Skip to content

Add pagination, filtering, and search ranking to backend endpoints - #412

Open
DeFiVC wants to merge 1 commit into
trustflow-protocol:mainfrom
DeFiVC:feat/pagination-filtering-search-improvements
Open

Add pagination, filtering, and search ranking to backend endpoints#412
DeFiVC wants to merge 1 commit into
trustflow-protocol:mainfrom
DeFiVC:feat/pagination-filtering-search-improvements

Conversation

@DeFiVC

@DeFiVC DeFiVC commented Aug 31, 2026

Copy link
Copy Markdown

Closes #232, Closes #233, Closes #234, Closes #235

Type of Change

  • New feature (non-breaking change that adds functionality)
  • Refactoring (no functional or behavioral changes)

Summary

This PR adds pagination, filtering, and search ranking capabilities to multiple list/search endpoints that previously returned unbounded results. All endpoints now support limit/offset query parameters with sane defaults (20) and enforced maximums (100). Gig listing endpoints gain status and budget range filtering. User profile search results are now ranked by relevance (exact name match > prefix > contains > bio/skills).

Motivation / Context

The affected endpoints (GET /escrows/depositor/:address, GET /gigs/creator/:address, GET /profiles, GET /profiles/search) all returned complete unbounded arrays with no pagination. As data grows, these endpoints return linearly-growing JSON payloads. This PR adds pagination to all list endpoints, filtering to gig listings, and relevance-based ranking to profile search.

Closes #232, Closes #233, Closes #234, Closes #235

…ile endpoints

- Add offset/limit pagination to GET /escrows/depositor/:address (trustflow-protocol#232)
- Add offset/limit pagination to GET /gigs/creator/:address and GET /profiles (trustflow-protocol#233)
- Add status and budget range filtering to gig listing endpoints (trustflow-protocol#234)
- Add relevance ranking to user profile search (trustflow-protocol#235)
- Add shared pagination utility in common/pagination.ts
- Add Swagger @apiquery annotations for all new parameters
- Add comprehensive unit tests for pagination, filtering, and ranking
@DeFiVC
DeFiVC requested a review from meshackyaro as a code owner August 31, 2026 07:14
@drips-wave

drips-wave Bot commented Aug 31, 2026

Copy link
Copy Markdown

@DeFiVC 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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant