/**
 * API Payload Optimization
 *
 * Reduces payload size through field selection, pagination, and data transformation
 */
interface PaginationOptions {
    page?: number;
    limit?: number;
    cursor?: string;
    defaultLimit?: number;
    maxLimit?: number;
}
interface PaginatedResponse<T> {
    data: T[];
    pagination: {
        page?: number;
        limit: number;
        total?: number;
        hasMore: boolean;
        nextCursor?: string | null;
        prevCursor?: string | null;
    };
}
interface FieldSelectionOptions {
    include?: string[];
    exclude?: string[];
    defaultFields?: string[];
}
/**
 * Paginate array of items
 */
export declare function paginateArray<T>(items: T[], options?: PaginationOptions): PaginatedResponse<T>;
/**
 * Create cursor for cursor-based pagination
 */
export declare function createCursor(item: Record<string, unknown>, field?: string): string;
/**
 * Parse cursor
 */
export declare function parseCursor(cursor: string): {
    field: string;
    value: unknown;
} | null;
/**
 * Select fields from object
 */
export declare function selectFields<T extends Record<string, unknown>>(obj: T, options: FieldSelectionOptions): Partial<T>;
/**
 * Select fields from array of objects
 */
export declare function selectFieldsFromArray<T extends Record<string, unknown>>(items: T[], options: FieldSelectionOptions): Partial<T>[];
/**
 * Remove null and undefined values
 */
export declare function removeEmpty<T extends Record<string, unknown>>(obj: T): Partial<T>;
/**
 * Flatten nested object
 */
export declare function flattenObject(obj: Record<string, unknown>, prefix?: string): Record<string, unknown>;
/**
 * Minimize JSON response size
 */
export declare function minimizeJSON(data: unknown): string;
/**
 * Format JSON response (for development)
 */
export declare function formatJSON(data: unknown): string;
/**
 * Remove sensitive fields
 */
export declare function sanitizeResponse<T extends Record<string, unknown>>(obj: T, sensitiveFields?: string[]): Partial<T>;
/**
 * Transform timestamps to ISO strings
 */
export declare function transformDates<T extends Record<string, unknown>>(obj: T): T;
/**
 * Calculate payload size in bytes
 */
export declare function getPayloadSize(data: unknown): number;
/**
 * Get payload size in human-readable format
 */
export declare function formatPayloadSize(bytes: number): string;
/**
 * Optimize payload by removing unnecessary data
 */
export interface OptimizationResult<T> {
    data: T;
    originalSize: number;
    optimizedSize: number;
    savings: number;
    savingsPercent: number;
}
export declare function optimizePayload<T>(data: T, options?: FieldSelectionOptions & {
    removeEmpty?: boolean;
    transformDates?: boolean;
    sanitize?: boolean;
}): OptimizationResult<T>;
/**
 * Create API response with optimized payload
 */
export declare function createOptimizedResponse<T>(data: T, options?: {
    pagination?: PaginationOptions;
    fields?: FieldSelectionOptions;
    optimize?: boolean;
    compress?: boolean;
}): {
    data: unknown;
    meta?: {
        pagination?: PaginatedResponse<T>['pagination'];
        size?: {
            original: string;
            optimized: string;
            savings: string;
        };
    };
};
/**
 * Parse field selection from query params
 */
export declare function parseFieldsFromQuery(query: string): FieldSelectionOptions;
/**
 * Parse pagination from query params
 */
export declare function parsePaginationFromQuery(query: string): PaginationOptions;
/**
 * Batch responses to reduce round trips
 */
export declare function batchResponses<T>(responses: Array<{
    key: string;
    data: T;
}>): Record<string, T>;
/**
 * Create partial response (for large objects)
 */
export declare function createPartialResponse<T extends Record<string, unknown>>(obj: T, maxDepth?: number, currentDepth?: number): Partial<T> | string;
export {};
//# sourceMappingURL=payload-optimization.d.ts.map