volleyballsimtypes 0.0.400 → 0.0.402

package/dist/cjs/src/api/index.d.ts

@@ -1,4 +1,4 @@
-import { BoxScore, DataProps, DeclineStatus, Division as _Division, League as _League, Match as _Match, MatchSet as _MatchSet, Player as _Player, PlayerPosition, Qualifier as _Qualifier, QualifierMatch as _QualifierMatch, Rally as _Rally, RallyEvent as _RallyEvent, Season as _Season, Standing as _Standing, Team as _Team, Tournament as _Tournament, TournamentMatch as _TournamentMatch, National as _National, NationalMatch as _NationalMatch, Country as _Country, CourtPosition, ConditionLogic, EnergyBand, PinchCondition, RotationSystemEnum, SubBand, SubMode } from '../service';
+import { BoxScore, DataProps, DeclineStatus, Division as _Division, League as _League, Match as _Match, MatchSet as _MatchSet, Player as _Player, PlayerPosition, Qualifier as _Qualifier, QualifierMatch as _QualifierMatch, Rally as _Rally, RallyEvent as _RallyEvent, Season as _Season, Standing as _Standing, Team as _Team, Tournament as _Tournament, TournamentMatch as _TournamentMatch, National as _National, NationalMatch as _NationalMatch, Country as _Country, CourtPosition, ConditionLogic, EnergyBand, LiberoSubMode, PinchCondition, RotationSystemEnum, SubBand, SubMode } from '../service';
 export type Rally = DataProps<_Rally> & {
     homePlayerPosition: PlayerPosition[];
     awayPlayerPosition: PlayerPosition[];
@@ -76,6 +76,13 @@ export interface ApiOffensivePreference {
     rotation: number;
     order: string[];
 }
+export interface ApiLiberoSetSubConfig {
+    mode: LiberoSubMode;
+    fatigueBand?: EnergyBand;
+}
+export interface ApiLiberoSubConfig extends ApiLiberoSetSubConfig {
+    sets?: ApiLiberoSetSubConfig[];
+}
 export interface Tactics {
     lineup: StartingLineup;
     substitutionTolerance: number;
@@ -84,6 +91,9 @@ export interface Tactics {
     receiveRotationOffset: boolean;
     designatedSubs: ApiDesignatedSub[];
     substitutionBand: SubBand;
+    secondLibero?: string;
+    liberoSub?: ApiLiberoSubConfig;
+    liberoReplacementSets?: string[][];
     rotationSystem: RotationSystemEnum;
     designatedSetters: string[];
     offensivePreferences: ApiOffensivePreference[];

package/dist/cjs/src/data/models/currency-transaction.d.ts

@@ -11,10 +11,11 @@ export declare enum CurrencyTransactionSourceEnum {
     GACHA_PULL = "GACHA_PULL",
     COACH_UPGRADE = "COACH_UPGRADE",
     PLAYER_DISMISS = "PLAYER_DISMISS",
+    PLAYER_RETIRE = "PLAYER_RETIRE",
     ADMIN_GRANT = "ADMIN_GRANT",
     SEASON_REWARD = "SEASON_REWARD"
 }
-export type CurrencyTransactionSource = CurrencyTransactionSourceEnum.MATCH_REWARD | CurrencyTransactionSourceEnum.GACHA_PULL | CurrencyTransactionSourceEnum.COACH_UPGRADE | CurrencyTransactionSourceEnum.PLAYER_DISMISS | CurrencyTransactionSourceEnum.ADMIN_GRANT | CurrencyTransactionSourceEnum.SEASON_REWARD;
+export type CurrencyTransactionSource = CurrencyTransactionSourceEnum.MATCH_REWARD | CurrencyTransactionSourceEnum.GACHA_PULL | CurrencyTransactionSourceEnum.COACH_UPGRADE | CurrencyTransactionSourceEnum.PLAYER_DISMISS | CurrencyTransactionSourceEnum.PLAYER_RETIRE | CurrencyTransactionSourceEnum.ADMIN_GRANT | CurrencyTransactionSourceEnum.SEASON_REWARD;
 export interface CurrencyTransactionAttributes {
     transaction_id: string;
     user_id: string;

package/dist/cjs/src/data/models/currency-transaction.js

@@ -13,6 +13,7 @@ var CurrencyTransactionSourceEnum;
     CurrencyTransactionSourceEnum["GACHA_PULL"] = "GACHA_PULL";
     CurrencyTransactionSourceEnum["COACH_UPGRADE"] = "COACH_UPGRADE";
     CurrencyTransactionSourceEnum["PLAYER_DISMISS"] = "PLAYER_DISMISS";
+    CurrencyTransactionSourceEnum["PLAYER_RETIRE"] = "PLAYER_RETIRE";
     CurrencyTransactionSourceEnum["ADMIN_GRANT"] = "ADMIN_GRANT";
     CurrencyTransactionSourceEnum["SEASON_REWARD"] = "SEASON_REWARD";
 })(CurrencyTransactionSourceEnum || (exports.CurrencyTransactionSourceEnum = CurrencyTransactionSourceEnum = {}));

package/dist/cjs/src/data/models/tactics.d.ts

@@ -1,7 +1,7 @@
 import * as Sequelize from 'sequelize';
 import { Model, Optional } from 'sequelize';
 import { PlayerId, TeamId, TeamModel } from '.';
-import { ConditionLogic, CourtPosition, EnergyBand, PinchCondition, RotationSystemEnum, SubBand, SubMode } from '../../service';
+import { ConditionLogic, CourtPosition, EnergyBand, LiberoSubMode, PinchCondition, RotationSystemEnum, SubBand, SubMode } from '../../service';
 export interface TacticsLineupAttributes {
     [CourtPosition.LIBERO_ZONE]?: PlayerId;
     [CourtPosition.LEFT_BACK]: PlayerId;
@@ -34,6 +34,13 @@ export interface OffensivePreferenceAttributes {
     rotation: number;
     order: PlayerId[];
 }
+export interface LiberoSetSubConfigAttributes {
+    mode: LiberoSubMode;
+    fatigueBand?: EnergyBand;
+}
+export interface LiberoSubConfigAttributes extends LiberoSetSubConfigAttributes {
+    sets?: LiberoSetSubConfigAttributes[];
+}
 export interface TacticsAttributes {
     team_id: string;
     substitution_tolerance: number;
@@ -43,13 +50,16 @@ export interface TacticsAttributes {
     receive_rotation_offset: boolean;
     designated_subs: DesignatedSubAttributes[];
     substitution_band: SubBand;
+    second_libero?: PlayerId;
+    libero_sub?: LiberoSubConfigAttributes;
+    libero_replacement_sets?: PlayerId[][];
     rotation_system: RotationSystemEnum;
     designated_setters: PlayerId[];
     offensive_preferences: OffensivePreferenceAttributes[];
 }
 export type TacticsPk = 'team_id';
 export type TacticsId = TacticsModel[TacticsPk];
-export type TacticsOptionalAttributes = 'substitution_tolerance' | 'lineup' | 'libero_replacements' | 'pinch_server_subs' | 'receive_rotation_offset' | 'designated_subs' | 'substitution_band' | 'rotation_system' | 'designated_setters' | 'offensive_preferences';
+export type TacticsOptionalAttributes = 'substitution_tolerance' | 'lineup' | 'libero_replacements' | 'pinch_server_subs' | 'receive_rotation_offset' | 'designated_subs' | 'substitution_band' | 'second_libero' | 'libero_sub' | 'libero_replacement_sets' | 'rotation_system' | 'designated_setters' | 'offensive_preferences';
 export type TacticsCreationAttributes = Optional<TacticsAttributes, TacticsOptionalAttributes>;
 export declare class TacticsModel extends Model<TacticsAttributes, TacticsCreationAttributes> implements TacticsAttributes {
     team_id: string;
@@ -60,6 +70,9 @@ export declare class TacticsModel extends Model<TacticsAttributes, TacticsCreati
     receive_rotation_offset: boolean;
     designated_subs: DesignatedSubAttributes[];
     substitution_band: SubBand;
+    second_libero?: PlayerId;
+    libero_sub?: LiberoSubConfigAttributes;
+    libero_replacement_sets?: PlayerId[][];
     rotation_system: RotationSystemEnum;
     designated_setters: PlayerId[];
     offensive_preferences: OffensivePreferenceAttributes[];

package/dist/cjs/src/data/models/tactics.js

@@ -50,6 +50,18 @@ class TacticsModel extends sequelize_1.Model {
                 allowNull: false,
                 defaultValue: 'TIRED'
             },
+            second_libero: {
+                type: sequelize_1.DataTypes.UUID,
+                allowNull: true
+            },
+            libero_sub: {
+                type: sequelize_1.DataTypes.JSONB,
+                allowNull: true
+            },
+            libero_replacement_sets: {
+                type: sequelize_1.DataTypes.JSONB,
+                allowNull: true
+            },
             rotation_system: {
                 type: sequelize_1.DataTypes.STRING,
                 allowNull: false,

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

@@ -54,6 +54,9 @@ function transformToAttributes(tactics, teamId) {
         libero_replacements: tactics.liberoReplacements.map((lr) => lr.id),
         pinch_server_subs: Object.fromEntries([...tactics.pinchServerSubs].map(([k, v]) => [k.id, v.id])),
         substitution_band: tactics.substitutionBand,
+        second_libero: tactics.secondLibero?.id,
+        libero_sub: tactics.liberoSub,
+        libero_replacement_sets: tactics.liberoReplacementSets?.map(set => set.map((p) => p.id)),
         designated_subs: tactics.designatedSubs.map(ds => ({
             starterId: ds.starter.id,
             benchId: ds.bench?.id,
@@ -92,6 +95,9 @@ function transformToObject(model, roster) {
         liberoReplacements: model.libero_replacements.map((lr) => findPlayer(lr, roster)),
         pinchServerSubs: buildPinchServerSubs(model.pinch_server_subs, roster),
         substitutionBand: model.substitution_band,
+        secondLibero: model.second_libero != null ? findPlayer(model.second_libero, roster) : undefined,
+        liberoSub: model.libero_sub ?? undefined,
+        liberoReplacementSets: model.libero_replacement_sets?.map(set => set.map((id) => findPlayer(id, roster))),
         designatedSubs: (model.designated_subs ?? []).map(d => ({
             starter: findPlayer(d.starterId, roster),
             bench: d.benchId != null ? findPlayer(d.benchId, roster) : undefined,

package/dist/cjs/src/service/team/index.d.ts

@@ -6,6 +6,7 @@ export * from './team-name';
 export * from './energy-band';
 export * from './pinch-condition';
 export * from './designated-sub';
+export * from './libero-sub';
 export * from './rotation-system';
 export * from './lineup-function';
 export * from './base-position';

package/dist/cjs/src/service/team/index.js

@@ -22,6 +22,7 @@ __exportStar(require("./team-name"), exports);
 __exportStar(require("./energy-band"), exports);
 __exportStar(require("./pinch-condition"), exports);
 __exportStar(require("./designated-sub"), exports);
+__exportStar(require("./libero-sub"), exports);
 __exportStar(require("./rotation-system"), exports);
 __exportStar(require("./lineup-function"), exports);
 __exportStar(require("./base-position"), exports);

package/dist/cjs/src/service/team/libero-sub.d.ts

@@ -0,0 +1,9 @@
+import { EnergyBand } from './energy-band';
+export type LiberoSubMode = 'NEVER' | 'FATIGUE' | 'ALWAYS';
+export interface LiberoSetSubConfig {
+    readonly mode: LiberoSubMode;
+    readonly fatigueBand?: EnergyBand;
+}
+export interface LiberoSubConfig extends LiberoSetSubConfig {
+    readonly sets?: LiberoSetSubConfig[];
+}

package/dist/cjs/src/service/team/libero-sub.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/src/service/team/schemas/libero-sub.z.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { EnergyBand } from '../energy-band';
+export declare const LiberoSubModeSchema: z.ZodEnum<{
+    NEVER: "NEVER";
+    FATIGUE: "FATIGUE";
+    ALWAYS: "ALWAYS";
+}>;
+export declare const LiberoSetSubConfigSchema: z.ZodObject<{
+    mode: z.ZodEnum<{
+        NEVER: "NEVER";
+        FATIGUE: "FATIGUE";
+        ALWAYS: "ALWAYS";
+    }>;
+    fatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
+}, z.core.$strip>;
+export declare const LiberoSubConfigSchema: z.ZodObject<{
+    sets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        mode: z.ZodEnum<{
+            NEVER: "NEVER";
+            FATIGUE: "FATIGUE";
+            ALWAYS: "ALWAYS";
+        }>;
+        fatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
+    }, z.core.$strip>>>;
+    mode: z.ZodEnum<{
+        NEVER: "NEVER";
+        FATIGUE: "FATIGUE";
+        ALWAYS: "ALWAYS";
+    }>;
+    fatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
+}, z.core.$strip>;

package/dist/cjs/src/service/team/schemas/libero-sub.z.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LiberoSubConfigSchema = exports.LiberoSetSubConfigSchema = exports.LiberoSubModeSchema = void 0;
+const zod_1 = require("zod");
+const energy_band_1 = require("../energy-band");
+exports.LiberoSubModeSchema = zod_1.z.enum(['NEVER', 'FATIGUE', 'ALWAYS']);
+// Fields shared by the all-sets config and each per-set config. Unlike a designated sub there is no bench or
+// pinch condition here (the swapped-in player is always the dedicated `secondLibero`), so there is nothing to
+// cross-validate.
+const liberoSetSubConfigShape = {
+    mode: exports.LiberoSubModeSchema,
+    // fatigue mode only (absent => the team default `substitutionBand`):
+    fatigueBand: zod_1.z.nativeEnum(energy_band_1.EnergyBand).optional()
+};
+exports.LiberoSetSubConfigSchema = zod_1.z.object(liberoSetSubConfigShape);
+exports.LiberoSubConfigSchema = zod_1.z.object({
+    ...liberoSetSubConfigShape,
+    // Optional per-set overrides (index 0 = set 1 ... index 4 = set 5); absent => the flat config for all sets.
+    sets: zod_1.z.array(exports.LiberoSetSubConfigSchema).max(5).optional()
+});

package/dist/cjs/src/service/team/schemas/libero-sub.z.test.d.ts

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

package/dist/cjs/src/service/team/schemas/libero-sub.z.test.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const libero_sub_z_1 = require("./libero-sub.z");
+const energy_band_1 = require("../energy-band");
+(0, globals_1.describe)('LiberoSubModeSchema', () => {
+    (0, globals_1.it)('accepts NEVER, FATIGUE and ALWAYS', () => {
+        for (const mode of ['NEVER', 'FATIGUE', 'ALWAYS']) {
+            (0, globals_1.expect)(libero_sub_z_1.LiberoSubModeSchema.safeParse(mode).success).toBe(true);
+        }
+    });
+    (0, globals_1.it)('rejects an unknown mode', () => {
+        (0, globals_1.expect)(libero_sub_z_1.LiberoSubModeSchema.safeParse('SOMETIMES').success).toBe(false);
+    });
+});
+(0, globals_1.describe)('LiberoSetSubConfigSchema', () => {
+    (0, globals_1.it)('accepts a mode with no band', () => {
+        (0, globals_1.expect)(libero_sub_z_1.LiberoSetSubConfigSchema.safeParse({ mode: 'ALWAYS' }).success).toBe(true);
+    });
+    (0, globals_1.it)('accepts a fatigue mode with a band', () => {
+        (0, globals_1.expect)(libero_sub_z_1.LiberoSetSubConfigSchema.safeParse({ mode: 'FATIGUE', fatigueBand: energy_band_1.EnergyBand.TIRED }).success).toBe(true);
+    });
+    (0, globals_1.it)('rejects an unknown band', () => {
+        (0, globals_1.expect)(libero_sub_z_1.LiberoSetSubConfigSchema.safeParse({ mode: 'FATIGUE', fatigueBand: 'SLEEPY' }).success).toBe(false);
+    });
+});
+(0, globals_1.describe)('LiberoSubConfigSchema', () => {
+    (0, globals_1.it)('accepts a flat config with no per-set overrides', () => {
+        (0, globals_1.expect)(libero_sub_z_1.LiberoSubConfigSchema.safeParse({ mode: 'FATIGUE', fatigueBand: energy_band_1.EnergyBand.WORN }).success).toBe(true);
+    });
+    (0, globals_1.it)('accepts up to five per-set configs', () => {
+        const res = libero_sub_z_1.LiberoSubConfigSchema.safeParse({
+            mode: 'NEVER',
+            sets: [
+                { mode: 'NEVER' },
+                { mode: 'ALWAYS' },
+                { mode: 'FATIGUE', fatigueBand: energy_band_1.EnergyBand.TIRED },
+                { mode: 'NEVER' },
+                { mode: 'ALWAYS' }
+            ]
+        });
+        (0, globals_1.expect)(res.success).toBe(true);
+    });
+    (0, globals_1.it)('rejects more than five per-set configs', () => {
+        const res = libero_sub_z_1.LiberoSubConfigSchema.safeParse({
+            mode: 'NEVER',
+            sets: Array.from({ length: 6 }, () => ({ mode: 'NEVER' }))
+        });
+        (0, globals_1.expect)(res.success).toBe(false);
+    });
+    (0, globals_1.it)('rejects an unknown mode in a per-set config', () => {
+        const res = libero_sub_z_1.LiberoSubConfigSchema.safeParse({
+            mode: 'NEVER',
+            sets: [{ mode: 'WHENEVER' }]
+        });
+        (0, globals_1.expect)(res.success).toBe(false);
+    });
+});

package/dist/cjs/src/service/team/schemas/tactics.z.d.ts

@@ -91,6 +91,24 @@ export declare const TacticsInputSchema: z.ZodObject<{
         starter: z.ZodCustom<Player, Player>;
     }, z.core.$strip>>>;
     substitutionBand: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<typeof EnergyBand>, z.ZodLiteral<"NEVER">]>>;
+    secondLibero: z.ZodOptional<z.ZodCustom<Player, Player>>;
+    liberoSub: z.ZodOptional<z.ZodObject<{
+        sets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            mode: z.ZodEnum<{
+                NEVER: "NEVER";
+                FATIGUE: "FATIGUE";
+                ALWAYS: "ALWAYS";
+            }>;
+            fatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
+        }, z.core.$strip>>>;
+        mode: z.ZodEnum<{
+            NEVER: "NEVER";
+            FATIGUE: "FATIGUE";
+            ALWAYS: "ALWAYS";
+        }>;
+        fatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
+    }, z.core.$strip>>;
+    liberoReplacementSets: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodCustom<Player, Player>>>>;
     rotationSystem: z.ZodDefault<z.ZodEnum<typeof RotationSystemEnum>>;
     designatedSetters: z.ZodDefault<z.ZodArray<z.ZodCustom<Player, Player>>>;
     offensivePreferences: z.ZodDefault<z.ZodArray<z.ZodObject<{

package/dist/cjs/src/service/team/schemas/tactics.z.js

@@ -6,6 +6,7 @@ const player_1 = require("../../player");
 const energy_band_1 = require("../energy-band");
 const rotation_system_1 = require("../rotation-system");
 const designated_sub_z_1 = require("./designated-sub.z");
+const libero_sub_z_1 = require("./libero-sub.z");
 const playerInstanceSchema = zod_1.z.custom((v) => v instanceof player_1.Player, {
     message: 'INVALID_PLAYER_INSTANCE'
 });
@@ -64,6 +65,11 @@ exports.TacticsInputSchema = zod_1.z.object({
     // New (designated-subs feature). Defaults keep every existing Tactics.create({...}) call valid.
     designatedSubs: zod_1.z.array(designated_sub_z_1.DesignatedSubSchema).default([]),
     substitutionBand: designated_sub_z_1.SubBandSchema.default(energy_band_1.EnergyBand.TIRED),
+    // Second libero (L2). All optional => an unconfigured team behaves exactly as before. Cross-field rules
+    // (reserve-only, requires a libero, swap requires a second libero, per-set replacements are starters) below.
+    secondLibero: playerInstanceSchema.optional(),
+    liberoSub: libero_sub_z_1.LiberoSubConfigSchema.optional(),
+    liberoReplacementSets: zod_1.z.array(zod_1.z.array(playerInstanceSchema).max(2)).max(5).optional(),
     // Advanced tactics (rotation systems). Defaults (6-0 / no setters / no preferences) keep every existing
     // Tactics.create({...}) call valid and make an unconfigured team play exactly as before.
     rotationSystem: zod_1.z.nativeEnum(rotation_system_1.RotationSystemEnum).default(rotation_system_1.RotationSystemEnum.SIX_ZERO),
@@ -123,4 +129,34 @@ exports.TacticsInputSchema = zod_1.z.object({
             }
         }
     }
+    // Second libero (L2). The second libero is a reserve (not a starter, the libero, or a bench player). A swap
+    // rule (FATIGUE/ALWAYS in any set) needs someone to swap in, so it requires a second libero, and a second
+    // libero needs a starting libero to replace ("no L2 without an L"). Per-set libero replacements, like the
+    // flat ones, are back-row court starters.
+    const libero = data.lineup[LIBERO_ZONE];
+    const inLineupIds = new Set([
+        ...starterIds,
+        ...(libero != null ? [libero.id] : []),
+        ...data.lineup.bench.map(p => p.id)
+    ]);
+    const liberoSubModes = data.liberoSub != null
+        ? [data.liberoSub.mode, ...(data.liberoSub.sets ?? []).map(s => s.mode)]
+        : [];
+    const wantsLiberoSwap = liberoSubModes.some(mode => mode !== 'NEVER');
+    if (wantsLiberoSwap && data.secondLibero == null) {
+        ctx.addIssue({ code: 'custom', message: 'LIBERO_SWAP_REQUIRES_SECOND_LIBERO', path: ['secondLibero'] });
+    }
+    if ((data.secondLibero != null || wantsLiberoSwap) && libero == null) {
+        ctx.addIssue({ code: 'custom', message: 'SECOND_LIBERO_REQUIRES_LIBERO', path: ['secondLibero'] });
+    }
+    if (data.secondLibero != null && inLineupIds.has(data.secondLibero.id)) {
+        ctx.addIssue({ code: 'custom', message: 'SECOND_LIBERO_MUST_BE_RESERVE', path: ['secondLibero'] });
+    }
+    for (const set of data.liberoReplacementSets ?? []) {
+        for (const player of set) {
+            if (!starterIds.has(player.id)) {
+                ctx.addIssue({ code: 'custom', message: 'LIBERO_REPLACEMENT_NOT_A_STARTER', path: ['liberoReplacementSets'] });
+            }
+        }
+    }
 });

package/dist/cjs/src/service/team/schemas/tactics.z.test.d.ts

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

package/dist/cjs/src/service/team/schemas/tactics.z.test.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const tactics_z_1 = require("./tactics.z");
+const test_helpers_1 = require("../../test-helpers");
+(0, globals_1.describe)('TacticsInputSchema — second libero rules', () => {
+    const country = (0, test_helpers_1.makeCountry)();
+    const p1 = (0, test_helpers_1.makePlayer)(country);
+    const p2 = (0, test_helpers_1.makePlayer)(country);
+    const p3 = (0, test_helpers_1.makePlayer)(country);
+    const p4 = (0, test_helpers_1.makePlayer)(country);
+    const p5 = (0, test_helpers_1.makePlayer)(country);
+    const p6 = (0, test_helpers_1.makePlayer)(country);
+    const libero = (0, test_helpers_1.makePlayer)(country);
+    const reserve = (0, test_helpers_1.makePlayer)(country);
+    // A minimal valid TacticsInput (6-0, no setters needed). `overrides` adds the libero fields under test.
+    function baseInput(overrides = {}, withLibero = true) {
+        return {
+            lineup: {
+                4: p4,
+                3: p3,
+                2: p2,
+                5: p5,
+                6: p6,
+                1: p1,
+                ...(withLibero ? { 0: libero } : {}),
+                bench: []
+            },
+            substitutionTolerance: 1,
+            liberoReplacements: [],
+            pinchServerSubs: new Map(),
+            ...overrides
+        };
+    }
+    (0, globals_1.it)('accepts an unconfigured team (no second libero, no liberoSub)', () => {
+        (0, globals_1.expect)(tactics_z_1.TacticsInputSchema.safeParse(baseInput()).success).toBe(true);
+    });
+    (0, globals_1.it)('accepts a reserve second libero with an ALWAYS swap and a starting libero', () => {
+        const res = tactics_z_1.TacticsInputSchema.safeParse(baseInput({
+            secondLibero: reserve,
+            liberoSub: { mode: 'ALWAYS' }
+        }));
+        (0, globals_1.expect)(res.success).toBe(true);
+    });
+    (0, globals_1.it)('rejects a swap rule with no second libero', () => {
+        const res = tactics_z_1.TacticsInputSchema.safeParse(baseInput({ liberoSub: { mode: 'ALWAYS' } }));
+        (0, globals_1.expect)(res.success).toBe(false);
+        if (!res.success) {
+            (0, globals_1.expect)(res.error.issues.some(issue => issue.message === 'LIBERO_SWAP_REQUIRES_SECOND_LIBERO')).toBe(true);
+        }
+    });
+    (0, globals_1.it)('rejects a second libero with no starting libero', () => {
+        const res = tactics_z_1.TacticsInputSchema.safeParse(baseInput({ secondLibero: reserve }, false));
+        (0, globals_1.expect)(res.success).toBe(false);
+        if (!res.success) {
+            (0, globals_1.expect)(res.error.issues.some(issue => issue.message === 'SECOND_LIBERO_REQUIRES_LIBERO')).toBe(true);
+        }
+    });
+    (0, globals_1.it)('rejects a second libero that is a starter (must be a reserve)', () => {
+        const res = tactics_z_1.TacticsInputSchema.safeParse(baseInput({ secondLibero: p1 }));
+        (0, globals_1.expect)(res.success).toBe(false);
+        if (!res.success) {
+            (0, globals_1.expect)(res.error.issues.some(issue => issue.message === 'SECOND_LIBERO_MUST_BE_RESERVE')).toBe(true);
+        }
+    });
+    (0, globals_1.it)('rejects per-set libero replacements that are not court starters', () => {
+        const res = tactics_z_1.TacticsInputSchema.safeParse(baseInput({ liberoReplacementSets: [[reserve]] }));
+        (0, globals_1.expect)(res.success).toBe(false);
+        if (!res.success) {
+            (0, globals_1.expect)(res.error.issues.some(issue => issue.message === 'LIBERO_REPLACEMENT_NOT_A_STARTER')).toBe(true);
+        }
+    });
+});

package/dist/cjs/src/service/team/schemas/team.z.d.ts

@@ -99,6 +99,24 @@ export declare const TeamInputSchema: z.ZodObject<{
             starter: z.ZodCustom<Player, Player>;
         }, z.core.$strip>>>;
         substitutionBand: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<typeof import("..").EnergyBand>, z.ZodLiteral<"NEVER">]>>;
+        secondLibero: z.ZodOptional<z.ZodCustom<Player, Player>>;
+        liberoSub: z.ZodOptional<z.ZodObject<{
+            sets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                mode: z.ZodEnum<{
+                    NEVER: "NEVER";
+                    FATIGUE: "FATIGUE";
+                    ALWAYS: "ALWAYS";
+                }>;
+                fatigueBand: z.ZodOptional<z.ZodEnum<typeof import("..").EnergyBand>>;
+            }, z.core.$strip>>>;
+            mode: z.ZodEnum<{
+                NEVER: "NEVER";
+                FATIGUE: "FATIGUE";
+                ALWAYS: "ALWAYS";
+            }>;
+            fatigueBand: z.ZodOptional<z.ZodEnum<typeof import("..").EnergyBand>>;
+        }, z.core.$strip>>;
+        liberoReplacementSets: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodCustom<Player, Player>>>>;
         rotationSystem: z.ZodDefault<z.ZodEnum<typeof import("..").RotationSystemEnum>>;
         designatedSetters: z.ZodDefault<z.ZodArray<z.ZodCustom<Player, Player>>>;
         offensivePreferences: z.ZodDefault<z.ZodArray<z.ZodObject<{

package/dist/cjs/src/service/team/tactics.d.ts

@@ -1,6 +1,7 @@
 import { CourtPosition } from '../match';
 import { Player } from '../player';
 import { DesignatedSub } from './designated-sub';
+import { LiberoSubConfig } from './libero-sub';
 import { SubBand } from './energy-band';
 import { RotationSystemEnum } from './rotation-system';
 import { OffensivePreference } from './offensive-preference';
@@ -22,6 +23,9 @@ export interface TacticsOpts {
     readonly receiveRotationOffset: boolean;
     readonly designatedSubs: DesignatedSub[];
     readonly substitutionBand: SubBand;
+    readonly secondLibero?: Player;
+    readonly liberoSub?: LiberoSubConfig;
+    readonly liberoReplacementSets?: Player[][];
     readonly rotationSystem: RotationSystemEnum;
     readonly designatedSetters: Player[];
     readonly offensivePreferences: OffensivePreference[];
@@ -34,6 +38,9 @@ export declare class Tactics {
     readonly receiveRotationOffset: boolean;
     readonly designatedSubs: DesignatedSub[];
     readonly substitutionBand: SubBand;
+    readonly secondLibero?: Player;
+    readonly liberoSub?: LiberoSubConfig;
+    readonly liberoReplacementSets?: Player[][];
     readonly rotationSystem: RotationSystemEnum;
     readonly designatedSetters: Player[];
     readonly offensivePreferences: OffensivePreference[];

package/dist/cjs/src/service/team/tactics.js

@@ -18,7 +18,7 @@ class Tactics {
         }
         return new Tactics(result.data);
     }
-    constructor({ lineup, pinchServerSubs, liberoReplacements, substitutionTolerance = 1, receiveRotationOffset = false, designatedSubs = [], substitutionBand = energy_band_1.EnergyBand.TIRED, rotationSystem = rotation_system_1.RotationSystemEnum.SIX_ZERO, designatedSetters = [], offensivePreferences = [] }) {
+    constructor({ lineup, pinchServerSubs, liberoReplacements, substitutionTolerance = 1, receiveRotationOffset = false, designatedSubs = [], substitutionBand = energy_band_1.EnergyBand.TIRED, secondLibero, liberoSub, liberoReplacementSets, rotationSystem = rotation_system_1.RotationSystemEnum.SIX_ZERO, designatedSetters = [], offensivePreferences = [] }) {
         this.lineup = lineup;
         this.substitutionTolerance = substitutionTolerance;
         this.pinchServerSubs = pinchServerSubs;
@@ -26,6 +26,9 @@ class Tactics {
         this.receiveRotationOffset = receiveRotationOffset;
         this.designatedSubs = designatedSubs;
         this.substitutionBand = substitutionBand;
+        this.secondLibero = secondLibero;
+        this.liberoSub = liberoSub;
+        this.liberoReplacementSets = liberoReplacementSets;
         this.rotationSystem = rotationSystem;
         this.designatedSetters = designatedSetters;
         this.offensivePreferences = offensivePreferences;

package/dist/esm/src/api/index.d.ts

@@ -1,4 +1,4 @@
-import { BoxScore, DataProps, DeclineStatus, Division as _Division, League as _League, Match as _Match, MatchSet as _MatchSet, Player as _Player, PlayerPosition, Qualifier as _Qualifier, QualifierMatch as _QualifierMatch, Rally as _Rally, RallyEvent as _RallyEvent, Season as _Season, Standing as _Standing, Team as _Team, Tournament as _Tournament, TournamentMatch as _TournamentMatch, National as _National, NationalMatch as _NationalMatch, Country as _Country, CourtPosition, ConditionLogic, EnergyBand, PinchCondition, RotationSystemEnum, SubBand, SubMode } from '../service';
+import { BoxScore, DataProps, DeclineStatus, Division as _Division, League as _League, Match as _Match, MatchSet as _MatchSet, Player as _Player, PlayerPosition, Qualifier as _Qualifier, QualifierMatch as _QualifierMatch, Rally as _Rally, RallyEvent as _RallyEvent, Season as _Season, Standing as _Standing, Team as _Team, Tournament as _Tournament, TournamentMatch as _TournamentMatch, National as _National, NationalMatch as _NationalMatch, Country as _Country, CourtPosition, ConditionLogic, EnergyBand, LiberoSubMode, PinchCondition, RotationSystemEnum, SubBand, SubMode } from '../service';
 export type Rally = DataProps<_Rally> & {
     homePlayerPosition: PlayerPosition[];
     awayPlayerPosition: PlayerPosition[];
@@ -76,6 +76,13 @@ export interface ApiOffensivePreference {
     rotation: number;
     order: string[];
 }
+export interface ApiLiberoSetSubConfig {
+    mode: LiberoSubMode;
+    fatigueBand?: EnergyBand;
+}
+export interface ApiLiberoSubConfig extends ApiLiberoSetSubConfig {
+    sets?: ApiLiberoSetSubConfig[];
+}
 export interface Tactics {
     lineup: StartingLineup;
     substitutionTolerance: number;
@@ -84,6 +91,9 @@ export interface Tactics {
     receiveRotationOffset: boolean;
     designatedSubs: ApiDesignatedSub[];
     substitutionBand: SubBand;
+    secondLibero?: string;
+    liberoSub?: ApiLiberoSubConfig;
+    liberoReplacementSets?: string[][];
     rotationSystem: RotationSystemEnum;
     designatedSetters: string[];
     offensivePreferences: ApiOffensivePreference[];

package/dist/esm/src/data/models/currency-transaction.d.ts

@@ -11,10 +11,11 @@ export declare enum CurrencyTransactionSourceEnum {
     GACHA_PULL = "GACHA_PULL",
     COACH_UPGRADE = "COACH_UPGRADE",
     PLAYER_DISMISS = "PLAYER_DISMISS",
+    PLAYER_RETIRE = "PLAYER_RETIRE",
     ADMIN_GRANT = "ADMIN_GRANT",
     SEASON_REWARD = "SEASON_REWARD"
 }
-export type CurrencyTransactionSource = CurrencyTransactionSourceEnum.MATCH_REWARD | CurrencyTransactionSourceEnum.GACHA_PULL | CurrencyTransactionSourceEnum.COACH_UPGRADE | CurrencyTransactionSourceEnum.PLAYER_DISMISS | CurrencyTransactionSourceEnum.ADMIN_GRANT | CurrencyTransactionSourceEnum.SEASON_REWARD;
+export type CurrencyTransactionSource = CurrencyTransactionSourceEnum.MATCH_REWARD | CurrencyTransactionSourceEnum.GACHA_PULL | CurrencyTransactionSourceEnum.COACH_UPGRADE | CurrencyTransactionSourceEnum.PLAYER_DISMISS | CurrencyTransactionSourceEnum.PLAYER_RETIRE | CurrencyTransactionSourceEnum.ADMIN_GRANT | CurrencyTransactionSourceEnum.SEASON_REWARD;
 export interface CurrencyTransactionAttributes {
     transaction_id: string;
     user_id: string;

package/dist/esm/src/data/models/currency-transaction.js

@@ -10,6 +10,7 @@ export var CurrencyTransactionSourceEnum;
     CurrencyTransactionSourceEnum["GACHA_PULL"] = "GACHA_PULL";
     CurrencyTransactionSourceEnum["COACH_UPGRADE"] = "COACH_UPGRADE";
     CurrencyTransactionSourceEnum["PLAYER_DISMISS"] = "PLAYER_DISMISS";
+    CurrencyTransactionSourceEnum["PLAYER_RETIRE"] = "PLAYER_RETIRE";
     CurrencyTransactionSourceEnum["ADMIN_GRANT"] = "ADMIN_GRANT";
     CurrencyTransactionSourceEnum["SEASON_REWARD"] = "SEASON_REWARD";
 })(CurrencyTransactionSourceEnum || (CurrencyTransactionSourceEnum = {}));

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

@@ -1,7 +1,7 @@
 import * as Sequelize from 'sequelize';
 import { Model, Optional } from 'sequelize';
 import { PlayerId, TeamId, TeamModel } from '.';
-import { ConditionLogic, CourtPosition, EnergyBand, PinchCondition, RotationSystemEnum, SubBand, SubMode } from '../../service';
+import { ConditionLogic, CourtPosition, EnergyBand, LiberoSubMode, PinchCondition, RotationSystemEnum, SubBand, SubMode } from '../../service';
 export interface TacticsLineupAttributes {
     [CourtPosition.LIBERO_ZONE]?: PlayerId;
     [CourtPosition.LEFT_BACK]: PlayerId;
@@ -34,6 +34,13 @@ export interface OffensivePreferenceAttributes {
     rotation: number;
     order: PlayerId[];
 }
+export interface LiberoSetSubConfigAttributes {
+    mode: LiberoSubMode;
+    fatigueBand?: EnergyBand;
+}
+export interface LiberoSubConfigAttributes extends LiberoSetSubConfigAttributes {
+    sets?: LiberoSetSubConfigAttributes[];
+}
 export interface TacticsAttributes {
     team_id: string;
     substitution_tolerance: number;
@@ -43,13 +50,16 @@ export interface TacticsAttributes {
     receive_rotation_offset: boolean;
     designated_subs: DesignatedSubAttributes[];
     substitution_band: SubBand;
+    second_libero?: PlayerId;
+    libero_sub?: LiberoSubConfigAttributes;
+    libero_replacement_sets?: PlayerId[][];
     rotation_system: RotationSystemEnum;
     designated_setters: PlayerId[];
     offensive_preferences: OffensivePreferenceAttributes[];
 }
 export type TacticsPk = 'team_id';
 export type TacticsId = TacticsModel[TacticsPk];
-export type TacticsOptionalAttributes = 'substitution_tolerance' | 'lineup' | 'libero_replacements' | 'pinch_server_subs' | 'receive_rotation_offset' | 'designated_subs' | 'substitution_band' | 'rotation_system' | 'designated_setters' | 'offensive_preferences';
+export type TacticsOptionalAttributes = 'substitution_tolerance' | 'lineup' | 'libero_replacements' | 'pinch_server_subs' | 'receive_rotation_offset' | 'designated_subs' | 'substitution_band' | 'second_libero' | 'libero_sub' | 'libero_replacement_sets' | 'rotation_system' | 'designated_setters' | 'offensive_preferences';
 export type TacticsCreationAttributes = Optional<TacticsAttributes, TacticsOptionalAttributes>;
 export declare class TacticsModel extends Model<TacticsAttributes, TacticsCreationAttributes> implements TacticsAttributes {
     team_id: string;
@@ -60,6 +70,9 @@ export declare class TacticsModel extends Model<TacticsAttributes, TacticsCreati
     receive_rotation_offset: boolean;
     designated_subs: DesignatedSubAttributes[];
     substitution_band: SubBand;
+    second_libero?: PlayerId;
+    libero_sub?: LiberoSubConfigAttributes;
+    libero_replacement_sets?: PlayerId[][];
     rotation_system: RotationSystemEnum;
     designated_setters: PlayerId[];
     offensive_preferences: OffensivePreferenceAttributes[];

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

@@ -47,6 +47,18 @@ export class TacticsModel extends Model {
                 allowNull: false,
                 defaultValue: 'TIRED'
             },
+            second_libero: {
+                type: DataTypes.UUID,
+                allowNull: true
+            },
+            libero_sub: {
+                type: DataTypes.JSONB,
+                allowNull: true
+            },
+            libero_replacement_sets: {
+                type: DataTypes.JSONB,
+                allowNull: true
+            },
             rotation_system: {
                 type: DataTypes.STRING,
                 allowNull: false,

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

@@ -50,6 +50,9 @@ function transformToAttributes(tactics, teamId) {
         libero_replacements: tactics.liberoReplacements.map((lr) => lr.id),
         pinch_server_subs: Object.fromEntries([...tactics.pinchServerSubs].map(([k, v]) => [k.id, v.id])),
         substitution_band: tactics.substitutionBand,
+        second_libero: tactics.secondLibero?.id,
+        libero_sub: tactics.liberoSub,
+        libero_replacement_sets: tactics.liberoReplacementSets?.map(set => set.map((p) => p.id)),
         designated_subs: tactics.designatedSubs.map(ds => ({
             starterId: ds.starter.id,
             benchId: ds.bench?.id,
@@ -88,6 +91,9 @@ function transformToObject(model, roster) {
         liberoReplacements: model.libero_replacements.map((lr) => findPlayer(lr, roster)),
         pinchServerSubs: buildPinchServerSubs(model.pinch_server_subs, roster),
         substitutionBand: model.substitution_band,
+        secondLibero: model.second_libero != null ? findPlayer(model.second_libero, roster) : undefined,
+        liberoSub: model.libero_sub ?? undefined,
+        liberoReplacementSets: model.libero_replacement_sets?.map(set => set.map((id) => findPlayer(id, roster))),
         designatedSubs: (model.designated_subs ?? []).map(d => ({
             starter: findPlayer(d.starterId, roster),
             bench: d.benchId != null ? findPlayer(d.benchId, roster) : undefined,

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

@@ -6,6 +6,7 @@ export * from './team-name';
 export * from './energy-band';
 export * from './pinch-condition';
 export * from './designated-sub';
+export * from './libero-sub';
 export * from './rotation-system';
 export * from './lineup-function';
 export * from './base-position';

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

@@ -6,6 +6,7 @@ export * from './team-name';
 export * from './energy-band';
 export * from './pinch-condition';
 export * from './designated-sub';
+export * from './libero-sub';
 export * from './rotation-system';
 export * from './lineup-function';
 export * from './base-position';

package/dist/esm/src/service/team/libero-sub.d.ts

@@ -0,0 +1,9 @@
+import { EnergyBand } from './energy-band';
+export type LiberoSubMode = 'NEVER' | 'FATIGUE' | 'ALWAYS';
+export interface LiberoSetSubConfig {
+    readonly mode: LiberoSubMode;
+    readonly fatigueBand?: EnergyBand;
+}
+export interface LiberoSubConfig extends LiberoSetSubConfig {
+    readonly sets?: LiberoSetSubConfig[];
+}

package/dist/esm/src/service/team/libero-sub.js

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

package/dist/esm/src/service/team/schemas/libero-sub.z.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { EnergyBand } from '../energy-band';
+export declare const LiberoSubModeSchema: z.ZodEnum<{
+    NEVER: "NEVER";
+    FATIGUE: "FATIGUE";
+    ALWAYS: "ALWAYS";
+}>;
+export declare const LiberoSetSubConfigSchema: z.ZodObject<{
+    mode: z.ZodEnum<{
+        NEVER: "NEVER";
+        FATIGUE: "FATIGUE";
+        ALWAYS: "ALWAYS";
+    }>;
+    fatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
+}, z.core.$strip>;
+export declare const LiberoSubConfigSchema: z.ZodObject<{
+    sets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        mode: z.ZodEnum<{
+            NEVER: "NEVER";
+            FATIGUE: "FATIGUE";
+            ALWAYS: "ALWAYS";
+        }>;
+        fatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
+    }, z.core.$strip>>>;
+    mode: z.ZodEnum<{
+        NEVER: "NEVER";
+        FATIGUE: "FATIGUE";
+        ALWAYS: "ALWAYS";
+    }>;
+    fatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
+}, z.core.$strip>;

package/dist/esm/src/service/team/schemas/libero-sub.z.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import { EnergyBand } from '../energy-band';
+export const LiberoSubModeSchema = z.enum(['NEVER', 'FATIGUE', 'ALWAYS']);
+// Fields shared by the all-sets config and each per-set config. Unlike a designated sub there is no bench or
+// pinch condition here (the swapped-in player is always the dedicated `secondLibero`), so there is nothing to
+// cross-validate.
+const liberoSetSubConfigShape = {
+    mode: LiberoSubModeSchema,
+    // fatigue mode only (absent => the team default `substitutionBand`):
+    fatigueBand: z.nativeEnum(EnergyBand).optional()
+};
+export const LiberoSetSubConfigSchema = z.object(liberoSetSubConfigShape);
+export const LiberoSubConfigSchema = z.object({
+    ...liberoSetSubConfigShape,
+    // Optional per-set overrides (index 0 = set 1 ... index 4 = set 5); absent => the flat config for all sets.
+    sets: z.array(LiberoSetSubConfigSchema).max(5).optional()
+});

package/dist/esm/src/service/team/schemas/libero-sub.z.test.d.ts

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

package/dist/esm/src/service/team/schemas/libero-sub.z.test.js

@@ -0,0 +1,56 @@
+import { describe, it, expect } from '@jest/globals';
+import { LiberoSetSubConfigSchema, LiberoSubConfigSchema, LiberoSubModeSchema } from './libero-sub.z';
+import { EnergyBand } from '../energy-band';
+describe('LiberoSubModeSchema', () => {
+    it('accepts NEVER, FATIGUE and ALWAYS', () => {
+        for (const mode of ['NEVER', 'FATIGUE', 'ALWAYS']) {
+            expect(LiberoSubModeSchema.safeParse(mode).success).toBe(true);
+        }
+    });
+    it('rejects an unknown mode', () => {
+        expect(LiberoSubModeSchema.safeParse('SOMETIMES').success).toBe(false);
+    });
+});
+describe('LiberoSetSubConfigSchema', () => {
+    it('accepts a mode with no band', () => {
+        expect(LiberoSetSubConfigSchema.safeParse({ mode: 'ALWAYS' }).success).toBe(true);
+    });
+    it('accepts a fatigue mode with a band', () => {
+        expect(LiberoSetSubConfigSchema.safeParse({ mode: 'FATIGUE', fatigueBand: EnergyBand.TIRED }).success).toBe(true);
+    });
+    it('rejects an unknown band', () => {
+        expect(LiberoSetSubConfigSchema.safeParse({ mode: 'FATIGUE', fatigueBand: 'SLEEPY' }).success).toBe(false);
+    });
+});
+describe('LiberoSubConfigSchema', () => {
+    it('accepts a flat config with no per-set overrides', () => {
+        expect(LiberoSubConfigSchema.safeParse({ mode: 'FATIGUE', fatigueBand: EnergyBand.WORN }).success).toBe(true);
+    });
+    it('accepts up to five per-set configs', () => {
+        const res = LiberoSubConfigSchema.safeParse({
+            mode: 'NEVER',
+            sets: [
+                { mode: 'NEVER' },
+                { mode: 'ALWAYS' },
+                { mode: 'FATIGUE', fatigueBand: EnergyBand.TIRED },
+                { mode: 'NEVER' },
+                { mode: 'ALWAYS' }
+            ]
+        });
+        expect(res.success).toBe(true);
+    });
+    it('rejects more than five per-set configs', () => {
+        const res = LiberoSubConfigSchema.safeParse({
+            mode: 'NEVER',
+            sets: Array.from({ length: 6 }, () => ({ mode: 'NEVER' }))
+        });
+        expect(res.success).toBe(false);
+    });
+    it('rejects an unknown mode in a per-set config', () => {
+        const res = LiberoSubConfigSchema.safeParse({
+            mode: 'NEVER',
+            sets: [{ mode: 'WHENEVER' }]
+        });
+        expect(res.success).toBe(false);
+    });
+});

package/dist/esm/src/service/team/schemas/tactics.z.d.ts

@@ -91,6 +91,24 @@ export declare const TacticsInputSchema: z.ZodObject<{
         starter: z.ZodCustom<Player, Player>;
     }, z.core.$strip>>>;
     substitutionBand: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<typeof EnergyBand>, z.ZodLiteral<"NEVER">]>>;
+    secondLibero: z.ZodOptional<z.ZodCustom<Player, Player>>;
+    liberoSub: z.ZodOptional<z.ZodObject<{
+        sets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            mode: z.ZodEnum<{
+                NEVER: "NEVER";
+                FATIGUE: "FATIGUE";
+                ALWAYS: "ALWAYS";
+            }>;
+            fatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
+        }, z.core.$strip>>>;
+        mode: z.ZodEnum<{
+            NEVER: "NEVER";
+            FATIGUE: "FATIGUE";
+            ALWAYS: "ALWAYS";
+        }>;
+        fatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
+    }, z.core.$strip>>;
+    liberoReplacementSets: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodCustom<Player, Player>>>>;
     rotationSystem: z.ZodDefault<z.ZodEnum<typeof RotationSystemEnum>>;
     designatedSetters: z.ZodDefault<z.ZodArray<z.ZodCustom<Player, Player>>>;
     offensivePreferences: z.ZodDefault<z.ZodArray<z.ZodObject<{

package/dist/esm/src/service/team/schemas/tactics.z.js

@@ -3,6 +3,7 @@ import { Player } from '../../player';
 import { EnergyBand } from '../energy-band';
 import { RotationSystemEnum, setterCountFor } from '../rotation-system';
 import { DesignatedSubSchema, SubBandSchema } from './designated-sub.z';
+import { LiberoSubConfigSchema } from './libero-sub.z';
 const playerInstanceSchema = z.custom((v) => v instanceof Player, {
     message: 'INVALID_PLAYER_INSTANCE'
 });
@@ -61,6 +62,11 @@ export const TacticsInputSchema = z.object({
     // New (designated-subs feature). Defaults keep every existing Tactics.create({...}) call valid.
     designatedSubs: z.array(DesignatedSubSchema).default([]),
     substitutionBand: SubBandSchema.default(EnergyBand.TIRED),
+    // Second libero (L2). All optional => an unconfigured team behaves exactly as before. Cross-field rules
+    // (reserve-only, requires a libero, swap requires a second libero, per-set replacements are starters) below.
+    secondLibero: playerInstanceSchema.optional(),
+    liberoSub: LiberoSubConfigSchema.optional(),
+    liberoReplacementSets: z.array(z.array(playerInstanceSchema).max(2)).max(5).optional(),
     // Advanced tactics (rotation systems). Defaults (6-0 / no setters / no preferences) keep every existing
     // Tactics.create({...}) call valid and make an unconfigured team play exactly as before.
     rotationSystem: z.nativeEnum(RotationSystemEnum).default(RotationSystemEnum.SIX_ZERO),
@@ -120,4 +126,34 @@ export const TacticsInputSchema = z.object({
             }
         }
     }
+    // Second libero (L2). The second libero is a reserve (not a starter, the libero, or a bench player). A swap
+    // rule (FATIGUE/ALWAYS in any set) needs someone to swap in, so it requires a second libero, and a second
+    // libero needs a starting libero to replace ("no L2 without an L"). Per-set libero replacements, like the
+    // flat ones, are back-row court starters.
+    const libero = data.lineup[LIBERO_ZONE];
+    const inLineupIds = new Set([
+        ...starterIds,
+        ...(libero != null ? [libero.id] : []),
+        ...data.lineup.bench.map(p => p.id)
+    ]);
+    const liberoSubModes = data.liberoSub != null
+        ? [data.liberoSub.mode, ...(data.liberoSub.sets ?? []).map(s => s.mode)]
+        : [];
+    const wantsLiberoSwap = liberoSubModes.some(mode => mode !== 'NEVER');
+    if (wantsLiberoSwap && data.secondLibero == null) {
+        ctx.addIssue({ code: 'custom', message: 'LIBERO_SWAP_REQUIRES_SECOND_LIBERO', path: ['secondLibero'] });
+    }
+    if ((data.secondLibero != null || wantsLiberoSwap) && libero == null) {
+        ctx.addIssue({ code: 'custom', message: 'SECOND_LIBERO_REQUIRES_LIBERO', path: ['secondLibero'] });
+    }
+    if (data.secondLibero != null && inLineupIds.has(data.secondLibero.id)) {
+        ctx.addIssue({ code: 'custom', message: 'SECOND_LIBERO_MUST_BE_RESERVE', path: ['secondLibero'] });
+    }
+    for (const set of data.liberoReplacementSets ?? []) {
+        for (const player of set) {
+            if (!starterIds.has(player.id)) {
+                ctx.addIssue({ code: 'custom', message: 'LIBERO_REPLACEMENT_NOT_A_STARTER', path: ['liberoReplacementSets'] });
+            }
+        }
+    }
 });

package/dist/esm/src/service/team/schemas/tactics.z.test.d.ts

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

package/dist/esm/src/service/team/schemas/tactics.z.test.js

@@ -0,0 +1,71 @@
+import { describe, it, expect } from '@jest/globals';
+import { TacticsInputSchema } from './tactics.z';
+import { makeCountry, makePlayer } from '../../test-helpers';
+describe('TacticsInputSchema — second libero rules', () => {
+    const country = makeCountry();
+    const p1 = makePlayer(country);
+    const p2 = makePlayer(country);
+    const p3 = makePlayer(country);
+    const p4 = makePlayer(country);
+    const p5 = makePlayer(country);
+    const p6 = makePlayer(country);
+    const libero = makePlayer(country);
+    const reserve = makePlayer(country);
+    // A minimal valid TacticsInput (6-0, no setters needed). `overrides` adds the libero fields under test.
+    function baseInput(overrides = {}, withLibero = true) {
+        return {
+            lineup: {
+                4: p4,
+                3: p3,
+                2: p2,
+                5: p5,
+                6: p6,
+                1: p1,
+                ...(withLibero ? { 0: libero } : {}),
+                bench: []
+            },
+            substitutionTolerance: 1,
+            liberoReplacements: [],
+            pinchServerSubs: new Map(),
+            ...overrides
+        };
+    }
+    it('accepts an unconfigured team (no second libero, no liberoSub)', () => {
+        expect(TacticsInputSchema.safeParse(baseInput()).success).toBe(true);
+    });
+    it('accepts a reserve second libero with an ALWAYS swap and a starting libero', () => {
+        const res = TacticsInputSchema.safeParse(baseInput({
+            secondLibero: reserve,
+            liberoSub: { mode: 'ALWAYS' }
+        }));
+        expect(res.success).toBe(true);
+    });
+    it('rejects a swap rule with no second libero', () => {
+        const res = TacticsInputSchema.safeParse(baseInput({ liberoSub: { mode: 'ALWAYS' } }));
+        expect(res.success).toBe(false);
+        if (!res.success) {
+            expect(res.error.issues.some(issue => issue.message === 'LIBERO_SWAP_REQUIRES_SECOND_LIBERO')).toBe(true);
+        }
+    });
+    it('rejects a second libero with no starting libero', () => {
+        const res = TacticsInputSchema.safeParse(baseInput({ secondLibero: reserve }, false));
+        expect(res.success).toBe(false);
+        if (!res.success) {
+            expect(res.error.issues.some(issue => issue.message === 'SECOND_LIBERO_REQUIRES_LIBERO')).toBe(true);
+        }
+    });
+    it('rejects a second libero that is a starter (must be a reserve)', () => {
+        const res = TacticsInputSchema.safeParse(baseInput({ secondLibero: p1 }));
+        expect(res.success).toBe(false);
+        if (!res.success) {
+            expect(res.error.issues.some(issue => issue.message === 'SECOND_LIBERO_MUST_BE_RESERVE')).toBe(true);
+        }
+    });
+    it('rejects per-set libero replacements that are not court starters', () => {
+        const res = TacticsInputSchema.safeParse(baseInput({ liberoReplacementSets: [[reserve]] }));
+        expect(res.success).toBe(false);
+        if (!res.success) {
+            expect(res.error.issues.some(issue => issue.message === 'LIBERO_REPLACEMENT_NOT_A_STARTER')).toBe(true);
+        }
+    });
+});

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

@@ -99,6 +99,24 @@ export declare const TeamInputSchema: z.ZodObject<{
             starter: z.ZodCustom<Player, Player>;
         }, z.core.$strip>>>;
         substitutionBand: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<typeof import("..").EnergyBand>, z.ZodLiteral<"NEVER">]>>;
+        secondLibero: z.ZodOptional<z.ZodCustom<Player, Player>>;
+        liberoSub: z.ZodOptional<z.ZodObject<{
+            sets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                mode: z.ZodEnum<{
+                    NEVER: "NEVER";
+                    FATIGUE: "FATIGUE";
+                    ALWAYS: "ALWAYS";
+                }>;
+                fatigueBand: z.ZodOptional<z.ZodEnum<typeof import("..").EnergyBand>>;
+            }, z.core.$strip>>>;
+            mode: z.ZodEnum<{
+                NEVER: "NEVER";
+                FATIGUE: "FATIGUE";
+                ALWAYS: "ALWAYS";
+            }>;
+            fatigueBand: z.ZodOptional<z.ZodEnum<typeof import("..").EnergyBand>>;
+        }, z.core.$strip>>;
+        liberoReplacementSets: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodCustom<Player, Player>>>>;
         rotationSystem: z.ZodDefault<z.ZodEnum<typeof import("..").RotationSystemEnum>>;
         designatedSetters: z.ZodDefault<z.ZodArray<z.ZodCustom<Player, Player>>>;
         offensivePreferences: z.ZodDefault<z.ZodArray<z.ZodObject<{

package/dist/esm/src/service/team/tactics.d.ts

@@ -1,6 +1,7 @@
 import { CourtPosition } from '../match';
 import { Player } from '../player';
 import { DesignatedSub } from './designated-sub';
+import { LiberoSubConfig } from './libero-sub';
 import { SubBand } from './energy-band';
 import { RotationSystemEnum } from './rotation-system';
 import { OffensivePreference } from './offensive-preference';
@@ -22,6 +23,9 @@ export interface TacticsOpts {
     readonly receiveRotationOffset: boolean;
     readonly designatedSubs: DesignatedSub[];
     readonly substitutionBand: SubBand;
+    readonly secondLibero?: Player;
+    readonly liberoSub?: LiberoSubConfig;
+    readonly liberoReplacementSets?: Player[][];
     readonly rotationSystem: RotationSystemEnum;
     readonly designatedSetters: Player[];
     readonly offensivePreferences: OffensivePreference[];
@@ -34,6 +38,9 @@ export declare class Tactics {
     readonly receiveRotationOffset: boolean;
     readonly designatedSubs: DesignatedSub[];
     readonly substitutionBand: SubBand;
+    readonly secondLibero?: Player;
+    readonly liberoSub?: LiberoSubConfig;
+    readonly liberoReplacementSets?: Player[][];
     readonly rotationSystem: RotationSystemEnum;
     readonly designatedSetters: Player[];
     readonly offensivePreferences: OffensivePreference[];

package/dist/esm/src/service/team/tactics.js

@@ -15,7 +15,7 @@ export class Tactics {
         }
         return new Tactics(result.data);
     }
-    constructor({ lineup, pinchServerSubs, liberoReplacements, substitutionTolerance = 1, receiveRotationOffset = false, designatedSubs = [], substitutionBand = EnergyBand.TIRED, rotationSystem = RotationSystemEnum.SIX_ZERO, designatedSetters = [], offensivePreferences = [] }) {
+    constructor({ lineup, pinchServerSubs, liberoReplacements, substitutionTolerance = 1, receiveRotationOffset = false, designatedSubs = [], substitutionBand = EnergyBand.TIRED, secondLibero, liberoSub, liberoReplacementSets, rotationSystem = RotationSystemEnum.SIX_ZERO, designatedSetters = [], offensivePreferences = [] }) {
         this.lineup = lineup;
         this.substitutionTolerance = substitutionTolerance;
         this.pinchServerSubs = pinchServerSubs;
@@ -23,6 +23,9 @@ export class Tactics {
         this.receiveRotationOffset = receiveRotationOffset;
         this.designatedSubs = designatedSubs;
         this.substitutionBand = substitutionBand;
+        this.secondLibero = secondLibero;
+        this.liberoSub = liberoSub;
+        this.liberoReplacementSets = liberoReplacementSets;
         this.rotationSystem = rotationSystem;
         this.designatedSetters = designatedSetters;
         this.offensivePreferences = offensivePreferences;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "volleyballsimtypes",
-  "version": "0.0.400",
+  "version": "0.0.402",
   "description": "vbsim types",
   "main": "./dist/cjs/src/index.js",
   "module": "./dist/esm/src/index.js",