api client refactor

apps/website/lib/api/analytics/AnalyticsApiClient.ts

@@ -0,0 +1,24 @@
+import { BaseApiClient } from '../base/BaseApiClient';
+import type {
+  RecordPageViewInputDto,
+  RecordPageViewOutputDto,
+  RecordEngagementInputDto,
+  RecordEngagementOutputDto,
+} from '../../dtos';
+
+/**
+ * Analytics API Client
+ *
+ * Handles all analytics-related API operations.
+ */
+export class AnalyticsApiClient extends BaseApiClient {
+  /** Record a page view */
+  recordPageView(input: RecordPageViewInputDto): Promise<RecordPageViewOutputDto> {
+    return this.post<RecordPageViewOutputDto>('/analytics/page-view', input);
+  }
+
+  /** Record an engagement event */
+  recordEngagement(input: RecordEngagementInputDto): Promise<RecordEngagementOutputDto> {
+    return this.post<RecordEngagementOutputDto>('/analytics/engagement', input);
+  }
+}

apps/website/lib/api/auth/AuthApiClient.ts

@@ -0,0 +1,40 @@
+import { BaseApiClient } from '../base/BaseApiClient';
+import type {
+  LoginParamsDto,
+  SignupParamsDto,
+  SessionDataDto,
+} from '../../dtos';
+
+/**
+ * Auth API Client
+ *
+ * Handles all authentication-related API operations.
+ */
+export class AuthApiClient extends BaseApiClient {
+  /** Sign up with email */
+  signup(params: SignupParamsDto): Promise<SessionDataDto> {
+    return this.post<SessionDataDto>('/auth/signup', params);
+  }
+
+  /** Login with email */
+  login(params: LoginParamsDto): Promise<SessionDataDto> {
+    return this.post<SessionDataDto>('/auth/login', params);
+  }
+
+  /** Get current session */
+  getSession(): Promise<SessionDataDto | null> {
+    return this.get<SessionDataDto | null>('/auth/session');
+  }
+
+  /** Logout */
+  logout(): Promise<void> {
+    return this.post<void>('/auth/logout', {});
+  }
+
+  /** Start iRacing auth redirect */
+  getIracingAuthUrl(returnTo?: string): string {
+    const baseUrl = process.env.NEXT_PUBLIC_API_BASE_URL || 'http://localhost:3001';
+    const params = returnTo ? `?returnTo=${encodeURIComponent(returnTo)}` : '';
+    return `${baseUrl}/auth/iracing/start${params}`;
+  }
+}

apps/website/lib/api/base/BaseApiClient.ts

@@ -0,0 +1,68 @@
+/**
+ * Base API Client for HTTP operations
+ *
+ * Provides generic HTTP methods with common request/response handling,
+ * error handling, and authentication.
+ */
+
+export class BaseApiClient {
+  private baseUrl: string;
+
+  constructor(baseUrl: string) {
+    this.baseUrl = baseUrl;
+  }
+
+  protected async request<T>(method: string, path: string, data?: object): Promise<T> {
+    const headers: HeadersInit = {
+      'Content-Type': 'application/json',
+    };
+
+    const config: RequestInit = {
+      method,
+      headers,
+      credentials: 'include', // Include cookies for auth
+    };
+
+    if (data) {
+      config.body = JSON.stringify(data);
+    }
+
+    const response = await fetch(`${this.baseUrl}${path}`, config);
+
+    if (!response.ok) {
+      let errorData: { message?: string } = { message: response.statusText };
+      try {
+        errorData = await response.json();
+      } catch {
+        // Keep default error message
+      }
+      throw new Error(errorData.message || `API request failed with status ${response.status}`);
+    }
+
+    const text = await response.text();
+    if (!text) {
+      return null as T;
+    }
+    return JSON.parse(text) as T;
+  }
+
+  protected get<T>(path: string): Promise<T> {
+    return this.request<T>('GET', path);
+  }
+
+  protected post<T>(path: string, data: object): Promise<T> {
+    return this.request<T>('POST', path, data);
+  }
+
+  protected put<T>(path: string, data: object): Promise<T> {
+    return this.request<T>('PUT', path, data);
+  }
+
+  protected delete<T>(path: string): Promise<T> {
+    return this.request<T>('DELETE', path);
+  }
+
+  protected patch<T>(path: string, data: object): Promise<T> {
+    return this.request<T>('PATCH', path, data);
+  }
+}

apps/website/lib/api/drivers/DriversApiClient.ts

@@ -0,0 +1,29 @@
+import { BaseApiClient } from '../base/BaseApiClient';
+import type {
+  DriversLeaderboardDto,
+  CompleteOnboardingInputDto,
+  CompleteOnboardingOutputDto,
+  DriverDto,
+} from '../../dtos';
+
+/**
+ * Drivers API Client
+ *
+ * Handles all driver-related API operations.
+ */
+export class DriversApiClient extends BaseApiClient {
+  /** Get drivers leaderboard */
+  getLeaderboard(): Promise<DriversLeaderboardDto> {
+    return this.get<DriversLeaderboardDto>('/drivers/leaderboard');
+  }
+
+  /** Complete driver onboarding */
+  completeOnboarding(input: CompleteOnboardingInputDto): Promise<CompleteOnboardingOutputDto> {
+    return this.post<CompleteOnboardingOutputDto>('/drivers/complete-onboarding', input);
+  }
+
+  /** Get current driver (based on session) */
+  getCurrent(): Promise<DriverDto | null> {
+    return this.get<DriverDto | null>('/drivers/current');
+  }
+}

apps/website/lib/api/index.ts

@@ -0,0 +1,46 @@
+import { LeaguesApiClient } from './leagues/LeaguesApiClient';
+import { RacesApiClient } from './races/RacesApiClient';
+import { DriversApiClient } from './drivers/DriversApiClient';
+import { TeamsApiClient } from './teams/TeamsApiClient';
+import { SponsorsApiClient } from './sponsors/SponsorsApiClient';
+import { MediaApiClient } from './media/MediaApiClient';
+import { AnalyticsApiClient } from './analytics/AnalyticsApiClient';
+import { AuthApiClient } from './auth/AuthApiClient';
+import { PaymentsApiClient } from './payments/PaymentsApiClient';
+
+/**
+ * Main API Client
+ *
+ * Orchestrates all domain-specific API clients with consistent configuration.
+ */
+export class ApiClient {
+  public readonly leagues: LeaguesApiClient;
+  public readonly races: RacesApiClient;
+  public readonly drivers: DriversApiClient;
+  public readonly teams: TeamsApiClient;
+  public readonly sponsors: SponsorsApiClient;
+  public readonly media: MediaApiClient;
+  public readonly analytics: AnalyticsApiClient;
+  public readonly auth: AuthApiClient;
+  public readonly payments: PaymentsApiClient;
+
+  constructor(baseUrl: string) {
+    this.leagues = new LeaguesApiClient(baseUrl);
+    this.races = new RacesApiClient(baseUrl);
+    this.drivers = new DriversApiClient(baseUrl);
+    this.teams = new TeamsApiClient(baseUrl);
+    this.sponsors = new SponsorsApiClient(baseUrl);
+    this.media = new MediaApiClient(baseUrl);
+    this.analytics = new AnalyticsApiClient(baseUrl);
+    this.auth = new AuthApiClient(baseUrl);
+    this.payments = new PaymentsApiClient(baseUrl);
+  }
+}
+
+// ============================================================================
+// Singleton Instance
+// ============================================================================
+
+const API_BASE_URL = process.env.NEXT_PUBLIC_API_BASE_URL || 'http://localhost:3001';
+
+export const api = new ApiClient(API_BASE_URL);

apps/website/lib/api/leagues/LeaguesApiClient.ts

@@ -0,0 +1,52 @@
+import { BaseApiClient } from '../base/BaseApiClient';
+import type {
+  AllLeaguesWithCapacityDto,
+  LeagueStatsDto,
+  LeagueStandingsDto,
+  LeagueScheduleDto,
+  LeagueMembershipsDto,
+  CreateLeagueInputDto,
+  CreateLeagueOutputDto,
+} from '../../dtos';
+
+/**
+ * Leagues API Client
+ *
+ * Handles all league-related API operations.
+ */
+export class LeaguesApiClient extends BaseApiClient {
+  /** Get all leagues with capacity information */
+  getAllWithCapacity(): Promise<AllLeaguesWithCapacityDto> {
+    return this.get<AllLeaguesWithCapacityDto>('/leagues/all-with-capacity');
+  }
+
+  /** Get total number of leagues */
+  getTotal(): Promise<LeagueStatsDto> {
+    return this.get<LeagueStatsDto>('/leagues/total-leagues');
+  }
+
+  /** Get league standings */
+  getStandings(leagueId: string): Promise<LeagueStandingsDto> {
+    return this.get<LeagueStandingsDto>(`/leagues/${leagueId}/standings`);
+  }
+
+  /** Get league schedule */
+  getSchedule(leagueId: string): Promise<LeagueScheduleDto> {
+    return this.get<LeagueScheduleDto>(`/leagues/${leagueId}/schedule`);
+  }
+
+  /** Get league memberships */
+  getMemberships(leagueId: string): Promise<LeagueMembershipsDto> {
+    return this.get<LeagueMembershipsDto>(`/leagues/${leagueId}/memberships`);
+  }
+
+  /** Create a new league */
+  create(input: CreateLeagueInputDto): Promise<CreateLeagueOutputDto> {
+    return this.post<CreateLeagueOutputDto>('/leagues', input);
+  }
+
+  /** Remove a member from league */
+  removeMember(leagueId: string, performerDriverId: string, targetDriverId: string): Promise<{ success: boolean }> {
+    return this.patch<{ success: boolean }>(`/leagues/${leagueId}/members/${targetDriverId}/remove`, { performerDriverId });
+  }
+}

apps/website/lib/api/media/MediaApiClient.ts

@@ -0,0 +1,17 @@
+import { BaseApiClient } from '../base/BaseApiClient';
+import type {
+  RequestAvatarGenerationInputDto,
+  RequestAvatarGenerationOutputDto,
+} from '../../dtos';
+
+/**
+ * Media API Client
+ *
+ * Handles all media-related API operations.
+ */
+export class MediaApiClient extends BaseApiClient {
+  /** Request avatar generation */
+  requestAvatarGeneration(input: RequestAvatarGenerationInputDto): Promise<RequestAvatarGenerationOutputDto> {
+    return this.post<RequestAvatarGenerationOutputDto>('/media/avatar/generate', input);
+  }
+}

apps/website/lib/api/payments/PaymentsApiClient.ts

@@ -0,0 +1,49 @@
+import { BaseApiClient } from '../base/BaseApiClient';
+import type {
+  GetPaymentsOutputDto,
+  CreatePaymentInputDto,
+  CreatePaymentOutputDto,
+  GetMembershipFeesOutputDto,
+  GetPrizesOutputDto,
+  GetWalletOutputDto,
+} from '../../dtos';
+
+/**
+ * Payments API Client
+ *
+ * Handles all payment-related API operations.
+ */
+export class PaymentsApiClient extends BaseApiClient {
+  /** Get payments */
+  getPayments(leagueId?: string, driverId?: string): Promise<GetPaymentsOutputDto> {
+    const params = new URLSearchParams();
+    if (leagueId) params.append('leagueId', leagueId);
+    if (driverId) params.append('driverId', driverId);
+    const query = params.toString();
+    return this.get<GetPaymentsOutputDto>(`/payments${query ? `?${query}` : ''}`);
+  }
+
+  /** Create a payment */
+  createPayment(input: CreatePaymentInputDto): Promise<CreatePaymentOutputDto> {
+    return this.post<CreatePaymentOutputDto>('/payments', input);
+  }
+
+  /** Get membership fees */
+  getMembershipFees(leagueId: string): Promise<GetMembershipFeesOutputDto> {
+    return this.get<GetMembershipFeesOutputDto>(`/payments/membership-fees?leagueId=${leagueId}`);
+  }
+
+  /** Get prizes */
+  getPrizes(leagueId?: string, seasonId?: string): Promise<GetPrizesOutputDto> {
+    const params = new URLSearchParams();
+    if (leagueId) params.append('leagueId', leagueId);
+    if (seasonId) params.append('seasonId', seasonId);
+    const query = params.toString();
+    return this.get<GetPrizesOutputDto>(`/payments/prizes${query ? `?${query}` : ''}`);
+  }
+
+  /** Get wallet */
+  getWallet(driverId: string): Promise<GetWalletOutputDto> {
+    return this.get<GetWalletOutputDto>(`/payments/wallets?driverId=${driverId}`);
+  }
+}

apps/website/lib/api/races/RacesApiClient.ts

@@ -0,0 +1,53 @@
+import { BaseApiClient } from '../base/BaseApiClient';
+import type {
+  RaceStatsDto,
+  RacesPageDataDto,
+  RaceDetailDto,
+  RaceResultsDetailDto,
+  RaceWithSOFDto,
+  RegisterForRaceInputDto,
+  ImportRaceResultsInputDto,
+  ImportRaceResultsSummaryDto,
+} from '../../dtos';
+
+/**
+ * Races API Client
+ *
+ * Handles all race-related API operations.
+ */
+export class RacesApiClient extends BaseApiClient {
+  /** Get total number of races */
+  getTotal(): Promise<RaceStatsDto> {
+    return this.get<RaceStatsDto>('/races/total-races');
+  }
+
+  /** Get races page data */
+  getPageData(): Promise<RacesPageDataDto> {
+    return this.get<RacesPageDataDto>('/races/page-data');
+  }
+
+  /** Get race detail */
+  getDetail(raceId: string, driverId: string): Promise<RaceDetailDto> {
+    return this.get<RaceDetailDto>(`/races/${raceId}?driverId=${driverId}`);
+  }
+
+  /** Get race results detail */
+  getResultsDetail(raceId: string): Promise<RaceResultsDetailDto> {
+    return this.get<RaceResultsDetailDto>(`/races/${raceId}/results`);
+  }
+
+  /** Get race with strength of field */
+  getWithSOF(raceId: string): Promise<RaceWithSOFDto> {
+    return this.get<RaceWithSOFDto>(`/races/${raceId}/sof`);
+  }
+
+  /** Register for race */
+  register(raceId: string, input: RegisterForRaceInputDto): Promise<void> {
+    return this.post<void>(`/races/${raceId}/register`, input);
+  }
+
+  /** Import race results */
+  importResults(raceId: string, input: ImportRaceResultsInputDto): Promise<ImportRaceResultsSummaryDto> {
+    return this.post<ImportRaceResultsSummaryDto>(`/races/${raceId}/import-results`, input);
+  }
+}

apps/website/lib/api/sponsors/SponsorsApiClient.ts

@@ -0,0 +1,41 @@
+import { BaseApiClient } from '../base/BaseApiClient';
+import type {
+  GetEntitySponsorshipPricingResultDto,
+  GetSponsorsOutputDto,
+  CreateSponsorInputDto,
+  CreateSponsorOutputDto,
+  SponsorDashboardDto,
+  SponsorSponsorshipsDto,
+} from '../../dtos';
+
+/**
+ * Sponsors API Client
+ *
+ * Handles all sponsor-related API operations.
+ */
+export class SponsorsApiClient extends BaseApiClient {
+  /** Get sponsorship pricing */
+  getPricing(): Promise<GetEntitySponsorshipPricingResultDto> {
+    return this.get<GetEntitySponsorshipPricingResultDto>('/sponsors/pricing');
+  }
+
+  /** Get all sponsors */
+  getAll(): Promise<GetSponsorsOutputDto> {
+    return this.get<GetSponsorsOutputDto>('/sponsors');
+  }
+
+  /** Create a new sponsor */
+  create(input: CreateSponsorInputDto): Promise<CreateSponsorOutputDto> {
+    return this.post<CreateSponsorOutputDto>('/sponsors', input);
+  }
+
+  /** Get sponsor dashboard */
+  getDashboard(sponsorId: string): Promise<SponsorDashboardDto | null> {
+    return this.get<SponsorDashboardDto | null>(`/sponsors/dashboard/${sponsorId}`);
+  }
+
+  /** Get sponsor sponsorships */
+  getSponsorships(sponsorId: string): Promise<SponsorSponsorshipsDto | null> {
+    return this.get<SponsorSponsorshipsDto | null>(`/sponsors/${sponsorId}/sponsorships`);
+  }
+}

apps/website/lib/api/teams/TeamsApiClient.ts

@@ -0,0 +1,54 @@
+import { BaseApiClient } from '../base/BaseApiClient';
+import type {
+  AllTeamsDto,
+  TeamDetailsDto,
+  TeamMembersDto,
+  TeamJoinRequestsDto,
+  CreateTeamInputDto,
+  CreateTeamOutputDto,
+  UpdateTeamInputDto,
+  UpdateTeamOutputDto,
+  DriverTeamDto,
+} from '../../dtos';
+
+/**
+ * Teams API Client
+ *
+ * Handles all team-related API operations.
+ */
+export class TeamsApiClient extends BaseApiClient {
+  /** Get all teams */
+  getAll(): Promise<AllTeamsDto> {
+    return this.get<AllTeamsDto>('/teams/all');
+  }
+
+  /** Get team details */
+  getDetails(teamId: string): Promise<TeamDetailsDto | null> {
+    return this.get<TeamDetailsDto | null>(`/teams/${teamId}`);
+  }
+
+  /** Get team members */
+  getMembers(teamId: string): Promise<TeamMembersDto> {
+    return this.get<TeamMembersDto>(`/teams/${teamId}/members`);
+  }
+
+  /** Get team join requests */
+  getJoinRequests(teamId: string): Promise<TeamJoinRequestsDto> {
+    return this.get<TeamJoinRequestsDto>(`/teams/${teamId}/join-requests`);
+  }
+
+  /** Create a new team */
+  create(input: CreateTeamInputDto): Promise<CreateTeamOutputDto> {
+    return this.post<CreateTeamOutputDto>('/teams', input);
+  }
+
+  /** Update team */
+  update(teamId: string, input: UpdateTeamInputDto): Promise<UpdateTeamOutputDto> {
+    return this.patch<UpdateTeamOutputDto>(`/teams/${teamId}`, input);
+  }
+
+  /** Get driver's team */
+  getDriverTeam(driverId: string): Promise<DriverTeamDto | null> {
+    return this.get<DriverTeamDto | null>(`/teams/driver/${driverId}`);
+  }
+}

apps/website/lib/dtos/AllLeaguesWithCapacityDto.ts

@@ -0,0 +1,9 @@
+import type { LeagueSummaryDto } from './LeagueSummaryDto';
+
+/**
+ * All leagues with capacity transport object
+ * Contains a list of leagues with their capacity information
+ */
+export interface AllLeaguesWithCapacityDto {
+  leagues: LeagueSummaryDto[];
+}

apps/website/lib/dtos/AllRacesPageDto.ts

@@ -0,0 +1,9 @@
+import type { RaceListItemDto } from './RaceListItemDto';
+
+/**
+ * All races page data transfer object
+ * List of all races for the races page
+ */
+export interface AllRacesPageDto {
+  races: RaceListItemDto[];
+}

apps/website/lib/dtos/AllTeamsDto.ts

@@ -0,0 +1,9 @@
+import type { TeamSummaryDto } from './TeamSummaryDto';
+
+/**
+ * All teams data transfer object
+ * List of all teams
+ */
+export interface AllTeamsDto {
+  teams: TeamSummaryDto[];
+}

apps/website/lib/dtos/CompleteOnboardingInputDto.ts

@@ -0,0 +1,8 @@
+/**
+ * Complete onboarding input data transfer object
+ * Input for completing driver onboarding
+ */
+export interface CompleteOnboardingInputDto {
+  iracingId: string;
+  displayName: string;
+}

apps/website/lib/dtos/CompleteOnboardingOutputDto.ts

@@ -0,0 +1,8 @@
+/**
+ * Complete onboarding output data transfer object
+ * Output from completing driver onboarding
+ */
+export interface CompleteOnboardingOutputDto {
+  driverId: string;
+  success: boolean;
+}

apps/website/lib/dtos/CreateLeagueInputDto.ts

@@ -0,0 +1,11 @@
+/**
+ * Create league input transport object
+ * Input data for creating a new league
+ */
+export interface CreateLeagueInputDto {
+  name: string;
+  description?: string;
+  isPublic: boolean;
+  maxMembers: number;
+  ownerId: string;
+}

apps/website/lib/dtos/CreateLeagueOutputDto.ts

@@ -0,0 +1,8 @@
+/**
+ * Create league output transport object
+ * Output data after creating a new league
+ */
+export interface CreateLeagueOutputDto {
+  leagueId: string;
+  success: boolean;
+}

apps/website/lib/dtos/CreatePaymentInputDto.ts

@@ -0,0 +1,11 @@
+/**
+ * Create payment input data transfer object
+ * Input for creating a payment
+ */
+export interface CreatePaymentInputDto {
+  amount: number;
+  currency: string;
+  leagueId: string;
+  driverId: string;
+  description?: string;
+}

apps/website/lib/dtos/CreatePaymentOutputDto.ts

@@ -0,0 +1,8 @@
+/**
+ * Create payment output data transfer object
+ * Output from creating a payment
+ */
+export interface CreatePaymentOutputDto {
+  paymentId: string;
+  success: boolean;
+}

apps/website/lib/dtos/CreateSponsorInputDto.ts

@@ -0,0 +1,10 @@
+/**
+ * Create sponsor input data transfer object
+ * Input for creating a new sponsor
+ */
+export interface CreateSponsorInputDto {
+  name: string;
+  logoUrl?: string;
+  websiteUrl?: string;
+  userId: string;
+}

apps/website/lib/dtos/CreateSponsorOutputDto.ts

@@ -0,0 +1,8 @@
+/**
+ * Create sponsor output data transfer object
+ * Output from creating a sponsor
+ */
+export interface CreateSponsorOutputDto {
+  sponsorId: string;
+  success: boolean;
+}

apps/website/lib/dtos/CreateTeamInputDto.ts

@@ -0,0 +1,9 @@
+/**
+ * Create team input data transfer object
+ * Input for creating a new team
+ */
+export interface CreateTeamInputDto {
+  name: string;
+  description?: string;
+  ownerId: string;
+}

apps/website/lib/dtos/CreateTeamOutputDto.ts

@@ -0,0 +1,8 @@
+/**
+ * Create team output data transfer object
+ * Output from creating a team
+ */
+export interface CreateTeamOutputDto {
+  teamId: string;
+  success: boolean;
+}

apps/website/lib/dtos/DriverDto.ts

@@ -0,0 +1,11 @@
+/**
+ * Driver transport object
+ * Represents a driver as received from the API
+ */
+export interface DriverDto {
+  id: string;
+  name: string;
+  avatarUrl?: string;
+  iracingId?: string;
+  rating?: number;
+}

apps/website/lib/dtos/DriverLeaderboardItemDto.ts

@@ -0,0 +1,16 @@
+/**
+ * Driver leaderboard item data transfer object
+ * Represents a driver in the global leaderboard
+ */
+export interface DriverLeaderboardItemDto {
+  id: string;
+  name: string;
+  avatarUrl?: string;
+  rating: number;
+  wins: number;
+  races: number;
+  skillLevel: string;
+  isActive: boolean;
+  nationality: string;
+  podiums: number;
+}

apps/website/lib/dtos/DriverRegistrationStatusDto.ts

@@ -0,0 +1,9 @@
+/**
+ * Driver registration status data transfer object
+ * Represents a driver's registration status for a race
+ */
+export interface DriverRegistrationStatusDto {
+  isRegistered: boolean;
+  raceId: string;
+  driverId: string;
+}

apps/website/lib/dtos/DriverRowDto.ts

@@ -0,0 +1,8 @@
+/**
+ * Driver row data transfer object
+ * Represents a driver in a table row
+ */
+export interface DriverRowDto {
+  id: string;
+  name: string;
+}

apps/website/lib/dtos/DriverStatsDto.ts

@@ -0,0 +1,7 @@
+/**
+ * Driver stats data transfer object
+ * Global driver statistics
+ */
+export interface DriverStatsDto {
+  totalDrivers: number;
+}

apps/website/lib/dtos/DriverTeamDto.ts

@@ -0,0 +1,10 @@
+/**
+ * Driver team data transfer object
+ * Represents a driver's team membership
+ */
+export interface DriverTeamDto {
+  teamId: string;
+  teamName: string;
+  role: string;
+  joinedAt: Date;
+}

apps/website/lib/dtos/DriversLeaderboardDto.ts

@@ -0,0 +1,9 @@
+import type { DriverLeaderboardItemDto } from './DriverLeaderboardItemDto';
+
+/**
+ * Drivers leaderboard data transfer object
+ * Contains the list of top drivers
+ */
+export interface DriversLeaderboardDto {
+  drivers: DriverLeaderboardItemDto[];
+}

apps/website/lib/dtos/GetEntitySponsorshipPricingResultDto.ts

@@ -0,0 +1,9 @@
+/**
+ * Get entity sponsorship pricing result data transfer object
+ * Pricing information for sponsorship slots
+ */
+export interface GetEntitySponsorshipPricingResultDto {
+  mainSlotPrice: number;
+  secondarySlotPrice: number;
+  currency: string;
+}

apps/website/lib/dtos/GetMembershipFeesOutputDto.ts

@@ -0,0 +1,11 @@
+import type { MembershipFeeDto } from './MembershipFeeDto';
+import type { MemberPaymentDto } from './MemberPaymentDto';
+
+/**
+ * Get membership fees output data transfer object
+ * Output containing membership fees and payments
+ */
+export interface GetMembershipFeesOutputDto {
+  fees: MembershipFeeDto[];
+  memberPayments: MemberPaymentDto[];
+}

apps/website/lib/dtos/GetPaymentsOutputDto.ts

@@ -0,0 +1,9 @@
+import type { PaymentDto } from './PaymentDto';
+
+/**
+ * Get payments output data transfer object
+ * Output containing list of payments
+ */
+export interface GetPaymentsOutputDto {
+  payments: PaymentDto[];
+}

apps/website/lib/dtos/GetPrizesOutputDto.ts

@@ -0,0 +1,9 @@
+import type { PrizeDto } from './PrizeDto';
+
+/**
+ * Get prizes output data transfer object
+ * Output containing list of prizes
+ */
+export interface GetPrizesOutputDto {
+  prizes: PrizeDto[];
+}

apps/website/lib/dtos/GetSponsorsOutputDto.ts

@@ -0,0 +1,9 @@
+import type { SponsorDto } from './SponsorDto';
+
+/**
+ * Get sponsors output data transfer object
+ * Output containing list of sponsors
+ */
+export interface GetSponsorsOutputDto {
+  sponsors: SponsorDto[];
+}

apps/website/lib/dtos/GetWalletOutputDto.ts

@@ -0,0 +1,9 @@
+import type { WalletDto } from './WalletDto';
+
+/**
+ * Get wallet output data transfer object
+ * Output containing wallet information
+ */
+export interface GetWalletOutputDto {
+  wallet: WalletDto;
+}

apps/website/lib/dtos/ImportRaceResultsInputDto.ts

@@ -0,0 +1,7 @@
+/**
+ * Import race results input data transfer object
+ * Input for importing race results
+ */
+export interface ImportRaceResultsInputDto {
+  resultsFileContent: string;
+}

apps/website/lib/dtos/ImportRaceResultsSummaryDto.ts

@@ -0,0 +1,11 @@
+/**
+ * Import race results summary data transfer object
+ * Summary of race results import operation
+ */
+export interface ImportRaceResultsSummaryDto {
+  success: boolean;
+  raceId: string;
+  driversProcessed: number;
+  resultsRecorded: number;
+  errors?: string[];
+}

apps/website/lib/dtos/ImportResultRowDto.ts

@@ -0,0 +1,13 @@
+/**
+ * Import result row data transfer object
+ * Represents a row in imported race results
+ */
+export interface ImportResultRowDto {
+  id: string;
+  raceId: string;
+  driverId: string;
+  position: number;
+  fastestLap: number;
+  incidents: number;
+  startPosition: number;
+}

apps/website/lib/dtos/LeagueAdminDto.ts

@@ -0,0 +1,13 @@
+import type { LeagueMemberDto } from './LeagueMemberDto';
+import type { LeagueJoinRequestDto } from './LeagueJoinRequestDto';
+import type { LeagueConfigFormModelDto } from './LeagueConfigFormModelDto';
+
+/**
+ * League admin transport object
+ * Contains all data needed for league administration
+ */
+export interface LeagueAdminDto {
+  config: LeagueConfigFormModelDto;
+  members: LeagueMemberDto[];
+  joinRequests: LeagueJoinRequestDto[];
+}

apps/website/lib/dtos/LeagueAdminPermissionsDto.ts

@@ -0,0 +1,12 @@
+/**
+ * League admin permissions transport object
+ * Defines the administrative permissions for a user in a league
+ */
+export interface LeagueAdminPermissionsDto {
+  canManageMembers: boolean;
+  canManageRaces: boolean;
+  canManageSettings: boolean;
+  canManageProtests: boolean;
+  isOwner: boolean;
+  isAdmin: boolean;
+}

apps/website/lib/dtos/LeagueAdminProtestsDto.ts

@@ -0,0 +1,9 @@
+import type { ProtestViewModel } from '../apiClient';
+
+/**
+ * League admin protests transport object
+ * Contains protests for league administration
+ */
+export interface LeagueAdminProtestsDto {
+  protests: ProtestViewModel[];
+}

apps/website/lib/dtos/LeagueConfigFormModelDto.ts

@@ -0,0 +1,12 @@
+/**
+ * League configuration form model transport object
+ * Used for league configuration forms
+ */
+export interface LeagueConfigFormModelDto {
+  id: string;
+  name: string;
+  description?: string;
+  isPublic: boolean;
+  maxMembers: number;
+  // Add other config fields as needed
+}

apps/website/lib/dtos/LeagueJoinRequestDto.ts

@@ -0,0 +1,11 @@
+/**
+ * League join request transport object
+ * Represents a driver's request to join a league
+ */
+export interface LeagueJoinRequestDto {
+  id: string;
+  leagueId: string;
+  driverId: string;
+  requestedAt: Date;
+  message?: string;
+}

apps/website/lib/dtos/LeagueMemberDto.ts

@@ -0,0 +1,12 @@
+import type { DriverDto } from './DriverDto';
+
+/**
+ * League member data transfer object
+ * Represents a driver's membership in a league
+ */
+export interface LeagueMemberDto {
+  driverId: string;
+  driver?: DriverDto;
+  role: string;
+  joinedAt: string;
+}

apps/website/lib/dtos/LeagueMembershipsDto.ts

@@ -0,0 +1,9 @@
+import type { LeagueMemberViewModel } from '../apiClient';
+
+/**
+ * League memberships transport object
+ * Contains the list of league members
+ */
+export interface LeagueMembershipsDto {
+  members: LeagueMemberViewModel[];
+}

apps/website/lib/dtos/LeagueOwnerSummaryDto.ts

@@ -0,0 +1,10 @@
+/**
+ * League owner summary transport object
+ * Summary information for league owners
+ */
+export interface LeagueOwnerSummaryDto {
+  leagueId: string;
+  leagueName: string;
+  memberCount: number;
+  pendingRequests: number;
+}

apps/website/lib/dtos/LeagueScheduleDto.ts

@@ -0,0 +1,9 @@
+import type { ScheduledRaceViewModel } from '../apiClient';
+
+/**
+ * League schedule transport object
+ * Contains the scheduled races for a league
+ */
+export interface LeagueScheduleDto {
+  races: ScheduledRaceViewModel[];
+}

apps/website/lib/dtos/LeagueSeasonSummaryDto.ts

@@ -0,0 +1,11 @@
+/**
+ * League season summary data transfer object
+ * Represents a season within a league
+ */
+export interface LeagueSeasonSummaryDto {
+  id: string;
+  name: string;
+  startDate?: string;
+  endDate?: string;
+  status: string;
+}

apps/website/lib/dtos/LeagueStandingsDto.ts

@@ -0,0 +1,13 @@
+import type { StandingEntryDto } from './StandingEntryDto';
+import type { DriverDto } from './DriverDto';
+import type { LeagueMembership } from './LeagueMembershipDto';
+
+/**
+ * League standings transport object
+ * Contains the current league standings
+ */
+export interface LeagueStandingsDto {
+  standings: StandingEntryDto[];
+  drivers: DriverDto[];
+  memberships: LeagueMembership[];
+}

apps/website/lib/dtos/LeagueStatsDto.ts

@@ -0,0 +1,13 @@
+/**
+ * League stats DTO
+ * Contains statistical information about a league's races
+ */
+export interface LeagueStatsDto {
+  leagueId: string;
+  totalRaces: number;
+  completedRaces: number;
+  scheduledRaces: number;
+  averageSOF?: number;
+  highestSOF?: number;
+  lowestSOF?: number;
+}

apps/website/lib/dtos/LeagueSummaryDto.ts

@@ -0,0 +1,18 @@
+/**
+ * League summary transport object
+ * Contains basic league information for list views
+ */
+export interface LeagueSummaryDto {
+  id: string;
+  name: string;
+  description?: string;
+  logoUrl?: string;
+  coverImage?: string;
+  memberCount: number;
+  maxMembers: number;
+  isPublic: boolean;
+  ownerId: string;
+  ownerName?: string;
+  scoringType?: string;
+  status?: string;
+}

apps/website/lib/dtos/LoginParamsDto.ts

@@ -0,0 +1,8 @@
+/**
+ * Login parameters data transfer object
+ * Parameters for user login
+ */
+export interface LoginParamsDto {
+  email: string;
+  password: string;
+}

apps/website/lib/dtos/MemberPaymentDto.ts

@@ -0,0 +1,10 @@
+/**
+ * Member payment data transfer object
+ * Represents a payment made by a league member
+ */
+export interface MemberPaymentDto {
+  driverId: string;
+  amount: number;
+  paidAt: string;
+  status: string;
+}

apps/website/lib/dtos/MembershipFeeDto.ts

@@ -0,0 +1,10 @@
+/**
+ * Membership fee data transfer object
+ * Represents a membership fee for a league
+ */
+export interface MembershipFeeDto {
+  leagueId: string;
+  amount: number;
+  currency: string;
+  period: string;
+}

apps/website/lib/dtos/PaymentDto.ts

@@ -0,0 +1,11 @@
+/**
+ * Payment data transfer object
+ * Represents a payment transaction
+ */
+export interface PaymentDto {
+  id: string;
+  amount: number;
+  currency: string;
+  status: string;
+  createdAt: string;
+}

apps/website/lib/dtos/PenaltyDataDto.ts

@@ -0,0 +1,11 @@
+import type { PenaltyTypeDto } from './PenaltyTypeDto';
+
+/**
+ * Penalty data structure
+ * Used when creating or updating penalties
+ */
+export interface PenaltyDataDto {
+  driverId: string;
+  type: PenaltyTypeDto;
+  value?: number;
+}

apps/website/lib/dtos/PenaltyTypeDto.ts

@@ -0,0 +1,11 @@
+/**
+ * Penalty type enumeration
+ * Defines all possible penalty types in the system
+ */
+export type PenaltyTypeDto =
+  | 'time_penalty'
+  | 'grid_penalty'
+  | 'points_deduction'
+  | 'disqualification'
+  | 'warning'
+  | 'license_points';

apps/website/lib/dtos/PrizeDto.ts

@@ -0,0 +1,11 @@
+/**
+ * Prize data transfer object
+ * Represents a prize in a league
+ */
+export interface PrizeDto {
+  id: string;
+  name: string;
+  amount: number;
+  currency: string;
+  position?: number;
+}

apps/website/lib/dtos/ProtestDto.ts

@@ -0,0 +1,13 @@
+/**
+ * Protest data transfer object
+ * Represents a protest filed in a race
+ */
+export interface ProtestDto {
+  id: string;
+  raceId: string;
+  complainantId: string;
+  defendantId: string;
+  description: string;
+  status: string;
+  createdAt: string;
+}

apps/website/lib/dtos/RaceDetailDto.ts

@@ -0,0 +1,18 @@
+import type { RaceDetailRaceDto } from './RaceDetailRaceDto';
+import type { RaceDetailLeagueDto } from './RaceDetailLeagueDto';
+import type { RaceDetailEntryDto } from './RaceDetailEntryDto';
+import type { RaceDetailRegistrationDto } from './RaceDetailRegistrationDto';
+import type { RaceDetailUserResultDto } from './RaceDetailUserResultDto';
+
+/**
+ * Race detail data transfer object
+ * Complete race details view
+ */
+export interface RaceDetailDto {
+  race: RaceDetailRaceDto | null;
+  league: RaceDetailLeagueDto | null;
+  entryList: RaceDetailEntryDto[];
+  registration: RaceDetailRegistrationDto;
+  userResult: RaceDetailUserResultDto | null;
+  error?: string;
+}

apps/website/lib/dtos/RaceDetailEntryDto.ts

@@ -0,0 +1,12 @@
+/**
+ * Race detail entry data transfer object
+ * Represents an entry in race details
+ */
+export interface RaceDetailEntryDto {
+  id: string;
+  name: string;
+  country: string;
+  avatarUrl: string;
+  rating: number | null;
+  isCurrentUser: boolean;
+}

apps/website/lib/dtos/RaceDetailLeagueDto.ts

@@ -0,0 +1,13 @@
+/**
+ * Race detail league data transfer object
+ * League information in race details
+ */
+export interface RaceDetailLeagueDto {
+  id: string;
+  name: string;
+  description: string;
+  settings: {
+    maxDrivers?: number;
+    qualifyingFormat?: string;
+  };
+}

apps/website/lib/dtos/RaceDetailRaceDto.ts

@@ -0,0 +1,16 @@
+/**
+ * Race detail race data transfer object
+ * Race information in race details
+ */
+export interface RaceDetailRaceDto {
+  id: string;
+  leagueId: string;
+  track: string;
+  car: string;
+  scheduledAt: string;
+  sessionType: string;
+  status: string;
+  strengthOfField: number | null;
+  registeredCount?: number;
+  maxParticipants?: number;
+}

apps/website/lib/dtos/RaceDetailRegistrationDto.ts

@@ -0,0 +1,8 @@
+/**
+ * Race detail registration data transfer object
+ * Registration information in race details
+ */
+export interface RaceDetailRegistrationDto {
+  isUserRegistered: boolean;
+  canRegister: boolean;
+}

apps/website/lib/dtos/RaceDetailUserResultDto.ts

@@ -0,0 +1,14 @@
+/**
+ * Race detail user result data transfer object
+ * Represents the current user's result in race details
+ */
+export interface RaceDetailUserResultDto {
+  position: number;
+  startPosition: number;
+  incidents: number;
+  fastestLap: number;
+  positionChange: number;
+  isPodium: boolean;
+  isClean: boolean;
+  ratingChange: number | null;
+}

apps/website/lib/dtos/RaceListItemDto.ts

@@ -0,0 +1,13 @@
+/**
+ * Race list item data transfer object
+ * Represents a race in list views
+ */
+export interface RaceListItemDto {
+  id: string;
+  name: string;
+  leagueId: string;
+  leagueName: string;
+  scheduledTime: string;
+  status: string;
+  trackName?: string;
+}

apps/website/lib/dtos/RacePenaltiesDto.ts

@@ -0,0 +1,10 @@
+import type { RacePenaltyDto } from './RacePenaltyDto';
+
+/**
+ * Race penalties data transfer object
+ * List of penalties for a race
+ */
+export interface RacePenaltiesDto {
+  penalties: RacePenaltyDto[];
+  driverMap: Record<string, string>;
+}

apps/website/lib/dtos/RacePenaltyDto.ts

@@ -0,0 +1,14 @@
+/**
+ * Race penalty data transfer object
+ * Represents a penalty issued in a race
+ */
+export interface RacePenaltyDto {
+  id: string;
+  driverId: string;
+  type: string;
+  value: number;
+  reason: string;
+  issuedBy: string;
+  issuedAt: string;
+  notes?: string;
+}

apps/website/lib/dtos/RaceProtestDto.ts

@@ -0,0 +1,15 @@
+/**
+ * Race protest data transfer object
+ * Represents a protest filed for a race
+ */
+export interface RaceProtestDto {
+  id: string;
+  protestingDriverId: string;
+  accusedDriverId: string;
+  incident: {
+    lap: number;
+    description: string;
+  };
+  status: string;
+  filedAt: string;
+}

apps/website/lib/dtos/RaceProtestsDto.ts

@@ -0,0 +1,10 @@
+import type { RaceProtestDto } from './RaceProtestDto';
+
+/**
+ * Race protests data transfer object
+ * List of protests for a race
+ */
+export interface RaceProtestsDto {
+  protests: RaceProtestDto[];
+  driverMap: Record<string, string>;
+}

apps/website/lib/dtos/RaceResultDto.ts

@@ -0,0 +1,18 @@
+/**
+ * Race result data transfer object
+ * Represents a driver's result in a race
+ */
+export interface RaceResultDto {
+  id: string;
+  raceId: string;
+  driverId: string;
+  driverName: string;
+  avatarUrl: string;
+  position: number;
+  startPosition: number;
+  incidents: number;
+  fastestLap: number;
+  positionChange: number;
+  isPodium: boolean;
+  isClean: boolean;
+}

apps/website/lib/dtos/RaceResultRowDto.ts

@@ -0,0 +1,13 @@
+/**
+ * Race result row data transfer object
+ * Represents a row in race results table
+ */
+export interface RaceResultRowDto {
+  id: string;
+  raceId: string;
+  driverId: string;
+  position: number;
+  fastestLap: number;
+  incidents: number;
+  startPosition: number;
+}

apps/website/lib/dtos/RaceResultsDetailDto.ts

@@ -0,0 +1,18 @@
+import type { RaceResultDto } from './RaceResultDto';
+
+/**
+ * Race results detail data transfer object
+ * Detailed results for a race
+ */
+export interface RaceResultsDetailDto {
+  raceId: string;
+  track: string;
+  results: RaceResultDto[];
+  league?: { id: string; name: string };
+  race?: { id: string; track: string; scheduledAt: string };
+  drivers: { id: string; name: string }[];
+  pointsSystem: Record<number, number>;
+  fastestLapTime: number;
+  penalties: { driverId: string; type: string; value?: number }[];
+  currentDriverId: string;
+}

apps/website/lib/dtos/RaceStatsDto.ts

@@ -0,0 +1,7 @@
+/**
+ * Race stats data transfer object
+ * Global race statistics
+ */
+export interface RaceStatsDto {
+  totalRaces: number;
+}

apps/website/lib/dtos/RaceWithSOFDto.ts

@@ -0,0 +1,9 @@
+/**
+ * Race with strength of field data transfer object
+ * Race information including SOF
+ */
+export interface RaceWithSOFDto {
+  id: string;
+  track: string;
+  strengthOfField: number | null;
+}

apps/website/lib/dtos/RacesPageDataDto.ts

@@ -0,0 +1,9 @@
+import type { RacesPageDataRaceDto } from './RacesPageDataRaceDto';
+
+/**
+ * Races page data data transfer object
+ * Data for the races page
+ */
+export interface RacesPageDataDto {
+  races: RacesPageDataRaceDto[];
+}

apps/website/lib/dtos/RacesPageDataRaceDto.ts

@@ -0,0 +1,17 @@
+/**
+ * Races page data race data transfer object
+ * Race information for the races page
+ */
+export interface RacesPageDataRaceDto {
+  id: string;
+  track: string;
+  car: string;
+  scheduledAt: string;
+  status: string;
+  leagueId: string;
+  leagueName: string;
+  strengthOfField: number | null;
+  isUpcoming: boolean;
+  isLive: boolean;
+  isPast: boolean;
+}

apps/website/lib/dtos/RecordEngagementInputDto.ts

@@ -0,0 +1,10 @@
+/**
+ * Record engagement input data transfer object
+ * Input for recording an engagement event
+ */
+export interface RecordEngagementInputDto {
+  eventType: string;
+  eventData?: Record<string, unknown>;
+  userId?: string;
+  sessionId?: string;
+}

apps/website/lib/dtos/RecordEngagementOutputDto.ts

@@ -0,0 +1,7 @@
+/**
+ * Record engagement output data transfer object
+ * Output from recording an engagement event
+ */
+export interface RecordEngagementOutputDto {
+  success: boolean;
+}

apps/website/lib/dtos/RecordPageViewInputDto.ts

@@ -0,0 +1,9 @@
+/**
+ * Record page view input data transfer object
+ * Input for recording a page view event
+ */
+export interface RecordPageViewInputDto {
+  path: string;
+  userId?: string;
+  sessionId?: string;
+}

apps/website/lib/dtos/RecordPageViewOutputDto.ts

@@ -0,0 +1,7 @@
+/**
+ * Record page view output data transfer object
+ * Output from recording a page view
+ */
+export interface RecordPageViewOutputDto {
+  success: boolean;
+}

apps/website/lib/dtos/RegisterForRaceInputDto.ts

@@ -0,0 +1,8 @@
+/**
+ * Register for race input data transfer object
+ * Input for registering a driver for a race
+ */
+export interface RegisterForRaceInputDto {
+  leagueId: string;
+  driverId: string;
+}

apps/website/lib/dtos/RequestAvatarGenerationInputDto.ts

@@ -0,0 +1,8 @@
+/**
+ * Request avatar generation input data transfer object
+ * Input for requesting avatar generation
+ */
+export interface RequestAvatarGenerationInputDto {
+  driverId: string;
+  style?: string;
+}

apps/website/lib/dtos/RequestAvatarGenerationOutputDto.ts

@@ -0,0 +1,9 @@
+/**
+ * Request avatar generation output data transfer object
+ * Output from avatar generation request
+ */
+export interface RequestAvatarGenerationOutputDto {
+  success: boolean;
+  avatarUrl?: string;
+  error?: string;
+}

apps/website/lib/dtos/ScheduledRaceDto.ts

@@ -0,0 +1,11 @@
+/**
+ * Scheduled race data transfer object
+ * Represents a race scheduled in a league
+ */
+export interface ScheduledRaceDto {
+  id: string;
+  name: string;
+  scheduledTime: string;
+  status: string;
+  trackName?: string;
+}

apps/website/lib/dtos/SessionDataDto.ts

@@ -0,0 +1,11 @@
+/**
+ * Session data data transfer object
+ * User session information
+ */
+export interface SessionDataDto {
+  userId: string;
+  email: string;
+  displayName?: string;
+  driverId?: string;
+  isAuthenticated: boolean;
+}

apps/website/lib/dtos/SignupParamsDto.ts

@@ -0,0 +1,9 @@
+/**
+ * Signup parameters data transfer object
+ * Parameters for user signup
+ */
+export interface SignupParamsDto {
+  email: string;
+  password: string;
+  displayName: string;
+}

apps/website/lib/dtos/SponsorDashboardDto.ts

@@ -0,0 +1,11 @@
+/**
+ * Sponsor dashboard data transfer object
+ * Dashboard information for a sponsor
+ */
+export interface SponsorDashboardDto {
+  sponsorId: string;
+  sponsorName: string;
+  totalSponsorships: number;
+  activeSponsorships: number;
+  totalInvestment: number;
+}

apps/website/lib/dtos/SponsorDto.ts

@@ -0,0 +1,10 @@
+/**
+ * Sponsor data transfer object
+ * Represents a sponsor entity
+ */
+export interface SponsorDto {
+  id: string;
+  name: string;
+  logoUrl?: string;
+  websiteUrl?: string;
+}

apps/website/lib/dtos/SponsorSponsorshipsDto.ts

@@ -0,0 +1,11 @@
+import type { SponsorshipDetailDto } from './SponsorshipDetailDto';
+
+/**
+ * Sponsor sponsorships data transfer object
+ * Sponsorships associated with a sponsor
+ */
+export interface SponsorSponsorshipsDto {
+  sponsorId: string;
+  sponsorName: string;
+  sponsorships: SponsorshipDetailDto[];
+}

apps/website/lib/dtos/SponsorshipDetailDto.ts

@@ -0,0 +1,14 @@
+/**
+ * Sponsorship detail data transfer object
+ * Details of a sponsorship
+ */
+export interface SponsorshipDetailDto {
+  id: string;
+  leagueId: string;
+  leagueName: string;
+  seasonId: string;
+  tier: 'main' | 'secondary';
+  status: string;
+  amount: number;
+  currency: string;
+}

apps/website/lib/dtos/StandingEntryDto.ts

@@ -0,0 +1,15 @@
+import type { DriverDto } from './DriverDto';
+
+/**
+ * Standing entry data transfer object
+ * Represents a driver's standing in league standings
+ */
+export interface StandingEntryDto {
+  driverId: string;
+  driver?: DriverDto;
+  position: number;
+  points: number;
+  wins: number;
+  podiums: number;
+  races: number;
+}

apps/website/lib/dtos/TeamDetailsDto.ts

@@ -0,0 +1,15 @@
+import type { TeamMemberDto } from './TeamMemberDto';
+
+/**
+ * Team details data transfer object
+ * Detailed information about a team
+ */
+export interface TeamDetailsDto {
+  id: string;
+  name: string;
+  description?: string;
+  logoUrl?: string;
+  memberCount: number;
+  ownerId: string;
+  members: TeamMemberDto[];
+}

apps/website/lib/dtos/TeamJoinRequestItemDto.ts

@@ -0,0 +1,11 @@
+/**
+ * Team join request item data transfer object
+ * Represents a request to join a team
+ */
+export interface TeamJoinRequestItemDto {
+  id: string;
+  teamId: string;
+  driverId: string;
+  requestedAt: string;
+  message?: string;
+}

apps/website/lib/dtos/TeamJoinRequestsDto.ts

@@ -0,0 +1,9 @@
+import type { TeamJoinRequestItemDto } from './TeamJoinRequestItemDto';
+
+/**
+ * Team join requests data transfer object
+ * List of join requests for a team
+ */
+export interface TeamJoinRequestsDto {
+  requests: TeamJoinRequestItemDto[];
+}

apps/website/lib/dtos/TeamMemberDto.ts

@@ -0,0 +1,12 @@
+import type { DriverDto } from './DriverDto';
+
+/**
+ * Team member data transfer object
+ * Represents a driver's membership in a team
+ */
+export interface TeamMemberDto {
+  driverId: string;
+  driver?: DriverDto;
+  role: string;
+  joinedAt: string;
+}

apps/website/lib/dtos/TeamMembersDto.ts

@@ -0,0 +1,9 @@
+import type { TeamMemberDto } from './TeamMemberDto';
+
+/**
+ * Team members data transfer object
+ * List of team members
+ */
+export interface TeamMembersDto {
+  members: TeamMemberDto[];
+}