volleyballsimtypes 0.0.523 → 0.0.525

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

@@ -16,12 +16,14 @@ dayjs_1.default.extend(utc_1.default);
 const MATCH_SPACING_MINUTES = 30;
 // eslint-disable-next-line @typescript-eslint/no-extraneous-class
 class MatchGenerator {
-    static generateMatches(teams, baseDate) {
+    static generateMatches(teams, baseDate, options = {}) {
+        const spacingMinutes = options.spacingMinutes ?? MATCH_SPACING_MINUTES;
+        const startHourUTC = options.startHourUTC ?? 0;
         const t = new Set(teams.map(x => x.id));
-        // Anchor the first match to 00:00 UTC of the iteration's start day (Monday), so league rounds fall on the
+        // Anchor the first match to `startHourUTC`:00 UTC of the iteration's start day (Monday), so rounds fall on the
         // same wall-clock time everywhere regardless of the host timezone. startOf('day') in UTC avoids the
         // local-timezone roll the old startOf('hour') was exposed to on a fractional-hour-offset host.
-        let date = dayjs_1.default.utc(baseDate).startOf('day');
+        let date = dayjs_1.default.utc(baseDate).startOf('day').add(startHourUTC, 'hour');
         if (t.size !== teams.length) {
             throw new Error('DUPLICATE_TEAMS');
         }
@@ -30,7 +32,7 @@ class MatchGenerator {
         }
         const nextDate = () => {
             const scheduledDate = date.toDate();
-            date = date.add(MATCH_SPACING_MINUTES, 'minutes');
+            date = date.add(spacingMinutes, 'minutes');
             return scheduledDate;
         };
         // First leg: one pass of the round robin, matches laid out back to back in round order.

package/dist/cjs/src/service/notification/catalog/en.json

@@ -62,5 +62,34 @@
     "regionRelocation": {
         "title": "Your team is moving",
         "body": "Your team has been chosen to be moved to the new region: Kyorin. Nothing has changed in terms of the team you manage, your players or anything else."
+    },
+    "wnlCallupOpen": {
+        "title": "National call-up open",
+        "body": "The national call-up phase has begun! You have until {{date}} to select your team to participate in the next edition of the WNL."
+    },
+    "wnlCallupDeadline": {
+        "title": "Call-up deadline today",
+        "body": "The national call-up deadline is today. Make sure you have selected the players that will participate in the next edition of the WNL."
+    },
+    "wnlCallupClosed": {
+        "title": "National call-up closed",
+        "body": "The national call-up phase has ended. You can edit your line-up to prepare for the WNL starting next Monday!"
+    },
+    "wnlLeagueStart": {
+        "title": "WNL league started",
+        "body": "The WNL League phase has started!"
+    },
+    "wnlFinalsStart": {
+        "title": "WNL finals started",
+        "body": "The WNL finals have started!"
+    },
+    "wnlChampion": {
+        "title": "WNL champions crowned",
+        "body": "The WNL edition has ended. {{team}} are the WNL champions!",
+        "bodyUnnamed": "The WNL edition has ended. The champions have been crowned!"
+    },
+    "wnlPlayerCalledUp": {
+        "title": "Players called up",
+        "body": "One or more of your players have been called-up to their national team!"
     }
 }

package/dist/cjs/src/service/notification/catalog/es.json

@@ -62,5 +62,34 @@
     "regionRelocation": {
         "title": "Tu equipo se traslada",
         "body": "Tu equipo ha sido elegido para trasladarse a la nueva región: Kyorin. No cambia nada en cuanto al equipo que gestionas, tus jugadores ni nada más."
+    },
+    "wnlCallupOpen": {
+        "title": "Convocatoria nacional abierta",
+        "body": "¡La fase de convocatoria nacional ha comenzado! Tienes hasta el {{date}} para seleccionar tu equipo y participar en la próxima edición de la WNL."
+    },
+    "wnlCallupDeadline": {
+        "title": "La convocatoria cierra hoy",
+        "body": "El plazo de la convocatoria nacional termina hoy. Asegúrate de haber seleccionado a los jugadores que participarán en la próxima edición de la WNL."
+    },
+    "wnlCallupClosed": {
+        "title": "Convocatoria nacional cerrada",
+        "body": "La fase de convocatoria nacional ha terminado. ¡Puedes editar tu alineación para preparar la WNL que empieza el próximo lunes!"
+    },
+    "wnlLeagueStart": {
+        "title": "La liga WNL ha empezado",
+        "body": "¡La fase de liga de la WNL ha comenzado!"
+    },
+    "wnlFinalsStart": {
+        "title": "Las finales de la WNL han empezado",
+        "body": "¡Las finales de la WNL han comenzado!"
+    },
+    "wnlChampion": {
+        "title": "Campeones de la WNL",
+        "body": "La edición de la WNL ha terminado. ¡{{team}} son los campeones de la WNL!",
+        "bodyUnnamed": "La edición de la WNL ha terminado. ¡Ya hay campeones!"
+    },
+    "wnlPlayerCalledUp": {
+        "title": "Jugadores convocados",
+        "body": "¡Uno o más de tus jugadores han sido convocados por su selección nacional!"
     }
 }

package/dist/cjs/src/service/notification/catalog/fr.json

@@ -62,5 +62,34 @@
     "regionRelocation": {
         "title": "Votre équipe déménage",
         "body": "Votre équipe a été choisie pour être transférée vers la nouvelle région : Kyorin. Rien ne change concernant l'équipe que vous gérez, vos joueurs ni quoi que ce soit d'autre."
+    },
+    "wnlCallupOpen": {
+        "title": "Convocation nationale ouverte",
+        "body": "La phase de convocation nationale a commencé ! Vous avez jusqu'au {{date}} pour sélectionner votre équipe et participer à la prochaine édition de la WNL."
+    },
+    "wnlCallupDeadline": {
+        "title": "La convocation se termine aujourd'hui",
+        "body": "La date limite de la convocation nationale est aujourd'hui. Assurez-vous d'avoir sélectionné les joueurs qui participeront à la prochaine édition de la WNL."
+    },
+    "wnlCallupClosed": {
+        "title": "Convocation nationale terminée",
+        "body": "La phase de convocation nationale est terminée. Vous pouvez modifier votre composition pour préparer la WNL qui commence lundi prochain !"
+    },
+    "wnlLeagueStart": {
+        "title": "La ligue WNL a commencé",
+        "body": "La phase de ligue de la WNL a commencé !"
+    },
+    "wnlFinalsStart": {
+        "title": "Les finales de la WNL ont commencé",
+        "body": "Les finales de la WNL ont commencé !"
+    },
+    "wnlChampion": {
+        "title": "Champions de la WNL",
+        "body": "L'édition de la WNL est terminée. {{team}} sont les champions de la WNL !",
+        "bodyUnnamed": "L'édition de la WNL est terminée. Les champions sont couronnés !"
+    },
+    "wnlPlayerCalledUp": {
+        "title": "Joueurs convoqués",
+        "body": "Un ou plusieurs de vos joueurs ont été convoqués par leur équipe nationale !"
     }
 }

package/dist/cjs/src/service/notification/catalog/it.json

@@ -62,5 +62,34 @@
     "regionRelocation": {
         "title": "La tua squadra si trasferisce",
         "body": "La tua squadra è stata scelta per essere spostata nella nuova regione: Kyorin. Non cambia nulla riguardo alla squadra che gestisci, ai tuoi giocatori o a qualsiasi altra cosa."
+    },
+    "wnlCallupOpen": {
+        "title": "Convocazione nazionale aperta",
+        "body": "La fase di convocazione nazionale è iniziata! Hai tempo fino al {{date}} per selezionare la tua squadra e partecipare alla prossima edizione della WNL."
+    },
+    "wnlCallupDeadline": {
+        "title": "La convocazione scade oggi",
+        "body": "Il termine della convocazione nazionale è oggi. Assicurati di aver selezionato i giocatori che parteciperanno alla prossima edizione della WNL."
+    },
+    "wnlCallupClosed": {
+        "title": "Convocazione nazionale chiusa",
+        "body": "La fase di convocazione nazionale è terminata. Puoi modificare la tua formazione per preparare la WNL che inizia lunedì prossimo!"
+    },
+    "wnlLeagueStart": {
+        "title": "La lega WNL è iniziata",
+        "body": "La fase di lega della WNL è iniziata!"
+    },
+    "wnlFinalsStart": {
+        "title": "Le finali della WNL sono iniziate",
+        "body": "Le finali della WNL sono iniziate!"
+    },
+    "wnlChampion": {
+        "title": "Campioni della WNL",
+        "body": "L'edizione della WNL è terminata. {{team}} sono i campioni della WNL!",
+        "bodyUnnamed": "L'edizione della WNL è terminata. I campioni sono stati incoronati!"
+    },
+    "wnlPlayerCalledUp": {
+        "title": "Giocatori convocati",
+        "body": "Uno o più dei tuoi giocatori sono stati convocati dalla loro nazionale!"
     }
 }

package/dist/cjs/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/cjs/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/cjs/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/cjs/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/cjs/src/service/notification/notification-type.js

@@ -22,7 +22,14 @@ exports.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.
 exports.NOTIFICATION_LOCALES = ['en', 'es', 'fr', 'it', 'pl', 'pt-BR', 'tr'];

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

@@ -145,4 +145,22 @@ function flattenStrings(node, prefix = '') {
         // disabling one type does not affect another
         (0, globals_1.expect)((0, notification_type_1.pushEnabledFor)({ MATCH_RESULT: false }, 'INJURY')).toBe(true);
     });
+    (0, globals_1.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_type_1.NOTIFICATION_TYPES.filter((t) => t.startsWith('WNL_'))) {
+            (0, globals_1.expect)((0, registry_1.pushPrefKeyFor)(type)).toBe('WNL');
+        }
+        (0, globals_1.expect)((0, registry_1.pushPrefKeyFor)('MATCH_RESULT')).toBe('MATCH_RESULT');
+        (0, globals_1.expect)((0, registry_1.pushPrefKeyFor)('UNKNOWN_TYPE')).toBe('UNKNOWN_TYPE');
+        // The one WNL toggle gates every WNL type's push; individual WNL type keys are never consulted.
+        (0, globals_1.expect)((0, registry_1.pushEnabledForType)({ WNL: false }, 'WNL_CALLUP_OPEN')).toBe(false);
+        (0, globals_1.expect)((0, registry_1.pushEnabledForType)({ WNL: false }, 'WNL_CHAMPION')).toBe(false);
+        (0, globals_1.expect)((0, registry_1.pushEnabledForType)({}, 'WNL_CHAMPION')).toBe(true);
+        (0, globals_1.expect)((0, registry_1.pushEnabledForType)({ WNL_CHAMPION: false }, 'WNL_CHAMPION')).toBe(true);
+        (0, globals_1.expect)((0, registry_1.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.
+        (0, globals_1.expect)(registry_1.PUSH_PREF_KEYS.filter((k) => k === 'WNL')).toHaveLength(1);
+        (0, globals_1.expect)(registry_1.PUSH_PREF_KEYS).not.toContain('WNL_CALLUP_OPEN');
+        (0, globals_1.expect)(registry_1.PUSH_PREF_KEYS).toContain('MATCH_RESULT');
+    });
 });

package/dist/cjs/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/cjs/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/cjs/src/service/notification/registry.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PUSH_NOTIFICATION_TYPES = exports.NOTIFICATION_REGISTRY = void 0;
+exports.PUSH_PREF_KEYS = exports.PUSH_NOTIFICATION_TYPES = exports.NOTIFICATION_REGISTRY = void 0;
+exports.pushPrefKeyFor = pushPrefKeyFor;
+exports.pushEnabledForType = pushEnabledForType;
 const notification_type_1 = require("./notification-type");
 function readString(value) {
     return typeof value === 'string' && value !== '' ? value : null;
@@ -171,9 +173,94 @@ exports.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.
 exports.PUSH_NOTIFICATION_TYPES = notification_type_1.NOTIFICATION_TYPES.filter((type) => exports.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.
+function pushPrefKeyFor(type) {
+    const descriptor = exports.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.
+function pushEnabledForType(prefs, type) {
+    return (0, notification_type_1.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.
+exports.PUSH_PREF_KEYS = [...new Set(exports.PUSH_NOTIFICATION_TYPES.map((type) => pushPrefKeyFor(type)))];

package/dist/cjs/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/cjs/src/service/premium/premium-tier.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAX_PREMIUM_TIER = exports.PREMIUM_TIERS = exports.NO_PREMIUM = void 0;
+exports.TIER_NATIONAL = exports.MAX_PREMIUM_TIER = exports.PREMIUM_TIERS = exports.NO_PREMIUM = void 0;
 exports.premiumTierDef = premiumTierDef;
 exports.hasTier = hasTier;
+exports.canManageNationalTeam = canManageNationalTeam;
 // Hierarchical premium tiers (owner 2026-08-17): tier N grants everything below it, so a feature gate is just
 // `effectiveTier >= required`. Tiers are NUMERIC and code-defined here (the DB stores only the number), so adding a
 // tier needs no migration. Names/keys are display + gating helpers. Keep PREMIUM_TIERS ascending by tier. See
@@ -22,3 +23,9 @@ function premiumTierDef(tier) {
 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.
+exports.TIER_NATIONAL = 2;
+function canManageNationalTeam(effectiveTier) {
+    return hasTier(effectiveTier, exports.TIER_NATIONAL);
+}

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

@@ -70,6 +70,8 @@ export type ChampionBadgeSpec = {
     region: ChampionRegion;
 } | {
     type: 'wcc';
+} | {
+    type: 'wnl';
 };
 export type Player = Omit<DataProps<_Player>, 'stats' | 'birthAge' | 'birthIteration' | 'declineProfile' | 'nickname' | 'injuryProneProfile' | 'injury'> & {
     -readonly [K in 'birthAge' | 'birthIteration']?: DataProps<_Player>[K];
@@ -83,6 +85,7 @@ export type Player = Omit<DataProps<_Player>, 'stats' | 'birthAge' | 'birthItera
     nickname?: string;
     jerseyConfig?: JerseyConfig;
     championBadge?: ChampionBadgeSpec;
+    nationalFlagAlpha2?: string;
 };
 export interface StartingLineup {
     [CourtPosition.LEFT_FRONT]: string;
@@ -189,6 +192,12 @@ export type Team = Omit<DataProps<_Team>, 'roster' | '_rating' | 'rating' | 'tac
     };
     nationalCountryName?: string;
     isEvent?: boolean;
+    isNational?: boolean;
+    nationalManager?: {
+        displayName: string;
+        teamId: string;
+        teamShortName: string;
+    };
 };
 export type Standing = DataProps<_Standing> & {
     position: number;
@@ -255,4 +264,11 @@ export type TotalBoxScore = Omit<DataProps<BoxScore>, 'misc' | 'playerId' | 'mat
         setsPlayed: number;
         matchesPlayed: number;
     };
+    national?: {
+        alpha2: string;
+        matchesPlayed: number;
+        matchesWon: number;
+        pointsPlayed: number;
+        pointsWon: number;
+    };
 };

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

@@ -1,4 +1,4 @@
-import { AuthIdentityModel, AuthSessionModel, AuthUserModel, BoxScoreModel, CoachModel, ScoutModel, PhysicianModel, PhysiotherapistModel, BoxScoreTotalsModel, CompetitionChampionModel, JerseyBadgeModel, CurrencyTransactionModel, GachaPityModel, GachaPullHistoryModel, WishlistModel, UserSettingsModel, UserAchievementsModel, 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';
+import { AuthIdentityModel, AuthSessionModel, AuthUserModel, BoxScoreModel, CoachModel, ScoutModel, PhysicianModel, PhysiotherapistModel, BoxScoreTotalsModel, CompetitionChampionModel, JerseyBadgeModel, CurrencyTransactionModel, GachaPityModel, GachaPullHistoryModel, WishlistModel, UserSettingsModel, UserAchievementsModel, 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, NationalTeamModel, NationalTeamClaimModel, WnlSquadModel, WnlCallupModel, WnlSeasonModel, RallyModel, MatchInputSnapshotModel, 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);
@@ -58,10 +58,16 @@ export function initModels(sequelize) {
     const PlayerTeam = PlayerTeamModel.initModel(sequelize);
     const RetiredPlayer = RetiredPlayerModel.initModel(sequelize);
     const Rally = RallyModel.initModel(sequelize);
+    const MatchInputSnapshot = MatchInputSnapshotModel.initModel(sequelize);
     const PromotionMatch = PromotionMatchModel.initModel(sequelize);
     const Friendly = FriendlyModel.initModel(sequelize);
     const RegionQualifier = RegionQualifierModel.initModel(sequelize);
     const NationalCountry = NationalCountryModel.initModel(sequelize);
+    const NationalTeam = NationalTeamModel.initModel(sequelize);
+    const NationalTeamClaim = NationalTeamClaimModel.initModel(sequelize);
+    const WnlSquad = WnlSquadModel.initModel(sequelize);
+    const WnlCallup = WnlCallupModel.initModel(sequelize);
+    const WnlSeason = WnlSeasonModel.initModel(sequelize);
     const Team = TeamModel.initModel(sequelize);
     const TeamReplacement = TeamReplacementModel.initModel(sequelize);
     const LegacyTeamFlag = LegacyTeamFlagModel.initModel(sequelize);
@@ -159,6 +165,8 @@ export function initModels(sequelize) {
     Match.hasOne(CompetitionMatch, { as: 'CompetitionMatch', foreignKey: 'match_id' });
     Match.hasOne(MatchResult, { as: 'MatchResult', foreignKey: 'match_id' });
     Match.hasOne(Friendly, { as: 'Friendly', foreignKey: 'match_id' });
+    Match.hasOne(MatchInputSnapshot, { as: 'MatchInputSnapshot', foreignKey: 'match_id' });
+    MatchInputSnapshot.belongsTo(Match, { as: 'Match', foreignKey: 'match_id' });
     MatchResult.belongsTo(Match, { as: 'Match', foreignKey: 'match_id' });
     MatchResult.belongsTo(Team, { as: 'Winner', foreignKey: 'winner_team_id' });
     MatchRating.belongsTo(Match, { as: 'match', foreignKey: 'match_id' });
@@ -225,6 +233,28 @@ export function initModels(sequelize) {
     Competition.hasOne(NationalCountry, { as: 'NationalCountry', foreignKey: 'competition_id' });
     Country.hasMany(NationalCountry, { as: 'NationalCountries', foreignKey: 'country_id' });
     Iteration.hasMany(NationalCountry, { as: 'NationalCountries', foreignKey: 'iteration' });
+    // National teams (WNL). The registry maps a country to its permanent active=false national Team; the claim links a
+    // Tier-2 manager to it; per-edition squad + callup + season rows hang off the WNL league Competition.
+    NationalTeam.belongsTo(Country, { as: 'country', foreignKey: 'country_id' });
+    NationalTeam.belongsTo(Team, { as: 'team', foreignKey: 'team_id' });
+    Country.hasOne(NationalTeam, { as: 'NationalTeam', foreignKey: 'country_id' });
+    Team.hasOne(NationalTeam, { as: 'NationalTeam', foreignKey: 'team_id' });
+    NationalTeam.hasOne(NationalTeamClaim, { as: 'claim', foreignKey: 'country_id' });
+    NationalTeamClaim.belongsTo(NationalTeam, { as: 'nationalTeam', foreignKey: 'country_id' });
+    NationalTeamClaim.belongsTo(AuthUser, { as: 'user', foreignKey: 'user_id' });
+    AuthUser.hasOne(NationalTeamClaim, { as: 'NationalTeamClaim', foreignKey: 'user_id' });
+    WnlSquad.belongsTo(Competition, { as: 'competition', foreignKey: 'competition_id' });
+    WnlSquad.belongsTo(Country, { as: 'country', foreignKey: 'country_id' });
+    WnlSquad.belongsTo(Team, { as: 'team', foreignKey: 'team_id' });
+    WnlSquad.belongsTo(AuthUser, { as: 'manager', foreignKey: 'manager_user_id' });
+    Competition.hasMany(WnlSquad, { as: 'WnlSquads', foreignKey: 'competition_id' });
+    WnlCallup.belongsTo(Competition, { as: 'competition', foreignKey: 'competition_id' });
+    WnlCallup.belongsTo(Player, { as: 'player', foreignKey: 'player_id' });
+    WnlCallup.belongsTo(Country, { as: 'country', foreignKey: 'country_id' });
+    Competition.hasMany(WnlCallup, { as: 'WnlCallups', foreignKey: 'competition_id' });
+    WnlSeason.belongsTo(Competition, { as: 'competition', foreignKey: 'competition_id' });
+    WnlSeason.belongsTo(Competition, { as: 'finalsCompetition', foreignKey: 'finals_competition_id' });
+    Competition.hasOne(WnlSeason, { as: 'WnlSeason', foreignKey: 'competition_id' });
     VPER.belongsTo(Player, { as: 'Player', foreignKey: 'player_id' });
     VPER.belongsTo(Match, { as: 'Match', foreignKey: 'match_id' });
     Team.hasOne(Coach, { as: 'Coach', foreignKey: 'team_id' });
@@ -348,6 +378,11 @@ export function initModels(sequelize) {
         Friendly,
         RegionQualifier,
         NationalCountry,
+        NationalTeam,
+        NationalTeamClaim,
+        WnlSquad,
+        WnlCallup,
+        WnlSeason,
         Rally,
         Team,
         TeamReplacement,

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

@@ -21,7 +21,7 @@ export interface CompetitionAttributes {
     LowerPromotionMatches?: PromotionMatchAttributes[];
 }
 export type CompetitionPk = 'competition_id';
-export type CompetitionType = 'LEAGUE' | 'TOURNAMENT' | 'QUALIFIER' | 'NATIONAL' | 'EVENT';
+export type CompetitionType = 'LEAGUE' | 'TOURNAMENT' | 'QUALIFIER' | 'NATIONAL' | 'EVENT' | 'WNL' | 'WNLF';
 export type CompetitionId = CompetitionModel[CompetitionPk];
 export type CompetitionCreationAttributes = CompetitionAttributes;
 export declare class CompetitionModel extends Model<CompetitionAttributes, CompetitionCreationAttributes> implements CompetitionAttributes {

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

@@ -18,7 +18,7 @@ export class CompetitionModel extends Model {
                 }
             },
             type: {
-                type: DataTypes.ENUM('LEAGUE', 'TOURNAMENT', 'QUALIFIER', 'NATIONAL', 'EVENT'),
+                type: DataTypes.ENUM('LEAGUE', 'TOURNAMENT', 'QUALIFIER', 'NATIONAL', 'EVENT', 'WNL', 'WNLF'),
                 allowNull: false
             },
             status: {