@daiso-tech/core 0.2.1 → 0.4.0

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

@@ -0,0 +1,30 @@
+/**
+ * @module Storage
+ */
+import { type ISerializer } from "../../../_module";
+import { type IStorageAdapter } from "../../../contracts/storage/_module";
+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 {
+    private readonly storageAdapter;
+    constructor(client: Client, { tableName, serializer, }?: LibsqlStorageAdapterSettings);
+    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>>;
+    updateMany<TValues extends TType, TKeys extends string>(values: Record<TKeys, TValues>): Promise<Record<TKeys, boolean>>;
+    addMany<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>>;
+    increment(key: string, value: number): Promise<boolean>;
+    clear(prefix: string): Promise<void>;
+}

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

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

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

@@ -0,0 +1,30 @@
+/**
+ * @module Storage
+ */
+import { type ISerializer } from "../../../_module";
+import { type IStorageAdapter } from "../../../contracts/storage/_module";
+import { type Database } from "better-sqlite3";
+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 {
+    private readonly storageAdapter;
+    constructor(database: Database, { tableName, serializer, }?: SqliteStorageAdapterSettings);
+    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>>;
+    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>>;
+    increment(key: string, value: number): Promise<boolean>;
+    clear(prefix: string): Promise<void>;
+}

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

@@ -0,0 +1,38 @@
+/**
+ * @module Storage
+ */
+import { type IStorageAdapter } from "../contracts/storage/_module";
+import { type StorageValue, type IStorage } from "../contracts/storage/_module";
+import { type AsyncLazyable, type GetOrAddValue } from "../_shared/types";
+export type StorageSettings = {
+    namespace?: string;
+};
+export declare class Storage<TType = unknown> implements IStorage<TType> {
+    private readonly storageAdapter;
+    private readonly namespaceStorageAdapter;
+    private readonly settings;
+    constructor(storageAdapter: IStorageAdapter<TType>, settings?: StorageSettings);
+    namespace<TNamespaceType extends TType>(name: string): IStorage<TNamespaceType>;
+    exists(key: string): Promise<boolean>;
+    existsMany<TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, boolean>>;
+    missing(key: string): Promise<boolean>;
+    missingMany<TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, boolean>>;
+    get<TValue extends TType>(key: string): Promise<TValue | null>;
+    getMany<TValues extends TType, TKeys extends string>(keys: TKeys[]): Promise<Record<TKeys, TValues | null>>;
+    getOr<TValue extends TType, TExtended extends TType>(key: string, defaultValue: AsyncLazyable<TExtended>): Promise<TValue | TExtended>;
+    getOrMany<TValues extends TType, TExtended extends TType, TKeys extends string>(keysWithDefaults: Record<TKeys, AsyncLazyable<TExtended>>): Promise<Record<TKeys, TValues | TExtended>>;
+    getOrFail<TValue extends TType>(key: string): Promise<TValue>;
+    add<TValue extends TType>(key: string, value: StorageValue<TValue>): Promise<boolean>;
+    addMany<TValues extends TType, TKeys extends string>(values: Record<TKeys, StorageValue<TValues>>): Promise<Record<TKeys, boolean>>;
+    update<TValue extends TType>(key: string, value: TValue): Promise<boolean>;
+    updateMany<TValues extends TType, TKeys extends string>(values: Record<TKeys, TValues>): Promise<Record<TKeys, boolean>>;
+    put<TValue extends TType>(key: string, value: StorageValue<TValue>): Promise<boolean>;
+    putMany<TValues extends TType, TKeys extends string>(values: Record<TKeys, StorageValue<TValues>>): Promise<Record<TKeys, boolean>>;
+    remove(key: string): Promise<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<StorageValue<GetOrAddValue<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/usable-storage-adapter.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @module Storage
+ */
+import type { AsyncLazyable, GetOrAddResult } from "../_shared/types";
+import { type IStorageAdapter } from "../contracts/storage/_module";
+/**
+ * @internal
+ */
+export declare class UsableStorageAdapter<TType> implements Required<Omit<IStorageAdapter<TType>, "getOrAdd">> {
+    private readonly storageAdapter;
+    constructor(storageAdapter: IStorageAdapter<TType>);
+    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>>;
+    increment(key: string, value: number): Promise<boolean>;
+    getAndRemove<TValue extends TType>(key: string): Promise<TValue | null>;
+    getOrAdd<TValue extends TType, TExtended extends TType>(key: string, valueToAdd: AsyncLazyable<TExtended>): Promise<GetOrAddResult<TValue | TExtended>>;
+    clear(prefix: string): Promise<void>;
+}

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

@@ -0,0 +1 @@
+export * from "../utilities/time-span/_module";

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

@@ -0,0 +1 @@
+export * from "../../utilities/time-span/time-span";

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

@@ -0,0 +1,50 @@
+/**
+ * @module Utilities
+ */
+/**
+ * The <i>TimeSpan</i> class is used for representing time interval that is the difference between two times measured in a number of days, hours, minutes, and seconds.
+ * <i>TimeSpan</i> cannot be negative.
+ */
+export declare class TimeSpan {
+    private readonly milliseconds;
+    private static secondInMilliseconds;
+    private static minuteInMilliseconds;
+    private static hourInMilliseconds;
+    private static dayInMilliseconds;
+    private constructor();
+    static fromMilliseconds(milliseconds: number): TimeSpan;
+    static fromSeconds(seconds: number): TimeSpan;
+    static fromMinutes(minutes: number): TimeSpan;
+    static fromHours(hours: number): TimeSpan;
+    static fromDays(days: number): TimeSpan;
+    static fromTimeSpan(timeSpan: TimeSpan): TimeSpan;
+    static fromDateRange(from: Date, to: Date): TimeSpan;
+    addMilliseconds(milliseconds: number): TimeSpan;
+    addSeconds(seconds: number): TimeSpan;
+    addMinutes(minutes: number): TimeSpan;
+    addHours(hours: number): TimeSpan;
+    addDays(days: number): TimeSpan;
+    addTimeSpan(timeSpan: TimeSpan): TimeSpan;
+    subtractMilliseconds(milliseconds: number): TimeSpan;
+    subtractSeconds(seconds: number): TimeSpan;
+    subtractMinutes(minutes: number): TimeSpan;
+    subtractHours(hours: number): TimeSpan;
+    subtractDays(days: number): TimeSpan;
+    subtractTimeSpan(timeSpan: TimeSpan): TimeSpan;
+    multiply(value: number): TimeSpan;
+    divide(value: number): TimeSpan;
+    toMilliseconds(): number;
+    toSeconds(): number;
+    toMinutes(): number;
+    toHours(): number;
+    toDays(): number;
+    toUTCTimestamp(): number;
+    /**
+     * Will return endDate relative to a given <i>startDate</i> argument.
+     */
+    toEndDate(startDate: Date): Date;
+    /**
+     * Will return startDate relative to a given <i>endDate</i> argument.
+     */
+    toStartDate(endDate: Date): Date;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@daiso-tech/core",
     "private": false,
-    "version": "0.2.1",
+    "version": "0.4.0",
     "author": "Yousif Abdulkarim",
     "license": "Apache-2.0",
     "main": "./dist/cjs/_module.js",
@@ -13,12 +13,13 @@
         "url": "https://github.com/yousif-khalil-abdulkarim/daiso-core.git"
     },
     "keywords": [
-        "Collections",
-        "Arrays",
-        "Iterables",
+        "Collection",
+        "Array",
         "Iterable",
-        "Async iterables",
-        "AsyncIterable"
+        "AsyncIterable",
+        "Cache",
+        "Mongodb",
+        "Redis"
     ],
     "files": [
         "./dist"
@@ -38,9 +39,14 @@
     },
     "devDependencies": {
         "@changesets/cli": "^2.27.7",
+        "@libsql/client": "^0.14.0",
+        "@testcontainers/mongodb": "^10.13.2",
+        "@testcontainers/redis": "^10.13.2",
+        "@types/better-sqlite3": "^7.6.11",
         "@typescript-eslint/eslint-plugin": "^8.1.0",
         "@typescript-eslint/parser": "^8.1.0",
         "@vitest/eslint-plugin": "^1.0.3",
+        "better-sqlite3": "^11.5.0",
         "eslint": "^8.57.0",
         "eslint-config-prettier": "^9.1.0",
         "eslint-plugin-no-relative-import-paths": "^1.5.5",
@@ -49,6 +55,8 @@
         "eslint-plugin-tsdoc": "^0.3.0",
         "eslint-plugin-typescript-enum": "^2.1.0",
         "eslint-plugin-vitest": "^0.5.4",
+        "ioredis": "^5.4.1",
+        "mongodb": "^6.10.0",
         "rimraf": "^6.0.1",
         "tsc-alias": "^1.8.10",
         "typedoc": "^0.26.5",
@@ -57,5 +65,32 @@
         "typescript": "^5.5.4",
         "vite-tsconfig-paths": "^4.3.2",
         "vitest": "^2.0.5"
+    },
+    "peerDependencies": {
+        "@libsql/client": "^0.4.1",
+        "better-sqlite3": "^11.5.0",
+        "ioredis": "^5.4.1",
+        "mongodb": "^6.10.0"
+    },
+    "peerDependenciesMeta": {
+        "mongodb": {
+            "optional": true
+        },
+        "ioredis": {
+            "optional": true
+        },
+        "better-sqlite3": {
+            "optional": true
+        },
+        "@libsql/client": {
+            "optional": true
+        }
+    },
+    "dependencies": {
+        "@libsql/kysely-libsql": "^0.4.1",
+        "escape-string-regexp": "^5.0.0",
+        "kysely": "^0.27.4",
+        "superjson": "^2.2.1",
+        "uuid": "^11.0.2"
     }
 }