@daiso-tech/core 0.22.2 → 0.24.0

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

@@ -0,0 +1,325 @@
+/**
+ * @module Cache
+ */
+import { TypeCacheError, UnexpectedCacheError, } from "../../../../cache/contracts/cache.errors.js";
+import {} from "../../../../cache/contracts/cache-adapter.contract.js";
+import { simplifyOneOrMoreStr, } from "../../../../utilities/_module-exports.js";
+import { MongoServerError } from "mongodb";
+import { MongodbSerde } from "../../../../serde/implementations/adapters/_module-exports.js";
+/**
+ * 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 class MongodbCacheAdapter {
+    static isMongodbIncrementError(value) {
+        return (value instanceof MongoServerError &&
+            value.code !== undefined &&
+            (typeof value.code === "string" ||
+                typeof value.code === "number") &&
+            String(value.code) === "14");
+    }
+    mongodbSerde;
+    group;
+    baseSerde;
+    database;
+    collection;
+    collectionName;
+    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) {
+        const { collectionName = "cache", collectionSettings, database, serde, rootGroup, } = settings;
+        this.collectionName = collectionName;
+        this.database = database;
+        this.collection = database.collection(collectionName, collectionSettings);
+        this.collectionSettings = collectionSettings;
+        this.baseSerde = serde;
+        this.group = rootGroup;
+        this.mongodbSerde = new MongodbSerde(this.baseSerde);
+    }
+    getGroup() {
+        return this.group;
+    }
+    withGroup(group) {
+        return new MongodbCacheAdapter({
+            database: this.database,
+            serde: this.baseSerde,
+            collectionName: this.collectionName,
+            collectionSettings: this.collectionSettings,
+            rootGroup: simplifyOneOrMoreStr([this.group, group]),
+        });
+    }
+    /**
+     * Creates all related indexes.
+     * Note the <i>init</i> method needs to be called before using the adapter.
+     */
+    async init() {
+        await this.collection.createIndex({
+            key: 1,
+            group: 1,
+        }, {
+            unique: true,
+        });
+        await this.collection.createIndex("expiresAt", {
+            expireAfterSeconds: 0,
+        });
+    }
+    /**
+     * Removes the collection where the cache values are stored and all it's related indexes.
+     * Note all cache data will be removed.
+     */
+    async deInit() {
+        await this.collection.dropIndexes();
+        await this.database.dropCollection(this.collectionName);
+    }
+    async get(key) {
+        const document = await this.collection.findOne({
+            key,
+            group: this.group,
+        }, {
+            projection: {
+                _id: 0,
+                expiresAt: 1,
+                value: 1,
+            },
+        });
+        if (document === null) {
+            return null;
+        }
+        const { expiresAt, value } = document;
+        if (expiresAt === null) {
+            return await this.mongodbSerde.deserialize(value);
+        }
+        const hasExpired = expiresAt.getTime() <= new Date().getTime();
+        if (hasExpired) {
+            return null;
+        }
+        return await this.mongodbSerde.deserialize(value);
+    }
+    async add(key, value, ttl) {
+        const hasExpirationQuery = {
+            $ne: ["$expiresAt", null],
+        };
+        const hasExpiredQuery = {
+            $lte: ["$expiresAt", new Date()],
+        };
+        const hasExpirationAndExpiredQuery = {
+            $and: [hasExpirationQuery, hasExpiredQuery],
+        };
+        const serializedValue = this.mongodbSerde.serialize(value);
+        const document = await this.collection.findOneAndUpdate({
+            key,
+            group: this.group,
+        }, [
+            {
+                $set: {
+                    group: this.group,
+                    value: {
+                        $cond: {
+                            if: hasExpirationAndExpiredQuery,
+                            then: serializedValue,
+                            else: "$value",
+                        },
+                    },
+                    expiresAt: {
+                        $cond: {
+                            if: hasExpirationAndExpiredQuery,
+                            then: ttl?.toEndDate() ?? null,
+                            else: "$expiresAt",
+                        },
+                    },
+                },
+            },
+        ], {
+            upsert: true,
+            projection: {
+                _id: 0,
+                expiresAt: 1,
+            },
+        });
+        if (document === null) {
+            return true;
+        }
+        const { expiresAt } = document;
+        if (expiresAt === null) {
+            return false;
+        }
+        const hasExpired = expiresAt.getTime() <= new Date().getTime();
+        return hasExpired;
+    }
+    async update(key, value) {
+        const hasNoExpiration = {
+            expiresAt: {
+                $eq: null,
+            },
+        };
+        const hasExpiration = {
+            expiresAt: {
+                $ne: null,
+            },
+        };
+        const hasNotExpired = {
+            expiresAt: {
+                $lte: new Date(),
+            },
+        };
+        const document = await this.collection.findOneAndUpdate({
+            key,
+            group: this.group,
+            $or: [
+                hasNoExpiration,
+                {
+                    $and: [hasExpiration, hasNotExpired],
+                },
+            ],
+        }, {
+            $set: {
+                value: this.mongodbSerde.serialize(value),
+            },
+        }, {
+            projection: {
+                _id: 0,
+                expiresAt: 1,
+            },
+        });
+        if (document === null) {
+            return false;
+        }
+        const { expiresAt } = document;
+        if (expiresAt === null) {
+            return true;
+        }
+        const hasExpired = expiresAt.getTime() <= new Date().getTime();
+        return !hasExpired;
+    }
+    async put(key, value, ttl) {
+        const document = await this.collection.findOneAndUpdate({
+            key,
+            group: this.group,
+        }, {
+            $set: {
+                group: this.group,
+                value: this.mongodbSerde.serialize(value),
+                expiresAt: ttl?.toEndDate() ?? null,
+            },
+        }, {
+            upsert: true,
+            projection: {
+                _id: 0,
+                expiresAt: 1,
+            },
+        });
+        if (document === null) {
+            return false;
+        }
+        const { expiresAt } = document;
+        if (expiresAt === null) {
+            return true;
+        }
+        const hasExpired = expiresAt.getTime() <= new Date().getTime();
+        return !hasExpired;
+    }
+    async remove(key) {
+        const document = await this.collection.findOneAndDelete({
+            key,
+            group: this.group,
+        }, {
+            projection: {
+                _id: 0,
+                expiresAt: 1,
+            },
+        });
+        if (document === null) {
+            return false;
+        }
+        const { expiresAt } = document;
+        if (expiresAt === null) {
+            return true;
+        }
+        const hasExpired = expiresAt.getTime() <= new Date().getTime();
+        return !hasExpired;
+    }
+    async increment(key, value) {
+        try {
+            const hasNoExpiration = {
+                expiresAt: {
+                    $eq: null,
+                },
+            };
+            const hasExpiration = {
+                expiresAt: {
+                    $ne: null,
+                },
+            };
+            const hasNotExpired = {
+                expiresAt: {
+                    $lte: new Date(),
+                },
+            };
+            const document = await this.collection.findOneAndUpdate({
+                key,
+                group: this.group,
+                $or: [
+                    hasNoExpiration,
+                    {
+                        $and: [hasExpiration, hasNotExpired],
+                    },
+                ],
+            }, {
+                $inc: {
+                    value,
+                },
+            }, {
+                projection: {
+                    _id: 0,
+                    expiresAt: 1,
+                },
+            });
+            if (document === null) {
+                return false;
+            }
+            const { expiresAt } = document;
+            if (expiresAt === null) {
+                return true;
+            }
+            const hasExpired = expiresAt.getTime() <= new Date().getTime();
+            return !hasExpired;
+        }
+        catch (error) {
+            if (MongodbCacheAdapter.isMongodbIncrementError(error)) {
+                throw new TypeCacheError(`Unable to increment or decrement none number type key "${key}"`);
+            }
+            throw error;
+        }
+    }
+    async clear() {
+        const mongodbResult = await this.collection.deleteMany({
+            group: this.group,
+        });
+        if (!mongodbResult.acknowledged) {
+            throw new UnexpectedCacheError("Mongodb deletion was not acknowledged");
+        }
+    }
+}
+//# sourceMappingURL=mongodb-cache-adapter.js.map

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

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

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

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

package/dist/cache/implementations/adapters/no-op-cache-adapter/_module.js

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

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

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

package/dist/cache/implementations/adapters/no-op-cache-adapter/no-op-cache-adapter.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @module Cache
+ */
+import type { ICacheAdapter } from "../../../../cache/contracts/cache-adapter.contract.js";
+import type { TimeSpan } from "../../../../utilities/_module-exports.js";
+/**
+ * This <i>NoOpCacheAdapter</i> will do nothing and is used for easily mocking {@link ICacheAdapter} for testing.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/implementations/adapters"```
+ * @group Adapters
+ */
+export declare class NoOpCacheAdapter<TType = unknown> implements ICacheAdapter<TType> {
+    getGroup(): string;
+    withGroup(_group: string): ICacheAdapter<TType>;
+    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/no-op-cache-adapter/no-op-cache-adapter.js

@@ -0,0 +1,39 @@
+/**
+ * @module Cache
+ */
+/**
+ * This <i>NoOpCacheAdapter</i> will do nothing and is used for easily mocking {@link ICacheAdapter} for testing.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/implementations/adapters"```
+ * @group Adapters
+ */
+export class NoOpCacheAdapter {
+    getGroup() {
+        return "";
+    }
+    withGroup(_group) {
+        return new NoOpCacheAdapter();
+    }
+    get(_key) {
+        return Promise.resolve(null);
+    }
+    add(_key, _value, _ttl) {
+        return Promise.resolve(false);
+    }
+    update(_key, _value) {
+        return Promise.resolve(false);
+    }
+    put(_key, _value, _ttl) {
+        return Promise.resolve(false);
+    }
+    remove(_key) {
+        return Promise.resolve(false);
+    }
+    increment(_key, _value) {
+        return Promise.resolve(false);
+    }
+    clear() {
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=no-op-cache-adapter.js.map

package/dist/cache/implementations/adapters/no-op-cache-adapter/no-op-cache-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-op-cache-adapter.js","sourceRoot":"","sources":["../../../../../src/cache/implementations/adapters/no-op-cache-adapter/no-op-cache-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IACzB,QAAQ;QACJ,OAAO,EAAE,CAAC;IACd,CAAC;IAED,SAAS,CAAC,MAAc;QACpB,OAAO,IAAI,gBAAgB,EAAE,CAAC;IAClC,CAAC;IAED,GAAG,CAAC,IAAY;QACZ,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,GAAG,CAAC,IAAY,EAAE,MAAa,EAAE,IAAqB;QAClD,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,MAAa;QAC9B,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,GAAG,CAAC,IAAY,EAAE,MAAa,EAAE,IAAqB;QAClD,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,IAAY;QACf,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,SAAS,CAAC,IAAY,EAAE,MAAc;QAClC,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,KAAK;QACD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;CACJ"}

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

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

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

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

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

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

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

@@ -0,0 +1,65 @@
+/**
+ * @module Cache
+ */
+import { type ICacheAdapter } from "../../../../cache/contracts/cache-adapter.contract.js";
+import { type TimeSpan } from "../../../../utilities/_module-exports.js";
+import { type Redis, type Result } from "ioredis";
+import type { ISerde } from "../../../../serde/contracts/_module-exports.js";
+declare module "ioredis" {
+    interface RedisCommander<Context> {
+        daiso_cache_increment(key: string, number: string): Result<number, Context>;
+    }
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/implementations/adapters"```
+ * @group Adapters
+ */
+export type RedisCacheAdapterSettings = {
+    database: Redis;
+    serde: ISerde<string>;
+    rootGroup: string;
+};
+/**
+ * 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 declare class RedisCacheAdapter<TType = unknown> implements ICacheAdapter<TType> {
+    private static isRedisTypeError;
+    private readonly baseSerde;
+    private readonly redisSerde;
+    private readonly group;
+    private readonly 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: RedisCacheAdapterSettings);
+    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>;
+    private initIncrementCommand;
+    increment(key: string, value: number): Promise<boolean>;
+    clear(): Promise<void>;
+    getGroup(): string;
+    withGroup(group: string): ICacheAdapter<TType>;
+}