monsqlize 1.1.7 → 1.1.9

package/CHANGELOG.md

@@ -1,7 +1,7 @@
 # 变更日志 (CHANGELOG)
 
 > **说明**: 版本概览摘要，详细变更见 [changelogs/](./changelogs/) 目录  
-> **最后更新**: 2026-02-11
+> **最后更新**: 2026-04-02
 
 ---
 
@@ -9,6 +9,8 @@
 
 | 版本 | 日期 | 变更摘要 | 详细 |
 |------|------|---------|------|
+| [v1.1.9](./changelogs/v1.1.9.md) | 2026-04-02 | 🚨 **P1 Bug 修复**：MultiLevelCache L2→L1 回填 TTL 缺失（null 永久驻留 L1）+ 新增 `backfillLocalTTL` 配置 + Redis `getWithTTL` 方法 + 14 个回归测试 | [查看](./changelogs/v1.1.9.md) |
+| [v1.1.8](./changelogs/v1.1.8.md) | 2026-03-16 | 🆕 **新功能**：Model 热重载支持（`undefine()` + `redefine()` + `_loadModels` reload 模式）+ 22个测试 (100%通过) | [查看](./changelogs/v1.1.8.md) |
 | [v1.1.6](./changelogs/v1.1.6.md) | 2026-02-11 | 🎉 **重大功能**：精准缓存失效机制 + 🚨 upsert 缓存失效 Bug 修复 + 36个测试 (100%通过) | [查看](./changelogs/v1.1.6.md) |
 | [v1.1.4](./changelogs/v1.1.4.md) | 2026-02-09 | 🎉 重大功能：通用函数缓存 - 52个测试 (100%通过) + 多层缓存 delPattern 修复 | [查看](./changelogs/v1.1.4.md) |
 | [v1.1.3](./changelogs/v1.1.3.md) | 2026-02-03 | 📚 文档完善：多连接池文档优化 + 健康检查详解 + 验证体系规范 | [查看](./changelogs/v1.1.3.md) |

package/README.md

@@ -1242,6 +1242,30 @@ const user = await User.findOne({ username: 'john' })
 npm install schema-dsl
 ```
 
+#### 热重载支持（v1.1.7+）🆕
+
+在开发模式下，无需重启进程即可更新 Model 定义。
+
+```javascript
+const { Model } = require('monsqlize');
+
+// 注销 Model 定义（返回 boolean）
+Model.undefine('users');         // true  — 成功注销
+Model.undefine('nonexistent');   // false — 不存在时不抛错
+
+// 替换 Model 定义（undefine + define 的组合）
+Model.redefine('users', {
+    schema: (dsl) => dsl({ username: 'string!', email: 'email!' })
+});
+
+// 批量热重载（重新加载所有 model 文件）
+await msq._loadModels({ reload: true });
+```
+
+**注意事项**：
+- `redefine()` 若新定义校验失败，旧定义**已被移除**（不会回滚），调用方需 try/catch
+- 已实例化的 `ModelInstance` 不受影响，热重载后应通过 `db.model()` 重新获取实例
+
 [📖 Model 层详细文档](./docs/model.md)
 
 ---

package/lib/connect.js

@@ -1,99 +1,99 @@
-/**
- * 数据库连接管理器
- * 统一管理各种数据库的连接创建和实例化逻辑
- */
-const Mongo = require("./mongodb");
-
-module.exports = class ConnectionManager {
-  /**
-   * 支持的数据库类型映射
-   */
-  static get SUPPORTED_DATABASES() {
-    return {
-      mongodb: Mongo,
-    };
-  }
-
-  /**
-   * 创建数据库实例
-   * @param {string} type - 数据库类型
-   * @param {string} databaseName - 数据库名称
-   * @param {Object} cache - 缓存实例（内存缓存）
-   * @param {Object} logger - 日志记录器
-   * @param {Object} [defaults] - 统一默认配置（如 maxTimeMS、namespace）
-   * @returns {Object} 数据库实例
-   * @throws {Error} 当数据库类型不支持或未实现时抛出错误
-   */
-  static createInstance(type, databaseName, cache, logger, defaults) {
-    const SUPPORTED_DATABASES = this.SUPPORTED_DATABASES;
-    // 验证数据库类型是否支持
-    if (!(type in SUPPORTED_DATABASES)) {
-      const supportedTypes = Object.keys(SUPPORTED_DATABASES).join(", ");
-      throw new Error(
-        `Invalid database type: ${type}. Supported types are: ${supportedTypes}`,
-      );
-    }
-
-    // 检查是否已实现
-    if (SUPPORTED_DATABASES[type] === null) {
-      throw new Error(`${type} support not implemented yet`);
-    }
-
-    // 获取对应的数据库类
-    const DatabaseClass = SUPPORTED_DATABASES[type];
-
-    // 创建并返回实例
-    return new DatabaseClass(type, databaseName, cache, logger, defaults);
-  }
-
-  /**
-   * 连接数据库
-   * @param {string} type - 数据库类型
-   * @param {string} databaseName - 数据库名称
-   * @param {Object} config - 数据库连接配置
-   * @param {Object} cache - 缓存实例
-   * @param {Object} logger - 日志记录器
-   * @param {Object} [defaults] - 统一默认配置（如 maxTimeMS、namespace）
-   * @param {Object} [poolManager] - 多连接池管理器（v1.0.8+）
-   * @returns {{accessor: Function, instance: Object}} 访问器与底层适配器实例
-   * @throws {Error} 连接失败时抛出错误
-   */
-  static async connect(
-    type,
-    databaseName,
-    config,
-    cache,
-    logger,
-    defaults,
-    poolManager,
-  ) {
-    // 创建数据库实例
-    const instance = this.createInstance(
-      type,
-      databaseName,
-      cache,
-      logger,
-      defaults,
-    );
-
-    // 🆕 v1.0.8: 传递 poolManager 给实例
-    if (poolManager) {
-      instance.poolManager = poolManager;
-    }
-
-    // 建立连接
-    await instance.connect(config);
-
-    // ---------- 构建访问器 ----------
-    const collection = (collectionName) =>
-      instance.collection(databaseName, collectionName);
-    const db = (databaseName) => {
-      return {
-        collection: (collectionName) =>
-          instance.collection(databaseName, collectionName),
-      };
-    };
-
-    return { collection, db, use: db, instance };
-  }
-};
+/**
+ * 数据库连接管理器
+ * 统一管理各种数据库的连接创建和实例化逻辑
+ */
+const Mongo = require("./mongodb");
+
+module.exports = class ConnectionManager {
+  /**
+   * 支持的数据库类型映射
+   */
+  static get SUPPORTED_DATABASES() {
+    return {
+      mongodb: Mongo,
+    };
+  }
+
+  /**
+   * 创建数据库实例
+   * @param {string} type - 数据库类型
+   * @param {string} databaseName - 数据库名称
+   * @param {Object} cache - 缓存实例（内存缓存）
+   * @param {Object} logger - 日志记录器
+   * @param {Object} [defaults] - 统一默认配置（如 maxTimeMS、namespace）
+   * @returns {Object} 数据库实例
+   * @throws {Error} 当数据库类型不支持或未实现时抛出错误
+   */
+  static createInstance(type, databaseName, cache, logger, defaults) {
+    const SUPPORTED_DATABASES = this.SUPPORTED_DATABASES;
+    // 验证数据库类型是否支持
+    if (!(type in SUPPORTED_DATABASES)) {
+      const supportedTypes = Object.keys(SUPPORTED_DATABASES).join(", ");
+      throw new Error(
+        `Invalid database type: ${type}. Supported types are: ${supportedTypes}`,
+      );
+    }
+
+    // 检查是否已实现
+    if (SUPPORTED_DATABASES[type] === null) {
+      throw new Error(`${type} support not implemented yet`);
+    }
+
+    // 获取对应的数据库类
+    const DatabaseClass = SUPPORTED_DATABASES[type];
+
+    // 创建并返回实例
+    return new DatabaseClass(type, databaseName, cache, logger, defaults);
+  }
+
+  /**
+   * 连接数据库
+   * @param {string} type - 数据库类型
+   * @param {string} databaseName - 数据库名称
+   * @param {Object} config - 数据库连接配置
+   * @param {Object} cache - 缓存实例
+   * @param {Object} logger - 日志记录器
+   * @param {Object} [defaults] - 统一默认配置（如 maxTimeMS、namespace）
+   * @param {Object} [poolManager] - 多连接池管理器（v1.0.8+）
+   * @returns {{accessor: Function, instance: Object}} 访问器与底层适配器实例
+   * @throws {Error} 连接失败时抛出错误
+   */
+  static async connect(
+    type,
+    databaseName,
+    config,
+    cache,
+    logger,
+    defaults,
+    poolManager,
+  ) {
+    // 创建数据库实例
+    const instance = this.createInstance(
+      type,
+      databaseName,
+      cache,
+      logger,
+      defaults,
+    );
+
+    // 🆕 v1.0.8: 传递 poolManager 给实例
+    if (poolManager) {
+      instance.poolManager = poolManager;
+    }
+
+    // 建立连接
+    await instance.connect(config);
+
+    // ---------- 构建访问器 ----------
+    const collection = (collectionName) =>
+      instance.collection(databaseName, collectionName);
+    const db = (databaseName) => {
+      return {
+        collection: (collectionName) =>
+          instance.collection(databaseName, collectionName),
+      };
+    };
+
+    return { collection, db, use: db, instance };
+  }
+};