volleyballsimtypes 0.0.519 → 0.0.521

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

@@ -1,4 +1,4 @@
-import { AuthIdentityModel, AuthSessionModel, AuthUserModel, BoxScoreModel, CoachModel, ScoutModel, PhysicianModel, PhysiotherapistModel, BoxScoreTotalsModel, CompetitionChampionModel, CurrencyTransactionModel, GachaPityModel, GachaPullHistoryModel, WishlistModel, UserSettingsModel, UserDeviceTokenModel, BasePositionPresetModel, CompetitionMatchModel, CompetitionMVPModel, CompetitionModel, CompetitionStandingsMatchModel, CompetitionStandingsModel, CompetitionTeamsModel, CountryModel, DivisionModel, DivisionSeasonModel, IterationModel, LeagueModel, MatchModel, MatchRatingModel, MatchResultModel, MatchSetModel, PerformanceStatsModel, PlayerModel, PlayerImprovementLogModel, PlayerDeclineLogModel, PlayerTeamModel, RetiredPlayerModel, PromotionMatchModel, FriendlyModel, RegionQualifierModel, NationalCountryModel, RallyModel, TacticsModel, LineupPresetModel, MatchPresetModel, EventModel, EventCompetitionModel, EventSquadModel, EventPackModel, EventPackPlayerModel, EventResultModel, EventBotTeamModel, TeamModel, TeamReplacementModel, UserCurrencyModel, UserPlayerProgressModel, UserPullGrantModel, UserTeamModel, VPERModel, NotificationModel, AppConfigModel, LegacyTeamFlagModel } from './models';
+import { AuthIdentityModel, AuthSessionModel, AuthUserModel, BoxScoreModel, CoachModel, ScoutModel, PhysicianModel, PhysiotherapistModel, BoxScoreTotalsModel, CompetitionChampionModel, JerseyBadgeModel, CurrencyTransactionModel, GachaPityModel, GachaPullHistoryModel, WishlistModel, UserSettingsModel, UserDeviceTokenModel, BasePositionPresetModel, CompetitionMatchModel, CompetitionMVPModel, CompetitionModel, CompetitionStandingsMatchModel, CompetitionStandingsModel, CompetitionTeamsModel, CountryModel, DivisionModel, DivisionSeasonModel, IterationModel, LeagueModel, MatchModel, MatchRatingModel, MatchResultModel, MatchSetModel, PerformanceStatsModel, PlayerModel, PlayerImprovementLogModel, PlayerDeclineLogModel, PlayerTeamModel, RetiredPlayerModel, PromotionMatchModel, FriendlyModel, RegionQualifierModel, NationalCountryModel, RallyModel, TacticsModel, TeamJerseyModel, LineupPresetModel, MatchPresetModel, EventModel, EventCompetitionModel, EventSquadModel, EventPackModel, EventPackPlayerModel, EventResultModel, EventBotTeamModel, TeamModel, TeamReplacementModel, UserCurrencyModel, UserPlayerProgressModel, UserPullGrantModel, PremiumGrantModel, UserTeamModel, VPERModel, NotificationModel, AppConfigModel, LegacyTeamFlagModel } from './models';
 export function initModels(sequelize) {
     const Coach = CoachModel.initModel(sequelize);
     const Scout = ScoutModel.initModel(sequelize);
@@ -6,6 +6,7 @@ export function initModels(sequelize) {
     const Physiotherapist = PhysiotherapistModel.initModel(sequelize);
     const CurrencyTransaction = CurrencyTransactionModel.initModel(sequelize);
     const Tactics = TacticsModel.initModel(sequelize);
+    const TeamJersey = TeamJerseyModel.initModel(sequelize);
     const LineupPreset = LineupPresetModel.initModel(sequelize);
     const MatchPreset = MatchPresetModel.initModel(sequelize);
     const Event = EventModel.initModel(sequelize);
@@ -21,6 +22,7 @@ export function initModels(sequelize) {
     const GachaPity = GachaPityModel.initModel(sequelize);
     const GachaPullHistory = GachaPullHistoryModel.initModel(sequelize);
     const UserPullGrant = UserPullGrantModel.initModel(sequelize);
+    const PremiumGrant = PremiumGrantModel.initModel(sequelize);
     const Wishlist = WishlistModel.initModel(sequelize);
     const UserSettings = UserSettingsModel.initModel(sequelize);
     const UserDeviceToken = UserDeviceTokenModel.initModel(sequelize);
@@ -36,6 +38,7 @@ export function initModels(sequelize) {
     const CompetitionStandingsMatch = CompetitionStandingsMatchModel.initModel(sequelize);
     const CompetitionTeams = CompetitionTeamsModel.initModel(sequelize);
     const CompetitionChampion = CompetitionChampionModel.initModel(sequelize);
+    const JerseyBadge = JerseyBadgeModel.initModel(sequelize);
     const CompetitionMatch = CompetitionMatchModel.initModel(sequelize);
     const Iteration = IterationModel.initModel(sequelize);
     const League = LeagueModel.initModel(sequelize);
@@ -80,6 +83,7 @@ export function initModels(sequelize) {
     Notification.belongsTo(AuthUser, { as: 'user', foreignKey: 'user_id' });
     AuthUser.hasMany(GachaPullHistory, { as: 'GachaPullHistory', foreignKey: 'user_id' });
     AuthUser.hasMany(UserPullGrant, { as: 'UserPullGrants', foreignKey: 'user_id' });
+    AuthUser.hasMany(PremiumGrant, { as: 'PremiumGrants', foreignKey: 'user_id' });
     AuthIdentity.belongsTo(AuthUser, { as: 'user', foreignKey: 'user_id' });
     AuthSession.belongsTo(AuthUser, { as: 'user', foreignKey: 'user_id' });
     UserTeam.belongsTo(AuthUser, { as: 'user', foreignKey: 'user_id' });
@@ -90,6 +94,8 @@ export function initModels(sequelize) {
     GachaPullHistory.belongsTo(AuthUser, { as: 'user', foreignKey: 'user_id' });
     GachaPullHistory.belongsTo(Player, { as: 'player', foreignKey: 'player_id' });
     UserPullGrant.belongsTo(AuthUser, { as: 'user', foreignKey: 'user_id' });
+    PremiumGrant.belongsTo(AuthUser, { as: 'user', foreignKey: 'user_id' });
+    PremiumGrant.belongsTo(AuthUser, { as: 'grantedByUser', foreignKey: 'granted_by' });
     Wishlist.belongsTo(AuthUser, { as: 'user', foreignKey: 'user_id' });
     UserSettings.belongsTo(AuthUser, { as: 'user', foreignKey: 'user_id' });
     Competition.belongsTo(Iteration, { as: 'Iteration', foreignKey: 'iteration' });
@@ -107,6 +113,8 @@ export function initModels(sequelize) {
     });
     CompetitionChampion.belongsTo(Competition, { as: 'competition', foreignKey: 'competition_id' });
     CompetitionChampion.belongsTo(Team, { as: 'team', foreignKey: 'team_id' });
+    JerseyBadge.belongsTo(Competition, { as: 'competition', foreignKey: 'competition_id' });
+    JerseyBadge.belongsTo(Team, { as: 'team', foreignKey: 'team_id' });
     CompetitionMVP.belongsTo(Competition, { as: 'competition', foreignKey: 'competition_id' });
     CompetitionMVP.belongsTo(Player, { as: 'player', foreignKey: 'player_id' });
     CompetitionMatch.belongsTo(Competition, { as: 'Competition', foreignKey: 'competition_id' });
@@ -225,6 +233,10 @@ export function initModels(sequelize) {
     Team.hasOne(Physiotherapist, { as: 'Physiotherapist', foreignKey: 'team_id' });
     Physiotherapist.belongsTo(Team, { as: 'team', foreignKey: 'team_id' });
     Team.hasOne(Tactics, { as: 'tactics', foreignKey: 'team_id' });
+    // Saved premium kit. Like lineup presets, deliberately NOT in Team.defaultScope: only the management API (editor)
+    // and the effective-jersey resolver include it, so the simulator's team loads are unchanged.
+    Team.hasOne(TeamJersey, { as: 'TeamJersey', foreignKey: 'team_id' });
+    TeamJersey.belongsTo(Team, { as: 'team', 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' });
@@ -306,6 +318,7 @@ export function initModels(sequelize) {
         AuthUser,
         Competition,
         CompetitionChampion,
+        JerseyBadge,
         CompetitionMatch,
         CompetitionMVP,
         CompetitionStandings,
@@ -351,6 +364,7 @@ export function initModels(sequelize) {
         GachaPity,
         GachaPullHistory,
         UserPullGrant,
+        PremiumGrant,
         Wishlist,
         UserSettings,
         UserDeviceToken,

package/dist/esm/src/data/models/auth-identity.d.ts

@@ -14,7 +14,7 @@ export interface AuthIdentityAttributes {
 }
 export type AuthIdentityPk = 'identity_id';
 export type AuthIdentityId = AuthIdentityModel[AuthIdentityPk];
-export type AuthProvider = 'EMAIL' | 'GOOGLE' | 'FACEBOOK' | 'APPLE';
+export type AuthProvider = 'EMAIL' | 'GOOGLE' | 'FACEBOOK' | 'APPLE' | 'PATREON';
 export type AuthIdentityOptionalAttributes = 'email' | 'password_hash' | 'last_used_at' | 'created_at' | 'updated_at';
 export type AuthIdentityCreationAttributes = Optional<AuthIdentityAttributes, AuthIdentityOptionalAttributes>;
 export declare class AuthIdentityModel extends Model<AuthIdentityAttributes, AuthIdentityCreationAttributes> implements AuthIdentityAttributes {

package/dist/esm/src/data/models/auth-identity.js

@@ -16,7 +16,7 @@ export class AuthIdentityModel extends Model {
                 }
             },
             provider: {
-                type: DataTypes.ENUM('EMAIL', 'GOOGLE', 'FACEBOOK', 'APPLE'),
+                type: DataTypes.ENUM('EMAIL', 'GOOGLE', 'FACEBOOK', 'APPLE', 'PATREON'),
                 allowNull: false
             },
             provider_user_id: {

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

@@ -7,6 +7,7 @@ export * from './competition';
 export * from './competition-mvp';
 export * from './competition-champion';
 export * from './competition-match';
+export * from './jersey-badge';
 export * from './competition-standings';
 export * from './competition-standings-match';
 export * from './competition-teams';
@@ -37,8 +38,10 @@ export * from './physiotherapist';
 export * from './team';
 export * from './team-replacement';
 export * from './tactics';
+export * from './team-jersey';
 export * from './lineup-preset';
 export * from './base-position-preset';
+export * from './premium-grant';
 export * from './event';
 export * from './event-competition';
 export * from './event-bot-team';

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

@@ -7,6 +7,7 @@ export * from './competition';
 export * from './competition-mvp';
 export * from './competition-champion';
 export * from './competition-match';
+export * from './jersey-badge';
 export * from './competition-standings';
 export * from './competition-standings-match';
 export * from './competition-teams';
@@ -37,8 +38,10 @@ export * from './physiotherapist';
 export * from './team';
 export * from './team-replacement';
 export * from './tactics';
+export * from './team-jersey';
 export * from './lineup-preset';
 export * from './base-position-preset';
+export * from './premium-grant';
 export * from './event';
 export * from './event-competition';
 export * from './event-bot-team';

package/dist/esm/src/data/models/jersey-badge.d.ts

@@ -0,0 +1,32 @@
+import * as Sequelize from 'sequelize';
+import { Model } from 'sequelize';
+import { CompetitionId, CompetitionModel, TeamId, TeamModel } from '.';
+export type JerseyBadgeKind = 'LEAGUE' | 'NATIONALS' | 'REGIONALS' | 'WCC';
+export interface JerseyBadgeAttributes {
+    competition_id: string;
+    team_id: string;
+    badge: JerseyBadgeKind;
+    region: string | null;
+    start_time: Date;
+    end_time: Date;
+}
+export type JerseyBadgePk = 'competition_id';
+export type JerseyBadgeId = JerseyBadgeModel[JerseyBadgePk];
+export type JerseyBadgeCreationAttributes = JerseyBadgeAttributes;
+export declare class JerseyBadgeModel extends Model<JerseyBadgeAttributes, JerseyBadgeCreationAttributes> implements JerseyBadgeAttributes {
+    competition_id: string;
+    team_id: string;
+    badge: JerseyBadgeKind;
+    region: string | null;
+    start_time: Date;
+    end_time: Date;
+    competition: CompetitionModel;
+    getCompetition: Sequelize.BelongsToGetAssociationMixin<CompetitionModel>;
+    setCompetition: Sequelize.BelongsToSetAssociationMixin<CompetitionModel, CompetitionId>;
+    createCompetition: Sequelize.BelongsToCreateAssociationMixin<CompetitionModel>;
+    team: TeamModel;
+    getTeam: Sequelize.BelongsToGetAssociationMixin<TeamModel>;
+    setTeam: Sequelize.BelongsToSetAssociationMixin<TeamModel, TeamId>;
+    createTeam: Sequelize.BelongsToCreateAssociationMixin<TeamModel>;
+    static initModel(sequelize: Sequelize.Sequelize): typeof JerseyBadgeModel;
+}

package/dist/esm/src/data/models/jersey-badge.js

@@ -0,0 +1,56 @@
+import { DataTypes, Model } from 'sequelize';
+export class JerseyBadgeModel extends Model {
+    static initModel(sequelize) {
+        return JerseyBadgeModel.init({
+            competition_id: {
+                type: DataTypes.UUID,
+                allowNull: false,
+                primaryKey: true,
+                references: {
+                    model: 'Competition',
+                    key: 'competition_id'
+                }
+            },
+            team_id: {
+                type: DataTypes.UUID,
+                allowNull: false,
+                references: {
+                    model: 'Team',
+                    key: 'team_id'
+                }
+            },
+            badge: {
+                type: DataTypes.ENUM('LEAGUE', 'NATIONALS', 'REGIONALS', 'WCC'),
+                allowNull: false
+            },
+            region: {
+                type: DataTypes.STRING(3),
+                allowNull: true
+            },
+            start_time: {
+                type: DataTypes.DATE,
+                allowNull: false
+            },
+            end_time: {
+                type: DataTypes.DATE,
+                allowNull: false
+            }
+        }, {
+            sequelize,
+            tableName: 'JerseyBadge',
+            schema: 'public',
+            timestamps: false,
+            indexes: [
+                {
+                    name: 'jerseybadge_pk',
+                    unique: true,
+                    fields: [{ name: 'competition_id' }]
+                },
+                {
+                    name: 'JerseyBadge_team_active_idx',
+                    fields: [{ name: 'team_id' }, { name: 'start_time' }, { name: 'end_time' }]
+                }
+            ]
+        });
+    }
+}

package/dist/esm/src/data/models/premium-grant.d.ts

@@ -0,0 +1,39 @@
+import * as Sequelize from 'sequelize';
+import { Model, Optional } from 'sequelize';
+import { PremiumGrantSource } from '../../service';
+import { AuthUserId, AuthUserModel } from '.';
+export interface PremiumGrantAttributes {
+    grant_id: string;
+    user_id: string;
+    tier: number;
+    source: PremiumGrantSource;
+    granted_by?: string | null;
+    granted_at: Date;
+    expires_at?: Date | null;
+    revoked_at?: Date | null;
+    patreon_member_id?: string | null;
+    note?: string | null;
+}
+export type PremiumGrantPk = 'grant_id';
+export type PremiumGrantId = PremiumGrantModel[PremiumGrantPk];
+export type PremiumGrantOptionalAttributes = 'grant_id' | 'granted_by' | 'granted_at' | 'expires_at' | 'revoked_at' | 'patreon_member_id' | 'note';
+export type PremiumGrantCreationAttributes = Optional<PremiumGrantAttributes, PremiumGrantOptionalAttributes>;
+export declare class PremiumGrantModel extends Model<PremiumGrantAttributes, PremiumGrantCreationAttributes> implements PremiumGrantAttributes {
+    grant_id: string;
+    user_id: string;
+    tier: number;
+    source: PremiumGrantSource;
+    granted_by?: string | null;
+    granted_at: Date;
+    expires_at?: Date | null;
+    revoked_at?: Date | null;
+    patreon_member_id?: string | null;
+    note?: string | null;
+    user: AuthUserModel;
+    getUser: Sequelize.BelongsToGetAssociationMixin<AuthUserModel>;
+    setUser: Sequelize.BelongsToSetAssociationMixin<AuthUserModel, AuthUserId>;
+    createUser: Sequelize.BelongsToCreateAssociationMixin<AuthUserModel>;
+    grantedByUser?: AuthUserModel | null;
+    getGrantedByUser: Sequelize.BelongsToGetAssociationMixin<AuthUserModel>;
+    static initModel(sequelize: Sequelize.Sequelize): typeof PremiumGrantModel;
+}

package/dist/esm/src/data/models/premium-grant.js

@@ -0,0 +1,78 @@
+import { DataTypes, Model } from 'sequelize';
+export class PremiumGrantModel extends Model {
+    static initModel(sequelize) {
+        return PremiumGrantModel.init({
+            grant_id: {
+                type: DataTypes.UUID,
+                allowNull: false,
+                primaryKey: true,
+                defaultValue: DataTypes.UUIDV4
+            },
+            user_id: {
+                type: DataTypes.UUID,
+                allowNull: false,
+                references: {
+                    model: 'AuthUser',
+                    key: 'user_id'
+                }
+            },
+            tier: {
+                type: DataTypes.INTEGER,
+                allowNull: false
+            },
+            source: {
+                type: DataTypes.ENUM('ADMIN', 'PATREON'),
+                allowNull: false
+            },
+            granted_by: {
+                type: DataTypes.UUID,
+                allowNull: true,
+                references: {
+                    model: 'AuthUser',
+                    key: 'user_id'
+                }
+            },
+            granted_at: {
+                type: DataTypes.DATE,
+                allowNull: false,
+                defaultValue: DataTypes.NOW
+            },
+            expires_at: {
+                type: DataTypes.DATE,
+                allowNull: true
+            },
+            revoked_at: {
+                type: DataTypes.DATE,
+                allowNull: true
+            },
+            patreon_member_id: {
+                type: DataTypes.STRING,
+                allowNull: true
+            },
+            note: {
+                type: DataTypes.TEXT,
+                allowNull: true
+            }
+        }, {
+            sequelize,
+            tableName: 'PremiumGrant',
+            schema: 'public',
+            timestamps: false,
+            indexes: [
+                {
+                    name: 'PremiumGrant_pk',
+                    unique: true,
+                    fields: [{ name: 'grant_id' }]
+                },
+                {
+                    name: 'PremiumGrant_user_id_idx',
+                    fields: [{ name: 'user_id' }]
+                },
+                {
+                    name: 'PremiumGrant_patreon_member_id_idx',
+                    fields: [{ name: 'patreon_member_id' }]
+                }
+            ]
+        });
+    }
+}

package/dist/esm/src/data/models/team-jersey.d.ts

@@ -0,0 +1,20 @@
+import * as Sequelize from 'sequelize';
+import { Model } from 'sequelize';
+import { TeamId, TeamModel } from '.';
+import { JerseyConfig } from '../../service';
+export interface TeamJerseyAttributes {
+    team_id: string;
+    config: JerseyConfig;
+}
+export type TeamJerseyPk = 'team_id';
+export type TeamJerseyId = TeamJerseyModel[TeamJerseyPk];
+export type TeamJerseyCreationAttributes = TeamJerseyAttributes;
+export declare class TeamJerseyModel extends Model<TeamJerseyAttributes, TeamJerseyCreationAttributes> implements TeamJerseyAttributes {
+    team_id: string;
+    config: JerseyConfig;
+    team: TeamModel;
+    getTeam: Sequelize.BelongsToGetAssociationMixin<TeamModel>;
+    setTeam: Sequelize.BelongsToSetAssociationMixin<TeamModel, TeamId>;
+    createTeam: Sequelize.BelongsToCreateAssociationMixin<TeamModel>;
+    static initModel(sequelize: Sequelize.Sequelize): typeof TeamJerseyModel;
+}

package/dist/esm/src/data/models/team-jersey.js

@@ -0,0 +1,34 @@
+import { DataTypes, Model } from 'sequelize';
+export class TeamJerseyModel extends Model {
+    static initModel(sequelize) {
+        return TeamJerseyModel.init({
+            team_id: {
+                type: DataTypes.UUID,
+                allowNull: false,
+                primaryKey: true,
+                references: {
+                    model: 'Team',
+                    key: 'team_id'
+                }
+            },
+            config: {
+                type: DataTypes.JSONB,
+                allowNull: false
+            }
+        }, {
+            sequelize,
+            tableName: 'TeamJersey',
+            schema: 'public',
+            timestamps: false,
+            indexes: [
+                {
+                    name: 'TeamJersey_pk',
+                    unique: true,
+                    fields: [
+                        { name: 'team_id' }
+                    ]
+                }
+            ]
+        });
+    }
+}

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

@@ -1,6 +1,6 @@
 import * as Sequelize from 'sequelize';
 import { Model, Optional } from 'sequelize';
-import { CompetitionChampionId, CompetitionChampionModel, CompetitionId, CompetitionModel, CompetitionTeamsId, CompetitionTeamsModel, CountryId, CountryModel, DivisionAttributes, DivisionId, DivisionModel, LegacyTeamFlagModel, MatchId, MatchModel, MatchRatingId, MatchRatingModel, PlayerAttributes, PlayerId, PlayerModel, PlayerTeamId, PlayerTeamModel, RallyId, RallyModel, TacticsAttributes, TacticsId, TacticsModel } from '.';
+import { CompetitionChampionId, CompetitionChampionModel, CompetitionId, CompetitionModel, CompetitionTeamsId, CompetitionTeamsModel, CountryId, CountryModel, DivisionAttributes, DivisionId, DivisionModel, LegacyTeamFlagModel, MatchId, MatchModel, MatchRatingId, MatchRatingModel, PlayerAttributes, PlayerId, PlayerModel, PlayerTeamId, PlayerTeamModel, RallyId, RallyModel, TacticsAttributes, TacticsId, TacticsModel, TeamJerseyModel } from '.';
 export interface TeamAttributes {
     team_id: string;
     name: string;
@@ -29,6 +29,8 @@ export declare class TeamModel extends Model<TeamAttributes, TeamCreationAttribu
     getTactics: Sequelize.HasOneGetAssociationMixin<TacticsModel>;
     setTactics: Sequelize.HasOneSetAssociationMixin<TacticsModel, TacticsId>;
     createTactics: Sequelize.HasOneCreateAssociationMixin<TacticsModel>;
+    TeamJersey?: TeamJerseyModel;
+    getTeamJersey: Sequelize.HasOneGetAssociationMixin<TeamJerseyModel>;
     country: CountryModel;
     getCountry: Sequelize.BelongsToGetAssociationMixin<CountryModel>;
     setCountry: Sequelize.BelongsToSetAssociationMixin<CountryModel, CountryId>;

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

@@ -43,7 +43,10 @@ function transformToObject(model, currentIteration, tacticsOverride) {
         rating: model.rating,
         tactics,
         roster,
-        divisionId: model.division_id
+        divisionId: model.division_id,
+        // Present only when the caller explicitly included the TeamJersey association (editor / effective-jersey
+        // resolver); undefined on ordinary team loads, which heals to the id-derived default in the UI.
+        jerseyConfig: model.TeamJersey?.config
     });
 }
 export { transformToObject as transformToTeam, transformToAttributes as transformFromTeam };

package/dist/esm/src/service/competition/event-schedule.d.ts

@@ -1,5 +1,5 @@
 import { Rarity } from '../player';
-export type EventKey = 'WAR_OF_THE_COMMONS' | 'RARE_GEMS' | 'STUFF_OF_LEGENDS';
+export type EventKey = 'WAR_OF_THE_COMMONS' | 'RARE_GEMS' | 'STUFF_OF_LEGENDS' | 'AGE_OF_MYTHOLOGIES' | 'SUPER_SPECIAL';
 /**
  * How an event is played out. One member today; a new format is a new member here AND the code path in the
  * simulator that builds its schedule, which is why formats live in code rather than in a table.

package/dist/esm/src/service/competition/event-schedule.js

@@ -7,7 +7,9 @@ dayjs.extend(utc);
 export const EVENT_CATALOGUE = [
     { key: 'WAR_OF_THE_COMMONS', format: 'GROUPS_FINAL', rarity: RarityEnum.COMMON, durationDays: 7 },
     { key: 'RARE_GEMS', format: 'GROUPS_FINAL', rarity: RarityEnum.RARE, durationDays: 7 },
-    { key: 'STUFF_OF_LEGENDS', format: 'GROUPS_FINAL', rarity: RarityEnum.LEGENDARY, durationDays: 7 }
+    { key: 'STUFF_OF_LEGENDS', format: 'GROUPS_FINAL', rarity: RarityEnum.LEGENDARY, durationDays: 7 },
+    { key: 'AGE_OF_MYTHOLOGIES', format: 'GROUPS_FINAL', rarity: RarityEnum.MYTHIC, durationDays: 7 },
+    { key: 'SUPER_SPECIAL', format: 'GROUPS_FINAL', rarity: RarityEnum.SPECIAL, durationDays: 7 }
 ];
 /** An event must be long enough to hold a group stage AND a final day. */
 export const MIN_DURATION_DAYS = 2;

package/dist/esm/src/service/competition/event-schedule.test.js

@@ -3,8 +3,10 @@ import { EVENT_CATALOGUE, MAX_FINAL_SIZE, MIN_GROUP_SIZE, MIN_ROUND_SPACING_MINU
 import { RarityEnum } from '../player';
 const COMMONS = eventDefinitionForKey('WAR_OF_THE_COMMONS');
 describe('EVENT_CATALOGUE', () => {
-    it('restricts the three launch presets to a single rarity each, over one week', () => {
-        expect(EVENT_CATALOGUE.map(e => e.rarity)).toEqual([RarityEnum.COMMON, RarityEnum.RARE, RarityEnum.LEGENDARY]);
+    it('restricts each preset to a single rarity, one per rarity, over one week', () => {
+        expect(EVENT_CATALOGUE.map(e => e.rarity)).toEqual([
+            RarityEnum.COMMON, RarityEnum.RARE, RarityEnum.LEGENDARY, RarityEnum.MYTHIC, RarityEnum.SPECIAL
+        ]);
         expect(EVENT_CATALOGUE.every(e => e.durationDays === 7)).toBe(true);
         expect(EVENT_CATALOGUE.every(e => e.format === 'GROUPS_FINAL')).toBe(true);
     });

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

@@ -5,4 +5,5 @@ export * from './event';
 export * from './player';
 export * from './competition';
 export * from './notification';
+export * from './premium';
 export * from './utils';

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

@@ -5,4 +5,5 @@ export * from './event';
 export * from './player';
 export * from './competition';
 export * from './notification';
+export * from './premium';
 export * from './utils';

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

@@ -192,8 +192,8 @@ describe('selectImprovableStat()', () => {
         const cap = getStatCap(RarityEnum.COMMON); // 59
         expect(selectImprovableStat(RarityEnum.COMMON, StatsEnum.ATTACK, allStats(cap))).toBeNull();
     });
-    it('returns a stat from the SERVE focus pool (serve, awareness, attack)', () => {
-        const focusPool = new Set(['serve', 'awareness', 'attack']);
+    it('returns a stat from the SERVE focus pool (serve, awareness, focus, attack)', () => {
+        const focusPool = new Set(['serve', 'awareness', 'focus', 'attack']);
         const stats = allStats(1);
         // Run many times to confirm we never escape the focus pool
         for (let i = 0; i < 100; i++) {
@@ -213,13 +213,13 @@ describe('selectImprovableStat()', () => {
     });
     it('falls back to any improvable stat when all focus-pool stats are capped', () => {
         const cap = getStatCap(RarityEnum.COMMON);
-        // Cap the SERVE focus stats: serve, awareness, attack
-        const stats = { ...allStats(1), serve: cap, awareness: cap, attack: cap };
+        // Cap the SERVE focus stats: serve, awareness, focus, attack
+        const stats = { ...allStats(1), serve: cap, awareness: cap, focus: cap, attack: cap };
         for (let i = 0; i < 50; i++) {
             const result = selectImprovableStat(RarityEnum.COMMON, StatsEnum.SERVE, stats);
             expect(result).not.toBeNull();
             // Must never return one of the capped focus stats
-            expect(['serve', 'awareness', 'attack']).not.toContain(result);
+            expect(['serve', 'awareness', 'focus', 'attack']).not.toContain(result);
         }
     });
     it('returns a string (DB column name) not a PerformanceStatsKey', () => {

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

@@ -17,12 +17,14 @@ export function getMultipliers(statName, performanceStats) {
     switch (statName) {
         case StatsEnum.ATTACK:
             return {
-                spike: 0.55,
+                spike: 0.5,
                 backAttack: 0.1,
                 power: performanceStats == null ? 0.125 : performanceStats.power >= performanceStats.quick ? 0.2 : 0.05,
                 quick: performanceStats == null ? 0.125 : performanceStats.quick > performanceStats.power ? 0.2 : 0.05,
                 awareness: 0.05,
-                attack: 0.05
+                attack: 0.05,
+                // focus places the spike inside its aim cone (attack-shot.focusLanding): placement precision, kill vs dug.
+                focus: 0.05
             };
         case StatsEnum.SET:
             return {
@@ -31,33 +33,45 @@ export function getMultipliers(statName, performanceStats) {
                 // rating AND in the SET training pool. Without it a setter on SET focus can never raise `quick` (it has
                 // weight 0 in every role too), and their whole tempo game would be fixed forever by a generation roll.
                 quick: 0.07,
-                overhand: 0.1,
-                awareness: 0.05,
+                // set TECHNIQUE: overhand sets good passes, bump sets scramble/negative passes (both +/-15% on set score).
+                overhand: 0.08,
+                bump: 0.07,
+                // attack is the setter's crit-style upside on the set (setAttackMod in the engine, owner 2026-08-17), the
+                // same modifier the spike + serve use. awareness dropped: the engine reads it only for the setter DUMP.
                 attack: 0.05
             };
         case StatsEnum.RECEIVE:
+            // reflex carries the most (owner 2026-08-19): reception success is gated by REFLEX (the reach + lunge-save on
+            // any serve that lands out of position), not by the `reception` control stat. A low-reflex passer is aced
+            // regardless of reception -- match 3aebe480 had a Mythic (reception 88, reflex 36) shank 79% of receptions,
+            // and the league >=40%-ace group averages reflex 24-32 across every rarity. `reception` is the pass CONTROL
+            // once the ball is reached; bump/overhand are technique; defense is the pass variance; focus avoids the seam ace.
             return {
-                reception: 0.75,
-                overhand: 0.015,
-                bump: 0.15,
-                focus: 0.015,
-                defense: 0.055,
-                reflex: 0.015
+                reflex: 0.45,
+                reception: 0.3,
+                bump: 0.1,
+                overhand: 0.05,
+                defense: 0.05,
+                focus: 0.05
             };
         case StatsEnum.SERVE:
             return {
-                serve: 0.85,
-                awareness: 0.075,
-                attack: 0.075
+                serve: 0.75,
+                // awareness (target selection) + focus (aim-cone placement) are important serve drivers (owner 2026-08-17).
+                awareness: 0.1,
+                focus: 0.1,
+                attack: 0.05
             };
         case StatsEnum.BLOCK:
             return {
-                block: 0.65,
+                block: 0.6,
                 read: performanceStats == null ? 0.125 : performanceStats.read >= performanceStats.commit ? 0.2 : 0.05,
                 commit: performanceStats == null ? 0.125 : performanceStats.commit > performanceStats.read ? 0.2 : 0.05,
-                focus: 0.04,
+                // reflex sets block REACH (help blockers forming doubles/triples; dominant for surprise/dump blocks): raised
+                // from 0.02 to match its impact.
+                reflex: 0.08,
                 defense: 0.04,
-                reflex: 0.02
+                focus: 0.03
             };
         case StatsEnum.STAMINA:
             return { stamina: 1 };

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

@@ -62,10 +62,10 @@ describe('getMultipliers()', () => {
             const total = Object.values(m).reduce((s, v) => s + (v ?? 0), 0);
             expect(total).toBeCloseTo(1, 10);
         });
-        it('reception has the highest weight (0.75)', () => {
+        it('reflex has the highest weight (reflex gates the reach + lunge-save)', () => {
             const m = getMultipliers(StatsEnum.RECEIVE);
             const max = Math.max(...Object.values(m).map(v => v ?? 0));
-            expect(m.reception).toBe(max);
+            expect(m.reflex).toBe(max);
         });
     });
     describe('SERVE', () => {
@@ -145,11 +145,11 @@ describe('calculateStatScore()', () => {
         const strong = calculateStatScore(makeStats(80), StatsEnum.SERVE);
         expect(strong).toBeGreaterThan(weak);
     });
-    it('SERVE: serve=99 dominates, contributing 0.85 of the total', () => {
-        // All other serve-relevant stats at 1: awareness=1, attack=1
-        // score ≈ 99*0.85 + 1*0.075 + 1*0.075 = 84.15 + 0.15 = 84.3 → 84
+    it('SERVE: serve=99 dominates, contributing 0.75 of the total', () => {
+        // All other serve-relevant stats at 1: awareness=1, focus=1, attack=1
+        // score ≈ 99*0.75 + 1*0.1 + 1*0.1 + 1*0.05 = 74.25 + 0.25 = 74.5 → 74
         const stats = makeStats(1, { serve: 99 });
-        expect(calculateStatScore(stats, StatsEnum.SERVE)).toBe(84);
+        expect(calculateStatScore(stats, StatsEnum.SERVE)).toBe(74);
     });
 });
 // ─── invariants (every stat, every branch) ────────────────────────────────────

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

@@ -0,0 +1,3 @@
+export * from './premium-tier';
+export * from './premium-grant';
+export * from './patreon-tier-map';

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

@@ -0,0 +1,3 @@
+export * from './premium-tier';
+export * from './premium-grant';
+export * from './patreon-tier-map';

package/dist/esm/src/service/premium/patreon-tier-map.d.ts

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+export declare const PATREON_TIER_MAP_KEY = "patreon_tier_map";
+export type PatreonTierMap = Record<string, number>;
+export declare const patreonTierMapSchema: z.ZodType<PatreonTierMap>;
+export declare function resolvePremiumTier(entitledTierIds: string[], map: PatreonTierMap): number;