@speckle/objectloader2 2.25.7 → 2.25.8

package/dist/esm/{operations/downloaders → core/stages}/serverDownloader.js

@@ -1,6 +1,7 @@
-import BatchedPool from '../../helpers/batchedPool.js';
+import BatchedPool from '../../queues/batchedPool.js';
 import { ObjectLoaderRuntimeError } from '../../types/errors.js';
-import { isBase, take } from '../../types/types.js';
+import { indexOf, isBase, take } from '../../types/functions.js';
+const MAX_SAFARI_DECODE_BYTES = 2 * 1024 * 1024 * 1024 - 1024 * 1024; // 2GB minus a margin
 export default class ServerDownloader {
     #requestUrlRootObj;
     #requestUrlChildren;
@@ -8,8 +9,12 @@ export default class ServerDownloader {
     #options;
     #fetch;
     #results;
+    #total;
     #downloadQueue;
-    #decoder = new TextDecoder();
+    #decoder = new TextDecoder('utf-8', { fatal: true });
+    #decodedBytesCount = 0;
+    #rawString = 'Objects.Other.RawEncoding';
+    #rawEncoding;
     constructor(options) {
         this.#options = options;
         this.#fetch =
@@ -26,6 +31,8 @@ export default class ServerDownloader {
         }
         this.#requestUrlChildren = `${this.#options.serverUrl}/api/getobjects/${this.#options.streamId}`;
         this.#requestUrlRootObj = `${this.#options.serverUrl}/objects/${this.#options.streamId}/${this.#options.objectId}/single`;
+        const encoder = new TextEncoder();
+        this.#rawEncoding = encoder.encode(this.#rawString);
     }
     #getDownloadCountAndSizes(total) {
         if (total <= 50) {
@@ -36,6 +43,7 @@ export default class ServerDownloader {
     initializePool(params) {
         const { results, total } = params;
         this.#results = results;
+        this.#total = total;
         this.#downloadQueue = new BatchedPool({
             concurrencyAndSizes: this.#getDownloadCountAndSizes(total),
             maxWaitTime: params.maxDownloadBatchWait,
@@ -55,24 +63,26 @@ export default class ServerDownloader {
     add(id) {
         this.#getPool().add(id);
     }
+    /*
+    This is the most frequently reported and confirmed reason for this error in Safari. There's a known bug in WebKit (Safari's rendering engine) where TextDecoder can fail or throw a RangeError after decoding around 2GB of data. Chrome and other browsers handle much larger amounts of data without this specific limitation.
+  
+  Why it happens: It seems to be an internal memory or indexing limitation within Safari's TextDecoder implementation. After a certain threshold of data has been processed by a TextDecoder instance, it starts throwing this error.
+  
+  Chrome's behavior: Chrome generally handles larger data sizes without this specific RangeError. It might become slow or run out of general memory, but not typically with this specific error.
+    */
+    decodeChunk(chunkBuffer) {
+        if (this.#decodedBytesCount + chunkBuffer.byteLength > MAX_SAFARI_DECODE_BYTES) {
+            // Safari is approaching its limit, create a new decoder
+            this.#decoder = new TextDecoder('utf-8', { fatal: true });
+            this.#decodedBytesCount = 0; // Reset counter for the new decoder
+        }
+        const decodedText = this.#decoder.decode(chunkBuffer);
+        this.#decodedBytesCount += chunkBuffer.byteLength;
+        return decodedText;
+    }
     async disposeAsync() {
         await this.#downloadQueue?.disposeAsync();
     }
-    #processJson(baseId, unparsedBase) {
-        let base;
-        try {
-            base = JSON.parse(unparsedBase);
-        }
-        catch (e) {
-            throw new Error(`Error parsing object ${baseId}: ${e.message}`);
-        }
-        if (isBase(base)) {
-            return { baseId, base };
-        }
-        else {
-            throw new ObjectLoaderRuntimeError(`${baseId} is not a base`);
-        }
-    }
     async downloadBatch(params) {
         const { batch, url, headers } = params;
         const keys = new Set(batch);
@@ -92,7 +102,7 @@ export default class ServerDownloader {
             const { done, value } = await reader.read();
             if (done)
                 break;
-            leftover = await this.processArray(leftover, value, keys, async () => {
+            leftover = await this.#processArray(leftover, value, keys, async () => {
                 count++;
                 if (count % 1000 === 0) {
                     await new Promise((resolve) => setTimeout(resolve, 100)); //allow other stuff to happen
@@ -102,40 +112,74 @@ export default class ServerDownloader {
         if (keys.size > 0) {
             throw new Error('Items requested were not downloaded: ' + take(keys.values(), 10).join(','));
         }
+        count += keys.size; // count the leftovers
+        if (count >= this.#total) {
+            await this.#results?.disposeAsync(); // mark the queue as done
+        }
     }
-    async processArray(leftover, value, keys, callback) {
+    async #processArray(leftover, value, keys, callback) {
         //this concat will allocate a new array
-        const combined = this.concatUint8Arrays(leftover, value);
+        const combined = this.#concatUint8Arrays(leftover, value);
         let start = 0;
         //subarray doesn't allocate
         for (let i = 0; i < combined.length; i++) {
             if (combined[i] === 0x0a) {
                 const line = combined.subarray(start, i); // line without \n
                 //strings are allocated here
-                const item = this.processLine(line);
-                this.#results?.add(item);
+                const item = this.#processLine(line);
                 start = i + 1;
                 await callback();
                 keys.delete(item.baseId);
+                this.#results?.add(item);
             }
         }
         return combined.subarray(start); // carry over remainder
     }
-    processLine(line) {
+    #processLine(line) {
         for (let i = 0; i < line.length; i++) {
             if (line[i] === 0x09) {
                 //this is a tab
-                const baseId = this.#decoder.decode(line.subarray(0, i));
-                const json = line.subarray(i + 1);
-                const base = this.#decoder.decode(json);
+                const baseId = this.decodeChunk(line.subarray(0, i));
+                const jsonBytes = line.subarray(i + 1);
+                if (!this.#isValidBytes(jsonBytes)) {
+                    return { baseId, base: undefined };
+                }
+                const base = this.decodeChunk(jsonBytes);
                 const item = this.#processJson(baseId, base);
-                item.size = json.length;
+                item.size = jsonBytes.length;
                 return item;
             }
         }
-        throw new ObjectLoaderRuntimeError('Invalid line format: ' + this.#decoder.decode(line));
+        throw new ObjectLoaderRuntimeError('Invalid line format in response: ' + this.decodeChunk(line));
     }
-    concatUint8Arrays(a, b) {
+    #processJson(baseId, unparsedBase) {
+        let base;
+        try {
+            base = JSON.parse(unparsedBase);
+        }
+        catch (e) {
+            throw new Error(`Error parsing object ${baseId}: ${e.message}`);
+        }
+        if (isBase(base)) {
+            return { baseId, base };
+        }
+        else {
+            throw new ObjectLoaderRuntimeError(`${baseId} is not a base`);
+        }
+    }
+    #isValidString(json) {
+        if (!json.includes(this.#rawString)) {
+            return true;
+        }
+        return false;
+    }
+    #isValidBytes(json) {
+        if (indexOf(json, this.#rawEncoding) === -1) {
+            return true;
+        }
+        return false;
+    }
+    #concatUint8Arrays(a, b) {
         const c = new Uint8Array(a.length + b.length);
         c.set(a, 0);
         c.set(b, a.length);
@@ -147,7 +191,13 @@ export default class ServerDownloader {
         });
         this.#validateResponse(response);
         const responseText = await response.text();
+        if (!this.#isValidString(responseText)) {
+            throw new ObjectLoaderRuntimeError('Invalid base object');
+        }
         const item = this.#processJson(this.#options.objectId, responseText);
+        if (!item.base) {
+            throw new ObjectLoaderRuntimeError('Invalid base object');
+        }
         item.size = 0;
         return item;
     }

package/dist/esm/core/stages/serverDownloader.js.map

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

package/dist/esm/core/traverser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverser.d.ts","sourceRoot":"","sources":["../../../src/core/traverser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAa,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,cAAc,CAAA;AACvD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,EAAE;IAC3B,KAAK,EAAE,aAAa,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd,KAAK,IAAI,CAAA;AAEV,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CACxB;AAED,MAAM,CAAC,OAAO,OAAO,SAAS;;gBAOhB,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAKvD,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAehD,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5E,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAuDvE"}

package/dist/esm/{operations → core}/traverser.js

@@ -1,4 +1,4 @@
-import { isBase, isReference, isScalar } from '../types/types.js';
+import { isScalar, isBase, isReference } from '../types/functions.js';
 export default class Traverser {
     #loader;
     #options;

package/dist/esm/core/traverser.js.map

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

package/dist/esm/deferment/MemoryCache.d.ts

@@ -0,0 +1,35 @@
+import { CustomLogger } from '../types/functions.js';
+import { Item } from '../types/types.js';
+export interface MemoryCacheOptions {
+    maxSizeInMb: number;
+    ttlms: number;
+}
+export declare class MemoryCacheItem {
+    private item;
+    private expiresAt;
+    constructor(item: Item, expiresAt: number);
+    isExpired(now: number): boolean;
+    setAccess(now: number, ttl: number): void;
+    getItem(): Item;
+    done(now: number): boolean;
+}
+export declare class MemoryCache {
+    private isGathered;
+    private references;
+    private cache;
+    private options;
+    private logger;
+    private disposed;
+    private currentSize;
+    private timer?;
+    constructor(options: MemoryCacheOptions, logger: CustomLogger);
+    add(item: Item, requestItem: (id: string) => void, testNow?: number): void;
+    get(id: string): Item | undefined;
+    scanForReferences(data: unknown, requestItem: (id: string) => void): void;
+    private resetGlobalTimer;
+    private now;
+    cleanCache(testNow?: number): void;
+    compareMaybeBasesByReferences(id1: string, id2: string): number;
+    dispose(): void;
+}
+//# sourceMappingURL=MemoryCache.d.ts.map

package/dist/esm/deferment/MemoryCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryCache.d.ts","sourceRoot":"","sources":["../../../src/deferment/MemoryCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAExC,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,IAAI,CAAM;IAClB,OAAO,CAAC,SAAS,CAAQ;gBAEb,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM;IAKzC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAG/B,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzC,OAAO,IAAI,IAAI;IAIf,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAM3B;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,KAAK,CAA0C;IAEvD,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,WAAW,CAAI;IACvB,OAAO,CAAC,KAAK,CAAC,CAA+B;gBAEjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,YAAY;IAM7D,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAc1E,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAUjC,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAuCzE,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,GAAG;IAIX,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAwClC,6BAA6B,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAS/D,OAAO,IAAI,IAAI;CAWhB"}

package/dist/esm/deferment/MemoryCache.js

@@ -0,0 +1,157 @@
+export class MemoryCacheItem {
+    item;
+    expiresAt; // Timestamp in ms
+    constructor(item, expiresAt) {
+        this.item = item;
+        this.expiresAt = expiresAt;
+    }
+    isExpired(now) {
+        return now > this.expiresAt;
+    }
+    setAccess(now, ttl) {
+        this.expiresAt = now + ttl;
+    }
+    getItem() {
+        return this.item;
+    }
+    done(now) {
+        if (this.isExpired(now)) {
+            return true;
+        }
+        return false;
+    }
+}
+export class MemoryCache {
+    isGathered = new Map();
+    references = new Map();
+    cache = new Map();
+    options;
+    logger;
+    disposed = false;
+    currentSize = 0;
+    timer;
+    constructor(options, logger) {
+        this.options = options;
+        this.logger = logger;
+        this.resetGlobalTimer();
+    }
+    add(item, requestItem, testNow) {
+        if (this.disposed)
+            throw new Error('MemoryCache is disposed');
+        this.currentSize += item.size || 0;
+        this.cache.set(item.baseId, new MemoryCacheItem(item, (testNow || this.now()) + this.options.ttlms));
+        if (!this.isGathered.has(item.baseId)) {
+            this.isGathered.set(item.baseId, true);
+            this.scanForReferences(item.base, requestItem);
+        }
+    }
+    get(id) {
+        if (this.disposed)
+            throw new Error('MemoryCache is disposed');
+        const item = this.cache.get(id);
+        if (item) {
+            item.setAccess(this.now(), this.options.ttlms);
+            return item.getItem();
+        }
+        return undefined;
+    }
+    scanForReferences(data, requestItem) {
+        const scan = (item) => {
+            // Stop if the item is null or not an object (i.e., primitive)
+            if (item === null || typeof item !== 'object') {
+                return;
+            }
+            // If it's an array, scan each element
+            if (Array.isArray(item)) {
+                for (const element of item) {
+                    scan(element);
+                }
+                return;
+            }
+            // If it's an object, scan its properties
+            for (const key in item) {
+                if (Object.prototype.hasOwnProperty.call(item, key)) {
+                    // We found the target property!
+                    if (key === 'referencedId') {
+                        const value = item.referencedId;
+                        // Ensure the value is a string before adding it
+                        if (typeof value === 'string') {
+                            this.references.set(value, (this.references.get(value) || 0) + 1);
+                            if (!this.cache.has(value)) {
+                                requestItem(value);
+                            }
+                        }
+                    }
+                    // Continue scanning deeper into the object's properties
+                    scan(item[key]);
+                }
+            }
+        };
+        scan(data);
+    }
+    resetGlobalTimer() {
+        const run = () => {
+            this.cleanCache();
+            this.timer = setTimeout(run, this.options.ttlms);
+        };
+        this.timer = setTimeout(run, this.options.ttlms);
+    }
+    now() {
+        return Date.now();
+    }
+    cleanCache(testNow) {
+        const maxSizeBytes = this.options.maxSizeInMb * 1024 * 1024;
+        if (this.currentSize < maxSizeBytes) {
+            this.logger(`cache size (${this.currentSize} < ${maxSizeBytes}) is ok, no need to clean`);
+            return;
+        }
+        const now = testNow || this.now();
+        let cleaned = 0;
+        const start = performance.now();
+        for (const deferredBase of Array.from(this.cache.values())
+            .filter((x) => x.isExpired(now))
+            .sort((a, b) => this.compareMaybeBasesByReferences(a.getItem().baseId, b.getItem().baseId))) {
+            if (deferredBase.done(now)) {
+                const id = deferredBase.getItem().baseId;
+                const referenceCount = this.references.get(id) || 0;
+                if (referenceCount > 0) {
+                    // Skip eviction for items with reference counts greater than 0,
+                    // as they are still in use and should not be removed from the cache.
+                    continue;
+                }
+                this.currentSize -= deferredBase.getItem().size || 0;
+                this.cache.delete(id);
+                cleaned++;
+                if (this.currentSize < maxSizeBytes) {
+                    break;
+                }
+            }
+        }
+        this.logger(`cleaned cache: cleaned ${cleaned}, cached ${this.cache.size}, time ${performance.now() - start}`);
+        return;
+    }
+    compareMaybeBasesByReferences(id1, id2) {
+        const a = this.references.get(id1);
+        const b = this.references.get(id2);
+        if (a === undefined && b === undefined)
+            return 0;
+        if (a === undefined)
+            return -1;
+        if (b === undefined)
+            return 1;
+        return a - b;
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = undefined;
+        }
+        this.cache.clear();
+        this.isGathered.clear();
+        this.references.clear();
+    }
+}
+//# sourceMappingURL=MemoryCache.js.map

package/dist/esm/deferment/MemoryCache.js.map

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

package/dist/esm/deferment/MemoryCache.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=MemoryCache.test.d.ts.map

package/dist/esm/deferment/MemoryCache.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryCache.test.d.ts","sourceRoot":"","sources":["../../../src/deferment/MemoryCache.test.ts"],"names":[],"mappings":""}

package/dist/esm/deferment/MemoryCache.test.js

@@ -0,0 +1,151 @@
+import { vi, describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { MemoryCache, MemoryCacheItem } from './MemoryCache.js';
+const logger = () => {
+    // console.log(message, ...optionalParams)
+};
+const defaultOptions = {
+    maxSizeInMb: 10,
+    ttlms: 1000
+};
+const createItem = (id, size, referencedIds = []) => {
+    const base = {
+        id,
+        // eslint-disable-next-line camelcase
+        speckle_type: 'Base'
+    };
+    if (referencedIds.length > 0) {
+        base.data = referencedIds.map((referencedId) => ({
+            // eslint-disable-next-line camelcase
+            speckle_type: 'reference',
+            referencedId
+        }));
+    }
+    return {
+        baseId: id,
+        base,
+        size
+    };
+};
+describe('MemoryCacheItem', () => {
+    it('should correctly determine if it is expired', () => {
+        const item = createItem('1', 100);
+        const now = Date.now();
+        const cacheItem = new MemoryCacheItem(item, now + 1000);
+        expect(cacheItem.isExpired(now + 500)).toBe(false);
+        expect(cacheItem.isExpired(now + 1500)).toBe(true);
+    });
+    it('should update its access time', () => {
+        const item = createItem('1', 100);
+        const now = Date.now();
+        const cacheItem = new MemoryCacheItem(item, now + 1000);
+        cacheItem.setAccess(now + 500, 1000);
+        expect(cacheItem.isExpired(now + 1000)).toBe(false);
+        expect(cacheItem.isExpired(now + 1600)).toBe(true);
+    });
+    it('should return the correct item', () => {
+        const item = createItem('1', 100);
+        const cacheItem = new MemoryCacheItem(item, Date.now() + 1000);
+        expect(cacheItem.getItem()).toEqual(item);
+    });
+    it('should be done if expired', () => {
+        const item = createItem('1', 100);
+        const now = Date.now();
+        const cacheItem = new MemoryCacheItem(item, now + 1000);
+        expect(cacheItem.done(now + 1500)).toBe(true);
+        expect(cacheItem.done(now + 500)).toBe(false);
+    });
+});
+describe('MemoryCache', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('should add and get an item', () => {
+        const cache = new MemoryCache(defaultOptions, logger);
+        const item = createItem('1', 100);
+        const requestItem = vi.fn();
+        cache.add(item, requestItem);
+        const retrieved = cache.get('1');
+        expect(retrieved).toEqual(item);
+        expect(requestItem).not.toHaveBeenCalled();
+    });
+    it('should update expiry on get', () => {
+        const cache = new MemoryCache({ ...defaultOptions, ttlms: 100 }, logger);
+        const item = createItem('1', 100);
+        cache.add(item, vi.fn());
+        vi.advanceTimersByTime(50);
+        const retrieved = cache.get('1');
+        expect(retrieved).toBeDefined();
+        vi.advanceTimersByTime(80);
+        const retrievedAgain = cache.get('1');
+        expect(retrievedAgain).toBeDefined();
+    });
+    it('should return undefined for non-existent item', () => {
+        const cache = new MemoryCache(defaultOptions, logger);
+        expect(cache.get('non-existent')).toBeUndefined();
+    });
+    it('should scan for references and request missing ones', () => {
+        const cache = new MemoryCache(defaultOptions, logger);
+        const requestItem = vi.fn();
+        const item = createItem('1', 100, ['2', '3']);
+        cache.add(createItem('3', 50), vi.fn()); // pre-cache one of the references
+        cache.scanForReferences(item.base, requestItem);
+        expect(requestItem).toHaveBeenCalledTimes(1);
+        expect(requestItem).toHaveBeenCalledWith('2');
+        expect(requestItem).not.toHaveBeenCalledWith('3');
+    });
+    it('should clean up expired items when size exceeds max', () => {
+        const options = { maxSizeInMb: 0, ttlms: 100 }; // 100 bytes
+        const cache = new MemoryCache(options, logger);
+        const requestItem = vi.fn();
+        const item1 = createItem('1', 60);
+        const item2 = createItem('2', 60);
+        const now = 1;
+        cache.add(item1, requestItem, now - 200);
+        cache.cleanCache(now);
+        cache.add(item2, requestItem, now + 100);
+        expect(cache.get('1')).toBeUndefined();
+        expect(cache.get('2')).toBeDefined();
+    });
+    it('should not clean up expired items if they have references', () => {
+        const options = { maxSizeInMb: 0.0001, ttlms: 100 }; // 100 bytes
+        const cache = new MemoryCache(options, logger);
+        const requestItem = vi.fn();
+        const item1 = createItem('1', 60);
+        const item2 = createItem('2', 60, ['1']);
+        cache.add(item1, requestItem);
+        vi.advanceTimersByTime(110); // item1 expires
+        cache.add(item2, requestItem); // item2 adds a reference to item1
+        vi.advanceTimersByTime(100);
+        expect(cache.get('1')).toBeDefined();
+        expect(cache.get('2')).toBeDefined();
+    });
+    it('compareMaybeBasesByReferences should sort correctly', () => {
+        const cache = new MemoryCache(defaultOptions, logger);
+        const requestItem = vi.fn();
+        const item1 = createItem('1', 10);
+        const item2 = createItem('2', 10);
+        const item3 = createItem('3', 10, ['1', '2']);
+        const item4 = createItem('4', 10, ['2']);
+        cache.add(item1, requestItem);
+        cache.add(item2, requestItem);
+        cache.add(item3, requestItem);
+        cache.add(item4, requestItem);
+        expect(cache.compareMaybeBasesByReferences('1', '2')).toBe(-1);
+        expect(cache.compareMaybeBasesByReferences('2', '1')).toBe(1);
+        expect(cache.compareMaybeBasesByReferences('1', '1')).toBe(0);
+        expect(cache.compareMaybeBasesByReferences('1', '5')).toBe(1);
+        expect(cache.compareMaybeBasesByReferences('5', '1')).toBe(-1);
+        expect(cache.compareMaybeBasesByReferences('5', '6')).toBe(0);
+    });
+    it('should throw when used after dispose', () => {
+        const cache = new MemoryCache(defaultOptions, logger);
+        cache.dispose();
+        const item = createItem('1', 100);
+        expect(() => cache.add(item, vi.fn())).toThrow('MemoryCache is disposed');
+        expect(() => cache.get('1')).toThrow('MemoryCache is disposed');
+    });
+});
+//# sourceMappingURL=MemoryCache.test.js.map

package/dist/esm/deferment/MemoryCache.test.js.map

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

package/dist/esm/deferment/defermentManager.d.ts

@@ -0,0 +1,16 @@
+import { CustomLogger } from '../types/functions.js';
+import { Item, Base } from '../types/types.js';
+import { MemoryCache } from './MemoryCache.js';
+export declare class DefermentManager {
+    private outstanding;
+    private logger;
+    private disposed;
+    private cache;
+    constructor(cache: MemoryCache, logger: CustomLogger);
+    defer(params: {
+        id: string;
+    }): [Promise<Base>, boolean];
+    undefer(item: Item, requestItem: (id: string) => void): void;
+    dispose(): void;
+}
+//# sourceMappingURL=defermentManager.d.ts.map

package/dist/esm/deferment/defermentManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defermentManager.d.ts","sourceRoot":"","sources":["../../../src/deferment/defermentManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,WAAW,CAAuC;IAC1D,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,KAAK,CAAa;gBAEd,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY;IAKpD,KAAK,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAevD,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAqB5D,OAAO,IAAI,IAAI;CAMhB"}