Add unit tests for cursor pagination helpers in lib/utils/pagination.ts

[Baskarayelu]

📋 Description

lib/utils/pagination.ts provides validatePaginationParams (clamps limit to 1..100, default 20) and the PaginatedResult<T> contract used by remittance/bills/goals routes. The clamping and cursor handling are untested, so a regression in the limit bounds would silently affect every paginated endpoint.

This issue adds a vitest suite for the pagination helpers.

Why this matters: these helpers are shared infrastructure; a single off-by-one in the clamp affects many routes at once.

🎯 Requirements & Context

• Test default limit (20), min clamp (1), max clamp (100), and below/above bounds.
• Test cursor passthrough and undefined cursor handling.
• Test PaginatedResult hasMore/nextCursor shaping if a builder exists.

Context & constraints

• Test-only; pure functions, no mocks needed.

🛠️ Suggested Execution

git checkout -b test/pagination-utils

• Add tests/unit/pagination.test.ts.
• Edge cases: limit: 0, limit: 1000, negative limit, empty cursor string.

npx vitest run && npx tsc --noEmit && npm run lint

test(utils): add pagination helper unit tests

✅ Acceptance Criteria & Guidelines

Requirement	Target
Clamp + default behaviour covered	Required
Cursor handling covered	Required
Coverage of pagination.ts	≥ 95%
tsc --noEmit, lint clean	Required
Timeframe	96 hours from assignment

💬 Community & Support

Join the RemitWise contributor community on Discord: https://discord.gg/CtQuPZFMA

Comment to claim and ask questions in the channel. 🚀

[ayomidearegbeshola29-dev]

@ayomidearegbeshola29-dev has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

I WOULD LOVE TO WORK ON THIS PLS

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

[devpassionOX]

@devpassionOX has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hello Maintainer. This wave is ending in next 2 day, I've been applying since the begining of the wave. I fully understood the issue and will create PR within 5hrs, please bless me this and the Lord shall bless you more. PLease once again

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

[grantfox-oss]

🦊 GrantFox — @ayomidearegbeshola29-dev has been assigned to this issue as part of the Official Campaign campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #873)
2. Your PR will be reviewed by the Remitwise-Org maintainers

Good luck! Track your progress on GrantFox.

[drips-wave]

Congratulations, @ayomidearegbeshola29-dev! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on June 30, 2026.

🧑‍💻 @ayomidearegbeshola29-dev: 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 awarded 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 🌊