import type { AsyncEventBus, EventBus } from "./events/index.js"; import { Event, type EventKeys, type IEvent, type IEventSink, type EventListener } from "./events/shared.js"; export type ResolveHandler = (value: T) => TResult | PromiseLike export type RejectHandler = (reason: unknown) => void | TResult | PromiseLike; export { isPromiseLike } from './teardown-manager.js' /** * Converts a Promise to an Event emitter that fires when the Promise resolves * @template T - The type of the Promise resolution value * @param {PromiseLike} promise - The Promise to convert * @returns {IEventSink<[T], void, unknown>} Event emitter that will emit the resolved value */ export function toEvent(promise: PromiseLike): IEventSink<[T], void, unknown> { const result = new Event<[T]>(Event.maxListeners, () => { }); promise.then(v => { try { result.emit(v); } finally { result[Symbol.dispose]() } }); return result; } /** * Converts an Event emitter to a Promise that resolves when the event fires * @template T - The type of the event payload * @param {IEventSink<[T], void, unknown>} event - The event emitter to convert * @returns {PromiseLike} Promise that resolves with the first event payload */ export function fromEvent(event: IEventSink<[T], void, unknown>): PromiseLike { const result = new Deferred(); event.addListener(value => result.resolve(value), { once: true }); return result; } /** * Converts an Event emitter to a Promise that resolves when the event fires * @template T - The type of the event payload * @param {IEventSink<[T], void, unknown>} event - The event emitter to convert * @returns {PromiseLike} Promise that resolves with the first event payload */ export function fromEventBus }, T>(bus: EventBus, eventName: EventKeys): PromiseLike { const result = new Deferred(); bus.once(eventName, (value => result.resolve(value)) as EventListener); return result; } /** * Converts an Event emitter to a Promise that resolves when the event fires * @template T - The type of the event payload * @param {IEventSink<[T], void, unknown>} event - The event emitter to convert * @returns {PromiseLike} Promise that resolves with the first event payload */ export async function fromAsyncEventBus | void> }, T>(bus: AsyncEventBus, eventName: EventKeys): Promise> { const result = new Deferred(); await bus.once(eventName, (value => result.resolve(value)) as EventListener); return result; } /** * A Deferred Promise pattern implementation allowing external resolution control * @template T - The type of the resolved value * @template TError - The type of the rejection reason (defaults to Error) */ export class Deferred implements PromiseLike { private _resolve?: (value?: T | PromiseLike | undefined) => void; private _reject?: (reason?: TError) => void; promise: Promise; /** * Resolves the deferred Promise with a value * @param {T | PromiseLike | undefined} _value - The resolution value * @throws {Error} If called before Promise initialization */ resolve(_value?: T | PromiseLike | undefined): void { if (typeof (this._resolve) == 'undefined') throw new Error('Not Implemented'); this._resolve(_value); } /** * Rejects the deferred Promise with a reason * @param {TError} _reason - The rejection reason * @throws {Error} If called before Promise initialization */ reject(_reason?: TError): void { if (typeof (this._reject) == 'undefined') throw new Error('Not Implemented'); this._reject(_reason); } constructor() { let _resolve; let _reject; this.promise = new Promise((resolve, reject) => { _resolve = resolve; _reject = reject; }); this._resolve = _resolve; this._reject = _reject; } public then(onfulfilled?: ((value: T) => TResult1 | PromiseLike) | undefined | null, onrejected?: ((reason: TError) => TResult2 | PromiseLike) | undefined | null): Promise { return this.promise.then(onfulfilled, onrejected); } public catch(onrejected?: ((reason: TError) => TResult | PromiseLike) | undefined | null): Promise { return this.promise.catch(onrejected); } public finally(onfinally?: (() => void) | undefined | null): Promise { return this.promise.finally(onfinally); } public get [Symbol.toStringTag](): string { return this.promise[Symbol.toStringTag]; } } /** * Creates a Promise that resolves after a specified delay * @param {number} delay - Delay duration in milliseconds * @returns {Promise} Promise that resolves after the delay */ export function delay(delay: number) { return new Promise((resolve) => { setTimeout(resolve, delay); }) } /** * Wraps a Promise with a timeout, rejecting if it doesn't resolve in time * @template T - The type of the original Promise resolution * @param {PromiseLike} promise - The Promise to wrap * @param {number} timeoutInMs - Timeout duration in milliseconds * @returns {PromiseLike} New Promise that either resolves with the original value or rejects with 'timeout' */ export function whenOrTimeout(promise: PromiseLike, timeoutInMs: number): PromiseLike { return new Promise((resolve, reject) => { const timeOut = setTimeout(function () { reject('timeout'); }, timeoutInMs); promise.then(function (data) { clearTimeout(timeOut); resolve(data); }, function (rejection) { clearTimeout(timeOut); reject(rejection); }); }) } /** * Enum representing the possible states of a Promise * @enum {number} */ export enum PromiseStatus { Pending = 0, Resolved = 1, Rejected = 2 }