volleyballsimtypes 0.0.462 → 0.0.463

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

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

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

@@ -49,6 +49,7 @@ export type Match = Omit<DataProps<_Match>, 'sets' | 'homeTeam' | 'awayTeam' | '
     awayForm?: MatchForm[];
     isFriendly?: boolean;
     detailUnavailable?: boolean;
+    selectedPresetId?: string;
 };
 export type RallyEvent = DataProps<_RallyEvent> & {
     teamId?: string;
@@ -128,6 +129,7 @@ export interface ApiLineupPreset {
     orderIndex: number;
     config: Tactics;
 }
+export type ApiLineupPresetSummary = Omit<ApiLineupPreset, 'config'>;
 export type Team = Omit<DataProps<_Team>, 'roster' | '_rating' | 'rating' | 'tactics'> & {
     roster: Player[];
     rating: {

package/dist/esm/src/data/init-models.js

@@ -1,10 +1,11 @@
-import { AuthIdentityModel, AuthSessionModel, AuthUserModel, BoxScoreModel, CoachModel, ScoutModel, BoxScoreTotalsModel, CompetitionChampionModel, CurrencyTransactionModel, GachaPityModel, GachaPullHistoryModel, WishlistModel, UserSettingsModel, UserDeviceTokenModel, CompetitionMatchModel, CompetitionMVPModel, CompetitionModel, CompetitionStandingsMatchModel, CompetitionStandingsModel, CompetitionTeamsModel, CountryModel, DivisionModel, DivisionSeasonModel, IterationModel, LeagueModel, MatchModel, MatchRatingModel, MatchResultModel, MatchSetModel, PerformanceStatsModel, PlayerModel, PlayerImprovementLogModel, PlayerDeclineLogModel, PlayerTeamModel, RetiredPlayerModel, PromotionMatchModel, FriendlyModel, RegionQualifierModel, NationalCountryModel, RallyModel, TacticsModel, LineupPresetModel, TeamModel, TeamReplacementModel, UserCurrencyModel, UserPlayerProgressModel, UserPullGrantModel, UserTeamModel, VPERModel, NotificationModel, AppConfigModel, LegacyTeamFlagModel } from './models';
+import { AuthIdentityModel, AuthSessionModel, AuthUserModel, BoxScoreModel, CoachModel, ScoutModel, BoxScoreTotalsModel, CompetitionChampionModel, CurrencyTransactionModel, GachaPityModel, GachaPullHistoryModel, WishlistModel, UserSettingsModel, UserDeviceTokenModel, CompetitionMatchModel, CompetitionMVPModel, CompetitionModel, CompetitionStandingsMatchModel, CompetitionStandingsModel, CompetitionTeamsModel, CountryModel, DivisionModel, DivisionSeasonModel, IterationModel, LeagueModel, MatchModel, MatchRatingModel, MatchResultModel, MatchSetModel, PerformanceStatsModel, PlayerModel, PlayerImprovementLogModel, PlayerDeclineLogModel, PlayerTeamModel, RetiredPlayerModel, PromotionMatchModel, FriendlyModel, RegionQualifierModel, NationalCountryModel, RallyModel, TacticsModel, LineupPresetModel, MatchPresetModel, TeamModel, TeamReplacementModel, UserCurrencyModel, UserPlayerProgressModel, UserPullGrantModel, UserTeamModel, VPERModel, NotificationModel, AppConfigModel, LegacyTeamFlagModel } from './models';
 export function initModels(sequelize) {
     const Coach = CoachModel.initModel(sequelize);
     const Scout = ScoutModel.initModel(sequelize);
     const CurrencyTransaction = CurrencyTransactionModel.initModel(sequelize);
     const Tactics = TacticsModel.initModel(sequelize);
     const LineupPreset = LineupPresetModel.initModel(sequelize);
+    const MatchPreset = MatchPresetModel.initModel(sequelize);
     const AuthUser = AuthUserModel.initModel(sequelize);
     const UserCurrency = UserCurrencyModel.initModel(sequelize);
     const UserPlayerProgress = UserPlayerProgressModel.initModel(sequelize);
@@ -212,6 +213,13 @@ export function initModels(sequelize) {
     // simulator's team loads are unchanged (it reads the active config from the mirrored Tactics row).
     Team.hasMany(LineupPreset, { as: 'lineupPresets', foreignKey: 'team_id' });
     LineupPreset.belongsTo(Team, { as: 'team', foreignKey: 'team_id' });
+    // Per-match preset choices. Deliberately NOT part of any default scope: only the simulator's match query
+    // loads MatchPresets, so every other transformToMatch caller stays on the active-tactics path.
+    Match.hasMany(MatchPreset, { as: 'MatchPresets', foreignKey: 'match_id' });
+    MatchPreset.belongsTo(Match, { as: 'match', foreignKey: 'match_id' });
+    MatchPreset.belongsTo(Team, { as: 'team', foreignKey: 'team_id' });
+    MatchPreset.belongsTo(LineupPreset, { as: 'preset', foreignKey: 'preset_id' });
+    LineupPreset.hasMany(MatchPreset, { as: 'MatchPresets', foreignKey: 'preset_id' });
     Team.belongsTo(Country, { as: 'country', foreignKey: 'country_id' });
     Team.belongsToMany(Competition, {
         as: 'Competitions',
@@ -286,6 +294,7 @@ export function initModels(sequelize) {
         TeamReplacement,
         Tactics,
         LineupPreset,
+        MatchPreset,
         UserTeam,
         UserCurrency,
         UserPlayerProgress,

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

@@ -36,6 +36,7 @@ export * from './team';
 export * from './team-replacement';
 export * from './tactics';
 export * from './lineup-preset';
+export * from './match-preset';
 export * from './user-currency';
 export * from './user-player-progress';
 export * from './gacha-pity';

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

@@ -36,6 +36,7 @@ export * from './team';
 export * from './team-replacement';
 export * from './tactics';
 export * from './lineup-preset';
+export * from './match-preset';
 export * from './user-currency';
 export * from './user-player-progress';
 export * from './gacha-pity';

package/dist/esm/src/data/models/match-preset.d.ts

@@ -0,0 +1,28 @@
+import * as Sequelize from 'sequelize';
+import { Model } from 'sequelize';
+import { LineupPresetId, LineupPresetModel, MatchId, MatchModel, TeamId, TeamModel } from '.';
+export interface MatchPresetAttributes {
+    match_id: string;
+    team_id: string;
+    preset_id: string;
+}
+export type MatchPresetPk = 'match_id' | 'team_id';
+export type MatchPresetCreationAttributes = MatchPresetAttributes;
+export declare class MatchPresetModel extends Model<MatchPresetAttributes, MatchPresetCreationAttributes> implements MatchPresetAttributes {
+    match_id: string;
+    team_id: string;
+    preset_id: string;
+    match: MatchModel;
+    getMatch: Sequelize.BelongsToGetAssociationMixin<MatchModel>;
+    setMatch: Sequelize.BelongsToSetAssociationMixin<MatchModel, MatchId>;
+    createMatch: Sequelize.BelongsToCreateAssociationMixin<MatchModel>;
+    team: TeamModel;
+    getTeam: Sequelize.BelongsToGetAssociationMixin<TeamModel>;
+    setTeam: Sequelize.BelongsToSetAssociationMixin<TeamModel, TeamId>;
+    createTeam: Sequelize.BelongsToCreateAssociationMixin<TeamModel>;
+    preset: LineupPresetModel;
+    getPreset: Sequelize.BelongsToGetAssociationMixin<LineupPresetModel>;
+    setPreset: Sequelize.BelongsToSetAssociationMixin<LineupPresetModel, LineupPresetId>;
+    createPreset: Sequelize.BelongsToCreateAssociationMixin<LineupPresetModel>;
+    static initModel(sequelize: Sequelize.Sequelize): typeof MatchPresetModel;
+}

package/dist/esm/src/data/models/match-preset.js

@@ -0,0 +1,61 @@
+import { DataTypes, Model } from 'sequelize';
+export class MatchPresetModel extends Model {
+    static initModel(sequelize) {
+        return MatchPresetModel.init({
+            match_id: {
+                type: DataTypes.UUID,
+                allowNull: false,
+                primaryKey: true,
+                references: {
+                    model: 'Match',
+                    key: 'match_id'
+                }
+            },
+            team_id: {
+                type: DataTypes.UUID,
+                allowNull: false,
+                primaryKey: true,
+                references: {
+                    model: 'Team',
+                    key: 'team_id'
+                }
+            },
+            preset_id: {
+                type: DataTypes.UUID,
+                allowNull: false,
+                references: {
+                    model: 'LineupPreset',
+                    key: 'preset_id'
+                }
+            }
+        }, {
+            sequelize,
+            tableName: 'MatchPreset',
+            schema: 'public',
+            timestamps: false,
+            indexes: [
+                {
+                    name: 'MatchPreset_pk',
+                    unique: true,
+                    fields: [
+                        { name: 'match_id' },
+                        { name: 'team_id' }
+                    ]
+                },
+                {
+                    name: 'MatchPreset_team_id_idx',
+                    fields: [
+                        { name: 'team_id' }
+                    ]
+                },
+                {
+                    // Keeps the LineupPreset ON DELETE CASCADE cheap.
+                    name: 'MatchPreset_preset_id_idx',
+                    fields: [
+                        { name: 'preset_id' }
+                    ]
+                }
+            ]
+        });
+    }
+}

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

@@ -1,7 +1,7 @@
 import * as Sequelize from 'sequelize';
 import { Model } from 'sequelize';
 import { Status } from '../common';
-import { CompetitionMatchId, CompetitionMatchModel, MatchRatingId, MatchRatingModel, MatchResultId, MatchResultModel, MatchSetAttributes, MatchSetId, MatchSetModel, VPERAttributes, VPERId, VPERModel, TeamId, TeamModel } from '.';
+import { CompetitionMatchId, CompetitionMatchModel, MatchRatingId, MatchRatingModel, MatchResultId, MatchResultModel, MatchPresetModel, MatchSetAttributes, MatchSetId, MatchSetModel, VPERAttributes, VPERId, VPERModel, TeamId, TeamModel } from '.';
 import { MatchRallyAggregates } from '../../service';
 export interface MatchAttributes {
     match_id: string;
@@ -59,6 +59,7 @@ export declare class MatchModel extends Model<MatchAttributes, MatchCreationAttr
     hasVPER: Sequelize.HasManyHasAssociationMixin<VPERModel, VPERId>;
     hasVPERs: Sequelize.HasManyHasAssociationsMixin<VPERModel, VPERId>;
     countVPERs: Sequelize.HasManyCountAssociationsMixin;
+    MatchPresets?: MatchPresetModel[];
     MatchSets: MatchSetModel[];
     getMatchSets: Sequelize.HasManyGetAssociationsMixin<MatchSetModel>;
     setMatchSets: Sequelize.HasManySetAssociationsMixin<MatchSetModel, MatchSetId>;

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

@@ -23,7 +23,7 @@ function transformToObject(model) {
         subdivision: model.subdivision,
         leagueId: model.league_id,
         seasons: (model.DivisionSeasons ?? []).map((ds) => transformToSeason(ds.competition)),
-        teams: model.Teams != null ? model.Teams.map(transformToTeam) : undefined
+        teams: model.Teams != null ? model.Teams.map(team => transformToTeam(team)) : undefined
     });
 }
 export { transformToObject as transformToDivision, transformToAttributes as transformFromDivision };

package/dist/esm/src/data/transformers/match-preset-override.test.d.ts

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

package/dist/esm/src/data/transformers/match-preset-override.test.js

@@ -0,0 +1,273 @@
+import { describe, it, expect, jest } from '@jest/globals';
+import { v4 as uuidv4 } from 'uuid';
+import { apiTacticsConfigToTacticsAttributes, tacticsColumnsToApiDto, transformToTactics } from './tactics';
+import { transformToTeam } from './team';
+import { transformToMatch } from './match';
+import { CourtPosition, DeclineProfileEnum, RarityEnum, RoleEnum } from '../../service';
+// ─── shared mocks (model-shaped plain objects, cast through unknown) ──────────
+const countryFixture = {
+    country_id: uuidv4(),
+    name: 'Test Country',
+    alpha_2: 'TC',
+    alpha_3: 'TCN',
+    country_code: '999',
+    iso_3166_2: 'TC-TEST',
+    region: '',
+    region_code: '',
+    sub_region: '',
+    sub_region_code: '',
+    intermediate_region: '',
+    intermediate_region_code: ''
+};
+function makePlayerModel(id) {
+    const stat = 50;
+    return {
+        player_id: id,
+        first_name: 'Test',
+        last_name: `P-${id.slice(0, 4)}`,
+        rarity: RarityEnum.COMMON,
+        roles: [RoleEnum.OUTSIDE_HITTER],
+        traits: [],
+        birth_age: 18,
+        birth_iteration: 1,
+        last_declined_iteration: null,
+        decline_profile: DeclineProfileEnum.STANDARD,
+        BoxScores: [],
+        BoxScoreTotals: null,
+        country: countryFixture,
+        PerformanceStat: {
+            setting: stat,
+            serve: stat,
+            spike: stat,
+            quick: stat,
+            power: stat,
+            awareness: stat,
+            attack: stat,
+            back_attack: stat,
+            reception: stat,
+            overhand: stat,
+            bump: stat,
+            block: stat,
+            read: stat,
+            commit: stat,
+            focus: stat,
+            defense: stat,
+            stamina: stat,
+            reflex: stat
+        }
+    };
+}
+// Six starters; index order is the row lineup's zone 1..6 order.
+const ids = Array.from({ length: 6 }, () => uuidv4());
+const teamId = uuidv4();
+function rowLineup(order) {
+    return {
+        [CourtPosition.RIGHT_BACK]: order[0],
+        [CourtPosition.RIGHT_FRONT]: order[1],
+        [CourtPosition.MIDDLE_FRONT]: order[2],
+        [CourtPosition.LEFT_FRONT]: order[3],
+        [CourtPosition.LEFT_BACK]: order[4],
+        [CourtPosition.MIDDLE_BACK]: order[5],
+        bench: []
+    };
+}
+function makeTacticsRow(order) {
+    return {
+        team_id: teamId,
+        lineup: rowLineup(order),
+        libero_replacements: [],
+        receive_rotation_offset: false,
+        designated_subs: [],
+        substitution_band: 'TIRED',
+        rotation_system: '6-0',
+        designated_setters: [],
+        offensive_preferences: []
+    };
+}
+function makeTeamModel(activeOrder) {
+    return {
+        team_id: teamId,
+        name: 'Test Team',
+        short_name: 'TST',
+        rating: 0,
+        division_id: uuidv4(),
+        active: true,
+        country: countryFixture,
+        tactics: makeTacticsRow(activeOrder),
+        PlayerTeams: ids.map(id => ({ player: makePlayerModel(id) }))
+    };
+}
+// The API-DTO config for a preset whose starters are the REVERSE of the active order, so an applied
+// override is visible through the hydrated lineup.
+function makeConfig(order) {
+    return {
+        lineup: {
+            [CourtPosition.RIGHT_BACK]: order[0],
+            [CourtPosition.RIGHT_FRONT]: order[1],
+            [CourtPosition.MIDDLE_FRONT]: order[2],
+            [CourtPosition.LEFT_FRONT]: order[3],
+            [CourtPosition.LEFT_BACK]: order[4],
+            [CourtPosition.MIDDLE_BACK]: order[5],
+            bench: []
+        },
+        liberoReplacements: [],
+        receiveRotationOffset: false,
+        designatedSubs: [],
+        substitutionBand: 'TIRED',
+        rotationSystem: '6-0',
+        designatedSetters: [],
+        offensivePreferences: []
+    };
+}
+const activeOrder = ids;
+const presetOrder = [...ids].reverse();
+function starterAt(tactics, zone) {
+    return tactics.lineup[zone]?.id;
+}
+// ─── apiTacticsConfigToTacticsAttributes ──────────────────────────────────────
+describe('apiTacticsConfigToTacticsAttributes()', () => {
+    it('round-trips a fully-loaded Tactics row through tacticsColumnsToApiDto', () => {
+        const full = {
+            team_id: teamId,
+            lineup: { ...rowLineup(activeOrder), [CourtPosition.LIBERO_ZONE]: undefined },
+            libero_replacements: [ids[5]],
+            receive_rotation_offset: true,
+            designated_subs: [{ starterId: ids[0], benchId: undefined, mode: 'FATIGUE', fatigueBand: 'WORN', sets: [{ mode: 'NEVER' }] }],
+            substitution_band: 'TIRED',
+            second_libero: undefined,
+            libero_sub: undefined,
+            libero_replacement_sets: [[ids[0]], [ids[1]]],
+            rotation_system: '5-1',
+            designated_setters: [ids[0]],
+            offensive_preferences: [{ rotation: 1, order: [ids[1], ids[2]] }],
+            system_sets: [{ rotationSystem: '5-1', designatedSetters: [ids[0]] }],
+            offensive_preference_sets: [[{ rotation: 2, order: [ids[3]] }]]
+        };
+        const dto = tacticsColumnsToApiDto(full);
+        const back = apiTacticsConfigToTacticsAttributes(dto, teamId);
+        expect(back.lineup).toEqual(full.lineup);
+        expect(back.libero_replacements).toEqual(full.libero_replacements);
+        expect(back.receive_rotation_offset).toBe(true);
+        expect(back.designated_subs).toEqual(full.designated_subs);
+        expect(back.libero_replacement_sets).toEqual(full.libero_replacement_sets);
+        expect(back.rotation_system).toBe('5-1');
+        expect(back.designated_setters).toEqual(full.designated_setters);
+        expect(back.offensive_preferences).toEqual(full.offensive_preferences);
+        expect(back.system_sets).toEqual(full.system_sets);
+        expect(back.offensive_preference_sets).toEqual(full.offensive_preference_sets);
+    });
+    it('hydrates through transformToTactics identically to the row path', () => {
+        const roster = ids.map(id => transformToTeam(makeTeamModel(activeOrder)).roster.find(p => p.id === id));
+        expect(roster.every(p => p != null)).toBe(true);
+        const teamModel = makeTeamModel(activeOrder);
+        const players = transformToTeam(teamModel).roster;
+        const fromRow = transformToTactics(makeTacticsRow(activeOrder), players);
+        const fromConfig = transformToTactics(apiTacticsConfigToTacticsAttributes(makeConfig(activeOrder), teamId), players);
+        for (const zone of [1, 2, 3, 4, 5, 6]) {
+            expect(starterAt(fromConfig, zone)).toBe(starterAt(fromRow, zone));
+        }
+    });
+    it('throws PLAYER_NOT_FOUND when the config references an off-roster player', () => {
+        const players = transformToTeam(makeTeamModel(activeOrder)).roster;
+        const drifted = makeConfig([uuidv4(), ...ids.slice(1)]);
+        expect(() => transformToTactics(apiTacticsConfigToTacticsAttributes(drifted, teamId), players)).toThrow('PLAYER_NOT_FOUND');
+    });
+});
+// ─── transformToTeam override / fallback ──────────────────────────────────────
+describe('transformToTeam() tacticsOverride', () => {
+    it('uses the override config when it hydrates', () => {
+        const team = transformToTeam(makeTeamModel(activeOrder), undefined, {
+            presetId: 'preset-1',
+            config: makeConfig(presetOrder)
+        });
+        expect(starterAt(team.tactics, CourtPosition.RIGHT_BACK)).toBe(presetOrder[0]);
+    });
+    it('falls back to the active tactics and notifies onFallback when the override fails', () => {
+        const onFallback = jest.fn();
+        const drifted = makeConfig([uuidv4(), ...ids.slice(1)]);
+        const team = transformToTeam(makeTeamModel(activeOrder), undefined, {
+            presetId: 'preset-1',
+            config: drifted,
+            onFallback
+        });
+        expect(onFallback).toHaveBeenCalledTimes(1);
+        expect(onFallback.mock.calls[0][0]).toBe('preset-1');
+        expect(starterAt(team.tactics, CourtPosition.RIGHT_BACK)).toBe(activeOrder[0]);
+    });
+    it('keeps the active tactics when no override is given', () => {
+        const team = transformToTeam(makeTeamModel(activeOrder));
+        expect(starterAt(team.tactics, CourtPosition.RIGHT_BACK)).toBe(activeOrder[0]);
+    });
+});
+// ─── transformToMatch per-team override ───────────────────────────────────────
+describe('transformToMatch() MatchPresets', () => {
+    const awayIds = Array.from({ length: 6 }, () => uuidv4());
+    const awayTeamId = uuidv4();
+    function makeAwayModel() {
+        return {
+            team_id: awayTeamId,
+            name: 'Away Team',
+            short_name: 'AWY',
+            rating: 0,
+            division_id: uuidv4(),
+            active: true,
+            country: countryFixture,
+            tactics: {
+                team_id: awayTeamId,
+                lineup: {
+                    [CourtPosition.RIGHT_BACK]: awayIds[0],
+                    [CourtPosition.RIGHT_FRONT]: awayIds[1],
+                    [CourtPosition.MIDDLE_FRONT]: awayIds[2],
+                    [CourtPosition.LEFT_FRONT]: awayIds[3],
+                    [CourtPosition.LEFT_BACK]: awayIds[4],
+                    [CourtPosition.MIDDLE_BACK]: awayIds[5],
+                    bench: []
+                },
+                libero_replacements: [],
+                receive_rotation_offset: false,
+                designated_subs: [],
+                substitution_band: 'TIRED',
+                rotation_system: '6-0',
+                designated_setters: [],
+                offensive_preferences: []
+            },
+            PlayerTeams: awayIds.map(id => ({ player: makePlayerModel(id) }))
+        };
+    }
+    function makeMatchModel(withPreset) {
+        return {
+            match_id: uuidv4(),
+            home_team: teamId,
+            away_team: awayTeamId,
+            scheduled_date: new Date(),
+            status: 'PENDING',
+            HomeTeam: makeTeamModel(activeOrder),
+            AwayTeam: makeAwayModel(),
+            MatchSets: [],
+            VPERs: [],
+            MatchPresets: withPreset
+                ? [{ match_id: 'm', team_id: teamId, preset_id: 'preset-1', preset: { config: makeConfig(presetOrder) } }]
+                : undefined
+        };
+    }
+    it('applies the home override and leaves the away team on active tactics', () => {
+        const match = transformToMatch(makeMatchModel(true));
+        expect(starterAt(match.homeTeam.tactics, CourtPosition.RIGHT_BACK)).toBe(presetOrder[0]);
+        expect(starterAt(match.awayTeam.tactics, CourtPosition.RIGHT_BACK)).toBe(awayIds[0]);
+    });
+    it('behaves exactly as before when the association is absent', () => {
+        const match = transformToMatch(makeMatchModel(false));
+        expect(starterAt(match.homeTeam.tactics, CourtPosition.RIGHT_BACK)).toBe(activeOrder[0]);
+        expect(starterAt(match.awayTeam.tactics, CourtPosition.RIGHT_BACK)).toBe(awayIds[0]);
+    });
+    it('routes the fallback callback with the failing team id', () => {
+        const onPresetFallback = jest.fn();
+        const model = makeMatchModel(true);
+        model.MatchPresets[0].preset.config = makeConfig([uuidv4(), ...ids.slice(1)]);
+        const match = transformToMatch(model, undefined, onPresetFallback);
+        expect(onPresetFallback).toHaveBeenCalledTimes(1);
+        expect(onPresetFallback.mock.calls[0][0]).toBe(teamId);
+        expect(onPresetFallback.mock.calls[0][1]).toBe('preset-1');
+        expect(starterAt(match.homeTeam.tactics, CourtPosition.RIGHT_BACK)).toBe(activeOrder[0]);
+    });
+});

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

@@ -1,5 +1,6 @@
 import { MatchAttributes, MatchModel } from '../models';
 import { Match } from '../../service';
+export type PresetFallbackHandler = (teamId: string, presetId: string, err: unknown) => void;
 declare function transformToAttributes(match: Match): MatchAttributes;
-declare function transformToObject(model: MatchModel, currentIteration?: number): Match;
+declare function transformToObject(model: MatchModel, currentIteration?: number, onPresetFallback?: PresetFallbackHandler): Match;
 export { transformToObject as transformToMatch, transformToAttributes as transformFromMatch };

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

@@ -11,7 +11,19 @@ function transformToAttributes(match) {
         status: match.status
     };
 }
-function transformToObject(model, currentIteration) {
+function transformToObject(model, currentIteration, onPresetFallback) {
+    // The (match, team)-chosen preset override for one side, when the loader included MatchPresets with the
+    // preset loaded (only the simulator's match query does). Association absent = active tactics, as always.
+    const overrideFor = (teamId) => {
+        const row = (model.MatchPresets ?? []).find(mp => mp.team_id === teamId);
+        if (row?.preset == null)
+            return undefined;
+        return {
+            presetId: row.preset_id,
+            config: row.preset.config,
+            onFallback: (presetId, err) => onPresetFallback?.(teamId, presetId, err)
+        };
+    };
     const sets = (model.MatchSets ?? []).map(transformToMatchSet)
         .sort((s1, s2) => s1.order - s2.order);
     let homeScore = 0;
@@ -43,8 +55,8 @@ function transformToObject(model, currentIteration) {
     const VPERs = (model.VPERs ?? []).map(transformToVPER);
     return Match.create({
         id: model.match_id,
-        homeTeam: transformToTeam(model.HomeTeam, currentIteration),
-        awayTeam: transformToTeam(model.AwayTeam, currentIteration),
+        homeTeam: transformToTeam(model.HomeTeam, currentIteration, overrideFor(model.home_team)),
+        awayTeam: transformToTeam(model.AwayTeam, currentIteration, overrideFor(model.away_team)),
         scheduledDate: new Date(model.scheduled_date),
         sets,
         status: model.status,

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

@@ -40,7 +40,7 @@ function transformToObject(model) {
         id: model.competition_id,
         iteration: transformToIteration(model.Iteration),
         matches: (model.CompetitionMatches ?? []).map(transformToQualifierMatch),
-        teams: sortTeamsByCompetitionIndex(model.Teams ?? []).map(transformToTeam),
+        teams: sortTeamsByCompetitionIndex(model.Teams ?? []).map(team => transformToTeam(team)),
         status: model.status,
         region: transformToRegion(regionQualifier),
         champion

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

@@ -84,6 +84,8 @@ function transformToAttributes(tactics, teamId) {
         })))
     };
 }
+// 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
@@ -219,4 +221,37 @@ function tacticsColumnsToApiDto(model) {
         offensivePreferenceSets: model.offensive_preference_sets
     };
 }
-export { transformToObject as transformToTactics, transformToAttributes as transformFromTactics, tacticsColumnsToApiDto };
+// 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
+    };
+}
+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,