feat(horizon): add pagination helper with resumable cursors (#913)

[zakarimaureen1-blip]

Summary

Closes #913. Implements a shared Horizon pagination utility featuring resumable cursor support to handle interrupted streaming/paging gracefully across Horizon client routes.

Changes Made

• Resumable Pagination Helper: Implemented cursor state tracking and auto-resumption mechanisms for Horizon pagination queries.
• Robust Failure Handling: Added explicit status and error handling for invalid input parameters, network dropouts, unsupported Horizon network environments, and rate-limiting responses.
• Automated Tests: Added comprehensive unit and integration tests covering:
  • Primary happy-path iteration and resumption.
  • Boundary cases (empty pages, last available cursor page).
  • Failure paths (invalid cursor formats, network interruption recoveries).
• Documentation: Updated client utility developer guides (docs-site/docs/guides/horizon-pagination.md) with cursor state persistence patterns, security considerations, and migration guidelines.

Verification

Ran local test suite and verified all automated tests pass cleanly.

[vercel]

@zakarimaureen1-blip is attempting to deploy a commit to the nanle-code's projects Team on Vercel.

A member of the Team first needs to authorize it.

[drips-wave]

@zakarimaureen1-blip Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

[zakarimaureen1-blip]

Hi, could you approve my PR.