@aglyn/plugins-marketing 1.0.0-beta.143

package/src/lib/server/lists-materialize.js

@@ -0,0 +1,130 @@
+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.
+ */ import { writeCronBeat } from "@aglyn/aglyn/server";
+import { firebaseAdmin, materializeDynamicList } from "@aglyn/tenant-data-admin";
+/**
+ * The scheduled sweep that keeps dynamic lists fresh
+ * (`docs/specs/email-overhaul.md` §3e).
+ *
+ * A dynamic list stores a rule and materializes into its `members`
+ * subcollection; without something re-running the rule, "dynamic" means
+ * "evaluated once at creation". This is that something: it rides the existing
+ * fifteen-minute Cloud Scheduler fast-cron beside the scheduled-campaign
+ * processor, so a dynamic list is never more than about fifteen minutes stale
+ * and no new scheduler job is provisioned.
+ *
+ * ## It chunks, because `sweepConsoleCron` will follow a cursor
+ *
+ * The caller in `cloud/functions` drives a route to completion by following
+ * `nextCursor`, so this answers `{ done, nextCursor }` rather than trying to
+ * sweep every list in one invocation. Two cursors are in play and they are
+ * different things: `nextCursor` here is a position in the LIST of lists, and
+ * the `evaluationCursor` stored on each list document is a position inside
+ * one list's own scan. Both resume; neither is allowed to shorten a
+ * membership.
+ *
+ * ## A failing list must not stop the sweep
+ *
+ * Each list is evaluated in its own try. One org's malformed rule, deleted
+ * segment or missing host would otherwise stop every list after it in
+ * document order from ever being evaluated — the failure would be invisible
+ * and would land on whichever customers sort last.
+ */ /** Dynamic lists evaluated per invocation. */ const LISTS_PER_CHUNK = 20;
+export const listsMaterializeHandler = async (req, res)=>{
+    var _ref;
+    var _req_body;
+    if (req.method !== 'POST') {
+        return res.status(405).json({
+            error: 'Method not allowed'
+        });
+    }
+    const cronSecret = process.env.CRON_SECRET;
+    if (!cronSecret) {
+        return res.status(501).json({
+            error: 'Dynamic lists are not configured (CRON_SECRET).'
+        });
+    }
+    if (req.headers['x-cron-secret'] !== cronSecret) {
+        return res.status(401).json({
+            error: 'Unauthenticated'
+        });
+    }
+    const firestore = firebaseAdmin.app().firestore();
+    /*
+   * The mark `/api/health/crons` reads to notice this job going away
+   * (AGL-1955). Nothing downstream ages when a dynamic list stops being
+   * re-evaluated — a stale membership looks exactly like a fresh one whose
+   * population happens not to have changed — so the invocation itself is the
+   * only honest thing to watch.
+   */ await writeCronBeat(firestore, 'lists-materialize');
+    const cursor = String((_ref = (_req_body = req.body) == null ? void 0 : _req_body['cursor']) != null ? _ref : '');
+    let query = firestore.collectionGroup('lists').where('kind', '==', 'dynamic').orderBy(firebaseAdmin.firestore.FieldPath.documentId()).limit(LISTS_PER_CHUNK);
+    /*
+   * A DocumentReference, not the raw string. A collection-group cursor on
+   * `documentId()` is compared against the FULL resource path, and a bare id
+   * would either be rejected or silently compared against the wrong thing —
+   * so the cursor travels as a path and is turned back into a reference here.
+   */ if (cursor) query = query.startAfter(firestore.doc(cursor));
+    const lists = await query.get();
+    const results = [];
+    let lastPath = '';
+    for (const listDoc of lists.docs){
+        var _listDoc_get;
+        lastPath = listDoc.ref.path;
+        const hostId = String((_listDoc_get = listDoc.get('hostId')) != null ? _listDoc_get : '');
+        if (!hostId) {
+            // A dynamic list with no host has no silos to draw from. Reported
+            // rather than thrown: it is a data problem on one list, and the sweep
+            // has other lists to get to.
+            results.push({
+                list: listDoc.ref.path,
+                error: 'no hostId'
+            });
+            continue;
+        }
+        try {
+            var _listDoc_get1;
+            const outcome = await materializeDynamicList({
+                listRef: listDoc.ref,
+                hostId,
+                rule: listDoc.get('rule'),
+                resume: (_listDoc_get1 = listDoc.get('evaluationCursor')) != null ? _listDoc_get1 : null
+            });
+            results.push(_extends({
+                list: listDoc.ref.path
+            }, outcome));
+        } catch (error) {
+            console.error('dynamic list materialize failed', listDoc.ref.path, error);
+            results.push({
+                list: listDoc.ref.path,
+                error: 'evaluation failed'
+            });
+        }
+    }
+    const done = lists.size < LISTS_PER_CHUNK;
+    return res.status(200).json({
+        ok: true,
+        evaluated: results.length,
+        results,
+        done,
+        // The caller refuses to loop on `done:false` with no cursor, which is the
+        // one shape that would re-read the same chunk for ever.
+        nextCursor: done ? null : lastPath
+    });
+};
+
+//# sourceMappingURL=lists-materialize.js.map

package/src/lib/server/lists-materialize.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/server/lists-materialize.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 { writeCronBeat, type PluginApiHandler } from '@aglyn/aglyn/server'\nimport {\n  firebaseAdmin,\n  materializeDynamicList,\n  type DynamicListCursor,\n} from '@aglyn/tenant-data-admin'\n\n/**\n * The scheduled sweep that keeps dynamic lists fresh\n * (`docs/specs/email-overhaul.md` §3e).\n *\n * A dynamic list stores a rule and materializes into its `members`\n * subcollection; without something re-running the rule, \"dynamic\" means\n * \"evaluated once at creation\". This is that something: it rides the existing\n * fifteen-minute Cloud Scheduler fast-cron beside the scheduled-campaign\n * processor, so a dynamic list is never more than about fifteen minutes stale\n * and no new scheduler job is provisioned.\n *\n * ## It chunks, because `sweepConsoleCron` will follow a cursor\n *\n * The caller in `cloud/functions` drives a route to completion by following\n * `nextCursor`, so this answers `{ done, nextCursor }` rather than trying to\n * sweep every list in one invocation. Two cursors are in play and they are\n * different things: `nextCursor` here is a position in the LIST of lists, and\n * the `evaluationCursor` stored on each list document is a position inside\n * one list's own scan. Both resume; neither is allowed to shorten a\n * membership.\n *\n * ## A failing list must not stop the sweep\n *\n * Each list is evaluated in its own try. One org's malformed rule, deleted\n * segment or missing host would otherwise stop every list after it in\n * document order from ever being evaluated — the failure would be invisible\n * and would land on whichever customers sort last.\n */\n\n/** Dynamic lists evaluated per invocation. */\nconst LISTS_PER_CHUNK = 20\n\nexport const listsMaterializeHandler: PluginApiHandler = async (req, res) => {\n  if (req.method !== 'POST') {\n    return res.status(405).json({ error: 'Method not allowed' })\n  }\n  const cronSecret = process.env.CRON_SECRET\n  if (!cronSecret) {\n    return res\n      .status(501)\n      .json({ error: 'Dynamic lists are not configured (CRON_SECRET).' })\n  }\n  if (req.headers['x-cron-secret'] !== cronSecret) {\n    return res.status(401).json({ error: 'Unauthenticated' })\n  }\n\n  const firestore = firebaseAdmin.app().firestore()\n  /*\n   * The mark `/api/health/crons` reads to notice this job going away\n   * (AGL-1955). Nothing downstream ages when a dynamic list stops being\n   * re-evaluated — a stale membership looks exactly like a fresh one whose\n   * population happens not to have changed — so the invocation itself is the\n   * only honest thing to watch.\n   */\n  await writeCronBeat(firestore, 'lists-materialize')\n\n  const cursor = String((req.body as Record<string, unknown>)?.['cursor'] ?? '')\n  let query = firestore\n    .collectionGroup('lists')\n    .where('kind', '==', 'dynamic')\n    .orderBy(firebaseAdmin.firestore.FieldPath.documentId())\n    .limit(LISTS_PER_CHUNK)\n  /*\n   * A DocumentReference, not the raw string. A collection-group cursor on\n   * `documentId()` is compared against the FULL resource path, and a bare id\n   * would either be rejected or silently compared against the wrong thing —\n   * so the cursor travels as a path and is turned back into a reference here.\n   */\n  if (cursor) query = query.startAfter(firestore.doc(cursor))\n\n  const lists = await query.get()\n  const results: Array<Record<string, unknown>> = []\n  let lastPath = ''\n  for (const listDoc of lists.docs) {\n    lastPath = listDoc.ref.path\n    const hostId = String(listDoc.get('hostId') ?? '')\n    if (!hostId) {\n      // A dynamic list with no host has no silos to draw from. Reported\n      // rather than thrown: it is a data problem on one list, and the sweep\n      // has other lists to get to.\n      results.push({ list: listDoc.ref.path, error: 'no hostId' })\n      continue\n    }\n    try {\n      const outcome = await materializeDynamicList({\n        listRef: listDoc.ref,\n        hostId,\n        rule: listDoc.get('rule'),\n        resume: (listDoc.get('evaluationCursor') as DynamicListCursor) ?? null,\n      })\n      results.push({ list: listDoc.ref.path, ...outcome })\n    } catch (error) {\n      console.error('dynamic list materialize failed', listDoc.ref.path, error)\n      results.push({ list: listDoc.ref.path, error: 'evaluation failed' })\n    }\n  }\n\n  const done = lists.size < LISTS_PER_CHUNK\n  return res.status(200).json({\n    ok: true,\n    evaluated: results.length,\n    results,\n    done,\n    // The caller refuses to loop on `done:false` with no cursor, which is the\n    // one shape that would re-read the same chunk for ever.\n    nextCursor: done ? null : lastPath,\n  })\n}\n"],"names":["writeCronBeat","firebaseAdmin","materializeDynamicList","LISTS_PER_CHUNK","listsMaterializeHandler","req","res","method","status","json","error","cronSecret","process","env","CRON_SECRET","headers","firestore","app","cursor","String","body","query","collectionGroup","where","orderBy","FieldPath","documentId","limit","startAfter","doc","lists","get","results","lastPath","listDoc","docs","ref","path","hostId","push","list","outcome","listRef","rule","resume","console","done","size","ok","evaluated","length","nextCursor"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,aAAa,QAA+B,sBAAqB;AAC1E,SACEC,aAAa,EACbC,sBAAsB,QAEjB,2BAA0B;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BC,GAED,4CAA4C,GAC5C,MAAMC,kBAAkB;AAExB,OAAO,MAAMC,0BAA4C,OAAOC,KAAKC;;QAwB5CD;IAvBvB,IAAIA,IAAIE,MAAM,KAAK,QAAQ;QACzB,OAAOD,IAAIE,MAAM,CAAC,KAAKC,IAAI,CAAC;YAAEC,OAAO;QAAqB;IAC5D;IACA,MAAMC,aAAaC,QAAQC,GAAG,CAACC,WAAW;IAC1C,IAAI,CAACH,YAAY;QACf,OAAOL,IACJE,MAAM,CAAC,KACPC,IAAI,CAAC;YAAEC,OAAO;QAAkD;IACrE;IACA,IAAIL,IAAIU,OAAO,CAAC,gBAAgB,KAAKJ,YAAY;QAC/C,OAAOL,IAAIE,MAAM,CAAC,KAAKC,IAAI,CAAC;YAAEC,OAAO;QAAkB;IACzD;IAEA,MAAMM,YAAYf,cAAcgB,GAAG,GAAGD,SAAS;IAC/C;;;;;;GAMC,GACD,MAAMhB,cAAcgB,WAAW;IAE/B,MAAME,SAASC,gBAAQd,YAAAA,IAAIe,IAAI,qBAAT,AAACf,SAAsC,CAAC,SAAS,mBAAI;IAC3E,IAAIgB,QAAQL,UACTM,eAAe,CAAC,SAChBC,KAAK,CAAC,QAAQ,MAAM,WACpBC,OAAO,CAACvB,cAAce,SAAS,CAACS,SAAS,CAACC,UAAU,IACpDC,KAAK,CAACxB;IACT;;;;;GAKC,GACD,IAAIe,QAAQG,QAAQA,MAAMO,UAAU,CAACZ,UAAUa,GAAG,CAACX;IAEnD,MAAMY,QAAQ,MAAMT,MAAMU,GAAG;IAC7B,MAAMC,UAA0C,EAAE;IAClD,IAAIC,WAAW;IACf,KAAK,MAAMC,WAAWJ,MAAMK,IAAI,CAAE;YAEVD;QADtBD,WAAWC,QAAQE,GAAG,CAACC,IAAI;QAC3B,MAAMC,SAASnB,QAAOe,eAAAA,QAAQH,GAAG,CAAC,qBAAZG,eAAyB;QAC/C,IAAI,CAACI,QAAQ;YACX,kEAAkE;YAClE,sEAAsE;YACtE,6BAA6B;YAC7BN,QAAQO,IAAI,CAAC;gBAAEC,MAAMN,QAAQE,GAAG,CAACC,IAAI;gBAAE3B,OAAO;YAAY;YAC1D;QACF;QACA,IAAI;gBAKSwB;YAJX,MAAMO,UAAU,MAAMvC,uBAAuB;gBAC3CwC,SAASR,QAAQE,GAAG;gBACpBE;gBACAK,MAAMT,QAAQH,GAAG,CAAC;gBAClBa,MAAM,GAAGV,gBAAAA,QAAQH,GAAG,CAAC,+BAAZG,gBAAyD;YACpE;YACAF,QAAQO,IAAI,CAAC;gBAAEC,MAAMN,QAAQE,GAAG,CAACC,IAAI;eAAKI;QAC5C,EAAE,OAAO/B,OAAO;YACdmC,QAAQnC,KAAK,CAAC,mCAAmCwB,QAAQE,GAAG,CAACC,IAAI,EAAE3B;YACnEsB,QAAQO,IAAI,CAAC;gBAAEC,MAAMN,QAAQE,GAAG,CAACC,IAAI;gBAAE3B,OAAO;YAAoB;QACpE;IACF;IAEA,MAAMoC,OAAOhB,MAAMiB,IAAI,GAAG5C;IAC1B,OAAOG,IAAIE,MAAM,CAAC,KAAKC,IAAI,CAAC;QAC1BuC,IAAI;QACJC,WAAWjB,QAAQkB,MAAM;QACzBlB;QACAc;QACA,0EAA0E;QAC1E,wDAAwD;QACxDK,YAAYL,OAAO,OAAOb;IAC5B;AACF,EAAC"}

package/src/lib/server/marketing-figures.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @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 { type PluginFigureReader } from '@aglyn/aglyn/plugin-manager/plugin-figures';
+/**
+ * A site's campaign and A/B testing results as figure tables another plugin
+ * reads by id (AGL-2915).
+ *
+ * The campaign table is what each send's report shows — delivered, and the
+ * open and click rates over delivered — through `campaignReport`, the one
+ * reader of a send's counters. The experiments table is what the A/B testing
+ * section shows, through the same variant comparison. No recipient, address
+ * or visitor reaches either: a campaign is named by its subject, a variant by
+ * its name.
+ */
+type Firestore = FirebaseFirestore.Firestore;
+/** Sends a campaign table reads, newest first, before it keeps those sent in the window. */
+export declare const CAMPAIGN_FIGURES_READ_LIMIT = 100;
+/** Experiments an experiments table reads. */
+export declare const EXPERIMENT_FIGURES_READ_LIMIT = 20;
+export declare function marketingFigureReaders(firestore: () => Firestore): PluginFigureReader[];
+/** Registers the campaign and A/B testing readers from the console surface, where insight jobs run. */
+export declare function registerMarketingFigureReaders(firestore: () => Firestore): void;
+export {};

package/src/lib/server/marketing-figures.js

@@ -0,0 +1,248 @@
+/**
+ * @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 { PLUGIN_FIGURE_MAX_ROWS, pluginFigureWindows, registerPluginFigureReader } from "@aglyn/aglyn/plugin-manager/plugin-figures";
+import { campaignReport } from "@aglyn/shared-ui-email-campaigns/model/campaign-report";
+import { EMAIL_CREATED_AT_FIELD, emailSendTimeMs } from "@aglyn/shared-ui-email-campaigns/model/email-record";
+import { compareVariants, summarizeVariantStats } from "../model/experiments.js";
+const MARKETING_PLUGIN_ID = 'marketing';
+/** Sends a campaign table reads, newest first, before it keeps those sent in the window. */ export const CAMPAIGN_FIGURES_READ_LIMIT = 100;
+/** Experiments an experiments table reads. */ export const EXPERIMENT_FIGURES_READ_LIMIT = 20;
+const WINDOWS = [
+    7,
+    14,
+    30,
+    90
+];
+const percent = (rate)=>rate ? Math.round(rate.value * 1000) / 10 : null;
+/** Rates pooled across sends: every numerator over every denominator, never an average of rates. */ function pooled(rates) {
+    const known = rates.filter((rate)=>rate !== null);
+    const denominator = known.reduce((sum, rate)=>sum + rate.denominator, 0);
+    if (!denominator) return null;
+    return Math.round(known.reduce((sum, rate)=>sum + rate.numerator, 0) / denominator * 1000) / 10;
+}
+export function marketingFigureReaders(firestore) {
+    return [
+        {
+            id: 'marketing.campaigns',
+            label: 'Campaigns',
+            description: 'Each campaign email sent from the site in the window: how many were delivered and the share of delivered messages opened and clicked, with every campaign together on the first row.',
+            scope: 'site',
+            windows: WINDOWS,
+            read: async (request)=>{
+                if (!request.hostId) return {
+                    ok: false,
+                    status: 400,
+                    error: 'Open a site to read its campaigns'
+                };
+                if (!WINDOWS.includes(request.days)) {
+                    return {
+                        ok: false,
+                        status: 400,
+                        error: 'That window is not one campaigns are read over'
+                    };
+                }
+                const { current } = pluginFigureWindows(request.now, request.days);
+                const snapshot = await firestore().collection('hosts').doc(request.hostId).collection('campaigns').orderBy(EMAIL_CREATED_AT_FIELD, 'desc').limit(CAMPAIGN_FIGURES_READ_LIMIT).get();
+                const sends = snapshot.docs.map((doc)=>{
+                    var _doc_data;
+                    return (_doc_data = doc.data()) != null ? _doc_data : {};
+                }).filter((record)=>{
+                    const sentAt = emailSendTimeMs(record);
+                    return Boolean(record['sentAt']) && sentAt >= current.startMs && sentAt < current.endMs;
+                }).map((record)=>{
+                    var _record_subject;
+                    return {
+                        subject: String((_record_subject = record['subject']) != null ? _record_subject : '').trim() || 'A campaign with no subject',
+                        report: campaignReport(record['stats'])
+                    };
+                });
+                const rows = [
+                    {
+                        campaign: 'All campaigns',
+                        delivered: sends.every((send)=>send.report.delivered === null) ? null : sends.reduce((sum, send)=>{
+                            var _send_report_delivered;
+                            return sum + ((_send_report_delivered = send.report.delivered) != null ? _send_report_delivered : 0);
+                        }, 0),
+                        openRate: pooled(sends.map((send)=>send.report.rates.open)),
+                        clickRate: pooled(sends.map((send)=>send.report.rates.click))
+                    },
+                    ...sends.slice(0, PLUGIN_FIGURE_MAX_ROWS - 1).map((send)=>({
+                            campaign: send.subject,
+                            delivered: send.report.delivered,
+                            openRate: percent(send.report.rates.open),
+                            clickRate: percent(send.report.rates.click)
+                        }))
+                ];
+                return {
+                    ok: true,
+                    table: {
+                        title: 'Campaigns',
+                        source: {
+                            label: 'Campaigns',
+                            path: 'marketing/campaigns'
+                        },
+                        period: {
+                            from: current.from,
+                            to: current.to,
+                            days: request.days
+                        },
+                        columns: [
+                            {
+                                key: 'campaign',
+                                label: 'Campaign',
+                                kind: 'text'
+                            },
+                            {
+                                key: 'delivered',
+                                label: 'Delivered',
+                                kind: 'count'
+                            },
+                            {
+                                key: 'openRate',
+                                label: 'Opened',
+                                kind: 'percent'
+                            },
+                            {
+                                key: 'clickRate',
+                                label: 'Clicked',
+                                kind: 'percent'
+                            }
+                        ],
+                        rows,
+                        omitted: Math.max(0, sends.length - (PLUGIN_FIGURE_MAX_ROWS - 1)),
+                        notes: [
+                            'Rates are over delivered messages, and a campaign with no delivery recorded has none.',
+                            ...snapshot.docs.length === CAMPAIGN_FIGURES_READ_LIMIT ? [
+                                `Only the ${CAMPAIGN_FIGURES_READ_LIMIT} most recent emails were looked at.`
+                            ] : []
+                        ]
+                    }
+                };
+            }
+        },
+        {
+            id: 'marketing.experiments',
+            label: 'A/B tests',
+            description: 'Each running or finished A/B test on the site: every variant’s visitors shown it, conversions and conversion rate, with the lift over the first variant and how confident that lift is.',
+            scope: 'site',
+            windows: [],
+            feature: 'abTesting',
+            read: async (request)=>{
+                if (!request.hostId) return {
+                    ok: false,
+                    status: 400,
+                    error: 'Open a site to read its A/B tests'
+                };
+                const experimentsRef = firestore().collection('hosts').doc(request.hostId).collection('experiments');
+                const snapshot = await experimentsRef.limit(EXPERIMENT_FIGURES_READ_LIMIT).get();
+                const rows = [];
+                for (const doc of snapshot.docs){
+                    var _doc_data, _experiment_variants, _byVariant_get;
+                    const experiment = (_doc_data = doc.data()) != null ? _doc_data : {};
+                    if (experiment.status !== 'running' && experiment.status !== 'done') continue;
+                    const variants = ((_experiment_variants = experiment.variants) != null ? _experiment_variants : []).slice(0, 4);
+                    if (!variants.length) continue;
+                    const stats = await doc.ref.collection('stats').get();
+                    const byVariant = new Map(stats.docs.map((entry)=>{
+                        var _entry_data;
+                        return [
+                            entry.id,
+                            (_entry_data = entry.data()) != null ? _entry_data : {}
+                        ];
+                    }));
+                    const control = (_byVariant_get = byVariant.get(variants[0].id)) != null ? _byVariant_get : {};
+                    variants.forEach((variant, index)=>{
+                        var _byVariant_get, _experiment_name, _variant_name;
+                        const own = (_byVariant_get = byVariant.get(variant.id)) != null ? _byVariant_get : {};
+                        const summary = summarizeVariantStats(own);
+                        const comparison = index === 0 ? null : compareVariants(control, own);
+                        rows.push({
+                            test: String((_experiment_name = experiment.name) != null ? _experiment_name : '').trim() || doc.id,
+                            variant: String((_variant_name = variant.name) != null ? _variant_name : '').trim() || variant.id,
+                            shown: summary.exposures,
+                            conversions: summary.conversions,
+                            rate: summary.exposures ? Math.round(summary.rate * 1000) / 10 : null,
+                            lift: (comparison == null ? void 0 : comparison.lift) === null || comparison === null ? null : Math.round(comparison.lift * 1000) / 10,
+                            confidence: (comparison == null ? void 0 : comparison.confidence) === null || comparison === null ? null : Math.round(comparison.confidence * 1000) / 10
+                        });
+                    });
+                }
+                return {
+                    ok: true,
+                    table: {
+                        title: 'A/B tests',
+                        source: {
+                            label: 'A/B testing',
+                            path: 'marketing/experiments'
+                        },
+                        period: null,
+                        columns: [
+                            {
+                                key: 'test',
+                                label: 'Test',
+                                kind: 'text'
+                            },
+                            {
+                                key: 'variant',
+                                label: 'Variant',
+                                kind: 'text'
+                            },
+                            {
+                                key: 'shown',
+                                label: 'Shown',
+                                kind: 'count'
+                            },
+                            {
+                                key: 'conversions',
+                                label: 'Conversions',
+                                kind: 'count'
+                            },
+                            {
+                                key: 'rate',
+                                label: 'Conversion rate',
+                                kind: 'percent'
+                            },
+                            {
+                                key: 'lift',
+                                label: 'Lift over the first variant',
+                                kind: 'change'
+                            },
+                            {
+                                key: 'confidence',
+                                label: 'Confidence in the lift',
+                                kind: 'percent'
+                            }
+                        ],
+                        rows: rows.slice(0, PLUGIN_FIGURE_MAX_ROWS),
+                        omitted: Math.max(0, rows.length - PLUGIN_FIGURE_MAX_ROWS),
+                        notes: [
+                            'Figures are totals since each test started; the first variant of a test is its control.'
+                        ]
+                    }
+                };
+            }
+        }
+    ];
+}
+/** Registers the campaign and A/B testing readers from the console surface, where insight jobs run. */ export function registerMarketingFigureReaders(firestore) {
+    for (const reader of marketingFigureReaders(firestore)){
+        registerPluginFigureReader(reader, {
+            pluginId: MARKETING_PLUGIN_ID
+        });
+    }
+}
+
+//# sourceMappingURL=marketing-figures.js.map

package/src/lib/server/marketing-figures.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/server/marketing-figures.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 {\n  PLUGIN_FIGURE_MAX_ROWS,\n  pluginFigureWindows,\n  registerPluginFigureReader,\n  type PluginFigureReader,\n  type PluginFigureRow,\n} from '@aglyn/aglyn/plugin-manager/plugin-figures'\nimport {\n  campaignReport,\n  type CampaignRate,\n  type CampaignStats,\n} from '@aglyn/shared-ui-email-campaigns/model/campaign-report'\nimport {\n  EMAIL_CREATED_AT_FIELD,\n  emailSendTimeMs,\n} from '@aglyn/shared-ui-email-campaigns/model/email-record'\nimport { compareVariants, summarizeVariantStats, type HostExperiment } from '../model/experiments'\n\n/**\n * A site's campaign and A/B testing results as figure tables another plugin\n * reads by id (AGL-2915).\n *\n * The campaign table is what each send's report shows — delivered, and the\n * open and click rates over delivered — through `campaignReport`, the one\n * reader of a send's counters. The experiments table is what the A/B testing\n * section shows, through the same variant comparison. No recipient, address\n * or visitor reaches either: a campaign is named by its subject, a variant by\n * its name.\n */\n\ntype Firestore = FirebaseFirestore.Firestore\n\nconst MARKETING_PLUGIN_ID = 'marketing'\n\n/** Sends a campaign table reads, newest first, before it keeps those sent in the window. */\nexport const CAMPAIGN_FIGURES_READ_LIMIT = 100\n\n/** Experiments an experiments table reads. */\nexport const EXPERIMENT_FIGURES_READ_LIMIT = 20\n\nconst WINDOWS: readonly number[] = [7, 14, 30, 90]\n\nconst percent = (rate: CampaignRate | null): number | null =>\n  rate ? Math.round(rate.value * 1_000) / 10 : null\n\n/** Rates pooled across sends: every numerator over every denominator, never an average of rates. */\nfunction pooled(rates: ReadonlyArray<CampaignRate | null>): number | null {\n  const known = rates.filter((rate): rate is CampaignRate => rate !== null)\n  const denominator = known.reduce((sum, rate) => sum + rate.denominator, 0)\n  if (!denominator) return null\n  return Math.round((known.reduce((sum, rate) => sum + rate.numerator, 0) / denominator) * 1_000) / 10\n}\n\nexport function marketingFigureReaders(firestore: () => Firestore): PluginFigureReader[] {\n  return [\n    {\n      id: 'marketing.campaigns',\n      label: 'Campaigns',\n      description:\n        'Each campaign email sent from the site in the window: how many were delivered and the share of delivered messages opened and clicked, with every campaign together on the first row.',\n      scope: 'site',\n      windows: WINDOWS,\n      read: async (request) => {\n        if (!request.hostId) return { ok: false, status: 400, error: 'Open a site to read its campaigns' }\n        if (!WINDOWS.includes(request.days)) {\n          return { ok: false, status: 400, error: 'That window is not one campaigns are read over' }\n        }\n        const { current } = pluginFigureWindows(request.now, request.days)\n        const snapshot = await firestore()\n          .collection('hosts')\n          .doc(request.hostId)\n          .collection('campaigns')\n          .orderBy(EMAIL_CREATED_AT_FIELD, 'desc')\n          .limit(CAMPAIGN_FIGURES_READ_LIMIT)\n          .get()\n        const sends = snapshot.docs\n          .map((doc) => doc.data() ?? {})\n          .filter((record) => {\n            const sentAt = emailSendTimeMs(record)\n            return Boolean(record['sentAt']) && sentAt >= current.startMs && sentAt < current.endMs\n          })\n          .map((record) => ({\n            subject: String(record['subject'] ?? '').trim() || 'A campaign with no subject',\n            report: campaignReport(record['stats'] as CampaignStats | undefined),\n          }))\n        const rows: PluginFigureRow[] = [\n          {\n            campaign: 'All campaigns',\n            delivered: sends.every((send) => send.report.delivered === null)\n              ? null\n              : sends.reduce((sum, send) => sum + (send.report.delivered ?? 0), 0),\n            openRate: pooled(sends.map((send) => send.report.rates.open)),\n            clickRate: pooled(sends.map((send) => send.report.rates.click)),\n          },\n          ...sends.slice(0, PLUGIN_FIGURE_MAX_ROWS - 1).map((send) => ({\n            campaign: send.subject,\n            delivered: send.report.delivered,\n            openRate: percent(send.report.rates.open),\n            clickRate: percent(send.report.rates.click),\n          })),\n        ]\n        return {\n          ok: true,\n          table: {\n            title: 'Campaigns',\n            source: { label: 'Campaigns', path: 'marketing/campaigns' },\n            period: { from: current.from, to: current.to, days: request.days },\n            columns: [\n              { key: 'campaign', label: 'Campaign', kind: 'text' },\n              { key: 'delivered', label: 'Delivered', kind: 'count' },\n              { key: 'openRate', label: 'Opened', kind: 'percent' },\n              { key: 'clickRate', label: 'Clicked', kind: 'percent' },\n            ],\n            rows,\n            omitted: Math.max(0, sends.length - (PLUGIN_FIGURE_MAX_ROWS - 1)),\n            notes: [\n              'Rates are over delivered messages, and a campaign with no delivery recorded has none.',\n              ...(snapshot.docs.length === CAMPAIGN_FIGURES_READ_LIMIT\n                ? [`Only the ${CAMPAIGN_FIGURES_READ_LIMIT} most recent emails were looked at.`]\n                : []),\n            ],\n          },\n        }\n      },\n    },\n    {\n      id: 'marketing.experiments',\n      label: 'A/B tests',\n      description:\n        'Each running or finished A/B test on the site: every variant’s visitors shown it, conversions and conversion rate, with the lift over the first variant and how confident that lift is.',\n      scope: 'site',\n      windows: [],\n      feature: 'abTesting',\n      read: async (request) => {\n        if (!request.hostId) return { ok: false, status: 400, error: 'Open a site to read its A/B tests' }\n        const experimentsRef = firestore().collection('hosts').doc(request.hostId).collection('experiments')\n        const snapshot = await experimentsRef.limit(EXPERIMENT_FIGURES_READ_LIMIT).get()\n        const rows: PluginFigureRow[] = []\n        for (const doc of snapshot.docs) {\n          const experiment = (doc.data() ?? {}) as Partial<HostExperiment>\n          if (experiment.status !== 'running' && experiment.status !== 'done') continue\n          const variants = (experiment.variants ?? []).slice(0, 4)\n          if (!variants.length) continue\n          const stats = await doc.ref.collection('stats').get()\n          const byVariant = new Map(stats.docs.map((entry) => [entry.id, entry.data() ?? {}]))\n          const control = byVariant.get(variants[0].id) ?? {}\n          variants.forEach((variant, index) => {\n            const own = byVariant.get(variant.id) ?? {}\n            const summary = summarizeVariantStats(own)\n            const comparison = index === 0 ? null : compareVariants(control, own)\n            rows.push({\n              test: String(experiment.name ?? '').trim() || doc.id,\n              variant: String(variant.name ?? '').trim() || variant.id,\n              shown: summary.exposures,\n              conversions: summary.conversions,\n              rate: summary.exposures ? Math.round(summary.rate * 1_000) / 10 : null,\n              lift: comparison?.lift === null || comparison === null ? null : Math.round(comparison.lift * 1_000) / 10,\n              confidence:\n                comparison?.confidence === null || comparison === null\n                  ? null\n                  : Math.round(comparison.confidence * 1_000) / 10,\n            })\n          })\n        }\n        return {\n          ok: true,\n          table: {\n            title: 'A/B tests',\n            source: { label: 'A/B testing', path: 'marketing/experiments' },\n            period: null,\n            columns: [\n              { key: 'test', label: 'Test', kind: 'text' },\n              { key: 'variant', label: 'Variant', kind: 'text' },\n              { key: 'shown', label: 'Shown', kind: 'count' },\n              { key: 'conversions', label: 'Conversions', kind: 'count' },\n              { key: 'rate', label: 'Conversion rate', kind: 'percent' },\n              { key: 'lift', label: 'Lift over the first variant', kind: 'change' },\n              { key: 'confidence', label: 'Confidence in the lift', kind: 'percent' },\n            ],\n            rows: rows.slice(0, PLUGIN_FIGURE_MAX_ROWS),\n            omitted: Math.max(0, rows.length - PLUGIN_FIGURE_MAX_ROWS),\n            notes: ['Figures are totals since each test started; the first variant of a test is its control.'],\n          },\n        }\n      },\n    },\n  ]\n}\n\n/** Registers the campaign and A/B testing readers from the console surface, where insight jobs run. */\nexport function registerMarketingFigureReaders(firestore: () => Firestore): void {\n  for (const reader of marketingFigureReaders(firestore)) {\n    registerPluginFigureReader(reader, { pluginId: MARKETING_PLUGIN_ID })\n  }\n}\n"],"names":["PLUGIN_FIGURE_MAX_ROWS","pluginFigureWindows","registerPluginFigureReader","campaignReport","EMAIL_CREATED_AT_FIELD","emailSendTimeMs","compareVariants","summarizeVariantStats","MARKETING_PLUGIN_ID","CAMPAIGN_FIGURES_READ_LIMIT","EXPERIMENT_FIGURES_READ_LIMIT","WINDOWS","percent","rate","Math","round","value","pooled","rates","known","filter","denominator","reduce","sum","numerator","marketingFigureReaders","firestore","id","label","description","scope","windows","read","request","hostId","ok","status","error","includes","days","current","now","snapshot","collection","doc","orderBy","limit","get","sends","docs","map","data","record","sentAt","Boolean","startMs","endMs","subject","String","trim","report","rows","campaign","delivered","every","send","openRate","open","clickRate","click","slice","table","title","source","path","period","from","to","columns","key","kind","omitted","max","length","notes","feature","experimentsRef","experiment","byVariant","variants","stats","ref","Map","entry","control","forEach","variant","index","own","summary","comparison","push","test","name","shown","exposures","conversions","lift","confidence","registerMarketingFigureReaders","reader","pluginId"],"mappings":"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"}

package/src/lib/server/site-page-enricher.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @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 type { SitePageEnricher } from '@aglyn/aglyn/server';
+/**
+ * Marketing contributions to a rendered site page (AGL-418), relocated
+ * verbatim from the tenant loader: overlays (announcement bar + popup with
+ * server-resolved binding tokens, AGL-195/196/251), site-event automations
+ * (AGL-256/257), and screen/section experiments (AGL-253). Every block is
+ * entitlement-gated on the owning org's plan exactly as before; the shapes
+ * written here are the wire contract the tenant page runtime consumes.
+ */
+export declare const marketingSitePageEnricher: SitePageEnricher;