@aglyn/aglyn 1.0.0-beta.206 → 1.0.0-beta.209

package/src/lib/app-utils/operator-alerts.js

@@ -0,0 +1,513 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /** The notification type an alert without its own writes under. */ export const OPERATOR_ALERT_DEFAULT_NOTIFICATION_TYPE = 'system.operatorAlert';
+export const OPERATOR_ALERT_TIER_LABELS = {
+    must: 'Must know',
+    should: 'Should know',
+    low: 'Routine'
+};
+export const OPERATOR_ALERT_CATEGORY_LABELS = {
+    billing: 'Billing',
+    payments: 'Payments & payouts',
+    legal: 'Legal',
+    data: 'Data protection',
+    ops: 'Operations',
+    deliverability: 'Email deliverability',
+    security: 'Security',
+    support: 'Support'
+};
+const DAY = 24 * 60;
+/**
+ * Core's alerts. Plugins contribute theirs through the plugin-manager
+ * registry; nothing plugin-specific belongs in this list.
+ */ export const CORE_OPERATOR_ALERTS = [
+    // ── Fraud, risk and legal duties already alerting before AGL-3377 ──────
+    {
+        type: 'system.abuseReportUrgent',
+        label: 'Urgent abuse, fraud or risk alert',
+        description: 'Phishing, malware or CSAM reported on a site, card testing, a flagged or disputed payment, a held phishing email, a seller under review. Review it on Staff → Abuse reports.',
+        tier: 'must',
+        category: 'security',
+        title: '{{title}}',
+        body: '{{body}}',
+        link: '/admin/abuse-reports',
+        delivery: 'immediate',
+        dedupeWindowMinutes: 0,
+        defaultEnabled: true,
+        notificationType: 'system.abuseReportUrgent'
+    },
+    {
+        type: 'system.disputeUnattributed',
+        label: 'Card dispute with no owner',
+        description: 'A chargeback arrived that no subscription, order or marketplace purchase claimed, so nothing is answering it. Find the charge in Stripe and respond before the evidence deadline.',
+        tier: 'must',
+        category: 'billing',
+        title: '{{title}}',
+        body: '{{body}}',
+        delivery: 'immediate',
+        dedupeWindowMinutes: 0,
+        defaultEnabled: true,
+        notificationType: 'system.disputeUnattributed'
+    },
+    {
+        type: 'system.dmcaCounterNotice',
+        label: 'DMCA counter-notice',
+        description: 'A customer contested a takedown. The statutory clock is already running; forward it to the complainant and restore on time unless they file suit.',
+        tier: 'must',
+        category: 'legal',
+        title: '{{title}}',
+        body: '{{body}}',
+        delivery: 'immediate',
+        dedupeWindowMinutes: 0,
+        defaultEnabled: true,
+        notificationType: 'system.dmcaCounterNotice'
+    },
+    {
+        type: 'system.billingWebhookHalfApplied',
+        label: 'Billing webhook half applied',
+        description: 'A Stripe event threw after its handlers began, so its effects may be partly applied and Stripe will not retry it. Reconcile the event by hand.',
+        tier: 'must',
+        category: 'billing',
+        title: '{{title}}',
+        body: '{{body}}',
+        delivery: 'immediate',
+        dedupeWindowMinutes: 0,
+        defaultEnabled: true,
+        notificationType: 'system.billingWebhookHalfApplied'
+    },
+    // ── MUST: billing ───────────────────────────────────────────────────────
+    {
+        type: 'billing.platformDisputeLost',
+        label: 'Subscription dispute lost',
+        description: 'A card dispute on a workspace subscription closed as lost: the money has been taken back. Decide whether the workspace keeps its plan.',
+        tier: 'must',
+        category: 'billing',
+        title: 'Subscription dispute lost on workspace {{orgId}}',
+        body: 'The card dispute {{disputeId}} on invoice {{invoiceId}} closed as lost ({{reason}}), and {{amount}} was taken back. The workspace keeps its plan until somebody decides otherwise.',
+        link: '/admin/orgs/{{orgId}}',
+        delivery: 'immediate',
+        dedupeWindowMinutes: 30 * DAY,
+        defaultEnabled: true
+    },
+    {
+        type: 'billing.orphanedSubscription',
+        label: 'Stripe is billing a workspace that does not exist',
+        description: 'A subscription names a workspace that was deleted or erased, so the customer keeps being charged for nothing. Cancel or refund it in Stripe.',
+        tier: 'must',
+        category: 'billing',
+        title: 'Subscription bills a missing workspace',
+        body: 'Stripe subscription {{subscriptionId}} (customer {{customerId}}, plan {{plan}}) names workspace {{orgId}}, which {{reason}}. The {{eventType}} event changed nothing. Cancel or refund it in Stripe.',
+        delivery: 'immediate',
+        dedupeWindowMinutes: DAY,
+        defaultEnabled: true
+    },
+    {
+        type: 'billing.usageNotReported',
+        label: 'Metered usage not reported to Stripe',
+        description: 'A closed month measured billable usage and it reached no invoice. Report it to Stripe by hand or the revenue is lost.',
+        tier: 'must',
+        category: 'billing',
+        title: 'Usage for {{month}} not billed on {{orgId}}',
+        body: 'The closed month {{month}} measured {{amount}} of billable usage on workspace {{orgId}}, and it was not reported to Stripe ({{reason}}). Nothing will invoice it until somebody does.',
+        link: '/admin/orgs/{{orgId}}',
+        delivery: 'immediate',
+        dedupeWindowMinutes: 7 * DAY,
+        defaultEnabled: true
+    },
+    {
+        type: 'billing.webhookSignatureRejected',
+        label: 'Billing webhook failing its signature check',
+        description: 'Repeated deliveries to the billing webhook were refused because their signature did not match. Usually a rolled signing secret: until it is fixed, Stripe cannot tell the install about money.',
+        tier: 'must',
+        category: 'billing',
+        title: 'Billing webhook is refusing deliveries',
+        body: 'The billing webhook refused several signed deliveries within six hours because their Stripe signature matched none of the configured secrets. If Stripe is the sender, its signing secret no longer matches this install’s, and no billing event is being applied.',
+        link: '/admin/health',
+        delivery: 'immediate',
+        dedupeWindowMinutes: 6 * 60,
+        minOccurrences: 3,
+        defaultEnabled: true
+    },
+    {
+        type: 'billing.webhookInert',
+        label: 'Billing webhook delivery moved nothing',
+        description: 'Stripe delivered an event this install subscribed to, and no handler did anything with it. Usually a handler that stopped being registered.',
+        tier: 'must',
+        category: 'billing',
+        title: 'A {{eventType}} delivery changed nothing',
+        body: 'Stripe event {{eventId}} ({{eventType}}) was accepted and no handler acted on it. Check which handler stopped being registered, then replay the event.',
+        link: '/admin/health',
+        delivery: 'immediate',
+        dedupeWindowMinutes: 6 * 60,
+        defaultEnabled: true
+    },
+    // ── MUST: data protection and records ───────────────────────────────────
+    {
+        type: 'data.personErasureFailed',
+        label: 'Personal data erasure failed',
+        description: 'A data subject’s erasure request failed. It will be retried, but the legal deadline keeps running: read the error and fix the cause.',
+        tier: 'must',
+        category: 'data',
+        title: 'Erasure request {{requestId}} failed',
+        body: 'The erasure request {{requestId}} on workspace {{orgId}} failed (attempt {{attempt}}): {{error}}. The statutory deadline keeps running while it retries.',
+        delivery: 'immediate',
+        dedupeWindowMinutes: DAY,
+        defaultEnabled: true
+    },
+    {
+        type: 'data.orgErasureFailed',
+        label: 'Workspace erasure failed',
+        description: 'A workspace scheduled for erasure could not be erased. Its data is still held after the date it was promised gone.',
+        tier: 'must',
+        category: 'data',
+        title: 'Workspace {{orgId}} could not be erased',
+        body: 'The scheduled erasure of workspace {{orgName}} ({{orgId}}) did not complete: {{reason}}. It will be retried on the next run; its data is held until it succeeds.',
+        link: '/admin/orgs/{{orgId}}',
+        delivery: 'immediate',
+        dedupeWindowMinutes: DAY,
+        defaultEnabled: true
+    },
+    {
+        type: 'data.backupExportFailed',
+        label: 'Database export failed',
+        description: 'The scheduled database export did not start. A stale export means the worst day has nothing to restore from.',
+        tier: 'must',
+        category: 'data',
+        title: 'Database export failed',
+        body: 'The scheduled database export did not start ({{reason}}). The last good export is getting older; check the service account’s export permission and the bucket.',
+        link: '/admin/health',
+        delivery: 'immediate',
+        dedupeWindowMinutes: 12 * 60,
+        defaultEnabled: true
+    },
+    // ── MUST: legal ─────────────────────────────────────────────────────────
+    {
+        type: 'legal.abuseReportHigh',
+        label: 'Takedown, impersonation or illegal-content report',
+        description: 'A DMCA takedown, impersonation or illegal-content report. Each carries a response duty; review it on Staff → Abuse reports.',
+        tier: 'must',
+        category: 'legal',
+        title: '{{category}} report on {{site}}',
+        body: '{{site}} was reported for {{category}}. Reference {{reference}}. Review it and respond within the policy’s window.',
+        link: '/admin/abuse-reports',
+        delivery: 'immediate',
+        dedupeWindowMinutes: 0,
+        defaultEnabled: true
+    },
+    // ── MUST/SHOULD: health ─────────────────────────────────────────────────
+    {
+        type: 'system.healthDegraded',
+        label: 'Health check degraded',
+        description: 'A health check went from healthy to degraded: scheduled jobs silent, backups stale, billing deliveries failing, sign-ups refused, server errors, a site not rendering. Told once per incident.',
+        tier: 'must',
+        category: 'ops',
+        title: '{{check}} is degraded',
+        body: '{{check}} went from healthy to degraded. {{detail}}',
+        link: '/admin/health',
+        delivery: 'immediate',
+        // A check flapping across the line is told once an hour, not on
+        // every swing.
+        dedupeWindowMinutes: 60,
+        defaultEnabled: true
+    },
+    {
+        type: 'system.healthRecovered',
+        label: 'Health check recovered',
+        description: 'A degraded health check is healthy again.',
+        tier: 'should',
+        category: 'ops',
+        title: '{{check}} recovered',
+        body: '{{check}} is healthy again after {{duration}}.',
+        link: '/admin/health',
+        delivery: 'immediate',
+        // A check flapping across the line is told once an hour, not on
+        // every swing.
+        dedupeWindowMinutes: 60,
+        defaultEnabled: true
+    },
+    // ── SHOULD: billing ─────────────────────────────────────────────────────
+    {
+        type: 'billing.autoLocked',
+        label: 'Workspace billing locked automatically',
+        description: 'A workspace crossed its spend guard and the platform locked its billable activity. Check it is not a false positive before the customer notices.',
+        tier: 'should',
+        category: 'billing',
+        title: 'Billing locked on {{orgName}}',
+        body: 'Workspace {{orgName}} ({{orgId}}) was locked automatically: {{reason}}.',
+        link: '/admin/orgs/{{orgId}}',
+        delivery: 'immediate',
+        dedupeWindowMinutes: DAY,
+        defaultEnabled: true
+    },
+    {
+        type: 'billing.platformInvoiceUncollectible',
+        label: 'Subscription invoice voided or uncollectible',
+        description: 'A workspace invoice was voided or marked uncollectible: revenue the books expected is not coming.',
+        tier: 'should',
+        category: 'billing',
+        title: 'Invoice {{status}} on {{orgId}}',
+        body: 'Invoice {{invoiceId}} for {{amount}} on workspace {{orgId}} was marked {{status}}.',
+        link: '/admin/orgs/{{orgId}}',
+        delivery: 'immediate',
+        dedupeWindowMinutes: 30 * DAY,
+        defaultEnabled: true
+    },
+    {
+        type: 'billing.connectPayoutFailed',
+        label: 'Connected account payout or transfer failed',
+        description: 'Money due to a merchant or seller did not arrive. Stripe retries on its own schedule; a human decides what happens next.',
+        tier: 'should',
+        category: 'billing',
+        title: 'A {{kind}} to {{account}} failed',
+        body: 'Stripe {{kind}} {{stripeId}} to connected account {{account}} failed ({{reason}}). The merchant’s funds are not where the ledger says.',
+        delivery: 'immediate',
+        dedupeWindowMinutes: 30 * DAY,
+        defaultEnabled: true
+    },
+    {
+        type: 'staff.paymentFailed',
+        label: 'Workspace payment failed',
+        description: 'A paying workspace’s renewal failed. Stripe is retrying; the customer has been told.',
+        tier: 'should',
+        category: 'billing',
+        title: '{{title}}',
+        body: '{{body}}',
+        delivery: 'immediate',
+        dedupeWindowMinutes: 0,
+        defaultEnabled: true,
+        notificationType: 'staff.paymentFailed'
+    },
+    // ── SHOULD: security ────────────────────────────────────────────────────
+    {
+        type: 'security.staffGranted',
+        label: 'Staff access granted or raised',
+        description: 'Somebody was made staff, or a staff role was raised. If nobody on the team did it, revoke it and rotate credentials.',
+        tier: 'should',
+        category: 'security',
+        title: '{{target}} is now {{role}} staff',
+        body: '{{actor}} granted {{target}} the {{role}} staff role (was {{previous}}).',
+        link: '/admin/users',
+        delivery: 'immediate',
+        dedupeWindowMinutes: 0,
+        defaultEnabled: true
+    },
+    // ── SHOULD: support ─────────────────────────────────────────────────────
+    {
+        type: 'support.slaBreached',
+        label: 'Support ticket past its response time',
+        description: 'A support ticket passed its promised response time without a staff reply.',
+        tier: 'should',
+        category: 'support',
+        title: 'Ticket past its response time: {{subject}}',
+        body: 'The {{tier}} ticket “{{subject}}” on workspace {{orgId}} was due a first response {{overdue}} ago and has none.',
+        link: '/admin/support',
+        delivery: 'immediate',
+        dedupeWindowMinutes: DAY,
+        defaultEnabled: true
+    },
+    {
+        type: 'support.ticketOpened',
+        label: 'New support ticket',
+        description: 'A subscriber opened a support ticket.',
+        tier: 'should',
+        category: 'support',
+        title: '{{title}}',
+        body: '{{body}}',
+        delivery: 'digest',
+        dedupeWindowMinutes: 0,
+        defaultEnabled: true,
+        notificationType: 'support.ticketOpened'
+    },
+    {
+        type: 'support.ticketReply',
+        label: 'Support ticket reply',
+        description: 'A subscriber replied on a support ticket.',
+        tier: 'should',
+        category: 'support',
+        title: '{{title}}',
+        body: '{{body}}',
+        delivery: 'digest',
+        dedupeWindowMinutes: 0,
+        defaultEnabled: true,
+        notificationType: 'support.ticketReply'
+    },
+    // ── SHOULD: deliverability ──────────────────────────────────────────────
+    {
+        type: 'deliverability.sendRateSaturated',
+        label: 'Email send-rate governor saturated',
+        description: 'The platform’s email send-rate budget is exhausted, so sends are being deferred. Raise the budget or find the sender filling it.',
+        tier: 'should',
+        category: 'deliverability',
+        title: 'Email sending is being throttled',
+        body: 'The {{scope}} send-rate budget is full ({{detail}}), so sends are being deferred.',
+        link: '/admin/emails',
+        delivery: 'immediate',
+        dedupeWindowMinutes: 6 * 60,
+        defaultEnabled: true
+    },
+    {
+        type: 'deliverability.sendRateUnavailable',
+        label: 'Email send-rate governor unavailable',
+        description: 'The send-rate governor could not read its counters, so mail is going out unmetered: nothing is holding the shared domains under their hourly ceiling.',
+        tier: 'should',
+        category: 'deliverability',
+        title: 'Email send-rate governor unavailable',
+        body: 'The send-rate governor could not read its counters ({{error}}), so sends are being allowed unmetered until it can.',
+        link: '/admin/emails',
+        delivery: 'immediate',
+        dedupeWindowMinutes: 6 * 60,
+        defaultEnabled: true
+    },
+    {
+        type: 'deliverability.gatewayBlocking',
+        label: 'A recipient gateway is blocking the shared domain',
+        description: 'A mail gateway is refusing mail from the shared sending domain, so everyone behind that gateway stops receiving it.',
+        tier: 'should',
+        category: 'deliverability',
+        title: '{{gateway}} is blocking {{domain}}',
+        body: 'Mail from {{domain}} is being refused by {{gateway}} ({{detail}}). Recipients behind that gateway are not receiving it.',
+        link: '/admin/emails',
+        delivery: 'immediate',
+        dedupeWindowMinutes: DAY,
+        defaultEnabled: true
+    },
+    {
+        type: 'deliverability.providerCredentialsRejected',
+        label: 'Email provider rejected the credentials',
+        description: 'The email provider refused the API key, or a sending pool is unhealthy: invites, password resets and receipts are not leaving. The webhook channel is the one that still reaches you.',
+        tier: 'should',
+        category: 'deliverability',
+        title: 'Email delivery is failing: {{problem}}',
+        body: '{{detail}}',
+        link: '/admin/emails',
+        delivery: 'immediate',
+        dedupeWindowMinutes: 6 * 60,
+        defaultEnabled: true
+    },
+    // ── SHOULD: operations ──────────────────────────────────────────────────
+    {
+        type: 'ops.reaperStuck',
+        label: 'A reaper is stuck or failing',
+        description: 'A cleanup job (sending domains, unverified workspaces) could not finish, so what it removes keeps accumulating.',
+        tier: 'should',
+        category: 'ops',
+        title: '{{job}} is stuck',
+        body: '{{job}} could not finish: {{detail}}',
+        delivery: 'immediate',
+        dedupeWindowMinutes: DAY,
+        defaultEnabled: true
+    },
+    {
+        type: 'ops.pluginJobFailed',
+        label: 'A plugin job failed',
+        description: 'A plugin’s scheduled job threw: consent-group changes, the publish outbox, sending-domain provisioning, a plugin cron.',
+        tier: 'should',
+        category: 'ops',
+        title: '{{job}} failed',
+        body: 'The scheduled job {{job}} failed: {{error}}',
+        delivery: 'immediate',
+        dedupeWindowMinutes: 6 * 60,
+        defaultEnabled: true
+    },
+    {
+        type: 'system.pluginVerifierRegression',
+        label: 'Plugin verifier regression',
+        description: 'A live plugin version stopped passing the static verifier.',
+        tier: 'should',
+        category: 'security',
+        title: '{{title}}',
+        body: '{{body}}',
+        delivery: 'immediate',
+        dedupeWindowMinutes: 0,
+        defaultEnabled: true,
+        notificationType: 'system.pluginVerifierRegression'
+    },
+    {
+        type: 'system.bandwidthCeilingTripped',
+        label: 'Bandwidth ceiling reached',
+        description: 'A site crossed the per-month bandwidth abuse ceiling.',
+        tier: 'should',
+        category: 'ops',
+        title: '{{title}}',
+        body: '{{body}}',
+        delivery: 'immediate',
+        dedupeWindowMinutes: 0,
+        defaultEnabled: true,
+        notificationType: 'system.bandwidthCeilingTripped'
+    },
+    // ── LOW ─────────────────────────────────────────────────────────────────
+    {
+        type: 'marketplace.review',
+        label: 'Plugin listing waiting for review',
+        description: 'A plugin listing or version was submitted for review.',
+        tier: 'low',
+        category: 'security',
+        title: '{{title}}',
+        body: '{{body}}',
+        delivery: 'digest',
+        dedupeWindowMinutes: 0,
+        defaultEnabled: true,
+        notificationType: 'marketplace.review'
+    },
+    {
+        type: 'system.scopeDrift',
+        label: 'Resources missing a sharing scope',
+        description: 'The weekly sweep found documents invisible to every site-scoped read: a creation path forgot the field.',
+        tier: 'low',
+        category: 'data',
+        title: '{{title}}',
+        body: '{{body}}',
+        delivery: 'digest',
+        dedupeWindowMinutes: 0,
+        defaultEnabled: true,
+        notificationType: 'system.scopeDrift'
+    }
+];
+/** An amount in minor units, as an alert prints it: `$12.40`. */ export function formatOperatorAlertAmount(cents, currency = 'usd') {
+    const value = Number(cents) / 100;
+    if (!Number.isFinite(value)) return '';
+    try {
+        return new Intl.NumberFormat('en-US', {
+            style: 'currency',
+            currency: String(currency || 'usd').toUpperCase()
+        }).format(value);
+    } catch (unused) {
+        return `${value.toFixed(2)} ${String(currency).toUpperCase()}`;
+    }
+}
+/** Replaces each `{{token}}` with its context value, or nothing. */ export function renderOperatorAlertTemplate(template, context) {
+    return String(template != null ? template : '').replace(/\{\{\s*([\w.]+)\s*\}\}/g, (_match, name)=>{
+        const value = context == null ? void 0 : context[name];
+        return value === null || value === undefined ? '' : String(value);
+    }).replace(/\(\s*\)/g, '').replace(/[ \t]{2,}/g, ' ').replace(/ ([.,;:])/g, '$1').trim();
+}
+/** Whether a type is on, and how it is delivered, after staff's answers. */ export function effectiveOperatorAlertSetting(definition, settings) {
+    var _settings_types;
+    const answer = settings == null ? void 0 : (_settings_types = settings.types) == null ? void 0 : _settings_types[definition.type];
+    return {
+        enabled: typeof (answer == null ? void 0 : answer.enabled) === 'boolean' ? answer.enabled : definition.defaultEnabled,
+        delivery: (answer == null ? void 0 : answer.delivery) === 'immediate' || (answer == null ? void 0 : answer.delivery) === 'digest' ? answer.delivery : definition.delivery
+    };
+}
+/**
+ * Staff notification types whose alert emails the operator on a coded
+ * default of immediate (AGL-3375), derived from the catalog so there is one
+ * list.
+ */ export const OPERATOR_ALERT_NOTIFICATION_TYPES = new Set(CORE_OPERATOR_ALERTS.flatMap((definition)=>definition.notificationType ? [
+        definition.notificationType
+    ] : []));
+
+//# sourceMappingURL=operator-alerts.js.map

package/src/lib/app-utils/operator-alerts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/operator-alerts.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { AglynNotificationType } from './notifications'\n\n/**\n * OPERATOR ALERTS (AGL-3377): the events whoever runs an install must hear\n * about, as one typed catalog.\n *\n * Every alert is an entry here (or a plugin's entry in the same shape,\n * registered through `@aglyn/aglyn/plugin-manager/operator-alerts`) and is\n * raised through ONE server entry point, `raiseOperatorAlert` in\n * `@aglyn/tenant-data-admin/server/operator-alerts`. That entry point writes\n * the staff console notification, dedupes a flapping condition, honours the\n * per-type switches staff set on Staff → Operator alerts, and delivers by\n * email (the `operator-alert` system email) and the optional out-of-band\n * webhook. No call site composes or sends its own mail.\n *\n * The catalog holds nothing install-specific: no address, no domain, no\n * host. Recipients come from `resolveStaffAlertRecipients()` and the webhook\n * from `OPERATOR_ALERT_WEBHOOK_URL`, so an entry reads the same on aglyn.com,\n * on a self-hosted install and in an OSS consumer's deployment.\n *\n * Copy is written against merge tokens (`{{orgId}}`), filled from the\n * `context` the call site passes. A token the call site did not supply is\n * blanked, so every sentence must still read when its optional tokens are\n * empty. Never put a data subject's address or other personal data into a\n * context: the alert travels to an inbox and a webhook, not only the console.\n */\n\n/**\n * How much an alert matters.\n *\n * - `must` — money moving with nobody looking, a legal duty unmet, data not\n *   protected or not erased. On and immediate unless staff change it.\n * - `should` — a fault an operator wants to know about today.\n * - `low` — routine review work; on, and batched into the daily digest.\n */\nexport type OperatorAlertTier = 'must' | 'should' | 'low'\n\nexport type OperatorAlertCategory =\n  | 'billing'\n  | 'payments'\n  | 'legal'\n  | 'data'\n  | 'ops'\n  | 'deliverability'\n  | 'security'\n  | 'support'\n\n/** `digest` batches the alert into the once-a-day operator digest. */\nexport type OperatorAlertDelivery = 'immediate' | 'digest'\n\nexport interface OperatorAlertDefinition {\n  /**\n   * Stable id, also the key of its settings row. Never rename: staff\n   * switches are stored under it. A plugin's types start with its plugin id\n   * and a dot (`commerce.taxNotReversed`).\n   */\n  type: string\n  /** The settings row's name. */\n  label: string\n  /** What it means and the first thing to do, for the settings page. */\n  description: string\n  tier: OperatorAlertTier\n  category: OperatorAlertCategory\n  /** The notification title and email subject, with `{{tokens}}`. */\n  title: string\n  /** What happened and what to do, with `{{tokens}}`. */\n  body: string\n  /** Console path the alert opens, with `{{tokens}}`; the call may override. */\n  link?: string\n  /** The coded default; staff may change it. */\n  delivery: OperatorAlertDelivery\n  /**\n   * How long one `dedupeKey` stays quiet after it fired, in minutes. A\n   * condition that flaps inside the window is told once. `0` never dedupes.\n   * A call without a `dedupeKey` is never deduped.\n   */\n  dedupeWindowMinutes: number\n  /**\n   * Fire only once the same `dedupeKey` has been raised this many times\n   * inside the window — for an endpoint any stranger can hit, where one\n   * refused request is noise and several are a broken secret. Default 1.\n   */\n  minOccurrences?: number\n  /** The coded default; staff may change it. */\n  defaultEnabled: boolean\n  /**\n   * The console notification's type. Absent is the generic\n   * `system.operatorAlert`; a type that already had its own notification\n   * keeps it, so its icon, label and everyone's mutes are unchanged.\n   */\n  notificationType?: AglynNotificationType\n  /** The plugin that contributed it; absent for core's own. */\n  pluginId?: string\n}\n\n/** Values a call site passes for an alert's `{{tokens}}`. */\nexport type OperatorAlertContext = Readonly<\n  Record<string, string | number | boolean | null | undefined>\n>\n\n/** The notification type an alert without its own writes under. */\nexport const OPERATOR_ALERT_DEFAULT_NOTIFICATION_TYPE: AglynNotificationType =\n  'system.operatorAlert'\n\nexport const OPERATOR_ALERT_TIER_LABELS: Record<OperatorAlertTier, string> = {\n  must: 'Must know',\n  should: 'Should know',\n  low: 'Routine',\n}\n\nexport const OPERATOR_ALERT_CATEGORY_LABELS: Record<\n  OperatorAlertCategory,\n  string\n> = {\n  billing: 'Billing',\n  payments: 'Payments & payouts',\n  legal: 'Legal',\n  data: 'Data protection',\n  ops: 'Operations',\n  deliverability: 'Email deliverability',\n  security: 'Security',\n  support: 'Support',\n}\n\nconst DAY = 24 * 60\n\n/**\n * Core's alerts. Plugins contribute theirs through the plugin-manager\n * registry; nothing plugin-specific belongs in this list.\n */\nexport const CORE_OPERATOR_ALERTS: readonly OperatorAlertDefinition[] = [\n  // ── Fraud, risk and legal duties already alerting before AGL-3377 ──────\n  {\n    type: 'system.abuseReportUrgent',\n    label: 'Urgent abuse, fraud or risk alert',\n    description:\n      'Phishing, malware or CSAM reported on a site, card testing, a flagged or disputed payment, a held phishing email, a seller under review. Review it on Staff → Abuse reports.',\n    tier: 'must',\n    category: 'security',\n    title: '{{title}}',\n    body: '{{body}}',\n    link: '/admin/abuse-reports',\n    delivery: 'immediate',\n    dedupeWindowMinutes: 0,\n    defaultEnabled: true,\n    notificationType: 'system.abuseReportUrgent',\n  },\n  {\n    type: 'system.disputeUnattributed',\n    label: 'Card dispute with no owner',\n    description:\n      'A chargeback arrived that no subscription, order or marketplace purchase claimed, so nothing is answering it. Find the charge in Stripe and respond before the evidence deadline.',\n    tier: 'must',\n    category: 'billing',\n    title: '{{title}}',\n    body: '{{body}}',\n    delivery: 'immediate',\n    dedupeWindowMinutes: 0,\n    defaultEnabled: true,\n    notificationType: 'system.disputeUnattributed',\n  },\n  {\n    type: 'system.dmcaCounterNotice',\n    label: 'DMCA counter-notice',\n    description:\n      'A customer contested a takedown. The statutory clock is already running; forward it to the complainant and restore on time unless they file suit.',\n    tier: 'must',\n    category: 'legal',\n    title: '{{title}}',\n    body: '{{body}}',\n    delivery: 'immediate',\n    dedupeWindowMinutes: 0,\n    defaultEnabled: true,\n    notificationType: 'system.dmcaCounterNotice',\n  },\n  {\n    type: 'system.billingWebhookHalfApplied',\n    label: 'Billing webhook half applied',\n    description:\n      'A Stripe event threw after its handlers began, so its effects may be partly applied and Stripe will not retry it. Reconcile the event by hand.',\n    tier: 'must',\n    category: 'billing',\n    title: '{{title}}',\n    body: '{{body}}',\n    delivery: 'immediate',\n    dedupeWindowMinutes: 0,\n    defaultEnabled: true,\n    notificationType: 'system.billingWebhookHalfApplied',\n  },\n\n  // ── MUST: billing ───────────────────────────────────────────────────────\n  {\n    type: 'billing.platformDisputeLost',\n    label: 'Subscription dispute lost',\n    description:\n      'A card dispute on a workspace subscription closed as lost: the money has been taken back. Decide whether the workspace keeps its plan.',\n    tier: 'must',\n    category: 'billing',\n    title: 'Subscription dispute lost on workspace {{orgId}}',\n    body:\n      'The card dispute {{disputeId}} on invoice {{invoiceId}} closed as lost ({{reason}}), and {{amount}} was taken back. The workspace keeps its plan until somebody decides otherwise.',\n    link: '/admin/orgs/{{orgId}}',\n    delivery: 'immediate',\n    dedupeWindowMinutes: 30 * DAY,\n    defaultEnabled: true,\n  },\n  {\n    type: 'billing.orphanedSubscription',\n    label: 'Stripe is billing a workspace that does not exist',\n    description:\n      'A subscription names a workspace that was deleted or erased, so the customer keeps being charged for nothing. Cancel or refund it in Stripe.',\n    tier: 'must',\n    category: 'billing',\n    title: 'Subscription bills a missing workspace',\n    body:\n      'Stripe subscription {{subscriptionId}} (customer {{customerId}}, plan {{plan}}) names workspace {{orgId}}, which {{reason}}. The {{eventType}} event changed nothing. Cancel or refund it in Stripe.',\n    delivery: 'immediate',\n    dedupeWindowMinutes: DAY,\n    defaultEnabled: true,\n  },\n  {\n    type: 'billing.usageNotReported',\n    label: 'Metered usage not reported to Stripe',\n    description:\n      'A closed month measured billable usage and it reached no invoice. Report it to Stripe by hand or the revenue is lost.',\n    tier: 'must',\n    category: 'billing',\n    title: 'Usage for {{month}} not billed on {{orgId}}',\n    body:\n      'The closed month {{month}} measured {{amount}} of billable usage on workspace {{orgId}}, and it was not reported to Stripe ({{reason}}). Nothing will invoice it until somebody does.',\n    link: '/admin/orgs/{{orgId}}',\n    delivery: 'immediate',\n    dedupeWindowMinutes: 7 * DAY,\n    defaultEnabled: true,\n  },\n  {\n    type: 'billing.webhookSignatureRejected',\n    label: 'Billing webhook failing its signature check',\n    description:\n      'Repeated deliveries to the billing webhook were refused because their signature did not match. Usually a rolled signing secret: until it is fixed, Stripe cannot tell the install about money.',\n    tier: 'must',\n    category: 'billing',\n    title: 'Billing webhook is refusing deliveries',\n    body:\n      'The billing webhook refused several signed deliveries within six hours because their Stripe signature matched none of the configured secrets. If Stripe is the sender, its signing secret no longer matches this install’s, and no billing event is being applied.',\n    link: '/admin/health',\n    delivery: 'immediate',\n    dedupeWindowMinutes: 6 * 60,\n    minOccurrences: 3,\n    defaultEnabled: true,\n  },\n  {\n    type: 'billing.webhookInert',\n    label: 'Billing webhook delivery moved nothing',\n    description:\n      'Stripe delivered an event this install subscribed to, and no handler did anything with it. Usually a handler that stopped being registered.',\n    tier: 'must',\n    category: 'billing',\n    title: 'A {{eventType}} delivery changed nothing',\n    body:\n      'Stripe event {{eventId}} ({{eventType}}) was accepted and no handler acted on it. Check which handler stopped being registered, then replay the event.',\n    link: '/admin/health',\n    delivery: 'immediate',\n    dedupeWindowMinutes: 6 * 60,\n    defaultEnabled: true,\n  },\n\n  // ── MUST: data protection and records ───────────────────────────────────\n  {\n    type: 'data.personErasureFailed',\n    label: 'Personal data erasure failed',\n    description:\n      'A data subject’s erasure request failed. It will be retried, but the legal deadline keeps running: read the error and fix the cause.',\n    tier: 'must',\n    category: 'data',\n    title: 'Erasure request {{requestId}} failed',\n    body:\n      'The erasure request {{requestId}} on workspace {{orgId}} failed (attempt {{attempt}}): {{error}}. The statutory deadline keeps running while it retries.',\n    delivery: 'immediate',\n    dedupeWindowMinutes: DAY,\n    defaultEnabled: true,\n  },\n  {\n    type: 'data.orgErasureFailed',\n    label: 'Workspace erasure failed',\n    description:\n      'A workspace scheduled for erasure could not be erased. Its data is still held after the date it was promised gone.',\n    tier: 'must',\n    category: 'data',\n    title: 'Workspace {{orgId}} could not be erased',\n    body:\n      'The scheduled erasure of workspace {{orgName}} ({{orgId}}) did not complete: {{reason}}. It will be retried on the next run; its data is held until it succeeds.',\n    link: '/admin/orgs/{{orgId}}',\n    delivery: 'immediate',\n    dedupeWindowMinutes: DAY,\n    defaultEnabled: true,\n  },\n  {\n    type: 'data.backupExportFailed',\n    label: 'Database export failed',\n    description:\n      'The scheduled database export did not start. A stale export means the worst day has nothing to restore from.',\n    tier: 'must',\n    category: 'data',\n    title: 'Database export failed',\n    body:\n      'The scheduled database export did not start ({{reason}}). The last good export is getting older; check the service account’s export permission and the bucket.',\n    link: '/admin/health',\n    delivery: 'immediate',\n    dedupeWindowMinutes: 12 * 60,\n    defaultEnabled: true,\n  },\n\n  // ── MUST: legal ─────────────────────────────────────────────────────────\n  {\n    type: 'legal.abuseReportHigh',\n    label: 'Takedown, impersonation or illegal-content report',\n    description:\n      'A DMCA takedown, impersonation or illegal-content report. Each carries a response duty; review it on Staff → Abuse reports.',\n    tier: 'must',\n    category: 'legal',\n    title: '{{category}} report on {{site}}',\n    body:\n      '{{site}} was reported for {{category}}. Reference {{reference}}. Review it and respond within the policy’s window.',\n    link: '/admin/abuse-reports',\n    delivery: 'immediate',\n    dedupeWindowMinutes: 0,\n    defaultEnabled: true,\n  },\n\n  // ── MUST/SHOULD: health ─────────────────────────────────────────────────\n  {\n    type: 'system.healthDegraded',\n    label: 'Health check degraded',\n    description:\n      'A health check went from healthy to degraded: scheduled jobs silent, backups stale, billing deliveries failing, sign-ups refused, server errors, a site not rendering. Told once per incident.',\n    tier: 'must',\n    category: 'ops',\n    title: '{{check}} is degraded',\n    body: '{{check}} went from healthy to degraded. {{detail}}',\n    link: '/admin/health',\n    delivery: 'immediate',\n    // A check flapping across the line is told once an hour, not on\n    // every swing.\n    dedupeWindowMinutes: 60,\n    defaultEnabled: true,\n  },\n  {\n    type: 'system.healthRecovered',\n    label: 'Health check recovered',\n    description: 'A degraded health check is healthy again.',\n    tier: 'should',\n    category: 'ops',\n    title: '{{check}} recovered',\n    body: '{{check}} is healthy again after {{duration}}.',\n    link: '/admin/health',\n    delivery: 'immediate',\n    // A check flapping across the line is told once an hour, not on\n    // every swing.\n    dedupeWindowMinutes: 60,\n    defaultEnabled: true,\n  },\n\n  // ── SHOULD: billing ─────────────────────────────────────────────────────\n  {\n    type: 'billing.autoLocked',\n    label: 'Workspace billing locked automatically',\n    description:\n      'A workspace crossed its spend guard and the platform locked its billable activity. Check it is not a false positive before the customer notices.',\n    tier: 'should',\n    category: 'billing',\n    title: 'Billing locked on {{orgName}}',\n    body:\n      'Workspace {{orgName}} ({{orgId}}) was locked automatically: {{reason}}.',\n    link: '/admin/orgs/{{orgId}}',\n    delivery: 'immediate',\n    dedupeWindowMinutes: DAY,\n    defaultEnabled: true,\n  },\n  {\n    type: 'billing.platformInvoiceUncollectible',\n    label: 'Subscription invoice voided or uncollectible',\n    description:\n      'A workspace invoice was voided or marked uncollectible: revenue the books expected is not coming.',\n    tier: 'should',\n    category: 'billing',\n    title: 'Invoice {{status}} on {{orgId}}',\n    body:\n      'Invoice {{invoiceId}} for {{amount}} on workspace {{orgId}} was marked {{status}}.',\n    link: '/admin/orgs/{{orgId}}',\n    delivery: 'immediate',\n    dedupeWindowMinutes: 30 * DAY,\n    defaultEnabled: true,\n  },\n  {\n    type: 'billing.connectPayoutFailed',\n    label: 'Connected account payout or transfer failed',\n    description:\n      'Money due to a merchant or seller did not arrive. Stripe retries on its own schedule; a human decides what happens next.',\n    tier: 'should',\n    category: 'billing',\n    title: 'A {{kind}} to {{account}} failed',\n    body:\n      'Stripe {{kind}} {{stripeId}} to connected account {{account}} failed ({{reason}}). The merchant’s funds are not where the ledger says.',\n    delivery: 'immediate',\n    dedupeWindowMinutes: 30 * DAY,\n    defaultEnabled: true,\n  },\n  {\n    type: 'staff.paymentFailed',\n    label: 'Workspace payment failed',\n    description:\n      'A paying workspace’s renewal failed. Stripe is retrying; the customer has been told.',\n    tier: 'should',\n    category: 'billing',\n    title: '{{title}}',\n    body: '{{body}}',\n    delivery: 'immediate',\n    dedupeWindowMinutes: 0,\n    defaultEnabled: true,\n    notificationType: 'staff.paymentFailed',\n  },\n\n  // ── SHOULD: security ────────────────────────────────────────────────────\n  {\n    type: 'security.staffGranted',\n    label: 'Staff access granted or raised',\n    description:\n      'Somebody was made staff, or a staff role was raised. If nobody on the team did it, revoke it and rotate credentials.',\n    tier: 'should',\n    category: 'security',\n    title: '{{target}} is now {{role}} staff',\n    body: '{{actor}} granted {{target}} the {{role}} staff role (was {{previous}}).',\n    link: '/admin/users',\n    delivery: 'immediate',\n    dedupeWindowMinutes: 0,\n    defaultEnabled: true,\n  },\n\n  // ── SHOULD: support ─────────────────────────────────────────────────────\n  {\n    type: 'support.slaBreached',\n    label: 'Support ticket past its response time',\n    description:\n      'A support ticket passed its promised response time without a staff reply.',\n    tier: 'should',\n    category: 'support',\n    title: 'Ticket past its response time: {{subject}}',\n    body:\n      'The {{tier}} ticket “{{subject}}” on workspace {{orgId}} was due a first response {{overdue}} ago and has none.',\n    link: '/admin/support',\n    delivery: 'immediate',\n    dedupeWindowMinutes: DAY,\n    defaultEnabled: true,\n  },\n  {\n    type: 'support.ticketOpened',\n    label: 'New support ticket',\n    description: 'A subscriber opened a support ticket.',\n    tier: 'should',\n    category: 'support',\n    title: '{{title}}',\n    body: '{{body}}',\n    delivery: 'digest',\n    dedupeWindowMinutes: 0,\n    defaultEnabled: true,\n    notificationType: 'support.ticketOpened',\n  },\n  {\n    type: 'support.ticketReply',\n    label: 'Support ticket reply',\n    description: 'A subscriber replied on a support ticket.',\n    tier: 'should',\n    category: 'support',\n    title: '{{title}}',\n    body: '{{body}}',\n    delivery: 'digest',\n    dedupeWindowMinutes: 0,\n    defaultEnabled: true,\n    notificationType: 'support.ticketReply',\n  },\n\n  // ── SHOULD: deliverability ──────────────────────────────────────────────\n  {\n    type: 'deliverability.sendRateSaturated',\n    label: 'Email send-rate governor saturated',\n    description:\n      'The platform’s email send-rate budget is exhausted, so sends are being deferred. Raise the budget or find the sender filling it.',\n    tier: 'should',\n    category: 'deliverability',\n    title: 'Email sending is being throttled',\n    body:\n      'The {{scope}} send-rate budget is full ({{detail}}), so sends are being deferred.',\n    link: '/admin/emails',\n    delivery: 'immediate',\n    dedupeWindowMinutes: 6 * 60,\n    defaultEnabled: true,\n  },\n  {\n    type: 'deliverability.sendRateUnavailable',\n    label: 'Email send-rate governor unavailable',\n    description:\n      'The send-rate governor could not read its counters, so mail is going out unmetered: nothing is holding the shared domains under their hourly ceiling.',\n    tier: 'should',\n    category: 'deliverability',\n    title: 'Email send-rate governor unavailable',\n    body:\n      'The send-rate governor could not read its counters ({{error}}), so sends are being allowed unmetered until it can.',\n    link: '/admin/emails',\n    delivery: 'immediate',\n    dedupeWindowMinutes: 6 * 60,\n    defaultEnabled: true,\n  },\n  {\n    type: 'deliverability.gatewayBlocking',\n    label: 'A recipient gateway is blocking the shared domain',\n    description:\n      'A mail gateway is refusing mail from the shared sending domain, so everyone behind that gateway stops receiving it.',\n    tier: 'should',\n    category: 'deliverability',\n    title: '{{gateway}} is blocking {{domain}}',\n    body:\n      'Mail from {{domain}} is being refused by {{gateway}} ({{detail}}). Recipients behind that gateway are not receiving it.',\n    link: '/admin/emails',\n    delivery: 'immediate',\n    dedupeWindowMinutes: DAY,\n    defaultEnabled: true,\n  },\n  {\n    type: 'deliverability.providerCredentialsRejected',\n    label: 'Email provider rejected the credentials',\n    description:\n      'The email provider refused the API key, or a sending pool is unhealthy: invites, password resets and receipts are not leaving. The webhook channel is the one that still reaches you.',\n    tier: 'should',\n    category: 'deliverability',\n    title: 'Email delivery is failing: {{problem}}',\n    body: '{{detail}}',\n    link: '/admin/emails',\n    delivery: 'immediate',\n    dedupeWindowMinutes: 6 * 60,\n    defaultEnabled: true,\n  },\n\n  // ── SHOULD: operations ──────────────────────────────────────────────────\n  {\n    type: 'ops.reaperStuck',\n    label: 'A reaper is stuck or failing',\n    description:\n      'A cleanup job (sending domains, unverified workspaces) could not finish, so what it removes keeps accumulating.',\n    tier: 'should',\n    category: 'ops',\n    title: '{{job}} is stuck',\n    body: '{{job}} could not finish: {{detail}}',\n    delivery: 'immediate',\n    dedupeWindowMinutes: DAY,\n    defaultEnabled: true,\n  },\n  {\n    type: 'ops.pluginJobFailed',\n    label: 'A plugin job failed',\n    description:\n      'A plugin’s scheduled job threw: consent-group changes, the publish outbox, sending-domain provisioning, a plugin cron.',\n    tier: 'should',\n    category: 'ops',\n    title: '{{job}} failed',\n    body: 'The scheduled job {{job}} failed: {{error}}',\n    delivery: 'immediate',\n    dedupeWindowMinutes: 6 * 60,\n    defaultEnabled: true,\n  },\n  {\n    type: 'system.pluginVerifierRegression',\n    label: 'Plugin verifier regression',\n    description:\n      'A live plugin version stopped passing the static verifier.',\n    tier: 'should',\n    category: 'security',\n    title: '{{title}}',\n    body: '{{body}}',\n    delivery: 'immediate',\n    dedupeWindowMinutes: 0,\n    defaultEnabled: true,\n    notificationType: 'system.pluginVerifierRegression',\n  },\n  {\n    type: 'system.bandwidthCeilingTripped',\n    label: 'Bandwidth ceiling reached',\n    description:\n      'A site crossed the per-month bandwidth abuse ceiling.',\n    tier: 'should',\n    category: 'ops',\n    title: '{{title}}',\n    body: '{{body}}',\n    delivery: 'immediate',\n    dedupeWindowMinutes: 0,\n    defaultEnabled: true,\n    notificationType: 'system.bandwidthCeilingTripped',\n  },\n\n  // ── LOW ─────────────────────────────────────────────────────────────────\n  {\n    type: 'marketplace.review',\n    label: 'Plugin listing waiting for review',\n    description: 'A plugin listing or version was submitted for review.',\n    tier: 'low',\n    category: 'security',\n    title: '{{title}}',\n    body: '{{body}}',\n    delivery: 'digest',\n    dedupeWindowMinutes: 0,\n    defaultEnabled: true,\n    notificationType: 'marketplace.review',\n  },\n  {\n    type: 'system.scopeDrift',\n    label: 'Resources missing a sharing scope',\n    description:\n      'The weekly sweep found documents invisible to every site-scoped read: a creation path forgot the field.',\n    tier: 'low',\n    category: 'data',\n    title: '{{title}}',\n    body: '{{body}}',\n    delivery: 'digest',\n    dedupeWindowMinutes: 0,\n    defaultEnabled: true,\n    notificationType: 'system.scopeDrift',\n  },\n]\n\n/** An amount in minor units, as an alert prints it: `$12.40`. */\nexport function formatOperatorAlertAmount(\n  cents: number,\n  currency = 'usd',\n): string {\n  const value = Number(cents) / 100\n  if (!Number.isFinite(value)) return ''\n  try {\n    return new Intl.NumberFormat('en-US', {\n      style: 'currency',\n      currency: String(currency || 'usd').toUpperCase(),\n    }).format(value)\n  } catch {\n    return `${value.toFixed(2)} ${String(currency).toUpperCase()}`\n  }\n}\n\n/** Replaces each `{{token}}` with its context value, or nothing. */\nexport function renderOperatorAlertTemplate(\n  template: string,\n  context: OperatorAlertContext | undefined,\n): string {\n  return String(template ?? '')\n    .replace(/\\{\\{\\s*([\\w.]+)\\s*\\}\\}/g, (_match, name: string) => {\n      const value = context?.[name]\n      return value === null || value === undefined ? '' : String(value)\n    })\n    .replace(/\\(\\s*\\)/g, '')\n    .replace(/[ \\t]{2,}/g, ' ')\n    .replace(/ ([.,;:])/g, '$1')\n    .trim()\n}\n\n/** A staff member's answer for one type; an absent key keeps the default. */\nexport interface OperatorAlertTypeSetting {\n  enabled?: boolean\n  delivery?: OperatorAlertDelivery\n}\n\n/** `platformSettings/operatorAlerts`, keyed by alert type. */\nexport interface OperatorAlertSettings {\n  types?: Record<string, OperatorAlertTypeSetting>\n}\n\n/** Whether a type is on, and how it is delivered, after staff's answers. */\nexport function effectiveOperatorAlertSetting(\n  definition: Pick<OperatorAlertDefinition, 'type' | 'delivery' | 'defaultEnabled'>,\n  settings: OperatorAlertSettings | null | undefined,\n): { enabled: boolean; delivery: OperatorAlertDelivery } {\n  const answer = settings?.types?.[definition.type]\n  return {\n    enabled:\n      typeof answer?.enabled === 'boolean'\n        ? answer.enabled\n        : definition.defaultEnabled,\n    delivery:\n      answer?.delivery === 'immediate' || answer?.delivery === 'digest'\n        ? answer.delivery\n        : definition.delivery,\n  }\n}\n\n/**\n * Staff notification types whose alert emails the operator on a coded\n * default of immediate (AGL-3375), derived from the catalog so there is one\n * list.\n */\nexport const OPERATOR_ALERT_NOTIFICATION_TYPES: ReadonlySet<string> = new Set(\n  CORE_OPERATOR_ALERTS.flatMap((definition) =>\n    definition.notificationType ? [definition.notificationType] : [],\n  ),\n)\n"],"names":["OPERATOR_ALERT_DEFAULT_NOTIFICATION_TYPE","OPERATOR_ALERT_TIER_LABELS","must","should","low","OPERATOR_ALERT_CATEGORY_LABELS","billing","payments","legal","data","ops","deliverability","security","support","DAY","CORE_OPERATOR_ALERTS","type","label","description","tier","category","title","body","link","delivery","dedupeWindowMinutes","defaultEnabled","notificationType","minOccurrences","formatOperatorAlertAmount","cents","currency","value","Number","isFinite","Intl","NumberFormat","style","String","toUpperCase","format","toFixed","renderOperatorAlertTemplate","template","context","replace","_match","name","undefined","trim","effectiveOperatorAlertSetting","definition","settings","answer","types","enabled","OPERATOR_ALERT_NOTIFICATION_TYPES","Set","flatMap"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAsGD,iEAAiE,GACjE,OAAO,MAAMA,2CACX,uBAAsB;AAExB,OAAO,MAAMC,6BAAgE;IAC3EC,MAAM;IACNC,QAAQ;IACRC,KAAK;AACP,EAAC;AAED,OAAO,MAAMC,iCAGT;IACFC,SAAS;IACTC,UAAU;IACVC,OAAO;IACPC,MAAM;IACNC,KAAK;IACLC,gBAAgB;IAChBC,UAAU;IACVC,SAAS;AACX,EAAC;AAED,MAAMC,MAAM,KAAK;AAEjB;;;CAGC,GACD,OAAO,MAAMC,uBAA2D;IACtE,0EAA0E;IAC1E;QACEC,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MAAM;QACNC,MAAM;QACNC,UAAU;QACVC,qBAAqB;QACrBC,gBAAgB;QAChBC,kBAAkB;IACpB;IACA;QACEX,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MAAM;QACNE,UAAU;QACVC,qBAAqB;QACrBC,gBAAgB;QAChBC,kBAAkB;IACpB;IACA;QACEX,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MAAM;QACNE,UAAU;QACVC,qBAAqB;QACrBC,gBAAgB;QAChBC,kBAAkB;IACpB;IACA;QACEX,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MAAM;QACNE,UAAU;QACVC,qBAAqB;QACrBC,gBAAgB;QAChBC,kBAAkB;IACpB;IAEA,2EAA2E;IAC3E;QACEX,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MACE;QACFC,MAAM;QACNC,UAAU;QACVC,qBAAqB,KAAKX;QAC1BY,gBAAgB;IAClB;IACA;QACEV,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MACE;QACFE,UAAU;QACVC,qBAAqBX;QACrBY,gBAAgB;IAClB;IACA;QACEV,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MACE;QACFC,MAAM;QACNC,UAAU;QACVC,qBAAqB,IAAIX;QACzBY,gBAAgB;IAClB;IACA;QACEV,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MACE;QACFC,MAAM;QACNC,UAAU;QACVC,qBAAqB,IAAI;QACzBG,gBAAgB;QAChBF,gBAAgB;IAClB;IACA;QACEV,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MACE;QACFC,MAAM;QACNC,UAAU;QACVC,qBAAqB,IAAI;QACzBC,gBAAgB;IAClB;IAEA,2EAA2E;IAC3E;QACEV,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MACE;QACFE,UAAU;QACVC,qBAAqBX;QACrBY,gBAAgB;IAClB;IACA;QACEV,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MACE;QACFC,MAAM;QACNC,UAAU;QACVC,qBAAqBX;QACrBY,gBAAgB;IAClB;IACA;QACEV,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MACE;QACFC,MAAM;QACNC,UAAU;QACVC,qBAAqB,KAAK;QAC1BC,gBAAgB;IAClB;IAEA,2EAA2E;IAC3E;QACEV,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MACE;QACFC,MAAM;QACNC,UAAU;QACVC,qBAAqB;QACrBC,gBAAgB;IAClB;IAEA,2EAA2E;IAC3E;QACEV,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MAAM;QACNC,MAAM;QACNC,UAAU;QACV,gEAAgE;QAChE,eAAe;QACfC,qBAAqB;QACrBC,gBAAgB;IAClB;IACA;QACEV,MAAM;QACNC,OAAO;QACPC,aAAa;QACbC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MAAM;QACNC,MAAM;QACNC,UAAU;QACV,gEAAgE;QAChE,eAAe;QACfC,qBAAqB;QACrBC,gBAAgB;IAClB;IAEA,2EAA2E;IAC3E;QACEV,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MACE;QACFC,MAAM;QACNC,UAAU;QACVC,qBAAqBX;QACrBY,gBAAgB;IAClB;IACA;QACEV,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MACE;QACFC,MAAM;QACNC,UAAU;QACVC,qBAAqB,KAAKX;QAC1BY,gBAAgB;IAClB;IACA;QACEV,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MACE;QACFE,UAAU;QACVC,qBAAqB,KAAKX;QAC1BY,gBAAgB;IAClB;IACA;QACEV,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MAAM;QACNE,UAAU;QACVC,qBAAqB;QACrBC,gBAAgB;QAChBC,kBAAkB;IACpB;IAEA,2EAA2E;IAC3E;QACEX,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MAAM;QACNC,MAAM;QACNC,UAAU;QACVC,qBAAqB;QACrBC,gBAAgB;IAClB;IAEA,2EAA2E;IAC3E;QACEV,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MACE;QACFC,MAAM;QACNC,UAAU;QACVC,qBAAqBX;QACrBY,gBAAgB;IAClB;IACA;QACEV,MAAM;QACNC,OAAO;QACPC,aAAa;QACbC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MAAM;QACNE,UAAU;QACVC,qBAAqB;QACrBC,gBAAgB;QAChBC,kBAAkB;IACpB;IACA;QACEX,MAAM;QACNC,OAAO;QACPC,aAAa;QACbC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MAAM;QACNE,UAAU;QACVC,qBAAqB;QACrBC,gBAAgB;QAChBC,kBAAkB;IACpB;IAEA,2EAA2E;IAC3E;QACEX,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MACE;QACFC,MAAM;QACNC,UAAU;QACVC,qBAAqB,IAAI;QACzBC,gBAAgB;IAClB;IACA;QACEV,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MACE;QACFC,MAAM;QACNC,UAAU;QACVC,qBAAqB,IAAI;QACzBC,gBAAgB;IAClB;IACA;QACEV,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MACE;QACFC,MAAM;QACNC,UAAU;QACVC,qBAAqBX;QACrBY,gBAAgB;IAClB;IACA;QACEV,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MAAM;QACNC,MAAM;QACNC,UAAU;QACVC,qBAAqB,IAAI;QACzBC,gBAAgB;IAClB;IAEA,2EAA2E;IAC3E;QACEV,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MAAM;QACNE,UAAU;QACVC,qBAAqBX;QACrBY,gBAAgB;IAClB;IACA;QACEV,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MAAM;QACNE,UAAU;QACVC,qBAAqB,IAAI;QACzBC,gBAAgB;IAClB;IACA;QACEV,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MAAM;QACNE,UAAU;QACVC,qBAAqB;QACrBC,gBAAgB;QAChBC,kBAAkB;IACpB;IACA;QACEX,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MAAM;QACNE,UAAU;QACVC,qBAAqB;QACrBC,gBAAgB;QAChBC,kBAAkB;IACpB;IAEA,2EAA2E;IAC3E;QACEX,MAAM;QACNC,OAAO;QACPC,aAAa;QACbC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MAAM;QACNE,UAAU;QACVC,qBAAqB;QACrBC,gBAAgB;QAChBC,kBAAkB;IACpB;IACA;QACEX,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,MAAM;QACNC,UAAU;QACVC,OAAO;QACPC,MAAM;QACNE,UAAU;QACVC,qBAAqB;QACrBC,gBAAgB;QAChBC,kBAAkB;IACpB;CACD,CAAA;AAED,+DAA+D,GAC/D,OAAO,SAASE,0BACdC,KAAa,EACbC,WAAW,KAAK;IAEhB,MAAMC,QAAQC,OAAOH,SAAS;IAC9B,IAAI,CAACG,OAAOC,QAAQ,CAACF,QAAQ,OAAO;IACpC,IAAI;QACF,OAAO,IAAIG,KAAKC,YAAY,CAAC,SAAS;YACpCC,OAAO;YACPN,UAAUO,OAAOP,YAAY,OAAOQ,WAAW;QACjD,GAAGC,MAAM,CAACR;IACZ,EAAE,eAAM;QACN,OAAO,GAAGA,MAAMS,OAAO,CAAC,GAAG,CAAC,EAAEH,OAAOP,UAAUQ,WAAW,IAAI;IAChE;AACF;AAEA,kEAAkE,GAClE,OAAO,SAASG,4BACdC,QAAgB,EAChBC,OAAyC;IAEzC,OAAON,OAAOK,mBAAAA,WAAY,IACvBE,OAAO,CAAC,2BAA2B,CAACC,QAAQC;QAC3C,MAAMf,QAAQY,2BAAAA,OAAS,CAACG,KAAK;QAC7B,OAAOf,UAAU,QAAQA,UAAUgB,YAAY,KAAKV,OAAON;IAC7D,GACCa,OAAO,CAAC,YAAY,IACpBA,OAAO,CAAC,cAAc,KACtBA,OAAO,CAAC,cAAc,MACtBI,IAAI;AACT;AAaA,0EAA0E,GAC1E,OAAO,SAASC,8BACdC,UAAiF,EACjFC,QAAkD;QAEnCA;IAAf,MAAMC,SAASD,6BAAAA,kBAAAA,SAAUE,KAAK,qBAAfF,eAAiB,CAACD,WAAWnC,IAAI,CAAC;IACjD,OAAO;QACLuC,SACE,QAAOF,0BAAAA,OAAQE,OAAO,MAAK,YACvBF,OAAOE,OAAO,GACdJ,WAAWzB,cAAc;QAC/BF,UACE6B,CAAAA,0BAAAA,OAAQ7B,QAAQ,MAAK,eAAe6B,CAAAA,0BAAAA,OAAQ7B,QAAQ,MAAK,WACrD6B,OAAO7B,QAAQ,GACf2B,WAAW3B,QAAQ;IAC3B;AACF;AAEA;;;;CAIC,GACD,OAAO,MAAMgC,oCAAyD,IAAIC,IACxE1C,qBAAqB2C,OAAO,CAAC,CAACP,aAC5BA,WAAWxB,gBAAgB,GAAG;QAACwB,WAAWxB,gBAAgB;KAAC,GAAG,EAAE,GAEnE"}

package/src/lib/app-utils/screen-link-value.d.ts

@@ -164,6 +164,10 @@ export declare function screenRoutesAnswerFor(screens: ScreenRouteMap | undefine
  * Navigable protocols only. A stored `javascript:`/`data:` href would
  * execute in visitors' browsers, so the guard the linking components each
  * carried is here instead — one copy, one place to harden.
+ *
+ * `sms:` sits beside `tel:` (AGL-3388): it opens the visitor's messaging app
+ * and executes nothing, the same list `safe-url-scheme.ts` keeps. Leaving it
+ * out rendered every "Text us" button as a button with no link.
  */
 export declare const SAFE_HREF_PATTERN: RegExp;
 /** Of those, the ones that actually leave the site (new-tab decisions). */

package/src/lib/app-utils/screen-link-value.js

@@ -206,8 +206,12 @@
  * Navigable protocols only. A stored `javascript:`/`data:` href would
  * execute in visitors' browsers, so the guard the linking components each
  * carried is here instead — one copy, one place to harden.
- */ export const SAFE_HREF_PATTERN = /^(https?:\/\/|mailto:|tel:|\/|#)/i;
-/** Of those, the ones that actually leave the site (new-tab decisions). */ export const EXTERNAL_HREF_PATTERN = /^(https?:\/\/|mailto:|tel:)/i;
+ *
+ * `sms:` sits beside `tel:` (AGL-3388): it opens the visitor's messaging app
+ * and executes nothing, the same list `safe-url-scheme.ts` keeps. Leaving it
+ * out rendered every "Text us" button as a button with no link.
+ */ export const SAFE_HREF_PATTERN = /^(https?:\/\/|mailto:|tel:|sms:|\/|#)/i;
+/** Of those, the ones that actually leave the site (new-tab decisions). */ export const EXTERNAL_HREF_PATTERN = /^(https?:\/\/|mailto:|tel:|sms:)/i;
 /**
  * The id a link value jumps to when a fragment is ALL it holds — `#watch`
  * gives `watch` — or `undefined` for any other value (AGL-2867).