Pagination

interface Page<T> {
  data: T[];           // items on the current page
  meta: PageMeta;      // totals and current position
  links: PageLinks;    // pre-built URLs for adjacent pages
}

interface PageMeta {
  total: number;       // total items across all pages
  page: number;        // current page number (1-based)
  perPage: number;     // items per page
  pages: number;       // total number of pages
  apiVersion: string;  // API version string
}

interface PageLinks {
  next: string | null; // URL of the next page, or null on the last page
  prev: string | null; // URL of the previous page, or null on the first page
}

let page = 1;
let total = 0;

while (true) {
  const result = await client.frameworks.list({ page, perPage: 10 });
  total += result.data.length;

  console.log(`Page ${result.meta.page}/${result.meta.pages}: ${result.data.length} items`);

  if (!result.links.next) break; // no more pages
  page++;
}

console.log(`Fetched ${total} frameworks in total`);

// Frameworks
for await (const fw of client.frameworks.iter()) {
  console.log(fw.slug);
}

// Articles scoped to a framework
for await (const article of client.articles.iter('gdpr')) {
  console.log(`Art. ${article.articleNumber}: ${article.title}`);
}

// Compliance deadlines
for await (const deadline of client.compliance.iterDeadlines({ frameworkSlug: 'nis2' })) {
  console.log(deadline.description);
}

// article is typed as ArticleSummary — no cast needed
for await (const article of client.articles.iter('cra')) {
  const tags: Tag[] = article.tags; // fully typed
}

// Find the first article tagged 'security' — stop as soon as found
let found: ArticleSummary | undefined;

for await (const article of client.articles.iter('nis2')) {
  if (article.tags.some(t => t.slug === 'security')) {
    found = article;
    break; // no further pages are fetched
  }
}

if (found) {
  console.log(`First security article: Art. ${found.articleNumber}`);
}

// Fewer, larger pages — fewer HTTP requests
for await (const req of client.requirements.iter({
  frameworkSlug: 'gdpr',
  perPage: 100,
})) {
  // process requirement
}

async function collectAll<T>(gen: AsyncGenerator<T>): Promise<T[]> {
  const items: T[] = [];
  for await (const item of gen) {
    items.push(item);
  }
  return items;
}

const allFrameworks = await collectAll(client.frameworks.iter());
console.log(`${allFrameworks.length} total frameworks`);