zapo-js 0.1.2 → 0.3.0

package/dist/types/transport/node/mex/persist-ids.d.ts

@@ -0,0 +1,14 @@
+export interface WaMexPersistId {
+    readonly docId: string;
+    readonly clientDocId: string;
+}
+export declare const WA_MEX_PERSIST_IDS: Readonly<{
+    WWWGetCertificates: Readonly<{
+        docId: "25094190163544446";
+        clientDocId: "16428758503015954638431529919";
+    }>;
+    WWWCreateUser: Readonly<{
+        docId: "8548056818544135";
+        clientDocId: "25777518041400352865446016972";
+    }>;
+}>;

package/dist/types/transport/noise/WaMobileClientPayload.d.ts

@@ -0,0 +1,29 @@
+import { type Proto } from '../..';
+export interface WaMobileTransportDeviceInfo {
+    readonly manufacturer: string;
+    readonly device: string;
+    readonly osVersion: string;
+    readonly osBuildNumber: string;
+    readonly appVersion: string;
+    readonly mcc?: string;
+    readonly mnc?: string;
+    readonly localeLanguageIso6391?: string;
+    readonly localeCountryIso31661Alpha2?: string;
+    readonly phoneId?: string;
+    readonly deviceBoard?: string;
+    readonly deviceModelType?: string;
+}
+export interface WaMobileLoginPayloadConfig {
+    readonly username: number;
+    readonly device?: number;
+    readonly passive?: boolean;
+    readonly pull?: boolean;
+    readonly deviceInfo: WaMobileTransportDeviceInfo;
+    readonly lidDbMigrated?: boolean;
+    readonly connectReason?: Proto.ClientPayload.ConnectReason;
+    readonly connectType?: Proto.ClientPayload.ConnectType;
+    readonly pushName?: string;
+    readonly yearClass?: number;
+    readonly memClass?: number;
+}
+export declare function buildMobileLoginPayload(config: WaMobileLoginPayloadConfig): Uint8Array;

package/dist/types/transport/noise/WaNoiseCert.d.ts

@@ -1 +1,7 @@
-export declare function verifyNoiseCertificateChain(certificateChain: Uint8Array, serverStatic: Uint8Array): Promise<void>;
+export interface WaNoiseRootCa {
+    /** Raw 32-byte X25519 public key (without version prefix). */
+    readonly publicKey: Uint8Array;
+    /** Serial number that intermediate certs issued by this root must claim. */
+    readonly serial: number;
+}
+export declare function verifyNoiseCertificateChain(certificateChain: Uint8Array, serverStatic: Uint8Array, rootCa?: WaNoiseRootCa): Promise<void>;

package/dist/types/transport/noise/WaNoiseSession.d.ts

@@ -3,8 +3,8 @@ import type { WaNoiseConfig } from '../types';
 export declare class WaNoiseSession {
     private readonly sendWire;
     private readonly logger;
-    private readonly writeQueue;
-    private readonly readQueue;
+    private writeChain;
+    private readChain;
     private frameCodec;
     private handshakeInbox;
     private handshakeInboxHead;
@@ -14,12 +14,14 @@ export declare class WaNoiseSession {
     private closedError;
     private noiseSocket;
     private serverStaticKey;
+    private trustedRootCa;
     private readonly handshakeFrameTimeoutMs;
     constructor(sendWire: (payload: Uint8Array) => Promise<void>, logger?: Logger);
     start(config: WaNoiseConfig): Promise<void>;
     encryptFrame(frame: Uint8Array): Promise<Uint8Array>;
     pushWireChunk(chunk: Uint8Array): Promise<readonly Uint8Array[]>;
     onSocketClosed(error?: Error): void;
+    private decryptFramesBatch;
     reset(): void;
     getServerStaticKey(): Uint8Array | null;
     private fullHandshake;

package/dist/types/transport/noise/WaNoiseSocket.d.ts

@@ -5,6 +5,8 @@ export declare class WaNoiseSocket {
     private writeCounter;
     private readCounter;
     constructor(encryptKey: CryptoKey, decryptKey: CryptoKey);
-    encrypt(frame: Uint8Array, additionalData?: Uint8Array): Promise<Uint8Array>;
-    decrypt(frame: Uint8Array, additionalData?: Uint8Array): Promise<Uint8Array>;
+    reserveWriteNonce(): Uint8Array;
+    encrypt(nonce: Uint8Array, frame: Uint8Array, additionalData?: Uint8Array): Promise<Uint8Array>;
+    reserveReadNonce(): Uint8Array;
+    decrypt(nonce: Uint8Array, frame: Uint8Array, additionalData?: Uint8Array): Promise<Uint8Array>;
 }

package/dist/types/transport/types.d.ts

@@ -28,6 +28,7 @@ export interface WaSocketConfig {
     readonly dispatcher?: WaProxyDispatcher;
     readonly agent?: WaProxyAgent;
     readonly timeoutIntervalMs?: number;
+    readonly rawWebSocketConstructor?: RawWebSocketConstructor;
 }
 export interface WaSocketHandlers {
     readonly onOpen?: (info: SocketOpenInfo) => void | Promise<void>;
@@ -58,6 +59,13 @@ export interface WaNoiseConfig {
     readonly routingInfo?: Uint8Array;
     readonly protocolHeader?: Uint8Array;
     readonly verifyCertificateChain?: boolean;
+    readonly trustedRootCa?: WaNoiseTrustedRootCa;
+}
+export interface WaNoiseTrustedRootCa {
+    /** Raw 32-byte X25519 public key (without version prefix). */
+    readonly publicKey: Uint8Array;
+    /** Serial number that intermediate certs issued by this root must claim. */
+    readonly serial: number;
 }
 export interface WebSocketEventLike {
     readonly code?: number;

package/dist/types/util/bytes.d.ts

@@ -15,7 +15,7 @@ export declare function bytesToBase64(value: Uint8Array): string;
 export declare function base64ToBytes(value: string): Uint8Array;
 export declare function base64ToBytesChecked(value: string, field: string, requireNonEmpty?: boolean): Uint8Array;
 export declare function decodeBase64Url(value: string | undefined, field: string): Uint8Array;
-export declare function assertByteLength(value: Uint8Array, expectedLength: number, errorMessage: string, throwOnMismatch?: boolean): boolean;
+export declare function assertByteLength(value: Uint8Array, expectedLength: number, errorMessage: string): void;
 export declare function decodeProtoBytes(value: Uint8Array | string | null | undefined, field: string): Uint8Array;
 /**
  * Encodes a Uint8Array to a base64url string (URL-safe, no padding)

package/dist/types/util/index.d.ts

@@ -0,0 +1,5 @@
+export { bytesToHex, hexToBytes, toBytesView, uint8Equal } from './bytes';
+export { asBytes, asNumber, asOptionalBytes, asOptionalNumber, asOptionalString, asString, resolvePositive, toBoolOrUndef } from './coercion';
+export { normalizeQueryLimit } from './collections';
+export { toSafeNumber } from './primitives';
+export { isBunRuntime } from './runtime';

package/dist/types/util/primitives.d.ts

@@ -6,5 +6,4 @@ export declare function longToNumber(value: number | {
     toNumber(): number;
 } | null | undefined): number;
 export declare function normalizeNonNegativeInteger(value: number | undefined, fallback: number): number;
-export declare function parseStrictUnsignedInt(value: string): number | undefined;
 export declare function parseOptionalInt(value: string | undefined): number | undefined;

package/dist/util/bytes.js

@@ -140,14 +140,10 @@ function decodeBase64Url(value, field) {
         .padEnd(Math.ceil(value.length / 4) * 4, '=');
     return base64ToBytesChecked(padded, field);
 }
-function assertByteLength(value, expectedLength, errorMessage, throwOnMismatch = true) {
+function assertByteLength(value, expectedLength, errorMessage) {
     if (value.length !== expectedLength) {
-        if (!throwOnMismatch) {
-            return false;
-        }
         throw new Error(errorMessage);
     }
-    return true;
 }
 function decodeProtoBytes(value, field) {
     if (value === null || value === undefined) {
@@ -214,12 +210,15 @@ function encodeBase64(value, alphabet, pad) {
     return out.join('');
 }
 function concatBytes(parts) {
-    const total = parts.reduce((sum, current) => sum + current.length, 0);
+    let total = 0;
+    for (let i = 0; i < parts.length; i += 1) {
+        total += parts[i].length;
+    }
     const out = new Uint8Array(total);
     let offset = 0;
-    for (const part of parts) {
-        out.set(part, offset);
-        offset += part.length;
+    for (let i = 0; i < parts.length; i += 1) {
+        out.set(parts[i], offset);
+        offset += parts[i].length;
     }
     return out;
 }
@@ -260,10 +259,21 @@ function uint8Equal(a, b) {
     return diff === 0;
 }
 function removeAt(items, index) {
-    const out = [];
+    if (items.length === 0) {
+        return [];
+    }
+    if (index < 0 || index >= items.length) {
+        const out = new Array(items.length);
+        for (let i = 0; i < items.length; i += 1) {
+            out[i] = items[i];
+        }
+        return out;
+    }
+    const out = new Array(items.length - 1);
+    let k = 0;
     for (let i = 0; i < items.length; i += 1) {
         if (i !== index) {
-            out.push(items[i]);
+            out[k++] = items[i];
         }
     }
     return out;
@@ -303,11 +313,5 @@ async function readAllBytes(stream, options = {}) {
     if (chunks.length === 1) {
         return chunks[0];
     }
-    const merged = new Uint8Array(total);
-    let offset = 0;
-    for (const chunk of chunks) {
-        merged.set(chunk, offset);
-        offset += chunk.byteLength;
-    }
-    return merged;
+    return concatBytes(chunks);
 }

package/dist/util/index.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isBunRuntime = exports.toSafeNumber = exports.normalizeQueryLimit = exports.toBoolOrUndef = exports.resolvePositive = exports.asString = exports.asOptionalString = exports.asOptionalNumber = exports.asOptionalBytes = exports.asNumber = exports.asBytes = exports.uint8Equal = exports.toBytesView = exports.hexToBytes = exports.bytesToHex = void 0;
+var bytes_1 = require("./bytes");
+Object.defineProperty(exports, "bytesToHex", { enumerable: true, get: function () { return bytes_1.bytesToHex; } });
+Object.defineProperty(exports, "hexToBytes", { enumerable: true, get: function () { return bytes_1.hexToBytes; } });
+Object.defineProperty(exports, "toBytesView", { enumerable: true, get: function () { return bytes_1.toBytesView; } });
+Object.defineProperty(exports, "uint8Equal", { enumerable: true, get: function () { return bytes_1.uint8Equal; } });
+var coercion_1 = require("./coercion");
+Object.defineProperty(exports, "asBytes", { enumerable: true, get: function () { return coercion_1.asBytes; } });
+Object.defineProperty(exports, "asNumber", { enumerable: true, get: function () { return coercion_1.asNumber; } });
+Object.defineProperty(exports, "asOptionalBytes", { enumerable: true, get: function () { return coercion_1.asOptionalBytes; } });
+Object.defineProperty(exports, "asOptionalNumber", { enumerable: true, get: function () { return coercion_1.asOptionalNumber; } });
+Object.defineProperty(exports, "asOptionalString", { enumerable: true, get: function () { return coercion_1.asOptionalString; } });
+Object.defineProperty(exports, "asString", { enumerable: true, get: function () { return coercion_1.asString; } });
+Object.defineProperty(exports, "resolvePositive", { enumerable: true, get: function () { return coercion_1.resolvePositive; } });
+Object.defineProperty(exports, "toBoolOrUndef", { enumerable: true, get: function () { return coercion_1.toBoolOrUndef; } });
+var collections_1 = require("./collections");
+Object.defineProperty(exports, "normalizeQueryLimit", { enumerable: true, get: function () { return collections_1.normalizeQueryLimit; } });
+var primitives_1 = require("./primitives");
+Object.defineProperty(exports, "toSafeNumber", { enumerable: true, get: function () { return primitives_1.toSafeNumber; } });
+var runtime_1 = require("./runtime");
+Object.defineProperty(exports, "isBunRuntime", { enumerable: true, get: function () { return runtime_1.isBunRuntime; } });

package/dist/util/primitives.js

@@ -4,8 +4,8 @@ exports.toError = toError;
 exports.toSafeNumber = toSafeNumber;
 exports.longToNumber = longToNumber;
 exports.normalizeNonNegativeInteger = normalizeNonNegativeInteger;
-exports.parseStrictUnsignedInt = parseStrictUnsignedInt;
 exports.parseOptionalInt = parseOptionalInt;
+const DIGITS_ONLY_RE = /^\d+$/;
 function toError(value) {
     if (value instanceof Error)
         return value;
@@ -51,7 +51,7 @@ function normalizeNonNegativeInteger(value, fallback) {
     return Math.max(0, Math.trunc(value));
 }
 function parseStrictUnsignedInt(value) {
-    if (!/^\d+$/.test(value))
+    if (!DIGITS_ONLY_RE.test(value))
         return undefined;
     const parsed = Number(value);
     if (!Number.isSafeInteger(parsed))

package/package.json

@@ -1,11 +1,12 @@
 {
     "name": "zapo-js",
-    "version": "0.1.2",
+    "version": "0.3.0",
     "description": "High-performance WhatsApp Web TypeScript library",
     "funding": {
         "type": "github",
         "url": "https://github.com/sponsors/vinikjkkj"
     },
+    "packageManager": "npm@10.0.0",
     "main": "dist/index.js",
     "module": "dist/esm/index.js",
     "types": "dist/types/index.d.ts",
@@ -70,6 +71,24 @@
             "import": "./dist/esm/transport/index.js",
             "default": "./dist/transport/index.js"
         },
+        "./protocol": {
+            "types": "./dist/types/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",
+            "require": "./dist/retry/index.js",
+            "import": "./dist/esm/retry/index.js",
+            "default": "./dist/retry/index.js"
+        },
+        "./util": {
+            "types": "./dist/types/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",
             "require": "./dist/proto.js",
@@ -84,6 +103,9 @@
         "proto/index.d.ts",
         "scripts/check-node-version.cjs"
     ],
+    "workspaces": [
+        "packages/*"
+    ],
     "engines": {
         "node": ">=20.9.0"
     },
@@ -92,13 +114,14 @@
         "changeset": "changeset",
         "changeset:status": "changeset status --verbose",
         "version:packages": "changeset version",
-        "release:publish": "npm run build && changeset publish",
+        "release:publish": "npm run build && npm run build:packages && changeset publish",
         "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
         "build:cjs": "tsc -p tsconfig.build.cjs.json && tsc-alias -p tsconfig.build.cjs.json",
         "build:esm": "tsc -p tsconfig.build.esm.json && tsc-alias -p tsconfig.build.esm.json",
         "build:types": "tsc -p tsconfig.build.types.json && tsc-alias -p tsconfig.build.types.json",
         "build:esm:finalize": "node ./scripts/finalize-esm-build.cjs",
         "build": "npm run clean && npm run build:cjs && npm run build:esm && npm run build:types && npm run build:esm:finalize",
+        "build:packages": "turbo run build",
         "proto:generate": "node ./scripts/generate-proto.cjs",
         "example": "tsx examples/example.ts",
         "bench:media": "node --expose-gc --import tsx bench/media-streaming.bench.ts",
@@ -109,30 +132,28 @@
         "bench:comment": "node ./scripts/build-bench-comment.cjs",
         "test:structure": "node ./scripts/check-tests-structure.cjs",
         "test": "npm run test:structure && node --import tsx --test --test-skip-pattern \"\\\\[flow\\\\]\" \"src/**/__tests__/**/*.test.ts\"",
+        "test:packages": "turbo run test",
+        "test:stores": "node ./scripts/test-stores.cjs",
         "test:watch": "node --import tsx --test --watch --test-skip-pattern \"\\\\[flow\\\\]\" \"src/**/__tests__/**/*.test.ts\"",
         "test:flow": "node --import tsx --test --test-concurrency=1 \"src/**/__tests__/**/*.flow.test.ts\"",
         "test:flow:watch": "node --import tsx --test --watch --test-concurrency=1 \"src/**/__tests__/**/*.flow.test.ts\"",
         "test:coverage": "npm run test:structure && c8 --all --include \"src/**/*.ts\" --exclude \"src/**/*.d.ts\" --exclude \"src/**/__tests__/**\" --exclude \"src/**/types.ts\" --exclude \"src/store/contracts/**/*.ts\" --reporter text --reporter html --reporter lcov node --import tsx --test --test-skip-pattern \"\\\\[flow\\\\]\" \"src/**/__tests__/**/*.test.ts\"",
         "test:coverage:open": "node -e \"require('node:child_process').execSync(process.platform === 'win32' ? 'start coverage\\\\index.html' : process.platform === 'darwin' ? 'open coverage/index.html' : 'xdg-open coverage/index.html', { stdio: 'inherit' })\"",
         "typecheck": "tsc -p tsconfig.json --noEmit",
+        "typecheck:packages": "turbo run typecheck",
         "lint": "eslint . --ext .ts,.js,.cjs",
         "lint:fix": "eslint . --ext .ts,.js,.cjs --fix",
         "format": "prettier . --write",
         "format:check": "prettier . --check"
     },
-    "dependencies": {},
     "peerDependencies": {
-        "better-sqlite3": "^11.9.1",
-        "got": "14.6.4",
+        "argo-codec": "^0.2.1",
         "pino": "^9.0.0",
         "pino-pretty": "^13.0.0",
         "ws": "^8.18.3"
     },
     "peerDependenciesMeta": {
-        "better-sqlite3": {
-            "optional": true
-        },
-        "got": {
+        "argo-codec": {
             "optional": true
         },
         "pino": {
@@ -151,16 +172,19 @@
         "@types/ws": "^8.18.1",
         "@typescript-eslint/parser": "^8.56.1",
         "@vinikjkkj/eslint-config": "^1.0.0",
+        "argo-codec": "^0.2.1",
         "better-sqlite3": "^12.6.2",
         "c8": "^11.0.0",
         "eslint": "^9.39.4",
+        "eslint-import-resolver-typescript": "^4.4.4",
         "eslint-plugin-import": "^2.32.0",
-        "got": "14.6.4",
+        "eslint-plugin-n": "^17.24.0",
         "pino": "^10.3.1",
         "pino-pretty": "^13.1.3",
         "prettier": "^3.8.1",
         "tsc-alias": "^1.8.16",
         "tsx": "^4.20.6",
+        "turbo": "^2.8.20",
         "typescript": "^5.7.3",
         "typescript-eslint": "^8.56.1",
         "ws": "^8.18.3"