yingzios-platform-backend-shared 1.0.1

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

@@ -0,0 +1,9 @@
+import { DynamicModule } from '@nestjs/common';
+import { INacosConfig } from './nacos.config';
+export declare class NacosModule {
+    static forRootAsync(options: {
+        useFactory: (...args: any[]) => Promise<INacosConfig> | INacosConfig;
+        inject?: any[];
+    }): DynamicModule;
+}
+//# sourceMappingURL=nacos.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nacos.module.d.ts","sourceRoot":"","sources":["../../src/nacos/nacos.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI9C,qBAEa,WAAW;IACtB,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE;QAC3B,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;QACrE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;KAChB,GAAG,aAAa;CAwBlB"}

package/dist/nacos/nacos.module.js

@@ -0,0 +1,42 @@
+"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 NacosModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NacosModule = void 0;
+const common_1 = require("@nestjs/common");
+const nacos_service_1 = require("./nacos.service");
+const lodash_1 = require("lodash");
+let NacosModule = NacosModule_1 = class NacosModule {
+    static forRootAsync(options) {
+        return {
+            module: NacosModule_1,
+            providers: [
+                {
+                    provide: 'NACOS_CONFIG',
+                    useFactory: async (...args) => {
+                        const config = await options.useFactory(...args);
+                        config.currentServicePort = (0, lodash_1.toNumber)(config.currentServicePort || 8080);
+                        return config;
+                    },
+                    inject: options.inject || [],
+                },
+                nacos_service_1.NacosService,
+                {
+                    provide: 'NACOS_SERVICE',
+                    useExisting: nacos_service_1.NacosService,
+                },
+            ],
+            exports: [nacos_service_1.NacosService, 'NACOS_SERVICE'],
+        };
+    }
+};
+exports.NacosModule = NacosModule;
+exports.NacosModule = NacosModule = NacosModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], NacosModule);

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

@@ -0,0 +1,43 @@
+import { OnModuleDestroy, OnModuleInit } from '@nestjs/common';
+import { Host } from 'nacos';
+import type { INacosConfig } from './nacos.config';
+import type { CustomLogger } from '../logger';
+export declare class NacosService implements OnModuleInit, OnModuleDestroy {
+    protected readonly config: INacosConfig;
+    protected logger: CustomLogger;
+    private client;
+    private services;
+    private registeredInstances;
+    private localIP;
+    constructor(config: INacosConfig, logger: CustomLogger);
+    onModuleInit(): Promise<void>;
+    onModuleDestroy(): Promise<void>;
+    /**
+     * 自动注册当前服务到Nacos
+     */
+    private registerCurrentService;
+    /**
+     * 获取一个服务实例（默认使用加权随机）
+     * @param serviceName 服务名称
+     * @param strategy 负载均衡策略
+     * @returns 服务实例 URL，格式：http://ip:port，如果没有可用实例返回 null
+     */
+    getInstance(serviceName: string, strategy?: 'weightedRandom' | 'roundRobin'): string | null;
+    /**
+     * 将当前服务注册到Nacos
+     * @param serviceName 服务名称
+     * @param instance 服务实例信息
+     */
+    registerInstance(serviceName: string, instance: Host): Promise<void>;
+    /**
+     * 获取所有服务实例
+     */
+    getAllInstances(): Map<string, Host[]>;
+    /**
+     * 获取指定服务的所有实例列表
+     * @param serviceName 服务名称
+     * @returns 实例列表
+     */
+    getInstances(serviceName: string): Host[];
+}
+//# sourceMappingURL=nacos.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nacos.service.d.ts","sourceRoot":"","sources":["../../src/nacos/nacos.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,eAAe,EACf,YAAY,EACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAqB,IAAI,EAAE,MAAM,OAAO,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,qBACa,YAAa,YAAW,YAAY,EAAE,eAAe;IAW9D,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY;IAEvC,SAAS,CAAC,MAAM,EAAE,YAAY;IAZhC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,mBAAmB,CAGnB;IACR,OAAO,CAAC,OAAO,CAAS;gBAIH,MAAM,EAAE,YAAY,EAE7B,MAAM,EAAE,YAAY;IAgF1B,YAAY;IAeZ,eAAe;IAiBrB;;OAEG;YACW,sBAAsB;IA4BpC;;;;;OAKG;IACH,WAAW,CACT,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,gBAAgB,GAAG,YAA+B,GAC3D,MAAM,GAAG,IAAI;IAuBhB;;;;OAIG;IACG,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1E;;OAEG;IACH,eAAe,IAAI,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IAItC;;;;OAIG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,EAAE;CAG1C"}

package/dist/nacos/nacos.service.js

@@ -0,0 +1,212 @@
+"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); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NacosService = void 0;
+const common_1 = require("@nestjs/common");
+const nacos_1 = require("nacos");
+const lodash_1 = require("lodash");
+const utils_1 = require("./utils");
+let NacosService = class NacosService {
+    config;
+    logger;
+    client;
+    services = new Map();
+    registeredInstances = [];
+    localIP;
+    constructor(config, logger) {
+        this.config = config;
+        this.logger = logger;
+        // 获取本机IP地址
+        this.localIP = (0, utils_1.getLocalIP)();
+        // 创建自定义日志记录器
+        const customLogger = {
+            info: (...args) => {
+                // 只有在info及以上级别时才输出Nacos的info日志
+                const logLevel = process.env.LOGGER_LEVEL || 'info';
+                if (['info', 'debug'].includes(logLevel)) {
+                    this.logger.log?.(args.join(' '), 'NacosClient');
+                }
+            },
+            debug: (...args) => {
+                // 只有在debug级别时才输出Nacos的debug日志
+                if (process.env.LOGGER_LEVEL === 'debug') {
+                    this.logger.debug?.(args.join(' '), 'NacosClient');
+                }
+            },
+            warn: (...args) => {
+                // warn及以上级别总是输出
+                this.logger.warn?.(args.join(' '), 'NacosClient');
+            },
+            error: (...args) => {
+                // error级别总是输出
+                this.logger.error?.(args.join(' '), 'NacosClient');
+            },
+            trace: () => { },
+            assert: () => { },
+            clear: () => { },
+            count: () => { },
+            countReset: () => { },
+            dir: () => { },
+            dirxml: () => { },
+            group: () => { },
+            groupCollapsed: () => { },
+            groupEnd: () => { },
+            table: () => { },
+            time: () => { },
+            timeEnd: () => { },
+            timeLog: () => { },
+            profile: () => { },
+            profileEnd: () => { },
+            timeStamp: () => { },
+            log: (...args) => {
+                // 只有在info及以上级别时才输出Nacos的log日志
+                const logLevel = process.env.LOGGER_LEVEL || 'info';
+                if (['info', 'debug'].includes(logLevel)) {
+                    this.logger.log?.(args.join(' '), 'NacosClient');
+                }
+            },
+        };
+        this.client = new nacos_1.NacosNamingClient({
+            logger: customLogger,
+            serverList: config.serverAddr,
+            namespace: config.namespace,
+            username: config.username,
+            password: config.password,
+        });
+        if ((0, lodash_1.isArray)(config.serviceNames) && config.serviceNames.length) {
+            for (const serviceName of config.serviceNames) {
+                this.client.subscribe(serviceName, (hosts) => {
+                    // 转换格式
+                    const instances = hosts;
+                    // 缓存实例列表
+                    this.services.set(serviceName, instances);
+                    // 将频繁更新的日志改为debug级别
+                    logger.log(`[${serviceName}] 实例列表更新: ${instances.map((i) => i.ip.toString() + ':' + i.port.toString()).join(', ')}`);
+                });
+            }
+        }
+    }
+    async onModuleInit() {
+        try {
+            await this.client.ready();
+            this.logger.forceLog('Nacos 客户端已就绪');
+            // 自动注册当前服务（如果配置了 currentServiceName）
+            if (this.config.currentServiceName) {
+                await this.registerCurrentService();
+            }
+        }
+        catch (error) {
+            this.logger.error('Nacos 客户端初始化失败', error);
+            // 不阻断应用启动，继续运行（降级模式）
+        }
+    }
+    async onModuleDestroy() {
+        // 应用关闭时注销所有已注册的服务实例
+        for (const { serviceName, instance } of this.registeredInstances) {
+            try {
+                await this.client.deregisterInstance(serviceName, instance);
+                this.logger.forceLog(`成功注销服务实例: ${instance.ip}:${instance.port}`);
+            }
+            catch (error) {
+                this.logger.forceLog(`注销服务实例失败: ${instance.ip}:${instance.port}`, error);
+            }
+        }
+    }
+    /**
+     * 自动注册当前服务到Nacos
+     */
+    async registerCurrentService() {
+        // 从配置获取服务注册信息
+        const serviceName = this.config.currentServiceName;
+        const port = this.config.currentServicePort;
+        if (!serviceName || !port) {
+            this.logger.warn('未配置 currentServiceName 或 currentServicePort，跳过服务注册');
+            return;
+        }
+        // 注册服务到Nacos
+        const instance = {
+            ip: this.localIP,
+            port: port,
+            weight: 1.0,
+            ephemeral: true,
+            clusterName: 'DEFAULT',
+        };
+        try {
+            await this.registerInstance(serviceName, instance);
+            this.logger.forceLog(`Nacos服务注册成功: ${serviceName} @ ${this.localIP}:${port}`);
+        }
+        catch (error) {
+            this.logger.error(`Nacos服务注册失败: ${serviceName} @ ${this.localIP}:${port}`, error);
+            // 不抛出异常，允许应用继续运行
+        }
+    }
+    /**
+     * 获取一个服务实例（默认使用加权随机）
+     * @param serviceName 服务名称
+     * @param strategy 负载均衡策略
+     * @returns 服务实例 URL，格式：http://ip:port，如果没有可用实例返回 null
+     */
+    getInstance(serviceName, strategy = 'weightedRandom') {
+        const instances = this.services.get(serviceName);
+        if (!instances || !instances.length) {
+            this.logger.warn?.(`服务 ${serviceName} 暂无可用实例`);
+            return null;
+        }
+        let instance = null;
+        switch (strategy) {
+            case 'roundRobin':
+                instance = utils_1.LoadBalancer.roundRobin(instances, serviceName);
+                break;
+            case 'weightedRandom':
+            default:
+                instance = utils_1.LoadBalancer.weightedRandom(instances);
+                break;
+        }
+        if (!instance)
+            return null;
+        return `http://${instance.ip}:${instance.port}`;
+    }
+    /**
+     * 将当前服务注册到Nacos
+     * @param serviceName 服务名称
+     * @param instance 服务实例信息
+     */
+    async registerInstance(serviceName, instance) {
+        // 注册服务实例到Nacos
+        await this.client.registerInstance(serviceName, instance);
+        // 缓存已注册的实例，以便在应用关闭时注销
+        this.registeredInstances.push({ serviceName, instance });
+    }
+    /**
+     * 获取所有服务实例
+     */
+    getAllInstances() {
+        return this.services;
+    }
+    /**
+     * 获取指定服务的所有实例列表
+     * @param serviceName 服务名称
+     * @returns 实例列表
+     */
+    getInstances(serviceName) {
+        return this.services.get(serviceName) || [];
+    }
+};
+exports.NacosService = NacosService;
+exports.NacosService = NacosService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)('NACOS_CONFIG')),
+    __param(1, (0, common_1.Inject)('APP_LOGGER')),
+    __metadata("design:paramtypes", [Object, Function])
+], NacosService);

package/dist/nacos/utils.d.ts

@@ -0,0 +1,10 @@
+import { Host } from 'nacos';
+export declare class LoadBalancer {
+    static roundRobin(instances: Host[], serviceName: string): Host | null;
+    static weightedRandom(instances: Host[]): Host | null;
+}
+/**
+ * 获取本机IP地址
+ */
+export declare function getLocalIP(): string;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/nacos/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,IAAI,EAAE,MAAM,OAAO,CAAC;AAGhD,qBAAa,YAAY;IAEvB,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAetE,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,IAAI,EAAE,GAAG,IAAI,GAAG,IAAI;CAyBtD;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAmBnC"}

package/dist/nacos/utils.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoadBalancer = void 0;
+exports.getLocalIP = getLocalIP;
+const os_1 = require("os");
+// 负载均衡器类
+class LoadBalancer {
+    // 简单轮询算法
+    static roundRobin(instances, serviceName) {
+        if (!instances.length)
+            return null;
+        // 创建或获取当前服务的轮询索引
+        const key = `roundRobin_${serviceName}`;
+        const index = global[key] || 0;
+        // 获取实例并更新索引
+        const instance = instances[index % instances.length];
+        global[key] = (index + 1) % instances.length;
+        return instance;
+    }
+    // 加权随机算法（这是最常用的）
+    static weightedRandom(instances) {
+        if (!instances.length)
+            return null;
+        // 过滤健康实例
+        const healthyInstances = instances.filter((inst) => inst.healthy !== false);
+        if (!healthyInstances.length)
+            return null;
+        // 计算总权重
+        const totalWeight = healthyInstances.reduce((sum, inst) => sum + (inst.weight || 1.0), 0);
+        let random = Math.random() * totalWeight;
+        // 根据权重选择实例
+        for (const instance of healthyInstances) {
+            random -= instance.weight || 1.0;
+            if (random < 0) {
+                return instance;
+            }
+        }
+        // 如果权重计算有问题，返回最后一个
+        return healthyInstances[healthyInstances.length - 1];
+    }
+}
+exports.LoadBalancer = LoadBalancer;
+/**
+ * 获取本机IP地址
+ */
+function getLocalIP() {
+    const interfaces = (0, os_1.networkInterfaces)();
+    for (const name of Object.keys(interfaces)) {
+        const nets = interfaces[name];
+        if (!nets)
+            continue;
+        for (const net of nets) {
+            // 跳过内部地址和IPv6地址
+            if (!net.internal && net.family === 'IPv4') {
+                // 在Docker/K8s环境中，通常会有类似172.17.x.x或10.x.x.x这样的私有地址
+                // 跳过docker网桥地址(172.17.x.x)
+                if (!net.address.startsWith('172.17.')) {
+                    return net.address;
+                }
+            }
+        }
+    }
+    // 如果找不到合适的地址，返回默认值
+    return '127.0.0.1';
+}

package/dist/restful/current-request.util.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 获取当前请求对象的工具函数
+ * 用于在服务层或 Repository 层获取请求上下文
+ */
+export declare function getCurrentRequest(): any;
+/**
+ * 设置当前请求上下文的工具函数
+ * 通常在中间件中使用
+ */
+export declare function setCurrentRequest(request: any): void;
+/**
+ * 在AsyncLocalStorage上下文中运行函数
+ * 用于在中间件中设置请求上下文
+ */
+export declare function runWithContext(fn: () => void, request: any): void;
+//# sourceMappingURL=current-request.util.d.ts.map

package/dist/restful/current-request.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"current-request.util.d.ts","sourceRoot":"","sources":["../../src/restful/current-request.util.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,GAAG,CAGvC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CAKpD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI,CAEjE"}

package/dist/restful/current-request.util.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCurrentRequest = getCurrentRequest;
+exports.setCurrentRequest = setCurrentRequest;
+exports.runWithContext = runWithContext;
+const async_hooks_1 = require("async_hooks");
+// 使用 AsyncLocalStorage 来追踪请求上下文
+// 这在 Node.js 环境中是处理请求上下文的标准方式
+const asyncLocalStorage = new async_hooks_1.AsyncLocalStorage();
+/**
+ * 获取当前请求对象的工具函数
+ * 用于在服务层或 Repository 层获取请求上下文
+ */
+function getCurrentRequest() {
+    // 使用 AsyncLocalStorage 获取当前执行上下文中的请求对象
+    return asyncLocalStorage.getStore();
+}
+/**
+ * 设置当前请求上下文的工具函数
+ * 通常在中间件中使用
+ */
+function setCurrentRequest(request) {
+    // 在当前异步执行上下文中存储请求对象
+    // 注意：这需要在正确的执行上下文中使用
+    // 在中间件中，我们需要使用 run 方法来创建执行上下文
+    asyncLocalStorage.enterWith(request);
+}
+/**
+ * 在AsyncLocalStorage上下文中运行函数
+ * 用于在中间件中设置请求上下文
+ */
+function runWithContext(fn, request) {
+    asyncLocalStorage.run(request, fn);
+}

package/dist/restful/http-exception.filter.d.ts

@@ -0,0 +1,24 @@
+import { ExceptionFilter, ArgumentsHost, HttpException } from '@nestjs/common';
+/**
+ * 全局 HTTP 异常过滤器
+ *
+ * 功能：
+ * 1. 捕获所有 HTTP 异常
+ * 2. 统一返回 HTTP 200 状态码
+ * 3. 在响应体中使用 code 字段表示业务状态
+ * 4. 记录异常日志
+ */
+export declare class HttpExceptionFilter implements ExceptionFilter {
+    private readonly logger;
+    catch(exception: HttpException, host: ArgumentsHost): void;
+}
+/**
+ * 全局未捕获异常过滤器
+ *
+ * 用于捕获所有非 HTTP 异常（如系统错误、未预期异常等）
+ */
+export declare class GlobalExceptionFilter implements ExceptionFilter {
+    private readonly logger;
+    catch(exception: unknown, host: ArgumentsHost): void;
+}
+//# sourceMappingURL=http-exception.filter.d.ts.map

package/dist/restful/http-exception.filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-exception.filter.d.ts","sourceRoot":"","sources":["../../src/restful/http-exception.filter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAEf,aAAa,EACb,aAAa,EAGd,MAAM,gBAAgB,CAAC;AAuBxB;;;;;;;;GAQG;AACH,qBACa,mBAAoB,YAAW,eAAe;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAE/D,KAAK,CAAC,SAAS,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa;CAqDpD;AAED;;;;GAIG;AACH,qBACa,qBAAsB,YAAW,eAAe;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IAEjE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa;CAmC9C"}

package/dist/restful/http-exception.filter.js

@@ -0,0 +1,126 @@
+"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 HttpExceptionFilter_1, GlobalExceptionFilter_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GlobalExceptionFilter = exports.HttpExceptionFilter = void 0;
+const common_1 = require("@nestjs/common");
+const response_dto_1 = require("./response.dto");
+const response_codes_1 = require("./response-codes");
+/**
+ * HTTP 异常映射到业务状态码
+ */
+const HTTP_STATUS_TO_CODE_MAP = {
+    [common_1.HttpStatus.BAD_REQUEST]: response_codes_1.ResponseCode.BAD_REQUEST,
+    [common_1.HttpStatus.UNAUTHORIZED]: response_codes_1.ResponseCode.UNAUTHORIZED,
+    [common_1.HttpStatus.FORBIDDEN]: response_codes_1.ResponseCode.FORBIDDEN,
+    [common_1.HttpStatus.NOT_FOUND]: response_codes_1.ResponseCode.NOT_FOUND,
+    [common_1.HttpStatus.METHOD_NOT_ALLOWED]: response_codes_1.ResponseCode.METHOD_NOT_ALLOWED,
+    [common_1.HttpStatus.REQUEST_TIMEOUT]: response_codes_1.ResponseCode.REQUEST_TIMEOUT,
+    [common_1.HttpStatus.CONFLICT]: response_codes_1.ResponseCode.CONFLICT,
+    [common_1.HttpStatus.PAYLOAD_TOO_LARGE]: response_codes_1.ResponseCode.PAYLOAD_TOO_LARGE,
+    [common_1.HttpStatus.TOO_MANY_REQUESTS]: response_codes_1.ResponseCode.TOO_MANY_REQUESTS,
+    [common_1.HttpStatus.INTERNAL_SERVER_ERROR]: response_codes_1.ResponseCode.INTERNAL_ERROR,
+    [common_1.HttpStatus.SERVICE_UNAVAILABLE]: response_codes_1.ResponseCode.SERVICE_UNAVAILABLE,
+    [common_1.HttpStatus.GATEWAY_TIMEOUT]: response_codes_1.ResponseCode.GATEWAY_TIMEOUT,
+};
+/**
+ * 全局 HTTP 异常过滤器
+ *
+ * 功能：
+ * 1. 捕获所有 HTTP 异常
+ * 2. 统一返回 HTTP 200 状态码
+ * 3. 在响应体中使用 code 字段表示业务状态
+ * 4. 记录异常日志
+ */
+let HttpExceptionFilter = HttpExceptionFilter_1 = class HttpExceptionFilter {
+    logger = new common_1.Logger(HttpExceptionFilter_1.name);
+    catch(exception, host) {
+        const ctx = host.switchToHttp();
+        const response = ctx.getResponse();
+        const request = ctx.getRequest();
+        const httpStatus = exception.getStatus();
+        const exceptionResponse = exception.getResponse();
+        // 提取错误消息
+        let message;
+        let code;
+        let data;
+        if (typeof exceptionResponse === 'object' && exceptionResponse !== null) {
+            const responseObject = exceptionResponse;
+            // 如果异常响应本身已经包含 code 字段（说明是业务异常），直接使用
+            if (responseObject.code) {
+                code = responseObject.code;
+                message = responseObject.message || exception.message;
+                data = responseObject.data;
+            }
+            else {
+                // 否则根据 HTTP 状态码映射到业务状态码
+                code = HTTP_STATUS_TO_CODE_MAP[httpStatus] || response_codes_1.ResponseCode.INTERNAL_ERROR;
+                message = responseObject.message || exception.message;
+                // Nest.js 的 ValidationPipe 会返回数组形式的错误消息
+                if (Array.isArray(message)) {
+                    message = message.join(', ');
+                }
+            }
+        }
+        else {
+            code = HTTP_STATUS_TO_CODE_MAP[httpStatus] || response_codes_1.ResponseCode.INTERNAL_ERROR;
+            message = exception.message;
+        }
+        // 记录日志
+        this.logger.error(`HTTP Exception: ${request.method} ${request.url} - Status: ${httpStatus} - Code: ${code} - Message: ${message}`, exception.stack);
+        // 构造响应
+        const errorResponse = response_dto_1.ApiResponseDto.error(code, message, data);
+        // 添加 traceId（如果请求上下文中有）
+        if (request.traceId) {
+            errorResponse.traceId = request.traceId;
+        }
+        // 统一返回 HTTP 200，通过 code 字段判断业务状态
+        response.status(common_1.HttpStatus.OK).json(errorResponse);
+    }
+};
+exports.HttpExceptionFilter = HttpExceptionFilter;
+exports.HttpExceptionFilter = HttpExceptionFilter = HttpExceptionFilter_1 = __decorate([
+    (0, common_1.Catch)(common_1.HttpException)
+], HttpExceptionFilter);
+/**
+ * 全局未捕获异常过滤器
+ *
+ * 用于捕获所有非 HTTP 异常（如系统错误、未预期异常等）
+ */
+let GlobalExceptionFilter = GlobalExceptionFilter_1 = class GlobalExceptionFilter {
+    logger = new common_1.Logger(GlobalExceptionFilter_1.name);
+    catch(exception, host) {
+        const ctx = host.switchToHttp();
+        const response = ctx.getResponse();
+        const request = ctx.getRequest();
+        // 默认为内部服务器错误
+        let code = response_codes_1.ResponseCode.INTERNAL_ERROR;
+        let message = '服务器内部错误';
+        // 如果是已知异常类型，尝试提取信息
+        if (exception instanceof Error) {
+            message = exception.message || message;
+            // 记录完整的错误堆栈
+            this.logger.error(`Unhandled Exception: ${request.method} ${request.url} - Message: ${message}`, exception.stack);
+        }
+        else {
+            this.logger.error(`Unknown Exception: ${request.method} ${request.url} - ${JSON.stringify(exception)}`);
+        }
+        // 构造响应
+        const errorResponse = response_dto_1.ApiResponseDto.error(code, message);
+        // 添加 traceId
+        if (request.traceId) {
+            errorResponse.traceId = request.traceId;
+        }
+        // 返回 HTTP 200
+        response.status(common_1.HttpStatus.OK).json(errorResponse);
+    }
+};
+exports.GlobalExceptionFilter = GlobalExceptionFilter;
+exports.GlobalExceptionFilter = GlobalExceptionFilter = GlobalExceptionFilter_1 = __decorate([
+    (0, common_1.Catch)()
+], GlobalExceptionFilter);

package/dist/restful/index.d.ts

@@ -0,0 +1,8 @@
+export * from './restful.module';
+export * from './response.dto';
+export * from './response-codes';
+export * from './response.interceptor';
+export * from './http-exception.filter';
+export * from './current-request.util';
+export * from './request-context.middleware';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/restful/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC"}

package/dist/restful/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./restful.module"), exports);
+__exportStar(require("./response.dto"), exports);
+__exportStar(require("./response-codes"), exports);
+__exportStar(require("./response.interceptor"), exports);
+__exportStar(require("./http-exception.filter"), exports);
+__exportStar(require("./current-request.util"), exports);
+__exportStar(require("./request-context.middleware"), exports);

package/dist/restful/request-context.middleware.d.ts

@@ -0,0 +1,6 @@
+import { NestMiddleware } from '@nestjs/common';
+import { Request, Response, NextFunction } from 'express';
+export declare class RequestContextMiddleware implements NestMiddleware {
+    use(req: Request, res: Response, next: NextFunction): void;
+}
+//# sourceMappingURL=request-context.middleware.d.ts.map

package/dist/restful/request-context.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.middleware.d.ts","sourceRoot":"","sources":["../../src/restful/request-context.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG1D,qBACa,wBAAyB,YAAW,cAAc;IAC7D,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY;CASpD"}