view data fixes
Some checks failed
Contract Testing / contract-tests (pull_request) Failing after 5m42s
Contract Testing / contract-snapshot (pull_request) Has been skipped

This commit is contained in:
2026-01-22 23:40:38 +01:00
parent 1288a9dc30
commit 18133aef4c
111 changed files with 841 additions and 324 deletions

View File

@@ -1,25 +1,28 @@
/**
* ViewData Builder Contract
*
* Purpose: Transform ViewModels into ViewData for templates
*
*
* Purpose: Transform API Transport DTOs into ViewData for templates
*
* Rules:
* - Deterministic and side-effect free
* - No HTTP/API calls
* - Input: ViewModel
* - Output: ViewData (JSON-serializable)
* - Input: API Transport DTO (must be JSON-serializable)
* - Output: ViewData (JSON-serializable template-ready data)
* - Must be in lib/builders/view-data/
* - Must be named *ViewDataBuilder
* - Must have 'use client' directive
* - Must implement static build() method
*/
export interface ViewDataBuilder<TInput, TOutput> {
import { JsonValue } from '../types/primitives';
import { ViewData } from '../view-data/ViewData';
export interface ViewDataBuilder<TDTO extends JsonValue, TViewData extends ViewData> {
/**
* Transform ViewModel into ViewData
*
* @param viewModel - Client-side ViewModel
* Transform DTO into ViewData
*
* @param dto - API Transport DTO (JSON-serializable)
* @returns ViewData for template
*/
build(viewModel: TInput): TOutput;
build(dto: TDTO): TViewData;
}

View File

@@ -1,25 +1,28 @@
/**
* ViewModel Builder Contract
*
* Purpose: Transform API Transport DTOs into ViewModels
*
*
* Purpose: Transform ViewData into ViewModels for client-side state management
*
* Rules:
* - Deterministic and side-effect free
* - No HTTP/API calls
* - Input: API Transport DTO
* - Output: ViewModel
* - Input: ViewData (JSON-serializable template-ready data)
* - Output: ViewModel (client-only class)
* - Must be in lib/builders/view-models/
* - Must be named *ViewModelBuilder
* - Must have 'use client' directive
* - Must implement static build() method
*/
export interface ViewModelBuilder<TInput, TOutput> {
import { ViewData } from '../view-data/ViewData';
import { ViewModel } from '../view-models/ViewModel';
export interface ViewModelBuilder<TViewData extends ViewData, TViewModel extends ViewModel> {
/**
* Transform DTO into ViewModel
*
* @param dto - API Transport DTO
* Transform ViewData into ViewModel
*
* @param viewData - ViewData (JSON-serializable template-ready data)
* @returns ViewModel
*/
build(dto: TInput): TOutput;
build(viewData: TViewData): TViewModel;
}

View File

@@ -1,6 +1,6 @@
/**
* Base interface for ViewData objects
*
*
* All ViewData must be JSON-serializable.
* This type ensures no class instances or functions are included.
*/
@@ -10,7 +10,7 @@ export interface ViewData {
/**
* Helper type to ensure a type is ViewData-compatible
*
*
* Usage:
* ```typescript
* type MyViewData = ViewData & {

View File

@@ -0,0 +1,33 @@
/**
* ActivityLevelDisplay
*
* Deterministic mapping of engagement rates to activity level labels.
*/
export class ActivityLevelDisplay {
/**
* Maps engagement rate to activity level label.
*/
static levelLabel(engagementRate: number): string {
if (engagementRate < 20) {
return 'Low';
} else if (engagementRate < 50) {
return 'Medium';
} else {
return 'High';
}
}
/**
* Maps engagement rate to activity level value.
*/
static levelValue(engagementRate: number): 'low' | 'medium' | 'high' {
if (engagementRate < 20) {
return 'low';
} else if (engagementRate < 50) {
return 'medium';
} else {
return 'high';
}
}
}

View File

@@ -0,0 +1,37 @@
/**
* AvatarDisplay
*
* Deterministic mapping of avatar-related data to display formats.
*/
export class AvatarDisplay {
/**
* Converts binary buffer to base64 string for display.
*/
static bufferToBase64(buffer: ArrayBuffer): string {
const bytes = new Uint8Array(buffer);
let binary = '';
for (let i = 0; i < bytes.byteLength; i++) {
binary += String.fromCharCode(bytes[i]);
}
return btoa(binary);
}
/**
* Determines if avatar data is valid for display.
*/
static hasValidData(buffer: ArrayBuffer, contentType: string): boolean {
return buffer.byteLength > 0 && contentType.length > 0;
}
/**
* Formats content type for display (e.g., "image/png" → "PNG").
*/
static formatContentType(contentType: string): string {
const parts = contentType.split('/');
if (parts.length === 2) {
return parts[1].toUpperCase();
}
return contentType;
}
}

View File

@@ -1,36 +1,47 @@
/**
* CurrencyDisplay
*
*
* Deterministic currency formatting for display.
* Avoids Intl and toLocaleString to prevent SSR/hydration mismatches.
*/
export class CurrencyDisplay {
/**
* Formats an amount as currency (e.g., "$10.00").
* Formats an amount as currency (e.g., "$10.00" or "€1.000,00").
* Default currency is USD.
*/
static format(amount: number, currency: string = 'USD'): string {
const symbol = currency === 'USD' ? '$' : currency + ' ';
const symbol = currency === 'USD' ? '$' : currency === 'EUR' ? '€' : currency + ' ';
const formattedAmount = amount.toFixed(2);
// Add thousands separators
const parts = formattedAmount.split('.');
parts[0] = parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, ',');
return `${symbol}${parts.join('.')}`;
// Use dot as thousands separator for EUR, comma for USD
if (currency === 'EUR') {
parts[0] = parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, '.');
return `${symbol}${parts[0]},${parts[1]}`;
} else {
parts[0] = parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, ',');
return `${symbol}${parts.join('.')}`;
}
}
/**
* Formats an amount as a compact currency (e.g., "$10").
* Formats an amount as a compact currency (e.g., "$10" or "€1.000").
*/
static formatCompact(amount: number, currency: string = 'USD'): string {
const symbol = currency === 'USD' ? '$' : currency + ' ';
const symbol = currency === 'USD' ? '$' : currency === 'EUR' ? '€' : currency + ' ';
const roundedAmount = Math.round(amount);
// Add thousands separators
const formattedAmount = roundedAmount.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',');
const formattedAmount = roundedAmount.toString();
return `${symbol}${formattedAmount}`;
// Use dot as thousands separator for EUR, comma for USD
if (currency === 'EUR') {
return `${symbol}${formattedAmount.replace(/\B(?=(\d{3})+(?!\d))/g, '.')}`;
} else {
return `${symbol}${formattedAmount.replace(/\B(?=(\d{3})+(?!\d))/g, ',')}`;
}
}
}

View File

@@ -0,0 +1,39 @@
/**
* LeagueTierDisplay
*
* Deterministic display logic for league tiers.
*/
export interface LeagueTierDisplayData {
color: string;
bgColor: string;
border: string;
icon: string;
}
export class LeagueTierDisplay {
private static readonly CONFIG: Record<string, LeagueTierDisplayData> = {
premium: {
color: 'text-yellow-400',
bgColor: 'bg-yellow-500/10',
border: 'border-yellow-500/30',
icon: '⭐'
},
standard: {
color: 'text-primary-blue',
bgColor: 'bg-primary-blue/10',
border: 'border-primary-blue/30',
icon: '🏆'
},
starter: {
color: 'text-gray-400',
bgColor: 'bg-gray-500/10',
border: 'border-gray-500/30',
icon: '🚀'
},
};
static getDisplay(tier: 'premium' | 'standard' | 'starter'): LeagueTierDisplayData {
return this.CONFIG[tier];
}
}

View File

@@ -0,0 +1,38 @@
/**
* OnboardingStatusDisplay
*
* Deterministic mapping of onboarding status to display labels and variants.
*/
export class OnboardingStatusDisplay {
/**
* Maps onboarding success status to display label.
*/
static statusLabel(success: boolean): string {
return success ? 'Onboarding Complete' : 'Onboarding Failed';
}
/**
* Maps onboarding success status to badge variant.
*/
static statusVariant(success: boolean): string {
return success ? 'performance-green' : 'racing-red';
}
/**
* Maps onboarding success status to icon.
*/
static statusIcon(success: boolean): string {
return success ? '✅' : '❌';
}
/**
* Maps onboarding success status to message.
*/
static statusMessage(success: boolean, errorMessage?: string): string {
if (success) {
return 'Your onboarding has been completed successfully.';
}
return errorMessage || 'Failed to complete onboarding. Please try again.';
}
}

View File

@@ -0,0 +1,35 @@
/**
* SeasonStatusDisplay
*
* Deterministic display logic for season status.
*/
export interface SeasonStatusDisplayData {
color: string;
bg: string;
label: string;
}
export class SeasonStatusDisplay {
private static readonly CONFIG: Record<string, SeasonStatusDisplayData> = {
active: {
color: 'text-performance-green',
bg: 'bg-performance-green/10',
label: 'Active Season'
},
upcoming: {
color: 'text-warning-amber',
bg: 'bg-warning-amber/10',
label: 'Starting Soon'
},
completed: {
color: 'text-gray-400',
bg: 'bg-gray-400/10',
label: 'Season Ended'
},
};
static getDisplay(status: 'active' | 'upcoming' | 'completed'): SeasonStatusDisplayData {
return this.CONFIG[status];
}
}

View File

@@ -0,0 +1,19 @@
/**
* UserRoleDisplay
*
* Deterministic mapping of user role codes to display labels.
*/
export class UserRoleDisplay {
/**
* Maps user role to display label.
*/
static roleLabel(role: string): string {
const map: Record<string, string> = {
owner: 'Owner',
admin: 'Admin',
user: 'User',
};
return map[role] || role;
}
}

View File

@@ -0,0 +1,52 @@
/**
* UserStatusDisplay
*
* Deterministic mapping of user status codes to display labels and variants.
*/
export class UserStatusDisplay {
/**
* Maps user status to display label.
*/
static statusLabel(status: string): string {
const map: Record<string, string> = {
active: 'Active',
suspended: 'Suspended',
deleted: 'Deleted',
};
return map[status] || status;
}
/**
* Maps user status to badge variant.
*/
static statusVariant(status: string): string {
const map: Record<string, string> = {
active: 'performance-green',
suspended: 'yellow-500',
deleted: 'racing-red',
};
return map[status] || 'gray-500';
}
/**
* Determines if a user can be suspended.
*/
static canSuspend(status: string): boolean {
return status === 'active';
}
/**
* Determines if a user can be activated.
*/
static canActivate(status: string): boolean {
return status === 'suspended';
}
/**
* Determines if a user can be deleted.
*/
static canDelete(status: string): boolean {
return status !== 'deleted';
}
}

View File

@@ -1,9 +1,9 @@
import { ProtestDetailViewDataBuilder } from '@/lib/builders/view-data/ProtestDetailViewDataBuilder';
import { PageQuery } from '@/lib/contracts/page-queries/PageQuery';
import { type PresentationError, mapToPresentationError } from '@/lib/contracts/page-queries/PresentationError';
import { Result } from '@/lib/contracts/Result';
import { ProtestDetailService } from '@/lib/services/leagues/ProtestDetailService';
import { ProtestDetailViewDataBuilder } from '@/lib/builders/view-data/ProtestDetailViewDataBuilder';
import { ProtestDetailViewData } from '@/lib/view-data/leagues/ProtestDetailViewData';
import { type PresentationError, mapToPresentationError } from '@/lib/contracts/page-queries/PresentationError';
import { ProtestDetailViewData } from '@/lib/view-data/ProtestDetailViewData';
export class LeagueProtestDetailPageQuery implements PageQuery<ProtestDetailViewData, { leagueId: string; protestId: string }, PresentationError> {
async execute(params: { leagueId: string; protestId: string }): Promise<Result<ProtestDetailViewData, PresentationError>> {

View File

@@ -1,9 +1,9 @@
import { RulebookViewDataBuilder } from '@/lib/builders/view-data/RulebookViewDataBuilder';
import { PageQuery } from '@/lib/contracts/page-queries/PageQuery';
import { type PresentationError, mapToPresentationError } from '@/lib/contracts/page-queries/PresentationError';
import { Result } from '@/lib/contracts/Result';
import { LeagueRulebookService } from '@/lib/services/leagues/LeagueRulebookService';
import { RulebookViewDataBuilder } from '@/lib/builders/view-data/RulebookViewDataBuilder';
import { RulebookViewData } from '@/lib/view-data/leagues/RulebookViewData';
import { type PresentationError, mapToPresentationError } from '@/lib/contracts/page-queries/PresentationError';
import { RulebookViewData } from '@/lib/view-data/RulebookViewData';
export class LeagueRulebookPageQuery implements PageQuery<RulebookViewData, string, PresentationError> {
async execute(leagueId: string): Promise<Result<RulebookViewData, PresentationError>> {

View File

@@ -1,9 +1,9 @@
import { LeagueSettingsViewDataBuilder } from '@/lib/builders/view-data/LeagueSettingsViewDataBuilder';
import { PageQuery } from '@/lib/contracts/page-queries/PageQuery';
import { type PresentationError, mapToPresentationError } from '@/lib/contracts/page-queries/PresentationError';
import { Result } from '@/lib/contracts/Result';
import { LeagueSettingsService } from '@/lib/services/leagues/LeagueSettingsService';
import { LeagueSettingsViewDataBuilder } from '@/lib/builders/view-data/LeagueSettingsViewDataBuilder';
import { LeagueSettingsViewData } from '@/lib/view-data/leagues/LeagueSettingsViewData';
import { type PresentationError, mapToPresentationError } from '@/lib/contracts/page-queries/PresentationError';
import { LeagueSettingsViewData } from '@/lib/view-data/LeagueSettingsViewData';
export class LeagueSettingsPageQuery implements PageQuery<LeagueSettingsViewData, string, PresentationError> {
async execute(leagueId: string): Promise<Result<LeagueSettingsViewData, PresentationError>> {

View File

@@ -1,9 +1,9 @@
import { LeagueSponsorshipsViewDataBuilder } from '@/lib/builders/view-data/LeagueSponsorshipsViewDataBuilder';
import { PageQuery } from '@/lib/contracts/page-queries/PageQuery';
import { type PresentationError, mapToPresentationError } from '@/lib/contracts/page-queries/PresentationError';
import { Result } from '@/lib/contracts/Result';
import { LeagueSponsorshipsService } from '@/lib/services/leagues/LeagueSponsorshipsService';
import { LeagueSponsorshipsViewDataBuilder } from '@/lib/builders/view-data/LeagueSponsorshipsViewDataBuilder';
import { LeagueSponsorshipsViewData } from '@/lib/view-data/leagues/LeagueSponsorshipsViewData';
import { type PresentationError, mapToPresentationError } from '@/lib/contracts/page-queries/PresentationError';
import { LeagueSponsorshipsViewData } from '@/lib/view-data/LeagueSponsorshipsViewData';
export class LeagueSponsorshipsPageQuery implements PageQuery<LeagueSponsorshipsViewData, string, PresentationError> {
async execute(leagueId: string): Promise<Result<LeagueSponsorshipsViewData, PresentationError>> {

View File

@@ -1,9 +1,9 @@
import { StewardingViewDataBuilder } from '@/lib/builders/view-data/StewardingViewDataBuilder';
import { Result } from '@/lib/contracts/Result';
import { PageQuery } from '@/lib/contracts/page-queries/PageQuery';
import { LeagueStewardingService } from '@/lib/services/leagues/LeagueStewardingService';
import { StewardingViewDataBuilder } from '@/lib/builders/view-data/StewardingViewDataBuilder';
import { StewardingViewData } from '@/lib/view-data/leagues/StewardingViewData';
import { type PresentationError, mapToPresentationError } from '@/lib/contracts/page-queries/PresentationError';
import { LeagueStewardingService } from '@/lib/services/leagues/LeagueStewardingService';
import { StewardingViewData } from '@/lib/view-data/StewardingViewData';
export class LeagueStewardingPageQuery implements PageQuery<StewardingViewData, string, PresentationError> {
async execute(leagueId: string): Promise<Result<StewardingViewData, PresentationError>> {

View File

@@ -1,9 +1,9 @@
import { LeagueWalletViewDataBuilder } from '@/lib/builders/view-data/LeagueWalletViewDataBuilder';
import { PageQuery } from '@/lib/contracts/page-queries/PageQuery';
import { type PresentationError, mapToPresentationError } from '@/lib/contracts/page-queries/PresentationError';
import { Result } from '@/lib/contracts/Result';
import { LeagueWalletService } from '@/lib/services/leagues/LeagueWalletService';
import { LeagueWalletViewDataBuilder } from '@/lib/builders/view-data/LeagueWalletViewDataBuilder';
import { LeagueWalletViewData } from '@/lib/view-data/leagues/LeagueWalletViewData';
import { type PresentationError, mapToPresentationError } from '@/lib/contracts/page-queries/PresentationError';
import { LeagueWalletViewData } from '@/lib/view-data/LeagueWalletViewData';
export class LeagueWalletPageQuery implements PageQuery<LeagueWalletViewData, string, PresentationError> {
async execute(leagueId: string): Promise<Result<LeagueWalletViewData, PresentationError>> {

View File

@@ -1,9 +1,9 @@
import { ForgotPasswordViewDataBuilder } from '@/lib/builders/view-data/ForgotPasswordViewDataBuilder';
import { Result } from '@/lib/contracts/Result';
import { PageQuery } from '@/lib/contracts/page-queries/PageQuery';
import { ForgotPasswordViewDataBuilder } from '@/lib/builders/view-data/ForgotPasswordViewDataBuilder';
import { ForgotPasswordViewData } from '@/lib/builders/view-data/types/ForgotPasswordViewData';
import { AuthPageService } from '@/lib/services/auth/AuthPageService';
import { SearchParamParser } from '@/lib/routing/search-params/SearchParamParser';
import { AuthPageService } from '@/lib/services/auth/AuthPageService';
import { ForgotPasswordViewData } from '@/lib/view-data/ForgotPasswordViewData';
export class ForgotPasswordPageQuery implements PageQuery<ForgotPasswordViewData, URLSearchParams | Record<string, string | string[] | undefined>> {
async execute(searchParams: URLSearchParams | Record<string, string | string[] | undefined>): Promise<Result<ForgotPasswordViewData, string>> {

View File

@@ -1,9 +1,9 @@
import { LoginViewDataBuilder } from '@/lib/builders/view-data/LoginViewDataBuilder';
import { Result } from '@/lib/contracts/Result';
import { PageQuery } from '@/lib/contracts/page-queries/PageQuery';
import { LoginViewDataBuilder } from '@/lib/builders/view-data/LoginViewDataBuilder';
import { LoginViewData } from '@/lib/builders/view-data/types/LoginViewData';
import { AuthPageService } from '@/lib/services/auth/AuthPageService';
import { SearchParamParser } from '@/lib/routing/search-params/SearchParamParser';
import { AuthPageService } from '@/lib/services/auth/AuthPageService';
import { LoginViewData } from '@/lib/view-data/LoginViewData';
export class LoginPageQuery implements PageQuery<LoginViewData, URLSearchParams | Record<string, string | string[] | undefined>> {
async execute(searchParams: URLSearchParams | Record<string, string | string[] | undefined>): Promise<Result<LoginViewData, string>> {

View File

@@ -1,9 +1,9 @@
import { ResetPasswordViewDataBuilder } from '@/lib/builders/view-data/ResetPasswordViewDataBuilder';
import { Result } from '@/lib/contracts/Result';
import { PageQuery } from '@/lib/contracts/page-queries/PageQuery';
import { ResetPasswordViewDataBuilder } from '@/lib/builders/view-data/ResetPasswordViewDataBuilder';
import { ResetPasswordViewData } from '@/lib/builders/view-data/types/ResetPasswordViewData';
import { AuthPageService } from '@/lib/services/auth/AuthPageService';
import { SearchParamParser } from '@/lib/routing/search-params/SearchParamParser';
import { AuthPageService } from '@/lib/services/auth/AuthPageService';
import { ResetPasswordViewData } from '@/lib/view-data/ResetPasswordViewData';
export class ResetPasswordPageQuery implements PageQuery<ResetPasswordViewData, URLSearchParams | Record<string, string | string[] | undefined>> {
async execute(searchParams: URLSearchParams | Record<string, string | string[] | undefined>): Promise<Result<ResetPasswordViewData, string>> {

View File

@@ -1,9 +1,9 @@
import { SignupViewDataBuilder } from '@/lib/builders/view-data/SignupViewDataBuilder';
import { SignupViewData } from '@/lib/builders/view-data/types/SignupViewData';
import { Result } from '@/lib/contracts/Result';
import { PageQuery } from '@/lib/contracts/page-queries/PageQuery';
import { AuthPageService } from '@/lib/services/auth/AuthPageService';
import { SearchParamParser } from '@/lib/routing/search-params/SearchParamParser';
import { AuthPageService } from '@/lib/services/auth/AuthPageService';
import { SignupViewData } from '@/lib/view-data/SignupViewData';
export class SignupPageQuery implements PageQuery<SignupViewData, URLSearchParams | Record<string, string | string[] | undefined>> {
async execute(searchParams: URLSearchParams | Record<string, string | string[] | undefined>): Promise<Result<SignupViewData, string>> {

View File

@@ -1,9 +1,9 @@
import { RaceDetailViewDataBuilder } from '@/lib/builders/view-data/RaceDetailViewDataBuilder';
import { Result } from '@/lib/contracts/Result';
import { PageQuery } from '@/lib/contracts/page-queries/PageQuery';
import { PresentationError, mapToPresentationError } from '@/lib/contracts/page-queries/PresentationError';
import { RaceDetailViewData } from '@/lib/view-data/races/RaceDetailViewData';
import { RacesService } from '@/lib/services/races/RacesService';
import { RaceDetailViewDataBuilder } from '@/lib/builders/view-data/RaceDetailViewDataBuilder';
import { RaceDetailViewData } from '@/lib/view-data/RaceDetailViewData';
interface RaceDetailPageQueryParams {
raceId: string;

View File

@@ -1,9 +1,9 @@
import { RaceResultsViewDataBuilder } from '@/lib/builders/view-data/RaceResultsViewDataBuilder';
import { Result } from '@/lib/contracts/Result';
import { PageQuery } from '@/lib/contracts/page-queries/PageQuery';
import { PresentationError, mapToPresentationError } from '@/lib/contracts/page-queries/PresentationError';
import { RaceResultsViewData } from '@/lib/view-data/races/RaceResultsViewData';
import { RaceResultsService } from '@/lib/services/races/RaceResultsService';
import { RaceResultsViewDataBuilder } from '@/lib/builders/view-data/RaceResultsViewDataBuilder';
import { RaceResultsViewData } from '@/lib/view-data/RaceResultsViewData';
interface RaceResultsPageQueryParams {
raceId: string;

View File

@@ -1,9 +1,9 @@
import { RaceStewardingViewDataBuilder } from '@/lib/builders/view-data/RaceStewardingViewDataBuilder';
import { Result } from '@/lib/contracts/Result';
import { PageQuery } from '@/lib/contracts/page-queries/PageQuery';
import { PresentationError, mapToPresentationError } from '@/lib/contracts/page-queries/PresentationError';
import { RaceStewardingViewData } from '@/lib/view-data/races/RaceStewardingViewData';
import { RaceStewardingService } from '@/lib/services/races/RaceStewardingService';
import { RaceStewardingViewDataBuilder } from '@/lib/builders/view-data/RaceStewardingViewDataBuilder';
import { RaceStewardingViewData } from '@/lib/view-data/RaceStewardingViewData';
interface RaceStewardingPageQueryParams {
raceId: string;

View File

@@ -1,5 +1,7 @@
import { ViewData } from '@/lib/contracts/view-data/ViewData';
import { ActionItem } from '@/lib/queries/ActionsPageQuery';
export interface ActionsViewData {
export interface ActionsViewData extends ViewData {
actions: ActionItem[];
}

View File

@@ -0,0 +1,14 @@
import { ViewData } from '../contracts/view-data/ViewData';
/**
* ActivityItemViewData
*
* ViewData for activity item rendering.
*/
export interface ActivityItemViewData extends ViewData {
id: string;
type: string;
message: string;
time: string;
impressions?: number;
}

View File

@@ -1,10 +1,13 @@
import { ViewData } from '@/lib/contracts/view-data/ViewData';
/**
* AdminDashboardViewData
*
*
* ViewData for AdminDashboardTemplate.
* Template-ready data structure with only primitives.
*/
export interface AdminDashboardViewData {
export interface AdminDashboardViewData extends ViewData {
stats: {
totalUsers: number;
activeUsers: number;

View File

@@ -1,10 +1,13 @@
import { ViewData } from '@/lib/contracts/view-data/ViewData';
/**
* AdminUsersViewData
*
*
* ViewData for AdminUsersTemplate.
* Template-ready data structure with only primitives.
*/
export interface AdminUsersViewData {
export interface AdminUsersViewData extends ViewData {
users: Array<{
id: string;
email: string;

View File

@@ -0,0 +1,13 @@
import { ViewData } from "../contracts/view-data/ViewData";
export interface AnalyticsDashboardViewData extends ViewData {
metrics: {
totalUsers: number;
activeUsers: number;
totalRaces: number;
totalLeagues: number;
userEngagementRate: number;
formattedEngagementRate: string;
activityLevel: string;
};
}

View File

@@ -0,0 +1,42 @@
import { ViewData } from "../contracts/view-data/ViewData";
export interface AvailableLeaguesViewData extends ViewData {
leagues: AvailableLeagueViewData[];
}
export interface AvailableLeagueViewData {
id: string;
name: string;
game: string;
drivers: number;
avgViewsPerRace: number;
formattedAvgViews: string;
mainSponsorSlot: {
available: boolean;
price: number;
};
secondarySlots: {
available: number;
total: number;
price: number;
};
cpm: number;
formattedCpm: string;
hasAvailableSlots: boolean;
rating: number;
tier: 'premium' | 'standard' | 'starter';
tierConfig: {
color: string;
bgColor: string;
border: string;
icon: string;
};
nextRace?: string;
seasonStatus: 'active' | 'upcoming' | 'completed';
statusConfig: {
color: string;
bg: string;
label: string;
};
description: string;
}

View File

@@ -0,0 +1,12 @@
import { ViewData } from "../contracts/view-data/ViewData";
/**
* AvatarGenerationViewData
*
* ViewData for avatar generation process.
*/
export interface AvatarGenerationViewData extends ViewData {
success: boolean;
avatarUrls: string[];
errorMessage?: string;
}

View File

@@ -1,9 +1,12 @@
import { ViewData } from '@/lib/contracts/view-data/ViewData';
/**
* AvatarViewData
*
* ViewData for avatar media rendering.
*/
export interface AvatarViewData {
export interface AvatarViewData extends ViewData {
buffer: string; // base64 encoded
contentType: string;
}

View File

@@ -1,9 +1,13 @@
import { ViewData } from '@/lib/contracts/view-data/ViewData';
/**
* CategoryIconViewData
*
* ViewData for category icon media rendering.
*/
export interface CategoryIconViewData {
import { ViewData } from "../contracts/view-data/ViewData";
export interface CategoryIconViewData extends ViewData {
buffer: string; // base64 encoded
contentType: string;
}

View File

@@ -0,0 +1,14 @@
import { ViewData } from '../contracts/view-data/ViewData';
/**
* CreateLeagueViewData
*
* ViewData for the create league result page.
* Contains only raw serializable data, no methods or computed properties
*/
export interface CreateLeagueViewData extends ViewData {
leagueId: string;
success: boolean;
successMessage: string;
}

View File

@@ -1,3 +1,5 @@
import { ViewData } from '@/lib/contracts/view-data/ViewData';
/**
* Dashboard ViewData
*
@@ -6,7 +8,8 @@
* for display and ISO string timestamps for JSON serialization.
*/
export interface DashboardViewData {
export interface DashboardViewData extends ViewData {
currentDriver: {
name: string;
avatarUrl: string;

View File

@@ -1,4 +1,7 @@
export interface DriverRankingItem {
import { ViewData } from '@/lib/contracts/view-data/ViewData';
export interface DriverRankingItem extends ViewData {
id: string;
name: string;
rating: number;

View File

@@ -1,7 +1,9 @@
import { ViewData } from '@/lib/contracts/view-data/ViewData';
import type { DriverRankingItem } from './DriverRankingItem';
import type { PodiumDriver } from './PodiumDriver';
export interface DriverRankingsViewData {
export interface DriverRankingsViewData extends ViewData {
drivers: DriverRankingItem[];
podium: PodiumDriver[];
searchQuery: string;

View File

@@ -0,0 +1,18 @@
import { ViewData } from '@/lib/contracts/view-data/ViewData';
/**
* Forgot Password View Data
*
* ViewData for the forgot password template.
*/
export interface ForgotPasswordViewData extends ViewData {
returnTo: string;
showSuccess: boolean;
successMessage?: string;
magicLink?: string;
formState: any; // Will be managed by client component
isSubmitting: boolean;
submitError?: string;
}

View File

@@ -1,3 +1,4 @@
/**
* Health View Data Types
*
@@ -52,7 +53,9 @@ export interface HealthAlert {
severityColor: string;
}
export interface HealthViewData {
import { ViewData } from "../contracts/view-data/ViewData";
export interface HealthViewData extends ViewData {
overallStatus: HealthStatus;
metrics: HealthMetrics;
components: HealthComponent[];

View File

@@ -1,4 +1,7 @@
export interface LeaderboardDriverItem {
import { ViewData } from '@/lib/contracts/view-data/ViewData';
export interface LeaderboardDriverItem extends ViewData {
id: string;
name: string;
rating: number;

View File

@@ -1,4 +1,7 @@
export interface LeaderboardTeamItem {
import { ViewData } from '@/lib/contracts/view-data/ViewData';
export interface LeaderboardTeamItem extends ViewData {
id: string;
name: string;
tag: string;

View File

@@ -1,7 +1,9 @@
import { ViewData } from '@/lib/contracts/view-data/ViewData';
import type { LeaderboardDriverItem } from './LeaderboardDriverItem';
import type { LeaderboardTeamItem } from './LeaderboardTeamItem';
export interface LeaderboardsViewData {
export interface LeaderboardsViewData extends ViewData {
drivers: LeaderboardDriverItem[];
teams: LeaderboardTeamItem[];
}

View File

@@ -1,17 +1,10 @@
export interface AdminScheduleRaceData {
import { ViewData } from '@/lib/contracts/view-data/ViewData';
export interface AdminScheduleRaceData extends ViewData {
id: string;
name: string;
track: string;
car: string;
scheduledAt: string; // ISO string
}
export interface LeagueAdminScheduleViewData {
published: boolean;
races: AdminScheduleRaceData[];
seasons: Array<{
seasonId: string;
name: string;
}>;
seasonId: string;
}
}

View File

@@ -1,9 +1,12 @@
import { ViewData } from '@/lib/contracts/view-data/ViewData';
/**
* LeagueCoverViewData
*
* ViewData for league cover media rendering.
*/
export interface LeagueCoverViewData {
export interface LeagueCoverViewData extends ViewData {
buffer: string; // base64 encoded
contentType: string;
}

View File

@@ -87,6 +87,7 @@ export interface RecentResult {
finishedAt: string;
}
export interface LeagueDetailViewData extends ViewData {
// Basic info
leagueId: string;

View File

@@ -1,9 +1,12 @@
import { ViewData } from '@/lib/contracts/view-data/ViewData';
/**
* LeagueLogoViewData
*
* ViewData for league logo media rendering.
* ViewData for league logoViewData extends ViewData {dering.
*/
export interface LeagueLogoViewData {
export interface LeagueLogoViewData extends ViewData {
buffer: string; // base64 encoded
contentType: string;
}

View File

@@ -1,3 +1,5 @@
import { ViewData } from '@/lib/contracts/view-data/ViewData';
/**
* LeagueRosterAdminViewData - Pure ViewData for RosterAdminPage
* Contains only raw serializable data, no methods or computed properties
@@ -25,7 +27,8 @@ export interface JoinRequestData {
message?: string;
}
export interface LeagueRosterAdminViewData {
export interface LeagueRosterAdminViewData extends ViewData {
leagueId: string;
members: RosterMemberData[];
joinRequests: JoinRequestData[];

View File

@@ -1,4 +1,7 @@
export interface RulebookScoringConfig {
import { ViewData } from '@/lib/contracts/view-data/ViewData';
export interface RulebookScoringConfig extends ViewData {
scoringPresetName: string | null;
gameName: string;
championships: Array<{
@@ -12,9 +15,4 @@ export interface RulebookScoringConfig {
bonusSummary: string[];
}>;
dropPolicySummary: string;
}
export interface LeagueRulebookViewData {
scoringConfig: RulebookScoringConfig | null;
positionPoints: Array<{ position: number; points: number }>;
}
}

View File

@@ -1,3 +1,5 @@
import { ViewData } from '@/lib/contracts/view-data/ViewData';
/**
* LeagueScheduleViewData - Pure ViewData for LeagueScheduleTemplate
* Contains only raw serializable data, no methods or computed properties
@@ -12,7 +14,8 @@ export interface ScheduleRaceData {
status: string;
}
export interface LeagueScheduleViewData {
export interface LeagueScheduleViewData extends ViewData {
leagueId: string;
races: ScheduleRaceData[];
seasons: Array<{

View File

@@ -1,4 +1,7 @@
export interface LeagueSettingsViewData {
import { ViewData } from "../contracts/view-data/ViewData";
export interface LeagueSettingsViewData extends ViewData {
leagueId: string;
league: {
id: string;

View File

@@ -1,4 +1,7 @@
export interface LeagueSponsorshipsViewData {
import { ViewData } from '@/lib/contracts/view-data/ViewData';
export interface LeagueSponsorshipsViewData extends ViewData {
leagueId: string;
activeTab: 'overview' | 'editor';
onTabChange: (tab: 'overview' | 'editor') => void;

View File

@@ -1,25 +1,4 @@
/**
* LeagueStandingsViewData - Pure ViewData for LeagueStandingsTemplate
* Contains only raw serializable data, no methods or computed properties
*/
export interface StandingEntryData {
driverId: string;
position: number;
totalPoints: number;
racesFinished: number;
racesStarted: number;
avgFinish: number | null;
penaltyPoints: number;
bonusPoints: number;
teamName?: string;
// New fields from Phase 3
positionChange: number;
lastRacePoints: number;
droppedRaceIds: string[];
wins: number;
podiums: number;
}
export interface DriverData {
id: string;
@@ -36,15 +15,4 @@ export interface LeagueMembershipData {
role: 'owner' | 'admin' | 'steward' | 'member';
joinedAt: string;
status: 'active' | 'pending' | 'banned';
}
export interface LeagueStandingsViewData {
standings: StandingEntryData[];
drivers: DriverData[];
memberships: LeagueMembershipData[];
leagueId: string;
currentDriverId: string | null;
isAdmin: boolean;
// New fields for team standings toggle
isTeamChampionship?: boolean;
}

View File

@@ -0,0 +1,16 @@
import { ViewData } from "../contracts/view-data/ViewData";
export interface LeagueWalletTransactionViewData extends ViewData {
id: string;
type: 'deposit' | 'withdrawal' | 'sponsorship' | 'prize';
amount: number;
formattedAmount: string;
amountColor: string;
description: string;
createdAt: string;
formattedDate: string;
status: 'completed' | 'pending' | 'failed';
statusColor: string;
typeColor: string;
}

View File

@@ -1,3 +1,5 @@
import { ViewData } from '@/lib/contracts/view-data/ViewData';
/**
* Leagues ViewData
*
@@ -6,7 +8,8 @@
* for display and ISO string timestamps for JSON serialization.
*/
export interface LeaguesViewData {
export interface LeaguesViewData extends ViewData {
leagues: Array<{
id: string;
name: string;

View File

@@ -0,0 +1,20 @@
/**
* Login View Data
*
* ViewData for the login template.
*/
import { FormState } from '../builders/view-data/types/FormState';
import { ViewData } from '@/lib/contracts/view-data/ViewData';
export interface LoginViewData extends ViewData {
returnTo: string;
hasInsufficientPermissions: boolean;
showPassword: boolean;
showErrorDetails: boolean;
formState: FormState;
isSubmitting: boolean;
submitError?: string;
}

View File

@@ -1,6 +1,8 @@
import { MediaAsset } from '@/components/media/MediaGallery';
import { ViewData } from '../contracts/view-data/ViewData';
export interface MediaViewData {
export interface MediaViewData extends ViewData {
assets: MediaAsset[];
categories: { label: string; value: string }[];
title: string;

View File

@@ -1,3 +1,6 @@
export interface OnboardingPageViewData {
import { ViewData } from "../contracts/view-data/ViewData";
export interface OnboardingPageViewData extends ViewData {
isAlreadyOnboarded: boolean;
}

View File

@@ -1,4 +1,7 @@
export interface PodiumDriver {
import { ViewData } from '@/lib/contracts/view-data/ViewData';
export interface PodiumDriverViewData extends ViewData {
id: string;
name: string;
rating: number;

View File

@@ -1,3 +1,6 @@
export interface ProfileLayoutViewData {
import { ViewData } from "../contracts/view-data/ViewData";
export interface ProfileLayoutViewData extends ViewData {
// Empty for now
}

View File

@@ -3,14 +3,18 @@
* Pure, JSON-serializable data structure for Template rendering
*/
export interface ProfileLeaguesLeagueViewData {
import { ViewData } from "../contracts/view-data/ViewData";
export interface ProfileLeaguesLeagueViewData extends ViewData {
leagueId: string;
name: string;
description: string;
membershipRole: 'owner' | 'admin' | 'steward' | 'member';
}
export interface ProfileLeaguesViewData {
export interface ProfileLeaguesViewData extends ViewData {
ownedLeagues: ProfileLeaguesLeagueViewData[];
memberLeagues: ProfileLeaguesLeagueViewData[];
}

View File

@@ -1,4 +1,7 @@
export interface ProfileLiveryViewData {
import { ViewData } from "../contracts/view-data/ViewData";
export interface ProfileLiveryViewData extends ViewData {
id: string;
carId: string;
carName: string;
@@ -7,6 +10,7 @@ export interface ProfileLiveryViewData {
isValidated: boolean;
}
export interface ProfileLiveriesViewData {
export interface ProfileLiveriesViewData extends ViewData {
liveries: ProfileLiveryViewData[];
}

View File

@@ -1,4 +1,7 @@
export interface ProfileViewData {
import { ViewData } from "../contracts/view-data/ViewData";
export interface ProfileViewData extends ViewData {
driver: {
id: string;
name: string;

View File

@@ -1,4 +1,7 @@
export interface ProtestDetailViewData {
import { ViewData } from "../contracts/view-data/ViewData";
export interface ProtestDetailViewData extends ViewData {
protestId: string;
leagueId: string;
status: string;

View File

@@ -5,6 +5,8 @@
* JSON-serializable, template-ready data structure.
*/
import { ViewData } from "../contracts/view-data/ViewData";
export interface RaceDetailEntry {
id: string;
name: string;
@@ -48,7 +50,8 @@ export interface RaceDetailRegistration {
canRegister: boolean;
}
export interface RaceDetailViewData {
export interface RaceDetailViewData extends ViewData {
race: RaceDetailRace;
league?: RaceDetailLeague;
entryList: RaceDetailEntry[];

View File

@@ -5,6 +5,8 @@
* JSON-serializable, template-ready data structure.
*/
import { ViewData } from "../contracts/view-data/ViewData";
export interface RaceResultsResult {
position: number;
driverId: string;
@@ -29,7 +31,8 @@ export interface RaceResultsPenalty {
notes?: string;
}
export interface RaceResultsViewData {
export interface RaceResultsViewData extends ViewData {
raceTrack?: string;
raceScheduledAt?: string;
totalDrivers?: number;

View File

@@ -5,6 +5,8 @@
* JSON-serializable, template-ready data structure.
*/
import { ViewData } from "../contracts/view-data/ViewData";
export interface Protest {
id: string;
protestingDriverId: string;
@@ -33,7 +35,8 @@ export interface Driver {
name: string;
}
export interface RaceStewardingViewData {
export interface RaceStewardingViewData extends ViewData {
race?: {
id: string;
track: string;

View File

@@ -1,4 +1,7 @@
export interface RaceViewData {
import { ViewData } from "../contracts/view-data/ViewData";
export interface RaceViewData extends ViewData {
id: string;
track: string;
car: string;
@@ -19,7 +22,8 @@ export interface RaceViewData {
isPast: boolean;
}
export interface RacesViewData {
export interface RacesViewData extends ViewData {
races: RaceViewData[];
totalCount: number;
scheduledCount: number;

View File

@@ -0,0 +1,18 @@
/**
* Reset Password View Data
*
* ViewData for the reset password template.
*/
import { ViewData } from "../contracts/view-data/ViewData";
export interface ResetPasswordViewData extends ViewData {
token: string;
returnTo: string;
showSuccess: boolean;
successMessage?: string;
formState: any; // Will be managed by client component
isSubmitting: boolean;
submitError?: string;
}

View File

@@ -1,4 +1,7 @@
export interface RulebookViewData {
import { ViewData } from "../contracts/view-data/ViewData";
export interface RulebookViewData extends ViewData {
leagueId: string;
gameName: string;
scoringPresetName: string;

View File

@@ -0,0 +1,15 @@
/**
* Signup View Data
*
* ViewData for the signup template.
*/
import { ViewData } from "../contracts/view-data/ViewData";
export interface SignupViewData extends ViewData {
returnTo: string;
formState: any; // Will be managed by client component
isSubmitting: boolean;
submitError?: string;
}

View File

@@ -1,4 +1,7 @@
export interface SponsorDashboardViewData {
import { ViewData } from "../contracts/view-data/ViewData";
export interface SponsorDashboardViewData extends ViewData {
sponsorName: string;
totalImpressions: string;
totalInvestment: string;

View File

@@ -1,9 +1,12 @@
import { ViewData } from "../contracts/view-data/ViewData";
/**
* SponsorLogoViewData
*
* ViewData for sponsor logo media rendering.
*/
export interface SponsorLogoViewData {
export interface SponsorLogoViewData extends ViewData {
buffer: string; // base64 encoded
contentType: string;
}

View File

@@ -1,4 +1,7 @@
export interface StewardingViewData {
import { ViewData } from "../contracts/view-data/ViewData";
export interface StewardingViewData extends ViewData {
leagueId: string;
totalPending: number;
totalResolved: number;

View File

@@ -3,6 +3,8 @@
* Contains only raw serializable data, no methods or computed properties
*/
import { ViewData } from "../contracts/view-data/ViewData";
export interface SponsorMetric {
icon: string; // Icon name (e.g. 'users', 'zap', 'calendar')
label: string;
@@ -51,7 +53,8 @@ export interface TeamTab {
visible: boolean;
}
export interface TeamDetailViewData {
export interface TeamDetailViewData extends ViewData {
team: TeamDetailData;
memberships: TeamMemberData[];
currentDriverId: string;

View File

@@ -1,9 +1,11 @@
import { ViewData } from '../contracts/view-data/ViewData';
import type { TeamSummaryViewModel } from '../view-models/TeamSummaryViewModel';
export type SkillLevel = 'pro' | 'advanced' | 'intermediate' | 'beginner';
export type SortBy = 'rating' | 'wins' | 'winRate' | 'races';
export interface TeamLeaderboardViewData {
export interface TeamLeaderboardViewData extends ViewData {
teams: TeamSummaryViewModel[];
searchQuery: string;
filterLevel: SkillLevel | 'all';

View File

@@ -1,9 +1,12 @@
import { ViewData } from "../contracts/view-data/ViewData";
/**
* TeamLogoViewData
*
* ViewData for team logo media rendering.
*/
export interface TeamLogoViewData {
export interface TeamLogoViewData extends ViewData {
buffer: string; // base64 encoded
contentType: string;
}

View File

@@ -1,6 +1,8 @@
import { ViewData } from '../contracts/view-data/ViewData';
import type { LeaderboardTeamItem } from './LeaderboardTeamItem';
export interface TeamRankingsViewData {
export interface TeamRankingsViewData extends ViewData {
teams: LeaderboardTeamItem[];
podium: LeaderboardTeamItem[];
recruitingCount: number;

View File

@@ -22,6 +22,7 @@ export interface TeamSummaryData {
countryCode?: string;
}
export interface TeamsViewData extends ViewData {
teams: TeamSummaryData[];
}

View File

@@ -1,9 +1,12 @@
import { ViewData } from "../contracts/view-data/ViewData";
/**
* TrackImageViewData
*
* ViewData for track image media rendering.
*/
export interface TrackImageViewData {
export interface TrackImageViewData extends ViewData {
buffer: string; // base64 encoded
contentType: string;
}

View File

@@ -1,24 +0,0 @@
export interface LeagueScheduleViewData {
leagueId: string;
races: Array<{
id: string;
name: string;
scheduledAt: string; // ISO string
track?: string;
car?: string;
sessionType?: string;
isPast: boolean;
isUpcoming: boolean;
status: 'scheduled' | 'completed';
strengthOfField?: number;
// Registration info
isUserRegistered?: boolean;
canRegister?: boolean;
// Admin info
canEdit?: boolean;
canReschedule?: boolean;
}>;
// User permissions
currentDriverId?: string;
isAdmin: boolean;
}

View File

@@ -1,27 +0,0 @@
export interface LeagueWalletTransactionViewData {
id: string;
type: 'deposit' | 'withdrawal' | 'sponsorship' | 'prize';
amount: number;
formattedAmount: string;
amountColor: string;
description: string;
createdAt: string;
formattedDate: string;
status: 'completed' | 'pending' | 'failed';
statusColor: string;
typeColor: string;
}
export interface LeagueWalletViewData {
leagueId: string;
balance: number;
formattedBalance: string;
totalRevenue: number;
formattedTotalRevenue: string;
totalFees: number;
formattedTotalFees: string;
pendingPayouts: number;
formattedPendingPayouts: string;
currency: string;
transactions: LeagueWalletTransactionViewData[];
}