UNPKG

@daiso-tech/core

Version:

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

151 lines 5.72 kB
/** * @module CircuitBreaker */ import {} from "../../../../circuit-breaker/contracts/_module.js"; import { CircuitBreakerFactory, } from "../../../../circuit-breaker/implementations/derivables/circuit-breaker-factory/_module.js"; import {} from "../../../../event-bus/contracts/_module.js"; import {} from "../../../../execution-context/contracts/_module.js"; import {} from "../../../../namespace/contracts/_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 `CircuitBreakerFactoryResolver` class is immutable. * * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker"` * @group Derivables */ export class CircuitBreakerFactoryResolver { settings; /** * @example * ```ts * import { CircuitBreakerFactoryResolver } 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 circuitBreakerFactoryResolver = new CircuitBreakerFactoryResolver({ * 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 CircuitBreakerFactoryResolver({ ...this.settings, namespace, }); } setEventBus(eventBus) { return new CircuitBreakerFactoryResolver({ ...this.settings, eventBus, }); } setDefaultSlowCallTime(slowCallTime) { return new CircuitBreakerFactoryResolver({ ...this.settings, defaultSlowCallTime: slowCallTime, }); } setDefaultTrigger(trigger) { return new CircuitBreakerFactoryResolver({ ...this.settings, defaultTrigger: trigger, }); } setDefaultErrorPolicy(defaultErrorPolicy) { return new CircuitBreakerFactoryResolver({ ...this.settings, defaultErrorPolicy, }); } setWaitUntil(waitUntil) { return new CircuitBreakerFactoryResolver({ ...this.settings, waitUntil, }); } setExecutionContext(executionContext) { return new CircuitBreakerFactoryResolver({ ...this.settings, executionContext, }); } /** * @example * ```ts * import { CircuitBreakerFactoryResolver } 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 circuitBreakerFactoryResolver = new CircuitBreakerFactoryResolver({ * 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 circuitBreakerFactoryResolver * .use() * .create("a") * .runOrFail(async () => { * // ... code to apply circuit breaker logic * }); * * // Will apply circuit breaker logic using the RedisCircuitBreakerAdapter * await circuitBreakerFactoryResolver * .use("redis") * .create("a") * .runOrFail(async () => { * // ... code to apply circuit breaker logic * }); * ``` */ use(adapterName = this.settings.defaultAdapter) { if (adapterName === undefined) { throw new DefaultAdapterNotDefinedError(CircuitBreakerFactoryResolver.name); } const adapter = this.settings.adapters[adapterName]; if (adapter === undefined) { throw new UnregisteredAdapterError(adapterName); } return new CircuitBreakerFactory({ ...this.settings, adapter, serdeTransformerName: adapterName, }); } } //# sourceMappingURL=circuit-breaker-factory-resolver.js.map