@omnitron-dev/titan-cache 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +19 -0
  3. package/dist/cache.adapter.d.ts +33 -0
  4. package/dist/cache.adapter.d.ts.map +1 -0
  5. package/dist/cache.adapter.js +146 -0
  6. package/dist/cache.adapter.js.map +1 -0
  7. package/dist/cache.decorators.d.ts +36 -0
  8. package/dist/cache.decorators.d.ts.map +1 -0
  9. package/dist/cache.decorators.js +250 -0
  10. package/dist/cache.decorators.js.map +1 -0
  11. package/dist/cache.health.d.ts +36 -0
  12. package/dist/cache.health.d.ts.map +1 -0
  13. package/dist/cache.health.js +260 -0
  14. package/dist/cache.health.js.map +1 -0
  15. package/dist/cache.module.d.ts +11 -0
  16. package/dist/cache.module.d.ts.map +1 -0
  17. package/dist/cache.module.js +125 -0
  18. package/dist/cache.module.js.map +1 -0
  19. package/dist/cache.service.d.ts +30 -0
  20. package/dist/cache.service.d.ts.map +1 -0
  21. package/dist/cache.service.js +250 -0
  22. package/dist/cache.service.js.map +1 -0
  23. package/dist/cache.tokens.d.ts +10 -0
  24. package/dist/cache.tokens.d.ts.map +1 -0
  25. package/dist/cache.tokens.js +11 -0
  26. package/dist/cache.tokens.js.map +1 -0
  27. package/dist/cache.types.d.ts +185 -0
  28. package/dist/cache.types.d.ts.map +1 -0
  29. package/dist/cache.types.js +2 -0
  30. package/dist/cache.types.js.map +1 -0
  31. package/dist/cache.utils.d.ts +44 -0
  32. package/dist/cache.utils.d.ts.map +1 -0
  33. package/dist/cache.utils.js +333 -0
  34. package/dist/cache.utils.js.map +1 -0
  35. package/dist/index.d.ts +14 -0
  36. package/dist/index.d.ts.map +1 -0
  37. package/dist/index.js +13 -0
  38. package/dist/index.js.map +1 -0
  39. package/dist/lfu-cache.d.ts +67 -0
  40. package/dist/lfu-cache.d.ts.map +1 -0
  41. package/dist/lfu-cache.js +481 -0
  42. package/dist/lfu-cache.js.map +1 -0
  43. package/dist/lru-cache.d.ts +61 -0
  44. package/dist/lru-cache.d.ts.map +1 -0
  45. package/dist/lru-cache.js +437 -0
  46. package/dist/lru-cache.js.map +1 -0
  47. package/dist/multi-tier-cache.d.ts +101 -0
  48. package/dist/multi-tier-cache.d.ts.map +1 -0
  49. package/dist/multi-tier-cache.js +611 -0
  50. package/dist/multi-tier-cache.js.map +1 -0
  51. package/package.json +38 -0
@@ -0,0 +1,250 @@
1
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
+ 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;
5
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
6
+ };
7
+ var __metadata = (this && this.__metadata) || function (k, v) {
8
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
9
+ };
10
+ import { Injectable } from '@omnitron-dev/titan/decorators';
11
+ import { EventEmitter } from '@omnitron-dev/eventemitter';
12
+ import { LRUCache } from './lru-cache.js';
13
+ import { LFUCache } from './lfu-cache.js';
14
+ import { MultiTierCache } from './multi-tier-cache.js';
15
+ import { DEFAULT_CACHE_NAME } from './cache.tokens.js';
16
+ let CacheService = class CacheService {
17
+ constructor(options = {}) {
18
+ this.caches = new Map();
19
+ this.eventEmitter = new EventEmitter();
20
+ this.disposed = false;
21
+ this.defaultOptions = {
22
+ maxSize: 1000,
23
+ defaultTtl: 300,
24
+ evictionPolicy: 'lru',
25
+ enableStats: true,
26
+ compressionThreshold: 1024,
27
+ compressionAlgorithm: 'none',
28
+ ...options,
29
+ };
30
+ this.createCache(DEFAULT_CACHE_NAME, this.defaultOptions);
31
+ }
32
+ getCache(name) {
33
+ const cacheName = name ?? DEFAULT_CACHE_NAME;
34
+ const cache = this.caches.get(cacheName);
35
+ if (!cache) {
36
+ throw new Error(`Cache '${cacheName}' not found. Use createCache() or getOrCreateCache() first.`);
37
+ }
38
+ return cache;
39
+ }
40
+ createCache(name, options) {
41
+ if (this.disposed) {
42
+ throw new Error('CacheService has been disposed');
43
+ }
44
+ if (this.caches.has(name)) {
45
+ throw new Error(`Cache '${name}' already exists. Use getOrCreateCache() instead.`);
46
+ }
47
+ const mergedOptions = { ...this.defaultOptions, ...options };
48
+ const cache = this.createCacheInstance(name, mergedOptions);
49
+ this.caches.set(name, cache);
50
+ this.emitEvent({ type: 'set', key: name, timestamp: Date.now(), metadata: { action: 'cache_created' } });
51
+ return cache;
52
+ }
53
+ getOrCreateCache(name, options) {
54
+ if (this.caches.has(name)) {
55
+ return this.caches.get(name);
56
+ }
57
+ return this.createCache(name, options);
58
+ }
59
+ listCaches() {
60
+ return Array.from(this.caches.keys());
61
+ }
62
+ deleteCache(name) {
63
+ if (name === DEFAULT_CACHE_NAME) {
64
+ throw new Error('Cannot delete the default cache');
65
+ }
66
+ const cache = this.caches.get(name);
67
+ if (!cache) {
68
+ return false;
69
+ }
70
+ cache.dispose().catch(() => {
71
+ });
72
+ this.caches.delete(name);
73
+ this.emitEvent({ type: 'delete', key: name, timestamp: Date.now(), metadata: { action: 'cache_deleted' } });
74
+ return true;
75
+ }
76
+ getGlobalStats() {
77
+ const allStats = Array.from(this.caches.values()).map((cache) => cache.getStats());
78
+ if (allStats.length === 0) {
79
+ return this.createEmptyStats();
80
+ }
81
+ const aggregated = {
82
+ hits: 0,
83
+ misses: 0,
84
+ hitRate: 0,
85
+ size: 0,
86
+ memoryUsage: 0,
87
+ evictions: 0,
88
+ expirations: 0,
89
+ avgGetLatency: 0,
90
+ avgSetLatency: 0,
91
+ createdAt: new Date(),
92
+ lastAccessAt: new Date(0),
93
+ };
94
+ let totalGetLatency = 0;
95
+ let totalSetLatency = 0;
96
+ let earliestCreated = Date.now();
97
+ let latestAccess = 0;
98
+ for (const stats of allStats) {
99
+ aggregated.hits += stats.hits;
100
+ aggregated.misses += stats.misses;
101
+ aggregated.size += stats.size;
102
+ aggregated.memoryUsage += stats.memoryUsage;
103
+ aggregated.evictions += stats.evictions;
104
+ aggregated.expirations += stats.expirations;
105
+ totalGetLatency += stats.avgGetLatency;
106
+ totalSetLatency += stats.avgSetLatency;
107
+ if (stats.createdAt.getTime() < earliestCreated) {
108
+ earliestCreated = stats.createdAt.getTime();
109
+ }
110
+ if (stats.lastAccessAt.getTime() > latestAccess) {
111
+ latestAccess = stats.lastAccessAt.getTime();
112
+ }
113
+ }
114
+ const total = aggregated.hits + aggregated.misses;
115
+ aggregated.hitRate = total > 0 ? aggregated.hits / total : 0;
116
+ aggregated.avgGetLatency = allStats.length > 0 ? totalGetLatency / allStats.length : 0;
117
+ aggregated.avgSetLatency = allStats.length > 0 ? totalSetLatency / allStats.length : 0;
118
+ aggregated.createdAt = new Date(earliestCreated);
119
+ aggregated.lastAccessAt = new Date(latestAccess);
120
+ return aggregated;
121
+ }
122
+ on(event, listener) {
123
+ this.eventEmitter.on(event, listener);
124
+ }
125
+ off(event, listener) {
126
+ this.eventEmitter.off(event, listener);
127
+ }
128
+ async dispose() {
129
+ if (this.disposed)
130
+ return;
131
+ this.disposed = true;
132
+ const disposePromises = Array.from(this.caches.values()).map((cache) => cache.dispose());
133
+ await Promise.all(disposePromises);
134
+ this.caches.clear();
135
+ this.eventEmitter.removeAllListeners();
136
+ }
137
+ createCacheInstance(name, options) {
138
+ const cacheType = this.determineCacheType(options);
139
+ switch (cacheType) {
140
+ case 'multi-tier':
141
+ return this.createMultiTierCache(name, options);
142
+ case 'lfu':
143
+ return this.createLFUCache(name, options);
144
+ case 'lru':
145
+ default:
146
+ return this.createLRUCache(name, options);
147
+ }
148
+ }
149
+ determineCacheType(options) {
150
+ if (options.type) {
151
+ return options.type;
152
+ }
153
+ if (options.multiTier || options.l2) {
154
+ return 'multi-tier';
155
+ }
156
+ const policy = options.evictionPolicy ?? 'lru';
157
+ return policy === 'lfu' ? 'lfu' : 'lru';
158
+ }
159
+ createLRUCache(name, options) {
160
+ const lruOptions = {
161
+ name,
162
+ maxSize: options.maxSize,
163
+ ttl: options.defaultTtl,
164
+ compressionThreshold: options.compressionThreshold,
165
+ compressionAlgorithm: options.compressionAlgorithm,
166
+ enableStats: options.enableStats,
167
+ useWeakRef: options.useWeakRef,
168
+ ttlCleanupInterval: options.ttlCleanupInterval,
169
+ wheelTimerBuckets: options.wheelTimerBuckets,
170
+ onEvict: (key, _value, reason) => {
171
+ this.emitEvent({
172
+ type: reason === 'capacity' ? 'evict' : reason === 'ttl' ? 'expire' : 'delete',
173
+ key,
174
+ timestamp: Date.now(),
175
+ });
176
+ },
177
+ };
178
+ return new LRUCache(lruOptions);
179
+ }
180
+ createLFUCache(name, options) {
181
+ const lfuOptions = {
182
+ name,
183
+ maxSize: options.maxSize,
184
+ ttl: options.defaultTtl,
185
+ compressionThreshold: options.compressionThreshold,
186
+ compressionAlgorithm: options.compressionAlgorithm,
187
+ enableStats: options.enableStats,
188
+ onEvict: (key, _value, reason) => {
189
+ this.emitEvent({
190
+ type: reason === 'capacity' ? 'evict' : reason === 'ttl' ? 'expire' : 'delete',
191
+ key,
192
+ timestamp: Date.now(),
193
+ });
194
+ },
195
+ };
196
+ return new LFUCache(lfuOptions);
197
+ }
198
+ createMultiTierCache(name, options) {
199
+ const multiTierOptions = {
200
+ name,
201
+ l1: {
202
+ type: options.evictionPolicy === 'lfu' ? 'lfu' : 'lru',
203
+ maxSize: options.l1?.maxSize ?? options.maxSize,
204
+ ttl: options.l1?.ttl ?? options.defaultTtl,
205
+ compressionThreshold: options.l1?.compressionThreshold ?? options.compressionThreshold,
206
+ compressionAlgorithm: options.l1?.compressionAlgorithm ?? options.compressionAlgorithm,
207
+ },
208
+ l2: options.l2
209
+ ? {
210
+ client: options.l2Adapter ?? options.l2.client,
211
+ prefix: options.l2.prefix,
212
+ ttl: options.l2.ttl,
213
+ serializer: options.l2.serializer,
214
+ compression: options.l2.compression,
215
+ compressionAlgorithm: options.l2.compressionAlgorithm,
216
+ compressionThreshold: options.l2.compressionThreshold,
217
+ }
218
+ : undefined,
219
+ writeStrategy: 'through',
220
+ autoPromote: true,
221
+ promotionThreshold: 3,
222
+ enableStats: options.enableStats,
223
+ };
224
+ return new MultiTierCache(multiTierOptions);
225
+ }
226
+ emitEvent(event) {
227
+ this.eventEmitter.emit(event.type, event);
228
+ }
229
+ createEmptyStats() {
230
+ return {
231
+ hits: 0,
232
+ misses: 0,
233
+ hitRate: 0,
234
+ size: 0,
235
+ memoryUsage: 0,
236
+ evictions: 0,
237
+ expirations: 0,
238
+ avgGetLatency: 0,
239
+ avgSetLatency: 0,
240
+ createdAt: new Date(),
241
+ lastAccessAt: new Date(),
242
+ };
243
+ }
244
+ };
245
+ CacheService = __decorate([
246
+ Injectable(),
247
+ __metadata("design:paramtypes", [Object])
248
+ ], CacheService);
249
+ export { CacheService };
250
+ //# sourceMappingURL=cache.service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache.service.js","sourceRoot":"","sources":["../src/cache.service.ts"],"names":[],"mappings":";;;;;;;;;AAYA,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAwB,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAwB,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAoD,MAAM,uBAAuB,CAAC;AAWzG,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAkBhD,IAAM,YAAY,GAAlB,MAAM,YAAY;IAMvB,YAAY,UAA+B,EAAE;QAL5B,WAAM,GAAiC,IAAI,GAAG,EAAE,CAAC;QACjD,iBAAY,GAAiB,IAAI,YAAY,EAAE,CAAC;QAEzD,aAAQ,GAAY,KAAK,CAAC;QAGhC,IAAI,CAAC,cAAc,GAAG;YACpB,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,GAAG;YACf,cAAc,EAAE,KAAK;YACrB,WAAW,EAAE,IAAI;YACjB,oBAAoB,EAAE,IAAI;YAC1B,oBAAoB,EAAE,MAAM;YAC5B,GAAG,OAAO;SACX,CAAC;QAGF,IAAI,CAAC,WAAW,CAAC,kBAAkB,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IAC5D,CAAC;IAMD,QAAQ,CAAc,IAAa;QACjC,MAAM,SAAS,GAAG,IAAI,IAAI,kBAAkB,CAAC;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEzC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,UAAU,SAAS,6DAA6D,CAAC,CAAC;QACpG,CAAC;QAED,OAAO,KAAkB,CAAC;IAC5B,CAAC;IAKD,WAAW,CAAc,IAAY,EAAE,OAA4B;QACjE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,mDAAmD,CAAC,CAAC;QACrF,CAAC;QAED,MAAM,aAAa,GAAG,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,GAAG,OAAO,EAAE,CAAC;QAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,mBAAmB,CAAI,IAAI,EAAE,aAAa,CAAC,CAAC;QAE/D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAwB,CAAC,CAAC;QAChD,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,CAAC,CAAC;QAEzG,OAAO,KAAK,CAAC;IACf,CAAC;IAKD,gBAAgB,CAAc,IAAY,EAAE,OAA4B;QACtE,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAc,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAI,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAKD,UAAU;QACR,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAKD,WAAW,CAAC,IAAY;QACtB,IAAI,IAAI,KAAK,kBAAkB,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;QAE3B,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,CAAC,CAAC;QAE5G,OAAO,IAAI,CAAC;IACd,CAAC;IAKD,cAAc;QACZ,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEnF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACjC,CAAC;QAED,MAAM,UAAU,GAAgB;YAC9B,IAAI,EAAE,CAAC;YACP,MAAM,EAAE,CAAC;YACT,OAAO,EAAE,CAAC;YACV,IAAI,EAAE,CAAC;YACP,WAAW,EAAE,CAAC;YACd,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,CAAC;YACd,aAAa,EAAE,CAAC;YAChB,aAAa,EAAE,CAAC;YAChB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,YAAY,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC;SAC1B,CAAC;QAEF,IAAI,eAAe,GAAG,CAAC,CAAC;QACxB,IAAI,eAAe,GAAG,CAAC,CAAC;QACxB,IAAI,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACjC,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,UAAU,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC;YAC9B,UAAU,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;YAClC,UAAU,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC;YAC9B,UAAU,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,CAAC;YAC5C,UAAU,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC;YACxC,UAAU,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,CAAC;YAC5C,eAAe,IAAI,KAAK,CAAC,aAAa,CAAC;YACvC,eAAe,IAAI,KAAK,CAAC,aAAa,CAAC;YAEvC,IAAI,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,eAAe,EAAE,CAAC;gBAChD,eAAe,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YAC9C,CAAC;YACD,IAAI,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,GAAG,YAAY,EAAE,CAAC;gBAChD,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YAC9C,CAAC;QACH,CAAC;QAED,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC;QAClD,UAAU,CAAC,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7D,UAAU,CAAC,aAAa,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACvF,UAAU,CAAC,aAAa,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACvF,UAAU,CAAC,SAAS,GAAG,IAAI,IAAI,CAAC,eAAe,CAAC,CAAC;QACjD,UAAU,CAAC,YAAY,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC;QAEjD,OAAO,UAAU,CAAC;IACpB,CAAC;IAKD,EAAE,CAAC,KAAqB,EAAE,QAA4B;QACpD,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;IACxE,CAAC;IAKD,GAAG,CAAC,KAAqB,EAAE,QAA4B;QACrD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;IACzE,CAAC;IAKD,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAE1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACzF,MAAM,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,YAAY,CAAC,kBAAkB,EAAE,CAAC;IACzC,CAAC;IAKO,mBAAmB,CAAI,IAAY,EAAE,OAA2B;QACtE,MAAM,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAEnD,QAAQ,SAAS,EAAE,CAAC;YAClB,KAAK,YAAY;gBACf,OAAO,IAAI,CAAC,oBAAoB,CAAI,IAAI,EAAE,OAAO,CAAC,CAAC;YACrD,KAAK,KAAK;gBACR,OAAO,IAAI,CAAC,cAAc,CAAI,IAAI,EAAE,OAAO,CAAC,CAAC;YAC/C,KAAK,KAAK,CAAC;YACX;gBACE,OAAO,IAAI,CAAC,cAAc,CAAI,IAAI,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAKO,kBAAkB,CAAC,OAA2B;QACpD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,OAAO,CAAC,IAAI,CAAC;QACtB,CAAC;QAED,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;YACpC,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,MAAM,MAAM,GAAmB,OAAO,CAAC,cAAc,IAAI,KAAK,CAAC;QAC/D,OAAO,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IAC1C,CAAC;IAKO,cAAc,CAAI,IAAY,EAAE,OAA2B;QACjE,MAAM,UAAU,GAAoB;YAClC,IAAI;YACJ,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,GAAG,EAAE,OAAO,CAAC,UAAU;YACvB,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;YAClD,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;YAClD,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;YAC5C,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;gBAC/B,IAAI,CAAC,SAAS,CAAC;oBACb,IAAI,EAAE,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;oBAC9E,GAAG;oBACH,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;iBACtB,CAAC,CAAC;YACL,CAAC;SACF,CAAC;QAEF,OAAO,IAAI,QAAQ,CAAI,UAAU,CAAc,CAAC;IAClD,CAAC;IAKO,cAAc,CAAI,IAAY,EAAE,OAA2B;QACjE,MAAM,UAAU,GAAoB;YAClC,IAAI;YACJ,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,GAAG,EAAE,OAAO,CAAC,UAAU;YACvB,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;YAClD,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;YAClD,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;gBAC/B,IAAI,CAAC,SAAS,CAAC;oBACb,IAAI,EAAE,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;oBAC9E,GAAG;oBACH,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;iBACtB,CAAC,CAAC;YACL,CAAC;SACF,CAAC;QAEF,OAAO,IAAI,QAAQ,CAAI,UAAU,CAAc,CAAC;IAClD,CAAC;IAKO,oBAAoB,CAAI,IAAY,EAAE,OAA2B;QACvE,MAAM,gBAAgB,GAA0B;YAC9C,IAAI;YACJ,EAAE,EAAE;gBACF,IAAI,EAAE,OAAO,CAAC,cAAc,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;gBACtD,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,IAAI,OAAO,CAAC,OAAO;gBAC/C,GAAG,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,IAAI,OAAO,CAAC,UAAU;gBAC1C,oBAAoB,EAAE,OAAO,CAAC,EAAE,EAAE,oBAAoB,IAAI,OAAO,CAAC,oBAAoB;gBACtF,oBAAoB,EAAE,OAAO,CAAC,EAAE,EAAE,oBAAoB,IAAI,OAAO,CAAC,oBAAoB;aACvF;YACD,EAAE,EAAE,OAAO,CAAC,EAAE;gBACZ,CAAC,CAAC;oBACE,MAAM,EAAE,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,EAAE,CAAC,MAAM;oBAC9C,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,MAAM;oBACzB,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;oBACnB,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC,UAAU;oBACjC,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC,WAAW;oBACnC,oBAAoB,EAAE,OAAO,CAAC,EAAE,CAAC,oBAAoB;oBACrD,oBAAoB,EAAE,OAAO,CAAC,EAAE,CAAC,oBAAoB;iBACtD;gBACH,CAAC,CAAC,SAAS;YACb,aAAa,EAAE,SAAS;YACxB,WAAW,EAAE,IAAI;YACjB,kBAAkB,EAAE,CAAC;YACrB,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC;QAEF,OAAO,IAAI,cAAc,CAAI,gBAAgB,CAAc,CAAC;IAC9D,CAAC;IAKO,SAAS,CAAC,KAAkB;QAClC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC;IAKO,gBAAgB;QACtB,OAAO;YACL,IAAI,EAAE,CAAC;YACP,MAAM,EAAE,CAAC;YACT,OAAO,EAAE,CAAC;YACV,IAAI,EAAE,CAAC;YACP,WAAW,EAAE,CAAC;YACd,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,CAAC;YACd,aAAa,EAAE,CAAC;YAChB,aAAa,EAAE,CAAC;YAChB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,YAAY,EAAE,IAAI,IAAI,EAAE;SACzB,CAAC;IACJ,CAAC;CACF,CAAA;AAhUY,YAAY;IADxB,UAAU,EAAE;;GACA,YAAY,CAgUxB"}
@@ -0,0 +1,10 @@
1
+ import { type Token } from '@omnitron-dev/titan/nexus';
2
+ import type { ICacheService, ICache, ICacheModuleOptions } from './cache.types.js';
3
+ export declare const CACHE_SERVICE_TOKEN: Token<ICacheService>;
4
+ export declare const CACHE_DEFAULT_TOKEN: Token<ICache>;
5
+ export declare const CACHE_OPTIONS_TOKEN: Token<ICacheModuleOptions>;
6
+ export declare function getCacheToken(name: string): Token<ICache>;
7
+ export declare const CACHE_ADAPTER_TOKEN: Token<import('./cache.adapter.js').CacheAdapter>;
8
+ export declare const CACHE_ADAPTER_OPTIONS_TOKEN: Token<import('./cache.adapter.js').ICacheAdapterOptions>;
9
+ export declare const DEFAULT_CACHE_NAME = "default";
10
+ //# sourceMappingURL=cache.tokens.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache.tokens.d.ts","sourceRoot":"","sources":["../src/cache.tokens.ts"],"names":[],"mappings":"AAQA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAKnF,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,aAAa,CAA8C,CAAC;AAKpG,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAwC,CAAC;AAKvF,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,mBAAmB,CAAoD,CAAC;AAKhH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAEzD;AAKD,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,OAAO,oBAAoB,EAAE,YAAY,CAA0E,CAAC;AAK5J,eAAO,MAAM,2BAA2B,EAAE,KAAK,CAAC,OAAO,oBAAoB,EAAE,oBAAoB,CACV,CAAC;AAKxF,eAAO,MAAM,kBAAkB,YAAY,CAAC"}
@@ -0,0 +1,11 @@
1
+ import { createToken } from '@omnitron-dev/titan/nexus';
2
+ export const CACHE_SERVICE_TOKEN = createToken('CacheService');
3
+ export const CACHE_DEFAULT_TOKEN = createToken('Cache:Default');
4
+ export const CACHE_OPTIONS_TOKEN = createToken('CacheOptions');
5
+ export function getCacheToken(name) {
6
+ return createToken(`Cache:${name}`);
7
+ }
8
+ export const CACHE_ADAPTER_TOKEN = createToken('CacheAdapter');
9
+ export const CACHE_ADAPTER_OPTIONS_TOKEN = createToken('CacheAdapterOptions');
10
+ export const DEFAULT_CACHE_NAME = 'default';
11
+ //# sourceMappingURL=cache.tokens.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache.tokens.js","sourceRoot":"","sources":["../src/cache.tokens.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAc,MAAM,2BAA2B,CAAC;AAMpE,MAAM,CAAC,MAAM,mBAAmB,GAAyB,WAAW,CAAgB,cAAc,CAAC,CAAC;AAKpG,MAAM,CAAC,MAAM,mBAAmB,GAAkB,WAAW,CAAS,eAAe,CAAC,CAAC;AAKvF,MAAM,CAAC,MAAM,mBAAmB,GAA+B,WAAW,CAAsB,cAAc,CAAC,CAAC;AAKhH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,WAAW,CAAS,SAAS,IAAI,EAAE,CAAC,CAAC;AAC9C,CAAC;AAKD,MAAM,CAAC,MAAM,mBAAmB,GAAqD,WAAW,CAA4C,cAAc,CAAC,CAAC;AAK5J,MAAM,CAAC,MAAM,2BAA2B,GACtC,WAAW,CAAoD,qBAAqB,CAAC,CAAC;AAKxF,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAC"}
@@ -0,0 +1,185 @@
1
+ export type EvictionPolicy = 'lru' | 'lfu' | 'fifo' | 'random' | 'ttl';
2
+ export type CacheTier = 'l1' | 'l2';
3
+ export type CacheEntryState = 'fresh' | 'stale' | 'expired';
4
+ export type CompressionAlgorithm = 'gzip' | 'deflate' | 'brotli' | 'lz4' | 'none';
5
+ export interface ICacheStats {
6
+ hits: number;
7
+ misses: number;
8
+ hitRate: number;
9
+ size: number;
10
+ memoryUsage: number;
11
+ evictions: number;
12
+ expirations: number;
13
+ avgGetLatency: number;
14
+ avgSetLatency: number;
15
+ createdAt: Date;
16
+ lastAccessAt: Date;
17
+ l1?: ICacheStats;
18
+ l2?: ICacheStats;
19
+ }
20
+ export interface ICacheEntryMeta {
21
+ createdAt: number;
22
+ lastAccessAt: number;
23
+ expiresAt: number;
24
+ accessCount: number;
25
+ size: number;
26
+ compressed: boolean;
27
+ compressionAlgorithm?: CompressionAlgorithm;
28
+ originalSize?: number;
29
+ tags?: string[];
30
+ metadata?: Record<string, unknown>;
31
+ }
32
+ export interface ICacheEntry<T = unknown> {
33
+ key: string;
34
+ value: T;
35
+ meta: ICacheEntryMeta;
36
+ }
37
+ export interface ICacheSetOptions {
38
+ ttl?: number;
39
+ tags?: string[];
40
+ compress?: boolean;
41
+ skipL2?: boolean;
42
+ metadata?: Record<string, unknown>;
43
+ onExpire?: (key: string, value: unknown) => void;
44
+ }
45
+ export interface ICacheGetOptions {
46
+ staleWhileRevalidate?: boolean;
47
+ skipL1?: boolean;
48
+ touch?: boolean;
49
+ }
50
+ export interface ICacheWarmingStrategy {
51
+ name: string;
52
+ keys?: string[];
53
+ pattern?: RegExp;
54
+ loader?: () => Promise<Map<string, unknown>>;
55
+ priority?: number;
56
+ }
57
+ export interface ICachePartition {
58
+ name: string;
59
+ maxSize?: number;
60
+ ttl?: number;
61
+ evictionPolicy?: EvictionPolicy;
62
+ prefix?: string;
63
+ }
64
+ export interface IL1CacheOptions {
65
+ maxSize?: number;
66
+ ttl?: number;
67
+ evictionPolicy?: EvictionPolicy;
68
+ useWeakRef?: boolean;
69
+ compressionThreshold?: number;
70
+ compressionAlgorithm?: CompressionAlgorithm;
71
+ }
72
+ export interface IL2CacheOptions {
73
+ client?: unknown;
74
+ maxSize?: number;
75
+ ttl?: number;
76
+ prefix?: string;
77
+ serializer?: ICacheSerializer;
78
+ compression?: boolean;
79
+ compressionAlgorithm?: CompressionAlgorithm;
80
+ compressionThreshold?: number;
81
+ }
82
+ export interface ICacheSerializer {
83
+ serialize(value: unknown): Buffer | Uint8Array;
84
+ deserialize<T>(data: Buffer | Uint8Array): T;
85
+ }
86
+ export interface ICacheModuleOptions {
87
+ multiTier?: boolean;
88
+ l1?: IL1CacheOptions;
89
+ l2?: IL2CacheOptions;
90
+ defaultTtl?: number;
91
+ maxSize?: number;
92
+ evictionPolicy?: EvictionPolicy;
93
+ enableStats?: boolean;
94
+ statsInterval?: number;
95
+ partitions?: ICachePartition[];
96
+ warmingStrategies?: ICacheWarmingStrategy[];
97
+ useWeakRef?: boolean;
98
+ compressionThreshold?: number;
99
+ compressionAlgorithm?: CompressionAlgorithm;
100
+ ttlCleanupInterval?: number;
101
+ wheelTimerBuckets?: number;
102
+ isGlobal?: boolean;
103
+ staleWhileRevalidate?: number;
104
+ backgroundRefresh?: boolean;
105
+ }
106
+ export interface ICacheModuleAsyncOptions {
107
+ useFactory?: (...args: unknown[]) => Promise<ICacheModuleOptions> | ICacheModuleOptions;
108
+ inject?: unknown[];
109
+ imports?: unknown[];
110
+ isGlobal?: boolean;
111
+ }
112
+ export interface ICache<T = unknown> {
113
+ get(key: string, options?: ICacheGetOptions): Promise<T | undefined>;
114
+ set(key: string, value: T, options?: ICacheSetOptions): Promise<void>;
115
+ has(key: string): Promise<boolean>;
116
+ delete(key: string): Promise<boolean>;
117
+ clear(pattern?: string | RegExp): Promise<void>;
118
+ invalidateByTags(tags: string[]): Promise<number>;
119
+ getMany(keys: string[]): Promise<Map<string, T | undefined>>;
120
+ setMany(entries: Map<string, T>, options?: ICacheSetOptions): Promise<void>;
121
+ getStats(): ICacheStats;
122
+ resetStats(): void;
123
+ getEntry(key: string): Promise<ICacheEntry<T> | undefined>;
124
+ keys(pattern?: string | RegExp): Promise<string[]>;
125
+ size(): Promise<number>;
126
+ warm(strategies?: ICacheWarmingStrategy[]): Promise<void>;
127
+ partition(name: string): ICache<T>;
128
+ dispose(): Promise<void>;
129
+ }
130
+ export interface IMultiTierCache<T = unknown> extends ICache<T> {
131
+ getL1(): ICache<T>;
132
+ getL2(): ICache<T>;
133
+ promote(key: string): Promise<boolean>;
134
+ demote(key: string): Promise<boolean>;
135
+ sync(): Promise<void>;
136
+ getTierStats(tier: CacheTier): ICacheStats;
137
+ }
138
+ export interface ICacheHealthIndicator {
139
+ readonly name: string;
140
+ check(): Promise<{
141
+ status: 'healthy' | 'degraded' | 'unhealthy';
142
+ message?: string;
143
+ details?: Record<string, unknown>;
144
+ }>;
145
+ }
146
+ export interface ILRUNode<T = unknown> {
147
+ key: string;
148
+ value: T;
149
+ meta: ICacheEntryMeta;
150
+ prev: ILRUNode<T> | null;
151
+ next: ILRUNode<T> | null;
152
+ }
153
+ export interface ILFUNode<T = unknown> {
154
+ key: string;
155
+ value: T;
156
+ meta: ICacheEntryMeta;
157
+ frequency: number;
158
+ }
159
+ export interface IWheelTimerBucket {
160
+ index: number;
161
+ keys: Set<string>;
162
+ expiresAt: number;
163
+ }
164
+ export type CacheEventType = 'hit' | 'miss' | 'set' | 'delete' | 'evict' | 'expire' | 'clear' | 'warm' | 'promote' | 'demote' | 'error';
165
+ export interface ICacheEvent {
166
+ type: CacheEventType;
167
+ key?: string;
168
+ tier?: CacheTier;
169
+ timestamp: number;
170
+ latency?: number;
171
+ metadata?: Record<string, unknown>;
172
+ }
173
+ export type CacheEventListener = (event: ICacheEvent) => void;
174
+ export interface ICacheService {
175
+ getCache<T = unknown>(name?: string): ICache<T>;
176
+ createCache<T = unknown>(name: string, options?: ICacheModuleOptions): ICache<T>;
177
+ getOrCreateCache<T = unknown>(name: string, options?: ICacheModuleOptions): ICache<T>;
178
+ listCaches(): string[];
179
+ deleteCache(name: string): boolean;
180
+ getGlobalStats(): ICacheStats;
181
+ on(event: CacheEventType, listener: CacheEventListener): void;
182
+ off(event: CacheEventType, listener: CacheEventListener): void;
183
+ dispose(): Promise<void>;
184
+ }
185
+ //# sourceMappingURL=cache.types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache.types.d.ts","sourceRoot":"","sources":["../src/cache.types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=cache.types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache.types.js","sourceRoot":"","sources":["../src/cache.types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,44 @@
1
+ import type { CompressionAlgorithm } from './cache.types.js';
2
+ export declare function compressValue(value: unknown, algorithm: CompressionAlgorithm): Promise<Buffer>;
3
+ export declare function decompressValue<T>(data: Buffer, algorithm: CompressionAlgorithm): Promise<T>;
4
+ export declare function estimateSize(value: unknown): number;
5
+ export declare function getExactSize(value: unknown): number;
6
+ export declare function deepClone<T>(value: T): T;
7
+ export declare function hashKey(key: string): number;
8
+ export declare function generateCacheKey(...parts: (string | number | boolean | undefined | null)[]): string;
9
+ export declare function parseCacheKey(key: string): string[];
10
+ export declare function isSerializable(value: unknown): boolean;
11
+ export declare function formatBytes(bytes: number): string;
12
+ export declare function calculateHitRate(hits: number, misses: number): string;
13
+ export declare function createTtlCalculator(baseTtl: number, jitterPercent?: number): () => number;
14
+ export declare function debounce<T extends (...args: unknown[]) => unknown>(fn: T, wait: number): (...args: Parameters<T>) => void;
15
+ export declare function throttle<T extends (...args: unknown[]) => unknown>(fn: T, limit: number): T;
16
+ export declare function createMessagePackSerializer(): Promise<{
17
+ serialize: (value: unknown) => Buffer;
18
+ deserialize: <T>(data: Buffer) => T;
19
+ }>;
20
+ export declare class Singleflight<T = unknown> {
21
+ private readonly inflight;
22
+ do(key: string, fn: () => Promise<T>): Promise<T>;
23
+ has(key: string): boolean;
24
+ get size(): number;
25
+ clear(): void;
26
+ }
27
+ export declare function createCacheGetOrSet<T>(cache: {
28
+ get: (key: string) => Promise<T | undefined>;
29
+ set: (key: string, value: T, options?: {
30
+ ttl?: number;
31
+ }) => Promise<void>;
32
+ }, singleflight?: Singleflight<T>): (key: string, factory: () => Promise<T>, options?: {
33
+ ttl?: number;
34
+ }) => Promise<T>;
35
+ export declare class AsyncMutex {
36
+ private queue;
37
+ private locked;
38
+ acquire(): Promise<void>;
39
+ release(): void;
40
+ runExclusive<T>(fn: () => Promise<T>): Promise<T>;
41
+ isLocked(): boolean;
42
+ get waitersCount(): number;
43
+ }
44
+ //# sourceMappingURL=cache.utils.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache.utils.d.ts","sourceRoot":"","sources":["../src/cache.utils.ts"],"names":[],"mappings":"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"}