@argos-js/cache 0.0.0-stage → 0.1.0

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 ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Argos-JS Team
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,117 @@
1
- # Temporary Holding Version
1
+ # @argos-js/cache
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ High-performance, modular, and runtime-agnostic caching suite for **Argos-JS**, featuring sub-millisecond In-Memory RAM reads (< 0.05ms) and instant reactive cache invalidation driven by **ArgosDB Pulse CDC** (`argosdb-pulse`).
4
+
5
+ ---
6
+
7
+ ## Key Features
8
+
9
+ - **Runtime-Agnostic & Zero Addons:** 100% pure TypeScript using standard Web APIs (`Map`, `Uint8Array`, `TextEncoder`, `TextDecoder`, `crypto`). Runs seamlessly across Node.js 18+, Bun, and Deno.
10
+ - **Pulse Near-Cache Driver (`PulseNearCacheDriver`):**
11
+ - **L1 In-Memory RAM:** Serves hot cache entries directly from process heap in microseconds without network hops.
12
+ - **Reactive CDC Invalidation:** Subscribes to ArgosDB Pulse streams (`cdc.<table_name>.*`). When an `UPDATE` or `DELETE` occurs in the database, stale keys are purged from L1 cache in the exact same event cycle, completely solving the stale cache problem.
13
+ - **Pluggable Drivers:**
14
+ - `pulse`: Near-Cache combining L1 RAM with real-time CDC invalidation (default with ArgosDB).
15
+ - `memory`: In-memory driver with configurable LRU eviction and TTL expiration.
16
+ - `redis`: Pluggable Redis adapter with prefix and tag support (optional dependency, no runtime crash if unused).
17
+ - `argosdb`: Distributed table-backed cache in ArgosDB (`app_cache`), sharing cache across cluster workers without deploying separate Redis infrastructure.
18
+ - **Batch Tag Invalidation:** Group related cache keys by tags (e.g. `['users', 'tenant_123']`) and purge them in a single call.
19
+ - **Fetch-Through (`getOrSet`):** Transparent read-through pattern with automatic population and TTL configuration.
20
+
21
+ ---
22
+
23
+ ## Installation
24
+
25
+ ```bash
26
+ pnpm add @argos-js/cache
27
+ ```
28
+
29
+ ---
30
+
31
+ ## Configuration
32
+
33
+ Configure the active driver via code or environment variables:
34
+
35
+ ```bash
36
+ # Driver selection: pulse | memory | redis | argosdb
37
+ CACHE_DRIVER=pulse
38
+ ```
39
+
40
+ ### Initializing CacheManager
41
+
42
+ ```typescript
43
+ import { createCache } from '@argos-js/cache';
44
+
45
+ export const cache = createCache({
46
+ driver: (process.env.CACHE_DRIVER as any) || 'pulse',
47
+ prefix: 'argos_api:',
48
+ defaultTtl: 300, // 5 minutes default TTL
49
+ pulse: {
50
+ listenCdc: true,
51
+ watchedTables: ['auth_users', 'products'],
52
+ },
53
+ });
54
+ ```
55
+
56
+ ---
57
+
58
+ ## Usage
59
+
60
+ ### 1. Fetch-Through (`getOrSet`)
61
+
62
+ ```typescript
63
+ const user = await cache.getOrSet(`user:${userId}`, async () => {
64
+ return await db.select().from(users).where(eq(users.id, userId)).first();
65
+ }, { ttl: 600 });
66
+ ```
67
+
68
+ ### 2. Manual Set & Get
69
+
70
+ ```typescript
71
+ // Store item with 60s TTL and tags
72
+ await cache.set('product:123', productData, {
73
+ ttl: 60,
74
+ tags: ['products', 'category_electronics'],
75
+ });
76
+
77
+ const product = await cache.get('product:123');
78
+ ```
79
+
80
+ ### 3. Invalidation by Tag
81
+
82
+ ```typescript
83
+ // Purges all products when catalog changes
84
+ await cache.invalidateByTag('products');
85
+ ```
86
+
87
+ ---
88
+
89
+ ## Near-Cache CDC Architecture
90
+
91
+ ```text
92
+ ┌────────────────────────────────────────────────────────┐
93
+ │ Application │
94
+ └──────────────────────────┬─────────────────────────────┘
95
+ │
96
+ ┌───────────────┴───────────────┐
97
+ ▼ ▼
98
+ [1] Fast Cache Read [2] Cache Miss
99
+ L1 RAM (< 0.05ms) Database Query
100
+ │ │
101
+ │ ArgosDB Mutation
102
+ │ │
103
+ │ ▼
104
+ │ ArgosDB Pulse (WAL/CDC)
105
+ │ │
106
+ │ TCP Binary Stream (Port 8788)
107
+ │ │
108
+ │ ▼
109
+ └──────── [3] Invalidate L1 ────┘
110
+ (Instant Purge on UPDATE/DELETE)
111
+ ```
112
+
113
+ ---
114
+
115
+ ## License
116
+
117
+ MIT © Argos-JS Team
@@ -0,0 +1,40 @@
1
+ import type { CacheConfig, CacheDriver, SetOptions, SupportedCacheDriver } from './types.js';
2
+ /**
3
+ * Unified Cache Manager facade.
4
+ * Implements standard CacheDriver interface, wraps pluggable drivers,
5
+ * handles global key prefixes, and provides convenient patterns like `getOrSet`.
6
+ */
7
+ export declare class CacheManager implements CacheDriver {
8
+ private config;
9
+ private drivers;
10
+ private defaultDriverName;
11
+ private prefix;
12
+ private defaultTtl?;
13
+ constructor(config?: Partial<CacheConfig>);
14
+ get name(): string;
15
+ registerDriver(name: string, driver: CacheDriver): void;
16
+ driver(name?: SupportedCacheDriver | string): CacheDriver;
17
+ get<T = unknown>(key: string): Promise<T | null>;
18
+ set<T = unknown>(key: string, value: T, options?: SetOptions): Promise<void>;
19
+ delete(key: string): Promise<boolean>;
20
+ deleteMany(keys: string[]): Promise<number>;
21
+ has(key: string): Promise<boolean>;
22
+ clear(): Promise<void>;
23
+ invalidateByTag(tag: string): Promise<void>;
24
+ disconnect(): Promise<void>;
25
+ /**
26
+ * Fetch-Through pattern: Retrieves an item from cache if present;
27
+ * otherwise invokes the factory, stores the result, and returns it.
28
+ */
29
+ getOrSet<T = unknown>(key: string, factory: () => Promise<T>, options?: SetOptions): Promise<T>;
30
+ private formatKey;
31
+ }
32
+ /**
33
+ * Creates a configured CacheManager instance.
34
+ */
35
+ export declare function createCache(config?: Partial<CacheConfig>): CacheManager;
36
+ /**
37
+ * Default global CacheManager singleton.
38
+ */
39
+ export declare const cache: CacheManager;
40
+ //# sourceMappingURL=cache-manager.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../src/cache-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAMpB;;;;GAIG;AACH,qBAAa,YAAa,YAAW,WAAW;IAC9C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAC,CAAS;gBAEhB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM;IA8B7C,IAAW,IAAI,IAAI,MAAM,CAExB;IAEM,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IAIvD,MAAM,CAAC,IAAI,CAAC,EAAE,oBAAoB,GAAG,MAAM,GAAG,WAAW;IA8CnD,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAKhD,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKrC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAgB3C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMxC;;;OAGG;IACU,QAAQ,CAAC,CAAC,GAAG,OAAO,EAC/B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,CAAC,CAAC;IAWb,OAAO,CAAC,SAAS;CAMlB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,YAAY,CAE3E;AAED;;GAEG;AACH,eAAO,MAAM,KAAK,cAAgB,CAAC"}
@@ -0,0 +1,168 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.cache = exports.CacheManager = void 0;
4
+ exports.createCache = createCache;
5
+ const memory_driver_js_1 = require("./drivers/memory.driver.js");
6
+ const pulse_driver_js_1 = require("./drivers/pulse.driver.js");
7
+ const redis_driver_js_1 = require("./drivers/redis.driver.js");
8
+ const argosdb_driver_js_1 = require("./drivers/argosdb.driver.js");
9
+ /**
10
+ * Unified Cache Manager facade.
11
+ * Implements standard CacheDriver interface, wraps pluggable drivers,
12
+ * handles global key prefixes, and provides convenient patterns like `getOrSet`.
13
+ */
14
+ class CacheManager {
15
+ config;
16
+ drivers = new Map();
17
+ defaultDriverName;
18
+ prefix;
19
+ defaultTtl;
20
+ constructor(config = {}) {
21
+ const envDriver = typeof process !== 'undefined' ? process.env?.CACHE_DRIVER : undefined;
22
+ const defaultDriver = config.driver || envDriver || 'memory';
23
+ const envPrefix = typeof process !== 'undefined'
24
+ ? process.env?.CACHE_PREFIX || process.env?.APP_NAME || process.env?.APP_KEY
25
+ : undefined;
26
+ const rawPrefix = (config.prefix ?? envPrefix ?? '').trim();
27
+ const normalizedPrefix = rawPrefix
28
+ ? (rawPrefix.endsWith(':') ? rawPrefix : `${rawPrefix.replace(/:+$/, '')}:`)
29
+ : '';
30
+ this.config = {
31
+ driver: defaultDriver,
32
+ prefix: normalizedPrefix,
33
+ defaultTtl: config.defaultTtl ?? 300,
34
+ memory: { ...config.memory },
35
+ pulse: { ...config.pulse },
36
+ redis: { ...config.redis },
37
+ argosdb: { ...config.argosdb },
38
+ drivers: { ...config.drivers },
39
+ };
40
+ this.defaultDriverName = defaultDriver;
41
+ this.prefix = this.config.prefix || '';
42
+ this.defaultTtl = this.config.defaultTtl;
43
+ }
44
+ get name() {
45
+ return this.driver().name;
46
+ }
47
+ registerDriver(name, driver) {
48
+ this.drivers.set(name, driver);
49
+ }
50
+ driver(name) {
51
+ const target = name || this.defaultDriverName;
52
+ if (this.drivers.has(target)) {
53
+ return this.drivers.get(target);
54
+ }
55
+ let created;
56
+ switch (target) {
57
+ case 'pulse':
58
+ created = new pulse_driver_js_1.PulseNearCacheDriver({
59
+ defaultTtl: this.defaultTtl,
60
+ ...this.config.pulse,
61
+ ...this.config.drivers?.pulse,
62
+ });
63
+ break;
64
+ case 'memory':
65
+ created = new memory_driver_js_1.MemoryCacheDriver({
66
+ defaultTtl: this.defaultTtl,
67
+ ...this.config.memory,
68
+ ...this.config.drivers?.memory,
69
+ });
70
+ break;
71
+ case 'redis':
72
+ created = new redis_driver_js_1.RedisCacheDriver({
73
+ ...this.config.redis,
74
+ ...this.config.drivers?.redis,
75
+ });
76
+ break;
77
+ case 'argosdb':
78
+ created = new argosdb_driver_js_1.ArgosDbTableDriver({
79
+ ...this.config.argosdb,
80
+ ...this.config.drivers?.argosdb,
81
+ });
82
+ break;
83
+ default:
84
+ throw new Error(`[CacheManager] Unsupported cache driver: "${target}".`);
85
+ }
86
+ this.drivers.set(target, created);
87
+ return created;
88
+ }
89
+ async get(key) {
90
+ const fullKey = this.formatKey(key);
91
+ return await this.driver().get(fullKey);
92
+ }
93
+ async set(key, value, options) {
94
+ const fullKey = this.formatKey(key);
95
+ const mergedOptions = {
96
+ ttl: options?.ttl ?? this.defaultTtl,
97
+ tags: options?.tags,
98
+ };
99
+ await this.driver().set(fullKey, value, mergedOptions);
100
+ }
101
+ async delete(key) {
102
+ const fullKey = this.formatKey(key);
103
+ return await this.driver().delete(fullKey);
104
+ }
105
+ async deleteMany(keys) {
106
+ const fullKeys = keys.map((k) => this.formatKey(k));
107
+ const activeDriver = this.driver();
108
+ if (typeof activeDriver.deleteMany === 'function') {
109
+ return await activeDriver.deleteMany(fullKeys);
110
+ }
111
+ let deleted = 0;
112
+ for (const k of fullKeys) {
113
+ if (await activeDriver.delete(k)) {
114
+ deleted++;
115
+ }
116
+ }
117
+ return deleted;
118
+ }
119
+ async has(key) {
120
+ const fullKey = this.formatKey(key);
121
+ return await this.driver().has(fullKey);
122
+ }
123
+ async clear() {
124
+ await this.driver().clear();
125
+ }
126
+ async invalidateByTag(tag) {
127
+ const activeDriver = this.driver();
128
+ if (typeof activeDriver.invalidateByTag === 'function') {
129
+ await activeDriver.invalidateByTag(tag);
130
+ }
131
+ }
132
+ async disconnect() {
133
+ for (const d of this.drivers.values()) {
134
+ await d.disconnect?.();
135
+ }
136
+ }
137
+ /**
138
+ * Fetch-Through pattern: Retrieves an item from cache if present;
139
+ * otherwise invokes the factory, stores the result, and returns it.
140
+ */
141
+ async getOrSet(key, factory, options) {
142
+ const cached = await this.get(key);
143
+ if (cached !== null) {
144
+ return cached;
145
+ }
146
+ const freshValue = await factory();
147
+ await this.set(key, freshValue, options);
148
+ return freshValue;
149
+ }
150
+ formatKey(key) {
151
+ if (!this.prefix) {
152
+ return key;
153
+ }
154
+ return `${this.prefix}${key}`;
155
+ }
156
+ }
157
+ exports.CacheManager = CacheManager;
158
+ /**
159
+ * Creates a configured CacheManager instance.
160
+ */
161
+ function createCache(config = {}) {
162
+ return new CacheManager(config);
163
+ }
164
+ /**
165
+ * Default global CacheManager singleton.
166
+ */
167
+ exports.cache = createCache();
168
+ //# sourceMappingURL=cache-manager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache-manager.js","sourceRoot":"","sources":["../src/cache-manager.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,25 @@
1
+ import type { ArgosDbTableCacheConfig, CacheDriver, SetOptions } from '../types.js';
2
+ /**
3
+ * Distributed cache driver backed by an ArgosDB database table.
4
+ * Enables shared caching across cluster workers without deploying an external Redis instance.
5
+ */
6
+ export declare class ArgosDbTableDriver implements CacheDriver {
7
+ readonly name = "argosdb";
8
+ private db;
9
+ private tableName;
10
+ private autoCreateTable;
11
+ private tableCreated;
12
+ constructor(config?: ArgosDbTableCacheConfig);
13
+ setDb(db: any): void;
14
+ ensureTable(): Promise<void>;
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
+ private getDb;
23
+ private runQuery;
24
+ }
25
+ //# sourceMappingURL=argosdb.driver.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"argosdb.driver.d.ts","sourceRoot":"","sources":["../../src/drivers/argosdb.driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEpF;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACpD,SAAgB,IAAI,aAAa;IAEjC,OAAO,CAAC,EAAE,CAAM;IAChB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,GAAE,uBAA4B;IAMzC,KAAK,CAAC,EAAE,EAAE,GAAG,GAAG,IAAI;IAKd,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B5B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IA2BhD,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB5E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOrC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAW3C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAO1C,KAAK;YAYL,QAAQ;CAevB"}
@@ -0,0 +1,145 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.ArgosDbTableDriver = void 0;
4
+ /**
5
+ * Distributed cache driver backed by an ArgosDB database table.
6
+ * Enables shared caching across cluster workers without deploying an external Redis instance.
7
+ */
8
+ class ArgosDbTableDriver {
9
+ name = 'argosdb';
10
+ db;
11
+ tableName;
12
+ autoCreateTable;
13
+ tableCreated = false;
14
+ constructor(config = {}) {
15
+ this.db = config.db;
16
+ this.tableName = config.tableName || 'app_cache';
17
+ this.autoCreateTable = config.autoCreateTable ?? true;
18
+ }
19
+ setDb(db) {
20
+ this.db = db;
21
+ this.tableCreated = false;
22
+ }
23
+ async ensureTable() {
24
+ if (this.tableCreated || !this.db) {
25
+ return;
26
+ }
27
+ const ddl = `
28
+ CREATE TABLE IF NOT EXISTS ${this.tableName} (
29
+ cache_key TEXT PRIMARY KEY,
30
+ cache_value TEXT NOT NULL,
31
+ expires_at BIGINT,
32
+ tags TEXT
33
+ )
34
+ `;
35
+ try {
36
+ if (typeof this.db.query === 'function') {
37
+ await this.db.query(ddl);
38
+ }
39
+ else if (typeof this.db.raw === 'function') {
40
+ await this.db.raw(ddl);
41
+ }
42
+ else if (typeof this.db.execute === 'function') {
43
+ await this.db.execute(ddl);
44
+ }
45
+ this.tableCreated = true;
46
+ }
47
+ catch (err) {
48
+ // Table might already exist or DDL handled by migrations
49
+ this.tableCreated = true;
50
+ }
51
+ }
52
+ async get(key) {
53
+ const db = await this.getDb();
54
+ const now = Date.now();
55
+ const sql = `SELECT cache_value, expires_at FROM ${this.tableName} WHERE cache_key = ?`;
56
+ const rows = await this.runQuery(db, sql, [key]);
57
+ if (!rows || rows.length === 0) {
58
+ return null;
59
+ }
60
+ const row = rows[0];
61
+ const expiresAt = row.expires_at ? Number(row.expires_at) : null;
62
+ if (expiresAt !== null && now > expiresAt) {
63
+ // Expired: prune in background
64
+ this.delete(key).catch(() => { });
65
+ return null;
66
+ }
67
+ try {
68
+ return JSON.parse(row.cache_value);
69
+ }
70
+ catch {
71
+ return row.cache_value;
72
+ }
73
+ }
74
+ async set(key, value, options) {
75
+ const db = await this.getDb();
76
+ const now = Date.now();
77
+ const expiresAt = options?.ttl && options.ttl > 0 ? now + options.ttl * 1000 : null;
78
+ const serialized = typeof value === 'string' ? value : JSON.stringify(value);
79
+ const tagsJson = options?.tags ? JSON.stringify(options.tags) : null;
80
+ // First delete any previous entry for deterministic upsert across SQL engines
81
+ await this.delete(key);
82
+ const sql = `
83
+ INSERT INTO ${this.tableName} (cache_key, cache_value, expires_at, tags)
84
+ VALUES (?, ?, ?, ?)
85
+ `;
86
+ await this.runQuery(db, sql, [key, serialized, expiresAt, tagsJson]);
87
+ }
88
+ async delete(key) {
89
+ const db = await this.getDb();
90
+ const sql = `DELETE FROM ${this.tableName} WHERE cache_key = ?`;
91
+ const result = await this.runQuery(db, sql, [key]);
92
+ return result?.affected_rows ? result.affected_rows > 0 : true;
93
+ }
94
+ async deleteMany(keys) {
95
+ if (keys.length === 0)
96
+ return 0;
97
+ let deleted = 0;
98
+ for (const key of keys) {
99
+ if (await this.delete(key)) {
100
+ deleted++;
101
+ }
102
+ }
103
+ return deleted;
104
+ }
105
+ async has(key) {
106
+ const val = await this.get(key);
107
+ return val !== null;
108
+ }
109
+ async clear() {
110
+ const db = await this.getDb();
111
+ await this.runQuery(db, `DELETE FROM ${this.tableName}`);
112
+ }
113
+ async invalidateByTag(tag) {
114
+ const db = await this.getDb();
115
+ // Searches JSON string tags containing the tag
116
+ const sql = `DELETE FROM ${this.tableName} WHERE tags LIKE ?`;
117
+ await this.runQuery(db, sql, [`%"${tag}"%`]);
118
+ }
119
+ async getDb() {
120
+ if (!this.db) {
121
+ throw new Error('[ArgosDbTableDriver] DatabaseClient instance is not configured. Pass `db` in ArgosDbTableCacheConfig.');
122
+ }
123
+ if (this.autoCreateTable && !this.tableCreated) {
124
+ await this.ensureTable();
125
+ }
126
+ return this.db;
127
+ }
128
+ async runQuery(db, sql, params = []) {
129
+ if (typeof db.query === 'function') {
130
+ const res = await db.query(sql, params);
131
+ return res?.rows ?? res;
132
+ }
133
+ if (typeof db.raw === 'function') {
134
+ const res = await db.raw(sql, params);
135
+ return res?.rows ?? res;
136
+ }
137
+ if (typeof db.execute === 'function') {
138
+ const res = await db.execute(sql, params);
139
+ return res?.rows ?? res;
140
+ }
141
+ throw new Error('[ArgosDbTableDriver] Unknown DatabaseClient query method');
142
+ }
143
+ }
144
+ exports.ArgosDbTableDriver = ArgosDbTableDriver;
145
+ //# sourceMappingURL=argosdb.driver.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"argosdb.driver.js","sourceRoot":"","sources":["../../src/drivers/argosdb.driver.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,30 @@
1
+ import type { CacheDriver, MemoryCacheConfig, SetOptions } from '../types.js';
2
+ /**
3
+ * Ultra-fast In-Memory cache driver with LRU eviction, TTL expiration, and tag indexing.
4
+ * Pure Web API based (Map, Date) with zero external dependencies.
5
+ */
6
+ export declare class MemoryCacheDriver implements CacheDriver {
7
+ readonly name = "memory";
8
+ private store;
9
+ private tagIndex;
10
+ private maxItems;
11
+ private defaultTtl?;
12
+ private accessCounter;
13
+ constructor(config?: MemoryCacheConfig);
14
+ get<T = unknown>(key: string): Promise<T | null>;
15
+ set<T = unknown>(key: string, value: T, options?: SetOptions): Promise<void>;
16
+ delete(key: string): Promise<boolean>;
17
+ deleteMany(keys: string[]): Promise<number>;
18
+ has(key: string): Promise<boolean>;
19
+ clear(): Promise<void>;
20
+ invalidateByTag(tag: string): Promise<void>;
21
+ disconnect(): Promise<void>;
22
+ /**
23
+ * Returns current count of entries in memory cache.
24
+ */
25
+ get size(): number;
26
+ private deleteInternal;
27
+ private removeKeyFromTagIndex;
28
+ private evictLru;
29
+ }
30
+ //# sourceMappingURL=memory.driver.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory.driver.d.ts","sourceRoot":"","sources":["../../src/drivers/memory.driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAS9E;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IACnD,SAAgB,IAAI,YAAY;IAEhC,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAK;gBAEd,MAAM,GAAE,iBAAsB;IAK7B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAgBhD,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAoC5E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAU3C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc3C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxC;;OAEG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,QAAQ;CAqBjB"}