volleyballsimtypes 0.0.217 → 0.0.358

package/dist/cjs/src/service/match/match-set.js

@@ -1,55 +1,66 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MatchSet = void 0;
-const utils_1 = require("../utils");
-const match_team_1 = require("./match-team");
-class MatchSet {
-    constructor({ id, order, isTieBreak, homePlayerPosition, awayPlayerPosition, boxScores, rallies, homeScore, awayScore }) {
-        (0, utils_1.validateUUID)(id);
-        this.id = id;
-        this.order = order;
-        this._homeScore = homeScore;
-        this._awayScore = awayScore;
-        this.homePlayerPosition = homePlayerPosition;
-        this.awayPlayerPosition = awayPlayerPosition;
-        this.boxScores = boxScores;
-        this.rallies = rallies;
-        this.isTieBreak = isTieBreak;
-        this.scoreThreshold = isTieBreak ? 15 : 25;
-    }
-    get homeScore() {
-        return this._homeScore;
-    }
-    get awayScore() {
-        return this._awayScore;
-    }
-    increaseScore(team) {
-        if (team === match_team_1.MatchTeam.HOME)
-            this._homeScore++;
-        else if (team === match_team_1.MatchTeam.AWAY)
-            this._awayScore++;
-        else
-            throw new Error('UNKNOWN_TEAM');
-    }
-    addRally(rally) {
-        this.rallies.push(rally);
-    }
-    /**
-     * Has a team reached at least 25 points, and is the score difference between both teams at least 2?
-     * @returns boolean
-     */
-    isOver() {
-        return Math.abs(this.homeScore - this.awayScore) > 1 &&
-            (this.homeScore >= this.scoreThreshold || this.awayScore >= this.scoreThreshold);
-    }
-    /**
-     * Get the team that won the Set. Return undefined if set is not over.
-     * @returns CourtTeam
-     */
-    getWinner() {
-        if (!this.isOver())
-            throw new Error('UNFINISHED_SET');
-        return this.homeScore > this.awayScore ? match_team_1.MatchTeam.HOME : match_team_1.MatchTeam.AWAY;
-    }
-}
-exports.MatchSet = MatchSet;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MatchSet = void 0;
+const match_team_1 = require("./match-team");
+const match_set_z_1 = require("./schemas/match-set.z");
+class MatchSet {
+    static create(input) {
+        const result = match_set_z_1.MatchSetInputSchema.safeParse(input);
+        if (!result.success) {
+            throw new Error(`INVALID_MATCH_SET: ${result.error.message}. RECEIVED=${(() => { try {
+                return JSON.stringify(input);
+            }
+            catch {
+                return String(input);
+            } })()}`);
+        }
+        return new MatchSet(result.data);
+    }
+    constructor({ id, order, isTieBreak, homePlayerPosition, awayPlayerPosition, boxScores, rallies, homeScore, awayScore }) {
+        this.id = id;
+        this.order = order;
+        this._homeScore = homeScore;
+        this._awayScore = awayScore;
+        this.homePlayerPosition = homePlayerPosition;
+        this.awayPlayerPosition = awayPlayerPosition;
+        this.boxScores = boxScores;
+        this.rallies = rallies;
+        this.isTieBreak = isTieBreak;
+        this.scoreThreshold = isTieBreak ? 15 : 25;
+    }
+    get homeScore() {
+        return this._homeScore;
+    }
+    get awayScore() {
+        return this._awayScore;
+    }
+    increaseScore(team) {
+        if (team === match_team_1.MatchTeam.HOME)
+            this._homeScore++;
+        else if (team === match_team_1.MatchTeam.AWAY)
+            this._awayScore++;
+        else
+            throw new Error('UNKNOWN_TEAM');
+    }
+    addRally(rally) {
+        this.rallies.push(rally);
+    }
+    /**
+     * Has a team reached at least 25 points, and is the score difference between both teams at least 2?
+     * @returns boolean
+     */
+    isOver() {
+        return Math.abs(this.homeScore - this.awayScore) > 1 &&
+            (this.homeScore >= this.scoreThreshold || this.awayScore >= this.scoreThreshold);
+    }
+    /**
+     * Get the team that won the Set. Return undefined if set is not over.
+     * @returns CourtTeam
+     */
+    getWinner() {
+        if (!this.isOver())
+            throw new Error('UNFINISHED_SET');
+        return this.homeScore > this.awayScore ? match_team_1.MatchTeam.HOME : match_team_1.MatchTeam.AWAY;
+    }
+}
+exports.MatchSet = MatchSet;

package/dist/cjs/src/service/match/match-set.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/src/service/match/match-set.test.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const uuid_1 = require("uuid");
+const match_set_1 = require("./match-set");
+const match_team_1 = require("./match-team");
+// ─── helpers ─────────────────────────────────────────────────────────────────
+function makeSet(homeScore, awayScore, isTieBreak = false, order) {
+    return match_set_1.MatchSet.create({
+        id: (0, uuid_1.v4)(),
+        order: order ?? (isTieBreak ? 4 : 0),
+        isTieBreak,
+        homePlayerPosition: [],
+        awayPlayerPosition: [],
+        homeScore,
+        awayScore,
+        boxScores: [],
+        rallies: []
+    });
+}
+// ─── scoreThreshold ───────────────────────────────────────────────────────────
+(0, globals_1.describe)('MatchSet', () => {
+    (0, globals_1.describe)('scoreThreshold', () => {
+        (0, globals_1.it)('is 25 for a regular set', () => {
+            (0, globals_1.expect)(makeSet(0, 0).scoreThreshold).toBe(25);
+        });
+        (0, globals_1.it)('is 15 for a tie-break set', () => {
+            (0, globals_1.expect)(makeSet(0, 0, true).scoreThreshold).toBe(15);
+        });
+    });
+    // ─── isOver ──────────────────────────────────────────────────────────────────
+    (0, globals_1.describe)('isOver()', () => {
+        (0, globals_1.it)('returns false at 0-0', () => {
+            (0, globals_1.expect)(makeSet(0, 0).isOver()).toBe(false);
+        });
+        (0, globals_1.it)('returns false when home has 25 but lead is only 1 (25-24)', () => {
+            (0, globals_1.expect)(makeSet(25, 24).isOver()).toBe(false);
+        });
+        (0, globals_1.it)('returns false when away has 25 but lead is only 1 (24-25)', () => {
+            (0, globals_1.expect)(makeSet(24, 25).isOver()).toBe(false);
+        });
+        (0, globals_1.it)('returns true when home reaches 25 with a 2-point lead (25-23)', () => {
+            (0, globals_1.expect)(makeSet(25, 23).isOver()).toBe(true);
+        });
+        (0, globals_1.it)('returns true when away reaches 25 with a 2-point lead (23-25)', () => {
+            (0, globals_1.expect)(makeSet(23, 25).isOver()).toBe(true);
+        });
+        (0, globals_1.it)('returns true in overtime with 2-point lead (27-25)', () => {
+            (0, globals_1.expect)(makeSet(27, 25).isOver()).toBe(true);
+        });
+        (0, globals_1.it)('returns false in overtime deuce (26-25)', () => {
+            (0, globals_1.expect)(makeSet(26, 25).isOver()).toBe(false);
+        });
+        (0, globals_1.it)('returns false when neither team has reached 25 (20-18 via increaseScore)', () => {
+            // MatchSet.create() validates finished-set scores, so build mid-game state
+            // by starting at 0-0 and driving scores up with increaseScore().
+            const set = makeSet(0, 0);
+            for (let i = 0; i < 20; i++)
+                set.increaseScore(match_team_1.MatchTeam.HOME);
+            for (let i = 0; i < 18; i++)
+                set.increaseScore(match_team_1.MatchTeam.AWAY);
+            (0, globals_1.expect)(set.isOver()).toBe(false);
+        });
+        (0, globals_1.it)('returns false for tie-break at 0-0', () => {
+            (0, globals_1.expect)(makeSet(0, 0, true).isOver()).toBe(false);
+        });
+        (0, globals_1.it)('returns true for tie-break at 15-13 (2-point lead)', () => {
+            (0, globals_1.expect)(makeSet(15, 13, true).isOver()).toBe(true);
+        });
+        (0, globals_1.it)('returns false for tie-break at 15-14 (only 1 ahead)', () => {
+            (0, globals_1.expect)(makeSet(15, 14, true).isOver()).toBe(false);
+        });
+        (0, globals_1.it)('returns true for tie-break in overtime (17-15)', () => {
+            (0, globals_1.expect)(makeSet(17, 15, true).isOver()).toBe(true);
+        });
+    });
+    // ─── getWinner ────────────────────────────────────────────────────────────────
+    (0, globals_1.describe)('getWinner()', () => {
+        (0, globals_1.it)('throws UNFINISHED_SET when set is not over', () => {
+            (0, globals_1.expect)(() => makeSet(0, 0).getWinner()).toThrow('UNFINISHED_SET');
+        });
+        (0, globals_1.it)('throws UNFINISHED_SET when score is tied at threshold (25-25)', () => {
+            // 25-25: diff is 0, not > 1
+            (0, globals_1.expect)(() => makeSet(25, 25).getWinner()).toThrow('UNFINISHED_SET');
+        });
+        (0, globals_1.it)('returns HOME when home score is higher', () => {
+            (0, globals_1.expect)(makeSet(25, 20).getWinner()).toBe(match_team_1.MatchTeam.HOME);
+        });
+        (0, globals_1.it)('returns AWAY when away score is higher', () => {
+            (0, globals_1.expect)(makeSet(20, 25).getWinner()).toBe(match_team_1.MatchTeam.AWAY);
+        });
+        (0, globals_1.it)('returns HOME for a tie-break win (15-13)', () => {
+            (0, globals_1.expect)(makeSet(15, 13, true).getWinner()).toBe(match_team_1.MatchTeam.HOME);
+        });
+    });
+    // ─── increaseScore ────────────────────────────────────────────────────────────
+    (0, globals_1.describe)('increaseScore()', () => {
+        (0, globals_1.it)('increments home score by 1', () => {
+            const set = makeSet(0, 0);
+            set.increaseScore(match_team_1.MatchTeam.HOME);
+            (0, globals_1.expect)(set.homeScore).toBe(1);
+            (0, globals_1.expect)(set.awayScore).toBe(0);
+        });
+        (0, globals_1.it)('increments away score by 1', () => {
+            const set = makeSet(0, 0);
+            set.increaseScore(match_team_1.MatchTeam.AWAY);
+            (0, globals_1.expect)(set.awayScore).toBe(1);
+            (0, globals_1.expect)(set.homeScore).toBe(0);
+        });
+        (0, globals_1.it)('can be called multiple times', () => {
+            const set = makeSet(0, 0);
+            set.increaseScore(match_team_1.MatchTeam.HOME);
+            set.increaseScore(match_team_1.MatchTeam.HOME);
+            set.increaseScore(match_team_1.MatchTeam.AWAY);
+            (0, globals_1.expect)(set.homeScore).toBe(2);
+            (0, globals_1.expect)(set.awayScore).toBe(1);
+        });
+        (0, globals_1.it)('throws UNKNOWN_TEAM for an invalid team value', () => {
+            const set = makeSet(0, 0);
+            (0, globals_1.expect)(() => set.increaseScore('INVALID')).toThrow('UNKNOWN_TEAM');
+        });
+    });
+});

package/dist/cjs/src/service/match/match-team.d.ts

@@ -1,7 +1,7 @@
-export declare enum MatchTeam {
-    HOME = "homeTeam",
-    AWAY = "awayTeam"
-}
-export declare namespace MatchTeam {
-    function otherTeam(team: MatchTeam): MatchTeam;
-}
+export declare enum MatchTeam {
+    HOME = "homeTeam",
+    AWAY = "awayTeam"
+}
+export declare namespace MatchTeam {
+    function otherTeam(team: MatchTeam): MatchTeam;
+}

package/dist/cjs/src/service/match/match-team.js

@@ -1,20 +1,20 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MatchTeam = void 0;
-var MatchTeam;
-(function (MatchTeam) {
-    MatchTeam["HOME"] = "homeTeam";
-    MatchTeam["AWAY"] = "awayTeam";
-})(MatchTeam = exports.MatchTeam || (exports.MatchTeam = {}));
-// eslint-disable-next-line @typescript-eslint/no-namespace
-(function (MatchTeam) {
-    function otherTeam(team) {
-        if (team === MatchTeam.HOME)
-            return MatchTeam.AWAY;
-        else if (team === MatchTeam.AWAY)
-            return MatchTeam.HOME;
-        else
-            throw new Error('UNKNOWN_MATCH_TEAM');
-    }
-    MatchTeam.otherTeam = otherTeam;
-})(MatchTeam = exports.MatchTeam || (exports.MatchTeam = {}));
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MatchTeam = void 0;
+var MatchTeam;
+(function (MatchTeam) {
+    MatchTeam["HOME"] = "homeTeam";
+    MatchTeam["AWAY"] = "awayTeam";
+})(MatchTeam || (exports.MatchTeam = MatchTeam = {}));
+// eslint-disable-next-line @typescript-eslint/no-namespace
+(function (MatchTeam) {
+    function otherTeam(team) {
+        if (team === MatchTeam.HOME)
+            return MatchTeam.AWAY;
+        else if (team === MatchTeam.AWAY)
+            return MatchTeam.HOME;
+        else
+            throw new Error('UNKNOWN_MATCH_TEAM');
+    }
+    MatchTeam.otherTeam = otherTeam;
+})(MatchTeam || (exports.MatchTeam = MatchTeam = {}));

package/dist/cjs/src/service/match/match.d.ts

@@ -1,38 +1,26 @@
-import { MatchSet } from './match-set';
-import { Team } from '../team';
-import { MatchTeam } from './match-team';
-import { StatusEnum } from '../../data';
-import { VPER } from './vper';
-interface MatchParams {
-    readonly id: string;
-    readonly homeTeam: Team;
-    readonly awayTeam: Team;
-    readonly scheduledDate: Date;
-    readonly sets: MatchSet[];
-    readonly status: StatusEnum;
-    readonly VPERs: VPER[];
-    homeScore?: number;
-    awayScore?: number;
-    winner?: Team;
-}
-export type MatchScore = '3-0' | '3-1' | '3-2' | '2-3' | '1-3' | '0-3';
-export type SetScore = 0 | 1 | 2 | 3;
-export declare class Match {
-    readonly id: string;
-    readonly homeTeam: Team;
-    readonly awayTeam: Team;
-    readonly sets: MatchSet[];
-    readonly scheduledDate: Date;
-    readonly VPERs: VPER[];
-    homeScore?: number;
-    awayScore?: number;
-    winner?: Team;
-    status: StatusEnum;
-    constructor({ id, homeTeam, awayTeam, scheduledDate, sets, status, homeScore, awayScore, winner, VPERs }: MatchParams);
-    addSet(set: MatchSet): void;
-    getTeamSets(team: MatchTeam): SetScore;
-    getScore(): MatchScore;
-    isOver(): boolean;
-    getWinner(): Team;
-}
-export {};
+import { MatchSet } from './match-set';
+import { Team } from '../team';
+import { MatchTeam } from './match-team';
+import { StatusEnum } from '../../data';
+import { VPER } from './vper';
+export type MatchScore = '3-0' | '3-1' | '3-2' | '2-3' | '1-3' | '0-3';
+export type SetScore = 0 | 1 | 2 | 3;
+export declare class Match {
+    readonly id: string;
+    readonly homeTeam: Team;
+    readonly awayTeam: Team;
+    readonly sets: MatchSet[];
+    readonly scheduledDate: Date;
+    readonly VPERs: VPER[];
+    status: StatusEnum;
+    homeScore?: number;
+    awayScore?: number;
+    winner?: Team;
+    static create(input: unknown): Match;
+    private constructor();
+    addSet(set: MatchSet): void;
+    getTeamSets(team: MatchTeam): SetScore;
+    getScore(): MatchScore;
+    isOver(): boolean;
+    getWinner(): Team;
+}

package/dist/cjs/src/service/match/match.js

@@ -1,52 +1,65 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Match = void 0;
-const utils_1 = require("../utils");
-const match_team_1 = require("./match-team");
-const data_1 = require("../../data");
-class Match {
-    constructor({ id, homeTeam, awayTeam, scheduledDate, sets, status, homeScore, awayScore, winner, VPERs }) {
-        (0, utils_1.validateUUID)(id);
-        this.id = id;
-        this.homeTeam = homeTeam;
-        this.awayTeam = awayTeam;
-        this.scheduledDate = scheduledDate;
-        this.sets = sets;
-        this.status = status;
-        this.homeScore = homeScore;
-        this.awayScore = awayScore;
-        this.winner = winner;
-        this.VPERs = VPERs;
-    }
-    addSet(set) {
-        if (this.sets.length >= 5)
-            throw new Error('SET_AMOUNT_EXCEEDED');
-        this.sets.push(set);
-    }
-    getTeamSets(team) {
-        const sets = this.sets.reduce((sets, set) => sets + (!set.isOver() ? 0 : set.getWinner() === team ? 1 : 0), 0);
-        if (sets > 3 || sets < 0)
-            throw new Error(`INCORRECT_SET_VALUE: ${sets}`);
-        return sets;
-    }
-    getScore() {
-        return `${this.getTeamSets(match_team_1.MatchTeam.HOME)}-${this.getTeamSets(match_team_1.MatchTeam.AWAY)}`;
-    }
-    isOver() {
-        if (this.status === data_1.StatusEnum.COMPLETE)
-            return true;
-        const setsToWin = 3;
-        const homeSets = this.getTeamSets(match_team_1.MatchTeam.HOME);
-        const awaySets = this.getTeamSets(match_team_1.MatchTeam.AWAY);
-        return !(homeSets < setsToWin && awaySets < setsToWin);
-    }
-    getWinner() {
-        if (!this.isOver()) {
-            throw new Error(`UNFINISHED_MATCH: ${this.id}, homeSets=[${this.sets.map(s => s.homeScore).join(', ')}], awaySets=[${this.sets.map(s => s.awayScore).join(', ')}], status=${this.status}`);
-        }
-        const homeSets = this.getTeamSets(match_team_1.MatchTeam.HOME);
-        const awaySets = this.getTeamSets(match_team_1.MatchTeam.AWAY);
-        return homeSets > awaySets ? this.homeTeam : this.awayTeam;
-    }
-}
-exports.Match = Match;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Match = void 0;
+const match_team_1 = require("./match-team");
+const data_1 = require("../../data");
+const match_z_1 = require("./schemas/match.z");
+class Match {
+    static create(input) {
+        const result = match_z_1.MatchInputSchema.safeParse(input);
+        if (!result.success) {
+            throw new Error(`INVALID_MATCH: ${result.error.message}. RECEIVED=${(() => { try {
+                return JSON.stringify(input);
+            }
+            catch {
+                return String(input);
+            } })()}`);
+        }
+        return new Match(result.data);
+    }
+    constructor({ id, homeTeam, awayTeam, scheduledDate, sets, status, homeScore, awayScore, winner, VPERs }) {
+        if (homeTeam.id === awayTeam.id)
+            throw new Error(`FAILED_TO_CREATE_MATCH. TEAMS_WITH_SAME_ID: ${homeTeam.id}`);
+        this.id = id;
+        this.homeTeam = homeTeam;
+        this.awayTeam = awayTeam;
+        this.scheduledDate = scheduledDate;
+        this.sets = sets ?? [];
+        this.status = status;
+        this.homeScore = homeScore;
+        this.awayScore = awayScore;
+        this.winner = winner;
+        this.VPERs = VPERs ?? [];
+    }
+    addSet(set) {
+        if (this.sets.length >= 5)
+            throw new Error('SET_AMOUNT_EXCEEDED');
+        this.sets.push(set);
+    }
+    getTeamSets(team) {
+        const sets = this.sets.reduce((sets, set) => sets + (!set.isOver() ? 0 : set.getWinner() === team ? 1 : 0), 0);
+        if (sets > 3 || sets < 0)
+            throw new Error(`INCORRECT_SET_VALUE: ${sets}`);
+        return sets;
+    }
+    getScore() {
+        return `${this.getTeamSets(match_team_1.MatchTeam.HOME)}-${this.getTeamSets(match_team_1.MatchTeam.AWAY)}`;
+    }
+    isOver() {
+        if (this.status === data_1.StatusEnum.COMPLETE)
+            return true;
+        const setsToWin = 3;
+        const homeSets = this.getTeamSets(match_team_1.MatchTeam.HOME);
+        const awaySets = this.getTeamSets(match_team_1.MatchTeam.AWAY);
+        return !(homeSets < setsToWin && awaySets < setsToWin);
+    }
+    getWinner() {
+        if (!this.isOver()) {
+            throw new Error(`UNFINISHED_MATCH: ${this.id}, homeSets=[${this.sets.map(s => s.homeScore).join(', ')}], awaySets=[${this.sets.map(s => s.awayScore).join(', ')}], status=${this.status}`);
+        }
+        const homeSets = this.getTeamSets(match_team_1.MatchTeam.HOME);
+        const awaySets = this.getTeamSets(match_team_1.MatchTeam.AWAY);
+        return homeSets > awaySets ? this.homeTeam : this.awayTeam;
+    }
+}
+exports.Match = Match;

package/dist/cjs/src/service/match/rally.d.ts

@@ -1,21 +1,15 @@
-import { CourtPosition } from './court-position';
-import { RallyEvent } from '../event';
-interface RallyParams {
-    readonly id: string;
-    readonly order: number;
-    readonly servingTeamId: string;
-    readonly events: RallyEvent[];
-}
-export interface PlayerPosition {
-    position: CourtPosition;
-    playerId: string;
-}
-export declare class Rally {
-    readonly id: string;
-    readonly servingTeamId: string;
-    readonly events: RallyEvent[];
-    readonly order: number;
-    constructor({ id, order, servingTeamId, events }: RallyParams);
-    addEvent(event: RallyEvent): void;
-}
-export {};
+import { CourtPosition } from './court-position';
+import { RallyEvent } from '../event';
+export interface PlayerPosition {
+    position: CourtPosition;
+    playerId: string;
+}
+export declare class Rally {
+    readonly id: string;
+    readonly servingTeamId: string;
+    readonly events: RallyEvent[];
+    readonly order: number;
+    static create(input: unknown): Rally;
+    private constructor();
+    addEvent(event: RallyEvent): void;
+}

package/dist/cjs/src/service/match/rally.js

@@ -1,17 +1,28 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Rally = void 0;
-const utils_1 = require("../utils");
-class Rally {
-    constructor({ id, order, servingTeamId, events }) {
-        (0, utils_1.validateUUID)(id);
-        this.id = id;
-        this.order = order;
-        this.servingTeamId = servingTeamId;
-        this.events = events;
-    }
-    addEvent(event) {
-        this.events.push(event);
-    }
-}
-exports.Rally = Rally;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Rally = void 0;
+const rally_z_1 = require("./schemas/rally.z");
+class Rally {
+    static create(input) {
+        const result = rally_z_1.RallyInputSchema.safeParse(input);
+        if (!result.success) {
+            throw new Error(`INVALID_RALLY: ${result.error.message}. RECEIVED=${(() => { try {
+                return JSON.stringify(input);
+            }
+            catch {
+                return String(input);
+            } })()}`);
+        }
+        return new Rally(result.data);
+    }
+    constructor({ id, order, servingTeamId, events }) {
+        this.id = id;
+        this.order = order;
+        this.servingTeamId = servingTeamId;
+        this.events = events;
+    }
+    addEvent(event) {
+        this.events.push(event);
+    }
+}
+exports.Rally = Rally;