@daiso-tech/core 0.42.0 → 0.43.2

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

@@ -0,0 +1,154 @@
+/**
+ * @module CircuitBreaker
+ */
+import { type CircuitBreakerEventMap, type CircuitBreakerProviderCreateSettings, type ICircuitBreaker, type ICircuitBreakerProvider, type ICircuitBreakerAdapter, type CircuitBreakerTrigger } from "../../../../circuit-breaker/contracts/_module.js";
+import { type EventListener, type IEventBus, type Unsubscribe } from "../../../../event-bus/contracts/_module.js";
+import { Namespace } from "../../../../namespace/_module.js";
+import { type ISerderRegister } from "../../../../serde/contracts/_module.js";
+import { type ITask } from "../../../../task/contracts/_module.js";
+import { type ITimeSpan } from "../../../../time-span/contracts/_module.js";
+import { type ErrorPolicy, type OneOrMore } from "../../../../utilities/_module.js";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker"`
+ * @group Derivables
+ */
+export type CircuitBreakerProviderSettingsBase = {
+    /**
+     * @default
+     * ```ts
+     * import { Namespace } from "@daiso-tech/core/namespace";
+     *
+     * new Namespace("@circuit-breaker")
+     * ```
+     */
+    namespace?: Namespace;
+    /**
+     * @default
+     * ```ts
+     * import { EventBus } from "@daiso-tech/core/event-bus";
+     * import { NoOpEventBusAdapter } from "@daiso-tech/core/event-bus/no-op-event-bus-adapter";
+     *
+     * new EventBus({
+     *   adapter: new NoOpEventBusAdapter()
+     * })
+     * ```
+     */
+    eventBus?: IEventBus;
+    /**
+     * You can set the default `ErrorPolicy`
+     *
+     * @default
+     * ```ts
+     * (_error: unknown) => true
+     * ```
+     */
+    defaultErrorPolicy?: ErrorPolicy;
+    /**
+     * You can set the default slow call threshold.
+     *
+     * @default
+     * ```ts
+     * import { TimeSpan } from "@daiso-tech/core/time-span";
+     *
+     * TimeSpan.fromSeconds(10);
+     * ```
+     */
+    defaultSlowCallTime?: ITimeSpan;
+    /**
+     * You set the default trigger.
+     *
+     * @default
+     * ```ts
+     * import { CIRCUIT_BREAKER_TRIGGER} from "@daiso-tech/core/circuit-breaker/contracts";
+     *
+     * CIRCUIT_BREAKER_TRIGGER.BOTH
+     * ```
+     */
+    defaultTrigger?: CircuitBreakerTrigger;
+    /**
+     * If true, metric tracking will run asynchronously in the background and won't block the function utilizing the circuit breaker logic.
+     * @default true
+     */
+    enableAsyncTracking?: boolean;
+    serde?: OneOrMore<ISerderRegister>;
+    /**
+     * @default ""
+     */
+    serdeTransformerName?: string;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker"`
+ * @group Derivables
+ */
+export type CircuitBreakerProviderSettings = CircuitBreakerProviderSettingsBase & {
+    adapter: ICircuitBreakerAdapter;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker"`
+ * @group Derivables
+ */
+export declare const DEFAULT_CIRCUIT_BREAKER_PROVIDER_NAMESPACE: Namespace;
+/**
+ * `CircuitBreakerProvider` class can be derived from any {@link ICircuitBreakerAdapter | `ICircuitBreakerAdapter`}.
+ *
+ * Note the {@link ICircuitBreaker | `ICircuitBreaker`} instances created by the `CircuitBreakerProvider` class are serializable and deserializable,
+ * allowing them to be seamlessly transferred across different servers, processes, and databases.
+ * This can be done directly using {@link ISerderRegister | `ISerderRegister`} or indirectly through components that rely on {@link ISerderRegister | `ISerderRegister`} internally.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker"`
+ * @group Derivables
+ */
+export declare class CircuitBreakerProvider implements ICircuitBreakerProvider {
+    private readonly namespace;
+    private readonly eventBus;
+    private readonly adapter;
+    private readonly defaultSlowCallTime;
+    private readonly defaultTrigger;
+    private readonly defaultErrorPolicy;
+    private readonly serde;
+    private readonly serdeTransformerName;
+    private readonly enableAsyncTracking;
+    /**
+     * @example
+     * ```ts
+     * import { KyselyCircuitBreakerStorageAdapter } from "@daiso-tech/core/circuit-breaker/kysely-circuit-breaker-storage-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 circuitBreakerStorageAdapter = new KyselyCircuitBreakerStorageAdapter({
+     *   kysely: new Kysely({
+     *     dialect: new SqliteDialect({
+     *       database: new Sqlite("local.db"),
+     *     }),
+     *   }),
+     *   serde
+     * });
+     * // You need initialize the adapter once before using it.
+     * await circuitBreakerStorageAdapter.init();
+     *
+     * const circuitBreakerAdapter = new DatabaseCircuitBreakerAdapter({
+     *   adapter: circuitBreakerStorageAdapter
+     * });
+     *
+     * const circuitBreakerProvider = new CircuitBreakerProvider({
+     *   adapter: circuitBreakerAdapter
+     * })
+     * ```
+     */
+    constructor(settings: CircuitBreakerProviderSettings);
+    private registerToSerde;
+    addListener<TEventName extends keyof CircuitBreakerEventMap>(eventName: TEventName, listener: EventListener<CircuitBreakerEventMap[TEventName]>): ITask<void>;
+    removeListener<TEventName extends keyof CircuitBreakerEventMap>(eventName: TEventName, listener: EventListener<CircuitBreakerEventMap[TEventName]>): ITask<void>;
+    listenOnce<TEventName extends keyof CircuitBreakerEventMap>(eventName: TEventName, listener: EventListener<CircuitBreakerEventMap[TEventName]>): ITask<void>;
+    asTask<TEventName extends keyof CircuitBreakerEventMap>(eventName: TEventName): ITask<CircuitBreakerEventMap[TEventName]>;
+    subscribeOnce<TEventName extends keyof CircuitBreakerEventMap>(eventName: TEventName, listener: EventListener<CircuitBreakerEventMap[TEventName]>): ITask<Unsubscribe>;
+    subscribe<TEventName extends keyof CircuitBreakerEventMap>(eventName: TEventName, listener: EventListener<CircuitBreakerEventMap[TEventName]>): ITask<Unsubscribe>;
+    create(key: string, settings?: CircuitBreakerProviderCreateSettings): ICircuitBreaker;
+}

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

@@ -0,0 +1,138 @@
+/**
+ * @module CircuitBreaker
+ */
+import { CIRCUIT_BREAKER_TRIGGER, } from "../../../../circuit-breaker/contracts/_module.js";
+import { CircuitBreakerSerdeTransformer } from "../../../../circuit-breaker/implementations/derivables/circuit-breaker-provider/circuit-breaker-serde-transformer.js";
+import { CircuitBreaker } from "../../../../circuit-breaker/implementations/derivables/circuit-breaker-provider/circuit-breaker.js";
+import {} from "../../../../event-bus/contracts/_module.js";
+import { NoOpEventBusAdapter } from "../../../../event-bus/implementations/adapters/_module.js";
+import { EventBus } from "../../../../event-bus/implementations/derivables/_module.js";
+import { Namespace } from "../../../../namespace/_module.js";
+import {} from "../../../../serde/contracts/_module.js";
+import { NoOpSerdeAdapter } from "../../../../serde/implementations/adapters/_module.js";
+import { Serde } from "../../../../serde/implementations/derivables/serde.js";
+import {} from "../../../../task/contracts/_module.js";
+import {} from "../../../../time-span/contracts/_module.js";
+import { TimeSpan } from "../../../../time-span/implementations/_module.js";
+import { CORE, resolveOneOrMore, } from "../../../../utilities/_module.js";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker"`
+ * @group Derivables
+ */
+export const DEFAULT_CIRCUIT_BREAKER_PROVIDER_NAMESPACE = new Namespace("@circuit-breaker");
+/**
+ * `CircuitBreakerProvider` class can be derived from any {@link ICircuitBreakerAdapter | `ICircuitBreakerAdapter`}.
+ *
+ * Note the {@link ICircuitBreaker | `ICircuitBreaker`} instances created by the `CircuitBreakerProvider` class are serializable and deserializable,
+ * allowing them to be seamlessly transferred across different servers, processes, and databases.
+ * This can be done directly using {@link ISerderRegister | `ISerderRegister`} or indirectly through components that rely on {@link ISerderRegister | `ISerderRegister`} internally.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/circuit-breaker"`
+ * @group Derivables
+ */
+export class CircuitBreakerProvider {
+    namespace;
+    eventBus;
+    adapter;
+    defaultSlowCallTime;
+    defaultTrigger;
+    defaultErrorPolicy;
+    serde;
+    serdeTransformerName;
+    enableAsyncTracking;
+    /**
+     * @example
+     * ```ts
+     * import { KyselyCircuitBreakerStorageAdapter } from "@daiso-tech/core/circuit-breaker/kysely-circuit-breaker-storage-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 circuitBreakerStorageAdapter = new KyselyCircuitBreakerStorageAdapter({
+     *   kysely: new Kysely({
+     *     dialect: new SqliteDialect({
+     *       database: new Sqlite("local.db"),
+     *     }),
+     *   }),
+     *   serde
+     * });
+     * // You need initialize the adapter once before using it.
+     * await circuitBreakerStorageAdapter.init();
+     *
+     * const circuitBreakerAdapter = new DatabaseCircuitBreakerAdapter({
+     *   adapter: circuitBreakerStorageAdapter
+     * });
+     *
+     * const circuitBreakerProvider = new CircuitBreakerProvider({
+     *   adapter: circuitBreakerAdapter
+     * })
+     * ```
+     */
+    constructor(settings) {
+        const { enableAsyncTracking = true, namespace = DEFAULT_CIRCUIT_BREAKER_PROVIDER_NAMESPACE, eventBus = new EventBus({
+            adapter: new NoOpEventBusAdapter(),
+        }), adapter, defaultSlowCallTime = TimeSpan.fromSeconds(10), defaultTrigger = CIRCUIT_BREAKER_TRIGGER.BOTH, defaultErrorPolicy = () => true, serde = new Serde(new NoOpSerdeAdapter()), serdeTransformerName = "", } = settings;
+        this.enableAsyncTracking = enableAsyncTracking;
+        this.namespace = namespace;
+        this.eventBus = eventBus;
+        this.adapter = adapter;
+        this.defaultSlowCallTime = TimeSpan.fromTimeSpan(defaultSlowCallTime);
+        this.defaultTrigger = defaultTrigger;
+        this.defaultErrorPolicy = defaultErrorPolicy;
+        this.serde = serde;
+        this.serdeTransformerName = serdeTransformerName;
+        this.registerToSerde();
+    }
+    registerToSerde() {
+        const transformer = new CircuitBreakerSerdeTransformer({
+            enableAsyncTracking: this.enableAsyncTracking,
+            adapter: this.adapter,
+            slowCallTime: this.defaultSlowCallTime,
+            errorPolicy: this.defaultErrorPolicy,
+            trigger: this.defaultTrigger,
+            eventBus: this.eventBus,
+            namespace: this.namespace,
+            serdeTransformerName: this.serdeTransformerName,
+        });
+        for (const serde of resolveOneOrMore(this.serde)) {
+            serde.registerCustom(transformer, CORE);
+        }
+    }
+    addListener(eventName, listener) {
+        return this.eventBus.addListener(eventName, listener);
+    }
+    removeListener(eventName, listener) {
+        return this.eventBus.removeListener(eventName, listener);
+    }
+    listenOnce(eventName, listener) {
+        return this.eventBus.listenOnce(eventName, listener);
+    }
+    asTask(eventName) {
+        return this.eventBus.asTask(eventName);
+    }
+    subscribeOnce(eventName, listener) {
+        return this.eventBus.subscribeOnce(eventName, listener);
+    }
+    subscribe(eventName, listener) {
+        return this.eventBus.subscribe(eventName, listener);
+    }
+    create(key, settings = {}) {
+        const { errorPolicy = this.defaultErrorPolicy, trigger = this.defaultTrigger, slowCallTime = this.defaultSlowCallTime, } = settings;
+        return new CircuitBreaker({
+            enableAsyncTracking: this.enableAsyncTracking,
+            eventDispatcher: this.eventBus,
+            adapter: this.adapter,
+            key: this.namespace.create(key),
+            slowCallTime: TimeSpan.fromTimeSpan(slowCallTime),
+            errorPolicy,
+            trigger,
+            serdeTransformerName: this.serdeTransformerName,
+            namespace: this.namespace,
+        });
+    }
+}
+//# sourceMappingURL=circuit-breaker-provider.js.map

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

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

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

@@ -0,0 +1,41 @@
+/**
+ * @module CircuitBreaker
+ */
+import { type CircuitBreakerEventMap, type CircuitBreakerTrigger, type ICircuitBreakerAdapter } from "../../../../circuit-breaker/contracts/_module.js";
+import { CircuitBreaker, type ISerializedCircuitBreaker } from "../../../../circuit-breaker/implementations/derivables/circuit-breaker-provider/circuit-breaker.js";
+import { type IEventBus } from "../../../../event-bus/contracts/_module.js";
+import { type Namespace } from "../../../../namespace/_module.js";
+import { type ISerdeTransformer } from "../../../../serde/contracts/_module.js";
+import { type TimeSpan } from "../../../../time-span/implementations/_module.js";
+import { type ErrorPolicy, type OneOrMore } from "../../../../utilities/_module.js";
+/**
+ * @internal
+ */
+export type CircuitBreakerSerdeTransformerSettings = {
+    adapter: ICircuitBreakerAdapter;
+    namespace: Namespace;
+    slowCallTime: TimeSpan;
+    errorPolicy: ErrorPolicy;
+    trigger: CircuitBreakerTrigger;
+    eventBus: IEventBus<CircuitBreakerEventMap>;
+    serdeTransformerName: string;
+    enableAsyncTracking: boolean;
+};
+/**
+ * @internal
+ */
+export declare class CircuitBreakerSerdeTransformer implements ISerdeTransformer<CircuitBreaker, ISerializedCircuitBreaker> {
+    private readonly adapter;
+    private readonly namespace;
+    private readonly slowCallTime;
+    private readonly errorPolicy;
+    private readonly trigger;
+    private readonly eventBus;
+    private readonly serdeTransformerName;
+    private readonly enableAsyncTracking;
+    constructor(settings: CircuitBreakerSerdeTransformerSettings);
+    get name(): OneOrMore<string>;
+    isApplicable(value: unknown): value is CircuitBreaker;
+    deserialize(serializedValue: ISerializedCircuitBreaker): CircuitBreaker;
+    serialize(deserializedValue: CircuitBreaker): ISerializedCircuitBreaker;
+}

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

@@ -0,0 +1,77 @@
+/**
+ * @module CircuitBreaker
+ */
+import {} from "../../../../circuit-breaker/contracts/_module.js";
+import { CircuitBreaker, } from "../../../../circuit-breaker/implementations/derivables/circuit-breaker-provider/circuit-breaker.js";
+import {} from "../../../../event-bus/contracts/_module.js";
+import {} from "../../../../namespace/_module.js";
+import {} from "../../../../serde/contracts/_module.js";
+import {} from "../../../../time-span/implementations/_module.js";
+import { getConstructorName, } from "../../../../utilities/_module.js";
+/**
+ * @internal
+ */
+export class CircuitBreakerSerdeTransformer {
+    adapter;
+    namespace;
+    slowCallTime;
+    errorPolicy;
+    trigger;
+    eventBus;
+    serdeTransformerName;
+    enableAsyncTracking;
+    constructor(settings) {
+        const { adapter, namespace, slowCallTime, errorPolicy, trigger, eventBus, serdeTransformerName, enableAsyncTracking, } = settings;
+        this.enableAsyncTracking = enableAsyncTracking;
+        this.adapter = adapter;
+        this.namespace = namespace;
+        this.slowCallTime = slowCallTime;
+        this.errorPolicy = errorPolicy;
+        this.trigger = trigger;
+        this.eventBus = eventBus;
+        this.serdeTransformerName = serdeTransformerName;
+    }
+    get name() {
+        return [
+            "circuitBreaker",
+            this.serdeTransformerName,
+            getConstructorName(this.adapter),
+            this.namespace.toString(),
+        ].filter((str) => str !== "");
+    }
+    isApplicable(value) {
+        const isCircuitBreaker = value instanceof CircuitBreaker &&
+            getConstructorName(value) === CircuitBreaker.name;
+        if (!isCircuitBreaker) {
+            return false;
+        }
+        const isSerdTransformerNameMathcing = this.serdeTransformerName ===
+            value._internal_getSerdeTransformerName();
+        const isNamespaceMatching = this.namespace.toString() ===
+            value._internal_getNamespace().toString();
+        const isAdapterMatching = getConstructorName(this.adapter) ===
+            getConstructorName(value._internal_getAdapter());
+        return (isSerdTransformerNameMathcing &&
+            isNamespaceMatching &&
+            isAdapterMatching);
+    }
+    deserialize(serializedValue) {
+        const { key } = serializedValue;
+        const keyObj = this.namespace.create(key);
+        return new CircuitBreaker({
+            enableAsyncTracking: this.enableAsyncTracking,
+            eventDispatcher: this.eventBus,
+            adapter: this.adapter,
+            key: keyObj,
+            slowCallTime: this.slowCallTime,
+            errorPolicy: this.errorPolicy,
+            trigger: this.trigger,
+            serdeTransformerName: this.serdeTransformerName,
+            namespace: this.namespace,
+        });
+    }
+    serialize(deserializedValue) {
+        return CircuitBreaker._internal_serialize(deserializedValue);
+    }
+}
+//# sourceMappingURL=circuit-breaker-serde-transformer.js.map

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

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

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

@@ -0,0 +1,62 @@
+/**
+ * @module CircuitBreaker
+ */
+import { type CircuitBreakerState, type CircuitBreakerTrigger, type ICircuitBreaker, type ICircuitBreakerAdapter, type CircuitBreakerEventMap } from "../../../../circuit-breaker/contracts/_module.js";
+import { type IEventDispatcher } from "../../../../event-bus/contracts/_module.js";
+import { type Key, type Namespace } from "../../../../namespace/_module.js";
+import { type ITask } from "../../../../task/contracts/_module.js";
+import { TimeSpan } from "../../../../time-span/implementations/_module.js";
+import { type AsyncLazy, type ErrorPolicy } from "../../../../utilities/_module.js";
+/**
+ * @internal
+ */
+export type CircuitBreakerSettings = {
+    enableAsyncTracking: boolean;
+    eventDispatcher: IEventDispatcher<CircuitBreakerEventMap>;
+    adapter: ICircuitBreakerAdapter;
+    key: Key;
+    slowCallTime: TimeSpan;
+    errorPolicy: ErrorPolicy;
+    trigger: CircuitBreakerTrigger;
+    serdeTransformerName: string;
+    namespace: Namespace;
+};
+/**
+ * @internal
+ */
+export type ISerializedCircuitBreaker = {
+    version: "1";
+    key: string;
+};
+/**
+ * @internal
+ */
+export declare class CircuitBreaker implements ICircuitBreaker {
+    /**
+     * @internal
+     */
+    static _internal_serialize(deserializedValue: CircuitBreaker): ISerializedCircuitBreaker;
+    private readonly _key;
+    private readonly errorPolicy;
+    private readonly trigger;
+    private readonly slowCallTime;
+    private readonly adapter;
+    private readonly eventDispatcher;
+    private readonly serdeTransformerName;
+    private readonly namespace;
+    private readonly enableAsyncTracking;
+    constructor(settings: CircuitBreakerSettings);
+    _internal_getNamespace(): Namespace;
+    _internal_getSerdeTransformerName(): string;
+    _internal_getAdapter(): ICircuitBreakerAdapter;
+    get key(): string;
+    getState(): ITask<CircuitBreakerState>;
+    private trackFailure;
+    private trackSuccess;
+    private trackErrorWrapper;
+    private trackSlowCallWrapper;
+    private guard;
+    runOrFail<TValue = void>(asyncFn: AsyncLazy<TValue>): ITask<TValue>;
+    reset(): ITask<void>;
+    isolate(): ITask<void>;
+}