@korajs/tauri 0.3.1

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(\n\t\t\t\t\t\t\t\t`Transaction query 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}\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 };

package/dist/index.js

@@ -0,0 +1,215 @@
+// src/tauri-sqlite-adapter.ts
+import { generateFullDDL } from "@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 = 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();
+    }
+  }
+};
+export {
+  TauriAdapterError,
+  TauriSqliteAdapter,
+  TauriStoreNotOpenError
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tauri-sqlite-adapter.ts"],"sourcesContent":["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(\n\t\t\t\t\t\t\t\t`Transaction query 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}\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/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@korajs/tauri",
+  "version": "0.3.1",
+  "description": "Tauri storage adapter for Kora.js — native SQLite with zero WASM overhead",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "plugin"
+  ],
+  "dependencies": {
+    "@korajs/core": "0.3.1"
+  },
+  "peerDependencies": {
+    "@tauri-apps/api": "^2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@tauri-apps/api": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "better-sqlite3": "^12.8.0",
+    "tsup": "^8.3.6",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.4",
+    "@korajs/store": "0.3.1"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo coverage"
+  }
+}

package/plugin/Cargo.toml

@@ -0,0 +1,19 @@
+[package]
+name = "tauri-plugin-kora"
+version = "0.1.0"
+edition = "2021"
+description = "Tauri plugin providing native SQLite storage for Kora.js applications"
+license = "MIT"
+repository = "https://github.com/nicholasgriffintn/kora"
+
+[dependencies]
+tauri = { version = "2", features = [] }
+tauri-plugin = { version = "2" }
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+thiserror = "2"
+rusqlite = { version = "0.32", features = ["bundled"] }
+log = "0.4"
+
+[build-dependencies]
+tauri-plugin = { version = "2", features = ["build"] }

package/plugin/build.rs

@@ -0,0 +1,5 @@
+const COMMANDS: &[&str] = &["open", "close", "execute", "query", "migrate"];
+
+fn main() {
+    tauri_plugin::Builder::new(COMMANDS).build();
+}

package/plugin/permissions/default.toml

@@ -0,0 +1,11 @@
+"$schema" = "schemas/schema.json"
+
+[default]
+description = "Default permissions for the Kora SQLite storage plugin. Grants access to all database operations."
+permissions = [
+    "allow-open",
+    "allow-close",
+    "allow-execute",
+    "allow-query",
+    "allow-migrate",
+]

package/plugin/src/commands.rs

@@ -0,0 +1,244 @@
+use std::collections::HashMap;
+use std::sync::Mutex;
+
+use rusqlite::{params_from_iter, Connection};
+use serde_json::Value as JsonValue;
+use tauri::{AppHandle, Manager, Runtime, State};
+
+use crate::error::Error;
+
+/// Managed state holding open database connections.
+/// Each database is identified by its file path.
+pub struct DbState {
+    pub connections: Mutex<HashMap<String, Connection>>,
+}
+
+impl Default for DbState {
+    fn default() -> Self {
+        Self {
+            connections: Mutex::new(HashMap::new()),
+        }
+    }
+}
+
+/// Convert a JSON value to a rusqlite parameter.
+fn json_to_param(value: &JsonValue) -> Box<dyn rusqlite::types::ToSql> {
+    match value {
+        JsonValue::Null => Box::new(rusqlite::types::Null),
+        JsonValue::Bool(b) => Box::new(if *b { 1i64 } else { 0i64 }),
+        JsonValue::Number(n) => {
+            if let Some(i) = n.as_i64() {
+                Box::new(i)
+            } else if let Some(f) = n.as_f64() {
+                Box::new(f)
+            } else {
+                Box::new(rusqlite::types::Null)
+            }
+        }
+        JsonValue::String(s) => Box::new(s.clone()),
+        // Arrays and objects are stored as JSON text
+        _ => Box::new(value.to_string()),
+    }
+}
+
+/// Open a database and execute DDL statements.
+/// Configures WAL mode, foreign keys, and other pragmas.
+#[tauri::command]
+pub fn open<R: Runtime>(
+    app: AppHandle<R>,
+    state: State<'_, DbState>,
+    path: String,
+    statements: Vec<String>,
+) -> Result<(), Error> {
+    let mut connections = state
+        .connections
+        .lock()
+        .map_err(|e| Error::Plugin(format!("Failed to acquire lock: {}", e)))?;
+
+    // Resolve the database path relative to the app's data directory
+    let db_path = if path == ":memory:" {
+        path.clone()
+    } else {
+        let data_dir = app
+            .path()
+            .app_data_dir()
+            .map_err(|e| Error::Plugin(format!("Failed to get app data dir: {}", e)))?;
+        std::fs::create_dir_all(&data_dir)?;
+        data_dir
+            .join(&path)
+            .to_string_lossy()
+            .into_owned()
+    };
+
+    let conn = Connection::open(&db_path)?;
+
+    // Configure SQLite for optimal performance and correctness
+    conn.pragma_update(None, "journal_mode", "WAL")?;
+    conn.pragma_update(None, "foreign_keys", "ON")?;
+    conn.pragma_update(None, "synchronous", "NORMAL")?;
+    conn.pragma_update(None, "busy_timeout", "5000")?;
+
+    // Execute DDL statements from the schema
+    for sql in &statements {
+        if sql.starts_with("--kora:safe-alter") {
+            // Safe ALTER TABLE — ignore "duplicate column name" errors
+            let clean_sql = sql.replace("--kora:safe-alter\n", "");
+            match conn.execute_batch(&clean_sql) {
+                Ok(_) => {}
+                Err(e) => {
+                    let msg = e.to_string();
+                    if !msg.contains("duplicate column name") {
+                        return Err(Error::Sqlite(e));
+                    }
+                }
+            }
+        } else {
+            conn.execute_batch(sql)?;
+        }
+    }
+
+    log::info!("Opened Kora database: {}", db_path);
+    connections.insert(path, conn);
+    Ok(())
+}
+
+/// Close a database connection.
+#[tauri::command]
+pub fn close(state: State<'_, DbState>, path: String) -> Result<(), Error> {
+    let mut connections = state
+        .connections
+        .lock()
+        .map_err(|e| Error::Plugin(format!("Failed to acquire lock: {}", e)))?;
+
+    if connections.remove(&path).is_some() {
+        log::info!("Closed Kora database: {}", path);
+    }
+    Ok(())
+}
+
+/// Execute a write query (INSERT, UPDATE, DELETE, or DDL like BEGIN/COMMIT/ROLLBACK).
+#[tauri::command]
+pub fn execute(
+    state: State<'_, DbState>,
+    path: String,
+    sql: String,
+    params: Vec<JsonValue>,
+) -> Result<(), Error> {
+    let connections = state
+        .connections
+        .lock()
+        .map_err(|e| Error::Plugin(format!("Failed to acquire lock: {}", e)))?;
+
+    let conn = connections
+        .get(&path)
+        .ok_or_else(|| Error::DatabaseNotLoaded(path.clone()))?;
+
+    if params.is_empty() {
+        // For statements without parameters (BEGIN, COMMIT, ROLLBACK, DDL)
+        conn.execute_batch(&sql)?;
+    } else {
+        let param_refs: Vec<Box<dyn rusqlite::types::ToSql>> =
+            params.iter().map(json_to_param).collect();
+        let param_slice: Vec<&dyn rusqlite::types::ToSql> =
+            param_refs.iter().map(|p| p.as_ref()).collect();
+        conn.execute(&sql, param_slice.as_slice())?;
+    }
+    Ok(())
+}
+
+/// Execute a read query (SELECT) and return results as JSON.
+#[tauri::command]
+pub fn query(
+    state: State<'_, DbState>,
+    path: String,
+    sql: String,
+    params: Vec<JsonValue>,
+) -> Result<Vec<HashMap<String, JsonValue>>, Error> {
+    let connections = state
+        .connections
+        .lock()
+        .map_err(|e| Error::Plugin(format!("Failed to acquire lock: {}", e)))?;
+
+    let conn = connections
+        .get(&path)
+        .ok_or_else(|| Error::DatabaseNotLoaded(path.clone()))?;
+
+    let param_refs: Vec<Box<dyn rusqlite::types::ToSql>> =
+        params.iter().map(json_to_param).collect();
+    let param_slice: Vec<&dyn rusqlite::types::ToSql> =
+        param_refs.iter().map(|p| p.as_ref()).collect();
+
+    let mut stmt = conn.prepare(&sql)?;
+    let column_names: Vec<String> = stmt
+        .column_names()
+        .iter()
+        .map(|s| s.to_string())
+        .collect();
+
+    let rows = stmt.query_map(param_slice.as_slice(), |row| {
+        let mut map = HashMap::new();
+        for (i, name) in column_names.iter().enumerate() {
+            let value: JsonValue = match row.get_ref(i) {
+                Ok(rusqlite::types::ValueRef::Null) => JsonValue::Null,
+                Ok(rusqlite::types::ValueRef::Integer(n)) => JsonValue::Number(n.into()),
+                Ok(rusqlite::types::ValueRef::Real(f)) => {
+                    match serde_json::Number::from_f64(f) {
+                        Some(n) => JsonValue::Number(n),
+                        None => JsonValue::Null,
+                    }
+                }
+                Ok(rusqlite::types::ValueRef::Text(s)) => {
+                    JsonValue::String(String::from_utf8_lossy(s).into_owned())
+                }
+                Ok(rusqlite::types::ValueRef::Blob(b)) => {
+                    // Encode blobs as hex strings for transport
+                    let hex: String = b.iter().map(|byte| format!("{:02x}", byte)).collect();
+                    JsonValue::String(hex)
+                }
+                Err(_) => JsonValue::Null,
+            };
+            map.insert(name.clone(), value);
+        }
+        Ok(map)
+    })?;
+
+    let mut results = Vec::new();
+    for row in rows {
+        results.push(row?);
+    }
+    Ok(results)
+}
+
+/// Apply a migration within a transaction.
+#[tauri::command]
+pub fn migrate(
+    state: State<'_, DbState>,
+    path: String,
+    statements: Vec<String>,
+) -> Result<(), Error> {
+    let connections = state
+        .connections
+        .lock()
+        .map_err(|e| Error::Plugin(format!("Failed to acquire lock: {}", e)))?;
+
+    let conn = connections
+        .get(&path)
+        .ok_or_else(|| Error::DatabaseNotLoaded(path.clone()))?;
+
+    conn.execute_batch("BEGIN")?;
+    match (|| -> Result<(), Error> {
+        for sql in &statements {
+            conn.execute_batch(sql)?;
+        }
+        Ok(())
+    })() {
+        Ok(_) => {
+            conn.execute_batch("COMMIT")?;
+            Ok(())
+        }
+        Err(e) => {
+            let _ = conn.execute_batch("ROLLBACK");
+            Err(e)
+        }
+    }
+}

package/plugin/src/error.rs

@@ -0,0 +1,27 @@
+use serde::Serialize;
+
+/// Errors that can occur in the Kora SQLite plugin.
+#[derive(Debug, thiserror::Error)]
+pub enum Error {
+    #[error("Database not loaded: {0}")]
+    DatabaseNotLoaded(String),
+
+    #[error("SQLite error: {0}")]
+    Sqlite(#[from] rusqlite::Error),
+
+    #[error("IO error: {0}")]
+    Io(#[from] std::io::Error),
+
+    #[error("Plugin error: {0}")]
+    Plugin(String),
+}
+
+// Tauri requires errors to implement Serialize to send them across the IPC boundary.
+impl Serialize for Error {
+    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
+    where
+        S: serde::ser::Serializer,
+    {
+        serializer.serialize_str(self.to_string().as_ref())
+    }
+}

package/plugin/src/lib.rs

@@ -0,0 +1,56 @@
+//! # tauri-plugin-kora
+//!
+//! Tauri plugin providing native SQLite storage for Kora.js applications.
+//!
+//! This plugin exposes SQLite operations via Tauri IPC commands, configured with
+//! WAL mode, foreign keys, and proper pragmas for optimal offline-first performance.
+//!
+//! ## Setup
+//!
+//! Add the plugin to your Tauri app:
+//!
+//! ```rust,no_run
+//! fn main() {
+//!     tauri::Builder::default()
+//!         .plugin(tauri_plugin_kora::init())
+//!         .run(tauri::generate_context!())
+//!         .expect("error while running tauri application");
+//! }
+//! ```
+//!
+//! Then add the permissions to your `capabilities/default.json`:
+//!
+//! ```json
+//! {
+//!   "permissions": ["kora-sqlite:default"]
+//! }
+//! ```
+
+mod commands;
+mod error;
+
+use commands::DbState;
+use tauri::{
+    plugin::{Builder as PluginBuilder, TauriPlugin},
+    Manager, Runtime,
+};
+
+/// Initialize the Kora SQLite plugin.
+///
+/// Registers IPC command handlers for database operations and manages
+/// the lifecycle of SQLite connections.
+pub fn init<R: Runtime>() -> TauriPlugin<R> {
+    PluginBuilder::new("kora-sqlite")
+        .setup(|app, _api| {
+            app.manage(DbState::default());
+            Ok(())
+        })
+        .invoke_handler(tauri::generate_handler![
+            commands::open,
+            commands::close,
+            commands::execute,
+            commands::query,
+            commands::migrate,
+        ])
+        .build()
+}