@afilimax/message-text-parser

Esta é uma biblioteca focada em extrair dados de mensagens de ofertas enviadas por canais do Telegram brasileiros.

Instalação

npm install @afilimax/message-text-parser

Uso

import { defaultParser } from "@afilimax/message-text-parser"

const offer = defaultParser.parse(`Tênis Charged Starlight Se Under Armour

💲R$ 158,99
💳 Em 6x Sem Juros
🎟 Cupom: CARNAVAL40

🔗https://mercadolivre.com/sec/2yaVLgw`) // Offer | null

console.log(offer) /* {
  title: 'Tênis Charged Starlight Se Under Armour',
  price: { value: 158990, oldValue: null, currency: 'BRL' },
  url: 'https://mercadolivre.com/sec/2yaVLgw',
  coupons: [ 'CARNAVAL40' ]
} */

Canais suportados intencionalmente

• PC DO FAFA PROMOÇÕES
• TJ Gaming
• Ofertas Adrenaline
• Iskandar Souza - Promoções
• Promocoes Do Tec

Pode haver suporte a outros canais pelo fato do padrão de mensagens ser o mesmo, mas não são suportados intencionalmente. Se estiver interessado em adicionar suporte a um canal, abra um issue ou envie uma pull request com um parser implementado.

Como criar seu próprio parser e registrá-lo

import { OfferParser } from "@afilimax/message-text-parser"

const myParser: OfferParser<TelegramParserMeta> = {
    name: "meu-parser",
    meta: {
        telegramChannelId: "TELEGRAM_CHAT_ID", // serve para que se você, no ato de parsing, enviar o channelId, ele vai mais facilmente identificar o parser correto por conta da condicional em `canParse`
    },
    canParse(text, context) {
        if (context?.channelId && context.channelId === this.meta?.telegramChannelId) {
            return true
        }

        return false
    },
    parse(text: string) {
        return null
    }
}

Depois de criar o parser, basta registrá-lo no parser principal:

import { defaultParser } from "@afilimax/message-text-parser"

defaultParser.register(myParser)

Ou um parser novo:

import { MessageTextParser } from "@afilimax/message-text-parser"

const parser = new MessageTextParser()

parser.register(myParser)

Contribuindo

Se você quiser contribuir para o projeto, abra um issue ou envie uma pull request.

Licença

Este projeto está licenciado sob a licença MIT - veja o arquivo LICENSE para detalhes.