@qadeer-xtech/whatsapp-rust-bridge 0.0.0-stage → 1.0.1

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "@qadeer-xtech/whatsapp-rust-bridge",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "description": "A high-performance utilities for WhatsApp, powered by Rust and WebAssembly.",
+  "author": "Qadeer-Xtech",
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "dist/index.js",
+    "dist/index.d.ts",
+    "pkg/whatsapp_rust_bridge.d.ts"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.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",
+    "build:wasm": "node scripts/build-wasm.mjs",
+    "build:ts": "bun build ts/index.ts --outfile dist/index.js",
+    "prebuild": "rm -rf dist",
+    "postbuild": "tsc -p tsconfig.json --outDir dist",
+    "build": "bun run prebuild && bun run build:wasm && bun run build:ts && bun run postbuild"
+  },
+  "devDependencies": {
+    "@mitata/counters": "^0.0.8",
+    "@types/bun": "^1.3.2",
+    "@types/node": "^24.10.1",
+    "@whiskeysockets/libsignal-node": "git+https://github.com/whiskeysockets/libsignal-node",
+    "audio-decode": "^2.1.3",
+    "baileys": "^7.0.0-rc.9",
+    "mitata": "^1.0.34",
+    "sharp": "^0.34.5",
+    "typescript": "^5.9.3"
+  },
+  "private": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Qadeer-Xtech/whatsapp-rust-bridge.git"
+  },
+  "homepage": "https://github.com/Qadeer-Xtech/whatsapp-rust-bridge#readme",
+  "bugs": {
+    "url": "https://github.com/Qadeer-Xtech/whatsapp-rust-bridge/issues"
+  }
+}

package/pkg/whatsapp_rust_bridge.d.ts

@@ -0,0 +1,446 @@
+/* tslint:disable */
+/* eslint-disable */
+
+export interface BinaryNode {
+    tag: string;
+    attrs: { [key: string]: string };
+    content?: BinaryNode[] | string | Uint8Array;
+}
+
+
+
+export interface ILogger {
+    level: string;
+    trace(obj: object, msg?: string): void;
+    debug(obj: object, msg?: string): void;
+    info(obj: object, msg?: string): void;
+    warn(obj: object, msg?: string): void;
+    error(obj: object, msg?: string): void;
+}
+
+
+
+export interface SignalStorage {
+    loadSession(address: string): Uint8Array | null | undefined | Promise<Uint8Array | null | undefined>;
+    storeSession(address: string, record: SessionRecord): void | Promise<void>;
+    getOurIdentity(): KeyPair | Promise<KeyPair>;
+    getOurRegistrationId(): number | Promise<number>;
+    isTrustedIdentity(name: string, identityKey: Uint8Array, direction: number): boolean | Promise<boolean>;
+    loadPreKey(id: number): KeyPair | null | undefined | Promise<KeyPair | null | undefined>;
+    removePreKey(id: number): void | Promise<void>;
+    loadSignedPreKey(id: number): SignedPreKey | null | undefined | Promise<SignedPreKey | null | undefined>;
+    loadSenderKey(keyId: string): Uint8Array | null | undefined | Promise<Uint8Array | null | undefined>;
+    storeSenderKey(keyId: string, record: Uint8Array): void | Promise<void>;
+}
+
+
+/**
+ * A cryptographic key pair containing public and private keys
+ */
+export interface KeyPair {
+    pubKey: Uint8Array;
+    privKey: Uint8Array;
+}
+
+/**
+ * Enabled features in this build.
+ * Use this to check feature availability at runtime before calling feature-gated functions.
+ */
+export interface EnabledFeatures {
+    /**
+     * Audio processing support (waveform generation, duration detection)
+     */
+    audio: boolean;
+    /**
+     * Image processing support (thumbnails, profile pictures, format conversion)
+     */
+    image: boolean;
+    /**
+     * Sticker metadata support (WebP EXIF for WhatsApp stickers)
+     */
+    sticker: boolean;
+}
+
+export interface HkdfInfo {
+    salt?: Uint8Array | undefined;
+    info?: string | undefined;
+}
+
+export interface PreKey {
+    keyId: number;
+    keyPair: KeyPair;
+}
+
+export interface PreKeyBundleInput {
+    registrationId: number;
+    identityKey: Uint8Array;
+    preKey?: PreKeyPublicKey | undefined;
+    signedPreKey: SignedPreKeyPublicKey;
+}
+
+export interface PreKeyPublicKey {
+    keyId: number;
+    publicKey: Uint8Array;
+}
+
+export interface SignedPreKey {
+    keyId: number;
+    keyPair: KeyPair;
+    signature: Uint8Array;
+}
+
+export interface SignedPreKeyPublicKey {
+    keyId: number;
+    publicKey: Uint8Array;
+    signature: Uint8Array;
+}
+
+
+export class ExpandedAppStateKeys {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    readonly indexKey: Uint8Array;
+    readonly patchMacKey: Uint8Array;
+    readonly snapshotMacKey: Uint8Array;
+    readonly valueEncryptionKey: Uint8Array;
+    readonly valueMacKey: Uint8Array;
+}
+
+export class GroupCipher {
+    free(): void;
+    [Symbol.dispose](): void;
+    decrypt(ciphertext: Uint8Array): Promise<Uint8Array>;
+    encrypt(plaintext: Uint8Array): Promise<Uint8Array>;
+    constructor(storage: SignalStorage, group_id: string, sender: ProtocolAddress);
+}
+
+export class GroupSessionBuilder {
+    free(): void;
+    [Symbol.dispose](): void;
+    create(sender_key_name: SenderKeyName): Promise<SenderKeyDistributionMessage>;
+    constructor(storage: SignalStorage);
+    process(sender_key_name: SenderKeyName, skdm: SenderKeyDistributionMessage): Promise<void>;
+}
+
+export class InternalBinaryNode {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    toJSON(): any;
+    attrs: { [key: string]: string };
+    get content(): BinaryNode[] | string | Uint8Array | undefined;
+    set content(value: BinaryNode[] | string | Uint8Array);
+    readonly tag: string;
+}
+
+export class LTHashAntiTampering {
+    free(): void;
+    [Symbol.dispose](): void;
+    constructor();
+    subtractThenAdd(base: Uint8Array, subtract: Uint8Array[], add: Uint8Array[]): Uint8Array;
+}
+
+export class LTHashState {
+    free(): void;
+    [Symbol.dispose](): void;
+    clone(): LTHashState;
+    deleteValueMac(index_mac_base64: string): boolean;
+    getValueMac(index_mac_base64: string): Uint8Array | undefined;
+    hasValueMac(index_mac_base64: string): boolean;
+    constructor();
+    setValueMac(index_mac_base64: string, value_mac: Uint8Array): void;
+    hash: Uint8Array;
+    version: bigint;
+}
+
+/**
+ * NoiseSession implements the Noise_XX_25519_AESGCM_SHA256 protocol pattern
+ * with combined binary encoding/decoding operations for reduced WASM boundary crossings.
+ */
+export class NoiseSession {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Updates the session hash with the given data (no-op after handshake).
+     */
+    authenticate(data: Uint8Array): void;
+    clearBuffer(): void;
+    decodeFrame(new_data: Uint8Array): Array<any>;
+    decrypt(ciphertext: Uint8Array): Uint8Array;
+    encodeFrame(node: EncodingNode): Uint8Array;
+    encodeFrameRaw(data: Uint8Array): Uint8Array;
+    encrypt(plaintext: Uint8Array): Uint8Array;
+    finishInit(): void;
+    getHash(): Uint8Array;
+    mixIntoKey(data: Uint8Array): void;
+    constructor(public_key: Uint8Array, noise_header: Uint8Array, routing_info?: Uint8Array | null);
+    processHandshakeFinish(noise_public_key: Uint8Array, noise_private_key: Uint8Array, server_ephemeral: Uint8Array): Uint8Array;
+    processHandshakeInit(server_ephemeral: Uint8Array, server_static_encrypted: Uint8Array, server_payload_encrypted: Uint8Array, private_key: Uint8Array): Uint8Array;
+    readonly bufferedBytes: number;
+    readonly isFinished: boolean;
+}
+
+export class ProtocolAddress {
+    free(): void;
+    [Symbol.dispose](): void;
+    static from(encoded: string): ProtocolAddress;
+    is(other: ProtocolAddress): boolean;
+    constructor(id: string, device_id: number);
+    toString(): string;
+    readonly deviceId: number;
+    readonly id: string;
+}
+
+export class SenderKeyDistributionMessage {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    static deserialize(serialized: Uint8Array): SenderKeyDistributionMessage;
+    serialize(): Uint8Array;
+}
+
+export class SenderKeyName {
+    free(): void;
+    [Symbol.dispose](): void;
+    constructor(group_id: string, sender: ProtocolAddress);
+    toString(): string;
+}
+
+export class SenderKeyRecord {
+    free(): void;
+    [Symbol.dispose](): void;
+    static deserialize(serialized: Uint8Array): SenderKeyRecord;
+    isEmpty(): boolean;
+    constructor();
+    serialize(): Uint8Array;
+}
+
+export class SessionBuilder {
+    free(): void;
+    [Symbol.dispose](): void;
+    initOutgoing(bundle_input: PreKeyBundleInput): Promise<void>;
+    constructor(storage: SignalStorage, remote_address: ProtocolAddress);
+    processPreKeyBundle(bundle_input: PreKeyBundleInput): Promise<void>;
+}
+
+export class SessionCipher {
+    free(): void;
+    [Symbol.dispose](): void;
+    decryptPreKeyWhisperMessage(ciphertext: Uint8Array): Promise<Uint8Array>;
+    decryptWhisperMessage(ciphertext: Uint8Array): Promise<Uint8Array>;
+    encrypt(plaintext: Uint8Array): Promise<{ type: number; body: Uint8Array }>;
+    hasOpenSession(): Promise<boolean>;
+    constructor(storage: SignalStorage, remote_address: ProtocolAddress);
+}
+
+export class SessionRecord {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    static deserialize(val: any): SessionRecord;
+    haveOpenSession(): boolean;
+    serialize(): Uint8Array;
+}
+
+export function _serializeIdentityKeyPair(key_pair: KeyPair): Uint8Array;
+
+export function calculateAgreement(public_key_bytes: Uint8Array, private_key_bytes: Uint8Array): Uint8Array;
+
+export function calculateSignature(private_key_bytes: Uint8Array, message: Uint8Array): Uint8Array;
+
+export function decodeNode(data: Uint8Array): InternalBinaryNode;
+
+export function encodeNode(node_val: EncodingNode): Uint8Array;
+
+export function expandAppStateKeys(key_data: Uint8Array): ExpandedAppStateKeys;
+
+export function generateContentMac(operation: number, data: Uint8Array, key_id: Uint8Array, key: Uint8Array): Uint8Array;
+
+export function generateIdentityKeyPair(): KeyPair;
+
+export function generateIndexMac(index_bytes: Uint8Array, key: Uint8Array): Uint8Array;
+
+export function generateKeyPair(): KeyPair;
+
+export function generatePatchMac(snapshot_mac: Uint8Array, value_macs: Uint8Array[], version: bigint, name: string, key: Uint8Array): Uint8Array;
+
+export function generatePreKey(key_id: number): PreKey;
+
+export function generateRegistrationId(): number;
+
+export function generateSignedPreKey(identity_key_pair: KeyPair, signed_key_id: number): SignedPreKey;
+
+export function generateSnapshotMac(lt_hash: Uint8Array, version: bigint, name: string, key: Uint8Array): Uint8Array;
+
+/**
+ * Returns which optional features are enabled in this build.
+ * Use this to conditionally call feature-gated functions.
+ */
+export function getEnabledFeatures(): EnabledFeatures;
+
+export function getPublicFromPrivateKey(private_key_bytes: Uint8Array): Uint8Array;
+
+/**
+ * Returns the WhatsApp connection header (WA_CONN_HEADER).
+ * This is the 4-byte header sent at the start of a WebSocket connection.
+ */
+export function getWAConnHeader(): Uint8Array;
+
+export function hasLogger(): boolean;
+
+export function hkdf(buffer: Uint8Array, expanded_length: number, info: HkdfInfo): Uint8Array;
+
+export function logMessage(level: string, message: string): void;
+
+export function md5(buffer: Uint8Array): Uint8Array;
+
+export function setLogger(logger: ILogger): void;
+
+export function updateLogger(logger: ILogger): void;
+
+export function verifySignature(public_key_bytes: Uint8Array, message: Uint8Array, signature: Uint8Array): boolean;
+
+export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
+
+export interface InitOutput {
+    readonly memory: WebAssembly.Memory;
+    readonly __wbg_expandedappstatekeys_free: (a: number, b: number) => void;
+    readonly __wbg_groupcipher_free: (a: number, b: number) => void;
+    readonly __wbg_groupsessionbuilder_free: (a: number, b: number) => void;
+    readonly __wbg_internalbinarynode_free: (a: number, b: number) => void;
+    readonly __wbg_lthashantitampering_free: (a: number, b: number) => void;
+    readonly __wbg_lthashstate_free: (a: number, b: number) => void;
+    readonly __wbg_noisesession_free: (a: number, b: number) => void;
+    readonly __wbg_protocoladdress_free: (a: number, b: number) => void;
+    readonly __wbg_senderkeydistributionmessage_free: (a: number, b: number) => void;
+    readonly __wbg_senderkeyname_free: (a: number, b: number) => void;
+    readonly __wbg_senderkeyrecord_free: (a: number, b: number) => void;
+    readonly __wbg_sessionbuilder_free: (a: number, b: number) => void;
+    readonly __wbg_sessionrecord_free: (a: number, b: number) => void;
+    readonly _serializeIdentityKeyPair: (a: number) => number;
+    readonly calculateAgreement: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly calculateSignature: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly decodeNode: (a: number, b: number, c: number) => void;
+    readonly encodeNode: (a: number, b: number) => void;
+    readonly expandAppStateKeys: (a: number, b: number) => number;
+    readonly expandedappstatekeys_indexKey: (a: number) => number;
+    readonly expandedappstatekeys_patchMacKey: (a: number) => number;
+    readonly expandedappstatekeys_snapshotMacKey: (a: number) => number;
+    readonly expandedappstatekeys_valueEncryptionKey: (a: number) => number;
+    readonly expandedappstatekeys_valueMacKey: (a: number) => number;
+    readonly generateContentMac: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+    readonly generateIdentityKeyPair: () => number;
+    readonly generateIndexMac: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly generatePatchMac: (a: number, b: number, c: number, d: number, e: number, f: bigint, g: number, h: number, i: number, j: number) => void;
+    readonly generatePreKey: (a: number) => number;
+    readonly generateRegistrationId: () => number;
+    readonly generateSignedPreKey: (a: number, b: number, c: number) => void;
+    readonly generateSnapshotMac: (a: number, b: number, c: number, d: bigint, e: number, f: number, g: number, h: number) => void;
+    readonly getEnabledFeatures: () => number;
+    readonly getPublicFromPrivateKey: (a: number, b: number, c: number) => void;
+    readonly getWAConnHeader: () => number;
+    readonly groupcipher_decrypt: (a: number, b: number, c: number) => number;
+    readonly groupcipher_encrypt: (a: number, b: number, c: number) => number;
+    readonly groupcipher_new: (a: number, b: number, c: number, d: number) => number;
+    readonly groupsessionbuilder_create: (a: number, b: number) => number;
+    readonly groupsessionbuilder_new: (a: number) => number;
+    readonly groupsessionbuilder_process: (a: number, b: number, c: number) => number;
+    readonly hasLogger: () => number;
+    readonly hkdf: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly internalbinarynode_attrs: (a: number) => number;
+    readonly internalbinarynode_content: (a: number) => number;
+    readonly internalbinarynode_set_attrs: (a: number, b: number) => void;
+    readonly internalbinarynode_set_content: (a: number, b: number) => void;
+    readonly internalbinarynode_tag: (a: number, b: number) => void;
+    readonly internalbinarynode_toJSON: (a: number) => number;
+    readonly logMessage: (a: number, b: number, c: number, d: number) => void;
+    readonly lthashantitampering_new: () => number;
+    readonly lthashantitampering_subtractThenAdd: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+    readonly lthashstate_clone: (a: number) => number;
+    readonly lthashstate_deleteValueMac: (a: number, b: number, c: number) => number;
+    readonly lthashstate_getValueMac: (a: number, b: number, c: number) => number;
+    readonly lthashstate_hasValueMac: (a: number, b: number, c: number) => number;
+    readonly lthashstate_hash: (a: number) => number;
+    readonly lthashstate_new: () => number;
+    readonly lthashstate_setValueMac: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly lthashstate_set_hash: (a: number, b: number, c: number) => void;
+    readonly lthashstate_set_version: (a: number, b: bigint) => void;
+    readonly lthashstate_version: (a: number) => bigint;
+    readonly md5: (a: number, b: number) => number;
+    readonly noisesession_authenticate: (a: number, b: number, c: number) => void;
+    readonly noisesession_bufferedBytes: (a: number) => number;
+    readonly noisesession_clearBuffer: (a: number) => void;
+    readonly noisesession_decodeFrame: (a: number, b: number, c: number, d: number) => void;
+    readonly noisesession_decrypt: (a: number, b: number, c: number, d: number) => void;
+    readonly noisesession_encodeFrame: (a: number, b: number, c: number) => void;
+    readonly noisesession_encodeFrameRaw: (a: number, b: number, c: number, d: number) => void;
+    readonly noisesession_encrypt: (a: number, b: number, c: number, d: number) => void;
+    readonly noisesession_finishInit: (a: number, b: number) => void;
+    readonly noisesession_getHash: (a: number) => number;
+    readonly noisesession_isFinished: (a: number) => number;
+    readonly noisesession_mixIntoKey: (a: number, b: number, c: number, d: number) => void;
+    readonly noisesession_new: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+    readonly noisesession_processHandshakeFinish: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+    readonly noisesession_processHandshakeInit: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
+    readonly protocoladdress_deviceId: (a: number) => number;
+    readonly protocoladdress_from: (a: number, b: number) => void;
+    readonly protocoladdress_id: (a: number, b: number) => void;
+    readonly protocoladdress_is: (a: number, b: number) => number;
+    readonly protocoladdress_new: (a: number, b: number, c: number) => void;
+    readonly protocoladdress_toString: (a: number, b: number) => void;
+    readonly senderkeydistributionmessage_deserialize: (a: number, b: number, c: number) => void;
+    readonly senderkeydistributionmessage_serialize: (a: number) => number;
+    readonly senderkeyname_new: (a: number, b: number, c: number) => number;
+    readonly senderkeyname_toString: (a: number, b: number) => void;
+    readonly senderkeyrecord_deserialize: (a: number, b: number, c: number) => void;
+    readonly senderkeyrecord_isEmpty: (a: number) => number;
+    readonly senderkeyrecord_new: () => number;
+    readonly senderkeyrecord_serialize: (a: number, b: number) => void;
+    readonly sessionbuilder_initOutgoing: (a: number, b: number) => number;
+    readonly sessionbuilder_new: (a: number, b: number) => number;
+    readonly sessionbuilder_processPreKeyBundle: (a: number, b: number) => number;
+    readonly sessioncipher_decryptPreKeyWhisperMessage: (a: number, b: number, c: number) => number;
+    readonly sessioncipher_decryptWhisperMessage: (a: number, b: number, c: number) => number;
+    readonly sessioncipher_encrypt: (a: number, b: number, c: number) => number;
+    readonly sessioncipher_hasOpenSession: (a: number) => number;
+    readonly sessionrecord_deserialize: (a: number, b: number) => void;
+    readonly sessionrecord_haveOpenSession: (a: number) => number;
+    readonly sessionrecord_serialize: (a: number) => number;
+    readonly setLogger: (a: number, b: number) => void;
+    readonly verifySignature: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+    readonly sessioncipher_new: (a: number, b: number) => number;
+    readonly generateKeyPair: () => number;
+    readonly updateLogger: (a: number) => void;
+    readonly __wbg_sessioncipher_free: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_694: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_699: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_1248: (a: number, b: number, c: number, d: number) => void;
+    readonly __wbindgen_export: (a: number, b: number) => number;
+    readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
+    readonly __wbindgen_export3: (a: number) => void;
+    readonly __wbindgen_add_to_stack_pointer: (a: number) => number;
+    readonly __wbindgen_export4: (a: number, b: number, c: number) => void;
+}
+
+export type SyncInitInput = BufferSource | WebAssembly.Module;
+
+/**
+ * Instantiates the given `module`, which can either be bytes or
+ * a precompiled `WebAssembly.Module`.
+ *
+ * @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
+ *
+ * @returns {InitOutput}
+ */
+export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
+
+/**
+ * If `module_or_path` is {RequestInfo} or {URL}, makes a request and
+ * for everything else, calls `WebAssembly.instantiate` directly.
+ *
+ * @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
+ *
+ * @returns {Promise<InitOutput>}
+ */
+export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;