@bellachu/xteambail 2.0.0

package/lib/Utils/signal.d.ts

@@ -0,0 +1,47 @@
+import type { SignalRepositoryWithLIDStore } from '../Types/index.js';
+import type { AuthenticationCreds, AuthenticationState, KeyPair, SignalIdentity, SignalKeyStore, SignedKeyPair } from '../Types/Auth.js';
+import { type BinaryNode, type FullJid } from '../WABinary/index.js';
+import type { USyncQueryResultList } from '../WAUSync/index.js';
+export declare const createSignalIdentity: (wid: string, accountSignatureKey: Uint8Array) => SignalIdentity;
+export declare const getPreKeys: ({ get }: SignalKeyStore, min: number, limit: number) => Promise<{
+    [id: string]: KeyPair;
+}>;
+export declare const generateOrGetPreKeys: (creds: AuthenticationCreds, range: number) => {
+    newPreKeys: {
+        [id: number]: KeyPair;
+    };
+    lastPreKeyId: number;
+    preKeysRange: readonly [number, number];
+};
+export declare const xmppSignedPreKey: (key: SignedKeyPair) => BinaryNode;
+export declare const xmppPreKey: (pair: KeyPair, id: number) => BinaryNode;
+export declare const extractE2ESessionFromRetryReceipt: (receipt: BinaryNode) => {
+    registrationId: number;
+    identityKey: Uint8Array<ArrayBufferLike> | Buffer<ArrayBufferLike>;
+    signedPreKey: {
+        keyId: number;
+        publicKey: Uint8Array<ArrayBufferLike> | Buffer<ArrayBufferLike>;
+        signature: Uint8Array<ArrayBufferLike> | Buffer<ArrayBufferLike>;
+    };
+    preKey: {
+        keyId: number;
+        publicKey: Uint8Array;
+    } | undefined;
+} | null;
+export declare const parseAndInjectE2ESessions: (node: BinaryNode, repository: SignalRepositoryWithLIDStore) => Promise<void>;
+export declare const extractDeviceJids: (result: USyncQueryResultList[], myJid: string, myLid: string, excludeZeroDevices: boolean) => FullJid[];
+/**
+ * get the next N keys for upload or processing
+ * @param count number of pre-keys to get or generate
+ */
+export declare const getNextPreKeys: ({ creds, keys }: AuthenticationState, count: number) => Promise<{
+    update: Partial<AuthenticationCreds>;
+    preKeys: {
+        [id: string]: KeyPair;
+    };
+}>;
+export declare const getNextPreKeysNode: (state: AuthenticationState, count: number) => Promise<{
+    update: Partial<AuthenticationCreds>;
+    node: BinaryNode;
+}>;
+//# sourceMappingURL=signal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../src/Utils/signal.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAA;AAC5D,OAAO,KAAK,EACX,mBAAmB,EACnB,mBAAmB,EACnB,OAAO,EACP,cAAc,EACd,cAAc,EACd,aAAa,EACb,MAAM,eAAe,CAAA;AACtB,OAAO,EAEN,KAAK,UAAU,EACf,KAAK,OAAO,EASZ,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAoC,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAaxF,eAAO,MAAM,oBAAoB,GAAI,KAAK,MAAM,EAAE,qBAAqB,UAAU,KAAG,cAKnF,CAAA;AAED,eAAO,MAAM,UAAU,GAAU,SAAS,cAAc,EAAE,KAAK,MAAM,EAAE,OAAO,MAAM;;EAOnF,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,OAAO,mBAAmB,EAAE,OAAO,MAAM;;;;;;CAgB7E,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,KAAK,aAAa,KAAG,UAQpD,CAAA;AAEF,eAAO,MAAM,UAAU,GAAI,MAAM,OAAO,EAAE,IAAI,MAAM,KAAG,UAOrD,CAAA;AAIF,eAAO,MAAM,iCAAiC,GAAI,SAAS,UAAU;;;;;;;;;eAsB/C,MAAM;mBAAa,UAAU;;QAqBlD,CAAA;AAED,eAAO,MAAM,yBAAyB,GAAU,MAAM,UAAU,EAAE,YAAY,4BAA4B,kBA0CzG,CAAA;AAED,eAAO,MAAM,iBAAiB,GAC7B,QAAQ,oBAAoB,EAAE,EAC9B,OAAO,MAAM,EACb,OAAO,MAAM,EACb,oBAAoB,OAAO,cAkC3B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAU,iBAAiB,mBAAmB,EAAE,OAAO,MAAM;;;;;EAavF,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAU,OAAO,mBAAmB,EAAE,OAAO,MAAM;;;EAqBjF,CAAA"}

package/lib/Utils/signal.js

@@ -0,0 +1,279 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.xmppSignedPreKey = exports.xmppPreKey = exports.parseAndInjectE2ESessions = exports.getPreKeys = exports.getNextPreKeysNode = exports.getNextPreKeys = exports.generateOrGetPreKeys = exports.extractE2ESessionFromRetryReceipt = exports.extractDeviceJids = exports.createSignalIdentity = void 0;
+var _index = require("../Defaults/index.js");
+var _index2 = require("../WABinary/index.js");
+var _crypto = require("./crypto.js");
+var _generics = require("./generics.js");
+function chunk(array, size) {
+  const chunks = [];
+  for (let i = 0; i < array.length; i += size) {
+    chunks.push(array.slice(i, i + size));
+  }
+  return chunks;
+}
+const createSignalIdentity = (wid, accountSignatureKey) => {
+  return {
+    identifier: {
+      name: wid,
+      deviceId: 0
+    },
+    identifierKey: (0, _crypto.generateSignalPubKey)(accountSignatureKey)
+  };
+};
+exports.createSignalIdentity = createSignalIdentity;
+const getPreKeys = async ({
+  get
+}, min, limit) => {
+  const idList = [];
+  for (let id = min; id < limit; id++) {
+    idList.push(id.toString());
+  }
+  return get('pre-key', idList);
+};
+exports.getPreKeys = getPreKeys;
+const generateOrGetPreKeys = (creds, range) => {
+  const avaliable = creds.nextPreKeyId - creds.firstUnuploadedPreKeyId;
+  const remaining = range - avaliable;
+  const lastPreKeyId = creds.nextPreKeyId + remaining - 1;
+  const newPreKeys = {};
+  if (remaining > 0) {
+    for (let i = creds.nextPreKeyId; i <= lastPreKeyId; i++) {
+      newPreKeys[i] = _crypto.Curve.generateKeyPair();
+    }
+  }
+  return {
+    newPreKeys,
+    lastPreKeyId,
+    preKeysRange: [creds.firstUnuploadedPreKeyId, range]
+  };
+};
+exports.generateOrGetPreKeys = generateOrGetPreKeys;
+const xmppSignedPreKey = key => ({
+  tag: 'skey',
+  attrs: {},
+  content: [{
+    tag: 'id',
+    attrs: {},
+    content: (0, _generics.encodeBigEndian)(key.keyId, 3)
+  }, {
+    tag: 'value',
+    attrs: {},
+    content: key.keyPair.public
+  }, {
+    tag: 'signature',
+    attrs: {},
+    content: key.signature
+  }]
+});
+exports.xmppSignedPreKey = xmppSignedPreKey;
+const xmppPreKey = (pair, id) => ({
+  tag: 'key',
+  attrs: {},
+  content: [{
+    tag: 'id',
+    attrs: {},
+    content: (0, _generics.encodeBigEndian)(id, 3)
+  }, {
+    tag: 'value',
+    attrs: {},
+    content: pair.public
+  }]
+});
+exports.xmppPreKey = xmppPreKey;
+const isValidUInt = n => typeof n === 'number' && Number.isInteger(n);
+const extractE2ESessionFromRetryReceipt = receipt => {
+  const keysNode = (0, _index2.getBinaryNodeChild)(receipt, 'keys');
+  if (!keysNode) return null;
+  const typeBuf = (0, _index2.getBinaryNodeChildBuffer)(keysNode, 'type');
+  if (!typeBuf || typeBuf.length !== 1 || typeBuf[0] !== _index.KEY_BUNDLE_TYPE[0]) return null;
+  const identity = (0, _index2.getBinaryNodeChildBuffer)(keysNode, 'identity');
+  const skey = (0, _index2.getBinaryNodeChild)(keysNode, 'skey');
+  if (!identity || identity.length !== 32 || !skey) return null;
+  const registrationId = (0, _index2.getBinaryNodeChildUInt)(receipt, 'registration', 4);
+  if (!isValidUInt(registrationId)) return null;
+  const signedPubKey = (0, _index2.getBinaryNodeChildBuffer)(skey, 'value');
+  const signedSig = (0, _index2.getBinaryNodeChildBuffer)(skey, 'signature');
+  const signedKeyId = (0, _index2.getBinaryNodeChildUInt)(skey, 'id', 3);
+  if (!signedPubKey || signedPubKey.length !== 32 || !signedSig || !isValidUInt(signedKeyId)) {
+    return null;
+  }
+  const preKeyNode = (0, _index2.getBinaryNodeChild)(keysNode, 'key');
+  let preKey;
+  if (preKeyNode) {
+    const preKeyPub = (0, _index2.getBinaryNodeChildBuffer)(preKeyNode, 'value');
+    const preKeyId = (0, _index2.getBinaryNodeChildUInt)(preKeyNode, 'id', 3);
+    if (!preKeyPub || preKeyPub.length !== 32 || !isValidUInt(preKeyId)) {
+      return null;
+    }
+    preKey = {
+      keyId: preKeyId,
+      publicKey: (0, _crypto.generateSignalPubKey)(preKeyPub)
+    };
+  }
+  return {
+    registrationId,
+    identityKey: (0, _crypto.generateSignalPubKey)(identity),
+    signedPreKey: {
+      keyId: signedKeyId,
+      publicKey: (0, _crypto.generateSignalPubKey)(signedPubKey),
+      signature: signedSig
+    },
+    preKey
+  };
+};
+exports.extractE2ESessionFromRetryReceipt = extractE2ESessionFromRetryReceipt;
+const parseAndInjectE2ESessions = async (node, repository) => {
+  const extractKey = key => key ? {
+    keyId: (0, _index2.getBinaryNodeChildUInt)(key, 'id', 3),
+    publicKey: (0, _crypto.generateSignalPubKey)((0, _index2.getBinaryNodeChildBuffer)(key, 'value')),
+    signature: (0, _index2.getBinaryNodeChildBuffer)(key, 'signature')
+  } : undefined;
+  const nodes = (0, _index2.getBinaryNodeChildren)((0, _index2.getBinaryNodeChild)(node, 'list'), 'user');
+  for (const node of nodes) {
+    (0, _index2.assertNodeErrorFree)(node);
+  }
+  // Most of the work in repository.injectE2ESession is CPU intensive, not IO
+  // So Promise.all doesn't really help here,
+  // but blocks even loop if we're using it inside keys.transaction, and it makes it "sync" actually
+  // This way we chunk it in smaller parts and between those parts we can yield to the event loop
+  // It's rare case when you need to E2E sessions for so many users, but it's possible
+  const chunkSize = 100;
+  const chunks = chunk(nodes, chunkSize);
+  for (const nodesChunk of chunks) {
+    for (const node of nodesChunk) {
+      const signedKey = (0, _index2.getBinaryNodeChild)(node, 'skey');
+      const key = (0, _index2.getBinaryNodeChild)(node, 'key');
+      const identity = (0, _index2.getBinaryNodeChildBuffer)(node, 'identity');
+      const jid = node.attrs.jid;
+      const registrationId = (0, _index2.getBinaryNodeChildUInt)(node, 'registration', 4);
+      await repository.injectE2ESession({
+        jid,
+        session: {
+          registrationId: registrationId,
+          identityKey: (0, _crypto.generateSignalPubKey)(identity),
+          signedPreKey: extractKey(signedKey),
+          preKey: extractKey(key)
+        }
+      });
+    }
+  }
+};
+exports.parseAndInjectE2ESessions = parseAndInjectE2ESessions;
+const extractDeviceJids = (result, myJid, myLid, excludeZeroDevices) => {
+  const {
+    user: myUser,
+    device: myDevice
+  } = (0, _index2.jidDecode)(myJid);
+  const extracted = [];
+  for (const userResult of result) {
+    const {
+      devices,
+      id
+    } = userResult;
+    const decoded = (0, _index2.jidDecode)(id),
+      {
+        user,
+        server
+      } = decoded;
+    let {
+      domainType
+    } = decoded;
+    const deviceList = devices?.deviceList;
+    if (!Array.isArray(deviceList)) continue;
+    for (const {
+      id: device,
+      keyIndex,
+      isHosted
+    } of deviceList) {
+      if ((!excludeZeroDevices || device !== 0) && (
+      // if zero devices are not-excluded, or device is non zero
+      myUser !== user && myLid !== user || myDevice !== device) && (
+      // either different user or if me user, not this device
+      device === 0 || !!keyIndex) // ensure that "key-index" is specified for "non-zero" devices, produces a bad req otherwise
+      ) {
+        if (isHosted) {
+          domainType = domainType === _index2.WAJIDDomains.LID ? _index2.WAJIDDomains.HOSTED_LID : _index2.WAJIDDomains.HOSTED;
+        }
+        extracted.push({
+          user,
+          device,
+          domainType,
+          server: (0, _index2.getServerFromDomainType)(server, domainType)
+        });
+      }
+    }
+  }
+  return extracted;
+};
+/**
+ * get the next N keys for upload or processing
+ * @param count number of pre-keys to get or generate
+ */
+exports.extractDeviceJids = extractDeviceJids;
+const getNextPreKeys = async ({
+  creds,
+  keys
+}, count) => {
+  const {
+    newPreKeys,
+    lastPreKeyId,
+    preKeysRange
+  } = generateOrGetPreKeys(creds, count);
+  const update = {
+    nextPreKeyId: Math.max(lastPreKeyId + 1, creds.nextPreKeyId),
+    firstUnuploadedPreKeyId: Math.max(creds.firstUnuploadedPreKeyId, lastPreKeyId + 1)
+  };
+  await keys.set({
+    'pre-key': newPreKeys
+  });
+  const preKeys = await getPreKeys(keys, preKeysRange[0], preKeysRange[0] + preKeysRange[1]);
+  return {
+    update,
+    preKeys
+  };
+};
+exports.getNextPreKeys = getNextPreKeys;
+const getNextPreKeysNode = async (state, count) => {
+  const {
+    creds
+  } = state;
+  const {
+    update,
+    preKeys
+  } = await getNextPreKeys(state, count);
+  const node = {
+    tag: 'iq',
+    attrs: {
+      xmlns: 'encrypt',
+      type: 'set',
+      to: _index2.S_WHATSAPP_NET
+    },
+    content: [{
+      tag: 'registration',
+      attrs: {},
+      content: (0, _generics.encodeBigEndian)(creds.registrationId)
+    }, {
+      tag: 'type',
+      attrs: {},
+      content: _index.KEY_BUNDLE_TYPE
+    }, {
+      tag: 'identity',
+      attrs: {},
+      content: creds.signedIdentityKey.public
+    }, {
+      tag: 'list',
+      attrs: {},
+      content: Object.keys(preKeys).map(k => xmppPreKey(preKeys[+k], +k))
+    }, xmppSignedPreKey(creds.signedPreKey)]
+  };
+  return {
+    update,
+    node
+  };
+};
+//# sourceMappingURL=signal.js.map
+exports.getNextPreKeysNode = getNextPreKeysNode;

package/lib/Utils/signal.js.map

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

package/lib/Utils/stanza-ack.d.ts

@@ -0,0 +1,11 @@
+import type { BinaryNode } from '../WABinary/index.js';
+/**
+ * Builds an ACK stanza for a received node.
+ * Pure function -- no I/O, no side effects.
+ *
+ * Mirrors WhatsApp Web's ACK construction:
+ * - WAWebHandleMsgSendAck.sendAck / sendNack
+ * - WAWebCreateNackFromStanza.createNackFromStanza
+ */
+export declare function buildAckStanza(node: BinaryNode, errorCode?: number, meId?: string): BinaryNode;
+//# sourceMappingURL=stanza-ack.d.ts.map

package/lib/Utils/stanza-ack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stanza-ack.d.ts","sourceRoot":"","sources":["../../src/Utils/stanza-ack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAkC9F"}

package/lib/Utils/stanza-ack.js

@@ -0,0 +1,47 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.buildAckStanza = buildAckStanza;
+/**
+ * Builds an ACK stanza for a received node.
+ * Pure function -- no I/O, no side effects.
+ *
+ * Mirrors WhatsApp Web's ACK construction:
+ * - WAWebHandleMsgSendAck.sendAck / sendNack
+ * - WAWebCreateNackFromStanza.createNackFromStanza
+ */
+function buildAckStanza(node, errorCode, meId) {
+  const {
+    tag,
+    attrs
+  } = node;
+  const stanza = {
+    tag: 'ack',
+    attrs: {
+      id: attrs.id,
+      to: attrs.from,
+      class: tag
+    }
+  };
+  if (errorCode) {
+    stanza.attrs.error = errorCode.toString();
+  }
+  if (attrs.participant) {
+    stanza.attrs.participant = attrs.participant;
+  }
+  if (attrs.recipient) {
+    stanza.attrs.recipient = attrs.recipient;
+  }
+  // WA Web always includes type when present: `n.type || DROP_ATTR`
+  if (attrs.type) {
+    stanza.attrs.type = attrs.type;
+  }
+  // WA Web WAWebHandleMsgSendAck.sendAck/sendNack always include `from` for message-class ACKs
+  if (tag === 'message' && meId) {
+    stanza.attrs.from = meId;
+  }
+  return stanza;
+}
+//# sourceMappingURL=stanza-ack.js.map

package/lib/Utils/stanza-ack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stanza-ack.js","sourceRoot":"","sources":["../../src/Utils/stanza-ack.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,IAAgB,EAAE,SAAkB,EAAE,IAAa;IACjF,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,CAAA;IAC3B,MAAM,MAAM,GAAe;QAC1B,GAAG,EAAE,KAAK;QACV,KAAK,EAAE;YACN,EAAE,EAAE,KAAK,CAAC,EAAG;YACb,EAAE,EAAE,KAAK,CAAC,IAAK;YACf,KAAK,EAAE,GAAG;SACV;KACD,CAAA;IAED,IAAI,SAAS,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAA;IAC1C,CAAC;IAED,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACvB,MAAM,CAAC,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAA;IAC7C,CAAC;IAED,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACrB,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAA;IACzC,CAAC;IAED,kEAAkE;IAClE,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QAChB,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;IAC/B,CAAC;IAED,6FAA6F;IAC7F,IAAI,GAAG,KAAK,SAAS,IAAI,IAAI,EAAE,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAA;IACzB,CAAC;IAED,OAAO,MAAM,CAAA;AACd,CAAC"}

package/lib/Utils/sync-action-utils.d.ts

@@ -0,0 +1,19 @@
+import { proto } from '../../WAProto/index.js';
+import type { xrlEventEmitter, xrlEventMap, Contact } from '../Types/index.js';
+import type { ILogger } from './logger.js';
+export type ContactsUpsertResult = {
+    event: 'contacts.upsert';
+    data: Contact[];
+};
+export type LidMappingUpdateResult = {
+    event: 'lid-mapping.update';
+    data: xrlEventMap['lid-mapping.update'];
+};
+export type SyncActionResult = ContactsUpsertResult | LidMappingUpdateResult;
+/**
+ * Process contactAction and return events to emit.
+ * Pure function - no side effects.
+ */
+export declare const processContactAction: (action: proto.SyncActionValue.IContactAction, id: string | undefined, logger?: ILogger) => SyncActionResult[];
+export declare const emitSyncActionResults: (ev: xrlEventEmitter, results: SyncActionResult[]) => void;
+//# sourceMappingURL=sync-action-utils.d.ts.map

package/lib/Utils/sync-action-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-action-utils.d.ts","sourceRoot":"","sources":["../../src/Utils/sync-action-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAE7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAEvC,MAAM,MAAM,oBAAoB,GAAG;IAClC,KAAK,EAAE,iBAAiB,CAAA;IACxB,IAAI,EAAE,OAAO,EAAE,CAAA;CACf,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACpC,KAAK,EAAE,oBAAoB,CAAA;IAC3B,IAAI,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAA;CAC3C,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG,sBAAsB,CAAA;AAE5E;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAChC,QAAQ,KAAK,CAAC,eAAe,CAAC,cAAc,EAC5C,IAAI,MAAM,GAAG,SAAS,EACtB,SAAS,OAAO,KACd,gBAAgB,EAuClB,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAI,IAAI,mBAAmB,EAAE,SAAS,gBAAgB,EAAE,KAAG,IAQ5F,CAAA"}

package/lib/Utils/sync-action-utils.js

@@ -0,0 +1,61 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.processContactAction = exports.emitSyncActionResults = void 0;
+var _index = require("../../WAProto/index.js");
+var _index2 = require("../WABinary/index.js");
+/**
+ * Process contactAction and return events to emit.
+ * Pure function - no side effects.
+ */
+const processContactAction = (action, id, logger) => {
+  const results = [];
+  if (!id) {
+    logger?.warn({
+      hasFullName: !!action.fullName,
+      hasLidJid: !!action.lidJid,
+      hasPnJid: !!action.pnJid
+    }, 'contactAction sync: missing id in index');
+    return results;
+  }
+  const lidJid = action.lidJid;
+  const idIsPn = (0, _index2.isPnUser)(id);
+  // PN is in index[1], not in contactAction.pnJid which is usually null
+  const phoneNumber = idIsPn ? id : action.pnJid || undefined;
+  // Always emit contacts.upsert
+  results.push({
+    event: 'contacts.upsert',
+    data: [{
+      id,
+      name: action.fullName || action.firstName || action.username || undefined,
+      username: action.username || undefined,
+      lid: lidJid || undefined,
+      phoneNumber
+    }]
+  });
+  // Emit lid-mapping.update if we have valid LID-PN pair
+  if (lidJid && (0, _index2.isLidUser)(lidJid) && idIsPn) {
+    results.push({
+      event: 'lid-mapping.update',
+      data: {
+        lid: lidJid,
+        pn: id
+      }
+    });
+  }
+  return results;
+};
+exports.processContactAction = processContactAction;
+const emitSyncActionResults = (ev, results) => {
+  for (const result of results) {
+    if (result.event === 'contacts.upsert') {
+      ev.emit('contacts.upsert', result.data);
+    } else {
+      ev.emit('lid-mapping.update', result.data);
+    }
+  }
+};
+//# sourceMappingURL=sync-action-utils.js.map
+exports.emitSyncActionResults = emitSyncActionResults;

package/lib/Utils/sync-action-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-action-utils.js","sourceRoot":"","sources":["../../src/Utils/sync-action-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAE9C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAejD;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CACnC,MAA4C,EAC5C,EAAsB,EACtB,MAAgB,EACK,EAAE;IACvB,MAAM,OAAO,GAAuB,EAAE,CAAA;IAEtC,IAAI,CAAC,EAAE,EAAE,CAAC;QACT,MAAM,EAAE,IAAI,CACX,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,EACxF,yCAAyC,CACzC,CAAA;QACD,OAAO,OAAO,CAAA;IACf,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;IAC5B,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAA;IAC3B,sEAAsE;IACtE,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,SAAS,CAAA;IAE3D,8BAA8B;IAC9B,OAAO,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,iBAAiB;QACxB,IAAI,EAAE;YACL;gBACC,EAAE;gBACF,IAAI,EAAE,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,QAAQ,IAAI,SAAS;gBACzE,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,SAAS;gBACtC,GAAG,EAAE,MAAM,IAAI,SAAS;gBACxB,WAAW;aACX;SACD;KACD,CAAC,CAAA;IAEF,uDAAuD;IACvD,IAAI,MAAM,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,oBAAoB;YAC3B,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE;SAC7B,CAAC,CAAA;IACH,CAAC;IAED,OAAO,OAAO,CAAA;AACf,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,EAAuB,EAAE,OAA2B,EAAQ,EAAE;IACnG,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,KAAK,KAAK,iBAAiB,EAAE,CAAC;YACxC,EAAE,CAAC,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QACxC,CAAC;aAAM,CAAC;YACP,EAAE,CAAC,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QAC3C,CAAC;IACF,CAAC;AACF,CAAC,CAAA"}

package/lib/Utils/tc-token-utils.d.ts

@@ -0,0 +1,37 @@
+import type { SignalKeyStoreWithTransaction } from '../Types/index.js';
+import type { BinaryNode } from '../WABinary/index.js';
+/** Sentinel key under `tctoken` store holding a JSON array of tracked storage JIDs for cross-session pruning. */
+export declare const TC_TOKEN_INDEX_KEY = "__index";
+/** Read the persisted tctoken JID index and return its entries (never contains the sentinel key itself). */
+export declare function readTcTokenIndex(keys: SignalKeyStoreWithTransaction): Promise<string[]>;
+/** Build a SignalDataSet fragment that writes the merged index (persisted ∪ added) under the sentinel key. */
+export declare function buildMergedTcTokenIndexWrite(keys: SignalKeyStoreWithTransaction, addedJids: Iterable<string>): Promise<{
+    [TC_TOKEN_INDEX_KEY]: {
+        token: Buffer;
+    };
+}>;
+export declare function isTcTokenExpired(timestamp: number | string | null | undefined): boolean;
+export declare function shouldSendNewTcToken(senderTimestamp: number | undefined): boolean;
+/** Resolve JID to LID for tctoken storage (WA Web stores under LID) */
+export declare function resolveTcTokenJid(jid: string, getLIDForPN: (pn: string) => Promise<string | null>): Promise<string>;
+/** Resolve target JID for issuing privacy token based on AB prop 14303 */
+export declare function resolveIssuanceJid(jid: string, issueToLid: boolean, getLIDForPN: (pn: string) => Promise<string | null>, getPNForLID?: (lid: string) => Promise<string | null>): Promise<string>;
+type TcTokenParams = {
+    jid: string;
+    baseContent?: BinaryNode[];
+    authState: {
+        keys: SignalKeyStoreWithTransaction;
+    };
+    getLIDForPN: (pn: string) => Promise<string | null>;
+};
+export declare function buildTcTokenFromJid({ authState, jid, baseContent, getLIDForPN }: TcTokenParams): Promise<BinaryNode[] | undefined>;
+type StoreTcTokensParams = {
+    result: BinaryNode;
+    fallbackJid: string;
+    keys: SignalKeyStoreWithTransaction;
+    getLIDForPN: (pn: string) => Promise<string | null>;
+    onNewJidStored?: (jid: string) => void;
+};
+export declare function storeTcTokensFromIqResult({ result, fallbackJid, keys, getLIDForPN, onNewJidStored }: StoreTcTokensParams): Promise<void>;
+export {};
+//# sourceMappingURL=tc-token-utils.d.ts.map

package/lib/Utils/tc-token-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tc-token-utils.d.ts","sourceRoot":"","sources":["../../src/Utils/tc-token-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,UAAU,CAAA;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAkC7C,iHAAiH;AACjH,eAAO,MAAM,kBAAkB,YAAY,CAAA;AAE3C,4GAA4G;AAC5G,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,6BAA6B,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAW7F;AAED,8GAA8G;AAC9G,wBAAsB,4BAA4B,CACjD,IAAI,EAAE,6BAA6B,EACnC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,GACzB,OAAO,CAAC;IAAE,CAAC,kBAAkB,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC,CAUtD;AAGD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CASvF;AAED,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAMjF;AAED,uEAAuE;AACvE,wBAAsB,iBAAiB,CACtC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GACjD,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED,0EAA0E;AAC1E,wBAAsB,kBAAkB,CACvC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,OAAO,EACnB,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,EACnD,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GACnD,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED,KAAK,aAAa,GAAG;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,CAAC,EAAE,UAAU,EAAE,CAAA;IAC1B,SAAS,EAAE;QACV,IAAI,EAAE,6BAA6B,CAAA;KACnC,CAAA;IACD,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;CACnD,CAAA;AAED,wBAAsB,mBAAmB,CAAC,EACzC,SAAS,EACT,GAAG,EACH,WAAgB,EAChB,WAAW,EACX,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,SAAS,CAAC,CAgCnD;AAED,KAAK,mBAAmB,GAAG;IAC1B,MAAM,EAAE,UAAU,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,6BAA6B,CAAA;IACnC,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACnD,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CACtC,CAAA;AAED,wBAAsB,yBAAyB,CAAC,EAC/C,MAAM,EACN,WAAW,EACX,IAAI,EACJ,WAAW,EACX,cAAc,EACd,EAAE,mBAAmB,iBAkCrB"}