@synchronized-console/objectloader2 2.25.7 → 2.31.14

package/dist/commonjs/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/commonjs/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/commonjs/deferment/MemoryCache.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryCache = exports.MemoryCacheItem = void 0;
+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;
+    }
+}
+exports.MemoryCacheItem = MemoryCacheItem;
+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();
+    }
+}
+exports.MemoryCache = MemoryCache;
+//# sourceMappingURL=MemoryCache.js.map

package/dist/commonjs/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/commonjs/deferment/MemoryCache.test.d.ts

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

package/dist/commonjs/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/commonjs/deferment/MemoryCache.test.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const MemoryCache_js_1 = require("./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
+    };
+};
+(0, vitest_1.describe)('MemoryCacheItem', () => {
+    (0, vitest_1.it)('should correctly determine if it is expired', () => {
+        const item = createItem('1', 100);
+        const now = Date.now();
+        const cacheItem = new MemoryCache_js_1.MemoryCacheItem(item, now + 1000);
+        (0, vitest_1.expect)(cacheItem.isExpired(now + 500)).toBe(false);
+        (0, vitest_1.expect)(cacheItem.isExpired(now + 1500)).toBe(true);
+    });
+    (0, vitest_1.it)('should update its access time', () => {
+        const item = createItem('1', 100);
+        const now = Date.now();
+        const cacheItem = new MemoryCache_js_1.MemoryCacheItem(item, now + 1000);
+        cacheItem.setAccess(now + 500, 1000);
+        (0, vitest_1.expect)(cacheItem.isExpired(now + 1000)).toBe(false);
+        (0, vitest_1.expect)(cacheItem.isExpired(now + 1600)).toBe(true);
+    });
+    (0, vitest_1.it)('should return the correct item', () => {
+        const item = createItem('1', 100);
+        const cacheItem = new MemoryCache_js_1.MemoryCacheItem(item, Date.now() + 1000);
+        (0, vitest_1.expect)(cacheItem.getItem()).toEqual(item);
+    });
+    (0, vitest_1.it)('should be done if expired', () => {
+        const item = createItem('1', 100);
+        const now = Date.now();
+        const cacheItem = new MemoryCache_js_1.MemoryCacheItem(item, now + 1000);
+        (0, vitest_1.expect)(cacheItem.done(now + 1500)).toBe(true);
+        (0, vitest_1.expect)(cacheItem.done(now + 500)).toBe(false);
+    });
+});
+(0, vitest_1.describe)('MemoryCache', () => {
+    (0, vitest_1.beforeEach)(() => {
+        vitest_1.vi.useFakeTimers();
+    });
+    (0, vitest_1.afterEach)(() => {
+        vitest_1.vi.useRealTimers();
+    });
+    (0, vitest_1.it)('should add and get an item', () => {
+        const cache = new MemoryCache_js_1.MemoryCache(defaultOptions, logger);
+        const item = createItem('1', 100);
+        const requestItem = vitest_1.vi.fn();
+        cache.add(item, requestItem);
+        const retrieved = cache.get('1');
+        (0, vitest_1.expect)(retrieved).toEqual(item);
+        (0, vitest_1.expect)(requestItem).not.toHaveBeenCalled();
+    });
+    (0, vitest_1.it)('should update expiry on get', () => {
+        const cache = new MemoryCache_js_1.MemoryCache({ ...defaultOptions, ttlms: 100 }, logger);
+        const item = createItem('1', 100);
+        cache.add(item, vitest_1.vi.fn());
+        vitest_1.vi.advanceTimersByTime(50);
+        const retrieved = cache.get('1');
+        (0, vitest_1.expect)(retrieved).toBeDefined();
+        vitest_1.vi.advanceTimersByTime(80);
+        const retrievedAgain = cache.get('1');
+        (0, vitest_1.expect)(retrievedAgain).toBeDefined();
+    });
+    (0, vitest_1.it)('should return undefined for non-existent item', () => {
+        const cache = new MemoryCache_js_1.MemoryCache(defaultOptions, logger);
+        (0, vitest_1.expect)(cache.get('non-existent')).toBeUndefined();
+    });
+    (0, vitest_1.it)('should scan for references and request missing ones', () => {
+        const cache = new MemoryCache_js_1.MemoryCache(defaultOptions, logger);
+        const requestItem = vitest_1.vi.fn();
+        const item = createItem('1', 100, ['2', '3']);
+        cache.add(createItem('3', 50), vitest_1.vi.fn()); // pre-cache one of the references
+        cache.scanForReferences(item.base, requestItem);
+        (0, vitest_1.expect)(requestItem).toHaveBeenCalledTimes(1);
+        (0, vitest_1.expect)(requestItem).toHaveBeenCalledWith('2');
+        (0, vitest_1.expect)(requestItem).not.toHaveBeenCalledWith('3');
+    });
+    (0, vitest_1.it)('should clean up expired items when size exceeds max', () => {
+        const options = { maxSizeInMb: 0, ttlms: 100 }; // 100 bytes
+        const cache = new MemoryCache_js_1.MemoryCache(options, logger);
+        const requestItem = vitest_1.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);
+        (0, vitest_1.expect)(cache.get('1')).toBeUndefined();
+        (0, vitest_1.expect)(cache.get('2')).toBeDefined();
+    });
+    (0, vitest_1.it)('should not clean up expired items if they have references', () => {
+        const options = { maxSizeInMb: 0.0001, ttlms: 100 }; // 100 bytes
+        const cache = new MemoryCache_js_1.MemoryCache(options, logger);
+        const requestItem = vitest_1.vi.fn();
+        const item1 = createItem('1', 60);
+        const item2 = createItem('2', 60, ['1']);
+        cache.add(item1, requestItem);
+        vitest_1.vi.advanceTimersByTime(110); // item1 expires
+        cache.add(item2, requestItem); // item2 adds a reference to item1
+        vitest_1.vi.advanceTimersByTime(100);
+        (0, vitest_1.expect)(cache.get('1')).toBeDefined();
+        (0, vitest_1.expect)(cache.get('2')).toBeDefined();
+    });
+    (0, vitest_1.it)('compareMaybeBasesByReferences should sort correctly', () => {
+        const cache = new MemoryCache_js_1.MemoryCache(defaultOptions, logger);
+        const requestItem = vitest_1.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);
+        (0, vitest_1.expect)(cache.compareMaybeBasesByReferences('1', '2')).toBe(-1);
+        (0, vitest_1.expect)(cache.compareMaybeBasesByReferences('2', '1')).toBe(1);
+        (0, vitest_1.expect)(cache.compareMaybeBasesByReferences('1', '1')).toBe(0);
+        (0, vitest_1.expect)(cache.compareMaybeBasesByReferences('1', '5')).toBe(1);
+        (0, vitest_1.expect)(cache.compareMaybeBasesByReferences('5', '1')).toBe(-1);
+        (0, vitest_1.expect)(cache.compareMaybeBasesByReferences('5', '6')).toBe(0);
+    });
+    (0, vitest_1.it)('should throw when used after dispose', () => {
+        const cache = new MemoryCache_js_1.MemoryCache(defaultOptions, logger);
+        cache.dispose();
+        const item = createItem('1', 100);
+        (0, vitest_1.expect)(() => cache.add(item, vitest_1.vi.fn())).toThrow('MemoryCache is disposed');
+        (0, vitest_1.expect)(() => cache.get('1')).toThrow('MemoryCache is disposed');
+    });
+});
+//# sourceMappingURL=MemoryCache.test.js.map

package/dist/commonjs/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/commonjs/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/commonjs/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/commonjs/deferment/defermentManager.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefermentManager = exports.MemoryOnlyDeferment = void 0;
+const deferredBase_js_1 = require("./deferredBase.js");
+const MemoryCache_js_1 = require("./MemoryCache.js");
+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
+    }
+}
+exports.MemoryOnlyDeferment = MemoryOnlyDeferment;
+class DefermentManager {
+    outstanding = new Map();
+    logger;
+    disposed = false;
+    cache;
+    constructor(logger, cache) {
+        this.logger = logger;
+        this.cache =
+            cache ||
+                new MemoryCache_js_1.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_js_1.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();
+    }
+}
+exports.DefermentManager = DefermentManager;
+//# sourceMappingURL=defermentManager.js.map

package/dist/commonjs/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/commonjs/deferment/defermentManager.test.d.ts

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

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