@aglyn/plugins-email 1.0.0-beta.179 → 1.0.0-beta.180

package/src/lib/components/sending-domain-detail.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/email/src/lib/components/sending-domain-detail.tsx"],"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'use client'\n\nimport { PageHeaderRecord, pluginDocsHelp } from '@aglyn/aglyn'\nimport { mdiDeleteOutline, mdiEmailCheckOutline } from '@aglyn/shared-data-mdi'\nimport { CardDisplay, MdiIcon, useConfirmationContext } from '@aglyn/shared-ui-jsx'\nimport RowActionsMenu, {\n  type RowActionsMenuItem,\n} from '@aglyn/shared-ui-jsx/components/row-actions-menu.component'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport {\n  Alert,\n  Button,\n  Chip,\n  Divider,\n  Stack,\n  Typography,\n} from '@mui/material'\nimport { useRouter } from 'next/navigation'\nimport { useCallback, useEffect, useRef, useState } from 'react'\nimport {\n  describeSendingDomain,\n  describeSendingDomainRemoval,\n  INCONCLUSIVE_CHECK,\n} from '../model/sending-domain-status'\nimport {\n  useSendingApi,\n  type SendingDnsRecordView,\n  type SendingDomainView,\n  type SendingIdentityView,\n} from '@aglyn/tenant-feature-instance/hooks/use-sending-identity-api'\n\nexport interface SendingDomainDetailProps {\n  hostId: string\n  domain: string\n  basePath: string\n}\n\n/** The record block, in the shape a registrar's own form asks for. */\nfunction RecordRow(props: { record: SendingDnsRecordView; missing: boolean }) {\n  const { record, missing } = props\n  const target = record.priority\n    ? `${record.priority} ${record.value}`\n    : record.value\n  return (\n    <Stack spacing={0.5}>\n      <Stack direction=\"row\" spacing={1} sx={{ alignItems: 'center' }}>\n        <Chip size=\"small\" label={record.type} variant=\"outlined\" />\n        <Typography variant=\"body2\" sx={{ fontWeight: 'bold' }}>\n          {record.purpose === 'spf'\n            ? 'Authorization'\n            : record.purpose === 'dkim'\n              ? 'Signing key'\n              : record.purpose === 'return-path'\n                ? 'Bounce routing'\n                : 'DMARC policy'}\n        </Typography>\n        {record.required ? null : (\n          <Chip size=\"small\" label=\"Optional\" variant=\"outlined\" />\n        )}\n        {missing ? <Chip size=\"small\" label=\"Not seen yet\" color=\"warning\" /> : null}\n      </Stack>\n      <Typography\n        variant=\"body2\"\n        component=\"code\"\n        sx={{\n          p: 1,\n          bgcolor: 'action.hover',\n          borderRadius: 1,\n          fontFamily: 'monospace',\n          whiteSpace: 'pre-wrap',\n          overflowWrap: 'anywhere',\n        }}\n      >\n        {`${record.type}  ${record.name}  →  ${target || '(not issued yet)'}`}\n      </Typography>\n      <Typography variant=\"body2\" color=\"text.secondary\">\n        {record.note}\n      </Typography>\n    </Stack>\n  )\n}\nRecordRow.displayName = 'RecordRow'\n\n/**\n * ONE SENDING DOMAIN: what to publish, whether we can see it, and whether\n * this site sends as it.\n *\n * ## `inconclusive` is not a failure, and this page is where that is felt\n *\n * Pressing Check DNS has three outcomes, not two. The third is that nobody\n * answered — a resolver outage, a timeout — and the route says so with a\n * `503` rather than with `verified: false`. It is held HERE, in the surface's\n * own state, next to a status the record still holds, because the record was\n * not changed and saying otherwise would send a customer whose DNS is perfect\n * to go and edit a zone that has nothing wrong with it.\n *\n * That is why `lastCheck` is a separate piece of state from `record.status`\n * and never assigned into it.\n */\nexport function SendingDomainDetail(props: SendingDomainDetailProps) {\n  const { hostId, domain, basePath } = props\n  const call = useSendingApi()\n  const router = useRouter()\n  const { enqueueSnackbar } = useSnackbar()\n  /*\n   * The snackbar held in a REF, for the reason `use-campaign-send-api` holds\n   * the user in one: `load` is a dependency of the effect that runs it, so\n   * anything whose identity changes per render re-runs the fetch — and a\n   * hook returning a fresh object each render turns that into a loop that\n   * never settles. Reading it through a ref makes the effect depend on the\n   * things that actually identify the request.\n   */\n  const notifyRef = useRef(enqueueSnackbar)\n  notifyRef.current = enqueueSnackbar\n  const { confirm } = useConfirmationContext()\n\n  const [identity, setIdentity] = useState<SendingIdentityView | null>(null)\n  const [record, setRecord] = useState<SendingDomainView | null>(null)\n  const [loading, setLoading] = useState(true)\n  const [busy, setBusy] = useState(false)\n  /**\n   * The outcome of the last check the reader ran, and ONLY when it was\n   * inconclusive. Never merged into the record: an unanswered lookup is\n   * evidence of nothing, and the record's own status is still the last thing\n   * we actually established.\n   */\n  const [unreachable, setUnreachable] = useState(false)\n\n  const load = useCallback(async () => {\n    setLoading(true)\n    const view = await call({\n      path: 'sending-identity',\n      method: 'GET',\n      query: { hostId },\n    })\n    if (!view.response.ok) {\n      setLoading(false)\n      return void notifyRef.current(\n        view.payload?.error ?? 'Could not read the sending identity',\n        { variant: 'warning' },\n      )\n    }\n    setIdentity(view.payload as SendingIdentityView)\n    const orgId = String(view.payload?.orgId ?? '')\n    const domains = orgId\n      ? await call({\n          path: 'sending-domains',\n          method: 'GET',\n          query: { orgId },\n        })\n      : null\n    setLoading(false)\n    const found = (domains?.payload?.domains ?? []).find(\n      (one: SendingDomainView) => one.domain === domain,\n    )\n    setRecord(found ?? null)\n  }, [call, hostId, domain])\n\n  useEffect(() => {\n    void load()\n  }, [load])\n\n  const handleVerify = useCallback(async () => {\n    if (busy || !identity?.orgId) return\n    setBusy(true)\n    setUnreachable(false)\n    const { response, payload } = await call({\n      path: 'sending-domains',\n      method: 'POST',\n      body: { orgId: identity.orgId, domain, action: 'verify' },\n    })\n    setBusy(false)\n    /*\n     * THE THIRD OUTCOME.\n     *\n     * A `503` here means the lookup got no answer. Nothing about the domain\n     * changed, so nothing on screen changes either except a notice saying the\n     * question could not be asked. Treating it as a failed check — which is\n     * what a plain `!response.ok` branch would do — is how a customer ends up\n     * rewriting records that were already correct.\n     */\n    if (response.status === 503) {\n      setUnreachable(true)\n      return\n    }\n    if (!response.ok) {\n      return void notifyRef.current(payload?.error ?? 'The check could not run', {\n        variant: 'warning',\n      })\n    }\n    await load()\n    notifyRef.current(\n      payload?.verified\n        ? 'Verified — this domain can send'\n        : 'Checked. Some records are still missing.',\n      { variant: payload?.verified ? 'success' : 'info' },\n    )\n  }, [busy, call, identity?.orgId, domain, load])\n\n  const handleRequestRecords = useCallback(async () => {\n    if (busy || !identity?.orgId) return\n    setBusy(true)\n    const { response, payload } = await call({\n      path: 'sending-domains',\n      method: 'POST',\n      body: { orgId: identity.orgId, domain, action: 'request' },\n    })\n    setBusy(false)\n    if (!response.ok) {\n      return void notifyRef.current(payload?.error ?? 'Could not request records', {\n        variant: 'warning',\n      })\n    }\n    await load()\n  }, [busy, call, identity?.orgId, domain, load])\n\n  const handleUse = useCallback(\n    async (next: string) => {\n      if (busy) return\n      setBusy(true)\n      const { response, payload } = await call({\n        path: 'sending-identity',\n        method: 'POST',\n        body: { hostId, domain: next },\n      })\n      setBusy(false)\n      if (!response.ok) {\n        return void notifyRef.current(payload?.error ?? 'Could not change the identity', {\n          variant: 'warning',\n        })\n      }\n      await load()\n      /*\n       * The address the ROUTE settled on, not the one this click asked for.\n       *\n       * Clearing the selection does not name a domain — it hands the site back\n       * to the one provisioned for it — so only the response knows what the\n       * `From:` line now says. A message composed from `next` would announce\n       * an address chosen here rather than the one recipients will see.\n       */\n      notifyRef.current(\n        payload?.from\n          ? `This site now sends as ${payload.from}`\n          : 'This site’s sending address was changed',\n        { variant: 'success' },\n      )\n    },\n    [busy, call, hostId, load],\n  )\n\n  const handleRelease = useCallback(async () => {\n    if (!identity?.orgId) return\n    /*\n     * The consequence stated rather than implied, and it is not one\n     * consequence — see `describeSendingDomainRemoval`, which holds all three.\n     *\n     * Taken from the model rather than written here because the LIST asks to\n     * remove the same record from its row menu. Two confirmations describing\n     * one action differently is how a merchant learns to dismiss the harsher\n     * of them.\n     */\n    const ok = await confirm({\n      ...describeSendingDomainRemoval({\n        domain,\n        selected: identity.selected,\n        platformDomain: identity.platformDomain,\n      }),\n      confirmationButtonProps: { color: 'error' },\n    })\n      // `confirm` resolves with no value and REJECTS on cancel, so the\n      // resolved value alone can never gate this.\n      .then(() => true)\n      .catch(() => false)\n    if (!ok) return\n    const { response, payload } = await call({\n      path: 'sending-domains',\n      method: 'DELETE',\n      query: { orgId: identity.orgId, domain },\n    })\n    if (!response.ok) {\n      return void notifyRef.current(payload?.error ?? 'Could not remove the domain', {\n        variant: 'warning',\n      })\n    }\n    router.push(`${basePath}/sending`)\n  }, [confirm, call, identity, domain, router, basePath])\n\n  const state = describeSendingDomain({\n    status: record?.status ?? 'requested',\n    pendingProvider: record?.pendingProvider ?? record?.status === 'requested',\n    issueError: record?.lastIssueError ?? null,\n    missing: record?.lastMissing ?? null,\n  })\n  const missing = new Set(record?.lastMissing ?? [])\n  const canManage = identity?.canManage === true\n  const isSelected = identity?.selected === domain\n\n  const actions: RowActionsMenuItem[] = canManage\n    ? [\n        {\n          key: 'release',\n          label: 'Remove domain',\n          icon: <MdiIcon path={mdiDeleteOutline.path} size={0.8} />,\n          destructive: true,\n          onClick: () => void handleRelease(),\n        },\n      ]\n    : []\n\n  /* The card, named so the page chrome above it is a plain list of\n     what this surface publishes upward. */\n  const card = (\n    <CardDisplay\n      header={'Sending domain'}\n      help={pluginDocsHelp('emailCampaigns', {\n        anchor: '#sending-domains',\n      })}\n      contentGutterX\n      contentGutterY\n      contentBordered=\"all\"\n      HeaderProps={{\n        action: actions.length ? <RowActionsMenu items={actions} /> : null,\n      }}\n    >\n      {loading ? (\n        <Typography variant=\"body2\" color=\"text.secondary\">\n          {'Loading…'}\n        </Typography>\n      ) : !record ? (\n        <Alert severity=\"warning\">\n          {`${domain} is not claimed by this workspace. It may have been ` +\n            `removed — go back and add it again if you still want it.`}\n        </Alert>\n      ) : (\n        <Stack spacing={2}>\n          <Stack direction=\"row\" spacing={1} sx={{ alignItems: 'center' }}>\n            <Chip\n              label={state.label}\n              color={state.color}\n              variant={state.sending ? 'filled' : 'outlined'}\n            />\n            {isSelected ? (\n              <Chip label=\"This site sends as this\" color=\"primary\" size=\"small\" />\n            ) : null}\n          </Stack>\n\n          <Alert severity={state.severity}>{state.text}</Alert>\n\n          {/*\n            The unanswered check, BESIDE the state above and never instead of\n            it. Both are true at once: the record still says what it said, and\n            the last thing we tried could not be completed.\n           */}\n          {unreachable ? (\n            <Alert severity={INCONCLUSIVE_CHECK.severity} icon={false}>\n              <Typography variant=\"body2\" sx={{ fontWeight: 'bold' }}>\n                {INCONCLUSIVE_CHECK.label}\n              </Typography>\n              <Typography variant=\"body2\">{INCONCLUSIVE_CHECK.text}</Typography>\n            </Alert>\n          ) : null}\n\n          {/*\n            The customer's DMARC policy, read and never written. It decides\n            whether unauthenticated mail from this domain is filed as spam or\n            refused outright, which is something a person publishing these\n            records should know before they finish rather than after.\n           */}\n          {record.dmarc ? (\n            <Alert\n              severity={\n                record.dmarc.policy === 'reject' && record.status !== 'verified'\n                  ? 'error'\n                  : 'info'\n              }\n            >\n              {record.dmarc.consequence}\n            </Alert>\n          ) : null}\n\n          {record.records?.length &&\n          record.records.some((entry) => entry.value) ? (\n            <>\n              <Divider />\n              <Typography variant=\"body2\" sx={{ fontWeight: 'bold' }}>\n                {'Publish these records'}\n              </Typography>\n              <Stack spacing={2}>\n                {record.records\n                  .filter((entry) => entry.value)\n                  .map((entry) => (\n                    <RecordRow\n                      key={`${entry.type}:${entry.name}`}\n                      record={entry}\n                      missing={missing.has(`${entry.type}:${entry.name}`)}\n                    />\n                  ))}\n                {record.dmarcSuggestion &&\n                record.dmarc?.policy === 'absent' ? (\n                  <RecordRow record={record.dmarcSuggestion} missing={false} />\n                ) : null}\n              </Stack>\n            </>\n          ) : null}\n\n          <Divider />\n          <Stack direction=\"row\" spacing={1} sx={{ flexWrap: 'wrap', gap: 1 }}>\n            {record.status === 'requested' && canManage ? (\n              <Button\n                variant=\"contained\"\n                disabled={busy}\n                onClick={() => void handleRequestRecords()}\n              >\n                {busy ? 'Working…' : 'Request records'}\n              </Button>\n            ) : null}\n            {record.status !== 'requested' ? (\n              <Button\n                variant=\"contained\"\n                disabled={busy}\n                onClick={() => void handleVerify()}\n              >\n                {busy ? 'Checking…' : 'Check DNS'}\n              </Button>\n            ) : null}\n            {canManage && record.status === 'verified' && !isSelected ? (\n              <Button\n                variant=\"outlined\"\n                startIcon={<MdiIcon path={mdiEmailCheckOutline.path} size={0.8} />}\n                disabled={busy}\n                onClick={() => void handleUse(domain)}\n              >\n                {'Send this site’s email as this domain'}\n              </Button>\n            ) : null}\n            {canManage && isSelected ? (\n              /*\n               * Clearing the selection returns the site to the domain\n               * PROVISIONED for it — `{label}.mail.aglyn.app` — not to the\n               * shared pool, and the label says so. A site whose plan carries\n               * no such domain is refused here with the reason, which is why\n               * the control is worded as leaving this domain rather than\n               * promising a destination it may not reach.\n               */\n              <Button\n                variant=\"outlined\"\n                disabled={busy}\n                onClick={() => void handleUse('platform')}\n              >\n                {'Stop sending this site’s email as this domain'}\n              </Button>\n            ) : null}\n          </Stack>\n        </Stack>\n      )}\n    </CardDisplay>\n  )\n\n  return (\n    <>\n      {/* The page heading and the trail name the domain; this card is\n          then free to say what it holds rather than repeating the title. */}\n      <PageHeaderRecord title={domain} />\n      {card}\n    </>\n  )\n}\nSendingDomainDetail.displayName = 'SendingDomainDetail'\n\nexport default SendingDomainDetail\n"],"names":["PageHeaderRecord","pluginDocsHelp","mdiDeleteOutline","mdiEmailCheckOutline","CardDisplay","MdiIcon","useConfirmationContext","RowActionsMenu","useSnackbar","Alert","Button","Chip","Divider","Stack","Typography","useRouter","useCallback","useEffect","useRef","useState","describeSendingDomain","describeSendingDomainRemoval","INCONCLUSIVE_CHECK","useSendingApi","RecordRow","props","record","missing","target","priority","value","spacing","direction","sx","alignItems","size","label","type","variant","fontWeight","purpose","required","color","component","p","bgcolor","borderRadius","fontFamily","whiteSpace","overflowWrap","name","note","displayName","SendingDomainDetail","hostId","domain","basePath","call","router","enqueueSnackbar","notifyRef","current","confirm","identity","setIdentity","setRecord","loading","setLoading","busy","setBusy","unreachable","setUnreachable","load","view","domains","path","method","query","response","ok","payload","error","orgId","String","found","find","one","handleVerify","body","action","status","verified","handleRequestRecords","handleUse","next","from","handleRelease","selected","platformDomain","confirmationButtonProps","then","catch","push","state","pendingProvider","issueError","lastIssueError","lastMissing","Set","canManage","isSelected","actions","key","icon","destructive","onClick","card","header","help","anchor","contentGutterX","contentGutterY","contentBordered","HeaderProps","length","items","severity","sending","text","dmarc","policy","consequence","records","some","entry","filter","map","has","dmarcSuggestion","flexWrap","gap","disabled","startIcon","title"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/email/src/lib/components/sending-domain-detail.tsx"],"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'use client'\n\nimport { PageHeaderRecord, pluginDocsHelp } from '@aglyn/aglyn'\nimport { mdiDeleteOutline, mdiEmailCheckOutline } from '@aglyn/shared-data-mdi'\nimport { CardDisplay, MdiIcon, useConfirmationContext } from '@aglyn/shared-ui-jsx'\nimport RowActionsMenu, {\n  type RowActionsMenuItem,\n} from '@aglyn/shared-ui-jsx/components/row-actions-menu.component'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport {\n  Alert,\n  Button,\n  Chip,\n  Divider,\n  Stack,\n  Typography,\n} from '@mui/material'\nimport { useRouter } from 'next/navigation'\nimport { useCallback, useEffect, useRef, useState } from 'react'\nimport {\n  describeSendingDomain,\n  describeSendingDomainRemoval,\n  INCONCLUSIVE_CHECK,\n} from '../model/sending-domain-status'\nimport {\n  useSendingApi,\n  type SendingDnsRecordView,\n  type SendingDomainView,\n  type SendingIdentityView,\n} from '@aglyn/tenant-feature-instance/hooks/use-sending-identity-api'\n\nexport interface SendingDomainDetailProps {\n  hostId: string\n  domain: string\n  basePath: string\n}\n\n/**\n * The record block, in the shape a registrar's own form asks for. Shared with\n * the organization's page for a domain, which prints the same records.\n */\nexport function RecordRow(props: {\n  record: SendingDnsRecordView\n  missing: boolean\n}) {\n  const { record, missing } = props\n  const target = record.priority\n    ? `${record.priority} ${record.value}`\n    : record.value\n  return (\n    <Stack spacing={0.5}>\n      <Stack direction=\"row\" spacing={1} sx={{ alignItems: 'center' }}>\n        <Chip size=\"small\" label={record.type} variant=\"outlined\" />\n        <Typography variant=\"body2\" sx={{ fontWeight: 'bold' }}>\n          {record.purpose === 'spf'\n            ? 'Authorization'\n            : record.purpose === 'dkim'\n              ? 'Signing key'\n              : record.purpose === 'return-path'\n                ? 'Bounce routing'\n                : 'DMARC policy'}\n        </Typography>\n        {record.required ? null : (\n          <Chip size=\"small\" label=\"Optional\" variant=\"outlined\" />\n        )}\n        {missing ? <Chip size=\"small\" label=\"Not seen yet\" color=\"warning\" /> : null}\n      </Stack>\n      <Typography\n        variant=\"body2\"\n        component=\"code\"\n        sx={{\n          p: 1,\n          bgcolor: 'action.hover',\n          borderRadius: 1,\n          fontFamily: 'monospace',\n          whiteSpace: 'pre-wrap',\n          overflowWrap: 'anywhere',\n        }}\n      >\n        {`${record.type}  ${record.name}  →  ${target || '(not issued yet)'}`}\n      </Typography>\n      <Typography variant=\"body2\" color=\"text.secondary\">\n        {record.note}\n      </Typography>\n    </Stack>\n  )\n}\nRecordRow.displayName = 'RecordRow'\n\n/**\n * ONE SENDING DOMAIN: what to publish, whether we can see it, and whether\n * this site sends as it.\n *\n * ## `inconclusive` is not a failure, and this page is where that is felt\n *\n * Pressing Check DNS has three outcomes, not two. The third is that nobody\n * answered — a resolver outage, a timeout — and the route says so with a\n * `503` rather than with `verified: false`. It is held HERE, in the surface's\n * own state, next to a status the record still holds, because the record was\n * not changed and saying otherwise would send a customer whose DNS is perfect\n * to go and edit a zone that has nothing wrong with it.\n *\n * That is why `lastCheck` is a separate piece of state from `record.status`\n * and never assigned into it.\n */\nexport function SendingDomainDetail(props: SendingDomainDetailProps) {\n  const { hostId, domain, basePath } = props\n  const call = useSendingApi()\n  const router = useRouter()\n  const { enqueueSnackbar } = useSnackbar()\n  /*\n   * The snackbar held in a REF, for the reason `use-campaign-send-api` holds\n   * the user in one: `load` is a dependency of the effect that runs it, so\n   * anything whose identity changes per render re-runs the fetch — and a\n   * hook returning a fresh object each render turns that into a loop that\n   * never settles. Reading it through a ref makes the effect depend on the\n   * things that actually identify the request.\n   */\n  const notifyRef = useRef(enqueueSnackbar)\n  notifyRef.current = enqueueSnackbar\n  const { confirm } = useConfirmationContext()\n\n  const [identity, setIdentity] = useState<SendingIdentityView | null>(null)\n  const [record, setRecord] = useState<SendingDomainView | null>(null)\n  const [loading, setLoading] = useState(true)\n  const [busy, setBusy] = useState(false)\n  /**\n   * The outcome of the last check the reader ran, and ONLY when it was\n   * inconclusive. Never merged into the record: an unanswered lookup is\n   * evidence of nothing, and the record's own status is still the last thing\n   * we actually established.\n   */\n  const [unreachable, setUnreachable] = useState(false)\n\n  const load = useCallback(async () => {\n    setLoading(true)\n    const view = await call({\n      path: 'sending-identity',\n      method: 'GET',\n      query: { hostId },\n    })\n    if (!view.response.ok) {\n      setLoading(false)\n      return void notifyRef.current(\n        view.payload?.error ?? 'Could not read the sending identity',\n        { variant: 'warning' },\n      )\n    }\n    setIdentity(view.payload as SendingIdentityView)\n    const orgId = String(view.payload?.orgId ?? '')\n    const domains = orgId\n      ? await call({\n          path: 'sending-domains',\n          method: 'GET',\n          query: { orgId },\n        })\n      : null\n    setLoading(false)\n    const found = (domains?.payload?.domains ?? []).find(\n      (one: SendingDomainView) => one.domain === domain,\n    )\n    setRecord(found ?? null)\n  }, [call, hostId, domain])\n\n  useEffect(() => {\n    void load()\n  }, [load])\n\n  const handleVerify = useCallback(async () => {\n    if (busy || !identity?.orgId) return\n    setBusy(true)\n    setUnreachable(false)\n    const { response, payload } = await call({\n      path: 'sending-domains',\n      method: 'POST',\n      body: { orgId: identity.orgId, domain, action: 'verify' },\n    })\n    setBusy(false)\n    /*\n     * THE THIRD OUTCOME.\n     *\n     * A `503` here means the lookup got no answer. Nothing about the domain\n     * changed, so nothing on screen changes either except a notice saying the\n     * question could not be asked. Treating it as a failed check — which is\n     * what a plain `!response.ok` branch would do — is how a customer ends up\n     * rewriting records that were already correct.\n     */\n    if (response.status === 503) {\n      setUnreachable(true)\n      return\n    }\n    if (!response.ok) {\n      return void notifyRef.current(payload?.error ?? 'The check could not run', {\n        variant: 'warning',\n      })\n    }\n    await load()\n    notifyRef.current(\n      payload?.verified\n        ? 'Verified — this domain can send'\n        : 'Checked. Some records are still missing.',\n      { variant: payload?.verified ? 'success' : 'info' },\n    )\n  }, [busy, call, identity?.orgId, domain, load])\n\n  const handleRequestRecords = useCallback(async () => {\n    if (busy || !identity?.orgId) return\n    setBusy(true)\n    const { response, payload } = await call({\n      path: 'sending-domains',\n      method: 'POST',\n      body: { orgId: identity.orgId, domain, action: 'request' },\n    })\n    setBusy(false)\n    if (!response.ok) {\n      return void notifyRef.current(payload?.error ?? 'Could not request records', {\n        variant: 'warning',\n      })\n    }\n    await load()\n  }, [busy, call, identity?.orgId, domain, load])\n\n  const handleUse = useCallback(\n    async (next: string) => {\n      if (busy) return\n      setBusy(true)\n      const { response, payload } = await call({\n        path: 'sending-identity',\n        method: 'POST',\n        body: { hostId, domain: next },\n      })\n      setBusy(false)\n      if (!response.ok) {\n        return void notifyRef.current(payload?.error ?? 'Could not change the identity', {\n          variant: 'warning',\n        })\n      }\n      await load()\n      /*\n       * The address the ROUTE settled on, not the one this click asked for.\n       *\n       * Clearing the selection does not name a domain — it hands the site back\n       * to the one provisioned for it — so only the response knows what the\n       * `From:` line now says. A message composed from `next` would announce\n       * an address chosen here rather than the one recipients will see.\n       */\n      notifyRef.current(\n        payload?.from\n          ? `This site now sends as ${payload.from}`\n          : 'This site’s sending address was changed',\n        { variant: 'success' },\n      )\n    },\n    [busy, call, hostId, load],\n  )\n\n  const handleRelease = useCallback(async () => {\n    if (!identity?.orgId) return\n    /*\n     * The consequence stated rather than implied, and it is not one\n     * consequence — see `describeSendingDomainRemoval`, which holds all three.\n     *\n     * Taken from the model rather than written here because the LIST asks to\n     * remove the same record from its row menu. Two confirmations describing\n     * one action differently is how a merchant learns to dismiss the harsher\n     * of them.\n     */\n    const ok = await confirm({\n      ...describeSendingDomainRemoval({\n        domain,\n        selected: identity.selected,\n        platformDomain: identity.platformDomain,\n      }),\n      confirmationButtonProps: { color: 'error' },\n    })\n      // `confirm` resolves with no value and REJECTS on cancel, so the\n      // resolved value alone can never gate this.\n      .then(() => true)\n      .catch(() => false)\n    if (!ok) return\n    const { response, payload } = await call({\n      path: 'sending-domains',\n      method: 'DELETE',\n      query: { orgId: identity.orgId, domain },\n    })\n    if (!response.ok) {\n      return void notifyRef.current(payload?.error ?? 'Could not remove the domain', {\n        variant: 'warning',\n      })\n    }\n    router.push(`${basePath}/sending`)\n  }, [confirm, call, identity, domain, router, basePath])\n\n  const state = describeSendingDomain({\n    status: record?.status ?? 'requested',\n    pendingProvider: record?.pendingProvider ?? record?.status === 'requested',\n    issueError: record?.lastIssueError ?? null,\n    missing: record?.lastMissing ?? null,\n  })\n  const missing = new Set(record?.lastMissing ?? [])\n  const canManage = identity?.canManage === true\n  const isSelected = identity?.selected === domain\n\n  const actions: RowActionsMenuItem[] = canManage\n    ? [\n        {\n          key: 'release',\n          label: 'Remove domain',\n          icon: <MdiIcon path={mdiDeleteOutline.path} size={0.8} />,\n          destructive: true,\n          onClick: () => void handleRelease(),\n        },\n      ]\n    : []\n\n  /* The card, named so the page chrome above it is a plain list of\n     what this surface publishes upward. */\n  const card = (\n    <CardDisplay\n      header={'Sending domain'}\n      help={pluginDocsHelp('emailCampaigns', {\n        anchor: '#sending-domains',\n      })}\n      contentGutterX\n      contentGutterY\n      contentBordered=\"all\"\n      HeaderProps={{\n        action: actions.length ? <RowActionsMenu items={actions} /> : null,\n      }}\n    >\n      {loading ? (\n        <Typography variant=\"body2\" color=\"text.secondary\">\n          {'Loading…'}\n        </Typography>\n      ) : !record ? (\n        <Alert severity=\"warning\">\n          {`${domain} is not claimed by this workspace. It may have been ` +\n            `removed — go back and add it again if you still want it.`}\n        </Alert>\n      ) : (\n        <Stack spacing={2}>\n          <Stack direction=\"row\" spacing={1} sx={{ alignItems: 'center' }}>\n            <Chip\n              label={state.label}\n              color={state.color}\n              variant={state.sending ? 'filled' : 'outlined'}\n            />\n            {isSelected ? (\n              <Chip label=\"This site sends as this\" color=\"primary\" size=\"small\" />\n            ) : null}\n          </Stack>\n\n          <Alert severity={state.severity}>{state.text}</Alert>\n\n          {/*\n            The unanswered check, BESIDE the state above and never instead of\n            it. Both are true at once: the record still says what it said, and\n            the last thing we tried could not be completed.\n           */}\n          {unreachable ? (\n            <Alert severity={INCONCLUSIVE_CHECK.severity} icon={false}>\n              <Typography variant=\"body2\" sx={{ fontWeight: 'bold' }}>\n                {INCONCLUSIVE_CHECK.label}\n              </Typography>\n              <Typography variant=\"body2\">{INCONCLUSIVE_CHECK.text}</Typography>\n            </Alert>\n          ) : null}\n\n          {/*\n            The customer's DMARC policy, read and never written. It decides\n            whether unauthenticated mail from this domain is filed as spam or\n            refused outright, which is something a person publishing these\n            records should know before they finish rather than after.\n           */}\n          {record.dmarc ? (\n            <Alert\n              severity={\n                record.dmarc.policy === 'reject' && record.status !== 'verified'\n                  ? 'error'\n                  : 'info'\n              }\n            >\n              {record.dmarc.consequence}\n            </Alert>\n          ) : null}\n\n          {record.records?.length &&\n          record.records.some((entry) => entry.value) ? (\n            <>\n              <Divider />\n              <Typography variant=\"body2\" sx={{ fontWeight: 'bold' }}>\n                {'Publish these records'}\n              </Typography>\n              <Stack spacing={2}>\n                {record.records\n                  .filter((entry) => entry.value)\n                  .map((entry) => (\n                    <RecordRow\n                      key={`${entry.type}:${entry.name}`}\n                      record={entry}\n                      missing={missing.has(`${entry.type}:${entry.name}`)}\n                    />\n                  ))}\n                {record.dmarcSuggestion &&\n                record.dmarc?.policy === 'absent' ? (\n                  <RecordRow record={record.dmarcSuggestion} missing={false} />\n                ) : null}\n              </Stack>\n            </>\n          ) : null}\n\n          <Divider />\n          <Stack direction=\"row\" spacing={1} sx={{ flexWrap: 'wrap', gap: 1 }}>\n            {record.status === 'requested' && canManage ? (\n              <Button\n                variant=\"contained\"\n                disabled={busy}\n                onClick={() => void handleRequestRecords()}\n              >\n                {busy ? 'Working…' : 'Request records'}\n              </Button>\n            ) : null}\n            {record.status !== 'requested' ? (\n              <Button\n                variant=\"contained\"\n                disabled={busy}\n                onClick={() => void handleVerify()}\n              >\n                {busy ? 'Checking…' : 'Check DNS'}\n              </Button>\n            ) : null}\n            {canManage && record.status === 'verified' && !isSelected ? (\n              <Button\n                variant=\"outlined\"\n                startIcon={<MdiIcon path={mdiEmailCheckOutline.path} size={0.8} />}\n                disabled={busy}\n                onClick={() => void handleUse(domain)}\n              >\n                {'Send this site’s email as this domain'}\n              </Button>\n            ) : null}\n            {canManage && isSelected ? (\n              /*\n               * Clearing the selection returns the site to the domain\n               * PROVISIONED for it — `{label}.mail.aglyn.app` — not to the\n               * shared pool, and the label says so. A site whose plan carries\n               * no such domain is refused here with the reason, which is why\n               * the control is worded as leaving this domain rather than\n               * promising a destination it may not reach.\n               */\n              <Button\n                variant=\"outlined\"\n                disabled={busy}\n                onClick={() => void handleUse('platform')}\n              >\n                {'Stop sending this site’s email as this domain'}\n              </Button>\n            ) : null}\n          </Stack>\n        </Stack>\n      )}\n    </CardDisplay>\n  )\n\n  return (\n    <>\n      {/* The page heading and the trail name the domain; this card is\n          then free to say what it holds rather than repeating the title. */}\n      <PageHeaderRecord title={domain} />\n      {card}\n    </>\n  )\n}\nSendingDomainDetail.displayName = 'SendingDomainDetail'\n\nexport default SendingDomainDetail\n"],"names":["PageHeaderRecord","pluginDocsHelp","mdiDeleteOutline","mdiEmailCheckOutline","CardDisplay","MdiIcon","useConfirmationContext","RowActionsMenu","useSnackbar","Alert","Button","Chip","Divider","Stack","Typography","useRouter","useCallback","useEffect","useRef","useState","describeSendingDomain","describeSendingDomainRemoval","INCONCLUSIVE_CHECK","useSendingApi","RecordRow","props","record","missing","target","priority","value","spacing","direction","sx","alignItems","size","label","type","variant","fontWeight","purpose","required","color","component","p","bgcolor","borderRadius","fontFamily","whiteSpace","overflowWrap","name","note","displayName","SendingDomainDetail","hostId","domain","basePath","call","router","enqueueSnackbar","notifyRef","current","confirm","identity","setIdentity","setRecord","loading","setLoading","busy","setBusy","unreachable","setUnreachable","load","view","domains","path","method","query","response","ok","payload","error","orgId","String","found","find","one","handleVerify","body","action","status","verified","handleRequestRecords","handleUse","next","from","handleRelease","selected","platformDomain","confirmationButtonProps","then","catch","push","state","pendingProvider","issueError","lastIssueError","lastMissing","Set","canManage","isSelected","actions","key","icon","destructive","onClick","card","header","help","anchor","contentGutterX","contentGutterY","contentBordered","HeaderProps","length","items","severity","sending","text","dmarc","policy","consequence","records","some","entry","filter","map","has","dmarcSuggestion","flexWrap","gap","disabled","startIcon","title"],"mappings":"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"}

package/src/lib/components/suppression-totals.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @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 Firestore } from 'firebase/firestore';
+/**
+ * What a reason means to a merchant, and how much it should worry them.
+ *
+ * An ABSENT reason reads as "Unsubscribed", and that is a compatibility rule
+ * rather than a guess: until AGL-2408 the unsubscribe handler wrote
+ * `{ email, createdAt }` and nothing else, while the Resend webhook has
+ * stamped `'bounce'`/`'complaint'` since AGL-1918 — so an entry with no reason
+ * can only have come from somebody clicking the link. New unsubscribes write
+ * the reason explicitly, so this fallback covers history and nothing else.
+ */
+export declare const SUPPRESSION_REASONS: Record<string, {
+    label: string;
+    color: 'default' | 'warning' | 'error';
+}>;
+/** One stored reason, as {@link SUPPRESSION_REASONS} describes it. */
+export declare const describeSuppressionReason: (reason: unknown) => {
+    label: string;
+    color: "default" | "warning" | "error";
+};
+/** One site's suppression list, broken down by why each address is on it. */
+export interface SuppressionTotals {
+    unsubscribe: number;
+    bounce: number;
+    complaint: number;
+    manual: number;
+}
+/**
+ * THE BREAKDOWN OF ONE SITE'S SUPPRESSION LIST, as server aggregates.
+ *
+ * One reader for both the site's own suppression card and the organization's
+ * summary of every site's, so the two can never count differently.
+ *
+ * Four reads, not one per reason. `where('reason','==','unsubscribe')` cannot
+ * be asked, because an entry written before AGL-2408 carries no `reason` at
+ * all and an equality filter excludes it — the field-presence trap the list's
+ * ordering also avoids. Unsubscribes are therefore the REMAINDER: the total
+ * minus every reason that is always written explicitly, which is exactly the
+ * compatibility rule the card's `describeReason` applies row by row. A reason
+ * counted explicitly and left out of the subtraction would be reported as
+ * somebody who clicked unsubscribe.
+ *
+ * Rejects when any read fails; a caller holds its figure at "unknown" rather
+ * than zeroing it, because "Bounced: 0" is a confident wrong number in the
+ * reassuring direction.
+ */
+export declare function readSuppressionTotals(firestore: Firestore, hostId: string): Promise<SuppressionTotals>;

package/src/lib/components/suppression-totals.js

@@ -0,0 +1,105 @@
+/**
+ * @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 { collection, count, getAggregateFromServer, query, where } from "firebase/firestore";
+/**
+ * What a reason means to a merchant, and how much it should worry them.
+ *
+ * An ABSENT reason reads as "Unsubscribed", and that is a compatibility rule
+ * rather than a guess: until AGL-2408 the unsubscribe handler wrote
+ * `{ email, createdAt }` and nothing else, while the Resend webhook has
+ * stamped `'bounce'`/`'complaint'` since AGL-1918 — so an entry with no reason
+ * can only have come from somebody clicking the link. New unsubscribes write
+ * the reason explicitly, so this fallback covers history and nothing else.
+ */ export const SUPPRESSION_REASONS = {
+    unsubscribe: {
+        label: 'Unsubscribed',
+        color: 'default'
+    },
+    bounce: {
+        label: 'Bounced',
+        color: 'warning'
+    },
+    complaint: {
+        label: 'Marked as spam',
+        color: 'error'
+    },
+    /*
+   * Recorded by a person, through the Add control.
+   *
+   * Its OWN value rather than a reuse of `unsubscribe`: an opt-out arriving
+   * by reply, phone or in person is not somebody clicking a link, and the
+   * difference is exactly what a merchant asked to prove the request was
+   * honored has to be able to show.
+   */ manual: {
+        label: 'Added by hand',
+        color: 'default'
+    }
+};
+/** One stored reason, as {@link SUPPRESSION_REASONS} describes it. */ export const describeSuppressionReason = (reason)=>{
+    var _SUPPRESSION_REASONS_String;
+    return (_SUPPRESSION_REASONS_String = SUPPRESSION_REASONS[String(reason != null ? reason : 'unsubscribe')]) != null ? _SUPPRESSION_REASONS_String : {
+        label: String(reason),
+        color: 'default'
+    };
+};
+/**
+ * THE BREAKDOWN OF ONE SITE'S SUPPRESSION LIST, as server aggregates.
+ *
+ * One reader for both the site's own suppression card and the organization's
+ * summary of every site's, so the two can never count differently.
+ *
+ * Four reads, not one per reason. `where('reason','==','unsubscribe')` cannot
+ * be asked, because an entry written before AGL-2408 carries no `reason` at
+ * all and an equality filter excludes it — the field-presence trap the list's
+ * ordering also avoids. Unsubscribes are therefore the REMAINDER: the total
+ * minus every reason that is always written explicitly, which is exactly the
+ * compatibility rule the card's `describeReason` applies row by row. A reason
+ * counted explicitly and left out of the subtraction would be reported as
+ * somebody who clicked unsubscribe.
+ *
+ * Rejects when any read fails; a caller holds its figure at "unknown" rather
+ * than zeroing it, because "Bounced: 0" is a confident wrong number in the
+ * reassuring direction.
+ */ export async function readSuppressionTotals(firestore, hostId) {
+    var _all_data_total, _bounced_data_total, _complained_data_total, _added_data_total;
+    const suppressionsRef = collection(firestore, 'hosts', hostId, 'suppressions');
+    const [all, bounced, complained, added] = await Promise.all([
+        getAggregateFromServer(suppressionsRef, {
+            total: count()
+        }),
+        getAggregateFromServer(query(suppressionsRef, where('reason', '==', 'bounce')), {
+            total: count()
+        }),
+        getAggregateFromServer(query(suppressionsRef, where('reason', '==', 'complaint')), {
+            total: count()
+        }),
+        getAggregateFromServer(query(suppressionsRef, where('reason', '==', 'manual')), {
+            total: count()
+        })
+    ]);
+    const total = Number((_all_data_total = all.data().total) != null ? _all_data_total : 0);
+    const bounce = Number((_bounced_data_total = bounced.data().total) != null ? _bounced_data_total : 0);
+    const complaint = Number((_complained_data_total = complained.data().total) != null ? _complained_data_total : 0);
+    const manual = Number((_added_data_total = added.data().total) != null ? _added_data_total : 0);
+    return {
+        unsubscribe: Math.max(0, total - bounce - complaint - manual),
+        bounce,
+        complaint,
+        manual
+    };
+}
+
+//# sourceMappingURL=suppression-totals.js.map

package/src/lib/components/suppression-totals.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/email/src/lib/components/suppression-totals.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  collection,\n  count,\n  getAggregateFromServer,\n  query,\n  where,\n  type Firestore,\n} from 'firebase/firestore'\n\n/**\n * What a reason means to a merchant, and how much it should worry them.\n *\n * An ABSENT reason reads as \"Unsubscribed\", and that is a compatibility rule\n * rather than a guess: until AGL-2408 the unsubscribe handler wrote\n * `{ email, createdAt }` and nothing else, while the Resend webhook has\n * stamped `'bounce'`/`'complaint'` since AGL-1918 — so an entry with no reason\n * can only have come from somebody clicking the link. New unsubscribes write\n * the reason explicitly, so this fallback covers history and nothing else.\n */\nexport const SUPPRESSION_REASONS: Record<\n  string,\n  { label: string; color: 'default' | 'warning' | 'error' }\n> = {\n  unsubscribe: { label: 'Unsubscribed', color: 'default' },\n  bounce: { label: 'Bounced', color: 'warning' },\n  complaint: { label: 'Marked as spam', color: 'error' },\n  /*\n   * Recorded by a person, through the Add control.\n   *\n   * Its OWN value rather than a reuse of `unsubscribe`: an opt-out arriving\n   * by reply, phone or in person is not somebody clicking a link, and the\n   * difference is exactly what a merchant asked to prove the request was\n   * honored has to be able to show.\n   */\n  manual: { label: 'Added by hand', color: 'default' },\n}\n\n/** One stored reason, as {@link SUPPRESSION_REASONS} describes it. */\nexport const describeSuppressionReason = (reason: unknown) =>\n  SUPPRESSION_REASONS[String(reason ?? 'unsubscribe')] ?? {\n    label: String(reason),\n    color: 'default' as const,\n  }\n\n/** One site's suppression list, broken down by why each address is on it. */\nexport interface SuppressionTotals {\n  unsubscribe: number\n  bounce: number\n  complaint: number\n  manual: number\n}\n\n/**\n * THE BREAKDOWN OF ONE SITE'S SUPPRESSION LIST, as server aggregates.\n *\n * One reader for both the site's own suppression card and the organization's\n * summary of every site's, so the two can never count differently.\n *\n * Four reads, not one per reason. `where('reason','==','unsubscribe')` cannot\n * be asked, because an entry written before AGL-2408 carries no `reason` at\n * all and an equality filter excludes it — the field-presence trap the list's\n * ordering also avoids. Unsubscribes are therefore the REMAINDER: the total\n * minus every reason that is always written explicitly, which is exactly the\n * compatibility rule the card's `describeReason` applies row by row. A reason\n * counted explicitly and left out of the subtraction would be reported as\n * somebody who clicked unsubscribe.\n *\n * Rejects when any read fails; a caller holds its figure at \"unknown\" rather\n * than zeroing it, because \"Bounced: 0\" is a confident wrong number in the\n * reassuring direction.\n */\nexport async function readSuppressionTotals(\n  firestore: Firestore,\n  hostId: string,\n): Promise<SuppressionTotals> {\n  const suppressionsRef = collection(firestore, 'hosts', hostId, 'suppressions')\n  const [all, bounced, complained, added] = await Promise.all([\n    getAggregateFromServer(suppressionsRef, { total: count() }),\n    getAggregateFromServer(\n      query(suppressionsRef, where('reason', '==', 'bounce')),\n      { total: count() },\n    ),\n    getAggregateFromServer(\n      query(suppressionsRef, where('reason', '==', 'complaint')),\n      { total: count() },\n    ),\n    getAggregateFromServer(\n      query(suppressionsRef, where('reason', '==', 'manual')),\n      { total: count() },\n    ),\n  ])\n  const total = Number(all.data().total ?? 0)\n  const bounce = Number(bounced.data().total ?? 0)\n  const complaint = Number(complained.data().total ?? 0)\n  const manual = Number(added.data().total ?? 0)\n  return {\n    unsubscribe: Math.max(0, total - bounce - complaint - manual),\n    bounce,\n    complaint,\n    manual,\n  }\n}\n"],"names":["collection","count","getAggregateFromServer","query","where","SUPPRESSION_REASONS","unsubscribe","label","color","bounce","complaint","manual","describeSuppressionReason","reason","String","readSuppressionTotals","firestore","hostId","all","bounced","complained","added","suppressionsRef","Promise","total","Number","data","Math","max"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,UAAU,EACVC,KAAK,EACLC,sBAAsB,EACtBC,KAAK,EACLC,KAAK,QAEA,qBAAoB;AAE3B;;;;;;;;;CASC,GACD,OAAO,MAAMC,sBAGT;IACFC,aAAa;QAAEC,OAAO;QAAgBC,OAAO;IAAU;IACvDC,QAAQ;QAAEF,OAAO;QAAWC,OAAO;IAAU;IAC7CE,WAAW;QAAEH,OAAO;QAAkBC,OAAO;IAAQ;IACrD;;;;;;;GAOC,GACDG,QAAQ;QAAEJ,OAAO;QAAiBC,OAAO;IAAU;AACrD,EAAC;AAED,oEAAoE,GACpE,OAAO,MAAMI,4BAA4B,CAACC;QACxCR;YAAAA,8BAAAA,mBAAmB,CAACS,OAAOD,iBAAAA,SAAU,eAAe,YAApDR,8BAAwD;QACtDE,OAAOO,OAAOD;QACdL,OAAO;IACT;EAAC;AAUH;;;;;;;;;;;;;;;;;;CAkBC,GACD,OAAO,eAAeO,sBACpBC,SAAoB,EACpBC,MAAc;QAkBOC,iBACCC,qBACGC,wBACHC;IAnBtB,MAAMC,kBAAkBtB,WAAWgB,WAAW,SAASC,QAAQ;IAC/D,MAAM,CAACC,KAAKC,SAASC,YAAYC,MAAM,GAAG,MAAME,QAAQL,GAAG,CAAC;QAC1DhB,uBAAuBoB,iBAAiB;YAAEE,OAAOvB;QAAQ;QACzDC,uBACEC,MAAMmB,iBAAiBlB,MAAM,UAAU,MAAM,YAC7C;YAAEoB,OAAOvB;QAAQ;QAEnBC,uBACEC,MAAMmB,iBAAiBlB,MAAM,UAAU,MAAM,eAC7C;YAAEoB,OAAOvB;QAAQ;QAEnBC,uBACEC,MAAMmB,iBAAiBlB,MAAM,UAAU,MAAM,YAC7C;YAAEoB,OAAOvB;QAAQ;KAEpB;IACD,MAAMuB,QAAQC,QAAOP,kBAAAA,IAAIQ,IAAI,GAAGF,KAAK,YAAhBN,kBAAoB;IACzC,MAAMT,SAASgB,QAAON,sBAAAA,QAAQO,IAAI,GAAGF,KAAK,YAApBL,sBAAwB;IAC9C,MAAMT,YAAYe,QAAOL,yBAAAA,WAAWM,IAAI,GAAGF,KAAK,YAAvBJ,yBAA2B;IACpD,MAAMT,SAASc,QAAOJ,oBAAAA,MAAMK,IAAI,GAAGF,KAAK,YAAlBH,oBAAsB;IAC5C,OAAO;QACLf,aAAaqB,KAAKC,GAAG,CAAC,GAAGJ,QAAQf,SAASC,YAAYC;QACtDF;QACAC;QACAC;IACF;AACF"}

package/src/lib/components/suppressions-card.js

@@ -36,51 +36,11 @@ import { TABLE_ROW_HEIGHT } from "@aglyn/shared-ui-jsx/const/table-pagination";
 import { useSnackbar } from "@aglyn/shared-ui-snackstack";
 import { Alert, Chip, IconButton, Stack, TextField, Typography } from "@mui/material";
 import Button from "@mui/material/Button";
-import { collection, count, deleteDoc, doc, getAggregateFromServer, limit, orderBy, query, where } from "firebase/firestore";
+import { collection, deleteDoc, doc, limit, orderBy, query } from "firebase/firestore";
 import { useCallback, useEffect, useState } from "react";
 import { useFirestore, usePagedCollection, useUser } from "@aglyn/tenant-feature-instance";
 import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
-/**
- * What a reason means to a merchant, and how much it should worry them.
- *
- * An ABSENT reason reads as "Unsubscribed", and that is a compatibility rule
- * rather than a guess: until AGL-2408 the unsubscribe handler wrote
- * `{ email, createdAt }` and nothing else, while the Resend webhook has
- * stamped `'bounce'`/`'complaint'` since AGL-1918 — so an entry with no reason
- * can only have come from somebody clicking the link. New unsubscribes write
- * the reason explicitly, so this fallback covers history and nothing else.
- */ const REASONS = {
-    unsubscribe: {
-        label: 'Unsubscribed',
-        color: 'default'
-    },
-    bounce: {
-        label: 'Bounced',
-        color: 'warning'
-    },
-    complaint: {
-        label: 'Marked as spam',
-        color: 'error'
-    },
-    /*
-   * Recorded by a person, through the Add control.
-   *
-   * Its OWN value rather than a reuse of `unsubscribe`: an opt-out arriving
-   * by reply, phone or in person is not somebody clicking a link, and the
-   * difference is exactly what a merchant asked to prove the request was
-   * honored has to be able to show.
-   */ manual: {
-        label: 'Added by hand',
-        color: 'default'
-    }
-};
-const describeReason = (reason)=>{
-    var _REASONS_String;
-    return (_REASONS_String = REASONS[String(reason != null ? reason : 'unsubscribe')]) != null ? _REASONS_String : {
-        label: String(reason),
-        color: 'default'
-    };
-};
+import { describeSuppressionReason as describeReason, readSuppressionTotals } from "./suppression-totals.js";
 /**
  * `YYYY-MM-DD` from a Firestore timestamp shape, or an em dash.
  *
@@ -182,48 +142,15 @@ const describeReason = (reason)=>{
    * a ten-row page it would have meant 140 of ten. A bounce rate computed
    * from a sample is not a bounce rate, and nothing on screen said it was one.
    *
-   * Three reads, not one per reason. `where('reason','==','unsubscribe')`
-   * cannot be asked, because an entry written before AGL-2408 carries no
-   * `reason` at all and an equality filter excludes it — the same
-   * field-presence trap as the ordering above. Unsubscribes are therefore the
-   * REMAINDER: total minus the two reasons that are always written
-   * explicitly, which is exactly the compatibility rule `describeReason`
-   * applies row by row.
+   * `readSuppressionTotals` holds the four reads and the remainder rule for
+   * unsubscribes, and the organization's summary of every site's list asks
+   * the same function, so a site's figures read the same on both pages.
    *=========================================*/ const [totalsEpoch, setTotalsEpoch] = useState(0);
     const [totals, setTotals] = useState(null);
     useEffect(()=>{
         let active = true;
-        const suppressionsRef = collection(firestore, 'hosts', hostId, 'suppressions');
-        void Promise.all([
-            getAggregateFromServer(suppressionsRef, {
-                total: count()
-            }),
-            getAggregateFromServer(query(suppressionsRef, where('reason', '==', 'bounce')), {
-                total: count()
-            }),
-            getAggregateFromServer(query(suppressionsRef, where('reason', '==', 'complaint')), {
-                total: count()
-            }),
-            // A FOURTH read, and it is not optional. Unsubscribes are the
-            // REMAINDER, so every reason that is counted explicitly has to be
-            // subtracted — a hand-added entry left out of this list would be
-            // reported as somebody who clicked unsubscribe.
-            getAggregateFromServer(query(suppressionsRef, where('reason', '==', 'manual')), {
-                total: count()
-            })
-        ]).then(([all, bounced, complained, added])=>{
-            var _all_data_total, _bounced_data_total, _complained_data_total, _added_data_total;
-            if (!active) return;
-            const total = Number((_all_data_total = all.data().total) != null ? _all_data_total : 0);
-            const bounce = Number((_bounced_data_total = bounced.data().total) != null ? _bounced_data_total : 0);
-            const complaint = Number((_complained_data_total = complained.data().total) != null ? _complained_data_total : 0);
-            const manual = Number((_added_data_total = added.data().total) != null ? _added_data_total : 0);
-            setTotals({
-                unsubscribe: Math.max(0, total - bounce - complaint - manual),
-                bounce,
-                complaint,
-                manual
-            });
+        void readSuppressionTotals(firestore, hostId).then((read)=>{
+            if (active) setTotals(read);
         }).catch(()=>{
             // Held at null rather than zeroed. "Bounced: 0" is a confident wrong
             // number in the reassuring direction, and this card exists to warn.