@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.
164 lines • 6.56 kB
JavaScript
/**
* @module CircuitBreaker
*/
import {} from "../../../../backoff-policies/_module.js";
import {} from "../../../../circuit-breaker/contracts/_module.js";
import { DatabaseCircuitBreakerAdapter } from "../../../../circuit-breaker/implementations/adapters/database-circuit-breaker-adapter/_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 `DatabaseCircuitBreakerProviderFactory` class is immutable.
*
* IMPORT_PATH: `"@daiso-tech/core/circuit-breaker"`
* @group Derivables
*/
export class DatabaseCircuitBreakerProviderFactory {
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) {
this.settings = settings;
}
setNamespace(namespace) {
return new DatabaseCircuitBreakerProviderFactory({
...this.settings,
namespace,
});
}
setEventBus(eventBus) {
return new DatabaseCircuitBreakerProviderFactory({
...this.settings,
eventBus,
});
}
setSlowCallTime(slowCallTime) {
return new DatabaseCircuitBreakerProviderFactory({
...this.settings,
defaultSlowCallTime: slowCallTime,
});
}
setTrigger(trigger) {
return new DatabaseCircuitBreakerProviderFactory({
...this.settings,
defaultTrigger: trigger,
});
}
setDefaultErrorPolicy(defaultErrorPolicy) {
return new DatabaseCircuitBreakerProviderFactory({
...this.settings,
defaultErrorPolicy,
});
}
setDefaultBackoffPolicy(backoffPolicy) {
return new DatabaseCircuitBreakerProviderFactory({
...this.settings,
backoffPolicy,
});
}
setDefaultCircuitBreakerPolicy(circuitBreakerPolicy) {
return new DatabaseCircuitBreakerProviderFactory({
...this.settings,
circuitBreakerPolicy,
});
}
/**
* @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 = this.settings.defaultAdapter) {
if (adapterName === undefined) {
throw new DefaultAdapterNotDefinedError(DatabaseCircuitBreakerProviderFactory.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: new DatabaseCircuitBreakerAdapter({
adapter,
}),
namespace: namespace.appendRoot(adapterName),
serdeTransformerName: adapterName,
});
}
}
//# sourceMappingURL=database-circuit-breaker-provider-factory.js.map