@daiso-tech/core 0.34.0 → 0.35.0

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@daiso-tech/core",
     "private": false,
-    "version": "0.34.0",
+    "version": "0.35.0",
     "author": "Yousif Abdulkarim",
     "license": "Apache-2.0",
     "type": "module",
@@ -37,7 +37,27 @@
         "TypeScript",
         "JavaScript",
         "Multitenant",
-        "Multitenancy"
+        "Multitenancy",
+        "LazyPromise",
+        "AsyncMiddleware",
+        "AsyncHooks",
+        "Async middlewares",
+        "Async hooks",
+        "Middleware",
+        "Middlewares",
+        "Hooks",
+        "Fallback",
+        "Retry",
+        "Timeout",
+        "Deadline",
+        "resilience",
+        "Resilience",
+        "Hedging",
+        "Fallback hedging",
+        "Sequential hedging",
+        "Parallel hedging",
+        "Concurrent hedging",
+        "Latency hedging"
     ],
     "files": [
         "./dist"

package/dist/async/async.events.d.ts

@@ -1,105 +0,0 @@
-/**
- * @module Async
- */
-import type { AbortAsyncError, RetryAsyncError, TimeoutAsyncError } from "../async/async.errors.js";
-import { BaseEvent } from "../event-bus/contracts/_shared.js";
-/**
- * This event is dispatched when the `LazyPromise` has been rejected.
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Events
- */
-export declare class FailureAsyncEvent extends BaseEvent<{
-    error: unknown;
-}> {
-}
-/**
- * This event is dispatched when the `LazyPromise` has been fulfilled.
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Events
- */
-export declare class SuccessAsyncEvent<TValue> extends BaseEvent<{
-    value: TValue;
-}> {
-}
-/**
- * This event is dispatched when the `LazyPromise` has been fulfilled or rejected.
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Events
- */
-export declare class FinallyAsyncEvent extends BaseEvent<{}> {
-}
-/**
- * This event is dispatched on every retry attempt of the `LazyPromise`.
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Events
- */
-export declare class RetryAttemptAsyncEvent extends BaseEvent<{
-    attempt: number;
-    error: unknown;
-}> {
-}
-/**
- * This event is dispatched when the rety attempt of the `LazyPromise` has exceeded the given time limit.
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Events
- */
-export declare class RetryTimeoutAsyncEvent extends BaseEvent<{
-    error: TimeoutAsyncError;
-}> {
-}
-/**
- * This event is dispatched when the `LazyPromise` has failed all retry attempts.
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Events
- */
-export declare class RetryFailureAsyncEvent extends BaseEvent<{
-    error: RetryAsyncError;
-}> {
-}
-/**
- * This event is dispatched when `LazyPromise` has exceeded the given total time limit.
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Events
- */
-export declare class TotalTimeoutFailureAsyncEvent extends BaseEvent<{
-    error: TimeoutAsyncError;
-}> {
-}
-/**
- * This event is dispatched when `LazyPromise` is aborted.
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Events
- */
-export declare class AbortAsyncEvent extends BaseEvent<{
-    error: AbortAsyncError;
-}> {
-}
-/**
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Events
- */
-export declare const ASYNC_EVENTS: {
-    readonly Failure: typeof FailureAsyncEvent;
-    readonly Success: typeof SuccessAsyncEvent;
-    readonly Finally: typeof FinallyAsyncEvent;
-    readonly RetryAttempt: typeof RetryAttemptAsyncEvent;
-    readonly RetryTimeout: typeof RetryTimeoutAsyncEvent;
-    readonly RetryFailure: typeof RetryFailureAsyncEvent;
-    readonly TotalTimeoutFailure: typeof TotalTimeoutFailureAsyncEvent;
-    readonly Abort: typeof AbortAsyncEvent;
-};
-/**
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Events
- */
-export type AsyncEvents<TValue> = FailureAsyncEvent | SuccessAsyncEvent<TValue> | FinallyAsyncEvent | RetryAttemptAsyncEvent | RetryTimeoutAsyncEvent | RetryFailureAsyncEvent | TotalTimeoutFailureAsyncEvent | AbortAsyncEvent;

package/dist/async/async.events.js

@@ -1,82 +0,0 @@
-import { BaseEvent } from "../event-bus/contracts/_shared.js";
-/**
- * This event is dispatched when the `LazyPromise` has been rejected.
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Events
- */
-export class FailureAsyncEvent extends BaseEvent {
-}
-/**
- * This event is dispatched when the `LazyPromise` has been fulfilled.
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Events
- */
-export class SuccessAsyncEvent extends BaseEvent {
-}
-/**
- * This event is dispatched when the `LazyPromise` has been fulfilled or rejected.
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Events
- */
-// eslint-disable-next-line @typescript-eslint/no-empty-object-type
-export class FinallyAsyncEvent extends BaseEvent {
-}
-/**
- * This event is dispatched on every retry attempt of the `LazyPromise`.
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Events
- */
-export class RetryAttemptAsyncEvent extends BaseEvent {
-}
-/**
- * This event is dispatched when the rety attempt of the `LazyPromise` has exceeded the given time limit.
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Events
- */
-export class RetryTimeoutAsyncEvent extends BaseEvent {
-}
-/**
- * This event is dispatched when the `LazyPromise` has failed all retry attempts.
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Events
- */
-export class RetryFailureAsyncEvent extends BaseEvent {
-}
-/**
- * This event is dispatched when `LazyPromise` has exceeded the given total time limit.
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Events
- */
-export class TotalTimeoutFailureAsyncEvent extends BaseEvent {
-}
-/**
- * This event is dispatched when `LazyPromise` is aborted.
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Events
- */
-export class AbortAsyncEvent extends BaseEvent {
-}
-/**
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Events
- */
-export const ASYNC_EVENTS = {
-    Failure: FailureAsyncEvent,
-    Success: SuccessAsyncEvent,
-    Finally: FinallyAsyncEvent,
-    RetryAttempt: RetryAttemptAsyncEvent,
-    RetryTimeout: RetryTimeoutAsyncEvent,
-    RetryFailure: RetryFailureAsyncEvent,
-    TotalTimeoutFailure: TotalTimeoutFailureAsyncEvent,
-    Abort: AbortAsyncEvent,
-};
-//# sourceMappingURL=async.events.js.map

package/dist/async/async.events.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"async.events.js","sourceRoot":"","sources":["../../src/async/async.events.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,OAAO,iBAAkB,SAAQ,SAErC;CAAG;AAEL;;;;;GAKG;AACH,MAAM,OAAO,iBAA0B,SAAQ,SAE7C;CAAG;AAEL;;;;;GAKG;AACH,mEAAmE;AACnE,MAAM,OAAO,iBAAkB,SAAQ,SAAa;CAAG;AAEvD;;;;;GAKG;AACH,MAAM,OAAO,sBAAuB,SAAQ,SAG1C;CAAG;AAEL;;;;;GAKG;AACH,MAAM,OAAO,sBAAuB,SAAQ,SAE1C;CAAG;AAEL;;;;;GAKG;AACH,MAAM,OAAO,sBAAuB,SAAQ,SAE1C;CAAG;AAEL;;;;;GAKG;AACH,MAAM,OAAO,6BAA8B,SAAQ,SAEjD;CAAG;AAEL;;;;;GAKG;AACH,MAAM,OAAO,eAAgB,SAAQ,SAEnC;CAAG;AAEL;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,OAAO,EAAE,iBAAiB;IAC1B,OAAO,EAAE,iBAAiB;IAC1B,OAAO,EAAE,iBAAiB;IAC1B,YAAY,EAAE,sBAAsB;IACpC,YAAY,EAAE,sBAAsB;IACpC,YAAY,EAAE,sBAAsB;IACpC,mBAAmB,EAAE,6BAA6B;IAClD,KAAK,EAAE,eAAe;CAChB,CAAC"}

package/dist/event-bus/contracts/_shared.d.ts

@@ -1,12 +0,0 @@
-/**
- * @module EventBus
- */
-/**
- *
- * IMPORT_PATH: `"@daiso-tech/core/event-bus/contracts"`
- * @group Contracts
- */
-export declare abstract class BaseEvent<TFields extends Record<string, unknown> = Record<string, unknown>> {
-    readonly fields: TFields;
-    constructor(fields: TFields);
-}

package/dist/event-bus/contracts/_shared.js

@@ -1,15 +0,0 @@
-/**
- * @module EventBus
- */
-/**
- *
- * IMPORT_PATH: `"@daiso-tech/core/event-bus/contracts"`
- * @group Contracts
- */
-export class BaseEvent {
-    fields;
-    constructor(fields) {
-        this.fields = fields;
-    }
-}
-//# sourceMappingURL=_shared.js.map

package/dist/event-bus/contracts/_shared.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../../src/event-bus/contracts/_shared.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,MAAM,OAAgB,SAAS;IAGN;IAArB,YAAqB,MAAe;QAAf,WAAM,GAAN,MAAM,CAAS;IAAG,CAAC;CAC3C"}

package/dist/test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/test.js

@@ -1,34 +0,0 @@
-import { observe, LazyPromise } from "./async/_module-exports.js";
-import { AsyncHooks, TimeSpan } from "./utilities/_module-exports.js";
-await new AsyncHooks(
-// Lets pretend this function can throw and takes time to execute.
-async (a, b) => {
-    const shouldThrow1 = Math.round(Math.random() * 100);
-    if (shouldThrow1 > 50) {
-        throw new Error("Unexpected error occured");
-    }
-    await LazyPromise.delay(TimeSpan.fromMilliseconds(Math.random() * 1000));
-    const shouldThrow2 = Math.round(Math.random() * 100);
-    if (shouldThrow2 > 50) {
-        throw new Error("Unexpected error occured");
-    }
-    return a / b;
-}, observe({
-    onStart: (data) => {
-        console.log("START:", data);
-    },
-    onSuccess: (data) => {
-        console.log("SUCCESS:", data);
-    },
-    onError: (data) => {
-        console.error("ERROR:", data);
-    },
-    onFinally: (data) => {
-        console.log("FINALLY:", data);
-    },
-})).invoke(20, 10);
-// Will log when the function execution has started.
-// Will log if the function succeded.
-// Will log if the function errored and the error.
-// Will log the execution time
-//# sourceMappingURL=test.js.map

package/dist/test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"test.js","sourceRoot":"","sources":["../src/test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAEtE,MAAM,IAAI,UAAU;AAChB,kEAAkE;AAClE,KAAK,EAAE,CAAS,EAAE,CAAS,EAAmB,EAAE;IAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;IACrD,IAAI,YAAY,GAAG,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,WAAW,CAAC,KAAK,CACnB,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAClD,CAAC;IACF,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;IACrD,IAAI,YAAY,GAAG,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,CAAC;AACjB,CAAC,EACD,OAAO,CAAC;IACJ,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;QACd,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;QAChB,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;QACd,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;QAChB,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;CACJ,CAAC,CACL,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;AACjB,oDAAoD;AACpD,qCAAqC;AACrC,kDAAkD;AAClD,8BAA8B"}

package/dist/utilities/contracts/sync-event-bus-listenable.d.ts

@@ -1,13 +0,0 @@
-/**
- * @module Utilities
- */
-import type { BaseEvent, EventClass, EventInstance, EventListener } from "../../event-bus/contracts/_module-exports.js";
-/**
- *
- * IMPORT_PATH: `"@daiso-tech/core/utilities"`
- * @group Contracts
- */
-export type ISyncEventListenable<TEvents extends BaseEvent> = {
-    addListener<TEventClass extends EventClass<TEvents>>(event: TEventClass, listener: EventListener<EventInstance<TEventClass>>): void;
-    removeListener<TEventClass extends EventClass<TEvents>>(event: TEventClass, listener: EventListener<EventInstance<TEventClass>>): void;
-};

package/dist/utilities/contracts/sync-event-bus-listenable.js

@@ -1,5 +0,0 @@
-/**
- * @module Utilities
- */
-export {};
-//# sourceMappingURL=sync-event-bus-listenable.js.map

package/dist/utilities/contracts/sync-event-bus-listenable.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sync-event-bus-listenable.js","sourceRoot":"","sources":["../../../src/utilities/contracts/sync-event-bus-listenable.ts"],"names":[],"mappings":"AAAA;;GAEG"}