@yydb/yydb-unknown-wasm32 0.1.1 → 0.1.3

package/README.md

@@ -1,27 +1,24 @@
 # `@yydb/yydb-unknown-wasm32`
 
-Low-level wasm-pack artifacts for the YYDB browser core. **App authors should use
-[`@yydb/yydb/wasm`](https://www.npmjs.com/package/@yydb/yydb)** instead of this package.
+Low-level wasm-pack artifacts for the YYDB browser core: init glue, schema checks, and memory / persistent sessions.
 
-Import here only when you need the raw glue or bundled `.wasm` path. For durable reads and writes in production, prefer
-[`@yydb/yydb-client`](https://www.npmjs.com/package/@yydb/yydb-client) against `yydb serve` until wasm persistence
-lands.
+Application authors should use [`@yydb/light-db`](https://www.npmjs.com/package/@yydb/light-db), which wraps these
+artifacts as `WasmDatabase` and `openLightDatabase`. Import this package directly only when you need the raw glue or
+the bundled `.wasm` asset path.
 
 ## Example
 
 ```ts
-import {initWasm, checkSchema, yydbVersion} from "@yydb/yydb/wasm";
+import { checkSchema, initWasm, yydbVersion } from '@yydb/yydb-unknown-wasm32';
 
 await initWasm();
 
 console.log(yydbVersion());
-console.log(
-    checkSchema("table Setting { @@id: uuid, key: utf8 }"),
-);
+console.log(checkSchema('table Setting { @@id: uuid, key: utf8 }'));
 ```
 
 Call `initWasm()` once before semantic methods. Omit `options.module` to load the bundled `lib/yydb_wasm_bg.wasm` asset.
 
-Low-level glue: `@yydb/yydb-unknown-wasm32/wasm` (raw `.wasm` path).
+Raw asset path: `@yydb/yydb-unknown-wasm32/wasm`.
 
-[YYDB overview](https://github.com/yy-database/yydb.rs)
+[YYDB overview](https://github.com/yy-database/yydb) · [Browser product](https://www.npmjs.com/package/@yydb/light-db)

package/package.json

@@ -39,5 +39,5 @@
     "./lib/yydb_wasm.js"
   ],
   "type": "module",
-  "version": "0.1.1"
+  "version": "0.1.3"
 }

package/src/index.ts

@@ -26,11 +26,34 @@ export type WasmSession = {
     ensureSchema(document: string): string;
     get(key: string): string;
     put(key: string, value: Uint8Array): string;
+    delete(key: string): string;
+    scanPrefix(prefix: string, after: string | null | undefined, limit: number): string;
+    writeBatch(body: Uint8Array): string;
+    compareExchange(key: string, expected?: Uint8Array | null, replacement?: Uint8Array | null): string;
     getSchema(): string;
+    queryVos(source: string): string;
+    executeVosWrite(source: string): string;
+    migrateSchema(document: string, renames_json?: string | null): string;
+    begin(): string;
+    commit(): string;
+    rollback(): string;
+    checkpoint(): string;
     info(): string;
     setMicroHostInvoker(invoker: (payload: MicroHostInvokePayload) => unknown): void;
     registerMicro(body: Uint8Array): string;
     callScalar(body: Uint8Array): string;
+    /** High-level JSON descriptor for host micro registration. */
+    registerMicroJson(json: string): string;
+    /** High-level JSON args for scalar UDF invocation. */
+    callScalarJson(json: string): string;
+    /** Read-only consistency probes. Returns JSON `{ ok, report?, error? }`. */
+    doctorJson(): string;
+    /** Prepare a VOS query plan. Returns JSON `{ ok, statement_id?, ..., error? }`. */
+    prepareJson(source: string): string;
+    /** Execute a previously prepared statement. Returns JSON `{ ok, rows?, error? }`. */
+    queryPreparedJson(json: string): string;
+    /** Release a prepared statement's plan. Returns true if present. */
+    closeStatement(statementId: string): boolean;
     close(): void;
     readonly path?: string;
 };
@@ -51,19 +74,13 @@ function assertReady(): void {
     }
 }
 
-async function resolveDefaultWasmBytes(): Promise<ArrayBuffer | Uint8Array | URL> {
-    const wasmUrl = new URL('../lib/yydb_wasm_bg.wasm', import.meta.url);
-    if (typeof process !== 'undefined' && process.versions?.node) {
-        const { readFileSync } = await import('node:fs');
-        const { fileURLToPath } = await import('node:url');
-        return readFileSync(fileURLToPath(wasmUrl));
-    }
-    return wasmUrl;
+function resolveDefaultWasmUrl(): URL {
+    return new URL('../lib/yydb_wasm_bg.wasm', import.meta.url);
 }
 
-async function normalizeInitInput(input: WasmInitInput | undefined): Promise<WasmInitInput | ArrayBuffer | Uint8Array> {
+function normalizeInitInput(input: WasmInitInput | undefined): WasmInitInput | ArrayBuffer | Uint8Array {
     if (input === undefined) {
-        return resolveDefaultWasmBytes();
+        return resolveDefaultWasmUrl();
     }
     if (
         input instanceof URL ||
@@ -83,7 +100,7 @@ export async function initWasm(options: InitWasmOptions = {}): Promise<void> {
     if (ready) {
         return;
     }
-    const moduleOrPath = await normalizeInitInput(options.module);
+    const moduleOrPath = normalizeInitInput(options.module);
     await initGlue({ module_or_path: moduleOrPath });
     ready = true;
 }