gridpilot.gg/core/racing/application/use-cases/ManageSeasonLifecycleUseCase.test.ts

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 { UseCaseOutputPort } from '@core/shared/application';
import type { ApplicationErrorCode } from '@core/shared/errors/ApplicationErrorCode';
import { Result } from '@core/shared/application/Result';

describe('ManageSeasonLifecycleUseCase', () => {
  let useCase: ManageSeasonLifecycleUseCase;
  let leagueRepository: {
    findById: Mock;
  };
  let seasonRepository: {
    findById: Mock;
    update: Mock;
  };
  let output: UseCaseOutputPort<ManageSeasonLifecycleResult> & {
    present: Mock;
  };
 
  beforeEach(() => {
    leagueRepository = {
      findById: vi.fn(),
    };
    seasonRepository = {
      findById: vi.fn(),
      update: vi.fn(),
    };
    output = {
      present: vi.fn(),
    } as unknown as UseCaseOutputPort<ManageSeasonLifecycleResult> & {
      present: Mock;
    };
    useCase = new ManageSeasonLifecycleUseCase(
      leagueRepository as unknown as ILeagueRepository,
      seasonRepository as unknown as ISeasonRepository,
      output,
    );
  });
 
  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();
    expect(output.present).toHaveBeenCalledTimes(1);
    const [firstCall] = output.present.mock.calls;
    const [firstArg] = firstCall as [ManageSeasonLifecycleResult];
    let presented = firstArg;
    expect(presented.season.status).toBe('active');
 
    (output.present as Mock).mockClear();
 
    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();
    expect(output.present).toHaveBeenCalledTimes(1);
    {
      const [[arg]] = output.present.mock.calls as [[ManageSeasonLifecycleResult]];
      presented = arg;
    }
    expect(presented.season.status).toBe('completed');
 
    (output.present as Mock).mockClear();
 
    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();
    expect(output.present).toHaveBeenCalledTimes(1);
    presented = output.present.mock.calls[0][0] as ManageSeasonLifecycleResult;
    expect(presented.season.status).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');
    expect(output.present).not.toHaveBeenCalled();
  });
 
  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' });
    expect(output.present).not.toHaveBeenCalled();
  });
 
  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',
    });
    expect(output.present).not.toHaveBeenCalled();
  });
});