Paginación
Los listados aceptan { page, perPage } y devuelven un Page<T>:
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).
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>:
interface CursorPage<T> {
items: T[]
nextCursor?: string // absent on the last page
}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.