@daiso-tech/core 0.10.0 → 0.11.0

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

@@ -7,11 +7,11 @@ import type { IStorageAdapter } from "../../storage/contracts/storage-adapter.co
  * @group Events
  */
 export declare const STORAGE_EVENTS: {
-    readonly KEYS_FOUND: "keys_found";
-    readonly KEYS_NOT_FOUND: "keys_not_found";
-    readonly KEYS_ADDED: "keys_added";
-    readonly KEYS_UPDATED: "keys_updated";
-    readonly KEYS_REMOVED: "keys_removed";
+    readonly KEY_FOUND: "key_found";
+    readonly KEY_NOT_FOUND: "key_not_found";
+    readonly KEY_ADDED: "key_added";
+    readonly KEY_UPDATED: "key_updated";
+    readonly KEY_REMOVED: "key_removed";
     readonly KEYS_CLEARED: "keys_cleared";
     readonly KEY_INCREMENTED: "key_incremented";
     readonly KEY_DECREMENTED: "key_decremented";
@@ -30,30 +30,33 @@ export type StorageEvent = {
 /**
  * @group Events
  */
-export type KeysFoundStorageEvent<TType> = StorageEvent & {
-    type: (typeof STORAGE_EVENTS)["KEYS_FOUND"];
-    values: Record<string, TType>;
+export type KeyFoundStorageEvent<TType = unknown> = StorageEvent & {
+    type: (typeof STORAGE_EVENTS)["KEY_FOUND"];
+    key: string;
+    value: TType;
 };
 /**
  * @group Events
  */
-export type KeysNotFoundStorageEvent = StorageEvent & {
-    type: (typeof STORAGE_EVENTS)["KEYS_NOT_FOUND"];
-    keys: string[];
+export type KeyNotFoundStorageEvent = StorageEvent & {
+    type: (typeof STORAGE_EVENTS)["KEY_NOT_FOUND"];
+    key: string;
 };
 /**
  * @group Events
  */
-export type KeysAddedStorageEvent<TType> = StorageEvent & {
-    type: (typeof STORAGE_EVENTS)["KEYS_ADDED"];
-    values: Record<string, TType>;
+export type KeyAddedStorageEvent<TType = unknown> = StorageEvent & {
+    type: (typeof STORAGE_EVENTS)["KEY_ADDED"];
+    key: string;
+    value: TType;
 };
 /**
  * @group Events
  */
-export type KeysUpdatedStorageEvent<TType> = StorageEvent & {
-    type: (typeof STORAGE_EVENTS)["KEYS_UPDATED"];
-    values: Record<string, TType>;
+export type KeyUpdatedStorageEvent<TType = unknown> = StorageEvent & {
+    type: (typeof STORAGE_EVENTS)["KEY_UPDATED"];
+    key: string;
+    value: TType;
 };
 /**
  * @group Events
@@ -74,9 +77,9 @@ export type KeyDecrementedStorageEvent = StorageEvent & {
 /**
  * @group Events
  */
-export type KeysRemovedStorageEvent = StorageEvent & {
-    type: (typeof STORAGE_EVENTS)["KEYS_REMOVED"];
-    keys: string[];
+export type KeyRemovedStorageEvent = StorageEvent & {
+    type: (typeof STORAGE_EVENTS)["KEY_REMOVED"];
+    key: string;
 };
 /**
  * This event will be triggered when storage is cleared.
@@ -88,4 +91,4 @@ export type KeysClearedStorageEvent = StorageEvent & {
 /**
  * @group Events
  */
-export type AllStorageEvents<TType = unknown> = KeysFoundStorageEvent<TType> | KeysNotFoundStorageEvent | KeysAddedStorageEvent<TType> | KeysUpdatedStorageEvent<TType> | KeysRemovedStorageEvent | KeysClearedStorageEvent | KeyIncrementedStorageEvent | KeyDecrementedStorageEvent;
+export type AllStorageEvents<TType> = KeyFoundStorageEvent<TType> | KeyNotFoundStorageEvent | KeyAddedStorageEvent<TType> | KeyUpdatedStorageEvent<TType> | KeyRemovedStorageEvent | KeysClearedStorageEvent | KeyIncrementedStorageEvent | KeyDecrementedStorageEvent;

package/dist/types/storage/implementations/_module.d.ts

@@ -1,6 +1,3 @@
-export * from "../../storage/implementations/storage/_module";
+export * from "../../storage/implementations/derivables/_module";
+export * from "../../storage/implementations/adapters/_module";
 export * from "../../storage/implementations/_shared/test-utilities/_module";
-export * from "../../storage/implementations/memory-storage-adapter/_module";
-export * from "../../storage/implementations/mongodb-storage-adapter/_module";
-export * from "../../storage/implementations/redis-storage-adapter/_module";
-export * from "../../storage/implementations/sqlite/_module";

package/dist/types/storage/implementations/adapters/_module.d.ts

@@ -0,0 +1,4 @@
+export * from "../../../storage/implementations/adapters/memory-storage-adapter/_module";
+export * from "../../../storage/implementations/adapters/mongodb-storage-adapter/_module";
+export * from "../../../storage/implementations/adapters/redis-storage-adapter/_module";
+export * from "../../../storage/implementations/adapters/sqlite/_module";

package/dist/types/storage/implementations/adapters/memory-storage-adapter/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../../storage/implementations/adapters/memory-storage-adapter/memory-storage-adapter";

package/dist/types/storage/implementations/adapters/memory-storage-adapter/memory-storage-adapter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @module Storage
+ */
+import { type IStorageAdapter } from "../../../../storage/contracts/storage-adapter.contract";
+/**
+ * @group Adapters
+ */
+export declare class MemoryStorageAdapter<TType> implements IStorageAdapter<TType> {
+    private readonly map;
+    constructor(map?: Map<string, TType>);
+    get(key: string): Promise<TType | null>;
+    add(key: string, value: TType): Promise<boolean>;
+    update(key: string, value: TType): Promise<boolean>;
+    put(key: string, value: TType): Promise<boolean>;
+    remove(key: string): Promise<boolean>;
+    increment(key: string, value: number): Promise<boolean>;
+    clear(prefix: string): Promise<void>;
+}

package/dist/types/storage/implementations/adapters/mongodb-storage-adapter/_module.d.ts

@@ -0,0 +1 @@
+export { MongodbStorageAdapter, type MongodbStorageAdapterSettings, } from "../../../../storage/implementations/adapters/mongodb-storage-adapter/mongodb-storage-adapter";

package/dist/types/storage/implementations/adapters/mongodb-storage-adapter/mongodb-storage-adapter.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @module Storage
+ */
+import { type ISerializer } from "../../../../serializer/contracts/_module";
+import { type IInitizable } from "../../../../_shared/types";
+import { type IStorageAdapter } from "../../../../storage/contracts/_module";
+import { ObjectId } from "mongodb";
+import { type Collection } from "mongodb";
+/**
+ * @group Adapters
+ */
+export type MongodbStorageDocument = {
+    _id: ObjectId;
+    key: string;
+    value: number | string;
+};
+/**
+ * @group Adapters
+ */
+export type MongodbStorageAdapterSettings = {
+    serializer?: ISerializer<string>;
+};
+/**
+ * @group Adapters
+ */
+export declare class MongodbStorageAdapter<TType> implements IStorageAdapter<TType>, IInitizable {
+    private readonly collection;
+    private static isMongodbIncrementError;
+    private static isMongoDuplicateError;
+    private serializer;
+    constructor(collection: Collection<MongodbStorageDocument>, { serializer, }?: MongodbStorageAdapterSettings);
+    init(): Promise<void>;
+    get(key: string): Promise<TType | null>;
+    add(key: string, value: TType): Promise<boolean>;
+    update(key: string, value: unknown): Promise<boolean>;
+    put(key: string, value: unknown): Promise<boolean>;
+    remove(key: string): Promise<boolean>;
+    increment(key: string, value: number): Promise<boolean>;
+    clear(prefix: string): Promise<void>;
+}

package/dist/types/storage/implementations/adapters/redis-storage-adapter/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../../storage/implementations/adapters/redis-storage-adapter/redis-storage-adapter";

package/dist/types/storage/implementations/{redis-storage-adapter → adapters/redis-storage-adapter}/redis-storage-adapter.d.ts

@@ -1,8 +1,8 @@
 /**
  * @module Storage
  */
-import { type ISerializer } from "../../../serializer/contracts/_module";
-import { type IStorageAdapter } from "../../../storage/contracts/_module";
+import { type ISerializer } from "../../../../serializer/contracts/_module";
+import { type IStorageAdapter } from "../../../../storage/contracts/_module";
 import type Redis from "ioredis";
 import { type Result } from "ioredis";
 declare module "ioredis" {
@@ -25,14 +25,13 @@ export declare class RedisStorageAdapter<TType> implements IStorageAdapter<TType
     private readonly client;
     private serializer;
     constructor(client: Redis, { serializer, }?: RedisStorageAdapterSettings);
-    private initIncrementCommand;
+    get(key: string): Promise<TType | null>;
+    add(key: string, value: TType): Promise<boolean>;
+    update(key: string, value: TType): Promise<boolean>;
     private initPutCommand;
-    existsMany<TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, boolean>>;
-    getMany<TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, TType | null>>;
-    addMany<TKeys extends string>(values: Record<TKeys, TType>): Promise<Record<TKeys, boolean>>;
-    updateMany<TKeys extends string>(values: Record<TKeys, TType>): Promise<Record<TKeys, boolean>>;
-    putMany<TKeys extends string>(values: Record<TKeys, TType>): Promise<Record<TKeys, boolean>>;
-    removeMany<TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, boolean>>;
+    put(key: string, value: TType): Promise<boolean>;
+    remove(key: string): Promise<boolean>;
+    private initIncrementCommand;
     increment(key: string, value: number): Promise<boolean>;
     clear(prefix: string): Promise<void>;
 }

package/dist/types/storage/implementations/adapters/sqlite/_module.d.ts

@@ -0,0 +1,2 @@
+export * from "../../../../storage/implementations/adapters/sqlite/sqlite-storage-adapter/_module";
+export * from "../../../../storage/implementations/adapters/sqlite/libsql-storage-adapter/_module";

package/dist/types/storage/implementations/adapters/sqlite/_shared/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../../../storage/implementations/adapters/sqlite/_shared/base-sqlite-storage-adapter";

package/dist/types/storage/implementations/adapters/sqlite/_shared/base-sqlite-storage-adapter.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @module Storage
+ */
+import { type IStorageAdapter } from "../../../../../storage/contracts/storage-adapter.contract";
+import { type Kysely } from "kysely";
+import { type ISerializer } from "../../../../../serializer/contracts/_module";
+import type { IDeinitizable } from "../../../../../_shared/types";
+import { type IInitizable } from "../../../../../_shared/types";
+/**
+ * @internal
+ */
+type BaseSqliteStorageTable = {
+    key: string;
+    value: string;
+};
+/**
+ * @internal
+ */
+type BaseSqliteTables = {
+    storage: BaseSqliteStorageTable;
+};
+/**
+ * @internal
+ */
+export declare class BaseSqliteStorageAdapter<TType> implements IStorageAdapter<TType>, IInitizable, IDeinitizable {
+    private readonly db;
+    private readonly serializer;
+    constructor(db: Kysely<BaseSqliteTables>, serializer: ISerializer<string>);
+    /**
+     * Creates the table
+     */
+    init(): Promise<void>;
+    /**
+     * Removes the table
+     */
+    deInit(): Promise<void>;
+    get(key: string): Promise<TType | null>;
+    add(key: string, value: TType): Promise<boolean>;
+    update(key: string, value: TType): Promise<boolean>;
+    put(key: string, value: TType): Promise<boolean>;
+    remove(key: string): Promise<boolean>;
+    increment(key: string, value: number): Promise<boolean>;
+    clear(prefix: string): Promise<void>;
+}
+export {};

package/dist/types/storage/implementations/adapters/sqlite/libsql-storage-adapter/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../../../storage/implementations/adapters/sqlite/libsql-storage-adapter/libsql-storage-adapter";

package/dist/types/storage/implementations/adapters/sqlite/libsql-storage-adapter/libsql-storage-adapter.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @module Storage
+ */
+import type { ISerializer } from "../../../../../serializer/contracts/_module";
+import { type IStorageAdapter } from "../../../../../storage/contracts/_module";
+import type { IDeinitizable } from "../../../../../_shared/types";
+import { type IInitizable } from "../../../../../_shared/types";
+import type { Client } from "@libsql/client";
+/**
+ * @group Adapters
+ */
+export type LibsqlStorageAdapterSettings = {
+    tableName?: string;
+    serializer?: ISerializer<string>;
+};
+/**
+ * @group Adapters
+ */
+export declare class LibsqlStorageAdapter<TType> implements IStorageAdapter<TType>, IInitizable, IDeinitizable {
+    private readonly storageAdapter;
+    constructor(client: Client, { tableName, serializer, }?: LibsqlStorageAdapterSettings);
+    /**
+     * Creates the table
+     */
+    init(): Promise<void>;
+    /**
+     * Removes the table
+     */
+    deInit(): Promise<void>;
+    get(key: string): Promise<TType | null>;
+    add(key: string, value: TType): Promise<boolean>;
+    update(key: string, value: TType): Promise<boolean>;
+    put(key: string, value: TType): Promise<boolean>;
+    remove(key: string): Promise<boolean>;
+    increment(key: string, value: number): Promise<boolean>;
+    clear(prefix: string): Promise<void>;
+}

package/dist/types/storage/implementations/adapters/sqlite/sqlite-storage-adapter/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../../../storage/implementations/adapters/sqlite/sqlite-storage-adapter/sqlite-storage-adapter";

package/dist/types/storage/implementations/adapters/sqlite/sqlite-storage-adapter/sqlite-storage-adapter.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @module Storage
+ */
+import type { ISerializer } from "../../../../../serializer/contracts/_module";
+import { type IStorageAdapter } from "../../../../../storage/contracts/_module";
+import { type Database } from "better-sqlite3";
+import type { IDeinitizable } from "../../../../../_shared/types";
+import { type IInitizable } from "../../../../../_shared/types";
+/**
+ * @group Adapters
+ */
+export type SqliteStorageAdapterSettings = {
+    tableName?: string;
+    serializer?: ISerializer<string>;
+};
+/**
+ * @group Adapters
+ */
+export declare class SqliteStorageAdapter<TType> implements IStorageAdapter<TType>, IInitizable, IDeinitizable {
+    private readonly storageAdapter;
+    constructor(database: Database, { tableName, serializer, }?: SqliteStorageAdapterSettings);
+    /**
+     * Creates the table
+     */
+    init(): Promise<void>;
+    /**
+     * Removes the table
+     */
+    deInit(): Promise<void>;
+    get(key: string): Promise<TType | null>;
+    add(key: string, value: TType): Promise<boolean>;
+    update(key: string, value: TType): Promise<boolean>;
+    put(key: string, value: TType): Promise<boolean>;
+    remove(key: string): Promise<boolean>;
+    increment(key: string, value: number): Promise<boolean>;
+    clear(prefix: string): Promise<void>;
+}

package/dist/types/storage/implementations/derivables/_module.d.ts

@@ -0,0 +1,2 @@
+export * from "../../../storage/implementations/derivables/storage";
+export * from "../../../storage/implementations/derivables/storage-factory";

package/dist/types/storage/implementations/derivables/storage-factory.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @module Storage
+ */
+import type { INamespacedEventBus } from "../../../event-bus/contracts/_module";
+import type { IStorageFactory, INamespacedStorage, IStorageAdapter } from "../../../storage/contracts/_module";
+import type { Validator } from "../../../utilities/_module";
+/**
+ * @group Derivables
+ */
+export type StorageDrivers<TDrivers extends string> = Partial<Record<TDrivers, IStorageAdapter<any>>>;
+/**
+ * @group Derivables
+ */
+export type StorageFactorySettings<TDrivers extends string = string> = {
+    drivers: StorageDrivers<TDrivers>;
+    defaultDriver?: NoInfer<TDrivers>;
+    eventBus?: INamespacedEventBus<any>;
+    rootNamespace?: string;
+};
+/**
+ * @group Derivables
+ * @example
+ * ```ts
+ * import { StorageFactory } from "@daiso-tech/core";
+ * import Redis from "ioredis"
+ *
+ * const storageFactory = new StorageFactory({
+ *   drivers: {
+ *     memory: new MemoryStorageAdapter(),
+ *     redis: new RedisStorageAdapter(new Redis()),
+ *   },
+ *   defaultDriver: "memory",
+ *   rootNamespace: "@events"
+ * });
+ * ```
+ */
+export declare class StorageFactory<TDrivers extends string = string, TType = unknown> implements IStorageFactory<TDrivers, TType> {
+    private readonly rootNamespace?;
+    private readonly drivers;
+    private readonly defaultDriver?;
+    private readonly eventBus?;
+    private validator;
+    constructor(settings: StorageFactorySettings<TDrivers>);
+    use(driverName?: TDrivers | undefined): INamespacedStorage<TType>;
+    withValidation<TOutput extends TType = TType>(validator: Validator<TOutput>): IStorageFactory<TDrivers, TOutput>;
+    withType<TOutput extends TType = TType>(): IStorageFactory<TDrivers, TOutput>;
+}

package/dist/types/storage/implementations/{storage → derivables}/storage.d.ts

@@ -1,8 +1,10 @@
 /**
  * @module Storage
  */
+import type { StorageEventNames } from "../../../storage/contracts/_module";
 import { type IStorage, type IStorageAdapter } from "../../../storage/contracts/_module";
-import { type StorageValue, type INamespacedStorage, type AllStorageEvents } from "../../../storage/contracts/_module";
+import { type INamespacedStorage, type AllStorageEvents } from "../../../storage/contracts/_module";
+import type { OneOrMore } from "../../../_shared/types";
 import { type AsyncLazyable, type GetOrAddValue } from "../../../_shared/types";
 import type { Validator } from "../../../utilities/_module";
 import { LazyPromise } from "../../../utilities/_module";
@@ -19,11 +21,12 @@ export type StorageSettings<TType> = {
      * ```ts
      * import { Storage, MemoryStorageAdapter } from "@daiso-tech/core";
      *
-     * const storageA = new Storage(new MemoryStorageAdapter(), {
-     *   rootNamespace: "@a/"
+     * const memoryStorageAdapter = new MemoryStorageAdapter();
+     * const storageA = new Storage(memoryStorageAdapter, {
+     *   rootNamespace: "@a"
      * });
-     * const storageB = new Storage(new MemoryStorageAdapter(), {
-     *   rootNamespace: "@b/"
+     * const storageB = new Storage(memoryStorageAdapter, {
+     *   rootNamespace: "@b"
      * });
      *
      * (async () => {
@@ -37,7 +40,7 @@ export type StorageSettings<TType> = {
      * })();
      * ```
      */
-    rootNamespace?: string;
+    rootNamespace?: OneOrMore<string>;
     /**
      * You can pass a custom <i>{@link Validator}</i> to validate, transform and sanitize your data.
      * You could also use <i>{@link zodValidator}</i> which enables you to use zod for validating, transforming, and sanitizing.
@@ -58,6 +61,9 @@ export type StorageSettings<TType> = {
      * ```
      */
     validator?: Validator<TType>;
+    /**
+     * In order to listen to events of <i>{@link Storage}</i> class you must pass in <i>{@link INamespacedEventBus}</i>.
+     */
     eventBus?: INamespacedEventBus<AllStorageEvents<TType>>;
 };
 /**
@@ -65,30 +71,29 @@ export type StorageSettings<TType> = {
  * @group Derivables
  */
 export declare class Storage<TType = unknown> implements INamespacedStorage<TType> {
-    private readonly storageAdapter;
-    static EVENTS: {
-        readonly KEYS_FOUND: "keys_found";
-        readonly KEYS_NOT_FOUND: "keys_not_found";
-        readonly KEYS_ADDED: "keys_added";
-        readonly KEYS_UPDATED: "keys_updated";
-        readonly KEYS_REMOVED: "keys_removed";
-        readonly KEYS_CLEARED: "keys_cleared";
-        readonly KEY_INCREMENTED: "key_incremented";
-        readonly KEY_DECREMENTED: "key_decremented";
-    };
-    private readonly withEventStorageAdapter;
-    private readonly namespace_;
+    private readonly namespace;
     private readonly validator;
     private readonly eventBus;
+    private readonly storageAdapter;
+    private readonly eventAttributes;
     constructor(storageAdapter: IStorageAdapter<any>, settings?: StorageSettings<TType>);
-    addListener<TEventType extends AllStorageEvents<TType>["type"]>(event: TEventType, listener: Listener<SelectEvent<AllStorageEvents<TType>, TEventType>>): LazyPromise<void>;
-    addListenerMany<TEventType extends AllStorageEvents<TType>["type"]>(events: TEventType[], listener: Listener<SelectEvent<AllStorageEvents<TType>, TEventType>>): LazyPromise<void>;
-    removeListener<TEventType extends AllStorageEvents<TType>["type"]>(event: TEventType, listener: Listener<SelectEvent<AllStorageEvents<TType>, TEventType>>): LazyPromise<void>;
-    removeListenerMany<TEventType extends AllStorageEvents<TType>["type"]>(events: TEventType[], listener: Listener<SelectEvent<AllStorageEvents<TType>, TEventType>>): LazyPromise<void>;
-    subscribe<TEventType extends AllStorageEvents<TType>["type"]>(event: TEventType, listener: Listener<SelectEvent<AllStorageEvents<TType>, TEventType>>): LazyPromise<Unsubscribe>;
-    subscribeMany<TEventType extends AllStorageEvents<TType>["type"]>(events: TEventType[], listener: Listener<SelectEvent<AllStorageEvents<TType>, TEventType>>): LazyPromise<Unsubscribe>;
-    withNamespace(namespace: string): IStorage<TType>;
+    addListener<TEventType extends StorageEventNames>(event: TEventType, listener: Listener<SelectEvent<AllStorageEvents<TType>, TEventType>>): LazyPromise<void>;
+    addListenerMany<TEventType extends StorageEventNames>(events: TEventType[], listener: Listener<SelectEvent<AllStorageEvents<TType>, TEventType>>): LazyPromise<void>;
+    removeListener<TEventType extends StorageEventNames>(event: TEventType, listener: Listener<SelectEvent<AllStorageEvents<TType>, TEventType>>): LazyPromise<void>;
+    removeListenerMany<TEventType extends StorageEventNames>(events: TEventType[], listener: Listener<SelectEvent<AllStorageEvents<TType>, TEventType>>): LazyPromise<void>;
+    subscribe<TEventType extends StorageEventNames>(event: TEventType, listener: Listener<SelectEvent<AllStorageEvents<TType>, TEventType>>): LazyPromise<Unsubscribe>;
+    subscribeMany<TEventType extends StorageEventNames>(events: TEventType[], listener: Listener<SelectEvent<AllStorageEvents<TType>, TEventType>>): LazyPromise<Unsubscribe>;
+    withNamespace(namespace: OneOrMore<string>): IStorage<TType>;
     getNamespace(): string;
+    private createKeyFoundEvent;
+    private createKeyNotFoundEvent;
+    private createKeyAddedEvent;
+    private createKeyUpdatedEvent;
+    private createKeyRemovedEvent;
+    private createKeysClearedEvent;
+    private createKeyIncrementedEvent;
+    private createKeyDecrementedEvent;
+    private keyWithNamespace;
     exists(key: string): LazyPromise<boolean>;
     existsMany<TKeys extends string>(keys: TKeys[]): LazyPromise<Record<TKeys, boolean>>;
     missing(key: string): LazyPromise<boolean>;
@@ -98,16 +103,16 @@ export declare class Storage<TType = unknown> implements INamespacedStorage<TTyp
     getOr(key: string, defaultValue: AsyncLazyable<TType>): LazyPromise<TType>;
     getOrMany<TKeys extends string>(keysWithDefaults: Record<TKeys, AsyncLazyable<TType>>): LazyPromise<Record<TKeys, TType>>;
     getOrFail(key: string): LazyPromise<TType>;
-    add(key: string, value: StorageValue<TType>): LazyPromise<boolean>;
-    addMany<TKeys extends string>(values: Record<TKeys, StorageValue<TType>>): LazyPromise<Record<TKeys, boolean>>;
+    add(key: string, value: TType): LazyPromise<boolean>;
+    addMany<TKeys extends string>(values: Record<TKeys, TType>): LazyPromise<Record<TKeys, boolean>>;
     update(key: string, value: TType): LazyPromise<boolean>;
     updateMany<TKeys extends string>(values: Record<TKeys, TType>): LazyPromise<Record<TKeys, boolean>>;
-    put(key: string, value: StorageValue<TType>): LazyPromise<boolean>;
-    putMany<TKeys extends string>(values: Record<TKeys, StorageValue<TType>>): LazyPromise<Record<TKeys, boolean>>;
+    put(key: string, value: TType): LazyPromise<boolean>;
+    putMany<TKeys extends string>(values: Record<TKeys, TType>): LazyPromise<Record<TKeys, boolean>>;
     remove(key: string): LazyPromise<boolean>;
     removeMany<TKeys extends string>(keys: TKeys[]): LazyPromise<Record<TKeys, boolean>>;
     getAndRemove(key: string): LazyPromise<TType | null>;
-    getOrAdd(key: string, valueToAdd: AsyncLazyable<StorageValue<GetOrAddValue<TType>>>): LazyPromise<TType>;
+    getOrAdd(key: string, valueToAdd: AsyncLazyable<GetOrAddValue<TType>>): LazyPromise<TType>;
     increment(key: string, value?: Extract<TType, number>): LazyPromise<boolean>;
     decrement(key: string, value?: Extract<TType, number>): LazyPromise<boolean>;
     clear(): LazyPromise<void>;

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

@@ -2,3 +2,4 @@ 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";

package/dist/types/utilities/global-errors.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @module Global Errors
+ */
+export declare class FactoryError extends Error {
+    constructor(message: string, cause?: unknown);
+}
+export declare class DefaultDriverNotDefinedError extends FactoryError {
+    constructor(factoryName: string);
+}
+export declare class UnregisteredDriverError extends FactoryError {
+    constructor(driverName: string);
+}

package/dist/types/utilities/time-span/time-span.d.ts

@@ -42,10 +42,12 @@ export declare class TimeSpan {
     toUTCTimestamp(): number;
     /**
      * Will return endDate relative to a given <i>startDate</i> argument.
+     * @default {new Date()} - current date
      */
     toEndDate(startDate?: Date): Date;
     /**
      * Will return startDate relative to a given <i>endDate</i> argument.
+     * @default {new Date()} - current date
      */
     toStartDate(endDate?: Date): Date;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@daiso-tech/core",
     "private": false,
-    "version": "0.10.0",
+    "version": "0.11.0",
     "author": "Yousif Abdulkarim",
     "license": "Apache-2.0",
     "main": "./dist/cjs/_module.js",
@@ -18,8 +18,18 @@
         "Iterable",
         "AsyncIterable",
         "Cache",
+        "Storage",
+        "EventBus",
+        "PuSub",
         "Mongodb",
-        "Redis"
+        "Redis",
+        "Sqlite3",
+        "Turso",
+        "Libsql",
+        "TypeScript",
+        "JavaScript",
+        "Multitenant",
+        "Multitenancy"
     ],
     "files": [
         "./dist"

package/dist/cjs/event-bus/contracts/event-bus-manager.contract.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-bus-manager.contract.js","sourceRoot":"","sources":["../../../../src/event-bus/contracts/event-bus-manager.contract.ts"],"names":[],"mappings":""}

package/dist/cjs/event-bus/implementations/event-bus/_module.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../../src/event-bus/implementations/event-bus/_module.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kFAAgE;AAChE,0FAAwE"}

package/dist/cjs/event-bus/implementations/event-bus/event-bus-manager.js

@@ -1,31 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EventBusManager = void 0;
-const event_bus_1 = require("../../../event-bus/implementations/event-bus/event-bus");
-class EventBusManager {
-    adapters;
-    defaultAdapter;
-    rootNamespace;
-    validator = (value) => value;
-    constructor(settings) {
-        const { adapters, defaultAdapter, rootNamespace } = settings;
-        this.adapters = adapters;
-        this.defaultAdapter = defaultAdapter;
-        this.rootNamespace = rootNamespace;
-    }
-    use(adapter = this.defaultAdapter) {
-        return new event_bus_1.EventBus(this.adapters[adapter], {
-            rootNamespace: this.rootNamespace,
-            validator: this.validator,
-        });
-    }
-    withValidation(validator) {
-        this.validator = validator;
-        return this;
-    }
-    withType() {
-        return this;
-    }
-}
-exports.EventBusManager = EventBusManager;
-//# sourceMappingURL=event-bus-manager.js.map

package/dist/cjs/event-bus/implementations/event-bus/event-bus-manager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-bus-manager.js","sourceRoot":"","sources":["../../../../../src/event-bus/implementations/event-bus/event-bus-manager.ts"],"names":[],"mappings":";;;AAYA,+EAA2E;AAc3E,MAAa,eAAe;IAKP,QAAQ,CAAsC;IAC9C,cAAc,CAAY;IAC1B,aAAa,CAAS;IAE/B,SAAS,GAAmB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC;IAErD,YAAY,QAA4C;QACpD,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,GAAG,QAAQ,CAAC;QAC7D,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACvC,CAAC;IAED,GAAG,CAAC,UAAqB,IAAI,CAAC,cAAc;QACxC,OAAO,IAAI,oBAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE;YACxC,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,SAAS,EAAE,IAAI,CAAC,SAAS;SAC5B,CAAC,CAAC;IACP,CAAC;IAED,cAAc,CACV,SAA6B;QAE7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAE3B,OAAO,IAAW,CAAC;IACvB,CAAC;IAED,QAAQ;QAKJ,OAAO,IAAW,CAAC;IACvB,CAAC;CACJ;AAxCD,0CAwCC"}

package/dist/cjs/event-bus/implementations/event-bus/event-bus.js.map

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

package/dist/cjs/event-bus/implementations/event-bus/with-namespace-event-bus-adapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"with-namespace-event-bus-adapter.js","sourceRoot":"","sources":["../../../../../src/event-bus/implementations/event-bus/with-namespace-event-bus-adapter.ts"],"names":[],"mappings":";;;AAaA,MAAa,4BAA4B;IAOhB;IACA;IAPJ,WAAW,GAAG,IAAI,GAAG,EAGnC,CAAC;IAEJ,YACqB,eAAiC,EACjC,SAAiB;QADjB,oBAAe,GAAf,eAAe,CAAkB;QACjC,cAAS,GAAT,SAAS,CAAQ;IACnC,CAAC;IAEJ,KAAK,CAAC,WAAW,CACb,KAAa,EACb,QAA8B;QAE9B,IAAI,eAAe,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;YAChC,eAAe,GAAG,KAAK,EAAE,QAAoB,EAAE,EAAE;gBAC7C,MAAM,QAAQ,CAAC;oBACX,GAAG,QAAQ;oBACX,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;iBACnD,CAAC,CAAC;YACP,CAAC,CAAC;YACF,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,IAAI,CAAC,eAAe,CAAC,WAAW,CAClC,GAAG,IAAI,CAAC,SAAS,GAAG,KAAK,EAAE,EAC3B,eAAe,CAClB,CAAC;IACN,CAAC;IAED,KAAK,CAAC,cAAc,CAChB,KAAa,EACb,QAA8B;QAE9B,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACvD,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO;QACX,CAAC;QAED,MAAM,IAAI,CAAC,eAAe,CAAC,cAAc,CACrC,GAAG,IAAI,CAAC,SAAS,GAAG,KAAK,EAAE,EAC3B,eAAe,CAClB,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAoB;QAC/B,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,CAC/B,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACnB,GAAG,KAAK;YACR,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,IAAI,EAAE;SACzC,CAAC,CAAC,CACN,CAAC;IACN,CAAC;CACJ;AAxDD,oEAwDC"}