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

package/dist/notifications/registry/channel.registry.js

@@ -0,0 +1,214 @@
+"use strict";
+// =============================================================================
+// Notification channel registry (issue #678, PP-1.6)
+// =============================================================================
+//
+// The set of delivery channels an event may declare. Until #678 this was the
+// closed literal `NOTIFICATION_CHANNELS = ['email', 'browser', 'push'] as const`
+// in notification-events.ts, so an app that added a transport (EvoPath's
+// `android_app`) had to edit a platform file. Now the platform registers its
+// three channels from `platform-channels.ts` and an app registers its own from
+// its manifest (the reference app: `app-registrations/notifications.ts`).
+//
+// OPEN SINCE #738. No closed tuple of channel ids is derived any more: the wire
+// contract takes any id matching the pattern
+// (`@marinoscar/platform-contract/notifications`), and a request that writes a
+// NEW preference or names a broadcast channel is checked against this registry
+// at run time. A preference stored for a channel that is later unregistered is
+// kept (a row outlives the registry that produced it).
+//
+// A CHANNEL ID IS A PERSISTED IDENTIFIER. It is the outer key of every user's
+// stored notification preferences (`user_settings.value.notifications`) and the
+// `channel` column of `notification_deliveries`. Never rename one; add a new id.
+//
+// This file declares WHICH channels exist. It does not deliver anything: the
+// transport for a channel is a `NotificationChannelSender`, held by the DI
+// registry in `channel-sender.registry.ts`. A channel declared here with no
+// sender is the documented "declared before its transport lands" state, which
+// the dispatcher skips quietly.
+//
+// FRAMEWORK-FREE: imports only the registry primitive, so DTOs built at module
+// evaluation time, the seed and standalone scripts can read it.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.notificationChannelRegistry = exports.NOTIFICATION_CHANNEL_ID_PATTERN = void 0;
+exports.registerNotificationChannels = registerNotificationChannels;
+exports.registerNotificationChannel = registerNotificationChannel;
+exports.isRegisteredNotificationChannel = isRegisteredNotificationChannel;
+exports.listNotificationChannels = listNotificationChannels;
+exports.collapseOverlappingChannels = collapseOverlappingChannels;
+exports.describeNotificationChannels = describeNotificationChannels;
+exports.criticalCapableChannels = criticalCapableChannels;
+const index_1 = require("../../core/index");
+const event_registry_1 = require("./event.registry");
+const notifications_1 = require("@marinoscar/platform-contract/notifications");
+/**
+ * What every channel id must look like (the wire contract's pattern).
+ *
+ * @stability stable
+ */
+exports.NOTIFICATION_CHANNEL_ID_PATTERN = notifications_1.NOTIFICATION_CHANNEL_ID_PATTERN;
+/**
+ * Every delivery channel, in registration order (platform first, then the
+ * app's). Filled by the app's manifest before it composes
+ * `NotificationsModule.forRoot()`; frozen once the application has
+ * bootstrapped.
+ *
+ * @extensionPoint registry
+ * @stability stable
+ */
+exports.notificationChannelRegistry = (0, index_1.defineRegistry)({
+    name: 'notification-channels',
+    idOf: (channel) => channel.id,
+    idPattern: exports.NOTIFICATION_CHANNEL_ID_PATTERN,
+    validate: (channel) => {
+        if (typeof channel.label !== 'string' || channel.label.trim() === '') {
+            throw new Error('a channel needs a non-empty label');
+        }
+        if (typeof channel.description !== 'string' || channel.description.trim() === '') {
+            throw new Error('a channel needs a non-empty description');
+        }
+        if (channel.userConfigurable !== undefined && typeof channel.userConfigurable !== 'boolean') {
+            throw new Error('userConfigurable must be a boolean when present');
+        }
+        if (channel.coveredBy !== undefined && (typeof channel.coveredBy !== 'string' || channel.coveredBy === channel.id)) {
+            throw new Error('coveredBy must name another channel id when present');
+        }
+        for (const flag of ['criticalCapable', 'broadcastDefault', 'rendersRawData']) {
+            if (channel[flag] !== undefined && typeof channel[flag] !== 'boolean') {
+                throw new Error(`${flag} must be a boolean when present`);
+            }
+        }
+        if (channel.id.length > 32) {
+            throw new Error('a channel id must be at most 32 characters');
+        }
+    },
+    describeDuplicate: (existing) => `Duplicate notification channel "${existing.id}". Channel ids are persisted ` +
+        'in preferences and delivery rows; pick a new id instead of reusing one.',
+});
+/**
+ * Registers delivery channels, all or nothing.
+ *
+ * @param channels - the channels, in the order they list.
+ * @throws RegistryError `INVALID_ID`, `INVALID_ENTRY`, `DUPLICATE_ID` or `FROZEN`.
+ *
+ * @stability stable
+ */
+function registerNotificationChannels(channels) {
+    exports.notificationChannelRegistry.registerAll(channels);
+}
+/**
+ * Registers ONE delivery channel: its id, label and whether users may toggle
+ * it. Call it from the app's manifest, before `NotificationsModule.forRoot()`
+ * composes; the transport (a `NotificationChannelSender`) registers itself
+ * with `NotificationChannelSenderRegistry` from its own module's
+ * `onModuleInit`. A channel declared with no sender is skipped quietly, so the
+ * id may land before its transport.
+ *
+ * @param channel - the channel.
+ * @throws RegistryError `INVALID_ID`, `INVALID_ENTRY`, `DUPLICATE_ID` or `FROZEN`.
+ *
+ * @example
+ * ```ts
+ * registerNotificationChannel({
+ *   id: 'example_webhook',
+ *   label: 'Webhook',
+ *   description: 'A JSON POST to the URL on the account.',
+ *   userConfigurable: true,
+ * });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability stable
+ */
+function registerNotificationChannel(channel) {
+    exports.notificationChannelRegistry.register(channel);
+}
+/**
+ * Whether `id` is a registered channel, read live.
+ *
+ * @param id - a channel id from a request or a stored row.
+ * @returns `true` when the registry holds it.
+ *
+ * @stability stable
+ */
+function isRegisteredNotificationChannel(id) {
+    return exports.notificationChannelRegistry.has(id);
+}
+/**
+ * Every registered channel, read live, in registration order.
+ *
+ * @returns a fresh array of the registry's own entries (do not mutate them).
+ *
+ * @stability stable
+ */
+function listNotificationChannels() {
+    return exports.notificationChannelRegistry.list();
+}
+/**
+ * Drops every channel another channel of the same dispatch covers
+ * ({@link NotificationChannelDef.coveredBy}, #746): with `push` and
+ * `android_app` both resolved, `android_app` goes, `push` reaches each
+ * subscription once and the delivery row says `push`, the channel that sent.
+ * The dispatcher applies it after preferences and narrowing.
+ *
+ * @param channels - the resolved channels, in dispatch order.
+ * @returns a fresh array, order preserved.
+ *
+ * @example
+ * ```ts
+ * collapseOverlappingChannels(['browser', 'push', 'android_app']); // ['browser', 'push']
+ * ```
+ *
+ * @stability experimental
+ */
+function collapseOverlappingChannels(channels) {
+    const present = new Set(channels);
+    return channels.filter((channel) => {
+        const coveredBy = exports.notificationChannelRegistry.get(channel)?.coveredBy;
+        return coveredBy === undefined || !present.has(coveredBy);
+    });
+}
+/**
+ * The registry as `GET /api/notifications/channels` serves it: one descriptor
+ * per registered channel, in registration order, with the defaults applied
+ * (PP-14.10). Clients draw channels from this and hold no list of their own.
+ *
+ * @param options - `broadcastEventKey`: the registered event a broadcast is sent as
+ *   (`admin.broadcast`); a channel it declares is `broadcastCapable`. Omitted: none is.
+ * @returns a fresh array of descriptors; `order` is the registration index.
+ *
+ * @example
+ * ```ts
+ * describeNotificationChannels().map((channel) => channel.label); // ['Email', 'Browser', 'Push']
+ * ```
+ *
+ * @stability experimental
+ */
+function describeNotificationChannels(options = {}) {
+    const broadcastChannels = options.broadcastEventKey
+        ? (event_registry_1.notificationEventRegistry.get(options.broadcastEventKey)?.channels ?? [])
+        : [];
+    return exports.notificationChannelRegistry.list().map((channel, order) => ({
+        id: channel.id,
+        label: channel.label,
+        description: channel.description,
+        userConfigurable: channel.userConfigurable !== false,
+        criticalCapable: channel.criticalCapable === true,
+        broadcastCapable: broadcastChannels.includes(channel.id),
+        broadcastDefault: channel.broadcastDefault === true,
+        order,
+    }));
+}
+/**
+ * The registered channels a critical broadcast may rely on
+ * ({@link NotificationChannelDef.criticalCapable}), in registration order.
+ *
+ * @returns the channel ids.
+ *
+ * @stability experimental
+ */
+function criticalCapableChannels() {
+    return exports.notificationChannelRegistry.list().filter((channel) => channel.criticalCapable === true).map((channel) => channel.id);
+}
+//# sourceMappingURL=channel.registry.js.map

package/dist/notifications/registry/channel.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.registry.js","sourceRoot":"","sources":["../../../src/notifications/registry/channel.registry.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,qDAAqD;AACrD,gFAAgF;AAChF,EAAE;AACF,6EAA6E;AAC7E,iFAAiF;AACjF,yEAAyE;AACzE,6EAA6E;AAC7E,+EAA+E;AAC/E,0EAA0E;AAC1E,EAAE;AACF,gFAAgF;AAChF,6CAA6C;AAC7C,+EAA+E;AAC/E,+EAA+E;AAC/E,+EAA+E;AAC/E,uDAAuD;AACvD,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAChF,iFAAiF;AACjF,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,4EAA4E;AAC5E,8EAA8E;AAC9E,gCAAgC;AAChC,EAAE;AACF,+EAA+E;AAC/E,gEAAgE;AAChE,gFAAgF;;;AAmIhF,oEAEC;AA0BD,kEAEC;AAUD,0EAEC;AASD,4DAEC;AAmBD,kEAMC;AAkBD,oEAgBC;AAUD,0DAEC;AA7PD,4CAAkD;AAClD,qDAA6D;AAC7D,+EAGqD;AAqErD;;;;GAIG;AACU,QAAA,+BAA+B,GAAW,+CAAuB,CAAC;AAE/E;;;;;;;;GAQG;AACU,QAAA,2BAA2B,GAAG,IAAA,sBAAc,EAAyB;IAChF,IAAI,EAAE,uBAAuB;IAC7B,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE;IAC7B,SAAS,EAAE,uCAA+B;IAC1C,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE;QACpB,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACjF,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,OAAO,CAAC,gBAAgB,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YAC5F,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,CAAC,SAAS,KAAK,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YACnH,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,CAAC,iBAAiB,EAAE,kBAAkB,EAAE,gBAAgB,CAAU,EAAE,CAAC;YACtF,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;gBACtE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,iCAAiC,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;QACD,IAAI,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IACD,iBAAiB,EAAE,CAAC,QAAQ,EAAE,EAAE,CAC9B,mCAAmC,QAAQ,CAAC,EAAE,+BAA+B;QAC7E,yEAAyE;CAC5E,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,SAAgB,4BAA4B,CAAC,QAA2C;IACtF,mCAA2B,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,2BAA2B,CAAC,OAA+B;IACzE,mCAA2B,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAChD,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,+BAA+B,CAAC,EAAU;IACxD,OAAO,mCAA2B,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,wBAAwB;IACtC,OAAO,mCAA2B,CAAC,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,2BAA2B,CAAmB,QAAsB;IAClF,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,QAAQ,CAAC,CAAC;IAC1C,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;QACjC,MAAM,SAAS,GAAG,mCAA2B,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC;QACtE,OAAO,SAAS,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,4BAA4B,CAC1C,UAA0C,EAAE;IAE5C,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB;QACjD,CAAC,CAAC,CAAC,0CAAyB,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,QAAQ,IAAI,EAAE,CAAC;QAC5E,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,mCAA2B,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACjE,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,KAAK,KAAK;QACpD,eAAe,EAAE,OAAO,CAAC,eAAe,KAAK,IAAI;QACjD,gBAAgB,EAAE,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACxD,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,KAAK,IAAI;QACnD,KAAK;KACN,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,uBAAuB;IACrC,OAAO,mCAA2B,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,eAAe,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC/H,CAAC"}

package/dist/notifications/registry/event.registry.d.ts

@@ -0,0 +1,154 @@
+import { type NotificationChannel } from './channel.registry';
+/**
+ * The longest event key the registry accepts.
+ *
+ * The same bound `NOTIFICATION_MAX_EVENT_KEY_LENGTH` applies to the event keys a
+ * user may store in preferences (`common/schemas/user-settings-namespaces.schema.ts`).
+ * Restated rather than imported because that schema imports this folder;
+ * `registry.spec.ts` asserts the two agree.
+  *
+  * @stability stable
+ */
+export declare const NOTIFICATION_EVENT_KEY_MAX_LENGTH = 64;
+/**
+ * What every event key must look like: `<area>.<event>`, lower snake case.
+ *
+ * @stability stable
+ */
+export declare const NOTIFICATION_EVENT_KEY_PATTERN: RegExp;
+/**
+ * One notification event, fully described for every surface that dispatches,
+ * renders, or documents it.
+  *
+  * @stability stable
+ */
+export interface NotificationEventDef {
+    /**
+     * Stable key, persisted in user preferences and in delivery records.
+     *
+     * RENAMING ONE IS A MIGRATION, not a refactor: a stored preference keyed by
+     * the old string becomes unreachable, and — under the epic's sparse
+     * absent-key contract, where absent means enabled — a user who deliberately
+     * muted an event would silently start receiving it again under its new name.
+     * Add a new key and migrate the rows; never edit a key in place.
+     */
+    key: string;
+    /** Short human label, shown as the row heading on the preferences page. */
+    label: string;
+    /**
+     * One sentence on what actually triggers this, in the user's terms. This is
+     * the only place the answer to "why did I get this?" is written down.
+     */
+    description: string;
+    /**
+     * Channels this event CAN be delivered over — a capability of the event,
+     * not a statement about which transports are implemented yet.
+     *
+     * Deliberately per-event and meaningful: `allowlist.invitation` lists email
+     * only because its recipient has no account and no open tab by definition,
+     * so a browser notification is not merely unimplemented, it is impossible.
+     * The dispatcher intersects this with the user's preferences and with the
+     * transports actually registered, so declaring a channel before its
+     * implementation lands is safe — it simply has nowhere to go until then.
+     *
+     * ---------------------------------------------------------------------------
+     * WHAT `channels` MEANS ON THE WIRE IS NOW CAPABILITY ∩ POLICY (#226)
+     * ---------------------------------------------------------------------------
+     *
+     * The array declared BELOW is still pure capability, and this is still the
+     * only place it is stated. But `GET /api/notifications/events` no longer
+     * serves it verbatim: since #226 both that endpoint and the dispatcher run it
+     * through `policyChannels` (notification-policy.ts), which drops `browser`
+     * when an operator has switched browser notifications off deployment-wide or
+     * suppressed this event specifically in system settings.
+     *
+     * So an event that declares `browser` here and shows no `browser` over the
+     * API is CONFIGURATION, not a bug in this registry — check
+     * `system_settings.value.notifications` before concluding otherwise. The one
+     * exception is a `mandatory` event, whose channels survive the policy filter
+     * because its `notifications` row is the delivery and muting a toast must not
+     * mute an audit-relevant inbox entry; for those the policy shows up as
+     * `toast: false` on the stream instead. notification-policy.ts carries the
+     * full argument.
+     *
+     * Must be non-empty: an event with no channels can never be delivered, which
+     * is a declaration bug rather than a configuration.
+     */
+    channels: NotificationChannel[];
+    /**
+     * Default when a user has expressed no preference.
+     *
+     * Reads together with the epic's sparse absent-key contract: no preference
+     * row is materialised until a user deliberately changes something, so this
+     * is what an untouched account gets.
+     */
+    defaultEnabled: boolean;
+    /**
+     * The user may NOT opt out — on ANY channel this event declares.
+     *
+     * For security-relevant events where silence is itself the risk: a role
+     * change, a new sign-in from an unknown device. #125 enforces this
+     * SERVER-SIDE, in preference resolution, and not only in the preferences UI
+     * — otherwise a crafted PATCH silences the exact alert the UI refuses to
+     * hide, which is the whole attack this flag exists to close.
+     *
+     * ALL-OR-NOTHING, BY DESIGN: mandatory is not "at least one channel must
+     * stay on". Per-channel opt-out on a mandatory event reopens the hole it
+     * closes — a user who drops email and keeps browser is unreachable the
+     * moment no tab is open, and the alert is lost exactly when it matters. So
+     * the resolver ignores stored preferences for a mandatory event entirely and
+     * every declared channel stays enabled. The UI (#126) renders the controls
+     * as disabled WITH the reason rather than hiding them, per epic #109's
+     * success criterion 5 — a dead toggle teaches nothing.
+     *
+     * Absent is the normal case and means "the user is in charge".
+     *
+     * Invariant: a mandatory event must also be `defaultEnabled: true`.
+     * `mandatory` with `defaultEnabled: false` is self-contradictory — it
+     * asserts the user cannot turn off something that is off.
+     */
+    mandatory?: boolean;
+}
+/**
+ * Rejects an event that could never be delivered or that contradicts itself.
+ * Exported so `registerNotification` can check an event before it registers
+ * anything (it is atomic across the event and its template bindings).
+ *
+ * @throws Error naming the problem; the registry wraps it as `INVALID_ENTRY`.
+  *
+  * @stability stable
+ */
+export declare function assertValidNotificationEvent(event: NotificationEventDef): void;
+/**
+ * Every notification event, in registration order. Filled by
+ * `notification.manifest.ts`; frozen once the application has bootstrapped.
+  *
+  * @stability stable
+ */
+export declare const notificationEventRegistry: import("../../core/index").Registry<NotificationEventDef>;
+/**
+ * Registers ONE event with no template binding: the event's `label` and
+ * `description` render its bell row and push toast, and an event that
+ * declares `email` needs {@link registerEmailNotificationTemplate} (or the
+ * combined `registerNotification`) before it can be emailed. Call it from the
+ * app's manifest, before `NotificationsModule.forRoot()` composes.
+ *
+ * @param event - the event.
+ * @throws RegistryError `INVALID_ID`, `INVALID_ENTRY`, `DUPLICATE_ID` or `FROZEN`.
+ *
+ * @example
+ * ```ts
+ * registerNotificationEvent({
+ *   key: 'billing.invoice_ready',
+ *   label: 'Invoice ready',
+ *   description: 'Sent when a new invoice is available to download.',
+ *   channels: ['browser'],
+ *   defaultEnabled: true,
+ * });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability stable
+ */
+export declare function registerNotificationEvent(event: NotificationEventDef): void;
+//# sourceMappingURL=event.registry.d.ts.map

package/dist/notifications/registry/event.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.registry.d.ts","sourceRoot":"","sources":["../../../src/notifications/registry/event.registry.ts"],"names":[],"mappings":"AA2BA,OAAO,EAA+B,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE3F;;;;;;;;;GASG;AACH,eAAO,MAAM,iCAAiC,KAAK,CAAC;AAEpD;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,QAAuC,CAAC;AAGnF;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;OAQG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAEhC;;;;;;OAMG;IACH,cAAc,EAAE,OAAO,CAAC;IAExB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CA8B9E;AAED;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,2DAQpC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAE3E"}

package/dist/notifications/registry/event.registry.js

@@ -0,0 +1,129 @@
+"use strict";
+// =============================================================================
+// Notification event registry (issue #678, PP-1.6; the definition dates from #121)
+// =============================================================================
+//
+// Every event this application can raise, in declaration order. Until #678
+// this was the closed array `NOTIFICATION_EVENTS` in notification-events.ts;
+// now each platform module declares its own events next to the code that
+// raises them (`auth/auth.notifications.ts`, `users/users.notifications.ts`,
+// ...), the app declares its own in `app-registrations/notifications.ts`, and
+// `notification.manifest.ts` registers them all, platform first. The old
+// exports in notification-events.ts are views over this registry.
+//
+// ORDER IS MEANINGFUL. `GET /api/notifications/events` lists events in
+// registration order and the preferences matrix renders them in that order, so
+// the manifest registers the platform events in exactly the order the old array
+// held them, and app events after them.
+//
+// THE INVARIANTS `notification-events.spec.ts` USED TO CHECK AFTER THE FACT ARE
+// NOW CHECKED ON REGISTRATION: a malformed key, an empty label or description,
+// an empty or repeated channel list, an unregistered channel, and `mandatory`
+// without `defaultEnabled` all fail at import time with a `RegistryError` that
+// names the key. A duplicate key fails with `DUPLICATE_ID`.
+//
+// FRAMEWORK-FREE: imports only the registry primitive and the channel registry.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.notificationEventRegistry = exports.NOTIFICATION_EVENT_KEY_PATTERN = exports.NOTIFICATION_EVENT_KEY_MAX_LENGTH = void 0;
+exports.assertValidNotificationEvent = assertValidNotificationEvent;
+exports.registerNotificationEvent = registerNotificationEvent;
+const index_1 = require("../../core/index");
+const channel_registry_1 = require("./channel.registry");
+/**
+ * The longest event key the registry accepts.
+ *
+ * The same bound `NOTIFICATION_MAX_EVENT_KEY_LENGTH` applies to the event keys a
+ * user may store in preferences (`common/schemas/user-settings-namespaces.schema.ts`).
+ * Restated rather than imported because that schema imports this folder;
+ * `registry.spec.ts` asserts the two agree.
+  *
+  * @stability stable
+ */
+exports.NOTIFICATION_EVENT_KEY_MAX_LENGTH = 64;
+/**
+ * What every event key must look like: `<area>.<event>`, lower snake case.
+ *
+ * @stability stable
+ */
+exports.NOTIFICATION_EVENT_KEY_PATTERN = /^[a-z][a-z0-9_]*\.[a-z][a-z0-9_]*$/;
+/**
+ * Rejects an event that could never be delivered or that contradicts itself.
+ * Exported so `registerNotification` can check an event before it registers
+ * anything (it is atomic across the event and its template bindings).
+ *
+ * @throws Error naming the problem; the registry wraps it as `INVALID_ENTRY`.
+  *
+  * @stability stable
+ */
+function assertValidNotificationEvent(event) {
+    if (event.key.length > exports.NOTIFICATION_EVENT_KEY_MAX_LENGTH) {
+        throw new Error(`an event key must be at most ${exports.NOTIFICATION_EVENT_KEY_MAX_LENGTH} characters`);
+    }
+    if (typeof event.label !== 'string' || event.label.trim() === '') {
+        throw new Error('an event needs a non-empty label');
+    }
+    if (typeof event.description !== 'string' || event.description.trim() === '') {
+        throw new Error('an event needs a non-empty description');
+    }
+    if (!Array.isArray(event.channels) || event.channels.length === 0) {
+        throw new Error('an event must declare at least one channel; one with none can never be delivered');
+    }
+    if (new Set(event.channels).size !== event.channels.length) {
+        throw new Error(`an event must not repeat a channel (${event.channels.join(', ')})`);
+    }
+    for (const channel of event.channels) {
+        if (!channel_registry_1.notificationChannelRegistry.has(channel)) {
+            throw new Error(`channel "${channel}" is not a registered notification channel ` +
+                `(known: ${channel_registry_1.notificationChannelRegistry.ids().join(', ') || 'none'})`);
+        }
+    }
+    if (typeof event.defaultEnabled !== 'boolean') {
+        throw new Error('defaultEnabled must be a boolean');
+    }
+    if (event.mandatory === true && event.defaultEnabled !== true) {
+        throw new Error('a mandatory event must also be defaultEnabled: true');
+    }
+}
+/**
+ * Every notification event, in registration order. Filled by
+ * `notification.manifest.ts`; frozen once the application has bootstrapped.
+  *
+  * @stability stable
+ */
+exports.notificationEventRegistry = (0, index_1.defineRegistry)({
+    name: 'notification-events',
+    idOf: (event) => event.key,
+    idPattern: exports.NOTIFICATION_EVENT_KEY_PATTERN,
+    validate: (event) => assertValidNotificationEvent(event),
+    describeDuplicate: (existing) => `Duplicate notification event "${existing.key}". An event key is persisted in ` +
+        'preferences and delivery rows: never rename or reuse one, add a new key.',
+});
+/**
+ * Registers ONE event with no template binding: the event's `label` and
+ * `description` render its bell row and push toast, and an event that
+ * declares `email` needs {@link registerEmailNotificationTemplate} (or the
+ * combined `registerNotification`) before it can be emailed. Call it from the
+ * app's manifest, before `NotificationsModule.forRoot()` composes.
+ *
+ * @param event - the event.
+ * @throws RegistryError `INVALID_ID`, `INVALID_ENTRY`, `DUPLICATE_ID` or `FROZEN`.
+ *
+ * @example
+ * ```ts
+ * registerNotificationEvent({
+ *   key: 'billing.invoice_ready',
+ *   label: 'Invoice ready',
+ *   description: 'Sent when a new invoice is available to download.',
+ *   channels: ['browser'],
+ *   defaultEnabled: true,
+ * });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability stable
+ */
+function registerNotificationEvent(event) {
+    exports.notificationEventRegistry.register(event);
+}
+//# sourceMappingURL=event.registry.js.map

package/dist/notifications/registry/event.registry.js.map

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

package/dist/notifications/registry/index.d.ts

@@ -0,0 +1,12 @@
+export { NOTIFICATION_CHANNEL_ID_PATTERN, collapseOverlappingChannels, criticalCapableChannels, describeNotificationChannels, isRegisteredNotificationChannel, listNotificationChannels, notificationChannelRegistry, registerNotificationChannel, registerNotificationChannels, } from './channel.registry';
+export type { NotificationChannel, NotificationChannelDef, } from './channel.registry';
+export { channelTemplateRegistry, findChannelTemplate, registerChannelTemplate, renderChannelPayload, } from './channel-template.registry';
+export type { ChannelPayload, ChannelTemplateBinding, ChannelTemplateContext, ChannelTemplateRender, } from './channel-template.registry';
+export { NOTIFICATION_EVENT_KEY_MAX_LENGTH, NOTIFICATION_EVENT_KEY_PATTERN, notificationEventRegistry, registerNotificationEvent, } from './event.registry';
+export type { NotificationEventDef } from './event.registry';
+export { EMAIL_TEMPLATE_NAME_PATTERN, emailTemplateRegistry, registerEmailTemplates, } from '../../email/index';
+export type { EmailTemplateEntry } from '../../email/index';
+export { eventBrowserTemplateRegistry, eventEmailTemplateRegistry, registerBrowserNotificationTemplate, registerEmailNotificationTemplate, registerNotification, registerNotifications, } from './bindings.registry';
+export { ANDROID_APP_NOTIFICATION_CHANNEL, PLATFORM_NOTIFICATION_CHANNELS, registerAndroidAppNotificationChannel, registerPlatformNotificationChannels, } from './platform-channels';
+export type { EventBrowserTemplateBinding, EventEmailTemplateBinding, NotificationRegistration, } from './bindings.registry';
+//# sourceMappingURL=index.d.ts.map

package/dist/notifications/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/notifications/registry/index.ts"],"names":[],"mappings":"AAoBA,OAAO,EACL,+BAA+B,EAC/B,2BAA2B,EAC3B,uBAAuB,EACvB,4BAA4B,EAC5B,+BAA+B,EAC/B,wBAAwB,EACxB,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,iCAAiC,EACjC,8BAA8B,EAC9B,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAI7D,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,EAC1B,mCAAmC,EACnC,iCAAiC,EACjC,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,gCAAgC,EAChC,8BAA8B,EAC9B,qCAAqC,EACrC,oCAAoC,GACrC,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC"}

package/dist/notifications/registry/index.js

@@ -0,0 +1,61 @@
+"use strict";
+// =============================================================================
+// Notification registries — public surface (issue #678, PP-1.6)
+// =============================================================================
+//
+// Since #738 the registries live in `@marinoscar/platform-api/notifications`
+// and importing this folder fills NOTHING: which channels, templates and
+// events exist, and in which order, is the app's decision, made in its own
+// manifest (the reference app: `apps/api/src/platform/notifications/
+// notification.manifest.ts`), which the app imports before it composes
+// `NotificationsModule.forRoot()`.
+//
+// FRAMEWORK-FREE, like the registries themselves: DTOs built at module
+// evaluation time, the seed and `npm run openapi:dump` read these. The one Nest
+// piece of this folder, `NotificationChannelSenderRegistry`, is therefore NOT
+// re-exported here; import it from './channel-sender.registry' (or from the
+// notifications barrel).
+//
+// Recipe and API: ./README.md.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPlatformNotificationChannels = exports.registerAndroidAppNotificationChannel = exports.PLATFORM_NOTIFICATION_CHANNELS = exports.ANDROID_APP_NOTIFICATION_CHANNEL = exports.registerNotifications = exports.registerNotification = exports.registerEmailNotificationTemplate = exports.registerBrowserNotificationTemplate = exports.eventEmailTemplateRegistry = exports.eventBrowserTemplateRegistry = exports.registerEmailTemplates = exports.emailTemplateRegistry = exports.EMAIL_TEMPLATE_NAME_PATTERN = exports.registerNotificationEvent = exports.notificationEventRegistry = exports.NOTIFICATION_EVENT_KEY_PATTERN = exports.NOTIFICATION_EVENT_KEY_MAX_LENGTH = exports.renderChannelPayload = exports.registerChannelTemplate = exports.findChannelTemplate = exports.channelTemplateRegistry = exports.registerNotificationChannels = exports.registerNotificationChannel = exports.notificationChannelRegistry = exports.listNotificationChannels = exports.isRegisteredNotificationChannel = exports.describeNotificationChannels = exports.criticalCapableChannels = exports.collapseOverlappingChannels = exports.NOTIFICATION_CHANNEL_ID_PATTERN = void 0;
+var channel_registry_1 = require("./channel.registry");
+Object.defineProperty(exports, "NOTIFICATION_CHANNEL_ID_PATTERN", { enumerable: true, get: function () { return channel_registry_1.NOTIFICATION_CHANNEL_ID_PATTERN; } });
+Object.defineProperty(exports, "collapseOverlappingChannels", { enumerable: true, get: function () { return channel_registry_1.collapseOverlappingChannels; } });
+Object.defineProperty(exports, "criticalCapableChannels", { enumerable: true, get: function () { return channel_registry_1.criticalCapableChannels; } });
+Object.defineProperty(exports, "describeNotificationChannels", { enumerable: true, get: function () { return channel_registry_1.describeNotificationChannels; } });
+Object.defineProperty(exports, "isRegisteredNotificationChannel", { enumerable: true, get: function () { return channel_registry_1.isRegisteredNotificationChannel; } });
+Object.defineProperty(exports, "listNotificationChannels", { enumerable: true, get: function () { return channel_registry_1.listNotificationChannels; } });
+Object.defineProperty(exports, "notificationChannelRegistry", { enumerable: true, get: function () { return channel_registry_1.notificationChannelRegistry; } });
+Object.defineProperty(exports, "registerNotificationChannel", { enumerable: true, get: function () { return channel_registry_1.registerNotificationChannel; } });
+Object.defineProperty(exports, "registerNotificationChannels", { enumerable: true, get: function () { return channel_registry_1.registerNotificationChannels; } });
+var channel_template_registry_1 = require("./channel-template.registry");
+Object.defineProperty(exports, "channelTemplateRegistry", { enumerable: true, get: function () { return channel_template_registry_1.channelTemplateRegistry; } });
+Object.defineProperty(exports, "findChannelTemplate", { enumerable: true, get: function () { return channel_template_registry_1.findChannelTemplate; } });
+Object.defineProperty(exports, "registerChannelTemplate", { enumerable: true, get: function () { return channel_template_registry_1.registerChannelTemplate; } });
+Object.defineProperty(exports, "renderChannelPayload", { enumerable: true, get: function () { return channel_template_registry_1.renderChannelPayload; } });
+var event_registry_1 = require("./event.registry");
+Object.defineProperty(exports, "NOTIFICATION_EVENT_KEY_MAX_LENGTH", { enumerable: true, get: function () { return event_registry_1.NOTIFICATION_EVENT_KEY_MAX_LENGTH; } });
+Object.defineProperty(exports, "NOTIFICATION_EVENT_KEY_PATTERN", { enumerable: true, get: function () { return event_registry_1.NOTIFICATION_EVENT_KEY_PATTERN; } });
+Object.defineProperty(exports, "notificationEventRegistry", { enumerable: true, get: function () { return event_registry_1.notificationEventRegistry; } });
+Object.defineProperty(exports, "registerNotificationEvent", { enumerable: true, get: function () { return event_registry_1.registerNotificationEvent; } });
+// The email template registry moved into @marinoscar/platform-api/email
+// (#737); re-exported so the notification registries stay one import.
+var index_1 = require("../../email/index");
+Object.defineProperty(exports, "EMAIL_TEMPLATE_NAME_PATTERN", { enumerable: true, get: function () { return index_1.EMAIL_TEMPLATE_NAME_PATTERN; } });
+Object.defineProperty(exports, "emailTemplateRegistry", { enumerable: true, get: function () { return index_1.emailTemplateRegistry; } });
+Object.defineProperty(exports, "registerEmailTemplates", { enumerable: true, get: function () { return index_1.registerEmailTemplates; } });
+var bindings_registry_1 = require("./bindings.registry");
+Object.defineProperty(exports, "eventBrowserTemplateRegistry", { enumerable: true, get: function () { return bindings_registry_1.eventBrowserTemplateRegistry; } });
+Object.defineProperty(exports, "eventEmailTemplateRegistry", { enumerable: true, get: function () { return bindings_registry_1.eventEmailTemplateRegistry; } });
+Object.defineProperty(exports, "registerBrowserNotificationTemplate", { enumerable: true, get: function () { return bindings_registry_1.registerBrowserNotificationTemplate; } });
+Object.defineProperty(exports, "registerEmailNotificationTemplate", { enumerable: true, get: function () { return bindings_registry_1.registerEmailNotificationTemplate; } });
+Object.defineProperty(exports, "registerNotification", { enumerable: true, get: function () { return bindings_registry_1.registerNotification; } });
+Object.defineProperty(exports, "registerNotifications", { enumerable: true, get: function () { return bindings_registry_1.registerNotifications; } });
+var platform_channels_1 = require("./platform-channels");
+Object.defineProperty(exports, "ANDROID_APP_NOTIFICATION_CHANNEL", { enumerable: true, get: function () { return platform_channels_1.ANDROID_APP_NOTIFICATION_CHANNEL; } });
+Object.defineProperty(exports, "PLATFORM_NOTIFICATION_CHANNELS", { enumerable: true, get: function () { return platform_channels_1.PLATFORM_NOTIFICATION_CHANNELS; } });
+Object.defineProperty(exports, "registerAndroidAppNotificationChannel", { enumerable: true, get: function () { return platform_channels_1.registerAndroidAppNotificationChannel; } });
+Object.defineProperty(exports, "registerPlatformNotificationChannels", { enumerable: true, get: function () { return platform_channels_1.registerPlatformNotificationChannels; } });
+//# sourceMappingURL=index.js.map

package/dist/notifications/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/notifications/registry/index.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,gEAAgE;AAChE,gFAAgF;AAChF,EAAE;AACF,6EAA6E;AAC7E,yEAAyE;AACzE,2EAA2E;AAC3E,qEAAqE;AACrE,uEAAuE;AACvE,mCAAmC;AACnC,EAAE;AACF,uEAAuE;AACvE,gFAAgF;AAChF,8EAA8E;AAC9E,4EAA4E;AAC5E,yBAAyB;AACzB,EAAE;AACF,+BAA+B;AAC/B,gFAAgF;;;AAEhF,uDAU4B;AAT1B,mIAAA,+BAA+B,OAAA;AAC/B,+HAAA,2BAA2B,OAAA;AAC3B,2HAAA,uBAAuB,OAAA;AACvB,gIAAA,4BAA4B,OAAA;AAC5B,mIAAA,+BAA+B,OAAA;AAC/B,4HAAA,wBAAwB,OAAA;AACxB,+HAAA,2BAA2B,OAAA;AAC3B,+HAAA,2BAA2B,OAAA;AAC3B,gIAAA,4BAA4B,OAAA;AAO9B,yEAKqC;AAJnC,oIAAA,uBAAuB,OAAA;AACvB,gIAAA,mBAAmB,OAAA;AACnB,oIAAA,uBAAuB,OAAA;AACvB,iIAAA,oBAAoB,OAAA;AAStB,mDAK0B;AAJxB,mIAAA,iCAAiC,OAAA;AACjC,gIAAA,8BAA8B,OAAA;AAC9B,2HAAA,yBAAyB,OAAA;AACzB,2HAAA,yBAAyB,OAAA;AAI3B,wEAAwE;AACxE,sEAAsE;AACtE,2CAI2B;AAHzB,oHAAA,2BAA2B,OAAA;AAC3B,8GAAA,qBAAqB,OAAA;AACrB,+GAAA,sBAAsB,OAAA;AAIxB,yDAO6B;AAN3B,iIAAA,4BAA4B,OAAA;AAC5B,+HAAA,0BAA0B,OAAA;AAC1B,wIAAA,mCAAmC,OAAA;AACnC,sIAAA,iCAAiC,OAAA;AACjC,yHAAA,oBAAoB,OAAA;AACpB,0HAAA,qBAAqB,OAAA;AAGvB,yDAK6B;AAJ3B,qIAAA,gCAAgC,OAAA;AAChC,mIAAA,8BAA8B,OAAA;AAC9B,0IAAA,qCAAqC,OAAA;AACrC,yIAAA,oCAAoC,OAAA"}