chanjs 2.7.15 → 2.7.17

package/README.md

@@ -20,7 +20,7 @@
 
 ### 核心架构
 
-- 原生基于 Express 5+
+- 原生基于 Express 5+ mysql/pgsql/sqlite 三款数据库支持
 - 最低运行环境 Node.js 22.18+
 - 全量 ES Modules（import / export）
 - **标准 HMVC 架构：模块自治 + 双通道跨模块协作**

package/core/App.js

@@ -151,7 +151,7 @@ export default class Chan {
       const dbKey = dbCfg.key ?? String(idx);
       let conn;
       try {
-        conn = this.dbManager.add(dbKey, dbCfg, { isDefault: idx === 0 });
+        conn = await this.dbManager.add(dbKey, dbCfg, { isDefault: idx === 0 });
         // 首个成功连接即作为默认 this.db，避免 idx===0 失败时 this.db 恒为 null
         if (!this.db) this.db = conn;
       } catch (err) {

package/core/Database.js

@@ -4,6 +4,29 @@ import logger from "../utils/logger.js";
 const DEFAULT_NAME = "default";
 const DEFAULT_SLOW_THRESHOLD = 200;  // 慢查询阈值（ms），可运行时调整
 
+/**
+ * 自定义 dialect 别名 → 客户端类（异步工厂）。
+ * config 中 client 只写字符串（如 "sqlite"），由框架在此按类型自动挂载驱动，
+ * 业务侧无需 import 客户端实现。
+ * 必须动态 import：sqlite 适配器依赖内建模块 node:sqlite（Node 22+），
+ * 静态引入会在 ESM 加载期解析导致低版本 Node 连 mysql/pg 也无法启动。
+ */
+const CUSTOM_CLIENTS = Object.freeze({
+  sqlite: () => import("./adaptor/sqliteAdapter.js").then((m) => m.default),
+});
+
+/** 把配置中的方言字符串解析为 knex 客户端类（按需加载；无匹配则原样返回） */
+async function resolveClient(config) {
+  if (config && typeof config.client === "string") {
+    const loader = CUSTOM_CLIENTS[config.client];
+    if (loader) {
+      const Client = await loader();
+      return { ...config, client: Client };
+    }
+  }
+  return config;
+}
+
 /**
  * 多 Knex 连接管理器：统一管理连接、心跳、批量销毁、慢查询监控。
  *
@@ -36,10 +59,10 @@ class DatabaseManager {
    * @param {string} name - 连接标识
    * @param {object} config - Knex 配置
    * @param {{isDefault?: boolean}} [opts]
-   * @returns {import("knex").Knex}
+   * @returns {Promise<import("knex").Knex>}
    */
-  add(name, config, { isDefault = false } = {}) {
-    const conn = knex(config);
+  async add(name, config, { isDefault = false } = {}) {
+    const conn = knex(await resolveClient(config));
     this._connections.set(name, conn);
     if (isDefault || this._connections.size === 1) this._defaultName = name;
 

package/core/Repository.js

@@ -256,8 +256,14 @@ class Repository extends BaseComponent {
     return { success:true, code:CODE_OK, msg:"删除成功", data:{ affectedRows:rows } };
   }
 
-  /** 按条件更新记录 */
-  async update({ query, data }={}) {
+  /**
+   * 更新内部原语（私有方法）：子类无法覆写。
+   * 历史教训：此前 updateById 直接调 this.update({query,data})，
+   * 业务 Service 普遍以扁平 body 形状覆写 update(body)，多态派发回子类后
+   * {query,data} 被解构成 id=undefined → 更新静默失效（无 SQL、仍返回旧数据）。
+   * 框架内部路径必须走本私有方法，杜绝该类命名冲突。
+   */
+  async #updateRaw(query, data) {
     this._checkDB();
     if (!query || !data || !Object.keys(query).length || !Object.keys(data).length) {
       return { success:false, code:CODE_PARAM_INVALID, msg:"参数无效", data:{} };
@@ -270,10 +276,16 @@ class Repository extends BaseComponent {
     return { success:true, code:CODE_OK, msg:"更新成功", data:{ affectedRows:rows } };
   }
 
-  /** 根据ID更新，返回更新后完整数据（复用 update 走统一 applyQuery 校验） */
+  /** 按条件更新记录 */
+  async update({ query, data }={}) {
+    return this.#updateRaw(query, data);
+  }
+
+  /** 根据ID更新，返回更新后完整数据；失败不再被忽略，直接透传错误体 */
   async updateById(id, data={}) {
     if (!id || !Object.keys(data).length) return { success:false, code:CODE_PARAM_INVALID, msg:"参数无效", data:{} };
-    await this.update({ query: { id }, data });
+    const res = await this.#updateRaw({ id }, data);
+    if (!res.success) return res;
     return this.findById(id);
   }
 

package/core/adaptor/sqliteAdapter.js

@@ -0,0 +1,104 @@
+// sqliteAdapter.js
+// 基于 Node 22 内置 node:sqlite（DatabaseSync）实现的 knex SQLite 适配器，零第三方依赖。
+// 仅替换底层连接与执行层，SQL 编译/方言完全复用 knex 自带的 SQLite 驱动，
+// 因此与官方 client:"sqlite3" 产出的 SQL 一致，只是不依赖 sqlite3 npm 包。
+//
+// 挂载方式：config 中 sqlite 分支填写纯字符串 client:"sqlite" 即可，
+// 由 Database.js 在初始化连接时按类型自动映射到本适配器，业务侧无需 import。
+import { createRequire } from "module";
+import { DatabaseSync } from "node:sqlite";
+
+const require = createRequire(import.meta.url);
+// 复用 knex 内置 SQLite 方言（SQL 编译器 / schema 编译器 / 事务 / DDL）
+const Client_SQLite = require("knex/lib/dialects/sqlite3/index.js");
+
+/**
+ * node:sqlite 的绑定值约束较小，这里统一规范化再绑定：
+ * - undefined -> null（跳过绑定会报错）
+ * - boolean   -> 0/1（SQLite 无 bool 类型）
+ * - Date      -> ISO 字符串（极少数未格式化兜底）
+ */
+function toSqliteValue(value) {
+  if (value === undefined) return null;
+  if (typeof value === "boolean") return value ? 1 : 0;
+  if (value instanceof Date) return value.toISOString();
+  return value;
+}
+
+/** 归一化位置参数与具名参数两种绑定形态 */
+function normalizeBindings(bindings) {
+  if (bindings == null) return [];
+  if (Array.isArray(bindings)) return bindings.map(toSqliteValue);
+  if (typeof bindings === "object") return Object.values(bindings).map(toSqliteValue);
+  return bindings;
+}
+
+class SqliteAdapter extends Client_SQLite {
+  // 官方客户端 _driver() 会 require("sqlite3")，这里改为静态标志，
+  // 避免任何路径触发未安装的 sqlite3 包（本项目不缓存驱动实例）。
+  _driver() {
+    return { OPEN_READWRITE: 0x00000002, OPEN_CREATE: 0x00000004 };
+  }
+
+  // 用内置 node:sqlite 同步打开连接（knex 接受同步返回值）
+  acquireRawConnection() {
+    const filename = this.connectionSettings?.filename || ":memory:";
+    const conn = new DatabaseSync(filename);
+    // 与官方 sqlite3 客户端默认口径一致，关闭外键强制以免种子/迁移级联约束影响
+    try {
+      conn.exec("PRAGMA foreign_keys = OFF");
+    } catch {
+      /* 忽略 */
+    }
+    return conn;
+  }
+
+  async destroyRawConnection(connection) {
+    try {
+      connection.close();
+    } catch {
+      /* 忽略 */
+    }
+  }
+
+  // 核心：用 node:sqlite 同步 API 执行 knex 编译好的 SQL。
+  // knex 的 SQLite 编译器产出 `?` 占位 + 数组绑定，与 node:sqlite 完全兼容。
+  // 说明：StatementSync 由 Node GC 自动回收，无需（在 v22 亦无）finalize 方法。
+  _query(connection, obj) {
+    if (!obj.sql) throw new Error("The query is empty");
+
+    const bindings = normalizeBindings(obj.bindings);
+    const useRun = ["insert", "update"].includes(obj.method)
+      ? !obj.returning
+      : ["del", "counter"].includes(obj.method);
+
+    const stmt = connection.prepare(obj.sql);
+    try {
+      if (useRun) {
+        const info = stmt.run(...bindings);
+        obj.context = {
+          lastID: Number(info.lastInsertRowid ?? 0),
+          changes: info.changes ?? 0,
+        };
+      } else {
+        obj.response = stmt.all(...bindings);
+      }
+    } catch (err) {
+      err.message = `[sqlite-node] 执行失败: ${err.message} | SQL: ${obj.sql}`;
+      throw err;
+    }
+
+    return Promise.resolve(obj);
+  }
+
+  validateConnection(connection) {
+    return !!connection;
+  }
+}
+
+Object.assign(SqliteAdapter.prototype, {
+  dialect: "sqlite3",
+  driverName: "sqlite3-node",
+});
+
+export default SqliteAdapter;

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "chanjs",
-  "version": "2.7.15",
+  "version": "2.7.17",
   "description": "chanjs基于 Node.js + Express 5 的标准 HMVC 框架（NHMVC），纯 JavaScript（ESM）开发。",
   "main": "index.js",
   "module": "index.js",