volleyballsimtypes 0.0.523 → 0.0.525

package/dist/esm/src/service/notification/catalog/pl.json

@@ -62,5 +62,34 @@
     "regionRelocation": {
         "title": "Twoja drużyna się przenosi",
         "body": "Twoja drużyna została wybrana do przeniesienia do nowego regionu: Kyorin. Nic się nie zmienia, jeśli chodzi o zarządzaną przez ciebie drużynę, twoich zawodników ani cokolwiek innego."
+    },
+    "wnlCallupOpen": {
+        "title": "Powołania do reprezentacji otwarte",
+        "body": "Faza powołań do reprezentacji rozpoczęła się! Masz czas do {{date}}, aby wybrać swoją drużynę do udziału w następnej edycji WNL."
+    },
+    "wnlCallupDeadline": {
+        "title": "Termin powołań mija dzisiaj",
+        "body": "Termin powołań do reprezentacji mija dzisiaj. Upewnij się, że wybrałeś zawodników, którzy wezmą udział w następnej edycji WNL."
+    },
+    "wnlCallupClosed": {
+        "title": "Powołania do reprezentacji zamknięte",
+        "body": "Faza powołań do reprezentacji zakończyła się. Możesz edytować swój skład, aby przygotować się do WNL, która zaczyna się w najbliższy poniedziałek!"
+    },
+    "wnlLeagueStart": {
+        "title": "Liga WNL rozpoczęta",
+        "body": "Faza ligowa WNL rozpoczęła się!"
+    },
+    "wnlFinalsStart": {
+        "title": "Finały WNL rozpoczęte",
+        "body": "Finały WNL rozpoczęły się!"
+    },
+    "wnlChampion": {
+        "title": "Mistrzowie WNL",
+        "body": "Edycja WNL zakończyła się. {{team}} to mistrzowie WNL!",
+        "bodyUnnamed": "Edycja WNL zakończyła się. Mistrzowie zostali wyłonieni!"
+    },
+    "wnlPlayerCalledUp": {
+        "title": "Zawodnicy powołani",
+        "body": "Co najmniej jeden z twoich zawodników został powołany do swojej reprezentacji!"
     }
 }

package/dist/esm/src/service/notification/catalog/pt-BR.json

@@ -62,5 +62,34 @@
     "regionRelocation": {
         "title": "Seu time está mudando",
         "body": "Seu time foi escolhido para ser movido para a nova região: Kyorin. Nada muda em relação ao time que você gerencia, seus jogadores ou qualquer outra coisa."
+    },
+    "wnlCallupOpen": {
+        "title": "Convocação nacional aberta",
+        "body": "A fase de convocação nacional começou! Você tem até {{date}} para selecionar seu time e participar da próxima edição da WNL."
+    },
+    "wnlCallupDeadline": {
+        "title": "A convocação termina hoje",
+        "body": "O prazo da convocação nacional termina hoje. Verifique se você selecionou os jogadores que participarão da próxima edição da WNL."
+    },
+    "wnlCallupClosed": {
+        "title": "Convocação nacional encerrada",
+        "body": "A fase de convocação nacional terminou. Você pode editar sua escalação para se preparar para a WNL que começa na próxima segunda-feira!"
+    },
+    "wnlLeagueStart": {
+        "title": "A liga WNL começou",
+        "body": "A fase de liga da WNL começou!"
+    },
+    "wnlFinalsStart": {
+        "title": "As finais da WNL começaram",
+        "body": "As finais da WNL começaram!"
+    },
+    "wnlChampion": {
+        "title": "Campeões da WNL",
+        "body": "A edição da WNL terminou. {{team}} são os campeões da WNL!",
+        "bodyUnnamed": "A edição da WNL terminou. Os campeões foram coroados!"
+    },
+    "wnlPlayerCalledUp": {
+        "title": "Jogadores convocados",
+        "body": "Um ou mais dos seus jogadores foram convocados pela sua seleção nacional!"
     }
 }

package/dist/esm/src/service/notification/catalog/tr.json

@@ -62,5 +62,34 @@
     "regionRelocation": {
         "title": "Takımın taşınıyor",
         "body": "Takımın yeni bölgeye, Kyorin'e taşınmak üzere seçildi. Yönettiğin takım, oyuncuların ya da başka hiçbir şey açısından hiçbir şey değişmiyor."
+    },
+    "wnlCallupOpen": {
+        "title": "Milli takım kadro çağrısı açıldı",
+        "body": "Milli takım kadro çağrısı başladı! Bir sonraki WNL sezonuna katılacak takımını seçmek için {{date}} tarihine kadar vaktin var."
+    },
+    "wnlCallupDeadline": {
+        "title": "Kadro çağrısı bugün sona eriyor",
+        "body": "Milli takım kadro çağrısının son günü bugün. Bir sonraki WNL sezonunda oynayacak oyuncuları seçtiğinden emin ol."
+    },
+    "wnlCallupClosed": {
+        "title": "Kadro çağrısı kapandı",
+        "body": "Milli takım kadro çağrısı sona erdi. Önümüzdeki pazartesi başlayacak WNL için dizilişini düzenleyebilirsin!"
+    },
+    "wnlLeagueStart": {
+        "title": "WNL ligi başladı",
+        "body": "WNL lig aşaması başladı!"
+    },
+    "wnlFinalsStart": {
+        "title": "WNL finalleri başladı",
+        "body": "WNL finalleri başladı!"
+    },
+    "wnlChampion": {
+        "title": "WNL şampiyonları",
+        "body": "WNL sezonu sona erdi. {{team}} WNL şampiyonu oldu!",
+        "bodyUnnamed": "WNL sezonu sona erdi. Şampiyonlar belli oldu!"
+    },
+    "wnlPlayerCalledUp": {
+        "title": "Oyuncular milli takıma çağrıldı",
+        "body": "Bir veya daha fazla oyuncun milli takımına çağrıldı!"
     }
 }

package/dist/esm/src/service/notification/notification-type.d.ts

@@ -1,4 +1,4 @@
-export declare const NOTIFICATION_TYPES: readonly ["MATCH_RESULT", "INJURY", "INJURY_RECOVERED", "SEASON_END", "GRANT_RECEIVED", "PROMOTION", "DAILY_LOGIN", "WELCOME", "COMPENSATION", "EVENT_REGISTRATION_OPEN", "EVENT_REGISTRATION_CLOSING", "EVENT_STARTED", "EVENT_FINAL_ROUND", "EVENT_FINISHED", "REGION_RELOCATION"];
+export declare const NOTIFICATION_TYPES: readonly ["MATCH_RESULT", "INJURY", "INJURY_RECOVERED", "SEASON_END", "GRANT_RECEIVED", "PROMOTION", "DAILY_LOGIN", "WELCOME", "COMPENSATION", "EVENT_REGISTRATION_OPEN", "EVENT_REGISTRATION_CLOSING", "EVENT_STARTED", "EVENT_FINAL_ROUND", "EVENT_FINISHED", "REGION_RELOCATION", "WNL_CALLUP_OPEN", "WNL_CALLUP_DEADLINE", "WNL_CALLUP_CLOSED", "WNL_LEAGUE_START", "WNL_FINALS_START", "WNL_CHAMPION", "WNL_PLAYER_CALLED_UP"];
 export type NotificationType = typeof NOTIFICATION_TYPES[number];
 export declare const NOTIFICATION_LOCALES: readonly ["en", "es", "fr", "it", "pl", "pt-BR", "tr"];
 export type NotificationLocale = typeof NOTIFICATION_LOCALES[number];

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

@@ -17,7 +17,14 @@ export const NOTIFICATION_TYPES = [
     'EVENT_STARTED',
     'EVENT_FINAL_ROUND',
     'EVENT_FINISHED',
-    'REGION_RELOCATION'
+    'REGION_RELOCATION',
+    'WNL_CALLUP_OPEN',
+    'WNL_CALLUP_DEADLINE',
+    'WNL_CALLUP_CLOSED',
+    'WNL_LEAGUE_START',
+    'WNL_FINALS_START',
+    'WNL_CHAMPION',
+    'WNL_PLAYER_CALLED_UP'
 ];
 // 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

@@ -1,6 +1,6 @@
 import { describe, it, expect } from '@jest/globals';
 import { NOTIFICATION_TYPES, NOTIFICATION_LOCALES, pushEnabledFor } from './notification-type';
-import { NOTIFICATION_REGISTRY, PUSH_NOTIFICATION_TYPES } from './registry';
+import { NOTIFICATION_REGISTRY, PUSH_NOTIFICATION_TYPES, PUSH_PREF_KEYS, pushEnabledForType, pushPrefKeyFor } from './registry';
 import { NOTIFICATION_CATALOG } from './catalog';
 import { renderPush, notificationPath, interpolate, translateNotification } from './render';
 function readNested(node, dotKey) {
@@ -143,4 +143,22 @@ describe('push preferences (PUSH_NOTIFICATION_TYPES + pushEnabledFor)', () => {
         // disabling one type does not affect another
         expect(pushEnabledFor({ MATCH_RESULT: false }, 'INJURY')).toBe(true);
     });
+    it('groups the WNL types under the single WNL preference key', () => {
+        // Every WNL type resolves to the shared toggle; ungrouped types resolve to themselves.
+        for (const type of NOTIFICATION_TYPES.filter((t) => t.startsWith('WNL_'))) {
+            expect(pushPrefKeyFor(type)).toBe('WNL');
+        }
+        expect(pushPrefKeyFor('MATCH_RESULT')).toBe('MATCH_RESULT');
+        expect(pushPrefKeyFor('UNKNOWN_TYPE')).toBe('UNKNOWN_TYPE');
+        // The one WNL toggle gates every WNL type's push; individual WNL type keys are never consulted.
+        expect(pushEnabledForType({ WNL: false }, 'WNL_CALLUP_OPEN')).toBe(false);
+        expect(pushEnabledForType({ WNL: false }, 'WNL_CHAMPION')).toBe(false);
+        expect(pushEnabledForType({}, 'WNL_CHAMPION')).toBe(true);
+        expect(pushEnabledForType({ WNL_CHAMPION: false }, 'WNL_CHAMPION')).toBe(true);
+        expect(pushEnabledForType({ MATCH_RESULT: false }, 'MATCH_RESULT')).toBe(false);
+        // The toggleable key set collapses the seven WNL types into one 'WNL' entry and keeps the rest per-type.
+        expect(PUSH_PREF_KEYS.filter((k) => k === 'WNL')).toHaveLength(1);
+        expect(PUSH_PREF_KEYS).not.toContain('WNL_CALLUP_OPEN');
+        expect(PUSH_PREF_KEYS).toContain('MATCH_RESULT');
+    });
 });

package/dist/esm/src/service/notification/payloads.d.ts

@@ -31,4 +31,10 @@ export interface PromotionPayload {
     teamId?: string;
     amount?: number;
 }
-export type NotificationPayload = MatchResultPayload | InjuryPayload | InjuryRecoveredPayload | SeasonEndPayload | PromotionPayload | Record<string, unknown>;
+export interface WnlCallupOpenPayload {
+    deadline?: string;
+}
+export interface WnlChampionPayload {
+    team?: string;
+}
+export type NotificationPayload = MatchResultPayload | InjuryPayload | InjuryRecoveredPayload | SeasonEndPayload | PromotionPayload | WnlCallupOpenPayload | WnlChampionPayload | Record<string, unknown>;

package/dist/esm/src/service/notification/registry.d.ts

@@ -1,7 +1,8 @@
-import { type NotificationType } from './notification-type';
+import { type NotificationPreferences, type NotificationType } from './notification-type';
 export type CatalogKeyResolver = string | ((payload: Record<string, unknown>) => string);
 export interface NotificationDescriptor {
     emitsPush: boolean;
+    prefKey?: string;
     deepLink?: (payload: Record<string, unknown>) => string;
     pushTitleKey?: CatalogKeyResolver;
     pushBodyKey?: CatalogKeyResolver;
@@ -12,3 +13,6 @@ export interface NotificationDescriptor {
 }
 export declare const NOTIFICATION_REGISTRY: Record<NotificationType, NotificationDescriptor>;
 export declare const PUSH_NOTIFICATION_TYPES: NotificationType[];
+export declare function pushPrefKeyFor(type: string): string;
+export declare function pushEnabledForType(prefs: NotificationPreferences | null | undefined, type: string): boolean;
+export declare const PUSH_PREF_KEYS: string[];

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

@@ -1,4 +1,4 @@
-import { NOTIFICATION_TYPES } from './notification-type';
+import { NOTIFICATION_TYPES, pushEnabledFor } from './notification-type';
 function readString(value) {
     return typeof value === 'string' && value !== '' ? value : null;
 }
@@ -168,9 +168,94 @@ export const NOTIFICATION_REGISTRY = {
         pushBodyKey: 'regionRelocation.body',
         inAppMessageKey: 'regionRelocation.body',
         catalogKeys: ['regionRelocation.title', 'regionRelocation.body']
+    },
+    // World Nations League (owner 2026-08-28). All seven share the single 'WNL' preference toggle. The three callup
+    // types go to national team managers, LEAGUE_START/FINALS_START/CHAMPION are broadcast to every active user, and
+    // PLAYER_CALLED_UP goes to club owners with at least one player in a finalized squad.
+    WNL_CALLUP_OPEN: {
+        emitsPush: true,
+        prefKey: 'WNL',
+        deepLink: () => '/wnl/callup',
+        pushTitleKey: 'wnlCallupOpen.title',
+        pushBodyKey: 'wnlCallupOpen.body',
+        inAppMessageKey: 'wnlCallupOpen.body',
+        // The deadline arrives pre-formatted (locale-neutral 'YYYY-MM-DD HH:mm UTC') because the stored payload is
+        // shared by the push and the in-app bell and cannot be re-localised per render.
+        params: (p) => ({ date: readString(p.deadline) ?? '' }),
+        catalogKeys: ['wnlCallupOpen.title', 'wnlCallupOpen.body']
+    },
+    WNL_CALLUP_DEADLINE: {
+        emitsPush: true,
+        prefKey: 'WNL',
+        deepLink: () => '/wnl/callup',
+        pushTitleKey: 'wnlCallupDeadline.title',
+        pushBodyKey: 'wnlCallupDeadline.body',
+        inAppMessageKey: 'wnlCallupDeadline.body',
+        catalogKeys: ['wnlCallupDeadline.title', 'wnlCallupDeadline.body']
+    },
+    WNL_CALLUP_CLOSED: {
+        emitsPush: true,
+        prefKey: 'WNL',
+        deepLink: () => '/wnl/manage/lineup',
+        pushTitleKey: 'wnlCallupClosed.title',
+        pushBodyKey: 'wnlCallupClosed.body',
+        inAppMessageKey: 'wnlCallupClosed.body',
+        catalogKeys: ['wnlCallupClosed.title', 'wnlCallupClosed.body']
+    },
+    WNL_LEAGUE_START: {
+        emitsPush: true,
+        prefKey: 'WNL',
+        deepLink: () => '/wnl',
+        pushTitleKey: 'wnlLeagueStart.title',
+        pushBodyKey: 'wnlLeagueStart.body',
+        inAppMessageKey: 'wnlLeagueStart.body',
+        catalogKeys: ['wnlLeagueStart.title', 'wnlLeagueStart.body']
+    },
+    WNL_FINALS_START: {
+        emitsPush: true,
+        prefKey: 'WNL',
+        deepLink: () => '/wnl/finals',
+        pushTitleKey: 'wnlFinalsStart.title',
+        pushBodyKey: 'wnlFinalsStart.body',
+        inAppMessageKey: 'wnlFinalsStart.body',
+        catalogKeys: ['wnlFinalsStart.title', 'wnlFinalsStart.body']
+    },
+    WNL_CHAMPION: {
+        emitsPush: true,
+        prefKey: 'WNL',
+        deepLink: () => '/wnl/finals',
+        pushTitleKey: 'wnlChampion.title',
+        // A missing team name never renders a subjectless sentence (mirrors the MATCH_RESULT named/unnamed split).
+        pushBodyKey: (p) => readString(p.team) != null ? 'wnlChampion.body' : 'wnlChampion.bodyUnnamed',
+        inAppMessageKey: (p) => readString(p.team) != null ? 'wnlChampion.body' : 'wnlChampion.bodyUnnamed',
+        params: (p) => ({ team: readString(p.team) ?? '' }),
+        catalogKeys: ['wnlChampion.title', 'wnlChampion.body', 'wnlChampion.bodyUnnamed']
+    },
+    WNL_PLAYER_CALLED_UP: {
+        emitsPush: true,
+        prefKey: 'WNL',
+        deepLink: () => '/wnl/teams',
+        pushTitleKey: 'wnlPlayerCalledUp.title',
+        pushBodyKey: 'wnlPlayerCalledUp.body',
+        inAppMessageKey: 'wnlPlayerCalledUp.body',
+        catalogKeys: ['wnlPlayerCalledUp.title', 'wnlPlayerCalledUp.body']
     }
 };
 // The notification types that emit a mobile push (everything except COMPENSATION). Source of truth = each
-// descriptor's emitsPush, so this cannot drift. This is the user-toggleable set surfaced in the mobile app's
-// notification settings and validated by the API before persisting a preference.
+// descriptor's emitsPush, so this cannot drift.
 export const PUSH_NOTIFICATION_TYPES = NOTIFICATION_TYPES.filter((type) => NOTIFICATION_REGISTRY[type].emitsPush);
+// The preference-map key a type's push toggle lives under: the descriptor's prefKey (group toggle) or the type
+// itself. Unknown types resolve to themselves, mirroring pushEnabledFor's loose-string tolerance.
+export function pushPrefKeyFor(type) {
+    const descriptor = NOTIFICATION_REGISTRY[type];
+    return descriptor?.prefKey ?? type;
+}
+// Group-aware push gate: like pushEnabledFor, but resolves the type's preference GROUP first, so muting the one
+// 'WNL' toggle suppresses every WNL type's push. Senders (Sim/API insertNotification) use THIS, not pushEnabledFor.
+export function pushEnabledForType(prefs, type) {
+    return pushEnabledFor(prefs, pushPrefKeyFor(type));
+}
+// The user-toggleable keys surfaced in the mobile app's notification settings and validated by the API before
+// persisting a preference: one entry per DISTINCT pref key (individual types plus each group toggle once),
+// in first-appearance order.
+export const PUSH_PREF_KEYS = [...new Set(PUSH_NOTIFICATION_TYPES.map((type) => pushPrefKeyFor(type)))];

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

@@ -8,3 +8,5 @@ export declare const PREMIUM_TIERS: PremiumTierDef[];
 export declare const MAX_PREMIUM_TIER: number;
 export declare function premiumTierDef(tier: number): PremiumTierDef | undefined;
 export declare function hasTier(effectiveTier: number, required: number): boolean;
+export declare const TIER_NATIONAL = 2;
+export declare function canManageNationalTeam(effectiveTier: number): boolean;

package/dist/esm/src/service/premium/premium-tier.js

@@ -17,3 +17,9 @@ export function premiumTierDef(tier) {
 export function hasTier(effectiveTier, required) {
     return effectiveTier >= required;
 }
+// Tier 2 (NATIONAL) unlocks World Cup / national-team management (claiming and managing a national team, the WNL
+// callup, lineup and kit). Gate every national-team write on this.
+export const TIER_NATIONAL = 2;
+export function canManageNationalTeam(effectiveTier) {
+    return hasTier(effectiveTier, TIER_NATIONAL);
+}

package/package.json

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