jazz-wasm 2.0.0-alpha.3 → 2.0.0-alpha.31

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jazz-wasm",
-  "version": "2.0.0-alpha.3",
+  "version": "2.0.0-alpha.31",
   "description": "WebAssembly bindings for the Jazz database engine",
   "keywords": [
     "crdt",
@@ -18,12 +18,14 @@
     "pkg/jazz_wasm.js",
     "pkg/jazz_wasm.d.ts"
   ],
+  "type": "module",
   "main": "pkg/jazz_wasm.js",
   "types": "pkg/jazz_wasm.d.ts",
+  "publishConfig": {
+    "access": "public",
+    "tag": "alpha"
+  },
   "scripts": {
     "build": "wasm-pack build --target web --profiling"
-  },
-  "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,15 @@ 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;
+    acknowledgeRejectedBatch(batch_id: string): boolean;
     /**
      * Add a client connection (for server-side use in tests).
      */
@@ -166,7 +123,19 @@ export class WasmRuntime {
      * catalogue sync messages (from queue_full_sync_to_server) are sent
      * before the call returns, rather than being deferred to a microtask.
      */
-    addServer(): void;
+    addServer(server_catalogue_state_hash?: string | null, next_sync_seq?: number | null): void;
+    /**
+     * Connect to a Jazz server over WebSocket.
+     *
+     * Parses `auth_json` into `AuthConfig`, wires a `TransportManager` into
+     * `RuntimeCore`, and spawns the manager loop via `spawn_local`.
+     */
+    connect(url: string, auth_json: string): 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 +143,39 @@ 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, write_context_json: string | null | undefined, tier: string): Promise<any>;
+    /**
+     * Delete a row immediately, returning the logical batch id that tracks
+     * replayable persisted fate for this write.
+     */
+    deletePersisted(object_id: string, tier: string): any;
+    /**
+     * Delete a row immediately, returning the logical batch id that tracks
+     * replayable persisted fate for this write, scoped to an explicit session
+     * principal or transactional write context.
+     */
+    deletePersistedWithSession(object_id: string, write_context_json: string | null | undefined, tier: string): any;
+    /**
+     * Delete a row by ObjectId as an explicit session principal.
+     */
+    deleteWithSession(object_id: string, write_context_json?: string | null): void;
+    static deriveUserId(seed_b64: string): string;
+    /**
+     * Disconnect from the Jazz server and drop the transport handle.
+     */
+    disconnect(): 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).
      */
@@ -183,6 +184,7 @@ export class WasmRuntime {
      * Flush only the WAL buffer to OPFS (not the snapshot).
      */
     flushWal(): void;
+    static getPublicKeyBase64url(seed_b64: string): string;
     /**
      * Get the current schema as JSON.
      */
@@ -195,15 +197,38 @@ 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, object_id?: string | null): 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, object_id?: string | null): Promise<any>;
+    /**
+     * Insert a row and return a Promise that resolves when the tier acks,
+     * scoped to an explicit session principal.
+     */
+    insertDurableWithSession(table: string, values: any, write_context_json: string | null | undefined, tier: string, object_id?: string | null): Promise<any>;
+    /**
+     * Insert a row immediately, returning the logical batch id that tracks
+     * replayable persisted fate for this write.
      */
-    insertWithAck(table: string, values: any, tier: string): Promise<any>;
+    insertPersisted(table: string, values: any, tier: string): any;
+    /**
+     * Insert a row immediately, returning the logical batch id that tracks
+     * replayable persisted fate for this write, scoped to an explicit session
+     * principal or transactional write context.
+     */
+    insertPersistedWithSession(table: string, values: any, write_context_json: string | null | undefined, tier: string): any;
+    /**
+     * Insert a row into a table as an explicit session principal.
+     */
+    insertWithSession(table: string, values: any, write_context_json?: string | null, object_id?: string | null): any;
+    loadLocalBatchRecord(batch_id: string): any;
+    loadLocalBatchRecords(): any;
+    static mintLocalFirstToken(seed_b64: string, audience: string, ttl_seconds: bigint, now_seconds: bigint): string;
     /**
      * Create a new WasmRuntime.
      *
@@ -214,25 +239,35 @@ 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);
+    /**
+     * Register a JS callback that fires when the Rust transport receives an
+     * auth failure (Unauthorized) from the server during the WS handshake.
+     *
+     * The callback receives a single string argument: a human-readable reason.
+     */
+    onAuthFailure(callback: Function): void;
     /**
      * 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, sequence?: number | null): 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,17 +278,18 @@ 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.
      */
     removeServer(): void;
+    sealBatch(batch_id: string): void;
     /**
      * Set a client's role.
      *
@@ -269,12 +305,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.
      */
@@ -283,10 +319,39 @@ export class WasmRuntime {
      * Update a row by ObjectId.
      */
     update(object_id: string, values: any): void;
+    /**
+     * Push updated auth credentials into the live transport.
+     */
+    updateAuth(auth_json: string): void;
     /**
      * 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, write_context_json: string | null | undefined, tier: string): Promise<any>;
+    /**
+     * Update a row immediately, returning the logical batch id that tracks
+     * replayable persisted fate for this write.
+     */
+    updatePersisted(object_id: string, values: any, tier: string): any;
+    /**
+     * Update a row immediately, returning the logical batch id that tracks
+     * replayable persisted fate for this write, scoped to an explicit session
+     * principal or transactional write context.
+     */
+    updatePersistedWithSession(object_id: string, values: any, write_context_json: string | null | undefined, tier: string): 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, write_context_json?: string | null): void;
 }
 
 export function bench_get_cache_bytes(): number;
@@ -366,9 +431,6 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
     readonly __wbg_wasmquerybuilder_free: (a: number, b: number) => void;
-    readonly currentTimestamp: () => bigint;
-    readonly generateId: () => [number, number];
-    readonly parseSchema: (a: number, b: number) => [number, number, number];
     readonly wasmquerybuilder_alias: (a: number, b: number, c: number) => number;
     readonly wasmquerybuilder_branch: (a: number, b: number, c: number) => number;
     readonly wasmquerybuilder_branches: (a: number, b: number, c: number) => number;
@@ -390,30 +452,60 @@ export interface InitOutput {
     readonly wasmquerybuilder_orderBy: (a: number, b: number, c: number) => number;
     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 currentTimestamp: () => bigint;
+    readonly generateId: () => [number, number];
+    readonly parseSchema: (a: number, b: number) => [number, number, number];
+    readonly wasmruntime___debugSchemaState: (a: number) => [number, number, number];
+    readonly wasmruntime___debugSeedLiveSchema: (a: number, b: number, c: number) => [number, number];
+    readonly wasmruntime_acknowledgeRejectedBatch: (a: number, b: number, c: number) => [number, number, number];
     readonly wasmruntime_addClient: (a: number) => [number, number];
-    readonly wasmruntime_addServer: (a: number) => void;
+    readonly wasmruntime_addServer: (a: number, b: number, c: number, d: number, e: number) => [number, number];
+    readonly wasmruntime_connect: (a: number, b: number, c: number, d: number, e: number) => [number, number];
+    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_deleteWithAck: (a: number, b: number, c: number, d: number, e: number) => [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_deletePersisted: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
+    readonly wasmruntime_deletePersistedWithSession: (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_deriveUserId: (a: number, b: number) => [number, number, number, number];
+    readonly wasmruntime_disconnect: (a: number) => void;
+    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_getPublicKeyBase64url: (a: number, b: number) => [number, number, number, number];
     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_insert: (a: number, b: number, c: number, d: any, e: number, f: number) => [number, number, number];
+    readonly wasmruntime_insertDurable: (a: number, b: number, c: number, d: any, e: number, f: number, g: number, h: number) => [number, number, number];
+    readonly wasmruntime_insertDurableWithSession: (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_insertPersisted: (a: number, b: number, c: number, d: any, e: number, f: number) => [number, number, number];
+    readonly wasmruntime_insertPersistedWithSession: (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, g: number, h: number) => [number, number, number];
+    readonly wasmruntime_loadLocalBatchRecord: (a: number, b: number, c: number) => [number, number, number];
+    readonly wasmruntime_loadLocalBatchRecords: (a: number) => [number, number, number];
+    readonly wasmruntime_mintLocalFirstToken: (a: number, b: number, c: number, d: number, e: bigint, f: bigint) => [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_onAuthFailure: (a: number, b: any) => void;
+    readonly wasmruntime_onSyncMessageReceived: (a: number, b: any, c: number, d: number) => [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_query: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number];
+    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_sealBatch: (a: number, b: number, c: number) => [number, number];
     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_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_updateWithAck: (a: number, b: number, c: number, d: any, e: number, f: number) => [number, number, number];
+    readonly wasmruntime_updateAuth: (a: number, b: number, c: number) => [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_updatePersisted: (a: number, b: number, c: number, d: any, e: number, f: number) => [number, number, number];
+    readonly wasmruntime_updatePersistedWithSession: (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 init: () => void;
     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,15 +529,18 @@ 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__hf4559643960778aa: (a: number, b: number) => void;
-    readonly wasm_bindgen__convert__closures_____invoke__h80f2dc13026cb48e: (a: number, b: number, c: any, d: any) => void;
-    readonly wasm_bindgen__convert__closures_____invoke__hb8186e1d67b17c41: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h656199c36535c3e6: (a: number, b: number, c: any) => [number, number];
+    readonly wasm_bindgen__convert__closures_____invoke__h250bbd6a67e0e1e6: (a: number, b: number, c: any, d: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__hf7ddf3622752ec36: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__hc18e08680cddc2e5: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h03757a48b3eba690: (a: number, b: number) => 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;
     readonly __externref_table_alloc: () => number;
     readonly __wbindgen_externrefs: WebAssembly.Table;
     readonly __wbindgen_free: (a: number, b: number, c: number) => void;
+    readonly __wbindgen_destroy_closure: (a: number, b: number) => void;
     readonly __externref_table_dealloc: (a: number) => void;
     readonly __wbindgen_start: () => void;
 }