jazz-wasm 2.0.0-alpha.13 → 2.0.0-alpha.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jazz-wasm",
-  "version": "2.0.0-alpha.13",
+  "version": "2.0.0-alpha.15",
   "description": "WebAssembly bindings for the Jazz database engine",
   "keywords": [
     "crdt",

package/pkg/jazz_wasm.d.ts

@@ -123,6 +123,11 @@ export class WasmRuntime {
      * before the call returns, rather than being deferred to a microtask.
      */
     addServer(): void;
+    /**
+     * Phase 1 of 2-phase subscribe: allocate a handle and store query params.
+     * No compilation, no sync, no tick — just bookkeeping.
+     */
+    createSubscription(query_json: string, session_json?: string | null, settled_tier?: string | null, options_json?: string | null): number;
     /**
      * Delete a row by ObjectId.
      */
@@ -131,6 +136,13 @@ export class WasmRuntime {
      * Delete a row and return a Promise that resolves when the tier acks.
      */
     deleteDurable(object_id: string, tier: string): Promise<any>;
+    /**
+     * Phase 2 of 2-phase subscribe: compile graph, register subscription,
+     * sync to servers, attach callback, and deliver the first delta.
+     *
+     * No-ops silently if the handle was already unsubscribed.
+     */
+    executeSubscription(handle: number, on_update: Function): void;
     /**
      * Flush all data to persistent storage (snapshot).
      */
@@ -151,9 +163,9 @@ export class WasmRuntime {
      * Insert a row into a table.
      *
      * # Returns
-     * The new row's ObjectId as a UUID string.
+     * The inserted row as `{ id, values }`.
      */
-    insert(table: string, values: any): string;
+    insert(table: string, values: any): any;
     /**
      * Insert a row and return a Promise that resolves when the tier acks.
      *
@@ -172,8 +184,10 @@ export class WasmRuntime {
      * * `user_branch` - User's branch name (e.g., "main")
      * * `tier` - Optional node durability tier ("worker", "edge", "global").
      *            Set for server nodes to enable ack emission.
+     * * `use_binary_encoding` - Optional outgoing sync payload encoding mode.
+     *   `Some(true)` emits postcard bytes (`Uint8Array`), otherwise JSON strings.
      */
-    constructor(schema_json: string, app_id: string, env: string, user_branch: string, tier?: string | null);
+    constructor(schema_json: string, app_id: string, env: string, user_branch: string, tier?: string | null, use_binary_encoding?: boolean | null);
     /**
      * Called by JS when a sync message arrives from the server.
      *
@@ -200,7 +214,7 @@ export class WasmRuntime {
      * Opens a single OPFS file namespace and restores state from the latest
      * durable checkpoint.
      */
-    static openPersistent(schema_json: string, app_id: string, env: string, user_branch: string, db_name: string, tier?: string | null): Promise<WasmRuntime>;
+    static openPersistent(schema_json: string, app_id: string, env: string, user_branch: string, db_name: string, tier: string | null | undefined, use_binary_encoding: boolean): Promise<WasmRuntime>;
     /**
      * Execute a query and return results as a Promise.
      *
@@ -244,6 +258,15 @@ export class WasmRuntime {
      * Update a row and return a Promise that resolves when the tier acks.
      */
     updateDurable(object_id: string, values: any, tier: string): Promise<any>;
+    /**
+     * Update a row by ObjectId as an explicit session principal.
+     *
+     * # Arguments
+     * * `object_id` - UUID string of target object
+     * * `values` - Partial update map (`{ columnName: Value }`)
+     * * `session_json` - Optional JSON-encoded Session used for policy checks
+     */
+    updateWithSession(object_id: string, values: any, session_json?: string | null): void;
 }
 
 export function bench_get_cache_bytes(): number;
@@ -353,19 +376,21 @@ export interface InitOutput {
     readonly wasmruntime___debugSeedLiveSchema: (a: number, b: number, c: number) => [number, number];
     readonly wasmruntime_addClient: (a: number) => [number, number];
     readonly wasmruntime_addServer: (a: number) => void;
+    readonly wasmruntime_createSubscription: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number];
     readonly wasmruntime_delete: (a: number, b: number, c: number) => [number, number];
     readonly wasmruntime_deleteDurable: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
+    readonly wasmruntime_executeSubscription: (a: number, b: number, c: any) => [number, number];
     readonly wasmruntime_flush: (a: number) => void;
     readonly wasmruntime_flushWal: (a: number) => void;
     readonly wasmruntime_getSchema: (a: number) => [number, number, number];
     readonly wasmruntime_getSchemaHash: (a: number) => [number, number];
-    readonly wasmruntime_insert: (a: number, b: number, c: number, d: any) => [number, number, number, number];
+    readonly wasmruntime_insert: (a: number, b: number, c: number, d: any) => [number, number, number];
     readonly wasmruntime_insertDurable: (a: number, b: number, c: number, d: any, e: number, f: number) => [number, number, number];
-    readonly wasmruntime_new: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number, number];
+    readonly wasmruntime_new: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => [number, number, number];
     readonly wasmruntime_onSyncMessageReceived: (a: number, b: any) => [number, number];
     readonly wasmruntime_onSyncMessageReceivedFromClient: (a: number, b: number, c: number, d: any) => [number, number];
     readonly wasmruntime_onSyncMessageToSend: (a: number, b: any) => void;
-    readonly wasmruntime_openPersistent: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number) => any;
+    readonly wasmruntime_openPersistent: (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) => any;
     readonly wasmruntime_query: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number];
     readonly wasmruntime_removeServer: (a: number) => void;
     readonly wasmruntime_setClientRole: (a: number, b: number, c: number, d: number, e: number) => [number, number];
@@ -373,6 +398,7 @@ export interface InitOutput {
     readonly wasmruntime_unsubscribe: (a: number, b: number) => void;
     readonly wasmruntime_update: (a: number, b: number, c: number, d: any) => [number, number];
     readonly wasmruntime_updateDurable: (a: number, b: number, c: number, d: any, e: number, f: number) => [number, number, number];
+    readonly wasmruntime_updateWithSession: (a: number, b: number, c: number, d: any, e: number, f: number) => [number, number];
     readonly bench_get_pin_internal_pages: () => number;
     readonly bench_opfs_cold_random_read: (a: number, b: number) => any;
     readonly bench_opfs_cold_sequential_read: (a: number, b: number) => any;

package/pkg/jazz_wasm.js

@@ -378,6 +378,30 @@ export class WasmRuntime {
     addServer() {
         wasm.wasmruntime_addServer(this.__wbg_ptr);
     }
+    /**
+     * Phase 1 of 2-phase subscribe: allocate a handle and store query params.
+     * No compilation, no sync, no tick — just bookkeeping.
+     * @param {string} query_json
+     * @param {string | null} [session_json]
+     * @param {string | null} [settled_tier]
+     * @param {string | null} [options_json]
+     * @returns {number}
+     */
+    createSubscription(query_json, session_json, settled_tier, options_json) {
+        const ptr0 = passStringToWasm0(query_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        var ptr1 = isLikeNone(session_json) ? 0 : passStringToWasm0(session_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        var len1 = WASM_VECTOR_LEN;
+        var ptr2 = isLikeNone(settled_tier) ? 0 : passStringToWasm0(settled_tier, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        var len2 = WASM_VECTOR_LEN;
+        var ptr3 = isLikeNone(options_json) ? 0 : passStringToWasm0(options_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        var len3 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmruntime_createSubscription(this.__wbg_ptr, ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0];
+    }
     /**
      * Delete a row by ObjectId.
      * @param {string} object_id
@@ -407,6 +431,20 @@ export class WasmRuntime {
         }
         return takeFromExternrefTable0(ret[0]);
     }
+    /**
+     * Phase 2 of 2-phase subscribe: compile graph, register subscription,
+     * sync to servers, attach callback, and deliver the first delta.
+     *
+     * No-ops silently if the handle was already unsubscribed.
+     * @param {number} handle
+     * @param {Function} on_update
+     */
+    executeSubscription(handle, on_update) {
+        const ret = wasm.wasmruntime_executeSubscription(this.__wbg_ptr, handle, on_update);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
     /**
      * Flush all data to persistent storage (snapshot).
      */
@@ -450,30 +488,19 @@ export class WasmRuntime {
      * Insert a row into a table.
      *
      * # Returns
-     * The new row's ObjectId as a UUID string.
+     * The inserted row as `{ id, values }`.
      * @param {string} table
      * @param {any} values
-     * @returns {string}
+     * @returns {any}
      */
     insert(table, values) {
-        let deferred3_0;
-        let deferred3_1;
-        try {
-            const ptr0 = passStringToWasm0(table, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
-            const len0 = WASM_VECTOR_LEN;
-            const ret = wasm.wasmruntime_insert(this.__wbg_ptr, ptr0, len0, values);
-            var ptr2 = ret[0];
-            var len2 = ret[1];
-            if (ret[3]) {
-                ptr2 = 0; len2 = 0;
-                throw takeFromExternrefTable0(ret[2]);
-            }
-            deferred3_0 = ptr2;
-            deferred3_1 = len2;
-            return getStringFromWasm0(ptr2, len2);
-        } finally {
-            wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+        const ptr0 = passStringToWasm0(table, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmruntime_insert(this.__wbg_ptr, ptr0, len0, values);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
         }
+        return takeFromExternrefTable0(ret[0]);
     }
     /**
      * Insert a row and return a Promise that resolves when the tier acks.
@@ -507,13 +534,16 @@ export class WasmRuntime {
      * * `user_branch` - User's branch name (e.g., "main")
      * * `tier` - Optional node durability tier ("worker", "edge", "global").
      *            Set for server nodes to enable ack emission.
+     * * `use_binary_encoding` - Optional outgoing sync payload encoding mode.
+     *   `Some(true)` emits postcard bytes (`Uint8Array`), otherwise JSON strings.
      * @param {string} schema_json
      * @param {string} app_id
      * @param {string} env
      * @param {string} user_branch
      * @param {string | null} [tier]
+     * @param {boolean | null} [use_binary_encoding]
      */
-    constructor(schema_json, app_id, env, user_branch, tier) {
+    constructor(schema_json, app_id, env, user_branch, tier, use_binary_encoding) {
         const ptr0 = passStringToWasm0(schema_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len0 = WASM_VECTOR_LEN;
         const ptr1 = passStringToWasm0(app_id, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -524,7 +554,7 @@ export class WasmRuntime {
         const len3 = WASM_VECTOR_LEN;
         var ptr4 = isLikeNone(tier) ? 0 : passStringToWasm0(tier, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         var len4 = WASM_VECTOR_LEN;
-        const ret = wasm.wasmruntime_new(ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3, ptr4, len4);
+        const ret = wasm.wasmruntime_new(ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3, ptr4, len4, isLikeNone(use_binary_encoding) ? 0xFFFFFF : use_binary_encoding ? 1 : 0);
         if (ret[2]) {
             throw takeFromExternrefTable0(ret[1]);
         }
@@ -580,10 +610,11 @@ export class WasmRuntime {
      * @param {string} env
      * @param {string} user_branch
      * @param {string} db_name
-     * @param {string | null} [tier]
+     * @param {string | null | undefined} tier
+     * @param {boolean} use_binary_encoding
      * @returns {Promise<WasmRuntime>}
      */
-    static openPersistent(schema_json, app_id, env, user_branch, db_name, tier) {
+    static openPersistent(schema_json, app_id, env, user_branch, db_name, tier, use_binary_encoding) {
         const ptr0 = passStringToWasm0(schema_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len0 = WASM_VECTOR_LEN;
         const ptr1 = passStringToWasm0(app_id, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -596,7 +627,7 @@ export class WasmRuntime {
         const len4 = WASM_VECTOR_LEN;
         var ptr5 = isLikeNone(tier) ? 0 : passStringToWasm0(tier, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         var len5 = WASM_VECTOR_LEN;
-        const ret = wasm.wasmruntime_openPersistent(ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3, ptr4, len4, ptr5, len5);
+        const ret = wasm.wasmruntime_openPersistent(ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3, ptr4, len4, ptr5, len5, use_binary_encoding);
         return ret;
     }
     /**
@@ -720,6 +751,27 @@ export class WasmRuntime {
         }
         return takeFromExternrefTable0(ret[0]);
     }
+    /**
+     * Update a row by ObjectId as an explicit session principal.
+     *
+     * # Arguments
+     * * `object_id` - UUID string of target object
+     * * `values` - Partial update map (`{ columnName: Value }`)
+     * * `session_json` - Optional JSON-encoded Session used for policy checks
+     * @param {string} object_id
+     * @param {any} values
+     * @param {string | null} [session_json]
+     */
+    updateWithSession(object_id, values, session_json) {
+        const ptr0 = passStringToWasm0(object_id, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        var ptr1 = isLikeNone(session_json) ? 0 : passStringToWasm0(session_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        var len1 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmruntime_updateWithSession(this.__wbg_ptr, ptr0, len0, values, ptr1, len1);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
 }
 if (Symbol.dispose) WasmRuntime.prototype[Symbol.dispose] = WasmRuntime.prototype.free;
 
@@ -1505,7 +1557,7 @@ function __wbg_get_imports() {
             return ret;
         }, arguments); },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 2408, function: Function { arguments: [Externref], shim_idx: 2409, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 2423, function: Function { arguments: [Externref], shim_idx: 2424, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__hd6be7d355a1a4111, wasm_bindgen__convert__closures_____invoke__h293cf1e74083bd37);
             return ret;
         },