zapo-js 0.1.1 → 0.2.0

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,48 @@ 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) {
+    if (value.length !== expectedLength) {
+        throw new Error(errorMessage);
     }
-    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 base64ToBytes(value);
 }
 function lookupBase64(code) {
     if (code > 127) {
@@ -185,39 +210,35 @@ 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;
 }
 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}`);
 }
@@ -238,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;
@@ -281,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/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/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

@@ -3,35 +3,63 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.toError = toError;
 exports.toSafeNumber = toSafeNumber;
 exports.longToNumber = longToNumber;
+exports.normalizeNonNegativeInteger = normalizeNonNegativeInteger;
+exports.parseOptionalInt = parseOptionalInt;
+const DIGITS_ONLY_RE = /^\d+$/;
 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 (!DIGITS_ONLY_RE.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,12 @@
 {
     "name": "zapo-js",
-    "version": "0.1.1",
+    "version": "0.2.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",
@@ -66,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",
@@ -80,6 +103,9 @@
         "proto/index.d.ts",
         "scripts/check-node-version.cjs"
     ],
+    "workspaces": [
+        "packages/*"
+    ],
     "engines": {
         "node": ">=20.9.0"
     },
@@ -88,36 +114,46 @@
         "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",
+        "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: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",
-        "lint": "eslint \"src/**/*.{ts,js}\"",
-        "lint:fix": "eslint \"src/**/*.{ts,js}\" --fix",
+        "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",
         "pino": "^9.0.0",
-        "pino-pretty": "^13.0.0"
+        "pino-pretty": "^13.0.0",
+        "ws": "^8.18.3"
     },
     "peerDependenciesMeta": {
-        "better-sqlite3": {
+        "got": {
             "optional": true
         },
         "pino": {
@@ -125,23 +161,30 @@
         },
         "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",
+        "turbo": "^2.8.20",
         "typescript": "^5.7.3",
-        "typescript-eslint": "^8.56.1"
+        "typescript-eslint": "^8.56.1",
+        "ws": "^8.18.3"
     }
 }