zapo-js 1.5.0 → 1.6.0

package/dist/esm/client/coordinators/WaMessageDispatchCoordinator.js

@@ -315,7 +315,7 @@ export class WaMessageDispatchCoordinator {
         }
         try {
             const results = await this.deps.signalDeviceSync.queryLidsByPhoneJids([pnUserJid]);
-            const match = results.find((entry) => entry.phoneJid === pnUserJid);
+            const match = results.find((entry) => entry.queriedJid === pnUserJid);
             if (match?.lidJid)
                 return match.lidJid;
         }

package/dist/esm/client/media.js

@@ -198,7 +198,7 @@ export async function performPlaintextMediaUpload(deps, input) {
         await prepared.cleanup?.();
     }
 }
-async function assertReadableFile(filePath) {
+export async function assertReadableFile(filePath) {
     try {
         const stats = await stat(filePath);
         if (!stats.isFile()) {

package/dist/esm/client/messaging/messages.js

@@ -341,9 +341,15 @@ async function buildMediaMessage(options, content) {
         const firstFrameLength = content.type === 'sticker'
             ? (content.firstFrameLength ?? detectedFirstFrameLength)
             : undefined;
-        const uploadPromise = isReadableStream(resolved.uploadMedia)
-            ? uploadMediaStream(options, content, resolved.uploadMedia, firstFrameLength, mimetype)
-            : uploadMediaBytes(options, content, resolved.uploadMedia, firstFrameLength, mimetype);
+        const uploadType = resolveUploadType(content);
+        const uploadPromise = uploadMedia(options, {
+            source: resolved.uploadMedia,
+            cryptoType: uploadType,
+            uploadPath: resolveUploadPath(uploadType),
+            contentType: mimetype,
+            sidecar: needsSidecar(content),
+            firstFrameLength
+        });
         const processPromise = runMediaProcessor(options.media, resolved.processorInput, content, options.logger);
         const [uploadResult, processResult] = await Promise.allSettled([
             uploadPromise,
@@ -504,29 +510,42 @@ function parseUploadResponse(body, status) {
         ...(parsed.metadata_url ? { metadataUrl: parsed.metadata_url } : {})
     };
 }
-async function uploadMediaBytes(options, content, mediaBytes, firstFrameLength, mimetype) {
-    const uploadType = resolveUploadType(content);
-    const mediaKey = await WaMediaCrypto.generateMediaKey();
+/**
+ * Shared media upload primitive: derives (or reuses) a media key, encrypts,
+ * fetches a media connection, and POSTs the ciphertext. Bytes take a
+ * zero-temp-file fast path; streams stage to a temp file first. Backs both the
+ * send path and `WaMessageCoordinator.upload`.
+ */
+export async function uploadMedia(options, input) {
+    const mediaKey = input.mediaKey ?? (await WaMediaCrypto.generateMediaKey());
+    if (input.source instanceof Uint8Array) {
+        return uploadMediaBytes(options, input, mediaKey, input.source);
+    }
+    return uploadMediaStream(options, input, mediaKey, input.source);
+}
+async function uploadMediaBytes(options, input, mediaKey, mediaBytes) {
     const [encrypted, mediaConn] = await Promise.all([
-        WaMediaCrypto.encryptBytes(uploadType, mediaKey, mediaBytes, {
-            sidecar: needsSidecar(content),
-            firstFrameLength
+        WaMediaCrypto.encryptBytes(input.cryptoType, mediaKey, mediaBytes, {
+            sidecar: input.sidecar,
+            firstFrameLength: input.firstFrameLength
         }),
         getMediaConn(options)
     ]);
     const selectedHost = selectMediaUploadHost(mediaConn);
-    const uploadUrl = buildMediaUploadUrl(selectedHost, resolveUploadPath(uploadType), mediaConn.auth, encrypted.fileEncSha256);
-    options.logger.debug('sending media upload request', {
-        mediaType: content.type,
-        uploadType,
-        host: selectedHost
+    const uploadUrl = buildMediaUploadUrl(selectedHost, input.uploadPath, mediaConn.auth, encrypted.fileEncSha256);
+    options.logger.debug(input.logLabel ?? 'sending media upload request', {
+        cryptoType: input.cryptoType,
+        host: selectedHost,
+        size: mediaBytes.byteLength
     });
     const uploadResponse = await options.mediaTransfer.uploadStream({
         url: uploadUrl,
         method: 'POST',
         body: encrypted.ciphertextHmac,
         contentLength: encrypted.ciphertextHmac.byteLength,
-        contentType: mimetype
+        contentType: input.contentType,
+        timeoutMs: input.timeoutMs,
+        signal: input.signal
     });
     const responseBody = await options.mediaTransfer.readResponseBytes(uploadResponse);
     const parsed = parseUploadResponse(responseBody, uploadResponse.status);
@@ -538,19 +557,22 @@ async function uploadMediaBytes(options, content, mediaBytes, firstFrameLength,
         fileLength: mediaBytes.byteLength,
         streamingSidecar: encrypted.streamingSidecar,
         firstFrameSidecar: encrypted.firstFrameSidecar,
-        firstFrameLength
+        firstFrameLength: input.firstFrameLength
     };
 }
-async function uploadEncryptedStream(options, input) {
-    const encResult = await WaMediaCrypto.encryptToFile(input.cryptoType, input.mediaKey, input.plaintext, { sidecar: input.sidecar, firstFrameLength: input.firstFrameLength });
+async function uploadMediaStream(options, input, mediaKey, plaintext) {
+    const encResult = await WaMediaCrypto.encryptToFile(input.cryptoType, mediaKey, plaintext, {
+        sidecar: input.sidecar,
+        firstFrameLength: input.firstFrameLength
+    });
     let readStream;
     try {
         const mediaConn = await getMediaConn(options);
         const selectedHost = selectMediaUploadHost(mediaConn);
         const uploadUrl = buildMediaUploadUrl(selectedHost, input.uploadPath, mediaConn.auth, encResult.fileEncSha256);
-        options.logger.debug(input.logLabel, {
+        options.logger.debug(input.logLabel ?? 'sending media stream upload request', {
+            cryptoType: input.cryptoType,
             host: selectedHost,
-            uploadPath: input.uploadPath,
             plaintextLength: encResult.plaintextLength,
             encryptedSize: encResult.fileSize
         });
@@ -560,13 +582,15 @@ async function uploadEncryptedStream(options, input) {
             method: 'POST',
             body: readStream,
             contentLength: encResult.fileSize,
-            contentType: input.contentType
+            contentType: input.contentType,
+            timeoutMs: input.timeoutMs,
+            signal: input.signal
         });
         const responseBody = await options.mediaTransfer.readResponseBytes(uploadResponse);
         const parsed = parseUploadResponse(responseBody, uploadResponse.status);
         return {
             ...parsed,
-            mediaKey: input.mediaKey,
+            mediaKey,
             fileSha256: encResult.fileSha256,
             fileEncSha256: encResult.fileEncSha256,
             fileLength: encResult.plaintextLength,
@@ -585,19 +609,6 @@ async function uploadEncryptedStream(options, input) {
         await WaMediaCrypto.cleanupEncryptedFile(encResult.filePath);
     }
 }
-async function uploadMediaStream(options, content, stream, firstFrameLength, mimetype) {
-    const cryptoType = resolveUploadType(content);
-    return uploadEncryptedStream(options, {
-        plaintext: stream,
-        mediaKey: await WaMediaCrypto.generateMediaKey(),
-        cryptoType,
-        uploadPath: resolveUploadPath(cryptoType),
-        contentType: mimetype,
-        logLabel: 'sending media stream upload request',
-        sidecar: needsSidecar(content),
-        firstFrameLength
-    });
-}
 function openStickerPackInputStream(media) {
     return typeof media === 'string' ? createReadStream(media) : Readable.from([media]);
 }
@@ -609,23 +620,23 @@ async function buildStickerPackMediaMessage(options, content) {
     const coverThumbnail = content.coverThumbnail;
     const mediaKey = await WaMediaCrypto.generateMediaKey();
     const [bundle, cover] = await Promise.all([
-        uploadEncryptedStream(options, {
-            plaintext: createStickerPackZipStream(toStickerPackZipEntries(content)),
-            mediaKey,
+        uploadMedia(options, {
+            source: createStickerPackZipStream(toStickerPackZipEntries(content)),
             cryptoType: 'sticker-pack',
             uploadPath: MEDIA_UPLOAD_PATHS['sticker-pack'],
             contentType: 'application/zip',
-            logLabel: 'sending sticker pack bundle upload',
-            sidecar: false
-        }),
-        uploadEncryptedStream(options, {
-            plaintext: openStickerPackInputStream(coverThumbnail),
             mediaKey,
+            sidecar: false,
+            logLabel: 'sending sticker pack bundle upload'
+        }),
+        uploadMedia(options, {
+            source: openStickerPackInputStream(coverThumbnail),
             cryptoType: 'thumbnail-sticker-pack',
             uploadPath: MEDIA_UPLOAD_PATHS['thumbnail-sticker-pack'],
             contentType: 'image/jpeg',
-            logLabel: 'sending sticker pack thumbnail upload',
-            sidecar: false
+            mediaKey,
+            sidecar: false,
+            logLabel: 'sending sticker pack thumbnail upload'
         })
     ]);
     if (cover.fileLength === 0) {

package/dist/esm/index.js

@@ -1,6 +1,8 @@
 export { WaClient } from './client/index.js';
 export { defineWaClientPlugin } from './client/plugins/index.js';
 export { downloadMediaMessage } from './client/media.js';
+export { WaMediaCrypto } from './media/crypto/WaMediaCrypto.js';
+export { WaMediaTransferClient } from './media/transfer/WaMediaTransferClient.js';
 export { createFileCompanionHostPersistence } from './client/persistence/companion-host.js';
 export { parseUsyncResultEnvelope } from './transport/node/builders/usync.js';
 export { getContentType, resolveEncMediaType, resolveMessageTarget, unwrapMessage } from './message/encode/content.js';

package/dist/esm/signal/api/SignalDeviceSyncApi.js

@@ -1,8 +1,8 @@
 import { PromiseDedup } from '../../infra/perf/PromiseDedup.js';
 import { WA_DEFAULTS, WA_NODE_TAGS, WA_USYNC_CONTEXTS } from '../../protocol/constants.js';
-import { buildDeviceJid, isHostedDeviceId, splitJid, toUserJid } from '../../protocol/jid.js';
+import { buildDeviceJid, isHostedDeviceId, parsePhoneJid, splitJid, toUserJid } from '../../protocol/jid.js';
 import { buildUsyncIq, iterateUsyncUsers, parseUsyncResultEnvelope } from '../../transport/node/builders/usync.js';
-import { findNodeChild, getNodeChildrenByTag } from '../../transport/node/helpers.js';
+import { findNodeChild, getNodeChildrenByTag, getNodeTextContent } from '../../transport/node/helpers.js';
 import { assertIqResult } from '../../transport/node/query.js';
 import { createUsyncSidGenerator, logUsyncProtocolErrors } from '../../transport/node/usync.js';
 /**
@@ -112,22 +112,21 @@ export class SignalDeviceSyncApi {
         const parsedByPhoneJid = new Map();
         for (let index = 0; index < parsed.length; index += 1) {
             const entry = parsed[index];
-            const phoneJid = entry.phoneJid ?? entry.jid;
-            parsedByPhoneJid.set(phoneJid, {
-                phoneJid,
+            parsedByPhoneJid.set(entry.jid, {
+                phoneJid: entry.phoneJid ?? entry.jid,
                 lidJid: entry.lidJid,
-                exists: entry.exists
+                exists: entry.exists,
+                invalid: entry.invalid
             });
         }
         const result = new Array(normalizedPhoneJids.length);
         let found = 0;
         for (let index = 0; index < normalizedPhoneJids.length; index += 1) {
-            const phoneJid = normalizedPhoneJids[index];
-            const resolved = parsedByPhoneJid.get(phoneJid) ?? {
-                phoneJid,
-                lidJid: null,
-                exists: false
-            };
+            const queriedJid = normalizedPhoneJids[index];
+            const hit = parsedByPhoneJid.get(queriedJid);
+            const resolved = hit
+                ? { queriedJid, ...hit }
+                : { queriedJid, phoneJid: queriedJid, lidJid: null, exists: false, invalid: false };
             if (resolved.exists) {
                 found += 1;
             }
@@ -151,24 +150,23 @@ export class SignalDeviceSyncApi {
         if (!this.deviceListStore || results.length === 0)
             return;
         const nowMs = Date.now();
-        const lidByPhoneJid = new Map();
-        const phoneJids = [];
+        const lidByQueriedJid = new Map();
+        const queriedJids = [];
         for (const entry of results) {
-            if (entry.lidJid && entry.phoneJid) {
-                lidByPhoneJid.set(entry.phoneJid, entry.lidJid);
-                phoneJids.push(entry.phoneJid);
+            if (entry.lidJid) {
+                lidByQueriedJid.set(entry.queriedJid, entry.lidJid);
+                queriedJids.push(entry.queriedJid);
             }
         }
-        if (phoneJids.length === 0)
+        if (queriedJids.length === 0)
             return;
-        const existing = await this.deviceListStore.getUserDevicesBatch(phoneJids, nowMs);
+        const existing = await this.deviceListStore.getUserDevicesBatch(queriedJids, nowMs);
         const updates = [];
-        for (let index = 0; index < phoneJids.length; index += 1) {
+        for (let index = 0; index < queriedJids.length; index += 1) {
             const snapshot = existing[index];
             if (!snapshot)
                 continue;
-            const phoneJid = phoneJids[index];
-            const lidJid = lidByPhoneJid.get(phoneJid);
+            const lidJid = lidByQueriedJid.get(queriedJids[index]);
             if (!lidJid || snapshot.altUserJid === lidJid)
                 continue;
             updates.push({
@@ -271,7 +269,13 @@ export class SignalDeviceSyncApi {
             if (!userJid) {
                 continue;
             }
-            const normalizedUserJid = this.normalizeUserJid(userJid);
+            const normalizedUserJid = this.tryNormalizeUserJid(userJid);
+            if (normalizedUserJid === null) {
+                this.logger.debug('signal device sync skipping user node with invalid jid', {
+                    jid: userJid
+                });
+                continue;
+            }
             if (!requestedSet.has(normalizedUserJid)) {
                 continue;
             }
@@ -292,55 +296,107 @@ export class SignalDeviceSyncApi {
             throw new Error('signal lid sync response missing usync envelope');
         }
         const requestedSet = new Set(requestedUsers);
-        const parsed = new Array(userNodes.length);
-        let parsedCount = 0;
+        const parsed = [];
+        const lidUserErrors = [];
         for (let index = 0; index < userNodes.length; index += 1) {
             const userNode = userNodes[index];
-            const userJid = userNode.attrs.jid;
-            if (!userJid) {
+            const rawUserJid = userNode.attrs.jid;
+            if (!rawUserJid) {
                 continue;
             }
-            const normalizedUserJid = this.normalizeUserJid(userJid);
-            const normalizedPhoneJid = userNode.attrs.pn_jid
-                ? this.normalizeUserJid(userNode.attrs.pn_jid)
+            const resolvedJid = this.tryNormalizeUserJid(rawUserJid);
+            const pnJid = userNode.attrs.pn_jid
+                ? this.tryNormalizeUserJid(userNode.attrs.pn_jid)
+                : null;
+            const phoneJid = pnJid ?? resolvedJid;
+            const lidNode = findNodeChild(userNode, WA_NODE_TAGS.LID);
+            const lidErrorNode = lidNode ? findNodeChild(lidNode, WA_NODE_TAGS.ERROR) : null;
+            if (lidErrorNode) {
+                lidUserErrors.push({
+                    jid: resolvedJid ?? rawUserJid,
+                    code: lidErrorNode.attrs.code,
+                    text: lidErrorNode.attrs.text
+                });
+            }
+            const lidJid = !lidErrorNode && lidNode?.attrs.val
+                ? this.tryNormalizeUserJid(lidNode.attrs.val)
                 : null;
-            const wasRequested = requestedSet.has(normalizedUserJid) ||
-                (normalizedPhoneJid !== null && requestedSet.has(normalizedPhoneJid));
-            if (!wasRequested) {
+            const contactNodes = getNodeChildrenByTag(userNode, WA_NODE_TAGS.CONTACT);
+            let matched = false;
+            for (let c = 0; c < contactNodes.length; c += 1) {
+                const contactNode = contactNodes[c];
+                const inputJid = this.recoverContactJid(contactNode);
+                if (inputJid === null || !requestedSet.has(inputJid)) {
+                    continue;
+                }
+                matched = true;
+                const invalid = resolvedJid === null || contactNode.attrs.type === 'invalid';
+                parsed.push({
+                    jid: inputJid,
+                    phoneJid: phoneJid ?? inputJid,
+                    lidJid,
+                    exists: !invalid &&
+                        this.parseLidSyncContactExists(contactNode, inputJid, lidJid !== null),
+                    invalid
+                });
+            }
+            if (matched) {
                 continue;
             }
-            const lidNode = findNodeChild(userNode, WA_NODE_TAGS.LID);
-            const contactNode = findNodeChild(userNode, WA_NODE_TAGS.CONTACT);
-            if (!lidNode) {
-                parsed[parsedCount] = this.buildLidSyncResult(normalizedUserJid, normalizedPhoneJid, contactNode, null);
-                parsedCount += 1;
+            if (resolvedJid === null) {
+                this.logger.debug('signal lid sync skipping user node with invalid jid', {
+                    jid: rawUserJid
+                });
                 continue;
             }
-            const errorNode = findNodeChild(lidNode, WA_NODE_TAGS.ERROR);
-            if (errorNode) {
-                this.logger.warn('signal lid sync user error', {
-                    jid: normalizedUserJid,
-                    code: errorNode.attrs.code,
-                    text: errorNode.attrs.text
+            const requestedKey = requestedSet.has(resolvedJid)
+                ? resolvedJid
+                : pnJid !== null && requestedSet.has(pnJid)
+                    ? pnJid
+                    : null;
+            if (requestedKey === null) {
+                this.logger.debug('signal lid sync unmatched user (no contact echo)', {
+                    jid: resolvedJid,
+                    pnJid
                 });
-                parsed[parsedCount] = this.buildLidSyncResult(normalizedUserJid, normalizedPhoneJid, contactNode, null);
-                parsedCount += 1;
                 continue;
             }
-            const lidJid = lidNode.attrs.val ? this.normalizeUserJid(lidNode.attrs.val) : null;
-            parsed[parsedCount] = this.buildLidSyncResult(normalizedUserJid, normalizedPhoneJid, contactNode, lidJid);
-            parsedCount += 1;
+            const contactNode = findNodeChild(userNode, WA_NODE_TAGS.CONTACT);
+            parsed.push({
+                jid: requestedKey,
+                phoneJid: phoneJid ?? requestedKey,
+                lidJid,
+                exists: this.parseLidSyncContactExists(contactNode, requestedKey, lidJid !== null),
+                invalid: false
+            });
+        }
+        if (lidUserErrors.length > 0) {
+            this.logger.warn('signal lid sync user errors', {
+                droppedCount: lidUserErrors.length,
+                totalExpected: requestedUsers.length,
+                sample: lidUserErrors.slice(0, 3)
+            });
         }
-        parsed.length = parsedCount;
         return parsed;
     }
-    buildLidSyncResult(jid, phoneJid, contactNode, lidJid) {
-        return {
-            jid,
-            lidJid,
-            phoneJid,
-            exists: this.parseLidSyncContactExists(contactNode, jid, lidJid !== null)
-        };
+    /**
+     * Recovers the queried phone JID from a `<contact>` echo. Each `<contact>` in a
+     * usync response echoes the `+<number>` we sent (base64 text content), so it maps
+     * a response node back to the exact input - even when the server corrected the
+     * `<user jid>` or rejected it as `jid='undefined'`. Returns `null` when there is
+     * no decodable phone echo.
+     */
+    recoverContactJid(contactNode) {
+        const echoed = getNodeTextContent(contactNode);
+        if (!echoed) {
+            return null;
+        }
+        try {
+            return parsePhoneJid(echoed);
+        }
+        catch {
+            return null;
+        }
     }
     parseLidSyncContactExists(contactNode, userJid, defaultExists) {
         if (!contactNode) {
@@ -401,7 +457,10 @@ export class SignalDeviceSyncApi {
         let normalizedCount = 0;
         const dedup = new Set();
         for (let index = 0; index < userJids.length; index += 1) {
-            const normalizedJid = this.normalizeUserJid(userJids[index]);
+            const normalizedJid = toUserJid(userJids[index], {
+                canonicalizeSignalServer: true,
+                hostDomain: this.hostDomain
+            });
             if (dedup.has(normalizedJid)) {
                 continue;
             }
@@ -412,10 +471,21 @@ export class SignalDeviceSyncApi {
         normalized.length = normalizedCount;
         return normalized;
     }
-    normalizeUserJid(jid) {
-        return toUserJid(jid, {
-            canonicalizeSignalServer: true,
-            hostDomain: this.hostDomain
-        });
+    /**
+     * Canonicalizes a user jid, returning `null` instead of throwing when the input
+     * is not a valid jid (for example the literal `'undefined'` the server returns
+     * for an invalid contact). Lets a single malformed response node be skipped
+     * without discarding the rest of the batch.
+     */
+    tryNormalizeUserJid(jid) {
+        try {
+            return toUserJid(jid, {
+                canonicalizeSignalServer: true,
+                hostDomain: this.hostDomain
+            });
+        }
+        catch {
+            return null;
+        }
     }
 }

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { defineWaClientPlugin } from './client/plugins';
 export type { WaClientDependencies } from './client/WaClientFactory';
 export type { WaClientEventMap, WaClientOptions, WaClientProxyOptions, WaDownloadMediaOptions, WaHistorySyncChunkEvent, WaHistorySyncOptions, WaWriteBehindOptions } from './client/types';
 export type { WaClientPluginContext, WaClientPluginDefinition } from './client/plugins';
-export type { WaMessageCoordinator } from './client/coordinators/WaMessageCoordinator';
+export type { WaMediaUploadResult, WaMessageCoordinator, WaUploadMediaOptions, WaUploadMediaType } from './client/coordinators/WaMessageCoordinator';
 export type { WaAccountTakeoverNoticeEvent, WaAppStateMutationEvent, WaAppStateMutationSource, WaBusinessEvent, WaBusinessEventAction, WaBusinessProfileResult, WaConnectionEvent, WaGroupEvent, WaGroupEventAction, WaGroupEventLinkedGroup, WaGroupEventMembershipRequest, WaGroupEventParticipant, WaGroupEventSubgroupSuggestion, WaIgnoreKey, WaIgnoreKeyContext, WaIgnoreKeyPredicate, WaIgnoreStanzaKind, WaIncomingAddonEvent, WaIncomingBaseEvent, WaIncomingBotChunkEvent, WaIncomingCallEvent, WaIncomingChatstateEvent, WaIncomingErrorStanzaEvent, WaIncomingFailureEvent, WaIncomingMessageEvent, WaIncomingMessageKey, WaIncomingNewsletterEvent, WaIncomingNewsletterMessageUpdateEvent, WaIncomingNodeHandler, WaIncomingNodeHandlerRegistration, WaIncomingNotificationEvent, WaIncomingPresenceEvent, WaIncomingProtocolMessageEvent, WaIncomingReceiptEvent, WaIncomingStanzaFilter, WaIncomingUnavailableMessageEvent, WaIncomingUnhandledStanzaEvent, WaMexLidChangeEvent, WaMexMessageCappingEvent, WaMexMessageCappingStatus, WaMexNotificationEvent, WaMexNotificationGraphQlError, WaMexNotificationOperationName, WaMexNotificationUnknownEvent, WaMexOwnUsernameSyncEvent, WaMexTextStatusUpdateEvent, WaMexTextStatusUpdateHintEvent, WaMexUsernameDeleteEvent, WaMexUsernameSetEvent, WaMexUsernameUpdateHintEvent, WaOfflineResumeEvent, WaOutgoingMessageEvent, WaPictureEvent, WaPictureEventAction, WaPrivacyTokenUpdateEvent, WaReceiptStatus, WaRegistrationCodeEvent, WaSendMessageOptions, WaUnavailableMessageKind, WaVerifiedNameResult, WaAddonKind, WaNewsletterEventAction, WaNewsletterMessageUpdate, WaNewsletterPollVoteEntry, WaNewsletterReactionEntry } from './client/types';
 export type { WaAppStateMutationCoordinator, WaBroadcastListParticipant, WaSetBroadcastListInput, WaSetStatusPrivacyInput } from './client/coordinators/WaAppStateMutationCoordinator';
 export type { WaBotCoordinator, WaBotInfo, WaBotPosingAsProfessional, WaBotProfileCommand, WaBotProfilePrompt, WaBotProfileResult, WaBotPromptOptions, WaGetBotProfileOptions } from './client/coordinators/WaBotCoordinator';
@@ -11,6 +11,9 @@ export type { WaBroadcastListCoordinator, WaSendBroadcastListMessageInput } from
 export type { WaBusinessCoordinator, WaVerifiedNameBatchEntry } from './client/coordinators/WaBusinessCoordinator';
 export { downloadMediaMessage } from './client/media';
 export type { WaDownloadMediaMessageOptions, WaUploadMediaSource } from './client/media';
+export { WaMediaCrypto } from './media/crypto/WaMediaCrypto';
+export { WaMediaTransferClient } from './media/transfer/WaMediaTransferClient';
+export type { MediaCryptoType, MediaKind, WaMediaConn, WaMediaDecryptReadableOptions, WaMediaDecryptionResult, WaMediaDerivedKeys, WaMediaEncryptionResult, WaMediaFileEncryptionResult, WaMediaReadableDecryptionResult, WaMediaReadableEncryptionResult, WaMediaTransferClientOptions } from './media/types';
 export type { WaEditBusinessProfileInput } from './transport/node/builders/business';
 export type { WaEmailCoordinator, WaEmailStatus, WaEmailVerifyCodeResult } from './client/coordinators/WaEmailCoordinator';
 export type { WaCommunityCreateOptions, WaCommunitySubGroup, WaCommunitySubGroupResult, WaCommunitySubGroupsResult, WaGroupCoordinator, WaGroupCreateOptions, WaGroupMetadata, WaGroupParticipant, WaLinkSubGroupsResult, WaMembershipRequest, WaUnlinkSubGroupsResult } from './client/coordinators/WaGroupCoordinator';

package/dist/index.js

@@ -1,13 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WA_APP_STATE_COLLECTIONS = exports.WA_ACCOUNT_SYNC_PROTOCOLS = exports.toUserJid = exports.splitJid = exports.signalAddressKey = exports.parseSignalAddressFromJid = exports.parsePhoneJid = exports.parseJidFull = exports.normalizeRecipientJid = exports.normalizeDeviceJid = exports.isUserJid = exports.isStatusBroadcastJid = exports.isNewsletterJid = exports.isLidJid = exports.isHostedServer = exports.isHostedDeviceJid = exports.isHostedDeviceId = exports.isGroupOrBroadcastJid = exports.isGroupJid = exports.isBroadcastJid = exports.isBotJid = exports.getWaMediaHkdfInfo = exports.getWaCompanionPlatformId = exports.getLoginIdentity = exports.canonicalizeSignalServer = exports.canonicalizeSignalJid = exports.buildDeviceJid = exports.delay = exports.WaAuthMemoryStore = exports.createStore = exports.WA_VERSION = exports.createNoopLogger = exports.createPinoLogger = exports.PinoLogger = exports.ConsoleLogger = exports.fetchLatestWaMobileVersion = exports.fetchLatestWaWebVersion = exports.writeRandomPadMax16 = exports.unpadPkcs7 = exports.resolveMediaPayload = exports.getContextInfo = exports.unwrapMessage = exports.resolveMessageTarget = exports.resolveEncMediaType = exports.getContentType = exports.parseUsyncResultEnvelope = exports.createFileCompanionHostPersistence = exports.downloadMediaMessage = exports.defineWaClientPlugin = exports.WaClient = void 0;
-exports.proto = exports.WA_XMLNS = exports.WA_PRIVACY_VALUES = exports.WA_PRIVACY_TAGS = exports.WA_PRIVACY_SETTING_TO_CATEGORY = exports.WA_PRIVACY_DISALLOWED_LIST_CATEGORIES = exports.WA_PRIVACY_CATEGORY_TO_SETTING = exports.WA_PRIVACY_CATEGORIES = exports.WA_SUPPORTED_DIRTY_TYPES = exports.WA_STREAM_SIGNALING = exports.WA_SIGNALING = exports.WA_RETRYABLE_ACK_CODES = exports.WA_READY_STATES = exports.WA_PREVIEW_MEDIA_HKDF_INFO = exports.WA_PAIRING_KDF_INFO = exports.WA_NODE_TAGS = exports.WA_MEDIA_HKDF_INFO = exports.WA_MESSAGE_TYPES = exports.WA_MESSAGE_TAGS = exports.WA_LOGOUT_REASONS = exports.WA_IQ_TYPES = exports.WA_DISCONNECT_REASONS = exports.WA_DIRTY_TYPES = exports.WA_DIRTY_PROTOCOLS = exports.WA_DEFAULTS = exports.WA_COMPANION_PLATFORM_IDS = exports.WA_BUSINESS_HOURS_MODES = exports.WA_BUSINESS_HOURS_DAYS = exports.WA_BROWSERS = exports.WA_APP_STATE_SYNC_DATA_TYPE = exports.WA_APP_STATE_KEY_TYPES = exports.WA_APP_STATE_KDF_INFO = exports.WA_APP_STATE_ERROR_CODES = exports.WA_APP_STATE_COLLECTION_STATES = void 0;
+exports.toUserJid = exports.splitJid = exports.signalAddressKey = exports.parseSignalAddressFromJid = exports.parsePhoneJid = exports.parseJidFull = exports.normalizeRecipientJid = exports.normalizeDeviceJid = exports.isUserJid = exports.isStatusBroadcastJid = exports.isNewsletterJid = exports.isLidJid = exports.isHostedServer = exports.isHostedDeviceJid = exports.isHostedDeviceId = exports.isGroupOrBroadcastJid = exports.isGroupJid = exports.isBroadcastJid = exports.isBotJid = exports.getWaMediaHkdfInfo = exports.getWaCompanionPlatformId = exports.getLoginIdentity = exports.canonicalizeSignalServer = exports.canonicalizeSignalJid = exports.buildDeviceJid = exports.delay = exports.WaAuthMemoryStore = exports.createStore = exports.WA_VERSION = exports.createNoopLogger = exports.createPinoLogger = exports.PinoLogger = exports.ConsoleLogger = exports.fetchLatestWaMobileVersion = exports.fetchLatestWaWebVersion = exports.writeRandomPadMax16 = exports.unpadPkcs7 = exports.resolveMediaPayload = exports.getContextInfo = exports.unwrapMessage = exports.resolveMessageTarget = exports.resolveEncMediaType = exports.getContentType = exports.parseUsyncResultEnvelope = exports.createFileCompanionHostPersistence = exports.WaMediaTransferClient = exports.WaMediaCrypto = exports.downloadMediaMessage = exports.defineWaClientPlugin = exports.WaClient = void 0;
+exports.proto = exports.WA_XMLNS = exports.WA_PRIVACY_VALUES = exports.WA_PRIVACY_TAGS = exports.WA_PRIVACY_SETTING_TO_CATEGORY = exports.WA_PRIVACY_DISALLOWED_LIST_CATEGORIES = exports.WA_PRIVACY_CATEGORY_TO_SETTING = exports.WA_PRIVACY_CATEGORIES = exports.WA_SUPPORTED_DIRTY_TYPES = exports.WA_STREAM_SIGNALING = exports.WA_SIGNALING = exports.WA_RETRYABLE_ACK_CODES = exports.WA_READY_STATES = exports.WA_PREVIEW_MEDIA_HKDF_INFO = exports.WA_PAIRING_KDF_INFO = exports.WA_NODE_TAGS = exports.WA_MEDIA_HKDF_INFO = exports.WA_MESSAGE_TYPES = exports.WA_MESSAGE_TAGS = exports.WA_LOGOUT_REASONS = exports.WA_IQ_TYPES = exports.WA_DISCONNECT_REASONS = exports.WA_DIRTY_TYPES = exports.WA_DIRTY_PROTOCOLS = exports.WA_DEFAULTS = exports.WA_COMPANION_PLATFORM_IDS = exports.WA_BUSINESS_HOURS_MODES = exports.WA_BUSINESS_HOURS_DAYS = exports.WA_BROWSERS = exports.WA_APP_STATE_SYNC_DATA_TYPE = exports.WA_APP_STATE_KEY_TYPES = exports.WA_APP_STATE_KDF_INFO = exports.WA_APP_STATE_ERROR_CODES = exports.WA_APP_STATE_COLLECTION_STATES = exports.WA_APP_STATE_COLLECTIONS = exports.WA_ACCOUNT_SYNC_PROTOCOLS = void 0;
 var _client_1 = require("./client");
 Object.defineProperty(exports, "WaClient", { enumerable: true, get: function () { return _client_1.WaClient; } });
 var plugins_1 = require("./client/plugins");
 Object.defineProperty(exports, "defineWaClientPlugin", { enumerable: true, get: function () { return plugins_1.defineWaClientPlugin; } });
 var media_1 = require("./client/media");
 Object.defineProperty(exports, "downloadMediaMessage", { enumerable: true, get: function () { return media_1.downloadMediaMessage; } });
+var WaMediaCrypto_1 = require("./media/crypto/WaMediaCrypto");
+Object.defineProperty(exports, "WaMediaCrypto", { enumerable: true, get: function () { return WaMediaCrypto_1.WaMediaCrypto; } });
+var WaMediaTransferClient_1 = require("./media/transfer/WaMediaTransferClient");
+Object.defineProperty(exports, "WaMediaTransferClient", { enumerable: true, get: function () { return WaMediaTransferClient_1.WaMediaTransferClient; } });
 var companion_host_1 = require("./client/persistence/companion-host");
 Object.defineProperty(exports, "createFileCompanionHostPersistence", { enumerable: true, get: function () { return companion_host_1.createFileCompanionHostPersistence; } });
 var usync_1 = require("./transport/node/builders/usync");

package/dist/signal/api/SignalDeviceSyncApi.d.ts

@@ -11,9 +11,23 @@ interface SignalDeviceSyncApiOptions {
     readonly generateSid?: WaUsyncSidGenerator;
 }
 export interface SignalLidSyncResult {
+    /**
+     * The phone jid the caller queried (normalized), so results can be correlated
+     * back to the input by value rather than by array position. Equals `phoneJid`
+     * unless the server corrected the number.
+     */
+    readonly queriedJid: string;
+    /** The server's canonical/corrected phone jid (e.g. BR 9th digit added). */
     readonly phoneJid: string;
     readonly lidJid: string | null;
     readonly exists: boolean;
+    /**
+     * `true` when the server rejected the number as malformed (`<user
+     * jid='undefined'>` with `<contact type='invalid'>`) - distinct from a
+     * well-formed number that simply has no WhatsApp account (`exists: false`,
+     * `invalid: false`).
+     */
+    readonly invalid: boolean;
 }
 /**
  * Resolves the device list and LID mapping for a set of users via the `usync`
@@ -55,10 +69,23 @@ export declare class SignalDeviceSyncApi {
     private makeLidSyncRequest;
     private parseDeviceSyncResponse;
     private parseLidSyncResponse;
-    private buildLidSyncResult;
+    /**
+     * Recovers the queried phone JID from a `<contact>` echo. Each `<contact>` in a
+     * usync response echoes the `+<number>` we sent (base64 text content), so it maps
+     * a response node back to the exact input - even when the server corrected the
+     * `<user jid>` or rejected it as `jid='undefined'`. Returns `null` when there is
+     * no decodable phone echo.
+     */
+    private recoverContactJid;
     private parseLidSyncContactExists;
     private parseUserDeviceJids;
     private normalizeUsers;
-    private normalizeUserJid;
+    /**
+     * Canonicalizes a user jid, returning `null` instead of throwing when the input
+     * is not a valid jid (for example the literal `'undefined'` the server returns
+     * for an invalid contact). Lets a single malformed response node be skipped
+     * without discarding the rest of the batch.
+     */
+    private tryNormalizeUserJid;
 }
 export {};