zibri 2.3.0 → 2.4.1

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

package/dist/cjs/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/cjs/caching/decorators/cache.decorator.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Marks a class that should be used as a cache.
+ */
+export declare function Cache(): ClassDecorator;
+//# sourceMappingURL=cache.decorator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.decorator.d.ts","sourceRoot":"","sources":["../../../../src/caching/decorators/cache.decorator.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAgB,KAAK,IAAI,cAAc,CAWtC"}

package/dist/cjs/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/cjs/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/cjs/caching/decorators/cached.decorator.d.ts

@@ -0,0 +1,16 @@
+import { DiToken } from '../../di/models/di-token.model';
+import { CacheKeyProvider, CacheWrapOptions } from '../cache/cache-options.model';
+import { CacheInterface } from '../cache/cache.interface';
+import { MultiTierCache, MultiWrapOptions } from '../cache/multi-tier.cache';
+type ExtractWrapOptions<C, TArgs extends unknown[]> = C extends MultiTierCache<any, infer V, infer Tiers, infer CacheTag> ? MultiWrapOptions<V, TArgs, CacheTag, Tiers> : C extends Pick<CacheInterface<any, infer V, infer CacheTag, any, any>, 'wrap'> ? CacheWrapOptions<V, TArgs, CacheTag> : never;
+/**
+ * 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.
+ */
+export declare function Cached<C extends {
+    wrap: (...args: any[]) => any;
+}, K, V, TArgs extends unknown[]>(cacheToken: DiToken<C>, keyFn: CacheKeyProvider<K, TArgs>, options?: ExtractWrapOptions<C, TArgs>): (target: object, propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<(...args: TArgs) => Promise<V>>) => TypedPropertyDescriptor<(...args: TArgs) => Promise<V>>;
+export {};
+//# sourceMappingURL=cached.decorator.d.ts.map

package/dist/cjs/caching/decorators/cached.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cached.decorator.d.ts","sourceRoot":"","sources":["../../../../src/caching/decorators/cached.decorator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAG7E,KAAK,kBAAkB,CAAC,CAAC,EAAE,KAAK,SAAS,OAAO,EAAE,IAE5C,CAAC,SAAS,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,EAAE,MAAM,QAAQ,CAAC,GAC/D,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,GAE3C,CAAC,SAAS,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,GAC1E,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,GACpC,KAAK,CAAC;AAGpB;;;;;GAKG;AAEH,wBAAgB,MAAM,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;CAAE,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,SAAS,OAAO,EAAE,EAC7F,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,EACtB,KAAK,EAAE,gBAAgB,CAAC,CAAC,EAAE,KAAK,CAAC,EACjC,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC,EAAE,KAAK,CAAC,IAGlC,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,CAkB7D"}

package/dist/cjs/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/cjs/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/cjs/caching/decorators/decorator-types.d.ts

@@ -0,0 +1,11 @@
+import { CacheInterface } from '../cache/cache.interface';
+import { MultiTierCache } from '../cache/multi-tier.cache';
+/**
+ * Extracts the key type `K` from a cache-like type.
+ */
+export type ExtractCacheKey<C> = C extends MultiTierCache<infer K, any, any, any> ? K : C extends CacheInterface<infer K, any, any, any, any> ? K : never;
+/** Extract the WriteResultAvailable flag from a cache-like type. */
+export type ExtractCacheWriteResultAvailable<C> = C extends {
+    _writeResultAvailable: infer WR;
+} ? (WR extends boolean ? WR : never) : never;
+//# sourceMappingURL=decorator-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decorator-types.d.ts","sourceRoot":"","sources":["../../../../src/caching/decorators/decorator-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAEvB,CAAC,SAAS,cAAc,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAC5C,CAAC,GAED,CAAC,SAAS,cAAc,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GACjD,CAAC,GACD,KAAK,CAAC;AAEpB,oEAAoE;AAEpE,MAAM,MAAM,gCAAgC,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,qBAAqB,EAAE,MAAM,EAAE,CAAA;CAAE,GACzF,CAAC,EAAE,SAAS,OAAO,GAAG,EAAE,GAAG,KAAK,CAAC,GACjC,KAAK,CAAC"}

package/dist/cjs/caching/decorators/decorator-types.js

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

package/dist/cjs/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/cjs/caching/store/cache-store.interface.d.ts

@@ -0,0 +1,57 @@
+import { CachedValue } from './cached-value.model';
+/**
+ * The different strategies on how to handle cache overflows.
+ */
+export type RemoveOnOverflowStrategy = 'leastRecentlyUsed' | 'mostRecentlyUsed' | 'leastFrequentlyUsed' | 'firstInFirstOut';
+/**
+ * Configuration of a cache store.
+ */
+export type CacheStoreConfig = {
+    /**
+     * The maximum amount of entries that the store can hold.
+     */
+    readonly maxEntries: number;
+    /**
+     * The maximum amount of bytes that this store can hold.
+     * Checks are done usually done using estimations, not exact numbers.
+     */
+    readonly maxBytes: number;
+    /**
+     * How to handle caches that exceed their maxEntries or maxBytes.
+     */
+    readonly removeOnOverflow: RemoveOnOverflowStrategy;
+};
+/**
+ * Interface for an cache store.
+ */
+export interface CacheStoreInterface<K, V> {
+    /**
+     * The configuration for the store.
+     */
+    readonly config: CacheStoreConfig;
+    /**
+     * Gets the cached value stored under the given key.
+     */
+    get: (key: K) => CachedValue<V> | undefined | Promise<CachedValue<V> | undefined>;
+    /**
+     * Stores a new cached value under the given key.
+     */
+    set: (key: K, value: CachedValue<V>) => void | Promise<void>;
+    /**
+     * Deletes the cached value stored under the given key.
+     */
+    delete: (key: K) => void | Promise<void>;
+    /**
+     * Completely clears all values from the cache.
+     */
+    clear: () => void | Promise<void>;
+    /**
+     * Invalidates all cached values that have one of the given tags.
+     */
+    invalidateTags: (tags: string[]) => void | Promise<void>;
+    /**
+     * The number of elements in the store.
+     */
+    size: () => number | Promise<number>;
+}
+//# sourceMappingURL=cache-store.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache-store.interface.d.ts","sourceRoot":"","sources":["../../../../src/caching/store/cache-store.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,mBAAmB,GAAG,kBAAkB,GAAG,qBAAqB,GAAG,iBAAiB,CAAC;AAE5H;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC3B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,wBAAwB,CAAA;CACtD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,EAAE,CAAC;IACrC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC;;OAEG;IACH,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAClF;;OAEG;IACH,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D;;OAEG;IACH,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC;;OAEG;IACH,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD;;OAEG;IACH,IAAI,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACvC"}

package/dist/cjs/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/cjs/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/cjs/caching/store/cached-value.model.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Definition for a cached value.
+ */
+export declare class CachedValue<V> {
+    /**
+     * The timestamp at which the value has been cached.
+     */
+    createdAt: Date;
+    /**
+     * The timestamp at which this cached value expires.
+     */
+    expiresAt?: Date;
+    /**
+     * The actual value that has been cached.
+     */
+    value: V;
+    /**
+     * Optional tags that the value can have and can be invalidated by.
+     */
+    tags: string[];
+}
+//# sourceMappingURL=cached-value.model.d.ts.map

package/dist/cjs/caching/store/cached-value.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cached-value.model.d.ts","sourceRoot":"","sources":["../../../../src/caching/store/cached-value.model.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,WAAW,CAAC,CAAC;IACtB;;OAEG;IAEH,SAAS,EAAG,IAAI,CAAC;IACjB;;OAEG;IAEH,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB;;OAEG;IAEH,KAAK,EAAG,CAAC,CAAC;IACV;;OAEG;IAEH,IAAI,EAAG,MAAM,EAAE,CAAC;CACnB"}

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

package/dist/cjs/caching/store/in-memory.cache-store.d.ts

@@ -0,0 +1,32 @@
+import { CacheStoreConfig, CacheStoreInterface } from './cache-store.interface';
+import { CachedValue } from './cached-value.model';
+/**
+ * A simple in‑memory cache store.
+ *
+ * Supports LRU, MRU, FIFO and LFU eviction when maxEntries or maxBytes
+ * are exceeded.  The implementation uses a generic {@link DoublyLinkedList}
+ * to keep O(1) access, removal and reordering.
+ */
+export declare class InMemoryCacheStore<K, V> implements CacheStoreInterface<K, V> {
+    private readonly entries;
+    /** Order list – used by LRU, MRU, FIFO.  For LFU it’s still maintained but not used for eviction. */
+    private readonly orderList;
+    private currentBytes;
+    private readonly frequencyMap;
+    private minFrequency;
+    readonly config: CacheStoreConfig;
+    constructor(configInput?: Partial<CacheStoreConfig>);
+    get(key: K): CachedValue<V> | undefined;
+    set(key: K, value: CachedValue<V>): void;
+    delete(key: K): void;
+    has(key: K): boolean;
+    clear(): void;
+    size(): number;
+    invalidateTags(tags: string[]): void;
+    private evictOne;
+    private recordAccess;
+    private increaseFrequency;
+    private decreaseFrequency;
+    private estimateBytes;
+}
+//# sourceMappingURL=in-memory.cache-store.d.ts.map

package/dist/cjs/caching/store/in-memory.cache-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.cache-store.d.ts","sourceRoot":"","sources":["../../../../src/caching/store/in-memory.cache-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAoBnD;;;;;;GAMG;AACH,qBAAa,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAE,YAAW,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC;IACtE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAE/D,qGAAqG;IACrG,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+C;IAEzE,OAAO,CAAC,YAAY,CAAa;IAGjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkC;IAC/D,OAAO,CAAC,YAAY,CAAa;IAGjC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;gBAEtB,WAAW,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAUnD,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS;IAWvC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IA4CxC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI;IAqBpB,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAKpB,KAAK,IAAI,IAAI;IASb,IAAI,IAAI,MAAM;IAKd,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IASpC,OAAO,CAAC,QAAQ;IAkChB,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,iBAAiB;IAgCzB,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,aAAa;CAQxB"}