@handy-common-utils/promise-utils 1.4.1 → 1.6.0

package/dist/promise-utils.d.ts

@@ -32,8 +32,8 @@ export declare enum PromiseState {
 }
 export declare abstract class PromiseUtils {
     /**
-     * Do an operation repeatedly and collect all the results.
-     * This function is useful for client side pagination.
+     * Executes an operation repeatedly and collects all the results.
+     * This function is very useful for many scenarios, such like client-side pagination.
      *
      * @example
      * const domainNameObjects = await PromiseUtils.repeat(
@@ -43,59 +43,84 @@ export declare abstract class PromiseUtils {
      *   [] as APIGateway.DomainName[],
      * );
      *
-     * @template Result type of the operation result
-     * @template Param  type of the input to the operation, normally the input is a paging parameter
-     * @template Collection type of the returned value of this function
+     * @template Result The type of the operation result.
+     * @template Param The type of the input to the operation, typically a paging parameter.
+     * @template Collection The type of the collection returned by this function.
      *
-     * @param operation a function that takes paging parameter as input and outputs a result, normally the operation supports paging
-     * @param nextParameter The function for calculating next parameter from the operation result.
-     *                      Normally the parameter controls paging,
-     *                      This function should return null when next invocation of the operation function is not desired.
-     *                      If next invocation is desired, the return value of this function can be a Promise or not a Promise.
-     * @param collect the function for merging operation result into the collection
-     * @param initialCollection initial collection which would be the first argument passed into the first invocation of the collect function
-     * @param initialParameter the parameter for the first operation
-     * @returns Promise of collection of all the results returned by the operation function
+     * @param operation A function that takes a parameter as input and returns a result. Typically, the parameter has optional fields to control paging.
+     * @param nextParameter A function for calculating the next parameter from the operation result.
+     *        Normally, this parameter controls paging.
+     *        This function should return null when no further invocation of the operation function is desired.
+     *        If further invocation is desired, the return value of this function can be a Promise or a non-Promise value.
+     * @param collect A function for merging the operation result into the collection.
+     * @param initialCollection The initial collection, which will be the first argument passed to the first invocation of the collect function.
+     * @param initialParameter The parameter for the first operation.
+     * @returns A promise that resolves to a collection of all the results returned by the operation function.
      *
      */
     static repeat<Result, Param, Collection>(operation: (parameter: Partial<Param>) => Promise<Result>, nextParameter: (response: Result) => Partial<Param> | Promise<Partial<Param>> | null, collect: (collection: Collection, result: Result) => Collection, initialCollection: Collection, initialParameter?: Partial<Param>): Promise<Collection>;
     /**
-     * Do an operation repeatedly until a criteria is met.
+     * Repeatedly performs an operation until a specified criteria is met.
      *
      * @example
      * const result = await PromiseUtils.withRetry(() => doSomething(), [100, 200, 300, 500, 800, 1000]);
      * const result2 = await PromiseUtils.withRetry(() => doSomething(), Array.from({length: 10}, (_v, i) => 1000 * Math.min(FIBONACCI_SEQUENCE[i], 10), err => err.statusCode === 429);
      * const result3 = await PromiseUtils.withRetry(() => doSomething(), attempt => attempt <= 8 ? 1000 * Math.min(FIBONACCI_SEQUENCE[attempt - 1], 10) : undefined, err => err.statusCode === 429);
      *
-     * @template Result type of the operation result
-     * @template TError  type of the possible error that could be generated by the operation
-     *
-     * @param operation a function that outputs a Promise result, normally the operation does not use its arguments
-     * @param backoff Array of retry backoff periods (unit: milliseconds) or function for calculating them.
-     *                If retry is desired, before making next call to the operation the desired backoff period would be waited.
-     *                If the array runs out of elements or the function returns `undefined` or either the array or the function returns a negative number,
-     *                there would be no further call to the operation.
-     *                The `attempt` argument passed into backoff function starts from 1 because the function is called right after the first attempt and before the first retry.
-     * @param shouldRetry Predicate function for deciding whether another call to the operation should happen.
-     *                    If this argument is not defined, retry would happen whenever the operation rejects with an error.
-     *                    `shouldRetry` would be evaluated before `backoff`.
-     *                    The `attempt` argument passed into shouldRetry function starts from 1.
-     * @returns Promise of the operation result potentially with retries already applied
+     * @template Result Type of the operation result.
+     * @template TError Type of the possible error that could be generated by the operation.
+     *
+     * @param operation A function that outputs a Promise result. Typically, the operation does not use its arguments.
+     * @param backoff An array of retry backoff periods (in milliseconds) or a function for calculating them.
+     *                If retry is desired, the specified backoff period is waited before the next call to the operation.
+     *                If the array runs out of elements or the function returns `undefined` or a negative number, no further calls to the operation will be made.
+     *                The `attempt` argument passed to the backoff function starts from 1, as it is called immediately after the first attempt and before the first retry.
+     * @param shouldRetry A predicate function for deciding whether another call to the operation should occur.
+     *                    If this argument is not defined, a retry will occur whenever the operation rejects with an error.
+     *                    The `shouldRetry` function is evaluated before the `backoff`.
+     *                    The `attempt` argument passed to the shouldRetry function starts from 1.
+     * @returns A promise of the operation result, potentially with retries applied.
      */
     static withRetry<Result, TError = any>(operation: (attempt: number, previousResult: Result | undefined, previousError: TError | undefined) => Promise<Result>, backoff: Array<number> | ((attempt: number, previousResult: Result | undefined, previousError: TError | undefined) => number | undefined), shouldRetry?: (previousError: TError | undefined, previousResult: Result | undefined, attempt: number) => boolean): Promise<Result>;
     /**
-     * Run multiple jobs/operations in parallel.
+     * Executes multiple jobs/operations with a specified level of concurrency.
+     *
+     * Unlike `inParallel(...)`, this function may throw or reject an error when a job/operation fails.
+     * When an error is re-thrown, remaining operations will not be executed.
+     * If you want all the operations to always be executed, use {@link PromiseUtils.inParallel} instead.
+     *
+     * @example
+     * // At any time, there would be no more than 5 concurrency API calls. Error would be re-thrown immediately when it occurs.
+     * const attributes = await PromiseUtils.withConcurrency(5, topicArns, async (topicArn) => {
+     *   const topicAttributes = (await sns.getTopicAttributes({ TopicArn: topicArn }).promise()).Attributes!;
+     *   return topicAttributes;
+     * });
+     *
      *
-     * By default this function does not throw / reject with error when any of the job/operation fails.
-     * Operation errors are returned together with operation results in the same returned array.
-     * That also means this function only returns when all the jobs/operations settle (either resolve or reject).
+     * @template Data   The type of the job data, typically an Array.
+     * @template Result The type of the return value from the operation function.
      *
-     * However, if options.abortOnError is true, this function throws / rejects with error when any of the job/operation fails.
-     * That also means, some of the jobs/operations may not get the chance to be executed if one of them fails.
+     * @param concurrency The number of jobs/operations to run concurrently.
+     * @param jobs The job data to be processed. This function can handle an infinite or unknown number of elements safely.
+     * @param operation The function that processes job data asynchronously.
+     * @returns A promise that resolves to an array containing the results from the operation function.
+     *          The results in the returned array are in the same order as the corresponding elements in the jobs array.
+     */
+    static withConcurrency<Data, Result>(concurrency: number, jobs: Iterable<Data>, operation: (job: Data, index: number) => Promise<Result>): Promise<Array<Result>>;
+    /**
+     * Executes multiple jobs/operations in parallel. By default, all operations are executed regardless of any failures.
+     * In most cases, using {@link PromiseUtils.withConcurrency} might be more convenient.
+     *
+     * By default, this function does not throw or reject an error when any job/operation fails.
+     * Errors from operations are returned alongside results in the returned array.
+     * This function only resolves when all jobs/operations are settled (either resolved or rejected).
+     *
+     * If `options.abortOnError` is set to true, this function throws (or rejects with) an error immediately when any job/operation fails.
+     * In this mode, some jobs/operations may not be executed if one fails.
      *
      * @example
      * // Capture errors in the returned array
-     * const attributesAndPossibleErrors = await PromiseUtils.inParallel(5, topicArns, async (topicArn) => {
+     * const attributesAndPossibleErrors: Array<JobResult|JobError> = await PromiseUtils.inParallel(5, topicArns, async (topicArn) => {
      *   const topicAttributes = (await sns.getTopicAttributes({ TopicArn: topicArn }).promise()).Attributes!;
      *   return topicAttributes;
      * });
@@ -108,88 +133,95 @@ export declare abstract class PromiseUtils {
      *   // handle the error
      * }
      *
-     * @template Data   Type of the job data, usually it would be an Array
-     * @template Result Type of the return value of the operation function
-     *
-     * @param parallelism how many jobs/operations can be running at the same time
-     * @param jobs        job data which will be the input to operation function.
-     *                    This function is safe when there are infinite unknown number of elements in the job data.
-     * @param operation   the function that turns job data into result asynchronously
-     * @param options     Options for controlling the behavior of this function.
-     * @returns Promise of void if the operation function does not return a value,
-     *          or promise of an array containing outcomes from the operation function.
-     *          In the returned array containing outcomes, each element is either the fulfilled result, or the rejected error/reason.
+     * @template Data   The type of the job data, typically an Array.
+     * @template Result The type of the return value from the operation function.
+     * @template TError The type for the error that could be thrown from the operation function, defaults to `Result`.
+     *
+     * @param parallelism The number of jobs/operations to run concurrently.
+     * @param jobs The job data to be processed. This function can safely handle an infinite or unknown number of elements.
+     * @param operation The function that processes job data asynchronously.
+     * @param options Options to control the function's behavior.
+     * @param options.abortOnError If true, the function aborts and throws an error on the first failed operation.
+     * @returns A promise that resolves to an array containing the results of the operations.
+     *  Each element is either a fulfilled result or a rejected error/reason.
+     *  The results or errors in the returned array are in the same order as the corresponding elements in the jobs array.
      */
     static inParallel<Data, Result, TError = Result>(parallelism: number, jobs: Iterable<Data>, operation: (job: Data, index: number) => Promise<Result>, options?: {
         abortOnError: boolean;
     }): Promise<Array<Result | TError>>;
     /**
-     * Create a Promise that resolves after number of milliseconds specified
-     * @param ms number of milliseconds after which the created Promise would resolve
-     * @param result the result to be resolved for the Promise, or a function that supplies the result.
-     * @returns the new Promise created
+     * Creates a Promise that resolves after a specified number of milliseconds.
+     *
+     * @param ms The number of milliseconds after which the created Promise will resolve.
+     * @param result The result to be resolved by the Promise, or a function that supplies the result.
+     * @returns A new Promise that resolves with the specified result after the specified delay.
      */
     static delayedResolve<T>(ms: number, result?: T | PromiseLike<T> | (() => (T | PromiseLike<T>))): Promise<T>;
     /**
-     * Create a Promise that rejects after number of milliseconds specified.
-     * @param ms number of milliseconds after which the created Promise would reject
-     * @param reason the reason of the rejection for the Promise, or a function that supplies the reason.
-     * If the reason ends up to be a rejected Promise, then the outcome (could be fulfilled or rejected) of it will be the reject reason of the Promise returned.
-     * @returns the new Promise created
+     * Creates a Promise that rejects after a specified number of milliseconds.
+     *
+     * @param ms The number of milliseconds after which the created Promise will reject.
+     * @param reason The reason for the rejection, or a function that supplies the reason.
+     *               If the reason is a rejected Promise, the outcome of it will be the rejection reason of the returned Promise.
+     * @returns A new Promise that rejects with the specified reason after the specified delay.
      */
     static delayedReject<T = never, R = any>(ms: number, reason: R | PromiseLike<R> | (() => R | PromiseLike<R>)): Promise<T>;
     /**
      * Applies a timeout to a Promise or a function that returns a Promise.
-     * If the timeout occurs, resolves to the specified result.
-     * If the timeout doesn't occur, the resolved result or rejection reason of the original Promise will be the outcome of the Promise returned from this function.
-     * If the 'result' parameter is a function and timeout doesn't occur, the function won't be called.
-     * The rejection of the 'operation' parameter is not handled by this function, you may want to handle it outside of this function to avoid warnings like "(node:4330) PromiseRejectionHandledWarning: Promise rejection was handled asynchronously".
+     * If the timeout occurs, the returned Promise resolves to the specified result.
+     * If the timeout does not occur, the returned Promise resolves or rejects based on the outcome of the original Promise.
+     * If the `result` parameter is a function and the timeout does not occur, the function will not be called.
+     * Note: The rejection of the `operation` parameter is not handled by this function.
+     * You may want to handle it outside this function to avoid warnings like "(node:4330) PromiseRejectionHandledWarning: Promise rejection was handled asynchronously."
      *
-     * @param operation The original Promise or a function that returns a Promise for which the timeout will be applied.
+     * @param operation The original Promise or a function that returns a Promise to which the timeout will be applied.
      * @param ms The number of milliseconds for the timeout.
-     * @param result The result to be resolved with if the timeout occurs, or a function that supplies the result.
-     * @return A new Promise that resolves to the specified result if the timeout occurs.
+     * @param result The result to resolve with if the timeout occurs, or a function that supplies the result.
+     * @returns A new Promise that resolves to the specified result if the timeout occurs.
      */
     static timeoutResolve<T>(operation: Promise<T> | (() => Promise<T>), ms: number, result?: T | PromiseLike<T> | (() => (T | PromiseLike<T>)) | undefined): Promise<T>;
     /**
      * Applies a timeout to a Promise or a function that returns a Promise.
-     * If the timeout occurs, rejects with the specified reason.
-     * If the timeout doesn't occur, the resolved result or rejection reason of the original Promise will be the outcome of the Promise returned from this function.
-     * If the 'reason' parameter is a function and timeout doesn't occur, the function won't be called.
-     * The rejection of the 'operation' parameter is not handled by this function, you may want to handle it outside of this function to avoid warnings like "(node:4330) PromiseRejectionHandledWarning: Promise rejection was handled asynchronously".
+     * If the timeout occurs, the returned Promise rejects with the specified reason.
+     * If the timeout does not occur, the returned Promise resolves or rejects based on the outcome of the original Promise.
+     * If the `rejectReason` parameter is a function and the timeout does not occur, the function will not be called.
+     * Note: The rejection of the `operation` parameter is not handled by this function. You may want to handle it outside this function to avoid warnings like "(node:4330) PromiseRejectionHandledWarning: Promise rejection was handled asynchronously."
      *
-     * @param operation The original Promise or a function that returns a Promise for which the timeout will be applied.
+     * @param operation The original Promise or a function that returns a Promise to which the timeout will be applied.
      * @param ms The number of milliseconds for the timeout.
      * @param rejectReason The reason to reject with if the timeout occurs, or a function that supplies the reason.
-     * @return A new Promise that rejects with the specified reason if the timeout occurs.
+     * @returns A new Promise that rejects with the specified reason if the timeout occurs.
      */
     static timeoutReject<T = never, R = any>(operation: Promise<T> | (() => Promise<T>), ms: number, rejectReason: R | PromiseLike<R> | (() => R | PromiseLike<R>)): Promise<T>;
     /**
-     * Get the state of the Promise.
-     * Please note that the returned value is a Promise, although it resolves immediately.
-     * @param p the Promise for which we would like to know its state
-     * @return A Promise that resolves immediately containing the state of the input Promise
+     * Retrieves the state of the specified Promise.
+     * Note: The returned value is a Promise that resolves immediately.
+     *
+     * @param p The Promise whose state is to be determined.
+     * @returns A Promise that resolves immediately with the state of the input Promise.
      */
     static promiseState(p: Promise<any>): Promise<PromiseState>;
     private static synchronizationLocks;
     /**
-     * Equivalent of `synchronized` in Java.
-     * In any situation there's no concurrent execution of any operation function associated with the same lock.
-     * The operation function has access to the state (when `synchronized` is called), settledState (when the operation function is called),
-     * and result (could be the fulfilled result or the rejected reason) of the previous operation.
-     * In case there is no previous invocation, state, settledState and result would all be undefined.
-     * @param lock        the object (could be a string, a number, or `this` in a class) that is used to apply the lock
-     * @param operation   function for doing the computation and returning a Promise
-     * @returns the result of the operation function
+     * Provides mutual exclusion similar to `synchronized` in Java.
+     * Ensures no concurrent execution of any operation function associated with the same lock.
+     * The operation function has access to the state (when `synchronized` is called),
+     * settledState (when the operation function is called),
+     * and result (either the fulfilled result or the rejected reason) of the previous operation.
+     * If there is no previous invocation, state, settledState, and result will all be undefined.
+     *
+     * @param lock The object (such as a string, a number, or `this` in a class) used to identify the lock.
+     * @param operation The function that performs the computation and returns a Promise.
+     * @returns The result of the operation function.
      */
-    static synchronized<T>(lock: unknown, operation: (previousState: PromiseState | undefined, previousSettledState: PromiseState | undefined, previousResult: any) => Promise<T>): Promise<T>;
+    static synchronized<T>(lock: any, operation: (previousState: PromiseState | undefined, previousSettledState: PromiseState | undefined, previousResult: any) => Promise<T>): Promise<T>;
     /**
      * This is just another spelling of {@link PromiseUtils.synchronized}.
-     * @param lock        the object (could be a string, a number, or `this` in a class) that is used to apply the lock
-     * @param operation   function for doing the computation and returning a Promise
-     * @returns the result of the operation function
+     * @param lock The object (such as a string, a number, or `this` in a class) used to identify the lock.
+     * @param operation The function that performs the computation and returns a Promise.
+     * @returns The result of the operation function.
      */
-    static synchronised<T>(lock: unknown, operation: (previousState: PromiseState | undefined, previousSettledState: PromiseState | undefined, previousResult: any) => Promise<T>): Promise<T>;
+    static synchronised<T>(lock: any, operation: (previousState: PromiseState | undefined, previousSettledState: PromiseState | undefined, previousResult: any) => Promise<T>): Promise<T>;
 }
 /**
  * See {@link PromiseUtils.repeat} for full documentation.
@@ -199,6 +231,10 @@ export declare const repeat: typeof PromiseUtils.repeat;
  * See {@link PromiseUtils.withRetry} for full documentation.
  */
 export declare const withRetry: typeof PromiseUtils.withRetry;
+/**
+ * See {@link PromiseUtils.withConcurrency} for full documentation.
+ */
+export declare const withConcurrency: typeof PromiseUtils.withConcurrency;
 /**
  * See {@link PromiseUtils.inParallel} for full documentation.
  */

package/dist/promise-utils.d.ts.map

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