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

package/src/lib/server/email-revenue-attribution.js

@@ -0,0 +1,322 @@
+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 { FieldValue } from "firebase-admin/firestore";
+import { EMAIL_ATTRIBUTION_MODEL, EMAIL_ATTRIBUTION_WINDOW_DAYS, EMAIL_ATTRIBUTION_WINDOW_MS, emailTouchIsInWindow } from "@aglyn/shared-util-email";
+import { isDocumentId } from "@aglyn/tenant-data-admin/server/document-id";
+import firebaseAdmin from "@aglyn/tenant-data-admin/server/firebase-admin";
+import { resolveCampaignSendRef } from "./campaign-conversion-attribution.js";
+import { readEmailCampaignTouch } from "./email-campaign-touch.js";
+const defaultFirestore = ()=>firebaseAdmin.app().firestore();
+/**
+ * THE COMMERCE↔EMAIL JOIN — an order, credited to the campaign that led to it.
+ *
+ * ## Why this is a join
+ *
+ * Every compared ESP attributes revenue through an integration into a store
+ * it does not own: a catalog sync, an on-site tracking snippet, an identity
+ * graph, and a window wide enough to absorb what the reconciliation misses.
+ * Commerce here is first-party and runs on the merchant's own Stripe Connect
+ * account, so the click and the order are two rows in one database keyed the
+ * same way. The window is not a fudge factor here — it is the model, and
+ * nothing else about the number is estimated.
+ *
+ * ## Three writes, and what each one is for
+ *
+ *  - **The touch**, `emailDeliveries/{personKey}.campaignTouches[hostId]`,
+ *    written by the delivery webhook on a click (`email-campaign-touch.ts`).
+ *    It lives on the person's delivery document, where the erasure that
+ *    removes the person's mail asks this plugin to remove it too.
+ *  - **The attribution record**, `hosts/{hostId}/emailAttributions/{orderId}`,
+ *    written here when an order is credited. It is the audit trail — which
+ *    campaign, which click, which model, which window — and it is what the
+ *    refund path reads to find out which campaign to take the money back off.
+ *  - **The rollup**, `campaigns/{campaignId}/reports/revenue`, incremented
+ *    here. One document per campaign, so the report reads it whole.
+ *
+ * ## Why the record is a document and not a field on the order
+ *
+ * Three reasons, and the first is decisive. `create()` fails when the
+ * document already exists, which is exact idempotency for free: webhook
+ * delivery is at-least-once, and a redelivered purchase must not be able to
+ * credit a campaign twice. Second, not every purchase door writes an order —
+ * a booking is a sale with no order document — and a field would have had to
+ * either skip those or conjure the document, and conjuring is the
+ * phantom-document shape this codebase spent a sweep removing. Third, the
+ * order document is read by the console list, the fulfilment path, the
+ * supplier outbox and the CSV export, and none of them wants a field about
+ * email.
+ *
+ * ## Never throws
+ *
+ * Same contract as the purchase door that asks for it (the person capture's
+ * `upsertHostContact`, through `plugin-conversion-credit.ts`), and for the
+ * same reason: the money has already moved and the order already records it, so
+ * nothing here may fail a sale. A lost attribution understates a campaign; a
+ * thrown one loses a checkout.
+ */ /** The per-host collection of attribution records. */ export const EMAIL_ATTRIBUTIONS_COLLECTION = 'emailAttributions';
+/** The single rollup document under a campaign. */ export const CAMPAIGN_REVENUE_REPORT_DOC = 'revenue';
+/**
+ * The currency an amount is recorded under when the caller does not say.
+ *
+ * Every checkout door in this repo — cart, buy-now, POS, draft orders,
+ * reservations, subscriptions — writes `currency: 'usd'` onto the Stripe line
+ * items, and no order document carries a currency field to read back. So this
+ * is a statement about what the code charges rather than a guess about the
+ * money. The parameter exists so a door that ever charges in something else
+ * says so and lands in its own bucket, because the one thing the report may
+ * never do is add two currencies together.
+ */ export const DEFAULT_ATTRIBUTION_CURRENCY = 'usd';
+/** Normalizes a currency code to the key its bucket is stored under. */ function currencyKey(raw) {
+    const code = String(raw != null ? raw : '').trim().toLowerCase();
+    // Letters only: the code becomes a MAP KEY, and a key carrying a dot would
+    // be unreachable by any dotted field path a later reader wants to use.
+    return /^[a-z]{3}$/.test(code) ? code : DEFAULT_ATTRIBUTION_CURRENCY;
+}
+/** A positive integer number of minor units, or 0. */ function minorUnits(raw) {
+    const value = Math.round(Number(raw));
+    return Number.isFinite(value) && value > 0 ? value : 0;
+}
+/**
+ * Credits one order to the campaign whose link the buyer last clicked.
+ *
+ * ## What happens when there is nobody to credit
+ *
+ * Each case answers `null` and writes NOTHING, which is the whole design:
+ *
+ *  - **No email on the order.** A guest checkout that never identified its
+ *    buyer cannot be joined to anybody's clicks. There is no fallback and
+ *    there deliberately is not one — the alternatives are an IP or a device
+ *    guess, which is the probabilistic attribution owning the checkout exists
+ *    to avoid.
+ *  - **A guest with an email but no contact record.** This is ATTRIBUTED
+ *    normally. The join keys on the address hash, exactly as the touch and
+ *    the suppression list do, so it never asks whether a contact document
+ *    exists — which matters, because contact creation is audience-band gated
+ *    and a Free org's dropped contact would otherwise silently drop the
+ *    revenue with it.
+ *  - **No touch, or a touch on another site.** Nobody clicked, so nobody is
+ *    credited. The touch map is keyed by host and the send path refuses
+ *    cross-site reach; the revenue join agrees with it.
+ *  - **A touch outside the window**, in either direction. See
+ *    {@link emailTouchIsInWindow} — a click AFTER the order is the receipt,
+ *    not the cause.
+ *
+ * None of these is counted anywhere. A miss costs no write, which is what
+ * keeps the ordinary order — placed by somebody who is not on the mailing
+ * list at all — at exactly one document read. What it means for the report is
+ * stated on the report: the figure counts orders it could join, and is a
+ * floor.
+ *
+ * @returns the record written, or `null` when nothing was credited.
+ */ export async function attributeOrderToEmail(options, firestore) {
+    try {
+        var _options_hostId, _options_orderId, _options_orderedAtMs, _options_email;
+        const hostId = String((_options_hostId = options.hostId) != null ? _options_hostId : '');
+        const orderId = String((_options_orderId = options.orderId) != null ? _options_orderId : '');
+        const amountCents = minorUnits(options.amountCents);
+        if (!isDocumentId(hostId) || !isDocumentId(orderId)) return null;
+        if (!amountCents) return null;
+        const orderedAtMs = Number((_options_orderedAtMs = options.orderedAtMs) != null ? _options_orderedAtMs : Date.now());
+        const db = firestore != null ? firestore : defaultFirestore();
+        /*
+     * `String()` on an `unknown`, then let `emailSuppressionKey` decide.
+     *
+     * The buyer's address arrives as the ORDER recorded it, which is not
+     * consistently a string — the same rawness `recordContactRefund` takes
+     * `email: unknown` for. The key derivation is the one place that knows
+     * how an address becomes a document id, so nothing here tries to
+     * pre-clean it; a value that is not an address answers `null` there and
+     * the order is credited to nobody.
+     */ const rawEmail = typeof options.email === 'string' ? options.email : String((_options_email = options.email) != null ? _options_email : '');
+        const touch = await readEmailCampaignTouch(rawEmail, hostId, db);
+        if (!touch) return null;
+        if (!isDocumentId(touch.campaignId)) return null;
+        if (!emailTouchIsInWindow(touch.clickedAtMs, orderedAtMs)) return null;
+        const record = {
+            campaignId: touch.campaignId,
+            clickedAtMs: touch.clickedAtMs,
+            orderedAtMs,
+            amountCents,
+            currency: currencyKey(options.currency),
+            model: EMAIL_ATTRIBUTION_MODEL,
+            windowDays: EMAIL_ATTRIBUTION_WINDOW_DAYS
+        };
+        const hostRef = db.collection('hosts').doc(hostId);
+        /*
+     * `create()`, never `set()`. It fails with ALREADY_EXISTS when this order
+     * has been credited before, and that failure is the idempotency: a
+     * webhook redelivery, a retried checkout completion and a replayed event
+     * all land here a second time, and all three must leave the rollup where
+     * they found it. The increment below is reached only when the create
+     * succeeded, so the two can never disagree about whether this order was
+     * counted.
+     */ try {
+            await hostRef.collection(EMAIL_ATTRIBUTIONS_COLLECTION).doc(orderId).create(_extends({}, record, {
+                createdAt: FieldValue.serverTimestamp()
+            }));
+        } catch (unused) {
+            return null;
+        }
+        /*
+     * A merge-set that CREATES, unlike the campaign counters the delivery
+     * webhook writes through `updateExisting`.
+     *
+     * The distinction is which document is being conjured. Those counters
+     * refuse to create because a merge-set against a DELETED CAMPAIGN
+     * resurrects the campaign itself, as a husk holding a stats map and no
+     * subject. This writes a subcollection document UNDER a campaign, so a
+     * campaign that no longer exists gains an orphaned report rather than
+     * coming back to life in the merchant's history — and the campaign was
+     * proven to exist a moment ago, when its click wrote the touch.
+     *
+     * Every amount is an increment, so two orders settling at once both land.
+     *
+     * The send is found where it is — the org's `campaigns`, or the site's
+     * for a send the migration has not reached — and a send in neither
+     * place was discarded: the record above stands, and no report is
+     * conjured under nothing.
+     */ const currency = record.currency;
+        const sendRef = await resolveCampaignSendRef({
+            hostId,
+            sendId: touch.campaignId,
+            firestore: db
+        });
+        if (!sendRef) return record;
+        await sendRef.collection('reports').doc(CAMPAIGN_REVENUE_REPORT_DOC).set({
+            model: EMAIL_ATTRIBUTION_MODEL,
+            windowDays: EMAIL_ATTRIBUTION_WINDOW_DAYS,
+            byCurrency: {
+                [currency]: {
+                    grossCents: FieldValue.increment(amountCents),
+                    orders: FieldValue.increment(1)
+                }
+            },
+            updatedAt: FieldValue.serverTimestamp()
+        }, {
+            merge: true
+        });
+        return record;
+    } catch (error) {
+        console.error('attributeOrderToEmail failed', error);
+        return null;
+    }
+}
+/**
+ * Takes back revenue a campaign was credited with, when it is refunded.
+ *
+ * ## Recorded beside the gross, never subtracted from it
+ *
+ * `grossCents` is left exactly as it is and the reversal lands in
+ * `refundedCents` next to it. This is the shape `contact-refund.ts` chose for
+ * `ltvCents`/`refundedCents` and the orders CSV chose for
+ * `amountUsd`/`refundedUsd`, and it is chosen a third time here so all three
+ * answer "what did this earn, net" identically. Decrementing would make a
+ * stored number mean one thing for rollups written before a refund and
+ * another after, with nothing on the document to tell them apart — and would
+ * put the question "can it go negative" onto storage, where the answer cannot
+ * be clamped without destroying evidence. Both stored figures are monotonic
+ * counters of money that really moved in one direction; the derived net is
+ * clamped at the point of display and nowhere else.
+ *
+ * ## The currency comes from the RECORD, not from the caller
+ *
+ * A refund reverses a specific sale, and the bucket it comes out of has to be
+ * the bucket it went into. Reading the currency back off the attribution
+ * record is what guarantees that, and it is the second thing the record is
+ * for.
+ *
+ * ## Chargebacks come through here too
+ *
+ * Money reversed is money reversed, whichever door it left by, so a lost
+ * dispute reverses the credit the same way a refund does. `kind` exists for
+ * the caller's clarity and changes nothing about the arithmetic — the same
+ * choice `recordContactRefund` made one field along.
+ *
+ * @returns whether a reversal was recorded.
+ */ export async function reverseEmailAttributedRevenue(options, firestore) {
+    try {
+        var _options_hostId, _options_orderId, _snapshot_data, _record_campaignId;
+        const hostId = String((_options_hostId = options.hostId) != null ? _options_hostId : '');
+        const orderId = String((_options_orderId = options.orderId) != null ? _options_orderId : '');
+        const amountCents = minorUnits(options.amountCents);
+        if (!isDocumentId(hostId) || !isDocumentId(orderId)) return false;
+        if (!amountCents) return false;
+        const db = firestore != null ? firestore : defaultFirestore();
+        const hostRef = db.collection('hosts').doc(hostId);
+        const snapshot = await hostRef.collection(EMAIL_ATTRIBUTIONS_COLLECTION).doc(orderId).get();
+        // The ordinary case, and not an error: most orders were never credited to
+        // a campaign, so most refunds have nothing to reverse.
+        if (!snapshot.exists) return false;
+        const record = (_snapshot_data = snapshot.data()) != null ? _snapshot_data : {};
+        const campaignId = String((_record_campaignId = record.campaignId) != null ? _record_campaignId : '');
+        if (!isDocumentId(campaignId)) return false;
+        const currency = currencyKey(record.currency);
+        /*
+     * NOT capped against what was credited, and that is deliberate. The
+     * caller already caps each attempt against what is left on the ORDER, so
+     * several partials sum to at most the order total; capping again here
+     * against the attributed amount would silently discard the reversal of an
+     * order refunded for more than the amount the campaign was credited with
+     * — which happens when the credit was the charge and the refund includes
+     * something the credit did not. The stored pair keeps both true figures
+     * and the reader clamps the net it prints.
+     *
+     * The send is found where it is, as the credit found it; a send that
+     * has since been discarded has no rollup left to reverse, and the
+     * record below still takes the refund.
+     */ const sendRef = await resolveCampaignSendRef({
+            hostId,
+            sendId: campaignId,
+            firestore: db
+        });
+        await (sendRef == null ? void 0 : sendRef.collection('reports').doc(CAMPAIGN_REVENUE_REPORT_DOC).set({
+            byCurrency: {
+                [currency]: _extends({
+                    refundedCents: FieldValue.increment(amountCents)
+                }, options.closedTheOrder ? {
+                    refundedOrders: FieldValue.increment(1)
+                } : {})
+            },
+            updatedAt: FieldValue.serverTimestamp()
+        }, {
+            merge: true
+        }));
+        /*
+     * Stamped on the record as well as counted in the rollup. The rollup is a
+     * sum and cannot say WHICH orders came back; this is the per-order half
+     * of the same fact, and it is what a merchant asking "why did this
+     * campaign's revenue drop" is eventually going to need. Increments, so
+     * two partials on one order both land.
+     */ await snapshot.ref.set(_extends({
+            refundedCents: FieldValue.increment(amountCents),
+            lastRefundAtMs: Date.now()
+        }, options.kind === 'chargeback' ? {
+            chargedBack: true
+        } : {}, options.closedTheOrder ? {
+            fullyRefunded: true
+        } : {}), {
+            merge: true
+        }).catch(()=>undefined);
+        return true;
+    } catch (error) {
+        console.error('reverseEmailAttributedRevenue failed', error);
+        return false;
+    }
+}
+/** The window, re-exported so a caller needs one import for the whole join. */ export { EMAIL_ATTRIBUTION_WINDOW_MS };
+
+//# sourceMappingURL=email-revenue-attribution.js.map

package/src/lib/server/email-revenue-attribution.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/server/email-revenue-attribution.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 { FieldValue } from 'firebase-admin/firestore'\nimport {\n  EMAIL_ATTRIBUTION_MODEL,\n  EMAIL_ATTRIBUTION_WINDOW_DAYS,\n  EMAIL_ATTRIBUTION_WINDOW_MS,\n  emailTouchIsInWindow,\n} from '@aglyn/shared-util-email'\nimport { isDocumentId } from '@aglyn/tenant-data-admin/server/document-id'\nimport firebaseAdmin from '@aglyn/tenant-data-admin/server/firebase-admin'\nimport { resolveCampaignSendRef } from './campaign-conversion-attribution'\nimport { readEmailCampaignTouch } from './email-campaign-touch'\n\nconst defaultFirestore = () => firebaseAdmin.app().firestore()\n\n/**\n * THE COMMERCE↔EMAIL JOIN — an order, credited to the campaign that led to it.\n *\n * ## Why this is a join\n *\n * Every compared ESP attributes revenue through an integration into a store\n * it does not own: a catalog sync, an on-site tracking snippet, an identity\n * graph, and a window wide enough to absorb what the reconciliation misses.\n * Commerce here is first-party and runs on the merchant's own Stripe Connect\n * account, so the click and the order are two rows in one database keyed the\n * same way. The window is not a fudge factor here — it is the model, and\n * nothing else about the number is estimated.\n *\n * ## Three writes, and what each one is for\n *\n *  - **The touch**, `emailDeliveries/{personKey}.campaignTouches[hostId]`,\n *    written by the delivery webhook on a click (`email-campaign-touch.ts`).\n *    It lives on the person's delivery document, where the erasure that\n *    removes the person's mail asks this plugin to remove it too.\n *  - **The attribution record**, `hosts/{hostId}/emailAttributions/{orderId}`,\n *    written here when an order is credited. It is the audit trail — which\n *    campaign, which click, which model, which window — and it is what the\n *    refund path reads to find out which campaign to take the money back off.\n *  - **The rollup**, `campaigns/{campaignId}/reports/revenue`, incremented\n *    here. One document per campaign, so the report reads it whole.\n *\n * ## Why the record is a document and not a field on the order\n *\n * Three reasons, and the first is decisive. `create()` fails when the\n * document already exists, which is exact idempotency for free: webhook\n * delivery is at-least-once, and a redelivered purchase must not be able to\n * credit a campaign twice. Second, not every purchase door writes an order —\n * a booking is a sale with no order document — and a field would have had to\n * either skip those or conjure the document, and conjuring is the\n * phantom-document shape this codebase spent a sweep removing. Third, the\n * order document is read by the console list, the fulfilment path, the\n * supplier outbox and the CSV export, and none of them wants a field about\n * email.\n *\n * ## Never throws\n *\n * Same contract as the purchase door that asks for it (the person capture's\n * `upsertHostContact`, through `plugin-conversion-credit.ts`), and for the\n * same reason: the money has already moved and the order already records it, so\n * nothing here may fail a sale. A lost attribution understates a campaign; a\n * thrown one loses a checkout.\n */\n\n/** The per-host collection of attribution records. */\nexport const EMAIL_ATTRIBUTIONS_COLLECTION = 'emailAttributions'\n\n/** The single rollup document under a campaign. */\nexport const CAMPAIGN_REVENUE_REPORT_DOC = 'revenue'\n\n/**\n * The currency an amount is recorded under when the caller does not say.\n *\n * Every checkout door in this repo — cart, buy-now, POS, draft orders,\n * reservations, subscriptions — writes `currency: 'usd'` onto the Stripe line\n * items, and no order document carries a currency field to read back. So this\n * is a statement about what the code charges rather than a guess about the\n * money. The parameter exists so a door that ever charges in something else\n * says so and lands in its own bucket, because the one thing the report may\n * never do is add two currencies together.\n */\nexport const DEFAULT_ATTRIBUTION_CURRENCY = 'usd'\n\n/** What one attribution record holds. */\nexport interface EmailAttributionRecord {\n  campaignId: string\n  /** When the credited click happened. */\n  clickedAtMs: number\n  /** When the order was placed. */\n  orderedAtMs: number\n  /** Minor units credited, gross — the amount the buyer was charged. */\n  amountCents: number\n  /** Lowercase currency code the amount is in. */\n  currency: string\n  /** The model this credit was decided under. */\n  model: string\n  /** The window, in days, it was decided inside. */\n  windowDays: number\n}\n\n/** Normalizes a currency code to the key its bucket is stored under. */\nfunction currencyKey(raw: unknown): string {\n  const code = String(raw ?? '')\n    .trim()\n    .toLowerCase()\n  // Letters only: the code becomes a MAP KEY, and a key carrying a dot would\n  // be unreachable by any dotted field path a later reader wants to use.\n  return /^[a-z]{3}$/.test(code) ? code : DEFAULT_ATTRIBUTION_CURRENCY\n}\n\n/** A positive integer number of minor units, or 0. */\nfunction minorUnits(raw: unknown): number {\n  const value = Math.round(Number(raw))\n  return Number.isFinite(value) && value > 0 ? value : 0\n}\n\n/**\n * Credits one order to the campaign whose link the buyer last clicked.\n *\n * ## What happens when there is nobody to credit\n *\n * Each case answers `null` and writes NOTHING, which is the whole design:\n *\n *  - **No email on the order.** A guest checkout that never identified its\n *    buyer cannot be joined to anybody's clicks. There is no fallback and\n *    there deliberately is not one — the alternatives are an IP or a device\n *    guess, which is the probabilistic attribution owning the checkout exists\n *    to avoid.\n *  - **A guest with an email but no contact record.** This is ATTRIBUTED\n *    normally. The join keys on the address hash, exactly as the touch and\n *    the suppression list do, so it never asks whether a contact document\n *    exists — which matters, because contact creation is audience-band gated\n *    and a Free org's dropped contact would otherwise silently drop the\n *    revenue with it.\n *  - **No touch, or a touch on another site.** Nobody clicked, so nobody is\n *    credited. The touch map is keyed by host and the send path refuses\n *    cross-site reach; the revenue join agrees with it.\n *  - **A touch outside the window**, in either direction. See\n *    {@link emailTouchIsInWindow} — a click AFTER the order is the receipt,\n *    not the cause.\n *\n * None of these is counted anywhere. A miss costs no write, which is what\n * keeps the ordinary order — placed by somebody who is not on the mailing\n * list at all — at exactly one document read. What it means for the report is\n * stated on the report: the figure counts orders it could join, and is a\n * floor.\n *\n * @returns the record written, or `null` when nothing was credited.\n */\nexport async function attributeOrderToEmail(\n  options: {\n    hostId: string\n    /** The order, booking or invoice the money came in on. */\n    orderId: string\n    /** The buyer as the sale recorded them, raw — normalized downstream. */\n    email: unknown\n    /** Gross minor units the buyer was charged. */\n    amountCents: number\n    /** Lowercase currency code, when the door knows one. */\n    currency?: string\n    /** When the order was placed. Defaults to now. */\n    orderedAtMs?: number\n  },\n  firestore?: any,\n): Promise<EmailAttributionRecord | null> {\n  try {\n    const hostId = String(options.hostId ?? '')\n    const orderId = String(options.orderId ?? '')\n    const amountCents = minorUnits(options.amountCents)\n    if (!isDocumentId(hostId) || !isDocumentId(orderId)) return null\n    if (!amountCents) return null\n\n    const orderedAtMs = Number(options.orderedAtMs ?? Date.now())\n    const db = firestore ?? defaultFirestore()\n\n    /*\n     * `String()` on an `unknown`, then let `emailSuppressionKey` decide.\n     *\n     * The buyer's address arrives as the ORDER recorded it, which is not\n     * consistently a string — the same rawness `recordContactRefund` takes\n     * `email: unknown` for. The key derivation is the one place that knows\n     * how an address becomes a document id, so nothing here tries to\n     * pre-clean it; a value that is not an address answers `null` there and\n     * the order is credited to nobody.\n     */\n    const rawEmail =\n      typeof options.email === 'string' ? options.email : String(options.email ?? '')\n    const touch = await readEmailCampaignTouch(rawEmail, hostId, db)\n    if (!touch) return null\n    if (!isDocumentId(touch.campaignId)) return null\n    if (!emailTouchIsInWindow(touch.clickedAtMs, orderedAtMs)) return null\n\n    const record: EmailAttributionRecord = {\n      campaignId: touch.campaignId,\n      clickedAtMs: touch.clickedAtMs,\n      orderedAtMs,\n      amountCents,\n      currency: currencyKey(options.currency),\n      model: EMAIL_ATTRIBUTION_MODEL,\n      windowDays: EMAIL_ATTRIBUTION_WINDOW_DAYS,\n    }\n\n    const hostRef = db.collection('hosts').doc(hostId)\n    /*\n     * `create()`, never `set()`. It fails with ALREADY_EXISTS when this order\n     * has been credited before, and that failure is the idempotency: a\n     * webhook redelivery, a retried checkout completion and a replayed event\n     * all land here a second time, and all three must leave the rollup where\n     * they found it. The increment below is reached only when the create\n     * succeeded, so the two can never disagree about whether this order was\n     * counted.\n     */\n    try {\n      await hostRef\n        .collection(EMAIL_ATTRIBUTIONS_COLLECTION)\n        .doc(orderId)\n        .create({ ...record, createdAt: FieldValue.serverTimestamp() })\n    } catch {\n      return null\n    }\n\n    /*\n     * A merge-set that CREATES, unlike the campaign counters the delivery\n     * webhook writes through `updateExisting`.\n     *\n     * The distinction is which document is being conjured. Those counters\n     * refuse to create because a merge-set against a DELETED CAMPAIGN\n     * resurrects the campaign itself, as a husk holding a stats map and no\n     * subject. This writes a subcollection document UNDER a campaign, so a\n     * campaign that no longer exists gains an orphaned report rather than\n     * coming back to life in the merchant's history — and the campaign was\n     * proven to exist a moment ago, when its click wrote the touch.\n     *\n     * Every amount is an increment, so two orders settling at once both land.\n     *\n     * The send is found where it is — the org's `campaigns`, or the site's\n     * for a send the migration has not reached — and a send in neither\n     * place was discarded: the record above stands, and no report is\n     * conjured under nothing.\n     */\n    const currency = record.currency\n    const sendRef = await resolveCampaignSendRef({ hostId, sendId: touch.campaignId, firestore: db })\n    if (!sendRef) return record\n    await sendRef\n      .collection('reports')\n      .doc(CAMPAIGN_REVENUE_REPORT_DOC)\n      .set(\n        {\n          model: EMAIL_ATTRIBUTION_MODEL,\n          windowDays: EMAIL_ATTRIBUTION_WINDOW_DAYS,\n          byCurrency: {\n            [currency]: {\n              grossCents: FieldValue.increment(amountCents),\n              orders: FieldValue.increment(1),\n            },\n          },\n          updatedAt: FieldValue.serverTimestamp(),\n        },\n        { merge: true },\n      )\n\n    return record\n  } catch (error) {\n    console.error('attributeOrderToEmail failed', error)\n    return null\n  }\n}\n\n/**\n * Takes back revenue a campaign was credited with, when it is refunded.\n *\n * ## Recorded beside the gross, never subtracted from it\n *\n * `grossCents` is left exactly as it is and the reversal lands in\n * `refundedCents` next to it. This is the shape `contact-refund.ts` chose for\n * `ltvCents`/`refundedCents` and the orders CSV chose for\n * `amountUsd`/`refundedUsd`, and it is chosen a third time here so all three\n * answer \"what did this earn, net\" identically. Decrementing would make a\n * stored number mean one thing for rollups written before a refund and\n * another after, with nothing on the document to tell them apart — and would\n * put the question \"can it go negative\" onto storage, where the answer cannot\n * be clamped without destroying evidence. Both stored figures are monotonic\n * counters of money that really moved in one direction; the derived net is\n * clamped at the point of display and nowhere else.\n *\n * ## The currency comes from the RECORD, not from the caller\n *\n * A refund reverses a specific sale, and the bucket it comes out of has to be\n * the bucket it went into. Reading the currency back off the attribution\n * record is what guarantees that, and it is the second thing the record is\n * for.\n *\n * ## Chargebacks come through here too\n *\n * Money reversed is money reversed, whichever door it left by, so a lost\n * dispute reverses the credit the same way a refund does. `kind` exists for\n * the caller's clarity and changes nothing about the arithmetic — the same\n * choice `recordContactRefund` made one field along.\n *\n * @returns whether a reversal was recorded.\n */\nexport async function reverseEmailAttributedRevenue(\n  options: {\n    hostId: string\n    orderId: string\n    /** Minor units reversed by THIS attempt, never the order total. */\n    amountCents: number\n    /** True only for the write that moved the order into `refunded`. */\n    closedTheOrder: boolean\n    kind?: 'refund' | 'chargeback'\n  },\n  firestore?: any,\n): Promise<boolean> {\n  try {\n    const hostId = String(options.hostId ?? '')\n    const orderId = String(options.orderId ?? '')\n    const amountCents = minorUnits(options.amountCents)\n    if (!isDocumentId(hostId) || !isDocumentId(orderId)) return false\n    if (!amountCents) return false\n\n    const db = firestore ?? defaultFirestore()\n    const hostRef = db.collection('hosts').doc(hostId)\n    const snapshot = await hostRef\n      .collection(EMAIL_ATTRIBUTIONS_COLLECTION)\n      .doc(orderId)\n      .get()\n    // The ordinary case, and not an error: most orders were never credited to\n    // a campaign, so most refunds have nothing to reverse.\n    if (!snapshot.exists) return false\n\n    const record = snapshot.data() ?? {}\n    const campaignId = String(record.campaignId ?? '')\n    if (!isDocumentId(campaignId)) return false\n    const currency = currencyKey(record.currency)\n\n    /*\n     * NOT capped against what was credited, and that is deliberate. The\n     * caller already caps each attempt against what is left on the ORDER, so\n     * several partials sum to at most the order total; capping again here\n     * against the attributed amount would silently discard the reversal of an\n     * order refunded for more than the amount the campaign was credited with\n     * — which happens when the credit was the charge and the refund includes\n     * something the credit did not. The stored pair keeps both true figures\n     * and the reader clamps the net it prints.\n     *\n     * The send is found where it is, as the credit found it; a send that\n     * has since been discarded has no rollup left to reverse, and the\n     * record below still takes the refund.\n     */\n    const sendRef = await resolveCampaignSendRef({ hostId, sendId: campaignId, firestore: db })\n    await sendRef\n      ?.collection('reports')\n      .doc(CAMPAIGN_REVENUE_REPORT_DOC)\n      .set(\n        {\n          byCurrency: {\n            [currency]: {\n              refundedCents: FieldValue.increment(amountCents),\n              ...(options.closedTheOrder\n                ? { refundedOrders: FieldValue.increment(1) }\n                : {}),\n            },\n          },\n          updatedAt: FieldValue.serverTimestamp(),\n        },\n        { merge: true },\n      )\n\n    /*\n     * Stamped on the record as well as counted in the rollup. The rollup is a\n     * sum and cannot say WHICH orders came back; this is the per-order half\n     * of the same fact, and it is what a merchant asking \"why did this\n     * campaign's revenue drop\" is eventually going to need. Increments, so\n     * two partials on one order both land.\n     */\n    await snapshot.ref\n      .set(\n        {\n          refundedCents: FieldValue.increment(amountCents),\n          lastRefundAtMs: Date.now(),\n          ...(options.kind === 'chargeback' ? { chargedBack: true } : {}),\n          ...(options.closedTheOrder ? { fullyRefunded: true } : {}),\n        },\n        { merge: true },\n      )\n      .catch(() => undefined)\n\n    return true\n  } catch (error) {\n    console.error('reverseEmailAttributedRevenue failed', error)\n    return false\n  }\n}\n\n/** The window, re-exported so a caller needs one import for the whole join. */\nexport { EMAIL_ATTRIBUTION_WINDOW_MS }\n"],"names":["FieldValue","EMAIL_ATTRIBUTION_MODEL","EMAIL_ATTRIBUTION_WINDOW_DAYS","EMAIL_ATTRIBUTION_WINDOW_MS","emailTouchIsInWindow","isDocumentId","firebaseAdmin","resolveCampaignSendRef","readEmailCampaignTouch","defaultFirestore","app","firestore","EMAIL_ATTRIBUTIONS_COLLECTION","CAMPAIGN_REVENUE_REPORT_DOC","DEFAULT_ATTRIBUTION_CURRENCY","currencyKey","raw","code","String","trim","toLowerCase","test","minorUnits","value","Math","round","Number","isFinite","attributeOrderToEmail","options","hostId","orderId","amountCents","orderedAtMs","Date","now","db","rawEmail","email","touch","campaignId","clickedAtMs","record","currency","model","windowDays","hostRef","collection","doc","create","createdAt","serverTimestamp","sendRef","sendId","set","byCurrency","grossCents","increment","orders","updatedAt","merge","error","console","reverseEmailAttributedRevenue","snapshot","get","exists","data","refundedCents","closedTheOrder","refundedOrders","ref","lastRefundAtMs","kind","chargedBack","fullyRefunded","catch","undefined"],"mappings":"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"}

package/src/lib/server/email-send-record-index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @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 { PluginIndexedRecord, PluginRecordIndex } from '@aglyn/aglyn/plugin-manager/plugin-record-index';
+/** The record kind a campaign's email send is published under. */
+export declare const EMAIL_SEND_RECORD_KIND = "emailSend";
+/**
+ * One send as another plugin reads it (AGL-3080): named by the name the team
+ * gave it, else its subject, with the site it is sent as and its subject as
+ * facts. An unnamed send — no name and no subject — is left out, as the
+ * index contract asks.
+ */
+export declare function emailSendIndexedRecord(id: string, data: Readonly<Record<string, unknown>> | undefined): PluginIndexedRecord | null;
+/**
+ * The organization's email sends, indexed for another plugin (AGL-3080) — a
+ * person's timeline naming the campaign email it lists from the delivery
+ * log. Sends are the ORGANIZATION's (`orgs/{orgId}/campaigns`), each stamped
+ * with the one site it is sent as; asked with a site, the index answers that
+ * site's sends only.
+ */
+export declare const emailSendRecordIndex: PluginRecordIndex;

package/src/lib/server/email-send-record-index.js

@@ -0,0 +1,90 @@
+/**
+ * @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 _extends } from "@swc/helpers/_/_extends";
+import { isDocumentId } from "@aglyn/tenant-data-admin/server/document-id";
+import firebaseAdmin from "@aglyn/tenant-data-admin/server/firebase-admin";
+import { resolveOrgIdForHost } from "@aglyn/tenant-data-admin/server/organizations";
+import { FieldPath } from "firebase-admin/firestore";
+import { orgCampaignSendRef } from "./campaign-conversion-attribution.js";
+/** The record kind a campaign's email send is published under. */ export const EMAIL_SEND_RECORD_KIND = 'emailSend';
+/**
+ * One send as another plugin reads it (AGL-3080): named by the name the team
+ * gave it, else its subject, with the site it is sent as and its subject as
+ * facts. An unnamed send — no name and no subject — is left out, as the
+ * index contract asks.
+ */ export function emailSendIndexedRecord(id, data) {
+    if (!id || !data) return null;
+    const text = (value)=>typeof value === 'string' ? value.trim() : '';
+    const subject = text(data['subject']);
+    const name = text(data['displayName']) || subject;
+    if (!name) return null;
+    const hostId = text(data['hostId']);
+    return {
+        id,
+        name,
+        facts: _extends({}, hostId ? {
+            hostId
+        } : {}, subject ? {
+            subject
+        } : {}, {
+            status: text(data['status']) || null
+        })
+    };
+}
+/** The organization a scope names, resolving it from the site when only a site is given. */ async function scopeOrg(scope) {
+    var _scope_orgId, _scope_hostId;
+    const given = String((_scope_orgId = scope.orgId) != null ? _scope_orgId : '');
+    if (isDocumentId(given)) return given;
+    const hostId = String((_scope_hostId = scope.hostId) != null ? _scope_hostId : '');
+    return isDocumentId(hostId) ? await resolveOrgIdForHost(hostId) : null;
+}
+/**
+ * The organization's email sends, indexed for another plugin (AGL-3080) — a
+ * person's timeline naming the campaign email it lists from the delivery
+ * log. Sends are the ORGANIZATION's (`orgs/{orgId}/campaigns`), each stamped
+ * with the one site it is sent as; asked with a site, the index answers that
+ * site's sends only.
+ */ export const emailSendRecordIndex = {
+    async list (request) {
+        const orgId = await scopeOrg(request);
+        if (!orgId) return {
+            records: [],
+            truncated: false
+        };
+        const firestore = firebaseAdmin.app().firestore();
+        let sends = firestore.collection('orgs').doc(orgId).collection('campaigns');
+        if (request.hostId) sends = sends.where('hostId', '==', request.hostId);
+        const max = Math.max(1, request.limit);
+        const snapshot = await sends.orderBy(FieldPath.documentId()).limit(max + 1).get();
+        const records = snapshot.docs.slice(0, max).map((doc)=>emailSendIndexedRecord(doc.id, doc.data())).filter((record)=>record !== null);
+        return {
+            records,
+            truncated: snapshot.size > max
+        };
+    },
+    async get (request) {
+        if (!isDocumentId(request.id)) return null;
+        const orgId = await scopeOrg(request);
+        if (!orgId) return null;
+        const snapshot = await orgCampaignSendRef(orgId, request.id).get();
+        if (!snapshot.exists) return null;
+        const record = emailSendIndexedRecord(snapshot.id, snapshot.data());
+        if (record && request.hostId && record.facts['hostId'] !== request.hostId) return null;
+        return record;
+    }
+};
+
+//# sourceMappingURL=email-send-record-index.js.map

package/src/lib/server/email-send-record-index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/server/email-send-record-index.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 type {\n  PluginIndexedRecord,\n  PluginRecordIndex,\n} from '@aglyn/aglyn/plugin-manager/plugin-record-index'\nimport { isDocumentId } from '@aglyn/tenant-data-admin/server/document-id'\nimport firebaseAdmin from '@aglyn/tenant-data-admin/server/firebase-admin'\nimport { resolveOrgIdForHost } from '@aglyn/tenant-data-admin/server/organizations'\nimport { FieldPath } from 'firebase-admin/firestore'\nimport { orgCampaignSendRef } from './campaign-conversion-attribution'\n\n/** The record kind a campaign's email send is published under. */\nexport const EMAIL_SEND_RECORD_KIND = 'emailSend'\n\n/**\n * One send as another plugin reads it (AGL-3080): named by the name the team\n * gave it, else its subject, with the site it is sent as and its subject as\n * facts. An unnamed send — no name and no subject — is left out, as the\n * index contract asks.\n */\nexport function emailSendIndexedRecord(\n  id: string,\n  data: Readonly<Record<string, unknown>> | undefined,\n): PluginIndexedRecord | null {\n  if (!id || !data) return null\n  const text = (value: unknown) => (typeof value === 'string' ? value.trim() : '')\n  const subject = text(data['subject'])\n  const name = text(data['displayName']) || subject\n  if (!name) return null\n  const hostId = text(data['hostId'])\n  return {\n    id,\n    name,\n    facts: {\n      ...(hostId ? { hostId } : {}),\n      ...(subject ? { subject } : {}),\n      status: text(data['status']) || null,\n    },\n  }\n}\n\n/** The organization a scope names, resolving it from the site when only a site is given. */\nasync function scopeOrg(scope: { orgId?: string | null; hostId?: string | null }): Promise<string | null> {\n  const given = String(scope.orgId ?? '')\n  if (isDocumentId(given)) return given\n  const hostId = String(scope.hostId ?? '')\n  return isDocumentId(hostId) ? await resolveOrgIdForHost(hostId) : null\n}\n\n/**\n * The organization's email sends, indexed for another plugin (AGL-3080) — a\n * person's timeline naming the campaign email it lists from the delivery\n * log. Sends are the ORGANIZATION's (`orgs/{orgId}/campaigns`), each stamped\n * with the one site it is sent as; asked with a site, the index answers that\n * site's sends only.\n */\nexport const emailSendRecordIndex: PluginRecordIndex = {\n  async list(request) {\n    const orgId = await scopeOrg(request)\n    if (!orgId) return { records: [], truncated: false }\n    const firestore = firebaseAdmin.app().firestore()\n    let sends: FirebaseFirestore.Query = firestore.collection('orgs').doc(orgId).collection('campaigns')\n    if (request.hostId) sends = sends.where('hostId', '==', request.hostId)\n    const max = Math.max(1, request.limit)\n    const snapshot = await sends.orderBy(FieldPath.documentId()).limit(max + 1).get()\n    const records = snapshot.docs\n      .slice(0, max)\n      .map((doc) => emailSendIndexedRecord(doc.id, doc.data()))\n      .filter((record): record is PluginIndexedRecord => record !== null)\n    return { records, truncated: snapshot.size > max }\n  },\n  async get(request) {\n    if (!isDocumentId(request.id)) return null\n    const orgId = await scopeOrg(request)\n    if (!orgId) return null\n    const snapshot = await orgCampaignSendRef(orgId, request.id).get()\n    if (!snapshot.exists) return null\n    const record = emailSendIndexedRecord(snapshot.id, snapshot.data())\n    if (record && request.hostId && record.facts['hostId'] !== request.hostId) return null\n    return record\n  },\n}\n"],"names":["isDocumentId","firebaseAdmin","resolveOrgIdForHost","FieldPath","orgCampaignSendRef","EMAIL_SEND_RECORD_KIND","emailSendIndexedRecord","id","data","text","value","trim","subject","name","hostId","facts","status","scopeOrg","scope","given","String","orgId","emailSendRecordIndex","list","request","records","truncated","firestore","app","sends","collection","doc","where","max","Math","limit","snapshot","orderBy","documentId","get","docs","slice","map","filter","record","size","exists"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;AAMD,SAASA,YAAY,QAAQ,8CAA6C;AAC1E,OAAOC,mBAAmB,iDAAgD;AAC1E,SAASC,mBAAmB,QAAQ,gDAA+C;AACnF,SAASC,SAAS,QAAQ,2BAA0B;AACpD,SAASC,kBAAkB,QAAQ,uCAAmC;AAEtE,gEAAgE,GAChE,OAAO,MAAMC,yBAAyB,YAAW;AAEjD;;;;;CAKC,GACD,OAAO,SAASC,uBACdC,EAAU,EACVC,IAAmD;IAEnD,IAAI,CAACD,MAAM,CAACC,MAAM,OAAO;IACzB,MAAMC,OAAO,CAACC,QAAoB,OAAOA,UAAU,WAAWA,MAAMC,IAAI,KAAK;IAC7E,MAAMC,UAAUH,KAAKD,IAAI,CAAC,UAAU;IACpC,MAAMK,OAAOJ,KAAKD,IAAI,CAAC,cAAc,KAAKI;IAC1C,IAAI,CAACC,MAAM,OAAO;IAClB,MAAMC,SAASL,KAAKD,IAAI,CAAC,SAAS;IAClC,OAAO;QACLD;QACAM;QACAE,OAAO,aACDD,SAAS;YAAEA;QAAO,IAAI,CAAC,GACvBF,UAAU;YAAEA;QAAQ,IAAI,CAAC;YAC7BI,QAAQP,KAAKD,IAAI,CAAC,SAAS,KAAK;;IAEpC;AACF;AAEA,0FAA0F,GAC1F,eAAeS,SAASC,KAAwD;QACzDA,cAECA;IAFtB,MAAMC,QAAQC,QAAOF,eAAAA,MAAMG,KAAK,YAAXH,eAAe;IACpC,IAAIlB,aAAamB,QAAQ,OAAOA;IAChC,MAAML,SAASM,QAAOF,gBAAAA,MAAMJ,MAAM,YAAZI,gBAAgB;IACtC,OAAOlB,aAAac,UAAU,MAAMZ,oBAAoBY,UAAU;AACpE;AAEA;;;;;;CAMC,GACD,OAAO,MAAMQ,uBAA0C;IACrD,MAAMC,MAAKC,OAAO;QAChB,MAAMH,QAAQ,MAAMJ,SAASO;QAC7B,IAAI,CAACH,OAAO,OAAO;YAAEI,SAAS,EAAE;YAAEC,WAAW;QAAM;QACnD,MAAMC,YAAY1B,cAAc2B,GAAG,GAAGD,SAAS;QAC/C,IAAIE,QAAiCF,UAAUG,UAAU,CAAC,QAAQC,GAAG,CAACV,OAAOS,UAAU,CAAC;QACxF,IAAIN,QAAQV,MAAM,EAAEe,QAAQA,MAAMG,KAAK,CAAC,UAAU,MAAMR,QAAQV,MAAM;QACtE,MAAMmB,MAAMC,KAAKD,GAAG,CAAC,GAAGT,QAAQW,KAAK;QACrC,MAAMC,WAAW,MAAMP,MAAMQ,OAAO,CAAClC,UAAUmC,UAAU,IAAIH,KAAK,CAACF,MAAM,GAAGM,GAAG;QAC/E,MAAMd,UAAUW,SAASI,IAAI,CAC1BC,KAAK,CAAC,GAAGR,KACTS,GAAG,CAAC,CAACX,MAAQzB,uBAAuByB,IAAIxB,EAAE,EAAEwB,IAAIvB,IAAI,KACpDmC,MAAM,CAAC,CAACC,SAA0CA,WAAW;QAChE,OAAO;YAAEnB;YAASC,WAAWU,SAASS,IAAI,GAAGZ;QAAI;IACnD;IACA,MAAMM,KAAIf,OAAO;QACf,IAAI,CAACxB,aAAawB,QAAQjB,EAAE,GAAG,OAAO;QACtC,MAAMc,QAAQ,MAAMJ,SAASO;QAC7B,IAAI,CAACH,OAAO,OAAO;QACnB,MAAMe,WAAW,MAAMhC,mBAAmBiB,OAAOG,QAAQjB,EAAE,EAAEgC,GAAG;QAChE,IAAI,CAACH,SAASU,MAAM,EAAE,OAAO;QAC7B,MAAMF,SAAStC,uBAAuB8B,SAAS7B,EAAE,EAAE6B,SAAS5B,IAAI;QAChE,IAAIoC,UAAUpB,QAAQV,MAAM,IAAI8B,OAAO7B,KAAK,CAAC,SAAS,KAAKS,QAAQV,MAAM,EAAE,OAAO;QAClF,OAAO8B;IACT;AACF,EAAC"}

package/src/lib/server/get-client-automations.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/server/get-client-automations.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/server'\nimport { compileClientAutomations, type RawHostAction } from '../model'\nimport { firebaseAdmin } from '@aglyn/tenant-data-admin'\nimport {\n  PUBLISHED_SITE_DATA_TTL_SECONDS,\n  tenantDataTag,\n  withRenderCache,\n} from '@aglyn/tenant-data-admin/render-cache'\n\n/**\n * One of three per-render reads AGL-1302 left uncached (AGL-1440).\n *\n * The automations engine loads on every plan, so this query ran on every render\n * of every path on every site — and an empty result still bills one read. 60s\n * backstop; `revalidateTag(tenant-data:{hostId})` busts it on publish.\n *\n * ONLY the raw documents are cached. The compile below is deliberately outside,\n * and that is the whole safety argument for this cache: `compileClientAutomations`\n * drops the advanced and server steps for orgs without `actions`, and `runJs`\n * for orgs without `webhooks`. Caching a compiled result would pin one org's\n * plan verdict onto the entry — serving a downgraded org paid steps, or a\n * just-upgraded one the trimmed payload, until the tag was busted. The\n * documents are the same for every visitor and every plan; the trim is not.\n */\nconst HOST_ACTIONS_TTL_SECONDS = PUBLISHED_SITE_DATA_TTL_SECONDS\n\n/**\n * A site-event automation prepared for the page runtime (AGL-256): the\n * trigger config the client engine needs, its CLIENT steps, and whether\n * server steps exist (fired actions then dispatch to\n * /api/events/dispatch). Fail-open: errors return an empty list.\n */\nexport type { ClientAutomation } from '../model/site-contract'\nimport type { ClientAutomation } from '../model/site-contract'\n\nexport async function getClientAutomations(options: {\n  hostId: string\n  /** Leading-slash page path for pathPattern targeting. */\n  path: string\n  /**\n   * The composed nodes of the page being rendered.\n   *\n   * Interactions authored on an element live ON the node, so they arrive with\n   * the document rather than from a second query — which is the point: they\n   * publish and roll back with the screen, they travel with a copied\n   * component, and they are gone when the element is. The host's `actions`\n   * collection keeps carrying genuine site-event automations, and both\n   * compile through the same compiler below so the client engine sees one\n   * shape.\n   *\n   * Costs nothing to read: these nodes are already in hand for the render.\n   */\n  nodes?: Iterable<Aglyn.InteractionNode | null | undefined>\n  /**\n   * `actions` entitlement (AGL-577). Basic presentational steps\n   * (menu/drawer/show-hide/class/nav/alert) always load; the advanced\n   * client steps (overlay/showHtml/analytics) and server steps are\n   * dropped when this is false. Server steps are re-checked server-side\n   * on dispatch, so a false value here only trims the client payload.\n   */\n  actionsEntitled: boolean\n  /** Business-tier gate for `runJs` steps (dropped when false). */\n  allowJs: boolean\n  /**\n   * The page has no request path of its own (AGL-2511), so path-scoped\n   * automations are dropped rather than matched. See `dropPathScoped`.\n   */\n  dropPathScoped?: boolean\n}): Promise<ClientAutomation[]> {\n  try {\n    const actions = await withRenderCache({\n      key: ['marketing-host-actions', options.hostId],\n      revalidate: HOST_ACTIONS_TTL_SECONDS,\n      tags: [tenantDataTag(options.hostId)],\n      read: () => readHostActions(options.hostId),\n    })\n    /**\n     * The document's own interactions, merged before the compile.\n     *\n     * AFTER the host actions, so an element's own choreography enrols last\n     * and a site-wide automation on the same event still runs first — the\n     * order a page is read in.\n     *\n     * Deliberately OUTSIDE the cache above. That entry is keyed on the host\n     * and shared by every path on the site; these belong to one page, and\n     * putting them in would serve one screen's interactions to another.\n     */\n    const withNodeInteractions = options.nodes\n      ? [...actions, ...Aglyn.collectNodeInteractions(options.nodes)]\n      : actions\n    // Shared mapping (AGL-830): the same pure compiler the editor Preview\n    // uses, so live and preview trim + shape automations identically. Run per\n    // render, never cached — see `HOST_ACTIONS_TTL_SECONDS`.\n    return compileClientAutomations(withNodeInteractions, {\n      path: options.path,\n      actionsEntitled: options.actionsEntitled,\n      allowJs: options.allowJs,\n      ...(options.dropPathScoped ? { dropPathScoped: true } : {}),\n    })\n  } catch (error) {\n    console.error(error)\n    return []\n  }\n}\n\n/** The host's raw `actions` documents — pure published data, no plan in it. */\nasync function readHostActions(hostId: string): Promise<RawHostAction[]> {\n  const snapshot = await firebaseAdmin\n    .app()\n    .firestore()\n    .collection('hosts')\n    .doc(hostId)\n    .collection('actions')\n    .limit(50)\n    .get()\n  return snapshot.docs.map((doc) => ({\n    id: doc.id,\n    action: doc.data() as Aglyn.HostAction,\n  }))\n}\n\nexport default getClientAutomations\n"],"names":["Aglyn","compileClientAutomations","firebaseAdmin","PUBLISHED_SITE_DATA_TTL_SECONDS","tenantDataTag","withRenderCache","HOST_ACTIONS_TTL_SECONDS","getClientAutomations","options","actions","key","hostId","revalidate","tags","read","readHostActions","withNodeInteractions","nodes","collectNodeInteractions","path","actionsEntitled","allowJs","dropPathScoped","error","console","snapshot","app","firestore","collection","doc","limit","get","docs","map","id","action","data"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,YAAYA,WAAW,sBAAqB;AAC5C,SAASC,wBAAwB,QAA4B,oBAAU;AACvE,SAASC,aAAa,QAAQ,2BAA0B;AACxD,SACEC,+BAA+B,EAC/BC,aAAa,EACbC,eAAe,QACV,wCAAuC;AAE9C;;;;;;;;;;;;;;CAcC,GACD,MAAMC,2BAA2BH;AAWjC,OAAO,eAAeI,qBAAqBC,OAiC1C;IACC,IAAI;QACF,MAAMC,UAAU,MAAMJ,gBAAgB;YACpCK,KAAK;gBAAC;gBAA0BF,QAAQG,MAAM;aAAC;YAC/CC,YAAYN;YACZO,MAAM;gBAACT,cAAcI,QAAQG,MAAM;aAAE;YACrCG,MAAM,IAAMC,gBAAgBP,QAAQG,MAAM;QAC5C;QACA;;;;;;;;;;KAUC,GACD,MAAMK,uBAAuBR,QAAQS,KAAK,GACtC;eAAIR;eAAYT,MAAMkB,uBAAuB,CAACV,QAAQS,KAAK;SAAE,GAC7DR;QACJ,sEAAsE;QACtE,0EAA0E;QAC1E,yDAAyD;QACzD,OAAOR,yBAAyBe,sBAAsB;YACpDG,MAAMX,QAAQW,IAAI;YAClBC,iBAAiBZ,QAAQY,eAAe;YACxCC,SAASb,QAAQa,OAAO;WACpBb,QAAQc,cAAc,GAAG;YAAEA,gBAAgB;QAAK,IAAI,CAAC;IAE7D,EAAE,OAAOC,OAAO;QACdC,QAAQD,KAAK,CAACA;QACd,OAAO,EAAE;IACX;AACF;AAEA,6EAA6E,GAC7E,eAAeR,gBAAgBJ,MAAc;IAC3C,MAAMc,WAAW,MAAMvB,cACpBwB,GAAG,GACHC,SAAS,GACTC,UAAU,CAAC,SACXC,GAAG,CAAClB,QACJiB,UAAU,CAAC,WACXE,KAAK,CAAC,IACNC,GAAG;IACN,OAAON,SAASO,IAAI,CAACC,GAAG,CAAC,CAACJ,MAAS,CAAA;YACjCK,IAAIL,IAAIK,EAAE;YACVC,QAAQN,IAAIO,IAAI;QAClB,CAAA;AACF;AAEA,eAAe7B,qBAAoB"}
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/server/get-client-automations.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/server'\nimport { compileClientAutomations, type RawHostAction } from '../model'\nimport { firebaseAdmin } from '@aglyn/tenant-data-admin'\nimport {\n  PUBLISHED_SITE_DATA_TTL_SECONDS,\n  tenantDataTag,\n  withRenderCache,\n} from '@aglyn/tenant-data-admin/render-cache'\n\n/**\n * One of three per-render reads AGL-1302 left uncached (AGL-1440).\n *\n * The automations engine loads on every plan, so this query ran on every render\n * of every path on every site — and an empty result still bills one read. 60s\n * backstop; `revalidateTag(tenant-data:{hostId})` busts it on publish.\n *\n * ONLY the raw documents are cached. The compile below is deliberately outside,\n * and that is the whole safety argument for this cache: `compileClientAutomations`\n * drops the advanced and server steps for orgs without `actions`, and `runJs`\n * for orgs without `webhooks`. Caching a compiled result would pin one org's\n * plan verdict onto the entry — serving a downgraded org paid steps, or a\n * just-upgraded one the trimmed payload, until the tag was busted. The\n * documents are the same for every visitor and every plan; the trim is not.\n */\nconst HOST_ACTIONS_TTL_SECONDS = PUBLISHED_SITE_DATA_TTL_SECONDS\n\n/**\n * A site-event automation prepared for the page runtime (AGL-256): the\n * trigger config the client engine needs, its CLIENT steps, and whether\n * server steps exist (fired actions then dispatch to\n * /api/events/dispatch). Fail-open: errors return an empty list.\n */\nexport type { ClientAutomation } from '../model/site-contract'\nimport type { ClientAutomation } from '../model/site-contract'\n\nexport async function getClientAutomations(options: {\n  hostId: string\n  /** Leading-slash page path for pathPattern targeting. */\n  path: string\n  /**\n   * The composed nodes of the page being rendered.\n   *\n   * Interactions authored on an element live ON the node, so they arrive with\n   * the document rather than from a second query — which is the point: they\n   * publish and roll back with the screen, they travel with a copied\n   * component, and they are gone when the element is. The host's `actions`\n   * collection keeps carrying genuine site-event automations, and both\n   * compile through the same compiler below so the client engine sees one\n   * shape.\n   *\n   * Costs nothing to read: these nodes are already in hand for the render.\n   */\n  nodes?: Iterable<Aglyn.InteractionNode | null | undefined>\n  /**\n   * `actions` entitlement (AGL-577). Basic presentational steps\n   * (menu/drawer/show-hide/class/nav/alert) always load; the advanced\n   * client steps (overlay/showHtml/analytics) and server steps are\n   * dropped when this is false. Server steps are re-checked server-side\n   * on dispatch, so a false value here only trims the client payload.\n   */\n  actionsEntitled: boolean\n  /** Business-tier gate for `runJs` steps (dropped when false). */\n  allowJs: boolean\n  /**\n   * The page has no request path of its own (AGL-2511), so path-scoped\n   * automations are dropped rather than matched. See `dropPathScoped`.\n   */\n  dropPathScoped?: boolean\n}): Promise<ClientAutomation[]> {\n  try {\n    const actions = await withRenderCache({\n      key: ['marketing-host-actions', options.hostId],\n      revalidate: HOST_ACTIONS_TTL_SECONDS,\n      tags: [tenantDataTag(options.hostId)],\n      read: () => readHostActions(options.hostId),\n    })\n    /**\n     * The document's own interactions, merged before the compile.\n     *\n     * AFTER the host actions, so an element's own choreography enrols last\n     * and a site-wide automation on the same event still runs first — the\n     * order a page is read in.\n     *\n     * Deliberately OUTSIDE the cache above. That entry is keyed on the host\n     * and shared by every path on the site; these belong to one page, and\n     * putting them in would serve one screen's interactions to another.\n     */\n    const withNodeInteractions = options.nodes\n      ? [...actions, ...Aglyn.collectNodeInteractions(options.nodes)]\n      : actions\n    // Shared mapping (AGL-830): the same pure compiler the editor Preview\n    // uses, so live and preview trim + shape automations identically. Run per\n    // render, never cached — see `HOST_ACTIONS_TTL_SECONDS`.\n    return compileClientAutomations(withNodeInteractions, {\n      path: options.path,\n      actionsEntitled: options.actionsEntitled,\n      allowJs: options.allowJs,\n      ...(options.dropPathScoped ? { dropPathScoped: true } : {}),\n    })\n  } catch (error) {\n    console.error(error)\n    return []\n  }\n}\n\n/** The host's raw `actions` documents — pure published data, no plan in it. */\nasync function readHostActions(hostId: string): Promise<RawHostAction[]> {\n  const snapshot = await firebaseAdmin\n    .app()\n    .firestore()\n    .collection('hosts')\n    .doc(hostId)\n    .collection('actions')\n    .limit(50)\n    .get()\n  return snapshot.docs.map((doc) => ({\n    id: doc.id,\n    action: doc.data() as RawHostAction['action'],\n  }))\n}\n\nexport default getClientAutomations\n"],"names":["Aglyn","compileClientAutomations","firebaseAdmin","PUBLISHED_SITE_DATA_TTL_SECONDS","tenantDataTag","withRenderCache","HOST_ACTIONS_TTL_SECONDS","getClientAutomations","options","actions","key","hostId","revalidate","tags","read","readHostActions","withNodeInteractions","nodes","collectNodeInteractions","path","actionsEntitled","allowJs","dropPathScoped","error","console","snapshot","app","firestore","collection","doc","limit","get","docs","map","id","action","data"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,YAAYA,WAAW,sBAAqB;AAC5C,SAASC,wBAAwB,QAA4B,oBAAU;AACvE,SAASC,aAAa,QAAQ,2BAA0B;AACxD,SACEC,+BAA+B,EAC/BC,aAAa,EACbC,eAAe,QACV,wCAAuC;AAE9C;;;;;;;;;;;;;;CAcC,GACD,MAAMC,2BAA2BH;AAWjC,OAAO,eAAeI,qBAAqBC,OAiC1C;IACC,IAAI;QACF,MAAMC,UAAU,MAAMJ,gBAAgB;YACpCK,KAAK;gBAAC;gBAA0BF,QAAQG,MAAM;aAAC;YAC/CC,YAAYN;YACZO,MAAM;gBAACT,cAAcI,QAAQG,MAAM;aAAE;YACrCG,MAAM,IAAMC,gBAAgBP,QAAQG,MAAM;QAC5C;QACA;;;;;;;;;;KAUC,GACD,MAAMK,uBAAuBR,QAAQS,KAAK,GACtC;eAAIR;eAAYT,MAAMkB,uBAAuB,CAACV,QAAQS,KAAK;SAAE,GAC7DR;QACJ,sEAAsE;QACtE,0EAA0E;QAC1E,yDAAyD;QACzD,OAAOR,yBAAyBe,sBAAsB;YACpDG,MAAMX,QAAQW,IAAI;YAClBC,iBAAiBZ,QAAQY,eAAe;YACxCC,SAASb,QAAQa,OAAO;WACpBb,QAAQc,cAAc,GAAG;YAAEA,gBAAgB;QAAK,IAAI,CAAC;IAE7D,EAAE,OAAOC,OAAO;QACdC,QAAQD,KAAK,CAACA;QACd,OAAO,EAAE;IACX;AACF;AAEA,6EAA6E,GAC7E,eAAeR,gBAAgBJ,MAAc;IAC3C,MAAMc,WAAW,MAAMvB,cACpBwB,GAAG,GACHC,SAAS,GACTC,UAAU,CAAC,SACXC,GAAG,CAAClB,QACJiB,UAAU,CAAC,WACXE,KAAK,CAAC,IACNC,GAAG;IACN,OAAON,SAASO,IAAI,CAACC,GAAG,CAAC,CAACJ,MAAS,CAAA;YACjCK,IAAIL,IAAIK,EAAE;YACVC,QAAQN,IAAIO,IAAI;QAClB,CAAA;AACF;AAEA,eAAe7B,qBAAoB"}

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

@@ -14,9 +14,9 @@
  * 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 { CAMPAIGN_SEND_HOST_FIELD } from "@aglyn/shared-ui-email-campaigns/model/campaign-container";
+import { campaignReport } from "../model/campaign-report.js";
+import { EMAIL_CREATED_AT_FIELD, emailSendTimeMs } from "../model/email-record.js";
+import { CAMPAIGN_SEND_HOST_FIELD } from "../model/campaign-container.js";
 import { orgCampaignSends } from "./campaign-org-refs.js";
 import { compareVariants, summarizeVariantStats } from "../model/experiments.js";
 const MARKETING_PLUGIN_ID = 'marketing';