@synchronized-console/objectloader2 2.25.7 → 2.31.14

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
+        synchronized_type: 'Base'
+    };
+    if (referencedIds.length > 0) {
+        base.data = referencedIds.map((referencedId) => ({
+            // eslint-disable-next-line camelcase
+            synchronized_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,32 @@
+import { CustomLogger } from '../types/functions.js';
+import { Item, Base } from '../types/types.js';
+import { MemoryCache } from './MemoryCache.js';
+export interface Deferment {
+    defer(params: {
+        id: string;
+    }): [Promise<Base>, boolean];
+    undefer(item: Item, requestItem: (id: string) => void): void;
+    dispose(): void;
+}
+export declare class MemoryOnlyDeferment implements Deferment {
+    private items;
+    constructor(items: Map<string, Base>);
+    defer(params: {
+        id: string;
+    }): [Promise<Base>, boolean];
+    undefer(): void;
+    dispose(): void;
+}
+export declare class DefermentManager implements Deferment {
+    private outstanding;
+    private logger;
+    private disposed;
+    private cache;
+    constructor(logger: CustomLogger, cache?: MemoryCache);
+    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,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAA;IACvD,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAA;IAC5D,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,qBAAa,mBAAoB,YAAW,SAAS;IACnD,OAAO,CAAC,KAAK,CAAmB;gBAEpB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC;IAGpC,KAAK,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAOvD,OAAO,IAAI,IAAI;IAGf,OAAO,IAAI,IAAI;CAGhB;AAED,qBAAa,gBAAiB,YAAW,SAAS;IAChD,OAAO,CAAC,WAAW,CAAuC;IAC1D,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,KAAK,CAAa;gBAEd,MAAM,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,WAAW;IAarD,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;CAOhB"}

package/dist/esm/deferment/defermentManager.js

@@ -0,0 +1,80 @@
+import { DeferredBase } from './deferredBase.js';
+import { MemoryCache } from './MemoryCache.js';
+export class MemoryOnlyDeferment {
+    items;
+    constructor(items) {
+        this.items = items;
+    }
+    defer(params) {
+        const item = this.items.get(params.id);
+        if (item) {
+            return [Promise.resolve(item), true];
+        }
+        return [Promise.reject(new Error('Not found in cache: ' + params.id)), false];
+    }
+    undefer() {
+        //no-op
+    }
+    dispose() {
+        //no-op
+    }
+}
+export class DefermentManager {
+    outstanding = new Map();
+    logger;
+    disposed = false;
+    cache;
+    constructor(logger, cache) {
+        this.logger = logger;
+        this.cache =
+            cache ||
+                new MemoryCache({
+                    maxSizeInMb: 500, // 500 MB
+                    ttlms: 5_000 // 5 seconds
+                }, logger);
+    }
+    defer(params) {
+        if (this.disposed)
+            throw new Error('DefermentManager is disposed');
+        const item = this.cache.get(params.id);
+        if (item) {
+            return [Promise.resolve(item.base), true];
+        }
+        const deferredBase = this.outstanding.get(params.id);
+        if (deferredBase) {
+            return [deferredBase.getPromise(), true];
+        }
+        const notYetFound = new DeferredBase(params.id);
+        this.outstanding.set(params.id, notYetFound);
+        return [notYetFound.getPromise(), false];
+    }
+    undefer(item, requestItem) {
+        if (this.disposed)
+            throw new Error('DefermentManager is disposed');
+        const base = item.base;
+        if (!base) {
+            this.logger('undefer called with no base', item);
+            return;
+        }
+        this.cache.add(item, (id) => {
+            if (!this.outstanding.has(id)) {
+                requestItem(id);
+            }
+        });
+        //order matters here with found before undefer
+        const deferredBase = this.outstanding.get(item.baseId);
+        if (deferredBase) {
+            deferredBase.found(base);
+            this.outstanding.delete(item.baseId);
+        }
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.logger('cleared deferments, left', this.outstanding.size);
+        this.outstanding.clear();
+        this.cache.dispose();
+    }
+}
+//# sourceMappingURL=defermentManager.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,191 @@
+import { vi, describe, it, expect } from 'vitest';
+import { DefermentManager } from './defermentManager.js';
+describe('DefermentManager', () => {
+    it('should be created', () => {
+        const mockLogger = vi.fn();
+        const mockCache = {
+            get: vi.fn(),
+            add: vi.fn(),
+            dispose: vi.fn()
+        };
+        const defermentManager = new DefermentManager(mockLogger, mockCache);
+        expect(defermentManager).toBeDefined();
+    });
+    describe('defer', () => {
+        it('should return a resolved promise if item is in cache', async () => {
+            const mockLogger = vi.fn();
+            const get = vi.fn();
+            const add = vi.fn();
+            const mockCache = {
+                get,
+                add
+            };
+            const defermentManager = new DefermentManager(mockLogger, mockCache);
+            const item = {
+                // eslint-disable-next-line camelcase
+                base: { id: 'testId', synchronized_type: 'Base' },
+                baseId: 'testId'
+            };
+            get.mockReturnValue(item);
+            const [promise, wasInCache] = defermentManager.defer({ id: 'testId' });
+            const result = await promise;
+            expect(wasInCache).toBe(true);
+            expect(result).toEqual(item.base);
+            expect(get).toHaveBeenCalledWith('testId');
+        });
+        it('should return the same promise if item is already outstanding', () => {
+            const mockLogger = vi.fn();
+            const get = vi.fn();
+            const add = vi.fn();
+            const mockCache = {
+                get,
+                add
+            };
+            const defermentManager = new DefermentManager(mockLogger, mockCache);
+            const [promise1, wasInCache1] = defermentManager.defer({ id: 'testId' });
+            const [promise2, wasInCache2] = defermentManager.defer({ id: 'testId' });
+            expect(wasInCache1).toBe(false);
+            expect(wasInCache2).toBe(true);
+            expect(promise1).toBe(promise2);
+        });
+        it('should create a new deferred base if not in cache and not outstanding', () => {
+            const mockLogger = vi.fn();
+            const get = vi.fn();
+            const add = vi.fn();
+            const mockCache = {
+                get,
+                add
+            };
+            const defermentManager = new DefermentManager(mockLogger, mockCache);
+            const [promise, wasInCache] = defermentManager.defer({ id: 'testId' });
+            expect(wasInCache).toBe(false);
+            expect(promise).toBeInstanceOf(Promise);
+        });
+        it('should throw if disposed', () => {
+            const mockLogger = vi.fn();
+            const get = vi.fn();
+            const add = vi.fn();
+            const mockCache = {
+                get,
+                add,
+                dispose: vi.fn()
+            };
+            const defermentManager = new DefermentManager(mockLogger, mockCache);
+            defermentManager.dispose();
+            expect(() => defermentManager.defer({ id: 'testId' })).toThrow('DefermentManager is disposed');
+        });
+    });
+    describe('undefer', () => {
+        it('should resolve the promise when an outstanding item is found', async () => {
+            const mockLogger = vi.fn();
+            const get = vi.fn();
+            const add = vi.fn();
+            const mockCache = {
+                get,
+                add
+            };
+            const defermentManager = new DefermentManager(mockLogger, mockCache);
+            const requestItem = vi.fn();
+            const [promise] = defermentManager.defer({ id: 'testId' });
+            const item = {
+                // eslint-disable-next-line camelcase
+                base: { id: 'testId', synchronized_type: 'Base' },
+                baseId: 'testId'
+            };
+            defermentManager.undefer(item, requestItem);
+            const result = await promise;
+            expect(result).toEqual(item.base);
+        });
+        it('should log an error if item has no base', () => {
+            const mockLogger = vi.fn();
+            const get = vi.fn();
+            const add = vi.fn();
+            const mockCache = {
+                get,
+                add
+            };
+            const defermentManager = new DefermentManager(mockLogger, mockCache);
+            const requestItem = vi.fn();
+            const item = { baseId: 'testId' };
+            defermentManager.undefer(item, requestItem);
+            expect(mockLogger).toHaveBeenCalledWith('undefer called with no base', item);
+        });
+        it('should add to cache and request item if not outstanding', () => {
+            const mockLogger = vi.fn();
+            const get = vi.fn();
+            const add = vi.fn();
+            const mockCache = {
+                get,
+                add
+            };
+            const defermentManager = new DefermentManager(mockLogger, mockCache);
+            const requestItem = vi.fn();
+            const item = {
+                // eslint-disable-next-line camelcase
+                base: { id: 'testId', synchronized_type: 'Base' },
+                baseId: 'testId'
+            };
+            add.mockImplementation((_item, getDependencies) => {
+                if (getDependencies)
+                    getDependencies('testId');
+            });
+            defermentManager.undefer(item, requestItem);
+            expect(add).toHaveBeenCalledWith(item, expect.any(Function));
+            expect(requestItem).toHaveBeenCalledWith('testId');
+        });
+        it('should throw if disposed', () => {
+            const mockLogger = vi.fn();
+            const get = vi.fn();
+            const add = vi.fn();
+            const mockCache = {
+                get,
+                add,
+                dispose: vi.fn()
+            };
+            const defermentManager = new DefermentManager(mockLogger, mockCache);
+            const requestItem = vi.fn();
+            defermentManager.dispose();
+            const item = {
+                // eslint-disable-next-line camelcase
+                base: { id: 'testId', synchronized_type: 'Base' },
+                baseId: 'testId'
+            };
+            expect(() => defermentManager.undefer(item, requestItem)).toThrow('DefermentManager is disposed');
+        });
+    });
+    describe('dispose', () => {
+        it('should clear all outstanding deferments', () => {
+            const mockLogger = vi.fn();
+            const get = vi.fn();
+            const add = vi.fn();
+            const mockCache = {
+                get,
+                add,
+                dispose: vi.fn()
+            };
+            const defermentManager = new DefermentManager(mockLogger, mockCache);
+            void defermentManager.defer({ id: 'testId' });
+            defermentManager.dispose();
+            // @ts-expect-error - accessing private property for testing
+            expect(defermentManager.outstanding.size).toBe(0);
+        });
+        it('should not do anything if already disposed', () => {
+            const mockLogger = vi.fn();
+            const get = vi.fn();
+            const add = vi.fn();
+            const mockCache = {
+                get,
+                add,
+                dispose: vi.fn()
+            };
+            const defermentManager = new DefermentManager(mockLogger, mockCache);
+            defermentManager.dispose();
+            // @ts-expect-error - accessing private property for testing
+            const outstanding = defermentManager.outstanding;
+            const clearSpy = vi.spyOn(outstanding, 'clear');
+            defermentManager.dispose();
+            expect(clearSpy).not.toHaveBeenCalled();
+        });
+    });
+});
+//# sourceMappingURL=defermentManager.test.js.map