Paginação

const MAX_PAGES = 1_000; // trava de segurança contra laço infinito

/**
 * Percorre todas as páginas de um recurso de lista de /v1.
 * `trynoFetch` é o cliente com retentativa do guia de erros.
 */
export async function* paginate(resource, { apiKey, pageSize = 100 } = {}) {
  let page = 1;

  while (page <= MAX_PAGES) {
    const query = new URLSearchParams({ page: String(page), pageSize: String(pageSize) });
    const body = await trynoFetch(`${resource}?${query}`, { apiKey });

    const items = body.data ?? [];
    for (const item of items) yield item;

    // Duas condições de parada: hasMore falso OU página vazia — a segunda
    // cobre o caso em que o total é múltiplo exato do pageSize.
    if (!body.hasMore || items.length === 0) return;
    page += 1;
  }

  throw new Error(`paginate(${resource}): teto de ${MAX_PAGES} páginas atingido`);
}

// Uso
const membros = [];
for await (const m of paginate("/members", { apiKey: process.env.TRYNO_API_KEY })) {
  membros.push(m);
}
console.log(`${membros.length} membros`);

from typing import Iterator

MAX_PAGES = 1_000  # trava de segurança contra laço infinito


def paginate(resource: str, page_size: int = 100, api_key: str | None = None) -> Iterator[dict]:
    """Percorre todas as páginas de um recurso de lista de /v1.

    `tryno_get` é o cliente com retentativa do guia de erros.
    """
    page = 1

    while page <= MAX_PAGES:
        body = tryno_get(
            resource,
            params={"page": page, "pageSize": page_size},
            api_key=api_key,
        )

        items = body.get("data") or []
        yield from items

        # Pare no hasMore falso OU na página vazia (múltiplo exato do pageSize).
        if not body.get("hasMore") or not items:
            return
        page += 1

    raise RuntimeError(f"paginate({resource}): teto de {MAX_PAGES} páginas atingido")


# Uso
membros = list(paginate("/members"))
print(f"{len(membros)} membros")

#!/usr/bin/env bash
set -euo pipefail

RESOURCE="${1:-/members}"
PAGE=1

while :; do
  BODY=$(curl -sf \
    -H "Authorization: Bearer $TRYNO_API_KEY" \
    "https://tryno.io/api/v1${RESOURCE}?page=${PAGE}&pageSize=100")

  COUNT=$(jq '.data | length' <<<"$BODY")
  jq -c '.data[]' <<<"$BODY"

  HAS_MORE=$(jq -r '.hasMore' <<<"$BODY")
  if [ "$HAS_MORE" != "true" ] || [ "$COUNT" -eq 0 ]; then
    break
  fi

  PAGE=$((PAGE + 1))
done