nodewarden/src/utils/pagination.ts

import { LIMITS } from '../config/limits';

const MAX_PAGE_SIZE = LIMITS.pagination.maxPageSize;

export interface PaginationRequest {
  limit: number;
  offset: number;
}

export function parsePagination(url: URL): PaginationRequest | null {
  const pageSizeRaw = url.searchParams.get('pageSize');
  const continuationToken = url.searchParams.get('continuationToken');
  if (!pageSizeRaw && !continuationToken) return null;

  const pageSize = pageSizeRaw ? Number(pageSizeRaw) : LIMITS.pagination.defaultPageSize;
  if (!Number.isInteger(pageSize) || pageSize <= 0) return null;

  const limit = Math.min(pageSize, MAX_PAGE_SIZE);
  const offset = decodeContinuationToken(continuationToken);

  return { limit, offset };
}

export function encodeContinuationToken(offset: number): string {
  return btoa(String(offset));
}

export function decodeContinuationToken(token: string | null): number {
  if (!token) return 0;
  try {
    const decoded = atob(token);
    const offset = Number(decoded);
    if (!Number.isInteger(offset) || offset < 0) return 0;
    return offset;
  } catch {
    return 0;
  }
}