@oxidezap/whatsapp-rust-bridge 0.6.0

package/dist/wire-info.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Packed wire-batch codecs (message metadata, receipts, server acks).
+ *
+ * The bridge crosses hot per-event metadata as fixed-width numeric records
+ * plus a per-batch deduplicated string table: repeated addresses, push names
+ * and ack classes pay one decode per batch instead of one FFI object build
+ * per event. This module is the single host-side owner of every record
+ * layout; the Rust writers live in `src/wasm_client.rs`.
+ */
+/** Serde shape of the core's `Jid` as carried by bridge events. */
+export interface WireJid {
+    user: string;
+    server: string;
+    agent: number;
+    device: number;
+    integrator: number;
+}
+/** Decoded per-message metadata envelope. */
+export interface MessageWireInfo {
+    /** Canonical device-independent chat address. */
+    chat: string;
+    /** Canonical device-independent author address. */
+    sender: string;
+    senderAlt?: string;
+    recipientAlt?: string;
+    isFromMe: boolean;
+    isGroup: boolean;
+    id: string;
+    /** Unix timestamp in seconds. */
+    timestamp: number;
+    pushName: string;
+    isViewOnce: boolean;
+    isOffline: boolean;
+    unavailableRequestId?: string;
+    /** Raw protocol edit attribute; absent when the attribute was empty. */
+    edit?: string;
+}
+export declare const MESSAGE_WIRE_INFO_RECORD_WIDTH = 10;
+/** Decoded message batch: payload slices plus one envelope per message. */
+export interface MessageWireBatchView {
+    /** Concatenated `proto.Message` payloads, in event order. */
+    messageData: Uint8Array;
+    /** N + 1 byte offsets delimiting the N payloads in `messageData`. */
+    messageOffsets: Uint32Array;
+    /** One decoded envelope per message, parallel to the payload offsets. */
+    infos: MessageWireInfo[];
+}
+/** Decode a packed message batch into payload slices and metadata envelopes. */
+export declare function decodeMessageWireBatch(batch: PackedWireBatch): MessageWireBatchView;
+/** One message as a caller supplies it to `encodeMessageWireBatch`. */
+export interface MessageWireEntry {
+    /** Encoded `proto.Message` payload. */
+    payload: Uint8Array;
+    info: MessageWireInfo;
+}
+/**
+ * Inverse of `decodeMessageWireBatch`, for hosts that need to fabricate batches
+ * (tests, replay tooling). Mirrors the Rust writer byte for byte.
+ */
+export declare function encodeMessageWireBatch(entries: readonly MessageWireEntry[]): PackedWireBatch;
+/**
+ * A packed batch IS its buffer: one flat run of header, cache definitions,
+ * fixed-width records and string bytes. See the Rust writers in
+ * `src/wire_batch.rs`.
+ *
+ * Crossing the bare typed array rather than a `{ buffer }` object saves an
+ * object construction and a property write per batch, and a single message
+ * produces three batches (its own, its receipt, its ack).
+ */
+export type PackedWireBatch = Uint8Array;
+/** Serde shape of the core's `Receipt` payload, as the single-event path emits it. */
+export interface ReceiptWireData {
+    source: {
+        chat: WireJid;
+        sender: WireJid;
+        is_from_me: boolean;
+        is_group: boolean;
+        addressing_mode?: string;
+        sender_alt?: WireJid;
+        recipient_alt?: WireJid;
+        broadcast_list_owner?: WireJid;
+        recipient?: WireJid;
+    };
+    message_ids: string[];
+    /** Unix timestamp in seconds. */
+    timestamp: number;
+    /** Variant name, or `{ Other: value }` for unrecognized wire values. */
+    type: string | {
+        Other: string;
+    };
+    offline: boolean;
+}
+/** Serde shape of the core's `ServerAck` payload. */
+export interface ServerAckWireData {
+    id: string;
+    class?: string;
+    from?: WireJid;
+    /** Unix timestamp in seconds. */
+    timestamp?: number;
+    error?: string;
+}
+export declare function decodeReceiptWireBatch(batch: PackedWireBatch): ReceiptWireData[];
+export declare function decodeServerAckWireBatch(batch: PackedWireBatch): ServerAckWireData[];
+/** Inverse of `decodeReceiptWireBatch`, for tests and replay tooling. */
+export declare function encodeReceiptWireBatch(receipts: readonly ReceiptWireData[]): PackedWireBatch;
+/** Inverse of `decodeServerAckWireBatch`, for tests and replay tooling. */
+export declare function encodeServerAckWireBatch(acks: readonly ServerAckWireData[]): PackedWireBatch;

package/package.json

@@ -0,0 +1,59 @@
+{
+    "name": "@oxidezap/whatsapp-rust-bridge",
+    "version": "0.6.0",
+    "description": "A high-performance utilities for WhatsApp, powered by Rust and WebAssembly.",
+    "author": "João Lucas <jlucaso@hotmail.com>",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/oxidezap/whatsapp-rust-bridge.git"
+    },
+    "type": "module",
+    "publishConfig": {
+        "access": "public"
+    },
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "files": [
+        "dist/**/*"
+    ],
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        },
+        "./proto-types": {
+            "import": "./dist/proto-types.js",
+            "types": "./dist/proto-types.d.ts"
+        }
+    },
+    "scripts": {
+        "bench": "bun run build && bun run benches/binary.ts && bun run benches/signal.ts && bun run benches/curve.ts && bun run benches/crypto.ts",
+        "bench:node": "bun run build && node --expose-gc benches/binary.ts && node --expose-gc benches/signal.ts && node --expose-gc benches/curve.ts && node --expose-gc benches/crypto.ts",
+        "gen:bridge-types": "cd codegen && cargo run -q --bin gen-types --target $(rustc -vV | grep host | cut -d' ' -f2) > ../src/generated_types.rs.tmp && mv ../src/generated_types.rs.tmp ../src/generated_types.rs",
+        "gen:proto-codec": "bun run scripts/gen-ts-proto.ts",
+        "gen:proto-types": "bun run scripts/gen-protobufjs-dts.ts",
+        "gen": "bun run gen:bridge-types && bun run gen:proto-codec && bun run gen:proto-types",
+        "build:wasm": "wasm-pack build --target web --out-dir pkg --no-pack",
+        "build:wasm:dev": "wasm-pack build --target web --out-dir pkg --no-pack --dev",
+        "build:ts": "bun build ts/index.ts --minify --outfile dist/index.js --target node && cp pkg/whatsapp_rust_bridge_bg.wasm dist/ && cp ts/proto-types.d.ts dist/proto-types.d.ts && cp ts/proto-types.d.ts pkg/proto-types.d.ts && printf 'export { proto } from \"./index.js\";\\n' > dist/proto-types.js",
+        "postbuild": "tsc -p tsconfig.json --outDir dist && rm -f dist/macro.d.ts && rm -rf dist/generated && bun run scripts/finalize-dist.ts",
+        "build": "bun run gen && bun run build:wasm && bun run build:ts && bun run postbuild",
+        "build:dev": "bun run gen && bun run build:wasm:dev && bun run build:ts && bun run postbuild",
+        "build:profile": "cargo build --profile profiling --target wasm32-unknown-unknown && wasm-bindgen --target web --out-dir pkg --keep-debug target/wasm32-unknown-unknown/profiling/whatsapp_rust_bridge.wasm && wasm-tools strip pkg/whatsapp_rust_bridge_bg.wasm -o pkg/whatsapp_rust_bridge_bg.wasm && bun run build:ts && bun run postbuild",
+        "build:memory-profile": "cargo build --profile profiling --target wasm32-unknown-unknown --features memory-profiling && wasm-bindgen --target web --out-dir pkg --keep-debug target/wasm32-unknown-unknown/profiling/whatsapp_rust_bridge.wasm && wasm-tools strip pkg/whatsapp_rust_bridge_bg.wasm -o pkg/whatsapp_rust_bridge_bg.wasm && bun run build:ts && bun run postbuild",
+        "bump:wacore": "cargo update -p whatsapp-rust && bun run build",
+        "example": "NODE_TLS_REJECT_UNAUTHORIZED=0 bun run examples/connect.ts",
+        "test:rust": "wasm-pack test --node",
+        "prepack": "bun run scripts/check-pack.ts",
+        "prepublishOnly": "bun run build"
+    },
+    "devDependencies": {
+        "@bufbuild/protobuf": "^2.12.0",
+        "@types/bun": "^1.3.13",
+        "@types/node": "^25.6.0",
+        "ts-proto": "^2.11.6",
+        "typescript": "^6.0.3"
+    },
+    "private": false
+}