@danqiusheng/nest-nacos 1.0.0 → 1.2.0

package/dist/index.d.ts

@@ -11,4 +11,5 @@ export * from './nacos-naming.service';
 export * from './nacos-config.service';
 export * from './nacos.decorators';
 export * from './nacos.health';
+export * from './nacos.utils';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -27,4 +27,5 @@ __exportStar(require("./nacos-naming.service"), exports);
 __exportStar(require("./nacos-config.service"), exports);
 __exportStar(require("./nacos.decorators"), exports);
 __exportStar(require("./nacos.health"), exports);
+__exportStar(require("./nacos.utils"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;GAIG;AACH,oDAAkC;AAClC,qDAAmC;AACnC,iDAA+B;AAC/B,oDAAkC;AAClC,yDAAuC;AACvC,yDAAuC;AACvC,qDAAmC;AACnC,iDAA+B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;GAIG;AACH,oDAAkC;AAClC,qDAAmC;AACnC,iDAA+B;AAC/B,oDAAkC;AAClC,yDAAuC;AACvC,yDAAuC;AACvC,qDAAmC;AACnC,iDAA+B;AAC/B,gDAA8B"}

package/dist/nacos-config.service.d.ts

@@ -1,62 +1,42 @@
-/**
- * NestJS Nacos 插件 - Config 服务（配置中心）
- *
- * 封装 NacosConfigClient，负责：
- * - 配置读取与发布
- * - 配置变更订阅（服务端推送）
- * - 本地配置缓存（支持热更新）
- */
 import { OnModuleDestroy, OnModuleInit } from '@nestjs/common';
 import { NacosConfigClient } from 'nacos';
-import { NacosModuleOptions } from './nacos.interfaces';
+import { NacosConfigDescriptor, NacosConfigFormat, NacosConfigState, NacosModuleOptions } from './nacos.interfaces';
+type ConfigListener = (content: string, parsed?: unknown) => void;
 export declare class NacosConfigService implements OnModuleInit, OnModuleDestroy {
     private readonly client;
     private readonly options;
     private readonly logger;
-    /** 配置缓存：key = `${dataId}@@${group}` */
     private readonly cache;
-    /** 订阅回调集合：key = `${dataId}@@${group}` */
+    private readonly parsedCache;
     private readonly listeners;
+    private readonly sdkListeners;
+    private readonly states;
     constructor(client: NacosConfigClient | null, options: NacosModuleOptions | null);
-    /** 模块初始化：等待客户端就绪 + 预加载订阅配置 */
     onModuleInit(): Promise<void>;
     onModuleDestroy(): Promise<void>;
-    /**
-     * 获取配置内容
-     * @param dataId 配置 ID
-     * @param group 分组名，默认 'DEFAULT_GROUP'
-     * @returns 配置内容字符串
-     */
+    preload(descriptors: NacosConfigDescriptor[]): Promise<void>;
     getConfig(dataId: string, group?: string): Promise<string>;
-    /**
-     * 获取配置并解析为 JSON 对象
-     */
-    getConfigAsJson<T = any>(dataId: string, group?: string): Promise<T>;
-    /**
-     * 发布配置
-     * @param dataId 配置 ID
-     * @param group 分组名
-     * @param content 配置内容
-     */
+    getParsedConfig<T = unknown>(dataId: string, group?: string, format?: NacosConfigFormat): Promise<T>;
+    getConfigAsJson<T = unknown>(dataId: string, group?: string): Promise<T>;
+    getMergedConfig<T = Record<string, unknown>>(descriptors?: NacosConfigDescriptor[]): Promise<T>;
     publish(dataId: string, group: string, content: string): Promise<boolean>;
-    /**
-     * 删除配置
-     */
     remove(dataId: string, group: string): Promise<boolean>;
-    /**
-     * 订阅配置变更（服务端推送）
-     * @param dataId 配置 ID
-     * @param group 分组名
-     * @param listener 回调函数，参数为新配置内容
-     */
-    subscribe(dataId: string, group: string, listener: (content: string) => void): void;
-    /**
-     * 取消订阅
-     */
-    unSubscribe(dataId: string, group: string, listener?: (content: string) => void): void;
-    /** 获取原始客户端 */
+    subscribe(dataId: string, group: string, listener: ConfigListener): void;
+    unSubscribe(dataId: string, group: string, listener?: ConfigListener): void;
+    getLoadedConfigs(): NacosConfigState[];
     getRawClient(): NacosConfigClient | null;
-    /** 内部方法：加载配置并建立订阅 */
-    private loadAndSubscribe;
+    private loadDescriptor;
+    private ensureSdkSubscription;
+    private acceptContent;
+    private loadFallback;
+    private writeFallback;
+    private cachePath;
+    private normalizeDescriptor;
+    private parse;
+    private key;
+    private splitKey;
+    private errorMessage;
+    private removeThroughSdk;
 }
+export {};
 //# sourceMappingURL=nacos-config.service.d.ts.map

package/dist/nacos-config.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nacos-config.service.d.ts","sourceRoot":"","sources":["../src/nacos-config.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAA8B,eAAe,EAAE,YAAY,EAAY,MAAM,gBAAgB,CAAC;AACrG,OAAO,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,qBACa,kBAAmB,YAAW,YAAY,EAAE,eAAe;IAQ3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAR7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,uCAAuC;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IACnD,yCAAyC;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqD;gBAGnB,MAAM,EAAE,iBAAiB,GAAG,IAAI,EACtC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAGxF,8BAA8B;IACxB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAe7B,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtC;;;;;OAKG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAWzE;;OAEG;IACG,eAAe,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,SAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAUnF;;;;;OAKG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS/E;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS7D;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAiBnF;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAYtF,cAAc;IACd,YAAY,IAAI,iBAAiB,GAAG,IAAI;IAIxC,qBAAqB;YACP,gBAAgB;CAY/B"}
+{"version":3,"file":"nacos-config.service.d.ts","sourceRoot":"","sources":["../src/nacos-config.service.ts"],"names":[],"mappings":"AAGA,OAAO,EAA8B,eAAe,EAAE,YAAY,EAAY,MAAM,gBAAgB,CAAC;AACrG,OAAO,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAG5B,KAAK,cAAc,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAElE,qBACa,kBAAmB,YAAW,YAAY,EAAE,eAAe;IAS3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAT7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8B;IAC1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;IACpE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgD;IAC7E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;gBAGF,MAAM,EAAE,iBAAiB,GAAG,IAAI,EACtC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAGlF,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAW7B,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAWhC,OAAO,CAAC,WAAW,EAAE,qBAAqB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5D,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAYnE,eAAe,CAAC,CAAC,GAAG,OAAO,EAC/B,MAAM,EAAE,MAAM,EACd,KAAK,SAAkB,EACvB,MAAM,GAAE,iBAA0B,GACjC,OAAO,CAAC,CAAC,CAAC;IASP,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,SAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAIjF,eAAe,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/C,WAAW,GAAE,qBAAqB,EAAyC,GAC1E,OAAO,CAAC,CAAC,CAAC;IAcP,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAczE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAe7D,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI;IAYxE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,IAAI;IAc3E,gBAAgB,IAAI,gBAAgB,EAAE;IAItC,YAAY,IAAI,iBAAiB,GAAG,IAAI;YAI1B,cAAc;IA0B5B,OAAO,CAAC,qBAAqB;YA2Bf,aAAa;YA0Bb,YAAY;YAcZ,aAAa;IAO3B,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,KAAK;IAQb,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,YAAY;YAIN,gBAAgB;CAmC/B"}

package/dist/nacos-config.service.js

@@ -14,157 +14,296 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 var NacosConfigService_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NacosConfigService = void 0;
-/**
- * NestJS Nacos 插件 - Config 服务（配置中心）
- *
- * 封装 NacosConfigClient，负责：
- * - 配置读取与发布
- * - 配置变更订阅（服务端推送）
- * - 本地配置缓存（支持热更新）
- */
+const crypto_1 = require("crypto");
+const fs_1 = require("fs");
+const path_1 = require("path");
 const common_1 = require("@nestjs/common");
 const nacos_constants_1 = require("./nacos.constants");
+const nacos_utils_1 = require("./nacos.utils");
 let NacosConfigService = NacosConfigService_1 = class NacosConfigService {
     constructor(client, options) {
         this.client = client;
         this.options = options;
         this.logger = new common_1.Logger(NacosConfigService_1.name);
-        /** 配置缓存：key = `${dataId}@@${group}` */
         this.cache = new Map();
-        /** 订阅回调集合：key = `${dataId}@@${group}` */
+        this.parsedCache = new Map();
         this.listeners = new Map();
+        this.sdkListeners = new Map();
+        this.states = new Map();
     }
-    /** 模块初始化：等待客户端就绪 + 预加载订阅配置 */
     async onModuleInit() {
         if (!this.client) {
-            this.logger.warn('NacosConfigClient 未初始化，Config 功能跳过');
+            if ((this.options?.subscribeConfigs?.length ?? 0) > 0) {
+                await this.preload(this.options.subscribeConfigs);
+            }
             return;
         }
-        await this.client.ready();
-        this.logger.log('NacosConfigClient 已就绪');
-        // 预加载并订阅配置项
-        const configs = this.options?.subscribeConfigs ?? [];
-        for (const { dataId, group } of configs) {
-            await this.loadAndSubscribe(dataId, group);
-        }
+        await (0, nacos_utils_1.withRetry)(() => this.client.ready(), this.options?.configLoading?.retry ?? this.options?.retry);
+        await this.preload(this.options?.subscribeConfigs ?? []);
     }
     async onModuleDestroy() {
         if (!this.client)
             return;
-        this.logger.log('NacosConfigClient 已关闭');
-    }
-    /**
-     * 获取配置内容
-     * @param dataId 配置 ID
-     * @param group 分组名，默认 'DEFAULT_GROUP'
-     * @returns 配置内容字符串
-     */
+        for (const [key, wrapper] of this.sdkListeners) {
+            const { dataId, group } = this.splitKey(key);
+            this.client.unSubscribe({ dataId, group }, wrapper);
+        }
+        this.sdkListeners.clear();
+        this.listeners.clear();
+        await Promise.resolve(this.client.close());
+    }
+    async preload(descriptors) {
+        for (const descriptor of descriptors) {
+            await this.loadDescriptor(this.normalizeDescriptor(descriptor));
+        }
+    }
     async getConfig(dataId, group = 'DEFAULT_GROUP') {
-        if (!this.client)
-            throw new Error('NacosConfigClient 未初始化');
-        const key = `${dataId}@@${group}`;
-        if (this.cache.has(key)) {
+        const key = this.key(dataId, group);
+        if (this.cache.has(key))
             return this.cache.get(key);
-        }
-        const content = await this.client.getConfig(dataId, group);
+        if (!this.client)
+            throw new Error('NacosConfigClient is not initialized');
+        const content = await (0, nacos_utils_1.withRetry)(() => this.client.getConfig(dataId, group), this.options?.configLoading?.retry ?? this.options?.retry);
         this.cache.set(key, content);
         return content;
     }
-    /**
-     * 获取配置并解析为 JSON 对象
-     */
-    async getConfigAsJson(dataId, group = 'DEFAULT_GROUP') {
+    async getParsedConfig(dataId, group = 'DEFAULT_GROUP', format = 'auto') {
+        const key = this.key(dataId, group);
+        if (this.parsedCache.has(key))
+            return this.parsedCache.get(key);
         const content = await this.getConfig(dataId, group);
-        try {
-            return JSON.parse(content);
-        }
-        catch {
-            this.logger.warn(`配置 ${dataId} 不是合法 JSON，返回原始字符串`);
-            return content;
+        const parsed = this.parse(content, format, dataId);
+        this.parsedCache.set(key, parsed);
+        return parsed;
+    }
+    async getConfigAsJson(dataId, group = 'DEFAULT_GROUP') {
+        return this.getParsedConfig(dataId, group, 'json');
+    }
+    async getMergedConfig(descriptors = this.options?.subscribeConfigs ?? []) {
+        let merged = {};
+        for (const input of descriptors) {
+            const descriptor = this.normalizeDescriptor(input);
+            const value = await this.getParsedConfig(descriptor.dataId, descriptor.group, descriptor.format);
+            merged = (0, nacos_utils_1.mergeConfigValues)(merged, value);
         }
+        return merged;
     }
-    /**
-     * 发布配置
-     * @param dataId 配置 ID
-     * @param group 分组名
-     * @param content 配置内容
-     */
     async publish(dataId, group, content) {
         if (!this.client)
-            throw new Error('NacosConfigClient 未初始化');
-        const result = await this.client.publishSingle(dataId, group, content);
-        const key = `${dataId}@@${group}`;
-        this.cache.set(key, content);
-        this.logger.log(`已发布配置: ${dataId} (${group})`);
+            throw new Error('NacosConfigClient is not initialized');
+        const result = await (0, nacos_utils_1.withRetry)(() => this.client.publishSingle(dataId, group, content), this.options?.retry);
+        if (result) {
+            const key = this.key(dataId, group);
+            this.cache.set(key, content);
+            this.parsedCache.delete(key);
+        }
         return result;
     }
-    /**
-     * 删除配置
-     */
     async remove(dataId, group) {
         if (!this.client)
-            throw new Error('NacosConfigClient 未初始化');
-        const result = await this.client.remove(dataId, group);
-        const key = `${dataId}@@${group}`;
-        this.cache.delete(key);
-        this.logger.log(`已删除配置: ${dataId} (${group})`);
+            throw new Error('NacosConfigClient is not initialized');
+        const result = await (0, nacos_utils_1.withRetry)(() => this.removeThroughSdk(dataId, group), this.options?.retry);
+        if (result) {
+            const key = this.key(dataId, group);
+            this.cache.delete(key);
+            this.parsedCache.delete(key);
+            this.states.delete(key);
+        }
         return result;
     }
-    /**
-     * 订阅配置变更（服务端推送）
-     * @param dataId 配置 ID
-     * @param group 分组名
-     * @param listener 回调函数，参数为新配置内容
-     */
     subscribe(dataId, group, listener) {
         if (!this.client)
-            throw new Error('NacosConfigClient 未初始化');
-        const key = `${dataId}@@${group}`;
-        // 内部包装：更新缓存 + 通知所有监听者
-        const wrapper = (content) => {
-            this.cache.set(key, content);
-            this.listeners.get(key)?.forEach((fn) => fn(content));
-        };
-        this.client.subscribe({ dataId, group }, wrapper);
-        if (!this.listeners.has(key)) {
-            this.listeners.set(key, new Set());
+            throw new Error('NacosConfigClient is not initialized');
+        const key = this.key(dataId, group);
+        let callbacks = this.listeners.get(key);
+        if (!callbacks) {
+            callbacks = new Set();
+            this.listeners.set(key, callbacks);
         }
-        this.listeners.get(key).add(listener);
-        this.logger.log(`已订阅配置: ${dataId} (${group})`);
+        callbacks.add(listener);
+        this.ensureSdkSubscription(dataId, group);
     }
-    /**
-     * 取消订阅
-     */
     unSubscribe(dataId, group, listener) {
         if (!this.client)
-            throw new Error('NacosConfigClient 未初始化');
-        const key = `${dataId}@@${group}`;
-        // SDK 要求 listener 必填，此处兼容可选参数
-        this.client.unSubscribe({ dataId, group }, (listener ?? (() => undefined)));
-        if (listener) {
-            this.listeners.get(key)?.delete(listener);
-        }
-        else {
+            throw new Error('NacosConfigClient is not initialized');
+        const key = this.key(dataId, group);
+        const callbacks = this.listeners.get(key);
+        if (listener)
+            callbacks?.delete(listener);
+        else
+            callbacks?.clear();
+        if (!callbacks || callbacks.size === 0) {
+            const wrapper = this.sdkListeners.get(key);
+            if (wrapper)
+                this.client.unSubscribe({ dataId, group }, wrapper);
             this.listeners.delete(key);
+            this.sdkListeners.delete(key);
         }
     }
-    /** 获取原始客户端 */
+    getLoadedConfigs() {
+        return Array.from(this.states.values()).map((state) => ({ ...state }));
+    }
     getRawClient() {
         return this.client;
     }
-    /** 内部方法：加载配置并建立订阅 */
-    async loadAndSubscribe(dataId, group) {
+    async loadDescriptor(descriptor) {
+        const mode = this.options?.configLoading?.failureMode ?? 'throw';
+        try {
+            if (!this.client)
+                throw new Error('NacosConfigClient is not initialized');
+            const content = await (0, nacos_utils_1.withRetry)(() => this.client.getConfig(descriptor.dataId, descriptor.group), this.options?.configLoading?.retry ?? this.options?.retry);
+            await this.acceptContent(descriptor, content, 'nacos', true);
+        }
+        catch (error) {
+            let loadedFallback = false;
+            if (mode === 'fallback') {
+                loadedFallback = await this.loadFallback(descriptor);
+            }
+            if (!loadedFallback && descriptor.required && mode !== 'continue') {
+                throw new Error(`Failed to preload Nacos config ${descriptor.dataId} (${descriptor.group}): ${this.errorMessage(error)}`);
+            }
+            if (!loadedFallback) {
+                this.logger.warn(`Skipped config ${descriptor.dataId} (${descriptor.group}): ${this.errorMessage(error)}`);
+            }
+        }
+        if (descriptor.subscribe && this.client)
+            this.ensureSdkSubscription(descriptor.dataId, descriptor.group);
+    }
+    ensureSdkSubscription(dataId, group) {
+        if (!this.client)
+            return;
+        const key = this.key(dataId, group);
+        if (this.sdkListeners.has(key))
+            return;
+        const descriptor = this.normalizeDescriptor(this.options?.subscribeConfigs?.find((item) => item.dataId === dataId && (item.group ?? 'DEFAULT_GROUP') === group) ?? { dataId, group });
+        const wrapper = (content) => {
+            void this.acceptContent(descriptor, content, 'nacos', true)
+                .then(() => {
+                const parsed = this.parsedCache.get(key);
+                for (const callback of this.listeners.get(key) ?? []) {
+                    try {
+                        callback(content, parsed);
+                    }
+                    catch (error) {
+                        this.logger.error(`Config listener failed for ${dataId} (${group})`, error);
+                    }
+                }
+            })
+                .catch((error) => this.logger.error(`Config update rejected for ${dataId} (${group})`, error));
+        };
+        this.sdkListeners.set(key, wrapper);
+        this.client.subscribe({ dataId, group }, wrapper);
+    }
+    async acceptContent(descriptor, content, source, persist) {
+        const key = this.key(descriptor.dataId, descriptor.group);
+        const parsed = this.parse(content, descriptor.format, descriptor.dataId);
+        this.cache.set(key, content);
+        this.parsedCache.set(key, parsed);
+        this.states.set(key, {
+            dataId: descriptor.dataId,
+            group: descriptor.group,
+            format: (0, nacos_utils_1.resolveConfigFormat)(descriptor.dataId, descriptor.format),
+            source,
+            updatedAt: new Date().toISOString(),
+        });
+        if (persist && this.cachePath(descriptor)) {
+            try {
+                await this.writeFallback(this.cachePath(descriptor), content);
+            }
+            catch (error) {
+                this.logger.warn(`Failed to write config cache for ${descriptor.dataId}: ${this.errorMessage(error)}`);
+            }
+        }
+    }
+    async loadFallback(descriptor) {
+        const path = this.cachePath(descriptor);
+        if (!path)
+            return false;
+        try {
+            const content = await fs_1.promises.readFile(path, 'utf8');
+            await this.acceptContent(descriptor, content, 'fallback', false);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async writeFallback(path, content) {
+        await fs_1.promises.mkdir((0, path_1.dirname)(path), { recursive: true });
+        const temporary = `${path}.${process.pid}.${Date.now()}.tmp`;
+        await fs_1.promises.writeFile(temporary, content, 'utf8');
+        await fs_1.promises.rename(temporary, path);
+    }
+    cachePath(descriptor) {
+        if (descriptor.cachePath)
+            return (0, path_1.resolve)(descriptor.cachePath);
+        const cacheDir = this.options?.configLoading?.cacheDir;
+        if (!cacheDir)
+            return undefined;
+        const digest = (0, crypto_1.createHash)('sha256')
+            .update(`${descriptor.dataId}@@${descriptor.group ?? 'DEFAULT_GROUP'}`)
+            .digest('hex')
+            .slice(0, 16);
+        return (0, path_1.join)((0, path_1.resolve)(cacheDir), `${digest}.cache`);
+    }
+    normalizeDescriptor(descriptor) {
+        return {
+            dataId: descriptor.dataId,
+            group: descriptor.group ?? 'DEFAULT_GROUP',
+            format: descriptor.format ?? 'auto',
+            subscribe: descriptor.subscribe ?? true,
+            required: descriptor.required ?? true,
+            cachePath: descriptor.cachePath,
+        };
+    }
+    parse(content, format, dataId) {
         try {
-            const content = await this.getConfig(dataId, group);
-            this.logger.log(`已加载配置: ${dataId} (${group})`);
-            this.subscribe(dataId, group, (newContent) => {
-                this.logger.log(`配置已更新: ${dataId} (${group})`);
-            });
-            void content;
+            return (0, nacos_utils_1.parseConfigContent)(content, format, dataId);
+        }
+        catch (error) {
+            throw new Error(`Invalid ${(0, nacos_utils_1.resolveConfigFormat)(dataId, format)} config ${dataId}: ${this.errorMessage(error)}`);
         }
-        catch (err) {
-            this.logger.error(`加载配置失败: ${dataId} (${group})`, err);
+    }
+    key(dataId, group) {
+        return `${dataId}@@${group}`;
+    }
+    splitKey(key) {
+        const separator = key.lastIndexOf('@@');
+        return { dataId: key.slice(0, separator), group: key.slice(separator + 2) };
+    }
+    errorMessage(error) {
+        return error instanceof Error ? error.message : String(error);
+    }
+    async removeThroughSdk(dataId, group) {
+        // nacos@2.6.x sends `tenant=public` when removing the public namespace,
+        // although publish/get use the empty namespace. Use the official
+        // nacos-config DataClient directly for this one operation so the request
+        // omits tenant entirely and does not depend on cluster-client's 7777
+        // leader/follower state.
+        const isPublic = !this.options?.config?.namespace || this.options.config.namespace === 'public';
+        if (isPublic) {
+            if (this.client.options) {
+                const { DataClient } = require('nacos-config');
+                const config = this.options?.config;
+                const directClient = new DataClient({
+                    serverAddr: config?.serverAddr,
+                    namespace: undefined,
+                    username: config?.username,
+                    password: config?.password,
+                    ssl: config?.ssl,
+                    accessKey: config?.accessKey,
+                    secretKey: config?.secretKey,
+                    signatureRegionId: config?.signatureRegionId,
+                });
+                try {
+                    return await directClient.remove(dataId, group);
+                }
+                finally {
+                    directClient.close();
+                }
+            }
         }
+        return this.client.remove(dataId, group);
     }
 };
 exports.NacosConfigService = NacosConfigService;

package/dist/nacos-config.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"nacos-config.service.js","sourceRoot":"","sources":["../src/nacos-config.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"nacos-config.service.js","sourceRoot":"","sources":["../src/nacos-config.service.ts"],"names":[],"mappings":"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"}

package/dist/nacos-naming.service.d.ts

@@ -1,68 +1,38 @@
-/**
- * NestJS Nacos 插件 - Naming 服务（服务发现/注册）
- *
- * 封装 NacosNamingClient，负责：
- * - 客户端生命周期管理（初始化 / 关闭）
- * - 服务实例自动注册与注销
- * - 服务订阅与实例查询
- */
 import { OnModuleDestroy, OnModuleInit } from '@nestjs/common';
 import { NacosNamingClient } from 'nacos';
-import { NacosInstanceOptions, NacosModuleOptions } from './nacos.interfaces';
+import { NacosInstanceOptions, NacosInstanceSelectionOptions, NacosModuleOptions, NacosServiceInstance } from './nacos.interfaces';
 export declare class NacosNamingService implements OnModuleInit, OnModuleDestroy {
     private readonly client;
     private readonly options;
     private readonly logger;
-    /** 已注册的实例配置（用于模块销毁时注销） */
-    private registeredInstances;
+    private readonly registeredInstances;
+    private readonly subscriptions;
+    private readonly roundRobinIndexes;
     constructor(client: NacosNamingClient | null, options: NacosModuleOptions | null);
-    /** 模块初始化：等待客户端就绪 + 自动注册实例 */
     onModuleInit(): Promise<void>;
-    /** 模块销毁：注销所有已注册实例 + 关闭客户端 */
     onModuleDestroy(): Promise<void>;
-    /**
-     * 注册服务实例
-     * @param inst 实例配置
-     */
-    register(inst: NacosInstanceOptions): Promise<void>;
-    /**
-     * 注销服务实例
-     * @param inst 实例配置
-     */
-    deregister(inst: NacosInstanceOptions): Promise<void>;
-    /**
-     * 查询服务的所有实例
-     * @param serviceName 服务名
-     * @param groupName 分组名
-     * @param clusters 集群名
-     * @param subscribe 是否订阅，默认 true
-     */
-    getAllInstances(serviceName: string, groupName?: string, clusters?: string, subscribe?: boolean): Promise<import("nacos-naming").Hosts>;
-    /**
-     * 查询健康实例
-     */
-    selectInstances(serviceName: string, groupName?: string, clusters?: string, healthy?: boolean, subscribe?: boolean): Promise<import("nacos-naming").Hosts>;
-    /**
-     * 订阅服务实例变更（服务端推送）
-     * @param info 服务信息，字符串为 serviceName，对象为 { serviceName, groupName, clusters }
-     * @param listener 回调函数，参数为实例列表
-     */
+    register(instance: NacosInstanceOptions): Promise<void>;
+    deregister(instance: NacosInstanceOptions): Promise<void>;
+    updateWeight(instance: NacosInstanceOptions, weight: number): Promise<void>;
+    getAllInstances(serviceName: string, groupName?: string, clusters?: string, subscribe?: boolean): Promise<NacosServiceInstance[]>;
+    selectInstances(serviceName: string, groupName?: string, clusters?: string, healthy?: boolean, subscribe?: boolean): Promise<NacosServiceInstance[]>;
+    selectInstance(serviceName: string, selection?: NacosInstanceSelectionOptions): Promise<NacosServiceInstance>;
     subscribe(info: string | {
         serviceName: string;
         groupName?: string;
         clusters?: string;
     }, listener: (hosts: any[]) => void): void;
-    /**
-     * 取消订阅
-     */
     unSubscribe(info: string | {
         serviceName: string;
         groupName?: string;
         clusters?: string;
     }, listener?: (hosts: any[]) => void): void;
-    /** 获取 Nacos 服务端状态：'UP' 或 'DOWN' */
-    getServerStatus(): string;
-    /** 获取原始客户端（需要使用高级 API 时） */
+    getServerStatus(): Promise<'UP' | 'DOWN'>;
+    getRegisteredInstances(): NacosInstanceOptions[];
     getRawClient(): NacosNamingClient | null;
+    private weighted;
+    private matchesMetadata;
+    private sameInstance;
+    private subscriptionKey;
 }
 //# sourceMappingURL=nacos-naming.service.d.ts.map