@aglyn/tenant-data-admin 1.0.0-beta.221 → 1.0.0-beta.223

package/src/lib/server/platform-marketing-consent.js

@@ -62,15 +62,16 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  * The console's switch undoes it the same way, one list wide: a Yes from a
  * verified account asks the plugin that keeps the site's preferences to
  * reopen that list and nothing else (`plugin-email-streams`).
- */ import { readTopicSubscriptionState, TOPIC_OPT_OUTS_SUBCOLLECTION } from "@aglyn/aglyn/app-utils/subscription-topics";
+ */ import { stampRecordOrigin } from "@aglyn/aglyn/plugin-manager/plugin-record-origin";
+import { readTopicSubscriptionState, TOPIC_OPT_OUTS_SUBCOLLECTION } from "@aglyn/aglyn/app-utils/subscription-topics";
 import { isPlatformMarketingConsentDecision, isPlatformMarketingConsoleSourceKind, isPlatformMarketingEmailSourceKind, platformMarketingConsentSource, platformMarketingEmailSource, PLATFORM_MARKETING_TOPIC_ID, platformMarketingUserFields, readPlatformMarketingConsent, USER_MARKETING_PROMPT_DISMISSED_AT_FIELD } from "@aglyn/aglyn/app-utils/platform-marketing-consent";
 import { marketingConsentDecision, readMarketingBasis, resolveMarketingConsentPolicy } from "@aglyn/aglyn/app-utils/marketing-consent";
 import { rejoinEmailStream } from "@aglyn/aglyn/plugin-manager/plugin-email-streams";
 import { attributableAccountForAddress } from "./account-addresses.js";
-import { findContactByEmail } from "./contact-email-index.js";
+import { findPluginPerson } from "@aglyn/aglyn/plugin-manager/plugin-person-records";
 import { EMAIL_SUPPRESSIONS_COLLECTION, emailSuppressionKey, HOST_SUPPRESSIONS_SUBCOLLECTION } from "./email-suppression.js";
 import firebaseAdmin from "./firebase-admin.js";
-import { consentGroupForSite, getOrgForHost, orgDataCollectionForHost } from "./organizations.js";
+import { consentGroupForSite, getOrgForHost } from "./organizations.js";
 import { upsertHostContact } from "./upsert-contact.js";
 const firestore = ()=>firebaseAdmin.app().firestore();
 /**
@@ -192,6 +193,16 @@ const firestore = ()=>firebaseAdmin.app().firestore();
         contactId: verdict.contactId,
         created: verdict.created
     };
+    // Where the person came from (AGL-3519): an account sign-up, on a record
+    // the platform's own CRM just started and that names no lead source.
+    if (contact.status === 'recorded') {
+        await stampRecordOrigin({
+            hostId,
+            email,
+            origin: 'account',
+            firstTouchOnly: true
+        });
+    }
     if (input.decision !== 'granted') return {
         atMs,
         contact
@@ -320,33 +331,38 @@ const firestore = ()=>firebaseAdmin.app().firestore();
     };
     const db = (_input_firestore = input.firestore) != null ? _input_firestore : firestore();
     try {
-        var _ref, _ref1, _ref2;
-        var _contact_data, _record_source;
+        var _ref, _ref1;
+        var _record_source;
         const owner = await getOrgForHost(hostId);
         if (!owner) return {
             status: 'unreadable',
             hostId
         };
         const org = owner.org;
-        const [contact, group, suppression, topic] = await Promise.all([
-            // Through the org-data seam, as the capture door finds the same row.
-            orgDataCollectionForHost(hostId, 'contacts').then((contacts)=>findContactByEmail(contacts, email)),
+        const [person, group, suppression, topic] = await Promise.all([
+            // The operator's person for the address, asked of the plugin that
+            // keeps people (AGL-3080) — the record the capture door wrote.
+            findPluginPerson({
+                orgId: owner.orgId,
+                hostId,
+                email
+            }),
             consentGroupForSite(hostId, org),
             readPlatformMarketingSuppression(db, hostId, email),
             readPlatformMarketingTopic(db, hostId, email)
         ]);
-        const record = readMarketingBasis((_ref = contact == null ? void 0 : (_contact_data = contact.data) == null ? void 0 : _contact_data.call(contact)) != null ? _ref : null, group);
+        const record = readMarketingBasis(person ? _extends({}, person.data) : null, group);
         const decision = marketingConsentDecision(record, resolveMarketingConsentPolicy(org['marketingConsentPolicy']));
         return {
             status: 'read',
             hostId,
             orgId: owner.orgId,
             orgSlug: typeof org['slug'] === 'string' ? org['slug'] : null,
-            contactId: (_ref1 = contact == null ? void 0 : contact.id) != null ? _ref1 : null,
+            contactId: (_ref = person == null ? void 0 : person.id) != null ? _ref : null,
             basis: record.basis,
             basisAtMs: record.basisAtMs,
             assertedBy: record.assertedBy,
-            basisKind: (_ref2 = (_record_source = record.source) == null ? void 0 : _record_source.kind) != null ? _ref2 : null,
+            basisKind: (_ref1 = (_record_source = record.source) == null ? void 0 : _record_source.kind) != null ? _ref1 : null,
             verdict: decision.verdict,
             reason: decision.reason,
             suppression,

package/src/lib/server/platform-marketing-consent.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../../libs/tenant/data/admin/src/lib/server/platform-marketing-consent.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\n/**\n * The record a console door writes when a person decides about the\n * platform's own product email (AGL-3185).\n *\n * ## Two documents, one decision\n *\n * The decision goes onto the person's own `users/{uid}` first — the console\n * shows the preference from there, and it must not depend on the operator's\n * CRM accepting a row — and then onto the operator's marketing contact for\n * the same address through `upsertHostContact`, which is every other capture\n * door's path and the only one the send-time consent join reads. The contact\n * half carries the decision AND its provenance, so a campaign's audience\n * count reports this basis as the person's own click and never as something\n * asserted on their behalf.\n *\n * ## Server-side, because the client cannot and should not\n *\n * The sign-up page is a client of the person's own project; the operator's\n * marketing org is somebody else's data. Only the Admin SDK writes there, and\n * only after the person's ID token has been verified by the route in front\n * of this module. The user-document half could be a client write — the rules\n * make it owner-writable — but a mirror the client writes and the server\n * reads back is two writers of one fact, so both halves are written here.\n *\n * ## Which host, and why it is a setting\n *\n * The marketing host is the deployment's, not the code's: this repository is\n * what a self-hosted install runs, and an install with no product audience of\n * its own has nowhere for a contact to go. `PLATFORM_MARKETING_HOST_ID` names\n * it, and when it is unset the decision is recorded on the person's document\n * alone. No hostname or document id is hardcoded here for the same reason\n * `platform-marketing-host.ts` gives: nothing in the code knows which site\n * is the operator's.\n *\n * ## The site's own pages answer the same question, for one list (AGL-3305)\n *\n * The marketing site's emails carry their own way out, and it writes the\n * site's lists, not either consent record. An unsubscribe that was about the\n * list the console's question stands for — `PLATFORM_MARKETING_TOPIC_ID`, or\n * everything the site sends — is mirrored onto the ACCOUNT here, through an\n * email door; an unsubscribe from any other list is not, because the person\n * said nothing about product updates. The contact is left alone on purpose:\n * its basis covers every list the site sends, and declining it would stop the\n * newsletter for somebody who only left product updates.\n *\n * The console's switch undoes it the same way, one list wide: a Yes from a\n * verified account asks the plugin that keeps the site's preferences to\n * reopen that list and nothing else (`plugin-email-streams`).\n */\n\nimport {\n  readTopicSubscriptionState,\n  TOPIC_OPT_OUTS_SUBCOLLECTION,\n  type TopicSubscriptionEntry,\n  type TopicSubscriptionState,\n} from '@aglyn/aglyn/app-utils/subscription-topics'\nimport {\n  isPlatformMarketingConsentDecision,\n  isPlatformMarketingConsoleSourceKind,\n  isPlatformMarketingEmailSourceKind,\n  type PlatformMarketingConsentDecision,\n  type PlatformMarketingConsoleSourceKind,\n  type PlatformMarketingConsentState,\n  platformMarketingConsentSource,\n  platformMarketingEmailSource,\n  PLATFORM_MARKETING_TOPIC_ID,\n  platformMarketingUserFields,\n  readPlatformMarketingConsent,\n  USER_MARKETING_PROMPT_DISMISSED_AT_FIELD,\n} from '@aglyn/aglyn/app-utils/platform-marketing-consent'\nimport {\n  marketingConsentDecision,\n  type MarketingBasis,\n  type MarketingConsentAssertedBy,\n  type MarketingConsentReason,\n  type MarketingConsentVerdict,\n  readMarketingBasis,\n  resolveMarketingConsentPolicy,\n} from '@aglyn/aglyn/app-utils/marketing-consent'\nimport {\n  type EmailStreamRejoinOutcome,\n  rejoinEmailStream,\n} from '@aglyn/aglyn/plugin-manager/plugin-email-streams'\nimport { attributableAccountForAddress } from './account-addresses'\nimport { findContactByEmail } from './contact-email-index'\nimport {\n  EMAIL_SUPPRESSIONS_COLLECTION,\n  emailSuppressionKey,\n  HOST_SUPPRESSIONS_SUBCOLLECTION,\n} from './email-suppression'\nimport firebaseAdmin from './firebase-admin'\nimport {\n  consentGroupForSite,\n  getOrgForHost,\n  orgDataCollectionForHost,\n} from './organizations'\nimport { upsertHostContact } from './upsert-contact'\n\nconst firestore = () => firebaseAdmin.app().firestore()\n\n/**\n * The variable naming the host whose contacts receive product-marketing\n * consent — the operator's own marketing site. Unset on a self-hosted\n * install, and honored as \"record the preference, capture no contact\".\n */\nexport const PLATFORM_MARKETING_HOST_ID_ENV = 'PLATFORM_MARKETING_HOST_ID'\n\n/**\n * The configured marketing host, or `null` when the deployment names none.\n *\n * Read at call time rather than at module load, so a test can set it and a\n * process that started without it picks up a later value the same way every\n * other runtime setting here does.\n */\nexport function platformMarketingHostId(): string | null {\n  const value = String(process.env.PLATFORM_MARKETING_HOST_ID ?? '').trim()\n  return value || null\n}\n\n/** What became of the contact half of the record. */\nexport type PlatformMarketingContactOutcome =\n  | { status: 'recorded'; contactId: string; created: boolean }\n  /** No marketing host is configured — a self-hosted install. */\n  | { status: 'unconfigured' }\n  /** The account carries no address a contact could be keyed on. */\n  | { status: 'no-email' }\n  /** The capture door refused the row — its band, an erasure, or an error. */\n  | { status: 'refused'; reason: string }\n\nexport interface RecordPlatformMarketingConsentInput {\n  uid: string\n  /** The account's address, from the verified token. */\n  email: string | null | undefined\n  /** The name the token carries, for an account whose document holds none. */\n  name?: string | null\n  decision: PlatformMarketingConsentDecision\n  /** A console door. An email door is recorded by the site's own pages. */\n  source: PlatformMarketingConsoleSourceKind\n  /** The wording version the door showed, stamped by the route. */\n  textVersion: string\n  /**\n   * Whether the token proves the caller holds the mailbox — its email is\n   * verified (AGL-3305). Only then does a Yes reopen the list on the\n   * marketing site, because reopening it reverses what somebody did from\n   * that mailbox; an unverified account could name a stranger's address.\n   */\n  mailboxVerified?: boolean\n  /** Injectable for tests; defaults to the clock. */\n  now?: number\n  /** Injectable for tests; defaults to the admin app's Firestore. */\n  firestore?: any\n  /** Injectable for tests; defaults to {@link platformMarketingHostId}. */\n  hostId?: string | null\n  /** Injectable for tests; defaults to the real capture door. */\n  upsert?: typeof upsertHostContact\n  /** Injectable for tests; defaults to the `plugin-email-streams` slot. */\n  rejoin?: typeof rejoinEmailStream\n}\n\n/**\n * What a Yes did to the marketing site's own lists (AGL-3305). Absent for a\n * No, and whenever there is no site or no address to reopen a list for.\n */\nexport type PlatformMarketingStreamOutcome =\n  | EmailStreamRejoinOutcome\n  /** The token does not prove the mailbox, so nothing was reopened. */\n  | { status: 'unverified' }\n\nexport interface RecordPlatformMarketingConsentResult {\n  /** The timestamp both documents carry. */\n  atMs: number\n  contact: PlatformMarketingContactOutcome\n  stream?: PlatformMarketingStreamOutcome\n}\n\n/**\n * The name the person's own document holds, else the one the caller has.\n *\n * The sign-up form writes `firstName`/`lastName` onto the document; a Google\n * account carries its name on the token instead. Either is the name the\n * contact row should show, and a blank is left blank rather than invented.\n */\nfunction accountName(\n  snapshot: { get?: (field: string) => unknown } | null | undefined,\n  fallback: string | null | undefined,\n): string | undefined {\n  const first = String(snapshot?.get?.('firstName') ?? '').trim()\n  const last = String(snapshot?.get?.('lastName') ?? '').trim()\n  const stored = [first, last].filter(Boolean).join(' ')\n  return stored || String(fallback ?? '').trim() || undefined\n}\n\n/**\n * Records a decision on both documents.\n *\n * Loud on bad input, like `recordLegalAcceptance`: a decision that cannot be\n * attributed to an account, a door and a wording is not a record of anything.\n * Quiet on the contact half — a refused row is returned, not thrown — because\n * the person's own preference has already been recorded by then, and the\n * operator's CRM band is not a reason to tell them their choice failed.\n */\nexport async function recordPlatformMarketingConsent(\n  input: RecordPlatformMarketingConsentInput,\n): Promise<RecordPlatformMarketingConsentResult> {\n  const uid = String(input.uid ?? '').trim()\n  if (!uid) throw new Error('recordPlatformMarketingConsent: uid is required')\n  if (!isPlatformMarketingConsentDecision(input.decision)) {\n    throw new Error('recordPlatformMarketingConsent: decision is required')\n  }\n  if (!isPlatformMarketingConsoleSourceKind(input.source)) {\n    throw new Error('recordPlatformMarketingConsent: a console source is required')\n  }\n  const textVersion = String(input.textVersion ?? '').trim()\n  if (!textVersion) {\n    throw new Error('recordPlatformMarketingConsent: textVersion is required')\n  }\n\n  const atMs = input.now ?? Date.now()\n  const source = platformMarketingConsentSource({\n    kind: input.source,\n    decision: input.decision,\n    uid,\n    atMs,\n    textVersion,\n  })\n\n  const userRef = (input.firestore ?? firestore()).collection('users').doc(uid)\n  const snapshot = await userRef.get()\n  await userRef.set(\n    platformMarketingUserFields({ decision: input.decision, atMs, source }),\n    { merge: true },\n  )\n\n  const hostId =\n    input.hostId === undefined ? platformMarketingHostId() : input.hostId\n  if (!hostId) return { atMs, contact: { status: 'unconfigured' } }\n  const email = String(input.email ?? '').trim()\n  if (!email) return { atMs, contact: { status: 'no-email' } }\n\n  const name = accountName(snapshot, input.name)\n  const verdict = await (input.upsert ?? upsertHostContact)({\n    hostId,\n    email,\n    ...(name ? { name } : {}),\n    source: 'account',\n    // The sentence the provenance carries is also the timeline row's: what\n    // the person did, in the words an auditor reads.\n    interaction: { atMs, summary: source.reason },\n    ...(input.decision === 'granted'\n      ? { marketingConsent: true }\n      : { declineMarketingConsent: true }),\n    marketingConsentSource: source,\n    // An account on the platform is at least a lead for the platform's own\n    // CRM, whichever way the marketing decision went; the floor never moves\n    // a customer back.\n    initialLifecycleStage: 'lead',\n  })\n  const contact: PlatformMarketingContactOutcome =\n    'refused' in verdict\n      ? { status: 'refused', reason: verdict.refused }\n      : { status: 'recorded', contactId: verdict.contactId, created: verdict.created }\n  if (input.decision !== 'granted') return { atMs, contact }\n\n  /*\n   * A Yes reopens the one list it stands for (AGL-3305).\n   *\n   * After the contact, whatever the contact's outcome: an erasure that\n   * refused the row also left a suppression the plugin will not lift, and it\n   * says so. One list wide, never \"resubscribe to everything\" — somebody who\n   * left every list and now asks for product updates has asked for product\n   * updates.\n   */\n  const stream: PlatformMarketingStreamOutcome = input.mailboxVerified\n    ? await (input.rejoin ?? rejoinEmailStream)({\n        hostId,\n        email,\n        topicId: PLATFORM_MARKETING_TOPIC_ID,\n      })\n    : { status: 'unverified' }\n  return { atMs, contact, stream }\n}\n\n/**\n * Stamps a prompt dismissal — no decision — so the console stays quiet for\n * the snooze window and asks once more after it.\n */\nexport async function snoozePlatformMarketingPrompt(\n  uid: string,\n  options: { now?: number; firestore?: any } = {},\n): Promise<{ atMs: number }> {\n  const trimmed = String(uid ?? '').trim()\n  if (!trimmed) throw new Error('snoozePlatformMarketingPrompt: uid is required')\n  const atMs = options.now ?? Date.now()\n  await (options.firestore ?? firestore())\n    .collection('users')\n    .doc(trimmed)\n    .set({ [USER_MARKETING_PROMPT_DISMISSED_AT_FIELD]: atMs }, { merge: true })\n  return { atMs }\n}\n\n/** The decision the person's own document holds, for the console to show. */\nexport async function readPlatformMarketingConsentForUser(\n  uid: string,\n  options: { firestore?: any } = {},\n): Promise<PlatformMarketingConsentState> {\n  const trimmed = String(uid ?? '').trim()\n  if (!trimmed) throw new Error('readPlatformMarketingConsentForUser: uid is required')\n  const snapshot = await (options.firestore ?? firestore())\n    .collection('users')\n    .doc(trimmed)\n    .get()\n  return readPlatformMarketingConsent(\n    (snapshot?.data?.() as Record<string, unknown> | undefined) ?? null,\n  )\n}\n\n/** An entry on one of the two lists every campaign send passes. */\nexport interface PlatformMarketingSuppression {\n  /** `site`: the marketing site's own list. `platform`: every sender's. */\n  list: 'site' | 'platform'\n  /** `unsubscribe` on the site list; `bounce`, `complaint` or `staff` platform-wide. */\n  reason: string\n}\n\n/**\n * What the operator's own product email would decide about one address\n * (AGL-3292), read the way a campaign from the marketing site reads it.\n *\n * The decision the person made lives on `users/{uid}`, and nothing a send\n * does looks there. A campaign from the configured marketing site reads the\n * CONTACT `recordPlatformMarketingConsent` wrote into that site's\n * organization — its basis for the site, under the organization's policy —\n * and then drops anybody on either suppression list, and a campaign on the\n * product-updates list anybody who left it. An unsubscribe writes those\n * lists; since AGL-3305 one about product updates also turns the account's\n * answer to No, but the contact's basis stays as it was, because it covers\n * every list the site sends. So a staff reader asking \"may we email them?\"\n * needs this half, and needs it from the sender's own readers — the same\n * basis read, consent group, policy and lists — or it answers a question no\n * send asks.\n */\nexport type PlatformMarketingReach =\n  /** No marketing site is configured — a self-hosted install. */\n  | { status: 'unconfigured' }\n  /** The account carries no address a contact could be keyed on. */\n  | { status: 'no-email' }\n  /** A read failed. Nothing about the person follows from it. */\n  | { status: 'unreadable'; hostId: string }\n  | {\n      status: 'read'\n      hostId: string\n      orgId: string\n      orgSlug: string | null\n      /** `null` when the operator's CRM holds no contact for the address. */\n      contactId: string | null\n      basis: MarketingBasis\n      basisAtMs: number | null\n      /** Whose act the basis is — a person's own, or an operator's assertion. */\n      assertedBy: MarketingConsentAssertedBy | null\n      /** Which door recorded the basis (`console-signup`, a form, a backfill). */\n      basisKind: string | null\n      /** The consent rule's answer alone, before either list is consulted. */\n      verdict: MarketingConsentVerdict\n      reason: MarketingConsentReason\n      /** The list that stops every send to the address, when one does. */\n      suppression: PlatformMarketingSuppression | null\n      /**\n       * The address on the list the account's answer stands for (AGL-3305):\n       * `opted-out` when they left product updates, `pending` while a\n       * confirmation is unanswered. A campaign on that list drops both.\n       */\n      topic: PlatformMarketingTopicState\n    }\n\n/** One address on {@link PLATFORM_MARKETING_TOPIC_ID}, as the site stores it. */\nexport interface PlatformMarketingTopicState {\n  id: string\n  state: TopicSubscriptionState\n  /** When they left it, for an `opted-out` state; else `null`. */\n  leftAtMs: number | null\n}\n\n/**\n * The entry that suppresses `email` for sends from `hostId`, if any.\n *\n * The site's own list first, because it is the one a person puts themselves\n * on from this sender's footer; the platform list second. The same two reads\n * `filterSendableForHost` makes: a site entry suppresses by existing, and a\n * platform entry until it is released.\n */\nasync function readPlatformMarketingSuppression(\n  db: any,\n  hostId: string,\n  email: string,\n): Promise<PlatformMarketingSuppression | null> {\n  const key = emailSuppressionKey(email)\n  if (!key) return null\n  const [site, platform] = await Promise.all([\n    db\n      .collection('hosts')\n      .doc(hostId)\n      .collection(HOST_SUPPRESSIONS_SUBCOLLECTION)\n      .doc(key)\n      .get(),\n    db.collection(EMAIL_SUPPRESSIONS_COLLECTION).doc(key).get(),\n  ])\n  if (site?.exists) {\n    return { list: 'site', reason: String(site.get('reason') ?? 'unsubscribe') }\n  }\n  if (platform?.exists && !platform.get('releasedAt')) {\n    return { list: 'platform', reason: String(platform.get('reason') ?? 'staff') }\n  }\n  return null\n}\n\n/** Milliseconds from a stored Firestore timestamp or a number, else `null`. */\nfunction storedMs(value: unknown): number | null {\n  if (typeof value === 'number' && Number.isFinite(value)) return value\n  const toMillis = (value as { toMillis?: () => number } | null)?.toMillis\n  return typeof toMillis === 'function' ? toMillis.call(value) : null\n}\n\n/**\n * Where the address stands on {@link PLATFORM_MARKETING_TOPIC_ID}.\n *\n * The site's per-topic record, read by key and through the one function that\n * knows its three states — the same read `filterTopicSendable` makes before\n * a campaign on that list goes out. No record is `subscribed`: nobody has\n * left a list they were never taken off.\n */\nasync function readPlatformMarketingTopic(\n  db: any,\n  hostId: string,\n  email: string,\n): Promise<PlatformMarketingTopicState> {\n  const key = emailSuppressionKey(email)\n  const unrecorded = { id: PLATFORM_MARKETING_TOPIC_ID, state: 'subscribed' as const, leftAtMs: null }\n  if (!key) return unrecorded\n  const snapshot = await db\n    .collection('hosts')\n    .doc(hostId)\n    .collection(TOPIC_OPT_OUTS_SUBCOLLECTION)\n    .doc(key)\n    .get()\n  if (!snapshot?.exists) return unrecorded\n  const entry = ((snapshot.get('topics') ?? {}) as Record<string, TopicSubscriptionEntry | undefined>)[\n    PLATFORM_MARKETING_TOPIC_ID\n  ]\n  const state = readTopicSubscriptionState(entry)\n  return {\n    id: PLATFORM_MARKETING_TOPIC_ID,\n    state,\n    leftAtMs: state === 'opted-out' ? storedMs(entry?.optedOutAt) : null,\n  }\n}\n\n/**\n * Reads {@link PlatformMarketingReach} for an address.\n *\n * Never throws: a failed read is `unreadable`, which the staff page shows as\n * unknown — never as \"no consent\", which would be a claim about the person.\n */\nexport async function readPlatformMarketingReach(input: {\n  email: string | null | undefined\n  /** Injectable for tests; defaults to {@link platformMarketingHostId}. */\n  hostId?: string | null\n  /** Injectable for tests; defaults to the admin app's Firestore. */\n  firestore?: any\n}): Promise<PlatformMarketingReach> {\n  const hostId =\n    input.hostId === undefined ? platformMarketingHostId() : input.hostId\n  if (!hostId) return { status: 'unconfigured' }\n  const email = String(input.email ?? '').trim().toLowerCase()\n  if (!email) return { status: 'no-email' }\n  const db = input.firestore ?? firestore()\n  try {\n    const owner = await getOrgForHost(hostId)\n    if (!owner) return { status: 'unreadable', hostId }\n    const org = owner.org as Record<string, unknown>\n    const [contact, group, suppression, topic] = await Promise.all([\n      // Through the org-data seam, as the capture door finds the same row.\n      orgDataCollectionForHost(hostId, 'contacts').then((contacts) =>\n        findContactByEmail(contacts, email),\n      ),\n      consentGroupForSite(hostId, org),\n      readPlatformMarketingSuppression(db, hostId, email),\n      readPlatformMarketingTopic(db, hostId, email),\n    ])\n    const record = readMarketingBasis(\n      (contact?.data?.() as Record<string, unknown> | undefined) ?? null,\n      group,\n    )\n    const decision = marketingConsentDecision(\n      record,\n      resolveMarketingConsentPolicy(org['marketingConsentPolicy']),\n    )\n    return {\n      status: 'read',\n      hostId,\n      orgId: owner.orgId,\n      orgSlug: typeof org['slug'] === 'string' ? org['slug'] : null,\n      contactId: contact?.id ?? null,\n      basis: record.basis,\n      basisAtMs: record.basisAtMs,\n      assertedBy: record.assertedBy,\n      basisKind: record.source?.kind ?? null,\n      verdict: decision.verdict,\n      reason: decision.reason,\n      suppression,\n      topic,\n    }\n  } catch (error) {\n    console.error('[platform-marketing-consent] reach read failed', error)\n    return { status: 'unreadable', hostId }\n  }\n}\n\n/**\n * Why somebody who said Yes will not receive product updates, in the terms\n * of what they can do about it (AGL-3305) — or `null` when nothing on the\n * marketing site's lists stands in the way.\n *\n * - `unsubscribed`: they left everything, or left product updates, from an\n *   email. Theirs to undo, and a Yes from a verified account does.\n * - `unconfirmed`: a confirmation for the list was asked and not answered.\n * - `paused`: a bounce, a complaint, an erasure or a staff hold. Not a\n *   preference, so no switch of theirs lifts it.\n *\n * The consent basis is not judged here: the Yes this is asked about is the\n * basis. Only the lists a Yes cannot overrule are.\n */\nexport type PlatformMarketingHold =\n  | { kind: 'unsubscribed' }\n  | { kind: 'unconfirmed' }\n  | { kind: 'paused'; reason: string }\n\nexport function platformMarketingHold(\n  reach: PlatformMarketingReach,\n): PlatformMarketingHold | null {\n  if (reach.status !== 'read') return null\n  if (reach.suppression) {\n    return reach.suppression.list === 'site' && reach.suppression.reason === 'unsubscribe'\n      ? { kind: 'unsubscribed' }\n      : { kind: 'paused', reason: reach.suppression.reason }\n  }\n  if (reach.topic.state === 'opted-out') return { kind: 'unsubscribed' }\n  if (reach.topic.state === 'pending') return { kind: 'unconfirmed' }\n  return null\n}\n\n/** What mirroring an email-side change onto the account did (AGL-3305). */\nexport type PlatformMarketingMirrorOutcome =\n  /** Another site's list. An account is never touched from one. */\n  | { status: 'not-platform' }\n  /** A list the account's answer is not about. */\n  | { status: 'other-list' }\n  /** No account holds the address — or more than one does. */\n  | { status: 'no-account' }\n  /** The account already says so, or the rule leaves it where it is. */\n  | { status: 'unchanged' }\n  | { status: 'recorded'; uid: string; decision: PlatformMarketingConsentDecision }\n  /** Logged; the site's own write, which is what stops the mail, stands. */\n  | { status: 'failed' }\n\nexport interface PlatformMarketingMirrorInput {\n  /** The site whose page the person used. */\n  hostId: string\n  /** The address the signed link was for. */\n  email: string\n  /** Injectable for tests; defaults to the clock. */\n  now?: number\n  /** Injectable for tests; defaults to the admin app's Firestore. */\n  firestore?: any\n  /** Injectable for tests; defaults to {@link platformMarketingHostId}. */\n  platformHostId?: string | null\n  /**\n   * Injectable for tests; defaults to `attributableAccountForAddress`, which\n   * answers `null` for nobody AND for more than one account. Changing the\n   * wrong person's answer is worse than changing nobody's.\n   */\n  findAccount?: (email: string) => Promise<string | null>\n}\n\n/** The account a mirror would write, or the reason there is none. */\nasync function mirrorTarget(\n  input: PlatformMarketingMirrorInput,\n): Promise<{ uid: string; ref: any; state: PlatformMarketingConsentState } | PlatformMarketingMirrorOutcome> {\n  const platformHost =\n    input.platformHostId === undefined ? platformMarketingHostId() : input.platformHostId\n  if (!platformHost || input.hostId !== platformHost) return { status: 'not-platform' }\n  const uid = await (input.findAccount ?? ((email: string) => attributableAccountForAddress(email)))(\n    input.email,\n  )\n  if (!uid) return { status: 'no-account' }\n  const ref = (input.firestore ?? firestore()).collection('users').doc(uid)\n  const snapshot = await ref.get()\n  return {\n    uid,\n    ref,\n    state: readPlatformMarketingConsent(\n      (snapshot?.data?.() as Record<string, unknown> | undefined) ?? null,\n    ),\n  }\n}\n\n/**\n * Mirrors an unsubscribe from the marketing site onto the account's answer.\n *\n * Called by the site's own pages AFTER their write, with what the person\n * left: `'everything'` for the site's list, or the topics left on the\n * preference page. Only the platform's marketing site counts, and only a\n * list the answer is about — {@link PLATFORM_MARKETING_TOPIC_ID}, which\n * everything includes. The first No keeps its date and its door: a second\n * unsubscribe is not a later decision.\n *\n * Never throws. The page has already stopped the mail; this is the account\n * catching up with it.\n */\nexport async function mirrorPlatformUnsubscribe(\n  input: PlatformMarketingMirrorInput & { left: 'everything' | readonly string[] },\n): Promise<PlatformMarketingMirrorOutcome> {\n  try {\n    const everything = input.left === 'everything'\n    if (!everything && !input.left.includes(PLATFORM_MARKETING_TOPIC_ID)) {\n      // Cheaper to answer before the account lookup, and the answer does not\n      // depend on the site: no other list is this one on any site.\n      const platformHost =\n        input.platformHostId === undefined ? platformMarketingHostId() : input.platformHostId\n      return input.hostId === platformHost ? { status: 'other-list' } : { status: 'not-platform' }\n    }\n    const target = await mirrorTarget(input)\n    if ('status' in target) return target\n    if (target.state.decision === 'declined') return { status: 'unchanged' }\n    const atMs = input.now ?? Date.now()\n    const source = platformMarketingEmailSource(\n      everything\n        ? { kind: 'email-unsubscribe', decision: 'declined', uid: target.uid, atMs }\n        : { kind: 'email-preferences', decision: 'declined', uid: target.uid, atMs },\n    )\n    await target.ref.set(\n      platformMarketingUserFields({ decision: 'declined', atMs, source }),\n      { merge: true },\n    )\n    return { status: 'recorded', uid: target.uid, decision: 'declined' }\n  } catch (error) {\n    console.error('[platform-marketing-consent] could not mirror an unsubscribe onto the account', error)\n    return { status: 'failed' }\n  }\n}\n\n/**\n * Mirrors a way back in from the marketing site: the resubscribe link, or\n * the list ticked again on the preference page.\n *\n * Narrower than the unsubscribe on purpose. It restores only a No that an\n * email door recorded — a No given in the console is the person's answer in\n * the console, and a link in an email does not overturn it — and only once\n * product updates would really reach them: nothing on either suppression\n * list, and the list itself not left. A resubscribe that lifted the site's\n * list while product updates stay unticked restores nothing.\n */\nexport async function mirrorPlatformResubscribe(\n  input: PlatformMarketingMirrorInput & { via: 'email-resubscribe' | 'email-preferences' },\n): Promise<PlatformMarketingMirrorOutcome> {\n  try {\n    const target = await mirrorTarget(input)\n    if ('status' in target) return target\n    if (\n      target.state.decision !== 'declined' ||\n      !isPlatformMarketingEmailSourceKind(target.state.sourceKind)\n    ) {\n      return { status: 'unchanged' }\n    }\n    const db = input.firestore ?? firestore()\n    const [suppression, topic] = await Promise.all([\n      readPlatformMarketingSuppression(db, input.hostId, input.email),\n      readPlatformMarketingTopic(db, input.hostId, input.email),\n    ])\n    if (suppression || topic.state !== 'subscribed') return { status: 'unchanged' }\n    const atMs = input.now ?? Date.now()\n    const source = platformMarketingEmailSource({\n      kind: input.via,\n      decision: 'granted',\n      uid: target.uid,\n      atMs,\n    })\n    await target.ref.set(\n      platformMarketingUserFields({ decision: 'granted', atMs, source }),\n      { merge: true },\n    )\n    return { status: 'recorded', uid: target.uid, decision: 'granted' }\n  } catch (error) {\n    console.error('[platform-marketing-consent] could not mirror a resubscribe onto the account', error)\n    return { status: 'failed' }\n  }\n}\n"],"names":["readTopicSubscriptionState","TOPIC_OPT_OUTS_SUBCOLLECTION","isPlatformMarketingConsentDecision","isPlatformMarketingConsoleSourceKind","isPlatformMarketingEmailSourceKind","platformMarketingConsentSource","platformMarketingEmailSource","PLATFORM_MARKETING_TOPIC_ID","platformMarketingUserFields","readPlatformMarketingConsent","USER_MARKETING_PROMPT_DISMISSED_AT_FIELD","marketingConsentDecision","readMarketingBasis","resolveMarketingConsentPolicy","rejoinEmailStream","attributableAccountForAddress","findContactByEmail","EMAIL_SUPPRESSIONS_COLLECTION","emailSuppressionKey","HOST_SUPPRESSIONS_SUBCOLLECTION","firebaseAdmin","consentGroupForSite","getOrgForHost","orgDataCollectionForHost","upsertHostContact","firestore","app","PLATFORM_MARKETING_HOST_ID_ENV","platformMarketingHostId","process","value","String","env","PLATFORM_MARKETING_HOST_ID","trim","accountName","snapshot","fallback","first","get","last","stored","filter","Boolean","join","undefined","recordPlatformMarketingConsent","input","uid","Error","decision","source","textVersion","atMs","now","Date","kind","userRef","collection","doc","set","merge","hostId","contact","status","email","name","verdict","upsert","interaction","summary","reason","marketingConsent","declineMarketingConsent","marketingConsentSource","initialLifecycleStage","refused","contactId","created","stream","mailboxVerified","rejoin","topicId","snoozePlatformMarketingPrompt","options","trimmed","readPlatformMarketingConsentForUser","data","readPlatformMarketingSuppression","db","key","site","platform","Promise","all","exists","list","storedMs","Number","isFinite","toMillis","call","readPlatformMarketingTopic","unrecorded","id","state","leftAtMs","entry","optedOutAt","readPlatformMarketingReach","toLowerCase","record","owner","org","group","suppression","topic","then","contacts","orgId","orgSlug","basis","basisAtMs","assertedBy","basisKind","error","console","platformMarketingHold","reach","mirrorTarget","platformHost","platformHostId","findAccount","ref","mirrorPlatformUnsubscribe","everything","left","includes","target","mirrorPlatformResubscribe","sourceKind","via"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../../libs/tenant/data/admin/src/lib/server/platform-marketing-consent.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\n/**\n * The record a console door writes when a person decides about the\n * platform's own product email (AGL-3185).\n *\n * ## Two documents, one decision\n *\n * The decision goes onto the person's own `users/{uid}` first — the console\n * shows the preference from there, and it must not depend on the operator's\n * CRM accepting a row — and then onto the operator's marketing contact for\n * the same address through `upsertHostContact`, which is every other capture\n * door's path and the only one the send-time consent join reads. The contact\n * half carries the decision AND its provenance, so a campaign's audience\n * count reports this basis as the person's own click and never as something\n * asserted on their behalf.\n *\n * ## Server-side, because the client cannot and should not\n *\n * The sign-up page is a client of the person's own project; the operator's\n * marketing org is somebody else's data. Only the Admin SDK writes there, and\n * only after the person's ID token has been verified by the route in front\n * of this module. The user-document half could be a client write — the rules\n * make it owner-writable — but a mirror the client writes and the server\n * reads back is two writers of one fact, so both halves are written here.\n *\n * ## Which host, and why it is a setting\n *\n * The marketing host is the deployment's, not the code's: this repository is\n * what a self-hosted install runs, and an install with no product audience of\n * its own has nowhere for a contact to go. `PLATFORM_MARKETING_HOST_ID` names\n * it, and when it is unset the decision is recorded on the person's document\n * alone. No hostname or document id is hardcoded here for the same reason\n * `platform-marketing-host.ts` gives: nothing in the code knows which site\n * is the operator's.\n *\n * ## The site's own pages answer the same question, for one list (AGL-3305)\n *\n * The marketing site's emails carry their own way out, and it writes the\n * site's lists, not either consent record. An unsubscribe that was about the\n * list the console's question stands for — `PLATFORM_MARKETING_TOPIC_ID`, or\n * everything the site sends — is mirrored onto the ACCOUNT here, through an\n * email door; an unsubscribe from any other list is not, because the person\n * said nothing about product updates. The contact is left alone on purpose:\n * its basis covers every list the site sends, and declining it would stop the\n * newsletter for somebody who only left product updates.\n *\n * The console's switch undoes it the same way, one list wide: a Yes from a\n * verified account asks the plugin that keeps the site's preferences to\n * reopen that list and nothing else (`plugin-email-streams`).\n */\n\nimport { stampRecordOrigin } from '@aglyn/aglyn/plugin-manager/plugin-record-origin'\nimport {\n  readTopicSubscriptionState,\n  TOPIC_OPT_OUTS_SUBCOLLECTION,\n  type TopicSubscriptionEntry,\n  type TopicSubscriptionState,\n} from '@aglyn/aglyn/app-utils/subscription-topics'\nimport {\n  isPlatformMarketingConsentDecision,\n  isPlatformMarketingConsoleSourceKind,\n  isPlatformMarketingEmailSourceKind,\n  type PlatformMarketingConsentDecision,\n  type PlatformMarketingConsoleSourceKind,\n  type PlatformMarketingConsentState,\n  platformMarketingConsentSource,\n  platformMarketingEmailSource,\n  PLATFORM_MARKETING_TOPIC_ID,\n  platformMarketingUserFields,\n  readPlatformMarketingConsent,\n  USER_MARKETING_PROMPT_DISMISSED_AT_FIELD,\n} from '@aglyn/aglyn/app-utils/platform-marketing-consent'\nimport {\n  marketingConsentDecision,\n  type MarketingBasis,\n  type MarketingConsentAssertedBy,\n  type MarketingConsentReason,\n  type MarketingConsentVerdict,\n  readMarketingBasis,\n  resolveMarketingConsentPolicy,\n} from '@aglyn/aglyn/app-utils/marketing-consent'\nimport {\n  type EmailStreamRejoinOutcome,\n  rejoinEmailStream,\n} from '@aglyn/aglyn/plugin-manager/plugin-email-streams'\nimport { attributableAccountForAddress } from './account-addresses'\nimport { findPluginPerson } from '@aglyn/aglyn/plugin-manager/plugin-person-records'\nimport {\n  EMAIL_SUPPRESSIONS_COLLECTION,\n  emailSuppressionKey,\n  HOST_SUPPRESSIONS_SUBCOLLECTION,\n} from './email-suppression'\nimport firebaseAdmin from './firebase-admin'\nimport { consentGroupForSite, getOrgForHost } from './organizations'\nimport { upsertHostContact } from './upsert-contact'\n\nconst firestore = () => firebaseAdmin.app().firestore()\n\n/**\n * The variable naming the host whose contacts receive product-marketing\n * consent — the operator's own marketing site. Unset on a self-hosted\n * install, and honored as \"record the preference, capture no contact\".\n */\nexport const PLATFORM_MARKETING_HOST_ID_ENV = 'PLATFORM_MARKETING_HOST_ID'\n\n/**\n * The configured marketing host, or `null` when the deployment names none.\n *\n * Read at call time rather than at module load, so a test can set it and a\n * process that started without it picks up a later value the same way every\n * other runtime setting here does.\n */\nexport function platformMarketingHostId(): string | null {\n  const value = String(process.env.PLATFORM_MARKETING_HOST_ID ?? '').trim()\n  return value || null\n}\n\n/** What became of the contact half of the record. */\nexport type PlatformMarketingContactOutcome =\n  | { status: 'recorded'; contactId: string; created: boolean }\n  /** No marketing host is configured — a self-hosted install. */\n  | { status: 'unconfigured' }\n  /** The account carries no address a contact could be keyed on. */\n  | { status: 'no-email' }\n  /** The capture door refused the row — its band, an erasure, or an error. */\n  | { status: 'refused'; reason: string }\n\nexport interface RecordPlatformMarketingConsentInput {\n  uid: string\n  /** The account's address, from the verified token. */\n  email: string | null | undefined\n  /** The name the token carries, for an account whose document holds none. */\n  name?: string | null\n  decision: PlatformMarketingConsentDecision\n  /** A console door. An email door is recorded by the site's own pages. */\n  source: PlatformMarketingConsoleSourceKind\n  /** The wording version the door showed, stamped by the route. */\n  textVersion: string\n  /**\n   * Whether the token proves the caller holds the mailbox — its email is\n   * verified (AGL-3305). Only then does a Yes reopen the list on the\n   * marketing site, because reopening it reverses what somebody did from\n   * that mailbox; an unverified account could name a stranger's address.\n   */\n  mailboxVerified?: boolean\n  /** Injectable for tests; defaults to the clock. */\n  now?: number\n  /** Injectable for tests; defaults to the admin app's Firestore. */\n  firestore?: any\n  /** Injectable for tests; defaults to {@link platformMarketingHostId}. */\n  hostId?: string | null\n  /** Injectable for tests; defaults to the real capture door. */\n  upsert?: typeof upsertHostContact\n  /** Injectable for tests; defaults to the `plugin-email-streams` slot. */\n  rejoin?: typeof rejoinEmailStream\n}\n\n/**\n * What a Yes did to the marketing site's own lists (AGL-3305). Absent for a\n * No, and whenever there is no site or no address to reopen a list for.\n */\nexport type PlatformMarketingStreamOutcome =\n  | EmailStreamRejoinOutcome\n  /** The token does not prove the mailbox, so nothing was reopened. */\n  | { status: 'unverified' }\n\nexport interface RecordPlatformMarketingConsentResult {\n  /** The timestamp both documents carry. */\n  atMs: number\n  contact: PlatformMarketingContactOutcome\n  stream?: PlatformMarketingStreamOutcome\n}\n\n/**\n * The name the person's own document holds, else the one the caller has.\n *\n * The sign-up form writes `firstName`/`lastName` onto the document; a Google\n * account carries its name on the token instead. Either is the name the\n * contact row should show, and a blank is left blank rather than invented.\n */\nfunction accountName(\n  snapshot: { get?: (field: string) => unknown } | null | undefined,\n  fallback: string | null | undefined,\n): string | undefined {\n  const first = String(snapshot?.get?.('firstName') ?? '').trim()\n  const last = String(snapshot?.get?.('lastName') ?? '').trim()\n  const stored = [first, last].filter(Boolean).join(' ')\n  return stored || String(fallback ?? '').trim() || undefined\n}\n\n/**\n * Records a decision on both documents.\n *\n * Loud on bad input, like `recordLegalAcceptance`: a decision that cannot be\n * attributed to an account, a door and a wording is not a record of anything.\n * Quiet on the contact half — a refused row is returned, not thrown — because\n * the person's own preference has already been recorded by then, and the\n * operator's CRM band is not a reason to tell them their choice failed.\n */\nexport async function recordPlatformMarketingConsent(\n  input: RecordPlatformMarketingConsentInput,\n): Promise<RecordPlatformMarketingConsentResult> {\n  const uid = String(input.uid ?? '').trim()\n  if (!uid) throw new Error('recordPlatformMarketingConsent: uid is required')\n  if (!isPlatformMarketingConsentDecision(input.decision)) {\n    throw new Error('recordPlatformMarketingConsent: decision is required')\n  }\n  if (!isPlatformMarketingConsoleSourceKind(input.source)) {\n    throw new Error('recordPlatformMarketingConsent: a console source is required')\n  }\n  const textVersion = String(input.textVersion ?? '').trim()\n  if (!textVersion) {\n    throw new Error('recordPlatformMarketingConsent: textVersion is required')\n  }\n\n  const atMs = input.now ?? Date.now()\n  const source = platformMarketingConsentSource({\n    kind: input.source,\n    decision: input.decision,\n    uid,\n    atMs,\n    textVersion,\n  })\n\n  const userRef = (input.firestore ?? firestore()).collection('users').doc(uid)\n  const snapshot = await userRef.get()\n  await userRef.set(\n    platformMarketingUserFields({ decision: input.decision, atMs, source }),\n    { merge: true },\n  )\n\n  const hostId =\n    input.hostId === undefined ? platformMarketingHostId() : input.hostId\n  if (!hostId) return { atMs, contact: { status: 'unconfigured' } }\n  const email = String(input.email ?? '').trim()\n  if (!email) return { atMs, contact: { status: 'no-email' } }\n\n  const name = accountName(snapshot, input.name)\n  const verdict = await (input.upsert ?? upsertHostContact)({\n    hostId,\n    email,\n    ...(name ? { name } : {}),\n    source: 'account',\n    // The sentence the provenance carries is also the timeline row's: what\n    // the person did, in the words an auditor reads.\n    interaction: { atMs, summary: source.reason },\n    ...(input.decision === 'granted'\n      ? { marketingConsent: true }\n      : { declineMarketingConsent: true }),\n    marketingConsentSource: source,\n    // An account on the platform is at least a lead for the platform's own\n    // CRM, whichever way the marketing decision went; the floor never moves\n    // a customer back.\n    initialLifecycleStage: 'lead',\n  })\n  const contact: PlatformMarketingContactOutcome =\n    'refused' in verdict\n      ? { status: 'refused', reason: verdict.refused }\n      : { status: 'recorded', contactId: verdict.contactId, created: verdict.created }\n  // Where the person came from (AGL-3519): an account sign-up, on a record\n  // the platform's own CRM just started and that names no lead source.\n  if (contact.status === 'recorded') {\n    await stampRecordOrigin({ hostId, email, origin: 'account', firstTouchOnly: true })\n  }\n  if (input.decision !== 'granted') return { atMs, contact }\n\n  /*\n   * A Yes reopens the one list it stands for (AGL-3305).\n   *\n   * After the contact, whatever the contact's outcome: an erasure that\n   * refused the row also left a suppression the plugin will not lift, and it\n   * says so. One list wide, never \"resubscribe to everything\" — somebody who\n   * left every list and now asks for product updates has asked for product\n   * updates.\n   */\n  const stream: PlatformMarketingStreamOutcome = input.mailboxVerified\n    ? await (input.rejoin ?? rejoinEmailStream)({\n        hostId,\n        email,\n        topicId: PLATFORM_MARKETING_TOPIC_ID,\n      })\n    : { status: 'unverified' }\n  return { atMs, contact, stream }\n}\n\n/**\n * Stamps a prompt dismissal — no decision — so the console stays quiet for\n * the snooze window and asks once more after it.\n */\nexport async function snoozePlatformMarketingPrompt(\n  uid: string,\n  options: { now?: number; firestore?: any } = {},\n): Promise<{ atMs: number }> {\n  const trimmed = String(uid ?? '').trim()\n  if (!trimmed) throw new Error('snoozePlatformMarketingPrompt: uid is required')\n  const atMs = options.now ?? Date.now()\n  await (options.firestore ?? firestore())\n    .collection('users')\n    .doc(trimmed)\n    .set({ [USER_MARKETING_PROMPT_DISMISSED_AT_FIELD]: atMs }, { merge: true })\n  return { atMs }\n}\n\n/** The decision the person's own document holds, for the console to show. */\nexport async function readPlatformMarketingConsentForUser(\n  uid: string,\n  options: { firestore?: any } = {},\n): Promise<PlatformMarketingConsentState> {\n  const trimmed = String(uid ?? '').trim()\n  if (!trimmed) throw new Error('readPlatformMarketingConsentForUser: uid is required')\n  const snapshot = await (options.firestore ?? firestore())\n    .collection('users')\n    .doc(trimmed)\n    .get()\n  return readPlatformMarketingConsent(\n    (snapshot?.data?.() as Record<string, unknown> | undefined) ?? null,\n  )\n}\n\n/** An entry on one of the two lists every campaign send passes. */\nexport interface PlatformMarketingSuppression {\n  /** `site`: the marketing site's own list. `platform`: every sender's. */\n  list: 'site' | 'platform'\n  /** `unsubscribe` on the site list; `bounce`, `complaint` or `staff` platform-wide. */\n  reason: string\n}\n\n/**\n * What the operator's own product email would decide about one address\n * (AGL-3292), read the way a campaign from the marketing site reads it.\n *\n * The decision the person made lives on `users/{uid}`, and nothing a send\n * does looks there. A campaign from the configured marketing site reads the\n * CONTACT `recordPlatformMarketingConsent` wrote into that site's\n * organization — its basis for the site, under the organization's policy —\n * and then drops anybody on either suppression list, and a campaign on the\n * product-updates list anybody who left it. An unsubscribe writes those\n * lists; since AGL-3305 one about product updates also turns the account's\n * answer to No, but the contact's basis stays as it was, because it covers\n * every list the site sends. So a staff reader asking \"may we email them?\"\n * needs this half, and needs it from the sender's own readers — the same\n * basis read, consent group, policy and lists — or it answers a question no\n * send asks.\n */\nexport type PlatformMarketingReach =\n  /** No marketing site is configured — a self-hosted install. */\n  | { status: 'unconfigured' }\n  /** The account carries no address a contact could be keyed on. */\n  | { status: 'no-email' }\n  /** A read failed. Nothing about the person follows from it. */\n  | { status: 'unreadable'; hostId: string }\n  | {\n      status: 'read'\n      hostId: string\n      orgId: string\n      orgSlug: string | null\n      /** `null` when the operator's CRM holds no contact for the address. */\n      contactId: string | null\n      basis: MarketingBasis\n      basisAtMs: number | null\n      /** Whose act the basis is — a person's own, or an operator's assertion. */\n      assertedBy: MarketingConsentAssertedBy | null\n      /** Which door recorded the basis (`console-signup`, a form, a backfill). */\n      basisKind: string | null\n      /** The consent rule's answer alone, before either list is consulted. */\n      verdict: MarketingConsentVerdict\n      reason: MarketingConsentReason\n      /** The list that stops every send to the address, when one does. */\n      suppression: PlatformMarketingSuppression | null\n      /**\n       * The address on the list the account's answer stands for (AGL-3305):\n       * `opted-out` when they left product updates, `pending` while a\n       * confirmation is unanswered. A campaign on that list drops both.\n       */\n      topic: PlatformMarketingTopicState\n    }\n\n/** One address on {@link PLATFORM_MARKETING_TOPIC_ID}, as the site stores it. */\nexport interface PlatformMarketingTopicState {\n  id: string\n  state: TopicSubscriptionState\n  /** When they left it, for an `opted-out` state; else `null`. */\n  leftAtMs: number | null\n}\n\n/**\n * The entry that suppresses `email` for sends from `hostId`, if any.\n *\n * The site's own list first, because it is the one a person puts themselves\n * on from this sender's footer; the platform list second. The same two reads\n * `filterSendableForHost` makes: a site entry suppresses by existing, and a\n * platform entry until it is released.\n */\nasync function readPlatformMarketingSuppression(\n  db: any,\n  hostId: string,\n  email: string,\n): Promise<PlatformMarketingSuppression | null> {\n  const key = emailSuppressionKey(email)\n  if (!key) return null\n  const [site, platform] = await Promise.all([\n    db\n      .collection('hosts')\n      .doc(hostId)\n      .collection(HOST_SUPPRESSIONS_SUBCOLLECTION)\n      .doc(key)\n      .get(),\n    db.collection(EMAIL_SUPPRESSIONS_COLLECTION).doc(key).get(),\n  ])\n  if (site?.exists) {\n    return { list: 'site', reason: String(site.get('reason') ?? 'unsubscribe') }\n  }\n  if (platform?.exists && !platform.get('releasedAt')) {\n    return { list: 'platform', reason: String(platform.get('reason') ?? 'staff') }\n  }\n  return null\n}\n\n/** Milliseconds from a stored Firestore timestamp or a number, else `null`. */\nfunction storedMs(value: unknown): number | null {\n  if (typeof value === 'number' && Number.isFinite(value)) return value\n  const toMillis = (value as { toMillis?: () => number } | null)?.toMillis\n  return typeof toMillis === 'function' ? toMillis.call(value) : null\n}\n\n/**\n * Where the address stands on {@link PLATFORM_MARKETING_TOPIC_ID}.\n *\n * The site's per-topic record, read by key and through the one function that\n * knows its three states — the same read `filterTopicSendable` makes before\n * a campaign on that list goes out. No record is `subscribed`: nobody has\n * left a list they were never taken off.\n */\nasync function readPlatformMarketingTopic(\n  db: any,\n  hostId: string,\n  email: string,\n): Promise<PlatformMarketingTopicState> {\n  const key = emailSuppressionKey(email)\n  const unrecorded = { id: PLATFORM_MARKETING_TOPIC_ID, state: 'subscribed' as const, leftAtMs: null }\n  if (!key) return unrecorded\n  const snapshot = await db\n    .collection('hosts')\n    .doc(hostId)\n    .collection(TOPIC_OPT_OUTS_SUBCOLLECTION)\n    .doc(key)\n    .get()\n  if (!snapshot?.exists) return unrecorded\n  const entry = ((snapshot.get('topics') ?? {}) as Record<string, TopicSubscriptionEntry | undefined>)[\n    PLATFORM_MARKETING_TOPIC_ID\n  ]\n  const state = readTopicSubscriptionState(entry)\n  return {\n    id: PLATFORM_MARKETING_TOPIC_ID,\n    state,\n    leftAtMs: state === 'opted-out' ? storedMs(entry?.optedOutAt) : null,\n  }\n}\n\n/**\n * Reads {@link PlatformMarketingReach} for an address.\n *\n * Never throws: a failed read is `unreadable`, which the staff page shows as\n * unknown — never as \"no consent\", which would be a claim about the person.\n */\nexport async function readPlatformMarketingReach(input: {\n  email: string | null | undefined\n  /** Injectable for tests; defaults to {@link platformMarketingHostId}. */\n  hostId?: string | null\n  /** Injectable for tests; defaults to the admin app's Firestore. */\n  firestore?: any\n}): Promise<PlatformMarketingReach> {\n  const hostId =\n    input.hostId === undefined ? platformMarketingHostId() : input.hostId\n  if (!hostId) return { status: 'unconfigured' }\n  const email = String(input.email ?? '').trim().toLowerCase()\n  if (!email) return { status: 'no-email' }\n  const db = input.firestore ?? firestore()\n  try {\n    const owner = await getOrgForHost(hostId)\n    if (!owner) return { status: 'unreadable', hostId }\n    const org = owner.org as Record<string, unknown>\n    const [person, group, suppression, topic] = await Promise.all([\n      // The operator's person for the address, asked of the plugin that\n      // keeps people (AGL-3080) — the record the capture door wrote.\n      findPluginPerson({ orgId: owner.orgId, hostId, email }),\n      consentGroupForSite(hostId, org),\n      readPlatformMarketingSuppression(db, hostId, email),\n      readPlatformMarketingTopic(db, hostId, email),\n    ])\n    const record = readMarketingBasis(person ? { ...person.data } : null, group)\n    const decision = marketingConsentDecision(\n      record,\n      resolveMarketingConsentPolicy(org['marketingConsentPolicy']),\n    )\n    return {\n      status: 'read',\n      hostId,\n      orgId: owner.orgId,\n      orgSlug: typeof org['slug'] === 'string' ? org['slug'] : null,\n      contactId: person?.id ?? null,\n      basis: record.basis,\n      basisAtMs: record.basisAtMs,\n      assertedBy: record.assertedBy,\n      basisKind: record.source?.kind ?? null,\n      verdict: decision.verdict,\n      reason: decision.reason,\n      suppression,\n      topic,\n    }\n  } catch (error) {\n    console.error('[platform-marketing-consent] reach read failed', error)\n    return { status: 'unreadable', hostId }\n  }\n}\n\n/**\n * Why somebody who said Yes will not receive product updates, in the terms\n * of what they can do about it (AGL-3305) — or `null` when nothing on the\n * marketing site's lists stands in the way.\n *\n * - `unsubscribed`: they left everything, or left product updates, from an\n *   email. Theirs to undo, and a Yes from a verified account does.\n * - `unconfirmed`: a confirmation for the list was asked and not answered.\n * - `paused`: a bounce, a complaint, an erasure or a staff hold. Not a\n *   preference, so no switch of theirs lifts it.\n *\n * The consent basis is not judged here: the Yes this is asked about is the\n * basis. Only the lists a Yes cannot overrule are.\n */\nexport type PlatformMarketingHold =\n  | { kind: 'unsubscribed' }\n  | { kind: 'unconfirmed' }\n  | { kind: 'paused'; reason: string }\n\nexport function platformMarketingHold(\n  reach: PlatformMarketingReach,\n): PlatformMarketingHold | null {\n  if (reach.status !== 'read') return null\n  if (reach.suppression) {\n    return reach.suppression.list === 'site' && reach.suppression.reason === 'unsubscribe'\n      ? { kind: 'unsubscribed' }\n      : { kind: 'paused', reason: reach.suppression.reason }\n  }\n  if (reach.topic.state === 'opted-out') return { kind: 'unsubscribed' }\n  if (reach.topic.state === 'pending') return { kind: 'unconfirmed' }\n  return null\n}\n\n/** What mirroring an email-side change onto the account did (AGL-3305). */\nexport type PlatformMarketingMirrorOutcome =\n  /** Another site's list. An account is never touched from one. */\n  | { status: 'not-platform' }\n  /** A list the account's answer is not about. */\n  | { status: 'other-list' }\n  /** No account holds the address — or more than one does. */\n  | { status: 'no-account' }\n  /** The account already says so, or the rule leaves it where it is. */\n  | { status: 'unchanged' }\n  | { status: 'recorded'; uid: string; decision: PlatformMarketingConsentDecision }\n  /** Logged; the site's own write, which is what stops the mail, stands. */\n  | { status: 'failed' }\n\nexport interface PlatformMarketingMirrorInput {\n  /** The site whose page the person used. */\n  hostId: string\n  /** The address the signed link was for. */\n  email: string\n  /** Injectable for tests; defaults to the clock. */\n  now?: number\n  /** Injectable for tests; defaults to the admin app's Firestore. */\n  firestore?: any\n  /** Injectable for tests; defaults to {@link platformMarketingHostId}. */\n  platformHostId?: string | null\n  /**\n   * Injectable for tests; defaults to `attributableAccountForAddress`, which\n   * answers `null` for nobody AND for more than one account. Changing the\n   * wrong person's answer is worse than changing nobody's.\n   */\n  findAccount?: (email: string) => Promise<string | null>\n}\n\n/** The account a mirror would write, or the reason there is none. */\nasync function mirrorTarget(\n  input: PlatformMarketingMirrorInput,\n): Promise<{ uid: string; ref: any; state: PlatformMarketingConsentState } | PlatformMarketingMirrorOutcome> {\n  const platformHost =\n    input.platformHostId === undefined ? platformMarketingHostId() : input.platformHostId\n  if (!platformHost || input.hostId !== platformHost) return { status: 'not-platform' }\n  const uid = await (input.findAccount ?? ((email: string) => attributableAccountForAddress(email)))(\n    input.email,\n  )\n  if (!uid) return { status: 'no-account' }\n  const ref = (input.firestore ?? firestore()).collection('users').doc(uid)\n  const snapshot = await ref.get()\n  return {\n    uid,\n    ref,\n    state: readPlatformMarketingConsent(\n      (snapshot?.data?.() as Record<string, unknown> | undefined) ?? null,\n    ),\n  }\n}\n\n/**\n * Mirrors an unsubscribe from the marketing site onto the account's answer.\n *\n * Called by the site's own pages AFTER their write, with what the person\n * left: `'everything'` for the site's list, or the topics left on the\n * preference page. Only the platform's marketing site counts, and only a\n * list the answer is about — {@link PLATFORM_MARKETING_TOPIC_ID}, which\n * everything includes. The first No keeps its date and its door: a second\n * unsubscribe is not a later decision.\n *\n * Never throws. The page has already stopped the mail; this is the account\n * catching up with it.\n */\nexport async function mirrorPlatformUnsubscribe(\n  input: PlatformMarketingMirrorInput & { left: 'everything' | readonly string[] },\n): Promise<PlatformMarketingMirrorOutcome> {\n  try {\n    const everything = input.left === 'everything'\n    if (!everything && !input.left.includes(PLATFORM_MARKETING_TOPIC_ID)) {\n      // Cheaper to answer before the account lookup, and the answer does not\n      // depend on the site: no other list is this one on any site.\n      const platformHost =\n        input.platformHostId === undefined ? platformMarketingHostId() : input.platformHostId\n      return input.hostId === platformHost ? { status: 'other-list' } : { status: 'not-platform' }\n    }\n    const target = await mirrorTarget(input)\n    if ('status' in target) return target\n    if (target.state.decision === 'declined') return { status: 'unchanged' }\n    const atMs = input.now ?? Date.now()\n    const source = platformMarketingEmailSource(\n      everything\n        ? { kind: 'email-unsubscribe', decision: 'declined', uid: target.uid, atMs }\n        : { kind: 'email-preferences', decision: 'declined', uid: target.uid, atMs },\n    )\n    await target.ref.set(\n      platformMarketingUserFields({ decision: 'declined', atMs, source }),\n      { merge: true },\n    )\n    return { status: 'recorded', uid: target.uid, decision: 'declined' }\n  } catch (error) {\n    console.error('[platform-marketing-consent] could not mirror an unsubscribe onto the account', error)\n    return { status: 'failed' }\n  }\n}\n\n/**\n * Mirrors a way back in from the marketing site: the resubscribe link, or\n * the list ticked again on the preference page.\n *\n * Narrower than the unsubscribe on purpose. It restores only a No that an\n * email door recorded — a No given in the console is the person's answer in\n * the console, and a link in an email does not overturn it — and only once\n * product updates would really reach them: nothing on either suppression\n * list, and the list itself not left. A resubscribe that lifted the site's\n * list while product updates stay unticked restores nothing.\n */\nexport async function mirrorPlatformResubscribe(\n  input: PlatformMarketingMirrorInput & { via: 'email-resubscribe' | 'email-preferences' },\n): Promise<PlatformMarketingMirrorOutcome> {\n  try {\n    const target = await mirrorTarget(input)\n    if ('status' in target) return target\n    if (\n      target.state.decision !== 'declined' ||\n      !isPlatformMarketingEmailSourceKind(target.state.sourceKind)\n    ) {\n      return { status: 'unchanged' }\n    }\n    const db = input.firestore ?? firestore()\n    const [suppression, topic] = await Promise.all([\n      readPlatformMarketingSuppression(db, input.hostId, input.email),\n      readPlatformMarketingTopic(db, input.hostId, input.email),\n    ])\n    if (suppression || topic.state !== 'subscribed') return { status: 'unchanged' }\n    const atMs = input.now ?? Date.now()\n    const source = platformMarketingEmailSource({\n      kind: input.via,\n      decision: 'granted',\n      uid: target.uid,\n      atMs,\n    })\n    await target.ref.set(\n      platformMarketingUserFields({ decision: 'granted', atMs, source }),\n      { merge: true },\n    )\n    return { status: 'recorded', uid: target.uid, decision: 'granted' }\n  } catch (error) {\n    console.error('[platform-marketing-consent] could not mirror a resubscribe onto the account', error)\n    return { status: 'failed' }\n  }\n}\n"],"names":["stampRecordOrigin","readTopicSubscriptionState","TOPIC_OPT_OUTS_SUBCOLLECTION","isPlatformMarketingConsentDecision","isPlatformMarketingConsoleSourceKind","isPlatformMarketingEmailSourceKind","platformMarketingConsentSource","platformMarketingEmailSource","PLATFORM_MARKETING_TOPIC_ID","platformMarketingUserFields","readPlatformMarketingConsent","USER_MARKETING_PROMPT_DISMISSED_AT_FIELD","marketingConsentDecision","readMarketingBasis","resolveMarketingConsentPolicy","rejoinEmailStream","attributableAccountForAddress","findPluginPerson","EMAIL_SUPPRESSIONS_COLLECTION","emailSuppressionKey","HOST_SUPPRESSIONS_SUBCOLLECTION","firebaseAdmin","consentGroupForSite","getOrgForHost","upsertHostContact","firestore","app","PLATFORM_MARKETING_HOST_ID_ENV","platformMarketingHostId","process","value","String","env","PLATFORM_MARKETING_HOST_ID","trim","accountName","snapshot","fallback","first","get","last","stored","filter","Boolean","join","undefined","recordPlatformMarketingConsent","input","uid","Error","decision","source","textVersion","atMs","now","Date","kind","userRef","collection","doc","set","merge","hostId","contact","status","email","name","verdict","upsert","interaction","summary","reason","marketingConsent","declineMarketingConsent","marketingConsentSource","initialLifecycleStage","refused","contactId","created","origin","firstTouchOnly","stream","mailboxVerified","rejoin","topicId","snoozePlatformMarketingPrompt","options","trimmed","readPlatformMarketingConsentForUser","data","readPlatformMarketingSuppression","db","key","site","platform","Promise","all","exists","list","storedMs","Number","isFinite","toMillis","call","readPlatformMarketingTopic","unrecorded","id","state","leftAtMs","entry","optedOutAt","readPlatformMarketingReach","toLowerCase","record","owner","org","person","group","suppression","topic","orgId","orgSlug","basis","basisAtMs","assertedBy","basisKind","error","console","platformMarketingHold","reach","mirrorTarget","platformHost","platformHostId","findAccount","ref","mirrorPlatformUnsubscribe","everything","left","includes","target","mirrorPlatformResubscribe","sourceKind","via"],"mappings":"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"}

package/src/lib/server/render-monitor.d.ts

@@ -0,0 +1,166 @@
+/**
+ * @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 type { OperatorHealthStateDoc } from './operator-health';
+/** Every render monitor document id starts with this. */
+export declare const RENDER_MONITOR_CHECK_PREFIX = "render-monitor--";
+/** The beat id `/api/health/crons` reads for the scheduled run. */
+export declare const RENDER_MONITOR_JOB_ID = "render-monitor";
+/**
+ * How long one page fetch may take. Well under the 60 s a platform function
+ * may run, so a hung render is graded here as a timeout rather than waiting
+ * for the platform's 504, and well under the route's own `maxDuration`.
+ */
+export declare const RENDER_MONITOR_TIMEOUT_MS = 25000;
+/** Failing runs in a row before the alert goes out. */
+export declare const RENDER_MONITOR_DEFAULT_THRESHOLD = 2;
+/**
+ * The prefix of the never-requested path the `isr` probe asks for. A
+ * lowercase slug on purpose: it must reach the catch-all page like any
+ * screen slug would, not a reserved or rewritten route.
+ */
+export declare const RENDER_PROBE_ISR_PREFIX = "/aglyn-render-probe-";
+export type RenderProbeKind = 'dynamic' | 'isr';
+export interface RenderProbeSpec {
+    kind: RenderProbeKind;
+    /** The path to request, given a fresh nonce. */
+    path: (nonce: string) => string;
+    /** The status a healthy render answers with. */
+    expectStatus: number;
+}
+export declare const RENDER_PROBES: readonly RenderProbeSpec[];
+/** One fetched response, reduced to what grading reads. */
+export interface RenderProbeResponse {
+    status: number;
+    contentType?: string | null;
+    body?: string;
+    location?: string | null;
+    /** `x-vercel-cache` on Vercel, `x-nextjs-cache` on a plain `next start`. */
+    cacheState?: string | null;
+}
+export interface RenderProbeVerdict {
+    ok: boolean;
+    /** Bot protection answered instead of the site. */
+    challenged: boolean;
+    /** A stable code; `ok` on a pass. */
+    code: string;
+    detail: string;
+}
+/**
+ * Grade one probe response. Pure.
+ *
+ * The page markers are the front doors' (`tools/scripts/lib/front-door.mjs`)
+ * and for their reason: structural, never site copy. `</html>` proves the
+ * document finished streaming, `/_next/static/` that our build produced it.
+ */
+export declare function gradeRenderProbe(response: RenderProbeResponse, expectStatus: number): RenderProbeVerdict;
+/** A configured value as an origin, or '' when it is not one. */
+export declare function originOf(value: string | undefined | null): string;
+/**
+ * Which sites the monitor renders, from the console's environment.
+ *
+ * 1. The install's demonstration site: `OPERATOR_HEALTH_TENANT_ORIGIN` when
+ *    set (the one published site the operator alerts tick already watches),
+ *    else `https://<AGLYN_TENANT_DEMO or demo>.<tenant apex>`.
+ * 2. Plus every origin in `RENDER_MONITOR_ORIGINS`, comma separated.
+ *
+ * `RENDER_MONITOR_ORIGINS=off` watches nothing, for an install with no
+ * published site to watch. Values that are not origins are dropped.
+ */
+export declare function resolveRenderMonitorTargets(env: Readonly<Record<string, string | undefined>>): string[];
+/** The state document id for one origin. */
+export declare function renderMonitorCheckId(origin: string): string;
+/** One render monitor state document. */
+export interface RenderMonitorStateDoc extends OperatorHealthStateDoc {
+    origin: string;
+    /** Failing runs in a row, reset by any passing run. */
+    consecutiveFailures: number;
+    /** When the current run of failures began; null while passing. */
+    failingSinceMs: number | null;
+    lastOkAtMs: number | null;
+}
+export type RenderMonitorTransition = 'failing' | 'recovered' | null;
+/**
+ * The next state for one site, given what this run saw. Pure.
+ *
+ * The status turns `degraded` only once `threshold` runs in a row have
+ * failed, so one slow cold start or one dropped connection says nothing. It
+ * turns back on the first passing run, because a render that works is
+ * proof, and a recovery held back is a recovery nobody hears about.
+ */
+export declare function nextRenderMonitorState(prior: Partial<RenderMonitorStateDoc> | null, observation: {
+    ok: boolean;
+    detail: string;
+}, context: {
+    origin: string;
+    label: string;
+    threshold: number;
+    now: number;
+}): {
+    next: RenderMonitorStateDoc;
+    transition: RenderMonitorTransition;
+};
+/** One probe as the report shows it. */
+export interface RenderProbeRow extends RenderProbeVerdict {
+    kind: RenderProbeKind;
+    url: string;
+    ms: number;
+    httpStatus: number | null;
+}
+/** One site's result for a run. */
+export interface RenderMonitorSiteResult {
+    origin: string;
+    ok: boolean;
+    probes: RenderProbeRow[];
+    /** The state written; absent on a dry run or a failed write. */
+    status?: 'ok' | 'degraded';
+    consecutiveFailures?: number;
+    transition?: RenderMonitorTransition;
+    error?: string;
+}
+export interface RenderMonitorReport {
+    dryRun: boolean;
+    threshold: number;
+    sites: RenderMonitorSiteResult[];
+}
+/** The read-modify-write of one site's state, as one transaction. */
+export type RenderMonitorStore = <T>(checkId: string, work: (prior: Partial<RenderMonitorStateDoc> | null) => {
+    next: RenderMonitorStateDoc;
+    result: T;
+}) => Promise<T>;
+type RaiseAlert = (type: string, options: {
+    dedupeKey?: string;
+    context?: Record<string, string | number>;
+}) => Promise<unknown>;
+/**
+ * One run: render every target, record each site's state, raise the edge.
+ *
+ * A dry run fetches and grades and writes nothing, so a person can ask
+ * "what would the monitor see right now" without moving its state.
+ */
+export declare function runRenderMonitor(options?: {
+    dryRun?: boolean;
+    env?: Readonly<Record<string, string | undefined>>;
+    fetcher?: typeof fetch;
+    /** Our own edge's bypass headers, from the caller's environment. */
+    headers?: Record<string, string>;
+    now?: () => number;
+    nonce?: () => string;
+    timeoutMs?: number;
+    store?: RenderMonitorStore;
+    raise?: RaiseAlert;
+}): Promise<RenderMonitorReport>;
+export {};