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

package/dist/notifications/testing/conformance.js

@@ -0,0 +1,292 @@
+"use strict";
+// =============================================================================
+// The notifications slice's conformance suite (issue #738, PP-8.5)
+// =============================================================================
+//
+// The slice's invariants, checked against the APP that consumes the package
+// (spec: "Conformance suites travel with packages"). Importing
+// `@marinoscar/platform-api/notifications/testing` registers the
+// `notifications` suite with `runPlatformConformance()`.
+//
+//   1. platform: the platform's channels and its own notifications
+//      (broadcasts, `jobs.job_failed`, `nodes.node_offline`) are registered.
+//   2. templates: every event that declares `email` has an email template
+//      bound, and the template is registered (an unbound one is a recorded
+//      delivery failure on every send).
+//   3. after-commit: no `notify*()` call sits lexically inside a
+//      `$transaction(...)` callback in the app's sources (CLAUDE.md:
+//      "notify() runs after the triggering write commits, outside any
+//      $transaction"). A static scan; the unit tests prove the runtime half.
+//   4. no-secret: neither the stored Web Push settings nor its admin view
+//      declares a secret-bearing field (the VAPID private key lives in the
+//      credential store only).
+//
+// Run it after the app's notification manifest has registered everything.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.notificationsConformanceSuite = void 0;
+exports.checkPlatformNotifications = checkPlatformNotifications;
+exports.checkEmailBindings = checkEmailBindings;
+exports.checkChannelTemplates = checkChannelTemplates;
+exports.checkNotifyAfterCommit = checkNotifyAfterCommit;
+exports.checkPushSchemas = checkPushSchemas;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const credentials_1 = require("@marinoscar/platform-contract/credentials");
+const notifications_1 = require("@marinoscar/platform-contract/notifications");
+const index_1 = require("../../testing/index");
+const index_2 = require("../../email/index");
+const broadcasts_notifications_1 = require("../broadcasts/broadcasts.notifications");
+const nodes_notifications_1 = require("../ops/nodes.notifications");
+const ops_notifications_1 = require("../ops/ops.notifications");
+const bindings_registry_1 = require("../registry/bindings.registry");
+const channel_template_registry_1 = require("../registry/channel-template.registry");
+const channel_registry_1 = require("../registry/channel.registry");
+const event_registry_1 = require("../registry/event.registry");
+const platform_channels_1 = require("../registry/platform-channels");
+const FILE_PLATFORM = 'notifications-platform';
+const FILE_TEMPLATES = 'notifications-templates';
+const FILE_SCHEMAS = 'notifications-schemas';
+const FILE_CHANNEL_TEMPLATES = 'notifications-channel-templates';
+/** A dispatcher call: `notify(`, `notifyNow(`, `notifyAddress(`, `notifyPermissionHolders(`, `notifyPermissionHoldersNow(`. */
+const NOTIFY_CALL = /\.notify(?:Now|Address|PermissionHolders|PermissionHoldersNow)?\(/;
+/**
+ * Check 1: the platform's channels and notifications are registered.
+ *
+ * @returns one finding per missing entry.
+ *
+ * @stability experimental
+ */
+function checkPlatformNotifications() {
+    const findings = [];
+    for (const channel of platform_channels_1.PLATFORM_NOTIFICATION_CHANNELS) {
+        if (!channel_registry_1.notificationChannelRegistry.has(channel.id)) {
+            findings.push({ file: FILE_PLATFORM, message: `platform channel "${channel.id}" is not registered (call registerPlatformNotificationChannels())` });
+        }
+    }
+    for (const registration of [...broadcasts_notifications_1.BROADCASTS_NOTIFICATIONS, ...ops_notifications_1.OPS_NOTIFICATIONS, ...nodes_notifications_1.NODES_NOTIFICATIONS]) {
+        if (!event_registry_1.notificationEventRegistry.has(registration.event.key)) {
+            findings.push({ file: FILE_PLATFORM, message: `platform notification "${registration.event.key}" is not registered (register BROADCASTS_NOTIFICATIONS, OPS_NOTIFICATIONS and NODES_NOTIFICATIONS)` });
+        }
+    }
+    return findings;
+}
+/**
+ * Check 2: every event that declares `email` has a registered email template.
+ *
+ * @returns one finding per unbound or dangling binding.
+ *
+ * @stability experimental
+ */
+function checkEmailBindings() {
+    const findings = [];
+    for (const event of event_registry_1.notificationEventRegistry.list()) {
+        if (!event.channels.includes('email'))
+            continue;
+        const binding = bindings_registry_1.eventEmailTemplateRegistry.get(event.key);
+        if (!binding) {
+            findings.push({ file: FILE_TEMPLATES, message: `event "${event.key}" declares email but no email template is bound (registerNotification({ emailTemplate }))` });
+        }
+        else if (!index_2.emailTemplateRegistry.has(binding.template)) {
+            findings.push({ file: FILE_TEMPLATES, message: `event "${event.key}" is bound to email template "${binding.template}", which is not registered` });
+        }
+    }
+    return findings;
+}
+/**
+ * Check 2b (PP-14.10): every event bound for an app's channel has a template for
+ * it, unless the channel declares it renders from the raw event data
+ * (`rendersRawData: true`). The platform's own channels have template
+ * registries of their own (email, browser, push) and are not checked here.
+ *
+ * @returns one finding per event with no template.
+ *
+ * @stability experimental
+ */
+function checkChannelTemplates() {
+    const builtIn = new Set([...notifications_1.PLATFORM_NOTIFICATION_CHANNEL_IDS, notifications_1.ANDROID_APP_NOTIFICATION_CHANNEL_ID]);
+    const findings = [];
+    for (const channel of channel_registry_1.notificationChannelRegistry.list()) {
+        if (builtIn.has(channel.id) || channel.rendersRawData === true)
+            continue;
+        for (const event of event_registry_1.notificationEventRegistry.list()) {
+            if (!event.channels.includes(channel.id))
+                continue;
+            if (!channel_template_registry_1.channelTemplateRegistry.has(`${channel.id}:${event.key}`)) {
+                findings.push({
+                    file: FILE_CHANNEL_TEMPLATES,
+                    message: `event "${event.key}" is bound for channel "${channel.id}" but has no template for it ` +
+                        '(registerChannelTemplate, or declare the channel with rendersRawData: true)',
+                });
+            }
+        }
+    }
+    return findings;
+}
+/** Every `.ts` file under `dir`, excluding tests. */
+function sourceFiles(dir) {
+    return (0, node_fs_1.readdirSync)(dir).flatMap((entry) => {
+        const full = (0, node_path_1.join)(dir, entry);
+        if ((0, node_fs_1.statSync)(full).isDirectory())
+            return entry === 'node_modules' ? [] : sourceFiles(full);
+        if (!entry.endsWith('.ts') || entry.endsWith('.spec.ts') || entry.endsWith('.d.ts'))
+            return [];
+        return [full];
+    });
+}
+/** Strips `//` and block comments, keeping line breaks so line numbers survive. */
+function stripComments(source) {
+    return source
+        .replace(/\/\*[\s\S]*?\*\//g, (block) => block.replace(/[^\n]/g, ' '))
+        .replace(/(^|[^:'"`\\])\/\/[^\n]*/g, (_match, lead) => lead);
+}
+/**
+ * The argument spans of every `$transaction(` call in `source`,
+ * parenthesis-matched (a regex would stop at the first `)`).
+ */
+function transactionSpans(source) {
+    const spans = [];
+    let index = source.indexOf('$transaction(');
+    while (index !== -1) {
+        const open = index + '$transaction'.length;
+        let depth = 0;
+        let end = open;
+        for (; end < source.length; end += 1) {
+            if (source[end] === '(')
+                depth += 1;
+            else if (source[end] === ')') {
+                depth -= 1;
+                if (depth === 0)
+                    break;
+            }
+        }
+        spans.push({ start: open, end });
+        index = source.indexOf('$transaction(', end);
+    }
+    return spans;
+}
+/**
+ * Check 3: no dispatcher call inside a `$transaction(...)` callback.
+ *
+ * @param context - the app's source roots.
+ * @param allowlist - relative paths to skip.
+ * @returns one finding per offending call, and how many files were scanned.
+ *
+ * @stability experimental
+ */
+function checkNotifyAfterCommit(context, allowlist = []) {
+    const findings = [];
+    const files = [];
+    const skip = new Set(allowlist);
+    for (const root of context.sourceRoots) {
+        for (const file of sourceFiles(root)) {
+            const rel = (0, node_path_1.relative)(root, file).split('\\').join('/');
+            if (skip.has(rel))
+                continue;
+            files.push(rel);
+            const source = stripComments((0, node_fs_1.readFileSync)(file, 'utf8'));
+            for (const span of transactionSpans(source)) {
+                const body = source.slice(span.start, span.end);
+                const match = NOTIFY_CALL.exec(body);
+                if (match) {
+                    const line = source.slice(0, span.start + match.index).split('\n').length;
+                    findings.push({
+                        file: `${rel}:${line}`,
+                        message: `${match[0]} is called inside a $transaction callback; call it after the transaction commits`,
+                    });
+                }
+            }
+        }
+    }
+    return { findings, files };
+}
+/**
+ * Check 4: neither the stored Web Push settings nor its admin view declares a
+ * secret-bearing field.
+ *
+ * @returns one finding per offending field.
+ *
+ * @stability experimental
+ */
+function checkPushSchemas() {
+    const forbidden = new Set([...credentials_1.SECRET_BEARING_KEYS, 'privateKey', 'vapidPrivateKey']);
+    const findings = [];
+    for (const [name, schema] of Object.entries({ pushConfigSchema: notifications_1.pushConfigSchema, pushConfigResponseSchema: notifications_1.pushConfigResponseSchema })) {
+        for (const key of Object.keys(schema.shape)) {
+            if (forbidden.has(key))
+                findings.push({ file: FILE_SCHEMAS, message: `${name} declares "${key}": the VAPID private key lives in the credential store only` });
+        }
+    }
+    return findings;
+}
+/**
+ * The `notifications` conformance suite. Registered when
+ * `@marinoscar/platform-api/notifications/testing` is imported.
+ *
+ * @example
+ * ```ts
+ * import '@marinoscar/platform-api/notifications/testing';
+ * runPlatformConformance({ sourceRoots: [API_SOURCE_ROOT], suites: { notifications: {} } });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+exports.notificationsConformanceSuite = {
+    id: 'notifications',
+    title: 'the notifications slice keeps its invariants',
+    description: 'The platform channels and notifications are registered, every email-capable event has a template, every event bound for an app channel has a template (or the channel renders raw data), no notify() runs inside a transaction, and no Web Push shape can carry the private key.',
+    check(context, options) {
+        const afterCommit = checkNotifyAfterCommit(context, options.afterCommitAllowlist);
+        const findings = [...checkPlatformNotifications(), ...checkEmailBindings(), ...checkChannelTemplates(), ...afterCommit.findings, ...checkPushSchemas()];
+        return {
+            scanned: {
+                channels: channel_registry_1.notificationChannelRegistry.ids().length,
+                events: event_registry_1.notificationEventRegistry.ids().length,
+                files: afterCommit.files.length,
+                schemas: 2,
+            },
+            scannedFiles: { files: afterCommit.files },
+            findings,
+        };
+    },
+    cases() {
+        const only = (prefix) => (finding) => finding.file === prefix;
+        return [
+            {
+                name: 'platform: the platform channels and notifications are registered',
+                run: (report, expect) => {
+                    expect(report.findings.filter(only(FILE_PLATFORM))).toEqual([]);
+                },
+            },
+            {
+                name: 'templates: every event that declares email has a registered template',
+                run: (report, expect) => {
+                    expect(report.findings.filter(only(FILE_TEMPLATES))).toEqual([]);
+                },
+            },
+            {
+                name: 'channel-templates: every event bound for an app channel has a template or the channel renders raw data',
+                run: (report, expect) => {
+                    expect(report.findings.filter(only(FILE_CHANNEL_TEMPLATES))).toEqual([]);
+                },
+            },
+            {
+                name: 'after-commit: no notify() call runs inside a $transaction callback',
+                run: (report, expect) => {
+                    expect(report.scanned.files).toBeGreaterThanOrEqual(1);
+                    expect(report.findings.filter((finding) => finding.message.includes('$transaction'))).toEqual([]);
+                },
+            },
+            {
+                name: 'no-secret: the Web Push settings and their admin view carry no secret-bearing field',
+                run: (report, expect) => {
+                    expect(report.findings.filter(only(FILE_SCHEMAS))).toEqual([]);
+                },
+            },
+        ];
+    },
+};
+if (!index_1.conformanceSuites.has(exports.notificationsConformanceSuite.id))
+    index_1.conformanceSuites.register(exports.notificationsConformanceSuite);
+//# sourceMappingURL=conformance.js.map

package/dist/notifications/testing/conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.js","sourceRoot":"","sources":["../../../src/notifications/testing/conformance.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,mEAAmE;AACnE,gFAAgF;AAChF,EAAE;AACF,4EAA4E;AAC5E,+DAA+D;AAC/D,iEAAiE;AACjE,yDAAyD;AACzD,EAAE;AACF,mEAAmE;AACnE,6EAA6E;AAC7E,0EAA0E;AAC1E,2EAA2E;AAC3E,wCAAwC;AACxC,iEAAiE;AACjE,qEAAqE;AACrE,sEAAsE;AACtE,6EAA6E;AAC7E,0EAA0E;AAC1E,2EAA2E;AAC3E,+BAA+B;AAC/B,EAAE;AACF,0EAA0E;AAC1E,gFAAgF;;;AA8DhF,gEAaC;AASD,gDAYC;AAYD,sDAkBC;AAgED,wDA2BC;AAUD,4CASC;AA1OD,qCAA8D;AAC9D,yCAA2C;AAE3C,2EAAgF;AAChF,+EAKqD;AAErD,+CAAwD;AAExD,6CAA0D;AAC1D,qFAAkF;AAClF,oEAAiE;AACjE,gEAA6D;AAC7D,qEAA2E;AAC3E,qFAAgF;AAChF,mEAA2E;AAC3E,+DAAuE;AACvE,qEAA+E;AAwB/E,MAAM,aAAa,GAAG,wBAAwB,CAAC;AAC/C,MAAM,cAAc,GAAG,yBAAyB,CAAC;AACjD,MAAM,YAAY,GAAG,uBAAuB,CAAC;AAC7C,MAAM,sBAAsB,GAAG,iCAAiC,CAAC;AAEjE,+HAA+H;AAC/H,MAAM,WAAW,GAAG,mEAAmE,CAAC;AAExF;;;;;;GAMG;AACH,SAAgB,0BAA0B;IACxC,MAAM,QAAQ,GAAyB,EAAE,CAAC;IAC1C,KAAK,MAAM,OAAO,IAAI,kDAA8B,EAAE,CAAC;QACrD,IAAI,CAAC,8CAA2B,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,qBAAqB,OAAO,CAAC,EAAE,mEAAmE,EAAE,CAAC,CAAC;QACtJ,CAAC;IACH,CAAC;IACD,KAAK,MAAM,YAAY,IAAI,CAAC,GAAG,mDAAwB,EAAE,GAAG,qCAAiB,EAAE,GAAG,yCAAmB,CAAC,EAAE,CAAC;QACvG,IAAI,CAAC,0CAAyB,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,0BAA0B,YAAY,CAAC,KAAK,CAAC,GAAG,oGAAoG,EAAE,CAAC,CAAC;QACxM,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,kBAAkB;IAChC,MAAM,QAAQ,GAAyB,EAAE,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,0CAAyB,CAAC,IAAI,EAAE,EAAE,CAAC;QACrD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,SAAS;QAChD,MAAM,OAAO,GAAG,8CAA0B,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,KAAK,CAAC,GAAG,2FAA2F,EAAE,CAAC,CAAC;QACnK,CAAC;aAAM,IAAI,CAAC,6BAAqB,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,KAAK,CAAC,GAAG,iCAAiC,OAAO,CAAC,QAAQ,4BAA4B,EAAE,CAAC,CAAC;QACrJ,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,qBAAqB;IACnC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,CAAC,GAAG,iDAAiC,EAAE,mDAAmC,CAAC,CAAC,CAAC;IAC7G,MAAM,QAAQ,GAAyB,EAAE,CAAC;IAC1C,KAAK,MAAM,OAAO,IAAI,8CAA2B,CAAC,IAAI,EAAE,EAAE,CAAC;QACzD,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,cAAc,KAAK,IAAI;YAAE,SAAS;QACzE,KAAK,MAAM,KAAK,IAAI,0CAAyB,CAAC,IAAI,EAAE,EAAE,CAAC;YACrD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAAE,SAAS;YACnD,IAAI,CAAC,mDAAuB,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,EAAE,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;gBAC/D,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,sBAAsB;oBAC5B,OAAO,EACL,UAAU,KAAK,CAAC,GAAG,2BAA2B,OAAO,CAAC,EAAE,+BAA+B;wBACvF,6EAA6E;iBAChF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,qDAAqD;AACrD,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,IAAA,qBAAW,EAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACxC,MAAM,IAAI,GAAG,IAAA,gBAAI,EAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9B,IAAI,IAAA,kBAAQ,EAAC,IAAI,CAAC,CAAC,WAAW,EAAE;YAAE,OAAO,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3F,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,EAAE,CAAC;QAC/F,OAAO,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,mFAAmF;AACnF,SAAS,aAAa,CAAC,MAAc;IACnC,OAAO,MAAM;SACV,OAAO,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;SACrE,OAAO,CAAC,0BAA0B,EAAE,CAAC,MAAM,EAAE,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;AACzE,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,MAAc;IACtC,MAAM,KAAK,GAA0C,EAAE,CAAC;IACxD,IAAI,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5C,OAAO,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC;QAC3C,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,GAAG,GAAG,IAAI,CAAC;QACf,OAAO,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;YACrC,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,GAAG;gBAAE,KAAK,IAAI,CAAC,CAAC;iBAC/B,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC7B,KAAK,IAAI,CAAC,CAAC;gBACX,IAAI,KAAK,KAAK,CAAC;oBAAE,MAAM;YACzB,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QACjC,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAcD;;;;;;;;GAQG;AACH,SAAgB,sBAAsB,CACpC,OAA2B,EAC3B,YAA+B,EAAE;IAEjC,MAAM,QAAQ,GAAyB,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACvC,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,IAAA,oBAAQ,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACvD,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC5B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChB,MAAM,MAAM,GAAG,aAAa,CAAC,IAAA,sBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;YACzD,KAAK,MAAM,IAAI,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;gBAChD,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrC,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;oBAC1E,QAAQ,CAAC,IAAI,CAAC;wBACZ,IAAI,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE;wBACtB,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,kFAAkF;qBACvG,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,gBAAgB;IAC9B,MAAM,SAAS,GAAG,IAAI,GAAG,CAAS,CAAC,GAAG,iCAAmB,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC7F,MAAM,QAAQ,GAAyB,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,gBAAgB,EAAhB,gCAAgB,EAAE,wBAAwB,EAAxB,wCAAwB,EAAE,CAAC,EAAE,CAAC;QAC5F,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5C,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,IAAI,cAAc,GAAG,6DAA6D,EAAE,CAAC,CAAC;QAChK,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;GAYG;AACU,QAAA,6BAA6B,GAAsD;IAC9F,EAAE,EAAE,eAAe;IACnB,KAAK,EAAE,8CAA8C;IACrD,WAAW,EACT,kRAAkR;IACpR,KAAK,CAAC,OAAO,EAAE,OAAO;QACpB,MAAM,WAAW,GAAG,sBAAsB,CAAC,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAClF,MAAM,QAAQ,GAAG,CAAC,GAAG,0BAA0B,EAAE,EAAE,GAAG,kBAAkB,EAAE,EAAE,GAAG,qBAAqB,EAAE,EAAE,GAAG,WAAW,CAAC,QAAQ,EAAE,GAAG,gBAAgB,EAAE,CAAC,CAAC;QACxJ,OAAO;YACL,OAAO,EAAE;gBACP,QAAQ,EAAE,8CAA2B,CAAC,GAAG,EAAE,CAAC,MAAM;gBAClD,MAAM,EAAE,0CAAyB,CAAC,GAAG,EAAE,CAAC,MAAM;gBAC9C,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM;gBAC/B,OAAO,EAAE,CAAC;aACX;YACD,YAAY,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,EAAE;YAC1C,QAAQ;SACT,CAAC;IACJ,CAAC;IACD,KAAK;QACH,MAAM,IAAI,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,CAAC,OAA2B,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC;QAC1F,OAAO;YACL;gBACE,IAAI,EAAE,kEAAkE;gBACxE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;oBACtB,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAClE,CAAC;aACF;YACD;gBACE,IAAI,EAAE,sEAAsE;gBAC5E,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;oBACtB,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBACnE,CAAC;aACF;YACD;gBACE,IAAI,EAAE,wGAAwG;gBAC9G,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;oBACtB,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAC3E,CAAC;aACF;YACD;gBACE,IAAI,EAAE,oEAAoE;gBAC1E,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;oBACtB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;oBACvD,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBACpG,CAAC;aACF;YACD;gBACE,IAAI,EAAE,qFAAqF;gBAC3F,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;oBACtB,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBACjE,CAAC;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,IAAI,CAAC,yBAAiB,CAAC,GAAG,CAAC,qCAA6B,CAAC,EAAE,CAAC;IAAE,yBAAiB,CAAC,QAAQ,CAAC,qCAA6B,CAAC,CAAC"}

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

@@ -0,0 +1,32 @@
+export { checkChannelTemplates, checkEmailBindings, checkNotifyAfterCommit, checkPlatformNotifications, checkPushSchemas, notificationsConformanceSuite, } from './conformance';
+export type { NotificationsConformanceOptions, NotifyAfterCommitScan } from './conformance';
+export { describeNotificationSenderConformance } from './sender-conformance';
+export type { NotificationSenderConformanceHarness, NotificationSenderConformanceOptions, NotificationSenderConformanceScenario, } from './sender-conformance';
+export { NOTIFICATION_CHANNEL_SENDERS } from '../notification.types';
+export { NotificationDeliveryService } from '../notification-delivery.service';
+export type { QueuedDeliveryInput } from '../notification-delivery.service';
+export { NotificationPolicyService } from '../notification-policy.service';
+export { NotificationStoreService } from '../notification-store.service';
+export { NotificationStreamService } from '../notification-stream.service';
+export { NotificationsController } from '../notifications.controller';
+export { PushConfigController } from '../push-config.controller';
+export { PushSubscriptionService } from '../push-subscription.service';
+export { PUSH_TEST_EVENT_KEY, PushTestService, buildHints, isValidVapidPublicKey, isValidVapidSubject, normalizeBase64Url, privateKeyDerivesPublicKey, } from '../push-test.service';
+export { BrowserNotificationChannel } from '../channels/browser-notification.channel';
+export { EmailNotificationChannel } from '../channels/email-notification.channel';
+export { PushNotificationChannel } from '../channels/push-notification.channel';
+export { JobFailureNotifier } from '../ops/job-failure-notifier';
+export { NodeOfflineNotifier } from '../ops/node-offline-notifier';
+export { PushVapidDoctorCheck, decidePushVapid } from '../doctor/push-vapid.doctor-check';
+export { KNOWN_PUSH_SERVICE_HOSTS, PUSH_ENDPOINT_SCAN_LIMIT, WebPushEgressContributor, } from '../doctor/egress/web-push.egress.contributor';
+export { describeThrown } from '../describe-thrown';
+export { BroadcastsController } from '../broadcasts/broadcasts.controller';
+export { BroadcastsService } from '../broadcasts/broadcasts.service';
+export type { BroadcastCreateResult, BroadcastDeliveryCount, BroadcastDetail, BroadcastListResult, } from '../broadcasts/broadcasts.service';
+export { BroadcastFailureListener } from '../broadcasts/broadcast-failure.listener';
+export { broadcastJobDeleteRefusal } from '../broadcasts/broadcast-job-delete-guard';
+export { BroadcastStartHandler, broadcastFirstChunkDedupKey } from '../broadcasts/handlers/broadcast-start.handler';
+export { BROADCAST_EMAIL_PROVIDER_KEY, BroadcastChunkHandler } from '../broadcasts/handlers/broadcast-chunk.handler';
+export { createBroadcastSchema, CreateBroadcastDto, TestBroadcastDto } from '../broadcasts/dto/create-broadcast.dto';
+export { NotificationListQueryDto } from '../dto/notification.dto';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/notifications/testing/index.ts"],"names":[],"mappings":"AASA,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,gBAAgB,EAChB,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,+BAA+B,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC5F,OAAO,EAAE,qCAAqC,EAAE,MAAM,sBAAsB,CAAC;AAC7E,YAAY,EACV,oCAAoC,EACpC,oCAAoC,EACpC,qCAAqC,GACtC,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,YAAY,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,UAAU,EACV,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAC1F,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AACpH,OAAO,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACrH,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AACrH,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/notifications/testing/index.js

@@ -0,0 +1,85 @@
+"use strict";
+// `@marinoscar/platform-api/notifications/testing`: the notifications slice's
+// test seams (issue #738): the conformance suite (importing this entry
+// registers it with `runPlatformConformance`), and the slice's INTERNALS, so an
+// app's own unit tests can construct a channel, the delivery log or a
+// broadcast handler around their own doubles exactly as before the move. Never
+// import it from production code: `NotificationsModule` keeps these providers
+// internal (a feature that could reach a channel directly would skip the
+// preference and `mandatory` gates). Documented in ../README.md.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationListQueryDto = exports.TestBroadcastDto = exports.CreateBroadcastDto = exports.createBroadcastSchema = exports.BroadcastChunkHandler = exports.BROADCAST_EMAIL_PROVIDER_KEY = exports.broadcastFirstChunkDedupKey = exports.BroadcastStartHandler = exports.broadcastJobDeleteRefusal = exports.BroadcastFailureListener = exports.BroadcastsService = exports.BroadcastsController = exports.describeThrown = exports.WebPushEgressContributor = exports.PUSH_ENDPOINT_SCAN_LIMIT = exports.KNOWN_PUSH_SERVICE_HOSTS = exports.decidePushVapid = exports.PushVapidDoctorCheck = exports.NodeOfflineNotifier = exports.JobFailureNotifier = exports.PushNotificationChannel = exports.EmailNotificationChannel = exports.BrowserNotificationChannel = exports.privateKeyDerivesPublicKey = exports.normalizeBase64Url = exports.isValidVapidSubject = exports.isValidVapidPublicKey = exports.buildHints = exports.PushTestService = exports.PUSH_TEST_EVENT_KEY = exports.PushSubscriptionService = exports.PushConfigController = exports.NotificationsController = exports.NotificationStreamService = exports.NotificationStoreService = exports.NotificationPolicyService = exports.NotificationDeliveryService = exports.NOTIFICATION_CHANNEL_SENDERS = exports.describeNotificationSenderConformance = exports.notificationsConformanceSuite = exports.checkPushSchemas = exports.checkPlatformNotifications = exports.checkNotifyAfterCommit = exports.checkEmailBindings = exports.checkChannelTemplates = void 0;
+var conformance_1 = require("./conformance");
+Object.defineProperty(exports, "checkChannelTemplates", { enumerable: true, get: function () { return conformance_1.checkChannelTemplates; } });
+Object.defineProperty(exports, "checkEmailBindings", { enumerable: true, get: function () { return conformance_1.checkEmailBindings; } });
+Object.defineProperty(exports, "checkNotifyAfterCommit", { enumerable: true, get: function () { return conformance_1.checkNotifyAfterCommit; } });
+Object.defineProperty(exports, "checkPlatformNotifications", { enumerable: true, get: function () { return conformance_1.checkPlatformNotifications; } });
+Object.defineProperty(exports, "checkPushSchemas", { enumerable: true, get: function () { return conformance_1.checkPushSchemas; } });
+Object.defineProperty(exports, "notificationsConformanceSuite", { enumerable: true, get: function () { return conformance_1.notificationsConformanceSuite; } });
+var sender_conformance_1 = require("./sender-conformance");
+Object.defineProperty(exports, "describeNotificationSenderConformance", { enumerable: true, get: function () { return sender_conformance_1.describeNotificationSenderConformance; } });
+// ---- internals, for an app's own unit tests ------------------------------------------------
+var notification_types_1 = require("../notification.types");
+Object.defineProperty(exports, "NOTIFICATION_CHANNEL_SENDERS", { enumerable: true, get: function () { return notification_types_1.NOTIFICATION_CHANNEL_SENDERS; } });
+var notification_delivery_service_1 = require("../notification-delivery.service");
+Object.defineProperty(exports, "NotificationDeliveryService", { enumerable: true, get: function () { return notification_delivery_service_1.NotificationDeliveryService; } });
+var notification_policy_service_1 = require("../notification-policy.service");
+Object.defineProperty(exports, "NotificationPolicyService", { enumerable: true, get: function () { return notification_policy_service_1.NotificationPolicyService; } });
+var notification_store_service_1 = require("../notification-store.service");
+Object.defineProperty(exports, "NotificationStoreService", { enumerable: true, get: function () { return notification_store_service_1.NotificationStoreService; } });
+var notification_stream_service_1 = require("../notification-stream.service");
+Object.defineProperty(exports, "NotificationStreamService", { enumerable: true, get: function () { return notification_stream_service_1.NotificationStreamService; } });
+var notifications_controller_1 = require("../notifications.controller");
+Object.defineProperty(exports, "NotificationsController", { enumerable: true, get: function () { return notifications_controller_1.NotificationsController; } });
+var push_config_controller_1 = require("../push-config.controller");
+Object.defineProperty(exports, "PushConfigController", { enumerable: true, get: function () { return push_config_controller_1.PushConfigController; } });
+var push_subscription_service_1 = require("../push-subscription.service");
+Object.defineProperty(exports, "PushSubscriptionService", { enumerable: true, get: function () { return push_subscription_service_1.PushSubscriptionService; } });
+var push_test_service_1 = require("../push-test.service");
+Object.defineProperty(exports, "PUSH_TEST_EVENT_KEY", { enumerable: true, get: function () { return push_test_service_1.PUSH_TEST_EVENT_KEY; } });
+Object.defineProperty(exports, "PushTestService", { enumerable: true, get: function () { return push_test_service_1.PushTestService; } });
+Object.defineProperty(exports, "buildHints", { enumerable: true, get: function () { return push_test_service_1.buildHints; } });
+Object.defineProperty(exports, "isValidVapidPublicKey", { enumerable: true, get: function () { return push_test_service_1.isValidVapidPublicKey; } });
+Object.defineProperty(exports, "isValidVapidSubject", { enumerable: true, get: function () { return push_test_service_1.isValidVapidSubject; } });
+Object.defineProperty(exports, "normalizeBase64Url", { enumerable: true, get: function () { return push_test_service_1.normalizeBase64Url; } });
+Object.defineProperty(exports, "privateKeyDerivesPublicKey", { enumerable: true, get: function () { return push_test_service_1.privateKeyDerivesPublicKey; } });
+var browser_notification_channel_1 = require("../channels/browser-notification.channel");
+Object.defineProperty(exports, "BrowserNotificationChannel", { enumerable: true, get: function () { return browser_notification_channel_1.BrowserNotificationChannel; } });
+var email_notification_channel_1 = require("../channels/email-notification.channel");
+Object.defineProperty(exports, "EmailNotificationChannel", { enumerable: true, get: function () { return email_notification_channel_1.EmailNotificationChannel; } });
+var push_notification_channel_1 = require("../channels/push-notification.channel");
+Object.defineProperty(exports, "PushNotificationChannel", { enumerable: true, get: function () { return push_notification_channel_1.PushNotificationChannel; } });
+var job_failure_notifier_1 = require("../ops/job-failure-notifier");
+Object.defineProperty(exports, "JobFailureNotifier", { enumerable: true, get: function () { return job_failure_notifier_1.JobFailureNotifier; } });
+var node_offline_notifier_1 = require("../ops/node-offline-notifier");
+Object.defineProperty(exports, "NodeOfflineNotifier", { enumerable: true, get: function () { return node_offline_notifier_1.NodeOfflineNotifier; } });
+var push_vapid_doctor_check_1 = require("../doctor/push-vapid.doctor-check");
+Object.defineProperty(exports, "PushVapidDoctorCheck", { enumerable: true, get: function () { return push_vapid_doctor_check_1.PushVapidDoctorCheck; } });
+Object.defineProperty(exports, "decidePushVapid", { enumerable: true, get: function () { return push_vapid_doctor_check_1.decidePushVapid; } });
+var web_push_egress_contributor_1 = require("../doctor/egress/web-push.egress.contributor");
+Object.defineProperty(exports, "KNOWN_PUSH_SERVICE_HOSTS", { enumerable: true, get: function () { return web_push_egress_contributor_1.KNOWN_PUSH_SERVICE_HOSTS; } });
+Object.defineProperty(exports, "PUSH_ENDPOINT_SCAN_LIMIT", { enumerable: true, get: function () { return web_push_egress_contributor_1.PUSH_ENDPOINT_SCAN_LIMIT; } });
+Object.defineProperty(exports, "WebPushEgressContributor", { enumerable: true, get: function () { return web_push_egress_contributor_1.WebPushEgressContributor; } });
+var describe_thrown_1 = require("../describe-thrown");
+Object.defineProperty(exports, "describeThrown", { enumerable: true, get: function () { return describe_thrown_1.describeThrown; } });
+var broadcasts_controller_1 = require("../broadcasts/broadcasts.controller");
+Object.defineProperty(exports, "BroadcastsController", { enumerable: true, get: function () { return broadcasts_controller_1.BroadcastsController; } });
+var broadcasts_service_1 = require("../broadcasts/broadcasts.service");
+Object.defineProperty(exports, "BroadcastsService", { enumerable: true, get: function () { return broadcasts_service_1.BroadcastsService; } });
+var broadcast_failure_listener_1 = require("../broadcasts/broadcast-failure.listener");
+Object.defineProperty(exports, "BroadcastFailureListener", { enumerable: true, get: function () { return broadcast_failure_listener_1.BroadcastFailureListener; } });
+var broadcast_job_delete_guard_1 = require("../broadcasts/broadcast-job-delete-guard");
+Object.defineProperty(exports, "broadcastJobDeleteRefusal", { enumerable: true, get: function () { return broadcast_job_delete_guard_1.broadcastJobDeleteRefusal; } });
+var broadcast_start_handler_1 = require("../broadcasts/handlers/broadcast-start.handler");
+Object.defineProperty(exports, "BroadcastStartHandler", { enumerable: true, get: function () { return broadcast_start_handler_1.BroadcastStartHandler; } });
+Object.defineProperty(exports, "broadcastFirstChunkDedupKey", { enumerable: true, get: function () { return broadcast_start_handler_1.broadcastFirstChunkDedupKey; } });
+var broadcast_chunk_handler_1 = require("../broadcasts/handlers/broadcast-chunk.handler");
+Object.defineProperty(exports, "BROADCAST_EMAIL_PROVIDER_KEY", { enumerable: true, get: function () { return broadcast_chunk_handler_1.BROADCAST_EMAIL_PROVIDER_KEY; } });
+Object.defineProperty(exports, "BroadcastChunkHandler", { enumerable: true, get: function () { return broadcast_chunk_handler_1.BroadcastChunkHandler; } });
+var create_broadcast_dto_1 = require("../broadcasts/dto/create-broadcast.dto");
+Object.defineProperty(exports, "createBroadcastSchema", { enumerable: true, get: function () { return create_broadcast_dto_1.createBroadcastSchema; } });
+Object.defineProperty(exports, "CreateBroadcastDto", { enumerable: true, get: function () { return create_broadcast_dto_1.CreateBroadcastDto; } });
+Object.defineProperty(exports, "TestBroadcastDto", { enumerable: true, get: function () { return create_broadcast_dto_1.TestBroadcastDto; } });
+var notification_dto_1 = require("../dto/notification.dto");
+Object.defineProperty(exports, "NotificationListQueryDto", { enumerable: true, get: function () { return notification_dto_1.NotificationListQueryDto; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/notifications/testing/index.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,uEAAuE;AACvE,gFAAgF;AAChF,sEAAsE;AACtE,+EAA+E;AAC/E,8EAA8E;AAC9E,yEAAyE;AACzE,iEAAiE;;;AAEjE,6CAOuB;AANrB,oHAAA,qBAAqB,OAAA;AACrB,iHAAA,kBAAkB,OAAA;AAClB,qHAAA,sBAAsB,OAAA;AACtB,yHAAA,0BAA0B,OAAA;AAC1B,+GAAA,gBAAgB,OAAA;AAChB,4HAAA,6BAA6B,OAAA;AAG/B,2DAA6E;AAApE,2IAAA,qCAAqC,OAAA;AAO9C,+FAA+F;AAC/F,4DAAqE;AAA5D,kIAAA,4BAA4B,OAAA;AACrC,kFAA+E;AAAtE,4IAAA,2BAA2B,OAAA;AAEpC,8EAA2E;AAAlE,wIAAA,yBAAyB,OAAA;AAClC,4EAAyE;AAAhE,sIAAA,wBAAwB,OAAA;AACjC,8EAA2E;AAAlE,wIAAA,yBAAyB,OAAA;AAClC,wEAAsE;AAA7D,mIAAA,uBAAuB,OAAA;AAChC,oEAAiE;AAAxD,8HAAA,oBAAoB,OAAA;AAC7B,0EAAuE;AAA9D,oIAAA,uBAAuB,OAAA;AAChC,0DAQ8B;AAP5B,wHAAA,mBAAmB,OAAA;AACnB,oHAAA,eAAe,OAAA;AACf,+GAAA,UAAU,OAAA;AACV,0HAAA,qBAAqB,OAAA;AACrB,wHAAA,mBAAmB,OAAA;AACnB,uHAAA,kBAAkB,OAAA;AAClB,+HAAA,0BAA0B,OAAA;AAE5B,yFAAsF;AAA7E,0IAAA,0BAA0B,OAAA;AACnC,qFAAkF;AAAzE,sIAAA,wBAAwB,OAAA;AACjC,mFAAgF;AAAvE,oIAAA,uBAAuB,OAAA;AAChC,oEAAiE;AAAxD,0HAAA,kBAAkB,OAAA;AAC3B,sEAAmE;AAA1D,4HAAA,mBAAmB,OAAA;AAC5B,6EAA0F;AAAjF,+HAAA,oBAAoB,OAAA;AAAE,0HAAA,eAAe,OAAA;AAC9C,4FAIsD;AAHpD,uIAAA,wBAAwB,OAAA;AACxB,uIAAA,wBAAwB,OAAA;AACxB,uIAAA,wBAAwB,OAAA;AAE1B,sDAAoD;AAA3C,iHAAA,cAAc,OAAA;AACvB,6EAA2E;AAAlE,6HAAA,oBAAoB,OAAA;AAC7B,uEAAqE;AAA5D,uHAAA,iBAAiB,OAAA;AAO1B,uFAAoF;AAA3E,sIAAA,wBAAwB,OAAA;AACjC,uFAAqF;AAA5E,uIAAA,yBAAyB,OAAA;AAClC,0FAAoH;AAA3G,gIAAA,qBAAqB,OAAA;AAAE,sIAAA,2BAA2B,OAAA;AAC3D,0FAAqH;AAA5G,uIAAA,4BAA4B,OAAA;AAAE,gIAAA,qBAAqB,OAAA;AAC5D,+EAAqH;AAA5G,6HAAA,qBAAqB,OAAA;AAAE,0HAAA,kBAAkB,OAAA;AAAE,wHAAA,gBAAgB,OAAA;AACpE,4DAAmE;AAA1D,4HAAA,wBAAwB,OAAA"}

package/dist/notifications/testing/sender-conformance.d.ts

@@ -0,0 +1,71 @@
+import type { NotificationChannelSender, NotificationRecipient } from '../notification.types';
+import type { RecipientHandleSource } from '../ports';
+import type { NotificationEventDef } from '../registry/event.registry';
+/**
+ * The test runner's own globals, passed in.
+ *
+ * @stability experimental
+ */
+export interface NotificationSenderConformanceHarness {
+    /** The runner's `describe`. */
+    describe: (name: string, fn: () => void) => unknown;
+    /** The runner's `it`. Every case body the kit passes is an asynchronous function. */
+    it: (name: string, fn: () => Promise<void>) => unknown;
+    /** The runner's `expect`. */
+    expect: (actual: unknown) => any;
+}
+/**
+ * One scenario of the kit; each is skippable by name.
+ *
+ * @stability experimental
+ */
+export type NotificationSenderConformanceScenario = 'definition' | 'resolve' | 'unreachable' | 'deliver' | 'payloads' | 'transportDown' | 'badDestination' | 'noSecret' | 'killSwitch';
+/**
+ * Options of {@link describeNotificationSenderConformance}.
+ *
+ * @stability experimental
+ */
+export interface NotificationSenderConformanceOptions extends NotificationSenderConformanceHarness {
+    /** A recipient the sender CAN reach (for a handle-based sender, one the {@link handles} source has a handle for). */
+    recipient: NotificationRecipient;
+    /** A recipient it cannot reach. Default: no account, no address, no preferences. */
+    unreachableRecipient?: NotificationRecipient;
+    /** The app's handle source, as the dispatcher would hand it to `resolveRecipient` through `context.handle()`. Default: none (`handle()` answers `null`). */
+    handles?: RecipientHandleSource;
+    /**
+     * The event the sender is exercised with. Default: a synthetic event
+     * declaring only the sender's channel. Pass a real event when the sender's
+     * template is bound to it.
+     */
+    event?: NotificationEventDef;
+    /** The payload of the normal delivery. Default `{ message: 'conformance' }`. */
+    data?: unknown;
+    /** Strings that must appear in neither the delivery row's `display`, nor `error`, nor `messageId` (tokens, webhook URLs, phone numbers). */
+    secrets?: readonly string[];
+    /**
+     * Makes the transport fail (a fake that rejects, a refused connection) and
+     * returns a function that restores it. Without it the `transportDown`
+     * scenario has nothing to break and is skipped.
+     */
+    breakTransport?: () => (() => void) | void | Promise<(() => void) | void>;
+    /** Scenarios to skip, each for a stated reason of the caller's. */
+    skip?: readonly NotificationSenderConformanceScenario[];
+}
+/**
+ * Registers the notification channel sender conformance suite.
+ *
+ * @param sender - the transport under test (constructed with its fakes).
+ * @param options - the runner, a reachable recipient and what the sender must never leak.
+ *
+ * @example
+ * ```ts
+ * import { describeNotificationSenderConformance } from '@marinoscar/platform-api/notifications/testing';
+ *
+ * describeNotificationSenderConformance(sender, { describe, it, expect, recipient, handles, secrets: [url] });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare function describeNotificationSenderConformance(sender: NotificationChannelSender, options: NotificationSenderConformanceOptions): void;
+//# sourceMappingURL=sender-conformance.d.ts.map

package/dist/notifications/testing/sender-conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender-conformance.d.ts","sourceRoot":"","sources":["../../../src/notifications/testing/sender-conformance.ts"],"names":[],"mappings":"AA6CA,OAAO,KAAK,EAEV,yBAAyB,EAEzB,qBAAqB,EAGtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGvE;;;;GAIG;AACH,MAAM,WAAW,oCAAoC;IACnD,+BAA+B;IAC/B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,KAAK,OAAO,CAAC;IACpD,qFAAqF;IACrF,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC;IACvD,6BAA6B;IAC7B,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,GAAG,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,MAAM,qCAAqC,GAC7C,YAAY,GACZ,SAAS,GACT,aAAa,GACb,SAAS,GACT,UAAU,GACV,eAAe,GACf,gBAAgB,GAChB,UAAU,GACV,YAAY,CAAC;AAEjB;;;;GAIG;AACH,MAAM,WAAW,oCAAqC,SAAQ,oCAAoC;IAChG,qHAAqH;IACrH,SAAS,EAAE,qBAAqB,CAAC;IACjC,oFAAoF;IACpF,oBAAoB,CAAC,EAAE,qBAAqB,CAAC;IAC7C,4JAA4J;IAC5J,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC;;;;OAIG;IACH,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,gFAAgF;IAChF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4IAA4I;IAC5I,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1E,mEAAmE;IACnE,IAAI,CAAC,EAAE,SAAS,qCAAqC,EAAE,CAAC;CACzD;AAqBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,yBAAyB,EACjC,OAAO,EAAE,oCAAoC,GAC5C,IAAI,CA8IN"}