import { FinalRequestOptions } from "../internal/request-options.js";
import { type Metronome } from "../client.js";
import { APIPromise } from "./api-promise.js";
import { type APIResponseProps } from "../internal/parse.js";
export type PageRequestOptions = Pick<FinalRequestOptions, 'query' | 'headers' | 'body' | 'path' | 'method'>;
export declare abstract class AbstractPage<Item> implements AsyncIterable<Item> {
    #private;
    protected options: FinalRequestOptions;
    protected response: Response;
    protected body: unknown;
    constructor(client: Metronome, response: Response, body: unknown, options: FinalRequestOptions);
    abstract nextPageRequestOptions(): PageRequestOptions | null;
    abstract getPaginatedItems(): Item[];
    hasNextPage(): boolean;
    getNextPage(): Promise<this>;
    iterPages(): AsyncGenerator<this>;
    [Symbol.asyncIterator](): AsyncGenerator<Item>;
}
/**
 * This subclass of Promise will resolve to an instantiated Page once the request completes.
 *
 * It also implements AsyncIterable to allow auto-paginating iteration on an unawaited list call, eg:
 *
 *    for await (const item of client.items.list()) {
 *      console.log(item)
 *    }
 */
export declare class PagePromise<PageClass extends AbstractPage<Item>, Item = ReturnType<PageClass['getPaginatedItems']>[number]> extends APIPromise<PageClass> implements AsyncIterable<Item> {
    constructor(client: Metronome, request: Promise<APIResponseProps>, Page: new (...args: ConstructorParameters<typeof AbstractPage>) => PageClass);
    /**
     * Allow auto-paginating iteration on an unawaited list call, eg:
     *
     *    for await (const item of client.items.list()) {
     *      console.log(item)
     *    }
     */
    [Symbol.asyncIterator](): AsyncGenerator<Item>;
}
export interface CursorPageResponse<Item> {
    /**
     * Cursor to fetch the next page
     */
    next_page: string;
    /**
     * Items of the page
     */
    data: Array<Item>;
}
export interface CursorPageParams {
    /**
     * Cursor to begin fetching from
     */
    next_page?: string;
    /**
     * Number of elements to fetch
     */
    limit?: number;
}
export declare class CursorPage<Item> extends AbstractPage<Item> implements CursorPageResponse<Item> {
    /**
     * Cursor to fetch the next page
     */
    next_page: string;
    /**
     * Items of the page
     */
    data: Array<Item>;
    constructor(client: Metronome, response: Response, body: CursorPageResponse<Item>, options: FinalRequestOptions);
    getPaginatedItems(): Item[];
    hasNextPage(): boolean;
    nextPageRequestOptions(): PageRequestOptions | null;
}
export interface BodyCursorPageResponse<Item> {
    /**
     * Cursor to fetch the next page
     */
    next_page: string;
    /**
     * Items of the page
     */
    data: Array<Item>;
}
export interface BodyCursorPageParams {
    /**
     * Cursor to begin fetching from
     */
    next_page?: string;
    /**
     * Number of elements to fetch
     */
    limit?: number;
}
export declare class BodyCursorPage<Item> extends AbstractPage<Item> implements BodyCursorPageResponse<Item> {
    /**
     * Cursor to fetch the next page
     */
    next_page: string;
    /**
     * Items of the page
     */
    data: Array<Item>;
    constructor(client: Metronome, response: Response, body: BodyCursorPageResponse<Item>, options: FinalRequestOptions);
    getPaginatedItems(): Item[];
    hasNextPage(): boolean;
    nextPageRequestOptions(): PageRequestOptions | null;
}
export interface CursorPageWithoutLimitResponse<Item> {
    /**
     * Cursor to fetch the next page
     */
    next_page: string;
    /**
     * Items of the page
     */
    data: Array<Item>;
}
export interface CursorPageWithoutLimitParams {
    /**
     * Cursor to begin fetching from
     */
    next_page?: string;
}
export declare class CursorPageWithoutLimit<Item> extends AbstractPage<Item> implements CursorPageWithoutLimitResponse<Item> {
    /**
     * Cursor to fetch the next page
     */
    next_page: string;
    /**
     * Items of the page
     */
    data: Array<Item>;
    constructor(client: Metronome, response: Response, body: CursorPageWithoutLimitResponse<Item>, options: FinalRequestOptions);
    getPaginatedItems(): Item[];
    hasNextPage(): boolean;
    nextPageRequestOptions(): PageRequestOptions | null;
}
//# sourceMappingURL=pagination.d.ts.map