/** an array of paginated results, augmented with the total telegram reported (absent for some endpoints) */
export type Paginated<T> = T[] & {
    total: number | undefined;
};
/** async iterator over paginated results; `collect()` drains the rest into a {@link Paginated} array */
export interface PageIterator<T> extends AsyncIterableIterator<T> {
    collect: () => Promise<Paginated<T>>;
}
interface OffsetPage<T> {
    items: T[];
    total: number | undefined;
}
interface CursorPage<T> {
    items: T[];
    total: number | undefined;
    next: string | undefined;
}
/** auto-page a numeric offset/limit endpoint, yielding items until a short or empty page */
export declare function offsetPaginator<T>(fetchPage: (offset: number, limit: number) => Promise<OffsetPage<T>>, startOffset?: number, limit?: number): PageIterator<Awaited<T>>;
/** auto-page a string-cursor endpoint (telegram `next_offset`), yielding items until the cursor empties */
export declare function cursorPaginator<T>(fetchPage: (offset: string, limit: number) => Promise<CursorPage<T>>, startOffset?: string, limit?: number): PageIterator<Awaited<T>>;
export {};
//# sourceMappingURL=paginate.d.ts.map