@korajs/tauri 0.0.0-canary-20261008174129

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dr. Obed Ehoneah
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,254 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  TauriAdapterError: () => TauriAdapterError,
+  TauriSqliteAdapter: () => TauriSqliteAdapter,
+  TauriStoreNotOpenError: () => TauriStoreNotOpenError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/tauri-sqlite-adapter.ts
+var import_core = require("@korajs/core");
+var TauriAdapterError = class extends Error {
+  code;
+  context;
+  constructor(message, context) {
+    super(message);
+    this.name = "TauriAdapterError";
+    this.code = "TAURI_ADAPTER_ERROR";
+    this.context = context;
+  }
+};
+var TauriStoreNotOpenError = class extends Error {
+  code;
+  constructor() {
+    super("Store is not open. Call adapter.open() before performing operations.");
+    this.name = "TauriStoreNotOpenError";
+    this.code = "STORE_NOT_OPEN";
+  }
+};
+var AsyncMutex = class {
+  queue = [];
+  locked = false;
+  async acquire() {
+    if (!this.locked) {
+      this.locked = true;
+      return () => this.release();
+    }
+    return new Promise((resolve) => {
+      this.queue.push(() => {
+        resolve(() => this.release());
+      });
+    });
+  }
+  release() {
+    const next = this.queue.shift();
+    if (next) {
+      next();
+    } else {
+      this.locked = false;
+    }
+  }
+};
+async function resolveDefaultInvoke() {
+  try {
+    const { invoke } = await import("@tauri-apps/api/core");
+    return invoke;
+  } catch {
+    throw new TauriAdapterError(
+      "Failed to import @tauri-apps/api/core. Ensure @tauri-apps/api is installed and you are running inside a Tauri application."
+    );
+  }
+}
+var PLUGIN_PREFIX = "plugin:kora-sqlite|";
+var TauriSqliteAdapter = class {
+  opened = false;
+  invoker;
+  dbPath;
+  txMutex = new AsyncMutex();
+  inTransaction = false;
+  constructor(options) {
+    this.dbPath = options?.path ?? "kora.db";
+    this.invoker = options?.invoke ?? null;
+  }
+  async getInvoke() {
+    if (!this.invoker) {
+      this.invoker = await resolveDefaultInvoke();
+    }
+    return this.invoker;
+  }
+  async invoke(cmd, args) {
+    const invokeFn = await this.getInvoke();
+    return invokeFn(`${PLUGIN_PREFIX}${cmd}`, args);
+  }
+  /**
+   * Open or create the database. Generates DDL from the schema and sends it
+   * to the Rust plugin for execution. The plugin configures WAL mode,
+   * foreign keys, and other pragmas before running the DDL.
+   */
+  async open(schema) {
+    const statements = (0, import_core.generateFullDDL)(schema);
+    await this.invoke("open", { path: this.dbPath, statements });
+    this.opened = true;
+  }
+  /**
+   * Close the database and release resources.
+   */
+  async close() {
+    if (this.opened) {
+      await this.invoke("close", { path: this.dbPath });
+      this.opened = false;
+    }
+  }
+  /**
+   * Execute a write query (INSERT, UPDATE, DELETE).
+   */
+  async execute(sql, params) {
+    this.ensureOpen();
+    try {
+      await this.invoke("execute", {
+        path: this.dbPath,
+        sql,
+        params: params ?? []
+      });
+    } catch (error) {
+      throw new TauriAdapterError(`Execute failed: ${error.message}`, {
+        sql,
+        params
+      });
+    }
+  }
+  /**
+   * Execute a read query (SELECT).
+   */
+  async query(sql, params) {
+    this.ensureOpen();
+    try {
+      return await this.invoke("query", {
+        path: this.dbPath,
+        sql,
+        params: params ?? []
+      });
+    } catch (error) {
+      throw new TauriAdapterError(`Query failed: ${error.message}`, {
+        sql,
+        params
+      });
+    }
+  }
+  /**
+   * Execute multiple operations atomically within a transaction.
+   *
+   * Uses a mutex to prevent interleaving of concurrent transactions.
+   * The transaction is committed on success or rolled back on error.
+   */
+  async transaction(fn) {
+    this.ensureOpen();
+    const release = await this.txMutex.acquire();
+    try {
+      this.inTransaction = true;
+      await this.invoke("execute", { path: this.dbPath, sql: "BEGIN", params: [] });
+      try {
+        const tx = {
+          execute: async (sql, params) => {
+            try {
+              await this.invoke("execute", {
+                path: this.dbPath,
+                sql,
+                params: params ?? []
+              });
+            } catch (error) {
+              throw new TauriAdapterError(
+                `Transaction execute failed: ${error.message}`,
+                { sql, params }
+              );
+            }
+          },
+          query: async (sql, params) => {
+            try {
+              return await this.invoke("query", {
+                path: this.dbPath,
+                sql,
+                params: params ?? []
+              });
+            } catch (error) {
+              throw new TauriAdapterError(`Transaction query failed: ${error.message}`, {
+                sql,
+                params
+              });
+            }
+          }
+        };
+        await fn(tx);
+        await this.invoke("execute", { path: this.dbPath, sql: "COMMIT", params: [] });
+      } catch (error) {
+        try {
+          await this.invoke("execute", { path: this.dbPath, sql: "ROLLBACK", params: [] });
+        } catch {
+        }
+        throw error;
+      }
+    } finally {
+      this.inTransaction = false;
+      release();
+    }
+  }
+  /**
+   * Apply a schema migration within a transaction.
+   */
+  async migrate(from, to, migration) {
+    this.ensureOpen();
+    try {
+      await this.invoke("migrate", {
+        path: this.dbPath,
+        statements: migration.statements
+      });
+    } catch (error) {
+      throw new TauriAdapterError(
+        `Migration from v${from} to v${to} failed: ${error.message}`,
+        { from, to }
+      );
+    }
+  }
+  ensureOpen() {
+    if (!this.opened) {
+      throw new TauriStoreNotOpenError();
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TauriAdapterError,
+  TauriSqliteAdapter,
+  TauriStoreNotOpenError
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/tauri-sqlite-adapter.ts"],"sourcesContent":["export {\n\tTauriSqliteAdapter,\n\tTauriAdapterError,\n\tTauriStoreNotOpenError,\n\ttype TauriSqliteOptions,\n\ttype InvokeFn,\n\ttype StorageAdapter,\n\ttype Transaction,\n\ttype MigrationPlan,\n} from './tauri-sqlite-adapter'\n","import { generateFullDDL } from '@korajs/core'\nimport type { SchemaDefinition } from '@korajs/core'\n\n/**\n * Transaction interface for executing multiple operations atomically.\n * Mirrors @korajs/store's Transaction type to avoid a runtime dependency.\n */\nexport interface Transaction {\n\texecute(sql: string, params?: unknown[]): Promise<void>\n\tquery<T>(sql: string, params?: unknown[]): Promise<T[]>\n}\n\n/**\n * Migration plan containing SQL statements and optional data transforms.\n * Mirrors @korajs/store's MigrationPlan type.\n */\nexport interface MigrationPlan {\n\tstatements: string[]\n\ttransforms?: Array<(row: Record<string, unknown>) => Record<string, unknown>>\n}\n\n/**\n * Storage adapter interface. Mirrors @korajs/store's StorageAdapter.\n * Redeclared here to avoid a runtime dependency on @korajs/store.\n */\nexport interface StorageAdapter {\n\topen(schema: SchemaDefinition): Promise<void>\n\tclose(): Promise<void>\n\texecute(sql: string, params?: unknown[]): Promise<void>\n\tquery<T>(sql: string, params?: unknown[]): Promise<T[]>\n\ttransaction(fn: (tx: Transaction) => Promise<void>): Promise<void>\n\tmigrate(from: number, to: number, migration: MigrationPlan): Promise<void>\n}\n\n/**\n * Function signature for Tauri's invoke IPC call.\n * Matches `invoke` from `@tauri-apps/api/core`.\n */\nexport type InvokeFn = <T>(cmd: string, args?: Record<string, unknown>) => Promise<T>\n\n/**\n * Configuration options for the Tauri SQLite adapter.\n */\nexport interface TauriSqliteOptions {\n\t/**\n\t * Database file path relative to the app's data directory.\n\t * Defaults to 'kora.db'.\n\t */\n\tpath?: string\n\n\t/**\n\t * Custom invoke function. Defaults to Tauri's `invoke` from `@tauri-apps/api/core`.\n\t * Useful for testing — inject a mock invoke to test without a Tauri runtime.\n\t */\n\tinvoke?: InvokeFn\n}\n\n/**\n * Thrown when a storage adapter operation fails in the Tauri plugin.\n */\nexport class TauriAdapterError extends Error {\n\tpublic readonly code: string\n\tpublic readonly context?: Record<string, unknown>\n\n\tconstructor(message: string, context?: Record<string, unknown>) {\n\t\tsuper(message)\n\t\tthis.name = 'TauriAdapterError'\n\t\tthis.code = 'TAURI_ADAPTER_ERROR'\n\t\tthis.context = context\n\t}\n}\n\n/**\n * Thrown when an operation is attempted on an adapter that has not been opened.\n */\nexport class TauriStoreNotOpenError extends Error {\n\tpublic readonly code: string\n\n\tconstructor() {\n\t\tsuper('Store is not open. Call adapter.open() before performing operations.')\n\t\tthis.name = 'TauriStoreNotOpenError'\n\t\tthis.code = 'STORE_NOT_OPEN'\n\t}\n}\n\n// Mutex for serializing transactions over async IPC\nclass AsyncMutex {\n\tprivate queue: Array<() => void> = []\n\tprivate locked = false\n\n\tasync acquire(): Promise<() => void> {\n\t\tif (!this.locked) {\n\t\t\tthis.locked = true\n\t\t\treturn () => this.release()\n\t\t}\n\t\treturn new Promise<() => void>((resolve) => {\n\t\t\tthis.queue.push(() => {\n\t\t\t\tresolve(() => this.release())\n\t\t\t})\n\t\t})\n\t}\n\n\tprivate release(): void {\n\t\tconst next = this.queue.shift()\n\t\tif (next) {\n\t\t\tnext()\n\t\t} else {\n\t\t\tthis.locked = false\n\t\t}\n\t}\n}\n\n/**\n * Resolves the default Tauri invoke function by dynamically importing `@tauri-apps/api/core`.\n * Returns null if not in a Tauri environment.\n */\nasync function resolveDefaultInvoke(): Promise<InvokeFn> {\n\ttry {\n\t\tconst { invoke } = await import('@tauri-apps/api/core')\n\t\treturn invoke as InvokeFn\n\t} catch {\n\t\tthrow new TauriAdapterError(\n\t\t\t'Failed to import @tauri-apps/api/core. Ensure @tauri-apps/api is installed and you are running inside a Tauri application.',\n\t\t)\n\t}\n}\n\nconst PLUGIN_PREFIX = 'plugin:kora-sqlite|'\n\n/**\n * Storage adapter backed by native SQLite via a Tauri plugin.\n *\n * Uses Tauri IPC to communicate with the `tauri-plugin-kora` Rust plugin,\n * which provides native SQLite access with WAL mode, foreign keys, and\n * proper connection management — zero WASM overhead.\n *\n * @example\n * ```typescript\n * import { TauriSqliteAdapter } from '@korajs/tauri'\n *\n * const adapter = new TauriSqliteAdapter({ path: 'my-app.db' })\n * ```\n *\n * @example\n * ```typescript\n * // With createApp (auto-detected in Tauri environments)\n * import { createApp, defineSchema, t } from 'korajs'\n *\n * const app = createApp({\n *   schema: defineSchema({\n *     version: 1,\n *     collections: {\n *       todos: { fields: { title: t.string(), completed: t.boolean().default(false) } }\n *     }\n *   })\n * })\n * ```\n */\nexport class TauriSqliteAdapter implements StorageAdapter {\n\tprivate opened = false\n\tprivate invoker: InvokeFn | null\n\tprivate readonly dbPath: string\n\tprivate readonly txMutex = new AsyncMutex()\n\tprivate inTransaction = false\n\n\tconstructor(options?: TauriSqliteOptions) {\n\t\tthis.dbPath = options?.path ?? 'kora.db'\n\t\tthis.invoker = options?.invoke ?? null\n\t}\n\n\tprivate async getInvoke(): Promise<InvokeFn> {\n\t\tif (!this.invoker) {\n\t\t\tthis.invoker = await resolveDefaultInvoke()\n\t\t}\n\t\treturn this.invoker\n\t}\n\n\tprivate async invoke<T>(cmd: string, args?: Record<string, unknown>): Promise<T> {\n\t\tconst invokeFn = await this.getInvoke()\n\t\treturn invokeFn<T>(`${PLUGIN_PREFIX}${cmd}`, args)\n\t}\n\n\t/**\n\t * Open or create the database. Generates DDL from the schema and sends it\n\t * to the Rust plugin for execution. The plugin configures WAL mode,\n\t * foreign keys, and other pragmas before running the DDL.\n\t */\n\tasync open(schema: SchemaDefinition): Promise<void> {\n\t\tconst statements = generateFullDDL(schema)\n\t\tawait this.invoke('open', { path: this.dbPath, statements })\n\t\tthis.opened = true\n\t}\n\n\t/**\n\t * Close the database and release resources.\n\t */\n\tasync close(): Promise<void> {\n\t\tif (this.opened) {\n\t\t\tawait this.invoke('close', { path: this.dbPath })\n\t\t\tthis.opened = false\n\t\t}\n\t}\n\n\t/**\n\t * Execute a write query (INSERT, UPDATE, DELETE).\n\t */\n\tasync execute(sql: string, params?: unknown[]): Promise<void> {\n\t\tthis.ensureOpen()\n\t\ttry {\n\t\t\tawait this.invoke('execute', {\n\t\t\t\tpath: this.dbPath,\n\t\t\t\tsql,\n\t\t\t\tparams: params ?? [],\n\t\t\t})\n\t\t} catch (error) {\n\t\t\tthrow new TauriAdapterError(`Execute failed: ${(error as Error).message}`, {\n\t\t\t\tsql,\n\t\t\t\tparams,\n\t\t\t})\n\t\t}\n\t}\n\n\t/**\n\t * Execute a read query (SELECT).\n\t */\n\tasync query<T>(sql: string, params?: unknown[]): Promise<T[]> {\n\t\tthis.ensureOpen()\n\t\ttry {\n\t\t\treturn await this.invoke<T[]>('query', {\n\t\t\t\tpath: this.dbPath,\n\t\t\t\tsql,\n\t\t\t\tparams: params ?? [],\n\t\t\t})\n\t\t} catch (error) {\n\t\t\tthrow new TauriAdapterError(`Query failed: ${(error as Error).message}`, {\n\t\t\t\tsql,\n\t\t\t\tparams,\n\t\t\t})\n\t\t}\n\t}\n\n\t/**\n\t * Execute multiple operations atomically within a transaction.\n\t *\n\t * Uses a mutex to prevent interleaving of concurrent transactions.\n\t * The transaction is committed on success or rolled back on error.\n\t */\n\tasync transaction(fn: (tx: Transaction) => Promise<void>): Promise<void> {\n\t\tthis.ensureOpen()\n\t\tconst release = await this.txMutex.acquire()\n\t\ttry {\n\t\t\tthis.inTransaction = true\n\t\t\tawait this.invoke('execute', { path: this.dbPath, sql: 'BEGIN', params: [] })\n\t\t\ttry {\n\t\t\t\tconst tx: Transaction = {\n\t\t\t\t\texecute: async (sql: string, params?: unknown[]): Promise<void> => {\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tawait this.invoke('execute', {\n\t\t\t\t\t\t\t\tpath: this.dbPath,\n\t\t\t\t\t\t\t\tsql,\n\t\t\t\t\t\t\t\tparams: params ?? [],\n\t\t\t\t\t\t\t})\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\tthrow new TauriAdapterError(\n\t\t\t\t\t\t\t\t`Transaction execute failed: ${(error as Error).message}`,\n\t\t\t\t\t\t\t\t{ sql, params },\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t}\n\t\t\t\t\t},\n\t\t\t\t\tquery: async <T>(sql: string, params?: unknown[]): Promise<T[]> => {\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\treturn await this.invoke<T[]>('query', {\n\t\t\t\t\t\t\t\tpath: this.dbPath,\n\t\t\t\t\t\t\t\tsql,\n\t\t\t\t\t\t\t\tparams: params ?? [],\n\t\t\t\t\t\t\t})\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\tthrow new TauriAdapterError(`Transaction query failed: ${(error as Error).message}`, {\n\t\t\t\t\t\t\t\tsql,\n\t\t\t\t\t\t\t\tparams,\n\t\t\t\t\t\t\t})\n\t\t\t\t\t\t}\n\t\t\t\t\t},\n\t\t\t\t}\n\t\t\t\tawait fn(tx)\n\t\t\t\tawait this.invoke('execute', { path: this.dbPath, sql: 'COMMIT', params: [] })\n\t\t\t} catch (error) {\n\t\t\t\ttry {\n\t\t\t\t\tawait this.invoke('execute', { path: this.dbPath, sql: 'ROLLBACK', params: [] })\n\t\t\t\t} catch {\n\t\t\t\t\t// Rollback failed — connection may be in a bad state, but we still throw the original error\n\t\t\t\t}\n\t\t\t\tthrow error\n\t\t\t}\n\t\t} finally {\n\t\t\tthis.inTransaction = false\n\t\t\trelease()\n\t\t}\n\t}\n\n\t/**\n\t * Apply a schema migration within a transaction.\n\t */\n\tasync migrate(from: number, to: number, migration: MigrationPlan): Promise<void> {\n\t\tthis.ensureOpen()\n\t\ttry {\n\t\t\tawait this.invoke('migrate', {\n\t\t\t\tpath: this.dbPath,\n\t\t\t\tstatements: migration.statements,\n\t\t\t})\n\t\t} catch (error) {\n\t\t\tthrow new TauriAdapterError(\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}\n\t}\n\n\tprivate ensureOpen(): void {\n\t\tif (!this.opened) {\n\t\t\tthrow new TauriStoreNotOpenError()\n\t\t}\n\t}\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,136 @@
+import { SchemaDefinition } from '@korajs/core';
+
+/**
+ * Transaction interface for executing multiple operations atomically.
+ * Mirrors @korajs/store's Transaction type to avoid a runtime dependency.
+ */
+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.
+ * Mirrors @korajs/store's MigrationPlan type.
+ */
+interface MigrationPlan {
+    statements: string[];
+    transforms?: Array<(row: Record<string, unknown>) => Record<string, unknown>>;
+}
+/**
+ * Storage adapter interface. Mirrors @korajs/store's StorageAdapter.
+ * Redeclared here to avoid a runtime dependency on @korajs/store.
+ */
+interface StorageAdapter {
+    open(schema: SchemaDefinition): Promise<void>;
+    close(): Promise<void>;
+    execute(sql: string, params?: unknown[]): Promise<void>;
+    query<T>(sql: string, params?: unknown[]): Promise<T[]>;
+    transaction(fn: (tx: Transaction) => Promise<void>): Promise<void>;
+    migrate(from: number, to: number, migration: MigrationPlan): Promise<void>;
+}
+/**
+ * Function signature for Tauri's invoke IPC call.
+ * Matches `invoke` from `@tauri-apps/api/core`.
+ */
+type InvokeFn = <T>(cmd: string, args?: Record<string, unknown>) => Promise<T>;
+/**
+ * Configuration options for the Tauri SQLite adapter.
+ */
+interface TauriSqliteOptions {
+    /**
+     * Database file path relative to the app's data directory.
+     * Defaults to 'kora.db'.
+     */
+    path?: string;
+    /**
+     * Custom invoke function. Defaults to Tauri's `invoke` from `@tauri-apps/api/core`.
+     * Useful for testing — inject a mock invoke to test without a Tauri runtime.
+     */
+    invoke?: InvokeFn;
+}
+/**
+ * Thrown when a storage adapter operation fails in the Tauri plugin.
+ */
+declare class TauriAdapterError extends Error {
+    readonly code: string;
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Thrown when an operation is attempted on an adapter that has not been opened.
+ */
+declare class TauriStoreNotOpenError extends Error {
+    readonly code: string;
+    constructor();
+}
+/**
+ * Storage adapter backed by native SQLite via a Tauri plugin.
+ *
+ * Uses Tauri IPC to communicate with the `tauri-plugin-kora` Rust plugin,
+ * which provides native SQLite access with WAL mode, foreign keys, and
+ * proper connection management — zero WASM overhead.
+ *
+ * @example
+ * ```typescript
+ * import { TauriSqliteAdapter } from '@korajs/tauri'
+ *
+ * const adapter = new TauriSqliteAdapter({ path: 'my-app.db' })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With createApp (auto-detected in Tauri environments)
+ * import { createApp, defineSchema, t } from 'korajs'
+ *
+ * const app = createApp({
+ *   schema: defineSchema({
+ *     version: 1,
+ *     collections: {
+ *       todos: { fields: { title: t.string(), completed: t.boolean().default(false) } }
+ *     }
+ *   })
+ * })
+ * ```
+ */
+declare class TauriSqliteAdapter implements StorageAdapter {
+    private opened;
+    private invoker;
+    private readonly dbPath;
+    private readonly txMutex;
+    private inTransaction;
+    constructor(options?: TauriSqliteOptions);
+    private getInvoke;
+    private invoke;
+    /**
+     * Open or create the database. Generates DDL from the schema and sends it
+     * to the Rust plugin for execution. The plugin configures WAL mode,
+     * foreign keys, and other pragmas before running the DDL.
+     */
+    open(schema: SchemaDefinition): Promise<void>;
+    /**
+     * Close the database and release resources.
+     */
+    close(): Promise<void>;
+    /**
+     * Execute a write query (INSERT, UPDATE, DELETE).
+     */
+    execute(sql: string, params?: unknown[]): Promise<void>;
+    /**
+     * Execute a read query (SELECT).
+     */
+    query<T>(sql: string, params?: unknown[]): Promise<T[]>;
+    /**
+     * Execute multiple operations atomically within a transaction.
+     *
+     * Uses a mutex to prevent interleaving of concurrent transactions.
+     * The transaction is committed on success or rolled back on error.
+     */
+    transaction(fn: (tx: Transaction) => Promise<void>): Promise<void>;
+    /**
+     * Apply a schema migration within a transaction.
+     */
+    migrate(from: number, to: number, migration: MigrationPlan): Promise<void>;
+    private ensureOpen;
+}
+
+export { type InvokeFn, type MigrationPlan, type StorageAdapter, TauriAdapterError, TauriSqliteAdapter, type TauriSqliteOptions, TauriStoreNotOpenError, type Transaction };

package/dist/index.d.ts

@@ -0,0 +1,136 @@
+import { SchemaDefinition } from '@korajs/core';
+
+/**
+ * Transaction interface for executing multiple operations atomically.
+ * Mirrors @korajs/store's Transaction type to avoid a runtime dependency.
+ */
+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.
+ * Mirrors @korajs/store's MigrationPlan type.
+ */
+interface MigrationPlan {
+    statements: string[];
+    transforms?: Array<(row: Record<string, unknown>) => Record<string, unknown>>;
+}
+/**
+ * Storage adapter interface. Mirrors @korajs/store's StorageAdapter.
+ * Redeclared here to avoid a runtime dependency on @korajs/store.
+ */
+interface StorageAdapter {
+    open(schema: SchemaDefinition): Promise<void>;
+    close(): Promise<void>;
+    execute(sql: string, params?: unknown[]): Promise<void>;
+    query<T>(sql: string, params?: unknown[]): Promise<T[]>;
+    transaction(fn: (tx: Transaction) => Promise<void>): Promise<void>;
+    migrate(from: number, to: number, migration: MigrationPlan): Promise<void>;
+}
+/**
+ * Function signature for Tauri's invoke IPC call.
+ * Matches `invoke` from `@tauri-apps/api/core`.
+ */
+type InvokeFn = <T>(cmd: string, args?: Record<string, unknown>) => Promise<T>;
+/**
+ * Configuration options for the Tauri SQLite adapter.
+ */
+interface TauriSqliteOptions {
+    /**
+     * Database file path relative to the app's data directory.
+     * Defaults to 'kora.db'.
+     */
+    path?: string;
+    /**
+     * Custom invoke function. Defaults to Tauri's `invoke` from `@tauri-apps/api/core`.
+     * Useful for testing — inject a mock invoke to test without a Tauri runtime.
+     */
+    invoke?: InvokeFn;
+}
+/**
+ * Thrown when a storage adapter operation fails in the Tauri plugin.
+ */
+declare class TauriAdapterError extends Error {
+    readonly code: string;
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Thrown when an operation is attempted on an adapter that has not been opened.
+ */
+declare class TauriStoreNotOpenError extends Error {
+    readonly code: string;
+    constructor();
+}
+/**
+ * Storage adapter backed by native SQLite via a Tauri plugin.
+ *
+ * Uses Tauri IPC to communicate with the `tauri-plugin-kora` Rust plugin,
+ * which provides native SQLite access with WAL mode, foreign keys, and
+ * proper connection management — zero WASM overhead.
+ *
+ * @example
+ * ```typescript
+ * import { TauriSqliteAdapter } from '@korajs/tauri'
+ *
+ * const adapter = new TauriSqliteAdapter({ path: 'my-app.db' })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With createApp (auto-detected in Tauri environments)
+ * import { createApp, defineSchema, t } from 'korajs'
+ *
+ * const app = createApp({
+ *   schema: defineSchema({
+ *     version: 1,
+ *     collections: {
+ *       todos: { fields: { title: t.string(), completed: t.boolean().default(false) } }
+ *     }
+ *   })
+ * })
+ * ```
+ */
+declare class TauriSqliteAdapter implements StorageAdapter {
+    private opened;
+    private invoker;
+    private readonly dbPath;
+    private readonly txMutex;
+    private inTransaction;
+    constructor(options?: TauriSqliteOptions);
+    private getInvoke;
+    private invoke;
+    /**
+     * Open or create the database. Generates DDL from the schema and sends it
+     * to the Rust plugin for execution. The plugin configures WAL mode,
+     * foreign keys, and other pragmas before running the DDL.
+     */
+    open(schema: SchemaDefinition): Promise<void>;
+    /**
+     * Close the database and release resources.
+     */
+    close(): Promise<void>;
+    /**
+     * Execute a write query (INSERT, UPDATE, DELETE).
+     */
+    execute(sql: string, params?: unknown[]): Promise<void>;
+    /**
+     * Execute a read query (SELECT).
+     */
+    query<T>(sql: string, params?: unknown[]): Promise<T[]>;
+    /**
+     * Execute multiple operations atomically within a transaction.
+     *
+     * Uses a mutex to prevent interleaving of concurrent transactions.
+     * The transaction is committed on success or rolled back on error.
+     */
+    transaction(fn: (tx: Transaction) => Promise<void>): Promise<void>;
+    /**
+     * Apply a schema migration within a transaction.
+     */
+    migrate(from: number, to: number, migration: MigrationPlan): Promise<void>;
+    private ensureOpen;
+}
+
+export { type InvokeFn, type MigrationPlan, type StorageAdapter, TauriAdapterError, TauriSqliteAdapter, type TauriSqliteOptions, TauriStoreNotOpenError, type Transaction };