@open-mercato/core 0.6.8-develop.6983.1.e4f794099e → 0.6.8-develop.6985.1.fb93574faa

package/src/modules/notifications/generators.ts

@@ -0,0 +1,82 @@
+import type { GeneratorPlugin } from '@open-mercato/shared/modules/generators'
+
+function buildDeliveryStrategiesOutput({
+  importSection,
+  entriesLiteral,
+}: {
+  importSection: string
+  entriesLiteral: string
+}): string {
+  return `// AUTO-GENERATED by mercato generate registry
+${importSection ? `${importSection}\n` : ''}type NotificationDeliveryStrategyEntry = { moduleId: string; strategies: unknown[] }
+
+export const notificationDeliveryStrategyEntries: NotificationDeliveryStrategyEntry[] = [
+${entriesLiteral ? `  ${entriesLiteral}\n` : ''}]
+`
+}
+
+/**
+ * Lets any module contribute notification delivery strategies by exporting
+ * `notifications.delivery-strategies.ts` (`export const deliveryStrategies = [...]`). The generator
+ * aggregates them and wires a bootstrap registration call, so the strategy registry is populated at
+ * boot without `bootstrap.ts` knowing about individual modules. Mirrors the security MFA-provider plugin.
+ */
+const deliveryStrategiesPlugin: GeneratorPlugin = {
+  id: 'notifications.delivery-strategies',
+  conventionFile: 'notifications.delivery-strategies.ts',
+  importPrefix: 'NOTIFICATIONS_DELIVERY_STRATEGIES',
+  configExpr: (importName: string, moduleId: string) =>
+    `{ moduleId: '${moduleId}', strategies: ((${importName}.default ?? ${importName}.deliveryStrategies ?? []) as unknown[]) }`,
+  outputFileName: 'notifications-delivery-strategies.generated.ts',
+  buildOutput: buildDeliveryStrategiesOutput,
+  bootstrapRegistration: {
+    entriesExportName: 'notificationDeliveryStrategyEntries',
+    registrationImports: [
+      `import { registerNotificationDeliveryStrategyEntries } from '@open-mercato/core/modules/notifications/lib/delivery-strategies-registry'`,
+    ],
+    buildCall: (name: string) => `registerNotificationDeliveryStrategyEntries(${name})`,
+  },
+}
+
+function buildChannelsOutput({
+  importSection,
+  entriesLiteral,
+}: {
+  importSection: string
+  entriesLiteral: string
+}): string {
+  return `// AUTO-GENERATED by mercato generate registry
+${importSection ? `${importSection}\n` : ''}type NotificationChannelEntry = { moduleId: string; channels: unknown[] }
+
+export const notificationChannelEntries: NotificationChannelEntry[] = [
+${entriesLiteral ? `  ${entriesLiteral}\n` : ''}]
+`
+}
+
+/**
+ * Lets any module contribute notification channels (metadata for the preferences UI + the
+ * `/api/notifications/channels` endpoint) by exporting `notification-channels.ts`
+ * (`export const notificationChannels = [...]`). The generator aggregates them and wires a bootstrap
+ * registration call, so the channel catalogue is populated at boot without `bootstrap.ts` knowing about
+ * individual modules. Mirrors the delivery-strategies plugin.
+ */
+const channelsPlugin: GeneratorPlugin = {
+  id: 'notifications.channels',
+  conventionFile: 'notification-channels.ts',
+  importPrefix: 'NOTIFICATION_CHANNELS',
+  configExpr: (importName: string, moduleId: string) =>
+    `{ moduleId: '${moduleId}', channels: ((${importName}.default ?? ${importName}.notificationChannels ?? []) as unknown[]) }`,
+  outputFileName: 'notification-channels.generated.ts',
+  buildOutput: buildChannelsOutput,
+  bootstrapRegistration: {
+    entriesExportName: 'notificationChannelEntries',
+    registrationImports: [
+      `import { registerNotificationChannelEntries } from '@open-mercato/core/modules/notifications/lib/notification-channel-registry'`,
+    ],
+    buildCall: (name: string) => `registerNotificationChannelEntries(${name})`,
+  },
+}
+
+export const generatorPlugins: GeneratorPlugin[] = [deliveryStrategiesPlugin, channelsPlugin]
+
+export default generatorPlugins

package/src/modules/notifications/i18n/de.json

@@ -23,6 +23,35 @@
   "notifications.footer.useHint": "Verwende",
   "notifications.markAllRead": "Alle als gelesen markieren",
   "notifications.nav.title": "Benachrichtigungen",
+  "notifications.preferences.admin.editingFor": "Einstellungen für {user}",
+  "notifications.preferences.admin.noUsers": "Keine Benutzer gefunden.",
+  "notifications.preferences.admin.pageDescription": "Suchen Sie einen Benutzer, um dessen Benachrichtigungskanäle zu überprüfen und zu bearbeiten.",
+  "notifications.preferences.admin.pageTitle": "Benachrichtigungseinstellungen der Benutzer",
+  "notifications.preferences.admin.searchPlaceholder": "Benutzer nach Name oder E-Mail suchen...",
+  "notifications.preferences.admin.searching": "Suche läuft...",
+  "notifications.preferences.channelDisabledHint": "Dieser Kanal wurde für diese Benachrichtigung von Ihrem Administrator deaktiviert.",
+  "notifications.preferences.channels.email": "E-Mail",
+  "notifications.preferences.channels.emailHint": "An die E-Mail-Adresse Ihres Kontos gesendet.",
+  "notifications.preferences.channels.inApp": "In-App",
+  "notifications.preferences.channels.inAppHint": "Benachrichtigungszentrale und Glocke.",
+  "notifications.preferences.channels.push": "Push",
+  "notifications.preferences.channels.pushHint": "Mobile Push (aktiv, sobald ein Push-Kanal verbunden ist).",
+  "notifications.preferences.columns.type": "Benachrichtigungstyp",
+  "notifications.preferences.empty": "Es sind noch keine Benachrichtigungstypen registriert.",
+  "notifications.preferences.entityNamePlural": "Benachrichtigungstypen",
+  "notifications.preferences.filters.category": "Kategorie",
+  "notifications.preferences.filters.categoryPlaceholder": "Kategorien suchen",
+  "notifications.preferences.loadError": "Benachrichtigungseinstellungen konnten nicht geladen werden",
+  "notifications.preferences.loading": "Benachrichtigungseinstellungen werden geladen...",
+  "notifications.preferences.pageDescription": "Wählen Sie, über welche Kanäle die einzelnen Benachrichtigungstypen zugestellt werden. Nicht gesetzte Optionen bleiben standardmäßig aktiviert.",
+  "notifications.preferences.pageTitle": "Benachrichtigungseinstellungen",
+  "notifications.preferences.profileGroup": "Profil",
+  "notifications.preferences.requiredHint": "Diese Benachrichtigung ist erforderlich und kann nicht deaktiviert werden.",
+  "notifications.preferences.save": "Einstellungen speichern",
+  "notifications.preferences.saveError": "Benachrichtigungseinstellungen konnten nicht gespeichert werden",
+  "notifications.preferences.saveSuccess": "Benachrichtigungseinstellungen gespeichert",
+  "notifications.preferences.saving": "Wird gespeichert...",
+  "notifications.preferences.userNotFound": "Benutzer nicht gefunden",
   "notifications.settings.core.appUrl": "Anwendungs-URL",
   "notifications.settings.core.appUrlHint": "Wird verwendet, um absolute Links in E-Mail-Benachrichtigungen zu erstellen.",
   "notifications.settings.core.databaseHint": "Speichert Benachrichtigungen in der Datenbank für Panel und Glocke.",
@@ -46,10 +75,24 @@
   "notifications.settings.saveError": "Benachrichtigungseinstellungen konnten nicht gespeichert werden",
   "notifications.settings.saveSuccess": "Benachrichtigungseinstellungen gespeichert",
   "notifications.settings.saving": "Speichern...",
+  "notifications.settings.types.description": "Zustellkanäle pro Benachrichtigungstyp. Das Ausschalten eines Kanals deaktiviert ihn vollständig für diesen Typ in Ihrem Tenant — er wird nie zugestellt und Nutzer können ihn nicht in ihren Einstellungen aktivieren. Ein eingeschalteter Kanal lässt Nutzer pro Typ entscheiden; erforderliche (Non-Opt-out-)Typen werden auf aktivierten Kanälen immer zugestellt. Ihre Einstellung überschreibt den Modul-Standard.",
+  "notifications.settings.types.empty": "Es sind noch keine Benachrichtigungstypen registriert.",
+  "notifications.settings.types.lastChannelRestored": "Ein Benachrichtigungstyp muss mindestens einen Kanal behalten, daher wurde die Standardeinstellung des Moduls wiederhergestellt.",
+  "notifications.settings.types.loadError": "Benachrichtigungstypen konnten nicht geladen werden",
+  "notifications.settings.types.requiredColumn": "Erforderlich",
+  "notifications.settings.types.requiredHint": "Nutzer können sich nicht abmelden, wenn aktiviert.",
+  "notifications.settings.types.saveError": "Einstellungen des Benachrichtigungstyps konnten nicht gespeichert werden",
+  "notifications.settings.types.saveSuccess": "Einstellungen des Benachrichtigungstyps gespeichert",
+  "notifications.settings.types.title": "Zustellkanäle pro Typ",
+  "notifications.settings.types.typeColumn": "Benachrichtigungstyp",
   "notifications.title": "Benachrichtigungen",
   "notifications.toast.actionError": "Aktion konnte nicht ausgeführt werden",
   "notifications.toast.actionSuccess": "Aktion erfolgreich ausgeführt",
   "notifications.toast.dismissed": "Benachrichtigung verworfen",
   "notifications.toast.new": "Neue Benachrichtigung",
+  "notifications.types.invalidChannels": "Ungültige Kanal-Daten",
+  "notifications.types.overrideConflict": "Ein anderer Operator hat diesen Benachrichtigungstyp gerade gespeichert. Bitte neu laden und erneut versuchen.",
+  "notifications.types.unknownChannel": "Unbekannter Benachrichtigungskanal",
+  "notifications.types.unknownType": "Unbekannter Benachrichtigungstyp",
   "notifications.unreadSummary": "{count} ungelesen"
 }

package/src/modules/notifications/i18n/en.json

@@ -23,6 +23,35 @@
   "notifications.footer.useHint": "Use",
   "notifications.markAllRead": "Mark all read",
   "notifications.nav.title": "Notifications",
+  "notifications.preferences.admin.editingFor": "Preferences for {user}",
+  "notifications.preferences.admin.noUsers": "No users found.",
+  "notifications.preferences.admin.pageDescription": "Search for a user to review and edit their notification channel preferences.",
+  "notifications.preferences.admin.pageTitle": "User Notification Preferences",
+  "notifications.preferences.admin.searchPlaceholder": "Search users by name or email...",
+  "notifications.preferences.admin.searching": "Searching...",
+  "notifications.preferences.channelDisabledHint": "This channel is turned off for this notification by your administrator.",
+  "notifications.preferences.channels.email": "Email",
+  "notifications.preferences.channels.emailHint": "Sent to your account email address.",
+  "notifications.preferences.channels.inApp": "In-app",
+  "notifications.preferences.channels.inAppHint": "Notification center and bell.",
+  "notifications.preferences.channels.push": "Push",
+  "notifications.preferences.channels.pushHint": "Mobile push (active once a push channel is connected).",
+  "notifications.preferences.columns.type": "Notification type",
+  "notifications.preferences.empty": "No notification types are registered yet.",
+  "notifications.preferences.entityNamePlural": "notification types",
+  "notifications.preferences.filters.category": "Category",
+  "notifications.preferences.filters.categoryPlaceholder": "Search categories",
+  "notifications.preferences.loadError": "Failed to load notification preferences",
+  "notifications.preferences.loading": "Loading notification preferences...",
+  "notifications.preferences.pageDescription": "Choose which channels deliver each notification type. Unset choices stay enabled by default.",
+  "notifications.preferences.pageTitle": "Notification Preferences",
+  "notifications.preferences.profileGroup": "Profile",
+  "notifications.preferences.requiredHint": "This notification is required and cannot be turned off.",
+  "notifications.preferences.save": "Save preferences",
+  "notifications.preferences.saveError": "Failed to save notification preferences",
+  "notifications.preferences.saveSuccess": "Notification preferences saved",
+  "notifications.preferences.saving": "Saving...",
+  "notifications.preferences.userNotFound": "User not found",
   "notifications.settings.core.appUrl": "Application URL",
   "notifications.settings.core.appUrlHint": "Used to build absolute links in email notifications.",
   "notifications.settings.core.databaseHint": "Store notifications in the database for the panel and bell.",
@@ -46,10 +75,24 @@
   "notifications.settings.saveError": "Failed to save notification settings",
   "notifications.settings.saveSuccess": "Notification settings saved",
   "notifications.settings.saving": "Saving...",
+  "notifications.settings.types.description": "Delivery channels per notification type. Turning a channel off disables it completely for that type in your tenant — it never delivers and users cannot enable it in their preferences. Turning it on lets users opt in or out per type; required (non-opt-out) types always deliver on enabled channels. Your setting overrides the module default.",
+  "notifications.settings.types.empty": "No notification types are registered yet.",
+  "notifications.settings.types.lastChannelRestored": "A notification type must keep at least one channel, so the module default was restored.",
+  "notifications.settings.types.loadError": "Failed to load notification types",
+  "notifications.settings.types.requiredColumn": "Required",
+  "notifications.settings.types.requiredHint": "Users cannot opt out when on.",
+  "notifications.settings.types.saveError": "Failed to save notification type settings",
+  "notifications.settings.types.saveSuccess": "Notification type settings saved",
+  "notifications.settings.types.title": "Delivery channels per type",
+  "notifications.settings.types.typeColumn": "Notification type",
   "notifications.title": "Notifications",
   "notifications.toast.actionError": "Failed to execute action",
   "notifications.toast.actionSuccess": "Action completed successfully",
   "notifications.toast.dismissed": "Notification dismissed",
   "notifications.toast.new": "New notification",
+  "notifications.types.invalidChannels": "Invalid channels payload",
+  "notifications.types.overrideConflict": "Another operator just saved this notification type. Reload and try again.",
+  "notifications.types.unknownChannel": "Unknown notification channel",
+  "notifications.types.unknownType": "Unknown notification type",
   "notifications.unreadSummary": "{count} unread"
 }

package/src/modules/notifications/i18n/es.json

@@ -23,6 +23,35 @@
   "notifications.footer.useHint": "Usa",
   "notifications.markAllRead": "Marcar todo como leído",
   "notifications.nav.title": "Notificaciones",
+  "notifications.preferences.admin.editingFor": "Preferencias de {user}",
+  "notifications.preferences.admin.noUsers": "No se encontraron usuarios.",
+  "notifications.preferences.admin.pageDescription": "Busca un usuario para revisar y editar sus preferencias de canales de notificación.",
+  "notifications.preferences.admin.pageTitle": "Preferencias de notificaciones de usuarios",
+  "notifications.preferences.admin.searchPlaceholder": "Buscar usuarios por nombre o correo electrónico...",
+  "notifications.preferences.admin.searching": "Buscando...",
+  "notifications.preferences.channelDisabledHint": "Este canal está desactivado para esta notificación por tu administrador.",
+  "notifications.preferences.channels.email": "Correo electrónico",
+  "notifications.preferences.channels.emailHint": "Enviado a la dirección de correo de tu cuenta.",
+  "notifications.preferences.channels.inApp": "En la aplicación",
+  "notifications.preferences.channels.inAppHint": "Centro de notificaciones y campana.",
+  "notifications.preferences.channels.push": "Push",
+  "notifications.preferences.channels.pushHint": "Push móvil (activo cuando se conecta un canal push).",
+  "notifications.preferences.columns.type": "Tipo de notificación",
+  "notifications.preferences.empty": "Aún no hay tipos de notificación registrados.",
+  "notifications.preferences.entityNamePlural": "tipos de notificación",
+  "notifications.preferences.filters.category": "Categoría",
+  "notifications.preferences.filters.categoryPlaceholder": "Buscar categorías",
+  "notifications.preferences.loadError": "No se pudieron cargar las preferencias de notificaciones",
+  "notifications.preferences.loading": "Cargando preferencias de notificaciones...",
+  "notifications.preferences.pageDescription": "Elige qué canales entregan cada tipo de notificación. Las opciones sin definir permanecen activadas de forma predeterminada.",
+  "notifications.preferences.pageTitle": "Preferencias de notificaciones",
+  "notifications.preferences.profileGroup": "Perfil",
+  "notifications.preferences.requiredHint": "Esta notificación es obligatoria y no se puede desactivar.",
+  "notifications.preferences.save": "Guardar preferencias",
+  "notifications.preferences.saveError": "No se pudieron guardar las preferencias de notificaciones",
+  "notifications.preferences.saveSuccess": "Preferencias de notificaciones guardadas",
+  "notifications.preferences.saving": "Guardando...",
+  "notifications.preferences.userNotFound": "Usuario no encontrado",
   "notifications.settings.core.appUrl": "URL de la aplicación",
   "notifications.settings.core.appUrlHint": "Se usa para construir enlaces absolutos en notificaciones por email.",
   "notifications.settings.core.databaseHint": "Guarda las notificaciones en la base de datos para el panel y la campana.",
@@ -46,10 +75,24 @@
   "notifications.settings.saveError": "No se pudieron guardar los ajustes de notificaciones",
   "notifications.settings.saveSuccess": "Ajustes de notificaciones guardados",
   "notifications.settings.saving": "Guardando...",
+  "notifications.settings.types.description": "Canales de entrega por tipo de notificación. Apagar un canal lo desactiva por completo para ese tipo en tu tenant: nunca se entrega y los usuarios no pueden activarlo en sus preferencias. Un canal encendido permite a los usuarios decidir por tipo; los tipos obligatorios (sin exclusión) siempre se entregan en los canales activos. Tu configuración anula el valor predeterminado del módulo.",
+  "notifications.settings.types.empty": "Aún no hay tipos de notificación registrados.",
+  "notifications.settings.types.lastChannelRestored": "Un tipo de notificación debe conservar al menos un canal, por lo que se restauró el valor predeterminado del módulo.",
+  "notifications.settings.types.loadError": "No se pudieron cargar los tipos de notificación",
+  "notifications.settings.types.requiredColumn": "Obligatoria",
+  "notifications.settings.types.requiredHint": "Los usuarios no pueden desactivarla cuando está activada.",
+  "notifications.settings.types.saveError": "No se pudieron guardar los ajustes del tipo de notificación",
+  "notifications.settings.types.saveSuccess": "Ajustes del tipo de notificación guardados",
+  "notifications.settings.types.title": "Canales de entrega por tipo",
+  "notifications.settings.types.typeColumn": "Tipo de notificación",
   "notifications.title": "Notificaciones",
   "notifications.toast.actionError": "No se pudo ejecutar la acción",
   "notifications.toast.actionSuccess": "Acción completada correctamente",
   "notifications.toast.dismissed": "Notificación descartada",
   "notifications.toast.new": "Nueva notificación",
+  "notifications.types.invalidChannels": "Payload de canales no válido",
+  "notifications.types.overrideConflict": "Otro operador acaba de guardar este tipo de notificación. Vuelve a cargar e inténtalo de nuevo.",
+  "notifications.types.unknownChannel": "Canal de notificación desconocido",
+  "notifications.types.unknownType": "Tipo de notificación desconocido",
   "notifications.unreadSummary": "{count} sin leer"
 }

package/src/modules/notifications/i18n/ko.json

@@ -23,6 +23,35 @@
   "notifications.footer.useHint": "사용",
   "notifications.markAllRead": "모두 읽음으로 표시",
   "notifications.nav.title": "알림",
+  "notifications.preferences.admin.editingFor": "{user} 님의 환경설정",
+  "notifications.preferences.admin.noUsers": "사용자를 찾을 수 없습니다.",
+  "notifications.preferences.admin.pageDescription": "사용자를 검색해 해당 사용자의 알림 채널 환경설정을 확인하고 수정하세요.",
+  "notifications.preferences.admin.pageTitle": "사용자 알림 환경설정",
+  "notifications.preferences.admin.searchPlaceholder": "이름 또는 이메일로 사용자 검색...",
+  "notifications.preferences.admin.searching": "검색하는 중...",
+  "notifications.preferences.channelDisabledHint": "이 알림에 대해 관리자가 이 채널을 꺼 두었습니다.",
+  "notifications.preferences.channels.email": "이메일",
+  "notifications.preferences.channels.emailHint": "계정 이메일 주소로 전송됩니다.",
+  "notifications.preferences.channels.inApp": "앱 내",
+  "notifications.preferences.channels.inAppHint": "알림 센터와 알림 벨에 표시됩니다.",
+  "notifications.preferences.channels.push": "푸시",
+  "notifications.preferences.channels.pushHint": "모바일 푸시 (푸시 채널이 연결되면 활성화됩니다).",
+  "notifications.preferences.columns.type": "알림 유형",
+  "notifications.preferences.empty": "아직 등록된 알림 유형이 없습니다.",
+  "notifications.preferences.entityNamePlural": "알림 유형",
+  "notifications.preferences.filters.category": "카테고리",
+  "notifications.preferences.filters.categoryPlaceholder": "카테고리 검색",
+  "notifications.preferences.loadError": "알림 환경설정을 불러오지 못했습니다",
+  "notifications.preferences.loading": "알림 환경설정을 불러오는 중...",
+  "notifications.preferences.pageDescription": "각 알림 유형을 어떤 채널로 받을지 선택하세요. 설정하지 않은 항목은 기본적으로 켜진 상태로 유지됩니다.",
+  "notifications.preferences.pageTitle": "알림 환경설정",
+  "notifications.preferences.profileGroup": "프로필",
+  "notifications.preferences.requiredHint": "이 알림은 필수이므로 끌 수 없습니다.",
+  "notifications.preferences.save": "환경설정 저장",
+  "notifications.preferences.saveError": "알림 환경설정을 저장하지 못했습니다",
+  "notifications.preferences.saveSuccess": "알림 환경설정이 저장되었습니다",
+  "notifications.preferences.saving": "저장 중...",
+  "notifications.preferences.userNotFound": "사용자를 찾을 수 없습니다",
   "notifications.settings.core.appUrl": "애플리케이션 URL",
   "notifications.settings.core.appUrlHint": "이메일 알림에서 절대 링크를 생성하는 데 사용됩니다.",
   "notifications.settings.core.databaseHint": "패널과 벨 아이콘을 위해 알림을 데이터베이스에 저장합니다.",
@@ -46,10 +75,24 @@
   "notifications.settings.saveError": "알림 설정 저장에 실패했습니다",
   "notifications.settings.saveSuccess": "알림 설정이 저장되었습니다",
   "notifications.settings.saving": "저장 중...",
+  "notifications.settings.types.description": "알림 유형별 전송 채널입니다. 채널을 끄면 해당 유형에 대해 테넌트 전체에서 완전히 비활성화되어 전송되지 않으며, 사용자도 환경설정에서 켤 수 없습니다. 채널을 켜면 사용자가 유형별로 수신 여부를 선택할 수 있고, 필수(수신 거부 불가) 유형은 활성화된 채널로 항상 전송됩니다. 이 설정은 모듈 기본값보다 우선합니다.",
+  "notifications.settings.types.empty": "아직 등록된 알림 유형이 없습니다.",
+  "notifications.settings.types.lastChannelRestored": "알림 유형에는 채널이 하나 이상 있어야 하므로 모듈 기본값이 복원되었습니다.",
+  "notifications.settings.types.loadError": "알림 유형을 불러오지 못했습니다",
+  "notifications.settings.types.requiredColumn": "필수",
+  "notifications.settings.types.requiredHint": "켜져 있으면 사용자가 수신을 거부할 수 없습니다.",
+  "notifications.settings.types.saveError": "알림 유형 설정을 저장하지 못했습니다",
+  "notifications.settings.types.saveSuccess": "알림 유형 설정이 저장되었습니다",
+  "notifications.settings.types.title": "유형별 전송 채널",
+  "notifications.settings.types.typeColumn": "알림 유형",
   "notifications.title": "알림",
   "notifications.toast.actionError": "작업을 실행하지 못했습니다",
   "notifications.toast.actionSuccess": "작업이 성공적으로 완료되었습니다",
   "notifications.toast.dismissed": "알림이 닫혔습니다",
   "notifications.toast.new": "새 알림",
+  "notifications.types.invalidChannels": "잘못된 채널 데이터입니다",
+  "notifications.types.overrideConflict": "다른 담당자가 방금 이 알림 유형을 저장했습니다. 새로고침한 뒤 다시 시도하세요.",
+  "notifications.types.unknownChannel": "알 수 없는 알림 채널입니다",
+  "notifications.types.unknownType": "알 수 없는 알림 유형입니다",
   "notifications.unreadSummary": "읽지 않음 {count}개"
 }

package/src/modules/notifications/i18n/pl.json

@@ -23,6 +23,35 @@
   "notifications.footer.useHint": "Użyj",
   "notifications.markAllRead": "Oznacz wszystkie jako przeczytane",
   "notifications.nav.title": "Powiadomienia",
+  "notifications.preferences.admin.editingFor": "Preferencje dla {user}",
+  "notifications.preferences.admin.noUsers": "Nie znaleziono użytkowników.",
+  "notifications.preferences.admin.pageDescription": "Wyszukaj użytkownika, aby przejrzeć i edytować jego preferencje kanałów powiadomień.",
+  "notifications.preferences.admin.pageTitle": "Preferencje powiadomień użytkowników",
+  "notifications.preferences.admin.searchPlaceholder": "Szukaj użytkowników według nazwy lub e-maila...",
+  "notifications.preferences.admin.searching": "Wyszukiwanie...",
+  "notifications.preferences.channelDisabledHint": "Ten kanał został wyłączony dla tego powiadomienia przez administratora.",
+  "notifications.preferences.channels.email": "E-mail",
+  "notifications.preferences.channels.emailHint": "Wysyłane na adres e-mail Twojego konta.",
+  "notifications.preferences.channels.inApp": "W aplikacji",
+  "notifications.preferences.channels.inAppHint": "Centrum powiadomień i dzwonek.",
+  "notifications.preferences.channels.push": "Push",
+  "notifications.preferences.channels.pushHint": "Powiadomienia push (aktywne po podłączeniu kanału push).",
+  "notifications.preferences.columns.type": "Typ powiadomienia",
+  "notifications.preferences.empty": "Nie zarejestrowano jeszcze żadnych typów powiadomień.",
+  "notifications.preferences.entityNamePlural": "typów powiadomień",
+  "notifications.preferences.filters.category": "Kategoria",
+  "notifications.preferences.filters.categoryPlaceholder": "Szukaj kategorii",
+  "notifications.preferences.loadError": "Nie udało się załadować preferencji powiadomień",
+  "notifications.preferences.loading": "Ładowanie preferencji powiadomień...",
+  "notifications.preferences.pageDescription": "Wybierz, które kanały dostarczają poszczególne typy powiadomień. Nieustawione opcje pozostają domyślnie włączone.",
+  "notifications.preferences.pageTitle": "Preferencje powiadomień",
+  "notifications.preferences.profileGroup": "Profil",
+  "notifications.preferences.requiredHint": "To powiadomienie jest wymagane i nie można go wyłączyć.",
+  "notifications.preferences.save": "Zapisz preferencje",
+  "notifications.preferences.saveError": "Nie udało się zapisać preferencji powiadomień",
+  "notifications.preferences.saveSuccess": "Zapisano preferencje powiadomień",
+  "notifications.preferences.saving": "Zapisywanie...",
+  "notifications.preferences.userNotFound": "Nie znaleziono użytkownika",
   "notifications.settings.core.appUrl": "URL aplikacji",
   "notifications.settings.core.appUrlHint": "Służy do budowania bezwzględnych linków w powiadomieniach e-mail.",
   "notifications.settings.core.databaseHint": "Zapisuje powiadomienia w bazie danych dla panelu i dzwonka.",
@@ -35,7 +64,7 @@
   "notifications.settings.email.enabledHint": "Akcje w e-mailu są tylko do odczytu i prowadzą do centrum powiadomień.",
   "notifications.settings.email.enabledLabel": "Włącz dostarczanie e-mail",
   "notifications.settings.email.from": "Adres nadawcy",
-  "notifications.settings.email.replyTo": "Odpowiedz do",
+  "notifications.settings.email.replyTo": "Adres zwrotny",
   "notifications.settings.email.subjectPrefix": "Prefiks tematu",
   "notifications.settings.email.title": "Strategia e-mail",
   "notifications.settings.loadError": "Nie udało się załadować ustawień powiadomień",
@@ -46,10 +75,24 @@
   "notifications.settings.saveError": "Nie udało się zapisać ustawień powiadomień",
   "notifications.settings.saveSuccess": "Ustawienia powiadomień zapisane",
   "notifications.settings.saving": "Zapisywanie...",
+  "notifications.settings.types.description": "Kanały dostarczania per typ powiadomienia. Wyłączenie kanału całkowicie dezaktywuje go dla tego typu w Twoim tenancie — nigdy nie jest dostarczany, a użytkownicy nie mogą go włączyć w swoich preferencjach. Włączony kanał pozwala użytkownikom decydować per typ; typy wymagane (bez rezygnacji) zawsze dostarczają na włączonych kanałach. Twoje ustawienie nadpisuje domyślne z modułu.",
+  "notifications.settings.types.empty": "Nie zarejestrowano jeszcze żadnych typów powiadomień.",
+  "notifications.settings.types.lastChannelRestored": "Typ powiadomienia musi mieć co najmniej jeden kanał, więc przywrócono domyślne ustawienie modułu.",
+  "notifications.settings.types.loadError": "Nie udało się wczytać typów powiadomień",
+  "notifications.settings.types.requiredColumn": "Wymagane",
+  "notifications.settings.types.requiredHint": "Użytkownicy nie mogą zrezygnować, gdy włączone.",
+  "notifications.settings.types.saveError": "Nie udało się zapisać ustawień typu powiadomienia",
+  "notifications.settings.types.saveSuccess": "Zapisano ustawienia typu powiadomienia",
+  "notifications.settings.types.title": "Kanały dostarczania per typ",
+  "notifications.settings.types.typeColumn": "Typ powiadomienia",
   "notifications.title": "Powiadomienia",
   "notifications.toast.actionError": "Nie udało się wykonać akcji",
   "notifications.toast.actionSuccess": "Akcja wykonana pomyślnie",
   "notifications.toast.dismissed": "Powiadomienie odrzucone",
   "notifications.toast.new": "Nowe powiadomienie",
+  "notifications.types.invalidChannels": "Nieprawidłowe dane kanałów",
+  "notifications.types.overrideConflict": "Inny operator właśnie zapisał ten typ powiadomienia. Odśwież i spróbuj ponownie.",
+  "notifications.types.unknownChannel": "Nieznany kanał powiadomień",
+  "notifications.types.unknownType": "Nieznany typ powiadomienia",
   "notifications.unreadSummary": "{count} nieprzeczytanych"
 }

package/src/modules/notifications/lib/delivery-strategies-registry.ts

@@ -0,0 +1,30 @@
+import {
+  getNotificationDeliveryStrategies,
+  registerNotificationDeliveryStrategy,
+  type NotificationDeliveryStrategy,
+} from './deliveryStrategies'
+
+export type NotificationDeliveryStrategyEntry = {
+  moduleId: string
+  strategies: unknown[]
+}
+
+/**
+ * Bootstrap-time registration of module-contributed notification delivery strategies.
+ *
+ * Fed from the generated `notifications-delivery-strategies.generated.ts` aggregate (see
+ * `notifications/generators.ts`) via `runBootstrapRegistrations()`, mirroring how the security
+ * module registers its MFA providers. Idempotent: a strategy whose `id` is already registered is
+ * skipped, so a repeated bootstrap (HMR / test re-import) never double-registers.
+ */
+export function registerNotificationDeliveryStrategyEntries(entries: NotificationDeliveryStrategyEntry[]): void {
+  const registered = new Set(getNotificationDeliveryStrategies().map((strategy) => strategy.id))
+  for (const entry of entries) {
+    for (const strategy of entry.strategies ?? []) {
+      const candidate = strategy as NotificationDeliveryStrategy
+      if (!candidate?.id || registered.has(candidate.id)) continue
+      registerNotificationDeliveryStrategy(candidate)
+      registered.add(candidate.id)
+    }
+  }
+}

package/src/modules/notifications/lib/deliveryStrategies.ts

@@ -11,24 +11,60 @@ export type NotificationDeliveryRecipient = {
   name?: string | null
 }
 
-export type NotificationDeliveryContext = {
+/**
+ * Channel-agnostic delivery context. Every strategy can rely on these fields regardless of channel.
+ */
+export type NotificationDeliveryContextCore = {
   notification: Notification
   recipient: NotificationDeliveryRecipient
   title: string
   body: string | null
-  panelUrl: string | null
-  panelLink: string | null
-  actionLinks: Array<{ id: string; label: string; href: string }>
   deliveryConfig: NotificationDeliveryConfig
   config: NotificationDeliveryStrategyConfig
   resolve: <T = unknown>(name: string) => T
   t: (key: string, fallback?: string, variables?: Record<string, string>) => string
 }
 
+/**
+ * Email-shaped extras carried on every context for backward compatibility. Only the `email` strategy
+ * should read these — they encode one channel's assumptions (a panel deep-link and pre-rendered
+ * action hyperlinks). New channel strategies MUST derive whatever they need from `notification`
+ * instead.
+ *
+ * @deprecated These fields are email-specific and will move behind an email-scoped accessor in a
+ * future major version. Do not depend on them from a non-email strategy.
+ */
+export type EmailDeliveryExtras = {
+  /** @deprecated Email-specific. Absolute panel URL (no notification id). */
+  panelUrl: string | null
+  /** @deprecated Email-specific. Absolute deep link to the notification in the panel. */
+  panelLink: string | null
+  /** @deprecated Email-specific. Pre-resolved absolute action hyperlinks for the email template. */
+  actionLinks: Array<{ id: string; label: string; href: string }>
+}
+
+/**
+ * Full delivery context handed to `strategy.deliver`. Kept as the flat intersection of the
+ * channel-agnostic core and the email extras so existing strategies compile unchanged; the split
+ * documents which fields are channel-neutral vs. email-only (see `EmailDeliveryExtras`).
+ */
+export type NotificationDeliveryContext = NotificationDeliveryContextCore & EmailDeliveryExtras
+
 export type NotificationDeliveryStrategy = {
   id: string
   label?: string
   defaultEnabled?: boolean
+  /**
+   * Optional technical-deliverability gate evaluated by the dispatcher before `deliver`. Return
+   * `false` to skip this channel for the current context (e.g. email disabled by tenant config).
+   * This is NOT for per-user opt-out — that is enforced once at create time via `shouldDeliver`.
+   */
+  isConfigured?: (ctx: NotificationDeliveryContext) => boolean | Promise<boolean>
+  /**
+   * Optional per-notification applicability check. Return `false` to skip this strategy entirely for
+   * the given notification (e.g. a channel that only handles a certain notification shape).
+   */
+  supports?: (notification: Notification) => boolean
   deliver: (ctx: NotificationDeliveryContext) => Promise<void> | void
 }
 

package/src/modules/notifications/lib/derive-category.ts

@@ -0,0 +1,15 @@
+/**
+ * Default grouping key for a notification type when the declaring module does not
+ * provide an explicit `category`. Uses the prefix before the first dot (e.g.
+ * `sales.order.created` → `sales`), or the whole id when there is no dot.
+ *
+ * This intentionally has NO knowledge of specific notification types — modules
+ * that want a non-default grouping declare `category` on their notification type.
+ *
+ * Applied once, in `syncNotificationTypes`, so the mirrored row always carries a
+ * resolved category and read paths never need a fallback branch.
+ */
+export function deriveCategory(type: string): string {
+  const dot = type.indexOf('.')
+  return dot === -1 ? type : type.slice(0, dot)
+}

package/src/modules/notifications/lib/notification-channel-registry.ts

@@ -0,0 +1,59 @@
+import type { NotificationChannelDefinition } from '@open-mercato/shared/modules/notifications/types'
+
+const registry = new Map<string, NotificationChannelDefinition>()
+
+export type RegisterNotificationChannelsOptions = {
+  replace?: boolean
+}
+
+/**
+ * In-memory catalogue of module-contributed delivery channels. Fed at app bootstrap from the
+ * generated aggregate (see `notifications/generators.ts` → `channelsPlugin`), mirroring the
+ * notification-type registry. Provides labels/metadata for the preferences UI and the
+ * `GET /api/notifications/channels` endpoint; the delivery-strategy registry remains the
+ * behavior layer (both are keyed by the same channel id).
+ */
+export function registerNotificationChannels(
+  channels: NotificationChannelDefinition[],
+  options: RegisterNotificationChannelsOptions = {},
+): void {
+  if (options.replace) registry.clear()
+  for (const channel of channels) {
+    if (!channel?.id) continue
+    registry.set(channel.id, channel)
+  }
+}
+
+export function getNotificationChannel(id: string): NotificationChannelDefinition | undefined {
+  return registry.get(id)
+}
+
+export function getNotificationChannels(): NotificationChannelDefinition[] {
+  return Array.from(registry.values()).sort((a, b) => {
+    const orderA = a.order ?? Number.MAX_SAFE_INTEGER
+    const orderB = b.order ?? Number.MAX_SAFE_INTEGER
+    if (orderA !== orderB) return orderA - orderB
+    return a.id.localeCompare(b.id)
+  })
+}
+
+export type NotificationChannelEntry = {
+  moduleId: string
+  channels: unknown[]
+}
+
+/**
+ * Bootstrap-time registration of module-contributed channels, fed from the generated
+ * `notification-channels.generated.ts` aggregate via `runBootstrapRegistrations()`. Idempotent:
+ * a channel whose `id` is already registered is skipped, so a repeated bootstrap (HMR / test
+ * re-import) never double-registers.
+ */
+export function registerNotificationChannelEntries(entries: NotificationChannelEntry[]): void {
+  for (const entry of entries) {
+    for (const channel of entry.channels ?? []) {
+      const candidate = channel as NotificationChannelDefinition
+      if (!candidate?.id || registry.has(candidate.id)) continue
+      registry.set(candidate.id, candidate)
+    }
+  }
+}