@danqiusheng/nest-nacos 1.0.0

package/dist/nacos-config.service.js

@@ -0,0 +1,179 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var NacosConfigService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NacosConfigService = void 0;
+/**
+ * NestJS Nacos 插件 - Config 服务（配置中心）
+ *
+ * 封装 NacosConfigClient，负责：
+ * - 配置读取与发布
+ * - 配置变更订阅（服务端推送）
+ * - 本地配置缓存（支持热更新）
+ */
+const common_1 = require("@nestjs/common");
+const nacos_constants_1 = require("./nacos.constants");
+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.listeners = new Map();
+    }
+    /** 模块初始化：等待客户端就绪 + 预加载订阅配置 */
+    async onModuleInit() {
+        if (!this.client) {
+            this.logger.warn('NacosConfigClient 未初始化，Config 功能跳过');
+            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);
+        }
+    }
+    async onModuleDestroy() {
+        if (!this.client)
+            return;
+        this.logger.log('NacosConfigClient 已关闭');
+    }
+    /**
+     * 获取配置内容
+     * @param dataId 配置 ID
+     * @param group 分组名，默认 'DEFAULT_GROUP'
+     * @returns 配置内容字符串
+     */
+    async getConfig(dataId, group = 'DEFAULT_GROUP') {
+        if (!this.client)
+            throw new Error('NacosConfigClient 未初始化');
+        const key = `${dataId}@@${group}`;
+        if (this.cache.has(key)) {
+            return this.cache.get(key);
+        }
+        const content = await this.client.getConfig(dataId, group);
+        this.cache.set(key, content);
+        return content;
+    }
+    /**
+     * 获取配置并解析为 JSON 对象
+     */
+    async getConfigAsJson(dataId, group = 'DEFAULT_GROUP') {
+        const content = await this.getConfig(dataId, group);
+        try {
+            return JSON.parse(content);
+        }
+        catch {
+            this.logger.warn(`配置 ${dataId} 不是合法 JSON，返回原始字符串`);
+            return content;
+        }
+    }
+    /**
+     * 发布配置
+     * @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})`);
+        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})`);
+        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());
+        }
+        this.listeners.get(key).add(listener);
+        this.logger.log(`已订阅配置: ${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 {
+            this.listeners.delete(key);
+        }
+    }
+    /** 获取原始客户端 */
+    getRawClient() {
+        return this.client;
+    }
+    /** 内部方法：加载配置并建立订阅 */
+    async loadAndSubscribe(dataId, group) {
+        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;
+        }
+        catch (err) {
+            this.logger.error(`加载配置失败: ${dataId} (${group})`, err);
+        }
+    }
+};
+exports.NacosConfigService = NacosConfigService;
+exports.NacosConfigService = NacosConfigService = NacosConfigService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Optional)()),
+    __param(0, (0, common_1.Inject)(nacos_constants_1.NACOS_CONFIG_CLIENT)),
+    __param(1, (0, common_1.Optional)()),
+    __param(1, (0, common_1.Inject)(nacos_constants_1.NACOS_OPTIONS)),
+    __metadata("design:paramtypes", [Object, Object])
+], NacosConfigService);
+//# sourceMappingURL=nacos-config.service.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,68 @@
+/**
+ * NestJS Nacos 插件 - Naming 服务（服务发现/注册）
+ *
+ * 封装 NacosNamingClient，负责：
+ * - 客户端生命周期管理（初始化 / 关闭）
+ * - 服务实例自动注册与注销
+ * - 服务订阅与实例查询
+ */
+import { OnModuleDestroy, OnModuleInit } from '@nestjs/common';
+import { NacosNamingClient } from 'nacos';
+import { NacosInstanceOptions, NacosModuleOptions } from './nacos.interfaces';
+export declare class NacosNamingService implements OnModuleInit, OnModuleDestroy {
+    private readonly client;
+    private readonly options;
+    private readonly logger;
+    /** 已注册的实例配置（用于模块销毁时注销） */
+    private registeredInstances;
+    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 回调函数，参数为实例列表
+     */
+    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 时） */
+    getRawClient(): NacosNamingClient | null;
+}
+//# sourceMappingURL=nacos-naming.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nacos-naming.service.d.ts","sourceRoot":"","sources":["../src/nacos-naming.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAA8B,eAAe,EAAE,YAAY,EAAY,MAAM,gBAAgB,CAAC;AACrG,OAAO,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAK1C,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAE5B,qBACa,kBAAmB,YAAW,YAAY,EAAE,eAAe;IAM3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,0BAA0B;IAC1B,OAAO,CAAC,mBAAmB,CAA8B;gBAGG,MAAM,EAAE,iBAAiB,GAAG,IAAI,EACtC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAGxF,6BAA6B;IACvB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAenC,6BAA6B;IACvB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAatC;;;OAGG;IACG,QAAQ,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAazD;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3D;;;;;;OAMG;IACG,eAAe,CACnB,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,UAAO;IAMlB;;OAEG;IACG,eAAe,CACnB,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,UAAO,EACd,SAAS,UAAO;IAMlB;;;;OAIG;IACH,SAAS,CACP,IAAI,EAAE,MAAM,GAAG;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAC7E,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,GAC/B,IAAI;IAMP;;OAEG;IACH,WAAW,CACT,IAAI,EAAE,MAAM,GAAG;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAC7E,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,GAChC,IAAI;IAMP,mCAAmC;IACnC,eAAe,IAAI,MAAM;IAKzB,4BAA4B;IAC5B,YAAY,IAAI,iBAAiB,GAAG,IAAI;CAGzC"}

package/dist/nacos-naming.service.js

@@ -0,0 +1,153 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var NacosNamingService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NacosNamingService = void 0;
+/**
+ * NestJS Nacos 插件 - Naming 服务（服务发现/注册）
+ *
+ * 封装 NacosNamingClient，负责：
+ * - 客户端生命周期管理（初始化 / 关闭）
+ * - 服务实例自动注册与注销
+ * - 服务订阅与实例查询
+ */
+const common_1 = require("@nestjs/common");
+const nacos_constants_1 = require("./nacos.constants");
+let NacosNamingService = NacosNamingService_1 = class NacosNamingService {
+    constructor(client, options) {
+        this.client = client;
+        this.options = options;
+        this.logger = new common_1.Logger(NacosNamingService_1.name);
+        /** 已注册的实例配置（用于模块销毁时注销） */
+        this.registeredInstances = [];
+    }
+    /** 模块初始化：等待客户端就绪 + 自动注册实例 */
+    async onModuleInit() {
+        if (!this.client) {
+            this.logger.warn('NacosNamingClient 未初始化，Naming 功能跳过');
+            return;
+        }
+        await this.client.ready();
+        this.logger.log('NacosNamingClient 已就绪');
+        // 自动注册配置中的服务实例
+        const instances = this.options?.instances ?? [];
+        for (const inst of instances) {
+            await this.register(inst);
+        }
+    }
+    /** 模块销毁：注销所有已注册实例 + 关闭客户端 */
+    async onModuleDestroy() {
+        if (!this.client)
+            return;
+        // 注销所有已注册实例
+        for (const inst of this.registeredInstances) {
+            try {
+                await this.deregister(inst);
+            }
+            catch (err) {
+                this.logger.error(`注销实例失败: ${inst.serviceName}`, err);
+            }
+        }
+        this.logger.log('NacosNamingClient 已关闭');
+    }
+    /**
+     * 注册服务实例
+     * @param inst 实例配置
+     */
+    async register(inst) {
+        if (!this.client)
+            throw new Error('NacosNamingClient 未初始化');
+        const { serviceName, ip, port, groupName, ...rest } = inst;
+        // SDK 的 Instance 类型要求 instanceId/healthy/enabled，但注册时由服务端生成，故用 as any
+        await this.client.registerInstance(serviceName, {
+            ip,
+            port,
+            ...rest,
+        }, groupName);
+        this.registeredInstances.push(inst);
+        this.logger.log(`已注册服务实例: ${serviceName} (${ip}:${port})`);
+    }
+    /**
+     * 注销服务实例
+     * @param inst 实例配置
+     */
+    async deregister(inst) {
+        if (!this.client)
+            throw new Error('NacosNamingClient 未初始化');
+        const { serviceName, ip, port, groupName } = inst;
+        await this.client.deregisterInstance(serviceName, { ip, port }, groupName);
+        this.registeredInstances = this.registeredInstances.filter((i) => !(i.serviceName === serviceName && i.ip === ip && i.port === port));
+        this.logger.log(`已注销服务实例: ${serviceName} (${ip}:${port})`);
+    }
+    /**
+     * 查询服务的所有实例
+     * @param serviceName 服务名
+     * @param groupName 分组名
+     * @param clusters 集群名
+     * @param subscribe 是否订阅，默认 true
+     */
+    async getAllInstances(serviceName, groupName, clusters, subscribe = true) {
+        if (!this.client)
+            throw new Error('NacosNamingClient 未初始化');
+        return this.client.getAllInstances(serviceName, groupName, clusters, subscribe);
+    }
+    /**
+     * 查询健康实例
+     */
+    async selectInstances(serviceName, groupName, clusters, healthy = true, subscribe = true) {
+        if (!this.client)
+            throw new Error('NacosNamingClient 未初始化');
+        return this.client.selectInstances(serviceName, groupName, clusters, healthy, subscribe);
+    }
+    /**
+     * 订阅服务实例变更（服务端推送）
+     * @param info 服务信息，字符串为 serviceName，对象为 { serviceName, groupName, clusters }
+     * @param listener 回调函数，参数为实例列表
+     */
+    subscribe(info, listener) {
+        if (!this.client)
+            throw new Error('NacosNamingClient 未初始化');
+        this.client.subscribe(info, listener);
+        this.logger.log(`已订阅服务: ${typeof info === 'string' ? info : info.serviceName}`);
+    }
+    /**
+     * 取消订阅
+     */
+    unSubscribe(info, listener) {
+        if (!this.client)
+            throw new Error('NacosNamingClient 未初始化');
+        // SDK 要求 listener 必填，此处兼容可选参数
+        this.client.unSubscribe(info, (listener ?? (() => undefined)));
+    }
+    /** 获取 Nacos 服务端状态：'UP' 或 'DOWN' */
+    getServerStatus() {
+        if (!this.client)
+            return 'DOWN';
+        return this.client.getServerStatus();
+    }
+    /** 获取原始客户端（需要使用高级 API 时） */
+    getRawClient() {
+        return this.client;
+    }
+};
+exports.NacosNamingService = NacosNamingService;
+exports.NacosNamingService = NacosNamingService = NacosNamingService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Optional)()),
+    __param(0, (0, common_1.Inject)(nacos_constants_1.NACOS_NAMING_CLIENT)),
+    __param(1, (0, common_1.Optional)()),
+    __param(1, (0, common_1.Inject)(nacos_constants_1.NACOS_OPTIONS)),
+    __metadata("design:paramtypes", [Object, Object])
+], NacosNamingService);
+//# sourceMappingURL=nacos-naming.service.js.map

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

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

package/dist/nacos.constants.d.ts

@@ -0,0 +1,8 @@
+/**
+ * NestJS Nacos 插件 - 依赖注入 Token 常量
+ */
+export declare const NACOS_OPTIONS = "NACOS_OPTIONS";
+export declare const NACOS_MODULE_ID = "NACOS_MODULE_ID";
+export declare const NACOS_NAMING_CLIENT = "NACOS_NAMING_CLIENT";
+export declare const NACOS_CONFIG_CLIENT = "NACOS_CONFIG_CLIENT";
+//# sourceMappingURL=nacos.constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nacos.constants.d.ts","sourceRoot":"","sources":["../src/nacos.constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAC7C,eAAO,MAAM,eAAe,oBAAoB,CAAC;AAGjD,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AACzD,eAAO,MAAM,mBAAmB,wBAAwB,CAAC"}

package/dist/nacos.constants.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * NestJS Nacos 插件 - 依赖注入 Token 常量
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NACOS_CONFIG_CLIENT = exports.NACOS_NAMING_CLIENT = exports.NACOS_MODULE_ID = exports.NACOS_OPTIONS = void 0;
+// Nacos 模块配置 Token
+exports.NACOS_OPTIONS = 'NACOS_OPTIONS';
+exports.NACOS_MODULE_ID = 'NACOS_MODULE_ID';
+// Nacos 客户端 Token
+exports.NACOS_NAMING_CLIENT = 'NACOS_NAMING_CLIENT';
+exports.NACOS_CONFIG_CLIENT = 'NACOS_CONFIG_CLIENT';
+//# sourceMappingURL=nacos.constants.js.map

package/dist/nacos.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nacos.constants.js","sourceRoot":"","sources":["../src/nacos.constants.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,mBAAmB;AACN,QAAA,aAAa,GAAG,eAAe,CAAC;AAChC,QAAA,eAAe,GAAG,iBAAiB,CAAC;AAEjD,kBAAkB;AACL,QAAA,mBAAmB,GAAG,qBAAqB,CAAC;AAC5C,QAAA,mBAAmB,GAAG,qBAAqB,CAAC"}

package/dist/nacos.decorators.d.ts

@@ -0,0 +1,9 @@
+/** 注入 NacosNamingService */
+export declare const InjectNacosNaming: () => PropertyDecorator & ParameterDecorator;
+/** 注入 NacosConfigService */
+export declare const InjectNacosConfig: () => PropertyDecorator & ParameterDecorator;
+/** 注入原始 Naming 客户端（高级用法） */
+export declare const InjectNacosNamingClient: () => PropertyDecorator & ParameterDecorator;
+/** 注入原始 Config 客户端（高级用法） */
+export declare const InjectNacosConfigClient: () => PropertyDecorator & ParameterDecorator;
+//# sourceMappingURL=nacos.decorators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nacos.decorators.d.ts","sourceRoot":"","sources":["../src/nacos.decorators.ts"],"names":[],"mappings":"AAYA,4BAA4B;AAC5B,eAAO,MAAM,iBAAiB,8CAAmC,CAAC;AAElE,4BAA4B;AAC5B,eAAO,MAAM,iBAAiB,8CAAmC,CAAC;AAElE,4BAA4B;AAC5B,eAAO,MAAM,uBAAuB,8CAAoC,CAAC;AAEzE,4BAA4B;AAC5B,eAAO,MAAM,uBAAuB,8CAAoC,CAAC"}

package/dist/nacos.decorators.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InjectNacosConfigClient = exports.InjectNacosNamingClient = exports.InjectNacosConfig = exports.InjectNacosNaming = void 0;
+/**
+ * NestJS Nacos 插件 - 装饰器
+ *
+ * @InjectNacosNaming()  — 注入 Naming 服务
+ * @InjectNacosConfig()  — 注入 Config 服务
+ * @NacosConfig()        — 参数装饰器：在路由/方法参数上直接获取某 dataId 的配置值（需配合 ConfigService 预加载）
+ */
+const common_1 = require("@nestjs/common");
+const nacos_constants_1 = require("./nacos.constants");
+const nacos_naming_service_1 = require("./nacos-naming.service");
+const nacos_config_service_1 = require("./nacos-config.service");
+/** 注入 NacosNamingService */
+const InjectNacosNaming = () => (0, common_1.Inject)(nacos_naming_service_1.NacosNamingService);
+exports.InjectNacosNaming = InjectNacosNaming;
+/** 注入 NacosConfigService */
+const InjectNacosConfig = () => (0, common_1.Inject)(nacos_config_service_1.NacosConfigService);
+exports.InjectNacosConfig = InjectNacosConfig;
+/** 注入原始 Naming 客户端（高级用法） */
+const InjectNacosNamingClient = () => (0, common_1.Inject)(nacos_constants_1.NACOS_NAMING_CLIENT);
+exports.InjectNacosNamingClient = InjectNacosNamingClient;
+/** 注入原始 Config 客户端（高级用法） */
+const InjectNacosConfigClient = () => (0, common_1.Inject)(nacos_constants_1.NACOS_CONFIG_CLIENT);
+exports.InjectNacosConfigClient = InjectNacosConfigClient;
+//# sourceMappingURL=nacos.decorators.js.map

package/dist/nacos.decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nacos.decorators.js","sourceRoot":"","sources":["../src/nacos.decorators.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,2CAA+C;AAC/C,uDAA6E;AAC7E,iEAA4D;AAC5D,iEAA4D;AAE5D,4BAA4B;AACrB,MAAM,iBAAiB,GAAG,GAAG,EAAE,CAAC,IAAA,eAAM,EAAC,yCAAkB,CAAC,CAAC;AAArD,QAAA,iBAAiB,qBAAoC;AAElE,4BAA4B;AACrB,MAAM,iBAAiB,GAAG,GAAG,EAAE,CAAC,IAAA,eAAM,EAAC,yCAAkB,CAAC,CAAC;AAArD,QAAA,iBAAiB,qBAAoC;AAElE,4BAA4B;AACrB,MAAM,uBAAuB,GAAG,GAAG,EAAE,CAAC,IAAA,eAAM,EAAC,qCAAmB,CAAC,CAAC;AAA5D,QAAA,uBAAuB,2BAAqC;AAEzE,4BAA4B;AACrB,MAAM,uBAAuB,GAAG,GAAG,EAAE,CAAC,IAAA,eAAM,EAAC,qCAAmB,CAAC,CAAC;AAA5D,QAAA,uBAAuB,2BAAqC"}

package/dist/nacos.health.d.ts

@@ -0,0 +1,14 @@
+import { NacosNamingService } from './nacos-naming.service';
+export declare class NacosHealthIndicator {
+    private readonly namingService;
+    private readonly logger;
+    constructor(namingService: NacosNamingService);
+    /**
+     * 检查 Nacos 服务端连接状态
+     * @returns { status: 'up' | 'down' }
+     */
+    isHealthy(): {
+        status: 'up' | 'down';
+    };
+}
+//# sourceMappingURL=nacos.health.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nacos.health.d.ts","sourceRoot":"","sources":["../src/nacos.health.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,qBACa,oBAAoB;IAGnB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAF1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;gBAEnC,aAAa,EAAE,kBAAkB;IAE9D;;;OAGG;IACH,SAAS,IAAI;QAAE,MAAM,EAAE,IAAI,GAAG,MAAM,CAAA;KAAE;CAUvC"}

package/dist/nacos.health.js

@@ -0,0 +1,57 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var NacosHealthIndicator_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NacosHealthIndicator = void 0;
+/**
+ * NestJS Nacos 插件 - 健康检查指示器（可选）
+ *
+ * 配合 @nestjs/terminus 使用，暴露 /health 端点时可检查 Nacos 连接状态。
+ * 用法：在 HealthController 中注入并调用 .isHealthy()
+ *
+ *   import { HealthIndicatorService } from '@nestjs/terminus';
+ *   @Injectable()
+ *   export class HealthService {
+ *     constructor(private nacos: NacosHealthIndicator) {}
+ *     check() { return this.nacos.isHealthy('nacos'); }
+ *   }
+ *
+ * 若未安装 @nestjs/terminus，可直接使用 isHealthy() 方法。
+ */
+const common_1 = require("@nestjs/common");
+const nacos_naming_service_1 = require("./nacos-naming.service");
+let NacosHealthIndicator = NacosHealthIndicator_1 = class NacosHealthIndicator {
+    constructor(namingService) {
+        this.namingService = namingService;
+        this.logger = new common_1.Logger(NacosHealthIndicator_1.name);
+    }
+    /**
+     * 检查 Nacos 服务端连接状态
+     * @returns { status: 'up' | 'down' }
+     */
+    isHealthy() {
+        try {
+            const serverStatus = this.namingService.getServerStatus();
+            const isUp = serverStatus === 'UP';
+            return { status: isUp ? 'up' : 'down' };
+        }
+        catch (err) {
+            this.logger.error('Nacos 健康检查失败', err);
+            return { status: 'down' };
+        }
+    }
+};
+exports.NacosHealthIndicator = NacosHealthIndicator;
+exports.NacosHealthIndicator = NacosHealthIndicator = NacosHealthIndicator_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [nacos_naming_service_1.NacosNamingService])
+], NacosHealthIndicator);
+//# sourceMappingURL=nacos.health.js.map

package/dist/nacos.health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nacos.health.js","sourceRoot":"","sources":["../src/nacos.health.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;GAcG;AACH,2CAAoD;AACpD,iEAA4D;AAGrD,IAAM,oBAAoB,4BAA1B,MAAM,oBAAoB;IAG/B,YAA6B,aAAiC;QAAjC,kBAAa,GAAb,aAAa,CAAoB;QAF7C,WAAM,GAAG,IAAI,eAAM,CAAC,sBAAoB,CAAC,IAAI,CAAC,CAAC;IAEC,CAAC;IAElE;;;OAGG;IACH,SAAS;QACP,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,eAAe,EAAE,CAAC;YAC1D,MAAM,IAAI,GAAG,YAAY,KAAK,IAAI,CAAC;YACnC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;YACvC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;CACF,CAAA;AAnBY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;qCAIiC,yCAAkB;GAHnD,oBAAoB,CAmBhC"}