volleyballsimtypes 0.0.477 → 0.0.479

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

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

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

@@ -20,4 +20,5 @@ __exportStar(require("./team"), exports);
 __exportStar(require("./event"), exports);
 __exportStar(require("./player"), exports);
 __exportStar(require("./competition"), exports);
+__exportStar(require("./notification"), exports);
 __exportStar(require("./utils"), exports);

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

@@ -0,0 +1,41 @@
+{
+    "matchResult": {
+        "title": "Match result",
+        "wonNamed": "You won against {{opponent}}",
+        "wonUnnamed": "You won your match",
+        "lostNamed": "You lost against {{opponent}}",
+        "lostUnnamed": "You lost your match"
+    },
+    "injury": {
+        "title": "Player injured",
+        "body": "{{name}} has been injured during the last match. Check the infirmary for their recovery time."
+    },
+    "injuryRecovered": {
+        "title": "Player recovered",
+        "body": "{{name}} has recovered from their injury and is ready to play!"
+    },
+    "seasonEnd": {
+        "title": "Season complete",
+        "body": "Your final league position is ready."
+    },
+    "grant": {
+        "title": "Recruit received",
+        "body": "A new recruit reward is available."
+    },
+    "promotion": {
+        "title": "Promotion",
+        "body": "Your team has been promoted to a higher division."
+    },
+    "dailyLogin": {
+        "title": "Daily reward claimed",
+        "body": "Your daily login reward was added."
+    },
+    "welcome": {
+        "title": "Welcome to World Aces",
+        "body": "Your welcome recruit is ready."
+    },
+    "generic": {
+        "title": "World Aces",
+        "body": "You have a new notification."
+    }
+}

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

@@ -0,0 +1,41 @@
+{
+    "matchResult": {
+        "title": "Resultado del partido",
+        "wonNamed": "Ganaste contra {{opponent}}",
+        "wonUnnamed": "Ganaste tu partido",
+        "lostNamed": "Perdiste contra {{opponent}}",
+        "lostUnnamed": "Perdiste tu partido"
+    },
+    "injury": {
+        "title": "Jugador lesionado",
+        "body": "{{name}} se ha lesionado durante el último partido. Consulta la enfermería para ver su tiempo de recuperación."
+    },
+    "injuryRecovered": {
+        "title": "Jugador recuperado",
+        "body": "¡{{name}} se ha recuperado de su lesión y está listo para jugar!"
+    },
+    "seasonEnd": {
+        "title": "Temporada completada",
+        "body": "Tu posición final en la liga está lista."
+    },
+    "grant": {
+        "title": "Reclutamiento recibido",
+        "body": "Hay una nueva recompensa de reclutamiento disponible."
+    },
+    "promotion": {
+        "title": "Ascenso",
+        "body": "Tu equipo ha ascendido a una división superior."
+    },
+    "dailyLogin": {
+        "title": "Recompensa diaria reclamada",
+        "body": "Tu recompensa por inicio de sesión diario se ha añadido."
+    },
+    "welcome": {
+        "title": "Te damos la bienvenida a World Aces",
+        "body": "Tu reclutamiento de bienvenida ya está disponible."
+    },
+    "generic": {
+        "title": "World Aces",
+        "body": "Tienes una nueva notificación."
+    }
+}

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

@@ -0,0 +1,41 @@
+{
+    "matchResult": {
+        "title": "Résultat du match",
+        "wonNamed": "Vous avez gagné contre {{opponent}}",
+        "wonUnnamed": "Vous avez gagné votre match",
+        "lostNamed": "Vous avez perdu contre {{opponent}}",
+        "lostUnnamed": "Vous avez perdu votre match"
+    },
+    "injury": {
+        "title": "Joueur blessé",
+        "body": "{{name}} s'est blessé lors du dernier match. Consultez l'infirmerie pour connaître son temps de récupération."
+    },
+    "injuryRecovered": {
+        "title": "Joueur rétabli",
+        "body": "{{name}} est remis de sa blessure et est prêt à jouer !"
+    },
+    "seasonEnd": {
+        "title": "Saison terminée",
+        "body": "Votre classement final dans la ligue est disponible."
+    },
+    "grant": {
+        "title": "Recrutement reçu",
+        "body": "Une nouvelle récompense de recrutement est disponible."
+    },
+    "promotion": {
+        "title": "Promotion",
+        "body": "Votre équipe a été promue dans une division supérieure."
+    },
+    "dailyLogin": {
+        "title": "Récompense quotidienne récupérée",
+        "body": "Votre récompense de connexion quotidienne a été ajoutée."
+    },
+    "welcome": {
+        "title": "Bienvenue sur World Aces",
+        "body": "Votre recrutement de bienvenue est prêt."
+    },
+    "generic": {
+        "title": "World Aces",
+        "body": "Vous avez une nouvelle notification."
+    }
+}

package/dist/cjs/src/service/notification/catalog/index.d.ts

@@ -0,0 +1,3 @@
+import { type NotificationLocale } from '../notification-type';
+export type CatalogNode = Record<string, unknown>;
+export declare const NOTIFICATION_CATALOG: Record<NotificationLocale, CatalogNode>;

package/dist/cjs/src/service/notification/catalog/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NOTIFICATION_CATALOG = void 0;
+const en_json_1 = __importDefault(require("./en.json"));
+const es_json_1 = __importDefault(require("./es.json"));
+const fr_json_1 = __importDefault(require("./fr.json"));
+const it_json_1 = __importDefault(require("./it.json"));
+const pl_json_1 = __importDefault(require("./pl.json"));
+const pt_BR_json_1 = __importDefault(require("./pt-BR.json"));
+const tr_json_1 = __importDefault(require("./tr.json"));
+exports.NOTIFICATION_CATALOG = {
+    en: en_json_1.default,
+    es: es_json_1.default,
+    fr: fr_json_1.default,
+    it: it_json_1.default,
+    pl: pl_json_1.default,
+    'pt-BR': pt_BR_json_1.default,
+    tr: tr_json_1.default
+};

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

@@ -0,0 +1,41 @@
+{
+    "matchResult": {
+        "title": "Risultato della partita",
+        "wonNamed": "Hai vinto contro {{opponent}}",
+        "wonUnnamed": "Hai vinto la partita",
+        "lostNamed": "Hai perso contro {{opponent}}",
+        "lostUnnamed": "Hai perso la partita"
+    },
+    "injury": {
+        "title": "Giocatore infortunato",
+        "body": "{{name}} si è infortunato durante l'ultima partita. Controlla l'infermeria per conoscere i suoi tempi di recupero."
+    },
+    "injuryRecovered": {
+        "title": "Giocatore recuperato",
+        "body": "{{name}} si è ripreso dall'infortunio ed è pronto a giocare!"
+    },
+    "seasonEnd": {
+        "title": "Stagione completata",
+        "body": "La tua posizione finale in campionato è pronta."
+    },
+    "grant": {
+        "title": "Reclutamento ricevuto",
+        "body": "È disponibile una nuova ricompensa di reclutamento."
+    },
+    "promotion": {
+        "title": "Promozione",
+        "body": "La tua squadra è stata promossa in una divisione superiore."
+    },
+    "dailyLogin": {
+        "title": "Ricompensa giornaliera riscattata",
+        "body": "La tua ricompensa di accesso giornaliero è stata aggiunta."
+    },
+    "welcome": {
+        "title": "Benvenuto in World Aces",
+        "body": "La tua recluta di benvenuto è pronta."
+    },
+    "generic": {
+        "title": "World Aces",
+        "body": "Hai una nuova notifica."
+    }
+}

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

@@ -0,0 +1,41 @@
+{
+    "matchResult": {
+        "title": "Wynik meczu",
+        "wonNamed": "Wygrana z {{opponent}}",
+        "wonUnnamed": "Wygrana w meczu",
+        "lostNamed": "Porażka z {{opponent}}",
+        "lostUnnamed": "Porażka w meczu"
+    },
+    "injury": {
+        "title": "Zawodnik kontuzjowany",
+        "body": "{{name}} doznał kontuzji w ostatnim meczu. Sprawdź ambulatorium, aby poznać czas powrotu do zdrowia."
+    },
+    "injuryRecovered": {
+        "title": "Zawodnik wyzdrowiał",
+        "body": "{{name}} wrócił do zdrowia po kontuzji i jest gotowy do gry!"
+    },
+    "seasonEnd": {
+        "title": "Sezon zakończony",
+        "body": "Twoja końcowa pozycja w lidze jest gotowa."
+    },
+    "grant": {
+        "title": "Otrzymano rekrutację",
+        "body": "Dostępna jest nowa nagroda rekrutacyjna."
+    },
+    "promotion": {
+        "title": "Awans",
+        "body": "Twoja drużyna awansowała do wyższej dywizji."
+    },
+    "dailyLogin": {
+        "title": "Odebrano codzienną nagrodę",
+        "body": "Twoja codzienna nagroda za logowanie została dodana."
+    },
+    "welcome": {
+        "title": "Witaj w World Aces",
+        "body": "Twoja powitalna rekrutacja jest gotowa."
+    },
+    "generic": {
+        "title": "World Aces",
+        "body": "Masz nowe powiadomienie."
+    }
+}

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

@@ -0,0 +1,41 @@
+{
+    "matchResult": {
+        "title": "Resultado da partida",
+        "wonNamed": "Você venceu {{opponent}}",
+        "wonUnnamed": "Você venceu sua partida",
+        "lostNamed": "Você perdeu para {{opponent}}",
+        "lostUnnamed": "Você perdeu sua partida"
+    },
+    "injury": {
+        "title": "Jogador lesionado",
+        "body": "{{name}} se lesionou durante a última partida. Confira a enfermaria para ver o tempo de recuperação."
+    },
+    "injuryRecovered": {
+        "title": "Jogador recuperado",
+        "body": "{{name}} se recuperou da lesão e está pronto para jogar!"
+    },
+    "seasonEnd": {
+        "title": "Temporada concluída",
+        "body": "Sua colocação final na liga já está disponível."
+    },
+    "grant": {
+        "title": "Recrutamento recebido",
+        "body": "Uma nova recompensa de recrutamento está disponível."
+    },
+    "promotion": {
+        "title": "Promoção",
+        "body": "Seu time foi promovido para uma divisão superior."
+    },
+    "dailyLogin": {
+        "title": "Recompensa diária coletada",
+        "body": "Sua recompensa de login diário foi adicionada."
+    },
+    "welcome": {
+        "title": "Boas-vindas ao World Aces",
+        "body": "Seu recrutamento de boas-vindas está pronto."
+    },
+    "generic": {
+        "title": "World Aces",
+        "body": "Você tem uma nova notificação."
+    }
+}

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

@@ -0,0 +1,41 @@
+{
+    "matchResult": {
+        "title": "Maç sonucu",
+        "wonNamed": "{{opponent}} karşısında kazandın",
+        "wonUnnamed": "Maçını kazandın",
+        "lostNamed": "{{opponent}} karşısında kaybettin",
+        "lostUnnamed": "Maçını kaybettin"
+    },
+    "injury": {
+        "title": "Oyuncu sakatlandı",
+        "body": "{{name}} son maçta sakatlandı. İyileşme süresini görmek için reviri kontrol edin."
+    },
+    "injuryRecovered": {
+        "title": "Oyuncu iyileşti",
+        "body": "{{name}} sakatlığını atlattı ve oynamaya hazır!"
+    },
+    "seasonEnd": {
+        "title": "Sezon tamamlandı",
+        "body": "Ligdeki nihai sıralaman hazır."
+    },
+    "grant": {
+        "title": "Transfer alındı",
+        "body": "Yeni bir transfer ödülü mevcut."
+    },
+    "promotion": {
+        "title": "Terfi",
+        "body": "Takımın bir üst gruba terfi etti."
+    },
+    "dailyLogin": {
+        "title": "Günlük ödül alındı",
+        "body": "Günlük giriş ödülün eklendi."
+    },
+    "welcome": {
+        "title": "World Aces'e hoş geldin",
+        "body": "Hoş geldin transferin hazır."
+    },
+    "generic": {
+        "title": "World Aces",
+        "body": "Yeni bir bildirimin var."
+    }
+}

package/dist/cjs/src/service/notification/index.d.ts

@@ -0,0 +1,5 @@
+export * from './notification-type';
+export * from './payloads';
+export * from './registry';
+export * from './render';
+export { NOTIFICATION_CATALOG, type CatalogNode } from './catalog';

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

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NOTIFICATION_CATALOG = void 0;
+__exportStar(require("./notification-type"), exports);
+__exportStar(require("./payloads"), exports);
+__exportStar(require("./registry"), exports);
+__exportStar(require("./render"), exports);
+var catalog_1 = require("./catalog");
+Object.defineProperty(exports, "NOTIFICATION_CATALOG", { enumerable: true, get: function () { return catalog_1.NOTIFICATION_CATALOG; } });

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

@@ -0,0 +1,6 @@
+export declare const NOTIFICATION_TYPES: readonly ["MATCH_RESULT", "INJURY", "INJURY_RECOVERED", "SEASON_END", "GRANT_RECEIVED", "PROMOTION", "DAILY_LOGIN", "WELCOME", "COMPENSATION"];
+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];
+export declare const DEFAULT_NOTIFICATION_LOCALE: NotificationLocale;
+export declare function normalizeNotificationLocale(locale: string | null | undefined): NotificationLocale;

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

@@ -0,0 +1,30 @@
+"use strict";
+// Single source of truth for the set of notification types and the locales the catalog ships.
+// Adding a notification type: add it here, add a NOTIFICATION_REGISTRY entry, and add its catalog
+// strings to every locale file. The completeness test (notification.test.ts) fails the build if any
+// of those three is missing. See README.md in this folder.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_NOTIFICATION_LOCALE = exports.NOTIFICATION_LOCALES = exports.NOTIFICATION_TYPES = void 0;
+exports.normalizeNotificationLocale = normalizeNotificationLocale;
+exports.NOTIFICATION_TYPES = [
+    'MATCH_RESULT',
+    'INJURY',
+    'INJURY_RECOVERED',
+    'SEASON_END',
+    'GRANT_RECEIVED',
+    'PROMOTION',
+    'DAILY_LOGIN',
+    'WELCOME',
+    'COMPENSATION'
+];
+// 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'];
+exports.DEFAULT_NOTIFICATION_LOCALE = 'en';
+// Coalesce an arbitrary/untrusted locale string (e.g. UserSettings.locale, which is nullable) to a
+// supported locale, defaulting to English. Push senders MUST call this before renderPush.
+function normalizeNotificationLocale(locale) {
+    if (locale != null && exports.NOTIFICATION_LOCALES.includes(locale)) {
+        return locale;
+    }
+    return exports.DEFAULT_NOTIFICATION_LOCALE;
+}

package/dist/cjs/src/service/notification/notification.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const notification_type_1 = require("./notification-type");
+const registry_1 = require("./registry");
+const catalog_1 = require("./catalog");
+const render_1 = require("./render");
+function readNested(node, dotKey) {
+    let current = node;
+    for (const part of dotKey.split('.')) {
+        if (typeof current !== 'object' || current == null)
+            return undefined;
+        current = current[part];
+    }
+    return typeof current === 'string' ? current : undefined;
+}
+function placeholders(value) {
+    return (value.match(/\{\{(\w+)\}\}/g) ?? []).sort((a, b) => a.localeCompare(b));
+}
+function flattenStrings(node, prefix = '') {
+    const out = [];
+    if (typeof node !== 'object' || node == null)
+        return out;
+    for (const [key, value] of Object.entries(node)) {
+        if (typeof value === 'string')
+            out.push([prefix + key, value]);
+        else if (typeof value === 'object' && value != null)
+            out.push(...flattenStrings(value, `${prefix}${key}.`));
+    }
+    return out;
+}
+(0, globals_1.describe)('notification registry + catalog completeness', () => {
+    (0, globals_1.it)('has exactly one descriptor per declared type', () => {
+        (0, globals_1.expect)(Object.keys(registry_1.NOTIFICATION_REGISTRY).sort((a, b) => a.localeCompare(b)))
+            .toEqual([...notification_type_1.NOTIFICATION_TYPES].sort((a, b) => a.localeCompare(b)));
+    });
+    (0, globals_1.it)('resolves every descriptor catalog key to a non-empty string in all 7 locales', () => {
+        for (const type of notification_type_1.NOTIFICATION_TYPES) {
+            for (const key of registry_1.NOTIFICATION_REGISTRY[type].catalogKeys) {
+                for (const locale of notification_type_1.NOTIFICATION_LOCALES) {
+                    const value = readNested(catalog_1.NOTIFICATION_CATALOG[locale], key);
+                    (0, globals_1.expect)([locale, key, (value ?? '').length > 0]).toEqual([locale, key, true]);
+                }
+            }
+        }
+    });
+    (0, globals_1.it)('ships an identical key set across all 7 locales (no drift)', () => {
+        const enKeys = flattenStrings(catalog_1.NOTIFICATION_CATALOG.en).map(([key]) => key).sort((a, b) => a.localeCompare(b));
+        for (const locale of notification_type_1.NOTIFICATION_LOCALES) {
+            const keys = flattenStrings(catalog_1.NOTIFICATION_CATALOG[locale]).map(([key]) => key).sort((a, b) => a.localeCompare(b));
+            (0, globals_1.expect)([locale, keys]).toEqual([locale, enKeys]);
+        }
+    });
+    (0, globals_1.it)('keeps placeholders identical across locales', () => {
+        for (const [key, enValue] of flattenStrings(catalog_1.NOTIFICATION_CATALOG.en)) {
+            const expected = placeholders(enValue);
+            for (const locale of notification_type_1.NOTIFICATION_LOCALES) {
+                const value = readNested(catalog_1.NOTIFICATION_CATALOG[locale], key);
+                if (value == null)
+                    continue;
+                (0, globals_1.expect)([locale, key, placeholders(value)]).toEqual([locale, key, expected]);
+            }
+        }
+    });
+    (0, globals_1.it)('contains no em or en dashes', () => {
+        for (const locale of notification_type_1.NOTIFICATION_LOCALES) {
+            for (const [key, value] of flattenStrings(catalog_1.NOTIFICATION_CATALOG[locale])) {
+                (0, globals_1.expect)([locale, key, value.includes('—') || value.includes('–')]).toEqual([locale, key, false]);
+            }
+        }
+    });
+});
+(0, globals_1.describe)('renderPush', () => {
+    (0, globals_1.it)('renders a localized MATCH_RESULT win with a named opponent', () => {
+        const payload = { matchId: 'm1', result: 'WIN', side: 'HOME', awayTeam: { name: 'Rivals' } };
+        const en = (0, render_1.renderPush)('MATCH_RESULT', payload, 'en');
+        (0, globals_1.expect)(en?.title).toBe('Match result');
+        (0, globals_1.expect)(en?.body).toBe('You won against Rivals');
+        (0, globals_1.expect)(en?.data.path).toBe('/match/m1');
+        (0, globals_1.expect)((0, render_1.renderPush)('MATCH_RESULT', payload, 'es')?.body).toBe('Ganaste contra Rivals');
+    });
+    (0, globals_1.it)('uses the unnamed variant and root path when the opponent is unknown', () => {
+        const en = (0, render_1.renderPush)('MATCH_RESULT', { result: 'LOSS' }, 'en');
+        (0, globals_1.expect)(en?.body).toBe('You lost your match');
+        (0, globals_1.expect)(en?.data.path).toBe('/');
+    });
+    (0, globals_1.it)('interpolates the injured player name and links to the infirmary', () => {
+        const en = (0, render_1.renderPush)('INJURY', { playerNickname: 'Ace', teamId: 't1' }, 'en');
+        (0, globals_1.expect)(en?.title).toBe('Player injured');
+        (0, globals_1.expect)(en?.body).toContain('Ace');
+        (0, globals_1.expect)(en?.data.path).toBe('/infirmary');
+    });
+    (0, globals_1.it)('uses a generic subject when the injury payload has no player name', () => {
+        const en = (0, render_1.renderPush)('INJURY', { teamId: 't1' }, 'en');
+        (0, globals_1.expect)(en?.body.startsWith('A player')).toBe(true);
+    });
+    (0, globals_1.it)('returns undefined for in-app-only types (COMPENSATION)', () => {
+        (0, globals_1.expect)((0, render_1.renderPush)('COMPENSATION', { currency: 100 }, 'en')).toBeUndefined();
+    });
+    (0, globals_1.it)('falls back to generic copy and root path for an unknown type', () => {
+        const en = (0, render_1.renderPush)('SOMETHING_NEW', {}, 'en');
+        (0, globals_1.expect)(en?.title).toBe('World Aces');
+        (0, globals_1.expect)(en?.body).toBe('You have a new notification.');
+        (0, globals_1.expect)(en?.data.path).toBe('/');
+    });
+    (0, globals_1.it)('serializes the payload into the FCM data block', () => {
+        const en = (0, render_1.renderPush)('GRANT_RECEIVED', { pullType: 'MYTHIC' }, 'en');
+        (0, globals_1.expect)(en?.data.type).toBe('GRANT_RECEIVED');
+        (0, globals_1.expect)(JSON.parse(en?.data.payload ?? '{}')).toEqual({ pullType: 'MYTHIC' });
+    });
+});
+(0, globals_1.describe)('translateNotification + interpolate + notificationPath', () => {
+    (0, globals_1.it)('falls back to English then to the raw key', () => {
+        (0, globals_1.expect)((0, render_1.translateNotification)('fr', 'promotion.title')).toBe('Promotion');
+        (0, globals_1.expect)((0, render_1.translateNotification)('en', 'does.not.exist')).toBe('does.not.exist');
+    });
+    (0, globals_1.it)('replaces placeholders and drops unknown ones', () => {
+        (0, globals_1.expect)((0, render_1.interpolate)('Hi {{name}}!', { name: 'X' })).toBe('Hi X!');
+        (0, globals_1.expect)((0, render_1.interpolate)('Hi {{name}}!', {})).toBe('Hi !');
+    });
+    (0, globals_1.it)('derives the deep-link path per type', () => {
+        (0, globals_1.expect)((0, render_1.notificationPath)('SEASON_END', { leagueId: 'l1' })).toBe('/league/l1');
+        (0, globals_1.expect)((0, render_1.notificationPath)('SEASON_END', {})).toBe('/league');
+        (0, globals_1.expect)((0, render_1.notificationPath)('PROMOTION', { teamId: 't1' })).toBe('/team/t1');
+        (0, globals_1.expect)((0, render_1.notificationPath)('GRANT_RECEIVED', {})).toBe('/recruit');
+        (0, globals_1.expect)((0, render_1.notificationPath)('COMPENSATION', {})).toBe('/');
+    });
+});

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

@@ -0,0 +1,34 @@
+export interface MatchResultTeam {
+    id?: string;
+    name?: string;
+}
+export interface MatchResultPayload {
+    matchId?: string;
+    homeTeam?: MatchResultTeam;
+    awayTeam?: MatchResultTeam;
+    result?: 'WIN' | 'LOSS';
+    side?: 'HOME' | 'AWAY';
+}
+export interface InjuryPayload {
+    playerId?: string;
+    playerName?: string;
+    playerNickname?: string;
+    teamId?: string;
+    matchId?: string;
+}
+export interface InjuryRecoveredPayload {
+    playerId?: string;
+    playerName?: string;
+    playerNickname?: string;
+    teamId?: string;
+}
+export interface SeasonEndPayload {
+    competitionId?: string;
+    leagueId?: string;
+    position?: number;
+}
+export interface PromotionPayload {
+    teamId?: string;
+    amount?: number;
+}
+export type NotificationPayload = MatchResultPayload | InjuryPayload | InjuryRecoveredPayload | SeasonEndPayload | PromotionPayload | Record<string, unknown>;

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

@@ -0,0 +1,5 @@
+"use strict";
+// Typed payload shapes per notification type, for call-site safety in the Sim/API. The DB `Notification.payload`
+// column is jsonb (free-form), so the registry reads payloads defensively (Record<string, unknown>); these
+// interfaces document the intended shape and can be used by emitters when constructing the payload.
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,13 @@
+import { type NotificationType } from './notification-type';
+export type CatalogKeyResolver = string | ((payload: Record<string, unknown>) => string);
+export interface NotificationDescriptor {
+    emitsPush: boolean;
+    deepLink?: (payload: Record<string, unknown>) => string;
+    pushTitleKey?: CatalogKeyResolver;
+    pushBodyKey?: CatalogKeyResolver;
+    inAppMessageKey?: CatalogKeyResolver;
+    richRender?: NotificationType;
+    params?: (payload: Record<string, unknown>) => Record<string, string>;
+    catalogKeys: string[];
+}
+export declare const NOTIFICATION_REGISTRY: Record<NotificationType, NotificationDescriptor>;