@nest-omni/core 4.1.3-3 → 4.1.3-31

package/audit/services/operation-description.service.js

@@ -20,24 +20,30 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var OperationDescriptionService_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OperationDescriptionService = void 0;
 const common_1 = require("@nestjs/common");
 const typeorm_1 = require("@nestjs/typeorm");
 const typeorm_2 = require("typeorm");
 const entities_1 = require("../entities");
+const cache_1 = require("../../cache");
 /**
  * 操作描述服务
  * 负责根据模板和参数动态生成多语言描述
  */
-let OperationDescriptionService = class OperationDescriptionService {
-    constructor(templateRepository, transactionRepository, auditLogRepository, manualOperationRepository) {
+let OperationDescriptionService = OperationDescriptionService_1 = class OperationDescriptionService {
+    constructor(templateRepository, transactionRepository, auditLogRepository, manualOperationRepository, cacheService) {
         this.templateRepository = templateRepository;
         this.transactionRepository = transactionRepository;
         this.auditLogRepository = auditLogRepository;
         this.manualOperationRepository = manualOperationRepository;
-        // 模板缓存
-        this.templateCache = new Map();
+        this.cacheService = cacheService;
+        this.logger = new common_1.Logger(OperationDescriptionService_1.name);
+        // 缓存命名空间
+        this.CACHE_NAMESPACE = 'audit:template';
+        // 缓存TTL（30分钟）
+        this.CACHE_TTL = 30 * 60 * 1000;
     }
     /**
      * 动态生成操作名称
@@ -182,14 +188,123 @@ let OperationDescriptionService = class OperationDescriptionService {
      */
     batchGetTransactionDescriptions(transactionIds_1) {
         return __awaiter(this, arguments, void 0, function* (transactionIds, language = 'zh') {
+            if (transactionIds.length === 0) {
+                return {};
+            }
+            // 批量查询事务信息
+            const transactions = yield this.transactionRepository
+                .createQueryBuilder('tx')
+                .whereInIds(transactionIds)
+                .getMany();
+            // 批量查询审计日志
+            const auditLogs = yield this.auditLogRepository
+                .createQueryBuilder('log')
+                .where('log.requestId IN (:...transactionIds)', { transactionIds })
+                .orderBy('log.createdAt', 'ASC')
+                .getMany();
+            // 批量查询手动操作记录
+            const manualOperations = yield this.manualOperationRepository
+                .createQueryBuilder('op')
+                .where('op.transactionId IN (:...transactionIds)', { transactionIds })
+                .orderBy('op.createdAt', 'ASC')
+                .getMany();
+            // 收集所有需要的模板键
+            const templateKeys = new Set();
+            transactions.forEach(tx => {
+                if (tx.operationTemplateKey)
+                    templateKeys.add(tx.operationTemplateKey);
+            });
+            auditLogs.forEach(log => {
+                if (log.operationTemplateKey)
+                    templateKeys.add(log.operationTemplateKey);
+            });
+            manualOperations.forEach(op => {
+                if (op.operationTemplateKey)
+                    templateKeys.add(op.operationTemplateKey);
+            });
+            // 批量预加载模板
+            if (templateKeys.size > 0) {
+                yield this.preloadTemplates(Array.from(templateKeys));
+            }
+            // 按事务ID分组
+            const logsByTxId = new Map();
+            const opsByTxId = new Map();
+            auditLogs.forEach(log => {
+                const txId = log.requestId;
+                if (!logsByTxId.has(txId))
+                    logsByTxId.set(txId, []);
+                logsByTxId.get(txId).push(log);
+            });
+            manualOperations.forEach(op => {
+                const txId = op.transactionId;
+                if (!opsByTxId.has(txId))
+                    opsByTxId.set(txId, []);
+                opsByTxId.get(txId).push(op);
+            });
+            // 构建结果
             const results = {};
-            for (const transactionId of transactionIds) {
+            for (const transaction of transactions) {
                 try {
-                    results[transactionId] = yield this.getTransactionDescription(transactionId, language);
+                    const txLogs = logsByTxId.get(transaction.id) || [];
+                    const txOps = opsByTxId.get(transaction.id) || [];
+                    // 生成操作名称和描述
+                    let operationName;
+                    let description;
+                    if (transaction.operationTemplateKey) {
+                        operationName = yield this.generateOperationName(transaction.operationTemplateKey, language);
+                        description = yield this.generateDescription(transaction.operationTemplateKey, transaction.descriptionParams || {}, language);
+                    }
+                    else {
+                        const firstLog = txLogs[0];
+                        if (firstLog && firstLog.operationTemplateKey) {
+                            operationName = yield this.generateOperationName(firstLog.operationTemplateKey, language);
+                            description = yield this.generateDescription(firstLog.operationTemplateKey, firstLog.descriptionParams || {}, language);
+                        }
+                        else {
+                            operationName = 'Unknown Operation';
+                            description = transaction.description || 'Unknown operation';
+                        }
+                    }
+                    // 生成变更详情
+                    const changes = [];
+                    // 添加实体变更
+                    for (const log of txLogs) {
+                        const changeDescription = log.operationTemplateKey
+                            ? yield this.generateDescription(log.operationTemplateKey, log.descriptionParams || {}, language)
+                            : log.description || '';
+                        const changeDetails = log.changeDetails
+                            ? yield this.generateChangeDetails(log.changeDetails, language)
+                            : [];
+                        changes.push({
+                            entityName: log.entityType,
+                            entityId: log.entityId,
+                            operation: log.operation,
+                            description: changeDescription,
+                            details: changeDetails,
+                            createdAt: log.createdAt,
+                        });
+                    }
+                    // 添加手动操作
+                    for (const manualOp of txOps) {
+                        const opName = yield this.generateOperationName(manualOp.operationTemplateKey, language);
+                        const opDescription = yield this.generateDescription(manualOp.operationTemplateKey, manualOp.descriptionParams, language);
+                        changes.push({
+                            type: 'manual',
+                            description: `${opName}: ${opDescription}`,
+                            details: manualOp.descriptionParams,
+                            createdAt: manualOp.createdAt,
+                        });
+                    }
+                    // 按时间排序
+                    changes.sort((a, b) => new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime());
+                    results[transaction.id] = {
+                        operationName,
+                        description,
+                        changes,
+                    };
                 }
                 catch (error) {
-                    // 忽略错误，继续处理其他事务
-                    console.error(`Failed to get description for transaction ${transactionId}:`, error);
+                    this.logger.error(`Failed to get description for transaction ${transaction.id}: ${error.message}`, error.stack);
                 }
             }
             return results;
@@ -230,32 +345,48 @@ let OperationDescriptionService = class OperationDescriptionService {
         return String(value);
     }
     /**
-     * 获取操作模板（带缓存）
+     * 获取操作模板（使用统一缓存服务）
      * @param templateKey 模板键
      * @returns 操作模板
      */
     getOperationTemplate(templateKey) {
         return __awaiter(this, void 0, void 0, function* () {
-            // 检查缓存
-            if (this.templateCache.has(templateKey)) {
-                return this.templateCache.get(templateKey);
-            }
-            // 从数据库查询
-            const template = yield this.templateRepository.findOne({
-                where: { key: templateKey },
+            // 使用统一缓存服务的 getOrSet 方法
+            return this.cacheService.getOrSet(templateKey, () => __awaiter(this, void 0, void 0, function* () {
+                // 从数据库查询
+                const template = yield this.templateRepository.findOne({
+                    where: { key: templateKey },
+                });
+                return template;
+            }), {
+                namespace: this.CACHE_NAMESPACE,
+                ttl: this.CACHE_TTL,
+                // 只使用内存缓存层，避免序列化开销
+                layers: [cache_1.CacheLayer.MEMORY],
             });
-            if (template) {
-                // 缓存模板
-                this.templateCache.set(templateKey, template);
+        });
+    }
+    /**
+     * 获取模板字符串（仅返回模板文本，不填充参数）
+     * @param templateKey 模板键
+     * @param language 语言
+     * @returns 模板字符串
+     */
+    getTemplate(templateKey_1) {
+        return __awaiter(this, arguments, void 0, function* (templateKey, language = 'zh') {
+            const template = yield this.getOperationTemplate(templateKey);
+            if (!template) {
+                return null;
             }
-            return template;
+            return template.descriptionTemplates[language] || template.descriptionTemplates['zh'] || null;
         });
     }
     /**
      * 清除模板缓存
      */
     clearTemplateCache() {
-        this.templateCache.clear();
+        // 使用统一缓存服务清除
+        this.cacheService.deletePattern(`${this.CACHE_NAMESPACE}:*`, [cache_1.CacheLayer.MEMORY]);
     }
     /**
      * 预加载模板到缓存
@@ -267,14 +398,21 @@ let OperationDescriptionService = class OperationDescriptionService {
                 .createQueryBuilder('template')
                 .where('template.key IN (:...keys)', { keys: templateKeys })
                 .getMany();
-            for (const template of templates) {
-                this.templateCache.set(template.key, template);
-            }
+            // 批量设置到缓存
+            const cacheItems = templates.map(template => ({
+                key: template.key,
+                value: template,
+            }));
+            yield this.cacheService.mset(cacheItems, {
+                namespace: this.CACHE_NAMESPACE,
+                ttl: this.CACHE_TTL,
+                layers: [cache_1.CacheLayer.MEMORY],
+            });
         });
     }
 };
 exports.OperationDescriptionService = OperationDescriptionService;
-exports.OperationDescriptionService = OperationDescriptionService = __decorate([
+exports.OperationDescriptionService = OperationDescriptionService = OperationDescriptionService_1 = __decorate([
     (0, common_1.Injectable)(),
     __param(0, (0, typeorm_1.InjectRepository)(entities_1.OperationTemplateEntity)),
     __param(1, (0, typeorm_1.InjectRepository)(entities_1.EntityTransactionEntity)),
@@ -283,5 +421,6 @@ exports.OperationDescriptionService = OperationDescriptionService = __decorate([
     __metadata("design:paramtypes", [typeorm_2.Repository,
         typeorm_2.Repository,
         typeorm_2.Repository,
-        typeorm_2.Repository])
+        typeorm_2.Repository,
+        cache_1.CacheService])
 ], OperationDescriptionService);

package/audit/services/transaction-audit.service.d.ts

@@ -12,6 +12,7 @@ export declare class TransactionAuditService {
     private readonly contextService;
     private readonly auditService;
     private readonly multiDbService;
+    private readonly logger;
     constructor(transactionRepository: Repository<EntityTransactionEntity>, contextService: AuditContextService, auditService: EntityAuditService, multiDbService: MultiDatabaseService);
     /**
      * 开始事务

package/audit/services/transaction-audit.service.js

@@ -20,6 +20,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var TransactionAuditService_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TransactionAuditService = void 0;
 const common_1 = require("@nestjs/common");
@@ -30,15 +31,17 @@ const enums_1 = require("../enums");
 const audit_context_service_1 = require("./audit-context.service");
 const entity_audit_service_1 = require("./entity-audit.service");
 const multi_database_service_1 = require("./multi-database.service");
+const transaction_1 = require("@nest-omni/transaction");
 /**
  * 事务审计服务
  */
-let TransactionAuditService = class TransactionAuditService {
+let TransactionAuditService = TransactionAuditService_1 = class TransactionAuditService {
     constructor(transactionRepository, contextService, auditService, multiDbService) {
         this.transactionRepository = transactionRepository;
         this.contextService = contextService;
         this.auditService = auditService;
         this.multiDbService = multiDbService;
+        this.logger = new common_1.Logger(TransactionAuditService_1.name);
     }
     /**
      * 开始事务
@@ -48,7 +51,7 @@ let TransactionAuditService = class TransactionAuditService {
             const context = yield this.contextService.getCurrentContext();
             const transaction = this.transactionRepository.create({
                 description,
-                status: enums_1.TransactionStatus.PENDING,
+                status: enums_1.AuditTransactionStatus.PENDING,
                 entities: [],
                 userId: context.userId,
                 username: context.username,
@@ -72,7 +75,7 @@ let TransactionAuditService = class TransactionAuditService {
             if (!transaction) {
                 throw new Error(`Transaction not found: ${transactionId}`);
             }
-            transaction.status = enums_1.TransactionStatus.COMMITTED;
+            transaction.status = enums_1.AuditTransactionStatus.COMMITTED;
             yield this.transactionRepository.save(transaction);
         });
     }
@@ -89,7 +92,7 @@ let TransactionAuditService = class TransactionAuditService {
             }
             // 执行回滚操作
             yield this.performRollback(transaction);
-            transaction.status = enums_1.TransactionStatus.ROLLED_BACK;
+            transaction.status = enums_1.AuditTransactionStatus.ROLLED_BACK;
             yield this.transactionRepository.save(transaction);
         });
     }
@@ -140,7 +143,7 @@ let TransactionAuditService = class TransactionAuditService {
                 let connectionFound = false;
                 for (const connectionName of monitoredConnections) {
                     try {
-                        const dataSource = yield this.multiDbService.getDataSource(connectionName);
+                        const dataSource = (0, transaction_1.getDataSource)(connectionName);
                         const metadata = dataSource.getMetadata(entity.entityType);
                         if (metadata) {
                             if (!grouped[connectionName]) {
@@ -173,7 +176,7 @@ let TransactionAuditService = class TransactionAuditService {
      */
     rollbackEntitiesInConnection(connectionName, entities) {
         return __awaiter(this, void 0, void 0, function* () {
-            const dataSource = yield this.multiDbService.getDataSource(connectionName);
+            const dataSource = (0, transaction_1.getDataSource)(connectionName);
             // 使用事务执行回滚
             yield dataSource.transaction((manager) => __awaiter(this, void 0, void 0, function* () {
                 for (const entity of entities) {
@@ -181,7 +184,7 @@ let TransactionAuditService = class TransactionAuditService {
                         yield this.rollbackSingleEntity(manager, entity, connectionName);
                     }
                     catch (error) {
-                        console.error(`Failed to rollback entity ${entity.entityType}:${entity.entityId} in connection ${connectionName}:`, error);
+                        this.logger.error(`Failed to rollback entity ${entity.entityType}:${entity.entityId} in connection ${connectionName}: ${error.message}`, error.stack);
                         throw error;
                     }
                 }
@@ -222,7 +225,7 @@ let TransactionAuditService = class TransactionAuditService {
                     }
                     break;
                 default:
-                    console.warn(`Unknown operation type: ${entity.operation}`);
+                    this.logger.warn(`Unknown operation type: ${entity.operation}`);
             }
         });
     }
@@ -238,7 +241,7 @@ let TransactionAuditService = class TransactionAuditService {
     }
 };
 exports.TransactionAuditService = TransactionAuditService;
-exports.TransactionAuditService = TransactionAuditService = __decorate([
+exports.TransactionAuditService = TransactionAuditService = TransactionAuditService_1 = __decorate([
     (0, common_1.Injectable)(),
     __param(0, (0, typeorm_1.InjectRepository)(entities_1.EntityTransactionEntity)),
     __metadata("design:paramtypes", [typeorm_2.Repository,

package/audit/subscribers/entity-audit.subscriber.d.ts

@@ -9,6 +9,7 @@ export declare class EntityAuditSubscriber implements EntitySubscriberInterface<
     private readonly entityAuditService;
     private readonly contextService;
     private readonly auditStrategy;
+    private readonly logger;
     constructor(entityAuditService: EntityAuditService, contextService: AuditContextService, auditStrategy: DefaultAuditStrategy, dataSource: DataSource);
     /**
      * 在实体插入后记录审计日志
@@ -22,6 +23,10 @@ export declare class EntityAuditSubscriber implements EntitySubscriberInterface<
      * 在实体删除前记录审计日志
      */
     beforeRemove(event: RemoveEvent<any>): Promise<void>;
+    /**
+     * 计算变更字段
+     */
+    private calculateChangedFields;
     /**
      * 检查是否启用了审计
      */

package/audit/subscribers/entity-audit.subscriber.js

@@ -17,6 +17,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var EntityAuditSubscriber_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EntityAuditSubscriber = void 0;
 const common_1 = require("@nestjs/common");
@@ -29,11 +30,12 @@ const decorators_1 = require("../decorators");
 /**
  * 实体审计订阅者
  */
-let EntityAuditSubscriber = class EntityAuditSubscriber {
+let EntityAuditSubscriber = EntityAuditSubscriber_1 = class EntityAuditSubscriber {
     constructor(entityAuditService, contextService, auditStrategy, dataSource) {
         this.entityAuditService = entityAuditService;
         this.contextService = contextService;
         this.auditStrategy = auditStrategy;
+        this.logger = new common_1.Logger(EntityAuditSubscriber_1.name);
         dataSource.subscribers.push(this);
     }
     /**
@@ -46,6 +48,11 @@ let EntityAuditSubscriber = class EntityAuditSubscriber {
                 return;
             const entityType = entity.constructor.name;
             const entityId = entity.id;
+            // 空值安全检查：确保实体 ID 存在
+            if (!entityId) {
+                this.logger.warn(`Entity ID is missing for ${entityType}, skipping audit`);
+                return;
+            }
             // 检查是否启用了审计
             if (!this.isAuditEnabled(entity)) {
                 return;
@@ -57,15 +64,25 @@ let EntityAuditSubscriber = class EntityAuditSubscriber {
             try {
                 // 获取上下文信息
                 const context = yield this.contextService.getCurrentContext();
+                const actionContext = this.contextService.getCurrentActionContext();
+                // 记录到审计动作上下文
+                if (actionContext) {
+                    this.contextService.recordEntityChangeInAction(entityType, entityId, enums_1.AuditOperation.CREATE);
+                    // 记录详细的实体变更数据
+                    this.contextService.recordDetailedEntityChange(entityType, entityId, enums_1.AuditOperation.CREATE, {}, entity, Object.keys(entity));
+                }
                 // 记录审计日志
                 yield this.entityAuditService.logEntityChange(entityType, entityId, enums_1.AuditOperation.CREATE, {}, entity, {
                     requestId: context.requestId,
                     requestIp: context.requestIp,
                     userAgent: context.userAgent,
+                    auditActionId: actionContext === null || actionContext === void 0 ? void 0 : actionContext.actionId,
+                    auditActionName: actionContext === null || actionContext === void 0 ? void 0 : actionContext.actionName,
+                    sequenceInAction: (actionContext === null || actionContext === void 0 ? void 0 : actionContext.entityChanges.length) || 0,
                 });
             }
             catch (error) {
-                console.error('Failed to log audit for insert:', error);
+                this.logger.error('Failed to log audit for insert:', error);
             }
         });
     }
@@ -80,6 +97,11 @@ let EntityAuditSubscriber = class EntityAuditSubscriber {
                 return;
             const entityType = entity.constructor.name;
             const entityId = entity.id;
+            // 空值安全检查：确保实体 ID 存在
+            if (!entityId) {
+                this.logger.warn(`Entity ID is missing for ${entityType}, skipping audit`);
+                return;
+            }
             // 检查是否启用了审计
             if (!this.isAuditEnabled(entity)) {
                 return;
@@ -91,15 +113,26 @@ let EntityAuditSubscriber = class EntityAuditSubscriber {
             try {
                 // 获取上下文信息
                 const context = yield this.contextService.getCurrentContext();
+                const actionContext = this.contextService.getCurrentActionContext();
+                // 记录到审计动作上下文
+                if (actionContext) {
+                    this.contextService.recordEntityChangeInAction(entityType, entityId, enums_1.AuditOperation.UPDATE);
+                    // 记录详细的实体变更数据
+                    const changedFields = this.calculateChangedFields(databaseEntity || {}, entity);
+                    this.contextService.recordDetailedEntityChange(entityType, entityId, enums_1.AuditOperation.UPDATE, databaseEntity || {}, entity, changedFields);
+                }
                 // 记录审计日志
                 yield this.entityAuditService.logEntityChange(entityType, entityId, enums_1.AuditOperation.UPDATE, databaseEntity || {}, entity, {
                     requestId: context.requestId,
                     requestIp: context.requestIp,
                     userAgent: context.userAgent,
+                    auditActionId: actionContext === null || actionContext === void 0 ? void 0 : actionContext.actionId,
+                    auditActionName: actionContext === null || actionContext === void 0 ? void 0 : actionContext.actionName,
+                    sequenceInAction: (actionContext === null || actionContext === void 0 ? void 0 : actionContext.entityChanges.length) || 0,
                 });
             }
             catch (error) {
-                console.error('Failed to log audit for update:', error);
+                this.logger.error('Failed to log audit for update:', error);
             }
         });
     }
@@ -113,6 +146,11 @@ let EntityAuditSubscriber = class EntityAuditSubscriber {
                 return;
             const entityType = entity.constructor.name;
             const entityId = entity.id;
+            // 空值安全检查：确保实体 ID 存在
+            if (!entityId) {
+                this.logger.warn(`Entity ID is missing for ${entityType}, skipping audit`);
+                return;
+            }
             // 检查是否启用了审计
             if (!this.isAuditEnabled(entity)) {
                 return;
@@ -124,18 +162,44 @@ let EntityAuditSubscriber = class EntityAuditSubscriber {
             try {
                 // 获取上下文信息
                 const context = yield this.contextService.getCurrentContext();
+                const actionContext = this.contextService.getCurrentActionContext();
+                // 记录到审计动作上下文
+                if (actionContext) {
+                    this.contextService.recordEntityChangeInAction(entityType, entityId, enums_1.AuditOperation.DELETE);
+                    // 记录详细的实体变更数据
+                    this.contextService.recordDetailedEntityChange(entityType, entityId, enums_1.AuditOperation.DELETE, entity, {}, Object.keys(entity));
+                }
                 // 记录审计日志
                 yield this.entityAuditService.logEntityChange(entityType, entityId, enums_1.AuditOperation.DELETE, entity, {}, {
                     requestId: context.requestId,
                     requestIp: context.requestIp,
                     userAgent: context.userAgent,
+                    auditActionId: actionContext === null || actionContext === void 0 ? void 0 : actionContext.actionId,
+                    auditActionName: actionContext === null || actionContext === void 0 ? void 0 : actionContext.actionName,
+                    sequenceInAction: (actionContext === null || actionContext === void 0 ? void 0 : actionContext.entityChanges.length) || 0,
                 });
             }
             catch (error) {
-                console.error('Failed to log audit for delete:', error);
+                this.logger.error('Failed to log audit for delete:', error);
             }
         });
     }
+    /**
+     * 计算变更字段
+     */
+    calculateChangedFields(oldValue, newValue) {
+        const changedFields = [];
+        const allKeys = new Set([
+            ...Object.keys(oldValue || {}),
+            ...Object.keys(newValue || {}),
+        ]);
+        for (const key of allKeys) {
+            if (JSON.stringify(oldValue[key]) !== JSON.stringify(newValue[key])) {
+                changedFields.push(key);
+            }
+        }
+        return changedFields;
+    }
     /**
      * 检查是否启用了审计
      */
@@ -154,7 +218,7 @@ let EntityAuditSubscriber = class EntityAuditSubscriber {
     }
 };
 exports.EntityAuditSubscriber = EntityAuditSubscriber;
-exports.EntityAuditSubscriber = EntityAuditSubscriber = __decorate([
+exports.EntityAuditSubscriber = EntityAuditSubscriber = EntityAuditSubscriber_1 = __decorate([
     (0, common_1.Injectable)(),
     (0, typeorm_1.EventSubscriber)(),
     __metadata("design:paramtypes", [entity_audit_service_1.EntityAuditService,

package/cache/cache.module.d.ts

@@ -1,5 +1,4 @@
 import { DynamicModule, OnModuleInit } from '@nestjs/common';
-import type { DataSource } from 'typeorm';
 import type { Redis } from 'ioredis';
 import { CacheService } from './cache.service';
 /**
@@ -21,18 +20,18 @@ export interface CacheModuleOptions {
      */
     redisClient?: Redis;
     /**
-     * TypeORM DataSource for DbDependency
-     * If not provided, DbDependency will throw error when used
-     */
-    dataSource?: DataSource;
-    /**
-     * Default TTL for memory cache in milliseconds
+     * Default TTL for LRU cache in milliseconds
      */
     memoryTtl?: number;
     /**
-     * Namespace for memory cache
+     * Namespace for LRU cache
      */
     memoryNamespace?: string;
+    /**
+     * Max size for LRU cache
+     * @default 500
+     */
+    lruMaxSize?: number;
     /**
      * Enable compression for cache values
      * @default false

package/cache/cache.module.js

@@ -80,10 +80,10 @@ let CacheModule = CacheModule_1 = class CacheModule {
      * Register cache module with options
      */
     static forRoot(options = {}) {
-        const { isGlobal = true, redisClient, dataSource, memoryTtl, memoryNamespace, enableCompression = false, compressionThreshold = 1024, } = options;
-        // Set DataSource for DbDependency if provided
-        if (dataSource) {
-            dependencies_1.DbDependency.setDataSource(dataSource);
+        const { isGlobal = true, redisClient, memoryTtl, memoryNamespace, lruMaxSize = 500, enableCompression = false, compressionThreshold = 1024, } = options;
+        // Set Redis client for TagDependency for distributed tag support
+        if (redisClient) {
+            dependencies_1.TagDependency.setRedisClient(redisClient);
         }
         return {
             module: CacheModule_1,
@@ -92,10 +92,11 @@ let CacheModule = CacheModule_1 = class CacheModule {
                 // Providers
                 providers_1.ClsCacheProvider,
                 {
-                    provide: providers_1.MemoryCacheProvider,
-                    useValue: new providers_1.MemoryCacheProvider({
+                    provide: providers_1.LRUCacheProvider,
+                    useValue: new providers_1.LRUCacheProvider({
+                        maxSize: lruMaxSize,
                         ttl: memoryTtl,
-                        namespace: memoryNamespace,
+                        namespace: memoryNamespace || 'cache:lru',
                     }),
                 },
                 // Redis client provider (optional)
@@ -159,15 +160,16 @@ let CacheModule = CacheModule_1 = class CacheModule {
                 // Providers
                 providers_1.ClsCacheProvider,
                 {
-                    provide: providers_1.MemoryCacheProvider,
+                    provide: providers_1.LRUCacheProvider,
                     useFactory: (moduleOptions) => {
-                        // Set DataSource for DbDependency if provided
-                        if (moduleOptions.dataSource) {
-                            dependencies_1.DbDependency.setDataSource(moduleOptions.dataSource);
+                        // Set Redis client for TagDependency for distributed tag support
+                        if (moduleOptions.redisClient) {
+                            dependencies_1.TagDependency.setRedisClient(moduleOptions.redisClient);
                         }
-                        return new providers_1.MemoryCacheProvider({
+                        return new providers_1.LRUCacheProvider({
+                            maxSize: moduleOptions.lruMaxSize || 500,
                             ttl: moduleOptions.memoryTtl,
-                            namespace: moduleOptions.memoryNamespace,
+                            namespace: moduleOptions.memoryNamespace || 'cache:lru',
                         });
                     },
                     inject: ['CACHE_MODULE_OPTIONS'],