jazz-wasm 2.0.0-alpha.2 → 2.0.0-alpha.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jazz-wasm",
-  "version": "2.0.0-alpha.2",
+  "version": "2.0.0-alpha.20",
   "description": "WebAssembly bindings for the Jazz database engine",
   "keywords": [
     "crdt",
@@ -20,6 +20,10 @@
   ],
   "main": "pkg/jazz_wasm.js",
   "types": "pkg/jazz_wasm.d.ts",
+  "publishConfig": {
+    "access": "public",
+    "tag": "alpha"
+  },
   "devDependencies": {
     "wasm-pack": "^0.14.0"
   },

package/pkg/jazz_wasm.d.ts

@@ -1,57 +1,5 @@
 /* tslint:disable */
 /* eslint-disable */
-export interface WasmColumnDescriptor {
-    name: string;
-    column_type: WasmColumnType;
-    nullable: boolean;
-    references?: string;
-}
-
-export interface WasmOperationPolicy {
-    using?: WasmPolicyExpr;
-    with_check?: WasmPolicyExpr;
-}
-
-export interface WasmRow {
-    id: string;
-    values: WasmValue[];
-}
-
-export interface WasmRowDelta {
-    added: WasmRow[];
-    removed: WasmRow[];
-    updated: [WasmRow, WasmRow][];
-    pending: boolean;
-}
-
-export interface WasmSchema {
-    tables: Record<string, WasmTableSchema>;
-}
-
-export interface WasmTablePolicies {
-    select?: WasmOperationPolicy;
-    insert?: WasmOperationPolicy;
-    update?: WasmOperationPolicy;
-    delete?: WasmOperationPolicy;
-}
-
-export interface WasmTableSchema {
-    columns: WasmColumnDescriptor[];
-    policies?: WasmTablePolicies;
-}
-
-export type WasmCmpOp = "Eq" | "Ne" | "Lt" | "Le" | "Gt" | "Ge";
-
-export type WasmColumnType = { type: "Integer" } | { type: "BigInt" } | { type: "Boolean" } | { type: "Text" } | { type: "Enum"; variants: string[] } | { type: "Timestamp" } | { type: "Uuid" } | { type: "Array"; element: WasmColumnType } | { type: "Row"; columns: WasmColumnDescriptor[] };
-
-export type WasmPolicyExpr = { type: "Cmp"; column: string; op: WasmCmpOp; value: WasmPolicyValue } | { type: "IsNull"; column: string } | { type: "IsNotNull"; column: string } | { type: "In"; column: string; session_path: string[] } | { type: "Exists"; table: string; condition: WasmPolicyExpr } | { type: "ExistsRel"; rel: any } | { type: "Inherits"; operation: WasmPolicyOperation; via_column: string; max_depth?: number } | { type: "And"; exprs: WasmPolicyExpr[] } | { type: "Or"; exprs: WasmPolicyExpr[] } | { type: "Not"; expr: WasmPolicyExpr } | { type: "True" } | { type: "False" };
-
-export type WasmPolicyOperation = "Select" | "Insert" | "Update" | "Delete";
-
-export type WasmPolicyValue = { type: "Literal"; value: WasmValue } | { type: "SessionRef"; path: string[] };
-
-export type WasmValue = { type: "Integer"; value: number } | { type: "BigInt"; value: number } | { type: "Boolean"; value: boolean } | { type: "Text"; value: string } | { type: "Timestamp"; value: number } | { type: "Uuid"; value: string } | { type: "Array"; value: WasmValue[] } | { type: "Row"; value: WasmValue[] } | { type: "Null" };
-
 
 /**
  * WASM-exposed QueryBuilder with camelCase methods.
@@ -155,6 +103,14 @@ export class WasmQueryBuilder {
 export class WasmRuntime {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Debug helper: expose schema/lens state currently loaded in SchemaManager.
+     */
+    __debugSchemaState(): any;
+    /**
+     * Debug helper: seed a historical schema and persist schema/lens catalogue objects.
+     */
+    __debugSeedLiveSchema(schema_json: string): void;
     /**
      * Add a client connection (for server-side use in tests).
      */
@@ -167,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.
      */
@@ -174,7 +135,23 @@ export class WasmRuntime {
     /**
      * Delete a row and return a Promise that resolves when the tier acks.
      */
-    deleteWithAck(object_id: string, tier: string): Promise<any>;
+    deleteDurable(object_id: string, tier: string): Promise<any>;
+    /**
+     * Delete a row and return a Promise that resolves when the tier acks,
+     * scoped to an explicit session principal.
+     */
+    deleteDurableWithSession(object_id: string, session_json: string | null | undefined, tier: string): Promise<any>;
+    /**
+     * Delete a row by ObjectId as an explicit session principal.
+     */
+    deleteWithSession(object_id: string, session_json?: string | null): void;
+    /**
+     * 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).
      */
@@ -195,15 +172,24 @@ 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.
      *
-     * `tier` must be one of: "worker", "edge", "core".
+     * `tier` must be one of: "worker", "edge", "global".
+     */
+    insertDurable(table: string, values: any, tier: string): Promise<any>;
+    /**
+     * Insert a row and return a Promise that resolves when the tier acks,
+     * scoped to an explicit session principal.
      */
-    insertWithAck(table: string, values: any, tier: string): Promise<any>;
+    insertDurableWithSession(table: string, values: any, session_json: string | null | undefined, tier: string): Promise<any>;
+    /**
+     * Insert a row into a table as an explicit session principal.
+     */
+    insertWithSession(table: string, values: any, session_json?: string | null): any;
     /**
      * Create a new WasmRuntime.
      *
@@ -214,25 +200,28 @@ export class WasmRuntime {
      * * `app_id` - Application identifier
      * * `env` - Environment (e.g., "dev", "prod")
      * * `user_branch` - User's branch name (e.g., "main")
-     * * `tier` - Optional persistence tier ("worker", "edge", "core").
+     * * `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.
      *
      * # Arguments
-     * * `message_json` - JSON-encoded SyncPayload
+     * * `payload` - Either postcard-encoded SyncPayload bytes (`Uint8Array`)
+     *   or JSON-encoded SyncPayload (`string`)
      */
-    onSyncMessageReceived(message_json: string): void;
+    onSyncMessageReceived(payload: any): void;
     /**
      * Called by JS when a sync message arrives from a client (not a server).
      *
      * # Arguments
      * * `client_id` - UUID string of the sending client
-     * * `message_json` - JSON-encoded SyncPayload
+     * * `payload` - Postcard-encoded SyncPayload bytes
      */
-    onSyncMessageReceivedFromClient(client_id: string, message_json: string): void;
+    onSyncMessageReceivedFromClient(client_id: string, payload: any): void;
     /**
      * Register a callback for outgoing sync messages.
      */
@@ -243,13 +232,13 @@ 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.
      *
-     * Optional `settled_tier` holds delivery until the tier confirms.
+     * Optional durability tier controls remote settlement behavior.
      */
-    query(query_json: string, session_json?: string | null, settled_tier?: string | null): Promise<any>;
+    query(query_json: string, session_json?: string | null, settled_tier?: string | null, options_json?: string | null): Promise<any>;
     /**
      * Remove the current upstream server connection.
      */
@@ -269,12 +258,12 @@ export class WasmRuntime {
      * - with upstream server: first callback waits for protocol QuerySettled convergence
      * - without upstream server: first callback is local-immediate
      *
-     * Pass `settled_tier` to override this default.
+     * Pass durability options to override this default.
      *
      * # Returns
      * Subscription handle (f64) for later unsubscription.
      */
-    subscribe(query_json: string, on_update: Function, session_json?: string | null, settled_tier?: string | null): number;
+    subscribe(query_json: string, on_update: Function, session_json?: string | null, settled_tier?: string | null, options_json?: string | null): number;
     /**
      * Unsubscribe from a query.
      */
@@ -286,7 +275,21 @@ export class WasmRuntime {
     /**
      * Update a row and return a Promise that resolves when the tier acks.
      */
-    updateWithAck(object_id: string, values: any, tier: string): Promise<any>;
+    updateDurable(object_id: string, values: any, tier: string): Promise<any>;
+    /**
+     * Update a row and return a Promise that resolves when the tier acks,
+     * scoped to an explicit session principal.
+     */
+    updateDurableWithSession(object_id: string, values: any, session_json: string | null | undefined, 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;
@@ -365,6 +368,39 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
+    readonly __wbg_wasmruntime_free: (a: number, b: number) => void;
+    readonly wasmruntime___debugSchemaState: (a: number) => [number, number, number];
+    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_deleteDurableWithSession: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number];
+    readonly wasmruntime_deleteWithSession: (a: number, b: number, c: number, d: number, e: 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];
+    readonly wasmruntime_insertDurable: (a: number, b: number, c: number, d: any, e: number, f: number) => [number, number, number];
+    readonly wasmruntime_insertDurableWithSession: (a: number, b: number, c: number, d: any, e: number, f: number, g: number, h: number) => [number, number, number];
+    readonly wasmruntime_insertWithSession: (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, 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, 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];
+    readonly wasmruntime_subscribe: (a: number, b: number, c: number, d: any, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number, number];
+    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_updateDurableWithSession: (a: number, b: number, c: number, d: any, e: number, f: number, g: number, h: number) => [number, number, number];
+    readonly wasmruntime_updateWithSession: (a: number, b: number, c: number, d: any, e: number, f: number) => [number, number];
     readonly __wbg_wasmquerybuilder_free: (a: number, b: number) => void;
     readonly currentTimestamp: () => bigint;
     readonly generateId: () => [number, number];
@@ -391,29 +427,6 @@ export interface InitOutput {
     readonly wasmquerybuilder_orderByDesc: (a: number, b: number, c: number) => number;
     readonly wasmquerybuilder_select: (a: number, b: number, c: number) => number;
     readonly init: () => void;
-    readonly __wbg_wasmruntime_free: (a: number, b: number) => void;
-    readonly wasmruntime_addClient: (a: number) => [number, number];
-    readonly wasmruntime_addServer: (a: number) => void;
-    readonly wasmruntime_delete: (a: number, b: number, c: number) => [number, number];
-    readonly wasmruntime_deleteWithAck: (a: number, b: number, c: number, d: number, e: number) => [number, 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_insertWithAck: (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_onSyncMessageReceived: (a: number, b: number, c: number) => [number, number];
-    readonly wasmruntime_onSyncMessageReceivedFromClient: (a: number, b: number, c: number, d: number, e: number) => [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_query: (a: number, b: number, c: number, d: number, e: number, f: number, g: 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];
-    readonly wasmruntime_subscribe: (a: number, b: number, c: number, d: any, e: number, f: number, g: number, h: number) => [number, number, number];
-    readonly wasmruntime_unsubscribe: (a: number, b: number) => void;
-    readonly wasmruntime_update: (a: number, b: number, c: number, d: any) => [number, number];
-    readonly wasmruntime_updateWithAck: (a: number, b: number, c: number, d: any, e: number, f: number) => [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;
@@ -437,9 +450,9 @@ export interface InitOutput {
     readonly bench_reset_overflow_threshold_bytes: () => void;
     readonly bench_reset_pin_internal_pages: () => void;
     readonly bench_reset_read_coalesce_pages: () => void;
-    readonly wasm_bindgen__closure__destroy__h36582af6159eae23: (a: number, b: number) => void;
-    readonly wasm_bindgen__convert__closures_____invoke__h87add1091edf4849: (a: number, b: number, c: any, d: any) => void;
-    readonly wasm_bindgen__convert__closures_____invoke__h2cc017d284ea0daf: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen__closure__destroy__h91062c162630e93c: (a: number, b: number) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__hc8651b792d0b9061: (a: number, b: number, c: any) => [number, number];
+    readonly wasm_bindgen__convert__closures_____invoke__h4abc8a55d4718cb4: (a: number, b: number, c: any, d: any) => void;
     readonly __wbindgen_malloc: (a: number, b: number) => number;
     readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_exn_store: (a: number) => void;