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.

175 lines 6.79 kB
/** * @module CircuitBreaker */ import {} from "../../../../backoff-policies/contracts/_module.js"; import {} from "../../../../circuit-breaker/contracts/_module.js"; import { DatabaseCircuitBreakerAdapter } from "../../../../circuit-breaker/implementations/adapters/database-circuit-breaker-adapter/_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 `DatabaseCircuitBreakerFactoryResolver` class is immutable. * * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker"` * @group Derivables */ export class DatabaseCircuitBreakerFactoryResolver { settings; /** * @example * ```ts * import { DatabaseCircuitBreakerFactoryResolver } 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 circuitBreakerFactoryResolver = new DatabaseCircuitBreakerFactoryResolver({ * serde, * adapters: { * memory: new MemoryCircuitBreakerStorageAdapter(), * sqlite: new KyselyCircuitBreakerStorageAdapter({ * kysely: new Kysely({ * dialect: new SqliteDialect({ * database: new Sqlite("local.db"), * }), * }), * serde, * }), * }, * defaultAdapter: "memory", * }); * ``` */ constructor(settings) { this.settings = settings; } setNamespace(namespace) { return new DatabaseCircuitBreakerFactoryResolver({ ...this.settings, namespace, }); } setEventBus(eventBus) { return new DatabaseCircuitBreakerFactoryResolver({ ...this.settings, eventBus, }); } setSlowCallTime(slowCallTime) { return new DatabaseCircuitBreakerFactoryResolver({ ...this.settings, defaultSlowCallTime: slowCallTime, }); } setTrigger(trigger) { return new DatabaseCircuitBreakerFactoryResolver({ ...this.settings, defaultTrigger: trigger, }); } setDefaultErrorPolicy(defaultErrorPolicy) { return new DatabaseCircuitBreakerFactoryResolver({ ...this.settings, defaultErrorPolicy, }); } setDefaultBackoffPolicy(backoffPolicy) { return new DatabaseCircuitBreakerFactoryResolver({ ...this.settings, backoffPolicy, }); } setDefaultCircuitBreakerPolicy(circuitBreakerPolicy) { return new DatabaseCircuitBreakerFactoryResolver({ ...this.settings, circuitBreakerPolicy, }); } setWaitUntil(waitUntil) { return new DatabaseCircuitBreakerFactoryResolver({ ...this.settings, waitUntil, }); } setExecutionContext(executionContext) { return new DatabaseCircuitBreakerFactoryResolver({ ...this.settings, executionContext, }); } /** * @example * ```ts * import { DatabaseCircuitBreakerFactoryResolver } 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 circuitBreakerFactoryResolver = new DatabaseCircuitBreakerFactoryResolver({ * 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 circuitBreakerFactoryResolver * .use() * .create("a") * .runOrFail(async () => { * // ... code to apply circuit breaker logic * }); * * // Will apply circuit breaker logic using the KyselyCircuitBreakerStorageAdapter * await circuitBreakerFactoryResolver * .use("sqlite") * .create("a") * .runOrFail(async () => { * // ... code to apply circuit breaker logic * }); * ``` */ use(adapterName = this.settings.defaultAdapter) { if (adapterName === undefined) { throw new DefaultAdapterNotDefinedError(DatabaseCircuitBreakerFactoryResolver.name); } const adapter = this.settings.adapters[adapterName]; if (adapter === undefined) { throw new UnregisteredAdapterError(adapterName); } return new CircuitBreakerFactory({ ...this.settings, adapter: new DatabaseCircuitBreakerAdapter({ adapter, }), serdeTransformerName: adapterName, }); } } //# sourceMappingURL=database-circuit-breaker-factory-resolver.js.map