@argos-js/cache 0.0.0-stage → 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.
- package/LICENSE +21 -0
- package/README.md +116 -2
- package/dist/cache-manager.d.ts +40 -0
- package/dist/cache-manager.d.ts.map +1 -0
- package/dist/cache-manager.js +168 -0
- package/dist/cache-manager.js.map +1 -0
- package/dist/drivers/argosdb.driver.d.ts +25 -0
- package/dist/drivers/argosdb.driver.d.ts.map +1 -0
- package/dist/drivers/argosdb.driver.js +145 -0
- package/dist/drivers/argosdb.driver.js.map +1 -0
- package/dist/drivers/memory.driver.d.ts +30 -0
- package/dist/drivers/memory.driver.d.ts.map +1 -0
- package/dist/drivers/memory.driver.js +146 -0
- package/dist/drivers/memory.driver.js.map +1 -0
- package/dist/drivers/pulse.driver.d.ts +40 -0
- package/dist/drivers/pulse.driver.d.ts.map +1 -0
- package/dist/drivers/pulse.driver.js +182 -0
- package/dist/drivers/pulse.driver.js.map +1 -0
- package/dist/drivers/redis.driver.d.ts +24 -0
- package/dist/drivers/redis.driver.d.ts.map +1 -0
- package/dist/drivers/redis.driver.js +128 -0
- package/dist/drivers/redis.driver.js.map +1 -0
- package/dist/index.d.ts +7 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +23 -0
- package/dist/index.js.map +1 -0
- package/dist/types.d.ts +168 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +3 -0
- package/dist/types.js.map +1 -0
- package/package.json +35 -3
|
@@ -0,0 +1,146 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.MemoryCacheDriver = void 0;
|
|
4
|
+
/**
|
|
5
|
+
* Ultra-fast In-Memory cache driver with LRU eviction, TTL expiration, and tag indexing.
|
|
6
|
+
* Pure Web API based (Map, Date) with zero external dependencies.
|
|
7
|
+
*/
|
|
8
|
+
class MemoryCacheDriver {
|
|
9
|
+
name = 'memory';
|
|
10
|
+
store = new Map();
|
|
11
|
+
tagIndex = new Map(); // tag -> Set of keys
|
|
12
|
+
maxItems;
|
|
13
|
+
defaultTtl;
|
|
14
|
+
accessCounter = 0;
|
|
15
|
+
constructor(config = {}) {
|
|
16
|
+
this.maxItems = config.maxItems && config.maxItems > 0 ? config.maxItems : 10000;
|
|
17
|
+
this.defaultTtl = config.defaultTtl;
|
|
18
|
+
}
|
|
19
|
+
async get(key) {
|
|
20
|
+
const entry = this.store.get(key);
|
|
21
|
+
if (!entry) {
|
|
22
|
+
return null;
|
|
23
|
+
}
|
|
24
|
+
const now = Date.now();
|
|
25
|
+
if (entry.expiresAt !== null && now > entry.expiresAt) {
|
|
26
|
+
this.deleteInternal(key);
|
|
27
|
+
return null;
|
|
28
|
+
}
|
|
29
|
+
entry.lastAccessed = ++this.accessCounter;
|
|
30
|
+
return entry.value;
|
|
31
|
+
}
|
|
32
|
+
async set(key, value, options) {
|
|
33
|
+
const now = Date.now();
|
|
34
|
+
const ttlSeconds = options?.ttl ?? this.defaultTtl;
|
|
35
|
+
const expiresAt = ttlSeconds && ttlSeconds > 0 ? now + ttlSeconds * 1000 : null;
|
|
36
|
+
// Check if key is new and store is full -> evict least recently used (LRU)
|
|
37
|
+
if (!this.store.has(key) && this.store.size >= this.maxItems) {
|
|
38
|
+
this.evictLru();
|
|
39
|
+
}
|
|
40
|
+
// Clean old tags for this key if key already exists
|
|
41
|
+
if (this.store.has(key)) {
|
|
42
|
+
this.removeKeyFromTagIndex(key);
|
|
43
|
+
}
|
|
44
|
+
const tags = new Set(options?.tags || []);
|
|
45
|
+
const entry = {
|
|
46
|
+
value,
|
|
47
|
+
expiresAt,
|
|
48
|
+
tags,
|
|
49
|
+
lastAccessed: ++this.accessCounter,
|
|
50
|
+
};
|
|
51
|
+
this.store.set(key, entry);
|
|
52
|
+
// Index tags
|
|
53
|
+
for (const tag of tags) {
|
|
54
|
+
let keySet = this.tagIndex.get(tag);
|
|
55
|
+
if (!keySet) {
|
|
56
|
+
keySet = new Set();
|
|
57
|
+
this.tagIndex.set(tag, keySet);
|
|
58
|
+
}
|
|
59
|
+
keySet.add(key);
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
async delete(key) {
|
|
63
|
+
return this.deleteInternal(key);
|
|
64
|
+
}
|
|
65
|
+
async deleteMany(keys) {
|
|
66
|
+
let deletedCount = 0;
|
|
67
|
+
for (const key of keys) {
|
|
68
|
+
if (this.deleteInternal(key)) {
|
|
69
|
+
deletedCount++;
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
return deletedCount;
|
|
73
|
+
}
|
|
74
|
+
async has(key) {
|
|
75
|
+
const val = await this.get(key);
|
|
76
|
+
return val !== null;
|
|
77
|
+
}
|
|
78
|
+
async clear() {
|
|
79
|
+
this.store.clear();
|
|
80
|
+
this.tagIndex.clear();
|
|
81
|
+
}
|
|
82
|
+
async invalidateByTag(tag) {
|
|
83
|
+
const keySet = this.tagIndex.get(tag);
|
|
84
|
+
if (!keySet || keySet.size === 0) {
|
|
85
|
+
return;
|
|
86
|
+
}
|
|
87
|
+
const keysToDelete = Array.from(keySet);
|
|
88
|
+
for (const key of keysToDelete) {
|
|
89
|
+
this.deleteInternal(key);
|
|
90
|
+
}
|
|
91
|
+
this.tagIndex.delete(tag);
|
|
92
|
+
}
|
|
93
|
+
async disconnect() {
|
|
94
|
+
await this.clear();
|
|
95
|
+
}
|
|
96
|
+
/**
|
|
97
|
+
* Returns current count of entries in memory cache.
|
|
98
|
+
*/
|
|
99
|
+
get size() {
|
|
100
|
+
return this.store.size;
|
|
101
|
+
}
|
|
102
|
+
deleteInternal(key) {
|
|
103
|
+
const entry = this.store.get(key);
|
|
104
|
+
if (!entry) {
|
|
105
|
+
return false;
|
|
106
|
+
}
|
|
107
|
+
this.removeKeyFromTagIndex(key);
|
|
108
|
+
this.store.delete(key);
|
|
109
|
+
return true;
|
|
110
|
+
}
|
|
111
|
+
removeKeyFromTagIndex(key) {
|
|
112
|
+
const entry = this.store.get(key);
|
|
113
|
+
if (!entry)
|
|
114
|
+
return;
|
|
115
|
+
for (const tag of entry.tags) {
|
|
116
|
+
const keySet = this.tagIndex.get(tag);
|
|
117
|
+
if (keySet) {
|
|
118
|
+
keySet.delete(key);
|
|
119
|
+
if (keySet.size === 0) {
|
|
120
|
+
this.tagIndex.delete(tag);
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
evictLru() {
|
|
126
|
+
let oldestKey = null;
|
|
127
|
+
let oldestAccess = Infinity;
|
|
128
|
+
const now = Date.now();
|
|
129
|
+
// First check for any expired keys to evict without touching active LRU
|
|
130
|
+
for (const [key, entry] of this.store.entries()) {
|
|
131
|
+
if (entry.expiresAt !== null && now > entry.expiresAt) {
|
|
132
|
+
this.deleteInternal(key);
|
|
133
|
+
return;
|
|
134
|
+
}
|
|
135
|
+
if (entry.lastAccessed < oldestAccess) {
|
|
136
|
+
oldestAccess = entry.lastAccessed;
|
|
137
|
+
oldestKey = key;
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
if (oldestKey) {
|
|
141
|
+
this.deleteInternal(oldestKey);
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
exports.MemoryCacheDriver = MemoryCacheDriver;
|
|
146
|
+
//# sourceMappingURL=memory.driver.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"memory.driver.js","sourceRoot":"","sources":["../../src/drivers/memory.driver.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import { MemoryCacheDriver } from './memory.driver.js';
|
|
2
|
+
import type { CacheDriver, PulseNearCacheConfig, SetOptions } from '../types.js';
|
|
3
|
+
import { type MutationEvent } from '@argos-js/events';
|
|
4
|
+
/**
|
|
5
|
+
* High-performance Near-Cache driver for ArgosDB.
|
|
6
|
+
*
|
|
7
|
+
* Architecture:
|
|
8
|
+
* - L1: In-memory RAM cache with microsecond reads (< 0.05ms) and zero network overhead.
|
|
9
|
+
* - Invalidation: Reactively listens to ArgosDB Pulse CDC mutation streams (UPDATE, DELETE).
|
|
10
|
+
* Instantly invalidates stale cache entries in the same event cycle when the database changes.
|
|
11
|
+
*/
|
|
12
|
+
export declare class PulseNearCacheDriver implements CacheDriver {
|
|
13
|
+
readonly name = "pulse";
|
|
14
|
+
private l1;
|
|
15
|
+
private watchedTables;
|
|
16
|
+
private listenCdc;
|
|
17
|
+
private keyResolver?;
|
|
18
|
+
private eventsClient;
|
|
19
|
+
private cdcSubscriptions;
|
|
20
|
+
constructor(config?: PulseNearCacheConfig);
|
|
21
|
+
/**
|
|
22
|
+
* Returns internal L1 memory cache instance.
|
|
23
|
+
*/
|
|
24
|
+
getL1(): MemoryCacheDriver;
|
|
25
|
+
get<T = unknown>(key: string): Promise<T | null>;
|
|
26
|
+
set<T = unknown>(key: string, value: T, options?: SetOptions): Promise<void>;
|
|
27
|
+
delete(key: string): Promise<boolean>;
|
|
28
|
+
deleteMany(keys: string[]): Promise<number>;
|
|
29
|
+
has(key: string): Promise<boolean>;
|
|
30
|
+
clear(): Promise<void>;
|
|
31
|
+
invalidateByTag(tag: string): Promise<void>;
|
|
32
|
+
disconnect(): Promise<void>;
|
|
33
|
+
/**
|
|
34
|
+
* Processes an incoming MutationEvent from CDC and invalidates corresponding L1 cache keys.
|
|
35
|
+
*/
|
|
36
|
+
handleMutation(event: MutationEvent): Promise<void>;
|
|
37
|
+
private decodePrimaryKey;
|
|
38
|
+
private initCdcListener;
|
|
39
|
+
}
|
|
40
|
+
//# sourceMappingURL=pulse.driver.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pulse.driver.d.ts","sourceRoot":"","sources":["../../src/drivers/pulse.driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAc,KAAK,aAAa,EAAqB,MAAM,kBAAkB,CAAC;AAErF;;;;;;;GAOG;AACH,qBAAa,oBAAqB,YAAW,WAAW;IACtD,SAAgB,IAAI,WAAW;IAE/B,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAkE;IACtF,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,gBAAgB,CAAsB;gBAElC,MAAM,GAAE,oBAAyB;IAqB7C;;OAEG;IACI,KAAK,IAAI,iBAAiB;IAIpB,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAIhD,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQxC;;OAEG;IACU,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAgDhE,OAAO,CAAC,gBAAgB;YAgBV,eAAe;CAmD9B"}
|
|
@@ -0,0 +1,182 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.PulseNearCacheDriver = void 0;
|
|
4
|
+
const memory_driver_js_1 = require("./memory.driver.js");
|
|
5
|
+
const events_1 = require("@argos-js/events");
|
|
6
|
+
/**
|
|
7
|
+
* High-performance Near-Cache driver for ArgosDB.
|
|
8
|
+
*
|
|
9
|
+
* Architecture:
|
|
10
|
+
* - L1: In-memory RAM cache with microsecond reads (< 0.05ms) and zero network overhead.
|
|
11
|
+
* - Invalidation: Reactively listens to ArgosDB Pulse CDC mutation streams (UPDATE, DELETE).
|
|
12
|
+
* Instantly invalidates stale cache entries in the same event cycle when the database changes.
|
|
13
|
+
*/
|
|
14
|
+
class PulseNearCacheDriver {
|
|
15
|
+
name = 'pulse';
|
|
16
|
+
l1;
|
|
17
|
+
watchedTables;
|
|
18
|
+
listenCdc;
|
|
19
|
+
keyResolver;
|
|
20
|
+
eventsClient;
|
|
21
|
+
cdcSubscriptions = [];
|
|
22
|
+
constructor(config = {}) {
|
|
23
|
+
this.l1 = new memory_driver_js_1.MemoryCacheDriver({
|
|
24
|
+
maxItems: config.maxItems,
|
|
25
|
+
defaultTtl: config.defaultTtl,
|
|
26
|
+
});
|
|
27
|
+
this.watchedTables = new Set(config.watchedTables || []);
|
|
28
|
+
this.listenCdc = config.listenCdc ?? true;
|
|
29
|
+
this.keyResolver = config.keyResolver;
|
|
30
|
+
this.eventsClient = config.events;
|
|
31
|
+
if (this.listenCdc) {
|
|
32
|
+
this.initCdcListener().catch((err) => {
|
|
33
|
+
// Log warning if broker is offline during instantiation
|
|
34
|
+
if (typeof console !== 'undefined') {
|
|
35
|
+
console.warn(`[PulseNearCacheDriver] Background CDC subscription note: ${err?.message || err}`);
|
|
36
|
+
}
|
|
37
|
+
});
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Returns internal L1 memory cache instance.
|
|
42
|
+
*/
|
|
43
|
+
getL1() {
|
|
44
|
+
return this.l1;
|
|
45
|
+
}
|
|
46
|
+
async get(key) {
|
|
47
|
+
return await this.l1.get(key);
|
|
48
|
+
}
|
|
49
|
+
async set(key, value, options) {
|
|
50
|
+
await this.l1.set(key, value, options);
|
|
51
|
+
}
|
|
52
|
+
async delete(key) {
|
|
53
|
+
return await this.l1.delete(key);
|
|
54
|
+
}
|
|
55
|
+
async deleteMany(keys) {
|
|
56
|
+
return await this.l1.deleteMany(keys);
|
|
57
|
+
}
|
|
58
|
+
async has(key) {
|
|
59
|
+
return await this.l1.has(key);
|
|
60
|
+
}
|
|
61
|
+
async clear() {
|
|
62
|
+
await this.l1.clear();
|
|
63
|
+
}
|
|
64
|
+
async invalidateByTag(tag) {
|
|
65
|
+
await this.l1.invalidateByTag(tag);
|
|
66
|
+
}
|
|
67
|
+
async disconnect() {
|
|
68
|
+
for (const sub of this.cdcSubscriptions) {
|
|
69
|
+
await sub.unsubscribe().catch(() => { });
|
|
70
|
+
}
|
|
71
|
+
this.cdcSubscriptions = [];
|
|
72
|
+
await this.l1.disconnect();
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
* Processes an incoming MutationEvent from CDC and invalidates corresponding L1 cache keys.
|
|
76
|
+
*/
|
|
77
|
+
async handleMutation(event) {
|
|
78
|
+
// Only UPDATE and DELETE mutate or destroy existing entity state
|
|
79
|
+
if (event.op !== events_1.MutationOp.Update && event.op !== events_1.MutationOp.Delete) {
|
|
80
|
+
return;
|
|
81
|
+
}
|
|
82
|
+
const tableName = event.tableName;
|
|
83
|
+
if (this.watchedTables.size > 0 && !this.watchedTables.has(tableName)) {
|
|
84
|
+
return;
|
|
85
|
+
}
|
|
86
|
+
// Decode primary key from Uint8Array
|
|
87
|
+
const pkStr = this.decodePrimaryKey(event.primaryKey);
|
|
88
|
+
if (!pkStr) {
|
|
89
|
+
return;
|
|
90
|
+
}
|
|
91
|
+
// Resolve keys to invalidate
|
|
92
|
+
const keysToInvalidate = [];
|
|
93
|
+
if (this.keyResolver) {
|
|
94
|
+
const customKeys = this.keyResolver(tableName, pkStr, event.op);
|
|
95
|
+
if (Array.isArray(customKeys)) {
|
|
96
|
+
keysToInvalidate.push(...customKeys);
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
else {
|
|
100
|
+
// Standard ArgosDB convention resolvers
|
|
101
|
+
keysToInvalidate.push(`${tableName}:${pkStr}`);
|
|
102
|
+
// Strip prefixes or pluralization (e.g. 'auth_users' -> 'user', 'users' -> 'user')
|
|
103
|
+
const singular = tableName.replace(/^auth_/, '').replace(/s$/, '');
|
|
104
|
+
if (singular && singular !== tableName) {
|
|
105
|
+
keysToInvalidate.push(`${singular}:${pkStr}`);
|
|
106
|
+
}
|
|
107
|
+
keysToInvalidate.push(pkStr);
|
|
108
|
+
}
|
|
109
|
+
// Delete matching cache entries
|
|
110
|
+
for (const key of keysToInvalidate) {
|
|
111
|
+
await this.l1.delete(key);
|
|
112
|
+
}
|
|
113
|
+
// Also invalidate by table tag if present
|
|
114
|
+
await this.l1.invalidateByTag(tableName);
|
|
115
|
+
await this.l1.invalidateByTag(`table:${tableName}`);
|
|
116
|
+
}
|
|
117
|
+
decodePrimaryKey(pkBytes) {
|
|
118
|
+
if (!pkBytes || pkBytes.byteLength === 0) {
|
|
119
|
+
return '';
|
|
120
|
+
}
|
|
121
|
+
try {
|
|
122
|
+
const text = new TextDecoder().decode(pkBytes).trim();
|
|
123
|
+
// Handle JSON quoted strings if applicable
|
|
124
|
+
if (text.startsWith('"') && text.endsWith('"')) {
|
|
125
|
+
return JSON.parse(text);
|
|
126
|
+
}
|
|
127
|
+
return text;
|
|
128
|
+
}
|
|
129
|
+
catch {
|
|
130
|
+
return '';
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
async initCdcListener() {
|
|
134
|
+
let eventsMgr = this.eventsClient;
|
|
135
|
+
if (!eventsMgr) {
|
|
136
|
+
try {
|
|
137
|
+
const eventsPkg = await import('@argos-js/events');
|
|
138
|
+
eventsMgr = eventsPkg.events;
|
|
139
|
+
}
|
|
140
|
+
catch {
|
|
141
|
+
// @argos-js/events not available in current scope
|
|
142
|
+
return;
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
if (!eventsMgr || typeof eventsMgr.subscribe !== 'function') {
|
|
146
|
+
return;
|
|
147
|
+
}
|
|
148
|
+
const patterns = this.watchedTables.size > 0
|
|
149
|
+
? Array.from(this.watchedTables).map((table) => `cdc.${table}.*`)
|
|
150
|
+
: ['cdc.#', 'cdc.*'];
|
|
151
|
+
for (const pattern of patterns) {
|
|
152
|
+
try {
|
|
153
|
+
// If subscribeGroup is available, use consumer group to avoid duplicate work if desired,
|
|
154
|
+
// or simple pub/sub subscribe to ensure every local worker invalidates its own L1 cache.
|
|
155
|
+
// For Near-Cache, broadcast subscribe ensures ALL cluster node L1s invalidate!
|
|
156
|
+
const sub = await eventsMgr.subscribe(pattern, async (message) => {
|
|
157
|
+
if (message?.event && typeof message.event.op === 'number') {
|
|
158
|
+
await this.handleMutation(message.event);
|
|
159
|
+
}
|
|
160
|
+
else if (message?.payload?.op !== undefined && message?.payload?.tableName) {
|
|
161
|
+
// Adapted event message
|
|
162
|
+
await this.handleMutation({
|
|
163
|
+
...message.payload,
|
|
164
|
+
primaryKey: message.payload.primaryKey instanceof Uint8Array
|
|
165
|
+
? message.payload.primaryKey
|
|
166
|
+
: new TextEncoder().encode(String(message.payload.primaryKey || '')),
|
|
167
|
+
jsonPayload: () => message.payload.afterPayload,
|
|
168
|
+
});
|
|
169
|
+
}
|
|
170
|
+
});
|
|
171
|
+
this.cdcSubscriptions.push(sub);
|
|
172
|
+
}
|
|
173
|
+
catch (err) {
|
|
174
|
+
if (typeof console !== 'undefined') {
|
|
175
|
+
console.warn(`[PulseNearCacheDriver] Could not subscribe to CDC pattern "${pattern}": ${err.message}`);
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
}
|
|
181
|
+
exports.PulseNearCacheDriver = PulseNearCacheDriver;
|
|
182
|
+
//# sourceMappingURL=pulse.driver.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pulse.driver.js","sourceRoot":"","sources":["../../src/drivers/pulse.driver.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import type { CacheDriver, RedisCacheConfig, SetOptions } from '../types.js';
|
|
2
|
+
/**
|
|
3
|
+
* Pluggable Redis cache driver.
|
|
4
|
+
* Supports custom pre-configured client instances or standalone connections via ioredis.
|
|
5
|
+
* Gracefully handles missing 'ioredis' peer dependency without breaking build or runtime.
|
|
6
|
+
*/
|
|
7
|
+
export declare class RedisCacheDriver implements CacheDriver {
|
|
8
|
+
readonly name = "redis";
|
|
9
|
+
private client;
|
|
10
|
+
private config;
|
|
11
|
+
private connected;
|
|
12
|
+
constructor(config?: RedisCacheConfig);
|
|
13
|
+
isConnected(): boolean;
|
|
14
|
+
private getClient;
|
|
15
|
+
get<T = unknown>(key: string): Promise<T | null>;
|
|
16
|
+
set<T = unknown>(key: string, value: T, options?: SetOptions): Promise<void>;
|
|
17
|
+
delete(key: string): Promise<boolean>;
|
|
18
|
+
deleteMany(keys: string[]): Promise<number>;
|
|
19
|
+
has(key: string): Promise<boolean>;
|
|
20
|
+
clear(): Promise<void>;
|
|
21
|
+
invalidateByTag(tag: string): Promise<void>;
|
|
22
|
+
disconnect(): Promise<void>;
|
|
23
|
+
}
|
|
24
|
+
//# sourceMappingURL=redis.driver.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"redis.driver.d.ts","sourceRoot":"","sources":["../../src/drivers/redis.driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE7E;;;;GAIG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAClD,SAAgB,IAAI,WAAW;IAE/B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,GAAE,gBAAqB;IAQlC,WAAW,IAAI,OAAO;YAIf,SAAS;IAgCV,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAahD,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB5E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMrC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAM3C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAWzC"}
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.RedisCacheDriver = void 0;
|
|
4
|
+
/**
|
|
5
|
+
* Pluggable Redis cache driver.
|
|
6
|
+
* Supports custom pre-configured client instances or standalone connections via ioredis.
|
|
7
|
+
* Gracefully handles missing 'ioredis' peer dependency without breaking build or runtime.
|
|
8
|
+
*/
|
|
9
|
+
class RedisCacheDriver {
|
|
10
|
+
name = 'redis';
|
|
11
|
+
client = null;
|
|
12
|
+
config;
|
|
13
|
+
connected = false;
|
|
14
|
+
constructor(config = {}) {
|
|
15
|
+
this.config = config;
|
|
16
|
+
if (config.client) {
|
|
17
|
+
this.client = config.client;
|
|
18
|
+
this.connected = true;
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
isConnected() {
|
|
22
|
+
return this.connected;
|
|
23
|
+
}
|
|
24
|
+
async getClient() {
|
|
25
|
+
if (this.client) {
|
|
26
|
+
return this.client;
|
|
27
|
+
}
|
|
28
|
+
try {
|
|
29
|
+
// Dynamic import of optional ioredis dependency
|
|
30
|
+
const ioredisModule = await import('ioredis');
|
|
31
|
+
const RedisClass = ioredisModule.default || ioredisModule.Redis || ioredisModule;
|
|
32
|
+
if (this.config.url) {
|
|
33
|
+
this.client = new RedisClass(this.config.url);
|
|
34
|
+
}
|
|
35
|
+
else {
|
|
36
|
+
this.client = new RedisClass({
|
|
37
|
+
host: this.config.host || '127.0.0.1',
|
|
38
|
+
port: this.config.port || 6379,
|
|
39
|
+
password: this.config.password,
|
|
40
|
+
db: this.config.db || 0,
|
|
41
|
+
lazyConnect: true,
|
|
42
|
+
});
|
|
43
|
+
await this.client.connect?.();
|
|
44
|
+
}
|
|
45
|
+
this.connected = true;
|
|
46
|
+
return this.client;
|
|
47
|
+
}
|
|
48
|
+
catch (err) {
|
|
49
|
+
throw new Error(`[RedisCacheDriver] Optional dependency "ioredis" is required to use RedisCacheDriver without providing a custom client. Install it via "pnpm add ioredis" or pass a pre-instantiated client to RedisCacheConfig. Root error: ${err?.message || err}`);
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
async get(key) {
|
|
53
|
+
const client = await this.getClient();
|
|
54
|
+
const raw = await client.get(key);
|
|
55
|
+
if (raw === null || raw === undefined) {
|
|
56
|
+
return null;
|
|
57
|
+
}
|
|
58
|
+
try {
|
|
59
|
+
return JSON.parse(raw);
|
|
60
|
+
}
|
|
61
|
+
catch {
|
|
62
|
+
return raw;
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
async set(key, value, options) {
|
|
66
|
+
const client = await this.getClient();
|
|
67
|
+
const serialized = typeof value === 'string' ? value : JSON.stringify(value);
|
|
68
|
+
if (options?.ttl && options.ttl > 0) {
|
|
69
|
+
await client.set(key, serialized, 'EX', options.ttl);
|
|
70
|
+
}
|
|
71
|
+
else {
|
|
72
|
+
await client.set(key, serialized);
|
|
73
|
+
}
|
|
74
|
+
if (options?.tags && options.tags.length > 0) {
|
|
75
|
+
for (const tag of options.tags) {
|
|
76
|
+
const tagKey = `tag:${tag}`;
|
|
77
|
+
await client.sadd(tagKey, key);
|
|
78
|
+
if (options.ttl && options.ttl > 0) {
|
|
79
|
+
// Set TTL on tag set slightly longer to avoid premature eviction
|
|
80
|
+
await client.expire(tagKey, options.ttl + 60);
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
async delete(key) {
|
|
86
|
+
const client = await this.getClient();
|
|
87
|
+
const count = await client.del(key);
|
|
88
|
+
return count > 0;
|
|
89
|
+
}
|
|
90
|
+
async deleteMany(keys) {
|
|
91
|
+
if (keys.length === 0)
|
|
92
|
+
return 0;
|
|
93
|
+
const client = await this.getClient();
|
|
94
|
+
return await client.del(...keys);
|
|
95
|
+
}
|
|
96
|
+
async has(key) {
|
|
97
|
+
const client = await this.getClient();
|
|
98
|
+
const exists = await client.exists(key);
|
|
99
|
+
return exists > 0;
|
|
100
|
+
}
|
|
101
|
+
async clear() {
|
|
102
|
+
const client = await this.getClient();
|
|
103
|
+
await client.flushdb();
|
|
104
|
+
}
|
|
105
|
+
async invalidateByTag(tag) {
|
|
106
|
+
const client = await this.getClient();
|
|
107
|
+
const tagKey = `tag:${tag}`;
|
|
108
|
+
const keys = await client.smembers(tagKey);
|
|
109
|
+
if (keys && keys.length > 0) {
|
|
110
|
+
await client.del(...keys);
|
|
111
|
+
}
|
|
112
|
+
await client.del(tagKey);
|
|
113
|
+
}
|
|
114
|
+
async disconnect() {
|
|
115
|
+
if (this.client) {
|
|
116
|
+
if (typeof this.client.quit === 'function') {
|
|
117
|
+
await this.client.quit().catch(() => { });
|
|
118
|
+
}
|
|
119
|
+
else if (typeof this.client.disconnect === 'function') {
|
|
120
|
+
await this.client.disconnect().catch(() => { });
|
|
121
|
+
}
|
|
122
|
+
this.client = null;
|
|
123
|
+
this.connected = false;
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
exports.RedisCacheDriver = RedisCacheDriver;
|
|
128
|
+
//# sourceMappingURL=redis.driver.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"redis.driver.js","sourceRoot":"","sources":["../../src/drivers/redis.driver.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,MAAa,gBAAgB;IACX,IAAI,GAAG,OAAO,CAAC;IAEvB,MAAM,GAAQ,IAAI,CAAC;IACnB,MAAM,CAAmB;IACzB,SAAS,GAAG,KAAK,CAAC;IAE1B,YAAY,SAA2B,EAAE;QACvC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,CAAC;IACH,CAAC;IAEM,WAAW;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEO,KAAK,CAAC,SAAS;QACrB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,IAAI,CAAC;YACH,gDAAgD;YAChD,MAAM,aAAa,GAAQ,MAAM,MAAM,CAAC,SAAgB,CAAC,CAAC;YAC1D,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,IAAI,aAAa,CAAC,KAAK,IAAI,aAAa,CAAC;YAEjF,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;gBACpB,IAAI,CAAC,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChD,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,MAAM,GAAG,IAAI,UAAU,CAAC;oBAC3B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,WAAW;oBACrC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI;oBAC9B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;oBAC9B,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC;oBACvB,WAAW,EAAE,IAAI;iBAClB,CAAC,CAAC;gBACH,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YAChC,CAAC;YAED,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,gOAAgO,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,CACtP,CAAC;QACJ,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,GAAG,CAAc,GAAW;QACvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAmB,CAAC;QAC7B,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,GAAG,CAAc,GAAW,EAAE,KAAQ,EAAE,OAAoB;QACvE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAE7E,IAAI,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;YACpC,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QACvD,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACpC,CAAC;QAED,IAAI,OAAO,EAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBAC/B,MAAM,MAAM,GAAG,OAAO,GAAG,EAAE,CAAC;gBAC5B,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBAC/B,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;oBACnC,iEAAiE;oBACjE,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC;gBAChD,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,GAAW;QAC7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,OAAO,KAAK,GAAG,CAAC,CAAC;IACnB,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,IAAc;QACpC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,OAAO,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACnC,CAAC;IAEM,KAAK,CAAC,GAAG,CAAC,GAAW;QAC1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACxC,OAAO,MAAM,GAAG,CAAC,CAAC;IACpB,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;IAEM,KAAK,CAAC,eAAe,CAAC,GAAW;QACtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,OAAO,GAAG,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAE3C,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QAC5B,CAAC;QACD,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAEM,KAAK,CAAC,UAAU;QACrB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC3C,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAC3C,CAAC;iBAAM,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBACxD,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACjD,CAAC;YACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACzB,CAAC;IACH,CAAC;CACF;AAnID,4CAmIC"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
export * from './types.js';
|
|
2
|
+
export * from './drivers/memory.driver.js';
|
|
3
|
+
export * from './drivers/pulse.driver.js';
|
|
4
|
+
export * from './drivers/redis.driver.js';
|
|
5
|
+
export * from './drivers/argosdb.driver.js';
|
|
6
|
+
export * from './cache-manager.js';
|
|
7
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
3
|
+
if (k2 === undefined) k2 = k;
|
|
4
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
5
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
6
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
7
|
+
}
|
|
8
|
+
Object.defineProperty(o, k2, desc);
|
|
9
|
+
}) : (function(o, m, k, k2) {
|
|
10
|
+
if (k2 === undefined) k2 = k;
|
|
11
|
+
o[k2] = m[k];
|
|
12
|
+
}));
|
|
13
|
+
var __exportStar = (this && this.__exportStar) || function(m, exports) {
|
|
14
|
+
for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
|
|
15
|
+
};
|
|
16
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
17
|
+
__exportStar(require("./types.js"), exports);
|
|
18
|
+
__exportStar(require("./drivers/memory.driver.js"), exports);
|
|
19
|
+
__exportStar(require("./drivers/pulse.driver.js"), exports);
|
|
20
|
+
__exportStar(require("./drivers/redis.driver.js"), exports);
|
|
21
|
+
__exportStar(require("./drivers/argosdb.driver.js"), exports);
|
|
22
|
+
__exportStar(require("./cache-manager.js"), exports);
|
|
23
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,6DAA2C;AAC3C,4DAA0C;AAC1C,4DAA0C;AAC1C,8DAA4C;AAC5C,qDAAmC"}
|