zapo-js 1.0.1 → 1.1.0

package/dist/{types/message → message}/context-info.d.ts

@@ -43,6 +43,7 @@ type WaQuoteSource = {
     readonly id?: string;
     readonly remoteJid?: string;
     readonly participant?: string;
+    readonly fromMe?: boolean;
     readonly message?: Proto.IMessage;
 };
 type WaForwardSource = boolean | {
@@ -54,6 +55,14 @@ export interface WaSendContextResolveInput {
     readonly quote?: WaQuoteSource;
     readonly forward?: WaForwardSource;
     readonly mentions?: readonly string[];
+    /**
+     * Chat the message is being sent to. When provided, the quote's
+     * `remoteJid` is emitted only for a cross-chat quote (the quoted message
+     * lives in a different chat), mirroring wa-web's `msgContextInfo`, which
+     * sets `remoteJid` only when `quotedMsg.remote !== targetChat`. Omit it to
+     * keep emitting `remoteJid` unconditionally.
+     */
+    readonly targetJid?: string;
     /**
      * LID-form self user JID. Used as the DM-quote `participant` fallback when
      * the quoted message is `fromMe` and no explicit participant was provided.

package/dist/message/context-info.js

@@ -101,13 +101,23 @@ function resolveSendContextInfo(input) {
         ctx.quotedMessageId = q.id ?? q.key?.id ?? ctx.quotedMessageId;
         const explicit = q.participant ?? q.key?.participant;
         const quotedRemote = q.remoteJid ?? q.key?.remoteJid;
+        const quotedFromMe = q.fromMe ?? q.key?.fromMe;
         const dmFallback = explicit === undefined && quotedRemote && !(0, jid_1.isGroupOrBroadcastJid)(quotedRemote)
-            ? q.key?.fromMe
+            ? quotedFromMe
                 ? input.meLid
                 : quotedRemote
             : undefined;
         ctx.quotedParticipant = explicit ?? dmFallback ?? ctx.quotedParticipant;
-        ctx.quotedRemoteJid = quotedRemote ?? ctx.quotedRemoteJid;
+        const crossChat = quotedRemote !== undefined &&
+            (input.targetJid === undefined || !isSameChatJid(quotedRemote, input.targetJid));
+        if (quotedRemote !== undefined) {
+            if (crossChat) {
+                ctx.quotedRemoteJid = quotedRemote;
+            }
+            else {
+                delete ctx.quotedRemoteJid;
+            }
+        }
         ctx.quotedMessage = q.message ?? ctx.quotedMessage;
     }
     if (input.forward) {
@@ -127,3 +137,6 @@ function hasAnyKey(value) {
     }
     return false;
 }
+function isSameChatJid(a, b) {
+    return (0, jid_1.toUserJid)(a) === (0, jid_1.toUserJid)(b);
+}

package/dist/message/encode/media-payload.d.ts

@@ -0,0 +1,43 @@
+import type { MediaCryptoType } from '../../media/types';
+import type { Proto } from '../../proto';
+/**
+ * Decrypted media metadata pulled out of a message, carrying everything a CDN
+ * download needs (see `downloadMediaMessage`). Binary fields are raw
+ * `Uint8Array`s exactly as the protobuf message carried them - never base64
+ * strings.
+ */
+export interface WaResolvedMediaPayload {
+    /** Crypto/HKDF domain for the kind: image, video, gif, audio, ptt, document, sticker, ptv. */
+    readonly mediaType: MediaCryptoType;
+    /** Server-relative path (or absolute URL) of the encrypted blob on the media CDN. */
+    readonly directPath: string;
+    /** Media key used to derive the AES/MAC keys. Sensitive key material - do not log. */
+    readonly mediaKey: Uint8Array;
+    /** SHA-256 of the decrypted file, when the message carried it. */
+    readonly fileSha256?: Uint8Array;
+    /** SHA-256 of the encrypted file, when the message carried it. */
+    readonly fileEncSha256?: Uint8Array;
+    /** Declared MIME type, when present. */
+    readonly mimetype?: string;
+    /** Declared plaintext length in bytes, when present. */
+    readonly fileLength?: number;
+}
+/**
+ * Extracts the downloadable media metadata from a message, unwrapping
+ * ephemeral / view-once / document-with-caption envelopes first.
+ *
+ * Returns `null` when `message` is absent, carries no media, or the media node
+ * lacks the `directPath` / `mediaKey` needed to fetch and decrypt the blob (a
+ * non-`Uint8Array` `mediaKey` also yields `null`). Supported kinds: image,
+ * video (gif when `gifPlayback`), audio (ptt when `ptt`), document, sticker,
+ * ptv.
+ *
+ * @example
+ * ```ts
+ * const payload = resolveMediaPayload(event.message)
+ * if (payload) {
+ *     // payload.directPath, payload.mediaKey, payload.fileEncSha256, ...
+ * }
+ * ```
+ */
+export declare function resolveMediaPayload(message: Proto.IMessage | null | undefined): WaResolvedMediaPayload | null;

package/dist/message/encode/media-payload.js

@@ -23,6 +23,24 @@ function buildPayload(mediaType, fields) {
         fileLength: fields.fileLength ? (0, primitives_1.longToNumber)(fields.fileLength) : undefined
     };
 }
+/**
+ * Extracts the downloadable media metadata from a message, unwrapping
+ * ephemeral / view-once / document-with-caption envelopes first.
+ *
+ * Returns `null` when `message` is absent, carries no media, or the media node
+ * lacks the `directPath` / `mediaKey` needed to fetch and decrypt the blob (a
+ * non-`Uint8Array` `mediaKey` also yields `null`). Supported kinds: image,
+ * video (gif when `gifPlayback`), audio (ptt when `ptt`), document, sticker,
+ * ptv.
+ *
+ * @example
+ * ```ts
+ * const payload = resolveMediaPayload(event.message)
+ * if (payload) {
+ *     // payload.directPath, payload.mediaKey, payload.fileEncSha256, ...
+ * }
+ * ```
+ */
 function resolveMediaPayload(message) {
     if (!message)
         return null;

package/dist/{types/protocol → protocol}/message.d.ts

@@ -24,6 +24,7 @@ export declare const WA_MESSAGE_TYPES: Readonly<{
     readonly RECEIPT_TYPE_SERVER_ERROR: "server-error";
     readonly RECEIPT_TYPE_RETRY: "retry";
     readonly RECEIPT_TYPE_ENC_REKEY_RETRY: "enc_rekey_retry";
+    readonly RECEIPT_TYPE_VIEW: "view";
 }>;
 export type WaOutboundReceiptType = typeof WA_MESSAGE_TYPES.RECEIPT_TYPE_READ | typeof WA_MESSAGE_TYPES.RECEIPT_TYPE_READ_SELF | typeof WA_MESSAGE_TYPES.RECEIPT_TYPE_PLAYED | typeof WA_MESSAGE_TYPES.RECEIPT_TYPE_PLAYED_SELF | typeof WA_MESSAGE_TYPES.RECEIPT_TYPE_INACTIVE | typeof WA_MESSAGE_TYPES.RECEIPT_TYPE_HISTORY_SYNC;
 export declare const WA_RETRYABLE_ACK_CODES: readonly ["408", "429", "500", "503"];

package/dist/protocol/message.js

@@ -26,7 +26,8 @@ exports.WA_MESSAGE_TYPES = Object.freeze({
     RECEIPT_TYPE_PEER: 'peer_msg',
     RECEIPT_TYPE_SERVER_ERROR: 'server-error',
     RECEIPT_TYPE_RETRY: 'retry',
-    RECEIPT_TYPE_ENC_REKEY_RETRY: 'enc_rekey_retry'
+    RECEIPT_TYPE_ENC_REKEY_RETRY: 'enc_rekey_retry',
+    RECEIPT_TYPE_VIEW: 'view'
 });
 exports.WA_RETRYABLE_ACK_CODES = Object.freeze(['408', '429', '500', '503']);
 exports.WA_STANZA_MSG_TYPES = Object.freeze({

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "zapo-js",
-    "version": "1.0.1",
+    "version": "1.1.0",
     "description": "High-performance WhatsApp Web TypeScript library",
     "license": "MIT",
     "author": "vinikjkkj <contact@vinicius.email> (https://github.com/vinikjkkj)",
@@ -8,91 +8,95 @@
         "type": "github",
         "url": "https://github.com/sponsors/vinikjkkj"
     },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/vinikjkkj/zapo.git"
+    },
     "packageManager": "npm@10.0.0",
     "main": "dist/index.js",
     "module": "dist/esm/index.js",
-    "types": "dist/types/index.d.ts",
+    "types": "dist/index.d.ts",
     "exports": {
         ".": {
-            "types": "./dist/types/index.d.ts",
+            "types": "./dist/index.d.ts",
             "require": "./dist/index.js",
             "import": "./dist/esm/index.js",
             "default": "./dist/index.js"
         },
         "./client": {
-            "types": "./dist/types/client/index.d.ts",
+            "types": "./dist/client/index.d.ts",
             "require": "./dist/client/index.js",
             "import": "./dist/esm/client/index.js",
             "default": "./dist/client/index.js"
         },
         "./appstate": {
-            "types": "./dist/types/appstate/index.d.ts",
+            "types": "./dist/appstate/index.d.ts",
             "require": "./dist/appstate/index.js",
             "import": "./dist/esm/appstate/index.js",
             "default": "./dist/appstate/index.js"
         },
         "./auth": {
-            "types": "./dist/types/auth/index.d.ts",
+            "types": "./dist/auth/index.d.ts",
             "require": "./dist/auth/index.js",
             "import": "./dist/esm/auth/index.js",
             "default": "./dist/auth/index.js"
         },
         "./crypto": {
-            "types": "./dist/types/crypto/index.d.ts",
+            "types": "./dist/crypto/index.d.ts",
             "require": "./dist/crypto/index.js",
             "import": "./dist/esm/crypto/index.js",
             "default": "./dist/crypto/index.js"
         },
         "./media": {
-            "types": "./dist/types/media/index.d.ts",
+            "types": "./dist/media/index.d.ts",
             "require": "./dist/media/index.js",
             "import": "./dist/esm/media/index.js",
             "default": "./dist/media/index.js"
         },
         "./message": {
-            "types": "./dist/types/message/index.d.ts",
+            "types": "./dist/message/index.d.ts",
             "require": "./dist/message/index.js",
             "import": "./dist/esm/message/index.js",
             "default": "./dist/message/index.js"
         },
         "./signal": {
-            "types": "./dist/types/signal/index.d.ts",
+            "types": "./dist/signal/index.d.ts",
             "require": "./dist/signal/index.js",
             "import": "./dist/esm/signal/index.js",
             "default": "./dist/signal/index.js"
         },
         "./store": {
-            "types": "./dist/types/store/index.d.ts",
+            "types": "./dist/store/index.d.ts",
             "require": "./dist/store/index.js",
             "import": "./dist/esm/store/index.js",
             "default": "./dist/store/index.js"
         },
         "./transport": {
-            "types": "./dist/types/transport/index.d.ts",
+            "types": "./dist/transport/index.d.ts",
             "require": "./dist/transport/index.js",
             "import": "./dist/esm/transport/index.js",
             "default": "./dist/transport/index.js"
         },
         "./protocol": {
-            "types": "./dist/types/protocol/index.d.ts",
+            "types": "./dist/protocol/index.d.ts",
             "require": "./dist/protocol/index.js",
             "import": "./dist/esm/protocol/index.js",
             "default": "./dist/protocol/index.js"
         },
         "./retry": {
-            "types": "./dist/types/retry/index.d.ts",
+            "types": "./dist/retry/index.d.ts",
             "require": "./dist/retry/index.js",
             "import": "./dist/esm/retry/index.js",
             "default": "./dist/retry/index.js"
         },
         "./util": {
-            "types": "./dist/types/util/index.d.ts",
+            "types": "./dist/util/index.d.ts",
             "require": "./dist/util/index.js",
             "import": "./dist/esm/util/index.js",
             "default": "./dist/util/index.js"
         },
         "./proto": {
-            "types": "./dist/types/proto.d.ts",
+            "types": "./dist/proto.d.ts",
             "require": "./dist/proto.js",
             "import": "./dist/esm/proto.js",
             "default": "./dist/proto.js"

package/dist/types/client/events/receipt.d.ts

@@ -1,14 +0,0 @@
-interface ReceiptTarget {
-    readonly chatJid: string;
-    readonly id: string;
-    readonly senderJid?: string;
-    readonly isGroupChat?: boolean;
-    readonly isBroadcastChat?: boolean;
-}
-interface AggregatedReceiptGroup {
-    readonly jid: string;
-    readonly ids: readonly string[];
-    readonly participant?: string;
-}
-export declare function aggregateReceiptTargets(targets: readonly ReceiptTarget[]): readonly AggregatedReceiptGroup[];
-export {};

package/dist/types/message/encode/media-payload.d.ts

@@ -1,12 +0,0 @@
-import type { MediaCryptoType } from '../../media/types';
-import type { Proto } from '../../proto';
-export interface WaResolvedMediaPayload {
-    readonly mediaType: MediaCryptoType;
-    readonly directPath: string;
-    readonly mediaKey: Uint8Array;
-    readonly fileSha256?: Uint8Array;
-    readonly fileEncSha256?: Uint8Array;
-    readonly mimetype?: string;
-    readonly fileLength?: number;
-}
-export declare function resolveMediaPayload(message: Proto.IMessage | null | undefined): WaResolvedMediaPayload | null;