@aglyn/plugins-marketing 1.0.0-beta.221 → 1.0.0-beta.223

package/src/lib/model/campaign-visits.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @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.
+ */
+/**
+ * WHO A CAMPAIGN REACHED ON THE SITE (AGL-3461) — first visits and views of
+ * the pages filed under it.
+ *
+ * ## One document per campaign, keyed by the campaign's id
+ *
+ * `orgs/{orgId}/campaignVisitReports/{campaignId}`, beside the sequence
+ * rollup and on the same footing: counts, never a person, written only on the
+ * Admin SDK by the site collector's `campaignVisit` beacon, readable by
+ * whoever may open the campaign. Keyed by the campaign DOCUMENT, so the
+ * collection is bounded by the campaigns that exist — never by a label or a
+ * path a visitor's URL could mint.
+ *
+ * ## What each figure counts
+ *
+ *  - **Page views** — views of the pages filed under the campaign, one per
+ *    pageview, whoever the visitor is. It needs nothing from the visitor's
+ *    device, so every view counts.
+ *  - **First visits** — visitors whose first campaign touch in the
+ *    attribution window was this campaign: a page filed under it, or a link
+ *    carrying a `utm_campaign` label it declares. The device answers from the
+ *    touch it already remembers (`claimFirstCampaignTouch` in
+ *    `utm-touch.ts`): one held from the last seven days means this visit is
+ *    not a first. A visitor whose consent posture keeps nothing on their
+ *    device cannot be told from the next one and is not counted at all, so
+ *    the figure is a floor, and the page says so.
+ *
+ * Both are also kept per month, under `byMonth`, so a campaign with dates can
+ * be read for its own window. Twelve keys a year is the bound.
+ */
+/** The org collection the rollups live in. */
+export declare const CAMPAIGN_VISIT_REPORTS_COLLECTION = "campaignVisitReports";
+/** One month's figures, under `byMonth['YYYY-MM']`. */
+export interface CampaignVisitMonth {
+    views?: number;
+    firstVisits?: number;
+}
+/** The stored shape of `orgs/{orgId}/campaignVisitReports/{campaignId}`. */
+export interface CampaignVisitRollup {
+    views?: number;
+    firstVisits?: number;
+    byMonth?: Record<string, CampaignVisitMonth>;
+}
+/** What the campaign's page draws. */
+export interface CampaignVisitsReport {
+    /** Whether anything has been counted at all. */
+    recorded: boolean;
+    views: number;
+    firstVisits: number;
+    /** The first month anything was counted, `YYYY-MM`, or `''`. */
+    since: string;
+}
+/**
+ * The rollup as the page reads it. `since` is the earliest month on record,
+ * so the figures say how far back they reach: they start when counting
+ * started, not when the campaign did.
+ */
+export declare function campaignVisitsReport(rollup: CampaignVisitRollup | null | undefined): CampaignVisitsReport;

package/src/lib/model/campaign-visits.js

@@ -0,0 +1,65 @@
+/**
+ * @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.
+ */ /**
+ * WHO A CAMPAIGN REACHED ON THE SITE (AGL-3461) — first visits and views of
+ * the pages filed under it.
+ *
+ * ## One document per campaign, keyed by the campaign's id
+ *
+ * `orgs/{orgId}/campaignVisitReports/{campaignId}`, beside the sequence
+ * rollup and on the same footing: counts, never a person, written only on the
+ * Admin SDK by the site collector's `campaignVisit` beacon, readable by
+ * whoever may open the campaign. Keyed by the campaign DOCUMENT, so the
+ * collection is bounded by the campaigns that exist — never by a label or a
+ * path a visitor's URL could mint.
+ *
+ * ## What each figure counts
+ *
+ *  - **Page views** — views of the pages filed under the campaign, one per
+ *    pageview, whoever the visitor is. It needs nothing from the visitor's
+ *    device, so every view counts.
+ *  - **First visits** — visitors whose first campaign touch in the
+ *    attribution window was this campaign: a page filed under it, or a link
+ *    carrying a `utm_campaign` label it declares. The device answers from the
+ *    touch it already remembers (`claimFirstCampaignTouch` in
+ *    `utm-touch.ts`): one held from the last seven days means this visit is
+ *    not a first. A visitor whose consent posture keeps nothing on their
+ *    device cannot be told from the next one and is not counted at all, so
+ *    the figure is a floor, and the page says so.
+ *
+ * Both are also kept per month, under `byMonth`, so a campaign with dates can
+ * be read for its own window. Twelve keys a year is the bound.
+ */ /** The org collection the rollups live in. */ export const CAMPAIGN_VISIT_REPORTS_COLLECTION = 'campaignVisitReports';
+function count(raw) {
+    const value = Math.floor(Number(raw != null ? raw : 0));
+    return Number.isFinite(value) && value > 0 ? value : 0;
+}
+/**
+ * The rollup as the page reads it. `since` is the earliest month on record,
+ * so the figures say how far back they reach: they start when counting
+ * started, not when the campaign did.
+ */ export function campaignVisitsReport(rollup) {
+    var _ref, _months_;
+    const months = Object.keys((_ref = rollup == null ? void 0 : rollup.byMonth) != null ? _ref : {}).filter((month)=>/^\d{4}-\d{2}$/.test(month)).sort();
+    return {
+        recorded: Boolean(rollup),
+        views: count(rollup == null ? void 0 : rollup.views),
+        firstVisits: count(rollup == null ? void 0 : rollup.firstVisits),
+        since: (_months_ = months[0]) != null ? _months_ : ''
+    };
+}
+
+//# sourceMappingURL=campaign-visits.js.map

package/src/lib/model/campaign-visits.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/model/campaign-visits.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\n/**\n * WHO A CAMPAIGN REACHED ON THE SITE (AGL-3461) — first visits and views of\n * the pages filed under it.\n *\n * ## One document per campaign, keyed by the campaign's id\n *\n * `orgs/{orgId}/campaignVisitReports/{campaignId}`, beside the sequence\n * rollup and on the same footing: counts, never a person, written only on the\n * Admin SDK by the site collector's `campaignVisit` beacon, readable by\n * whoever may open the campaign. Keyed by the campaign DOCUMENT, so the\n * collection is bounded by the campaigns that exist — never by a label or a\n * path a visitor's URL could mint.\n *\n * ## What each figure counts\n *\n *  - **Page views** — views of the pages filed under the campaign, one per\n *    pageview, whoever the visitor is. It needs nothing from the visitor's\n *    device, so every view counts.\n *  - **First visits** — visitors whose first campaign touch in the\n *    attribution window was this campaign: a page filed under it, or a link\n *    carrying a `utm_campaign` label it declares. The device answers from the\n *    touch it already remembers (`claimFirstCampaignTouch` in\n *    `utm-touch.ts`): one held from the last seven days means this visit is\n *    not a first. A visitor whose consent posture keeps nothing on their\n *    device cannot be told from the next one and is not counted at all, so\n *    the figure is a floor, and the page says so.\n *\n * Both are also kept per month, under `byMonth`, so a campaign with dates can\n * be read for its own window. Twelve keys a year is the bound.\n */\n\n/** The org collection the rollups live in. */\nexport const CAMPAIGN_VISIT_REPORTS_COLLECTION = 'campaignVisitReports'\n\n/** One month's figures, under `byMonth['YYYY-MM']`. */\nexport interface CampaignVisitMonth {\n  views?: number\n  firstVisits?: number\n}\n\n/** The stored shape of `orgs/{orgId}/campaignVisitReports/{campaignId}`. */\nexport interface CampaignVisitRollup {\n  views?: number\n  firstVisits?: number\n  byMonth?: Record<string, CampaignVisitMonth>\n}\n\n/** What the campaign's page draws. */\nexport interface CampaignVisitsReport {\n  /** Whether anything has been counted at all. */\n  recorded: boolean\n  views: number\n  firstVisits: number\n  /** The first month anything was counted, `YYYY-MM`, or `''`. */\n  since: string\n}\n\nfunction count(raw: unknown): number {\n  const value = Math.floor(Number(raw ?? 0))\n  return Number.isFinite(value) && value > 0 ? value : 0\n}\n\n/**\n * The rollup as the page reads it. `since` is the earliest month on record,\n * so the figures say how far back they reach: they start when counting\n * started, not when the campaign did.\n */\nexport function campaignVisitsReport(\n  rollup: CampaignVisitRollup | null | undefined,\n): CampaignVisitsReport {\n  const months = Object.keys(rollup?.byMonth ?? {})\n    .filter((month) => /^\\d{4}-\\d{2}$/.test(month))\n    .sort()\n  return {\n    recorded: Boolean(rollup),\n    views: count(rollup?.views),\n    firstVisits: count(rollup?.firstVisits),\n    since: months[0] ?? '',\n  }\n}\n"],"names":["CAMPAIGN_VISIT_REPORTS_COLLECTION","count","raw","value","Math","floor","Number","isFinite","campaignVisitsReport","rollup","months","Object","keys","byMonth","filter","month","test","sort","recorded","Boolean","views","firstVisits","since"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BC,GAED,4CAA4C,GAC5C,OAAO,MAAMA,oCAAoC,uBAAsB;AAyBvE,SAASC,MAAMC,GAAY;IACzB,MAAMC,QAAQC,KAAKC,KAAK,CAACC,OAAOJ,cAAAA,MAAO;IACvC,OAAOI,OAAOC,QAAQ,CAACJ,UAAUA,QAAQ,IAAIA,QAAQ;AACvD;AAEA;;;;CAIC,GACD,OAAO,SAASK,qBACdC,MAA8C;cASrCC;IAPT,MAAMA,SAASC,OAAOC,IAAI,SAACH,0BAAAA,OAAQI,OAAO,mBAAI,CAAC,GAC5CC,MAAM,CAAC,CAACC,QAAU,gBAAgBC,IAAI,CAACD,QACvCE,IAAI;IACP,OAAO;QACLC,UAAUC,QAAQV;QAClBW,OAAOnB,MAAMQ,0BAAAA,OAAQW,KAAK;QAC1BC,aAAapB,MAAMQ,0BAAAA,OAAQY,WAAW;QACtCC,KAAK,GAAEZ,WAAAA,MAAM,CAAC,EAAE,YAATA,WAAa;IACtB;AACF"}

package/src/lib/model/compile-client-automations.d.ts

@@ -14,12 +14,12 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { type HostAction } from '@aglyn/aglyn/app-utils/actions';
+import { type InteractionStepBase, type SiteInteraction } from '@aglyn/aglyn/app-utils/site-interactions';
 import type { ClientAutomation } from './site-contract';
 /** A raw `hosts/{hostId}/actions` doc paired with its id. */
 export interface RawHostAction {
     id: string;
-    action: HostAction;
+    action: SiteInteraction<InteractionStepBase>;
 }
 export interface CompileClientAutomationsOptions {
     /** Leading-slash page path for pathPattern targeting. */

package/src/lib/model/compile-client-automations.js

@@ -14,11 +14,11 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  * 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 the entitlement/event predicates from the context-free actions
+ */ // Import the entitlement/event predicates from the context-free interactions
 // subpath, NOT the `@aglyn/aglyn` barrel: this file is in the marketing model,
 // which the plugin's SERVER graph re-exports, and the full barrel pulls client
 // React contexts (createContext) that break the RSC server build (AGL-830).
-import { hostActionStepsForClient, isClientActionStep, isClientStepEntitled, isSiteEventType } from "@aglyn/aglyn/app-utils/actions";
+import { interactionStepsForClient, isClientActionStep, isClientStepEntitled, isSiteEventType } from "@aglyn/aglyn/app-utils/site-interactions";
 import { overlayMatchesPath } from "./overlays.js";
 /**
  * Pure action→client-automation mapping (AGL-256/577, extracted AGL-830):
@@ -55,7 +55,7 @@ import { overlayMatchesPath } from "./overlays.js";
      * delay would look correct on the server, and the two halves of one
      * authored flow would disagree about when they happened. Everything past
      * the first wait belongs to a run the job beat has not started yet.
-     */ const reachableSteps = hostActionStepsForClient(action.steps);
+     */ const reachableSteps = interactionStepsForClient(action.steps);
         // Step-level entitlement tiering (AGL-577): basic presentational steps
         // load on every plan; advanced client steps need `actions` and runJs
         // needs `webhooks` — see isClientStepEntitled.

package/src/lib/model/compile-client-automations.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/model/compile-client-automations.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// Import the entitlement/event predicates from the context-free actions\n// subpath, NOT the `@aglyn/aglyn` barrel: this file is in the marketing model,\n// which the plugin's SERVER graph re-exports, and the full barrel pulls client\n// React contexts (createContext) that break the RSC server build (AGL-830).\nimport {\n  hostActionStepsForClient,\n  isClientActionStep,\n  isClientStepEntitled,\n  isSiteEventType,\n  type HostAction,\n} from '@aglyn/aglyn/app-utils/actions'\nimport { overlayMatchesPath } from './overlays'\nimport type { ClientAutomation } from './site-contract'\n\n/** A raw `hosts/{hostId}/actions` doc paired with its id. */\nexport interface RawHostAction {\n  id: string\n  action: HostAction\n}\n\nexport interface CompileClientAutomationsOptions {\n  /** Leading-slash page path for pathPattern targeting. */\n  path: string\n  /**\n   * `actions` entitlement (AGL-577). Basic presentational steps\n   * (menu/drawer/show-hide/class/nav/alert) always load; advanced client\n   * steps (overlay/showHtml/analytics) and server steps drop when false.\n   */\n  actionsEntitled: boolean\n  /** Business-tier gate for `runJs` steps (dropped when false). */\n  allowJs: boolean\n  /**\n   * Ignore each action's `pathPattern` (AGL-830). The besigner Preview shows\n   * a single composed screen and scopes relevance by selector match, so it\n   * skips path filtering rather than resolve the composed path.\n   */\n  matchAllPaths?: boolean\n  /**\n   * Drop every automation that names a `pathPattern` (AGL-2511), for a\n   * surface whose own path is unknown — the designed 404 body, served from a\n   * per-host cache that no request path belongs to.\n   *\n   * The opposite of `matchAllPaths` and deliberately so: Preview knows the\n   * page and only lacks its composed address, so it keeps path-scoped\n   * automations; this caller cannot know the page at all, and running an\n   * automation scoped to `/pricing` on whatever URL 404'd would be a guess\n   * with a side effect. Interactions authored on nodes carry no pattern, so\n   * a nav's hover choreography — the reason this surface is enriched — is\n   * unaffected.\n   */\n  dropPathScoped?: boolean\n}\n\n/**\n * Pure action→client-automation mapping (AGL-256/577, extracted AGL-830):\n * the single place the trigger config + entitlement-trimmed client steps are\n * shaped. Both the server page-enricher (admin fetch) and the editor Preview\n * (client fetch) feed their loaded action docs through this, so live and\n * preview stay byte-for-byte consistent. No I/O, no firebase — safe on the\n * client. Malformed entries are skipped, never thrown.\n */\nexport function compileClientAutomations(\n  actions: RawHostAction[],\n  options: CompileClientAutomationsOptions,\n): ClientAutomation[] {\n  const automations: ClientAutomation[] = []\n  for (const { id, action } of actions) {\n    if (\n      (action as { deletedAt?: unknown }).deletedAt ||\n      action.enabled === false\n    ) {\n      continue\n    }\n    const event = String(action.trigger?.event ?? '')\n    if (!isSiteEventType(event)) continue\n    const pathPattern = action.trigger?.pathPattern?.trim()\n    if (pathPattern && options.dropPathScoped) continue\n    if (\n      !options.matchAllPaths &&\n      pathPattern &&\n      !overlayMatchesPath({ pathPatterns: [pathPattern] }, options.path)\n    ) {\n      continue\n    }\n    /*\n     * TRUNCATED AT THE FIRST WAIT, before anything else is decided.\n     *\n     * The browser runs its slice of the list the moment the trigger fires, so\n     * a client step sitting after a `wait` would execute at once — the popup\n     * an author scheduled for three days later would appear immediately, the\n     * delay would look correct on the server, and the two halves of one\n     * authored flow would disagree about when they happened. Everything past\n     * the first wait belongs to a run the job beat has not started yet.\n     */\n    const reachableSteps = hostActionStepsForClient(action.steps)\n    // Step-level entitlement tiering (AGL-577): basic presentational steps\n    // load on every plan; advanced client steps need `actions` and runJs\n    // needs `webhooks` — see isClientStepEntitled.\n    const clientSteps = reachableSteps.filter((step) =>\n      isClientStepEntitled(step, {\n        actionsEntitled: options.actionsEntitled,\n        allowJs: options.allowJs,\n      }),\n    )\n    // Server steps only dispatch (and are only re-authorized) when the org is\n    // actions-entitled — never advertise them otherwise, so basic-tier pages\n    // don't POST to /api/events/dispatch for a no-op.\n    const hasServerSteps =\n      options.actionsEntitled &&\n      (action.steps ?? []).some((step) => !isClientActionStep(step))\n    if (!clientSteps.length && !hasServerSteps) continue\n    automations.push({\n      id,\n      event,\n      ...(action.trigger?.selector\n        ? { selector: action.trigger.selector }\n        : {}),\n      ...(Number(action.trigger?.threshold) > 0\n        ? { threshold: Number(action.trigger.threshold) }\n        : {}),\n      ...(action.trigger?.oncePerVisitor === true\n        ? { oncePerVisitor: true }\n        : {}),\n      ...(action.trigger?.oncePerSession === true\n        ? { oncePerSession: true }\n        : {}),\n      ...(Number(action.trigger?.cooldownMinutes) >= 1\n        ? { cooldownMinutes: Number(action.trigger?.cooldownMinutes) }\n        : {}),\n      // Repeatable UI choreography (AGL-562): menu/drawer interactions fire on\n      // every occurrence instead of once per pageview.\n      ...(action.trigger?.everyTime === true ? { everyTime: true } : {}),\n      steps: clientSteps,\n      hasServerSteps,\n    })\n  }\n  return automations\n}\n\nexport default compileClientAutomations\n"],"names":["hostActionStepsForClient","isClientActionStep","isClientStepEntitled","isSiteEventType","overlayMatchesPath","compileClientAutomations","actions","options","automations","id","action","deletedAt","enabled","event","String","trigger","pathPattern","trim","dropPathScoped","matchAllPaths","pathPatterns","path","reachableSteps","steps","clientSteps","filter","step","actionsEntitled","allowJs","hasServerSteps","some","length","push","selector","Number","threshold","oncePerVisitor","oncePerSession","cooldownMinutes","everyTime"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,wEAAwE;AACxE,+EAA+E;AAC/E,+EAA+E;AAC/E,4EAA4E;AAC5E,SACEA,wBAAwB,EACxBC,kBAAkB,EAClBC,oBAAoB,EACpBC,eAAe,QAEV,iCAAgC;AACvC,SAASC,kBAAkB,QAAQ,gBAAY;AA0C/C;;;;;;;CAOC,GACD,OAAO,SAASC,yBACdC,OAAwB,EACxBC,OAAwC;IAExC,MAAMC,cAAkC,EAAE;IAC1C,KAAK,MAAM,EAAEC,EAAE,EAAEC,MAAM,EAAE,IAAIJ,QAAS;kBA2CjCI;YApCkBA,iBAEDA,6BAAAA,kBAuCdA,kBAGOA,kBAGPA,kBAGAA,kBAGOA,kBACmBA,kBAI1BA;QAhEN,IACE,AAACA,OAAmCC,SAAS,IAC7CD,OAAOE,OAAO,KAAK,OACnB;YACA;QACF;QACA,MAAMC,QAAQC,gBAAOJ,kBAAAA,OAAOK,OAAO,qBAAdL,gBAAgBG,KAAK,mBAAI;QAC9C,IAAI,CAACV,gBAAgBU,QAAQ;QAC7B,MAAMG,eAAcN,mBAAAA,OAAOK,OAAO,sBAAdL,8BAAAA,iBAAgBM,WAAW,qBAA3BN,4BAA6BO,IAAI;QACrD,IAAID,eAAeT,QAAQW,cAAc,EAAE;QAC3C,IACE,CAACX,QAAQY,aAAa,IACtBH,eACA,CAACZ,mBAAmB;YAAEgB,cAAc;gBAACJ;aAAY;QAAC,GAAGT,QAAQc,IAAI,GACjE;YACA;QACF;QACA;;;;;;;;;KASC,GACD,MAAMC,iBAAiBtB,yBAAyBU,OAAOa,KAAK;QAC5D,uEAAuE;QACvE,qEAAqE;QACrE,+CAA+C;QAC/C,MAAMC,cAAcF,eAAeG,MAAM,CAAC,CAACC,OACzCxB,qBAAqBwB,MAAM;gBACzBC,iBAAiBpB,QAAQoB,eAAe;gBACxCC,SAASrB,QAAQqB,OAAO;YAC1B;QAEF,0EAA0E;QAC1E,yEAAyE;QACzE,kDAAkD;QAClD,MAAMC,iBACJtB,QAAQoB,eAAe,IACvB,EAACjB,gBAAAA,OAAOa,KAAK,YAAZb,gBAAgB,EAAE,EAAEoB,IAAI,CAAC,CAACJ,OAAS,CAACzB,mBAAmByB;QAC1D,IAAI,CAACF,YAAYO,MAAM,IAAI,CAACF,gBAAgB;QAC5CrB,YAAYwB,IAAI,CAAC;YACfvB;YACAI;WACIH,EAAAA,mBAAAA,OAAOK,OAAO,qBAAdL,iBAAgBuB,QAAQ,IACxB;YAAEA,UAAUvB,OAAOK,OAAO,CAACkB,QAAQ;QAAC,IACpC,CAAC,GACDC,QAAOxB,mBAAAA,OAAOK,OAAO,qBAAdL,iBAAgByB,SAAS,IAAI,IACpC;YAAEA,WAAWD,OAAOxB,OAAOK,OAAO,CAACoB,SAAS;QAAE,IAC9C,CAAC,GACDzB,EAAAA,mBAAAA,OAAOK,OAAO,qBAAdL,iBAAgB0B,cAAc,MAAK,OACnC;YAAEA,gBAAgB;QAAK,IACvB,CAAC,GACD1B,EAAAA,mBAAAA,OAAOK,OAAO,qBAAdL,iBAAgB2B,cAAc,MAAK,OACnC;YAAEA,gBAAgB;QAAK,IACvB,CAAC,GACDH,QAAOxB,mBAAAA,OAAOK,OAAO,qBAAdL,iBAAgB4B,eAAe,KAAK,IAC3C;YAAEA,iBAAiBJ,QAAOxB,mBAAAA,OAAOK,OAAO,qBAAdL,iBAAgB4B,eAAe;QAAE,IAC3D,CAAC,GAGD5B,EAAAA,mBAAAA,OAAOK,OAAO,qBAAdL,iBAAgB6B,SAAS,MAAK,OAAO;YAAEA,WAAW;QAAK,IAAI,CAAC;YAChEhB,OAAOC;YACPK;;IAEJ;IACA,OAAOrB;AACT;AAEA,eAAeH,yBAAwB"}
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/model/compile-client-automations.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// Import the entitlement/event predicates from the context-free interactions\n// subpath, NOT the `@aglyn/aglyn` barrel: this file is in the marketing model,\n// which the plugin's SERVER graph re-exports, and the full barrel pulls client\n// React contexts (createContext) that break the RSC server build (AGL-830).\nimport {\n  type ClientInteractionStep,\n  type InteractionStepBase,\n  interactionStepsForClient,\n  isClientActionStep,\n  isClientStepEntitled,\n  isSiteEventType,\n  type SiteInteraction,\n} from '@aglyn/aglyn/app-utils/site-interactions'\nimport { overlayMatchesPath } from './overlays'\nimport type { ClientAutomation } from './site-contract'\n\n/** A raw `hosts/{hostId}/actions` doc paired with its id. */\nexport interface RawHostAction {\n  id: string\n  action: SiteInteraction<InteractionStepBase>\n}\n\nexport interface CompileClientAutomationsOptions {\n  /** Leading-slash page path for pathPattern targeting. */\n  path: string\n  /**\n   * `actions` entitlement (AGL-577). Basic presentational steps\n   * (menu/drawer/show-hide/class/nav/alert) always load; advanced client\n   * steps (overlay/showHtml/analytics) and server steps drop when false.\n   */\n  actionsEntitled: boolean\n  /** Business-tier gate for `runJs` steps (dropped when false). */\n  allowJs: boolean\n  /**\n   * Ignore each action's `pathPattern` (AGL-830). The besigner Preview shows\n   * a single composed screen and scopes relevance by selector match, so it\n   * skips path filtering rather than resolve the composed path.\n   */\n  matchAllPaths?: boolean\n  /**\n   * Drop every automation that names a `pathPattern` (AGL-2511), for a\n   * surface whose own path is unknown — the designed 404 body, served from a\n   * per-host cache that no request path belongs to.\n   *\n   * The opposite of `matchAllPaths` and deliberately so: Preview knows the\n   * page and only lacks its composed address, so it keeps path-scoped\n   * automations; this caller cannot know the page at all, and running an\n   * automation scoped to `/pricing` on whatever URL 404'd would be a guess\n   * with a side effect. Interactions authored on nodes carry no pattern, so\n   * a nav's hover choreography — the reason this surface is enriched — is\n   * unaffected.\n   */\n  dropPathScoped?: boolean\n}\n\n/**\n * Pure action→client-automation mapping (AGL-256/577, extracted AGL-830):\n * the single place the trigger config + entitlement-trimmed client steps are\n * shaped. Both the server page-enricher (admin fetch) and the editor Preview\n * (client fetch) feed their loaded action docs through this, so live and\n * preview stay byte-for-byte consistent. No I/O, no firebase — safe on the\n * client. Malformed entries are skipped, never thrown.\n */\nexport function compileClientAutomations(\n  actions: RawHostAction[],\n  options: CompileClientAutomationsOptions,\n): ClientAutomation[] {\n  const automations: ClientAutomation[] = []\n  for (const { id, action } of actions) {\n    if (\n      (action as { deletedAt?: unknown }).deletedAt ||\n      action.enabled === false\n    ) {\n      continue\n    }\n    const event = String(action.trigger?.event ?? '')\n    if (!isSiteEventType(event)) continue\n    const pathPattern = action.trigger?.pathPattern?.trim()\n    if (pathPattern && options.dropPathScoped) continue\n    if (\n      !options.matchAllPaths &&\n      pathPattern &&\n      !overlayMatchesPath({ pathPatterns: [pathPattern] }, options.path)\n    ) {\n      continue\n    }\n    /*\n     * TRUNCATED AT THE FIRST WAIT, before anything else is decided.\n     *\n     * The browser runs its slice of the list the moment the trigger fires, so\n     * a client step sitting after a `wait` would execute at once — the popup\n     * an author scheduled for three days later would appear immediately, the\n     * delay would look correct on the server, and the two halves of one\n     * authored flow would disagree about when they happened. Everything past\n     * the first wait belongs to a run the job beat has not started yet.\n     */\n    const reachableSteps = interactionStepsForClient(action.steps)\n    // Step-level entitlement tiering (AGL-577): basic presentational steps\n    // load on every plan; advanced client steps need `actions` and runJs\n    // needs `webhooks` — see isClientStepEntitled.\n    const clientSteps = reachableSteps.filter((step): step is ClientInteractionStep =>\n      isClientStepEntitled(step, {\n        actionsEntitled: options.actionsEntitled,\n        allowJs: options.allowJs,\n      }),\n    )\n    // Server steps only dispatch (and are only re-authorized) when the org is\n    // actions-entitled — never advertise them otherwise, so basic-tier pages\n    // don't POST to /api/events/dispatch for a no-op.\n    const hasServerSteps =\n      options.actionsEntitled &&\n      (action.steps ?? []).some((step) => !isClientActionStep(step))\n    if (!clientSteps.length && !hasServerSteps) continue\n    automations.push({\n      id,\n      event,\n      ...(action.trigger?.selector\n        ? { selector: action.trigger.selector }\n        : {}),\n      ...(Number(action.trigger?.threshold) > 0\n        ? { threshold: Number(action.trigger.threshold) }\n        : {}),\n      ...(action.trigger?.oncePerVisitor === true\n        ? { oncePerVisitor: true }\n        : {}),\n      ...(action.trigger?.oncePerSession === true\n        ? { oncePerSession: true }\n        : {}),\n      ...(Number(action.trigger?.cooldownMinutes) >= 1\n        ? { cooldownMinutes: Number(action.trigger?.cooldownMinutes) }\n        : {}),\n      // Repeatable UI choreography (AGL-562): menu/drawer interactions fire on\n      // every occurrence instead of once per pageview.\n      ...(action.trigger?.everyTime === true ? { everyTime: true } : {}),\n      steps: clientSteps,\n      hasServerSteps,\n    })\n  }\n  return automations\n}\n\nexport default compileClientAutomations\n"],"names":["interactionStepsForClient","isClientActionStep","isClientStepEntitled","isSiteEventType","overlayMatchesPath","compileClientAutomations","actions","options","automations","id","action","deletedAt","enabled","event","String","trigger","pathPattern","trim","dropPathScoped","matchAllPaths","pathPatterns","path","reachableSteps","steps","clientSteps","filter","step","actionsEntitled","allowJs","hasServerSteps","some","length","push","selector","Number","threshold","oncePerVisitor","oncePerSession","cooldownMinutes","everyTime"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,6EAA6E;AAC7E,+EAA+E;AAC/E,+EAA+E;AAC/E,4EAA4E;AAC5E,SAGEA,yBAAyB,EACzBC,kBAAkB,EAClBC,oBAAoB,EACpBC,eAAe,QAEV,2CAA0C;AACjD,SAASC,kBAAkB,QAAQ,gBAAY;AA0C/C;;;;;;;CAOC,GACD,OAAO,SAASC,yBACdC,OAAwB,EACxBC,OAAwC;IAExC,MAAMC,cAAkC,EAAE;IAC1C,KAAK,MAAM,EAAEC,EAAE,EAAEC,MAAM,EAAE,IAAIJ,QAAS;kBA2CjCI;YApCkBA,iBAEDA,6BAAAA,kBAuCdA,kBAGOA,kBAGPA,kBAGAA,kBAGOA,kBACmBA,kBAI1BA;QAhEN,IACE,AAACA,OAAmCC,SAAS,IAC7CD,OAAOE,OAAO,KAAK,OACnB;YACA;QACF;QACA,MAAMC,QAAQC,gBAAOJ,kBAAAA,OAAOK,OAAO,qBAAdL,gBAAgBG,KAAK,mBAAI;QAC9C,IAAI,CAACV,gBAAgBU,QAAQ;QAC7B,MAAMG,eAAcN,mBAAAA,OAAOK,OAAO,sBAAdL,8BAAAA,iBAAgBM,WAAW,qBAA3BN,4BAA6BO,IAAI;QACrD,IAAID,eAAeT,QAAQW,cAAc,EAAE;QAC3C,IACE,CAACX,QAAQY,aAAa,IACtBH,eACA,CAACZ,mBAAmB;YAAEgB,cAAc;gBAACJ;aAAY;QAAC,GAAGT,QAAQc,IAAI,GACjE;YACA;QACF;QACA;;;;;;;;;KASC,GACD,MAAMC,iBAAiBtB,0BAA0BU,OAAOa,KAAK;QAC7D,uEAAuE;QACvE,qEAAqE;QACrE,+CAA+C;QAC/C,MAAMC,cAAcF,eAAeG,MAAM,CAAC,CAACC,OACzCxB,qBAAqBwB,MAAM;gBACzBC,iBAAiBpB,QAAQoB,eAAe;gBACxCC,SAASrB,QAAQqB,OAAO;YAC1B;QAEF,0EAA0E;QAC1E,yEAAyE;QACzE,kDAAkD;QAClD,MAAMC,iBACJtB,QAAQoB,eAAe,IACvB,EAACjB,gBAAAA,OAAOa,KAAK,YAAZb,gBAAgB,EAAE,EAAEoB,IAAI,CAAC,CAACJ,OAAS,CAACzB,mBAAmByB;QAC1D,IAAI,CAACF,YAAYO,MAAM,IAAI,CAACF,gBAAgB;QAC5CrB,YAAYwB,IAAI,CAAC;YACfvB;YACAI;WACIH,EAAAA,mBAAAA,OAAOK,OAAO,qBAAdL,iBAAgBuB,QAAQ,IACxB;YAAEA,UAAUvB,OAAOK,OAAO,CAACkB,QAAQ;QAAC,IACpC,CAAC,GACDC,QAAOxB,mBAAAA,OAAOK,OAAO,qBAAdL,iBAAgByB,SAAS,IAAI,IACpC;YAAEA,WAAWD,OAAOxB,OAAOK,OAAO,CAACoB,SAAS;QAAE,IAC9C,CAAC,GACDzB,EAAAA,mBAAAA,OAAOK,OAAO,qBAAdL,iBAAgB0B,cAAc,MAAK,OACnC;YAAEA,gBAAgB;QAAK,IACvB,CAAC,GACD1B,EAAAA,mBAAAA,OAAOK,OAAO,qBAAdL,iBAAgB2B,cAAc,MAAK,OACnC;YAAEA,gBAAgB;QAAK,IACvB,CAAC,GACDH,QAAOxB,mBAAAA,OAAOK,OAAO,qBAAdL,iBAAgB4B,eAAe,KAAK,IAC3C;YAAEA,iBAAiBJ,QAAOxB,mBAAAA,OAAOK,OAAO,qBAAdL,iBAAgB4B,eAAe;QAAE,IAC3D,CAAC,GAGD5B,EAAAA,mBAAAA,OAAOK,OAAO,qBAAdL,iBAAgB6B,SAAS,MAAK,OAAO;YAAEA,WAAW;QAAK,IAAI,CAAC;YAChEhB,OAAOC;YACPK;;IAEJ;IACA,OAAOrB;AACT;AAEA,eAAeH,yBAAwB"}

package/src/lib/model/email-record.d.ts

@@ -0,0 +1,175 @@
+/**
+ * @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.
+ */
+/**
+ * READING ONE MESSAGE RECORD.
+ *
+ * A message — an email that was or will be sent — is a document under
+ * `hosts/{hostId}/campaigns`. Two facts about that document are awkward
+ * enough that every surface reading it gets them wrong the same way, so they
+ * are decided here once.
+ */
+/**
+ * When a message went out, or is due to.
+ *
+ * **There is no one SEND date field.** The send path writes `{status:'sent',
+ * sentAt}` from one branch and `{status:'scheduled', sendAtMs}` from another.
+ * So a list ordered on either field in Firestore does not mis-sort —
+ * `orderBy` DROPS every document missing the ordered field — and half the
+ * messages simply vanish. Sorting on this instead keeps both kinds in one
+ * ordered list.
+ *
+ * `sentAt` is a Firestore `Timestamp`, which the client SDK gives as an
+ * object with `seconds` and `toMillis()`; a document read from cache while a
+ * write is pending can carry a sentinel with neither, which reads as 0 and
+ * sorts last rather than throwing.
+ *
+ * A DRAFT correctly answers 0 here: it has no send time, and inventing one
+ * from its creation would put an unsent message on the timeline of mail that
+ * went out. Ordering a list is {@link emailListTimeMs}'s job.
+ *
+ * @returns epoch ms, or 0 when the message has no time at all.
+ */
+export declare function emailSendTimeMs(record: Record<string, any> | null | undefined): number;
+/**
+ * The field every writer of a message stamps when it MINTS the document.
+ *
+ * The one date on every message, which is what neither `sentAt` nor
+ * `sendAtMs` is — each is written by one branch of the send path and neither
+ * is on both kinds. A field carried by every record is the precondition for
+ * ordering this collection in Firestore rather than in the browser, because
+ * `orderBy` drops documents that lack the ordered field instead of
+ * mis-sorting them.
+ *
+ * Epoch milliseconds rather than a `Timestamp`, matching `sendAtMs` beside
+ * it: the two are compared against each other on every list that draws
+ * drafts and sends together, and a comparison that has to unwrap one side
+ * first is a comparison somebody writes wrong.
+ */
+export declare const EMAIL_CREATED_AT_FIELD = "createdAtMs";
+/**
+ * When a message was created, for the records that carry it.
+ *
+ * `null` — not 0 — for a record carrying no {@link EMAIL_CREATED_AT_FIELD},
+ * because 0 is a real instant at the far end of the sort and "we do not know"
+ * is not "1970". A null orders by the record's send time instead, so the list
+ * is correct for a record from any era.
+ */
+export declare function emailCreatedAtMs(record: Record<string, any> | null | undefined): number | null;
+/**
+ * WHERE A MESSAGE SITS IN A LIST OF MESSAGES.
+ *
+ * Its send time where it has one, and its creation time where it does not.
+ *
+ * A draft has neither `sentAt` nor `sendAtMs`, so ordering a list on the send
+ * time alone gives every draft the key 0 and files it below mail sent years
+ * ago — the newest thing a merchant did, at the bottom of the page, behind
+ * whatever paging the list has. Falling back to creation puts it where the
+ * merchant left it.
+ *
+ * The fallback is deliberately not the other way round. A SENT message orders
+ * by when it went out, never by when it was drafted: the list is a record of
+ * what happened, and a message drafted in March and sent in June belongs in
+ * June.
+ *
+ * @returns epoch ms, or 0 for a record with no time of any kind — a draft
+ *   written before the created stamp existed, which sorts last exactly as it
+ *   did before.
+ */
+export declare function emailListTimeMs(record: Record<string, any> | null | undefined): number;
+/**
+ * Reader-facing text for a message's state.
+ *
+ * The KEYS are persisted values written by the send path and read by the
+ * scheduled-campaign processor — nothing here may change them, including
+ * `canceled`, which is already the American spelling and is a stored enum in
+ * either case. Only the right-hand side is display text, and an unrecognized
+ * state falls through as itself rather than being flattened into one of
+ * these: a state this list cannot name is worth seeing.
+ *
+ * `draft` is an email that has been created and not sent. `sending` is the
+ * claim the scheduled processor and the send-now route both take before they
+ * mail, and it is named here because a merchant who reloads mid-send would
+ * otherwise be shown the raw token.
+ *
+ * ⚠️ **Not what a console row should draw.** This names the STORED value, and
+ * an email delivering an audience larger than one batch is stored as
+ * `scheduled` between runs — so a row rendering this says "Scheduled" about a
+ * send that has already put five hundred messages in five hundred inboxes.
+ * `campaignSendDisplay` in `campaign-container.ts` reads the counters beside
+ * the status and is what every surface here draws. This remains the honest
+ * answer to the narrower question of what one stored token means.
+ */
+export declare function emailStateLabel(status: unknown): string;
+/**
+ * Whether an email has yet been mailed to anybody.
+ *
+ * The surfaces that report on a send need this because an unsent email has no
+ * `stats` at all, and a report that divides into an absent denominator
+ * presents "not sent yet" as a delivery rate of 0% — the same class of fault
+ * as a rate rendered over a denominator it does not name.
+ */
+export declare function emailIsUnsent(record: Record<string, any> | null | undefined): boolean;
+/**
+ * Reader-facing names for the built-in audience kinds.
+ *
+ * The KEYS are the persisted `audience` values written on every message since
+ * the composer shipped; only the values on the right are display text. A
+ * `list` audience is deliberately absent — it is not a kind of audience, it
+ * is a NAMED one, and naming it is {@link emailAudienceLabel}'s job.
+ */
+export declare const EMAIL_AUDIENCE_LABELS: Record<string, string>;
+/**
+ * Which audience a message went to, named for a reader.
+ *
+ * A list send is named by the name the SEND recorded, never by the name the
+ * list carries today: resolving it now would let a rename rewrite the history
+ * of a message that went out months ago, and a deletion erase it. A send that
+ * recorded no name says so instead of printing a document id, which is not
+ * something a merchant recognises as a list.
+ */
+export declare function emailAudienceLabel(record: Record<string, any> | null | undefined): string;
+/**
+ * The sender a message actually left with, as this record has it.
+ *
+ * `recorded` is the whole point of the shape. The address a send goes out on
+ * is stamped by the send — see `sentAsStamp` — and every message sent before
+ * that stamp existed carries nothing, so a surface has to be able to tell an
+ * unrecorded sender apart from one it could compose. Composing it is the
+ * thing that must not happen: a site's sending identity is a setting, and
+ * resolving it now would answer "what would this send as today" on a report
+ * whose subject is a message that went out months ago, under whatever address
+ * the site held then.
+ *
+ * The same rule {@link emailAudienceLabel} follows for a list name, and for
+ * the same reason: the report says what happened, not what would happen now.
+ *
+ * `replyTo` is null on a message that set none, which is not missing
+ * information — a message with no `Reply-To:` takes replies at its `from`,
+ * and that is a fact the record states by omission rather than one it lost.
+ * The difference only reads correctly when `recorded` is true, which is why
+ * a caller must consult that first.
+ */
+export interface EmailSentAs {
+    /** False on a message sent before the send began stamping its sender. */
+    recorded: boolean;
+    from: string | null;
+    /** The display name recipients saw, or null when the address stood alone. */
+    fromName: string | null;
+    /** Where replies were pointed, or null when they go to `from`. */
+    replyTo: string | null;
+}
+export declare function emailSentAs(record: Record<string, any> | null | undefined): EmailSentAs;

package/src/lib/model/email-record.js

@@ -0,0 +1,206 @@
+/**
+ * @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.
+ */ /**
+ * READING ONE MESSAGE RECORD.
+ *
+ * A message — an email that was or will be sent — is a document under
+ * `hosts/{hostId}/campaigns`. Two facts about that document are awkward
+ * enough that every surface reading it gets them wrong the same way, so they
+ * are decided here once.
+ */ /**
+ * When a message went out, or is due to.
+ *
+ * **There is no one SEND date field.** The send path writes `{status:'sent',
+ * sentAt}` from one branch and `{status:'scheduled', sendAtMs}` from another.
+ * So a list ordered on either field in Firestore does not mis-sort —
+ * `orderBy` DROPS every document missing the ordered field — and half the
+ * messages simply vanish. Sorting on this instead keeps both kinds in one
+ * ordered list.
+ *
+ * `sentAt` is a Firestore `Timestamp`, which the client SDK gives as an
+ * object with `seconds` and `toMillis()`; a document read from cache while a
+ * write is pending can carry a sentinel with neither, which reads as 0 and
+ * sorts last rather than throwing.
+ *
+ * A DRAFT correctly answers 0 here: it has no send time, and inventing one
+ * from its creation would put an unsent message on the timeline of mail that
+ * went out. Ordering a list is {@link emailListTimeMs}'s job.
+ *
+ * @returns epoch ms, or 0 when the message has no time at all.
+ */ export function emailSendTimeMs(record) {
+    var _ref, _ref1;
+    var _record_staffReview;
+    // A send held for staff review is parked at a time no run reaches
+    // (AGL-3356). That is a mechanism, not a send time, and printed it reads as
+    // the year 9999 — so a held send answers "no time", like a draft, and the
+    // lists order it by when it was created.
+    if ((record == null ? void 0 : (_record_staffReview = record['staffReview']) == null ? void 0 : _record_staffReview['state']) === 'held' && String((_ref = record == null ? void 0 : record['status']) != null ? _ref : '') === 'scheduled') {
+        return 0;
+    }
+    const sentAt = record == null ? void 0 : record['sentAt'];
+    if (typeof (sentAt == null ? void 0 : sentAt.toMillis) === 'function') return sentAt.toMillis();
+    if (typeof (sentAt == null ? void 0 : sentAt.seconds) === 'number') return sentAt.seconds * 1000;
+    const scheduled = Number((_ref1 = record == null ? void 0 : record['sendAtMs']) != null ? _ref1 : 0);
+    return Number.isFinite(scheduled) ? scheduled : 0;
+}
+/**
+ * The field every writer of a message stamps when it MINTS the document.
+ *
+ * The one date on every message, which is what neither `sentAt` nor
+ * `sendAtMs` is — each is written by one branch of the send path and neither
+ * is on both kinds. A field carried by every record is the precondition for
+ * ordering this collection in Firestore rather than in the browser, because
+ * `orderBy` drops documents that lack the ordered field instead of
+ * mis-sorting them.
+ *
+ * Epoch milliseconds rather than a `Timestamp`, matching `sendAtMs` beside
+ * it: the two are compared against each other on every list that draws
+ * drafts and sends together, and a comparison that has to unwrap one side
+ * first is a comparison somebody writes wrong.
+ */ export const EMAIL_CREATED_AT_FIELD = 'createdAtMs';
+/**
+ * When a message was created, for the records that carry it.
+ *
+ * `null` — not 0 — for a record carrying no {@link EMAIL_CREATED_AT_FIELD},
+ * because 0 is a real instant at the far end of the sort and "we do not know"
+ * is not "1970". A null orders by the record's send time instead, so the list
+ * is correct for a record from any era.
+ */ export function emailCreatedAtMs(record) {
+    var _ref;
+    const created = Number((_ref = record == null ? void 0 : record[EMAIL_CREATED_AT_FIELD]) != null ? _ref : Number.NaN);
+    return Number.isFinite(created) && created > 0 ? created : null;
+}
+/**
+ * WHERE A MESSAGE SITS IN A LIST OF MESSAGES.
+ *
+ * Its send time where it has one, and its creation time where it does not.
+ *
+ * A draft has neither `sentAt` nor `sendAtMs`, so ordering a list on the send
+ * time alone gives every draft the key 0 and files it below mail sent years
+ * ago — the newest thing a merchant did, at the bottom of the page, behind
+ * whatever paging the list has. Falling back to creation puts it where the
+ * merchant left it.
+ *
+ * The fallback is deliberately not the other way round. A SENT message orders
+ * by when it went out, never by when it was drafted: the list is a record of
+ * what happened, and a message drafted in March and sent in June belongs in
+ * June.
+ *
+ * @returns epoch ms, or 0 for a record with no time of any kind — a draft
+ *   written before the created stamp existed, which sorts last exactly as it
+ *   did before.
+ */ export function emailListTimeMs(record) {
+    return emailSendTimeMs(record) || emailCreatedAtMs(record) || 0;
+}
+/**
+ * Reader-facing text for a message's state.
+ *
+ * The KEYS are persisted values written by the send path and read by the
+ * scheduled-campaign processor — nothing here may change them, including
+ * `canceled`, which is already the American spelling and is a stored enum in
+ * either case. Only the right-hand side is display text, and an unrecognized
+ * state falls through as itself rather than being flattened into one of
+ * these: a state this list cannot name is worth seeing.
+ *
+ * `draft` is an email that has been created and not sent. `sending` is the
+ * claim the scheduled processor and the send-now route both take before they
+ * mail, and it is named here because a merchant who reloads mid-send would
+ * otherwise be shown the raw token.
+ *
+ * ⚠️ **Not what a console row should draw.** This names the STORED value, and
+ * an email delivering an audience larger than one batch is stored as
+ * `scheduled` between runs — so a row rendering this says "Scheduled" about a
+ * send that has already put five hundred messages in five hundred inboxes.
+ * `campaignSendDisplay` in `campaign-container.ts` reads the counters beside
+ * the status and is what every surface here draws. This remains the honest
+ * answer to the narrower question of what one stored token means.
+ */ export function emailStateLabel(status) {
+    const value = String(status != null ? status : '');
+    if (value === 'sent') return 'Sent';
+    if (value === 'scheduled') return 'Scheduled';
+    if (value === 'canceled') return 'Canceled';
+    if (value === 'draft') return 'Draft';
+    if (value === 'sending') return 'Sending';
+    return value || 'Unknown';
+}
+/**
+ * Whether an email has yet been mailed to anybody.
+ *
+ * The surfaces that report on a send need this because an unsent email has no
+ * `stats` at all, and a report that divides into an absent denominator
+ * presents "not sent yet" as a delivery rate of 0% — the same class of fault
+ * as a rate rendered over a denominator it does not name.
+ */ export function emailIsUnsent(record) {
+    var _ref;
+    const value = String((_ref = record == null ? void 0 : record['status']) != null ? _ref : '');
+    return value === 'draft' || value === 'scheduled' || value === 'sending';
+}
+/**
+ * Reader-facing names for the built-in audience kinds.
+ *
+ * The KEYS are the persisted `audience` values written on every message since
+ * the composer shipped; only the values on the right are display text. A
+ * `list` audience is deliberately absent — it is not a kind of audience, it
+ * is a NAMED one, and naming it is {@link emailAudienceLabel}'s job.
+ */ export const EMAIL_AUDIENCE_LABELS = {
+    leads: 'All leads',
+    members: 'All site members',
+    segment: 'A contact segment',
+    manual: 'Addresses typed into the composer'
+};
+/**
+ * Which audience a message went to, named for a reader.
+ *
+ * A list send is named by the name the SEND recorded, never by the name the
+ * list carries today: resolving it now would let a rename rewrite the history
+ * of a message that went out months ago, and a deletion erase it. A send that
+ * recorded no name says so instead of printing a document id, which is not
+ * something a merchant recognises as a list.
+ */ export function emailAudienceLabel(record) {
+    var _ref, _ref1;
+    const audience = String((_ref = record == null ? void 0 : record['audience']) != null ? _ref : '');
+    if (audience !== 'list') {
+        var _ref2, _EMAIL_AUDIENCE_LABELS_audience;
+        return (_ref2 = (_EMAIL_AUDIENCE_LABELS_audience = EMAIL_AUDIENCE_LABELS[audience]) != null ? _EMAIL_AUDIENCE_LABELS_audience : audience) != null ? _ref2 : 'Not recorded';
+    }
+    const name = String((_ref1 = record == null ? void 0 : record['listName']) != null ? _ref1 : '');
+    if (name) return name;
+    return (record == null ? void 0 : record['listId']) ? 'A list this send did not name' : 'A list this send did not record';
+}
+export function emailSentAs(record) {
+    var _ref, _ref1, _ref2;
+    const stamp = record == null ? void 0 : record['sentAs'];
+    const from = String((_ref = stamp == null ? void 0 : stamp['from']) != null ? _ref : '').trim();
+    // The ADDRESS is what makes the stamp a record of a send. A `sentAs` map
+    // carrying only a display name is a partial write, and reporting it as
+    // recorded would put a name on screen beside an address nothing supplied.
+    if (!from) {
+        return {
+            recorded: false,
+            from: null,
+            fromName: null,
+            replyTo: null
+        };
+    }
+    return {
+        recorded: true,
+        from,
+        fromName: String((_ref1 = stamp == null ? void 0 : stamp['fromName']) != null ? _ref1 : '').trim() || null,
+        replyTo: String((_ref2 = stamp == null ? void 0 : stamp['replyTo']) != null ? _ref2 : '').trim() || null
+    };
+}
+
+//# sourceMappingURL=email-record.js.map