@c9up/echo 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 C9up
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,33 @@
+# @c9up/echo
+
+> Pluggable cache contract for the Ream framework, with memory + Redis drivers.
+
+Part of **[Ream](https://github.com/C9up/ream)** — a Rust-powered, AdonisJS-compatible Node.js framework. Independent, publishable package.
+
+## Installation
+
+```bash
+pnpm add @c9up/echo
+ream configure @c9up/echo
+```
+
+## Usage
+
+Register the provider in your app, then configure it under `config/echo.ts`:
+
+```ts
+// reamrc.ts
+providers: [
+  () => import('@c9up/echo/provider'),
+]
+```
+
+## Entry points
+
+- `@c9up/echo` — main API
+- `@c9up/echo/provider` — Ream IoC provider
+- `@c9up/echo/services/main` — container service accessor
+
+## License
+
+MIT

package/dist/CacheManager.d.ts

@@ -0,0 +1,36 @@
+/**
+ * CacheManager — unified cache API with driver abstraction.
+ */
+export interface CacheDriver {
+    get<T = unknown>(key: string): Promise<T | null>;
+    set(key: string, value: unknown, ttlSeconds?: number): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    flush(): Promise<void>;
+    has(key: string): Promise<boolean>;
+}
+export interface CacheConfig {
+    driver?: string;
+    prefix?: string;
+    ttl?: number;
+}
+export declare class CacheManager implements CacheDriver {
+    private driver;
+    private prefix;
+    private defaultTtl;
+    constructor(driver: CacheDriver, config?: CacheConfig);
+    private prefixKey;
+    get<T = unknown>(key: string): Promise<T | null>;
+    set(key: string, value: unknown, ttlSeconds?: number): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    flush(): Promise<void>;
+    has(key: string): Promise<boolean>;
+    /** Set a value with tags for grouped invalidation. */
+    setWithTags(key: string, value: unknown, tags: string[], ttlSeconds?: number): Promise<void>;
+    /** Flush only entries with matching tags. */
+    flushTags(tags: string[]): Promise<void>;
+    /** In-flight promises for stampede prevention. Each factory is typed per-call; the map is keyed by prefixed cache key. */
+    private inflight;
+    /** Get or set — fetch from cache, or compute and store. Single-flight: concurrent misses share one factory call. */
+    remember<T>(key: string, ttl: number, factory: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=CacheManager.d.ts.map

package/dist/CacheManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../src/CacheManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC3B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACjD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnC;AAoBD,MAAM,WAAW,WAAW;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,YAAa,YAAW,WAAW;IAC/C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW;IAMrD,OAAO,CAAC,SAAS;IAIX,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAIhD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAapE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxC,sDAAsD;IAChD,WAAW,CAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EAAE,EACd,UAAU,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAmBhB,6CAA6C;IACvC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9C,0HAA0H;IAC1H,OAAO,CAAC,QAAQ,CAA4C;IAE5D,oHAAoH;IAC9G,QAAQ,CAAC,CAAC,EACf,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC;CA0Bb"}

package/dist/CacheManager.js

@@ -0,0 +1,84 @@
+/**
+ * CacheManager — unified cache API with driver abstraction.
+ */
+function isTaggableDriver(driver) {
+    const candidate = driver;
+    return (typeof candidate.flushTags === "function" &&
+        typeof candidate.setWithTags === "function");
+}
+export class CacheManager {
+    driver;
+    prefix;
+    defaultTtl;
+    constructor(driver, config) {
+        this.driver = driver;
+        this.prefix = config?.prefix ?? "";
+        this.defaultTtl = config?.ttl ?? 3600;
+    }
+    prefixKey(key) {
+        return this.prefix ? `${this.prefix}:${key}` : key;
+    }
+    async get(key) {
+        return this.driver.get(this.prefixKey(key));
+    }
+    async set(key, value, ttlSeconds) {
+        if (value === null || value === undefined) {
+            throw new TypeError("Echo: caching null/undefined values is not supported");
+        }
+        return this.driver.set(this.prefixKey(key), value, ttlSeconds ?? this.defaultTtl);
+    }
+    async delete(key) {
+        return this.driver.delete(this.prefixKey(key));
+    }
+    async flush() {
+        return this.driver.flush();
+    }
+    async has(key) {
+        return this.driver.has(this.prefixKey(key));
+    }
+    /** Set a value with tags for grouped invalidation. */
+    async setWithTags(key, value, tags, ttlSeconds) {
+        if (value === null || value === undefined) {
+            throw new TypeError("Echo: caching null/undefined values is not supported");
+        }
+        if (!isTaggableDriver(this.driver)) {
+            throw new Error("Echo: the configured driver does not support tag-based invalidation");
+        }
+        return this.driver.setWithTags(this.prefixKey(key), value, tags, ttlSeconds ?? this.defaultTtl);
+    }
+    /** Flush only entries with matching tags. */
+    async flushTags(tags) {
+        if (isTaggableDriver(this.driver)) {
+            return this.driver.flushTags(tags);
+        }
+        throw new Error("Echo: the configured driver does not support tag-based invalidation");
+    }
+    /** In-flight promises for stampede prevention. Each factory is typed per-call; the map is keyed by prefixed cache key. */
+    inflight = new Map();
+    /** Get or set — fetch from cache, or compute and store. Single-flight: concurrent misses share one factory call. */
+    async remember(key, ttl, factory) {
+        const prefixed = this.prefixKey(key);
+        const existing = this.inflight.get(prefixed);
+        if (existing)
+            return existing.then((v) => v);
+        const cached = await this.get(key);
+        if (cached !== null)
+            return cached;
+        const existingAfterAwait = this.inflight.get(prefixed);
+        if (existingAfterAwait)
+            return existingAfterAwait.then((v) => v);
+        const promise = factory()
+            .then(async (value) => {
+            await this.set(key, value, ttl);
+            this.inflight.delete(prefixed);
+            return value;
+        })
+            .catch((err) => {
+            this.inflight.delete(prefixed);
+            throw err;
+        });
+        this.inflight.set(prefixed, promise);
+        return promise;
+    }
+}
+//# sourceMappingURL=CacheManager.js.map

package/dist/CacheManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.js","sourceRoot":"","sources":["../src/CacheManager.ts"],"names":[],"mappings":"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"}

package/dist/EchoProvider.d.ts

@@ -0,0 +1,52 @@
+import { type CacheConfig } from "./CacheManager.js";
+/**
+ * Duck-typed host context — echo stays publishable without importing
+ * `@c9up/ream`. Any framework that exposes a Container + a config
+ * store satisfies the contract.
+ */
+interface EchoContainer {
+    singleton(token: unknown, factory: () => unknown): void;
+    resolve<T = unknown>(token: unknown): T;
+}
+interface EchoConfigStore {
+    get<T = unknown>(key: string): T | undefined;
+}
+export interface EchoAppContext {
+    container: EchoContainer;
+    config: EchoConfigStore;
+}
+export interface EchoProviderConfig extends CacheConfig {
+    /**
+     * Driver to bind by default. Only `"memory"` is created
+     * automatically — other drivers (Redis etc.) need custom client
+     * wiring, so apps build the `CacheManager` themselves and call
+     * `setCache(...)` from `@c9up/echo/services/main`.
+     *
+     * Default `"memory"`.
+     */
+    driver?: "memory";
+}
+/**
+ * EchoProvider — registers a default in-memory `CacheManager` so apps
+ * that don't need Redis can `import cache from '@c9up/echo/services/main'`
+ * and `await cache.get(...)` straight away.
+ *
+ *   // reamrc.ts
+ *   providers: [() => import('@c9up/echo/provider')]
+ *
+ *   // config/cache.ts
+ *   export default { driver: 'memory', prefix: 'myapp', ttl: 300 }
+ *
+ *   // anywhere
+ *   import cache from '@c9up/echo/services/main'
+ *   await cache.set('k', v, 60)
+ */
+export default class EchoProvider {
+    protected app: EchoAppContext;
+    constructor(app: EchoAppContext);
+    register(): void;
+    boot(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=EchoProvider.d.ts.map

package/dist/EchoProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EchoProvider.d.ts","sourceRoot":"","sources":["../src/EchoProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAgB,MAAM,mBAAmB,CAAC;AAInE;;;;GAIG;AACH,UAAU,aAAa;IACtB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,GAAG,IAAI,CAAC;IACxD,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC;CACxC;AACD,UAAU,eAAe;IACxB,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;CAC7C;AACD,MAAM,WAAW,cAAc;IAC9B,SAAS,EAAE,aAAa,CAAC;IACzB,MAAM,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACtD;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,OAAO,OAAO,YAAY;IACpB,SAAS,CAAC,GAAG,EAAE,cAAc;gBAAnB,GAAG,EAAE,cAAc;IAEzC,QAAQ,IAAI,IAAI;IAiBV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAC/B"}

package/dist/EchoProvider.js

@@ -0,0 +1,41 @@
+import { CacheManager } from "./CacheManager.js";
+import { MemoryDriver } from "./drivers/MemoryDriver.js";
+import { setCache } from "./services/main.js";
+/**
+ * EchoProvider — registers a default in-memory `CacheManager` so apps
+ * that don't need Redis can `import cache from '@c9up/echo/services/main'`
+ * and `await cache.get(...)` straight away.
+ *
+ *   // reamrc.ts
+ *   providers: [() => import('@c9up/echo/provider')]
+ *
+ *   // config/cache.ts
+ *   export default { driver: 'memory', prefix: 'myapp', ttl: 300 }
+ *
+ *   // anywhere
+ *   import cache from '@c9up/echo/services/main'
+ *   await cache.set('k', v, 60)
+ */
+export default class EchoProvider {
+    app;
+    constructor(app) {
+        this.app = app;
+    }
+    register() {
+        this.app.container.singleton(CacheManager, () => {
+            const config = this.app.config.get("cache");
+            const driver = config?.driver ?? "memory";
+            if (driver !== "memory") {
+                throw new Error(`[echo] Unsupported driver '${driver}' for default provider — ` +
+                    "wire CacheManager yourself for non-memory drivers.");
+            }
+            return new CacheManager(new MemoryDriver(), config);
+        });
+        this.app.container.singleton("cache", () => this.app.container.resolve(CacheManager));
+    }
+    async boot() {
+        setCache(this.app.container.resolve(CacheManager));
+    }
+    async shutdown() { }
+}
+//# sourceMappingURL=EchoProvider.js.map

package/dist/EchoProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EchoProvider.js","sourceRoot":"","sources":["../src/EchoProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AA+B9C;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,OAAO,OAAO,YAAY;IACV;IAAtB,YAAsB,GAAmB;QAAnB,QAAG,GAAH,GAAG,CAAgB;IAAG,CAAC;IAE7C,QAAQ;QACP,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,YAAY,EAAE,GAAG,EAAE;YAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAqB,OAAO,CAAC,CAAC;YAChE,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,QAAQ,CAAC;YAC1C,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CACd,8BAA8B,MAAM,2BAA2B;oBAC9D,oDAAoD,CACrD,CAAC;YACH,CAAC;YACD,OAAO,IAAI,YAAY,CAAC,IAAI,YAAY,EAAE,EAAE,MAAM,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,EAAE,CAC1C,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAe,YAAY,CAAC,CACtD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACT,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAe,YAAY,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,QAAQ,KAAmB,CAAC;CAClC"}

package/dist/drivers/MemoryDriver.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Memory cache driver — in-process Map with TTL support.
+ * Suitable for development and single-process deployments.
+ */
+import type { CacheDriver } from "../CacheManager.js";
+export declare class MemoryDriver implements CacheDriver {
+    #private;
+    constructor(sweepIntervalMs?: number);
+    destroy(): void;
+    get<T = unknown>(key: string): Promise<T | null>;
+    set(key: string, value: unknown, ttlSeconds?: number): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    flush(): Promise<void>;
+    has(key: string): Promise<boolean>;
+    /** Set with tags for group invalidation. */
+    setWithTags(key: string, value: unknown, tags: string[], ttlSeconds?: number): Promise<void>;
+    /** Flush all entries tagged with any of the given tags. */
+    flushTags(tags: string[]): Promise<void>;
+}
+//# sourceMappingURL=MemoryDriver.d.ts.map

package/dist/drivers/MemoryDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryDriver.d.ts","sourceRoot":"","sources":["../../src/drivers/MemoryDriver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAQtD,qBAAa,YAAa,YAAW,WAAW;;gBAKnC,eAAe,SAAS;IAiBpC,OAAO,IAAI,IAAI;IAIT,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAUhD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKxC,4CAA4C;IACtC,WAAW,CAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EAAE,EACd,UAAU,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IA+BhB,2DAA2D;IACrD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAgC9C"}

package/dist/drivers/MemoryDriver.js

@@ -0,0 +1,127 @@
+/**
+ * Memory cache driver — in-process Map with TTL support.
+ * Suitable for development and single-process deployments.
+ */
+export class MemoryDriver {
+    #store = new Map();
+    #tagIndex = new Map();
+    #sweepInterval;
+    constructor(sweepIntervalMs = 60_000) {
+        this.#sweepInterval = setInterval(() => {
+            const now = Date.now();
+            for (const [key, entry] of this.#store) {
+                if (entry.expiresAt > 0 && entry.expiresAt < now) {
+                    this.#store.delete(key);
+                }
+            }
+        }, sweepIntervalMs);
+        if (typeof this.#sweepInterval === "object" &&
+            "unref" in this.#sweepInterval) {
+            this.#sweepInterval.unref();
+        }
+    }
+    destroy() {
+        clearInterval(this.#sweepInterval);
+    }
+    async get(key) {
+        const entry = this.#store.get(key);
+        if (!entry)
+            return null;
+        if (entry.expiresAt > 0 && entry.expiresAt < Date.now()) {
+            this.#store.delete(key);
+            return null;
+        }
+        return entry.value;
+    }
+    async set(key, value, ttlSeconds) {
+        if (value === null || value === undefined) {
+            throw new TypeError("Echo: caching null/undefined values is not supported");
+        }
+        const expiresAt = ttlSeconds != null && ttlSeconds > 0 ? Date.now() + ttlSeconds * 1000 : 0;
+        this.#store.set(key, { value, expiresAt, tags: [] });
+    }
+    async delete(key) {
+        const entry = this.#store.get(key);
+        if (entry) {
+            for (const tag of entry.tags) {
+                this.#tagIndex.get(tag)?.delete(key);
+            }
+        }
+        return this.#store.delete(key);
+    }
+    async flush() {
+        this.#store.clear();
+        this.#tagIndex.clear();
+    }
+    async has(key) {
+        const val = await this.get(key);
+        return val !== null;
+    }
+    /** Set with tags for group invalidation. */
+    async setWithTags(key, value, tags, ttlSeconds) {
+        // Audit 2026-05-22 F4: align with `set()` — both paths now treat any
+        // `ttlSeconds <= 0` (and undefined) as "no expiration". Previously
+        // `setWithTags` used a truthy check (`ttlSeconds ?`), which let a
+        // negative value through and produced `Date.now() + (-N * 1000)` —
+        // an already-past timestamp — so the entry was born already-expired.
+        // `set()` correctly returned the immortal-entry branch on the same
+        // input. The divergence made cache semantics depend on whether the
+        // caller used tags or not, which is the worst kind of "very hard to
+        // diagnose in prod" bug.
+        const expiresAt = ttlSeconds != null && ttlSeconds > 0 ? Date.now() + ttlSeconds * 1000 : 0;
+        // Audit 2026-05-22 F3 (overwrite leg): if `key` already exists with
+        // a different tag set, the old #tagIndex entries become dangling
+        // refs to the (now overwritten) key. Clean them up before re-tagging
+        // so subsequent flushTags doesn't iterate stale references.
+        const prev = this.#store.get(key);
+        if (prev !== undefined) {
+            for (const t of prev.tags)
+                this.#tagIndex.get(t)?.delete(key);
+        }
+        this.#store.set(key, { value, expiresAt, tags });
+        for (const tag of tags) {
+            let set = this.#tagIndex.get(tag);
+            if (!set) {
+                set = new Set();
+                this.#tagIndex.set(tag, set);
+            }
+            set.add(key);
+        }
+    }
+    /** Flush all entries tagged with any of the given tags. */
+    async flushTags(tags) {
+        // Audit 2026-05-22 F3: when a key is multi-tagged (e.g. `[news, fr]`)
+        // and we flush by `news`, the old code deleted the key from #store
+        // and dropped the `news` Set, but `fr`'s Set kept a dangling
+        // reference. A later flushTags(`fr`) would iterate over the
+        // stale entry, attempt `#store.delete(key)` (no-op), and the entry
+        // would silently linger in #tagIndex forever. Worse — if a new
+        // entry was later written under the same key with different tags,
+        // flushTags(`fr`) would WRONGLY purge it because of the residue.
+        // Collect keys first, then scrub each one from EVERY tag set it
+        // belonged to (including the tags we're not flushing this round).
+        const toDelete = new Set();
+        for (const tag of tags) {
+            const keys = this.#tagIndex.get(tag);
+            if (keys) {
+                for (const key of keys)
+                    toDelete.add(key);
+            }
+        }
+        for (const key of toDelete) {
+            const entry = this.#store.get(key);
+            if (entry) {
+                for (const t of entry.tags) {
+                    this.#tagIndex.get(t)?.delete(key);
+                }
+            }
+            this.#store.delete(key);
+        }
+        // Now drop the flushed tag sets themselves (any other keys still
+        // referenced by them have been processed in the toDelete loop and
+        // already removed via the inner scrub).
+        for (const tag of tags)
+            this.#tagIndex.delete(tag);
+    }
+}
+//# sourceMappingURL=MemoryDriver.js.map

package/dist/drivers/MemoryDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryDriver.js","sourceRoot":"","sources":["../../src/drivers/MemoryDriver.ts"],"names":[],"mappings":"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"}

package/dist/drivers/RedisDriver.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Redis cache driver — production-grade cache with TTL and tags.
+ *
+ * Requires a Redis client instance implementing the minimal interface below.
+ * Compatible with ioredis and redis (node-redis) clients.
+ *
+ * @implements MISS-10
+ */
+import type { CacheDriver } from "../CacheManager.js";
+/** Minimal Redis client interface — compatible with ioredis and node-redis. */
+export interface RedisClient {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, ...args: unknown[]): Promise<unknown>;
+    del(key: string | string[]): Promise<number>;
+    exists(key: string): Promise<number>;
+    keys(pattern: string): Promise<string[]>;
+    sadd(key: string, ...members: string[]): Promise<number>;
+    srem(key: string, ...members: string[]): Promise<number>;
+    smembers(key: string): Promise<string[]>;
+    expire(key: string, seconds: number): Promise<number>;
+    ttl(key: string): Promise<number>;
+    scan?(cursor: string, matchOption: "MATCH", pattern: string, countOption: "COUNT", count: number): Promise<[string, string[]]>;
+}
+export declare class RedisDriver implements CacheDriver {
+    #private;
+    constructor(client: RedisClient, prefix?: string);
+    delete(key: string): Promise<boolean>;
+    get<T = unknown>(key: string): Promise<T | null>;
+    set(key: string, value: unknown, ttlSeconds?: number): Promise<void>;
+    flush(): Promise<void>;
+    has(key: string): Promise<boolean>;
+    /**
+     * Set a value with tag memberships for group invalidation.
+     *
+     * Re-tagging an existing key (e.g. `['news']` → `['homepage']`) cleans
+     * the stale memberships via the per-key reverse-index — without this,
+     * a later `flushTags(['news'])` would silently wipe the still-current
+     * value because the abandoned `tag:news` set kept pointing at it.
+     */
+    setWithTags(key: string, value: unknown, tags: string[], ttlSeconds?: number): Promise<void>;
+    /**
+     * Flush all entries tagged with any of the given tags. Cleans up the
+     * per-key reverse-index AND cross-tag memberships so a multi-tag key
+     * (e.g. `['news', 'homepage']`) flushed via `news` is also removed from
+     * the `homepage` tag-set — otherwise the `homepage` set ends up with a
+     * dangling reference to a now-deleted value.
+     */
+    flushTags(tags: string[]): Promise<void>;
+}
+//# sourceMappingURL=RedisDriver.d.ts.map

package/dist/drivers/RedisDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisDriver.d.ts","sourceRoot":"","sources":["../../src/drivers/RedisDriver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC3B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,CACJ,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,OAAO,EACpB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,OAAO,EACpB,KAAK,EAAE,MAAM,GACX,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;CAC/B;AAED,qBAAa,WAAY,YAAW,WAAW;;gBAIlC,MAAM,EAAE,WAAW,EAAE,MAAM,SAAW;IAqB5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAerC,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAMhD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASpE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBtB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKxC;;;;;;;OAOG;IACG,WAAW,CAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EAAE,EACd,UAAU,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IA6ChB;;;;;;OAMG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA6B9C"}