@daiso-tech/core 0.41.1 → 0.43.2

package/dist/circuit-breaker/implementations/adapters/kysely-circuit-breaker-storage-adapter/kysely-circuit-breaker-storage-adapter.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @module CircuitBreaker
+ */
+import { type Kysely } from "kysely";
+import { type ICircuitBreakerStorageAdapter, type ICircuitBreakerStorageAdapterTransaction } from "../../../../circuit-breaker/contracts/circuit-breaker-storage-adapter.contract.js";
+import { type ISerde } from "../../../../serde/contracts/serde.contract.js";
+import { type IDeinitizable, type IInitizable, type InvokableFn } from "../../../../utilities/_module.js";
+/**
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker/kysely-circuit-breaker-storage-adapter"`
+ * @group Adapters
+ */
+export type KyselyCircuitBreakerStorageTable = {
+    key: string;
+    state: string;
+};
+/**
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker/kysely-circuit-breaker-storage-adapter"`
+ * @group Adapters
+ */
+export type KyselyCircuitBreakerStorageTables = {
+    circuitBreaker: KyselyCircuitBreakerStorageTable;
+};
+/**
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker/kysely-circuit-breaker-storage-adapter"`
+ * @group Adapters
+ */
+export type KyselyCircuitBreakerStorageAdapterSettings = {
+    kysely: Kysely<KyselyCircuitBreakerStorageTables>;
+    serde: ISerde<string>;
+};
+/**
+ * To utilize the `KyselyCircuitBreakerStorageAdapter`, you must install the [`"kysely"`](https://www.npmjs.com/package/kysely) package and configure a `Kysely` class instance.
+ *
+ * Note in order to use `KyselyCircuitBreakerStorageAdapter` correctly, you need to use a database that has support for transactions.
+ * The adapter have been tested with `sqlite`, `postgres` and `mysql` databases.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker/kysely-circuit-breaker-storage-adapter"`
+ * @group Adapters
+ */
+export declare class KyselyCircuitBreakerStorageAdapter<TType> implements ICircuitBreakerStorageAdapter, IInitizable, IDeinitizable {
+    private readonly kysely;
+    private readonly serde;
+    /**
+     * @example
+     * ```ts
+     * import { KyselyCircuitBreakerStorageAdapter } from "@daiso-tech/core/circuit-breaker/kysely-circuit-breaker-storage-adapter";
+     * import { Serde } from "@daiso-tech/core/serde";
+     * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/super-json-serde-adapter"
+     * import Sqlite from "better-sqlite3";
+     * import { Kysely, SqliteDialect } from "kysely";
+     *
+     * const serde = new Serde(new SuperJsonSerdeAdapter());
+     * const circuitBreakerStorageAdapter = new KyselyCircuitBreakerStorageAdapter({
+     *   kysely: new Kysely({
+     *     dialect: new SqliteDialect({
+     *       database: new Sqlite("local.db"),
+     *     }),
+     *   }),
+     *   serde
+     * });
+     * // You need initialize the adapter once before using it.
+     * await circuitBreakerStorageAdapter.init();
+     * ```
+     */
+    constructor(settings: KyselyCircuitBreakerStorageAdapterSettings);
+    /**
+     * Removes all related circuit breaker tables and their rows.
+     * Note all circuit breaker data will be removed.
+     */
+    deInit(): Promise<void>;
+    /**
+     * Creates all related tables and indexes.
+     * Note the `init` method needs to be called once before using the adapter.
+     */
+    init(): Promise<void>;
+    transaction<TValue>(fn: InvokableFn<[
+        transaction: ICircuitBreakerStorageAdapterTransaction
+    ], Promise<TValue>>): Promise<TValue>;
+    find(key: string): Promise<TType | null>;
+    remove(key: string): Promise<void>;
+}

package/dist/circuit-breaker/implementations/adapters/kysely-circuit-breaker-storage-adapter/kysely-circuit-breaker-storage-adapter.js

@@ -0,0 +1,149 @@
+/**
+ * @module CircuitBreaker
+ */
+import { MysqlAdapter } from "kysely";
+import {} from "../../../../circuit-breaker/contracts/circuit-breaker-storage-adapter.contract.js";
+import {} from "../../../../serde/contracts/serde.contract.js";
+import {} from "../../../../utilities/_module.js";
+/**
+ * @internal
+ */
+async function find(key, { serde, kysely }) {
+    const row = await kysely
+        .selectFrom("circuitBreaker")
+        .where("circuitBreaker.key", "=", key)
+        .select("circuitBreaker.state")
+        .executeTakeFirst();
+    if (row === undefined) {
+        return null;
+    }
+    return serde.deserialize(row.state);
+}
+/**
+ * @internal
+ */
+class KyselyCircuitBreakerStorageAdapterTransaction {
+    kysely;
+    serde;
+    isMysql;
+    constructor(settings) {
+        const { kysely, serde } = settings;
+        this.kysely = kysely;
+        this.serde = serde;
+        this.isMysql =
+            this.kysely.getExecutor().adapter instanceof MysqlAdapter;
+    }
+    async upsert(key, state) {
+        const serializedState = this.serde.serialize(state);
+        await this.kysely
+            .insertInto("circuitBreaker")
+            .values({
+            key,
+            state: serializedState,
+        })
+            .$if(!this.isMysql, (eb) => eb.onConflict((eb) => eb.column("key").doUpdateSet({
+            state: serializedState,
+        })))
+            .$if(this.isMysql, (eb) => eb.onDuplicateKeyUpdate({
+            state: serializedState,
+        }))
+            .execute();
+    }
+    async find(key) {
+        return find(key, {
+            serde: this.serde,
+            kysely: this.kysely,
+        });
+    }
+}
+/**
+ * To utilize the `KyselyCircuitBreakerStorageAdapter`, you must install the [`"kysely"`](https://www.npmjs.com/package/kysely) package and configure a `Kysely` class instance.
+ *
+ * Note in order to use `KyselyCircuitBreakerStorageAdapter` correctly, you need to use a database that has support for transactions.
+ * The adapter have been tested with `sqlite`, `postgres` and `mysql` databases.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker/kysely-circuit-breaker-storage-adapter"`
+ * @group Adapters
+ */
+export class KyselyCircuitBreakerStorageAdapter {
+    kysely;
+    serde;
+    /**
+     * @example
+     * ```ts
+     * import { KyselyCircuitBreakerStorageAdapter } from "@daiso-tech/core/circuit-breaker/kysely-circuit-breaker-storage-adapter";
+     * import { Serde } from "@daiso-tech/core/serde";
+     * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/super-json-serde-adapter"
+     * import Sqlite from "better-sqlite3";
+     * import { Kysely, SqliteDialect } from "kysely";
+     *
+     * const serde = new Serde(new SuperJsonSerdeAdapter());
+     * const circuitBreakerStorageAdapter = new KyselyCircuitBreakerStorageAdapter({
+     *   kysely: new Kysely({
+     *     dialect: new SqliteDialect({
+     *       database: new Sqlite("local.db"),
+     *     }),
+     *   }),
+     *   serde
+     * });
+     * // You need initialize the adapter once before using it.
+     * await circuitBreakerStorageAdapter.init();
+     * ```
+     */
+    constructor(settings) {
+        const { kysely, serde } = settings;
+        this.kysely = kysely;
+        this.serde = serde;
+    }
+    /**
+     * Removes all related circuit breaker tables and their rows.
+     * Note all circuit breaker data will be removed.
+     */
+    async deInit() {
+        // Should throw if the table does not exists thats why the try catch is used.
+        try {
+            await this.kysely.schema.dropTable("circuitBreaker").execute();
+        }
+        catch {
+            /* EMPTY */
+        }
+    }
+    /**
+     * Creates all related tables and indexes.
+     * Note the `init` method needs to be called once before using the adapter.
+     */
+    async init() {
+        // Should throw if the table already exists thats why the try catch is used.
+        try {
+            await this.kysely.schema
+                .createTable("circuitBreaker")
+                .addColumn("key", "varchar(255)", (col) => col.primaryKey().notNull())
+                .addColumn("state", "varchar(255)", (col) => col.notNull())
+                .execute();
+        }
+        catch {
+            /* EMPTY */
+        }
+    }
+    async transaction(fn) {
+        return await this.kysely.transaction().execute(async (trx) => {
+            return await fn(new KyselyCircuitBreakerStorageAdapterTransaction({
+                kysely: trx,
+                serde: this.serde,
+            }));
+        });
+    }
+    async find(key) {
+        return find(key, {
+            serde: this.serde,
+            kysely: this.kysely,
+        });
+    }
+    async remove(key) {
+        await this.kysely
+            .deleteFrom("circuitBreaker")
+            .where("circuitBreaker.key", "=", key)
+            .execute();
+    }
+}
+//# sourceMappingURL=kysely-circuit-breaker-storage-adapter.js.map

package/dist/circuit-breaker/implementations/adapters/kysely-circuit-breaker-storage-adapter/kysely-circuit-breaker-storage-adapter.js.map

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

package/dist/circuit-breaker/implementations/adapters/memory-circuit-breaker-storage-adapter/_module-exports.d.ts

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

package/dist/circuit-breaker/implementations/adapters/memory-circuit-breaker-storage-adapter/_module-exports.js

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

package/dist/circuit-breaker/implementations/adapters/memory-circuit-breaker-storage-adapter/_module-exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module-exports.js","sourceRoot":"","sources":["../../../../../src/circuit-breaker/implementations/adapters/memory-circuit-breaker-storage-adapter/_module-exports.ts"],"names":[],"mappings":"AAAA,cAAc,6HAA6H,CAAC"}

package/dist/circuit-breaker/implementations/adapters/memory-circuit-breaker-storage-adapter/_module.d.ts

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

package/dist/circuit-breaker/implementations/adapters/memory-circuit-breaker-storage-adapter/_module.js

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

package/dist/circuit-breaker/implementations/adapters/memory-circuit-breaker-storage-adapter/_module.js.map

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

package/dist/circuit-breaker/implementations/adapters/memory-circuit-breaker-storage-adapter/memory-circuit-breaker-storage-adapter.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @module CircuitBreaker
+ */
+import { type ICircuitBreakerStorageAdapter, type ICircuitBreakerStorageAdapterTransaction } from "../../../../circuit-breaker/contracts/circuit-breaker-storage-adapter.contract.js";
+import { type IDeinitizable, type InvokableFn } from "../../../../utilities/_module.js";
+/**
+ * Note the `MemoryCircuitBreakerStorageAdapter` is limited to single process usage and cannot be shared across multiple servers or different processes.
+ * This adapter is meant for testing.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker/memory-circuit-breaker-storage-adapter"`
+ * @group Adapters
+ */
+export declare class MemoryCircuitBreakerStorageAdapter<TType = unknown> implements ICircuitBreakerStorageAdapter<TType>, IDeinitizable {
+    private readonly map;
+    /**
+     *  @example
+     * ```ts
+     * import { MemoryCircuitBreakerStorageAdapter } from "@daiso-tech/core/circuit-breaker/memory-circuit-breaker-storage-adapter";
+     *
+     * const circuitBreakerStorageAdapter = new MemoryCircuitBreakerStorageAdapter();
+     * ```
+     * You can also provide an `Map`.
+     * @example
+     * ```ts
+     * import { MemoryCircuitBreakerStorageAdapter } from "@daiso-tech/core/circuit-breaker/memory-circuit-breaker-storage-adapter";
+     *
+     * const map = new Map<any, any>();
+     * const circuitBreakerStorageAdapter = new MemoryCircuitBreakerStorageAdapter(map);
+     * ```
+     */
+    constructor(map?: Map<string, TType>);
+    /**
+     * Removes all in-memory circuit breaker data.
+     */
+    deInit(): Promise<void>;
+    private upsert;
+    transaction<TValue>(fn: InvokableFn<[
+        transaction: ICircuitBreakerStorageAdapterTransaction<TType>
+    ], Promise<TValue>>): Promise<TValue>;
+    find(key: string): Promise<TType | null>;
+    remove(key: string): Promise<void>;
+}

package/dist/circuit-breaker/implementations/adapters/memory-circuit-breaker-storage-adapter/memory-circuit-breaker-storage-adapter.js

@@ -0,0 +1,60 @@
+/**
+ * @module CircuitBreaker
+ */
+import {} from "../../../../circuit-breaker/contracts/circuit-breaker-storage-adapter.contract.js";
+import {} from "../../../../utilities/_module.js";
+/**
+ * Note the `MemoryCircuitBreakerStorageAdapter` is limited to single process usage and cannot be shared across multiple servers or different processes.
+ * This adapter is meant for testing.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker/memory-circuit-breaker-storage-adapter"`
+ * @group Adapters
+ */
+export class MemoryCircuitBreakerStorageAdapter {
+    map;
+    /**
+     *  @example
+     * ```ts
+     * import { MemoryCircuitBreakerStorageAdapter } from "@daiso-tech/core/circuit-breaker/memory-circuit-breaker-storage-adapter";
+     *
+     * const circuitBreakerStorageAdapter = new MemoryCircuitBreakerStorageAdapter();
+     * ```
+     * You can also provide an `Map`.
+     * @example
+     * ```ts
+     * import { MemoryCircuitBreakerStorageAdapter } from "@daiso-tech/core/circuit-breaker/memory-circuit-breaker-storage-adapter";
+     *
+     * const map = new Map<any, any>();
+     * const circuitBreakerStorageAdapter = new MemoryCircuitBreakerStorageAdapter(map);
+     * ```
+     */
+    constructor(map = new Map()) {
+        this.map = map;
+    }
+    /**
+     * Removes all in-memory circuit breaker data.
+     */
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async deInit() {
+        this.map.clear();
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async upsert(key, state) {
+        this.map.set(key, state);
+    }
+    async transaction(fn) {
+        return await fn({
+            upsert: (key, state) => this.upsert(key, state),
+            find: (key) => this.find(key),
+        });
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async find(key) {
+        return this.map.get(key) ?? null;
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async remove(key) {
+        this.map.delete(key);
+    }
+}
+//# sourceMappingURL=memory-circuit-breaker-storage-adapter.js.map

package/dist/circuit-breaker/implementations/adapters/memory-circuit-breaker-storage-adapter/memory-circuit-breaker-storage-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-circuit-breaker-storage-adapter.js","sourceRoot":"","sources":["../../../../../src/circuit-breaker/implementations/adapters/memory-circuit-breaker-storage-adapter/memory-circuit-breaker-storage-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAGN,MAAM,yEAAyE,CAAC;AACjF,OAAO,EAAwC,MAAM,wBAAwB,CAAC;AAE9E;;;;;;GAMG;AACH,MAAM,OAAO,kCAAkC;IAmBd;IAhB7B;;;;;;;;;;;;;;;OAeG;IACH,YAA6B,MAAM,IAAI,GAAG,EAAiB;QAA9B,QAAG,GAAH,GAAG,CAA2B;IAAG,CAAC;IAE/D;;OAEG;IACH,4DAA4D;IAC5D,KAAK,CAAC,MAAM;QACR,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,4DAA4D;IACpD,KAAK,CAAC,MAAM,CAAC,GAAW,EAAE,KAAY;QAC1C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,WAAW,CACb,EAGC;QAED,OAAO,MAAM,EAAE,CAAC;YACZ,MAAM,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC;YAC/C,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;SAChC,CAAC,CAAC;IACP,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,IAAI,CAAC,GAAW;QAClB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;IACrC,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,MAAM,CAAC,GAAW;QACpB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;CACJ"}

package/dist/circuit-breaker/implementations/adapters/mongodb-circuit-breaker-storage-adapter/_module-exports.d.ts

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

package/dist/circuit-breaker/implementations/adapters/mongodb-circuit-breaker-storage-adapter/_module-exports.js

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

package/dist/circuit-breaker/implementations/adapters/mongodb-circuit-breaker-storage-adapter/_module-exports.js.map

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

package/dist/circuit-breaker/implementations/adapters/mongodb-circuit-breaker-storage-adapter/_module.d.ts

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

package/dist/circuit-breaker/implementations/adapters/mongodb-circuit-breaker-storage-adapter/_module.js

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

package/dist/circuit-breaker/implementations/adapters/mongodb-circuit-breaker-storage-adapter/_module.js.map

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

package/dist/circuit-breaker/implementations/adapters/mongodb-circuit-breaker-storage-adapter/mongodb-circuit-breaker-storage-adapter.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @module CircuitBreaker
+ */
+import { type CollectionOptions, type Db, type MongoClient, type ObjectId } from "mongodb";
+import { type ICircuitBreakerStorageAdapter, type ICircuitBreakerStorageAdapterTransaction } from "../../../../circuit-breaker/contracts/circuit-breaker-storage-adapter.contract.js";
+import { type ISerde } from "../../../../serde/contracts/serde.contract.js";
+import { type IDeinitizable, type IInitizable, type InvokableFn } from "../../../../utilities/_module.js";
+/**
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker/mongodb-circuit-breaker-storage-adapter"`
+ * @group Adapters
+ */
+export type MongodbCircuitBreakerStorageDocument = {
+    _id: ObjectId;
+    key: string;
+    state: string;
+};
+/**
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker/mongodb-circuit-breaker-storage-adapter"`
+ * @group Adapters
+ */
+export type MongodbCircuitBreakerStorageAdapterSettings = {
+    client: MongoClient;
+    database: Db;
+    /**
+     * @default "circuitBreaker"
+     */
+    collectionName?: string;
+    collectionSettings?: CollectionOptions;
+    serde: ISerde<string>;
+};
+/**
+ * To utilize the `MongodbCircuitBreakerStorageAdapter`, you must install the [`"mongodb"`](https://www.npmjs.com/package/mongodb) package.
+ *
+ * Note in order to use `MongodbCircuitBreakerStorageAdapter` correctly, you need to use a database that has support for transactions.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker/mongodb-circuit-breaker-storage-adapter"`
+ * @group Adapters
+ */
+export declare class MongodbCircuitBreakerStorageAdapter<TType = unknown> implements ICircuitBreakerStorageAdapter<TType>, IInitizable, IDeinitizable {
+    private readonly collection;
+    private readonly client;
+    private readonly serde;
+    /**
+     * @example
+     * ```ts
+     * import { MongodbCircuitBreakerStorageAdapter } from "@daiso-tech/core/circuit-breaker/mongodb-circuit-breaker-storage-adapter";
+     * import { MongoClient } from "mongodb";
+     * import { Serde } from "@daiso-tech/core/serde";
+     * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/super-json-serde-adapter"
+     *
+     * const client = await MongoClient.connect("YOUR_MONGODB_CONNECTION_STRING");
+     * const database = client.db("database");
+     * const serde = new Serde(new SuperJsonSerdeAdapter());
+     * const circuitBreakerStorageAdapter = new MongodbCircuitBreakerStorageAdapter({
+     *   client,
+     *   database,
+     *   serde
+     * });
+     * // You need initialize the adapter once before using it.
+     * await circuitBreakerStorageAdapter.init()
+     * ```
+     */
+    constructor(settings: MongodbCircuitBreakerStorageAdapterSettings);
+    /**
+     * Removes the collection where the circuit breaker keys are stored and all it's related indexes.
+     * Note all circuit breaker data will be removed.
+     */
+    deInit(): Promise<void>;
+    /**
+     * Creates all related indexes.
+     * Note the `init` method needs to be called once before using the adapter.
+     */
+    init(): Promise<void>;
+    private upsert;
+    transaction<TValue>(fn: InvokableFn<[
+        transaction: ICircuitBreakerStorageAdapterTransaction<TType>
+    ], Promise<TValue>>): Promise<TValue>;
+    find(key: string): Promise<TType | null>;
+    remove(key: string): Promise<void>;
+}

package/dist/circuit-breaker/implementations/adapters/mongodb-circuit-breaker-storage-adapter/mongodb-circuit-breaker-storage-adapter.js

@@ -0,0 +1,115 @@
+/**
+ * @module CircuitBreaker
+ */
+import {} from "mongodb";
+import {} from "../../../../circuit-breaker/contracts/circuit-breaker-storage-adapter.contract.js";
+import {} from "../../../../serde/contracts/serde.contract.js";
+import {} from "../../../../utilities/_module.js";
+/**
+ * To utilize the `MongodbCircuitBreakerStorageAdapter`, you must install the [`"mongodb"`](https://www.npmjs.com/package/mongodb) package.
+ *
+ * Note in order to use `MongodbCircuitBreakerStorageAdapter` correctly, you need to use a database that has support for transactions.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker/mongodb-circuit-breaker-storage-adapter"`
+ * @group Adapters
+ */
+export class MongodbCircuitBreakerStorageAdapter {
+    collection;
+    client;
+    serde;
+    /**
+     * @example
+     * ```ts
+     * import { MongodbCircuitBreakerStorageAdapter } from "@daiso-tech/core/circuit-breaker/mongodb-circuit-breaker-storage-adapter";
+     * import { MongoClient } from "mongodb";
+     * import { Serde } from "@daiso-tech/core/serde";
+     * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/super-json-serde-adapter"
+     *
+     * const client = await MongoClient.connect("YOUR_MONGODB_CONNECTION_STRING");
+     * const database = client.db("database");
+     * const serde = new Serde(new SuperJsonSerdeAdapter());
+     * const circuitBreakerStorageAdapter = new MongodbCircuitBreakerStorageAdapter({
+     *   client,
+     *   database,
+     *   serde
+     * });
+     * // You need initialize the adapter once before using it.
+     * await circuitBreakerStorageAdapter.init()
+     * ```
+     */
+    constructor(settings) {
+        const { client, collectionName = "circuitBreaker", collectionSettings, database, serde, } = settings;
+        this.client = client;
+        this.collection = database.collection(collectionName, collectionSettings);
+        this.serde = serde;
+    }
+    /**
+     * Removes the collection where the circuit breaker keys are stored and all it's related indexes.
+     * Note all circuit breaker data will be removed.
+     */
+    async deInit() {
+        // Should throw if the collection already does not exists thats why the try catch is used.
+        try {
+            await this.collection.dropIndexes();
+        }
+        catch {
+            /* EMPTY */
+        }
+        // Should throw if the collection already does not exists thats why the try catch is used.
+        try {
+            await this.collection.drop();
+        }
+        catch {
+            /* EMPTY */
+        }
+    }
+    /**
+     * Creates all related indexes.
+     * Note the `init` method needs to be called once before using the adapter.
+     */
+    async init() {
+        // Should throw if the index already exists thats why the try catch is used.
+        try {
+            await this.collection.createIndex({
+                key: 1,
+            }, {
+                unique: true,
+            });
+        }
+        catch {
+            /* EMPTY */
+        }
+    }
+    async upsert(key, state) {
+        await this.collection.updateOne({
+            key,
+        }, {
+            $set: {
+                state: this.serde.serialize(state),
+            },
+        }, {
+            upsert: true,
+        });
+    }
+    async transaction(fn) {
+        return await this.client.startSession().withTransaction(async () => {
+            return await fn({
+                upsert: (key, state) => this.upsert(key, state),
+                find: (key) => this.find(key),
+            });
+        });
+    }
+    async find(key) {
+        const doc = await this.collection.findOne({ key });
+        if (doc === null) {
+            return null;
+        }
+        return this.serde.deserialize(doc.state);
+    }
+    async remove(key) {
+        await this.collection.deleteOne({
+            key,
+        });
+    }
+}
+//# sourceMappingURL=mongodb-circuit-breaker-storage-adapter.js.map

package/dist/circuit-breaker/implementations/adapters/mongodb-circuit-breaker-storage-adapter/mongodb-circuit-breaker-storage-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongodb-circuit-breaker-storage-adapter.js","sourceRoot":"","sources":["../../../../../src/circuit-breaker/implementations/adapters/mongodb-circuit-breaker-storage-adapter/mongodb-circuit-breaker-storage-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAMN,MAAM,SAAS,CAAC;AAEjB,OAAO,EAGN,MAAM,yEAAyE,CAAC;AACjF,OAAO,EAAe,MAAM,qCAAqC,CAAC;AAClE,OAAO,EAIN,MAAM,wBAAwB,CAAC;AA2BhC;;;;;;;GAOG;AACH,MAAM,OAAO,mCAAmC;IAG3B,UAAU,CAAmD;IAC7D,MAAM,CAAc;IACpB,KAAK,CAAiB;IAEvC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,YAAY,QAAqD;QAC7D,MAAM,EACF,MAAM,EACN,cAAc,GAAG,gBAAgB,EACjC,kBAAkB,EAClB,QAAQ,EACR,KAAK,GACR,GAAG,QAAQ,CAAC;QACb,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CACjC,cAAc,EACd,kBAAkB,CACrB,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM;QACR,0FAA0F;QAC1F,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACL,WAAW;QACf,CAAC;QAED,0FAA0F;QAC1F,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACL,WAAW;QACf,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI;QACN,4EAA4E;QAC5E,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAC7B;gBACI,GAAG,EAAE,CAAC;aACT,EACD;gBACI,MAAM,EAAE,IAAI;aACf,CACJ,CAAC;QACN,CAAC;QAAC,MAAM,CAAC;YACL,WAAW;QACf,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,MAAM,CAAQ,GAAW,EAAE,KAAY;QACjD,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAC3B;YACI,GAAG;SACN,EACD;YACI,IAAI,EAAE;gBACF,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC;aACrC;SACJ,EACD;YACI,MAAM,EAAE,IAAI;SACf,CACJ,CAAC;IACN,CAAC;IAED,KAAK,CAAC,WAAW,CACb,EAGC;QAED,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,eAAe,CAAC,KAAK,IAAI,EAAE;YAC/D,OAAO,MAAM,EAAE,CAAC;gBACZ,MAAM,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC;gBAC/C,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;aAChC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAW;QAClB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QACnD,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAQ,GAAG,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACpB,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YAC5B,GAAG;SACN,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/circuit-breaker/implementations/adapters/no-op-circuit-breaker-adapter/_module-exports.d.ts

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

package/dist/circuit-breaker/implementations/adapters/no-op-circuit-breaker-adapter/_module-exports.js

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

package/dist/circuit-breaker/implementations/adapters/no-op-circuit-breaker-adapter/_module-exports.js.map

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

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

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

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

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

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * @module CircuitBreaker
+ */
+import { type CircuitBreakerState, type CircuitBreakerStateTransition, type ICircuitBreakerAdapter } from "../../../../circuit-breaker/contracts/_module.js";
+/**
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker/no-op-circuit-breaker-adapter"`
+ * @group Adapters
+ */
+export declare class NoOpCircuitBreakerAdapter implements ICircuitBreakerAdapter {
+    getState(_key: string): Promise<CircuitBreakerState>;
+    updateState(_key: string): Promise<CircuitBreakerStateTransition>;
+    isolate(_key: string): Promise<void>;
+    trackFailure(_key: string): Promise<void>;
+    trackSuccess(_key: string): Promise<void>;
+    reset(_key: string): Promise<void>;
+}