@daiso-tech/core 0.2.1 → 0.4.0

package/dist/types/contracts/storage/storage-adapter.contract.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @module Storage
+ */
+import type { GetOrAddResult } from "../../_shared/types";
+/**
+ * @throws {StorageError} {@link StorageError}
+ * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+ * @throws {TypeStorageError} {@link TypeStorageError}
+ * @group Contracts
+ */
+export type IStorageAdapter<TType> = {
+    /**
+     * Returns true for the keys that are found otherwise false will be returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    existsMany?<TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, boolean>>;
+    /**
+     * Returns the value for the keys that are found otherwise null will be returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    getMany<TValues extends TType, TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, TValues | null>>;
+    /**
+     * Adds the keys that doesn't exists. Returns true for the keys that doesn't exists otherwise false will be returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    addMany<TValues extends TType, TKeys extends string>(values: Record<TKeys, TValues>): Promise<Record<TKeys, boolean>>;
+    /**
+     * Updates the keys that exists. Returns true for the keys that exists otherwise false will be returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    updateMany<TValues extends TType, TKeys extends string>(values: Record<TKeys, TValues>): Promise<Record<TKeys, boolean>>;
+    /**
+     * Replaces the keys that are found. Adds keys that are not found. Returns true for all the keys that are found otherwise false is returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    putMany?<TValues extends TType, TKeys extends string>(values: Record<TKeys, TValues>): Promise<Record<TKeys, boolean>>;
+    /**
+     * Removes the keys that are found. Returns true for the keys that are found otherwise false is returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    removeMany<TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, boolean>>;
+    /**
+     * If the key is found the value be returned and key will be removed otherwise null will be returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    getAndRemove?<TValue extends TType>(key: string): Promise<TValue | null>;
+    /**
+     * If the key is found the value be returned otherwise valueToAdd will be added and returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    getOrAdd?<TValue extends TType, TExtended extends TType>(key: string, valueToAdd: TExtended): Promise<GetOrAddResult<TValue | TExtended>>;
+    /**
+     * Will increment the existing key with value if found otherwise nonthing occurs. Returns true if key exists otherwise false will be returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     * @throws {TypeStorageError} {@link TypeStorageError}
+     */
+    increment?(key: string, value: number): Promise<boolean>;
+    /**
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    clear(prefix: string): Promise<void>;
+};

package/dist/types/contracts/storage/storage.contract.d.ts

@@ -0,0 +1,148 @@
+/**
+ * @module Storage
+ */
+import { type AnyFunction, type AsyncLazyable, type GetOrAddValue } from "../../_shared/types";
+export type StorageValue<T> = Exclude<T, AnyFunction | undefined | null>;
+/**
+ * @throws {StorageError} {@link StorageError}
+ * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+ * @throws {TypeStorageError} {@link TypeStorageError}
+ * @group Contracts
+ */
+export type IStorage<TType = unknown> = {
+    namespace<TNamespaceType extends TType>(name: string): IStorage<TNamespaceType>;
+    /**
+     * Returns true when key is found otherwise false will be returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    exists(key: string): Promise<boolean>;
+    /**
+     * Returns true for the keys that are found otherwise false will be returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    existsMany<TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, boolean>>;
+    /**
+     * Returns true when key is not found otherwise false will be returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    missing(key: string): Promise<boolean>;
+    /**
+     * Returns true for the keys that are not found otherwise false will be returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    missingMany<TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, boolean>>;
+    /**
+     * Returns the value when key is found otherwise null will be returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    get<TValue extends TType>(key: string): Promise<TValue | null>;
+    /**
+     * Returns the value for the keys that are found otherwise null will be returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    getMany<TValues extends TType, TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, TValues | null>>;
+    /**
+     * Returns the value when key is found otherwise defaultValue will be returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    getOr<TValue extends TType, TExtended extends TType>(key: string, defaultValue: AsyncLazyable<TExtended>): Promise<TValue | TExtended>;
+    /**
+     * Returns the value for the keys that are found otherwise defaultValue will be returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    getOrMany<TValues extends TType, TExtended extends TType, TKeys extends string>(keysWithDefaults: Record<TKeys, AsyncLazyable<TExtended>>): Promise<Record<TKeys, TValues | TExtended>>;
+    /**
+     * Returns the value when key is found otherwise an error will be thrown.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     * @throws {KeyNotFoundStorageError} {@link KeyNotFoundStorageError}
+     */
+    getOrFail<TValue extends TType>(key: string): Promise<TValue>;
+    /**
+     * Adds a key when key doesn't exists. Returns true when key doesn't exists otherwise false will be returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    add<TValue extends TType>(key: string, value: StorageValue<TValue>): Promise<boolean>;
+    /**
+     * Adds the keys that doesn't exists. Returns true for the keys that doesn't exists otherwise false will be returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    addMany<TValues extends TType, TKeys extends string>(values: Record<TKeys, StorageValue<TValues>>): Promise<Record<TKeys, boolean>>;
+    /**
+     * Updates a keys that exists. Returns true when key otherwise false will be returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    update<TValue extends TType>(key: string, value: TValue): Promise<boolean>;
+    /**
+     * Updates the keys that exists. Returns true for the keys that exists otherwise false will be returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    updateMany<TValues extends TType, TKeys extends string>(values: Record<TKeys, TValues>): Promise<Record<TKeys, boolean>>;
+    /**
+     * If the key is found it will replaced. If the key is not found it will just be added. True is returned if the key is found otherwise false will be returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    put<TValue extends TType>(key: string, value: StorageValue<TValue>): Promise<boolean>;
+    /**
+     * Replaces the keys that are found. Adds keys that are not found. Returns true for all the keys that are found otherwise false is returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    putMany<TValues extends TType, TKeys extends string>(values: Record<TKeys, StorageValue<TValues>>): Promise<Record<TKeys, boolean>>;
+    /**
+     * Removes the key when found. Returns true if the key is found otherwise false is returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    remove(key: string): Promise<boolean>;
+    /**
+     * Removes the keys that are found. Returns true for the keys that are found otherwise false is returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    removeMany<TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, boolean>>;
+    /**
+     * If the key is found the value be returned and key will be removed otherwise null will be returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    getAndRemove<TValue extends TType>(key: string): Promise<TValue | null>;
+    /**
+     * If the key is found the value be returned otherwise valueToAdd will be added and returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    getOrAdd<TValue extends TType, TExtended extends TType>(key: string, valueToAdd: AsyncLazyable<StorageValue<GetOrAddValue<TExtended>>>): Promise<TValue | TExtended>;
+    /**
+     * Will increment the existing key with value if found otherwise nonthing will occur. Returns true if key exists otherwise false will be returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     * @throws {TypeStorageError} {@link TypeStorageError}
+     */
+    increment(key: string, value?: number): Promise<boolean>;
+    /**
+     * Will decrement the existing key with value if found otherwise nonthing will occur. Returns true if key exists otherwise false will be returned.
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     * @throws {TypeStorageError} {@link TypeStorageError}
+     */
+    decrement(key: string, value?: number): Promise<boolean>;
+    /**
+     * @throws {StorageError} {@link StorageError}
+     * @throws {UnexpectedStorageError} {@link UnexpectedStorageError}
+     */
+    clear(): Promise<void>;
+};

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

@@ -0,0 +1,5 @@
+export * from "../serializer/_shared/test-utilities/_module";
+export * from "../serializer/mongodb-serializer/_module";
+export * from "../serializer/redis-serializer/_module";
+export * from "../serializer/sql-serializer/_module";
+export * from "../serializer/super-json-serializer/_module";

package/dist/types/serializer/_shared/test-utilities/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../serializer/_shared/test-utilities/serializer.test-suite";

package/dist/types/serializer/_shared/test-utilities/serializer.test-suite.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @module Serializer
+ */
+import { type TestAPI, type ExpectStatic } from "vitest";
+import { type ISerializer } from "../../../contracts/serializer/_module";
+import { type Promisable } from "../../../_shared/types";
+/**
+ * @group Utilities
+ */
+export type SerializerSuiteSettings = {
+    expect: ExpectStatic;
+    test: TestAPI;
+    createAdapter: () => Promisable<ISerializer>;
+};
+/**
+ * @group Utilities
+ */
+export declare function serializerTestSuite(settings: SerializerSuiteSettings): void;

package/dist/types/serializer/mongodb-serializer/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../serializer/mongodb-serializer/mongodb-serializer";

package/dist/types/serializer/mongodb-serializer/mongodb-serializer.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @module Serializer
+ */
+import { type ISerializer } from "../../contracts/serializer/_module";
+/**
+ * @internal
+ */
+export declare class MongodbSerializer implements ISerializer<string | number> {
+    private readonly serializer;
+    constructor(serializer: ISerializer<string>);
+    serialize<TValue>(value: TValue): Promise<string | number>;
+    deserialize<TValue>(value: string | number): Promise<TValue>;
+}

package/dist/types/serializer/redis-serializer/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../serializer/redis-serializer/redis-serializer";

package/dist/types/serializer/redis-serializer/redis-serializer.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @module Serializer
+ */
+import { type ISerializer } from "../../contracts/serializer/_module";
+/**
+ * @internal
+ */
+export declare class RedisSerializer implements ISerializer<string> {
+    private readonly serializer;
+    constructor(serializer: ISerializer<string>);
+    serialize<TValue>(value: TValue): Promise<string>;
+    deserialize<TValue>(value: string): Promise<TValue>;
+}

package/dist/types/serializer/sql-serializer/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../serializer/sql-serializer/sql-serializer";

package/dist/types/serializer/sql-serializer/sql-serializer.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @module Serializer
+ */
+import { type ISerializer } from "../../contracts/serializer/_module";
+/**
+ * @internal
+ */
+export declare class SqlSerializer implements ISerializer<string> {
+    private readonly serializer;
+    constructor(serializer: ISerializer<string>);
+    serialize<TValue>(value: TValue): Promise<string>;
+    deserialize<TValue>(value: string): Promise<TValue>;
+}

package/dist/types/serializer/super-json-serializer/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../serializer/super-json-serializer/super-json-serializer";

package/dist/types/serializer/super-json-serializer/super-json-serializer.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @module Serializer
+ */
+import { type ISerializer } from "../../contracts/serializer/_module";
+import type { SuperJSON } from "superjson";
+/**
+ * @group Adapters
+ */
+export type SuperJsonSerializerSettings = {
+    dedupe?: boolean;
+    registerClass?: (registerClass: SuperJSON["registerClass"]) => void;
+    registerSymbol?: (registerClass: SuperJSON["registerSymbol"]) => void;
+    registerCustom?: (registerClass: SuperJSON["registerCustom"]) => void;
+};
+/**
+ * @group Adapters
+ */
+export declare class SuperJsonSerializer implements ISerializer<string> {
+    private superJson;
+    private dedupe;
+    private registerClass;
+    private registerSymbol;
+    private registerCustom;
+    constructor({ dedupe, registerClass, registerSymbol, registerCustom, }?: SuperJsonSerializerSettings);
+    private static registerBuffer;
+    private static registerUint8Array;
+    private static registerInt8Array;
+    private static registerUint16Array;
+    private static registerInt16Array;
+    private static registerUint32Array;
+    private static registerInt32Array;
+    private static registerFloat32Array;
+    private static registerFloat64Array;
+    private init;
+    serialize<TValue>(value: TValue): Promise<string>;
+    deserialize<TValue>(value: string): Promise<TValue>;
+}

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

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

package/dist/types/storage/_shared/test-utilities/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../storage/_shared/test-utilities/storage.test-suite";

package/dist/types/storage/_shared/test-utilities/storage-api.test-suite.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @module Storage
+ */
+import { type TestAPI, type SuiteAPI, type ExpectStatic, type beforeEach } from "vitest";
+import { type IStorageAdapter } from "../../../contracts/storage/_module";
+import { type Promisable } from "../../../_shared/types";
+/**
+ * @internal
+ */
+export type StorageApiTestSuiteSettings = {
+    expect: ExpectStatic;
+    test: TestAPI;
+    describe: SuiteAPI;
+    beforeEach: typeof beforeEach;
+    createAdapter: () => Promisable<IStorageAdapter<unknown>>;
+};
+/**
+ * @internal
+ */
+export declare function storageApiTestSuite(settings: StorageApiTestSuiteSettings): void;

package/dist/types/storage/_shared/test-utilities/storage-namespace.test-suite.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @module Storage
+ */
+import { type TestAPI, type ExpectStatic, type beforeEach, type SuiteAPI } from "vitest";
+import { type IStorageAdapter } from "../../../contracts/storage/_module";
+import { type Promisable } from "../../../_shared/types";
+/**
+ * @internal
+ */
+export type StorageNamespaceTestSuiteSettings = {
+    expect: ExpectStatic;
+    test: TestAPI;
+    describe: SuiteAPI;
+    beforeEach: typeof beforeEach;
+    createAdapter: () => Promisable<IStorageAdapter<unknown>>;
+};
+/**
+ * @internal
+ */
+export declare function storageNamespaceTestSuite(settings: StorageNamespaceTestSuiteSettings): void;

package/dist/types/storage/_shared/test-utilities/storage-value.test-suite.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @module Storage
+ */
+import { type TestAPI, type SuiteAPI, type ExpectStatic, type beforeEach } from "vitest";
+import { type IStorageAdapter } from "../../../contracts/storage/_module";
+import { type Promisable } from "../../../_shared/types";
+/**
+ * @internal
+ */
+export type StorageValueTestSuiteSettings = {
+    expect: ExpectStatic;
+    test: TestAPI;
+    describe: SuiteAPI;
+    beforeEach: typeof beforeEach;
+    createAdapter: () => Promisable<IStorageAdapter<unknown>>;
+};
+/**
+ * @internal
+ */
+export declare function storageValueTestSuite(settings: StorageValueTestSuiteSettings): void;

package/dist/types/storage/_shared/test-utilities/storage.test-suite.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @module Storage
+ */
+import { type TestAPI, type SuiteAPI, type ExpectStatic, type beforeEach } from "vitest";
+import { type IStorageAdapter } from "../../../contracts/storage/_module";
+import { type Promisable } from "../../../_shared/types";
+/**
+ * @group Utilities
+ */
+export type StorageTestSuiteSettings = {
+    expect: ExpectStatic;
+    test: TestAPI;
+    describe: SuiteAPI;
+    beforeEach: typeof beforeEach;
+    createAdapter: () => Promisable<IStorageAdapter<unknown>>;
+};
+/**
+ * @group Utilities
+ */
+export declare function storageTestSuite(settings: StorageTestSuiteSettings): void;

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * @module Storage
+ */
+import { type IStorageAdapter } from "../../contracts/storage/storage-adapter.contract";
+/**
+ * @group Adapters
+ */
+export declare class MemoryStorageAdapter<TType> implements IStorageAdapter<TType> {
+    private readonly map;
+    constructor(map?: Map<string, TType>);
+    getMany<TValues extends TType, TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, TValues | null>>;
+    addMany<TValues extends TType, TKeys extends string>(values: Record<TKeys, TValues>): Promise<Record<TKeys, boolean>>;
+    updateMany<TValues extends TType, TKeys extends string>(values: Record<TKeys, TValues>): Promise<Record<TKeys, boolean>>;
+    removeMany<TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, boolean>>;
+    clear(prefix: string): Promise<void>;
+}

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

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

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

@@ -0,0 +1,46 @@
+/**
+ * @module Storage
+ */
+import { type ISerializer } from "../../contracts/serializer/_module";
+import type { GetOrAddResult } from "../../_shared/types";
+import { type IInitizable } from "../../_shared/types";
+import { type IStorageAdapter } from "../../contracts/storage/_module";
+import { type Collection, ObjectId } 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>;
+    existsMany<TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, boolean>>;
+    getMany<TValues extends TType, TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, TValues | null>>;
+    addMany<TValues extends TType, TKeys extends string>(values: Record<TKeys, TValues>): Promise<Record<TKeys, boolean>>;
+    private updateOne;
+    updateMany<TValues extends TType, TKeys extends string>(values: Record<TKeys, TValues>): Promise<Record<TKeys, boolean>>;
+    private putOne;
+    putMany<TValues extends TType, TKeys extends string>(values: Record<TKeys, TValues>): Promise<Record<TKeys, boolean>>;
+    private removeOne;
+    removeMany<TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, boolean>>;
+    getAndRemove<TValue extends TType>(key: string): Promise<TValue | null>;
+    getOrAdd<TValue extends TType, TExtended extends TType>(key: string, valueToAdd: TExtended): Promise<GetOrAddResult<TValue | TExtended>>;
+    increment(key: string, value: number): Promise<boolean>;
+    clear(prefix: string): Promise<void>;
+}

package/dist/types/storage/namespace-storage-adapter.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @module Storage
+ */
+import type { AsyncLazyable } from "../_shared/types";
+import { type IStorageAdapter } from "../contracts/storage/_module";
+import type { UsableStorageAdapter } from "../storage/usable-storage-adapter";
+/**
+ * @internal
+ */
+export declare class NamespaceStorageAdapter<TType> implements Required<Omit<IStorageAdapter<TType>, "clear" | "getOrAdd">> {
+    private readonly usableStorageAdapter;
+    private readonly namespace;
+    constructor(usableStorageAdapter: UsableStorageAdapter<TType>, namespace: string);
+    private withNamespace;
+    private withNamespaceArray;
+    private withNamespaceObject;
+    private withoutNamespace;
+    private withoutNamespaceObject;
+    existsMany<TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, boolean>>;
+    getMany<TValues extends TType, TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, TValues | null>>;
+    addMany<TValues extends TType, TKeys extends string>(values: Record<TKeys, TValues>): Promise<Record<TKeys, boolean>>;
+    updateMany<TValues extends TType, TKeys extends string>(values: Record<TKeys, TValues>): Promise<Record<TKeys, boolean>>;
+    putMany<TValues extends TType, TKeys extends string>(values: Record<TKeys, TValues>): Promise<Record<TKeys, boolean>>;
+    removeMany<TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, boolean>>;
+    getAndRemove<TValue extends TType>(key: string): Promise<TValue | null>;
+    getOrAdd<TValue extends TType, TExtended extends TType>(key: string, valueToAdd: AsyncLazyable<TExtended>): Promise<TValue | TExtended>;
+    increment(key: string, value: number): Promise<boolean>;
+    decrement(key: string, value: number): Promise<boolean>;
+    clear(): Promise<void>;
+}

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

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

package/dist/types/storage/redis-storage-adapter/redis-storage-adapter.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @module Storage
+ */
+import { type ISerializer } from "../../contracts/serializer/_module";
+import { type IStorageAdapter } from "../../contracts/storage/_module";
+import type Redis from "ioredis";
+import { type Result } from "ioredis";
+import type { GetOrAddResult } from "../../_shared/types";
+declare module "ioredis" {
+    interface RedisCommander<Context> {
+        daiso_storage_increment(key: string, number: string): Result<number, Context>;
+        daiso_storage_put(key: string, value: string): Result<string, Context>;
+        daiso_storage_getOrAdd(key: string, valueToAdd: string): Result<string, Context>;
+    }
+}
+/**
+ * @group Adapters
+ */
+export type RedisStorageAdapterSettings = {
+    serializer?: ISerializer<string>;
+};
+/**
+ * @group Adapters
+ */
+export declare class RedisStorageAdapter<TType> implements IStorageAdapter<TType> {
+    private readonly client;
+    private serializer;
+    constructor(client: Redis, { serializer, }?: RedisStorageAdapterSettings);
+    private initIncrementCommand;
+    private initPutCommand;
+    existsMany<TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, boolean>>;
+    getMany<TValues extends TType, TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, TValues | null>>;
+    addMany<TValues extends TType, TKeys extends string>(values: Record<TKeys, TValues>): Promise<Record<TKeys, boolean>>;
+    updateMany<TValues extends TType, TKeys extends string>(values: Record<TKeys, TValues>): Promise<Record<TKeys, boolean>>;
+    putMany<TValues extends TType, TKeys extends string>(values: Record<TKeys, TValues>): Promise<Record<TKeys, boolean>>;
+    removeMany<TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, boolean>>;
+    getAndRemove<TValue extends TType>(key: string): Promise<TValue | null>;
+    getOrAdd<TValue extends TType, TExtended extends TType>(key: string, valueToAdd: TExtended): Promise<GetOrAddResult<TValue | TExtended>>;
+    increment(key: string, value: number): Promise<boolean>;
+    clear(prefix: string): Promise<void>;
+}

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

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

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

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

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

@@ -0,0 +1,42 @@
+/**
+ * @module Storage
+ */
+import { type IStorageAdapter } from "../../../contracts/storage/storage-adapter.contract";
+import { type Generated, type Kysely } from "kysely";
+import { type ISerializer } from "../../../contracts/serializer/_module";
+import type { GetOrAddResult } from "../../../_shared/types";
+import { type IInitizable } from "../../../_shared/types";
+/**
+ * @internal
+ */
+type BaseSqliteStorageTable = {
+    key: string;
+    value: string;
+    hasBeenUpdated: Generated<1 | 0>;
+};
+/**
+ * @internal
+ */
+type BaseSqliteTables = {
+    storage: BaseSqliteStorageTable;
+};
+/**
+ * @internal
+ */
+export declare class BaseSqliteStorageAdapter<TType> implements IStorageAdapter<TType>, IInitizable {
+    private readonly db;
+    private readonly serializer;
+    constructor(db: Kysely<BaseSqliteTables>, serializer: ISerializer<string>);
+    init(): Promise<void>;
+    existsMany<TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, boolean>>;
+    getMany<TValues extends TType, TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, TValues | null>>;
+    addMany<TValues extends TType, TKeys extends string>(values: Record<TKeys, TValues>): Promise<Record<TKeys, boolean>>;
+    updateMany<TValues extends TType, TKeys extends string>(values: Record<TKeys, TValues>): Promise<Record<TKeys, boolean>>;
+    removeMany<TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, boolean>>;
+    getAndRemove<TValue extends TType>(key: string): Promise<TValue | null>;
+    getOrAdd<TValue extends TType, TExtended extends TType>(key: string, valueToAdd: TExtended): Promise<GetOrAddResult<TValue | TExtended>>;
+    putMany<TValues extends TType, TKeys extends string>(values: Record<TKeys, TValues>): Promise<Record<TKeys, boolean>>;
+    increment(key: string, value: number): Promise<boolean>;
+    clear(prefix: string): Promise<void>;
+}
+export {};

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

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