trompot 1.6.5 → 1.6.7

package/lib/wa/utils/ContactIdHelper.js

@@ -0,0 +1,216 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContactIdHelper = void 0;
+/**
+ * 🎯 CONTACT ID HELPER
+ *
+ * Utilitário para identificar e manipular diferentes tipos de IDs do WhatsApp
+ *
+ * Tipos suportados:
+ * - LID: Local ID (identificador criptografado) - Ex: "7812579066017@lid"
+ * - PN: Phone Number JID (formato antigo) - Ex: "5511999999999@s.whatsapp.net"
+ * - Group: ID de grupo - Ex: "120363XXXXX@g.us"
+ * - Broadcast: Lista de transmissão - Ex: "XXXXX@broadcast"
+ * - Newsletter: Canal - Ex: "XXXXX@newsletter"
+ *
+ * @since Baileys v7 - LID é o formato PREFERIDO e mais confiável
+ */
+class ContactIdHelper {
+    /**
+     * Verifica se é um LID (Local ID)
+     *
+     * @example
+     * ContactIdHelper.isLID("7812579066017@lid") // true
+     * ContactIdHelper.isLID("5511999999999@s.whatsapp.net") // false
+     */
+    static isLID(id) {
+        return (id === null || id === void 0 ? void 0 : id.endsWith('@lid')) || (id === null || id === void 0 ? void 0 : id.endsWith('@hosted.lid')) || false;
+    }
+    /**
+     * Verifica se é um PN (Phone Number JID)
+     *
+     * @example
+     * ContactIdHelper.isPN("5511999999999@s.whatsapp.net") // true
+     * ContactIdHelper.isPN("7812579066017@lid") // false
+     */
+    static isPN(id) {
+        return (id === null || id === void 0 ? void 0 : id.endsWith('@s.whatsapp.net')) || (id === null || id === void 0 ? void 0 : id.endsWith('@hosted')) || false;
+    }
+    /**
+     * Verifica se é um ID de grupo
+     */
+    static isGroup(id) {
+        return (id === null || id === void 0 ? void 0 : id.endsWith('@g.us')) || false;
+    }
+    /**
+     * Verifica se é uma lista de transmissão
+     */
+    static isBroadcast(id) {
+        return (id === null || id === void 0 ? void 0 : id.endsWith('@broadcast')) || false;
+    }
+    /**
+     * Verifica se é um canal (newsletter)
+     */
+    static isNewsletter(id) {
+        return (id === null || id === void 0 ? void 0 : id.endsWith('@newsletter')) || false;
+    }
+    /**
+     * Verifica se é um contato individual (LID ou PN)
+     */
+    static isUser(id) {
+        return this.isLID(id) || this.isPN(id);
+    }
+    /**
+     * Retorna o tipo do ID
+     */
+    static getIdType(id) {
+        if (this.isLID(id))
+            return 'lid';
+        if (this.isPN(id))
+            return 'pn';
+        if (this.isGroup(id))
+            return 'group';
+        if (this.isBroadcast(id))
+            return 'broadcast';
+        if (this.isNewsletter(id))
+            return 'newsletter';
+        return 'unknown';
+    }
+    /**
+     * Extrai o número de telefone de um PN format
+     *
+     * @example
+     * ContactIdHelper.extractPhoneFromPN("5511999999999@s.whatsapp.net")
+     * // "5511999999999"
+     */
+    static extractPhoneFromPN(pn) {
+        if (!this.isPN(pn))
+            return null;
+        return pn.replace('@s.whatsapp.net', '').replace('@hosted', '');
+    }
+    /**
+     * Extrai o LID number (parte antes do @)
+     *
+     * @example
+     * ContactIdHelper.extractLIDNumber("7812579066017@lid")
+     * // "7812579066017"
+     */
+    static extractLIDNumber(lid) {
+        if (!this.isLID(lid))
+            return null;
+        return lid.replace('@lid', '').replace('@hosted.lid', '');
+    }
+    /**
+     * Normaliza um ID removendo device ID e mantendo só user ID
+     *
+     * @example
+     * ContactIdHelper.normalizeId("5511999999999:10@s.whatsapp.net")
+     * // "5511999999999@s.whatsapp.net"
+     */
+    static normalizeId(id) {
+        if (!id)
+            return id;
+        // Remove device ID (formato: user:device@domain)
+        const parts = id.split('@');
+        if (parts.length !== 2)
+            return id;
+        const [userPart, domain] = parts;
+        const user = userPart.split(':')[0]; // Remove device ID
+        return `${user}@${domain}`;
+    }
+    /**
+     * Formata um phoneNumber para PN JID
+     *
+     * @example
+     * ContactIdHelper.formatToPN("5511999999999")
+     * // "5511999999999@s.whatsapp.net"
+     */
+    static formatToPN(phoneNumber) {
+        if (phoneNumber.includes('@')) {
+            return phoneNumber; // Já está formatado
+        }
+        return `${phoneNumber}@s.whatsapp.net`;
+    }
+    /**
+     * Retorna o ID preferido para uso
+     * Baileys v7: LID é PREFERIDO sobre PN
+     *
+     * @param lidId - LID se disponível
+     * @param pnId - PN se disponível
+     * @returns ID preferido (LID > PN)
+     */
+    static getPreferredId(lidId, pnId) {
+        // Baileys v7: LID é mais confiável
+        if (lidId && this.isLID(lidId))
+            return lidId;
+        if (pnId && this.isPN(pnId))
+            return pnId;
+        // Fallback para qualquer ID válido
+        return lidId || pnId || null;
+    }
+    /**
+     * Verifica se dois IDs representam o mesmo usuário
+     * Útil para comparar LID ↔ PN do mesmo contato
+     */
+    static isSameUser(id1, id2) {
+        if (!id1 || !id2)
+            return false;
+        // Mesmos IDs = mesmo usuário
+        if (this.normalizeId(id1) === this.normalizeId(id2)) {
+            return true;
+        }
+        // Para LID ↔ PN: não podemos determinar sem mapeamento
+        // Retorna false por segurança
+        return false;
+    }
+    /**
+     * Valida se um ID está no formato correto
+     */
+    static isValidId(id) {
+        if (!id || typeof id !== 'string')
+            return false;
+        return this.isLID(id) ||
+            this.isPN(id) ||
+            this.isGroup(id) ||
+            this.isBroadcast(id) ||
+            this.isNewsletter(id);
+    }
+    /**
+     * Extrai informações detalhadas de um ID
+     */
+    static parseId(id) {
+        const type = this.getIdType(id);
+        if (!this.isValidId(id)) {
+            return {
+                type: 'unknown',
+                user: null,
+                device: null,
+                domain: null,
+                isValid: false
+            };
+        }
+        const parts = id.split('@');
+        if (parts.length !== 2) {
+            return {
+                type: 'unknown',
+                user: null,
+                device: null,
+                domain: null,
+                isValid: false
+            };
+        }
+        const [userPart, domain] = parts;
+        const userDeviceParts = userPart.split(':');
+        const user = userDeviceParts[0];
+        const device = userDeviceParts.length > 1 ? parseInt(userDeviceParts[1], 10) : null;
+        return {
+            type,
+            user,
+            device,
+            domain,
+            isValid: true
+        };
+    }
+}
+exports.ContactIdHelper = ContactIdHelper;
+//# sourceMappingURL=ContactIdHelper.js.map

package/lib/wa/utils/ContactIdHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContactIdHelper.js","sourceRoot":"","sources":["../../../src/wa/utils/ContactIdHelper.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trompot",
-  "version": "1.6.5",
+  "version": "1.6.7",
   "description": "Chatbot API multi-plataforma em TypeScript. Fork do Trompot.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -9,6 +9,14 @@
     "cluster": "ts-node-dev example/cluster.ts",
     "telegram": "ts-node-dev example/telegram.ts",
     "test": "ts-node example/test-refactoring.ts",
+    "test:proactive": "ts-node example/test-send-proactive-whatsapp.ts",
+    "test:bulk": "ts-node example/test-bulk-notifications-whatsapp.ts",
+    "test:convert-lid": "ts-node example/test-convert-lid-to-jid.ts",
+    "test:stable-id": "ts-node example/test-stable-user-id.ts",
+    "test:perfect": "ts-node example/test-perfect-contact-system.ts",
+    "test:force-contact": "ts-node example/test-force-contact-verification.ts",
+    "test:complete": "ts-node example/test-complete-whatsapp-methods.ts",
+    "test:connection": "ts-node example/test-connection-debug.ts",
     "build": "npm i && npm run clean && tsc",
     "clean": "rimraf lib",
     "lint": "eslint ."