Esta versão (v0.7) ainda não foi publicada no npm.
Pular para o conteúdo

Paginação ​

Listagens aceitam { page, perPage } e devolvem um Page<T>:

ts
interface Page<T> {
  items: T[]
  page: number       // starts at 1
  perPage: number
  totalPages: number
  totalItems: number
}

No SDK o nome é sempre page/perPage; o SDK traduz para o que cada rota do gateway espera. As demais listagens mandam per_page; em wallet.listTransactions, deposits.list, withdrawals.list e notifications.list, perPage vai como limit no fio. Você nunca passa limit ao SDK: ele só aparece ao inspecionar o request (hooks.onRequest, rede do navegador).

Nessas quatro rotas do limit, perPage vai de 1 a 100; fora disso (ou omitido), o gateway usa 20 (notifications.list rejeita fora da faixa com CONFIGURATION_ERROR).

ts
let page = await enginex.wallet.listTransactions({ page: 1, perPage: 20 })
while (page.page < page.totalPages) {
  page = await enginex.wallet.listTransactions({ page: page.page + 1, perPage: 20 })
}

Paginação por cursor ​

Algumas listagens (ex.: as campanhas de bônus de @getenginex/sdk-igaming) são paginadas por cursor: aceitam { cursor?, pageSize? } (CursorPageInput) e devolvem um CursorPage<T>:

ts
interface CursorPage<T> {
  items: T[]
  nextCursor?: string // absent on the last page
}
ts
let cursor: string | undefined
do {
  const page = await igaming.bonus.listOffers({ cursor, pageSize: 20 })
  render(page.items)
  cursor = page.nextCursor
} while (cursor)

O cursor é opaco: não monte nem altere, só repasse o nextCursor recebido.