@aglyn/plugins-marketing 1.0.0-beta.221 → 1.0.0-beta.223

package/src/lib/components/conversion-attribution.component.js

@@ -14,17 +14,82 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */ 'use client';
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { AppLink } from "@aglyn/shared-ui-jsx";
 import { Chip, Stack, Typography } from "@mui/material";
 import { doc } from "firebase/firestore";
 import { useFirestore, useFirestoreDoc } from "@aglyn/tenant-feature-instance";
 import { useMarketingHubPath } from "./use-marketing-hub-path.js";
-import { campaignConversionId, campaignTouchLabel } from "../model/campaign-conversions.js";
+import { useMarketingOrgId } from "./marketing-org-mount.js";
+import { campaignContainerDoc, campaignSendDoc } from "./campaign-queries.js";
+import { campaignConversionId, campaignCreditRule, campaignTouchLabel } from "../model/campaign-conversions.js";
+/**
+ * A campaign's name, read from its own document: the container's `name`, or
+ * a send's `subject` — the id until the read answers or when the document is
+ * gone, because an id is still the true value and a blank is not.
+ */ function CampaignName(props) {
+    var _ref;
+    const { orgId, id, of } = props;
+    const firestore = useFirestore();
+    const { data } = useFirestoreDoc(()=>orgId && id ? of === 'container' ? campaignContainerDoc(firestore, orgId, id) : campaignSendDoc(firestore, orgId, id) : null, [
+        firestore,
+        orgId,
+        id,
+        of
+    ]);
+    const label = String((_ref = of === 'container' ? data == null ? void 0 : data.name : data == null ? void 0 : data.subject) != null ? _ref : '').trim();
+    return /*#__PURE__*/ _jsx(_Fragment, {
+        children: label || id
+    });
+}
+/** The chip a channel is drawn with, and whether its credit names a document. */ function channelChip(record) {
+    switch(record.channel){
+        case 'email':
+            return {
+                label: 'Campaign email',
+                linked: true
+            };
+        case 'sequence':
+            return {
+                label: 'Sequence',
+                linked: true
+            };
+        case 'page':
+            return {
+                label: 'Campaign page',
+                linked: true
+            };
+        default:
+            return record.campaignId ? {
+                label: 'Campaign link',
+                linked: true
+            } : {
+                label: 'Web link',
+                linked: false
+            };
+    }
+}
+/** When and how the visitor was touched, in the sentence under the credit. */ function touchSentence(record) {
+    var _record_touchedAtMs;
+    const touched = Number((_record_touchedAtMs = record.touchedAtMs) != null ? _record_touchedAtMs : 0);
+    const at = touched ? ` on ${new Date(touched).toLocaleString()}` : '';
+    switch(record.channel){
+        case 'sequence':
+            return touched ? `Reached by a sequence email${at}` : 'Reached by a sequence email';
+        case 'page':
+            return `Viewed ${record.path ? record.path : 'a page filed under it'}${at}`;
+        default:
+            return touched ? `Followed the link${at}` : 'Followed a campaign link';
+    }
+}
 export function ConversionAttribution(props) {
-    var _props_marketingBasePath, _record_convertedAtMs, _record_touchedAtMs, _record_model, _record_windowDays;
+    var _props_filedUnder, _props_marketingBasePath, _record_convertedAtMs;
     const { hostId, kind, refId, quiet } = props;
+    const filedUnder = (_props_filedUnder = props.filedUnder) != null ? _props_filedUnder : [];
     const firestore = useFirestore();
+    // The org whose campaigns the names are read from; nothing is read until it
+    // is known, and the ids stand in until then.
+    const { orgId } = useMarketingOrgId(hostId);
     /*
    * Free — the org slug and the subdomain are already in the URL this console
    * is on, so no host document is resolved to render a link. `null` until the
@@ -55,69 +120,142 @@ export function ConversionAttribution(props) {
    * the reader's eye takes to reach it, and this sits inside a dialog that
    * opens with the read.
    */ if (status === 'loading') return null;
+    const campaignHref = (id)=>marketingBasePath && id ? `${marketingBasePath}/campaigns/${id}` : undefined;
+    /*
+   * FILED UNDER — the merchant's declaration, drawn first and under its own
+   * heading so it can never be read as the credit below it.
+   */ const filed = filedUnder.length ? /*#__PURE__*/ _jsxs(Stack, {
+        spacing: 0.5,
+        children: [
+            /*#__PURE__*/ _jsx(Typography, {
+                variant: "caption",
+                color: "text.secondary",
+                children: 'Filed under'
+            }),
+            /*#__PURE__*/ _jsx(Stack, {
+                direction: "row",
+                spacing: 1,
+                useFlexGap: true,
+                sx: {
+                    flexWrap: 'wrap'
+                },
+                children: filedUnder.map((id)=>{
+                    const href = campaignHref(id);
+                    const name = /*#__PURE__*/ _jsx(CampaignName, {
+                        orgId: orgId,
+                        id: id,
+                        of: "container"
+                    });
+                    return href ? /*#__PURE__*/ _jsx(AppLink, {
+                        href: href,
+                        children: name
+                    }, id) : /*#__PURE__*/ _jsx(Typography, {
+                        variant: "body2",
+                        children: name
+                    }, id);
+                })
+            })
+        ]
+    }) : null;
     if (!record) {
-        if (quiet) return null;
+        if (quiet && !filed) return null;
         return /*#__PURE__*/ _jsxs(Stack, {
-            spacing: 0.5,
+            spacing: 1,
             children: [
                 /*#__PURE__*/ _jsx(Typography, {
                     variant: "overline",
                     color: "text.secondary",
                     children: 'Campaign'
                 }),
-                /*#__PURE__*/ _jsx(Typography, {
-                    variant: "body2",
-                    color: "text.secondary",
-                    children: 'Not credited to a campaign — this arrived directly, or from a ' + 'link that carried no campaign. Nothing is inferred from a ' + 'referrer and no campaign is credited for being the most recent ' + 'one to run.'
+                filed,
+                quiet ? null : /*#__PURE__*/ _jsxs(Stack, {
+                    spacing: 0.5,
+                    children: [
+                        filed ? /*#__PURE__*/ _jsx(Typography, {
+                            variant: "caption",
+                            color: "text.secondary",
+                            children: 'Credited to'
+                        }) : null,
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "body2",
+                            color: "text.secondary",
+                            children: 'Not credited to a campaign — this arrived directly, or from a ' + 'link that carried no campaign, and no page filed under a ' + 'campaign was viewed before it. Nothing is inferred from a ' + 'referrer and no campaign is credited for being the most ' + 'recent one to run.'
+                        })
+                    ]
                 })
             ]
         });
     }
     const label = campaignTouchLabel(record);
     const converted = Number((_record_convertedAtMs = record.convertedAtMs) != null ? _record_convertedAtMs : 0);
-    const touched = Number((_record_touchedAtMs = record.touchedAtMs) != null ? _record_touchedAtMs : 0);
-    const isEmail = record.channel === 'email';
-    const isSequence = record.channel === 'sequence';
-    const campaignHref = (isEmail || isSequence) && marketingBasePath && record.campaignId ? `${marketingBasePath}/campaigns/${record.campaignId}` : undefined;
+    const chip = channelChip(record);
+    const creditedHref = chip.linked ? campaignHref(record.campaignId) : undefined;
+    const creditedName = chip.linked && record.campaignId ? /*#__PURE__*/ _jsx(CampaignName, {
+        orgId: orgId,
+        id: record.campaignId,
+        of: record.channel === 'email' ? 'send' : 'container'
+    }) : null;
     return /*#__PURE__*/ _jsxs(Stack, {
-        spacing: 0.5,
+        spacing: 1,
         children: [
             /*#__PURE__*/ _jsx(Typography, {
                 variant: "overline",
                 color: "text.secondary",
                 children: 'Campaign'
             }),
+            filed,
             /*#__PURE__*/ _jsxs(Stack, {
-                direction: "row",
-                spacing: 1,
-                useFlexGap: true,
-                sx: {
-                    alignItems: 'center',
-                    flexWrap: 'wrap'
-                },
+                spacing: 0.5,
                 children: [
-                    /*#__PURE__*/ _jsx(Chip, {
-                        size: "small",
-                        color: isEmail || isSequence ? 'primary' : 'default',
-                        variant: isEmail || isSequence ? 'filled' : 'outlined',
-                        label: isEmail ? 'Campaign email' : isSequence ? 'Sequence' : 'Web link'
-                    }),
-                    campaignHref ? /*#__PURE__*/ _jsx(AppLink, {
-                        href: campaignHref,
-                        children: label || record.campaignId
-                    }) : /*#__PURE__*/ _jsx(Typography, {
-                        variant: "body2",
+                    filed ? /*#__PURE__*/ _jsx(Typography, {
+                        variant: "caption",
+                        color: "text.secondary",
+                        children: 'Credited to'
+                    }) : null,
+                    /*#__PURE__*/ _jsxs(Stack, {
+                        direction: "row",
+                        spacing: 1,
+                        useFlexGap: true,
                         sx: {
-                            fontWeight: 'bold'
+                            alignItems: 'center',
+                            flexWrap: 'wrap'
                         },
-                        children: label || 'unnamed'
+                        children: [
+                            /*#__PURE__*/ _jsx(Chip, {
+                                size: "small",
+                                color: chip.linked ? 'primary' : 'default',
+                                variant: chip.linked ? 'filled' : 'outlined',
+                                label: chip.label
+                            }),
+                            creditedHref ? /*#__PURE__*/ _jsx(AppLink, {
+                                href: creditedHref,
+                                children: creditedName
+                            }) : creditedName ? /*#__PURE__*/ _jsx(Typography, {
+                                variant: "body2",
+                                sx: {
+                                    fontWeight: 'bold'
+                                },
+                                children: creditedName
+                            }) : /*#__PURE__*/ _jsx(Typography, {
+                                variant: "body2",
+                                sx: {
+                                    fontWeight: 'bold'
+                                },
+                                children: label || 'unnamed'
+                            }),
+                            record.channel === 'web' && record.campaignId && label ? /*#__PURE__*/ _jsx(Typography, {
+                                variant: "caption",
+                                color: "text.secondary",
+                                children: label
+                            }) : null
+                        ]
+                    }),
+                    /*#__PURE__*/ _jsx(Typography, {
+                        variant: "caption",
+                        color: "text.secondary",
+                        children: touchSentence(record) + (converted ? `, converted ${new Date(converted).toLocaleString()}` : '') + '. ' + campaignCreditRule(record.model, record.windowDays)
                     })
                 ]
-            }),
-            /*#__PURE__*/ _jsx(Typography, {
-                variant: "caption",
-                color: "text.secondary",
-                children: (isSequence ? touched ? `Reached by a sequence email on ${new Date(touched).toLocaleString()}` : 'Reached by a sequence email' : touched ? `Followed the link on ${new Date(touched).toLocaleString()}` : 'Followed a campaign link') + (converted ? `, converted ${new Date(converted).toLocaleString()}` : '') + `. Credited ${record.model === 'last-click' ? 'to the last campaign whose link they clicked' : `under the ${String((_record_model = record.model) != null ? _record_model : 'recorded')} model`}, within ${Number((_record_windowDays = record.windowDays) != null ? _record_windowDays : 0) || 7} days of that click.`
             })
         ]
     });

package/src/lib/components/conversion-attribution.component.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/components/conversion-attribution.component.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 { AppLink } from '@aglyn/shared-ui-jsx'\nimport { Chip, Stack, Typography } from '@mui/material'\nimport { doc } from 'firebase/firestore'\nimport { useFirestore, useFirestoreDoc } from '@aglyn/tenant-feature-instance'\nimport { useMarketingHubPath } from './use-marketing-hub-path'\nimport {\n  campaignConversionId,\n  campaignTouchLabel,\n  type CampaignConversionKind,\n  type CampaignConversionRecord,\n} from '../model/campaign-conversions'\n\n/**\n * WHERE THIS RECORD CAME FROM — attribution on the converted record itself.\n *\n * The campaign's own page answers \"what did this campaign cause\". This\n * answers the question from the other end, which is the one a person standing\n * in front of a lead actually has: where did THIS come from. Without it the\n * join is invisible to everybody who is not already looking at a campaign.\n *\n * ## One keyed read, and only where the record is opened\n *\n * The record's id IS half the attribution's id — `{kind}:{refId}` — so this\n * is `getDoc` on a known path: no query, no index, nothing that can be\n * truncated, and no listener over a collection. Mounted on a DETAIL surface\n * (a reader dialog, a drawer) rather than in a table row, because a column\n * would multiply that one read by the page size and charge it to every reader\n * who opened the list for another reason entirely.\n *\n * ## Absence is a real answer and is rendered as one\n *\n * The join writes nothing at all for a conversion it cannot credit — no\n * `utm_source=direct` placeholder, no referrer inference, no fallback to\n * whichever campaign ran most recently. So a missing document is the ordinary\n * case and it means \"this person arrived without following a campaign link\",\n * which this says in words.\n *\n * What it must never render is a campaign with a zero beside it. \"Came from\n * no campaign\" and \"came from this campaign, which produced nothing\" are\n * opposite facts, and a component that reached for a default would print the\n * second when it means the first.\n *\n * ## The channels do not render the same, because they are not the same\n *\n * An EMAIL touch names a campaign document, so the label is a link to it. A\n * WEB touch names `utm_` text a marketer typed into a URL — there is no\n * document at the other end and no page to open — so it is rendered as text.\n * A link that resolves nowhere is worse than no link. A SEQUENCE touch\n * (AGL-3254) names the campaign a rep's sequence is in, a container with a\n * page, so it links like an email touch and says which door it came through.\n */\nexport interface ConversionAttributionProps {\n  hostId: string\n  /** Which identify moment this record is. */\n  kind: CampaignConversionKind\n  /** The record's own document id — the `refId` the writer credited. */\n  refId: string\n  /**\n   * The marketing hub URL, when the caller already holds it.\n   *\n   * Resolved from the console route when it does not, which is the ordinary\n   * case: the surfaces that render this belong to other plugins — the Inbox,\n   * Contacts — and they are handed their OWN hub's path. Deriving one hub's\n   * URL from another's by string surgery is the link that breaks silently\n   * when a surface moves.\n   */\n  marketingBasePath?: string\n  /** Rendered instead of the \"no campaign\" sentence, for a compact surface. */\n  quiet?: boolean\n}\n\nexport function ConversionAttribution(props: ConversionAttributionProps) {\n  const { hostId, kind, refId, quiet } = props\n  const firestore = useFirestore()\n  /*\n   * Free — the org slug and the subdomain are already in the URL this console\n   * is on, so no host document is resolved to render a link. `null` until the\n   * params settle, and the campaign is then NAMED but not linked, which is\n   * the rule the web channel follows for the same reason: no link beats one\n   * that resolves nowhere.\n   */\n  const resolvedHub = useMarketingHubPath()\n  const marketingBasePath = props.marketingBasePath ?? resolvedHub\n\n  /*\n   * The id is BUILT rather than interpolated, so a ref carrying a slash or a\n   * colon answers null here instead of naming a document in another\n   * collection. A null builder is how this hook is told not to read at all.\n   */\n  const attributionId = campaignConversionId(kind, refId)\n  const { data: record, status } = useFirestoreDoc<CampaignConversionRecord>(\n    () =>\n      attributionId\n        ? doc(\n            firestore,\n            'hosts',\n            hostId,\n            'campaignAttributions',\n            attributionId,\n          )\n        : null,\n    [firestore, hostId, attributionId],\n  )\n\n  /*\n   * An id that could not be built means the record's own id is unusable, so\n   * the question was never asked. Drawing the \"not credited\" sentence here\n   * would state a fact nothing checked — the one thing this component must\n   * not do — so it draws nothing.\n   */\n  if (!attributionId) return null\n\n  /*\n   * Nothing while the read settles. Rendering \"no campaign\" first and\n   * replacing it a tick later states the opposite of the truth for as long as\n   * the reader's eye takes to reach it, and this sits inside a dialog that\n   * opens with the read.\n   */\n  if (status === 'loading') return null\n\n  if (!record) {\n    if (quiet) return null\n    return (\n      <Stack spacing={0.5}>\n        <Typography variant=\"overline\" color=\"text.secondary\">\n          {'Campaign'}\n        </Typography>\n        {/*\n          NOT a zero, and not an empty campaign chip. The sentence says which\n          fact this is: nobody was credited, and nothing was guessed.\n         */}\n        <Typography variant=\"body2\" color=\"text.secondary\">\n          {'Not credited to a campaign — this arrived directly, or from a ' +\n            'link that carried no campaign. Nothing is inferred from a ' +\n            'referrer and no campaign is credited for being the most recent ' +\n            'one to run.'}\n        </Typography>\n      </Stack>\n    )\n  }\n\n  const label = campaignTouchLabel(record)\n  const converted = Number(record.convertedAtMs ?? 0)\n  const touched = Number(record.touchedAtMs ?? 0)\n  const isEmail = record.channel === 'email'\n  const isSequence = record.channel === 'sequence'\n  const campaignHref =\n    (isEmail || isSequence) && marketingBasePath && record.campaignId\n      ? `${marketingBasePath}/campaigns/${record.campaignId}`\n      : undefined\n\n  return (\n    <Stack spacing={0.5}>\n      <Typography variant=\"overline\" color=\"text.secondary\">\n        {'Campaign'}\n      </Typography>\n      <Stack\n        direction=\"row\"\n        spacing={1}\n        useFlexGap\n        sx={{ alignItems: 'center', flexWrap: 'wrap' }}\n      >\n        {/*\n          The CHANNEL is on screen beside the label, because the two are read\n          differently: one names a campaign whose report can be opened, the\n          other names text somebody typed into a URL.\n         */}\n        <Chip\n          size=\"small\"\n          color={isEmail || isSequence ? 'primary' : 'default'}\n          variant={isEmail || isSequence ? 'filled' : 'outlined'}\n          label={isEmail ? 'Campaign email' : isSequence ? 'Sequence' : 'Web link'}\n        />\n        {campaignHref ? (\n          <AppLink href={campaignHref}>{label || record.campaignId}</AppLink>\n        ) : (\n          <Typography variant=\"body2\" sx={{ fontWeight: 'bold' }}>\n            {label || 'unnamed'}\n          </Typography>\n        )}\n      </Stack>\n      {/*\n        THE RULE, under the claim. A credit whose rule the reader cannot state\n        is a credit they will use anyway, and the two things they need are\n        which touch wins and how long one stays creditable. `model` and\n        `windowDays` come off the RECORD, so a conversion credited under an\n        older rule prints the rule it was credited under.\n       */}\n      <Typography variant=\"caption\" color=\"text.secondary\">\n        {(isSequence\n          ? touched\n            ? `Reached by a sequence email on ${new Date(touched).toLocaleString()}`\n            : 'Reached by a sequence email'\n          : touched\n            ? `Followed the link on ${new Date(touched).toLocaleString()}`\n            : 'Followed a campaign link') +\n          (converted\n            ? `, converted ${new Date(converted).toLocaleString()}`\n            : '') +\n          `. Credited ${\n            record.model === 'last-click'\n              ? 'to the last campaign whose link they clicked'\n              : `under the ${String(record.model ?? 'recorded')} model`\n          }, within ${Number(record.windowDays ?? 0) || 7} days of that click.`}\n      </Typography>\n    </Stack>\n  )\n}\nConversionAttribution.displayName = 'ConversionAttribution'\n\nexport default ConversionAttribution\n"],"names":["AppLink","Chip","Stack","Typography","doc","useFirestore","useFirestoreDoc","useMarketingHubPath","campaignConversionId","campaignTouchLabel","ConversionAttribution","props","record","hostId","kind","refId","quiet","firestore","resolvedHub","marketingBasePath","attributionId","data","status","spacing","variant","color","label","converted","Number","convertedAtMs","touched","touchedAtMs","isEmail","channel","isSequence","campaignHref","campaignId","undefined","direction","useFlexGap","sx","alignItems","flexWrap","size","href","fontWeight","Date","toLocaleString","model","String","windowDays","displayName"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/components/conversion-attribution.component.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 { AppLink } from '@aglyn/shared-ui-jsx'\nimport { Chip, Stack, Typography } from '@mui/material'\nimport { doc } from 'firebase/firestore'\nimport { useFirestore, useFirestoreDoc } from '@aglyn/tenant-feature-instance'\nimport { useMarketingHubPath } from './use-marketing-hub-path'\nimport { useMarketingOrgId } from './marketing-org-mount'\nimport { campaignContainerDoc, campaignSendDoc } from './campaign-queries'\nimport {\n  campaignConversionId,\n  campaignCreditRule,\n  campaignTouchLabel,\n  type CampaignConversionKind,\n  type CampaignConversionRecord,\n} from '../model/campaign-conversions'\n\n/**\n * WHERE THIS RECORD CAME FROM — attribution on the converted record itself.\n *\n * The campaign's own page answers \"what did this campaign cause\". This\n * answers the question from the other end, which is the one a person standing\n * in front of a lead actually has: where did THIS come from. Without it the\n * join is invisible to everybody who is not already looking at a campaign.\n *\n * ## One keyed read, and only where the record is opened\n *\n * The record's id IS half the attribution's id — `{kind}:{refId}` — so this\n * is `getDoc` on a known path: no query, no index, nothing that can be\n * truncated, and no listener over a collection. Mounted on a DETAIL surface\n * (a reader dialog, a drawer) rather than in a table row, because a column\n * would multiply that one read by the page size and charge it to every reader\n * who opened the list for another reason entirely.\n *\n * ## Absence is a real answer and is rendered as one\n *\n * The join writes nothing at all for a conversion it cannot credit — no\n * `utm_source=direct` placeholder, no referrer inference, no fallback to\n * whichever campaign ran most recently. So a missing document is the ordinary\n * case and it means \"this person arrived without following a campaign link\",\n * which this says in words.\n *\n * What it must never render is a campaign with a zero beside it. \"Came from\n * no campaign\" and \"came from this campaign, which produced nothing\" are\n * opposite facts, and a component that reached for a default would print the\n * second when it means the first.\n *\n * ## The channels do not render the same, because they are not the same\n *\n * An EMAIL touch names a campaign document, so the label is a link to it. A\n * WEB touch names `utm_` text a marketer typed into a URL — there is no\n * document at the other end and no page to open — so it is rendered as text.\n * A link that resolves nowhere is worse than no link. A SEQUENCE touch\n * (AGL-3254) names the campaign a rep's sequence is in, a container with a\n * page, so it links like an email touch and says which door it came through.\n * A PAGE touch (AGL-3461) names the campaign the viewed page is filed under,\n * and a web touch whose label a campaign declares names that campaign: both\n * link to it.\n *\n * ## Filed under is not credited to\n *\n * A surface that knows what its record is filed under — the Inbox knows the\n * form's campaigns and the page's — hands them in as `filedUnder`, and they\n * are drawn ABOVE the credit under their own heading. The two answer\n * different questions: which campaigns the merchant put this form and page\n * in, and which campaign's touch the visitor arrived through. A submission can\n * be filed under one campaign and credited to another, or to none, and a\n * screen that ran the two together would hide exactly that.\n */\nexport interface ConversionAttributionProps {\n  hostId: string\n  /** Which identify moment this record is. */\n  kind: CampaignConversionKind\n  /** The record's own document id — the `refId` the writer credited. */\n  refId: string\n  /**\n   * The marketing hub URL, when the caller already holds it.\n   *\n   * Resolved from the console route when it does not, which is the ordinary\n   * case: the surfaces that render this belong to other plugins — the Inbox,\n   * Contacts — and they are handed their OWN hub's path. Deriving one hub's\n   * URL from another's by string surgery is the link that breaks silently\n   * when a surface moves.\n   */\n  marketingBasePath?: string\n  /** Rendered instead of the \"no campaign\" sentence, for a compact surface. */\n  quiet?: boolean\n  /**\n   * The campaigns the record is FILED under, by container id (AGL-3461) —\n   * drawn as \"Filed under\" above the credit. Absent: the heading is not drawn.\n   */\n  filedUnder?: readonly string[]\n}\n\n/** Which collection a campaign id on a record names. */\ntype CampaignIdKind = 'container' | 'send'\n\n/**\n * A campaign's name, read from its own document: the container's `name`, or\n * a send's `subject` — the id until the read answers or when the document is\n * gone, because an id is still the true value and a blank is not.\n */\nfunction CampaignName(props: {\n  orgId: string | null\n  id: string\n  of: CampaignIdKind\n}) {\n  const { orgId, id, of } = props\n  const firestore = useFirestore()\n  const { data } = useFirestoreDoc<{ name?: string; subject?: string }>(\n    () =>\n      orgId && id\n        ? of === 'container'\n          ? campaignContainerDoc(firestore, orgId, id)\n          : campaignSendDoc(firestore, orgId, id)\n        : null,\n    [firestore, orgId, id, of],\n  )\n  const label = String((of === 'container' ? data?.name : data?.subject) ?? '').trim()\n  return <>{label || id}</>\n}\n\n/** The chip a channel is drawn with, and whether its credit names a document. */\nfunction channelChip(record: CampaignConversionRecord): {\n  label: string\n  linked: boolean\n} {\n  switch (record.channel) {\n    case 'email':\n      return { label: 'Campaign email', linked: true }\n    case 'sequence':\n      return { label: 'Sequence', linked: true }\n    case 'page':\n      return { label: 'Campaign page', linked: true }\n    default:\n      return record.campaignId\n        ? { label: 'Campaign link', linked: true }\n        : { label: 'Web link', linked: false }\n  }\n}\n\n/** When and how the visitor was touched, in the sentence under the credit. */\nfunction touchSentence(record: CampaignConversionRecord): string {\n  const touched = Number(record.touchedAtMs ?? 0)\n  const at = touched ? ` on ${new Date(touched).toLocaleString()}` : ''\n  switch (record.channel) {\n    case 'sequence':\n      return touched ? `Reached by a sequence email${at}` : 'Reached by a sequence email'\n    case 'page':\n      return `Viewed ${record.path ? record.path : 'a page filed under it'}${at}`\n    default:\n      return touched ? `Followed the link${at}` : 'Followed a campaign link'\n  }\n}\n\nexport function ConversionAttribution(props: ConversionAttributionProps) {\n  const { hostId, kind, refId, quiet } = props\n  const filedUnder = props.filedUnder ?? []\n  const firestore = useFirestore()\n  // The org whose campaigns the names are read from; nothing is read until it\n  // is known, and the ids stand in until then.\n  const { orgId } = useMarketingOrgId(hostId)\n  /*\n   * Free — the org slug and the subdomain are already in the URL this console\n   * is on, so no host document is resolved to render a link. `null` until the\n   * params settle, and the campaign is then NAMED but not linked, which is\n   * the rule the web channel follows for the same reason: no link beats one\n   * that resolves nowhere.\n   */\n  const resolvedHub = useMarketingHubPath()\n  const marketingBasePath = props.marketingBasePath ?? resolvedHub\n\n  /*\n   * The id is BUILT rather than interpolated, so a ref carrying a slash or a\n   * colon answers null here instead of naming a document in another\n   * collection. A null builder is how this hook is told not to read at all.\n   */\n  const attributionId = campaignConversionId(kind, refId)\n  const { data: record, status } = useFirestoreDoc<CampaignConversionRecord>(\n    () =>\n      attributionId\n        ? doc(\n            firestore,\n            'hosts',\n            hostId,\n            'campaignAttributions',\n            attributionId,\n          )\n        : null,\n    [firestore, hostId, attributionId],\n  )\n\n  /*\n   * An id that could not be built means the record's own id is unusable, so\n   * the question was never asked. Drawing the \"not credited\" sentence here\n   * would state a fact nothing checked — the one thing this component must\n   * not do — so it draws nothing.\n   */\n  if (!attributionId) return null\n\n  /*\n   * Nothing while the read settles. Rendering \"no campaign\" first and\n   * replacing it a tick later states the opposite of the truth for as long as\n   * the reader's eye takes to reach it, and this sits inside a dialog that\n   * opens with the read.\n   */\n  if (status === 'loading') return null\n\n  const campaignHref = (id: string | undefined) =>\n    marketingBasePath && id ? `${marketingBasePath}/campaigns/${id}` : undefined\n\n  /*\n   * FILED UNDER — the merchant's declaration, drawn first and under its own\n   * heading so it can never be read as the credit below it.\n   */\n  const filed = filedUnder.length ? (\n    <Stack spacing={0.5}>\n      <Typography variant=\"caption\" color=\"text.secondary\">\n        {'Filed under'}\n      </Typography>\n      <Stack direction=\"row\" spacing={1} useFlexGap sx={{ flexWrap: 'wrap' }}>\n        {filedUnder.map((id) => {\n          const href = campaignHref(id)\n          const name = <CampaignName orgId={orgId} id={id} of=\"container\" />\n          return href ? (\n            <AppLink key={id} href={href}>\n              {name}\n            </AppLink>\n          ) : (\n            <Typography key={id} variant=\"body2\">\n              {name}\n            </Typography>\n          )\n        })}\n      </Stack>\n    </Stack>\n  ) : null\n\n  if (!record) {\n    if (quiet && !filed) return null\n    return (\n      <Stack spacing={1}>\n        <Typography variant=\"overline\" color=\"text.secondary\">\n          {'Campaign'}\n        </Typography>\n        {filed}\n        {quiet ? null : (\n          <Stack spacing={0.5}>\n            {filed ? (\n              <Typography variant=\"caption\" color=\"text.secondary\">\n                {'Credited to'}\n              </Typography>\n            ) : null}\n            {/*\n              NOT a zero, and not an empty campaign chip. The sentence says\n              which fact this is: nobody was credited, and nothing was guessed.\n             */}\n            <Typography variant=\"body2\" color=\"text.secondary\">\n              {'Not credited to a campaign — this arrived directly, or from a ' +\n                'link that carried no campaign, and no page filed under a ' +\n                'campaign was viewed before it. Nothing is inferred from a ' +\n                'referrer and no campaign is credited for being the most ' +\n                'recent one to run.'}\n            </Typography>\n          </Stack>\n        )}\n      </Stack>\n    )\n  }\n\n  const label = campaignTouchLabel(record)\n  const converted = Number(record.convertedAtMs ?? 0)\n  const chip = channelChip(record)\n  const creditedHref = chip.linked ? campaignHref(record.campaignId) : undefined\n  const creditedName =\n    chip.linked && record.campaignId ? (\n      <CampaignName\n        orgId={orgId}\n        id={record.campaignId}\n        of={record.channel === 'email' ? 'send' : 'container'}\n      />\n    ) : null\n\n  return (\n    <Stack spacing={1}>\n      <Typography variant=\"overline\" color=\"text.secondary\">\n        {'Campaign'}\n      </Typography>\n      {filed}\n      <Stack spacing={0.5}>\n        {filed ? (\n          <Typography variant=\"caption\" color=\"text.secondary\">\n            {'Credited to'}\n          </Typography>\n        ) : null}\n        <Stack\n          direction=\"row\"\n          spacing={1}\n          useFlexGap\n          sx={{ alignItems: 'center', flexWrap: 'wrap' }}\n        >\n          {/*\n            The CHANNEL is on screen beside the label, because the two are\n            read differently: one names a campaign whose report can be opened,\n            the other names text somebody typed into a URL.\n           */}\n          <Chip\n            size=\"small\"\n            color={chip.linked ? 'primary' : 'default'}\n            variant={chip.linked ? 'filled' : 'outlined'}\n            label={chip.label}\n          />\n          {creditedHref ? (\n            <AppLink href={creditedHref}>{creditedName}</AppLink>\n          ) : creditedName ? (\n            <Typography variant=\"body2\" sx={{ fontWeight: 'bold' }}>\n              {creditedName}\n            </Typography>\n          ) : (\n            <Typography variant=\"body2\" sx={{ fontWeight: 'bold' }}>\n              {label || 'unnamed'}\n            </Typography>\n          )}\n          {/* A declared label keeps its text beside the campaign it names. */}\n          {record.channel === 'web' && record.campaignId && label ? (\n            <Typography variant=\"caption\" color=\"text.secondary\">\n              {label}\n            </Typography>\n          ) : null}\n        </Stack>\n        {/*\n          THE RULE, under the claim. A credit whose rule the reader cannot\n          state is a credit they will use anyway, and the two things they\n          need are which touch wins and how long one stays creditable.\n          `model` and `windowDays` come off the RECORD, so a conversion\n          credited under an older rule prints the rule it was credited under.\n         */}\n        <Typography variant=\"caption\" color=\"text.secondary\">\n          {touchSentence(record) +\n            (converted ? `, converted ${new Date(converted).toLocaleString()}` : '') +\n            '. ' +\n            campaignCreditRule(record.model, record.windowDays)}\n        </Typography>\n      </Stack>\n    </Stack>\n  )\n}\nConversionAttribution.displayName = 'ConversionAttribution'\n\nexport default ConversionAttribution\n"],"names":["AppLink","Chip","Stack","Typography","doc","useFirestore","useFirestoreDoc","useMarketingHubPath","useMarketingOrgId","campaignContainerDoc","campaignSendDoc","campaignConversionId","campaignCreditRule","campaignTouchLabel","CampaignName","props","of","orgId","id","firestore","data","label","String","name","subject","trim","channelChip","record","channel","linked","campaignId","touchSentence","touched","Number","touchedAtMs","at","Date","toLocaleString","path","ConversionAttribution","hostId","kind","refId","quiet","filedUnder","resolvedHub","marketingBasePath","attributionId","status","campaignHref","undefined","filed","length","spacing","variant","color","direction","useFlexGap","sx","flexWrap","map","href","converted","convertedAtMs","chip","creditedHref","creditedName","alignItems","size","fontWeight","model","windowDays","displayName"],"mappings":"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"}

package/src/lib/components/email-compose-card.js

@@ -63,7 +63,7 @@ import { AppLink, CardDisplay } from "@aglyn/shared-ui-jsx";
 import { Button, Typography } from "@mui/material";
 import { useFirestore, useFirestoreDoc } from "@aglyn/tenant-feature-instance";
 import { useRouter } from "next/navigation";
-import { campaignHeldForReviewNotice, campaignSendDisplay, CAMPAIGN_SEND_CONTAINER_FIELD } from "@aglyn/shared-ui-email-campaigns/model/campaign-container";
+import { campaignHeldForReviewNotice, campaignSendDisplay, CAMPAIGN_SEND_CONTAINER_FIELD } from "../model/campaign-container.js";
 import CampaignComposer from "./campaign-composer.js";
 import { campaignSendDoc } from "./campaign-queries.js";
 import { useMarketingOrgId } from "./marketing-org-mount.js";

package/src/lib/components/email-compose-card.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/components/email-compose-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\n/**\n * WRITING ONE EMAIL — its own route, and its own card.\n *\n * ## Why it is not on the message's page\n *\n * `/emails/messages/{emailId}` answers \"what did this email do\": delivery,\n * engagement, every rate over its own denominator, the links that were\n * followed and who it reached. Writing the thing is a different job with a\n * different shape — a form, a preview, and one irreversible button — and\n * carrying both on one route made the reader of a report scroll past a\n * composer and the writer of an email scroll past a table of zeros.\n *\n * So the record's page reports, and `…/edit` writes. It is the grammar this\n * surface already reads by: an audience is `…/audiences/{listId}` and its\n * settings are `…/audiences/{listId}/edit`, and a screen's page and its\n * besigner are two addresses for the same reason. Creating is still a drawer\n * on the list — it collects the name, mints the record and routes here — so no\n * list on this surface carries a form above it.\n *\n * ## Why the card is HERE and not inside the composer\n *\n * The composer is also mounted inside the campaign detail card, which already\n * supplies a card of its own; a `CardDisplay` in the component would nest one\n * inside another there. The surface owns the chrome, exactly as `ListEditCard`\n * owns the chrome around the audience rule fields.\n *\n * ## What may be edited\n *\n * Only an email that is still unsent. The route enforces it too — `schedule`\n * and `draft` answer 409 on a sent or canceled record — and this is the same\n * refusal said before the merchant types rather than after they press Send. An\n * email PART WAY THROUGH a send is stored as `scheduled` between batches, so\n * the stored status alone would let somebody rewrite the copy of a message\n * that is already reaching inboxes; `campaignSendDisplay` is what tells the\n * two apart.\n *\n * ## The site it is written as\n *\n * The record is the org's; the composer is a site's — its senders, its\n * designs, its experiments. Under a site that is the site. On the org hub it\n * is the send's own `hostId`, and a send that names none is not opened for\n * writing there.\n */\n\nimport { pluginDocsHelp } from '@aglyn/aglyn'\nimport { AppLink, CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { Button, Typography } from '@mui/material'\nimport { useFirestore, useFirestoreDoc } from '@aglyn/tenant-feature-instance'\nimport { useRouter } from 'next/navigation'\nimport {\n  campaignHeldForReviewNotice,\n  campaignSendDisplay,\n  CAMPAIGN_SEND_CONTAINER_FIELD,\n} from '@aglyn/shared-ui-email-campaigns/model/campaign-container'\nimport CampaignComposer from './campaign-composer'\nimport { campaignSendDoc } from './campaign-queries'\nimport { useMarketingOrgId } from './marketing-org-mount'\n\nconst composeDocsHelp = pluginDocsHelp('emailCampaigns', {\n  anchor: '#send-a-campaign',\n  excerpt:\n    'Everything one email decides: who it goes to, how it is written, who ' +\n    'it appears to come from, and how many people it reaches.',\n})\n\nexport interface EmailComposeCardProps {\n  /** The site, or `null` on the organization's Emails page. */\n  hostId: string | null\n  /** The message document under `orgs/{orgId}/campaigns`. */\n  emailId: string\n  /**\n   * The Emails page's own URL, under the site or the organization, for the\n   * way back to the message's own page.\n   */\n  basePath: string\n}\n\nexport function EmailComposeCard(props: EmailComposeCardProps) {\n  const { emailId, basePath } = props\n  const firestore = useFirestore()\n  const router = useRouter()\n  const { orgId } = useMarketingOrgId(props.hostId)\n\n  const { data: email, status } = useFirestoreDoc<Record<string, any>>(\n    () => (orgId ? campaignSendDoc(firestore, orgId, emailId) : null),\n    [firestore, orgId, emailId],\n  )\n  /** The site this email is written as; see the file header. */\n  const hostId: string | null =\n    props.hostId ?? (email?.hostId ? String(email.hostId) : null)\n\n  const detailHref = `${basePath}/messages/${emailId}`\n  const headerActions = (\n    <Button\n      component={AppLink as any}\n      {...({ componentVariant: 'naked', nativeButton: false } as any)}\n      href={detailHref}\n      size=\"small\"\n      color=\"primary\"\n    >\n      {'Back to the email'}\n    </Button>\n  )\n\n  const subject = String(email?.subject ?? '')\n  const displayName = String(email?.displayName ?? '')\n  const state = String(email?.status ?? '')\n  const display = email ? campaignSendDisplay(email as never) : null\n  const editable =\n    (state === 'draft' || state === 'scheduled') &&\n    display?.state !== 'sending' &&\n    // A held send is written by nobody until staff decide (AGL-3356).\n    display?.state !== 'held'\n\n  /**\n   * Why this email cannot be written, in the words that say what to do next.\n   *\n   * Empty while it still can be. Each case is a different fact about the\n   * record and not a variation on \"no\": one has not loaded, one is in inboxes\n   * already, one is being delivered right now.\n   */\n  const refusal = !email\n    ? status === 'loading'\n      ? 'Loading this email…'\n      : 'This email could not be loaded. It may have been deleted.'\n    : !hostId\n      ? 'This email does not record which site it is sent as, so it can ' +\n        'only be written from that site’s own Emails page.'\n      : editable\n      ? ''\n      : display?.state === 'held'\n        ? campaignHeldForReviewNotice(email as never)\n      : display?.state === 'sending'\n        ? 'This email is being sent right now, so its message can no longer ' +\n          'be changed. Its page reports what it has reached so far.'\n        : state === 'sent'\n          ? 'This email has been sent, so its subject, message and audience ' +\n            'describe mail that is already in inboxes. Compose a new email ' +\n            'to say something else.'\n          : 'This email was canceled, so it can no longer be written or put ' +\n            'back on the schedule. Compose a new email.'\n\n  return (\n    <CardDisplay\n      header={subject || displayName || 'Untitled email'}\n      subheader={'Write this email'}\n      help={composeDocsHelp}\n      contentGutterX\n      contentGutterY\n      HeaderProps={{ action: headerActions }}\n    >\n      {refusal ? (\n        <Typography variant=\"body2\" color=\"text.secondary\">\n          {refusal}\n        </Typography>\n      ) : (\n        <CampaignComposer\n          hostId={hostId}\n          campaignId={emailId}\n          emailCampaignId={\n            email?.[CAMPAIGN_SEND_CONTAINER_FIELD]\n              ? String(email[CAMPAIGN_SEND_CONTAINER_FIELD])\n              : undefined\n          }\n          displayName={displayName || undefined}\n          initial={{\n            subject,\n            body: String(email?.body ?? ''),\n            fromName: String(email?.fromName ?? ''),\n            replyTo: String(email?.replyTo ?? ''),\n            /*\n             * The sender this email is set to go out as, so reopening a draft\n             * does not silently move it onto whichever sender has become the\n             * site's default since it was saved.\n             */\n            senderId: String(email?.senderId ?? ''),\n            preheader: String(email?.preheader ?? ''),\n            audience: String(email?.audience ?? ''),\n            listId: String(email?.listId ?? ''),\n            segmentId: String(email?.segmentId ?? ''),\n            topicId: String(email?.topicId ?? ''),\n            /*\n             * Which of the two ways this email is written. The composer\n             * resolves the mode from this field through the same function the\n             * send path reads, so a designed draft reopens designed.\n             */\n            templateScreenId: String(email?.templateScreenId ?? ''),\n            /*\n             * The plain-text half, and the design version it was written\n             * against. Absent means the design generates it — the composer\n             * reads that through the same resolver the record's shape is\n             * defined by, so a stale override is named rather than guessed at.\n             */\n            plainText: String(email?.plainText ?? ''),\n            plainTextVersionId: String(email?.plainTextVersionId ?? ''),\n          }}\n          /*\n           * A send or a schedule lands on the record, and the record's page is\n           * where its report will be — so the merchant is left looking at what\n           * they just did rather than at the form that did it.\n           */\n          onSent={() => router.push(detailHref)}\n        />\n      )}\n    </CardDisplay>\n  )\n}\nEmailComposeCard.displayName = 'EmailComposeCard'\n\nexport default EmailComposeCard\n"],"names":["pluginDocsHelp","AppLink","CardDisplay","Button","Typography","useFirestore","useFirestoreDoc","useRouter","campaignHeldForReviewNotice","campaignSendDisplay","CAMPAIGN_SEND_CONTAINER_FIELD","CampaignComposer","campaignSendDoc","useMarketingOrgId","composeDocsHelp","anchor","excerpt","EmailComposeCard","props","emailId","basePath","firestore","router","orgId","hostId","data","email","status","String","detailHref","headerActions","component","componentVariant","nativeButton","href","size","color","subject","displayName","state","display","editable","refusal","header","subheader","help","contentGutterX","contentGutterY","HeaderProps","action","variant","campaignId","emailCampaignId","undefined","initial","body","fromName","replyTo","senderId","preheader","audience","listId","segmentId","topicId","templateScreenId","plainText","plainTextVersionId","onSent","push"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/components/email-compose-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\n/**\n * WRITING ONE EMAIL — its own route, and its own card.\n *\n * ## Why it is not on the message's page\n *\n * `/emails/messages/{emailId}` answers \"what did this email do\": delivery,\n * engagement, every rate over its own denominator, the links that were\n * followed and who it reached. Writing the thing is a different job with a\n * different shape — a form, a preview, and one irreversible button — and\n * carrying both on one route made the reader of a report scroll past a\n * composer and the writer of an email scroll past a table of zeros.\n *\n * So the record's page reports, and `…/edit` writes. It is the grammar this\n * surface already reads by: an audience is `…/audiences/{listId}` and its\n * settings are `…/audiences/{listId}/edit`, and a screen's page and its\n * besigner are two addresses for the same reason. Creating is still a drawer\n * on the list — it collects the name, mints the record and routes here — so no\n * list on this surface carries a form above it.\n *\n * ## Why the card is HERE and not inside the composer\n *\n * The composer is also mounted inside the campaign detail card, which already\n * supplies a card of its own; a `CardDisplay` in the component would nest one\n * inside another there. The surface owns the chrome, exactly as `ListEditCard`\n * owns the chrome around the audience rule fields.\n *\n * ## What may be edited\n *\n * Only an email that is still unsent. The route enforces it too — `schedule`\n * and `draft` answer 409 on a sent or canceled record — and this is the same\n * refusal said before the merchant types rather than after they press Send. An\n * email PART WAY THROUGH a send is stored as `scheduled` between batches, so\n * the stored status alone would let somebody rewrite the copy of a message\n * that is already reaching inboxes; `campaignSendDisplay` is what tells the\n * two apart.\n *\n * ## The site it is written as\n *\n * The record is the org's; the composer is a site's — its senders, its\n * designs, its experiments. Under a site that is the site. On the org hub it\n * is the send's own `hostId`, and a send that names none is not opened for\n * writing there.\n */\n\nimport { pluginDocsHelp } from '@aglyn/aglyn'\nimport { AppLink, CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { Button, Typography } from '@mui/material'\nimport { useFirestore, useFirestoreDoc } from '@aglyn/tenant-feature-instance'\nimport { useRouter } from 'next/navigation'\nimport {\n  campaignHeldForReviewNotice,\n  campaignSendDisplay,\n  CAMPAIGN_SEND_CONTAINER_FIELD,\n} from '../model/campaign-container'\nimport CampaignComposer from './campaign-composer'\nimport { campaignSendDoc } from './campaign-queries'\nimport { useMarketingOrgId } from './marketing-org-mount'\n\nconst composeDocsHelp = pluginDocsHelp('emailCampaigns', {\n  anchor: '#send-a-campaign',\n  excerpt:\n    'Everything one email decides: who it goes to, how it is written, who ' +\n    'it appears to come from, and how many people it reaches.',\n})\n\nexport interface EmailComposeCardProps {\n  /** The site, or `null` on the organization's Emails page. */\n  hostId: string | null\n  /** The message document under `orgs/{orgId}/campaigns`. */\n  emailId: string\n  /**\n   * The Emails page's own URL, under the site or the organization, for the\n   * way back to the message's own page.\n   */\n  basePath: string\n}\n\nexport function EmailComposeCard(props: EmailComposeCardProps) {\n  const { emailId, basePath } = props\n  const firestore = useFirestore()\n  const router = useRouter()\n  const { orgId } = useMarketingOrgId(props.hostId)\n\n  const { data: email, status } = useFirestoreDoc<Record<string, any>>(\n    () => (orgId ? campaignSendDoc(firestore, orgId, emailId) : null),\n    [firestore, orgId, emailId],\n  )\n  /** The site this email is written as; see the file header. */\n  const hostId: string | null =\n    props.hostId ?? (email?.hostId ? String(email.hostId) : null)\n\n  const detailHref = `${basePath}/messages/${emailId}`\n  const headerActions = (\n    <Button\n      component={AppLink as any}\n      {...({ componentVariant: 'naked', nativeButton: false } as any)}\n      href={detailHref}\n      size=\"small\"\n      color=\"primary\"\n    >\n      {'Back to the email'}\n    </Button>\n  )\n\n  const subject = String(email?.subject ?? '')\n  const displayName = String(email?.displayName ?? '')\n  const state = String(email?.status ?? '')\n  const display = email ? campaignSendDisplay(email as never) : null\n  const editable =\n    (state === 'draft' || state === 'scheduled') &&\n    display?.state !== 'sending' &&\n    // A held send is written by nobody until staff decide (AGL-3356).\n    display?.state !== 'held'\n\n  /**\n   * Why this email cannot be written, in the words that say what to do next.\n   *\n   * Empty while it still can be. Each case is a different fact about the\n   * record and not a variation on \"no\": one has not loaded, one is in inboxes\n   * already, one is being delivered right now.\n   */\n  const refusal = !email\n    ? status === 'loading'\n      ? 'Loading this email…'\n      : 'This email could not be loaded. It may have been deleted.'\n    : !hostId\n      ? 'This email does not record which site it is sent as, so it can ' +\n        'only be written from that site’s own Emails page.'\n      : editable\n      ? ''\n      : display?.state === 'held'\n        ? campaignHeldForReviewNotice(email as never)\n      : display?.state === 'sending'\n        ? 'This email is being sent right now, so its message can no longer ' +\n          'be changed. Its page reports what it has reached so far.'\n        : state === 'sent'\n          ? 'This email has been sent, so its subject, message and audience ' +\n            'describe mail that is already in inboxes. Compose a new email ' +\n            'to say something else.'\n          : 'This email was canceled, so it can no longer be written or put ' +\n            'back on the schedule. Compose a new email.'\n\n  return (\n    <CardDisplay\n      header={subject || displayName || 'Untitled email'}\n      subheader={'Write this email'}\n      help={composeDocsHelp}\n      contentGutterX\n      contentGutterY\n      HeaderProps={{ action: headerActions }}\n    >\n      {refusal ? (\n        <Typography variant=\"body2\" color=\"text.secondary\">\n          {refusal}\n        </Typography>\n      ) : (\n        <CampaignComposer\n          hostId={hostId}\n          campaignId={emailId}\n          emailCampaignId={\n            email?.[CAMPAIGN_SEND_CONTAINER_FIELD]\n              ? String(email[CAMPAIGN_SEND_CONTAINER_FIELD])\n              : undefined\n          }\n          displayName={displayName || undefined}\n          initial={{\n            subject,\n            body: String(email?.body ?? ''),\n            fromName: String(email?.fromName ?? ''),\n            replyTo: String(email?.replyTo ?? ''),\n            /*\n             * The sender this email is set to go out as, so reopening a draft\n             * does not silently move it onto whichever sender has become the\n             * site's default since it was saved.\n             */\n            senderId: String(email?.senderId ?? ''),\n            preheader: String(email?.preheader ?? ''),\n            audience: String(email?.audience ?? ''),\n            listId: String(email?.listId ?? ''),\n            segmentId: String(email?.segmentId ?? ''),\n            topicId: String(email?.topicId ?? ''),\n            /*\n             * Which of the two ways this email is written. The composer\n             * resolves the mode from this field through the same function the\n             * send path reads, so a designed draft reopens designed.\n             */\n            templateScreenId: String(email?.templateScreenId ?? ''),\n            /*\n             * The plain-text half, and the design version it was written\n             * against. Absent means the design generates it — the composer\n             * reads that through the same resolver the record's shape is\n             * defined by, so a stale override is named rather than guessed at.\n             */\n            plainText: String(email?.plainText ?? ''),\n            plainTextVersionId: String(email?.plainTextVersionId ?? ''),\n          }}\n          /*\n           * A send or a schedule lands on the record, and the record's page is\n           * where its report will be — so the merchant is left looking at what\n           * they just did rather than at the form that did it.\n           */\n          onSent={() => router.push(detailHref)}\n        />\n      )}\n    </CardDisplay>\n  )\n}\nEmailComposeCard.displayName = 'EmailComposeCard'\n\nexport default EmailComposeCard\n"],"names":["pluginDocsHelp","AppLink","CardDisplay","Button","Typography","useFirestore","useFirestoreDoc","useRouter","campaignHeldForReviewNotice","campaignSendDisplay","CAMPAIGN_SEND_CONTAINER_FIELD","CampaignComposer","campaignSendDoc","useMarketingOrgId","composeDocsHelp","anchor","excerpt","EmailComposeCard","props","emailId","basePath","firestore","router","orgId","hostId","data","email","status","String","detailHref","headerActions","component","componentVariant","nativeButton","href","size","color","subject","displayName","state","display","editable","refusal","header","subheader","help","contentGutterX","contentGutterY","HeaderProps","action","variant","campaignId","emailCampaignId","undefined","initial","body","fromName","replyTo","senderId","preheader","audience","listId","segmentId","topicId","templateScreenId","plainText","plainTextVersionId","onSent","push"],"mappings":"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"}

package/src/lib/components/email-detail.js

@@ -28,9 +28,10 @@ import { Alert, Button, Chip, Divider, Stack, TableBody, TableCell, TableHead, T
 import { doc } from "firebase/firestore";
 import { useRouter } from "next/navigation";
 import { useCallback, useMemo, useState } from "react";
-import { campaignLinkReport, campaignReport } from "@aglyn/shared-ui-email-campaigns/model/campaign-report";
-import { campaignHeldForReviewNotice, campaignSendDisplay, CAMPAIGN_SEND_CONTAINER_FIELD } from "@aglyn/shared-ui-email-campaigns/model/campaign-container";
-import { emailAudienceLabel, emailIsUnsent, emailSendTimeMs, emailSentAs } from "@aglyn/shared-ui-email-campaigns/model/email-record";
+import { sendLinkReport } from "@aglyn/shared-ui-email-campaigns/model/send-report";
+import { campaignReport } from "../model/campaign-report.js";
+import { campaignHeldForReviewNotice, campaignSendDisplay, CAMPAIGN_SEND_CONTAINER_FIELD } from "../model/campaign-container.js";
+import { emailAudienceLabel, emailIsUnsent, emailSendTimeMs, emailSentAs } from "../model/email-record.js";
 import { emailPlainTextState } from "@aglyn/aglyn/app-utils/recipient-email-render";
 import { useMarketingHubPath } from "./use-marketing-hub-path.js";
 import { siteRecordRouteContext, useRecordRouteContext } from "./record-route-context.js";
@@ -155,7 +156,7 @@ const emailDocsHelp = pluginDocsHelp('emailCampaigns', {
     const report = useMemo(()=>campaignReport(email == null ? void 0 : email.stats), [
         email
     ]);
-    const linkReport = useMemo(()=>campaignLinkReport(links), [
+    const linkReport = useMemo(()=>sendLinkReport(links), [
         links
     ]);
     const subject = String((email == null ? void 0 : email.subject) || 'Untitled email');