fix: advance pagination with cursors

[Aming9303]

Summary

• make paginate consume cursor metadata and pass each returned cursor into the next request
• preserve the existing one-page array response API while adding CursorPage support
• stop on empty, short, cursor-less, repeated-cursor, or maxPages boundaries
• cover both cursor progression and backward compatibility

Fixes #403

Validation

• npx vitest run tests/pagination-helper.test.ts (17 passed)
• npm run typecheck
• npm run lint
• npx prettier --check src/pagination.ts tests/pagination-helper.test.ts
• npm exec tsup (ESM, CJS, browser, and declarations built)
• git diff --check