@aglyn/plugins-marketing 1.0.0-beta.173 → 1.0.0-beta.175

package/src/lib/components/campaign-report-card.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/components/campaign-report-card.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 { AppLink, CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { ScrollTable } from '@aglyn/shared-ui-jsx/components/scroll-table.component'\nimport {\n  Alert,\n  Box,\n  Button,\n  Chip,\n  Divider,\n  Stack,\n  TableBody,\n  TableCell,\n  TableHead,\n  TableRow,\n  Typography,\n} from '@mui/material'\nimport { doc } from 'firebase/firestore'\nimport { useFirestore, useFirestoreDoc } from '@aglyn/tenant-feature-instance'\nimport {\n  campaignLinkReport,\n  campaignReport,\n  type CampaignLinkRollup,\n  type CampaignStats,\n} from '@aglyn/shared-ui-email-campaigns/model/campaign-report'\nimport {\n  campaignRevenueReport,\n  type CampaignRevenueRollup,\n} from '@aglyn/shared-ui-email-campaigns/model/campaign-revenue'\nimport {\n  campaignConversionsReport,\n  type CampaignConversionsRollup,\n} from '@aglyn/shared-ui-email-campaigns/model/campaign-conversions'\n/*\n * The three renderers every email report shares. Imported rather than kept\n * here, so \"a rate prints its denominator\" is one implementation and not a\n * convention each new card has to remember.\n */\nimport {\n  Figure,\n  MoneyFigure,\n  MoneyPerUnitRow,\n  percent,\n  RateRow,\n  Section,\n} from '@aglyn/shared-ui-jsx/components/measured-figures.component'\nimport {\n  emailSendTimeMs,\n} from '@aglyn/shared-ui-email-campaigns/model/email-record'\nimport {\n  campaignSendDisplay,\n  campaignSendProgress,\n} from '@aglyn/shared-ui-email-campaigns/model/campaign-container'\nimport { useEmailsHubPath } from './use-emails-hub-path'\n\n/**\n * The help affordance, hoisted so BOTH headers carry it.\n *\n * The unreadable-campaign branch below renders its own `CardDisplay`, and a\n * header without help is a header a reader has no way out of — which is\n * exactly the state that branch describes.\n */\nconst reportDocsHelp = pluginDocsHelp('emailCampaigns', {\n  anchor: '#the-campaign-report',\n  excerpt:\n    'What one campaign did: delivery, opens, clicks, bounces, complaints, ' +\n    'unsubscribes and the revenue it was credited with, each with the ' +\n    'population it is measured against.',\n})\n\nexport interface CampaignReportCardProps {\n  hostId: string\n  campaignId: string\n  /** The marketing hub URL, for the way back to the campaigns list. */\n  basePath: string\n}\n\n/**\n * ONE CAMPAIGN, MEASURED — and every denominator on screen.\n *\n * ## What was missing\n *\n * Opens and clicks have been recorded on the campaign document since AGL-268\n * and displayed as two words in a history row: `12 opens · 3 clicks`. Nothing\n * anywhere showed a rate, a delivery count, a bounce, a complaint or an\n * unsubscribe, and the populations the send itself measured — how large the\n * audience was, how many the consent rule refused, how many were already\n * suppressed — were computed on every send and written nowhere.\n *\n * ## The rule this screen is built around\n *\n * **Every rate names its denominator, in the same breath as the number.**\n *\n * That is not decoration. An open rate over `sent` and an open rate over\n * `delivered` are different numbers that share a label, and the difference\n * between them is exactly the mail that bounced — so a report that showed one\n * while the reader assumed the other would be wrong by however bad the\n * address list is, which is the case where being wrong matters most. Worse,\n * \"click rate\" is used in the wild for two unrelated quantities — clicks over\n * delivered, and clicks over openers — and they differ by a factor of three\n * or four on ordinary mail.\n *\n * So the arithmetic is not done here at all. `campaign-report.ts` returns\n * each rate as a triple carrying `denominatorLabel`, this file renders that\n * label, and a rate whose denominator is zero or unrecorded comes back `null`\n * and is drawn as \"—\" with a caveat naming the reason. There is no path\n * through this component that prints a percentage without saying what it is a\n * percentage of.\n *\n * ## What the page is about comes before how the mail did\n *\n * A campaign of one email is the ordinary shape, and this card is the page it\n * gets: the URL names a send, so there is no container above it and no list of\n * emails to draw. That collapse is honest, but it decided what the page was\n * ABOUT — delivery, engagement and rates are mechanics of a message, and a\n * page that led with them at length read as a mail report wearing the word\n * campaign.\n *\n * So the outcomes lead: what it caused, what it earned, where it sent people.\n * Two of those headings are the ones `campaign-reach-sections.tsx` puts at the\n * top of a campaign holding SEVERAL emails, and they are the same words here\n * deliberately — a merchant who opens a campaign of one and a campaign of six\n * is asking the same question and should not have to learn two vocabularies to\n * find the answer. The email's own figures follow, under a row that names the\n * message they belong to.\n *\n * Nothing about the reads changed with the order. The conversions, revenue and\n * destination figures were already on this page and already came from the four\n * documents below; they were simply underneath the mail.\n *\n * ## Three documents, whatever the campaign's size\n *\n * The whole screen is one campaign document plus one link-rollup document\n * plus one revenue-rollup document. All three are single-document listens, so\n * the cost does not move with the audience — a report over a 50,000-recipient\n * send reads the same three documents as one over ten. Aggregating the\n * per-recipient delivery log on mount would have been the obvious\n * implementation and would have read one document per recipient, every time\n * anybody opened the page; joining orders to campaigns at read time would\n * have been the same mistake one collection along, which is why the join is\n * done once at the sale and stored.\n *\n * ## No per-recipient view here, deliberately\n *\n * Every number on this screen is an aggregate that carries no address, and\n * that is what makes it three single-document reads. A per-recipient list is a\n * different read and a different question, so it lives where it is asked:\n * the design report's recipients table, which resolves the campaigns from the\n * design on a server that has already checked the reader's site role, and\n * returns only rows tagged with that site.\n *\n * The other per-recipient view — the staff delivery log on the user detail\n * page — spans every site on the install and is behind a staff claim that\n * records who looked. Neither reaches this card: adding a recipient list here\n * would put an unbounded read behind a widget whose whole cost model is that\n * it has none.\n */\nexport function CampaignReportCard(props: CampaignReportCardProps) {\n  const { hostId, campaignId, basePath } = props\n  // The sibling hub: the message's own page belongs to the Emails console.\n  const emailsHub = useEmailsHubPath()\n  const firestore = useFirestore()\n\n  const { data: campaign } = useFirestoreDoc<\n    Record<string, unknown> & { stats?: CampaignStats }\n  >(\n    () => doc(firestore, 'hosts', hostId, 'campaigns', campaignId),\n    [firestore, hostId, campaignId],\n  )\n  /*\n   * The link rollup, its own document rather than a field on the campaign.\n   *\n   * A map of destinations grows with the campaign's content and a campaign\n   * document is read by the history list, the glance widget and the send\n   * path; putting an unbounded map on it would make every one of those reads\n   * larger. Split, the rollup is read by exactly the screen that renders it.\n   */\n  const { data: links } = useFirestoreDoc<CampaignLinkRollup>(\n    () => doc(firestore, 'hosts', hostId, 'campaigns', campaignId, 'reports', 'links'),\n    [firestore, hostId, campaignId],\n  )\n  /*\n   * The revenue rollup, a third single-document listen.\n   *\n   * Its own document beside the link rollup rather than a field on the\n   * campaign, for the reason the link rollup is: the campaign document is\n   * read by the history list, the glance widget and the send path, and a map\n   * that grows with the campaign's sales would enlarge every one of those\n   * reads. The cost model in this file's header is unchanged in the way that\n   * matters — the page still reads a fixed number of documents whatever the\n   * audience, and no per-order or per-recipient read exists anywhere on it.\n   */\n  const { data: revenue } = useFirestoreDoc<CampaignRevenueRollup>(\n    () =>\n      doc(\n        firestore,\n        'hosts',\n        hostId,\n        'campaigns',\n        campaignId,\n        'reports',\n        'revenue',\n      ),\n    [firestore, hostId, campaignId],\n  )\n\n  /*\n   * The conversions rollup, a fourth single-document listen.\n   *\n   * Beside `reports/revenue` and read the same way, because it is the same\n   * join answering the other half of the question: revenue is what a campaign\n   * EARNED from people who named themselves at checkout, and this is what it\n   * CAUSED among people who were anonymous until the moment they submitted,\n   * signed up or booked. The cost model in this file's header is unchanged in\n   * the way that matters — a fixed number of documents whatever the audience,\n   * and no per-conversion read anywhere on the page.\n   */\n  const { data: conversions } = useFirestoreDoc<CampaignConversionsRollup>(\n    () =>\n      doc(\n        firestore,\n        'hosts',\n        hostId,\n        'campaigns',\n        campaignId,\n        'reports',\n        'conversions',\n      ),\n    [firestore, hostId, campaignId],\n  )\n\n  const report = campaignReport(campaign?.stats)\n  const linkReport = campaignLinkReport(links)\n  const revenueReport = campaignRevenueReport({\n    rollup: revenue,\n    /*\n     * The DENOMINATOR, handed over from the same document read at the same\n     * instant rather than re-read here. `report.delivered` is `null` when no\n     * delivery event was ever recorded, and it is passed as `null` so the\n     * revenue figures over it are withheld for exactly the reason every other\n     * rate over it is.\n     */\n    delivered: report.delivered,\n    midFlight: campaign\n      ? campaignSendProgress(campaign as never).state === 'sending'\n      : false,\n  })\n  /*\n   * No denominator is handed in, unlike the revenue report. A conversion RATE\n   * over delivered messages would repeat the defect the revenue section\n   * refuses for orders — one visitor can submit two forms, so the quotient\n   * passes 100% without anything being wrong — and counting distinct people\n   * instead needs a document per person per campaign, which is the\n   * per-recipient read this screen's cost model exists to refuse.\n   */\n  const conversionsReport = campaignConversionsReport({ rollup: conversions })\n  const subject = String(campaign?.subject ?? 'Campaign')\n  const sendTimeMs = campaign ? emailSendTimeMs(campaign) : 0\n\n  const backButton = (\n    <Button\n      component={AppLink as any}\n      {...({ componentVariant: 'naked', nativeButton: false } as any)}\n      href={`${basePath}/campaigns`}\n      size=\"small\"\n      color=\"primary\"\n    >\n      {'All campaigns'}\n    </Button>\n  )\n\n  if (!campaign) {\n    return (\n      <CardDisplay\n        header={'Campaign report'}\n        help={reportDocsHelp}\n        contentGutterX\n        contentGutterY\n        HeaderProps={{ action: backButton }}\n      >\n        {/*\n         * Not \"no data\". A campaign that cannot be read is a different\n         * situation from one with no engagement, and rendering an empty\n         * report for the first is how somebody comes to believe a campaign\n         * they sent reached nobody.\n         */}\n        <Typography variant=\"body2\" color=\"text.secondary\">\n          {'This campaign could not be loaded. It may have been deleted.'}\n        </Typography>\n      </CardDisplay>\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={'Campaign report'}\n      help={reportDocsHelp}\n      contentGutterX\n      contentGutterY\n      HeaderProps={{ action: backButton }}\n    >\n      <Stack spacing={3}>\n        {report.caveats.map((caveat) => (\n          <Alert key={caveat.id} severity=\"info\">\n            {caveat.message}\n          </Alert>\n        ))}\n\n        {/*==========================================\n          * WHAT THIS CAMPAIGN CAUSED — the page's first section, and the\n          * heading a campaign of several emails leads with too.\n          *\n          * The same join as the revenue below, credited under the same rule,\n          * answering it for people who were anonymous until the moment being\n          * counted: they arrived from a campaign link, browsed, and only\n          * became somebody when they submitted a form, signed up or booked.\n          *\n          * THE FOUR FIGURES ARE NEVER ADDED. One person filling in one form\n          * writes a submission, a contact and a lead, so a total would count\n          * that visit three times — and it would look like a bigger version\n          * of a real number, which is why the model carries no total for this\n          * JSX to reach for and the caveat says so in words above them.\n          *\n          * They are laid out in a row of independent `Figure`s rather than in\n          * a table with a footer, because a footer row is where a reader\n          * expects the sum to be.\n          *=========================================*/}\n        <Section title=\"What it caused\">\n          {conversionsReport.caveats.map((caveat) => (\n            <Alert key={caveat.id} severity=\"info\">\n              {caveat.message}\n            </Alert>\n          ))}\n          {conversionsReport.any ? (\n            <Stack spacing={1}>\n              <Stack\n                direction=\"row\"\n                spacing={4}\n                useFlexGap\n                sx={{ flexWrap: 'wrap' }}\n              >\n                {conversionsReport.kinds.map((entry) => (\n                  <Figure\n                    key={entry.kind}\n                    label={entry.label}\n                    value={entry.value}\n                    note={entry.note}\n                  />\n                ))}\n              </Stack>\n              <Typography variant=\"caption\" color=\"text.secondary\">\n                {`Credited ${conversionsReport.model === 'last-click' ? 'to the last campaign whose link the visitor clicked' : `under the ${conversionsReport.model} model`}, ` +\n                  `within ${conversionsReport.windowDays} days of that click. ` +\n                  'Somebody who converted without ever following a campaign ' +\n                  'link is credited to no campaign at all — nothing is ' +\n                  'inferred from a referrer — so these are a floor rather ' +\n                  'than everything this campaign influenced. The ones ' +\n                  'credited to nobody are counted under Conversions in the ' +\n                  'marketing console.'}\n              </Typography>\n              {/*\n                THE RECORDS BEHIND THE FIGURES. The rollup says how many; the\n                list says which, and it is the only place the uncredited half\n                is counted. A link rather than a table here — the records are\n                a paged read and this page's whole cost model is a fixed\n                number of documents whatever the audience.\n               */}\n              <Box>\n                <Button\n                  component={AppLink as any}\n                  {...({\n                    componentVariant: 'naked',\n                    nativeButton: false,\n                  } as any)}\n                  href={`${basePath}/conversions/${campaignId}`}\n                  size=\"small\"\n                  color=\"primary\"\n                >\n                  {'See these conversions'}\n                </Button>\n              </Box>\n            </Stack>\n          ) : (\n            <Typography variant=\"body2\" color=\"text.secondary\">\n              {conversionsReport.recorded\n                ? 'Nothing has been credited to this campaign yet.'\n                : 'No conversions have been attributed to this campaign. A ' +\n                  'form submission, lead, contact or booking is credited to ' +\n                  'the last campaign whose link the visitor clicked, within ' +\n                  `${conversionsReport.windowDays} days — a campaign sent ` +\n                  'before that was recorded will never show a figure here.'}\n            </Typography>\n          )}\n        </Section>\n\n        <Divider />\n\n        {/*==========================================\n          * WHAT THIS CAMPAIGN EARNED.\n          *\n          * The merchant's second question, and the one every compared\n          * product answers by reconstructing revenue probabilistically\n          * because it does not own the order. Here it is a join: the click\n          * and the order are rows in one database, so there is no tracking\n          * script, no catalog sync and nothing estimated except the model.\n          *\n          * THE MODEL IS ON SCREEN, in a sentence, above the money. A revenue\n          * figure whose rule the reader cannot state is worse than no\n          * figure, because they will use it anyway — and the two things they\n          * have to know to use it are which campaign gets the credit when\n          * several touched the buyer, and how long a click stays creditable.\n          *\n          * NET LEADS. Gross and refunded are both shown beside it, because\n          * \"this campaign made $4,000\" and \"this campaign made $4,000 of\n          * which $3,100 came back\" are different facts about whether to send\n          * another one.\n          *=========================================*/}\n        <Section title=\"Revenue\">\n          {revenueReport.caveats.map((caveat) => (\n            <Alert key={caveat.id} severity=\"info\">\n              {caveat.message}\n            </Alert>\n          ))}\n          {revenueReport.currencies.length ? (\n            <Stack spacing={3}>\n              {revenueReport.currencies.map((entry) => (\n                <Stack key={entry.currency} spacing={1}>\n                  {/*\n                   * The currency is a HEADING when there is more than one,\n                   * and absent when there is one. A per-currency label on a\n                   * report that only ever shows dollars is noise; the moment\n                   * there are two, the reader has to be able to see at a\n                   * glance that the blocks are not addable — which is also\n                   * what the caveat above says in words.\n                   */}\n                  {revenueReport.multiCurrency ? (\n                    <Typography variant=\"subtitle2\">\n                      {entry.currency.toUpperCase()}\n                    </Typography>\n                  ) : null}\n                  <Stack\n                    direction=\"row\"\n                    spacing={4}\n                    useFlexGap\n                    sx={{ flexWrap: 'wrap' }}\n                  >\n                    <MoneyFigure\n                      label=\"Net revenue\"\n                      cents={entry.netCents}\n                      currency={entry.currency}\n                      note=\"after refunds\"\n                    />\n                    <MoneyFigure\n                      label=\"Gross revenue\"\n                      cents={entry.grossCents}\n                      currency={entry.currency}\n                      note=\"as charged\"\n                    />\n                    <MoneyFigure\n                      label=\"Refunded\"\n                      cents={entry.refundedCents}\n                      currency={entry.currency}\n                      note=\"handed back\"\n                    />\n                    <Figure\n                      label=\"Orders\"\n                      value={entry.orders}\n                      note=\"credited to this campaign\"\n                    />\n                    <Figure\n                      label=\"Fully refunded\"\n                      value={entry.refundedOrders}\n                      note=\"of those orders\"\n                    />\n                  </Stack>\n                  <MoneyPerUnitRow\n                    label=\"Net revenue per delivered message\"\n                    figure={entry.netPerDelivered}\n                  />\n                </Stack>\n              ))}\n              {/*\n               * NO CONVERSION RATE, and this is where a reader would look\n               * for one. Orders over delivered is not a rate: one buyer can\n               * place two orders, so the quotient passes 100% without\n               * anything being wrong — the same defect that keeps `opens`\n               * out of the open-rate numerator two sections above. Counting\n               * distinct buyers instead would need a document per person per\n               * campaign, which is the per-recipient read this screen's cost\n               * model exists to refuse. The order count is shown as a count.\n               */}\n              <Typography variant=\"caption\" color=\"text.secondary\">\n                {`Credited ${revenueReport.model === 'last-click' ? 'to the last campaign whose link the buyer clicked' : `under the ${revenueReport.model} model`}, ` +\n                  `within ${revenueReport.windowDays} days of that click. ` +\n                  'Clicks only — an open is not treated as evidence that ' +\n                  'anybody read the email. An order placed by somebody who ' +\n                  'never clicked, or who checked out without giving an ' +\n                  'address, is credited to no campaign, so this is a floor ' +\n                  'rather than every sale this campaign influenced.'}\n              </Typography>\n            </Stack>\n          ) : (\n            <Typography variant=\"body2\" color=\"text.secondary\">\n              {revenueReport.recorded\n                ? 'No orders have been credited to this campaign.'\n                : 'No revenue has been attributed to this campaign. Orders ' +\n                  'are credited to the last campaign whose link the buyer ' +\n                  `clicked, within ${revenueReport.windowDays} days — a ` +\n                  'campaign sent before that was recorded, or one on a site ' +\n                  'with no store, will never show a figure here.'}\n            </Typography>\n          )}\n        </Section>\n\n        <Divider />\n\n        <Section title=\"Where it sent people\">\n          {/*\n            The heading a campaign of several emails carries over the same\n            question, so the two shapes of campaign page read alike. A\n            campaign owns no page — this is where its mail was actually\n            followed to, which is the only account of it the data holds.\n           */}\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {'The pages this campaign’s links were followed to.'}\n          </Typography>\n          {linkReport.rows.length ? (\n            <>\n              <ScrollTable size=\"small\">\n                <TableHead>\n                  <TableRow>\n                    <TableCell>{'Destination'}</TableCell>\n                    <TableCell align=\"right\">{'Clicks'}</TableCell>\n                    <TableCell align=\"right\">{'Share'}</TableCell>\n                  </TableRow>\n                </TableHead>\n                <TableBody>\n                  {linkReport.rows.map((row) => (\n                    <TableRow key={row.url}>\n                      <TableCell sx={{ wordBreak: 'break-all' }}>\n                        {row.url}\n                      </TableCell>\n                      <TableCell align=\"right\" sx={{ fontWeight: 'bold' }}>\n                        {row.clicks.toLocaleString()}\n                      </TableCell>\n                      <TableCell align=\"right\">\n                        {row.share\n                          ? `${percent(row.share.value)} of ${row.share.denominator.toLocaleString()} ${row.share.denominatorLabel}`\n                          : '—'}\n                      </TableCell>\n                    </TableRow>\n                  ))}\n                </TableBody>\n              </ScrollTable>\n              {/*\n               * The normalisation, stated rather than left for somebody to\n               * discover from a total that does not add up. Two links to the\n               * same page distinguished only by their UTM tags are one row\n               * here, and a merchant comparing this table with the campaign\n               * they built has to be told that before they conclude a link\n               * is missing.\n               */}\n              <Typography variant=\"caption\" color=\"text.secondary\">\n                {'Counted by address and path — query strings are dropped, so ' +\n                  'two links to the same page with different tracking ' +\n                  'parameters count as one row.'}\n              </Typography>\n              {linkReport.unattributedClicks ? (\n                <Typography variant=\"caption\" color=\"text.secondary\">\n                  {`${linkReport.unattributedClicks.toLocaleString()} clicks ` +\n                    'arrived without a destination and are not in this table.'}\n                </Typography>\n              ) : null}\n              {linkReport.overflowClicks ? (\n                <Alert severity=\"info\">\n                  {`This campaign has more distinct destinations than the ` +\n                    `rollup keeps. ${linkReport.overflowClicks.toLocaleString()} ` +\n                    'clicks landed on links past that limit and are counted ' +\n                    'in the click total above but not in this table.'}\n                </Alert>\n              ) : null}\n            </>\n          ) : (\n            <Typography variant=\"body2\" color=\"text.secondary\">\n              {report.clicks\n                ? 'Clicks were recorded for this campaign, but none of them ' +\n                  'carried a destination, so there is nothing to break down ' +\n                  'by link.'\n                : 'No link clicks have been recorded for this campaign.'}\n            </Typography>\n          )}\n        </Section>\n\n        <Divider />\n\n        {/*==========================================\n          * THE EMAIL THE FIGURES BELOW CAME FROM — and the hinge between the\n          * two halves of this page.\n          *\n          * This screen is reached at `/marketing/campaigns/{sendId}`, which\n          * is a CAMPAIGN url resolving to a send — the fall-through that keeps\n          * every unsubscribe footer and every pasted report link working. So\n          * a reader arrives from the campaigns table, where the row carries a\n          * \"Single send\" chip, and everything under this row is a fact about\n          * a message rather than about the campaign.\n          *\n          * Figures with no visible source read as a campaign holding no\n          * emails while reporting real numbers, which is a contradiction\n          * rather than a shortage of detail. Naming the one email — and\n          * saying it IS the campaign, which is what the chip already claims\n          * and what `campaignListRows` already does at read time — is what\n          * makes the page answer the question it raises.\n          *\n          * One row, from the document this card already read: no query, no\n          * second listen, and the two-document cost the header describes is\n          * unchanged.\n          *=========================================*/}\n        <Section title=\"The email in this campaign\">\n          <Stack spacing={1}>\n            <Stack\n              direction=\"row\"\n              spacing={1}\n              useFlexGap\n              sx={{ alignItems: 'center', flexWrap: 'wrap' }}\n            >\n              {/*\n                The MESSAGE's own page, which the Emails console owns — hence\n                the sibling hub rather than this surface's `basePath`. Plain\n                text until that hub resolves: a link with no destination is\n                worse than none, and the subject is what the reader came for\n                either way.\n               */}\n              {emailsHub ? (\n                <AppLink href={`${emailsHub}/messages/${campaignId}`}>\n                  {subject}\n                </AppLink>\n              ) : (\n                <Typography variant=\"body2\">{subject}</Typography>\n              )}\n              {/*\n                What the email is DOING, not the field it stores. One\n                delivering an audience larger than one batch is written back\n                as `scheduled` between runs, so a chip rendering the status\n                said \"Scheduled\" at the head of a report of five hundred\n                deliveries.\n               */}\n              <Chip\n                size=\"small\"\n                label={campaignSendDisplay(campaign as never).label}\n              />\n              <Chip\n                size=\"small\"\n                variant=\"outlined\"\n                label=\"Single send\"\n                title={\n                  'One email, sent on its own rather than as part of a ' +\n                  'campaign of several. Its report and its unsubscribe links ' +\n                  'are unchanged.'\n                }\n              />\n              <Typography variant=\"caption\" color=\"text.secondary\">\n                {sendTimeMs\n                  ? new Date(sendTimeMs).toLocaleString()\n                  : 'not recorded'}\n              </Typography>\n            </Stack>\n            <Typography variant=\"caption\" color=\"text.secondary\">\n              {'This campaign is one email, so the sections above are what ' +\n                'that one email caused. What follows is the mail itself — ' +\n                'how it was delivered and how it was read. Open the message ' +\n                'for its body and the people it reached.'}\n            </Typography>\n          </Stack>\n        </Section>\n\n        <Divider />\n\n        {/*==========================================\n          * WHAT HAPPENED TO THE MAIL.\n          *\n          * Counts first and rates second, in that order and not the other\n          * way round, because a rate is only readable once you know what it\n          * was taken over — and because the counts are the part that is\n          * always true. Every rate below can be absent; none of these can.\n          *=========================================*/}\n        <Section title=\"Delivery\">\n          <Stack direction=\"row\" spacing={4} useFlexGap sx={{ flexWrap: 'wrap' }}>\n            <Figure\n              label=\"Addressed\"\n              value={report.recipients}\n              note=\"after the per-send cap\"\n            />\n            <Figure\n              label=\"Sent\"\n              value={report.sent}\n              note=\"accepted by the provider\"\n            />\n            <Figure\n              label=\"Delivered\"\n              value={report.delivered}\n              note=\"accepted by the receiving server\"\n            />\n            <Figure label=\"Bounced\" value={report.bounced} note=\"of sent\" />\n            <Figure\n              label=\"Marked as spam\"\n              value={report.complained}\n              note=\"of delivered\"\n            />\n          </Stack>\n        </Section>\n\n        <Divider />\n\n        <Section title=\"Engagement\">\n          {/*\n           * BOTH the event count and the distinct count, side by side.\n           *\n           * `Opens` is every open event — one reader opening four times is\n           * four — and it is the number this product has always shown. It\n           * cannot be a rate numerator: divided by anything it exceeds 100%\n           * the moment somebody reads an email twice. `Readers who opened`\n           * is the distinct count, and it is what the rate below divides.\n           * Showing only one of them would either hide activity or invite a\n           * rate nobody can defend, so both are here with different names.\n           */}\n          <Stack direction=\"row\" spacing={4} useFlexGap sx={{ flexWrap: 'wrap' }}>\n            <Figure\n              label=\"Opens\"\n              value={report.opens}\n              note=\"every open, repeats included\"\n            />\n            <Figure\n              label=\"Readers who opened\"\n              value={report.uniqueOpens}\n              note=\"distinct recipients\"\n            />\n            <Figure\n              label=\"Clicks\"\n              value={report.clicks}\n              note=\"every click, repeats included\"\n            />\n            <Figure\n              label=\"Readers who clicked\"\n              value={report.uniqueClicks}\n              note=\"distinct recipients\"\n            />\n            <Figure\n              label=\"Unsubscribed\"\n              value={report.unsubscribes}\n              note=\"through this campaign's link\"\n            />\n          </Stack>\n        </Section>\n\n        <Divider />\n\n        <Section title=\"Rates\">\n          <Stack spacing={1}>\n            <RateRow label=\"Delivery rate\" rate={report.rates.delivery} />\n            <RateRow label=\"Open rate\" rate={report.rates.open} />\n            <RateRow label=\"Click rate\" rate={report.rates.click} />\n            <RateRow\n              label=\"Click-to-open rate\"\n              rate={report.rates.clickToOpen}\n            />\n            <RateRow label=\"Bounce rate\" rate={report.rates.bounce} />\n            <RateRow label=\"Complaint rate\" rate={report.rates.complaint} />\n            <RateRow\n              label=\"Unsubscribe rate\"\n              rate={report.rates.unsubscribe}\n            />\n          </Stack>\n        </Section>\n\n        {report.populations.length ? (\n          <>\n            <Divider />\n            <Section title=\"Who this went to\">\n              {/*\n               * The populations the SEND measured, recorded at send time.\n               *\n               * Not recomputed here, and the note under the heading says so:\n               * consent records change and addresses get suppressed, so\n               * asking the list today produces a number that is true of the\n               * list and false of the campaign.\n               */}\n              <Typography variant=\"body2\" color=\"text.secondary\">\n                {'Measured when this campaign was sent, and stored as it was ' +\n                  'then. These figures describe the send, not the audience ' +\n                  'as it stands today.'}\n              </Typography>\n              <ScrollTable size=\"small\">\n                <TableBody>\n                  {report.populations.map((population) => (\n                    <TableRow key={population.id}>\n                      <TableCell>{population.label}</TableCell>\n                      <TableCell align=\"right\" sx={{ fontWeight: 'bold' }}>\n                        {population.count.toLocaleString()}\n                      </TableCell>\n                      <TableCell align=\"right\">\n                        <Typography variant=\"caption\" color=\"text.secondary\">\n                          {`of ${population.of.toLocaleString()} ${population.ofLabel}`}\n                        </Typography>\n                      </TableCell>\n                    </TableRow>\n                  ))}\n                </TableBody>\n              </ScrollTable>\n            </Section>\n          </>\n        ) : null}\n      </Stack>\n    </CardDisplay>\n  )\n\n  return (\n    <>\n      {/* The page heading and the trail name the send; this card is\n          then free to say what it holds rather than repeating the title. */}\n      <PageHeaderRecord\n        title={\n          campaign ? String(campaign.subject || '') || campaignId : undefined\n        }\n      />\n      {card}\n    </>\n  )\n}\nCampaignReportCard.displayName = 'CampaignReportCard'\n\nexport default CampaignReportCard\n"],"names":["PageHeaderRecord","pluginDocsHelp","AppLink","CardDisplay","ScrollTable","Alert","Box","Button","Chip","Divider","Stack","TableBody","TableCell","TableHead","TableRow","Typography","doc","useFirestore","useFirestoreDoc","campaignLinkReport","campaignReport","campaignRevenueReport","campaignConversionsReport","Figure","MoneyFigure","MoneyPerUnitRow","percent","RateRow","Section","emailSendTimeMs","campaignSendDisplay","campaignSendProgress","useEmailsHubPath","reportDocsHelp","anchor","excerpt","CampaignReportCard","props","hostId","campaignId","basePath","emailsHub","firestore","data","campaign","links","revenue","conversions","report","stats","linkReport","revenueReport","rollup","delivered","midFlight","state","conversionsReport","subject","String","sendTimeMs","backButton","component","componentVariant","nativeButton","href","size","color","header","help","contentGutterX","contentGutterY","HeaderProps","action","variant","card","spacing","caveats","map","caveat","severity","message","id","title","any","direction","useFlexGap","sx","flexWrap","kinds","entry","label","value","note","kind","model","windowDays","recorded","currencies","length","multiCurrency","currency","toUpperCase","cents","netCents","grossCents","refundedCents","orders","refundedOrders","figure","netPerDelivered","rows","align","row","wordBreak","url","fontWeight","clicks","toLocaleString","share","denominator","denominatorLabel","unattributedClicks","overflowClicks","alignItems","Date","recipients","sent","bounced","complained","opens","uniqueOpens","uniqueClicks","unsubscribes","rate","rates","delivery","open","click","clickToOpen","bounce","complaint","unsubscribe","populations","population","count","of","ofLabel","undefined","displayName"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/components/campaign-report-card.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 { AppLink, CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { ScrollTable } from '@aglyn/shared-ui-jsx/components/scroll-table.component'\nimport {\n  Alert,\n  Box,\n  Button,\n  Chip,\n  Divider,\n  Stack,\n  TableBody,\n  TableCell,\n  TableHead,\n  TableRow,\n  Typography,\n} from '@mui/material'\nimport { useFirestore, useFirestoreDoc } from '@aglyn/tenant-feature-instance'\nimport {\n  campaignLinkReport,\n  campaignReport,\n  type CampaignLinkRollup,\n  type CampaignStats,\n} from '@aglyn/shared-ui-email-campaigns/model/campaign-report'\nimport {\n  campaignRevenueReport,\n  type CampaignRevenueRollup,\n} from '@aglyn/shared-ui-email-campaigns/model/campaign-revenue'\nimport {\n  campaignConversionsReport,\n  type CampaignConversionsRollup,\n} from '@aglyn/shared-ui-email-campaigns/model/campaign-conversions'\n/*\n * The three renderers every email report shares. Imported rather than kept\n * here, so \"a rate prints its denominator\" is one implementation and not a\n * convention each new card has to remember.\n */\nimport {\n  Figure,\n  MoneyFigure,\n  MoneyPerUnitRow,\n  percent,\n  RateRow,\n  Section,\n} from '@aglyn/shared-ui-jsx/components/measured-figures.component'\nimport {\n  emailSendTimeMs,\n} from '@aglyn/shared-ui-email-campaigns/model/email-record'\nimport {\n  campaignSendDisplay,\n  campaignSendProgress,\n} from '@aglyn/shared-ui-email-campaigns/model/campaign-container'\nimport { campaignSendDoc, campaignSendReportDoc } from './campaign-queries'\nimport {\n  orgSiteHubPath,\n  useMarketingOrgId,\n  useMarketingOrgMount,\n} from './marketing-org-mount'\nimport { useEmailsHubPath } from './use-emails-hub-path'\n\n/**\n * The help affordance, hoisted so BOTH headers carry it.\n *\n * The unreadable-campaign branch below renders its own `CardDisplay`, and a\n * header without help is a header a reader has no way out of — which is\n * exactly the state that branch describes.\n */\nconst reportDocsHelp = pluginDocsHelp('emailCampaigns', {\n  anchor: '#the-campaign-report',\n  excerpt:\n    'What one campaign did: delivery, opens, clicks, bounces, complaints, ' +\n    'unsubscribes and the revenue it was credited with, each with the ' +\n    'population it is measured against.',\n})\n\nexport interface CampaignReportCardProps {\n  /** The site, or `null` on the org Marketing hub. */\n  hostId: string | null\n  campaignId: string\n  /** The marketing hub URL, for the way back to the campaigns list. */\n  basePath: string\n}\n\n/**\n * ONE CAMPAIGN, MEASURED — and every denominator on screen.\n *\n * ## What was missing\n *\n * Opens and clicks have been recorded on the campaign document since AGL-268\n * and displayed as two words in a history row: `12 opens · 3 clicks`. Nothing\n * anywhere showed a rate, a delivery count, a bounce, a complaint or an\n * unsubscribe, and the populations the send itself measured — how large the\n * audience was, how many the consent rule refused, how many were already\n * suppressed — were computed on every send and written nowhere.\n *\n * ## The rule this screen is built around\n *\n * **Every rate names its denominator, in the same breath as the number.**\n *\n * That is not decoration. An open rate over `sent` and an open rate over\n * `delivered` are different numbers that share a label, and the difference\n * between them is exactly the mail that bounced — so a report that showed one\n * while the reader assumed the other would be wrong by however bad the\n * address list is, which is the case where being wrong matters most. Worse,\n * \"click rate\" is used in the wild for two unrelated quantities — clicks over\n * delivered, and clicks over openers — and they differ by a factor of three\n * or four on ordinary mail.\n *\n * So the arithmetic is not done here at all. `campaign-report.ts` returns\n * each rate as a triple carrying `denominatorLabel`, this file renders that\n * label, and a rate whose denominator is zero or unrecorded comes back `null`\n * and is drawn as \"—\" with a caveat naming the reason. There is no path\n * through this component that prints a percentage without saying what it is a\n * percentage of.\n *\n * ## What the page is about comes before how the mail did\n *\n * A campaign of one email is the ordinary shape, and this card is the page it\n * gets: the URL names a send, so there is no container above it and no list of\n * emails to draw. That collapse is honest, but it decided what the page was\n * ABOUT — delivery, engagement and rates are mechanics of a message, and a\n * page that led with them at length read as a mail report wearing the word\n * campaign.\n *\n * So the outcomes lead: what it caused, what it earned, where it sent people.\n * Two of those headings are the ones `campaign-reach-sections.tsx` puts at the\n * top of a campaign holding SEVERAL emails, and they are the same words here\n * deliberately — a merchant who opens a campaign of one and a campaign of six\n * is asking the same question and should not have to learn two vocabularies to\n * find the answer. The email's own figures follow, under a row that names the\n * message they belong to.\n *\n * Nothing about the reads changed with the order. The conversions, revenue and\n * destination figures were already on this page and already came from the four\n * documents below; they were simply underneath the mail.\n *\n * ## Three documents, whatever the campaign's size\n *\n * The whole screen is one campaign document plus one link-rollup document\n * plus one revenue-rollup document. All three are single-document listens, so\n * the cost does not move with the audience — a report over a 50,000-recipient\n * send reads the same three documents as one over ten. Aggregating the\n * per-recipient delivery log on mount would have been the obvious\n * implementation and would have read one document per recipient, every time\n * anybody opened the page; joining orders to campaigns at read time would\n * have been the same mistake one collection along, which is why the join is\n * done once at the sale and stored.\n *\n * ## No per-recipient view here, deliberately\n *\n * Every number on this screen is an aggregate that carries no address, and\n * that is what makes it three single-document reads. A per-recipient list is a\n * different read and a different question, so it lives where it is asked:\n * the design report's recipients table, which resolves the campaigns from the\n * design on a server that has already checked the reader's site role, and\n * returns only rows tagged with that site.\n *\n * ## The same four documents at the org level\n *\n * A send and its rollups are the org's, so the org hub reads the same four\n * documents. The one link that leads to a SITE fact — the conversions list,\n * which is that site's visitors — goes to the site the send was sent as.\n *\n * The other per-recipient view — the staff delivery log on the user detail\n * page — spans every site on the install and is behind a staff claim that\n * records who looked. Neither reaches this card: adding a recipient list here\n * would put an unbounded read behind a widget whose whole cost model is that\n * it has none.\n */\nexport function CampaignReportCard(props: CampaignReportCardProps) {\n  const { hostId, campaignId, basePath } = props\n  // The sibling hub: the message's own page belongs to the Emails console.\n  const emailsHub = useEmailsHubPath()\n  const orgMount = useMarketingOrgMount()\n  const { orgId } = useMarketingOrgId(hostId)\n  const firestore = useFirestore()\n\n  const { data: campaign, status } = useFirestoreDoc<\n    Record<string, unknown> & { stats?: CampaignStats }\n  >(\n    () => (orgId ? campaignSendDoc(firestore, orgId, campaignId) : null),\n    [firestore, orgId, campaignId],\n  )\n  /*\n   * The link rollup, its own document rather than a field on the campaign.\n   *\n   * A map of destinations grows with the campaign's content and a campaign\n   * document is read by the history list, the glance widget and the send\n   * path; putting an unbounded map on it would make every one of those reads\n   * larger. Split, the rollup is read by exactly the screen that renders it.\n   */\n  const { data: links } = useFirestoreDoc<CampaignLinkRollup>(\n    () =>\n      orgId ? campaignSendReportDoc(firestore, orgId, campaignId, 'links') : null,\n    [firestore, orgId, campaignId],\n  )\n  /*\n   * The revenue rollup, a third single-document listen.\n   *\n   * Its own document beside the link rollup rather than a field on the\n   * campaign, for the reason the link rollup is: the campaign document is\n   * read by the history list, the glance widget and the send path, and a map\n   * that grows with the campaign's sales would enlarge every one of those\n   * reads. The cost model in this file's header is unchanged in the way that\n   * matters — the page still reads a fixed number of documents whatever the\n   * audience, and no per-order or per-recipient read exists anywhere on it.\n   */\n  const { data: revenue } = useFirestoreDoc<CampaignRevenueRollup>(\n    () =>\n      orgId\n        ? campaignSendReportDoc(firestore, orgId, campaignId, 'revenue')\n        : null,\n    [firestore, orgId, campaignId],\n  )\n\n  /*\n   * The conversions rollup, a fourth single-document listen.\n   *\n   * Beside `reports/revenue` and read the same way, because it is the same\n   * join answering the other half of the question: revenue is what a campaign\n   * EARNED from people who named themselves at checkout, and this is what it\n   * CAUSED among people who were anonymous until the moment they submitted,\n   * signed up or booked. The cost model in this file's header is unchanged in\n   * the way that matters — a fixed number of documents whatever the audience,\n   * and no per-conversion read anywhere on the page.\n   */\n  const { data: conversions } = useFirestoreDoc<CampaignConversionsRollup>(\n    () =>\n      orgId\n        ? campaignSendReportDoc(firestore, orgId, campaignId, 'conversions')\n        : null,\n    [firestore, orgId, campaignId],\n  )\n  /*\n   * Where this send's links lead. The message's page is the Emails console's\n   * under a site and the org hub's own Emails section over the org; the\n   * conversions list is always the sending site's.\n   */\n  const messageHref = orgMount\n    ? `${orgMount.basePath}/emails/${campaignId}`\n    : emailsHub\n      ? `${emailsHub}/messages/${campaignId}`\n      : null\n  const conversionsHub = orgMount\n    ? orgSiteHubPath(orgMount, String(campaign?.hostId ?? ''), 'marketing')\n    : basePath\n\n  const report = campaignReport(campaign?.stats)\n  const linkReport = campaignLinkReport(links)\n  const revenueReport = campaignRevenueReport({\n    rollup: revenue,\n    /*\n     * The DENOMINATOR, handed over from the same document read at the same\n     * instant rather than re-read here. `report.delivered` is `null` when no\n     * delivery event was ever recorded, and it is passed as `null` so the\n     * revenue figures over it are withheld for exactly the reason every other\n     * rate over it is.\n     */\n    delivered: report.delivered,\n    midFlight: campaign\n      ? campaignSendProgress(campaign as never).state === 'sending'\n      : false,\n  })\n  /*\n   * No denominator is handed in, unlike the revenue report. A conversion RATE\n   * over delivered messages would repeat the defect the revenue section\n   * refuses for orders — one visitor can submit two forms, so the quotient\n   * passes 100% without anything being wrong — and counting distinct people\n   * instead needs a document per person per campaign, which is the\n   * per-recipient read this screen's cost model exists to refuse.\n   */\n  const conversionsReport = campaignConversionsReport({ rollup: conversions })\n  const subject = String(campaign?.subject ?? 'Campaign')\n  const sendTimeMs = campaign ? emailSendTimeMs(campaign) : 0\n\n  const backButton = (\n    <Button\n      component={AppLink as any}\n      {...({ componentVariant: 'naked', nativeButton: false } as any)}\n      href={`${basePath}/campaigns`}\n      size=\"small\"\n      color=\"primary\"\n    >\n      {'All campaigns'}\n    </Button>\n  )\n\n  // Nothing to say until the read has had its chance to answer.\n  if (!campaign && (status === 'loading' || !orgId)) return null\n\n  if (!campaign) {\n    return (\n      <CardDisplay\n        header={'Campaign report'}\n        help={reportDocsHelp}\n        contentGutterX\n        contentGutterY\n        HeaderProps={{ action: backButton }}\n      >\n        {/*\n         * Not \"no data\". A campaign that cannot be read is a different\n         * situation from one with no engagement, and rendering an empty\n         * report for the first is how somebody comes to believe a campaign\n         * they sent reached nobody.\n         */}\n        <Typography variant=\"body2\" color=\"text.secondary\">\n          {'This campaign could not be loaded. It may have been deleted.'}\n        </Typography>\n      </CardDisplay>\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={'Campaign report'}\n      help={reportDocsHelp}\n      contentGutterX\n      contentGutterY\n      HeaderProps={{ action: backButton }}\n    >\n      <Stack spacing={3}>\n        {report.caveats.map((caveat) => (\n          <Alert key={caveat.id} severity=\"info\">\n            {caveat.message}\n          </Alert>\n        ))}\n\n        {/*==========================================\n          * WHAT THIS CAMPAIGN CAUSED — the page's first section, and the\n          * heading a campaign of several emails leads with too.\n          *\n          * The same join as the revenue below, credited under the same rule,\n          * answering it for people who were anonymous until the moment being\n          * counted: they arrived from a campaign link, browsed, and only\n          * became somebody when they submitted a form, signed up or booked.\n          *\n          * THE FOUR FIGURES ARE NEVER ADDED. One person filling in one form\n          * writes a submission, a contact and a lead, so a total would count\n          * that visit three times — and it would look like a bigger version\n          * of a real number, which is why the model carries no total for this\n          * JSX to reach for and the caveat says so in words above them.\n          *\n          * They are laid out in a row of independent `Figure`s rather than in\n          * a table with a footer, because a footer row is where a reader\n          * expects the sum to be.\n          *=========================================*/}\n        <Section title=\"What it caused\">\n          {conversionsReport.caveats.map((caveat) => (\n            <Alert key={caveat.id} severity=\"info\">\n              {caveat.message}\n            </Alert>\n          ))}\n          {conversionsReport.any ? (\n            <Stack spacing={1}>\n              <Stack\n                direction=\"row\"\n                spacing={4}\n                useFlexGap\n                sx={{ flexWrap: 'wrap' }}\n              >\n                {conversionsReport.kinds.map((entry) => (\n                  <Figure\n                    key={entry.kind}\n                    label={entry.label}\n                    value={entry.value}\n                    note={entry.note}\n                  />\n                ))}\n              </Stack>\n              <Typography variant=\"caption\" color=\"text.secondary\">\n                {`Credited ${conversionsReport.model === 'last-click' ? 'to the last campaign whose link the visitor clicked' : `under the ${conversionsReport.model} model`}, ` +\n                  `within ${conversionsReport.windowDays} days of that click. ` +\n                  'Somebody who converted without ever following a campaign ' +\n                  'link is credited to no campaign at all — nothing is ' +\n                  'inferred from a referrer — so these are a floor rather ' +\n                  'than everything this campaign influenced. The ones ' +\n                  'credited to nobody are counted under Conversions in the ' +\n                  'marketing console.'}\n              </Typography>\n              {/*\n                THE RECORDS BEHIND THE FIGURES. The rollup says how many; the\n                list says which, and it is the only place the uncredited half\n                is counted. A link rather than a table here — the records are\n                a paged read and this page's whole cost model is a fixed\n                number of documents whatever the audience.\n               */}\n              {conversionsHub ? (\n                <Box>\n                  <Button\n                    component={AppLink as any}\n                    {...({\n                      componentVariant: 'naked',\n                      nativeButton: false,\n                    } as any)}\n                    href={`${conversionsHub}/conversions/${campaignId}`}\n                    size=\"small\"\n                    color=\"primary\"\n                  >\n                    {'See these conversions'}\n                  </Button>\n                </Box>\n              ) : null}\n            </Stack>\n          ) : (\n            <Typography variant=\"body2\" color=\"text.secondary\">\n              {conversionsReport.recorded\n                ? 'Nothing has been credited to this campaign yet.'\n                : 'No conversions have been attributed to this campaign. A ' +\n                  'form submission, lead, contact or booking is credited to ' +\n                  'the last campaign whose link the visitor clicked, within ' +\n                  `${conversionsReport.windowDays} days — a campaign sent ` +\n                  'before that was recorded will never show a figure here.'}\n            </Typography>\n          )}\n        </Section>\n\n        <Divider />\n\n        {/*==========================================\n          * WHAT THIS CAMPAIGN EARNED.\n          *\n          * The merchant's second question, and the one every compared\n          * product answers by reconstructing revenue probabilistically\n          * because it does not own the order. Here it is a join: the click\n          * and the order are rows in one database, so there is no tracking\n          * script, no catalog sync and nothing estimated except the model.\n          *\n          * THE MODEL IS ON SCREEN, in a sentence, above the money. A revenue\n          * figure whose rule the reader cannot state is worse than no\n          * figure, because they will use it anyway — and the two things they\n          * have to know to use it are which campaign gets the credit when\n          * several touched the buyer, and how long a click stays creditable.\n          *\n          * NET LEADS. Gross and refunded are both shown beside it, because\n          * \"this campaign made $4,000\" and \"this campaign made $4,000 of\n          * which $3,100 came back\" are different facts about whether to send\n          * another one.\n          *=========================================*/}\n        <Section title=\"Revenue\">\n          {revenueReport.caveats.map((caveat) => (\n            <Alert key={caveat.id} severity=\"info\">\n              {caveat.message}\n            </Alert>\n          ))}\n          {revenueReport.currencies.length ? (\n            <Stack spacing={3}>\n              {revenueReport.currencies.map((entry) => (\n                <Stack key={entry.currency} spacing={1}>\n                  {/*\n                   * The currency is a HEADING when there is more than one,\n                   * and absent when there is one. A per-currency label on a\n                   * report that only ever shows dollars is noise; the moment\n                   * there are two, the reader has to be able to see at a\n                   * glance that the blocks are not addable — which is also\n                   * what the caveat above says in words.\n                   */}\n                  {revenueReport.multiCurrency ? (\n                    <Typography variant=\"subtitle2\">\n                      {entry.currency.toUpperCase()}\n                    </Typography>\n                  ) : null}\n                  <Stack\n                    direction=\"row\"\n                    spacing={4}\n                    useFlexGap\n                    sx={{ flexWrap: 'wrap' }}\n                  >\n                    <MoneyFigure\n                      label=\"Net revenue\"\n                      cents={entry.netCents}\n                      currency={entry.currency}\n                      note=\"after refunds\"\n                    />\n                    <MoneyFigure\n                      label=\"Gross revenue\"\n                      cents={entry.grossCents}\n                      currency={entry.currency}\n                      note=\"as charged\"\n                    />\n                    <MoneyFigure\n                      label=\"Refunded\"\n                      cents={entry.refundedCents}\n                      currency={entry.currency}\n                      note=\"handed back\"\n                    />\n                    <Figure\n                      label=\"Orders\"\n                      value={entry.orders}\n                      note=\"credited to this campaign\"\n                    />\n                    <Figure\n                      label=\"Fully refunded\"\n                      value={entry.refundedOrders}\n                      note=\"of those orders\"\n                    />\n                  </Stack>\n                  <MoneyPerUnitRow\n                    label=\"Net revenue per delivered message\"\n                    figure={entry.netPerDelivered}\n                  />\n                </Stack>\n              ))}\n              {/*\n               * NO CONVERSION RATE, and this is where a reader would look\n               * for one. Orders over delivered is not a rate: one buyer can\n               * place two orders, so the quotient passes 100% without\n               * anything being wrong — the same defect that keeps `opens`\n               * out of the open-rate numerator two sections above. Counting\n               * distinct buyers instead would need a document per person per\n               * campaign, which is the per-recipient read this screen's cost\n               * model exists to refuse. The order count is shown as a count.\n               */}\n              <Typography variant=\"caption\" color=\"text.secondary\">\n                {`Credited ${revenueReport.model === 'last-click' ? 'to the last campaign whose link the buyer clicked' : `under the ${revenueReport.model} model`}, ` +\n                  `within ${revenueReport.windowDays} days of that click. ` +\n                  'Clicks only — an open is not treated as evidence that ' +\n                  'anybody read the email. An order placed by somebody who ' +\n                  'never clicked, or who checked out without giving an ' +\n                  'address, is credited to no campaign, so this is a floor ' +\n                  'rather than every sale this campaign influenced.'}\n              </Typography>\n            </Stack>\n          ) : (\n            <Typography variant=\"body2\" color=\"text.secondary\">\n              {revenueReport.recorded\n                ? 'No orders have been credited to this campaign.'\n                : 'No revenue has been attributed to this campaign. Orders ' +\n                  'are credited to the last campaign whose link the buyer ' +\n                  `clicked, within ${revenueReport.windowDays} days — a ` +\n                  'campaign sent before that was recorded, or one on a site ' +\n                  'with no store, will never show a figure here.'}\n            </Typography>\n          )}\n        </Section>\n\n        <Divider />\n\n        <Section title=\"Where it sent people\">\n          {/*\n            The heading a campaign of several emails carries over the same\n            question, so the two shapes of campaign page read alike. A\n            campaign owns no page — this is where its mail was actually\n            followed to, which is the only account of it the data holds.\n           */}\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {'The pages this campaign’s links were followed to.'}\n          </Typography>\n          {linkReport.rows.length ? (\n            <>\n              <ScrollTable size=\"small\">\n                <TableHead>\n                  <TableRow>\n                    <TableCell>{'Destination'}</TableCell>\n                    <TableCell align=\"right\">{'Clicks'}</TableCell>\n                    <TableCell align=\"right\">{'Share'}</TableCell>\n                  </TableRow>\n                </TableHead>\n                <TableBody>\n                  {linkReport.rows.map((row) => (\n                    <TableRow key={row.url}>\n                      <TableCell sx={{ wordBreak: 'break-all' }}>\n                        {row.url}\n                      </TableCell>\n                      <TableCell align=\"right\" sx={{ fontWeight: 'bold' }}>\n                        {row.clicks.toLocaleString()}\n                      </TableCell>\n                      <TableCell align=\"right\">\n                        {row.share\n                          ? `${percent(row.share.value)} of ${row.share.denominator.toLocaleString()} ${row.share.denominatorLabel}`\n                          : '—'}\n                      </TableCell>\n                    </TableRow>\n                  ))}\n                </TableBody>\n              </ScrollTable>\n              {/*\n               * The normalisation, stated rather than left for somebody to\n               * discover from a total that does not add up. Two links to the\n               * same page distinguished only by their UTM tags are one row\n               * here, and a merchant comparing this table with the campaign\n               * they built has to be told that before they conclude a link\n               * is missing.\n               */}\n              <Typography variant=\"caption\" color=\"text.secondary\">\n                {'Counted by address and path — query strings are dropped, so ' +\n                  'two links to the same page with different tracking ' +\n                  'parameters count as one row.'}\n              </Typography>\n              {linkReport.unattributedClicks ? (\n                <Typography variant=\"caption\" color=\"text.secondary\">\n                  {`${linkReport.unattributedClicks.toLocaleString()} clicks ` +\n                    'arrived without a destination and are not in this table.'}\n                </Typography>\n              ) : null}\n              {linkReport.overflowClicks ? (\n                <Alert severity=\"info\">\n                  {`This campaign has more distinct destinations than the ` +\n                    `rollup keeps. ${linkReport.overflowClicks.toLocaleString()} ` +\n                    'clicks landed on links past that limit and are counted ' +\n                    'in the click total above but not in this table.'}\n                </Alert>\n              ) : null}\n            </>\n          ) : (\n            <Typography variant=\"body2\" color=\"text.secondary\">\n              {report.clicks\n                ? 'Clicks were recorded for this campaign, but none of them ' +\n                  'carried a destination, so there is nothing to break down ' +\n                  'by link.'\n                : 'No link clicks have been recorded for this campaign.'}\n            </Typography>\n          )}\n        </Section>\n\n        <Divider />\n\n        {/*==========================================\n          * THE EMAIL THE FIGURES BELOW CAME FROM — and the hinge between the\n          * two halves of this page.\n          *\n          * This screen is reached at `/marketing/campaigns/{sendId}`, which\n          * is a CAMPAIGN url resolving to a send — the fall-through that keeps\n          * every unsubscribe footer and every pasted report link working. So\n          * a reader arrives from the campaigns table, where the row carries a\n          * \"Single send\" chip, and everything under this row is a fact about\n          * a message rather than about the campaign.\n          *\n          * Figures with no visible source read as a campaign holding no\n          * emails while reporting real numbers, which is a contradiction\n          * rather than a shortage of detail. Naming the one email — and\n          * saying it IS the campaign, which is what the chip already claims\n          * and what `campaignListRows` already does at read time — is what\n          * makes the page answer the question it raises.\n          *\n          * One row, from the document this card already read: no query, no\n          * second listen, and the two-document cost the header describes is\n          * unchanged.\n          *=========================================*/}\n        <Section title=\"The email in this campaign\">\n          <Stack spacing={1}>\n            <Stack\n              direction=\"row\"\n              spacing={1}\n              useFlexGap\n              sx={{ alignItems: 'center', flexWrap: 'wrap' }}\n            >\n              {/*\n                The MESSAGE's own page, which the Emails console owns — hence\n                the sibling hub rather than this surface's `basePath`. Plain\n                text until that hub resolves: a link with no destination is\n                worse than none, and the subject is what the reader came for\n                either way.\n               */}\n              {messageHref ? (\n                <AppLink href={messageHref}>{subject}</AppLink>\n              ) : (\n                <Typography variant=\"body2\">{subject}</Typography>\n              )}\n              {/*\n                What the email is DOING, not the field it stores. One\n                delivering an audience larger than one batch is written back\n                as `scheduled` between runs, so a chip rendering the status\n                said \"Scheduled\" at the head of a report of five hundred\n                deliveries.\n               */}\n              <Chip\n                size=\"small\"\n                label={campaignSendDisplay(campaign as never).label}\n              />\n              <Chip\n                size=\"small\"\n                variant=\"outlined\"\n                label=\"Single send\"\n                title={\n                  'One email, sent on its own rather than as part of a ' +\n                  'campaign of several. Its report and its unsubscribe links ' +\n                  'are unchanged.'\n                }\n              />\n              <Typography variant=\"caption\" color=\"text.secondary\">\n                {sendTimeMs\n                  ? new Date(sendTimeMs).toLocaleString()\n                  : 'not recorded'}\n              </Typography>\n            </Stack>\n            <Typography variant=\"caption\" color=\"text.secondary\">\n              {'This campaign is one email, so the sections above are what ' +\n                'that one email caused. What follows is the mail itself — ' +\n                'how it was delivered and how it was read. Open the message ' +\n                'for its body and the people it reached.'}\n            </Typography>\n          </Stack>\n        </Section>\n\n        <Divider />\n\n        {/*==========================================\n          * WHAT HAPPENED TO THE MAIL.\n          *\n          * Counts first and rates second, in that order and not the other\n          * way round, because a rate is only readable once you know what it\n          * was taken over — and because the counts are the part that is\n          * always true. Every rate below can be absent; none of these can.\n          *=========================================*/}\n        <Section title=\"Delivery\">\n          <Stack direction=\"row\" spacing={4} useFlexGap sx={{ flexWrap: 'wrap' }}>\n            <Figure\n              label=\"Addressed\"\n              value={report.recipients}\n              note=\"after the per-send cap\"\n            />\n            <Figure\n              label=\"Sent\"\n              value={report.sent}\n              note=\"accepted by the provider\"\n            />\n            <Figure\n              label=\"Delivered\"\n              value={report.delivered}\n              note=\"accepted by the receiving server\"\n            />\n            <Figure label=\"Bounced\" value={report.bounced} note=\"of sent\" />\n            <Figure\n              label=\"Marked as spam\"\n              value={report.complained}\n              note=\"of delivered\"\n            />\n          </Stack>\n        </Section>\n\n        <Divider />\n\n        <Section title=\"Engagement\">\n          {/*\n           * BOTH the event count and the distinct count, side by side.\n           *\n           * `Opens` is every open event — one reader opening four times is\n           * four — and it is the number this product has always shown. It\n           * cannot be a rate numerator: divided by anything it exceeds 100%\n           * the moment somebody reads an email twice. `Readers who opened`\n           * is the distinct count, and it is what the rate below divides.\n           * Showing only one of them would either hide activity or invite a\n           * rate nobody can defend, so both are here with different names.\n           */}\n          <Stack direction=\"row\" spacing={4} useFlexGap sx={{ flexWrap: 'wrap' }}>\n            <Figure\n              label=\"Opens\"\n              value={report.opens}\n              note=\"every open, repeats included\"\n            />\n            <Figure\n              label=\"Readers who opened\"\n              value={report.uniqueOpens}\n              note=\"distinct recipients\"\n            />\n            <Figure\n              label=\"Clicks\"\n              value={report.clicks}\n              note=\"every click, repeats included\"\n            />\n            <Figure\n              label=\"Readers who clicked\"\n              value={report.uniqueClicks}\n              note=\"distinct recipients\"\n            />\n            <Figure\n              label=\"Unsubscribed\"\n              value={report.unsubscribes}\n              note=\"through this campaign's link\"\n            />\n          </Stack>\n        </Section>\n\n        <Divider />\n\n        <Section title=\"Rates\">\n          <Stack spacing={1}>\n            <RateRow label=\"Delivery rate\" rate={report.rates.delivery} />\n            <RateRow label=\"Open rate\" rate={report.rates.open} />\n            <RateRow label=\"Click rate\" rate={report.rates.click} />\n            <RateRow\n              label=\"Click-to-open rate\"\n              rate={report.rates.clickToOpen}\n            />\n            <RateRow label=\"Bounce rate\" rate={report.rates.bounce} />\n            <RateRow label=\"Complaint rate\" rate={report.rates.complaint} />\n            <RateRow\n              label=\"Unsubscribe rate\"\n              rate={report.rates.unsubscribe}\n            />\n          </Stack>\n        </Section>\n\n        {report.populations.length ? (\n          <>\n            <Divider />\n            <Section title=\"Who this went to\">\n              {/*\n               * The populations the SEND measured, recorded at send time.\n               *\n               * Not recomputed here, and the note under the heading says so:\n               * consent records change and addresses get suppressed, so\n               * asking the list today produces a number that is true of the\n               * list and false of the campaign.\n               */}\n              <Typography variant=\"body2\" color=\"text.secondary\">\n                {'Measured when this campaign was sent, and stored as it was ' +\n                  'then. These figures describe the send, not the audience ' +\n                  'as it stands today.'}\n              </Typography>\n              <ScrollTable size=\"small\">\n                <TableBody>\n                  {report.populations.map((population) => (\n                    <TableRow key={population.id}>\n                      <TableCell>{population.label}</TableCell>\n                      <TableCell align=\"right\" sx={{ fontWeight: 'bold' }}>\n                        {population.count.toLocaleString()}\n                      </TableCell>\n                      <TableCell align=\"right\">\n                        <Typography variant=\"caption\" color=\"text.secondary\">\n                          {`of ${population.of.toLocaleString()} ${population.ofLabel}`}\n                        </Typography>\n                      </TableCell>\n                    </TableRow>\n                  ))}\n                </TableBody>\n              </ScrollTable>\n            </Section>\n          </>\n        ) : null}\n      </Stack>\n    </CardDisplay>\n  )\n\n  return (\n    <>\n      {/* The page heading and the trail name the send; this card is\n          then free to say what it holds rather than repeating the title. */}\n      <PageHeaderRecord\n        title={\n          campaign ? String(campaign.subject || '') || campaignId : undefined\n        }\n      />\n      {card}\n    </>\n  )\n}\nCampaignReportCard.displayName = 'CampaignReportCard'\n\nexport default CampaignReportCard\n"],"names":["PageHeaderRecord","pluginDocsHelp","AppLink","CardDisplay","ScrollTable","Alert","Box","Button","Chip","Divider","Stack","TableBody","TableCell","TableHead","TableRow","Typography","useFirestore","useFirestoreDoc","campaignLinkReport","campaignReport","campaignRevenueReport","campaignConversionsReport","Figure","MoneyFigure","MoneyPerUnitRow","percent","RateRow","Section","emailSendTimeMs","campaignSendDisplay","campaignSendProgress","campaignSendDoc","campaignSendReportDoc","orgSiteHubPath","useMarketingOrgId","useMarketingOrgMount","useEmailsHubPath","reportDocsHelp","anchor","excerpt","CampaignReportCard","props","hostId","campaignId","basePath","emailsHub","orgMount","orgId","firestore","data","campaign","status","links","revenue","conversions","messageHref","conversionsHub","String","report","stats","linkReport","revenueReport","rollup","delivered","midFlight","state","conversionsReport","subject","sendTimeMs","backButton","component","componentVariant","nativeButton","href","size","color","header","help","contentGutterX","contentGutterY","HeaderProps","action","variant","card","spacing","caveats","map","caveat","severity","message","id","title","any","direction","useFlexGap","sx","flexWrap","kinds","entry","label","value","note","kind","model","windowDays","recorded","currencies","length","multiCurrency","currency","toUpperCase","cents","netCents","grossCents","refundedCents","orders","refundedOrders","figure","netPerDelivered","rows","align","row","wordBreak","url","fontWeight","clicks","toLocaleString","share","denominator","denominatorLabel","unattributedClicks","overflowClicks","alignItems","Date","recipients","sent","bounced","complained","opens","uniqueOpens","uniqueClicks","unsubscribes","rate","rates","delivery","open","click","clickToOpen","bounce","complaint","unsubscribe","populations","population","count","of","ofLabel","undefined","displayName"],"mappings":"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"}

package/src/lib/components/campaigns-card.d.ts

@@ -12,9 +12,18 @@
  * existed; those carry no container id, and `campaignListRows` presents each
  * as a campaign of one rather than dropping it. Nothing is rewritten, so no
  * unsubscribe link and no pasted report URL stops resolving.
+ *
+ * ## At two levels
+ *
+ * Both collections are the organization's. Under a site the card lists the
+ * campaigns PLACED on that site and the sends sent AS it (see
+ * `campaign-queries.ts` for why those filters are what make the read legal);
+ * on the org hub, with `hostId` null, it lists every campaign with the sites
+ * each one is placed on, and a new campaign is placed where its creator says.
  */
 export declare function HostCampaignsCard(props: {
-    hostId: string;
+    /** The site, or `null` on the org Marketing hub. */
+    hostId: string | null;
     /**
      * The marketing hub URL, when the caller already has it.
      *

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

@@ -27,12 +27,14 @@ import { AppLink, CardDisplay, MdiIcon, useConfirmationContext } from "@aglyn/sh
 import { ListRowActions, ListTable, listActionsColumn } from "@aglyn/shared-ui-jsx/components/list-table.component";
 import { useSnackbar } from "@aglyn/shared-ui-snackstack";
 import { Alert, Button, Chip, Stack, Typography } from "@mui/material";
-import { collection, doc, limit, query, setDoc } from "firebase/firestore";
+import { collection, limit, query, setDoc } from "firebase/firestore";
 import { useCallback, useMemo, useState } from "react";
 import { useRouter } from "next/navigation";
-import { useConsoleHostRoute, useFirestore, useFirestoreCollection, useOrgDataScope, useUser } from "@aglyn/tenant-feature-instance";
-import { campaignListRows } from "@aglyn/shared-ui-email-campaigns/model";
+import { useConsoleHostRoute, useFirestore, useFirestoreCollection, useUser } from "@aglyn/tenant-feature-instance";
+import { campaignListRows, campaignSiteIds, campaignVisibleTo } from "@aglyn/shared-ui-email-campaigns/model";
 import { CreateArtifactDrawer } from "@aglyn/shared-ui-jsx-forms";
+import { campaignContainerDoc, campaignContainersQuery, campaignSendsQuery } from "./campaign-queries.js";
+import { orgSiteName, orgSiteOptions, topicCatalogHostId, useMarketingOrgId, useMarketingOrgMount } from "./marketing-org-mount.js";
 import { useCampaignManageApi } from "./use-campaign-send-api.js";
 import { useCampaignTopicOptions } from "./use-campaign-topic-options.js";
 /**
@@ -65,6 +67,14 @@ const WINDOW_LABEL = {
  * existed; those carry no container id, and `campaignListRows` presents each
  * as a campaign of one rather than dropping it. Nothing is rewritten, so no
  * unsubscribe link and no pasted report URL stops resolving.
+ *
+ * ## At two levels
+ *
+ * Both collections are the organization's. Under a site the card lists the
+ * campaigns PLACED on that site and the sends sent AS it (see
+ * `campaign-queries.ts` for why those filters are what make the read legal);
+ * on the org hub, with `hostId` null, it lists every campaign with the sites
+ * each one is placed on, and a new campaign is placed where its creator says.
  */ export function HostCampaignsCard(props) {
     const { hostId, basePath } = props;
     const firestore = useFirestore();
@@ -78,10 +88,10 @@ const WINDOW_LABEL = {
     const { data: user } = useUser();
     const { enqueueSnackbar } = useSnackbar();
     const { confirm } = useConfirmationContext();
-    const manageApi = useCampaignManageApi(hostId);
-    const { scope: dataScope } = useOrgDataScope({
-        hostId
-    });
+    const orgMount = useMarketingOrgMount();
+    const { orgId } = useMarketingOrgId(hostId);
+    // A container is the org's, so deleting one from the org hub names the org.
+    const manageApi = useCampaignManageApi(hostId, orgId);
     /*
    * ORDERED AND CEILINGED, and not orderable on any DATE.
    *
@@ -96,15 +106,23 @@ const WINDOW_LABEL = {
    * document-id order is what the bare cap already gave — but it says so,
    * which is what stops the next edit reaching for `sentAt`, and it probes one
    * past the ceiling so the reader is told the history is longer.
-   */ const { data: sendDocs } = useFirestoreCollection(()=>collectionCeiling(collection(firestore, 'hosts', hostId, 'campaigns'), CAMPAIGN_CEILING), [
+   */ const { data: sendDocs } = useFirestoreCollection(()=>{
+        const sends = campaignSendsQuery(firestore, orgId, hostId);
+        return sends ? collectionCeiling(sends, CAMPAIGN_CEILING) : null;
+    }, [
         firestore,
+        orgId,
         hostId
     ], {
         idField: '$id'
     });
     const { rows: readSends, truncated: sendsTruncated } = ceilingedWindow(sendDocs, CAMPAIGN_CEILING);
-    const { data: campaignDocs } = useFirestoreCollection(()=>collectionCeiling(collection(firestore, 'hosts', hostId, 'emailCampaigns'), CONTAINER_CEILING), [
+    const { data: campaignDocs } = useFirestoreCollection(()=>{
+        const containers = campaignContainersQuery(firestore, orgId, hostId);
+        return containers ? collectionCeiling(containers, CONTAINER_CEILING) : null;
+    }, [
         firestore,
+        orgId,
         hostId
     ], {
         idField: '$id'
@@ -112,9 +130,9 @@ const WINDOW_LABEL = {
     const { rows: readCampaigns, truncated: campaignsTruncated } = ceilingedWindow(campaignDocs, CONTAINER_CEILING);
     // Org email lists, so a row can name what it is aimed at rather than
     // showing ids.
-    const { data: listDocs } = useFirestoreCollection(()=>dataScope ? query(collection(firestore, dataScope[0], dataScope[1], 'lists'), limit(50)) : null, [
+    const { data: listDocs } = useFirestoreCollection(()=>orgId ? query(collection(firestore, 'orgs', orgId, 'lists'), limit(50)) : null, [
         firestore,
-        dataScope
+        orgId
     ], {
         idField: '$id'
     });
@@ -128,7 +146,7 @@ const WINDOW_LABEL = {
    * own drawer, and the one the audiences section applies to a list's
    * members. It is the largest read on this section at 200 documents, and it
    * is the only one nothing on screen needs.
-   */ const { topics, source: topicSource } = useCampaignTopicOptions(hostId, {
+   */ const { topics, source: topicSource } = useCampaignTopicOptions(topicCatalogHostId(hostId, orgMount), {
         enabled: createOpen
     });
     const topicOptions = useMemo(()=>topics.map((topic)=>({
@@ -158,12 +176,18 @@ const WINDOW_LABEL = {
     ]);
     const rows = useMemo(()=>{
         const campaigns = readCampaigns.filter((campaign)=>!campaign.deletedAt);
+        const byId = new Map(campaigns.map((campaign)=>[
+                campaign.$id,
+                campaign
+            ]));
         return campaignListRows(campaigns, readSends, Date.now()).map((row)=>_extends({}, row, {
-                $id: row.id
+                $id: row.id,
+                sitesLabel: orgMount ? campaignSitesLabel(orgMount, row, byId.get(row.id)) : ''
             }));
     }, [
         readCampaigns,
-        readSends
+        readSends,
+        orgMount
     ]);
     const [createError, setCreateError] = useState(null);
     const [creating, setCreating] = useState(false);
@@ -192,12 +216,18 @@ const WINDOW_LABEL = {
         if (startAtMs !== null && endAtMs !== null && endAtMs < startAtMs) {
             return setCreateError('The end date is before the start date');
         }
+        /*
+       * Held until the org is known. A container has one home, and a write
+       * that raced the site's org lookup would have nowhere to go.
+       */ if (!orgId) {
+            return setCreateError('This workspace is still loading — try again');
+        }
         setCreating(true);
         setCreateError(null);
         const id = createResourceUid();
         try {
             var _ref;
-            await setDoc(doc(firestore, 'hosts', hostId, 'emailCampaigns', id), _extends({
+            await setDoc(campaignContainerDoc(firestore, orgId, id), _extends({
                 name
             }, Number.isFinite(startAtMs) && startAtMs !== null ? {
                 startAtMs
@@ -208,6 +238,14 @@ const WINDOW_LABEL = {
             }, values.topicId ? {
                 topicId: String(values.topicId)
             } : {}, {
+                /*
+           * Where it is placed. From a site's hub, that site — the creator is
+           * standing on it, and a campaign that appeared on every sibling
+           * site would be a decision nobody made. From the org hub, the sites
+           * picked, and every site when none are.
+           */ visibleTo: campaignVisibleTo(hostId ? [
+                    hostId
+                ] : Array.isArray(values.siteIds) ? values.siteIds.map(String) : null),
                 createdAtMs: Date.now(),
                 createdBy: String((_ref = user == null ? void 0 : user.uid) != null ? _ref : '')
             }));
@@ -227,6 +265,7 @@ const WINDOW_LABEL = {
         creating,
         firestore,
         hostId,
+        orgId,
         user,
         enqueueSnackbar,
         openCampaign
@@ -351,6 +390,23 @@ const WINDOW_LABEL = {
                         ]
                     })
             },
+            /*
+        WHERE IT IS PLACED, on the org hub only. Under a site every row is on
+        that site by construction, so the column would say one thing thirty
+        times.
+       */ ...orgMount ? [
+                {
+                    field: 'sitesLabel',
+                    headerName: 'Sites',
+                    width: 170,
+                    sortable: false,
+                    renderCell: ({ row })=>/*#__PURE__*/ _jsx(Typography, {
+                            variant: "body2",
+                            noWrap: true,
+                            children: row.sitesLabel
+                        })
+                }
+            ] : [],
             {
                 field: 'windowState',
                 headerName: 'Window',
@@ -543,7 +599,8 @@ const WINDOW_LABEL = {
         listNames,
         campaignHref,
         deletingId,
-        handleDelete
+        handleDelete,
+        orgMount
     ]);
     return /*#__PURE__*/ _jsxs(CardDisplay, {
         header: 'Campaigns',
@@ -588,7 +645,7 @@ const WINDOW_LABEL = {
                     }),
                     sendsTruncated || campaignsTruncated ? /*#__PURE__*/ _jsx(Alert, {
                         severity: "info",
-                        children: `Showing the most recent ${CONTAINER_CEILING} campaigns and ` + `${CAMPAIGN_CEILING} sends. This site has more — the ones ` + 'listed are not necessarily the most recent, because a send ' + 'carries no date field that every writer stamps.'
+                        children: `Showing the most recent ${CONTAINER_CEILING} campaigns and ` + `${CAMPAIGN_CEILING} sends. ${hostId ? 'This site' : 'This organization'} has more — the ones ` + 'listed are not necessarily the most recent, because a send ' + 'carries no date field that every writer stamps.'
                     }) : null
                 ]
             }),
@@ -600,7 +657,7 @@ const WINDOW_LABEL = {
                 submitLabel: "Create campaign",
                 includeDescription: false,
                 onSubmit: handleCreate,
-                extraFields: campaignFields(listOptions, topicOptions),
+                extraFields: campaignFields(listOptions, topicOptions, orgMount ? orgSiteOptions(orgMount) : null),
                 errorSlot: createError ? /*#__PURE__*/ _jsx(Alert, {
                     severity: "error",
                     sx: {
@@ -620,8 +677,20 @@ const WINDOW_LABEL = {
  * topics so the drawer offers what this workspace actually has. Dates are
  * plain `date` inputs: a campaign window is a day at each end, and a time of
  * day would be a precision the model does not carry.
- */ function campaignFields(lists, topics) {
+ */ function campaignFields(lists, topics, /** The org's sites, on the org hub only — a site hub places on itself. */ sites) {
     return [
+        ...sites ? [
+            {
+                component: 'select',
+                name: 'siteIds',
+                label: 'Sites',
+                multiple: true,
+                initialValue: [],
+                helperText: 'The sites this campaign is offered on. Leave empty for every site.',
+                disableDefaultOption: true,
+                options: sites
+            }
+        ] : [],
         {
             component: 'text-field',
             name: 'startAt',
@@ -661,6 +730,20 @@ const WINDOW_LABEL = {
         }
     ];
 }
+/**
+ * The Sites cell: where a campaign is offered.
+ *
+ * A container reads its `visibleTo`; a single send, which has no container,
+ * is on the one site it was sent as. An empty placement is said rather than
+ * left blank, because a blank cell reads as "every site" and it means none.
+ */ function campaignSitesLabel(mount, row, container) {
+    var _row_sends_;
+    if (row.legacy) return orgSiteName(mount, (_row_sends_ = row.sends[0]) == null ? void 0 : _row_sends_.hostId) || '—';
+    const ids = campaignSiteIds(container);
+    if (ids === null) return 'Every site';
+    if (!ids.length) return 'No site';
+    return ids.map((id)=>orgSiteName(mount, id)).join(', ');
+}
 HostCampaignsCard.displayName = 'HostCampaignsCard';
 export default HostCampaignsCard;