baileys-joss 1.0.0

package/lib/Utils/group-utils.d.ts

@@ -0,0 +1,190 @@
+/**
+ * Group Utilities untuk Baileys-Joss
+ *
+ * Fitur tambahan untuk group management
+ *
+ * @module group-utils
+ */
+import type { GroupMetadata } from '../Types/index.js';
+export interface GroupInfo {
+    /** Group JID */
+    jid: string;
+    /** Nama group */
+    name: string;
+    /** Subject (sama dengan name) */
+    subject: string;
+    /** Description */
+    description?: string;
+    /** Owner JID */
+    owner?: string;
+    /** Creation timestamp */
+    createdAt?: number;
+    /** Jumlah participants */
+    participantCount: number;
+    /** Is announcement (only admin can send) */
+    isAnnouncement: boolean;
+    /** Is restricted (only admin can edit info) */
+    isRestricted: boolean;
+    /** Is community */
+    isCommunity: boolean;
+    /** Is community announcement */
+    isCommunityAnnouncement: boolean;
+    /** Ephemeral duration */
+    ephemeralDuration?: number;
+    /** Invite link */
+    inviteCode?: string;
+}
+export interface ParticipantInfo {
+    /** JID */
+    jid: string;
+    /** Is admin */
+    isAdmin: boolean;
+    /** Is super admin (owner) */
+    isSuperAdmin: boolean;
+    /** LID if available */
+    lid?: string;
+}
+export interface GroupStats {
+    /** Total members */
+    totalMembers: number;
+    /** Total admins */
+    totalAdmins: number;
+    /** Total super admins */
+    totalSuperAdmins: number;
+    /** Admin percentage */
+    adminPercentage: number;
+}
+/**
+ * Get participant info dari GroupMetadata
+ */
+export declare const getParticipants: (metadata: GroupMetadata) => ParticipantInfo[];
+/**
+ * Get only admins
+ */
+export declare const getAdmins: (metadata: GroupMetadata) => ParticipantInfo[];
+/**
+ * Get only super admins (owners)
+ */
+export declare const getSuperAdmins: (metadata: GroupMetadata) => ParticipantInfo[];
+/**
+ * Get regular members (non-admin)
+ */
+export declare const getRegularMembers: (metadata: GroupMetadata) => ParticipantInfo[];
+/**
+ * Check apakah user adalah admin di group
+ */
+export declare const isGroupAdmin: (metadata: GroupMetadata, jid: string) => boolean;
+/**
+ * Check apakah user adalah super admin (owner) di group
+ */
+export declare const isGroupSuperAdmin: (metadata: GroupMetadata, jid: string) => boolean;
+/**
+ * Check apakah user ada di group
+ */
+export declare const isGroupMember: (metadata: GroupMetadata, jid: string) => boolean;
+/**
+ * Get formatted group info
+ */
+export declare const getGroupInfo: (metadata: GroupMetadata) => GroupInfo;
+/**
+ * Get group stats
+ */
+export declare const getGroupStats: (metadata: GroupMetadata) => GroupStats;
+/**
+ * Check if group is announcement only
+ */
+export declare const isAnnouncementGroup: (metadata: GroupMetadata) => boolean;
+/**
+ * Check if group is restricted (only admin can edit info)
+ */
+export declare const isRestrictedGroup: (metadata: GroupMetadata) => boolean;
+/**
+ * Generate mention text untuk semua member
+ */
+export declare const mentionAll: (metadata: GroupMetadata) => {
+    text: string;
+    mentions: string[];
+};
+/**
+ * Generate mention text untuk admins saja
+ */
+export declare const mentionAdmins: (metadata: GroupMetadata) => {
+    text: string;
+    mentions: string[];
+};
+/**
+ * Generate formatted participant list
+ */
+export declare const formatParticipantList: (metadata: GroupMetadata, options?: {
+    showAdmin?: boolean;
+    showNumber?: boolean;
+    prefix?: string;
+}) => string;
+/**
+ * Split participants into chunks untuk batch operations
+ * (WhatsApp has limit on participants per action)
+ */
+export declare const chunkParticipants: (participants: string[], chunkSize?: number) => string[][];
+/**
+ * Generate batch add/remove/promote/demote operations
+ */
+export declare const batchParticipantAction: <T>(participants: string[], action: (jids: string[]) => Promise<T>, options?: {
+    chunkSize?: number;
+    delayMs?: number;
+}) => Promise<{
+    success: string[];
+    failed: string[];
+    results: T[];
+}>;
+/**
+ * Validate group JID
+ */
+export declare const isValidGroupJid: (jid: string) => boolean;
+/**
+ * Validate community JID
+ */
+export declare const isValidCommunityJid: (jid: string) => boolean;
+/**
+ * Extract group ID dari JID
+ */
+export declare const extractGroupId: (jid: string) => string | null;
+declare const _default: {
+    getParticipants: (metadata: GroupMetadata) => ParticipantInfo[];
+    getAdmins: (metadata: GroupMetadata) => ParticipantInfo[];
+    getSuperAdmins: (metadata: GroupMetadata) => ParticipantInfo[];
+    getRegularMembers: (metadata: GroupMetadata) => ParticipantInfo[];
+    isGroupAdmin: (metadata: GroupMetadata, jid: string) => boolean;
+    isGroupSuperAdmin: (metadata: GroupMetadata, jid: string) => boolean;
+    isGroupMember: (metadata: GroupMetadata, jid: string) => boolean;
+    getGroupInfo: (metadata: GroupMetadata) => GroupInfo;
+    getGroupStats: (metadata: GroupMetadata) => GroupStats;
+    isAnnouncementGroup: (metadata: GroupMetadata) => boolean;
+    isRestrictedGroup: (metadata: GroupMetadata) => boolean;
+    mentionAll: (metadata: GroupMetadata) => {
+        text: string;
+        mentions: string[];
+    };
+    mentionAdmins: (metadata: GroupMetadata) => {
+        text: string;
+        mentions: string[];
+    };
+    formatParticipantList: (metadata: GroupMetadata, options?: {
+        showAdmin?: boolean;
+        showNumber?: boolean;
+        prefix?: string;
+    }) => string;
+    chunkParticipants: (participants: string[], chunkSize?: number) => string[][];
+    batchParticipantAction: <T>(participants: string[], action: (jids: string[]) => Promise<T>, options?: {
+        chunkSize?: number;
+        delayMs?: number;
+    }) => Promise<{
+        success: string[];
+        failed: string[];
+        results: T[];
+    }>;
+    isValidGroupJid: (jid: string) => boolean;
+    isValidCommunityJid: (jid: string) => boolean;
+    extractGroupId: (jid: string) => string | null;
+};
+export default _default;
+//# sourceMappingURL=group-utils.d.ts.map

package/lib/Utils/group-utils.d.ts.map

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

package/lib/Utils/group-utils.js

@@ -0,0 +1,241 @@
+/**
+ * Group Utilities untuk Baileys-Joss
+ *
+ * Fitur tambahan untuk group management
+ *
+ * @module group-utils
+ */
+// =====================================================
+// PARTICIPANT UTILITIES
+// =====================================================
+/**
+ * Get participant info dari GroupMetadata
+ */
+export const getParticipants = (metadata) => {
+    return metadata.participants.map(p => ({
+        jid: p.id,
+        isAdmin: p.admin === 'admin' || p.admin === 'superadmin',
+        isSuperAdmin: p.admin === 'superadmin',
+        lid: p.lid
+    }));
+};
+/**
+ * Get only admins
+ */
+export const getAdmins = (metadata) => {
+    return getParticipants(metadata).filter(p => p.isAdmin);
+};
+/**
+ * Get only super admins (owners)
+ */
+export const getSuperAdmins = (metadata) => {
+    return getParticipants(metadata).filter(p => p.isSuperAdmin);
+};
+/**
+ * Get regular members (non-admin)
+ */
+export const getRegularMembers = (metadata) => {
+    return getParticipants(metadata).filter(p => !p.isAdmin);
+};
+/**
+ * Check apakah user adalah admin di group
+ */
+export const isGroupAdmin = (metadata, jid) => {
+    const participant = metadata.participants.find(p => p.id === jid || p.lid === jid);
+    return participant?.admin === 'admin' || participant?.admin === 'superadmin';
+};
+/**
+ * Check apakah user adalah super admin (owner) di group
+ */
+export const isGroupSuperAdmin = (metadata, jid) => {
+    const participant = metadata.participants.find(p => p.id === jid || p.lid === jid);
+    return participant?.admin === 'superadmin';
+};
+/**
+ * Check apakah user ada di group
+ */
+export const isGroupMember = (metadata, jid) => {
+    return metadata.participants.some(p => p.id === jid || p.lid === jid);
+};
+// =====================================================
+// GROUP INFO UTILITIES
+// =====================================================
+/**
+ * Get formatted group info
+ */
+export const getGroupInfo = (metadata) => {
+    return {
+        jid: metadata.id,
+        name: metadata.subject,
+        subject: metadata.subject,
+        description: metadata.desc || undefined,
+        owner: metadata.owner || undefined,
+        createdAt: metadata.creation ? metadata.creation * 1000 : undefined,
+        participantCount: metadata.participants.length,
+        isAnnouncement: !!metadata.announce,
+        isRestricted: !!metadata.restrict,
+        isCommunity: !!metadata.isCommunity,
+        isCommunityAnnouncement: !!metadata.isCommunityAnnounce,
+        ephemeralDuration: metadata.ephemeralDuration || undefined,
+        inviteCode: metadata.inviteCode || undefined
+    };
+};
+/**
+ * Get group stats
+ */
+export const getGroupStats = (metadata) => {
+    const participants = getParticipants(metadata);
+    const admins = participants.filter(p => p.isAdmin);
+    const superAdmins = participants.filter(p => p.isSuperAdmin);
+    return {
+        totalMembers: participants.length,
+        totalAdmins: admins.length,
+        totalSuperAdmins: superAdmins.length,
+        adminPercentage: Math.round((admins.length / participants.length) * 100)
+    };
+};
+/**
+ * Check if group is announcement only
+ */
+export const isAnnouncementGroup = (metadata) => {
+    return !!metadata.announce;
+};
+/**
+ * Check if group is restricted (only admin can edit info)
+ */
+export const isRestrictedGroup = (metadata) => {
+    return !!metadata.restrict;
+};
+// =====================================================
+// MENTION UTILITIES
+// =====================================================
+/**
+ * Generate mention text untuk semua member
+ */
+export const mentionAll = (metadata) => {
+    const mentions = metadata.participants.map(p => p.id);
+    const text = mentions.map(jid => `@${jid.split('@')[0]}`).join(' ');
+    return { text, mentions };
+};
+/**
+ * Generate mention text untuk admins saja
+ */
+export const mentionAdmins = (metadata) => {
+    const admins = getAdmins(metadata);
+    const mentions = admins.map(a => a.jid);
+    const text = mentions.map(jid => `@${jid.split('@')[0]}`).join(' ');
+    return { text, mentions };
+};
+/**
+ * Generate formatted participant list
+ */
+export const formatParticipantList = (metadata, options) => {
+    const opts = {
+        showAdmin: true,
+        showNumber: true,
+        prefix: '• ',
+        ...options
+    };
+    return metadata.participants
+        .map((p, i) => {
+        let line = opts.prefix;
+        if (opts.showNumber) {
+            line += `${i + 1}. `;
+        }
+        line += `${p.id.split('@')[0]}`;
+        if (opts.showAdmin && p.admin) {
+            line += ` [${p.admin === 'superadmin' ? 'Owner' : 'Admin'}]`;
+        }
+        return line;
+    })
+        .join('\n');
+};
+// =====================================================
+// BATCH OPERATIONS HELPERS
+// =====================================================
+/**
+ * Split participants into chunks untuk batch operations
+ * (WhatsApp has limit on participants per action)
+ */
+export const chunkParticipants = (participants, chunkSize = 5) => {
+    const chunks = [];
+    for (let i = 0; i < participants.length; i += chunkSize) {
+        chunks.push(participants.slice(i, i + chunkSize));
+    }
+    return chunks;
+};
+/**
+ * Generate batch add/remove/promote/demote operations
+ */
+export const batchParticipantAction = async (participants, action, options) => {
+    const opts = {
+        chunkSize: 5,
+        delayMs: 1000,
+        ...options
+    };
+    const chunks = chunkParticipants(participants, opts.chunkSize);
+    const success = [];
+    const failed = [];
+    const results = [];
+    for (let i = 0; i < chunks.length; i++) {
+        const chunk = chunks[i];
+        try {
+            const result = await action(chunk);
+            results.push(result);
+            success.push(...chunk);
+        }
+        catch (error) {
+            failed.push(...chunk);
+        }
+        // Delay between chunks to avoid rate limiting
+        if (i < chunks.length - 1 && opts.delayMs > 0) {
+            await new Promise(resolve => setTimeout(resolve, opts.delayMs));
+        }
+    }
+    return { success, failed, results };
+};
+// =====================================================
+// VALIDATION UTILITIES
+// =====================================================
+/**
+ * Validate group JID
+ */
+export const isValidGroupJid = (jid) => {
+    return jid.endsWith('@g.us');
+};
+/**
+ * Validate community JID
+ */
+export const isValidCommunityJid = (jid) => {
+    return jid.endsWith('@g.us'); // Communities also use @g.us
+};
+/**
+ * Extract group ID dari JID
+ */
+export const extractGroupId = (jid) => {
+    if (!isValidGroupJid(jid))
+        return null;
+    return jid.split('@')[0] || null;
+};
+export default {
+    getParticipants,
+    getAdmins,
+    getSuperAdmins,
+    getRegularMembers,
+    isGroupAdmin,
+    isGroupSuperAdmin,
+    isGroupMember,
+    getGroupInfo,
+    getGroupStats,
+    isAnnouncementGroup,
+    isRestrictedGroup,
+    mentionAll,
+    mentionAdmins,
+    formatParticipantList,
+    chunkParticipants,
+    batchParticipantAction,
+    isValidGroupJid,
+    isValidCommunityJid,
+    extractGroupId
+};
+//# sourceMappingURL=group-utils.js.map

package/lib/Utils/group-utils.js.map

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

package/lib/Utils/history.d.ts

@@ -0,0 +1,22 @@
+import { proto } from '../../WAProto/index.js';
+import type { Chat, Contact, LIDMapping, WAMessage } from '../Types/index.js';
+import type { ILogger } from './logger.js';
+export declare const downloadHistory: (msg: proto.Message.IHistorySyncNotification, options: RequestInit) => Promise<proto.HistorySync>;
+export declare const processHistoryMessage: (item: proto.IHistorySync, logger?: ILogger) => {
+    chats: Chat[];
+    contacts: Contact[];
+    messages: WAMessage[];
+    lidPnMappings: LIDMapping[];
+    syncType: proto.HistorySync.HistorySyncType | null | undefined;
+    progress: number | null | undefined;
+};
+export declare const downloadAndProcessHistorySyncNotification: (msg: proto.Message.IHistorySyncNotification, options: RequestInit, logger?: ILogger) => Promise<{
+    chats: Chat[];
+    contacts: Contact[];
+    messages: WAMessage[];
+    lidPnMappings: LIDMapping[];
+    syncType: proto.HistorySync.HistorySyncType | null | undefined;
+    progress: number | null | undefined;
+}>;
+export declare const getHistoryMsg: (message: proto.IMessage) => proto.Message.IHistorySyncNotification;
+//# sourceMappingURL=history.d.ts.map

package/lib/Utils/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/Utils/history.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAIpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAwB1C,eAAO,MAAM,eAAe,GAAU,KAAK,KAAK,CAAC,OAAO,CAAC,wBAAwB,EAAE,SAAS,WAAW,+BActG,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAI,MAAM,KAAK,CAAC,YAAY,EAAE,SAAS,OAAO;;;;;;;CA2F/E,CAAA;AAED,eAAO,MAAM,yCAAyC,GACrD,KAAK,KAAK,CAAC,OAAO,CAAC,wBAAwB,EAC3C,SAAS,WAAW,EACpB,SAAS,OAAO;;;;;;;EAUhB,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,SAAS,KAAK,CAAC,QAAQ,2CAKpD,CAAA"}

package/lib/Utils/history.js

@@ -0,0 +1,131 @@
+import { promisify } from 'util';
+import { inflate } from 'zlib';
+import { proto } from '../../WAProto/index.js';
+import { WAMessageStubType } from '../Types/index.js';
+import { isHostedLidUser, isHostedPnUser, isLidUser, isPnUser } from '../WABinary/index.js';
+import { toNumber } from './generics.js';
+import { normalizeMessageContent } from './messages.js';
+import { downloadContentFromMessage } from './messages-media.js';
+const inflatePromise = promisify(inflate);
+const extractPnFromMessages = (messages) => {
+    for (const msgItem of messages) {
+        const message = msgItem.message;
+        // Only extract from outgoing messages (fromMe: true) in 1:1 chats
+        // because userReceipt.userJid is the recipient's JID
+        if (!message?.key?.fromMe || !message.userReceipt?.length) {
+            continue;
+        }
+        const userJid = message.userReceipt[0]?.userJid;
+        if (userJid && (isPnUser(userJid) || isHostedPnUser(userJid))) {
+            return userJid;
+        }
+    }
+    return undefined;
+};
+export const downloadHistory = async (msg, options) => {
+    const stream = await downloadContentFromMessage(msg, 'md-msg-hist', { options });
+    const bufferArray = [];
+    for await (const chunk of stream) {
+        bufferArray.push(chunk);
+    }
+    let buffer = Buffer.concat(bufferArray);
+    // decompress buffer
+    buffer = await inflatePromise(buffer);
+    const syncData = proto.HistorySync.decode(buffer);
+    return syncData;
+};
+export const processHistoryMessage = (item, logger) => {
+    const messages = [];
+    const contacts = [];
+    const chats = [];
+    const lidPnMappings = [];
+    logger?.trace({ progress: item.progress }, 'processing history of type ' + item.syncType?.toString());
+    // Extract LID-PN mappings for all sync types
+    for (const m of item.phoneNumberToLidMappings || []) {
+        if (m.lidJid && m.pnJid) {
+            lidPnMappings.push({ lid: m.lidJid, pn: m.pnJid });
+        }
+    }
+    switch (item.syncType) {
+        case proto.HistorySync.HistorySyncType.INITIAL_BOOTSTRAP:
+        case proto.HistorySync.HistorySyncType.RECENT:
+        case proto.HistorySync.HistorySyncType.FULL:
+        case proto.HistorySync.HistorySyncType.ON_DEMAND:
+            for (const chat of item.conversations) {
+                contacts.push({
+                    id: chat.id,
+                    name: chat.displayName || chat.name || chat.username || undefined,
+                    lid: chat.lidJid || chat.accountLid || undefined,
+                    phoneNumber: chat.pnJid || undefined
+                });
+                const chatId = chat.id;
+                const isLid = isLidUser(chatId) || isHostedLidUser(chatId);
+                const isPn = isPnUser(chatId) || isHostedPnUser(chatId);
+                if (isLid && chat.pnJid) {
+                    lidPnMappings.push({ lid: chatId, pn: chat.pnJid });
+                }
+                else if (isPn && chat.lidJid) {
+                    lidPnMappings.push({ lid: chat.lidJid, pn: chatId });
+                }
+                else if (isLid && !chat.pnJid) {
+                    // Fallback: extract PN from userReceipt in messages when pnJid is missing
+                    const pnFromReceipt = extractPnFromMessages(chat.messages || []);
+                    if (pnFromReceipt) {
+                        lidPnMappings.push({ lid: chatId, pn: pnFromReceipt });
+                    }
+                }
+                const msgs = chat.messages || [];
+                delete chat.messages;
+                for (const item of msgs) {
+                    const message = item.message;
+                    messages.push(message);
+                    if (!chat.messages?.length) {
+                        // keep only the most recent message in the chat array
+                        chat.messages = [{ message }];
+                    }
+                    if (!message.key.fromMe && !chat.lastMessageRecvTimestamp) {
+                        chat.lastMessageRecvTimestamp = toNumber(message.messageTimestamp);
+                    }
+                    if ((message.messageStubType === WAMessageStubType.BIZ_PRIVACY_MODE_TO_BSP ||
+                        message.messageStubType === WAMessageStubType.BIZ_PRIVACY_MODE_TO_FB) &&
+                        message.messageStubParameters?.[0]) {
+                        contacts.push({
+                            id: message.key.participant || message.key.remoteJid,
+                            verifiedName: message.messageStubParameters?.[0]
+                        });
+                    }
+                }
+                chats.push({ ...chat });
+            }
+            break;
+        case proto.HistorySync.HistorySyncType.PUSH_NAME:
+            for (const c of item.pushnames) {
+                contacts.push({ id: c.id, notify: c.pushname });
+            }
+            break;
+    }
+    return {
+        chats,
+        contacts,
+        messages,
+        lidPnMappings,
+        syncType: item.syncType,
+        progress: item.progress
+    };
+};
+export const downloadAndProcessHistorySyncNotification = async (msg, options, logger) => {
+    let historyMsg;
+    if (msg.initialHistBootstrapInlinePayload) {
+        historyMsg = proto.HistorySync.decode(await inflatePromise(msg.initialHistBootstrapInlinePayload));
+    }
+    else {
+        historyMsg = await downloadHistory(msg, options);
+    }
+    return processHistoryMessage(historyMsg, logger);
+};
+export const getHistoryMsg = (message) => {
+    const normalizedContent = !!message ? normalizeMessageContent(message) : undefined;
+    const anyHistoryMsg = normalizedContent?.protocolMessage?.historySyncNotification;
+    return anyHistoryMsg;
+};
+//# sourceMappingURL=history.js.map

package/lib/Utils/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/Utils/history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAC9B,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAE9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAC5C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAClF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAA;AAE7D,MAAM,cAAc,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;AAEzC,MAAM,qBAAqB,GAAG,CAAC,QAAiC,EAAsB,EAAE;IACvF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAA;QAC/B,kEAAkE;QAClE,qDAAqD;QACrD,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;YAC3D,SAAQ;QACT,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,CAAA;QAC/C,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YAC/D,OAAO,OAAO,CAAA;QACf,CAAC;IACF,CAAC;IAED,OAAO,SAAS,CAAA;AACjB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,GAA2C,EAAE,OAAoB,EAAE,EAAE;IAC1G,MAAM,MAAM,GAAG,MAAM,0BAA0B,CAAC,GAAG,EAAE,aAAa,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;IAChF,MAAM,WAAW,GAAa,EAAE,CAAA;IAChC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAClC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACxB,CAAC;IAED,IAAI,MAAM,GAAW,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IAE/C,oBAAoB;IACpB,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAA;IAErC,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACjD,OAAO,QAAQ,CAAA;AAChB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,IAAwB,EAAE,MAAgB,EAAE,EAAE;IACnF,MAAM,QAAQ,GAAgB,EAAE,CAAA;IAChC,MAAM,QAAQ,GAAc,EAAE,CAAA;IAC9B,MAAM,KAAK,GAAW,EAAE,CAAA;IACxB,MAAM,aAAa,GAAiB,EAAE,CAAA;IAEtC,MAAM,EAAE,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,6BAA6B,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAA;IAErG,6CAA6C;IAC7C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,wBAAwB,IAAI,EAAE,EAAE,CAAC;QACrD,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;YACzB,aAAa,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAA;QACnD,CAAC;IACF,CAAC;IAED,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QACvB,KAAK,KAAK,CAAC,WAAW,CAAC,eAAe,CAAC,iBAAiB,CAAC;QACzD,KAAK,KAAK,CAAC,WAAW,CAAC,eAAe,CAAC,MAAM,CAAC;QAC9C,KAAK,KAAK,CAAC,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC;QAC5C,KAAK,KAAK,CAAC,WAAW,CAAC,eAAe,CAAC,SAAS;YAC/C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,aAAwB,EAAE,CAAC;gBAClD,QAAQ,CAAC,IAAI,CAAC;oBACb,EAAE,EAAE,IAAI,CAAC,EAAG;oBACZ,IAAI,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,IAAI,SAAS;oBACjE,GAAG,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,IAAI,SAAS;oBAChD,WAAW,EAAE,IAAI,CAAC,KAAK,IAAI,SAAS;iBACpC,CAAC,CAAA;gBAEF,MAAM,MAAM,GAAG,IAAI,CAAC,EAAG,CAAA;gBACvB,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,CAAA;gBAC1D,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC,CAAA;gBACvD,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBACzB,aAAa,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;gBACpD,CAAC;qBAAM,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;oBAChC,aAAa,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;gBACrD,CAAC;qBAAM,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;oBACjC,0EAA0E;oBAC1E,MAAM,aAAa,GAAG,qBAAqB,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAA;oBAChE,IAAI,aAAa,EAAE,CAAC;wBACnB,aAAa,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,CAAA;oBACvD,CAAC;gBACF,CAAC;gBAED,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAA;gBAChC,OAAO,IAAI,CAAC,QAAQ,CAAA;gBAEpB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;oBACzB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAqB,CAAA;oBAC1C,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;oBAEtB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;wBAC5B,sDAAsD;wBACtD,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;oBAC9B,CAAC;oBAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,wBAAwB,EAAE,CAAC;wBAC3D,IAAI,CAAC,wBAAwB,GAAG,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAA;oBACnE,CAAC;oBAED,IACC,CAAC,OAAO,CAAC,eAAe,KAAK,iBAAiB,CAAC,uBAAuB;wBACrE,OAAO,CAAC,eAAe,KAAK,iBAAiB,CAAC,sBAAsB,CAAC;wBACtE,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC,EACjC,CAAC;wBACF,QAAQ,CAAC,IAAI,CAAC;4BACb,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,SAAU;4BACrD,YAAY,EAAE,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC;yBAChD,CAAC,CAAA;oBACH,CAAC;gBACF,CAAC;gBAED,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAA;YACxB,CAAC;YAED,MAAK;QACN,KAAK,KAAK,CAAC,WAAW,CAAC,eAAe,CAAC,SAAS;YAC/C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAU,EAAE,CAAC;gBACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAG,EAAE,MAAM,EAAE,CAAC,CAAC,QAAS,EAAE,CAAC,CAAA;YAClD,CAAC;YAED,MAAK;IACP,CAAC;IAED,OAAO;QACN,KAAK;QACL,QAAQ;QACR,QAAQ;QACR,aAAa;QACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACvB,CAAA;AACF,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,yCAAyC,GAAG,KAAK,EAC7D,GAA2C,EAC3C,OAAoB,EACpB,MAAgB,EACf,EAAE;IACH,IAAI,UAA6B,CAAA;IACjC,IAAI,GAAG,CAAC,iCAAiC,EAAE,CAAC;QAC3C,UAAU,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,cAAc,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC,CAAA;IACnG,CAAC;SAAM,CAAC;QACP,UAAU,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IACjD,CAAC;IAED,OAAO,qBAAqB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;AACjD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAuB,EAAE,EAAE;IACxD,MAAM,iBAAiB,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAClF,MAAM,aAAa,GAAG,iBAAiB,EAAE,eAAe,EAAE,uBAAwB,CAAA;IAElF,OAAO,aAAa,CAAA;AACrB,CAAC,CAAA"}

package/lib/Utils/identity-change-handler.d.ts

@@ -0,0 +1,37 @@
+import NodeCache from '@cacheable/node-cache';
+import { type BinaryNode } from '../WABinary/index.js';
+import type { ILogger } from './logger.js';
+export type IdentityChangeResult = {
+    action: 'no_identity_node';
+} | {
+    action: 'invalid_notification';
+} | {
+    action: 'skipped_companion_device';
+    device: number;
+} | {
+    action: 'skipped_self_primary';
+} | {
+    action: 'debounced';
+} | {
+    action: 'skipped_offline';
+} | {
+    action: 'skipped_no_session';
+} | {
+    action: 'session_refreshed';
+} | {
+    action: 'session_refresh_failed';
+    error: unknown;
+};
+export type IdentityChangeContext = {
+    meId: string | undefined;
+    meLid: string | undefined;
+    validateSession: (jid: string) => Promise<{
+        exists: boolean;
+        reason?: string;
+    }>;
+    assertSessions: (jids: string[], force?: boolean) => Promise<boolean>;
+    debounceCache: NodeCache<boolean>;
+    logger: ILogger;
+};
+export declare function handleIdentityChange(node: BinaryNode, ctx: IdentityChangeContext): Promise<IdentityChangeResult>;
+//# sourceMappingURL=identity-change-handler.d.ts.map

package/lib/Utils/identity-change-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-change-handler.d.ts","sourceRoot":"","sources":["../../src/Utils/identity-change-handler.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,uBAAuB,CAAA;AAC7C,OAAO,EAAmB,KAAK,UAAU,EAAiC,MAAM,aAAa,CAAA;AAE7F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAEvC,MAAM,MAAM,oBAAoB,GAC7B;IAAE,MAAM,EAAE,kBAAkB,CAAA;CAAE,GAC9B;IAAE,MAAM,EAAE,sBAAsB,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,0BAA0B,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,MAAM,EAAE,sBAAsB,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,iBAAiB,CAAA;CAAE,GAC7B;IAAE,MAAM,EAAE,oBAAoB,CAAA;CAAE,GAChC;IAAE,MAAM,EAAE,mBAAmB,CAAA;CAAE,GAC/B;IAAE,MAAM,EAAE,wBAAwB,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AAEvD,MAAM,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACxB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC/E,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACrE,aAAa,EAAE,SAAS,CAAC,OAAO,CAAC,CAAA;IACjC,MAAM,EAAE,OAAO,CAAA;CACf,CAAA;AAED,wBAAsB,oBAAoB,CACzC,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,qBAAqB,GACxB,OAAO,CAAC,oBAAoB,CAAC,CAsD/B"}