@pickleball/expo-sdk 0.1.1

package/src/match/contracts.ts

@@ -0,0 +1,137 @@
+export type MatchFormat = "singles" | "doubles";
+export type MatchScoringMode = "rally" | "sideOut";
+export type MatchTeamId = "A" | "B";
+export type CourtSide = "left" | "right";
+export type MatchInputSource =
+  | "local"
+  | "remote"
+  | "voice"
+  | "ble"
+  | "system";
+
+export interface MatchPlayer {
+  readonly id: string;
+  readonly name: string;
+}
+
+export interface MatchTeam {
+  readonly id: MatchTeamId;
+  readonly name?: string;
+  /** Defaults to the first player in the roster. */
+  readonly initialServerId?: string;
+  readonly players: readonly MatchPlayer[];
+}
+
+export interface MatchCreateInput {
+  readonly id: string;
+  readonly format: MatchFormat;
+  readonly scoringMode: MatchScoringMode;
+  readonly targetScore?: number;
+  readonly initialServingTeam?: MatchTeamId;
+  readonly teams: Readonly<Record<MatchTeamId, MatchTeam>>;
+}
+
+export interface TeamScore {
+  readonly A: number;
+  readonly B: number;
+}
+
+export interface ServeState {
+  readonly teamId: MatchTeamId;
+  readonly playerId: string;
+  readonly serverNumber: 1 | 2;
+  readonly court: CourtSide;
+}
+
+export interface GameSnapshot {
+  readonly number: 1 | 2 | 3;
+  readonly score: TeamScore;
+  readonly startingServingTeam: MatchTeamId;
+  readonly winner: MatchTeamId | null;
+  readonly midGameSwitchCompleted: boolean;
+}
+
+export type PendingCourtSwitch =
+  | { readonly reason: "gameEnd"; readonly game: 1 | 2 }
+  | { readonly reason: "gameThreeMidpoint"; readonly game: 3 };
+
+export interface MatchSnapshot {
+  readonly id: string;
+  readonly format: MatchFormat;
+  readonly scoringMode: MatchScoringMode;
+  readonly targetScore: number;
+  readonly bestOf: 3;
+  readonly teams: Readonly<Record<MatchTeamId, MatchTeam>>;
+  readonly designatedServerByTeam: Readonly<Record<MatchTeamId, string>>;
+  readonly initialServingTeam: MatchTeamId;
+  readonly courtSides: Readonly<Record<CourtSide, MatchTeamId>>;
+  readonly playerCourts: Readonly<Record<string, CourtSide>>;
+  readonly games: readonly GameSnapshot[];
+  readonly currentGame: 1 | 2 | 3;
+  readonly gamesWon: TeamScore;
+  readonly serve: ServeState;
+  readonly pendingCourtSwitch: PendingCourtSwitch | null;
+  readonly status: "inProgress" | "completed" | "ended";
+  readonly winner: MatchTeamId | null;
+  readonly endReason: string | null;
+  readonly sequence: number;
+}
+
+export interface MatchCorrection {
+  readonly score?: Partial<TeamScore>;
+  readonly serve?: ServeState;
+  readonly playerCourts?: Readonly<Record<string, CourtSide>>;
+}
+
+interface MatchEventBase {
+  readonly schemaVersion: 1;
+  readonly id: string;
+  readonly sequence: number;
+  readonly source: MatchInputSource;
+}
+
+export interface MatchCreatedEvent extends MatchEventBase {
+  readonly type: "matchCreated";
+  readonly input: MatchCreateInput;
+  readonly snapshot: MatchSnapshot;
+}
+
+export interface RallyAwardedEvent extends MatchEventBase {
+  readonly type: "rallyAwarded";
+  readonly displaySide: CourtSide;
+  readonly winnerTeamId: MatchTeamId;
+}
+
+export interface CourtSwitchConfirmedEvent extends MatchEventBase {
+  readonly type: "courtSwitchConfirmed";
+  readonly pending: PendingCourtSwitch;
+}
+
+export interface MatchCorrectedEvent extends MatchEventBase {
+  readonly type: "matchCorrected";
+  readonly correction: MatchCorrection;
+}
+
+export interface MatchEndedEvent extends MatchEventBase {
+  readonly type: "matchEnded";
+  readonly reason: string;
+}
+
+export interface MatchEventUndoneEvent extends MatchEventBase {
+  readonly type: "matchEventUndone";
+  readonly targetEventId: string;
+  readonly restoredSnapshot: MatchSnapshot;
+}
+
+export type MatchEvent =
+  | MatchCreatedEvent
+  | RallyAwardedEvent
+  | CourtSwitchConfirmedEvent
+  | MatchCorrectedEvent
+  | MatchEndedEvent
+  | MatchEventUndoneEvent;
+
+export interface MatchCreation {
+  readonly snapshot: MatchSnapshot;
+  readonly events: readonly [MatchCreatedEvent];
+}