@danqiusheng/nest-nacos 1.0.0 → 1.2.0

package/dist/nacos.module.d.ts

@@ -1,16 +1,7 @@
-/**
- * NestJS Nacos 插件 - 动态模块定义
- *
- * 用法：
- *   同步：NacosModule.forRoot({ naming: {...}, config: {...} })
- *   异步：NacosModule.forRootAsync({ imports, useFactory, inject })
- */
 import { DynamicModule } from '@nestjs/common';
-import { NacosModuleAsyncOptions, NacosModuleOptions } from './nacos.interfaces';
+import { NacosModuleAsyncOptions, NacosModuleOptionsInput } from './nacos.interfaces';
 export declare class NacosModule {
-    /** 同步注册 */
-    static forRoot(options: NacosModuleOptions): DynamicModule;
-    /** 异步注册（配合 @nestjs/config、环境变量等使用） */
+    static forRoot(options: NacosModuleOptionsInput): DynamicModule;
     static forRootAsync(options: NacosModuleAsyncOptions): DynamicModule;
     private static createAsyncOptionsProvider;
 }

package/dist/nacos.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nacos.module.d.ts","sourceRoot":"","sources":["../src/nacos.module.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,aAAa,EAAoB,MAAM,gBAAgB,CAAC;AAEjE,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAEnB,MAAM,oBAAoB,CAAC;AAM5B,qBACa,WAAW;IACtB,WAAW;IACX,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa;IAe1D,sCAAsC;IACtC,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,uBAAuB,GAAG,aAAa;IAiBpE,OAAO,CAAC,MAAM,CAAC,0BAA0B;CAmB1C"}
+{"version":3,"file":"nacos.module.d.ts","sourceRoot":"","sources":["../src/nacos.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAoB,MAAM,gBAAgB,CAAC;AAEjE,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EAExB,MAAM,oBAAoB,CAAC;AAc5B,qBACa,WAAW;IACtB,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,uBAAuB,GAAG,aAAa;IAe/D,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,uBAAuB,GAAG,aAAa;IAoBpE,OAAO,CAAC,MAAM,CAAC,0BAA0B;CAoB1C"}

package/dist/nacos.module.js

@@ -8,66 +8,69 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var NacosModule_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NacosModule = void 0;
-/**
- * NestJS Nacos 插件 - 动态模块定义
- *
- * 用法：
- *   同步：NacosModule.forRoot({ naming: {...}, config: {...} })
- *   异步：NacosModule.forRootAsync({ imports, useFactory, inject })
- */
 const common_1 = require("@nestjs/common");
 const nacos_constants_1 = require("./nacos.constants");
 const nacos_providers_1 = require("./nacos.providers");
 const nacos_naming_service_1 = require("./nacos-naming.service");
 const nacos_config_service_1 = require("./nacos-config.service");
 const nacos_health_1 = require("./nacos.health");
+const exportedProviders = [
+    nacos_constants_1.NACOS_NAMING_CLIENT,
+    nacos_constants_1.NACOS_CONFIG_CLIENT,
+    nacos_naming_service_1.NacosNamingService,
+    nacos_config_service_1.NacosConfigService,
+    nacos_health_1.NacosHealthIndicator,
+];
 let NacosModule = NacosModule_1 = class NacosModule {
-    /** 同步注册 */
     static forRoot(options) {
         return {
             module: NacosModule_1,
             global: true,
             providers: [
-                { provide: nacos_constants_1.NACOS_OPTIONS, useValue: options },
+                { provide: nacos_constants_1.NACOS_OPTIONS, useValue: (0, nacos_providers_1.normalizeNacosOptions)(options) },
                 ...nacos_providers_1.nacosClientProviders,
                 nacos_naming_service_1.NacosNamingService,
                 nacos_config_service_1.NacosConfigService,
                 nacos_health_1.NacosHealthIndicator,
             ],
-            exports: [nacos_naming_service_1.NacosNamingService, nacos_config_service_1.NacosConfigService, nacos_health_1.NacosHealthIndicator],
+            exports: exportedProviders,
         };
     }
-    /** 异步注册（配合 @nestjs/config、环境变量等使用） */
     static forRootAsync(options) {
-        const asyncOptionsProvider = this.createAsyncOptionsProvider(options);
+        const classProviders = options.useClass
+            ? [{ provide: options.useClass, useClass: options.useClass }]
+            : [];
         return {
             module: NacosModule_1,
             global: true,
             imports: options.imports,
             providers: [
-                asyncOptionsProvider,
+                ...classProviders,
+                this.createAsyncOptionsProvider(options),
                 ...nacos_providers_1.nacosClientProviders,
                 nacos_naming_service_1.NacosNamingService,
                 nacos_config_service_1.NacosConfigService,
                 nacos_health_1.NacosHealthIndicator,
             ],
-            exports: [nacos_naming_service_1.NacosNamingService, nacos_config_service_1.NacosConfigService, nacos_health_1.NacosHealthIndicator],
+            exports: exportedProviders,
         };
     }
     static createAsyncOptionsProvider(options) {
-        // 方式一：useFactory
         if (options.useFactory) {
             return {
                 provide: nacos_constants_1.NACOS_OPTIONS,
-                useFactory: options.useFactory,
+                useFactory: async (...args) => (0, nacos_providers_1.normalizeNacosOptions)(await options.useFactory(...args)),
                 inject: options.inject ?? [],
             };
         }
-        // 方式二：useClass / useExisting
+        const factoryToken = options.useExisting ?? options.useClass;
+        if (!factoryToken) {
+            throw new Error('forRootAsync requires useFactory, useClass, or useExisting');
+        }
         return {
             provide: nacos_constants_1.NACOS_OPTIONS,
-            useFactory: async (factory) => factory.createNacosOptions(),
-            inject: [options.useExisting ?? options.useClass],
+            useFactory: async (factory) => (0, nacos_providers_1.normalizeNacosOptions)(await factory.createNacosOptions()),
+            inject: [factoryToken],
         };
     }
 };

package/dist/nacos.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"nacos.module.js","sourceRoot":"","sources":["../src/nacos.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA;;;;;;GAMG;AACH,2CAAiE;AACjE,uDAAkD;AAMlD,uDAAyD;AACzD,iEAA4D;AAC5D,iEAA4D;AAC5D,iDAAsD;AAG/C,IAAM,WAAW,mBAAjB,MAAM,WAAW;IACtB,WAAW;IACX,MAAM,CAAC,OAAO,CAAC,OAA2B;QACxC,OAAO;YACL,MAAM,EAAE,aAAW;YACnB,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE;gBACT,EAAE,OAAO,EAAE,+BAAa,EAAE,QAAQ,EAAE,OAAO,EAAE;gBAC7C,GAAG,sCAAoB;gBACvB,yCAAkB;gBAClB,yCAAkB;gBAClB,mCAAoB;aACrB;YACD,OAAO,EAAE,CAAC,yCAAkB,EAAE,yCAAkB,EAAE,mCAAoB,CAAC;SACxE,CAAC;IACJ,CAAC;IAED,sCAAsC;IACtC,MAAM,CAAC,YAAY,CAAC,OAAgC;QAClD,MAAM,oBAAoB,GAAG,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC;QACtE,OAAO;YACL,MAAM,EAAE,aAAW;YACnB,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS,EAAE;gBACT,oBAAoB;gBACpB,GAAG,sCAAoB;gBACvB,yCAAkB;gBAClB,yCAAkB;gBAClB,mCAAoB;aACrB;YACD,OAAO,EAAE,CAAC,yCAAkB,EAAE,yCAAkB,EAAE,mCAAoB,CAAC;SACxE,CAAC;IACJ,CAAC;IAEO,MAAM,CAAC,0BAA0B,CACvC,OAAgC;QAEhC,iBAAiB;QACjB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,OAAO;gBACL,OAAO,EAAE,+BAAa;gBACtB,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;aAC7B,CAAC;QACJ,CAAC;QACD,6BAA6B;QAC7B,OAAO;YACL,OAAO,EAAE,+BAAa;YACtB,UAAU,EAAE,KAAK,EAAE,OAA4B,EAAE,EAAE,CACjD,OAAO,CAAC,kBAAkB,EAAE;YAC9B,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC;SAClD,CAAC;IACJ,CAAC;CACF,CAAA;AAtDY,kCAAW;sBAAX,WAAW;IADvB,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,WAAW,CAsDvB"}
+{"version":3,"file":"nacos.module.js","sourceRoot":"","sources":["../src/nacos.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAiE;AACjE,uDAA4F;AAM5F,uDAAgF;AAChF,iEAA4D;AAC5D,iEAA4D;AAC5D,iDAAsD;AAEtD,MAAM,iBAAiB,GAAG;IACxB,qCAAmB;IACnB,qCAAmB;IACnB,yCAAkB;IAClB,yCAAkB;IAClB,mCAAoB;CACrB,CAAC;AAGK,IAAM,WAAW,mBAAjB,MAAM,WAAW;IACtB,MAAM,CAAC,OAAO,CAAC,OAAgC;QAC7C,OAAO;YACL,MAAM,EAAE,aAAW;YACnB,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE;gBACT,EAAE,OAAO,EAAE,+BAAa,EAAE,QAAQ,EAAE,IAAA,uCAAqB,EAAC,OAAO,CAAC,EAAE;gBACpE,GAAG,sCAAoB;gBACvB,yCAAkB;gBAClB,yCAAkB;gBAClB,mCAAoB;aACrB;YACD,OAAO,EAAE,iBAAiB;SAC3B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,OAAgC;QAClD,MAAM,cAAc,GAAe,OAAO,CAAC,QAAQ;YACjD,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC7D,CAAC,CAAC,EAAE,CAAC;QACP,OAAO;YACL,MAAM,EAAE,aAAW;YACnB,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS,EAAE;gBACT,GAAG,cAAc;gBACjB,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC;gBACxC,GAAG,sCAAoB;gBACvB,yCAAkB;gBAClB,yCAAkB;gBAClB,mCAAoB;aACrB;YACD,OAAO,EAAE,iBAAiB;SAC3B,CAAC;IACJ,CAAC;IAEO,MAAM,CAAC,0BAA0B,CAAC,OAAgC;QACxE,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,OAAO;gBACL,OAAO,EAAE,+BAAa;gBACtB,UAAU,EAAE,KAAK,EAAE,GAAG,IAAW,EAAE,EAAE,CACnC,IAAA,uCAAqB,EAAC,MAAM,OAAO,CAAC,UAAW,CAAC,GAAG,IAAI,CAAC,CAAC;gBAC3D,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;aAC7B,CAAC;QACJ,CAAC;QACD,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC;QAC7D,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;QACD,OAAO;YACL,OAAO,EAAE,+BAAa;YACtB,UAAU,EAAE,KAAK,EAAE,OAA4B,EAAE,EAAE,CACjD,IAAA,uCAAqB,EAAC,MAAM,OAAO,CAAC,kBAAkB,EAAE,CAAC;YAC3D,MAAM,EAAE,CAAC,YAAY,CAAC;SACvB,CAAC;IACJ,CAAC;CACF,CAAA;AAxDY,kCAAW;sBAAX,WAAW;IADvB,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,WAAW,CAwDvB"}

package/dist/nacos.providers.d.ts

@@ -1,16 +1,9 @@
-/**
- * NestJS Nacos 插件 - Provider 工厂
- *
- * 负责根据模块配置创建 NacosNamingClient / NacosConfigClient 实例。
- * 如果未配置 naming / config，则返回 null（对应服务以 @Optional 注入）。
- */
 import { Provider } from '@nestjs/common';
-import { NacosNamingClient, NacosConfigClient } from 'nacos';
-import { NacosModuleOptions } from './nacos.interfaces';
-/** 创建 Naming 客户端 */
+import { NacosConfigClient, NacosNamingClient } from 'nacos';
+import { NacosModuleOptions, NacosModuleOptionsInput } from './nacos.interfaces';
 export declare function createNamingClient(options: NacosModuleOptions['naming']): NacosNamingClient | null;
-/** 创建 Config 客户端 */
 export declare function createConfigClient(options: NacosModuleOptions['config']): NacosConfigClient | null;
-/** 客户端 Provider 列表 */
+/** Expands the simple shared connection fields into SDK-specific options. */
+export declare function normalizeNacosOptions(input: NacosModuleOptionsInput): NacosModuleOptions;
 export declare const nacosClientProviders: Provider[];
 //# sourceMappingURL=nacos.providers.d.ts.map

package/dist/nacos.providers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nacos.providers.d.ts","sourceRoot":"","sources":["../src/nacos.providers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAU,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAE7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAiBxD,oBAAoB;AACpB,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GAAG,iBAAiB,GAAG,IAAI,CAgBlG;AAED,oBAAoB;AACpB,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GAAG,iBAAiB,GAAG,IAAI,CAelG;AAED,sBAAsB;AACtB,eAAO,MAAM,oBAAoB,EAAE,QAAQ,EAW1C,CAAC"}
+{"version":3,"file":"nacos.providers.d.ts","sourceRoot":"","sources":["../src/nacos.providers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAE7D,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EAExB,MAAM,oBAAoB,CAAC;AAW5B,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GAAG,iBAAiB,GAAG,IAAI,CAclG;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GAAG,iBAAiB,GAAG,IAAI,CAelG;AAED,6EAA6E;AAC7E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,uBAAuB,GAAG,kBAAkB,CAwBxF;AAUD,eAAO,MAAM,oBAAoB,EAAE,QAAQ,EAW1C,CAAC"}

package/dist/nacos.providers.js

@@ -3,21 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.nacosClientProviders = void 0;
 exports.createNamingClient = createNamingClient;
 exports.createConfigClient = createConfigClient;
-/**
- * NestJS Nacos 插件 - Provider 工厂
- *
- * 负责根据模块配置创建 NacosNamingClient / NacosConfigClient 实例。
- * 如果未配置 naming / config，则返回 null（对应服务以 @Optional 注入）。
- */
+exports.normalizeNacosOptions = normalizeNacosOptions;
 const common_1 = require("@nestjs/common");
 const nacos_1 = require("nacos");
 const nacos_constants_1 = require("./nacos.constants");
 const nestLogger = new common_1.Logger('Nacos');
-/**
- * Logger 适配器
- * Nacos SDK 期望 logger 有 info/warn/error/debug 方法，
- * 而 NestJS Logger 使用 log/warn/error/debug，此处做映射。
- */
 const nacosLogger = {
     info: (...args) => nestLogger.log(args.join(' ')),
     warn: (...args) => nestLogger.warn(args.join(' ')),
@@ -25,16 +15,14 @@ const nacosLogger = {
     debug: (...args) => nestLogger.debug(args.join(' ')),
     log: (...args) => nestLogger.log(args.join(' ')),
 };
-/** 创建 Naming 客户端 */
 function createNamingClient(options) {
     if (!options)
         return null;
-    // SDK 运行时支持 transport 选项（gRPC），但类型定义尚未包含，故用 as any
-    const client = new nacos_1.NacosNamingClient({
+    assertSupportedTransport(options.transport);
+    return new nacos_1.NacosNamingClient({
         logger: nacosLogger,
         serverList: options.serverList,
         namespace: options.namespace ?? 'public',
-        transport: options.transport ?? 'grpc',
         username: options.username,
         password: options.password,
         ssl: options.ssl,
@@ -42,17 +30,16 @@ function createNamingClient(options) {
         sk: options.sk,
         appName: options.appName,
     });
-    return client;
 }
-/** 创建 Config 客户端 */
 function createConfigClient(options) {
     if (!options)
         return null;
-    // SDK 运行时支持 transport 选项（gRPC），但类型定义尚未包含，故用 as any
-    const client = new nacos_1.NacosConfigClient({
+    assertSupportedTransport(options.transport);
+    return new nacos_1.NacosConfigClient({
         serverAddr: options.serverAddr,
-        namespace: options.namespace ?? 'public',
-        transport: options.transport ?? 'grpc',
+        // The SDK sends an empty string as `tenant=`. Nacos 2.5.x treats that
+        // differently from an omitted tenant, so public namespace must be omitted.
+        namespace: !options.namespace || options.namespace === 'public' ? undefined : options.namespace,
         username: options.username,
         password: options.password,
         ssl: options.ssl,
@@ -60,9 +47,36 @@ function createConfigClient(options) {
         secretKey: options.secretKey,
         signatureRegionId: options.signatureRegionId,
     });
-    return client;
 }
-/** 客户端 Provider 列表 */
+/** Expands the simple shared connection fields into SDK-specific options. */
+function normalizeNacosOptions(input) {
+    const options = typeof input === 'string'
+        ? { serverAddr: input }
+        : input;
+    const sharedAddress = options.serverAddr;
+    const shared = {
+        namespace: options.namespace,
+        username: options.username,
+        password: options.password,
+        ssl: options.ssl,
+    };
+    const naming = options.naming
+        ? { ...shared, ...options.naming }
+        : sharedAddress
+            ? { ...shared, serverList: sharedAddress }
+            : undefined;
+    const config = options.config
+        ? { ...shared, ...options.config }
+        : sharedAddress
+            ? { ...shared, serverAddr: sharedAddress }
+            : undefined;
+    return { ...options, naming, config };
+}
+function assertSupportedTransport(transport) {
+    if (transport === 'grpc') {
+        throw new Error('transport "grpc" is not supported: nacos@2.6.x only implements the Nacos HTTP OpenAPI');
+    }
+}
 exports.nacosClientProviders = [
     {
         provide: nacos_constants_1.NACOS_NAMING_CLIENT,

package/dist/nacos.providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"nacos.providers.js","sourceRoot":"","sources":["../src/nacos.providers.ts"],"names":[],"mappings":";;;AA2BA,gDAgBC;AAGD,gDAeC;AA7DD;;;;;GAKG;AACH,2CAAkD;AAClD,iCAA6D;AAC7D,uDAA4F;AAG5F,MAAM,UAAU,GAAG,IAAI,eAAM,CAAC,OAAO,CAAC,CAAC;AAEvC;;;;GAIG;AACH,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxD,IAAI,EAAE,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzD,KAAK,EAAE,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3D,KAAK,EAAE,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3D,GAAG,EAAE,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;CACxD,CAAC;AAEF,oBAAoB;AACpB,SAAgB,kBAAkB,CAAC,OAAqC;IACtE,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,mDAAmD;IACnD,MAAM,MAAM,GAAG,IAAI,yBAAiB,CAAC;QACnC,MAAM,EAAE,WAAW;QACnB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,QAAQ;QACxC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM;QACtC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,OAAO,EAAE,OAAO,CAAC,OAAO;KAClB,CAAC,CAAC;IACV,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,oBAAoB;AACpB,SAAgB,kBAAkB,CAAC,OAAqC;IACtE,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,mDAAmD;IACnD,MAAM,MAAM,GAAG,IAAI,yBAAiB,CAAC;QACnC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,QAAQ;QACxC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM;QACtC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;KACtC,CAAC,CAAC;IACV,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,sBAAsB;AACT,QAAA,oBAAoB,GAAe;IAC9C;QACE,OAAO,EAAE,qCAAmB;QAC5B,UAAU,EAAE,CAAC,OAA2B,EAAE,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC;QAChF,MAAM,EAAE,CAAC,+BAAa,CAAC;KACxB;IACD;QACE,OAAO,EAAE,qCAAmB;QAC5B,UAAU,EAAE,CAAC,OAA2B,EAAE,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC;QAChF,MAAM,EAAE,CAAC,+BAAa,CAAC;KACxB;CACF,CAAC"}
+{"version":3,"file":"nacos.providers.js","sourceRoot":"","sources":["../src/nacos.providers.ts"],"names":[],"mappings":"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"}

package/dist/nacos.utils.d.ts

@@ -0,0 +1,6 @@
+import { NacosConfigFormat, NacosRetryOptions } from './nacos.interfaces';
+export declare function resolveConfigFormat(dataId: string, format?: NacosConfigFormat): NacosConfigFormat;
+export declare function parseConfigContent<T = unknown>(content: string, format?: NacosConfigFormat, dataId?: string): T;
+export declare function mergeConfigValues(target: unknown, source: unknown): unknown;
+export declare function withRetry<T>(operation: () => Promise<T>, options?: NacosRetryOptions): Promise<T>;
+//# sourceMappingURL=nacos.utils.d.ts.map

package/dist/nacos.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nacos.utils.d.ts","sourceRoot":"","sources":["../src/nacos.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE1E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,iBAA0B,GAAG,iBAAiB,CAOzG;AAED,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAC5C,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,iBAA0B,EAClC,MAAM,SAAK,GACV,CAAC,CAgBH;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAO3E;AAED,wBAAsB,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,CAAC,CAkBvG"}

package/dist/nacos.utils.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveConfigFormat = resolveConfigFormat;
+exports.parseConfigContent = parseConfigContent;
+exports.mergeConfigValues = mergeConfigValues;
+exports.withRetry = withRetry;
+const js_yaml_1 = require("js-yaml");
+function resolveConfigFormat(dataId, format = 'auto') {
+    if (format !== 'auto')
+        return format;
+    const extension = dataId.toLowerCase().split('.').pop();
+    if (extension === 'json')
+        return 'json';
+    if (extension === 'yaml' || extension === 'yml')
+        return 'yaml';
+    if (extension === 'properties' || extension === 'props')
+        return 'properties';
+    return 'txt';
+}
+function parseConfigContent(content, format = 'auto', dataId = '') {
+    const resolved = resolveConfigFormat(dataId, format);
+    if (resolved === 'txt')
+        return content;
+    if (resolved === 'json')
+        return JSON.parse(content);
+    if (resolved === 'yaml')
+        return (0, js_yaml_1.load)(content);
+    const result = {};
+    for (const originalLine of content.split(/\r?\n/)) {
+        const line = originalLine.trim();
+        if (!line || line.startsWith('#') || line.startsWith('!'))
+            continue;
+        const separator = line.search(/(?<!\\)[=:]/);
+        const key = (separator < 0 ? line : line.slice(0, separator)).trim();
+        const value = (separator < 0 ? '' : line.slice(separator + 1)).trim();
+        result[key.replace(/\\([:= ])/g, '$1')] = value.replace(/\\n/g, '\n').replace(/\\t/g, '\t');
+    }
+    return result;
+}
+function mergeConfigValues(target, source) {
+    if (!isPlainObject(target) || !isPlainObject(source))
+        return cloneValue(source);
+    const merged = { ...target };
+    for (const [key, value] of Object.entries(source)) {
+        merged[key] = key in merged ? mergeConfigValues(merged[key], value) : cloneValue(value);
+    }
+    return merged;
+}
+async function withRetry(operation, options) {
+    const attempts = Math.max(1, options?.attempts ?? 3);
+    let delay = Math.max(0, options?.delayMs ?? 300);
+    const factor = Math.max(1, options?.backoffFactor ?? 2);
+    const maxDelay = Math.max(delay, options?.maxDelayMs ?? 3000);
+    let lastError;
+    for (let attempt = 1; attempt <= attempts; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt < attempts && delay > 0) {
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                delay = Math.min(maxDelay, delay * factor);
+            }
+        }
+    }
+    throw lastError;
+}
+function isPlainObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function cloneValue(value) {
+    if (Array.isArray(value))
+        return value.map(cloneValue);
+    if (!isPlainObject(value))
+        return value;
+    return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, cloneValue(item)]));
+}
+//# sourceMappingURL=nacos.utils.js.map

package/dist/nacos.utils.js.map

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

package/package.json

@@ -1,20 +1,28 @@
 {
   "name": "@danqiusheng/nest-nacos",
-  "version": "1.0.0",
-  "description": "NestJS Nacos 插件 - 服务发现 + 配置中心（基于 nacos-sdk-nodejs，支持 gRPC / Nacos 2.x & 3.x）",
+  "version": "1.2.0",
+  "description": "NestJS Nacos 2.x configuration and service-discovery integration",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
     "dist",
     "README.md",
+    "README.en.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "scripts": {
     "build": "rimraf dist && tsc",
+    "test": "npm run test:unit",
+    "test:unit": "ts-node test/unit.ts",
+    "test:simple-e2e": "ts-node test/simple-options.e2e.ts",
+    "typecheck:example": "tsc --project tsconfig.example.json --noEmit",
     "start:example": "ts-node example/app.module.ts",
-    "prepublishOnly": "npm run build",
-    "version": "npm run build",
-    "postversion": "git push && git push --tags"
+    "prepublishOnly": "npm run build && npm test && npm run typecheck:example"
+  },
+  "dependencies": {
+    "js-yaml": "^4.3.0",
+    "nacos-config": "^2.6.3"
   },
   "peerDependencies": {
     "@nestjs/common": "^10.0.0 || ^11.0.0",
@@ -28,6 +36,7 @@
     "@nestjs/config": "^4.0.0",
     "@nestjs/core": "^11.0.0",
     "@nestjs/testing": "^11.1.28",
+    "@types/js-yaml": "^4.0.9",
     "@types/node": "^26.1.2",
     "nacos": "^2.6.3",
     "reflect-metadata": "^0.2.2",
@@ -44,17 +53,17 @@
     "config-center",
     "configuration",
     "microservice",
-    "grpc"
+    "load-balancing"
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/danqiusheng/nest-nacos.git"
+    "url": "git+https://gitee.com/li-zucheng/nacos-plugin.git"
   },
   "bugs": {
-    "url": "https://github.com/danqiusheng/nest-nacos/issues"
+    "url": "https://gitee.com/li-zucheng/nacos-plugin/issues"
   },
-  "homepage": "https://github.com/danqiusheng/nest-nacos#readme",
-  "author": "丹丘生",
+  "homepage": "https://gitee.com/li-zucheng/nacos-plugin",
+  "author": "danqiusheng",
   "license": "MIT",
   "engines": {
     "node": ">=16"