@cqrs-ddd/pipeline-cache 0.5.0

package/README.md

@@ -0,0 +1,37 @@
+# @cqrs-ddd/pipeline-cache
+
+Result caching for `@cqrs-ddd/pipeline` on [cache-manager](https://github.com/jaredwray/cacheable)
+and Keyv stores (memory, Redis, Memcache, SQLite, PostgreSQL, tiered). `buildCache()`
+creates the cache from a store configuration; `createPartitionedCacheKeyFactory()`
+builds keys partitioned by tenant, principal and permission scope, because a cache hit
+skips the function and every check inside it.
+
+**Documentation:** [guide](https://aristoteliss.github.io/ddd-cqrs/packages/pipeline-cache/) · [API reference](https://aristoteliss.github.io/ddd-cqrs/api/cqrs-ddd/pipeline-cache/) · [all packages](https://aristoteliss.github.io/ddd-cqrs/)
+
+## Installation
+
+```bash
+pnpm add @cqrs-ddd/pipeline-cache @cqrs-ddd/pipeline cache-manager keyv
+```
+
+Add `@keyv/redis`, `@keyv/memcache`, `@keyv/sqlite` or `@keyv/postgres` for those stores.
+Requires Node.js 22.12 or later. Published as an ES module; a CommonJS application loads
+it with `require()`.
+
+## Example
+
+```ts
+const pipeline = createPipeline({
+  behaviors: [new CacheBehavior(buildCache({ store: { type: 'redis', url: redisUrl } }), { ttl: 30_000 })],
+});
+
+export const getPrice = pipeline.wrap(
+  { name: 'getPrice', kind: 'query' },
+  cache({ key: createPartitionedCacheKeyFactory({ principal: currentUserId, requireScope: false }) }),
+)(async (sku: string) => prices.find(sku));
+```
+
+## License
+
+Dual-licensed under **AGPLv3** and a **Commercial License**. See `LICENSE` and
+`COMMERCIAL_LICENSE.txt`.

package/dist/adapters/cache-manager.adapter.d.ts

@@ -0,0 +1,21 @@
+import type { Cache } from 'cache-manager';
+/**
+ * Common interface for cache interactions within the pipeline.
+ */
+export interface IPipelineCache {
+    get(key: string): Promise<unknown>;
+    set(key: string, value: unknown, ttl?: number): Promise<unknown>;
+}
+/**
+ * Adapter wrapping a cache-manager Cache instance to reliably expose backend
+ * store errors that cache-manager would otherwise swallow in get().
+ */
+export declare class CacheManagerAdapter {
+    private readonly cache;
+    private readonly operation;
+    constructor(cache: Cache);
+    private captureError;
+    get(key: string): Promise<unknown>;
+    set(key: string, value: unknown, ttl?: number): Promise<unknown>;
+}
+//# sourceMappingURL=cache-manager.adapter.d.ts.map

package/dist/adapters/cache-manager.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-manager.adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/cache-manager.adapter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAClE;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IASlB,OAAO,CAAC,QAAQ,CAAC,KAAK;IANlC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAIrB;IAEL,YAA6B,KAAK,EAAE,KAAK,EASxC;IAED,OAAO,CAAC,YAAY;IAcd,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOvC;IAEK,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOrE;CACF"}

package/dist/adapters/cache-manager.adapter.js

@@ -0,0 +1,52 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+import { AsyncLocalStorage } from 'node:async_hooks';
+/**
+ * Adapter wrapping a cache-manager Cache instance to reliably expose backend
+ * store errors that cache-manager would otherwise swallow in get().
+ */
+export class CacheManagerAdapter {
+    cache;
+    // cache-manager emits errors in the originating operation's async context.
+    // A key alone cannot identify concurrent reads, writes, or fallback lookups.
+    operation = new AsyncLocalStorage();
+    constructor(cache) {
+        this.cache = cache;
+        // A caller-supplied store may swallow backend errors, which then read as a
+        // miss; these listeners surface what it reports.
+        const emitter = cache;
+        emitter.on?.('get', (event) => this.captureError('get', event));
+        emitter.on?.('set', (event) => this.captureError('set', event));
+        emitter.on?.('error', (event) => this.captureError(undefined, event));
+    }
+    captureError(kind, event) {
+        const operation = this.operation.getStore();
+        if (!operation || (kind && operation.kind !== kind))
+            return;
+        if (event &&
+            typeof event === 'object' &&
+            'key' in event &&
+            event.key === operation.key &&
+            'error' in event) {
+            operation.error = event.error;
+        }
+    }
+    async get(key) {
+        return this.operation.run({ key, kind: 'get' }, async () => {
+            const value = await this.cache.get(key);
+            const error = this.operation.getStore()?.error;
+            if (value === undefined && error !== undefined)
+                throw error;
+            return value;
+        });
+    }
+    async set(key, value, ttl) {
+        return this.operation.run({ key, kind: 'set' }, async () => {
+            const result = await this.cache.set(key, value, ttl);
+            const error = this.operation.getStore()?.error;
+            if (error !== undefined)
+                throw error;
+            return result;
+        });
+    }
+}
+//# sourceMappingURL=cache-manager.adapter.js.map

package/dist/adapters/cache-manager.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-manager.adapter.js","sourceRoot":"","sources":["../../src/adapters/cache-manager.adapter.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAWrD;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IASD,KAAK;IARlC,2EAA2E;IAC3E,6EAA6E;IAC5D,SAAS,GAAG,IAAI,iBAAiB,EAI9C,CAAC;IAEL,YAA6B,KAAY;qBAAZ,KAAK;QAChC,2EAA2E;QAC3E,iDAAiD;QACjD,MAAM,OAAO,GAAG,KAEf,CAAC;QACF,OAAO,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QAChE,OAAO,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QAChE,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IACxE,CAAC;IAEO,YAAY,CAAC,IAA+B,EAAE,KAAc;QAClE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;QAC5C,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC;YAAE,OAAO;QAC5D,IACE,KAAK;YACL,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,IAAI,KAAK;YACd,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,GAAG;YAC3B,OAAO,IAAI,KAAK,EAChB,CAAC;YACD,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAChC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,IAAI,EAAE;YACzD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACxC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC;YAC/C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS;gBAAE,MAAM,KAAK,CAAC;YAC5D,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAc,EAAE,GAAY;QACjD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,IAAI,EAAE;YACzD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YACrD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC;YAC/C,IAAI,KAAK,KAAK,SAAS;gBAAE,MAAM,KAAK,CAAC;YACrC,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/cache.behavior.d.ts

@@ -0,0 +1,83 @@
+import { type IPipelineBehavior, type IPipelineBehaviorContract, type IPipelineBehaviorOptionsResolver, type IPipelineContext, type NextDelegate, PIPELINE_BEHAVIOR_CONTRACT, type PipelineItemToken, type PipelineLogger } from '@cqrs-ddd/pipeline';
+import type { Cache } from 'cache-manager';
+import { type IPipelineCache } from './adapters/cache-manager.adapter.js';
+import type { CacheBehaviorOptions } from './interfaces/cache-options.interface.js';
+/**
+ * Unique symbol key set on `context.items` recording whether the request was served from cache (`true` on hit).
+ *
+ * @example
+ * ```ts
+ * const isHit = context.items.get(CACHE_HIT_ITEM) === true;
+ * ```
+ */
+export declare const CACHE_HIT_ITEM: unique symbol;
+/**
+ * Typed token for {@link CACHE_HIT_ITEM}: the cache hit flag. Reads and writes the same
+ * `context.items` entry through `getPipelineItem` / `requirePipelineItem`.
+ */
+export declare const CACHE_HIT_ITEM_TOKEN: PipelineItemToken<boolean>;
+/**
+ * Unique symbol key set on `context.items` recording the resolved cache key string.
+ *
+ * @example
+ * ```ts
+ * const key = context.items.get(CACHE_KEY_ITEM) as string | undefined;
+ * ```
+ */
+export declare const CACHE_KEY_ITEM: unique symbol;
+/**
+ * Typed token for {@link CACHE_KEY_ITEM}: the resolved cache key. Reads and writes the same
+ * `context.items` entry through `getPipelineItem` / `requirePipelineItem`.
+ */
+export declare const CACHE_KEY_ITEM_TOKEN: PipelineItemToken<string>;
+/**
+ * Pipeline behavior that transparently caches handler results with
+ * `cache-manager` (v7) on top of Keyv.
+ *
+ * Resolution of the effective options for a handler:
+ * 1. Application-wide defaults, the second constructor argument.
+ * 2. Per-operation options from the `cache({ ... })` entry,
+ *    shallow-merged on top of the defaults (handler keys win).
+ *
+ * A `key` factory is required — see {@link createPartitionedCacheKeyFactory}. Only
+ * `query` requests are cached by default; commands and events pass through
+ * untouched. On a cache miss, `null` / `undefined` results are not written.
+ * Cache hits return the value from the single explicit lookup. This behavior
+ * intentionally does not use `cache-manager.wrap()` because its background
+ * refresh callback would re-enter every downstream pipeline behavior.
+ * Cached results are JSON values. A miss returns the JSON form of the handler
+ * result that it stores (a `Date` becomes an ISO string and a class instance a
+ * plain object), so a hit and a miss return the same shape. A result that cannot
+ * be JSON-serialized is returned unchanged and not cached.
+ *
+ * Store errors fail open by default: read failures bypass caching for that
+ * execution, and write failures return the successful handler result. Set
+ * `failOpen: false` to propagate store failures instead.
+ *
+ * @example Principal/permission-scoped query cache
+ * ```ts
+ * const userCacheKey = createPartitionedCacheKeyFactory({
+ *   principal: (ctx) => ctx.items.get('userId') as string | undefined,
+ *   scope: (ctx) => ctx.items.get('capabilityVersion') as string | undefined,
+ * });
+ *
+ * class GetUsersHandler {
+ *   @pipeline.wrap({ kind: 'query' }, [CacheBehavior, { key: userCacheKey, ttl: 30_000 }])
+ *   async handle(query: GetUsersQuery) {}
+ * }
+ * ```
+ */
+export declare class CacheBehavior implements IPipelineBehavior, IPipelineBehaviorOptionsResolver<CacheBehaviorOptions> {
+    static readonly [PIPELINE_BEHAVIOR_CONTRACT]: IPipelineBehaviorContract;
+    private readonly logger;
+    private readonly defaults;
+    private readonly cacheAdapter;
+    constructor(cache: Cache | IPipelineCache, defaults?: CacheBehaviorOptions, logger?: PipelineLogger);
+    handle(context: IPipelineContext, next: NextDelegate): Promise<unknown>;
+    /** Logs a store failure and either bypasses it or propagates it. */
+    private handleStoreError;
+    private diagnose;
+    /** Shallow-merges pipeline-level options over application defaults. */
+    resolveEffectiveOptions(options?: CacheBehaviorOptions): CacheBehaviorOptions;
+}
+//# sourceMappingURL=cache.behavior.d.ts.map

package/dist/cache.behavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.behavior.d.ts","sourceRoot":"","sources":["../src/cache.behavior.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,gCAAgC,EACrC,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,0BAA0B,EAI1B,KAAK,iBAAiB,EACtB,KAAK,cAAc,EAEpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAEpF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,eAA2B,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,iBAAiB,CAAC,OAAO,CACG,CAAC;AAEhE;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,eAA2B,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,iBAAiB,CAAC,MAAM,CACG,CAAC;AAY/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,aACX,YACE,iBAAiB,EACjB,gCAAgC,CAAC,oBAAoB,CAAC;IAExD,MAAM,CAAC,QAAQ,CAAC,CAAC,0BAA0B,CAAC,EAAE,yBAAyB,CAkDrE;IAEF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiB;IAE9C,YACE,KAAK,EAAE,KAAK,GAAG,cAAc,EAC7B,QAAQ,CAAC,EAAE,oBAAoB,EAC/B,MAAM,CAAC,EAAE,cAAc,EAcxB;IAEK,MAAM,CACV,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,OAAO,CAAC,CAyDlB;IAED,oEAAoE;IACpE,OAAO,CAAC,gBAAgB;IA0BxB,OAAO,CAAC,QAAQ;IAQhB,uEAAuE;IACvE,uBAAuB,CACrB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,oBAAoB,CAGtB;CACF"}

package/dist/cache.behavior.js

@@ -0,0 +1,213 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+import { createPipelineItem, PIPELINE_BEHAVIOR_CONTRACT, setPipelineItem, } from '@cqrs-ddd/pipeline';
+import { CacheManagerAdapter, } from './adapters/cache-manager.adapter.js';
+/**
+ * Unique symbol key set on `context.items` recording whether the request was served from cache (`true` on hit).
+ *
+ * @example
+ * ```ts
+ * const isHit = context.items.get(CACHE_HIT_ITEM) === true;
+ * ```
+ */
+export const CACHE_HIT_ITEM = Symbol('CACHE_HIT_ITEM');
+/**
+ * Typed token for {@link CACHE_HIT_ITEM}: the cache hit flag. Reads and writes the same
+ * `context.items` entry through `getPipelineItem` / `requirePipelineItem`.
+ */
+export const CACHE_HIT_ITEM_TOKEN = createPipelineItem('CACHE_HIT_ITEM', CACHE_HIT_ITEM);
+/**
+ * Unique symbol key set on `context.items` recording the resolved cache key string.
+ *
+ * @example
+ * ```ts
+ * const key = context.items.get(CACHE_KEY_ITEM) as string | undefined;
+ * ```
+ */
+export const CACHE_KEY_ITEM = Symbol('CACHE_KEY_ITEM');
+/**
+ * Typed token for {@link CACHE_KEY_ITEM}: the resolved cache key. Reads and writes the same
+ * `context.items` entry through `getPipelineItem` / `requirePipelineItem`.
+ */
+export const CACHE_KEY_ITEM_TOKEN = createPipelineItem('CACHE_KEY_ITEM', CACHE_KEY_ITEM);
+const DEFAULT_KINDS = ['query'];
+/** Whether this request kind is configured for caching. */
+function inScope(options, requestKind) {
+    return (options?.kinds ?? DEFAULT_KINDS).includes(requestKind);
+}
+/**
+ * Pipeline behavior that transparently caches handler results with
+ * `cache-manager` (v7) on top of Keyv.
+ *
+ * Resolution of the effective options for a handler:
+ * 1. Application-wide defaults, the second constructor argument.
+ * 2. Per-operation options from the `cache({ ... })` entry,
+ *    shallow-merged on top of the defaults (handler keys win).
+ *
+ * A `key` factory is required — see {@link createPartitionedCacheKeyFactory}. Only
+ * `query` requests are cached by default; commands and events pass through
+ * untouched. On a cache miss, `null` / `undefined` results are not written.
+ * Cache hits return the value from the single explicit lookup. This behavior
+ * intentionally does not use `cache-manager.wrap()` because its background
+ * refresh callback would re-enter every downstream pipeline behavior.
+ * Cached results are JSON values. A miss returns the JSON form of the handler
+ * result that it stores (a `Date` becomes an ISO string and a class instance a
+ * plain object), so a hit and a miss return the same shape. A result that cannot
+ * be JSON-serialized is returned unchanged and not cached.
+ *
+ * Store errors fail open by default: read failures bypass caching for that
+ * execution, and write failures return the successful handler result. Set
+ * `failOpen: false` to propagate store failures instead.
+ *
+ * @example Principal/permission-scoped query cache
+ * ```ts
+ * const userCacheKey = createPartitionedCacheKeyFactory({
+ *   principal: (ctx) => ctx.items.get('userId') as string | undefined,
+ *   scope: (ctx) => ctx.items.get('capabilityVersion') as string | undefined,
+ * });
+ *
+ * class GetUsersHandler {
+ *   @pipeline.wrap({ kind: 'query' }, [CacheBehavior, { key: userCacheKey, ttl: 30_000 }])
+ *   async handle(query: GetUsersQuery) {}
+ * }
+ * ```
+ */
+export class CacheBehavior {
+    static [PIPELINE_BEHAVIOR_CONTRACT] = {
+        order: (context) => {
+            const options = context.effectiveOptions;
+            if (!inScope(options, context.requestKind)) {
+                return undefined;
+            }
+            return {
+                after: ['@cqrs-ddd/pipeline-casl:CaslBehavior', 'CaslBehavior'],
+            };
+        },
+        validate: (context) => {
+            const options = context.effectiveOptions;
+            if (!inScope(options, context.requestKind)) {
+                return undefined;
+            }
+            if (!options?.key) {
+                return [
+                    {
+                        handlerName: context.handlerName,
+                        behaviorName: CacheBehavior.name,
+                        message: 'Active CacheBehavior requires an explicit `key` factory',
+                        fix: 'Provide a key factory via createPartitionedCacheKeyFactory(...) in ' +
+                            'the cache({ key }) entry or the CacheBehavior constructor defaults.',
+                    },
+                ];
+            }
+            if (typeof options.key !== 'function') {
+                return [
+                    {
+                        handlerName: context.handlerName,
+                        behaviorName: CacheBehavior.name,
+                        message: `CacheBehavior key factory must be a callable function, received ${typeof options.key}`,
+                        fix: 'Pass a valid function (ctx) => string as the key option of the cache({ key }) entry.',
+                    },
+                ];
+            }
+            return undefined;
+        },
+    };
+    logger;
+    defaults;
+    cacheAdapter;
+    constructor(cache, defaults, logger) {
+        if (!cache || typeof cache.get !== 'function') {
+            throw new TypeError('CacheBehavior requires a cache, such as buildCache({ store }) of @cqrs-ddd/pipeline-cache.');
+        }
+        this.defaults = defaults ?? {};
+        this.cacheAdapter =
+            cache instanceof CacheManagerAdapter
+                ? cache
+                : new CacheManagerAdapter(cache);
+        this.logger = logger ?? console;
+    }
+    async handle(context, next) {
+        const options = this.resolveEffectiveOptions(context.getBehaviorOptions(CacheBehavior));
+        if (!inScope(options, context.requestKind))
+            return next();
+        if (options.condition && !options.condition(context))
+            return next();
+        if (!options.key) {
+            throw new TypeError(`CacheBehavior on ${context.handlerName} requires an explicit \`key\` factory. ` +
+                'A cache hit returns without running the handler, so the key must partition ' +
+                'every dimension that can change the authorized response: tenant, principal, ' +
+                'permission scope and request payload. Use createPartitionedCacheKeyFactory(...).');
+        }
+        const key = options.key(context);
+        setPipelineItem(context, CACHE_KEY_ITEM_TOKEN, key);
+        let cached;
+        let canWrite = true;
+        try {
+            cached = await this.cacheAdapter.get(key);
+        }
+        catch (error) {
+            this.handleStoreError('read', context, key, error, options);
+            canWrite = false;
+        }
+        if (cached !== undefined && cached !== null) {
+            setPipelineItem(context, CACHE_HIT_ITEM_TOKEN, true);
+            this.diagnose('debug', `Cache hit for ${context.requestName} (${key})`);
+            return cached;
+        }
+        setPipelineItem(context, CACHE_HIT_ITEM_TOKEN, false);
+        this.diagnose('debug', `Cache miss for ${context.requestName} (${key})`);
+        const result = await next();
+        if (result === undefined || result === null)
+            return result;
+        const cacheable = toJsonForm(result);
+        if (cacheable === undefined) {
+            this.diagnose('warn', `Result of ${context.requestName} is not JSON-serializable; not cached (key: ${key})`);
+            return result;
+        }
+        if (canWrite) {
+            try {
+                await this.cacheAdapter.set(key, cacheable, options.ttl);
+            }
+            catch (error) {
+                this.handleStoreError('write', context, key, error, options);
+            }
+        }
+        return cacheable;
+    }
+    /** Logs a store failure and either bypasses it or propagates it. */
+    handleStoreError(operation, context, key, error, options) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (options.failOpen ?? true) {
+            this.diagnose('warn', `Cache ${operation} error for ${context.requestName} ` +
+                `(key: ${key}); failing open: ${message}`);
+            return;
+        }
+        this.diagnose('error', `Cache ${operation} error for ${context.requestName} ` +
+            `(key: ${key}); failing closed: ${message}`);
+        throw error;
+    }
+    diagnose(level, message) {
+        try {
+            this.logger[level]?.(message, CacheBehavior.name);
+        }
+        catch {
+            // Diagnostics must not replace the handler result or cache-store error.
+        }
+    }
+    /** Shallow-merges pipeline-level options over application defaults. */
+    resolveEffectiveOptions(options) {
+        if (!options)
+            return this.defaults;
+        return { ...this.defaults, ...options };
+    }
+}
+/** JSON round-trip of a cacheable result, or `undefined` when it has no JSON form. */
+function toJsonForm(value) {
+    try {
+        const json = JSON.stringify(value);
+        return json === undefined ? undefined : JSON.parse(json);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=cache.behavior.js.map

package/dist/cache.behavior.js.map

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

package/dist/errors/missing-partition.error.d.ts

@@ -0,0 +1,18 @@
+import { MissingPartitionError } from '@cqrs-ddd/pipeline';
+/** Which dimension of the cache key could not be resolved. */
+export type CachePartitionDimension = 'tenant' | 'principal' | 'scope';
+/**
+ * Raised before the cache is consulted when a dimension required by the
+ * configured key factory cannot be resolved.
+ *
+ * A cache hit returns without executing the handler,
+ * so it also skips whatever entity-level authorization and field filtering that
+ * handler performs. A key missing its tenant or principal segment therefore does
+ * not merely lose isolation — it can replay one caller's authorized response to
+ * another.
+ */
+export declare class MissingCachePartitionError extends MissingPartitionError<CachePartitionDimension> {
+    readonly name = "MissingCachePartitionError";
+    constructor(requestName: string, dimension: CachePartitionDimension, remedy: string);
+}
+//# sourceMappingURL=missing-partition.error.d.ts.map

package/dist/errors/missing-partition.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-partition.error.d.ts","sourceRoot":"","sources":["../../src/errors/missing-partition.error.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,8DAA8D;AAC9D,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;AAEvE;;;;;;;;;GASG;AACH,qBAAa,0BAA2B,SAAQ,qBAAqB,CAAC,uBAAuB,CAAC;IAC5F,SAAkB,IAAI,gCAAgC;IAEtD,YACE,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,uBAAuB,EAClC,MAAM,EAAE,MAAM,EAGf;CACF"}

package/dist/errors/missing-partition.error.js

@@ -0,0 +1,19 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+import { MissingPartitionError } from '@cqrs-ddd/pipeline';
+/**
+ * Raised before the cache is consulted when a dimension required by the
+ * configured key factory cannot be resolved.
+ *
+ * A cache hit returns without executing the handler,
+ * so it also skips whatever entity-level authorization and field filtering that
+ * handler performs. A key missing its tenant or principal segment therefore does
+ * not merely lose isolation — it can replay one caller's authorized response to
+ * another.
+ */
+export class MissingCachePartitionError extends MissingPartitionError {
+    name = 'MissingCachePartitionError';
+    constructor(requestName, dimension, remedy) {
+        super('Cache', requestName, dimension, remedy);
+    }
+}
+//# sourceMappingURL=missing-partition.error.js.map

package/dist/errors/missing-partition.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-partition.error.js","sourceRoot":"","sources":["../../src/errors/missing-partition.error.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAK3D;;;;;;;;;GASG;AACH,MAAM,OAAO,0BAA2B,SAAQ,qBAA8C;IAC1E,IAAI,GAAG,4BAA4B,CAAC;IAEtD,YACE,WAAmB,EACnB,SAAkC,EAClC,MAAc;QAEd,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/helpers/build-attributes.d.ts

@@ -0,0 +1,37 @@
+import { type IPipelineContext } from '@cqrs-ddd/pipeline';
+/**
+ * The cache decision of one execution as flat attributes:
+ * `{ 'cache.hit': boolean }` once `CacheBehavior` looked the response up, and
+ * `{}` when it did not run, so a request without caching never reports a
+ * fabricated miss. The cache key is never included: it carries the tenant and
+ * the principal, and is unbounded as a value.
+ *
+ * The result is plain data and needs no telemetry package: put it on a span, a
+ * log line, an audit record or a metric label (bounded values only).
+ *
+ * @param context - The pipeline execution, read after `CacheBehavior` ran.
+ * @returns The attributes; empty when the behavior did not run.
+ *
+ * @example Span attributes
+ * With `AttributesBehavior` of `@cqrs-ddd/pipeline-opentelemetry`:
+ * ```ts
+ * createPipeline({
+ *   globalBehaviors: {
+ *     before: [TraceBehavior, [AttributesBehavior, { factories: [buildCacheAttributes] }]],
+ *   },
+ * });
+ * ```
+ *
+ * @example A log line from a custom behavior, after the chain ran
+ * ```ts
+ * async handle(context: IPipelineContext, next: NextDelegate) {
+ *   try {
+ *     return await next();
+ *   } finally {
+ *     this.logger.log({ request: context.requestName, ...buildCacheAttributes(context) });
+ *   }
+ * }
+ * ```
+ */
+export declare function buildCacheAttributes(context: IPipelineContext): Record<string, boolean>;
+//# sourceMappingURL=build-attributes.d.ts.map

package/dist/helpers/build-attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-attributes.d.ts","sourceRoot":"","sources":["../../src/helpers/build-attributes.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAG5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIzB"}

package/dist/helpers/build-attributes.js

@@ -0,0 +1,43 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+import { getPipelineItem, hasPipelineItem, } from '@cqrs-ddd/pipeline';
+import { CACHE_HIT_ITEM_TOKEN } from '../cache.behavior.js';
+/**
+ * The cache decision of one execution as flat attributes:
+ * `{ 'cache.hit': boolean }` once `CacheBehavior` looked the response up, and
+ * `{}` when it did not run, so a request without caching never reports a
+ * fabricated miss. The cache key is never included: it carries the tenant and
+ * the principal, and is unbounded as a value.
+ *
+ * The result is plain data and needs no telemetry package: put it on a span, a
+ * log line, an audit record or a metric label (bounded values only).
+ *
+ * @param context - The pipeline execution, read after `CacheBehavior` ran.
+ * @returns The attributes; empty when the behavior did not run.
+ *
+ * @example Span attributes
+ * With `AttributesBehavior` of `@cqrs-ddd/pipeline-opentelemetry`:
+ * ```ts
+ * createPipeline({
+ *   globalBehaviors: {
+ *     before: [TraceBehavior, [AttributesBehavior, { factories: [buildCacheAttributes] }]],
+ *   },
+ * });
+ * ```
+ *
+ * @example A log line from a custom behavior, after the chain ran
+ * ```ts
+ * async handle(context: IPipelineContext, next: NextDelegate) {
+ *   try {
+ *     return await next();
+ *   } finally {
+ *     this.logger.log({ request: context.requestName, ...buildCacheAttributes(context) });
+ *   }
+ * }
+ * ```
+ */
+export function buildCacheAttributes(context) {
+    return hasPipelineItem(context, CACHE_HIT_ITEM_TOKEN)
+        ? { 'cache.hit': getPipelineItem(context, CACHE_HIT_ITEM_TOKEN) === true }
+        : {};
+}
+//# sourceMappingURL=build-attributes.js.map

package/dist/helpers/build-attributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-attributes.js","sourceRoot":"","sources":["../../src/helpers/build-attributes.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,EACL,eAAe,EACf,eAAe,GAEhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAyB;IAEzB,OAAO,eAAe,CAAC,OAAO,EAAE,oBAAoB,CAAC;QACnD,CAAC,CAAC,EAAE,WAAW,EAAE,eAAe,CAAC,OAAO,EAAE,oBAAoB,CAAC,KAAK,IAAI,EAAE;QAC1E,CAAC,CAAC,EAAE,CAAC;AACT,CAAC"}

package/dist/helpers/cache-factory.d.ts

@@ -0,0 +1,36 @@
+import { type Cache } from 'cache-manager';
+import { Keyv } from 'keyv';
+import type { BuildCacheOptions, CacheStoreConfig } from '../interfaces/cache-options.interface.js';
+/**
+ * Build a single package-owned `Keyv` instance from a declarative store
+ * configuration. Package-owned stores enable `throwOnErrors` so
+ * {@link CacheBehavior} can apply its own `failOpen` / fail-closed policy rather
+ * than having Keyv silently consume backend failures first.
+ */
+export declare function buildKeyv(config: CacheStoreConfig): Keyv;
+/**
+ * Resolve the {@link BuildCacheOptions} into a ready-to-use `cache-manager`
+ * {@link Cache}. A pre-built `cache` wins, followed by pre-built `stores`,
+ * followed by declarative `store` configuration, falling back to an in-memory
+ * store when nothing is provided.
+ *
+ * Package-created stores use `throwOnErrors: true` so cache failures reach
+ * `CacheBehavior` and its configured failure policy. Caller-owned `cache` and
+ * `stores` are **not mutated**: if an application intentionally shares a Keyv
+ * instance with another subsystem, this package must not change that object's
+ * error semantics globally.
+ *
+ * @example Fully package-owned Redis cache
+ * ```ts
+ * const cache = buildCache({ store: { type: 'redis', url: redisUrl } });
+ * ```
+ *
+ * @example Caller-owned shared store — configuration remains caller-controlled
+ * ```ts
+ * const shared = new Keyv({ store: sharedRedis, throwOnErrors: false });
+ * const cache = buildCache({ stores: [shared] });
+ * // buildCache() will not mutate shared.throwOnErrors.
+ * ```
+ */
+export declare function buildCache(options: BuildCacheOptions): Cache;
+//# sourceMappingURL=cache-factory.d.ts.map

package/dist/helpers/cache-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-factory.d.ts","sourceRoot":"","sources":["../../src/helpers/cache-factory.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,KAAK,EAAe,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,IAAI,EAAyB,MAAM,MAAM,CAAC;AACnD,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAEjB,MAAM,0CAA0C,CAAC;AAqGlD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAexD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,KAAK,CAsB5D"}