@daiso-tech/core 0.10.0 → 0.11.0

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

@@ -0,0 +1,425 @@
+import { KeyNotFoundStorageError, STORAGE_EVENTS, UnexpectedStorageError, } from "../../../storage/contracts/_module";
+import { isArrayEmpty, isObjectEmpty, simplifyAsyncLazyable, simplifyNamespace, } from "../../../_shared/utilities";
+import { LazyPromise } from "../../../utilities/_module";
+import { EventBus, NoOpEventBusAdapter, } from "../../../event-bus/implementations/_module";
+export class Storage {
+    namespace;
+    validator;
+    eventBus;
+    storageAdapter;
+    eventAttributes;
+    constructor(storageAdapter, settings = {}) {
+        const { validator = (v) => v, eventBus = new EventBus(new NoOpEventBusAdapter()), } = settings;
+        let { rootNamespace: namespace = "" } = settings;
+        namespace = simplifyNamespace(namespace);
+        this.namespace = namespace;
+        this.validator = validator;
+        this.eventBus = eventBus.withNamespace(this.namespace);
+        this.storageAdapter = storageAdapter;
+        this.eventAttributes = {
+            adapter: this.storageAdapter,
+            namespace: this.namespace,
+        };
+    }
+    addListener(event, listener) {
+        return this.eventBus.addListener(event, listener);
+    }
+    addListenerMany(events, listener) {
+        return this.eventBus.addListenerMany(events, listener);
+    }
+    removeListener(event, listener) {
+        return this.eventBus.removeListener(event, listener);
+    }
+    removeListenerMany(events, listener) {
+        return this.eventBus.removeListenerMany(events, listener);
+    }
+    subscribe(event, listener) {
+        return this.eventBus.subscribe(event, listener);
+    }
+    subscribeMany(events, listener) {
+        return this.eventBus.subscribeMany(events, listener);
+    }
+    withNamespace(namespace) {
+        namespace = simplifyNamespace(namespace);
+        return new Storage(this.storageAdapter, {
+            validator: this.validator,
+            rootNamespace: [this.namespace, namespace],
+        });
+    }
+    getNamespace() {
+        return this.namespace;
+    }
+    createKeyFoundEvent(key, value) {
+        return {
+            type: STORAGE_EVENTS.KEY_FOUND,
+            ...this.eventAttributes,
+            key,
+            value,
+        };
+    }
+    createKeyNotFoundEvent(key) {
+        return {
+            type: STORAGE_EVENTS.KEY_NOT_FOUND,
+            ...this.eventAttributes,
+            key,
+        };
+    }
+    createKeyAddedEvent(key, value) {
+        return {
+            type: STORAGE_EVENTS.KEY_ADDED,
+            ...this.eventAttributes,
+            key,
+            value,
+        };
+    }
+    createKeyUpdatedEvent(key, value) {
+        return {
+            type: STORAGE_EVENTS.KEY_UPDATED,
+            ...this.eventAttributes,
+            key,
+            value,
+        };
+    }
+    createKeyRemovedEvent(key) {
+        return {
+            type: STORAGE_EVENTS.KEY_REMOVED,
+            ...this.eventAttributes,
+            key,
+        };
+    }
+    createKeysClearedEvent() {
+        return {
+            type: STORAGE_EVENTS.KEYS_CLEARED,
+            ...this.eventAttributes,
+        };
+    }
+    createKeyIncrementedEvent(key, value) {
+        return {
+            type: STORAGE_EVENTS.KEY_INCREMENTED,
+            ...this.eventAttributes,
+            key,
+            value,
+        };
+    }
+    createKeyDecrementedEvent(key, value) {
+        return {
+            type: STORAGE_EVENTS.KEY_DECREMENTED,
+            ...this.eventAttributes,
+            key,
+            value,
+        };
+    }
+    keyWithNamespace(key) {
+        return simplifyNamespace([this.namespace, key]);
+    }
+    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 UnexpectedStorageError("!!__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 UnexpectedStorageError("!!__message__!!");
+                }
+                result[key] = value;
+            }
+            return result;
+        });
+    }
+    get(key) {
+        return new LazyPromise(async () => {
+            const value = await this.storageAdapter.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;
+        });
+    }
+    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 UnexpectedStorageError("!!__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 UnexpectedStorageError("!!__message__!!");
+                }
+                result[key] = value;
+            }
+            return result;
+        });
+    }
+    getOrFail(key) {
+        return new LazyPromise(async () => {
+            const value = await this.get(key);
+            if (value === null) {
+                throw new KeyNotFoundStorageError(`Key "${key}" is not found`);
+            }
+            return value;
+        });
+    }
+    add(key, value) {
+        return new LazyPromise(async () => {
+            const hasAdded = await this.storageAdapter.add(this.keyWithNamespace(key), this.validator(value));
+            if (hasAdded) {
+                await this.eventBus.dispatch(this.createKeyAddedEvent(key, value));
+            }
+            return hasAdded;
+        });
+    }
+    addMany(values) {
+        return new LazyPromise(async () => {
+            if (isObjectEmpty(values)) {
+                return {};
+            }
+            const valuePromises = [];
+            for (const key in values) {
+                const value = values[key];
+                valuePromises.push(this.add(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 UnexpectedStorageError("!!__message__!!");
+                }
+                result[key] = value;
+            }
+            return result;
+        });
+    }
+    update(key, value) {
+        return new LazyPromise(async () => {
+            const hasUpdated = await this.storageAdapter.update(this.keyWithNamespace(key), this.validator(value));
+            if (hasUpdated) {
+                await this.eventBus.dispatch(this.createKeyUpdatedEvent(key, value));
+            }
+            else {
+                await this.eventBus.dispatch(this.createKeyNotFoundEvent(key));
+            }
+            return hasUpdated;
+        });
+    }
+    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 UnexpectedStorageError("!!__message__!!");
+                }
+                result[key] = value;
+            }
+            return result;
+        });
+    }
+    put(key, value) {
+        return new LazyPromise(async () => {
+            const hasUpdated = await this.storageAdapter.put(this.keyWithNamespace(key), this.validator(value));
+            if (hasUpdated) {
+                await this.eventBus.dispatch(this.createKeyUpdatedEvent(key, value));
+            }
+            else {
+                await this.eventBus.dispatch(this.createKeyAddedEvent(key, value));
+            }
+            return hasUpdated;
+        });
+    }
+    putMany(values) {
+        return new LazyPromise(async () => {
+            if (isObjectEmpty(values)) {
+                return {};
+            }
+            const valuePromises = [];
+            for (const key in values) {
+                const value = values[key];
+                valuePromises.push(this.put(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 UnexpectedStorageError("!!__message__!!");
+                }
+                result[key] = value;
+            }
+            return result;
+        });
+    }
+    remove(key) {
+        return new LazyPromise(async () => {
+            const hasRemoved = await this.storageAdapter.remove(this.keyWithNamespace(key));
+            if (hasRemoved) {
+                await this.eventBus.dispatch(this.createKeyRemovedEvent(key));
+            }
+            else {
+                await this.eventBus.dispatch(this.createKeyNotFoundEvent(key));
+            }
+            return hasRemoved;
+        });
+    }
+    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 UnexpectedStorageError("!!__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) {
+        return new LazyPromise(async () => {
+            const value = await this.get(key);
+            if (value === null) {
+                const simplifiedValueToAdd = await simplifyAsyncLazyable(valueToAdd);
+                await this.add(key, simplifiedValueToAdd);
+                return simplifiedValueToAdd;
+            }
+            return value;
+        });
+    }
+    increment(key, value = 1) {
+        return new LazyPromise(async () => {
+            const hasUpdated = await this.storageAdapter.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;
+        });
+    }
+    decrement(key, value = 1) {
+        return new LazyPromise(async () => {
+            return await this.increment(key, -value);
+        });
+    }
+    clear() {
+        return new LazyPromise(async () => {
+            await this.storageAdapter.clear(this.namespace);
+            await this.eventBus.dispatch(this.createKeysClearedEvent());
+        });
+    }
+}
+//# sourceMappingURL=storage.js.map

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

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

package/dist/esm/utilities/_module.js

@@ -2,4 +2,5 @@ export * from "../utilities/async/_module";
 export * from "../utilities/backof-policies/_module";
 export * from "../utilities/time-span/_module";
 export * from "../utilities/validation/_module";
+export * from "../utilities/global-errors";
 //# sourceMappingURL=_module.js.map

package/dist/esm/utilities/_module.js.map

@@ -1 +1 @@
-{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../src/utilities/_module.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC"}
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../src/utilities/_module.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC"}

package/dist/esm/utilities/global-errors.js

@@ -0,0 +1,19 @@
+export class FactoryError extends Error {
+    constructor(message, cause) {
+        super(message, { cause });
+        this.name = FactoryError.name;
+    }
+}
+export class DefaultDriverNotDefinedError extends FactoryError {
+    constructor(factoryName) {
+        super(`Default driver not set for factory "${factoryName}"`);
+        this.name = DefaultDriverNotDefinedError.name;
+    }
+}
+export class UnregisteredDriverError extends FactoryError {
+    constructor(driverName) {
+        super(`Unregistered driver "${driverName}"`);
+        this.name = UnregisteredDriverError.name;
+    }
+}
+//# sourceMappingURL=global-errors.js.map

package/dist/esm/utilities/global-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-errors.js","sourceRoot":"","sources":["../../../src/utilities/global-errors.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,YAAa,SAAQ,KAAK;IACnC,YAAY,OAAe,EAAE,KAAe;QACxC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC;IAClC,CAAC;CACJ;AAED,MAAM,OAAO,4BAA6B,SAAQ,YAAY;IAC1D,YAAY,WAAmB;QAC3B,KAAK,CAAC,uCAAuC,WAAW,GAAG,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC,IAAI,CAAC;IAClD,CAAC;CACJ;AAED,MAAM,OAAO,uBAAwB,SAAQ,YAAY;IACrD,YAAY,UAAkB;QAC1B,KAAK,CAAC,wBAAwB,UAAU,GAAG,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC,IAAI,CAAC;IAC7C,CAAC;CACJ"}

package/dist/esm/utilities/time-span/time-span.js.map

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

package/dist/types/_shared/types.d.ts

@@ -11,5 +11,9 @@ export type AnyFunction = (...parameters: unknown[]) => unknown;
 export type IInitizable = {
     init(): PromiseLike<void>;
 };
+export type IDeinitizable = {
+    deInit(): PromiseLike<void>;
+};
 export type Func<TArgs extends unknown[], TReturn> = (...args_: TArgs) => TReturn;
 export type GetOrAddValue<TValue> = Awaited<TValue extends AnyFunction ? ReturnType<TValue> : TValue>;
+export type Result<TValue> = [true, TValue] | [false];

package/dist/types/_shared/utilities.d.ts

@@ -1,7 +1,7 @@
 /**
  * @module Shared
  */
-import type { Lazyable } from "../_shared/types";
+import type { Lazyable, OneOrMore } from "../_shared/types";
 import { type AsyncLazyable } from "../_shared/types";
 /**
  * @internal
@@ -19,3 +19,7 @@ export declare function isArrayEmpty(array: any[]): boolean;
  * @internal
  */
 export declare function isObjectEmpty(object: Record<string | number | symbol, any>): boolean;
+/**
+ * @internal
+ */
+export declare function simplifyNamespace(namepsace: OneOrMore<string>): string;

package/dist/types/event-bus/contracts/_module.d.ts

@@ -1,4 +1,5 @@
 export * from "../../event-bus/contracts/_shared";
+export * from "../../event-bus/contracts/event-bus.errors";
 export * from "../../event-bus/contracts/event-bus.contract";
 export * from "../../event-bus/contracts/event-bus-adapter.contract";
-export * from "../../event-bus/contracts/event-bus-manager.contract";
+export * from "../../event-bus/contracts/event-bus-factory.contract";

package/dist/types/event-bus/contracts/_shared.d.ts

@@ -6,33 +6,3 @@ export type IBaseEvent = {
     type: string;
 };
 export type Listener<TEvent extends IBaseEvent> = (event: TEvent) => Promisable<void>;
-/**
- * @group Errors
- */
-export declare class EventBusError extends Error {
-    constructor(message: string, cause?: unknown);
-}
-/**
- * @group Errors
- */
-export declare class UnexpectedEventBusError extends EventBusError {
-    constructor(message: string, cause?: unknown);
-}
-/**
- * @group Errors
- */
-export declare class RemoveListenerEventBusError extends Error {
-    constructor(message: string, cause?: unknown);
-}
-/**
- * @group Errors
- */
-export declare class AddListenerEventBusError extends Error {
-    constructor(message: string, cause?: unknown);
-}
-/**
- * @group Errors
- */
-export declare class DispatchEventBusError extends Error {
-    constructor(message: string, cause?: unknown);
-}

package/dist/types/event-bus/contracts/event-bus-factory.contract.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @module EventBus
+ */
+import type { Validator } from "../../utilities/_module";
+import type { INamespacedEventBus } from "../../event-bus/contracts/event-bus.contract";
+import type { IBaseEvent } from "../../event-bus/contracts/_shared";
+/**
+ * The <i>IEventBusFactory</i> contract makes it easy to configure and switch between different <i>{@link INamespacedEventBus}</i> dynamically.
+ * @group Contracts
+ */
+export type IEventBusFactory<TDrivers extends string = string, TEvents extends IBaseEvent = IBaseEvent> = {
+    /**
+     * 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 IEventBusFactory } from "@daiso-tech/core";
+     *
+     * async function main(eventFactory: IEventBusFactory): Promise<void> {
+     *   // Will dispatch envent using the default driver which is the memory addapter
+     *   await eventBusFactory
+     *     .use()
+     *     .dispatch({ type: "add", a: 1, b: 2 });
+     *   // Will dispatch envent using the redis addapter
+     *   await eventBusFactory
+     *     .use("redis")
+     *     .dispatch({ type: "add", a: 1, b: 2 });
+     * }
+     * ```
+     */
+    use(driverName?: TDrivers): INamespacedEventBus<TEvents>;
+    /**
+     * The <i>withValidation</i> method is used to set a <i>validator</i>, which validates the event during runtime.
+     * The type is inferred from the provided <i>validator</i>.
+     * @example
+     * ```ts
+     * import { type IEventBusFactory, zodValidator } from "@daiso-tech/core";
+     * import { z } from "zod"
+     *
+     * async function main(eventBusFactory: IEventBusFactory): Promise<void> {
+     *   const addEventSchema = z.zod({
+     *     type: z.literal("add"),
+     *     a: z.number(),
+     *     b: z.number(),
+     *   });
+     *   await eventBusFactory
+     *     .withValidation(zodValidator(addEventSchema))
+     *     .use()
+     *     // You will se an typescript error and get runtime erorr
+     *     .dispatch({ type: "add" });
+     * }
+     * ```
+     */
+    withValidation<TOutput extends TEvents = TEvents>(validator: Validator<TOutput>): IEventBusFactory<TDrivers, TOutput>;
+    /**
+     * The <i>withTypes</i> method is used to set the event types of the <i>{@link IEventBus}</i>.
+     * @example
+     * ```ts
+     * import { type IEventBusFactory, zodValidator } from "@daiso-tech/core";
+     *
+     * async function main(eventBusFactory: IEventBusFactory): Promise<void> {
+     *   type AddEvent = {
+     *     type: "add";
+     *     a: number;
+     *     b: number;
+     *   };
+     *   await eventBusFactory
+     *     .withTypes<AddEvent>()
+     *     .use()
+     *     // You will se an typescript error
+     *     .dispatch({ type: "add" });
+     * }
+     * ```
+     */
+    withType<TOutput extends TEvents = TEvents>(): IEventBusFactory<TDrivers, TOutput>;
+};