@dofe/infra-common 0.1.1

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

@@ -0,0 +1,251 @@
+"use strict";
+/**
+ * App Version Service
+ *
+ * 提供应用版本管理服务，用于前后端版本一致性检查。
+ *
+ * 版本策略:
+ * - API 版本: 后端 API 接口版本
+ * - App 版本: 应用整体版本 (前后端协调)
+ * - Build 版本: 构建时间戳/Git commit hash
+ *
+ * 前端检测机制:
+ * 1. 响应头检查: x-app-version, x-build-version
+ * 2. 专用接口: GET /api/version
+ * 3. 版本不一致时提示用户刷新
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+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 __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppVersionService = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const nest_winston_1 = require("nest-winston");
+const winston_1 = require("winston");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const environment_util_1 = __importDefault(require("@dofe/infra-utils/environment.util"));
+const env_config_service_1 = require("@/config/env-config.service");
+// ============================================================================
+// Service
+// ============================================================================
+let AppVersionService = class AppVersionService {
+    configService;
+    logger;
+    versionInfo;
+    buildHash = '';
+    constructor(configService, logger) {
+        this.configService = configService;
+        this.logger = logger;
+    }
+    async onModuleInit() {
+        await this.loadVersionInfo();
+    }
+    /**
+     * 加载版本信息
+     */
+    async loadVersionInfo() {
+        try {
+            // 读取 package.json
+            const packagePath = path.join(process.cwd(), 'package.json');
+            const packageJson = JSON.parse(fs.readFileSync(packagePath, 'utf-8'));
+            // 生成构建版本
+            this.buildHash = this.generateBuildHash();
+            this.versionInfo = {
+                appVersion: packageJson.version || '0.0.1',
+                apiVersion: this.configService.get('app.apiVersion', '1'),
+                buildVersion: this.buildHash,
+                buildTime: new Date().toISOString(),
+                environment: (0, env_config_service_1.getNodeEnv)(),
+                minClientVersion: this.configService.get('app.minClientVersion'),
+            };
+            if (environment_util_1.default.isProduction()) {
+                this.logger.info('App version info module loaded', {
+                    versionInfo: this.versionInfo,
+                });
+            }
+            else {
+                this.logger.debug('App version info module loaded', {
+                    versionInfo: this.versionInfo,
+                });
+            }
+        }
+        catch (error) {
+            this.logger.error('Failed to load version info', {
+                error: error.message,
+            });
+            this.versionInfo = {
+                appVersion: '0.0.1',
+                apiVersion: '1',
+                buildVersion: 'unknown',
+                buildTime: new Date().toISOString(),
+                environment: (0, env_config_service_1.getNodeEnv)(),
+            };
+        }
+    }
+    /**
+     * 生成构建哈希
+     */
+    generateBuildHash() {
+        // 优先使用 Git commit hash
+        const gitHash = env_config_service_1.buildConfig.gitCommitHash;
+        if (gitHash) {
+            return gitHash.substring(0, 8);
+        }
+        // 使用时间戳
+        return Date.now().toString(36);
+    }
+    /**
+     * 获取版本信息
+     */
+    getVersionInfo() {
+        return { ...this.versionInfo };
+    }
+    /**
+     * 获取版本响应头
+     */
+    getVersionHeaders() {
+        return {
+            'x-app-version': this.versionInfo.appVersion,
+            'x-api-version': this.versionInfo.apiVersion,
+            'x-build-version': this.versionInfo.buildVersion,
+            'x-build-time': this.versionInfo.buildTime,
+        };
+    }
+    /**
+     * 检查客户端版本兼容性
+     */
+    checkClientVersion(clientVersion) {
+        const serverVersion = this.versionInfo.appVersion;
+        const minVersion = this.versionInfo.minClientVersion;
+        // 如果客户端版本为空，建议刷新
+        if (!clientVersion) {
+            return {
+                needsRefresh: true,
+                reason: 'outdated',
+                serverVersion,
+                clientVersion: 'unknown',
+                action: 'refresh',
+                message: '检测到新版本，请刷新页面',
+            };
+        }
+        // 比较版本
+        const comparison = this.compareVersions(clientVersion, serverVersion);
+        // 客户端版本低于服务端
+        if (comparison < 0) {
+            const isMajorUpdate = this.isMajorVersionDiff(clientVersion, serverVersion);
+            return {
+                needsRefresh: true,
+                reason: isMajorUpdate ? 'major_update' : 'outdated',
+                serverVersion,
+                clientVersion,
+                action: 'refresh',
+                message: isMajorUpdate
+                    ? '发现重要更新，请刷新页面以获得最佳体验'
+                    : '检测到新版本，建议刷新页面',
+            };
+        }
+        // 检查最低兼容版本
+        if (minVersion && this.compareVersions(clientVersion, minVersion) < 0) {
+            return {
+                needsRefresh: true,
+                reason: 'incompatible',
+                serverVersion,
+                clientVersion,
+                action: 'update',
+                message: '当前版本过旧，请刷新页面更新',
+            };
+        }
+        return {
+            needsRefresh: false,
+            serverVersion,
+            clientVersion,
+            action: 'none',
+        };
+    }
+    /**
+     * 检查构建版本是否匹配
+     */
+    checkBuildVersion(clientBuildVersion) {
+        return clientBuildVersion === this.versionInfo.buildVersion;
+    }
+    /**
+     * 比较版本号
+     * @returns -1 if v1 < v2, 0 if v1 == v2, 1 if v1 > v2
+     */
+    compareVersions(v1, v2) {
+        const parts1 = v1.split('.').map(Number);
+        const parts2 = v2.split('.').map(Number);
+        for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
+            const num1 = parts1[i] || 0;
+            const num2 = parts2[i] || 0;
+            if (num1 < num2)
+                return -1;
+            if (num1 > num2)
+                return 1;
+        }
+        return 0;
+    }
+    /**
+     * 检查是否为主版本更新
+     */
+    isMajorVersionDiff(v1, v2) {
+        const major1 = parseInt(v1.split('.')[0] || '0', 10);
+        const major2 = parseInt(v2.split('.')[0] || '0', 10);
+        return major1 !== major2;
+    }
+};
+exports.AppVersionService = AppVersionService;
+exports.AppVersionService = AppVersionService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(1, (0, common_1.Inject)(nest_winston_1.WINSTON_MODULE_PROVIDER)),
+    __metadata("design:paramtypes", [config_1.ConfigService,
+        winston_1.Logger])
+], AppVersionService);
+//# sourceMappingURL=app-version.service.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * App Version Module Exports
+ */
+export { AppVersionService, AppVersionInfo, VersionCheckResult, } from './app-version.service';
+export { AppVersionController } from './app-version.controller';
+export { AppVersionInterceptor } from './app-version.interceptor';
+export { AppVersionModule } from './app-version.module';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/decorators/app-version/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}

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

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * App Version Module Exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppVersionModule = exports.AppVersionInterceptor = exports.AppVersionController = exports.AppVersionService = void 0;
+var app_version_service_1 = require("./app-version.service");
+Object.defineProperty(exports, "AppVersionService", { enumerable: true, get: function () { return app_version_service_1.AppVersionService; } });
+var app_version_controller_1 = require("./app-version.controller");
+Object.defineProperty(exports, "AppVersionController", { enumerable: true, get: function () { return app_version_controller_1.AppVersionController; } });
+var app_version_interceptor_1 = require("./app-version.interceptor");
+Object.defineProperty(exports, "AppVersionInterceptor", { enumerable: true, get: function () { return app_version_interceptor_1.AppVersionInterceptor; } });
+var app_version_module_1 = require("./app-version.module");
+Object.defineProperty(exports, "AppVersionModule", { enumerable: true, get: function () { return app_version_module_1.AppVersionModule; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/decorators/app-version/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,6DAI+B;AAH7B,wHAAA,iBAAiB,OAAA;AAKnB,mEAAgE;AAAvD,8HAAA,oBAAoB,OAAA;AAC7B,qEAAkE;AAAzD,gIAAA,qBAAqB,OAAA;AAC9B,2DAAwD;AAA/C,sHAAA,gBAAgB,OAAA"}

package/dist/decorators/audit-log.decorator.d.ts

@@ -0,0 +1,41 @@
+export declare const AUDIT_LOG_KEY = "audit_log";
+export interface AuditLogOptions {
+    /**
+     * 操作类型
+     */
+    operateType: string;
+    /**
+     * 操作目标类型
+     */
+    target: string;
+    /**
+     * 目标 ID 提取路径（从请求参数中提取）
+     * 支持点号分隔的路径，如 'params.id' 或 'body.botId'
+     */
+    targetIdPath?: string;
+    /**
+     * 目标名称提取路径
+     */
+    targetNamePath?: string;
+    /**
+     * 是否记录变更前数据（需要先查询）
+     */
+    recordBeforeData?: boolean;
+    /**
+     * 自定义描述
+     */
+    description?: string;
+}
+/**
+ * 审计日志装饰器
+ *
+ * 用于标记需要记录审计日志的方法
+ *
+ * @example
+ * ```typescript
+ * @AuditLog({ operateType: 'CREATE', target: 'BOT', targetIdPath: 'body.id' })
+ * async createBot(@Body() body: CreateBotDto) { ... }
+ * ```
+ */
+export declare const AuditLog: (options: AuditLogOptions) => import("@nestjs/common").CustomDecorator<string>;
+//# sourceMappingURL=audit-log.decorator.d.ts.map

package/dist/decorators/audit-log.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/audit-log.decorator.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,cAAc,CAAC;AAEzC,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,GAAI,SAAS,eAAe,qDACZ,CAAC"}

package/dist/decorators/audit-log.decorator.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditLog = exports.AUDIT_LOG_KEY = void 0;
+const common_1 = require("@nestjs/common");
+exports.AUDIT_LOG_KEY = 'audit_log';
+/**
+ * 审计日志装饰器
+ *
+ * 用于标记需要记录审计日志的方法
+ *
+ * @example
+ * ```typescript
+ * @AuditLog({ operateType: 'CREATE', target: 'BOT', targetIdPath: 'body.id' })
+ * async createBot(@Body() body: CreateBotDto) { ... }
+ * ```
+ */
+const AuditLog = (options) => (0, common_1.SetMetadata)(exports.AUDIT_LOG_KEY, options);
+exports.AuditLog = AuditLog;
+//# sourceMappingURL=audit-log.decorator.js.map

package/dist/decorators/audit-log.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.decorator.js","sourceRoot":"","sources":["../../src/decorators/audit-log.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAA6C;AAEhC,QAAA,aAAa,GAAG,WAAW,CAAC;AA8BzC;;;;;;;;;;GAUG;AACI,MAAM,QAAQ,GAAG,CAAC,OAAwB,EAAE,EAAE,CACnD,IAAA,oBAAW,EAAC,qBAAa,EAAE,OAAO,CAAC,CAAC;AADzB,QAAA,QAAQ,YACiB"}

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

@@ -0,0 +1,256 @@
+/**
+ * Cache Decorators
+ *
+ * 提供方法级别的缓存装饰器，与 RedisService 深度融合。
+ * 支持配置驱动的缓存策略，使用 config.local.yaml 中的 redis 配置。
+ *
+ * 支持分层缓存键策略:
+ * - 格式: prefix:primaryKey:hash(secondaryParams)
+ * - 示例: userInfo:userId:md5(select+include)
+ * - 清除时支持前缀匹配: userInfo:userId:* 清除所有变体
+ *
+ * @example
+ * ```typescript
+ * // 基础用法 - 使用配置名称
+ * @Cacheable('userInfo')
+ * async getUserById(userId: string) { ... }
+ *
+ * // 分层缓存 - 支持不同 select/include 参数的独立缓存
+ * @Cacheable('userInfo', {
+ *     keyGenerator: hierarchicalKeyGenerator({
+ *         primaryKey: (userId) => userId,
+ *         secondaryParams: (userId, select, include) => ({ select, include }),
+ *     }),
+ * })
+ * async getUserById(userId: string, select?: any, include?: any) { ... }
+ *
+ * // 缓存失效 - 清除所有相关缓存
+ * @CacheEvict('userInfo', {
+ *     keyGenerator: (userId) => userId,
+ *     evictByPrefix: true,  // 清除 userInfo:userId:* 所有变体
+ * })
+ * async updateUser(userId: string, data: any) { ... }
+ * ```
+ */
+export declare const CACHE_METADATA_KEY = "cache:cacheable";
+export declare const CACHE_EVICT_METADATA_KEY = "cache:evict";
+export declare const CACHE_PUT_METADATA_KEY = "cache:put";
+/**
+ * 缓存配置选项
+ */
+export interface CacheOptions {
+    /** Redis 配置名称 (对应 config.local.yaml 中的 redis[].name) */
+    cacheName: string;
+    /**
+     * 自定义 key 生成器
+     * 接收方法参数，返回缓存 key 后缀
+     * 默认使用 JSON.stringify(args)
+     */
+    keyGenerator?: (...args: any[]) => string;
+    /**
+     * 自定义过期时间 (秒)
+     * 默认使用配置中的 expireIn
+     */
+    ttl?: number;
+    /**
+     * 条件表达式 - 决定是否缓存结果
+     * 接收方法返回值，返回 true 则缓存
+     * 默认：result !== null && result !== undefined
+     */
+    condition?: (result: any) => boolean;
+    /**
+     * 是否同步刷新缓存 (后台更新)
+     * 默认: false
+     */
+    refreshAsync?: boolean;
+}
+/**
+ * 缓存失效配置选项
+ */
+export interface CacheEvictOptions {
+    /** Redis 配置名称 */
+    cacheName: string;
+    /**
+     * 自定义 key 生成器
+     * 返回的 key 将用于精确匹配或前缀匹配
+     */
+    keyGenerator?: (...args: any[]) => string;
+    /**
+     * 是否在方法执行前失效缓存
+     * 默认: false (方法执行后失效)
+     */
+    beforeInvocation?: boolean;
+    /**
+     * 是否清除所有匹配前缀的缓存
+     * 默认: false
+     */
+    allEntries?: boolean;
+    /**
+     * 是否使用前缀模式清除缓存
+     * 当为 true 时，keyGenerator 返回的 key 将作为前缀，
+     * 清除所有以该前缀开头的缓存条目
+     *
+     * 例如: keyGenerator 返回 "userId123"
+     * 将清除: userInfo:userId123, userInfo:userId123:abc, userInfo:userId123:xyz 等
+     *
+     * 默认: false
+     */
+    evictByPrefix?: boolean;
+}
+/**
+ * @Cacheable - 缓存方法返回值
+ *
+ * 首次调用时执行方法并缓存结果，后续调用直接返回缓存。
+ *
+ * @param cacheName - Redis 配置名称
+ * @param options - 可选配置
+ *
+ * @example
+ * ```typescript
+ * @Cacheable('userInfo')
+ * async getUserById(userId: string) {
+ *     return await this.prisma.userInfo.findUnique({ where: { id: userId } });
+ * }
+ *
+ * ```
+ */
+export declare function Cacheable(cacheName: string, options?: Partial<Omit<CacheOptions, 'cacheName'>>): MethodDecorator;
+/**
+ * @CacheEvict - 缓存失效
+ *
+ * 方法执行后（或前）使指定缓存失效。
+ *
+ * @param cacheName - Redis 配置名称
+ * @param options - 可选配置
+ *
+ * @example
+ * ```typescript
+ * @CacheEvict('userInfo')
+ * async updateUser(userId: string, data: any) {
+ *     return await this.prisma.userInfo.update({ where: { id: userId }, data });
+ * }
+ *
+ * @CacheEvict('userInfo', { allEntries: true })
+ * async clearAllUserCache() { ... }
+ * ```
+ */
+export declare function CacheEvict(cacheName: string, options?: Partial<Omit<CacheEvictOptions, 'cacheName'>>): MethodDecorator;
+/**
+ * @CachePut - 更新缓存
+ *
+ * 每次都执行方法，并用返回值更新缓存。
+ * 适用于需要确保数据新鲜度的场景。
+ *
+ * @param cacheName - Redis 配置名称
+ * @param options - 可选配置
+ *
+ * @example
+ * ```typescript
+ * @CachePut('userInfo')
+ * async refreshUserCache(userId: string) {
+ *     return await this.prisma.userInfo.findUnique({ where: { id: userId } });
+ * }
+ * ```
+ */
+export declare function CachePut(cacheName: string, options?: Partial<Omit<CacheOptions, 'cacheName'>>): MethodDecorator;
+/**
+ * 默认 key 生成器
+ * 将方法参数序列化为缓存 key
+ */
+export declare function defaultKeyGenerator(...args: any[]): string;
+/**
+ * 基于对象属性的 key 生成器
+ *
+ * @example
+ * ```typescript
+ * @Cacheable('userInfo', { keyGenerator: objectKeyGenerator('id') })
+ * async getUser(user: { id: string; name: string }) { ... }
+ * ```
+ */
+export declare function objectKeyGenerator(...properties: string[]): (...args: any[]) => string;
+/**
+ * 组合 key 生成器
+ * 使用冒号连接多个参数
+ *
+ * @example
+ */
+export declare function compositeKeyGenerator(...args: any[]): string;
+/**
+ * 计算对象的 MD5 哈希值
+ * 用于生成缓存键中的参数哈希部分
+ */
+export declare function hashObject(obj: any): string;
+/**
+ * 计算多个参数的组合哈希
+ */
+export declare function hashParams(...params: any[]): string;
+/**
+ * 分层缓存键生成器配置
+ */
+export interface HierarchicalKeyConfig {
+    /**
+     * 主键生成器
+     * 返回缓存键的主要标识部分 (如 userId)
+     * 这部分将用于前缀匹配清除
+     */
+    primaryKey: (...args: any[]) => string;
+    /**
+     * 次要参数提取器
+     * 返回需要哈希的次要参数 (如 select, include)
+     * 这些参数将被哈希后附加到主键之后
+     */
+    secondaryParams?: (...args: any[]) => Record<string, any> | null;
+}
+/**
+ * 分层缓存键生成器
+ *
+ * 生成格式: primaryKey:hash(secondaryParams)
+ * 如果没有 secondaryParams 或为空，则只返回 primaryKey
+ *
+ * @example
+ * ```typescript
+ * // 用于 getUserById(userId, select?, include?)
+ * @Cacheable('userInfo', {
+ *     keyGenerator: hierarchicalKeyGenerator({
+ *         primaryKey: (userId) => userId,
+ *         secondaryParams: (userId, select, include) => ({ select, include }),
+ *     }),
+ * })
+ * async getUserById(userId: string, select?: any, include?: any) { ... }
+ *
+ * // 生成的 key 示例:
+ * // - getUserById('user1') -> 'user1'
+ * // - getUserById('user1', { id: true }) -> 'user1:a3f2b1c4'
+ * // - getUserById('user1', { id: true, name: true }) -> 'user1:b2c3d4e5'
+ * ```
+ */
+export declare function hierarchicalKeyGenerator(config: HierarchicalKeyConfig): (...args: any[]) => string;
+/**
+ * 简单分层键生成器
+ * 第一个参数作为主键，其余参数作为次要参数
+ *
+ * @example
+ * ```typescript
+ * @Cacheable('userInfo', { keyGenerator: simpleHierarchicalKeyGenerator })
+ * async getUserById(userId: string, select?: any, include?: any) { ... }
+ * // 生成: userId:hash(select+include)
+ * ```
+ */
+export declare function simpleHierarchicalKeyGenerator(...args: any[]): string;
+/**
+ * 创建用户缓存键生成器
+ * 专门用于 User 相关的缓存
+ *
+ * @example
+ * ```typescript
+ * @Cacheable('userInfo', { keyGenerator: userKeyGenerator })
+ * async getUserById(userId: string, select?: any, include?: any) { ... }
+ * ```
+ */
+export declare const userKeyGenerator: typeof simpleHierarchicalKeyGenerator;
+/**
+ * 创建空间缓存键生成器
+ * 专门用于 Space 相关的缓存
+ */
+export declare const spaceKeyGenerator: typeof simpleHierarchicalKeyGenerator;
+//# sourceMappingURL=cache.decorator.d.ts.map

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

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