zibri 2.3.0 → 2.4.0

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,GAAoB,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,qCAAc,CAAC,KAAK,EAAE,CAAC;YAExF,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"}

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

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WriteBehindReadAsideCache = 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‑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.
+ */
+class WriteBehindReadAsideCache extends read_aside_cache_1.ReadAsideCache {
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    _writeResultAvailable = true;
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    wrapWrite(fn, keyFn, 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, value, args);
+                const key = await keyFn(value, ...args);
+                cacheCtx.key = key;
+                const [tags, ttl] = await Promise.all([
+                    this.resolveResultTags(options?.tags, value, args),
+                    this.resolveResultTtl(options?.ttl, value, args)
+                ]);
+                // Fire‑and‑forget write
+                Promise.resolve()
+                    // eslint-disable-next-line promise/prefer-await-to-then
+                    .then(async () => {
+                    const storeStart = performance.now();
+                    await this.store.set(key, this.createCachedValue(value, tags, ttl));
+                    this.metrics.storeDuration.observe({ cache: this.name, operation: 'set' }, performance.now() - storeStart);
+                    this.metrics.writes.increase({ cache: this.name });
+                    await this.updateSizeGauge();
+                })
+                    // eslint-disable-next-line promise/prefer-await-to-then, promise/prefer-await-to-callbacks
+                    .catch(async (error) => {
+                    this.metrics.errors.increase({ cache: this.name, operation: 'set' });
+                    await this.logger.warn('Background cache write failed', { error });
+                });
+                return value;
+            });
+        };
+    }
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    async setDirect(key, value, options) {
+        const ttl = options?.ttl ?? await this.resolveResultTtl(undefined, value, []);
+        const tags = options?.tags ?? [];
+        Promise.resolve()
+            // eslint-disable-next-line promise/prefer-await-to-then
+            .then(async () => {
+            const storeStart = performance.now();
+            await this.store.set(key, this.createCachedValue(value, tags, ttl));
+            this.metrics.storeDuration.observe({ cache: this.name, operation: 'set' }, performance.now() - storeStart);
+            this.metrics.writes.increase({ cache: this.name });
+            await this.updateSizeGauge();
+        })
+            // eslint-disable-next-line promise/prefer-await-to-then, promise/prefer-await-to-callbacks
+            .catch(async (error) => {
+            this.metrics.errors.increase({ cache: this.name, operation: 'set' });
+            await this.logger.warn('Background cache write failed in setDirect', { error });
+        });
+    }
+}
+exports.WriteBehindReadAsideCache = WriteBehindReadAsideCache;
+//# sourceMappingURL=write-behind-read-aside.cache.js.map

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

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

package/dist/cjs/caching/cache/read-aside/write-invalidate-read-aside-args-only.cache.d.ts

@@ -0,0 +1,15 @@
+import { CacheKeyProvider, CacheWrapWriteOptionsArgsOnly } from '../cache-options.model';
+import { CacheInterface } from '../cache.interface';
+import { ReadAsideCache } from './read-aside.cache';
+/**
+ * Write‑invalidate (key from arguments) read‑aside cache.
+ *
+ * After a source write, the cache entry derived from **arguments** is deleted.
+ * Reads (`wrap`) check the cache but **never** populate it.
+ */
+export declare abstract class WriteInvalidateReadAsideArgsOnlyCache<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>, options?: CacheWrapWriteOptionsArgsOnly<TArgs, CacheTag>): (...args: TArgs) => Promise<V>;
+    setDirect(key: K): Promise<void>;
+}
+//# sourceMappingURL=write-invalidate-read-aside-args-only.cache.d.ts.map

package/dist/cjs/caching/cache/read-aside/write-invalidate-read-aside-args-only.cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-invalidate-read-aside-args-only.cache.d.ts","sourceRoot":"","sources":["../../../../../src/caching/cache/read-aside/write-invalidate-read-aside-args-only.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,qCAAqC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,CAChH,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,KAAK,EAAE,gBAAgB,CAAC,CAAC,EAAE,KAAK,CAAC,EACjC,OAAO,CAAC,EAAE,6BAA6B,CAAC,KAAK,EAAE,QAAQ,CAAC,GACzD,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC;IA6C3B,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAazC"}