/** An error subclass which is thrown when there are too many pending push or next operations on a single repeater. */ export declare class RepeaterOverflowError extends Error { constructor(message: string); } /*** BUFFERS ***/ /** A special queue interface which allow multiple values to be pushed onto a repeater without having pushes wait or throw overflow errors, passed as the second argument to the repeater constructor. */ export interface RepeaterBuffer { empty: boolean; full: boolean; add(value: TValue): unknown; remove(): TValue; } /** A buffer which allows you to push a set amount of values to the repeater without pushes waiting or throwing errors. */ export declare class FixedBuffer implements RepeaterBuffer { _c: number; _q: Array; constructor(capacity: number); get empty(): boolean; get full(): boolean; add(value: unknown): void; remove(): unknown; } /** Sliding buffers allow you to push a set amount of values to the repeater without pushes waiting or throwing errors. If the number of values exceeds the capacity set in the constructor, the buffer will discard the earliest values added. */ export declare class SlidingBuffer implements RepeaterBuffer { _c: number; _q: Array; constructor(capacity: number); get empty(): boolean; get full(): boolean; add(value: unknown): void; remove(): unknown; } /** Dropping buffers allow you to push a set amount of values to the repeater without the push function waiting or throwing errors. If the number of values exceeds the capacity set in the constructor, the buffer will discard the latest values added. */ export declare class DroppingBuffer implements RepeaterBuffer { _c: number; _q: Array; constructor(capacity: number); get empty(): boolean; get full(): boolean; add(value: unknown): void; remove(): unknown; } /*** TYPES ***/ /** The type of the first argument passed to the executor callback. */ export declare type Push = (value: PromiseLike | T) => Promise; /** The type of the second argument passed to the executor callback. A callable promise. */ export declare type Stop = ((err?: unknown) => undefined) & Promise; /** The type of the callback passed to the Repeater constructor. */ export declare type RepeaterExecutor = (push: Push, stop: Stop) => PromiseLike | TReturn; /** The maximum number of push or next operations which may exist on a single repeater. */ export declare const MAX_QUEUE_LENGTH = 1024; export declare class Repeater { constructor(executor: RepeaterExecutor, buffer?: RepeaterBuffer | undefined); next(value?: PromiseLike | TNext): Promise>; return(value?: PromiseLike | TReturn): Promise>; throw(err: unknown): Promise>; [Symbol.asyncIterator](): this; static race: typeof race; static merge: typeof merge; static zip: typeof zip; static latest: typeof latest; } declare function race(contenders: Iterable): Repeater | Iterable ? U extends PromiseLike ? V : U : never>; declare function merge(contenders: Iterable): Repeater | Iterable ? U extends PromiseLike ? V : U : T extends PromiseLike ? U : T>; declare type Contender = AsyncIterable | T> | Iterable | T> | PromiseLike | T; declare function zip(contenders: []): Repeater; declare function zip(contenders: Iterable>): Repeater<[T]>; declare function zip(contenders: [Contender, Contender]): Repeater<[T1, T2]>; declare function zip(contenders: [Contender, Contender, Contender]): Repeater<[T1, T2, T3]>; declare function zip(contenders: [Contender, Contender, Contender, Contender]): Repeater<[T1, T2, T3, T4]>; declare function zip(contenders: [Contender, Contender, Contender, Contender, Contender]): Repeater<[T1, T2, T3, T4, T5]>; declare function zip(contenders: [Contender, Contender, Contender, Contender, Contender, Contender]): Repeater<[T1, T2, T3, T4, T5, T6]>; declare function zip(contenders: [Contender, Contender, Contender, Contender, Contender, Contender, Contender]): Repeater<[T1, T2, T3, T4, T5, T6, T7]>; declare function zip(contenders: [Contender, Contender, Contender, Contender, Contender, Contender, Contender, Contender]): Repeater<[T1, T2, T3, T4, T5, T6, T7, T8]>; declare function zip(contenders: [Contender, Contender, Contender, Contender, Contender, Contender, Contender, Contender, Contender]): Repeater<[T1, T2, T3, T4, T5, T6, T7, T8, T9]>; declare function zip(contenders: [Contender, Contender, Contender, Contender, Contender, Contender, Contender, Contender, Contender, Contender]): Repeater<[T1, T2, T3, T4, T5, T6, T7, T8, T9, T10]>; declare function latest(contenders: []): Repeater; declare function latest(contenders: Iterable>): Repeater<[T]>; declare function latest(contenders: [Contender, Contender]): Repeater<[T1, T2]>; declare function latest(contenders: [Contender, Contender, Contender]): Repeater<[T1, T2, T3]>; declare function latest(contenders: [Contender, Contender, Contender, Contender]): Repeater<[T1, T2, T3, T4]>; declare function latest(contenders: [Contender, Contender, Contender, Contender, Contender]): Repeater<[T1, T2, T3, T4, T5]>; declare function latest(contenders: [Contender, Contender, Contender, Contender, Contender, Contender]): Repeater<[T1, T2, T3, T4, T5, T6]>; declare function latest(contenders: [Contender, Contender, Contender, Contender, Contender, Contender, Contender]): Repeater<[T1, T2, T3, T4, T5, T6, T7]>; declare function latest(contenders: [Contender, Contender, Contender, Contender, Contender, Contender, Contender, Contender]): Repeater<[T1, T2, T3, T4, T5, T6, T7, T8]>; declare function latest(contenders: [Contender, Contender, Contender, Contender, Contender, Contender, Contender, Contender, Contender]): Repeater<[T1, T2, T3, T4, T5, T6, T7, T8, T9]>; declare function latest(contenders: [Contender, Contender, Contender, Contender, Contender, Contender, Contender, Contender, Contender, Contender]): Repeater<[T1, T2, T3, T4, T5, T6, T7, T8, T9, T10]>; export {};