@daiso-tech/core 0.41.1 → 0.43.2

package/dist/circuit-breaker/implementations/derivables/circuit-breaker-provider/circuit-breaker.js

@@ -0,0 +1,201 @@
+/**
+ * @module CircuitBreaker
+ */
+import { OpenCircuitBreakerError, IsolatedCircuitBreakerError, CIRCUIT_BREAKER_TRIGGER, CIRCUIT_BREAKER_STATE, CIRCUIT_BREAKER_EVENTS, } from "../../../../circuit-breaker/contracts/_module.js";
+import {} from "../../../../event-bus/contracts/_module.js";
+import {} from "../../../../namespace/_module.js";
+import {} from "../../../../task/contracts/_module.js";
+import { Task } from "../../../../task/implementations/_module.js";
+import { TimeSpan } from "../../../../time-span/implementations/_module.js";
+import { callErrorPolicyOnThrow, resolveAsyncLazyable, } from "../../../../utilities/_module.js";
+/**
+ * @internal
+ */
+export class CircuitBreaker {
+    /**
+     * @internal
+     */
+    static _internal_serialize(deserializedValue) {
+        return {
+            version: "1",
+            key: deserializedValue._key.get(),
+        };
+    }
+    _key;
+    errorPolicy;
+    trigger;
+    slowCallTime;
+    adapter;
+    eventDispatcher;
+    serdeTransformerName;
+    namespace;
+    enableAsyncTracking;
+    constructor(settings) {
+        const { enableAsyncTracking, eventDispatcher, key, errorPolicy, trigger, adapter, slowCallTime, serdeTransformerName, namespace, } = settings;
+        this.enableAsyncTracking = enableAsyncTracking;
+        this.eventDispatcher = eventDispatcher;
+        this._key = key;
+        this.errorPolicy = errorPolicy;
+        this.trigger = trigger;
+        this.adapter = adapter;
+        this.slowCallTime = slowCallTime;
+        this.serdeTransformerName = serdeTransformerName;
+        this.namespace = namespace;
+    }
+    _internal_getNamespace() {
+        return this.namespace;
+    }
+    _internal_getSerdeTransformerName() {
+        return this.serdeTransformerName;
+    }
+    _internal_getAdapter() {
+        return this.adapter;
+    }
+    get key() {
+        return this._key.get();
+    }
+    getState() {
+        return new Task(async () => {
+            return this.adapter.getState(this._key.toString());
+        });
+    }
+    async trackFailure() {
+        if (this.enableAsyncTracking) {
+            new Task(async () => {
+                await this.adapter.trackFailure(this._key.toString());
+            }).detach();
+            return;
+        }
+        await this.adapter.trackFailure(this._key.toString());
+    }
+    async trackSuccess() {
+        if (this.enableAsyncTracking) {
+            new Task(async () => {
+                await this.adapter.trackSuccess(this._key.toString());
+            }).detach();
+            return;
+        }
+        await this.adapter.trackSuccess(this._key.toString());
+    }
+    async trackErrorWrapper(fn) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            const isErrorMatching = await callErrorPolicyOnThrow(this.errorPolicy, error);
+            const shouldRecordError = this.trigger === CIRCUIT_BREAKER_TRIGGER.BOTH ||
+                this.trigger === CIRCUIT_BREAKER_TRIGGER.ONLY_ERROR;
+            if (shouldRecordError && isErrorMatching) {
+                if (this.enableAsyncTracking) {
+                    new Task(async () => {
+                        await this.trackFailure();
+                    }).detach();
+                }
+                else {
+                    await this.trackFailure();
+                }
+                this.eventDispatcher
+                    .dispatch(CIRCUIT_BREAKER_EVENTS.TRACKED_FAILURE, {
+                    circuitBreaker: this,
+                    error,
+                })
+                    .detach();
+            }
+            else if (shouldRecordError) {
+                this.eventDispatcher
+                    .dispatch(CIRCUIT_BREAKER_EVENTS.UNTRACKED_FAILURE, {
+                    circuitBreaker: this,
+                    error,
+                })
+                    .detach();
+            }
+            throw error;
+        }
+    }
+    async trackSlowCallWrapper(fn) {
+        const start = performance.now();
+        const value = await fn();
+        const end = performance.now();
+        const executionTime = TimeSpan.fromMilliseconds(end - start);
+        const shouldRecordSlowCall = this.trigger === CIRCUIT_BREAKER_TRIGGER.BOTH ||
+            this.trigger === CIRCUIT_BREAKER_TRIGGER.ONLY_SLOW_CALL;
+        const isCallSlow = executionTime.gte(this.slowCallTime);
+        if (shouldRecordSlowCall && isCallSlow) {
+            await this.trackFailure();
+            this.eventDispatcher
+                .dispatch(CIRCUIT_BREAKER_EVENTS.TRACKED_SLOW_CALL, {
+                circuitBreaker: this,
+            })
+                .detach();
+        }
+        if (shouldRecordSlowCall && !isCallSlow) {
+            await this.trackSuccess();
+            this.eventDispatcher
+                .dispatch(CIRCUIT_BREAKER_EVENTS.TRACKED_SUCCESS, {
+                circuitBreaker: this,
+            })
+                .detach();
+        }
+        if (!shouldRecordSlowCall) {
+            await this.trackSuccess();
+            this.eventDispatcher
+                .dispatch(CIRCUIT_BREAKER_EVENTS.TRACKED_SUCCESS, {
+                circuitBreaker: this,
+            })
+                .detach();
+        }
+        return value;
+    }
+    async guard() {
+        const transition = await this.adapter.updateState(this._key.toString());
+        const hasStateChaned = transition.to !== transition.from;
+        if (hasStateChaned) {
+            this.eventDispatcher
+                .dispatch(CIRCUIT_BREAKER_EVENTS.STATE_TRANSITIONED, {
+                circuitBreaker: this,
+                from: transition.from,
+                to: transition.to,
+            })
+                .detach();
+        }
+        const isInOpenState = transition.to === CIRCUIT_BREAKER_STATE.OPEN;
+        if (isInOpenState) {
+            throw OpenCircuitBreakerError.create(this._key);
+        }
+        const isIsolatedState = transition.to === CIRCUIT_BREAKER_EVENTS.ISOLATED;
+        if (isIsolatedState) {
+            throw IsolatedCircuitBreakerError.create(this._key);
+        }
+    }
+    runOrFail(asyncFn) {
+        return new Task(async () => {
+            await this.guard();
+            return await this.trackErrorWrapper(async () => {
+                return await this.trackSlowCallWrapper(async () => {
+                    return await resolveAsyncLazyable(asyncFn);
+                });
+            });
+        });
+    }
+    reset() {
+        return new Task(async () => {
+            await this.adapter.reset(this._key.toString());
+            this.eventDispatcher
+                .dispatch(CIRCUIT_BREAKER_EVENTS.RESETED, {
+                circuitBreaker: this,
+            })
+                .detach();
+        });
+    }
+    isolate() {
+        return new Task(async () => {
+            await this.adapter.isolate(this.key);
+            this.eventDispatcher
+                .dispatch(CIRCUIT_BREAKER_EVENTS.ISOLATED, {
+                circuitBreaker: this,
+            })
+                .detach();
+        });
+    }
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/circuit-breaker/implementations/derivables/circuit-breaker-provider/circuit-breaker.js.map

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

package/dist/circuit-breaker/implementations/derivables/circuit-breaker-provider-factory/_module.d.ts

@@ -0,0 +1,2 @@
+export * from "../../../../circuit-breaker/implementations/derivables/circuit-breaker-provider-factory/circuit-breaker-provider-factory.js";
+export * from "../../../../circuit-breaker/implementations/derivables/circuit-breaker-provider-factory/database-circuit-breaker-provider-factory.js";

package/dist/circuit-breaker/implementations/derivables/circuit-breaker-provider-factory/_module.js

@@ -0,0 +1,3 @@
+export * from "../../../../circuit-breaker/implementations/derivables/circuit-breaker-provider-factory/circuit-breaker-provider-factory.js";
+export * from "../../../../circuit-breaker/implementations/derivables/circuit-breaker-provider-factory/database-circuit-breaker-provider-factory.js";
+//# sourceMappingURL=_module.js.map

package/dist/circuit-breaker/implementations/derivables/circuit-breaker-provider-factory/_module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../../src/circuit-breaker/implementations/derivables/circuit-breaker-provider-factory/_module.ts"],"names":[],"mappings":"AAAA,cAAc,mHAAmH,CAAC;AAClI,cAAc,4HAA4H,CAAC"}

package/dist/circuit-breaker/implementations/derivables/circuit-breaker-provider-factory/circuit-breaker-provider-factory.d.ts

@@ -0,0 +1,108 @@
+/**
+ * @module CircuitBreaker
+ */
+import { type ICircuitBreakerProviderFactory, type CircuitBreakerTrigger, type ICircuitBreakerProvider, type ICircuitBreakerAdapter } from "../../../../circuit-breaker/contracts/_module.js";
+import { type CircuitBreakerProviderSettingsBase } from "../../../../circuit-breaker/implementations/derivables/circuit-breaker-provider/_module.js";
+import { type IEventBus } from "../../../../event-bus/contracts/_module.js";
+import { type Namespace } from "../../../../namespace/_module.js";
+import { type ITimeSpan } from "../../../../time-span/contracts/_module.js";
+import { type ErrorPolicy } from "../../../../utilities/_module.js";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker"`
+ * @group Derivables
+ */
+export type CircuitBreakerAdapters<TAdapters extends string> = Partial<Record<TAdapters, ICircuitBreakerAdapter>>;
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker"`
+ * @group Derivables
+ */
+export type CircuitBreakerProviderFactorySettings<TAdapters extends string> = CircuitBreakerProviderSettingsBase & {
+    adapters: CircuitBreakerAdapters<TAdapters>;
+    defaultAdapter?: NoInfer<TAdapters>;
+};
+/**
+ * The `CircuitBreakerProviderFactory` class is immutable.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker"`
+ * @group Derivables
+ */
+export declare class CircuitBreakerProviderFactory<TAdapters extends string> implements ICircuitBreakerProviderFactory<TAdapters> {
+    private readonly settings;
+    /**
+     * @example
+     * ```ts
+     * import { CircuitBreakerProviderFactory } from "@daiso-tech/core/circuit-breaker";
+     * import { MemoryCircuitBreakerStorageAdapter } from "@daiso-tech/core/circuit-breaker/memory-circuit-breaker-storate-adapter";
+     * import { DatabaseCircuitBreakerAdapter } from "@daiso-tech/core/circuit-breaker/database-circuit-breaker-adapter";
+     * import { RedisCircuitBreakerAdapter } from "@daiso-tech/core/circuit-breaker/redis-circuit-breaker-adapter";
+     * import { Serde } from "@daiso-tech/core/serde";
+     * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/super-json-serde-adapter";
+     * import Redis from "ioredis"
+     *
+     * const serde = new Serde(new SuperJsonSerdeAdapter());
+     * const circuitBreakerProviderFactory = new CircuitBreakerProviderFactory({
+     *   serde,
+     *   adapters: {
+     *     memory: new DatabaseCircuitBreakerAdapter({
+     *       adapter: new MemoryCircuitBreakerStorageAdapter()
+     *     }),
+     *     redis: new RedisCircuitBreakerAdapter({
+     *       database: new Redis("YOUR_REDIS_CONNECTION")
+     *     }),
+     *   },
+     *   defaultAdapter: "memory",
+     * });
+     * ```
+     */
+    constructor(settings: CircuitBreakerProviderFactorySettings<TAdapters>);
+    setNamespace(namespace: Namespace): CircuitBreakerProviderFactory<TAdapters>;
+    setEventBus(eventBus: IEventBus): CircuitBreakerProviderFactory<TAdapters>;
+    setDefaultSlowCallTime(slowCallTime?: ITimeSpan): CircuitBreakerProviderFactory<TAdapters>;
+    setDefaultTrigger(trigger?: CircuitBreakerTrigger): CircuitBreakerProviderFactory<TAdapters>;
+    setDefaultErrorPolicy(defaultErrorPolicy: ErrorPolicy): CircuitBreakerProviderFactory<TAdapters>;
+    /**
+     * @example
+     * ```ts
+     * import { CircuitBreakerProviderFactory } from "@daiso-tech/core/circuit-breaker";
+     * import { MemoryCircuitBreakerStorageAdapter } from "@daiso-tech/core/circuit-breaker/memory-circuit-breaker-storate-adapter";
+     * import { DatabaseCircuitBreakerAdapter } from "@daiso-tech/core/circuit-breaker/database-circuit-breaker-adapter";
+     * import { RedisCircuitBreakerAdapter } from "@daiso-tech/core/circuit-breaker/redis-circuit-breaker-adapter";
+     * import { Serde } from "@daiso-tech/core/serde";
+     * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/super-json-serde-adapter";
+     * import Redis from "ioredis"
+     *
+     * const serde = new Serde(new SuperJsonSerdeAdapter());
+     * const circuitBreakerProviderFactory = new CircuitBreakerProviderFactory({
+     *   serde,
+     *   adapters: {
+     *     memory: new DatabaseCircuitBreakerAdapter({
+     *       adapter: new MemoryCircuitBreakerStorageAdapter()
+     *     }),
+     *     redis: new RedisCircuitBreakerAdapter({
+     *       database: new Redis("YOUR_REDIS_CONNECTION")
+     *     }),
+     *   },
+     *   defaultAdapter: "memory",
+     * });
+     *
+     * // Will apply circuit breaker logic the default adapter which is MemoryCircuitBreakerStorageAdapter
+     * await circuitBreakerProviderFactory
+     *   .use()
+     *   .create("a")
+     *   .runOrFail(async () => {
+     *     // ... code to apply circuit breaker logic
+     *   });
+     *
+     * // Will apply circuit breaker logic using the RedisCircuitBreakerAdapter
+     * await circuitBreakerProviderFactory
+     *   .use("redis")
+     *   .create("a")
+     *   .runOrFail(async () => {
+     *     // ... code to apply circuit breaker logic
+     *   });
+     * ```
+     */
+    use(adapterName?: TAdapters | undefined): ICircuitBreakerProvider;
+}

package/dist/circuit-breaker/implementations/derivables/circuit-breaker-provider-factory/circuit-breaker-provider-factory.js

@@ -0,0 +1,140 @@
+/**
+ * @module CircuitBreaker
+ */
+import {} from "../../../../circuit-breaker/contracts/_module.js";
+import { CircuitBreakerProvider, DEFAULT_CIRCUIT_BREAKER_PROVIDER_NAMESPACE, } from "../../../../circuit-breaker/implementations/derivables/circuit-breaker-provider/_module.js";
+import {} from "../../../../event-bus/contracts/_module.js";
+import {} from "../../../../namespace/_module.js";
+import {} from "../../../../time-span/contracts/_module.js";
+import { 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+UnregisteredAdapterError, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+DefaultAdapterNotDefinedError, } from "../../../../utilities/_module.js";
+/**
+ * The `CircuitBreakerProviderFactory` class is immutable.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker"`
+ * @group Derivables
+ */
+export class CircuitBreakerProviderFactory {
+    settings;
+    /**
+     * @example
+     * ```ts
+     * import { CircuitBreakerProviderFactory } from "@daiso-tech/core/circuit-breaker";
+     * import { MemoryCircuitBreakerStorageAdapter } from "@daiso-tech/core/circuit-breaker/memory-circuit-breaker-storate-adapter";
+     * import { DatabaseCircuitBreakerAdapter } from "@daiso-tech/core/circuit-breaker/database-circuit-breaker-adapter";
+     * import { RedisCircuitBreakerAdapter } from "@daiso-tech/core/circuit-breaker/redis-circuit-breaker-adapter";
+     * import { Serde } from "@daiso-tech/core/serde";
+     * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/super-json-serde-adapter";
+     * import Redis from "ioredis"
+     *
+     * const serde = new Serde(new SuperJsonSerdeAdapter());
+     * const circuitBreakerProviderFactory = new CircuitBreakerProviderFactory({
+     *   serde,
+     *   adapters: {
+     *     memory: new DatabaseCircuitBreakerAdapter({
+     *       adapter: new MemoryCircuitBreakerStorageAdapter()
+     *     }),
+     *     redis: new RedisCircuitBreakerAdapter({
+     *       database: new Redis("YOUR_REDIS_CONNECTION")
+     *     }),
+     *   },
+     *   defaultAdapter: "memory",
+     * });
+     * ```
+     */
+    constructor(settings) {
+        this.settings = settings;
+    }
+    setNamespace(namespace) {
+        return new CircuitBreakerProviderFactory({
+            ...this.settings,
+            namespace,
+        });
+    }
+    setEventBus(eventBus) {
+        return new CircuitBreakerProviderFactory({
+            ...this.settings,
+            eventBus,
+        });
+    }
+    setDefaultSlowCallTime(slowCallTime) {
+        return new CircuitBreakerProviderFactory({
+            ...this.settings,
+            defaultSlowCallTime: slowCallTime,
+        });
+    }
+    setDefaultTrigger(trigger) {
+        return new CircuitBreakerProviderFactory({
+            ...this.settings,
+            defaultTrigger: trigger,
+        });
+    }
+    setDefaultErrorPolicy(defaultErrorPolicy) {
+        return new CircuitBreakerProviderFactory({
+            ...this.settings,
+            defaultErrorPolicy,
+        });
+    }
+    /**
+     * @example
+     * ```ts
+     * import { CircuitBreakerProviderFactory } from "@daiso-tech/core/circuit-breaker";
+     * import { MemoryCircuitBreakerStorageAdapter } from "@daiso-tech/core/circuit-breaker/memory-circuit-breaker-storate-adapter";
+     * import { DatabaseCircuitBreakerAdapter } from "@daiso-tech/core/circuit-breaker/database-circuit-breaker-adapter";
+     * import { RedisCircuitBreakerAdapter } from "@daiso-tech/core/circuit-breaker/redis-circuit-breaker-adapter";
+     * import { Serde } from "@daiso-tech/core/serde";
+     * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/super-json-serde-adapter";
+     * import Redis from "ioredis"
+     *
+     * const serde = new Serde(new SuperJsonSerdeAdapter());
+     * const circuitBreakerProviderFactory = new CircuitBreakerProviderFactory({
+     *   serde,
+     *   adapters: {
+     *     memory: new DatabaseCircuitBreakerAdapter({
+     *       adapter: new MemoryCircuitBreakerStorageAdapter()
+     *     }),
+     *     redis: new RedisCircuitBreakerAdapter({
+     *       database: new Redis("YOUR_REDIS_CONNECTION")
+     *     }),
+     *   },
+     *   defaultAdapter: "memory",
+     * });
+     *
+     * // Will apply circuit breaker logic the default adapter which is MemoryCircuitBreakerStorageAdapter
+     * await circuitBreakerProviderFactory
+     *   .use()
+     *   .create("a")
+     *   .runOrFail(async () => {
+     *     // ... code to apply circuit breaker logic
+     *   });
+     *
+     * // Will apply circuit breaker logic using the RedisCircuitBreakerAdapter
+     * await circuitBreakerProviderFactory
+     *   .use("redis")
+     *   .create("a")
+     *   .runOrFail(async () => {
+     *     // ... code to apply circuit breaker logic
+     *   });
+     * ```
+     */
+    use(adapterName = this.settings.defaultAdapter) {
+        if (adapterName === undefined) {
+            throw new DefaultAdapterNotDefinedError(CircuitBreakerProviderFactory.name);
+        }
+        const adapter = this.settings.adapters[adapterName];
+        if (adapter === undefined) {
+            throw new UnregisteredAdapterError(adapterName);
+        }
+        const { namespace = DEFAULT_CIRCUIT_BREAKER_PROVIDER_NAMESPACE } = this.settings;
+        return new CircuitBreakerProvider({
+            ...this.settings,
+            adapter,
+            namespace: namespace.appendRoot(adapterName),
+            serdeTransformerName: adapterName,
+        });
+    }
+}
+//# sourceMappingURL=circuit-breaker-provider-factory.js.map

package/dist/circuit-breaker/implementations/derivables/circuit-breaker-provider-factory/circuit-breaker-provider-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker-provider-factory.js","sourceRoot":"","sources":["../../../../../src/circuit-breaker/implementations/derivables/circuit-breaker-provider-factory/circuit-breaker-provider-factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAKN,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACH,sBAAsB,EACtB,0CAA0C,GAE7C,MAAM,kFAAkF,CAAC;AAC1F,OAAO,EAAkB,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAkB,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAkB,MAAM,kCAAkC,CAAC;AAClE,OAAO;AACH,6DAA6D;AAC7D,wBAAwB;AACxB,6DAA6D;AAC7D,6BAA6B,GAEhC,MAAM,wBAAwB,CAAC;AAuBhC;;;;;GAKG;AACH,MAAM,OAAO,6BAA6B;IA8BjB;IA3BrB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,YACqB,QAA0D;QAA1D,aAAQ,GAAR,QAAQ,CAAkD;IAC5E,CAAC;IAEJ,YAAY,CACR,SAAoB;QAEpB,OAAO,IAAI,6BAA6B,CAAC;YACrC,GAAG,IAAI,CAAC,QAAQ;YAChB,SAAS;SACZ,CAAC,CAAC;IACP,CAAC;IAED,WAAW,CAAC,QAAmB;QAC3B,OAAO,IAAI,6BAA6B,CAAC;YACrC,GAAG,IAAI,CAAC,QAAQ;YAChB,QAAQ;SACX,CAAC,CAAC;IACP,CAAC;IAED,sBAAsB,CAClB,YAAwB;QAExB,OAAO,IAAI,6BAA6B,CAAC;YACrC,GAAG,IAAI,CAAC,QAAQ;YAChB,mBAAmB,EAAE,YAAY;SACpC,CAAC,CAAC;IACP,CAAC;IAED,iBAAiB,CACb,OAA+B;QAE/B,OAAO,IAAI,6BAA6B,CAAC;YACrC,GAAG,IAAI,CAAC,QAAQ;YAChB,cAAc,EAAE,OAAO;SAC1B,CAAC,CAAC;IACP,CAAC;IAED,qBAAqB,CACjB,kBAA+B;QAE/B,OAAO,IAAI,6BAA6B,CAAC;YACrC,GAAG,IAAI,CAAC,QAAQ;YAChB,kBAAkB;SACrB,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACH,GAAG,CACC,cAAqC,IAAI,CAAC,QAAQ,CAAC,cAAc;QAEjE,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,6BAA6B,CACnC,6BAA6B,CAAC,IAAI,CACrC,CAAC;QACN,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACpD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,wBAAwB,CAAC,WAAW,CAAC,CAAC;QACpD,CAAC;QACD,MAAM,EAAE,SAAS,GAAG,0CAA0C,EAAE,GAC5D,IAAI,CAAC,QAAQ,CAAC;QAClB,OAAO,IAAI,sBAAsB,CAAC;YAC9B,GAAG,IAAI,CAAC,QAAQ;YAChB,OAAO;YACP,SAAS,EAAE,SAAS,CAAC,UAAU,CAAC,WAAW,CAAC;YAC5C,oBAAoB,EAAE,WAAW;SACpC,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/circuit-breaker/implementations/derivables/circuit-breaker-provider-factory/database-circuit-breaker-provider-factory.d.ts

@@ -0,0 +1,137 @@
+/**
+ * @module CircuitBreaker
+ */
+import { type BackoffPolicy } from "../../../../backoff-policies/_module.js";
+import { type ICircuitBreakerProviderFactory, type CircuitBreakerTrigger, type ICircuitBreakerProvider, type ICircuitBreakerStorageAdapter, type ICircuitBreakerPolicy } from "../../../../circuit-breaker/contracts/_module.js";
+import { type CircuitBreakerProviderSettingsBase } from "../../../../circuit-breaker/implementations/derivables/circuit-breaker-provider/_module.js";
+import { type IEventBus } from "../../../../event-bus/contracts/_module.js";
+import { type Namespace } from "../../../../namespace/_module.js";
+import { type ITimeSpan } from "../../../../time-span/contracts/_module.js";
+import { type ErrorPolicy } from "../../../../utilities/_module.js";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker"`
+ * @group Derivables
+ */
+export type DatabaseCircuitBreakerAdapters<TAdapters extends string> = Partial<Record<TAdapters, ICircuitBreakerStorageAdapter>>;
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker"`
+ * @group Derivables
+ */
+export type DatabaseCircuitBreakerProviderFactorySettings<TAdapters extends string> = CircuitBreakerProviderSettingsBase & {
+    adapters: DatabaseCircuitBreakerAdapters<TAdapters>;
+    defaultAdapter?: NoInfer<TAdapters>;
+    /**
+     * @default
+     * ```ts
+     * import { exponentialBackoff } from "@daiso-tech/core/backoff-policies";
+     *
+     * exponentialBackoff();
+     * ```
+     */
+    backoffPolicy?: BackoffPolicy;
+    /**
+     * @default
+     * ```ts
+     * import { ConsecutiveBreaker } from "@daiso-tech/core/circuit-breaker/policies";
+     *
+     * new ConsecutiveBreaker();
+     * ```
+     */
+    circuitBreakerPolicy?: ICircuitBreakerPolicy;
+};
+/**
+ * The `DatabaseCircuitBreakerProviderFactory` class is immutable.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker"`
+ * @group Derivables
+ */
+export declare class DatabaseCircuitBreakerProviderFactory<TAdapters extends string> implements ICircuitBreakerProviderFactory<TAdapters> {
+    private readonly settings;
+    /**
+     * @example
+     * ```ts
+     * import { DatabaseCircuitBreakerProviderFactory } from "@daiso-tech/core/circuit-breaker";
+     * import { MemoryCircuitBreakerStorageAdapter } from "@daiso-tech/core/circuit-breaker/memory-circuit-breaker-storate-adapter";
+     * import { KyselyCircuitBreakerStorageAdapter } from "@daiso-tech/core/circuit-breaker/kysely-circuit-breaker-storate-adapter";
+     * import { DatabaseCircuitBreakerAdapter } from "@daiso-tech/core/circuit-breaker/database-circuit-breaker-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 circuitBreakerProviderFactory = new DatabaseCircuitBreakerProviderFactory({
+     *   serde,
+     *   adapters: {
+     *     memory: new MemoryCircuitBreakerStorageAdapter(),
+     *     sqlite: new KyselyCircuitBreakerStorageAdapter({
+     *       kysely: new Kysely({
+     *         dialect: new SqliteDialect({
+     *           database: new Sqlite("local.db"),
+     *         }),
+     *       }),
+     *       serde,
+     *     }),
+     *   },
+     *   defaultAdapter: "memory",
+     * });
+     * ```
+     */
+    constructor(settings: DatabaseCircuitBreakerProviderFactorySettings<TAdapters>);
+    setNamespace(namespace: Namespace): DatabaseCircuitBreakerProviderFactory<TAdapters>;
+    setEventBus(eventBus: IEventBus): DatabaseCircuitBreakerProviderFactory<TAdapters>;
+    setSlowCallTime(slowCallTime?: ITimeSpan): DatabaseCircuitBreakerProviderFactory<TAdapters>;
+    setTrigger(trigger?: CircuitBreakerTrigger): DatabaseCircuitBreakerProviderFactory<TAdapters>;
+    setDefaultErrorPolicy(defaultErrorPolicy: ErrorPolicy): DatabaseCircuitBreakerProviderFactory<TAdapters>;
+    setDefaultBackoffPolicy(backoffPolicy?: BackoffPolicy): DatabaseCircuitBreakerProviderFactory<TAdapters>;
+    setDefaultCircuitBreakerPolicy(circuitBreakerPolicy?: ICircuitBreakerPolicy): DatabaseCircuitBreakerProviderFactory<TAdapters>;
+    /**
+     * @example
+     * ```ts
+     * import { DatabaseCircuitBreakerProviderFactory } from "@daiso-tech/core/circuit-breaker";
+     * import { MemoryCircuitBreakerStorageAdapter } from "@daiso-tech/core/circuit-breaker/memory-circuit-breaker-storate-adapter";
+     * import { KyselyCircuitBreakerStorageAdapter } from "@daiso-tech/core/circuit-breaker/kysely-circuit-breaker-storate-adapter";
+     * import { DatabaseCircuitBreakerAdapter } from "@daiso-tech/core/circuit-breaker/database-circuit-breaker-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 circuitBreakerProviderFactory = new DatabaseCircuitBreakerProviderFactory({
+     *   serde,
+     *   adapters: {
+     *     memory: new MemoryCircuitBreakerStorageAdapter(),
+     *     sqlite: new KyselyCircuitBreakerStorageAdapter({
+     *       kysely: new Kysely({
+     *         dialect: new SqliteDialect({
+     *           database: new Sqlite("local.db"),
+     *         }),
+     *       }),
+     *       serde,
+     *     }),
+     *   },
+     *   defaultAdapter: "memory",
+     * });
+     *
+     * // Will apply circuit breaker logic the default adapter which is MemoryCircuitBreakerStorageAdapter
+     * await circuitBreakerProviderFactory
+     *   .use()
+     *   .create("a")
+     *   .runOrFail(async () => {
+     *     // ... code to apply circuit breaker logic
+     *   });
+     *
+     * // Will apply circuit breaker logic using the KyselyCircuitBreakerStorageAdapter
+     * await circuitBreakerProviderFactory
+     *   .use("sqlite")
+     *   .create("a")
+     *   .runOrFail(async () => {
+     *     // ... code to apply circuit breaker logic
+     *   });
+     * ```
+     */
+    use(adapterName?: TAdapters | undefined): ICircuitBreakerProvider;
+}