@dofe/infra-common 0.1.1

package/dist/decorators/version/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Version Decorators Module Exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersionDecoratorModule = exports.VersionInterceptor = exports.compareVersions = exports.getVersionFromRequest = exports.isSupportedVersion = exports.SUPPORTED_VERSIONS = exports.VERSION_METADATA_KEY = exports.DEFAULT_API_VERSION = exports.API_VERSION_HEADER = exports.DeprecatedVersion = exports.VersionNeutral = exports.ApiVersion = void 0;
+var version_decorator_1 = require("./version.decorator");
+// Decorators
+Object.defineProperty(exports, "ApiVersion", { enumerable: true, get: function () { return version_decorator_1.ApiVersion; } });
+Object.defineProperty(exports, "VersionNeutral", { enumerable: true, get: function () { return version_decorator_1.VersionNeutral; } });
+Object.defineProperty(exports, "DeprecatedVersion", { enumerable: true, get: function () { return version_decorator_1.DeprecatedVersion; } });
+// Constants
+Object.defineProperty(exports, "API_VERSION_HEADER", { enumerable: true, get: function () { return version_decorator_1.API_VERSION_HEADER; } });
+Object.defineProperty(exports, "DEFAULT_API_VERSION", { enumerable: true, get: function () { return version_decorator_1.DEFAULT_API_VERSION; } });
+Object.defineProperty(exports, "VERSION_METADATA_KEY", { enumerable: true, get: function () { return version_decorator_1.VERSION_METADATA_KEY; } });
+Object.defineProperty(exports, "SUPPORTED_VERSIONS", { enumerable: true, get: function () { return version_decorator_1.SUPPORTED_VERSIONS; } });
+// Utilities
+Object.defineProperty(exports, "isSupportedVersion", { enumerable: true, get: function () { return version_decorator_1.isSupportedVersion; } });
+Object.defineProperty(exports, "getVersionFromRequest", { enumerable: true, get: function () { return version_decorator_1.getVersionFromRequest; } });
+Object.defineProperty(exports, "compareVersions", { enumerable: true, get: function () { return version_decorator_1.compareVersions; } });
+var version_interceptor_1 = require("./version.interceptor");
+Object.defineProperty(exports, "VersionInterceptor", { enumerable: true, get: function () { return version_interceptor_1.VersionInterceptor; } });
+var version_module_1 = require("./version.module");
+Object.defineProperty(exports, "VersionDecoratorModule", { enumerable: true, get: function () { return version_module_1.VersionDecoratorModule; } });
+//# sourceMappingURL=index.js.map

package/dist/decorators/version/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/decorators/version/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,yDAgB6B;AAf3B,aAAa;AACb,+GAAA,UAAU,OAAA;AACV,mHAAA,cAAc,OAAA;AACd,sHAAA,iBAAiB,OAAA;AACjB,YAAY;AACZ,uHAAA,kBAAkB,OAAA;AAClB,wHAAA,mBAAmB,OAAA;AACnB,yHAAA,oBAAoB,OAAA;AACpB,uHAAA,kBAAkB,OAAA;AAGlB,YAAY;AACZ,uHAAA,kBAAkB,OAAA;AAClB,0HAAA,qBAAqB,OAAA;AACrB,oHAAA,eAAe,OAAA;AAGjB,6DAA2D;AAAlD,yHAAA,kBAAkB,OAAA;AAC3B,mDAA0D;AAAjD,wHAAA,sBAAsB,OAAA"}

package/dist/decorators/version/version.decorator.d.ts

@@ -0,0 +1,96 @@
+/**
+ * API Version Decorators
+ *
+ * 提供 API 版本控制装饰器，支持 Header 和 URI 版本控制。
+ * 与当前 api/... 前缀结构兼容，不改变现有路由。
+ *
+ * 版本控制策略:
+ * - 使用 Header: x-api-version 指定版本
+ * - 默认版本: 1 (VERSION_NEUTRAL)
+ * - 支持版本兼容性检查
+ *
+ * @example
+ * ```typescript
+ * // Controller 级别版本控制
+ * @Controller('users')
+ * @ApiVersion('2')
+ * export class UsersV2Controller { ... }
+ *
+ * // Method 级别版本控制
+ * @Get()
+ * @ApiVersion(['1', '2'])  // 支持多版本
+ * async getUsers() { ... }
+ * ```
+ */
+export declare const API_VERSION_HEADER = "x-api-version";
+export declare const DEFAULT_API_VERSION = "1";
+export declare const VERSION_METADATA_KEY = "api:version";
+/**
+ * 当前支持的 API 版本列表
+ */
+export declare const SUPPORTED_VERSIONS: readonly ["1", "2"];
+export type SupportedVersion = (typeof SUPPORTED_VERSIONS)[number];
+/**
+ * @ApiVersion - API 版本控制装饰器
+ *
+ * 使用 NestJS 内置的 @Version 装饰器，配合 Header 版本控制策略。
+ *
+ * @param version - 版本号或版本号数组
+ *
+ * @example
+ * ```typescript
+ * // 单版本
+ * @ApiVersion('2')
+ * @Controller('users')
+ * export class UsersV2Controller { ... }
+ *
+ * // 多版本兼容
+ * @Get()
+ * @ApiVersion(['1', '2'])
+ * async getUsers() { ... }
+ * ```
+ */
+export declare function ApiVersion(version: SupportedVersion | SupportedVersion[]): MethodDecorator & ClassDecorator;
+/**
+ * @VersionNeutral - 版本中立装饰器
+ *
+ * 标记方法或控制器不受版本控制影响，适用于所有版本。
+ *
+ * @example
+ * ```typescript
+ * @VersionNeutral()
+ * @Get('health')
+ * async healthCheck() { ... }
+ * ```
+ */
+export declare function VersionNeutral(): MethodDecorator & ClassDecorator;
+/**
+ * @DeprecatedVersion - 废弃版本警告装饰器
+ *
+ * 标记即将废弃的 API 版本，会在响应头中添加 Deprecation 警告。
+ *
+ * @param message - 废弃说明
+ * @param sunsetDate - 停止服务日期 (可选)
+ *
+ * @example
+ * ```typescript
+ * @DeprecatedVersion('请升级到 v2 API', '2025-06-01')
+ * @Get()
+ * async getUsers() { ... }
+ * ```
+ */
+export declare function DeprecatedVersion(message: string, sunsetDate?: string): MethodDecorator;
+/**
+ * 检查版本是否受支持
+ */
+export declare function isSupportedVersion(version: string): version is SupportedVersion;
+/**
+ * 获取版本从请求头
+ */
+export declare function getVersionFromRequest(request: any): string;
+/**
+ * 比较版本号
+ * @returns -1 if v1 < v2, 0 if v1 == v2, 1 if v1 > v2
+ */
+export declare function compareVersions(v1: string, v2: string): number;
+//# sourceMappingURL=version.decorator.d.ts.map

package/dist/decorators/version/version.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.decorator.d.ts","sourceRoot":"","sources":["../../../src/decorators/version/version.decorator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AASH,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAClD,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,oBAAoB,gBAAgB,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,kBAAkB,qBAAsB,CAAC;AACtD,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAMnE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,GAC7C,eAAe,GAAG,cAAc,CAelC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,IAAI,eAAe,GAAG,cAAc,CAKjE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,GAClB,eAAe,CAajB;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,GACd,OAAO,IAAI,gBAAgB,CAE7B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM,CAE1D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAM9D"}

package/dist/decorators/version/version.decorator.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * API Version Decorators
+ *
+ * 提供 API 版本控制装饰器，支持 Header 和 URI 版本控制。
+ * 与当前 api/... 前缀结构兼容，不改变现有路由。
+ *
+ * 版本控制策略:
+ * - 使用 Header: x-api-version 指定版本
+ * - 默认版本: 1 (VERSION_NEUTRAL)
+ * - 支持版本兼容性检查
+ *
+ * @example
+ * ```typescript
+ * // Controller 级别版本控制
+ * @Controller('users')
+ * @ApiVersion('2')
+ * export class UsersV2Controller { ... }
+ *
+ * // Method 级别版本控制
+ * @Get()
+ * @ApiVersion(['1', '2'])  // 支持多版本
+ * async getUsers() { ... }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUPPORTED_VERSIONS = exports.VERSION_METADATA_KEY = exports.DEFAULT_API_VERSION = exports.API_VERSION_HEADER = void 0;
+exports.ApiVersion = ApiVersion;
+exports.VersionNeutral = VersionNeutral;
+exports.DeprecatedVersion = DeprecatedVersion;
+exports.isSupportedVersion = isSupportedVersion;
+exports.getVersionFromRequest = getVersionFromRequest;
+exports.compareVersions = compareVersions;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+// ============================================================================
+// Constants
+// ============================================================================
+exports.API_VERSION_HEADER = 'x-api-version';
+exports.DEFAULT_API_VERSION = '1';
+exports.VERSION_METADATA_KEY = 'api:version';
+/**
+ * 当前支持的 API 版本列表
+ */
+exports.SUPPORTED_VERSIONS = ['1', '2'];
+// ============================================================================
+// Decorators
+// ============================================================================
+/**
+ * @ApiVersion - API 版本控制装饰器
+ *
+ * 使用 NestJS 内置的 @Version 装饰器，配合 Header 版本控制策略。
+ *
+ * @param version - 版本号或版本号数组
+ *
+ * @example
+ * ```typescript
+ * // 单版本
+ * @ApiVersion('2')
+ * @Controller('users')
+ * export class UsersV2Controller { ... }
+ *
+ * // 多版本兼容
+ * @Get()
+ * @ApiVersion(['1', '2'])
+ * async getUsers() { ... }
+ * ```
+ */
+function ApiVersion(version) {
+    return (0, common_1.applyDecorators)((0, common_1.Version)(version), (0, common_1.SetMetadata)(exports.VERSION_METADATA_KEY, version), (0, swagger_1.ApiHeader)({
+        name: exports.API_VERSION_HEADER,
+        description: `API 版本号 (支持: ${exports.SUPPORTED_VERSIONS.join(', ')})`,
+        required: false,
+        schema: {
+            type: 'string',
+            default: exports.DEFAULT_API_VERSION,
+            enum: [...exports.SUPPORTED_VERSIONS],
+        },
+    }));
+}
+/**
+ * @VersionNeutral - 版本中立装饰器
+ *
+ * 标记方法或控制器不受版本控制影响，适用于所有版本。
+ *
+ * @example
+ * ```typescript
+ * @VersionNeutral()
+ * @Get('health')
+ * async healthCheck() { ... }
+ * ```
+ */
+function VersionNeutral() {
+    return (0, common_1.applyDecorators)((0, common_1.Version)('neutral'), // VERSION_NEUTRAL
+    (0, common_1.SetMetadata)(exports.VERSION_METADATA_KEY, 'neutral'));
+}
+/**
+ * @DeprecatedVersion - 废弃版本警告装饰器
+ *
+ * 标记即将废弃的 API 版本，会在响应头中添加 Deprecation 警告。
+ *
+ * @param message - 废弃说明
+ * @param sunsetDate - 停止服务日期 (可选)
+ *
+ * @example
+ * ```typescript
+ * @DeprecatedVersion('请升级到 v2 API', '2025-06-01')
+ * @Get()
+ * async getUsers() { ... }
+ * ```
+ */
+function DeprecatedVersion(message, sunsetDate) {
+    return (target, propertyKey, descriptor) => {
+        (0, common_1.SetMetadata)('api:deprecated', { message, sunsetDate })(target, propertyKey, descriptor);
+        return descriptor;
+    };
+}
+// ============================================================================
+// Utilities
+// ============================================================================
+/**
+ * 检查版本是否受支持
+ */
+function isSupportedVersion(version) {
+    return exports.SUPPORTED_VERSIONS.includes(version);
+}
+/**
+ * 获取版本从请求头
+ */
+function getVersionFromRequest(request) {
+    return request.headers?.[exports.API_VERSION_HEADER] || exports.DEFAULT_API_VERSION;
+}
+/**
+ * 比较版本号
+ * @returns -1 if v1 < v2, 0 if v1 == v2, 1 if v1 > v2
+ */
+function compareVersions(v1, v2) {
+    const num1 = parseInt(v1, 10);
+    const num2 = parseInt(v2, 10);
+    if (num1 < num2)
+        return -1;
+    if (num1 > num2)
+        return 1;
+    return 0;
+}
+//# sourceMappingURL=version.decorator.js.map

package/dist/decorators/version/version.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.decorator.js","sourceRoot":"","sources":["../../../src/decorators/version/version.decorator.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;;AA2CH,gCAiBC;AAcD,wCAKC;AAiBD,8CAgBC;AASD,gDAIC;AAKD,sDAEC;AAMD,0CAMC;AA9ID,2CAAuE;AACvE,6CAA4C;AAE5C,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAElE,QAAA,kBAAkB,GAAG,eAAe,CAAC;AACrC,QAAA,mBAAmB,GAAG,GAAG,CAAC;AAC1B,QAAA,oBAAoB,GAAG,aAAa,CAAC;AAElD;;GAEG;AACU,QAAA,kBAAkB,GAAG,CAAC,GAAG,EAAE,GAAG,CAAU,CAAC;AAGtD,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,UAAU,CACxB,OAA8C;IAE9C,OAAO,IAAA,wBAAe,EACpB,IAAA,gBAAO,EAAC,OAAO,CAAC,EAChB,IAAA,oBAAW,EAAC,4BAAoB,EAAE,OAAO,CAAC,EAC1C,IAAA,mBAAS,EAAC;QACR,IAAI,EAAE,0BAAkB;QACxB,WAAW,EAAE,gBAAgB,0BAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAC7D,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,2BAAmB;YAC5B,IAAI,EAAE,CAAC,GAAG,0BAAkB,CAAC;SAC9B;KACF,CAAC,CACH,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,cAAc;IAC5B,OAAO,IAAA,wBAAe,EACpB,IAAA,gBAAO,EAAC,SAAgB,CAAC,EAAE,kBAAkB;IAC7C,IAAA,oBAAW,EAAC,4BAAoB,EAAE,SAAS,CAAC,CAC7C,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,iBAAiB,CAC/B,OAAe,EACf,UAAmB;IAEnB,OAAO,CACL,MAAW,EACX,WAA4B,EAC5B,UAA8B,EAC9B,EAAE;QACF,IAAA,oBAAW,EAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CACpD,MAAM,EACN,WAAW,EACX,UAAU,CACX,CAAC;QACF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E;;GAEG;AACH,SAAgB,kBAAkB,CAChC,OAAe;IAEf,OAAO,0BAAkB,CAAC,QAAQ,CAAC,OAA2B,CAAC,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,OAAY;IAChD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,0BAAkB,CAAC,IAAI,2BAAmB,CAAC;AACtE,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAAC,EAAU,EAAE,EAAU;IACpD,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC9B,IAAI,IAAI,GAAG,IAAI;QAAE,OAAO,CAAC,CAAC,CAAC;IAC3B,IAAI,IAAI,GAAG,IAAI;QAAE,OAAO,CAAC,CAAC;IAC1B,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/decorators/version/version.interceptor.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Version Interceptor
+ *
+ * 拦截器实现，处理 API 版本控制逻辑：
+ * - 添加版本响应头
+ * - 处理废弃版本警告
+ * - 版本日志记录
+ */
+import { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+import { Observable } from 'rxjs';
+import { Logger } from 'winston';
+export declare class VersionInterceptor implements NestInterceptor {
+    private readonly reflector;
+    private readonly logger;
+    constructor(reflector: Reflector, logger: Logger);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
+}
+//# sourceMappingURL=version.interceptor.d.ts.map

package/dist/decorators/version/version.interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.interceptor.d.ts","sourceRoot":"","sources":["../../../src/decorators/version/version.interceptor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAEL,eAAe,EACf,gBAAgB,EAChB,WAAW,EAEZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAGlC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AASjC,qBACa,kBAAmB,YAAW,eAAe;IAEtD,OAAO,CAAC,QAAQ,CAAC,SAAS;IACO,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADvC,SAAS,EAAE,SAAS,EACa,MAAM,EAAE,MAAM;IAGlE,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC;CA4DzE"}

package/dist/decorators/version/version.interceptor.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * Version Interceptor
+ *
+ * 拦截器实现，处理 API 版本控制逻辑：
+ * - 添加版本响应头
+ * - 处理废弃版本警告
+ * - 版本日志记录
+ */
+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.VersionInterceptor = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const operators_1 = require("rxjs/operators");
+const nest_winston_1 = require("nest-winston");
+const winston_1 = require("winston");
+const version_decorator_1 = require("./version.decorator");
+let VersionInterceptor = class VersionInterceptor {
+    reflector;
+    logger;
+    constructor(reflector, logger) {
+        this.reflector = reflector;
+        this.logger = logger;
+    }
+    intercept(context, next) {
+        const request = context.switchToHttp().getRequest();
+        const response = context.switchToHttp().getResponse();
+        const handler = context.getHandler();
+        const controller = context.getClass();
+        // 获取请求的版本
+        const requestVersion = request.headers?.[version_decorator_1.API_VERSION_HEADER] || version_decorator_1.DEFAULT_API_VERSION;
+        // 获取方法或控制器的版本元数据
+        const methodVersion = this.reflector.get(version_decorator_1.VERSION_METADATA_KEY, handler);
+        const controllerVersion = this.reflector.get(version_decorator_1.VERSION_METADATA_KEY, controller);
+        // 获取废弃信息
+        const deprecatedInfo = this.reflector.get('api:deprecated', handler);
+        // 添加版本响应头
+        response.header('x-api-version', requestVersion);
+        response.header('x-supported-versions', version_decorator_1.SUPPORTED_VERSIONS.join(', '));
+        // 处理废弃版本警告
+        if (deprecatedInfo) {
+            response.header('Deprecation', 'true');
+            response.header('X-Deprecation-Message', deprecatedInfo.message);
+            if (deprecatedInfo.sunsetDate) {
+                response.header('Sunset', deprecatedInfo.sunsetDate);
+            }
+            this.logger.warn('Deprecated API version used', {
+                path: request.url,
+                method: request.method,
+                version: requestVersion,
+                message: deprecatedInfo.message,
+                sunsetDate: deprecatedInfo.sunsetDate,
+            });
+        }
+        return next.handle().pipe((0, operators_1.tap)(() => {
+            // 可选: 记录版本使用日志
+            this.logger.debug('API request processed', {
+                path: request.url,
+                method: request.method,
+                version: requestVersion,
+                controllerVersion,
+                methodVersion,
+            });
+        }));
+    }
+};
+exports.VersionInterceptor = VersionInterceptor;
+exports.VersionInterceptor = VersionInterceptor = __decorate([
+    (0, common_1.Injectable)(),
+    __param(1, (0, common_1.Inject)(nest_winston_1.WINSTON_MODULE_PROVIDER)),
+    __metadata("design:paramtypes", [core_1.Reflector,
+        winston_1.Logger])
+], VersionInterceptor);
+//# sourceMappingURL=version.interceptor.js.map

package/dist/decorators/version/version.interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.interceptor.js","sourceRoot":"","sources":["../../../src/decorators/version/version.interceptor.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;AAEH,2CAMwB;AACxB,uCAAyC;AAEzC,8CAAqC;AACrC,+CAAuD;AACvD,qCAAiC;AAEjC,2DAK6B;AAGtB,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAEV;IACiC;IAFpD,YACmB,SAAoB,EACa,MAAc;QAD/C,cAAS,GAAT,SAAS,CAAW;QACa,WAAM,GAAN,MAAM,CAAQ;IAC/D,CAAC;IAEJ,SAAS,CAAC,OAAyB,EAAE,IAAiB;QACpD,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,CAAC;QACpD,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,WAAW,EAAE,CAAC;QACtD,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QAEtC,UAAU;QACV,MAAM,cAAc,GAClB,OAAO,CAAC,OAAO,EAAE,CAAC,sCAAkB,CAAC,IAAI,uCAAmB,CAAC;QAE/D,iBAAiB;QACjB,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CACtC,wCAAoB,EACpB,OAAO,CACR,CAAC;QACF,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAC1C,wCAAoB,EACpB,UAAU,CACX,CAAC;QAEF,SAAS;QACT,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAGtC,gBAAgB,EAAE,OAAO,CAAC,CAAC;QAE9B,UAAU;QACV,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;QACjD,QAAQ,CAAC,MAAM,CAAC,sBAAsB,EAAE,sCAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAEvE,WAAW;QACX,IAAI,cAAc,EAAE,CAAC;YACnB,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;YACvC,QAAQ,CAAC,MAAM,CAAC,uBAAuB,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;YACjE,IAAI,cAAc,CAAC,UAAU,EAAE,CAAC;gBAC9B,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;YACvD,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE;gBAC9C,IAAI,EAAE,OAAO,CAAC,GAAG;gBACjB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,OAAO,EAAE,cAAc;gBACvB,OAAO,EAAE,cAAc,CAAC,OAAO;gBAC/B,UAAU,EAAE,cAAc,CAAC,UAAU;aACtC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CACvB,IAAA,eAAG,EAAC,GAAG,EAAE;YACP,eAAe;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE;gBACzC,IAAI,EAAE,OAAO,CAAC,GAAG;gBACjB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,OAAO,EAAE,cAAc;gBACvB,iBAAiB;gBACjB,aAAa;aACd,CAAC,CAAC;QACL,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;CACF,CAAA;AAlEY,gDAAkB;6BAAlB,kBAAkB;IAD9B,IAAA,mBAAU,GAAE;IAIR,WAAA,IAAA,eAAM,EAAC,sCAAuB,CAAC,CAAA;qCADJ,gBAAS;QACqB,gBAAM;GAHvD,kBAAkB,CAkE9B"}

package/dist/decorators/version/version.module.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Version Decorator Module
+ *
+ * 提供 API 版本控制功能的全局模块。
+ */
+export declare class VersionDecoratorModule {
+}
+//# sourceMappingURL=version.module.d.ts.map

package/dist/decorators/version/version.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.module.d.ts","sourceRoot":"","sources":["../../../src/decorators/version/version.module.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,qBAUa,sBAAsB;CAAG"}

package/dist/decorators/version/version.module.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Version Decorator Module
+ *
+ * 提供 API 版本控制功能的全局模块。
+ */
+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.VersionDecoratorModule = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const version_interceptor_1 = require("./version.interceptor");
+let VersionDecoratorModule = class VersionDecoratorModule {
+};
+exports.VersionDecoratorModule = VersionDecoratorModule;
+exports.VersionDecoratorModule = VersionDecoratorModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        providers: [
+            {
+                provide: core_1.APP_INTERCEPTOR,
+                useClass: version_interceptor_1.VersionInterceptor,
+            },
+        ],
+        exports: [],
+    })
+], VersionDecoratorModule);
+//# sourceMappingURL=version.module.js.map

package/dist/decorators/version/version.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.module.js","sourceRoot":"","sources":["../../../src/decorators/version/version.module.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;AAEH,2CAAgD;AAChD,uCAA+C;AAC/C,+DAA2D;AAYpD,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;CAAG,CAAA;AAAzB,wDAAsB;iCAAtB,sBAAsB;IAVlC,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,SAAS,EAAE;YACT;gBACE,OAAO,EAAE,sBAAe;gBACxB,QAAQ,EAAE,wCAAkB;aAC7B;SACF;QACD,OAAO,EAAE,EAAE;KACZ,CAAC;GACW,sBAAsB,CAAG"}

package/dist/encryption.service.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 加密服务
+ * 提供对称加密/解密功能，用于敏感数据保护
+ */
+export declare class EncryptionService {
+    /**
+     * 加密数据
+     */
+    encrypt(data: string): string;
+    /**
+     * 解密数据
+     */
+    decrypt(encrypted: string): string;
+}
+//# sourceMappingURL=encryption.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.service.d.ts","sourceRoot":"","sources":["../src/encryption.service.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBACa,iBAAiB;IAC5B;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAK7B;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAInC"}

package/dist/encryption.service.js

@@ -0,0 +1,35 @@
+"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.EncryptionService = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * 加密服务
+ * 提供对称加密/解密功能，用于敏感数据保护
+ */
+let EncryptionService = class EncryptionService {
+    /**
+     * 加密数据
+     */
+    encrypt(data) {
+        // TODO: 实现实际加密逻辑
+        return data;
+    }
+    /**
+     * 解密数据
+     */
+    decrypt(encrypted) {
+        // TODO: 实现实际解密逻辑
+        return encrypted;
+    }
+};
+exports.EncryptionService = EncryptionService;
+exports.EncryptionService = EncryptionService = __decorate([
+    (0, common_1.Injectable)()
+], EncryptionService);
+//# sourceMappingURL=encryption.service.js.map

package/dist/encryption.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.service.js","sourceRoot":"","sources":["../src/encryption.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AAE5C;;;GAGG;AAEI,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAC5B;;OAEG;IACH,OAAO,CAAC,IAAY;QAClB,iBAAiB;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,SAAiB;QACvB,iBAAiB;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;CACF,CAAA;AAhBY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,mBAAU,GAAE;GACA,iBAAiB,CAgB7B"}

package/dist/enums/action.enum.d.ts

@@ -0,0 +1,8 @@
+export declare enum Action {
+    Manage = "manage",
+    Create = "create",
+    Read = "read",
+    Update = "update",
+    Delete = "delete"
+}
+//# sourceMappingURL=action.enum.d.ts.map

package/dist/enums/action.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.enum.d.ts","sourceRoot":"","sources":["../../src/enums/action.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,MAAM;IAChB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB"}

package/dist/enums/action.enum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Action = void 0;
+var Action;
+(function (Action) {
+    Action["Manage"] = "manage";
+    Action["Create"] = "create";
+    Action["Read"] = "read";
+    Action["Update"] = "update";
+    Action["Delete"] = "delete";
+})(Action || (exports.Action = Action = {}));
+//# sourceMappingURL=action.enum.js.map

package/dist/enums/action.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.enum.js","sourceRoot":"","sources":["../../src/enums/action.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,MAMX;AAND,WAAY,MAAM;IAChB,2BAAiB,CAAA;IACjB,2BAAiB,CAAA;IACjB,uBAAa,CAAA;IACb,2BAAiB,CAAA;IACjB,2BAAiB,CAAA;AACnB,CAAC,EANW,MAAM,sBAAN,MAAM,QAMjB"}

package/dist/enums/error-codes.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Error Codes Bridge File
+ * 错误码桥接文件
+ *
+ * Re-exports error codes from @repo/contracts and provides
+ * backward-compatible ErrorMessageEnums for existing code.
+ *
+ * Migration Guide:
+ * - New code: import { UserErrorCode } from '@dofe/infra-contracts';
+ * - New code: import { apiError } from '@/filter/exception/api.exception';
+ */
+export { ApiErrorCode, UserErrorCode, CommonErrorCode, AllErrorTypes, AllErrorHttpStatus, getErrorType, getHttpStatus, } from '@dofe/infra-contracts';
+/**
+ * Error Message Definition Type
+ * Note: errorCode is now a string but numeric representation is kept for backward compatibility
+ */
+export interface ErrorMessageDefinition {
+    errorCode: number;
+    httpStatus: number;
+    message: string;
+}
+/**
+ * ErrorMessageEnums - Backward compatible mapping
+ * 向后兼容的错误消息映射
+ *
+ * @deprecated Use @repo/contracts/errors directly for new code
+ */
+export declare const ErrorMessageEnums: Record<string, ErrorMessageDefinition>;
+/**
+ * Type for ErrorMessageEnums keys
+ */
+export type ErrorType = keyof typeof ErrorMessageEnums;
+//# sourceMappingURL=error-codes.d.ts.map

package/dist/enums/error-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/enums/error-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,YAAY,EACZ,aAAa,EACb,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,aAAa,GACd,MAAM,uBAAuB,CAAC;AAI/B;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AA0BD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,wCAA8B,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,iBAAiB,CAAC"}

package/dist/enums/error-codes.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * Error Codes Bridge File
+ * 错误码桥接文件
+ *
+ * Re-exports error codes from @repo/contracts and provides
+ * backward-compatible ErrorMessageEnums for existing code.
+ *
+ * Migration Guide:
+ * - New code: import { UserErrorCode } from '@dofe/infra-contracts';
+ * - New code: import { apiError } from '@/filter/exception/api.exception';
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorMessageEnums = exports.getHttpStatus = exports.getErrorType = exports.AllErrorHttpStatus = exports.AllErrorTypes = exports.CommonErrorCode = exports.UserErrorCode = exports.ApiErrorCode = void 0;
+// Re-export all error codes from @dofe/infra-contracts
+var infra_contracts_1 = require("@dofe/infra-contracts");
+Object.defineProperty(exports, "ApiErrorCode", { enumerable: true, get: function () { return infra_contracts_1.ApiErrorCode; } });
+Object.defineProperty(exports, "UserErrorCode", { enumerable: true, get: function () { return infra_contracts_1.UserErrorCode; } });
+Object.defineProperty(exports, "CommonErrorCode", { enumerable: true, get: function () { return infra_contracts_1.CommonErrorCode; } });
+Object.defineProperty(exports, "AllErrorTypes", { enumerable: true, get: function () { return infra_contracts_1.AllErrorTypes; } });
+Object.defineProperty(exports, "AllErrorHttpStatus", { enumerable: true, get: function () { return infra_contracts_1.AllErrorHttpStatus; } });
+Object.defineProperty(exports, "getErrorType", { enumerable: true, get: function () { return infra_contracts_1.getErrorType; } });
+Object.defineProperty(exports, "getHttpStatus", { enumerable: true, get: function () { return infra_contracts_1.getHttpStatus; } });
+const infra_contracts_2 = require("@dofe/infra-contracts");
+/**
+ * Generate ErrorMessageEnums from @repo/contracts
+ * 从 @repo/contracts 生成 ErrorMessageEnums
+ *
+ * This provides backward compatibility with the old error system.
+ * The message is just the errorType - actual messages come from i18n.
+ */
+function generateErrorMessageEnums() {
+    const result = {};
+    for (const [codeStr, errorType] of Object.entries(infra_contracts_2.AllErrorTypes)) {
+        const code = Number(codeStr);
+        const httpStatus = infra_contracts_2.AllErrorHttpStatus[codeStr] ?? 200;
+        result[errorType] = {
+            errorCode: code,
+            httpStatus,
+            message: errorType, // Message comes from i18n, this is just fallback
+        };
+    }
+    return result;
+}
+/**
+ * ErrorMessageEnums - Backward compatible mapping
+ * 向后兼容的错误消息映射
+ *
+ * @deprecated Use @repo/contracts/errors directly for new code
+ */
+exports.ErrorMessageEnums = generateErrorMessageEnums();
+//# sourceMappingURL=error-codes.js.map

package/dist/enums/error-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.js","sourceRoot":"","sources":["../../src/enums/error-codes.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,uDAAuD;AACvD,yDAQ+B;AAP7B,+GAAA,YAAY,OAAA;AACZ,gHAAA,aAAa,OAAA;AACb,kHAAA,eAAe,OAAA;AACf,gHAAA,aAAa,OAAA;AACb,qHAAA,kBAAkB,OAAA;AAClB,+GAAA,YAAY,OAAA;AACZ,gHAAA,aAAa,OAAA;AAGf,2DAA0E;AAY1E;;;;;;GAMG;AACH,SAAS,yBAAyB;IAChC,MAAM,MAAM,GAA2C,EAAE,CAAC;IAE1D,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,+BAAa,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,UAAU,GAAG,oCAAkB,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC;QAEtD,MAAM,CAAC,SAAS,CAAC,GAAG;YAClB,SAAS,EAAE,IAAI;YACf,UAAU;YACV,OAAO,EAAE,SAAS,EAAE,iDAAiD;SACtE,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACU,QAAA,iBAAiB,GAAG,yBAAyB,EAAE,CAAC"}

package/dist/enums/role.enum.d.ts

@@ -0,0 +1,5 @@
+export declare enum Role {
+    User = "user",
+    Admin = "admin"
+}
+//# sourceMappingURL=role.enum.d.ts.map

package/dist/enums/role.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role.enum.d.ts","sourceRoot":"","sources":["../../src/enums/role.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,IAAI;IACd,IAAI,SAAS;IACb,KAAK,UAAU;CAChB"}