@aglyn/plugins-marketing 1.0.0-beta.220 → 1.0.0-beta.222

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":";AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCC,GAED,SACEA,QAAQ,QAGH,qDAAoD;AAC3D,SAASC,kBAAkB,QAAQ,oBAAgB;AA0GnD,8EAA8E,GAC9E,SAASC,QAAQC,QAA0B;IACzC,OAAOA,SAASC,QAAQ,KAAK;AAC/B;AAEA,6EAA6E,GAC7E,SAASC,MACPC,SAAsC,EACtCC,KAAsB;IAEtB,OAAOD,UAAUE,MAAM,CACrB,CAACC,SAASN;;YAA8BA;eAAjBM,UAAUC,gBAAOP,kBAAAA,SAASQ,KAAK,qBAAdR,eAAgB,CAACI,MAAM,mBAAI;OACnE;AAEJ;AAEA;;;;;;;CAOC,GACD,SAASK,YAAYC,QAAgB,EAAEC,OAAe,EAAEC,GAAW;IACjE,OAAOD,YAAYC,MACf,GAAGF,SAAS,QAAQ,EAAEC,QAAQ,CAAC,EAAEA,YAAY,IAAI,aAAa,aAAa,GAC3E,GAAGD,SAAS,QAAQ,EAAEC,QAAQ,IAAI,EAAEC,IAAI,UAAU,CAAC;AACzD;AAEA;;;;;;;;;CASC,GACD,OAAO,SAASC,eACdV,SAAsC,EACtCW,YAAY,KAAK;IAEjB,MAAMC,gBAAgBZ,UAAUa,MAAM,CAACjB;IACvC,MAAMa,MAAMG,cAAcE,MAAM;IAEhC;;;;GAIC,GACD,MAAMC,eAAeH,cAAcC,MAAM,CACvC,CAAChB;YAAaA;eAAAA,EAAAA,kBAAAA,SAASQ,KAAK,qBAAdR,gBAAgBmB,SAAS,MAAKC;;IAE9C,MAAMC,kBAAkBH,aAAaF,MAAM,CACzC,CAAChB;YAAaA;eAAAA,EAAAA,kBAAAA,SAASQ,KAAK,qBAAdR,gBAAgBsB,WAAW,MAAKF;;IAEhD;;;;;;;;;GASC,GACD,MAAMG,oBAAoBL,aAAaF,MAAM,CAC3C,CAAChB;YACCA,iBACAA;eADAA,EAAAA,kBAAAA,SAASQ,KAAK,qBAAdR,gBAAgBwB,YAAY,MAAK,QACjCxB,EAAAA,mBAAAA,SAASQ,KAAK,qBAAdR,iBAAgByB,YAAY,MAAKL;;IAErC,MAAMM,uBAAuBH,kBAAkBP,MAAM,CACnD,CAAChB;YAAaA;eAAAA,EAAAA,kBAAAA,SAASQ,KAAK,qBAAdR,gBAAgBsB,WAAW,MAAKF;;IAGhD,MAAMO,OAAOzB,MAAMa,eAAe;IAClC,MAAMI,YAAYD,aAAaD,MAAM,GACjCf,MAAMgB,cAAc,eACpB;IACJ,MAAMI,cAAcD,gBAAgBJ,MAAM,GACtCf,MAAMmB,iBAAiB,iBACvB;IACJ,MAAMI,eAAeF,kBAAkBN,MAAM,GACzCf,MAAMqB,mBAAmB,kBACzB;IAEJ,MAAMK,QAAiC;QACrC;;;;;KAKC,GACDC,UAAUV,cAAc,OACpB,OACAtB,SACEsB,WACAjB,MAAMgB,cAAc,SACpBT,YAAY,QAAQS,aAAaD,MAAM,EAAEL;QAE/CkB,MAAMjC,SACJyB,sBAAAA,cAAeF,WACfC,gBAAgBJ,MAAM,GAAGf,MAAMmB,iBAAiB,eAAeD,WAC/DX,YAAY,aAAaY,gBAAgBJ,MAAM,EAAEL;QAEnDmB,OAAOlC,SACL4B,uBAAAA,eAAgBL,WAChBG,kBAAkBN,MAAM,GACpBf,MAAMqB,mBAAmB,eACzBH,WACJX,YAAY,aAAac,kBAAkBN,MAAM,EAAEL;QAErDoB,aAAanC,SACX6B,qBAAqBT,MAAM,GACvBf,MAAMwB,sBAAsB,kBAC5BN,WACJM,qBAAqBT,MAAM,GACvBf,MAAMwB,sBAAsB,iBAC5BN,WACJX,YAAY,kBAAkBiB,qBAAqBT,MAAM,EAAEL;QAE7D;;;;;;KAMC,GACDqB,QAAQpC,SACNK,MAAMa,eAAe,YACrBY,MACAlB,YAAY,QAAQG,KAAKA;QAE3BsB,WAAWrC,SACTqB,aAAaD,MAAM,GAAGf,MAAMgB,cAAc,gBAAgBE,WAC1DD,oBAAAA,YAAaC,WACbX,YAAY,aAAaS,aAAaD,MAAM,EAAEL;QAEhDuB,aAAatC,SACXqB,aAAaD,MAAM,GAAGf,MAAMgB,cAAc,kBAAkBE,WAC5DD,oBAAAA,YAAaC,WACbX,YAAY,aAAaS,aAAaD,MAAM,EAAEL;IAElD;IAEA,MAAMwB,UAA4B,EAAE;IACpC,IAAI,CAACxB,KAAK;QACRwB,QAAQC,IAAI,CAAC;YACXC,IAAI;YACJC,SAASpC,UAAUc,MAAM,GACrB,kEACA,mEACA,mCACA;QACN;IACF,OAAO,IAAIC,aAAaD,MAAM,GAAGL,KAAK;QACpCwB,QAAQC,IAAI,CAAC;YACXC,IAAI;YACJC,SACE,GAAG3B,MAAMM,aAAaD,MAAM,CAAC,IAAI,EAAEL,IAAI,6BAA6B,CAAC,GACrE,qEACA,oEACA;QACJ;IACF;IACA,IAAIA,OAAOW,kBAAkBN,MAAM,GAAGC,aAAaD,MAAM,EAAE;QACzDmB,QAAQC,IAAI,CAAC;YACXC,IAAI;YACJC,SACE,GAAGrB,aAAaD,MAAM,GAAGM,kBAAkBN,MAAM,CAAC,oBAAoB,CAAC,GACvE,yEACA,wEACA,uEACA;QACJ;IACF;IACA,IAAIH,WAAW;QACbsB,QAAQC,IAAI,CAAC;YACXC,IAAI;YACJC,SACE,wEACA,oEACA;QACJ;IACF;IACA,IAAIxB,cAAcyB,IAAI,CAAC,CAACxC;YAAaA;gBAAAA,kBAAAA,SAASQ,KAAK,qBAAdR,gBAAgByC,qBAAqB;QAAG;QAC3EL,QAAQC,IAAI,CAAC;YACXC,IAAI;YACJC,SACE,yEACA;QACJ;IACF;IAEA,OAAO;QACLxB,eAAeH;QACf8B,gBAAgBvC,UAAUc,MAAM;QAChC0B,cAAc5B,cAAcV,MAAM,CAChC,CAACuC,QAAQ5C;gBACaA;mBAApB4C,WAAW,QAAQ,EAAC5C,qBAAAA,SAASC,QAAQ,YAAjBD,qBAAqB,KAAK4C,SAC1C5C,SAASC,QAAQ,GACjB2C;WACN;QAEFC,YAAY3C,MAAMa,eAAe;QACjCY;QACAR;QACA2B,OAAO5C,MAAMa,eAAe;QAC5BgC,QAAQ7C,MAAMa,eAAe;QAC7BO;QACAG;QACAuB,SAAS9C,MAAMa,eAAe;QAC9BkC,YAAY/C,MAAMa,eAAe;QACjCmC,cAAchD,MAAMa,eAAe;QACnCa;QACAuB,WAAWC,kBAAkBrC;QAC7BqB;IACF;AACF;AAEA;;;;;;;;;;;CAWC,GACD,SAASgB,kBACPjD,SAAsC;IAEtC,MAAMkD,OAAO,IAAIC;IACjB,KAAK,MAAMtD,YAAYG,UAAW;;YAKPH;QAJzB,MAAMuD,SAASvD,SAASwD,QAAQ,KAAK;QACrC,IAAID,UAAU,CAACvD,SAASyD,MAAM,EAAE;QAChC,MAAMnB,KAAKiB,SAAS,CAAC,KAAK,EAAEvD,SAASyD,MAAM,EAAE,GAAGzD,SAASwD,QAAQ;QACjE,MAAME,WAAWL,KAAKM,GAAG,CAACrB;QAC1B,MAAMsB,YAAYrD,gBAAOP,kBAAAA,SAASQ,KAAK,qBAAdR,gBAAgB6C,UAAU,mBAAI;QACvD,IAAIa,UAAU;YACZA,SAASvD,SAAS,IAAI;YACtBuD,SAASE,SAAS,IAAIA;YACtB,qEAAqE;YACrE,mEAAmE;YACnE,IAAIF,SAASG,OAAO,IAAI7D,SAAS8D,QAAQ,EAAE;gBACzCJ,SAASK,KAAK,GAAG/D,SAAS8D,QAAQ;gBAClC,OAAOJ,SAASG,OAAO;YACzB;YACA;QACF;QACAR,KAAKW,GAAG,CAAC1B,IAAI;YACXA;YACA,oEAAoE;YACpE,sEAAsE;YACtE,WAAW;YACXyB,OAAOjE,mBAAmBE;YAC1BG,WAAW;YACXyD;WACIL,UAAU,CAACvD,SAAS8D,QAAQ,GAAG;YAAED,SAAS;QAAc,IAAI,CAAC;IAErE;IACA,OAAO;WAAIR,KAAKY,MAAM;KAAG,CAACC,IAAI,CAC5B,CAACC,GAAGC,IAAMA,EAAER,SAAS,GAAGO,EAAEP,SAAS,IAAIO,EAAEJ,KAAK,CAACM,aAAa,CAACD,EAAEL,KAAK;AAExE"}

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',

package/src/lib/plugin.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/plugins/marketing/src/lib/plugin.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport * as Aglyn from '@aglyn/aglyn'\nimport {\n  registerPluginZone,\n  type PluginZone,\n} from '@aglyn/aglyn/plugin-manager/plugin-zones'\nimport { mdiBullhornOutline } from '@aglyn/shared-data-mdi'\nimport { lazy } from 'react'\nimport {\n  CAMPAIGN_DESIGN_CREATE_ZONE,\n  CAMPAIGN_DESIGN_PREVIEW_ZONE,\n  CAMPAIGN_SENDER_EDITOR_ZONE,\n  CAMPAIGN_TOPIC_OPTIONS_ZONE,\n  CAMPAIGN_TOPIC_SELECT_ZONE,\n} from './components/campaign-email-zones'\nimport {\n  EXPERIMENT_RESULT_ZONE,\n  EXPERIMENT_VARIANTS_ZONE,\n} from './components/experiment-zones'\nimport {\n  MARKETING_CONSOLE_SECTIONS,\n  MARKETING_ORG_CONSOLE_SECTIONS,\n} from './components/marketing-console-sections'\nimport { BUNDLE_ID } from './constants/bundle-common'\nimport { StaffOrgEmailCard } from './components/staff-org-email-card.component'\nimport { registerMarketingRecordLists } from './model/overlay-record-list'\nimport { registerMarketingRecordRoutes } from './model/marketing-record-routes'\n\n/** Code-split: the Marketing console page only loads when opened. */\nconst MarketingConsolePage = lazy(\n  () => import('./components/marketing-console-page'),\n)\n\n/** Dashboard glance card, loaded only where the shell renders the slot. */\nconst CampaignGlanceCard = lazy(\n  () => import('./components/campaign-glance-card.component'),\n)\n\n/**\n * The campaigns drawn in the Inbox's Campaigns section: one site's, or every\n * site's on the organization's Inbox.\n */\nconst InboxCampaignsWidget = lazy(\n  () => import('./components/inbox-campaigns-widget'),\n)\n\n/** The Emails page's Messages section: the list, one message, its composer. */\nconst EmailMessagesWidget = lazy(\n  () => import('./components/email-messages-widget'),\n)\n\n/** Who received the sends built from one template, on the template's page. */\nconst EmailRecipientsCard = lazy(\n  () => import('./components/email-recipients-card'),\n)\n\n/** Loaded where a record page draws one of the attribution zones. */\nconst RecordAttributionWidget = lazy(\n  () => import('./components/record-attribution-widget'),\n)\n\n/** The site's section experiments, reported to the besigner's Interactions section. */\nconst BesignerSectionExperiments = lazy(\n  () => import('./components/besigner-section-experiments'),\n)\n\n/**\n * Marketing feature plugin (AGL-395). Console-only — overlays and popups\n * render on published sites through the tenant runtime, not a canvas\n * element of their own, so there is no UI bundle. The console half declares\n * the Marketing nav + page through the ConsoleExtension registry (always-on;\n * the surface itself is not release-flagged — its overlays/A-B cards run\n * their own per-plan checks off the passed `org`). The popup image picker\n * uses the shell's media browser via `useMediaPicker`.\n */\nexport function registerMarketingConsole(): void {\n  /*\n   * The two positions the A/B testing card hosts (AGL-2914), declared before\n   * the extension that draws the card. An id another plugin has already taken\n   * is refused, naming both. What each zone hands a widget is carried on its\n   * token, in `components/experiment-zones`, so a widget elsewhere is written\n   * against the same shape without importing this plugin.\n   */\n  registerPluginZone(\n    {\n      zone: EXPERIMENT_VARIANTS_ZONE,\n      label: 'A/B test variants',\n      surface: 'console',\n      description:\n        'In the experiment editor, beside the variants. A widget here proposes copy for the variants the editor holds; the dialog’s Save is the write, and nothing a widget returns starts or changes a test.',\n    },\n    // Named rather than left to the loader's marker, because this function is\n    // also called directly — by a spec, and by an app that loads the plugin\n    // without the loader — and a zone with no owner is refused.\n    { pluginId: BUNDLE_ID },\n  )\n  registerPluginZone(\n    {\n      zone: EXPERIMENT_RESULT_ZONE,\n      label: 'A/B test result',\n      surface: 'console',\n      description:\n        'Below the results of one test. A widget here explains what the figures show. There is nothing to apply, and a widget may not declare a winner the card has not.',\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  /*\n   * What a campaign email asks of whichever plugin keeps the mail itself —\n   * the topic catalog, the sending identities, the design document and its\n   * renderer. Each is a zone the composer or a message's page hosts; see\n   * `components/campaign-email-zones` for what each hands a widget. All are\n   * `bare`: a widget there is a field, a button, a drawer or nothing at all,\n   * and the stack's spacing around it would be a gap in a form.\n   */\n  const bareZone = <Props,>(\n    zone: PluginZone<Props>,\n    label: string,\n    description: string,\n  ) =>\n    registerPluginZone(\n      { zone, label, description, surface: 'console', layout: 'bare' },\n      { pluginId: BUNDLE_ID },\n    )\n  bareZone(\n    CAMPAIGN_TOPIC_SELECT_ZONE,\n    'An email’s topic',\n    'In the campaign composer’s field stack. A widget here is the picker for the stream the email belongs to: it is handed the chosen id and reports a new one through `onChange`. The composer records it; the widget writes nothing.',\n  )\n  bareZone(\n    CAMPAIGN_TOPIC_OPTIONS_ZONE,\n    'The topics a campaign can open on',\n    'Beside the drawers that create and edit a campaign. A widget here draws nothing: while `enabled` it reads the streams a recipient can still leave and answers through `onTopics`.',\n  )\n  bareZone(\n    CAMPAIGN_SENDER_EDITOR_ZONE,\n    'Add a sender while composing',\n    'Mounted by the campaign composer once its author asks to add a sender. A widget here is that editor, open in its add mode; `onSaved` names the sender it created.',\n  )\n  bareZone(\n    CAMPAIGN_DESIGN_CREATE_ZONE,\n    'A design for one email',\n    'In the campaign composer, beside the design picker. A widget here is the control that mints a design document and names it through `onCreated`; the composer records the choice on the campaign and opens the editor.',\n  )\n  bareZone(\n    CAMPAIGN_DESIGN_PREVIEW_ZONE,\n    'A sent email as an inbox receives it',\n    'On one message’s page. A widget here renders the stored design, or the plain-text body, through the renderer the send path uses.',\n  )\n  registerMarketingRecordRoutes()\n  // The site's overlays, for another plugin's picker to list (AGL-3080).\n  registerMarketingRecordLists()\n  Aglyn.registerConsoleExtension({\n    pluginId: BUNDLE_ID,\n    displayName: 'Marketing',\n    /*\n     * The host dashboard's `Last campaign` card (AGL-433). A widget rather\n     * than a direct import by the dashboard page, so it appears only on\n     * workspaces that have the plugin that owns the campaign history — a card\n     * about campaigns on a console with no campaigns page could only ever be\n     * blank, and its header links straight into `/marketing/campaigns`.\n     */\n    widgets: [\n      {\n        slot: Aglyn.CONSOLE_WIDGET_SLOTS.hostDashboard,\n        // The id a reader's dashboard preferences already name — it is what\n        // `isDashboardWidgetHidden` and the customize order are keyed on, so\n        // it is persisted and does not follow the plugin.\n        widgetId: 'email-campaign-glance',\n        title: 'Last campaign',\n        Component: CampaignGlanceCard,\n      },\n      // Which campaign or link brought a person, drawn where the plugins that\n      // keep and list people host a zone for it. They hand over what the\n      // record is and its id; neither imports this plugin.\n      {\n        slot: 'crmRecordAttribution',\n        widgetId: 'marketing-crm-record-attribution',\n        title: 'Campaign attribution',\n        Component: RecordAttributionWidget,\n      },\n      // The Emails page hosts its Messages section as a zone: a message is\n      // one send of a campaign, and every action on it is this plugin's route.\n      {\n        slot: 'emailMessages',\n        widgetId: 'marketing-email-messages',\n        title: 'Messages',\n        Component: EmailMessagesWidget,\n      },\n      {\n        slot: 'emailTemplateRecipients',\n        widgetId: 'marketing-email-template-recipients',\n        title: 'Recipients',\n        Component: EmailRecipientsCard,\n      },\n      // The Inbox's Campaigns tab is a zone; this is the card that fills it.\n      {\n        slot: 'inboxCampaigns',\n        widgetId: 'marketing-inbox-campaigns',\n        title: 'Campaigns',\n        Component: InboxCampaignsWidget,\n      },\n      {\n        slot: 'inboxRecordAttribution',\n        widgetId: 'marketing-inbox-record-attribution',\n        title: 'Campaign attribution',\n        Component: RecordAttributionWidget,\n      },\n      // The section experiments the besigner's Interactions section badges an\n      // element with and starts on a page's element; reported, never drawn.\n      {\n        slot: Aglyn.CONSOLE_WIDGET_SLOTS.besignerInteractions,\n        widgetId: 'marketing-besigner-section-experiments',\n        title: 'Section experiments',\n        Component: BesignerSectionExperiments,\n      },\n      // The staff organization page's sends and campaigns (AGL-3380), read\n      // only: staff see what the organization sent without joining it.\n      {\n        slot: Aglyn.CONSOLE_WIDGET_SLOTS.adminOrgDetail,\n        widgetId: 'marketing-staff-org-email',\n        title: 'Email campaigns',\n        Component: StaffOrgEmailCard,\n      },\n    ],\n    navItems: [\n      {\n        label: 'Marketing',\n        href: '/marketing',\n        // Sections as ROUTES (AGL-2501): each is a real URL the shell\n        // resolves and gates, so the page mounts the one being read.\n        sections: MARKETING_CONSOLE_SECTIONS,\n        navTabId: 'nav-tab-marketing',\n        icon: { path: mdiBullhornOutline.path },\n        header: {\n          title: 'Marketing',\n          icon: { path: mdiBullhornOutline.path },\n          docsTopic: 'marketingOverlays',\n        },\n        Component: MarketingConsolePage,\n      },\n    ],\n    /*\n     * The ORGANIZATION's Marketing hub, at `/[orgSlug]/marketing`: every\n     * section the site hub has, over every site. Campaigns and their sequence\n     * rollups belong to the organization, so this is where one campaign is\n     * placed across several sites; overlays, tests and conversions stay each\n     * site's and are read across them. Every site's mail is on the\n     * organization's Emails page, as a site's is on its own. The page is the\n     * same component; handed no site, it renders the org sections.\n     *\n     * It carries the SITE tab's id on purpose, the way the org CRM tab does:\n     * `release_marketing` names `nav-tab-marketing`, so one flag holds both\n     * halves of the surface, and the org half cannot ship while the site half\n     * is switched off.\n     */\n    orgNavItems: [\n      {\n        label: 'Marketing',\n        href: '/marketing',\n        sections: MARKETING_ORG_CONSOLE_SECTIONS,\n        navTabId: 'nav-tab-marketing',\n        icon: { path: mdiBullhornOutline.path },\n        header: {\n          title: 'Marketing',\n          icon: { path: mdiBullhornOutline.path },\n          docsTopic: 'marketingOverlays',\n        },\n        Component: MarketingConsolePage,\n      },\n    ],\n  })\n}\n\nexport * from './site'\n"],"names":["Aglyn","registerPluginZone","mdiBullhornOutline","lazy","CAMPAIGN_DESIGN_CREATE_ZONE","CAMPAIGN_DESIGN_PREVIEW_ZONE","CAMPAIGN_SENDER_EDITOR_ZONE","CAMPAIGN_TOPIC_OPTIONS_ZONE","CAMPAIGN_TOPIC_SELECT_ZONE","EXPERIMENT_RESULT_ZONE","EXPERIMENT_VARIANTS_ZONE","MARKETING_CONSOLE_SECTIONS","MARKETING_ORG_CONSOLE_SECTIONS","BUNDLE_ID","StaffOrgEmailCard","registerMarketingRecordLists","registerMarketingRecordRoutes","MarketingConsolePage","CampaignGlanceCard","InboxCampaignsWidget","EmailMessagesWidget","EmailRecipientsCard","RecordAttributionWidget","BesignerSectionExperiments","registerMarketingConsole","zone","label","surface","description","pluginId","bareZone","layout","registerConsoleExtension","displayName","widgets","slot","CONSOLE_WIDGET_SLOTS","hostDashboard","widgetId","title","Component","besignerInteractions","adminOrgDetail","navItems","href","sections","navTabId","icon","path","header","docsTopic","orgNavItems"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../libs/plugins/marketing/src/lib/plugin.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport * as Aglyn from '@aglyn/aglyn'\nimport {\n  registerPluginZone,\n  type PluginZone,\n} from '@aglyn/aglyn/plugin-manager/plugin-zones'\nimport { mdiBullhornOutline } from '@aglyn/shared-data-mdi'\nimport { lazy } from 'react'\nimport {\n  CAMPAIGN_DESIGN_CREATE_ZONE,\n  CAMPAIGN_DESIGN_PREVIEW_ZONE,\n  CAMPAIGN_SENDER_EDITOR_ZONE,\n  CAMPAIGN_TOPIC_OPTIONS_ZONE,\n  CAMPAIGN_TOPIC_SELECT_ZONE,\n} from './components/campaign-email-zones'\nimport {\n  EXPERIMENT_RESULT_ZONE,\n  EXPERIMENT_VARIANTS_ZONE,\n} from './components/experiment-zones'\nimport {\n  MARKETING_CONSOLE_SECTIONS,\n  MARKETING_ORG_CONSOLE_SECTIONS,\n} from './components/marketing-console-sections'\nimport { registerPluginTransferResourceUi } from '@aglyn/aglyn/plugin-manager/plugin-transfer-resources'\nimport { BUNDLE_ID } from './constants/bundle-common'\nimport { StaffOrgEmailCard } from './components/staff-org-email-card.component'\nimport { registerMarketingRecordLists } from './model/overlay-record-list'\nimport { registerMarketingRecordRoutes } from './model/marketing-record-routes'\n\n/** Code-split: the Marketing console page only loads when opened. */\nconst MarketingConsolePage = lazy(\n  () => import('./components/marketing-console-page'),\n)\n\n/** Dashboard glance card, loaded only where the shell renders the slot. */\nconst CampaignGlanceCard = lazy(\n  () => import('./components/campaign-glance-card.component'),\n)\n\n/**\n * The campaigns drawn in the Inbox's Campaigns section: one site's, or every\n * site's on the organization's Inbox.\n */\nconst InboxCampaignsWidget = lazy(\n  () => import('./components/inbox-campaigns-widget'),\n)\n\n/** The Emails page's Messages section: the list, one message, its composer. */\nconst EmailMessagesWidget = lazy(\n  () => import('./components/email-messages-widget'),\n)\n\n/** What the sends built from one template did, on the template's page. */\nconst EmailTemplateReportCard = lazy(\n  () => import('./components/email-template-report-card'),\n)\n\n/** Who received the sends built from one template, on the template's page. */\nconst EmailRecipientsCard = lazy(\n  () => import('./components/email-recipients-card'),\n)\n\n/** Loaded where a record page draws one of the attribution zones. */\nconst RecordAttributionWidget = lazy(\n  () => import('./components/record-attribution-widget'),\n)\n\n/** The site's section experiments, reported to the besigner's Interactions section. */\nconst BesignerSectionExperiments = lazy(\n  () => import('./components/besigner-section-experiments'),\n)\n\n/**\n * Marketing feature plugin (AGL-395). Console-only — overlays and popups\n * render on published sites through the tenant runtime, not a canvas\n * element of their own, so there is no UI bundle. The console half declares\n * the Marketing nav + page through the ConsoleExtension registry (always-on;\n * the surface itself is not release-flagged — its overlays/A-B cards run\n * their own per-plan checks off the passed `org`). The popup image picker\n * uses the shell's media browser via `useMediaPicker`.\n */\nexport function registerMarketingConsole(): void {\n  // How the Import & export hub names campaigns in a workspace package (AGL-3535).\n  registerPluginTransferResourceUi('marketing.campaigns', { label: 'Campaigns' }, { pluginId: BUNDLE_ID })\n  /*\n   * The two positions the A/B testing card hosts (AGL-2914), declared before\n   * the extension that draws the card. An id another plugin has already taken\n   * is refused, naming both. What each zone hands a widget is carried on its\n   * token, in `components/experiment-zones`, so a widget elsewhere is written\n   * against the same shape without importing this plugin.\n   */\n  registerPluginZone(\n    {\n      zone: EXPERIMENT_VARIANTS_ZONE,\n      label: 'A/B test variants',\n      surface: 'console',\n      description:\n        'In the experiment editor, beside the variants. A widget here proposes copy for the variants the editor holds; the dialog’s Save is the write, and nothing a widget returns starts or changes a test.',\n    },\n    // Named rather than left to the loader's marker, because this function is\n    // also called directly — by a spec, and by an app that loads the plugin\n    // without the loader — and a zone with no owner is refused.\n    { pluginId: BUNDLE_ID },\n  )\n  registerPluginZone(\n    {\n      zone: EXPERIMENT_RESULT_ZONE,\n      label: 'A/B test result',\n      surface: 'console',\n      description:\n        'Below the results of one test. A widget here explains what the figures show. There is nothing to apply, and a widget may not declare a winner the card has not.',\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  /*\n   * What a campaign email asks of whichever plugin keeps the mail itself —\n   * the topic catalog, the sending identities, the design document and its\n   * renderer. Each is a zone the composer or a message's page hosts; see\n   * `components/campaign-email-zones` for what each hands a widget. All are\n   * `bare`: a widget there is a field, a button, a drawer or nothing at all,\n   * and the stack's spacing around it would be a gap in a form.\n   */\n  const bareZone = <Props,>(\n    zone: PluginZone<Props>,\n    label: string,\n    description: string,\n  ) =>\n    registerPluginZone(\n      { zone, label, description, surface: 'console', layout: 'bare' },\n      { pluginId: BUNDLE_ID },\n    )\n  bareZone(\n    CAMPAIGN_TOPIC_SELECT_ZONE,\n    'An email’s topic',\n    'In the campaign composer’s field stack. A widget here is the picker for the stream the email belongs to: it is handed the chosen id and reports a new one through `onChange`. The composer records it; the widget writes nothing.',\n  )\n  bareZone(\n    CAMPAIGN_TOPIC_OPTIONS_ZONE,\n    'The topics a campaign can open on',\n    'Beside the drawers that create and edit a campaign. A widget here draws nothing: while `enabled` it reads the streams a recipient can still leave and answers through `onTopics`.',\n  )\n  bareZone(\n    CAMPAIGN_SENDER_EDITOR_ZONE,\n    'Add a sender while composing',\n    'Mounted by the campaign composer once its author asks to add a sender. A widget here is that editor, open in its add mode; `onSaved` names the sender it created.',\n  )\n  bareZone(\n    CAMPAIGN_DESIGN_CREATE_ZONE,\n    'A design for one email',\n    'In the campaign composer, beside the design picker. A widget here is the control that mints a design document and names it through `onCreated`; the composer records the choice on the campaign and opens the editor.',\n  )\n  bareZone(\n    CAMPAIGN_DESIGN_PREVIEW_ZONE,\n    'A sent email as an inbox receives it',\n    'On one message’s page. A widget here renders the stored design, or the plain-text body, through the renderer the send path uses.',\n  )\n  registerMarketingRecordRoutes()\n  // The site's overlays, for another plugin's picker to list (AGL-3080).\n  registerMarketingRecordLists()\n  Aglyn.registerConsoleExtension({\n    pluginId: BUNDLE_ID,\n    displayName: 'Marketing',\n    /*\n     * The host dashboard's `Last campaign` card (AGL-433). A widget rather\n     * than a direct import by the dashboard page, so it appears only on\n     * workspaces that have the plugin that owns the campaign history — a card\n     * about campaigns on a console with no campaigns page could only ever be\n     * blank, and its header links straight into `/marketing/campaigns`.\n     */\n    widgets: [\n      {\n        slot: Aglyn.CONSOLE_WIDGET_SLOTS.hostDashboard,\n        // The id a reader's dashboard preferences already name — it is what\n        // `isDashboardWidgetHidden` and the customize order are keyed on, so\n        // it is persisted and does not follow the plugin.\n        widgetId: 'email-campaign-glance',\n        title: 'Last campaign',\n        Component: CampaignGlanceCard,\n      },\n      // Which campaign or link brought a person, drawn where the plugins that\n      // keep and list people host a zone for it. They hand over what the\n      // record is and its id; neither imports this plugin.\n      {\n        slot: 'crmRecordAttribution',\n        widgetId: 'marketing-crm-record-attribution',\n        title: 'Campaign attribution',\n        Component: RecordAttributionWidget,\n      },\n      // The Emails page hosts its Messages section as a zone: a message is\n      // one send of a campaign, and every action on it is this plugin's route.\n      {\n        slot: 'emailMessages',\n        widgetId: 'marketing-email-messages',\n        title: 'Messages',\n        Component: EmailMessagesWidget,\n      },\n      // A template's page: what the sends built from it did, then who\n      // received them. The template is the Email plugin's; the sends are ours.\n      {\n        slot: 'emailTemplateReport',\n        widgetId: 'marketing-email-template-report',\n        title: 'Sent from this template',\n        Component: EmailTemplateReportCard,\n      },\n      {\n        slot: 'emailTemplateRecipients',\n        widgetId: 'marketing-email-template-recipients',\n        title: 'Recipients',\n        Component: EmailRecipientsCard,\n      },\n      // The Inbox's Campaigns tab is a zone; this is the card that fills it.\n      {\n        slot: 'inboxCampaigns',\n        widgetId: 'marketing-inbox-campaigns',\n        title: 'Campaigns',\n        Component: InboxCampaignsWidget,\n      },\n      {\n        slot: 'inboxRecordAttribution',\n        widgetId: 'marketing-inbox-record-attribution',\n        title: 'Campaign attribution',\n        Component: RecordAttributionWidget,\n      },\n      // The section experiments the besigner's Interactions section badges an\n      // element with and starts on a page's element; reported, never drawn.\n      {\n        slot: Aglyn.CONSOLE_WIDGET_SLOTS.besignerInteractions,\n        widgetId: 'marketing-besigner-section-experiments',\n        title: 'Section experiments',\n        Component: BesignerSectionExperiments,\n      },\n      // The staff organization page's sends and campaigns (AGL-3380), read\n      // only: staff see what the organization sent without joining it.\n      {\n        slot: Aglyn.CONSOLE_WIDGET_SLOTS.adminOrgDetail,\n        widgetId: 'marketing-staff-org-email',\n        title: 'Email campaigns',\n        Component: StaffOrgEmailCard,\n      },\n    ],\n    navItems: [\n      {\n        label: 'Marketing',\n        href: '/marketing',\n        // Sections as ROUTES (AGL-2501): each is a real URL the shell\n        // resolves and gates, so the page mounts the one being read.\n        sections: MARKETING_CONSOLE_SECTIONS,\n        navTabId: 'nav-tab-marketing',\n        icon: { path: mdiBullhornOutline.path },\n        header: {\n          title: 'Marketing',\n          icon: { path: mdiBullhornOutline.path },\n          docsTopic: 'marketingOverlays',\n        },\n        Component: MarketingConsolePage,\n      },\n    ],\n    /*\n     * The ORGANIZATION's Marketing hub, at `/[orgSlug]/marketing`: every\n     * section the site hub has, over every site. Campaigns and their sequence\n     * rollups belong to the organization, so this is where one campaign is\n     * placed across several sites; overlays, tests and conversions stay each\n     * site's and are read across them. Every site's mail is on the\n     * organization's Emails page, as a site's is on its own. The page is the\n     * same component; handed no site, it renders the org sections.\n     *\n     * It carries the SITE tab's id on purpose, the way the org CRM tab does:\n     * `release_marketing` names `nav-tab-marketing`, so one flag holds both\n     * halves of the surface, and the org half cannot ship while the site half\n     * is switched off.\n     */\n    orgNavItems: [\n      {\n        label: 'Marketing',\n        href: '/marketing',\n        sections: MARKETING_ORG_CONSOLE_SECTIONS,\n        navTabId: 'nav-tab-marketing',\n        icon: { path: mdiBullhornOutline.path },\n        header: {\n          title: 'Marketing',\n          icon: { path: mdiBullhornOutline.path },\n          docsTopic: 'marketingOverlays',\n        },\n        Component: MarketingConsolePage,\n      },\n    ],\n  })\n}\n\nexport * from './site'\n"],"names":["Aglyn","registerPluginZone","mdiBullhornOutline","lazy","CAMPAIGN_DESIGN_CREATE_ZONE","CAMPAIGN_DESIGN_PREVIEW_ZONE","CAMPAIGN_SENDER_EDITOR_ZONE","CAMPAIGN_TOPIC_OPTIONS_ZONE","CAMPAIGN_TOPIC_SELECT_ZONE","EXPERIMENT_RESULT_ZONE","EXPERIMENT_VARIANTS_ZONE","MARKETING_CONSOLE_SECTIONS","MARKETING_ORG_CONSOLE_SECTIONS","registerPluginTransferResourceUi","BUNDLE_ID","StaffOrgEmailCard","registerMarketingRecordLists","registerMarketingRecordRoutes","MarketingConsolePage","CampaignGlanceCard","InboxCampaignsWidget","EmailMessagesWidget","EmailTemplateReportCard","EmailRecipientsCard","RecordAttributionWidget","BesignerSectionExperiments","registerMarketingConsole","label","pluginId","zone","surface","description","bareZone","layout","registerConsoleExtension","displayName","widgets","slot","CONSOLE_WIDGET_SLOTS","hostDashboard","widgetId","title","Component","besignerInteractions","adminOrgDetail","navItems","href","sections","navTabId","icon","path","header","docsTopic","orgNavItems"],"mappings":"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"}

package/src/lib/preview-props.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/plugins/marketing/src/lib/preview-props.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { collection, getDocs, limit, query, type Firestore } from 'firebase/firestore'\nimport type { HostAction } from '@aglyn/aglyn'\nimport type { SiteRuntimePreviewContext } from '@aglyn/aglyn'\nimport { compileClientAutomations, type RawHostAction } from './model'\n\n/**\n * The marketing site-runtime's client-side page-props for the besigner\n * Preview (AGL-830). No server enricher runs there, so this reads the host's\n * `actions` with the client SDK and compiles them the same way the enricher\n * does — the Preview then mounts the SAME MarketingSiteRuntime the tenant\n * uses, and hover-to-open menus/drawers behave exactly like the live site.\n *\n * Compiled with `actionsEntitled: false`, so only basic PRESENTATIONAL steps\n * (menu/drawer/show-hide/class/nav) run and `hasServerSteps` stays false —\n * preview never fires analytics, webhooks, or server events. `matchAllPaths`\n * because the Preview renders one composed screen and scopes relevance by\n * selector match, not page path.\n */\nexport async function loadMarketingPreviewProps(\n  ctx: SiteRuntimePreviewContext,\n): Promise<Record<string, unknown>> {\n  const { hostId, firestore } = ctx\n  if (!hostId || !firestore) return {}\n  try {\n    const snapshot = await getDocs(\n      query(\n        collection(firestore as Firestore, 'hosts', hostId, 'actions'),\n        limit(50),\n      ),\n    )\n    const actions: RawHostAction[] = snapshot.docs.map((doc) => ({\n      id: doc.id,\n      action: doc.data() as HostAction,\n    }))\n    const clientAutomations = compileClientAutomations(actions, {\n      path: '/',\n      actionsEntitled: false,\n      allowJs: false,\n      matchAllPaths: true,\n    })\n    return { clientAutomations }\n  } catch (error) {\n    console.error('marketing: preview props load failed', error)\n    return {}\n  }\n}\n"],"names":["collection","getDocs","limit","query","compileClientAutomations","loadMarketingPreviewProps","ctx","hostId","firestore","snapshot","actions","docs","map","doc","id","action","data","clientAutomations","path","actionsEntitled","allowJs","matchAllPaths","error","console"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,UAAU,EAAEC,OAAO,EAAEC,KAAK,EAAEC,KAAK,QAAwB,qBAAoB;AAGtF,SAASC,wBAAwB,QAA4B,mBAAS;AAEtE;;;;;;;;;;;;CAYC,GACD,OAAO,eAAeC,0BACpBC,GAA8B;IAE9B,MAAM,EAAEC,MAAM,EAAEC,SAAS,EAAE,GAAGF;IAC9B,IAAI,CAACC,UAAU,CAACC,WAAW,OAAO,CAAC;IACnC,IAAI;QACF,MAAMC,WAAW,MAAMR,QACrBE,MACEH,WAAWQ,WAAwB,SAASD,QAAQ,YACpDL,MAAM;QAGV,MAAMQ,UAA2BD,SAASE,IAAI,CAACC,GAAG,CAAC,CAACC,MAAS,CAAA;gBAC3DC,IAAID,IAAIC,EAAE;gBACVC,QAAQF,IAAIG,IAAI;YAClB,CAAA;QACA,MAAMC,oBAAoBb,yBAAyBM,SAAS;YAC1DQ,MAAM;YACNC,iBAAiB;YACjBC,SAAS;YACTC,eAAe;QACjB;QACA,OAAO;YAAEJ;QAAkB;IAC7B,EAAE,OAAOK,OAAO;QACdC,QAAQD,KAAK,CAAC,wCAAwCA;QACtD,OAAO,CAAC;IACV;AACF"}
+{"version":3,"sources":["../../../../../../libs/plugins/marketing/src/lib/preview-props.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { collection, getDocs, limit, query, type Firestore } from 'firebase/firestore'\nimport type { SiteRuntimePreviewContext } from '@aglyn/aglyn'\nimport { compileClientAutomations, type RawHostAction } from './model'\n\n/**\n * The marketing site-runtime's client-side page-props for the besigner\n * Preview (AGL-830). No server enricher runs there, so this reads the host's\n * `actions` with the client SDK and compiles them the same way the enricher\n * does — the Preview then mounts the SAME MarketingSiteRuntime the tenant\n * uses, and hover-to-open menus/drawers behave exactly like the live site.\n *\n * Compiled with `actionsEntitled: false`, so only basic PRESENTATIONAL steps\n * (menu/drawer/show-hide/class/nav) run and `hasServerSteps` stays false —\n * preview never fires analytics, webhooks, or server events. `matchAllPaths`\n * because the Preview renders one composed screen and scopes relevance by\n * selector match, not page path.\n */\nexport async function loadMarketingPreviewProps(\n  ctx: SiteRuntimePreviewContext,\n): Promise<Record<string, unknown>> {\n  const { hostId, firestore } = ctx\n  if (!hostId || !firestore) return {}\n  try {\n    const snapshot = await getDocs(\n      query(\n        collection(firestore as Firestore, 'hosts', hostId, 'actions'),\n        limit(50),\n      ),\n    )\n    const actions: RawHostAction[] = snapshot.docs.map((doc) => ({\n      id: doc.id,\n      action: doc.data() as RawHostAction['action'],\n    }))\n    const clientAutomations = compileClientAutomations(actions, {\n      path: '/',\n      actionsEntitled: false,\n      allowJs: false,\n      matchAllPaths: true,\n    })\n    return { clientAutomations }\n  } catch (error) {\n    console.error('marketing: preview props load failed', error)\n    return {}\n  }\n}\n"],"names":["collection","getDocs","limit","query","compileClientAutomations","loadMarketingPreviewProps","ctx","hostId","firestore","snapshot","actions","docs","map","doc","id","action","data","clientAutomations","path","actionsEntitled","allowJs","matchAllPaths","error","console"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,UAAU,EAAEC,OAAO,EAAEC,KAAK,EAAEC,KAAK,QAAwB,qBAAoB;AAEtF,SAASC,wBAAwB,QAA4B,mBAAS;AAEtE;;;;;;;;;;;;CAYC,GACD,OAAO,eAAeC,0BACpBC,GAA8B;IAE9B,MAAM,EAAEC,MAAM,EAAEC,SAAS,EAAE,GAAGF;IAC9B,IAAI,CAACC,UAAU,CAACC,WAAW,OAAO,CAAC;IACnC,IAAI;QACF,MAAMC,WAAW,MAAMR,QACrBE,MACEH,WAAWQ,WAAwB,SAASD,QAAQ,YACpDL,MAAM;QAGV,MAAMQ,UAA2BD,SAASE,IAAI,CAACC,GAAG,CAAC,CAACC,MAAS,CAAA;gBAC3DC,IAAID,IAAIC,EAAE;gBACVC,QAAQF,IAAIG,IAAI;YAClB,CAAA;QACA,MAAMC,oBAAoBb,yBAAyBM,SAAS;YAC1DQ,MAAM;YACNC,iBAAiB;YACjBC,SAAS;YACTC,eAAe;QACjB;QACA,OAAO;YAAEJ;QAAkB;IAC7B,EAAE,OAAOK,OAAO;QACdC,QAAQD,KAAK,CAAC,wCAAwCA;QACtD,OAAO,CAAC;IACV;AACF"}

package/src/lib/server/campaign-attribution-store.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/** The per-host collection of conversion attribution records. */
+export declare const CAMPAIGN_ATTRIBUTIONS_COLLECTION = "campaignAttributions";
+/**
+ * Removes every conversion attributed to one person, across every site.
+ *
+ * ## Why an erasure reaches these at all
+ *
+ * An attribution is a claim about a person: "this human came from that
+ * campaign and then did this". It is the same personal fact as the click
+ * stamp it was derived from, and the same erasure deletes those —
+ * `eraseEmailCampaignTouches` drops `campaignTouches` from the person's
+ * delivery document, beside the engagement stamps the platform drops. A summary that outlived its source would
+ * leave an erasure that removed the evidence and kept the conclusion.
+ *
+ * ## Why a collection-group query
+ *
+ * The record is per HOST, because that is where a site's own reporting reads
+ * it. An erasure arrives as an ADDRESS and knows nothing about which sites
+ * that person ever visited. The collection group is the join between the two,
+ * and `personKey` is on the record precisely so one exists — declared in
+ * `cloud/firebase-firestore.indexes.json` with `COLLECTION_GROUP` scope,
+ * because a collection-group query gets no automatic single-field index and
+ * would otherwise fail with FAILED_PRECONDITION at the moment somebody asked
+ * to be forgotten.
+ *
+ * ## The order's own record is NOT touched
+ *
+ * `emailAttributions` holds a commercial fact about a sale, keyed by the
+ * order's id and carrying no address — the revenue join says so where it
+ * writes it. This holds a record of a person's behavior under a key derived
+ * from their address. Different facts, different answers, and the split is
+ * why both are defensible.
+ *
+ * Never throws: an erasure that fails on one leg must still complete the
+ * others, and the caller reports what it removed.
+ *
+ * @returns how many records were removed.
+ */
+export declare function eraseCampaignAttributionsForPersonKey(key: string | null | undefined, firestore?: any): Promise<number>;

package/src/lib/server/campaign-attribution-store.js

@@ -0,0 +1,98 @@
+/**
+ * @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.
+ */ /**
+ * Where conversion attributions are kept, and how an erasure reaches them.
+ *
+ * ## Why this is a leaf module and not part of the join
+ *
+ * The erasure runs from the plugin's conversion creditor
+ * (`conversion-creditor.ts`), which the platform's address erasure asks
+ * beside the delivery log — the same request that drops the person's
+ * campaign touches (`email-campaign-touch.ts`), which is the point, because
+ * an attribution is a conclusion drawn from those touches and a conclusion
+ * that outlives its evidence is an erasure that did not happen. The join
+ * READS the touch module too (`readEmailCampaignTouch` is one half of the
+ * last-touch comparison), and a module that both defined the collection and
+ * read the touches would be a second place the creditor's two halves meet.
+ * Under jest a cycle between such modules resolves to `undefined` at import
+ * time rather than failing loudly, which is how an erasure comes to silently
+ * do nothing while its test passes.
+ *
+ * So the collection name and the sweep live here, importing nothing but
+ * Firestore, and both sides import this.
+ */ import firebaseAdmin from "@aglyn/tenant-data-admin/server/firebase-admin";
+const defaultFirestore = ()=>firebaseAdmin.app().firestore();
+/** The per-host collection of conversion attribution records. */ export const CAMPAIGN_ATTRIBUTIONS_COLLECTION = 'campaignAttributions';
+/** How many records one erasure pass removes per batch. */ const ERASURE_BATCH = 400;
+/**
+ * Removes every conversion attributed to one person, across every site.
+ *
+ * ## Why an erasure reaches these at all
+ *
+ * An attribution is a claim about a person: "this human came from that
+ * campaign and then did this". It is the same personal fact as the click
+ * stamp it was derived from, and the same erasure deletes those —
+ * `eraseEmailCampaignTouches` drops `campaignTouches` from the person's
+ * delivery document, beside the engagement stamps the platform drops. A summary that outlived its source would
+ * leave an erasure that removed the evidence and kept the conclusion.
+ *
+ * ## Why a collection-group query
+ *
+ * The record is per HOST, because that is where a site's own reporting reads
+ * it. An erasure arrives as an ADDRESS and knows nothing about which sites
+ * that person ever visited. The collection group is the join between the two,
+ * and `personKey` is on the record precisely so one exists — declared in
+ * `cloud/firebase-firestore.indexes.json` with `COLLECTION_GROUP` scope,
+ * because a collection-group query gets no automatic single-field index and
+ * would otherwise fail with FAILED_PRECONDITION at the moment somebody asked
+ * to be forgotten.
+ *
+ * ## The order's own record is NOT touched
+ *
+ * `emailAttributions` holds a commercial fact about a sale, keyed by the
+ * order's id and carrying no address — the revenue join says so where it
+ * writes it. This holds a record of a person's behavior under a key derived
+ * from their address. Different facts, different answers, and the split is
+ * why both are defensible.
+ *
+ * Never throws: an erasure that fails on one leg must still complete the
+ * others, and the caller reports what it removed.
+ *
+ * @returns how many records were removed.
+ */ export async function eraseCampaignAttributionsForPersonKey(key, firestore) {
+    if (!key || typeof key !== 'string') return 0;
+    const db = firestore != null ? firestore : defaultFirestore();
+    let removed = 0;
+    try {
+        // Bounded rather than `while (true)`: a pathological volume must not be
+        // able to hold an erasure request open indefinitely, and the pass that
+        // runs next picks up whatever a bounded one left.
+        for(let pass = 0; pass < 20; pass += 1){
+            const snapshot = await db.collectionGroup(CAMPAIGN_ATTRIBUTIONS_COLLECTION).where('personKey', '==', key).limit(ERASURE_BATCH).get();
+            if (snapshot.empty) break;
+            const batch = db.batch();
+            snapshot.docs.forEach((doc)=>batch.delete(doc.ref));
+            await batch.commit();
+            removed += snapshot.size;
+            if (snapshot.size < ERASURE_BATCH) break;
+        }
+    } catch (error) {
+        console.error('eraseCampaignAttributionsForPersonKey failed', error);
+    }
+    return removed;
+}
+
+//# sourceMappingURL=campaign-attribution-store.js.map

package/src/lib/server/campaign-attribution-store.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/server/campaign-attribution-store.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 * Where conversion attributions are kept, and how an erasure reaches them.\n *\n * ## Why this is a leaf module and not part of the join\n *\n * The erasure runs from the plugin's conversion creditor\n * (`conversion-creditor.ts`), which the platform's address erasure asks\n * beside the delivery log — the same request that drops the person's\n * campaign touches (`email-campaign-touch.ts`), which is the point, because\n * an attribution is a conclusion drawn from those touches and a conclusion\n * that outlives its evidence is an erasure that did not happen. The join\n * READS the touch module too (`readEmailCampaignTouch` is one half of the\n * last-touch comparison), and a module that both defined the collection and\n * read the touches would be a second place the creditor's two halves meet.\n * Under jest a cycle between such modules resolves to `undefined` at import\n * time rather than failing loudly, which is how an erasure comes to silently\n * do nothing while its test passes.\n *\n * So the collection name and the sweep live here, importing nothing but\n * Firestore, and both sides import this.\n */\n\nimport firebaseAdmin from '@aglyn/tenant-data-admin/server/firebase-admin'\n\nconst defaultFirestore = () => firebaseAdmin.app().firestore()\n\n/** The per-host collection of conversion attribution records. */\nexport const CAMPAIGN_ATTRIBUTIONS_COLLECTION = 'campaignAttributions'\n\n/** How many records one erasure pass removes per batch. */\nconst ERASURE_BATCH = 400\n\n/**\n * Removes every conversion attributed to one person, across every site.\n *\n * ## Why an erasure reaches these at all\n *\n * An attribution is a claim about a person: \"this human came from that\n * campaign and then did this\". It is the same personal fact as the click\n * stamp it was derived from, and the same erasure deletes those —\n * `eraseEmailCampaignTouches` drops `campaignTouches` from the person's\n * delivery document, beside the engagement stamps the platform drops. A summary that outlived its source would\n * leave an erasure that removed the evidence and kept the conclusion.\n *\n * ## Why a collection-group query\n *\n * The record is per HOST, because that is where a site's own reporting reads\n * it. An erasure arrives as an ADDRESS and knows nothing about which sites\n * that person ever visited. The collection group is the join between the two,\n * and `personKey` is on the record precisely so one exists — declared in\n * `cloud/firebase-firestore.indexes.json` with `COLLECTION_GROUP` scope,\n * because a collection-group query gets no automatic single-field index and\n * would otherwise fail with FAILED_PRECONDITION at the moment somebody asked\n * to be forgotten.\n *\n * ## The order's own record is NOT touched\n *\n * `emailAttributions` holds a commercial fact about a sale, keyed by the\n * order's id and carrying no address — the revenue join says so where it\n * writes it. This holds a record of a person's behavior under a key derived\n * from their address. Different facts, different answers, and the split is\n * why both are defensible.\n *\n * Never throws: an erasure that fails on one leg must still complete the\n * others, and the caller reports what it removed.\n *\n * @returns how many records were removed.\n */\nexport async function eraseCampaignAttributionsForPersonKey(\n  key: string | null | undefined,\n  firestore?: any,\n): Promise<number> {\n  if (!key || typeof key !== 'string') return 0\n  const db = firestore ?? defaultFirestore()\n  let removed = 0\n  try {\n    // Bounded rather than `while (true)`: a pathological volume must not be\n    // able to hold an erasure request open indefinitely, and the pass that\n    // runs next picks up whatever a bounded one left.\n    for (let pass = 0; pass < 20; pass += 1) {\n      const snapshot = await db\n        .collectionGroup(CAMPAIGN_ATTRIBUTIONS_COLLECTION)\n        .where('personKey', '==', key)\n        .limit(ERASURE_BATCH)\n        .get()\n      if (snapshot.empty) break\n      const batch = db.batch()\n      snapshot.docs.forEach((doc: any) => batch.delete(doc.ref))\n      await batch.commit()\n      removed += snapshot.size\n      if (snapshot.size < ERASURE_BATCH) break\n    }\n  } catch (error) {\n    console.error('eraseCampaignAttributionsForPersonKey failed', error)\n  }\n  return removed\n}\n"],"names":["firebaseAdmin","defaultFirestore","app","firestore","CAMPAIGN_ATTRIBUTIONS_COLLECTION","ERASURE_BATCH","eraseCampaignAttributionsForPersonKey","key","db","removed","pass","snapshot","collectionGroup","where","limit","get","empty","batch","docs","forEach","doc","delete","ref","commit","size","error","console"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;;;;;CAoBC,GAED,OAAOA,mBAAmB,iDAAgD;AAE1E,MAAMC,mBAAmB,IAAMD,cAAcE,GAAG,GAAGC,SAAS;AAE5D,+DAA+D,GAC/D,OAAO,MAAMC,mCAAmC,uBAAsB;AAEtE,yDAAyD,GACzD,MAAMC,gBAAgB;AAEtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCC,GACD,OAAO,eAAeC,sCACpBC,GAA8B,EAC9BJ,SAAe;IAEf,IAAI,CAACI,OAAO,OAAOA,QAAQ,UAAU,OAAO;IAC5C,MAAMC,KAAKL,oBAAAA,YAAaF;IACxB,IAAIQ,UAAU;IACd,IAAI;QACF,wEAAwE;QACxE,uEAAuE;QACvE,kDAAkD;QAClD,IAAK,IAAIC,OAAO,GAAGA,OAAO,IAAIA,QAAQ,EAAG;YACvC,MAAMC,WAAW,MAAMH,GACpBI,eAAe,CAACR,kCAChBS,KAAK,CAAC,aAAa,MAAMN,KACzBO,KAAK,CAACT,eACNU,GAAG;YACN,IAAIJ,SAASK,KAAK,EAAE;YACpB,MAAMC,QAAQT,GAAGS,KAAK;YACtBN,SAASO,IAAI,CAACC,OAAO,CAAC,CAACC,MAAaH,MAAMI,MAAM,CAACD,IAAIE,GAAG;YACxD,MAAML,MAAMM,MAAM;YAClBd,WAAWE,SAASa,IAAI;YACxB,IAAIb,SAASa,IAAI,GAAGnB,eAAe;QACrC;IACF,EAAE,OAAOoB,OAAO;QACdC,QAAQD,KAAK,CAAC,gDAAgDA;IAChE;IACA,OAAOhB;AACT"}