@yydb/yydb 0.0.12 → 0.0.15

package/dist/wasm/database.js

@@ -0,0 +1,118 @@
+import { encodeMicroRegister, encodeScalarCall, YydbError, YydbErrorCodes } from '@yydb/yydb-client';
+import { defineMicro as buildMicro, microFingerprint, udfWireKind, MicroSessionRegistry } from '../shared/micro.js';
+import { parseWasmKvGetResult, parseWasmRowsResult, parseWasmScalarResult, parseWasmSchemaResult, parseWasmUnitResult, } from '../shared/wasm-envelope.js';
+import { checkSchema, createMemorySession, initWasm, openPersistentSession, yydbVersion, } from './binding.js';
+/**
+ * Browser-facing YYDB handle backed by an in-process wasm session.
+ * Use `open` for OPFS-backed paths and `openInMemory` for ephemeral state.
+ */
+export class Database {
+    path;
+    session;
+    kind;
+    microRegistry;
+    constructor(kind, path, session) {
+        this.kind = kind;
+        this.path = path;
+        this.session = session;
+        this.microRegistry = new MicroSessionRegistry();
+        session.setMicroHostInvoker((payload) => this.microRegistry.invokeFromWire(payload));
+    }
+    /** Open an OPFS-backed database at `path` (for example `app.yydb`). */
+    static async open(path, options = {}) {
+        await initWasm(options);
+        const session = openPersistentSession(path);
+        return new Database('persistent', session.path ?? path, session);
+    }
+    /** Open a stateful in-memory database session. */
+    static async openInMemory(options = {}) {
+        await initWasm(options);
+        const session = createMemorySession();
+        return new Database('memory', ':memory:', session);
+    }
+    /** Library version from the wasm binding. */
+    version() {
+        return yydbVersion();
+    }
+    /** Engine version string (Node API parity). */
+    async serverVersion() {
+        return yydbVersion();
+    }
+    /** Database info text (`path=…\\n…`), matching the YY wire `Info` reply. */
+    async info() {
+        return this.requireSession('info').info();
+    }
+    /** Parse and validate a VOS schema document without opening a session. */
+    checkSchema(source) {
+        return checkSchema(source);
+    }
+    /** Persist schema document. `version` is accepted for Node API parity; wasm uses the document body. */
+    async ensureSchema(_version, document) {
+        parseWasmUnitResult(this.requireSession('schemaEnsure').ensureSchema(document), 'schemaEnsure');
+    }
+    async getSchema() {
+        return parseWasmSchemaResult(this.requireSession('schemaGet').getSchema(), 'schemaGet');
+    }
+    async get(key) {
+        return parseWasmKvGetResult(this.requireSession('kvGet').get(key), 'kvGet');
+    }
+    async put(key, value) {
+        const bytes = typeof value === 'string' ? new TextEncoder().encode(value) : value;
+        parseWasmUnitResult(this.requireSession('kvPut').put(key, bytes), 'kvPut');
+    }
+    /** VOS read pipeline (for example `User.filter(x => x.active).collect()`). */
+    query(source) {
+        return parseWasmRowsResult(this.requireSession('query').query(source), 'query').rows;
+    }
+    /** Unit-valued VOS write programs (for example `User { … }.insert()`). */
+    execute(source) {
+        parseWasmUnitResult(this.requireSession('execute').execute(source), 'execute');
+    }
+    /**
+     * Build a typed session-local micro definition. Does not register it with
+     * the engine until `registerMicro` is called.
+     */
+    defineMicro(definition) {
+        return buildMicro(definition);
+    }
+    /**
+     * Install a `defineMicro` definition into the current session registry and
+     * sync metadata to the embedded engine. Host micros are session-local.
+     */
+    async registerMicro(definition) {
+        const handle = this.microRegistry.register(definition);
+        const body = encodeMicroRegister({
+            hostId: handle.hostId,
+            handleVersion: handle.implementationVersion,
+            udfVersion: definition.version,
+            name: definition.name,
+            functionId: handle.functionId,
+            args: definition.args.map(udfWireKind),
+            returns: udfWireKind(definition.returns),
+            fingerprint: microFingerprint(definition.name, definition.version),
+        });
+        parseWasmUnitResult(this.requireSession('microRegister').registerMicro(body), 'microRegister');
+        return handle;
+    }
+    /** Invoke a registered scalar UDF on the embedded engine. */
+    async callScalar(name, version, args) {
+        const body = encodeScalarCall(name, version, args);
+        return parseWasmScalarResult(this.requireSession('callScalar').callScalar(body), 'callScalar');
+    }
+    /** Whether this handle owns a persistent OPFS session. */
+    isPersistent() {
+        return this.kind === 'persistent';
+    }
+    /** Close the embedded session. Idempotent; further calls fail with `yydb.session.closed`. */
+    async close() {
+        const session = this.session;
+        this.session = null;
+        session?.close();
+    }
+    requireSession(operation) {
+        if (!this.session) {
+            throw new YydbError(YydbErrorCodes.sessionClosed, `${operation}: @yydb/yydb/wasm session is closed`, { operation });
+        }
+        return this.session;
+    }
+}

package/dist/wasm/index.d.ts

@@ -0,0 +1,8 @@
+export { Database, type WasmOpenOptions } from './database.js';
+export { YydbError, YydbErrorCodes, isRetryableYydbCode, isYydbError } from '@yydb/yydb-client';
+export type { YydbErrorCode, YydbErrorOptions } from '@yydb/yydb-client';
+export { checkSchema, createMemorySession, initWasm, introspectSchema, openPersistentSession, queryMemory, resetWasmBindingForTests, yydbVersion, type CheckSchemaResult, type InitWasmOptions, type WasmInitInput, type WasmSession, } from './binding.js';
+export { defineMicro, type DefinedMicro, type MicroHandle, type TsMicroDefinitionInput, MicroSessionRegistry } from '../shared/micro.js';
+export { type InferUdfArgs, type InferUdfReturn, type MicroEffect, type MicroInvocationMode, type UdfScalarDescriptor, type UdfScalarKind, } from '../shared/udf-types.js';
+export type { SchemaVersion } from '../shared/wasm-envelope.js';
+export * from '../shared/vos.js';

package/dist/wasm/index.js

@@ -0,0 +1,5 @@
+export { Database } from './database.js';
+export { YydbError, YydbErrorCodes, isRetryableYydbCode, isYydbError } from '@yydb/yydb-client';
+export { checkSchema, createMemorySession, initWasm, introspectSchema, openPersistentSession, queryMemory, resetWasmBindingForTests, yydbVersion, } from './binding.js';
+export { defineMicro, MicroSessionRegistry } from '../shared/micro.js';
+export * from '../shared/vos.js';

package/package.json

@@ -1,41 +1,38 @@
 {
-  "name": "@yydb/yydb",
-  "version": "0.0.12",
-  "description": "YYDB Node embedded engine and CLI",
-  "license": "MPL-2.0",
-  "type": "module",
   "bin": {
     "yydb": "./dist/cli.js"
   },
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "bugs": {
+    "url": "https://github.com/yy-database/yydb.rs/issues"
+  },
+  "dependencies": {
+    "@vmz/commander": "^0.3.5",
+    "@vmz/diagnostic": "^0.3.5",
+    "@voml/vos": "^0.0.1"
+  },
+  "description": "YYDB Node embedded engine and CLI",
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "~5.3.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
     },
     "./cli": {
-      "types": "./dist/cli.d.ts",
-      "import": "./dist/cli.js"
+      "import": "./dist/cli.js",
+      "types": "./dist/cli.d.ts"
     }
   },
   "files": [
     "dist",
     "README.md"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "test": "pnpm run build && node --experimental-strip-types --test src/**/*.test.ts"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/yy-database/yydb.git",
-    "directory": "projects/packages/yydb"
-  },
-  "homepage": "https://github.com/yy-database/yydb/tree/dev/projects/packages/yydb#readme",
-  "bugs": {
-    "url": "https://github.com/yy-database/yydb/issues"
-  },
+  "homepage": "https://github.com/yy-database/yydb.rs/tree/dev/projects/packages/yydb#readme",
   "keywords": [
     "yydb",
     "vos",
@@ -43,25 +40,28 @@
     "embedded",
     "typescript"
   ],
+  "license": "MPL-2.0",
+  "main": "./dist/index.js",
+  "name": "@yydb/yydb",
+  "optionalDependencies": {
+    "@yydb/yydb-darwin-arm64": "0.0.15",
+    "@yydb/yydb-darwin-x64": "0.0.15",
+    "@yydb/yydb-linux-x64": "0.0.15",
+    "@yydb/yydb-win32-x64": "0.0.15"
+  },
   "publishConfig": {
     "access": "public"
   },
-  "dependencies": {
-    "@vmz/commander": "^0.3.5",
-    "@vmz/diagnostic": "^0.3.5",
-    "@voml/vos": "^0.0.1"
-  },
-  "devDependencies": {
-    "@types/node": "^20.10.0",
-    "typescript": "~5.3.0"
+  "repository": {
+    "directory": "projects/packages/yydb",
+    "type": "git",
+    "url": "git+https://github.com/yy-database/yydb.rs.git"
   },
-  "engines": {
-    "node": ">=18"
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "pnpm run build && node --experimental-strip-types --test src/**/*.test.ts"
   },
-  "optionalDependencies": {
-    "@yydb/yydb-darwin-arm64": "0.0.12",
-    "@yydb/yydb-darwin-x64": "0.0.12",
-    "@yydb/yydb-linux-x64": "0.0.12",
-    "@yydb/yydb-win32-x64": "0.0.12"
-  }
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "version": "0.0.15"
 }