@qimen-lab/core 0.1.1

package/dist/registry/registrars/DomainRegistrar.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DomainRegistrar = void 0;
+const types_1 = require("../types");
+const RegistrarBase_1 = require("./RegistrarBase");
+const errors_1 = require("./errors");
+/**
+ * 域配置注册器
+ * 管理不同域名的配置信息
+ *
+ * 用于存储和管理多个API端点或服务域的配置信息，
+ * 支持不同的超时时长、分页配置、公共参数等
+ */
+class DomainRegistrar extends RegistrarBase_1.RegistrarBase {
+    constructor() {
+        super(...arguments);
+        this.name = types_1.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 errors_1.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();
+    }
+}
+exports.DomainRegistrar = DomainRegistrar;
+//# sourceMappingURL=DomainRegistrar.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DomainRegistrar.js","sourceRoot":"","sources":["../../../../src/registry/registrars/DomainRegistrar.ts"],"names":[],"mappings":";;;AAAA,oCAA6D;AAC7D,mDAAgD;AAChD,qCAAkD;AAElD;;;;;;GAMG;AACH,MAAa,eAAgB,SAAQ,6BAAwC;IAA7E;;QACoB,SAAI,GAAG,2BAAmB,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,+BAAsB,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;AA/GD,0CA+GC"}

package/dist/registry/registrars/HtmlTemplateRegistrar.d.ts

@@ -0,0 +1,41 @@
+import { RegistrarBase } from './RegistrarBase';
+/**
+ * HTML模板注册器
+ * 管理HTML模板字符串的注册和检索
+ *
+ * 用于存储和管理预定义的HTML模板，
+ * 支持按ID快速检索和复用HTML模板内容
+ */
+export declare class HtmlTemplateRegistrar extends RegistrarBase<Map<string, string>> {
+    readonly name: "html";
+    protected storage: Map<string, string>;
+    /**
+     * 注册HTML模板
+     *
+     * @param id - 模板唯一标识符
+     * @param template - HTML模板字符串
+     */
+    register(id: string, template: string): void;
+    /**
+     * 注销HTML模板
+     * 从存储中删除指定ID的模板
+     *
+     * @param id - 要删除的模板ID
+     */
+    unregister(id: string): void;
+    /**
+     * 获取HTML模板
+     *
+     * @param id - 模板ID
+     * @returns 对应的HTML模板字符串
+     */
+    get(id: string): string;
+    /**
+     * 输出HTML模板注册器的状态信息
+     * 显示当前存储的所有模板ID和对应的模板内容
+     *
+     * @protected
+     */
+    protected doInspect(): void;
+}
+//# sourceMappingURL=HtmlTemplateRegistrar.d.ts.map

package/dist/registry/registrars/HtmlTemplateRegistrar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HtmlTemplateRegistrar.d.ts","sourceRoot":"","sources":["../../../../src/registry/registrars/HtmlTemplateRegistrar.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;GAMG;AACH,qBAAa,qBAAsB,SAAQ,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzE,SAAgB,IAAI,SAA6B;IACjD,SAAS,CAAC,OAAO,sBAA6B;IAE9C;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAK5C;;;;;OAKG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK5B;;;;;OAKG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAIvB;;;;;OAKG;IACH,SAAS,CAAC,SAAS,IAAI,IAAI;CAI9B"}

package/dist/registry/registrars/HtmlTemplateRegistrar.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HtmlTemplateRegistrar = void 0;
+const types_1 = require("../types");
+const RegistrarBase_1 = require("./RegistrarBase");
+/**
+ * HTML模板注册器
+ * 管理HTML模板字符串的注册和检索
+ *
+ * 用于存储和管理预定义的HTML模板，
+ * 支持按ID快速检索和复用HTML模板内容
+ */
+class HtmlTemplateRegistrar extends RegistrarBase_1.RegistrarBase {
+    constructor() {
+        super(...arguments);
+        this.name = types_1.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));
+    }
+}
+exports.HtmlTemplateRegistrar = HtmlTemplateRegistrar;
+//# sourceMappingURL=HtmlTemplateRegistrar.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HtmlTemplateRegistrar.js","sourceRoot":"","sources":["../../../../src/registry/registrars/HtmlTemplateRegistrar.ts"],"names":[],"mappings":";;;AAAA,oCAAqD;AACrD,mDAAgD;AAEhD;;;;;;GAMG;AACH,MAAa,qBAAsB,SAAQ,6BAAkC;IAA7E;;QACoB,SAAI,GAAG,iCAAyB,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;AA9CD,sDA8CC"}

package/dist/registry/registrars/RegistrarBase.d.ts

@@ -0,0 +1,97 @@
+/**
+ * 注册器基类
+ * 定义了注册器的基本结构和通用操作方法
+ *
+ * 所有具体的注册器都应继承此类，以获得统一的接口和功能
+ * 包括单例模式、锁定机制、存储管理和基本操作方法
+ */
+export declare abstract class RegistrarBase<M = any> {
+    /**
+     * 存储所有注册器实例，确保单例模式
+     * 使用构造函数作为键，保证每种注册器只有一个实例
+     * @private
+     */
+    private static instances;
+    /**
+     * 注册器的唯一名称，子类必须实现
+     * 用于在注册中心中标识和检索注册器实例
+     */
+    abstract readonly name: string;
+    /**
+     * 注册器锁定状态
+     * 用于防止在应用启动后修改配置
+     * @protected
+     */
+    protected isLocked: boolean;
+    /**
+     * 存储数据的具体实现，由子类提供
+     * 不同的注册器可以使用不同的数据结构来存储数据
+     * @protected
+     */
+    protected abstract storage: M;
+    /**
+     * 获取注册器实例，确保单例模式
+     *
+     * @returns 注册器实例，确保同一类型只存在一个实例
+     */
+    static getInstance<T extends RegistrarBase<any>>(this: new () => T): T;
+    /**
+     * 检查注册器是否被锁定
+     * 如果已锁定则抛出错误
+     *
+     * @throws Error - 当注册器被锁定时抛出
+     * @protected
+     */
+    protected checkLock(): void;
+    /**
+     * 锁定注册器，阻止后续修改
+     *
+     * 一旦锁定，将不能进行注册、注销等修改操作
+     * 通常在应用启动完成后调用，确保运行时配置的稳定性
+     */
+    lock(): void;
+    /**
+     * 清空存储的数据
+     * 根据存储类型的不同采用不同的清空方式
+     *
+     * 此操作不可逆，请谨慎使用
+     */
+    clear(): void;
+    /**
+     * 输出注册器的当前状态信息
+     * 以分组的形式输出注册器的信息，便于调试和诊断
+     *
+     * 此方法会调用子类实现的doInspect方法来显示具体的数据内容
+     */
+    inspect(): void;
+    /**
+     * 抽象方法：注册项目
+     * 子类必须实现此方法来提供具体的注册逻辑
+     *
+     * @param args - 注册参数，根据具体实现而定
+     */
+    abstract register(...args: any[]): void;
+    /**
+     * 抽象方法：注销项目
+     * 子类必须实现此方法来提供具体的注销逻辑
+     *
+     * @param id - 要注销的项目的ID
+     */
+    abstract unregister(id: string): void;
+    /**
+     * 抽象方法：获取项目
+     * 子类必须实现此方法来提供具体的数据获取逻辑
+     *
+     * @param args - 获取参数，根据具体实现而定
+     * @returns 获取到的数据
+     */
+    abstract get(...args: any[]): any;
+    /**
+     * 抽象方法：实现具体的输出逻辑
+     * 子类必须实现此方法来定义如何输出注册器的状态信息
+     *
+     * @protected
+     */
+    protected abstract doInspect(): void;
+}
+//# sourceMappingURL=RegistrarBase.d.ts.map

package/dist/registry/registrars/RegistrarBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegistrarBase.d.ts","sourceRoot":"","sources":["../../../../src/registry/registrars/RegistrarBase.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,8BAAsB,aAAa,CAAC,CAAC,GAAG,GAAG;IACvC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS,CAAuB;IAE/C;;;OAGG;IACH,kBAAyB,IAAI,EAAE,MAAM,CAAC;IAEtC;;;;OAIG;IACH,SAAS,CAAC,QAAQ,UAAS;IAE3B;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IAE9B;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,aAAa,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,GAAG,CAAC;IAQtE;;;;;;OAMG;IACH,SAAS,CAAC,SAAS,IAAI,IAAI;IAM3B;;;;;OAKG;IACH,IAAI,IAAI,IAAI;IAIZ;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IAab;;;;;OAKG;IACH,OAAO,IAAI,IAAI;IAMf;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAEvC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAErC;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,GAAG;IAEjC;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,IAAI,IAAI;CACvC"}

package/dist/registry/registrars/RegistrarBase.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RegistrarBase = void 0;
+/**
+ * 注册器基类
+ * 定义了注册器的基本结构和通用操作方法
+ *
+ * 所有具体的注册器都应继承此类，以获得统一的接口和功能
+ * 包括单例模式、锁定机制、存储管理和基本操作方法
+ */
+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();
+    }
+}
+exports.RegistrarBase = RegistrarBase;
+/**
+ * 存储所有注册器实例，确保单例模式
+ * 使用构造函数作为键，保证每种注册器只有一个实例
+ * @private
+ */
+RegistrarBase.instances = new Map();
+//# sourceMappingURL=RegistrarBase.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RegistrarBase.js","sourceRoot":"","sources":["../../../../src/registry/registrars/RegistrarBase.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,MAAsB,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;;AA7FL,sCA+HC;AA9HG;;;;GAIG;AACY,uBAAS,GAAG,IAAI,GAAG,EAAY,AAAtB,CAAuB"}

package/dist/registry/registrars/SystemRegistrar.d.ts

@@ -0,0 +1,58 @@
+import { SystemConfig } from '../types';
+import { RegistrarBase } from './RegistrarBase';
+/**
+ * 系统配置注册器
+ * 管理全局系统配置信息
+ *
+ * 存储和管理系统级的配置，如语言环境、日期格式、密码策略等
+ * 提供默认配置和动态更新功能
+ */
+export declare class SystemRegistrar extends RegistrarBase<Partial<SystemConfig>> {
+    readonly name: "system";
+    protected storage: Partial<SystemConfig>;
+    /**
+     * 注册系统配置
+     * 支持两种调用方式：
+     * 1. 单个注册: register('locale', 'zh-CN')
+     * 2. 对象拆解: register({ locale: 'zh-CN', timezone: 'UTC+8' })
+     *
+     * @param keyOrObj - 配置键名或包含多个配置的对象
+     * @param value - 配置值（当第一个参数为键名时）
+     */
+    register(keyOrObj: string | Partial<SystemConfig>, value?: any): void;
+    /**
+     * 批量合并注册配置
+     * 一次性更新多个配置项
+     *
+     * @param obj - 包含多个配置项的对象
+     */
+    registerAll(obj: Partial<SystemConfig>): void;
+    /**
+     * 注销指定的配置项
+     * 从存储中删除指定键的配置
+     *
+     * @param key - 要删除的配置键
+     */
+    unregister(key: string): void;
+    /**
+     * 获取指定的配置项
+     *
+     * @param key - 配置键名
+     * @returns 配置值
+     */
+    get(key: keyof SystemConfig): any;
+    /**
+     * 获取所有系统配置
+     *
+     * @returns 完整的配置对象
+     */
+    getAll(): Partial<SystemConfig>;
+    /**
+     * 输出系统配置注册器的状态信息
+     * 显示当前存储的所有配置项
+     *
+     * @protected
+     */
+    protected doInspect(): void;
+}
+//# sourceMappingURL=SystemRegistrar.d.ts.map

package/dist/registry/registrars/SystemRegistrar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SystemRegistrar.d.ts","sourceRoot":"","sources":["../../../../src/registry/registrars/SystemRegistrar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,UAAU,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,aAAa,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACrE,SAAgB,IAAI,WAAuB;IAG3C,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,CAatC;IAEF;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,IAAI;IAYrE;;;;;OAKG;IACH,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAQ7C;;;;;OAKG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK7B;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,YAAY,GAAG,GAAG;IAIjC;;;;OAIG;IACI,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IAItC;;;;;OAKG;IACH,SAAS,CAAC,SAAS,IAAI,IAAI;CAK9B"}

package/dist/registry/registrars/SystemRegistrar.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SystemRegistrar = void 0;
+const types_1 = require("../types");
+const RegistrarBase_1 = require("./RegistrarBase");
+/**
+ * 系统配置注册器
+ * 管理全局系统配置信息
+ *
+ * 存储和管理系统级的配置，如语言环境、日期格式、密码策略等
+ * 提供默认配置和动态更新功能
+ */
+class SystemRegistrar extends RegistrarBase_1.RegistrarBase {
+    constructor() {
+        super(...arguments);
+        this.name = types_1.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();
+    }
+}
+exports.SystemRegistrar = SystemRegistrar;
+//# sourceMappingURL=SystemRegistrar.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SystemRegistrar.js","sourceRoot":"","sources":["../../../../src/registry/registrars/SystemRegistrar.ts"],"names":[],"mappings":";;;AAAA,oCAA6D;AAC7D,mDAAgD;AAEhD;;;;;;GAMG;AACH,MAAa,eAAgB,SAAQ,6BAAoC;IAAzE;;QACoB,SAAI,GAAG,2BAAmB,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;AA/FD,0CA+FC"}