@aglyn/tenant-data-admin 1.0.0-beta.218 → 1.0.0-beta.220

package/src/lib/server/operator-alerts.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../../libs/tenant/data/admin/src/lib/server/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 { createHash, createHmac } from 'node:crypto'\nimport {\n  effectiveOperatorAlertSetting,\n  OPERATOR_ALERT_DEFAULT_NOTIFICATION_TYPE,\n  OPERATOR_ALERT_TIER_LABELS,\n  renderOperatorAlertTemplate,\n  type AglynNotificationType,\n  type OperatorAlertContext,\n  type OperatorAlertDefinition,\n  type OperatorAlertSettings,\n  type OperatorAlertTypeSetting,\n} from '@aglyn/aglyn/server'\nimport {\n  getOperatorAlert,\n  registerOperatorAlerts,\n} from '@aglyn/aglyn/plugin-manager/operator-alerts'\nimport { createResourceUid } from '@aglyn/aglyn/app-utils/create-resource-uid'\nimport { isEmailConfigured, type SendEmailResult } from '@aglyn/shared-util-email'\nimport firebaseAdmin from './firebase-admin'\n\n/**\n * RAISING AN OPERATOR ALERT (AGL-3377): the one server entry point every\n * alert in the registry goes through.\n *\n * In order, for one call:\n *\n * 1. The type is looked up in the registry (core's catalog plus what plugins\n *    registered). A plugin may pass its definition itself, which registers\n *    it in this process if its declarations have not loaded yet.\n * 2. A `dedupeKey` is claimed against `operatorAlertState`, so a condition\n *    that flaps inside the type's window is told once, and a type with\n *    `minOccurrences` fires only once it has recurred that often.\n * 3. The staff console notification is written for every staff member, as\n *    `notifyStaff` always has.\n * 4. Staff's switches (`platformSettings/operatorAlerts`, coded defaults\n *    until changed) decide the rest: off is console only, `digest` queues it\n *    for the once-a-day digest, `immediate` emails the operator now.\n * 5. The email is the `operator-alert` system email, to\n *    `resolveStaffAlertRecipients()`; the optional out-of-band webhook\n *    (`OPERATOR_ALERT_WEBHOOK_URL`) gets the same alert beside it, so a mail\n *    provider that is itself the outage still reaches somebody.\n *\n * Never throws: an alert is raised from inside the failure it reports, and a\n * second failure there must not replace the first.\n */\n\n/** Where staff's per-type switches live. */\nexport const OPERATOR_ALERT_SETTINGS_COLLECTION = 'platformSettings'\nexport const OPERATOR_ALERT_SETTINGS_DOC = 'operatorAlerts'\n/** One document per (type, dedupeKey): when it last fired, how often since. */\nexport const OPERATOR_ALERT_STATE_COLLECTION = 'operatorAlertState'\n/** Alerts waiting for the daily digest. */\nexport const OPERATOR_ALERT_DIGEST_COLLECTION = 'operatorAlertDigest'\n\n/** The hour, UTC, the digest goes out when staff have not chosen one. */\nexport const OPERATOR_ALERT_DIGEST_DEFAULT_HOUR_UTC = 14\n\nexport interface OperatorAlertSettingsDoc extends OperatorAlertSettings {\n  /** The hour of the day, UTC, the digest is sent. */\n  digestHourUtc?: number\n  updatedAtMs?: number\n  updatedByEmail?: string | null\n}\n\nexport interface RaiseOperatorAlertOptions {\n  /**\n   * What makes two raises the SAME alert — a dispute id, an org and month, a\n   * check id. Absent never dedupes: every raise is told.\n   */\n  dedupeKey?: string\n  /** Values for the definition's `{{tokens}}`. Never personal data. */\n  context?: OperatorAlertContext\n  /** A console path or absolute URL; overrides the definition's link. */\n  url?: string\n  /** The title as written by the caller; overrides the rendered one. */\n  subject?: string\n  /** The body as written by the caller; overrides the rendered one. */\n  body?: string\n  orgId?: string\n  hostId?: string\n}\n\nexport type OperatorAlertOutcome =\n  | 'deduped'\n  | 'below-threshold'\n  | 'console-only'\n  | 'queued'\n  | 'delivered'\n  | 'undelivered'\n\nexport interface OperatorAlertResult {\n  outcome: OperatorAlertOutcome\n  type: string\n  email?: SendEmailResult\n  webhook?: OperatorAlertWebhookResult\n}\n\nexport type OperatorAlertWebhookResult =\n  | { posted: true; status: number }\n  | { posted: false; reason: 'unconfigured' | 'refused' | 'network'; status?: number }\n\n/** One alert, rendered, as it is delivered and queued. */\nexport interface RenderedOperatorAlert {\n  type: string\n  label: string\n  tier: OperatorAlertDefinition['tier']\n  category: OperatorAlertDefinition['category']\n  title: string\n  body: string\n  /** Console path or absolute URL; `''` when there is none. */\n  link: string\n  notificationType: AglynNotificationType\n  orgId?: string\n  hostId?: string\n}\n\nconst firestore = () => firebaseAdmin.app().firestore()\n\n// ── Settings ────────────────────────────────────────────────────────────────\n\nconst SETTINGS_TTL_MS = 15_000\nlet settingsCache: { at: number; doc: OperatorAlertSettingsDoc } | undefined\n\n/** Drop the in-process settings cache; the console calls it after a write. */\nexport function invalidateOperatorAlertSettingsCache(): void {\n  settingsCache = undefined\n}\n\n/** Clamps a stored settings document to what the pipeline understands. */\nexport function normalizeOperatorAlertSettings(\n  raw: unknown,\n): OperatorAlertSettingsDoc {\n  const source = (raw && typeof raw === 'object' ? raw : {}) as Record<string, unknown>\n  const types: Record<string, OperatorAlertTypeSetting> = {}\n  const rawTypes = source['types']\n  if (rawTypes && typeof rawTypes === 'object') {\n    for (const [type, value] of Object.entries(rawTypes as Record<string, unknown>)) {\n      if (!type || !value || typeof value !== 'object') continue\n      const entry = value as Record<string, unknown>\n      const setting: OperatorAlertTypeSetting = {}\n      if (typeof entry['enabled'] === 'boolean') setting.enabled = entry['enabled']\n      if (entry['delivery'] === 'immediate' || entry['delivery'] === 'digest') {\n        setting.delivery = entry['delivery']\n      }\n      if (Object.keys(setting).length) types[type] = setting\n    }\n  }\n  const hour = Number(source['digestHourUtc'])\n  return {\n    types,\n    digestHourUtc:\n      Number.isInteger(hour) && hour >= 0 && hour <= 23\n        ? hour\n        : OPERATOR_ALERT_DIGEST_DEFAULT_HOUR_UTC,\n    ...(typeof source['updatedAtMs'] === 'number'\n      ? { updatedAtMs: source['updatedAtMs'] as number }\n      : {}),\n    ...(typeof source['updatedByEmail'] === 'string'\n      ? { updatedByEmail: source['updatedByEmail'] as string }\n      : {}),\n  }\n}\n\n/**\n * Staff's switches. An unreadable document is the coded defaults, uncached:\n * an alert must still go out when the settings cannot be read.\n */\nexport async function readOperatorAlertSettings(): Promise<OperatorAlertSettingsDoc> {\n  const now = Date.now()\n  if (settingsCache && now - settingsCache.at < SETTINGS_TTL_MS) return settingsCache.doc\n  try {\n    const snapshot = await firestore()\n      .collection(OPERATOR_ALERT_SETTINGS_COLLECTION)\n      .doc(OPERATOR_ALERT_SETTINGS_DOC)\n      .get()\n    const doc = normalizeOperatorAlertSettings(snapshot.exists ? snapshot.data() : null)\n    settingsCache = { at: now, doc }\n    return doc\n  } catch (error) {\n    console.error('[operator-alerts] settings unreadable; using the defaults', error)\n    return normalizeOperatorAlertSettings(null)\n  }\n}\n\n// ── Dedupe ──────────────────────────────────────────────────────────────────\n\n/** Keys this instance fired, and until when they stay quiet. */\nconst firedLocally = new Map<string, number>()\nconst FIRED_LOCALLY_MAX = 500\n\nfunction stateDocId(type: string, dedupeKey: string): string {\n  return createHash('sha256').update(`${type}\\u0000${dedupeKey}`).digest('hex').slice(0, 40)\n}\n\nexport type OperatorAlertClaim =\n  | { fire: true; repeats: number }\n  | { fire: false; reason: 'deduped' | 'below-threshold' }\n\n/**\n * Whether a raise with this key fires now. One transaction on the key's\n * state document: inside the window after a fire it is counted and\n * suppressed; before it reaches `minOccurrences` it is counted and held.\n * A store that cannot be read FIRES — a duplicate beats a silence.\n */\nexport async function claimOperatorAlert(\n  definition: Pick<OperatorAlertDefinition, 'type' | 'dedupeWindowMinutes' | 'minOccurrences'>,\n  dedupeKey: string,\n  now = Date.now(),\n): Promise<OperatorAlertClaim> {\n  const windowMs = Math.max(0, definition.dedupeWindowMinutes) * 60_000\n  const minOccurrences = Math.max(1, Math.floor(definition.minOccurrences ?? 1))\n  if (!windowMs) return { fire: true, repeats: 0 }\n  const localKey = `${definition.type}\\u0000${dedupeKey}`\n  const quietUntil = firedLocally.get(localKey)\n  if (quietUntil && quietUntil > now) return { fire: false, reason: 'deduped' }\n  try {\n    const ref = firestore()\n      .collection(OPERATOR_ALERT_STATE_COLLECTION)\n      .doc(stateDocId(definition.type, dedupeKey))\n    const claim = await firestore().runTransaction(async (transaction: any) => {\n      const snapshot = await transaction.get(ref)\n      const state = (snapshot.exists ? snapshot.data() : {}) as Record<string, unknown>\n      const lastFiredAtMs = Number(state['lastFiredAtMs'] ?? 0)\n      const base = { type: definition.type, dedupeKey: dedupeKey.slice(0, 300), updatedAtMs: now }\n      if (lastFiredAtMs && now - lastFiredAtMs < windowMs) {\n        transaction.set(ref, { ...base, suppressed: Number(state['suppressed'] ?? 0) + 1 }, { merge: true })\n        return { fire: false, reason: 'deduped' } as const\n      }\n      const windowStartMs = Number(state['windowStartMs'] ?? 0)\n      const inWindow = windowStartMs && now - windowStartMs < windowMs\n      const occurrences = (inWindow ? Number(state['occurrences'] ?? 0) : 0) + 1\n      if (occurrences < minOccurrences) {\n        transaction.set(\n          ref,\n          { ...base, occurrences, windowStartMs: inWindow ? windowStartMs : now },\n          { merge: true },\n        )\n        return { fire: false, reason: 'below-threshold' } as const\n      }\n      transaction.set(\n        ref,\n        {\n          ...base,\n          lastFiredAtMs: now,\n          occurrences: 0,\n          windowStartMs: 0,\n          suppressed: 0,\n          fired: Number(state['fired'] ?? 0) + 1,\n        },\n        { merge: true },\n      )\n      return { fire: true, repeats: Number(state['suppressed'] ?? 0) } as const\n    })\n    if (claim.fire) {\n      if (firedLocally.size >= FIRED_LOCALLY_MAX) firedLocally.clear()\n      firedLocally.set(localKey, now + windowMs)\n    }\n    return claim\n  } catch (error) {\n    console.error(`[operator-alerts] dedupe unavailable for ${definition.type}; firing`, error)\n    return { fire: true, repeats: 0 }\n  }\n}\n\n// ── Out-of-band webhook ─────────────────────────────────────────────────────\n\nconst WEBHOOK_TIMEOUT_MS = 5_000\n\n/** The webhook URL, when one is configured and is http(s). */\nexport function operatorAlertWebhookUrl(): string {\n  const value = String(process.env['OPERATOR_ALERT_WEBHOOK_URL'] ?? '').trim()\n  return /^https?:\\/\\/\\S+$/i.test(value) ? value : ''\n}\n\n/**\n * The JSON the webhook receives. `text` is what a Slack-compatible incoming\n * webhook renders on its own; `alert` carries the fields for anything that\n * wants to route on them.\n */\nexport function operatorAlertWebhookPayload(\n  alerts: readonly RenderedOperatorAlert[],\n  options: { digest?: boolean; now?: number } = {},\n): Record<string, unknown> {\n  const origin = consoleOrigin()\n  const lines = alerts.map((alert) => {\n    const link = operatorAlertAbsoluteLink(alert.link)\n    return [\n      `[${OPERATOR_ALERT_TIER_LABELS[alert.tier]}] ${alert.title}`,\n      alert.body,\n      link,\n    ]\n      .filter(Boolean)\n      .join('\\n')\n  })\n  const text = options.digest\n    ? [`Operator digest: ${alerts.length} alert${alerts.length === 1 ? '' : 's'}`, ...lines].join('\\n\\n')\n    : lines.join('\\n\\n')\n  const occurredAt = new Date(options.now ?? Date.now()).toISOString()\n  const shaped = alerts.map((alert) => ({\n    type: alert.type,\n    tier: alert.tier,\n    category: alert.category,\n    title: alert.title,\n    body: alert.body,\n    url: operatorAlertAbsoluteLink(alert.link) || null,\n  }))\n  return {\n    text,\n    ...(options.digest ? { digest: shaped } : { alert: shaped[0] ?? null }),\n    occurredAt,\n    ...(origin ? { install: origin } : {}),\n  }\n}\n\n/**\n * Posts alerts to `OPERATOR_ALERT_WEBHOOK_URL`, signed when\n * `OPERATOR_ALERT_WEBHOOK_SECRET` is set: `x-operator-alert-timestamp` is the\n * Unix time and `x-operator-alert-signature` is `sha256=` plus the hex HMAC\n * of `{timestamp}.{body}`. Unset means email only. Never throws.\n */\nexport async function postOperatorAlertWebhook(\n  alerts: readonly RenderedOperatorAlert[],\n  options: { digest?: boolean; now?: number } = {},\n): Promise<OperatorAlertWebhookResult> {\n  const url = operatorAlertWebhookUrl()\n  if (!url || !alerts.length) return { posted: false, reason: 'unconfigured' }\n  const body = JSON.stringify(operatorAlertWebhookPayload(alerts, options))\n  const headers: Record<string, string> = { 'content-type': 'application/json' }\n  const secret = String(process.env['OPERATOR_ALERT_WEBHOOK_SECRET'] ?? '').trim()\n  if (secret) {\n    const timestamp = String(Math.floor((options.now ?? Date.now()) / 1000))\n    headers['x-operator-alert-timestamp'] = timestamp\n    headers['x-operator-alert-signature'] =\n      'sha256=' + createHmac('sha256', secret).update(`${timestamp}.${body}`).digest('hex')\n  }\n  try {\n    const response = await fetch(url, {\n      method: 'POST',\n      headers,\n      body,\n      redirect: 'manual',\n      signal: AbortSignal.timeout(WEBHOOK_TIMEOUT_MS),\n    })\n    if (response.ok) return { posted: true, status: response.status }\n    console.error(`[operator-alerts] webhook answered ${response.status}`)\n    return { posted: false, reason: 'refused', status: response.status }\n  } catch (error) {\n    console.error('[operator-alerts] webhook unreachable', error)\n    return { posted: false, reason: 'network' }\n  }\n}\n\n// ── Links ───────────────────────────────────────────────────────────────────\n\nfunction consoleOrigin(): string {\n  return String(process.env['NEXT_PUBLIC_CONSOLE_URL'] ?? '').trim().replace(/\\/+$/, '')\n}\n\n/** A console path as an inbox or webhook can follow it, or `''`. */\nexport function operatorAlertAbsoluteLink(link: string | undefined | null): string {\n  const value = String(link ?? '').trim()\n  if (!value) return ''\n  if (/^https?:\\/\\//i.test(value)) return value\n  const origin = consoleOrigin()\n  return origin && value.startsWith('/') ? `${origin}${value}` : ''\n}\n\n/**\n * The definition's link with its tokens filled, or `''` when a token it\n * needs is missing — `/admin/orgs/` would open the wrong page.\n */\nfunction renderLink(template: string | undefined, context: OperatorAlertContext | undefined): string {\n  if (!template) return ''\n  const missing = [...template.matchAll(/\\{\\{\\s*([\\w.]+)\\s*\\}\\}/g)].some(([, name]) => {\n    const value = context?.[name as string]\n    return value === null || value === undefined || value === ''\n  })\n  return missing ? '' : renderOperatorAlertTemplate(template, context)\n}\n\n// ── Rendering ───────────────────────────────────────────────────────────────\n\n/** Stands in for a type nobody registered, so it is still told. */\nfunction unregisteredDefinition(type: string): OperatorAlertDefinition {\n  return {\n    type,\n    label: type,\n    description: 'An alert type this install has no registry entry for.',\n    tier: 'should',\n    category: 'ops',\n    title: '{{title}}',\n    body: '{{body}}',\n    delivery: 'immediate',\n    dedupeWindowMinutes: 60,\n    defaultEnabled: true,\n  }\n}\n\n/** Resolves the definition a call names, registering a plugin's own. */\nexport function resolveOperatorAlertDefinition(\n  type: string | OperatorAlertDefinition,\n): OperatorAlertDefinition {\n  if (typeof type !== 'string') {\n    const known = getOperatorAlert(type.type)\n    if (known) return known\n    if (type.pluginId) {\n      try {\n        registerOperatorAlerts([type], { pluginId: type.pluginId })\n      } catch (error) {\n        console.error(`[operator-alerts] ${type.type} could not be registered`, error)\n      }\n    }\n    return type\n  }\n  const known = getOperatorAlert(type)\n  if (known) return known\n  console.error(`[operator-alerts] \"${type}\" is not a registered alert type; telling it anyway`)\n  return unregisteredDefinition(type)\n}\n\nexport function renderOperatorAlert(\n  definition: OperatorAlertDefinition,\n  options: RaiseOperatorAlertOptions = {},\n): RenderedOperatorAlert {\n  const context: OperatorAlertContext = {\n    ...(options.subject ? { title: options.subject } : {}),\n    ...(options.body ? { body: options.body } : {}),\n    ...(options.context ?? {}),\n  }\n  const title =\n    String(options.subject ?? '').trim() ||\n    renderOperatorAlertTemplate(definition.title, context) ||\n    definition.label\n  const body =\n    String(options.body ?? '').trim() || renderOperatorAlertTemplate(definition.body, context)\n  return {\n    type: definition.type,\n    label: definition.label,\n    tier: definition.tier,\n    category: definition.category,\n    title,\n    body,\n    link: String(options.url ?? '').trim() || renderLink(definition.link, context),\n    notificationType: definition.notificationType ?? OPERATOR_ALERT_DEFAULT_NOTIFICATION_TYPE,\n    ...(options.orgId ? { orgId: options.orgId } : {}),\n    ...(options.hostId ? { hostId: options.hostId } : {}),\n  }\n}\n\n// ── The entry point ─────────────────────────────────────────────────────────\n\n/** Whether an email to the operator can go at all on this install. */\nasync function operatorEmailReachable(): Promise<boolean> {\n  if (!isEmailConfigured()) return false\n  const { resolveStaffAlertRecipients } = await import('./staff-alert-email')\n  return (await resolveStaffAlertRecipients()).length > 0\n}\n\n/** See the module comment. Never throws. */\nexport async function raiseOperatorAlert(\n  type: string | OperatorAlertDefinition,\n  options: RaiseOperatorAlertOptions = {},\n): Promise<OperatorAlertResult> {\n  const typeId = typeof type === 'string' ? type : type.type\n  try {\n    const definition = resolveOperatorAlertDefinition(type)\n    const dedupeKey = String(options.dedupeKey ?? '').trim()\n    let repeats = 0\n    if (dedupeKey) {\n      const claim = await claimOperatorAlert(definition, dedupeKey)\n      if (claim.fire === false) return { outcome: claim.reason, type: typeId }\n      repeats = claim.repeats\n    }\n    const alert = renderOperatorAlert(definition, options)\n    if (repeats > 0) {\n      alert.body = [alert.body, `Raised ${repeats} more time${repeats === 1 ? '' : 's'} since it was last told.`]\n        .filter(Boolean)\n        .join(' ')\n    }\n    const settings = await readOperatorAlertSettings()\n    const { enabled, delivery } = effectiveOperatorAlertSetting(definition, settings)\n    const emailNow = enabled && delivery === 'immediate' && (await operatorEmailReachable())\n\n    const { notifyStaffConsole } = await import('./notifications')\n    await notifyStaffConsole(\n      {\n        type: alert.notificationType,\n        title: alert.title,\n        ...(alert.body ? { body: alert.body } : {}),\n        ...(alert.link && alert.link.startsWith('/') ? { link: alert.link } : {}),\n        ...(alert.orgId ? { orgId: alert.orgId } : {}),\n        ...(alert.hostId ? { hostId: alert.hostId } : {}),\n      },\n      // The operator is emailed; a staff member who also switched email on\n      // for this category is not mailed the same alert a second time.\n      emailNow ? { skipEmail: true } : {},\n    )\n    if (!enabled) return { outcome: 'console-only', type: typeId }\n    if (delivery === 'digest') {\n      await queueOperatorAlertForDigest(alert)\n      return { outcome: 'queued', type: typeId }\n    }\n    return await deliverOperatorAlert(alert, { emailNow })\n  } catch (error) {\n    console.error(`[operator-alerts] ${typeId} could not be raised`, error)\n    return { outcome: 'undelivered', type: typeId }\n  }\n}\n\n/** Emails and posts one alert now. */\nasync function deliverOperatorAlert(\n  alert: RenderedOperatorAlert,\n  options: { emailNow: boolean },\n): Promise<OperatorAlertResult> {\n  const { sendOperatorAlertEmail } = await import('./staff-alert-email')\n  const [email, webhook] = await Promise.all([\n    options.emailNow\n      ? sendOperatorAlertEmail({\n          title: alert.title,\n          body: alert.body,\n          url: operatorAlertAbsoluteLink(alert.link),\n          context: `operator-alert ${alert.type}`,\n        })\n      : Promise.resolve<SendEmailResult>({ sent: false, reason: 'unconfigured' }),\n    postOperatorAlertWebhook([alert]),\n  ])\n  return {\n    outcome: email.sent || webhook.posted ? 'delivered' : 'undelivered',\n    type: alert.type,\n    email,\n    webhook,\n  }\n}\n\n// ── The digest ──────────────────────────────────────────────────────────────\n\nasync function queueOperatorAlertForDigest(alert: RenderedOperatorAlert): Promise<void> {\n  try {\n    await firestore()\n      .collection(OPERATOR_ALERT_DIGEST_COLLECTION)\n      .doc(createResourceUid())\n      .set({ ...alert, atMs: Date.now() })\n  } catch (error) {\n    // The queue is the only record the digest will have; with it gone, the\n    // alert goes now rather than never.\n    console.error(`[operator-alerts] digest queue unavailable; sending ${alert.type} now`, error)\n    await deliverOperatorAlert(alert, { emailNow: await operatorEmailReachable() })\n  }\n}\n\n/** At most this many alerts are listed in one digest; the rest are counted. */\nexport const OPERATOR_DIGEST_MAX_LISTED = 50\nconst DIGEST_READ_LIMIT = 500\n\nexport interface OperatorDigestResult {\n  /** Whether a digest went out (or, on a dry run, would). */\n  sent: boolean\n  reason?: 'not-due' | 'already-sent' | 'empty' | 'dry-run' | 'unavailable'\n  count: number\n  email?: SendEmailResult\n  webhook?: OperatorAlertWebhookResult\n}\n\nfunction dayKey(now: number): string {\n  return new Date(now).toISOString().slice(0, 10)\n}\n\n/** The state document that claims one UTC day's digest. */\nexport function operatorDigestMarkerId(now: number): string {\n  return `digest-${dayKey(now)}`\n}\n\n/** The digest's body: one paragraph per alert, newest last. */\nexport function composeOperatorDigestBody(\n  alerts: readonly RenderedOperatorAlert[],\n  total = alerts.length,\n): string {\n  const listed = alerts.slice(0, OPERATOR_DIGEST_MAX_LISTED).map((alert) => {\n    const link = operatorAlertAbsoluteLink(alert.link)\n    return [`• ${alert.title}`, alert.body, link].filter(Boolean).join('\\n')\n  })\n  const rest = total - listed.length\n  if (rest > 0) listed.push(`…and ${rest} more in the staff console.`)\n  return listed.join('\\n\\n')\n}\n\n/**\n * Sends the day's digest once the configured hour has passed: every queued\n * alert in one `operator-alert-digest` email and one webhook post, then\n * clears what it sent. Once per UTC day, claimed by creating\n * `operatorAlertState/digest-{day}`, so two ticks never both send it.\n */\nexport async function sendOperatorAlertDigest(\n  options: { now?: number; dryRun?: boolean; force?: boolean } = {},\n): Promise<OperatorDigestResult> {\n  const now = options.now ?? Date.now()\n  try {\n    const settings = await readOperatorAlertSettings()\n    const hour = settings.digestHourUtc ?? OPERATOR_ALERT_DIGEST_DEFAULT_HOUR_UTC\n    if (!options.force && new Date(now).getUTCHours() < hour) {\n      return { sent: false, reason: 'not-due', count: 0 }\n    }\n    const collection = firestore().collection(OPERATOR_ALERT_DIGEST_COLLECTION)\n    const marker = firestore()\n      .collection(OPERATOR_ALERT_STATE_COLLECTION)\n      .doc(operatorDigestMarkerId(now))\n    if (!options.force && (await marker.get()).exists) {\n      return { sent: false, reason: 'already-sent', count: 0 }\n    }\n    const snapshot = await collection.orderBy('atMs', 'asc').limit(DIGEST_READ_LIMIT).get()\n    const queued = snapshot.docs\n    if (!queued.length) return { sent: false, reason: 'empty', count: 0 }\n    if (options.dryRun) return { sent: false, reason: 'dry-run', count: queued.length }\n    if (!options.force) {\n      try {\n        await marker.create({ atMs: now, count: queued.length })\n      } catch {\n        return { sent: false, reason: 'already-sent', count: 0 }\n      }\n    }\n    const alerts = queued.map((doc: any) => doc.data() as RenderedOperatorAlert)\n    const { sendOperatorAlertDigestEmail } = await import('./staff-alert-email')\n    const [email, webhook] = await Promise.all([\n      sendOperatorAlertDigestEmail({\n        date: dayKey(now),\n        count: alerts.length,\n        body: composeOperatorDigestBody(alerts),\n        url: operatorAlertAbsoluteLink('/admin/operator-alerts'),\n      }),\n      postOperatorAlertWebhook(alerts, { digest: true, now }),\n    ])\n    if (email.sent || webhook.posted) {\n      const batch = firestore().batch()\n      for (const doc of queued) batch.delete(doc.ref)\n      await batch.commit()\n    } else if (!options.force) {\n      // Nothing reached anybody: release the day so the next tick retries.\n      await marker.delete().catch(() => undefined)\n    }\n    return { sent: email.sent || webhook.posted, count: alerts.length, email, webhook }\n  } catch (error) {\n    console.error('[operator-alerts] digest failed', error)\n    return { sent: false, reason: 'unavailable', count: 0 }\n  }\n}\n\n\n// ── The staff page ──────────────────────────────────────────────────────────\n\n/** One registry entry as Staff → Operator alerts lists it. */\nexport interface OperatorAlertCatalogRow {\n  type: string\n  label: string\n  description: string\n  tier: OperatorAlertDefinition['tier']\n  category: OperatorAlertDefinition['category']\n  pluginId: string | null\n  defaults: { enabled: boolean; delivery: OperatorAlertDefinition['delivery'] }\n  effective: { enabled: boolean; delivery: OperatorAlertDefinition['delivery'] }\n  /** Whether staff have answered for this type, rather than the default. */\n  overridden: boolean\n}\n\n/** Every registered type with its default and its effective setting. */\nexport function operatorAlertCatalogRows(\n  definitions: readonly OperatorAlertDefinition[],\n  settings: OperatorAlertSettingsDoc,\n): OperatorAlertCatalogRow[] {\n  return definitions.map((definition) => ({\n    type: definition.type,\n    label: definition.label,\n    description: definition.description,\n    tier: definition.tier,\n    category: definition.category,\n    pluginId: definition.pluginId ?? null,\n    defaults: { enabled: definition.defaultEnabled, delivery: definition.delivery },\n    effective: effectiveOperatorAlertSetting(definition, settings),\n    overridden: Boolean(settings.types?.[definition.type]),\n  }))\n}\n\n/**\n * Sends one `[Test]` alert of a type straight to the operator's inbox and\n * webhook, past dedupe and staff's switches, so an operator can prove the\n * channels reach them. Writes no console notification.\n */\nexport async function sendOperatorAlertTest(\n  definition: OperatorAlertDefinition,\n): Promise<{ email: SendEmailResult; webhook: OperatorAlertWebhookResult }> {\n  const sample: Record<string, string> = {}\n  for (const [, name] of `${definition.title} ${definition.body} ${definition.link ?? ''}`.matchAll(\n    /\\{\\{\\s*([\\w.]+)\\s*\\}\\}/g,\n  )) {\n    sample[name as string] = `sample ${name}`\n  }\n  const alert = renderOperatorAlert(definition, { context: sample })\n  alert.title = `[Test] ${alert.title}`\n  alert.body = [\n    alert.body,\n    'This is a test of the operator alert channels; nothing happened.',\n  ].join(' ')\n  const { sendOperatorAlertEmail } = await import('./staff-alert-email')\n  const [email, webhook] = await Promise.all([\n    isEmailConfigured()\n      ? sendOperatorAlertEmail({\n          title: alert.title,\n          body: alert.body,\n          url: operatorAlertAbsoluteLink(alert.link) || operatorAlertAbsoluteLink('/admin/operator-alerts'),\n          context: `operator-alert-test ${definition.type}`,\n        })\n      : Promise.resolve<SendEmailResult>({ sent: false, reason: 'unconfigured' }),\n    postOperatorAlertWebhook([alert]),\n  ])\n  return { email, webhook }\n}\n\n/** Where operator mail goes, named but never listed, for the staff page. */\nexport async function describeOperatorAlertRecipients(): Promise<{\n  source: 'STAFF_ALERT_EMAIL' | 'NEXT_PUBLIC_OPERATOR_SUPPORT_EMAIL' | 'staff-accounts' | 'none'\n  count: number\n}> {\n  const { resolveStaffAlertRecipients } = await import('./staff-alert-email')\n  const recipients = await resolveStaffAlertRecipients()\n  if (!recipients.length) return { source: 'none', count: 0 }\n  const configured = String(process.env['STAFF_ALERT_EMAIL'] ?? '').trim().toLowerCase()\n  if (configured.includes('@') && recipients[0] === configured) {\n    return { source: 'STAFF_ALERT_EMAIL', count: 1 }\n  }\n  const support = String(process.env['NEXT_PUBLIC_OPERATOR_SUPPORT_EMAIL'] ?? '').trim().toLowerCase()\n  if (support.includes('@') && recipients[0] === support) {\n    return { source: 'NEXT_PUBLIC_OPERATOR_SUPPORT_EMAIL', count: 1 }\n  }\n  return { source: 'staff-accounts', count: recipients.length }\n}\n"],"names":["createHash","createHmac","effectiveOperatorAlertSetting","OPERATOR_ALERT_DEFAULT_NOTIFICATION_TYPE","OPERATOR_ALERT_TIER_LABELS","renderOperatorAlertTemplate","getOperatorAlert","registerOperatorAlerts","createResourceUid","isEmailConfigured","firebaseAdmin","OPERATOR_ALERT_SETTINGS_COLLECTION","OPERATOR_ALERT_SETTINGS_DOC","OPERATOR_ALERT_STATE_COLLECTION","OPERATOR_ALERT_DIGEST_COLLECTION","OPERATOR_ALERT_DIGEST_DEFAULT_HOUR_UTC","firestore","app","SETTINGS_TTL_MS","settingsCache","invalidateOperatorAlertSettingsCache","undefined","normalizeOperatorAlertSettings","raw","source","types","rawTypes","type","value","Object","entries","entry","setting","enabled","delivery","keys","length","hour","Number","digestHourUtc","isInteger","updatedAtMs","updatedByEmail","readOperatorAlertSettings","now","Date","at","doc","snapshot","collection","get","exists","data","error","console","firedLocally","Map","FIRED_LOCALLY_MAX","stateDocId","dedupeKey","update","digest","slice","claimOperatorAlert","definition","windowMs","Math","max","dedupeWindowMinutes","minOccurrences","floor","fire","repeats","localKey","quietUntil","reason","ref","claim","runTransaction","transaction","state","lastFiredAtMs","base","set","suppressed","merge","windowStartMs","inWindow","occurrences","fired","size","clear","WEBHOOK_TIMEOUT_MS","operatorAlertWebhookUrl","process","String","env","trim","test","operatorAlertWebhookPayload","alerts","options","shaped","origin","consoleOrigin","lines","map","alert","link","operatorAlertAbsoluteLink","tier","title","body","filter","Boolean","join","text","occurredAt","toISOString","category","url","install","postOperatorAlertWebhook","posted","JSON","stringify","headers","secret","timestamp","response","fetch","method","redirect","signal","AbortSignal","timeout","ok","status","replace","startsWith","renderLink","template","context","missing","matchAll","some","name","unregisteredDefinition","label","description","defaultEnabled","resolveOperatorAlertDefinition","known","pluginId","renderOperatorAlert","subject","notificationType","orgId","hostId","operatorEmailReachable","resolveStaffAlertRecipients","raiseOperatorAlert","typeId","outcome","settings","emailNow","notifyStaffConsole","skipEmail","queueOperatorAlertForDigest","deliverOperatorAlert","sendOperatorAlertEmail","email","webhook","Promise","all","resolve","sent","atMs","OPERATOR_DIGEST_MAX_LISTED","DIGEST_READ_LIMIT","dayKey","operatorDigestMarkerId","composeOperatorDigestBody","total","listed","rest","push","sendOperatorAlertDigest","force","getUTCHours","count","marker","orderBy","limit","queued","docs","dryRun","create","sendOperatorAlertDigestEmail","date","batch","delete","commit","catch","operatorAlertCatalogRows","definitions","defaults","effective","overridden","sendOperatorAlertTest","sample","describeOperatorAlertRecipients","recipients","configured","toLowerCase","includes","support"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../../libs/tenant/data/admin/src/lib/server/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 { createHash, createHmac } from 'node:crypto'\nimport {\n  effectiveOperatorAlertSetting,\n  OPERATOR_ALERT_DEFAULT_NOTIFICATION_TYPE,\n  OPERATOR_ALERT_TIER_LABELS,\n  operatorAlertLevel,\n  renderOperatorAlertTemplate,\n  type AglynNotificationType,\n  type NotificationLevel,\n  type OperatorAlertContext,\n  type OperatorAlertDefinition,\n  type OperatorAlertSettings,\n  type OperatorAlertTypeSetting,\n} from '@aglyn/aglyn/server'\nimport {\n  getOperatorAlert,\n  registerOperatorAlerts,\n} from '@aglyn/aglyn/plugin-manager/operator-alerts'\nimport { createResourceUid } from '@aglyn/aglyn/app-utils/create-resource-uid'\nimport { isEmailConfigured, type SendEmailResult } from '@aglyn/shared-util-email'\nimport firebaseAdmin from './firebase-admin'\n\n/**\n * RAISING AN OPERATOR ALERT (AGL-3377): the one server entry point every\n * alert in the registry goes through.\n *\n * In order, for one call:\n *\n * 1. The type is looked up in the registry (core's catalog plus what plugins\n *    registered). A plugin may pass its definition itself, which registers\n *    it in this process if its declarations have not loaded yet.\n * 2. A `dedupeKey` is claimed against `operatorAlertState`, so a condition\n *    that flaps inside the type's window is told once, and a type with\n *    `minOccurrences` fires only once it has recurred that often.\n * 3. The staff console notification is written for every staff member, as\n *    `notifyStaff` always has.\n * 4. Staff's switches (`platformSettings/operatorAlerts`, coded defaults\n *    until changed) decide the rest: off is console only, `digest` queues it\n *    for the once-a-day digest, `immediate` emails the operator now.\n * 5. The email is the `operator-alert` system email, to\n *    `resolveStaffAlertRecipients()`; the optional out-of-band webhook\n *    (`OPERATOR_ALERT_WEBHOOK_URL`) gets the same alert beside it, so a mail\n *    provider that is itself the outage still reaches somebody.\n *\n * Never throws: an alert is raised from inside the failure it reports, and a\n * second failure there must not replace the first.\n */\n\n/** Where staff's per-type switches live. */\nexport const OPERATOR_ALERT_SETTINGS_COLLECTION = 'platformSettings'\nexport const OPERATOR_ALERT_SETTINGS_DOC = 'operatorAlerts'\n/** One document per (type, dedupeKey): when it last fired, how often since. */\nexport const OPERATOR_ALERT_STATE_COLLECTION = 'operatorAlertState'\n/** Alerts waiting for the daily digest. */\nexport const OPERATOR_ALERT_DIGEST_COLLECTION = 'operatorAlertDigest'\n\n/** The hour, UTC, the digest goes out when staff have not chosen one. */\nexport const OPERATOR_ALERT_DIGEST_DEFAULT_HOUR_UTC = 14\n\nexport interface OperatorAlertSettingsDoc extends OperatorAlertSettings {\n  /** The hour of the day, UTC, the digest is sent. */\n  digestHourUtc?: number\n  updatedAtMs?: number\n  updatedByEmail?: string | null\n}\n\nexport interface RaiseOperatorAlertOptions {\n  /**\n   * What makes two raises the SAME alert — a dispute id, an org and month, a\n   * check id. Absent never dedupes: every raise is told.\n   */\n  dedupeKey?: string\n  /** Values for the definition's `{{tokens}}`. Never personal data. */\n  context?: OperatorAlertContext\n  /** A console path or absolute URL; overrides the definition's link. */\n  url?: string\n  /** The title as written by the caller; overrides the rendered one. */\n  subject?: string\n  /** The body as written by the caller; overrides the rendered one. */\n  body?: string\n  /**\n   * The console notification's level as the caller judged it (AGL-3437);\n   * overrides the definition's. For a caller whose one alert type covers\n   * news of more than one tone.\n   */\n  level?: NotificationLevel\n  orgId?: string\n  hostId?: string\n}\n\nexport type OperatorAlertOutcome =\n  | 'deduped'\n  | 'below-threshold'\n  | 'console-only'\n  | 'queued'\n  | 'delivered'\n  | 'undelivered'\n\nexport interface OperatorAlertResult {\n  outcome: OperatorAlertOutcome\n  type: string\n  email?: SendEmailResult\n  webhook?: OperatorAlertWebhookResult\n}\n\nexport type OperatorAlertWebhookResult =\n  | { posted: true; status: number }\n  | { posted: false; reason: 'unconfigured' | 'refused' | 'network'; status?: number }\n\n/** One alert, rendered, as it is delivered and queued. */\nexport interface RenderedOperatorAlert {\n  type: string\n  label: string\n  tier: OperatorAlertDefinition['tier']\n  category: OperatorAlertDefinition['category']\n  title: string\n  body: string\n  /** Console path or absolute URL; `''` when there is none. */\n  link: string\n  notificationType: AglynNotificationType\n  orgId?: string\n  hostId?: string\n}\n\nconst firestore = () => firebaseAdmin.app().firestore()\n\n// ── Settings ────────────────────────────────────────────────────────────────\n\nconst SETTINGS_TTL_MS = 15_000\nlet settingsCache: { at: number; doc: OperatorAlertSettingsDoc } | undefined\n\n/** Drop the in-process settings cache; the console calls it after a write. */\nexport function invalidateOperatorAlertSettingsCache(): void {\n  settingsCache = undefined\n}\n\n/** Clamps a stored settings document to what the pipeline understands. */\nexport function normalizeOperatorAlertSettings(\n  raw: unknown,\n): OperatorAlertSettingsDoc {\n  const source = (raw && typeof raw === 'object' ? raw : {}) as Record<string, unknown>\n  const types: Record<string, OperatorAlertTypeSetting> = {}\n  const rawTypes = source['types']\n  if (rawTypes && typeof rawTypes === 'object') {\n    for (const [type, value] of Object.entries(rawTypes as Record<string, unknown>)) {\n      if (!type || !value || typeof value !== 'object') continue\n      const entry = value as Record<string, unknown>\n      const setting: OperatorAlertTypeSetting = {}\n      if (typeof entry['enabled'] === 'boolean') setting.enabled = entry['enabled']\n      if (entry['delivery'] === 'immediate' || entry['delivery'] === 'digest') {\n        setting.delivery = entry['delivery']\n      }\n      if (Object.keys(setting).length) types[type] = setting\n    }\n  }\n  const hour = Number(source['digestHourUtc'])\n  return {\n    types,\n    digestHourUtc:\n      Number.isInteger(hour) && hour >= 0 && hour <= 23\n        ? hour\n        : OPERATOR_ALERT_DIGEST_DEFAULT_HOUR_UTC,\n    ...(typeof source['updatedAtMs'] === 'number'\n      ? { updatedAtMs: source['updatedAtMs'] as number }\n      : {}),\n    ...(typeof source['updatedByEmail'] === 'string'\n      ? { updatedByEmail: source['updatedByEmail'] as string }\n      : {}),\n  }\n}\n\n/**\n * Staff's switches. An unreadable document is the coded defaults, uncached:\n * an alert must still go out when the settings cannot be read.\n */\nexport async function readOperatorAlertSettings(): Promise<OperatorAlertSettingsDoc> {\n  const now = Date.now()\n  if (settingsCache && now - settingsCache.at < SETTINGS_TTL_MS) return settingsCache.doc\n  try {\n    const snapshot = await firestore()\n      .collection(OPERATOR_ALERT_SETTINGS_COLLECTION)\n      .doc(OPERATOR_ALERT_SETTINGS_DOC)\n      .get()\n    const doc = normalizeOperatorAlertSettings(snapshot.exists ? snapshot.data() : null)\n    settingsCache = { at: now, doc }\n    return doc\n  } catch (error) {\n    console.error('[operator-alerts] settings unreadable; using the defaults', error)\n    return normalizeOperatorAlertSettings(null)\n  }\n}\n\n// ── Dedupe ──────────────────────────────────────────────────────────────────\n\n/** Keys this instance fired, and until when they stay quiet. */\nconst firedLocally = new Map<string, number>()\nconst FIRED_LOCALLY_MAX = 500\n\nfunction stateDocId(type: string, dedupeKey: string): string {\n  return createHash('sha256').update(`${type}\\u0000${dedupeKey}`).digest('hex').slice(0, 40)\n}\n\nexport type OperatorAlertClaim =\n  | { fire: true; repeats: number }\n  | { fire: false; reason: 'deduped' | 'below-threshold' }\n\n/**\n * Whether a raise with this key fires now. One transaction on the key's\n * state document: inside the window after a fire it is counted and\n * suppressed; before it reaches `minOccurrences` it is counted and held.\n * A store that cannot be read FIRES — a duplicate beats a silence.\n */\nexport async function claimOperatorAlert(\n  definition: Pick<OperatorAlertDefinition, 'type' | 'dedupeWindowMinutes' | 'minOccurrences'>,\n  dedupeKey: string,\n  now = Date.now(),\n): Promise<OperatorAlertClaim> {\n  const windowMs = Math.max(0, definition.dedupeWindowMinutes) * 60_000\n  const minOccurrences = Math.max(1, Math.floor(definition.minOccurrences ?? 1))\n  if (!windowMs) return { fire: true, repeats: 0 }\n  const localKey = `${definition.type}\\u0000${dedupeKey}`\n  const quietUntil = firedLocally.get(localKey)\n  if (quietUntil && quietUntil > now) return { fire: false, reason: 'deduped' }\n  try {\n    const ref = firestore()\n      .collection(OPERATOR_ALERT_STATE_COLLECTION)\n      .doc(stateDocId(definition.type, dedupeKey))\n    const claim = await firestore().runTransaction(async (transaction: any) => {\n      const snapshot = await transaction.get(ref)\n      const state = (snapshot.exists ? snapshot.data() : {}) as Record<string, unknown>\n      const lastFiredAtMs = Number(state['lastFiredAtMs'] ?? 0)\n      const base = { type: definition.type, dedupeKey: dedupeKey.slice(0, 300), updatedAtMs: now }\n      if (lastFiredAtMs && now - lastFiredAtMs < windowMs) {\n        transaction.set(ref, { ...base, suppressed: Number(state['suppressed'] ?? 0) + 1 }, { merge: true })\n        return { fire: false, reason: 'deduped' } as const\n      }\n      const windowStartMs = Number(state['windowStartMs'] ?? 0)\n      const inWindow = windowStartMs && now - windowStartMs < windowMs\n      const occurrences = (inWindow ? Number(state['occurrences'] ?? 0) : 0) + 1\n      if (occurrences < minOccurrences) {\n        transaction.set(\n          ref,\n          { ...base, occurrences, windowStartMs: inWindow ? windowStartMs : now },\n          { merge: true },\n        )\n        return { fire: false, reason: 'below-threshold' } as const\n      }\n      transaction.set(\n        ref,\n        {\n          ...base,\n          lastFiredAtMs: now,\n          occurrences: 0,\n          windowStartMs: 0,\n          suppressed: 0,\n          fired: Number(state['fired'] ?? 0) + 1,\n        },\n        { merge: true },\n      )\n      return { fire: true, repeats: Number(state['suppressed'] ?? 0) } as const\n    })\n    if (claim.fire) {\n      if (firedLocally.size >= FIRED_LOCALLY_MAX) firedLocally.clear()\n      firedLocally.set(localKey, now + windowMs)\n    }\n    return claim\n  } catch (error) {\n    console.error(`[operator-alerts] dedupe unavailable for ${definition.type}; firing`, error)\n    return { fire: true, repeats: 0 }\n  }\n}\n\n// ── Out-of-band webhook ─────────────────────────────────────────────────────\n\nconst WEBHOOK_TIMEOUT_MS = 5_000\n\n/** The webhook URL, when one is configured and is http(s). */\nexport function operatorAlertWebhookUrl(): string {\n  const value = String(process.env['OPERATOR_ALERT_WEBHOOK_URL'] ?? '').trim()\n  return /^https?:\\/\\/\\S+$/i.test(value) ? value : ''\n}\n\n/**\n * The JSON the webhook receives. `text` is what a Slack-compatible incoming\n * webhook renders on its own; `alert` carries the fields for anything that\n * wants to route on them.\n */\nexport function operatorAlertWebhookPayload(\n  alerts: readonly RenderedOperatorAlert[],\n  options: { digest?: boolean; now?: number } = {},\n): Record<string, unknown> {\n  const origin = consoleOrigin()\n  const lines = alerts.map((alert) => {\n    const link = operatorAlertAbsoluteLink(alert.link)\n    return [\n      `[${OPERATOR_ALERT_TIER_LABELS[alert.tier]}] ${alert.title}`,\n      alert.body,\n      link,\n    ]\n      .filter(Boolean)\n      .join('\\n')\n  })\n  const text = options.digest\n    ? [`Operator digest: ${alerts.length} alert${alerts.length === 1 ? '' : 's'}`, ...lines].join('\\n\\n')\n    : lines.join('\\n\\n')\n  const occurredAt = new Date(options.now ?? Date.now()).toISOString()\n  const shaped = alerts.map((alert) => ({\n    type: alert.type,\n    tier: alert.tier,\n    category: alert.category,\n    title: alert.title,\n    body: alert.body,\n    url: operatorAlertAbsoluteLink(alert.link) || null,\n  }))\n  return {\n    text,\n    ...(options.digest ? { digest: shaped } : { alert: shaped[0] ?? null }),\n    occurredAt,\n    ...(origin ? { install: origin } : {}),\n  }\n}\n\n/**\n * Posts alerts to `OPERATOR_ALERT_WEBHOOK_URL`, signed when\n * `OPERATOR_ALERT_WEBHOOK_SECRET` is set: `x-operator-alert-timestamp` is the\n * Unix time and `x-operator-alert-signature` is `sha256=` plus the hex HMAC\n * of `{timestamp}.{body}`. Unset means email only. Never throws.\n */\nexport async function postOperatorAlertWebhook(\n  alerts: readonly RenderedOperatorAlert[],\n  options: { digest?: boolean; now?: number } = {},\n): Promise<OperatorAlertWebhookResult> {\n  const url = operatorAlertWebhookUrl()\n  if (!url || !alerts.length) return { posted: false, reason: 'unconfigured' }\n  const body = JSON.stringify(operatorAlertWebhookPayload(alerts, options))\n  const headers: Record<string, string> = { 'content-type': 'application/json' }\n  const secret = String(process.env['OPERATOR_ALERT_WEBHOOK_SECRET'] ?? '').trim()\n  if (secret) {\n    const timestamp = String(Math.floor((options.now ?? Date.now()) / 1000))\n    headers['x-operator-alert-timestamp'] = timestamp\n    headers['x-operator-alert-signature'] =\n      'sha256=' + createHmac('sha256', secret).update(`${timestamp}.${body}`).digest('hex')\n  }\n  try {\n    const response = await fetch(url, {\n      method: 'POST',\n      headers,\n      body,\n      redirect: 'manual',\n      signal: AbortSignal.timeout(WEBHOOK_TIMEOUT_MS),\n    })\n    if (response.ok) return { posted: true, status: response.status }\n    console.error(`[operator-alerts] webhook answered ${response.status}`)\n    return { posted: false, reason: 'refused', status: response.status }\n  } catch (error) {\n    console.error('[operator-alerts] webhook unreachable', error)\n    return { posted: false, reason: 'network' }\n  }\n}\n\n// ── Links ───────────────────────────────────────────────────────────────────\n\nfunction consoleOrigin(): string {\n  return String(process.env['NEXT_PUBLIC_CONSOLE_URL'] ?? '').trim().replace(/\\/+$/, '')\n}\n\n/** A console path as an inbox or webhook can follow it, or `''`. */\nexport function operatorAlertAbsoluteLink(link: string | undefined | null): string {\n  const value = String(link ?? '').trim()\n  if (!value) return ''\n  if (/^https?:\\/\\//i.test(value)) return value\n  const origin = consoleOrigin()\n  return origin && value.startsWith('/') ? `${origin}${value}` : ''\n}\n\n/**\n * The definition's link with its tokens filled, or `''` when a token it\n * needs is missing — `/admin/orgs/` would open the wrong page.\n */\nfunction renderLink(template: string | undefined, context: OperatorAlertContext | undefined): string {\n  if (!template) return ''\n  const missing = [...template.matchAll(/\\{\\{\\s*([\\w.]+)\\s*\\}\\}/g)].some(([, name]) => {\n    const value = context?.[name as string]\n    return value === null || value === undefined || value === ''\n  })\n  return missing ? '' : renderOperatorAlertTemplate(template, context)\n}\n\n// ── Rendering ───────────────────────────────────────────────────────────────\n\n/** Stands in for a type nobody registered, so it is still told. */\nfunction unregisteredDefinition(type: string): OperatorAlertDefinition {\n  return {\n    type,\n    label: type,\n    description: 'An alert type this install has no registry entry for.',\n    tier: 'should',\n    category: 'ops',\n    title: '{{title}}',\n    body: '{{body}}',\n    delivery: 'immediate',\n    dedupeWindowMinutes: 60,\n    defaultEnabled: true,\n  }\n}\n\n/** Resolves the definition a call names, registering a plugin's own. */\nexport function resolveOperatorAlertDefinition(\n  type: string | OperatorAlertDefinition,\n): OperatorAlertDefinition {\n  if (typeof type !== 'string') {\n    const known = getOperatorAlert(type.type)\n    if (known) return known\n    if (type.pluginId) {\n      try {\n        registerOperatorAlerts([type], { pluginId: type.pluginId })\n      } catch (error) {\n        console.error(`[operator-alerts] ${type.type} could not be registered`, error)\n      }\n    }\n    return type\n  }\n  const known = getOperatorAlert(type)\n  if (known) return known\n  console.error(`[operator-alerts] \"${type}\" is not a registered alert type; telling it anyway`)\n  return unregisteredDefinition(type)\n}\n\nexport function renderOperatorAlert(\n  definition: OperatorAlertDefinition,\n  options: RaiseOperatorAlertOptions = {},\n): RenderedOperatorAlert {\n  const context: OperatorAlertContext = {\n    ...(options.subject ? { title: options.subject } : {}),\n    ...(options.body ? { body: options.body } : {}),\n    ...(options.context ?? {}),\n  }\n  const title =\n    String(options.subject ?? '').trim() ||\n    renderOperatorAlertTemplate(definition.title, context) ||\n    definition.label\n  const body =\n    String(options.body ?? '').trim() || renderOperatorAlertTemplate(definition.body, context)\n  return {\n    type: definition.type,\n    label: definition.label,\n    tier: definition.tier,\n    category: definition.category,\n    title,\n    body,\n    link: String(options.url ?? '').trim() || renderLink(definition.link, context),\n    notificationType: definition.notificationType ?? OPERATOR_ALERT_DEFAULT_NOTIFICATION_TYPE,\n    ...(options.orgId ? { orgId: options.orgId } : {}),\n    ...(options.hostId ? { hostId: options.hostId } : {}),\n  }\n}\n\n// ── The entry point ─────────────────────────────────────────────────────────\n\n/** Whether an email to the operator can go at all on this install. */\nasync function operatorEmailReachable(): Promise<boolean> {\n  if (!isEmailConfigured()) return false\n  const { resolveStaffAlertRecipients } = await import('./staff-alert-email')\n  return (await resolveStaffAlertRecipients()).length > 0\n}\n\n/** See the module comment. Never throws. */\nexport async function raiseOperatorAlert(\n  type: string | OperatorAlertDefinition,\n  options: RaiseOperatorAlertOptions = {},\n): Promise<OperatorAlertResult> {\n  const typeId = typeof type === 'string' ? type : type.type\n  try {\n    const definition = resolveOperatorAlertDefinition(type)\n    const dedupeKey = String(options.dedupeKey ?? '').trim()\n    let repeats = 0\n    if (dedupeKey) {\n      const claim = await claimOperatorAlert(definition, dedupeKey)\n      if (claim.fire === false) return { outcome: claim.reason, type: typeId }\n      repeats = claim.repeats\n    }\n    const alert = renderOperatorAlert(definition, options)\n    if (repeats > 0) {\n      alert.body = [alert.body, `Raised ${repeats} more time${repeats === 1 ? '' : 's'} since it was last told.`]\n        .filter(Boolean)\n        .join(' ')\n    }\n    const settings = await readOperatorAlertSettings()\n    const { enabled, delivery } = effectiveOperatorAlertSetting(definition, settings)\n    const emailNow = enabled && delivery === 'immediate' && (await operatorEmailReachable())\n\n    const { notifyStaffConsole } = await import('./notifications')\n    await notifyStaffConsole(\n      {\n        type: alert.notificationType,\n        title: alert.title,\n        ...(alert.body ? { body: alert.body } : {}),\n        level: options.level ?? operatorAlertLevel(definition),\n        ...(alert.link && alert.link.startsWith('/') ? { link: alert.link } : {}),\n        ...(alert.orgId ? { orgId: alert.orgId } : {}),\n        ...(alert.hostId ? { hostId: alert.hostId } : {}),\n      },\n      // The operator is emailed; a staff member who also switched email on\n      // for this category is not mailed the same alert a second time.\n      emailNow ? { skipEmail: true } : {},\n    )\n    if (!enabled) return { outcome: 'console-only', type: typeId }\n    if (delivery === 'digest') {\n      await queueOperatorAlertForDigest(alert)\n      return { outcome: 'queued', type: typeId }\n    }\n    return await deliverOperatorAlert(alert, { emailNow })\n  } catch (error) {\n    console.error(`[operator-alerts] ${typeId} could not be raised`, error)\n    return { outcome: 'undelivered', type: typeId }\n  }\n}\n\n/** Emails and posts one alert now. */\nasync function deliverOperatorAlert(\n  alert: RenderedOperatorAlert,\n  options: { emailNow: boolean },\n): Promise<OperatorAlertResult> {\n  const { sendOperatorAlertEmail } = await import('./staff-alert-email')\n  const [email, webhook] = await Promise.all([\n    options.emailNow\n      ? sendOperatorAlertEmail({\n          title: alert.title,\n          body: alert.body,\n          url: operatorAlertAbsoluteLink(alert.link),\n          context: `operator-alert ${alert.type}`,\n        })\n      : Promise.resolve<SendEmailResult>({ sent: false, reason: 'unconfigured' }),\n    postOperatorAlertWebhook([alert]),\n  ])\n  return {\n    outcome: email.sent || webhook.posted ? 'delivered' : 'undelivered',\n    type: alert.type,\n    email,\n    webhook,\n  }\n}\n\n// ── The digest ──────────────────────────────────────────────────────────────\n\nasync function queueOperatorAlertForDigest(alert: RenderedOperatorAlert): Promise<void> {\n  try {\n    await firestore()\n      .collection(OPERATOR_ALERT_DIGEST_COLLECTION)\n      .doc(createResourceUid())\n      .set({ ...alert, atMs: Date.now() })\n  } catch (error) {\n    // The queue is the only record the digest will have; with it gone, the\n    // alert goes now rather than never.\n    console.error(`[operator-alerts] digest queue unavailable; sending ${alert.type} now`, error)\n    await deliverOperatorAlert(alert, { emailNow: await operatorEmailReachable() })\n  }\n}\n\n/** At most this many alerts are listed in one digest; the rest are counted. */\nexport const OPERATOR_DIGEST_MAX_LISTED = 50\nconst DIGEST_READ_LIMIT = 500\n\nexport interface OperatorDigestResult {\n  /** Whether a digest went out (or, on a dry run, would). */\n  sent: boolean\n  reason?: 'not-due' | 'already-sent' | 'empty' | 'dry-run' | 'unavailable'\n  count: number\n  email?: SendEmailResult\n  webhook?: OperatorAlertWebhookResult\n}\n\nfunction dayKey(now: number): string {\n  return new Date(now).toISOString().slice(0, 10)\n}\n\n/** The state document that claims one UTC day's digest. */\nexport function operatorDigestMarkerId(now: number): string {\n  return `digest-${dayKey(now)}`\n}\n\n/** The digest's body: one paragraph per alert, newest last. */\nexport function composeOperatorDigestBody(\n  alerts: readonly RenderedOperatorAlert[],\n  total = alerts.length,\n): string {\n  const listed = alerts.slice(0, OPERATOR_DIGEST_MAX_LISTED).map((alert) => {\n    const link = operatorAlertAbsoluteLink(alert.link)\n    return [`• ${alert.title}`, alert.body, link].filter(Boolean).join('\\n')\n  })\n  const rest = total - listed.length\n  if (rest > 0) listed.push(`…and ${rest} more in the staff console.`)\n  return listed.join('\\n\\n')\n}\n\n/**\n * Sends the day's digest once the configured hour has passed: every queued\n * alert in one `operator-alert-digest` email and one webhook post, then\n * clears what it sent. Once per UTC day, claimed by creating\n * `operatorAlertState/digest-{day}`, so two ticks never both send it.\n */\nexport async function sendOperatorAlertDigest(\n  options: { now?: number; dryRun?: boolean; force?: boolean } = {},\n): Promise<OperatorDigestResult> {\n  const now = options.now ?? Date.now()\n  try {\n    const settings = await readOperatorAlertSettings()\n    const hour = settings.digestHourUtc ?? OPERATOR_ALERT_DIGEST_DEFAULT_HOUR_UTC\n    if (!options.force && new Date(now).getUTCHours() < hour) {\n      return { sent: false, reason: 'not-due', count: 0 }\n    }\n    const collection = firestore().collection(OPERATOR_ALERT_DIGEST_COLLECTION)\n    const marker = firestore()\n      .collection(OPERATOR_ALERT_STATE_COLLECTION)\n      .doc(operatorDigestMarkerId(now))\n    if (!options.force && (await marker.get()).exists) {\n      return { sent: false, reason: 'already-sent', count: 0 }\n    }\n    const snapshot = await collection.orderBy('atMs', 'asc').limit(DIGEST_READ_LIMIT).get()\n    const queued = snapshot.docs\n    if (!queued.length) return { sent: false, reason: 'empty', count: 0 }\n    if (options.dryRun) return { sent: false, reason: 'dry-run', count: queued.length }\n    if (!options.force) {\n      try {\n        await marker.create({ atMs: now, count: queued.length })\n      } catch {\n        return { sent: false, reason: 'already-sent', count: 0 }\n      }\n    }\n    const alerts = queued.map((doc: any) => doc.data() as RenderedOperatorAlert)\n    const { sendOperatorAlertDigestEmail } = await import('./staff-alert-email')\n    const [email, webhook] = await Promise.all([\n      sendOperatorAlertDigestEmail({\n        date: dayKey(now),\n        count: alerts.length,\n        body: composeOperatorDigestBody(alerts),\n        url: operatorAlertAbsoluteLink('/admin/operator-alerts'),\n      }),\n      postOperatorAlertWebhook(alerts, { digest: true, now }),\n    ])\n    if (email.sent || webhook.posted) {\n      const batch = firestore().batch()\n      for (const doc of queued) batch.delete(doc.ref)\n      await batch.commit()\n    } else if (!options.force) {\n      // Nothing reached anybody: release the day so the next tick retries.\n      await marker.delete().catch(() => undefined)\n    }\n    return { sent: email.sent || webhook.posted, count: alerts.length, email, webhook }\n  } catch (error) {\n    console.error('[operator-alerts] digest failed', error)\n    return { sent: false, reason: 'unavailable', count: 0 }\n  }\n}\n\n\n// ── The staff page ──────────────────────────────────────────────────────────\n\n/** One registry entry as Staff → Operator alerts lists it. */\nexport interface OperatorAlertCatalogRow {\n  type: string\n  label: string\n  description: string\n  tier: OperatorAlertDefinition['tier']\n  category: OperatorAlertDefinition['category']\n  pluginId: string | null\n  defaults: { enabled: boolean; delivery: OperatorAlertDefinition['delivery'] }\n  effective: { enabled: boolean; delivery: OperatorAlertDefinition['delivery'] }\n  /** Whether staff have answered for this type, rather than the default. */\n  overridden: boolean\n}\n\n/** Every registered type with its default and its effective setting. */\nexport function operatorAlertCatalogRows(\n  definitions: readonly OperatorAlertDefinition[],\n  settings: OperatorAlertSettingsDoc,\n): OperatorAlertCatalogRow[] {\n  return definitions.map((definition) => ({\n    type: definition.type,\n    label: definition.label,\n    description: definition.description,\n    tier: definition.tier,\n    category: definition.category,\n    pluginId: definition.pluginId ?? null,\n    defaults: { enabled: definition.defaultEnabled, delivery: definition.delivery },\n    effective: effectiveOperatorAlertSetting(definition, settings),\n    overridden: Boolean(settings.types?.[definition.type]),\n  }))\n}\n\n/**\n * Sends one `[Test]` alert of a type straight to the operator's inbox and\n * webhook, past dedupe and staff's switches, so an operator can prove the\n * channels reach them. Writes no console notification.\n */\nexport async function sendOperatorAlertTest(\n  definition: OperatorAlertDefinition,\n): Promise<{ email: SendEmailResult; webhook: OperatorAlertWebhookResult }> {\n  const sample: Record<string, string> = {}\n  for (const [, name] of `${definition.title} ${definition.body} ${definition.link ?? ''}`.matchAll(\n    /\\{\\{\\s*([\\w.]+)\\s*\\}\\}/g,\n  )) {\n    sample[name as string] = `sample ${name}`\n  }\n  const alert = renderOperatorAlert(definition, { context: sample })\n  alert.title = `[Test] ${alert.title}`\n  alert.body = [\n    alert.body,\n    'This is a test of the operator alert channels; nothing happened.',\n  ].join(' ')\n  const { sendOperatorAlertEmail } = await import('./staff-alert-email')\n  const [email, webhook] = await Promise.all([\n    isEmailConfigured()\n      ? sendOperatorAlertEmail({\n          title: alert.title,\n          body: alert.body,\n          url: operatorAlertAbsoluteLink(alert.link) || operatorAlertAbsoluteLink('/admin/operator-alerts'),\n          context: `operator-alert-test ${definition.type}`,\n        })\n      : Promise.resolve<SendEmailResult>({ sent: false, reason: 'unconfigured' }),\n    postOperatorAlertWebhook([alert]),\n  ])\n  return { email, webhook }\n}\n\n/** Where operator mail goes, named but never listed, for the staff page. */\nexport async function describeOperatorAlertRecipients(): Promise<{\n  source: 'STAFF_ALERT_EMAIL' | 'NEXT_PUBLIC_OPERATOR_SUPPORT_EMAIL' | 'staff-accounts' | 'none'\n  count: number\n}> {\n  const { resolveStaffAlertRecipients } = await import('./staff-alert-email')\n  const recipients = await resolveStaffAlertRecipients()\n  if (!recipients.length) return { source: 'none', count: 0 }\n  const configured = String(process.env['STAFF_ALERT_EMAIL'] ?? '').trim().toLowerCase()\n  if (configured.includes('@') && recipients[0] === configured) {\n    return { source: 'STAFF_ALERT_EMAIL', count: 1 }\n  }\n  const support = String(process.env['NEXT_PUBLIC_OPERATOR_SUPPORT_EMAIL'] ?? '').trim().toLowerCase()\n  if (support.includes('@') && recipients[0] === support) {\n    return { source: 'NEXT_PUBLIC_OPERATOR_SUPPORT_EMAIL', count: 1 }\n  }\n  return { source: 'staff-accounts', count: recipients.length }\n}\n"],"names":["createHash","createHmac","effectiveOperatorAlertSetting","OPERATOR_ALERT_DEFAULT_NOTIFICATION_TYPE","OPERATOR_ALERT_TIER_LABELS","operatorAlertLevel","renderOperatorAlertTemplate","getOperatorAlert","registerOperatorAlerts","createResourceUid","isEmailConfigured","firebaseAdmin","OPERATOR_ALERT_SETTINGS_COLLECTION","OPERATOR_ALERT_SETTINGS_DOC","OPERATOR_ALERT_STATE_COLLECTION","OPERATOR_ALERT_DIGEST_COLLECTION","OPERATOR_ALERT_DIGEST_DEFAULT_HOUR_UTC","firestore","app","SETTINGS_TTL_MS","settingsCache","invalidateOperatorAlertSettingsCache","undefined","normalizeOperatorAlertSettings","raw","source","types","rawTypes","type","value","Object","entries","entry","setting","enabled","delivery","keys","length","hour","Number","digestHourUtc","isInteger","updatedAtMs","updatedByEmail","readOperatorAlertSettings","now","Date","at","doc","snapshot","collection","get","exists","data","error","console","firedLocally","Map","FIRED_LOCALLY_MAX","stateDocId","dedupeKey","update","digest","slice","claimOperatorAlert","definition","windowMs","Math","max","dedupeWindowMinutes","minOccurrences","floor","fire","repeats","localKey","quietUntil","reason","ref","claim","runTransaction","transaction","state","lastFiredAtMs","base","set","suppressed","merge","windowStartMs","inWindow","occurrences","fired","size","clear","WEBHOOK_TIMEOUT_MS","operatorAlertWebhookUrl","process","String","env","trim","test","operatorAlertWebhookPayload","alerts","options","shaped","origin","consoleOrigin","lines","map","alert","link","operatorAlertAbsoluteLink","tier","title","body","filter","Boolean","join","text","occurredAt","toISOString","category","url","install","postOperatorAlertWebhook","posted","JSON","stringify","headers","secret","timestamp","response","fetch","method","redirect","signal","AbortSignal","timeout","ok","status","replace","startsWith","renderLink","template","context","missing","matchAll","some","name","unregisteredDefinition","label","description","defaultEnabled","resolveOperatorAlertDefinition","known","pluginId","renderOperatorAlert","subject","notificationType","orgId","hostId","operatorEmailReachable","resolveStaffAlertRecipients","raiseOperatorAlert","typeId","outcome","settings","emailNow","notifyStaffConsole","level","skipEmail","queueOperatorAlertForDigest","deliverOperatorAlert","sendOperatorAlertEmail","email","webhook","Promise","all","resolve","sent","atMs","OPERATOR_DIGEST_MAX_LISTED","DIGEST_READ_LIMIT","dayKey","operatorDigestMarkerId","composeOperatorDigestBody","total","listed","rest","push","sendOperatorAlertDigest","force","getUTCHours","count","marker","orderBy","limit","queued","docs","dryRun","create","sendOperatorAlertDigestEmail","date","batch","delete","commit","catch","operatorAlertCatalogRows","definitions","defaults","effective","overridden","sendOperatorAlertTest","sample","describeOperatorAlertRecipients","recipients","configured","toLowerCase","includes","support"],"mappings":"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"}

package/src/lib/server/org-containers.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @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.
+ */
+/**
+ * AN ORGANIZATION'S CONTAINERS OF ONE KIND, read on the server by a plugin
+ * that files its records under them and does not keep them.
+ *
+ * A container kind is declared by the plugin that keeps it
+ * (`plugin-manager/plugin-containers.ts`): which org collection holds the
+ * containers and which field names one. That declaration is the whole of what
+ * another plugin may rely on — a container's id, its name, the sites its
+ * `visibleTo` places it on, and whether its owner retired it (`deletedAt`) —
+ * and this module reads exactly that, where the declaration says. A sequence
+ * that validates the campaigns it is filed under, an import that matches
+ * campaign names, a timeline entry that names the campaign a lead was filed
+ * under: none of them names the owner's collection, so the owner may move it.
+ *
+ * A kind no plugin keeps reads nothing: every id answers as gone, and a list
+ * is empty. That is the honest answer for a workspace without the owner.
+ */
+/** One container, as much of it as a plugin that files under it may read. */
+export interface OrgContainerRecord {
+    id: string;
+    /** The org holds a container under this id, retired or not. */
+    exists: boolean;
+    /** It exists and its owner has not retired it. */
+    live: boolean;
+    /** Its name, from the field its kind declares; `''` when it has none or is gone. */
+    name: string;
+    /** Its `visibleTo` scope tokens; `[]` when it has none or is gone. */
+    visibleTo: string[];
+}
+/**
+ * The containers named by `ids`, one record per id in the order asked: one
+ * keyed read each, in a single `getAll`. An id that cannot be a document id
+ * is answered as gone without a read.
+ *
+ * Throws what the read throws; a caller that must not fail on it catches.
+ */
+export declare function readOrgContainers(firestore: FirebaseFirestore.Firestore, kind: string, orgId: string, ids: readonly string[]): Promise<OrgContainerRecord[]>;
+/**
+ * Up to `ceiling` of the organization's containers of a kind, in document
+ * order, retired ones included and marked: a caller that matches by name
+ * decides what a retired one means to it. Read as a projection of the
+ * fields a record carries.
+ */
+export declare function listOrgContainers(firestore: FirebaseFirestore.Firestore, kind: string, orgId: string, ceiling: number): Promise<OrgContainerRecord[]>;
+/**
+ * Up to `limit` of the organization's containers of a kind whose declared
+ * name field is exactly `name`, retired ones included and marked, so a caller
+ * resolving a name can tell a live match from a retired one sharing it.
+ */
+export declare function findOrgContainersByName(firestore: FirebaseFirestore.Firestore, kind: string, orgId: string, name: string, limit: number): Promise<OrgContainerRecord[]>;

package/src/lib/server/org-containers.js

@@ -0,0 +1,95 @@
+/**
+ * @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.
+ */ import { pluginContainerKind } from "@aglyn/aglyn/plugin-manager/plugin-containers";
+import { isDocumentId } from "./document-id.js";
+function recordOf(id, snapshot, nameField) {
+    var _snapshot_get;
+    if (!(snapshot == null ? void 0 : snapshot.exists)) return {
+        id,
+        exists: false,
+        live: false,
+        name: '',
+        visibleTo: []
+    };
+    const visibleTo = snapshot.get('visibleTo');
+    return {
+        id,
+        exists: true,
+        live: !snapshot.get('deletedAt'),
+        name: String((_snapshot_get = snapshot.get(nameField)) != null ? _snapshot_get : '').trim(),
+        visibleTo: Array.isArray(visibleTo) ? visibleTo.map(String) : []
+    };
+}
+/**
+ * The fields a reader may rely on, and the only ones a listing reads: a
+ * container can be a large document, and nothing here needs the rest.
+ */ const fieldsOf = (nameField)=>[
+        nameField,
+        'deletedAt',
+        'visibleTo'
+    ];
+/** The kind's collection under the org, or `null` when no plugin keeps the kind. */ function containersOf(firestore, kind, orgId) {
+    const declared = pluginContainerKind(kind);
+    if (!declared || !isDocumentId(orgId)) return null;
+    return {
+        ref: firestore.collection('orgs').doc(orgId).collection(declared.orgCollection),
+        nameField: declared.nameField
+    };
+}
+/**
+ * The containers named by `ids`, one record per id in the order asked: one
+ * keyed read each, in a single `getAll`. An id that cannot be a document id
+ * is answered as gone without a read.
+ *
+ * Throws what the read throws; a caller that must not fail on it catches.
+ */ export async function readOrgContainers(firestore, kind, orgId, ids) {
+    if (!ids.length) return [];
+    const containers = containersOf(firestore, kind, orgId);
+    const readable = ids.filter((id)=>isDocumentId(id));
+    if (!containers || !readable.length) return ids.map((id)=>recordOf(id, undefined, ''));
+    // `getAll` answers in the order asked, so each snapshot is matched to its
+    // id by position rather than by a field of the snapshot.
+    const found = await firestore.getAll(...readable.map((id)=>containers.ref.doc(id)));
+    const byId = new Map(readable.map((id, index)=>[
+            id,
+            found[index]
+        ]));
+    return ids.map((id)=>recordOf(id, byId.get(id), containers.nameField));
+}
+/**
+ * Up to `ceiling` of the organization's containers of a kind, in document
+ * order, retired ones included and marked: a caller that matches by name
+ * decides what a retired one means to it. Read as a projection of the
+ * fields a record carries.
+ */ export async function listOrgContainers(firestore, kind, orgId, ceiling) {
+    const containers = containersOf(firestore, kind, orgId);
+    if (!containers || ceiling <= 0) return [];
+    const snapshot = await containers.ref.select(...fieldsOf(containers.nameField)).limit(ceiling).get();
+    return snapshot.docs.map((doc)=>recordOf(doc.id, doc, containers.nameField));
+}
+/**
+ * Up to `limit` of the organization's containers of a kind whose declared
+ * name field is exactly `name`, retired ones included and marked, so a caller
+ * resolving a name can tell a live match from a retired one sharing it.
+ */ export async function findOrgContainersByName(firestore, kind, orgId, name, limit) {
+    const containers = containersOf(firestore, kind, orgId);
+    const wanted = name.trim();
+    if (!containers || !wanted || limit <= 0) return [];
+    const snapshot = await containers.ref.where(containers.nameField, '==', wanted).select(...fieldsOf(containers.nameField)).limit(limit).get();
+    return snapshot.docs.map((doc)=>recordOf(doc.id, doc, containers.nameField));
+}
+
+//# sourceMappingURL=org-containers.js.map

package/src/lib/server/org-containers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/tenant/data/admin/src/lib/server/org-containers.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 { pluginContainerKind } from '@aglyn/aglyn/plugin-manager/plugin-containers'\nimport { isDocumentId } from './document-id'\n\n/**\n * AN ORGANIZATION'S CONTAINERS OF ONE KIND, read on the server by a plugin\n * that files its records under them and does not keep them.\n *\n * A container kind is declared by the plugin that keeps it\n * (`plugin-manager/plugin-containers.ts`): which org collection holds the\n * containers and which field names one. That declaration is the whole of what\n * another plugin may rely on — a container's id, its name, the sites its\n * `visibleTo` places it on, and whether its owner retired it (`deletedAt`) —\n * and this module reads exactly that, where the declaration says. A sequence\n * that validates the campaigns it is filed under, an import that matches\n * campaign names, a timeline entry that names the campaign a lead was filed\n * under: none of them names the owner's collection, so the owner may move it.\n *\n * A kind no plugin keeps reads nothing: every id answers as gone, and a list\n * is empty. That is the honest answer for a workspace without the owner.\n */\n\n/** One container, as much of it as a plugin that files under it may read. */\nexport interface OrgContainerRecord {\n  id: string\n  /** The org holds a container under this id, retired or not. */\n  exists: boolean\n  /** It exists and its owner has not retired it. */\n  live: boolean\n  /** Its name, from the field its kind declares; `''` when it has none or is gone. */\n  name: string\n  /** Its `visibleTo` scope tokens; `[]` when it has none or is gone. */\n  visibleTo: string[]\n}\n\ntype Snapshot = Pick<FirebaseFirestore.DocumentSnapshot, 'exists' | 'get'>\n\nfunction recordOf(id: string, snapshot: Snapshot | undefined, nameField: string): OrgContainerRecord {\n  if (!snapshot?.exists) return { id, exists: false, live: false, name: '', visibleTo: [] }\n  const visibleTo = snapshot.get('visibleTo')\n  return {\n    id,\n    exists: true,\n    live: !snapshot.get('deletedAt'),\n    name: String(snapshot.get(nameField) ?? '').trim(),\n    visibleTo: Array.isArray(visibleTo) ? visibleTo.map(String) : [],\n  }\n}\n\n/**\n * The fields a reader may rely on, and the only ones a listing reads: a\n * container can be a large document, and nothing here needs the rest.\n */\nconst fieldsOf = (nameField: string) => [nameField, 'deletedAt', 'visibleTo']\n\n/** The kind's collection under the org, or `null` when no plugin keeps the kind. */\nfunction containersOf(\n  firestore: FirebaseFirestore.Firestore,\n  kind: string,\n  orgId: string,\n): { ref: FirebaseFirestore.CollectionReference; nameField: string } | null {\n  const declared = pluginContainerKind(kind)\n  if (!declared || !isDocumentId(orgId)) return null\n  return {\n    ref: firestore.collection('orgs').doc(orgId).collection(declared.orgCollection),\n    nameField: declared.nameField,\n  }\n}\n\n/**\n * The containers named by `ids`, one record per id in the order asked: one\n * keyed read each, in a single `getAll`. An id that cannot be a document id\n * is answered as gone without a read.\n *\n * Throws what the read throws; a caller that must not fail on it catches.\n */\nexport async function readOrgContainers(\n  firestore: FirebaseFirestore.Firestore,\n  kind: string,\n  orgId: string,\n  ids: readonly string[],\n): Promise<OrgContainerRecord[]> {\n  if (!ids.length) return []\n  const containers = containersOf(firestore, kind, orgId)\n  const readable = ids.filter((id) => isDocumentId(id))\n  if (!containers || !readable.length) return ids.map((id) => recordOf(id, undefined, ''))\n  // `getAll` answers in the order asked, so each snapshot is matched to its\n  // id by position rather than by a field of the snapshot.\n  const found = await firestore.getAll(...readable.map((id) => containers.ref.doc(id)))\n  const byId = new Map(readable.map((id, index) => [id, found[index]]))\n  return ids.map((id) => recordOf(id, byId.get(id), containers.nameField))\n}\n\n/**\n * Up to `ceiling` of the organization's containers of a kind, in document\n * order, retired ones included and marked: a caller that matches by name\n * decides what a retired one means to it. Read as a projection of the\n * fields a record carries.\n */\nexport async function listOrgContainers(\n  firestore: FirebaseFirestore.Firestore,\n  kind: string,\n  orgId: string,\n  ceiling: number,\n): Promise<OrgContainerRecord[]> {\n  const containers = containersOf(firestore, kind, orgId)\n  if (!containers || ceiling <= 0) return []\n  const snapshot = await containers.ref\n    .select(...fieldsOf(containers.nameField))\n    .limit(ceiling)\n    .get()\n  return snapshot.docs.map((doc) => recordOf(doc.id, doc, containers.nameField))\n}\n\n/**\n * Up to `limit` of the organization's containers of a kind whose declared\n * name field is exactly `name`, retired ones included and marked, so a caller\n * resolving a name can tell a live match from a retired one sharing it.\n */\nexport async function findOrgContainersByName(\n  firestore: FirebaseFirestore.Firestore,\n  kind: string,\n  orgId: string,\n  name: string,\n  limit: number,\n): Promise<OrgContainerRecord[]> {\n  const containers = containersOf(firestore, kind, orgId)\n  const wanted = name.trim()\n  if (!containers || !wanted || limit <= 0) return []\n  const snapshot = await containers.ref\n    .where(containers.nameField, '==', wanted)\n    .select(...fieldsOf(containers.nameField))\n    .limit(limit)\n    .get()\n  return snapshot.docs.map((doc) => recordOf(doc.id, doc, containers.nameField))\n}\n"],"names":["pluginContainerKind","isDocumentId","recordOf","id","snapshot","nameField","exists","live","name","visibleTo","get","String","trim","Array","isArray","map","fieldsOf","containersOf","firestore","kind","orgId","declared","ref","collection","doc","orgCollection","readOrgContainers","ids","length","containers","readable","filter","undefined","found","getAll","byId","Map","index","listOrgContainers","ceiling","select","limit","docs","findOrgContainersByName","wanted","where"],"mappings":"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"}

package/src/lib/server/org-member-notice.js

@@ -73,9 +73,10 @@ const MAX_SENDS = 25;
             'notice.subject': input.subject,
             'notice.body': input.text,
             'org.name': (_brand_orgName = brand.orgName) != null ? _brand_orgName : ''
-        }, brand, {
+        }, brand, // The last resort reads as the built-in copy does: subject, then body.
+        {
             subject: input.subject,
-            text: input.text
+            text: `${input.subject}\n\n${input.text}`
         });
         let sent = 0;
         for (const to of recipients.slice(0, MAX_SENDS)){

package/src/lib/server/org-member-notice.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../../libs/tenant/data/admin/src/lib/server/org-member-notice.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 { isEmailConfigured, sendEmail } from '@aglyn/shared-util-email'\nimport { withoutMailWithheldAccounts } from './account-mail'\nimport { findUserByUidAcrossPools } from './auth-pools'\nimport { filterSuppressedEmails } from './email-suppression'\nimport { listOrgMembers } from './organizations'\nimport { orgSystemEmailBrand, renderSystemEmailContent } from './render-system-email'\n\n/**\n * A NOTICE TO NAMED MEMBERS OF AN ORGANIZATION, BY EMAIL (AGL-3244).\n *\n * The console notification (`notifications.ts`) is the record, and its email\n * channel is a preference that defaults off. Some things cannot wait on a\n * preference: a sequence mailbox that paused itself holds every enrollment\n * on it until its owner acts, and the owner is not watching the page. This\n * sends the email regardless, to the members named and — when asked — to\n * the organization's owners and admins beside them, one send per address\n * so nobody is shown anyone else's.\n *\n * Addresses come from the roster (`orgs/{orgId}/members/{uid}.email`), and\n * for a member whose row carries none, from the directory. Suppressed\n * addresses are skipped, the send is metered to the organization, and\n * nothing here throws: the notice is a courtesy beside a state the caller\n * already wrote.\n */\n\nexport interface OrgMemberNoticeInput {\n  orgId: string\n  /** The members to write to, by uid. */\n  uids: readonly string[]\n  /** Also the organization's owners and admins. */\n  includeAdmins?: boolean\n  subject: string\n  text: string\n  /** Resend tag / log label. */\n  context: string\n}\n\nexport interface OrgMemberNoticeResult {\n  /** Addresses the notice went to. */\n  sent: number\n  /** Why nothing could be sent at all, when nothing could. */\n  reason?: 'unconfigured' | 'no-recipients' | 'failed'\n}\n\n/** At most this many directory lookups, and this many sends, per notice. */\nconst MAX_LOOKUPS = 10\nconst MAX_SENDS = 25\n\n/** Sends one notice to each member — see the module note. */\nexport async function sendOrgMemberNotice(input: OrgMemberNoticeInput): Promise<OrgMemberNoticeResult> {\n  if (!isEmailConfigured()) return { sent: 0, reason: 'unconfigured' }\n  try {\n    const members = await listOrgMembers(input.orgId)\n    const rosterEmail = new Map<string, string>()\n    for (const member of members) {\n      const address = String(member.email ?? '')\n        .trim()\n        .toLowerCase()\n      if (address.includes('@')) rosterEmail.set(member.$id, address)\n    }\n    const uids = new Set(input.uids.filter(Boolean))\n    if (input.includeAdmins) {\n      for (const member of members) {\n        if (member.role === 'owner' || member.role === 'admin') uids.add(member.$id)\n      }\n    }\n    const addresses = new Set<string>()\n    let lookups = 0\n    // A locked or disabled account is not mailed (AGL-3418).\n    for (const uid of await withoutMailWithheldAccounts([...uids])) {\n      let address = rosterEmail.get(uid) ?? ''\n      if (!address && lookups < MAX_LOOKUPS) {\n        lookups += 1\n        const pooled = await findUserByUidAcrossPools(uid).catch(() => null)\n        address = String(pooled?.record?.email ?? '')\n          .trim()\n          .toLowerCase()\n      }\n      if (address.includes('@')) addresses.add(address)\n    }\n    const recipients = await filterSuppressedEmails([...addresses])\n    if (!recipients.length) return { sent: 0, reason: 'no-recipients' }\n    // One message for everyone, in the organization's brand, as the\n    // `workspace-notice` system email (AGL-3367).\n    const brand = await orgSystemEmailBrand(input.orgId)\n    const content = await renderSystemEmailContent(\n      'workspace-notice',\n      {\n        'notice.subject': input.subject,\n        'notice.body': input.text,\n        'org.name': brand.orgName ?? '',\n      },\n      brand,\n      { subject: input.subject, text: input.text },\n    )\n    let sent = 0\n    for (const to of recipients.slice(0, MAX_SENDS)) {\n      const result = await sendEmail({\n        to,\n        ...content,\n        ...(brand.fromName ? { fromName: brand.fromName } : {}),\n        context: input.context,\n      })\n      if (!result.sent) continue\n      sent += 1\n      const { meterOrgEmail } = await import('./email-metering')\n      await meterOrgEmail(input.orgId).catch(() => undefined)\n    }\n    return sent ? { sent } : { sent: 0, reason: 'failed' }\n  } catch (error) {\n    console.error('[org-member-notice] send failed', error)\n    return { sent: 0, reason: 'failed' }\n  }\n}\n"],"names":["isEmailConfigured","sendEmail","withoutMailWithheldAccounts","findUserByUidAcrossPools","filterSuppressedEmails","listOrgMembers","orgSystemEmailBrand","renderSystemEmailContent","MAX_LOOKUPS","MAX_SENDS","sendOrgMemberNotice","input","sent","reason","brand","members","orgId","rosterEmail","Map","member","address","String","email","trim","toLowerCase","includes","set","$id","uids","Set","filter","Boolean","includeAdmins","role","add","addresses","lookups","uid","get","pooled","catch","record","recipients","length","content","subject","text","orgName","to","slice","result","fromName","context","meterOrgEmail","undefined","error","console"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../../libs/tenant/data/admin/src/lib/server/org-member-notice.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 { isEmailConfigured, sendEmail } from '@aglyn/shared-util-email'\nimport { withoutMailWithheldAccounts } from './account-mail'\nimport { findUserByUidAcrossPools } from './auth-pools'\nimport { filterSuppressedEmails } from './email-suppression'\nimport { listOrgMembers } from './organizations'\nimport { orgSystemEmailBrand, renderSystemEmailContent } from './render-system-email'\n\n/**\n * A NOTICE TO NAMED MEMBERS OF AN ORGANIZATION, BY EMAIL (AGL-3244).\n *\n * The console notification (`notifications.ts`) is the record, and its email\n * channel is a preference that defaults off. Some things cannot wait on a\n * preference: a sequence mailbox that paused itself holds every enrollment\n * on it until its owner acts, and the owner is not watching the page. This\n * sends the email regardless, to the members named and — when asked — to\n * the organization's owners and admins beside them, one send per address\n * so nobody is shown anyone else's.\n *\n * Addresses come from the roster (`orgs/{orgId}/members/{uid}.email`), and\n * for a member whose row carries none, from the directory. Suppressed\n * addresses are skipped, the send is metered to the organization, and\n * nothing here throws: the notice is a courtesy beside a state the caller\n * already wrote.\n */\n\nexport interface OrgMemberNoticeInput {\n  orgId: string\n  /** The members to write to, by uid. */\n  uids: readonly string[]\n  /** Also the organization's owners and admins. */\n  includeAdmins?: boolean\n  subject: string\n  text: string\n  /** Resend tag / log label. */\n  context: string\n}\n\nexport interface OrgMemberNoticeResult {\n  /** Addresses the notice went to. */\n  sent: number\n  /** Why nothing could be sent at all, when nothing could. */\n  reason?: 'unconfigured' | 'no-recipients' | 'failed'\n}\n\n/** At most this many directory lookups, and this many sends, per notice. */\nconst MAX_LOOKUPS = 10\nconst MAX_SENDS = 25\n\n/** Sends one notice to each member — see the module note. */\nexport async function sendOrgMemberNotice(input: OrgMemberNoticeInput): Promise<OrgMemberNoticeResult> {\n  if (!isEmailConfigured()) return { sent: 0, reason: 'unconfigured' }\n  try {\n    const members = await listOrgMembers(input.orgId)\n    const rosterEmail = new Map<string, string>()\n    for (const member of members) {\n      const address = String(member.email ?? '')\n        .trim()\n        .toLowerCase()\n      if (address.includes('@')) rosterEmail.set(member.$id, address)\n    }\n    const uids = new Set(input.uids.filter(Boolean))\n    if (input.includeAdmins) {\n      for (const member of members) {\n        if (member.role === 'owner' || member.role === 'admin') uids.add(member.$id)\n      }\n    }\n    const addresses = new Set<string>()\n    let lookups = 0\n    // A locked or disabled account is not mailed (AGL-3418).\n    for (const uid of await withoutMailWithheldAccounts([...uids])) {\n      let address = rosterEmail.get(uid) ?? ''\n      if (!address && lookups < MAX_LOOKUPS) {\n        lookups += 1\n        const pooled = await findUserByUidAcrossPools(uid).catch(() => null)\n        address = String(pooled?.record?.email ?? '')\n          .trim()\n          .toLowerCase()\n      }\n      if (address.includes('@')) addresses.add(address)\n    }\n    const recipients = await filterSuppressedEmails([...addresses])\n    if (!recipients.length) return { sent: 0, reason: 'no-recipients' }\n    // One message for everyone, in the organization's brand, as the\n    // `workspace-notice` system email (AGL-3367).\n    const brand = await orgSystemEmailBrand(input.orgId)\n    const content = await renderSystemEmailContent(\n      'workspace-notice',\n      {\n        'notice.subject': input.subject,\n        'notice.body': input.text,\n        'org.name': brand.orgName ?? '',\n      },\n      brand,\n      // The last resort reads as the built-in copy does: subject, then body.\n      { subject: input.subject, text: `${input.subject}\\n\\n${input.text}` },\n    )\n    let sent = 0\n    for (const to of recipients.slice(0, MAX_SENDS)) {\n      const result = await sendEmail({\n        to,\n        ...content,\n        ...(brand.fromName ? { fromName: brand.fromName } : {}),\n        context: input.context,\n      })\n      if (!result.sent) continue\n      sent += 1\n      const { meterOrgEmail } = await import('./email-metering')\n      await meterOrgEmail(input.orgId).catch(() => undefined)\n    }\n    return sent ? { sent } : { sent: 0, reason: 'failed' }\n  } catch (error) {\n    console.error('[org-member-notice] send failed', error)\n    return { sent: 0, reason: 'failed' }\n  }\n}\n"],"names":["isEmailConfigured","sendEmail","withoutMailWithheldAccounts","findUserByUidAcrossPools","filterSuppressedEmails","listOrgMembers","orgSystemEmailBrand","renderSystemEmailContent","MAX_LOOKUPS","MAX_SENDS","sendOrgMemberNotice","input","sent","reason","brand","members","orgId","rosterEmail","Map","member","address","String","email","trim","toLowerCase","includes","set","$id","uids","Set","filter","Boolean","includeAdmins","role","add","addresses","lookups","uid","get","pooled","catch","record","recipients","length","content","subject","text","orgName","to","slice","result","fromName","context","meterOrgEmail","undefined","error","console"],"mappings":"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"}

package/src/lib/server/payment-fraud-signal.js

@@ -37,6 +37,7 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  * substituting the admin barrel substitutes these too.
  *=========================================*/ import { createHash } from "crypto";
 import { ABUSE_REPORT_COLLECTION } from "@aglyn/aglyn/app-utils/abuse-report";
+import { RISK_PAYMENT_EVENTS } from "@aglyn/shared-util-email/risk-notice-catalog";
 import { FieldValue } from "firebase-admin/firestore";
 const KIND_LABEL = {
     'early-fraud-warning': 'Early fraud warning',
@@ -176,7 +177,7 @@ const KIND_LABEL = {
         merge: true
     });
     if (first) {
-        var _ref, _signal_chargeId;
+        var _RISK_PAYMENT_EVENTS_signal_kind, _ref, _signal_chargeId;
         // The workspace's owners are told their subscription payment was
         // flagged and how to confirm it; staff get the row with the evidence.
         await deps.notifyRisk({
@@ -189,6 +190,9 @@ const KIND_LABEL = {
                 path: '/org/billing/invoices'
             },
             amount: formatSignalAmount(signal.amountCents, signal.currency),
+            // A dispute is the bank's, already opened; a warning or a review is
+            // a fraud check. The notice says which.
+            paymentEvent: (_RISK_PAYMENT_EVENTS_signal_kind = RISK_PAYMENT_EVENTS[signal.kind]) != null ? _RISK_PAYMENT_EVENTS_signal_kind : null,
             stripeUrl: stripeSignalDashboardUrl(signal),
             staffEvidence: `${KIND_LABEL[signal.kind]} (${signal.stripeObjectId}) on charge ` + `${(_ref = (_signal_chargeId = signal.chargeId) != null ? _signal_chargeId : signal.paymentIntentId) != null ? _ref : 'not named'}` + (signal.detail ? `; Stripe says: ${signal.detail}` : '') + (signal.livemode ? '' : ' — TEST MODE') + '.'
         }).catch(()=>undefined);