volleyballsimtypes 0.0.356 → 0.0.358

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

@@ -0,0 +1,5 @@
+import { Team } from '../team';
+import { Match } from './match';
+export default class MatchGenerator {
+    static generateMatches(teams: Team[], baseDate: Date): Match[];
+}

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

@@ -0,0 +1,73 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const dayjs_1 = __importDefault(require("dayjs"));
+const uuid_1 = require("uuid");
+const match_1 = require("./match");
+const utils_1 = require("../utils");
+const data_1 = require("../../data");
+// eslint-disable-next-line @typescript-eslint/no-extraneous-class
+class MatchGenerator {
+    static generateMatches(teams, baseDate) {
+        const t = new Set(teams.map(x => x.id));
+        let date = (0, dayjs_1.default)(baseDate).startOf('hour');
+        if (t.size !== teams.length) {
+            throw new Error('DUPLICATE_TEAMS');
+        }
+        let shuffled = (0, utils_1.shuffle)([...teams]);
+        const l = shuffled.length - 1;
+        const half = Math.ceil(shuffled.length / 2);
+        const matches = [];
+        // We fix the first team
+        let firstTeam = shuffled.shift();
+        if (firstTeam == null) {
+            throw new Error('EMPTY_TEAM_ARRAY');
+        }
+        let homeRow;
+        let awayRow;
+        for (let i = 0; i < l; i++) {
+            // split array in 2 halves
+            const row1 = shuffled.slice(0, half);
+            const row2 = shuffled.slice(half);
+            row2.push(firstTeam);
+            if (i % 2 === 0) {
+                homeRow = row1;
+                awayRow = row2;
+            }
+            else {
+                homeRow = row2;
+                awayRow = row1;
+            }
+            for (let j = 0; j < half; j++) {
+                matches.push(match_1.Match.create({
+                    id: (0, uuid_1.v4)(),
+                    homeTeam: homeRow[j],
+                    awayTeam: awayRow[j],
+                    scheduledDate: date.toDate(),
+                    status: data_1.StatusEnum.PENDING
+                }));
+                date = date.add(30, 'minutes');
+            }
+            firstTeam = row2.pop();
+            row1.unshift(row2.shift());
+            row2.push(row1.pop());
+            shuffled = [...row1, ...row2];
+        }
+        // Generate Inverted matches for home-away pairings
+        matches.push(...matches.map(match => {
+            const scheduledDate = date.toDate();
+            date = date.add(30, 'minutes');
+            return match_1.Match.create({
+                id: (0, uuid_1.v4)(),
+                homeTeam: match.awayTeam,
+                awayTeam: match.homeTeam,
+                scheduledDate,
+                status: data_1.StatusEnum.PENDING
+            });
+        }));
+        return matches;
+    }
+}
+exports.default = MatchGenerator;

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

@@ -0,0 +1,34 @@
+import { Match, MatchTeam } from '.';
+import { MatchContext } from './schemas/match-rating.z';
+export type { MatchContext };
+interface SetScoreVariant {
+    '3-0': number;
+    '3-1': number;
+    '3-2': number;
+    '2-3': number;
+    '1-3': number;
+    '0-3': number;
+}
+export declare class MatchRating {
+    static readonly K: number;
+    static readonly C1: number;
+    static readonly C2: number;
+    static readonly C3: number;
+    static readonly C4: number;
+    static readonly C5: number;
+    static readonly SSV: SetScoreVariant;
+    static readonly LEAGUE_BASE: number;
+    static readonly TIER_PENALTY: number;
+    static readonly QUALIFIER_WEIGHT: number;
+    static readonly TOURNAMENT_WEIGHT: number;
+    readonly match: Match;
+    readonly weight: number;
+    static create(input: unknown): MatchRating;
+    private constructor();
+    private static leagueWeight;
+    private static applyBotPenalty;
+    private static computeWeight;
+    static calculateProbability(z: number): number;
+    getExpectedResult(): number;
+    getPoints(team: MatchTeam): number;
+}

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

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MatchRating = void 0;
+const _1 = require(".");
+const utils_1 = require("../utils");
+const match_rating_z_1 = require("./schemas/match-rating.z");
+class MatchRating {
+    static create(input) {
+        const result = match_rating_z_1.MatchRatingInputSchema.safeParse(input);
+        if (!result.success) {
+            throw new Error(`INVALID_MATCH_RATING: ${result.error.message}. RECEIVED=${(() => { try {
+                return JSON.stringify(input);
+            }
+            catch {
+                return String(input);
+            } })()}`);
+        }
+        return new MatchRating(result.data);
+    }
+    constructor({ match, context }) {
+        this.match = match;
+        this.weight = MatchRating.computeWeight(context);
+    }
+    static leagueWeight(tier) {
+        return Math.max(MatchRating.TIER_PENALTY, MatchRating.LEAGUE_BASE - MatchRating.TIER_PENALTY * tier);
+    }
+    static applyBotPenalty(weight, homeIsBot, awayIsBot) {
+        const bots = (homeIsBot ? 1 : 0) + (awayIsBot ? 1 : 0);
+        return weight * Math.pow(0.5, bots);
+    }
+    static computeWeight(context) {
+        switch (context.kind) {
+            case 'LEAGUE': {
+                const base = MatchRating.leagueWeight(context.tier);
+                return MatchRating.applyBotPenalty(base, context.homeIsBot, context.awayIsBot);
+            }
+            case 'PROMOTION': {
+                const base = (MatchRating.leagueWeight(context.upperTier) + MatchRating.leagueWeight(context.lowerTier)) / 2;
+                return MatchRating.applyBotPenalty(base, context.homeIsBot, context.awayIsBot);
+            }
+            case 'QUALIFIER':
+                return MatchRating.applyBotPenalty(MatchRating.QUALIFIER_WEIGHT, context.homeIsBot, context.awayIsBot);
+            case 'TOURNAMENT':
+                return MatchRating.applyBotPenalty(MatchRating.TOURNAMENT_WEIGHT, context.homeIsBot, context.awayIsBot);
+        }
+    }
+    static calculateProbability(z) {
+        return 0.5 * (1 + (0, utils_1.erf)(z / Math.SQRT2));
+    }
+    getExpectedResult() {
+        const D = MatchRating.K * (this.match.homeTeam.rating - this.match.awayTeam.rating) / 1000;
+        const P1 = MatchRating.calculateProbability(MatchRating.C1 + D);
+        const P2 = MatchRating.calculateProbability(MatchRating.C2 + D) - MatchRating.calculateProbability(MatchRating.C1 + D);
+        const P3 = MatchRating.calculateProbability(MatchRating.C3 + D) - MatchRating.calculateProbability(MatchRating.C2 + D);
+        const P4 = MatchRating.calculateProbability(MatchRating.C4 + D) - MatchRating.calculateProbability(MatchRating.C3 + D);
+        const P5 = MatchRating.calculateProbability(MatchRating.C5 + D) - MatchRating.calculateProbability(MatchRating.C4 + D);
+        const P6 = 1 - MatchRating.calculateProbability(MatchRating.C5 + D);
+        return P1 * MatchRating.SSV['3-0'] +
+            P2 * MatchRating.SSV['3-1'] +
+            P3 * MatchRating.SSV['3-2'] +
+            P4 * MatchRating.SSV['2-3'] +
+            P5 * MatchRating.SSV['1-3'] +
+            P6 * MatchRating.SSV['0-3'];
+    }
+    getPoints(team) {
+        const homeScoreKey = this.match.getScore();
+        const emr = this.getExpectedResult();
+        const ssv = MatchRating.SSV[homeScoreKey];
+        const homeDelta = (ssv - emr) * this.weight / MatchRating.K;
+        return team === _1.MatchTeam.HOME ? homeDelta : -homeDelta;
+    }
+}
+exports.MatchRating = MatchRating;
+// Standard scaling factor (FIVB spec)
+MatchRating.K = 8;
+// Cut-points for the normal distribution (symmetric, equal-strength baseline)
+MatchRating.C1 = -1.060;
+MatchRating.C2 = -0.394;
+MatchRating.C3 = 0;
+MatchRating.C4 = 0.394;
+MatchRating.C5 = 1.060;
+MatchRating.SSV = {
+    '3-0': 2,
+    '3-1': 1.5,
+    '3-2': 1,
+    '2-3': -1,
+    '1-3': -1.5,
+    '0-3': -2
+};
+// League weight = LEAGUE_BASE - TIER_PENALTY * tier
+// Tier 1 → 35, Tier 2 → 30, Tier 3 → 25, Tier 4 → 20, ...
+MatchRating.LEAGUE_BASE = 40;
+MatchRating.TIER_PENALTY = 5;
+// Regional qualifier — higher prestige than any league tier
+MatchRating.QUALIFIER_WEIGHT = 45;
+// WCC tournament — top of the hierarchy
+MatchRating.TOURNAMENT_WEIGHT = 55;

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

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

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

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const match_rating_1 = require("./match-rating");
+const match_team_1 = require("./match-team");
+const test_helpers_1 = require("../test-helpers");
+const number_utils_1 = require("../utils/number-utils");
+// ─── MatchRating.calculateProbability (static normal CDF) ───────────────────
+(0, globals_1.describe)('MatchRating.calculateProbability()', () => {
+    (0, globals_1.it)('returns 0.5 at z = 0 (symmetric distribution)', () => {
+        (0, globals_1.expect)(match_rating_1.MatchRating.calculateProbability(0)).toBeCloseTo(0.5, 5);
+    });
+    (0, globals_1.it)('is monotone: P(z1) < P(z2) when z1 < z2', () => {
+        (0, globals_1.expect)(match_rating_1.MatchRating.calculateProbability(-1))
+            .toBeLessThan(match_rating_1.MatchRating.calculateProbability(0));
+        (0, globals_1.expect)(match_rating_1.MatchRating.calculateProbability(0))
+            .toBeLessThan(match_rating_1.MatchRating.calculateProbability(1));
+    });
+    (0, globals_1.it)('approaches 1 for large positive z', () => {
+        (0, globals_1.expect)(match_rating_1.MatchRating.calculateProbability(10)).toBeCloseTo(1, 5);
+    });
+    (0, globals_1.it)('approaches 0 for large negative z', () => {
+        (0, globals_1.expect)(match_rating_1.MatchRating.calculateProbability(-10)).toBeCloseTo(0, 5);
+    });
+    (0, globals_1.it)('matches the formula 0.5 * (1 + erf(z / sqrt(2)))', () => {
+        for (const z of [-2, -1, 0, 1, 2]) {
+            (0, globals_1.expect)(match_rating_1.MatchRating.calculateProbability(z))
+                .toBeCloseTo(0.5 * (1 + (0, number_utils_1.erf)(z / Math.SQRT2)), 8);
+        }
+    });
+});
+// ─── weight computation ───────────────────────────────────────────────────────
+(0, globals_1.describe)('MatchRating weight computation', () => {
+    function makeRating(context) {
+        const home = (0, test_helpers_1.makeTeam)();
+        const away = (0, test_helpers_1.makeTeam)();
+        const match = (0, test_helpers_1.makeMatch30)(home, away);
+        return match_rating_1.MatchRating.create({ match, context });
+    }
+    (0, globals_1.it)('LEAGUE tier 1 → weight = LEAGUE_BASE - TIER_PENALTY * 1 = 35', () => {
+        const mr = makeRating({ kind: 'LEAGUE', tier: 1, homeIsBot: false, awayIsBot: false });
+        (0, globals_1.expect)(mr.weight).toBe(35);
+    });
+    (0, globals_1.it)('LEAGUE tier 7 → weight is floored at TIER_PENALTY (5)', () => {
+        // 40 - 5*7 = 5 (minimum is TIER_PENALTY itself)
+        const mr = makeRating({ kind: 'LEAGUE', tier: 7, homeIsBot: false, awayIsBot: false });
+        (0, globals_1.expect)(mr.weight).toBe(5);
+    });
+    (0, globals_1.it)('QUALIFIER → weight = QUALIFIER_WEIGHT (45)', () => {
+        const mr = makeRating({ kind: 'QUALIFIER', homeIsBot: false, awayIsBot: false });
+        (0, globals_1.expect)(mr.weight).toBe(45);
+    });
+    (0, globals_1.it)('TOURNAMENT → weight = TOURNAMENT_WEIGHT (55)', () => {
+        const mr = makeRating({ kind: 'TOURNAMENT', homeIsBot: false, awayIsBot: false });
+        (0, globals_1.expect)(mr.weight).toBe(55);
+    });
+    (0, globals_1.it)('each bot halves the weight', () => {
+        const noBots = makeRating({ kind: 'QUALIFIER', homeIsBot: false, awayIsBot: false });
+        const oneBot = makeRating({ kind: 'QUALIFIER', homeIsBot: true, awayIsBot: false });
+        const twoBots = makeRating({ kind: 'QUALIFIER', homeIsBot: true, awayIsBot: true });
+        (0, globals_1.expect)(oneBot.weight).toBeCloseTo(noBots.weight * 0.5, 10);
+        (0, globals_1.expect)(twoBots.weight).toBeCloseTo(noBots.weight * 0.25, 10);
+    });
+    (0, globals_1.it)('PROMOTION weight is the average of the two league tier weights', () => {
+        // upperTier=1 (35), lowerTier=2 (30) → avg = 32.5
+        const mr = makeRating({ kind: 'PROMOTION', upperTier: 1, lowerTier: 2, homeIsBot: false, awayIsBot: false });
+        (0, globals_1.expect)(mr.weight).toBeCloseTo(32.5, 5);
+    });
+});
+// ─── getExpectedResult ────────────────────────────────────────────────────────
+(0, globals_1.describe)('MatchRating.getExpectedResult()', () => {
+    function makeRatingForTeams(homeRating, awayRating) {
+        const home = (0, test_helpers_1.makeTeam)({ rating: homeRating });
+        const away = (0, test_helpers_1.makeTeam)({ rating: awayRating });
+        const match = (0, test_helpers_1.makeMatch30)(home, away);
+        return match_rating_1.MatchRating.create({ match, context: { kind: 'LEAGUE', tier: 1, homeIsBot: false, awayIsBot: false } });
+    }
+    (0, globals_1.it)('returns 0 when both teams have equal rating', () => {
+        const mr = makeRatingForTeams(1000, 1000);
+        (0, globals_1.expect)(mr.getExpectedResult()).toBeCloseTo(0, 5);
+    });
+    (0, globals_1.it)('returns a positive value when home team is stronger', () => {
+        const mr = makeRatingForTeams(1500, 1000);
+        (0, globals_1.expect)(mr.getExpectedResult()).toBeGreaterThan(0);
+    });
+    (0, globals_1.it)('returns a negative value when away team is stronger', () => {
+        const mr = makeRatingForTeams(1000, 1500);
+        (0, globals_1.expect)(mr.getExpectedResult()).toBeLessThan(0);
+    });
+    (0, globals_1.it)('is antisymmetric: EMR(h, a) = -EMR(a, h)', () => {
+        const mr1 = makeRatingForTeams(1200, 800);
+        const mr2 = makeRatingForTeams(800, 1200);
+        (0, globals_1.expect)(mr1.getExpectedResult()).toBeCloseTo(-mr2.getExpectedResult(), 8);
+    });
+});
+// ─── getPoints ────────────────────────────────────────────────────────────────
+(0, globals_1.describe)('MatchRating.getPoints()', () => {
+    (0, globals_1.it)('home and away deltas are opposite signs', () => {
+        const home = (0, test_helpers_1.makeTeam)({ rating: 1000 });
+        const away = (0, test_helpers_1.makeTeam)({ rating: 1000 });
+        const match = (0, test_helpers_1.makeMatch30)(home, away);
+        const mr = match_rating_1.MatchRating.create({ match, context: { kind: 'LEAGUE', tier: 1, homeIsBot: false, awayIsBot: false } });
+        (0, globals_1.expect)(mr.getPoints(match_team_1.MatchTeam.HOME)).toBeCloseTo(-mr.getPoints(match_team_1.MatchTeam.AWAY), 10);
+    });
+    (0, globals_1.it)('winning home team gains positive points against equal opponent (3-0)', () => {
+        const home = (0, test_helpers_1.makeTeam)({ rating: 1000 });
+        const away = (0, test_helpers_1.makeTeam)({ rating: 1000 });
+        const match = (0, test_helpers_1.makeMatch30)(home, away);
+        const mr = match_rating_1.MatchRating.create({ match, context: { kind: 'LEAGUE', tier: 1, homeIsBot: false, awayIsBot: false } });
+        // ssv['3-0'] = 2, emr = 0 for equal teams → homeDelta = 2 * weight / K > 0
+        (0, globals_1.expect)(mr.getPoints(match_team_1.MatchTeam.HOME)).toBeGreaterThan(0);
+        (0, globals_1.expect)(mr.getPoints(match_team_1.MatchTeam.AWAY)).toBeLessThan(0);
+    });
+    (0, globals_1.it)('match winner earns fewer points when they were heavily favoured', () => {
+        // Strong home team beats weak away — less surprising, fewer points
+        const strongHome = (0, test_helpers_1.makeTeam)({ rating: 2000 });
+        const weakAway = (0, test_helpers_1.makeTeam)({ rating: 500 });
+        const evenHome = (0, test_helpers_1.makeTeam)({ rating: 1000 });
+        const evenAway = (0, test_helpers_1.makeTeam)({ rating: 1000 });
+        const surpriseMr = match_rating_1.MatchRating.create({
+            match: (0, test_helpers_1.makeMatch30)(evenHome, evenAway),
+            context: { kind: 'LEAGUE', tier: 1, homeIsBot: false, awayIsBot: false }
+        });
+        const expectedMr = match_rating_1.MatchRating.create({
+            match: (0, test_helpers_1.makeMatch30)(strongHome, weakAway),
+            context: { kind: 'LEAGUE', tier: 1, homeIsBot: false, awayIsBot: false }
+        });
+        // Equal-match 3-0 win earns more points than a heavily favoured 3-0 win
+        (0, globals_1.expect)(surpriseMr.getPoints(match_team_1.MatchTeam.HOME))
+            .toBeGreaterThan(expectedMr.getPoints(match_team_1.MatchTeam.HOME));
+    });
+    (0, globals_1.it)('3-1 win earns fewer points than a 3-0 win (SSV difference)', () => {
+        const home = (0, test_helpers_1.makeTeam)({ rating: 1000 });
+        const away = (0, test_helpers_1.makeTeam)({ rating: 1000 });
+        const win30 = match_rating_1.MatchRating.create({
+            match: (0, test_helpers_1.makeMatch30)(home, away),
+            context: { kind: 'LEAGUE', tier: 1, homeIsBot: false, awayIsBot: false }
+        });
+        const away2 = (0, test_helpers_1.makeTeam)({ rating: 1000 });
+        const win31 = match_rating_1.MatchRating.create({
+            match: (0, test_helpers_1.makeMatch31)(home, away2),
+            context: { kind: 'LEAGUE', tier: 1, homeIsBot: false, awayIsBot: false }
+        });
+        (0, globals_1.expect)(win30.getPoints(match_team_1.MatchTeam.HOME)).toBeGreaterThan(win31.getPoints(match_team_1.MatchTeam.HOME));
+    });
+});

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

@@ -0,0 +1,33 @@
+import { PlayerPosition, Rally } from './rally';
+import { MatchTeam } from './match-team';
+import { BoxScore } from './box-score';
+type ScoreThreshold = 25 | 15;
+export declare class MatchSet {
+    readonly id: string;
+    readonly order: number;
+    readonly isTieBreak: boolean;
+    readonly homePlayerPosition: PlayerPosition[];
+    readonly awayPlayerPosition: PlayerPosition[];
+    readonly boxScores: BoxScore[];
+    readonly rallies: Rally[];
+    readonly scoreThreshold: ScoreThreshold;
+    private _homeScore;
+    private _awayScore;
+    static create(input: unknown): MatchSet;
+    private constructor();
+    get homeScore(): number;
+    get awayScore(): number;
+    increaseScore(team: MatchTeam): void;
+    addRally(rally: Rally): void;
+    /**
+     * Has a team reached at least 25 points, and is the score difference between both teams at least 2?
+     * @returns boolean
+     */
+    isOver(): boolean;
+    /**
+     * Get the team that won the Set. Return undefined if set is not over.
+     * @returns CourtTeam
+     */
+    getWinner(): MatchTeam;
+}
+export {};

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

@@ -0,0 +1,66 @@
+"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

@@ -0,0 +1,7 @@
+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

@@ -0,0 +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 = 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

@@ -0,0 +1,26 @@
+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;
+}