@aglyn/plugins-email 1.0.0-beta.143

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 CampaignRate, type CampaignStats } from '@aglyn/shared-ui-email-campaigns/model/campaign-report';
+/** A rate over a sum, carrying how many campaigns the sum covers. */
+export type TemplateRate = CampaignRate;
+/**
+ * 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: CampaignStats | 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 { campaignRate } from "@aglyn/shared-ui-email-campaigns/model/campaign-report";
+import { emailAudienceLabel } from "@aglyn/shared-ui-email-campaigns/model/email-record";
+/** 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 : campaignRate(delivered, total(withDelivery, 'sent'), acrossLabel('sent', withDelivery.length, all)),
+        open: campaignRate(uniqueOpens != null ? uniqueOpens : undefined, withUniqueOpens.length ? total(withUniqueOpens, 'delivered') : undefined, acrossLabel('delivered', withUniqueOpens.length, all)),
+        click: campaignRate(uniqueClicks != null ? uniqueClicks : undefined, withClickTracking.length ? total(withClickTracking, 'delivered') : undefined, acrossLabel('delivered', withClickTracking.length, all)),
+        clickToOpen: campaignRate(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: campaignRate(total(sentCampaigns, 'bounced'), sent, acrossLabel('sent', all, all)),
+        complaint: campaignRate(withDelivery.length ? total(withDelivery, 'complained') : undefined, delivered != null ? delivered : undefined, acrossLabel('delivered', withDelivery.length, all)),
+        unsubscribe: campaignRate(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/email/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  campaignRate,\n  type CampaignRate,\n  type CampaignStats,\n} from '@aglyn/shared-ui-email-campaigns/model/campaign-report'\nimport {\n  emailAudienceLabel,\n} from '@aglyn/shared-ui-email-campaigns/model/email-record'\n\n/** A rate over a sum, carrying how many campaigns the sum covers. */\nexport type TemplateRate = CampaignRate\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: CampaignStats | 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 CampaignStats,\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      : campaignRate(\n          delivered,\n          total(withDelivery, 'sent'),\n          acrossLabel('sent', withDelivery.length, all),\n        ),\n    open: campaignRate(\n      uniqueOpens ?? undefined,\n      withUniqueOpens.length ? total(withUniqueOpens, 'delivered') : undefined,\n      acrossLabel('delivered', withUniqueOpens.length, all),\n    ),\n    click: campaignRate(\n      uniqueClicks ?? undefined,\n      withClickTracking.length\n        ? total(withClickTracking, 'delivered')\n        : undefined,\n      acrossLabel('delivered', withClickTracking.length, all),\n    ),\n    clickToOpen: campaignRate(\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: campaignRate(\n      total(sentCampaigns, 'bounced'),\n      sent,\n      acrossLabel('sent', all, all),\n    ),\n    complaint: campaignRate(\n      withDelivery.length ? total(withDelivery, 'complained') : undefined,\n      delivered ?? undefined,\n      acrossLabel('delivered', withDelivery.length, all),\n    ),\n    unsubscribe: campaignRate(\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":["campaignRate","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.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @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.
+ */
+/**
+ * Console half (AGL-395): registers the Emails nav item + page in the
+ * ConsoleExtension registry. Safe to call at console app load — the page is
+ * lazy, so no besigner/canvas code loads. The shell renders the Emails nav
+ * item and, via its generic plugin route, the page (the messages and their
+ * composer, the templates, the audience lists, the topic catalog, the sending
+ * identities and the suppression list) — with no edit to the console's own
+ * nav or page files.
+ */
+export declare function registerEmailConsole(): void;
+export * from './site';

package/src/lib/plugin.js

@@ -0,0 +1,163 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import * as Aglyn from "@aglyn/aglyn";
+import { registerPluginZone } from "@aglyn/aglyn/plugin-manager/plugin-zones";
+import { mdiEmailOutline } from "@aglyn/shared-data-mdi";
+import { lazy } from "react";
+import { EMAIL_MESSAGES_ZONE, EMAIL_TEMPLATE_RECIPIENTS_ZONE } from "./components/email-zones.js";
+import { EMAILS_CONSOLE_SECTIONS } from "./components/emails-console-sections.js";
+import { BUNDLE_ID } from "./constants/bundle-common.js";
+/** Code-split: the Emails console page only loads when opened. */ const EmailsConsolePage = lazy(()=>import("./components/emails-console-page.js"));
+/*
+ * What this plugin draws inside a campaign's own pages, each loaded only where
+ * the campaign owner's zone is on screen.
+ */ const CampaignTopicSelect = lazy(()=>import("./components/campaign-topic-select.js"));
+const CampaignTopicOptionsWidget = lazy(()=>import("./components/campaign-topic-options-widget.js"));
+const CampaignSenderEditorWidget = lazy(()=>import("./components/campaign-sender-editor-widget.js"));
+const CampaignDesignCreateWidget = lazy(()=>import("./components/campaign-design-create-widget.js"));
+const EmailDesignPreview = lazy(()=>import("./components/email-design-preview.js"));
+/**
+ * Console half (AGL-395): registers the Emails nav item + page in the
+ * ConsoleExtension registry. Safe to call at console app load — the page is
+ * lazy, so no besigner/canvas code loads. The shell renders the Emails nav
+ * item and, via its generic plugin route, the page (the messages and their
+ * composer, the templates, the audience lists, the topic catalog, the sending
+ * identities and the suppression list) — with no edit to the console's own
+ * nav or page files.
+ */ export function registerEmailConsole() {
+    /*
+   * The two places this plugin's pages hand over to whichever plugin owns
+   * campaigns. A message is one send of a campaign and every action on it is
+   * that plugin's route, so the Messages section is a zone this page hosts
+   * rather than pages this plugin imports; the same holds for the recipients
+   * table under a template's report. Named, because a spec calls this
+   * registrar without the loader.
+   */ registerPluginZone({
+        zone: EMAIL_MESSAGES_ZONE,
+        label: 'The Emails page’s Messages section',
+        surface: 'console',
+        layout: 'bare',
+        description: 'The whole body of `/emails/messages` and the routes under it. A widget here is handed the site, the Emails page’s base path and the segments under `messages`, and draws the list, one message’s report or its composer.'
+    }, {
+        pluginId: BUNDLE_ID
+    });
+    registerPluginZone({
+        zone: EMAIL_TEMPLATE_RECIPIENTS_ZONE,
+        label: 'Who received a template’s emails',
+        surface: 'console',
+        description: 'On one template’s page, under its report. A widget here lists the recipients of every send built from that template; it is handed the site and the template’s screen id.'
+    }, {
+        pluginId: BUNDLE_ID
+    });
+    Aglyn.registerConsoleExtension({
+        pluginId: BUNDLE_ID,
+        displayName: 'Email',
+        /*
+     * WHO may open the email console, declared so the shell enforces it.
+     *
+     * The audiences section reads `orgs/{orgId}/lists/{listId}/members`, and
+     * those members are enrolled CONTACTS — an address, a name, and the
+     * consent basis recording why the person may be mailed. That is the same
+     * org-shared people data the CRM holds, reached from a different page.
+     *
+     * The rules gate those reads on `isOrgWideMember()` ALONE, with no role
+     * condition, so org-wide membership of any role is enough to list every
+     * audience the organization has and everybody on it. An org VIEWER — the
+     * role that exists to read and change nothing — therefore reads the whole
+     * marketing audience today. `data.manage` is what closes that: it
+     * defaults to owner, admin and editor, so the population it admits is
+     * exactly the one `server-list-gate.ts` accepts a list write from, and
+     * the viewer it excludes is the reader the rules never excluded.
+     *
+     * `data.manage` rather than a key of this plugin's own for the reason the
+     * catalog gives for refusing a `marketing.manage`: campaigns are written
+     * client-direct against rules that gate on the HOST role, so a new
+     * org-level key would name an action with no org-level boundary under it.
+     * `data.manage` is not in that position — it already governs the
+     * org-shared data this surface exposes, and the list gate already reads
+     * the roles it defaults to.
+     *
+     * A SITE COLLABORATOR holding it opens the page, and the answer is NOT
+     * the one Contacts reached. There the listener is scoped and the rules
+     * prove the same predicate per document; here the audiences read demands
+     * `isOrgWideMember()`, which a collaborator is not, so the org-shared
+     * half is already refused beneath the console and the half that remains —
+     * this site's own messages, templates and sending identities — is theirs.
+     * Refusing the surface outright would take that away to close nothing.
+     */ permission: 'data.manage',
+        /*
+     * The mail a campaign rides on is this plugin's — the topic catalog, the
+     * sending identities, the design document and its renderer — so each is
+     * drawn here, in a zone the campaign owner's composer and message page
+     * host. Every one reports through a callback; none writes a campaign.
+     */ widgets: [
+            {
+                slot: 'campaignTopicSelect',
+                widgetId: 'email-campaign-topic-select',
+                title: 'Topic',
+                Component: CampaignTopicSelect
+            },
+            {
+                slot: 'campaignTopicOptions',
+                widgetId: 'email-campaign-topic-options',
+                title: 'Topics',
+                Component: CampaignTopicOptionsWidget
+            },
+            {
+                slot: 'campaignSenderEditor',
+                widgetId: 'email-campaign-sender-editor',
+                title: 'Add a sender',
+                Component: CampaignSenderEditorWidget
+            },
+            {
+                slot: 'campaignDesignCreate',
+                widgetId: 'email-campaign-design-create',
+                title: 'Design this email',
+                Component: CampaignDesignCreateWidget
+            },
+            {
+                slot: 'campaignDesignPreview',
+                widgetId: 'email-campaign-design-preview',
+                title: 'Preview',
+                Component: EmailDesignPreview
+            }
+        ],
+        navItems: [
+            {
+                label: 'Emails',
+                href: '/emails',
+                icon: {
+                    path: mdiEmailOutline.path
+                },
+                // Sections as ROUTES (AGL-2501): `/emails/messages` and friends are
+                // real URLs the shell resolves and gates, so the page mounts the one
+                // being read instead of subscribing all six.
+                sections: EMAILS_CONSOLE_SECTIONS,
+                header: {
+                    title: 'Emails',
+                    icon: {
+                        path: mdiEmailOutline.path
+                    },
+                    docsTopic: 'emailCampaigns'
+                },
+                Component: EmailsConsolePage
+            }
+        ]
+    });
+}
+export * from "./site.js";
+
+//# sourceMappingURL=plugin.js.map