@qimen-lab/core 0.1.4 → 0.1.5

package/dist/mime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qimen-lab/mime",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "main": "index.js",
   "module": "index.esm.js",
   "types": "index.d.ts",
@@ -13,6 +13,6 @@
     }
   },
   "dependencies": {
-    "@qimen-lab/registry": "0.1.3"
+    "@qimen-lab/registry": "0.1.4"
   }
 }

package/dist/oauth2/OAuth2Manager.esm.js

@@ -10,7 +10,7 @@
  * @module oauth2/OAuth2Manager
  */
 import { createTokenStorage } from './TokenStorage';
-import { DomainRegistrar } from '../registry/registrars/DomainRegistrar.esm.js';
+import { DomainRegistrar } from '../registry/index.esm.js';
 /**
  * OAuth2 核心管理器
  */

package/dist/oauth2/OAuth2Manager.js

@@ -13,7 +13,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.oauth2 = exports.OAuth2Manager = void 0;
 const TokenStorage_1 = require("./TokenStorage");
-const DomainRegistrar_1 = require("../registry/registrars/DomainRegistrar.js");
+const DomainRegistrar_1 = require("../registry/index.js");
 /**
  * OAuth2 核心管理器
  */

package/dist/oauth2/TokenRefreshHandler.esm.js

@@ -7,7 +7,7 @@
  * @module oauth2/TokenRefreshHandler
  */
 import { oauth2 } from './OAuth2Manager';
-import { HttpExecutor } from '../http/HttpExecutor.esm.js';
+import { HttpExecutor } from '../http/index.esm.js';
 /**
  * Token 刷新处理器
  *

package/dist/oauth2/TokenRefreshHandler.js

@@ -10,7 +10,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TokenRefreshHandler = void 0;
 const OAuth2Manager_1 = require("./OAuth2Manager");
-const HttpExecutor_1 = require("../http/HttpExecutor.js");
+const HttpExecutor_1 = require("../http/index.js");
 /**
  * Token 刷新处理器
  *

package/dist/oauth2/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qimen-lab/oauth2",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "main": "index.js",
   "module": "index.esm.js",
   "types": "index.d.ts",
@@ -13,9 +13,9 @@
     }
   },
   "dependencies": {
-    "@qimen-lab/http": "0.1.3",
-    "@qimen-lab/registry": "0.1.3",
-    "@qimen-lab/events": "0.1.3",
-    "@qimen-lab/cache": "0.1.3"
+    "@qimen-lab/http": "0.1.4",
+    "@qimen-lab/registry": "0.1.4",
+    "@qimen-lab/events": "0.1.4",
+    "@qimen-lab/cache": "0.1.4"
   }
 }

package/dist/pattern/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qimen-lab/pattern",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "main": "index.js",
   "module": "index.esm.js",
   "types": "index.d.ts",
@@ -13,6 +13,6 @@
     }
   },
   "dependencies": {
-    "@qimen-lab/registry": "0.1.3"
+    "@qimen-lab/registry": "0.1.4"
   }
 }

package/dist/pipeline/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qimen-lab/pipeline",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "main": "index.js",
   "module": "index.esm.js",
   "types": "index.d.ts",
@@ -13,7 +13,7 @@
     }
   },
   "dependencies": {
-    "@qimen-lab/logger": "0.1.3",
-    "@qimen-lab/context": "0.1.3"
+    "@qimen-lab/logger": "0.1.4",
+    "@qimen-lab/context": "0.1.4"
   }
 }

package/dist/registry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qimen-lab/registry",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "main": "index.js",
   "module": "index.esm.js",
   "types": "index.d.ts",
@@ -13,6 +13,6 @@
     }
   },
   "dependencies": {
-    "@qimen-lab/error": "0.1.3"
+    "@qimen-lab/error": "0.1.4"
   }
 }

package/dist/registry/registrars/DomainRegistrar.esm.js

@@ -0,0 +1,116 @@
+import { DomainRegistrarName } from '../types';
+import { RegistrarBase } from './RegistrarBase';
+import { RegistrarConflictError } from './errors';
+/**
+ * 域配置注册器
+ * 管理不同域名的配置信息
+ *
+ * 用于存储和管理多个API端点或服务域的配置信息，
+ * 支持不同的超时时长、分页配置、公共参数等
+ */
+export class DomainRegistrar extends RegistrarBase {
+    constructor() {
+        super(...arguments);
+        this.name = DomainRegistrarName;
+        /**
+         * 存储域名称到域配置的映射
+         * 使用Map结构提供高效的键值对存储和检索
+         * @protected
+         */
+        this.storage = new Map();
+    }
+    /**
+     * 注册一个域配置
+     *
+     * @param name - 域名称，作为唯一标识符
+     * @param config - 域配置对象，包含API端点的相关设置
+     * @param force - 是否强制注册（覆盖已有配置），默认为 false
+     * @throws RegistrarConflictError - 当配置名称冲突且未使用 force 时
+     */
+    register(name, config, force = false) {
+        this.checkLock();
+        // 1. 如果不强制且已存在，直接炸掉，不给任何模糊空间
+        if (!force && this.storage.has(name)) {
+            throw new RegistrarConflictError(this.name, name);
+        }
+        // 2. 只有两种情况会走到这：要么是新的，要么你明确说了要覆盖
+        this.storage.set(name, config);
+    }
+    /**
+     * 删除一个域配置
+     * 从存储中移除指定名称的配置
+     *
+     * @param name - 要删除的域名称
+     */
+    unregister(name) {
+        this.checkLock();
+        this.storage.delete(name);
+    }
+    /**
+     * 获取域配置
+     *
+     * @param name - 域名称
+     * @returns 域配置对象
+     */
+    get(name) {
+        return this.storage.get(name);
+    }
+    /**
+     * 获取域的基地址
+     * 便捷方法，直接返回指定域的baseUrl
+     *
+     * @param name - 域名称
+     * @returns 域的基地址
+     */
+    getBaseUrl(name) {
+        const config = this.storage.get(name);
+        return config.baseUrl;
+    }
+    /**
+     * 更新 token
+     *
+     * 批量更新多个域的 token
+     *
+     * @param token - Token 字符串
+     * @param domains - 域名列表（可变参数）
+     */
+    updateToken(token, ...domains) {
+        domains.forEach(domain => {
+            const config = this.storage.get(domain);
+            if (config) {
+                config.token = token;
+            }
+        });
+    }
+    /**
+     * 清除 token
+     *
+     * 批量清除多个域的 token
+     *
+     * @param domains - 域名列表（可变参数）
+     */
+    clearToken(...domains) {
+        domains.forEach(domain => {
+            const config = this.storage.get(domain);
+            if (config) {
+                config.token = undefined;
+            }
+        });
+    }
+    /**
+     * 输出域注册器的状态信息
+     * 显示当前存储的所有域名称和对应的基地址
+     *
+     * @protected
+     */
+    doInspect() {
+        console.group('🌐 Domain Registry Status');
+        const summary = {};
+        this.storage.forEach((config, name) => {
+            summary[name] = config.baseUrl;
+        });
+        console.table(summary);
+        console.groupEnd();
+    }
+}
+//# sourceMappingURL=DomainRegistrar.js.map

package/dist/registry/registrars/DomainRegistrar.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DomainRegistrar.js","sourceRoot":"","sources":["../../../../src/registry/registrars/DomainRegistrar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,OAAO,eAAgB,SAAQ,aAAwC;IAA7E;;QACoB,SAAI,GAAG,mBAAmB,CAAC;QAE3C;;;;WAIG;QACO,YAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IAuGxD,CAAC;IArGG;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAY,EAAE,MAAoB,EAAE,KAAK,GAAG,KAAK;QACtD,IAAI,CAAC,SAAS,EAAE,CAAC;QAEjB,6BAA6B;QAC7B,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,sBAAsB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACtD,CAAC;QAED,iCAAiC;QACjC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,IAAY;QACnB,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,IAAY;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;IACnC,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,IAAY;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,OAAO,MAAO,CAAC,OAAO,CAAC;IAC3B,CAAC;IAED;;;;;;;OAOG;IACH,WAAW,CAAC,KAAa,EAAE,GAAG,OAAiB;QAC3C,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;YACrB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACxC,IAAI,MAAM,EAAE,CAAC;gBACT,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;YACzB,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,GAAG,OAAiB;QAC3B,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;YACrB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACxC,IAAI,MAAM,EAAE,CAAC;gBACT,MAAM,CAAC,KAAK,GAAG,SAAS,CAAC;YAC7B,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;OAKG;IACO,SAAS;QACf,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC3C,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;YAClC,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;QACnC,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,CAAC,QAAQ,EAAE,CAAC;IACvB,CAAC;CACJ"}

package/dist/registry/registrars/HtmlTemplateRegistrar.esm.js

@@ -0,0 +1,56 @@
+import { HtmlTemplateRegistrarName } from '../types';
+import { RegistrarBase } from './RegistrarBase';
+/**
+ * HTML模板注册器
+ * 管理HTML模板字符串的注册和检索
+ *
+ * 用于存储和管理预定义的HTML模板，
+ * 支持按ID快速检索和复用HTML模板内容
+ */
+export class HtmlTemplateRegistrar extends RegistrarBase {
+    constructor() {
+        super(...arguments);
+        this.name = HtmlTemplateRegistrarName; // 简洁的名称
+        this.storage = new Map();
+    }
+    /**
+     * 注册HTML模板
+     *
+     * @param id - 模板唯一标识符
+     * @param template - HTML模板字符串
+     */
+    register(id, template) {
+        this.checkLock();
+        this.storage.set(id, template);
+    }
+    /**
+     * 注销HTML模板
+     * 从存储中删除指定ID的模板
+     *
+     * @param id - 要删除的模板ID
+     */
+    unregister(id) {
+        this.checkLock();
+        this.storage.delete(id);
+    }
+    /**
+     * 获取HTML模板
+     *
+     * @param id - 模板ID
+     * @returns 对应的HTML模板字符串
+     */
+    get(id) {
+        return this.storage.get(id);
+    }
+    /**
+     * 输出HTML模板注册器的状态信息
+     * 显示当前存储的所有模板ID和对应的模板内容
+     *
+     * @protected
+     */
+    doInspect() {
+        // 子类只需要这一行，外壳基类已经穿好了
+        console.table(Object.fromEntries(this.storage));
+    }
+}
+//# sourceMappingURL=HtmlTemplateRegistrar.js.map

package/dist/registry/registrars/HtmlTemplateRegistrar.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HtmlTemplateRegistrar.js","sourceRoot":"","sources":["../../../../src/registry/registrars/HtmlTemplateRegistrar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,OAAO,qBAAsB,SAAQ,aAAkC;IAA7E;;QACoB,SAAI,GAAG,yBAAyB,CAAC,CAAC,QAAQ;QAChD,YAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IA4ClD,CAAC;IA1CG;;;;;OAKG;IACH,QAAQ,CAAC,EAAU,EAAE,QAAgB;QACjC,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,EAAU;QACjB,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,EAAU;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACO,SAAS;QACf,qBAAqB;QACrB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACpD,CAAC;CACJ"}

package/dist/registry/registrars/RegistrarBase.esm.js

@@ -0,0 +1,88 @@
+/**
+ * 注册器基类
+ * 定义了注册器的基本结构和通用操作方法
+ *
+ * 所有具体的注册器都应继承此类，以获得统一的接口和功能
+ * 包括单例模式、锁定机制、存储管理和基本操作方法
+ */
+export class RegistrarBase {
+    constructor() {
+        /**
+         * 注册器锁定状态
+         * 用于防止在应用启动后修改配置
+         * @protected
+         */
+        this.isLocked = false;
+    }
+    /**
+     * 获取注册器实例，确保单例模式
+     *
+     * @returns 注册器实例，确保同一类型只存在一个实例
+     */
+    static getInstance() {
+        const constructor = this;
+        if (!RegistrarBase.instances.has(constructor)) {
+            RegistrarBase.instances.set(constructor, new this());
+        }
+        return RegistrarBase.instances.get(constructor);
+    }
+    /**
+     * 检查注册器是否被锁定
+     * 如果已锁定则抛出错误
+     *
+     * @throws Error - 当注册器被锁定时抛出
+     * @protected
+     */
+    checkLock() {
+        if (this.isLocked) {
+            throw new Error(`[Registrar: ${this.name}] modification denied: Locked.`);
+        }
+    }
+    /**
+     * 锁定注册器，阻止后续修改
+     *
+     * 一旦锁定，将不能进行注册、注销等修改操作
+     * 通常在应用启动完成后调用，确保运行时配置的稳定性
+     */
+    lock() {
+        this.isLocked = true;
+    }
+    /**
+     * 清空存储的数据
+     * 根据存储类型的不同采用不同的清空方式
+     *
+     * 此操作不可逆，请谨慎使用
+     */
+    clear() {
+        this.checkLock();
+        if (!this.storage)
+            return;
+        if (typeof this.storage.clear === 'function') {
+            this.storage.clear();
+        }
+        else if (Array.isArray(this.storage)) {
+            this.storage.length = 0;
+        }
+        else if (typeof this.storage === 'object') {
+            Object.keys(this.storage).forEach(key => delete this.storage[key]);
+        }
+    }
+    /**
+     * 输出注册器的当前状态信息
+     * 以分组的形式输出注册器的信息，便于调试和诊断
+     *
+     * 此方法会调用子类实现的doInspect方法来显示具体的数据内容
+     */
+    inspect() {
+        console.group(`🔍 Registrar: ${this.name} [${this.isLocked ? '🔒' : '🔓'}]`);
+        this.doInspect(); // 子类只负责核心数据的呈现方式
+        console.groupEnd();
+    }
+}
+/**
+ * 存储所有注册器实例，确保单例模式
+ * 使用构造函数作为键，保证每种注册器只有一个实例
+ * @private
+ */
+RegistrarBase.instances = new Map();
+//# sourceMappingURL=RegistrarBase.js.map

package/dist/registry/registrars/RegistrarBase.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegistrarBase.js","sourceRoot":"","sources":["../../../../src/registry/registrars/RegistrarBase.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAgB,aAAa;IAAnC;QAcI;;;;WAIG;QACO,aAAQ,GAAG,KAAK,CAAC;IA4G/B,CAAC;IAnGG;;;;OAIG;IACH,MAAM,CAAC,WAAW;QACd,MAAM,WAAW,GAAG,IAAW,CAAC;QAChC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5C,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAM,CAAC;IACzD,CAAC;IAED;;;;;;OAMG;IACO,SAAS;QACf,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,IAAI,gCAAgC,CAAC,CAAC;QAC9E,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,IAAI;QACA,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,KAAK;QACD,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,IAAI,OAAQ,IAAI,CAAC,OAAe,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACnD,IAAI,CAAC,OAAe,CAAC,KAAK,EAAE,CAAC;QAClC,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5B,CAAC;aAAM,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,OAAQ,IAAI,CAAC,OAAe,CAAC,GAAG,CAAC,CAAC,CAAC;QAChF,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,OAAO;QACH,OAAO,CAAC,KAAK,CAAC,iBAAiB,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QAC7E,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,iBAAiB;QACnC,OAAO,CAAC,QAAQ,EAAE,CAAC;IACvB,CAAC;;AA5FD;;;;GAIG;AACY,uBAAS,GAAG,IAAI,GAAG,EAAY,AAAtB,CAAuB"}

package/dist/registry/registrars/SystemRegistrar.esm.js

@@ -0,0 +1,101 @@
+import { SystemRegistrarName } from '../types';
+import { RegistrarBase } from './RegistrarBase';
+/**
+ * 系统配置注册器
+ * 管理全局系统配置信息
+ *
+ * 存储和管理系统级的配置，如语言环境、日期格式、密码策略等
+ * 提供默认配置和动态更新功能
+ */
+export class SystemRegistrar extends RegistrarBase {
+    constructor() {
+        super(...arguments);
+        this.name = SystemRegistrarName;
+        // 静态配置池：这是唯一的真相来源（Source of Truth）
+        this.storage = {
+            locale: 'zh-CN',
+            dateFormat: 'YYYY-MM-DD',
+            datetimeFormat: 'YYYY-MM-DD HH:mm:ss',
+            timezone: 'UTC+8',
+            password: {
+                minLength: 8,
+                maxLength: 16,
+                upperCase: true,
+                lowerCase: true,
+                digit: true,
+                specialChar: true,
+            },
+        };
+    }
+    /**
+     * 注册系统配置
+     * 支持两种调用方式：
+     * 1. 单个注册: register('locale', 'zh-CN')
+     * 2. 对象拆解: register({ locale: 'zh-CN', timezone: 'UTC+8' })
+     *
+     * @param keyOrObj - 配置键名或包含多个配置的对象
+     * @param value - 配置值（当第一个参数为键名时）
+     */
+    register(keyOrObj, value) {
+        this.checkLock();
+        if (typeof keyOrObj === 'object' && keyOrObj !== null) {
+            // 模式 2：拆解对象注册
+            Object.assign(this.storage, keyOrObj);
+        }
+        else if (typeof keyOrObj === 'string') {
+            // 模式 1：单个 Key 注册
+            this.storage[keyOrObj] = value;
+        }
+    }
+    /**
+     * 批量合并注册配置
+     * 一次性更新多个配置项
+     *
+     * @param obj - 包含多个配置项的对象
+     */
+    registerAll(obj) {
+        this.checkLock();
+        // 使用 Object.assign 进行一级合并
+        // 如果需要处理 password 这种嵌套对象，建议使用简单的递归合并
+        Object.assign(this.storage, obj);
+    }
+    /**
+     * 注销指定的配置项
+     * 从存储中删除指定键的配置
+     *
+     * @param key - 要删除的配置键
+     */
+    unregister(key) {
+        this.checkLock();
+        delete this.storage[key];
+    }
+    /**
+     * 获取指定的配置项
+     *
+     * @param key - 配置键名
+     * @returns 配置值
+     */
+    get(key) {
+        return this.storage[key];
+    }
+    /**
+     * 获取所有系统配置
+     *
+     * @returns 完整的配置对象
+     */
+    getAll() {
+        return this.storage;
+    }
+    /**
+     * 输出系统配置注册器的状态信息
+     * 显示当前存储的所有配置项
+     *
+     * @protected
+     */
+    doInspect() {
+        console.group('🖥️ System Global Configuration');
+        console.table(this.storage);
+        console.groupEnd();
+    }
+}
+//# sourceMappingURL=SystemRegistrar.js.map

package/dist/registry/registrars/SystemRegistrar.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SystemRegistrar.js","sourceRoot":"","sources":["../../../../src/registry/registrars/SystemRegistrar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,OAAO,eAAgB,SAAQ,aAAoC;IAAzE;;QACoB,SAAI,GAAG,mBAAmB,CAAC;QAE3C,mCAAmC;QACzB,YAAO,GAA0B;YACvC,MAAM,EAAE,OAAO;YACf,UAAU,EAAE,YAAY;YACxB,cAAc,EAAE,qBAAqB;YACrC,QAAQ,EAAE,OAAO;YACjB,QAAQ,EAAE;gBACN,SAAS,EAAE,CAAC;gBACZ,SAAS,EAAE,EAAE;gBACb,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,IAAI;gBACf,KAAK,EAAE,IAAI;gBACX,WAAW,EAAE,IAAI;aACpB;SACJ,CAAC;IA8EN,CAAC;IA5EG;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAwC,EAAE,KAAW;QAC1D,IAAI,CAAC,SAAS,EAAE,CAAC;QAEjB,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACpD,cAAc;YACd,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC1C,CAAC;aAAM,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACtC,iBAAiB;YAChB,IAAI,CAAC,OAAe,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;QAC5C,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,GAA0B;QAClC,IAAI,CAAC,SAAS,EAAE,CAAC;QAEjB,0BAA0B;QAC1B,qCAAqC;QACrC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,GAAW;QAClB,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,OAAQ,IAAI,CAAC,OAAe,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,GAAuB;QACvB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACI,MAAM;QACT,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED;;;;;OAKG;IACO,SAAS;QACf,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACjD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,OAAO,CAAC,QAAQ,EAAE,CAAC;IACvB,CAAC;CACJ"}

package/dist/registry/registrars/errors.esm.js

@@ -0,0 +1,122 @@
+import { ErrorBase } from '../../error/index.esm.js';
+/**
+ * 注册器错误代码枚举
+ * 定义了注册器系统中可能出现的各种错误类型
+ * 通过统一的错误代码便于错误分类、处理和调试
+ */
+export var RegistrarErrorCode;
+(function (RegistrarErrorCode) {
+    RegistrarErrorCode["REGISTRATION_LOCKED"] = "REGISTRAR_REGISTRATION_LOCKED";
+    RegistrarErrorCode["REGISTRATION_CONFLICT"] = "REGISTRAR_REGISTRATION_CONFLICT";
+    RegistrarErrorCode["REGISTRATION_NOT_FOUND"] = "REGISTRAR_REGISTRATION_NOT_FOUND";
+    RegistrarErrorCode["INVALID_ARGUMENT"] = "REGISTRAR_INVALID_ARGUMENT";
+})(RegistrarErrorCode || (RegistrarErrorCode = {}));
+/**
+ * 注册器基础错误类
+ * 所有注册器相关错误的基类
+ * 继承自ErrorBase，提供统一的错误处理机制
+ */
+export class RegistrarError extends ErrorBase {
+    /**
+     * 创建一个新的注册器错误实例
+     *
+     * @param message - 错误消息描述
+     * @param code - 错误代码，来自RegistrarErrorCode枚举
+     * @param context - 可选的错误上下文信息，提供更多错误相关数据
+     */
+    constructor(message, code, context) {
+        super(message, code, context);
+    }
+}
+/**
+ * 注册器锁定错误 - 当尝试在注册器锁定后进行注册时抛出
+ *
+ * 当注册器被锁定后，不能再进行任何修改操作（注册、注销等）
+ * 这种设计确保了系统在启动后的配置稳定性
+ */
+export class RegistrarLockedError extends RegistrarError {
+    /**
+     * 创建一个新的注册器锁定错误实例
+     *
+     * @param registrarName - 发生错误的注册器名称
+     * @param context - 可选的错误上下文信息
+     */
+    constructor(registrarName, context) {
+        const message = `[${registrarName}] Registration failed: The registrar is locked. Modifications must be completed during the bootstrap phase.`;
+        super(message, RegistrarErrorCode.REGISTRATION_LOCKED, {
+            ...context,
+            registrarName,
+            phase: 'bootstrap',
+        });
+    }
+}
+/**
+ * 注册冲突错误 - 当尝试注册已存在的名称时抛出
+ *
+ * 确保注册器中每个名称都是唯一的，防止意外覆盖已有的注册项
+ * 这种保护机制有助于避免配置错误和命名冲突
+ */
+export class RegistrarConflictError extends RegistrarError {
+    /**
+     * 创建一个新的注册冲突错误实例
+     *
+     * @param registrarName - 发生错误的注册器名称
+     * @param name - 已存在的注册项名称
+     * @param context - 可选的错误上下文信息
+     */
+    constructor(registrarName, name, context) {
+        const message = `[${registrarName}] Conflict: "${name}" already exists.`;
+        super(message, RegistrarErrorCode.REGISTRATION_CONFLICT, {
+            ...context,
+            registrarName,
+            registrationName: name,
+        });
+    }
+}
+/**
+ * 注册项未找到错误 - 当尝试获取不存在的注册项时抛出
+ *
+ * 当使用一个不存在的键来获取注册项时会抛出此错误
+ * 提醒开发者检查键名是否正确或是否已注册相应的项
+ */
+export class RegistrarNotFoundError extends RegistrarError {
+    /**
+     * 创建一个新的注册项未找到错误实例
+     *
+     * @param registrarName - 发生错误的注册器名称
+     * @param name - 未找到的注册项名称
+     * @param context - 可选的错误上下文信息
+     */
+    constructor(registrarName, name, context) {
+        const message = `[${registrarName}] Not found: "${name}" does not exist.`;
+        super(message, RegistrarErrorCode.REGISTRATION_NOT_FOUND, {
+            ...context,
+            registrarName,
+            registrationName: name,
+        });
+    }
+}
+/**
+ * 参数无效错误 - 当传入的参数不符合要求时抛出
+ *
+ * 当传入注册器的参数类型或格式不正确时会抛出此错误
+ * 用于验证输入参数的有效性，防止错误的数据进入系统
+ */
+export class RegistrarInvalidArgumentError extends RegistrarError {
+    /**
+     * 创建一个新的参数无效错误实例
+     *
+     * @param registrarName - 发生错误的注册器名称
+     * @param argument - 无效的参数值
+     * @param context - 可选的错误上下文信息
+     */
+    constructor(registrarName, argument, context) {
+        const message = `[${registrarName}] Invalid argument: "${argument}" is not valid.`;
+        super(message, RegistrarErrorCode.INVALID_ARGUMENT, {
+            ...context,
+            registrarName,
+            argument,
+        });
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/registry/registrars/errors.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/registry/registrars/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;GAIG;AACH,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC1B,2EAAqD,CAAA;IACrD,+EAAyD,CAAA;IACzD,iFAA2D,CAAA;IAC3D,qEAA+C,CAAA;AACnD,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B;AAED;;;;GAIG;AACH,MAAM,OAAgB,cAAe,SAAQ,SAAS;IAClD;;;;;;OAMG;IACH,YAAY,OAAe,EAAE,IAAwB,EAAE,OAA6B;QAChF,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,OAAO,oBAAqB,SAAQ,cAAc;IACpD;;;;;OAKG;IACH,YAAY,aAAqB,EAAE,OAA6B;QAC5D,MAAM,OAAO,GAAG,IAAI,aAAa,6GAA6G,CAAC;QAC/I,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,mBAAmB,EAAE;YACnD,GAAG,OAAO;YACV,aAAa;YACb,KAAK,EAAE,WAAW;SACrB,CAAC,CAAC;IACP,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,OAAO,sBAAuB,SAAQ,cAAc;IACtD;;;;;;OAMG;IACH,YAAY,aAAqB,EAAE,IAAY,EAAE,OAA6B;QAC1E,MAAM,OAAO,GAAG,IAAI,aAAa,gBAAgB,IAAI,mBAAmB,CAAC;QACzE,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,qBAAqB,EAAE;YACrD,GAAG,OAAO;YACV,aAAa;YACb,gBAAgB,EAAE,IAAI;SACzB,CAAC,CAAC;IACP,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,OAAO,sBAAuB,SAAQ,cAAc;IACtD;;;;;;OAMG;IACH,YAAY,aAAqB,EAAE,IAAY,EAAE,OAA6B;QAC1E,MAAM,OAAO,GAAG,IAAI,aAAa,iBAAiB,IAAI,mBAAmB,CAAC;QAC1E,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,sBAAsB,EAAE;YACtD,GAAG,OAAO;YACV,aAAa;YACb,gBAAgB,EAAE,IAAI;SACzB,CAAC,CAAC;IACP,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,OAAO,6BAA8B,SAAQ,cAAc;IAC7D;;;;;;OAMG;IACH,YAAY,aAAqB,EAAE,QAAgB,EAAE,OAA6B;QAC9E,MAAM,OAAO,GAAG,IAAI,aAAa,wBAAwB,QAAQ,iBAAiB,CAAC;QACnF,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,gBAAgB,EAAE;YAChD,GAAG,OAAO;YACV,aAAa;YACb,QAAQ;SACX,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/registry/registrars/index.esm.js

@@ -0,0 +1,6 @@
+export * from './RegistrarBase';
+export * from './SystemRegistrar';
+export * from './DomainRegistrar';
+export * from './HtmlTemplateRegistrar';
+export * from './errors';
+//# sourceMappingURL=index.js.map

package/dist/registry/registrars/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/registry/registrars/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,UAAU,CAAC"}

package/dist/runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qimen-lab/runtime",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "main": "index.js",
   "module": "index.esm.js",
   "types": "index.d.ts",