zibri 2.3.0 → 2.4.0

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

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

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

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WriteInvalidateReadThroughArgsOnlyCache = 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 arguments) read‑through cache.
+ *
+ * After the source write succeeds, the cache entry identified by the
+ * argument‑derived key is **deleted**, and optional tag invalidations
+ * are fired.
+ */
+class WriteInvalidateReadThroughArgsOnlyCache extends read_through_cache_1.ReadThroughCache {
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    _writeResultAvailable = false;
+    // 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 specific key, in parallel
+                await Promise.all([
+                    this.safeInvalidateTags(options?.invalidatesTags, args),
+                    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 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.WriteInvalidateReadThroughArgsOnlyCache = WriteInvalidateReadThroughArgsOnlyCache;
+//# sourceMappingURL=write-invalidate-read-through-args-only.cache.js.map

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

package/dist/esm/caching/decorators/cache-write.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-write.decorator.js","sourceRoot":"","sources":["../../../../src/caching/decorators/cache-write.decorator.ts"],"names":[],"mappings":";;AA2BA,gCAgCC;AA1DD,8DAAkD;AAkBlD,iDAAiD;AACjD;;;;;GAKG;AACH,2EAA2E;AAC3E,SAAgB,UAAU,CACtB,UAAsB,EACtB,KAEgC,EAChC,OAA2C;IAE3C,OAAO,SAAS,SAAS,CACrB,MAAc,EACd,WAA4B,EAC5B,UAAmE;QAEnE,4DAA4D;QAC5D,MAAM,QAAQ,GAAmC,UAAU,CAAC,KAAM,CAAC;QACnE,MAAM,UAAU,GAAoD,IAAI,OAAO,EAAE,CAAC;QAElF,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,UAAU,CAAC,GAAG,CACV,IAAI;gBACJ,yDAAyD;gBACzD,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CACvD,CAAC;YACN,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/esm/caching/decorators/cache.decorator.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Cache = Cache;
+const global_registry_1 = require("../../global/global-registry");
+const metadata_utilities_1 = require("../../utilities/metadata.utilities");
+/**
+ * Marks a class that should be used as a cache.
+ */
+function Cache() {
+    return target => {
+        // eslint-disable-next-line unicorn/error-message
+        const stack = new Error().stack ?? '';
+        metadata_utilities_1.MetadataUtilities.setFilePath(target, stack);
+        global_registry_1.GlobalRegistry.injectables.push({
+            token: target,
+            useClass: target
+        });
+        global_registry_1.GlobalRegistry.cacheClasses.push(target);
+    };
+}
+//# sourceMappingURL=cache.decorator.js.map

package/dist/esm/caching/decorators/cache.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.decorator.js","sourceRoot":"","sources":["../../../../src/caching/decorators/cache.decorator.ts"],"names":[],"mappings":";;AAQA,sBAWC;AAnBD,kEAA8D;AAE9D,2EAAuE;AAGvE;;GAEG;AACH,SAAgB,KAAK;IACjB,OAAO,MAAM,CAAC,EAAE;QACZ,iDAAiD;QACjD,MAAM,KAAK,GAAW,IAAI,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9C,sCAAiB,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC7C,gCAAc,CAAC,WAAW,CAAC,IAAI,CAAC;YAC5B,KAAK,EAAE,MAAqC;YAC5C,QAAQ,EAAE,MAAqC;SAClD,CAAC,CAAC;QACH,gCAAc,CAAC,YAAY,CAAC,IAAI,CAAC,MAAsC,CAAC,CAAC;IAC7E,CAAC,CAAC;AACN,CAAC"}

package/dist/esm/caching/decorators/cached.decorator.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Cached = Cached;
+const inject_function_1 = require("../../di/inject.function");
+// eslint-disable-next-line jsdoc/require-returns
+/**
+ * Marks the method for caching via the given cache token.
+ * @param cacheToken - The token of the cache to use.
+ * @param keyFn - How to resolve the key under which results are cached.
+ * @param options - Additional options like ttl or tags.
+ */
+// eslint-disable-next-line jsdoc/require-jsdoc, typescript/no-explicit-any
+function Cached(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.wrap(original.bind(this), keyFn, options));
+            }
+            // eslint-disable-next-line typescript/no-non-null-assertion
+            return await wrappedFns.get(this)(...args);
+        };
+        return descriptor;
+    };
+}
+//# sourceMappingURL=cached.decorator.js.map

package/dist/esm/caching/decorators/cached.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cached.decorator.js","sourceRoot":"","sources":["../../../../src/caching/decorators/cached.decorator.ts"],"names":[],"mappings":";;AAwBA,wBA2BC;AAnDD,8DAAkD;AAgBlD,iDAAiD;AACjD;;;;;GAKG;AACH,2EAA2E;AAC3E,SAAgB,MAAM,CAClB,UAAsB,EACtB,KAAiC,EACjC,OAAsC;IAEtC,OAAO,CACH,MAAc,EACd,WAA4B,EAC5B,UAAmE,EACZ,EAAE;QACzD,4DAA4D;QAC5D,MAAM,QAAQ,GAAuC,UAAU,CAAC,KAAM,CAAC;QACvE,MAAM,UAAU,GAAoD,IAAI,OAAO,EAAE,CAAC;QAElF,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,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;YAC1E,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/esm/caching/decorators/decorator-types.js

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

package/dist/esm/caching/decorators/decorator-types.js.map

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

package/dist/esm/caching/store/cache-store.interface.js

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

package/dist/esm/caching/store/cache-store.interface.js.map

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

package/dist/esm/caching/store/cached-value.model.js

@@ -0,0 +1,52 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CachedValue = void 0;
+const property_decorator_1 = require("../../entity/decorators/property.decorator");
+/**
+ * Definition for a cached value.
+ */
+class CachedValue {
+    /**
+     * The timestamp at which the value has been cached.
+     */
+    createdAt;
+    /**
+     * The timestamp at which this cached value expires.
+     */
+    expiresAt;
+    /**
+     * The actual value that has been cached.
+     */
+    value;
+    /**
+     * Optional tags that the value can have and can be invalidated by.
+     */
+    tags;
+}
+exports.CachedValue = CachedValue;
+__decorate([
+    property_decorator_1.Property.date({ default: () => new Date() }),
+    __metadata("design:type", Date)
+], CachedValue.prototype, "createdAt", void 0);
+__decorate([
+    property_decorator_1.Property.date({ required: false }),
+    __metadata("design:type", Date)
+], CachedValue.prototype, "expiresAt", void 0);
+__decorate([
+    property_decorator_1.Property.unknown({ required: false }),
+    __metadata("design:type", Object)
+], CachedValue.prototype, "value", void 0);
+__decorate([
+    property_decorator_1.Property.array({ items: { type: 'string' } }),
+    __metadata("design:type", Array)
+], CachedValue.prototype, "tags", void 0);
+//# sourceMappingURL=cached-value.model.js.map

package/dist/esm/caching/store/cached-value.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cached-value.model.js","sourceRoot":"","sources":["../../../../src/caching/store/cached-value.model.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,mFAAsE;AAEtE;;GAEG;AACH,MAAa,WAAW;IACpB;;OAEG;IAEH,SAAS,CAAQ;IACjB;;OAEG;IAEH,SAAS,CAAQ;IACjB;;OAEG;IAEH,KAAK,CAAK;IACV;;OAEG;IAEH,IAAI,CAAY;CACnB;AArBD,kCAqBC;AAhBG;IADC,6BAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BACjC,IAAI;8CAAC;AAKjB;IADC,6BAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;8BACvB,IAAI;8CAAC;AAKjB;IADC,6BAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;;0CAC5B;AAKV;IADC,6BAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;;yCAC9B"}