chanjs 2.7.16 → 2.8.0

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/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/core/loader.js

@@ -60,17 +60,27 @@ export async function loadController(moduleName) {
     if (!inst || typeof inst !== "object") continue;
 
     // 原型方法批量bind，幂等标记避免重复绑定
-    const proto = Object.getPrototypeOf(inst);
-    if (!proto) continue;
-    Object.getOwnPropertyNames(proto).forEach(key => {
-      const fn = inst[key];
-      if (key === "constructor" || typeof fn !== "function" || fn[BOUND_SYMBOL]) return;
-      const boundFn = fn.bind(inst);
-      Object.defineProperty(boundFn, BOUND_SYMBOL, {
-        value: true, enumerable: false, writable: false, configurable: false
+    // 遍历整条原型链（含父类继承的方法）：子类方法定义在自身原型、父类模板方法定义在父类原型，
+    // 只 bind 直接原型会导致继承方法 this 丢失（Express 非点调用时 this=undefined）。
+    // ⚠️ 必须用 getOwnPropertyDescriptor 取 value：BaseComponent 的 app/config/db 是 getter-only，
+    //    其中 db 返回 knex 实例（typeof 为 function），直接 inst[key] 会触发 getter 且赋值只读属性抛错。
+    let proto = Object.getPrototypeOf(inst);
+    while (proto && proto !== Object.prototype) {
+      Object.getOwnPropertyNames(proto).forEach(key => {
+        if (key === "constructor") return;
+        const desc = Object.getOwnPropertyDescriptor(proto, key);
+        // 只 bind 数据方法（value 为函数）；getter/setter 访问器跳过
+        if (!desc || typeof desc.value !== "function") return;
+        const fn = desc.value;
+        if (fn[BOUND_SYMBOL]) return;
+        const boundFn = fn.bind(inst);
+        Object.defineProperty(boundFn, BOUND_SYMBOL, {
+          value: true, enumerable: false, writable: false, configurable: false
+        });
+        inst[key] = boundFn;
       });
-      inst[key] = boundFn;
-    });
+      proto = Object.getPrototypeOf(proto);
+    }
 
     ctrlMap[ctrlName] = inst;
   }

package/package.json

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