@daiso-tech/core 0.11.0 → 0.12.0

package/dist/esm/cache/implementations/derivables/base-cache.js

@@ -0,0 +1,258 @@
+import { KeyNotFoundCacheError, UnexpectedCacheError, } from "../../../cache/contracts/_module";
+import { isArrayEmpty, isObjectEmpty, simplifyAsyncLazyable, } from "../../../_shared/utilities";
+import { LazyPromise } from "../../../utilities/_module";
+export class BaseCache {
+    listenable;
+    constructor(settings) {
+        const { eventBus, namespace } = settings;
+        this.listenable = eventBus.withNamespace(namespace);
+    }
+    addListener(event, listener) {
+        return this.listenable.addListener(event, listener);
+    }
+    addListenerMany(events, listener) {
+        return this.listenable.addListenerMany(events, listener);
+    }
+    removeListener(event, listener) {
+        return this.listenable.removeListener(event, listener);
+    }
+    removeListenerMany(events, listener) {
+        return this.listenable.removeListenerMany(events, listener);
+    }
+    subscribe(event, listener) {
+        return this.listenable.subscribe(event, listener);
+    }
+    subscribeMany(events, listener) {
+        return this.listenable.subscribeMany(events, listener);
+    }
+    exists(key) {
+        return new LazyPromise(async () => {
+            const value = await this.get(key);
+            return value !== null;
+        });
+    }
+    existsMany(keys) {
+        return new LazyPromise(async () => {
+            if (isArrayEmpty(keys)) {
+                return {};
+            }
+            const valuePromises = [];
+            for (const key of keys) {
+                valuePromises.push(this.exists(key));
+            }
+            const values = await Promise.all(valuePromises);
+            const result = {};
+            for (const [index, key] of keys.entries()) {
+                const value = values[index];
+                if (value === undefined) {
+                    throw new UnexpectedCacheError("!!__message__!!");
+                }
+                result[key] = value;
+            }
+            return result;
+        });
+    }
+    missing(key) {
+        return new LazyPromise(async () => {
+            const value = await this.get(key);
+            return value === null;
+        });
+    }
+    missingMany(keys) {
+        return new LazyPromise(async () => {
+            if (isArrayEmpty(keys)) {
+                return {};
+            }
+            const valuePromises = [];
+            for (const key of keys) {
+                valuePromises.push(this.missing(key));
+            }
+            const values = await Promise.all(valuePromises);
+            const result = {};
+            for (const [index, key] of keys.entries()) {
+                const value = values[index];
+                if (value === undefined) {
+                    throw new UnexpectedCacheError("!!__message__!!");
+                }
+                result[key] = value;
+            }
+            return result;
+        });
+    }
+    getMany(keys) {
+        return new LazyPromise(async () => {
+            if (isArrayEmpty(keys)) {
+                return {};
+            }
+            const valuePromises = [];
+            for (const key of keys) {
+                valuePromises.push(this.get(key));
+            }
+            const values = await Promise.all(valuePromises);
+            const result = {};
+            for (const [index, key] of keys.entries()) {
+                const value = values[index];
+                if (value === undefined) {
+                    throw new UnexpectedCacheError("!!__message__!!");
+                }
+                result[key] = value;
+            }
+            return result;
+        });
+    }
+    getOr(key, defaultValue) {
+        return new LazyPromise(async () => {
+            const value = await this.get(key);
+            if (value === null) {
+                return await simplifyAsyncLazyable(defaultValue);
+            }
+            return value;
+        });
+    }
+    getOrMany(keysWithDefaults) {
+        return new LazyPromise(async () => {
+            const keys = Object.keys(keysWithDefaults);
+            if (isArrayEmpty(keys)) {
+                return {};
+            }
+            const valuePromises = [];
+            for (const key of keys) {
+                const defaultValue = keysWithDefaults[key];
+                valuePromises.push(this.getOr(key, defaultValue));
+            }
+            const values = await Promise.all(valuePromises);
+            const result = {};
+            for (const [index, key] of keys.entries()) {
+                const value = values[index];
+                if (value === undefined) {
+                    throw new UnexpectedCacheError("!!__message__!!");
+                }
+                result[key] = value;
+            }
+            return result;
+        });
+    }
+    getOrFail(key) {
+        return new LazyPromise(async () => {
+            const value = await this.get(key);
+            if (value === null) {
+                throw new KeyNotFoundCacheError(`Key "${key}" is not found`);
+            }
+            return value;
+        });
+    }
+    addMany(values) {
+        return new LazyPromise(async () => {
+            if (isObjectEmpty(values)) {
+                return {};
+            }
+            const valuePromises = [];
+            for (const key in values) {
+                const { value, ttl } = values[key];
+                valuePromises.push(this.add(key, value, ttl));
+            }
+            const returnValues = await Promise.all(valuePromises);
+            const result = {};
+            for (const [index, key] of Object.keys(values).entries()) {
+                const value = returnValues[index];
+                if (value === undefined) {
+                    throw new UnexpectedCacheError("!!__message__!!");
+                }
+                result[key] = value;
+            }
+            return result;
+        });
+    }
+    updateMany(values) {
+        return new LazyPromise(async () => {
+            if (isObjectEmpty(values)) {
+                return {};
+            }
+            const valuePromises = [];
+            for (const key in values) {
+                const value = values[key];
+                valuePromises.push(this.update(key, value));
+            }
+            const returnValues = await Promise.all(valuePromises);
+            const result = {};
+            for (const [index, key] of Object.keys(values).entries()) {
+                const value = returnValues[index];
+                if (value === undefined) {
+                    throw new UnexpectedCacheError("!!__message__!!");
+                }
+                result[key] = value;
+            }
+            return result;
+        });
+    }
+    putMany(values) {
+        return new LazyPromise(async () => {
+            if (isObjectEmpty(values)) {
+                return {};
+            }
+            const valuePromises = [];
+            for (const key in values) {
+                const { value, ttl } = values[key];
+                valuePromises.push(this.put(key, value, ttl));
+            }
+            const returnValues = await Promise.all(valuePromises);
+            const result = {};
+            for (const [index, key] of Object.keys(values).entries()) {
+                const value = returnValues[index];
+                if (value === undefined) {
+                    throw new UnexpectedCacheError("!!__message__!!");
+                }
+                result[key] = value;
+            }
+            return result;
+        });
+    }
+    removeMany(keys) {
+        return new LazyPromise(async () => {
+            if (isArrayEmpty(keys)) {
+                return {};
+            }
+            const valuePromises = [];
+            for (const key of keys) {
+                valuePromises.push(this.remove(key));
+            }
+            const values = await Promise.all(valuePromises);
+            const result = {};
+            for (const [index, key] of keys.entries()) {
+                const value = values[index];
+                if (value === undefined) {
+                    throw new UnexpectedCacheError("!!__message__!!");
+                }
+                result[key] = value;
+            }
+            return result;
+        });
+    }
+    getAndRemove(key) {
+        return new LazyPromise(async () => {
+            const value = await this.get(key);
+            if (value === null) {
+                return null;
+            }
+            await this.remove(key);
+            return value;
+        });
+    }
+    getOrAdd(key, valueToAdd, ttl) {
+        return new LazyPromise(async () => {
+            const value = await this.get(key);
+            if (value === null) {
+                const simplifiedValueToAdd = await simplifyAsyncLazyable(valueToAdd);
+                await this.add(key, simplifiedValueToAdd, ttl);
+                return simplifiedValueToAdd;
+            }
+            return value;
+        });
+    }
+    decrement(key, value = 1) {
+        return new LazyPromise(async () => {
+            return await this.increment(key, -value);
+        });
+    }
+}
+//# sourceMappingURL=base-cache.js.map

package/dist/esm/cache/implementations/derivables/base-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-cache.js","sourceRoot":"","sources":["../../../../../src/cache/implementations/derivables/base-cache.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,qBAAqB,EACrB,oBAAoB,GAEvB,MAAM,2BAA2B,CAAC;AAOnC,OAAO,EACH,YAAY,EACZ,aAAa,EACb,qBAAqB,GACxB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAsBlD,MAAM,OAAgB,SAAS;IAGV,UAAU,CAAqC;IAEhE,YAAY,QAAkC;QAC1C,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC;QACzC,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;IAED,WAAW,CACP,KAAiB,EACjB,QAAkE;QAElE,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACxD,CAAC;IAED,eAAe,CACX,MAAoB,EACpB,QAAkE;QAElE,OAAO,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7D,CAAC;IAED,cAAc,CACV,KAAiB,EACjB,QAAkE;QAElE,OAAO,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAED,kBAAkB,CACd,MAAoB,EACpB,QAAkE;QAElE,OAAO,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAChE,CAAC;IAED,SAAS,CACL,KAAiB,EACjB,QAAkE;QAElE,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED,aAAa,CACT,MAAoB,EACpB,QAAkE;QAElE,OAAO,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAMD,MAAM,CAAC,GAAW;QACd,OAAO,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClC,OAAO,KAAK,KAAK,IAAI,CAAC;QAC1B,CAAC,CAAC,CAAC;IACP,CAAC;IAED,UAAU,CACN,IAAa;QAEb,OAAO,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE;YAC9B,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,OAAO,EAAE,CAAC;YACd,CAAC;YACD,MAAM,aAAa,GAA2B,EAAE,CAAC;YACjD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACrB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACzC,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAChD,MAAM,MAAM,GAAG,EAA6B,CAAC;YAC7C,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;gBACxC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACtB,MAAM,IAAI,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;gBACtD,CAAC;gBACD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACxB,CAAC;YACD,OAAO,MAAM,CAAC;QAClB,CAAC,CAAC,CAAC;IACP,CAAC;IAED,OAAO,CAAC,GAAW;QACf,OAAO,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClC,OAAO,KAAK,KAAK,IAAI,CAAC;QAC1B,CAAC,CAAC,CAAC;IACP,CAAC;IAED,WAAW,CACP,IAAa;QAEb,OAAO,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE;YAC9B,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,OAAO,EAAE,CAAC;YACd,CAAC;YACD,MAAM,aAAa,GAA2B,EAAE,CAAC;YACjD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACrB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1C,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAChD,MAAM,MAAM,GAAG,EAA6B,CAAC;YAC7C,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;gBACxC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACtB,MAAM,IAAI,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;gBACtD,CAAC;gBACD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACxB,CAAC;YACD,OAAO,MAAM,CAAC;QAClB,CAAC,CAAC,CAAC;IACP,CAAC;IAID,OAAO,CACH,IAAa;QAEb,OAAO,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE;YAC9B,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,OAAO,EAAE,CAAC;YACd,CAAC;YACD,MAAM,aAAa,GAAgC,EAAE,CAAC;YACtD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACrB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YACtC,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAChD,MAAM,MAAM,GAAG,EAAkC,CAAC;YAClD,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;gBACxC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACtB,MAAM,IAAI,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;gBACtD,CAAC;gBACD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACxB,CAAC;YACD,OAAO,MAAM,CAAC;QAClB,CAAC,CAAC,CAAC;IACP,CAAC;IAED,KAAK,CAAC,GAAW,EAAE,YAAkC;QACjD,OAAO,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACjB,OAAO,MAAM,qBAAqB,CAAC,YAAY,CAAC,CAAC;YACrD,CAAC;YACD,OAAO,KAAK,CAAC;QACjB,CAAC,CAAC,CAAC;IACP,CAAC;IAED,SAAS,CACL,gBAAqD;QAErD,OAAO,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAC3C,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,OAAO,EAAE,CAAC;YACd,CAAC;YACD,MAAM,aAAa,GAAyB,EAAE,CAAC;YAC/C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACrB,MAAM,YAAY,GAAG,gBAAgB,CAAC,GAAY,CAAC,CAAC;gBACpD,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC;YACtD,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAChD,MAAM,MAAM,GAAG,EAA2B,CAAC;YAC3C,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;gBACxC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACtB,MAAM,IAAI,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;gBACtD,CAAC;gBACD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACxB,CAAC;YACD,OAAO,MAAM,CAAC;QAClB,CAAC,CAAC,CAAC;IACP,CAAC;IAED,SAAS,CAAC,GAAW;QACjB,OAAO,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACjB,MAAM,IAAI,qBAAqB,CAAC,QAAQ,GAAG,gBAAgB,CAAC,CAAC;YACjE,CAAC;YACD,OAAO,KAAK,CAAC;QACjB,CAAC,CAAC,CAAC;IACP,CAAC;IAQD,OAAO,CACH,MAA0C;QAE1C,OAAO,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE;YAC9B,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxB,OAAO,EAA4B,CAAC;YACxC,CAAC;YACD,MAAM,aAAa,GAA2B,EAAE,CAAC;YACjD,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;gBACvB,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBACnC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;YAClD,CAAC;YACD,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YACtD,MAAM,MAAM,GAAG,EAA6B,CAAC;YAC7C,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;gBACvD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;gBAClC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACtB,MAAM,IAAI,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;gBACtD,CAAC;gBACD,MAAM,CAAC,GAAY,CAAC,GAAG,KAAK,CAAC;YACjC,CAAC;YACD,OAAO,MAAM,CAAC;QAClB,CAAC,CAAC,CAAC;IACP,CAAC;IAID,UAAU,CACN,MAA4B;QAE5B,OAAO,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE;YAC9B,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxB,OAAO,EAA4B,CAAC;YACxC,CAAC;YACD,MAAM,aAAa,GAA2B,EAAE,CAAC;YACjD,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;gBACvB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC1B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;YAChD,CAAC;YACD,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YACtD,MAAM,MAAM,GAAG,EAA6B,CAAC;YAC7C,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;gBACvD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;gBAClC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACtB,MAAM,IAAI,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;gBACtD,CAAC;gBACD,MAAM,CAAC,GAAY,CAAC,GAAG,KAAK,CAAC;YACjC,CAAC;YACD,OAAO,MAAM,CAAC;QAClB,CAAC,CAAC,CAAC;IACP,CAAC;IAQD,OAAO,CACH,MAA0C;QAE1C,OAAO,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE;YAC9B,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxB,OAAO,EAA4B,CAAC;YACxC,CAAC;YACD,MAAM,aAAa,GAA2B,EAAE,CAAC;YACjD,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;gBACvB,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBACnC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;YAClD,CAAC;YACD,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YACtD,MAAM,MAAM,GAAG,EAA6B,CAAC;YAC7C,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;gBACvD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;gBAClC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACtB,MAAM,IAAI,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;gBACtD,CAAC;gBACD,MAAM,CAAC,GAAY,CAAC,GAAG,KAAK,CAAC;YACjC,CAAC;YACD,OAAO,MAAM,CAAC;QAClB,CAAC,CAAC,CAAC;IACP,CAAC;IAID,UAAU,CACN,IAAa;QAEb,OAAO,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE;YAC9B,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,OAAO,EAA4B,CAAC;YACxC,CAAC;YACD,MAAM,aAAa,GAA2B,EAAE,CAAC;YACjD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACrB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACzC,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAChD,MAAM,MAAM,GAAG,EAA6B,CAAC;YAC7C,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;gBACxC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACtB,MAAM,IAAI,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;gBACtD,CAAC;gBACD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACxB,CAAC;YACD,OAAO,MAAM,CAAC;QAClB,CAAC,CAAC,CAAC;IACP,CAAC;IAED,YAAY,CAAC,GAAW;QACpB,OAAO,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACjB,OAAO,IAAI,CAAC;YAChB,CAAC;YACD,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,KAAK,CAAC;QACjB,CAAC,CAAC,CAAC;IACP,CAAC;IAED,QAAQ,CACJ,GAAW,EACX,UAA+C,EAC/C,GAAc;QAEd,OAAO,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACjB,MAAM,oBAAoB,GAAG,MAAM,qBAAqB,CACpD,UAAkC,CACrC,CAAC;gBACF,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,oBAAoB,EAAE,GAAG,CAAC,CAAC;gBAC/C,OAAO,oBAAoB,CAAC;YAChC,CAAC;YACD,OAAO,KAAK,CAAC;QACjB,CAAC,CAAC,CAAC;IACP,CAAC;IAOD,SAAS,CACL,GAAW,EACX,QAAQ,CAA2B;QAEnC,OAAO,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE;YAC9B,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,KAA+B,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;IACP,CAAC;CAGJ"}

package/dist/esm/{storage/implementations/derivables/storage-factory.js → cache/implementations/derivables/cache-factory.js}

@@ -1,38 +1,35 @@
 import { DefaultDriverNotDefinedError, UnregisteredDriverError, } from "../../../utilities/global-errors";
-import { Storage } from "../../../storage/implementations/derivables/storage";
-export class StorageFactory {
+import { Cache } from "../../../cache/implementations/derivables/cache";
+export class CacheFactory {
     rootNamespace;
     drivers;
     defaultDriver;
     eventBus;
-    validator = (value) => value;
+    defaultTtl;
     constructor(settings) {
-        const { drivers, defaultDriver, eventBus, rootNamespace } = settings;
+        const { drivers, defaultDriver, eventBus, rootNamespace, defaultTtl = null, } = settings;
         this.drivers = drivers;
         this.defaultDriver = defaultDriver;
         this.eventBus = eventBus;
         this.rootNamespace = rootNamespace;
+        this.defaultTtl = defaultTtl;
     }
     use(driverName = this.defaultDriver) {
         if (driverName === undefined) {
-            throw new DefaultDriverNotDefinedError(StorageFactory.name);
+            throw new DefaultDriverNotDefinedError(CacheFactory.name);
         }
         const driver = this.drivers[driverName];
         if (driver === undefined) {
             throw new UnregisteredDriverError(driverName);
         }
-        return new Storage(driver, {
-            validator: this.validator,
+        return new Cache(driver, {
             eventBus: this.eventBus,
             rootNamespace: this.rootNamespace,
+            defaultTtl: this.defaultTtl,
         });
     }
-    withValidation(validator) {
-        this.validator = validator;
-        return this;
-    }
     withType() {
         return this;
     }
 }
-//# sourceMappingURL=storage-factory.js.map
+//# sourceMappingURL=cache-factory.js.map

package/dist/esm/cache/implementations/derivables/cache-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-factory.js","sourceRoot":"","sources":["../../../../../src/cache/implementations/derivables/cache-factory.ts"],"names":[],"mappings":"AAIA,OAAO,EACH,4BAA4B,EAC5B,uBAAuB,GAC1B,MAAM,2BAA2B,CAAC;AAOnC,OAAO,EAAE,KAAK,EAAE,MAAM,0CAA0C,CAAC;AAkDjE,MAAM,OAAO,YAAY;IAGJ,aAAa,CAAU;IACvB,OAAO,CAAyB;IAChC,aAAa,CAAY;IACzB,QAAQ,CAA4B;IAC7C,UAAU,CAAkB;IAEpC,YAAY,QAAwC;QAChD,MAAM,EACF,OAAO,EACP,aAAa,EACb,QAAQ,EACR,aAAa,EACb,UAAU,GAAG,IAAI,GACpB,GAAG,QAAQ,CAAC;QACb,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC;IAED,GAAG,CACC,aAAmC,IAAI,CAAC,aAAa;QAErD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,4BAA4B,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACxC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,uBAAuB,CAAC,UAAU,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,IAAI,KAAK,CAAQ,MAAM,EAAE;YAC5B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,UAAU,EAAE,IAAI,CAAC,UAAU;SAC9B,CAAC,CAAC;IACP,CAAC;IAED,QAAQ;QAKJ,OAAO,IAAW,CAAC;IACvB,CAAC;CACJ"}

package/dist/esm/cache/implementations/derivables/cache.js

@@ -0,0 +1,187 @@
+import { CACHE_EVENTS, } from "../../../cache/contracts/_module";
+import { simplifyNamespace } from "../../../_shared/utilities";
+import { LazyPromise } from "../../../utilities/_module";
+import { EventBus, NoOpEventBusAdapter, } from "../../../event-bus/implementations/_module";
+import { BaseCache } from "../../../cache/implementations/derivables/base-cache";
+export class Cache extends BaseCache {
+    namespace;
+    namespacedEventBus;
+    eventBus;
+    cacheAdapter;
+    eventAttributes;
+    defaultTtl;
+    constructor(cacheAdapter, settings = {}) {
+        const { eventBus: namespacedEventBus = new EventBus(new NoOpEventBusAdapter()), defaultTtl = null, rootNamespace = "", } = settings;
+        const namespace = simplifyNamespace(rootNamespace);
+        const eventBus = namespacedEventBus.withNamespace(namespace);
+        super({
+            namespace,
+            eventBus: namespacedEventBus,
+        });
+        this.namespacedEventBus = namespacedEventBus;
+        this.namespace = namespace;
+        this.eventBus = eventBus;
+        this.cacheAdapter = cacheAdapter;
+        this.defaultTtl = defaultTtl;
+        this.eventAttributes = {
+            adapter: this.cacheAdapter,
+            namespace: this.namespace,
+        };
+    }
+    createKeyFoundEvent(key, value) {
+        return {
+            type: CACHE_EVENTS.KEY_FOUND,
+            ...this.eventAttributes,
+            key,
+            value,
+        };
+    }
+    createKeyNotFoundEvent(key) {
+        return {
+            type: CACHE_EVENTS.KEY_NOT_FOUND,
+            ...this.eventAttributes,
+            key,
+        };
+    }
+    createKeyAddedEvent(key, value, ttl) {
+        return {
+            type: CACHE_EVENTS.KEY_ADDED,
+            ...this.eventAttributes,
+            key,
+            value,
+            ttl,
+        };
+    }
+    createKeyUpdatedEvent(key, value) {
+        return {
+            type: CACHE_EVENTS.KEY_UPDATED,
+            ...this.eventAttributes,
+            key,
+            value,
+        };
+    }
+    createKeyRemovedEvent(key) {
+        return {
+            type: CACHE_EVENTS.KEY_REMOVED,
+            ...this.eventAttributes,
+            key,
+        };
+    }
+    createKeysClearedEvent() {
+        return {
+            type: CACHE_EVENTS.KEYS_CLEARED,
+            ...this.eventAttributes,
+        };
+    }
+    createKeyIncrementedEvent(key, value) {
+        return {
+            type: CACHE_EVENTS.KEY_INCREMENTED,
+            ...this.eventAttributes,
+            key,
+            value,
+        };
+    }
+    createKeyDecrementedEvent(key, value) {
+        return {
+            type: CACHE_EVENTS.KEY_DECREMENTED,
+            ...this.eventAttributes,
+            key,
+            value,
+        };
+    }
+    keyWithNamespace(key) {
+        return simplifyNamespace([this.namespace, key]);
+    }
+    withNamespace(namespace) {
+        namespace = simplifyNamespace(namespace);
+        return new Cache(this.cacheAdapter, {
+            defaultTtl: this.defaultTtl,
+            eventBus: this.namespacedEventBus,
+            rootNamespace: [this.namespace, namespace],
+        });
+    }
+    getNamespace() {
+        return this.namespace;
+    }
+    get(key) {
+        return new LazyPromise(async () => {
+            const value = await this.cacheAdapter.get(this.keyWithNamespace(key));
+            if (value === null) {
+                await this.eventBus.dispatch(this.createKeyNotFoundEvent(key));
+            }
+            else {
+                await this.eventBus.dispatch(this.createKeyFoundEvent(key, value));
+            }
+            return value;
+        });
+    }
+    add(key, value, ttl = this.defaultTtl) {
+        return new LazyPromise(async () => {
+            const hasAdded = await this.cacheAdapter.add(this.keyWithNamespace(key), value, ttl);
+            if (hasAdded) {
+                await this.eventBus.dispatch(this.createKeyAddedEvent(key, value, ttl));
+            }
+            return hasAdded;
+        });
+    }
+    update(key, value) {
+        return new LazyPromise(async () => {
+            const hasUpdated = await this.cacheAdapter.update(this.keyWithNamespace(key), value);
+            if (hasUpdated) {
+                await this.eventBus.dispatch(this.createKeyUpdatedEvent(key, value));
+            }
+            else {
+                await this.eventBus.dispatch(this.createKeyNotFoundEvent(key));
+            }
+            return hasUpdated;
+        });
+    }
+    put(key, value, ttl = this.defaultTtl) {
+        return new LazyPromise(async () => {
+            const hasUpdated = await this.cacheAdapter.put(this.keyWithNamespace(key), value, ttl);
+            if (hasUpdated) {
+                await this.eventBus.dispatch(this.createKeyUpdatedEvent(key, value));
+            }
+            else {
+                await this.eventBus.dispatch(this.createKeyAddedEvent(key, value, ttl));
+            }
+            return hasUpdated;
+        });
+    }
+    remove(key) {
+        return new LazyPromise(async () => {
+            const hasRemoved = await this.cacheAdapter.remove(this.keyWithNamespace(key));
+            if (hasRemoved) {
+                await this.eventBus.dispatch(this.createKeyRemovedEvent(key));
+            }
+            else {
+                await this.eventBus.dispatch(this.createKeyNotFoundEvent(key));
+            }
+            return hasRemoved;
+        });
+    }
+    increment(key, value = 1) {
+        return new LazyPromise(async () => {
+            const hasUpdated = await this.cacheAdapter.increment(this.keyWithNamespace(key), value);
+            if (hasUpdated) {
+                if (value > 0) {
+                    await this.eventBus.dispatch(this.createKeyIncrementedEvent(key, value));
+                }
+                if (value < 0) {
+                    await this.eventBus.dispatch(this.createKeyDecrementedEvent(key, value));
+                }
+            }
+            else {
+                await this.eventBus.dispatch(this.createKeyNotFoundEvent(key));
+            }
+            return hasUpdated;
+        });
+    }
+    clear() {
+        return new LazyPromise(async () => {
+            await this.cacheAdapter.clear(this.namespace);
+            await this.eventBus.dispatch(this.createKeysClearedEvent());
+        });
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/esm/cache/implementations/derivables/cache.js.map

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

package/dist/esm/collection/implementations/async-iterable-collection/_shared/async-error-handler-iterable.js.map

@@ -1 +1 @@
-{"version":3,"file":"async-error-handler-iterable.js","sourceRoot":"","sources":["../../../../../../src/collection/implementations/async-iterable-collection/_shared/async-error-handler-iterable.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,yBAAyB;IAIb;IACA;IAFrB,YACqB,QAA+B,EAC/B,WAAwC;QADxC,aAAQ,GAAR,QAAQ,CAAuB;QAC/B,gBAAW,GAAX,WAAW,CAA6B;IAC1D,CAAC;IAEJ,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC;YAED,OAAO,IAAI,EAAE,CAAC;gBACV,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACrC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;oBACd,OAAO;gBACX,CAAC;gBACD,MAAM,MAAM,CAAC,KAAK,CAAC;YACvB,CAAC;QACL,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO;YACX,CAAC;YACD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;CACJ"}
+{"version":3,"file":"async-error-handler-iterable.js","sourceRoot":"","sources":["../../../../../../src/collection/implementations/async-iterable-collection/_shared/async-error-handler-iterable.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,yBAAyB;IAIb;IACA;IAFrB,YACqB,QAA+B,EAC/B,WAAwC;QADxC,aAAQ,GAAR,QAAQ,CAAuB;QAC/B,gBAAW,GAAX,WAAW,CAA6B;IAC1D,CAAC;IAEJ,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC;YAED,OAAO,IAAI,EAAE,CAAC;gBACV,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACrC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;oBACd,OAAO;gBACX,CAAC;gBACD,MAAM,MAAM,CAAC,KAAK,CAAC;YACvB,CAAC;QACL,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO;YACX,CAAC;YACD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;CACJ"}

package/dist/esm/collection/implementations/iterable-collection/_shared/cross-join-iterable.js.map

@@ -1 +1 @@
-{"version":3,"file":"cross-join-iterable.js","sourceRoot":"","sources":["../../../../../../src/collection/implementations/iterable-collection/_shared/cross-join-iterable.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAMlE,MAAM,OAAO,iBAAiB;IAId;IACA;IACA;IAHZ,YACY,UAA+B,EAC/B,QAA6B,EAC7B,cAEgB;QAJhB,eAAU,GAAV,UAAU,CAAqB;QAC/B,aAAQ,GAAR,QAAQ,CAAqB;QAC7B,mBAAc,GAAd,cAAc,CAEE;IACzB,CAAC;IAEJ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;QACd,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC;YACrC,IAAI,CAAC,UAAU;YACf,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC;SACA,CAAC;aAClC,MAAM,CACH,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACL,OAAO,CAAC;iBACH,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACP,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;oBACf,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;gBACrB,CAAC,CAAC,CAAC;YACP,CAAC,CAAC;iBACD,MAAM,CACH,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EACrB,IAAI,CAAC,cAAc,CAA4B,EAAE,CAAC,CACrD,CAAC;QACV,CAAC,EACD,IAAI,CAAC,cAAc,CAAC,CAAC,EAA+B,CAAC,CAAC,CACzD;aACA,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE;YAEjB,OAAO,WAAW,CAAC,MAAM,CAA4B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBAC1D,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAEzC,CAAC;YACN,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,CAAC,CAAC,CAAC;QACP,KAAK,CAAC,CAAC,YAA4D,CAAC;IACxE,CAAC;CACJ"}
+{"version":3,"file":"cross-join-iterable.js","sourceRoot":"","sources":["../../../../../../src/collection/implementations/iterable-collection/_shared/cross-join-iterable.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AASlE,MAAM,OAAO,iBAAiB;IAId;IACA;IACA;IAHZ,YACY,UAA+B,EAC/B,QAA6B,EAC7B,cAEgB;QAJhB,eAAU,GAAV,UAAU,CAAqB;QAC/B,aAAQ,GAAR,QAAQ,CAAqB;QAC7B,mBAAc,GAAd,cAAc,CAEE;IACzB,CAAC;IAEJ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;QACd,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC;YACrC,IAAI,CAAC,UAAU;YACf,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC;SACA,CAAC;aAClC,MAAM,CACH,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACL,OAAO,CAAC;iBACH,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACP,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;oBACf,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;gBACrB,CAAC,CAAC,CAAC;YACP,CAAC,CAAC;iBACD,MAAM,CACH,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EACrB,IAAI,CAAC,cAAc,CAA4B,EAAE,CAAC,CACrD,CAAC;QACV,CAAC,EACD,IAAI,CAAC,cAAc,CAAC,CAAC,EAA+B,CAAC,CAAC,CACzD;aACA,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE;YAEjB,OAAO,WAAW,CAAC,MAAM,CAA4B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBAC1D,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAEzC,CAAC;YACN,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,CAAC,CAAC,CAAC;QACP,KAAK,CAAC,CAAC,YAA4D,CAAC;IACxE,CAAC;CACJ"}

package/dist/types/_module.d.ts

@@ -1,9 +1,9 @@
+export * from "./cache/implementations/_module";
+export * from "./cache/contracts/_module";
 export * from "./collection/implementations/_module";
 export * from "./collection/contracts/_module";
 export * from "./event-bus/implementations/_module";
 export * from "./event-bus/contracts/_module";
 export * from "./serializer/implementations/_module";
 export * from "./serializer/contracts/_module";
-export * from "./storage/implementations/_module";
-export * from "./storage/contracts/_module";
 export * from "./utilities/_module";

package/dist/types/cache/contracts/_module.d.ts

@@ -0,0 +1,5 @@
+export * from "../../cache/contracts/cache-adapter.contract";
+export * from "../../cache/contracts/cache-factory.contract";
+export * from "../../cache/contracts/cache.contract";
+export * from "../../cache/contracts/cache.errors";
+export * from "../../cache/contracts/cache.events";

package/dist/types/{storage/contracts/storage-adapter.contract.d.ts → cache/contracts/cache-adapter.contract.d.ts}

@@ -1,28 +1,31 @@
 /**
- * @module Storage
+ * @module Cache
  */
+import type { TimeSpan } from "../../utilities/_module";
 /**
- * The <i>IStorageAdapter</i> contract defines a way for storing data as key-value pairs independent of storage.
- * This interface is not meant to be used directly, instead you should use <i>IStorage</i>
+ * The <i>ICacheAdapter</i> contract defines a way for storing data as key-value pairs independent of data storage.
+ * This interface is not meant to be used directly, instead you should use <i>ICache</i>
  * @group Contracts
  */
-export type IStorageAdapter<TType = unknown> = {
+export type ICacheAdapter<TType = unknown> = {
     /**
      * The <i>get</i> returns the value of <i>keys</i> that are found otherwise null will be returned.
      */
     get(key: string): PromiseLike<TType | null>;
     /**
      * The <i>add</i> method add a new <i>key</i>. Returns true if the <i>key</i> where added otherwise false will be returned.
+     * You can provide a <i>ttl</i> value. If null is passed, the item will not expire.
      */
-    add(key: string, value: TType): PromiseLike<boolean>;
+    add(key: string, value: TType, ttl: TimeSpan | null): PromiseLike<boolean>;
     /**
      * The <i>update</i> method updates a <i>key</i>. Returns true if the <i>key</i> where updated otherwise false will be returned.
      */
     update(key: string, value: TType): PromiseLike<boolean>;
     /**
      * The <i>put</i> method replaces a <i>key</i> that exists or adds <i>key</i> that do not exists. Return true if the <i>key</i> where updated otherwise false is returned.
+     * You can provide a <i>ttl</i> value. If null is passed, the item will not expire.
      */
-    put(key: string, value: TType): PromiseLike<boolean>;
+    put(key: string, value: TType, ttl: TimeSpan | null): PromiseLike<boolean>;
     /**
      * The <i>remove</i> method removes a <i>key</i>. Returns true if the <i>key</i> is removed otherwise false is returned.
      */
@@ -31,7 +34,7 @@ export type IStorageAdapter<TType = unknown> = {
      * The <i>increment</i> method will increment the given <i>key</i> if found otherwise nonthing will occur.
      * Returns true if key is incremented otherwise false will be returned.
      * An error will thrown if the key is not a number.
-     * @throws {TypeStorageError} {@link TypeStorageError}
+     * @throws {TypeCacheError} {@link TypeCacheError}
      */
     increment(key: string, value: number): PromiseLike<boolean>;
     /**

package/dist/types/cache/contracts/cache-factory.contract.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @module Cache
+ */
+import type { INamespacedCache } from "../../cache/contracts/cache.contract";
+/**
+ * The <i>ICacheFactory</i> contract makes it easy to configure and switch between different <i>{@link INamespacedCache}</i> dynamically.
+ * @group Contracts
+ */
+export type ICacheFactory<TDrivers extends string = string, TType = unknown> = {
+    /**
+     * The <i>use</i> method will throw an error if you provide it unregisted driver.
+     * If no default driver is defined an error will be thrown by <i>use</i> method.
+     * @throws {UnregisteredDriverError} {@link UnregisteredDriverError}
+     * @throws {DefaultDriverNotDefinedError} {@link DefaultDriverNotDefinedError}
+     * @example
+     * ```ts
+     * import { type ICacheFactory } from "@daiso-tech/core";
+     *
+     * async function main(cacheFactory: ICacheFactory): Promise<void> {
+     *   // Will add key using the default driver
+     *   await cacheFactory
+     *     .use()
+     *     .add("a", 1);
+     *   // Will add key using the redis addapter
+     *   await cacheFactory
+     *     .use("redis")
+     *     .add("a", 1);
+     * }
+     * ```
+     */
+    use(driverName?: TDrivers): INamespacedCache<TType>;
+    /**
+     * The <i>withTypes</i> method is used to set the value types of the cache.
+     * @example
+     * ```ts
+     * import { type ICacheFactory zodValidator } from "@daiso-tech/core";
+     *
+     * async function main(cacheFactory: ICacheFactory): Promise<void> {
+     *   await cacheFactory
+     *     .withTypes<string>()
+     *     .use()
+     *     // You will se an typescript error
+     *     .add("a", 1)
+     * }
+     * ```
+     */
+    withType<TOutput extends TType = TType>(): ICacheFactory<TDrivers, TOutput>;
+};