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

package/src/lib/model/email-record.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/model/email-record.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * READING ONE MESSAGE RECORD.\n *\n * A message — an email that was or will be sent — is a document under\n * `hosts/{hostId}/campaigns`. Two facts about that document are awkward\n * enough that every surface reading it gets them wrong the same way, so they\n * are decided here once.\n */\n\n/**\n * When a message went out, or is due to.\n *\n * **There is no one SEND date field.** The send path writes `{status:'sent',\n * sentAt}` from one branch and `{status:'scheduled', sendAtMs}` from another.\n * So a list ordered on either field in Firestore does not mis-sort —\n * `orderBy` DROPS every document missing the ordered field — and half the\n * messages simply vanish. Sorting on this instead keeps both kinds in one\n * ordered list.\n *\n * `sentAt` is a Firestore `Timestamp`, which the client SDK gives as an\n * object with `seconds` and `toMillis()`; a document read from cache while a\n * write is pending can carry a sentinel with neither, which reads as 0 and\n * sorts last rather than throwing.\n *\n * A DRAFT correctly answers 0 here: it has no send time, and inventing one\n * from its creation would put an unsent message on the timeline of mail that\n * went out. Ordering a list is {@link emailListTimeMs}'s job.\n *\n * @returns epoch ms, or 0 when the message has no time at all.\n */\nexport function emailSendTimeMs(\n  record: Record<string, any> | null | undefined,\n): number {\n  // A send held for staff review is parked at a time no run reaches\n  // (AGL-3356). That is a mechanism, not a send time, and printed it reads as\n  // the year 9999 — so a held send answers \"no time\", like a draft, and the\n  // lists order it by when it was created.\n  if (\n    record?.['staffReview']?.['state'] === 'held' &&\n    String(record?.['status'] ?? '') === 'scheduled'\n  ) {\n    return 0\n  }\n  const sentAt = record?.['sentAt'] as\n    | { toMillis?: () => number; seconds?: number }\n    | undefined\n  if (typeof sentAt?.toMillis === 'function') return sentAt.toMillis()\n  if (typeof sentAt?.seconds === 'number') return sentAt.seconds * 1000\n  const scheduled = Number(record?.['sendAtMs'] ?? 0)\n  return Number.isFinite(scheduled) ? scheduled : 0\n}\n\n/**\n * The field every writer of a message stamps when it MINTS the document.\n *\n * The one date on every message, which is what neither `sentAt` nor\n * `sendAtMs` is — each is written by one branch of the send path and neither\n * is on both kinds. A field carried by every record is the precondition for\n * ordering this collection in Firestore rather than in the browser, because\n * `orderBy` drops documents that lack the ordered field instead of\n * mis-sorting them.\n *\n * Epoch milliseconds rather than a `Timestamp`, matching `sendAtMs` beside\n * it: the two are compared against each other on every list that draws\n * drafts and sends together, and a comparison that has to unwrap one side\n * first is a comparison somebody writes wrong.\n */\nexport const EMAIL_CREATED_AT_FIELD = 'createdAtMs'\n\n/**\n * When a message was created, for the records that carry it.\n *\n * `null` — not 0 — for a record carrying no {@link EMAIL_CREATED_AT_FIELD},\n * because 0 is a real instant at the far end of the sort and \"we do not know\"\n * is not \"1970\". A null orders by the record's send time instead, so the list\n * is correct for a record from any era.\n */\nexport function emailCreatedAtMs(\n  record: Record<string, any> | null | undefined,\n): number | null {\n  const created = Number(record?.[EMAIL_CREATED_AT_FIELD] ?? Number.NaN)\n  return Number.isFinite(created) && created > 0 ? created : null\n}\n\n/**\n * WHERE A MESSAGE SITS IN A LIST OF MESSAGES.\n *\n * Its send time where it has one, and its creation time where it does not.\n *\n * A draft has neither `sentAt` nor `sendAtMs`, so ordering a list on the send\n * time alone gives every draft the key 0 and files it below mail sent years\n * ago — the newest thing a merchant did, at the bottom of the page, behind\n * whatever paging the list has. Falling back to creation puts it where the\n * merchant left it.\n *\n * The fallback is deliberately not the other way round. A SENT message orders\n * by when it went out, never by when it was drafted: the list is a record of\n * what happened, and a message drafted in March and sent in June belongs in\n * June.\n *\n * @returns epoch ms, or 0 for a record with no time of any kind — a draft\n *   written before the created stamp existed, which sorts last exactly as it\n *   did before.\n */\nexport function emailListTimeMs(\n  record: Record<string, any> | null | undefined,\n): number {\n  return emailSendTimeMs(record) || emailCreatedAtMs(record) || 0\n}\n\n/**\n * Reader-facing text for a message's state.\n *\n * The KEYS are persisted values written by the send path and read by the\n * scheduled-campaign processor — nothing here may change them, including\n * `canceled`, which is already the American spelling and is a stored enum in\n * either case. Only the right-hand side is display text, and an unrecognized\n * state falls through as itself rather than being flattened into one of\n * these: a state this list cannot name is worth seeing.\n *\n * `draft` is an email that has been created and not sent. `sending` is the\n * claim the scheduled processor and the send-now route both take before they\n * mail, and it is named here because a merchant who reloads mid-send would\n * otherwise be shown the raw token.\n *\n * ⚠️ **Not what a console row should draw.** This names the STORED value, and\n * an email delivering an audience larger than one batch is stored as\n * `scheduled` between runs — so a row rendering this says \"Scheduled\" about a\n * send that has already put five hundred messages in five hundred inboxes.\n * `campaignSendDisplay` in `campaign-container.ts` reads the counters beside\n * the status and is what every surface here draws. This remains the honest\n * answer to the narrower question of what one stored token means.\n */\nexport function emailStateLabel(status: unknown): string {\n  const value = String(status ?? '')\n  if (value === 'sent') return 'Sent'\n  if (value === 'scheduled') return 'Scheduled'\n  if (value === 'canceled') return 'Canceled'\n  if (value === 'draft') return 'Draft'\n  if (value === 'sending') return 'Sending'\n  return value || 'Unknown'\n}\n\n/**\n * Whether an email has yet been mailed to anybody.\n *\n * The surfaces that report on a send need this because an unsent email has no\n * `stats` at all, and a report that divides into an absent denominator\n * presents \"not sent yet\" as a delivery rate of 0% — the same class of fault\n * as a rate rendered over a denominator it does not name.\n */\nexport function emailIsUnsent(\n  record: Record<string, any> | null | undefined,\n): boolean {\n  const value = String(record?.['status'] ?? '')\n  return value === 'draft' || value === 'scheduled' || value === 'sending'\n}\n\n/**\n * Reader-facing names for the built-in audience kinds.\n *\n * The KEYS are the persisted `audience` values written on every message since\n * the composer shipped; only the values on the right are display text. A\n * `list` audience is deliberately absent — it is not a kind of audience, it\n * is a NAMED one, and naming it is {@link emailAudienceLabel}'s job.\n */\nexport const EMAIL_AUDIENCE_LABELS: Record<string, string> = {\n  leads: 'All leads',\n  members: 'All site members',\n  segment: 'A contact segment',\n  manual: 'Addresses typed into the composer',\n}\n\n/**\n * Which audience a message went to, named for a reader.\n *\n * A list send is named by the name the SEND recorded, never by the name the\n * list carries today: resolving it now would let a rename rewrite the history\n * of a message that went out months ago, and a deletion erase it. A send that\n * recorded no name says so instead of printing a document id, which is not\n * something a merchant recognises as a list.\n */\nexport function emailAudienceLabel(\n  record: Record<string, any> | null | undefined,\n): string {\n  const audience = String(record?.['audience'] ?? '')\n  if (audience !== 'list') {\n    return EMAIL_AUDIENCE_LABELS[audience] ?? audience ?? 'Not recorded'\n  }\n  const name = String(record?.['listName'] ?? '')\n  if (name) return name\n  return record?.['listId']\n    ? 'A list this send did not name'\n    : 'A list this send did not record'\n}\n\n/**\n * The sender a message actually left with, as this record has it.\n *\n * `recorded` is the whole point of the shape. The address a send goes out on\n * is stamped by the send — see `sentAsStamp` — and every message sent before\n * that stamp existed carries nothing, so a surface has to be able to tell an\n * unrecorded sender apart from one it could compose. Composing it is the\n * thing that must not happen: a site's sending identity is a setting, and\n * resolving it now would answer \"what would this send as today\" on a report\n * whose subject is a message that went out months ago, under whatever address\n * the site held then.\n *\n * The same rule {@link emailAudienceLabel} follows for a list name, and for\n * the same reason: the report says what happened, not what would happen now.\n *\n * `replyTo` is null on a message that set none, which is not missing\n * information — a message with no `Reply-To:` takes replies at its `from`,\n * and that is a fact the record states by omission rather than one it lost.\n * The difference only reads correctly when `recorded` is true, which is why\n * a caller must consult that first.\n */\nexport interface EmailSentAs {\n  /** False on a message sent before the send began stamping its sender. */\n  recorded: boolean\n  from: string | null\n  /** The display name recipients saw, or null when the address stood alone. */\n  fromName: string | null\n  /** Where replies were pointed, or null when they go to `from`. */\n  replyTo: string | null\n}\n\nexport function emailSentAs(\n  record: Record<string, any> | null | undefined,\n): EmailSentAs {\n  const stamp = record?.['sentAs'] as Record<string, any> | null | undefined\n  const from = String(stamp?.['from'] ?? '').trim()\n  // The ADDRESS is what makes the stamp a record of a send. A `sentAs` map\n  // carrying only a display name is a partial write, and reporting it as\n  // recorded would put a name on screen beside an address nothing supplied.\n  if (!from) {\n    return { recorded: false, from: null, fromName: null, replyTo: null }\n  }\n  return {\n    recorded: true,\n    from,\n    fromName: String(stamp?.['fromName'] ?? '').trim() || null,\n    replyTo: String(stamp?.['replyTo'] ?? '').trim() || null,\n  }\n}\n"],"names":["emailSendTimeMs","record","String","sentAt","toMillis","seconds","scheduled","Number","isFinite","EMAIL_CREATED_AT_FIELD","emailCreatedAtMs","created","NaN","emailListTimeMs","emailStateLabel","status","value","emailIsUnsent","EMAIL_AUDIENCE_LABELS","leads","members","segment","manual","emailAudienceLabel","audience","name","emailSentAs","stamp","from","trim","recorded","fromName","replyTo"],"mappings":"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"}

package/src/lib/model/site-contract.d.ts

@@ -20,7 +20,7 @@
  * reads back. Pure types — shared by the /server graph and the client
  * runtime without pulling either's dependencies.
  */
-import type { HostActionStep, SiteEventType } from '@aglyn/aglyn';
+import type { ClientInteractionStep, SiteEventType } from '@aglyn/aglyn';
 import type { ExperimentStatus } from './experiments';
 export interface ClientAutomation {
     id: string;
@@ -35,7 +35,7 @@ export interface ClientAutomation {
     cooldownMinutes?: number;
     /** Fire on every occurrence, not once per pageview (AGL-562). */
     everyTime?: boolean;
-    steps: HostActionStep[];
+    steps: ClientInteractionStep[];
     hasServerSteps: boolean;
 }
 export interface ScreenExperiment {

package/src/lib/model/site-contract.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/model/site-contract.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * The marketing plugin's site wire contract (AGL-419): shapes its server\n * page-enricher writes into the page props and its client site-runtime\n * reads back. Pure types — shared by the /server graph and the client\n * runtime without pulling either's dependencies.\n */\n\nimport type { HostActionStep, SiteEventType } from '@aglyn/aglyn'\nimport type { ExperimentStatus } from './experiments'\n\nexport interface ClientAutomation {\n  id: string\n  event: SiteEventType\n  selector?: string\n  threshold?: number\n  /** Fire at most once per visitor (AGL-266). */\n  oncePerVisitor?: boolean\n  /** Fire at most once per browser session (AGL-274). */\n  oncePerSession?: boolean\n  /** Minimum minutes between fires for the same visitor (AGL-274). */\n  cooldownMinutes?: number\n  /** Fire on every occurrence, not once per pageview (AGL-562). */\n  everyTime?: boolean\n  steps: HostActionStep[]\n  hasServerSteps: boolean\n}\n\nexport interface ScreenExperiment {\n  id: string\n  target: 'screen' | 'section'\n  status: ExperimentStatus\n  nodeId?: string\n  winnerVariantId?: string\n  /** Past this the client runner serves the default (AGL-273). */\n  endAtMs?: number\n  goal?: { event: string; filter?: string }\n  variants: Array<{ id: string; weight?: number; versionId?: string }>\n  payloads: Record<string, Record<string, any> | null>\n}\n\nexport interface AnnouncementBarData {\n  text: string\n  href?: string\n  backgroundColor?: string\n  textColor?: string\n  dismissible: boolean\n  contentHash: string\n  overlayId?: string\n}\n\nexport interface PopupData {\n  headline?: string\n  body: string\n  imageUrl?: string\n  /**\n   * Alt text for {@link imageUrl} (AGL-1896).\n   *\n   * The popup image used to render with a hardcoded `alt=\"\"` and there was\n   * no field anywhere that could have changed it — an author-chosen banner,\n   * on a paying customer's published site, invisible to a screen reader by\n   * construction. Defaults from the DAM asset's own alt when the author\n   * picks one through \"Browse media\"; an empty value still renders `alt=\"\"`,\n   * which is the right markup for a genuinely decorative banner.\n   */\n  imageAlt?: string\n  ctaLabel?: string\n  ctaHref?: string\n  trigger: string\n  triggerValue: number\n  frequencyDays: number\n  /**\n   * Cap the popup to one showing per browser session (AGL-2174). When\n   * set, `frequencyDays` is not consulted — the two are alternative\n   * answers to the same question.\n   */\n  oncePerSession?: boolean\n  collectEmail?: boolean\n  startAtMs?: number\n  endAtMs?: number\n  contentHash: string\n  overlayId?: string\n}\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;CAKC,GA6CD,WA+BC"}
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/model/site-contract.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * The marketing plugin's site wire contract (AGL-419): shapes its server\n * page-enricher writes into the page props and its client site-runtime\n * reads back. Pure types — shared by the /server graph and the client\n * runtime without pulling either's dependencies.\n */\n\nimport type { ClientInteractionStep, SiteEventType } from '@aglyn/aglyn'\nimport type { ExperimentStatus } from './experiments'\n\nexport interface ClientAutomation {\n  id: string\n  event: SiteEventType\n  selector?: string\n  threshold?: number\n  /** Fire at most once per visitor (AGL-266). */\n  oncePerVisitor?: boolean\n  /** Fire at most once per browser session (AGL-274). */\n  oncePerSession?: boolean\n  /** Minimum minutes between fires for the same visitor (AGL-274). */\n  cooldownMinutes?: number\n  /** Fire on every occurrence, not once per pageview (AGL-562). */\n  everyTime?: boolean\n  steps: ClientInteractionStep[]\n  hasServerSteps: boolean\n}\n\nexport interface ScreenExperiment {\n  id: string\n  target: 'screen' | 'section'\n  status: ExperimentStatus\n  nodeId?: string\n  winnerVariantId?: string\n  /** Past this the client runner serves the default (AGL-273). */\n  endAtMs?: number\n  goal?: { event: string; filter?: string }\n  variants: Array<{ id: string; weight?: number; versionId?: string }>\n  payloads: Record<string, Record<string, any> | null>\n}\n\nexport interface AnnouncementBarData {\n  text: string\n  href?: string\n  backgroundColor?: string\n  textColor?: string\n  dismissible: boolean\n  contentHash: string\n  overlayId?: string\n}\n\nexport interface PopupData {\n  headline?: string\n  body: string\n  imageUrl?: string\n  /**\n   * Alt text for {@link imageUrl} (AGL-1896).\n   *\n   * The popup image used to render with a hardcoded `alt=\"\"` and there was\n   * no field anywhere that could have changed it — an author-chosen banner,\n   * on a paying customer's published site, invisible to a screen reader by\n   * construction. Defaults from the DAM asset's own alt when the author\n   * picks one through \"Browse media\"; an empty value still renders `alt=\"\"`,\n   * which is the right markup for a genuinely decorative banner.\n   */\n  imageAlt?: string\n  ctaLabel?: string\n  ctaHref?: string\n  trigger: string\n  triggerValue: number\n  frequencyDays: number\n  /**\n   * Cap the popup to one showing per browser session (AGL-2174). When\n   * set, `frequencyDays` is not consulted — the two are alternative\n   * answers to the same question.\n   */\n  oncePerSession?: boolean\n  collectEmail?: boolean\n  startAtMs?: number\n  endAtMs?: number\n  contentHash: string\n  overlayId?: string\n}\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;CAKC,GA6CD,WA+BC"}

package/src/lib/model/template-report.d.ts

@@ -0,0 +1,158 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * ONE DESIGN, MEASURED ACROSS EVERY CAMPAIGN THAT USED IT.
+ *
+ * ## What this adds to `campaign-report.ts`
+ *
+ * A campaign report divides two numbers that were recorded by the same send.
+ * A design report divides two SUMS, and a sum has a membership: which
+ * campaigns went into it. That is the whole difficulty, and it is a new way
+ * for the repo's rule — every rate names its denominator — to be broken.
+ *
+ * ## The rule, restated for a sum
+ *
+ * **A rate's numerator and its denominator are summed over the SAME set of
+ * campaigns, and the screen is told how large that set is.**
+ *
+ * `delivered` is written only by the delivery webhook, so a design used by
+ * five campaigns may have three that recorded it and two that never did.
+ * Summing `uniqueOpens` over all five and dividing by `delivered` summed over
+ * three produces an open rate that can exceed 100% and is, in every case,
+ * the flattering substitution `campaign-report.ts` exists to refuse — carried
+ * out by addition instead of by picking the wrong field.
+ *
+ * So each rate here is built from a FILTERED subset, and
+ * {@link TemplateRate.denominatorLabel} names the subset as well as the
+ * quantity: `delivered across 3 of 5 campaigns`. A reader comparing this
+ * design's open rate with another's can see the two were taken over different
+ * populations without being told separately.
+ *
+ * ## Counts are over everything; rates are over what can be divided
+ *
+ * The COUNTS — opens, clicks, unsubscribes — are summed over every campaign,
+ * because a count is true whatever else was recorded. Only the rates narrow.
+ * The two are labelled differently on screen for that reason, and the caveats
+ * say how many campaigns each rate left out.
+ *
+ * ## Why this is a pure module
+ *
+ * Same reason as `campaign-report.ts`: a division written in JSX is a
+ * denominator chosen by whoever writes the next card. Here it is worse — the
+ * subset is invisible in the output unless something carries it — so the
+ * subset is data, computed once, and the screen renders it.
+ */
+import { type SendRate, type SendStats } from '@aglyn/shared-ui-email-campaigns/model/send-report';
+/** A rate over a sum, carrying how many campaigns the sum covers. */
+export type TemplateRate = SendRate;
+/**
+ * One campaign that used the design, as the report reads it.
+ *
+ * `sentAtMs` is nullable because a campaign document can exist without ever
+ * having been sent — a scheduled campaign holds `sendAtMs` and no `sentAt`.
+ * Those carry no engagement and the reader is shown their status rather than
+ * a row of zeroes.
+ */
+export interface TemplateCampaign {
+    campaignId: string;
+    subject: string;
+    /** Epoch ms, or null for a campaign that has not been sent. */
+    sentAtMs: number | null;
+    /** `'sent'`, `'scheduled'`, `'canceled'`. A persisted value; not relabeled. */
+    status: string;
+    /** The audience KIND — `'leads'`, `'members'`, `'segment'`, `'list'`. */
+    audience: string;
+    /** Set when `audience` is `'list'`. */
+    listId?: string;
+    /** The list's name AS IT WAS at send time, when the send recorded one. */
+    listName?: string;
+    stats: SendStats | undefined;
+}
+/**
+ * One audience the design was sent to.
+ *
+ * A LIST is named by the name the send recorded, not by the name the list
+ * carries today: a renamed or deleted list would otherwise rewrite the
+ * history of a campaign that went out months ago, and a deleted one would
+ * erase it. The same reasoning as the campaign report's populations.
+ */
+export interface TemplateAudience {
+    /** Stable key — the list id, or the audience kind for the built-ins. */
+    id: string;
+    label: string;
+    /** How many campaigns using this design went to this audience. */
+    campaigns: number;
+    /** Addresses those campaigns ADDRESSED, summed. */
+    addressed: number;
+    /**
+     * The named list has since been deleted or renamed out of reach.
+     *
+     * Only ever true for a `list` audience, and only when the send recorded no
+     * name — an older send, before the name was stored. The screen says "list
+     * no longer named" rather than printing a raw document id as if it were
+     * something a merchant would recognise.
+     */
+    unnamed?: boolean;
+}
+/** Why a number the design report would otherwise show is being withheld. */
+export interface TemplateCaveat {
+    id: 'no-campaigns' | 'delivery-partial' | 'click-tracking-partial' | 'campaigns-truncated' | 'audience-truncated';
+    message: string;
+}
+/** Everything the design report screen renders. */
+export interface TemplateReport {
+    /** Campaigns that used this design AND were sent. */
+    sentCampaigns: number;
+    /** Campaigns that used this design, sent or not. */
+    totalCampaigns: number;
+    /** Epoch ms of the most recent send, or null. */
+    lastSentAtMs: number | null;
+    recipients: number;
+    sent: number;
+    /** Summed over the campaigns that recorded it; null when none did. */
+    delivered: number | null;
+    opens: number;
+    clicks: number;
+    uniqueOpens: number | null;
+    uniqueClicks: number | null;
+    bounced: number;
+    complained: number;
+    unsubscribes: number;
+    /** Rates, each `null` when its denominator is zero or unrecorded. */
+    rates: {
+        delivery: TemplateRate | null;
+        open: TemplateRate | null;
+        click: TemplateRate | null;
+        clickToOpen: TemplateRate | null;
+        bounce: TemplateRate | null;
+        complaint: TemplateRate | null;
+        unsubscribe: TemplateRate | null;
+    };
+    audiences: TemplateAudience[];
+    caveats: TemplateCaveat[];
+}
+/**
+ * Aggregates every campaign that used one design.
+ *
+ * @param campaigns every campaign document naming this design, sent or not.
+ * @param truncated the query that produced `campaigns` stopped at its read
+ *        ceiling, so every total here is a FLOOR. Reported as a caveat rather
+ *        than hidden, on the same reasoning as `audienceSizeTruncated`: a
+ *        figure that is at least this large is useful, and a figure presented
+ *        as complete when it is not is worse than none.
+ */
+export declare function templateReport(campaigns: readonly TemplateCampaign[], truncated?: boolean): TemplateReport;

package/src/lib/model/template-report.js

@@ -0,0 +1,249 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * ONE DESIGN, MEASURED ACROSS EVERY CAMPAIGN THAT USED IT.
+ *
+ * ## What this adds to `campaign-report.ts`
+ *
+ * A campaign report divides two numbers that were recorded by the same send.
+ * A design report divides two SUMS, and a sum has a membership: which
+ * campaigns went into it. That is the whole difficulty, and it is a new way
+ * for the repo's rule — every rate names its denominator — to be broken.
+ *
+ * ## The rule, restated for a sum
+ *
+ * **A rate's numerator and its denominator are summed over the SAME set of
+ * campaigns, and the screen is told how large that set is.**
+ *
+ * `delivered` is written only by the delivery webhook, so a design used by
+ * five campaigns may have three that recorded it and two that never did.
+ * Summing `uniqueOpens` over all five and dividing by `delivered` summed over
+ * three produces an open rate that can exceed 100% and is, in every case,
+ * the flattering substitution `campaign-report.ts` exists to refuse — carried
+ * out by addition instead of by picking the wrong field.
+ *
+ * So each rate here is built from a FILTERED subset, and
+ * {@link TemplateRate.denominatorLabel} names the subset as well as the
+ * quantity: `delivered across 3 of 5 campaigns`. A reader comparing this
+ * design's open rate with another's can see the two were taken over different
+ * populations without being told separately.
+ *
+ * ## Counts are over everything; rates are over what can be divided
+ *
+ * The COUNTS — opens, clicks, unsubscribes — are summed over every campaign,
+ * because a count is true whatever else was recorded. Only the rates narrow.
+ * The two are labelled differently on screen for that reason, and the caveats
+ * say how many campaigns each rate left out.
+ *
+ * ## Why this is a pure module
+ *
+ * Same reason as `campaign-report.ts`: a division written in JSX is a
+ * denominator chosen by whoever writes the next card. Here it is worse — the
+ * subset is invisible in the output unless something carries it — so the
+ * subset is data, computed once, and the screen renders it.
+ */ import { sendRate } from "@aglyn/shared-ui-email-campaigns/model/send-report";
+import { emailAudienceLabel } from "./email-record.js";
+/** A campaign that actually went out. The only kind engagement can describe. */ function wasSent(campaign) {
+    return campaign.sentAtMs !== null;
+}
+/** Sums one stats field over a set of campaigns, defaulting absent to zero. */ function total(campaigns, field) {
+    return campaigns.reduce((running, campaign)=>{
+        var _ref;
+        var _campaign_stats;
+        return running + Number((_ref = (_campaign_stats = campaign.stats) == null ? void 0 : _campaign_stats[field]) != null ? _ref : 0);
+    }, 0);
+}
+/**
+ * `${quantity} across N of M campaigns` — the denominator label for a sum.
+ *
+ * The `of M` half is what makes a narrowed rate readable. `delivered across 3
+ * campaigns` is true and still invites the reader to assume the design has
+ * three; `across 3 of 5` says on its face that two are missing from this
+ * number and not from the counts above it.
+ */ function acrossLabel(quantity, covered, all) {
+    return covered === all ? `${quantity} across ${covered} ${covered === 1 ? 'campaign' : 'campaigns'}` : `${quantity} across ${covered} of ${all} campaigns`;
+}
+/**
+ * Aggregates every campaign that used one design.
+ *
+ * @param campaigns every campaign document naming this design, sent or not.
+ * @param truncated the query that produced `campaigns` stopped at its read
+ *        ceiling, so every total here is a FLOOR. Reported as a caveat rather
+ *        than hidden, on the same reasoning as `audienceSizeTruncated`: a
+ *        figure that is at least this large is useful, and a figure presented
+ *        as complete when it is not is worse than none.
+ */ export function templateReport(campaigns, truncated = false) {
+    const sentCampaigns = campaigns.filter(wasSent);
+    const all = sentCampaigns.length;
+    /*
+   * THE SUBSETS. Each rate divides sums taken over one of these and nothing
+   * else, which is what makes the numerator and denominator describe the same
+   * population — see this module's header.
+   */ const withDelivery = sentCampaigns.filter((campaign)=>{
+        var _campaign_stats;
+        return ((_campaign_stats = campaign.stats) == null ? void 0 : _campaign_stats.delivered) !== undefined;
+    });
+    const withUniqueOpens = withDelivery.filter((campaign)=>{
+        var _campaign_stats;
+        return ((_campaign_stats = campaign.stats) == null ? void 0 : _campaign_stats.uniqueOpens) !== undefined;
+    });
+    /*
+   * Click rates need BOTH a delivery denominator and the record that the send
+   * carried an HTML part. A send with no HTML part reports zero clicks
+   * whatever recipients did, so including it in a click rate's denominator
+   * drags the rate down by however many untrackable sends this design has —
+   * a measurement of our own sending code presented as a measurement of the
+   * audience. `campaign-report.ts` refuses the same substitution for one
+   * campaign; a sum must refuse it per campaign, not for the design as a
+   * whole, or one old send would withhold the design's whole click rate.
+   */ const withClickTracking = withDelivery.filter((campaign)=>{
+        var _campaign_stats, _campaign_stats1;
+        return ((_campaign_stats = campaign.stats) == null ? void 0 : _campaign_stats.clickTracked) === true && ((_campaign_stats1 = campaign.stats) == null ? void 0 : _campaign_stats1.uniqueClicks) !== undefined;
+    });
+    const withOpenersAndClicks = withClickTracking.filter((campaign)=>{
+        var _campaign_stats;
+        return ((_campaign_stats = campaign.stats) == null ? void 0 : _campaign_stats.uniqueOpens) !== undefined;
+    });
+    const sent = total(sentCampaigns, 'sent');
+    const delivered = withDelivery.length ? total(withDelivery, 'delivered') : null;
+    const uniqueOpens = withUniqueOpens.length ? total(withUniqueOpens, 'uniqueOpens') : null;
+    const uniqueClicks = withClickTracking.length ? total(withClickTracking, 'uniqueClicks') : null;
+    const rates = {
+        /*
+     * Over the campaigns that recorded a delivery, and `sent` summed over
+     * those SAME campaigns rather than over all of them. The alternative —
+     * delivered over the design's whole `sent` — reads as a delivery failure
+     * proportional to how many of this design's sends predate the webhook.
+     */ delivery: delivered === null ? null : sendRate(delivered, total(withDelivery, 'sent'), acrossLabel('sent', withDelivery.length, all)),
+        open: sendRate(uniqueOpens != null ? uniqueOpens : undefined, withUniqueOpens.length ? total(withUniqueOpens, 'delivered') : undefined, acrossLabel('delivered', withUniqueOpens.length, all)),
+        click: sendRate(uniqueClicks != null ? uniqueClicks : undefined, withClickTracking.length ? total(withClickTracking, 'delivered') : undefined, acrossLabel('delivered', withClickTracking.length, all)),
+        clickToOpen: sendRate(withOpenersAndClicks.length ? total(withOpenersAndClicks, 'uniqueClicks') : undefined, withOpenersAndClicks.length ? total(withOpenersAndClicks, 'uniqueOpens') : undefined, acrossLabel('unique openers', withOpenersAndClicks.length, all)),
+        /*
+     * Bounces and their rate are over every sent campaign, because both
+     * halves are recorded for all of them: `sent` by the send itself and
+     * `bounced` by a webhook whose absence is a genuine zero — no bounce
+     * event means nothing bounced, unlike `delivered`, whose absence means
+     * nothing was measured.
+     */ bounce: sendRate(total(sentCampaigns, 'bounced'), sent, acrossLabel('sent', all, all)),
+        complaint: sendRate(withDelivery.length ? total(withDelivery, 'complained') : undefined, delivered != null ? delivered : undefined, acrossLabel('delivered', withDelivery.length, all)),
+        unsubscribe: sendRate(withDelivery.length ? total(withDelivery, 'unsubscribes') : undefined, delivered != null ? delivered : undefined, acrossLabel('delivered', withDelivery.length, all))
+    };
+    const caveats = [];
+    if (!all) {
+        caveats.push({
+            id: 'no-campaigns',
+            message: campaigns.length ? 'No campaign using this design has been sent yet, so there is ' + 'nothing to measure. The campaigns below are scheduled or were ' + 'canceled before they went out.' : 'This design has never been sent, so there is nothing to measure.'
+        });
+    } else if (withDelivery.length < all) {
+        caveats.push({
+            id: 'delivery-partial',
+            message: `${all - withDelivery.length} of ${all} campaigns using this design ` + 'recorded no delivery events, so they are left out of every rate ' + 'taken over delivered — open, click, complaint and unsubscribe. ' + 'Their counts are still included above.'
+        });
+    }
+    if (all && withClickTracking.length < withDelivery.length) {
+        caveats.push({
+            id: 'click-tracking-partial',
+            message: `${withDelivery.length - withClickTracking.length} of these campaigns ` + 'did not record carrying an HTML part. Click tracking rewrites links ' + 'in the HTML, so those sends report zero clicks whatever recipients ' + 'did, and they are left out of the click rates rather than counted ' + 'as sends nobody clicked.'
+        });
+    }
+    if (truncated) {
+        caveats.push({
+            id: 'campaigns-truncated',
+            message: 'This design has been used by more campaigns than one read returns, ' + 'so every total here is a floor — the real figures are at least ' + 'this large.'
+        });
+    }
+    if (sentCampaigns.some((campaign)=>{
+        var _campaign_stats;
+        return (_campaign_stats = campaign.stats) == null ? void 0 : _campaign_stats.audienceSizeTruncated;
+    })) {
+        caveats.push({
+            id: 'audience-truncated',
+            message: 'At least one of these sends stopped audience resolution at its read ' + 'ceiling, so the audience figures it contributed are floors.'
+        });
+    }
+    return {
+        sentCampaigns: all,
+        totalCampaigns: campaigns.length,
+        lastSentAtMs: sentCampaigns.reduce((latest, campaign)=>{
+            var _campaign_sentAtMs;
+            return latest === null || ((_campaign_sentAtMs = campaign.sentAtMs) != null ? _campaign_sentAtMs : 0) > latest ? campaign.sentAtMs : latest;
+        }, null),
+        recipients: total(sentCampaigns, 'recipients'),
+        sent,
+        delivered,
+        opens: total(sentCampaigns, 'opens'),
+        clicks: total(sentCampaigns, 'clicks'),
+        uniqueOpens,
+        uniqueClicks,
+        bounced: total(sentCampaigns, 'bounced'),
+        complained: total(sentCampaigns, 'complained'),
+        unsubscribes: total(sentCampaigns, 'unsubscribes'),
+        rates,
+        audiences: templateAudiences(sentCampaigns),
+        caveats
+    };
+}
+/**
+ * The audiences the design actually went to, largest first.
+ *
+ * Keyed on the LIST ID for a list send and on the audience kind otherwise, so
+ * two campaigns to the same list are one row and two campaigns to "all leads"
+ * are one row — but a list send and a segment send are never merged, because
+ * they are different questions about who received this design.
+ *
+ * A list send whose campaign recorded no list id at all is dropped rather
+ * than filed under a generic "List" heading: a row that cannot name which
+ * list is a row that answers the question wrongly.
+ */ function templateAudiences(campaigns) {
+    const rows = new Map();
+    for (const campaign of campaigns){
+        var _ref;
+        var _campaign_stats;
+        const isList = campaign.audience === 'list';
+        if (isList && !campaign.listId) continue;
+        const id = isList ? `list:${campaign.listId}` : campaign.audience;
+        const existing = rows.get(id);
+        const addressed = Number((_ref = (_campaign_stats = campaign.stats) == null ? void 0 : _campaign_stats.recipients) != null ? _ref : 0);
+        if (existing) {
+            existing.campaigns += 1;
+            existing.addressed += addressed;
+            // A later send that DID record the name fills one that did not, so a
+            // list mailed twice is named whenever any of those sends named it.
+            if (existing.unnamed && campaign.listName) {
+                existing.label = campaign.listName;
+                delete existing.unnamed;
+            }
+            continue;
+        }
+        rows.set(id, _extends({
+            id,
+            // Named once, in `email-record.ts`, so a list row on this table and
+            // the same list on a message's own page cannot disagree about what to
+            // call it.
+            label: emailAudienceLabel(campaign),
+            campaigns: 1,
+            addressed
+        }, isList && !campaign.listName ? {
+            unnamed: true
+        } : {}));
+    }
+    return [
+        ...rows.values()
+    ].sort((a, b)=>b.addressed - a.addressed || a.label.localeCompare(b.label));
+}
+
+//# sourceMappingURL=template-report.js.map

package/src/lib/model/template-report.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/model/template-report.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * ONE DESIGN, MEASURED ACROSS EVERY CAMPAIGN THAT USED IT.\n *\n * ## What this adds to `campaign-report.ts`\n *\n * A campaign report divides two numbers that were recorded by the same send.\n * A design report divides two SUMS, and a sum has a membership: which\n * campaigns went into it. That is the whole difficulty, and it is a new way\n * for the repo's rule — every rate names its denominator — to be broken.\n *\n * ## The rule, restated for a sum\n *\n * **A rate's numerator and its denominator are summed over the SAME set of\n * campaigns, and the screen is told how large that set is.**\n *\n * `delivered` is written only by the delivery webhook, so a design used by\n * five campaigns may have three that recorded it and two that never did.\n * Summing `uniqueOpens` over all five and dividing by `delivered` summed over\n * three produces an open rate that can exceed 100% and is, in every case,\n * the flattering substitution `campaign-report.ts` exists to refuse — carried\n * out by addition instead of by picking the wrong field.\n *\n * So each rate here is built from a FILTERED subset, and\n * {@link TemplateRate.denominatorLabel} names the subset as well as the\n * quantity: `delivered across 3 of 5 campaigns`. A reader comparing this\n * design's open rate with another's can see the two were taken over different\n * populations without being told separately.\n *\n * ## Counts are over everything; rates are over what can be divided\n *\n * The COUNTS — opens, clicks, unsubscribes — are summed over every campaign,\n * because a count is true whatever else was recorded. Only the rates narrow.\n * The two are labelled differently on screen for that reason, and the caveats\n * say how many campaigns each rate left out.\n *\n * ## Why this is a pure module\n *\n * Same reason as `campaign-report.ts`: a division written in JSX is a\n * denominator chosen by whoever writes the next card. Here it is worse — the\n * subset is invisible in the output unless something carries it — so the\n * subset is data, computed once, and the screen renders it.\n */\n\nimport {\n  sendRate,\n  type SendRate,\n  type SendStats,\n} from '@aglyn/shared-ui-email-campaigns/model/send-report'\nimport { emailAudienceLabel } from './email-record'\n\n/** A rate over a sum, carrying how many campaigns the sum covers. */\nexport type TemplateRate = SendRate\n\n/**\n * One campaign that used the design, as the report reads it.\n *\n * `sentAtMs` is nullable because a campaign document can exist without ever\n * having been sent — a scheduled campaign holds `sendAtMs` and no `sentAt`.\n * Those carry no engagement and the reader is shown their status rather than\n * a row of zeroes.\n */\nexport interface TemplateCampaign {\n  campaignId: string\n  subject: string\n  /** Epoch ms, or null for a campaign that has not been sent. */\n  sentAtMs: number | null\n  /** `'sent'`, `'scheduled'`, `'canceled'`. A persisted value; not relabeled. */\n  status: string\n  /** The audience KIND — `'leads'`, `'members'`, `'segment'`, `'list'`. */\n  audience: string\n  /** Set when `audience` is `'list'`. */\n  listId?: string\n  /** The list's name AS IT WAS at send time, when the send recorded one. */\n  listName?: string\n  stats: SendStats | undefined\n}\n\n/**\n * One audience the design was sent to.\n *\n * A LIST is named by the name the send recorded, not by the name the list\n * carries today: a renamed or deleted list would otherwise rewrite the\n * history of a campaign that went out months ago, and a deleted one would\n * erase it. The same reasoning as the campaign report's populations.\n */\nexport interface TemplateAudience {\n  /** Stable key — the list id, or the audience kind for the built-ins. */\n  id: string\n  label: string\n  /** How many campaigns using this design went to this audience. */\n  campaigns: number\n  /** Addresses those campaigns ADDRESSED, summed. */\n  addressed: number\n  /**\n   * The named list has since been deleted or renamed out of reach.\n   *\n   * Only ever true for a `list` audience, and only when the send recorded no\n   * name — an older send, before the name was stored. The screen says \"list\n   * no longer named\" rather than printing a raw document id as if it were\n   * something a merchant would recognise.\n   */\n  unnamed?: boolean\n}\n\n/** Why a number the design report would otherwise show is being withheld. */\nexport interface TemplateCaveat {\n  id:\n    | 'no-campaigns'\n    | 'delivery-partial'\n    | 'click-tracking-partial'\n    | 'campaigns-truncated'\n    | 'audience-truncated'\n  message: string\n}\n\n/** Everything the design report screen renders. */\nexport interface TemplateReport {\n  /** Campaigns that used this design AND were sent. */\n  sentCampaigns: number\n  /** Campaigns that used this design, sent or not. */\n  totalCampaigns: number\n  /** Epoch ms of the most recent send, or null. */\n  lastSentAtMs: number | null\n\n  /*========================================\n   * COUNTS — over every sent campaign.\n   *=======================================*/\n  recipients: number\n  sent: number\n  /** Summed over the campaigns that recorded it; null when none did. */\n  delivered: number | null\n  opens: number\n  clicks: number\n  uniqueOpens: number | null\n  uniqueClicks: number | null\n  bounced: number\n  complained: number\n  unsubscribes: number\n\n  /** Rates, each `null` when its denominator is zero or unrecorded. */\n  rates: {\n    delivery: TemplateRate | null\n    open: TemplateRate | null\n    click: TemplateRate | null\n    clickToOpen: TemplateRate | null\n    bounce: TemplateRate | null\n    complaint: TemplateRate | null\n    unsubscribe: TemplateRate | null\n  }\n\n  audiences: TemplateAudience[]\n  caveats: TemplateCaveat[]\n}\n\n/** A campaign that actually went out. The only kind engagement can describe. */\nfunction wasSent(campaign: TemplateCampaign): boolean {\n  return campaign.sentAtMs !== null\n}\n\n/** Sums one stats field over a set of campaigns, defaulting absent to zero. */\nfunction total(\n  campaigns: readonly TemplateCampaign[],\n  field: keyof SendStats,\n): number {\n  return campaigns.reduce(\n    (running, campaign) => running + Number(campaign.stats?.[field] ?? 0),\n    0,\n  )\n}\n\n/**\n * `${quantity} across N of M campaigns` — the denominator label for a sum.\n *\n * The `of M` half is what makes a narrowed rate readable. `delivered across 3\n * campaigns` is true and still invites the reader to assume the design has\n * three; `across 3 of 5` says on its face that two are missing from this\n * number and not from the counts above it.\n */\nfunction acrossLabel(quantity: string, covered: number, all: number): string {\n  return covered === all\n    ? `${quantity} across ${covered} ${covered === 1 ? 'campaign' : 'campaigns'}`\n    : `${quantity} across ${covered} of ${all} campaigns`\n}\n\n/**\n * Aggregates every campaign that used one design.\n *\n * @param campaigns every campaign document naming this design, sent or not.\n * @param truncated the query that produced `campaigns` stopped at its read\n *        ceiling, so every total here is a FLOOR. Reported as a caveat rather\n *        than hidden, on the same reasoning as `audienceSizeTruncated`: a\n *        figure that is at least this large is useful, and a figure presented\n *        as complete when it is not is worse than none.\n */\nexport function templateReport(\n  campaigns: readonly TemplateCampaign[],\n  truncated = false,\n): TemplateReport {\n  const sentCampaigns = campaigns.filter(wasSent)\n  const all = sentCampaigns.length\n\n  /*\n   * THE SUBSETS. Each rate divides sums taken over one of these and nothing\n   * else, which is what makes the numerator and denominator describe the same\n   * population — see this module's header.\n   */\n  const withDelivery = sentCampaigns.filter(\n    (campaign) => campaign.stats?.delivered !== undefined,\n  )\n  const withUniqueOpens = withDelivery.filter(\n    (campaign) => campaign.stats?.uniqueOpens !== undefined,\n  )\n  /*\n   * Click rates need BOTH a delivery denominator and the record that the send\n   * carried an HTML part. A send with no HTML part reports zero clicks\n   * whatever recipients did, so including it in a click rate's denominator\n   * drags the rate down by however many untrackable sends this design has —\n   * a measurement of our own sending code presented as a measurement of the\n   * audience. `campaign-report.ts` refuses the same substitution for one\n   * campaign; a sum must refuse it per campaign, not for the design as a\n   * whole, or one old send would withhold the design's whole click rate.\n   */\n  const withClickTracking = withDelivery.filter(\n    (campaign) =>\n      campaign.stats?.clickTracked === true &&\n      campaign.stats?.uniqueClicks !== undefined,\n  )\n  const withOpenersAndClicks = withClickTracking.filter(\n    (campaign) => campaign.stats?.uniqueOpens !== undefined,\n  )\n\n  const sent = total(sentCampaigns, 'sent')\n  const delivered = withDelivery.length\n    ? total(withDelivery, 'delivered')\n    : null\n  const uniqueOpens = withUniqueOpens.length\n    ? total(withUniqueOpens, 'uniqueOpens')\n    : null\n  const uniqueClicks = withClickTracking.length\n    ? total(withClickTracking, 'uniqueClicks')\n    : null\n\n  const rates: TemplateReport['rates'] = {\n    /*\n     * Over the campaigns that recorded a delivery, and `sent` summed over\n     * those SAME campaigns rather than over all of them. The alternative —\n     * delivered over the design's whole `sent` — reads as a delivery failure\n     * proportional to how many of this design's sends predate the webhook.\n     */\n    delivery: delivered === null\n      ? null\n      : sendRate(\n          delivered,\n          total(withDelivery, 'sent'),\n          acrossLabel('sent', withDelivery.length, all),\n        ),\n    open: sendRate(\n      uniqueOpens ?? undefined,\n      withUniqueOpens.length ? total(withUniqueOpens, 'delivered') : undefined,\n      acrossLabel('delivered', withUniqueOpens.length, all),\n    ),\n    click: sendRate(\n      uniqueClicks ?? undefined,\n      withClickTracking.length\n        ? total(withClickTracking, 'delivered')\n        : undefined,\n      acrossLabel('delivered', withClickTracking.length, all),\n    ),\n    clickToOpen: sendRate(\n      withOpenersAndClicks.length\n        ? total(withOpenersAndClicks, 'uniqueClicks')\n        : undefined,\n      withOpenersAndClicks.length\n        ? total(withOpenersAndClicks, 'uniqueOpens')\n        : undefined,\n      acrossLabel('unique openers', withOpenersAndClicks.length, all),\n    ),\n    /*\n     * Bounces and their rate are over every sent campaign, because both\n     * halves are recorded for all of them: `sent` by the send itself and\n     * `bounced` by a webhook whose absence is a genuine zero — no bounce\n     * event means nothing bounced, unlike `delivered`, whose absence means\n     * nothing was measured.\n     */\n    bounce: sendRate(\n      total(sentCampaigns, 'bounced'),\n      sent,\n      acrossLabel('sent', all, all),\n    ),\n    complaint: sendRate(\n      withDelivery.length ? total(withDelivery, 'complained') : undefined,\n      delivered ?? undefined,\n      acrossLabel('delivered', withDelivery.length, all),\n    ),\n    unsubscribe: sendRate(\n      withDelivery.length ? total(withDelivery, 'unsubscribes') : undefined,\n      delivered ?? undefined,\n      acrossLabel('delivered', withDelivery.length, all),\n    ),\n  }\n\n  const caveats: TemplateCaveat[] = []\n  if (!all) {\n    caveats.push({\n      id: 'no-campaigns',\n      message: campaigns.length\n        ? 'No campaign using this design has been sent yet, so there is ' +\n          'nothing to measure. The campaigns below are scheduled or were ' +\n          'canceled before they went out.'\n        : 'This design has never been sent, so there is nothing to measure.',\n    })\n  } else if (withDelivery.length < all) {\n    caveats.push({\n      id: 'delivery-partial',\n      message:\n        `${all - withDelivery.length} of ${all} campaigns using this design ` +\n        'recorded no delivery events, so they are left out of every rate ' +\n        'taken over delivered — open, click, complaint and unsubscribe. ' +\n        'Their counts are still included above.',\n    })\n  }\n  if (all && withClickTracking.length < withDelivery.length) {\n    caveats.push({\n      id: 'click-tracking-partial',\n      message:\n        `${withDelivery.length - withClickTracking.length} of these campaigns ` +\n        'did not record carrying an HTML part. Click tracking rewrites links ' +\n        'in the HTML, so those sends report zero clicks whatever recipients ' +\n        'did, and they are left out of the click rates rather than counted ' +\n        'as sends nobody clicked.',\n    })\n  }\n  if (truncated) {\n    caveats.push({\n      id: 'campaigns-truncated',\n      message:\n        'This design has been used by more campaigns than one read returns, ' +\n        'so every total here is a floor — the real figures are at least ' +\n        'this large.',\n    })\n  }\n  if (sentCampaigns.some((campaign) => campaign.stats?.audienceSizeTruncated)) {\n    caveats.push({\n      id: 'audience-truncated',\n      message:\n        'At least one of these sends stopped audience resolution at its read ' +\n        'ceiling, so the audience figures it contributed are floors.',\n    })\n  }\n\n  return {\n    sentCampaigns: all,\n    totalCampaigns: campaigns.length,\n    lastSentAtMs: sentCampaigns.reduce<number | null>(\n      (latest, campaign) =>\n        latest === null || (campaign.sentAtMs ?? 0) > latest\n          ? campaign.sentAtMs\n          : latest,\n      null,\n    ),\n    recipients: total(sentCampaigns, 'recipients'),\n    sent,\n    delivered,\n    opens: total(sentCampaigns, 'opens'),\n    clicks: total(sentCampaigns, 'clicks'),\n    uniqueOpens,\n    uniqueClicks,\n    bounced: total(sentCampaigns, 'bounced'),\n    complained: total(sentCampaigns, 'complained'),\n    unsubscribes: total(sentCampaigns, 'unsubscribes'),\n    rates,\n    audiences: templateAudiences(sentCampaigns),\n    caveats,\n  }\n}\n\n/**\n * The audiences the design actually went to, largest first.\n *\n * Keyed on the LIST ID for a list send and on the audience kind otherwise, so\n * two campaigns to the same list are one row and two campaigns to \"all leads\"\n * are one row — but a list send and a segment send are never merged, because\n * they are different questions about who received this design.\n *\n * A list send whose campaign recorded no list id at all is dropped rather\n * than filed under a generic \"List\" heading: a row that cannot name which\n * list is a row that answers the question wrongly.\n */\nfunction templateAudiences(\n  campaigns: readonly TemplateCampaign[],\n): TemplateAudience[] {\n  const rows = new Map<string, TemplateAudience>()\n  for (const campaign of campaigns) {\n    const isList = campaign.audience === 'list'\n    if (isList && !campaign.listId) continue\n    const id = isList ? `list:${campaign.listId}` : campaign.audience\n    const existing = rows.get(id)\n    const addressed = Number(campaign.stats?.recipients ?? 0)\n    if (existing) {\n      existing.campaigns += 1\n      existing.addressed += addressed\n      // A later send that DID record the name fills one that did not, so a\n      // list mailed twice is named whenever any of those sends named it.\n      if (existing.unnamed && campaign.listName) {\n        existing.label = campaign.listName\n        delete existing.unnamed\n      }\n      continue\n    }\n    rows.set(id, {\n      id,\n      // Named once, in `email-record.ts`, so a list row on this table and\n      // the same list on a message's own page cannot disagree about what to\n      // call it.\n      label: emailAudienceLabel(campaign),\n      campaigns: 1,\n      addressed,\n      ...(isList && !campaign.listName ? { unnamed: true as const } : {}),\n    })\n  }\n  return [...rows.values()].sort(\n    (a, b) => b.addressed - a.addressed || a.label.localeCompare(b.label),\n  )\n}\n"],"names":["sendRate","emailAudienceLabel","wasSent","campaign","sentAtMs","total","campaigns","field","reduce","running","Number","stats","acrossLabel","quantity","covered","all","templateReport","truncated","sentCampaigns","filter","length","withDelivery","delivered","undefined","withUniqueOpens","uniqueOpens","withClickTracking","clickTracked","uniqueClicks","withOpenersAndClicks","sent","rates","delivery","open","click","clickToOpen","bounce","complaint","unsubscribe","caveats","push","id","message","some","audienceSizeTruncated","totalCampaigns","lastSentAtMs","latest","recipients","opens","clicks","bounced","complained","unsubscribes","audiences","templateAudiences","rows","Map","isList","audience","listId","existing","get","addressed","unnamed","listName","label","set","values","sort","a","b","localeCompare"],"mappings":"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"}

package/src/lib/plugin.js

@@ -20,6 +20,7 @@ import { lazy } from "react";
 import { CAMPAIGN_DESIGN_CREATE_ZONE, CAMPAIGN_DESIGN_PREVIEW_ZONE, CAMPAIGN_SENDER_EDITOR_ZONE, CAMPAIGN_TOPIC_OPTIONS_ZONE, CAMPAIGN_TOPIC_SELECT_ZONE } from "./components/campaign-email-zones.js";
 import { EXPERIMENT_RESULT_ZONE, EXPERIMENT_VARIANTS_ZONE } from "./components/experiment-zones.js";
 import { MARKETING_CONSOLE_SECTIONS, MARKETING_ORG_CONSOLE_SECTIONS } from "./components/marketing-console-sections.js";
+import { registerPluginTransferResourceUi } from "@aglyn/aglyn/plugin-manager/plugin-transfer-resources";
 import { BUNDLE_ID } from "./constants/bundle-common.js";
 import { StaffOrgEmailCard } from "./components/staff-org-email-card.component.js";
 import { registerMarketingRecordLists } from "./model/overlay-record-list.js";
@@ -31,6 +32,7 @@ import { registerMarketingRecordRoutes } from "./model/marketing-record-routes.j
  * site's on the organization's Inbox.
  */ const InboxCampaignsWidget = lazy(()=>import("./components/inbox-campaigns-widget.js"));
 /** The Emails page's Messages section: the list, one message, its composer. */ const EmailMessagesWidget = lazy(()=>import("./components/email-messages-widget.js"));
+/** What the sends built from one template did, on the template's page. */ const EmailTemplateReportCard = lazy(()=>import("./components/email-template-report-card.js"));
 /** Who received the sends built from one template, on the template's page. */ const EmailRecipientsCard = lazy(()=>import("./components/email-recipients-card.js"));
 /** Loaded where a record page draws one of the attribution zones. */ const RecordAttributionWidget = lazy(()=>import("./components/record-attribution-widget.js"));
 /** The site's section experiments, reported to the besigner's Interactions section. */ const BesignerSectionExperiments = lazy(()=>import("./components/besigner-section-experiments.js"));
@@ -43,6 +45,12 @@ import { registerMarketingRecordRoutes } from "./model/marketing-record-routes.j
  * their own per-plan checks off the passed `org`). The popup image picker
  * uses the shell's media browser via `useMediaPicker`.
  */ export function registerMarketingConsole() {
+    // How the Import & export hub names campaigns in a workspace package (AGL-3535).
+    registerPluginTransferResourceUi('marketing.campaigns', {
+        label: 'Campaigns'
+    }, {
+        pluginId: BUNDLE_ID
+    });
     /*
    * The two positions the A/B testing card hosts (AGL-2914), declared before
    * the extension that draws the card. An id another plugin has already taken
@@ -128,6 +136,14 @@ import { registerMarketingRecordRoutes } from "./model/marketing-record-routes.j
                 title: 'Messages',
                 Component: EmailMessagesWidget
             },
+            // A template's page: what the sends built from it did, then who
+            // received them. The template is the Email plugin's; the sends are ours.
+            {
+                slot: 'emailTemplateReport',
+                widgetId: 'marketing-email-template-report',
+                title: 'Sent from this template',
+                Component: EmailTemplateReportCard
+            },
             {
                 slot: 'emailTemplateRecipients',
                 widgetId: 'marketing-email-template-recipients',