volleyballsimtypes 0.0.491 → 0.0.493

package/dist/esm/src/service/notification/notification-type.js

@@ -11,7 +11,12 @@ export const NOTIFICATION_TYPES = [
     'PROMOTION',
     'DAILY_LOGIN',
     'WELCOME',
-    'COMPENSATION'
+    'COMPENSATION',
+    'EVENT_REGISTRATION_OPEN',
+    'EVENT_REGISTRATION_CLOSING',
+    'EVENT_STARTED',
+    'EVENT_FINAL_ROUND',
+    'EVENT_FINISHED'
 ];
 // The 7 supported locales. Must stay in sync with the API VALID_LOCALES set and the UI src/locales/*.json.
 export const NOTIFICATION_LOCALES = ['en', 'es', 'fr', 'it', 'pl', 'pt-BR', 'tr'];

package/dist/esm/src/service/notification/notification.test.js

@@ -130,7 +130,9 @@ describe('push preferences (PUSH_NOTIFICATION_TYPES + pushEnabledFor)', () => {
             .toEqual(NOTIFICATION_TYPES.filter((t) => NOTIFICATION_REGISTRY[t].emitsPush).sort((a, b) => a.localeCompare(b)));
         expect(PUSH_NOTIFICATION_TYPES).not.toContain('COMPENSATION');
         expect(PUSH_NOTIFICATION_TYPES).toContain('MATCH_RESULT');
-        expect(PUSH_NOTIFICATION_TYPES).toHaveLength(8);
+        // COMPENSATION is the ONLY in-app-only type, so every other type pushes. Expressed as a relationship
+        // rather than a count, so adding a type does not need this number edited.
+        expect(PUSH_NOTIFICATION_TYPES).toHaveLength(NOTIFICATION_TYPES.length - 1);
     });
     it('is opt-out: absent / null / empty / true all enable, only explicit false suppresses', () => {
         expect(pushEnabledFor(undefined, 'MATCH_RESULT')).toBe(true);

package/dist/esm/src/service/notification/registry.js

@@ -85,6 +85,58 @@ export const NOTIFICATION_REGISTRY = {
         inAppMessageKey: 'promotion.body',
         catalogKeys: ['promotion.title', 'promotion.body']
     },
+    // In-game events. All five deep-link to the Events section, which is where every phase of an event lives.
+    // eventName is the event's key; the UI resolves it to the translated name, so the catalog copy interpolates
+    // a key rather than a localised string the sender would have to translate.
+    EVENT_REGISTRATION_OPEN: {
+        emitsPush: true,
+        deepLink: () => '/events',
+        pushTitleKey: 'eventRegistrationOpen.title',
+        pushBodyKey: 'eventRegistrationOpen.body',
+        inAppMessageKey: 'eventRegistrationOpen.body',
+        catalogKeys: ['eventRegistrationOpen.title', 'eventRegistrationOpen.body']
+    },
+    EVENT_REGISTRATION_CLOSING: {
+        emitsPush: true,
+        deepLink: () => '/events',
+        pushTitleKey: 'eventRegistrationClosing.title',
+        pushBodyKey: 'eventRegistrationClosing.body',
+        inAppMessageKey: 'eventRegistrationClosing.body',
+        catalogKeys: ['eventRegistrationClosing.title', 'eventRegistrationClosing.body']
+    },
+    EVENT_STARTED: {
+        emitsPush: true,
+        deepLink: () => '/events',
+        pushTitleKey: 'eventStarted.title',
+        pushBodyKey: 'eventStarted.body',
+        inAppMessageKey: 'eventStarted.body',
+        catalogKeys: ['eventStarted.title', 'eventStarted.body']
+    },
+    EVENT_FINAL_ROUND: {
+        emitsPush: true,
+        deepLink: () => '/events',
+        pushTitleKey: 'eventFinalRound.title',
+        pushBodyKey: 'eventFinalRound.body',
+        inAppMessageKey: 'eventFinalRound.body',
+        catalogKeys: ['eventFinalRound.title', 'eventFinalRound.body']
+    },
+    EVENT_FINISHED: {
+        emitsPush: true,
+        deepLink: () => '/events',
+        pushTitleKey: 'eventFinished.title',
+        // Copy depends on whether we know where they finished; a missing position never renders "You finished th".
+        pushBodyKey: (p) => readString(p.position) != null || typeof p.position === 'number'
+            ? 'eventFinished.placed'
+            : 'eventFinished.body',
+        inAppMessageKey: (p) => readString(p.position) != null || typeof p.position === 'number'
+            ? 'eventFinished.placed'
+            : 'eventFinished.body',
+        params: (p) => ({
+            position: typeof p.position === 'number' ? String(p.position) : (readString(p.position) ?? ''),
+            entrants: typeof p.entrants === 'number' ? String(p.entrants) : (readString(p.entrants) ?? '')
+        }),
+        catalogKeys: ['eventFinished.title', 'eventFinished.body', 'eventFinished.placed']
+    },
     DAILY_LOGIN: {
         emitsPush: true,
         // Fires when the reward becomes claimable (00:00 UTC), so it opens the daily-login claim view.

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

@@ -35,13 +35,14 @@ export interface GachaPullConfig {
 }
 export declare const NORMAL_PULL_CONFIG: GachaPullConfig;
 export declare const QUALIFIER_PULL_CONFIG: GachaPullConfig;
+export declare const EVENT_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();
     private static generatePerformance;
-    static generatePlayer(country: Country, _rarity?: Rarity, role?: Role, maxTraits?: boolean, birthIteration?: number): Player;
+    static generatePlayer(country: Country, _rarity?: Rarity, role?: Role, maxTraits?: boolean, birthIteration?: number, topSkew?: 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

@@ -63,6 +63,21 @@ export const QUALIFIER_PULL_CONFIG = {
     accumulateMythicPity: true,
     accumulateSpecialPity: true
 };
+// Event Pack (x5): the NATIONAL pool and structure, with TRIPLE the legendary and mythic chance. Special is
+// untouched and rare absorbs the difference, so it still sums to 1. Builds all three pities, like NATIONAL.
+// Owner-defined 2026-07-23.
+export const EVENT_PULL_CONFIG = {
+    special: 0.003,
+    mythic: 0.03,
+    legendary: 0.30,
+    rare: 0.667,
+    applyLegendaryPity: true,
+    applyMythicPity: true,
+    applySpecialPity: true,
+    accumulateLegendaryPity: true,
+    accumulateMythicPity: true,
+    accumulateSpecialPity: true
+};
 // Tournament gacha (x5 per match): LEGENDARY–SPECIAL, no legendary pity (floor is legendary)
 export const TOURNAMENT_PULL_CONFIG = {
     special: 0.01,
@@ -188,7 +203,7 @@ export function rollRarity(pity, config = WORLD_PULL_CONFIG) {
 /* eslint-disable @typescript-eslint/no-extraneous-class */
 export class PlayerGenerator {
     constructor() { }
-    static generatePerformance(rarity, role) {
+    static generatePerformance(rarity, role, topSkew = 0) {
         const ATTACK = getMultipliers(StatsEnum.ATTACK);
         const SET = getMultipliers(StatsEnum.SET);
         const RECEIVE = getMultipliers(StatsEnum.RECEIVE);
@@ -199,8 +214,10 @@ export class PlayerGenerator {
                 // Stamina always uses its own per-rarity range (guaranteed floor), regardless of role weight.
                 if (key === 'stamina')
                     return [key, rollStamina(rarity)];
+                // On-role stats drive the role score, so a positive topSkew bends only these toward the top of the
+                // range; off-role stats stay uniform. topSkew defaults to 0 (the historic uniform draw).
                 if (weights[key] > 0)
-                    return [key, randomInt(minValue, maxValue + 1)];
+                    return [key, randomIntSkewed(minValue, maxValue, topSkew)];
                 else
                     return [key, randomInt(RarityRanges.COMMON[0], Math.max(minValue - 1, RarityRanges.COMMON[0] + 1))];
             })));
@@ -294,10 +311,10 @@ export class PlayerGenerator {
             }
         }
     }
-    static generatePlayer(country, _rarity, role, maxTraits, birthIteration = 1) {
+    static generatePlayer(country, _rarity, role, maxTraits, birthIteration = 1, topSkew = 0) {
         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 stats = PlayerGenerator.generatePerformance(rarity, role, topSkew);
         const roles = assignRoles(stats, rarity, role);
         const traits = assignTraits(roles, rarity, maxTraits);
         const birthAge = randomInt(15, 21);
@@ -338,6 +355,21 @@ function rollStamina(rarity) {
     const [low, high] = StaminaRanges[rarity];
     return randomInt(low, high + 1);
 }
+/**
+ * A crypto.randomInt draw over [min, max] inclusive, optionally skewed toward the top.
+ *
+ * skew = 0 is the plain uniform draw the generator has always used. A positive skew bends a uniform fraction
+ * upward with u^(1/(1+skew)), so higher values become progressively likelier while the maximum is never forced,
+ * which keeps the result random rather than a maxed stat. Event drafts use this to make the lower rarities'
+ * recruits cluster near the top of their range (see EVENT_DRAFT_TOP_SKEW).
+ */
+function randomIntSkewed(min, max, skew) {
+    if (skew <= 0 || max <= min)
+        return randomInt(min, max + 1);
+    const u = randomInt(0, 1000001) / 1000000;
+    const frac = Math.pow(u, 1 / (1 + skew));
+    return min + Math.round(frac * (max - min));
+}
 function assignValues(stat, low, high, performance) {
     performanceStatKeys.filter((key) => stat[key] != null && stat[key] > 0)
         .forEach((key) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "volleyballsimtypes",
-  "version": "0.0.491",
+  "version": "0.0.493",
   "description": "vbsim types",
   "main": "./dist/cjs/src/index.js",
   "module": "./dist/esm/src/index.js",
@@ -42,6 +42,11 @@
       "import": "./dist/esm/src/service/notification/index.js",
       "require": "./dist/cjs/src/service/notification/index.js"
     },
+    "./api": {
+      "types": "./dist/esm/src/api/index.d.ts",
+      "import": "./dist/esm/src/api/index.js",
+      "require": "./dist/cjs/src/api/index.js"
+    },
     "./stat-config": {
       "types": "./dist/esm/src/stat-config/index.d.ts",
       "import": "./dist/esm/src/stat-config/index.js",