zibri 2.2.1 → 2.4.0

package/dist/esm/backup/transports/fs.backup-transport.js

@@ -1,16 +1,20 @@
-import { pipeline } from 'stream/promises';
-import { ZIBRI_DI_TOKENS } from '../../di/default/zibri-di-tokens.default';
-import { inject } from '../../di/inject.function';
-import { FsUtilities } from '../../utilities/fs.utilities';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FsBackupTransport = void 0;
+const promises_1 = require("stream/promises");
+const zibri_di_tokens_default_1 = require("../../di/default/zibri-di-tokens.default");
+const inject_function_1 = require("../../di/inject.function");
+const fs_utilities_1 = require("../../utilities/fs.utilities");
+const json_utilities_1 = require("../../utilities/json.utilities");
 const METADATA_FILENAME = 'metadata.json';
 /**
  * A transport that saves the data to the local file system.
  */
-export class FsBackupTransport {
+class FsBackupTransport {
     name;
     backupBasePath;
     get logger() {
-        return inject(ZIBRI_DI_TOKENS.LOGGER);
+        return (0, inject_function_1.inject)(zibri_di_tokens_default_1.ZIBRI_DI_TOKENS.LOGGER);
     }
     constructor(name, backupBasePath) {
         this.name = name;
@@ -18,10 +22,10 @@ export class FsBackupTransport {
     }
     // eslint-disable-next-line jsdoc/require-jsdoc
     async resolveBackups(existingEntities) {
-        if (!await FsUtilities.exists(this.backupBasePath)) {
+        if (!await fs_utilities_1.FsUtilities.exists(this.backupBasePath)) {
             return [];
         }
-        const nodes = await FsUtilities.readdir(this.backupBasePath);
+        const nodes = await fs_utilities_1.FsUtilities.readdir(this.backupBasePath);
         const res = (await Promise.all(nodes.map(async (node) => {
             if (!node.isDirectory()) {
                 return;
@@ -29,41 +33,42 @@ export class FsBackupTransport {
             if (existingEntities.map(e => e.name).includes(node.name)) {
                 return;
             }
-            const p = FsUtilities.getPath(node.parentPath, node.name, METADATA_FILENAME);
-            if (!await FsUtilities.exists(p)) {
+            const p = fs_utilities_1.FsUtilities.getPath(node.parentPath, node.name, METADATA_FILENAME);
+            if (!await fs_utilities_1.FsUtilities.exists(p)) {
                 await this.logger.warn(`Could not find the metadata file needed to resolve a backup: "${p}"`);
                 return;
             }
-            const json = await FsUtilities.readFile(p);
-            return JSON.parse(json);
+            const json = await fs_utilities_1.FsUtilities.readFile(p);
+            return json_utilities_1.JsonUtilities.parse(json);
         }))).filter(b => b != undefined);
         return res;
     }
     // eslint-disable-next-line jsdoc/require-jsdoc
     async storeData(data, backup, resource) {
         const p = this.getResourcePath(backup, resource);
-        await FsUtilities.mkdir(this.getBackupPath(backup));
-        await FsUtilities.createFile(this.getBackupMetadataPath(backup), JSON.stringify(backup));
-        await pipeline(data, FsUtilities.createWriteStream(p));
+        await fs_utilities_1.FsUtilities.mkdir(this.getBackupPath(backup));
+        await fs_utilities_1.FsUtilities.createFile(this.getBackupMetadataPath(backup), json_utilities_1.JsonUtilities.stringify(backup));
+        await (0, promises_1.pipeline)(data, fs_utilities_1.FsUtilities.createWriteStream(p));
     }
     // eslint-disable-next-line jsdoc/require-jsdoc
     retrieveData(backup, resource) {
         const p = this.getResourcePath(backup, resource);
-        return FsUtilities.createReadStream(p);
+        return fs_utilities_1.FsUtilities.createReadStream(p);
     }
     // eslint-disable-next-line jsdoc/require-jsdoc
     async deleteData(backup, resource) {
         const p = this.getResourcePath(backup, resource);
-        await FsUtilities.rm(p);
+        await fs_utilities_1.FsUtilities.rm(p);
     }
     getResourcePath(backup, resource) {
-        return FsUtilities.getPath(this.getBackupPath(backup), resource.name);
+        return fs_utilities_1.FsUtilities.getPath(this.getBackupPath(backup), resource.name);
     }
     getBackupPath(backup) {
-        return FsUtilities.getPath(this.backupBasePath, backup.name);
+        return fs_utilities_1.FsUtilities.getPath(this.backupBasePath, backup.name);
     }
     getBackupMetadataPath(backup) {
-        return FsUtilities.getPath(this.getBackupPath(backup), METADATA_FILENAME);
+        return fs_utilities_1.FsUtilities.getPath(this.getBackupPath(backup), METADATA_FILENAME);
     }
 }
+exports.FsBackupTransport = FsBackupTransport;
 //# sourceMappingURL=fs.backup-transport.js.map

package/dist/esm/backup/transports/fs.backup-transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"fs.backup-transport.js","sourceRoot":"","sources":["../../../../src/backup/transports/fs.backup-transport.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG3C,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAElD,OAAO,EAAE,WAAW,EAAQ,MAAM,8BAA8B,CAAC;AAIjE,MAAM,iBAAiB,GAAW,eAAe,CAAC;AAElD;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAML;IAAiC;IAJtD,IAAY,MAAM;QACd,OAAO,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,YAAqB,IAAY,EAAqB,cAAoB;QAArD,SAAI,GAAJ,IAAI,CAAQ;QAAqB,mBAAc,GAAd,cAAc,CAAM;IAAG,CAAC;IAE9E,+CAA+C;IAC/C,KAAK,CAAC,cAAc,CAAC,gBAAgC;QACjD,IAAI,CAAC,MAAM,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;YACjD,OAAO,EAAE,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAqB,MAAM,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC/E,MAAM,GAAG,GAAmB,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAC,IAAI,EAAC,EAAE;YAClE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACtB,OAAO;YACX,CAAC;YACD,IAAI,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxD,OAAO;YACX,CAAC;YACD,MAAM,CAAC,GAAS,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;YACnF,IAAI,CAAC,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iEAAiE,CAAC,GAAG,CAAC,CAAC;gBAC9F,OAAO;YACX,CAAC;YACD,MAAM,IAAI,GAAW,MAAM,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAiB,CAAC;QAC5C,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC;QACjC,OAAO,GAAG,CAAC;IACf,CAAC;IAED,+CAA+C;IAC/C,KAAK,CAAC,SAAS,CAAC,IAAc,EAAE,MAAoB,EAAE,QAA8B;QAChF,MAAM,CAAC,GAAS,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACvD,MAAM,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;QACpD,MAAM,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QAEzF,MAAM,QAAQ,CACV,IAAI,EACJ,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC,CACnC,CAAC;IACN,CAAC;IAED,+CAA+C;IAC/C,YAAY,CAAC,MAAoB,EAAE,QAA8B;QAC7D,MAAM,CAAC,GAAS,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACvD,OAAO,WAAW,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,+CAA+C;IAC/C,KAAK,CAAC,UAAU,CAAC,MAAoB,EAAE,QAA8B;QACjE,MAAM,CAAC,GAAS,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACvD,MAAM,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IAEO,eAAe,CAAC,MAAoB,EAAE,QAA8B;QACxE,OAAO,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;IAEO,aAAa,CAAC,MAAoB;QACtC,OAAO,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC;IAEO,qBAAqB,CAAC,MAAoB;QAC9C,OAAO,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAC9E,CAAC;CACJ"}
+{"version":3,"file":"fs.backup-transport.js","sourceRoot":"","sources":["../../../../src/backup/transports/fs.backup-transport.ts"],"names":[],"mappings":"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"}

package/dist/esm/caching/cache/base-cache.model.js

@@ -0,0 +1,245 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseCache = void 0;
+const als_utilities_1 = require("../../context/als.utilities");
+const cache_operation_enum_1 = require("./cache-operation.enum");
+/**
+ * Shared base class of all caches.
+ */
+class BaseCache {
+    name;
+    store;
+    tags;
+    defaultTtl;
+    onInvalidationFailure;
+    inFlight = new Map();
+    _metrics;
+    // eslint-disable-next-line jsdoc/require-returns
+    /**
+     * The cache metrics.
+     */
+    get metrics() {
+        this._metrics ??= this.initMetrics();
+        return this._metrics;
+    }
+    constructor(name, store, tags, defaultTtl, onInvalidationFailure) {
+        this.name = name;
+        this.store = store;
+        this.tags = tags;
+        this.defaultTtl = defaultTtl;
+        this.onInvalidationFailure = onInvalidationFailure;
+    }
+    // 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 sourceStart = performance.now();
+                const res = await fn(...args);
+                cacheCtx.durationInMs = performance.now() - sourceStart;
+                this.metrics.sourceDuration.observe({ cache: this.name, operation: cache_operation_enum_1.CacheOperation.DELETE }, cacheCtx.durationInMs);
+                await Promise.all([
+                    Promise.resolve()
+                        .then(async () => {
+                        const key = await keyFn(...args);
+                        cacheCtx.key = key;
+                        const storeStart = performance.now();
+                        await this.store.delete(key);
+                        this.metrics.storeDuration.observe({ cache: this.name, operation: 'delete' }, performance.now() - storeStart);
+                        this.metrics.deletes.increase({ cache: this.name });
+                        await this.updateSizeGauge();
+                    })
+                        .catch(async (error) => {
+                        this.metrics.errors.increase({ cache: this.name, operation: 'delete' });
+                        await this.logger.warn('Cache deletion failed after successful source delete', { error });
+                    }),
+                    this.safeInvalidateTags(options?.invalidatesTags, args)
+                ]);
+                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 sourceStart = performance.now();
+                const result = await fn(...args);
+                cacheCtx.durationInMs = performance.now() - sourceStart;
+                this.metrics.sourceDuration.observe({ cache: this.name, operation: cache_operation_enum_1.CacheOperation.INVALIDATE }, cacheCtx.durationInMs);
+                await this.safeInvalidateTags(options.invalidatesTags, args);
+                return result;
+            });
+        };
+    }
+    initMetrics() {
+        const label = ['cache'];
+        const labelWithOp = ['cache', 'operation'];
+        return {
+            hits: this.metricsService.getCounter('cache_hits_total', label),
+            misses: this.metricsService.getCounter('cache_misses_total', label),
+            writes: this.metricsService.getCounter('cache_writes_total', label),
+            deletes: this.metricsService.getCounter('cache_deletes_total', label),
+            invalidations: this.metricsService.getCounter('cache_invalidations_total', label),
+            invalidationFailures: this.metricsService.getCounter('cache_invalidation_failures_total', label),
+            expiredEvictions: this.metricsService.getCounter('cache_expired_evictions_total', label),
+            errors: this.metricsService.getCounter('cache_errors_total', labelWithOp),
+            inFlight: this.metricsService.getGauge('cache_in_flight', label),
+            size: this.metricsService.getGauge('cache_size', label),
+            sourceDuration: this.metricsService.getHistogram('cache_source_duration_ms', labelWithOp, [1, 5, 10, 25, 50, 100, 250, 500, 1000]),
+            storeDuration: this.metricsService.getHistogram('cache_store_duration_ms', labelWithOp, [1, 5, 10, 25, 50, 100, 250, 500])
+        };
+    }
+    /**
+     * Updates the size gauge metric.
+     */
+    async updateSizeGauge() {
+        try {
+            this.metrics.size.set({ cache: this.name }, await this.store.size());
+        }
+        catch {
+            // not critical — never surface gauge update failures
+        }
+    }
+    /**
+     * Runs the given factory under the given key in single flight.
+     * @param key - The key to check if a operation is already ongoing.
+     * @param factory - The operation to run.
+     * @returns The resolving promise.
+     */
+    async runSingleFlight(key, factory) {
+        const existing = this.inFlight.get(key);
+        if (existing !== undefined) {
+            return existing;
+        }
+        const promise = (async () => {
+            try {
+                return await factory();
+            }
+            finally {
+                this.inFlight.delete(key);
+                this.metrics.inFlight.set({ cache: this.name }, this.inFlight.size);
+            }
+        })();
+        this.inFlight.set(key, promise);
+        this.metrics.inFlight.set({ cache: this.name }, this.inFlight.size);
+        return promise;
+    }
+    /**
+     * Safely invalidates tags.
+     * @param provider - The provider for the tags to invalidate.
+     * @param resultOrArgs - Either the result or The method arguments, depending on whether the result is available.
+     * @param maybeArgs - The method arguments if a result is available, undefined otherwise.
+     */
+    async safeInvalidateTags(provider, resultOrArgs, maybeArgs) {
+        try {
+            const tags = maybeArgs !== undefined
+                ? await this.resolveResultTags(provider, resultOrArgs, maybeArgs)
+                : await this.resolveArgTags(provider, resultOrArgs);
+            if (!tags.length) {
+                return;
+            }
+            await this.cacheService.invalidateTags(tags);
+            this.metrics.invalidations.increase({ cache: this.name });
+            // size may have changed as other caches invalidated entries
+            await this.updateSizeGauge();
+        }
+        catch (error) {
+            this.metrics.invalidationFailures.increase({ cache: this.name });
+            if (this.onInvalidationFailure === 'throw') {
+                throw error;
+            }
+            else {
+                await this.logger.warn('Cache invalidation failed, stale data may be served', { error });
+            }
+        }
+    }
+    /**
+     * Resolves tags from a result provider.
+     * @param provider - The provider to resolve the tags from.
+     * @param result - The result.
+     * @param args - Additional arguments.
+     * @returns All resolved CacheTags.
+     */
+    async resolveResultTags(provider, result, args) {
+        if (!provider) {
+            return [];
+        }
+        if (typeof provider === 'function') {
+            return await provider(result, ...args);
+        }
+        return provider;
+    }
+    /**
+     * Resolves tags from a provider.
+     * @param provider - The provider to resolve the tags from.
+     * @param args - The arguments.
+     * @returns All resolved CacheTags.
+     */
+    async resolveArgTags(provider, args) {
+        if (!provider) {
+            return [];
+        }
+        if (typeof provider === 'function') {
+            return await provider(...args);
+        }
+        return provider;
+    }
+    /**
+     * Resolves ttl from a result provider.
+     * @param provider - The provider to resolve the ttl from.
+     * @param result - The result.
+     * @param args - The arguments.
+     * @returns The resolved time to live or undefined if values should be kept in cache without time limit.
+     */
+    async resolveResultTtl(provider, result, args) {
+        if (provider == undefined) {
+            if (typeof this.defaultTtl === 'function') {
+                return await this.defaultTtl();
+            }
+            return this.defaultTtl;
+        }
+        if (typeof provider === 'function') {
+            return await provider(result, ...args);
+        }
+        return provider;
+    }
+    /**
+     * Resolves ttl from a provider.
+     * @param provider - The provider to resolve the ttl from.
+     * @param args - The arguments.
+     * @returns The resolved time to live or undefined if values should be kept in cache without time limit.
+     */
+    async resolveArgsTtl(provider, args) {
+        if (provider == undefined) {
+            if (typeof this.defaultTtl === 'function') {
+                return await this.defaultTtl();
+            }
+            return this.defaultTtl;
+        }
+        if (typeof provider === 'function') {
+            return await provider(...args);
+        }
+        return provider;
+    }
+    /**
+     * Creates a cached value from the given input.
+     * @param value - The value of the value to cache.
+     * @param tags - The tags that should mark this cache entry.
+     * @param ttl - The time that this cache entry should be valid.
+     * @returns A cached value definition.
+     */
+    createCachedValue(value, tags, ttl) {
+        const createdAt = new Date();
+        const expiresAt = ttl != undefined ? new Date(createdAt.getTime() + ttl) : undefined;
+        return {
+            createdAt,
+            expiresAt,
+            value,
+            tags
+        };
+    }
+}
+exports.BaseCache = BaseCache;
+//# sourceMappingURL=base-cache.model.js.map

package/dist/esm/caching/cache/base-cache.model.js.map

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

package/dist/esm/caching/cache/cache-operation.enum.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheOperation = void 0;
+/**
+ * The different operations of a cache.
+ */
+var CacheOperation;
+(function (CacheOperation) {
+    CacheOperation["WRAP"] = "WRAP";
+    CacheOperation["WRITE"] = "WRITE";
+    CacheOperation["DELETE"] = "DELETE";
+    CacheOperation["INVALIDATE"] = "INVALIDATE";
+})(CacheOperation || (exports.CacheOperation = CacheOperation = {}));
+//# sourceMappingURL=cache-operation.enum.js.map

package/dist/esm/caching/cache/cache-operation.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-operation.enum.js","sourceRoot":"","sources":["../../../../src/caching/cache/cache-operation.enum.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,cAKX;AALD,WAAY,cAAc;IACtB,+BAAa,CAAA;IACb,iCAAe,CAAA;IACf,mCAAiB,CAAA;IACjB,2CAAyB,CAAA;AAC7B,CAAC,EALW,cAAc,8BAAd,cAAc,QAKzB"}

package/dist/esm/caching/cache/cache-options.model.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=cache-options.model.js.map

package/dist/esm/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/esm/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/esm/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/esm/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/esm/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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"}