@aglyn/plugins-outreach 1.0.0-beta.200 → 1.0.0-beta.201

package/src/lib/model/enrollment-list-query.js

@@ -34,12 +34,29 @@
  *   search      `searchTokens`: every prefix of the person's name and of
  *               their address and its parts, stamped at enrollment by the
  *               enroll route and by `tools/scripts/backfill-outreach-list-search.mjs`
- *               for the enrollments made before it.
+ *               for the enrollments made before it;
+ *   clicked     (AGL-3332) whether the person clicked a link: `clicked`,
+ *               `false` at enrollment and set by the click route's
+ *               transaction on a person's click (never a scanner's), and
+ *               stamped from `engagement.clicks` by the same backfill;
+ *   link        (AGL-3332) a destination they followed, whole:
+ *               `engagement.links`, the capped array the click route keeps,
+ *               asked with `array-contains-any` — the query's one array
+ *               clause, so it and the search cannot stand together and the
+ *               plan refuses the pair by name. The backfill seeds it with an
+ *               earlier click's `lastClickUrl`, the one destination such a
+ *               click is known by.
  *
  * The step, the next send and the last activity are not offered: each is
  * derived from the sequence's steps or from several fields, and a query can
  * ask none of them.
  */ /** The array the search box reads, stamped by the enroll route. */ export const OUTREACH_ENROLLMENT_SEARCH_TOKENS = 'searchTokens';
+/** Whether the person clicked (AGL-3332): what the "Clicked" filter asks. */ export const OUTREACH_ENROLLMENT_CLICKED = 'clicked';
+/** The destinations followed (AGL-3332): what the "Link followed" filter asks. */ export const OUTREACH_ENROLLMENT_LINKS_PATH = 'engagement.links';
+/** The fields the table offers only for a sequence that counts clicks. */ export const OUTREACH_ENROLLMENT_CLICK_FIELDS = [
+    'clicked',
+    'link'
+];
 export const OUTREACH_ENROLLMENT_LIST_QUERY = {
     fields: [
         {
@@ -92,6 +109,23 @@ export const OUTREACH_ENROLLMENT_LIST_QUERY = {
                 'before',
                 'onOrBefore'
             ]
+        },
+        {
+            column: 'clicked',
+            kind: 'boolean',
+            path: OUTREACH_ENROLLMENT_CLICKED,
+            operators: [
+                'equals'
+            ]
+        },
+        {
+            column: 'link',
+            kind: 'exact',
+            path: OUTREACH_ENROLLMENT_LINKS_PATH,
+            tokensPath: OUTREACH_ENROLLMENT_LINKS_PATH,
+            operators: [
+                'isAnyOf'
+            ]
         }
     ],
     sorts: [

package/src/lib/model/enrollment-list-query.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/outreach/src/lib/model/enrollment-list-query.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  ListQueryDeclaration,\n  ListQueryFilter,\n} from '@aglyn/shared-ui-jsx/const/list-query-plan'\n\n/*\n * WHAT A SEQUENCE'S ENROLLMENTS TABLE ASKS FIRESTORE (AGL-3321).\n *\n * One query over `orgs/{orgId}/outreachEnrollments`, narrowed to the\n * sequence (`sequenceId ==`, the list's base) and ordered newest enrolled\n * first, paged by that query. Every clause the Filters panel offers and the\n * search box are predicates on it:\n *\n *   status      the stored status, on every enrollment;\n *   target      `contact` or `lead`, on every enrollment (the ones made\n *               before leads could be sequenced gain `contact` from the\n *               backfill);\n *   stopReason  the stored reason code — the column shows its label and the\n *               stop detail, the query asks by code;\n *   email       the whole address, stored normalized, so `equals` is exact;\n *   enrolled    the table's ONE range: when the person was enrolled, the\n *               field the table is already ordered by, so it costs no index\n *               of its own;\n *   search      `searchTokens`: every prefix of the person's name and of\n *               their address and its parts, stamped at enrollment by the\n *               enroll route and by `tools/scripts/backfill-outreach-list-search.mjs`\n *               for the enrollments made before it.\n *\n * The step, the next send and the last activity are not offered: each is\n * derived from the sequence's steps or from several fields, and a query can\n * ask none of them.\n */\n\n/** The array the search box reads, stamped by the enroll route. */\nexport const OUTREACH_ENROLLMENT_SEARCH_TOKENS = 'searchTokens'\n\nexport const OUTREACH_ENROLLMENT_LIST_QUERY: ListQueryDeclaration = {\n  fields: [\n    { column: 'status', kind: 'exact', path: 'status', presence: 'always', operators: ['equals', 'isAnyOf'] },\n    { column: 'target', kind: 'exact', path: 'target', presence: 'always', operators: ['equals'] },\n    { column: 'stopReason', kind: 'exact', path: 'stopReason', operators: ['equals', 'isAnyOf'] },\n    { column: 'email', kind: 'text', path: 'email', lowerPath: 'email', operators: ['equals'] },\n    {\n      column: 'enrolled',\n      kind: 'date',\n      path: 'createdAtMs',\n      storedAs: 'millis',\n      presence: 'always',\n      operators: ['is', 'after', 'onOrAfter', 'before', 'onOrBefore'],\n    },\n  ],\n  sorts: [{ path: 'createdAtMs', direction: 'desc' }],\n  search: { tokensPath: OUTREACH_ENROLLMENT_SEARCH_TOKENS },\n}\n\n/** The scope every page of the table carries: this sequence's people. */\nexport function outreachEnrollmentListBase(sequenceId: string): ListQueryFilter[] {\n  return [{ path: 'sequenceId', op: '==', value: sequenceId }]\n}\n"],"names":["OUTREACH_ENROLLMENT_SEARCH_TOKENS","OUTREACH_ENROLLMENT_LIST_QUERY","fields","column","kind","path","presence","operators","lowerPath","storedAs","sorts","direction","search","tokensPath","outreachEnrollmentListBase","sequenceId","op","value"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAOD;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BC,GAED,iEAAiE,GACjE,OAAO,MAAMA,oCAAoC,eAAc;AAE/D,OAAO,MAAMC,iCAAuD;IAClEC,QAAQ;QACN;YAAEC,QAAQ;YAAUC,MAAM;YAASC,MAAM;YAAUC,UAAU;YAAUC,WAAW;gBAAC;gBAAU;aAAU;QAAC;QACxG;YAAEJ,QAAQ;YAAUC,MAAM;YAASC,MAAM;YAAUC,UAAU;YAAUC,WAAW;gBAAC;aAAS;QAAC;QAC7F;YAAEJ,QAAQ;YAAcC,MAAM;YAASC,MAAM;YAAcE,WAAW;gBAAC;gBAAU;aAAU;QAAC;QAC5F;YAAEJ,QAAQ;YAASC,MAAM;YAAQC,MAAM;YAASG,WAAW;YAASD,WAAW;gBAAC;aAAS;QAAC;QAC1F;YACEJ,QAAQ;YACRC,MAAM;YACNC,MAAM;YACNI,UAAU;YACVH,UAAU;YACVC,WAAW;gBAAC;gBAAM;gBAAS;gBAAa;gBAAU;aAAa;QACjE;KACD;IACDG,OAAO;QAAC;YAAEL,MAAM;YAAeM,WAAW;QAAO;KAAE;IACnDC,QAAQ;QAAEC,YAAYb;IAAkC;AAC1D,EAAC;AAED,uEAAuE,GACvE,OAAO,SAASc,2BAA2BC,UAAkB;IAC3D,OAAO;QAAC;YAAEV,MAAM;YAAcW,IAAI;YAAMC,OAAOF;QAAW;KAAE;AAC9D"}
+{"version":3,"sources":["../../../../../../../libs/plugins/outreach/src/lib/model/enrollment-list-query.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  ListQueryDeclaration,\n  ListQueryFilter,\n} from '@aglyn/shared-ui-jsx/const/list-query-plan'\n\n/*\n * WHAT A SEQUENCE'S ENROLLMENTS TABLE ASKS FIRESTORE (AGL-3321).\n *\n * One query over `orgs/{orgId}/outreachEnrollments`, narrowed to the\n * sequence (`sequenceId ==`, the list's base) and ordered newest enrolled\n * first, paged by that query. Every clause the Filters panel offers and the\n * search box are predicates on it:\n *\n *   status      the stored status, on every enrollment;\n *   target      `contact` or `lead`, on every enrollment (the ones made\n *               before leads could be sequenced gain `contact` from the\n *               backfill);\n *   stopReason  the stored reason code — the column shows its label and the\n *               stop detail, the query asks by code;\n *   email       the whole address, stored normalized, so `equals` is exact;\n *   enrolled    the table's ONE range: when the person was enrolled, the\n *               field the table is already ordered by, so it costs no index\n *               of its own;\n *   search      `searchTokens`: every prefix of the person's name and of\n *               their address and its parts, stamped at enrollment by the\n *               enroll route and by `tools/scripts/backfill-outreach-list-search.mjs`\n *               for the enrollments made before it;\n *   clicked     (AGL-3332) whether the person clicked a link: `clicked`,\n *               `false` at enrollment and set by the click route's\n *               transaction on a person's click (never a scanner's), and\n *               stamped from `engagement.clicks` by the same backfill;\n *   link        (AGL-3332) a destination they followed, whole:\n *               `engagement.links`, the capped array the click route keeps,\n *               asked with `array-contains-any` — the query's one array\n *               clause, so it and the search cannot stand together and the\n *               plan refuses the pair by name. The backfill seeds it with an\n *               earlier click's `lastClickUrl`, the one destination such a\n *               click is known by.\n *\n * The step, the next send and the last activity are not offered: each is\n * derived from the sequence's steps or from several fields, and a query can\n * ask none of them.\n */\n\n/** The array the search box reads, stamped by the enroll route. */\nexport const OUTREACH_ENROLLMENT_SEARCH_TOKENS = 'searchTokens'\n\n/** Whether the person clicked (AGL-3332): what the \"Clicked\" filter asks. */\nexport const OUTREACH_ENROLLMENT_CLICKED = 'clicked'\n\n/** The destinations followed (AGL-3332): what the \"Link followed\" filter asks. */\nexport const OUTREACH_ENROLLMENT_LINKS_PATH = 'engagement.links'\n\n/** The fields the table offers only for a sequence that counts clicks. */\nexport const OUTREACH_ENROLLMENT_CLICK_FIELDS = ['clicked', 'link'] as const\n\nexport const OUTREACH_ENROLLMENT_LIST_QUERY: ListQueryDeclaration = {\n  fields: [\n    { column: 'status', kind: 'exact', path: 'status', presence: 'always', operators: ['equals', 'isAnyOf'] },\n    { column: 'target', kind: 'exact', path: 'target', presence: 'always', operators: ['equals'] },\n    { column: 'stopReason', kind: 'exact', path: 'stopReason', operators: ['equals', 'isAnyOf'] },\n    { column: 'email', kind: 'text', path: 'email', lowerPath: 'email', operators: ['equals'] },\n    {\n      column: 'enrolled',\n      kind: 'date',\n      path: 'createdAtMs',\n      storedAs: 'millis',\n      presence: 'always',\n      operators: ['is', 'after', 'onOrAfter', 'before', 'onOrBefore'],\n    },\n    { column: 'clicked', kind: 'boolean', path: OUTREACH_ENROLLMENT_CLICKED, operators: ['equals'] },\n    {\n      column: 'link',\n      kind: 'exact',\n      path: OUTREACH_ENROLLMENT_LINKS_PATH,\n      tokensPath: OUTREACH_ENROLLMENT_LINKS_PATH,\n      operators: ['isAnyOf'],\n    },\n  ],\n  sorts: [{ path: 'createdAtMs', direction: 'desc' }],\n  search: { tokensPath: OUTREACH_ENROLLMENT_SEARCH_TOKENS },\n}\n\n/** The scope every page of the table carries: this sequence's people. */\nexport function outreachEnrollmentListBase(sequenceId: string): ListQueryFilter[] {\n  return [{ path: 'sequenceId', op: '==', value: sequenceId }]\n}\n"],"names":["OUTREACH_ENROLLMENT_SEARCH_TOKENS","OUTREACH_ENROLLMENT_CLICKED","OUTREACH_ENROLLMENT_LINKS_PATH","OUTREACH_ENROLLMENT_CLICK_FIELDS","OUTREACH_ENROLLMENT_LIST_QUERY","fields","column","kind","path","presence","operators","lowerPath","storedAs","tokensPath","sorts","direction","search","outreachEnrollmentListBase","sequenceId","op","value"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAOD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCC,GAED,iEAAiE,GACjE,OAAO,MAAMA,oCAAoC,eAAc;AAE/D,2EAA2E,GAC3E,OAAO,MAAMC,8BAA8B,UAAS;AAEpD,gFAAgF,GAChF,OAAO,MAAMC,iCAAiC,mBAAkB;AAEhE,wEAAwE,GACxE,OAAO,MAAMC,mCAAmC;IAAC;IAAW;CAAO,CAAS;AAE5E,OAAO,MAAMC,iCAAuD;IAClEC,QAAQ;QACN;YAAEC,QAAQ;YAAUC,MAAM;YAASC,MAAM;YAAUC,UAAU;YAAUC,WAAW;gBAAC;gBAAU;aAAU;QAAC;QACxG;YAAEJ,QAAQ;YAAUC,MAAM;YAASC,MAAM;YAAUC,UAAU;YAAUC,WAAW;gBAAC;aAAS;QAAC;QAC7F;YAAEJ,QAAQ;YAAcC,MAAM;YAASC,MAAM;YAAcE,WAAW;gBAAC;gBAAU;aAAU;QAAC;QAC5F;YAAEJ,QAAQ;YAASC,MAAM;YAAQC,MAAM;YAASG,WAAW;YAASD,WAAW;gBAAC;aAAS;QAAC;QAC1F;YACEJ,QAAQ;YACRC,MAAM;YACNC,MAAM;YACNI,UAAU;YACVH,UAAU;YACVC,WAAW;gBAAC;gBAAM;gBAAS;gBAAa;gBAAU;aAAa;QACjE;QACA;YAAEJ,QAAQ;YAAWC,MAAM;YAAWC,MAAMP;YAA6BS,WAAW;gBAAC;aAAS;QAAC;QAC/F;YACEJ,QAAQ;YACRC,MAAM;YACNC,MAAMN;YACNW,YAAYX;YACZQ,WAAW;gBAAC;aAAU;QACxB;KACD;IACDI,OAAO;QAAC;YAAEN,MAAM;YAAeO,WAAW;QAAO;KAAE;IACnDC,QAAQ;QAAEH,YAAYb;IAAkC;AAC1D,EAAC;AAED,uEAAuE,GACvE,OAAO,SAASiB,2BAA2BC,UAAkB;IAC3D,OAAO;QAAC;YAAEV,MAAM;YAAcW,IAAI;YAAMC,OAAOF;QAAW;KAAE;AAC9D"}

package/src/lib/model/enrollment-timeline.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @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 { OutreachClickMachineReason } from '../engine/click-tracking';
+import { type OutreachMailGateway } from '../engine/mail-gateway';
+import { type OutreachEnrollment, type OutreachEnrollmentHistoryEntry, type OutreachSequenceStep } from './outreach.types';
+/** What kind of thing an entry is, which the view draws an icon for. */
+export type OutreachTimelineKind = 'enrolled' | 'curated' | 'sent' | 'task' | 'click' | 'scanner' | 'earlier-clicks' | 'paused' | 'resumed' | 'stopped' | 'do-not-contact' | 'replied' | 'bounced' | 'opted-out' | 'held' | 'released' | 'failed' | 'finished';
+/** How loudly the view draws an entry. */
+export type OutreachTimelineTone = 'default' | 'success' | 'info' | 'warning' | 'error';
+/** One line of the timeline. */
+export interface OutreachTimelineEntry {
+    /** Stable across renders, for React and for a spec. */
+    key: string;
+    kind: OutreachTimelineKind;
+    atMs: number;
+    /** What happened, in a few words. */
+    title: string;
+    /** The one fact that matters most, shown in full: a subject, a reason, a diagnostic. */
+    detail?: string | null;
+    /** The rest, each short: the step, who, a scanner's reason. */
+    facts: string[];
+    /** A destination the person followed, shown whole and linkable. */
+    url?: string | null;
+    /** What `url` is, when it is not simply "the link they followed". */
+    urlLabel?: string;
+    /** The Gmail thread this entry opened, for an "Open in Gmail" link. */
+    gmailThreadId?: string | null;
+    tone: OutreachTimelineTone;
+}
+export interface OutreachTimelineInput {
+    enrollment: OutreachEnrollment;
+    steps: readonly OutreachSequenceStep[];
+    /** The history rows, newest or oldest first; `null` while unread or unreadable. */
+    history: readonly OutreachEnrollmentHistoryEntry[] | null;
+    /** A member's name for a stored uid; the uid itself when the roster does not know it. */
+    memberName: (uid: string) => string;
+    /** A moment as the reader reads it — in the mailbox's zone. */
+    formatTime: (ms: number) => string;
+    /** The mail gateway in front of the person's domain, when it is known. */
+    gateway?: OutreachMailGateway | null;
+}
+/** "Email 2 · step 3" for an email step, "Step 2 · Call" for a task, "Step 4" for one the sequence no longer has. */
+export declare function outreachStepName(steps: readonly OutreachSequenceStep[], stepIndex: number): string;
+/** Why a click was read as a scanner's, as the timeline says it. */
+export declare const OUTREACH_MACHINE_REASON_LABELS: Record<OutreachClickMachineReason, string>;
+/**
+ * The timeline, newest first — see the module note.
+ */
+export declare function outreachEnrollmentTimeline(input: OutreachTimelineInput): OutreachTimelineEntry[];
+/** The five figures above the timeline. */
+export interface OutreachEnrollmentFigures {
+    emailsSent: number;
+    clicks: number;
+    /** Distinct destinations followed; `atLeast` when only a floor is known. */
+    linksFollowed: {
+        count: number;
+        atLeast: boolean;
+    };
+    scannerClicks: number;
+    replies: number;
+    /** Whether anything has happened to them beyond being enrolled. */
+    anything: boolean;
+}
+export declare function outreachEnrollmentFigures(enrollment: OutreachEnrollment): OutreachEnrollmentFigures;

package/src/lib/model/enrollment-timeline.js

@@ -0,0 +1,430 @@
+/**
+ * @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.
+ */ /*==========================================
+ * EVERYTHING THAT HAPPENED TO ONE PERSON IN ONE SEQUENCE (AGL-3332).
+ *
+ * The enrollment's detail view is one list, newest first, and this builds
+ * it from what is stored — the enrollment itself, and its history rows —
+ * without inventing anything that is not:
+ *
+ * - **Each send** is a step record: the step, the time, the subject as
+ *   sent, and whether it went out as the person's curated copy.
+ * - **Each click** is a history row: the destination, the step whose email
+ *   carried it, and a person's or a scanner's. Clicks from before the
+ *   history began exist only as totals, and are ONE row saying so — never
+ *   a row per click, which would be a fabrication with a timestamp on it.
+ * - **Each member's act** — pause, resume, stop, do-not-contact — is a
+ *   history row with who and why. An enrollment holds only its current
+ *   stop, so the row is the only record of a pause that was resumed.
+ * - **The current stop** — a reply, a bounce, an opt-out, a hold — comes
+ *   from the enrollment's own fields, with its full reason, unless a
+ *   history row already says it.
+ * - **The gateway hold** (AGL-3326), and its release.
+ * - **The enrollment**, with who enrolled them, and each curated step.
+ *
+ * Client-safe and free of React: the view renders these entries, and the
+ * spec reads them.
+ *=========================================*/ import { _ as _extends } from "@swc/helpers/_/_extends";
+import { OUTREACH_MAIL_GATEWAY_LABELS } from "../engine/mail-gateway.js";
+import { outreachClickSummary } from "./enrollment-engagement.js";
+import { OUTREACH_ENROLLMENT_HISTORY_MAX, OUTREACH_TASK_KIND_LABELS } from "./outreach.types.js";
+/** "Email 2 · step 3" for an email step, "Step 2 · Call" for a task, "Step 4" for one the sequence no longer has. */ export function outreachStepName(steps, stepIndex) {
+    const step = steps[stepIndex];
+    if ((step == null ? void 0 : step.kind) === 'email') {
+        const position = steps.slice(0, stepIndex + 1).filter((entry)=>entry.kind === 'email').length;
+        return `Email ${position} · step ${stepIndex + 1}`;
+    }
+    if ((step == null ? void 0 : step.kind) === 'task') return `Step ${stepIndex + 1} · ${OUTREACH_TASK_KIND_LABELS[step.taskKind]}`;
+    return `Step ${stepIndex + 1}`;
+}
+/** Why a click was read as a scanner's, as the timeline says it. */ export const OUTREACH_MACHINE_REASON_LABELS = {
+    agent: 'the request named itself as a scanner or a link preview',
+    too_soon: 'it came within 30 seconds of the email arriving, faster than anyone reads',
+    method: 'it checked the link without opening the page'
+};
+const ACTION_TITLES = {
+    pause: 'Paused',
+    resume: 'Resumed',
+    stop: 'Stopped by a member',
+    do_not_contact: 'Marked do-not-contact'
+};
+const ACTION_KINDS = {
+    pause: 'paused',
+    resume: 'resumed',
+    stop: 'stopped',
+    do_not_contact: 'do-not-contact'
+};
+/** Which of two entries at the same moment reads first: the outcome above what led to it. */ const TIE_ORDER = {
+    finished: 0,
+    replied: 1,
+    bounced: 1,
+    'opted-out': 1,
+    failed: 1,
+    stopped: 2,
+    'do-not-contact': 2,
+    paused: 2,
+    held: 2,
+    released: 3,
+    resumed: 3,
+    click: 4,
+    scanner: 4,
+    'earlier-clicks': 4,
+    task: 5,
+    sent: 5,
+    curated: 6,
+    enrolled: 7
+};
+const plural = (count, one, many)=>`${count} ${count === 1 ? one : many}`;
+const byWhom = (uid, memberName)=>uid ? `By ${memberName(uid)}` : null;
+/** The step records that are emails, in the order they went. */ function emailRecords(enrollment) {
+    var _enrollment_stepRecords;
+    return ((_enrollment_stepRecords = enrollment.stepRecords) != null ? _enrollment_stepRecords : []).filter((record)=>(record == null ? void 0 : record.kind) === 'email');
+}
+/**
+ * The timeline, newest first — see the module note.
+ */ export function outreachEnrollmentTimeline(input) {
+    var _input_history, _enrollment_stepOverrides, _enrollment_stepRecords;
+    const { enrollment, steps, memberName } = input;
+    const entries = [];
+    const history = (_input_history = input.history) != null ? _input_history : [];
+    const gatewayName = input.gateway ? OUTREACH_MAIL_GATEWAY_LABELS[input.gateway] : null;
+    // ── The enrollment ──────────────────────────────────────────────────────
+    if (enrollment.createdAtMs) {
+        entries.push({
+            key: 'enrolled',
+            kind: 'enrolled',
+            atMs: enrollment.createdAtMs,
+            title: 'Enrolled',
+            facts: [
+                byWhom(enrollment.enrolledByUid, memberName),
+                enrollment.target === 'lead' ? 'As a lead' : 'As a contact',
+                enrollment.cold ? 'Cold — confirmed by the member who enrolled them' : null
+            ].filter((fact)=>Boolean(fact)),
+            tone: 'default'
+        });
+    }
+    // ── Curated copies (AGL-3324) ───────────────────────────────────────────
+    for (const [key, override] of Object.entries((_enrollment_stepOverrides = enrollment.stepOverrides) != null ? _enrollment_stepOverrides : {})){
+        if (!override.draftedAtMs) continue;
+        entries.push({
+            key: `curated-${key}`,
+            kind: 'curated',
+            atMs: override.draftedAtMs,
+            title: `Curated ${outreachStepName(steps, Number(key))}`,
+            facts: [
+                override.source === 'ai' ? override.edited ? 'AI draft, edited' : 'AI draft' : 'Written by a member',
+                byWhom(override.draftedByUid, memberName)
+            ].filter((fact)=>Boolean(fact)),
+            tone: 'default'
+        });
+    }
+    // ── Sends and tasks ─────────────────────────────────────────────────────
+    let previousThread = null;
+    ((_enrollment_stepRecords = enrollment.stepRecords) != null ? _enrollment_stepRecords : []).forEach((record, index)=>{
+        var _record_gmailThreadId;
+        var _record_links;
+        if (!record || typeof record.atMs !== 'number') return;
+        if (record.kind === 'task') {
+            var _steps_find;
+            const step = (_steps_find = steps.find((entry)=>entry.id === record.stepId)) != null ? _steps_find : steps[record.stepIndex];
+            entries.push({
+                key: `task-${index}`,
+                kind: 'task',
+                atMs: record.atMs,
+                title: (step == null ? void 0 : step.kind) === 'task' ? `${OUTREACH_TASK_KIND_LABELS[step.taskKind]} task filed` : 'Task filed',
+                detail: (step == null ? void 0 : step.kind) === 'task' ? step.title : null,
+                facts: [
+                    outreachStepName(steps, record.stepIndex),
+                    record.taskId === null ? 'The CRM could not file it' : null
+                ].filter((fact)=>Boolean(fact)),
+                tone: 'default'
+            });
+            return;
+        }
+        const thread = (_record_gmailThreadId = record.gmailThreadId) != null ? _record_gmailThreadId : null;
+        // The link to Gmail sits on the email that STARTED a thread, once.
+        const startsThread = Boolean(thread) && thread !== previousThread;
+        previousThread = thread != null ? thread : previousThread;
+        entries.push({
+            key: `sent-${index}`,
+            kind: 'sent',
+            atMs: record.atMs,
+            title: `${outreachStepName(steps, record.stepIndex)} sent`,
+            detail: record.subject ? `Subject: ${record.subject}` : null,
+            facts: [
+                record.curated === 'ai' ? 'Curated copy — AI draft' : record.curated === 'member' ? 'Curated copy — written by a member' : null,
+                ((_record_links = record.links) == null ? void 0 : _record_links.length) ? plural(record.links.length, 'tracked link', 'tracked links') : null
+            ].filter((fact)=>Boolean(fact)),
+            gmailThreadId: startsThread ? thread : null,
+            tone: 'default'
+        });
+    });
+    // ── Clicks ──────────────────────────────────────────────────────────────
+    for (const row of history){
+        if (row.kind !== 'click') continue;
+        entries.push(row.human ? {
+            key: `history-${row.id}`,
+            kind: 'click',
+            atMs: row.atMs,
+            title: 'Clicked a link',
+            url: row.url,
+            facts: [
+                `From ${outreachStepName(steps, row.stepIndex)}`
+            ],
+            tone: 'success'
+        } : {
+            key: `history-${row.id}`,
+            kind: 'scanner',
+            atMs: row.atMs,
+            title: 'A scanner followed a link — not counted',
+            url: row.url,
+            facts: [
+                `From ${outreachStepName(steps, row.stepIndex)}`,
+                row.machineReason ? `Read as a scanner: ${OUTREACH_MACHINE_REASON_LABELS[row.machineReason]}` : null
+            ].filter((fact)=>Boolean(fact)),
+            tone: 'default'
+        });
+    }
+    /*
+   * Clicks with no row of their own: counted before the per-click history
+   * began, or past its limit. ONE entry, placed at the first of them when
+   * that is known, saying what the totals hold and nothing more.
+   */ const clicks = outreachClickSummary(enrollment.engagement);
+    const engagement = enrollment.engagement;
+    if (clicks.unloggedClicks > 0 || clicks.unloggedMachineClicks > 0) {
+        var _ref, _ref1, _ref2, _ref3, _ref4, _ref5;
+        var _emailRecords_;
+        const everyHumanUnlogged = clicks.unloggedClicks === clicks.clicks;
+        const loggedRows = clicks.clicks - clicks.unloggedClicks + (clicks.machineClicks - clicks.unloggedMachineClicks);
+        const facts = [];
+        const first = (_ref = engagement == null ? void 0 : engagement.firstClickAtMs) != null ? _ref : null;
+        const last = (_ref1 = engagement == null ? void 0 : engagement.lastClickAtMs) != null ? _ref1 : null;
+        if (clicks.unloggedClicks > 0 && first !== null && everyHumanUnlogged && last !== null) {
+            facts.push(clicks.unloggedClicks === 1 ? `At ${input.formatTime(first)}` : first === last ? `First and last at ${input.formatTime(first)}` : `First at ${input.formatTime(first)}, last at ${input.formatTime(last)}`);
+        } else if (clicks.unloggedClicks > 0 && first !== null) {
+            // Later clicks have rows of their own, so only the first is one of these.
+            facts.push(`First at ${input.formatTime(first)}`);
+        }
+        if (clicks.unloggedMachineClicks > 0) {
+            facts.push(plural(clicks.unloggedMachineClicks, 'scanner click, not counted', 'scanner clicks, not counted'));
+        }
+        entries.push({
+            key: 'earlier-clicks',
+            kind: 'earlier-clicks',
+            atMs: (_ref2 = (_ref3 = (_ref4 = clicks.unloggedClicks > 0 ? engagement == null ? void 0 : engagement.firstClickAtMs : null) != null ? _ref4 : engagement == null ? void 0 : engagement.lastClickAtMs) != null ? _ref3 : (_emailRecords_ = emailRecords(enrollment)[0]) == null ? void 0 : _emailRecords_.atMs) != null ? _ref2 : enrollment.createdAtMs,
+            title: clicks.unloggedClicks > 0 ? `${plural(clicks.unloggedClicks, 'earlier click', 'earlier clicks')}, kept as a total` : `${plural(clicks.unloggedMachineClicks, 'earlier scanner click', 'earlier scanner clicks')}, kept as a total`,
+            detail: loggedRows >= OUTREACH_ENROLLMENT_HISTORY_MAX ? `Each click is listed on its own up to ${OUTREACH_ENROLLMENT_HISTORY_MAX}; these came before per-click history began, or after this person reached that limit.` : 'These came before each click was recorded on its own, so only their count and times were kept.',
+            // The last destination is theirs only when every counted click was.
+            url: clicks.unloggedClicks > 0 && everyHumanUnlogged ? (_ref5 = engagement == null ? void 0 : engagement.lastClickUrl) != null ? _ref5 : null : null,
+            urlLabel: clicks.unloggedClicks === 1 ? 'Link' : 'Last link',
+            facts,
+            tone: clicks.unloggedClicks > 0 ? 'success' : 'default'
+        });
+    }
+    // ── Members' acts ───────────────────────────────────────────────────────
+    const actionTimes = new Set();
+    for (const row of history){
+        var _enrollment_gatewayHold;
+        if (row.kind !== 'action') continue;
+        actionTimes.add(row.atMs);
+        const released = row.action === 'resume' && ((_enrollment_gatewayHold = enrollment.gatewayHold) == null ? void 0 : _enrollment_gatewayHold.releasedAtMs) === row.atMs;
+        if (released) continue;
+        entries.push({
+            key: `history-${row.id}`,
+            kind: ACTION_KINDS[row.action],
+            atMs: row.atMs,
+            title: ACTION_TITLES[row.action],
+            detail: row.detail,
+            facts: [
+                byWhom(row.byUid, memberName)
+            ].filter((fact)=>Boolean(fact)),
+            tone: row.action === 'resume' ? 'default' : row.action === 'pause' ? 'warning' : 'default'
+        });
+    }
+    // ── The gateway hold (AGL-3326) ─────────────────────────────────────────
+    const hold = enrollment.gatewayHold;
+    const holdGateway = hold ? OUTREACH_MAIL_GATEWAY_LABELS[hold.gateway] : null;
+    if (hold == null ? void 0 : hold.heldAtMs) {
+        entries.push({
+            key: 'held',
+            kind: 'held',
+            atMs: hold.heldAtMs,
+            title: `Held — ${holdGateway} refused this sender`,
+            detail: enrollment.stopReason === 'gateway_blocked_here' && enrollment.stoppedAtMs === hold.heldAtMs ? enrollment.stopDetail : null,
+            facts: [
+                'Nothing was sent to them while it was held'
+            ],
+            tone: 'warning'
+        });
+    }
+    if (hold == null ? void 0 : hold.releasedAtMs) {
+        entries.push({
+            key: 'released',
+            kind: 'released',
+            atMs: hold.releasedAtMs,
+            title: hold.heldAtMs ? `Resumed past the ${holdGateway} hold — sent anyway` : `Enrolled past the ${holdGateway} warning`,
+            facts: [
+                byWhom(hold.releasedByUid, memberName)
+            ].filter((fact)=>Boolean(fact)),
+            tone: 'default'
+        });
+    }
+    // ── The current stop, from the enrollment ───────────────────────────────
+    const stoppedAtMs = enrollment.stoppedAtMs;
+    const alreadySaid = stoppedAtMs !== null && (actionTimes.has(stoppedAtMs) || enrollment.stopReason === 'gateway_blocked_here' && (hold == null ? void 0 : hold.heldAtMs) === stoppedAtMs);
+    if (stoppedAtMs && !alreadySaid && enrollment.status !== 'active' && enrollment.status !== 'finished') {
+        const stop = currentStop(enrollment, memberName, gatewayName);
+        if (stop) entries.push(_extends({
+            key: 'stop',
+            atMs: stoppedAtMs
+        }, stop));
+    }
+    // ── Finished ────────────────────────────────────────────────────────────
+    if (enrollment.status === 'finished') {
+        var _enrollment_stepRecords1, _ref6;
+        const last = ((_enrollment_stepRecords1 = enrollment.stepRecords) != null ? _enrollment_stepRecords1 : []).at(-1);
+        entries.push({
+            key: 'finished',
+            kind: 'finished',
+            atMs: (_ref6 = last == null ? void 0 : last.atMs) != null ? _ref6 : enrollment.updatedAtMs,
+            title: 'Finished — every step ran',
+            facts: [],
+            tone: 'success'
+        });
+    }
+    return entries.sort((a, b)=>b.atMs - a.atMs || TIE_ORDER[a.kind] - TIE_ORDER[b.kind]);
+}
+/** The entry for the stop the enrollment is in now. */ function currentStop(enrollment, memberName, gatewayName) {
+    const detail = enrollment.stopDetail;
+    const by = byWhom(enrollment.stoppedByUid, memberName);
+    const facts = (...values)=>values.filter((fact)=>Boolean(fact));
+    switch(enrollment.stopReason){
+        case 'reply':
+            var _ref, _enrollment_gmailThreadId;
+            return {
+                kind: 'replied',
+                title: 'Replied',
+                detail,
+                facts: [
+                    'The sequence stopped for them'
+                ],
+                gmailThreadId: (_ref = (_enrollment_gmailThreadId = enrollment.gmailThreadId) != null ? _enrollment_gmailThreadId : enrollment.gmailThreadIds.at(-1)) != null ? _ref : null,
+                tone: 'info'
+            };
+        case 'hard_bounce':
+            return {
+                kind: 'bounced',
+                title: 'Bounced',
+                detail,
+                facts: facts(gatewayName ? `Their mail gateway: ${gatewayName}` : null, 'The address is on the do-not-contact list'),
+                tone: 'error'
+            };
+        case 'opt_out_reply':
+            return {
+                kind: 'opted-out',
+                title: 'Asked not to be emailed, in a reply',
+                detail,
+                facts: [],
+                tone: 'warning'
+            };
+        case 'unsubscribe':
+            return {
+                kind: 'opted-out',
+                title: 'Unsubscribed',
+                detail,
+                facts: [],
+                tone: 'warning'
+            };
+        case 'do_not_contact':
+            return {
+                kind: 'do-not-contact',
+                title: 'Put on the do-not-contact list',
+                detail,
+                facts: facts(by),
+                tone: 'warning'
+            };
+        case 'manual':
+            return enrollment.status === 'paused' ? {
+                kind: 'paused',
+                title: 'Paused',
+                detail,
+                facts: facts(by),
+                tone: 'warning'
+            } : {
+                kind: 'stopped',
+                title: 'Stopped by a member',
+                detail,
+                facts: facts(by),
+                tone: 'default'
+            };
+        case 'gate':
+            return {
+                kind: 'stopped',
+                title: 'Stopped — no longer eligible',
+                detail,
+                facts: [],
+                tone: 'default'
+            };
+        case 'sequence_archived':
+            return {
+                kind: 'stopped',
+                title: 'Stopped — the sequence was archived',
+                detail,
+                facts: [],
+                tone: 'default'
+            };
+        case 'gateway_blocked_here':
+            return {
+                kind: 'held',
+                title: 'Held — their mail gateway refused this sender',
+                detail,
+                facts: [],
+                tone: 'warning'
+            };
+        case 'send_failed':
+            return {
+                kind: 'failed',
+                title: 'An email couldn’t be sent',
+                detail,
+                facts: [],
+                tone: 'error'
+            };
+        default:
+            return null;
+    }
+}
+export function outreachEnrollmentFigures(enrollment) {
+    var _enrollment_stepRecords;
+    const clicks = outreachClickSummary(enrollment.engagement);
+    const emailsSent = emailRecords(enrollment).length;
+    const replies = enrollment.status === 'replied' || enrollment.stopReason === 'reply' || enrollment.stopReason === 'opt_out_reply' ? 1 : 0;
+    return {
+        emailsSent,
+        clicks: clicks.clicks,
+        linksFollowed: clicks.linkCount === null ? {
+            count: clicks.followed.length,
+            atLeast: true
+        } : {
+            count: clicks.linkCount,
+            atLeast: clicks.linksCapped
+        },
+        scannerClicks: clicks.machineClicks,
+        replies,
+        anything: emailsSent > 0 || ((_enrollment_stepRecords = enrollment.stepRecords) != null ? _enrollment_stepRecords : []).length > 0 || clicks.clicks > 0 || clicks.machineClicks > 0 || enrollment.stoppedAtMs !== null
+    };
+}
+
+//# sourceMappingURL=enrollment-timeline.js.map