@qimen-lab/core 0.1.1

package/dist/registry/RegistryHub.esm.js

@@ -0,0 +1,116 @@
+var _a;
+import { RegistryHubLockedError, RegistryHubConflictError } from './errors';
+/**
+ * 注册中心Hub - 用于统一管理各种注册器
+ * 提供注册、锁定、调试等功能
+ *
+ * RegistryHub 是整个注册系统的中心枢纽，它管理着所有的注册器实例，
+ * 并提供了统一的访问接口和锁定机制，确保注册阶段结束后系统处于稳定状态。
+ */
+export class RegistryHub {
+    /**
+     * 锁定注册中心
+     * 调用后，任何对 use 方法的调用都会抛出 RegistryHubLockedError 错误
+     * 通常在应用启动完成时调用，防止后续意外修改
+     *
+     * 锁定机制的作用：
+     * 1. 防止在应用运行过程中意外修改配置
+     * 2. 确保配置的一致性和稳定性
+     * 3. 为生产环境提供安全保障
+     */
+    static lock() {
+        this.isLocked = true;
+        this.registars.forEach(ins => {
+            // 如果注册器自己也支持锁定逻辑（比如关闭 add 接口）
+            ins.lock();
+        });
+        Object.freeze(this.registars);
+    }
+    /**
+     * 注册子注册器
+     * 将指定的注册器实例添加到注册中心
+     *
+     * @param registrar - 要注册的注册器实例
+     * @param force - 是否强制注册（覆盖已有注册器），默认为 false
+     * @returns 注册器实例本身，允许链式调用
+     * @throws RegistryHubLockedError - 当注册中心已锁定时
+     * @throws RegistryHubConflictError - 当注册器名称冲突且未使用 force 时
+     */
+    static use(registrar, force = false) {
+        // 1. 优先检查锁定状态
+        if (this.isLocked) {
+            throw new RegistryHubLockedError({
+                registrarName: registrar.name,
+            });
+        }
+        const { name } = registrar;
+        // 2. 冲突检查
+        if (this.registars.has(name) && !force) {
+            throw new RegistryHubConflictError(name);
+        }
+        this.registars.set(name, registrar);
+        return registrar;
+    }
+    /**
+     * 调试接口：列出注册表信息
+     * 根据传入的参数决定输出哪些注册器的信息
+     *
+     * @param targets - 指定要输出信息的注册器名称，不传则列出全部
+     */
+    static debug(...targets) {
+        // 情况 A: 如果传了参数，就只打印指定的
+        if (targets.length > 0) {
+            targets.forEach(name => {
+                const registar = this.registars.get(name);
+                // 不做 instance 是否存在的防御，找不到就直接让它抛异常
+                // 不做 inspect 是否是函数的防御，没定义就让它报错
+                registar.inspect();
+            });
+            return;
+        }
+        // 情况 B: 没传参数，打印全部
+        this.registars.forEach(registar => registar.inspect());
+    }
+    /**
+     * 根据名称安全地获取注册器实例
+     * 这种方式在 doValidate 等核心逻辑中调用，不会产生循环依赖
+     *
+     * @param name - 要获取的注册器名称
+     * @returns 注册器实例，如果不存在则返回 undefined
+     */
+    static get(name) {
+        const registar = this.registars.get(name);
+        return registar;
+    }
+}
+_a = RegistryHub;
+/**
+ * 存储所有注册器实例
+ * 使用 Map 结构提供高效的键值对存储和检索
+ * @private
+ */
+RegistryHub.registars = new Map();
+/**
+ * 注册中心锁定状态
+ * 一旦锁定，将不允许新增或修改任何注册器
+ * @private
+ */
+RegistryHub.isLocked = false; // 锁定状态位
+/**
+ * 导出顶级访问代理
+ * 通过 ES6 Proxy 提供对注册器的便捷访问
+ * 允许通过 Registry.[name] 的方式访问注册器
+ */
+RegistryHub.root = new Proxy({}, {
+    get: (_, prop) => {
+        // 直接尝试获取，如果不存在，外部调用 Registry.nonExistent.get()
+        // 会因为 Registry.nonExistent 是 undefined 而立刻抛出异常
+        return _a.registars.get(prop);
+    },
+});
+/**
+ * Registry - 通过Proxy提供的注册中心根访问点
+ * 提供便捷的全局访问接口，例如 Registry.system.get() 或 Registry.mimeType.register()
+ */
+export const Registry = RegistryHub.root;
+//# sourceMappingURL=RegistryHub.js.map

package/dist/registry/RegistryHub.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegistryHub.js","sourceRoot":"","sources":["../../../src/registry/RegistryHub.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAI5E;;;;;;GAMG;AACH,MAAM,OAAO,WAAW;IAepB;;;;;;;;;OASG;IACH,MAAM,CAAC,IAAI;QACP,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YACzB,8BAA8B;YAC9B,GAAG,CAAC,IAAI,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,GAAG,CAA+B,SAAY,EAAE,QAAiB,KAAK;QACzE,cAAc;QACd,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,MAAM,IAAI,sBAAsB,CAAC;gBAC7B,aAAa,EAAE,SAAS,CAAC,IAAI;aAChC,CAAC,CAAC;QACP,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC;QAE3B,UAAU;QACV,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACrC,MAAM,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACpC,OAAO,SAAS,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,OAAiB;QAC7B,uBAAuB;QACvB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;gBACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC1C,kCAAkC;gBAClC,+BAA+B;gBAC/B,QAAS,CAAC,OAAO,EAAE,CAAC;YACxB,CAAC,CAAC,CAAC;YACH,OAAO;QACX,CAAC;QAED,kBAAkB;QAClB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAA+B,IAAY;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,QAAa,CAAC;IACzB,CAAC;;;AA9FD;;;;GAIG;AACqB,qBAAS,GAAG,IAAI,GAAG,EAA8B,AAAxC,CAAyC;AAE1E;;;;GAIG;AACY,oBAAQ,GAAG,KAAK,AAAR,CAAS,CAAC,QAAQ;AAoFzC;;;;GAIG;AACa,gBAAI,GAAG,IAAI,KAAK,CAC5B,EAAE,EACF;IACI,GAAG,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE;QACrB,+CAA+C;QAC/C,+CAA+C;QAC/C,OAAO,EAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACJ,CACU,AATK,CASJ;AAGpB;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC"}

package/dist/registry/RegistryHub.js

@@ -0,0 +1,120 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Registry = exports.RegistryHub = void 0;
+const errors_1 = require("./errors");
+/**
+ * 注册中心Hub - 用于统一管理各种注册器
+ * 提供注册、锁定、调试等功能
+ *
+ * RegistryHub 是整个注册系统的中心枢纽，它管理着所有的注册器实例，
+ * 并提供了统一的访问接口和锁定机制，确保注册阶段结束后系统处于稳定状态。
+ */
+class RegistryHub {
+    /**
+     * 锁定注册中心
+     * 调用后，任何对 use 方法的调用都会抛出 RegistryHubLockedError 错误
+     * 通常在应用启动完成时调用，防止后续意外修改
+     *
+     * 锁定机制的作用：
+     * 1. 防止在应用运行过程中意外修改配置
+     * 2. 确保配置的一致性和稳定性
+     * 3. 为生产环境提供安全保障
+     */
+    static lock() {
+        this.isLocked = true;
+        this.registars.forEach(ins => {
+            // 如果注册器自己也支持锁定逻辑（比如关闭 add 接口）
+            ins.lock();
+        });
+        Object.freeze(this.registars);
+    }
+    /**
+     * 注册子注册器
+     * 将指定的注册器实例添加到注册中心
+     *
+     * @param registrar - 要注册的注册器实例
+     * @param force - 是否强制注册（覆盖已有注册器），默认为 false
+     * @returns 注册器实例本身，允许链式调用
+     * @throws RegistryHubLockedError - 当注册中心已锁定时
+     * @throws RegistryHubConflictError - 当注册器名称冲突且未使用 force 时
+     */
+    static use(registrar, force = false) {
+        // 1. 优先检查锁定状态
+        if (this.isLocked) {
+            throw new errors_1.RegistryHubLockedError({
+                registrarName: registrar.name,
+            });
+        }
+        const { name } = registrar;
+        // 2. 冲突检查
+        if (this.registars.has(name) && !force) {
+            throw new errors_1.RegistryHubConflictError(name);
+        }
+        this.registars.set(name, registrar);
+        return registrar;
+    }
+    /**
+     * 调试接口：列出注册表信息
+     * 根据传入的参数决定输出哪些注册器的信息
+     *
+     * @param targets - 指定要输出信息的注册器名称，不传则列出全部
+     */
+    static debug(...targets) {
+        // 情况 A: 如果传了参数，就只打印指定的
+        if (targets.length > 0) {
+            targets.forEach(name => {
+                const registar = this.registars.get(name);
+                // 不做 instance 是否存在的防御，找不到就直接让它抛异常
+                // 不做 inspect 是否是函数的防御，没定义就让它报错
+                registar.inspect();
+            });
+            return;
+        }
+        // 情况 B: 没传参数，打印全部
+        this.registars.forEach(registar => registar.inspect());
+    }
+    /**
+     * 根据名称安全地获取注册器实例
+     * 这种方式在 doValidate 等核心逻辑中调用，不会产生循环依赖
+     *
+     * @param name - 要获取的注册器名称
+     * @returns 注册器实例，如果不存在则返回 undefined
+     */
+    static get(name) {
+        const registar = this.registars.get(name);
+        return registar;
+    }
+}
+exports.RegistryHub = RegistryHub;
+_a = RegistryHub;
+/**
+ * 存储所有注册器实例
+ * 使用 Map 结构提供高效的键值对存储和检索
+ * @private
+ */
+RegistryHub.registars = new Map();
+/**
+ * 注册中心锁定状态
+ * 一旦锁定，将不允许新增或修改任何注册器
+ * @private
+ */
+RegistryHub.isLocked = false; // 锁定状态位
+/**
+ * 导出顶级访问代理
+ * 通过 ES6 Proxy 提供对注册器的便捷访问
+ * 允许通过 Registry.[name] 的方式访问注册器
+ */
+RegistryHub.root = new Proxy({}, {
+    get: (_, prop) => {
+        // 直接尝试获取，如果不存在，外部调用 Registry.nonExistent.get()
+        // 会因为 Registry.nonExistent 是 undefined 而立刻抛出异常
+        return _a.registars.get(prop);
+    },
+});
+/**
+ * Registry - 通过Proxy提供的注册中心根访问点
+ * 提供便捷的全局访问接口，例如 Registry.system.get() 或 Registry.mimeType.register()
+ */
+exports.Registry = RegistryHub.root;
+//# sourceMappingURL=RegistryHub.js.map

package/dist/registry/RegistryHub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegistryHub.js","sourceRoot":"","sources":["../../../src/registry/RegistryHub.ts"],"names":[],"mappings":";;;;AAAA,qCAA4E;AAI5E;;;;;;GAMG;AACH,MAAa,WAAW;IAepB;;;;;;;;;OASG;IACH,MAAM,CAAC,IAAI;QACP,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YACzB,8BAA8B;YAC9B,GAAG,CAAC,IAAI,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,GAAG,CAA+B,SAAY,EAAE,QAAiB,KAAK;QACzE,cAAc;QACd,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,MAAM,IAAI,+BAAsB,CAAC;gBAC7B,aAAa,EAAE,SAAS,CAAC,IAAI;aAChC,CAAC,CAAC;QACP,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC;QAE3B,UAAU;QACV,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACrC,MAAM,IAAI,iCAAwB,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACpC,OAAO,SAAS,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,OAAiB;QAC7B,uBAAuB;QACvB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;gBACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC1C,kCAAkC;gBAClC,+BAA+B;gBAC/B,QAAS,CAAC,OAAO,EAAE,CAAC;YACxB,CAAC,CAAC,CAAC;YACH,OAAO;QACX,CAAC;QAED,kBAAkB;QAClB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAA+B,IAAY;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,QAAa,CAAC;IACzB,CAAC;;AA/FL,kCAgHC;;AA/GG;;;;GAIG;AACqB,qBAAS,GAAG,IAAI,GAAG,EAA8B,AAAxC,CAAyC;AAE1E;;;;GAIG;AACY,oBAAQ,GAAG,KAAK,AAAR,CAAS,CAAC,QAAQ;AAoFzC;;;;GAIG;AACa,gBAAI,GAAG,IAAI,KAAK,CAC5B,EAAE,EACF;IACI,GAAG,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE;QACrB,+CAA+C;QAC/C,+CAA+C;QAC/C,OAAO,EAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACJ,CACU,AATK,CASJ;AAGpB;;;GAGG;AACU,QAAA,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC"}

package/dist/registry/errors.d.ts

@@ -0,0 +1,55 @@
+import { ErrorBase } from '@qimenjs/error';
+/**
+ * RegistryHub错误的错误代码枚举
+ * 定义了注册中心可能遇到的各种错误情况
+ * 通过统一的错误代码便于错误分类和处理
+ */
+export declare enum RegistryHubErrorCode {
+    REGISTRATION_LOCKED = "REGISTRY_REGISTRATION_LOCKED",
+    REGISTRATION_CONFLICT = "REGISTRY_REGISTRATION_CONFLICT"
+}
+/**
+ * RegistryHub相关的基础错误类
+ * 所有注册中心相关错误的基类
+ * 提供了统一的错误处理机制和上下文信息
+ */
+export declare abstract class RegistryHubError extends ErrorBase {
+    /**
+     * 创建一个新的注册中心错误实例
+     *
+     * @param message - 错误消息描述
+     * @param code - 错误代码，来自 RegistryHubErrorCode 枚举
+     * @param context - 可选的错误上下文信息，提供更多错误相关数据
+     */
+    constructor(message: string, code: RegistryHubErrorCode, context?: Record<string, any>);
+}
+/**
+ * 注册中心锁定错误 - 当尝试在注册中心锁定后进行注册时抛出
+ * 通常在应用启动完成后注册中心被锁定，此时再尝试注册会抛出此错误
+ *
+ * 此错误提示开发者在正确的时机进行注册操作，避免在应用运行过程中修改配置
+ */
+export declare class RegistryHubLockedError extends RegistryHubError {
+    /**
+     * 创建一个新的注册中心锁定错误实例
+     *
+     * @param context - 错误上下文信息，包含更多关于错误发生时的环境信息
+     */
+    constructor(context?: Record<string, any>);
+}
+/**
+ * 注册冲突错误 - 当尝试注册已存在的名称时抛出
+ * 防止重复注册相同名称的注册器，保证注册器名称的唯一性
+ *
+ * 此错误有助于防止配置冲突和命名混乱，确保系统配置的准确性
+ */
+export declare class RegistryHubConflictError extends RegistryHubError {
+    /**
+     * 创建一个新的注册冲突错误实例
+     *
+     * @param name - 已存在的注册器名称
+     * @param context - 可选的错误上下文信息
+     */
+    constructor(name: string, context?: Record<string, any>);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/registry/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/registry/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;GAIG;AACH,oBAAY,oBAAoB;IAC5B,mBAAmB,iCAAiC;IACpD,qBAAqB,mCAAmC;CAC3D;AAED;;;;GAIG;AACH,8BAAsB,gBAAiB,SAAQ,SAAS;IACpD;;;;;;OAMG;gBACS,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAGzF;AAED;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,gBAAgB;IACxD;;;;OAIG;gBACS,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAQ5C;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,gBAAgB;IAC1D;;;;;OAKG;gBACS,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAO1D"}

package/dist/registry/errors.esm.js

@@ -0,0 +1,70 @@
+import { ErrorBase } from '@qimenjs/error';
+/**
+ * RegistryHub错误的错误代码枚举
+ * 定义了注册中心可能遇到的各种错误情况
+ * 通过统一的错误代码便于错误分类和处理
+ */
+export var RegistryHubErrorCode;
+(function (RegistryHubErrorCode) {
+    RegistryHubErrorCode["REGISTRATION_LOCKED"] = "REGISTRY_REGISTRATION_LOCKED";
+    RegistryHubErrorCode["REGISTRATION_CONFLICT"] = "REGISTRY_REGISTRATION_CONFLICT";
+})(RegistryHubErrorCode || (RegistryHubErrorCode = {}));
+/**
+ * RegistryHub相关的基础错误类
+ * 所有注册中心相关错误的基类
+ * 提供了统一的错误处理机制和上下文信息
+ */
+export class RegistryHubError extends ErrorBase {
+    /**
+     * 创建一个新的注册中心错误实例
+     *
+     * @param message - 错误消息描述
+     * @param code - 错误代码，来自 RegistryHubErrorCode 枚举
+     * @param context - 可选的错误上下文信息，提供更多错误相关数据
+     */
+    constructor(message, code, context) {
+        super(message, code, context);
+    }
+}
+/**
+ * 注册中心锁定错误 - 当尝试在注册中心锁定后进行注册时抛出
+ * 通常在应用启动完成后注册中心被锁定，此时再尝试注册会抛出此错误
+ *
+ * 此错误提示开发者在正确的时机进行注册操作，避免在应用运行过程中修改配置
+ */
+export class RegistryHubLockedError extends RegistryHubError {
+    /**
+     * 创建一个新的注册中心锁定错误实例
+     *
+     * @param context - 错误上下文信息，包含更多关于错误发生时的环境信息
+     */
+    constructor(context) {
+        const message = '[RegistryHub] Registration failed: The hub is locked. Registrations must be completed during the bootstrap phase.';
+        super(message, RegistryHubErrorCode.REGISTRATION_LOCKED, {
+            ...context,
+            phase: 'bootstrap',
+        });
+    }
+}
+/**
+ * 注册冲突错误 - 当尝试注册已存在的名称时抛出
+ * 防止重复注册相同名称的注册器，保证注册器名称的唯一性
+ *
+ * 此错误有助于防止配置冲突和命名混乱，确保系统配置的准确性
+ */
+export class RegistryHubConflictError extends RegistryHubError {
+    /**
+     * 创建一个新的注册冲突错误实例
+     *
+     * @param name - 已存在的注册器名称
+     * @param context - 可选的错误上下文信息
+     */
+    constructor(name, context) {
+        const message = `[RegistryHub] Conflict: "${name}" already exists.`;
+        super(message, RegistryHubErrorCode.REGISTRATION_CONFLICT, {
+            ...context,
+            registrarName: name,
+        });
+    }
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/registry/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;GAIG;AACH,MAAM,CAAN,IAAY,oBAGX;AAHD,WAAY,oBAAoB;IAC5B,4EAAoD,CAAA;IACpD,gFAAwD,CAAA;AAC5D,CAAC,EAHW,oBAAoB,KAApB,oBAAoB,QAG/B;AAED;;;;GAIG;AACH,MAAM,OAAgB,gBAAiB,SAAQ,SAAS;IACpD;;;;;;OAMG;IACH,YAAY,OAAe,EAAE,IAA0B,EAAE,OAA6B;QAClF,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,OAAO,sBAAuB,SAAQ,gBAAgB;IACxD;;;;OAIG;IACH,YAAY,OAA6B;QACrC,MAAM,OAAO,GACT,mHAAmH,CAAC;QACxH,KAAK,CAAC,OAAO,EAAE,oBAAoB,CAAC,mBAAmB,EAAE;YACrD,GAAG,OAAO;YACV,KAAK,EAAE,WAAW;SACrB,CAAC,CAAC;IACP,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,OAAO,wBAAyB,SAAQ,gBAAgB;IAC1D;;;;;OAKG;IACH,YAAY,IAAY,EAAE,OAA6B;QACnD,MAAM,OAAO,GAAG,4BAA4B,IAAI,mBAAmB,CAAC;QACpE,KAAK,CAAC,OAAO,EAAE,oBAAoB,CAAC,qBAAqB,EAAE;YACvD,GAAG,OAAO;YACV,aAAa,EAAE,IAAI;SACtB,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/registry/errors.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RegistryHubConflictError = exports.RegistryHubLockedError = exports.RegistryHubError = exports.RegistryHubErrorCode = void 0;
+const error_1 = require("@qimenjs/error");
+/**
+ * RegistryHub错误的错误代码枚举
+ * 定义了注册中心可能遇到的各种错误情况
+ * 通过统一的错误代码便于错误分类和处理
+ */
+var RegistryHubErrorCode;
+(function (RegistryHubErrorCode) {
+    RegistryHubErrorCode["REGISTRATION_LOCKED"] = "REGISTRY_REGISTRATION_LOCKED";
+    RegistryHubErrorCode["REGISTRATION_CONFLICT"] = "REGISTRY_REGISTRATION_CONFLICT";
+})(RegistryHubErrorCode || (exports.RegistryHubErrorCode = RegistryHubErrorCode = {}));
+/**
+ * RegistryHub相关的基础错误类
+ * 所有注册中心相关错误的基类
+ * 提供了统一的错误处理机制和上下文信息
+ */
+class RegistryHubError extends error_1.ErrorBase {
+    /**
+     * 创建一个新的注册中心错误实例
+     *
+     * @param message - 错误消息描述
+     * @param code - 错误代码，来自 RegistryHubErrorCode 枚举
+     * @param context - 可选的错误上下文信息，提供更多错误相关数据
+     */
+    constructor(message, code, context) {
+        super(message, code, context);
+    }
+}
+exports.RegistryHubError = RegistryHubError;
+/**
+ * 注册中心锁定错误 - 当尝试在注册中心锁定后进行注册时抛出
+ * 通常在应用启动完成后注册中心被锁定，此时再尝试注册会抛出此错误
+ *
+ * 此错误提示开发者在正确的时机进行注册操作，避免在应用运行过程中修改配置
+ */
+class RegistryHubLockedError extends RegistryHubError {
+    /**
+     * 创建一个新的注册中心锁定错误实例
+     *
+     * @param context - 错误上下文信息，包含更多关于错误发生时的环境信息
+     */
+    constructor(context) {
+        const message = '[RegistryHub] Registration failed: The hub is locked. Registrations must be completed during the bootstrap phase.';
+        super(message, RegistryHubErrorCode.REGISTRATION_LOCKED, {
+            ...context,
+            phase: 'bootstrap',
+        });
+    }
+}
+exports.RegistryHubLockedError = RegistryHubLockedError;
+/**
+ * 注册冲突错误 - 当尝试注册已存在的名称时抛出
+ * 防止重复注册相同名称的注册器，保证注册器名称的唯一性
+ *
+ * 此错误有助于防止配置冲突和命名混乱，确保系统配置的准确性
+ */
+class RegistryHubConflictError extends RegistryHubError {
+    /**
+     * 创建一个新的注册冲突错误实例
+     *
+     * @param name - 已存在的注册器名称
+     * @param context - 可选的错误上下文信息
+     */
+    constructor(name, context) {
+        const message = `[RegistryHub] Conflict: "${name}" already exists.`;
+        super(message, RegistryHubErrorCode.REGISTRATION_CONFLICT, {
+            ...context,
+            registrarName: name,
+        });
+    }
+}
+exports.RegistryHubConflictError = RegistryHubConflictError;
+//# sourceMappingURL=errors.js.map

package/dist/registry/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/registry/errors.ts"],"names":[],"mappings":";;;AAAA,0CAA2C;AAE3C;;;;GAIG;AACH,IAAY,oBAGX;AAHD,WAAY,oBAAoB;IAC5B,4EAAoD,CAAA;IACpD,gFAAwD,CAAA;AAC5D,CAAC,EAHW,oBAAoB,oCAApB,oBAAoB,QAG/B;AAED;;;;GAIG;AACH,MAAsB,gBAAiB,SAAQ,iBAAS;IACpD;;;;;;OAMG;IACH,YAAY,OAAe,EAAE,IAA0B,EAAE,OAA6B;QAClF,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;CACJ;AAXD,4CAWC;AAED;;;;;GAKG;AACH,MAAa,sBAAuB,SAAQ,gBAAgB;IACxD;;;;OAIG;IACH,YAAY,OAA6B;QACrC,MAAM,OAAO,GACT,mHAAmH,CAAC;QACxH,KAAK,CAAC,OAAO,EAAE,oBAAoB,CAAC,mBAAmB,EAAE;YACrD,GAAG,OAAO;YACV,KAAK,EAAE,WAAW;SACrB,CAAC,CAAC;IACP,CAAC;CACJ;AAdD,wDAcC;AAED;;;;;GAKG;AACH,MAAa,wBAAyB,SAAQ,gBAAgB;IAC1D;;;;;OAKG;IACH,YAAY,IAAY,EAAE,OAA6B;QACnD,MAAM,OAAO,GAAG,4BAA4B,IAAI,mBAAmB,CAAC;QACpE,KAAK,CAAC,OAAO,EAAE,oBAAoB,CAAC,qBAAqB,EAAE;YACvD,GAAG,OAAO;YACV,aAAa,EAAE,IAAI;SACtB,CAAC,CAAC;IACP,CAAC;CACJ;AAdD,4DAcC"}

package/dist/registry/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Registry模块入口文件
+ * 提供注册中心的核心功能和各类注册器
+ *
+ * 此文件作为registry模块的统一入口，导出所有相关的类型、类和实例
+ * 通过此文件可以方便地访问注册中心的所有功能
+ */
+export * from './errors';
+export * from './RegistryHub';
+export * from './types';
+export * from './registrars';
+//# sourceMappingURL=index.d.ts.map

package/dist/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,cAAc,UAAU,CAAC;AAGzB,cAAc,eAAe,CAAC;AAG9B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC"}

package/dist/registry/index.esm.js

@@ -0,0 +1,24 @@
+/**
+ * Registry模块入口文件
+ * 提供注册中心的核心功能和各类注册器
+ *
+ * 此文件作为registry模块的统一入口，导出所有相关的类型、类和实例
+ * 通过此文件可以方便地访问注册中心的所有功能
+ */
+// RegistryHub错误类
+export * from './errors';
+// RegistryHub主类
+export * from './RegistryHub';
+// 类型定义
+export * from './types';
+export * from './registrars';
+import { DomainRegistrar, HtmlTemplateRegistrar, SystemRegistrar } from './registrars';
+import { RegistryHub } from './RegistryHub';
+import { DataProcessorRegistrar } from '../data-processor';
+// 初始化默认注册器
+// 在模块加载时自动注册常用的注册器实例，确保它们随时可用
+RegistryHub.use(SystemRegistrar.getInstance());
+RegistryHub.use(HtmlTemplateRegistrar.getInstance());
+RegistryHub.use(DomainRegistrar.getInstance());
+RegistryHub.use(DataProcessorRegistrar.getInstance());
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,iBAAiB;AACjB,cAAc,UAAU,CAAC;AAEzB,gBAAgB;AAChB,cAAc,eAAe,CAAC;AAE9B,OAAO;AACP,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,WAAW;AACX,8BAA8B;AAC9B,WAAW,CAAC,GAAG,CAAC,eAAe,CAAC,WAAW,EAAE,CAAC,CAAC;AAC/C,WAAW,CAAC,GAAG,CAAC,qBAAqB,CAAC,WAAW,EAAE,CAAC,CAAC;AACrD,WAAW,CAAC,GAAG,CAAC,eAAe,CAAC,WAAW,EAAE,CAAC,CAAC;AAC/C,WAAW,CAAC,GAAG,CAAC,sBAAsB,CAAC,WAAW,EAAE,CAAC,CAAC"}

package/dist/registry/index.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * Registry模块入口文件
+ * 提供注册中心的核心功能和各类注册器
+ *
+ * 此文件作为registry模块的统一入口，导出所有相关的类型、类和实例
+ * 通过此文件可以方便地访问注册中心的所有功能
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// RegistryHub错误类
+__exportStar(require("./errors"), exports);
+// RegistryHub主类
+__exportStar(require("./RegistryHub"), exports);
+// 类型定义
+__exportStar(require("./types"), exports);
+__exportStar(require("./registrars"), exports);
+const registrars_1 = require("./registrars");
+const RegistryHub_1 = require("./RegistryHub");
+const data_processor_1 = require("../data-processor");
+// 初始化默认注册器
+// 在模块加载时自动注册常用的注册器实例，确保它们随时可用
+RegistryHub_1.RegistryHub.use(registrars_1.SystemRegistrar.getInstance());
+RegistryHub_1.RegistryHub.use(registrars_1.HtmlTemplateRegistrar.getInstance());
+RegistryHub_1.RegistryHub.use(registrars_1.DomainRegistrar.getInstance());
+RegistryHub_1.RegistryHub.use(data_processor_1.DataProcessorRegistrar.getInstance());
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/registry/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;AAEH,iBAAiB;AACjB,2CAAyB;AAEzB,gBAAgB;AAChB,gDAA8B;AAE9B,OAAO;AACP,0CAAwB;AACxB,+CAA6B;AAE7B,6CAAuF;AACvF,+CAA4C;AAC5C,sDAA2D;AAE3D,WAAW;AACX,8BAA8B;AAC9B,yBAAW,CAAC,GAAG,CAAC,4BAAe,CAAC,WAAW,EAAE,CAAC,CAAC;AAC/C,yBAAW,CAAC,GAAG,CAAC,kCAAqB,CAAC,WAAW,EAAE,CAAC,CAAC;AACrD,yBAAW,CAAC,GAAG,CAAC,4BAAe,CAAC,WAAW,EAAE,CAAC,CAAC;AAC/C,yBAAW,CAAC,GAAG,CAAC,uCAAsB,CAAC,WAAW,EAAE,CAAC,CAAC"}

package/dist/registry/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@qimen-lab/registry",
+  "version": "0.1.1",
+  "main": "index.js",
+  "module": "index.esm.js",
+  "types": "index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": "./index.esm.js",
+      "require": "./index.js",
+      "types": "./index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@qimen-lab/error": "0.1.1"
+  }
+}

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

@@ -0,0 +1,74 @@
+import { DomainConfig } from '../types';
+import { RegistrarBase } from './RegistrarBase';
+/**
+ * 域配置注册器
+ * 管理不同域名的配置信息
+ *
+ * 用于存储和管理多个API端点或服务域的配置信息，
+ * 支持不同的超时时长、分页配置、公共参数等
+ */
+export declare class DomainRegistrar extends RegistrarBase<Map<string, DomainConfig>> {
+    readonly name: "domain";
+    /**
+     * 存储域名称到域配置的映射
+     * 使用Map结构提供高效的键值对存储和检索
+     * @protected
+     */
+    protected storage: Map<string, DomainConfig>;
+    /**
+     * 注册一个域配置
+     *
+     * @param name - 域名称，作为唯一标识符
+     * @param config - 域配置对象，包含API端点的相关设置
+     * @param force - 是否强制注册（覆盖已有配置），默认为 false
+     * @throws RegistrarConflictError - 当配置名称冲突且未使用 force 时
+     */
+    register(name: string, config: DomainConfig, force?: boolean): void;
+    /**
+     * 删除一个域配置
+     * 从存储中移除指定名称的配置
+     *
+     * @param name - 要删除的域名称
+     */
+    unregister(name: string): void;
+    /**
+     * 获取域配置
+     *
+     * @param name - 域名称
+     * @returns 域配置对象
+     */
+    get(name: string): DomainConfig;
+    /**
+     * 获取域的基地址
+     * 便捷方法，直接返回指定域的baseUrl
+     *
+     * @param name - 域名称
+     * @returns 域的基地址
+     */
+    getBaseUrl(name: string): string;
+    /**
+     * 更新 token
+     *
+     * 批量更新多个域的 token
+     *
+     * @param token - Token 字符串
+     * @param domains - 域名列表（可变参数）
+     */
+    updateToken(token: string, ...domains: string[]): void;
+    /**
+     * 清除 token
+     *
+     * 批量清除多个域的 token
+     *
+     * @param domains - 域名列表（可变参数）
+     */
+    clearToken(...domains: string[]): void;
+    /**
+     * 输出域注册器的状态信息
+     * 显示当前存储的所有域名称和对应的基地址
+     *
+     * @protected
+     */
+    protected doInspect(): void;
+}
+//# sourceMappingURL=DomainRegistrar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DomainRegistrar.d.ts","sourceRoot":"","sources":["../../../../src/registry/registrars/DomainRegistrar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,UAAU,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzE,SAAgB,IAAI,WAAuB;IAE3C;;;;OAIG;IACH,SAAS,CAAC,OAAO,4BAAmC;IAEpD;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,UAAQ,GAAG,IAAI;IAYjE;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK9B;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAI/B;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKhC;;;;;;;OAOG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAStD;;;;;;OAMG;IACH,UAAU,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAStC;;;;;OAKG;IACH,SAAS,CAAC,SAAS,IAAI,IAAI;CAS9B"}