feat: define competition domain contracts

This commit is contained in:
dahyeon committed 2026-07-12 18:44:26 +00:00
1 parent f4ba3d524f
commit 05a83db886
13 files changed
+843

No files matched your search

+85
View File
@@ -0,0 +1,85 @@
import type {
CommandId,
CompetitionFactId,
CompetitionId,
GameId,
GameSlotId,
RiotMatchId,
SeriesId,
TeamId,
UserId,
} from "./ids.js";
import type { IsoDateTime } from "./series.js";
export type CompetitionFactActor =
| { type: "system" }
| { type: "user"; userId: UserId }
| { type: "migration"; migrationRunId: string };
interface CompetitionFactViewBase {
id: CompetitionFactId;
competitionId: CompetitionId;
revision: number;
ordinalWithinRevision: number;
commandId: CommandId;
schemaVersion: number;
actor: CompetitionFactActor;
occurredAt: IsoDateTime;
recordedAt: IsoDateTime;
causationId?: string;
}
export interface GameAcceptedFactView extends CompetitionFactViewBase {
type: "game-accepted";
gameId: GameId;
seriesId: SeriesId;
gameSlotId: GameSlotId;
ordinal: number;
evidence:
| { type: "riot"; riotMatchId: RiotMatchId; payloadHash: string }
| { type: "legacy"; legacyReference: string };
mapping: {
mappingVersion: number;
confidence: number;
blueTeamId: TeamId;
redTeamId: TeamId;
winnerTeamId: TeamId;
};
}
export interface GameVoidedFactView extends CompetitionFactViewBase {
type: "game-voided";
gameAcceptedFactId: CompetitionFactId;
reason: string;
}
export type SeriesAdjudicationDecision =
| { type: "walkover"; winnerTeamId: TeamId }
| { type: "forfeit"; winnerTeamId: TeamId }
| { type: "administrative"; winnerTeamId: TeamId }
| { type: "administrative-draw" };
export interface SeriesAdjudicatedFactView extends CompetitionFactViewBase {
type: "series-adjudicated";
seriesId: SeriesId;
decision: SeriesAdjudicationDecision;
reason: string;
}
export interface AdjudicationReversedFactView extends CompetitionFactViewBase {
type: "adjudication-reversed";
adjudicationFactId: CompetitionFactId;
reason: string;
}
export type CompetitionFactView =
| GameAcceptedFactView
| GameVoidedFactView
| SeriesAdjudicatedFactView
| AdjudicationReversedFactView;
export interface CompetitionFactsResponse {
facts: CompetitionFactView[];
nextCursor: string | null;
}