volleyballsimtypes 0.0.419 → 0.0.421

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

@@ -40,7 +40,7 @@ export type Match = Omit<DataProps<_Match>, 'sets' | 'homeTeam' | 'awayTeam' | '
 export type RallyEvent = DataProps<_RallyEvent> & {
     team?: Team;
 };
-export type Player = Omit<DataProps<_Player>, 'stats' | 'birthAge' | 'birthIteration' | 'declineProfile'> & {
+export type Player = Omit<DataProps<_Player>, 'stats' | 'birthAge' | 'birthIteration' | 'declineProfile' | 'nickname'> & {
     -readonly [K in 'birthAge' | 'birthIteration' | 'declineProfile']?: DataProps<_Player>[K];
 } & {
     stats?: PerformanceStats;
@@ -48,6 +48,7 @@ export type Player = Omit<DataProps<_Player>, 'stats' | 'birthAge' | 'birthItera
     jerseyNumber: number;
     locked?: boolean;
     declineStatus?: DeclineStatus;
+    nickname?: string;
 };
 export interface StartingLineup {
     [CourtPosition.LEFT_FRONT]: string;

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

@@ -4,6 +4,7 @@ exports.initModels = initModels;
 const models_1 = require("./models");
 function initModels(sequelize) {
     const Coach = models_1.CoachModel.initModel(sequelize);
+    const Scout = models_1.ScoutModel.initModel(sequelize);
     const CurrencyTransaction = models_1.CurrencyTransactionModel.initModel(sequelize);
     const Tactics = models_1.TacticsModel.initModel(sequelize);
     const AuthUser = models_1.AuthUserModel.initModel(sequelize);
@@ -195,6 +196,8 @@ function initModels(sequelize) {
     VPER.belongsTo(Match, { as: 'Match', foreignKey: 'match_id' });
     Team.hasOne(Coach, { as: 'Coach', foreignKey: 'team_id' });
     Coach.belongsTo(Team, { as: 'team', foreignKey: 'team_id' });
+    Team.hasOne(Scout, { as: 'Scout', foreignKey: 'team_id' });
+    Scout.belongsTo(Team, { as: 'team', foreignKey: 'team_id' });
     Team.hasOne(Tactics, { as: 'tactics', foreignKey: 'team_id' });
     Team.belongsTo(Country, { as: 'country', foreignKey: 'country_id' });
     Team.belongsToMany(Competition, {
@@ -277,6 +280,7 @@ function initModels(sequelize) {
         UserSettings,
         Notification,
         Coach,
+        Scout,
         CurrencyTransaction,
         VPER,
         LegacyTeamFlag,

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

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

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

@@ -12,6 +12,7 @@ var CurrencyTransactionSourceEnum;
     CurrencyTransactionSourceEnum["MATCH_REWARD"] = "MATCH_REWARD";
     CurrencyTransactionSourceEnum["GACHA_PULL"] = "GACHA_PULL";
     CurrencyTransactionSourceEnum["COACH_UPGRADE"] = "COACH_UPGRADE";
+    CurrencyTransactionSourceEnum["SCOUT_UPGRADE"] = "SCOUT_UPGRADE";
     CurrencyTransactionSourceEnum["PLAYER_DISMISS"] = "PLAYER_DISMISS";
     CurrencyTransactionSourceEnum["PLAYER_RETIRE"] = "PLAYER_RETIRE";
     CurrencyTransactionSourceEnum["ADMIN_GRANT"] = "ADMIN_GRANT";

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

@@ -29,6 +29,7 @@ export * from './promotion-match';
 export * from './region-qualifier';
 export * from './national-country';
 export * from './coach';
+export * from './scout';
 export * from './team';
 export * from './team-replacement';
 export * from './tactics';

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

@@ -45,6 +45,7 @@ __exportStar(require("./promotion-match"), exports);
 __exportStar(require("./region-qualifier"), exports);
 __exportStar(require("./national-country"), exports);
 __exportStar(require("./coach"), exports);
+__exportStar(require("./scout"), exports);
 __exportStar(require("./team"), exports);
 __exportStar(require("./team-replacement"), exports);
 __exportStar(require("./tactics"), exports);

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

@@ -9,6 +9,7 @@ export interface PlayerAttributes {
     rarity: Rarity;
     first_name: string;
     last_name: string;
+    nickname?: string | null;
     country_id: string;
     birth_age: number;
     birth_iteration: number;
@@ -27,6 +28,7 @@ export declare class PlayerModel extends Model<PlayerAttributes, PlayerCreationA
     rarity: Rarity;
     first_name: string;
     last_name: string;
+    nickname: string | null;
     country_id: string;
     birth_age: number;
     birth_iteration: number;

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

@@ -32,6 +32,10 @@ class PlayerModel extends sequelize_1.Model {
                 type: sequelize_1.DataTypes.STRING,
                 allowNull: false
             },
+            nickname: {
+                type: sequelize_1.DataTypes.STRING(16),
+                allowNull: true
+            },
             country_id: {
                 type: sequelize_1.DataTypes.UUID,
                 allowNull: false,

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

@@ -0,0 +1,25 @@
+import * as Sequelize from 'sequelize';
+import { Model } from 'sequelize';
+import { TeamId, TeamModel } from '.';
+export interface ScoutAttributes {
+    scout_id: string;
+    team_id: string;
+    name: string;
+    rarity: string;
+    currency_invested: number;
+}
+export type ScoutPk = 'scout_id';
+export type ScoutId = ScoutModel[ScoutPk];
+export type ScoutCreationAttributes = ScoutAttributes;
+export declare class ScoutModel extends Model<ScoutAttributes, ScoutCreationAttributes> implements ScoutAttributes {
+    scout_id: string;
+    team_id: string;
+    name: string;
+    rarity: string;
+    currency_invested: number;
+    team: TeamModel;
+    getTeam: Sequelize.BelongsToGetAssociationMixin<TeamModel>;
+    setTeam: Sequelize.BelongsToSetAssociationMixin<TeamModel, TeamId>;
+    createTeam: Sequelize.BelongsToCreateAssociationMixin<TeamModel>;
+    static initModel(sequelize: Sequelize.Sequelize): typeof ScoutModel;
+}

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

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScoutModel = void 0;
+const sequelize_1 = require("sequelize");
+class ScoutModel extends sequelize_1.Model {
+    static initModel(sequelize) {
+        return ScoutModel.init({
+            scout_id: {
+                type: sequelize_1.DataTypes.UUID,
+                allowNull: false,
+                primaryKey: true
+            },
+            team_id: {
+                type: sequelize_1.DataTypes.UUID,
+                allowNull: false,
+                unique: true,
+                references: {
+                    model: 'Team',
+                    key: 'team_id'
+                }
+            },
+            name: {
+                type: sequelize_1.DataTypes.STRING,
+                allowNull: false,
+                defaultValue: ''
+            },
+            rarity: {
+                type: sequelize_1.DataTypes.STRING,
+                allowNull: false,
+                defaultValue: 'COMMON'
+            },
+            currency_invested: {
+                type: sequelize_1.DataTypes.INTEGER,
+                allowNull: false,
+                defaultValue: 0
+            }
+        }, {
+            sequelize,
+            tableName: 'Scout',
+            schema: 'public',
+            timestamps: false,
+            indexes: [
+                {
+                    name: 'Scout_pk',
+                    unique: true,
+                    fields: [{ name: 'scout_id' }]
+                },
+                {
+                    name: 'Scout_team_id_unique',
+                    unique: true,
+                    fields: [{ name: 'team_id' }]
+                }
+            ]
+        });
+    }
+}
+exports.ScoutModel = ScoutModel;

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

@@ -17,6 +17,7 @@ function transformToAttributes(player) {
         country_id: player.country.id,
         first_name: player.name.first,
         last_name: player.name.last,
+        nickname: player.nickname ?? null,
         roles: player.roles,
         traits: player.traits,
         PerformanceStat: (0, _1.transformFromPerformanceStats)(player.stats, player.id),
@@ -80,6 +81,7 @@ function transformToObject(model, currentIteration) {
             first: model.first_name,
             last: model.last_name
         },
+        nickname: model.nickname ?? undefined,
         country: (0, _1.transformToCountry)(model.country),
         roles: model.roles,
         traits: model.traits,

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

@@ -36,6 +36,7 @@ export interface GachaPullConfig {
 export declare const NORMAL_PULL_CONFIG: GachaPullConfig;
 export declare const QUALIFIER_PULL_CONFIG: GachaPullConfig;
 export declare const TOURNAMENT_PULL_CONFIG: GachaPullConfig;
+export declare function scoutPullConfig(level: string): GachaPullConfig;
 export declare function rollRarity(pity: PityState, config?: GachaPullConfig): RollResult;
 export declare class PlayerGenerator {
     private constructor();

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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PlayerGenerator = exports.TOURNAMENT_PULL_CONFIG = exports.QUALIFIER_PULL_CONFIG = exports.NORMAL_PULL_CONFIG = exports.PITY_STEP = exports.PITY_THRESHOLDS = void 0;
+exports.scoutPullConfig = scoutPullConfig;
 exports.rollRarity = rollRarity;
 exports.pickPlayerCountry = pickPlayerCountry;
 const uuid_1 = require("uuid");
@@ -20,7 +21,7 @@ const decline_1 = require("./decline");
 exports.PITY_THRESHOLDS = {
     legendary: 25,
     mythic: 200,
-    special: 575
+    special: 600
 };
 // Per-pull soft-pity step: how much a rarity's odds increase for each pull without it. Small enough
 // that base rates stay honest until the hard-pity threshold guarantees the drop.
@@ -81,6 +82,67 @@ exports.TOURNAMENT_PULL_CONFIG = {
     accumulateMythicPity: true,
     accumulateSpecialPity: true
 };
+// Scout employee: each upgrade level shifts a team's NORMAL-pull odds - fewer commons, more legendary+,
+// and at MYTHIC+ a tiny SPECIAL chance plus special pity (apply + accumulate). RARE band width stays 0.25
+// and COMMON is the remainder. Levels reuse the Rarity ladder: COMMON = no scout / base, up to SPECIAL =
+// max. Caps at max scout: legendary 5%, mythic 1.5%, special 0.1%. See plans/scout-employee.md.
+const SCOUT_PULL_CONFIGS = {
+    COMMON: exports.NORMAL_PULL_CONFIG,
+    RARE: {
+        special: 0,
+        mythic: 0.007,
+        legendary: 0.03,
+        rare: 0.25,
+        applyLegendaryPity: true,
+        applyMythicPity: true,
+        applySpecialPity: false,
+        accumulateLegendaryPity: true,
+        accumulateMythicPity: true,
+        accumulateSpecialPity: false
+    },
+    LEGENDARY: {
+        special: 0,
+        mythic: 0.01,
+        legendary: 0.04,
+        rare: 0.25,
+        applyLegendaryPity: true,
+        applyMythicPity: true,
+        applySpecialPity: false,
+        accumulateLegendaryPity: true,
+        accumulateMythicPity: true,
+        accumulateSpecialPity: false
+    },
+    MYTHIC: {
+        special: 0.0005,
+        mythic: 0.013,
+        legendary: 0.045,
+        rare: 0.25,
+        applyLegendaryPity: true,
+        applyMythicPity: true,
+        applySpecialPity: true,
+        accumulateLegendaryPity: true,
+        accumulateMythicPity: true,
+        accumulateSpecialPity: true
+    },
+    SPECIAL: {
+        special: 0.001,
+        mythic: 0.015,
+        legendary: 0.05,
+        rare: 0.25,
+        applyLegendaryPity: true,
+        applyMythicPity: true,
+        applySpecialPity: true,
+        accumulateLegendaryPity: true,
+        accumulateMythicPity: true,
+        accumulateSpecialPity: true
+    }
+};
+// The pull config for a team's scout level (the scout's rarity field). Unknown levels fall back to the
+// base NORMAL_PULL_CONFIG. The API uses this for normal pulls and to derive the scout-tied SPECIAL rate
+// for match grants (national/qualifier = this special, tournament = 2x), gated by applySpecialPity.
+function scoutPullConfig(level) {
+    return SCOUT_PULL_CONFIGS[level] ?? exports.NORMAL_PULL_CONFIG;
+}
 // Effective odds for a rarity: the base rate plus a gentle per-pull soft-pity increase, until the
 // counter reaches its threshold, at which point the rarity is a guaranteed drop (odds = 1). Returns
 // the base rate unchanged when pity is not applied for this pull type.

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

@@ -25,6 +25,7 @@ export declare class Name {
 export declare class Player {
     readonly id: string;
     readonly name: Name;
+    readonly nickname?: string;
     readonly country: Country;
     readonly stats: PerformanceStats;
     readonly roles: Role[];

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

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

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

@@ -14,6 +14,7 @@ export declare const PlayerInputSchema: z.ZodObject<{
         first: z.ZodString;
         last: z.ZodString;
     }, z.core.$strip>;
+    nickname: z.ZodOptional<z.ZodString>;
     country: z.ZodCustom<Country, Country>;
     stats: z.ZodObject<{
         attack: z.ZodNumber;

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

@@ -28,6 +28,7 @@ const BoxScoreTotalsInputSchema = zod_1.z.object({
 exports.PlayerInputSchema = zod_1.z.object({
     id: zod_1.z.uuid(),
     name: exports.NameInputSchema,
+    nickname: zod_1.z.string().max(16).optional(),
     country: countrySchema,
     stats: performance_stats_z_1.PerformanceStatsInputSchema,
     roles: zod_1.z.array(zod_1.z.enum(Object.values(role_1.RoleEnum))).min(1),

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

@@ -40,7 +40,7 @@ export type Match = Omit<DataProps<_Match>, 'sets' | 'homeTeam' | 'awayTeam' | '
 export type RallyEvent = DataProps<_RallyEvent> & {
     team?: Team;
 };
-export type Player = Omit<DataProps<_Player>, 'stats' | 'birthAge' | 'birthIteration' | 'declineProfile'> & {
+export type Player = Omit<DataProps<_Player>, 'stats' | 'birthAge' | 'birthIteration' | 'declineProfile' | 'nickname'> & {
     -readonly [K in 'birthAge' | 'birthIteration' | 'declineProfile']?: DataProps<_Player>[K];
 } & {
     stats?: PerformanceStats;
@@ -48,6 +48,7 @@ export type Player = Omit<DataProps<_Player>, 'stats' | 'birthAge' | 'birthItera
     jerseyNumber: number;
     locked?: boolean;
     declineStatus?: DeclineStatus;
+    nickname?: string;
 };
 export interface StartingLineup {
     [CourtPosition.LEFT_FRONT]: string;

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

@@ -1,6 +1,7 @@
-import { AuthIdentityModel, AuthSessionModel, AuthUserModel, BoxScoreModel, CoachModel, 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, 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 AuthUser = AuthUserModel.initModel(sequelize);
@@ -192,6 +193,8 @@ export function initModels(sequelize) {
     VPER.belongsTo(Match, { as: 'Match', foreignKey: 'match_id' });
     Team.hasOne(Coach, { as: 'Coach', foreignKey: 'team_id' });
     Coach.belongsTo(Team, { as: 'team', foreignKey: 'team_id' });
+    Team.hasOne(Scout, { as: 'Scout', foreignKey: 'team_id' });
+    Scout.belongsTo(Team, { as: 'team', foreignKey: 'team_id' });
     Team.hasOne(Tactics, { as: 'tactics', foreignKey: 'team_id' });
     Team.belongsTo(Country, { as: 'country', foreignKey: 'country_id' });
     Team.belongsToMany(Competition, {
@@ -274,6 +277,7 @@ export function initModels(sequelize) {
         UserSettings,
         Notification,
         Coach,
+        Scout,
         CurrencyTransaction,
         VPER,
         LegacyTeamFlag,

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

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

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

@@ -9,6 +9,7 @@ export var CurrencyTransactionSourceEnum;
     CurrencyTransactionSourceEnum["MATCH_REWARD"] = "MATCH_REWARD";
     CurrencyTransactionSourceEnum["GACHA_PULL"] = "GACHA_PULL";
     CurrencyTransactionSourceEnum["COACH_UPGRADE"] = "COACH_UPGRADE";
+    CurrencyTransactionSourceEnum["SCOUT_UPGRADE"] = "SCOUT_UPGRADE";
     CurrencyTransactionSourceEnum["PLAYER_DISMISS"] = "PLAYER_DISMISS";
     CurrencyTransactionSourceEnum["PLAYER_RETIRE"] = "PLAYER_RETIRE";
     CurrencyTransactionSourceEnum["ADMIN_GRANT"] = "ADMIN_GRANT";

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

@@ -29,6 +29,7 @@ export * from './promotion-match';
 export * from './region-qualifier';
 export * from './national-country';
 export * from './coach';
+export * from './scout';
 export * from './team';
 export * from './team-replacement';
 export * from './tactics';

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

@@ -29,6 +29,7 @@ export * from './promotion-match';
 export * from './region-qualifier';
 export * from './national-country';
 export * from './coach';
+export * from './scout';
 export * from './team';
 export * from './team-replacement';
 export * from './tactics';

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

@@ -9,6 +9,7 @@ export interface PlayerAttributes {
     rarity: Rarity;
     first_name: string;
     last_name: string;
+    nickname?: string | null;
     country_id: string;
     birth_age: number;
     birth_iteration: number;
@@ -27,6 +28,7 @@ export declare class PlayerModel extends Model<PlayerAttributes, PlayerCreationA
     rarity: Rarity;
     first_name: string;
     last_name: string;
+    nickname: string | null;
     country_id: string;
     birth_age: number;
     birth_iteration: number;

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

@@ -29,6 +29,10 @@ export class PlayerModel extends Model {
                 type: DataTypes.STRING,
                 allowNull: false
             },
+            nickname: {
+                type: DataTypes.STRING(16),
+                allowNull: true
+            },
             country_id: {
                 type: DataTypes.UUID,
                 allowNull: false,

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

@@ -0,0 +1,25 @@
+import * as Sequelize from 'sequelize';
+import { Model } from 'sequelize';
+import { TeamId, TeamModel } from '.';
+export interface ScoutAttributes {
+    scout_id: string;
+    team_id: string;
+    name: string;
+    rarity: string;
+    currency_invested: number;
+}
+export type ScoutPk = 'scout_id';
+export type ScoutId = ScoutModel[ScoutPk];
+export type ScoutCreationAttributes = ScoutAttributes;
+export declare class ScoutModel extends Model<ScoutAttributes, ScoutCreationAttributes> implements ScoutAttributes {
+    scout_id: string;
+    team_id: string;
+    name: string;
+    rarity: string;
+    currency_invested: number;
+    team: TeamModel;
+    getTeam: Sequelize.BelongsToGetAssociationMixin<TeamModel>;
+    setTeam: Sequelize.BelongsToSetAssociationMixin<TeamModel, TeamId>;
+    createTeam: Sequelize.BelongsToCreateAssociationMixin<TeamModel>;
+    static initModel(sequelize: Sequelize.Sequelize): typeof ScoutModel;
+}

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

@@ -0,0 +1,53 @@
+import { DataTypes, Model } from 'sequelize';
+export class ScoutModel extends Model {
+    static initModel(sequelize) {
+        return ScoutModel.init({
+            scout_id: {
+                type: DataTypes.UUID,
+                allowNull: false,
+                primaryKey: true
+            },
+            team_id: {
+                type: DataTypes.UUID,
+                allowNull: false,
+                unique: true,
+                references: {
+                    model: 'Team',
+                    key: 'team_id'
+                }
+            },
+            name: {
+                type: DataTypes.STRING,
+                allowNull: false,
+                defaultValue: ''
+            },
+            rarity: {
+                type: DataTypes.STRING,
+                allowNull: false,
+                defaultValue: 'COMMON'
+            },
+            currency_invested: {
+                type: DataTypes.INTEGER,
+                allowNull: false,
+                defaultValue: 0
+            }
+        }, {
+            sequelize,
+            tableName: 'Scout',
+            schema: 'public',
+            timestamps: false,
+            indexes: [
+                {
+                    name: 'Scout_pk',
+                    unique: true,
+                    fields: [{ name: 'scout_id' }]
+                },
+                {
+                    name: 'Scout_team_id_unique',
+                    unique: true,
+                    fields: [{ name: 'team_id' }]
+                }
+            ]
+        });
+    }
+}

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

@@ -13,6 +13,7 @@ function transformToAttributes(player) {
         country_id: player.country.id,
         first_name: player.name.first,
         last_name: player.name.last,
+        nickname: player.nickname ?? null,
         roles: player.roles,
         traits: player.traits,
         PerformanceStat: transformFromPerformanceStats(player.stats, player.id),
@@ -76,6 +77,7 @@ function transformToObject(model, currentIteration) {
             first: model.first_name,
             last: model.last_name
         },
+        nickname: model.nickname ?? undefined,
         country: transformToCountry(model.country),
         roles: model.roles,
         traits: model.traits,

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

@@ -36,6 +36,7 @@ export interface GachaPullConfig {
 export declare const NORMAL_PULL_CONFIG: GachaPullConfig;
 export declare const QUALIFIER_PULL_CONFIG: GachaPullConfig;
 export declare const TOURNAMENT_PULL_CONFIG: GachaPullConfig;
+export declare function scoutPullConfig(level: string): GachaPullConfig;
 export declare function rollRarity(pity: PityState, config?: GachaPullConfig): RollResult;
 export declare class PlayerGenerator {
     private constructor();

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

@@ -15,7 +15,7 @@ import { declineProfiles } from './decline';
 export const PITY_THRESHOLDS = {
     legendary: 25,
     mythic: 200,
-    special: 575
+    special: 600
 };
 // Per-pull soft-pity step: how much a rarity's odds increase for each pull without it. Small enough
 // that base rates stay honest until the hard-pity threshold guarantees the drop.
@@ -76,6 +76,67 @@ export const TOURNAMENT_PULL_CONFIG = {
     accumulateMythicPity: true,
     accumulateSpecialPity: true
 };
+// Scout employee: each upgrade level shifts a team's NORMAL-pull odds - fewer commons, more legendary+,
+// and at MYTHIC+ a tiny SPECIAL chance plus special pity (apply + accumulate). RARE band width stays 0.25
+// and COMMON is the remainder. Levels reuse the Rarity ladder: COMMON = no scout / base, up to SPECIAL =
+// max. Caps at max scout: legendary 5%, mythic 1.5%, special 0.1%. See plans/scout-employee.md.
+const SCOUT_PULL_CONFIGS = {
+    COMMON: NORMAL_PULL_CONFIG,
+    RARE: {
+        special: 0,
+        mythic: 0.007,
+        legendary: 0.03,
+        rare: 0.25,
+        applyLegendaryPity: true,
+        applyMythicPity: true,
+        applySpecialPity: false,
+        accumulateLegendaryPity: true,
+        accumulateMythicPity: true,
+        accumulateSpecialPity: false
+    },
+    LEGENDARY: {
+        special: 0,
+        mythic: 0.01,
+        legendary: 0.04,
+        rare: 0.25,
+        applyLegendaryPity: true,
+        applyMythicPity: true,
+        applySpecialPity: false,
+        accumulateLegendaryPity: true,
+        accumulateMythicPity: true,
+        accumulateSpecialPity: false
+    },
+    MYTHIC: {
+        special: 0.0005,
+        mythic: 0.013,
+        legendary: 0.045,
+        rare: 0.25,
+        applyLegendaryPity: true,
+        applyMythicPity: true,
+        applySpecialPity: true,
+        accumulateLegendaryPity: true,
+        accumulateMythicPity: true,
+        accumulateSpecialPity: true
+    },
+    SPECIAL: {
+        special: 0.001,
+        mythic: 0.015,
+        legendary: 0.05,
+        rare: 0.25,
+        applyLegendaryPity: true,
+        applyMythicPity: true,
+        applySpecialPity: true,
+        accumulateLegendaryPity: true,
+        accumulateMythicPity: true,
+        accumulateSpecialPity: true
+    }
+};
+// The pull config for a team's scout level (the scout's rarity field). Unknown levels fall back to the
+// base NORMAL_PULL_CONFIG. The API uses this for normal pulls and to derive the scout-tied SPECIAL rate
+// for match grants (national/qualifier = this special, tournament = 2x), gated by applySpecialPity.
+export function scoutPullConfig(level) {
+    return SCOUT_PULL_CONFIGS[level] ?? NORMAL_PULL_CONFIG;
+}
 // Effective odds for a rarity: the base rate plus a gentle per-pull soft-pity increase, until the
 // counter reaches its threshold, at which point the rarity is a guaranteed drop (odds = 1). Returns
 // the base rate unchanged when pity is not applied for this pull type.

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

@@ -25,6 +25,7 @@ export declare class Name {
 export declare class Player {
     readonly id: string;
     readonly name: Name;
+    readonly nickname?: string;
     readonly country: Country;
     readonly stats: PerformanceStats;
     readonly roles: Role[];

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

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

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

@@ -14,6 +14,7 @@ export declare const PlayerInputSchema: z.ZodObject<{
         first: z.ZodString;
         last: z.ZodString;
     }, z.core.$strip>;
+    nickname: z.ZodOptional<z.ZodString>;
     country: z.ZodCustom<Country, Country>;
     stats: z.ZodObject<{
         attack: z.ZodNumber;

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

@@ -25,6 +25,7 @@ const BoxScoreTotalsInputSchema = z.object({
 export const PlayerInputSchema = z.object({
     id: z.uuid(),
     name: NameInputSchema,
+    nickname: z.string().max(16).optional(),
     country: countrySchema,
     stats: PerformanceStatsInputSchema,
     roles: z.array(z.enum(Object.values(RoleEnum))).min(1),

package/package.json

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