@lopeszera/baileys 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Rajeh Taher/WhiskeySockets
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,392 @@
+# 𝕷'𝖆𝖌ü𝖊𝖗𝖔 • Baileys
+
+<p align="center">
+  <img src="https://img.shields.io/npm/v/@lopeszera/baileys?color=FFD400&label=vers%C3%A3o&style=for-the-badge" />
+  <img src="https://img.shields.io/npm/dw/@lopeszera/baileys?color=FFD400&label=downloads&style=for-the-badge" />
+  <img src="https://img.shields.io/badge/licen%C3%A7a-MIT-FFD400?style=for-the-badge" />
+  <img src="https://img.shields.io/badge/node-%3E%3D20-FFD400?style=for-the-badge" />
+</p>
+
+<p align="center">
+  <b>Fork pessoal do Baileys</b> — biblioteca TypeScript pra conectar direto na
+  API do WhatsApp Web via WebSocket, sem precisar de navegador/Selenium.<br/>
+  Baseado no <a href="https://github.com/WhiskeySockets/Baileys">WhiskeySockets/Baileys</a>,
+  com módulos extras de <b>mensagens interativas</b> (botões, carrossel, listas,
+  menu de fontes), <b>status</b> e <b>chamadas</b> já prontos pra usar.
+</p>
+
+<p align="center">
+  <a href="https://whatsapp.com/channel/0029Vb5nzxV7dmehsyILK70Z">
+    <img src="https://img.shields.io/badge/WhatsApp-Me%20siga%20no%20canal-FFD400?style=for-the-badge&logo=whatsapp&logoColor=black" />
+  </a>
+</p>
+
+---
+
+## 📦 Instalação
+
+```bash
+npm install @lopeszera/baileys
+```
+
+## ⚡ Uso rápido
+
+```js
+const {
+  default: makeWASocket,
+  useMultiFileAuthState,
+  DisconnectReason
+} = require('@lopeszera/baileys')
+
+async function start() {
+  const { state, saveCreds } = await useMultiFileAuthState('session')
+
+  const sock = makeWASocket({ auth: state })
+
+  sock.ev.on('creds.update', saveCreds)
+
+  sock.ev.on('connection.update', ({ connection, lastDisconnect }) => {
+    if (connection === 'open') console.log('conectado!')
+    if (connection === 'close') {
+      const shouldReconnect = lastDisconnect?.error?.output?.statusCode !== DisconnectReason.loggedOut
+      if (shouldReconnect) start()
+    }
+  })
+
+  sock.ev.on('messages.upsert', ({ messages }) => {
+    console.log(messages[0])
+  })
+}
+
+start()
+```
+
+---
+
+## 🧩 Módulos
+
+### 💬 Mensagens de texto e mídia
+Igual o Baileys original — `sock.sendMessage(jid, { text: '...' })`,
+`{ image: { url }, caption: '...' }`, `{ video }`, `{ audio, ptt: true }`,
+`{ document }`, etc.
+
+### 🔘 Botões — `sendButtonMessage`
+Manda uma mensagem com botões de resposta rápida e/ou de link.
+
+```js
+const { sendButtonMessage } = require('@lopeszera/baileys')
+
+await sendButtonMessage(sock, jid, {
+  text: 'Escolha uma opção:',
+  footer: 'Meu Bot',
+  buttons: [
+    { text: 'Falar com suporte', id: 'suporte' },
+    { text: 'Ver site', url: 'https://exemplo.com' }
+  ]
+})
+```
+
+A resposta do usuário chega no evento `messages.upsert` normal, dentro de
+`msg.message.interactiveResponseMessage.nativeFlowResponseMessage.paramsJson`.
+
+### 🎠 Carrossel — `sendCarouselMessage`
+Vários cards roláveis horizontalmente, cada um com imagem, título, corpo e
+seus próprios botões.
+
+```js
+const { sendCarouselMessage } = require('@lopeszera/baileys')
+
+await sendCarouselMessage(sock, jid, {
+  text: 'Confira nossos produtos:',
+  footer: 'Minha Loja',
+  cards: [
+    {
+      image: { url: 'https://exemplo.com/produto1.jpg' },
+      title: 'Produto 1',
+      body: 'Descrição do produto 1 - R$ 99,90',
+      buttons: [{ text: 'Comprar', url: 'https://loja.com/produto1' }]
+    },
+    {
+      image: { url: 'https://exemplo.com/produto2.jpg' },
+      title: 'Produto 2',
+      body: 'Descrição do produto 2 - R$ 149,90',
+      buttons: [{ text: 'Comprar', url: 'https://loja.com/produto2' }]
+    }
+  ]
+})
+```
+
+> Precisa de **2 a 10 cards** (regra do próprio WhatsApp).
+> Cada card aceita `image` **ou** `video` no lugar da capa — troque
+> `image: { url: '...' }` por `video: { url: '...' }` no card que quiser.
+
+### 🧱 MessageBuilder — `ButtonV2`, `Carousel`, `AIRich`
+API fluente por cima do `sendButtonMessage`/`sendCarouselMessage`, pra quem
+prefere encadear em vez de montar o objeto de opções na mão.
+
+```js
+const { ButtonV2, Carousel, AIRich } = require('@lopeszera/baileys')
+// O socket vai sempre no construtor: new ButtonV2(sock)
+```
+
+**ButtonV2**
+```js
+const msg = new ButtonV2(sock)
+msg.setTitle('Título')
+msg.setBody('Corpo')
+msg.setFooter('Rodapé — lopes-api-store')
+msg.addReply('✅ Opção 1', 'opcao_1')
+msg.addReply('❌ Opção 2', 'opcao_2')
+await msg.send(jid, { quoted: m })
+```
+
+**Botão nativo (native flow)**
+```js
+const msg = new ButtonV2(sock)
+msg.addReply('✅ Confirmar', 'confirmar')
+msg.addUrl('🔗 Abrir', 'https://lopes-api-store.com.br')
+msg.addCopy('📋 Copiar', 'PROMO2025')
+msg.addCall('📞 Ligar', '5511999999999')
+await msg.send(jid, { quoted: m })
+```
+
+**Carousel**
+```js
+const msg = new Carousel(sock)
+msg.setBody('Escolha:')
+msg.card(c => c.image('https://lopes-api-store.com.br/produto1.jpg').title('Card 1').text('...'))
+msg.card(c => c.video('./produto2.mp4').title('Card 2').text('...'))
+await msg.send(jid, { quoted: m })
+```
+
+**AIRich** — texto formatado, bloco de código e "tabela" (alinhada em
+fonte monoespaçada — o WhatsApp não tem tabela nativa em texto):
+```js
+const msg = new AIRich(sock)
+msg.addText('Acesse a Lopes API: https://lopes-api-store.com.br')
+msg.addCode('javascript', `require('@lopeszera/baileys')`)
+msg.addTable(['Comando', 'Desc'], [['!menu', 'Menu principal']])
+await msg.send(jid, { quoted: m })
+```
+
+### 🔘 Botões estendidos
+`InteractiveButton` aceita mais tipos além de `url`/`id` (quick reply):
+
+```js
+const button = { text: '📋 Copiar código', copyCode: 'PROMO2025' }
+```
+
+| Campo               | O que faz                                  | Confiabilidade |
+|---------------------|---------------------------------------------|----------------|
+| `url`               | abre um link                                 | ✅ confirmado |
+| `call`               | liga pro número                              | ✅ confirmado |
+| `copyCode`           | copia texto/código com 1 toque               | ✅ confirmado |
+| `reminderId` / `cancelReminderId` | cria/cancela lembrete nativo   | ⚠️ pouco documentado — teste antes |
+| `address` / `location` | pede endereço/localização salvos           | ⚠️ pouco documentado — teste antes |
+| `catalog`            | abre o catálogo do WhatsApp Business         | ⚠️ pouco documentado — teste antes |
+| `list`               | abre uma lista de opções (`single_select`)   | ✅ confirmado |
+| `product`            | mostra 1 produto do catálogo (`mpm`) — 1 botão por produto | ⚠️ pouco documentado — teste antes |
+| `callPermissionRequest` | pede permissão do contato pra você poder ligar | ✅ confirmado |
+| `flow`               | abre um WhatsApp Flow (formulário nativo)    | 🔵 formato oficial da Cloud API — teste antes de usar em produção |
+| `clearChat`          | **não é nativo** — quick_reply com id fixo pro seu handler tratar | 🔧 sua lógica |
+
+**Lista de opções (`single_select`)**
+```js
+const msg = new ButtonV2(sock)
+msg.setBody('Escolha um plano:')
+msg.addList('📋 Ver planos', [
+  {
+    title: 'Planos Lopes',
+    rows: [
+      { title: 'Básico', description: 'R$ 29,90/mês', id: 'plano_basico' },
+      { title: 'Pro', description: 'R$ 59,90/mês', id: 'plano_pro' }
+    ]
+  }
+])
+await msg.send(jid, { quoted: m })
+```
+
+**Vitrine de produtos (`mpm`)** — precisa de catálogo vinculado ao número:
+```js
+const msg = new ButtonV2(sock)
+msg.setBody('Confira:')
+msg.addProduct('SEU_CATALOG_ID', 'SKU-001')
+msg.addProduct('SEU_CATALOG_ID', 'SKU-002')
+await msg.send(jid, { quoted: m })
+```
+
+**Pedir permissão de chamada**
+```js
+const msg = new ButtonV2(sock)
+msg.setBody('Podemos te ligar pra tirar dúvidas sobre seu pedido?')
+msg.addCallPermissionRequest('📞 Permitir chamada')
+await msg.send(jid, { quoted: m })
+```
+
+**WhatsApp Flow (formulário nativo)**
+```js
+const msg = new ButtonV2(sock)
+msg.setBody('Preencha seu cadastro na Lopes:')
+msg.addFlow('📝 Iniciar cadastro', {
+  flowId: 'SEU_FLOW_ID',
+  action: 'navigate',
+  screen: 'WELCOME_SCREEN',
+  data: { origem: 'lopes-api-store' }
+})
+await msg.send(jid, { quoted: m })
+```
+> Exige ter criado o Flow antes (tela/JSON do formulário) — isso não é
+> algo que o Baileys cria pra você, só dispara o botão que abre um Flow
+> já existente vinculado ao número.
+
+### 🔕 `isSystemNotification`
+Filtra mensagens que são notificação de sistema (grupo criado, participante
+entrou/saiu, etc.) em vez de conteúdo de conversa de verdade:
+
+```js
+const { isSystemNotification } = require('@lopeszera/baileys')
+
+sock.ev.on('messages.upsert', async ({ messages }) => {
+  const msg = messages[0]
+  if (isSystemNotification(msg)) return
+  // ...seu handler de comando aqui
+})
+```
+
+### 🗂️ Menu de fontes — `setupSourcesMenu`
+Monta o fluxo: comando de texto → card com imagem/infos → lista de itens →
+botão nativo de "copiar código" pro item escolhido. Útil pra menu de
+fontes/produtos/cupons.
+
+```js
+const { setupSourcesMenu } = require('@lopeszera/baileys')
+
+setupSourcesMenu(sock, {
+  trigger: '-fontes',           // o que o usuário manda pra abrir o card
+  card: {
+    image: { url: './card.png' },
+    title: 'Fontes do Bot',
+    tags: ['武士道', 'Meu Bot'],
+    info: {
+      Creator: 'Você',
+      BotNome: 'Meu Bot V1',
+      Telegram: 't.me/seucanal'
+    },
+    channel: { text: 'Meu Canal', url: 'https://whatsapp.com/channel/xxxx' },
+    listButtonText: 'Fontes'
+  },
+  list: {
+    title: 'Fontes Disponíveis',
+    buttonText: 'Ver fontes'
+  },
+  // pode ser um array fixo ou uma função (pra buscar de um arquivo/banco na hora)
+  sources: [
+    { id: 'src1', title: 'Fonte 1', description: 'Menu principal', code: 'ABC123' },
+    { id: 'src2', title: 'Fonte 2', description: 'Sistema de figurinhas', code: 'DEF456' }
+  ]
+})
+```
+
+**Fluxo real** (importante entender antes de usar): usuário manda `-fontes`
+→ recebe o card → toca no botão "Fontes" → recebe a lista → toca num item
+→ recebe uma mensagem só daquele item com o botão **"Copiar código"** → aí
+sim toca e copia. São 2 toques depois do comando, não 1 — não existe (até
+onde consegui confirmar no protocolo) uma lista onde cada linha já copia
+direto sem essa etapa intermediária.
+
+Também dá pra usar as peças separadas, se quiser montar seu próprio fluxo:
+`sendSourcesCard`, `sendSourcesList`, `sendSourceCode`.
+
+### 📖 Status — `sendStatus`
+Posta um Status de texto, imagem ou vídeo. `statusJidList` é a lista de
+contatos que **podem ver** esse status especificamente — sem isso, vale a
+audiência padrão (todo mundo que já te tem salvo).
+
+```js
+const { sendStatus } = require('@lopeszera/baileys')
+
+// status de texto, só pra um grupo específico de contatos
+await sendStatus(
+  sock,
+  { text: 'Bom dia! ☀️' },
+  {
+    statusJidList: ['5567999999999@s.whatsapp.net', '5567988888888@s.whatsapp.net'],
+    backgroundColor: '#25D366',
+    font: 2
+  }
+)
+
+// status de imagem, audiência padrão
+await sendStatus(sock, { image: { url: './foto.jpg' }, caption: 'Olha só' })
+```
+
+### 📞 Chamadas — o que o fork faz de verdade
+Importante: o Baileys (esse fork incluso) fala só a **sinalização** de
+chamada do WhatsApp — não tem nada de RTP/SRTP/Opus aqui, então:
+
+- ✅ **Recebe** eventos de chamada (`offer`, `ringing`, `accept`, `reject`,
+  `terminate`, `timeout`) e consegue **rejeitar** automaticamente
+- ❌ **Não** origina chamada, **não** tem áudio — isso não existe em
+  nenhuma versão pública do Baileys
+
+```js
+const { setupCallHandler } = require('@lopeszera/baileys')
+
+setupCallHandler(sock, {
+  autoReject: true,
+  onCall: (call) => {
+    console.log(`Chamada de ${call.from} — status: ${call.status}`)
+  }
+})
+```
+
+**Chamada de saída com áudio de verdade** (bot ligar e tocar uma música)
+só é possível integrando uma lib externa que embuta a stack VoIP real do
+WhatsApp Web — usamos o
+[baileys-caller](https://github.com/SheIITear/baileys-caller) pra isso.
+Não faz parte do core do fork (é uma dependência separada, com seu próprio
+socket/sessão), tem exemplo pronto em `Example/voipCaller.ts` e
+`Example/call-example.ts`:
+
+```bash
+npm run example:call ./session 5567999999999 ./hello.mp3
+```
+
+Detalhes de instalação (ffmpeg, build do baileys-caller, alias no
+`package.json`) estão comentados no topo do `Example/voipCaller.ts`.
+
+---
+
+## 🔐 Conectando
+
+**Via QR Code** (padrão):
+```js
+sock.ev.on('connection.update', ({ qr }) => {
+  if (qr) console.log(qr)
+})
+```
+
+**Via código de pareamento** (sem escanear QR):
+```js
+if (!sock.authState.creds.registered) {
+  const code = await sock.requestPairingCode('55SEUNUMEROCOMDDIcompleto')
+  console.log('Código:', code)
+}
+```
+
+---
+
+## ⚠️ Aviso
+Automação de WhatsApp fora da API oficial pode violar os Termos de Serviço
+do WhatsApp e resultar em banimento do número. Use por sua conta e risco.
+
+---
+
+<p align="center">
+  Mantido por <b>𝕷'𝖆𝖌ü𝖊𝖗𝖔</b><br/>
+  <a href="https://whatsapp.com/channel/0029Vb5nzxV7dmehsyILK70Z">📲 Me segue no canal do WhatsApp</a>
+</p>
+
+<p align="center">
+  <sub>Baseado no <a href="https://github.com/WhiskeySockets/Baileys">WhiskeySockets/Baileys</a> (MIT) — créditos originais preservados na <a href="./LICENSE">LICENSE</a>.</sub>
+</p>

package/WAProto/GenerateStatics.sh

@@ -0,0 +1,3 @@
+yarn pbjs -t static-module --no-beautify -w es6 --no-bundle --no-delimited --no-verify --no-comments -o ./index.js ./WAProto.proto;
+yarn pbjs -t static-module --no-beautify -w es6 --no-bundle --no-delimited --no-verify ./WAProto.proto | yarn pbts --no-comments -o ./index.d.ts -;
+node ./fix-imports.js