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

import { describe, it, expect, beforeEach, vi, type Mock } from 'vitest';
import {
  ManageSeasonLifecycleUseCase,
  type ManageSeasonLifecycleInput,
  type ManageSeasonLifecycleErrorCode,
} from './ManageSeasonLifecycleUseCase';
import type { SeasonRepository } from '../../domain/repositories/SeasonRepository';
import type { LeagueRepository } from '../../domain/repositories/LeagueRepository';
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 LeagueRepository,
      seasonRepository as unknown as SeasonRepository);
  });

  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);
    let presented = activated.unwrap();
    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);
    presented = completed.unwrap();
    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);
    presented = archived.unwrap();
    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',
    });
  });
});