@aglyn/tenant-data-admin 1.0.0-beta.143

package/src/lib/server/personal-data-export.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/tenant/data/admin/src/lib/server/personal-data-export.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 * Personal-data export — access and portability, in a machine-readable form\n * (AGL-1974).\n *\n * Privacy Policy §7 grants portability (GDPR Art. 20) and nothing in the\n * product exported a person's or a workspace's personal data. Six surfaces\n * told customers to \"export first\" before deleting — the org settings Delete\n * tab, the Close account card, `erase-org-cli.mjs`, the staff org actions,\n * live DPA §11 and Terms §13.3 — all pointing at something that did not\n * exist. An access request was assembled by a staff member reading the console\n * by hand.\n *\n * ## THE PROPERTY THIS FILE EXISTS FOR\n *\n * **An export whose coverage differs from erasure's is a bug in one of them.**\n * Both answer the same question — *what do we hold about this subject* — and\n * the honest failure modes are symmetric: an export that misses a collection\n * under-discloses on an access request, and an erasure that misses the same\n * one leaves data behind after we said it was gone. Historically the second\n * kept happening (AGL-1444, AGL-1448, AGL-1970, AGL-1971 each found a\n * collection outside the cascade), which is exactly the evidence that a list\n * kept in one place and mirrored by hand in another will drift.\n *\n * The ideal is one enumeration both derive from. That is not available here:\n * `erase.ts` is under concurrent change and its sweep list is expressed as\n * code, not data. So the coverage is enumerated ONCE below, as data, and\n * `personal-data-export-coverage.spec.ts` DISCOVERS every collection\n * `erase.ts` touches out of its source and fails when the two disagree. A new\n * sweep added to the erasure turns this file red until somebody decides\n * whether the export discloses it — which is the decision that was being\n * skipped.\n *\n * That guard is worth more than the feature.\n *\n * ## What must NOT come out wholesale\n *\n * Three categories, and each is a way an access request becomes a breach:\n *\n *  1. **Another person's data.** A workspace is shared. A member asking what\n *     we hold about THEM gets their own roster row, not the roster; their own\n *     support messages, not the thread's other authors. Handled by exporting\n *     the person and the workspace as different subjects with different\n *     scopes, never by filtering a single blob after the fact.\n *  2. **Secrets.** An `apiKeys` row confirms that a credential exists — its\n *     label, scopes, creator and dates, which are all facts about the subject\n *     — and never re-discloses the credential. Note the document ID *is* the\n *     SHA-256 of the token, so the id itself is withheld too; a hash handed\n *     back is a verifier handed back.\n *  3. **Staff-only fields.** Internal notes, override reasons and moderation\n *     state are about our handling, not about the person, and several name a\n *     staff member.\n *\n * ## What it is NOT\n *\n * Not `GET /api/hosts/export` — that is a Pro+ site-design backup whose own\n * header says it never includes bookings, leads, submissions or secrets, and\n * offering it as a portability answer would be misdescribing it. Not the\n * `firestore-export` cron, which is an unscoped DR snapshot. Not the audit CSV.\n */\n\nimport { firebaseAdmin } from './firebase-admin'\nimport { CONSOLE_DOMAINS_COLLECTION } from './console-domains'\n\nconst firestoreApp = () => firebaseAdmin.app().firestore()\n\n/** Which subject an export source belongs to. */\nexport type ExportSubject = 'user' | 'org'\n\n/** How a source is located — the axis a path cascade is blind to. */\nexport type ExportKeying =\n  /** Top-level collection carrying the subject id in a FIELD. */\n  | 'field'\n  /** Top-level collection whose DOCUMENT ID is the subject id. */\n  | 'doc-id'\n  /** Under the subject's own document path. */\n  | 'path'\n  /** Reached through another collection's rows (a collection group). */\n  | 'collection-group'\n  /** Outside Firestore entirely. */\n  | 'external'\n\nexport interface ExportSourceSpec {\n  /** Firestore collection name, or an `external:` pseudo-name. */\n  collection: string\n  keyedBy: ExportKeying\n  subjects: readonly ExportSubject[]\n  /**\n   * `true` when the export discloses it. `false` requires `reason` — and the\n   * reason is the whole value of the field: it is a decision recorded at the\n   * moment it was made, not an omission discovered later.\n   */\n  exported: boolean\n  /** Why it is withheld, or how it is disclosed. Always present. */\n  note: string\n}\n\n/**\n * Every collection `erase.ts` touches, and what the export does with it.\n *\n * Kept in the SAME order as the erasure's steps so a reader comparing the two\n * files reads them in step. `personal-data-export-coverage.spec.ts` proves the\n * set matches; this list carries the decision for each one.\n */\nexport const PERSONAL_DATA_SOURCES: readonly ExportSourceSpec[] = [\n  // ── The person ────────────────────────────────────────────────────────\n  {\n    collection: 'users',\n    keyedBy: 'doc-id',\n    subjects: ['user'],\n    exported: true,\n    note: 'Profile: name, phone, postal address, legalAcceptances, and every subcollection (orgs, hostMemberships, notifications, passkeys).',\n  },\n  {\n    collection: 'profiles',\n    keyedBy: 'doc-id',\n    subjects: ['user'],\n    exported: true,\n    note: 'The world-readable handle, display name and Stripe Connect account. Not reachable from the user tree (AGL-1970) — the same blind spot on both sides.',\n  },\n  // ── The workspace ─────────────────────────────────────────────────────\n  {\n    collection: 'orgs',\n    keyedBy: 'doc-id',\n    subjects: ['org'],\n    exported: true,\n    note: 'The org document and every subcollection: members, invites, roles, usage, apiUsage, analytics, datasets/records, contacts, lists, media, installs, activity, assistExchanges, retention.',\n  },\n  {\n    collection: 'hosts',\n    keyedBy: 'field',\n    subjects: ['org'],\n    exported: true,\n    note: 'Each site tree the org owns — screens, layouts, orders, form submissions. Secrets within are redacted, not omitted, so the export still says a webhook exists.',\n  },\n  {\n    collection: 'hostIndex',\n    keyedBy: 'doc-id',\n    subjects: ['org'],\n    exported: true,\n    note: 'Subdomain/CNAME routing for each of the org’s sites. Configuration the customer set, so it is theirs to take.',\n  },\n  {\n    collection: 'supplierDeliveries',\n    keyedBy: 'field',\n    subjects: ['org'],\n    exported: true,\n    note: 'The dropship outbox for each of the org’s sites, keyed by hostId (AGL-1448). Disclosed to the ORG and to no one else, and the reason is the unusual one: the personal data in the row is a SHOPPER’s — name, email and shipping address in the body we sign and POST to the supplier. That is the merchant’s own order record, which they already read in their console and for which they are the controller and we the processor, so an org access request is entitled to it. It is NOT a `user`-subject source: a console member asking what we hold about THEM is not the shopper, and returning these rows would answer their request with a third party’s address. Withholding it was not an option worth taking — `eraseHost` destroys these rows, so an export that omitted them would delete what it never disclosed.',\n  },\n  // ── Top-level, field-keyed: what a path cascade cannot see ────────────\n  {\n    collection: 'apiKeys',\n    keyedBy: 'field',\n    subjects: ['org'],\n    exported: true,\n    note: 'EXISTENCE ONLY — label, scopes, creating uid, dates. Never the credential, and never the document id, which is the SHA-256 of the token.',\n  },\n  {\n    collection: 'outreachMailboxCredentials',\n    keyedBy: 'field',\n    subjects: ['org'],\n    exported: true,\n    note: 'EXISTENCE ONLY — which connected mailbox a credential authorizes, its provider, granted scopes and dates (AGL-2974), and since AGL-2978 the connected account’s address, its Google account id and the member who connected it: the organization’s own record of whose mailbox it holds. Every token is redacted by name and by shape (see redactSecrets) and never disclosed; the sealed refresh token and the id of the key that sealed it both carry `token` in their names. The document id is the mailbox id, not derived from any secret, so it is disclosed.',\n  },\n  {\n    collection: 'ssoDomains',\n    keyedBy: 'field',\n    subjects: ['org'],\n    exported: true,\n    note: 'The public SSO routing document: domain, GCIP tenant and provider ids, IdP display name. `token` is redacted.',\n  },\n  {\n    collection: CONSOLE_DOMAINS_COLLECTION,\n    keyedBy: 'field',\n    subjects: ['org'],\n    exported: true,\n    note: 'Custom console domain claims the org holds.',\n  },\n  {\n    collection: 'apiIdempotency',\n    keyedBy: 'field',\n    subjects: ['org'],\n    exported: false,\n    note: 'Replay keys. The document id is a SHA-256 of the org id and the caller’s Idempotency-Key, and the row names a record id and nothing about a person. Disclosed as a COUNT so the export does not silently omit a collection the erasure destroys.',\n  },\n  {\n    collection: 'stripeCustomers',\n    keyedBy: 'field',\n    subjects: ['org'],\n    exported: true,\n    note: 'The local reverse index: which Stripe customer id belongs to this workspace. An identifier the customer already holds on their own invoices.',\n  },\n  {\n    collection: 'orgSlugs',\n    keyedBy: 'field',\n    subjects: ['org'],\n    exported: true,\n    note: 'Every workspace name the org has ever held, rename tombstones included — naming history is a fact about them.',\n  },\n  {\n    collection: 'publisherHandles',\n    keyedBy: 'field',\n    subjects: ['org'],\n    exported: true,\n    note: 'Marketplace handle reservations and rename tombstones (AGL-1970).',\n  },\n  {\n    collection: 'publisherProfiles',\n    keyedBy: 'doc-id',\n    subjects: ['org'],\n    exported: true,\n    note: 'The public publisher identity — handle, display name, bio, website, avatar, publisher agreement. `stripeAccountId` is the org’s own payout destination and is disclosed; nothing here is a credential.',\n  },\n  {\n    collection: 'marketplaceListings',\n    keyedBy: 'field',\n    subjects: ['org'],\n    exported: true,\n    note: 'Listings the org published. These deliberately OUTLIVE an erasure (AGL-1448 Tier 3) — which makes disclosing them on an access request more important, not less: they are the part that does not go away.',\n  },\n  {\n    collection: 'supportTickets',\n    keyedBy: 'field',\n    subjects: ['org', 'user'],\n    exported: true,\n    note: 'For an ORG: every thread and its messages. For a PERSON: only the messages they themselves authored — a thread has other authors, and handing a member the whole conversation would disclose colleagues’ words to them.',\n  },\n  // ── Retained past erasure on statutory grounds ────────────────────────\n  {\n    collection: 'platformRevenue',\n    keyedBy: 'field',\n    subjects: ['org'],\n    exported: true,\n    note: 'Per-transaction tax filing records. GDPR Art. 17(3)(b) exempts them from ERASURE (AGL-1811); it does not exempt them from ACCESS. If a transaction of theirs is in there it is disclosable — and the export is the only place a customer can see what survived their erasure.',\n  },\n  {\n    collection: 'storefrontTaxCollected',\n    keyedBy: 'field',\n    subjects: ['org'],\n    exported: true,\n    note: 'Sales tax charged to shoppers on the org’s storefront (AGL-1904). Same statutory retention, same access obligation.',\n  },\n  // ── Records of our own handling ───────────────────────────────────────\n  {\n    collection: 'adminAudit',\n    keyedBy: 'field',\n    subjects: ['org', 'user'],\n    exported: false,\n    note: 'STAFF-ONLY. Rows name the staff actor, carry override reasons and internal notes, and are the record of our handling rather than data about the subject. `/admin/audit` → Export CSV serves a request that specifically asks for them, after a staff read.',\n  },\n]\n\n/** Sources this export deliberately withholds, with the reason. */\nexport const EXPORT_WITHHELD = PERSONAL_DATA_SOURCES.filter((s) => !s.exported)\n\n/** Collection names the export claims to cover, for the coverage guard. */\nexport const EXPORT_COVERED_COLLECTIONS: readonly string[] =\n  PERSONAL_DATA_SOURCES.map((source) => source.collection)\n\n/**\n * ## WHY THIS IS SHAPE-DRIVEN AND NOT A LIST OF NAMES\n *\n * It used to be a list of names, anchored on separators:\n *\n *     /(^|[._-])(secret|token|password|apikey|…)($|[._-])/i\n *\n * That pattern requires a `.`, `_`, `-`, or a string boundary on both sides\n * of the word, so it reads `password_hash` and `webhooks.secret` and misses\n * `supplierToken` and `passwordScrypt` — the exact two fields the AGL-1881\n * review found leaving the platform in a customer's own export file. One is\n * a live bearer credential a supplier authenticates with; the other is a\n * shopper's scrypt password hash. **A denylist of names is always one naming\n * convention behind, and camelCase is the proof.**\n *\n * So the name half is now tokenized rather than separator-anchored, and it is\n * no longer the only gate. Three run, in order, and any of them redacts:\n *\n *  * **(A) The name, tokenized.** `supplierToken` splits to\n *    `['supplier','token']` the same way `supplier_token` and\n *    `SUPPLIER-TOKEN` do, so the convention stops mattering. A name matches\n *    on a single secret word or on an adjacent pair (`client secret`).\n *  * **(B) The VALUE's shape, whatever the key is called.** This is the half\n *    that does not need to know the schema: a PEM block, a JWT, a vendor\n *    prefix (`sk_live_`, `whsec_`, `ghp_`, `AKIA`…), a `$2b$`/`$argon2` hash,\n *    this repo's own `salt:hash` scrypt form, or an opaque high-entropy\n *    string is a credential whether the field is called `supplierToken`,\n *    `t`, or `notes`. **Gate B is the \"redact unless known safe\" default**:\n *    a credential-shaped string is withheld unless its key names it as a\n *    content identifier (see {@link SAFE_VALUE_WORDS}).\n *  * **(C) Credentials carried inside a URL.** `?token=`, `?sig=`,\n *    `?key=`, and `https://user:pass@host` are stripped from the URL rather\n *    than the URL being blanked, because a media object's `url` field really\n *    does carry a live Firebase download token in a query parameter, and the\n *    location of the customer's own file is exactly what an access request\n *    asks for. Precision beats blanking here.\n *\n * ### Why the KEY half is still deny-based, when the value half is not\n *\n * A true allowlist of field names is not available on this data. The export\n * walks documents whose field names our customers author — canvas nodes,\n * dataset records, custom metadata, form submissions — so an allowlist of\n * names would blank most of the file and turn an access request into a\n * non-answer, which is the under-disclosure this feature exists to stop. The\n * allowlist therefore lives where the vocabulary IS ours: value shapes. An\n * unrecognized VALUE shape is passed through (it is prose, a number, a date,\n * a customer's own content); an unrecognized value shape that looks like a\n * credential is withheld. That is the inversion the review asked for, put\n * where it can hold.\n *\n * ### The one deliberate carve-out\n *\n * `token`/`tokens` is also a metering word — `tokensUsed: 14203` on an\n * assist exchange is a usage count, and blanking it would blank a real\n * disclosure. A credential is a STRING; a count is a number. So a numeric or\n * boolean value under a name that matched only on a metering word passes\n * through. Nothing else in the vocabulary gets that treatment.\n *\n * A false positive costs a redacted field in an export. A false negative\n * costs a credential. Everything below is tuned in that direction.\n */\n\n/**\n * Split a field name into lowercase word tokens, convention-independently.\n *\n * `supplierToken`, `supplier_token`, `SUPPLIER-TOKEN` and `Supplier.Token`\n * all become `['supplier','token']`. Acronym runs split at the last capital\n * (`SSOTokenId` → `['sso','token','id']`) and digits break a word\n * (`apiKey2` → `['api','key','2']`), so a numbered field cannot hide.\n */\nexport function fieldNameTokens(key: unknown): string[] {\n  return String(key ?? '')\n    .replace(/[^A-Za-z0-9]+/g, ' ')\n    .replace(/([a-z0-9])([A-Z])/g, '$1 $2')\n    .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')\n    .replace(/([A-Za-z])([0-9])/g, '$1 $2')\n    .toLowerCase()\n    .split(' ')\n    .filter(Boolean)\n}\n\n/**\n * Words that make a field a credential on their own.\n *\n * Deliberately short. Every entry here is a word that has no innocent\n * meaning on a stored VALUE — `hmac`, `scrypt` and `bcrypt` name the\n * algorithm that produced a verifier, `passphrase` and `credential` name the\n * thing itself. `key` is NOT here and must never be: `publicKey` on a\n * passkey and `sortKey` on a dataset are not secrets, which is what\n * {@link SECRET_WORD_PAIRS} is for.\n */\nconst SECRET_WORDS = new Set([\n  'secret',\n  'secrets',\n  'password',\n  'passwords',\n  'passwd',\n  'pwd',\n  'passphrase',\n  'token',\n  'tokens',\n  'credential',\n  'credentials',\n  'apikey',\n  'privatekey',\n  'scrypt',\n  'bcrypt',\n  'argon',\n  'argon2',\n  'pbkdf2',\n  'hmac',\n  'otp',\n  'totp',\n  'authorization',\n])\n\n/**\n * Words that are a credential only next to another word.\n *\n * `key` is meaningless alone and decisive after `api`, `private`, `signing`,\n * `secret`, `session` or `encryption`; `token` after `access`/`refresh` is\n * already caught by {@link SECRET_WORDS} and listed here anyway so the pair\n * table reads as the complete statement of the rule.\n */\nconst SECRET_WORD_PAIRS = new Set([\n  'api key',\n  'private key',\n  'signing key',\n  'secret key',\n  'session key',\n  'encryption key',\n  'client secret',\n  'access token',\n  'refresh token',\n  'webhook secret',\n  'shared secret',\n  // A Stripe payment link is a live bearer URL: whoever holds it can pay.\n  // Named in the AGL-1443 inventory of what the old dump actually carried.\n  'payment link',\n  'auth code',\n  'recovery code',\n  'backup code',\n])\n\n/**\n * The metering carve-out — see the header. A name that matched ONLY on one\n * of these, over a number or a boolean, is a count and is disclosed.\n */\nconst METERING_WORDS = new Set(['token', 'tokens'])\n\n/**\n * Key words that mark a high-entropy value as a content identifier rather\n * than a credential, defusing gate (B) only.\n *\n * A SHA-256 has exactly the shape of a 64-character secret and is not one.\n * Gate (A) is never defused by this list: `apiKeyId` is redacted, because\n * the name says credential and an id of a credential is not worth the\n * argument.\n */\nconst SAFE_VALUE_WORDS = new Set([\n  // A passkey's `publicKey` is public by definition and has exactly the shape\n  // of a secret. Safe to list because gate (A) is never defused here — a\n  // `publicToken` is still redacted, on the strength of `token`.\n  'public',\n  'id',\n  'ids',\n  'uid',\n  'uuid',\n  'guid',\n  'hash',\n  'hashes',\n  'sha',\n  'sha1',\n  'sha256',\n  'sha512',\n  'md5',\n  'crc',\n  'crc32c',\n  'etag',\n  'checksum',\n  'digest',\n  'fingerprint',\n  'generation',\n  'version',\n  'revision',\n  'slug',\n  'path',\n  'url',\n  'uri',\n  'href',\n  'src',\n  'color',\n  'colour',\n  'hex',\n])\n\n/** Vendor credential prefixes — unambiguous, and worth naming explicitly. */\nconst CREDENTIAL_PREFIXES = [\n  'sk_live_',\n  'sk_test_',\n  'rk_live_',\n  'rk_test_',\n  'whsec_',\n  'ghp_',\n  'gho_',\n  'ghu_',\n  'ghs_',\n  'ghr_',\n  'github_pat_',\n  'xoxb-',\n  'xoxp-',\n  'xapp-',\n  'xoxa-',\n  'AKIA',\n  'ASIA',\n  'AIza',\n  'ya29.',\n  'SG.',\n  're_',\n  'shpat_',\n  'shpss_',\n  'npm_',\n  'glpat-',\n  'sq0csp-',\n  'sq0atp-',\n]\n\n/** A PEM block that carries a private key or a certificate request. */\nconst PEM_PATTERN = /-----BEGIN [A-Z0-9 ]*PRIVATE KEY-----/\n\n/** Modular crypt format: bcrypt, argon2, scrypt, PBKDF2, sha512-crypt. */\nconst CRYPT_HASH_PATTERN = /^\\$(2[abxy]?|argon2[a-z]*|scrypt|pbkdf2[^$]*|[56])\\$/\n\n/** This repo's own scrypt storage form: `{16+ hex salt}:{32+ hex hash}`. */\nconst SALTED_HASH_PATTERN = /^[0-9a-f]{16,}:[0-9a-f]{32,}$/i\n\n/** A JSON Web Token — three base64url segments. */\nconst JWT_PATTERN = /^[A-Za-z0-9_-]{8,}\\.[A-Za-z0-9_-]{8,}\\.[A-Za-z0-9_-]{8,}$/\n\n/** A UUID, which is an identifier far more often than it is a credential. */\nconst UUID_PATTERN =\n  /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i\n\n/** Charset of an opaque credential: base64, base64url or hex, nothing else. */\nconst OPAQUE_CHARSET = /^[A-Za-z0-9_+/=-]+$/\n\n/**\n * The window an opaque secret lives in.\n *\n * Below 32 characters the false-positive rate against ordinary identifiers is\n * not worth it and the value is too short to be a modern credential anyway.\n * Above 512 it is customer CONTENT — a base64 image, a compressed canvas\n * blob, an encoded document — and blanking those is the \"gutting the export\"\n * failure this file is explicitly trying not to commit.\n */\nconst OPAQUE_MIN_LENGTH = 32\nconst OPAQUE_MAX_LENGTH = 512\n\n/** Shannon entropy per character. Prose and slugs sit well below this. */\nconst OPAQUE_MIN_ENTROPY = 3.2\n\nfunction shannonEntropyPerChar(text: string): number {\n  const counts = new Map<string, number>()\n  for (const character of text) {\n    counts.set(character, (counts.get(character) ?? 0) + 1)\n  }\n  let entropy = 0\n  for (const count of counts.values()) {\n    const p = count / text.length\n    entropy -= p * Math.log2(p)\n  }\n  return entropy\n}\n\n/**\n * Does this STRING look like a credential, ignoring what it is called?\n *\n * Exported because the guard spec asserts each limb independently — a shape\n * detector tested only through the redactor is a detector whose gaps are\n * invisible.\n */\nexport function looksLikeCredential(value: string): boolean {\n  const text = value.trim()\n  if (!text) return false\n  if (PEM_PATTERN.test(text)) return true\n  if (CRYPT_HASH_PATTERN.test(text)) return true\n  if (SALTED_HASH_PATTERN.test(text)) return true\n  if (CREDENTIAL_PREFIXES.some((prefix) => text.startsWith(prefix))) return true\n  if (JWT_PATTERN.test(text)) return true\n  // Anything with whitespace is prose, and `data:` is an inline asset. Both\n  // are customer content, and neither is a bearer credential.\n  if (/\\s/.test(text)) return false\n  if (/^data:/i.test(text)) return false\n  if (UUID_PATTERN.test(text)) return false\n  if (text.length < OPAQUE_MIN_LENGTH || text.length > OPAQUE_MAX_LENGTH) {\n    return false\n  }\n  if (!OPAQUE_CHARSET.test(text)) return false\n  return shannonEntropyPerChar(text) >= OPAQUE_MIN_ENTROPY\n}\n\n/** What a stripped URL parameter reads as, so the removal is visible. */\nexport const REDACTED_URL_PARAM = 'REDACTED'\n\n/** Query parameters that carry a bearer credential inside a URL. */\nconst URL_CREDENTIAL_PARAMS = new Set([\n  'token',\n  'access_token',\n  'accesstoken',\n  'id_token',\n  'refresh_token',\n  'auth',\n  'authorization',\n  'apikey',\n  'api_key',\n  'key',\n  'sig',\n  'signature',\n  'secret',\n  'password',\n  'downloadtoken',\n])\n\n/**\n * Strip the credential out of a URL, keeping the URL.\n *\n * A media object's `url` is `…/o/{path}?alt=media&token={uuid}` — a live,\n * unauthenticated download credential, in a field an access request has a\n * real interest in. Blanking the whole value would tell the customer nothing\n * about where their own file is; keeping it whole hands out the credential.\n * So the parameter is replaced and the rest survives. `user:pass@` userinfo\n * goes the same way.\n *\n * Returns the input unchanged when it is not a URL — every non-URL string\n * has already been decided by the shape gate.\n */\nexport function scrubUrlCredentials(value: string): string {\n  if (!/^https?:\\/\\//i.test(value)) return value\n  let url: URL\n  try {\n    url = new URL(value)\n  } catch {\n    return value\n  }\n  let changed = false\n  if (url.username || url.password) {\n    url.username = ''\n    url.password = ''\n    changed = true\n  }\n  for (const name of Array.from(url.searchParams.keys())) {\n    if (!URL_CREDENTIAL_PARAMS.has(name.toLowerCase())) continue\n    if (!url.searchParams.get(name)) continue\n    url.searchParams.set(name, REDACTED_URL_PARAM)\n    changed = true\n  }\n  return changed ? url.toString() : value\n}\n\n/**\n * Gate (A): does the NAME say credential?\n *\n * `value` is consulted only for the metering carve-out described in the\n * header — a `tokensUsed: 14203` is a count, not a credential.\n */\nexport function secretByName(key: unknown, value?: unknown): boolean {\n  const tokens = fieldNameTokens(key)\n  if (!tokens.length) return false\n  const hits = tokens.filter((token) => SECRET_WORDS.has(token))\n  for (let index = 0; index + 1 < tokens.length; index += 1) {\n    if (SECRET_WORD_PAIRS.has(`${tokens[index]} ${tokens[index + 1]}`)) {\n      return true\n    }\n  }\n  if (!hits.length) return false\n  // Matched only on a metering word, over a number or a boolean: a count.\n  const metering = hits.every((token) => METERING_WORDS.has(token))\n  if (metering && (typeof value === 'number' || typeof value === 'boolean')) {\n    return false\n  }\n  return true\n}\n\n/** Gate (B)'s defuser: does the NAME say this high-entropy value is an id? */\nfunction nameMarksContentIdentifier(key: unknown): boolean {\n  return fieldNameTokens(key).some((token) => SAFE_VALUE_WORDS.has(token))\n}\n\n/** What a redacted value is replaced with — presence, never content. */\nexport interface RedactedValue {\n  redacted: true\n  /** Whether a value was actually there, so absence is distinguishable. */\n  present: boolean\n  reason: 'secret'\n}\n\nconst redactedMarker = (present: boolean): RedactedValue => ({\n  redacted: true,\n  present,\n  reason: 'secret',\n})\n\n/**\n * Deep-copy a document, replacing every credential-shaped value with a\n * presence marker.\n *\n * Presence rather than deletion, because \"we hold a webhook secret for you\"\n * is itself a true and disclosable fact, and a silently-absent key would make\n * the export look like it holds less than it does — the under-disclosure this\n * feature exists to stop, reintroduced by the safety measure.\n *\n * Firestore values that are not plain JSON (Timestamp, GeoPoint, DocumentRef,\n * Buffer) are stringified rather than walked: they carry no nested keys to\n * redact, and `JSON.stringify` on a Timestamp yields `{_seconds,_nanoseconds}`,\n * which is not a date to a human reading the file.\n *\n * Three gates, any of which redacts — the name (A), the value's shape (B),\n * and a credential embedded in a URL (C). See the header above\n * {@link fieldNameTokens} for why the value half is the one that carries the\n * \"withhold unless known safe\" default.\n */\nexport function redactSecrets(value: unknown, key = ''): unknown {\n  // (A) The name, tokenized — convention-independent.\n  if (key && secretByName(key, value)) {\n    return redactedMarker(value !== undefined && value !== null && value !== '')\n  }\n  if (value === null || value === undefined) return value ?? null\n  if (typeof value === 'string') {\n    // (C) A URL that carries its credential in a parameter keeps the URL and\n    // loses the credential — see {@link scrubUrlCredentials}.\n    const scrubbed = scrubUrlCredentials(value)\n    if (scrubbed !== value) return scrubbed\n    // (B) The shape, whatever the field is called. Withheld unless the name\n    // marks it as a content identifier.\n    if (looksLikeCredential(value) && !nameMarksContentIdentifier(key)) {\n      return redactedMarker(true)\n    }\n    return value\n  }\n  if (Array.isArray(value)) return value.map((entry) => redactSecrets(entry, key))\n  if (typeof value === 'object') {\n    const source = value as Record<string, unknown>\n    // Firestore Timestamp — the only non-plain value common enough to be\n    // worth rendering rather than dumping.\n    if (typeof (source as any).toDate === 'function') {\n      try {\n        return (source as any).toDate().toISOString()\n      } catch {\n        return String(value)\n      }\n    }\n    if (typeof (source as any).toBase64 === 'function') return '[binary]'\n    const out: Record<string, unknown> = {}\n    for (const [childKey, childValue] of Object.entries(source)) {\n      out[childKey] = redactSecrets(childValue, childKey)\n    }\n    return out\n  }\n  return value\n}\n\nexport interface ExportedDocument {\n  /** Document id — omitted where the id is itself a secret (see `apiKeys`). */\n  id?: string\n  path?: string\n  data: unknown\n}\n\nexport interface PersonalDataExport {\n  subject: { type: ExportSubject; id: string }\n  generatedAt: string\n  /**\n   * The disclosure decision for every source, copied into the file the\n   * customer receives. An export that silently omits a collection is\n   * indistinguishable from one that has nothing to report; this makes the two\n   * different, and it is what a supervisory authority would ask to see.\n   */\n  coverage: readonly ExportSourceSpec[]\n  /** Collection name → the documents disclosed for it. */\n  data: Record<string, ExportedDocument[]>\n  /** Collection name → row count, for sources disclosed as a count only. */\n  counts: Record<string, number>\n  /** Places we hold data that is not in Firestore. */\n  elsewhere: readonly string[]\n}\n\n/** Data we hold outside Firestore — named, because a file that omits them reads as complete. */\nconst ELSEWHERE = [\n  'Stripe — customer object, payment methods, invoices. Request from Stripe or ask us.',\n  'Resend — transactional email delivery logs.',\n  'Google Analytics — 14-month retention, not keyed to an account.',\n  'Cloud Storage — uploaded media and avatars, under users/{uid}/, orgs/{orgId}/ and hosts/{hostId}/. Listed by path in this file; the bytes are served by their own URLs.',\n]\n\nfunction sourcesFor(subject: ExportSubject): ExportSourceSpec[] {\n  return PERSONAL_DATA_SOURCES.filter((source) => source.subjects.includes(subject))\n}\n\n/** Read a top-level collection bounded by a field equal to the subject id. */\nasync function readByField(\n  db: any,\n  collection: string,\n  field: string,\n  id: string,\n  options: { includeIds?: boolean } = {},\n): Promise<ExportedDocument[]> {\n  const rows = await db.collection(collection).where(field, '==', id).get()\n  return rows.docs.map((doc: any) => ({\n    // `apiKeys` document ids are the SHA-256 of the token: an id handed back\n    // is a verifier handed back, so the caller opts in rather than out.\n    ...(options.includeIds === false ? {} : { id: doc.id }),\n    data: redactSecrets(doc.data()),\n  }))\n}\n\n/** Read one document by id, or nothing when it does not exist. */\nasync function readDoc(\n  db: any,\n  collection: string,\n  id: string,\n): Promise<ExportedDocument[]> {\n  const snapshot = await db.collection(collection).doc(id).get()\n  if (!snapshot.exists) return []\n  return [{ id, data: redactSecrets(snapshot.data()) }]\n}\n\n/**\n * Walk a document and everything beneath it.\n *\n * `listCollections()` rather than a hard-coded subcollection list, for the\n * same reason the erasure uses `recursiveDelete`: a subcollection added next\n * quarter is reached without anybody remembering this file exists. Bounded by\n * `maxDepth` because the tree is customer-shaped and an unbounded recursion\n * inside a request is how AGL-1455 lost erasures to a 60-second timeout.\n */\nasync function readSubtree(\n  db: any,\n  ref: any,\n  depth = 0,\n  maxDepth = 4,\n): Promise<ExportedDocument[]> {\n  const snapshot = await ref.get()\n  const found: ExportedDocument[] = []\n  if (snapshot.exists) {\n    found.push({ path: ref.path, data: redactSecrets(snapshot.data()) })\n  }\n  if (depth >= maxDepth) return found\n  const children = (await ref.listCollections?.()) ?? []\n  for (const child of children) {\n    const rows = await child.get()\n    for (const doc of rows.docs) {\n      found.push(...(await readSubtree(db, doc.ref, depth + 1, maxDepth)))\n    }\n  }\n  return found\n}\n\nexport interface ExportOptions {\n  /** Injectable for tests; defaults to the admin app's Firestore. */\n  firestore?: any\n  /** Stops a pathological workspace from building an unbounded file. */\n  maxDepth?: number\n}\n\n/**\n * Everything we hold about a PERSON, as the person themselves may ask for it\n * (GDPR Art. 15 and Art. 20).\n *\n * Scoped to them, never to the workspaces they belong to. Their membership row\n * in each org is theirs; the roster around it is their colleagues'. An org\n * export is a separate call with a separate authorization, which is the whole\n * reason the two are different functions rather than one with a flag.\n */\nexport async function exportUserData(\n  uid: string,\n  options: ExportOptions = {},\n): Promise<PersonalDataExport> {\n  const db = options.firestore ?? firestoreApp()\n  const data: Record<string, ExportedDocument[]> = {}\n  const counts: Record<string, number> = {}\n\n  // The profile tree — `users/{uid}` and every subcollection under it.\n  data['users'] = await readSubtree(\n    db,\n    db.collection('users').doc(uid),\n    0,\n    options.maxDepth ?? 4,\n  )\n\n  // The public identity, which the user tree does not reach (AGL-1970).\n  data['profiles'] = await readDoc(db, 'profiles', uid)\n\n  // ONLY the messages this person wrote. The threads belong to a workspace\n  // and carry other people's words; handing a member the whole conversation\n  // to answer their own access request is a disclosure nobody consented to.\n  const messages = await db\n    .collectionGroup('messages')\n    .where('authorId', '==', uid)\n    .get()\n    .catch(() => ({ docs: [] as any[] }))\n  data['supportTickets'] = messages.docs.map((doc: any) => ({\n    path: doc.ref.path,\n    data: redactSecrets(doc.data()),\n  }))\n\n  return {\n    subject: { type: 'user', id: uid },\n    generatedAt: new Date().toISOString(),\n    coverage: sourcesFor('user'),\n    data,\n    counts,\n    elsewhere: ELSEWHERE,\n  }\n}\n\n/**\n * Everything we hold about a WORKSPACE, for its owner (Art. 15 for the\n * personal data in it, and the \"export before you delete\" the Delete tab,\n * DPA §11 and Terms §13.3 have been promising).\n *\n * Every top-level collection the erasure sweeps by `orgId` is read here by the\n * same bound, so the two see the same rows. Where a source is withheld, its\n * COUNT is still reported: a collection that appears in neither the data nor\n * the counts is indistinguishable from one that does not exist, and that\n * ambiguity is what makes an incomplete export undetectable.\n */\nexport async function exportOrgData(\n  orgId: string,\n  options: ExportOptions = {},\n): Promise<PersonalDataExport> {\n  const db = options.firestore ?? firestoreApp()\n  const data: Record<string, ExportedDocument[]> = {}\n  const counts: Record<string, number> = {}\n\n  data['orgs'] = await readSubtree(\n    db,\n    db.collection('orgs').doc(orgId),\n    0,\n    options.maxDepth ?? 4,\n  )\n\n  // Sites: the routing entry and the whole tree for each.\n  const hosts = await db.collection('hosts').where('orgId', '==', orgId).get()\n  const hostDocs: ExportedDocument[] = []\n  const routing: ExportedDocument[] = []\n  const outbox: ExportedDocument[] = []\n  for (const host of hosts.docs) {\n    hostDocs.push(...(await readSubtree(db, host.ref, 0, options.maxDepth ?? 4)))\n    routing.push(...(await readDoc(db, 'hostIndex', host.id)))\n    // Keyed by `hostId`, not `orgId`, so it is read here rather than in the\n    // field-keyed loop below — the same bound `eraseHostSupplierDeliveries`\n    // sweeps by, so the export and the erasure see the same rows.\n    outbox.push(...(await readByField(db, 'supplierDeliveries', 'hostId', host.id)))\n  }\n  data['hosts'] = hostDocs\n  data['hostIndex'] = routing\n  data['supplierDeliveries'] = outbox\n\n  // The field-keyed collections a path cascade is blind to — the ones the\n  // erasure had to grow a sweep for, one issue at a time.\n  for (const collection of [\n    'ssoDomains',\n    CONSOLE_DOMAINS_COLLECTION,\n    'stripeCustomers',\n    'orgSlugs',\n    'publisherHandles',\n    'platformRevenue',\n    'storefrontTaxCollected',\n  ]) {\n    data[collection] = await readByField(db, collection, 'orgId', orgId)\n  }\n\n  // Existence, never the credential — and not the id either, which is the\n  // token's SHA-256.\n  data['apiKeys'] = await readByField(db, 'apiKeys', 'orgId', orgId, {\n    includeIds: false,\n  })\n\n  // Which mailboxes the reps connected, never the grant behind one: the\n  // tokens are withheld by `redactSecrets` like every other read here. The id\n  // is the mailbox's own, so unlike `apiKeys` it stays.\n  data['outreachMailboxCredentials'] = await readByField(\n    db,\n    'outreachMailboxCredentials',\n    'orgId',\n    orgId,\n  )\n\n  data['publisherProfiles'] = await readDoc(db, 'publisherProfiles', orgId)\n  data['marketplaceListings'] = await readByField(\n    db,\n    'marketplaceListings',\n    'profileId',\n    orgId,\n  )\n\n  // Support threads WITH their messages — for an org the whole thread is the\n  // org's own record, unlike the person-scoped export above.\n  const tickets = await db\n    .collection('supportTickets')\n    .where('orgId', '==', orgId)\n    .get()\n  const ticketDocs: ExportedDocument[] = []\n  for (const ticket of tickets.docs) {\n    ticketDocs.push(...(await readSubtree(db, ticket.ref, 0, 2)))\n  }\n  data['supportTickets'] = ticketDocs\n\n  // Withheld, but counted — see the note on this function.\n  const replayKeys = await db\n    .collection('apiIdempotency')\n    .where('orgId', '==', orgId)\n    .get()\n  counts['apiIdempotency'] = replayKeys.docs.length\n\n  return {\n    subject: { type: 'org', id: orgId },\n    generatedAt: new Date().toISOString(),\n    coverage: sourcesFor('org'),\n    data,\n    counts,\n    elsewhere: ELSEWHERE,\n  }\n}\n\n/** A filename a human can file: subject, id and the date it was produced. */\nexport function exportFilename(exported: PersonalDataExport): string {\n  const day = exported.generatedAt.slice(0, 10)\n  return `aglyn-${exported.subject.type}-data-${exported.subject.id}-${day}.json`\n}\n\nexport default exportUserData\n"],"names":["firebaseAdmin","CONSOLE_DOMAINS_COLLECTION","firestoreApp","app","firestore","PERSONAL_DATA_SOURCES","collection","keyedBy","subjects","exported","note","EXPORT_WITHHELD","filter","s","EXPORT_COVERED_COLLECTIONS","map","source","fieldNameTokens","key","String","replace","toLowerCase","split","Boolean","SECRET_WORDS","Set","SECRET_WORD_PAIRS","METERING_WORDS","SAFE_VALUE_WORDS","CREDENTIAL_PREFIXES","PEM_PATTERN","CRYPT_HASH_PATTERN","SALTED_HASH_PATTERN","JWT_PATTERN","UUID_PATTERN","OPAQUE_CHARSET","OPAQUE_MIN_LENGTH","OPAQUE_MAX_LENGTH","OPAQUE_MIN_ENTROPY","shannonEntropyPerChar","text","counts","Map","character","set","get","entropy","count","values","p","length","Math","log2","looksLikeCredential","value","trim","test","some","prefix","startsWith","REDACTED_URL_PARAM","URL_CREDENTIAL_PARAMS","scrubUrlCredentials","url","URL","changed","username","password","name","Array","from","searchParams","keys","has","toString","secretByName","tokens","hits","token","index","metering","every","nameMarksContentIdentifier","redactedMarker","present","redacted","reason","redactSecrets","undefined","scrubbed","isArray","entry","toDate","toISOString","toBase64","out","childKey","childValue","Object","entries","ELSEWHERE","sourcesFor","subject","includes","readByField","db","field","id","options","rows","where","docs","doc","includeIds","data","readDoc","snapshot","exists","readSubtree","ref","depth","maxDepth","found","push","path","children","listCollections","child","exportUserData","uid","messages","collectionGroup","catch","type","generatedAt","Date","coverage","elsewhere","exportOrgData","orgId","hosts","hostDocs","routing","outbox","host","tickets","ticketDocs","ticket","replayKeys","exportFilename","day","slice"],"mappings":"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A;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD;AAED;;;;;;;CAOC,GACD,MAAMC,oBAAoB,IAAID,IAAI;IAChC;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA,wEAAwE;IACxE,yEAAyE;IACzE;IACA;IACA;IACA;CACD;AAED;;;CAGC,GACD,MAAME,iBAAiB,IAAIF,IAAI;IAAC;IAAS;CAAS;AAElD;;;;;;;;CAQC,GACD,MAAMG,mBAAmB,IAAIH,IAAI;IAC/B,4EAA4E;IAC5E,uEAAuE;IACvE,+DAA+D;IAC/D;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD;AAED,2EAA2E,GAC3E,MAAMI,sBAAsB;IAC1B;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD;AAED,qEAAqE,GACrE,MAAMC,cAAc;AAEpB,wEAAwE,GACxE,MAAMC,qBAAqB;AAE3B,0EAA0E,GAC1E,MAAMC,sBAAsB;AAE5B,iDAAiD,GACjD,MAAMC,cAAc;AAEpB,2EAA2E,GAC3E,MAAMC,eACJ;AAEF,6EAA6E,GAC7E,MAAMC,iBAAiB;AAEvB;;;;;;;;CAQC,GACD,MAAMC,oBAAoB;AAC1B,MAAMC,oBAAoB;AAE1B,wEAAwE,GACxE,MAAMC,qBAAqB;AAE3B,SAASC,sBAAsBC,IAAY;IACzC,MAAMC,SAAS,IAAIC;IACnB,KAAK,MAAMC,aAAaH,KAAM;YACLC;QAAvBA,OAAOG,GAAG,CAACD,WAAW,EAACF,cAAAA,OAAOI,GAAG,CAACF,sBAAXF,cAAyB,KAAK;IACvD;IACA,IAAIK,UAAU;IACd,KAAK,MAAMC,SAASN,OAAOO,MAAM,GAAI;QACnC,MAAMC,IAAIF,QAAQP,KAAKU,MAAM;QAC7BJ,WAAWG,IAAIE,KAAKC,IAAI,CAACH;IAC3B;IACA,OAAOH;AACT;AAEA;;;;;;CAMC,GACD,OAAO,SAASO,oBAAoBC,KAAa;IAC/C,MAAMd,OAAOc,MAAMC,IAAI;IACvB,IAAI,CAACf,MAAM,OAAO;IAClB,IAAIV,YAAY0B,IAAI,CAAChB,OAAO,OAAO;IACnC,IAAIT,mBAAmByB,IAAI,CAAChB,OAAO,OAAO;IAC1C,IAAIR,oBAAoBwB,IAAI,CAAChB,OAAO,OAAO;IAC3C,IAAIX,oBAAoB4B,IAAI,CAAC,CAACC,SAAWlB,KAAKmB,UAAU,CAACD,UAAU,OAAO;IAC1E,IAAIzB,YAAYuB,IAAI,CAAChB,OAAO,OAAO;IACnC,0EAA0E;IAC1E,4DAA4D;IAC5D,IAAI,KAAKgB,IAAI,CAAChB,OAAO,OAAO;IAC5B,IAAI,UAAUgB,IAAI,CAAChB,OAAO,OAAO;IACjC,IAAIN,aAAasB,IAAI,CAAChB,OAAO,OAAO;IACpC,IAAIA,KAAKU,MAAM,GAAGd,qBAAqBI,KAAKU,MAAM,GAAGb,mBAAmB;QACtE,OAAO;IACT;IACA,IAAI,CAACF,eAAeqB,IAAI,CAAChB,OAAO,OAAO;IACvC,OAAOD,sBAAsBC,SAASF;AACxC;AAEA,uEAAuE,GACvE,OAAO,MAAMsB,qBAAqB,WAAU;AAE5C,kEAAkE,GAClE,MAAMC,wBAAwB,IAAIpC,IAAI;IACpC;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD;AAED;;;;;;;;;;;;CAYC,GACD,OAAO,SAASqC,oBAAoBR,KAAa;IAC/C,IAAI,CAAC,gBAAgBE,IAAI,CAACF,QAAQ,OAAOA;IACzC,IAAIS;IACJ,IAAI;QACFA,MAAM,IAAIC,IAAIV;IAChB,EAAE,eAAM;QACN,OAAOA;IACT;IACA,IAAIW,UAAU;IACd,IAAIF,IAAIG,QAAQ,IAAIH,IAAII,QAAQ,EAAE;QAChCJ,IAAIG,QAAQ,GAAG;QACfH,IAAII,QAAQ,GAAG;QACfF,UAAU;IACZ;IACA,KAAK,MAAMG,QAAQC,MAAMC,IAAI,CAACP,IAAIQ,YAAY,CAACC,IAAI,IAAK;QACtD,IAAI,CAACX,sBAAsBY,GAAG,CAACL,KAAK/C,WAAW,KAAK;QACpD,IAAI,CAAC0C,IAAIQ,YAAY,CAAC1B,GAAG,CAACuB,OAAO;QACjCL,IAAIQ,YAAY,CAAC3B,GAAG,CAACwB,MAAMR;QAC3BK,UAAU;IACZ;IACA,OAAOA,UAAUF,IAAIW,QAAQ,KAAKpB;AACpC;AAEA;;;;;CAKC,GACD,OAAO,SAASqB,aAAazD,GAAY,EAAEoC,KAAe;IACxD,MAAMsB,SAAS3D,gBAAgBC;IAC/B,IAAI,CAAC0D,OAAO1B,MAAM,EAAE,OAAO;IAC3B,MAAM2B,OAAOD,OAAOhE,MAAM,CAAC,CAACkE,QAAUtD,aAAaiD,GAAG,CAACK;IACvD,IAAK,IAAIC,QAAQ,GAAGA,QAAQ,IAAIH,OAAO1B,MAAM,EAAE6B,SAAS,EAAG;QACzD,IAAIrD,kBAAkB+C,GAAG,CAAC,GAAGG,MAAM,CAACG,MAAM,CAAC,CAAC,EAAEH,MAAM,CAACG,QAAQ,EAAE,EAAE,GAAG;YAClE,OAAO;QACT;IACF;IACA,IAAI,CAACF,KAAK3B,MAAM,EAAE,OAAO;IACzB,wEAAwE;IACxE,MAAM8B,WAAWH,KAAKI,KAAK,CAAC,CAACH,QAAUnD,eAAe8C,GAAG,CAACK;IAC1D,IAAIE,YAAa,CAAA,OAAO1B,UAAU,YAAY,OAAOA,UAAU,SAAQ,GAAI;QACzE,OAAO;IACT;IACA,OAAO;AACT;AAEA,4EAA4E,GAC5E,SAAS4B,2BAA2BhE,GAAY;IAC9C,OAAOD,gBAAgBC,KAAKuC,IAAI,CAAC,CAACqB,QAAUlD,iBAAiB6C,GAAG,CAACK;AACnE;AAUA,MAAMK,iBAAiB,CAACC,UAAqC,CAAA;QAC3DC,UAAU;QACVD;QACAE,QAAQ;IACV,CAAA;AAEA;;;;;;;;;;;;;;;;;;CAkBC,GACD,OAAO,SAASC,cAAcjC,KAAc,EAAEpC,MAAM,EAAE;IACpD,oDAAoD;IACpD,IAAIA,OAAOyD,aAAazD,KAAKoC,QAAQ;QACnC,OAAO6B,eAAe7B,UAAUkC,aAAalC,UAAU,QAAQA,UAAU;IAC3E;IACA,IAAIA,UAAU,QAAQA,UAAUkC,WAAW,OAAOlC,gBAAAA,QAAS;IAC3D,IAAI,OAAOA,UAAU,UAAU;QAC7B,yEAAyE;QACzE,0DAA0D;QAC1D,MAAMmC,WAAW3B,oBAAoBR;QACrC,IAAImC,aAAanC,OAAO,OAAOmC;QAC/B,wEAAwE;QACxE,oCAAoC;QACpC,IAAIpC,oBAAoBC,UAAU,CAAC4B,2BAA2BhE,MAAM;YAClE,OAAOiE,eAAe;QACxB;QACA,OAAO7B;IACT;IACA,IAAIe,MAAMqB,OAAO,CAACpC,QAAQ,OAAOA,MAAMvC,GAAG,CAAC,CAAC4E,QAAUJ,cAAcI,OAAOzE;IAC3E,IAAI,OAAOoC,UAAU,UAAU;QAC7B,MAAMtC,SAASsC;QACf,qEAAqE;QACrE,uCAAuC;QACvC,IAAI,OAAO,AAACtC,OAAe4E,MAAM,KAAK,YAAY;YAChD,IAAI;gBACF,OAAO,AAAC5E,OAAe4E,MAAM,GAAGC,WAAW;YAC7C,EAAE,eAAM;gBACN,OAAO1E,OAAOmC;YAChB;QACF;QACA,IAAI,OAAO,AAACtC,OAAe8E,QAAQ,KAAK,YAAY,OAAO;QAC3D,MAAMC,MAA+B,CAAC;QACtC,KAAK,MAAM,CAACC,UAAUC,WAAW,IAAIC,OAAOC,OAAO,CAACnF,QAAS;YAC3D+E,GAAG,CAACC,SAAS,GAAGT,cAAcU,YAAYD;QAC5C;QACA,OAAOD;IACT;IACA,OAAOzC;AACT;AA2BA,8FAA8F,GAC9F,MAAM8C,YAAY;IAChB;IACA;IACA;IACA;CACD;AAED,SAASC,WAAWC,OAAsB;IACxC,OAAOjG,sBAAsBO,MAAM,CAAC,CAACI,SAAWA,OAAOR,QAAQ,CAAC+F,QAAQ,CAACD;AAC3E;AAEA,4EAA4E,GAC5E,eAAeE,YACbC,EAAO,EACPnG,UAAkB,EAClBoG,KAAa,EACbC,EAAU,EACVC,UAAoC,CAAC,CAAC;IAEtC,MAAMC,OAAO,MAAMJ,GAAGnG,UAAU,CAACA,YAAYwG,KAAK,CAACJ,OAAO,MAAMC,IAAI9D,GAAG;IACvE,OAAOgE,KAAKE,IAAI,CAAChG,GAAG,CAAC,CAACiG,MAAc,aAG9BJ,QAAQK,UAAU,KAAK,QAAQ,CAAC,IAAI;YAAEN,IAAIK,IAAIL,EAAE;QAAC;YACrDO,MAAM3B,cAAcyB,IAAIE,IAAI;;AAEhC;AAEA,gEAAgE,GAChE,eAAeC,QACbV,EAAO,EACPnG,UAAkB,EAClBqG,EAAU;IAEV,MAAMS,WAAW,MAAMX,GAAGnG,UAAU,CAACA,YAAY0G,GAAG,CAACL,IAAI9D,GAAG;IAC5D,IAAI,CAACuE,SAASC,MAAM,EAAE,OAAO,EAAE;IAC/B,OAAO;QAAC;YAAEV;YAAIO,MAAM3B,cAAc6B,SAASF,IAAI;QAAI;KAAE;AACvD;AAEA;;;;;;;;CAQC,GACD,eAAeI,YACbb,EAAO,EACPc,GAAQ,EACRC,QAAQ,CAAC,EACTC,WAAW,CAAC;QAQM;IANlB,MAAML,WAAW,MAAMG,IAAI1E,GAAG;IAC9B,MAAM6E,QAA4B,EAAE;IACpC,IAAIN,SAASC,MAAM,EAAE;QACnBK,MAAMC,IAAI,CAAC;YAAEC,MAAML,IAAIK,IAAI;YAAEV,MAAM3B,cAAc6B,SAASF,IAAI;QAAI;IACpE;IACA,IAAIM,SAASC,UAAU,OAAOC;IAC9B,MAAMG,YAAY,OAAA,OAAMN,IAAIO,eAAe,oBAAnBP,IAAIO,eAAe,MAAnBP,iBAAN,OAAkC,EAAE;IACtD,KAAK,MAAMQ,SAASF,SAAU;QAC5B,MAAMhB,OAAO,MAAMkB,MAAMlF,GAAG;QAC5B,KAAK,MAAMmE,OAAOH,KAAKE,IAAI,CAAE;YAC3BW,MAAMC,IAAI,IAAK,MAAML,YAAYb,IAAIO,IAAIO,GAAG,EAAEC,QAAQ,GAAGC;QAC3D;IACF;IACA,OAAOC;AACT;AASA;;;;;;;;CAQC,GACD,OAAO,eAAeM,eACpBC,GAAW,EACXrB,UAAyB,CAAC,CAAC;QAEhBA,oBASTA;IATF,MAAMH,MAAKG,qBAAAA,QAAQxG,SAAS,YAAjBwG,qBAAqB1G;IAChC,MAAMgH,OAA2C,CAAC;IAClD,MAAMzE,SAAiC,CAAC;IAExC,qEAAqE;IACrEyE,IAAI,CAAC,QAAQ,GAAG,MAAMI,YACpBb,IACAA,GAAGnG,UAAU,CAAC,SAAS0G,GAAG,CAACiB,MAC3B,IACArB,oBAAAA,QAAQa,QAAQ,YAAhBb,oBAAoB;IAGtB,sEAAsE;IACtEM,IAAI,CAAC,WAAW,GAAG,MAAMC,QAAQV,IAAI,YAAYwB;IAEjD,yEAAyE;IACzE,0EAA0E;IAC1E,0EAA0E;IAC1E,MAAMC,WAAW,MAAMzB,GACpB0B,eAAe,CAAC,YAChBrB,KAAK,CAAC,YAAY,MAAMmB,KACxBpF,GAAG,GACHuF,KAAK,CAAC,IAAO,CAAA;YAAErB,MAAM,EAAE;QAAU,CAAA;IACpCG,IAAI,CAAC,iBAAiB,GAAGgB,SAASnB,IAAI,CAAChG,GAAG,CAAC,CAACiG,MAAc,CAAA;YACxDY,MAAMZ,IAAIO,GAAG,CAACK,IAAI;YAClBV,MAAM3B,cAAcyB,IAAIE,IAAI;QAC9B,CAAA;IAEA,OAAO;QACLZ,SAAS;YAAE+B,MAAM;YAAQ1B,IAAIsB;QAAI;QACjCK,aAAa,IAAIC,OAAO1C,WAAW;QACnC2C,UAAUnC,WAAW;QACrBa;QACAzE;QACAgG,WAAWrC;IACb;AACF;AAEA;;;;;;;;;;CAUC,GACD,OAAO,eAAesC,cACpBC,KAAa,EACb/B,UAAyB,CAAC,CAAC;QAEhBA,oBAQTA;IARF,MAAMH,MAAKG,qBAAAA,QAAQxG,SAAS,YAAjBwG,qBAAqB1G;IAChC,MAAMgH,OAA2C,CAAC;IAClD,MAAMzE,SAAiC,CAAC;IAExCyE,IAAI,CAAC,OAAO,GAAG,MAAMI,YACnBb,IACAA,GAAGnG,UAAU,CAAC,QAAQ0G,GAAG,CAAC2B,QAC1B,IACA/B,oBAAAA,QAAQa,QAAQ,YAAhBb,oBAAoB;IAGtB,wDAAwD;IACxD,MAAMgC,QAAQ,MAAMnC,GAAGnG,UAAU,CAAC,SAASwG,KAAK,CAAC,SAAS,MAAM6B,OAAO9F,GAAG;IAC1E,MAAMgG,WAA+B,EAAE;IACvC,MAAMC,UAA8B,EAAE;IACtC,MAAMC,SAA6B,EAAE;IACrC,KAAK,MAAMC,QAAQJ,MAAM7B,IAAI,CAAE;YACwBH;QAArDiC,SAASlB,IAAI,IAAK,MAAML,YAAYb,IAAIuC,KAAKzB,GAAG,EAAE,IAAGX,qBAAAA,QAAQa,QAAQ,YAAhBb,qBAAoB;QACzEkC,QAAQnB,IAAI,IAAK,MAAMR,QAAQV,IAAI,aAAauC,KAAKrC,EAAE;QACvD,wEAAwE;QACxE,wEAAwE;QACxE,8DAA8D;QAC9DoC,OAAOpB,IAAI,IAAK,MAAMnB,YAAYC,IAAI,sBAAsB,UAAUuC,KAAKrC,EAAE;IAC/E;IACAO,IAAI,CAAC,QAAQ,GAAG2B;IAChB3B,IAAI,CAAC,YAAY,GAAG4B;IACpB5B,IAAI,CAAC,qBAAqB,GAAG6B;IAE7B,wEAAwE;IACxE,wDAAwD;IACxD,KAAK,MAAMzI,cAAc;QACvB;QACAL;QACA;QACA;QACA;QACA;QACA;KACD,CAAE;QACDiH,IAAI,CAAC5G,WAAW,GAAG,MAAMkG,YAAYC,IAAInG,YAAY,SAASqI;IAChE;IAEA,wEAAwE;IACxE,mBAAmB;IACnBzB,IAAI,CAAC,UAAU,GAAG,MAAMV,YAAYC,IAAI,WAAW,SAASkC,OAAO;QACjE1B,YAAY;IACd;IAEA,sEAAsE;IACtE,4EAA4E;IAC5E,sDAAsD;IACtDC,IAAI,CAAC,6BAA6B,GAAG,MAAMV,YACzCC,IACA,8BACA,SACAkC;IAGFzB,IAAI,CAAC,oBAAoB,GAAG,MAAMC,QAAQV,IAAI,qBAAqBkC;IACnEzB,IAAI,CAAC,sBAAsB,GAAG,MAAMV,YAClCC,IACA,uBACA,aACAkC;IAGF,2EAA2E;IAC3E,2DAA2D;IAC3D,MAAMM,UAAU,MAAMxC,GACnBnG,UAAU,CAAC,kBACXwG,KAAK,CAAC,SAAS,MAAM6B,OACrB9F,GAAG;IACN,MAAMqG,aAAiC,EAAE;IACzC,KAAK,MAAMC,UAAUF,QAAQlC,IAAI,CAAE;QACjCmC,WAAWvB,IAAI,IAAK,MAAML,YAAYb,IAAI0C,OAAO5B,GAAG,EAAE,GAAG;IAC3D;IACAL,IAAI,CAAC,iBAAiB,GAAGgC;IAEzB,yDAAyD;IACzD,MAAME,aAAa,MAAM3C,GACtBnG,UAAU,CAAC,kBACXwG,KAAK,CAAC,SAAS,MAAM6B,OACrB9F,GAAG;IACNJ,MAAM,CAAC,iBAAiB,GAAG2G,WAAWrC,IAAI,CAAC7D,MAAM;IAEjD,OAAO;QACLoD,SAAS;YAAE+B,MAAM;YAAO1B,IAAIgC;QAAM;QAClCL,aAAa,IAAIC,OAAO1C,WAAW;QACnC2C,UAAUnC,WAAW;QACrBa;QACAzE;QACAgG,WAAWrC;IACb;AACF;AAEA,2EAA2E,GAC3E,OAAO,SAASiD,eAAe5I,QAA4B;IACzD,MAAM6I,MAAM7I,SAAS6H,WAAW,CAACiB,KAAK,CAAC,GAAG;IAC1C,OAAO,CAAC,MAAM,EAAE9I,SAAS6F,OAAO,CAAC+B,IAAI,CAAC,MAAM,EAAE5H,SAAS6F,OAAO,CAACK,EAAE,CAAC,CAAC,EAAE2C,IAAI,KAAK,CAAC;AACjF;AAEA,eAAetB,eAAc"}

package/src/lib/server/platform-domain-names.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @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 { DomainCheck } from './sso-provisioning';
+/** Hostname shape: dash-free at label edges, a real TLD, at least two labels. */
+export declare const PLATFORM_DOMAIN_PATTERN: RegExp;
+/** RFC 1035: a fully-qualified name is at most 253 octets. */
+export declare const MAX_DOMAIN_LENGTH = 253;
+/** Reserved as the name itself AND as any subdomain of it. See the header. */
+export declare const RESERVED_DOMAIN_SUFFIXES: readonly string[];
+/** Reserved as a WHOLE name only — `acme.co.uk` stays claimable. */
+export declare const BARE_PUBLIC_SUFFIXES: ReadonlySet<string>;
+/**
+ * Trim, lowercase, drop a trailing root dot, and tolerate a pasted URL.
+ *
+ * People paste `https://console.acme.com/` into a domain field constantly, and
+ * refusing that is a support ticket rather than a security control — the value
+ * is re-validated against the shape below either way.
+ */
+export declare function normalizePlatformDomain(input: string): string;
+/**
+ * Whether a normalised name belongs to the platform rather than a customer.
+ *
+ * `TENANT_APEX` is consulted at call time rather than baked into the list
+ * above, and that is the load-bearing half rather than a nicety. The static
+ * entries name *our* production zones; the correspondence this file exists to
+ * protect is a property of **whichever apex this deployment attaches
+ * `{subdomain}.{apex}` redirects to**, which a self-host operator sets with
+ * `NEXT_PUBLIC_TENANT_DOMAIN`. A blocklist that only knew `aglyn.app` would
+ * leave every self-host install with the hole we are closing here.
+ */
+export declare function isPlatformReservedDomain(domain: string): boolean;
+/**
+ * Shape, length and reserved-name check for a customer-supplied hostname.
+ *
+ * `{ domain, error }` with both keys always present rather than a discriminated
+ * union, matching `validateSsoDomain` — `strictNullChecks` is off repo-wide and
+ * an `{ ok: true } | { ok: false }` union does not narrow reliably once it
+ * crosses a library boundary.
+ *
+ * `copy` is a parameter rather than a constant because the console and site
+ * wizards are different products to the customer standing in front of them,
+ * and these two strings are the ones a customer reads and acts on. The RULES
+ * are shared; only the wording is not.
+ */
+export declare function validatePlatformDomain(input: string, copy: {
+    invalid: string;
+    reserved: string;
+}): DomainCheck;

package/src/lib/server/platform-domain-names.js

@@ -0,0 +1,197 @@
+/**
+ * @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.
+ */ /**
+ * Which hostnames a customer may claim, and which are the platform's own.
+ *
+ * ## Why this file exists (AGL-1430)
+ *
+ * Both domain surfaces — `consoleDomains` (white-label console, AGL-1353) and
+ * `hosts.cname` (site custom domain, AGL-166/743) — attach customer names to a
+ * Vercel project whose add-domain call **tolerates `domain_already_in_use`**.
+ * That tolerance is only safe while the Firestore claim indexes *every* name
+ * the platform holds on that project. A name that reaches Vercel without a
+ * claim can be claimed by a second org, which reads the tolerated 409 as
+ * health and has its visitors redirected to a stranger's site.
+ *
+ * `console-domains.ts` reasoned this through and built the blocklist. The site
+ * path never got one, and it was the path with the live hole: AGL-1273 attaches
+ * `{subdomain}.{TENANT_APEX}` to the tenant project as a 307 redirect on every
+ * custom-domain connect, and nothing indexes that name as anybody's `cname`.
+ * Org B could claim org A's `alice.aglyn.app`, watch `projectDomainStatus`
+ * truthfully answer `serving` — the name really is on our project — and end up
+ * with its own `{sub}.aglyn.app` 307ing to org A's site.
+ *
+ * So the lists live here, once, and both surfaces read them. A name added to
+ * one blocklist is added to both, which is the property that was missing.
+ *
+ * ## The two ways a name is reserved
+ *
+ * **Suffix-reserved** (`RESERVED_DOMAIN_SUFFIXES`) — blocked as the name itself
+ * *and as any subdomain of it*. Two families:
+ *
+ * - **Ours.** `aglyn.com`, `aglyn.io`, `aglyn.app`, `aglyn.dev`. Keying on the
+ *   registrable domain covers every entry of `PRODUCTION_DOMAINS` in
+ *   `security-origins.js` without duplicating that list, and keeps covering
+ *   names added to it later. `console-domains.spec.ts` walks the real file and
+ *   asserts exactly that.
+ * - **Shared app-hosting suffixes.** Nobody controls the zone at
+ *   `something.vercel.app` in the sense these features need — AGL-1353 measured
+ *   `aglyn-console-aglyn.vercel.app` already serving a real console. Proving
+ *   control of a name a platform hands out for free proves something that can
+ *   be re-handed to someone else.
+ *
+ * **Bare-suffix-reserved** (`BARE_PUBLIC_SUFFIXES`) — blocked as a *whole name
+ * only*. `acme.co.uk` is a perfectly good customer domain; `co.uk` is not a
+ * domain at all. A short list rather than the Public Suffix List on purpose:
+ * pulling in a PSL dependency to reject a name no registrar would sell is not a
+ * trade worth making, and the single-label rule catches the commoner `com` case
+ * for free.
+ */ import { TENANT_APEX } from "@aglyn/aglyn/server";
+const LABEL = '[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?';
+/** Hostname shape: dash-free at label edges, a real TLD, at least two labels. */ export const PLATFORM_DOMAIN_PATTERN = new RegExp(`^${LABEL}(?:\\.${LABEL})*\\.[a-z]{2,63}$`);
+/** RFC 1035: a fully-qualified name is at most 253 octets. */ export const MAX_DOMAIN_LENGTH = 253;
+/** Reserved as the name itself AND as any subdomain of it. See the header. */ export const RESERVED_DOMAIN_SUFFIXES = [
+    'aglyn.com',
+    'aglyn.io',
+    'aglyn.app',
+    'aglyn.dev',
+    'vercel.app',
+    'vercel.sh',
+    'web.app',
+    'firebaseapp.com',
+    'appspot.com',
+    'cloudfunctions.net',
+    'run.app',
+    'pages.dev',
+    'workers.dev',
+    'netlify.app',
+    'github.io',
+    'herokuapp.com',
+    'azurewebsites.net',
+    'amplifyapp.com',
+    'onrender.com',
+    'fly.dev',
+    'ngrok.io',
+    'ngrok-free.app',
+    'trycloudflare.com',
+    // RFC 2606 / 6761 special-use names, plus the ones a misconfigured resolver
+    // answers for. None of these can be proved by a public TXT lookup.
+    'localhost',
+    'local',
+    'localdomain',
+    'internal',
+    'intranet',
+    'lan',
+    'home',
+    'corp',
+    'test',
+    'example',
+    'invalid',
+    'onion'
+];
+/** Reserved as a WHOLE name only — `acme.co.uk` stays claimable. */ export const BARE_PUBLIC_SUFFIXES = new Set([
+    'co.uk',
+    'org.uk',
+    'me.uk',
+    'ac.uk',
+    'gov.uk',
+    'com.au',
+    'net.au',
+    'org.au',
+    'co.nz',
+    'co.za',
+    'co.jp',
+    'ne.jp',
+    'or.jp',
+    'com.br',
+    'com.mx',
+    'com.cn',
+    'com.tr',
+    'co.in',
+    'co.kr',
+    'com.sg',
+    'com.hk'
+]);
+/**
+ * Trim, lowercase, drop a trailing root dot, and tolerate a pasted URL.
+ *
+ * People paste `https://console.acme.com/` into a domain field constantly, and
+ * refusing that is a support ticket rather than a security control — the value
+ * is re-validated against the shape below either way.
+ */ export function normalizePlatformDomain(input) {
+    const raw = String(input != null ? input : '').trim().toLowerCase();
+    if (!raw) return '';
+    return raw.replace(/^[a-z][a-z0-9+.-]*:\/\//, '').replace(/^[^@]*@/, '').split(/[/?#]/)[0].replace(/\.+$/, '');
+}
+/**
+ * Whether a normalised name belongs to the platform rather than a customer.
+ *
+ * `TENANT_APEX` is consulted at call time rather than baked into the list
+ * above, and that is the load-bearing half rather than a nicety. The static
+ * entries name *our* production zones; the correspondence this file exists to
+ * protect is a property of **whichever apex this deployment attaches
+ * `{subdomain}.{apex}` redirects to**, which a self-host operator sets with
+ * `NEXT_PUBLIC_TENANT_DOMAIN`. A blocklist that only knew `aglyn.app` would
+ * leave every self-host install with the hole we are closing here.
+ */ export function isPlatformReservedDomain(domain) {
+    if (!domain) return true;
+    if (BARE_PUBLIC_SUFFIXES.has(domain)) return true;
+    const apex = String(TENANT_APEX != null ? TENANT_APEX : '').trim().toLowerCase();
+    const suffixes = apex ? [
+        ...RESERVED_DOMAIN_SUFFIXES,
+        apex
+    ] : RESERVED_DOMAIN_SUFFIXES;
+    return suffixes.some((suffix)=>domain === suffix || domain.endsWith(`.${suffix}`));
+}
+/**
+ * Shape, length and reserved-name check for a customer-supplied hostname.
+ *
+ * `{ domain, error }` with both keys always present rather than a discriminated
+ * union, matching `validateSsoDomain` — `strictNullChecks` is off repo-wide and
+ * an `{ ok: true } | { ok: false }` union does not narrow reliably once it
+ * crosses a library boundary.
+ *
+ * `copy` is a parameter rather than a constant because the console and site
+ * wizards are different products to the customer standing in front of them,
+ * and these two strings are the ones a customer reads and acts on. The RULES
+ * are shared; only the wording is not.
+ */ export function validatePlatformDomain(input, copy) {
+    const domain = normalizePlatformDomain(input);
+    if (!domain || domain.length > MAX_DOMAIN_LENGTH || !PLATFORM_DOMAIN_PATTERN.test(domain)) {
+        return {
+            domain: null,
+            error: copy.invalid
+        };
+    }
+    if (domain.split('.').length < 2) {
+        return {
+            domain: null,
+            error: 'Enter a full domain name, not a single label'
+        };
+    }
+    if (isPlatformReservedDomain(domain)) {
+        return {
+            domain: null,
+            error: copy.reserved
+        };
+    }
+    return {
+        domain,
+        error: null
+    };
+}
+
+//# sourceMappingURL=platform-domain-names.js.map

package/src/lib/server/platform-domain-names.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/tenant/data/admin/src/lib/server/platform-domain-names.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 * Which hostnames a customer may claim, and which are the platform's own.\n *\n * ## Why this file exists (AGL-1430)\n *\n * Both domain surfaces — `consoleDomains` (white-label console, AGL-1353) and\n * `hosts.cname` (site custom domain, AGL-166/743) — attach customer names to a\n * Vercel project whose add-domain call **tolerates `domain_already_in_use`**.\n * That tolerance is only safe while the Firestore claim indexes *every* name\n * the platform holds on that project. A name that reaches Vercel without a\n * claim can be claimed by a second org, which reads the tolerated 409 as\n * health and has its visitors redirected to a stranger's site.\n *\n * `console-domains.ts` reasoned this through and built the blocklist. The site\n * path never got one, and it was the path with the live hole: AGL-1273 attaches\n * `{subdomain}.{TENANT_APEX}` to the tenant project as a 307 redirect on every\n * custom-domain connect, and nothing indexes that name as anybody's `cname`.\n * Org B could claim org A's `alice.aglyn.app`, watch `projectDomainStatus`\n * truthfully answer `serving` — the name really is on our project — and end up\n * with its own `{sub}.aglyn.app` 307ing to org A's site.\n *\n * So the lists live here, once, and both surfaces read them. A name added to\n * one blocklist is added to both, which is the property that was missing.\n *\n * ## The two ways a name is reserved\n *\n * **Suffix-reserved** (`RESERVED_DOMAIN_SUFFIXES`) — blocked as the name itself\n * *and as any subdomain of it*. Two families:\n *\n * - **Ours.** `aglyn.com`, `aglyn.io`, `aglyn.app`, `aglyn.dev`. Keying on the\n *   registrable domain covers every entry of `PRODUCTION_DOMAINS` in\n *   `security-origins.js` without duplicating that list, and keeps covering\n *   names added to it later. `console-domains.spec.ts` walks the real file and\n *   asserts exactly that.\n * - **Shared app-hosting suffixes.** Nobody controls the zone at\n *   `something.vercel.app` in the sense these features need — AGL-1353 measured\n *   `aglyn-console-aglyn.vercel.app` already serving a real console. Proving\n *   control of a name a platform hands out for free proves something that can\n *   be re-handed to someone else.\n *\n * **Bare-suffix-reserved** (`BARE_PUBLIC_SUFFIXES`) — blocked as a *whole name\n * only*. `acme.co.uk` is a perfectly good customer domain; `co.uk` is not a\n * domain at all. A short list rather than the Public Suffix List on purpose:\n * pulling in a PSL dependency to reject a name no registrar would sell is not a\n * trade worth making, and the single-label rule catches the commoner `com` case\n * for free.\n */\n\nimport { TENANT_APEX } from '@aglyn/aglyn/server'\nimport type { DomainCheck } from './sso-provisioning'\n\nconst LABEL = '[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?'\n\n/** Hostname shape: dash-free at label edges, a real TLD, at least two labels. */\nexport const PLATFORM_DOMAIN_PATTERN = new RegExp(\n  `^${LABEL}(?:\\\\.${LABEL})*\\\\.[a-z]{2,63}$`,\n)\n\n/** RFC 1035: a fully-qualified name is at most 253 octets. */\nexport const MAX_DOMAIN_LENGTH = 253\n\n/** Reserved as the name itself AND as any subdomain of it. See the header. */\nexport const RESERVED_DOMAIN_SUFFIXES: readonly string[] = [\n  'aglyn.com',\n  'aglyn.io',\n  'aglyn.app',\n  'aglyn.dev',\n  'vercel.app',\n  'vercel.sh',\n  'web.app',\n  'firebaseapp.com',\n  'appspot.com',\n  'cloudfunctions.net',\n  'run.app',\n  'pages.dev',\n  'workers.dev',\n  'netlify.app',\n  'github.io',\n  'herokuapp.com',\n  'azurewebsites.net',\n  'amplifyapp.com',\n  'onrender.com',\n  'fly.dev',\n  'ngrok.io',\n  'ngrok-free.app',\n  'trycloudflare.com',\n  // RFC 2606 / 6761 special-use names, plus the ones a misconfigured resolver\n  // answers for. None of these can be proved by a public TXT lookup.\n  'localhost',\n  'local',\n  'localdomain',\n  'internal',\n  'intranet',\n  'lan',\n  'home',\n  'corp',\n  'test',\n  'example',\n  'invalid',\n  'onion',\n]\n\n/** Reserved as a WHOLE name only — `acme.co.uk` stays claimable. */\nexport const BARE_PUBLIC_SUFFIXES: ReadonlySet<string> = new Set([\n  'co.uk',\n  'org.uk',\n  'me.uk',\n  'ac.uk',\n  'gov.uk',\n  'com.au',\n  'net.au',\n  'org.au',\n  'co.nz',\n  'co.za',\n  'co.jp',\n  'ne.jp',\n  'or.jp',\n  'com.br',\n  'com.mx',\n  'com.cn',\n  'com.tr',\n  'co.in',\n  'co.kr',\n  'com.sg',\n  'com.hk',\n])\n\n/**\n * Trim, lowercase, drop a trailing root dot, and tolerate a pasted URL.\n *\n * People paste `https://console.acme.com/` into a domain field constantly, and\n * refusing that is a support ticket rather than a security control — the value\n * is re-validated against the shape below either way.\n */\nexport function normalizePlatformDomain(input: string): string {\n  const raw = String(input ?? '')\n    .trim()\n    .toLowerCase()\n  if (!raw) return ''\n  return raw\n    .replace(/^[a-z][a-z0-9+.-]*:\\/\\//, '')\n    .replace(/^[^@]*@/, '')\n    .split(/[/?#]/)[0]\n    .replace(/\\.+$/, '')\n}\n\n/**\n * Whether a normalised name belongs to the platform rather than a customer.\n *\n * `TENANT_APEX` is consulted at call time rather than baked into the list\n * above, and that is the load-bearing half rather than a nicety. The static\n * entries name *our* production zones; the correspondence this file exists to\n * protect is a property of **whichever apex this deployment attaches\n * `{subdomain}.{apex}` redirects to**, which a self-host operator sets with\n * `NEXT_PUBLIC_TENANT_DOMAIN`. A blocklist that only knew `aglyn.app` would\n * leave every self-host install with the hole we are closing here.\n */\nexport function isPlatformReservedDomain(domain: string): boolean {\n  if (!domain) return true\n  if (BARE_PUBLIC_SUFFIXES.has(domain)) return true\n  const apex = String(TENANT_APEX ?? '')\n    .trim()\n    .toLowerCase()\n  const suffixes = apex\n    ? [...RESERVED_DOMAIN_SUFFIXES, apex]\n    : RESERVED_DOMAIN_SUFFIXES\n  return suffixes.some(\n    (suffix) => domain === suffix || domain.endsWith(`.${suffix}`),\n  )\n}\n\n/**\n * Shape, length and reserved-name check for a customer-supplied hostname.\n *\n * `{ domain, error }` with both keys always present rather than a discriminated\n * union, matching `validateSsoDomain` — `strictNullChecks` is off repo-wide and\n * an `{ ok: true } | { ok: false }` union does not narrow reliably once it\n * crosses a library boundary.\n *\n * `copy` is a parameter rather than a constant because the console and site\n * wizards are different products to the customer standing in front of them,\n * and these two strings are the ones a customer reads and acts on. The RULES\n * are shared; only the wording is not.\n */\nexport function validatePlatformDomain(\n  input: string,\n  copy: { invalid: string; reserved: string },\n): DomainCheck {\n  const domain = normalizePlatformDomain(input)\n  if (\n    !domain ||\n    domain.length > MAX_DOMAIN_LENGTH ||\n    !PLATFORM_DOMAIN_PATTERN.test(domain)\n  ) {\n    return { domain: null, error: copy.invalid }\n  }\n  if (domain.split('.').length < 2) {\n    return { domain: null, error: 'Enter a full domain name, not a single label' }\n  }\n  if (isPlatformReservedDomain(domain)) {\n    return { domain: null, error: copy.reserved }\n  }\n  return { domain, error: null }\n}\n"],"names":["TENANT_APEX","LABEL","PLATFORM_DOMAIN_PATTERN","RegExp","MAX_DOMAIN_LENGTH","RESERVED_DOMAIN_SUFFIXES","BARE_PUBLIC_SUFFIXES","Set","normalizePlatformDomain","input","raw","String","trim","toLowerCase","replace","split","isPlatformReservedDomain","domain","has","apex","suffixes","some","suffix","endsWith","validatePlatformDomain","copy","length","test","error","invalid","reserved"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CC,GAED,SAASA,WAAW,QAAQ,sBAAqB;AAGjD,MAAMC,QAAQ;AAEd,+EAA+E,GAC/E,OAAO,MAAMC,0BAA0B,IAAIC,OACzC,CAAC,CAAC,EAAEF,MAAM,MAAM,EAAEA,MAAM,iBAAiB,CAAC,EAC3C;AAED,4DAA4D,GAC5D,OAAO,MAAMG,oBAAoB,IAAG;AAEpC,4EAA4E,GAC5E,OAAO,MAAMC,2BAA8C;IACzD;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA,4EAA4E;IAC5E,mEAAmE;IACnE;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD,CAAA;AAED,kEAAkE,GAClE,OAAO,MAAMC,uBAA4C,IAAIC,IAAI;IAC/D;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD,EAAC;AAEF;;;;;;CAMC,GACD,OAAO,SAASC,wBAAwBC,KAAa;IACnD,MAAMC,MAAMC,OAAOF,gBAAAA,QAAS,IACzBG,IAAI,GACJC,WAAW;IACd,IAAI,CAACH,KAAK,OAAO;IACjB,OAAOA,IACJI,OAAO,CAAC,2BAA2B,IACnCA,OAAO,CAAC,WAAW,IACnBC,KAAK,CAAC,QAAQ,CAAC,EAAE,CACjBD,OAAO,CAAC,QAAQ;AACrB;AAEA;;;;;;;;;;CAUC,GACD,OAAO,SAASE,yBAAyBC,MAAc;IACrD,IAAI,CAACA,QAAQ,OAAO;IACpB,IAAIX,qBAAqBY,GAAG,CAACD,SAAS,OAAO;IAC7C,MAAME,OAAOR,OAAOX,sBAAAA,cAAe,IAChCY,IAAI,GACJC,WAAW;IACd,MAAMO,WAAWD,OACb;WAAId;QAA0Bc;KAAK,GACnCd;IACJ,OAAOe,SAASC,IAAI,CAClB,CAACC,SAAWL,WAAWK,UAAUL,OAAOM,QAAQ,CAAC,CAAC,CAAC,EAAED,QAAQ;AAEjE;AAEA;;;;;;;;;;;;CAYC,GACD,OAAO,SAASE,uBACdf,KAAa,EACbgB,IAA2C;IAE3C,MAAMR,SAAST,wBAAwBC;IACvC,IACE,CAACQ,UACDA,OAAOS,MAAM,GAAGtB,qBAChB,CAACF,wBAAwByB,IAAI,CAACV,SAC9B;QACA,OAAO;YAAEA,QAAQ;YAAMW,OAAOH,KAAKI,OAAO;QAAC;IAC7C;IACA,IAAIZ,OAAOF,KAAK,CAAC,KAAKW,MAAM,GAAG,GAAG;QAChC,OAAO;YAAET,QAAQ;YAAMW,OAAO;QAA+C;IAC/E;IACA,IAAIZ,yBAAyBC,SAAS;QACpC,OAAO;YAAEA,QAAQ;YAAMW,OAAOH,KAAKK,QAAQ;QAAC;IAC9C;IACA,OAAO;QAAEb;QAAQW,OAAO;IAAK;AAC/B"}

package/src/lib/server/platform-marketing-consent.d.ts

@@ -0,0 +1,133 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * The record a console door writes when a person decides about the
+ * platform's own product email (AGL-3185).
+ *
+ * ## Two documents, one decision
+ *
+ * The decision goes onto the person's own `users/{uid}` first — the console
+ * shows the preference from there, and it must not depend on the operator's
+ * CRM accepting a row — and then onto the operator's marketing contact for
+ * the same address through `upsertHostContact`, which is every other capture
+ * door's path and the only one the send-time consent join reads. The contact
+ * half carries the decision AND its provenance, so a campaign's audience
+ * count reports this basis as the person's own click and never as something
+ * asserted on their behalf.
+ *
+ * ## Server-side, because the client cannot and should not
+ *
+ * The sign-up page is a client of the person's own project; the operator's
+ * marketing org is somebody else's data. Only the Admin SDK writes there, and
+ * only after the person's ID token has been verified by the route in front
+ * of this module. The user-document half could be a client write — the rules
+ * make it owner-writable — but a mirror the client writes and the server
+ * reads back is two writers of one fact, so both halves are written here.
+ *
+ * ## Which host, and why it is a setting
+ *
+ * The marketing host is the deployment's, not the code's: this repository is
+ * what a self-hosted install runs, and an install with no product audience of
+ * its own has nowhere for a contact to go. `PLATFORM_MARKETING_HOST_ID` names
+ * it, and when it is unset the decision is recorded on the person's document
+ * alone. No hostname or document id is hardcoded here for the same reason
+ * `platform-marketing-host.ts` gives: nothing in the code knows which site
+ * is the operator's.
+ */
+import { type PlatformMarketingConsentDecision, type PlatformMarketingConsentSourceKind, type PlatformMarketingConsentState } from '@aglyn/aglyn/app-utils/platform-marketing-consent';
+import { upsertHostContact } from './upsert-contact';
+/**
+ * The variable naming the host whose contacts receive product-marketing
+ * consent — the operator's own marketing site. Unset on a self-hosted
+ * install, and honored as "record the preference, capture no contact".
+ */
+export declare const PLATFORM_MARKETING_HOST_ID_ENV = "PLATFORM_MARKETING_HOST_ID";
+/**
+ * The configured marketing host, or `null` when the deployment names none.
+ *
+ * Read at call time rather than at module load, so a test can set it and a
+ * process that started without it picks up a later value the same way every
+ * other runtime setting here does.
+ */
+export declare function platformMarketingHostId(): string | null;
+/** What became of the contact half of the record. */
+export type PlatformMarketingContactOutcome = {
+    status: 'recorded';
+    contactId: string;
+    created: boolean;
+}
+/** No marketing host is configured — a self-hosted install. */
+ | {
+    status: 'unconfigured';
+}
+/** The account carries no address a contact could be keyed on. */
+ | {
+    status: 'no-email';
+}
+/** The capture door refused the row — its band, an erasure, or an error. */
+ | {
+    status: 'refused';
+    reason: string;
+};
+export interface RecordPlatformMarketingConsentInput {
+    uid: string;
+    /** The account's address, from the verified token. */
+    email: string | null | undefined;
+    /** The name the token carries, for an account whose document holds none. */
+    name?: string | null;
+    decision: PlatformMarketingConsentDecision;
+    source: PlatformMarketingConsentSourceKind;
+    /** The wording version the door showed, stamped by the route. */
+    textVersion: string;
+    /** Injectable for tests; defaults to the clock. */
+    now?: number;
+    /** Injectable for tests; defaults to the admin app's Firestore. */
+    firestore?: any;
+    /** Injectable for tests; defaults to {@link platformMarketingHostId}. */
+    hostId?: string | null;
+    /** Injectable for tests; defaults to the real capture door. */
+    upsert?: typeof upsertHostContact;
+}
+export interface RecordPlatformMarketingConsentResult {
+    /** The timestamp both documents carry. */
+    atMs: number;
+    contact: PlatformMarketingContactOutcome;
+}
+/**
+ * Records a decision on both documents.
+ *
+ * Loud on bad input, like `recordLegalAcceptance`: a decision that cannot be
+ * attributed to an account, a door and a wording is not a record of anything.
+ * Quiet on the contact half — a refused row is returned, not thrown — because
+ * the person's own preference has already been recorded by then, and the
+ * operator's CRM band is not a reason to tell them their choice failed.
+ */
+export declare function recordPlatformMarketingConsent(input: RecordPlatformMarketingConsentInput): Promise<RecordPlatformMarketingConsentResult>;
+/**
+ * Stamps a prompt dismissal — no decision — so the console stays quiet for
+ * the snooze window and asks once more after it.
+ */
+export declare function snoozePlatformMarketingPrompt(uid: string, options?: {
+    now?: number;
+    firestore?: any;
+}): Promise<{
+    atMs: number;
+}>;
+/** The decision the person's own document holds, for the console to show. */
+export declare function readPlatformMarketingConsentForUser(uid: string, options?: {
+    firestore?: any;
+}): Promise<PlatformMarketingConsentState>;