@bellachu/xteambail 2.0.0

package/lib/Utils/history.js

@@ -0,0 +1,160 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.processHistoryMessage = exports.getHistoryMsg = exports.downloadHistory = exports.downloadAndProcessHistorySyncNotification = void 0;
+var _promises = require("stream/promises");
+var _util = require("util");
+var _zlib = require("zlib");
+var _index = require("../../WAProto/index.js");
+var _index2 = require("../Types/index.js");
+var _index3 = require("../WABinary/index.js");
+var _generics = require("./generics.js");
+var _messages = require("./messages.js");
+var _messagesMedia = require("./messages-media.js");
+const inflatePromise = (0, _util.promisify)(_zlib.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 && ((0, _index3.isPnUser)(userJid) || (0, _index3.isHostedPnUser)(userJid))) {
+      return userJid;
+    }
+  }
+  return undefined;
+};
+const downloadHistory = async (msg, options) => {
+  const stream = await (0, _messagesMedia.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 = (0, _zlib.createInflate)();
+  const chunks = [];
+  inflater.on('data', chunk => chunks.push(chunk));
+  await (0, _promises.pipeline)(stream, inflater);
+  const buffer = Buffer.concat(chunks);
+  const syncData = _index.proto.HistorySync.decode(buffer);
+  return syncData;
+};
+exports.downloadHistory = downloadHistory;
+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 _index.proto.HistorySync.HistorySyncType.INITIAL_BOOTSTRAP:
+    case _index.proto.HistorySync.HistorySyncType.RECENT:
+    case _index.proto.HistorySync.HistorySyncType.FULL:
+    case _index.proto.HistorySync.HistorySyncType.ON_DEMAND:
+      for (const chat of item.conversations) {
+        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 = (0, _index3.isLidUser)(chatId) || (0, _index3.isHostedLidUser)(chatId);
+        const isPn = (0, _index3.isPnUser)(chatId) || (0, _index3.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 = (0, _generics.toNumber)(message.messageTimestamp);
+          }
+          if ((message.messageStubType === _index2.WAMessageStubType.BIZ_PRIVACY_MODE_TO_BSP || message.messageStubType === _index2.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 _index.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,
+    pastParticipants: item.pastParticipants,
+    syncType: item.syncType,
+    progress: item.progress
+  };
+};
+exports.processHistoryMessage = processHistoryMessage;
+const downloadAndProcessHistorySyncNotification = async (msg, options, logger) => {
+  let historyMsg;
+  if (msg.initialHistBootstrapInlinePayload) {
+    historyMsg = _index.proto.HistorySync.decode(await inflatePromise(msg.initialHistBootstrapInlinePayload));
+  } else {
+    historyMsg = await downloadHistory(msg, options);
+  }
+  return processHistoryMessage(historyMsg, logger);
+};
+exports.downloadAndProcessHistorySyncNotification = downloadAndProcessHistorySyncNotification;
+const getHistoryMsg = message => {
+  const normalizedContent = !!message ? (0, _messages.normalizeMessageContent)(message) : undefined;
+  const anyHistoryMsg = normalizedContent?.protocolMessage?.historySyncNotification;
+  return anyHistoryMsg;
+};
+//# sourceMappingURL=history.js.map
+exports.getHistoryMsg = getHistoryMsg;

package/lib/Utils/history.js.map

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

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

@@ -0,0 +1,44 @@
+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;
+    /**
+     * Invoked right before `assertSessions` is called for an existing-session identity change.
+     * Used to kick off fire-and-forget side effects (e.g. tctoken re-issuance) in the same
+     * order WA Web does — i.e. before the E2E session is re-established.
+     * Must not throw; implementations are responsible for their own error handling.
+     */
+    onBeforeSessionRefresh?: (jid: string) => void;
+};
+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;IACf;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9C,CAAA;AAED,wBAAsB,oBAAoB,CACzC,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,qBAAqB,GACxB,OAAO,CAAC,oBAAoB,CAAC,CAwD/B"}

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

@@ -0,0 +1,94 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.handleIdentityChange = handleIdentityChange;
+var _nodeCache = _interopRequireDefault(require("@cacheable/node-cache"));
+var _index = require("../WABinary/index.js");
+var _generics = require("./generics.js");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+async function handleIdentityChange(node, ctx) {
+  const from = node.attrs.from;
+  if (!from) {
+    return {
+      action: 'invalid_notification'
+    };
+  }
+  const identityNode = (0, _index.getBinaryNodeChild)(node, 'identity');
+  if (!identityNode) {
+    return {
+      action: 'no_identity_node'
+    };
+  }
+  ctx.logger.info({
+    jid: from
+  }, 'identity changed');
+  const decoded = (0, _index.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 && ((0, _index.areJidsSameUser)(from, ctx.meId) || ctx.meLid && (0, _index.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 = !(0, _generics.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.ts"],"names":[],"mappings":"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"}

package/lib/Utils/index.d.ts

@@ -0,0 +1,22 @@
+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 './link-preview.js';
+export * from './event-buffer.js';
+export * from './process-message.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';
+//# 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.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,qBAAqB,CAAA;AACnC,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,uBAAuB,CAAA;AACrC,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA;AACzC,cAAc,cAAc,CAAA"}

package/lib/Utils/index.js

@@ -0,0 +1,236 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _generics = require("./generics.js");
+Object.keys(_generics).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _generics[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _generics[key];
+    }
+  });
+});
+var _decodeWaMessage = require("./decode-wa-message.js");
+Object.keys(_decodeWaMessage).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _decodeWaMessage[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _decodeWaMessage[key];
+    }
+  });
+});
+var _messages = require("./messages.js");
+Object.keys(_messages).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _messages[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _messages[key];
+    }
+  });
+});
+var _messagesMedia = require("./messages-media.js");
+Object.keys(_messagesMedia).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _messagesMedia[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _messagesMedia[key];
+    }
+  });
+});
+var _validateConnection = require("./validate-connection.js");
+Object.keys(_validateConnection).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _validateConnection[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _validateConnection[key];
+    }
+  });
+});
+var _crypto = require("./crypto.js");
+Object.keys(_crypto).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _crypto[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _crypto[key];
+    }
+  });
+});
+var _signal = require("./signal.js");
+Object.keys(_signal).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _signal[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _signal[key];
+    }
+  });
+});
+var _noiseHandler = require("./noise-handler.js");
+Object.keys(_noiseHandler).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _noiseHandler[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _noiseHandler[key];
+    }
+  });
+});
+var _history = require("./history.js");
+Object.keys(_history).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _history[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _history[key];
+    }
+  });
+});
+var _chatUtils = require("./chat-utils.js");
+Object.keys(_chatUtils).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _chatUtils[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _chatUtils[key];
+    }
+  });
+});
+var _ltHash = require("./lt-hash.js");
+Object.keys(_ltHash).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _ltHash[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _ltHash[key];
+    }
+  });
+});
+var _authUtils = require("./auth-utils.js");
+Object.keys(_authUtils).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _authUtils[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _authUtils[key];
+    }
+  });
+});
+var _useMultiFileAuthState = require("./use-multi-file-auth-state.js");
+Object.keys(_useMultiFileAuthState).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _useMultiFileAuthState[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useMultiFileAuthState[key];
+    }
+  });
+});
+var _linkPreview = require("./link-preview.js");
+Object.keys(_linkPreview).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _linkPreview[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _linkPreview[key];
+    }
+  });
+});
+var _eventBuffer = require("./event-buffer.js");
+Object.keys(_eventBuffer).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _eventBuffer[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _eventBuffer[key];
+    }
+  });
+});
+var _processMessage = require("./process-message.js");
+Object.keys(_processMessage).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _processMessage[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _processMessage[key];
+    }
+  });
+});
+var _messageRetryManager = require("./message-retry-manager.js");
+Object.keys(_messageRetryManager).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _messageRetryManager[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _messageRetryManager[key];
+    }
+  });
+});
+var _browserUtils = require("./browser-utils.js");
+Object.keys(_browserUtils).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _browserUtils[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _browserUtils[key];
+    }
+  });
+});
+var _companionRegClientUtils = require("./companion-reg-client-utils.js");
+Object.keys(_companionRegClientUtils).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _companionRegClientUtils[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _companionRegClientUtils[key];
+    }
+  });
+});
+var _identityChangeHandler = require("./identity-change-handler.js");
+Object.keys(_identityChangeHandler).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _identityChangeHandler[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _identityChangeHandler[key];
+    }
+  });
+});
+var _stanzaAck = require("./stanza-ack.js");
+Object.keys(_stanzaAck).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _stanzaAck[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _stanzaAck[key];
+    }
+  });
+});

package/lib/Utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,qBAAqB,CAAA;AACnC,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,uBAAuB,CAAA;AACrC,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA;AACzC,cAAc,cAAc,CAAA"}

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

@@ -0,0 +1,21 @@
+import type { WAMediaUploadFunction, WAUrlInfo } from '../Types/index.js';
+import type { ILogger } from './logger.js';
+export type URLGenerationOptions = {
+    thumbnailWidth: number;
+    fetchOpts: {
+        /** Timeout in ms */
+        timeout: number;
+        proxyUrl?: string;
+        headers?: HeadersInit;
+    };
+    uploadImage?: WAMediaUploadFunction;
+    logger?: ILogger;
+};
+/**
+ * Given a piece of text, checks for any URL present, generates link preview for the same and returns it
+ * Return undefined if the fetch failed or no URL was found
+ * @param text first matched URL in text
+ * @returns the URL info required to generate link preview
+ */
+export declare const getUrlInfo: (text: string, opts?: URLGenerationOptions) => Promise<WAUrlInfo | 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.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAavC,MAAM,MAAM,oBAAoB,GAAG;IAClC,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE;QACV,oBAAoB;QACpB,OAAO,EAAE,MAAM,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,OAAO,CAAC,EAAE,WAAW,CAAA;KACrB,CAAA;IACD,WAAW,CAAC,EAAE,qBAAqB,CAAA;IACnC,MAAM,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GACtB,MAAM,MAAM,EACZ,OAAM,oBAGL,KACC,OAAO,CAAC,SAAS,GAAG,SAAS,CAwE/B,CAAA"}