pro-clubs-shared-dtos 3.0.0 → 3.1.0

package/src/service-interfaces/comment/comment.interface.ts

@@ -0,0 +1,9 @@
+export interface ICommentService {
+  createComment(gameId: string, userId: string, content: string, parentCommentId?: string): Promise<any>;
+  updateComment(commentId: string, userId: string, content: string): Promise<any>;
+  deleteComment(commentId: string, userId: string): Promise<void>;
+  getCommentsByGame(gameId: string, userId?: string, page?: number, limit?: number): Promise<any>;
+  likeComment(commentId: string, userId: string): Promise<any>;
+  unlikeComment(commentId: string, userId: string): Promise<any>;
+  getUserComments(userId: string, limit?: number): Promise<any[]>;
+}

package/src/service-interfaces/comment/index.ts

@@ -0,0 +1 @@
+export * from './comment.interface';

package/src/service-interfaces/game/game-controller.interface.ts

@@ -0,0 +1,10 @@
+export interface IGameController {
+  createGame(req: any, res: any): Promise<void>;
+  getGameById(req: any, res: any): Promise<void>;
+  getAllGames(req: any, res: any): Promise<void>;
+  updateGameResult(req: any, res: any): Promise<void>;
+  updateGameDate(req: any, res: any): Promise<void>;
+  deleteGame(req: any, res: any): Promise<void>;
+  updateGameBroadcast(req: any, res: any): Promise<void>;
+  updateTeamPlayersPerformance(req: any, res: any): Promise<void>;
+}

package/src/service-interfaces/game/game-repository.interface.ts

@@ -0,0 +1,8 @@
+export interface IGameRepository {
+  create(gameData: any): Promise<any>;
+  findById(id: string): Promise<any | null>;
+  findByIds(ids: string[]): Promise<any[]>;
+  findAll(): Promise<any[]>;
+  update(id: string, updateData: any): Promise<any | null>;
+  delete(id: string): Promise<boolean>;
+}

package/src/service-interfaces/game/game.interface.ts

@@ -0,0 +1,43 @@
+// Extended interface to support BOT players
+export interface UpdatePlayerPerformanceDataRequestExtended {
+  playerId: string;
+  position: string;
+  goals?: number;
+  assists?: number;
+  rating?: number;
+  isBot?: boolean;
+}
+
+export interface TopAvgRatingByPosition {
+  position: string;
+  avgRating: number;
+  playerName?: string;
+  playerId?: string;
+}
+
+export interface IGameService {
+  getGameById(id: string, session?: any): Promise<any>;
+  getGamesByIds(gamesIds: string[]): Promise<any[]>;
+  getAllGames(): Promise<any[]>;
+
+  getTopAvgRatingByPosition(position: string, minimumGames?: number, session?: any): Promise<TopAvgRatingByPosition[]>;
+
+  getCurrentSeasonTeamGames(teamId: string, limit?: number, session?: any): Promise<any[]>;
+  getTeamVsTeamHistory(team1Id: string, team2Id: string, limit?: number, session?: any): Promise<any[]>;
+
+  createGame(fixtureId: string, leagueId: string, seasonNumber: number, gameData: any, session: any): Promise<any>;
+  createFixtureGames(fixtureId: string, leagueId: string, seasonNumber: number, gamesData: any[], session: any): Promise<any[]>;
+
+  updateGameResult(gameId: string, homeTeamGoals: number, awayTeamGoals: number, isPlayoffGame: boolean, penalties?: { homeTeamPenalties: number; awayTeamPenalties: number }): Promise<void>;
+  resetGameResult(gameId: string): Promise<void>;
+  setTechnicalResult(gameId: string, losingTeamId: string, reason: string, date: Date, isPlayoffGame?: boolean): Promise<void>;
+  updateGameDate(gameId: string, date: Date): Promise<void>;
+  updateGameBroadcast(gameId: string, streamUrl: string, broadcastingTeam: string): Promise<void>;
+  updateAiAnalysisImage(gameId: string, imageUrl: string): Promise<void>;
+  replaceTeamInGame(gameId: string, oldTeamId: string, newTeamId: string): Promise<void>;
+
+  updateTeamPlayersPerformance(gameId: string, isHomeTeam: boolean, playersPerformance: UpdatePlayerPerformanceDataRequestExtended[], imageUrl?: string): Promise<void>;
+  uploadLineup(gameId: string, isHomeTeam: boolean, lineupData: any[]): Promise<void>;
+
+  deleteGame(id: string): Promise<void>;
+}

package/src/service-interfaces/game/index.ts

@@ -0,0 +1,3 @@
+export * from './game.interface';
+export * from './game-controller.interface';
+export * from './game-repository.interface';

package/src/service-interfaces/index.ts

@@ -0,0 +1,9 @@
+// Export all service interfaces
+export * from './user/index';
+export * from './game/index';
+export * from './team/index';
+export * from './prediction/index';
+export * from './comment/index';
+export * from './transfer-request.interface';
+export * from './notification.interface';
+export * from './wrapper-services/index';

package/src/service-interfaces/notification.interface.ts

@@ -0,0 +1,20 @@
+export interface CreateNotificationData {
+  userId: string;
+  type: 'transfer_request' | 'transfer_approved' | 'transfer_rejected' | 'transfer_cancelled' | 'player_association_request' | 'player_association_approved' | 'player_association_rejected' | 'system';
+  title: string;
+  message: string;
+  data?: any;
+  expiresAt?: Date;
+}
+
+export interface INotificationService {
+  createNotification(data: CreateNotificationData, session?: any): Promise<any>;
+  getNotificationsByUserId(userId: string, limit?: number, skip?: number): Promise<any[]>;
+  getUnreadNotificationsByUserId(userId: string): Promise<any[]>;
+  markAsRead(notificationId: string, session?: any): Promise<any | null>;
+  markAllAsRead(userId: string, session?: any): Promise<number>;
+  deleteNotification(notificationId: string, session?: any): Promise<boolean>;
+  deleteAllNotificationsByUserId(userId: string, session?: any): Promise<boolean>;
+  countUnreadByUserId(userId: string): Promise<number>;
+  cleanupExpiredNotifications(): Promise<number>;
+}

package/src/service-interfaces/prediction/index.ts

@@ -0,0 +1 @@
+export * from './prediction.interface';

package/src/service-interfaces/prediction/prediction.interface.ts

@@ -0,0 +1,7 @@
+export interface IPredictionService {
+  createOrUpdatePrediction(gameId: string, userId: string, predictedOutcome: any, confidence?: number): Promise<any>;
+  deletePrediction(predictionId: string, userId: string): Promise<void>;
+  getPredictionDistribution(gameId: string, userId?: string): Promise<any>;
+  getUserPredictions(userId: string, limit?: number): Promise<any[]>;
+  getPredictionById(predictionId: string): Promise<any>;
+}

package/src/service-interfaces/team/index.ts

@@ -0,0 +1 @@
+export * from './team.interface';

package/src/service-interfaces/team/team.interface.ts

@@ -0,0 +1,33 @@
+export interface ITeamService {
+  getTeamById(teamId: string): Promise<any>;
+  getTeams(limit?: number, skip?: number): Promise<any[]>;
+  createTeam(teamData: any): Promise<any>;
+  updateTeam(teamId: string, updateData: any): Promise<any>;
+  deleteTeam(teamId: string): Promise<boolean>;
+  getTeamByName(teamName: string): Promise<any>;
+  getAllTeamsByLeague(leagueId: string): Promise<any[]>;
+  getTeamPlayers(teamId: string): Promise<any[]>;
+  addPlayerToTeam(teamId: string, playerId: string): Promise<any>;
+  removePlayerFromTeam(teamId: string, playerId: string): Promise<any>;
+  updateTeamCaptain(teamId: string, newCaptainId: string): Promise<any>;
+}
+
+export interface ITeamController {
+  createTeam(req: any, res: any): Promise<void>;
+  getTeamById(req: any, res: any): Promise<void>;
+  getAllTeams(req: any, res: any): Promise<void>;
+  updateTeam(req: any, res: any): Promise<void>;
+  deleteTeam(req: any, res: any): Promise<void>;
+  getTeamPlayers(req: any, res: any): Promise<void>;
+  addPlayer(req: any, res: any): Promise<void>;
+  removePlayer(req: any, res: any): Promise<void>;
+}
+
+export interface ITeamRepository {
+  create(teamData: any): Promise<any>;
+  findById(id: string): Promise<any | null>;
+  findByName(name: string): Promise<any | null>;
+  findAll(): Promise<any[]>;
+  update(id: string, updateData: any): Promise<any | null>;
+  delete(id: string): Promise<boolean>;
+}

package/src/service-interfaces/transfer-request.interface.ts

@@ -0,0 +1,34 @@
+export interface CreateTransferRequestData {
+  playerId: string;
+  fromTeamId?: string | null; // Optional for free agents
+  toTeamId: string;
+  message?: string;
+}
+
+export interface ProcessTransferRequestData {
+  requestId: string;
+  action: 'approve' | 'reject';
+  reason?: string;
+}
+
+export interface PaginatedTransferRequests {
+  data: any[];
+  page: number;
+  pageSize: number;
+  totalItems: number;
+  totalPages: number;
+  hasNextPage: boolean;
+  hasPreviousPage: boolean;
+}
+
+export interface ITransferRequestService {
+  createTransferRequest(requestedBy: string, data: CreateTransferRequestData): Promise<any>;
+  processTransferRequest(processedBy: string, data: ProcessTransferRequestData): Promise<any>;
+  getTransferRequestsByTeam(teamId: string, status?: string): Promise<any[]>;
+  getTransferRequestsByPlayer(playerId: string, status?: string): Promise<any[]>;
+  getAllTransferRequests(status?: string, leagueId?: string): Promise<any[]>;
+  getAllTransferRequestsPaginated(status: string | undefined, leagueId: string | undefined, page: number, pageSize: number): Promise<PaginatedTransferRequests>;
+  getTransferRequestById(requestId: string): Promise<any>;
+  cancelTransferRequest(requestId: string, userId: string): Promise<void>;
+  cleanupExpiredRequests(): Promise<number>;
+}

package/src/service-interfaces/user/index.ts

@@ -0,0 +1,3 @@
+export * from './user.interface';
+export * from './user-controller.interface';
+export * from './user-repository.interface';

package/src/service-interfaces/user/user-controller.interface.ts

@@ -0,0 +1,17 @@
+export interface IUserController {
+  createUser(req: any, res: any): Promise<void>;
+  loginUser(req: any, res: any): Promise<void>;
+  googleAuth(req: any, res: any): Promise<void>;
+  getUserById(req: any, res: any): Promise<void>;
+  updateUser(req: any, res: any): Promise<void>;
+  deleteUser(req: any, res: any): Promise<void>;
+  verifyEmail(req: any, res: any): Promise<void>;
+  associatePlayer(req: any, res: any): Promise<void>;
+  removePlayer(req: any, res: any): Promise<void>;
+  searchPlayers(req: any, res: any): Promise<void>;
+  getUserPlayers(req: any, res: any): Promise<void>;
+  createPlayer(req: any, res: any): Promise<void>;
+  requestPasswordReset(req: any, res: any): Promise<void>;
+  verifyResetCode(req: any, res: any): Promise<void>;
+  resetPassword(req: any, res: any): Promise<void>;
+}

package/src/service-interfaces/user/user-repository.interface.ts

@@ -0,0 +1,8 @@
+export interface IUserRepository {
+  create(userData: any): Promise<any>;
+  findById(id: string): Promise<any | null>;
+  findByEmail(email: string): Promise<any | null>;
+  update(id: string, updateData: any): Promise<any | null>;
+  delete(id: string): Promise<boolean>;
+  findAll(): Promise<any[]>;
+}

package/src/service-interfaces/user/user.interface.ts

@@ -0,0 +1,55 @@
+// User Request/Response DTOs (not service implementations, just contracts)
+
+export interface CreateUserRequest {
+  email: string;
+  password: string;
+  firstName: string;
+  lastName: string;
+}
+
+export interface LoginRequest {
+  email: string;
+  password: string;
+}
+
+export interface GoogleAuthRequest {
+  googleId: string;
+  email: string;
+  firstName: string;
+  lastName: string;
+  profilePicture?: string;
+}
+
+export interface UpdateUserRequest {
+  firstName?: string;
+  lastName?: string;
+  email?: string;
+  profileImage?: string;
+}
+
+export interface AuthResponse {
+  user: any; // IUser from models
+  token: string;
+}
+
+// Service interface - defines contract for user service implementation
+export interface IUserService {
+  createUser(userData: CreateUserRequest): Promise<AuthResponse>;
+  loginUser(loginData: LoginRequest): Promise<AuthResponse>;
+  googleAuth(googleData: GoogleAuthRequest): Promise<AuthResponse>;
+  getUserById(userId: string): Promise<any | null>;
+  getUserByEmail(email: string): Promise<any | null>;
+  updateUser(userId: string, updateData: Partial<any>): Promise<any | null>;
+  deleteUser(userId: string): Promise<boolean>;
+  associatePlayerWithUser(userId: string, playerId?: string, playerEmail?: string): Promise<any | null>;
+  removePlayerFromUser(userId: string, playerId: string): Promise<any | null>;
+  verifyEmail(userId: string): Promise<any | null>;
+  searchAvailablePlayers(search?: string, email?: string): Promise<any[]>;
+  getUserAssociatedPlayers(userId: string): Promise<any[]>;
+  checkPlayerOwnership(userId: string, playerId: string): Promise<boolean>;
+  isPlayerAssociated(playerId: string): Promise<boolean>;
+  createPlayerForUser(userId: string, playerData: any): Promise<any>;
+  requestPasswordReset(email: string): Promise<void>;
+  verifyResetCode(email: string, code: string): Promise<boolean>;
+  resetPassword(email: string, code: string, newPassword: string): Promise<AuthResponse>;
+}

package/src/service-interfaces/wrapper-services/index.ts

@@ -0,0 +1,57 @@
+// Wrapper Service Interfaces
+// These define contracts for high-level statistics and achievement services
+
+export interface ITeamStatsService {
+  getCurrentSeasonAdvancedTeamStats(teamId: string, session?: any): Promise<any | null>;
+  getCurrentSeasonTeamPlayersStats(teamId: string, limit?: number, session?: any): Promise<any>;
+  getTeamTopScorersAndAssists(teamId: string, limit?: number, session?: any): Promise<{ topScorers: any[]; topAssists: any[] }>;
+  getTeamTopContributors(teamId: string, limit?: number, session?: any): Promise<any[]>;
+}
+
+export interface IPlayerStatsService {
+  getCurrentSeasonAdvancedPlayerStats(playerId: string, session?: any): Promise<any | null>;
+  getPlayerCareerStats(playerId: string): Promise<any | null>;
+  getPlayerAchievements(playerId: string): Promise<any[]>;
+}
+
+export interface ITeamLeagueService {
+  getTeamLeaguePositions(teamId: string): Promise<any[]>;
+  getCurrentSeasonTeamPosition(teamId: string): Promise<any | null>;
+  getTeamHistoricalPositions(teamId: string): Promise<any[]>;
+}
+
+export interface IPlayerTeamService {
+  getPlayerCurrentTeam(playerId: string): Promise<any | null>;
+  getPlayerTeamHistory(playerId: string): Promise<any[]>;
+  getTeamPlayers(teamId: string): Promise<any[]>;
+}
+
+export interface ITeamOfTheWeekService {
+  getTeamOfTheWeek(leagueId: string, seasonNumber: number, weekNumber?: number): Promise<any>;
+  getAllTeamsOfTheWeek(leagueId: string, seasonNumber: number): Promise<any[]>;
+  createTeamOfTheWeek(leagueId: string, seasonNumber: number, weekNumber: number, players: string[]): Promise<any>;
+}
+
+export interface ITeamOfTheSeasonService {
+  getTeamOfTheSeason(leagueId: string, seasonNumber: number): Promise<any>;
+  createTeamOfTheSeason(leagueId: string, seasonNumber: number, formation: any, players: string[]): Promise<any>;
+}
+
+export interface ISeasonCompletionService {
+  getSeasonCompletionStatus(leagueId: string, seasonNumber: number): Promise<any>;
+  completeSeason(leagueId: string, seasonNumber: number, endDate?: Date): Promise<any>;
+}
+
+export interface ISeasonAchievementService {
+  getSeasonAchievements(leagueId: string, seasonNumber: number): Promise<any>;
+  getPlayerAchievementsInSeason(playerId: string, leagueId: string, seasonNumber: number): Promise<any>;
+  getTeamAchievementsInSeason(teamId: string, leagueId: string, seasonNumber: number): Promise<any>;
+  previewSeasonEnd(leagueId: string, seasonNumber: number): Promise<any>;
+  endSeason(leagueId: string, seasonNumber: number, endDate?: Date, forceEnd?: boolean): Promise<any>;
+}
+
+export interface ILeagueStatsService {
+  getCurrentSeasonTopScorers(leagueId: string, limit?: number): Promise<any[]>;
+  getCurrentSeasonTopAssists(leagueId: string, limit?: number): Promise<any[]>;
+  getLeagueStandings(leagueId: string, seasonNumber?: number): Promise<any>;
+}