@marinoscar/platform-api 0.0.0-stage → 0.1.0-next.10

package/dist/notifications/index.js

@@ -0,0 +1,173 @@
+"use strict";
+// =============================================================================
+// `@marinoscar/platform-api/notifications` (issue #738, PP-8.5)
+// =============================================================================
+//
+// The notifications slice: the event, channel and template registries, the
+// dispatcher, the channels (email, the in-app inbox and its SSE stream, Web
+// Push), the runtime Web Push configuration, the org-aware policy, admin
+// broadcasts (org-targeted), and the `job.settled` and `nodes.node.offline`
+// notifiers. Documented in ./README.md; the internals an app's own unit tests
+// construct are `@marinoscar/platform-api/notifications/testing`.
+//
+// Explicit named exports only.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OPS_NOTIFICATIONS = exports.NODES_NOTIFICATIONS = exports.BROADCASTS_NOTIFICATIONS = exports.supportsChannel = exports.listNotificationEvents = exports.isMandatory = exports.findEvent = exports.channelsFor = exports.NotificationChannelSenderRegistry = exports.renderChannelPayload = exports.registerPlatformNotificationChannels = exports.registerAndroidAppNotificationChannel = exports.registerNotifications = exports.registerNotificationEvent = exports.registerNotificationChannels = exports.registerNotificationChannel = exports.registerNotification = exports.registerEmailTemplates = exports.registerEmailNotificationTemplate = exports.registerChannelTemplate = exports.registerBrowserNotificationTemplate = exports.findChannelTemplate = exports.notificationEventRegistry = exports.notificationChannelRegistry = exports.listNotificationChannels = exports.isRegisteredNotificationChannel = exports.eventEmailTemplateRegistry = exports.eventBrowserTemplateRegistry = exports.emailTemplateRegistry = exports.describeNotificationChannels = exports.criticalCapableChannels = exports.collapseOverlappingChannels = exports.channelTemplateRegistry = exports.PLATFORM_NOTIFICATION_CHANNELS = exports.NOTIFICATION_EVENT_KEY_PATTERN = exports.NOTIFICATION_EVENT_KEY_MAX_LENGTH = exports.NOTIFICATION_CHANNEL_ID_PATTERN = exports.ANDROID_APP_NOTIFICATION_CHANNEL = exports.EMAIL_TEMPLATE_NAME_PATTERN = exports.NotificationsService = exports.NOTIFICATION_STREAM_INLINE_LIMIT_BYTES = exports.NOTIFICATION_STREAM_BUS_CHANNEL = exports.NOTIFICATION_RECIPIENT_HANDLES = exports.NOTIFICATIONS_METRICS = exports.NOTIFICATIONS_EVENT_BUS = exports.NOOP_NOTIFICATIONS_METRICS = exports.resolveNotificationsModuleOptions = exports.NOTIFICATIONS_OPTIONS = exports.BroadcastsModule = exports.NotificationsModule = void 0;
+exports.ORG_BROADCASTS_PERMISSIONS = exports.BROADCASTS_PERMISSIONS = exports.BROADCAST_CHUNK_TYPE = exports.BROADCAST_START_TYPE = exports.BROADCAST_EVENT_KEY = exports.BROADCAST_CRITICAL_EVENT_KEY = exports.audienceWhere = exports.BROADCAST_SUBJECT_TYPE = exports.BROADCAST_SEND_CONCURRENCY = exports.BROADCAST_CHUNK_SIZE = exports.PUSH_SETTINGS_PATH = exports.PUSH_VAPID_CREDENTIAL_PURPOSE_DEF = exports.PUSH_VAPID_CREDENTIAL_PURPOSE = exports.PUSH_VAPID_CREDENTIAL_NAME = exports.PUSH_VAPID_CREDENTIAL_LABEL = exports.DEFAULT_PUSH_CONFIG = exports.AndroidAppNotificationChannel = exports.endpointHost = exports.PushTestService = exports.PushConfigService = exports.PUSH_CONFIG_KEY = exports.parseNotificationStreamBusMessage = exports.NOTIFICATION_SSE_EVENT = exports.HEARTBEAT_INTERVAL_MS = exports.sanitizePushExtras = exports.PUSH_MAX_PAYLOAD_BYTES = exports.PUSH_MAX_ACTIONS = exports.notificationsPatchSchema = exports.NOTIFICATIONS_USER_SETTINGS = exports.tightenNotificationsPolicy = exports.NOTIFICATIONS_SYSTEM_SETTINGS = exports.policyChannels = exports.isChannelSwitchedOn = exports.isBrowserToastAllowed = exports.DEFAULT_NOTIFICATION_POLICY = exports.resolveChannels = exports.readNotificationPreferences = exports.isChannelEnabled = exports.NOTIFICATION_PREFERENCES_NAMESPACE = exports.sanitizeLink = exports.roleChangedBrowserTemplate = exports.restoreCompletedBrowserTemplate = exports.nodeOfflineBrowserTemplate = exports.broadcastBrowserTemplate = exports.backupFailedBrowserTemplate = exports.NotificationInboxPurgeHandler = exports.NOTIFICATION_INBOX_PURGE_TYPE = exports.PURGEABLE_DELIVERY_STATUSES = exports.NotificationDeliveriesPurgeHandler = exports.NOTIFICATION_DELIVERIES_PURGE_TYPE = void 0;
+exports.NotificationDeliveryStatus = exports.NotificationBroadcastStatus = exports.PUSH_PERMISSIONS = void 0;
+// ---- modules ---------------------------------------------------------------------------
+var notifications_module_1 = require("./notifications.module");
+Object.defineProperty(exports, "NotificationsModule", { enumerable: true, get: function () { return notifications_module_1.NotificationsModule; } });
+var broadcasts_module_1 = require("./broadcasts/broadcasts.module");
+Object.defineProperty(exports, "BroadcastsModule", { enumerable: true, get: function () { return broadcasts_module_1.BroadcastsModule; } });
+var notifications_options_1 = require("./notifications.options");
+Object.defineProperty(exports, "NOTIFICATIONS_OPTIONS", { enumerable: true, get: function () { return notifications_options_1.NOTIFICATIONS_OPTIONS; } });
+Object.defineProperty(exports, "resolveNotificationsModuleOptions", { enumerable: true, get: function () { return notifications_options_1.resolveNotificationsModuleOptions; } });
+// ---- host ports ------------------------------------------------------------------------
+var ports_1 = require("./ports");
+Object.defineProperty(exports, "NOOP_NOTIFICATIONS_METRICS", { enumerable: true, get: function () { return ports_1.NOOP_NOTIFICATIONS_METRICS; } });
+Object.defineProperty(exports, "NOTIFICATIONS_EVENT_BUS", { enumerable: true, get: function () { return ports_1.NOTIFICATIONS_EVENT_BUS; } });
+Object.defineProperty(exports, "NOTIFICATIONS_METRICS", { enumerable: true, get: function () { return ports_1.NOTIFICATIONS_METRICS; } });
+Object.defineProperty(exports, "NOTIFICATION_RECIPIENT_HANDLES", { enumerable: true, get: function () { return ports_1.NOTIFICATION_RECIPIENT_HANDLES; } });
+Object.defineProperty(exports, "NOTIFICATION_STREAM_BUS_CHANNEL", { enumerable: true, get: function () { return ports_1.NOTIFICATION_STREAM_BUS_CHANNEL; } });
+Object.defineProperty(exports, "NOTIFICATION_STREAM_INLINE_LIMIT_BYTES", { enumerable: true, get: function () { return ports_1.NOTIFICATION_STREAM_INLINE_LIMIT_BYTES; } });
+// ---- the dispatcher ----------------------------------------------------------------------
+var notifications_service_1 = require("./notifications.service");
+Object.defineProperty(exports, "NotificationsService", { enumerable: true, get: function () { return notifications_service_1.NotificationsService; } });
+// ---- registries --------------------------------------------------------------------------
+var index_1 = require("./registry/index");
+Object.defineProperty(exports, "EMAIL_TEMPLATE_NAME_PATTERN", { enumerable: true, get: function () { return index_1.EMAIL_TEMPLATE_NAME_PATTERN; } });
+Object.defineProperty(exports, "ANDROID_APP_NOTIFICATION_CHANNEL", { enumerable: true, get: function () { return index_1.ANDROID_APP_NOTIFICATION_CHANNEL; } });
+Object.defineProperty(exports, "NOTIFICATION_CHANNEL_ID_PATTERN", { enumerable: true, get: function () { return index_1.NOTIFICATION_CHANNEL_ID_PATTERN; } });
+Object.defineProperty(exports, "NOTIFICATION_EVENT_KEY_MAX_LENGTH", { enumerable: true, get: function () { return index_1.NOTIFICATION_EVENT_KEY_MAX_LENGTH; } });
+Object.defineProperty(exports, "NOTIFICATION_EVENT_KEY_PATTERN", { enumerable: true, get: function () { return index_1.NOTIFICATION_EVENT_KEY_PATTERN; } });
+Object.defineProperty(exports, "PLATFORM_NOTIFICATION_CHANNELS", { enumerable: true, get: function () { return index_1.PLATFORM_NOTIFICATION_CHANNELS; } });
+Object.defineProperty(exports, "channelTemplateRegistry", { enumerable: true, get: function () { return index_1.channelTemplateRegistry; } });
+Object.defineProperty(exports, "collapseOverlappingChannels", { enumerable: true, get: function () { return index_1.collapseOverlappingChannels; } });
+Object.defineProperty(exports, "criticalCapableChannels", { enumerable: true, get: function () { return index_1.criticalCapableChannels; } });
+Object.defineProperty(exports, "describeNotificationChannels", { enumerable: true, get: function () { return index_1.describeNotificationChannels; } });
+Object.defineProperty(exports, "emailTemplateRegistry", { enumerable: true, get: function () { return index_1.emailTemplateRegistry; } });
+Object.defineProperty(exports, "eventBrowserTemplateRegistry", { enumerable: true, get: function () { return index_1.eventBrowserTemplateRegistry; } });
+Object.defineProperty(exports, "eventEmailTemplateRegistry", { enumerable: true, get: function () { return index_1.eventEmailTemplateRegistry; } });
+Object.defineProperty(exports, "isRegisteredNotificationChannel", { enumerable: true, get: function () { return index_1.isRegisteredNotificationChannel; } });
+Object.defineProperty(exports, "listNotificationChannels", { enumerable: true, get: function () { return index_1.listNotificationChannels; } });
+Object.defineProperty(exports, "notificationChannelRegistry", { enumerable: true, get: function () { return index_1.notificationChannelRegistry; } });
+Object.defineProperty(exports, "notificationEventRegistry", { enumerable: true, get: function () { return index_1.notificationEventRegistry; } });
+Object.defineProperty(exports, "findChannelTemplate", { enumerable: true, get: function () { return index_1.findChannelTemplate; } });
+Object.defineProperty(exports, "registerBrowserNotificationTemplate", { enumerable: true, get: function () { return index_1.registerBrowserNotificationTemplate; } });
+Object.defineProperty(exports, "registerChannelTemplate", { enumerable: true, get: function () { return index_1.registerChannelTemplate; } });
+Object.defineProperty(exports, "registerEmailNotificationTemplate", { enumerable: true, get: function () { return index_1.registerEmailNotificationTemplate; } });
+Object.defineProperty(exports, "registerEmailTemplates", { enumerable: true, get: function () { return index_1.registerEmailTemplates; } });
+Object.defineProperty(exports, "registerNotification", { enumerable: true, get: function () { return index_1.registerNotification; } });
+Object.defineProperty(exports, "registerNotificationChannel", { enumerable: true, get: function () { return index_1.registerNotificationChannel; } });
+Object.defineProperty(exports, "registerNotificationChannels", { enumerable: true, get: function () { return index_1.registerNotificationChannels; } });
+Object.defineProperty(exports, "registerNotificationEvent", { enumerable: true, get: function () { return index_1.registerNotificationEvent; } });
+Object.defineProperty(exports, "registerNotifications", { enumerable: true, get: function () { return index_1.registerNotifications; } });
+Object.defineProperty(exports, "registerAndroidAppNotificationChannel", { enumerable: true, get: function () { return index_1.registerAndroidAppNotificationChannel; } });
+Object.defineProperty(exports, "registerPlatformNotificationChannels", { enumerable: true, get: function () { return index_1.registerPlatformNotificationChannels; } });
+Object.defineProperty(exports, "renderChannelPayload", { enumerable: true, get: function () { return index_1.renderChannelPayload; } });
+var channel_sender_registry_1 = require("./registry/channel-sender.registry");
+Object.defineProperty(exports, "NotificationChannelSenderRegistry", { enumerable: true, get: function () { return channel_sender_registry_1.NotificationChannelSenderRegistry; } });
+var notification_events_1 = require("./notification-events");
+Object.defineProperty(exports, "channelsFor", { enumerable: true, get: function () { return notification_events_1.channelsFor; } });
+Object.defineProperty(exports, "findEvent", { enumerable: true, get: function () { return notification_events_1.findEvent; } });
+Object.defineProperty(exports, "isMandatory", { enumerable: true, get: function () { return notification_events_1.isMandatory; } });
+Object.defineProperty(exports, "listNotificationEvents", { enumerable: true, get: function () { return notification_events_1.listNotificationEvents; } });
+Object.defineProperty(exports, "supportsChannel", { enumerable: true, get: function () { return notification_events_1.supportsChannel; } });
+// The platform's own notifications, for the app's manifest to register in its
+// chosen order.
+var broadcasts_notifications_1 = require("./broadcasts/broadcasts.notifications");
+Object.defineProperty(exports, "BROADCASTS_NOTIFICATIONS", { enumerable: true, get: function () { return broadcasts_notifications_1.BROADCASTS_NOTIFICATIONS; } });
+var nodes_notifications_1 = require("./ops/nodes.notifications");
+Object.defineProperty(exports, "NODES_NOTIFICATIONS", { enumerable: true, get: function () { return nodes_notifications_1.NODES_NOTIFICATIONS; } });
+var ops_notifications_1 = require("./ops/ops.notifications");
+Object.defineProperty(exports, "OPS_NOTIFICATIONS", { enumerable: true, get: function () { return ops_notifications_1.OPS_NOTIFICATIONS; } });
+// ---- the retention purges of this slice's tables (#898) -----------------------------------
+var notification_deliveries_purge_handler_1 = require("./retention/notification-deliveries-purge.handler");
+Object.defineProperty(exports, "NOTIFICATION_DELIVERIES_PURGE_TYPE", { enumerable: true, get: function () { return notification_deliveries_purge_handler_1.NOTIFICATION_DELIVERIES_PURGE_TYPE; } });
+Object.defineProperty(exports, "NotificationDeliveriesPurgeHandler", { enumerable: true, get: function () { return notification_deliveries_purge_handler_1.NotificationDeliveriesPurgeHandler; } });
+Object.defineProperty(exports, "PURGEABLE_DELIVERY_STATUSES", { enumerable: true, get: function () { return notification_deliveries_purge_handler_1.PURGEABLE_DELIVERY_STATUSES; } });
+var notification_inbox_purge_handler_1 = require("./retention/notification-inbox-purge.handler");
+Object.defineProperty(exports, "NOTIFICATION_INBOX_PURGE_TYPE", { enumerable: true, get: function () { return notification_inbox_purge_handler_1.NOTIFICATION_INBOX_PURGE_TYPE; } });
+Object.defineProperty(exports, "NotificationInboxPurgeHandler", { enumerable: true, get: function () { return notification_inbox_purge_handler_1.NotificationInboxPurgeHandler; } });
+// ---- browser and push rendering ----------------------------------------------------------
+var browser_templates_1 = require("./channels/browser-templates");
+Object.defineProperty(exports, "backupFailedBrowserTemplate", { enumerable: true, get: function () { return browser_templates_1.backupFailedBrowserTemplate; } });
+Object.defineProperty(exports, "broadcastBrowserTemplate", { enumerable: true, get: function () { return browser_templates_1.broadcastBrowserTemplate; } });
+Object.defineProperty(exports, "nodeOfflineBrowserTemplate", { enumerable: true, get: function () { return browser_templates_1.nodeOfflineBrowserTemplate; } });
+Object.defineProperty(exports, "restoreCompletedBrowserTemplate", { enumerable: true, get: function () { return browser_templates_1.restoreCompletedBrowserTemplate; } });
+Object.defineProperty(exports, "roleChangedBrowserTemplate", { enumerable: true, get: function () { return browser_templates_1.roleChangedBrowserTemplate; } });
+var browser_notification_channel_1 = require("./channels/browser-notification.channel");
+Object.defineProperty(exports, "sanitizeLink", { enumerable: true, get: function () { return browser_notification_channel_1.sanitizeLink; } });
+// ---- preferences, policy, settings namespaces ------------------------------------------
+var notification_preferences_1 = require("./notification-preferences");
+Object.defineProperty(exports, "NOTIFICATION_PREFERENCES_NAMESPACE", { enumerable: true, get: function () { return notification_preferences_1.NOTIFICATION_PREFERENCES_NAMESPACE; } });
+Object.defineProperty(exports, "isChannelEnabled", { enumerable: true, get: function () { return notification_preferences_1.isChannelEnabled; } });
+Object.defineProperty(exports, "readNotificationPreferences", { enumerable: true, get: function () { return notification_preferences_1.readNotificationPreferences; } });
+Object.defineProperty(exports, "resolveChannels", { enumerable: true, get: function () { return notification_preferences_1.resolveChannels; } });
+var notification_policy_1 = require("./notification-policy");
+Object.defineProperty(exports, "DEFAULT_NOTIFICATION_POLICY", { enumerable: true, get: function () { return notification_policy_1.DEFAULT_NOTIFICATION_POLICY; } });
+Object.defineProperty(exports, "isBrowserToastAllowed", { enumerable: true, get: function () { return notification_policy_1.isBrowserToastAllowed; } });
+Object.defineProperty(exports, "isChannelSwitchedOn", { enumerable: true, get: function () { return notification_policy_1.isChannelSwitchedOn; } });
+Object.defineProperty(exports, "policyChannels", { enumerable: true, get: function () { return notification_policy_1.policyChannels; } });
+var notifications_system_settings_1 = require("./notifications.system-settings");
+Object.defineProperty(exports, "NOTIFICATIONS_SYSTEM_SETTINGS", { enumerable: true, get: function () { return notifications_system_settings_1.NOTIFICATIONS_SYSTEM_SETTINGS; } });
+Object.defineProperty(exports, "tightenNotificationsPolicy", { enumerable: true, get: function () { return notifications_system_settings_1.tightenNotificationsPolicy; } });
+var notifications_user_settings_1 = require("./notifications.user-settings");
+Object.defineProperty(exports, "NOTIFICATIONS_USER_SETTINGS", { enumerable: true, get: function () { return notifications_user_settings_1.NOTIFICATIONS_USER_SETTINGS; } });
+Object.defineProperty(exports, "notificationsPatchSchema", { enumerable: true, get: function () { return notifications_user_settings_1.notificationsPatchSchema; } });
+// ---- push payload extras ---------------------------------------------------------------
+var push_payload_1 = require("./channels/push-payload");
+Object.defineProperty(exports, "PUSH_MAX_ACTIONS", { enumerable: true, get: function () { return push_payload_1.PUSH_MAX_ACTIONS; } });
+Object.defineProperty(exports, "PUSH_MAX_PAYLOAD_BYTES", { enumerable: true, get: function () { return push_payload_1.PUSH_MAX_PAYLOAD_BYTES; } });
+Object.defineProperty(exports, "sanitizePushExtras", { enumerable: true, get: function () { return push_payload_1.sanitizePushExtras; } });
+// ---- the stream --------------------------------------------------------------------------
+var notification_stream_service_1 = require("./notification-stream.service");
+Object.defineProperty(exports, "HEARTBEAT_INTERVAL_MS", { enumerable: true, get: function () { return notification_stream_service_1.HEARTBEAT_INTERVAL_MS; } });
+Object.defineProperty(exports, "NOTIFICATION_SSE_EVENT", { enumerable: true, get: function () { return notification_stream_service_1.NOTIFICATION_SSE_EVENT; } });
+Object.defineProperty(exports, "parseNotificationStreamBusMessage", { enumerable: true, get: function () { return notification_stream_service_1.parseNotificationStreamBusMessage; } });
+// ---- Web Push configuration ----------------------------------------------------------------
+var push_config_service_1 = require("./push-config.service");
+Object.defineProperty(exports, "PUSH_CONFIG_KEY", { enumerable: true, get: function () { return push_config_service_1.PUSH_CONFIG_KEY; } });
+Object.defineProperty(exports, "PushConfigService", { enumerable: true, get: function () { return push_config_service_1.PushConfigService; } });
+// #746: what the android-app slice (a sibling) needs to send its test
+// notification and to provide the `android_app` sender. The two classes are
+// `@internal` (no app should reach a channel or the test sender directly).
+var push_test_service_1 = require("./push-test.service");
+Object.defineProperty(exports, "PushTestService", { enumerable: true, get: function () { return push_test_service_1.PushTestService; } });
+Object.defineProperty(exports, "endpointHost", { enumerable: true, get: function () { return push_test_service_1.endpointHost; } });
+var android_app_notification_channel_1 = require("./channels/android-app-notification.channel");
+Object.defineProperty(exports, "AndroidAppNotificationChannel", { enumerable: true, get: function () { return android_app_notification_channel_1.AndroidAppNotificationChannel; } });
+var push_config_schema_1 = require("./push-config.schema");
+Object.defineProperty(exports, "DEFAULT_PUSH_CONFIG", { enumerable: true, get: function () { return push_config_schema_1.DEFAULT_PUSH_CONFIG; } });
+var push_vapid_credential_constants_1 = require("./push-vapid-credential.constants");
+Object.defineProperty(exports, "PUSH_VAPID_CREDENTIAL_LABEL", { enumerable: true, get: function () { return push_vapid_credential_constants_1.PUSH_VAPID_CREDENTIAL_LABEL; } });
+Object.defineProperty(exports, "PUSH_VAPID_CREDENTIAL_NAME", { enumerable: true, get: function () { return push_vapid_credential_constants_1.PUSH_VAPID_CREDENTIAL_NAME; } });
+Object.defineProperty(exports, "PUSH_VAPID_CREDENTIAL_PURPOSE", { enumerable: true, get: function () { return push_vapid_credential_constants_1.PUSH_VAPID_CREDENTIAL_PURPOSE; } });
+Object.defineProperty(exports, "PUSH_VAPID_CREDENTIAL_PURPOSE_DEF", { enumerable: true, get: function () { return push_vapid_credential_constants_1.PUSH_VAPID_CREDENTIAL_PURPOSE_DEF; } });
+var push_vapid_doctor_check_1 = require("./doctor/push-vapid.doctor-check");
+Object.defineProperty(exports, "PUSH_SETTINGS_PATH", { enumerable: true, get: function () { return push_vapid_doctor_check_1.PUSH_SETTINGS_PATH; } });
+// ---- broadcasts ----------------------------------------------------------------------------
+var broadcast_audience_1 = require("./broadcasts/broadcast-audience");
+Object.defineProperty(exports, "BROADCAST_CHUNK_SIZE", { enumerable: true, get: function () { return broadcast_audience_1.BROADCAST_CHUNK_SIZE; } });
+Object.defineProperty(exports, "BROADCAST_SEND_CONCURRENCY", { enumerable: true, get: function () { return broadcast_audience_1.BROADCAST_SEND_CONCURRENCY; } });
+Object.defineProperty(exports, "BROADCAST_SUBJECT_TYPE", { enumerable: true, get: function () { return broadcast_audience_1.BROADCAST_SUBJECT_TYPE; } });
+Object.defineProperty(exports, "audienceWhere", { enumerable: true, get: function () { return broadcast_audience_1.audienceWhere; } });
+var broadcasts_service_1 = require("./broadcasts/broadcasts.service");
+Object.defineProperty(exports, "BROADCAST_CRITICAL_EVENT_KEY", { enumerable: true, get: function () { return broadcasts_service_1.BROADCAST_CRITICAL_EVENT_KEY; } });
+Object.defineProperty(exports, "BROADCAST_EVENT_KEY", { enumerable: true, get: function () { return broadcasts_service_1.BROADCAST_EVENT_KEY; } });
+var broadcast_start_handler_1 = require("./broadcasts/handlers/broadcast-start.handler");
+Object.defineProperty(exports, "BROADCAST_START_TYPE", { enumerable: true, get: function () { return broadcast_start_handler_1.BROADCAST_START_TYPE; } });
+var broadcast_chunk_handler_1 = require("./broadcasts/handlers/broadcast-chunk.handler");
+Object.defineProperty(exports, "BROADCAST_CHUNK_TYPE", { enumerable: true, get: function () { return broadcast_chunk_handler_1.BROADCAST_CHUNK_TYPE; } });
+// ---- permissions ---------------------------------------------------------------------------
+var notifications_permissions_1 = require("./notifications.permissions");
+Object.defineProperty(exports, "BROADCASTS_PERMISSIONS", { enumerable: true, get: function () { return notifications_permissions_1.BROADCASTS_PERMISSIONS; } });
+Object.defineProperty(exports, "ORG_BROADCASTS_PERMISSIONS", { enumerable: true, get: function () { return notifications_permissions_1.ORG_BROADCASTS_PERMISSIONS; } });
+Object.defineProperty(exports, "PUSH_PERMISSIONS", { enumerable: true, get: function () { return notifications_permissions_1.PUSH_PERMISSIONS; } });
+// ---- data --------------------------------------------------------------------------------
+var notifications_db_1 = require("./data/notifications-db");
+Object.defineProperty(exports, "NotificationBroadcastStatus", { enumerable: true, get: function () { return notifications_db_1.NotificationBroadcastStatus; } });
+Object.defineProperty(exports, "NotificationDeliveryStatus", { enumerable: true, get: function () { return notifications_db_1.NotificationDeliveryStatus; } });
+//# sourceMappingURL=index.js.map

package/dist/notifications/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"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"}

package/dist/notifications/notification-delivery.service.d.ts

@@ -0,0 +1,63 @@
+import type { NotificationsPrisma } from './data/notifications-db';
+import type { NotificationChannel } from './notification-events';
+/**
+ * What identifies a delivery attempt at the moment it is queued.
+ *
+ * @internal
+ */
+export interface QueuedDeliveryInput {
+    eventKey: string;
+    /** `null` for a recipient with no account — see `NotificationRecipient`. */
+    userId: string | null;
+    /**
+     * The destination ACTUALLY used for this attempt.
+     *
+     * Captured independently of the user relation, so the record stands on its
+     * own with `userId` null and stays historically accurate if the user's
+     * email later changes. Never re-derived from the user row at read time.
+     */
+    recipient: string;
+    channel: NotificationChannel;
+}
+/**
+ * Exported for an app's own unit tests (`@marinoscar/platform-api/notifications/testing`); not an extension point: reach it through `NotificationsModule` and its documented seams.
+ *
+ * @internal
+ */
+export declare class NotificationDeliveryService {
+    private readonly prisma;
+    private readonly logger;
+    constructor(prisma: NotificationsPrisma);
+    /**
+     * Open a delivery record, before the attempt.
+     *
+     * @returns the row id, or `null` when the row could not be written. `null`
+     *          is not a reason to abandon the send: the notification still
+     *          matters more than its bookkeeping, and the dispatcher carries on
+     *          with the id absent (the later `markSent`/`markFailed` become
+     *          no-ops). Returning null rather than throwing is what lets the
+     *          dispatcher express that in a single `if`.
+     */
+    queue(input: QueuedDeliveryInput): Promise<string | null>;
+    /**
+     * Close a delivery record as delivered.
+     *
+     * @param deliveryId - `null` when {@link queue} could not write a row — the
+     *        call is then a no-op, so the dispatcher does not need a null check
+     *        at every call site.
+     */
+    markSent(deliveryId: string | null, messageId?: string): Promise<void>;
+    /**
+     * Close a delivery record as failed, with the reason.
+     *
+     * The reason is the entire value of the row for triage — "it failed" without
+     * "because SES rejected the sender identity" answers nothing.
+     */
+    markFailed(deliveryId: string | null, error: string): Promise<void>;
+    /**
+     * The single write path for closing a record, so `sent` and `failed` cannot
+     * drift in how they treat the columns they do not set.
+     */
+    private finalise;
+}
+//# sourceMappingURL=notification-delivery.service.d.ts.map

package/dist/notifications/notification-delivery.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-delivery.service.d.ts","sourceRoot":"","sources":["../../src/notifications/notification-delivery.service.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAsEjE;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IAEjB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB,OAAO,EAAE,mBAAmB,CAAC;CAC9B;AAED;;;;GAIG;AACH,qBACa,2BAA2B;IAGD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAF5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgD;gBAEjB,MAAM,EAAE,mBAAmB;IAEjF;;;;;;;;;OASG;IACG,KAAK,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA+B/D;;;;;;OAMG;IACG,QAAQ,CACZ,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAYhB;;;;;OAKG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzE;;;OAGG;YACW,QAAQ;CAyBvB"}

package/dist/notifications/notification-delivery.service.js

@@ -0,0 +1,194 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var NotificationDeliveryService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationDeliveryService = void 0;
+const common_1 = require("@nestjs/common");
+const notifications_db_1 = require("./data/notifications-db");
+const index_1 = require("../core/index");
+const describe_thrown_1 = require("./describe-thrown");
+// =============================================================================
+// NotificationDeliveryService — the delivery record (issue #125, epic #109)
+// =============================================================================
+//
+// "Did the user actually get it?" is the first question asked when something
+// goes wrong, and without this table it is unanswerable: a user reporting a
+// missing email cannot be distinguished from a bounce, a mute, a
+// misconfiguration, or an event that never fired.
+//
+// -----------------------------------------------------------------------------
+// TWO WRITES PER ATTEMPT: `queued` FIRST, THEN `sent`/`failed`
+// -----------------------------------------------------------------------------
+//
+// The obvious cheaper design is one write after the attempt, carrying the
+// final status. It has a hole that the extra write exists to close: the
+// dispatch is FIRE-AND-FORGET AND IN-PROCESS (see notifications.service.ts).
+// If the process is killed — a deploy, an OOM, a `SIGKILL` — between "we
+// decided to send this" and "the provider answered", the one-write design
+// leaves NO EVIDENCE AT ALL. The notification is gone and nothing anywhere
+// records that it was ever attempted, which is precisely the state this table
+// exists to make impossible.
+//
+// With the `queued` row written first, that crash leaves a row stuck at
+// `queued`, and `queued` rows older than a few seconds are a legible signal
+// with a query already indexed for it (`@@index([status, createdAt])` — "what
+// failed recently?"). The schema's `status` default is `queued` for the same
+// reason.
+//
+// The cost is one extra UPDATE per notification, on a row this process is
+// holding the id of. That is cheap, and it is not on the caller's request path
+// at all — the dispatch already returned to them.
+//
+// -----------------------------------------------------------------------------
+// NOTHING HERE THROWS
+// -----------------------------------------------------------------------------
+//
+// Every method swallows its own database errors and reports the failure by
+// returning (`null`, or nothing) rather than by rejecting. #125's rule is that
+// a notification failure never fails the action that triggered it, and
+// "recording the send failed" must not become a new way to fail. A dispatcher
+// that has to `try`/`catch` its own bookkeeping in three places is a
+// dispatcher with three chances to miss one.
+//
+// The consequence is accepted deliberately: if the database is down, a
+// notification can be delivered with no record of it. The alternative —
+// refusing to send unless we can write the row — trades a missing audit line
+// for a missing security alert, which is the worse of the two.
+// =============================================================================
+/**
+ * Cap on stored error text.
+ *
+ * Provider errors arrive already redacted and capped at 2000 by
+ * `BaseEmailProvider.formatError`, so this is for the errors authored on THIS
+ * side — a render failure carrying a stack, a configuration message. Matching
+ * that cap keeps one number in the reader's head, and stops a pathological
+ * exception message from being written verbatim into a table that grows with
+ * every notification sent.
+ */
+const MAX_ERROR_LENGTH = 2000;
+/** Truncate for storage, marking that it happened. */
+function capError(raw) {
+    return raw.length > MAX_ERROR_LENGTH
+        ? `${raw.slice(0, MAX_ERROR_LENGTH)}… (truncated)`
+        : raw;
+}
+/**
+ * Exported for an app's own unit tests (`@marinoscar/platform-api/notifications/testing`); not an extension point: reach it through `NotificationsModule` and its documented seams.
+ *
+ * @internal
+ */
+let NotificationDeliveryService = NotificationDeliveryService_1 = class NotificationDeliveryService {
+    prisma;
+    logger = new common_1.Logger(NotificationDeliveryService_1.name);
+    constructor(prisma) {
+        this.prisma = prisma;
+    }
+    /**
+     * Open a delivery record, before the attempt.
+     *
+     * @returns the row id, or `null` when the row could not be written. `null`
+     *          is not a reason to abandon the send: the notification still
+     *          matters more than its bookkeeping, and the dispatcher carries on
+     *          with the id absent (the later `markSent`/`markFailed` become
+     *          no-ops). Returning null rather than throwing is what lets the
+     *          dispatcher express that in a single `if`.
+     */
+    async queue(input) {
+        try {
+            const row = await this.prisma.notificationDelivery.create({
+                data: {
+                    eventKey: input.eventKey,
+                    userId: input.userId,
+                    recipient: input.recipient,
+                    channel: input.channel,
+                    // Explicit, though the column defaults to it. The state machine is
+                    // this service's own and reads better stated than inherited.
+                    status: notifications_db_1.NotificationDeliveryStatus.queued,
+                },
+                select: { id: true },
+            });
+            return row.id;
+        }
+        catch (err) {
+            // `error`, not `warn`: unlike a refused send, a failure to write this
+            // row is an infrastructure fault on OUR side, and it means the audit
+            // trail has a hole in it.
+            //
+            // No recipient address and no payload in the message — see the logging
+            // note in notifications.service.ts.
+            this.logger.error(`Could not record a queued ${input.channel} delivery for event ` +
+                `${input.eventKey}: ${(0, describe_thrown_1.describeThrown)(err)}`);
+            return null;
+        }
+    }
+    /**
+     * Close a delivery record as delivered.
+     *
+     * @param deliveryId - `null` when {@link queue} could not write a row — the
+     *        call is then a no-op, so the dispatcher does not need a null check
+     *        at every call site.
+     */
+    async markSent(deliveryId, messageId) {
+        await this.finalise(deliveryId, {
+            status: notifications_db_1.NotificationDeliveryStatus.sent,
+            // `?? null`, not omitted: a provider that reports success without an id
+            // (a legitimate outcome for some transports) should leave the column
+            // explicitly empty rather than carrying over whatever a retry might
+            // once have written there.
+            providerMessageId: messageId ?? null,
+            error: null,
+        });
+    }
+    /**
+     * Close a delivery record as failed, with the reason.
+     *
+     * The reason is the entire value of the row for triage — "it failed" without
+     * "because SES rejected the sender identity" answers nothing.
+     */
+    async markFailed(deliveryId, error) {
+        await this.finalise(deliveryId, {
+            status: notifications_db_1.NotificationDeliveryStatus.failed,
+            providerMessageId: null,
+            error: capError(error),
+        });
+    }
+    /**
+     * The single write path for closing a record, so `sent` and `failed` cannot
+     * drift in how they treat the columns they do not set.
+     */
+    async finalise(deliveryId, data) {
+        if (deliveryId === null)
+            return;
+        try {
+            await this.prisma.notificationDelivery.update({
+                where: { id: deliveryId },
+                data,
+            });
+        }
+        catch (err) {
+            // The send itself may well have succeeded; only the bookkeeping failed.
+            // Logged so the stuck `queued` row that results has an explanation
+            // somewhere, and swallowed so it cannot propagate — see the header.
+            this.logger.error(`Could not finalise delivery ${deliveryId} as ${data.status}: ` +
+                `${(0, describe_thrown_1.describeThrown)(err)}`);
+        }
+    }
+};
+exports.NotificationDeliveryService = NotificationDeliveryService;
+exports.NotificationDeliveryService = NotificationDeliveryService = NotificationDeliveryService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(index_1.PLATFORM_PRISMA)),
+    __metadata("design:paramtypes", [Object])
+], NotificationDeliveryService);
+//# sourceMappingURL=notification-delivery.service.js.map

package/dist/notifications/notification-delivery.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-delivery.service.js","sourceRoot":"","sources":["../../src/notifications/notification-delivery.service.ts"],"names":[],"mappings":"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"}

package/dist/notifications/notification-events.d.ts

@@ -0,0 +1,72 @@
+import type { NotificationChannel } from './registry/channel.registry';
+import type { NotificationEventDef } from './registry/event.registry';
+export type { NotificationChannel } from './registry/channel.registry';
+export type { NotificationEventDef } from './registry/event.registry';
+/**
+ * Every registered event, read from the registry now, in registration order.
+ *
+ * A fresh array each call; the entries are the registry's own objects, so do
+ * not mutate them.
+  *
+  * @stability stable
+ */
+export declare function listNotificationEvents(): NotificationEventDef[];
+/**
+ * The definition for `key`, or `undefined` when nothing is registered under it.
+ *
+ * RETURNS `undefined` RATHER THAN THROWING because the caller is frequently
+ * holding a string that came from persisted data — a preference row or a
+ * delivery record written before an event was removed from this list. A
+ * decommissioned event must not turn a preferences page render into a 500;
+ * the caller decides whether an unknown key is "skip it" or "this is a bug".
+ *
+ * A keyed lookup in the registry, so the dispatcher's per-delivery lookups are
+ * not a linear scan.
+  *
+  * @stability stable
+ */
+export declare function findEvent(key: string): NotificationEventDef | undefined;
+/**
+ * Channels `key` can be delivered over, or an empty array when the key is
+ * unknown.
+ *
+ * Empty-for-unknown is the safe direction and is deliberately not an
+ * exception: every caller is about to iterate the result, and "an event that
+ * no longer exists is delivered nowhere" is the correct outcome of that loop.
+ * Throwing would instead take down whatever action raised the stale event —
+ * violating epic #109's rule that a notification failure never fails the
+ * action that triggered it.
+ *
+ * Returns a defensive copy: the arrays in the registered events are the
+ * registry's own state, and a caller that sorted or spliced the result in
+ * place would silently reconfigure delivery for every later dispatch in the
+ * process.
+  *
+  * @stability stable
+ */
+export declare function channelsFor(key: string): NotificationChannel[];
+/**
+ * Can `key` be delivered over `channel`?
+ *
+ * The membership test the dispatcher (#125) needs on every delivery, kept here
+ * so the answer is not re-derived — and re-derived subtly differently — at
+ * each call site. Unknown key is `false`, consistent with `channelsFor`.
+  *
+  * @stability stable
+ */
+export declare function supportsChannel(key: string, channel: NotificationChannel): boolean;
+/**
+ * Is `key` an event the user may not opt out of?
+ *
+ * THE SERVER-SIDE GATE, not a UI hint. #125 calls this during preference
+ * resolution, so a stored preference disabling a mandatory event is ignored no
+ * matter how it got written — including by a crafted PATCH that never went
+ * near the UI.
+ *
+ * Unknown key is `false`: an event that is not registered cannot be dispatched
+ * at all, so nothing is being weakened by the default.
+  *
+  * @stability stable
+ */
+export declare function isMandatory(key: string): boolean;
+//# sourceMappingURL=notification-events.d.ts.map

package/dist/notifications/notification-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-events.d.ts","sourceRoot":"","sources":["../../src/notifications/notification-events.ts"],"names":[],"mappings":"AAkHA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,oBAAoB,EAAE,CAE/D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAEvE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAE9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAElF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD"}