import { describe, it, expect, beforeEach, vi, Mock } from 'vitest'; import { ManageSeasonLifecycleUseCase, type ManageSeasonLifecycleInput, type ManageSeasonLifecycleResult, type ManageSeasonLifecycleErrorCode, } from './ManageSeasonLifecycleUseCase'; import type { ISeasonRepository } from '../../domain/repositories/ISeasonRepository'; import type { ILeagueRepository } from '../../domain/repositories/ILeagueRepository'; import { Season } from '../../domain/entities/season/Season'; import type { ApplicationErrorCode } from '@core/shared/errors/ApplicationErrorCode'; describe('ManageSeasonLifecycleUseCase', () => { let useCase: ManageSeasonLifecycleUseCase; let leagueRepository: { findById: Mock; }; let seasonRepository: { findById: Mock; update: Mock; }; }; beforeEach(() => { leagueRepository = { findById: vi.fn(), }; seasonRepository = { findById: vi.fn(), update: vi.fn(), }; }; useCase = new ManageSeasonLifecycleUseCase(leagueRepository as unknown as ILeagueRepository, seasonRepository as unknown as ISeasonRepository); }); it('applies activate → complete → archive transitions and persists state', async () => { const league = { id: 'league-1' }; let currentSeason = Season.create({ id: 'season-1', leagueId: 'league-1', gameId: 'iracing', name: 'Lifecycle Season', status: 'planned', }); leagueRepository.findById.mockResolvedValue(league); seasonRepository.findById.mockImplementation(() => Promise.resolve(currentSeason)); seasonRepository.update.mockImplementation((s) => { currentSeason = s; return Promise.resolve(s); }); const activateInput: ManageSeasonLifecycleInput = { leagueId: 'league-1', seasonId: currentSeason.id, transition: 'activate', }; const activated = await useCase.execute(activateInput); expect(activated.isOk()).toBe(true); expect(activated.unwrap()).toBeUndefined(); const [firstCall] = const [firstArg] = firstCall as [ManageSeasonLifecycleResult]; let presented = firstArg; expect(presented.season.status.toString()).toBe('active'); (const completeInput: ManageSeasonLifecycleInput = { leagueId: 'league-1', seasonId: currentSeason.id, transition: 'complete', }; const completed = await useCase.execute(completeInput); expect(completed.isOk()).toBe(true); expect(completed.unwrap()).toBeUndefined(); { const [[arg]] = presented = arg; } expect(presented.season.status.toString()).toBe('completed'); (const archiveInput: ManageSeasonLifecycleInput = { leagueId: 'league-1', seasonId: currentSeason.id, transition: 'archive', }; const archived = await useCase.execute(archiveInput); expect(archived.isOk()).toBe(true); expect(archived.unwrap()).toBeUndefined(); { const presentedRaw = expect(presentedRaw).toBeDefined(); presented = presentedRaw as ManageSeasonLifecycleResult; } expect(presented.season.status.toString()).toBe('archived'); }); it('propagates domain invariant errors for invalid transitions', async () => { const league = { id: 'league-1' }; const season = Season.create({ id: 'season-1', leagueId: 'league-1', gameId: 'iracing', name: 'Lifecycle Season', status: 'planned', }); leagueRepository.findById.mockResolvedValue(league); seasonRepository.findById.mockResolvedValue(season); const completeInput: ManageSeasonLifecycleInput = { leagueId: 'league-1', seasonId: season.id, transition: 'complete', }; const result = await useCase.execute(completeInput); expect(result.isErr()).toBe(true); const error = result.unwrapErr() as ApplicationErrorCode< ManageSeasonLifecycleErrorCode, { message: string } >; expect(error.code).toEqual('INVALID_TRANSITION'); }); it('returns error when league not found', async () => { leagueRepository.findById.mockResolvedValue(null); const input: ManageSeasonLifecycleInput = { leagueId: 'league-1', seasonId: 'season-1', transition: 'activate', }; const result = await useCase.execute(input); expect(result.isErr()).toBe(true); const error = result.unwrapErr() as ApplicationErrorCode< ManageSeasonLifecycleErrorCode, { message: string } >; expect(error.code).toEqual('LEAGUE_NOT_FOUND'); expect(error.details).toEqual({ message: 'League not found: league-1' }); }); it('returns error when season not found', async () => { const league = { id: 'league-1' }; leagueRepository.findById.mockResolvedValue(league); seasonRepository.findById.mockResolvedValue(null); const input: ManageSeasonLifecycleInput = { leagueId: 'league-1', seasonId: 'season-1', transition: 'activate', }; const result = await useCase.execute(input); expect(result.isErr()).toBe(true); const error = result.unwrapErr() as ApplicationErrorCode< ManageSeasonLifecycleErrorCode, { message: string } >; expect(error.code).toEqual('SEASON_NOT_FOUND'); expect(error.details).toEqual({ message: 'Season season-1 does not belong to league league-1', }); }); });