export interface PageResult<T> {
    data: T[];
    cursor: string | null;
    hasMore: boolean;
    total: number;
}
/**
 * Encode a cursor from an object.
 */
export declare function encodeCursor(value: Record<string, unknown>): string;
/**
 * Decode a cursor string back to its object form.
 * Returns null if the cursor is invalid.
 */
export declare function decodeCursor(cursor: string): Record<string, unknown> | null;
/**
 * Build a Page result from a slice of data + total count.
 * @param rows      The rows already fetched (limit+1 to detect hasMore)
 * @param limit     The requested page size
 * @param total     Total matching record count (pass undefined to skip)
 * @param cursorKey The field on the row used as the cursor (default: 'id')
 */
export declare function buildPage<T>(rows: T[], limit: number, total: number | undefined, cursorKey?: string): PageResult<T>;
/** Parse limit from query string, clamped to 1–200. Default 50. */
export declare function parseLimit(raw: unknown, defaultLimit?: number): number;
//# sourceMappingURL=http-pagination.d.ts.map