@oxidezap/whatsapp-rust-bridge 0.21.4 → 0.22.0

package/dist/whatsapp_rust_bridge.d.ts

@@ -1950,6 +1950,40 @@ export interface JsStoreCallbacks {
  */
 export function initWasmEngine(logger?: any, crypto?: JsCryptoCallbacks): void;
 
+/**
+ * The intentionally small metadata view exposed to admission policies.
+ * Fields absent in the core are omitted. It does not include the notification's
+ * keys or media paths.
+ */
+export interface HistorySyncAdmissionMetadata {
+    syncType?: number;
+    chunkOrder?: number;
+    progress?: number;
+    /**
+     * Sender-declared file length. The core does not validate this value.
+     * A decimal string preserves the full uint64 range. Use BigInt(fileLength)
+     * for numeric comparisons.
+     */
+    fileLength?: string;
+    /** Number of bytes present in the inline payload. */
+    inlinePayloadLen?: number;
+    peerDataRequestSessionId?: string;
+}
+
+export interface ClientPolicies {
+    /**
+     * Synchronously decide whether to accept a history-sync chunk.
+     * Only the boolean true accepts. False permanently acknowledges the chunk
+     * and prevents retry. Thrown errors and non-boolean results do the same,
+     * including Promise results. Do not use this for transient load shedding.
+     * The callback runs with this policies object as its receiver.
+     * The function is captured at client construction. Mutable state it reads
+     * may still change, but replacing the property does not replace the policy.
+     * Omitting the callback leaves the core's default admission policy in place.
+     */
+    historySyncAdmission?(metadata: HistorySyncAdmissionMetadata): boolean;
+}
+
 /**
  * Create a full WhatsApp client running in WASM.
  *
@@ -1967,6 +2001,7 @@ export function initWasmEngine(logger?: any, crypto?: JsCryptoCallbacks): void;
  *   rooted in WhatsApp's issuer. Absent, null or false keeps strict
  *   verification; only an explicit `true` opts in. Anything else rejects the
  *   construction as invalid-argument.
+ * @param policies Optional ninth argument. See ClientPolicies; existing calls may omit it.
  */
 export function createWhatsAppClient(
 transport_config: JsTransportCallbacks,
@@ -1977,6 +2012,7 @@ cache_config?: CacheConfig | null,
 version?: readonly [number, number, number] | null,
 wanted_pre_key_count?: number | null,
 danger_skip_cert_chain_verify?: boolean | null,
+policies?: ClientPolicies | null,
 ): Promise<WasmWhatsAppClient>;
 
 /** Cache entry configuration. */
@@ -4744,7 +4780,7 @@ export interface InitOutput {
     readonly beginWasmAllocationProfile: () => void;
     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 createWhatsAppClient: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => number;
+    readonly createWhatsAppClient: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => number;
     readonly decodeSenderKeyRecordComponents: (a: number, b: number, c: number) => void;
     readonly decodeSessionRecordComponents: (a: number, b: number, c: number) => void;
     readonly decryptEventResponsePayload: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number) => void;
@@ -4960,12 +4996,12 @@ export interface InitOutput {
     readonly intounderlyingsink_write: (a: number, b: number) => number;
     readonly intounderlyingsource_cancel: (a: number) => void;
     readonly intounderlyingsource_pull: (a: number, b: number) => number;
-    readonly __wasm_bindgen_func_elem_4656: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_28598: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_28600: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_9893: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_4655: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_4654: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_4659: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_28605: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_28607: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_9899: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_4658: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_4657: (a: number, b: 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;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@oxidezap/whatsapp-rust-bridge",
-    "version": "0.21.4",
+    "version": "0.22.0",
     "description": "A high-performance utilities for WhatsApp, powered by Rust and WebAssembly.",
     "author": "João Lucas <jlucaso@hotmail.com>",
     "license": "MIT",