@yina-npm/openrouterx 0.4.28 → 0.4.32

package/app/public/i18n/literals/pt-PT.json

@@ -203,5 +203,6 @@
   "Open New Antigravity": "Open New Antigravity",
   "Open a new Antigravity window with MITM enabled": "Open a new Antigravity window with MITM enabled",
   "Opened new Antigravity": "Opened new Antigravity",
-  "Open New": "Open New"
+  "Open New": "Open New",
+  "Focus UI": "Focus UI"
 }

package/app/public/i18n/literals/ro.json

@@ -203,5 +203,6 @@
   "Open New Antigravity": "Open New Antigravity",
   "Open a new Antigravity window with MITM enabled": "Open a new Antigravity window with MITM enabled",
   "Opened new Antigravity": "Opened new Antigravity",
-  "Open New": "Open New"
+  "Open New": "Open New",
+  "Focus UI": "Focus UI"
 }

package/app/public/i18n/literals/ru.json

@@ -203,5 +203,6 @@
   "Open New Antigravity": "Открыть новый Antigravity",
   "Open a new Antigravity window with MITM enabled": "Открыть новое окно Antigravity с включенным MITM",
   "Opened new Antigravity": "Новый Antigravity открыт",
-  "Open New": "Открыть новый"
+  "Open New": "Открыть новый",
+  "Focus UI": "Фокус UI"
 }

package/app/public/i18n/literals/sv.json

@@ -203,5 +203,6 @@
   "Open New Antigravity": "Open New Antigravity",
   "Open a new Antigravity window with MITM enabled": "Open a new Antigravity window with MITM enabled",
   "Opened new Antigravity": "Opened new Antigravity",
-  "Open New": "Open New"
+  "Open New": "Open New",
+  "Focus UI": "Focus UI"
 }

package/app/public/i18n/literals/th.json

@@ -203,5 +203,6 @@
   "Open New Antigravity": "Open New Antigravity",
   "Open a new Antigravity window with MITM enabled": "Open a new Antigravity window with MITM enabled",
   "Opened new Antigravity": "Opened new Antigravity",
-  "Open New": "Open New"
+  "Open New": "Open New",
+  "Focus UI": "Focus UI"
 }

package/app/public/i18n/literals/tl.json

@@ -203,5 +203,6 @@
   "Open New Antigravity": "Open New Antigravity",
   "Open a new Antigravity window with MITM enabled": "Open a new Antigravity window with MITM enabled",
   "Opened new Antigravity": "Opened new Antigravity",
-  "Open New": "Open New"
+  "Open New": "Open New",
+  "Focus UI": "Focus UI"
 }

package/app/public/i18n/literals/tr.json

@@ -203,5 +203,6 @@
   "Open New Antigravity": "Open New Antigravity",
   "Open a new Antigravity window with MITM enabled": "Open a new Antigravity window with MITM enabled",
   "Opened new Antigravity": "Opened new Antigravity",
-  "Open New": "Open New"
+  "Open New": "Open New",
+  "Focus UI": "Focus UI"
 }

package/app/public/i18n/literals/uk.json

@@ -203,5 +203,6 @@
   "Open New Antigravity": "Open New Antigravity",
   "Open a new Antigravity window with MITM enabled": "Open a new Antigravity window with MITM enabled",
   "Opened new Antigravity": "Opened new Antigravity",
-  "Open New": "Open New"
+  "Open New": "Open New",
+  "Focus UI": "Focus UI"
 }

package/app/public/i18n/literals/ur.json

@@ -203,5 +203,6 @@
   "Open New Antigravity": "Open New Antigravity",
   "Open a new Antigravity window with MITM enabled": "Open a new Antigravity window with MITM enabled",
   "Opened new Antigravity": "Opened new Antigravity",
-  "Open New": "Open New"
+  "Open New": "Open New",
+  "Focus UI": "Focus UI"
 }

package/app/public/i18n/literals/vi.json

@@ -203,5 +203,6 @@
   "Open New Antigravity": "Open New Antigravity",
   "Open a new Antigravity window with MITM enabled": "Open a new Antigravity window with MITM enabled",
   "Opened new Antigravity": "Opened new Antigravity",
-  "Open New": "Open New"
+  "Open New": "Open New",
+  "Focus UI": "Focus UI"
 }

package/app/public/i18n/literals/zh-CN.json

@@ -117,6 +117,10 @@
   "Checking Factory Droid CLI...": "检查 Factory Droid CLI...",
   "Checking Open Claw CLI...": "正在检查 Open Claw CLI...",
   "Checking OpenCode CLI...": "检查 OpenCode CLI...",
+  "Checking Cline...": "正在检查 Cline...",
+  "Checking Kilo Code...": "正在检查 Kilo Code...",
+  "Checking Hermes Agent...": "正在检查 Hermes Agent...",
+  "Checking Claude Cowork...": "正在检查 Claude Cowork...",
   "Checking...": "检查中...",
   "Choose your authentication method:": "选择您的身份验证方法：",
   "Claude": "Claude",
@@ -152,6 +156,7 @@
   "Compress tool output to reduce token usage.": "压缩工具输出以减少 Token 使用量。",
   "Configure a new AI provider to use with your applications.": "配置新的 AI 提供程序以与您的应用程序一起使用。",
   "Configure CLI tools": "配置 CLI 工具",
+  "Configure local coding tools to use your openrouterX providers.": "配置本地编码工具以使用你的 openrouterX 提供商。",
   "Configure pricing rates for cost tracking and calculations": "配置定价以进行成本跟踪和计算",
   "Configured outbound proxy timed out": "配置的出站代理超时",
   "Confirm": "确认",
@@ -331,6 +336,7 @@
   "How Pricing Works": "定价如何运作",
   "How to get cookie:": "如何获取cookie：",
   "How to Install": "如何安装",
+  "Hide": "隐藏",
   "IDC Start URL": "IDC 起始 URL",
   "If provider lacks /models endpoint, enter a model ID to validate via chat/completions instead.": "如果提供商不支持 /models 端点，请输入模型 ID 通过 chat/completions 进行验证。",
   "iFlow AI": "iFlow AI",
@@ -354,6 +360,8 @@
   "Install OpenrouterX": "安装 OpenrouterX",
   "Install Tailscale": "安装 Tailscale",
   "Installation Guide": "安装指南",
+  "Install Cline VS Code extension or CLI from": "从以下位置安装 Cline VS Code 扩展或 CLI：",
+  "Install Kilo Code from": "从以下位置安装 Kilo Code：",
   "Installing Tailscale...": "正在安装 Tailscale...",
   "Interactive diagram visible on desktop": "桌面上可见的交互式图表",
   "Intercept CLI tool traffic and route through OpenrouterX": "拦截 CLI 工具流量并通过 OpenrouterX 路由",
@@ -511,9 +519,24 @@
   "OpenAI Response": "OpenAI 响应",
   "OpenCode - Manual Configuration": "OpenCode - 手动配置",
   "OpenCode CLI not installed": "未安装 OpenCode CLI",
+  "Claude CLI not detected locally": "未在本机检测到 Claude CLI",
+  "Codex CLI not detected locally": "未在本机检测到 Codex CLI",
+  "Codex CLI status unavailable": "无法获取 Codex CLI 状态",
+  "OpenCode CLI not detected locally": "未在本机检测到 OpenCode CLI",
+  "Factory Droid CLI not detected locally": "未在本机检测到 Factory Droid CLI",
+  "Open Claw CLI not detected locally": "未在本机检测到 Open Claw CLI",
+  "Hermes Agent not detected locally": "未在本机检测到 Hermes Agent",
+  "Cline not detected locally": "未在本机检测到 Cline",
+  "Kilo Code not detected locally": "未在本机检测到 Kilo Code",
+  "Claude Desktop (Cowork mode) not detected": "未检测到 Claude Desktop（Cowork 模式）",
+  "Manual configuration is still available if openrouterX is deployed on a remote server.": "如果 openrouterX 部署在远程服务器上，仍可使用手动配置。",
+  "Manual configuration is still available if OpenrouterX is deployed on a remote server.": "如果 OpenrouterX 部署在远程服务器上，仍可使用手动配置。",
+  "Click \"Apply\" to auto-configure.": "点击“应用”自动配置。",
+  "After installation, run": "安装后运行",
+  "to verify.": "进行验证。",
   "OpenRouter": "OpenRouter",
   "OpenRouter supports any model. Add models and create aliases for quick access.": "OpenRouter 支持任何模型。添加模型并创建别名以便快速访问。",
-  "OpenrouterX Base URL": "OpenrouterX 基础 URL",
+  "OpenrouterX Base URL": "base URL",
   "OpenrouterX fell back after the configured proxy connection timed out. Because the app stores this as a targeted proxy allowlist, the failure affects selected upstream API calls rather than macOS global networking.": "配置的代理连接超时后，OpenrouterX 已回退。由于应用将其作为定向代理白名单保存，该故障影响的是选定的上游 API 调用，而不是 macOS 全局网络。",
   "Other": "其他",
   "Our engine analyzes the prompt and routes through your subscription, cheap, and free provider tiers with automatic fallback.": "我们的引擎分析提示词并通过您的订阅、低价和免费提供商层级路由，自动回退。",
@@ -826,5 +849,104 @@
   "Open New Antigravity": "新开 Antigravity",
   "Open a new Antigravity window with MITM enabled": "新开一个启用 MITM 的 Antigravity 窗口",
   "Opened new Antigravity": "已新开 Antigravity",
-  "Open New": "新开"
+  "Open New": "新开",
+  "Focus UI": "关注UI",
+  "Amp CLI": "Amp CLI",
+  "Sourcegraph Amp coding assistant CLI": "Sourcegraph Amp 编程助手 CLI",
+  "Use openrouterX model aliases to keep Amp shorthand mappings stable across provider updates.": "使用 openrouterX 模型别名，让 Amp 快捷模型名在提供商更新后仍保持稳定。",
+  "Suggested shorthand examples: g25p → gemini/gemini-2.5-pro, g25f → gemini/gemini-2.5-flash, cs45 → cc/claude-sonnet-4-5-20250929.": "快捷名示例：g25p → gemini/gemini-2.5-pro，g25f → gemini/gemini-2.5-flash，cs45 → cc/claude-sonnet-4-5-20250929。",
+  "Install Amp": "安装 Amp",
+  "Install the Amp CLI using the package manager supported by your environment.": "使用当前环境支持的包管理器安装 Amp CLI。",
+  "Add Shorthands": "添加快捷名",
+  "Map Amp shorthand names such as g25p or cs45 to openrouterX aliases in your local config.": "在本地配置中把 g25p、cs45 等 Amp 快捷名映射到 openrouterX 别名。",
+  "Qwen Code": "Qwen Code",
+  "Alibaba Qwen Code CLI — supports OpenAI, Anthropic & Gemini providers via openrouterX": "阿里 Qwen Code CLI — 通过 openrouterX 支持 OpenAI、Anthropic 和 Gemini 提供商",
+  "Qwen Code supports multiple provider types (openai, anthropic, gemini) via modelProviders in settings.json. openrouterX works as an OpenAI-compatible endpoint.": "Qwen Code 可通过 settings.json 里的 modelProviders 支持多种提供商类型（openai、anthropic、gemini）。openrouterX 作为 OpenAI 兼容端点使用。",
+  "Any model available in openrouterX can be used — not just Qwen models. Select from Qwen, Claude, Gemini, GPT, and more.": "openrouterX 中可用的任何模型都可以使用，不限于 Qwen 模型。可选择 Qwen、Claude、Gemini、GPT 等。",
+  "Config path: Linux/macOS ~/.qwen/settings.json • Windows %USERPROFILE%\\.qwen\\settings.json": "配置路径：Linux/macOS ~/.qwen/settings.json • Windows %USERPROFILE%\\.qwen\\settings.json",
+  "Qwen OAuth free tier was discontinued on 2026-04-15. Use openrouterX with alicode/openrouter/anthropic/gemini providers instead.": "Qwen OAuth 免费额度已于 2026-04-15 停用。请改用 openrouterX 搭配 alicode/openrouter/anthropic/gemini 提供商。",
+  "Install Qwen Code": "安装 Qwen Code",
+  "Save Config": "保存配置",
+  "Copy the JSON below to your ~/.qwen/settings.json file.": "将下方 JSON 复制到 ~/.qwen/settings.json 文件。",
+  "Global Fast": "全局快速",
+  "My Fast": "我的快速",
+  "Enable Codex Fast Mode for this sub-user": "为此子用户启用 Codex 快速模式",
+  "Fast On": "快速开",
+  "Fast Off": "快速关",
+  "User Management": "用户管理",
+  "Manage sub-users and their permissions": "管理子用户及其权限",
+  "+ Add Sub-user": "+ 添加子用户",
+  "No sub-users yet. Create one to get started.": "还没有子用户。创建一个即可开始。",
+  "Create Sub-user": "创建子用户",
+  "Username": "用户名",
+  "Display Name": "显示名称",
+  "Password": "密码",
+  "Permissions": "权限",
+  "Allow Quota Tracker for this sub-user": "允许此子用户使用配额跟踪",
+  "Quota On": "配额开",
+  "Quota Off": "配额关",
+  "New Password (leave blank to keep)": "新密码（留空则保持不变）",
+  "Delete User": "删除用户",
+  "Allowed Providers & Accounts": "允许的提供商和账号",
+  "Connect providers first, then assign them to this sub-user.": "请先连接提供商，然后分配给此子用户。",
+  "Only selected providers and selected provider accounts will be visible and usable for this sub-user.": "只有选中的提供商和账号会对此子用户可见且可用。",
+  "No providers enabled": "未启用提供商",
+  "No accounts": "没有账号",
+  "API Key Management": "API 密钥管理",
+  "Key Management": "密钥管理",
+  "Assign Key:": "分配密钥：",
+  "assigned": "已分配",
+  "Assign API keys to sub-users. Only the assigned user can use that key.": "将 API 密钥分配给子用户。只有被分配的用户可以使用该密钥。",
+  "No API keys yet. Create one in the Endpoint page.": "还没有 API 密钥。请在 Endpoint 页面创建一个。",
+  "Unassigned (Admin)": "未分配（管理员）",
+  "Assign to User": "分配给用户",
+  "Reassign": "重新分配",
+  "Assign to user": "分配给用户",
+  "— Unassigned (Admin only) —": "— 未分配（仅管理员）—",
+  "OIDC Dashboard Login": "OIDC 控制面板登录",
+  "OIDC active": "OIDC 已启用",
+  "Password + OIDC active": "密码 + OIDC 已启用",
+  "Optional SSO via Authentik/Keycloak/Google": "可选：通过 Authentik/Keycloak/Google 单点登录",
+  "Use Authentik or any OIDC provider to sign in to the dashboard. You can enable password-only, OIDC-only, or both for the dashboard; model API access still uses API keys.": "使用 Authentik 或任何 OIDC 提供商登录控制面板。控制面板可设置为仅密码、仅 OIDC，或两者都允许；模型 API 访问仍使用 API Key。",
+  "Auth Mode": "认证模式",
+  "Password only": "仅密码",
+  "Keep the legacy password login.": "保留原有密码登录。",
+  "OIDC only": "仅 OIDC",
+  "Require OIDC for dashboard access.": "访问控制面板时必须使用 OIDC。",
+  "Both": "两者都允许",
+  "Allow either password or OIDC.": "允许使用密码或 OIDC 登录。",
+  "Issuer URL": "Issuer URL",
+  "Client ID": "客户端 ID",
+  "Client Secret": "客户端密钥",
+  "Leave blank to keep existing secret": "留空则保留现有密钥",
+  "This value is write-only after saving.": "保存后该值只可写入，不会再明文显示。",
+  "Scopes": "授权范围",
+  "Login Button Label": "登录按钮文字",
+  "Sign in with OIDC": "使用 OIDC 登录",
+  "Redirect URI": "重定向 URI",
+  "Save auth mode": "保存认证模式",
+  "Test connection": "测试连接",
+  "Issuer URL, client ID, and client secret are required to enable OIDC.": "启用 OIDC 需要填写 Issuer URL、客户端 ID 和客户端密钥。",
+  "OIDC login enabled": "OIDC 登录已启用",
+  "Password and OIDC login enabled": "密码和 OIDC 登录已启用",
+  "OIDC settings saved": "OIDC 设置已保存",
+  "Failed to save OIDC settings": "保存 OIDC 设置失败",
+  "Issuer URL and client ID are required to test the connection.": "测试连接需要填写 Issuer URL 和客户端 ID。",
+  "Failed to save OIDC settings before testing": "测试前保存 OIDC 设置失败",
+  "OIDC connection test failed": "OIDC 连接测试失败",
+  "OIDC login is currently active. Password login is disabled until you switch back.": "当前已启用 OIDC 登录。切回之前，密码登录将被禁用。",
+  "Password and OIDC login are both active.": "密码登录和 OIDC 登录当前都已启用。",
+  "Sign in to access the dashboard": "登录以访问控制面板",
+  "or": "或",
+  "Super Admin": "超级管理员",
+  "Sub User": "子用户",
+  "Select user": "选择用户",
+  "— Select a user —": "— 选择用户 —",
+  "Your password": "你的密码",
+  "Admin password": "管理员密码",
+  "Sign In": "登录",
+  "Invalid credentials": "账号或密码无效",
+  "An error occurred. Please try again.": "发生错误，请重试。",
+  "OIDC user": "OIDC 用户",
+  "Password user": "密码用户"
 }

package/app/public/i18n/literals/zh-TW.json

@@ -256,5 +256,6 @@
   "Open New Antigravity": "新開 Antigravity",
   "Open a new Antigravity window with MITM enabled": "新開一個啟用 MITM 的 Antigravity 視窗",
   "Opened new Antigravity": "已新開 Antigravity",
-  "Open New": "新開"
+  "Open New": "新開",
+  "Focus UI": "關注UI"
 }

package/app/src/lib/db/adapters/betterSqliteAdapter.js

@@ -0,0 +1,55 @@
+import Database from "better-sqlite3";
+import { PRAGMA_SQL } from "../schema.js";
+
+// Periodic checkpoint to keep WAL file small (avoid huge -wal/-shm growth)
+const CHECKPOINT_INTERVAL_MS = 60 * 1000;
+
+export function createBetterSqliteAdapter(filePath) {
+  const db = new Database(filePath);
+  db.exec(PRAGMA_SQL);
+  // Schema is created/synced by migrate.js after adapter init
+
+  const stmtCache = new Map();
+
+  function prepare(sql) {
+    let stmt = stmtCache.get(sql);
+    if (!stmt) {
+      stmt = db.prepare(sql);
+      stmtCache.set(sql, stmt);
+    }
+    return stmt;
+  }
+
+  // Truncate WAL periodically so file stays small for backup/copy
+  const checkpointTimer = setInterval(() => {
+    try { db.pragma("wal_checkpoint(TRUNCATE)"); } catch {}
+  }, CHECKPOINT_INTERVAL_MS);
+  if (typeof checkpointTimer.unref === "function") checkpointTimer.unref();
+
+  function gracefulClose() {
+    try { db.pragma("wal_checkpoint(TRUNCATE)"); } catch {}
+    try { stmtCache.clear(); } catch {}
+    try { db.close(); } catch {}
+  }
+
+  // Ensure WAL is flushed and -wal/-shm files removed on shutdown
+  const onShutdown = () => gracefulClose();
+  process.once("beforeExit", onShutdown);
+  process.once("SIGINT", () => { onShutdown(); process.exit(0); });
+  process.once("SIGTERM", () => { onShutdown(); process.exit(0); });
+
+  return {
+    driver: "better-sqlite3",
+    run(sql, params = []) { return prepare(sql).run(params); },
+    get(sql, params = []) { return prepare(sql).get(params); },
+    all(sql, params = []) { return prepare(sql).all(params); },
+    exec(sql) { return db.exec(sql); },
+    transaction(fn) { return db.transaction(fn)(); },
+    checkpoint() { try { db.pragma("wal_checkpoint(TRUNCATE)"); } catch {} },
+    close() {
+      clearInterval(checkpointTimer);
+      gracefulClose();
+    },
+    raw: db,
+  };
+}

package/app/src/lib/db/adapters/bunSqliteAdapter.js

@@ -0,0 +1,63 @@
+// Bun runtime adapter — uses built-in bun:sqlite (native, fastest under Bun).
+// Loaded only when process.versions.bun is present.
+import { PRAGMA_SQL } from "../schema.js";
+
+const CHECKPOINT_INTERVAL_MS = 60 * 1000;
+
+export async function createBunSqliteAdapter(filePath) {
+  // Dynamic import — only resolves under Bun runtime
+  const { Database } = await import("bun:sqlite");
+  const db = new Database(filePath, { create: true });
+  db.exec(PRAGMA_SQL);
+
+  const stmtCache = new Map();
+  function prepare(sql) {
+    let stmt = stmtCache.get(sql);
+    if (!stmt) {
+      stmt = db.prepare(sql);
+      stmtCache.set(sql, stmt);
+    }
+    return stmt;
+  }
+
+  const checkpointTimer = setInterval(() => {
+    try { db.exec("PRAGMA wal_checkpoint(TRUNCATE)"); } catch {}
+  }, CHECKPOINT_INTERVAL_MS);
+  if (typeof checkpointTimer.unref === "function") checkpointTimer.unref();
+
+  function gracefulClose() {
+    try { db.exec("PRAGMA wal_checkpoint(TRUNCATE)"); } catch {}
+    try { stmtCache.clear(); } catch {}
+    try { db.close(); } catch {}
+  }
+  const onShutdown = () => gracefulClose();
+  process.once("beforeExit", onShutdown);
+  process.once("SIGINT", () => { onShutdown(); process.exit(0); });
+  process.once("SIGTERM", () => { onShutdown(); process.exit(0); });
+
+  return {
+    driver: "bun:sqlite",
+    run(sql, params = []) {
+      const r = prepare(sql).run(...params);
+      return { changes: Number(r.changes ?? 0), lastInsertRowid: Number(r.lastInsertRowid ?? 0) };
+    },
+    get(sql, params = []) {
+      return prepare(sql).get(...params);
+    },
+    all(sql, params = []) {
+      return prepare(sql).all(...params);
+    },
+    exec(sql) { return db.exec(sql); },
+    transaction(fn) {
+      // bun:sqlite has db.transaction() API (similar to better-sqlite3)
+      const tx = db.transaction(fn);
+      return tx();
+    },
+    checkpoint() { try { db.exec("PRAGMA wal_checkpoint(TRUNCATE)"); } catch {} },
+    close() {
+      clearInterval(checkpointTimer);
+      gracefulClose();
+    },
+    raw: db,
+  };
+}

package/app/src/lib/db/adapters/nodeSqliteAdapter.js

@@ -0,0 +1,84 @@
+// Built-in node:sqlite adapter — available in Node >= 22.5.0.
+// No native build, no npm install. API mirrors betterSqliteAdapter.
+import { PRAGMA_SQL } from "../schema.js";
+
+const CHECKPOINT_INTERVAL_MS = 60 * 1000;
+
+export async function createNodeSqliteAdapter(filePath) {
+  // Suppress "ExperimentalWarning: SQLite is an experimental feature" from node:sqlite.
+  // Stable enough for production use as of Node 22.x (RC quality).
+  const origEmit = process.emit;
+  process.emit = function (name, data, ...rest) {
+    if (name === "warning" && data?.name === "ExperimentalWarning" && /SQLite/i.test(data.message || "")) {
+      return false;
+    }
+    return origEmit.call(process, name, data, ...rest);
+  };
+
+  // Dynamic import — fails on Node < 22.5 → driver.js falls back to sql.js
+  const sqlite = await import("node:sqlite");
+  const Database = sqlite.DatabaseSync;
+  const db = new Database(filePath);
+
+  db.exec(PRAGMA_SQL);
+
+  const stmtCache = new Map();
+  function prepare(sql) {
+    let stmt = stmtCache.get(sql);
+    if (!stmt) {
+      stmt = db.prepare(sql);
+      stmtCache.set(sql, stmt);
+    }
+    return stmt;
+  }
+
+  // Periodic WAL checkpoint to keep -wal/-shm small
+  const checkpointTimer = setInterval(() => {
+    try { db.exec("PRAGMA wal_checkpoint(TRUNCATE)"); } catch {}
+  }, CHECKPOINT_INTERVAL_MS);
+  if (typeof checkpointTimer.unref === "function") checkpointTimer.unref();
+
+  function gracefulClose() {
+    try { db.exec("PRAGMA wal_checkpoint(TRUNCATE)"); } catch {}
+    try { stmtCache.clear(); } catch {}
+    try { db.close(); } catch {}
+  }
+  const onShutdown = () => gracefulClose();
+  process.once("beforeExit", onShutdown);
+  process.once("SIGINT", () => { onShutdown(); process.exit(0); });
+  process.once("SIGTERM", () => { onShutdown(); process.exit(0); });
+
+  return {
+    driver: "node:sqlite",
+    run(sql, params = []) {
+      const r = prepare(sql).run(...params);
+      return { changes: Number(r.changes ?? 0), lastInsertRowid: Number(r.lastInsertRowid ?? 0) };
+    },
+    get(sql, params = []) {
+      return prepare(sql).get(...params);
+    },
+    all(sql, params = []) {
+      return prepare(sql).all(...params);
+    },
+    exec(sql) { return db.exec(sql); },
+    transaction(fn) {
+      // node:sqlite has no transaction wrapper. Use SAVEPOINT for nested support.
+      const sp = `sp_${Math.random().toString(36).slice(2)}`;
+      db.exec(`SAVEPOINT ${sp}`);
+      try {
+        const r = fn();
+        db.exec(`RELEASE ${sp}`);
+        return r;
+      } catch (e) {
+        try { db.exec(`ROLLBACK TO ${sp}`); db.exec(`RELEASE ${sp}`); } catch {}
+        throw e;
+      }
+    },
+    checkpoint() { try { db.exec("PRAGMA wal_checkpoint(TRUNCATE)"); } catch {} },
+    close() {
+      clearInterval(checkpointTimer);
+      gracefulClose();
+    },
+    raw: db,
+  };
+}

package/app/src/lib/db/adapters/sqljsAdapter.js

@@ -0,0 +1,115 @@
+import fs from "node:fs";
+import initSqlJs from "sql.js";
+import { PRAGMA_SQL } from "../schema.js";
+
+let SQL = null;
+
+async function loadSql() {
+  if (SQL) return SQL;
+  SQL = await initSqlJs();
+  return SQL;
+}
+
+export async function createSqlJsAdapter(filePath) {
+  const SQLLib = await loadSql();
+  const buf = fs.existsSync(filePath) ? fs.readFileSync(filePath) : null;
+  const db = new SQLLib.Database(buf);
+  db.exec(PRAGMA_SQL);
+  // Schema is created/synced by migrate.js after adapter init
+
+  let dirty = false;
+  let saveTimer = null;
+  const SAVE_DEBOUNCE_MS = 100;
+
+  function persist() {
+    const data = db.export();
+    fs.writeFileSync(filePath, Buffer.from(data));
+    dirty = false;
+  }
+
+  function scheduleSave() {
+    dirty = true;
+    if (saveTimer) clearTimeout(saveTimer);
+    saveTimer = setTimeout(() => {
+      saveTimer = null;
+      if (dirty) {
+        try { persist(); } catch (e) { console.error("[sqljs] save failed:", e); }
+      }
+    }, SAVE_DEBOUNCE_MS);
+  }
+
+  function paramsObj(params) {
+    if (!params || (Array.isArray(params) && params.length === 0)) return undefined;
+    return params;
+  }
+
+  function run(sql, params = []) {
+    const stmt = db.prepare(sql);
+    try {
+      stmt.bind(paramsObj(params));
+      stmt.step();
+      const changes = db.getRowsModified();
+      const lastInsertRowid = db.exec("SELECT last_insert_rowid() as id")[0]?.values?.[0]?.[0] ?? null;
+      scheduleSave();
+      return { changes, lastInsertRowid };
+    } finally {
+      stmt.free();
+    }
+  }
+
+  function get(sql, params = []) {
+    const stmt = db.prepare(sql);
+    try {
+      stmt.bind(paramsObj(params));
+      if (stmt.step()) return stmt.getAsObject();
+      return undefined;
+    } finally {
+      stmt.free();
+    }
+  }
+
+  function all(sql, params = []) {
+    const stmt = db.prepare(sql);
+    try {
+      stmt.bind(paramsObj(params));
+      const rows = [];
+      while (stmt.step()) rows.push(stmt.getAsObject());
+      return rows;
+    } finally {
+      stmt.free();
+    }
+  }
+
+  function exec(sql) {
+    db.exec(sql);
+    scheduleSave();
+  }
+
+  function transaction(fn) {
+    const sp = `sp_${Math.random().toString(36).slice(2)}`;
+    db.exec(`SAVEPOINT ${sp}`);
+    try {
+      const result = fn();
+      db.exec(`RELEASE ${sp}`);
+      scheduleSave();
+      return result;
+    } catch (e) {
+      try { db.exec(`ROLLBACK TO ${sp}`); db.exec(`RELEASE ${sp}`); } catch {}
+      throw e;
+    }
+  }
+
+  function close() {
+    if (saveTimer) clearTimeout(saveTimer);
+    if (dirty) persist();
+    db.close();
+  }
+
+  // Flush on shutdown
+  const flush = () => { if (dirty) try { persist(); } catch {} };
+  process.on("beforeExit", flush);
+  process.on("SIGINT", flush);
+  process.on("SIGTERM", flush);
+
+  return { driver: "sql.js", run, get, all, exec, transaction, close, raw: db };
+}