@daiso-tech/core 0.22.2 → 0.24.0

package/dist/cache/implementations/adapters/libsql-cache-adapter/libsql-cache-adapter.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @module Cache
+ */
+import { type ICacheAdapter } from "../../../../cache/contracts/cache-adapter.contract.js";
+import type { TimeSpan, IDeinitizable, IInitizable } from "../../../../utilities/_module-exports.js";
+import type { ISerde } from "../../../../serde/contracts/_module-exports.js";
+import type { Client } from "@libsql/client";
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/implementations/adapters"```
+ * @group Adapters
+ */
+export type LibsqlCacheAdapterSettings = {
+    database: Client;
+    tableName?: string;
+    serde: ISerde<string>;
+    enableTransactions?: boolean;
+    expiredKeysRemovalInterval?: TimeSpan;
+    shouldRemoveExpiredKeys?: boolean;
+    rootGroup: string;
+};
+/**
+ * To utilize the <i>LibsqlCacheAdapter</i>, you must install the <i>"@libsql/client"</i> package and supply a <i>{@link ISerde | ISerde<string> }</i>, with an adapter like <i>{@link SuperJsonSerdeAdapter}</i>.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/implementations/adapters"```
+ * @group Adapters
+ */
+export declare class LibsqlCacheAdapter<TType = unknown> implements ICacheAdapter<TType>, IInitizable, IDeinitizable {
+    private readonly cacheAdapter;
+    /***
+     * @example
+     * ```ts
+     * import { LibsqlCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     * import { Serde } from "@daiso-tech/core/serde/implementations/derivables";
+     * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/implementations/adapters";
+     * import { createClient } from "@libsql/client";
+     *
+     * (async () => {
+     *   const database = createClient({ url: "file:local.db" });
+     *   const serde = new Serde(new SuperJsonSerdeAdapter());
+     *   const cacheAdapter = new LibsqlCacheAdapter({
+     *     database,
+     *     serde,
+     *     rootGroup: "@global"
+     *   });
+     *   await cacheAdapter.init();
+     * })();
+     * ```
+     */
+    constructor(settings: LibsqlCacheAdapterSettings);
+    getGroup(): string;
+    withGroup(group: string): ICacheAdapter<TType>;
+    removeExpiredKeys(): Promise<void>;
+    /**
+     * Removes the table where the cache values are stored and removes the table indexes.
+     * Note all cache data will be removed.
+     */
+    deInit(): Promise<void>;
+    /**
+     * Creates the table where the cache values are stored and it's related indexes.
+     * Note the <i>init</i> method needs to be called before using the adapter.
+     */
+    init(): Promise<void>;
+    get(key: string): Promise<TType | null>;
+    add(key: string, value: TType, ttl: TimeSpan | null): Promise<boolean>;
+    update(key: string, value: TType): Promise<boolean>;
+    put(key: string, value: TType, ttl: TimeSpan | null): Promise<boolean>;
+    remove(key: string): Promise<boolean>;
+    increment(key: string, value: number): Promise<boolean>;
+    clear(): Promise<void>;
+}

package/dist/cache/implementations/adapters/libsql-cache-adapter/libsql-cache-adapter.js

@@ -0,0 +1,104 @@
+/**
+ * @module Cache
+ */
+import {} from "../../../../cache/contracts/cache-adapter.contract.js";
+import { KyselySqliteCacheAdapter } from "../../../../cache/implementations/adapters/kysely-sqlite-cache-adapter/_module.js";
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+import { SuperJsonSerdeAdapter } from "../../../../serde/implementations/adapters/_module-exports.js";
+import { Kysely } from "kysely";
+import { LibsqlDialect } from "@libsql/kysely-libsql";
+import { KyselyTableNameTransformerPlugin } from "../../../../utilities/_module-exports.js";
+/**
+ * To utilize the <i>LibsqlCacheAdapter</i>, you must install the <i>"@libsql/client"</i> package and supply a <i>{@link ISerde | ISerde<string> }</i>, with an adapter like <i>{@link SuperJsonSerdeAdapter}</i>.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/implementations/adapters"```
+ * @group Adapters
+ */
+export class LibsqlCacheAdapter {
+    cacheAdapter;
+    /***
+     * @example
+     * ```ts
+     * import { LibsqlCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     * import { Serde } from "@daiso-tech/core/serde/implementations/derivables";
+     * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/implementations/adapters";
+     * import { createClient } from "@libsql/client";
+     *
+     * (async () => {
+     *   const database = createClient({ url: "file:local.db" });
+     *   const serde = new Serde(new SuperJsonSerdeAdapter());
+     *   const cacheAdapter = new LibsqlCacheAdapter({
+     *     database,
+     *     serde,
+     *     rootGroup: "@global"
+     *   });
+     *   await cacheAdapter.init();
+     * })();
+     * ```
+     */
+    constructor(settings) {
+        const { database, tableName = "cache", serde, enableTransactions = false, expiredKeysRemovalInterval, shouldRemoveExpiredKeys, rootGroup, } = settings;
+        this.cacheAdapter = new KyselySqliteCacheAdapter({
+            db: new Kysely({
+                dialect: new LibsqlDialect({
+                    client: database,
+                }),
+                plugins: [
+                    new KyselyTableNameTransformerPlugin({
+                        cache: tableName,
+                    }),
+                ],
+            }),
+            serde,
+            enableTransactions,
+            expiredKeysRemovalInterval,
+            shouldRemoveExpiredKeys,
+            rootGroup,
+        });
+    }
+    getGroup() {
+        return this.cacheAdapter.getGroup();
+    }
+    withGroup(group) {
+        return this.cacheAdapter.withGroup(group);
+    }
+    async removeExpiredKeys() {
+        await this.cacheAdapter.removeExpiredKeys();
+    }
+    /**
+     * Removes the table where the cache values are stored and removes the table indexes.
+     * Note all cache data will be removed.
+     */
+    async deInit() {
+        await this.cacheAdapter.deInit();
+    }
+    /**
+     * Creates the table where the cache values are stored and it's related indexes.
+     * Note the <i>init</i> method needs to be called before using the adapter.
+     */
+    async init() {
+        await this.cacheAdapter.init();
+    }
+    async get(key) {
+        return await this.cacheAdapter.get(key);
+    }
+    async add(key, value, ttl) {
+        return await this.cacheAdapter.add(key, value, ttl);
+    }
+    async update(key, value) {
+        return await this.cacheAdapter.update(key, value);
+    }
+    async put(key, value, ttl) {
+        return await this.cacheAdapter.put(key, value, ttl);
+    }
+    async remove(key) {
+        return await this.cacheAdapter.remove(key);
+    }
+    async increment(key, value) {
+        return await this.cacheAdapter.increment(key, value);
+    }
+    async clear() {
+        await this.cacheAdapter.clear();
+    }
+}
+//# sourceMappingURL=libsql-cache-adapter.js.map

package/dist/cache/implementations/adapters/libsql-cache-adapter/libsql-cache-adapter.js.map

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

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

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

package/dist/cache/implementations/adapters/memory-cache-adapter/_module.js

@@ -0,0 +1,2 @@
+export * from "../../../../cache/implementations/adapters/memory-cache-adapter/memory-cache-adapter.js";
+//# sourceMappingURL=_module.js.map

package/dist/cache/implementations/adapters/memory-cache-adapter/_module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../../src/cache/implementations/adapters/memory-cache-adapter/_module.ts"],"names":[],"mappings":"AAAA,cAAc,+EAA+E,CAAC"}

package/dist/cache/implementations/adapters/memory-cache-adapter/memory-cache-adapter.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @module Cache
+ */
+import { type ICacheAdapter } from "../../../../cache/contracts/cache-adapter.contract.js";
+import { type TimeSpan } from "../../../../utilities/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/implementations/adapters"```
+ * @group Adapters
+ */
+export type MemoryCacheAdapterSettings = {
+    rootGroup: string;
+    map?: Map<string, unknown>;
+};
+/**
+ * To utilize the <i>MemoryCacheAdapter</i>, you must create instance of it.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/implementations/adapters"```
+ * @group Adapters
+ */
+export declare class MemoryCacheAdapter<TType = unknown> implements ICacheAdapter<TType> {
+    private readonly group;
+    private readonly timeoutMap;
+    private readonly map;
+    /**
+     *  @example
+     * ```ts
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     *
+     * const cacheAdapter = new MemoryCacheAdapter({
+     *   rootGroup: "@cache"
+     * });
+     * ```
+     * You can also provide an <i>Map</i>.
+     * @example
+     * ```ts
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     *
+     * const map = new Map<any, any>();
+     * const cacheAdapter = new MemoryCacheAdapter({
+     *   rootGroup: "@cache",
+     *   map
+     * });
+     * ```
+     */
+    constructor(settings: MemoryCacheAdapterSettings);
+    private getPrefix;
+    private withPrefix;
+    get(key: string): Promise<TType | null>;
+    add(key: string, value: TType, ttl: TimeSpan | null): Promise<boolean>;
+    update(key: string, value: TType): Promise<boolean>;
+    put(key: string, value: TType, ttl: TimeSpan | null): Promise<boolean>;
+    remove(key: string): Promise<boolean>;
+    increment(key: string, value: number): Promise<boolean>;
+    clear(): Promise<void>;
+    getGroup(): string;
+    withGroup(group: string): ICacheAdapter<TType>;
+}

package/dist/cache/implementations/adapters/memory-cache-adapter/memory-cache-adapter.js

@@ -0,0 +1,119 @@
+/* eslint-disable @typescript-eslint/require-await */
+/**
+ * @module Cache
+ */
+import { TypeCacheError } from "../../../../cache/contracts/cache.errors.js";
+import {} from "../../../../cache/contracts/cache-adapter.contract.js";
+import { simplifyOneOrMoreStr, } from "../../../../utilities/_module-exports.js";
+/**
+ * To utilize the <i>MemoryCacheAdapter</i>, you must create instance of it.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/implementations/adapters"```
+ * @group Adapters
+ */
+export class MemoryCacheAdapter {
+    group;
+    timeoutMap = new Map();
+    map;
+    /**
+     *  @example
+     * ```ts
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     *
+     * const cacheAdapter = new MemoryCacheAdapter({
+     *   rootGroup: "@cache"
+     * });
+     * ```
+     * You can also provide an <i>Map</i>.
+     * @example
+     * ```ts
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     *
+     * const map = new Map<any, any>();
+     * const cacheAdapter = new MemoryCacheAdapter({
+     *   rootGroup: "@cache",
+     *   map
+     * });
+     * ```
+     */
+    constructor(settings) {
+        const { rootGroup, map = new Map() } = settings;
+        this.map = map;
+        this.group = rootGroup;
+    }
+    getPrefix() {
+        return simplifyOneOrMoreStr([this.group, "__KEY__"]);
+    }
+    withPrefix(key) {
+        return simplifyOneOrMoreStr([this.getPrefix(), key]);
+    }
+    async get(key) {
+        key = this.withPrefix(key);
+        return this.map.get(key) ?? null;
+    }
+    async add(key, value, ttl) {
+        key = this.withPrefix(key);
+        const hasNotKey = !this.map.has(key);
+        if (hasNotKey) {
+            this.map.set(key, value);
+        }
+        if (hasNotKey && ttl !== null) {
+            this.timeoutMap.set(key, setTimeout(() => {
+                this.map.delete(key);
+                this.timeoutMap.delete(key);
+            }, ttl.toMilliseconds()));
+        }
+        return hasNotKey;
+    }
+    async update(key, value) {
+        key = this.withPrefix(key);
+        const hasKey = this.map.has(key);
+        if (hasKey) {
+            this.map.set(key, value);
+        }
+        return hasKey;
+    }
+    async put(key, value, ttl) {
+        const hasKey = await this.remove(key);
+        await this.add(key, value, ttl);
+        return hasKey;
+    }
+    async remove(key) {
+        key = this.withPrefix(key);
+        clearTimeout(this.timeoutMap.get(key));
+        this.timeoutMap.delete(key);
+        return this.map.delete(key);
+    }
+    async increment(key, value) {
+        key = this.withPrefix(key);
+        const prevValue = this.map.get(key);
+        const hasKey = prevValue !== undefined;
+        if (hasKey) {
+            if (typeof prevValue !== "number") {
+                throw new TypeCacheError(`Unable to increment or decrement none number type key "${key}"`);
+            }
+            const newValue = prevValue + value;
+            this.map.set(key, newValue);
+        }
+        return hasKey;
+    }
+    async clear() {
+        for (const key of this.map.keys()) {
+            if (key.startsWith(this.getPrefix())) {
+                clearTimeout(this.timeoutMap.get(key));
+                this.timeoutMap.delete(key);
+                this.map.delete(key);
+            }
+        }
+    }
+    getGroup() {
+        return this.group;
+    }
+    withGroup(group) {
+        return new MemoryCacheAdapter({
+            map: this.map,
+            rootGroup: simplifyOneOrMoreStr([this.group, group]),
+        });
+    }
+}
+//# sourceMappingURL=memory-cache-adapter.js.map

package/dist/cache/implementations/adapters/memory-cache-adapter/memory-cache-adapter.js.map

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

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

@@ -0,0 +1 @@
+export * from "../../../../cache/implementations/adapters/mongodb-cache-adapter/mongodb-cache-adapter.js";

package/dist/cache/implementations/adapters/mongodb-cache-adapter/_module.js

@@ -0,0 +1,2 @@
+export * from "../../../../cache/implementations/adapters/mongodb-cache-adapter/mongodb-cache-adapter.js";
+//# sourceMappingURL=_module.js.map

package/dist/cache/implementations/adapters/mongodb-cache-adapter/_module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../../src/cache/implementations/adapters/mongodb-cache-adapter/_module.ts"],"names":[],"mappings":"AAAA,cAAc,iFAAiF,CAAC"}

package/dist/cache/implementations/adapters/mongodb-cache-adapter/mongodb-cache-adapter.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @module Cache
+ */
+import { type ICacheAdapter } from "../../../../cache/contracts/cache-adapter.contract.js";
+import type { IDeinitizable } from "../../../../utilities/_module-exports.js";
+import { type TimeSpan, type IInitizable } from "../../../../utilities/_module-exports.js";
+import type { CollectionOptions, Db } from "mongodb";
+import type { ISerde } from "../../../../serde/contracts/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/implementations/adapters"```
+ * @group Adapters
+ */
+export type MongodbCacheAdapterSettings = {
+    database: Db;
+    serde: ISerde<string>;
+    rootGroup: string;
+    collectionName?: string;
+    collectionSettings?: CollectionOptions;
+};
+/**
+ * To utilize the <i>MongodbCacheAdapter</i>, you must install the <i>"mongodb"</i> package and supply a <i>{@link ISerde | ISerde<string> }</i>, with an adapter like <i>{@link SuperJsonSerdeAdapter}</i>.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/implementations/adapters"```
+ * @group Adapters
+ */
+export declare class MongodbCacheAdapter<TType = unknown> implements ICacheAdapter<TType>, IInitizable, IDeinitizable {
+    private static isMongodbIncrementError;
+    private readonly mongodbSerde;
+    private readonly group;
+    private readonly baseSerde;
+    private readonly database;
+    private readonly collection;
+    private readonly collectionName;
+    private readonly collectionSettings?;
+    /**
+     * @example
+     * ```ts
+     * import { MongodbCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     * import { Serde } from "@daiso-tech/core/serde/implementations/derivables";
+     * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/implementations/adapters"
+     * import { MongoClient } from "mongodb";
+     *
+     * (async () => {
+     *   const client = await MongoClient.connect("YOUR_MONGODB_CONNECTION_STRING");
+     *   const database = client.db("database");
+     *   const serde = new Serde(new SuperJsonSerdeAdapter());
+     *   const cacheAdapter = new MongodbCacheAdapter({
+     *     database,
+     *     serde,
+     *     rootGroup: "@global"
+     *   });
+     *   await cacheAdapter.init();
+     * })();
+     * ```
+     */
+    constructor(settings: MongodbCacheAdapterSettings);
+    getGroup(): string;
+    withGroup(group: string): ICacheAdapter<TType>;
+    /**
+     * Creates all related indexes.
+     * Note the <i>init</i> method needs to be called before using the adapter.
+     */
+    init(): Promise<void>;
+    /**
+     * Removes the collection where the cache values are stored and all it's related indexes.
+     * Note all cache data will be removed.
+     */
+    deInit(): Promise<void>;
+    get(key: string): Promise<TType | null>;
+    add(key: string, value: TType, ttl: TimeSpan | null): Promise<boolean>;
+    update(key: string, value: TType): Promise<boolean>;
+    put(key: string, value: TType, ttl: TimeSpan | null): Promise<boolean>;
+    remove(key: string): Promise<boolean>;
+    increment(key: string, value: number): Promise<boolean>;
+    clear(): Promise<void>;
+}