Pagination

// First page — omit cursor
const page1 = await sdk.listRecords('tasks', {
  pageSize: 25,
  sort: 'created_at:desc',
});

// page1.meta.hasMore  — true if more pages exist
// page1.meta.cursor   — pass to next request
// page1.meta.total    — total count (omitted for apps with more than ~10,000 records)

// Next page — pass cursor from previous response
if (page1.meta.hasMore) {
  const page2 = await sdk.listRecords('tasks', {
    pageSize: 25,
    sort: 'created_at:desc',
    cursor: page1.meta.cursor,
  });
}

for await (const record of sdk.paginateRecords('tasks', {
  filter: { status: { eq: 'open' } },
  sort: 'due_date:asc',
  pageSize: 50,
})) {
  renderTask(record);
}

for await (const record of sdk.paginateRecords('tasks', {
  maxPages: 10,
  maxRecords: 500,
  signal: controller.signal,
})) {
  process(record);
}

try {
  for await (const record of sdk.paginateRecords('tasks')) {
    process(record);
  }
} catch (error) {
  // error.message includes page number and cursor for debugging
  console.error('Pagination failed:', error.message);
}