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

package/src/lib/server/overlay-beacon.js

@@ -0,0 +1,76 @@
+/**
+ * @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 firebaseAdmin from "@aglyn/tenant-data-admin/server/firebase-admin";
+import { FieldValue } from "firebase-admin/firestore";
+/**
+ * OVERLAY ENGAGEMENT (AGL-200), as the site runtime reports it.
+ *
+ * The announcement bar and the popup post `{ overlay, overlayId? }` to the
+ * platform's site collector, which hands the beacon here after its host and
+ * lockdown gates. Two counters move, and neither is a pageview:
+ *
+ *  - the site's day document (`hosts/{hostId}/analytics/{day}`) gains one
+ *    under `overlays.{event}`, the host-wide totals the dashboard reads —
+ *    stamped with the platform's expiry so a day created by overlay events
+ *    alone is still swept (AGL-1844);
+ *  - with an `overlayId` (AGL-271), that overlay's own document gains one
+ *    under `stats.impressions`, `stats.clicks` or `stats.dismissals`, so the
+ *    console shows engagement per bar and popup.
+ */ /** The events an overlay reports; anything else is counted nowhere. */ export const OVERLAY_BEACON_EVENTS = [
+    'barImpression',
+    'popupImpression',
+    'popupDismiss',
+    'popupClick',
+    'barClick',
+    'barDismiss'
+];
+/** The body field that marks a beacon as an overlay's. */ export const OVERLAY_BEACON_FIELD = 'overlay';
+/** The longest overlay id the per-overlay counter accepts. */ const OVERLAY_ID_MAX = 64;
+/** Which of an overlay's lifetime counters an event moves. */ function statKeyOf(event) {
+    if (event.endsWith('Impression')) return 'impressions';
+    if (event.endsWith('Click')) return 'clicks';
+    return 'dismissals';
+}
+/** Counts one overlay beacon, on the Firestore it is handed. */ export async function countOverlayBeacon(request, firestore) {
+    var _request_body_OVERLAY_BEACON_FIELD, _request_body_overlayId;
+    const event = String((_request_body_OVERLAY_BEACON_FIELD = request.body[OVERLAY_BEACON_FIELD]) != null ? _request_body_OVERLAY_BEACON_FIELD : '');
+    if (!OVERLAY_BEACON_EVENTS.includes(event)) return;
+    const hostRef = firestore.collection('hosts').doc(request.hostId);
+    await hostRef.collection('analytics').doc(request.day).set({
+        overlays: {
+            [event]: FieldValue.increment(1)
+        },
+        expiresAt: request.dayExpiresAt
+    }, {
+        merge: true
+    });
+    const overlayId = String((_request_body_overlayId = request.body['overlayId']) != null ? _request_body_overlayId : '');
+    if (!overlayId || overlayId.length > OVERLAY_ID_MAX) return;
+    // update(), not set(): a beacon from a stale cached page must not
+    // resurrect a deleted overlay as a stats-only stray document.
+    await hostRef.collection('overlays').doc(overlayId).update({
+        [`stats.${statKeyOf(event)}`]: FieldValue.increment(1)
+    }).catch(()=>undefined);
+}
+/**
+ * Counts one overlay beacon on the platform's Firestore: what the server
+ * declarations hand the collector, with this module and the Admin SDK loaded
+ * on the first beacon.
+ */ export async function countOverlayBeaconOnPlatform(request) {
+    await countOverlayBeacon(request, firebaseAdmin.app().firestore());
+}
+
+//# sourceMappingURL=overlay-beacon.js.map

package/src/lib/server/overlay-beacon.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/server/overlay-beacon.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 { PluginSiteBeaconRequest } from '@aglyn/aglyn/plugin-manager/plugin-site-beacons'\nimport firebaseAdmin from '@aglyn/tenant-data-admin/server/firebase-admin'\nimport { FieldValue } from 'firebase-admin/firestore'\n\ntype Firestore = FirebaseFirestore.Firestore\n\n/**\n * OVERLAY ENGAGEMENT (AGL-200), as the site runtime reports it.\n *\n * The announcement bar and the popup post `{ overlay, overlayId? }` to the\n * platform's site collector, which hands the beacon here after its host and\n * lockdown gates. Two counters move, and neither is a pageview:\n *\n *  - the site's day document (`hosts/{hostId}/analytics/{day}`) gains one\n *    under `overlays.{event}`, the host-wide totals the dashboard reads —\n *    stamped with the platform's expiry so a day created by overlay events\n *    alone is still swept (AGL-1844);\n *  - with an `overlayId` (AGL-271), that overlay's own document gains one\n *    under `stats.impressions`, `stats.clicks` or `stats.dismissals`, so the\n *    console shows engagement per bar and popup.\n */\n\n/** The events an overlay reports; anything else is counted nowhere. */\nexport const OVERLAY_BEACON_EVENTS: readonly string[] = [\n  'barImpression',\n  'popupImpression',\n  'popupDismiss',\n  'popupClick',\n  'barClick',\n  'barDismiss',\n]\n\n/** The body field that marks a beacon as an overlay's. */\nexport const OVERLAY_BEACON_FIELD = 'overlay'\n\n/** The longest overlay id the per-overlay counter accepts. */\nconst OVERLAY_ID_MAX = 64\n\n/** Which of an overlay's lifetime counters an event moves. */\nfunction statKeyOf(event: string): 'impressions' | 'clicks' | 'dismissals' {\n  if (event.endsWith('Impression')) return 'impressions'\n  if (event.endsWith('Click')) return 'clicks'\n  return 'dismissals'\n}\n\n/** Counts one overlay beacon, on the Firestore it is handed. */\nexport async function countOverlayBeacon(\n  request: PluginSiteBeaconRequest,\n  firestore: Firestore,\n): Promise<void> {\n  const event = String(request.body[OVERLAY_BEACON_FIELD] ?? '')\n  if (!OVERLAY_BEACON_EVENTS.includes(event)) return\n  const hostRef = firestore.collection('hosts').doc(request.hostId)\n  await hostRef\n    .collection('analytics')\n    .doc(request.day)\n    .set(\n      {\n        overlays: { [event]: FieldValue.increment(1) },\n        expiresAt: request.dayExpiresAt,\n      },\n      { merge: true },\n    )\n  const overlayId = String(request.body['overlayId'] ?? '')\n  if (!overlayId || overlayId.length > OVERLAY_ID_MAX) return\n  // update(), not set(): a beacon from a stale cached page must not\n  // resurrect a deleted overlay as a stats-only stray document.\n  await hostRef\n    .collection('overlays')\n    .doc(overlayId)\n    .update({ [`stats.${statKeyOf(event)}`]: FieldValue.increment(1) })\n    .catch(() => undefined)\n}\n\n/**\n * Counts one overlay beacon on the platform's Firestore: what the server\n * declarations hand the collector, with this module and the Admin SDK loaded\n * on the first beacon.\n */\nexport async function countOverlayBeaconOnPlatform(\n  request: PluginSiteBeaconRequest,\n): Promise<void> {\n  await countOverlayBeacon(request, firebaseAdmin.app().firestore())\n}\n"],"names":["firebaseAdmin","FieldValue","OVERLAY_BEACON_EVENTS","OVERLAY_BEACON_FIELD","OVERLAY_ID_MAX","statKeyOf","event","endsWith","countOverlayBeacon","request","firestore","String","body","includes","hostRef","collection","doc","hostId","day","set","overlays","increment","expiresAt","dayExpiresAt","merge","overlayId","length","update","catch","undefined","countOverlayBeaconOnPlatform","app"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAGD,OAAOA,mBAAmB,iDAAgD;AAC1E,SAASC,UAAU,QAAQ,2BAA0B;AAIrD;;;;;;;;;;;;;;CAcC,GAED,qEAAqE,GACrE,OAAO,MAAMC,wBAA2C;IACtD;IACA;IACA;IACA;IACA;IACA;CACD,CAAA;AAED,wDAAwD,GACxD,OAAO,MAAMC,uBAAuB,UAAS;AAE7C,4DAA4D,GAC5D,MAAMC,iBAAiB;AAEvB,4DAA4D,GAC5D,SAASC,UAAUC,KAAa;IAC9B,IAAIA,MAAMC,QAAQ,CAAC,eAAe,OAAO;IACzC,IAAID,MAAMC,QAAQ,CAAC,UAAU,OAAO;IACpC,OAAO;AACT;AAEA,8DAA8D,GAC9D,OAAO,eAAeC,mBACpBC,OAAgC,EAChCC,SAAoB;QAECD,oCAaIA;IAbzB,MAAMH,QAAQK,QAAOF,qCAAAA,QAAQG,IAAI,CAACT,qBAAqB,YAAlCM,qCAAsC;IAC3D,IAAI,CAACP,sBAAsBW,QAAQ,CAACP,QAAQ;IAC5C,MAAMQ,UAAUJ,UAAUK,UAAU,CAAC,SAASC,GAAG,CAACP,QAAQQ,MAAM;IAChE,MAAMH,QACHC,UAAU,CAAC,aACXC,GAAG,CAACP,QAAQS,GAAG,EACfC,GAAG,CACF;QACEC,UAAU;YAAE,CAACd,MAAM,EAAEL,WAAWoB,SAAS,CAAC;QAAG;QAC7CC,WAAWb,QAAQc,YAAY;IACjC,GACA;QAAEC,OAAO;IAAK;IAElB,MAAMC,YAAYd,QAAOF,0BAAAA,QAAQG,IAAI,CAAC,YAAY,YAAzBH,0BAA6B;IACtD,IAAI,CAACgB,aAAaA,UAAUC,MAAM,GAAGtB,gBAAgB;IACrD,kEAAkE;IAClE,8DAA8D;IAC9D,MAAMU,QACHC,UAAU,CAAC,YACXC,GAAG,CAACS,WACJE,MAAM,CAAC;QAAE,CAAC,CAAC,MAAM,EAAEtB,UAAUC,QAAQ,CAAC,EAAEL,WAAWoB,SAAS,CAAC;IAAG,GAChEO,KAAK,CAAC,IAAMC;AACjB;AAEA;;;;CAIC,GACD,OAAO,eAAeC,6BACpBrB,OAAgC;IAEhC,MAAMD,mBAAmBC,SAAST,cAAc+B,GAAG,GAAGrB,SAAS;AACjE"}

package/src/lib/server.js

@@ -18,6 +18,7 @@ import { evaluateAutoWinner } from "./model/index.js";
 import { registerPluginApiRoute, registerSitePageEnricher } from "@aglyn/aglyn/server";
 import { emailEventsHandler } from "./server/email-events.js";
 import { registerMarketingFigureReaders } from "./server/marketing-figures.js";
+import { registerListSendTimeFacts } from "./server/list-send-time-facts.js";
 import { marketingSitePageEnricher } from "./server/site-page-enricher.js";
 import { firebaseAdmin, getOrgForHost } from "@aglyn/tenant-data-admin";
 import { FieldValue } from "firebase-admin/firestore";
@@ -129,6 +130,9 @@ import { campaignRecipientsHandler } from "./server/campaign-recipients.js";
     // Campaign and A/B testing results as figure tables (AGL-2915), for the AI
     // plugin's insights to read by id; the console runs insight jobs.
     registerMarketingFigureReaders(()=>firebaseAdmin.app().firestore());
+    // When a list reads its mail, from its sends on the site (AGL-3080): the
+    // AI plugin's campaign drafts suggest a send time through it.
+    registerListSendTimeFacts(()=>firebaseAdmin.app().firestore());
     registerPluginApiRoute('campaigns/send', campaignSendHandler);
     // Taking a campaign or an abandoned draft away, which is the one class of
     // change the send route may not carry: both write to the SEND collection,

package/src/lib/server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/plugins/marketing/src/lib/server.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 { checkEntitlement } from '@aglyn/aglyn/server'\nimport { evaluateAutoWinner, type HostExperiment } from './model'\nimport {\n  registerPluginApiRoute,\n  registerSitePageEnricher,\n  type PluginApiHandler,\n} from '@aglyn/aglyn/server'\nimport { emailEventsHandler } from './server/email-events'\nimport { registerMarketingFigureReaders } from './server/marketing-figures'\nimport { marketingSitePageEnricher } from './server/site-page-enricher'\nimport { firebaseAdmin, getOrgForHost } from '@aglyn/tenant-data-admin'\nimport { FieldValue } from 'firebase-admin/firestore'\nimport { campaignProcessScheduledHandler } from './server/campaign-process-scheduled'\nimport { listsMaterializeHandler } from './server/lists-materialize'\nimport {\n  campaignManageHandler,\n  campaignManageSubject,\n  registerCampaignDraftWriter,\n} from './server/campaign-manage'\nimport { campaignSendHandler } from './server/campaign-send'\nimport { campaignRecipientsHandler } from './server/campaign-recipients'\n\n/**\n * Experiment beacon (AGL-252): counts an exposure or conversion on\n * `hosts/{hostId}/experiments/{id}/stats/{variantId}`. Sampled counters —\n * fire-and-forget from the page, abTesting-gated, no visitor identity\n * stored server-side (assignment is deterministic client-side).\n */\nconst trackHandler: PluginApiHandler = async (req, res) => {\n  if (req.method !== 'POST') {\n    return res.status(405).json({ error: 'Method not allowed' })\n  }\n  const hostId = String(req.body?.hostId ?? '')\n  const experimentId = String(req.body?.experimentId ?? '')\n  const variantId = String(req.body?.variantId ?? '')\n  const kind = String(req.body?.kind ?? '')\n  if (\n    !hostId ||\n    !experimentId ||\n    !variantId ||\n    !['exposure', 'conversion'].includes(kind)\n  ) {\n    return res.status(400).json({ error: 'Bad beacon' })\n  }\n  try {\n    const org = (await getOrgForHost(hostId))?.org\n    if (!checkEntitlement(org as any, 'abTesting')) {\n      return res.status(200).json({ ok: true })\n    }\n    const experimentRef = firebaseAdmin\n      .app()\n      .firestore()\n      .collection('hosts')\n      .doc(hostId)\n      .collection('experiments')\n      .doc(experimentId)\n    const experiment = await experimentRef.get()\n    if (!experiment.exists || experiment.get('status') !== 'running') {\n      return res.status(200).json({ ok: true })\n    }\n    // Ended experiments (AGL-273) stop counting: stale cached pages may\n    // still beacon briefly, and post-end stats would skew the decision.\n    const endAtMs = Number(experiment.get('endAtMs') ?? 0)\n    if (endAtMs && Date.now() > endAtMs) {\n      return res.status(200).json({ ok: true })\n    }\n    await experimentRef\n      .collection('stats')\n      .doc(variantId)\n      .set(\n        {\n          [kind === 'exposure' ? 'exposures' : 'conversions']:\n            FieldValue.increment(1),\n          updatedAt: FieldValue.serverTimestamp(),\n        },\n        { merge: true },\n      )\n    // Auto-winner (AGL-273): conversions re-evaluate the opt-in decision\n    // rule; a decided experiment finishes itself and serves the winner.\n    const data = experiment.data() as HostExperiment\n    if (kind === 'conversion' && data.autoWinner) {\n      const statsSnapshot = await experimentRef.collection('stats').get()\n      const statsByVariant: Record<\n        string,\n        { exposures?: number; conversions?: number }\n      > = {}\n      for (const doc of statsSnapshot.docs) {\n        statsByVariant[doc.id] = {\n          exposures: Number(doc.get('exposures') ?? 0),\n          conversions: Number(doc.get('conversions') ?? 0),\n        }\n      }\n      const decision = evaluateAutoWinner(data, statsByVariant)\n      if (decision) {\n        await experimentRef.update({\n          status: 'done',\n          winnerVariantId: decision.variantId,\n          autoCompleted: true,\n          completedAt: FieldValue.serverTimestamp(),\n        })\n      }\n    }\n    return res.status(200).json({ ok: true })\n  } catch (error) {\n    console.error(error)\n    return res.status(200).json({ ok: true }) // beacons never error the page\n  }\n}\n\n/** Registers the marketing plugin's public (site-facing) API routes (AGL-396). */\nexport function registerMarketingApi(): void {\n  registerPluginApiRoute('experiments/track', trackHandler)\n  // Site-page contributions (AGL-418): overlays, automations, experiments.\n  registerSitePageEnricher(marketingSitePageEnricher)\n}\n\n/** Registers the marketing plugin's console-side API routes (AGL-396). */\nexport function registerMarketingConsoleApi(): void {\n  // The campaign draft writer another plugin reaches through the core's\n  // resource-drafts seam (AGL-2912). Registered here alone: the AI jobs that\n  // write through it run only on the console, inline and on the beat\n  // (AGL-3026).\n  registerCampaignDraftWriter()\n  // Campaign and A/B testing results as figure tables (AGL-2915), for the AI\n  // plugin's insights to read by id; the console runs insight jobs.\n  registerMarketingFigureReaders(() => firebaseAdmin.app().firestore())\n  registerPluginApiRoute('campaigns/send', campaignSendHandler)\n  // Taking a campaign or an abandoned draft away, which is the one class of\n  // change the send route may not carry: both write to the SEND collection,\n  // which no client may touch, and neither of them mails anything. The\n  // organization hub reaches it naming its org and no site, so the route\n  // names that org as its subject for the release gate.\n  registerPluginApiRoute('campaigns/manage', campaignManageHandler, {\n    subject: campaignManageSubject,\n  })\n  // The other direction through the per-recipient delivery log: not \"what did\n  // we send this person\" but \"who did this design reach, and which of them\n  // opened it\". Server-side because the log is a platform-level collection no\n  // security rule can scope to one site's campaigns.\n  registerPluginApiRoute('campaigns/recipients', campaignRecipientsHandler)\n  // Relocated console route (AGL-418): the Resend/Svix webhook keeps its\n  // /api/email/events URL via the dispatcher; ownership is recorded at\n  // registration so the org gate attributes it to marketing, not email.\n  registerPluginApiRoute('email/events', emailEventsHandler)\n  registerPluginApiRoute(\n    'campaigns/process-scheduled',\n    campaignProcessScheduledHandler,\n  )\n  // The dynamic-list sweep rides the same `*/15` fast-cron as the campaign\n  // processor rather than provisioning a scheduler job of its own.\n  registerPluginApiRoute('lists/materialize', listsMaterializeHandler)\n}\n"],"names":["checkEntitlement","evaluateAutoWinner","registerPluginApiRoute","registerSitePageEnricher","emailEventsHandler","registerMarketingFigureReaders","marketingSitePageEnricher","firebaseAdmin","getOrgForHost","FieldValue","campaignProcessScheduledHandler","listsMaterializeHandler","campaignManageHandler","campaignManageSubject","registerCampaignDraftWriter","campaignSendHandler","campaignRecipientsHandler","trackHandler","req","res","method","status","json","error","hostId","String","body","experimentId","variantId","kind","includes","experiment","org","ok","experimentRef","app","firestore","collection","doc","get","exists","endAtMs","Number","Date","now","set","increment","updatedAt","serverTimestamp","merge","data","autoWinner","statsSnapshot","statsByVariant","docs","id","exposures","conversions","decision","update","winnerVariantId","autoCompleted","completedAt","console","registerMarketingApi","registerMarketingConsoleApi","subject"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,gBAAgB,QAAQ,sBAAqB;AACtD,SAASC,kBAAkB,QAA6B,mBAAS;AACjE,SACEC,sBAAsB,EACtBC,wBAAwB,QAEnB,sBAAqB;AAC5B,SAASC,kBAAkB,QAAQ,2BAAuB;AAC1D,SAASC,8BAA8B,QAAQ,gCAA4B;AAC3E,SAASC,yBAAyB,QAAQ,iCAA6B;AACvE,SAASC,aAAa,EAAEC,aAAa,QAAQ,2BAA0B;AACvE,SAASC,UAAU,QAAQ,2BAA0B;AACrD,SAASC,+BAA+B,QAAQ,yCAAqC;AACrF,SAASC,uBAAuB,QAAQ,gCAA4B;AACpE,SACEC,qBAAqB,EACrBC,qBAAqB,EACrBC,2BAA2B,QACtB,8BAA0B;AACjC,SAASC,mBAAmB,QAAQ,4BAAwB;AAC5D,SAASC,yBAAyB,QAAQ,kCAA8B;AAExE;;;;;CAKC,GACD,MAAMC,eAAiC,OAAOC,KAAKC;;QAI3BD,WACMA,YACHA,YACLA;IANpB,IAAIA,IAAIE,MAAM,KAAK,QAAQ;QACzB,OAAOD,IAAIE,MAAM,CAAC,KAAKC,IAAI,CAAC;YAAEC,OAAO;QAAqB;IAC5D;IACA,MAAMC,SAASC,gBAAOP,YAAAA,IAAIQ,IAAI,qBAARR,UAAUM,MAAM,mBAAI;IAC1C,MAAMG,eAAeF,iBAAOP,aAAAA,IAAIQ,IAAI,qBAARR,WAAUS,YAAY,oBAAI;IACtD,MAAMC,YAAYH,iBAAOP,aAAAA,IAAIQ,IAAI,qBAARR,WAAUU,SAAS,oBAAI;IAChD,MAAMC,OAAOJ,iBAAOP,aAAAA,IAAIQ,IAAI,qBAARR,WAAUW,IAAI,oBAAI;IACtC,IACE,CAACL,UACD,CAACG,gBACD,CAACC,aACD,CAAC;QAAC;QAAY;KAAa,CAACE,QAAQ,CAACD,OACrC;QACA,OAAOV,IAAIE,MAAM,CAAC,KAAKC,IAAI,CAAC;YAAEC,OAAO;QAAa;IACpD;IACA,IAAI;YAkBqBQ;YAjBV;QAAb,MAAMC,OAAO,QAAA,MAAMxB,cAAcgB,4BAArB,AAAC,MAA8BQ,GAAG;QAC9C,IAAI,CAAChC,iBAAiBgC,KAAY,cAAc;YAC9C,OAAOb,IAAIE,MAAM,CAAC,KAAKC,IAAI,CAAC;gBAAEW,IAAI;YAAK;QACzC;QACA,MAAMC,gBAAgB3B,cACnB4B,GAAG,GACHC,SAAS,GACTC,UAAU,CAAC,SACXC,GAAG,CAACd,QACJa,UAAU,CAAC,eACXC,GAAG,CAACX;QACP,MAAMI,aAAa,MAAMG,cAAcK,GAAG;QAC1C,IAAI,CAACR,WAAWS,MAAM,IAAIT,WAAWQ,GAAG,CAAC,cAAc,WAAW;YAChE,OAAOpB,IAAIE,MAAM,CAAC,KAAKC,IAAI,CAAC;gBAAEW,IAAI;YAAK;QACzC;QACA,oEAAoE;QACpE,oEAAoE;QACpE,MAAMQ,UAAUC,QAAOX,kBAAAA,WAAWQ,GAAG,CAAC,sBAAfR,kBAA6B;QACpD,IAAIU,WAAWE,KAAKC,GAAG,KAAKH,SAAS;YACnC,OAAOtB,IAAIE,MAAM,CAAC,KAAKC,IAAI,CAAC;gBAAEW,IAAI;YAAK;QACzC;QACA,MAAMC,cACHG,UAAU,CAAC,SACXC,GAAG,CAACV,WACJiB,GAAG,CACF;YACE,CAAChB,SAAS,aAAa,cAAc,cAAc,EACjDpB,WAAWqC,SAAS,CAAC;YACvBC,WAAWtC,WAAWuC,eAAe;QACvC,GACA;YAAEC,OAAO;QAAK;QAElB,qEAAqE;QACrE,oEAAoE;QACpE,MAAMC,OAAOnB,WAAWmB,IAAI;QAC5B,IAAIrB,SAAS,gBAAgBqB,KAAKC,UAAU,EAAE;YAC5C,MAAMC,gBAAgB,MAAMlB,cAAcG,UAAU,CAAC,SAASE,GAAG;YACjE,MAAMc,iBAGF,CAAC;YACL,KAAK,MAAMf,OAAOc,cAAcE,IAAI,CAAE;oBAEhBhB,UACEA;gBAFtBe,cAAc,CAACf,IAAIiB,EAAE,CAAC,GAAG;oBACvBC,WAAWd,QAAOJ,WAAAA,IAAIC,GAAG,CAAC,wBAARD,WAAwB;oBAC1CmB,aAAaf,QAAOJ,YAAAA,IAAIC,GAAG,CAAC,0BAARD,YAA0B;gBAChD;YACF;YACA,MAAMoB,WAAWzD,mBAAmBiD,MAAMG;YAC1C,IAAIK,UAAU;gBACZ,MAAMxB,cAAcyB,MAAM,CAAC;oBACzBtC,QAAQ;oBACRuC,iBAAiBF,SAAS9B,SAAS;oBACnCiC,eAAe;oBACfC,aAAarD,WAAWuC,eAAe;gBACzC;YACF;QACF;QACA,OAAO7B,IAAIE,MAAM,CAAC,KAAKC,IAAI,CAAC;YAAEW,IAAI;QAAK;IACzC,EAAE,OAAOV,OAAO;QACdwC,QAAQxC,KAAK,CAACA;QACd,OAAOJ,IAAIE,MAAM,CAAC,KAAKC,IAAI,CAAC;YAAEW,IAAI;QAAK,GAAG,+BAA+B;;IAC3E;AACF;AAEA,gFAAgF,GAChF,OAAO,SAAS+B;IACd9D,uBAAuB,qBAAqBe;IAC5C,yEAAyE;IACzEd,yBAAyBG;AAC3B;AAEA,wEAAwE,GACxE,OAAO,SAAS2D;IACd,sEAAsE;IACtE,2EAA2E;IAC3E,mEAAmE;IACnE,cAAc;IACdnD;IACA,2EAA2E;IAC3E,kEAAkE;IAClET,+BAA+B,IAAME,cAAc4B,GAAG,GAAGC,SAAS;IAClElC,uBAAuB,kBAAkBa;IACzC,0EAA0E;IAC1E,0EAA0E;IAC1E,qEAAqE;IACrE,uEAAuE;IACvE,sDAAsD;IACtDb,uBAAuB,oBAAoBU,uBAAuB;QAChEsD,SAASrD;IACX;IACA,4EAA4E;IAC5E,yEAAyE;IACzE,4EAA4E;IAC5E,mDAAmD;IACnDX,uBAAuB,wBAAwBc;IAC/C,uEAAuE;IACvE,qEAAqE;IACrE,sEAAsE;IACtEd,uBAAuB,gBAAgBE;IACvCF,uBACE,+BACAQ;IAEF,yEAAyE;IACzE,iEAAiE;IACjER,uBAAuB,qBAAqBS;AAC9C"}
+{"version":3,"sources":["../../../../../../libs/plugins/marketing/src/lib/server.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 { checkEntitlement } from '@aglyn/aglyn/server'\nimport { evaluateAutoWinner, type HostExperiment } from './model'\nimport {\n  registerPluginApiRoute,\n  registerSitePageEnricher,\n  type PluginApiHandler,\n} from '@aglyn/aglyn/server'\nimport { emailEventsHandler } from './server/email-events'\nimport { registerMarketingFigureReaders } from './server/marketing-figures'\nimport { registerListSendTimeFacts } from './server/list-send-time-facts'\nimport { marketingSitePageEnricher } from './server/site-page-enricher'\nimport { firebaseAdmin, getOrgForHost } from '@aglyn/tenant-data-admin'\nimport { FieldValue } from 'firebase-admin/firestore'\nimport { campaignProcessScheduledHandler } from './server/campaign-process-scheduled'\nimport { listsMaterializeHandler } from './server/lists-materialize'\nimport {\n  campaignManageHandler,\n  campaignManageSubject,\n  registerCampaignDraftWriter,\n} from './server/campaign-manage'\nimport { campaignSendHandler } from './server/campaign-send'\nimport { campaignRecipientsHandler } from './server/campaign-recipients'\n\n/**\n * Experiment beacon (AGL-252): counts an exposure or conversion on\n * `hosts/{hostId}/experiments/{id}/stats/{variantId}`. Sampled counters —\n * fire-and-forget from the page, abTesting-gated, no visitor identity\n * stored server-side (assignment is deterministic client-side).\n */\nconst trackHandler: PluginApiHandler = async (req, res) => {\n  if (req.method !== 'POST') {\n    return res.status(405).json({ error: 'Method not allowed' })\n  }\n  const hostId = String(req.body?.hostId ?? '')\n  const experimentId = String(req.body?.experimentId ?? '')\n  const variantId = String(req.body?.variantId ?? '')\n  const kind = String(req.body?.kind ?? '')\n  if (\n    !hostId ||\n    !experimentId ||\n    !variantId ||\n    !['exposure', 'conversion'].includes(kind)\n  ) {\n    return res.status(400).json({ error: 'Bad beacon' })\n  }\n  try {\n    const org = (await getOrgForHost(hostId))?.org\n    if (!checkEntitlement(org as any, 'abTesting')) {\n      return res.status(200).json({ ok: true })\n    }\n    const experimentRef = firebaseAdmin\n      .app()\n      .firestore()\n      .collection('hosts')\n      .doc(hostId)\n      .collection('experiments')\n      .doc(experimentId)\n    const experiment = await experimentRef.get()\n    if (!experiment.exists || experiment.get('status') !== 'running') {\n      return res.status(200).json({ ok: true })\n    }\n    // Ended experiments (AGL-273) stop counting: stale cached pages may\n    // still beacon briefly, and post-end stats would skew the decision.\n    const endAtMs = Number(experiment.get('endAtMs') ?? 0)\n    if (endAtMs && Date.now() > endAtMs) {\n      return res.status(200).json({ ok: true })\n    }\n    await experimentRef\n      .collection('stats')\n      .doc(variantId)\n      .set(\n        {\n          [kind === 'exposure' ? 'exposures' : 'conversions']:\n            FieldValue.increment(1),\n          updatedAt: FieldValue.serverTimestamp(),\n        },\n        { merge: true },\n      )\n    // Auto-winner (AGL-273): conversions re-evaluate the opt-in decision\n    // rule; a decided experiment finishes itself and serves the winner.\n    const data = experiment.data() as HostExperiment\n    if (kind === 'conversion' && data.autoWinner) {\n      const statsSnapshot = await experimentRef.collection('stats').get()\n      const statsByVariant: Record<\n        string,\n        { exposures?: number; conversions?: number }\n      > = {}\n      for (const doc of statsSnapshot.docs) {\n        statsByVariant[doc.id] = {\n          exposures: Number(doc.get('exposures') ?? 0),\n          conversions: Number(doc.get('conversions') ?? 0),\n        }\n      }\n      const decision = evaluateAutoWinner(data, statsByVariant)\n      if (decision) {\n        await experimentRef.update({\n          status: 'done',\n          winnerVariantId: decision.variantId,\n          autoCompleted: true,\n          completedAt: FieldValue.serverTimestamp(),\n        })\n      }\n    }\n    return res.status(200).json({ ok: true })\n  } catch (error) {\n    console.error(error)\n    return res.status(200).json({ ok: true }) // beacons never error the page\n  }\n}\n\n/** Registers the marketing plugin's public (site-facing) API routes (AGL-396). */\nexport function registerMarketingApi(): void {\n  registerPluginApiRoute('experiments/track', trackHandler)\n  // Site-page contributions (AGL-418): overlays, automations, experiments.\n  registerSitePageEnricher(marketingSitePageEnricher)\n}\n\n/** Registers the marketing plugin's console-side API routes (AGL-396). */\nexport function registerMarketingConsoleApi(): void {\n  // The campaign draft writer another plugin reaches through the core's\n  // resource-drafts seam (AGL-2912). Registered here alone: the AI jobs that\n  // write through it run only on the console, inline and on the beat\n  // (AGL-3026).\n  registerCampaignDraftWriter()\n  // Campaign and A/B testing results as figure tables (AGL-2915), for the AI\n  // plugin's insights to read by id; the console runs insight jobs.\n  registerMarketingFigureReaders(() => firebaseAdmin.app().firestore())\n  // When a list reads its mail, from its sends on the site (AGL-3080): the\n  // AI plugin's campaign drafts suggest a send time through it.\n  registerListSendTimeFacts(() => firebaseAdmin.app().firestore())\n  registerPluginApiRoute('campaigns/send', campaignSendHandler)\n  // Taking a campaign or an abandoned draft away, which is the one class of\n  // change the send route may not carry: both write to the SEND collection,\n  // which no client may touch, and neither of them mails anything. The\n  // organization hub reaches it naming its org and no site, so the route\n  // names that org as its subject for the release gate.\n  registerPluginApiRoute('campaigns/manage', campaignManageHandler, {\n    subject: campaignManageSubject,\n  })\n  // The other direction through the per-recipient delivery log: not \"what did\n  // we send this person\" but \"who did this design reach, and which of them\n  // opened it\". Server-side because the log is a platform-level collection no\n  // security rule can scope to one site's campaigns.\n  registerPluginApiRoute('campaigns/recipients', campaignRecipientsHandler)\n  // Relocated console route (AGL-418): the Resend/Svix webhook keeps its\n  // /api/email/events URL via the dispatcher; ownership is recorded at\n  // registration so the org gate attributes it to marketing, not email.\n  registerPluginApiRoute('email/events', emailEventsHandler)\n  registerPluginApiRoute(\n    'campaigns/process-scheduled',\n    campaignProcessScheduledHandler,\n  )\n  // The dynamic-list sweep rides the same `*/15` fast-cron as the campaign\n  // processor rather than provisioning a scheduler job of its own.\n  registerPluginApiRoute('lists/materialize', listsMaterializeHandler)\n}\n"],"names":["checkEntitlement","evaluateAutoWinner","registerPluginApiRoute","registerSitePageEnricher","emailEventsHandler","registerMarketingFigureReaders","registerListSendTimeFacts","marketingSitePageEnricher","firebaseAdmin","getOrgForHost","FieldValue","campaignProcessScheduledHandler","listsMaterializeHandler","campaignManageHandler","campaignManageSubject","registerCampaignDraftWriter","campaignSendHandler","campaignRecipientsHandler","trackHandler","req","res","method","status","json","error","hostId","String","body","experimentId","variantId","kind","includes","experiment","org","ok","experimentRef","app","firestore","collection","doc","get","exists","endAtMs","Number","Date","now","set","increment","updatedAt","serverTimestamp","merge","data","autoWinner","statsSnapshot","statsByVariant","docs","id","exposures","conversions","decision","update","winnerVariantId","autoCompleted","completedAt","console","registerMarketingApi","registerMarketingConsoleApi","subject"],"mappings":"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"}

package/src/lib/tenant-emails.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @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 { TenantEmailEntry } from '@aglyn/shared-util-email';
+/**
+ * The emails a site sends its own customers through Marketing (AGL-769/770).
+ *
+ * Declared here, by the plugin that sends them, and compiled into the
+ * platform's tenant email catalog (`TENANT_EMAILS` in
+ * `@aglyn/shared-util-email`) by `tools/scripts/generate-plugin-manifests.mjs`
+ * (AGL-3080): the catalog's readers include the send path, which loads no
+ * plugin code, so a runtime registry it had not filled would quietly send
+ * the text card in place of the site's designed email. Regenerate after
+ * changing an entry; `--check` refuses a stale catalog.
+ */
+export declare function marketingTenantEmails(): readonly TenantEmailEntry[];

package/src/lib/tenant-emails.js

@@ -0,0 +1,41 @@
+/**
+ * @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.
+ */ /**
+ * The emails a site sends its own customers through Marketing (AGL-769/770).
+ *
+ * Declared here, by the plugin that sends them, and compiled into the
+ * platform's tenant email catalog (`TENANT_EMAILS` in
+ * `@aglyn/shared-util-email`) by `tools/scripts/generate-plugin-manifests.mjs`
+ * (AGL-3080): the catalog's readers include the send path, which loads no
+ * plugin code, so a runtime registry it had not filled would quietly send
+ * the text card in place of the site's designed email. Regenerate after
+ * changing an entry; `--check` refuses a stale catalog.
+ */ export function marketingTenantEmails() {
+    return [
+        {
+            key: 'campaign',
+            name: 'Campaign broadcast',
+            description: "A campaign sent to the site's subscriber list.",
+            pluginId: 'marketing',
+            plugin: 'Marketing',
+            control: 'external',
+            authoredIn: 'Marketing → Campaigns',
+            footerReason: 'You’re receiving this email from {{host.businessName}}.'
+        }
+    ];
+}
+
+//# sourceMappingURL=tenant-emails.js.map

package/src/lib/tenant-emails.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/plugins/marketing/src/lib/tenant-emails.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 { TenantEmailEntry } from '@aglyn/shared-util-email'\n\n/**\n * The emails a site sends its own customers through Marketing (AGL-769/770).\n *\n * Declared here, by the plugin that sends them, and compiled into the\n * platform's tenant email catalog (`TENANT_EMAILS` in\n * `@aglyn/shared-util-email`) by `tools/scripts/generate-plugin-manifests.mjs`\n * (AGL-3080): the catalog's readers include the send path, which loads no\n * plugin code, so a runtime registry it had not filled would quietly send\n * the text card in place of the site's designed email. Regenerate after\n * changing an entry; `--check` refuses a stale catalog.\n */\nexport function marketingTenantEmails(): readonly TenantEmailEntry[] {\n  return [\n    {\n      key: 'campaign',\n      name: 'Campaign broadcast',\n      description: \"A campaign sent to the site's subscriber list.\",\n      pluginId: 'marketing',\n      plugin: 'Marketing',\n      control: 'external',\n      authoredIn: 'Marketing → Campaigns',\n      footerReason:\n        'You’re receiving this email from {{host.businessName}}.',\n    },\n  ]\n}\n"],"names":["marketingTenantEmails","key","name","description","pluginId","plugin","control","authoredIn","footerReason"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAID;;;;;;;;;;CAUC,GACD,OAAO,SAASA;IACd,OAAO;QACL;YACEC,KAAK;YACLC,MAAM;YACNC,aAAa;YACbC,UAAU;YACVC,QAAQ;YACRC,SAAS;YACTC,YAAY;YACZC,cACE;QACJ;KACD;AACH"}

package/src/lib/testing/stand-in-emails-page-routes.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @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.
+ */
+/**
+ * The Emails page's record routes, as the email plugin publishes them
+ * (AGL-3080), stood in for this plugin's specs — a campaign links each
+ * message's report and the template it was built from, and this plugin may
+ * not load the email plugin that registers the real routes. What that plugin
+ * publishes is held in its own `email-record-routes.spec.ts`.
+ *
+ * Registered under the owner's id, `email`, so a spec asking what happens
+ * where it is not loaded unregisters that plugin's services.
+ */
+export declare function standInEmailsPageRoutes(): void;

package/src/lib/testing/stand-in-emails-page-routes.js

@@ -0,0 +1,42 @@
+/**
+ * @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 { registerPluginRecordRoute } from "@aglyn/aglyn/plugin-manager/plugin-record-routes";
+/**
+ * The Emails page's record routes, as the email plugin publishes them
+ * (AGL-3080), stood in for this plugin's specs — a campaign links each
+ * message's report and the template it was built from, and this plugin may
+ * not load the email plugin that registers the real routes. What that plugin
+ * publishes is held in its own `email-record-routes.spec.ts`.
+ *
+ * Registered under the owner's id, `email`, so a spec asking what happens
+ * where it is not loaded unregisters that plugin's services.
+ */ export function standInEmailsPageRoutes() {
+    const hub = (orgSlug, host)=>host ? `/${orgSlug}/hosts/${host}/emails` : `/${orgSlug}/emails`;
+    registerPluginRecordRoute('emailMessage', {
+        list: ({ orgSlug, host })=>`${hub(orgSlug, host)}/messages`,
+        record: ({ orgSlug, host }, id)=>`${hub(orgSlug, host)}/messages/${encodeURIComponent(id)}`
+    }, {
+        pluginId: 'email'
+    });
+    registerPluginRecordRoute('emailTemplate', {
+        list: ({ orgSlug, host })=>host ? `${hub(orgSlug, host)}/templates` : null,
+        record: ({ orgSlug, host }, id)=>host ? `${hub(orgSlug, host)}/templates/${encodeURIComponent(id)}` : null
+    }, {
+        pluginId: 'email'
+    });
+}
+
+//# sourceMappingURL=stand-in-emails-page-routes.js.map

package/src/lib/testing/stand-in-emails-page-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/testing/stand-in-emails-page-routes.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 { registerPluginRecordRoute } from '@aglyn/aglyn/plugin-manager/plugin-record-routes'\n\n/**\n * The Emails page's record routes, as the email plugin publishes them\n * (AGL-3080), stood in for this plugin's specs — a campaign links each\n * message's report and the template it was built from, and this plugin may\n * not load the email plugin that registers the real routes. What that plugin\n * publishes is held in its own `email-record-routes.spec.ts`.\n *\n * Registered under the owner's id, `email`, so a spec asking what happens\n * where it is not loaded unregisters that plugin's services.\n */\nexport function standInEmailsPageRoutes(): void {\n  const hub = (orgSlug: string, host: string | null) =>\n    host ? `/${orgSlug}/hosts/${host}/emails` : `/${orgSlug}/emails`\n  registerPluginRecordRoute(\n    'emailMessage',\n    {\n      list: ({ orgSlug, host }) => `${hub(orgSlug, host)}/messages`,\n      record: ({ orgSlug, host }, id) => `${hub(orgSlug, host)}/messages/${encodeURIComponent(id)}`,\n    },\n    { pluginId: 'email' },\n  )\n  registerPluginRecordRoute(\n    'emailTemplate',\n    {\n      list: ({ orgSlug, host }) => (host ? `${hub(orgSlug, host)}/templates` : null),\n      record: ({ orgSlug, host }, id) =>\n        host ? `${hub(orgSlug, host)}/templates/${encodeURIComponent(id)}` : null,\n    },\n    { pluginId: 'email' },\n  )\n}\n"],"names":["registerPluginRecordRoute","standInEmailsPageRoutes","hub","orgSlug","host","list","record","id","encodeURIComponent","pluginId"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,yBAAyB,QAAQ,mDAAkD;AAE5F;;;;;;;;;CASC,GACD,OAAO,SAASC;IACd,MAAMC,MAAM,CAACC,SAAiBC,OAC5BA,OAAO,CAAC,CAAC,EAAED,QAAQ,OAAO,EAAEC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC,EAAED,QAAQ,OAAO,CAAC;IAClEH,0BACE,gBACA;QACEK,MAAM,CAAC,EAAEF,OAAO,EAAEC,IAAI,EAAE,GAAK,GAAGF,IAAIC,SAASC,MAAM,SAAS,CAAC;QAC7DE,QAAQ,CAAC,EAAEH,OAAO,EAAEC,IAAI,EAAE,EAAEG,KAAO,GAAGL,IAAIC,SAASC,MAAM,UAAU,EAAEI,mBAAmBD,KAAK;IAC/F,GACA;QAAEE,UAAU;IAAQ;IAEtBT,0BACE,iBACA;QACEK,MAAM,CAAC,EAAEF,OAAO,EAAEC,IAAI,EAAE,GAAMA,OAAO,GAAGF,IAAIC,SAASC,MAAM,UAAU,CAAC,GAAG;QACzEE,QAAQ,CAAC,EAAEH,OAAO,EAAEC,IAAI,EAAE,EAAEG,KAC1BH,OAAO,GAAGF,IAAIC,SAASC,MAAM,WAAW,EAAEI,mBAAmBD,KAAK,GAAG;IACzE,GACA;QAAEE,UAAU;IAAQ;AAExB"}

package/src/lib/components/use-emails-hub-path.d.ts

@@ -1,58 +0,0 @@
-/**
- * The Emails console's URL: under the site being read, or the organization's
- * own Emails page on a surface mounted over the org.
- *
- * A campaign's page links to two records it does not own — the message that
- * was sent inside it, and the template that message was built from — and both
- * keep their pages on the Emails console. The shell hands a plugin page only
- * its OWN `basePath`, so the sibling hub is named here by its SLUG rather
- * than by editing the last segment off the current path: a slug is a string
- * this file can be searched for when a surface moves, and string surgery on
- * somebody else's path is a link that keeps resolving to the wrong place.
- *
- * Free, deliberately. The org slug and the subdomain are already in the URL
- * the console is on, so this reads the route rather than resolving the host
- * document — the two `getDoc`s that resolution costs would be paid on every
- * open of a campaign, to render a link. At the organization level the org
- * mount already carries the slug.
- *
- * The org answer comes from the MOUNT rather than from the route having no
- * site in it: a card is on the organization's page because it was handed the
- * org mount, and that is the fact a link to the org's messages has to follow.
- * A message is the org's document, so its page there is
- * `/[orgSlug]/emails/messages/{id}` — the Emails page over every site.
- *
- * `null` before the params resolve, so callers render plain text rather than
- * a link to nowhere.
- */
-export declare function useEmailsHubPath(): string | null;
-/**
- * The MARKETING console's URL: under the site being read, or the
- * organization's own Marketing hub on a page that names no site.
- *
- * Named for the same reason the Emails one is, from the opposite direction: a
- * converted record — a form submission in the Inbox, a contact in Contacts —
- * links to the campaign it came from, and those surfaces are handed their own
- * hub's `basePath`, not this one's.
- *
- * Campaigns belong to the organization, so the org-level CRM and the org
- * Marketing hub itself link a campaign to `/[orgSlug]/marketing/campaigns/{id}`.
- */
-export declare function useMarketingHubPath(): string | null;
-/** The organization's own Marketing hub, `/[orgSlug]/marketing`. */
-export declare function orgMarketingHubPath(orgSlug: string): string;
-/** The organization's own Emails page, `/[orgSlug]/emails`. */
-export declare function orgEmailsHubPath(orgSlug: string): string;
-/**
- * Any sibling hub's URL under the site being read, by plugin slug.
- *
- * One implementation, because "read the org slug and the subdomain off the
- * route rather than resolving the host document" is the property that keeps
- * these links free, and a second copy of it is where somebody pays for the
- * two `getDoc`s instead.
- *
- * `null` on a page that names no site: a site's hub is the only thing this
- * builds.
- */
-export declare function useConsoleHubPath(pluginSlug: string): string | null;
-export default useEmailsHubPath;

package/src/lib/components/use-emails-hub-path.js

@@ -1,109 +0,0 @@
-/**
- * @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.
- */ 'use client';
-import { buildRoute, Route } from "@aglyn/aglyn";
-import { useParams } from "next/navigation";
-import { useMarketingOrgMount } from "./marketing-org-mount.js";
-/**
- * The Emails console's URL: under the site being read, or the organization's
- * own Emails page on a surface mounted over the org.
- *
- * A campaign's page links to two records it does not own — the message that
- * was sent inside it, and the template that message was built from — and both
- * keep their pages on the Emails console. The shell hands a plugin page only
- * its OWN `basePath`, so the sibling hub is named here by its SLUG rather
- * than by editing the last segment off the current path: a slug is a string
- * this file can be searched for when a surface moves, and string surgery on
- * somebody else's path is a link that keeps resolving to the wrong place.
- *
- * Free, deliberately. The org slug and the subdomain are already in the URL
- * the console is on, so this reads the route rather than resolving the host
- * document — the two `getDoc`s that resolution costs would be paid on every
- * open of a campaign, to render a link. At the organization level the org
- * mount already carries the slug.
- *
- * The org answer comes from the MOUNT rather than from the route having no
- * site in it: a card is on the organization's page because it was handed the
- * org mount, and that is the fact a link to the org's messages has to follow.
- * A message is the org's document, so its page there is
- * `/[orgSlug]/emails/messages/{id}` — the Emails page over every site.
- *
- * `null` before the params resolve, so callers render plain text rather than
- * a link to nowhere.
- */ export function useEmailsHubPath() {
-    const orgMount = useMarketingOrgMount();
-    const siteHub = useConsoleHubPath(EMAILS_SLUG);
-    return orgMount ? orgEmailsHubPath(orgMount.orgSlug) : siteHub;
-}
-/**
- * The MARKETING console's URL: under the site being read, or the
- * organization's own Marketing hub on a page that names no site.
- *
- * Named for the same reason the Emails one is, from the opposite direction: a
- * converted record — a form submission in the Inbox, a contact in Contacts —
- * links to the campaign it came from, and those surfaces are handed their own
- * hub's `basePath`, not this one's.
- *
- * Campaigns belong to the organization, so the org-level CRM and the org
- * Marketing hub itself link a campaign to `/[orgSlug]/marketing/campaigns/{id}`.
- */ export function useMarketingHubPath() {
-    const params = useParams();
-    const orgSlug = params == null ? void 0 : params.orgSlug;
-    if (!orgSlug) return null;
-    return (params == null ? void 0 : params.host) ? buildRoute(Route.HOST_PLUGIN, {
-        orgSlug,
-        host: params.host,
-        pluginSlug: MARKETING_SLUG
-    }) : orgMarketingHubPath(orgSlug);
-}
-/** The Marketing hub's URL slug, under a site and under the org alike. */ const MARKETING_SLUG = 'marketing';
-/** The Emails console's URL slug, under a site and under the org alike. */ const EMAILS_SLUG = 'emails';
-/** The organization's own Marketing hub, `/[orgSlug]/marketing`. */ export function orgMarketingHubPath(orgSlug) {
-    return buildRoute(Route.ORG_PLUGIN, {
-        orgSlug,
-        pluginSlug: MARKETING_SLUG
-    });
-}
-/** The organization's own Emails page, `/[orgSlug]/emails`. */ export function orgEmailsHubPath(orgSlug) {
-    return buildRoute(Route.ORG_PLUGIN, {
-        orgSlug,
-        pluginSlug: EMAILS_SLUG
-    });
-}
-/**
- * Any sibling hub's URL under the site being read, by plugin slug.
- *
- * One implementation, because "read the org slug and the subdomain off the
- * route rather than resolving the host document" is the property that keeps
- * these links free, and a second copy of it is where somebody pays for the
- * two `getDoc`s instead.
- *
- * `null` on a page that names no site: a site's hub is the only thing this
- * builds.
- */ export function useConsoleHubPath(pluginSlug) {
-    const params = useParams();
-    const orgSlug = params == null ? void 0 : params.orgSlug;
-    const host = params == null ? void 0 : params.host;
-    if (!orgSlug || !host) return null;
-    return buildRoute(Route.HOST_PLUGIN, {
-        orgSlug,
-        host,
-        pluginSlug
-    });
-}
-export default useEmailsHubPath;
-
-//# sourceMappingURL=use-emails-hub-path.js.map

package/src/lib/components/use-emails-hub-path.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/components/use-emails-hub-path.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'use client'\n\nimport { buildRoute, Route } from '@aglyn/aglyn'\nimport { useParams } from 'next/navigation'\nimport { useMarketingOrgMount } from './marketing-org-mount'\n\n/**\n * The Emails console's URL: under the site being read, or the organization's\n * own Emails page on a surface mounted over the org.\n *\n * A campaign's page links to two records it does not own — the message that\n * was sent inside it, and the template that message was built from — and both\n * keep their pages on the Emails console. The shell hands a plugin page only\n * its OWN `basePath`, so the sibling hub is named here by its SLUG rather\n * than by editing the last segment off the current path: a slug is a string\n * this file can be searched for when a surface moves, and string surgery on\n * somebody else's path is a link that keeps resolving to the wrong place.\n *\n * Free, deliberately. The org slug and the subdomain are already in the URL\n * the console is on, so this reads the route rather than resolving the host\n * document — the two `getDoc`s that resolution costs would be paid on every\n * open of a campaign, to render a link. At the organization level the org\n * mount already carries the slug.\n *\n * The org answer comes from the MOUNT rather than from the route having no\n * site in it: a card is on the organization's page because it was handed the\n * org mount, and that is the fact a link to the org's messages has to follow.\n * A message is the org's document, so its page there is\n * `/[orgSlug]/emails/messages/{id}` — the Emails page over every site.\n *\n * `null` before the params resolve, so callers render plain text rather than\n * a link to nowhere.\n */\nexport function useEmailsHubPath(): string | null {\n  const orgMount = useMarketingOrgMount()\n  const siteHub = useConsoleHubPath(EMAILS_SLUG)\n  return orgMount ? orgEmailsHubPath(orgMount.orgSlug) : siteHub\n}\n\n/**\n * The MARKETING console's URL: under the site being read, or the\n * organization's own Marketing hub on a page that names no site.\n *\n * Named for the same reason the Emails one is, from the opposite direction: a\n * converted record — a form submission in the Inbox, a contact in Contacts —\n * links to the campaign it came from, and those surfaces are handed their own\n * hub's `basePath`, not this one's.\n *\n * Campaigns belong to the organization, so the org-level CRM and the org\n * Marketing hub itself link a campaign to `/[orgSlug]/marketing/campaigns/{id}`.\n */\nexport function useMarketingHubPath(): string | null {\n  const params = useParams<{ orgSlug: string; host: string }>()\n  const orgSlug = params?.orgSlug\n  if (!orgSlug) return null\n  return params?.host\n    ? buildRoute(Route.HOST_PLUGIN, {\n        orgSlug,\n        host: params.host,\n        pluginSlug: MARKETING_SLUG,\n      })\n    : orgMarketingHubPath(orgSlug)\n}\n\n/** The Marketing hub's URL slug, under a site and under the org alike. */\nconst MARKETING_SLUG = 'marketing'\n\n/** The Emails console's URL slug, under a site and under the org alike. */\nconst EMAILS_SLUG = 'emails'\n\n/** The organization's own Marketing hub, `/[orgSlug]/marketing`. */\nexport function orgMarketingHubPath(orgSlug: string): string {\n  return buildRoute(Route.ORG_PLUGIN, { orgSlug, pluginSlug: MARKETING_SLUG })\n}\n\n/** The organization's own Emails page, `/[orgSlug]/emails`. */\nexport function orgEmailsHubPath(orgSlug: string): string {\n  return buildRoute(Route.ORG_PLUGIN, { orgSlug, pluginSlug: EMAILS_SLUG })\n}\n\n/**\n * Any sibling hub's URL under the site being read, by plugin slug.\n *\n * One implementation, because \"read the org slug and the subdomain off the\n * route rather than resolving the host document\" is the property that keeps\n * these links free, and a second copy of it is where somebody pays for the\n * two `getDoc`s instead.\n *\n * `null` on a page that names no site: a site's hub is the only thing this\n * builds.\n */\nexport function useConsoleHubPath(pluginSlug: string): string | null {\n  const params = useParams<{ orgSlug: string; host: string }>()\n  const orgSlug = params?.orgSlug\n  const host = params?.host\n  if (!orgSlug || !host) return null\n  return buildRoute(Route.HOST_PLUGIN, { orgSlug, host, pluginSlug })\n}\n\nexport default useEmailsHubPath\n"],"names":["buildRoute","Route","useParams","useMarketingOrgMount","useEmailsHubPath","orgMount","siteHub","useConsoleHubPath","EMAILS_SLUG","orgEmailsHubPath","orgSlug","useMarketingHubPath","params","host","HOST_PLUGIN","pluginSlug","MARKETING_SLUG","orgMarketingHubPath","ORG_PLUGIN"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA,SAASA,UAAU,EAAEC,KAAK,QAAQ,eAAc;AAChD,SAASC,SAAS,QAAQ,kBAAiB;AAC3C,SAASC,oBAAoB,QAAQ,2BAAuB;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BC,GACD,OAAO,SAASC;IACd,MAAMC,WAAWF;IACjB,MAAMG,UAAUC,kBAAkBC;IAClC,OAAOH,WAAWI,iBAAiBJ,SAASK,OAAO,IAAIJ;AACzD;AAEA;;;;;;;;;;;CAWC,GACD,OAAO,SAASK;IACd,MAAMC,SAASV;IACf,MAAMQ,UAAUE,0BAAAA,OAAQF,OAAO;IAC/B,IAAI,CAACA,SAAS,OAAO;IACrB,OAAOE,CAAAA,0BAAAA,OAAQC,IAAI,IACfb,WAAWC,MAAMa,WAAW,EAAE;QAC5BJ;QACAG,MAAMD,OAAOC,IAAI;QACjBE,YAAYC;IACd,KACAC,oBAAoBP;AAC1B;AAEA,wEAAwE,GACxE,MAAMM,iBAAiB;AAEvB,yEAAyE,GACzE,MAAMR,cAAc;AAEpB,kEAAkE,GAClE,OAAO,SAASS,oBAAoBP,OAAe;IACjD,OAAOV,WAAWC,MAAMiB,UAAU,EAAE;QAAER;QAASK,YAAYC;IAAe;AAC5E;AAEA,6DAA6D,GAC7D,OAAO,SAASP,iBAAiBC,OAAe;IAC9C,OAAOV,WAAWC,MAAMiB,UAAU,EAAE;QAAER;QAASK,YAAYP;IAAY;AACzE;AAEA;;;;;;;;;;CAUC,GACD,OAAO,SAASD,kBAAkBQ,UAAkB;IAClD,MAAMH,SAASV;IACf,MAAMQ,UAAUE,0BAAAA,OAAQF,OAAO;IAC/B,MAAMG,OAAOD,0BAAAA,OAAQC,IAAI;IACzB,IAAI,CAACH,WAAW,CAACG,MAAM,OAAO;IAC9B,OAAOb,WAAWC,MAAMa,WAAW,EAAE;QAAEJ;QAASG;QAAME;IAAW;AACnE;AAEA,eAAeX,iBAAgB"}