@nest-omni/core 3.1.1-9 → 3.1.1

package/cache/examples/basic-usage.js

@@ -0,0 +1,379 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheMonitoringService = exports.PostService = exports.UserService = void 0;
+exports.demonstrateCacheUsage = demonstrateCacheUsage;
+const common_1 = require("@nestjs/common");
+const index_1 = require("../index");
+class UserRepository {
+    findOne(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            console.log(`[DB] 查询用户 ${id}`);
+            return {
+                id,
+                name: `User ${id}`,
+                email: `user${id}@example.com`,
+                profile: {
+                    bio: `这是用户 ${id} 的个人简介`.repeat(10),
+                    avatar: `avatar_${id}.jpg`,
+                },
+            };
+        });
+    }
+    findMany(ids) {
+        return __awaiter(this, void 0, void 0, function* () {
+            console.log(`[DB] 批量查询用户 ${ids.join(', ')}`);
+            return Promise.all(ids.map((id) => this.findOne(id)));
+        });
+    }
+    findAll() {
+        return __awaiter(this, void 0, void 0, function* () {
+            console.log('[DB] 查询所有用户');
+            return Array(100)
+                .fill(null)
+                .map((_, i) => ({
+                id: `user_${i}`,
+                name: `User ${i}`,
+                email: `user${i}@example.com`,
+                profile: {
+                    bio: `这是用户 ${i} 的个人简介`.repeat(5),
+                    avatar: `avatar_${i}.jpg`,
+                },
+            }));
+        });
+    }
+    save(user) {
+        return __awaiter(this, void 0, void 0, function* () {
+            console.log(`[DB] 保存用户 ${user.id}`);
+            return Object.assign({}, user);
+        });
+    }
+    delete(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            console.log(`[DB] 删除用户 ${id}`);
+        });
+    }
+}
+class PostRepository {
+    findByAuthor(authorId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            console.log(`[DB] 查询作者 ${authorId} 的文章`);
+            return Array(20)
+                .fill(null)
+                .map((_, i) => ({
+                id: `post_${authorId}_${i}`,
+                title: `文章 ${i}`,
+                content: `这是文章 ${i} 的内容`.repeat(15),
+                authorId,
+                createdAt: new Date(),
+            }));
+        });
+    }
+}
+let UserService = class UserService {
+    constructor(cacheService, userRepository) {
+        this.cacheService = cacheService;
+        this.userRepository = userRepository;
+    }
+    getUser(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this.cacheService.getOrSet(`user:${id}`, () => this.userRepository.findOne(id), { ttl: 300000 });
+        });
+    }
+    getUserProfile(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this.userRepository.findOne(id);
+        });
+    }
+    getUserData(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this.userRepository.findOne(id);
+        });
+    }
+    getUsersBatch(ids) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const keys = ids.map((id) => `user:${id}`);
+            const cachedUsers = yield this.cacheService.mget(keys);
+            const uncachedIds = [];
+            const result = [];
+            cachedUsers.forEach((user, index) => {
+                if (user) {
+                    result.push(user);
+                }
+                else {
+                    uncachedIds.push(ids[index]);
+                }
+            });
+            if (uncachedIds.length > 0) {
+                const newUsers = yield this.userRepository.findMany(uncachedIds);
+                const cacheItems = newUsers.map((user) => ({
+                    key: `user:${user.id}`,
+                    value: user,
+                }));
+                yield this.cacheService.mset(cacheItems, { ttl: 300000 });
+                result.push(...newUsers);
+            }
+            return result;
+        });
+    }
+    updateUser(id, data) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const updatedUser = yield this.userRepository.save(Object.assign({ id }, data));
+            return updatedUser;
+        });
+    }
+    deleteUser(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.userRepository.delete(id);
+        });
+    }
+    invalidateAllProfiles() {
+        return __awaiter(this, void 0, void 0, function* () {
+            console.log('清除所有用户资料缓存');
+        });
+    }
+    cacheLargeData(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const largeData = {
+                user: yield this.userRepository.findOne(id),
+                posts: Array(50)
+                    .fill(null)
+                    .map((_, i) => ({
+                    id: `post_${i}`,
+                    title: `文章标题 ${i}`,
+                    content: `这是很长的文章内容 ${i}`.repeat(20),
+                    metadata: {
+                        tags: ['tag1', 'tag2', 'tag3'],
+                        category: 'test',
+                        views: Math.floor(Math.random() * 10000),
+                        likes: Math.floor(Math.random() * 1000),
+                    },
+                })),
+                statistics: {
+                    totalPosts: 50,
+                    totalViews: Math.floor(Math.random() * 100000),
+                    totalLikes: Math.floor(Math.random() * 10000),
+                    averageRating: (Math.random() * 5).toFixed(2),
+                },
+            };
+            yield this.cacheService.set(`user:${id}:large-data`, largeData, {
+                ttl: 3600000,
+            });
+        });
+    }
+    getLargeData(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this.cacheService.get(`user:${id}:large-data`);
+        });
+    }
+};
+exports.UserService = UserService;
+__decorate([
+    (0, index_1.Cacheable)({
+        key: (id) => `user:${id}:profile`,
+        ttl: 600000,
+        dependencies: [new index_1.TagDependency(['user-profile'])],
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], UserService.prototype, "getUserProfile", null);
+__decorate([
+    (0, index_1.Cacheable)({
+        key: (id) => `user:${id}:data`,
+        ttl: 300000,
+        condition: (id) => id !== 'admin',
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], UserService.prototype, "getUserData", null);
+__decorate([
+    (0, index_1.CachePut)({
+        key: (id) => `user:${id}`,
+        ttl: 300000,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object]),
+    __metadata("design:returntype", Promise)
+], UserService.prototype, "updateUser", null);
+__decorate([
+    (0, index_1.CacheEvict)({
+        keys: [(id) => `user:${id}`, (id) => `user:${id}:profile`],
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], UserService.prototype, "deleteUser", null);
+__decorate([
+    (0, index_1.CacheEvict)({
+        tags: ['user-profile'],
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], UserService.prototype, "invalidateAllProfiles", null);
+exports.UserService = UserService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [index_1.CacheService,
+        UserRepository])
+], UserService);
+let PostService = class PostService {
+    constructor(cacheService, postRepository) {
+        this.cacheService = cacheService;
+        this.postRepository = postRepository;
+    }
+    getPostsByAuthor(authorId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this.postRepository.findByAuthor(authorId);
+        });
+    }
+    getFeaturedPosts() {
+        return __awaiter(this, void 0, void 0, function* () {
+            console.log('[DB] 获取推荐文章');
+            return Array(10)
+                .fill(null)
+                .map((_, i) => ({
+                id: `featured_${i}`,
+                title: `推荐文章 ${i}`,
+                content: `推荐文章内容 ${i}`.repeat(10),
+                authorId: `author_${i}`,
+                createdAt: new Date(),
+            }));
+        });
+    }
+    getConfigVersion() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return '1.0.0';
+        });
+    }
+};
+exports.PostService = PostService;
+__decorate([
+    (0, index_1.Cacheable)({
+        key: (authorId) => `posts:by-author:${authorId}`,
+        ttl: 600000,
+        dependencies: [
+            new index_1.DbDependency('SELECT updated_at FROM users WHERE id = ?', (authorId) => [authorId]),
+        ],
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], PostService.prototype, "getPostsByAuthor", null);
+__decorate([
+    (0, index_1.Cacheable)({
+        key: 'posts:featured',
+        ttl: 1800000,
+        dependencies: [
+            new index_1.CallbackDependency(() => __awaiter(void 0, void 0, void 0, function* () {
+                return yield 'v1.0.0';
+            })),
+        ],
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], PostService.prototype, "getFeaturedPosts", null);
+exports.PostService = PostService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [index_1.CacheService,
+        PostRepository])
+], PostService);
+let CacheMonitoringService = class CacheMonitoringService {
+    constructor(cacheService) {
+        this.cacheService = cacheService;
+    }
+    getCacheStats() {
+        const stats = this.cacheService.getStats();
+        console.log('=== 缓存统计信息 ===');
+        console.log(`总请求数: ${stats.totalGets}`);
+        console.log(`命中数: ${stats.hits}`);
+        console.log `未命中数: ${stats.misses}`;
+        console.log(`命中率: ${(stats.hitRate * 100).toFixed(2)}%`);
+        if (stats.byLayer) {
+            console.log('\n各层级统计:');
+            Object.entries(stats.byLayer).forEach(([layer, layerStats]) => {
+                const stats = layerStats;
+                console.log(`${layer}: 命中 ${stats.hits}, 未命中 ${stats.misses}`);
+            });
+        }
+        return stats;
+    }
+    resetStats() {
+        this.cacheService.resetStats();
+        console.log('缓存统计已重置');
+    }
+    startMonitoring(intervalMs = 60000) {
+        setInterval(() => {
+            const stats = this.getCacheStats();
+            if (stats.hitRate < 0.7) {
+                console.warn(`⚠️ 缓存命中率过低: ${(stats.hitRate * 100).toFixed(2)}%`);
+            }
+            console.log(`✅ 缓存状态良好，命中率: ${(stats.hitRate * 100).toFixed(2)}%`);
+        }, intervalMs);
+    }
+};
+exports.CacheMonitoringService = CacheMonitoringService;
+exports.CacheMonitoringService = CacheMonitoringService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [index_1.CacheService])
+], CacheMonitoringService);
+function demonstrateCacheUsage() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const userService = new UserService(new index_1.CacheService({}, {}, {}, true, 1024), new UserRepository());
+        const postService = new PostService(new index_1.CacheService({}, {}, {}, true, 1024), new PostRepository());
+        const monitoringService = new CacheMonitoringService(new index_1.CacheService({}, {}, {}, true, 1024));
+        console.log('🚀 开始缓存演示...\n');
+        try {
+            console.log('1. 基础缓存使用:');
+            const user1 = yield userService.getUser('1');
+            console.log(`获取用户: ${user1.name}`);
+            const user1Cached = yield userService.getUser('1');
+            console.log(`从缓存获取用户: ${user1Cached.name}\n`);
+            console.log('2. 装饰器缓存:');
+            const profile = yield userService.getUserProfile('2');
+            console.log(`获取用户资料: ${profile.name}`);
+            const profileCached = yield userService.getUserProfile('2');
+            console.log(`从缓存获取用户资料: ${profileCached.name}\n`);
+            console.log('3. 批量操作:');
+            const users = yield userService.getUsersBatch(['1', '2', '3', '4', '5']);
+            console.log(`批量获取 ${users.length} 个用户\n`);
+            console.log('4. 大数据压缩:');
+            yield userService.cacheLargeData('1');
+            console.log('缓存大数据完成（应该自动压缩）');
+            const largeData = yield userService.getLargeData('1');
+            console.log(`获取大数据: 用户 ${largeData.user.name}, 文章数 ${largeData.posts.length}\n`);
+            console.log('5. 依赖系统:');
+            const posts = yield postService.getPostsByAuthor('1');
+            console.log(`获取作者文章: ${posts.length} 篇`);
+            const featuredPosts = yield postService.getFeaturedPosts();
+            console.log(`获取推荐文章: ${featuredPosts.length} 篇\n`);
+            console.log('6. 缓存统计:');
+            monitoringService.getCacheStats();
+            console.log('\n7. 缓存失效:');
+            yield userService.invalidateAllProfiles();
+            console.log('已清除所有用户资料缓存');
+        }
+        catch (error) {
+            console.error('演示过程中出现错误:', error);
+        }
+    });
+}

package/cache/index.d.ts

@@ -0,0 +1,15 @@
+export { CacheModule, type CacheModuleOptions, CACHE_SERVICE, } from './cache.module';
+export { CACHE_COMPRESSION_ENABLED, CACHE_COMPRESSION_THRESHOLD, } from './cache.constants';
+export { CacheService } from './cache.service';
+export { CacheHealthChecker, type CacheHealthResult } from './cache.health';
+export { CacheWarmupService, type CacheWarmupConfig, type CacheWarmupResult, } from './cache.warmup.service';
+export { CacheMetricsService, type CacheMetrics, type CacheOperationRecord, } from './cache-metrics.service';
+export { CacheSerializationService, type CacheSerializationOptions, type SerializationResult, type DeserializationResult, } from './cache-serialization.service';
+export { Cacheable, CacheEvict, CachePut, getCacheService, setCacheService, } from './decorators';
+export { ClsCacheProvider, MemoryCacheProvider, RedisCacheProvider, BaseCacheProvider, } from './providers';
+export { REDIS_CLIENT } from './providers/redis-cache.provider';
+export type { CacheProvider } from './interfaces/cache-provider.interface';
+export { CallbackDependency, ChainDependency, DbDependency, FileDependency, TagDependency, TimeDependency, } from './dependencies';
+export { CacheLayer, type CacheDependency, type CacheEvictOptions, type CacheOptions, type CachePutOptions, type CacheableOptions, type CacheStats, type DependencyData, } from './interfaces';
+export { DependencyManager, KeyGenerator, type CachedValueWithDependencies, } from './utils';
+export type { CacheDependency as ICacheDependency, CacheProvider as ICacheProvider, } from './interfaces';

package/cache/index.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeyGenerator = exports.DependencyManager = exports.CacheLayer = exports.TimeDependency = exports.TagDependency = exports.FileDependency = exports.DbDependency = exports.ChainDependency = exports.CallbackDependency = exports.REDIS_CLIENT = exports.BaseCacheProvider = exports.RedisCacheProvider = exports.MemoryCacheProvider = exports.ClsCacheProvider = exports.setCacheService = exports.getCacheService = exports.CachePut = exports.CacheEvict = exports.Cacheable = exports.CacheSerializationService = exports.CacheMetricsService = exports.CacheWarmupService = exports.CacheHealthChecker = exports.CacheService = exports.CACHE_COMPRESSION_THRESHOLD = exports.CACHE_COMPRESSION_ENABLED = exports.CACHE_SERVICE = exports.CacheModule = void 0;
+var cache_module_1 = require("./cache.module");
+Object.defineProperty(exports, "CacheModule", { enumerable: true, get: function () { return cache_module_1.CacheModule; } });
+Object.defineProperty(exports, "CACHE_SERVICE", { enumerable: true, get: function () { return cache_module_1.CACHE_SERVICE; } });
+var cache_constants_1 = require("./cache.constants");
+Object.defineProperty(exports, "CACHE_COMPRESSION_ENABLED", { enumerable: true, get: function () { return cache_constants_1.CACHE_COMPRESSION_ENABLED; } });
+Object.defineProperty(exports, "CACHE_COMPRESSION_THRESHOLD", { enumerable: true, get: function () { return cache_constants_1.CACHE_COMPRESSION_THRESHOLD; } });
+var cache_service_1 = require("./cache.service");
+Object.defineProperty(exports, "CacheService", { enumerable: true, get: function () { return cache_service_1.CacheService; } });
+var cache_health_1 = require("./cache.health");
+Object.defineProperty(exports, "CacheHealthChecker", { enumerable: true, get: function () { return cache_health_1.CacheHealthChecker; } });
+var cache_warmup_service_1 = require("./cache.warmup.service");
+Object.defineProperty(exports, "CacheWarmupService", { enumerable: true, get: function () { return cache_warmup_service_1.CacheWarmupService; } });
+var cache_metrics_service_1 = require("./cache-metrics.service");
+Object.defineProperty(exports, "CacheMetricsService", { enumerable: true, get: function () { return cache_metrics_service_1.CacheMetricsService; } });
+var cache_serialization_service_1 = require("./cache-serialization.service");
+Object.defineProperty(exports, "CacheSerializationService", { enumerable: true, get: function () { return cache_serialization_service_1.CacheSerializationService; } });
+var decorators_1 = require("./decorators");
+Object.defineProperty(exports, "Cacheable", { enumerable: true, get: function () { return decorators_1.Cacheable; } });
+Object.defineProperty(exports, "CacheEvict", { enumerable: true, get: function () { return decorators_1.CacheEvict; } });
+Object.defineProperty(exports, "CachePut", { enumerable: true, get: function () { return decorators_1.CachePut; } });
+Object.defineProperty(exports, "getCacheService", { enumerable: true, get: function () { return decorators_1.getCacheService; } });
+Object.defineProperty(exports, "setCacheService", { enumerable: true, get: function () { return decorators_1.setCacheService; } });
+var providers_1 = require("./providers");
+Object.defineProperty(exports, "ClsCacheProvider", { enumerable: true, get: function () { return providers_1.ClsCacheProvider; } });
+Object.defineProperty(exports, "MemoryCacheProvider", { enumerable: true, get: function () { return providers_1.MemoryCacheProvider; } });
+Object.defineProperty(exports, "RedisCacheProvider", { enumerable: true, get: function () { return providers_1.RedisCacheProvider; } });
+Object.defineProperty(exports, "BaseCacheProvider", { enumerable: true, get: function () { return providers_1.BaseCacheProvider; } });
+var redis_cache_provider_1 = require("./providers/redis-cache.provider");
+Object.defineProperty(exports, "REDIS_CLIENT", { enumerable: true, get: function () { return redis_cache_provider_1.REDIS_CLIENT; } });
+var dependencies_1 = require("./dependencies");
+Object.defineProperty(exports, "CallbackDependency", { enumerable: true, get: function () { return dependencies_1.CallbackDependency; } });
+Object.defineProperty(exports, "ChainDependency", { enumerable: true, get: function () { return dependencies_1.ChainDependency; } });
+Object.defineProperty(exports, "DbDependency", { enumerable: true, get: function () { return dependencies_1.DbDependency; } });
+Object.defineProperty(exports, "FileDependency", { enumerable: true, get: function () { return dependencies_1.FileDependency; } });
+Object.defineProperty(exports, "TagDependency", { enumerable: true, get: function () { return dependencies_1.TagDependency; } });
+Object.defineProperty(exports, "TimeDependency", { enumerable: true, get: function () { return dependencies_1.TimeDependency; } });
+var interfaces_1 = require("./interfaces");
+Object.defineProperty(exports, "CacheLayer", { enumerable: true, get: function () { return interfaces_1.CacheLayer; } });
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "DependencyManager", { enumerable: true, get: function () { return utils_1.DependencyManager; } });
+Object.defineProperty(exports, "KeyGenerator", { enumerable: true, get: function () { return utils_1.KeyGenerator; } });

package/cache/interfaces/cache-dependency.interface.d.ts

@@ -0,0 +1,11 @@
+export interface CacheDependency {
+    getKey(): string;
+    getData(): Promise<any>;
+    isChanged(oldData: any): Promise<boolean>;
+    reset?(): Promise<void>;
+}
+export interface DependencyData {
+    key: string;
+    data: any;
+    timestamp: number;
+}

package/cache/interfaces/cache-dependency.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/cache/interfaces/cache-options.interface.d.ts

@@ -0,0 +1,32 @@
+import type { CacheDependency } from './cache-dependency.interface';
+export declare enum CacheLayer {
+    CLS = "cls",
+    MEMORY = "memory",
+    REDIS = "redis"
+}
+export interface CacheOptions {
+    ttl?: number;
+    layers?: CacheLayer[];
+    prefix?: string;
+    condition?: (...args: any[]) => boolean | Promise<boolean>;
+    dependencies?: CacheDependency[];
+    backfill?: boolean;
+    namespace?: string;
+}
+export interface CacheKeyOptions {
+    key?: string | ((...args: any[]) => string);
+    prefix?: string;
+    includeAllArgs?: boolean;
+}
+export interface CacheableOptions extends CacheOptions, CacheKeyOptions {
+}
+export interface CacheEvictOptions {
+    keys?: Array<string | ((...args: any[]) => string)>;
+    patterns?: string[];
+    tags?: string[];
+    layers?: CacheLayer[];
+    condition?: (...args: any[]) => boolean | Promise<boolean>;
+    timing?: 'before' | 'after';
+}
+export interface CachePutOptions extends CacheOptions, CacheKeyOptions {
+}

package/cache/interfaces/cache-options.interface.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheLayer = void 0;
+var CacheLayer;
+(function (CacheLayer) {
+    CacheLayer["CLS"] = "cls";
+    CacheLayer["MEMORY"] = "memory";
+    CacheLayer["REDIS"] = "redis";
+})(CacheLayer || (exports.CacheLayer = CacheLayer = {}));

package/cache/interfaces/cache-provider.interface.d.ts

@@ -0,0 +1,28 @@
+export interface CacheProvider {
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T, ttl?: number): Promise<void>;
+    delete(key: string | string[]): Promise<void>;
+    deletePattern?(pattern: string): Promise<number>;
+    clear(): Promise<void>;
+    has(key: string): Promise<boolean>;
+    mget<T>(keys: string[]): Promise<(T | null)[]>;
+    mset(items: Array<{
+        key: string;
+        value: any;
+    }>, ttl?: number): Promise<void>;
+    getName(): string;
+}
+export interface CacheStats {
+    totalGets: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+    byLayer: Record<string, {
+        hits: number;
+        misses: number;
+        hitRate: number;
+    }>;
+    totalSets: number;
+    totalDeletes: number;
+    totalClears: number;
+}

package/cache/interfaces/cache-provider.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/cache/interfaces/index.d.ts

@@ -0,0 +1,3 @@
+export * from './cache-dependency.interface';
+export * from './cache-options.interface';
+export * from './cache-provider.interface';

package/cache/interfaces/index.js

@@ -0,0 +1,19 @@
+"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("./cache-dependency.interface"), exports);
+__exportStar(require("./cache-options.interface"), exports);
+__exportStar(require("./cache-provider.interface"), exports);

package/cache/providers/base-cache.provider.d.ts

@@ -0,0 +1,16 @@
+import type { CacheProvider } from '../interfaces/cache-provider.interface';
+export declare abstract class BaseCacheProvider implements CacheProvider {
+    abstract get<T>(key: string): Promise<T | null>;
+    abstract set<T>(key: string, value: T, ttl?: number): Promise<void>;
+    abstract delete(key: string | string[]): Promise<void>;
+    abstract deletePattern?(pattern: string): Promise<number>;
+    abstract clear(): Promise<void>;
+    abstract has(key: string): Promise<boolean>;
+    abstract getName(): string;
+    mget<T>(keys: string[]): Promise<(T | null)[]>;
+    mset(items: Array<{
+        key: string;
+        value: any;
+    }>, ttl?: number): Promise<void>;
+    protected patternToRegex(pattern: string): RegExp;
+}

package/cache/providers/base-cache.provider.js

@@ -0,0 +1,32 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseCacheProvider = void 0;
+class BaseCacheProvider {
+    mget(keys) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const promises = keys.map((key) => this.get(key));
+            return Promise.all(promises);
+        });
+    }
+    mset(items, ttl) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const promises = items.map((item) => this.set(item.key, item.value, ttl));
+            yield Promise.all(promises);
+        });
+    }
+    patternToRegex(pattern) {
+        const escaped = pattern.replace(/[.+?^${}()|[\]\\]/g, '\\$&');
+        const regexPattern = escaped.replace(/\*/g, '.*');
+        return new RegExp(`^${regexPattern}$`);
+    }
+}
+exports.BaseCacheProvider = BaseCacheProvider;

package/cache/providers/cls-cache.provider.d.ts

@@ -0,0 +1,16 @@
+import { BaseCacheProvider } from './base-cache.provider';
+export declare class ClsCacheProvider extends BaseCacheProvider {
+    private static readonly CACHE_PREFIX;
+    private static readonly KEYS_SET;
+    getName(): string;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T, ttl?: number): Promise<void>;
+    delete(key: string | string[]): Promise<void>;
+    deletePattern(pattern: string): Promise<number>;
+    clear(): Promise<void>;
+    has(key: string): Promise<boolean>;
+    private getFullKey;
+    private addKeyToSet;
+    private removeKeyFromSet;
+    private getAllKeys;
+}