volleyballsimtypes 0.0.462 → 0.0.464

package/dist/esm/src/data/transformers/rally-event.d.ts

@@ -9,6 +9,7 @@ export interface CompactEvent {
     b?: number[];
     l?: number;
     o?: number;
+    j?: number;
 }
 export declare function transformToCompact(evt: RallyEvent, playerIndex: Map<string, number>): CompactEvent;
 export declare function transformToBlock(event: CompactEvent, roster: string[]): Block;

package/dist/esm/src/data/transformers/rally-event.js

@@ -19,6 +19,8 @@ export function transformToCompact(evt, playerIndex) {
     }
     else if (evt instanceof Substitution) {
         out.o = playerIndex.get(evt.playerOut);
+        if (evt.injury === true)
+            out.j = 1;
     }
     return out;
 }
@@ -78,6 +80,7 @@ export function transformToSpike(event, roster) {
 export function transformToSubstitution(event, roster) {
     return Substitution.create({
         playerId: roster[event.p],
-        playerOut: roster[event.o]
+        playerOut: roster[event.o],
+        injury: event.j === 1 ? true : undefined
     });
 }

package/dist/esm/src/data/transformers/season.js

@@ -29,7 +29,7 @@ function transformToAttributes(season) {
     };
 }
 function transformToObject(model) {
-    const teams = sortTeamsByCompetitionIndex(model.Teams ?? []).map(transformToTeam);
+    const teams = sortTeamsByCompetitionIndex(model.Teams ?? []).map(team => transformToTeam(team));
     // One standing per roster team: the persisted CompetitionStandings aggregate where it exists, a zero-stat
     // row otherwise. CompetitionStandings only gains a row once a team plays (the DB trigger fires on match
     // COMPLETE), so mapping it directly dropped un-played teams from the table for the first part of a season.

package/dist/esm/src/data/transformers/tactics.d.ts

@@ -2,6 +2,7 @@ import { TacticsAttributes, TacticsModel } from '../models';
 import { Player, Tactics } from '../../service';
 import type { Tactics as ApiTactics } from '../../api';
 declare function transformToAttributes(tactics: Tactics, teamId: string): TacticsAttributes;
-declare function transformToObject(model: TacticsModel, roster: Player[]): Tactics;
+declare function transformToObject(model: TacticsAttributes, roster: Player[]): Tactics;
 declare function tacticsColumnsToApiDto(model: TacticsModel): ApiTactics;
-export { transformToObject as transformToTactics, transformToAttributes as transformFromTactics, tacticsColumnsToApiDto };
+declare function apiTacticsConfigToAttributes(config: ApiTactics, teamId: string): TacticsAttributes;
+export { transformToObject as transformToTactics, transformToAttributes as transformFromTactics, tacticsColumnsToApiDto, apiTacticsConfigToAttributes as apiTacticsConfigToTacticsAttributes };

package/dist/esm/src/data/transformers/tactics.js

@@ -81,9 +81,16 @@ function transformToAttributes(tactics, teamId) {
         offensive_preference_sets: tactics.offensivePreferenceSets?.map(prefs => prefs.map(p => ({
             rotation: p.rotation,
             order: p.order.map((a) => a.id)
-        })))
+        }))),
+        replace_injured_immediately: tactics.replaceInjuredImmediately,
+        reserve_priorities: tactics.reservePriorities.map(rp => ({
+            position: rp.position,
+            reserves: rp.reserves.map((p) => p.id)
+        }))
     };
 }
+// Accepts TacticsAttributes (not just TacticsModel) so a per-match preset's config, shaped as column data by
+// apiTacticsConfigToTacticsAttributes below, can be hydrated through the exact same validation/healing path.
 function transformToObject(model, roster) {
     const lineup = transformToLineup(model.lineup, roster);
     // A second libero is only valid as a RESERVE: it needs a starting libero (LIBERO_ZONE), the L2 player must be
@@ -156,7 +163,39 @@ function transformToObject(model, roster) {
         offensivePreferenceSets: model.offensive_preference_sets?.map(prefs => prefs.map(p => ({
             rotation: p.rotation,
             order: p.order.map((id) => findPlayer(id, roster))
-        })))
+        }))),
+        replaceInjuredImmediately: model.replace_injured_immediately ?? true,
+        // LENIENT (roster.find, not findPlayer): a dismissed/retired reserve, one that has since moved INTO the
+        // lineup, one that doubles as the resolved second libero, or a duplicate (player in two lists, repeated
+        // position) is DROPPED rather than crashing the sim batch (reserves are depth, not structure); now-empty
+        // entries are pruned. First occurrence wins on duplicates; the next tactics save rewrites cleanly.
+        reservePriorities: (() => {
+            const seenIds = new Set();
+            const seenPositions = new Set();
+            return (model.reserve_priorities ?? [])
+                .filter(rp => {
+                // Court slots only (1-6): jsonb has no constraint, and an out-of-range position would pass the
+                // heal only to be rejected by the schema, crashing the very sim batch this heal protects.
+                if (!Number.isInteger(rp.position) || rp.position < 1 || rp.position > 6)
+                    return false;
+                if (seenPositions.has(rp.position))
+                    return false;
+                seenPositions.add(rp.position);
+                return true;
+            })
+                .map(rp => ({
+                position: rp.position,
+                reserves: rp.reserves
+                    .map((id) => roster.find((p) => p.id === id))
+                    .filter((p) => {
+                    if (p == null || inLineupIds.has(p.id) || p.id === secondLibero?.id || seenIds.has(p.id))
+                        return false;
+                    seenIds.add(p.id);
+                    return true;
+                })
+            }))
+                .filter(rp => rp.reserves.length > 0);
+        })()
     });
 }
 // Serialize a Tactics ROW (db columns) straight to the API Tactics DTO (player references stay as ids; no
@@ -216,7 +255,70 @@ function tacticsColumnsToApiDto(model) {
         designatedSetters: model.designated_setters,
         offensivePreferences: model.offensive_preferences,
         systemSets: model.system_sets,
-        offensivePreferenceSets: model.offensive_preference_sets
+        offensivePreferenceSets: model.offensive_preference_sets,
+        replaceInjuredImmediately: model.replace_injured_immediately ?? true,
+        // Same stale-data policy as validSecondLibero above: don't surface reserve entries the service load
+        // would drop (bad position, id now in the lineup, the L2, duplicates), or the UI reloads and re-emits
+        // them forever. Roster membership can't be checked here (ids only); the service heal covers that.
+        reservePriorities: (() => {
+            const seenIds = new Set();
+            const seenPositions = new Set();
+            const healed = (model.reserve_priorities ?? [])
+                .filter(rp => {
+                if (!Number.isInteger(rp.position) || rp.position < 1 || rp.position > 6)
+                    return false;
+                if (seenPositions.has(rp.position))
+                    return false;
+                seenPositions.add(rp.position);
+                return true;
+            })
+                .map(rp => ({
+                position: rp.position,
+                reserves: rp.reserves.filter(id => {
+                    if (lineupIds.has(id) || id === validSecondLibero || seenIds.has(id))
+                        return false;
+                    seenIds.add(id);
+                    return true;
+                })
+            }))
+                .filter(rp => rp.reserves.length > 0);
+            return healed.length > 0 ? healed : undefined;
+        })()
+    };
+}
+// Inverse of tacticsColumnsToApiDto: shape a preset's stored API config (camelCase, player ids) as
+// TacticsAttributes-shaped column data so transformToTactics can hydrate it against a roster through the
+// exact same validation/healing path as the Tactics row. Only the top-level keys need renaming -- the jsonb
+// sub-objects (designated subs, libero sub, preferences, system sets) are stored camelCase in both shapes.
+// Deliberately NOT mirroring writeTacticsRow's null-clears-column rule: nothing is being UPDATEd here, so
+// absent optionals simply stay undefined.
+function apiTacticsConfigToAttributes(config, teamId) {
+    return {
+        team_id: teamId,
+        lineup: {
+            [CourtPosition.LIBERO_ZONE]: config.lineup[CourtPosition.LIBERO_ZONE],
+            [CourtPosition.LEFT_BACK]: config.lineup[CourtPosition.LEFT_BACK],
+            [CourtPosition.LEFT_FRONT]: config.lineup[CourtPosition.LEFT_FRONT],
+            [CourtPosition.MIDDLE_BACK]: config.lineup[CourtPosition.MIDDLE_BACK],
+            [CourtPosition.MIDDLE_FRONT]: config.lineup[CourtPosition.MIDDLE_FRONT],
+            [CourtPosition.RIGHT_BACK]: config.lineup[CourtPosition.RIGHT_BACK],
+            [CourtPosition.RIGHT_FRONT]: config.lineup[CourtPosition.RIGHT_FRONT],
+            bench: config.lineup.bench
+        },
+        libero_replacements: config.liberoReplacements,
+        receive_rotation_offset: config.receiveRotationOffset,
+        designated_subs: config.designatedSubs,
+        substitution_band: config.substitutionBand,
+        second_libero: config.secondLibero,
+        libero_sub: config.liberoSub,
+        libero_replacement_sets: config.liberoReplacementSets,
+        rotation_system: config.rotationSystem,
+        designated_setters: config.designatedSetters,
+        offensive_preferences: config.offensivePreferences,
+        system_sets: config.systemSets,
+        offensive_preference_sets: config.offensivePreferenceSets,
+        replace_injured_immediately: config.replaceInjuredImmediately,
+        reserve_priorities: config.reservePriorities
     };
 }
-export { transformToObject as transformToTactics, transformToAttributes as transformFromTactics, tacticsColumnsToApiDto };
+export { transformToObject as transformToTactics, transformToAttributes as transformFromTactics, tacticsColumnsToApiDto, apiTacticsConfigToAttributes as apiTacticsConfigToTacticsAttributes };

package/dist/esm/src/data/transformers/team.d.ts

@@ -1,5 +1,11 @@
 import { Team } from '../../service';
 import { TeamAttributes, TeamModel } from '../models';
+import type { Tactics as ApiTactics } from '../../api';
+export interface MatchTacticsOverride {
+    presetId: string;
+    config: ApiTactics;
+    onFallback?: (presetId: string, err: unknown) => void;
+}
 declare function transformToAttributes(team: Team): TeamAttributes;
-declare function transformToObject(model: TeamModel, currentIteration?: number): Team;
+declare function transformToObject(model: TeamModel, currentIteration?: number, tacticsOverride?: MatchTacticsOverride): Team;
 export { transformToObject as transformToTeam, transformToAttributes as transformFromTeam };

package/dist/esm/src/data/transformers/team.js

@@ -1,5 +1,6 @@
 import { Team } from '../../service';
-import { transformFromTactics, transformToCountry, transformToPlayer, transformToTactics } from '.';
+import { apiTacticsConfigToTacticsAttributes, transformFromTactics, transformToCountry, transformToPlayer, transformToTactics } from '.';
+import logger from '../../logger';
 function transformToAttributes(team) {
     return {
         team_id: team.id,
@@ -12,11 +13,25 @@ function transformToAttributes(team) {
         division_id: team.divisionId
     };
 }
-function transformToObject(model, currentIteration) {
+function transformToObject(model, currentIteration, tacticsOverride) {
     const roster = (model.PlayerTeams ?? []).map((pt) => transformToPlayer(pt.player, currentIteration));
-    const tactics = model.tactics != null && roster != null && roster.length > 0
-        ? transformToTactics(model.tactics, roster)
-        : undefined;
+    let tactics;
+    if (tacticsOverride != null && roster.length > 0) {
+        try {
+            tactics = transformToTactics(apiTacticsConfigToTacticsAttributes(tacticsOverride.config, model.team_id), roster);
+        }
+        catch (err) {
+            if (tacticsOverride.onFallback != null)
+                tacticsOverride.onFallback(tacticsOverride.presetId, err);
+            else
+                logger.warn(`MATCH_PRESET_FALLBACK: team=${model.team_id} preset=${tacticsOverride.presetId} failed to hydrate; using active tactics`);
+        }
+    }
+    if (tactics == null) {
+        tactics = model.tactics != null && roster.length > 0
+            ? transformToTactics(model.tactics, roster)
+            : undefined;
+    }
     return Team.create({
         id: model.team_id,
         name: model.name,

package/dist/esm/src/data/transformers/tournament.js

@@ -41,7 +41,7 @@ function transformToObject(model) {
         id: model.competition_id,
         iteration: transformToIteration(model.Iteration),
         matches: (model.CompetitionMatches ?? []).map(transformToTournamentMatch),
-        teams: sortTeamsByCompetitionIndex(model.Teams ?? []).map(transformToTeam),
+        teams: sortTeamsByCompetitionIndex(model.Teams ?? []).map(team => transformToTeam(team)),
         status: model.status,
         champion
     });

package/dist/esm/src/service/event/schemas/substitution.z.d.ts

@@ -2,5 +2,6 @@ import { z } from 'zod';
 export declare const SubstitutionInputSchema: z.ZodObject<{
     playerId: z.ZodUUID;
     playerOut: z.ZodUUID;
+    injury: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type SubstitutionInput = z.infer<typeof SubstitutionInputSchema>;

package/dist/esm/src/service/event/schemas/substitution.z.js

@@ -1,7 +1,8 @@
 import { z } from 'zod';
 export const SubstitutionInputSchema = z.object({
     playerId: z.uuid(),
-    playerOut: z.uuid()
+    playerOut: z.uuid(),
+    injury: z.boolean().optional()
 }).superRefine((data, ctx) => {
     if (data.playerId === data.playerOut) {
         ctx.addIssue({

package/dist/esm/src/service/event/substitution.d.ts

@@ -1,6 +1,7 @@
 import { RallyEvent } from './rally-event';
 export declare class Substitution extends RallyEvent {
     readonly playerOut: string;
+    readonly injury?: boolean;
     static create(input: unknown): Substitution;
     private constructor();
     toString(): string;

package/dist/esm/src/service/event/substitution.js

@@ -14,14 +14,16 @@ export class Substitution extends RallyEvent {
         }
         return new Substitution(result.data);
     }
-    constructor({ playerOut, playerId }) {
+    constructor({ playerOut, playerId, injury }) {
         super({ eventType, playerId });
         this.playerOut = playerOut;
+        this.injury = injury;
     }
     toString() {
         const playerId = `"playerId":"${this.playerId}"`;
         const playerOut = `"playerOut":"${this.playerOut}"`;
         const eventType = `"eventType":${this.eventType}`;
-        return `{${playerId},${playerOut},${eventType}}`;
+        const injury = this.injury === true ? ',"injury":true' : '';
+        return `{${playerId},${playerOut},${eventType}${injury}}`;
     }
 }

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

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

package/dist/esm/src/service/match/match-set-forfeit.test.js

@@ -0,0 +1,74 @@
+import { describe, it, expect } from '@jest/globals';
+import { v4 as uuidv4 } from 'uuid';
+import { MatchSet } from './match-set';
+import { MatchTeam } from './match-team';
+function makeSet(homeScore, awayScore, isTieBreak = false, forfeited) {
+    return MatchSet.create({
+        id: uuidv4(),
+        order: isTieBreak ? 4 : 0,
+        isTieBreak,
+        homePlayerPosition: [],
+        awayPlayerPosition: [],
+        homeScore,
+        awayScore,
+        boxScores: [],
+        rallies: [],
+        ...(forfeited != null ? { forfeited } : {})
+    });
+}
+// Mid-set states are not valid CREATION states (the schema wants 0-0 or a finished score), so build them the
+// way the sim does: create at 0-0 and play to the score.
+function playedTo(homeScore, awayScore, isTieBreak = false) {
+    const set = makeSet(0, 0, isTieBreak);
+    for (let i = 0; i < homeScore; i++)
+        set.increaseScore(MatchTeam.HOME);
+    for (let i = 0; i < awayScore; i++)
+        set.increaseScore(MatchTeam.AWAY);
+    return set;
+}
+describe('MatchSet — forfeit (FIVB 6.4.3)', () => {
+    it('defaults forfeited to false', () => {
+        expect(makeSet(25, 20).forfeited).toBe(false);
+    });
+    it('accepts a persisted forfeited set with an awarded score', () => {
+        const set = makeSet(25, 13, false, true);
+        expect(set.forfeited).toBe(true);
+        expect(set.isOver()).toBe(true);
+        expect(set.getWinner()).toBe(MatchTeam.HOME);
+    });
+    it('awards the threshold when the loser is below deuce (18-23, home granted)', () => {
+        const set = playedTo(18, 23);
+        // Score order in makeSet is home, away; away leads 23-18 but HOME is granted the forfeit win.
+        set.forfeit(MatchTeam.HOME);
+        expect(set.homeScore).toBe(25);
+        expect(set.awayScore).toBe(23);
+        expect(set.forfeited).toBe(true);
+        expect(set.isOver()).toBe(true);
+        expect(set.getWinner()).toBe(MatchTeam.HOME);
+    });
+    it('awards loser + 2 beyond deuce (24-24, away granted -> 24-26)', () => {
+        const set = playedTo(24, 24);
+        set.forfeit(MatchTeam.AWAY);
+        expect(set.homeScore).toBe(24);
+        expect(set.awayScore).toBe(26);
+        expect(set.isOver()).toBe(true);
+        expect(set.getWinner()).toBe(MatchTeam.AWAY);
+    });
+    it('keeps the forfeiting side points (0-0 fully-awarded set -> 25-0)', () => {
+        const set = makeSet(0, 0);
+        set.forfeit(MatchTeam.HOME);
+        expect(set.homeScore).toBe(25);
+        expect(set.awayScore).toBe(0);
+        expect(set.isOver()).toBe(true);
+    });
+    it('awards 15 on a tie break', () => {
+        const set = playedTo(10, 13, true);
+        set.forfeit(MatchTeam.HOME);
+        expect(set.homeScore).toBe(15);
+        expect(set.awayScore).toBe(13);
+        expect(set.isOver()).toBe(true);
+    });
+    it('rejects a forfeited set whose score never reached the awarding rule (below threshold)', () => {
+        expect(() => makeSet(18, 12, false, true)).toThrow(/INVALID_MATCH_SET/);
+    });
+});

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

@@ -13,10 +13,18 @@ export declare class MatchSet {
     readonly scoreThreshold: ScoreThreshold;
     private _homeScore;
     private _awayScore;
+    private _forfeited;
     static create(input: unknown): MatchSet;
     private constructor();
     get homeScore(): number;
     get awayScore(): number;
+    get forfeited(): boolean;
+    /**
+     * End the set by forfeit (FIVB 6.4.3, incomplete team). The forfeiting side keeps its points; the winner
+     * is granted exactly the points needed to win the set (the threshold, or loser + 2 beyond deuce), so the
+     * final score always satisfies the normal reached-threshold and win-by-2 rules. Marks the set forfeited.
+     */
+    forfeit(winner: MatchTeam): void;
     increaseScore(team: MatchTeam): void;
     addRally(rally: Rally): void;
     /**

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

@@ -13,11 +13,12 @@ export class MatchSet {
         }
         return new MatchSet(result.data);
     }
-    constructor({ id, order, isTieBreak, homePlayerPosition, awayPlayerPosition, boxScores, rallies, homeScore, awayScore }) {
+    constructor({ id, order, isTieBreak, homePlayerPosition, awayPlayerPosition, boxScores, rallies, homeScore, awayScore, forfeited = false }) {
         this.id = id;
         this.order = order;
         this._homeScore = homeScore;
         this._awayScore = awayScore;
+        this._forfeited = forfeited;
         this.homePlayerPosition = homePlayerPosition;
         this.awayPlayerPosition = awayPlayerPosition;
         this.boxScores = boxScores;
@@ -31,6 +32,27 @@ export class MatchSet {
     get awayScore() {
         return this._awayScore;
     }
+    get forfeited() {
+        return this._forfeited;
+    }
+    /**
+     * End the set by forfeit (FIVB 6.4.3, incomplete team). The forfeiting side keeps its points; the winner
+     * is granted exactly the points needed to win the set (the threshold, or loser + 2 beyond deuce), so the
+     * final score always satisfies the normal reached-threshold and win-by-2 rules. Marks the set forfeited.
+     */
+    forfeit(winner) {
+        // Forfeiting an already-decided (or already-forfeited) set would silently rewrite the winner with a
+        // schema-legal score: surface the caller bug instead (e.g. both teams forfeited in the same rally).
+        if (this._forfeited || this.isOver())
+            throw new Error('SET_ALREADY_DECIDED');
+        if (winner === MatchTeam.HOME)
+            this._homeScore = Math.max(this.scoreThreshold, this._awayScore + 2);
+        else if (winner === MatchTeam.AWAY)
+            this._awayScore = Math.max(this.scoreThreshold, this._homeScore + 2);
+        else
+            throw new Error('UNKNOWN_TEAM');
+        this._forfeited = true;
+    }
     increaseScore(team) {
         if (team === MatchTeam.HOME)
             this._homeScore++;

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

@@ -3,6 +3,7 @@ import { Team } from '../team';
 import { MatchTeam } from './match-team';
 import { StatusEnum } from '../../data';
 import { VPER } from './vper';
+export type MatchForfeitType = 'INCOMPLETE' | 'DEFAULT';
 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 {
@@ -16,6 +17,7 @@ export declare class Match {
     homeScore?: number;
     awayScore?: number;
     winner?: Team;
+    forfeitType?: MatchForfeitType;
     static create(input: unknown): Match;
     private constructor();
     addSet(set: MatchSet): void;

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

@@ -14,7 +14,7 @@ export class Match {
         }
         return new Match(result.data);
     }
-    constructor({ id, homeTeam, awayTeam, scheduledDate, sets, status, homeScore, awayScore, winner, VPERs }) {
+    constructor({ id, homeTeam, awayTeam, scheduledDate, sets, status, homeScore, awayScore, winner, VPERs, forfeitType }) {
         if (homeTeam.id === awayTeam.id)
             throw new Error(`FAILED_TO_CREATE_MATCH. TEAMS_WITH_SAME_ID: ${homeTeam.id}`);
         this.id = id;
@@ -27,6 +27,7 @@ export class Match {
         this.awayScore = awayScore;
         this.winner = winner;
         this.VPERs = VPERs ?? [];
+        this.forfeitType = forfeitType;
     }
     addSet(set) {
         if (this.sets.length >= 5)

package/dist/esm/src/service/match/schemas/match-set.z.d.ts

@@ -11,5 +11,6 @@ export declare const MatchSetInputSchema: z.ZodObject<{
     awayScore: z.ZodNumber;
     boxScores: z.ZodArray<z.ZodCustom<BoxScore, BoxScore>>;
     rallies: z.ZodArray<z.ZodCustom<Rally, Rally>>;
+    forfeited: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 export type MatchSetInput = z.infer<typeof MatchSetInputSchema>;

package/dist/esm/src/service/match/schemas/match-set.z.js

@@ -24,7 +24,10 @@ export const MatchSetInputSchema = z.object({
     })),
     rallies: z.array(z.custom((v) => v instanceof Rally, {
         message: 'INVALID_RALLY_INSTANCE'
-    }))
+    })),
+    // FIVB 6.4.3 set forfeit (injuries: team could not field six). The awarding rule (winner granted the points
+    // needed to win) keeps the threshold rule below satisfied; only the rallies-vs-score equality is relaxed.
+    forfeited: z.boolean().default(false)
 }).superRefine((data, ctx) => {
     const { order, isTieBreak, rallies, homeScore, awayScore } = data;
     // isTieBreak <-> order === 4
@@ -53,6 +56,20 @@ export const MatchSetInputSchema = z.object({
             path: ['homeScore']
         });
     }
+    // A forfeited score must be exactly what forfeit() awards: winner = max(threshold, loser + 2). This rejects
+    // over-awarded scores (30-10), missing-award states (0-0 or 25-24 forfeited) and any hand-rolled corruption
+    // at the validation boundary instead of letting it flip winners downstream.
+    if (data.forfeited) {
+        const winner = Math.max(homeScore, awayScore);
+        const loser = Math.min(homeScore, awayScore);
+        if (winner !== Math.max(scoreThreshold, loser + 2)) {
+            ctx.addIssue({
+                code: 'custom',
+                message: 'FORFEITED_SCORE_MUST_MATCH_AWARDING_RULE',
+                path: ['homeScore']
+            });
+        }
+    }
     // If rallies exist, score cannot be 0-0 and must match the number of rallies.
     if (hasRallies) {
         if (isZeroZero) {
@@ -62,12 +79,23 @@ export const MatchSetInputSchema = z.object({
                 path: ['rallies']
             });
         }
-        if (homeScore + awayScore !== rallies.length) {
+        // A forfeited set keeps the rallies actually played and is topped up with awarded points, so the sum
+        // exceeds the rally count; anything else (more rallies than points) is still invalid. The loser's points
+        // were all EARNED, so when rallies are present they must at least cover them (rally-less persisted sets,
+        // the bot-vs-bot path, skip this whole block).
+        if (data.forfeited ? rallies.length > homeScore + awayScore : homeScore + awayScore !== rallies.length) {
             ctx.addIssue({
                 code: 'custom',
                 message: 'RALLIES_LENGTH_MUST_EQUAL_SCORE_SUM',
                 path: ['rallies']
             });
         }
+        if (data.forfeited && rallies.length < Math.min(homeScore, awayScore)) {
+            ctx.addIssue({
+                code: 'custom',
+                message: 'FORFEITED_LOSER_POINTS_REQUIRE_RALLIES',
+                path: ['rallies']
+            });
+        }
     }
 });

package/dist/esm/src/service/match/schemas/match.z.d.ts

@@ -18,5 +18,9 @@ export declare const MatchInputSchema: z.ZodObject<{
     homeScore: z.ZodOptional<z.ZodNumber>;
     awayScore: z.ZodOptional<z.ZodNumber>;
     winner: z.ZodOptional<z.ZodCustom<Team, Team>>;
+    forfeitType: z.ZodOptional<z.ZodEnum<{
+        INCOMPLETE: "INCOMPLETE";
+        DEFAULT: "DEFAULT";
+    }>>;
 }, z.core.$strip>;
 export type MatchInput = z.infer<typeof MatchInputSchema>;

package/dist/esm/src/service/match/schemas/match.z.js

@@ -20,7 +20,10 @@ export const MatchInputSchema = z.object({
     })).optional(),
     homeScore: z.number().int().optional(),
     awayScore: z.number().int().optional(),
-    winner: teamSchema.optional()
+    winner: teamSchema.optional(),
+    // Abnormal ending marker (see MatchForfeitType). The match still validates as a normal COMPLETE result
+    // because forfeited sets carry FIVB-awarded scores.
+    forfeitType: z.enum(['INCOMPLETE', 'DEFAULT']).optional()
 }).superRefine((data, ctx) => {
     if (data.homeTeam.id === data.awayTeam.id) {
         ctx.addIssue({

package/dist/esm/src/service/player/index.d.ts

@@ -1,6 +1,7 @@
 export * from './player';
 export * from './improvement';
 export * from './decline';
+export * from './injury';
 export * from './player-generator';
 export * from './performance-stats';
 export * from './trait';

package/dist/esm/src/service/player/index.js

@@ -1,6 +1,7 @@
 export * from './player';
 export * from './improvement';
 export * from './decline';
+export * from './injury';
 export * from './player-generator';
 export * from './performance-stats';
 export * from './trait';

package/dist/esm/src/service/player/injury.d.ts

@@ -0,0 +1,14 @@
+import { Rarity } from './rarity';
+export declare enum InjurySeverityEnum {
+    MINOR = 1,
+    MODERATE = 2,
+    SEVERE = 3
+}
+export interface PlayerInjury {
+    readonly severity: number;
+    readonly injuredUntil: Date;
+    readonly debuff?: number;
+}
+export declare function hasActiveInjury(injury: PlayerInjury | undefined, at: Date): boolean;
+export declare function getPhysiotherapistRiskMultiplier(rarity: Rarity): number;
+export declare function getPhysicianRecoveryMultiplier(rarity: Rarity): number;

package/dist/esm/src/service/player/injury.js

@@ -0,0 +1,33 @@
+import { RarityEnum } from './rarity';
+export var InjurySeverityEnum;
+(function (InjurySeverityEnum) {
+    InjurySeverityEnum[InjurySeverityEnum["MINOR"] = 1] = "MINOR";
+    InjurySeverityEnum[InjurySeverityEnum["MODERATE"] = 2] = "MODERATE";
+    InjurySeverityEnum[InjurySeverityEnum["SEVERE"] = 3] = "SEVERE";
+})(InjurySeverityEnum || (InjurySeverityEnum = {}));
+// A long-term injury is active while `at` is before injuredUntil.
+export function hasActiveInjury(injury, at) {
+    return injury != null && injury.injuredUntil.getTime() > at.getTime();
+}
+// Staff effect curves (same Record-plus-accessor shape as getCoachMultiplier). COMMON = neutral baseline.
+// Physiotherapist scales the per-action injury CHANCE; physician scales long-term recovery TIME.
+const PHYSIOTHERAPIST_RISK_MULTIPLIERS = {
+    [RarityEnum.COMMON]: 1.0,
+    [RarityEnum.RARE]: 0.92,
+    [RarityEnum.LEGENDARY]: 0.84,
+    [RarityEnum.MYTHIC]: 0.75,
+    [RarityEnum.SPECIAL]: 0.65
+};
+const PHYSICIAN_RECOVERY_MULTIPLIERS = {
+    [RarityEnum.COMMON]: 1.0,
+    [RarityEnum.RARE]: 0.9,
+    [RarityEnum.LEGENDARY]: 0.8,
+    [RarityEnum.MYTHIC]: 0.65,
+    [RarityEnum.SPECIAL]: 0.5
+};
+export function getPhysiotherapistRiskMultiplier(rarity) {
+    return PHYSIOTHERAPIST_RISK_MULTIPLIERS[rarity] ?? 1.0;
+}
+export function getPhysicianRecoveryMultiplier(rarity) {
+    return PHYSICIAN_RECOVERY_MULTIPLIERS[rarity] ?? 1.0;
+}

package/dist/esm/src/service/player/injury.test.d.ts

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