@stone-wpp/ofc 1.0.5 → 1.0.7

package/README.md

@@ -18,7 +18,7 @@
 
 <br>
 
-<a href="https://github.com/dylan-Modz/stone-wpp-ofc"><img src="https://img.shields.io/badge/VERS%C3%83O-1.0.5-00BFFF?style=for-the-badge&logo=github&logoColor=white&labelColor=111820" alt="Versão 1.0.5 do código no GitHub"></a>
+<a href="https://github.com/dylan-Modz/stone-wpp-ofc"><img src="https://img.shields.io/badge/VERS%C3%83O-1.0.7-00BFFF?style=for-the-badge&logo=github&logoColor=white&labelColor=111820" alt="Versão 1.0.7 do código no GitHub"></a>
 <img src="https://img.shields.io/badge/NODE.JS-20%2B-111820?style=for-the-badge&logo=node.js&logoColor=00BFFF" alt="Node.js 20 ou superior">
 <img src="https://img.shields.io/badge/LICENSE-MIT-00BFFF?style=for-the-badge&labelColor=111820" alt="Licença MIT">
 
@@ -38,53 +38,73 @@
 
 ---
 
-## 📚 DOCUMENTAÇÃO COMPLETA
+## 🚀 Stone WPP 1.0.7 — novidades e melhorias
 
-A documentação principal da **Stone WPP** está disponível no nosso site oficial, com navegação por categorias, pesquisa e exemplos. Em vez de repetir todos os tutoriais aqui no npm, centralizamos as explicações no site para você encontrar cada recurso no lugar certo.
+A **1.0.7** apresenta um módulo totalmente novo de chamadas e aperfeiçoa recursos que a Stone WPP já oferecia.
 
-<div align="center">
+### 🆕 Novidades desta versão
 
-### **[🌐 ABRIR DOCUMENTAÇÃO — STONE WPP](https://stone-wpp.squareweb.app/)**
+**📞 VoIP — novo módulo experimental**
 
-**https://stone-wpp.squareweb.app/**
+A Stone agora oferece a interface `stone.calls` para trabalhar com chamadas usando **a mesma conexão autenticada do WhatsApp**.
 
-</div>
+- **Chamadas de voz:** iniciar, atender, recusar e encerrar ligações.
+- **Música e áudio:** carregar arquivos de áudio e transmitir áudio em tempo real, conforme o suporte do ambiente.
+- **Eventos de chamadas:** acompanhar ligações recebidas, alterações de estado e encerramentos.
+- **Links e convites:** gerar links de chamada de voz ou vídeo e compartilhá-los com grupos.
+- **Chamadas em grupo:** novas interfaces para iniciar, entrar e sair de chamadas, ainda em caráter experimental.
+- **Controle do módulo:** consultar a disponibilidade dos recursos com `getVoipStatus()` e `getCapabilities()`.
 
-| O que você encontra | Conteúdo |
-| :--- | :--- |
-| 🚀 **Primeiros passos** | Instalação, configuração e uso inicial. |
-| 🔐 **Autenticação** | Sessão, conexão e reconexão. |
-| 💬 **Mensagens** | Envio, recebimento e eventos. |
-| 🧩 **Botões** | Exemplos e referências das mensagens interativas. |
-| 👥 **Grupos e comunidades** | Operações e gerenciamento. |
-| 📢 **Canais** | Métodos e recursos disponíveis. |
-| ⚙️ **Outros módulos** | API, DataLayer (armazenamento), Extensions (extensões) e funcionalidades relacionadas. |
+> **VoIP é uma funcionalidade nova e experimental.** Alguns recursos, especialmente as chamadas em grupo, dependem da compatibilidade com o WhatsApp e podem não estar disponíveis em todos os ambientes.
+
+**🔎 Novas ferramentas de diagnóstico**
+
+- `resolveJidMapping(jid)` — consulta o mapeamento conhecido entre identificadores PN e LID.
+- `inspectSignalSession(jid)` — consulta a existência de uma sessão criptográfica Signal.
 
-> **Importante:** a Stone WPP está em desenvolvimento. Consulte a documentação para conhecer os recursos disponíveis e suas limitações. Nem todas as funções planejadas estão implementadas.
+### 🛠️ Melhorias nas funções que já existiam
+
+- **Downloads de mídia:** recuperação aprimorada quando a URL direta responde com HTTP 403, 404 ou 410, tentando a URL original quando possível.
+- **Arquivos e descriptografia:** identificação mais clara de mídias sem chave e limites de espera para evitar processamento preso em tentativas de recuperação.
+- **Identificadores PN/LID:** tratamento aprimorado dos JIDs de usuários e dispositivos nas respostas da sincronização USync.
+- **Estabilidade e integração:** ajustes no tratamento dos eventos e na consistência das informações de sessão, mantendo os recursos de mensagens, grupos e canais.
 
 ---
 
-## 📦 INSTALAÇÃO PELO NPM
+## 📚 Documentação
 
-```bash
-npm install @stone-wpp/ofc
-```
+O site oficial concentra os guias, exemplos e referências das funções disponíveis na Stone WPP.
 
-**Requisitos:** Node.js **20+**. Biblioteca em JavaScript com suporte a ES Modules.
+**[📖 Acessar a documentação completa](https://stone-wpp.squareweb.app/)**
 
-Para instalar no **Termux**, dentro da pasta da sua aplicação:
+| Área | O que você encontra |
+| :--- | :--- |
+| Conexão e autenticação | Sessão, eventos e reconexão |
+| Mensagens e mídias | Envio, recebimento, downloads e arquivos |
+| Grupos e comunidades | Administração e operações de grupos |
+| Canais | Recursos de canais do WhatsApp |
+| Chamadas | Métodos e eventos do novo módulo VoIP |
+| Outros módulos | API, armazenamento e extensões |
+
+---
+
+## 📦 Instalação
+
+**Requisito:** Node.js 20 ou superior.
 
 ```bash
-pkg update -y
-pkg install nodejs-lts git -y
 npm install @stone-wpp/ofc
 ```
 
-No Android, algumas dependências podem exigir suporte nativo. Prefira instalar na pasta privada do Termux.
+Para utilizar o código disponível diretamente no GitHub:
+
+```bash
+npm install github:dylan-Modz/stone-wpp-ofc#main
+```
 
 ---
 
-## ⚡ EXEMPLO RÁPIDO
+## ⚡ Exemplo rápido
 
 ```js
 import createStone, { useMultiFileAuthState } from '@stone-wpp/ofc'
@@ -99,9 +119,7 @@ stone.ev.on('connection.update', ({ connection }) => {
 })
 ```
 
-Para entender cada método, opções de conexão, eventos e exemplos, acesse a **[documentação oficial](https://stone-wpp.squareweb.app/)**.
-
-> A Stone WPP é uma **biblioteca**, não um bot pronto. Não possui `npm start` próprio. Proteja suas sessões e credenciais; não as publique em repositórios.
+Para explorar os métodos e exemplos de integração, consulte a **[documentação oficial](https://stone-wpp.squareweb.app/)**.
 
 ---
 

package/lib/Signal/lid-mapping.js

@@ -182,7 +182,15 @@ export class LIDMappingStore {
                     const lidUser = jidDecode(pair.lid)?.user;
                     if (!lidUser)
                         continue;
-                    for (const device of usyncFetch[pair.pn]) {
+                    // USync may reply with a device-specific PN instead of the normalized request.
+                    // Resolve both forms to avoid iterating over an undefined device list.
+                    const normalizedPairPn = jidNormalizedUser(pair.pn);
+                    const devices = usyncFetch[normalizedPairPn] ?? usyncFetch[pair.pn];
+                    if (!devices?.length) {
+                        this.logger.warn({ pn: pair.pn }, 'USync returned an unmatched PN mapping');
+                        continue;
+                    }
+                    for (const device of devices) {
                         const deviceSpecificLid = `${lidUser}${!!device ? `:${device}` : ``}@${device === 99 ? 'hosted.lid' : 'lid'}`;
                         this.logger.trace(`getLIDForPN: USYNC success for ${pair.pn} → ${deviceSpecificLid} (user mapping with device ${device})`);
                         const deviceSpecificPn = `${pnUser}${!!device ? `:${device}` : ``}@${device === 99 ? 'hosted' : 's.whatsapp.net'}`;

package/lib/Socket/group-protection.d.ts

@@ -0,0 +1,146 @@
+export type GroupProtectionMode = 'alert' | 'delete' | 'remove' | 'protect'
+
+/** Persistência opcional: utilize createStoneStore({ type: 'json' | 'sqlite', path }). */
+export interface GroupProtectionStore {
+  get<T = unknown>(key: string): Promise<T | undefined>
+  set(key: string, value: unknown): Promise<boolean>
+}
+
+export interface GroupProtectionHistoryEntry {
+  type: 'alert' | 'action'
+  jid: string
+  participant: string | null
+  reason: string | null
+  severity: string | null
+  action: string | null
+  mode: string | null
+  deleted: boolean
+  removed: boolean
+  locked: boolean
+  receivedAt: number
+}
+
+export interface GroupProtectionMonitor {
+  ev: {
+    on(name: string, fn: (...args: any[]) => void): unknown
+    off(name: string, fn: (...args: any[]) => void): unknown
+  }
+}
+
+/** Cria/recria sessão auxiliar do próprio usuário. O aplicativo ainda persiste a autenticação. */
+export interface GroupProtectionMonitorPairing {
+  create(args: { jid: string; attempt: number }): Promise<GroupProtectionMonitor>
+  /** Número com DDI para solicitar o código somente se a sessão não estiver registrada. */
+  phoneNumber?: string
+  /** Callback privado: mostre o código ao titular para confirmação no WhatsApp. */
+  onPairingCode?: (info: { jid: string; index: number; code: string }) => void | Promise<void>
+}
+
+export interface GroupProtectionOptions {
+  /** Desativada por padrão; chamar com {enabled: true} para ativar. */
+  enabled?: boolean
+  /** alert: apenas eventos. delete: apaga; remove: apaga + remove membro; protect: fecha temporariamente + apaga + remove. */
+  mode?: GroupProtectionMode
+  /** Mínimo de mensagens de pagamento do mesmo remetente por janela (padrão: 3). */
+  paymentBurst?: number
+  /** Mínimo de mensagens totais por janela (padrão: 14). */
+  messageBurst?: number
+  /** Janela de detecção em milissegundos (padrão: 8000). */
+  windowMs?: number
+  /** Tempo de fechamento temporário no modo protect (padrão: 12000). */
+  lockMs?: number
+  observeInvisible?: boolean
+  observePayments?: boolean
+  observeQuotes?: boolean
+  observeFlood?: boolean
+  /** Se true, publica um aviso do bot e edita o aviso ao concluir as ações. */
+  editNotice?: boolean
+  /** Até três sockets adicionais já autenticados e presentes nos grupos. */
+  monitors?: GroupProtectionMonitor[]
+  /** Factories de até 3 sessões extras já autenticadas; reconecta em queda temporária.
+   *  O próprio aplicativo deve criar os sockets e persistir as credenciais.
+   *  Logout não causa novo pareamento automático. */
+  monitorFactories?: Array<
+    ((args: { jid: string; attempt: number }) => Promise<GroupProtectionMonitor>)
+    | GroupProtectionMonitorPairing
+  >
+  monitorReconnectMs?: number
+  /** Recibos de retry são tratados apenas como telemetria, nunca prova de ataque. */
+  observeReceipts?: boolean
+  receiptBurst?: number
+  /** JIDs imunes a remoção (PN e LID são comparados separadamente). */
+  immunity?: string[]
+  /** Limite de registros mantidos por grupo, entre 20 e 500. */
+  historyLimit?: number
+  /** StoneStore opcional para persistir regras e histórico. */
+  store?: GroupProtectionStore
+  /** Restaura regras previamente salvas no store; requer store. */
+  restore?: boolean
+  /** Consulta o histórico sem modificar as configurações; requer store ou ativação prévia. */
+  getHistory?: boolean
+  /** Limita linhas retornadas na consulta de histórico. */
+  limit?: number
+}
+
+export interface GroupProtectionStatus {
+  jid: string
+  enabled: boolean
+  mode?: GroupProtectionMode
+  paymentBurst?: number
+  messageBurst?: number
+  windowMs?: number
+  lockMs?: number
+  observeInvisible?: boolean
+  observePayments?: boolean
+  observeQuotes?: boolean
+  observeFlood?: boolean
+  observeReceipts?: boolean
+  receiptBurst?: number
+  immunity?: string[]
+  historyLimit?: number
+  history?: GroupProtectionHistoryEntry[]
+  restored?: boolean
+  monitorCount: number
+  alerts: number
+  actions: number
+}
+
+export interface GroupProtectionAlert {
+  jid: string
+  participant: string
+  messageId: string
+  reason: 'payment' | 'flood' | 'invisible-suspected' | 'quoted-payment' | 'receipt-suspected'
+  severity: 'low' | 'medium' | 'high'
+  verified: boolean
+  source: string
+  evidence: Record<string, unknown>
+  mode: GroupProtectionMode
+  receivedAt: number
+}
+
+export interface GroupProtectionAction {
+  jid: string
+  participant?: string
+  messageId?: string
+  action?: 'reopen'
+  attemptedMode?: GroupProtectionMode
+  deleted?: boolean
+  removed?: boolean
+  locked?: boolean
+  ok?: boolean
+  error?: string
+  deleteError?: string
+  removeError?: string
+  lockError?: string
+  noticeEdited?: boolean
+  noticeError?: string
+  noticeEditError?: string
+}
+
+export interface GroupProtectionMethods {
+  /** Configura, consulta, restaura, desativa ou consulta histórico por grupo.
+   * Persistência exige store explícito; login de monitores exige autenticação prévia. */
+  groupProtection(jid: string, options?: GroupProtectionOptions): Promise<GroupProtectionStatus>
+}
+
+export declare function createGroupProtectionMethods(socket: unknown): GroupProtectionMethods