@daiso-tech/core 0.33.0 → 0.35.0

package/dist/async/utilities/lazy-promise/lazy-promise.js

@@ -1,64 +1,35 @@
-import { retryOrFail } from "../../../async/utilities/retry/_module.js";
-import { timeoutAndFail } from "../../../async/utilities/timeout/_module.js";
-import { abortAndFail } from "../../../async/utilities/abort/_module.js";
-import { 
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-TimeoutAsyncError, } from "../../../async/async.errors.js";
-import { 
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-RetryAsyncError, } from "../../../async/async.errors.js";
-import { 
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-AbortAsyncError, } from "../../../async/async.errors.js";
-import { removeUndefinedProperties, resolveAsyncLazyable, resolveInvokable, SyncEventBus, } from "../../../utilities/_module-exports.js";
-import { delay } from "../../../async/utilities/_module.js";
-import { AbortAsyncEvent, FailureAsyncEvent, FinallyAsyncEvent, RetryAttemptAsyncEvent, RetryFailureAsyncEvent, RetryTimeoutAsyncEvent, SuccessAsyncEvent, TotalTimeoutFailureAsyncEvent, } from "../../../async/async.events.js";
 /**
- * The <i>LazyPromise</i> class is used for creating lazy <i>{@link PromiseLike}<i> object that will only execute when awaited or when then method is called.
- * The class includes helpful methods
- * - <i>defer</i>
- * - <i>setRetryTimeout</i>
- * - <i>setRetryPolicy</i>
- * - <i>setBackoffPolicy</i>
- * - <i>setRetryAttempts</i>
- * - <i>setTotalTimeout</i>
- * - <i>setAbortSignal</i>
- *
- * The order in which these methods are called does not have any affect. Internally, the following execution order is applied:
- * 1. <i>setRetryTimeout</i>
- * 2. <i>setRetryPolicy</i>
- * 3. <i>setBackoffPolicy</i>
- * 4. <i>setRetryAttempts</i>
- * 5. <i>setTotalTimeout</i>
- * 6. <i>setAbortSignal</i>
+ * @module Async
+ */
+import { AsyncHooks, callInvokable, resolveAsyncLazyable, } from "../../../utilities/_module-exports.js";
+import { abortAndFail } from "../../../async/utilities/abort-and-fail/_module.js";
+/**
+ * The `LazyPromise` class is used for creating lazy {@link PromiseLike | `PromiseLike`} object that will only execute when awaited or when `then` method is called.
+ * Note the class is immutable.
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Utilities
  */
 export class LazyPromise {
     /**
-     * The <i>wrapFn</i> is convience method used for wrapping async <i>{@link Invokable}</i> with a <i>LazyPromise</i>.
+     * The `wrapFn` is convience method used for wrapping async {@link Invokable | `Invokable`} with a `LazyPromise`.
      * @example
      * ```ts
-     * import { LazyPromise } from "@daiso-tech/core/async";
+     * import { LazyPromise, retry } from "@daiso-tech/core/async";
      * import { TimeSpan } from "@daiso-tech/core/utilities";
      * import { readFile as readFileNodeJs } from "node:fs/promises";
      *
      * const readFile = LazyPromise.wrapFn(readFileNodeJs);
      *
-     * const file = await readFile("none_existing_file.txt")
-     *   .setRetryAttempts(4)
-     *   .setRetryTimeout(TimeSpan.fromMinutes(1));
+     * const file = await readFile("none_existing_file.txt");
      * ```
      */
-    static wrapFn(fn, settings) {
-        return (...parameters) => new LazyPromise(() => resolveInvokable(fn)(...parameters), settings);
+    static wrapFn(fn) {
+        return (...parameters) => new LazyPromise(() => callInvokable(fn, ...parameters));
     }
     /**
-     * The <i>delay</i> method creates a <i>{@link LazyPromise}</i> that will be fulfilled after given <i>time</i>.
+     * The `delay` method creates a {@link LazyPromise | `LazyPromise`} that will be fulfilled after given `time`.
      *
-     * @throws {AsyncError} {@link AsyncError}
-     * @throws {AbortAsyncError} {@link AbortAsyncError}
      * @example
      * ```ts
      * import { LazyPromise } from "@daiso-tech/core/async";
@@ -69,37 +40,49 @@ export class LazyPromise {
      * console.log("b");
      * ```
      */
-    static delay(time) {
+    static delay(time, abortSignal = new AbortController().signal) {
         return new LazyPromise(async () => {
-            await delay(time);
+            let timeoutId = null;
+            try {
+                await abortAndFail(new Promise((resolve) => {
+                    timeoutId = setTimeout(() => {
+                        resolve();
+                    }, time.toMilliseconds());
+                }), abortSignal);
+            }
+            finally {
+                if (timeoutId !== null) {
+                    clearTimeout(timeoutId);
+                }
+            }
         });
     }
     /**
-     * The <i>all<i> method works similarly to <i>{@link Promise.all}</i> with the key distinction that it operates lazily.
+     * The `all` method works similarly to {@link Promise.all | `Promise.all`} with the key distinction that it operates lazily.
      */
-    static all(promises, settings) {
-        return new LazyPromise(async () => Promise.all(promises), settings);
+    static all(promises) {
+        return new LazyPromise(async () => Promise.all(promises));
     }
     /**
-     * The <i>allSettled<i> method works similarly to <i>{@link Promise.allSettled}</i> with the key distinction that it operates lazily.
+     * The `allSettled` method works similarly to {@link Promise.allSettled | `Promise.allSettled`} with the key distinction that it operates lazily.
      */
-    static allSettled(promises, settings) {
-        return new LazyPromise(async () => Promise.allSettled(promises), settings);
+    static allSettled(promises) {
+        return new LazyPromise(async () => Promise.allSettled(promises));
     }
     /**
-     * The <i>race<i> method works similarly to <i>{@link Promise.race}</i> with the key distinction that it operates lazily.
+     * The `race` method works similarly to {@link Promise.race | `Promise.race`} with the key distinction that it operates lazily.
      */
-    static race(promises, settings) {
-        return new LazyPromise(async () => Promise.race(promises), settings);
+    static race(promises) {
+        return new LazyPromise(async () => Promise.race(promises));
     }
     /**
-     * The <i>any<i> method works similarly to <i>{@link Promise.any}</i> with the key distinction that it operates lazily.
+     * The `any` method works similarly to {@link Promise.any | `Promise.any`} with the key distinction that it operates lazily.
      */
-    static any(promises, settings) {
-        return new LazyPromise(async () => Promise.any(promises), settings);
+    static any(promises) {
+        return new LazyPromise(async () => Promise.any(promises));
     }
     /**
-     * The <i>fromCallback</i> is convience method used for wrapping Node js callback functions with a <i>LazyPromise</i>.
+     * The `fromCallback` is convience method used for wrapping Node js callback functions with a `LazyPromise`.
      * @example
      * ```ts
      * import { LazyPromise } from "@daiso-tech/core/async";
@@ -118,321 +101,55 @@ export class LazyPromise {
      * console.log(file);
      * ```
      */
-    static fromCallback(callback, settings) {
+    static fromCallback(callback) {
         return new LazyPromise(() => new Promise((resolve, reject) => {
             callback(resolve, reject);
-        }), settings);
+        }));
     }
     promise = null;
-    asyncFn;
-    settings;
-    eventBus = new SyncEventBus();
+    invokable;
     /**
      * @example
      * ```ts
-     * import { LazyPromise } from "@daiso-tech/core/async";
+     * import { LazyPromise, retryMiddleware } from "@daiso-tech/core/async";
      *
      * const promise = new LazyPromise(async () => {
      *   console.log("I am lazy");
-     * });
+     * },
+     *   // You can also pass in one AsyncMiddleware or multiple (as an Array).
+     *   retry()
+     * );
      *
      * // "I am lazy" will only logged when awaited or then method i called.
      * await promise;
      * ```
      *
-     * You can pass sync or async <i>{@link Invokable}</i>.
+     * You can pass sync or async {@link Invokable | `Invokable`}.
      */
-    constructor(invokable, settings = {}) {
-        this.asyncFn = () => resolveAsyncLazyable(invokable);
-        this.settings = removeUndefinedProperties({
-            retryAttempts: null,
-            backoffPolicy: null,
-            retryPolicy: null,
-            retryTimeout: null,
-            totalTimeout: null,
-            abortSignal: null,
-            onFinally: () => { },
-            onSuccess: (_value) => { },
-            onError: () => { },
-            ...settings,
-        });
-    }
-    addListener(event, listener) {
-        this.eventBus.addListener(event, listener);
-    }
-    removeListener(event, listener) {
-        this.eventBus.removeListener(event, listener);
-    }
-    applyRetryTimeout() {
-        if (this.settings.retryTimeout === null) {
-            return;
-        }
-        const oldAsyncFn = this.asyncFn;
-        const newAsyncFn = async () => {
-            try {
-                if (this.settings.retryTimeout === null) {
-                    throw new Error(`LazyPromise["time"] field is null`);
-                }
-                return await timeoutAndFail(oldAsyncFn, this.settings.retryTimeout);
-            }
-            catch (error) {
-                if (error instanceof TimeoutAsyncError) {
-                    this.eventBus.dispatch(new RetryTimeoutAsyncEvent({ error }));
-                }
-                throw error;
-            }
-        };
-        this.asyncFn = newAsyncFn;
-    }
-    applyRetry() {
-        if (this.settings.retryAttempts === null) {
-            return;
-        }
-        this.applyRetryTimeout();
-        const oldAsyncFn = this.asyncFn;
-        const newAsyncFn = async () => {
-            try {
-                if (this.settings.retryAttempts === null) {
-                    throw new Error(`LazyPromise["attempts"] field is null`);
-                }
-                return await retryOrFail(async (attempt) => {
-                    try {
-                        return await oldAsyncFn();
-                    }
-                    catch (error) {
-                        this.eventBus.dispatch(new RetryAttemptAsyncEvent({
-                            attempt,
-                            error,
-                        }));
-                        throw error;
-                    }
-                }, {
-                    backoffPolicy: this.settings.backoffPolicy ?? undefined,
-                    retryPolicy: this.settings.retryPolicy ?? undefined,
-                    maxAttempts: this.settings.retryAttempts,
-                });
-            }
-            catch (error) {
-                if (error instanceof RetryAsyncError) {
-                    this.eventBus.dispatch(new RetryFailureAsyncEvent({ error }));
-                }
-                throw error;
-            }
-        };
-        this.asyncFn = newAsyncFn;
-    }
-    applyTotalTimeout() {
-        if (this.settings.totalTimeout === null) {
-            return;
-        }
-        const oldAsyncFn = this.asyncFn;
-        const newAsyncFn = () => {
-            try {
-                if (this.settings.totalTimeout === null) {
-                    throw new Error(`LazyPromise["time"] field is null`);
-                }
-                return timeoutAndFail(oldAsyncFn, this.settings.totalTimeout);
-            }
-            catch (error) {
-                if (error instanceof TimeoutAsyncError) {
-                    this.eventBus.dispatch(new TotalTimeoutFailureAsyncEvent({ error }));
-                }
-                throw error;
-            }
-        };
-        this.asyncFn = newAsyncFn;
-    }
-    applyAbort() {
-        if (this.settings.abortSignal === null) {
-            return;
-        }
-        const oldAsyncFn = this.asyncFn;
-        const newAsyncFn = async () => {
-            try {
-                if (this.settings.abortSignal === null) {
-                    throw new Error(`LazyPromise["abortSignal"] field is null`);
-                }
-                return await abortAndFail(oldAsyncFn, this.settings.abortSignal);
-            }
-            catch (error) {
-                if (error instanceof AbortAsyncError) {
-                    this.eventBus.dispatch(new AbortAsyncEvent({ error }));
-                }
-                throw error;
-            }
-        };
-        this.asyncFn = newAsyncFn;
-    }
-    applySettings() {
-        this.applyRetry();
-        this.applyTotalTimeout();
-        this.applyAbort();
+    constructor(invokable, middlewares = []) {
+        this.invokable = new AsyncHooks(() => resolveAsyncLazyable(invokable), middlewares);
     }
     /**
-     * The <i>setBackoffPolicy</i> method is used for setting a custom <i>{@link BackoffPolicy}</i>.
-     * ```ts
-     * import { LazyPromise, linearBackoffPolicy } from "@daiso-tech/core/async";
-     * import { TimeSpan } from "@daiso-tech/core/utilities";
-     *
-     * const promise =
-     *   new LazyPromise(async () => {
-     *     console.log("A");
-     *     throw new Error("Error occured!");
-     *   })
-     *   .setRetryAttempts(3)
-     *   .setBackoffPolicy(linearBackoffPolicy())
-     *
-     * // Will log "A" 3 times and then retry error will be thrown.
-     * await promise;
-     * ```
+     * The `pipe` method returns a new `LazyPromise` instance with the additional `middlewares` applied.
      */
-    setBackoffPolicy(policy) {
-        return new LazyPromise(this.asyncFn, {
-            ...this.settings,
-            backoffPolicy: policy,
-        });
+    pipe(middlewares) {
+        return new LazyPromise(this.invokable.pipe(middlewares));
     }
     /**
-     * The <i>setRetryAttempts</i> method is used for setting max retry attempts.
-     * @example
-     * ```ts
-     * import { LazyPromise } from "@daiso-tech/core/async";
-     *
-     * const promise =
-     *   new LazyPromise(async () => {
-     *     console.log("A");
-     *     throw new Error("Error occured!");
-     *   })
-     *   .setRetryAttempts(3)
-     *
-     * // Will log "A" 3 times and then retry error will be thrown.
-     * await promise;
-     * ```
+     * The `pipeWhen` method conditionally applies additional `middlewares`, returning a new `LazyPromise` instance only if the specified condition is met.
      */
-    setRetryAttempts(attempts) {
-        return new LazyPromise(this.asyncFn, {
-            ...this.settings,
-            retryAttempts: attempts,
-        });
-    }
-    /**
-     * The <i>setRetryPolicy</i> method is used for setting a custom <i>{@link BackoffPolicy}</i>.
-     * @example
-     * ```ts
-     * import { LazyPromise } from "@daiso-tech/core/async";
-     *
-     * class ErrorA extends Error {}
-     *
-     * const promise =
-     *   new LazyPromise(async () => {
-     *     console.log("A");
-     *     throw new Error("Error occured!");
-     *   })
-     *   .setRetryAttempts(3)
-     *   // Will only retry an error that is instance ErrorA
-     *   .setRetryPolicy(error => error instanceof ErrorA)
-     *
-     * // Will log "A" 1 time and then error will be thrown.
-     * await promise;
-     * ```
-     */
-    setRetryPolicy(policy) {
-        return new LazyPromise(this.asyncFn, {
-            ...this.settings,
-            retryPolicy: policy,
-        });
+    pipeWhen(condition, middlewares) {
+        return new LazyPromise(this.invokable.pipeWhen(condition, middlewares));
     }
-    /**
-     * The <i>setRetryTimeout</i> method aborts the each retry if it exceeds the given <i>time</i>.
-     * @example
-     * ```ts
-     * import { LazyPromise } from "@daiso-tech/core/async";
-     * import { TimeSpan } from "@daiso-tech/core/utilities";
-     *
-     * const promise =
-     *   new LazyPromise(async () => {
-     *     await LazyPromise.delay(TimeSpan.fromMinutes(1));
-     *   })
-     *   .setRetryTimeout(TimeSpan.fromSeconds(1));
-     *
-     * // An timeout error will be thrown.
-     * await promise;
-     * ```
-     */
-    setRetryTimeout(time) {
-        return new LazyPromise(this.asyncFn, {
-            ...this.settings,
-            retryTimeout: time,
-        });
-    }
-    /**
-     * The <i>setTotalTimeout</i> method aborts the <i>LazyPromise</i> if it exceeds the given <i>time</i> by throwning an error.
-     * @example
-     * ```ts
-     * import { LazyPromise } from "@daiso-tech/core/async";
-     * import { TimeSpan } from "@daiso-tech/core/utilities";
-     *
-     * const promise =
-     *   new LazyPromise(async () => {
-     *     await LazyPromise.delay(TimeSpan.fromMinutes(1));
-     *   })
-     *   .setRetryTimeout(TimeSpan.fromSeconds(1));
-     *
-     * // An timeout error will be thrown.
-     * await promise;
-     * ```
-     */
-    setTotalTimeout(time) {
-        return new LazyPromise(this.asyncFn, {
-            ...this.settings,
-            totalTimeout: time,
-        });
-    }
-    /**
-     * The <i>setAbortSignal</i> method aborts the <i>LazyPromise</i> by the passed in <i>abortSignal</i>.
-     * @example
-     * ```ts
-     * import { LazyPromise } from "@daiso-tech/core";
-     * import { TimeSpan } from "@daiso-tech/core/utilities";
-     *
-     * const abortController = new AbortController();
-     * const promise =
-     *   new LazyPromise(async () => {
-     *     await LazyPromise.delay(TimeSpan.fromMinutes(1));
-     *   })
-     *   .setAbortSignal(abortController.signal);
-     *
-     * setTimeout(() => {
-     *   abortController.abort();
-     * }, 1000);
-     *
-     * // An timeout error will be thrown.
-     * await promise;
-     * ```
-     */
-    setAbortSignal(abortSignal) {
-        return new LazyPromise(this.asyncFn, {
-            ...this.settings,
-            abortSignal,
-        });
-    }
-    /**
-     * @throws {AbortAsyncError} {@link AbortAsyncError}
-     * @throws {TimeoutAsyncError} {@link TimeoutAsyncError}
-     * @throws {RetryAsyncError} {@link RetryAsyncError}
-     */
-    then(onfulfilled, 
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    onrejected) {
-        this.applySettings();
+    then(onfulfilled, onrejected) {
         if (this.promise === null) {
-            this.promise = this.asyncFn();
+            this.promise = this.invokable.invoke();
         }
         // eslint-disable-next-line @typescript-eslint/use-unknown-in-catch-callback-variable
         return this.promise.then(onfulfilled, onrejected);
     }
     /**
-     * The <i>defer</i> method executes the <i>LazyPromise</i> without awaiting it.
+     * The `defer` method executes the `LazyPromise` without awaiting it.
      * @example
      * ```ts
      * import { LazyPromise } from "@daiso-tech/core/async";
@@ -453,21 +170,7 @@ export class LazyPromise {
      * ```
      */
     defer() {
-        const onFinally = () => {
-            this.eventBus.dispatch(new FinallyAsyncEvent({}));
-            this.eventBus.clear();
-        };
-        const onSuccess = (value) => {
-            this.eventBus.dispatch(new SuccessAsyncEvent({ value }));
-            onFinally();
-            return value;
-        };
-        const onFailure = (error) => {
-            this.eventBus.dispatch(new FailureAsyncEvent({ error }));
-            onFinally();
-            return error;
-        };
-        this.then(onSuccess, onFailure);
+        this.then(() => { });
     }
 }
 //# sourceMappingURL=lazy-promise.js.map

package/dist/async/utilities/lazy-promise/lazy-promise.js.map

@@ -1 +1 @@
-{"version":3,"file":"lazy-promise.js","sourceRoot":"","sources":["../../../../src/async/utilities/lazy-promise/lazy-promise.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lazy-promise.js","sourceRoot":"","sources":["../../../../src/async/utilities/lazy-promise/lazy-promise.ts"],"names":[],"mappings":"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"}

package/dist/async/utilities/promise-queue/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../async/utilities/promise-queue/promise-queue.js";

package/dist/async/utilities/promise-queue/_module.js

@@ -0,0 +1,2 @@
+export * from "../../../async/utilities/promise-queue/promise-queue.js";
+//# sourceMappingURL=_module.js.map

package/dist/async/utilities/promise-queue/_module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../src/async/utilities/promise-queue/_module.ts"],"names":[],"mappings":"AAAA,cAAc,kDAAkD,CAAC"}

package/dist/async/utilities/promise-queue/promise-queue.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @module Async
+ */
+import type { TimeSpan } from "../../../utilities/_module-exports.js";
+import { type InvokableFn, type Promisable } from "../../../utilities/_module-exports.js";
+/**
+ * @internal
+ */
+export type PromiseQueueSettings = {
+    maxConcurrency: number;
+    maxCapacity: number | null;
+    interval: TimeSpan;
+};
+/**
+ * @internal
+ */
+export declare class PromiseQueue {
+    private readonly settings;
+    private readonly queue;
+    private readonly listeners;
+    constructor(settings: PromiseQueueSettings);
+    private start;
+    private getItems;
+    private process;
+    private enqueue;
+    private listenOnce;
+    private asPromise;
+    /**
+     * @throws {CapacityFullAsyncError} {@link CapacityFullAsyncError}
+     */
+    add<TValue>(func: InvokableFn<[signal: AbortSignal], Promisable<TValue>>, signal: AbortSignal): Promise<TValue>;
+}