Implement Pagination Helper (Cursor or Offset) for List Endpoints

[thlpkee20-wq]

Description
Add a reusable pagination helper (e.g. parse limit/offset or cursor from query, return nextCursor and page metadata) so list endpoints can use a consistent pagination contract.

Requirements and context

• Implement only in new files. Add src/lib/pagination.ts (or src/middleware/pagination.ts). Do not modify package.json, src/index.ts, or existing route files. Expose helpers like parsePagination(req), formatPage(data, total, cursor) so that routes can adopt in separate PRs.

Suggested execution

• Branch: git checkout -b feature/pagination-helper
• Add pagination util and unit tests. Example commit message: feat(lib): add pagination helper for list endpoints

Guidelines

• Only new lib file. Timeframe: 96 hours.

[drips-wave]

This issue has been added to the Stellar Wave Program and is worth 200 Points.

🧑‍💻 Interested in contributing? Apply to work on this issue on Drips Wave, earn points, and receive rewards.

Warning

Only applications submitted via the apply link above will be considered. Please do not apply by commenting on the issue or opening a PR directly.

🤠 Repo maintainers: You can manage this issue's Points and Complexity on your Maintainer Dashboard here. Please keep an eye on applications and respond quickly 💙

ℹ️ Learn more about Drips Wave

[Samuel1505]

@Samuel1505 has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

I would like to work on this issue, please assign me

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Samuel1505 to this issue.

[jahrulezfrancis]

@jahrulezfrancis has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

I'd love to work on implementing the pagination helper for list endpoints.

I'll create a reusable utility in src/lib/pagination.ts to parse query parameters (limit/offset or cursor) and format responses with pagination metadata, including thorough unit tests—all without modifying existing route files.

ETA: ~3 hours.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @jahrulezfrancis to this issue.

[drips-wave]

Congratulations, @jahrulezfrancis! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on February 26, 2026.

🧑‍💻 @jahrulezfrancis: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are issued when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊