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

package/src/lib/model/do-not-contact-domain-list-query.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/outreach/src/lib/model/do-not-contact-domain-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 { nameSearchTokens } from '@aglyn/aglyn/app-utils/name-search'\nimport {\n  LIST_QUERY_ID_PATH,\n  type ListQueryDeclaration,\n} from '@aglyn/shared-ui-jsx/const/list-query-plan'\nimport type { OutreachDoNotContactDomainEntry } from './outreach.types'\n\n/*\n * WHAT THE DO-NOT-CONTACT DOMAINS LIST ASKS FIRESTORE (AGL-3321).\n *\n * One query over `orgs/{orgId}/outreachDoNotContactDomains`, alphabetical —\n * the document id IS the domain — paged by that query:\n *\n *   domain  `equals` one domain, on the `domain` field every entry carries\n *           beside its id, lower-cased the way every domain is written; a\n *           prefix is the search box's job, which reads every label;\n *   reason  the stored reason, which every entry carries;\n *   added   the list's ONE range: when the entry was added, which every\n *           entry carries; a range leads the order, so while it applies\n *           the list is newest added first;\n *   search  `searchTokens`: the domain, each shorter domain inside it and\n *           each of its labels, and the words of its detail, stamped when\n *           the entry is created.\n *\n * Without the range every shape is equalities and the one array clause,\n * ordered by the document id, which Firestore serves by merging\n * single-field indexes. The range's order needs one composite per\n * equality field beside it: `reason` and `searchTokens`.\n */\n\n/** The array the search box reads, stamped by the one writer that adds a domain. */\nexport const OUTREACH_DOMAIN_SEARCH_TOKENS = 'searchTokens'\n\nexport const OUTREACH_DO_NOT_CONTACT_DOMAIN_LIST_QUERY: ListQueryDeclaration = {\n  fields: [\n    { column: 'domain', kind: 'text', path: 'domain', lowerPath: 'domain', operators: ['equals'] },\n    { column: 'reason', kind: 'exact', path: 'reason', presence: 'always', operators: ['equals', 'isAnyOf'] },\n    {\n      column: 'addedAtMs',\n      kind: 'date',\n      path: 'addedAtMs',\n      storedAs: 'millis',\n      presence: 'always',\n      operators: ['is', 'after', 'onOrAfter', 'before', 'onOrBefore'],\n    },\n  ],\n  sorts: [{ path: LIST_QUERY_ID_PATH, direction: 'asc' }],\n  search: { tokensPath: OUTREACH_DOMAIN_SEARCH_TOKENS },\n}\n\n/**\n * What the domains list searches an entry by: every prefix of the domain\n * whole and of each shorter domain inside it, of each of its labels, and of\n * each word of its detail — so \"acme\", \"acme.com\" and \"mail.ac\" all find\n * `mail.acme.com`, and \"barracuda\" finds the domain a gateway block filed.\n * An entry is created once and never edited, so its one writer stamps this\n * and `tools/scripts/backfill-outreach-list-search.mjs` restates it for the\n * entries made before it; both are held to\n * `tools/scripts/lib/outreach-search-tokens.fixtures.json`.\n */\nexport function outreachDomainSearchTokens(\n  entry: Pick<OutreachDoNotContactDomainEntry, 'domain' | 'detail'>,\n): string[] {\n  const domain = String(entry.domain ?? '')\n  const labels = domain.split('.')\n  const within = labels.map((_, at) => labels.slice(at).join('.'))\n  return nameSearchTokens([...within, ...domain.split(/[.-]+/), entry.detail ?? ''].join(' '))\n}\n"],"names":["nameSearchTokens","LIST_QUERY_ID_PATH","OUTREACH_DOMAIN_SEARCH_TOKENS","OUTREACH_DO_NOT_CONTACT_DOMAIN_LIST_QUERY","fields","column","kind","path","lowerPath","operators","presence","storedAs","sorts","direction","search","tokensPath","outreachDomainSearchTokens","entry","domain","String","labels","split","within","map","_","at","slice","join","detail"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,gBAAgB,QAAQ,qCAAoC;AACrE,SACEC,kBAAkB,QAEb,6CAA4C;AAGnD;;;;;;;;;;;;;;;;;;;;;CAqBC,GAED,kFAAkF,GAClF,OAAO,MAAMC,gCAAgC,eAAc;AAE3D,OAAO,MAAMC,4CAAkE;IAC7EC,QAAQ;QACN;YAAEC,QAAQ;YAAUC,MAAM;YAAQC,MAAM;YAAUC,WAAW;YAAUC,WAAW;gBAAC;aAAS;QAAC;QAC7F;YAAEJ,QAAQ;YAAUC,MAAM;YAASC,MAAM;YAAUG,UAAU;YAAUD,WAAW;gBAAC;gBAAU;aAAU;QAAC;QACxG;YACEJ,QAAQ;YACRC,MAAM;YACNC,MAAM;YACNI,UAAU;YACVD,UAAU;YACVD,WAAW;gBAAC;gBAAM;gBAAS;gBAAa;gBAAU;aAAa;QACjE;KACD;IACDG,OAAO;QAAC;YAAEL,MAAMN;YAAoBY,WAAW;QAAM;KAAE;IACvDC,QAAQ;QAAEC,YAAYb;IAA8B;AACtD,EAAC;AAED;;;;;;;;;CASC,GACD,OAAO,SAASc,2BACdC,KAAiE;QAE3CA,eAGwCA;IAH9D,MAAMC,SAASC,QAAOF,gBAAAA,MAAMC,MAAM,YAAZD,gBAAgB;IACtC,MAAMG,SAASF,OAAOG,KAAK,CAAC;IAC5B,MAAMC,SAASF,OAAOG,GAAG,CAAC,CAACC,GAAGC,KAAOL,OAAOM,KAAK,CAACD,IAAIE,IAAI,CAAC;IAC3D,OAAO3B,iBAAiB;WAAIsB;WAAWJ,OAAOG,KAAK,CAAC;SAAUJ,gBAAAA,MAAMW,MAAM,YAAZX,gBAAgB;KAAG,CAACU,IAAI,CAAC;AACzF"}

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

@@ -14,7 +14,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { OutreachEnrollmentEngagement } from './outreach.types';
+import { type OutreachEnrollmentEngagement } from './outreach.types';
 /**
  * WHAT ONE PERSON DID WITH THE LINKS THEY WERE SENT (AGL-3239), read back
  * from the stored map.
@@ -28,4 +28,28 @@ import type { OutreachEnrollmentEngagement } from './outreach.types';
  * every enrollment of every sequence that does not track clicks, so it is
  * the common case rather than the edge one.
  */
-export declare function readOutreachEngagement(raw: unknown): OutreachEnrollmentEngagement;
+export declare function readOutreachEngagement(raw: unknown): Required<OutreachEnrollmentEngagement>;
+/**
+ * What the enrollments table and the detail view say about one person's
+ * clicks (AGL-3332), from the engagement alone.
+ *
+ * `linkCount` is the number of distinct destinations they followed when that
+ * number is KNOWN, and `null` when it is not: a click from before the
+ * per-click history kept only the last destination, so a person with two
+ * such clicks followed one link or two, and neither is claimed.
+ * `linksCapped` says the list stopped at {@link OUTREACH_ENGAGEMENT_LINKS_MAX}.
+ */
+export interface OutreachClickSummary {
+    clicks: number;
+    machineClicks: number;
+    /** Every destination known to have been followed: the history's, and the last one. */
+    followed: string[];
+    linkCount: number | null;
+    linksCapped: boolean;
+    /** Human clicks counted as totals only, with no row of their own. */
+    unloggedClicks: number;
+    unloggedMachineClicks: number;
+}
+export declare function outreachClickSummary(raw: unknown): OutreachClickSummary;
+/** The Clicks cell: "2 · 1 link", or the count alone when the links are not known. */
+export declare function outreachClickCountLabel(summary: OutreachClickSummary): string;

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

@@ -13,7 +13,8 @@
  * 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 { OUTREACH_ENGAGEMENT_LINKS_MAX } from "./outreach.types.js";
+/**
  * WHAT ONE PERSON DID WITH THE LINKS THEY WERE SENT (AGL-3239), read back
  * from the stored map.
  *
@@ -32,13 +33,49 @@
         return Number.isFinite(parsed) && parsed > 0 ? Math.floor(parsed) : 0;
     };
     const ms = (value)=>typeof value === 'number' && Number.isFinite(value) ? value : null;
+    const clicks = count(data['clicks']);
+    const machineClicks = count(data['machineClicks']);
+    const links = Array.isArray(data['links']) ? [
+        ...new Set(data['links'].filter((entry)=>typeof entry === 'string' && entry !== ''))
+    ] : [];
     return {
-        clicks: count(data['clicks']),
+        clicks,
         firstClickAtMs: ms(data['firstClickAtMs']),
         lastClickAtMs: ms(data['lastClickAtMs']),
         lastClickUrl: typeof data['lastClickUrl'] === 'string' ? data['lastClickUrl'] : null,
-        machineClicks: count(data['machineClicks'])
+        machineClicks,
+        links: links.slice(0, OUTREACH_ENGAGEMENT_LINKS_MAX),
+        // Never more than the totals they are part of: a history row is written
+        // in the same transaction as the count it itemizes.
+        loggedClicks: Math.min(count(data['loggedClicks']), clicks),
+        loggedMachineClicks: Math.min(count(data['loggedMachineClicks']), machineClicks)
     };
 }
+export function outreachClickSummary(raw) {
+    const engagement = readOutreachEngagement(raw);
+    const followed = [
+        ...engagement.links
+    ];
+    if (engagement.lastClickUrl && !followed.includes(engagement.lastClickUrl)) followed.push(engagement.lastClickUrl);
+    const unloggedClicks = engagement.clicks - engagement.loggedClicks;
+    const linksCapped = engagement.links.length >= OUTREACH_ENGAGEMENT_LINKS_MAX;
+    // Exact when every human click has a row, or when there was only one.
+    const exact = unloggedClicks === 0 || engagement.clicks === 1 && engagement.lastClickUrl !== null;
+    return {
+        clicks: engagement.clicks,
+        machineClicks: engagement.machineClicks,
+        followed,
+        linkCount: engagement.clicks === 0 ? 0 : exact ? followed.length : null,
+        linksCapped,
+        unloggedClicks,
+        unloggedMachineClicks: engagement.machineClicks - engagement.loggedMachineClicks
+    };
+}
+/** The Clicks cell: "2 · 1 link", or the count alone when the links are not known. */ export function outreachClickCountLabel(summary) {
+    if (!summary.clicks) return '—';
+    if (summary.linkCount === null) return String(summary.clicks);
+    const links = `${summary.linkCount}${summary.linksCapped ? '+' : ''}`;
+    return `${summary.clicks} · ${links} ${summary.linkCount === 1 && !summary.linksCapped ? 'link' : 'links'}`;
+}
 
 //# sourceMappingURL=enrollment-engagement.js.map

package/src/lib/model/enrollment-engagement.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/outreach/src/lib/model/enrollment-engagement.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 { OutreachEnrollmentEngagement } from './outreach.types'\n\n/**\n * WHAT ONE PERSON DID WITH THE LINKS THEY WERE SENT (AGL-3239), read back\n * from the stored map.\n *\n * Client-safe, and here rather than beside the writer for that reason: the\n * enrollments table renders this in the browser and the click route writes\n * it on the server, and both must agree on what an absent field means.\n *\n * Read defensively, a field at a time. `readOutreachEngagement(undefined)`\n * is what an enrollment that has never been clicked reads as — which is\n * every enrollment of every sequence that does not track clicks, so it is\n * the common case rather than the edge one.\n */\nexport function readOutreachEngagement(raw: unknown): OutreachEnrollmentEngagement {\n  const data = (raw ?? {}) as Record<string, unknown>\n  const count = (value: unknown): number => {\n    const parsed = Number(value)\n    return Number.isFinite(parsed) && parsed > 0 ? Math.floor(parsed) : 0\n  }\n  const ms = (value: unknown): number | null =>\n    typeof value === 'number' && Number.isFinite(value) ? value : null\n  return {\n    clicks: count(data['clicks']),\n    firstClickAtMs: ms(data['firstClickAtMs']),\n    lastClickAtMs: ms(data['lastClickAtMs']),\n    lastClickUrl: typeof data['lastClickUrl'] === 'string' ? data['lastClickUrl'] : null,\n    machineClicks: count(data['machineClicks']),\n  }\n}\n"],"names":["readOutreachEngagement","raw","data","count","value","parsed","Number","isFinite","Math","floor","ms","clicks","firstClickAtMs","lastClickAtMs","lastClickUrl","machineClicks"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAID;;;;;;;;;;;;CAYC,GACD,OAAO,SAASA,uBAAuBC,GAAY;IACjD,MAAMC,OAAQD,cAAAA,MAAO,CAAC;IACtB,MAAME,QAAQ,CAACC;QACb,MAAMC,SAASC,OAAOF;QACtB,OAAOE,OAAOC,QAAQ,CAACF,WAAWA,SAAS,IAAIG,KAAKC,KAAK,CAACJ,UAAU;IACtE;IACA,MAAMK,KAAK,CAACN,QACV,OAAOA,UAAU,YAAYE,OAAOC,QAAQ,CAACH,SAASA,QAAQ;IAChE,OAAO;QACLO,QAAQR,MAAMD,IAAI,CAAC,SAAS;QAC5BU,gBAAgBF,GAAGR,IAAI,CAAC,iBAAiB;QACzCW,eAAeH,GAAGR,IAAI,CAAC,gBAAgB;QACvCY,cAAc,OAAOZ,IAAI,CAAC,eAAe,KAAK,WAAWA,IAAI,CAAC,eAAe,GAAG;QAChFa,eAAeZ,MAAMD,IAAI,CAAC,gBAAgB;IAC5C;AACF"}
+{"version":3,"sources":["../../../../../../../libs/plugins/outreach/src/lib/model/enrollment-engagement.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 { OUTREACH_ENGAGEMENT_LINKS_MAX, type OutreachEnrollmentEngagement } from './outreach.types'\n\n/**\n * WHAT ONE PERSON DID WITH THE LINKS THEY WERE SENT (AGL-3239), read back\n * from the stored map.\n *\n * Client-safe, and here rather than beside the writer for that reason: the\n * enrollments table renders this in the browser and the click route writes\n * it on the server, and both must agree on what an absent field means.\n *\n * Read defensively, a field at a time. `readOutreachEngagement(undefined)`\n * is what an enrollment that has never been clicked reads as — which is\n * every enrollment of every sequence that does not track clicks, so it is\n * the common case rather than the edge one.\n */\nexport function readOutreachEngagement(raw: unknown): Required<OutreachEnrollmentEngagement> {\n  const data = (raw ?? {}) as Record<string, unknown>\n  const count = (value: unknown): number => {\n    const parsed = Number(value)\n    return Number.isFinite(parsed) && parsed > 0 ? Math.floor(parsed) : 0\n  }\n  const ms = (value: unknown): number | null =>\n    typeof value === 'number' && Number.isFinite(value) ? value : null\n  const clicks = count(data['clicks'])\n  const machineClicks = count(data['machineClicks'])\n  const links = Array.isArray(data['links'])\n    ? [...new Set(data['links'].filter((entry): entry is string => typeof entry === 'string' && entry !== ''))]\n    : []\n  return {\n    clicks,\n    firstClickAtMs: ms(data['firstClickAtMs']),\n    lastClickAtMs: ms(data['lastClickAtMs']),\n    lastClickUrl: typeof data['lastClickUrl'] === 'string' ? data['lastClickUrl'] : null,\n    machineClicks,\n    links: links.slice(0, OUTREACH_ENGAGEMENT_LINKS_MAX),\n    // Never more than the totals they are part of: a history row is written\n    // in the same transaction as the count it itemizes.\n    loggedClicks: Math.min(count(data['loggedClicks']), clicks),\n    loggedMachineClicks: Math.min(count(data['loggedMachineClicks']), machineClicks),\n  }\n}\n\n/**\n * What the enrollments table and the detail view say about one person's\n * clicks (AGL-3332), from the engagement alone.\n *\n * `linkCount` is the number of distinct destinations they followed when that\n * number is KNOWN, and `null` when it is not: a click from before the\n * per-click history kept only the last destination, so a person with two\n * such clicks followed one link or two, and neither is claimed.\n * `linksCapped` says the list stopped at {@link OUTREACH_ENGAGEMENT_LINKS_MAX}.\n */\nexport interface OutreachClickSummary {\n  clicks: number\n  machineClicks: number\n  /** Every destination known to have been followed: the history's, and the last one. */\n  followed: string[]\n  linkCount: number | null\n  linksCapped: boolean\n  /** Human clicks counted as totals only, with no row of their own. */\n  unloggedClicks: number\n  unloggedMachineClicks: number\n}\n\nexport function outreachClickSummary(raw: unknown): OutreachClickSummary {\n  const engagement = readOutreachEngagement(raw)\n  const followed = [...engagement.links]\n  if (engagement.lastClickUrl && !followed.includes(engagement.lastClickUrl)) followed.push(engagement.lastClickUrl)\n  const unloggedClicks = engagement.clicks - engagement.loggedClicks\n  const linksCapped = engagement.links.length >= OUTREACH_ENGAGEMENT_LINKS_MAX\n  // Exact when every human click has a row, or when there was only one.\n  const exact = unloggedClicks === 0 || (engagement.clicks === 1 && engagement.lastClickUrl !== null)\n  return {\n    clicks: engagement.clicks,\n    machineClicks: engagement.machineClicks,\n    followed,\n    linkCount: engagement.clicks === 0 ? 0 : exact ? followed.length : null,\n    linksCapped,\n    unloggedClicks,\n    unloggedMachineClicks: engagement.machineClicks - engagement.loggedMachineClicks,\n  }\n}\n\n/** The Clicks cell: \"2 · 1 link\", or the count alone when the links are not known. */\nexport function outreachClickCountLabel(summary: OutreachClickSummary): string {\n  if (!summary.clicks) return '—'\n  if (summary.linkCount === null) return String(summary.clicks)\n  const links = `${summary.linkCount}${summary.linksCapped ? '+' : ''}`\n  return `${summary.clicks} · ${links} ${summary.linkCount === 1 && !summary.linksCapped ? 'link' : 'links'}`\n}\n"],"names":["OUTREACH_ENGAGEMENT_LINKS_MAX","readOutreachEngagement","raw","data","count","value","parsed","Number","isFinite","Math","floor","ms","clicks","machineClicks","links","Array","isArray","Set","filter","entry","firstClickAtMs","lastClickAtMs","lastClickUrl","slice","loggedClicks","min","loggedMachineClicks","outreachClickSummary","engagement","followed","includes","push","unloggedClicks","linksCapped","length","exact","linkCount","unloggedMachineClicks","outreachClickCountLabel","summary","String"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,6BAA6B,QAA2C,sBAAkB;AAEnG;;;;;;;;;;;;CAYC,GACD,OAAO,SAASC,uBAAuBC,GAAY;IACjD,MAAMC,OAAQD,cAAAA,MAAO,CAAC;IACtB,MAAME,QAAQ,CAACC;QACb,MAAMC,SAASC,OAAOF;QACtB,OAAOE,OAAOC,QAAQ,CAACF,WAAWA,SAAS,IAAIG,KAAKC,KAAK,CAACJ,UAAU;IACtE;IACA,MAAMK,KAAK,CAACN,QACV,OAAOA,UAAU,YAAYE,OAAOC,QAAQ,CAACH,SAASA,QAAQ;IAChE,MAAMO,SAASR,MAAMD,IAAI,CAAC,SAAS;IACnC,MAAMU,gBAAgBT,MAAMD,IAAI,CAAC,gBAAgB;IACjD,MAAMW,QAAQC,MAAMC,OAAO,CAACb,IAAI,CAAC,QAAQ,IACrC;WAAI,IAAIc,IAAId,IAAI,CAAC,QAAQ,CAACe,MAAM,CAAC,CAACC,QAA2B,OAAOA,UAAU,YAAYA,UAAU;KAAK,GACzG,EAAE;IACN,OAAO;QACLP;QACAQ,gBAAgBT,GAAGR,IAAI,CAAC,iBAAiB;QACzCkB,eAAeV,GAAGR,IAAI,CAAC,gBAAgB;QACvCmB,cAAc,OAAOnB,IAAI,CAAC,eAAe,KAAK,WAAWA,IAAI,CAAC,eAAe,GAAG;QAChFU;QACAC,OAAOA,MAAMS,KAAK,CAAC,GAAGvB;QACtB,wEAAwE;QACxE,oDAAoD;QACpDwB,cAAcf,KAAKgB,GAAG,CAACrB,MAAMD,IAAI,CAAC,eAAe,GAAGS;QACpDc,qBAAqBjB,KAAKgB,GAAG,CAACrB,MAAMD,IAAI,CAAC,sBAAsB,GAAGU;IACpE;AACF;AAwBA,OAAO,SAASc,qBAAqBzB,GAAY;IAC/C,MAAM0B,aAAa3B,uBAAuBC;IAC1C,MAAM2B,WAAW;WAAID,WAAWd,KAAK;KAAC;IACtC,IAAIc,WAAWN,YAAY,IAAI,CAACO,SAASC,QAAQ,CAACF,WAAWN,YAAY,GAAGO,SAASE,IAAI,CAACH,WAAWN,YAAY;IACjH,MAAMU,iBAAiBJ,WAAWhB,MAAM,GAAGgB,WAAWJ,YAAY;IAClE,MAAMS,cAAcL,WAAWd,KAAK,CAACoB,MAAM,IAAIlC;IAC/C,sEAAsE;IACtE,MAAMmC,QAAQH,mBAAmB,KAAMJ,WAAWhB,MAAM,KAAK,KAAKgB,WAAWN,YAAY,KAAK;IAC9F,OAAO;QACLV,QAAQgB,WAAWhB,MAAM;QACzBC,eAAee,WAAWf,aAAa;QACvCgB;QACAO,WAAWR,WAAWhB,MAAM,KAAK,IAAI,IAAIuB,QAAQN,SAASK,MAAM,GAAG;QACnED;QACAD;QACAK,uBAAuBT,WAAWf,aAAa,GAAGe,WAAWF,mBAAmB;IAClF;AACF;AAEA,oFAAoF,GACpF,OAAO,SAASY,wBAAwBC,OAA6B;IACnE,IAAI,CAACA,QAAQ3B,MAAM,EAAE,OAAO;IAC5B,IAAI2B,QAAQH,SAAS,KAAK,MAAM,OAAOI,OAAOD,QAAQ3B,MAAM;IAC5D,MAAME,QAAQ,GAAGyB,QAAQH,SAAS,GAAGG,QAAQN,WAAW,GAAG,MAAM,IAAI;IACrE,OAAO,GAAGM,QAAQ3B,MAAM,CAAC,GAAG,EAAEE,MAAM,CAAC,EAAEyB,QAAQH,SAAS,KAAK,KAAK,CAACG,QAAQN,WAAW,GAAG,SAAS,SAAS;AAC7G"}

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

@@ -0,0 +1,40 @@
+/**
+ * @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 { OutreachEnrollmentHistoryEntry, OutreachHistoryAction } from './outreach.types';
+/** A click row as the click route writes it. */
+export declare function outreachClickHistoryRow(input: {
+    atMs: number;
+    url: string | null;
+    stepIndex: number;
+    human: boolean;
+    machineReason: OutreachClickMachineReason | null;
+}): Record<string, unknown>;
+/** A member's act as the action route writes it. */
+export declare function outreachActionHistoryRow(input: {
+    atMs: number;
+    action: OutreachHistoryAction;
+    byUid: string;
+    detail: string | null;
+}): Record<string, unknown>;
+/**
+ * A row id that sorts by time and cannot collide: two clicks in the same
+ * millisecond — a scanner fetching every link at once — are two rows.
+ */
+export declare function outreachHistoryEntryId(atMs: number, random?: () => number): string;
+/** A stored history row in its model shape, or `null` for one nothing can be said about. */
+export declare function readOutreachHistoryEntry(id: string, data: Record<string, unknown> | undefined): OutreachEnrollmentHistoryEntry | null;

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

@@ -0,0 +1,95 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * ONE ROW OF AN ENROLLMENT'S HISTORY (AGL-3332), as stored and as read back.
+ *
+ * Client-safe, beside the other readers, because the click route and the
+ * member-action route write these rows on the server and the detail view
+ * reads them in the browser, and both must agree on the shape. Read a field
+ * at a time: a row that names no time, or no kind this model knows, is
+ * dropped rather than shown as something that happened.
+ */ const MACHINE_REASONS = [
+    'agent',
+    'too_soon',
+    'method'
+];
+const ACTIONS = [
+    'pause',
+    'resume',
+    'stop',
+    'do_not_contact'
+];
+/** A click row as the click route writes it. */ export function outreachClickHistoryRow(input) {
+    return {
+        kind: 'click',
+        atMs: input.atMs,
+        url: input.url,
+        stepIndex: input.stepIndex,
+        human: input.human,
+        machineReason: input.human ? null : input.machineReason
+    };
+}
+/** A member's act as the action route writes it. */ export function outreachActionHistoryRow(input) {
+    const detail = typeof input.detail === 'string' ? input.detail.replace(/\s+/g, ' ').trim().slice(0, 500) : '';
+    return {
+        kind: 'action',
+        atMs: input.atMs,
+        action: input.action,
+        byUid: input.byUid,
+        detail: detail || null
+    };
+}
+/**
+ * A row id that sorts by time and cannot collide: two clicks in the same
+ * millisecond — a scanner fetching every link at once — are two rows.
+ */ export function outreachHistoryEntryId(atMs, random = Math.random) {
+    const suffix = Math.floor(random() * 36 ** 6).toString(36).padStart(6, '0');
+    return `${String(Math.max(0, Math.floor(atMs))).padStart(15, '0')}-${suffix}`;
+}
+/** A stored history row in its model shape, or `null` for one nothing can be said about. */ export function readOutreachHistoryEntry(id, data) {
+    if (!data) return null;
+    const atMs = data['atMs'];
+    if (typeof atMs !== 'number' || !Number.isFinite(atMs)) return null;
+    if (data['kind'] === 'click') {
+        const stepIndex = Number(data['stepIndex']);
+        const human = data['human'] === true;
+        const reason = data['machineReason'];
+        return {
+            id,
+            kind: 'click',
+            atMs,
+            url: typeof data['url'] === 'string' && data['url'] ? data['url'] : null,
+            stepIndex: Number.isInteger(stepIndex) && stepIndex >= 0 ? stepIndex : 0,
+            human,
+            machineReason: human ? null : MACHINE_REASONS.includes(reason) ? reason : null
+        };
+    }
+    if (data['kind'] === 'action') {
+        const action = data['action'];
+        if (!ACTIONS.includes(action)) return null;
+        return {
+            id,
+            kind: 'action',
+            atMs,
+            action: action,
+            byUid: typeof data['byUid'] === 'string' ? data['byUid'] : '',
+            detail: typeof data['detail'] === 'string' && data['detail'] ? data['detail'] : null
+        };
+    }
+    return null;
+}
+
+//# sourceMappingURL=enrollment-history.js.map

package/src/lib/model/enrollment-history.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/outreach/src/lib/model/enrollment-history.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 { OutreachClickMachineReason } from '../engine/click-tracking'\nimport type {\n  OutreachEnrollmentHistoryEntry,\n  OutreachHistoryAction,\n} from './outreach.types'\n\n/**\n * ONE ROW OF AN ENROLLMENT'S HISTORY (AGL-3332), as stored and as read back.\n *\n * Client-safe, beside the other readers, because the click route and the\n * member-action route write these rows on the server and the detail view\n * reads them in the browser, and both must agree on the shape. Read a field\n * at a time: a row that names no time, or no kind this model knows, is\n * dropped rather than shown as something that happened.\n */\n\nconst MACHINE_REASONS: readonly OutreachClickMachineReason[] = ['agent', 'too_soon', 'method']\nconst ACTIONS: readonly OutreachHistoryAction[] = ['pause', 'resume', 'stop', 'do_not_contact']\n\n/** A click row as the click route writes it. */\nexport function outreachClickHistoryRow(input: {\n  atMs: number\n  url: string | null\n  stepIndex: number\n  human: boolean\n  machineReason: OutreachClickMachineReason | null\n}): Record<string, unknown> {\n  return {\n    kind: 'click',\n    atMs: input.atMs,\n    url: input.url,\n    stepIndex: input.stepIndex,\n    human: input.human,\n    machineReason: input.human ? null : input.machineReason,\n  }\n}\n\n/** A member's act as the action route writes it. */\nexport function outreachActionHistoryRow(input: {\n  atMs: number\n  action: OutreachHistoryAction\n  byUid: string\n  detail: string | null\n}): Record<string, unknown> {\n  const detail = typeof input.detail === 'string' ? input.detail.replace(/\\s+/g, ' ').trim().slice(0, 500) : ''\n  return {\n    kind: 'action',\n    atMs: input.atMs,\n    action: input.action,\n    byUid: input.byUid,\n    detail: detail || null,\n  }\n}\n\n/**\n * A row id that sorts by time and cannot collide: two clicks in the same\n * millisecond — a scanner fetching every link at once — are two rows.\n */\nexport function outreachHistoryEntryId(atMs: number, random: () => number = Math.random): string {\n  const suffix = Math.floor(random() * 36 ** 6)\n    .toString(36)\n    .padStart(6, '0')\n  return `${String(Math.max(0, Math.floor(atMs))).padStart(15, '0')}-${suffix}`\n}\n\n/** A stored history row in its model shape, or `null` for one nothing can be said about. */\nexport function readOutreachHistoryEntry(\n  id: string,\n  data: Record<string, unknown> | undefined,\n): OutreachEnrollmentHistoryEntry | null {\n  if (!data) return null\n  const atMs = data['atMs']\n  if (typeof atMs !== 'number' || !Number.isFinite(atMs)) return null\n  if (data['kind'] === 'click') {\n    const stepIndex = Number(data['stepIndex'])\n    const human = data['human'] === true\n    const reason = data['machineReason']\n    return {\n      id,\n      kind: 'click',\n      atMs,\n      url: typeof data['url'] === 'string' && data['url'] ? data['url'] : null,\n      stepIndex: Number.isInteger(stepIndex) && stepIndex >= 0 ? stepIndex : 0,\n      human,\n      machineReason: human\n        ? null\n        : (MACHINE_REASONS as readonly unknown[]).includes(reason)\n          ? (reason as OutreachClickMachineReason)\n          : null,\n    }\n  }\n  if (data['kind'] === 'action') {\n    const action = data['action']\n    if (!(ACTIONS as readonly unknown[]).includes(action)) return null\n    return {\n      id,\n      kind: 'action',\n      atMs,\n      action: action as OutreachHistoryAction,\n      byUid: typeof data['byUid'] === 'string' ? data['byUid'] : '',\n      detail: typeof data['detail'] === 'string' && data['detail'] ? data['detail'] : null,\n    }\n  }\n  return null\n}\n"],"names":["MACHINE_REASONS","ACTIONS","outreachClickHistoryRow","input","kind","atMs","url","stepIndex","human","machineReason","outreachActionHistoryRow","detail","replace","trim","slice","action","byUid","outreachHistoryEntryId","random","Math","suffix","floor","toString","padStart","String","max","readOutreachHistoryEntry","id","data","Number","isFinite","reason","isInteger","includes"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAQD;;;;;;;;CAQC,GAED,MAAMA,kBAAyD;IAAC;IAAS;IAAY;CAAS;AAC9F,MAAMC,UAA4C;IAAC;IAAS;IAAU;IAAQ;CAAiB;AAE/F,8CAA8C,GAC9C,OAAO,SAASC,wBAAwBC,KAMvC;IACC,OAAO;QACLC,MAAM;QACNC,MAAMF,MAAME,IAAI;QAChBC,KAAKH,MAAMG,GAAG;QACdC,WAAWJ,MAAMI,SAAS;QAC1BC,OAAOL,MAAMK,KAAK;QAClBC,eAAeN,MAAMK,KAAK,GAAG,OAAOL,MAAMM,aAAa;IACzD;AACF;AAEA,kDAAkD,GAClD,OAAO,SAASC,yBAAyBP,KAKxC;IACC,MAAMQ,SAAS,OAAOR,MAAMQ,MAAM,KAAK,WAAWR,MAAMQ,MAAM,CAACC,OAAO,CAAC,QAAQ,KAAKC,IAAI,GAAGC,KAAK,CAAC,GAAG,OAAO;IAC3G,OAAO;QACLV,MAAM;QACNC,MAAMF,MAAME,IAAI;QAChBU,QAAQZ,MAAMY,MAAM;QACpBC,OAAOb,MAAMa,KAAK;QAClBL,QAAQA,UAAU;IACpB;AACF;AAEA;;;CAGC,GACD,OAAO,SAASM,uBAAuBZ,IAAY,EAAEa,SAAuBC,KAAKD,MAAM;IACrF,MAAME,SAASD,KAAKE,KAAK,CAACH,WAAW,MAAM,GACxCI,QAAQ,CAAC,IACTC,QAAQ,CAAC,GAAG;IACf,OAAO,GAAGC,OAAOL,KAAKM,GAAG,CAAC,GAAGN,KAAKE,KAAK,CAAChB,QAAQkB,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAEH,QAAQ;AAC/E;AAEA,0FAA0F,GAC1F,OAAO,SAASM,yBACdC,EAAU,EACVC,IAAyC;IAEzC,IAAI,CAACA,MAAM,OAAO;IAClB,MAAMvB,OAAOuB,IAAI,CAAC,OAAO;IACzB,IAAI,OAAOvB,SAAS,YAAY,CAACwB,OAAOC,QAAQ,CAACzB,OAAO,OAAO;IAC/D,IAAIuB,IAAI,CAAC,OAAO,KAAK,SAAS;QAC5B,MAAMrB,YAAYsB,OAAOD,IAAI,CAAC,YAAY;QAC1C,MAAMpB,QAAQoB,IAAI,CAAC,QAAQ,KAAK;QAChC,MAAMG,SAASH,IAAI,CAAC,gBAAgB;QACpC,OAAO;YACLD;YACAvB,MAAM;YACNC;YACAC,KAAK,OAAOsB,IAAI,CAAC,MAAM,KAAK,YAAYA,IAAI,CAAC,MAAM,GAAGA,IAAI,CAAC,MAAM,GAAG;YACpErB,WAAWsB,OAAOG,SAAS,CAACzB,cAAcA,aAAa,IAAIA,YAAY;YACvEC;YACAC,eAAeD,QACX,OACA,AAACR,gBAAuCiC,QAAQ,CAACF,UAC9CA,SACD;QACR;IACF;IACA,IAAIH,IAAI,CAAC,OAAO,KAAK,UAAU;QAC7B,MAAMb,SAASa,IAAI,CAAC,SAAS;QAC7B,IAAI,CAAC,AAAC3B,QAA+BgC,QAAQ,CAAClB,SAAS,OAAO;QAC9D,OAAO;YACLY;YACAvB,MAAM;YACNC;YACAU,QAAQA;YACRC,OAAO,OAAOY,IAAI,CAAC,QAAQ,KAAK,WAAWA,IAAI,CAAC,QAAQ,GAAG;YAC3DjB,QAAQ,OAAOiB,IAAI,CAAC,SAAS,KAAK,YAAYA,IAAI,CAAC,SAAS,GAAGA,IAAI,CAAC,SAAS,GAAG;QAClF;IACF;IACA,OAAO;AACT"}

package/src/lib/model/enrollment-list-query.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @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 { ListQueryDeclaration, ListQueryFilter } from '@aglyn/shared-ui-jsx/const/list-query-plan';
+/** The array the search box reads, stamped by the enroll route. */
+export declare const OUTREACH_ENROLLMENT_SEARCH_TOKENS = "searchTokens";
+/** Whether the person clicked (AGL-3332): what the "Clicked" filter asks. */
+export declare const OUTREACH_ENROLLMENT_CLICKED = "clicked";
+/** The destinations followed (AGL-3332): what the "Link followed" filter asks. */
+export declare const OUTREACH_ENROLLMENT_LINKS_PATH = "engagement.links";
+/** The fields the table offers only for a sequence that counts clicks. */
+export declare const OUTREACH_ENROLLMENT_CLICK_FIELDS: readonly ["clicked", "link"];
+export declare const OUTREACH_ENROLLMENT_LIST_QUERY: ListQueryDeclaration;
+/** The scope every page of the table carries: this sequence's people. */
+export declare function outreachEnrollmentListBase(sequenceId: string): ListQueryFilter[];

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

@@ -0,0 +1,151 @@
+/**
+ * @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.
+ */ /*
+ * WHAT A SEQUENCE'S ENROLLMENTS TABLE ASKS FIRESTORE (AGL-3321).
+ *
+ * One query over `orgs/{orgId}/outreachEnrollments`, narrowed to the
+ * sequence (`sequenceId ==`, the list's base) and ordered newest enrolled
+ * first, paged by that query. Every clause the Filters panel offers and the
+ * search box are predicates on it:
+ *
+ *   status      the stored status, on every enrollment;
+ *   target      `contact` or `lead`, on every enrollment (the ones made
+ *               before leads could be sequenced gain `contact` from the
+ *               backfill);
+ *   stopReason  the stored reason code — the column shows its label and the
+ *               stop detail, the query asks by code;
+ *   email       the whole address, stored normalized, so `equals` is exact;
+ *   enrolled    the table's ONE range: when the person was enrolled, the
+ *               field the table is already ordered by, so it costs no index
+ *               of its own;
+ *   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;
+ *   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: [
+        {
+            column: 'status',
+            kind: 'exact',
+            path: 'status',
+            presence: 'always',
+            operators: [
+                'equals',
+                'isAnyOf'
+            ]
+        },
+        {
+            column: 'target',
+            kind: 'exact',
+            path: 'target',
+            presence: 'always',
+            operators: [
+                'equals'
+            ]
+        },
+        {
+            column: 'stopReason',
+            kind: 'exact',
+            path: 'stopReason',
+            operators: [
+                'equals',
+                'isAnyOf'
+            ]
+        },
+        {
+            column: 'email',
+            kind: 'text',
+            path: 'email',
+            lowerPath: 'email',
+            operators: [
+                'equals'
+            ]
+        },
+        {
+            column: 'enrolled',
+            kind: 'date',
+            path: 'createdAtMs',
+            storedAs: 'millis',
+            presence: 'always',
+            operators: [
+                'is',
+                'after',
+                'onOrAfter',
+                '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: [
+        {
+            path: 'createdAtMs',
+            direction: 'desc'
+        }
+    ],
+    search: {
+        tokensPath: OUTREACH_ENROLLMENT_SEARCH_TOKENS
+    }
+};
+/** The scope every page of the table carries: this sequence's people. */ export function outreachEnrollmentListBase(sequenceId) {
+    return [
+        {
+            path: 'sequenceId',
+            op: '==',
+            value: sequenceId
+        }
+    ];
+}
+
+//# sourceMappingURL=enrollment-list-query.js.map

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

@@ -0,0 +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 *   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;