zibri 2.3.0 → 2.4.0

package/dist/cjs/caching/cache/read-through/write-invalidate-read-through-args-only.cache.js.map

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

package/dist/cjs/caching/cache/read-through/write-invalidate-read-through-with-result.cache.d.ts

@@ -0,0 +1,15 @@
+import { ResultCacheKeyProvider, CacheWrapWriteOptionsWithResult } from '../cache-options.model';
+import { CacheInterface } from '../cache.interface';
+import { ReadThroughCache } from './read-through.cache';
+/**
+ * Write‑invalidate (key from result) read‑through cache.
+ *
+ * After a successful source write, the cache entry identified by the
+ * **result** is deleted (typically after a creation that generates an ID).
+ */
+export declare abstract class WriteInvalidateReadThroughWithResultCache<K, V, N extends string, CacheTag extends string = string> extends ReadThroughCache<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): Promise<void>;
+}
+//# sourceMappingURL=write-invalidate-read-through-with-result.cache.d.ts.map

package/dist/cjs/caching/cache/read-through/write-invalidate-read-through-with-result.cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-invalidate-read-through-with-result.cache.d.ts","sourceRoot":"","sources":["../../../../../src/caching/cache/read-through/write-invalidate-read-through-with-result.cache.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AACjG,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;;GAKG;AACH,8BAAsB,yCAAyC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,CACpH,SAAQ,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAChD,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;IA8C3B,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAazC"}

package/dist/cjs/caching/cache/read-through/write-invalidate-read-through-with-result.cache.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WriteInvalidateReadThroughWithResultCache = void 0;
+const als_utilities_1 = require("../../../context/als.utilities");
+const cache_operation_enum_1 = require("../cache-operation.enum");
+const read_through_cache_1 = require("./read-through.cache");
+/**
+ * Write‑invalidate (key from result) read‑through cache.
+ *
+ * After a successful source write, the cache entry identified by the
+ * **result** is deleted (typically after a creation that generates an ID).
+ */
+class WriteInvalidateReadThroughWithResultCache extends read_through_cache_1.ReadThroughCache {
+    // 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);
+                // Invalidate tags and delete the result‑based key
+                await Promise.all([
+                    this.safeInvalidateTags(options?.invalidatesTags, value, args),
+                    Promise.resolve()
+                        .then(async () => {
+                        const key = await keyFn(value, ...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 invalidation (delete) failed after successful source write', { error });
+                    })
+                ]);
+                return value;
+            });
+        };
+    }
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    async setDirect(key) {
+        try {
+            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 (error) {
+            this.metrics.errors.increase({ cache: this.name, operation: 'delete' });
+            await this.logger.warn('Cache invalidation (delete) failed in setDirect', { error });
+        }
+    }
+}
+exports.WriteInvalidateReadThroughWithResultCache = WriteInvalidateReadThroughWithResultCache;
+//# sourceMappingURL=write-invalidate-read-through-with-result.cache.js.map

package/dist/cjs/caching/cache/read-through/write-invalidate-read-through-with-result.cache.js.map

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

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

@@ -0,0 +1,12 @@
+import { ResultCacheKeyProvider, CacheWrapWriteOptionsWithResult, CacheSetDirectOptions } from '../cache-options.model';
+import { CacheInterface } from '../cache.interface';
+import { ReadThroughCache } from './read-through.cache';
+/**
+ * A write-through read-through cache.
+ */
+export declare abstract class WriteThroughReadThroughCache<K, V, N extends string, CacheTag extends string = string> extends ReadThroughCache<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-through-read-through.cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write-through-read-through.cache.d.ts","sourceRoot":"","sources":["../../../../../src/caching/cache/read-through/write-through-read-through.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,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD;;GAEG;AACH,8BAAsB,4BAA4B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,CACvG,SAAQ,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAChD,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;IAyC3B,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,qBAAqB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAa9F"}

package/dist/cjs/caching/cache/read-through/write-through-read-through.cache.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WriteThroughReadThroughCache = void 0;
+const als_utilities_1 = require("../../../context/als.utilities");
+const cache_operation_enum_1 = require("../cache-operation.enum");
+const read_through_cache_1 = require("./read-through.cache");
+/**
+ * A write-through read-through cache.
+ */
+class WriteThroughReadThroughCache extends read_through_cache_1.ReadThroughCache {
+    // 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);
+                try {
+                    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)
+                    ]);
+                    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();
+                }
+                catch (error) {
+                    this.metrics.errors.increase({ cache: this.name, operation: 'set' });
+                    await this.logger.warn('Cache store failed after successful source write, source write was not rolled back', { error });
+                }
+                return value;
+            });
+        };
+    }
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    async setDirect(key, value, options) {
+        try {
+            const ttl = options?.ttl ?? await this.resolveResultTtl(undefined, value, []);
+            const tags = options?.tags ?? [];
+            await this.store.set(key, this.createCachedValue(value, tags, ttl));
+            this.metrics.writes.increase({ cache: this.name });
+            await this.updateSizeGauge();
+        }
+        catch (error) {
+            this.metrics.errors.increase({ cache: this.name, operation: 'set' });
+            await this.logger.warn('Cache store failed in setDirect', { error });
+        }
+    }
+}
+exports.WriteThroughReadThroughCache = WriteThroughReadThroughCache;
+//# sourceMappingURL=write-through-read-through.cache.js.map

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

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

package/dist/cjs/caching/cache-metrics.model.d.ts

@@ -0,0 +1,57 @@
+import { CounterInterface } from '../metrics/counter.interface';
+import { GaugeInterface } from '../metrics/gauge.interface';
+import { HistogramInterface } from '../metrics/histogram.interface';
+/**
+ * Metrics regarding caching.
+ */
+export type CacheMetrics = {
+    /**
+     * How many times caches have been hit.
+     */
+    hits: CounterInterface;
+    /**
+     * How many times caches have been missed.
+     */
+    misses: CounterInterface;
+    /**
+     * How many times values have been written to caches.
+     */
+    writes: CounterInterface;
+    /**
+     * How many times values have been deleted from caches.
+     */
+    deletes: CounterInterface;
+    /**
+     * How many times cache invalidations have happened.
+     */
+    invalidations: CounterInterface;
+    /**
+     * How many times cache invalidations have failed.
+     */
+    invalidationFailures: CounterInterface;
+    /**
+     * How many times cached values have expired.
+     */
+    expiredEvictions: CounterInterface;
+    /**
+     * How many times errors occurred during caching.
+     */
+    errors: CounterInterface;
+    /**
+     * The current amount of inFlight cache operations.
+     */
+    inFlight: GaugeInterface;
+    /**
+     * The amount of cached values.
+     */
+    size: GaugeInterface;
+    /**
+     * The duration of the original functions.
+     */
+    sourceDuration: HistogramInterface;
+    /**
+     * The duration of cache operations.
+     */
+    storeDuration: HistogramInterface;
+};
+//# sourceMappingURL=cache-metrics.model.d.ts.map

package/dist/cjs/caching/cache-metrics.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-metrics.model.d.ts","sourceRoot":"","sources":["../../../src/caching/cache-metrics.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB;;OAEG;IACH,IAAI,EAAE,gBAAgB,CAAC;IACvB;;OAEG;IACH,MAAM,EAAE,gBAAgB,CAAC;IACzB;;OAEG;IACH,MAAM,EAAE,gBAAgB,CAAC;IACzB;;OAEG;IACH,OAAO,EAAE,gBAAgB,CAAC;IAC1B;;OAEG;IACH,aAAa,EAAE,gBAAgB,CAAC;IAChC;;OAEG;IACH,oBAAoB,EAAE,gBAAgB,CAAC;IACvC;;OAEG;IACH,gBAAgB,EAAE,gBAAgB,CAAC;IACnC;;OAEG;IACH,MAAM,EAAE,gBAAgB,CAAC;IACzB;;OAEG;IACH,QAAQ,EAAE,cAAc,CAAC;IACzB;;OAEG;IACH,IAAI,EAAE,cAAc,CAAC;IACrB;;OAEG;IACH,cAAc,EAAE,kBAAkB,CAAC;IACnC;;OAEG;IACH,aAAa,EAAE,kBAAkB,CAAA;CACpC,CAAC"}

package/dist/cjs/caching/cache-metrics.model.js

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

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

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

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

@@ -0,0 +1,15 @@
+import { AnyCache } from './cache/cache.interface';
+/**
+ * Interface for a cache service.
+ */
+export interface CacheServiceInterface {
+    /**
+     * All caches that have been registered.
+     */
+    readonly caches: AnyCache[];
+    /**
+     * Invalidates the given tags through all caches.
+     */
+    invalidateTags: (tags: string[]) => void | Promise<void>;
+}
+//# sourceMappingURL=cache-service.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache-service.interface.d.ts","sourceRoot":"","sources":["../../../src/caching/cache-service.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC5B;;OAEG;IACH,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3D"}

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

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

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

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

package/dist/cjs/caching/cache-tag-matchers.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Matcher for a tag.
+ */
+export type CacheTagMatcher = string | RegExp | ((tag: string) => boolean);
+/**
+ * Checks whether the given matchers match any of the given tags.
+ * @param matchers - The matchers used for the check.
+ * @param tags - The tags to check.
+ * @returns True if any of the tags are matched by at least one of the matchers, false otherwise.
+ */
+export declare function matchesAnyTag(matchers: readonly CacheTagMatcher[], tags: string[]): boolean;
+/**
+ * Checks whether or not the given matcher matches the given tag.
+ * @param matcher - The matcher used for the check.
+ * @param tag - The tag to check.
+ * @returns True if the matcher matches the tag, false otherwise.
+ */
+export declare function matchesTag(matcher: CacheTagMatcher, tag: string): boolean;
+//# sourceMappingURL=cache-tag-matchers.d.ts.map

package/dist/cjs/caching/cache-tag-matchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-tag-matchers.d.ts","sourceRoot":"","sources":["../../../src/caching/cache-tag-matchers.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,MAAM,MAAM,eAAe,GAAK,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;AAE7E;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAE3F;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAQzE"}

package/dist/cjs/caching/cache-tag-matchers.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchesAnyTag = matchesAnyTag;
+exports.matchesTag = matchesTag;
+/**
+ * Checks whether the given matchers match any of the given tags.
+ * @param matchers - The matchers used for the check.
+ * @param tags - The tags to check.
+ * @returns True if any of the tags are matched by at least one of the matchers, false otherwise.
+ */
+function matchesAnyTag(matchers, tags) {
+    return matchers.some(matcher => tags.some(tag => matchesTag(matcher, tag)));
+}
+/**
+ * Checks whether or not the given matcher matches the given tag.
+ * @param matcher - The matcher used for the check.
+ * @param tag - The tag to check.
+ * @returns True if the matcher matches the tag, false otherwise.
+ */
+function matchesTag(matcher, tag) {
+    if (typeof matcher === 'string') {
+        return matcher === tag;
+    }
+    if (matcher instanceof RegExp) {
+        return matcher.test(tag);
+    }
+    return matcher(tag);
+}
+//# sourceMappingURL=cache-tag-matchers.js.map

package/dist/cjs/caching/cache-tag-matchers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-tag-matchers.js","sourceRoot":"","sources":["../../../src/caching/cache-tag-matchers.ts"],"names":[],"mappings":";;AAYA,sCAEC;AAQD,gCAQC;AAxBD;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,QAAoC,EAAE,IAAc;IAC9E,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;AAChF,CAAC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,OAAwB,EAAE,GAAW;IAC5D,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,OAAO,KAAK,GAAG,CAAC;IAC3B,CAAC;IACD,IAAI,OAAO,YAAY,MAAM,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC"}

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

@@ -0,0 +1,15 @@
+import { AnyCache } from './cache/cache.interface';
+import { CacheServiceInterface } from './cache-service.interface';
+import { OnAppInit } from '../global/on-app-init.interface';
+import { type LoggerInterface } from '../logging/logger.interface';
+/**
+ * Default implementation of the cache service.
+ */
+export declare class CacheService implements CacheServiceInterface, OnAppInit {
+    private readonly logger;
+    readonly caches: AnyCache[];
+    constructor(logger: LoggerInterface);
+    onAppInit(): Promise<void>;
+    invalidateTags(tags: string[]): Promise<void>;
+}
+//# sourceMappingURL=cache.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.service.d.ts","sourceRoot":"","sources":["../../../src/caching/cache.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAW,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAOlE,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAGnE;;GAEG;AACH,qBACa,YAAa,YAAW,qBAAqB,EAAE,SAAS;IAM7D,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJ3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAM;gBAIZ,MAAM,EAAE,eAAe;IAItC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC1B,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAOtD"}

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

@@ -0,0 +1,74 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheService = void 0;
+const cache_interface_1 = require("./cache/cache.interface");
+const cache_tag_matchers_1 = require("./cache-tag-matchers");
+const inject_decorator_1 = require("../di/decorators/inject.decorator");
+const injectable_decorator_1 = require("../di/decorators/injectable.decorator");
+const zibri_di_tokens_default_1 = require("../di/default/zibri-di-tokens.default");
+const inject_function_1 = require("../di/inject.function");
+const global_registry_1 = require("../global/global-registry");
+const multi_tier_cache_1 = require("./cache/multi-tier.cache");
+/**
+ * Default implementation of the cache service.
+ */
+let CacheService = class CacheService {
+    logger;
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    caches = [];
+    constructor(logger) {
+        this.logger = logger;
+    }
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    async onAppInit() {
+        if (global_registry_1.GlobalRegistry.cacheClasses.length) {
+            // eslint-disable-next-line stylistic/max-len
+            await this.logger.info(`configures ${global_registry_1.GlobalRegistry.cacheClasses.length} ${global_registry_1.GlobalRegistry.cacheClasses.length > 1 ? 'caches' : 'cache'}:`);
+        }
+        for (const cacheClass of global_registry_1.GlobalRegistry.cacheClasses) {
+            const cache = (0, inject_function_1.inject)(cacheClass);
+            this.caches.push(cache);
+            if (!(0, cache_interface_1.isCache)(cache)) {
+                throw new Error(`Invalid class marked with @Cache: ${cacheClass.name} needs to implement CacheInterface`);
+            }
+            await this.logger.info(`  - ${cache.name}`);
+        }
+        for (const cacheInjectable of global_registry_1.GlobalRegistry.injectables.map(i => (0, inject_function_1.inject)(i.token)).filter(i => (0, cache_interface_1.isCache)(i))) {
+            if (!this.caches.find(c => c.name === cacheInjectable.name)) {
+                throw new Error(`The class "${cacheInjectable.constructor}" seems to be a cache but has not been decorated with @Cache()`);
+            }
+        }
+        const duplicateCacheNames = this.caches.filter(c => this.caches.filter(internalC => internalC.name === c.name).length > 1);
+        if (duplicateCacheNames.length) {
+            throw new Error([
+                'There are duplicate cache names:',
+                [...new Set(duplicateCacheNames)].map(s => `- ${s.name}`)
+            ].join('\n'));
+        }
+    }
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    async invalidateTags(tags) {
+        // Only hit caches that actually declared these tags
+        const affectedCaches = this.caches.filter(c => !(c instanceof multi_tier_cache_1.MultiTierCache) && (c.tags === 'all' || (0, cache_tag_matchers_1.matchesAnyTag)(c.tags, tags)));
+        await Promise.all(affectedCaches.map(c => c instanceof multi_tier_cache_1.MultiTierCache ? undefined : c.store.invalidateTags(tags)));
+    }
+};
+exports.CacheService = CacheService;
+exports.CacheService = CacheService = __decorate([
+    (0, injectable_decorator_1.Injectable)({ register: 'onUse' }),
+    __param(0, (0, inject_decorator_1.Inject)(zibri_di_tokens_default_1.ZIBRI_DI_TOKENS.LOGGER)),
+    __metadata("design:paramtypes", [Object])
+], CacheService);
+//# sourceMappingURL=cache.service.js.map

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

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

package/dist/cjs/caching/decorators/cache-delete.decorator.d.ts

@@ -0,0 +1,12 @@
+import { DiToken } from '../../di/models/di-token.model';
+import { CacheKeyProvider, CacheWrapDeleteOptions } from '../cache/cache-options.model';
+/**
+ * Marks the method to delete a cached value under the resolved key using the provided cache.
+ * @param cacheToken - The token of the cache to use.
+ * @param keyFn - How to resolve the key that should be deleted from the cache.
+ * @param options - Additional options like tags to invalidate.
+ */
+export declare function CacheDelete<C extends {
+    wrapDelete: (...args: any[]) => any;
+}, K, CacheTag extends string, TReturn, TArgs extends unknown[]>(cacheToken: DiToken<C>, keyFn: CacheKeyProvider<K, TArgs>, options?: CacheWrapDeleteOptions<TArgs, CacheTag>): (target: object, propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<(...args: TArgs) => Promise<TReturn>>) => TypedPropertyDescriptor<(...args: TArgs) => Promise<TReturn>>;
+//# sourceMappingURL=cache-delete.decorator.d.ts.map

package/dist/cjs/caching/decorators/cache-delete.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-delete.decorator.d.ts","sourceRoot":"","sources":["../../../../src/caching/decorators/cache-delete.decorator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAGxF;;;;;GAKG;AACH,wBAAgB,WAAW,CAEvB,CAAC,SAAS;IAAE,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;CAAE,EACjD,CAAC,EACD,QAAQ,SAAS,MAAM,EACvB,OAAO,EACP,KAAK,SAAS,OAAO,EAAE,EAEvB,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,EACtB,KAAK,EAAE,gBAAgB,CAAC,CAAC,EAAE,KAAK,CAAC,EACjC,OAAO,CAAC,EAAE,sBAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC,IAG7C,QAAQ,MAAM,EACd,aAAa,MAAM,GAAG,MAAM,EAC5B,YAAY,uBAAuB,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,KAC1E,uBAAuB,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAkBnE"}

package/dist/cjs/caching/decorators/cache-delete.decorator.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheDelete = CacheDelete;
+const inject_function_1 = require("../../di/inject.function");
+// eslint-disable-next-line jsdoc/require-returns
+/**
+ * Marks the method to delete a cached value under the resolved key using the provided cache.
+ * @param cacheToken - The token of the cache to use.
+ * @param keyFn - How to resolve the key that should be deleted from the cache.
+ * @param options - Additional options like tags to invalidate.
+ */
+function CacheDelete(cacheToken, keyFn, options) {
+    return (target, propertyKey, descriptor) => {
+        // eslint-disable-next-line typescript/no-non-null-assertion
+        const original = descriptor.value;
+        const wrappedFns = new WeakMap();
+        descriptor.value = async function (...args) {
+            if (!wrappedFns.has(this)) {
+                // eslint-disable-next-line typescript/typedef
+                const cache = (0, inject_function_1.inject)(cacheToken);
+                // eslint-disable-next-line typescript/no-unsafe-argument
+                wrappedFns.set(this, cache.wrapDelete(original.bind(this), keyFn, options));
+            }
+            // eslint-disable-next-line typescript/no-non-null-assertion
+            return await wrappedFns.get(this)(...args);
+        };
+        return descriptor;
+    };
+}
+//# sourceMappingURL=cache-delete.decorator.js.map

package/dist/cjs/caching/decorators/cache-delete.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-delete.decorator.js","sourceRoot":"","sources":["../../../../src/caching/decorators/cache-delete.decorator.ts"],"names":[],"mappings":";;AAWA,kCAkCC;AA7CD,8DAAkD;AAIlD,iDAAiD;AACjD;;;;;GAKG;AACH,SAAgB,WAAW,CAQvB,UAAsB,EACtB,KAAiC,EACjC,OAAiD;IAEjD,OAAO,CACH,MAAc,EACd,WAA4B,EAC5B,UAAyE,EACZ,EAAE;QAC/D,4DAA4D;QAC5D,MAAM,QAAQ,GAAyC,UAAU,CAAC,KAAM,CAAC;QACzE,MAAM,UAAU,GAA0D,IAAI,OAAO,EAAE,CAAC;QAExF,UAAU,CAAC,KAAK,GAAG,KAAK,WAAwB,GAAG,IAAW;YAC1D,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,8CAA8C;gBAC9C,MAAM,KAAK,GAAG,IAAA,wBAAM,EAAC,UAAU,CAAC,CAAC;gBACjC,yDAAyD;gBACzD,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;YAChF,CAAC;YACD,4DAA4D;YAC5D,OAAO,MAAM,UAAU,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAChD,CAAC,CAAC;QAEF,OAAO,UAAU,CAAC;IACtB,CAAC,CAAC;AACN,CAAC"}

package/dist/cjs/caching/decorators/cache-invalidate.decorator.d.ts

@@ -0,0 +1,11 @@
+import { DiToken } from '../../di/models/di-token.model';
+import { CacheWrapInvalidateOptions } from '../cache/cache-options.model';
+/**
+ * Marks the method to invalidate some cached values resolved by the provided options using the provided cache.
+ * @param cacheToken - The token of the cache to use.
+ * @param options - Additional options, including tags to invalidate.
+ */
+export declare function CacheInvalidate<C extends {
+    wrapInvalidate: (...args: any[]) => any;
+}, CacheTag extends string, TReturn, TArgs extends unknown[]>(cacheToken: DiToken<C>, options: CacheWrapInvalidateOptions<TArgs, CacheTag>): (target: object, propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<(...args: TArgs) => Promise<TReturn>>) => TypedPropertyDescriptor<(...args: TArgs) => Promise<TReturn>>;
+//# sourceMappingURL=cache-invalidate.decorator.d.ts.map

package/dist/cjs/caching/decorators/cache-invalidate.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-invalidate.decorator.d.ts","sourceRoot":"","sources":["../../../../src/caching/decorators/cache-invalidate.decorator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAG1E;;;;GAIG;AACH,wBAAgB,eAAe,CAE3B,CAAC,SAAS;IAAE,cAAc,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;CAAE,EACrD,QAAQ,SAAS,MAAM,EACvB,OAAO,EACP,KAAK,SAAS,OAAO,EAAE,EAEvB,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,EACtB,OAAO,EAAE,0BAA0B,CAAC,KAAK,EAAE,QAAQ,CAAC,IAGhD,QAAQ,MAAM,EACd,aAAa,MAAM,GAAG,MAAM,EAC5B,YAAY,uBAAuB,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,KAC1E,uBAAuB,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAkBnE"}

package/dist/cjs/caching/decorators/cache-invalidate.decorator.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheInvalidate = CacheInvalidate;
+const inject_function_1 = require("../../di/inject.function");
+// eslint-disable-next-line jsdoc/require-returns
+/**
+ * Marks the method to invalidate some cached values resolved by the provided options using the provided cache.
+ * @param cacheToken - The token of the cache to use.
+ * @param options - Additional options, including tags to invalidate.
+ */
+function CacheInvalidate(cacheToken, options) {
+    return (target, propertyKey, descriptor) => {
+        // eslint-disable-next-line typescript/no-non-null-assertion
+        const original = descriptor.value;
+        const wrappedFns = new WeakMap();
+        descriptor.value = async function (...args) {
+            if (!wrappedFns.has(this)) {
+                // eslint-disable-next-line typescript/typedef
+                const cache = (0, inject_function_1.inject)(cacheToken);
+                // eslint-disable-next-line typescript/no-unsafe-argument
+                wrappedFns.set(this, cache.wrapInvalidate(original.bind(this), options));
+            }
+            // eslint-disable-next-line typescript/no-non-null-assertion
+            return wrappedFns.get(this)(...args);
+        };
+        return descriptor;
+    };
+}
+//# sourceMappingURL=cache-invalidate.decorator.js.map

package/dist/cjs/caching/decorators/cache-invalidate.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-invalidate.decorator.js","sourceRoot":"","sources":["../../../../src/caching/decorators/cache-invalidate.decorator.ts"],"names":[],"mappings":";;AAUA,0CAgCC;AA1CD,8DAAkD;AAIlD,iDAAiD;AACjD;;;;GAIG;AACH,SAAgB,eAAe,CAO3B,UAAsB,EACtB,OAAoD;IAEpD,OAAO,CACH,MAAc,EACd,WAA4B,EAC5B,UAAyE,EACZ,EAAE;QAC/D,4DAA4D;QAC5D,MAAM,QAAQ,GAAyC,UAAU,CAAC,KAAM,CAAC;QACzE,MAAM,UAAU,GAA0D,IAAI,OAAO,EAAE,CAAC;QAExF,UAAU,CAAC,KAAK,GAAG,KAAK,WAAwB,GAAG,IAAW;YAC1D,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,8CAA8C;gBAC9C,MAAM,KAAK,GAAG,IAAA,wBAAM,EAAC,UAAU,CAAC,CAAC;gBACjC,yDAAyD;gBACzD,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;YAC7E,CAAC;YACD,4DAA4D;YAC5D,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAC1C,CAAC,CAAC;QAEF,OAAO,UAAU,CAAC;IACtB,CAAC,CAAC;AACN,CAAC"}

package/dist/cjs/caching/decorators/cache-write.decorator.d.ts

@@ -0,0 +1,18 @@
+import { ExtractCacheWriteResultAvailable } from './decorator-types';
+import { DiToken } from '../../di/models/di-token.model';
+import { CacheKeyProvider, CacheWrapWriteOptionsArgsOnly, CacheWrapWriteOptionsWithResult, ResultCacheKeyProvider } from '../cache/cache-options.model';
+import { CacheInterface } from '../cache/cache.interface';
+import { MultiTierCache, MultiWrapWriteOptions } from '../cache/multi-tier.cache';
+/** Extract the wrapWrite options type for a given cache and TArgs. */
+type ExtractWrapWriteOptions<C, TArgs extends unknown[]> = C extends MultiTierCache<any, infer V, infer Tiers, infer CacheTag> ? MultiWrapWriteOptions<V, TArgs, CacheTag, Tiers> : C extends Pick<CacheInterface<any, infer V, infer CacheTag, infer WR, any>, 'wrapWrite'> ? (WR extends true ? CacheWrapWriteOptionsWithResult<V, TArgs, CacheTag> : CacheWrapWriteOptionsArgsOnly<TArgs, CacheTag>) : never;
+/**
+ * Marks the method to write the result to the cache using the provided cache.
+ * @param cacheToken - The token of the cache to use.
+ * @param keyFn - How to resolve the key under which results should be cached.
+ * @param options - Additional options like ttl or tags.
+ */
+export declare function CacheWrite<C extends {
+    wrapWrite: (...args: any[]) => any;
+}, K, V, TArgs extends unknown[]>(cacheToken: DiToken<C>, keyFn: ExtractCacheWriteResultAvailable<C> extends true ? ResultCacheKeyProvider<K, V, TArgs> : CacheKeyProvider<K, TArgs>, options?: ExtractWrapWriteOptions<C, TArgs>): (target: object, propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<(...args: TArgs) => Promise<V>>) => TypedPropertyDescriptor<(...args: TArgs) => Promise<V>>;
+export {};
+//# sourceMappingURL=cache-write.decorator.d.ts.map

package/dist/cjs/caching/decorators/cache-write.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-write.decorator.d.ts","sourceRoot":"","sources":["../../../../src/caching/decorators/cache-write.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,+BAA+B,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACxJ,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElF,sEAAsE;AACtE,KAAK,uBAAuB,CAAC,CAAC,EAAE,KAAK,SAAS,OAAO,EAAE,IAEjD,CAAC,SAAS,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,EAAE,MAAM,QAAQ,CAAC,GAC/D,qBAAqB,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,GAEhD,CAAC,SAAS,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,WAAW,CAAC,GACpF,CAAC,EAAE,SAAS,IAAI,GACZ,+BAA+B,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,GACnD,6BAA6B,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,GACnD,KAAK,CAAC;AAGpB;;;;;GAKG;AAEH,wBAAgB,UAAU,CAAC,CAAC,SAAS;IAAE,SAAS,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;CAAE,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,SAAS,OAAO,EAAE,EACtG,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,EACtB,KAAK,EAAE,gCAAgC,CAAC,CAAC,CAAC,SAAS,IAAI,GACjD,sBAAsB,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,GACnC,gBAAgB,CAAC,CAAC,EAAE,KAAK,CAAC,EAChC,OAAO,CAAC,EAAE,uBAAuB,CAAC,CAAC,EAAE,KAAK,CAAC,IAGvC,QAAQ,MAAM,EACd,aAAa,MAAM,GAAG,MAAM,EAC5B,YAAY,uBAAuB,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,KACpE,uBAAuB,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAqB7D"}

package/dist/cjs/caching/decorators/cache-write.decorator.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheWrite = CacheWrite;
+const inject_function_1 = require("../../di/inject.function");
+// eslint-disable-next-line jsdoc/require-returns
+/**
+ * Marks the method to write the result to the cache using the provided cache.
+ * @param cacheToken - The token of the cache to use.
+ * @param keyFn - How to resolve the key under which results should be cached.
+ * @param options - Additional options like ttl or tags.
+ */
+// eslint-disable-next-line jsdoc/require-jsdoc, typescript/no-explicit-any
+function CacheWrite(cacheToken, keyFn, options) {
+    return function decorator(target, propertyKey, descriptor) {
+        // eslint-disable-next-line typescript/no-non-null-assertion
+        const original = descriptor.value;
+        const wrappedFns = new WeakMap();
+        descriptor.value = async function (...args) {
+            if (!wrappedFns.has(this)) {
+                // eslint-disable-next-line typescript/typedef
+                const cache = (0, inject_function_1.inject)(cacheToken);
+                wrappedFns.set(this, 
+                // eslint-disable-next-line typescript/no-unsafe-argument
+                cache.wrapWrite(original.bind(this), keyFn, options));
+            }
+            // eslint-disable-next-line typescript/no-non-null-assertion
+            return wrappedFns.get(this)(...args);
+        };
+        return descriptor;
+    };
+}
+//# sourceMappingURL=cache-write.decorator.js.map