zapo-js 0.1.1 → 0.1.2

package/dist/util/bytes.js

@@ -1,10 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EMPTY_BYTES = exports.TEXT_DECODER = exports.TEXT_ENCODER = void 0;
+exports.EMPTY_BYTES = exports.ZERO_BYTES = exports.TEXT_DECODER = exports.TEXT_ENCODER = void 0;
 exports.bytesToHex = bytesToHex;
 exports.hexToBytes = hexToBytes;
 exports.bytesToBase64 = bytesToBase64;
 exports.base64ToBytes = base64ToBytes;
+exports.base64ToBytesChecked = base64ToBytesChecked;
+exports.decodeBase64Url = decodeBase64Url;
+exports.assertByteLength = assertByteLength;
+exports.decodeProtoBytes = decodeProtoBytes;
 exports.bytesToBase64UrlSafe = bytesToBase64UrlSafe;
 exports.concatBytes = concatBytes;
 exports.toBytesView = toBytesView;
@@ -17,6 +21,7 @@ exports.readAllBytes = readAllBytes;
 const node_crypto_1 = require("node:crypto");
 exports.TEXT_ENCODER = new TextEncoder();
 exports.TEXT_DECODER = new TextDecoder();
+exports.ZERO_BYTES = new Uint8Array([0]);
 exports.EMPTY_BYTES = Object.freeze(new Uint8Array(0));
 const HEX_CHARS = '0123456789abcdef';
 const HEX_TABLE = /* @__PURE__ */ (() => {
@@ -106,28 +111,52 @@ function base64ToBytes(value) {
         out[j++] = ((b & 0x0f) << 4) | (c >> 2);
         out[j++] = ((c & 0x03) << 6) | d;
     }
-    if (padding === 0) {
-        const a = lookupBase64(value.charCodeAt(i));
-        const b = lookupBase64(value.charCodeAt(i + 1));
+    const a = lookupBase64(value.charCodeAt(i));
+    const b = lookupBase64(value.charCodeAt(i + 1));
+    out[j++] = (a << 2) | (b >> 4);
+    if (j < outLen) {
         const c = lookupBase64(value.charCodeAt(i + 2));
-        const d = lookupBase64(value.charCodeAt(i + 3));
-        out[j++] = (a << 2) | (b >> 4);
         out[j++] = ((b & 0x0f) << 4) | (c >> 2);
-        out[j++] = ((c & 0x03) << 6) | d;
+        if (j < outLen) {
+            const d = lookupBase64(value.charCodeAt(i + 3));
+            out[j++] = ((c & 0x03) << 6) | d;
+        }
     }
-    else if (padding === 1) {
-        const a = lookupBase64(value.charCodeAt(i));
-        const b = lookupBase64(value.charCodeAt(i + 1));
-        const c = lookupBase64(value.charCodeAt(i + 2));
-        out[j++] = (a << 2) | (b >> 4);
-        out[j++] = ((b & 0x0f) << 4) | (c >> 2);
+    return out;
+}
+function base64ToBytesChecked(value, field, requireNonEmpty = true) {
+    if (requireNonEmpty && value.length === 0) {
+        throw new Error(`invalid base64 payload for ${field}`);
     }
-    else {
-        const a = lookupBase64(value.charCodeAt(i));
-        const b = lookupBase64(value.charCodeAt(i + 1));
-        out[j++] = (a << 2) | (b >> 4);
+    return base64ToBytes(value);
+}
+function decodeBase64Url(value, field) {
+    if (!value) {
+        throw new Error(`missing ${field}`);
+    }
+    const padded = value
+        .replace(/-/g, '+')
+        .replace(/_/g, '/')
+        .padEnd(Math.ceil(value.length / 4) * 4, '=');
+    return base64ToBytesChecked(padded, field);
+}
+function assertByteLength(value, expectedLength, errorMessage, throwOnMismatch = true) {
+    if (value.length !== expectedLength) {
+        if (!throwOnMismatch) {
+            return false;
+        }
+        throw new Error(errorMessage);
     }
-    return out;
+    return true;
+}
+function decodeProtoBytes(value, field) {
+    if (value === null || value === undefined) {
+        throw new Error(`missing protobuf bytes field ${field}`);
+    }
+    if (value instanceof Uint8Array) {
+        return value;
+    }
+    return base64ToBytes(value);
 }
 function lookupBase64(code) {
     if (code > 127) {
@@ -196,28 +225,21 @@ function concatBytes(parts) {
 }
 function toBytesView(value) {
     if (value instanceof Uint8Array) {
-        if (value.constructor === Uint8Array) {
-            return value;
-        }
-        return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
+        return value.constructor === Uint8Array
+            ? value
+            : new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
     }
-    if (ArrayBuffer.isView(value)) {
-        return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
+    if (value instanceof ArrayBuffer) {
+        return new Uint8Array(value);
     }
-    return new Uint8Array(value);
+    return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
 }
 function toChunkBytes(chunk) {
-    if (chunk instanceof Uint8Array) {
-        return chunk;
-    }
-    if (chunk instanceof ArrayBuffer) {
-        return new Uint8Array(chunk);
-    }
     if (typeof chunk === 'string') {
         return exports.TEXT_ENCODER.encode(chunk);
     }
-    if (ArrayBuffer.isView(chunk)) {
-        return new Uint8Array(chunk.buffer, chunk.byteOffset, chunk.byteLength);
+    if (chunk instanceof Uint8Array || chunk instanceof ArrayBuffer || ArrayBuffer.isView(chunk)) {
+        return toBytesView(chunk);
     }
     throw new Error(`unsupported stream chunk type: ${typeof chunk}`);
 }

package/dist/util/coercion.js

@@ -20,9 +20,8 @@ function asNumber(value, field) {
     throw new Error(`invalid number value for ${field}`);
 }
 function asOptionalNumber(value, field = 'optional number') {
-    if (value === null || value === undefined) {
+    if (value === null || value === undefined)
         return undefined;
-    }
     return asNumber(value, field);
 }
 function asString(value, field) {
@@ -32,9 +31,8 @@ function asString(value, field) {
     throw new Error(`invalid string value for ${field}`);
 }
 function asOptionalString(value, field = 'optional string') {
-    if (value === null || value === undefined) {
+    if (value === null || value === undefined)
         return undefined;
-    }
     return asString(value, field);
 }
 function asBytes(value, field) {
@@ -44,23 +42,17 @@ function asBytes(value, field) {
     throw new Error(`invalid bytes value for ${field}`);
 }
 function asOptionalBytes(value, field = 'optional bytes') {
-    if (value === null || value === undefined) {
+    if (value === null || value === undefined)
         return undefined;
-    }
     return asBytes(value, field);
 }
 function toBoolOrUndef(value) {
-    if (value === null || value === undefined) {
-        return undefined;
-    }
-    return Boolean(value);
+    return value === null || value === undefined ? undefined : Boolean(value);
 }
 function resolvePositive(value, fallback, name) {
-    if (value === undefined) {
+    if (value === undefined)
         return fallback;
-    }
-    if (Number.isSafeInteger(value) && value > 0) {
+    if (Number.isSafeInteger(value) && value > 0)
         return value;
-    }
     throw new Error(`${name} must be a positive safe integer`);
 }

package/dist/util/primitives.js

@@ -3,35 +3,63 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.toError = toError;
 exports.toSafeNumber = toSafeNumber;
 exports.longToNumber = longToNumber;
+exports.normalizeNonNegativeInteger = normalizeNonNegativeInteger;
+exports.parseStrictUnsignedInt = parseStrictUnsignedInt;
+exports.parseOptionalInt = parseOptionalInt;
 function toError(value) {
-    if (value instanceof Error) {
+    if (value instanceof Error)
         return value;
-    }
-    if (typeof value === 'string') {
+    if (typeof value === 'string')
         return new Error(value);
+    if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') {
+        return new Error(String(value));
+    }
+    if (value && typeof value === 'object') {
+        const message = value.message;
+        if (typeof message === 'string' && message.length > 0) {
+            return new Error(message);
+        }
+        const code = value.code;
+        if (typeof code === 'string' || typeof code === 'number') {
+            return new Error(`unknown error (${code})`);
+        }
     }
     return new Error('unknown error');
 }
 function assertSafeInteger(value, field, nullishBehavior) {
-    if (!Number.isFinite(value) || !Number.isSafeInteger(value)) {
-        const prefix = nullishBehavior === 'throw' ? `invalid ${field}` : 'invalid long numeric value';
-        throw new Error(`${prefix}: ${value}`);
-    }
-    return value;
+    if (Number.isFinite(value) && Number.isSafeInteger(value))
+        return value;
+    const prefix = nullishBehavior === 'throw' ? `invalid ${field}` : 'invalid long numeric value';
+    throw new Error(`${prefix}: ${value}`);
 }
 function toSafeNumber(value, field) {
-    if (value === null || value === undefined) {
+    if (value === null || value === undefined)
         throw new Error(`missing ${field}`);
-    }
     const numeric = typeof value === 'number' ? value : value.toNumber?.();
-    if (typeof numeric !== 'number') {
+    if (typeof numeric !== 'number')
         throw new Error(`invalid ${field}`);
-    }
     return assertSafeInteger(numeric, field, 'throw');
 }
 function longToNumber(value) {
-    if (value === null || value === undefined) {
+    if (value === null || value === undefined)
         return 0;
-    }
     return assertSafeInteger(typeof value === 'number' ? value : value.toNumber(), '', 'zero');
 }
+function normalizeNonNegativeInteger(value, fallback) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return fallback;
+    return Math.max(0, Math.trunc(value));
+}
+function parseStrictUnsignedInt(value) {
+    if (!/^\d+$/.test(value))
+        return undefined;
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed))
+        return undefined;
+    return parsed;
+}
+function parseOptionalInt(value) {
+    if (!value)
+        return undefined;
+    return parseStrictUnsignedInt(value);
+}

package/package.json

@@ -1,7 +1,11 @@
 {
     "name": "zapo-js",
-    "version": "0.1.1",
+    "version": "0.1.2",
     "description": "High-performance WhatsApp Web TypeScript library",
+    "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/vinikjkkj"
+    },
     "main": "dist/index.js",
     "module": "dist/esm/index.js",
     "types": "dist/types/index.d.ts",
@@ -97,6 +101,12 @@
         "build": "npm run clean && npm run build:cjs && npm run build:esm && npm run build:types && npm run build:esm:finalize",
         "proto:generate": "node ./scripts/generate-proto.cjs",
         "example": "tsx examples/example.ts",
+        "bench:media": "node --expose-gc --import tsx bench/media-streaming.bench.ts",
+        "bench:binary": "node --expose-gc --import tsx bench/binary-codec.bench.ts",
+        "bench:crypto": "node --expose-gc --import tsx bench/crypto-core.bench.ts",
+        "bench:store:memory": "node --expose-gc --import tsx bench/store-memory.bench.ts",
+        "bench:all": "npm run bench:media && npm run bench:binary && npm run bench:crypto && npm run bench:store:memory",
+        "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:watch": "node --import tsx --test --watch --test-skip-pattern \"\\\\[flow\\\\]\" \"src/**/__tests__/**/*.test.ts\"",
@@ -105,43 +115,54 @@
         "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",
-        "lint": "eslint \"src/**/*.{ts,js}\"",
-        "lint:fix": "eslint \"src/**/*.{ts,js}\" --fix",
+        "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",
         "pino": "^9.0.0",
-        "pino-pretty": "^13.0.0"
+        "pino-pretty": "^13.0.0",
+        "ws": "^8.18.3"
     },
     "peerDependenciesMeta": {
         "better-sqlite3": {
             "optional": true
         },
+        "got": {
+            "optional": true
+        },
         "pino": {
             "optional": true
         },
         "pino-pretty": {
             "optional": true
+        },
+        "ws": {
+            "optional": true
         }
     },
     "devDependencies": {
         "@changesets/cli": "^2.30.0",
         "@types/node": "^22.13.14",
+        "@types/ws": "^8.18.1",
         "@typescript-eslint/parser": "^8.56.1",
         "@vinikjkkj/eslint-config": "^1.0.0",
         "better-sqlite3": "^12.6.2",
         "c8": "^11.0.0",
         "eslint": "^9.39.4",
         "eslint-plugin-import": "^2.32.0",
+        "got": "14.6.4",
         "pino": "^10.3.1",
         "pino-pretty": "^13.1.3",
         "prettier": "^3.8.1",
         "tsc-alias": "^1.8.16",
         "tsx": "^4.20.6",
         "typescript": "^5.7.3",
-        "typescript-eslint": "^8.56.1"
+        "typescript-eslint": "^8.56.1",
+        "ws": "^8.18.3"
     }
 }

package/dist/crypto/core/encoding.js

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.decodeBase64Url = decodeBase64Url;
-exports.assert32 = assert32;
-const bytes_1 = require("../../util/bytes");
-/**
- * Base64 URL encoding utilities
- */
-/**
- * Decodes a base64url encoded string to Uint8Array
- */
-function decodeBase64Url(value, field) {
-    if (!value) {
-        throw new Error(`missing ${field}`);
-    }
-    const padded = value
-        .replace(/-/g, '+')
-        .replace(/_/g, '/')
-        .padEnd(Math.ceil(value.length / 4) * 4, '=');
-    return (0, bytes_1.base64ToBytes)(padded);
-}
-/**
- * Asserts that a Uint8Array is exactly 32 bytes
- */
-function assert32(value, name) {
-    if (value.length !== 32) {
-        throw new Error(`${name} must be 32 bytes`);
-    }
-}

package/dist/esm/crypto/core/encoding.js

@@ -1,25 +0,0 @@
-import { base64ToBytes } from '../../util/bytes.js';
-/**
- * Base64 URL encoding utilities
- */
-/**
- * Decodes a base64url encoded string to Uint8Array
- */
-export function decodeBase64Url(value, field) {
-    if (!value) {
-        throw new Error(`missing ${field}`);
-    }
-    const padded = value
-        .replace(/-/g, '+')
-        .replace(/_/g, '/')
-        .padEnd(Math.ceil(value.length / 4) * 4, '=');
-    return base64ToBytes(padded);
-}
-/**
- * Asserts that a Uint8Array is exactly 32 bytes
- */
-export function assert32(value, name) {
-    if (value.length !== 32) {
-        throw new Error(`${name} must be 32 bytes`);
-    }
-}

package/dist/esm/util/base64.js

@@ -1,18 +0,0 @@
-import { base64ToBytes as decodeBase64, bytesToBase64, bytesToBase64UrlSafe } from './bytes.js';
-export { bytesToBase64, bytesToBase64UrlSafe };
-export function base64ToBytes(value, field, requireNonEmpty = true) {
-    const out = decodeBase64(value);
-    if (requireNonEmpty && out.length === 0) {
-        throw new Error(`invalid base64 payload for ${field}`);
-    }
-    return out;
-}
-export function decodeProtoBytes(value, field) {
-    if (value === null || value === undefined) {
-        throw new Error(`missing protobuf bytes field ${field}`);
-    }
-    if (value instanceof Uint8Array) {
-        return value;
-    }
-    return decodeBase64(value);
-}

package/dist/esm/util/signal-address.js

@@ -1,5 +0,0 @@
-import { WA_DEFAULTS } from '../protocol/constants.js';
-export function signalAddressKey(address) {
-    const server = address.server ?? WA_DEFAULTS.HOST_DOMAIN;
-    return `${address.user}|${server}|${address.device}`;
-}

package/dist/types/crypto/core/encoding.d.ts

@@ -1,11 +0,0 @@
-/**
- * Base64 URL encoding utilities
- */
-/**
- * Decodes a base64url encoded string to Uint8Array
- */
-export declare function decodeBase64Url(value: string | undefined, field: string): Uint8Array;
-/**
- * Asserts that a Uint8Array is exactly 32 bytes
- */
-export declare function assert32(value: Uint8Array, name: string): void;

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

@@ -1,4 +0,0 @@
-import { bytesToBase64, bytesToBase64UrlSafe } from './bytes';
-export { bytesToBase64, bytesToBase64UrlSafe };
-export declare function base64ToBytes(value: string, field: string, requireNonEmpty?: boolean): Uint8Array;
-export declare function decodeProtoBytes(value: Uint8Array | string | null | undefined, field: string): Uint8Array;

package/dist/types/util/signal-address.d.ts

@@ -1,2 +0,0 @@
-import type { SignalAddress } from '../signal/types';
-export declare function signalAddressKey(address: SignalAddress): string;

package/dist/util/base64.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.bytesToBase64UrlSafe = exports.bytesToBase64 = void 0;
-exports.base64ToBytes = base64ToBytes;
-exports.decodeProtoBytes = decodeProtoBytes;
-const bytes_1 = require("./bytes");
-Object.defineProperty(exports, "bytesToBase64", { enumerable: true, get: function () { return bytes_1.bytesToBase64; } });
-Object.defineProperty(exports, "bytesToBase64UrlSafe", { enumerable: true, get: function () { return bytes_1.bytesToBase64UrlSafe; } });
-function base64ToBytes(value, field, requireNonEmpty = true) {
-    const out = (0, bytes_1.base64ToBytes)(value);
-    if (requireNonEmpty && out.length === 0) {
-        throw new Error(`invalid base64 payload for ${field}`);
-    }
-    return out;
-}
-function decodeProtoBytes(value, field) {
-    if (value === null || value === undefined) {
-        throw new Error(`missing protobuf bytes field ${field}`);
-    }
-    if (value instanceof Uint8Array) {
-        return value;
-    }
-    return (0, bytes_1.base64ToBytes)(value);
-}

package/dist/util/signal-address.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.signalAddressKey = signalAddressKey;
-const constants_1 = require("../protocol/constants");
-function signalAddressKey(address) {
-    const server = address.server ?? constants_1.WA_DEFAULTS.HOST_DOMAIN;
-    return `${address.user}|${server}|${address.device}`;
-}