@rspack/core 0.1.8 → 0.1.9

package/dist/lib/Cache.js

@@ -0,0 +1,131 @@
+/*
+    MIT License http://www.opensource.org/licenses/mit-license.php
+    Author Tobias Koppers @sokra
+*/
+"use strict";
+const { AsyncParallelHook, AsyncSeriesBailHook, SyncHook } = require("tapable");
+const { makeWebpackError, makeWebpackErrorCallback } = require("./HookWebpackError.js");
+/** @typedef {import("./WebpackError")} WebpackError */
+/**
+ * @typedef {Object} Etag
+ * @property {function(): string} toString
+ */
+/**
+ * @template T
+ * @callback CallbackCache
+ * @param {(WebpackError | null)=} err
+ * @param {T=} result
+ * @returns {void}
+ */
+/**
+ * @callback GotHandler
+ * @param {any} result
+ * @param {function(Error=): void} callback
+ * @returns {void}
+ */
+const needCalls = (times, callback) => {
+    return err => {
+        if (--times === 0) {
+            return callback(err);
+        }
+        if (err && times > 0) {
+            times = 0;
+            return callback(err);
+        }
+    };
+};
+class Cache {
+    constructor() {
+        this.hooks = {
+            /** @type {AsyncSeriesBailHook<[string, Etag | null, GotHandler[]], any>} */
+            get: new AsyncSeriesBailHook(["identifier", "etag", "gotHandlers"]),
+            /** @type {AsyncParallelHook<[string, Etag | null, any]>} */
+            store: new AsyncParallelHook(["identifier", "etag", "data"]),
+            /** @type {AsyncParallelHook<[Iterable<string>]>} */
+            storeBuildDependencies: new AsyncParallelHook(["dependencies"]),
+            /** @type {SyncHook<[]>} */
+            beginIdle: new SyncHook([]),
+            /** @type {AsyncParallelHook<[]>} */
+            endIdle: new AsyncParallelHook([]),
+            /** @type {AsyncParallelHook<[]>} */
+            shutdown: new AsyncParallelHook([])
+        };
+    }
+    /**
+     * @template T
+     * @param {string} identifier the cache identifier
+     * @param {Etag | null} etag the etag
+     * @param {CallbackCache<T>} callback signals when the value is retrieved
+     * @returns {void}
+     */
+    get(identifier, etag, callback) {
+        const gotHandlers = [];
+        this.hooks.get.callAsync(identifier, etag, gotHandlers, (err, result) => {
+            if (err) {
+                callback(makeWebpackError(err, "Cache.hooks.get"));
+                return;
+            }
+            if (result === null) {
+                result = undefined;
+            }
+            if (gotHandlers.length > 1) {
+                const innerCallback = needCalls(gotHandlers.length, () => callback(null, result));
+                for (const gotHandler of gotHandlers) {
+                    gotHandler(result, innerCallback);
+                }
+            }
+            else if (gotHandlers.length === 1) {
+                gotHandlers[0](result, () => callback(null, result));
+            }
+            else {
+                callback(null, result);
+            }
+        });
+    }
+    /**
+     * @template T
+     * @param {string} identifier the cache identifier
+     * @param {Etag | null} etag the etag
+     * @param {T} data the value to store
+     * @param {CallbackCache<void>} callback signals when the value is stored
+     * @returns {void}
+     */
+    store(identifier, etag, data, callback) {
+        this.hooks.store.callAsync(identifier, etag, data, makeWebpackErrorCallback(callback, "Cache.hooks.store"));
+    }
+    /**
+     * After this method has succeeded the cache can only be restored when build dependencies are
+     * @param {Iterable<string>} dependencies list of all build dependencies
+     * @param {CallbackCache<void>} callback signals when the dependencies are stored
+     * @returns {void}
+     */
+    storeBuildDependencies(dependencies, callback) {
+        this.hooks.storeBuildDependencies.callAsync(dependencies, makeWebpackErrorCallback(callback, "Cache.hooks.storeBuildDependencies"));
+    }
+    /**
+     * @returns {void}
+     */
+    beginIdle() {
+        this.hooks.beginIdle.call();
+    }
+    /**
+     * @param {CallbackCache<void>} callback signals when the call finishes
+     * @returns {void}
+     */
+    endIdle(callback) {
+        this.hooks.endIdle.callAsync(makeWebpackErrorCallback(callback, "Cache.hooks.endIdle"));
+    }
+    /**
+     * @param {CallbackCache<void>} callback signals when the call finishes
+     * @returns {void}
+     */
+    shutdown(callback) {
+        this.hooks.shutdown.callAsync(makeWebpackErrorCallback(callback, "Cache.hooks.shutdown"));
+    }
+}
+Cache.STAGE_MEMORY = -10;
+Cache.STAGE_DEFAULT = 0;
+Cache.STAGE_DISK = 10;
+Cache.STAGE_NETWORK = 20;
+module.exports = Cache;
+//# sourceMappingURL=Cache.js.map

package/dist/lib/Cache.js.map

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

package/dist/lib/CacheFacade.d.ts

@@ -0,0 +1,192 @@
+export = CacheFacade;
+declare class CacheFacade {
+    /**
+     * @param {Cache} cache the root cache
+     * @param {string} name the child cache name
+     * @param {string | HashConstructor} hashFunction the hash function to use
+     */
+    constructor(cache: Cache, name: string, hashFunction: string | HashConstructor);
+    _cache: import("./Cache");
+    _name: string;
+    _hashFunction: any;
+    /**
+     * @param {string} name the child cache name#
+     * @returns {CacheFacade} child cache
+     */
+    getChildCache(name: string): CacheFacade;
+    /**
+     * @param {string} identifier the cache identifier
+     * @param {Etag | null} etag the etag
+     * @returns {ItemCacheFacade} item cache
+     */
+    getItemCache(identifier: string, etag: Etag | null): ItemCacheFacade;
+    /**
+     * @param {HashableObject} obj an hashable object
+     * @returns {Etag} an etag that is lazy hashed
+     */
+    getLazyHashedEtag(obj: HashableObject): Etag;
+    /**
+     * @param {Etag} a an etag
+     * @param {Etag} b another etag
+     * @returns {Etag} an etag that represents both
+     */
+    mergeEtags(a: Etag, b: Etag): Etag;
+    /**
+     * @template T
+     * @param {string} identifier the cache identifier
+     * @param {Etag | null} etag the etag
+     * @param {CallbackCache<T>} callback signals when the value is retrieved
+     * @returns {void}
+     */
+    get<T>(identifier: string, etag: Etag | null, callback: CallbackCache<T>): void;
+    /**
+     * @template T
+     * @param {string} identifier the cache identifier
+     * @param {Etag | null} etag the etag
+     * @returns {Promise<T>} promise with the data
+     */
+    getPromise<T_1>(identifier: string, etag: Etag | null): Promise<T_1>;
+    /**
+     * @template T
+     * @param {string} identifier the cache identifier
+     * @param {Etag | null} etag the etag
+     * @param {T} data the value to store
+     * @param {CallbackCache<void>} callback signals when the value is stored
+     * @returns {void}
+     */
+    store<T_2>(identifier: string, etag: Etag | null, data: T_2, callback: CallbackCache<void>): void;
+    /**
+     * @template T
+     * @param {string} identifier the cache identifier
+     * @param {Etag | null} etag the etag
+     * @param {T} data the value to store
+     * @returns {Promise<void>} promise signals when the value is stored
+     */
+    storePromise<T_3>(identifier: string, etag: Etag | null, data: T_3): Promise<void>;
+    /**
+     * @template T
+     * @param {string} identifier the cache identifier
+     * @param {Etag | null} etag the etag
+     * @param {function(CallbackNormalErrorCache<T>): void} computer function to compute the value if not cached
+     * @param {CallbackNormalErrorCache<T>} callback signals when the value is retrieved
+     * @returns {void}
+     */
+    provide<T_4>(identifier: string, etag: Etag | null, computer: (arg0: CallbackNormalErrorCache<T_4>) => void, callback: CallbackNormalErrorCache<T_4>): void;
+    /**
+     * @template T
+     * @param {string} identifier the cache identifier
+     * @param {Etag | null} etag the etag
+     * @param {function(): Promise<T> | T} computer function to compute the value if not cached
+     * @returns {Promise<T>} promise with the data
+     */
+    providePromise<T_5>(identifier: string, etag: Etag | null, computer: () => T_5 | Promise<T_5>): Promise<T_5>;
+}
+declare namespace CacheFacade {
+    export { ItemCacheFacade, MultiItemCache, Cache, Etag, WebpackError, HashableObject, HashConstructor, CallbackCache, CallbackNormalErrorCache };
+}
+type Etag = import("./Cache").Etag;
+declare class ItemCacheFacade {
+    /**
+     * @param {Cache} cache the root cache
+     * @param {string} name the child cache item name
+     * @param {Etag | null} etag the etag
+     */
+    constructor(cache: Cache, name: string, etag: Etag | null);
+    _cache: import("./Cache");
+    _name: string;
+    _etag: import("./Cache").Etag | null;
+    /**
+     * @template T
+     * @param {CallbackCache<T>} callback signals when the value is retrieved
+     * @returns {void}
+     */
+    get<T>(callback: CallbackCache<T>): void;
+    /**
+     * @template T
+     * @returns {Promise<T>} promise with the data
+     */
+    getPromise<T_1>(): Promise<T_1>;
+    /**
+     * @template T
+     * @param {T} data the value to store
+     * @param {CallbackCache<void>} callback signals when the value is stored
+     * @returns {void}
+     */
+    store<T_2>(data: T_2, callback: CallbackCache<void>): void;
+    /**
+     * @template T
+     * @param {T} data the value to store
+     * @returns {Promise<void>} promise signals when the value is stored
+     */
+    storePromise<T_3>(data: T_3): Promise<void>;
+    /**
+     * @template T
+     * @param {function(CallbackNormalErrorCache<T>): void} computer function to compute the value if not cached
+     * @param {CallbackNormalErrorCache<T>} callback signals when the value is retrieved
+     * @returns {void}
+     */
+    provide<T_4>(computer: (arg0: CallbackNormalErrorCache<T_4>) => void, callback: CallbackNormalErrorCache<T_4>): void;
+    /**
+     * @template T
+     * @param {function(): Promise<T> | T} computer function to compute the value if not cached
+     * @returns {Promise<T>} promise with the data
+     */
+    providePromise<T_5>(computer: () => T_5 | Promise<T_5>): Promise<T_5>;
+}
+type HashableObject = import("./cache/getLazyHashedEtag").HashableObject;
+type CallbackCache<T> = (err?: (WebpackError | null) | undefined, result?: T | undefined) => void;
+type CallbackNormalErrorCache<T> = (err?: (Error | null) | undefined, result?: T | undefined) => void;
+type Cache = import("./Cache");
+type HashConstructor = typeof import("./util/Hash");
+/** @typedef {import("./Cache")} Cache */
+/** @typedef {import("./Cache").Etag} Etag */
+/** @typedef {import("./WebpackError")} WebpackError */
+/** @typedef {import("./cache/getLazyHashedEtag").HashableObject} HashableObject */
+/** @typedef {typeof import("./util/Hash")} HashConstructor */
+/**
+ * @template T
+ * @callback CallbackCache
+ * @param {(WebpackError | null)=} err
+ * @param {T=} result
+ * @returns {void}
+ */
+/**
+ * @template T
+ * @callback CallbackNormalErrorCache
+ * @param {(Error | null)=} err
+ * @param {T=} result
+ * @returns {void}
+ */
+declare class MultiItemCache {
+    /**
+     * @param {ItemCacheFacade[]} items item caches
+     */
+    constructor(items: ItemCacheFacade[]);
+    _items: ItemCacheFacade[];
+    /**
+     * @template T
+     * @param {CallbackCache<T>} callback signals when the value is retrieved
+     * @returns {void}
+     */
+    get<T>(callback: CallbackCache<T>): void;
+    /**
+     * @template T
+     * @returns {Promise<T>} promise with the data
+     */
+    getPromise<T_1>(): Promise<T_1>;
+    /**
+     * @template T
+     * @param {T} data the value to store
+     * @param {CallbackCache<void>} callback signals when the value is stored
+     * @returns {void}
+     */
+    store<T_2>(data: T_2, callback: CallbackCache<void>): void;
+    /**
+     * @template T
+     * @param {T} data the value to store
+     * @returns {Promise<void>} promise signals when the value is stored
+     */
+    storePromise<T_3>(data: T_3): Promise<void>;
+}
+type WebpackError = import("./WebpackError");
+//# sourceMappingURL=CacheFacade.d.ts.map

package/dist/lib/CacheFacade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheFacade.d.ts","sourceRoot":"","sources":["../../src/lib/CacheFacade.js"],"names":[],"mappings":";AA8LA;IACC;;;;OAIG;IACH,mBAJW,KAAK,QACL,MAAM,gBACN,MAAM,GAAG,eAAe,EAMlC;IAHA,0BAAmB;IACnB,cAAiB;IACjB,mBAAiC;IAGlC;;;OAGG;IACH,oBAHW,MAAM,GACJ,WAAW,CAQvB;IAED;;;;OAIG;IACH,yBAJW,MAAM,QACN,IAAI,GAAG,IAAI,GACT,eAAe,CAQ3B;IAED;;;OAGG;IACH,uBAHW,cAAc,GACZ,IAAI,CAIhB;IAED;;;;OAIG;IACH,cAJW,IAAI,KACJ,IAAI,GACF,IAAI,CAIhB;IAED;;;;;;OAMG;IACH,mBALW,MAAM,QACN,IAAI,GAAG,IAAI,+BAET,IAAI,CAIhB;IAED;;;;;OAKG;IACH,4BAJW,MAAM,QACN,IAAI,GAAG,IAAI,gBAarB;IAED;;;;;;;OAOG;IACH,uBANW,MAAM,QACN,IAAI,GAAG,IAAI,uBAEX,cAAc,IAAI,CAAC,GACjB,IAAI,CAIhB;IAED;;;;;;OAMG;IACH,8BALW,MAAM,QACN,IAAI,GAAG,IAAI,cAET,QAAQ,IAAI,CAAC,CAYzB;IAED;;;;;;;OAOG;IACH,yBANW,MAAM,QACN,IAAI,GAAG,IAAI,qDAC4B,IAAI,4CAEzC,IAAI,CAchB;IAED;;;;;;OAMG;IACH,gCALW,MAAM,QACN,IAAI,GAAG,IAAI,oDAUrB;CACD;;;;YAvUa,OAAO,SAAS,EAAE,IAAI;AA+EpC;IACC;;;;OAIG;IACH,mBAJW,KAAK,QACL,MAAM,QACN,IAAI,GAAG,IAAI,EAMrB;IAHA,0BAAmB;IACnB,cAAiB;IACjB,qCAAiB;IAGlB;;;;OAIG;IACH,oCAFa,IAAI,CAIhB;IAED;;;OAGG;IACH,gCAUC;IAED;;;;;OAKG;IACH,gCAHW,cAAc,IAAI,CAAC,GACjB,IAAI,CAIhB;IAED;;;;OAIG;IACH,8BAFa,QAAQ,IAAI,CAAC,CAYzB;IAED;;;;;OAKG;IACH,gEAJkD,IAAI,4CAEzC,IAAI,CAchB;IAED;;;;OAIG;IACH,sEAMC;CACD;sBA7Ka,OAAO,2BAA2B,EAAE,cAAc;+BAMrD,CAAC,YAAY,GAAG,IAAI,CAAC,uBACrB,CAAC,iBACC,IAAI;0CAMN,CAAC,KAAK,GAAG,IAAI,CAAC,uBACd,CAAC,iBACC,IAAI;aAnBH,OAAO,SAAS,CAAC;uBAIjB,cAAc,aAAa,CAAC;AAJ1C,yCAAyC;AACzC,6CAA6C;AAC7C,uDAAuD;AACvD,mFAAmF;AACnF,8DAA8D;AAE9D;;;;;;GAMG;AAEH;;;;;;GAMG;AAEH;IACC;;OAEG;IACH,mBAFW,eAAe,EAAE,EAK3B;IAFA,0BAAmB;IAIpB;;;;OAIG;IACH,oCAFa,IAAI,CAIhB;IAED;;;OAGG;IACH,gCAQC;IAED;;;;;OAKG;IACH,gCAHW,cAAc,IAAI,CAAC,GACjB,IAAI,CAQhB;IAED;;;;OAIG;IACH,8BAFa,QAAQ,IAAI,CAAC,CAMzB;CACD;oBA5Ea,OAAO,gBAAgB,CAAC"}

package/dist/lib/CacheFacade.js

@@ -0,0 +1,320 @@
+/*
+    MIT License http://www.opensource.org/licenses/mit-license.php
+    Author Tobias Koppers @sokra
+*/
+"use strict";
+const { forEachBail } = require("enhanced-resolve");
+const asyncLib = require("neo-async");
+const getLazyHashedEtag = require("./cache/getLazyHashedEtag.js");
+const mergeEtags = require("./cache/mergeEtags.js");
+/** @typedef {import("./Cache")} Cache */
+/** @typedef {import("./Cache").Etag} Etag */
+/** @typedef {import("./WebpackError")} WebpackError */
+/** @typedef {import("./cache/getLazyHashedEtag").HashableObject} HashableObject */
+/** @typedef {typeof import("./util/Hash")} HashConstructor */
+/**
+ * @template T
+ * @callback CallbackCache
+ * @param {(WebpackError | null)=} err
+ * @param {T=} result
+ * @returns {void}
+ */
+/**
+ * @template T
+ * @callback CallbackNormalErrorCache
+ * @param {(Error | null)=} err
+ * @param {T=} result
+ * @returns {void}
+ */
+class MultiItemCache {
+    /**
+     * @param {ItemCacheFacade[]} items item caches
+     */
+    constructor(items) {
+        this._items = items;
+        if (items.length === 1)
+            return /** @type {any} */ (items[0]);
+    }
+    /**
+     * @template T
+     * @param {CallbackCache<T>} callback signals when the value is retrieved
+     * @returns {void}
+     */
+    get(callback) {
+        forEachBail(this._items, (item, callback) => item.get(callback), callback);
+    }
+    /**
+     * @template T
+     * @returns {Promise<T>} promise with the data
+     */
+    getPromise() {
+        const next = i => {
+            return this._items[i].getPromise().then(result => {
+                if (result !== undefined)
+                    return result;
+                if (++i < this._items.length)
+                    return next(i);
+            });
+        };
+        return next(0);
+    }
+    /**
+     * @template T
+     * @param {T} data the value to store
+     * @param {CallbackCache<void>} callback signals when the value is stored
+     * @returns {void}
+     */
+    store(data, callback) {
+        asyncLib.each(this._items, (item, callback) => item.store(data, callback), callback);
+    }
+    /**
+     * @template T
+     * @param {T} data the value to store
+     * @returns {Promise<void>} promise signals when the value is stored
+     */
+    storePromise(data) {
+        return Promise.all(this._items.map(item => item.storePromise(data))).then(() => { });
+    }
+}
+class ItemCacheFacade {
+    /**
+     * @param {Cache} cache the root cache
+     * @param {string} name the child cache item name
+     * @param {Etag | null} etag the etag
+     */
+    constructor(cache, name, etag) {
+        this._cache = cache;
+        this._name = name;
+        this._etag = etag;
+    }
+    /**
+     * @template T
+     * @param {CallbackCache<T>} callback signals when the value is retrieved
+     * @returns {void}
+     */
+    get(callback) {
+        this._cache.get(this._name, this._etag, callback);
+    }
+    /**
+     * @template T
+     * @returns {Promise<T>} promise with the data
+     */
+    getPromise() {
+        return new Promise((resolve, reject) => {
+            this._cache.get(this._name, this._etag, (err, data) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve(data);
+                }
+            });
+        });
+    }
+    /**
+     * @template T
+     * @param {T} data the value to store
+     * @param {CallbackCache<void>} callback signals when the value is stored
+     * @returns {void}
+     */
+    store(data, callback) {
+        this._cache.store(this._name, this._etag, data, callback);
+    }
+    /**
+     * @template T
+     * @param {T} data the value to store
+     * @returns {Promise<void>} promise signals when the value is stored
+     */
+    storePromise(data) {
+        return new Promise((resolve, reject) => {
+            this._cache.store(this._name, this._etag, data, err => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+    /**
+     * @template T
+     * @param {function(CallbackNormalErrorCache<T>): void} computer function to compute the value if not cached
+     * @param {CallbackNormalErrorCache<T>} callback signals when the value is retrieved
+     * @returns {void}
+     */
+    provide(computer, callback) {
+        this.get((err, cacheEntry) => {
+            if (err)
+                return callback(err);
+            if (cacheEntry !== undefined)
+                return cacheEntry;
+            computer((err, result) => {
+                if (err)
+                    return callback(err);
+                this.store(result, err => {
+                    if (err)
+                        return callback(err);
+                    callback(null, result);
+                });
+            });
+        });
+    }
+    /**
+     * @template T
+     * @param {function(): Promise<T> | T} computer function to compute the value if not cached
+     * @returns {Promise<T>} promise with the data
+     */
+    async providePromise(computer) {
+        const cacheEntry = await this.getPromise();
+        if (cacheEntry !== undefined)
+            return cacheEntry;
+        const result = await computer();
+        await this.storePromise(result);
+        return result;
+    }
+}
+class CacheFacade {
+    /**
+     * @param {Cache} cache the root cache
+     * @param {string} name the child cache name
+     * @param {string | HashConstructor} hashFunction the hash function to use
+     */
+    constructor(cache, name, hashFunction) {
+        this._cache = cache;
+        this._name = name;
+        this._hashFunction = hashFunction;
+    }
+    /**
+     * @param {string} name the child cache name#
+     * @returns {CacheFacade} child cache
+     */
+    getChildCache(name) {
+        return new CacheFacade(this._cache, `${this._name}|${name}`, this._hashFunction);
+    }
+    /**
+     * @param {string} identifier the cache identifier
+     * @param {Etag | null} etag the etag
+     * @returns {ItemCacheFacade} item cache
+     */
+    getItemCache(identifier, etag) {
+        return new ItemCacheFacade(this._cache, `${this._name}|${identifier}`, etag);
+    }
+    /**
+     * @param {HashableObject} obj an hashable object
+     * @returns {Etag} an etag that is lazy hashed
+     */
+    getLazyHashedEtag(obj) {
+        return getLazyHashedEtag(obj, this._hashFunction);
+    }
+    /**
+     * @param {Etag} a an etag
+     * @param {Etag} b another etag
+     * @returns {Etag} an etag that represents both
+     */
+    mergeEtags(a, b) {
+        return mergeEtags(a, b);
+    }
+    /**
+     * @template T
+     * @param {string} identifier the cache identifier
+     * @param {Etag | null} etag the etag
+     * @param {CallbackCache<T>} callback signals when the value is retrieved
+     * @returns {void}
+     */
+    get(identifier, etag, callback) {
+        this._cache.get(`${this._name}|${identifier}`, etag, callback);
+    }
+    /**
+     * @template T
+     * @param {string} identifier the cache identifier
+     * @param {Etag | null} etag the etag
+     * @returns {Promise<T>} promise with the data
+     */
+    getPromise(identifier, etag) {
+        return new Promise((resolve, reject) => {
+            this._cache.get(`${this._name}|${identifier}`, etag, (err, data) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve(data);
+                }
+            });
+        });
+    }
+    /**
+     * @template T
+     * @param {string} identifier the cache identifier
+     * @param {Etag | null} etag the etag
+     * @param {T} data the value to store
+     * @param {CallbackCache<void>} callback signals when the value is stored
+     * @returns {void}
+     */
+    store(identifier, etag, data, callback) {
+        this._cache.store(`${this._name}|${identifier}`, etag, data, callback);
+    }
+    /**
+     * @template T
+     * @param {string} identifier the cache identifier
+     * @param {Etag | null} etag the etag
+     * @param {T} data the value to store
+     * @returns {Promise<void>} promise signals when the value is stored
+     */
+    storePromise(identifier, etag, data) {
+        return new Promise((resolve, reject) => {
+            this._cache.store(`${this._name}|${identifier}`, etag, data, err => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+    /**
+     * @template T
+     * @param {string} identifier the cache identifier
+     * @param {Etag | null} etag the etag
+     * @param {function(CallbackNormalErrorCache<T>): void} computer function to compute the value if not cached
+     * @param {CallbackNormalErrorCache<T>} callback signals when the value is retrieved
+     * @returns {void}
+     */
+    provide(identifier, etag, computer, callback) {
+        this.get(identifier, etag, (err, cacheEntry) => {
+            if (err)
+                return callback(err);
+            if (cacheEntry !== undefined)
+                return cacheEntry;
+            computer((err, result) => {
+                if (err)
+                    return callback(err);
+                this.store(identifier, etag, result, err => {
+                    if (err)
+                        return callback(err);
+                    callback(null, result);
+                });
+            });
+        });
+    }
+    /**
+     * @template T
+     * @param {string} identifier the cache identifier
+     * @param {Etag | null} etag the etag
+     * @param {function(): Promise<T> | T} computer function to compute the value if not cached
+     * @returns {Promise<T>} promise with the data
+     */
+    async providePromise(identifier, etag, computer) {
+        const cacheEntry = await this.getPromise(identifier, etag);
+        if (cacheEntry !== undefined)
+            return cacheEntry;
+        const result = await computer();
+        await this.storePromise(identifier, etag, result);
+        return result;
+    }
+}
+module.exports = CacheFacade;
+module.exports.ItemCacheFacade = ItemCacheFacade;
+module.exports.MultiItemCache = MultiItemCache;
+//# sourceMappingURL=CacheFacade.js.map

package/dist/lib/CacheFacade.js.map

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