zibri 2.3.0 → 2.4.1

package/dist/cjs/caching/cache/cache-options.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-options.model.js","sourceRoot":"","sources":["../../../../src/caching/cache/cache-options.model.ts"],"names":[],"mappings":""}

package/dist/cjs/caching/cache/cache.interface.d.ts

@@ -0,0 +1,77 @@
+import { type CacheTagMatcher } from '../cache-tag-matchers';
+import { CacheKeyProvider, CacheSetDirectOptions, CacheWrapDeleteOptions, CacheWrapInvalidateOptions, CacheWrapOptions, CacheWrapWriteOptionsArgsOnly, CacheWrapWriteOptionsWithResult, OnInvalidationFailure, ResultCacheKeyProvider } from './cache-options.model';
+import { MultiTierCache } from './multi-tier.cache';
+import { type CacheStoreInterface } from '../store/cache-store.interface';
+/**
+ * Definition for a cache.
+ */
+export interface CacheInterface<K, V, CacheTag extends string, WriteResultAvailable extends boolean, N extends string> {
+    /**
+     * Phantom carrier, only for type inference.
+     */
+    readonly _writeResultAvailable: WriteResultAvailable;
+    /**
+     * The name of the cache. Should be unique.
+     */
+    readonly name: N;
+    /**
+     * The tags that any values inside of this cache might have.
+     *
+     * This is used for performance improvements, to skip caches for invalidateTags if the given tag will never be inside any of the cached values.
+     * Can be set to 'all' to check every time.
+     */
+    readonly tags: 'all' | readonly CacheTagMatcher[];
+    /**
+     * The default time to live for a cached value.
+     */
+    readonly defaultTtl?: number | (() => number | Promise<number>);
+    /**
+     * Whether to throw when invalidation fails or to just log and ignore.
+     */
+    readonly onInvalidationFailure?: OnInvalidationFailure;
+    /**
+     * The store used by this cache.
+     */
+    readonly store: CacheStoreInterface<K, V>;
+    /**
+     * Returns a cached value if present; otherwise calls fn.
+     * The exact caching behavior (whether the result is stored) depends on the concrete strategy.
+     */
+    wrap: <TArgs extends unknown[]>(fn: (...args: TArgs) => V | Promise<V>, keyFn: CacheKeyProvider<K, TArgs>, options?: CacheWrapOptions<V, TArgs, CacheTag>) => (...args: TArgs) => Promise<V>;
+    /**
+     * Returns a wrapped version of fn that writes its result into the cache.
+     * Key is derived from the *result*, not the args — handles the
+     * create-with-generated-id case cleanly.
+     */
+    wrapWrite: <TArgs extends unknown[]>(fn: (...args: TArgs) => V | Promise<V>, keyFn: WriteResultAvailable extends true ? ResultCacheKeyProvider<K, V, TArgs> : CacheKeyProvider<K, TArgs>, options?: WriteResultAvailable extends true ? CacheWrapWriteOptionsWithResult<V, TArgs, CacheTag> : CacheWrapWriteOptionsArgsOnly<TArgs, CacheTag>) => (...args: TArgs) => Promise<V>;
+    /**
+     * Returns a wrapped version of fn that invalidates a cache entry after call.
+     */
+    wrapDelete: <TReturn, TArgs extends unknown[]>(fn: (...args: TArgs) => TReturn | Promise<TReturn>, keyFn: CacheKeyProvider<K, TArgs>, options?: CacheWrapDeleteOptions<TArgs, CacheTag>) => (...args: TArgs) => Promise<TReturn>;
+    /**
+     * Calls fn → Invalidates tags → Returns the fn result.
+     * For operations that affect cached data but produce no cacheable result,
+     * e.g. CreateAll/updateAll on a collection cache where no filter key
+     * can be derived from the output.
+     */
+    wrapInvalidate: <TReturn, TArgs extends unknown[]>(fn: (...args: TArgs) => TReturn | Promise<TReturn>, options: CacheWrapInvalidateOptions<TArgs, CacheTag>) => (...args: TArgs) => Promise<TReturn>;
+    /**
+     * Directly write a value into this cache, following its configured
+     * write strategy.
+     *
+     * Use this instead of `wrapWrite` when the source function has already
+     * been called and you only need to propagate the result.
+     */
+    setDirect: (key: K, value: V, options?: CacheSetDirectOptions<CacheTag>) => Promise<void>;
+}
+/**
+ * The type for any unspecified cache.
+ */
+export type AnyCache = MultiTierCache<any, any, any> | CacheInterface<any, any, string, true, any> | CacheInterface<any, any, string, false, any>;
+/**
+ * Checks whether or not the given value is a cache.
+ * @param value - The value to check.
+ * @returns True if the value has all the keys of a cache, false otherwise.
+ */
+export declare function isCache(value: unknown): value is AnyCache;
+//# sourceMappingURL=cache.interface.d.ts.map

package/dist/cjs/caching/cache/cache.interface.d.ts.map

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

package/dist/cjs/caching/cache/cache.interface.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isCache = isCache;
+const multi_tier_cache_1 = require("./multi-tier.cache");
+/**
+ * Checks whether or not the given value is a cache.
+ * @param value - The value to check.
+ * @returns True if the value has all the keys of a cache, false otherwise.
+ */
+function isCache(value) {
+    if (value instanceof multi_tier_cache_1.MultiTierCache) {
+        return true;
+    }
+    // eslint-disable-next-line typescript/no-explicit-any
+    const keys = [
+        'defaultTtl',
+        'name',
+        'onInvalidationFailure',
+        'store',
+        'tags',
+        'wrap',
+        'wrapDelete',
+        'wrapInvalidate',
+        'wrapWrite'
+    ];
+    if (value == undefined || typeof value !== 'object') {
+        return false;
+    }
+    for (const key of keys) {
+        if (!(key in value)) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=cache.interface.js.map

package/dist/cjs/caching/cache/cache.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.interface.js","sourceRoot":"","sources":["../../../../src/caching/cache/cache.interface.ts"],"names":[],"mappings":";;AAuGA,0BA6BC;AAlID,yDAAoD;AAgGpD;;;;GAIG;AACH,SAAgB,OAAO,CAAC,KAAc;IAElC,IAAI,KAAK,YAAY,iCAAc,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,sDAAsD;IACtD,MAAM,IAAI,GAAqE;QAC3E,YAAY;QACZ,MAAM;QACN,uBAAuB;QACvB,OAAO;QACP,MAAM;QACN,MAAM;QACN,YAAY;QACZ,gBAAgB;QAChB,WAAW;KACd,CAAC;IAEF,IAAI,KAAK,IAAI,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/cjs/caching/cache/multi-tier.cache.d.ts

@@ -0,0 +1,64 @@
+import { CacheWrapOptions, CacheWrapDeleteOptions, CacheWrapInvalidateOptions, CacheKeyProvider, ResultCacheKeyProvider, OnInvalidationFailure, CacheTagsProvider, CacheSetDirectOptions } from './cache-options.model';
+import { LoggerInterface } from '../../logging/logger.interface';
+import { MetricsServiceInterface } from '../../metrics/metrics-service.interface';
+import { CacheMetrics } from '../cache-metrics.model';
+import { CacheServiceInterface } from '../cache-service.interface';
+import { ExtractCacheWriteResultAvailable } from '../decorators/decorator-types';
+import { CacheStoreInterface } from '../store/cache-store.interface';
+type TierLike<K, V, CacheTag extends string, N extends string> = {
+    readonly name: N;
+    store: CacheStoreInterface<K, V>;
+    _writeResultAvailable?: boolean;
+    setDirect(key: K, value: V, options?: CacheSetDirectOptions<CacheTag>): Promise<void>;
+};
+type TierName<Tiers extends readonly TierLike<any, any, any, any>[]> = Tiers[number]['name'];
+/** Outer WR – true if any tier is true, else false. */
+type OuterWR<Tiers extends readonly TierLike<any, any, any, any>[]> = true extends ExtractCacheWriteResultAvailable<Tiers[number]> ? true : false;
+/** The options object for wrapWrite. */
+export type MultiWrapWriteOptions<V, TArgs extends unknown[], CacheTag extends string, Tiers extends readonly TierLike<any, V, CacheTag, any>[]> = {
+    /**
+     * The configuration for each internal cache.
+     */
+    perCache?: Partial<Record<TierName<Tiers>, CacheWrapOptions<V, TArgs, CacheTag>>>;
+    /**
+     * A provider for the tags to invalidate.
+     */
+    invalidatesTags?: CacheTagsProvider<TArgs, CacheTag>;
+};
+/** Per‑tier wrap options – just `CacheWrapOptions` for each tier. */
+export type MultiWrapOptions<V, TArgs extends unknown[], CacheTag extends string, Tiers extends readonly TierLike<any, V, CacheTag, any>[]> = Partial<Record<TierName<Tiers>, CacheWrapOptions<V, TArgs, CacheTag>>>;
+/**
+ * Multi‑tier cache that composes multiple {@link CacheInterface} instances.
+ *
+ * Reads are cascaded through the tiers (fastest first). When a lower tier
+ * hits, all faster tiers are back‑filled. Writes are propagated to **every**
+ * tier via their setDirect method.
+ *
+ * The `WriteResultAvailable` flag must be supplied explicitly. If you want
+ * to mix a `false` tier (e.g. Write‑Around) into a `true` cache, simply cast it
+ * `as CacheInterface<K, V, Tag, true>` – the key is provided but the tier
+ * can safely ignore it.
+ */
+export declare abstract class MultiTierCache<K, V, Tiers extends readonly TierLike<K, V, CacheTag, any>[], CacheTag extends string = string> {
+    readonly name: string;
+    private readonly tiers;
+    readonly onInvalidationFailure?: OnInvalidationFailure | undefined;
+    private readonly _writeResultAvailable;
+    private _metrics;
+    protected abstract cacheService: CacheServiceInterface;
+    protected abstract logger: LoggerInterface;
+    protected abstract metricsService: MetricsServiceInterface;
+    /**
+     * The cache metrics.
+     */
+    protected get metrics(): CacheMetrics;
+    constructor(name: string, tiers: Tiers, onInvalidationFailure?: OnInvalidationFailure | undefined);
+    private initMetrics;
+    wrap<TArgs extends unknown[]>(fn: (...args: TArgs) => V | Promise<V>, keyFn: CacheKeyProvider<K, TArgs>, options?: MultiWrapOptions<V, TArgs, CacheTag, Tiers>): (...args: TArgs) => Promise<V>;
+    wrapWrite<TArgs extends unknown[]>(fn: (...args: TArgs) => V | Promise<V>, keyFn: OuterWR<Tiers> extends true ? ResultCacheKeyProvider<K, V, TArgs> : CacheKeyProvider<K, TArgs>, options?: MultiWrapWriteOptions<V, TArgs, CacheTag, Tiers>): (...args: TArgs) => Promise<V>;
+    wrapDelete<TReturn, TArgs extends unknown[]>(fn: (...args: TArgs) => TReturn | Promise<TReturn>, keyFn: CacheKeyProvider<K, TArgs>, options?: CacheWrapDeleteOptions<TArgs, CacheTag>): (...args: TArgs) => Promise<TReturn>;
+    wrapInvalidate<TReturn, TArgs extends unknown[]>(fn: (...args: TArgs) => TReturn | Promise<TReturn>, options: CacheWrapInvalidateOptions<TArgs, CacheTag>): (...args: TArgs) => Promise<TReturn>;
+    private safeInvalidateTags;
+}
+export {};
+//# sourceMappingURL=multi-tier.cache.d.ts.map

package/dist/cjs/caching/cache/multi-tier.cache.d.ts.map

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

package/dist/cjs/caching/cache/multi-tier.cache.js

@@ -0,0 +1,190 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiTierCache = void 0;
+const cache_operation_enum_1 = require("./cache-operation.enum");
+const als_utilities_1 = require("../../context/als.utilities");
+/**
+ * Multi‑tier cache that composes multiple {@link CacheInterface} instances.
+ *
+ * Reads are cascaded through the tiers (fastest first). When a lower tier
+ * hits, all faster tiers are back‑filled. Writes are propagated to **every**
+ * tier via their setDirect method.
+ *
+ * The `WriteResultAvailable` flag must be supplied explicitly. If you want
+ * to mix a `false` tier (e.g. Write‑Around) into a `true` cache, simply cast it
+ * `as CacheInterface<K, V, Tag, true>` – the key is provided but the tier
+ * can safely ignore it.
+ */
+class MultiTierCache {
+    name;
+    tiers;
+    onInvalidationFailure;
+    // Outer WR is computed, not stated by the user.
+    _writeResultAvailable;
+    _metrics;
+    // eslint-disable-next-line jsdoc/require-returns
+    /**
+     * The cache metrics.
+     */
+    get metrics() {
+        this._metrics ??= this.initMetrics();
+        return this._metrics;
+    }
+    constructor(name, tiers, onInvalidationFailure) {
+        this.name = name;
+        this.tiers = tiers;
+        this.onInvalidationFailure = onInvalidationFailure;
+        if (tiers.length === 0) {
+            throw new Error('MultiTierCache requires at least one tier');
+        }
+        this._writeResultAvailable = tiers.some(t => t._writeResultAvailable === true);
+    }
+    initMetrics() {
+        return {
+            hits: this.metricsService.getCounter('cache_hits_total', ['cache']),
+            misses: this.metricsService.getCounter('cache_misses_total', ['cache']),
+            writes: this.metricsService.getCounter('cache_writes_total', ['cache']),
+            deletes: this.metricsService.getCounter('cache_deletes_total', ['cache']),
+            invalidations: this.metricsService.getCounter('cache_invalidations_total', ['cache']),
+            invalidationFailures: this.metricsService.getCounter('cache_invalidation_failures_total', ['cache']),
+            expiredEvictions: this.metricsService.getCounter('cache_expired_evictions_total', ['cache']),
+            errors: this.metricsService.getCounter('cache_errors_total', ['cache', 'operation']),
+            inFlight: this.metricsService.getGauge('cache_in_flight', ['cache']),
+            size: this.metricsService.getGauge('cache_size', ['cache']),
+            sourceDuration: this.metricsService.getHistogram('cache_source_duration_ms', ['cache', 'operation'], [1, 5, 10, 25, 50, 100, 250, 500, 1000]),
+            storeDuration: this.metricsService.getHistogram('cache_store_duration_ms', ['cache', 'operation'], [1, 5, 10, 25, 50, 100, 250, 500])
+        };
+    }
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    wrap(fn, keyFn, options) {
+        return async (...args) => {
+            const key = await keyFn(...args);
+            for (let i = 0; i < this.tiers.length; i++) {
+                const cached = await this.tiers[i].store.get(key);
+                if (cached && (!cached.expiresAt || cached.expiresAt > new Date())) {
+                    // back‑fill earlier tiers – per‑tier options are NOT used here
+                    for (let j = 0; j < i; j++) {
+                        this.tiers[j].setDirect(key, cached.value, {
+                            ttl: cached.expiresAt
+                                ? cached.expiresAt.getTime() - Date.now()
+                                : undefined,
+                            tags: cached.tags
+                            // eslint-disable-next-line promise/prefer-await-to-then
+                        }).catch(() => { });
+                    }
+                    return cached.value;
+                }
+            }
+            // miss
+            const value = await fn(...args);
+            // populate all tiers using per‑tier options
+            await Promise.all(this.tiers.map(async (tier) => {
+                const tierOpt = options?.[tier.name];
+                const ttl = typeof tierOpt?.ttl === 'function'
+                    ? await tierOpt.ttl(value, ...args)
+                    : tierOpt?.ttl;
+                const tags = typeof tierOpt?.tags === 'function'
+                    ? await tierOpt.tags(value, ...args)
+                    : tierOpt?.tags;
+                await tier.setDirect(key, value, { ttl, tags }).catch(() => { });
+            }));
+            return value;
+        };
+    }
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    wrapWrite(fn, keyFn, options) {
+        return async (...args) => {
+            const value = await fn(...args);
+            const key = this._writeResultAvailable
+                ? await keyFn(value, ...args)
+                : await keyFn(...args);
+            const perTier = options?.perCache;
+            // eslint-disable-next-line sonar/cognitive-complexity
+            await Promise.all(this.tiers.map(async (tier) => {
+                const tierOpt = perTier?.[tier.name];
+                let ttl;
+                let tags;
+                if (this._writeResultAvailable) {
+                    const o = tierOpt;
+                    ttl = o?.ttl != undefined
+                        ? typeof o.ttl === 'function' ? await o.ttl(value, ...args) : o.ttl
+                        : undefined;
+                    tags = o?.tags
+                        ? typeof o.tags === 'function' ? await o.tags(value, ...args) : o.tags
+                        : undefined;
+                }
+                else {
+                    // eslint-disable-next-line stylistic/max-len
+                    const o = tierOpt;
+                    ttl = o?.ttl != undefined
+                        ? typeof o.ttl === 'function' ? await o.ttl(...args) : o.ttl
+                        : undefined;
+                    tags = o?.tags
+                        ? typeof o.tags === 'function' ? await o.tags(...args) : o.tags
+                        : undefined;
+                }
+                await tier.setDirect(key, value, { ttl, tags }).catch(() => { });
+            }));
+            // global tag invalidation
+            if (options?.invalidatesTags) {
+                const tags = typeof options.invalidatesTags === 'function'
+                    ? await options.invalidatesTags(...args)
+                    : options.invalidatesTags;
+                await this.safeInvalidateTags(tags);
+            }
+            return value;
+        };
+    }
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    wrapDelete(fn, keyFn, options) {
+        return async (...args) => {
+            const cacheCtx = { cache: this.name, operation: cache_operation_enum_1.CacheOperation.DELETE };
+            return als_utilities_1.AlsUtilities.runWithCacheContext(cacheCtx, async () => {
+                const res = await fn(...args);
+                const key = await keyFn(...args);
+                cacheCtx.key = key;
+                await Promise.all(this.tiers.map(tier => tier.store.delete(key)));
+                this.metrics.deletes.increase({ cache: this.name });
+                if (options?.invalidatesTags) {
+                    const tags = typeof options.invalidatesTags === 'function'
+                        ? await options.invalidatesTags(...args)
+                        : options.invalidatesTags;
+                    await this.safeInvalidateTags(tags);
+                }
+                return res;
+            });
+        };
+    }
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    wrapInvalidate(fn, options) {
+        return async (...args) => {
+            const cacheCtx = { cache: this.name, operation: cache_operation_enum_1.CacheOperation.INVALIDATE };
+            return als_utilities_1.AlsUtilities.runWithCacheContext(cacheCtx, async () => {
+                const result = await fn(...args);
+                const tags = typeof options.invalidatesTags === 'function'
+                    ? await options.invalidatesTags(...args)
+                    : options.invalidatesTags;
+                await this.safeInvalidateTags(tags);
+                return result;
+            });
+        };
+    }
+    async safeInvalidateTags(tags) {
+        if (!tags.length) {
+            return;
+        }
+        try {
+            await this.cacheService.invalidateTags(tags);
+            this.metrics.invalidations.increase({ cache: this.name });
+        }
+        catch (error) {
+            this.metrics.invalidationFailures.increase({ cache: this.name });
+            if (this.onInvalidationFailure === 'throw') {
+                throw error;
+            }
+            await this.logger.warn('Cache invalidation failed in multi‑tier cache', { error });
+        }
+    }
+}
+exports.MultiTierCache = MultiTierCache;
+//# sourceMappingURL=multi-tier.cache.js.map

package/dist/cjs/caching/cache/multi-tier.cache.js.map

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

package/dist/cjs/caching/cache/read-aside/read-aside.cache.d.ts

@@ -0,0 +1,16 @@
+import { BaseCache } from '../base-cache.model';
+import { CacheKeyProvider, CacheWrapOptions } from '../cache-options.model';
+/**
+ * Read‑aside base class.
+ *
+ * On a cache miss the source is called, but the result is **never** written
+ * back to the cache.  Cache population happens only via explicit write
+ * strategies (`wrapWrite`) or out‑of‑band processes.
+ *
+ * `wrapDelete` and `wrapInvalidate` work exactly like their read‑through
+ * counterparts.
+ */
+export declare abstract class ReadAsideCache<K, V, CacheTag extends string, WriteResultAvailable extends boolean, N extends string> extends BaseCache<K, V, CacheTag, WriteResultAvailable, N> {
+    wrap<TArgs extends unknown[]>(fn: (...args: TArgs) => V | Promise<V>, keyFn: CacheKeyProvider<K, TArgs>, options?: CacheWrapOptions<V, TArgs, CacheTag>): (...args: TArgs) => Promise<V>;
+}
+//# sourceMappingURL=read-aside.cache.d.ts.map

package/dist/cjs/caching/cache/read-aside/read-aside.cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-aside.cache.d.ts","sourceRoot":"","sources":["../../../../../src/caching/cache/read-aside/read-aside.cache.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE5E;;;;;;;;;GASG;AACH,8BAAsB,cAAc,CAChC,CAAC,EACD,CAAC,EACD,QAAQ,SAAS,MAAM,EACvB,oBAAoB,SAAS,OAAO,EACpC,CAAC,SAAS,MAAM,CAClB,SAAQ,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,oBAAoB,EAAE,CAAC,CAAC;IAExD,IAAI,CAAC,KAAK,SAAS,OAAO,EAAE,EACxB,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACtC,KAAK,EAAE,gBAAgB,CAAC,CAAC,EAAE,KAAK,CAAC,EAEjC,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,GAC/C,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC;CAoEpC"}

package/dist/cjs/caching/cache/read-aside/read-aside.cache.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadAsideCache = void 0;
+const als_utilities_1 = require("../../../context/als.utilities");
+const base_cache_model_1 = require("../base-cache.model");
+const cache_operation_enum_1 = require("../cache-operation.enum");
+/**
+ * Read‑aside base class.
+ *
+ * On a cache miss the source is called, but the result is **never** written
+ * back to the cache.  Cache population happens only via explicit write
+ * strategies (`wrapWrite`) or out‑of‑band processes.
+ *
+ * `wrapDelete` and `wrapInvalidate` work exactly like their read‑through
+ * counterparts.
+ */
+class ReadAsideCache extends base_cache_model_1.BaseCache {
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    wrap(fn, keyFn, 
+    // eslint-disable-next-line unusedImports/no-unused-vars
+    options) {
+        return async (...args) => {
+            const cacheCtx = { cache: this.name, operation: cache_operation_enum_1.CacheOperation.WRAP };
+            const label = { cache: this.name };
+            return als_utilities_1.AlsUtilities.runWithCacheContext(cacheCtx, async () => {
+                let key;
+                // ---------- try cache read ----------
+                try {
+                    key = await keyFn(...args);
+                    cacheCtx.key = key;
+                    const storeStart = performance.now();
+                    const cached = await this.store.get(key);
+                    this.metrics.storeDuration.observe({ cache: this.name, operation: cache_operation_enum_1.CacheOperation.WRAP }, performance.now() - storeStart);
+                    if (cached !== undefined) {
+                        // expired → evict, but still treat as miss
+                        if (cached.expiresAt !== undefined && cached.expiresAt.getTime() <= Date.now()) {
+                            this.metrics.expiredEvictions.increase(label);
+                            await Promise.resolve()
+                                .then(() => this.store.delete(key))
+                                .catch(() => undefined);
+                            await this.updateSizeGauge();
+                        }
+                        else {
+                            cacheCtx.hit = true;
+                            this.metrics.hits.increase(label);
+                            return cached.value;
+                        }
+                    }
+                }
+                catch (error) {
+                    this.metrics.errors.increase({ cache: this.name, operation: cache_operation_enum_1.CacheOperation.WRAP });
+                    await this.logger.warn('Cache read failed, treating as miss', { error });
+                }
+                // ---------- cache miss ----------
+                cacheCtx.hit = false;
+                this.metrics.misses.increase(label);
+                if (key == undefined) {
+                    const start = performance.now();
+                    const value = await fn(...args);
+                    cacheCtx.durationInMs = performance.now() - start;
+                    return value;
+                }
+                // Single‑flight: coalesce concurrent source calls for the same key.
+                // No store.set – **read‑aside**.
+                return this.runSingleFlight(key, async () => {
+                    const sourceStart = performance.now();
+                    const value = await fn(...args);
+                    const sourceDuration = performance.now() - sourceStart;
+                    cacheCtx.durationInMs = sourceDuration;
+                    this.metrics.sourceDuration.observe({ cache: this.name, operation: cache_operation_enum_1.CacheOperation.WRAP }, sourceDuration);
+                    return value;
+                });
+            });
+        };
+    }
+}
+exports.ReadAsideCache = ReadAsideCache;
+//# sourceMappingURL=read-aside.cache.js.map

package/dist/cjs/caching/cache/read-aside/read-aside.cache.js.map

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

package/dist/cjs/caching/cache/read-aside/write-around-read-aside.cache.d.ts

@@ -0,0 +1,16 @@
+import { CacheKeyProvider, CacheWrapWriteOptionsArgsOnly } from '../cache-options.model';
+import { CacheInterface } from '../cache.interface';
+import { ReadAsideCache } from './read-aside.cache';
+/**
+ * Write‑around read‑aside cache.
+ *
+ * Writes update the source and then only invalidate tags (no cache population).
+ * Reads (`wrap`) check the cache but **never** populate it.
+ */
+export declare abstract class WriteAroundReadAsideCache<K, V, N extends string, CacheTag extends string = string> extends ReadAsideCache<K, V, CacheTag, false, N> implements CacheInterface<K, V, CacheTag, false, N> {
+    readonly _writeResultAvailable: false;
+    wrapWrite<TArgs extends unknown[]>(fn: (...args: TArgs) => V | Promise<V>, _keyFn: CacheKeyProvider<K, TArgs>, // kept for interface compatibility, never used
+    options?: CacheWrapWriteOptionsArgsOnly<TArgs, CacheTag>): (...args: TArgs) => Promise<V>;
+    setDirect(): Promise<void>;
+}
+//# sourceMappingURL=write-around-read-aside.cache.d.ts.map

package/dist/cjs/caching/cache/read-aside/write-around-read-aside.cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-around-read-aside.cache.d.ts","sourceRoot":"","sources":["../../../../../src/caching/cache/read-aside/write-around-read-aside.cache.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;GAKG;AACH,8BAAsB,yBAAyB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,CACpG,SAAQ,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAC/C,YAAW,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAGnD,QAAQ,CAAC,qBAAqB,EAAE,KAAK,CAAS;IAG9C,SAAS,CAAC,KAAK,SAAS,OAAO,EAAE,EAC7B,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACtC,MAAM,EAAE,gBAAgB,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,+CAA+C;IACnF,OAAO,CAAC,EAAE,6BAA6B,CAAC,KAAK,EAAE,QAAQ,CAAC,GACzD,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC;IAuB3B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAGnC"}

package/dist/cjs/caching/cache/read-aside/write-around-read-aside.cache.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WriteAroundReadAsideCache = void 0;
+const als_utilities_1 = require("../../../context/als.utilities");
+const cache_operation_enum_1 = require("../cache-operation.enum");
+const read_aside_cache_1 = require("./read-aside.cache");
+/**
+ * Write‑around read‑aside cache.
+ *
+ * Writes update the source and then only invalidate tags (no cache population).
+ * Reads (`wrap`) check the cache but **never** populate it.
+ */
+class WriteAroundReadAsideCache extends read_aside_cache_1.ReadAsideCache {
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    _writeResultAvailable = false;
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    wrapWrite(fn, _keyFn, // kept for interface compatibility, never used
+    options) {
+        return async (...args) => {
+            const cacheCtx = { cache: this.name, operation: cache_operation_enum_1.CacheOperation.WRITE };
+            return als_utilities_1.AlsUtilities.runWithCacheContext(cacheCtx, async () => {
+                const sourceStart = performance.now();
+                const value = await fn(...args);
+                const sourceDuration = performance.now() - sourceStart;
+                cacheCtx.durationInMs = sourceDuration;
+                this.metrics.sourceDuration.observe({ cache: this.name, operation: cache_operation_enum_1.CacheOperation.WRITE }, sourceDuration);
+                await this.safeInvalidateTags(options?.invalidatesTags, args);
+                this.metrics.writes.increase({ cache: this.name });
+                return value;
+            });
+        };
+    }
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    async setDirect() {
+        // Write‑around: intentionally does not cache writes.
+    }
+}
+exports.WriteAroundReadAsideCache = WriteAroundReadAsideCache;
+//# sourceMappingURL=write-around-read-aside.cache.js.map

package/dist/cjs/caching/cache/read-aside/write-around-read-aside.cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-around-read-aside.cache.js","sourceRoot":"","sources":["../../../../../src/caching/cache/read-aside/write-around-read-aside.cache.ts"],"names":[],"mappings":";;;AAAA,kEAA8D;AAE9D,kEAAyD;AAGzD,yDAAoD;AAEpD;;;;;GAKG;AACH,MAAsB,yBAClB,SAAQ,iCAAwC;IAGhD,+CAA+C;IACtC,qBAAqB,GAAU,KAAK,CAAC;IAE9C,+CAA+C;IAC/C,SAAS,CACL,EAAsC,EACtC,MAAkC,EAAE,+CAA+C;IACnF,OAAwD;QAExD,OAAO,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE;YACrB,MAAM,QAAQ,GAAiB,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,qCAAc,CAAC,KAAK,EAAE,CAAC;YAErF,OAAO,4BAAY,CAAC,mBAAmB,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;gBACzD,MAAM,WAAW,GAAW,WAAW,CAAC,GAAG,EAAE,CAAC;gBAC9C,MAAM,KAAK,GAAM,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;gBACnC,MAAM,cAAc,GAAW,WAAW,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC;gBAC/D,QAAQ,CAAC,YAAY,GAAG,cAAc,CAAC;gBACvC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,CAC/B,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,qCAAc,CAAC,KAAK,EAAE,EACrD,cAAc,CACjB,CAAC;gBAEF,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC;gBAC9D,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBAEnD,OAAO,KAAK,CAAC;YACjB,CAAC,CAAC,CAAC;QACP,CAAC,CAAC;IACN,CAAC;IAED,+CAA+C;IAC/C,KAAK,CAAC,SAAS;QACX,qDAAqD;IACzD,CAAC;CACJ;AAtCD,8DAsCC"}

package/dist/cjs/caching/cache/read-aside/write-behind-read-aside.cache.d.ts

@@ -0,0 +1,15 @@
+import { ResultCacheKeyProvider, CacheWrapWriteOptionsWithResult, CacheSetDirectOptions } from '../cache-options.model';
+import { CacheInterface } from '../cache.interface';
+import { ReadAsideCache } from './read-aside.cache';
+/**
+ * Write‑behind read‑aside cache.
+ *
+ * Writes update the source and then fire‑and‑forget a cache store.
+ * Reads (`wrap`) check the cache but **never** populate it.
+ */
+export declare abstract class WriteBehindReadAsideCache<K, V, N extends string, CacheTag extends string = string> extends ReadAsideCache<K, V, CacheTag, true, N> implements CacheInterface<K, V, CacheTag, true, N> {
+    readonly _writeResultAvailable: true;
+    wrapWrite<TArgs extends unknown[]>(fn: (...args: TArgs) => V | Promise<V>, keyFn: ResultCacheKeyProvider<K, V, TArgs>, options?: CacheWrapWriteOptionsWithResult<V, TArgs, CacheTag>): (...args: TArgs) => Promise<V>;
+    setDirect(key: K, value: V, options?: CacheSetDirectOptions<CacheTag>): Promise<void>;
+}
+//# sourceMappingURL=write-behind-read-aside.cache.d.ts.map

package/dist/cjs/caching/cache/read-aside/write-behind-read-aside.cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-behind-read-aside.cache.d.ts","sourceRoot":"","sources":["../../../../../src/caching/cache/read-aside/write-behind-read-aside.cache.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,+BAA+B,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACxH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;GAKG;AACH,8BAAsB,yBAAyB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,CACpG,SAAQ,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAC9C,YAAW,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAGlD,QAAQ,CAAC,qBAAqB,EAAE,IAAI,CAAQ;IAG5C,SAAS,CAAC,KAAK,SAAS,OAAO,EAAE,EAC7B,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACtC,KAAK,EAAE,sBAAsB,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,EAC1C,OAAO,CAAC,EAAE,+BAA+B,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,GAC9D,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC;IAmD3B,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,qBAAqB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAkB9F"}