feat(connect): 新增 use() 作为 db() 别名（运行时 + 类型声明）

Author: rockyshi1993

lib/connect.js

@@ -2,82 +2,98 @@
  * 数据库连接管理器
  * 统一管理各种数据库的连接创建和实例化逻辑
  */
-const Mongo = require('./mongodb');
+const Mongo = require("./mongodb");
 
 module.exports = class ConnectionManager {
+  /**
+   * 支持的数据库类型映射
+   */
+  static get SUPPORTED_DATABASES() {
+    return {
+      mongodb: Mongo,
+    };
+  }
 
-    /**
-     * 支持的数据库类型映射
-     */
-    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}`,
+      );
     }
 
-    /**
-     * 创建数据库实例
-     * @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`);
-        }
+    // 检查是否已实现
+    if (SUPPORTED_DATABASES[type] === null) {
+      throw new Error(`${type} support not implemented yet`);
+    }
 
-        // 获取对应的数据库类
-        const DatabaseClass = SUPPORTED_DATABASES[type];
+    // 获取对应的数据库类
+    const DatabaseClass = SUPPORTED_DATABASES[type];
 
-        // 创建并返回实例
-        return new DatabaseClass(type, databaseName, cache, logger, defaults);
-    }
+    // 创建并返回实例
+    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);
+  /**
+   * 连接数据库
+   * @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;
-        }
+    // 🆕 v1.0.8: 传递 poolManager 给实例
+    if (poolManager) {
+      instance.poolManager = poolManager;
+    }
 
-        // 建立连接
-        await instance.connect(config);
+    // 建立连接
+    await instance.connect(config);
 
-        // ---------- 构建访问器 ----------
-        const collection = (collectionName) => instance.collection(databaseName, collectionName);
-        const db = (databaseName)=>{
-            return {
-                collection:(collectionName)=>instance.collection(databaseName, collectionName)
-            };
-        };
+    // ---------- 构建访问器 ----------
+    const collection = (collectionName) =>
+      instance.collection(databaseName, collectionName);
+    const db = (databaseName) => {
+      return {
+        collection: (collectionName) =>
+          instance.collection(databaseName, collectionName),
+      };
+    };
 
-        return { collection, db, instance };
-    }
+    return { collection, db, use: db, instance };
+  }
 };
-