@korajs/store 0.3.2 → 0.5.0

package/dist/types-DepnRDk_.d.ts

@@ -0,0 +1,212 @@
+import { SchemaDefinition, Operation, KoraEventEmitter } from '@korajs/core';
+
+/**
+ * Transaction interface for executing multiple operations atomically.
+ */
+interface Transaction {
+    execute(sql: string, params?: unknown[]): Promise<void>;
+    query<T>(sql: string, params?: unknown[]): Promise<T[]>;
+}
+/**
+ * Migration plan containing SQL statements and optional data transforms.
+ */
+interface MigrationPlan {
+    statements: string[];
+    transforms?: Array<(row: Record<string, unknown>) => Record<string, unknown>>;
+}
+/**
+ * Storage adapter interface. All storage backends must implement this.
+ * Operations are async to support both sync (better-sqlite3) and async (IndexedDB, WASM) backends.
+ */
+interface StorageAdapter {
+    /** Open or create the database */
+    open(schema: SchemaDefinition): Promise<void>;
+    /** Close the database and release resources */
+    close(): Promise<void>;
+    /** Execute a write query (INSERT, UPDATE, DELETE) within a transaction */
+    execute(sql: string, params?: unknown[]): Promise<void>;
+    /** Execute a read query (SELECT) */
+    query<T>(sql: string, params?: unknown[]): Promise<T[]>;
+    /** Execute multiple operations atomically */
+    transaction(fn: (tx: Transaction) => Promise<void>): Promise<void>;
+    /** Apply a schema migration */
+    migrate(from: number, to: number, migration: MigrationPlan): Promise<void>;
+}
+/**
+ * Buffered SQL + operation produced during a transaction (before commit).
+ */
+interface TransactionBufferedEntry {
+    operation: Operation;
+    commands: Array<{
+        sql: string;
+        params: unknown[];
+    }>;
+    collection: string;
+}
+/**
+ * Batch passed to {@link LocalMutationHandler.commitTransaction} on commit.
+ */
+interface TransactionCommitBatch {
+    entries: TransactionBufferedEntry[];
+    transactionId: string;
+    mutationName?: string;
+}
+interface TransactionCommitResult {
+    operations: Operation[];
+    affectedCollections: Set<string>;
+}
+interface LocalMutationHandler {
+    insert(collection: string, data: Record<string, unknown>): Promise<CollectionRecord>;
+    update(collection: string, id: string, data: Record<string, unknown>): Promise<CollectionRecord>;
+    delete(collection: string, id: string): Promise<void>;
+    /**
+     * Commit a buffered transaction through the unified apply pipeline.
+     * When omitted, the store uses the built-in SQL commit path.
+     */
+    commitTransaction?(batch: TransactionCommitBatch): Promise<TransactionCommitResult>;
+}
+type StoreIsolation = 'shared' | 'per-tab';
+interface StoreConfig {
+    schema: SchemaDefinition;
+    adapter: StorageAdapter;
+    /** Database name used for per-tab node id keys. Defaults to 'kora-db'. */
+    dbName?: string;
+    /**
+     * `shared` (default): one node id per database in `_kora_meta`.
+     * `per-tab`: unique node id per browser tab via sessionStorage.
+     */
+    isolation?: StoreIsolation;
+    /** Optional node ID. If omitted, one is generated or loaded from the database. */
+    nodeId?: string;
+    /** Optional event emitter. When provided, local mutations emit 'operation:created' events. */
+    emitter?: KoraEventEmitter;
+    /** Routes local mutations through a unified apply pipeline when provided. */
+    localMutationHandler?: LocalMutationHandler;
+    /** Called when a reactive query subscription is registered (for sync query subsets). */
+    onQuerySubscribed?: (descriptor: QueryDescriptor) => () => void;
+}
+/**
+ * Operators for where clause conditions.
+ */
+interface WhereOperators {
+    $eq?: unknown;
+    $ne?: unknown;
+    $gt?: number | string;
+    $gte?: number | string;
+    $lt?: number | string;
+    $lte?: number | string;
+    $in?: unknown[];
+}
+/**
+ * Where clause: field name to value (shorthand for $eq) or WhereOperators.
+ */
+type WhereClause = Record<string, unknown | WhereOperators>;
+/**
+ * Order direction for sorting query results.
+ */
+type OrderByDirection = 'asc' | 'desc';
+/**
+ * Order-by clause: field name and optional direction.
+ */
+interface OrderByClause {
+    field: string;
+    direction: OrderByDirection;
+}
+/**
+ * Internal representation of a query to be compiled to SQL.
+ */
+interface QueryDescriptor {
+    collection: string;
+    where: WhereClause;
+    orderBy: OrderByClause[];
+    limit?: number;
+    offset?: number;
+    /** Relation names to include in results (for relational queries). */
+    include?: string[];
+    /** Resolved collection names for included relations (for subscription tracking). */
+    includeCollections?: string[];
+}
+/**
+ * Callback for reactive subscriptions. Receives the current result set.
+ */
+type SubscriptionCallback<T> = (results: T[]) => void;
+/**
+ * Serialized row in the operations log table.
+ */
+interface OperationRow {
+    id: string;
+    node_id: string;
+    type: string;
+    record_id: string;
+    data: string | null;
+    previous_data: string | null;
+    timestamp: string;
+    sequence_number: number;
+    causal_deps: string;
+    schema_version: number;
+}
+/**
+ * Record type returned from collection queries.
+ * Includes the id and mapped metadata fields.
+ */
+interface CollectionRecord {
+    id: string;
+    createdAt: number;
+    updatedAt: number;
+    [key: string]: unknown;
+}
+
+/**
+ * Internal row shape returned from SQL queries on collection tables.
+ */
+interface RawCollectionRow {
+    id: string;
+    _created_at: number;
+    _updated_at: number;
+    _version?: string;
+    _deleted: number;
+    [key: string]: unknown;
+}
+/**
+ * A registered subscription tracked by the SubscriptionManager.
+ */
+interface Subscription<T = CollectionRecord> {
+    id: string;
+    descriptor: QueryDescriptor;
+    callback: SubscriptionCallback<T>;
+    executeFn: () => Promise<T[]>;
+    lastResults: T[];
+}
+
+/**
+ * Options for applying a remote operation to materialized storage.
+ */
+interface ApplyRemoteOptions {
+    /** When true, a winning remote update clears soft-delete on the row. */
+    reactivateIfDeleted?: boolean;
+}
+/**
+ * Snapshot of a materialized row, including soft-deleted records.
+ */
+interface MaterializedRowSnapshot {
+    /** Deserialized application record (excludes tombstone metadata). */
+    record: CollectionRecord;
+    /** Whether the row is soft-deleted (_deleted = 1). */
+    deleted: boolean;
+}
+/**
+ * Metadata row from _kora_meta table.
+ */
+interface MetaRow {
+    key: string;
+    value: string;
+}
+/**
+ * Version vector row from _kora_version_vector table.
+ */
+interface VersionVectorRow {
+    node_id: string;
+    sequence_number: number;
+}
+
+export type { ApplyRemoteOptions as A, CollectionRecord as C, LocalMutationHandler as L, MigrationPlan as M, OperationRow as O, QueryDescriptor as Q, RawCollectionRow as R, StorageAdapter as S, Transaction as T, VersionVectorRow as V, WhereClause as W, MetaRow as a, Subscription as b, SubscriptionCallback as c, OrderByDirection as d, StoreConfig as e, MaterializedRowSnapshot as f, OrderByClause as g, StoreIsolation as h, TransactionBufferedEntry as i, TransactionCommitBatch as j, TransactionCommitResult as k, WhereOperators as l };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@korajs/store",
-  "version": "0.3.2",
+  "version": "0.5.0",
   "description": "Local storage engine for Kora.js with SQLite WASM, IndexedDB, and reactive queries",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -47,6 +47,16 @@
         "default": "./dist/adapters/sqlite-wasm-worker.cjs"
       }
     },
+    "./sqlite-wasm/shared-host": {
+      "import": {
+        "types": "./dist/adapters/sqlite-wasm-shared-host.d.ts",
+        "default": "./dist/adapters/sqlite-wasm-shared-host.js"
+      },
+      "require": {
+        "types": "./dist/adapters/sqlite-wasm-shared-host.d.cts",
+        "default": "./dist/adapters/sqlite-wasm-shared-host.cjs"
+      }
+    },
     "./indexeddb": {
       "import": {
         "types": "./dist/adapters/indexeddb.d.ts",
@@ -56,6 +66,16 @@
         "types": "./dist/adapters/indexeddb.d.cts",
         "default": "./dist/adapters/indexeddb.cjs"
       }
+    },
+    "./internal": {
+      "import": {
+        "types": "./dist/internal.d.ts",
+        "default": "./dist/internal.js"
+      },
+      "require": {
+        "types": "./dist/internal.d.cts",
+        "default": "./dist/internal.cjs"
+      }
     }
   },
   "files": [
@@ -63,7 +83,7 @@
   ],
   "dependencies": {
     "yjs": "^13.6.30",
-    "@korajs/core": "0.3.2"
+    "@korajs/core": "0.5.0"
   },
   "peerDependencies": {
     "@sqlite.org/sqlite-wasm": ">=3.51.0-build1"
@@ -87,6 +107,7 @@
     "build": "tsup",
     "dev": "tsup --watch",
     "test": "vitest run",
+    "test:benchmarks": "vitest run --config vitest.benchmark.config.ts",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
     "lint": "biome check .",

package/dist/chunk-DXKLAQ6P.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/adapters/sqlite-wasm-channel.ts"],"sourcesContent":["/// <reference lib=\"dom\" />\nimport { WorkerTimeoutError } from '../errors'\n\n// === Message Protocol ===\n\n/**\n * Request message sent from the main thread to the SQLite WASM worker.\n * Each request carries a unique `id` for response correlation.\n */\nexport type WorkerRequest =\n\t| { id: number; type: 'open'; ddlStatements: string[] }\n\t| { id: number; type: 'close' }\n\t| { id: number; type: 'execute'; sql: string; params?: unknown[] }\n\t| { id: number; type: 'query'; sql: string; params?: unknown[] }\n\t| { id: number; type: 'begin' }\n\t| { id: number; type: 'commit' }\n\t| { id: number; type: 'rollback' }\n\t| { id: number; type: 'migrate'; from: number; to: number; statements: string[] }\n\t| { id: number; type: 'export' }\n\t| { id: number; type: 'import'; data: Uint8Array }\n\n/**\n * Response message sent from the worker back to the main thread.\n * Matches the request `id` for correlation.\n */\nexport type WorkerResponse =\n\t| { id: number; type: 'success'; data?: unknown }\n\t| { id: number; type: 'error'; message: string; code: string; context?: Record<string, unknown> }\n\n// === WorkerBridge Interface ===\n\n/**\n * Abstraction over the communication channel with the SQLite WASM worker.\n * In browsers, this is backed by a real Web Worker via MessagePort.\n * In Node.js tests, this is backed by better-sqlite3 via MockWorkerBridge.\n */\nexport interface WorkerBridge {\n\t/** Send a request to the worker and wait for a response. */\n\tsend(request: WorkerRequest): Promise<WorkerResponse>\n\n\t/** Terminate the worker. Safe to call multiple times. */\n\tterminate(): void\n}\n\n// === Mutex ===\n\n/**\n * Async mutex for serializing transaction access across the async worker boundary.\n * Only one transaction may be active at a time.\n */\nexport class Mutex {\n\tprivate locked = false\n\tprivate waiters: Array<() => void> = []\n\n\t/**\n\t * Acquire the mutex. Returns a release function.\n\t * If the mutex is already held, the caller waits until it's released.\n\t */\n\tasync acquire(): Promise<() => void> {\n\t\tif (!this.locked) {\n\t\t\tthis.locked = true\n\t\t\treturn this.createRelease()\n\t\t}\n\n\t\treturn new Promise<() => void>((resolve) => {\n\t\t\tthis.waiters.push(() => {\n\t\t\t\tresolve(this.createRelease())\n\t\t\t})\n\t\t})\n\t}\n\n\tprivate createRelease(): () => void {\n\t\tlet released = false\n\t\treturn () => {\n\t\t\tif (released) return\n\t\t\treleased = true\n\t\t\tconst next = this.waiters.shift()\n\t\t\tif (next) {\n\t\t\t\tnext()\n\t\t\t} else {\n\t\t\t\tthis.locked = false\n\t\t\t}\n\t\t}\n\t}\n}\n\n// === WebWorkerBridge ===\n\n/**\n * WorkerBridge implementation for browser environments.\n * Communicates with an actual Web Worker running SQLite WASM.\n */\nexport class WebWorkerBridge implements WorkerBridge {\n\tprivate worker: Worker\n\tprivate pending = new Map<\n\t\tnumber,\n\t\t{ resolve: (r: WorkerResponse) => void; reject: (e: Error) => void }\n\t>()\n\tprivate nextId = 1\n\tprivate terminated = false\n\tprivate timeoutMs: number\n\n\t/**\n\t * @param workerUrl - URL to the sqlite-wasm-worker script\n\t * @param timeoutMs - Timeout for worker responses in milliseconds (default: 30000)\n\t */\n\tconstructor(workerUrl: string | URL, timeoutMs = 30000) {\n\t\tthis.timeoutMs = timeoutMs\n\t\tthis.worker = new Worker(workerUrl, { type: 'module' })\n\t\tthis.worker.onmessage = (event: MessageEvent<WorkerResponse>) => {\n\t\t\tconst response = event.data\n\t\t\tconst entry = this.pending.get(response.id)\n\t\t\tif (entry) {\n\t\t\t\tthis.pending.delete(response.id)\n\t\t\t\tentry.resolve(response)\n\t\t\t}\n\t\t}\n\t\tthis.worker.onerror = (event) => {\n\t\t\t// Reject all pending requests on worker error\n\t\t\tconst error = new Error(`Worker error: ${event.message}`)\n\t\t\tfor (const [id, entry] of this.pending) {\n\t\t\t\tthis.pending.delete(id)\n\t\t\t\tentry.reject(error)\n\t\t\t}\n\t\t}\n\t}\n\n\tasync send(request: WorkerRequest): Promise<WorkerResponse> {\n\t\tif (this.terminated) {\n\t\t\treturn {\n\t\t\t\tid: request.id,\n\t\t\t\ttype: 'error',\n\t\t\t\tmessage: 'Worker has been terminated',\n\t\t\t\tcode: 'WORKER_TERMINATED',\n\t\t\t}\n\t\t}\n\n\t\tconst id = this.nextId++\n\t\tconst req = { ...request, id }\n\n\t\treturn new Promise<WorkerResponse>((resolve, reject) => {\n\t\t\tconst timer = setTimeout(() => {\n\t\t\t\tthis.pending.delete(id)\n\t\t\t\treject(new WorkerTimeoutError(req.type, this.timeoutMs))\n\t\t\t}, this.timeoutMs)\n\n\t\t\tthis.pending.set(id, {\n\t\t\t\tresolve: (response) => {\n\t\t\t\t\tclearTimeout(timer)\n\t\t\t\t\tresolve(response)\n\t\t\t\t},\n\t\t\t\treject: (error) => {\n\t\t\t\t\tclearTimeout(timer)\n\t\t\t\t\treject(error)\n\t\t\t\t},\n\t\t\t})\n\n\t\t\tthis.worker.postMessage(req)\n\t\t})\n\t}\n\n\tterminate(): void {\n\t\tif (this.terminated) return\n\t\tthis.terminated = true\n\t\tthis.worker.terminate()\n\t\t// Reject any pending requests\n\t\tfor (const [id, entry] of this.pending) {\n\t\t\tthis.pending.delete(id)\n\t\t\tentry.reject(new Error('Worker terminated'))\n\t\t}\n\t}\n}\n"],"mappings":";;;;;AAkDO,IAAM,QAAN,MAAY;AAAA,EACV,SAAS;AAAA,EACT,UAA6B,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMtC,MAAM,UAA+B;AACpC,QAAI,CAAC,KAAK,QAAQ;AACjB,WAAK,SAAS;AACd,aAAO,KAAK,cAAc;AAAA,IAC3B;AAEA,WAAO,IAAI,QAAoB,CAAC,YAAY;AAC3C,WAAK,QAAQ,KAAK,MAAM;AACvB,gBAAQ,KAAK,cAAc,CAAC;AAAA,MAC7B,CAAC;AAAA,IACF,CAAC;AAAA,EACF;AAAA,EAEQ,gBAA4B;AACnC,QAAI,WAAW;AACf,WAAO,MAAM;AACZ,UAAI,SAAU;AACd,iBAAW;AACX,YAAM,OAAO,KAAK,QAAQ,MAAM;AAChC,UAAI,MAAM;AACT,aAAK;AAAA,MACN,OAAO;AACN,aAAK,SAAS;AAAA,MACf;AAAA,IACD;AAAA,EACD;AACD;AAQO,IAAM,kBAAN,MAA8C;AAAA,EAC5C;AAAA,EACA,UAAU,oBAAI,IAGpB;AAAA,EACM,SAAS;AAAA,EACT,aAAa;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA,EAMR,YAAY,WAAyB,YAAY,KAAO;AACvD,SAAK,YAAY;AACjB,SAAK,SAAS,IAAI,OAAO,WAAW,EAAE,MAAM,SAAS,CAAC;AACtD,SAAK,OAAO,YAAY,CAAC,UAAwC;AAChE,YAAM,WAAW,MAAM;AACvB,YAAM,QAAQ,KAAK,QAAQ,IAAI,SAAS,EAAE;AAC1C,UAAI,OAAO;AACV,aAAK,QAAQ,OAAO,SAAS,EAAE;AAC/B,cAAM,QAAQ,QAAQ;AAAA,MACvB;AAAA,IACD;AACA,SAAK,OAAO,UAAU,CAAC,UAAU;AAEhC,YAAM,QAAQ,IAAI,MAAM,iBAAiB,MAAM,OAAO,EAAE;AACxD,iBAAW,CAAC,IAAI,KAAK,KAAK,KAAK,SAAS;AACvC,aAAK,QAAQ,OAAO,EAAE;AACtB,cAAM,OAAO,KAAK;AAAA,MACnB;AAAA,IACD;AAAA,EACD;AAAA,EAEA,MAAM,KAAK,SAAiD;AAC3D,QAAI,KAAK,YAAY;AACpB,aAAO;AAAA,QACN,IAAI,QAAQ;AAAA,QACZ,MAAM;AAAA,QACN,SAAS;AAAA,QACT,MAAM;AAAA,MACP;AAAA,IACD;AAEA,UAAM,KAAK,KAAK;AAChB,UAAM,MAAM,EAAE,GAAG,SAAS,GAAG;AAE7B,WAAO,IAAI,QAAwB,CAAC,SAAS,WAAW;AACvD,YAAM,QAAQ,WAAW,MAAM;AAC9B,aAAK,QAAQ,OAAO,EAAE;AACtB,eAAO,IAAI,mBAAmB,IAAI,MAAM,KAAK,SAAS,CAAC;AAAA,MACxD,GAAG,KAAK,SAAS;AAEjB,WAAK,QAAQ,IAAI,IAAI;AAAA,QACpB,SAAS,CAAC,aAAa;AACtB,uBAAa,KAAK;AAClB,kBAAQ,QAAQ;AAAA,QACjB;AAAA,QACA,QAAQ,CAAC,UAAU;AAClB,uBAAa,KAAK;AAClB,iBAAO,KAAK;AAAA,QACb;AAAA,MACD,CAAC;AAED,WAAK,OAAO,YAAY,GAAG;AAAA,IAC5B,CAAC;AAAA,EACF;AAAA,EAEA,YAAkB;AACjB,QAAI,KAAK,WAAY;AACrB,SAAK,aAAa;AAClB,SAAK,OAAO,UAAU;AAEtB,eAAW,CAAC,IAAI,KAAK,KAAK,KAAK,SAAS;AACvC,WAAK,QAAQ,OAAO,EAAE;AACtB,YAAM,OAAO,IAAI,MAAM,mBAAmB,CAAC;AAAA,IAC5C;AAAA,EACD;AACD;","names":[]}

package/dist/chunk-ZP5AXQ3Z.js

@@ -1,179 +0,0 @@
-import {
-  Mutex
-} from "./chunk-DXKLAQ6P.js";
-import {
-  AdapterError,
-  StoreNotOpenError
-} from "./chunk-LAWV6CFH.js";
-
-// src/adapters/sqlite-wasm-adapter.ts
-import { generateFullDDL } from "@korajs/core";
-var SqliteWasmAdapter = class {
-  bridge = null;
-  opened = false;
-  mutex = new Mutex();
-  injectedBridge;
-  workerUrl;
-  dbName;
-  constructor(options = {}) {
-    this.injectedBridge = options.bridge;
-    this.workerUrl = options.workerUrl;
-    this.dbName = options.dbName ?? "kora-db";
-  }
-  async open(schema) {
-    if (this.opened) return;
-    if (this.injectedBridge) {
-      this.bridge = this.injectedBridge;
-    } else if (this.workerUrl) {
-      const { WebWorkerBridge } = await import("./sqlite-wasm-channel-46AOWNPM.js");
-      this.bridge = new WebWorkerBridge(this.workerUrl);
-    } else {
-      throw new AdapterError(
-        'SqliteWasmAdapter requires either a bridge (for testing) or a workerUrl (for browsers). Pass { bridge: new MockWorkerBridge() } for tests, or { workerUrl: "/worker.js" } for browsers.'
-      );
-    }
-    const ddlStatements = generateFullDDL(schema);
-    const response = await this.sendRequest({ id: 0, type: "open", ddlStatements });
-    if (response.type === "error") {
-      throw new AdapterError(`Failed to open database: ${response.message}`, {
-        code: response.code,
-        dbName: this.dbName
-      });
-    }
-    this.opened = true;
-  }
-  async close() {
-    if (!this.bridge) return;
-    try {
-      await this.sendRequest({ id: 0, type: "close" });
-    } finally {
-      this.bridge.terminate();
-      this.bridge = null;
-      this.opened = false;
-    }
-  }
-  async execute(sql, params) {
-    this.guardOpen();
-    const response = await this.sendRequest({ id: 0, type: "execute", sql, params });
-    if (response.type === "error") {
-      throw new AdapterError(`Execute failed: ${response.message}`, { sql, params });
-    }
-  }
-  async query(sql, params) {
-    this.guardOpen();
-    const response = await this.sendRequest({ id: 0, type: "query", sql, params });
-    if (response.type === "error") {
-      throw new AdapterError(`Query failed: ${response.message}`, { sql, params });
-    }
-    return response.data ?? [];
-  }
-  async transaction(fn) {
-    this.guardOpen();
-    const release = await this.mutex.acquire();
-    try {
-      await this.sendChecked({ id: 0, type: "begin" }, "BEGIN transaction");
-      const tx = {
-        execute: async (sql, params) => {
-          const response = await this.sendRequest({ id: 0, type: "execute", sql, params });
-          if (response.type === "error") {
-            throw new AdapterError(`Transaction execute failed: ${response.message}`, {
-              sql,
-              params
-            });
-          }
-        },
-        query: async (sql, params) => {
-          const response = await this.sendRequest({ id: 0, type: "query", sql, params });
-          if (response.type === "error") {
-            throw new AdapterError(`Transaction query failed: ${response.message}`, { sql, params });
-          }
-          return response.data ?? [];
-        }
-      };
-      await fn(tx);
-      await this.sendChecked({ id: 0, type: "commit" }, "COMMIT transaction");
-    } catch (error) {
-      try {
-        await this.sendRequest({ id: 0, type: "rollback" });
-      } catch {
-      }
-      throw error;
-    } finally {
-      release();
-    }
-  }
-  async migrate(from, to, migration) {
-    this.guardOpen();
-    const release = await this.mutex.acquire();
-    try {
-      await this.sendChecked({ id: 0, type: "begin" }, "BEGIN migration");
-      for (const sql of migration.statements) {
-        const response = await this.sendRequest({ id: 0, type: "execute", sql });
-        if (response.type === "error") {
-          throw new AdapterError(`Migration from v${from} to v${to} failed: ${response.message}`, {
-            from,
-            to
-          });
-        }
-      }
-      await this.sendChecked({ id: 0, type: "commit" }, "COMMIT migration");
-    } catch (error) {
-      try {
-        await this.sendRequest({ id: 0, type: "rollback" });
-      } catch {
-      }
-      if (error instanceof AdapterError) throw error;
-      throw new AdapterError(
-        `Migration from v${from} to v${to} failed: ${error.message}`,
-        { from, to }
-      );
-    } finally {
-      release();
-    }
-  }
-  /**
-   * Export the database as a Uint8Array (for IndexedDB persistence).
-   * Only available when the database is open.
-   */
-  async exportDatabase() {
-    this.guardOpen();
-    const response = await this.sendRequest({ id: 0, type: "export" });
-    if (response.type === "error") {
-      throw new AdapterError(`Export failed: ${response.message}`);
-    }
-    return response.data;
-  }
-  /**
-   * Import a serialized database snapshot.
-   */
-  async importDatabase(data) {
-    this.guardOpen();
-    const response = await this.sendRequest({ id: 0, type: "import", data });
-    if (response.type === "error") {
-      throw new AdapterError(`Import failed: ${response.message}`);
-    }
-  }
-  guardOpen() {
-    if (!this.opened || !this.bridge) {
-      throw new StoreNotOpenError();
-    }
-  }
-  async sendRequest(request) {
-    const bridge = this.bridge;
-    if (!bridge) {
-      throw new StoreNotOpenError();
-    }
-    return bridge.send(request);
-  }
-  async sendChecked(request, description) {
-    const response = await this.sendRequest(request);
-    if (response.type === "error") {
-      throw new AdapterError(`${description} failed: ${response.message}`);
-    }
-  }
-};
-
-export {
-  SqliteWasmAdapter
-};
-//# sourceMappingURL=chunk-ZP5AXQ3Z.js.map

package/dist/chunk-ZP5AXQ3Z.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/adapters/sqlite-wasm-adapter.ts"],"sourcesContent":["import { generateFullDDL } from '@korajs/core'\nimport type { SchemaDefinition } from '@korajs/core'\nimport { AdapterError, StoreNotOpenError } from '../errors'\nimport type { MigrationPlan, StorageAdapter, Transaction } from '../types'\nimport { Mutex } from './sqlite-wasm-channel'\nimport type { WorkerBridge, WorkerRequest, WorkerResponse } from './sqlite-wasm-channel'\n\n/**\n * Options for creating a SqliteWasmAdapter.\n */\nexport interface SqliteWasmAdapterOptions {\n\t/**\n\t * Injected WorkerBridge for testing. If omitted, a WebWorkerBridge is created\n\t * in browser environments.\n\t */\n\tbridge?: WorkerBridge\n\n\t/**\n\t * Database name for persistence. Used as the OPFS file name or IDB key.\n\t */\n\tdbName?: string\n\n\t/**\n\t * URL to the sqlite-wasm-worker script. Required in browsers if no bridge is provided.\n\t */\n\tworkerUrl?: string | URL\n}\n\n/**\n * SQLite WASM adapter that communicates with a SQLite instance through a WorkerBridge.\n *\n * In browsers, the bridge is backed by a Web Worker running SQLite WASM with OPFS persistence.\n * In Node.js tests, the bridge is backed by MockWorkerBridge wrapping better-sqlite3.\n *\n * @example\n * ```typescript\n * // Browser usage\n * const adapter = new SqliteWasmAdapter({ workerUrl: '/sqlite-wasm-worker.js' })\n *\n * // Test usage with MockWorkerBridge\n * import { MockWorkerBridge } from './sqlite-wasm-mock-bridge'\n * const adapter = new SqliteWasmAdapter({ bridge: new MockWorkerBridge() })\n * ```\n */\nexport class SqliteWasmAdapter implements StorageAdapter {\n\tprivate bridge: WorkerBridge | null = null\n\tprivate opened = false\n\tprivate readonly mutex = new Mutex()\n\tprivate readonly injectedBridge: WorkerBridge | undefined\n\tprivate readonly workerUrl: string | URL | undefined\n\tprivate readonly dbName: string\n\n\tconstructor(options: SqliteWasmAdapterOptions = {}) {\n\t\tthis.injectedBridge = options.bridge\n\t\tthis.workerUrl = options.workerUrl\n\t\tthis.dbName = options.dbName ?? 'kora-db'\n\t}\n\n\tasync open(schema: SchemaDefinition): Promise<void> {\n\t\tif (this.opened) return\n\n\t\tif (this.injectedBridge) {\n\t\t\tthis.bridge = this.injectedBridge\n\t\t} else if (this.workerUrl) {\n\t\t\t// Dynamic import to avoid loading WebWorkerBridge in Node.js\n\t\t\tconst { WebWorkerBridge } = await import('./sqlite-wasm-channel')\n\t\t\tthis.bridge = new WebWorkerBridge(this.workerUrl)\n\t\t} else {\n\t\t\tthrow new AdapterError(\n\t\t\t\t'SqliteWasmAdapter requires either a bridge (for testing) or a workerUrl (for browsers). ' +\n\t\t\t\t\t'Pass { bridge: new MockWorkerBridge() } for tests, or { workerUrl: \"/worker.js\" } for browsers.',\n\t\t\t)\n\t\t}\n\n\t\tconst ddlStatements = generateFullDDL(schema)\n\t\tconst response = await this.sendRequest({ id: 0, type: 'open', ddlStatements })\n\t\tif (response.type === 'error') {\n\t\t\tthrow new AdapterError(`Failed to open database: ${response.message}`, {\n\t\t\t\tcode: response.code,\n\t\t\t\tdbName: this.dbName,\n\t\t\t})\n\t\t}\n\t\tthis.opened = true\n\t}\n\n\tasync close(): Promise<void> {\n\t\tif (!this.bridge) return\n\n\t\ttry {\n\t\t\tawait this.sendRequest({ id: 0, type: 'close' })\n\t\t} finally {\n\t\t\tthis.bridge.terminate()\n\t\t\tthis.bridge = null\n\t\t\tthis.opened = false\n\t\t}\n\t}\n\n\tasync execute(sql: string, params?: unknown[]): Promise<void> {\n\t\tthis.guardOpen()\n\t\tconst response = await this.sendRequest({ id: 0, type: 'execute', sql, params })\n\t\tif (response.type === 'error') {\n\t\t\tthrow new AdapterError(`Execute failed: ${response.message}`, { sql, params })\n\t\t}\n\t}\n\n\tasync query<T>(sql: string, params?: unknown[]): Promise<T[]> {\n\t\tthis.guardOpen()\n\t\tconst response = await this.sendRequest({ id: 0, type: 'query', sql, params })\n\t\tif (response.type === 'error') {\n\t\t\tthrow new AdapterError(`Query failed: ${response.message}`, { sql, params })\n\t\t}\n\t\treturn (response.data as T[]) ?? []\n\t}\n\n\tasync transaction(fn: (tx: Transaction) => Promise<void>): Promise<void> {\n\t\tthis.guardOpen()\n\n\t\tconst release = await this.mutex.acquire()\n\t\ttry {\n\t\t\tawait this.sendChecked({ id: 0, type: 'begin' }, 'BEGIN transaction')\n\n\t\t\tconst tx: Transaction = {\n\t\t\t\texecute: async (sql: string, params?: unknown[]): Promise<void> => {\n\t\t\t\t\tconst response = await this.sendRequest({ id: 0, type: 'execute', sql, params })\n\t\t\t\t\tif (response.type === 'error') {\n\t\t\t\t\t\tthrow new AdapterError(`Transaction execute failed: ${response.message}`, {\n\t\t\t\t\t\t\tsql,\n\t\t\t\t\t\t\tparams,\n\t\t\t\t\t\t})\n\t\t\t\t\t}\n\t\t\t\t},\n\t\t\t\tquery: async <T>(sql: string, params?: unknown[]): Promise<T[]> => {\n\t\t\t\t\tconst response = await this.sendRequest({ id: 0, type: 'query', sql, params })\n\t\t\t\t\tif (response.type === 'error') {\n\t\t\t\t\t\tthrow new AdapterError(`Transaction query failed: ${response.message}`, { sql, params })\n\t\t\t\t\t}\n\t\t\t\t\treturn (response.data as T[]) ?? []\n\t\t\t\t},\n\t\t\t}\n\n\t\t\tawait fn(tx)\n\t\t\tawait this.sendChecked({ id: 0, type: 'commit' }, 'COMMIT transaction')\n\t\t} catch (error) {\n\t\t\t// Attempt rollback, but don't mask the original error\n\t\t\ttry {\n\t\t\t\tawait this.sendRequest({ id: 0, type: 'rollback' })\n\t\t\t} catch {\n\t\t\t\t// Rollback failure is secondary to the original error\n\t\t\t}\n\t\t\tthrow error\n\t\t} finally {\n\t\t\trelease()\n\t\t}\n\t}\n\n\tasync migrate(from: number, to: number, migration: MigrationPlan): Promise<void> {\n\t\tthis.guardOpen()\n\n\t\tconst release = await this.mutex.acquire()\n\t\ttry {\n\t\t\tawait this.sendChecked({ id: 0, type: 'begin' }, 'BEGIN migration')\n\n\t\t\tfor (const sql of migration.statements) {\n\t\t\t\tconst response = await this.sendRequest({ id: 0, type: 'execute', sql })\n\t\t\t\tif (response.type === 'error') {\n\t\t\t\t\tthrow new AdapterError(`Migration from v${from} to v${to} failed: ${response.message}`, {\n\t\t\t\t\t\tfrom,\n\t\t\t\t\t\tto,\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tawait this.sendChecked({ id: 0, type: 'commit' }, 'COMMIT migration')\n\t\t} catch (error) {\n\t\t\ttry {\n\t\t\t\tawait this.sendRequest({ id: 0, type: 'rollback' })\n\t\t\t} catch {\n\t\t\t\t// Rollback failure is secondary\n\t\t\t}\n\t\t\tif (error instanceof AdapterError) throw error\n\t\t\tthrow new AdapterError(\n\t\t\t\t`Migration from v${from} to v${to} failed: ${(error as Error).message}`,\n\t\t\t\t{ from, to },\n\t\t\t)\n\t\t} finally {\n\t\t\trelease()\n\t\t}\n\t}\n\n\t/**\n\t * Export the database as a Uint8Array (for IndexedDB persistence).\n\t * Only available when the database is open.\n\t */\n\tasync exportDatabase(): Promise<Uint8Array> {\n\t\tthis.guardOpen()\n\t\tconst response = await this.sendRequest({ id: 0, type: 'export' })\n\t\tif (response.type === 'error') {\n\t\t\tthrow new AdapterError(`Export failed: ${response.message}`)\n\t\t}\n\t\treturn response.data as Uint8Array\n\t}\n\n\t/**\n\t * Import a serialized database snapshot.\n\t */\n\tasync importDatabase(data: Uint8Array): Promise<void> {\n\t\tthis.guardOpen()\n\t\tconst response = await this.sendRequest({ id: 0, type: 'import', data })\n\t\tif (response.type === 'error') {\n\t\t\tthrow new AdapterError(`Import failed: ${response.message}`)\n\t\t}\n\t}\n\n\tprivate guardOpen(): void {\n\t\tif (!this.opened || !this.bridge) {\n\t\t\tthrow new StoreNotOpenError()\n\t\t}\n\t}\n\n\tprivate async sendRequest(request: WorkerRequest): Promise<WorkerResponse> {\n\t\t// guardOpen() is always called before sendRequest, so bridge is guaranteed non-null\n\t\tconst bridge = this.bridge\n\t\tif (!bridge) {\n\t\t\tthrow new StoreNotOpenError()\n\t\t}\n\t\treturn bridge.send(request)\n\t}\n\n\tprivate async sendChecked(request: WorkerRequest, description: string): Promise<void> {\n\t\tconst response = await this.sendRequest(request)\n\t\tif (response.type === 'error') {\n\t\t\tthrow new AdapterError(`${description} failed: ${response.message}`)\n\t\t}\n\t}\n}\n"],"mappings":";;;;;;;;;AAAA,SAAS,uBAAuB;AA4CzB,IAAM,oBAAN,MAAkD;AAAA,EAChD,SAA8B;AAAA,EAC9B,SAAS;AAAA,EACA,QAAQ,IAAI,MAAM;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,YAAY,UAAoC,CAAC,GAAG;AACnD,SAAK,iBAAiB,QAAQ;AAC9B,SAAK,YAAY,QAAQ;AACzB,SAAK,SAAS,QAAQ,UAAU;AAAA,EACjC;AAAA,EAEA,MAAM,KAAK,QAAyC;AACnD,QAAI,KAAK,OAAQ;AAEjB,QAAI,KAAK,gBAAgB;AACxB,WAAK,SAAS,KAAK;AAAA,IACpB,WAAW,KAAK,WAAW;AAE1B,YAAM,EAAE,gBAAgB,IAAI,MAAM,OAAO,mCAAuB;AAChE,WAAK,SAAS,IAAI,gBAAgB,KAAK,SAAS;AAAA,IACjD,OAAO;AACN,YAAM,IAAI;AAAA,QACT;AAAA,MAED;AAAA,IACD;AAEA,UAAM,gBAAgB,gBAAgB,MAAM;AAC5C,UAAM,WAAW,MAAM,KAAK,YAAY,EAAE,IAAI,GAAG,MAAM,QAAQ,cAAc,CAAC;AAC9E,QAAI,SAAS,SAAS,SAAS;AAC9B,YAAM,IAAI,aAAa,4BAA4B,SAAS,OAAO,IAAI;AAAA,QACtE,MAAM,SAAS;AAAA,QACf,QAAQ,KAAK;AAAA,MACd,CAAC;AAAA,IACF;AACA,SAAK,SAAS;AAAA,EACf;AAAA,EAEA,MAAM,QAAuB;AAC5B,QAAI,CAAC,KAAK,OAAQ;AAElB,QAAI;AACH,YAAM,KAAK,YAAY,EAAE,IAAI,GAAG,MAAM,QAAQ,CAAC;AAAA,IAChD,UAAE;AACD,WAAK,OAAO,UAAU;AACtB,WAAK,SAAS;AACd,WAAK,SAAS;AAAA,IACf;AAAA,EACD;AAAA,EAEA,MAAM,QAAQ,KAAa,QAAmC;AAC7D,SAAK,UAAU;AACf,UAAM,WAAW,MAAM,KAAK,YAAY,EAAE,IAAI,GAAG,MAAM,WAAW,KAAK,OAAO,CAAC;AAC/E,QAAI,SAAS,SAAS,SAAS;AAC9B,YAAM,IAAI,aAAa,mBAAmB,SAAS,OAAO,IAAI,EAAE,KAAK,OAAO,CAAC;AAAA,IAC9E;AAAA,EACD;AAAA,EAEA,MAAM,MAAS,KAAa,QAAkC;AAC7D,SAAK,UAAU;AACf,UAAM,WAAW,MAAM,KAAK,YAAY,EAAE,IAAI,GAAG,MAAM,SAAS,KAAK,OAAO,CAAC;AAC7E,QAAI,SAAS,SAAS,SAAS;AAC9B,YAAM,IAAI,aAAa,iBAAiB,SAAS,OAAO,IAAI,EAAE,KAAK,OAAO,CAAC;AAAA,IAC5E;AACA,WAAQ,SAAS,QAAgB,CAAC;AAAA,EACnC;AAAA,EAEA,MAAM,YAAY,IAAuD;AACxE,SAAK,UAAU;AAEf,UAAM,UAAU,MAAM,KAAK,MAAM,QAAQ;AACzC,QAAI;AACH,YAAM,KAAK,YAAY,EAAE,IAAI,GAAG,MAAM,QAAQ,GAAG,mBAAmB;AAEpE,YAAM,KAAkB;AAAA,QACvB,SAAS,OAAO,KAAa,WAAsC;AAClE,gBAAM,WAAW,MAAM,KAAK,YAAY,EAAE,IAAI,GAAG,MAAM,WAAW,KAAK,OAAO,CAAC;AAC/E,cAAI,SAAS,SAAS,SAAS;AAC9B,kBAAM,IAAI,aAAa,+BAA+B,SAAS,OAAO,IAAI;AAAA,cACzE;AAAA,cACA;AAAA,YACD,CAAC;AAAA,UACF;AAAA,QACD;AAAA,QACA,OAAO,OAAU,KAAa,WAAqC;AAClE,gBAAM,WAAW,MAAM,KAAK,YAAY,EAAE,IAAI,GAAG,MAAM,SAAS,KAAK,OAAO,CAAC;AAC7E,cAAI,SAAS,SAAS,SAAS;AAC9B,kBAAM,IAAI,aAAa,6BAA6B,SAAS,OAAO,IAAI,EAAE,KAAK,OAAO,CAAC;AAAA,UACxF;AACA,iBAAQ,SAAS,QAAgB,CAAC;AAAA,QACnC;AAAA,MACD;AAEA,YAAM,GAAG,EAAE;AACX,YAAM,KAAK,YAAY,EAAE,IAAI,GAAG,MAAM,SAAS,GAAG,oBAAoB;AAAA,IACvE,SAAS,OAAO;AAEf,UAAI;AACH,cAAM,KAAK,YAAY,EAAE,IAAI,GAAG,MAAM,WAAW,CAAC;AAAA,MACnD,QAAQ;AAAA,MAER;AACA,YAAM;AAAA,IACP,UAAE;AACD,cAAQ;AAAA,IACT;AAAA,EACD;AAAA,EAEA,MAAM,QAAQ,MAAc,IAAY,WAAyC;AAChF,SAAK,UAAU;AAEf,UAAM,UAAU,MAAM,KAAK,MAAM,QAAQ;AACzC,QAAI;AACH,YAAM,KAAK,YAAY,EAAE,IAAI,GAAG,MAAM,QAAQ,GAAG,iBAAiB;AAElE,iBAAW,OAAO,UAAU,YAAY;AACvC,cAAM,WAAW,MAAM,KAAK,YAAY,EAAE,IAAI,GAAG,MAAM,WAAW,IAAI,CAAC;AACvE,YAAI,SAAS,SAAS,SAAS;AAC9B,gBAAM,IAAI,aAAa,mBAAmB,IAAI,QAAQ,EAAE,YAAY,SAAS,OAAO,IAAI;AAAA,YACvF;AAAA,YACA;AAAA,UACD,CAAC;AAAA,QACF;AAAA,MACD;AAEA,YAAM,KAAK,YAAY,EAAE,IAAI,GAAG,MAAM,SAAS,GAAG,kBAAkB;AAAA,IACrE,SAAS,OAAO;AACf,UAAI;AACH,cAAM,KAAK,YAAY,EAAE,IAAI,GAAG,MAAM,WAAW,CAAC;AAAA,MACnD,QAAQ;AAAA,MAER;AACA,UAAI,iBAAiB,aAAc,OAAM;AACzC,YAAM,IAAI;AAAA,QACT,mBAAmB,IAAI,QAAQ,EAAE,YAAa,MAAgB,OAAO;AAAA,QACrE,EAAE,MAAM,GAAG;AAAA,MACZ;AAAA,IACD,UAAE;AACD,cAAQ;AAAA,IACT;AAAA,EACD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,iBAAsC;AAC3C,SAAK,UAAU;AACf,UAAM,WAAW,MAAM,KAAK,YAAY,EAAE,IAAI,GAAG,MAAM,SAAS,CAAC;AACjE,QAAI,SAAS,SAAS,SAAS;AAC9B,YAAM,IAAI,aAAa,kBAAkB,SAAS,OAAO,EAAE;AAAA,IAC5D;AACA,WAAO,SAAS;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,eAAe,MAAiC;AACrD,SAAK,UAAU;AACf,UAAM,WAAW,MAAM,KAAK,YAAY,EAAE,IAAI,GAAG,MAAM,UAAU,KAAK,CAAC;AACvE,QAAI,SAAS,SAAS,SAAS;AAC9B,YAAM,IAAI,aAAa,kBAAkB,SAAS,OAAO,EAAE;AAAA,IAC5D;AAAA,EACD;AAAA,EAEQ,YAAkB;AACzB,QAAI,CAAC,KAAK,UAAU,CAAC,KAAK,QAAQ;AACjC,YAAM,IAAI,kBAAkB;AAAA,IAC7B;AAAA,EACD;AAAA,EAEA,MAAc,YAAY,SAAiD;AAE1E,UAAM,SAAS,KAAK;AACpB,QAAI,CAAC,QAAQ;AACZ,YAAM,IAAI,kBAAkB;AAAA,IAC7B;AACA,WAAO,OAAO,KAAK,OAAO;AAAA,EAC3B;AAAA,EAEA,MAAc,YAAY,SAAwB,aAAoC;AACrF,UAAM,WAAW,MAAM,KAAK,YAAY,OAAO;AAC/C,QAAI,SAAS,SAAS,SAAS;AAC9B,YAAM,IAAI,aAAa,GAAG,WAAW,YAAY,SAAS,OAAO,EAAE;AAAA,IACpE;AAAA,EACD;AACD;","names":[]}

package/dist/types-DF-KDSK1.d.cts

@@ -1,106 +0,0 @@
-import { SchemaDefinition, KoraEventEmitter } from '@korajs/core';
-
-/**
- * Transaction interface for executing multiple operations atomically.
- */
-interface Transaction {
-    execute(sql: string, params?: unknown[]): Promise<void>;
-    query<T>(sql: string, params?: unknown[]): Promise<T[]>;
-}
-/**
- * Migration plan containing SQL statements and optional data transforms.
- */
-interface MigrationPlan {
-    statements: string[];
-    transforms?: Array<(row: Record<string, unknown>) => Record<string, unknown>>;
-}
-/**
- * Storage adapter interface. All storage backends must implement this.
- * Operations are async to support both sync (better-sqlite3) and async (IndexedDB, WASM) backends.
- */
-interface StorageAdapter {
-    /** Open or create the database */
-    open(schema: SchemaDefinition): Promise<void>;
-    /** Close the database and release resources */
-    close(): Promise<void>;
-    /** Execute a write query (INSERT, UPDATE, DELETE) within a transaction */
-    execute(sql: string, params?: unknown[]): Promise<void>;
-    /** Execute a read query (SELECT) */
-    query<T>(sql: string, params?: unknown[]): Promise<T[]>;
-    /** Execute multiple operations atomically */
-    transaction(fn: (tx: Transaction) => Promise<void>): Promise<void>;
-    /** Apply a schema migration */
-    migrate(from: number, to: number, migration: MigrationPlan): Promise<void>;
-}
-/**
- * Configuration for creating a Store instance.
- */
-interface StoreConfig {
-    schema: SchemaDefinition;
-    adapter: StorageAdapter;
-    /** Optional node ID. If omitted, one is generated or loaded from the database. */
-    nodeId?: string;
-    /** Optional event emitter. When provided, local mutations emit 'operation:created' events. */
-    emitter?: KoraEventEmitter;
-}
-/**
- * Operators for where clause conditions.
- */
-interface WhereOperators {
-    $eq?: unknown;
-    $ne?: unknown;
-    $gt?: number | string;
-    $gte?: number | string;
-    $lt?: number | string;
-    $lte?: number | string;
-    $in?: unknown[];
-}
-/**
- * Where clause: field name to value (shorthand for $eq) or WhereOperators.
- */
-type WhereClause = Record<string, unknown | WhereOperators>;
-/**
- * Order direction for sorting query results.
- */
-type OrderByDirection = 'asc' | 'desc';
-/**
- * Order-by clause: field name and optional direction.
- */
-interface OrderByClause {
-    field: string;
-    direction: OrderByDirection;
-}
-/**
- * Internal representation of a query to be compiled to SQL.
- */
-interface QueryDescriptor {
-    collection: string;
-    where: WhereClause;
-    orderBy: OrderByClause[];
-    limit?: number;
-    offset?: number;
-    /** Relation names to include in results (for relational queries). */
-    include?: string[];
-    /** Resolved collection names for included relations (for subscription tracking). */
-    includeCollections?: string[];
-}
-/**
- * Callback for reactive subscriptions. Receives the current result set.
- */
-type SubscriptionCallback<T> = (results: T[]) => void;
-/**
- * Record type returned from collection queries.
- * Includes the id and mapped metadata fields.
- */
-interface CollectionRecord {
-    id: string;
-    createdAt: number;
-    updatedAt: number;
-    [key: string]: unknown;
-}
-/**
- * Result of a remote operation application.
- */
-type ApplyResult = 'applied' | 'duplicate' | 'skipped';
-
-export type { ApplyResult as A, CollectionRecord as C, MigrationPlan as M, OrderByDirection as O, QueryDescriptor as Q, StorageAdapter as S, Transaction as T, WhereClause as W, SubscriptionCallback as a, StoreConfig as b, OrderByClause as c, WhereOperators as d };