@moyodb/sdk 0.0.0-alpha.1

package/dist/change-events.d.ts

@@ -0,0 +1,29 @@
+import type { DbChange } from './types';
+export interface StoreChangeSet {
+    store: string;
+    changes: DbChange[];
+}
+export interface CommitAppliedEvent {
+    type: 'commit_applied';
+    dbName: string;
+    txid: number;
+    stores: StoreChangeSet[];
+}
+export interface OwnerChangedEvent {
+    type: 'owner_changed';
+    dbName: string;
+    txid: null;
+}
+export interface DbClosedEvent {
+    type: 'db_closed';
+    dbName: string;
+    txid: null;
+}
+export interface DbDeletedEvent {
+    type: 'db_deleted';
+    dbName: string;
+    txid: null;
+}
+export type WorkerBroadcastEvent = CommitAppliedEvent | OwnerChangedEvent | DbClosedEvent | DbDeletedEvent;
+export declare function isCommitAppliedEvent(value: unknown): value is CommitAppliedEvent;
+//# sourceMappingURL=change-events.d.ts.map

package/dist/change-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-events.d.ts","sourceRoot":"","sources":["../src/change-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,QAAQ,EAAE,CAAC;CACvB;AACD,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,EAAE,CAAC;CAC5B;AACD,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,CAAC;CACd;AACD,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,CAAC;CACd;AACD,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,CAAC;CACd;AACD,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,aAAa,GAAG,cAAc,CAAC;AAY3G,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAShF"}

package/dist/codec.d.ts

@@ -0,0 +1,17 @@
+import type { Range } from './types';
+export type CompoundKeyPart = string | number | boolean | null | Uint8Array;
+export type IndexKeyPrimitive = CompoundKeyPart;
+export declare function utf8Encode(value: string): Uint8Array;
+export declare function utf8Decode(bytes: Uint8Array): string;
+export declare function jsonEncode(value: unknown): Uint8Array;
+export declare function jsonDecode<T>(bytes: Uint8Array): T;
+export declare function u64Key(value: bigint | number): Uint8Array;
+export declare function indexKey(value: CompoundKeyPart | ReadonlyArray<CompoundKeyPart>): Uint8Array;
+export declare function compoundKey(...parts: CompoundKeyPart[]): Uint8Array;
+export declare function encodeIndexScalar(value: IndexKeyPrimitive): Uint8Array;
+export declare function encodeCompoundKeyParts(parts: ReadonlyArray<Uint8Array>): Uint8Array;
+export declare function splitCompoundKey(key: Uint8Array): Uint8Array[];
+export declare function prefixSuccessor(prefix: Uint8Array): Uint8Array | null;
+export declare function prefixRange(prefix: Uint8Array): Range;
+export declare function compoundKeyRange(...parts: CompoundKeyPart[]): Range;
+//# sourceMappingURL=codec.d.ts.map

package/dist/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../src/codec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAarC,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,UAAU,CAAC;AAC5E,MAAM,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAChD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAEpD;AACD,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEpD;AACD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAErD;AACD,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,GAAG,CAAC,CAElD;AACD,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CASzD;AACD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,aAAa,CAAC,eAAe,CAAC,GAAG,UAAU,CAK5F;AACD,wBAAgB,WAAW,CAAC,GAAG,KAAK,EAAE,eAAe,EAAE,GAAG,UAAU,CAEnE;AACD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,UAAU,CAEtE;AACD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,UAAU,CAEnF;AACD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,UAAU,EAAE,CA2B9D;AACD,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CASrE;AACD,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK,CAGrD;AACD,wBAAgB,gBAAgB,CAAC,GAAG,KAAK,EAAE,eAAe,EAAE,GAAG,KAAK,CAEnE"}

package/dist/compression.d.ts

@@ -0,0 +1,11 @@
+import type { CompressionKind } from './types';
+export type CompressionOption = CompressionKind | false;
+export declare const STORE_VALUE_COMPRESSION_THRESHOLD = 1024;
+export declare function compressionFromStoreFlags(flags: number): CompressionOption;
+export declare function encodeStoreValueRecord(value: Uint8Array, compression: CompressionOption): Promise<Uint8Array>;
+export declare function decodeStoreValueRecord(value: Uint8Array, options: {
+    strict: boolean;
+}): Promise<Uint8Array>;
+export declare function wrapSnapshotWithCompression(snapshot: Uint8Array, compression: CompressionOption): Promise<Uint8Array>;
+export declare function unwrapSnapshotCompression(snapshot: Uint8Array): Promise<Uint8Array>;
+//# sourceMappingURL=compression.d.ts.map

package/dist/compression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.d.ts","sourceRoot":"","sources":["../src/compression.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG,KAAK,CAAC;AAUxD,eAAO,MAAM,iCAAiC,OAAO,CAAC;AA6KtD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAY1E;AACD,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAYnH;AACD,wBAAsB,sBAAsB,CACxC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE;IACL,MAAM,EAAE,OAAO,CAAC;CACnB,GACF,OAAO,CAAC,UAAU,CAAC,CAqDrB;AACD,wBAAsB,2BAA2B,CAC7C,QAAQ,EAAE,UAAU,EACpB,WAAW,EAAE,iBAAiB,GAC/B,OAAO,CAAC,UAAU,CAAC,CAMrB;AACD,wBAAsB,yBAAyB,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAmCzF"}

package/dist/demo.d.ts

@@ -0,0 +1,21 @@
+import { compoundKey, compoundKeyRange, deleteDB, indexKey, jsonDecode, jsonEncode, openDB, prefixRange, prefixSuccessor, splitCompoundKey, unsafeDebugCrashWorker, utf8Decode, utf8Encode } from './index';
+declare global {
+    interface Window {
+        moyodb: {
+            openDB: typeof openDB;
+            deleteDB: typeof deleteDB;
+            utf8Encode: typeof utf8Encode;
+            utf8Decode: typeof utf8Decode;
+            jsonEncode: typeof jsonEncode;
+            jsonDecode: typeof jsonDecode;
+            indexKey: typeof indexKey;
+            compoundKey: typeof compoundKey;
+            splitCompoundKey: typeof splitCompoundKey;
+            prefixRange: typeof prefixRange;
+            prefixSuccessor: typeof prefixSuccessor;
+            compoundKeyRange: typeof compoundKeyRange;
+            unsafeDebugCrashWorker: typeof unsafeDebugCrashWorker;
+        };
+    }
+}
+//# sourceMappingURL=demo.d.ts.map

package/dist/demo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.d.ts","sourceRoot":"","sources":["../src/demo.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,UAAU,EACV,MAAM,EACN,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,UAAU,EACV,UAAU,EAEb,MAAM,SAAS,CAAC;AAEjB,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,MAAM;QACZ,MAAM,EAAE;YACJ,MAAM,EAAE,OAAO,MAAM,CAAC;YACtB,QAAQ,EAAE,OAAO,QAAQ,CAAC;YAC1B,UAAU,EAAE,OAAO,UAAU,CAAC;YAC9B,UAAU,EAAE,OAAO,UAAU,CAAC;YAC9B,UAAU,EAAE,OAAO,UAAU,CAAC;YAC9B,UAAU,EAAE,OAAO,UAAU,CAAC;YAC9B,QAAQ,EAAE,OAAO,QAAQ,CAAC;YAC1B,WAAW,EAAE,OAAO,WAAW,CAAC;YAChC,gBAAgB,EAAE,OAAO,gBAAgB,CAAC;YAC1C,WAAW,EAAE,OAAO,WAAW,CAAC;YAChC,eAAe,EAAE,OAAO,eAAe,CAAC;YACxC,gBAAgB,EAAE,OAAO,gBAAgB,CAAC;YAC1C,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;SACzD,CAAC;KACL;CACJ"}

package/dist/engine/README.md

@@ -0,0 +1,56 @@
+<p align="center">
+  <img
+    width="100%"
+    src="https://capsule-render.vercel.app/api?type=waving&amp;height=220&amp;color=0:0B1220,50:1E1B4B,100:4F46E5&amp;text=MoyoDB&amp;fontColor=E2E8F0&amp;fontSize=54&amp;fontAlignY=50"
+    alt="Header banner"
+  />
+</p>
+
+<p align="center">
+  <img alt="Rust" src="https://img.shields.io/badge/Rust-1E293B?style=for-the-badge" />
+  <img alt="WebAssembly" src="https://img.shields.io/badge/WebAssembly-1E293B?style=for-the-badge" />
+  <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-1E293B?style=for-the-badge" />
+  <img alt="JavaScript" src="https://img.shields.io/badge/JavaScript-1E293B?style=for-the-badge" />
+  <img alt="Lean 4" src="https://img.shields.io/badge/Lean%204-1E293B?style=for-the-badge" />
+  <img alt="npm" src="https://img.shields.io/badge/npm-1E293B?style=for-the-badge" />
+</p>
+
+Experimental Rust/WASM transactional key-value storage engine for browser apps.
+
+It provides ordered byte keys, range scans, snapshots, TTL, recovery checks, and a TypeScript SDK that talks to a dedicated Worker-backed runtime over OPFS.
+
+> Status: **alpha / pre-public release**. MoyoDB is useful for experiments and early integrations. Do not use it for production data without your own durability and compatibility validation.
+
+## Quick start
+
+```bash
+rustup target add wasm32-unknown-unknown
+cargo install --locked wasm-pack --version 0.15.0
+npm ci
+npm run build
+npm run test:sdk
+```
+
+```ts
+import { openDB, utf8Decode, utf8Encode } from '@moyodb/sdk';
+
+const db = await openDB('app', { requestPersistence: false });
+await db.createStore('kv');
+await db.put('kv', utf8Encode('hello'), utf8Encode('world'));
+
+const value = await db.get('kv', utf8Encode('hello'));
+console.log(value ? utf8Decode(value) : null);
+
+await db.close();
+```
+
+The npm package name is `@moyodb/sdk`. The human-facing project name is **MoyoDB**.
+
+## Limitations
+
+- Alpha software; storage format and SDK API may still change.
+- Browser-only runtime; there is no Node.js persistence API.
+- Requires OPFS and Worker-side sync access handles.
+- One active owner per database and one write transaction at a time.
+- Raw byte keys and values; no SQL/query planner.
+- No cloud sync, multi-tab concurrent writers, SharedWorker runtime, or IndexedDB fallback.

package/dist/engine/moyodb_engine.d.ts

@@ -0,0 +1,127 @@
+/* tslint:disable */
+/* eslint-disable */
+
+export class WasmEngine {
+    free(): void;
+    [Symbol.dispose](): void;
+    apply_batch(tx_id: bigint, store: string, ops: any): any;
+    apply_batch_packed(tx_id: bigint, store: string, ops: Uint8Array): any;
+    begin_tx(mode: string): bigint;
+    changes_since(tx_id: bigint, options: any): any;
+    clear_store(tx_id: bigint, name: string): void;
+    close(): void;
+    commit_tx(tx_id: bigint): bigint;
+    create_store(tx_id: bigint, name: string, options: any): void;
+    delete(tx_id: bigint, store: string, key: Uint8Array): boolean;
+    delete_many(tx_id: bigint, store: string, keys: any): any;
+    delete_many_packed(tx_id: bigint, store: string, keys: Uint8Array): any;
+    drop_store(tx_id: bigint, name: string): void;
+    export_snapshot(): Uint8Array;
+    get(tx_id: bigint, store: string, key: Uint8Array): any;
+    get_many(tx_id: bigint, store: string, keys: any): any;
+    get_many_packed(tx_id: bigint, store: string, keys: Uint8Array): any;
+    get_schema_version(): bigint;
+    has(tx_id: bigint, store: string, key: Uint8Array): boolean;
+    import_snapshot(data: Uint8Array): bigint;
+    list_store_configs(): any;
+    list_stores(): any;
+    constructor();
+    open(name: string, options: any): Promise<void>;
+    openGeneration(name: string, generation_name: string, options: any): Promise<void>;
+    put(tx_id: bigint, store: string, key: Uint8Array, value: Uint8Array, options: any): void;
+    put_many(tx_id: bigint, store: string, entries: any, options: any): any;
+    put_many_packed(tx_id: bigint, store: string, entries: Uint8Array, options: any): any;
+    reset(): bigint;
+    rollback_tx(tx_id: bigint): void;
+    scan(tx_id: bigint, store: string, range: any): any;
+    set_failpoint(failpoint: any): void;
+    set_schema_version(tx_id: bigint, version: bigint): void;
+    stats(): any;
+}
+
+export function cleanupInactiveEntries(name: string): Promise<void>;
+
+export function dbDirectorySize(name: string): Promise<number>;
+
+export function deleteDB(name: string): Promise<void>;
+
+export function prepareRebuildTarget(name: string): Promise<any>;
+
+export function swapActiveGeneration(name: string, generation_name: string): Promise<void>;
+
+export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
+
+export interface InitOutput {
+    readonly memory: WebAssembly.Memory;
+    readonly __wbg_wasmengine_free: (a: number, b: number) => void;
+    readonly cleanupInactiveEntries: (a: number, b: number) => any;
+    readonly dbDirectorySize: (a: number, b: number) => any;
+    readonly deleteDB: (a: number, b: number) => any;
+    readonly prepareRebuildTarget: (a: number, b: number) => any;
+    readonly swapActiveGeneration: (a: number, b: number, c: number, d: number) => any;
+    readonly wasmengine_apply_batch: (a: number, b: bigint, c: number, d: number, e: any) => [number, number, number];
+    readonly wasmengine_apply_batch_packed: (a: number, b: bigint, c: number, d: number, e: any) => [number, number, number];
+    readonly wasmengine_begin_tx: (a: number, b: number, c: number) => [bigint, number, number];
+    readonly wasmengine_changes_since: (a: number, b: bigint, c: any) => [number, number, number];
+    readonly wasmengine_clear_store: (a: number, b: bigint, c: number, d: number) => [number, number];
+    readonly wasmengine_close: (a: number) => [number, number];
+    readonly wasmengine_commit_tx: (a: number, b: bigint) => [bigint, number, number];
+    readonly wasmengine_create_store: (a: number, b: bigint, c: number, d: number, e: any) => [number, number];
+    readonly wasmengine_delete: (a: number, b: bigint, c: number, d: number, e: number, f: number) => [number, number, number];
+    readonly wasmengine_delete_many: (a: number, b: bigint, c: number, d: number, e: any) => [number, number, number];
+    readonly wasmengine_delete_many_packed: (a: number, b: bigint, c: number, d: number, e: any) => [number, number, number];
+    readonly wasmengine_drop_store: (a: number, b: bigint, c: number, d: number) => [number, number];
+    readonly wasmengine_export_snapshot: (a: number) => [number, number, number];
+    readonly wasmengine_get: (a: number, b: bigint, c: number, d: number, e: number, f: number) => [number, number, number];
+    readonly wasmengine_get_many: (a: number, b: bigint, c: number, d: number, e: any) => [number, number, number];
+    readonly wasmengine_get_many_packed: (a: number, b: bigint, c: number, d: number, e: any) => [number, number, number];
+    readonly wasmengine_get_schema_version: (a: number) => [bigint, number, number];
+    readonly wasmengine_has: (a: number, b: bigint, c: number, d: number, e: number, f: number) => [number, number, number];
+    readonly wasmengine_import_snapshot: (a: number, b: number, c: number) => [bigint, number, number];
+    readonly wasmengine_list_store_configs: (a: number) => [number, number, number];
+    readonly wasmengine_list_stores: (a: number) => [number, number, number];
+    readonly wasmengine_new: () => number;
+    readonly wasmengine_open: (a: number, b: number, c: number, d: any) => any;
+    readonly wasmengine_openGeneration: (a: number, b: number, c: number, d: number, e: number, f: any) => any;
+    readonly wasmengine_put: (a: number, b: bigint, c: number, d: number, e: number, f: number, g: number, h: number, i: any) => [number, number];
+    readonly wasmengine_put_many: (a: number, b: bigint, c: number, d: number, e: any, f: any) => [number, number, number];
+    readonly wasmengine_put_many_packed: (a: number, b: bigint, c: number, d: number, e: any, f: any) => [number, number, number];
+    readonly wasmengine_reset: (a: number) => [bigint, number, number];
+    readonly wasmengine_rollback_tx: (a: number, b: bigint) => [number, number];
+    readonly wasmengine_scan: (a: number, b: bigint, c: number, d: number, e: any) => [number, number, number];
+    readonly wasmengine_set_failpoint: (a: number, b: any) => [number, number];
+    readonly wasmengine_set_schema_version: (a: number, b: bigint, c: bigint) => [number, number];
+    readonly wasmengine_stats: (a: number) => [number, number, number];
+    readonly wasm_bindgen__convert__closures_____invoke__h0b808fc55658bd50: (a: number, b: number, c: any) => [number, number];
+    readonly wasm_bindgen__convert__closures_____invoke__h694ddb4a279886ac: (a: number, b: number, c: any, d: any) => 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_destroy_closure: (a: number, b: number) => void;
+    readonly __externref_table_dealloc: (a: number) => void;
+    readonly __wbindgen_start: () => void;
+}
+
+export type SyncInitInput = BufferSource | WebAssembly.Module;
+
+/**
+ * Instantiates the given `module`, which can either be bytes or
+ * a precompiled `WebAssembly.Module`.
+ *
+ * @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
+ *
+ * @returns {InitOutput}
+ */
+export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
+
+/**
+ * If `module_or_path` is {RequestInfo} or {URL}, makes a request and
+ * for everything else, calls `WebAssembly.instantiate` directly.
+ *
+ * @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
+ *
+ * @returns {Promise<InitOutput>}
+ */
+export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;