@yydb/yydb 0.0.15 → 0.0.17

package/dist/node/resolve-bin.js

@@ -1,62 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-/** Map Node platform/arch to optionalDependency package suffix. */
-export function platformKey(platform = process.platform, arch = process.arch) {
-    if (platform === 'win32' && arch === 'x64')
-        return 'win32-x64';
-    if (platform === 'linux' && arch === 'x64')
-        return 'linux-x64';
-    if (platform === 'darwin' && arch === 'x64')
-        return 'darwin-x64';
-    if (platform === 'darwin' && arch === 'arm64')
-        return 'darwin-arm64';
-    return null;
-}
-/** Native binding filename inside each `@yydb/yydb-<platform>` package `lib/`. */
-export function nativeBindingName(key) {
-    switch (key) {
-        case 'win32-x64':
-            return 'yydb-win32-x64-msvc.node';
-        case 'linux-x64':
-            return 'yydb-linux-x64-gnu.node';
-        case 'darwin-x64':
-            return 'yydb-darwin-x64.node';
-        case 'darwin-arm64':
-            return 'yydb-darwin-arm64.node';
-    }
-}
-function existsFile(filePath) {
-    try {
-        fs.accessSync(filePath, fs.constants.F_OK);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Resolve the TypeScript `yydb` CLI entry script.
- * Order: `YYDB_CLI` → this package `dist/cli.js`.
- */
-export function resolveYydbCli() {
-    const fromEnv = process.env.YYDB_CLI?.trim();
-    if (fromEnv) {
-        if (!existsFile(fromEnv)) {
-            throw new Error(`YYDB_CLI points to missing script: ${fromEnv}`);
-        }
-        return path.resolve(fromEnv);
-    }
-    const here = path.dirname(fileURLToPath(import.meta.url));
-    const candidate = path.join(here, 'cli.js');
-    if (!existsFile(candidate)) {
-        throw new Error('YYDB CLI script not found. Build `@yydb/yydb` (`pnpm --filter @yydb/yydb build`) or set YYDB_CLI.');
-    }
-    return candidate;
-}
-/**
- * @deprecated Use {@link resolveYydbCli}. Kept for callers that still import this name.
- */
-export function resolveYydbBinary() {
-    return resolveYydbCli();
-}

package/dist/resolve-bin.d.ts

@@ -1,15 +0,0 @@
-/// <reference types="node" />
-export type PlatformKey = 'win32-x64' | 'linux-x64' | 'darwin-x64' | 'darwin-arm64';
-/** Map Node platform/arch to optionalDependency package suffix. */
-export declare function platformKey(platform?: NodeJS.Platform, arch?: NodeJS.Architecture): PlatformKey | null;
-/** Native binding filename inside each `@yydb/yydb-<platform>` package `lib/`. */
-export declare function nativeBindingName(key: PlatformKey): string;
-/**
- * Resolve the TypeScript `yydb` CLI entry script.
- * Order: `YYDB_CLI` → this package `dist/cli.js`.
- */
-export declare function resolveYydbCli(): string;
-/**
- * @deprecated Use {@link resolveYydbCli}. Kept for callers that still import this name.
- */
-export declare function resolveYydbBinary(): string;

package/dist/resolve-bin.js

@@ -1,62 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-/** Map Node platform/arch to optionalDependency package suffix. */
-export function platformKey(platform = process.platform, arch = process.arch) {
-    if (platform === 'win32' && arch === 'x64')
-        return 'win32-x64';
-    if (platform === 'linux' && arch === 'x64')
-        return 'linux-x64';
-    if (platform === 'darwin' && arch === 'x64')
-        return 'darwin-x64';
-    if (platform === 'darwin' && arch === 'arm64')
-        return 'darwin-arm64';
-    return null;
-}
-/** Native binding filename inside each `@yydb/yydb-<platform>` package `lib/`. */
-export function nativeBindingName(key) {
-    switch (key) {
-        case 'win32-x64':
-            return 'yydb-win32-x64-msvc.node';
-        case 'linux-x64':
-            return 'yydb-linux-x64-gnu.node';
-        case 'darwin-x64':
-            return 'yydb-darwin-x64.node';
-        case 'darwin-arm64':
-            return 'yydb-darwin-arm64.node';
-    }
-}
-function existsFile(filePath) {
-    try {
-        fs.accessSync(filePath, fs.constants.F_OK);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Resolve the TypeScript `yydb` CLI entry script.
- * Order: `YYDB_CLI` → this package `dist/cli.js`.
- */
-export function resolveYydbCli() {
-    const fromEnv = process.env.YYDB_CLI?.trim();
-    if (fromEnv) {
-        if (!existsFile(fromEnv)) {
-            throw new Error(`YYDB_CLI points to missing script: ${fromEnv}`);
-        }
-        return path.resolve(fromEnv);
-    }
-    const here = path.dirname(fileURLToPath(import.meta.url));
-    const candidate = path.join(here, 'cli.js');
-    if (!existsFile(candidate)) {
-        throw new Error('YYDB CLI script not found. Build `@yydb/yydb` (`pnpm --filter @yydb/yydb build`) or set YYDB_CLI.');
-    }
-    return candidate;
-}
-/**
- * @deprecated Use {@link resolveYydbCli}. Kept for callers that still import this name.
- */
-export function resolveYydbBinary() {
-    return resolveYydbCli();
-}

package/dist/shared/wasm-envelope.d.ts

@@ -1,41 +0,0 @@
-/** Parsed `{ ok, rows, error, code }` envelope from wasm VOS calls. */
-export type WasmRowsResult = {
-    ok: boolean;
-    rows: Record<string, unknown>[];
-    error: string | null;
-    code: string | null;
-};
-/** Parsed `{ ok, schema, error, code }` envelope from wasm `getSchema`. */
-export type WasmSchemaResult = {
-    ok: boolean;
-    schema: {
-        version: number;
-        document: string;
-    } | null;
-    error: string | null;
-    code: string | null;
-};
-/** Parsed `{ ok, value, error, code }` envelope from wasm `get`. */
-export type WasmKvGetResult = {
-    ok: boolean;
-    value: number[] | null;
-    error: string | null;
-    code: string | null;
-};
-/** Parsed `{ ok, value, error, code }` envelope from wasm `callScalar`. */
-export type WasmScalarResult = {
-    ok: boolean;
-    value: string | number | boolean | null;
-    error: string | null;
-    code: string | null;
-};
-export type WireScalarValue = string | number | boolean | null;
-export type SchemaVersion = {
-    version: number;
-    document: string;
-};
-export declare function parseWasmRowsResult(payload: string, operation: string): WasmRowsResult;
-export declare function parseWasmUnitResult(payload: string, operation: string): void;
-export declare function parseWasmSchemaResult(payload: string, operation: string): SchemaVersion | null;
-export declare function parseWasmScalarResult(payload: string, operation: string): WireScalarValue;
-export declare function parseWasmKvGetResult(payload: string, operation: string): Uint8Array | null;

package/dist/shared/wasm-envelope.js

@@ -1,56 +0,0 @@
-import { YydbError, YydbErrorCodes } from '@yydb/yydb-client';
-function parseJson(payload, operation) {
-    try {
-        return JSON.parse(payload);
-    }
-    catch (cause) {
-        throw new YydbError(YydbErrorCodes.clientDecodeFailure, `${operation}: invalid JSON envelope`, { operation, cause });
-    }
-}
-/**
- * Build the error for a failed wasm envelope. The Rust core always sends a
- * stable `code`; a missing one means the wasm artifact is stale, which is a
- * decode failure rather than an engine failure.
- */
-function envelopeError(envelope, operation) {
-    const code = envelope.code ?? YydbErrorCodes.clientDecodeFailure;
-    const message = envelope.error ?? `${operation}: wasm envelope carried no message`;
-    return new YydbError(code, message, { operation });
-}
-export function parseWasmRowsResult(payload, operation) {
-    const parsed = parseJson(payload, operation);
-    if (!parsed.ok) {
-        throw envelopeError(parsed, operation);
-    }
-    return parsed;
-}
-export function parseWasmUnitResult(payload, operation) {
-    const parsed = parseJson(payload, operation);
-    if (!parsed.ok) {
-        throw envelopeError(parsed, operation);
-    }
-}
-export function parseWasmSchemaResult(payload, operation) {
-    const parsed = parseJson(payload, operation);
-    if (!parsed.ok) {
-        throw envelopeError(parsed, operation);
-    }
-    return parsed.schema;
-}
-export function parseWasmScalarResult(payload, operation) {
-    const parsed = parseJson(payload, operation);
-    if (!parsed.ok) {
-        throw envelopeError(parsed, operation);
-    }
-    return parsed.value;
-}
-export function parseWasmKvGetResult(payload, operation) {
-    const parsed = parseJson(payload, operation);
-    if (!parsed.ok) {
-        throw envelopeError(parsed, operation);
-    }
-    if (parsed.value === null) {
-        return null;
-    }
-    return Uint8Array.from(parsed.value);
-}

package/dist/udf-types.d.ts

@@ -1,26 +0,0 @@
-/** Phase-1 scalar UDF wire kinds aligned with `yydb-udf`. */
-export type UdfScalarKind = 'i64' | 'bool' | 'text' | 'null';
-/** Runtime type descriptor used in `defineMicro` contracts. */
-export interface UdfTypeDescriptor<T = unknown> {
-    readonly kind: UdfScalarKind;
-    /** Phantom type for author-side inference only. */
-    readonly _type?: T;
-}
-/** `i64` argument or return descriptor. */
-export declare function i64(): UdfTypeDescriptor<number>;
-/** `bool` argument or return descriptor. */
-export declare function bool(): UdfTypeDescriptor<boolean>;
-/** `text` argument or return descriptor. */
-export declare function text(): UdfTypeDescriptor<string>;
-/** `null` return descriptor. */
-export declare function nullType(): UdfTypeDescriptor<null>;
-/** Maps descriptor tuple types to positional argument types. */
-export type InferUdfArgs<T extends readonly UdfTypeDescriptor[]> = {
-    [K in keyof T]: T[K] extends UdfTypeDescriptor<infer V> ? V : never;
-};
-/** Maps a return descriptor to its value type. */
-export type InferUdfReturn<T extends UdfTypeDescriptor> = T extends UdfTypeDescriptor<infer V> ? V : never;
-/** Session micro effect surface (Phase 1: pure only). */
-export type MicroEffect = 'pure';
-/** Invocation mode stored with the definition for future batch host calls. */
-export type MicroInvocationMode = 'scalar' | 'batch';

package/dist/udf-types.js

@@ -1,16 +0,0 @@
-/** `i64` argument or return descriptor. */
-export function i64() {
-    return { kind: 'i64' };
-}
-/** `bool` argument or return descriptor. */
-export function bool() {
-    return { kind: 'bool' };
-}
-/** `text` argument or return descriptor. */
-export function text() {
-    return { kind: 'text' };
-}
-/** `null` return descriptor. */
-export function nullType() {
-    return { kind: 'null' };
-}

package/dist/wasm/binding.d.ts

@@ -1 +0,0 @@
-export { checkSchema, createMemorySession, initWasm, introspectSchema, openPersistentSession, queryMemory, resetWasmBindingForTests, yydbVersion, type CheckSchemaResult, type InitWasmOptions, type WasmInitInput, type WasmSession, } from '@yydb/yydb-unknown-wasm32';

package/dist/wasm/binding.js

@@ -1 +0,0 @@
-export { checkSchema, createMemorySession, initWasm, introspectSchema, openPersistentSession, queryMemory, resetWasmBindingForTests, yydbVersion, } from '@yydb/yydb-unknown-wasm32';

package/dist/wasm/database.d.ts

@@ -1,54 +0,0 @@
-import { defineMicro as buildMicro, type DefinedMicro, type MicroHandle } from '../shared/micro.js';
-import type { UdfScalarDescriptor } from '../shared/udf-types.js';
-import { type SchemaVersion } from '../shared/wasm-envelope.js';
-import { type CheckSchemaResult, type InitWasmOptions } from './binding.js';
-export type WasmOpenOptions = InitWasmOptions;
-/**
- * Browser-facing YYDB handle backed by an in-process wasm session.
- * Use `open` for OPFS-backed paths and `openInMemory` for ephemeral state.
- */
-export declare class Database {
-    readonly path: string;
-    private session;
-    private readonly kind;
-    private readonly microRegistry;
-    private constructor();
-    /** Open an OPFS-backed database at `path` (for example `app.yydb`). */
-    static open(path: string, options?: WasmOpenOptions): Promise<Database>;
-    /** Open a stateful in-memory database session. */
-    static openInMemory(options?: WasmOpenOptions): Promise<Database>;
-    /** Library version from the wasm binding. */
-    version(): string;
-    /** Engine version string (Node API parity). */
-    serverVersion(): Promise<string>;
-    /** Database info text (`path=…\\n…`), matching the YY wire `Info` reply. */
-    info(): Promise<string>;
-    /** Parse and validate a VOS schema document without opening a session. */
-    checkSchema(source: string): CheckSchemaResult;
-    /** Persist schema document. `version` is accepted for Node API parity; wasm uses the document body. */
-    ensureSchema(_version: number, document: string): Promise<void>;
-    getSchema(): Promise<SchemaVersion | null>;
-    get(key: string): Promise<Uint8Array | null>;
-    put(key: string, value: Uint8Array | string): Promise<void>;
-    /** VOS read pipeline (for example `User.filter(x => x.active).collect()`). */
-    query(source: string): Record<string, unknown>[];
-    /** Unit-valued VOS write programs (for example `User { … }.insert()`). */
-    execute(source: string): void;
-    /**
-     * Build a typed session-local micro definition. Does not register it with
-     * the engine until `registerMicro` is called.
-     */
-    defineMicro<TArgs extends readonly UdfScalarDescriptor[], TReturn extends UdfScalarDescriptor>(definition: Parameters<typeof buildMicro<TArgs, TReturn>>[0]): DefinedMicro<TArgs, TReturn>;
-    /**
-     * Install a `defineMicro` definition into the current session registry and
-     * sync metadata to the embedded engine. Host micros are session-local.
-     */
-    registerMicro<TArgs extends readonly UdfScalarDescriptor[], TReturn extends UdfScalarDescriptor>(definition: DefinedMicro<TArgs, TReturn>): Promise<MicroHandle>;
-    /** Invoke a registered scalar UDF on the embedded engine. */
-    callScalar(name: string, version: number, args: readonly (string | number | boolean | null)[]): Promise<string | number | boolean | null>;
-    /** Whether this handle owns a persistent OPFS session. */
-    isPersistent(): boolean;
-    /** Close the embedded session. Idempotent; further calls fail with `yydb.session.closed`. */
-    close(): Promise<void>;
-    private requireSession;
-}

package/dist/wasm/database.js

@@ -1,118 +0,0 @@
-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

@@ -1,8 +0,0 @@
-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

@@ -1,5 +0,0 @@
-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';