Files
gridpilot.gg/core/leaderboards/application/ports/TeamRankingsQuery.ts
Marc Mintel 597bb48248
Some checks failed
Contract Testing / contract-tests (pull_request) Failing after 4m51s
Contract Testing / contract-snapshot (pull_request) Has been skipped
integration tests
2026-01-22 17:29:06 +01:00

77 lines
1.2 KiB
TypeScript

/**
* Team Rankings Query Port
*
* Defines the interface for querying team rankings data.
* This is a read-only query with search, filter, and sort capabilities.
*/
/**
* Query input for team rankings
*/
export interface TeamRankingsQuery {
/**
* Search term for filtering teams by name (case-insensitive)
*/
search?: string;
/**
* Minimum rating filter
*/
minRating?: number;
/**
* Minimum member count filter
*/
minMemberCount?: number;
/**
* Sort field (default: rating)
*/
sortBy?: 'rating' | 'name' | 'rank' | 'memberCount';
/**
* Sort order (default: desc)
*/
sortOrder?: 'asc' | 'desc';
/**
* Page number (default: 1)
*/
page?: number;
/**
* Number of results per page (default: 20)
*/
limit?: number;
}
/**
* Team entry for rankings
*/
export interface TeamRankingEntry {
rank: number;
id: string;
name: string;
rating: number;
memberCount: number;
raceCount: number;
}
/**
* Pagination metadata
*/
export interface PaginationMetadata {
total: number;
page: number;
limit: number;
totalPages: number;
}
/**
* Team rankings result
*/
export interface TeamRankingsResult {
teams: TeamRankingEntry[];
pagination: PaginationMetadata;
}