import { Result } from "../result/models.mjs";
import { PromiseOptions, PromisesItems, PromisesOptions, PromisesResult, PromisesUnwrapped, PromisesValue, PromisesValues } from "./models.mjs";

//#region src/promise/index.d.ts
/**
 * Wrap a _Promise_ with safety handlers, with optional abort capabilities and timeout
 *
 * @param promise _Promise_ to wrap
 * @param options Options for the _Promise_
 * @returns Wrapped _Promise_
 */
declare function attemptPromise<Value>(promise: Promise<Value>, options?: PromiseOptions | AbortSignal | number): Promise<Value>;
/**
 * Wrap a _Promise_-returning callback with safety handlers, with optional abort capabilities and timeout
 *
 * @param callback Callback to wrap
 * @param options Options for the _Promise_
 * @returns _Promise_-wrapped callback
 */
declare function attemptPromise<Value>(callback: () => Promise<Value>, options?: PromiseOptions | AbortSignal | number): Promise<Value>;
/**
 * Wrap a callback with a _Promise_ and safety handlers, with optional abort capabilities and timeout
 *
 * @param callback Callback to wrap
 * @param options Options for the _Promise_
 * @returns _Promise_-wrapped callback
 */
declare function attemptPromise<Value>(callback: () => Value, options?: PromiseOptions | AbortSignal | number): Promise<Value>;
/**
 * Handle a list of _Promises_, returning their results in an ordered array
 *
 * Depending on the strategy, the function will either reject on the first error encountered or return an array of rejected and resolved results
 *
 * @param items List of _Promises_
 * @param options Options for handling the _Promises_
 * @returns List of results
 */
declare function promises<Items extends unknown[], Options extends PromisesOptions>(items: [...Items], options?: Options): Promise<Options['strategy'] extends 'first' ? PromisesUnwrapped<Items> : PromisesValues<PromisesItems<Items>>>;
/**
 * Handle a list of _Promises_, returning their results in an ordered array
 *
 * Depending on the strategy, the function will either reject on the first error encountered or return an array of rejected and resolved results
 *
 * @param items List of _Promises_
 * @param options Options for handling the _Promises_
 * @returns List of results
 */
declare function promises<Value, Options extends PromisesOptions>(items: Promise<Value>[], options?: Options): Promise<Options['strategy'] extends 'first' ? Value[] : PromisesValue<Value>[]>;
/**
 * Handle a list of _Promises_, returning their results in an ordered array
 *
 * If any _Promise_ in the list is rejected, the whole function will reject
 *
 * @param items List of _Promises_
 * @param strategy Strategy for handling the _Promises_; rejects on the first error encountered
 * @returns List of results
 */
declare function promises<Items extends unknown[]>(items: [...Items], strategy: 'first'): Promise<PromisesUnwrapped<Items>>;
/**
 * Handle a list of _Promises_, returning their results in an ordered array
 *
 * If any _Promise_ in the list is rejected, the whole function will reject
 *
 * @param items List of _Promises_
 * @param strategy Strategy for handling the _Promises_; rejects on the first error encountered
 * @returns List of results
 */
declare function promises<Value>(items: Promise<Value>[], strategy: 'first'): Promise<Value[]>;
/**
 * Handle a list of _Promises_, returning their results in an ordered array of rejected and resolved results
 *
 * @param items List of _Promises_
 * @param signal AbortSignal for aborting the operation _(when aborted, the _Promise_ will reject with the reason of the signal)_
 * @returns List of results
 */
declare function promises<Items extends unknown[]>(items: [...Items], signal?: AbortSignal): Promise<PromisesValues<PromisesItems<Items>>>;
/**
 * Handle a list of _Promises_, returning their results in an ordered array of rejected and resolved results
 *
 * @param items List of _Promises_
 * @param signal AbortSignal for aborting the operation _(when aborted, the _Promise_ will reject with the reason of the signal)_
 * @returns List of results
 */
declare function promises<Value>(items: Array<Promise<Value> | (() => Promise<Value>)>, signal?: AbortSignal): Promise<PromisesValue<Value>[]>;
declare namespace promises {
  var result: typeof resultPromises;
}
/**
 * Handle a list of _Promises_, returning their results in an ordered array of results _({@link Result})_
 *
 * Depending on the strategy, the function will either reject on the first error encountered or return an array of rejected and resolved results
 *
 * _Available as `resultPromises` and `promises.result`_
 *
 * @param items List of _Promises_
 * @param signal AbortSignal for aborting the operation _(when aborted, the _Promise_ will reject with the reason of the signal)_
 * @returns List of results
 */
declare function resultPromises<Items extends unknown[]>(items: [...Items], signal?: AbortSignal): Promise<PromisesResult<PromisesItems<Items>>>;
/**
 * Handle a list of _Promises_, returning their results in an ordered array of results _({@link Result})_
 *
 * Depending on the strategy, the function will either reject on the first error encountered or return an array of rejected and resolved results
 *
 * _Available as `resultPromises` and `promises.result`_
 *
 * @param items List of _Promises_
 * @param signal AbortSignal for aborting the operation _(when aborted, the _Promise_ will reject with the reason of the signal)_
 * @returns List of results
 */
declare function resultPromises<Value>(items: Promise<Value>[], signal?: AbortSignal): Promise<Result<Awaited<Value>>[]>;
//#endregion
export { attemptPromise, promises, resultPromises };