volleyballsimtypes 0.0.365 → 0.0.366

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

@@ -10,7 +10,9 @@ export interface PlayerAttributes {
     first_name: string;
     last_name: string;
     country_id: string;
-    age: number;
+    birth_age: number;
+    birth_iteration: number;
+    last_declined_iteration: number | null;
     decline_profile: DeclineProfile;
     PerformanceStat?: PerformanceStatsAttributes;
     BoxScores?: BoxScoreAttributes[];
@@ -26,7 +28,9 @@ export declare class PlayerModel extends Model<PlayerAttributes, PlayerCreationA
     first_name: string;
     last_name: string;
     country_id: string;
-    age: number;
+    birth_age: number;
+    birth_iteration: number;
+    last_declined_iteration: number | null;
     decline_profile: DeclineProfile;
     country: CountryModel;
     getCountry: Sequelize.BelongsToGetAssociationMixin<CountryModel>;

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

@@ -40,11 +40,20 @@ class PlayerModel extends sequelize_1.Model {
                     key: 'country_id'
                 }
             },
-            age: {
+            birth_age: {
                 type: sequelize_1.DataTypes.INTEGER,
                 allowNull: false,
                 defaultValue: 17
             },
+            birth_iteration: {
+                type: sequelize_1.DataTypes.INTEGER,
+                allowNull: false,
+                defaultValue: 1
+            },
+            last_declined_iteration: {
+                type: sequelize_1.DataTypes.INTEGER,
+                allowNull: true
+            },
             decline_profile: {
                 type: sequelize_1.DataTypes.ENUM(...Object.values(service_1.DeclineProfileEnum)),
                 allowNull: false,

package/dist/cjs/src/data/models/retired-player.d.ts

@@ -3,7 +3,6 @@ import { Model } from 'sequelize';
 import { PlayerId, PlayerModel, TeamId, TeamModel } from '.';
 export interface RetiredPlayerAttributes {
     player_id: string;
-    user_id: string;
     team_id: string;
     retired_iteration: number;
 }
@@ -12,7 +11,6 @@ export type RetiredPlayerId = RetiredPlayerModel[RetiredPlayerPk];
 export type RetiredPlayerCreationAttributes = RetiredPlayerAttributes;
 export declare class RetiredPlayerModel extends Model<RetiredPlayerAttributes, RetiredPlayerCreationAttributes> implements RetiredPlayerAttributes {
     player_id: string;
-    user_id: string;
     team_id: string;
     retired_iteration: number;
     player: PlayerModel;

package/dist/cjs/src/data/models/retired-player.js

@@ -14,14 +14,6 @@ class RetiredPlayerModel extends sequelize_1.Model {
                     key: 'player_id'
                 }
             },
-            user_id: {
-                type: sequelize_1.DataTypes.UUID,
-                allowNull: false,
-                references: {
-                    model: 'AuthUser',
-                    key: 'user_id'
-                }
-            },
             team_id: {
                 type: sequelize_1.DataTypes.UUID,
                 allowNull: false,
@@ -39,11 +31,17 @@ class RetiredPlayerModel extends sequelize_1.Model {
             tableName: 'RetiredPlayer',
             schema: 'public',
             timestamps: false,
-            indexes: [{
+            indexes: [
+                {
                     name: 'RetiredPlayer_pk',
                     unique: true,
                     fields: [{ name: 'player_id' }]
-                }]
+                },
+                {
+                    name: 'RetiredPlayer_team_id_idx',
+                    fields: [{ name: 'team_id' }]
+                }
+            ]
         });
     }
 }

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

@@ -1,5 +1,5 @@
 import { MatchAttributes, MatchModel } from '../models';
 import { Match } from '../../service';
 declare function transformToAttributes(match: Match): MatchAttributes;
-declare function transformToObject(model: MatchModel): Match;
+declare function transformToObject(model: MatchModel, currentIteration?: number): Match;
 export { transformToObject as transformToMatch, transformToAttributes as transformFromMatch };

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

@@ -15,7 +15,7 @@ function transformToAttributes(match) {
         status: match.status
     };
 }
-function transformToObject(model) {
+function transformToObject(model, currentIteration) {
     const sets = (model.MatchSets ?? []).map(match_set_1.transformToMatchSet)
         .sort((s1, s2) => s1.order - s2.order);
     let homeScore = 0;
@@ -47,14 +47,14 @@ function transformToObject(model) {
     const VPERs = (model.VPERs ?? []).map(vper_1.transformToVPER);
     return service_1.Match.create({
         id: model.match_id,
-        homeTeam: (0, team_1.transformToTeam)(model.HomeTeam),
-        awayTeam: (0, team_1.transformToTeam)(model.AwayTeam),
+        homeTeam: (0, team_1.transformToTeam)(model.HomeTeam, currentIteration),
+        awayTeam: (0, team_1.transformToTeam)(model.AwayTeam, currentIteration),
         scheduledDate: new Date(model.scheduled_date),
         sets,
         status: model.status,
         VPERs,
         homeScore,
         awayScore,
-        winner: model.MatchResult?.Winner != null ? (0, team_1.transformToTeam)(model.MatchResult.Winner) : undefined
+        winner: model.MatchResult?.Winner != null ? (0, team_1.transformToTeam)(model.MatchResult.Winner, currentIteration) : undefined
     });
 }

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

@@ -1,5 +1,5 @@
 import { PlayerAttributes, PlayerModel } from '../models';
 import { Player } from '../../service';
 declare function transformToAttributes(player: Player): PlayerAttributes;
-declare function transformToObject(model: PlayerModel): Player;
+declare function transformToObject(model: PlayerModel, currentIteration?: number): Player;
 export { transformToObject as transformToPlayer, transformToAttributes as transformFromPlayer };

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

@@ -21,7 +21,9 @@ function transformToAttributes(player) {
         traits: player.traits,
         PerformanceStat: (0, _1.transformFromPerformanceStats)(player.stats, player.id),
         rarity: player.rarity,
-        age: player.age,
+        birth_age: player.birthAge,
+        birth_iteration: player.birthIteration,
+        last_declined_iteration: null,
         decline_profile: player.declineProfile
     };
 }
@@ -68,8 +70,10 @@ function transformToBoxScoreTotals(model) {
         }
     };
 }
-function transformToObject(model) {
+function transformToObject(model, currentIteration) {
     const boxScoreTotals = model.BoxScoreTotals != null ? transformToBoxScoreTotals(model.BoxScoreTotals) : undefined;
+    // When currentIteration is not provided, fall back to birth_iteration so age = birthAge.
+    const iter = currentIteration ?? model.birth_iteration;
     return service_1.Player.create({
         id: model.player_id,
         name: {
@@ -81,7 +85,9 @@ function transformToObject(model) {
         traits: model.traits,
         stats: (0, _1.transformToPerformanceStats)(model.PerformanceStat),
         rarity: model.rarity,
-        age: model.age,
+        age: model.birth_age + (iter - model.birth_iteration),
+        birthAge: model.birth_age,
+        birthIteration: model.birth_iteration,
         declineProfile: model.decline_profile,
         boxScores: (model.BoxScores ?? []).map(_1.transformToBoxScore),
         boxScoreTotals

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

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

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

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const uuid_1 = require("uuid");
+const player_1 = require("./player");
+const service_1 = require("../../service");
+// ─── shared mock ──────────────────────────────────────────────────────────────
+/** Minimal PlayerModel-shaped object for transformer tests.
+ *  Uses 'as unknown as PlayerModel' because Sequelize model instances carry
+ *  internal state we don't need; plain objects are sufficient for unit testing. */
+function makeModel(birthAge, birthIteration) {
+    const stat = 50;
+    return {
+        player_id: (0, uuid_1.v4)(),
+        first_name: 'Test',
+        last_name: 'Player',
+        rarity: service_1.RarityEnum.COMMON,
+        roles: [service_1.RoleEnum.OUTSIDE_HITTER],
+        traits: [],
+        birth_age: birthAge,
+        birth_iteration: birthIteration,
+        last_declined_iteration: null,
+        decline_profile: service_1.DeclineProfileEnum.STANDARD,
+        BoxScores: [],
+        BoxScoreTotals: null,
+        country: {
+            country_id: (0, uuid_1.v4)(),
+            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: ''
+        },
+        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
+        }
+    };
+}
+// ─── transformToPlayer ────────────────────────────────────────────────────────
+(0, globals_1.describe)('transformToPlayer()', () => {
+    (0, globals_1.describe)('age computation', () => {
+        (0, globals_1.it)('computes age as birthAge + (currentIteration - birthIteration)', () => {
+            const model = makeModel(17, 1);
+            const player = (0, player_1.transformToPlayer)(model, 10);
+            (0, globals_1.expect)(player.age).toBe(17 + (10 - 1)); // 26
+        });
+        (0, globals_1.it)('age equals birthAge when currentIteration equals birthIteration', () => {
+            const model = makeModel(18, 5);
+            const player = (0, player_1.transformToPlayer)(model, 5);
+            (0, globals_1.expect)(player.age).toBe(18);
+        });
+        (0, globals_1.it)('falls back to birthAge when currentIteration is omitted', () => {
+            const model = makeModel(19, 3);
+            const player = (0, player_1.transformToPlayer)(model);
+            (0, globals_1.expect)(player.age).toBe(19); // iter defaults to birth_iteration → offset = 0
+        });
+        (0, globals_1.it)('handles a large iteration gap correctly', () => {
+            const model = makeModel(15, 1);
+            const player = (0, player_1.transformToPlayer)(model, 53);
+            (0, globals_1.expect)(player.age).toBe(15 + 52); // 67
+        });
+    });
+    (0, globals_1.describe)('birthAge and birthIteration passthrough', () => {
+        (0, globals_1.it)('stores birthAge from birth_age', () => {
+            const model = makeModel(20, 1);
+            (0, globals_1.expect)((0, player_1.transformToPlayer)(model, 1).birthAge).toBe(20);
+        });
+        (0, globals_1.it)('stores birthIteration from birth_iteration', () => {
+            const model = makeModel(16, 4);
+            (0, globals_1.expect)((0, player_1.transformToPlayer)(model, 4).birthIteration).toBe(4);
+        });
+        (0, globals_1.it)('age, birthAge, and birthIteration are mutually consistent', () => {
+            const birthAge = 17;
+            const birthIteration = 2;
+            const currentIteration = 15;
+            const model = makeModel(birthAge, birthIteration);
+            const player = (0, player_1.transformToPlayer)(model, currentIteration);
+            (0, globals_1.expect)(player.age).toBe(player.birthAge + (currentIteration - player.birthIteration));
+        });
+    });
+});
+// ─── transformFromPlayer ──────────────────────────────────────────────────────
+(0, globals_1.describe)('transformFromPlayer()', () => {
+    (0, globals_1.it)('writes birth_iteration from player.birthIteration', () => {
+        const model = makeModel(17, 3);
+        const player = (0, player_1.transformToPlayer)(model, 3);
+        const attrs = (0, player_1.transformFromPlayer)(player);
+        (0, globals_1.expect)(attrs.birth_iteration).toBe(3);
+    });
+    (0, globals_1.it)('writes birth_age from player.birthAge', () => {
+        const model = makeModel(19, 1);
+        const player = (0, player_1.transformToPlayer)(model, 1);
+        const attrs = (0, player_1.transformFromPlayer)(player);
+        (0, globals_1.expect)(attrs.birth_age).toBe(19);
+    });
+    (0, globals_1.it)('sets last_declined_iteration to null for new players', () => {
+        const model = makeModel(17, 1);
+        const player = (0, player_1.transformToPlayer)(model, 1);
+        const attrs = (0, player_1.transformFromPlayer)(player);
+        (0, globals_1.expect)(attrs.last_declined_iteration).toBeNull();
+    });
+    (0, globals_1.it)('does not write an age column (age is derived, not stored)', () => {
+        const model = makeModel(17, 1);
+        const player = (0, player_1.transformToPlayer)(model, 1);
+        const attrs = (0, player_1.transformFromPlayer)(player);
+        (0, globals_1.expect)('age' in attrs).toBe(false);
+    });
+});

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

@@ -1,5 +1,5 @@
 import { Team } from '../../service';
 import { TeamAttributes, TeamModel } from '../models';
 declare function transformToAttributes(team: Team): TeamAttributes;
-declare function transformToObject(model: TeamModel): Team;
+declare function transformToObject(model: TeamModel, currentIteration?: number): Team;
 export { transformToObject as transformToTeam, transformToAttributes as transformFromTeam };

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

@@ -16,8 +16,8 @@ function transformToAttributes(team) {
         division_id: team.divisionId
     };
 }
-function transformToObject(model) {
-    const roster = (model.PlayerTeams ?? []).map((pt) => (0, _1.transformToPlayer)(pt.player));
+function transformToObject(model, currentIteration) {
+    const roster = (model.PlayerTeams ?? []).map((pt) => (0, _1.transformToPlayer)(pt.player, currentIteration));
     const tactics = model.tactics != null && roster != null && roster.length > 0
         ? (0, _1.transformToTactics)(model.tactics, roster)
         : undefined;

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

@@ -30,7 +30,7 @@ export declare function rollRarity(pity: PityState, config?: GachaPullConfig): R
 export declare class PlayerGenerator {
     private constructor();
     private static generatePerformance;
-    static generatePlayer(country: Country, _rarity?: Rarity, role?: Role, maxTraits?: boolean): Player;
+    static generatePlayer(country: Country, _rarity?: Rarity, role?: Role, maxTraits?: boolean, birthIteration?: number): Player;
     static generatePlayers(count: number, countries: Country[]): Player[];
 }
 export declare function pickPlayerCountry(teamCountry: Country, allCountries: Country[]): Country;

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

@@ -213,15 +213,15 @@ class PlayerGenerator {
             }
         }
     }
-    static generatePlayer(country, _rarity, role, maxTraits) {
+    static generatePlayer(country, _rarity, role, maxTraits, birthIteration = 1) {
         const rarity = _rarity ?? rollRarity({ legendaryPity: 0, mythicPity: 0, specialPity: 0 }).rarity;
         const name = (0, utils_1.generatePlayerName)(country.locales, 1)[0];
         const stats = PlayerGenerator.generatePerformance(rarity, role);
         const roles = (0, role_1.assignRoles)(stats, rarity);
         const traits = (0, trait_1.assignTraits)(roles, rarity, maxTraits);
-        const age = (0, node_crypto_1.randomInt)(15, 21);
+        const birthAge = (0, node_crypto_1.randomInt)(15, 21);
         const declineProfile = decline_1.declineProfiles[(0, node_crypto_1.randomInt)(0, decline_1.declineProfiles.length)];
-        return player_1.Player.create({ id: (0, uuid_1.v4)(), name, country, stats, roles, traits, rarity, age, declineProfile });
+        return player_1.Player.create({ id: (0, uuid_1.v4)(), name, country, stats, roles, traits, rarity, age: birthAge, birthAge, birthIteration, declineProfile });
     }
     static generatePlayers(count, countries) {
         const players = [];

package/dist/cjs/src/service/player/player.d.ts

@@ -32,6 +32,8 @@ export declare class Player {
     readonly generalStats: Stat[];
     readonly rarity: Rarity;
     readonly age: number;
+    readonly birthAge: number;
+    readonly birthIteration: number;
     readonly declineProfile: DeclineProfile;
     readonly boxScores?: BoxScore[];
     readonly boxScoreTotals?: BoxScoreTotals;

package/dist/cjs/src/service/player/player.js

@@ -54,7 +54,7 @@ class Player {
             stats: performance_stats_1.PerformanceStats.create(result.data.stats)
         });
     }
-    constructor({ id, name, country, stats, roles, traits, rarity, age, declineProfile, boxScores, boxScoreTotals }) {
+    constructor({ id, name, country, stats, roles, traits, rarity, age, birthAge, birthIteration, declineProfile, boxScores, boxScoreTotals }) {
         this.id = id;
         this.name = name;
         this.country = country;
@@ -63,6 +63,8 @@ class Player {
         this.traits = traits;
         this.rarity = rarity;
         this.age = age;
+        this.birthAge = birthAge;
+        this.birthIteration = birthIteration;
         this.declineProfile = declineProfile;
         this.boxScores = boxScores;
         this.boxScoreTotals = boxScoreTotals;

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

@@ -61,6 +61,8 @@ export declare const PlayerInputSchema: z.ZodObject<{
         SPECIAL: RarityEnum.SPECIAL;
     }>;
     age: z.ZodNumber;
+    birthAge: z.ZodNumber;
+    birthIteration: z.ZodNumber;
     declineProfile: z.ZodEnum<{
         PRODIGY: DeclineProfileEnum.PRODIGY;
         STANDARD: DeclineProfileEnum.STANDARD;

package/dist/cjs/src/service/player/schemas/player.z.js

@@ -34,6 +34,8 @@ exports.PlayerInputSchema = zod_1.z.object({
     traits: zod_1.z.array(zod_1.z.enum(Object.values(trait_1.TraitEnum))),
     rarity: zod_1.z.enum(Object.values(rarity_1.RarityEnum)),
     age: zod_1.z.number().int().min(0),
+    birthAge: zod_1.z.number().int().min(0),
+    birthIteration: zod_1.z.number().int().min(1),
     declineProfile: zod_1.z.enum(Object.values(decline_1.DeclineProfileEnum)),
     boxScores: zod_1.z.array(box_score_z_1.BoxScoreInputSchema).optional(),
     boxScoreTotals: BoxScoreTotalsInputSchema.optional()

package/dist/cjs/src/service/test-helpers.js

@@ -46,6 +46,8 @@ function makePlayer(country, statValue = 50) {
         traits: [],
         rarity: rarity_1.RarityEnum.COMMON,
         age: 20,
+        birthAge: 20,
+        birthIteration: 1,
         declineProfile: decline_1.DeclineProfileEnum.STANDARD
     });
 }

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

@@ -10,7 +10,9 @@ export interface PlayerAttributes {
     first_name: string;
     last_name: string;
     country_id: string;
-    age: number;
+    birth_age: number;
+    birth_iteration: number;
+    last_declined_iteration: number | null;
     decline_profile: DeclineProfile;
     PerformanceStat?: PerformanceStatsAttributes;
     BoxScores?: BoxScoreAttributes[];
@@ -26,7 +28,9 @@ export declare class PlayerModel extends Model<PlayerAttributes, PlayerCreationA
     first_name: string;
     last_name: string;
     country_id: string;
-    age: number;
+    birth_age: number;
+    birth_iteration: number;
+    last_declined_iteration: number | null;
     decline_profile: DeclineProfile;
     country: CountryModel;
     getCountry: Sequelize.BelongsToGetAssociationMixin<CountryModel>;

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

@@ -37,11 +37,20 @@ export class PlayerModel extends Model {
                     key: 'country_id'
                 }
             },
-            age: {
+            birth_age: {
                 type: DataTypes.INTEGER,
                 allowNull: false,
                 defaultValue: 17
             },
+            birth_iteration: {
+                type: DataTypes.INTEGER,
+                allowNull: false,
+                defaultValue: 1
+            },
+            last_declined_iteration: {
+                type: DataTypes.INTEGER,
+                allowNull: true
+            },
             decline_profile: {
                 type: DataTypes.ENUM(...Object.values(DeclineProfileEnum)),
                 allowNull: false,

package/dist/esm/src/data/models/retired-player.d.ts

@@ -3,7 +3,6 @@ import { Model } from 'sequelize';
 import { PlayerId, PlayerModel, TeamId, TeamModel } from '.';
 export interface RetiredPlayerAttributes {
     player_id: string;
-    user_id: string;
     team_id: string;
     retired_iteration: number;
 }
@@ -12,7 +11,6 @@ export type RetiredPlayerId = RetiredPlayerModel[RetiredPlayerPk];
 export type RetiredPlayerCreationAttributes = RetiredPlayerAttributes;
 export declare class RetiredPlayerModel extends Model<RetiredPlayerAttributes, RetiredPlayerCreationAttributes> implements RetiredPlayerAttributes {
     player_id: string;
-    user_id: string;
     team_id: string;
     retired_iteration: number;
     player: PlayerModel;

package/dist/esm/src/data/models/retired-player.js

@@ -11,14 +11,6 @@ export class RetiredPlayerModel extends Model {
                     key: 'player_id'
                 }
             },
-            user_id: {
-                type: DataTypes.UUID,
-                allowNull: false,
-                references: {
-                    model: 'AuthUser',
-                    key: 'user_id'
-                }
-            },
             team_id: {
                 type: DataTypes.UUID,
                 allowNull: false,
@@ -36,11 +28,17 @@ export class RetiredPlayerModel extends Model {
             tableName: 'RetiredPlayer',
             schema: 'public',
             timestamps: false,
-            indexes: [{
+            indexes: [
+                {
                     name: 'RetiredPlayer_pk',
                     unique: true,
                     fields: [{ name: 'player_id' }]
-                }]
+                },
+                {
+                    name: 'RetiredPlayer_team_id_idx',
+                    fields: [{ name: 'team_id' }]
+                }
+            ]
         });
     }
 }

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

@@ -1,5 +1,5 @@
 import { MatchAttributes, MatchModel } from '../models';
 import { Match } from '../../service';
 declare function transformToAttributes(match: Match): MatchAttributes;
-declare function transformToObject(model: MatchModel): Match;
+declare function transformToObject(model: MatchModel, currentIteration?: number): Match;
 export { transformToObject as transformToMatch, transformToAttributes as transformFromMatch };

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

@@ -11,7 +11,7 @@ function transformToAttributes(match) {
         status: match.status
     };
 }
-function transformToObject(model) {
+function transformToObject(model, currentIteration) {
     const sets = (model.MatchSets ?? []).map(transformToMatchSet)
         .sort((s1, s2) => s1.order - s2.order);
     let homeScore = 0;
@@ -43,15 +43,15 @@ function transformToObject(model) {
     const VPERs = (model.VPERs ?? []).map(transformToVPER);
     return Match.create({
         id: model.match_id,
-        homeTeam: transformToTeam(model.HomeTeam),
-        awayTeam: transformToTeam(model.AwayTeam),
+        homeTeam: transformToTeam(model.HomeTeam, currentIteration),
+        awayTeam: transformToTeam(model.AwayTeam, currentIteration),
         scheduledDate: new Date(model.scheduled_date),
         sets,
         status: model.status,
         VPERs,
         homeScore,
         awayScore,
-        winner: model.MatchResult?.Winner != null ? transformToTeam(model.MatchResult.Winner) : undefined
+        winner: model.MatchResult?.Winner != null ? transformToTeam(model.MatchResult.Winner, currentIteration) : undefined
     });
 }
 export { transformToObject as transformToMatch, transformToAttributes as transformFromMatch };

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

@@ -1,5 +1,5 @@
 import { PlayerAttributes, PlayerModel } from '../models';
 import { Player } from '../../service';
 declare function transformToAttributes(player: Player): PlayerAttributes;
-declare function transformToObject(model: PlayerModel): Player;
+declare function transformToObject(model: PlayerModel, currentIteration?: number): Player;
 export { transformToObject as transformToPlayer, transformToAttributes as transformFromPlayer };

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

@@ -17,7 +17,9 @@ function transformToAttributes(player) {
         traits: player.traits,
         PerformanceStat: transformFromPerformanceStats(player.stats, player.id),
         rarity: player.rarity,
-        age: player.age,
+        birth_age: player.birthAge,
+        birth_iteration: player.birthIteration,
+        last_declined_iteration: null,
         decline_profile: player.declineProfile
     };
 }
@@ -64,8 +66,10 @@ function transformToBoxScoreTotals(model) {
         }
     };
 }
-function transformToObject(model) {
+function transformToObject(model, currentIteration) {
     const boxScoreTotals = model.BoxScoreTotals != null ? transformToBoxScoreTotals(model.BoxScoreTotals) : undefined;
+    // When currentIteration is not provided, fall back to birth_iteration so age = birthAge.
+    const iter = currentIteration ?? model.birth_iteration;
     return Player.create({
         id: model.player_id,
         name: {
@@ -77,7 +81,9 @@ function transformToObject(model) {
         traits: model.traits,
         stats: transformToPerformanceStats(model.PerformanceStat),
         rarity: model.rarity,
-        age: model.age,
+        age: model.birth_age + (iter - model.birth_iteration),
+        birthAge: model.birth_age,
+        birthIteration: model.birth_iteration,
         declineProfile: model.decline_profile,
         boxScores: (model.BoxScores ?? []).map(transformToBoxScore),
         boxScoreTotals

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

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

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

@@ -0,0 +1,129 @@
+import { describe, it, expect } from '@jest/globals';
+import { v4 as uuidv4 } from 'uuid';
+import { transformToPlayer, transformFromPlayer } from './player';
+import { DeclineProfileEnum, RarityEnum, RoleEnum } from '../../service';
+// ─── shared mock ──────────────────────────────────────────────────────────────
+/** Minimal PlayerModel-shaped object for transformer tests.
+ *  Uses 'as unknown as PlayerModel' because Sequelize model instances carry
+ *  internal state we don't need; plain objects are sufficient for unit testing. */
+function makeModel(birthAge, birthIteration) {
+    const stat = 50;
+    return {
+        player_id: uuidv4(),
+        first_name: 'Test',
+        last_name: 'Player',
+        rarity: RarityEnum.COMMON,
+        roles: [RoleEnum.OUTSIDE_HITTER],
+        traits: [],
+        birth_age: birthAge,
+        birth_iteration: birthIteration,
+        last_declined_iteration: null,
+        decline_profile: DeclineProfileEnum.STANDARD,
+        BoxScores: [],
+        BoxScoreTotals: null,
+        country: {
+            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: ''
+        },
+        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
+        }
+    };
+}
+// ─── transformToPlayer ────────────────────────────────────────────────────────
+describe('transformToPlayer()', () => {
+    describe('age computation', () => {
+        it('computes age as birthAge + (currentIteration - birthIteration)', () => {
+            const model = makeModel(17, 1);
+            const player = transformToPlayer(model, 10);
+            expect(player.age).toBe(17 + (10 - 1)); // 26
+        });
+        it('age equals birthAge when currentIteration equals birthIteration', () => {
+            const model = makeModel(18, 5);
+            const player = transformToPlayer(model, 5);
+            expect(player.age).toBe(18);
+        });
+        it('falls back to birthAge when currentIteration is omitted', () => {
+            const model = makeModel(19, 3);
+            const player = transformToPlayer(model);
+            expect(player.age).toBe(19); // iter defaults to birth_iteration → offset = 0
+        });
+        it('handles a large iteration gap correctly', () => {
+            const model = makeModel(15, 1);
+            const player = transformToPlayer(model, 53);
+            expect(player.age).toBe(15 + 52); // 67
+        });
+    });
+    describe('birthAge and birthIteration passthrough', () => {
+        it('stores birthAge from birth_age', () => {
+            const model = makeModel(20, 1);
+            expect(transformToPlayer(model, 1).birthAge).toBe(20);
+        });
+        it('stores birthIteration from birth_iteration', () => {
+            const model = makeModel(16, 4);
+            expect(transformToPlayer(model, 4).birthIteration).toBe(4);
+        });
+        it('age, birthAge, and birthIteration are mutually consistent', () => {
+            const birthAge = 17;
+            const birthIteration = 2;
+            const currentIteration = 15;
+            const model = makeModel(birthAge, birthIteration);
+            const player = transformToPlayer(model, currentIteration);
+            expect(player.age).toBe(player.birthAge + (currentIteration - player.birthIteration));
+        });
+    });
+});
+// ─── transformFromPlayer ──────────────────────────────────────────────────────
+describe('transformFromPlayer()', () => {
+    it('writes birth_iteration from player.birthIteration', () => {
+        const model = makeModel(17, 3);
+        const player = transformToPlayer(model, 3);
+        const attrs = transformFromPlayer(player);
+        expect(attrs.birth_iteration).toBe(3);
+    });
+    it('writes birth_age from player.birthAge', () => {
+        const model = makeModel(19, 1);
+        const player = transformToPlayer(model, 1);
+        const attrs = transformFromPlayer(player);
+        expect(attrs.birth_age).toBe(19);
+    });
+    it('sets last_declined_iteration to null for new players', () => {
+        const model = makeModel(17, 1);
+        const player = transformToPlayer(model, 1);
+        const attrs = transformFromPlayer(player);
+        expect(attrs.last_declined_iteration).toBeNull();
+    });
+    it('does not write an age column (age is derived, not stored)', () => {
+        const model = makeModel(17, 1);
+        const player = transformToPlayer(model, 1);
+        const attrs = transformFromPlayer(player);
+        expect('age' in attrs).toBe(false);
+    });
+});

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

@@ -1,5 +1,5 @@
 import { Team } from '../../service';
 import { TeamAttributes, TeamModel } from '../models';
 declare function transformToAttributes(team: Team): TeamAttributes;
-declare function transformToObject(model: TeamModel): Team;
+declare function transformToObject(model: TeamModel, currentIteration?: number): Team;
 export { transformToObject as transformToTeam, transformToAttributes as transformFromTeam };

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

@@ -12,8 +12,8 @@ function transformToAttributes(team) {
         division_id: team.divisionId
     };
 }
-function transformToObject(model) {
-    const roster = (model.PlayerTeams ?? []).map((pt) => transformToPlayer(pt.player));
+function transformToObject(model, currentIteration) {
+    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;

package/dist/esm/src/service/player/player-generator.d.ts

@@ -30,7 +30,7 @@ export declare function rollRarity(pity: PityState, config?: GachaPullConfig): R
 export declare class PlayerGenerator {
     private constructor();
     private static generatePerformance;
-    static generatePlayer(country: Country, _rarity?: Rarity, role?: Role, maxTraits?: boolean): Player;
+    static generatePlayer(country: Country, _rarity?: Rarity, role?: Role, maxTraits?: boolean, birthIteration?: number): Player;
     static generatePlayers(count: number, countries: Country[]): Player[];
 }
 export declare function pickPlayerCountry(teamCountry: Country, allCountries: Country[]): Country;

package/dist/esm/src/service/player/player-generator.js

@@ -208,15 +208,15 @@ export class PlayerGenerator {
             }
         }
     }
-    static generatePlayer(country, _rarity, role, maxTraits) {
+    static generatePlayer(country, _rarity, role, maxTraits, birthIteration = 1) {
         const rarity = _rarity ?? rollRarity({ legendaryPity: 0, mythicPity: 0, specialPity: 0 }).rarity;
         const name = generatePlayerName(country.locales, 1)[0];
         const stats = PlayerGenerator.generatePerformance(rarity, role);
         const roles = assignRoles(stats, rarity);
         const traits = assignTraits(roles, rarity, maxTraits);
-        const age = randomInt(15, 21);
+        const birthAge = randomInt(15, 21);
         const declineProfile = declineProfiles[randomInt(0, declineProfiles.length)];
-        return Player.create({ id: uuidv4(), name, country, stats, roles, traits, rarity, age, declineProfile });
+        return Player.create({ id: uuidv4(), name, country, stats, roles, traits, rarity, age: birthAge, birthAge, birthIteration, declineProfile });
     }
     static generatePlayers(count, countries) {
         const players = [];

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

@@ -32,6 +32,8 @@ export declare class Player {
     readonly generalStats: Stat[];
     readonly rarity: Rarity;
     readonly age: number;
+    readonly birthAge: number;
+    readonly birthIteration: number;
     readonly declineProfile: DeclineProfile;
     readonly boxScores?: BoxScore[];
     readonly boxScoreTotals?: BoxScoreTotals;

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

@@ -49,7 +49,7 @@ export class Player {
             stats: PerformanceStats.create(result.data.stats)
         });
     }
-    constructor({ id, name, country, stats, roles, traits, rarity, age, declineProfile, boxScores, boxScoreTotals }) {
+    constructor({ id, name, country, stats, roles, traits, rarity, age, birthAge, birthIteration, declineProfile, boxScores, boxScoreTotals }) {
         this.id = id;
         this.name = name;
         this.country = country;
@@ -58,6 +58,8 @@ export class Player {
         this.traits = traits;
         this.rarity = rarity;
         this.age = age;
+        this.birthAge = birthAge;
+        this.birthIteration = birthIteration;
         this.declineProfile = declineProfile;
         this.boxScores = boxScores;
         this.boxScoreTotals = boxScoreTotals;

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

@@ -61,6 +61,8 @@ export declare const PlayerInputSchema: z.ZodObject<{
         SPECIAL: RarityEnum.SPECIAL;
     }>;
     age: z.ZodNumber;
+    birthAge: z.ZodNumber;
+    birthIteration: z.ZodNumber;
     declineProfile: z.ZodEnum<{
         PRODIGY: DeclineProfileEnum.PRODIGY;
         STANDARD: DeclineProfileEnum.STANDARD;

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

@@ -31,6 +31,8 @@ export const PlayerInputSchema = z.object({
     traits: z.array(z.enum(Object.values(TraitEnum))),
     rarity: z.enum(Object.values(RarityEnum)),
     age: z.number().int().min(0),
+    birthAge: z.number().int().min(0),
+    birthIteration: z.number().int().min(1),
     declineProfile: z.enum(Object.values(DeclineProfileEnum)),
     boxScores: z.array(BoxScoreInputSchema).optional(),
     boxScoreTotals: BoxScoreTotalsInputSchema.optional()

package/dist/esm/src/service/test-helpers.js

@@ -36,6 +36,8 @@ export function makePlayer(country, statValue = 50) {
         traits: [],
         rarity: RarityEnum.COMMON,
         age: 20,
+        birthAge: 20,
+        birthIteration: 1,
         declineProfile: DeclineProfileEnum.STANDARD
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "volleyballsimtypes",
-  "version": "0.0.365",
+  "version": "0.0.366",
   "description": "vbsim types",
   "main": "./dist/cjs/src/index.js",
   "module": "./dist/esm/src/index.js",
@@ -68,9 +68,7 @@
     "build": "npm run test-types && yarn clean && tsc -p tsconfig.json && tsc -p tsconfig-cjs.json",
     "sync:consumers": "powershell -NoProfile -ExecutionPolicy Bypass -File ./scripts/sync-consumers.ps1",
     "release": "powershell -NoProfile -ExecutionPolicy Bypass -File ./scripts/release.ps1",
-    "export:schema": "powershell -NoProfile -ExecutionPolicy Bypass -File ./scripts/export-schema.ps1",
-    "preversion": "npm run clean && npm run build && git commit -a --amend --no-edit",
-    "postversion": "git push --follow-tags && npm login && npm publish"
+    "export:schema": "powershell -NoProfile -ExecutionPolicy Bypass -File ./scripts/export-schema.ps1"
   },
   "author": "Francisco Farias <fariasfranciscoe@gmail.com>",
   "license": "ISC",