@yydb/yydb-unknown-wasm32 0.0.15 → 0.0.16

package/README.md

@@ -1,27 +1,27 @@
-# `@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.
-
-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.
-
-## Example
-
-```ts
-import {initWasm, checkSchema, yydbVersion} from "@yydb/yydb/wasm";
-
-await initWasm();
-
-console.log(yydbVersion());
-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).
-
-[YYDB overview](https://github.com/yy-database/yydb.rs)
+# `@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.
+
+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.
+
+## Example
+
+```ts
+import {initWasm, checkSchema, yydbVersion} from "@yydb/yydb/wasm";
+
+await initWasm();
+
+console.log(yydbVersion());
+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).
+
+[YYDB overview](https://github.com/yy-database/yydb.rs)

package/package.json

@@ -1,6 +1,6 @@
 {
   "bugs": {
-    "url": "https://github.com/yy-database/yydb.rs/issues"
+    "url": "https://github.com/yy-database/yydb/issues"
   },
   "description": "Browser WebAssembly binary for `@yydb/yydb`",
   "devDependencies": {
@@ -20,16 +20,16 @@
     "lib",
     "README.md"
   ],
-  "homepage": "https://github.com/yy-database/yydb.rs/tree/dev/projects/packages/yydb-unknown-wasm32#readme",
+  "homepage": "https://github.com/yy-database/yydb/tree/dev/projects/packages/yydb-unknown-wasm32#readme",
   "license": "MPL-2.0",
   "name": "@yydb/yydb-unknown-wasm32",
   "publishConfig": {
     "access": "public"
   },
   "repository": {
-    "directory": "projects/packages/yydb-unknown-wasm32",
     "type": "git",
-    "url": "git+https://github.com/yy-database/yydb.rs.git"
+    "url": "git+https://github.com/yy-database/yydb.git",
+    "directory": "projects/packages/yydb-unknown-wasm32"
   },
   "scripts": {
     "test": "pnpm run typecheck",
@@ -39,5 +39,5 @@
     "./lib/yydb_wasm.js"
   ],
   "type": "module",
-  "version": "0.0.15"
+  "version": "0.0.16"
 }

package/src/index.ts

@@ -1,150 +1,150 @@
-import initGlue, * as glue from '../lib/yydb_wasm.js';
-
-export type WasmInitInput = URL | Request | Response | ArrayBuffer | Uint8Array | WebAssembly.Module;
-
-export type InitWasmOptions = {
-    /** When omitted, loads the bundled `lib/yydb_wasm_bg.wasm` asset. */
-    module?: WasmInitInput;
-};
-
-export type CheckSchemaResult = {
-    ok: boolean;
-    tableCount: number;
-    schemaFingerprint: string;
-    error?: string;
-};
-
-export type MicroHostInvokePayload = {
-    hostId: number;
-    handleVersion: number;
-    functionId: string;
-    args: readonly unknown[];
-};
-
-/** Stateful wasm session (memory or OPFS-backed). */
-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;
-    close(): void;
-    readonly path?: string;
-};
-
-const glueApi = glue as {
-    yydbVersion?: () => string;
-    checkSchema?: (source: string) => CheckSchemaResult;
-    introspectSchema?: (source: string) => string;
-    MemorySession?: new () => WasmSession;
-    PersistentSession?: new (path: string) => WasmSession;
-};
-
-let ready = false;
-
-function assertReady(): void {
-    if (!ready) {
-        throw new Error('@yydb/yydb-unknown-wasm32: call initWasm() before semantic core methods');
-    }
-}
-
-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;
-}
-
-async function normalizeInitInput(input: WasmInitInput | undefined): Promise<WasmInitInput | ArrayBuffer | Uint8Array> {
-    if (input === undefined) {
-        return resolveDefaultWasmBytes();
-    }
-    if (
-        input instanceof URL ||
-        input instanceof Request ||
-        input instanceof Response ||
-        input instanceof ArrayBuffer ||
-        input instanceof Uint8Array ||
-        input instanceof WebAssembly.Module
-    ) {
-        return input;
-    }
-    throw new Error(`@yydb/yydb-unknown-wasm32: unsupported WASM init input (${typeof input})`);
-}
-
-/** One-time WASM init. Required before semantic core methods. */
-export async function initWasm(options: InitWasmOptions = {}): Promise<void> {
-    if (ready) {
-        return;
-    }
-    const moduleOrPath = await normalizeInitInput(options.module);
-    await initGlue({ module_or_path: moduleOrPath });
-    ready = true;
-}
-
-/** Library version (matches workspace `@yydb/yydb` semver). */
-export function yydbVersion(): string {
-    assertReady();
-    if (!glueApi.yydbVersion) {
-        throw new Error('@yydb/yydb-unknown-wasm32: yydbVersion export missing, rebuild wasm artifacts');
-    }
-    return glueApi.yydbVersion();
-}
-
-/** Parse and validate a VOS schema document via the Rust core. */
-export function checkSchema(source: string): CheckSchemaResult {
-    assertReady();
-    if (!glueApi.checkSchema) {
-        throw new Error('@yydb/yydb-unknown-wasm32: checkSchema export missing, rebuild wasm artifacts');
-    }
-    return glueApi.checkSchema(source);
-}
-
-/** Read-only schema introspection JSON. */
-export function introspectSchema(source: string): string {
-    assertReady();
-    if (!glueApi.introspectSchema) {
-        throw new Error('@yydb/yydb-unknown-wasm32: introspectSchema export missing, rebuild wasm artifacts');
-    }
-    return glueApi.introspectSchema(source);
-}
-
-/** Open a stateful in-memory session. */
-export function createMemorySession(): WasmSession {
-    assertReady();
-    if (!glueApi.MemorySession) {
-        throw new Error('@yydb/yydb-unknown-wasm32: MemorySession export missing, rebuild wasm artifacts');
-    }
-    return new glueApi.MemorySession();
-}
-
-/** Open a stateful OPFS-backed session at `path`. */
-export function openPersistentSession(path: string): WasmSession {
-    assertReady();
-    if (!glueApi.PersistentSession) {
-        throw new Error('@yydb/yydb-unknown-wasm32: PersistentSession export missing, rebuild wasm artifacts');
-    }
-    return new glueApi.PersistentSession(path);
-}
-
-/** @internal Reset init gate (binding tests only). */
-export function resetWasmBindingForTests(): void {
-    ready = false;
-}
+import initGlue, * as glue from '../lib/yydb_wasm.js';
+
+export type WasmInitInput = URL | Request | Response | ArrayBuffer | Uint8Array | WebAssembly.Module;
+
+export type InitWasmOptions = {
+    /** When omitted, loads the bundled `lib/yydb_wasm_bg.wasm` asset. */
+    module?: WasmInitInput;
+};
+
+export type CheckSchemaResult = {
+    ok: boolean;
+    tableCount: number;
+    schemaFingerprint: string;
+    error?: string;
+};
+
+export type MicroHostInvokePayload = {
+    hostId: number;
+    handleVersion: number;
+    functionId: string;
+    args: readonly unknown[];
+};
+
+/** Stateful wasm session (memory or OPFS-backed). */
+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;
+    close(): void;
+    readonly path?: string;
+};
+
+const glueApi = glue as {
+    yydbVersion?: () => string;
+    checkSchema?: (source: string) => CheckSchemaResult;
+    introspectSchema?: (source: string) => string;
+    MemorySession?: new () => WasmSession;
+    PersistentSession?: new (path: string) => WasmSession;
+};
+
+let ready = false;
+
+function assertReady(): void {
+    if (!ready) {
+        throw new Error('@yydb/yydb-unknown-wasm32: call initWasm() before semantic core methods');
+    }
+}
+
+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;
+}
+
+async function normalizeInitInput(input: WasmInitInput | undefined): Promise<WasmInitInput | ArrayBuffer | Uint8Array> {
+    if (input === undefined) {
+        return resolveDefaultWasmBytes();
+    }
+    if (
+        input instanceof URL ||
+        input instanceof Request ||
+        input instanceof Response ||
+        input instanceof ArrayBuffer ||
+        input instanceof Uint8Array ||
+        input instanceof WebAssembly.Module
+    ) {
+        return input;
+    }
+    throw new Error(`@yydb/yydb-unknown-wasm32: unsupported WASM init input (${typeof input})`);
+}
+
+/** One-time WASM init. Required before semantic core methods. */
+export async function initWasm(options: InitWasmOptions = {}): Promise<void> {
+    if (ready) {
+        return;
+    }
+    const moduleOrPath = await normalizeInitInput(options.module);
+    await initGlue({ module_or_path: moduleOrPath });
+    ready = true;
+}
+
+/** Library version (matches workspace `@yydb/yydb` semver). */
+export function yydbVersion(): string {
+    assertReady();
+    if (!glueApi.yydbVersion) {
+        throw new Error('@yydb/yydb-unknown-wasm32: yydbVersion export missing, rebuild wasm artifacts');
+    }
+    return glueApi.yydbVersion();
+}
+
+/** Parse and validate a VOS schema document via the Rust core. */
+export function checkSchema(source: string): CheckSchemaResult {
+    assertReady();
+    if (!glueApi.checkSchema) {
+        throw new Error('@yydb/yydb-unknown-wasm32: checkSchema export missing, rebuild wasm artifacts');
+    }
+    return glueApi.checkSchema(source);
+}
+
+/** Read-only schema introspection JSON. */
+export function introspectSchema(source: string): string {
+    assertReady();
+    if (!glueApi.introspectSchema) {
+        throw new Error('@yydb/yydb-unknown-wasm32: introspectSchema export missing, rebuild wasm artifacts');
+    }
+    return glueApi.introspectSchema(source);
+}
+
+/** Open a stateful in-memory session. */
+export function createMemorySession(): WasmSession {
+    assertReady();
+    if (!glueApi.MemorySession) {
+        throw new Error('@yydb/yydb-unknown-wasm32: MemorySession export missing, rebuild wasm artifacts');
+    }
+    return new glueApi.MemorySession();
+}
+
+/** Open a stateful OPFS-backed session at `path`. */
+export function openPersistentSession(path: string): WasmSession {
+    assertReady();
+    if (!glueApi.PersistentSession) {
+        throw new Error('@yydb/yydb-unknown-wasm32: PersistentSession export missing, rebuild wasm artifacts');
+    }
+    return new glueApi.PersistentSession(path);
+}
+
+/** @internal Reset init gate (binding tests only). */
+export function resetWasmBindingForTests(): void {
+    ready = false;
+}