@zajno/common 2.3.17 → 2.4.0

package/esm/structures/path/utils.js

@@ -0,0 +1,56 @@
+export function indexTrim(str, ch) {
+    if (!str || str === ch || !ch) {
+        return '';
+    }
+    let start = 0, end = str.length;
+    while (start < end && str[start] === ch)
+        ++start;
+    while (end > start && str[end - 1] === ch)
+        --end;
+    return (start > 0 || end < str.length)
+        ? str.substring(start, end)
+        : str;
+}
+export var CombineOptions;
+(function (CombineOptions) {
+    function merge(...options) {
+        return Object.assign({}, ...options);
+    }
+    CombineOptions.merge = merge;
+})(CombineOptions || (CombineOptions = {}));
+export function combineUrls(...parts) {
+    const options = typeof parts[0] === 'string'
+        ? null
+        : parts[0];
+    const separator = options?.separator ?? '/';
+    const trimSymbol = options?.trimSymbol ?? '/';
+    const noTrim = options?.noTrim || false;
+    const _parts = [];
+    for (const p of parts) {
+        if (typeof p !== 'string') {
+            continue;
+        }
+        let part = p;
+        if (!noTrim) {
+            part = indexTrim(p, trimSymbol);
+        }
+        if (part) {
+            _parts.push(part);
+        }
+    }
+    let result = _parts.join(separator);
+    if (options?.addTrail) {
+        const char = typeof options.addTrail === 'string'
+            ? options.addTrail
+            : separator;
+        result += char;
+    }
+    if (options?.addStart) {
+        const char = typeof options.addStart === 'string'
+            ? options.addStart
+            : separator;
+        result = char + result;
+    }
+    return result;
+}
+//# sourceMappingURL=utils.js.map

package/esm/structures/path/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/structures/path/utils.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,SAAS,CAAC,GAA8B,EAAE,EAAU;IAChE,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACd,CAAC;IAED,IAAI,KAAK,GAAG,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC;IAEhC,OAAO,KAAK,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE;QACnC,EAAE,KAAK,CAAC;IAEZ,OAAO,GAAG,GAAG,KAAK,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE;QACrC,EAAE,GAAG,CAAC;IAEV,OAAO,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC;QAClC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC;QAC3B,CAAC,CAAC,GAAG,CAAC;AACd,CAAC;AAWD,MAAM,KAAW,cAAc,CAI9B;AAJD,WAAiB,cAAc;IAC3B,SAAgB,KAAK,CAAC,GAAG,OAAmC;QACxD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC;IACzC,CAAC;IAFe,oBAAK,QAEpB,CAAA;AACL,CAAC,EAJgB,cAAc,KAAd,cAAc,QAI9B;AAKD,MAAM,UAAU,WAAW,CAAC,GAAG,KAA0C;IACrE,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ;QACxC,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,KAAK,CAAC,CAAC,CAA6B,CAAC;IAE3C,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,GAAG,CAAC;IAC5C,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,GAAG,CAAC;IAE9C,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,KAAK,CAAC;IACxC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACpB,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YACxB,SAAS;QACb,CAAC;QAED,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,IAAI,GAAG,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QACpC,CAAC;QAED,IAAI,IAAI,EAAE,CAAC;YACP,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACL,CAAC;IAED,IAAI,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEpC,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ;YAC7C,CAAC,CAAC,OAAO,CAAC,QAAQ;YAClB,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,IAAI,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ;YAC7C,CAAC,CAAC,OAAO,CAAC,QAAQ;YAClB,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;IAC3B,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/esm/structures/pool.js

@@ -0,0 +1,45 @@
+export class Pool {
+    factory;
+    _container = [];
+    constructor(factory) {
+        this.factory = factory;
+    }
+    get() {
+        if (this._container.length > 0) {
+            return this._container.pop();
+        }
+        else {
+            return this.factory();
+        }
+    }
+    release(e) {
+        if (Array.isArray(e)) {
+            this._container.push(...e);
+        }
+        else if (e) {
+            this._container.push(e);
+        }
+    }
+}
+export class PoolDisposable extends Pool {
+    initializer;
+    constructor(factory, initializer = null) {
+        super(factory);
+        this.initializer = initializer;
+    }
+    get() {
+        const res = super.get();
+        this.initializer?.(res);
+        return res;
+    }
+    release(e) {
+        if (Array.isArray(e)) {
+            e.forEach(ee => ee.dispose());
+        }
+        else if (e) {
+            e.dispose();
+        }
+        return super.release(e);
+    }
+}
+//# sourceMappingURL=pool.js.map

package/esm/structures/pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../../../src/structures/pool.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,IAAI;IAIQ;IAFJ,UAAU,GAAQ,EAAE,CAAC;IAEtC,YAAqB,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAI,CAAC;IAEnC,GAAG;QACN,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,EAAG,CAAC;QAClC,CAAC;aAAM,CAAC;YACJ,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;IACL,CAAC;IAEM,OAAO,CAAC,CAAU;QACrB,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/B,CAAC;aAAM,IAAI,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;IACL,CAAC;CACJ;AAID,MAAM,OAAO,cAAsC,SAAQ,IAAO;IAEvB;IAAvC,YAAY,OAAgB,EAAW,cAAqC,IAAI;QAC5E,KAAK,CAAC,OAAO,CAAC,CAAC;QADoB,gBAAW,GAAX,WAAW,CAA8B;IAEhF,CAAC;IAEM,GAAG;QACN,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC;QACxB,OAAO,GAAG,CAAC;IACf,CAAC;IAEM,OAAO,CAAC,CAAU;QACrB,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACnB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAClC,CAAC;aAAM,IAAI,CAAC,EAAE,CAAC;YACX,CAAC,CAAC,OAAO,EAAE,CAAC;QAChB,CAAC;QACD,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;CACJ"}

package/esm/structures/promiseCache.js

@@ -0,0 +1,266 @@
+import { ThrottleProcessor } from '../functions/throttle';
+import { createLogger } from '../logger';
+export var DeferredGetter;
+(function (DeferredGetter) {
+    const _resolvedPromise = Promise.resolve(null);
+    DeferredGetter.Empty = {
+        get current() { return null; },
+        get promise() { return _resolvedPromise; },
+        get busy() { return false; },
+    };
+})(DeferredGetter || (DeferredGetter = {}));
+const BATCHING_DELAY = 200;
+/** Caches items by key which are resolve by a promise.
+ *
+ * Supports:
+ *  - custom key adapter and parser for non-string keys.
+ *  - batching of fetches.
+ *  - auto-invalidation of cached items.
+*/
+export class PromiseCache {
+    fetcher;
+    keyAdapter;
+    keyParser;
+    _itemsCache = {};
+    _itemsStatus = {};
+    _fetchCache = {};
+    _timestamps = new Map();
+    _batch = null;
+    _invalidationTimeMs = null;
+    _keepInstanceDuringInvalidation = false;
+    _logger = null;
+    _version = 0;
+    _busyCount = 0;
+    constructor(fetcher, keyAdapter, keyParser) {
+        this.fetcher = fetcher;
+        this.keyAdapter = keyAdapter;
+        this.keyParser = keyParser;
+        //
+    }
+    get busyCount() { return this._busyCount; }
+    _pk(k) {
+        if (k == null) {
+            throw new Error('PromiseCache: null keys are not supported');
+        }
+        if (typeof k === 'string') {
+            return k;
+        }
+        if (!this.keyAdapter) {
+            throw new Error('Provide key adapter for non-string keys');
+        }
+        return this.keyAdapter(k);
+    }
+    useLogger(nameOrLogger) {
+        if (nameOrLogger != null && typeof nameOrLogger !== 'string') {
+            this._logger = nameOrLogger;
+        }
+        else {
+            this._logger = createLogger(`[PromiseCache:${nameOrLogger || '?'}]`);
+        }
+        return this;
+    }
+    /**
+     * Provide a fetcher function that takes multiple ids and returns multiple results at once. Will be called with a slight delay to allow multiple ids to be collected.
+     *
+     * Warning: resolved array should have the same order as the input array.
+     *
+     * When provided, effectively replaces the main fetcher; but in case of fail, fallbacks to the main fetcher.
+    */
+    useBatching(fetcher, delay = BATCHING_DELAY) {
+        this._batch = fetcher ? new ThrottleProcessor(fetcher, delay) : null;
+        return this;
+    }
+    /**
+     * Enables auto-invalidation of cached items.
+     *
+     * @param ms Time in milliseconds after which the item will be considered invalid. If null, auto-invalidation is disabled.
+    */
+    useInvalidationTime(ms, keepInstance = false) {
+        this._invalidationTimeMs = ms;
+        this._keepInstanceDuringInvalidation = keepInstance;
+        return this;
+    }
+    getDeferred(key) {
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const self = this;
+        return {
+            get current() { return self.getCurrent(key); },
+            get promise() { return self.get(key); },
+            get busy() { return self.getIsBusy(key); },
+        };
+    }
+    getIsBusy(id) {
+        const key = this._pk(id);
+        const res = this._itemsStatus[key];
+        if (res) {
+            return res;
+        }
+        const isInvalid = this.getIsInvalidated(key);
+        return isInvalid ? undefined : res;
+    }
+    _getCurrent(id) {
+        const key = this._pk(id);
+        const isInvalid = this.getIsInvalidated(key);
+        // make sure current item is hooked here from the cache (required by observers)
+        const item = this._itemsCache[key];
+        if (isInvalid) {
+            this._logger?.log(key, 'item is invalidated');
+        }
+        return {
+            item: (isInvalid && !this._keepInstanceDuringInvalidation) ? undefined : item,
+            key,
+            isInvalid,
+        };
+    }
+    getCurrent(id, initiateFetch = true) {
+        const { item, key } = this._getCurrent(id);
+        if (initiateFetch) {
+            // spin fetch
+            this.get(id);
+        }
+        this._logger?.log(key, 'getCurrent: returns', item);
+        return item;
+    }
+    get(id) {
+        const { item, key, isInvalid } = this._getCurrent(id);
+        // return cached item if it's not invalidated
+        if (item !== undefined && !isInvalid) {
+            this._logger?.log(key, 'get: item resolved to', item, isInvalid ? '(invalidated)' : '');
+            return Promise.resolve(item);
+        }
+        let promise = this._fetchCache[key];
+        if (promise != null) {
+            this._logger?.log(key, 'get: item resolved to <promise>');
+            return promise;
+        }
+        this.setStatus(key, true);
+        promise = this._doFetchAsync(id, key);
+        this.setPromise(key, promise);
+        return promise;
+    }
+    _doFetchAsync = async (id, key) => {
+        let isInSameVersion = true;
+        try {
+            this.onBeforeFetch(key);
+            const v = this._version;
+            let res = await this.tryFetchInBatch(id);
+            if (v !== this._version) {
+                isInSameVersion = false;
+                // resolve with actual result but don't store it
+                return res;
+            }
+            if (this._fetchCache[key] != null) {
+                this._logger?.log(key, 'item\'s <promise> resolved to', res);
+                res = this.prepareResult(res);
+                this.storeResult(key, res);
+            }
+            return res;
+        }
+        finally {
+            if (isInSameVersion) {
+                this.onFetchComplete(key);
+            }
+            else {
+                this._logger?.log(key, 'skipping item\'s resolve due to version change ("clear()" has been called)');
+            }
+        }
+    };
+    invalidate(id) {
+        const key = this._pk(id);
+        this._set(key, undefined, undefined, undefined);
+    }
+    updateValueDirectly(id, value) {
+        const key = this._pk(id);
+        this._set(key, value, undefined, undefined);
+    }
+    hasKey(id) {
+        const key = this._pk(id);
+        return this._itemsCache[key] !== undefined || this._itemsStatus[key] !== undefined;
+    }
+    keys() {
+        return Object.keys(this._itemsCache);
+    }
+    keysParsed() {
+        if (!this.keyParser) {
+            return null;
+        }
+        return this.keys().map(this.keyParser);
+    }
+    clear() {
+        ++this._version;
+        this._busyCount = 0;
+        this._batch?.clear();
+        this._itemsCache = {};
+        this._itemsStatus = {};
+        this._fetchCache = {};
+    }
+    _set(key, item, promise, busy) {
+        _setX(key, this._fetchCache, promise);
+        _setX(key, this._itemsStatus, busy);
+        _setX(key, this._itemsCache, item);
+    }
+    getIsInvalidated(key) {
+        if (!this._invalidationTimeMs) {
+            return false;
+        }
+        const ts = this._timestamps.get(key);
+        return ts != null && Date.now() - ts > this._invalidationTimeMs;
+    }
+    /** @override */
+    setStatus(key, status) {
+        this._logger?.log(key, 'status update:', status);
+        this._itemsStatus[key] = status;
+    }
+    /** @override */
+    setPromise(key, promise) {
+        this._fetchCache[key] = promise;
+    }
+    /** @override */
+    storeResult(key, res) {
+        this._itemsCache[key] = res;
+        this._timestamps.set(key, Date.now());
+    }
+    /** @override */
+    onBeforeFetch(_key) {
+        ++this._busyCount;
+    }
+    /** @override */
+    prepareResult(res) {
+        return res || null;
+    }
+    /** @override */
+    onFetchComplete(key) {
+        --this._busyCount;
+        delete this._fetchCache[key];
+        this._itemsStatus[key] = false;
+    }
+    /** @pure */
+    async tryFetchInBatch(id) {
+        const fetchWrap = () => this.fetcher(id).catch(err => {
+            this._logger?.warn('fetcher failed', id, err);
+            return null;
+        });
+        if (!this._batch) {
+            return fetchWrap();
+        }
+        const res = await this._batch.push(id)
+            .catch(err => {
+            this._logger?.warn('batch fetch failed', id, err);
+            return null;
+        });
+        if (!res || !res.result || res.result[res.index] === undefined) {
+            // If we got to batch call, should we fallback to the direct one?
+            return fetchWrap();
+        }
+        return res.result[res.index];
+    }
+}
+function _setX(key, obj, val) {
+    if (val === undefined) {
+        delete obj[key];
+    }
+    else {
+        obj[key] = val;
+    }
+}
+//# sourceMappingURL=promiseCache.js.map

package/esm/structures/promiseCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promiseCache.js","sourceRoot":"","sources":["../../../src/structures/promiseCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAW,MAAM,WAAW,CAAC;AAQlD,MAAM,KAAW,cAAc,CAQ9B;AARD,WAAiB,cAAc;IAC3B,MAAM,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAO,IAAI,CAAC,CAAC;IAExC,oBAAK,GAAG;QACjB,IAAI,OAAO,KAAW,OAAO,IAAI,CAAC,CAAC,CAAC;QACpC,IAAI,OAAO,KAAoB,OAAO,gBAAgB,CAAC,CAAC,CAAC;QACzD,IAAI,IAAI,KAAK,OAAO,KAAK,CAAC,CAAC,CAAC;KACA,CAAC;AACrC,CAAC,EARgB,cAAc,KAAd,cAAc,QAQ9B;AAED,MAAM,cAAc,GAAG,GAAG,CAAC;AAE3B;;;;;;EAME;AACF,MAAM,OAAO,YAAY;IAiBA;IACA;IACA;IAjBX,WAAW,GAAyC,EAAE,CAAC;IACvD,YAAY,GAA4B,EAAE,CAAC;IAE7C,WAAW,GAAsC,EAAE,CAAC;IACpD,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAExC,MAAM,GAAqC,IAAI,CAAC;IAChD,mBAAmB,GAAkB,IAAI,CAAC;IAC1C,+BAA+B,GAAG,KAAK,CAAC;IAExC,OAAO,GAAmB,IAAI,CAAC;IAC/B,QAAQ,GAAG,CAAC,CAAC;IACX,UAAU,GAAG,CAAC,CAAC;IAEzB,YACqB,OAA8B,EAC9B,UAAuD,EACvD,SAAuD;QAFvD,YAAO,GAAP,OAAO,CAAuB;QAC9B,eAAU,GAAV,UAAU,CAA6C;QACvD,cAAS,GAAT,SAAS,CAA8C;QAExE,EAAE;IACN,CAAC;IAED,IAAW,SAAS,KAAK,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAE1C,GAAG,CAAC,CAAI;QACZ,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YACxB,OAAO,CAAC,CAAC;QACb,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED,SAAS,CAAC,YAA+B;QACrC,IAAI,YAAY,IAAI,IAAI,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YAC3D,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC;QAChC,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,iBAAiB,YAAY,IAAI,GAAG,GAAG,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;;MAME;IACF,WAAW,CAAC,OAAmC,EAAE,KAAK,GAAG,cAAc;QACnE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACrE,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;MAIE;IACF,mBAAmB,CAAC,EAAiB,EAAE,YAAY,GAAG,KAAK;QACvD,IAAI,CAAC,mBAAmB,GAAG,EAAE,CAAC;QAC9B,IAAI,CAAC,+BAA+B,GAAG,YAAY,CAAC;QACpD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,WAAW,CAAC,GAAM;QACd,4DAA4D;QAC5D,MAAM,IAAI,GAAG,IAAI,CAAC;QAClB,OAAO;YACH,IAAI,OAAO,KAAK,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC9C,IAAI,OAAO,KAAK,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACvC,IAAI,IAAI,KAAK,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SAC7C,CAAC;IACN,CAAC;IAED,SAAS,CAAC,EAAK;QACX,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,GAAG,EAAE,CAAC;YACN,OAAO,GAAG,CAAC;QACf,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAC7C,OAAO,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;IACvC,CAAC;IAES,WAAW,CAAC,EAAK;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzB,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAC7C,+EAA+E;QAC/E,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,SAAS,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;QAClD,CAAC;QACD,OAAO;YACH,IAAI,EAAE,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI;YAC7E,GAAG;YACH,SAAS;SACZ,CAAC;IACN,CAAC;IAED,UAAU,CAAC,EAAK,EAAE,aAAa,GAAG,IAAI;QAClC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC3C,IAAI,aAAa,EAAE,CAAC;YAChB,aAAa;YACb,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,EAAE,qBAAqB,EAAE,IAAI,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,GAAG,CAAC,EAAK;QACL,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAEtD,6CAA6C;QAC7C,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,EAAE,uBAAuB,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACxF,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QAED,IAAI,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,EAAE,iCAAiC,CAAC,CAAC;YAC1D,OAAO,OAAO,CAAC;QACnB,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAE1B,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAEtC,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAE9B,OAAO,OAAO,CAAC;IACnB,CAAC;IAES,aAAa,GAAG,KAAK,EAAE,EAAK,EAAE,GAAW,EAAE,EAAE;QACnD,IAAI,eAAe,GAAG,IAAI,CAAC;QAC3B,IAAI,CAAC;YACD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;YACxB,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;YAExB,IAAI,GAAG,GAAa,MAAM,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;YAEnD,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACtB,eAAe,GAAG,KAAK,CAAC;gBACxB,gDAAgD;gBAChD,OAAO,GAAG,CAAC;YACf,CAAC;YAED,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;gBAChC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,EAAE,+BAA+B,EAAE,GAAG,CAAC,CAAC;gBAC7D,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;gBAC9B,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC/B,CAAC;YACD,OAAO,GAAG,CAAC;QACf,CAAC;gBAAS,CAAC;YACP,IAAI,eAAe,EAAE,CAAC;gBAClB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,EAAE,4EAA4E,CAAC,CAAC;YACzG,CAAC;QACL,CAAC;IACL,CAAC,CAAC;IAEF,UAAU,CAAC,EAAK;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IACpD,CAAC;IAED,mBAAmB,CAAC,EAAK,EAAE,KAAe;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,CAAC,EAAK;QACR,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;IACvF,CAAC;IAED,IAAI;QACA,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;IAED,UAAU;QACN,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK;QACD,EAAE,IAAI,CAAC,QAAQ,CAAC;QAChB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;QAErB,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;IAC1B,CAAC;IAES,IAAI,CAAC,GAAW,EAAE,IAA0B,EAAE,OAA+B,EAAE,IAAyB;QAC9G,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACtC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QACpC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;IAES,gBAAgB,CAAC,GAAW;QAClC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC5B,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,OAAO,EAAE,IAAI,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,mBAAmB,CAAC;IACpE,CAAC;IAED,gBAAgB;IACN,SAAS,CAAC,GAAW,EAAE,MAAe;QAC5C,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;QACjD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;IACpC,CAAC;IAED,gBAAgB;IACN,UAAU,CAAC,GAAW,EAAE,OAA0B;QACxD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;IACpC,CAAC;IAED,gBAAgB;IACN,WAAW,CAAC,GAAW,EAAE,GAAa;QAC5C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QAC5B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,gBAAgB;IACN,aAAa,CAAC,IAAY;QAChC,EAAE,IAAI,CAAC,UAAU,CAAC;IACtB,CAAC;IAED,gBAAgB;IACN,aAAa,CAAC,GAAa;QACjC,OAAO,GAAG,IAAI,IAAI,CAAC;IACvB,CAAC;IAED,gBAAgB;IACN,eAAe,CAAC,GAAW;QACjC,EAAE,IAAI,CAAC,UAAU,CAAC;QAClB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACnC,CAAC;IAED,YAAY;IACF,KAAK,CAAC,eAAe,CAAC,EAAK;QACjC,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;YACjD,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;YAC9C,OAAO,IAAI,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACf,OAAO,SAAS,EAAE,CAAC;QACvB,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;aACjC,KAAK,CAAC,GAAG,CAAC,EAAE;YACT,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,oBAAoB,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;YAClD,OAAO,IAAI,CAAC;QAChB,CAAC,CAAC,CAAC;QACP,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;YAC7D,iEAAiE;YACjE,OAAO,SAAS,EAAE,CAAC;QACvB,CAAC;QAED,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;CACJ;AAED,SAAS,KAAK,CAAI,GAAW,EAAE,GAAsB,EAAE,GAAM;IACzD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACpB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;SAAM,CAAC;QACJ,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACnB,CAAC;AACL,CAAC"}

package/esm/structures/promiseExtended.js

@@ -0,0 +1,191 @@
+/**
+ * The idea here is to wrap a promise (or promise getter) so it will never throw natively, but still be able to provide success/fail results:
+ * - `onSuccess` for handling successful result: like `then` but to be called only if there was no error
+ * - `onError` for handling error: like `catch` but with extended error format
+ * - `expectError` adds a specific Error sub-class caster and adds it to the error data; useful when expecting some kind of specific error
+ *
+ * Important: all methods are chainable however will return the same PromiseExtended instance,
+ * while native Promise methods return a new Promise instance on each `then`/`catch`/`finally` call.
+ * Internally it just replaces the promise reference.
+ *
+ * Usage example:
+ *
+ * ```ts
+ * function doWork() {
+ *    return PromiseExtended
+ *      .run(async () => {
+ *          // return 42;
+ *          throw new Error('Some error');
+ *     });
+ * }
+ *
+ * dowWork()
+ *   // if no error, will return 42
+ *   .onSuccess(data => console.log('Success:', data))
+ *   // if error, will return { error: 'Some error', source: Error }
+ *   .onError(({ error, source }) => console.error('Error Message:', error, '; original:', source))
+ *   // this is possible to be called only if handlers throw
+ *   .catch(err => console.error('Really unexpected error:', err));
+ *
+ * ```
+ *
+ * NOTE: regular `then`/`catch` will still work, but they will go after `catch` in the chain,
+ * so basically every `then` will be called unless some previous handler throws,
+ * and every `catch` will NOT be called unless there was an error in any previous handler.
+ *
+ * If passed promise resolve is `PromiseExtended` instance, current instance will redirect everything to it.
+ *
+ */
+export class PromiseExtended {
+    _error = null;
+    _promise;
+    _errorProcessors = [];
+    constructor(promise) {
+        this._promise = promise.catch(this._catch);
+    }
+    static run(worker) {
+        const promise = typeof worker === 'function'
+            ? safeGetPromise(worker)
+            : worker;
+        if (promise instanceof PromiseExtended) {
+            return promise;
+        }
+        return new PromiseExtended(promise);
+    }
+    static succeeded(data) {
+        return new PromiseExtended(Promise.resolve(data));
+    }
+    static errored(source) {
+        const err = typeof source === 'string' ? new Error(source) : source;
+        const promise = new PromiseExtended(
+        // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors
+        Promise.reject(err));
+        return promise;
+    }
+    onError(cb) {
+        if (cb != null) {
+            this._promise = this._promise.then(data => {
+                if (this._error) {
+                    cb(this.getError());
+                }
+                return data;
+            });
+        }
+        return this;
+    }
+    onSuccess(cb) {
+        if (cb != null) {
+            this._promise = this._promise.then(data => {
+                if (!this._error) {
+                    cb(data);
+                }
+                return data;
+            });
+        }
+        return this;
+    }
+    expectError(name, ErrCtor, processor) {
+        this._errorProcessors.push(errorData => {
+            const src = errorData?.source;
+            if (src && src instanceof ErrCtor) {
+                const res = processor?.(src);
+                Object.assign(errorData, { [name]: src }, res);
+            }
+        });
+        return this;
+    }
+    then(onfulfilled, onrejected) {
+        const res = this;
+        res._promise = this._promise.then(onfulfilled, onrejected);
+        return res;
+    }
+    catch(onrejected) {
+        const res = this;
+        res._promise = this._promise.catch(onrejected);
+        return res;
+    }
+    finally(onfinally) {
+        this._promise = this._promise.finally(onfinally);
+        return this;
+    }
+    toSuccessPromise() {
+        return new Promise(resolve => {
+            this.onSuccess(() => resolve(true))
+                .onError(() => resolve(false))
+                // below is unreachable, but just in case
+                .catch(() => {
+                /* istanbul ignore next -- @preserve */
+                resolve(false);
+            });
+        });
+    }
+    /* istanbul ignore next -- @preserve */
+    get [Symbol.toStringTag]() { return this._promise[Symbol.toStringTag]; }
+    getError() {
+        const data = {
+            error: this._error.error,
+            source: this._error.source,
+        };
+        this._errorProcessors.forEach(p => p(data));
+        return data;
+    }
+    _catch = (err) => {
+        if (err instanceof PromiseExtendedInnerMarker) {
+            // we've caught the marker, so we need to redirect everything to the inner instance
+            // first, if we still didn't catch any error, we're taking it from the inner instance
+            if (!this._error && err.instance._error) {
+                this.onErrorCaught(err.instance.getError());
+            }
+            // returning inner promise will also resolve with their resolved data
+            return err.data;
+        }
+        let message = '';
+        if (Array.isArray(err)) {
+            message = err.map(e => e.message).join('\n');
+        }
+        else {
+            message = err.message;
+        }
+        this.onErrorCaught({ error: message, source: err });
+        return undefined;
+    };
+    /** Adds to the end of chain special marker that allow outer PromiseExtended to correctly process this instance with its own onSuccess/onError callbacks.
+     *
+     * See `example for combining` test case for more details.
+     */
+    pop() {
+        return this.then(data => {
+            throw new PromiseExtendedInnerMarker(this, data);
+        });
+    }
+    onErrorCaught(data) {
+        this._error = data;
+    }
+}
+/*
+
+Idea: would be nice to combine few Promises and PromiseExtended's into one PromiseExtended instance, so the final result will be handled by onSuccess/onError
+
+*/
+class PromiseExtendedInnerMarker extends Error {
+    instance;
+    data;
+    constructor(instance, data) {
+        super('This is a marker error for PromiseExtended instance, it should be handled internally. If you see this, it means an async function `PromiseExtended.pop()` was called in is not wrapped with `PromiseExtended.run()` or not awaited.');
+        this.instance = instance;
+        this.data = data;
+    }
+}
+function safeGetPromise(cb) {
+    try {
+        const res = cb();
+        if (res == null) {
+            return Promise.reject(new Error('PromiseExtended: target promise is null or undefined'));
+        }
+        return res;
+    }
+    catch (err) {
+        return Promise.reject(err);
+    }
+}
+//# sourceMappingURL=promiseExtended.js.map

package/esm/structures/promiseExtended.js.map

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

package/esm/structures/promiseProxy.js

@@ -0,0 +1,89 @@
+import { LazyPromise } from '../lazy/promise';
+const PromiseGetter = '__promise';
+/**
+ * Creates a proxy object that will be resolved to the object returned by the loader function. // Thanks CoPilot for this comment :)
+ *
+ * @param loader a function returning a promise that resolves to a proxied object
+ * @param fnKeys an array of keys that should be treated as functions so that they can be called before the object is resolved
+ * @param wrap an object that will be used as a wrapper for the proxied object. can contain any fields that will be copied to the resolved object
+ * @returns a proxy object that will be resolved to the object returned by the loader function
+ */
+export function createPromiseProxy(options) {
+    const { loader, fnKeys, wrap, lazy: TLazy = LazyPromise } = options;
+    // wrapper object that will hold values temporarily while loading is in progress
+    const wrapper = (wrap || {});
+    const functionCalls = new Map();
+    let _resolved = null;
+    let lazy = new TLazy(async () => {
+        // do the loading
+        const result = await loader();
+        // copy values from wrapper to result
+        Object.entries(wrapper).forEach(([key, value]) => {
+            const kk = key;
+            if (value !== undefined && (!wrap || wrap[kk] == null)) {
+                result[key] = value;
+            }
+        });
+        // call functions that were called before the object was resolved
+        for (const [key, args] of functionCalls) {
+            const fn = result[key];
+            fn.apply(result, args);
+        }
+        _resolved = result;
+        if (_resolved) {
+            // free up memory, we don't need the wrapper anymore
+            lazy = null;
+        }
+        return result;
+    });
+    const proxy = new Proxy(wrapper, {
+        get(target, key) {
+            if (key === PromiseGetter) {
+                return _resolved ? null : lazy.promise;
+            }
+            const current = _resolved || lazy.value;
+            if (current) {
+                if (wrap && !(key in current) && key in wrap) {
+                    return target[key];
+                }
+                const res = current[key];
+                if (typeof res === 'function') {
+                    return res.bind(current);
+                }
+                return res;
+            }
+            if (fnKeys?.includes(key)) {
+                return (...args) => {
+                    functionCalls.set(key, args);
+                };
+            }
+            return target[key];
+        },
+        set(target, key, value) {
+            const current = _resolved || lazy.value;
+            if (current) {
+                current[key] = value;
+            }
+            else {
+                target[key] = value;
+            }
+            return true;
+        },
+        getOwnPropertyDescriptor(target, key) {
+            const current = _resolved || lazy.value;
+            if (current) {
+                return Object.getOwnPropertyDescriptor(current, key);
+            }
+            return Object.getOwnPropertyDescriptor(target, key);
+        },
+        ownKeys(target) {
+            const current = _resolved || lazy.value;
+            if (current) {
+                return Object.keys(current);
+            }
+            return Object.keys(target);
+        },
+    });
+    return proxy;
+}
+//# sourceMappingURL=promiseProxy.js.map