volleyballsimtypes 0.0.427 → 0.0.428

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

@@ -114,6 +114,13 @@ export interface Tactics {
     designatedSetters: string[];
     offensivePreferences: ApiOffensivePreference[];
 }
+export interface ApiLineupPreset {
+    presetId: string;
+    name: string;
+    isActive: boolean;
+    orderIndex: number;
+    config: Tactics;
+}
 export type Team = Omit<DataProps<_Team>, 'roster' | '_rating' | 'rating' | 'tactics'> & {
     roster: Player[];
     rating: {

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

@@ -7,6 +7,7 @@ function initModels(sequelize) {
     const Scout = models_1.ScoutModel.initModel(sequelize);
     const CurrencyTransaction = models_1.CurrencyTransactionModel.initModel(sequelize);
     const Tactics = models_1.TacticsModel.initModel(sequelize);
+    const LineupPreset = models_1.LineupPresetModel.initModel(sequelize);
     const AuthUser = models_1.AuthUserModel.initModel(sequelize);
     const UserCurrency = models_1.UserCurrencyModel.initModel(sequelize);
     const UserPlayerProgress = models_1.UserPlayerProgressModel.initModel(sequelize);
@@ -199,6 +200,10 @@ function initModels(sequelize) {
     Team.hasOne(Scout, { as: 'Scout', foreignKey: 'team_id' });
     Scout.belongsTo(Team, { as: 'team', foreignKey: 'team_id' });
     Team.hasOne(Tactics, { as: 'tactics', foreignKey: 'team_id' });
+    // Lineup presets are loaded only by the management API; deliberately NOT in Team.defaultScope so the
+    // 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' });
     Team.belongsTo(Country, { as: 'country', foreignKey: 'country_id' });
     Team.belongsToMany(Competition, {
         as: 'Competitions',
@@ -270,6 +275,7 @@ function initModels(sequelize) {
         Team,
         TeamReplacement,
         Tactics,
+        LineupPreset,
         UserTeam,
         UserCurrency,
         UserPlayerProgress,

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

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

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

@@ -49,6 +49,7 @@ __exportStar(require("./scout"), exports);
 __exportStar(require("./team"), exports);
 __exportStar(require("./team-replacement"), exports);
 __exportStar(require("./tactics"), exports);
+__exportStar(require("./lineup-preset"), exports);
 __exportStar(require("./user-currency"), exports);
 __exportStar(require("./user-player-progress"), exports);
 __exportStar(require("./gacha-pity"), exports);

package/dist/cjs/src/data/models/lineup-preset.d.ts

@@ -0,0 +1,29 @@
+import * as Sequelize from 'sequelize';
+import { Model, Optional } from 'sequelize';
+import { TeamId, TeamModel } from '.';
+import type { Tactics as ApiTactics } from '../../api';
+export interface LineupPresetAttributes {
+    preset_id: string;
+    team_id: string;
+    name: string;
+    is_active: boolean;
+    order_index: number;
+    config: ApiTactics;
+}
+export type LineupPresetPk = 'preset_id';
+export type LineupPresetId = LineupPresetModel[LineupPresetPk];
+export type LineupPresetOptionalAttributes = 'preset_id' | 'is_active';
+export type LineupPresetCreationAttributes = Optional<LineupPresetAttributes, LineupPresetOptionalAttributes>;
+export declare class LineupPresetModel extends Model<LineupPresetAttributes, LineupPresetCreationAttributes> implements LineupPresetAttributes {
+    preset_id: string;
+    team_id: string;
+    name: string;
+    is_active: boolean;
+    order_index: number;
+    config: ApiTactics;
+    team: TeamModel;
+    getTeam: Sequelize.BelongsToGetAssociationMixin<TeamModel>;
+    setTeam: Sequelize.BelongsToSetAssociationMixin<TeamModel, TeamId>;
+    createTeam: Sequelize.BelongsToCreateAssociationMixin<TeamModel>;
+    static initModel(sequelize: Sequelize.Sequelize): typeof LineupPresetModel;
+}

package/dist/cjs/src/data/models/lineup-preset.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LineupPresetModel = void 0;
+const sequelize_1 = require("sequelize");
+class LineupPresetModel extends sequelize_1.Model {
+    static initModel(sequelize) {
+        return LineupPresetModel.init({
+            preset_id: {
+                type: sequelize_1.DataTypes.UUID,
+                allowNull: false,
+                primaryKey: true,
+                defaultValue: sequelize_1.DataTypes.UUIDV4
+            },
+            team_id: {
+                type: sequelize_1.DataTypes.UUID,
+                allowNull: false,
+                references: {
+                    model: 'Team',
+                    key: 'team_id'
+                }
+            },
+            name: {
+                type: sequelize_1.DataTypes.STRING,
+                allowNull: false
+            },
+            is_active: {
+                type: sequelize_1.DataTypes.BOOLEAN,
+                allowNull: false,
+                defaultValue: false
+            },
+            order_index: {
+                type: sequelize_1.DataTypes.INTEGER,
+                allowNull: false
+            },
+            config: {
+                type: sequelize_1.DataTypes.JSONB,
+                allowNull: false
+            }
+        }, {
+            sequelize,
+            tableName: 'LineupPreset',
+            schema: 'public',
+            timestamps: false,
+            indexes: [
+                {
+                    name: 'LineupPreset_pk',
+                    unique: true,
+                    fields: [
+                        { name: 'preset_id' }
+                    ]
+                },
+                {
+                    name: 'LineupPreset_team_id_idx',
+                    fields: [
+                        { name: 'team_id' }
+                    ]
+                },
+                {
+                    // At most one active preset per team.
+                    name: 'LineupPreset_one_active_per_team',
+                    unique: true,
+                    fields: [
+                        { name: 'team_id' }
+                    ],
+                    where: { is_active: true }
+                }
+            ]
+        });
+    }
+}
+exports.LineupPresetModel = LineupPresetModel;

package/dist/cjs/src/data/transformers/index.d.ts

@@ -26,4 +26,5 @@ export * from './national';
 export * from './national-match';
 export * from './team';
 export * from './tactics';
+export * from './lineup-preset';
 export * from './vper';

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

@@ -42,4 +42,5 @@ __exportStar(require("./national"), exports);
 __exportStar(require("./national-match"), exports);
 __exportStar(require("./team"), exports);
 __exportStar(require("./tactics"), exports);
+__exportStar(require("./lineup-preset"), exports);
 __exportStar(require("./vper"), exports);

package/dist/cjs/src/data/transformers/lineup-preset.d.ts

@@ -0,0 +1,4 @@
+import { LineupPresetModel } from '../models';
+import type { ApiLineupPreset } from '../../api';
+declare function transformToObject(model: LineupPresetModel): ApiLineupPreset;
+export { transformToObject as transformToLineupPreset };

package/dist/cjs/src/data/transformers/lineup-preset.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transformToLineupPreset = transformToObject;
+// `config` is already stored as the API Tactics DTO, so a preset row maps to its API shape with no hydration.
+function transformToObject(model) {
+    return {
+        presetId: model.preset_id,
+        name: model.name,
+        isActive: model.is_active,
+        orderIndex: model.order_index,
+        config: model.config
+    };
+}

package/dist/cjs/src/data/transformers/lineup-preset.test.d.ts

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

package/dist/cjs/src/data/transformers/lineup-preset.test.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const lineup_preset_1 = require("./lineup-preset");
+(0, globals_1.describe)('transformToLineupPreset()', () => {
+    (0, globals_1.it)('maps preset columns to the API shape and passes config through by reference', () => {
+        const config = { lineup: { bench: [] }, substitutionBand: 'TIRED' };
+        const preset = (0, lineup_preset_1.transformToLineupPreset)({
+            preset_id: 'p1',
+            team_id: 't1',
+            name: 'Starters',
+            is_active: true,
+            order_index: 2,
+            config
+        });
+        (0, globals_1.expect)(preset).toEqual({
+            presetId: 'p1',
+            name: 'Starters',
+            isActive: true,
+            orderIndex: 2,
+            config
+        });
+        (0, globals_1.expect)(preset.config).toBe(config);
+    });
+});

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

@@ -1,5 +1,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;
-export { transformToObject as transformToTactics, transformToAttributes as transformFromTactics };
+declare function tacticsColumnsToApiDto(model: TacticsModel): ApiTactics;
+export { transformToObject as transformToTactics, transformToAttributes as transformFromTactics, tacticsColumnsToApiDto };

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

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.transformToTactics = transformToObject;
 exports.transformFromTactics = transformToAttributes;
+exports.tacticsColumnsToApiDto = tacticsColumnsToApiDto;
 const service_1 = require("../../service");
 // Back-compat: new rows persist `mode`; rows written before the mode change persist `isPinchServer` (+ a
 // 'NEVER' fatigueBand for the old "never fatigue-sub" state). Derive the mode so existing data keeps working
@@ -137,3 +138,40 @@ function transformToObject(model, roster) {
         }))
     });
 }
+// Serialize a Tactics ROW (db columns) straight to the API Tactics DTO (player references stay as ids; no
+// roster needed). Used to seed a lineup preset's `config` from the existing single tactics row (backfill) and
+// to keep the active preset and the mirrored Tactics row in the same shape. Applies the same legacy fixups as
+// the service transformer: resolve the designated-sub `mode` and drop a legacy 'NEVER' fatigueBand.
+function tacticsColumnsToApiDto(model) {
+    return {
+        lineup: model.lineup,
+        substitutionTolerance: model.substitution_tolerance,
+        liberoReplacements: model.libero_replacements,
+        pinchServerSubs: model.pinch_server_subs,
+        receiveRotationOffset: model.receive_rotation_offset,
+        substitutionBand: model.substitution_band,
+        secondLibero: model.second_libero,
+        liberoSub: model.libero_sub,
+        liberoReplacementSets: model.libero_replacement_sets,
+        designatedSubs: (model.designated_subs ?? []).map(d => ({
+            starterId: d.starterId,
+            benchId: d.benchId,
+            mode: subModeFromAttributes(d),
+            fatigueBand: d.fatigueBand === 'NEVER' ? undefined : d.fatigueBand,
+            benchFatigueBand: d.benchFatigueBand,
+            conditions: d.conditions,
+            conditionLogic: d.conditionLogic,
+            sets: d.sets?.map(s => ({
+                mode: s.mode,
+                benchId: s.benchId,
+                fatigueBand: s.fatigueBand,
+                benchFatigueBand: s.benchFatigueBand,
+                conditions: s.conditions,
+                conditionLogic: s.conditionLogic
+            }))
+        })),
+        rotationSystem: model.rotation_system,
+        designatedSetters: model.designated_setters,
+        offensivePreferences: model.offensive_preferences
+    };
+}

package/dist/cjs/src/data/transformers/tactics.test.d.ts

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

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

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const tactics_1 = require("./tactics");
+const service_1 = require("../../service");
+// Minimal TacticsModel-shaped object; cast through unknown since the transformer only reads columns.
+function makeTactics(designatedSubs) {
+    return {
+        team_id: 'team-1',
+        substitution_tolerance: 10,
+        lineup: {
+            [service_1.CourtPosition.LEFT_FRONT]: 'lf',
+            [service_1.CourtPosition.MIDDLE_FRONT]: 'mf',
+            [service_1.CourtPosition.RIGHT_FRONT]: 'rf',
+            [service_1.CourtPosition.LEFT_BACK]: 'lb',
+            [service_1.CourtPosition.MIDDLE_BACK]: 'mb',
+            [service_1.CourtPosition.RIGHT_BACK]: 'rb',
+            bench: ['b1', 'b2']
+        },
+        libero_replacements: ['lf'],
+        pinch_server_subs: { starter1: 'server1' },
+        receive_rotation_offset: true,
+        designated_subs: designatedSubs,
+        substitution_band: service_1.EnergyBand.TIRED,
+        second_libero: undefined,
+        libero_sub: undefined,
+        libero_replacement_sets: undefined,
+        rotation_system: '5-1',
+        designated_setters: ['lf'],
+        offensive_preferences: [{ rotation: 1, order: ['lf', 'rf'] }]
+    };
+}
+(0, globals_1.describe)('tacticsColumnsToApiDto()', () => {
+    (0, globals_1.it)('passes scalar/array columns through to the API DTO shape', () => {
+        const dto = (0, tactics_1.tacticsColumnsToApiDto)(makeTactics([]));
+        (0, globals_1.expect)(dto.substitutionTolerance).toBe(10);
+        (0, globals_1.expect)(dto.receiveRotationOffset).toBe(true);
+        (0, globals_1.expect)(dto.substitutionBand).toBe(service_1.EnergyBand.TIRED);
+        (0, globals_1.expect)(dto.rotationSystem).toBe('5-1');
+        (0, globals_1.expect)(dto.liberoReplacements).toEqual(['lf']);
+        (0, globals_1.expect)(dto.pinchServerSubs).toEqual({ starter1: 'server1' });
+        (0, globals_1.expect)(dto.lineup.bench).toEqual(['b1', 'b2']);
+        (0, globals_1.expect)(dto.offensivePreferences).toEqual([{ rotation: 1, order: ['lf', 'rf'] }]);
+    });
+    (0, globals_1.it)("resolves a legacy isPinchServer entry to mode 'PINCH'", () => {
+        const dto = (0, tactics_1.tacticsColumnsToApiDto)(makeTactics([
+            { starterId: 's1', benchId: 'b1', isPinchServer: true, conditions: [{ type: 'ASAP' }] }
+        ]));
+        (0, globals_1.expect)(dto.designatedSubs[0].mode).toBe('PINCH');
+    });
+    (0, globals_1.it)("resolves a legacy 'NEVER' fatigueBand to mode NEVER and drops the band", () => {
+        const dto = (0, tactics_1.tacticsColumnsToApiDto)(makeTactics([
+            { starterId: 's1', fatigueBand: 'NEVER' }
+        ]));
+        (0, globals_1.expect)(dto.designatedSubs[0].mode).toBe('NEVER');
+        (0, globals_1.expect)(dto.designatedSubs[0].fatigueBand).toBeUndefined();
+    });
+    (0, globals_1.it)('passes a fatigue entry with its own bands through unchanged', () => {
+        const dto = (0, tactics_1.tacticsColumnsToApiDto)(makeTactics([
+            { starterId: 's1', benchId: 'b1', mode: 'FATIGUE', fatigueBand: service_1.EnergyBand.WORN, benchFatigueBand: service_1.EnergyBand.TIRED }
+        ]));
+        (0, globals_1.expect)(dto.designatedSubs[0].mode).toBe('FATIGUE');
+        (0, globals_1.expect)(dto.designatedSubs[0].fatigueBand).toBe(service_1.EnergyBand.WORN);
+        (0, globals_1.expect)(dto.designatedSubs[0].benchFatigueBand).toBe(service_1.EnergyBand.TIRED);
+    });
+});

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

@@ -73,6 +73,25 @@ const test_helpers_1 = require("../../test-helpers");
         });
         (0, globals_1.expect)(res.success).toBe(true);
     });
+    (0, globals_1.it)("accepts a fatigue-mode entry with the substitute's own benchFatigueBand", () => {
+        const res = designated_sub_z_1.DesignatedSubSchema.safeParse({
+            starter,
+            bench,
+            mode: 'FATIGUE',
+            fatigueBand: energy_band_1.EnergyBand.WORN,
+            benchFatigueBand: energy_band_1.EnergyBand.TIRED
+        });
+        (0, globals_1.expect)(res.success).toBe(true);
+    });
+    (0, globals_1.it)('rejects benchFatigueBand = NEVER (only the team default band may be NEVER)', () => {
+        const res = designated_sub_z_1.DesignatedSubSchema.safeParse({
+            starter,
+            bench,
+            mode: 'FATIGUE',
+            benchFatigueBand: 'NEVER'
+        });
+        (0, globals_1.expect)(res.success).toBe(false);
+    });
     (0, globals_1.it)('accepts a fatigue-mode entry with no bench (falls back to closest sub)', () => {
         const res = designated_sub_z_1.DesignatedSubSchema.safeParse({
             starter,

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

@@ -114,6 +114,13 @@ export interface Tactics {
     designatedSetters: string[];
     offensivePreferences: ApiOffensivePreference[];
 }
+export interface ApiLineupPreset {
+    presetId: string;
+    name: string;
+    isActive: boolean;
+    orderIndex: number;
+    config: Tactics;
+}
 export type Team = Omit<DataProps<_Team>, 'roster' | '_rating' | 'rating' | 'tactics'> & {
     roster: Player[];
     rating: {

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

@@ -1,9 +1,10 @@
-import { AuthIdentityModel, AuthSessionModel, AuthUserModel, BoxScoreModel, CoachModel, ScoutModel, BoxScoreTotalsModel, CompetitionChampionModel, CurrencyTransactionModel, GachaPityModel, GachaPullHistoryModel, WishlistModel, UserSettingsModel, CompetitionMatchModel, CompetitionMVPModel, CompetitionModel, CompetitionStandingsMatchModel, CompetitionStandingsModel, CompetitionTeamsModel, CountryModel, DivisionModel, DivisionSeasonModel, IterationModel, LeagueModel, MatchModel, MatchRatingModel, MatchResultModel, MatchSetModel, PerformanceStatsModel, PlayerModel, PlayerImprovementLogModel, PlayerTeamModel, RetiredPlayerModel, PromotionMatchModel, RegionQualifierModel, NationalCountryModel, RallyModel, TacticsModel, 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, CompetitionMatchModel, CompetitionMVPModel, CompetitionModel, CompetitionStandingsMatchModel, CompetitionStandingsModel, CompetitionTeamsModel, CountryModel, DivisionModel, DivisionSeasonModel, IterationModel, LeagueModel, MatchModel, MatchRatingModel, MatchResultModel, MatchSetModel, PerformanceStatsModel, PlayerModel, PlayerImprovementLogModel, PlayerTeamModel, RetiredPlayerModel, PromotionMatchModel, RegionQualifierModel, NationalCountryModel, RallyModel, TacticsModel, LineupPresetModel, 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 AuthUser = AuthUserModel.initModel(sequelize);
     const UserCurrency = UserCurrencyModel.initModel(sequelize);
     const UserPlayerProgress = UserPlayerProgressModel.initModel(sequelize);
@@ -196,6 +197,10 @@ export function initModels(sequelize) {
     Team.hasOne(Scout, { as: 'Scout', foreignKey: 'team_id' });
     Scout.belongsTo(Team, { as: 'team', foreignKey: 'team_id' });
     Team.hasOne(Tactics, { as: 'tactics', foreignKey: 'team_id' });
+    // Lineup presets are loaded only by the management API; deliberately NOT in Team.defaultScope so the
+    // 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' });
     Team.belongsTo(Country, { as: 'country', foreignKey: 'country_id' });
     Team.belongsToMany(Competition, {
         as: 'Competitions',
@@ -267,6 +272,7 @@ export function initModels(sequelize) {
         Team,
         TeamReplacement,
         Tactics,
+        LineupPreset,
         UserTeam,
         UserCurrency,
         UserPlayerProgress,

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

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

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

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

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

@@ -0,0 +1,29 @@
+import * as Sequelize from 'sequelize';
+import { Model, Optional } from 'sequelize';
+import { TeamId, TeamModel } from '.';
+import type { Tactics as ApiTactics } from '../../api';
+export interface LineupPresetAttributes {
+    preset_id: string;
+    team_id: string;
+    name: string;
+    is_active: boolean;
+    order_index: number;
+    config: ApiTactics;
+}
+export type LineupPresetPk = 'preset_id';
+export type LineupPresetId = LineupPresetModel[LineupPresetPk];
+export type LineupPresetOptionalAttributes = 'preset_id' | 'is_active';
+export type LineupPresetCreationAttributes = Optional<LineupPresetAttributes, LineupPresetOptionalAttributes>;
+export declare class LineupPresetModel extends Model<LineupPresetAttributes, LineupPresetCreationAttributes> implements LineupPresetAttributes {
+    preset_id: string;
+    team_id: string;
+    name: string;
+    is_active: boolean;
+    order_index: number;
+    config: ApiTactics;
+    team: TeamModel;
+    getTeam: Sequelize.BelongsToGetAssociationMixin<TeamModel>;
+    setTeam: Sequelize.BelongsToSetAssociationMixin<TeamModel, TeamId>;
+    createTeam: Sequelize.BelongsToCreateAssociationMixin<TeamModel>;
+    static initModel(sequelize: Sequelize.Sequelize): typeof LineupPresetModel;
+}

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

@@ -0,0 +1,67 @@
+import { DataTypes, Model } from 'sequelize';
+export class LineupPresetModel extends Model {
+    static initModel(sequelize) {
+        return LineupPresetModel.init({
+            preset_id: {
+                type: DataTypes.UUID,
+                allowNull: false,
+                primaryKey: true,
+                defaultValue: DataTypes.UUIDV4
+            },
+            team_id: {
+                type: DataTypes.UUID,
+                allowNull: false,
+                references: {
+                    model: 'Team',
+                    key: 'team_id'
+                }
+            },
+            name: {
+                type: DataTypes.STRING,
+                allowNull: false
+            },
+            is_active: {
+                type: DataTypes.BOOLEAN,
+                allowNull: false,
+                defaultValue: false
+            },
+            order_index: {
+                type: DataTypes.INTEGER,
+                allowNull: false
+            },
+            config: {
+                type: DataTypes.JSONB,
+                allowNull: false
+            }
+        }, {
+            sequelize,
+            tableName: 'LineupPreset',
+            schema: 'public',
+            timestamps: false,
+            indexes: [
+                {
+                    name: 'LineupPreset_pk',
+                    unique: true,
+                    fields: [
+                        { name: 'preset_id' }
+                    ]
+                },
+                {
+                    name: 'LineupPreset_team_id_idx',
+                    fields: [
+                        { name: 'team_id' }
+                    ]
+                },
+                {
+                    // At most one active preset per team.
+                    name: 'LineupPreset_one_active_per_team',
+                    unique: true,
+                    fields: [
+                        { name: 'team_id' }
+                    ],
+                    where: { is_active: true }
+                }
+            ]
+        });
+    }
+}

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

@@ -26,4 +26,5 @@ export * from './national';
 export * from './national-match';
 export * from './team';
 export * from './tactics';
+export * from './lineup-preset';
 export * from './vper';

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

@@ -26,4 +26,5 @@ export * from './national';
 export * from './national-match';
 export * from './team';
 export * from './tactics';
+export * from './lineup-preset';
 export * from './vper';

package/dist/esm/src/data/transformers/lineup-preset.d.ts

@@ -0,0 +1,4 @@
+import { LineupPresetModel } from '../models';
+import type { ApiLineupPreset } from '../../api';
+declare function transformToObject(model: LineupPresetModel): ApiLineupPreset;
+export { transformToObject as transformToLineupPreset };

package/dist/esm/src/data/transformers/lineup-preset.js

@@ -0,0 +1,11 @@
+// `config` is already stored as the API Tactics DTO, so a preset row maps to its API shape with no hydration.
+function transformToObject(model) {
+    return {
+        presetId: model.preset_id,
+        name: model.name,
+        isActive: model.is_active,
+        orderIndex: model.order_index,
+        config: model.config
+    };
+}
+export { transformToObject as transformToLineupPreset };

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

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

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

@@ -0,0 +1,23 @@
+import { describe, it, expect } from '@jest/globals';
+import { transformToLineupPreset } from './lineup-preset';
+describe('transformToLineupPreset()', () => {
+    it('maps preset columns to the API shape and passes config through by reference', () => {
+        const config = { lineup: { bench: [] }, substitutionBand: 'TIRED' };
+        const preset = transformToLineupPreset({
+            preset_id: 'p1',
+            team_id: 't1',
+            name: 'Starters',
+            is_active: true,
+            order_index: 2,
+            config
+        });
+        expect(preset).toEqual({
+            presetId: 'p1',
+            name: 'Starters',
+            isActive: true,
+            orderIndex: 2,
+            config
+        });
+        expect(preset.config).toBe(config);
+    });
+});

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

@@ -1,5 +1,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;
-export { transformToObject as transformToTactics, transformToAttributes as transformFromTactics };
+declare function tacticsColumnsToApiDto(model: TacticsModel): ApiTactics;
+export { transformToObject as transformToTactics, transformToAttributes as transformFromTactics, tacticsColumnsToApiDto };

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

@@ -133,4 +133,41 @@ function transformToObject(model, roster) {
         }))
     });
 }
-export { transformToObject as transformToTactics, transformToAttributes as transformFromTactics };
+// Serialize a Tactics ROW (db columns) straight to the API Tactics DTO (player references stay as ids; no
+// roster needed). Used to seed a lineup preset's `config` from the existing single tactics row (backfill) and
+// to keep the active preset and the mirrored Tactics row in the same shape. Applies the same legacy fixups as
+// the service transformer: resolve the designated-sub `mode` and drop a legacy 'NEVER' fatigueBand.
+function tacticsColumnsToApiDto(model) {
+    return {
+        lineup: model.lineup,
+        substitutionTolerance: model.substitution_tolerance,
+        liberoReplacements: model.libero_replacements,
+        pinchServerSubs: model.pinch_server_subs,
+        receiveRotationOffset: model.receive_rotation_offset,
+        substitutionBand: model.substitution_band,
+        secondLibero: model.second_libero,
+        liberoSub: model.libero_sub,
+        liberoReplacementSets: model.libero_replacement_sets,
+        designatedSubs: (model.designated_subs ?? []).map(d => ({
+            starterId: d.starterId,
+            benchId: d.benchId,
+            mode: subModeFromAttributes(d),
+            fatigueBand: d.fatigueBand === 'NEVER' ? undefined : d.fatigueBand,
+            benchFatigueBand: d.benchFatigueBand,
+            conditions: d.conditions,
+            conditionLogic: d.conditionLogic,
+            sets: d.sets?.map(s => ({
+                mode: s.mode,
+                benchId: s.benchId,
+                fatigueBand: s.fatigueBand,
+                benchFatigueBand: s.benchFatigueBand,
+                conditions: s.conditions,
+                conditionLogic: s.conditionLogic
+            }))
+        })),
+        rotationSystem: model.rotation_system,
+        designatedSetters: model.designated_setters,
+        offensivePreferences: model.offensive_preferences
+    };
+}
+export { transformToObject as transformToTactics, transformToAttributes as transformFromTactics, tacticsColumnsToApiDto };

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

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

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

@@ -0,0 +1,64 @@
+import { describe, it, expect } from '@jest/globals';
+import { tacticsColumnsToApiDto } from './tactics';
+import { CourtPosition, EnergyBand } from '../../service';
+// Minimal TacticsModel-shaped object; cast through unknown since the transformer only reads columns.
+function makeTactics(designatedSubs) {
+    return {
+        team_id: 'team-1',
+        substitution_tolerance: 10,
+        lineup: {
+            [CourtPosition.LEFT_FRONT]: 'lf',
+            [CourtPosition.MIDDLE_FRONT]: 'mf',
+            [CourtPosition.RIGHT_FRONT]: 'rf',
+            [CourtPosition.LEFT_BACK]: 'lb',
+            [CourtPosition.MIDDLE_BACK]: 'mb',
+            [CourtPosition.RIGHT_BACK]: 'rb',
+            bench: ['b1', 'b2']
+        },
+        libero_replacements: ['lf'],
+        pinch_server_subs: { starter1: 'server1' },
+        receive_rotation_offset: true,
+        designated_subs: designatedSubs,
+        substitution_band: EnergyBand.TIRED,
+        second_libero: undefined,
+        libero_sub: undefined,
+        libero_replacement_sets: undefined,
+        rotation_system: '5-1',
+        designated_setters: ['lf'],
+        offensive_preferences: [{ rotation: 1, order: ['lf', 'rf'] }]
+    };
+}
+describe('tacticsColumnsToApiDto()', () => {
+    it('passes scalar/array columns through to the API DTO shape', () => {
+        const dto = tacticsColumnsToApiDto(makeTactics([]));
+        expect(dto.substitutionTolerance).toBe(10);
+        expect(dto.receiveRotationOffset).toBe(true);
+        expect(dto.substitutionBand).toBe(EnergyBand.TIRED);
+        expect(dto.rotationSystem).toBe('5-1');
+        expect(dto.liberoReplacements).toEqual(['lf']);
+        expect(dto.pinchServerSubs).toEqual({ starter1: 'server1' });
+        expect(dto.lineup.bench).toEqual(['b1', 'b2']);
+        expect(dto.offensivePreferences).toEqual([{ rotation: 1, order: ['lf', 'rf'] }]);
+    });
+    it("resolves a legacy isPinchServer entry to mode 'PINCH'", () => {
+        const dto = tacticsColumnsToApiDto(makeTactics([
+            { starterId: 's1', benchId: 'b1', isPinchServer: true, conditions: [{ type: 'ASAP' }] }
+        ]));
+        expect(dto.designatedSubs[0].mode).toBe('PINCH');
+    });
+    it("resolves a legacy 'NEVER' fatigueBand to mode NEVER and drops the band", () => {
+        const dto = tacticsColumnsToApiDto(makeTactics([
+            { starterId: 's1', fatigueBand: 'NEVER' }
+        ]));
+        expect(dto.designatedSubs[0].mode).toBe('NEVER');
+        expect(dto.designatedSubs[0].fatigueBand).toBeUndefined();
+    });
+    it('passes a fatigue entry with its own bands through unchanged', () => {
+        const dto = tacticsColumnsToApiDto(makeTactics([
+            { starterId: 's1', benchId: 'b1', mode: 'FATIGUE', fatigueBand: EnergyBand.WORN, benchFatigueBand: EnergyBand.TIRED }
+        ]));
+        expect(dto.designatedSubs[0].mode).toBe('FATIGUE');
+        expect(dto.designatedSubs[0].fatigueBand).toBe(EnergyBand.WORN);
+        expect(dto.designatedSubs[0].benchFatigueBand).toBe(EnergyBand.TIRED);
+    });
+});

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

@@ -71,6 +71,25 @@ describe('DesignatedSubSchema', () => {
         });
         expect(res.success).toBe(true);
     });
+    it("accepts a fatigue-mode entry with the substitute's own benchFatigueBand", () => {
+        const res = DesignatedSubSchema.safeParse({
+            starter,
+            bench,
+            mode: 'FATIGUE',
+            fatigueBand: EnergyBand.WORN,
+            benchFatigueBand: EnergyBand.TIRED
+        });
+        expect(res.success).toBe(true);
+    });
+    it('rejects benchFatigueBand = NEVER (only the team default band may be NEVER)', () => {
+        const res = DesignatedSubSchema.safeParse({
+            starter,
+            bench,
+            mode: 'FATIGUE',
+            benchFatigueBand: 'NEVER'
+        });
+        expect(res.success).toBe(false);
+    });
     it('accepts a fatigue-mode entry with no bench (falls back to closest sub)', () => {
         const res = DesignatedSubSchema.safeParse({
             starter,

package/package.json

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