@nexe/config-manager 0.1.0

package/dist/factory.d.ts

@@ -0,0 +1,45 @@
+import { ConfigManager } from './config-manager';
+export interface ConfigSourceOptions {
+    environment?: {
+        enabled: boolean;
+        prefix?: string;
+        priority?: number;
+    };
+    json?: {
+        enabled: boolean;
+        filePath: string;
+        watchChanges?: boolean;
+        priority?: number;
+    };
+    yaml?: {
+        enabled: boolean;
+        filePath: string;
+        watchChanges?: boolean;
+        priority?: number;
+    };
+    remoteApi?: {
+        enabled: boolean;
+        baseUrl: string;
+        headers?: Record<string, string>;
+        pollingInterval?: number;
+        priority?: number;
+    };
+    consul?: {
+        enabled: boolean;
+        host: string;
+        port: number;
+        secure?: boolean;
+        token?: string;
+        dc?: string;
+        keyPrefix?: string;
+        watchInterval?: number;
+        priority?: number;
+    };
+}
+/**
+ * 创建配置管理器的工厂函数
+ * @param options 配置源选项
+ * @returns 配置管理器实例
+ */
+export declare function createConfigManager(options: ConfigSourceOptions): ConfigManager;
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAOjD,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE;QACZ,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,SAAS,CAAC,EAAE;QACV,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,mBAAmB,GAC3B,aAAa,CAgEf"}

package/dist/factory.js

@@ -0,0 +1,46 @@
+import { container } from 'tsyringe';
+import { ConfigManager } from './config-manager';
+import { ConsulConfigSource } from './sources/consul-config-source';
+import { EnvironmentConfigSource } from './sources/environment-config-source';
+import { JsonConfigSource } from './sources/json-config-source';
+import { RemoteApiConfigSource } from './sources/remote-api-config-source';
+import { YamlConfigSource } from './sources/yaml-config-source';
+/**
+ * 创建配置管理器的工厂函数
+ * @param options 配置源选项
+ * @returns 配置管理器实例
+ */
+export function createConfigManager(options) {
+    const configManager = new ConfigManager();
+    // 添加环境变量配置源
+    if (options.environment?.enabled) {
+        configManager.addSource(new EnvironmentConfigSource(options.environment.prefix ?? ''), options.environment.priority ?? 100);
+    }
+    // 添加JSON配置源
+    if (options.json?.enabled) {
+        configManager.addSource(new JsonConfigSource(options.json.filePath, options.json.watchChanges ?? false), options.json.priority ?? 20);
+    }
+    // 添加YAML配置源
+    if (options.yaml?.enabled) {
+        configManager.addSource(new YamlConfigSource(options.yaml.filePath, options.yaml.watchChanges ?? false), options.yaml.priority ?? 40);
+    }
+    // 添加远程API配置源
+    if (options.remoteApi?.enabled) {
+        configManager.addSource(new RemoteApiConfigSource(options.remoteApi.baseUrl, options.remoteApi.headers ?? {}, options.remoteApi.pollingInterval), options.remoteApi.priority ?? 60);
+    }
+    // 添加Consul配置源
+    if (options.consul?.enabled) {
+        configManager.addSource(new ConsulConfigSource({
+            host: options.consul.host,
+            port: options.consul.port,
+            secure: options.consul.secure,
+            token: options.consul.token,
+            dc: options.consul.dc,
+            defaultKeyPrefix: options.consul.keyPrefix,
+        }), options.consul.priority ?? 80);
+    }
+    // 注册到容器
+    container.registerInstance(ConfigManager, configManager);
+    return configManager;
+}
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAwChE;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAA4B;IAE5B,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;IAE1C,YAAY;IACZ,IAAI,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;QACjC,aAAa,CAAC,SAAS,CACrB,IAAI,uBAAuB,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,IAAI,EAAE,CAAC,EAC7D,OAAO,CAAC,WAAW,CAAC,QAAQ,IAAI,GAAG,CACpC,CAAC;IACJ,CAAC;IAED,YAAY;IACZ,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;QAC1B,aAAa,CAAC,SAAS,CACrB,IAAI,gBAAgB,CAClB,OAAO,CAAC,IAAI,CAAC,QAAQ,EACrB,OAAO,CAAC,IAAI,CAAC,YAAY,IAAI,KAAK,CACnC,EACD,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAC5B,CAAC;IACJ,CAAC;IAED,YAAY;IACZ,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;QAC1B,aAAa,CAAC,SAAS,CACrB,IAAI,gBAAgB,CAClB,OAAO,CAAC,IAAI,CAAC,QAAQ,EACrB,OAAO,CAAC,IAAI,CAAC,YAAY,IAAI,KAAK,CACnC,EACD,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAC5B,CAAC;IACJ,CAAC;IAED,aAAa;IACb,IAAI,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC;QAC/B,aAAa,CAAC,SAAS,CACrB,IAAI,qBAAqB,CACvB,OAAO,CAAC,SAAS,CAAC,OAAO,EACzB,OAAO,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,EAC/B,OAAO,CAAC,SAAS,CAAC,eAAe,CAClC,EACD,OAAO,CAAC,SAAS,CAAC,QAAQ,IAAI,EAAE,CACjC,CAAC;IACJ,CAAC;IAED,cAAc;IACd,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QAC5B,aAAa,CAAC,SAAS,CACrB,IAAI,kBAAkB,CAAC;YACrB,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;YACzB,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;YACzB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM;YAC7B,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK;YAC3B,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE;YACrB,gBAAgB,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;SAC3C,CAAC,EACF,OAAO,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAC9B,CAAC;IACJ,CAAC;IAED,QAAQ;IACR,SAAS,CAAC,gBAAgB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IAEzD,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './config-manager';
+export * from './decorators';
+export * from './interfaces';
+export * from './sources';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from './config-manager';
+export * from './decorators';
+export * from './interfaces';
+export * from './sources';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/dist/interfaces.d.ts

@@ -0,0 +1,100 @@
+/**
+ * 配置源接口
+ * 所有配置源必须实现此接口
+ */
+export interface IConfigSource<T = unknown> {
+    /**
+     * 加载配置
+     * @param key 可选的配置键，用于获取特定配置项
+     * @param pathPrefix 可选的路径前缀，用于动态指定配置路径
+     */
+    load: (key?: string, pathPrefix?: string) => Promise<T>;
+    /**
+     * 获取配置源名称
+     */
+    getName: () => string;
+    /**
+     * 是否支持热更新
+     */
+    supportsHotReload: () => boolean;
+    /**
+     * 是否支持动态路径
+     */
+    supportsDynamicPath?: () => boolean;
+    /**
+     * 订阅配置变更（如果支持热更新）
+     * @param key 配置键
+     * @param callback 配置变更时的回调函数
+     * @param pathPrefix 可选的路径前缀
+     */
+    subscribe?: (key: string, callback: (value: unknown) => void, pathPrefix?: string) => void;
+    /**
+     * 取消订阅配置变更
+     * @param key 配置键
+     * @param pathPrefix 可选的路径前缀
+     */
+    unsubscribe?: (key: string, pathPrefix?: string) => void;
+}
+/**
+ * 配置获取选项
+ */
+export interface ConfigOptions {
+    /**
+     * 配置路径前缀，用于指定从哪个路径获取配置
+     */
+    pathPrefix?: string;
+    /**
+     * 配置源名称，用于指定从哪个配置源获取配置
+     */
+    sourceName?: string;
+}
+/**
+ * 配置管理器接口
+ */
+export interface IConfigManager {
+    /**
+     * 添加配置源
+     * @param source 配置源实例
+     * @param priority 优先级，数字越大优先级越高
+     */
+    addSource: (source: IConfigSource, priority?: number) => void;
+    /**
+     * 获取配置值
+     * @param key 配置键
+     * @param defaultValue 默认值
+     * @param options 配置选项
+     */
+    get: <T>(key: string, defaultValue?: T, options?: ConfigOptions) => Promise<T>;
+    /**
+     * 获取强类型配置对象
+     * @param configClass 配置类
+     * @param options 配置选项，可指定配置路径前缀
+     */
+    getConfig: <T>(configClass: new () => T, options?: ConfigOptions) => Promise<T>;
+    /**
+     * 订阅配置变更
+     * @param key 配置键
+     * @param callback 配置变更时的回调函数
+     * @param options 配置选项，可指定配置路径前缀
+     */
+    subscribe: <T>(key: string, callback: (value: T) => void, options?: ConfigOptions) => void;
+    /**
+     * 取消订阅配置变更
+     * @param key 配置键
+     * @param options 配置选项，可指定配置路径前缀
+     */
+    unsubscribe: (key: string, options?: ConfigOptions) => void;
+}
+/**
+ * 配置装饰器元数据键
+ */
+export declare const CONFIG_PROPERTY_METADATA = "config:property";
+export declare const CONFIG_SECTION_METADATA = "config:section";
+/**
+ * 配置属性元数据
+ */
+export interface ConfigPropertyMetadata {
+    key: string;
+    propertyKey: string;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC;;;;OAIG;IACH,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAExD;;OAEG;IACH,OAAO,EAAE,MAAM,MAAM,CAAC;IAEtB;;OAEG;IACH,iBAAiB,EAAE,MAAM,OAAO,CAAC;IAEjC;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC;IAEpC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,CACV,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EAClC,UAAU,CAAC,EAAE,MAAM,KAChB,IAAI,CAAC;IAEV;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1D;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,SAAS,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAE9D;;;;;OAKG;IACH,GAAG,EAAE,CAAC,CAAC,EACL,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,CAAC,EAChB,OAAO,CAAC,EAAE,aAAa,KACpB,OAAO,CAAC,CAAC,CAAC,CAAC;IAEhB;;;;OAIG;IACH,SAAS,EAAE,CAAC,CAAC,EACX,WAAW,EAAE,UAAU,CAAC,EACxB,OAAO,CAAC,EAAE,aAAa,KACpB,OAAO,CAAC,CAAC,CAAC,CAAC;IAEhB;;;;;OAKG;IACH,SAAS,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,KAAK,IAAI,CAAC;IAE3F;;;;OAIG;IACH,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,KAAK,IAAI,CAAC;CAC7D;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,oBAAoB,CAAC;AAC1D,eAAO,MAAM,uBAAuB,mBAAmB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/interfaces.js

@@ -0,0 +1,6 @@
+/**
+ * 配置装饰器元数据键
+ */
+export const CONFIG_PROPERTY_METADATA = 'config:property';
+export const CONFIG_SECTION_METADATA = 'config:section';
+//# sourceMappingURL=interfaces.js.map

package/dist/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AA+GA;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,iBAAiB,CAAC;AAC1D,MAAM,CAAC,MAAM,uBAAuB,GAAG,gBAAgB,CAAC"}

package/dist/sources/consul-config-source.d.ts

@@ -0,0 +1,79 @@
+import type { IConfigSource } from '../interfaces';
+interface ConsulOptions {
+    host: string;
+    port: number;
+    secure?: boolean;
+    token?: string;
+    dc?: string;
+    defaultKeyPrefix?: string;
+}
+/**
+ * 支持动态路径的 Consul 配置源
+ * 允许在运行时指定不同的配置路径前缀
+ */
+export declare class ConsulConfigSource implements IConfigSource {
+    private consul;
+    private options;
+    private pathCaches;
+    private callbacks;
+    private watchers;
+    private recreatingWatchers;
+    /**
+     * @param options Consul配置选项
+     */
+    constructor(options: ConsulOptions);
+    /**
+     * 从Consul加载配置
+     */
+    load(key?: string, pathPrefix?: string): Promise<unknown>;
+    /**
+     * 获取指定前缀的所有配置键
+     */
+    private fetchKeysForPrefix;
+    /**
+     * 获取相对路径
+     */
+    private getRelativePath;
+    /**
+     * 解码Consul值
+     */
+    private decodeConsulValue;
+    /**
+     * 获取嵌套值
+     */
+    private getNestedValue;
+    /**
+     * 设置嵌套值
+     */
+    private setNestedValue;
+    /**
+     * 获取配置源名称
+     */
+    getName(): string;
+    /**
+     * 是否支持热更新
+     */
+    supportsHotReload(): boolean;
+    /**
+     * 是否支持动态路径
+     */
+    supportsDynamicPath(): boolean;
+    /**
+     * 订阅配置变更
+     */
+    subscribe(key: string, callback: (value: unknown) => void, pathPrefix?: string): void;
+    /**
+     * 取消订阅配置变更
+     */
+    unsubscribe(key: string, pathPrefix?: string): void;
+    /**
+     * 创建配置监听器
+     */
+    private createWatcher;
+    /**
+     * 清理资源
+     */
+    dispose(): void;
+}
+export {};
+//# sourceMappingURL=consul-config-source.d.ts.map

package/dist/sources/consul-config-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consul-config-source.d.ts","sourceRoot":"","sources":["../../src/sources/consul-config-source.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAcD;;;GAGG;AACH,qBACa,kBAAmB,YAAW,aAAa;IAEtD,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,OAAO,CAAgB;IAE/B,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,SAAS,CAAmD;IAEpE,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,kBAAkB,CAAqB;IAE/C;;OAEG;gBACS,OAAO,EAAE,aAAa;IAqBlC;;OAEG;IACG,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA4B/D;;OAEG;YACW,kBAAkB;IA8DhC;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAczB;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAqBtB;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,iBAAiB,IAAI,OAAO;IAI5B;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAI9B;;OAEG;IACH,SAAS,CACP,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EAClC,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI;IAsBP;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAyBnD;;OAEG;IACH,OAAO,CAAC,aAAa;IAkFrB;;OAEG;IACH,OAAO,IAAI,IAAI;CAsBhB"}

package/dist/sources/consul-config-source.js

@@ -0,0 +1,332 @@
+import { __decorate, __metadata } from "tslib";
+import { createLogger } from '@nexe/logger';
+import Consul from 'consul';
+import { injectable } from 'tsyringe';
+const logger = createLogger('ConsulConfigSource');
+/**
+ * 支持动态路径的 Consul 配置源
+ * 允许在运行时指定不同的配置路径前缀
+ */
+let ConsulConfigSource = class ConsulConfigSource {
+    /**
+     * @param options Consul配置选项
+     */
+    constructor(options) {
+        // 按路径前缀分别缓存配置
+        this.pathCaches = new Map();
+        this.callbacks = new Map();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        this.watchers = new Map();
+        this.recreatingWatchers = new Set(); // 防止重复创建
+        this.options = {
+            secure: false,
+            defaultKeyPrefix: '',
+            ...options,
+        };
+        // 初始化Consul客户端
+        this.consul = new Consul({
+            host: this.options.host,
+            port: this.options.port,
+            secure: this.options.secure,
+            defaults: {
+                token: this.options.token,
+                dc: this.options.dc,
+            },
+        });
+        logger.info(`🔗 已连接到Consul: ${this.options.host}:${this.options.port}`);
+    }
+    /**
+     * 从Consul加载配置
+     */
+    async load(key, pathPrefix) {
+        const actualPrefix = pathPrefix || this.options.defaultKeyPrefix || '';
+        try {
+            // 检查是否已缓存该路径的配置
+            if (!this.pathCaches.has(actualPrefix)) {
+                logger.info(`🔄 正在从Consul加载配置路径: ${actualPrefix}`);
+                await this.fetchKeysForPrefix(actualPrefix);
+            }
+            const cache = this.pathCaches.get(actualPrefix) || {};
+            if (!key) {
+                return cache;
+            }
+            const value = this.getNestedValue(cache, key);
+            return value;
+        }
+        catch (error) {
+            logger.error(`从Consul加载配置失败 (路径: ${actualPrefix}, 键: ${key}): ${error instanceof Error ? error.message : String(error)}`);
+            return undefined;
+        }
+    }
+    /**
+     * 获取指定前缀的所有配置键
+     */
+    async fetchKeysForPrefix(keyPrefix) {
+        try {
+            const cache = {};
+            // 首先尝试获取前缀作为单个JSON对象（兼容原版）
+            try {
+                const singleResult = await this.consul.kv.get({
+                    key: keyPrefix,
+                    recurse: false,
+                });
+                if (singleResult &&
+                    !Array.isArray(singleResult) &&
+                    singleResult.Value) {
+                    // 如果存在单个JSON对象，解析它
+                    const jsonData = this.decodeConsulValue(singleResult.Value);
+                    if (jsonData && typeof jsonData === 'object') {
+                        // logger.debug(`发现单个JSON配置对象 (${keyPrefix})，使用原版兼容模式`);
+                        Object.assign(cache, jsonData);
+                        this.pathCaches.set(keyPrefix, cache);
+                        // logger.info(
+                        //   `✅ 已缓存配置路径 ${keyPrefix}，包含 ${Object.keys(cache).length} 个配置项`,
+                        // );
+                        return;
+                    }
+                }
+            }
+            catch (error) {
+                logger.debug(`单个JSON模式失败 (${keyPrefix})，尝试递归模式:`, error);
+            }
+            // 如果单个JSON模式失败，使用递归模式获取所有子键
+            const result = await this.consul.kv.get({
+                key: keyPrefix,
+                recurse: true,
+            });
+            if (Array.isArray(result)) {
+                // 递归模式：处理多个键值对
+                logger.debug(`使用递归模式处理配置路径 (${keyPrefix})`);
+                for (const item of result) {
+                    if (item.Key && item.Value !== undefined) {
+                        const relativePath = this.getRelativePath(item.Key, keyPrefix);
+                        const value = this.decodeConsulValue(item.Value);
+                        if (relativePath) {
+                            this.setNestedValue(cache, relativePath, value);
+                        }
+                    }
+                }
+            }
+            this.pathCaches.set(keyPrefix, cache);
+            logger.info(`✅ 已缓存配置路径 ${keyPrefix}，包含 ${Object.keys(cache).length} 个配置项`);
+        }
+        catch (error) {
+            logger.error(`获取Consul配置前缀 ${keyPrefix} 失败:`, error);
+            this.pathCaches.set(keyPrefix, {});
+        }
+    }
+    /**
+     * 获取相对路径
+     */
+    getRelativePath(fullKey, prefix) {
+        if (!prefix) {
+            return fullKey;
+        }
+        const relativePath = fullKey.startsWith(prefix)
+            ? fullKey.slice(prefix.length)
+            : fullKey;
+        return relativePath.replace(/^\//, '');
+    }
+    /**
+     * 解码Consul值
+     */
+    decodeConsulValue(value) {
+        if (!value) {
+            return null;
+        }
+        try {
+            // 尝试解析为JSON
+            return JSON.parse(value);
+        }
+        catch {
+            // 如果不是JSON，返回原始字符串
+            return value;
+        }
+    }
+    /**
+     * 获取嵌套值
+     */
+    getNestedValue(obj, path) {
+        return path.split('.').reduce((current, key) => {
+            return current && typeof current === 'object' && !Array.isArray(current)
+                ? current[key]
+                : undefined;
+        }, obj);
+    }
+    /**
+     * 设置嵌套值
+     */
+    setNestedValue(obj, path, value) {
+        const keys = path.split('.');
+        const lastKey = keys.pop();
+        if (!lastKey) {
+            return;
+        }
+        const target = keys.reduce((current, key) => {
+            if (!(key in current)) {
+                current[key] = {};
+            }
+            return current[key];
+        }, obj);
+        target[lastKey] = value;
+    }
+    /**
+     * 获取配置源名称
+     */
+    getName() {
+        return `ConsulConfigSource(${this.options.host}:${this.options.port})`;
+    }
+    /**
+     * 是否支持热更新
+     */
+    supportsHotReload() {
+        return true;
+    }
+    /**
+     * 是否支持动态路径
+     */
+    supportsDynamicPath() {
+        return true;
+    }
+    /**
+     * 订阅配置变更
+     */
+    subscribe(key, callback, pathPrefix) {
+        const actualPrefix = pathPrefix || this.options.defaultKeyPrefix || '';
+        const watchKey = `${actualPrefix}:${key}`;
+        logger.info(`🔔 订阅配置变更: ${watchKey}`);
+        // 添加回调到列表
+        const callbacks = this.callbacks.get(watchKey) ?? [];
+        callbacks.push(callback);
+        this.callbacks.set(watchKey, callbacks);
+        // 如果还没有为这个路径+键创建watcher且不在重新创建中，则创建一个
+        if (!this.watchers.has(watchKey) && !this.recreatingWatchers.has(watchKey)) {
+            logger.info(`🚀 创建新的 watcher: ${watchKey}`);
+            this.createWatcher(actualPrefix, key);
+        }
+        else if (this.watchers.has(watchKey)) {
+            logger.info(`♻️ watcher 已存在: ${watchKey}`);
+        }
+        else if (this.recreatingWatchers.has(watchKey)) {
+            logger.info(`⏳ watcher 正在重新创建中: ${watchKey}`);
+        }
+    }
+    /**
+     * 取消订阅配置变更
+     */
+    unsubscribe(key, pathPrefix) {
+        const actualPrefix = pathPrefix || this.options.defaultKeyPrefix || '';
+        const watchKey = `${actualPrefix}:${key}`;
+        logger.info(`🚫 取消订阅配置变更: ${watchKey}`);
+        // 删除回调
+        this.callbacks.delete(watchKey);
+        // 取消重新创建标记
+        this.recreatingWatchers.delete(watchKey);
+        // 关闭对应的watcher
+        const watcher = this.watchers.get(watchKey);
+        if (watcher) {
+            try {
+                watcher.end();
+                logger.info(`✅ 已关闭 watcher: ${watchKey}`);
+            }
+            catch (error) {
+                logger.warn(`⚠️ 关闭 watcher 时出错 (${watchKey}):`, error);
+            }
+            this.watchers.delete(watchKey);
+        }
+    }
+    /**
+     * 创建配置监听器
+     */
+    createWatcher(pathPrefix, key) {
+        const watchKey = `${pathPrefix}:${key}`;
+        // 双重检查，确保不重复创建
+        if (this.watchers.has(watchKey)) {
+            logger.warn(`⚠️ watcher 已存在，跳过创建: ${watchKey}`);
+            return;
+        }
+        try {
+            logger.info(`🔍 创建watcher: ${watchKey} -> 监听路径: ${pathPrefix}`);
+            const watcher = this.consul.watch({
+                method: this.consul.kv.get,
+                options: {
+                    key: pathPrefix,
+                    recurse: true,
+                },
+            });
+            // 先注册到 watchers，防止重复创建
+            this.watchers.set(watchKey, watcher);
+            watcher.on('change', async (_data) => {
+                try {
+                    // logger.info(`🔄 配置变更检测: ${watchKey}`);
+                    // 更新缓存
+                    await this.fetchKeysForPrefix(pathPrefix);
+                    // 通知订阅者
+                    const cache = this.pathCaches.get(pathPrefix) || {};
+                    const value = this.getNestedValue(cache, key);
+                    // logger.info(`📢 通知订阅者: ${watchKey}, 新值:`, value);
+                    const callbacks = this.callbacks.get(watchKey) ?? [];
+                    callbacks.forEach(callback => callback(value));
+                }
+                catch (error) {
+                    logger.error('处理配置变更失败:', error);
+                }
+            });
+            watcher.on('error', (error) => {
+                logger.error(`Consul watch错误 (${watchKey}):`, error);
+                // 清理当前 watcher
+                this.watchers.delete(watchKey);
+                // 检查是否是限流错误
+                const isRateLimited = error.message.includes('too many requests');
+                if (isRateLimited) {
+                    logger.warn(`⚠️ Consul 限流，暂停重新创建 watcher: ${watchKey}`);
+                    return; // 不重新创建，避免进一步限流
+                }
+                // 标记为正在重新创建
+                this.recreatingWatchers.add(watchKey);
+                setTimeout(() => {
+                    this.recreatingWatchers.delete(watchKey);
+                    // 只有在还有回调的情况下才重新创建
+                    if (this.callbacks.has(watchKey) && this.callbacks.get(watchKey)?.length) {
+                        logger.info(`🔄 重新创建 watcher: ${watchKey}`);
+                        this.createWatcher(pathPrefix, key);
+                    }
+                }, 10000); // 增加到10秒，避免频繁重试
+            });
+            logger.info(`✅ watcher 创建成功: ${watchKey}`);
+        }
+        catch (error) {
+            logger.error(`创建watcher失败 (${watchKey}):`, error);
+            // 如果创建失败，从 watchers 中移除
+            this.watchers.delete(watchKey);
+        }
+    }
+    /**
+     * 清理资源
+     */
+    dispose() {
+        logger.info('🧹 开始清理所有资源...');
+        // 清理重新创建标记
+        this.recreatingWatchers.clear();
+        // 关闭所有watchers
+        this.watchers.forEach((watcher, watchKey) => {
+            try {
+                watcher.end();
+                logger.info(`✅ 已关闭 watcher: ${watchKey}`);
+            }
+            catch (error) {
+                logger.warn(`⚠️ 关闭 watcher 时出错 (${watchKey}):`, error);
+            }
+        });
+        this.watchers.clear();
+        this.callbacks.clear();
+        this.pathCaches.clear();
+        logger.info('🧹 已清理所有资源');
+    }
+};
+ConsulConfigSource = __decorate([
+    injectable(),
+    __metadata("design:paramtypes", [Object])
+], ConsulConfigSource);
+export { ConsulConfigSource };
+//# sourceMappingURL=consul-config-source.js.map