zibri 2.2.1 → 2.4.0

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"}

package/dist/cjs/caching/store/in-memory.cache-store.js

@@ -0,0 +1,227 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryCacheStore = void 0;
+const bytes_1 = require("../../utilities/bytes");
+const doubly_linked_list_1 = require("../../utilities/doubly-linked-list");
+const json_utilities_1 = require("../../utilities/json.utilities");
+const number_utilities_1 = require("../../utilities/number.utilities");
+/**
+ * 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.
+ */
+class InMemoryCacheStore {
+    entries = new Map();
+    /** Order list – used by LRU, MRU, FIFO.  For LFU it’s still maintained but not used for eviction. */
+    orderList = new doubly_linked_list_1.DoublyLinkedList();
+    currentBytes = 0;
+    // LFU helpers
+    frequencyMap = new Map();
+    minFrequency = 0;
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    config;
+    constructor(configInput) {
+        this.config = {
+            maxEntries: 500,
+            maxBytes: bytes_1.Bytes.KB * 750,
+            removeOnOverflow: 'leastRecentlyUsed',
+            ...configInput
+        };
+    }
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    get(key) {
+        const entry = this.entries.get(key);
+        if (!entry) {
+            return undefined;
+        }
+        this.recordAccess(entry);
+        return entry.value;
+    }
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    set(key, value) {
+        const existing = this.entries.get(key);
+        if (existing) {
+            this.currentBytes = number_utilities_1.NumberUtilities.subtract(this.currentBytes, existing.byteSize).toNumber();
+            existing.value = value;
+            existing.byteSize = this.estimateBytes(key, value);
+            this.currentBytes = number_utilities_1.NumberUtilities.add(this.currentBytes, existing.byteSize).toNumber();
+            this.recordAccess(existing);
+            return;
+        }
+        const byteSize = this.estimateBytes(key, value);
+        // Evict until there is enough space
+        while (this.size() >= this.config.maxEntries
+            || number_utilities_1.NumberUtilities.add(this.currentBytes, byteSize).comparedTo(this.config.maxBytes) === 1) {
+            if (this.entries.size <= 0) {
+                // a single entry exceeds the cache, skip caching for it
+                return;
+            }
+            this.evictOne();
+        }
+        const orderNode = this.orderList.addLast(key);
+        const entry = {
+            orderNode,
+            value,
+            byteSize,
+            frequency: 1
+        };
+        this.entries.set(key, entry);
+        this.currentBytes = number_utilities_1.NumberUtilities.add(this.currentBytes, byteSize).toNumber();
+        // LFU initialization
+        if (this.config.removeOnOverflow === 'leastFrequentlyUsed') {
+            this.increaseFrequency(entry);
+        }
+    }
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    delete(key) {
+        const entry = this.entries.get(key);
+        if (!entry) {
+            return;
+        }
+        // Remove from order list
+        this.orderList.remove(entry.orderNode);
+        // Subtract bytes
+        this.currentBytes = number_utilities_1.NumberUtilities.subtract(this.currentBytes, entry.byteSize).toNumber();
+        // LFU cleanup
+        if (this.config.removeOnOverflow === 'leastFrequentlyUsed') {
+            this.decreaseFrequency(entry);
+        }
+        this.entries.delete(key);
+    }
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    has(key) {
+        return this.entries.has(key);
+    }
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    clear() {
+        this.entries.clear();
+        this.orderList.clear();
+        this.frequencyMap.clear();
+        this.currentBytes = 0;
+        this.minFrequency = 0;
+    }
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    size() {
+        return this.entries.size;
+    }
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    invalidateTags(tags) {
+        // Safe iteration – we delete while iterating
+        for (const [key, entry] of this.entries.entries()) {
+            if (entry.value.tags.some(t => tags.includes(t))) {
+                this.delete(key);
+            }
+        }
+    }
+    evictOne() {
+        switch (this.config.removeOnOverflow) {
+            case 'leastRecentlyUsed':
+            case 'firstInFirstOut': {
+                // Both evict the head of the order list
+                if (this.orderList.head) {
+                    this.delete(this.orderList.head.value);
+                }
+                break;
+            }
+            case 'mostRecentlyUsed': {
+                // Evict the tail (most recently used)
+                if (this.orderList.tail) {
+                    this.delete(this.orderList.tail.value);
+                }
+                break;
+            }
+            case 'leastFrequentlyUsed': {
+                // Remove any key from the current minimum‑frequency bucket
+                const minSet = this.frequencyMap.get(this.minFrequency);
+                if (minSet && minSet.size > 0) {
+                    // eslint-disable-next-line typescript/no-non-null-assertion
+                    const keyToEvict = minSet.values().next().value;
+                    this.delete(keyToEvict);
+                    return;
+                }
+                if (this.orderList.head) {
+                    this.delete(this.orderList.head.value);
+                }
+                break;
+            }
+        }
+    }
+    recordAccess(entry) {
+        switch (this.config.removeOnOverflow) {
+            case 'leastRecentlyUsed':
+            case 'mostRecentlyUsed': {
+                // Move to tail (mark as most recent)
+                this.orderList.moveToTail(entry.orderNode);
+                break;
+            }
+            case 'firstInFirstOut': {
+                // Do not change order – keep insertion order intact
+                break;
+            }
+            case 'leastFrequentlyUsed': {
+                // Increase frequency
+                this.increaseFrequency(entry);
+                break;
+            }
+        }
+    }
+    increaseFrequency(entry) {
+        const oldFrequency = entry.frequency;
+        const newFrequency = oldFrequency + 1;
+        entry.frequency = newFrequency;
+        // remove from old frequency set
+        const oldSet = this.frequencyMap.get(oldFrequency);
+        if (oldSet) {
+            oldSet.delete(entry.orderNode.value);
+            if (oldSet.size === 0) {
+                this.frequencyMap.delete(oldFrequency);
+                if (oldFrequency === this.minFrequency) {
+                    // find the next min frequency
+                    this.minFrequency = Math.min(...this.frequencyMap.keys());
+                    if (!Number.isFinite(this.minFrequency)) {
+                        this.minFrequency = 0;
+                    }
+                }
+            }
+        }
+        // add to new frequency set
+        if (!this.frequencyMap.has(newFrequency)) {
+            this.frequencyMap.set(newFrequency, new Set());
+        }
+        // eslint-disable-next-line typescript/no-non-null-assertion
+        this.frequencyMap.get(newFrequency).add(entry.orderNode.value);
+        if (newFrequency < this.minFrequency || this.minFrequency === 0) {
+            this.minFrequency = newFrequency;
+        }
+    }
+    decreaseFrequency(entry) {
+        // Called when a node is removed – just clean up the frequency sets.
+        const frequency = entry.frequency;
+        const set = this.frequencyMap.get(frequency);
+        if (!set) {
+            return;
+        }
+        set.delete(entry.orderNode.value);
+        if (set.size === 0) {
+            this.frequencyMap.delete(frequency);
+            if (frequency === this.minFrequency) {
+                this.minFrequency = Math.min(...this.frequencyMap.keys());
+                if (!Number.isFinite(this.minFrequency)) {
+                    this.minFrequency = 0;
+                }
+            }
+        }
+    }
+    estimateBytes(key, value) {
+        try {
+            return Buffer.byteLength(json_utilities_1.JsonUtilities.stringify({ key, value }), 'utf8');
+        }
+        catch {
+            return 1024;
+        }
+    }
+}
+exports.InMemoryCacheStore = InMemoryCacheStore;
+//# sourceMappingURL=in-memory.cache-store.js.map

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

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

package/dist/cjs/change-sets/change-set-repository.d.ts

@@ -1,6 +1,10 @@
 import { Repository as TORepository } from 'typeorm';
 import { ChangeSetEntity } from './models/change-set-entity.model';
 import { ChangeSetType } from './models/change-set-type.enum';
+import { NewChange } from './models/change.model';
+import { DataSourceInterface } from '../data-source/data-sources/data-source.interface';
+import { BeforeReturnHook } from '../data-source/hooks/before-return';
+import { BeforeSaveHook } from '../data-source/hooks/before-save';
 import { BaseRepositoryOptions } from '../data-source/models/options/base-repository-options.model';
 import { CreateAllOptions } from '../data-source/models/options/create-all-options.model';
 import { CreateOptions } from '../data-source/models/options/create-options.model';
@@ -9,9 +13,8 @@ import { UpdateByIdOptions } from '../data-source/models/options/update-by-id-op
 import { Where } from '../data-source/models/where/where-filter.model';
 import { Repository } from '../data-source/repository';
 import { LoggerInterface } from '../logging/logger.interface';
-import { Newable } from '../types/newable.type';
-import { NewChange } from './models/change.model';
 import { DeepPartial } from '../types/deep-partial.type';
+import { Newable } from '../types/newable.type';
 /**
  * The result for resetting a change set on an entity.
  */
@@ -32,10 +35,10 @@ export declare class ChangeSetRepository<T extends ChangeSetEntity, CreateData e
     /**
      * Any keys that should be excluded from the change set.
      */
-    protected readonly keysToExcludeFromChangeSets: (keyof T)[];
-    private get changeSetRepository();
-    private get authService();
-    constructor(entityClass: Newable<T>, repo: TORepository<T> | Repository<T>, logger: LoggerInterface);
+    protected readonly keysToExcludeFromChangeSets: Set<keyof T>;
+    private readonly changeSetRepository;
+    private readonly authService;
+    constructor(entityClass: Newable<T>, repo: TORepository<T> | Repository<T>, logger: LoggerInterface, dataSource: DataSourceInterface, beforeSave: BeforeSaveHook<T, CreateData, UpdateData>, beforeReturn: BeforeReturnHook<T>);
     create(data: CreateData, options?: CreateOptions): Promise<T>;
     createAll(data: CreateData[], options?: CreateAllOptions): Promise<T[]>;
     updateById(id: T['id'], data: UpdateData, options?: UpdateByIdOptions): Promise<T>;
@@ -87,7 +90,7 @@ export declare class ChangeSetRepository<T extends ChangeSetEntity, CreateData e
      * Rolls back all changes on the given entity that have happened since the given change set.
      * This DOES NOT preserve any changes that happened after the change set.
      * The given change set and any change sets after that will be deleted in the end.
-     * Calls rollbackByDate on the change set date internally.
+     * Calls rollbackToTimestamp on the change set timestamp internally.
      * @param entity - The entity to rollback.
      * @param changeSetId - The id of the changeSet to rollback to.
      * @param createChangeSet - Whether or not a change set should be created.
@@ -101,7 +104,7 @@ export declare class ChangeSetRepository<T extends ChangeSetEntity, CreateData e
      * Rolls back all changes on the entity with the given id that have happened since the given change set.
      * This DOES NOT preserve any changes that happened after the change set.
      * The given change set and any change sets after that will be deleted in the end.
-     * Calls rollbackByDate on the change set date internally.
+     * Calls rollbackToTimestampById on the change set timestamp internally.
      * @param id - The id of the entity to rollback.
      * @param changeSetId - The id of the changeSet to rollback to.
      * @param createChangeSet - Whether or not a change set should be created.
@@ -112,36 +115,36 @@ export declare class ChangeSetRepository<T extends ChangeSetEntity, CreateData e
      */
     rollbackToChangeSetById(id: T['id'], changeSetId: string, createChangeSet?: boolean, preserveCreateChangeSet?: boolean, options?: BaseRepositoryOptions): Promise<T>;
     /**
-     * Rolls back all changes on the given entity that have happened since the given date.
-     * This DOES NOT preserve any changes that happened after the date.
-     * Any change sets after the given date will be deleted in the end.
+     * Rolls back all changes on the given entity that have happened since the given timestamp.
+     * This DOES NOT preserve any changes that happened after the timestamp.
+     * Any change sets after the given timestamp will be deleted in the end.
      * @param entity - The entity to rollback.
-     * @param date - The date to which the rollback should happen.
+     * @param timestampInNs - The timestamp to which the rollback should happen with nanosecond precision.
      * @param createChangeSet - Whether or not a change set should be created.
      * @param preserveCreateChangeSet - Whether or not create change sets should be preserved.
      * In that case the entity gets reset to the state after the create change set. Also, the create change set isn't deleted.
      * @param options - Additional options, eg. Transaction.
      * @returns The updated entity.
      */
-    rollbackToDate(entity: T, date: Date, createChangeSet?: boolean, preserveCreateChangeSet?: boolean, options?: BaseRepositoryOptions): Promise<T>;
+    rollbackToTimestamp(entity: T, timestampInNs: bigint, createChangeSet?: boolean, preserveCreateChangeSet?: boolean, options?: BaseRepositoryOptions): Promise<T>;
     /**
-     * Rolls back all changes on the entity with the given id that have happened since the given date.
-     * This DOES NOT preserve any changes that happened after the date.
-     * Any change sets after the given date will be deleted in the end.
+     * Rolls back all changes on the entity with the given id that have happened since the given timestamp.
+     * This DOES NOT preserve any changes that happened after the timestamp.
+     * Any change sets after the given timestamp will be deleted in the end.
      * @param id - The id of the entity to rollback.
-     * @param date - The date to which the rollback should happen.
+     * @param timestampInNs - The timestamp to which the rollback should happen with nanosecond precision.
      * @param createChangeSet - Whether or not a change set should be created.
      * @param preserveCreateChangeSet - Whether or not create change sets should be preserved.
      * In that case the entity gets reset to the state after the create change set. Also, the create change set isn't deleted.
      * @param options - Additional options, eg. Transaction.
      * @returns The updated entity.
      */
-    rollbackToDateById(id: T['id'], date: Date, createChangeSet?: boolean, preserveCreateChangeSet?: boolean, options?: BaseRepositoryOptions): Promise<T>;
+    rollbackToTimestampById(id: T['id'], timestampInNs: bigint, createChangeSet?: boolean, preserveCreateChangeSet?: boolean, options?: BaseRepositoryOptions): Promise<T>;
     /**
-     * Rolls back all changes on the entities found with the given where filter to the state of the given date.
-     * This DOES NOT preserve any changes that happened after the date.
-     * Any change sets after the given date will be deleted in the end.
-     * @param date - The date to which the rollback should happen.
+     * Rolls back all changes on the entities found with the given where filter to the state of the given timestamp.
+     * This DOES NOT preserve any changes that happened after the timestamp.
+     * Any change sets after the given timestamp will be deleted in the end.
+     * @param timestampInNs - The timestamp to which the rollback should happen with nanosecond precision.
      * @param where - A filter to only rollback some entities.
      * @param createChangeSet - Whether or not a change set should be created.
      * @param preserveCreateChangeSet - Whether or not create change sets should be preserved.
@@ -149,7 +152,7 @@ export declare class ChangeSetRepository<T extends ChangeSetEntity, CreateData e
      * @param options - Additional options, eg. Transaction.
      * @returns The updated entity.
      */
-    rollbackAllToDate(date: Date, where?: Where<T>, createChangeSet?: boolean, preserveCreateChangeSet?: boolean, options?: BaseRepositoryOptions): Promise<number>;
+    rollbackAllToTimestamp(timestampInNs: bigint, where?: Where<T>, createChangeSet?: boolean, preserveCreateChangeSet?: boolean, options?: BaseRepositoryOptions): Promise<number>;
     /**
      * Creates a change set for the related entity id.
      * Also generates the changes from the given data.

package/dist/cjs/change-sets/change-set-repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"change-set-repository.d.ts","sourceRoot":"","sources":["../../../src/change-sets/change-set-repository.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"change-set-repository.d.ts","sourceRoot":"","sources":["../../../src/change-sets/change-set-repository.ts"],"names":[],"mappings":"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"}