@violetix/baileys 0.0.0-stage → 0.4.0

package/lib/Utils/history.js

@@ -0,0 +1,188 @@
+import { pipeline } from 'stream/promises';
+import { promisify } from 'util';
+import { createInflate, inflate } from 'zlib';
+import $protobuf from 'protobufjs/minimal.js';
+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;
+};
+const HISTORY_SYNC_CONVERSATIONS_FIELD = 2;
+const WIRE_TYPE_LENGTH_DELIMITED = 2;
+/**
+ * Decodes a HistorySync one conversation at a time. `proto.HistorySync.decode` materializes
+ * the whole tree, so for a large chunk every message of every chat is alive at once; walking
+ * the top-level fields instead lets each conversation be reduced and dropped before the next
+ * one is decoded. Non-conversation fields are copied raw and decoded together at the end.
+ */
+export const decodeHistorySyncStreaming = (buffer, onConversation) => {
+    const reader = $protobuf.Reader.create(buffer);
+    const rest = [];
+    while (reader.pos < reader.len) {
+        const start = reader.pos;
+        const tag = reader.uint32();
+        if (tag >>> 3 === HISTORY_SYNC_CONVERSATIONS_FIELD && (tag & 7) === WIRE_TYPE_LENGTH_DELIMITED) {
+            onConversation(proto.Conversation.decode(reader, reader.uint32()));
+        }
+        else {
+            reader.skipType(tag & 7);
+            rest.push(buffer.subarray(start, reader.pos));
+        }
+    }
+    return proto.HistorySync.decode(rest.length === 1 ? rest[0] : Buffer.concat(rest));
+};
+const inflateHistoryStream = async (msg, options) => {
+    const stream = await downloadContentFromMessage(msg, 'md-msg-hist', { options });
+    // Pipe decrypted stream directly through zlib inflate
+    // This avoids allocating an intermediate buffer for the compressed data
+    const inflater = createInflate();
+    const chunks = [];
+    inflater.on('data', (chunk) => chunks.push(chunk));
+    await pipeline(stream, inflater);
+    return Buffer.concat(chunks);
+};
+export const downloadHistory = async (msg, options) => {
+    return proto.HistorySync.decode(await inflateHistoryStream(msg, options));
+};
+const createHistoryAccumulator = (logger) => {
+    const messages = [];
+    const contacts = [];
+    const chats = [];
+    const convLidPnMappings = [];
+    const addConversation = (chat) => {
+        contacts.push({
+            id: chat.id,
+            name: chat.displayName || chat.name || chat.username || undefined,
+            username: 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) {
+            convLidPnMappings.push({ lid: chatId, pn: chat.pnJid });
+        }
+        else if (isPn && chat.lidJid) {
+            convLidPnMappings.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) {
+                convLidPnMappings.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.participant || message.key.participant || message.key.remoteJid,
+                    verifiedName: message.messageStubParameters?.[0]
+                });
+            }
+        }
+        chats.push(chat);
+    };
+    const finish = (item) => {
+        logger?.trace({ progress: item.progress }, 'processing history of type ' + item.syncType?.toString());
+        // Extract LID-PN mappings for all sync types
+        const lidPnMappings = [];
+        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 || []) {
+                    addConversation(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: [...lidPnMappings, ...convLidPnMappings],
+            pastParticipants: item.pastParticipants,
+            syncType: item.syncType,
+            progress: item.progress
+        };
+    };
+    return { addConversation, finish };
+};
+export const processHistoryMessage = (item, logger) => createHistoryAccumulator(logger).finish(item);
+const HISTORY_SYNC_TYPE_FIELD = 1;
+const CONVERSATION_SYNC_TYPES = new Set([
+    proto.HistorySync.HistorySyncType.INITIAL_BOOTSTRAP,
+    proto.HistorySync.HistorySyncType.RECENT,
+    proto.HistorySync.HistorySyncType.FULL,
+    proto.HistorySync.HistorySyncType.ON_DEMAND
+]);
+/** Reads only the `syncType` varint, skipping every other field without decoding it. */
+const peekHistorySyncType = (buffer) => {
+    const reader = $protobuf.Reader.create(buffer);
+    while (reader.pos < reader.len) {
+        const tag = reader.uint32();
+        if (tag >>> 3 === HISTORY_SYNC_TYPE_FIELD && (tag & 7) === 0) {
+            return reader.int32();
+        }
+        reader.skipType(tag & 7);
+    }
+    return undefined;
+};
+export const downloadAndProcessHistorySyncNotification = async (msg, options, logger) => {
+    const buffer = msg.initialHistBootstrapInlinePayload
+        ? await inflatePromise(msg.initialHistBootstrapInlinePayload)
+        : await inflateHistoryStream(msg, options);
+    const acc = createHistoryAccumulator(logger);
+    // conversations are reduced as they are decoded, only for the sync types that carry chats
+    // (same gate as processHistoryMessage); `rest` holds every other field
+    const wantsConversations = CONVERSATION_SYNC_TYPES.has(peekHistorySyncType(buffer));
+    const rest = decodeHistorySyncStreaming(buffer, wantsConversations ? acc.addConversation : () => { });
+    return acc.finish(rest);
+};
+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.js"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,14 @@
+export function handleIdentityChange(node: any, ctx: any): Promise<{
+    action: string;
+    device?: undefined;
+    error?: undefined;
+} | {
+    action: string;
+    device: number;
+    error?: undefined;
+} | {
+    action: string;
+    error: unknown;
+    device?: undefined;
+}>;
+//# 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.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GA6CC"}

package/lib/Utils/identity-change-handler.js

@@ -0,0 +1,50 @@
+import NodeCache from '@cacheable/node-cache';
+import { areJidsSameUser, getBinaryNodeChild, jidDecode } from '../WABinary/index.js';
+import { isStringNullOrEmpty } from './generics.js';
+export async function handleIdentityChange(node, ctx) {
+    const from = node.attrs.from;
+    if (!from) {
+        return { action: 'invalid_notification' };
+    }
+    const identityNode = getBinaryNodeChild(node, 'identity');
+    if (!identityNode) {
+        return { action: 'no_identity_node' };
+    }
+    ctx.logger.info({ jid: from }, 'identity changed');
+    const decoded = jidDecode(from);
+    if (decoded?.device && decoded.device !== 0) {
+        ctx.logger.debug({ jid: from, device: decoded.device }, 'ignoring identity change from companion device');
+        return { action: 'skipped_companion_device', device: decoded.device };
+    }
+    const isSelfPrimary = ctx.meId && (areJidsSameUser(from, ctx.meId) || (ctx.meLid && areJidsSameUser(from, ctx.meLid)));
+    if (isSelfPrimary) {
+        ctx.logger.info({ jid: from }, 'self primary identity changed');
+        return { action: 'skipped_self_primary' };
+    }
+    if (ctx.debounceCache.get(from)) {
+        ctx.logger.debug({ jid: from }, 'skipping identity assert (debounced)');
+        return { action: 'debounced' };
+    }
+    ctx.debounceCache.set(from, true);
+    const isOfflineNotification = !isStringNullOrEmpty(node.attrs.offline);
+    const hasExistingSession = await ctx.validateSession(from);
+    if (!hasExistingSession.exists) {
+        ctx.logger.debug({ jid: from }, 'no old session, skipping session refresh');
+        return { action: 'skipped_no_session' };
+    }
+    ctx.logger.debug({ jid: from }, 'old session exists, will refresh session');
+    if (isOfflineNotification) {
+        ctx.logger.debug({ jid: from }, 'skipping session refresh during offline processing');
+        return { action: 'skipped_offline' };
+    }
+    ctx.onBeforeSessionRefresh?.(from);
+    try {
+        await ctx.assertSessions([from], true);
+        return { action: 'session_refreshed' };
+    }
+    catch (error) {
+        ctx.logger.warn({ error, jid: from }, 'failed to assert sessions after identity change');
+        return { action: 'session_refresh_failed', error };
+    }
+}
+//# sourceMappingURL=identity-change-handler.js.map

package/lib/Utils/identity-change-handler.js.map

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

package/lib/Utils/ignore-key.d.ts

@@ -0,0 +1,51 @@
+import type { BinaryNode } from '../WABinary/index.js';
+export declare const IGNORE_KEY_KINDS: readonly ['message', 'receipt', 'notification', 'presence', 'chatstate', 'call'];
+export type WaIgnoreKeyKind = (typeof IGNORE_KEY_KINDS)[number];
+export type WaIgnoreKeyContext = {
+    /** Stanza tag. */
+    kind: WaIgnoreKeyKind;
+    /** Deviceless chat JID; userless `from` values are kept verbatim. */
+    remoteJid: string | null;
+    /** Resolved against the account's own PN and LID. */
+    fromMe: boolean;
+    /** Stanza id. */
+    id: string | undefined;
+    /** Author in groups / broadcasts; `null` otherwise. */
+    participant: string | null;
+};
+export type WaIgnoreKey = {
+    /** Chat JID; array entries OR. Alt `sender_pn` / `sender_lid` attrs are matched too. */
+    remoteJid?: string | readonly string[];
+    /** Whether the stanza was sent by this account. */
+    fromMe?: boolean;
+    /** Stanza id. */
+    id?: string;
+    /** Author in groups / broadcasts. Alt forms are matched too. */
+    participant?: string;
+    /** Restrict to specific tags. Default: all six. */
+    only?: readonly WaIgnoreKeyKind[];
+};
+export type WaIgnoreKeyPredicate = (ctx: WaIgnoreKeyContext) => boolean;
+export type WaIgnoreKeyInput = WaIgnoreKey | WaIgnoreKeyPredicate;
+export type WaIgnoreKeyEntry = {
+    remoteJid?: string[];
+    participant?: string;
+    fromMe?: boolean;
+    id?: string;
+    only?: readonly WaIgnoreKeyKind[];
+    predicate?: WaIgnoreKeyPredicate;
+};
+export declare const isIgnorableKind: (tag: string) => boolean;
+export declare const normalizeIgnoreKey: (input: WaIgnoreKeyInput) => WaIgnoreKeyEntry;
+export declare const buildIgnoreContext: (node: BinaryNode, meId?: string, meLid?: string) => WaIgnoreKeyContext;
+export declare const matchesIgnoreKey: (entry: WaIgnoreKeyEntry, ctx: WaIgnoreKeyContext, node: BinaryNode) => boolean;
+export declare const ignoredStanzaNeedsAck: (tag: string) => boolean;
+export declare const makeIgnoreKeyRegistry: (deps: {
+    getMeId: () => string | undefined;
+    getMeLid: () => string | undefined;
+    logger?: any;
+}) => {
+    register: (input: WaIgnoreKeyInput) => () => void;
+    shouldDrop: (node: BinaryNode) => boolean;
+    readonly size: number;
+};

package/lib/Utils/ignore-key.js

@@ -0,0 +1,174 @@
+import { areJidsSameUser, jidDecode, jidEncode } from '../WABinary/index.js';
+/**
+ * Stanza tags a filter may drop. Stream control, `iq` replies and the auth-critical
+ * `success` / `failure` tags are deliberately absent so the connection flow stays intact.
+ */
+export const IGNORE_KEY_KINDS = ['message', 'receipt', 'notification', 'presence', 'chatstate', 'call'];
+const IGNORE_KEY_KIND_SET = new Set(IGNORE_KEY_KINDS);
+/**
+ * Kinds the server re-delivers until acked. Dropping one without an ack makes the server
+ * retry it forever, so the filter acks on the handler's behalf. Presence and chat-state are
+ * fire-and-forget and must not be acked.
+ */
+const ACKED_KINDS = new Set(['message', 'receipt', 'notification', 'call']);
+/**
+ * A JID arrives in whichever namespace the sender used, and the alt attributes carry the other
+ * form. Matching every one of these lets a filter written with a phone number also catch the
+ * LID-addressed copy of the same stanza (and vice versa).
+ */
+const REMOTE_JID_ATTRS = ['from', 'sender_pn', 'sender_lid'];
+const PARTICIPANT_ATTRS = ['participant', 'participant_pn', 'participant_lid'];
+const DESCRIPTOR_FIELDS = ['remoteJid', 'fromMe', 'id', 'participant'];
+/** Deviceless user-form JID. Userless values (e.g. `s.whatsapp.net`) are kept verbatim. */
+const stripDevice = (jid) => {
+    if (!jid) {
+        return null;
+    }
+    const decoded = jidDecode(jid);
+    if (!decoded?.user) {
+        return jid;
+    }
+    return jidEncode(decoded.user, decoded.server);
+};
+/**
+ * Compares deviceless JIDs as whole strings rather than by user part. `areJidsSameUser` ignores
+ * the server, so it reports `5551234@s.whatsapp.net` and `5551234@lid` as the same user — two
+ * unrelated accounts that would then share a filter. Server equality is required here; the
+ * PN/LID crossover is handled by the alt attributes instead.
+ */
+const sameJid = (a, b) => {
+    if (!a || !b) {
+        return false;
+    }
+    return stripDevice(a) === stripDevice(b);
+};
+export const isIgnorableKind = (tag) => IGNORE_KEY_KIND_SET.has(tag);
+/** Validates a descriptor or predicate and freezes it into an internal entry. */
+export const normalizeIgnoreKey = (input) => {
+    if (typeof input === 'function') {
+        return { predicate: input };
+    }
+    if (!input || typeof input !== 'object' || Array.isArray(input)) {
+        throw new Error('ignoreKey expects a descriptor object or a predicate function');
+    }
+    if (!DESCRIPTOR_FIELDS.some(field => input[field] !== undefined)) {
+        throw new Error('ignoreKey descriptor needs at least one of remoteJid, fromMe, id, participant');
+    }
+    const entry = {};
+    if (input.remoteJid !== undefined) {
+        const jids = (Array.isArray(input.remoteJid) ? input.remoteJid : [input.remoteJid]).filter(Boolean);
+        if (!jids.length) {
+            throw new Error('ignoreKey remoteJid cannot be empty');
+        }
+        entry.remoteJid = jids;
+    }
+    if (input.participant !== undefined) {
+        if (typeof input.participant !== 'string' || !input.participant) {
+            throw new Error('ignoreKey participant must be a non-empty jid');
+        }
+        entry.participant = input.participant;
+    }
+    if (input.fromMe !== undefined) {
+        entry.fromMe = !!input.fromMe;
+    }
+    if (input.id !== undefined) {
+        if (typeof input.id !== 'string' || !input.id) {
+            throw new Error('ignoreKey id must be a non-empty string');
+        }
+        entry.id = input.id;
+    }
+    if (input.only !== undefined) {
+        const only = Array.isArray(input.only) ? input.only : [input.only];
+        if (!only.length) {
+            throw new Error('ignoreKey only cannot be empty');
+        }
+        const unknown = only.filter(kind => !IGNORE_KEY_KIND_SET.has(kind));
+        if (unknown.length) {
+            throw new Error(`ignoreKey only has unknown kinds: ${unknown.join(', ')}`);
+        }
+        entry.only = only;
+    }
+    return entry;
+};
+/**
+ * Parses the wire node into the shape filters match on, so a predicate never has to walk a
+ * BinaryNode. `remoteJid` and `participant` are device-stripped to line up with the
+ * `event.key.remoteJid` a handler would see.
+ */
+export const buildIgnoreContext = (node, meId, meLid) => {
+    const attrs = node.attrs || {};
+    const author = attrs.participant || attrs.participant_pn || attrs.participant_lid || attrs.from;
+    const fromMe = !!author && ((!!meId && areJidsSameUser(author, meId)) || (!!meLid && areJidsSameUser(author, meLid)));
+    return {
+        kind: node.tag,
+        remoteJid: stripDevice(attrs.from),
+        fromMe,
+        id: attrs.id,
+        participant: stripDevice(attrs.participant || attrs.participant_pn || attrs.participant_lid)
+    };
+};
+export const matchesIgnoreKey = (entry, ctx, node) => {
+    if (entry.predicate) {
+        return !!entry.predicate(ctx);
+    }
+    if (entry.only && !entry.only.includes(ctx.kind)) {
+        return false;
+    }
+    if (entry.id !== undefined && entry.id !== ctx.id) {
+        return false;
+    }
+    if (entry.fromMe !== undefined && entry.fromMe !== ctx.fromMe) {
+        return false;
+    }
+    const attrs = node.attrs || {};
+    if (entry.remoteJid && !entry.remoteJid.some(wanted => REMOTE_JID_ATTRS.some(attr => sameJid(attrs[attr], wanted)))) {
+        return false;
+    }
+    if (entry.participant && !PARTICIPANT_ATTRS.some(attr => sameJid(attrs[attr], entry.participant))) {
+        return false;
+    }
+    return true;
+};
+export const ignoredStanzaNeedsAck = (tag) => ACKED_KINDS.has(tag);
+/**
+ * Holds the registered filters and answers the one question the socket asks per stanza.
+ *
+ * `category='peer'` traffic from this account's own devices is never dropped: those stanzas
+ * carry app-state key shares, history sync and PDO responses between the account's devices, so
+ * the common `{ fromMe: true }` filter would otherwise swallow the app-state key share and leave
+ * the collections blocked on a key they re-request on every sync. The exemption only applies
+ * when the sender really is this account — resolved against both `meJid` and `meLid` — so a
+ * foreign stanza cannot dodge a filter by stamping the attribute.
+ */
+export const makeIgnoreKeyRegistry = ({ getMeId, getMeLid, logger }) => {
+    const entries = new Set();
+    const register = (input) => {
+        const entry = normalizeIgnoreKey(input);
+        entries.add(entry);
+        return () => {
+            entries.delete(entry);
+        };
+    };
+    const shouldDrop = (node) => {
+        if (!entries.size || !isIgnorableKind(node.tag)) {
+            return false;
+        }
+        const ctx = buildIgnoreContext(node, getMeId(), getMeLid());
+        if (ctx.fromMe && node.attrs?.category === 'peer') {
+            return false;
+        }
+        for (const entry of entries) {
+            try {
+                if (matchesIgnoreKey(entry, ctx, node)) {
+                    return true;
+                }
+            }
+            catch (err) {
+                // A throwing predicate must not take the stanza with it; the stanza stays.
+                logger?.error({ err, kind: ctx.kind, id: ctx.id }, 'ignoreKey filter threw, keeping stanza');
+            }
+        }
+        return false;
+    };
+    return { register, shouldDrop, get size() { return entries.size; } };
+};

package/lib/Utils/index.d.ts

@@ -0,0 +1,29 @@
+export * from "./generics.js";
+export * from "./decode-wa-message.js";
+export * from "./messages.js";
+export * from "./messages-media.js";
+export * from "./validate-connection.js";
+export * from "./crypto.js";
+export * from "./signal.js";
+export * from "./noise-handler.js";
+export * from "./history.js";
+export * from "./chat-utils.js";
+export * from "./lt-hash.js";
+export * from "./auth-utils.js";
+export * from "./use-multi-file-auth-state.js";
+export * from "./use-single-file-auth-state.js";
+export * from "./use-sqlite-auth-state.js";
+export * from "./link-preview.js";
+export * from "./event-buffer.js";
+export * from "./process-message.js";
+export * from "./rich-message-utils.js";
+export * from "./message-retry-manager.js";
+export * from "./browser-utils.js";
+export * from "./companion-reg-client-utils.js";
+export * from "./identity-change-handler.js";
+export * from "./stanza-ack.js";
+export * from "./ignore-key.js";
+export * from "./anchor-guard.js";
+export * from "./a2ui.js";
+export * from "./meta-ai-msmsg.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Utils/index.js"],"names":[],"mappings":""}

package/lib/Utils/index.js

@@ -0,0 +1,29 @@
+export * from './generics.js';
+export * from './decode-wa-message.js';
+export * from './messages.js';
+export * from './messages-media.js';
+export * from './validate-connection.js';
+export * from './crypto.js';
+export * from './signal.js';
+export * from './noise-handler.js';
+export * from './history.js';
+export * from './chat-utils.js';
+export * from './lt-hash.js';
+export * from './auth-utils.js';
+export * from './use-multi-file-auth-state.js';
+export * from './use-single-file-auth-state.js';
+export * from './use-sqlite-auth-state.js';
+export * from './link-preview.js';
+export * from './event-buffer.js';
+export * from './process-message.js';
+export * from './rich-message-utils.js';
+export * from './message-retry-manager.js';
+export * from './browser-utils.js';
+export * from './companion-reg-client-utils.js';
+export * from './identity-change-handler.js';
+export * from './stanza-ack.js';
+export * from './ignore-key.js';
+export * from './anchor-guard.js';
+export * from './a2ui.js';
+export * from './meta-ai-msmsg.js';
+//# sourceMappingURL=index.js.map

package/lib/Utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Utils/index.js"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC"}

package/lib/Utils/link-preview.d.ts

@@ -0,0 +1,13 @@
+export function getUrlInfo(text: any, opts?: {
+    thumbnailWidth: number;
+    fetchOpts: {
+        timeout: number;
+    };
+}): Promise<{
+    'canonical-url': any;
+    'matched-text': any;
+    title: any;
+    description: any;
+    originalThumbnailUrl: any;
+} | undefined>;
+//# sourceMappingURL=link-preview.d.ts.map

package/lib/Utils/link-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-preview.d.ts","sourceRoot":"","sources":["../../src/Utils/link-preview.js"],"names":[],"mappings":"AAeO;;;;;;;;;;;eAoEN"}