@nestjs-pipeline/cache 0.2.0

package/dist/cache.behavior.d.ts

@@ -0,0 +1,84 @@
+import { type LoggerService } from '@nestjs/common';
+import { type IPipelineBehavior, type IPipelineBehaviorContract, type IPipelineBehaviorOptionsResolver, type IPipelineContext, type NextDelegate, PIPELINE_BEHAVIOR_CONTRACT, type PipelineItemToken } from '@nestjs-pipeline/core';
+import type { Cache } from 'cache-manager';
+import { type IPipelineCache } from './adapters/cache-manager.adapter';
+import type { CacheBehaviorOptions } from './interfaces/cache-options.interface';
+/**
+ * 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 bound to {@link CACHE_DEFAULT_OPTIONS}
+ *    (via {@link CacheModule.forRoot}).
+ * 2. Per-handler options from `@UsePipeline([CacheBehavior, { ... }])`,
+ *    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,
+ * });
+ *
+ * @QueryHandler(GetUsersQuery)
+ * @UsePipeline([CacheBehavior, { key: userCacheKey, ttl: 30_000 }])
+ * export class GetUsersHandler {}
+ * ```
+ */
+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?: LoggerService);
+    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,EAIL,KAAK,aAAa,EAEnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,gCAAgC,EACrC,KAAK,gBAAgB,EAErB,KAAK,YAAY,EACjB,0BAA0B,EAI1B,KAAK,iBAAiB,EAEvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAEjF;;;;;;;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,qBACa,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,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiB;gBAI5C,KAAK,EAAE,KAAK,GAAG,cAAc,EAG7B,QAAQ,CAAC,EAAE,oBAAoB,EAG/B,MAAM,CAAC,EAAE,aAAa;IAWlB,MAAM,CACV,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,OAAO,CAAC;IA2DnB,oEAAoE;IACpE,OAAO,CAAC,gBAAgB;IA0BxB,OAAO,CAAC,QAAQ;IAQhB,uEAAuE;IACvE,uBAAuB,CACrB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,oBAAoB;CAIxB"}

package/dist/cache.behavior.js

@@ -0,0 +1,239 @@
+"use strict";
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var CacheBehavior_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheBehavior = exports.CACHE_KEY_ITEM_TOKEN = exports.CACHE_KEY_ITEM = exports.CACHE_HIT_ITEM_TOKEN = exports.CACHE_HIT_ITEM = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs-pipeline/core");
+const cache_manager_adapter_1 = require("./adapters/cache-manager.adapter");
+const tokens_1 = require("./constants/tokens");
+/**
+ * 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;
+ * ```
+ */
+exports.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`.
+ */
+exports.CACHE_HIT_ITEM_TOKEN = (0, core_1.createPipelineItem)('CACHE_HIT_ITEM', exports.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;
+ * ```
+ */
+exports.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`.
+ */
+exports.CACHE_KEY_ITEM_TOKEN = (0, core_1.createPipelineItem)('CACHE_KEY_ITEM', exports.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 bound to {@link CACHE_DEFAULT_OPTIONS}
+ *    (via {@link CacheModule.forRoot}).
+ * 2. Per-handler options from `@UsePipeline([CacheBehavior, { ... }])`,
+ *    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,
+ * });
+ *
+ * @QueryHandler(GetUsersQuery)
+ * @UsePipeline([CacheBehavior, { key: userCacheKey, ttl: 30_000 }])
+ * export class GetUsersHandler {}
+ * ```
+ */
+let CacheBehavior = class CacheBehavior {
+    static { CacheBehavior_1 = this; }
+    static [core_1.PIPELINE_BEHAVIOR_CONTRACT] = {
+        order: (context) => {
+            const options = context.effectiveOptions;
+            if (!inScope(options, context.requestKind)) {
+                return undefined;
+            }
+            return {
+                after: ['@nestjs-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_1.name,
+                        message: 'Active CacheBehavior requires an explicit `key` factory',
+                        fix: 'Provide a key factory via createPartitionedCacheKeyFactory(...) in ' +
+                            '@UsePipeline([CacheBehavior, { key: ... }]) or CacheModule.forRoot({ defaults: ... }).',
+                    },
+                ];
+            }
+            if (typeof options.key !== 'function') {
+                return [
+                    {
+                        handlerName: context.handlerName,
+                        behaviorName: CacheBehavior_1.name,
+                        message: `CacheBehavior key factory must be a callable function, received ${typeof options.key}`,
+                        fix: 'Pass a valid function (ctx) => string to the key option in @UsePipeline([CacheBehavior, { key: ... }]).',
+                    },
+                ];
+            }
+            return undefined;
+        },
+    };
+    logger;
+    defaults;
+    cacheAdapter;
+    constructor(cache, defaults, logger) {
+        this.defaults = defaults ?? {};
+        this.cacheAdapter =
+            cache instanceof cache_manager_adapter_1.CacheManagerAdapter
+                ? cache
+                : new cache_manager_adapter_1.CacheManagerAdapter(cache);
+        this.logger = logger ?? new common_1.Logger(CacheBehavior_1.name, { timestamp: true });
+    }
+    async handle(context, next) {
+        const options = this.resolveEffectiveOptions(context.getBehaviorOptions(CacheBehavior_1));
+        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);
+        (0, core_1.setPipelineItem)(context, exports.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) {
+            (0, core_1.setPipelineItem)(context, exports.CACHE_HIT_ITEM_TOKEN, true);
+            this.diagnose('debug', `Cache hit for ${context.requestName} (${key})`);
+            return cached;
+        }
+        (0, core_1.setPipelineItem)(context, exports.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_1.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 };
+    }
+};
+exports.CacheBehavior = CacheBehavior;
+exports.CacheBehavior = CacheBehavior = CacheBehavior_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(tokens_1.PIPELINE_CACHE)),
+    __param(1, (0, common_1.Optional)()),
+    __param(1, (0, common_1.Inject)(tokens_1.CACHE_DEFAULT_OPTIONS)),
+    __param(2, (0, common_1.Optional)()),
+    __param(2, (0, common_1.Inject)(core_1.LOGGING_BEHAVIOR_LOGGER)),
+    __metadata("design:paramtypes", [Object, Object, Object])
+], CacheBehavior);
+/** 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/cache.module.d.ts

@@ -0,0 +1,85 @@
+import { type DynamicModule } from '@nestjs/common';
+import type { CacheModuleAsyncOptions, CacheModuleOptions } from './interfaces/cache-options.interface';
+/**
+ * NestJS module that builds the shared `cache-manager` instance, registers the
+ * {@link CacheBehavior}, and (optionally) application-wide default
+ * {@link CacheBehaviorOptions}.
+ *
+ * The store backend is selected declaratively (memory, redis, memcache,
+ * sqlite, postgres) or supplied directly as a pre-built cache / Keyv stores.
+ * The cache is built when the application instantiates its providers, once per
+ * application. A cache built from `store` (or the default memory store) is
+ * disconnected on application shutdown; a supplied `cache` or `stores` belongs
+ * to the caller, who closes it.
+ *
+ * @example In-memory cache (default), per-handler configuration
+ * ```ts
+ * import {
+ *   CacheBehavior,
+ *   CacheModule,
+ *   createPartitionedCacheKeyFactory,
+ * } from '@nestjs-pipeline/cache';
+ *
+ * @Module({
+ *   imports: [
+ *     CacheModule.forRoot({ ttl: 30_000 }),
+ *     PipelineModule.forRoot({ behaviors: [CacheBehavior] }),
+ *   ],
+ * })
+ * export class AppModule {}
+ *
+ * const userQueryKey = createPartitionedCacheKeyFactory({
+ *   principal: (ctx) => ctx.items.get('userId') as string | undefined,
+ *   scope: (ctx) => ctx.items.get('capabilityVersion') as string | undefined,
+ * });
+ *
+ * @QueryHandler(GetUserQuery)
+ * @UsePipeline([CacheBehavior, { key: userQueryKey, ttl: 60_000 }])
+ * export class GetUserHandler implements IQueryHandler<GetUserQuery> {}
+ * ```
+ *
+ * @example Redis store
+ * ```ts
+ * CacheModule.forRoot({
+ *   store: { type: 'redis', url: 'redis://localhost:6379' },
+ *   ttl: 60_000,
+ * })
+ * ```
+ *
+ * @example Tiered memory + postgres store
+ * ```ts
+ * CacheModule.forRoot({
+ *   store: [
+ *     { type: 'memory', ttl: 5_000 },
+ *     { type: 'postgres', url: 'postgresql://user:pass@localhost:5432/db' },
+ *   ],
+ * })
+ * ```
+ */
+export declare class CacheModule {
+    /**
+     * Registers the cache behavior, the cache instance, and optional
+     * application-wide defaults.
+     *
+     * @param options - Store configuration and default behavior options.
+     * @returns The configured global {@link DynamicModule}.
+     */
+    static forRoot(options?: CacheModuleOptions): DynamicModule;
+    /**
+     * Registers the cache behavior with options resolved from injected
+     * dependencies (for example configuration read at startup).
+     *
+     * @example
+     * ```ts
+     * CacheModule.forRootAsync({
+     *   inject: [ConfigService],
+     *   useFactory: (config: ConfigService) => ({
+     *     store: { type: 'redis', url: config.getOrThrow('REDIS_URL') },
+     *     ttl: 30_000,
+     *   }),
+     * });
+     * ```
+     */
+    static forRootAsync(options: CacheModuleAsyncOptions): DynamicModule;
+}
+//# sourceMappingURL=cache.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.module.d.ts","sourceRoot":"","sources":["../src/cache.module.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,aAAa,EAOnB,MAAM,gBAAgB,CAAC;AASxB,OAAO,KAAK,EAEV,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,sCAAsC,CAAC;AAyD9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,qBACa,WAAW;IACtB;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,kBAAuB,GAAG,aAAa;IAY/D;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,uBAAuB,GAAG,aAAa;CAarE"}

package/dist/cache.module.js

@@ -0,0 +1,189 @@
+"use strict";
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var CacheModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheModule = void 0;
+const common_1 = require("@nestjs/common");
+const cache_behavior_1 = require("./cache.behavior");
+const tokens_1 = require("./constants/tokens");
+const cache_factory_1 = require("./helpers/cache-factory");
+const logger = new common_1.Logger('CacheModule');
+function storeLabel(options) {
+    if (options.cache)
+        return 'custom-cache';
+    if (options.stores && options.stores.length > 0)
+        return 'custom-stores';
+    if (!options.store)
+        return 'memory';
+    return Array.isArray(options.store)
+        ? options.store.map((s) => s.type).join(', ')
+        : options.store.type;
+}
+/** The module owns, and closes, only a cache it built from declarative options. */
+function ownsCache(options) {
+    return !options.cache && !(options.stores && options.stores.length > 0);
+}
+let CacheConnectionLifecycle = class CacheConnectionLifecycle {
+    cache;
+    options;
+    constructor(cache, options) {
+        this.cache = cache;
+        this.options = options;
+    }
+    async onApplicationShutdown() {
+        if (ownsCache(this.options))
+            await this.cache.disconnect();
+    }
+};
+CacheConnectionLifecycle = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(tokens_1.PIPELINE_CACHE)),
+    __param(1, (0, common_1.Inject)(tokens_1.CACHE_MODULE_OPTIONS)),
+    __metadata("design:paramtypes", [Object, Object])
+], CacheConnectionLifecycle);
+function cacheProviders(optionsProvider) {
+    return [
+        optionsProvider,
+        cache_behavior_1.CacheBehavior,
+        {
+            provide: tokens_1.PIPELINE_CACHE,
+            useFactory: (options) => {
+                const cache = (0, cache_factory_1.buildCache)(options);
+                logger.log(`Initialized cache with [${storeLabel(options)}] store`);
+                return cache;
+            },
+            inject: [tokens_1.CACHE_MODULE_OPTIONS],
+        },
+        {
+            provide: tokens_1.CACHE_DEFAULT_OPTIONS,
+            useFactory: (options) => ({
+                ...(options.ttl !== undefined ? { ttl: options.ttl } : {}),
+                ...options.defaults,
+            }),
+            inject: [tokens_1.CACHE_MODULE_OPTIONS],
+        },
+        CacheConnectionLifecycle,
+    ];
+}
+const CACHE_EXPORTS = [cache_behavior_1.CacheBehavior, tokens_1.PIPELINE_CACHE, tokens_1.CACHE_DEFAULT_OPTIONS];
+/**
+ * NestJS module that builds the shared `cache-manager` instance, registers the
+ * {@link CacheBehavior}, and (optionally) application-wide default
+ * {@link CacheBehaviorOptions}.
+ *
+ * The store backend is selected declaratively (memory, redis, memcache,
+ * sqlite, postgres) or supplied directly as a pre-built cache / Keyv stores.
+ * The cache is built when the application instantiates its providers, once per
+ * application. A cache built from `store` (or the default memory store) is
+ * disconnected on application shutdown; a supplied `cache` or `stores` belongs
+ * to the caller, who closes it.
+ *
+ * @example In-memory cache (default), per-handler configuration
+ * ```ts
+ * import {
+ *   CacheBehavior,
+ *   CacheModule,
+ *   createPartitionedCacheKeyFactory,
+ * } from '@nestjs-pipeline/cache';
+ *
+ * @Module({
+ *   imports: [
+ *     CacheModule.forRoot({ ttl: 30_000 }),
+ *     PipelineModule.forRoot({ behaviors: [CacheBehavior] }),
+ *   ],
+ * })
+ * export class AppModule {}
+ *
+ * const userQueryKey = createPartitionedCacheKeyFactory({
+ *   principal: (ctx) => ctx.items.get('userId') as string | undefined,
+ *   scope: (ctx) => ctx.items.get('capabilityVersion') as string | undefined,
+ * });
+ *
+ * @QueryHandler(GetUserQuery)
+ * @UsePipeline([CacheBehavior, { key: userQueryKey, ttl: 60_000 }])
+ * export class GetUserHandler implements IQueryHandler<GetUserQuery> {}
+ * ```
+ *
+ * @example Redis store
+ * ```ts
+ * CacheModule.forRoot({
+ *   store: { type: 'redis', url: 'redis://localhost:6379' },
+ *   ttl: 60_000,
+ * })
+ * ```
+ *
+ * @example Tiered memory + postgres store
+ * ```ts
+ * CacheModule.forRoot({
+ *   store: [
+ *     { type: 'memory', ttl: 5_000 },
+ *     { type: 'postgres', url: 'postgresql://user:pass@localhost:5432/db' },
+ *   ],
+ * })
+ * ```
+ */
+let CacheModule = CacheModule_1 = class CacheModule {
+    /**
+     * Registers the cache behavior, the cache instance, and optional
+     * application-wide defaults.
+     *
+     * @param options - Store configuration and default behavior options.
+     * @returns The configured global {@link DynamicModule}.
+     */
+    static forRoot(options = {}) {
+        return {
+            module: CacheModule_1,
+            global: true,
+            providers: cacheProviders({
+                provide: tokens_1.CACHE_MODULE_OPTIONS,
+                useValue: options,
+            }),
+            exports: CACHE_EXPORTS,
+        };
+    }
+    /**
+     * Registers the cache behavior with options resolved from injected
+     * dependencies (for example configuration read at startup).
+     *
+     * @example
+     * ```ts
+     * CacheModule.forRootAsync({
+     *   inject: [ConfigService],
+     *   useFactory: (config: ConfigService) => ({
+     *     store: { type: 'redis', url: config.getOrThrow('REDIS_URL') },
+     *     ttl: 30_000,
+     *   }),
+     * });
+     * ```
+     */
+    static forRootAsync(options) {
+        return {
+            module: CacheModule_1,
+            global: true,
+            imports: options.imports ?? [],
+            providers: cacheProviders({
+                provide: tokens_1.CACHE_MODULE_OPTIONS,
+                useFactory: options.useFactory,
+                inject: options.inject ?? [],
+            }),
+            exports: CACHE_EXPORTS,
+        };
+    }
+};
+exports.CacheModule = CacheModule;
+exports.CacheModule = CacheModule = CacheModule_1 = __decorate([
+    (0, common_1.Module)({})
+], CacheModule);
+//# sourceMappingURL=cache.module.js.map

package/dist/cache.module.js.map

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

package/dist/constants/tokens.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Injection token holding the shared `cache-manager` {@link import('cache-manager').Cache}
+ * instance built by {@link CacheModule.forRoot} or {@link CacheModule.forRootAsync}.
+ */
+export declare const PIPELINE_CACHE: unique symbol;
+/**
+ * Injection token holding the module-wide default {@link CacheBehaviorOptions}
+ * merged into every handler's per-pipeline configuration.
+ */
+export declare const CACHE_DEFAULT_OPTIONS: unique symbol;
+/** Injection token holding the resolved {@link CacheModuleOptions}. @internal */
+export declare const CACHE_MODULE_OPTIONS: unique symbol;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/constants/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/constants/tokens.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,cAAc,eAA2B,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,eAAkC,CAAC;AAErE,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,eAAiC,CAAC"}

package/dist/constants/tokens.js

@@ -0,0 +1,17 @@
+"use strict";
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CACHE_MODULE_OPTIONS = exports.CACHE_DEFAULT_OPTIONS = exports.PIPELINE_CACHE = void 0;
+/**
+ * Injection token holding the shared `cache-manager` {@link import('cache-manager').Cache}
+ * instance built by {@link CacheModule.forRoot} or {@link CacheModule.forRootAsync}.
+ */
+exports.PIPELINE_CACHE = Symbol('PIPELINE_CACHE');
+/**
+ * Injection token holding the module-wide default {@link CacheBehaviorOptions}
+ * merged into every handler's per-pipeline configuration.
+ */
+exports.CACHE_DEFAULT_OPTIONS = Symbol('CACHE_DEFAULT_OPTIONS');
+/** Injection token holding the resolved {@link CacheModuleOptions}. @internal */
+exports.CACHE_MODULE_OPTIONS = Symbol('CACHE_MODULE_OPTIONS');
+//# sourceMappingURL=tokens.js.map

package/dist/constants/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/constants/tokens.ts"],"names":[],"mappings":";AAAA,sEAAsE;;;AAEtE;;;GAGG;AACU,QAAA,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAEvD;;;GAGG;AACU,QAAA,qBAAqB,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;AAErE,iFAAiF;AACpE,QAAA,oBAAoB,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC"}