@daiso-tech/core 0.22.2 → 0.24.0

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

@@ -0,0 +1,205 @@
+/**
+ * @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";
+import { ReplyError } from "ioredis";
+import { RedisSerde, } from "../../../../serde/implementations/adapters/_module-exports.js";
+/**
+ * @internal
+ */
+class ClearIterable {
+    client;
+    pattern;
+    constructor(client, pattern) {
+        this.client = client;
+        this.pattern = pattern;
+    }
+    async *[Symbol.asyncIterator]() {
+        let coursor = 0;
+        do {
+            const [_coursor, elements] = await this.client.scan(coursor, "MATCH", this.pattern);
+            if (elements.length === 0) {
+                return;
+            }
+            await this.client.del(elements);
+            coursor++;
+            yield undefined;
+        } while (coursor !== 0);
+    }
+}
+/**
+ * @internal
+ */
+function escapeRedisChars(value) {
+    const replacements = {
+        ",": "\\,",
+        ".": "\\.",
+        "<": "\\<",
+        ">": "\\>",
+        "{": "\\{",
+        "}": "\\}",
+        "[": "\\[",
+        "]": "\\]",
+        '"': '\\"',
+        "'": "\\'",
+        ":": "\\:",
+        ";": "\\;",
+        "!": "\\!",
+        "@": "\\@",
+        "#": "\\#",
+        $: "\\$",
+        "%": "\\%",
+        "^": "\\^",
+        "&": "\\&",
+        "*": "\\*",
+        "(": "\\(",
+        ")": "\\)",
+        "-": "\\-",
+        "+": "\\+",
+        "=": "\\=",
+        "~": "\\~",
+    };
+    return value.replace(/,|\.|<|>|\{|\}|\[|\]|"|'|:|;|!|@|#|\$|%|\^|&|\*|\(|\)|-|\+|=|~/g, (chunk) => {
+        const item = replacements[chunk];
+        if (item === undefined) {
+            throw new Error("Encounterd none existing field");
+        }
+        return item;
+    });
+}
+/**
+ * To utilize the <i>RedisCacheAdapter</i>, you must install the <i>"ioredis"</i> package and supply a <i>{@link ISerde | ISerde<string> }</i>, with adapter like <i>{@link SuperJsonSerdeAdapter}</i>.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/implementations/adapters"```
+ * @group Adapters
+ */
+export class RedisCacheAdapter {
+    static isRedisTypeError(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types
+    value) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+        return (value instanceof ReplyError &&
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access
+            value.message.includes("ERR value is not a valid float"));
+    }
+    baseSerde;
+    redisSerde;
+    group;
+    database;
+    /**
+     * @example
+     * ```ts
+     * import { RedisCacheAdapter } 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 Redis from "ioredis";
+     *
+     * const database = new Redis("YOUR_REDIS_CONNECTION_STRING");
+     * const serde = new Serde(new SuperJsonSerdeAdapter());
+     * const cacheAdapter = new RedisCacheAdapter({
+     *   database,
+     *   serde,
+     *   rootGroup: "@global"
+     * });
+     * ```
+     */
+    constructor(settings) {
+        const { database, serde, rootGroup } = settings;
+        this.database = database;
+        this.group = rootGroup;
+        this.baseSerde = serde;
+        this.redisSerde = new RedisSerde(serde);
+        this.initIncrementCommand();
+    }
+    getPrefix() {
+        return simplifyOneOrMoreStr([this.group, "__KEY__"]);
+    }
+    withPrefix(key) {
+        return simplifyOneOrMoreStr([this.getPrefix(), key]);
+    }
+    async get(key) {
+        key = this.withPrefix(key);
+        const value = await this.database.get(key);
+        if (value === null) {
+            return null;
+        }
+        return await this.redisSerde.deserialize(value);
+    }
+    async add(key, value, ttl) {
+        key = this.withPrefix(key);
+        if (ttl === null) {
+            const result = await this.database.set(key, this.redisSerde.serialize(value), "NX");
+            return result === "OK";
+        }
+        const result = await this.database.set(key, this.redisSerde.serialize(value), "PX", ttl.toMilliseconds(), "NX");
+        return result === "OK";
+    }
+    async update(key, value) {
+        key = this.withPrefix(key);
+        const result = await this.database.set(key, this.redisSerde.serialize(value), "XX");
+        return result === "OK";
+    }
+    async put(key, value, ttl) {
+        key = this.withPrefix(key);
+        if (ttl === null) {
+            const result = await this.database.set(key, this.redisSerde.serialize(value), "GET");
+            return result !== null;
+        }
+        const result = await this.database.set(key, this.redisSerde.serialize(value), "PX", ttl.toMilliseconds(), "GET");
+        return result !== null;
+    }
+    async remove(key) {
+        key = this.withPrefix(key);
+        const result = await this.database.del(key);
+        return result === 1;
+    }
+    initIncrementCommand() {
+        if (typeof this.database.daiso_cache_increment === "function") {
+            return;
+        }
+        this.database.defineCommand("daiso_cache_increment", {
+            numberOfKeys: 1,
+            lua: `
+                local hasKey = redis.call("exists", KEYS[1])
+        
+                if hasKey == 1 then
+                    redis.call("incrbyfloat", KEYS[1], tonumber(ARGV[1]))
+                end
+                
+                return hasKey
+                `,
+        });
+    }
+    async increment(key, value) {
+        try {
+            key = this.withPrefix(key);
+            const redisResult = await this.database.daiso_cache_increment(key, this.redisSerde.serialize(value));
+            const keyExists = redisResult === 1;
+            return keyExists;
+        }
+        catch (error) {
+            if (!RedisCacheAdapter.isRedisTypeError(error)) {
+                throw error;
+            }
+            throw new TypeCacheError(`Unable to increment or decrement none number type key "${key}"`);
+        }
+    }
+    async clear() {
+        for await (const _ of new ClearIterable(this.database, simplifyOneOrMoreStr([escapeRedisChars(this.getPrefix()), "*"]))) {
+            /* Empty */
+        }
+    }
+    getGroup() {
+        return this.group;
+    }
+    withGroup(group) {
+        return new RedisCacheAdapter({
+            database: this.database,
+            serde: this.baseSerde,
+            rootGroup: simplifyOneOrMoreStr([this.group, group]),
+        });
+    }
+}
+//# sourceMappingURL=redis-cache-adapter.js.map

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,71 @@
+/**
+ * @module Cache
+ */
+import { type ICacheAdapter } from "../../../../cache/contracts/cache-adapter.contract.js";
+import type { TimeSpan, IInitizable, IDeinitizable } from "../../../../utilities/_module-exports.js";
+import type { SqliteDatabase } from "kysely";
+import type { ISerde } from "../../../../serde/contracts/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/implementations/adapters"```
+ * @group Adapters
+ */
+export type SqliteCacheAdapterSettings = {
+    database: SqliteDatabase;
+    tableName?: string;
+    serde: ISerde<string>;
+    enableTransactions?: boolean;
+    expiredKeysRemovalInterval?: TimeSpan;
+    shouldRemoveExpiredKeys?: boolean;
+    rootGroup: string;
+};
+/**
+ * To utilize the <i>SqliteCacheAdapter</i>, you must install the <i>"better-sqlite3"</i> package and supply a <i>{@link ISerde | ISerde<string> }</i>, with adapter like <i>{@link SuperJsonSerdeAdapter}</i>.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/implementations/adapters"```
+ * @group Adapters
+ */
+export declare class SqliteCacheAdapter<TType = unknown> implements ICacheAdapter<TType>, IInitizable, IDeinitizable {
+    private readonly cacheAdapter;
+    /**
+     * @example
+     * ```ts
+     * import { SqliteCacheAdapter } 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 Sqlite from "better-sqlite3";
+     *
+     * (async () => {
+     *   const database = new Sqlite("local.db");
+     *   const serde = new Serde(new SuperJsonSerdeAdapter());
+     *   const cacheAdapter = new SqliteCacheAdapter({
+     *     database,
+     *     serde,
+     *     rootGroup: "@global"
+     *   });
+     *   await cacheAdapter.init();
+     * })();
+     * ```
+     */
+    constructor(settings: SqliteCacheAdapterSettings);
+    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/sqlite-cache-adapter/sqlite-cache-adapter.js

@@ -0,0 +1,103 @@
+/**
+ * @module Cache
+ */
+import {} from "../../../../cache/contracts/cache-adapter.contract.js";
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+import { SuperJsonSerdeAdapter } from "../../../../serde/implementations/adapters/_module-exports.js";
+import { KyselySqliteCacheAdapter } from "../../../../cache/implementations/adapters/kysely-sqlite-cache-adapter/_module.js";
+import { Kysely, SqliteDialect } from "kysely";
+import { KyselyTableNameTransformerPlugin } from "../../../../utilities/_module-exports.js";
+/**
+ * To utilize the <i>SqliteCacheAdapter</i>, you must install the <i>"better-sqlite3"</i> package and supply a <i>{@link ISerde | ISerde<string> }</i>, with adapter like <i>{@link SuperJsonSerdeAdapter}</i>.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/implementations/adapters"```
+ * @group Adapters
+ */
+export class SqliteCacheAdapter {
+    cacheAdapter;
+    /**
+     * @example
+     * ```ts
+     * import { SqliteCacheAdapter } 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 Sqlite from "better-sqlite3";
+     *
+     * (async () => {
+     *   const database = new Sqlite("local.db");
+     *   const serde = new Serde(new SuperJsonSerdeAdapter());
+     *   const cacheAdapter = new SqliteCacheAdapter({
+     *     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 SqliteDialect({
+                    database: 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=sqlite-cache-adapter.js.map

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

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

package/dist/cache/implementations/derivables/_module-exports.d.ts

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

package/dist/cache/implementations/derivables/_module-exports.js

@@ -0,0 +1,3 @@
+export * from "../../../cache/implementations/derivables/cache-factory/_module.js";
+export * from "../../../cache/implementations/derivables/cache/_module.js";
+//# sourceMappingURL=_module-exports.js.map

package/dist/cache/implementations/derivables/_module-exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module-exports.js","sourceRoot":"","sources":["../../../../src/cache/implementations/derivables/_module-exports.ts"],"names":[],"mappings":"AAAA,cAAc,6DAA6D,CAAC;AAC5E,cAAc,qDAAqD,CAAC"}

package/dist/cache/implementations/derivables/cache/_module.d.ts

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

package/dist/cache/implementations/derivables/cache/_module.js

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

package/dist/cache/implementations/derivables/cache/_module.js.map

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