@dofe/infra-common 0.1.1

package/dist/config/vendor.config.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * Vendor Configuration - AI 提供商配置
+ *
+ * 定义各 AI 提供商的 API 端点和认证方式
+ * 支持 60+ 提供商，与 provider.schema.ts 保持同步
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VENDOR_CONFIGS = void 0;
+exports.createVendorConfigFromUrl = createVendorConfigFromUrl;
+exports.getSupportedVendors = getSupportedVendors;
+exports.isVendorSupported = isVendorSupported;
+exports.getVendorConfig = getVendorConfig;
+exports.getVendorConfigWithCustomUrl = getVendorConfigWithCustomUrl;
+const infra_contracts_1 = require("@dofe/infra-contracts");
+/**
+ * 根据 API 类型获取认证配置
+ */
+function getAuthConfig(apiType) {
+    switch (apiType) {
+        case 'anthropic':
+            return {
+                authHeader: 'x-api-key',
+                authFormat: (key) => key,
+            };
+        case 'gemini':
+            return {
+                authHeader: 'x-goog-api-key',
+                authFormat: (key) => key,
+            };
+        case 'azure-openai':
+            return {
+                authHeader: 'api-key',
+                authFormat: (key) => key,
+            };
+        case 'aws-bedrock':
+            // AWS Bedrock uses IAM credentials, not API keys
+            return {
+                authHeader: 'Authorization',
+                authFormat: (key) => `Bearer ${key}`,
+            };
+        case 'vertexai':
+            return {
+                authHeader: 'Authorization',
+                authFormat: (key) => `Bearer ${key}`,
+            };
+        // OpenAI-compatible APIs (openai, openai-response, ollama, new-api, gateway)
+        default:
+            return {
+                authHeader: 'Authorization',
+                authFormat: (key) => `Bearer ${key}`,
+            };
+    }
+}
+/**
+ * 从 URL 解析主机名和基础路径
+ */
+function parseApiHost(apiHost) {
+    if (!apiHost) {
+        return { host: '', basePath: '' };
+    }
+    try {
+        const url = new URL(apiHost);
+        return {
+            host: url.host,
+            basePath: url.pathname === '/' ? '' : url.pathname,
+        };
+    }
+    catch {
+        // 如果不是有效 URL，假设是主机名
+        return { host: apiHost, basePath: '' };
+    }
+}
+/**
+ * 从 PROVIDER_CONFIGS 动态生成 VENDOR_CONFIGS
+ * 支持所有 60+ 提供商
+ */
+exports.VENDOR_CONFIGS = Object.entries(infra_contracts_1.PROVIDER_CONFIGS).reduce((acc, [vendor, config]) => {
+    const { host, basePath } = parseApiHost(config.apiHost);
+    const authConfig = getAuthConfig(config.apiType);
+    acc[vendor] = {
+        host,
+        basePath,
+        ...authConfig,
+        apiType: config.apiType,
+    };
+    return acc;
+}, {});
+/**
+ * 从自定义 URL 创建 VendorConfig
+ * 用于支持自定义 endpoint
+ */
+function createVendorConfigFromUrl(customUrl, apiType = 'openai') {
+    const { host, basePath } = parseApiHost(customUrl);
+    const authConfig = getAuthConfig(apiType);
+    return {
+        host,
+        basePath,
+        ...authConfig,
+        apiType,
+    };
+}
+/**
+ * 获取支持的 vendor 列表
+ */
+function getSupportedVendors() {
+    return Object.keys(exports.VENDOR_CONFIGS);
+}
+/**
+ * 检查 vendor 是否支持
+ * 注意：即使 vendor 不在预定义列表中，如果有自定义 baseUrl 也可以支持
+ */
+function isVendorSupported(vendor) {
+    return vendor in exports.VENDOR_CONFIGS || vendor === 'custom';
+}
+/**
+ * 获取 vendor 配置
+ */
+function getVendorConfig(vendor) {
+    return exports.VENDOR_CONFIGS[vendor];
+}
+/**
+ * 获取 vendor 配置，支持自定义 URL 覆盖
+ * 如果提供了 customBaseUrl，将使用自定义 URL 创建配置
+ */
+function getVendorConfigWithCustomUrl(vendor, customBaseUrl, apiType) {
+    // 如果有自定义 URL，使用自定义配置
+    if (customBaseUrl) {
+        const baseConfig = exports.VENDOR_CONFIGS[vendor];
+        const effectiveApiType = apiType || baseConfig?.apiType || 'openai';
+        return createVendorConfigFromUrl(customBaseUrl, effectiveApiType);
+    }
+    // 否则使用默认配置
+    return exports.VENDOR_CONFIGS[vendor];
+}
+//# sourceMappingURL=vendor.config.js.map

package/dist/config/vendor.config.js.map

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

package/dist/decorators/api-key/api-key.decorator.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 允许 API Key 访问的元数据键
+ */
+export declare const ALLOW_API_KEY_KEY: "allowApiKey";
+/**
+ * 允许 API Key 访问装饰器
+ * 标记可以使用 API Key 跳过部分验证的端点
+ *
+ * @example
+ * ```typescript
+ * @TsRestHandler(skillC.list)
+ * @AllowApiKey()
+ * @TenantScope()
+ * @RequirePermissions(PERMISSION.SKILL_READ)
+ * async listSkills(@Req() req: AuthenticatedRequest) {
+ *   // ...
+ * }
+ * ```
+ *
+ * 配合 ApiKeyGuard 使用，需要设置以下环境变量：
+ * - INTERNAL_API_KEYS: API Key 列表，多个用逗号分隔（必填）
+ * - INTERNAL_API_REQUIRE_TENANT: (可选) 是否强制要求租户 Header，默认 false
+ */
+export declare const AllowApiKey: () => import("@nestjs/common").CustomDecorator<"allowApiKey">;
+//# sourceMappingURL=api-key.decorator.d.ts.map

package/dist/decorators/api-key/api-key.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key.decorator.d.ts","sourceRoot":"","sources":["../../../src/decorators/api-key/api-key.decorator.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAG,aAAsB,CAAC;AAExD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,WAAW,+DAA6C,CAAC"}

package/dist/decorators/api-key/api-key.decorator.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AllowApiKey = exports.ALLOW_API_KEY_KEY = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * 允许 API Key 访问的元数据键
+ */
+exports.ALLOW_API_KEY_KEY = 'allowApiKey';
+/**
+ * 允许 API Key 访问装饰器
+ * 标记可以使用 API Key 跳过部分验证的端点
+ *
+ * @example
+ * ```typescript
+ * @TsRestHandler(skillC.list)
+ * @AllowApiKey()
+ * @TenantScope()
+ * @RequirePermissions(PERMISSION.SKILL_READ)
+ * async listSkills(@Req() req: AuthenticatedRequest) {
+ *   // ...
+ * }
+ * ```
+ *
+ * 配合 ApiKeyGuard 使用，需要设置以下环境变量：
+ * - INTERNAL_API_KEYS: API Key 列表，多个用逗号分隔（必填）
+ * - INTERNAL_API_REQUIRE_TENANT: (可选) 是否强制要求租户 Header，默认 false
+ */
+const AllowApiKey = () => (0, common_1.SetMetadata)(exports.ALLOW_API_KEY_KEY, true);
+exports.AllowApiKey = AllowApiKey;
+//# sourceMappingURL=api-key.decorator.js.map

package/dist/decorators/api-key/api-key.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key.decorator.js","sourceRoot":"","sources":["../../../src/decorators/api-key/api-key.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAA6C;AAE7C;;GAEG;AACU,QAAA,iBAAiB,GAAG,aAAsB,CAAC;AAExD;;;;;;;;;;;;;;;;;;GAkBG;AACI,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,IAAA,oBAAW,EAAC,yBAAiB,EAAE,IAAI,CAAC,CAAC;AAAzD,QAAA,WAAW,eAA8C"}

package/dist/decorators/api-key/index.d.ts

@@ -0,0 +1,2 @@
+export * from './api-key.decorator';
+//# sourceMappingURL=index.d.ts.map

package/dist/decorators/api-key/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/decorators/api-key/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/decorators/api-key/index.js

@@ -0,0 +1,18 @@
+"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("./api-key.decorator"), exports);
+//# sourceMappingURL=index.js.map

package/dist/decorators/api-key/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/decorators/api-key/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC"}

package/dist/decorators/app-version/app-version.controller.d.ts

@@ -0,0 +1,30 @@
+/**
+ * App Version Controller
+ *
+ * 提供版本检查 API 端点。
+ *
+ * **重要**: 此控制器使用 VERSION_NEUTRAL，不需要版本 header。
+ * 前端应在启动时调用此 API 获取当前 API 版本，然后在后续请求中携带版本 header。
+ */
+import { AppVersionService, AppVersionInfo, VersionCheckResult } from './app-version.service';
+export declare class AppVersionController {
+    private readonly appVersionService;
+    constructor(appVersionService: AppVersionService);
+    /**
+     * 获取服务端版本信息
+     */
+    getVersion(): AppVersionInfo;
+    /**
+     * 检查客户端版本兼容性
+     */
+    checkVersion(clientVersion?: string, buildVersion?: string): VersionCheckResult;
+    /**
+     * 简单的版本哈希检查 (轻量级)
+     * 用于前端轮询检测
+     */
+    getBuildHash(): {
+        hash: string;
+        time: string;
+    };
+}
+//# sourceMappingURL=app-version.controller.d.ts.map

package/dist/decorators/app-version/app-version.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-version.controller.d.ts","sourceRoot":"","sources":["../../../src/decorators/app-version/app-version.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAG/B,qBAEa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBAAjB,iBAAiB,EAAE,iBAAiB;IAEjE;;OAEG;IAoBH,UAAU,IAAI,cAAc;IAI5B;;OAEG;IAiCH,YAAY,CACc,aAAa,CAAC,EAAE,MAAM,EACvB,YAAY,CAAC,EAAE,MAAM,GAC3C,kBAAkB;IAsBrB;;;OAGG;IAeH,YAAY,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;CAO/C"}

package/dist/decorators/app-version/app-version.controller.js

@@ -0,0 +1,159 @@
+"use strict";
+/**
+ * App Version Controller
+ *
+ * 提供版本检查 API 端点。
+ *
+ * **重要**: 此控制器使用 VERSION_NEUTRAL，不需要版本 header。
+ * 前端应在启动时调用此 API 获取当前 API 版本，然后在后续请求中携带版本 header。
+ */
+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.AppVersionController = void 0;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const app_version_service_1 = require("./app-version.service");
+const ts_rest_controller_decorator_1 = require("../ts-rest-controller.decorator");
+let AppVersionController = class AppVersionController {
+    appVersionService;
+    constructor(appVersionService) {
+        this.appVersionService = appVersionService;
+    }
+    /**
+     * 获取服务端版本信息
+     */
+    getVersion() {
+        return this.appVersionService.getVersionInfo();
+    }
+    /**
+     * 检查客户端版本兼容性
+     */
+    checkVersion(clientVersion, buildVersion) {
+        const result = this.appVersionService.checkClientVersion(clientVersion || '');
+        // 如果版本匹配，额外检查构建版本
+        if (!result.needsRefresh && buildVersion) {
+            const buildMatch = this.appVersionService.checkBuildVersion(buildVersion);
+            if (!buildMatch) {
+                return {
+                    ...result,
+                    needsRefresh: true,
+                    reason: 'outdated',
+                    action: 'refresh',
+                    message: '检测到代码更新，建议刷新页面',
+                };
+            }
+        }
+        return result;
+    }
+    /**
+     * 简单的版本哈希检查 (轻量级)
+     * 用于前端轮询检测
+     */
+    getBuildHash() {
+        const info = this.appVersionService.getVersionInfo();
+        return {
+            hash: info.buildVersion,
+            time: info.buildTime,
+        };
+    }
+};
+exports.AppVersionController = AppVersionController;
+__decorate([
+    (0, common_1.Get)(),
+    (0, swagger_1.ApiOperation)({ summary: '获取服务端版本信息' }),
+    (0, swagger_1.ApiResponse)({
+        status: 200,
+        description: '版本信息',
+        schema: {
+            type: 'object',
+            properties: {
+                appVersion: { type: 'string', example: '1.0.0' },
+                apiVersion: { type: 'string', example: '1' },
+                buildVersion: { type: 'string', example: 'a1b2c3d4' },
+                buildTime: {
+                    type: 'string',
+                    example: '2025-01-15T10:00:00.000Z',
+                },
+                environment: { type: 'string', example: 'production' },
+            },
+        },
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Object)
+], AppVersionController.prototype, "getVersion", null);
+__decorate([
+    (0, common_1.Get)('check'),
+    (0, swagger_1.ApiOperation)({ summary: '检查客户端版本兼容性' }),
+    (0, swagger_1.ApiQuery)({
+        name: 'clientVersion',
+        description: '客户端版本号',
+        required: false,
+        example: '1.0.0',
+    }),
+    (0, swagger_1.ApiQuery)({
+        name: 'buildVersion',
+        description: '客户端构建版本',
+        required: false,
+        example: 'a1b2c3d4',
+    }),
+    (0, swagger_1.ApiResponse)({
+        status: 200,
+        description: '版本检查结果',
+        schema: {
+            type: 'object',
+            properties: {
+                needsRefresh: { type: 'boolean', example: false },
+                reason: {
+                    type: 'string',
+                    enum: ['outdated', 'incompatible', 'major_update'],
+                },
+                serverVersion: { type: 'string', example: '1.0.0' },
+                clientVersion: { type: 'string', example: '1.0.0' },
+                action: { type: 'string', enum: ['refresh', 'update', 'none'] },
+                message: { type: 'string' },
+            },
+        },
+    }),
+    __param(0, (0, common_1.Query)('clientVersion')),
+    __param(1, (0, common_1.Query)('buildVersion')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String]),
+    __metadata("design:returntype", Object)
+], AppVersionController.prototype, "checkVersion", null);
+__decorate([
+    (0, common_1.Get)('hash'),
+    (0, swagger_1.ApiOperation)({ summary: '获取构建哈希 (轻量级检查)' }),
+    (0, common_1.Header)('Cache-Control', 'no-cache, no-store, must-revalidate'),
+    (0, swagger_1.ApiResponse)({
+        status: 200,
+        description: '构建哈希',
+        schema: {
+            type: 'object',
+            properties: {
+                hash: { type: 'string', example: 'a1b2c3d4' },
+                time: { type: 'string', example: '2025-01-15T10:00:00.000Z' },
+            },
+        },
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Object)
+], AppVersionController.prototype, "getBuildHash", null);
+exports.AppVersionController = AppVersionController = __decorate([
+    (0, swagger_1.ApiTags)('Version'),
+    (0, ts_rest_controller_decorator_1.TsRestController)('version'),
+    __metadata("design:paramtypes", [app_version_service_1.AppVersionService])
+], AppVersionController);
+//# sourceMappingURL=app-version.controller.js.map

package/dist/decorators/app-version/app-version.controller.js.map

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

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

@@ -0,0 +1,15 @@
+/**
+ * App Version Interceptor
+ *
+ * 拦截器实现，在每个响应中添加版本信息头。
+ * 前端可以通过这些头检测版本变化。
+ */
+import { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { Observable } from 'rxjs';
+import { AppVersionService } from './app-version.service';
+export declare class AppVersionInterceptor implements NestInterceptor {
+    private readonly appVersionService;
+    constructor(appVersionService: AppVersionService);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
+}
+//# sourceMappingURL=app-version.interceptor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app-version.interceptor.d.ts","sourceRoot":"","sources":["../../../src/decorators/app-version/app-version.interceptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,eAAe,EACf,gBAAgB,EAChB,WAAW,EACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAElC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,qBACa,qBAAsB,YAAW,eAAe;IAC/C,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBAAjB,iBAAiB,EAAE,iBAAiB;IAEjE,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC;CAazE"}

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

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * App Version Interceptor
+ *
+ * 拦截器实现，在每个响应中添加版本信息头。
+ * 前端可以通过这些头检测版本变化。
+ */
+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.AppVersionInterceptor = void 0;
+const common_1 = require("@nestjs/common");
+const app_version_service_1 = require("./app-version.service");
+let AppVersionInterceptor = class AppVersionInterceptor {
+    appVersionService;
+    constructor(appVersionService) {
+        this.appVersionService = appVersionService;
+    }
+    intercept(context, next) {
+        const response = context.switchToHttp().getResponse();
+        // 获取版本响应头
+        const versionHeaders = this.appVersionService.getVersionHeaders();
+        // 添加版本头到响应
+        for (const [key, value] of Object.entries(versionHeaders)) {
+            response.header(key, value);
+        }
+        return next.handle();
+    }
+};
+exports.AppVersionInterceptor = AppVersionInterceptor;
+exports.AppVersionInterceptor = AppVersionInterceptor = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [app_version_service_1.AppVersionService])
+], AppVersionInterceptor);
+//# sourceMappingURL=app-version.interceptor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app-version.interceptor.js","sourceRoot":"","sources":["../../../src/decorators/app-version/app-version.interceptor.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;AAEH,2CAKwB;AAGxB,+DAA0D;AAGnD,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IACH;IAA7B,YAA6B,iBAAoC;QAApC,sBAAiB,GAAjB,iBAAiB,CAAmB;IAAG,CAAC;IAErE,SAAS,CAAC,OAAyB,EAAE,IAAiB;QACpD,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,WAAW,EAAE,CAAC;QAEtD,UAAU;QACV,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,CAAC,iBAAiB,EAAE,CAAC;QAElE,WAAW;QACX,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;YAC1D,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;CACF,CAAA;AAhBY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;qCAEqC,uCAAiB;GADtD,qBAAqB,CAgBjC"}

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

@@ -0,0 +1,8 @@
+/**
+ * App Version Module
+ *
+ * 提供应用版本管理和前后端版本一致性检查。
+ */
+export declare class AppVersionModule {
+}
+//# sourceMappingURL=app-version.module.d.ts.map

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

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

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

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * App Version Module
+ *
+ * 提供应用版本管理和前后端版本一致性检查。
+ */
+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.AppVersionModule = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const config_1 = require("@nestjs/config");
+const app_version_service_1 = require("./app-version.service");
+const app_version_controller_1 = require("./app-version.controller");
+const app_version_interceptor_1 = require("./app-version.interceptor");
+let AppVersionModule = class AppVersionModule {
+};
+exports.AppVersionModule = AppVersionModule;
+exports.AppVersionModule = AppVersionModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        imports: [config_1.ConfigModule],
+        controllers: [app_version_controller_1.AppVersionController],
+        providers: [
+            app_version_service_1.AppVersionService,
+            {
+                provide: core_1.APP_INTERCEPTOR,
+                useClass: app_version_interceptor_1.AppVersionInterceptor,
+            },
+        ],
+        exports: [app_version_service_1.AppVersionService],
+    })
+], AppVersionModule);
+//# sourceMappingURL=app-version.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app-version.module.js","sourceRoot":"","sources":["../../../src/decorators/app-version/app-version.module.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;AAEH,2CAAgD;AAChD,uCAA+C;AAC/C,2CAA8C;AAC9C,+DAA0D;AAC1D,qEAAgE;AAChE,uEAAkE;AAe3D,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;CAAG,CAAA;AAAnB,4CAAgB;2BAAhB,gBAAgB;IAb5B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,qBAAY,CAAC;QACvB,WAAW,EAAE,CAAC,6CAAoB,CAAC;QACnC,SAAS,EAAE;YACT,uCAAiB;YACjB;gBACE,OAAO,EAAE,sBAAe;gBACxB,QAAQ,EAAE,+CAAqB;aAChC;SACF;QACD,OAAO,EAAE,CAAC,uCAAiB,CAAC;KAC7B,CAAC;GACW,gBAAgB,CAAG"}

package/dist/decorators/app-version/app-version.service.d.ts

@@ -0,0 +1,88 @@
+/**
+ * App Version Service
+ *
+ * 提供应用版本管理服务，用于前后端版本一致性检查。
+ *
+ * 版本策略:
+ * - API 版本: 后端 API 接口版本
+ * - App 版本: 应用整体版本 (前后端协调)
+ * - Build 版本: 构建时间戳/Git commit hash
+ *
+ * 前端检测机制:
+ * 1. 响应头检查: x-app-version, x-build-version
+ * 2. 专用接口: GET /api/version
+ * 3. 版本不一致时提示用户刷新
+ */
+import { OnModuleInit } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { Logger } from 'winston';
+export interface AppVersionInfo {
+    /** 应用版本 (package.json version) */
+    appVersion: string;
+    /** API 版本 */
+    apiVersion: string;
+    /** 构建版本 (时间戳或 Git hash) */
+    buildVersion: string;
+    /** 构建时间 */
+    buildTime: string;
+    /** 环境 */
+    environment: string;
+    /** 最低兼容前端版本 */
+    minClientVersion?: string;
+}
+export interface VersionCheckResult {
+    /** 是否需要刷新 */
+    needsRefresh: boolean;
+    /** 原因 */
+    reason?: 'outdated' | 'incompatible' | 'major_update';
+    /** 当前服务端版本 */
+    serverVersion: string;
+    /** 客户端版本 */
+    clientVersion: string;
+    /** 建议操作 */
+    action?: 'refresh' | 'update' | 'none';
+    /** 消息 */
+    message?: string;
+}
+export declare class AppVersionService implements OnModuleInit {
+    private readonly configService;
+    private readonly logger;
+    private versionInfo;
+    private buildHash;
+    constructor(configService: ConfigService, logger: Logger);
+    onModuleInit(): Promise<void>;
+    /**
+     * 加载版本信息
+     */
+    private loadVersionInfo;
+    /**
+     * 生成构建哈希
+     */
+    private generateBuildHash;
+    /**
+     * 获取版本信息
+     */
+    getVersionInfo(): AppVersionInfo;
+    /**
+     * 获取版本响应头
+     */
+    getVersionHeaders(): Record<string, string>;
+    /**
+     * 检查客户端版本兼容性
+     */
+    checkClientVersion(clientVersion: string): VersionCheckResult;
+    /**
+     * 检查构建版本是否匹配
+     */
+    checkBuildVersion(clientBuildVersion: string): boolean;
+    /**
+     * 比较版本号
+     * @returns -1 if v1 < v2, 0 if v1 == v2, 1 if v1 > v2
+     */
+    private compareVersions;
+    /**
+     * 检查是否为主版本更新
+     */
+    private isMajorVersionDiff;
+}
+//# sourceMappingURL=app-version.service.d.ts.map

package/dist/decorators/app-version/app-version.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-version.service.d.ts","sourceRoot":"","sources":["../../../src/decorators/app-version/app-version.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAc,YAAY,EAAU,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAUjC,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS;IACT,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa;IACb,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS;IACT,MAAM,CAAC,EAAE,UAAU,GAAG,cAAc,GAAG,cAAc,CAAC;IACtD,cAAc;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW;IACX,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;IACvC,SAAS;IACT,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,qBACa,iBAAkB,YAAW,YAAY;IAKlD,OAAO,CAAC,QAAQ,CAAC,aAAa;IACG,OAAO,CAAC,QAAQ,CAAC,MAAM;IAL1D,OAAO,CAAC,WAAW,CAAiB;IACpC,OAAO,CAAC,SAAS,CAAc;gBAGZ,aAAa,EAAE,aAAa,EACK,MAAM,EAAE,MAAM;IAG5D,YAAY;IAIlB;;OAEG;YACW,eAAe;IA2C7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,cAAc,IAAI,cAAc;IAIhC;;OAEG;IACH,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAS3C;;OAEG;IACH,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,kBAAkB;IA0D7D;;OAEG;IACH,iBAAiB,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO;IAItD;;;OAGG;IACH,OAAO,CAAC,eAAe;IAevB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAK3B"}