import { ResponsePagination } from '../types/common.types.js';
/**
 * Represents the possible pagination types.
 */
export declare enum PaginationType {
    CURSOR = "cursor",// Confluence, Bitbucket (some endpoints)
    OFFSET = "offset",// Jira
    PAGE = "page"
}
/**
 * Interface representing the common structure of paginated data from APIs.
 * This union type covers properties used by offset, cursor, and page-based pagination.
 */
interface PaginationData {
    results?: unknown[];
    values?: unknown[];
    count?: number;
    size?: number;
    hasMore?: boolean;
    _links?: {
        next?: string;
    };
    startAt?: number;
    maxResults?: number;
    total?: number;
    nextPage?: string;
    page?: number;
    pagelen?: number;
    next?: string;
}
/**
 * Extract pagination information from API response
 * @param data The API response containing pagination information
 * @param paginationType The type of pagination mechanism used
 * @returns Object with nextCursor, hasMore, and count properties
 */
export declare function extractPaginationInfo<T extends Partial<PaginationData>>(data: T, paginationType: PaginationType): ResponsePagination | undefined;
/**
 * Validates and enforces page size limits to prevent excessive data exposure (CWE-770)
 * @param requestedPageSize The requested page size from the client
 * @param contextInfo Optional context for logging (e.g., endpoint name)
 * @returns The validated page size (clamped to maximum allowed)
 */
export declare function validatePageSize(requestedPageSize?: number, contextInfo?: string): number;
/**
 * Validates pagination data to ensure it doesn't exceed configured limits
 * @param paginationData The pagination data to validate
 * @param contextInfo Optional context for logging
 * @returns True if data is within limits, false otherwise
 */
export declare function validatePaginationLimits(paginationData: {
    count?: number;
    size?: number;
    pagelen?: number;
}, contextInfo?: string): boolean;
export {};