@aglyn/tenant-data-admin 1.0.0-beta.221 → 1.0.0-beta.222

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

@@ -1,450 +0,0 @@
-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 { parseUtmTouch } from "@aglyn/aglyn/app-utils/utm-touch";
-/*
- * Stamped from the REVENUE join's constants, aliased at the import.
- *
- * They are spelled `EMAIL_` because that is where both halves of that join
- * could reach them, not because the window is an email fact — it is the
- * platform's one answer to how long a touch may be credited. Reading them
- * from there is what makes a lead's record and an order's record carry the
- * same rule rather than two that happen to agree.
- */ import { EMAIL_ATTRIBUTION_MODEL as ATTRIBUTION_MODEL, EMAIL_ATTRIBUTION_WINDOW_DAYS as ATTRIBUTION_WINDOW_DAYS, emailTouchIsInWindow } from "@aglyn/shared-util-email/email-revenue-window";
-import { personKey } from "@aglyn/aglyn/app-utils/person-key";
-import { CAMPAIGN_ATTRIBUTIONS_COLLECTION, eraseCampaignAttributionsForPersonKey } from "./campaign-attribution-store.js";
-import { readEmailCampaignTouch } from "./email-delivery-log.js";
-import { isDocumentId } from "./document-id.js";
-import firebaseAdmin from "./firebase-admin.js";
-import { resolveOrgIdForHost } from "./organizations.js";
-const defaultFirestore = ()=>firebaseAdmin.app().firestore();
-/**
- * THE IDENTIFY-MOMENT JOIN — a form, a lead, a contact or a booking, credited
- * to the campaign that led to it.
- *
- * ## Why there is a second join at all, and why it is not a second SCHEME
- *
- * `email-revenue-attribution.ts` credits an ORDER by looking the buyer's
- * address up in the touch map a click wrote. That works because an order
- * names its buyer. Every other outcome a campaign causes is produced by
- * somebody who was anonymous until the instant they produced it: they arrive
- * from a campaign link, browse, and only become identifiable when they submit
- * a form, sign up, book or check out. There is no address to look up until
- * the very moment being attributed.
- *
- * So the touch is carried on the VISITOR (`utm-touch.ts`) and attached
- * here, at each moment they become somebody. What is NOT rebuilt is the
- * model: the same seven-day window, the same last-click rule, the same
- * `model`/`windowDays` stamped onto every record so a report can say what it
- * counted. The email channel is not re-derived either — it is READ from the
- * touch the delivery webhook already wrote, so a campaign email and a
- * campaign ad are two inputs to one comparison rather than two schemes with
- * two answers.
- *
- * ## Last touch, across both channels
- *
- * At the identify moment there can be two candidate touches:
- *
- *  - the WEB touch the visitor's device carried, from an ad, a partner link
- *    or a social post; and
- *  - the EMAIL touch on `emailDeliveries/{personKey}.campaignTouches[hostId]`,
- *    written server-side when they clicked a campaign's mail.
- *
- * Both are window-checked and the LATER one wins. Splitting the outcome
- * between them is the multi-touch model the revenue work rejected for the
- * reason that applies here unchanged: a rule the merchant did not choose
- * produces a figure nobody can check. One outcome, one campaign, and a rule
- * stated on the record.
- *
- * ## No campaign touch means NO RECORD
- *
- * Direct traffic writes nothing at all, and there is deliberately no fallback
- * — no "most recent campaign on this site", no referrer inference, no
- * `utm_source=direct`. A conversion nobody can be credited with is a
- * conversion nobody is credited with, and the absence of a record is how the
- * report says so. The cost of a miss is one uncounted outcome; the cost of a
- * guess is a campaign that reads as effective because it was the last one to
- * run.
- *
- * ## Three reads at most, and usually one
- *
- * Resolving a touch costs ONE keyed document read, and only when the visitor
- * gave an address — no query, no index, nothing that can be truncated. A door
- * resolves once per request and hands the result to every writer beneath it,
- * so a form submission that creates a submission, a contact and a lead pays
- * for the lookup once rather than three times.
- *
- * ## Never throws
- *
- * The same contract as the revenue join and for the same reason: the visitor
- * has already done the thing being attributed and the record of it is already
- * written. A lost attribution understates a campaign; a thrown one loses a
- * lead.
- */ /**
- * The collection and the erasure sweep, re-exported so a caller needs one
- * import for the whole join. They are DEFINED in a leaf module because the
- * sweep runs from `email-delivery-log.ts`, which this file reads — see
- * `campaign-attribution-store.ts` for why that cycle is not merely untidy.
- */ export { CAMPAIGN_ATTRIBUTIONS_COLLECTION, eraseCampaignAttributionsForPersonKey,  };
-/** The single conversion rollup document under an email campaign. */ export const CAMPAIGN_CONVERSIONS_REPORT_DOC = 'conversions';
-/**
- * The document id for one conversion.
- *
- * `{kind}:{refId}`, so the same submission credited twice is the same
- * document — which is what makes {@link attributeCampaignConversion}'s
- * `create()` idempotent. Scoped by kind because the ids come from different
- * collections and a booking id has no reason to be distinct from a form
- * submission's.
- */ export function campaignConversionId(kind, refId) {
-    return `${kind}:${refId}`;
-}
-/**
- * The campaign touch to credit a conversion happening now, or `null`.
- *
- * Called ONCE per conversion request, at the door, and the result handed to
- * every writer beneath it. See the module docblock for the cost argument.
- *
- * @returns the winning touch, or `null` when neither channel has one inside
- *          the window — which is the ordinary case and writes nothing.
- */ export async function resolveCampaignTouch(options, firestore) {
-    try {
-        var _options_hostId, _options_atMs, _options_email;
-        const hostId = String((_options_hostId = options.hostId) != null ? _options_hostId : '');
-        if (!isDocumentId(hostId)) return null;
-        const convertedAtMs = Number((_options_atMs = options.atMs) != null ? _options_atMs : Date.now());
-        if (!Number.isFinite(convertedAtMs) || convertedAtMs <= 0) return null;
-        // The window is enforced inside the parser, so an expired or
-        // future-dated wire value answers null here exactly as it does in the
-        // browser that decided whether to send it.
-        const web = parseUtmTouch(options.wire, convertedAtMs);
-        const key = personKey(options.email);
-        /*
-     * The email channel is only askable of somebody who named an address, and
-     * that is the whole reason this join needs the web channel at all. No
-     * address means no keyed read: the ordinary anonymous conversion costs
-     * nothing here.
-     */ const emailTouch = key ? await readEmailCampaignTouch(String((_options_email = options.email) != null ? _options_email : ''), hostId, firestore != null ? firestore : defaultFirestore()) : null;
-        const emailInWindow = emailTouch && isDocumentId(emailTouch.campaignId) && emailTouchIsInWindow(emailTouch.clickedAtMs, convertedAtMs) ? emailTouch : null;
-        /*
-     * LAST TOUCH decides, and a tie goes to email. A tie is only reachable
-     * when the two instants are the same millisecond, and in that case the
-     * email touch is the better evidence: it was recorded by the provider's
-     * own click event on the server, while the web touch is a value the
-     * visitor's device supplied.
-     */ const emailWins = emailInWindow && (!web || emailInWindow.clickedAtMs >= web.atMs);
-        if (emailWins) {
-            const viaSequence = emailInWindow.sequenceId && emailInWindow.enrollmentId;
-            return _extends({
-                channel: viaSequence ? 'sequence' : 'email',
-                campaignId: emailInWindow.campaignId
-            }, viaSequence ? {
-                sequenceId: emailInWindow.sequenceId,
-                enrollmentId: emailInWindow.enrollmentId
-            } : {}, {
-                touchedAtMs: emailInWindow.clickedAtMs
-            }, key ? {
-                personKey: key
-            } : {});
-        }
-        if (!web) return null;
-        return _extends({
-            channel: 'web'
-        }, web.source ? {
-            source: web.source
-        } : {}, web.medium ? {
-            medium: web.medium
-        } : {}, web.campaign ? {
-            campaign: web.campaign
-        } : {}, {
-            touchedAtMs: web.atMs
-        }, key ? {
-            personKey: key
-        } : {});
-    } catch (error) {
-        console.error('resolveCampaignTouch failed', error);
-        return null;
-    }
-}
-/**
- * Credits one conversion to the campaign the visitor last came from.
- *
- * ## Why the record is a document and not a field
- *
- * The revenue join's three reasons, and the first is decisive here too.
- * `create()` fails when the document already exists, which is exact
- * idempotency for free: a retried form POST, a redelivered booking webhook
- * and a re-run capture all land here a second time and must all leave the
- * rollup where they found it. Second, the four kinds live in four different
- * collections — a contact is org-scoped and shared across every site in the
- * org — so there is no one document a field could go on. Third, the
- * submission, the lead and the booking are read by the inbox, the export and
- * the fulfilment path, and none of them wants a field about marketing.
- *
- * ## The rollup exists for the EMAIL channel only
- *
- * A campaign document is a real entity with a real id, so its conversions
- * roll up under it beside the revenue the same join already credits it with.
- * A web campaign is a LABEL the marketer typed into a URL, with no document,
- * no id and no bound on how many distinct values exist — the same unbounded
- * key space the analytics collector caps its per-day label map against. A
- * rollup keyed on it would be a map anybody who can vary a query string can
- * grow. So the web channel's records stand on their own and a report reads
- * them; see the module's report seam note.
- *
- * @returns the record written, or `null` when nothing was credited.
- */ export async function attributeCampaignConversion(options, firestore) {
-    try {
-        var _options_hostId, _options_refId, _options_convertedAtMs;
-        const { touch } = options;
-        if (!touch) return null;
-        const hostId = String((_options_hostId = options.hostId) != null ? _options_hostId : '');
-        const refId = String((_options_refId = options.refId) != null ? _options_refId : '');
-        if (!isDocumentId(hostId) || !isDocumentId(refId)) return null;
-        const convertedAtMs = Number((_options_convertedAtMs = options.convertedAtMs) != null ? _options_convertedAtMs : Date.now());
-        if (!Number.isFinite(convertedAtMs) || convertedAtMs <= 0) return null;
-        // Re-checked at the write rather than trusted from the resolve. The two
-        // are separated by the writes that produced the thing being credited, and
-        // a touch that has aged out between them is a touch outside the window.
-        if (!emailTouchIsInWindow(touch.touchedAtMs, convertedAtMs)) return null;
-        const record = _extends({
-            kind: options.kind,
-            refId,
-            channel: touch.channel
-        }, touch.campaignId ? {
-            campaignId: touch.campaignId
-        } : {}, touch.sequenceId ? {
-            sequenceId: touch.sequenceId
-        } : {}, touch.enrollmentId ? {
-            enrollmentId: touch.enrollmentId
-        } : {}, touch.source ? {
-            source: touch.source
-        } : {}, touch.medium ? {
-            medium: touch.medium
-        } : {}, touch.campaign ? {
-            campaign: touch.campaign
-        } : {}, {
-            touchedAtMs: touch.touchedAtMs,
-            convertedAtMs,
-            model: ATTRIBUTION_MODEL,
-            windowDays: ATTRIBUTION_WINDOW_DAYS
-        }, touch.personKey ? {
-            personKey: touch.personKey
-        } : {});
-        const db = firestore != null ? firestore : defaultFirestore();
-        const hostRef = db.collection('hosts').doc(hostId);
-        /*
-     * `create()`, never `set()` — the revenue join's argument, unchanged. The
-     * ALREADY_EXISTS failure IS the idempotency, and the rollup below is
-     * reached only when the create succeeded, so the two can never disagree
-     * about whether this conversion was counted.
-     */ try {
-            await hostRef.collection(CAMPAIGN_ATTRIBUTIONS_COLLECTION).doc(campaignConversionId(options.kind, refId)).create(_extends({}, record, {
-                createdAt: FieldValue.serverTimestamp()
-            }));
-        } catch (unused) {
-            return null;
-        }
-        /*
-     * The send the touch names (`touch.campaignId` is a SEND id on the email
-     * channel), wherever it is: the org's `campaigns` collection, or the
-     * site's for a send the migration has not reached. A send in neither
-     * place was discarded, and its rollup is skipped — the record above
-     * already says what was credited.
-     */ const sendRef = touch.channel === 'email' && touch.campaignId && isDocumentId(touch.campaignId) ? await resolveCampaignSendRef({
-            hostId,
-            sendId: touch.campaignId,
-            firestore: db
-        }) : null;
-        if (sendRef) {
-            /*
-       * A merge-set that CREATES, for the reason `reports/revenue` gives: this
-       * writes a document UNDER a campaign, so a campaign that no longer
-       * exists gains an orphaned report rather than being resurrected as a
-       * husk in the merchant's history — and the campaign was proven to exist
-       * when its click wrote the touch.
-       *
-       * Every figure is an increment, so two conversions settling at once
-       * both land.
-       */ await sendRef.collection('reports').doc(CAMPAIGN_CONVERSIONS_REPORT_DOC).set({
-                model: ATTRIBUTION_MODEL,
-                windowDays: ATTRIBUTION_WINDOW_DAYS,
-                byKind: {
-                    [options.kind]: FieldValue.increment(1)
-                },
-                updatedAt: FieldValue.serverTimestamp()
-            }, {
-                merge: true
-            });
-        }
-        /*
-     * A SEQUENCE touch rolls up under the campaign's sequences report, and
-     * only a booking does: "meetings booked from a sequence link" is the one
-     * identify moment a sequence's own outcomes do not already count. The
-     * form, lead and contact kinds stand as records — visible on the record
-     * they credit and on the site's conversions list — and never in
-     * `byKind`, whose caveat promises the reader campaign emails only.
-     */ if (touch.channel === 'sequence' && touch.campaignId && options.kind === 'booking') {
-            await creditCampaignSequenceOutcome({
-                hostId,
-                campaignIds: [
-                    touch.campaignId
-                ],
-                outcome: 'meetings',
-                atMs: convertedAtMs
-            }, db);
-        }
-        return record;
-    } catch (error) {
-        console.error('attributeCampaignConversion failed', error);
-        return null;
-    }
-}
-/*==========================================
- * WHAT A CAMPAIGN'S SEQUENCES PRODUCED (AGL-3254).
- *
- * A sequence joins a campaign the way a form does, and the Outreach runtime
- * credits what each enrollment produced — enrolled, first email sent, a
- * reply, a meeting booked from a sequence link, an enrolled lead converted
- * — to every campaign the sequence was in when the person was enrolled. The
- * counts live in `orgs/{orgId}/campaignSequenceReports/{campaignId}`, beside
- * the org's containers: one document per campaign, server-only like every
- * other report here, and never inside the campaign container, which the
- * history list reads.
- *
- * Idempotency is the CALLER's: a plugin credits an outcome once per
- * enrollment from a state change that happens once — the enrollment is
- * created once, its first email is the first, its status moves to replied
- * once, its lead converts once — so this writer is a plain increment and
- * keeps no per-enrollment record of its own.
- *=========================================*/ /**
- * The per-org collection of sequence rollups. Restated from the reader
- * (`campaign-report.ts` in the campaigns UI library, which this package may
- * not import) and asserted equal by the reader's spec.
- */ export const CAMPAIGN_SEQUENCE_REPORTS_COLLECTION = 'campaignSequenceReports';
-/** The outcomes the runtime credits, in funnel order. */ export const CAMPAIGN_SEQUENCE_OUTCOMES = [
-    'enrolled',
-    'sent',
-    'replied',
-    'meetings',
-    'converted'
-];
-/**
- * Credits one outcome, for one enrollment, to every campaign named.
- *
- * Never throws, and never refuses the batch for one bad id: the outcome
- * has already happened, and a campaign that is gone gains an orphaned
- * report rather than blocking the credit to one that is not — the
- * conversions rollup's own argument for a merge-set that creates.
- *
- * @returns how many campaigns were credited.
- */ export async function creditCampaignSequenceOutcome(options, firestore) {
-    try {
-        var _options_atMs, _options_hostId, _options_orgId;
-        if (!CAMPAIGN_SEQUENCE_OUTCOMES.includes(options.outcome)) return 0;
-        const atMs = Number((_options_atMs = options.atMs) != null ? _options_atMs : Date.now());
-        const ids = [
-            ...new Set(options.campaignIds.map((id)=>String(id != null ? id : '').trim()))
-        ].filter((id)=>isDocumentId(id));
-        if (!ids.length) return 0;
-        const hostId = String((_options_hostId = options.hostId) != null ? _options_hostId : '');
-        const given = String((_options_orgId = options.orgId) != null ? _options_orgId : '');
-        const orgId = isDocumentId(given) ? given : isDocumentId(hostId) ? await resolveOrgIdForHost(hostId) : null;
-        if (!orgId || !isDocumentId(orgId)) return 0;
-        const db = firestore != null ? firestore : defaultFirestore();
-        await Promise.all(ids.map((campaignId)=>orgCampaignSequenceReportRef(orgId, campaignId, db).set(_extends({
-                byOutcome: {
-                    [options.outcome]: FieldValue.increment(1)
-                }
-            }, Number.isFinite(atMs) && atMs > 0 ? {
-                updatedAtMs: atMs
-            } : {}, {
-                updatedAt: FieldValue.serverTimestamp()
-            }), {
-                merge: true
-            })));
-        return ids.length;
-    } catch (error) {
-        console.error('creditCampaignSequenceOutcome failed', error);
-        return 0;
-    }
-}
-/*==========================================
- * WHERE A SEND IS (AGL-3273)
- *=========================================*/ /**
- * WHERE A SEND IS, given only what a link or a delivery event carries.
- *
- * Campaign containers and sends belong to the organization
- * (`orgs/{orgId}/emailCampaigns`, `orgs/{orgId}/campaigns`, AGL-3273). Every
- * reader that starts from inside the product already holds the org id and
- * addresses those collections directly. This module is for the readers that
- * start OUTSIDE it — the unsubscribe link, the provider's delivery webhook,
- * the conversion join — which hold a site id and a send id and nothing else,
- * because that is what was signed into the link or tagged on the message
- * when it went out, possibly years ago.
- *
- * ## The fallback, and why it stays
- *
- * The site path (`hosts/{hostId}/campaigns/{sendId}`) is where every send
- * lived before the move, and the migration copies each one up under its
- * existing id. Between a deployment of this code and the migration reaching
- * an org, the send is still only at the site; and an interrupted migration
- * leaves some sends behind. A reader that looked only at the org would, in
- * that window, drop an unsubscribe's count or a bounce — and a bounce that
- * is dropped is an address that gets mailed again. So the org is asked
- * first and the site second. After the migration the second read never
- * happens, because the first one answers.
- *
- * The collection names are spelled here rather than imported from the
- * campaign model (`@aglyn/shared-ui-email-campaigns`), which this package
- * does not depend on. They are the same strings; `campaign-container.ts`
- * documents them. The join above is this lookup's first reader, and the two
- * move together when the campaign code leaves this package.
- */ const sendRefFirestore = ()=>firebaseAdmin.app().firestore();
-/** `orgs/{orgId}/campaigns` — one document per email send. */ const ORG_SENDS = 'campaigns';
-/** `orgs/{orgId}/campaignSequenceReports` — keyed by the container id. */ const ORG_SEQUENCE_REPORTS = 'campaignSequenceReports';
-/** `orgs/{orgId}/campaigns/{sendId}`. */ export function orgCampaignSendRef(orgId, sendId, firestore = sendRefFirestore()) {
-    return firestore.collection('orgs').doc(orgId).collection(ORG_SENDS).doc(sendId);
-}
-/** `orgs/{orgId}/campaignSequenceReports/{campaignId}`. */ export function orgCampaignSequenceReportRef(orgId, campaignId, firestore = sendRefFirestore()) {
-    return firestore.collection('orgs').doc(orgId).collection(ORG_SEQUENCE_REPORTS).doc(campaignId);
-}
-/** The pre-AGL-3273 location, read only as the fallback described above. */ function legacySiteSendRef(hostId, sendId, firestore) {
-    return firestore.collection('hosts').doc(hostId).collection(ORG_SENDS).doc(sendId);
-}
-/**
- * The send's document, wherever it currently is. Null when neither location
- * holds it — a send id from a link whose send was discarded, or a forged one.
- *
- * Costs one read after the migration (the org document), plus the
- * `hostIndex` lookup when the caller has no org id; that lookup is
- * request-cached.
- */ export async function resolveCampaignSendRef(input) {
-    var _input_firestore;
-    const { hostId, sendId } = input;
-    if (!hostId || !sendId || sendId.includes('/') || hostId.includes('/')) return null;
-    const firestore = (_input_firestore = input.firestore) != null ? _input_firestore : sendRefFirestore();
-    const orgId = input.orgId || await resolveOrgIdForHost(hostId);
-    if (orgId) {
-        const orgRef = orgCampaignSendRef(orgId, sendId, firestore);
-        if ((await orgRef.get()).exists) return orgRef;
-    }
-    const siteRef = legacySiteSendRef(hostId, sendId, firestore);
-    if ((await siteRef.get()).exists) return siteRef;
-    return null;
-}
-
-//# sourceMappingURL=campaign-conversion-attribution.js.map

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

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../../libs/tenant/data/admin/src/lib/server/campaign-conversion-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, type DocumentReference, type Firestore } from 'firebase-admin/firestore'\nimport {\n  parseUtmTouch,\n  type UtmTouch,\n} from '@aglyn/aglyn/app-utils/utm-touch'\n/*\n * Stamped from the REVENUE join's constants, aliased at the import.\n *\n * They are spelled `EMAIL_` because that is where both halves of that join\n * could reach them, not because the window is an email fact — it is the\n * platform's one answer to how long a touch may be credited. Reading them\n * from there is what makes a lead's record and an order's record carry the\n * same rule rather than two that happen to agree.\n */\nimport {\n  EMAIL_ATTRIBUTION_MODEL as ATTRIBUTION_MODEL,\n  EMAIL_ATTRIBUTION_WINDOW_DAYS as ATTRIBUTION_WINDOW_DAYS,\n  emailTouchIsInWindow,\n} from '@aglyn/shared-util-email/email-revenue-window'\nimport { personKey } from '@aglyn/aglyn/app-utils/person-key'\nimport {\n  CAMPAIGN_ATTRIBUTIONS_COLLECTION,\n  eraseCampaignAttributionsForPersonKey,\n} from './campaign-attribution-store'\nimport { readEmailCampaignTouch } from './email-delivery-log'\nimport { isDocumentId } from './document-id'\nimport firebaseAdmin from './firebase-admin'\nimport { resolveOrgIdForHost } from './organizations'\n\nconst defaultFirestore = () => firebaseAdmin.app().firestore()\n\n/**\n * THE IDENTIFY-MOMENT JOIN — a form, a lead, a contact or a booking, credited\n * to the campaign that led to it.\n *\n * ## Why there is a second join at all, and why it is not a second SCHEME\n *\n * `email-revenue-attribution.ts` credits an ORDER by looking the buyer's\n * address up in the touch map a click wrote. That works because an order\n * names its buyer. Every other outcome a campaign causes is produced by\n * somebody who was anonymous until the instant they produced it: they arrive\n * from a campaign link, browse, and only become identifiable when they submit\n * a form, sign up, book or check out. There is no address to look up until\n * the very moment being attributed.\n *\n * So the touch is carried on the VISITOR (`utm-touch.ts`) and attached\n * here, at each moment they become somebody. What is NOT rebuilt is the\n * model: the same seven-day window, the same last-click rule, the same\n * `model`/`windowDays` stamped onto every record so a report can say what it\n * counted. The email channel is not re-derived either — it is READ from the\n * touch the delivery webhook already wrote, so a campaign email and a\n * campaign ad are two inputs to one comparison rather than two schemes with\n * two answers.\n *\n * ## Last touch, across both channels\n *\n * At the identify moment there can be two candidate touches:\n *\n *  - the WEB touch the visitor's device carried, from an ad, a partner link\n *    or a social post; and\n *  - the EMAIL touch on `emailDeliveries/{personKey}.campaignTouches[hostId]`,\n *    written server-side when they clicked a campaign's mail.\n *\n * Both are window-checked and the LATER one wins. Splitting the outcome\n * between them is the multi-touch model the revenue work rejected for the\n * reason that applies here unchanged: a rule the merchant did not choose\n * produces a figure nobody can check. One outcome, one campaign, and a rule\n * stated on the record.\n *\n * ## No campaign touch means NO RECORD\n *\n * Direct traffic writes nothing at all, and there is deliberately no fallback\n * — no \"most recent campaign on this site\", no referrer inference, no\n * `utm_source=direct`. A conversion nobody can be credited with is a\n * conversion nobody is credited with, and the absence of a record is how the\n * report says so. The cost of a miss is one uncounted outcome; the cost of a\n * guess is a campaign that reads as effective because it was the last one to\n * run.\n *\n * ## Three reads at most, and usually one\n *\n * Resolving a touch costs ONE keyed document read, and only when the visitor\n * gave an address — no query, no index, nothing that can be truncated. A door\n * resolves once per request and hands the result to every writer beneath it,\n * so a form submission that creates a submission, a contact and a lead pays\n * for the lookup once rather than three times.\n *\n * ## Never throws\n *\n * The same contract as the revenue join and for the same reason: the visitor\n * has already done the thing being attributed and the record of it is already\n * written. A lost attribution understates a campaign; a thrown one loses a\n * lead.\n */\n\n/**\n * The collection and the erasure sweep, re-exported so a caller needs one\n * import for the whole join. They are DEFINED in a leaf module because the\n * sweep runs from `email-delivery-log.ts`, which this file reads — see\n * `campaign-attribution-store.ts` for why that cycle is not merely untidy.\n */\nexport {\n  CAMPAIGN_ATTRIBUTIONS_COLLECTION,\n  eraseCampaignAttributionsForPersonKey,\n}\n\n/** The single conversion rollup document under an email campaign. */\nexport const CAMPAIGN_CONVERSIONS_REPORT_DOC = 'conversions'\n\n/**\n * Which identify moment a record credits.\n *\n * Kept apart rather than summed, which is the whole reason the kind is on the\n * record. One form submission by a new person creates a submission, a contact\n * and possibly a lead — three true statements about one visitor action — and\n * a report that added them would treble every campaign's conversions. A\n * reader asks for one kind at a time, exactly as the revenue rollup buckets\n * by currency and never totals across them.\n */\nexport type CampaignConversionKind = 'form' | 'lead' | 'contact' | 'booking'\n\n/**\n * Which channel the credited touch arrived through.\n *\n * `sequence` (AGL-3254) is a click on, or the sending of, a one-to-one\n * email a rep's sequence sent. It is read off the same touch map as the\n * email channel — the Outreach click route stamps it there with the\n * sequence and the enrollment beside the campaign the sequence is in — so\n * a booking made from a sequence link is credited by the door that credits\n * every other booking, and nothing in this join has to know what a\n * sequence is.\n */\nexport type CampaignTouchChannel = 'email' | 'web' | 'sequence'\n\n/** The touch a conversion is credited to, once both channels have been asked. */\nexport interface ResolvedCampaignTouch {\n  channel: CampaignTouchChannel\n  /**\n   * The campaign document, when the touch was a click on our own mail — or\n   * the campaign CONTAINER (`emailCampaigns/{id}`) a sequence is in, for a\n   * sequence touch.\n   */\n  campaignId?: string\n  /** The sequence the touch came through, for a `sequence` touch. */\n  sequenceId?: string\n  /** The enrollment the touch came through, for a `sequence` touch. */\n  enrollmentId?: string\n  /** `utm_source`, when the touch was a link on the web. */\n  source?: string\n  /** `utm_medium`, when the touch was a link on the web. */\n  medium?: string\n  /** `utm_campaign`, when the touch was a link on the web. */\n  campaign?: string\n  /** When the visitor followed the campaign link, epoch ms. */\n  touchedAtMs: number\n  /**\n   * `sha256` of the normalized address the touch was resolved against, when\n   * the visitor gave one. The handle an erasure erases by — see\n   * {@link eraseCampaignAttributionsForPersonKey}.\n   */\n  personKey?: string\n}\n\n/** What one conversion attribution record holds. */\nexport interface CampaignConversionRecord extends ResolvedCampaignTouch {\n  kind: CampaignConversionKind\n  /** The submission, lead, contact or booking this credits. */\n  refId: string\n  /** When the visitor became identifiable. */\n  convertedAtMs: number\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/**\n * The document id for one conversion.\n *\n * `{kind}:{refId}`, so the same submission credited twice is the same\n * document — which is what makes {@link attributeCampaignConversion}'s\n * `create()` idempotent. Scoped by kind because the ids come from different\n * collections and a booking id has no reason to be distinct from a form\n * submission's.\n */\nexport function campaignConversionId(\n  kind: CampaignConversionKind,\n  refId: string,\n): string {\n  return `${kind}:${refId}`\n}\n\n/**\n * The campaign touch to credit a conversion happening now, or `null`.\n *\n * Called ONCE per conversion request, at the door, and the result handed to\n * every writer beneath it. See the module docblock for the cost argument.\n *\n * @returns the winning touch, or `null` when neither channel has one inside\n *          the window — which is the ordinary case and writes nothing.\n */\nexport async function resolveCampaignTouch(\n  options: {\n    hostId: string\n    /**\n     * The wire form the conversion request carried, when the door reports\n     * one. Re-parsed through the allowlist that wrote it rather than trusted:\n     * it arrives from the visitor's browser, so it may claim no more than an\n     * inbound URL could.\n     */\n    wire?: unknown\n    /** The address the visitor identified with, raw. */\n    email?: unknown\n    /** When they identified themselves. Defaults to now. */\n    atMs?: number\n  },\n  firestore?: any,\n): Promise<ResolvedCampaignTouch | null> {\n  try {\n    const hostId = String(options.hostId ?? '')\n    if (!isDocumentId(hostId)) return null\n    const convertedAtMs = Number(options.atMs ?? Date.now())\n    if (!Number.isFinite(convertedAtMs) || convertedAtMs <= 0) return null\n\n    // The window is enforced inside the parser, so an expired or\n    // future-dated wire value answers null here exactly as it does in the\n    // browser that decided whether to send it.\n    const web: UtmTouch | null = parseUtmTouch(\n      options.wire,\n      convertedAtMs,\n    )\n\n    const key = personKey(options.email)\n    /*\n     * The email channel is only askable of somebody who named an address, and\n     * that is the whole reason this join needs the web channel at all. No\n     * address means no keyed read: the ordinary anonymous conversion costs\n     * nothing here.\n     */\n    const emailTouch = key\n      ? await readEmailCampaignTouch(\n          String(options.email ?? ''),\n          hostId,\n          firestore ?? defaultFirestore(),\n        )\n      : null\n    const emailInWindow =\n      emailTouch &&\n      isDocumentId(emailTouch.campaignId) &&\n      emailTouchIsInWindow(emailTouch.clickedAtMs, convertedAtMs)\n        ? emailTouch\n        : null\n\n    /*\n     * LAST TOUCH decides, and a tie goes to email. A tie is only reachable\n     * when the two instants are the same millisecond, and in that case the\n     * email touch is the better evidence: it was recorded by the provider's\n     * own click event on the server, while the web touch is a value the\n     * visitor's device supplied.\n     */\n    const emailWins =\n      emailInWindow && (!web || emailInWindow.clickedAtMs >= web.atMs)\n    if (emailWins) {\n      const viaSequence = emailInWindow.sequenceId && emailInWindow.enrollmentId\n      return {\n        channel: viaSequence ? 'sequence' : 'email',\n        campaignId: emailInWindow.campaignId,\n        ...(viaSequence\n          ? { sequenceId: emailInWindow.sequenceId, enrollmentId: emailInWindow.enrollmentId }\n          : {}),\n        touchedAtMs: emailInWindow.clickedAtMs,\n        ...(key ? { personKey: key } : {}),\n      }\n    }\n    if (!web) return null\n    return {\n      channel: 'web',\n      ...(web.source ? { source: web.source } : {}),\n      ...(web.medium ? { medium: web.medium } : {}),\n      ...(web.campaign ? { campaign: web.campaign } : {}),\n      touchedAtMs: web.atMs,\n      ...(key ? { personKey: key } : {}),\n    }\n  } catch (error) {\n    console.error('resolveCampaignTouch failed', error)\n    return null\n  }\n}\n\n/**\n * Credits one conversion to the campaign the visitor last came from.\n *\n * ## Why the record is a document and not a field\n *\n * The revenue join's three reasons, and the first is decisive here too.\n * `create()` fails when the document already exists, which is exact\n * idempotency for free: a retried form POST, a redelivered booking webhook\n * and a re-run capture all land here a second time and must all leave the\n * rollup where they found it. Second, the four kinds live in four different\n * collections — a contact is org-scoped and shared across every site in the\n * org — so there is no one document a field could go on. Third, the\n * submission, the lead and the booking are read by the inbox, the export and\n * the fulfilment path, and none of them wants a field about marketing.\n *\n * ## The rollup exists for the EMAIL channel only\n *\n * A campaign document is a real entity with a real id, so its conversions\n * roll up under it beside the revenue the same join already credits it with.\n * A web campaign is a LABEL the marketer typed into a URL, with no document,\n * no id and no bound on how many distinct values exist — the same unbounded\n * key space the analytics collector caps its per-day label map against. A\n * rollup keyed on it would be a map anybody who can vary a query string can\n * grow. So the web channel's records stand on their own and a report reads\n * them; see the module's report seam note.\n *\n * @returns the record written, or `null` when nothing was credited.\n */\nexport async function attributeCampaignConversion(\n  options: {\n    hostId: string\n    kind: CampaignConversionKind\n    /** The submission, lead, contact or booking being credited. */\n    refId: string\n    /** The touch {@link resolveCampaignTouch} picked, or `null` for direct. */\n    touch: ResolvedCampaignTouch | null | undefined\n    /** When the visitor became identifiable. Defaults to now. */\n    convertedAtMs?: number\n  },\n  firestore?: any,\n): Promise<CampaignConversionRecord | null> {\n  try {\n    const { touch } = options\n    if (!touch) return null\n    const hostId = String(options.hostId ?? '')\n    const refId = String(options.refId ?? '')\n    if (!isDocumentId(hostId) || !isDocumentId(refId)) return null\n    const convertedAtMs = Number(options.convertedAtMs ?? Date.now())\n    if (!Number.isFinite(convertedAtMs) || convertedAtMs <= 0) return null\n    // Re-checked at the write rather than trusted from the resolve. The two\n    // are separated by the writes that produced the thing being credited, and\n    // a touch that has aged out between them is a touch outside the window.\n    if (!emailTouchIsInWindow(touch.touchedAtMs, convertedAtMs)) return null\n\n    const record: CampaignConversionRecord = {\n      kind: options.kind,\n      refId,\n      channel: touch.channel,\n      ...(touch.campaignId ? { campaignId: touch.campaignId } : {}),\n      ...(touch.sequenceId ? { sequenceId: touch.sequenceId } : {}),\n      ...(touch.enrollmentId ? { enrollmentId: touch.enrollmentId } : {}),\n      ...(touch.source ? { source: touch.source } : {}),\n      ...(touch.medium ? { medium: touch.medium } : {}),\n      ...(touch.campaign ? { campaign: touch.campaign } : {}),\n      touchedAtMs: touch.touchedAtMs,\n      convertedAtMs,\n      model: ATTRIBUTION_MODEL,\n      windowDays: ATTRIBUTION_WINDOW_DAYS,\n      ...(touch.personKey ? { personKey: touch.personKey } : {}),\n    }\n\n    const db = firestore ?? defaultFirestore()\n    const hostRef = db.collection('hosts').doc(hostId)\n    /*\n     * `create()`, never `set()` — the revenue join's argument, unchanged. The\n     * ALREADY_EXISTS failure IS the idempotency, and the rollup below is\n     * reached only when the create succeeded, so the two can never disagree\n     * about whether this conversion was counted.\n     */\n    try {\n      await hostRef\n        .collection(CAMPAIGN_ATTRIBUTIONS_COLLECTION)\n        .doc(campaignConversionId(options.kind, refId))\n        .create({ ...record, createdAt: FieldValue.serverTimestamp() })\n    } catch {\n      return null\n    }\n\n    /*\n     * The send the touch names (`touch.campaignId` is a SEND id on the email\n     * channel), wherever it is: the org's `campaigns` collection, or the\n     * site's for a send the migration has not reached. A send in neither\n     * place was discarded, and its rollup is skipped — the record above\n     * already says what was credited.\n     */\n    const sendRef =\n      touch.channel === 'email' && touch.campaignId && isDocumentId(touch.campaignId)\n        ? await resolveCampaignSendRef({ hostId, sendId: touch.campaignId, firestore: db })\n        : null\n    if (sendRef) {\n      /*\n       * A merge-set that CREATES, for the reason `reports/revenue` gives: this\n       * writes a document UNDER a campaign, so a campaign that no longer\n       * exists gains an orphaned report rather than being resurrected as a\n       * husk in the merchant's history — and the campaign was proven to exist\n       * when its click wrote the touch.\n       *\n       * Every figure is an increment, so two conversions settling at once\n       * both land.\n       */\n      await sendRef\n        .collection('reports')\n        .doc(CAMPAIGN_CONVERSIONS_REPORT_DOC)\n        .set(\n          {\n            model: ATTRIBUTION_MODEL,\n            windowDays: ATTRIBUTION_WINDOW_DAYS,\n            byKind: { [options.kind]: FieldValue.increment(1) },\n            updatedAt: FieldValue.serverTimestamp(),\n          },\n          { merge: true },\n        )\n    }\n\n    /*\n     * A SEQUENCE touch rolls up under the campaign's sequences report, and\n     * only a booking does: \"meetings booked from a sequence link\" is the one\n     * identify moment a sequence's own outcomes do not already count. The\n     * form, lead and contact kinds stand as records — visible on the record\n     * they credit and on the site's conversions list — and never in\n     * `byKind`, whose caveat promises the reader campaign emails only.\n     */\n    if (touch.channel === 'sequence' && touch.campaignId && options.kind === 'booking') {\n      await creditCampaignSequenceOutcome(\n        { hostId, campaignIds: [touch.campaignId], outcome: 'meetings', atMs: convertedAtMs },\n        db,\n      )\n    }\n\n    return record\n  } catch (error) {\n    console.error('attributeCampaignConversion failed', error)\n    return null\n  }\n}\n\n/*==========================================\n * WHAT A CAMPAIGN'S SEQUENCES PRODUCED (AGL-3254).\n *\n * A sequence joins a campaign the way a form does, and the Outreach runtime\n * credits what each enrollment produced — enrolled, first email sent, a\n * reply, a meeting booked from a sequence link, an enrolled lead converted\n * — to every campaign the sequence was in when the person was enrolled. The\n * counts live in `orgs/{orgId}/campaignSequenceReports/{campaignId}`, beside\n * the org's containers: one document per campaign, server-only like every\n * other report here, and never inside the campaign container, which the\n * history list reads.\n *\n * Idempotency is the CALLER's: a plugin credits an outcome once per\n * enrollment from a state change that happens once — the enrollment is\n * created once, its first email is the first, its status moves to replied\n * once, its lead converts once — so this writer is a plain increment and\n * keeps no per-enrollment record of its own.\n *=========================================*/\n\n/**\n * The per-org collection of sequence rollups. Restated from the reader\n * (`campaign-report.ts` in the campaigns UI library, which this package may\n * not import) and asserted equal by the reader's spec.\n */\nexport const CAMPAIGN_SEQUENCE_REPORTS_COLLECTION = 'campaignSequenceReports'\n\n/** The outcomes the runtime credits, in funnel order. */\nexport const CAMPAIGN_SEQUENCE_OUTCOMES = [\n  'enrolled',\n  'sent',\n  'replied',\n  'meetings',\n  'converted',\n] as const\n\nexport type CampaignSequenceOutcome = (typeof CAMPAIGN_SEQUENCE_OUTCOMES)[number]\n\n/**\n * Credits one outcome, for one enrollment, to every campaign named.\n *\n * Never throws, and never refuses the batch for one bad id: the outcome\n * has already happened, and a campaign that is gone gains an orphaned\n * report rather than blocking the credit to one that is not — the\n * conversions rollup's own argument for a merge-set that creates.\n *\n * @returns how many campaigns were credited.\n */\nexport async function creditCampaignSequenceOutcome(\n  options: {\n    /** The site the enrollment emails for; resolves the org when none is given. */\n    hostId: string\n    /**\n     * The org whose containers the campaigns are, when the caller holds it —\n     * an enrollment is an org document, so its routes do. Saves the\n     * `hostIndex` read.\n     */\n    orgId?: string | null\n    /** The campaigns the enrollment carries; unusable ids are skipped. */\n    campaignIds: readonly string[]\n    outcome: CampaignSequenceOutcome\n    /** When the outcome happened. Defaults to now. */\n    atMs?: number\n  },\n  firestore?: any,\n): Promise<number> {\n  try {\n    if (!(CAMPAIGN_SEQUENCE_OUTCOMES as readonly string[]).includes(options.outcome)) return 0\n    const atMs = Number(options.atMs ?? Date.now())\n    const ids = [...new Set(options.campaignIds.map((id) => String(id ?? '').trim()))].filter(\n      (id) => isDocumentId(id),\n    )\n    if (!ids.length) return 0\n    const hostId = String(options.hostId ?? '')\n    const given = String(options.orgId ?? '')\n    const orgId = isDocumentId(given)\n      ? given\n      : isDocumentId(hostId)\n        ? await resolveOrgIdForHost(hostId)\n        : null\n    if (!orgId || !isDocumentId(orgId)) return 0\n    const db = firestore ?? defaultFirestore()\n    await Promise.all(\n      ids.map((campaignId) =>\n        orgCampaignSequenceReportRef(orgId, campaignId, db).set(\n          {\n            byOutcome: { [options.outcome]: FieldValue.increment(1) },\n            ...(Number.isFinite(atMs) && atMs > 0 ? { updatedAtMs: atMs } : {}),\n            updatedAt: FieldValue.serverTimestamp(),\n          },\n          { merge: true },\n        ),\n      ),\n    )\n    return ids.length\n  } catch (error) {\n    console.error('creditCampaignSequenceOutcome failed', error)\n    return 0\n  }\n}\n\n/*==========================================\n * WHERE A SEND IS (AGL-3273)\n *=========================================*/\n\n/**\n * WHERE A SEND IS, given only what a link or a delivery event carries.\n *\n * Campaign containers and sends belong to the organization\n * (`orgs/{orgId}/emailCampaigns`, `orgs/{orgId}/campaigns`, AGL-3273). Every\n * reader that starts from inside the product already holds the org id and\n * addresses those collections directly. This module is for the readers that\n * start OUTSIDE it — the unsubscribe link, the provider's delivery webhook,\n * the conversion join — which hold a site id and a send id and nothing else,\n * because that is what was signed into the link or tagged on the message\n * when it went out, possibly years ago.\n *\n * ## The fallback, and why it stays\n *\n * The site path (`hosts/{hostId}/campaigns/{sendId}`) is where every send\n * lived before the move, and the migration copies each one up under its\n * existing id. Between a deployment of this code and the migration reaching\n * an org, the send is still only at the site; and an interrupted migration\n * leaves some sends behind. A reader that looked only at the org would, in\n * that window, drop an unsubscribe's count or a bounce — and a bounce that\n * is dropped is an address that gets mailed again. So the org is asked\n * first and the site second. After the migration the second read never\n * happens, because the first one answers.\n *\n * The collection names are spelled here rather than imported from the\n * campaign model (`@aglyn/shared-ui-email-campaigns`), which this package\n * does not depend on. They are the same strings; `campaign-container.ts`\n * documents them. The join above is this lookup's first reader, and the two\n * move together when the campaign code leaves this package.\n */\n\nconst sendRefFirestore = (): Firestore => firebaseAdmin.app().firestore()\n\n/** `orgs/{orgId}/campaigns` — one document per email send. */\nconst ORG_SENDS = 'campaigns'\n\n/** `orgs/{orgId}/campaignSequenceReports` — keyed by the container id. */\nconst ORG_SEQUENCE_REPORTS = 'campaignSequenceReports'\n\n/** `orgs/{orgId}/campaigns/{sendId}`. */\nexport function orgCampaignSendRef(\n  orgId: string,\n  sendId: string,\n  firestore: Firestore = sendRefFirestore(),\n): DocumentReference {\n  return firestore.collection('orgs').doc(orgId).collection(ORG_SENDS).doc(sendId)\n}\n\n/** `orgs/{orgId}/campaignSequenceReports/{campaignId}`. */\nexport function orgCampaignSequenceReportRef(\n  orgId: string,\n  campaignId: string,\n  firestore: Firestore = sendRefFirestore(),\n): DocumentReference {\n  return firestore\n    .collection('orgs')\n    .doc(orgId)\n    .collection(ORG_SEQUENCE_REPORTS)\n    .doc(campaignId)\n}\n\n/** The pre-AGL-3273 location, read only as the fallback described above. */\nfunction legacySiteSendRef(\n  hostId: string,\n  sendId: string,\n  firestore: Firestore,\n): DocumentReference {\n  return firestore.collection('hosts').doc(hostId).collection(ORG_SENDS).doc(sendId)\n}\n\nexport interface ResolveCampaignSendRefInput {\n  /** The site the link or the message tag names. */\n  hostId: string\n  /** The send id (`cid` on a link, `campaignId` on a message tag). */\n  sendId: string\n  /**\n   * The org, when the caller already has it — a message tag minted since\n   * AGL-3273 carries it. Saves the `hostIndex` read.\n   */\n  orgId?: string | null\n  firestore?: Firestore\n}\n\n/**\n * The send's document, wherever it currently is. Null when neither location\n * holds it — a send id from a link whose send was discarded, or a forged one.\n *\n * Costs one read after the migration (the org document), plus the\n * `hostIndex` lookup when the caller has no org id; that lookup is\n * request-cached.\n */\nexport async function resolveCampaignSendRef(\n  input: ResolveCampaignSendRefInput,\n): Promise<DocumentReference | null> {\n  const { hostId, sendId } = input\n  if (!hostId || !sendId || sendId.includes('/') || hostId.includes('/')) return null\n  const firestore = input.firestore ?? sendRefFirestore()\n  const orgId = input.orgId || (await resolveOrgIdForHost(hostId))\n  if (orgId) {\n    const orgRef = orgCampaignSendRef(orgId, sendId, firestore)\n    if ((await orgRef.get()).exists) return orgRef\n  }\n  const siteRef = legacySiteSendRef(hostId, sendId, firestore)\n  if ((await siteRef.get()).exists) return siteRef\n  return null\n}\n"],"names":["FieldValue","parseUtmTouch","EMAIL_ATTRIBUTION_MODEL","ATTRIBUTION_MODEL","EMAIL_ATTRIBUTION_WINDOW_DAYS","ATTRIBUTION_WINDOW_DAYS","emailTouchIsInWindow","personKey","CAMPAIGN_ATTRIBUTIONS_COLLECTION","eraseCampaignAttributionsForPersonKey","readEmailCampaignTouch","isDocumentId","firebaseAdmin","resolveOrgIdForHost","defaultFirestore","app","firestore","CAMPAIGN_CONVERSIONS_REPORT_DOC","campaignConversionId","kind","refId","resolveCampaignTouch","options","hostId","String","convertedAtMs","Number","atMs","Date","now","isFinite","web","wire","key","email","emailTouch","emailInWindow","campaignId","clickedAtMs","emailWins","viaSequence","sequenceId","enrollmentId","channel","touchedAtMs","source","medium","campaign","error","console","attributeCampaignConversion","touch","record","model","windowDays","db","hostRef","collection","doc","create","createdAt","serverTimestamp","sendRef","resolveCampaignSendRef","sendId","set","byKind","increment","updatedAt","merge","creditCampaignSequenceOutcome","campaignIds","outcome","CAMPAIGN_SEQUENCE_REPORTS_COLLECTION","CAMPAIGN_SEQUENCE_OUTCOMES","includes","ids","Set","map","id","trim","filter","length","given","orgId","Promise","all","orgCampaignSequenceReportRef","byOutcome","updatedAtMs","sendRefFirestore","ORG_SENDS","ORG_SEQUENCE_REPORTS","orgCampaignSendRef","legacySiteSendRef","input","orgRef","get","exists","siteRef"],"mappings":"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"}