Esta versión (v0.7) todavía no se publicó en npm.
Ir al contenido

Paginación ​

Los listados aceptan { page, perPage } y devuelven un Page<T>:

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

En el SDK el nombre es siempre page/perPage; el SDK lo traduce a lo que espera cada ruta del gateway. Los demás listados envían per_page; en wallet.listTransactions, deposits.list, withdrawals.list y notifications.list, perPage va como limit por la red. Nunca le pasas limit al SDK: solo aparece al inspeccionar el request (hooks.onRequest, la red del navegador).

En esas cuatro rutas con limit, perPage va de 1 a 100; fuera de eso (u omitido), el gateway usa 20 (notifications.list rechaza los valores fuera del rango con 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 })
}

Paginación por cursor ​

Algunos listados (p. ej., las campañas de bono de @getenginex/sdk-igaming) se paginan por cursor: aceptan { cursor?, pageSize? } (CursorPageInput) y devuelven un 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)

El cursor es opaco: no lo armes ni lo modifiques, solo pasa el nextCursor recibido.