monsqlize 1.2.0 → 1.2.1

package/CHANGELOG.md

@@ -9,6 +9,7 @@
 
 | 版本 | 日期 | 变更摘要 | 详细 |
 |------|------|---------|------|
+| [v1.2.1](./changelogs/v1.2.1.md) | 2026-04-13 | 🐛 **Bug 修复**：`msq.model()` 实例缓存 + 索引去重 + 死代码清理 + `types/monsqlize.ts` 补全 `model()` / `collection()` 类型 | [查看](./changelogs/v1.2.1.md) |
 | [v1.2.0](./changelogs/v1.2.0.md) | 2026-04-13 | 🐛 **Bug 修复 + 新功能**：`findPage` 正式支持 `projection` 投影参数（修复静默忽略问题）+ 有效投影策略自动保护游标排序字段 + 8 个测试用例 | [查看](./changelogs/v1.2.0.md) |
 | [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) |

package/lib/index.js

@@ -678,7 +678,10 @@ module.exports = class {
   }
 
   /**
-   * 获取 Model 实例
+   * 获取 Model 实例（缓存复用）
+   *
+   * 同一 collectionName 多次调用返回同一实例。
+   * Model.redefine() / Model.undefine() 后自动失效，close() 后全部清空。
    *
    * @param {string} collectionName - 集合名称
    * @returns {ModelInstance} Model 实例
@@ -710,8 +713,19 @@ module.exports = class {
       throw err;
     }
 
-    // 检查 Model 是否已定义
     const Model = require("./model");
+
+    // 缓存命中 + redefine 失效检查
+    if (this._modelInstances && this._modelInstances.has(collectionName)) {
+      if (!Model._redefinedNames.has(collectionName)) {
+        return this._modelInstances.get(collectionName);
+      }
+      // redefine 后需要重建实例
+      this._modelInstances.delete(collectionName);
+      Model._redefinedNames.delete(collectionName);
+    }
+
+    // 检查 Model 是否已定义
     if (!Model.has(collectionName)) {
       const err = new Error(
         `Model '${collectionName}' is not defined. Call Model.define() first.`,
@@ -726,9 +740,13 @@ module.exports = class {
     // 获取 collection 实例
     const collection = this.dbInstance.collection(collectionName);
 
-    // 创建 ModelInstance
-    const ModelInstanceClass = require("./model").ModelInstance;
-    return new ModelInstanceClass(collection, modelDef.definition, this);
+    // 创建 ModelInstance 并缓存
+    const instance = new Model.ModelInstance(collection, modelDef.definition, this);
+
+    if (!this._modelInstances) this._modelInstances = new Map();
+    this._modelInstances.set(collectionName, instance);
+
+    return instance;
   }
 
   /**
@@ -1007,6 +1025,12 @@ module.exports = class {
     this.dbInstance = null;
     this._connecting = null;
 
+    // 清理 ModelInstance 缓存
+    if (this._modelInstances) {
+      this._modelInstances.clear();
+      this._modelInstances = null;
+    }
+
     return null;
   }
 };

package/lib/model/index.js

@@ -58,6 +58,14 @@ class Model {
    */
   static _registry = new Map();
 
+  /**
+   * 已被 redefine 的 collectionName 集合（用于缓存失效通知）
+   * @private
+   * @type {Set<string>}
+   * @since 1.2.1
+   */
+  static _redefinedNames = new Set();
+
   /**
    * 定义并注册 Model
    *
@@ -396,6 +404,8 @@ class Model {
    * @since 1.1.7
    */
   static undefine(collectionName) {
+    // 标记需要缓存失效（MonSQLize.model() 检查此标记）
+    this._redefinedNames.add(collectionName);
     return this._registry.delete(collectionName);
   }
 
@@ -434,6 +444,8 @@ class Model {
   static redefine(collectionName, definition) {
     this.undefine(collectionName);
     this.define(collectionName, definition);
+    // 标记需要缓存失效（MonSQLize.model() 检查此标记）
+    this._redefinedNames.add(collectionName);
   }
 
   /**
@@ -443,6 +455,7 @@ class Model {
    */
   static _clear() {
     this._registry.clear();
+    this._redefinedNames.clear();
   }
 }
 
@@ -662,38 +675,6 @@ class ModelInstance {
     }
   }
 
-  /**
-   * 创建索引
-   *
-   * @private
-   * @returns {Promise<void>}
-   */
-  async _createIndexes() {
-    if (!Array.isArray(this.indexes) || this.indexes.length === 0) {
-      return;
-    }
-
-    try {
-      // 使用 createIndexes 批量创建索引
-      await this.collection.createIndexes(this.indexes);
-
-      if (this.msq && this.msq.logger) {
-        this.msq.logger.info(
-          `[Model] Created ${this.indexes.length} index(es) for ${this.collection.collectionName}`,
-        );
-      }
-    } catch (err) {
-      // 索引创建失败仅记录警告
-      if (this.msq && this.msq.logger) {
-        this.msq.logger.warn(
-          `[Model] Failed to create indexes for ${this.collection.collectionName}:`,
-          err.message,
-        );
-      }
-      throw err;
-    }
-  }
-
   /**
    * 将实例方法注入到文档对象
    *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "monsqlize",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "A lightweight MongoDB ORM with multi-level caching, transaction support, distributed features, Saga distributed transactions, unified expression system with 122 operators, and universal function caching (100% MongoDB support)",
   "main": "lib/index.js",
   "module": "index.mjs",

package/types/monsqlize.ts

@@ -4,12 +4,13 @@
  */
 
 import type { TransactionOptions } from './options';
-import type { DbAccessor, HealthView } from './collection';
+import type { DbAccessor, HealthView, Collection } from './collection';
 import type { CacheLike } from './cache';
 import type { Transaction } from './transaction';
 import type { Lock, LockOptions } from './lock';
 import type { ExpressionFunction } from './base';
 import type { MetaInfo } from './pagination';
+import type { ModelInstance } from './model';
 
 /**
  * MonSQLize 主类
@@ -46,6 +47,29 @@ export interface MonSQLize {
      */
     health(): Promise<HealthView>;
 
+    /**
+     * 获取 Model 实例（缓存复用）
+     *
+     * 同一 collectionName 多次调用返回同一实例。
+     * Model.redefine() / Model.undefine() 后自动失效，close() 后全部清空。
+     *
+     * @param collectionName - 已注册的集合名称
+     * @returns ModelInstance 实例
+     * @throws 数据库未连接（NOT_CONNECTED）
+     * @throws Model 未定义（MODEL_NOT_DEFINED）
+     * @since 1.0.3
+     */
+    model(collectionName: string): ModelInstance;
+
+    /**
+     * 获取原始集合实例
+     *
+     * @param collectionName - 集合名称
+     * @returns Collection 实例
+     * @throws 数据库未连接（NOT_CONNECTED）
+     */
+    collection(collectionName: string): Collection;
+
 
     // ============================================================================
     // 事件系统