pro-clubs-shared-dtos 3.0.0

package/src/dtos/requests/fixture-requests.ts

@@ -0,0 +1,13 @@
+// Fixture Request DTOs
+export interface CreateFixtureRequestDTO {
+  leagueId: string;
+  seasonNumber: number;
+  homeTeamId: string;
+  awayTeamId: string;
+  scheduledDate: Date;
+}
+
+export interface UpdateFixtureRequestDTO {
+  scheduledDate?: Date;
+  status?: string;
+}

package/src/dtos/requests/game-requests.ts

@@ -0,0 +1,16 @@
+// Game Request DTOs
+export interface CreateGameRequestDTO {
+  fixtureId: string;
+  leagueId: string;
+  seasonNumber: number;
+  homeTeamScore: number;
+  awayTeamScore: number;
+  date: Date;
+}
+
+export interface UpdateGameRequestDTO {
+  homeTeamScore?: number;
+  awayTeamScore?: number;
+  status?: string;
+  date?: Date;
+}

package/src/dtos/requests/index.ts

@@ -0,0 +1,8 @@
+// Player Request DTOs
+export * from './create-player-request';
+export * from './update-player-data-request';
+export * from './player-requests';
+export * from './player-performance-request';
+export * from './fixture-game-requests';
+export * from './fixture-requests';
+export * from './game-requests';

package/src/dtos/requests/player-performance-request.ts

@@ -0,0 +1,18 @@
+// Base Update Player Performance Data Request
+export interface BaseUpdatePlayerPerformanceDataRequest {
+  playerId: string;
+  positionPlayed: string;
+  rating: number;
+  goals?: number;
+  assists?: number;
+  playerOfTheMatch?: boolean;
+  chemistry?: string;
+  chemistryBoost?: number;
+  cleanSheet?: boolean;
+}
+
+// Update Player Performance Data Request (exported as requested)
+export interface UpdatePlayerPerformanceDataRequest extends BaseUpdatePlayerPerformanceDataRequest {
+  // Additional properties can be added by consumers
+  [key: string]: any;
+}

package/src/dtos/requests/player-requests.ts

@@ -0,0 +1,9 @@
+// Player Requests
+export interface PlayerRequestDTO {
+  playerId: string;
+  firstName: string;
+  lastName: string;
+  email: string;
+  nation?: string;
+  club?: string;
+}

package/src/dtos/requests/update-player-data-request.ts

@@ -0,0 +1,9 @@
+// Update Player Data Request
+export interface UpdatePlayerDataRequestDTO {
+  overall?: number;
+  potential?: number;
+  age?: number;
+  position?: string;
+  imgUrl?: string;
+  [key: string]: any;
+}

package/src/dtos/responses/api-error-response.interface.ts

@@ -0,0 +1,71 @@
+/**
+ * Standardized API Error Response Interface
+ * This interface ensures all errors returned to clients have a consistent format
+ */
+export interface ApiErrorResponse {
+  /**
+   * HTTP status code (200-599)
+   */
+  statusCode: number;
+
+  /**
+   * Human-readable error message for end users
+   * Should explain WHAT went wrong in simple terms
+   */
+  message: string;
+
+  /**
+   * Error code for frontend to use for internationalization or specific handling
+   * Examples: 'INVALID_INPUT', 'UNAUTHORIZED', 'NOT_FOUND', 'SERVER_ERROR', etc.
+   */
+  errorCode?: string;
+
+  /**
+   * Additional details about the error (optional)
+   * Useful for validation errors or detailed context
+   */
+  details?: {
+    [key: string]: any;
+  };
+
+  /**
+   * Timestamp when the error occurred
+   */
+  timestamp?: string;
+
+  /**
+   * Request path that caused the error (for debugging)
+   */
+  path?: string;
+}
+
+/**
+ * Error code enum for consistent error handling
+ */
+export enum ErrorCode {
+  // Client Errors (4xx)
+  BAD_REQUEST = 'BAD_REQUEST',
+  INVALID_INPUT = 'INVALID_INPUT',
+  MISSING_REQUIRED_FIELD = 'MISSING_REQUIRED_FIELD',
+  UNAUTHORIZED = 'UNAUTHORIZED',
+  TOKEN_EXPIRED = 'TOKEN_EXPIRED',
+  FORBIDDEN = 'FORBIDDEN',
+  NOT_FOUND = 'NOT_FOUND',
+  RESOURCE_NOT_FOUND = 'RESOURCE_NOT_FOUND',
+  CONFLICT = 'CONFLICT',
+  DUPLICATE_ENTRY = 'DUPLICATE_ENTRY',
+  VALIDATION_ERROR = 'VALIDATION_ERROR',
+
+  // Server Errors (5xx)
+  INTERNAL_SERVER_ERROR = 'INTERNAL_SERVER_ERROR',
+  DATABASE_ERROR = 'DATABASE_ERROR',
+  EXTERNAL_SERVICE_ERROR = 'EXTERNAL_SERVICE_ERROR',
+  FILE_UPLOAD_ERROR = 'FILE_UPLOAD_ERROR',
+  
+  // Custom Business Logic Errors
+  PLAYER_ASSOCIATION_ERROR = 'PLAYER_ASSOCIATION_ERROR',
+  TRANSFER_REQUEST_ERROR = 'TRANSFER_REQUEST_ERROR',
+  TEAM_ERROR = 'TEAM_ERROR',
+  PLAYER_ERROR = 'PLAYER_ERROR',
+  USER_ERROR = 'USER_ERROR',
+}

package/src/dtos/responses/error-dtos.ts

@@ -0,0 +1,39 @@
+// API Error Response DTOs
+export interface ApiErrorResponse {
+  statusCode: number;
+  message: string;
+  errorCode?: string;
+  details?: {
+    [key: string]: any;
+  };
+  timestamp?: string;
+  path?: string;
+}
+
+export enum ErrorCode {
+  // Client Errors (4xx)
+  BAD_REQUEST = 'BAD_REQUEST',
+  INVALID_INPUT = 'INVALID_INPUT',
+  MISSING_REQUIRED_FIELD = 'MISSING_REQUIRED_FIELD',
+  UNAUTHORIZED = 'UNAUTHORIZED',
+  TOKEN_EXPIRED = 'TOKEN_EXPIRED',
+  FORBIDDEN = 'FORBIDDEN',
+  NOT_FOUND = 'NOT_FOUND',
+  RESOURCE_NOT_FOUND = 'RESOURCE_NOT_FOUND',
+  CONFLICT = 'CONFLICT',
+  DUPLICATE_ENTRY = 'DUPLICATE_ENTRY',
+  VALIDATION_ERROR = 'VALIDATION_ERROR',
+
+  // Server Errors (5xx)
+  INTERNAL_SERVER_ERROR = 'INTERNAL_SERVER_ERROR',
+  DATABASE_ERROR = 'DATABASE_ERROR',
+  EXTERNAL_SERVICE_ERROR = 'EXTERNAL_SERVICE_ERROR',
+  FILE_UPLOAD_ERROR = 'FILE_UPLOAD_ERROR',
+  
+  // Custom Business Logic Errors
+  PLAYER_ASSOCIATION_ERROR = 'PLAYER_ASSOCIATION_ERROR',
+  TRANSFER_REQUEST_ERROR = 'TRANSFER_REQUEST_ERROR',
+  TEAM_ERROR = 'TEAM_ERROR',
+  PLAYER_ERROR = 'PLAYER_ERROR',
+  USER_ERROR = 'USER_ERROR',
+}

package/src/dtos/responses/event-dtos.ts

@@ -0,0 +1,97 @@
+// Event DTOs
+export interface AllStarTeamDTO {
+  id: string;
+  name: string;
+  captainId: string;
+  players: string[];
+}
+
+export interface AllStarDraftConfigDTO {
+  numberOfCaptains: number;
+  matchFormat: string; // SERIES_FORMAT
+  registrationOpenDate: Date;
+  registrationCloseDate: Date;
+  teams?: AllStarTeamDTO[];
+  captainIds?: string[];
+}
+
+export interface EventStatsDTO {
+  playerId: string;
+  goals: number;
+  assists: number;
+  appearances: number;
+  playerOfTheMatch: number;
+  avgRating: number;
+}
+
+export interface EventDTO {
+  id: string;
+  name: string;
+  type: string; // EVENT_TYPE
+  league: string;
+  seasonNumber: number;
+  date: Date;
+  status: string; // EVENT_STATUS
+  createdBy: string;
+  createdAt: Date;
+  updatedAt: Date;
+
+  // All-Star specific fields
+  allStarConfig?: AllStarDraftConfigDTO;
+  registeredPlayers?: string[];
+  fixtures?: string[];
+  stats?: EventStatsDTO[];
+
+  // Event outcome
+  winnerTeam?: AllStarTeamDTO;
+  completedDate?: Date;
+}
+
+export interface CreateEventDTO {
+  name: string;
+  type: string; // EVENT_TYPE
+  league: string;
+  seasonNumber: number;
+  date: Date;
+  allStarConfig?: {
+    numberOfCaptains: number;
+    matchFormat: string; // SERIES_FORMAT
+    registrationOpenDate: Date;
+    registrationCloseDate: Date;
+  };
+}
+
+export interface RegisterForEventDTO {
+  eventId: string;
+  playerId: string;
+}
+
+export interface SelectCaptainsDTO {
+  eventId: string;
+  captainIds: string[];
+}
+
+export interface AddPlayerToDraftTeamDTO {
+  eventId: string;
+  teamIndex: number;
+  playerId: string;
+}
+
+export interface FinishDraftDTO {
+  eventId: string;
+  teams: Array<{
+    index: number;
+    name: string;
+    captainId: string;
+  }>;
+}
+
+export interface UpdateEventStatsDTO {
+  eventId: string;
+  playerId: string;
+  goals?: number;
+  assists?: number;
+  appearances?: number;
+  playerOfTheMatch?: number;
+  avgRating?: number;
+}

package/src/dtos/responses/fixture-dtos.ts

@@ -0,0 +1,52 @@
+// Fixture DTO
+export type FixtureDTO = {
+  id: string;
+  leagueId: string;
+  seasonNumber: number;
+  homeTeamId: string;
+  awayTeamId: string;
+  homeTeamName: string;
+  awayTeamName: string;
+  homeTeamImg?: string;
+  awayTeamImg?: string;
+  scheduledDate: Date;
+  startDate?: Date;
+  endDate?: Date;
+  round?: number;
+  status: string;
+  games: any[]; // Array of GameDTO
+  isPlayoff?: boolean;
+  playoffDetails?: any;
+  [key: string]: any;
+};
+
+// Extended Fixture DTO (for internal use)
+export type ExtendedFixtureDTO = FixtureDTO & {
+  isPlayoff?: boolean;
+  playoffDetails?: any;
+  [key: string]: any;
+};
+
+// Paginated Fixture DTO
+export type PaginatedFixtureDTO = {
+  fixtures: FixtureDTO[];
+  page?: number;
+  pageSize?: number;
+  totalItems?: number;
+  totalPages?: number;
+  hasNextPage?: boolean;
+  hasPreviousPage?: boolean;
+  currentPage?: number;
+  totalFixtures?: number;
+  [key: string]: any;
+};
+
+// Game Fixture Data (for fixture creation)
+export type GameFixtureData = {
+  homeTeamId: string;
+  awayTeamId: string;
+  isPlayoff?: boolean;
+  playoffStage?: string;
+  matchNumber?: number;
+  [key: string]: any;
+};

package/src/dtos/responses/game-dtos.ts

@@ -0,0 +1,82 @@
+// Player Performance DTO
+export type PlayerPerformanceDTO = {
+  playerId: string;
+  playerName: string;
+  position: string;
+  shirtNumber: number;
+  rating: number;
+  goals: number;
+  assists: number;
+  isPotm: boolean;
+  chemistry: string;
+  chemistryBoost?: number;
+  nation?: string;
+  club?: string;
+  isBotPlayer?: boolean;
+  botName?: string;
+  positionPlayed?: string;
+  imgUrl?: string;
+  [key: string]: any;
+};
+
+// Extended Player Performance DTO (for internal use)
+export type ExtendedPlayerPerformanceDTO = PlayerPerformanceDTO & {
+  isBotPlayer?: boolean;
+  positionPlayed?: string;
+  [key: string]: any;
+};
+
+// Game DTO
+export type GameDTO = {
+  id: string;
+  fixtureId: string;
+  leagueId: string;
+  seasonNumber: number;
+  homeTeam: {
+    id: string;
+    name: string;
+    imgUrl?: string;
+  };
+  awayTeam: {
+    id: string;
+    name: string;
+    imgUrl?: string;
+  };
+  homeTeamScore: number;
+  awayTeamScore: number;
+  status: string; // GAME_STATUS
+  date?: Date;
+  playersPerformance?: PlayerPerformanceDTO[];
+  homeTeamLineup?: {
+    playersPerformance?: PlayerPerformanceDTO[];
+  };
+  awayTeamLineup?: {
+    playersPerformance?: PlayerPerformanceDTO[];
+  };
+  isPlayoff?: boolean;
+  playoffStage?: string | null;
+  broadcast?: {
+    streamUrl: string;
+    broadcastingTeam: string;
+  };
+  aiAnalysisImage?: string;
+  homeTeamPlayersImage?: string;
+  awayTeamPlayersImage?: string;
+  eaGameDetails?: any;
+  [key: string]: any; // Allow extended properties for specialized DTOs
+};
+
+// Extended Game DTO (for internal use)
+export type ExtendedGameDTO = GameDTO & {
+  isPlayoff?: boolean;
+  playoffStage?: string | null;
+  broadcast?: {
+    streamUrl: string;
+    broadcastingTeam: string;
+  };
+  aiAnalysisImage?: string;
+  homeTeamPlayersImage?: string;
+  awayTeamPlayersImage?: string;
+  eaGameDetails?: any;
+  [key: string]: any;
+};

package/src/dtos/responses/index.ts

@@ -0,0 +1,11 @@
+// Export all response DTOs
+export * from './game-dtos';
+export * from './fixture-dtos';
+export * from './player-dtos';
+export * from './team-dtos';
+export * from './league-dtos';
+export * from './stats-dtos';
+export * from './event-dtos';
+export * from './transfer-dtos';
+export * from './notification-dtos';
+export * from './error-dtos';

package/src/dtos/responses/league-dtos.ts

@@ -0,0 +1,10 @@
+// League DTO
+export type LeagueDTO = {
+  id: string;
+  name: string;
+  description?: string;
+  currentSeason: number;
+  createdAt: Date;
+  updatedAt: Date;
+  [key: string]: any;
+};

package/src/dtos/responses/notification-dtos.ts

@@ -0,0 +1,23 @@
+// Notification DTO
+export interface NotificationDTO {
+  id: string;
+  userId: string;
+  type: string; // NOTIFICATION_TYPE
+  title: string;
+  message: string;
+  data?: any;
+  isRead: boolean;
+  createdAt: Date;
+  readAt?: Date;
+  expiresAt?: Date;
+}
+
+// Create Notification DTO
+export interface CreateNotificationDTO {
+  userId: string;
+  type: string; // NOTIFICATION_TYPE
+  title: string;
+  message: string;
+  data?: any;
+  expiresAt?: Date;
+}

package/src/dtos/responses/player-dtos.ts

@@ -0,0 +1,93 @@
+// Player DTO
+export type PlayerDTO = {
+  id: string;
+  name: string;
+  position: string;
+  age: number;
+  overall: number;
+  potential: number;
+  nationality: string;
+  preferredFoot: string;
+  imgUrl?: string;
+  height?: number;
+  weight?: number;
+  workRate?: string;
+  speciality?: string;
+  weakFoot?: number;
+  skillMoves?: number;
+  email?: string;
+  gamertag?: string;
+  phone?: string;
+  seasonStats?: any;
+  careerStats?: any;
+  playablePositions?: string[];
+  team?: any;
+  stats?: any;
+  [key: string]: any;
+};
+
+// Player DTO with Transfer History
+export type PlayerDTOWithTransferHistory = PlayerDTO & {
+  transferHistory?: any[];
+  playablePositions?: string[];
+  [key: string]: any;
+};
+
+// Create Player Request DTO
+export type CreatePlayerDataRequest = {
+  email: string;
+  name: string;
+  position: string;
+  age: number;
+  overall: number;
+  potential: number;
+  nationality: string;
+  preferredFoot: string;
+  imgUrl?: string;
+  height?: number;
+  weight?: number;
+  workRate?: string;
+  speciality?: string;
+  weakFoot?: number;
+  skillMoves?: number;
+  playablePositions?: string[];
+  [key: string]: any;
+};
+
+// Update Player Data DTO
+export type UpdatePlayerDataRequest = {
+  overall?: number;
+  potential?: number;
+  age?: number;
+  position?: string;
+  imgUrl?: string;
+  playablePositions?: string[];
+  [key: string]: any;
+};
+
+// Player Stats DTO
+export type PlayerStatsDTO = {
+  playerId: string;
+  seasonNumber: number;
+  games: number;
+  goals: number;
+  assists: number;
+  avgRating: number;
+  appearances: number;
+};
+
+// Player Last Games Form DTO
+export type PlayerLastGamesForm = {
+  playerId?: string;
+  lastGames?: Array<{
+    gameId: string;
+    rating: number;
+    goals: number;
+    assists: number;
+    date: Date;
+    totalGoals?: number;
+  }>;
+  totalGoals?: number;
+  totalAssists?: number;
+  [key: string]: any;
+};

package/src/dtos/responses/stats-dtos.ts

@@ -0,0 +1,87 @@
+// Advanced Player Stats DTO
+export type AdvancedPlayersStats = {
+  playerId: string;
+  playerName: string;
+  teamName: string;
+  teamId?: string;
+  position: string;
+  gamesPlayed: number;
+  totalGoals: number;
+  totalAssists: number;
+  avgRating: number;
+  totalAppearances: number;
+  playerOfTheMatchAwards: number;
+  topScorers?: TopScorer[];
+  [key: string]: any;
+};
+
+// Top Scorer DTO
+export type TopScorer = {
+  playerId: string;
+  playerName: string;
+  teamName: string;
+  teamId?: string;
+  position: string;
+  goals: number;
+  appearances?: number;
+  avgRating?: number;
+  games?: number;
+  goalsPerGame?: number;
+  playerImgUrl?: string;
+  [key: string]: any;
+};
+
+// Top Assister DTO
+export type TopAssister = {
+  playerId: string;
+  playerName: string;
+  teamName: string;
+  teamId?: string;
+  position: string;
+  assists: number;
+  appearances?: number;
+  avgRating?: number;
+  games?: number;
+  assistsPerGame?: number;
+  playerImgUrl?: string;
+  [key: string]: any;
+};
+
+// Top Avg Rating DTO
+export type TopAvgRating = {
+  playerId: string;
+  playerName: string;
+  teamName: string;
+  teamId?: string;
+  position: string;
+  avgRating: number;
+  appearances?: number;
+  goals?: number;
+  assists?: number;
+  games?: number;
+  [key: string]: any;
+};
+
+// Advanced Team Stats DTO
+export type AdvancedTeamStats = {
+  teamId: string;
+  teamName: string;
+  gamesPlayed: number;
+  wins: number;
+  losses: number;
+  draws: number;
+  goalsScored: number;
+  goalsConceded: number;
+  goalDifference: number;
+  points: number;
+  avgGoalsPerGame: number;
+  winPercentage: number;
+  longestUnbeatenStreak?: number;
+  [key: string]: any;
+};
+
+// Extended Advanced Team Stats (for internal use)
+export type ExtendedAdvancedTeamStats = AdvancedTeamStats & {
+  longestUnbeatenStreak?: number;
+  [key: string]: any;
+};

package/src/dtos/responses/team-dtos.ts

@@ -0,0 +1,30 @@
+// Team DTO
+export type TeamDTO = {
+  id: string;
+  name: string;
+  eaTeamId?: string;
+  clubsTeamName?: string;
+  imgUrl?: string;
+  league?: string;
+  seasonNumber?: number;
+  [key: string]: any;
+};
+
+// League Table Row DTO
+export type LeagueTableRow = {
+  teamId: string;
+  teamName: string;
+  teamImgUrl?: string;
+  imgUrl?: string;
+  position?: number;
+  gamesPlayed?: number;
+  wins?: number;
+  losses?: number;
+  draws?: number;
+  goalsScored?: number;
+  goalsConceded?: number;
+  goalDifference?: number;
+  points?: number;
+  divisionLabel?: string;
+  [key: string]: any;
+};