@daiso-tech/core/dist/circuit-breaker/implementations/derivables/circuit-breaker-provider-factory/circuit-breaker-provider-factory.js

The library offers flexible, framework-agnostic solutions for modern web applications, built on adaptable components that integrate seamlessly with popular frameworks like Next Js.

/**
 * @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