yingzios-platform-backend-shared 1.0.1

package/dist/restful/request-context.middleware.js

@@ -0,0 +1,25 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestContextMiddleware = void 0;
+const common_1 = require("@nestjs/common");
+const current_request_util_1 = require("./current-request.util");
+let RequestContextMiddleware = class RequestContextMiddleware {
+    use(req, res, next) {
+        // 在AsyncLocalStorage上下文中运行请求处理
+        (0, current_request_util_1.runWithContext)(() => {
+            // 设置当前请求上下文
+            (0, current_request_util_1.setCurrentRequest)(req);
+            next();
+        }, req);
+    }
+};
+exports.RequestContextMiddleware = RequestContextMiddleware;
+exports.RequestContextMiddleware = RequestContextMiddleware = __decorate([
+    (0, common_1.Injectable)()
+], RequestContextMiddleware);

package/dist/restful/response-codes.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 统一业务状态码定义
+ *
+ * 规范：
+ * - 所有接口统一返回 HTTP 200
+ * - 通过响应体中的 code 字段判断业务状态
+ * - code 为 6 位数字字符串
+ *
+ * 状态码分类：
+ * - 000xxx: 成功
+ * - 100xxx: 客户端错误（参数、认证、权限等）
+ * - 200xxx: 服务端错误（系统错误、数据库错误等）
+ * - 300xxx: 业务错误（业务规则限制等）
+ */
+/**
+ * 业务状态码枚举
+ */
+export declare enum ResponseCode {
+    /** 操作成功 */
+    SUCCESS = "000000",
+    /** 请求参数错误 */
+    BAD_REQUEST = "100400",
+    /** 未认证（未登录） */
+    UNAUTHORIZED = "100401",
+    /** 无权限 */
+    FORBIDDEN = "100403",
+    /** 资源不存在 */
+    NOT_FOUND = "100404",
+    /** 请求方法不允许 */
+    METHOD_NOT_ALLOWED = "100405",
+    /** 请求超时 */
+    REQUEST_TIMEOUT = "100408",
+    /** 请求冲突 */
+    CONFLICT = "100409",
+    /** 请求实体过大 */
+    PAYLOAD_TOO_LARGE = "100413",
+    /** 请求频率过高 */
+    TOO_MANY_REQUESTS = "100429",
+    /** 令牌无效 */
+    TOKEN_INVALID = "101001",
+    /** 令牌已过期 */
+    TOKEN_EXPIRED = "101002",
+    /** 令牌被撤销 */
+    TOKEN_REVOKED = "101003",
+    /** 刷新令牌无效 */
+    REFRESH_TOKEN_INVALID = "101004",
+    /** 检测到令牌重用 */
+    TOKEN_REUSED = "101005",
+    /** 验证码错误 */
+    CAPTCHA_ERROR = "101006",
+    /** 验证码已过期 */
+    CAPTCHA_EXPIRED = "101007",
+    /** 内部服务器错误 */
+    INTERNAL_ERROR = "200500",
+    /** 服务不可用 */
+    SERVICE_UNAVAILABLE = "200503",
+    /** 网关超时 */
+    GATEWAY_TIMEOUT = "200504",
+    /** 数据库错误 */
+    DATABASE_ERROR = "200510",
+    /** 缓存错误 */
+    CACHE_ERROR = "200511",
+    /** 外部服务错误 */
+    EXTERNAL_SERVICE_ERROR = "200520",
+    /** 业务规则限制 */
+    BUSINESS_ERROR = "300001",
+    /** 数据已存在 */
+    DATA_EXISTS = "300002",
+    /** 数据不存在 */
+    DATA_NOT_FOUND = "300003",
+    /** 操作不允许 */
+    OPERATION_NOT_ALLOWED = "300004",
+    /** 状态不允许 */
+    STATE_NOT_ALLOWED = "300005",
+    /** 余额不足 */
+    INSUFFICIENT_BALANCE = "300006",
+    /** 库存不足 */
+    INSUFFICIENT_STOCK = "300007"
+}
+/**
+ * 业务状态码描述映射
+ */
+export declare const ResponseCodeMessage: Record<ResponseCode, string>;
+/**
+ * 获取状态码对应的描述
+ */
+export declare function getResponseMessage(code: ResponseCode | string): string;
+/**
+ * 判断是否为成功状态
+ */
+export declare function isSuccess(code: string): boolean;
+/**
+ * 判断是否为认证错误
+ */
+export declare function isAuthError(code: string): boolean;
+/**
+ * 判断是否为服务端错误
+ */
+export declare function isServerError(code: string): boolean;
+/**
+ * 判断是否为业务错误
+ */
+export declare function isBusinessError(code: string): boolean;
+//# sourceMappingURL=response-codes.d.ts.map

package/dist/restful/response-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-codes.d.ts","sourceRoot":"","sources":["../../src/restful/response-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;GAEG;AACH,oBAAY,YAAY;IAEtB,WAAW;IACX,OAAO,WAAW;IAGlB,aAAa;IACb,WAAW,WAAW;IACtB,eAAe;IACf,YAAY,WAAW;IACvB,UAAU;IACV,SAAS,WAAW;IACpB,YAAY;IACZ,SAAS,WAAW;IACpB,cAAc;IACd,kBAAkB,WAAW;IAC7B,WAAW;IACX,eAAe,WAAW;IAC1B,WAAW;IACX,QAAQ,WAAW;IACnB,aAAa;IACb,iBAAiB,WAAW;IAC5B,aAAa;IACb,iBAAiB,WAAW;IAG5B,WAAW;IACX,aAAa,WAAW;IACxB,YAAY;IACZ,aAAa,WAAW;IACxB,YAAY;IACZ,aAAa,WAAW;IACxB,aAAa;IACb,qBAAqB,WAAW;IAChC,cAAc;IACd,YAAY,WAAW;IACvB,YAAY;IACZ,aAAa,WAAW;IACxB,aAAa;IACb,eAAe,WAAW;IAG1B,cAAc;IACd,cAAc,WAAW;IACzB,YAAY;IACZ,mBAAmB,WAAW;IAC9B,WAAW;IACX,eAAe,WAAW;IAC1B,YAAY;IACZ,cAAc,WAAW;IACzB,WAAW;IACX,WAAW,WAAW;IACtB,aAAa;IACb,sBAAsB,WAAW;IAGjC,aAAa;IACb,cAAc,WAAW;IACzB,YAAY;IACZ,WAAW,WAAW;IACtB,YAAY;IACZ,cAAc,WAAW;IACzB,YAAY;IACZ,qBAAqB,WAAW;IAChC,YAAY;IACZ,iBAAiB,WAAW;IAC5B,WAAW;IACX,oBAAoB,WAAW;IAC/B,WAAW;IACX,kBAAkB,WAAW;CAC9B;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAwC5D,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,MAAM,CAEtE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/dist/restful/response-codes.js

@@ -0,0 +1,163 @@
+"use strict";
+/**
+ * 统一业务状态码定义
+ *
+ * 规范：
+ * - 所有接口统一返回 HTTP 200
+ * - 通过响应体中的 code 字段判断业务状态
+ * - code 为 6 位数字字符串
+ *
+ * 状态码分类：
+ * - 000xxx: 成功
+ * - 100xxx: 客户端错误（参数、认证、权限等）
+ * - 200xxx: 服务端错误（系统错误、数据库错误等）
+ * - 300xxx: 业务错误（业务规则限制等）
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseCodeMessage = exports.ResponseCode = void 0;
+exports.getResponseMessage = getResponseMessage;
+exports.isSuccess = isSuccess;
+exports.isAuthError = isAuthError;
+exports.isServerError = isServerError;
+exports.isBusinessError = isBusinessError;
+/**
+ * 业务状态码枚举
+ */
+var ResponseCode;
+(function (ResponseCode) {
+    // ========== 成功 ==========
+    /** 操作成功 */
+    ResponseCode["SUCCESS"] = "000000";
+    // ========== 客户端错误 (100xxx) ==========
+    /** 请求参数错误 */
+    ResponseCode["BAD_REQUEST"] = "100400";
+    /** 未认证（未登录） */
+    ResponseCode["UNAUTHORIZED"] = "100401";
+    /** 无权限 */
+    ResponseCode["FORBIDDEN"] = "100403";
+    /** 资源不存在 */
+    ResponseCode["NOT_FOUND"] = "100404";
+    /** 请求方法不允许 */
+    ResponseCode["METHOD_NOT_ALLOWED"] = "100405";
+    /** 请求超时 */
+    ResponseCode["REQUEST_TIMEOUT"] = "100408";
+    /** 请求冲突 */
+    ResponseCode["CONFLICT"] = "100409";
+    /** 请求实体过大 */
+    ResponseCode["PAYLOAD_TOO_LARGE"] = "100413";
+    /** 请求频率过高 */
+    ResponseCode["TOO_MANY_REQUESTS"] = "100429";
+    // ========== 认证相关 (101xxx) ==========
+    /** 令牌无效 */
+    ResponseCode["TOKEN_INVALID"] = "101001";
+    /** 令牌已过期 */
+    ResponseCode["TOKEN_EXPIRED"] = "101002";
+    /** 令牌被撤销 */
+    ResponseCode["TOKEN_REVOKED"] = "101003";
+    /** 刷新令牌无效 */
+    ResponseCode["REFRESH_TOKEN_INVALID"] = "101004";
+    /** 检测到令牌重用 */
+    ResponseCode["TOKEN_REUSED"] = "101005";
+    /** 验证码错误 */
+    ResponseCode["CAPTCHA_ERROR"] = "101006";
+    /** 验证码已过期 */
+    ResponseCode["CAPTCHA_EXPIRED"] = "101007";
+    // ========== 服务端错误 (200xxx) ==========
+    /** 内部服务器错误 */
+    ResponseCode["INTERNAL_ERROR"] = "200500";
+    /** 服务不可用 */
+    ResponseCode["SERVICE_UNAVAILABLE"] = "200503";
+    /** 网关超时 */
+    ResponseCode["GATEWAY_TIMEOUT"] = "200504";
+    /** 数据库错误 */
+    ResponseCode["DATABASE_ERROR"] = "200510";
+    /** 缓存错误 */
+    ResponseCode["CACHE_ERROR"] = "200511";
+    /** 外部服务错误 */
+    ResponseCode["EXTERNAL_SERVICE_ERROR"] = "200520";
+    // ========== 业务错误 (300xxx) ==========
+    /** 业务规则限制 */
+    ResponseCode["BUSINESS_ERROR"] = "300001";
+    /** 数据已存在 */
+    ResponseCode["DATA_EXISTS"] = "300002";
+    /** 数据不存在 */
+    ResponseCode["DATA_NOT_FOUND"] = "300003";
+    /** 操作不允许 */
+    ResponseCode["OPERATION_NOT_ALLOWED"] = "300004";
+    /** 状态不允许 */
+    ResponseCode["STATE_NOT_ALLOWED"] = "300005";
+    /** 余额不足 */
+    ResponseCode["INSUFFICIENT_BALANCE"] = "300006";
+    /** 库存不足 */
+    ResponseCode["INSUFFICIENT_STOCK"] = "300007";
+})(ResponseCode || (exports.ResponseCode = ResponseCode = {}));
+/**
+ * 业务状态码描述映射
+ */
+exports.ResponseCodeMessage = {
+    // 成功
+    [ResponseCode.SUCCESS]: '操作成功',
+    // 客户端错误
+    [ResponseCode.BAD_REQUEST]: '请求参数错误',
+    [ResponseCode.UNAUTHORIZED]: '未认证，请先登录',
+    [ResponseCode.FORBIDDEN]: '无权限访问',
+    [ResponseCode.NOT_FOUND]: '资源不存在',
+    [ResponseCode.METHOD_NOT_ALLOWED]: '请求方法不允许',
+    [ResponseCode.REQUEST_TIMEOUT]: '请求超时',
+    [ResponseCode.CONFLICT]: '请求冲突',
+    [ResponseCode.PAYLOAD_TOO_LARGE]: '请求实体过大',
+    [ResponseCode.TOO_MANY_REQUESTS]: '请求过于频繁，请稍后再试',
+    // 认证相关
+    [ResponseCode.TOKEN_INVALID]: '令牌无效',
+    [ResponseCode.TOKEN_EXPIRED]: '令牌已过期',
+    [ResponseCode.TOKEN_REVOKED]: '令牌已被撤销',
+    [ResponseCode.REFRESH_TOKEN_INVALID]: '刷新令牌无效',
+    [ResponseCode.TOKEN_REUSED]: '检测到令牌重用，会话已撤销',
+    [ResponseCode.CAPTCHA_ERROR]: '验证码错误',
+    [ResponseCode.CAPTCHA_EXPIRED]: '验证码已过期',
+    // 服务端错误
+    [ResponseCode.INTERNAL_ERROR]: '服务器内部错误',
+    [ResponseCode.SERVICE_UNAVAILABLE]: '服务暂不可用',
+    [ResponseCode.GATEWAY_TIMEOUT]: '网关超时',
+    [ResponseCode.DATABASE_ERROR]: '数据库错误',
+    [ResponseCode.CACHE_ERROR]: '缓存错误',
+    [ResponseCode.EXTERNAL_SERVICE_ERROR]: '外部服务错误',
+    // 业务错误
+    [ResponseCode.BUSINESS_ERROR]: '业务规则限制',
+    [ResponseCode.DATA_EXISTS]: '数据已存在',
+    [ResponseCode.DATA_NOT_FOUND]: '数据不存在',
+    [ResponseCode.OPERATION_NOT_ALLOWED]: '操作不允许',
+    [ResponseCode.STATE_NOT_ALLOWED]: '当前状态不允许此操作',
+    [ResponseCode.INSUFFICIENT_BALANCE]: '余额不足',
+    [ResponseCode.INSUFFICIENT_STOCK]: '库存不足',
+};
+/**
+ * 获取状态码对应的描述
+ */
+function getResponseMessage(code) {
+    return exports.ResponseCodeMessage[code] || '未知错误';
+}
+/**
+ * 判断是否为成功状态
+ */
+function isSuccess(code) {
+    return code === ResponseCode.SUCCESS;
+}
+/**
+ * 判断是否为认证错误
+ */
+function isAuthError(code) {
+    return code.startsWith('101');
+}
+/**
+ * 判断是否为服务端错误
+ */
+function isServerError(code) {
+    return code.startsWith('200');
+}
+/**
+ * 判断是否为业务错误
+ */
+function isBusinessError(code) {
+    return code.startsWith('300');
+}

package/dist/restful/response.dto.d.ts

@@ -0,0 +1,52 @@
+import { ResponseCode } from './response-codes';
+/**
+ * 标准API响应格式
+ */
+export declare class ApiResponseDto<T = any> {
+    code: string;
+    message?: string;
+    data?: T;
+    traceId?: string;
+    constructor(partial: Partial<ApiResponseDto<T>>);
+    /**
+     * 创建成功响应
+     */
+    static success<T>(data?: T, message?: string): ApiResponseDto<T>;
+    /**
+     * 创建错误响应
+     */
+    static error<T = any>(code: string | ResponseCode, message?: string, data?: T): ApiResponseDto<T>;
+}
+/**
+ * 错误响应格式
+ */
+export declare class ErrorResponseDto {
+    code: string;
+    message: string;
+    traceId?: string;
+    constructor(code: string, message: string, options?: {
+        traceId?: string;
+    });
+}
+/**
+ * 新的分页响应格式
+ */
+export declare class PaginatedResponseDto<T> extends ApiResponseDto<any> {
+    code: string;
+    msg: string;
+    data: {
+        totalCount: string;
+        pageSize: string;
+        totalPage: string;
+        currentPage: string;
+        list: T[];
+    };
+    ptraceId?: string;
+    constructor(list: T[], total: number, page: number, limit: number, options?: {
+        code?: string;
+        msg?: string;
+        traceId?: string;
+        ptraceId?: string;
+    });
+}
+//# sourceMappingURL=response.dto.d.ts.map

package/dist/restful/response.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.dto.d.ts","sourceRoot":"","sources":["../../src/restful/response.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAsB,MAAM,kBAAkB,CAAC;AAEpE;;GAEG;AACH,qBAAa,cAAc,CAAC,CAAC,GAAG,GAAG;IAMjC,IAAI,EAAE,MAAM,CAAC;IAGb,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,IAAI,CAAC,EAAE,CAAC,CAAC;IAGT,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEL,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAI/C;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC;IAQhE;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC;CAOlG;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAE3B,IAAI,EAAE,MAAM,CAAC;IAGb,OAAO,EAAE,MAAM,CAAC;IAGhB,OAAO,CAAC,EAAE,MAAM,CAAC;gBAGf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CAMJ;AAED;;GAEG;AACH,qBAAa,oBAAoB,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,GAAG,CAAC;IAE9D,IAAI,EAAE,MAAM,CAAY;IAGxB,GAAG,EAAE,MAAM,CAAa;IAgBxB,IAAI,EAAE;QACJ,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,CAAC,EAAE,CAAC;KACX,CAAkF;IAGnF,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAGhB,IAAI,EAAE,CAAC,EAAE,EACT,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;CAeJ"}

package/dist/restful/response.dto.js

@@ -0,0 +1,146 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaginatedResponseDto = exports.ErrorResponseDto = exports.ApiResponseDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const response_codes_1 = require("./response-codes");
+/**
+ * 标准API响应格式
+ */
+class ApiResponseDto {
+    code;
+    message;
+    data;
+    traceId;
+    constructor(partial) {
+        Object.assign(this, partial);
+    }
+    /**
+     * 创建成功响应
+     */
+    static success(data, message) {
+        return new ApiResponseDto({
+            code: response_codes_1.ResponseCode.SUCCESS,
+            message: message || (0, response_codes_1.getResponseMessage)(response_codes_1.ResponseCode.SUCCESS),
+            data: data,
+        });
+    }
+    /**
+     * 创建错误响应
+     */
+    static error(code, message, data) {
+        return new ApiResponseDto({
+            code: String(code),
+            message: message || (0, response_codes_1.getResponseMessage)(code),
+            ...(data === undefined ? {} : { data }),
+        });
+    }
+}
+exports.ApiResponseDto = ApiResponseDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: '响应编码',
+        example: '000000',
+        default: '000000',
+    }),
+    __metadata("design:type", String)
+], ApiResponseDto.prototype, "code", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '响应消息', example: '操作成功' }),
+    __metadata("design:type", String)
+], ApiResponseDto.prototype, "message", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '响应数据' }),
+    __metadata("design:type", Object)
+], ApiResponseDto.prototype, "data", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '追踪ID' }),
+    __metadata("design:type", String)
+], ApiResponseDto.prototype, "traceId", void 0);
+/**
+ * 错误响应格式
+ */
+class ErrorResponseDto {
+    code;
+    message;
+    traceId;
+    constructor(code, message, options) {
+        this.code = code;
+        this.message = message;
+        this.traceId = options?.traceId;
+    }
+}
+exports.ErrorResponseDto = ErrorResponseDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: '响应码', example: '000000' }),
+    __metadata("design:type", String)
+], ErrorResponseDto.prototype, "code", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: '响应消息', example: 'Success' }),
+    __metadata("design:type", String)
+], ErrorResponseDto.prototype, "message", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '追踪ID' }),
+    __metadata("design:type", String)
+], ErrorResponseDto.prototype, "traceId", void 0);
+/**
+ * 新的分页响应格式
+ */
+class PaginatedResponseDto extends ApiResponseDto {
+    code = '000000';
+    msg = 'Success';
+    data = { totalCount: '0', pageSize: '0', totalPage: '0', currentPage: '0', list: [] };
+    ptraceId;
+    constructor(list, total, page, limit, options) {
+        super({});
+        this.code = options?.code || '000000';
+        this.msg = options?.msg || 'Success';
+        this.traceId = options?.traceId;
+        this.ptraceId = options?.ptraceId;
+        this.data = {
+            totalCount: total.toString(),
+            pageSize: limit.toString(),
+            totalPage: Math.ceil(total / limit).toString(),
+            currentPage: page.toString(),
+            list,
+        };
+    }
+}
+exports.PaginatedResponseDto = PaginatedResponseDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: '响应码', example: '000000' }),
+    __metadata("design:type", String)
+], PaginatedResponseDto.prototype, "code", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: '响应消息', example: 'Success' }),
+    __metadata("design:type", String)
+], PaginatedResponseDto.prototype, "msg", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: '分页数据',
+        properties: {
+            totalCount: { type: 'string', description: '总记录数' },
+            pageSize: { type: 'string', description: '每页记录数' },
+            totalPage: { type: 'string', description: '总页数' },
+            currentPage: { type: 'string', description: '当前页码' },
+            list: {
+                type: 'array',
+                items: { type: 'object' },
+                description: '数据列表',
+            },
+        },
+    }),
+    __metadata("design:type", Object)
+], PaginatedResponseDto.prototype, "data", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '父追踪ID' }),
+    __metadata("design:type", String)
+], PaginatedResponseDto.prototype, "ptraceId", void 0);

package/dist/restful/response.interceptor.d.ts

@@ -0,0 +1,17 @@
+import { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { Observable } from 'rxjs';
+/**
+ * 全局响应拦截器
+ * 统一格式化所有API响应
+ */
+export declare class ResponseInterceptor implements NestInterceptor {
+    intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
+}
+/**
+ * 创建响应拦截器提供者
+ */
+export declare const ResponseInterceptorProvider: {
+    provide: string;
+    useClass: typeof ResponseInterceptor;
+};
+//# sourceMappingURL=response.interceptor.d.ts.map

package/dist/restful/response.interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.interceptor.d.ts","sourceRoot":"","sources":["../../src/restful/response.interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EACf,gBAAgB,EAChB,WAAW,EAGZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,UAAU,EAAc,MAAM,MAAM,CAAC;AAI9C;;;GAGG;AACH,qBACa,mBAAoB,YAAW,eAAe;IACzD,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC;CAoEzE;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;CAGvC,CAAC"}

package/dist/restful/response.interceptor.js

@@ -0,0 +1,86 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseInterceptorProvider = exports.ResponseInterceptor = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const response_dto_1 = require("./response.dto");
+/**
+ * 全局响应拦截器
+ * 统一格式化所有API响应
+ */
+let ResponseInterceptor = class ResponseInterceptor {
+    intercept(context, next) {
+        const ctx = context.switchToHttp();
+        const response = ctx.getResponse();
+        return next.handle().pipe((0, operators_1.map)((data) => {
+            // 如果已经是 ApiResponseDto 格式，直接返回
+            if (data instanceof response_dto_1.ApiResponseDto || data instanceof response_dto_1.PaginatedResponseDto) {
+                return data;
+            }
+            // 处理分页数据格式
+            if (data && typeof data === 'object' && 'data' in data && 'meta' in data) {
+                const { data: items, meta } = data;
+                // 检查是否是分页格式 { data: [], meta: { total, page, limit, totalPages } }
+                if (Array.isArray(items) &&
+                    meta &&
+                    typeof meta === 'object' &&
+                    'total' in meta &&
+                    'page' in meta &&
+                    'limit' in meta) {
+                    // 使用新的分页格式
+                    return new response_dto_1.PaginatedResponseDto(items, meta.total, meta.page, meta.limit);
+                }
+            }
+            // 默认成功响应
+            return response_dto_1.ApiResponseDto.success(data);
+        }), (0, operators_1.catchError)((error) => {
+            let status = common_1.HttpStatus.INTERNAL_SERVER_ERROR;
+            let message = 'Internal server error';
+            let code = 'INTERNAL_ERROR';
+            // 处理 HttpException
+            if (error instanceof common_1.HttpException) {
+                status = error.getStatus();
+                const errorResponse = error.getResponse();
+                if (typeof errorResponse === 'string') {
+                    message = errorResponse;
+                }
+                else if (typeof errorResponse === 'object') {
+                    const errorObj = errorResponse;
+                    message = errorObj.message || error.message;
+                    code = errorObj.code || error.name;
+                    return (0, rxjs_1.throwError)(() => new common_1.HttpException(errorResponse, status));
+                }
+            }
+            else {
+                // 处理其他错误
+                message = error.message || 'Unknown error';
+                code = error.name || 'UNKNOWN_ERROR';
+            }
+            // 设置HTTP状态码
+            response.status(status);
+            // 返回统一错误格式
+            const errorResponse = new response_dto_1.ErrorResponseDto(code, message);
+            // 返回标准的HttpException，但使用我们自定义的错误响应格式
+            return (0, rxjs_1.throwError)(() => new common_1.HttpException(errorResponse, status));
+        }));
+    }
+};
+exports.ResponseInterceptor = ResponseInterceptor;
+exports.ResponseInterceptor = ResponseInterceptor = __decorate([
+    (0, common_1.Injectable)()
+], ResponseInterceptor);
+/**
+ * 创建响应拦截器提供者
+ */
+exports.ResponseInterceptorProvider = {
+    provide: core_1.APP_INTERCEPTOR,
+    useClass: ResponseInterceptor,
+};

package/dist/restful/restful.module.d.ts

@@ -0,0 +1,5 @@
+import { DynamicModule } from '@nestjs/common';
+export declare class RestfulModule {
+    static forRoot(): DynamicModule;
+}
+//# sourceMappingURL=restful.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"restful.module.d.ts","sourceRoot":"","sources":["../../src/restful/restful.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,gBAAgB,CAAC;AAG/D,qBAEa,aAAa;IACxB,MAAM,CAAC,OAAO,IAAI,aAAa;CAOhC"}

package/dist/restful/restful.module.js

@@ -0,0 +1,26 @@
+"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 RestfulModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RestfulModule = void 0;
+const common_1 = require("@nestjs/common");
+const response_interceptor_1 = require("./response.interceptor");
+let RestfulModule = RestfulModule_1 = class RestfulModule {
+    static forRoot() {
+        return {
+            module: RestfulModule_1,
+            providers: [response_interceptor_1.ResponseInterceptor, response_interceptor_1.ResponseInterceptorProvider],
+            exports: [response_interceptor_1.ResponseInterceptor],
+        };
+    }
+};
+exports.RestfulModule = RestfulModule;
+exports.RestfulModule = RestfulModule = RestfulModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], RestfulModule);

package/dist/sequelize/index.d.ts

@@ -0,0 +1,4 @@
+export * from './sequelize.config';
+export * from './sequelize.provider';
+export * from './sequelize.module';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sequelize/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC"}