@aglyn/plugins-marketing 1.0.0-beta.229 → 1.0.0-beta.231

package/src/lib/model/overlay-drafts.d.ts

@@ -0,0 +1,97 @@
+/**
+ * @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 { HostOverlay } from './overlays';
+/**
+ * Copy proposed for an announcement bar or a popup by something other than a
+ * person typing it — a widget in the overlay zones — and the rules it is held
+ * to before it reaches an overlay.
+ *
+ * A proposal is never trusted to be the right length or to name a trigger the
+ * site runtime knows: {@link overlayCopyFromProposal} cuts every field to
+ * {@link OVERLAY_COPY_LIMITS} and keeps a trigger only when it is one of
+ * {@link OVERLAY_POPUP_TRIGGERS}, with its value inside that trigger's range.
+ * Links are never proposed: a call to action's destination is a page of the
+ * person's own site, which they pick.
+ */
+/**
+ * How many overlays a site's list reads and can reorder (AGL-2501), and so
+ * the most a site keeps before something else may add one (AGL-3616).
+ */
+export declare const OVERLAY_LIST_CEILING = 50;
+/** The longest each overlay field a proposal fills may be, in characters. */
+export declare const OVERLAY_COPY_LIMITS: {
+    /** The internal name shown in the overlays list. */
+    readonly name: 80;
+    /** An announcement bar's one line. */
+    readonly text: 160;
+    /** A popup's headline. */
+    readonly headline: 90;
+    /** A popup's body. */
+    readonly body: 400;
+    /** A popup's button label; the single popup card cuts the label to the same. */
+    readonly ctaLabel: 60;
+};
+export type OverlayCopyField = keyof typeof OVERLAY_COPY_LIMITS;
+/** One way a popup opens, with the unit and the range of the value it reads. */
+export interface OverlayPopupTrigger {
+    id: NonNullable<NonNullable<HostOverlay['popup']>['trigger']>;
+    /** How the editor names it. */
+    label: string;
+    /** What `triggerValue` counts, or `null` for a trigger that reads none. */
+    unit: 'seconds' | 'percent' | null;
+    min: number;
+    max: number;
+}
+/**
+ * Every trigger the site runtime opens a popup on: after a delay, once the
+ * visitor has scrolled a share of the page, or as they move to leave it.
+ */
+export declare const OVERLAY_POPUP_TRIGGERS: readonly OverlayPopupTrigger[];
+/** What a widget proposes for one overlay. Every field is optional. */
+export interface OverlayCopyProposal {
+    name?: string;
+    /** An announcement bar's text. */
+    text?: string;
+    headline?: string;
+    body?: string;
+    ctaLabel?: string;
+    trigger?: string;
+    triggerValue?: number;
+}
+/** A proposal as it may be written: cut to the limits, with a known trigger or none. */
+export type OverlayCopyValues = Omit<OverlayCopyProposal, 'trigger'> & {
+    trigger?: OverlayPopupTrigger['id'];
+};
+/**
+ * A proposal held to the overlay's own rules, keeping only the fields the
+ * overlay's kind has: a bar has text, a popup a headline, a body, a button
+ * label and a trigger.
+ */
+export declare function overlayCopyFromProposal(kind: HostOverlay['kind'], proposal: OverlayCopyProposal): OverlayCopyValues;
+/**
+ * A new overlay from a proposal, written SWITCHED OFF: a visitor sees nothing
+ * until a person reads it and turns it on. `null` when the proposal has
+ * nothing the overlay needs to exist — a bar's text, a popup's body.
+ */
+export declare function overlayDraftFromProposal(kind: HostOverlay['kind'], proposal: OverlayCopyProposal): HostOverlay | null;
+/**
+ * What is wrong with an overlay draft's content as another plugin hands it
+ * over (AGL-3616), held to the same limits and trigger catalog a proposal is,
+ * but REFUSED rather than cut: a caller that writes a draft through the
+ * marketing plugin's writer is told what to fix. Empty when nothing is.
+ */
+export declare function overlayDraftContentProblems(content: Readonly<Record<string, unknown>>): string[];

package/src/lib/model/overlay-drafts.js

@@ -0,0 +1,192 @@
+/**
+ * @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 { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * Copy proposed for an announcement bar or a popup by something other than a
+ * person typing it — a widget in the overlay zones — and the rules it is held
+ * to before it reaches an overlay.
+ *
+ * A proposal is never trusted to be the right length or to name a trigger the
+ * site runtime knows: {@link overlayCopyFromProposal} cuts every field to
+ * {@link OVERLAY_COPY_LIMITS} and keeps a trigger only when it is one of
+ * {@link OVERLAY_POPUP_TRIGGERS}, with its value inside that trigger's range.
+ * Links are never proposed: a call to action's destination is a page of the
+ * person's own site, which they pick.
+ */ /**
+ * How many overlays a site's list reads and can reorder (AGL-2501), and so
+ * the most a site keeps before something else may add one (AGL-3616).
+ */ export const OVERLAY_LIST_CEILING = 50;
+/** The longest each overlay field a proposal fills may be, in characters. */ export const OVERLAY_COPY_LIMITS = {
+    /** The internal name shown in the overlays list. */ name: 80,
+    /** An announcement bar's one line. */ text: 160,
+    /** A popup's headline. */ headline: 90,
+    /** A popup's body. */ body: 400,
+    /** A popup's button label; the single popup card cuts the label to the same. */ ctaLabel: 60
+};
+/**
+ * Every trigger the site runtime opens a popup on: after a delay, once the
+ * visitor has scrolled a share of the page, or as they move to leave it.
+ */ export const OVERLAY_POPUP_TRIGGERS = [
+    {
+        id: 'delay',
+        label: 'After a delay',
+        unit: 'seconds',
+        min: 0,
+        max: 120
+    },
+    {
+        id: 'scroll',
+        label: 'On scroll',
+        unit: 'percent',
+        min: 1,
+        max: 100
+    },
+    {
+        id: 'exit',
+        label: 'On exit intent',
+        unit: null,
+        min: 0,
+        max: 0
+    }
+];
+/** One line of copy, on one line, cut to its field's limit. */ function clean(value, field, multiline = false) {
+    if (typeof value !== 'string') return undefined;
+    const folded = multiline ? value.replace(/\r\n?/g, '\n').replace(/[^\S\n]+/g, ' ').replace(/\n{3,}/g, '\n\n') : value.replace(/\s+/g, ' ');
+    const trimmed = folded.trim().slice(0, OVERLAY_COPY_LIMITS[field]).trim();
+    return trimmed || undefined;
+}
+/**
+ * A proposal held to the overlay's own rules, keeping only the fields the
+ * overlay's kind has: a bar has text, a popup a headline, a body, a button
+ * label and a trigger.
+ */ export function overlayCopyFromProposal(kind, proposal) {
+    const values = {};
+    const name = clean(proposal.name, 'name');
+    if (name) values.name = name;
+    if (kind === 'bar') {
+        const text = clean(proposal.text, 'text');
+        if (text) values.text = text;
+        return values;
+    }
+    const headline = clean(proposal.headline, 'headline');
+    const body = clean(proposal.body, 'body', true);
+    const ctaLabel = clean(proposal.ctaLabel, 'ctaLabel');
+    if (headline) values.headline = headline;
+    if (body) values.body = body;
+    if (ctaLabel) values.ctaLabel = ctaLabel;
+    const trigger = OVERLAY_POPUP_TRIGGERS.find((entry)=>entry.id === proposal.trigger);
+    if (trigger) {
+        values.trigger = trigger.id;
+        if (trigger.unit) {
+            const raw = Number(proposal.triggerValue);
+            if (Number.isFinite(raw)) {
+                values.triggerValue = Math.min(trigger.max, Math.max(trigger.min, Math.round(raw)));
+            }
+        }
+    }
+    return values;
+}
+/**
+ * A new overlay from a proposal, written SWITCHED OFF: a visitor sees nothing
+ * until a person reads it and turns it on. `null` when the proposal has
+ * nothing the overlay needs to exist — a bar's text, a popup's body.
+ */ export function overlayDraftFromProposal(kind, proposal) {
+    var _values_trigger, _values_triggerValue;
+    const values = overlayCopyFromProposal(kind, proposal);
+    if (kind === 'bar') {
+        if (!values.text) return null;
+        return _extends({
+            kind: 'bar',
+            enabled: false
+        }, values.name ? {
+            name: values.name
+        } : {}, {
+            bar: {
+                text: values.text,
+                dismissible: true
+            }
+        });
+    }
+    if (!values.body) return null;
+    const trigger = (_values_trigger = values.trigger) != null ? _values_trigger : 'delay';
+    return _extends({
+        kind: 'popup',
+        enabled: false
+    }, values.name ? {
+        name: values.name
+    } : {}, {
+        popup: _extends({}, values.headline ? {
+            headline: values.headline
+        } : {}, {
+            body: values.body
+        }, values.ctaLabel ? {
+            ctaLabel: values.ctaLabel
+        } : {}, {
+            trigger
+        }, trigger === 'exit' ? {} : {
+            triggerValue: (_values_triggerValue = values.triggerValue) != null ? _values_triggerValue : 3
+        }, {
+            frequencyDays: 7
+        })
+    });
+}
+/**
+ * What is wrong with an overlay draft's content as another plugin hands it
+ * over (AGL-3616), held to the same limits and trigger catalog a proposal is,
+ * but REFUSED rather than cut: a caller that writes a draft through the
+ * marketing plugin's writer is told what to fix. Empty when nothing is.
+ */ export function overlayDraftContentProblems(content) {
+    const problems = [];
+    const kind = content['kind'];
+    if (kind !== 'bar' && kind !== 'popup') return [
+        'An overlay is a bar or a popup'
+    ];
+    const fields = kind === 'bar' ? [
+        'name',
+        'text'
+    ] : [
+        'name',
+        'headline',
+        'body',
+        'ctaLabel'
+    ];
+    for (const field of fields){
+        const value = content[field];
+        if (value === undefined || value === null) continue;
+        if (typeof value !== 'string') problems.push(`The ${field} must be text`);
+        else if (value.trim().length > OVERLAY_COPY_LIMITS[field]) {
+            problems.push(`The ${field} is longer than ${OVERLAY_COPY_LIMITS[field]} characters`);
+        }
+    }
+    const required = kind === 'bar' ? 'text' : 'body';
+    if (typeof content[required] !== 'string' || !String(content[required]).trim()) {
+        problems.push(kind === 'bar' ? 'An announcement bar needs its text' : 'A popup needs its body');
+    }
+    if (kind === 'popup' && content['trigger'] !== undefined && content['trigger'] !== null) {
+        const trigger = OVERLAY_POPUP_TRIGGERS.find((entry)=>entry.id === content['trigger']);
+        if (!trigger) {
+            problems.push(`A popup opens ${OVERLAY_POPUP_TRIGGERS.map((entry)=>entry.id).join(', ')}`);
+        } else if (trigger.unit && content['triggerValue'] !== undefined && content['triggerValue'] !== null) {
+            const value = Number(content['triggerValue']);
+            if (!Number.isFinite(value) || value < trigger.min || value > trigger.max) {
+                problems.push(`The ${trigger.label.toLowerCase()} value must be from ${trigger.min} to ${trigger.max}`);
+            }
+        }
+    }
+    return problems;
+}
+
+//# sourceMappingURL=overlay-drafts.js.map

package/src/lib/model/overlay-drafts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/model/overlay-drafts.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 { HostOverlay } from './overlays'\n\n/**\n * Copy proposed for an announcement bar or a popup by something other than a\n * person typing it — a widget in the overlay zones — and the rules it is held\n * to before it reaches an overlay.\n *\n * A proposal is never trusted to be the right length or to name a trigger the\n * site runtime knows: {@link overlayCopyFromProposal} cuts every field to\n * {@link OVERLAY_COPY_LIMITS} and keeps a trigger only when it is one of\n * {@link OVERLAY_POPUP_TRIGGERS}, with its value inside that trigger's range.\n * Links are never proposed: a call to action's destination is a page of the\n * person's own site, which they pick.\n */\n\n/**\n * How many overlays a site's list reads and can reorder (AGL-2501), and so\n * the most a site keeps before something else may add one (AGL-3616).\n */\nexport const OVERLAY_LIST_CEILING = 50\n\n/** The longest each overlay field a proposal fills may be, in characters. */\nexport const OVERLAY_COPY_LIMITS = {\n  /** The internal name shown in the overlays list. */\n  name: 80,\n  /** An announcement bar's one line. */\n  text: 160,\n  /** A popup's headline. */\n  headline: 90,\n  /** A popup's body. */\n  body: 400,\n  /** A popup's button label; the single popup card cuts the label to the same. */\n  ctaLabel: 60,\n} as const\n\nexport type OverlayCopyField = keyof typeof OVERLAY_COPY_LIMITS\n\n/** One way a popup opens, with the unit and the range of the value it reads. */\nexport interface OverlayPopupTrigger {\n  id: NonNullable<NonNullable<HostOverlay['popup']>['trigger']>\n  /** How the editor names it. */\n  label: string\n  /** What `triggerValue` counts, or `null` for a trigger that reads none. */\n  unit: 'seconds' | 'percent' | null\n  min: number\n  max: number\n}\n\n/**\n * Every trigger the site runtime opens a popup on: after a delay, once the\n * visitor has scrolled a share of the page, or as they move to leave it.\n */\nexport const OVERLAY_POPUP_TRIGGERS: readonly OverlayPopupTrigger[] = [\n  { id: 'delay', label: 'After a delay', unit: 'seconds', min: 0, max: 120 },\n  { id: 'scroll', label: 'On scroll', unit: 'percent', min: 1, max: 100 },\n  { id: 'exit', label: 'On exit intent', unit: null, min: 0, max: 0 },\n]\n\n/** What a widget proposes for one overlay. Every field is optional. */\nexport interface OverlayCopyProposal {\n  name?: string\n  /** An announcement bar's text. */\n  text?: string\n  headline?: string\n  body?: string\n  ctaLabel?: string\n  trigger?: string\n  triggerValue?: number\n}\n\n/** A proposal as it may be written: cut to the limits, with a known trigger or none. */\nexport type OverlayCopyValues = Omit<OverlayCopyProposal, 'trigger'> & {\n  trigger?: OverlayPopupTrigger['id']\n}\n\n/** One line of copy, on one line, cut to its field's limit. */\nfunction clean(value: unknown, field: OverlayCopyField, multiline = false): string | undefined {\n  if (typeof value !== 'string') return undefined\n  const folded = multiline\n    ? value.replace(/\\r\\n?/g, '\\n').replace(/[^\\S\\n]+/g, ' ').replace(/\\n{3,}/g, '\\n\\n')\n    : value.replace(/\\s+/g, ' ')\n  const trimmed = folded.trim().slice(0, OVERLAY_COPY_LIMITS[field]).trim()\n  return trimmed || undefined\n}\n\n/**\n * A proposal held to the overlay's own rules, keeping only the fields the\n * overlay's kind has: a bar has text, a popup a headline, a body, a button\n * label and a trigger.\n */\nexport function overlayCopyFromProposal(\n  kind: HostOverlay['kind'],\n  proposal: OverlayCopyProposal,\n): OverlayCopyValues {\n  const values: OverlayCopyValues = {}\n  const name = clean(proposal.name, 'name')\n  if (name) values.name = name\n  if (kind === 'bar') {\n    const text = clean(proposal.text, 'text')\n    if (text) values.text = text\n    return values\n  }\n  const headline = clean(proposal.headline, 'headline')\n  const body = clean(proposal.body, 'body', true)\n  const ctaLabel = clean(proposal.ctaLabel, 'ctaLabel')\n  if (headline) values.headline = headline\n  if (body) values.body = body\n  if (ctaLabel) values.ctaLabel = ctaLabel\n  const trigger = OVERLAY_POPUP_TRIGGERS.find((entry) => entry.id === proposal.trigger)\n  if (trigger) {\n    values.trigger = trigger.id\n    if (trigger.unit) {\n      const raw = Number(proposal.triggerValue)\n      if (Number.isFinite(raw)) {\n        values.triggerValue = Math.min(trigger.max, Math.max(trigger.min, Math.round(raw)))\n      }\n    }\n  }\n  return values\n}\n\n/**\n * A new overlay from a proposal, written SWITCHED OFF: a visitor sees nothing\n * until a person reads it and turns it on. `null` when the proposal has\n * nothing the overlay needs to exist — a bar's text, a popup's body.\n */\nexport function overlayDraftFromProposal(\n  kind: HostOverlay['kind'],\n  proposal: OverlayCopyProposal,\n): HostOverlay | null {\n  const values = overlayCopyFromProposal(kind, proposal)\n  if (kind === 'bar') {\n    if (!values.text) return null\n    return {\n      kind: 'bar',\n      enabled: false,\n      ...(values.name ? { name: values.name } : {}),\n      bar: { text: values.text, dismissible: true },\n    }\n  }\n  if (!values.body) return null\n  const trigger = values.trigger ?? 'delay'\n  return {\n    kind: 'popup',\n    enabled: false,\n    ...(values.name ? { name: values.name } : {}),\n    popup: {\n      ...(values.headline ? { headline: values.headline } : {}),\n      body: values.body,\n      ...(values.ctaLabel ? { ctaLabel: values.ctaLabel } : {}),\n      trigger,\n      ...(trigger === 'exit' ? {} : { triggerValue: values.triggerValue ?? 3 }),\n      frequencyDays: 7,\n    },\n  }\n}\n\n/**\n * What is wrong with an overlay draft's content as another plugin hands it\n * over (AGL-3616), held to the same limits and trigger catalog a proposal is,\n * but REFUSED rather than cut: a caller that writes a draft through the\n * marketing plugin's writer is told what to fix. Empty when nothing is.\n */\nexport function overlayDraftContentProblems(content: Readonly<Record<string, unknown>>): string[] {\n  const problems: string[] = []\n  const kind = content['kind']\n  if (kind !== 'bar' && kind !== 'popup') return ['An overlay is a bar or a popup']\n  const fields: OverlayCopyField[] =\n    kind === 'bar' ? ['name', 'text'] : ['name', 'headline', 'body', 'ctaLabel']\n  for (const field of fields) {\n    const value = content[field]\n    if (value === undefined || value === null) continue\n    if (typeof value !== 'string') problems.push(`The ${field} must be text`)\n    else if (value.trim().length > OVERLAY_COPY_LIMITS[field]) {\n      problems.push(`The ${field} is longer than ${OVERLAY_COPY_LIMITS[field]} characters`)\n    }\n  }\n  const required = kind === 'bar' ? 'text' : 'body'\n  if (typeof content[required] !== 'string' || !String(content[required]).trim()) {\n    problems.push(kind === 'bar' ? 'An announcement bar needs its text' : 'A popup needs its body')\n  }\n  if (kind === 'popup' && content['trigger'] !== undefined && content['trigger'] !== null) {\n    const trigger = OVERLAY_POPUP_TRIGGERS.find((entry) => entry.id === content['trigger'])\n    if (!trigger) {\n      problems.push(`A popup opens ${OVERLAY_POPUP_TRIGGERS.map((entry) => entry.id).join(', ')}`)\n    } else if (trigger.unit && content['triggerValue'] !== undefined && content['triggerValue'] !== null) {\n      const value = Number(content['triggerValue'])\n      if (!Number.isFinite(value) || value < trigger.min || value > trigger.max) {\n        problems.push(`The ${trigger.label.toLowerCase()} value must be from ${trigger.min} to ${trigger.max}`)\n      }\n    }\n  }\n  return problems\n}\n"],"names":["OVERLAY_LIST_CEILING","OVERLAY_COPY_LIMITS","name","text","headline","body","ctaLabel","OVERLAY_POPUP_TRIGGERS","id","label","unit","min","max","clean","value","field","multiline","undefined","folded","replace","trimmed","trim","slice","overlayCopyFromProposal","kind","proposal","values","trigger","find","entry","raw","Number","triggerValue","isFinite","Math","round","overlayDraftFromProposal","enabled","bar","dismissible","popup","frequencyDays","overlayDraftContentProblems","content","problems","fields","push","length","required","String","map","join","toLowerCase"],"mappings":"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"}

package/src/lib/plugin.js

@@ -19,6 +19,9 @@ import { mdiBullhornOutline } from "@aglyn/shared-data-mdi";
 import { lazy } from "react";
 import { CAMPAIGN_DESIGN_CREATE_ZONE, CAMPAIGN_DESIGN_PREVIEW_ZONE, CAMPAIGN_SENDER_EDITOR_ZONE, CAMPAIGN_TOPIC_OPTIONS_ZONE, CAMPAIGN_TOPIC_SELECT_ZONE } from "./components/campaign-email-zones.js";
 import { EXPERIMENT_RESULT_ZONE, EXPERIMENT_VARIANTS_ZONE } from "./components/experiment-zones.js";
+import { HOST_OVERLAYS_ZONE, OVERLAY_EDITOR_ZONE } from "./components/overlay-zones.js";
+import { HOST_CAMPAIGNS_ZONE } from "./components/campaign-list-zones.js";
+import { MARKETING_INSIGHTS_ZONE } from "./components/marketing-insight-zones.js";
 import { MARKETING_CONSOLE_SECTIONS, MARKETING_ORG_CONSOLE_SECTIONS } from "./components/marketing-console-sections.js";
 import { registerPluginTransferResourceUi } from "@aglyn/aglyn/plugin-manager/plugin-transfer-resources";
 import { BUNDLE_ID } from "./constants/bundle-common.js";
@@ -97,6 +100,15 @@ import { registerMarketingRecordRoutes } from "./model/marketing-record-routes.j
     bareZone(CAMPAIGN_SENDER_EDITOR_ZONE, 'Add a sender while composing', 'Mounted by the campaign composer once its author asks to add a sender. A widget here is that editor, open in its add mode; `onSaved` names the sender it created.');
     bareZone(CAMPAIGN_DESIGN_CREATE_ZONE, 'A design for one email', 'In the campaign composer, beside the design picker. A widget here is the control that mints a design document and names it through `onCreated`; the composer records the choice on the campaign and opens the editor.');
     bareZone(CAMPAIGN_DESIGN_PREVIEW_ZONE, 'A sent email as an inbox receives it', 'On one message’s page. A widget here renders the stored design, or the plain-text body, through the renderer the send path uses.');
+    /*
+   * The overlays list's two positions (AGL-3603): another way to start an
+   * overlay beside New bar and New popup, and copy proposed among the
+   * editor's fields. What each hands a widget is carried on its token in
+   * `components/overlay-zones`; neither lets a widget write.
+   */ bareZone(HOST_OVERLAYS_ZONE, 'Start an overlay', 'On a site’s Overlays section, beside New bar and New popup: another way to start an announcement bar or a popup. A widget hands proposed copy to `createOverlayDraft`; the list writes the overlay switched off and opens it in the editor.');
+    bareZone(OVERLAY_EDITOR_ZONE, 'An overlay’s copy', 'Among the overlay editor’s fields. A widget is handed the copy as the editor holds it, the field limits and the popup triggers, and proposes copy through `proposeValues`, which fills the fields unsaved; the editor’s Save is the write.');
+    bareZone(HOST_CAMPAIGNS_ZONE, 'Start a campaign', 'On the Campaigns section, a site’s or the organization’s, beside Create campaign and again in the empty list: another way to start a campaign. A widget is handed the site, the organization and, on the organization’s hub, the sites a campaign could be placed on; it writes nothing through the list.');
+    bareZone(MARKETING_INSIGHTS_ZONE, 'A marketing report’s figures, in words', 'In the header of the Conversions section and of one campaign’s report, beside the page’s own actions. A widget is handed the site the figures are one site’s and what the report is about, reads the figures this plugin publishes as figure readers, and writes nothing.');
     registerMarketingRecordRoutes();
     // The site's overlays, for another plugin's picker to list (AGL-3080).
     registerMarketingRecordLists();

package/src/lib/plugin.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/plugins/marketing/src/lib/plugin.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 * as Aglyn from '@aglyn/aglyn'\nimport {\n  registerPluginZone,\n  type PluginZone,\n} from '@aglyn/aglyn/plugin-manager/plugin-zones'\nimport { mdiBullhornOutline } from '@aglyn/shared-data-mdi'\nimport { lazy } from 'react'\nimport {\n  CAMPAIGN_DESIGN_CREATE_ZONE,\n  CAMPAIGN_DESIGN_PREVIEW_ZONE,\n  CAMPAIGN_SENDER_EDITOR_ZONE,\n  CAMPAIGN_TOPIC_OPTIONS_ZONE,\n  CAMPAIGN_TOPIC_SELECT_ZONE,\n} from './components/campaign-email-zones'\nimport {\n  EXPERIMENT_RESULT_ZONE,\n  EXPERIMENT_VARIANTS_ZONE,\n} from './components/experiment-zones'\nimport {\n  MARKETING_CONSOLE_SECTIONS,\n  MARKETING_ORG_CONSOLE_SECTIONS,\n} from './components/marketing-console-sections'\nimport { registerPluginTransferResourceUi } from '@aglyn/aglyn/plugin-manager/plugin-transfer-resources'\nimport { BUNDLE_ID } from './constants/bundle-common'\nimport { StaffOrgEmailCard } from './components/staff-org-email-card.component'\nimport { registerMarketingRecordLists } from './model/overlay-record-list'\nimport { registerMarketingRecordRoutes } from './model/marketing-record-routes'\n\n/** Code-split: the Marketing console page only loads when opened. */\nconst MarketingConsolePage = lazy(\n  () => import('./components/marketing-console-page'),\n)\n\n/** Dashboard glance card, loaded only where the shell renders the slot. */\nconst CampaignGlanceCard = lazy(\n  () => import('./components/campaign-glance-card.component'),\n)\n\n/**\n * The campaigns drawn in the Inbox's Campaigns section: one site's, or every\n * site's on the organization's Inbox.\n */\nconst InboxCampaignsWidget = lazy(\n  () => import('./components/inbox-campaigns-widget'),\n)\n\n/** The Emails page's Messages section: the list, one message, its composer. */\nconst EmailMessagesWidget = lazy(\n  () => import('./components/email-messages-widget'),\n)\n\n/** What the sends built from one template did, on the template's page. */\nconst EmailTemplateReportCard = lazy(\n  () => import('./components/email-template-report-card'),\n)\n\n/** Who received the sends built from one template, on the template's page. */\nconst EmailRecipientsCard = lazy(\n  () => import('./components/email-recipients-card'),\n)\n\n/** Loaded where a record page draws one of the attribution zones. */\nconst RecordAttributionWidget = lazy(\n  () => import('./components/record-attribution-widget'),\n)\n\n/** The site's section experiments, reported to the besigner's Interactions section. */\nconst BesignerSectionExperiments = lazy(\n  () => import('./components/besigner-section-experiments'),\n)\n\n/**\n * Marketing feature plugin (AGL-395). Console-only — overlays and popups\n * render on published sites through the tenant runtime, not a canvas\n * element of their own, so there is no UI bundle. The console half declares\n * the Marketing nav + page through the ConsoleExtension registry (always-on;\n * the surface itself is not release-flagged — its overlays/A-B cards run\n * their own per-plan checks off the passed `org`). The popup image picker\n * uses the shell's media browser via `useMediaPicker`.\n */\nexport function registerMarketingConsole(): void {\n  // How the Import & export hub names campaigns in a workspace package (AGL-3535).\n  registerPluginTransferResourceUi('marketing.campaigns', { label: 'Campaigns' }, { pluginId: BUNDLE_ID })\n  /*\n   * The two positions the A/B testing card hosts (AGL-2914), declared before\n   * the extension that draws the card. An id another plugin has already taken\n   * is refused, naming both. What each zone hands a widget is carried on its\n   * token, in `components/experiment-zones`, so a widget elsewhere is written\n   * against the same shape without importing this plugin.\n   */\n  registerPluginZone(\n    {\n      zone: EXPERIMENT_VARIANTS_ZONE,\n      label: 'A/B test variants',\n      surface: 'console',\n      description:\n        'In the experiment editor, beside the variants. A widget here proposes copy for the variants the editor holds; the dialog’s Save is the write, and nothing a widget returns starts or changes a test.',\n    },\n    // Named rather than left to the loader's marker, because this function is\n    // also called directly — by a spec, and by an app that loads the plugin\n    // without the loader — and a zone with no owner is refused.\n    { pluginId: BUNDLE_ID },\n  )\n  registerPluginZone(\n    {\n      zone: EXPERIMENT_RESULT_ZONE,\n      label: 'A/B test result',\n      surface: 'console',\n      description:\n        'Below the results of one test. A widget here explains what the figures show. There is nothing to apply, and a widget may not declare a winner the card has not.',\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  /*\n   * What a campaign email asks of whichever plugin keeps the mail itself —\n   * the topic catalog, the sending identities, the design document and its\n   * renderer. Each is a zone the composer or a message's page hosts; see\n   * `components/campaign-email-zones` for what each hands a widget. All are\n   * `bare`: a widget there is a field, a button, a drawer or nothing at all,\n   * and the stack's spacing around it would be a gap in a form.\n   */\n  const bareZone = <Props,>(\n    zone: PluginZone<Props>,\n    label: string,\n    description: string,\n  ) =>\n    registerPluginZone(\n      { zone, label, description, surface: 'console', layout: 'bare' },\n      { pluginId: BUNDLE_ID },\n    )\n  bareZone(\n    CAMPAIGN_TOPIC_SELECT_ZONE,\n    'An email’s topic',\n    'In the campaign composer’s field stack. A widget here is the picker for the stream the email belongs to: it is handed the chosen id and reports a new one through `onChange`. The composer records it; the widget writes nothing.',\n  )\n  bareZone(\n    CAMPAIGN_TOPIC_OPTIONS_ZONE,\n    'The topics a campaign can open on',\n    'Beside the drawers that create and edit a campaign. A widget here draws nothing: while `enabled` it reads the streams a recipient can still leave and answers through `onTopics`.',\n  )\n  bareZone(\n    CAMPAIGN_SENDER_EDITOR_ZONE,\n    'Add a sender while composing',\n    'Mounted by the campaign composer once its author asks to add a sender. A widget here is that editor, open in its add mode; `onSaved` names the sender it created.',\n  )\n  bareZone(\n    CAMPAIGN_DESIGN_CREATE_ZONE,\n    'A design for one email',\n    'In the campaign composer, beside the design picker. A widget here is the control that mints a design document and names it through `onCreated`; the composer records the choice on the campaign and opens the editor.',\n  )\n  bareZone(\n    CAMPAIGN_DESIGN_PREVIEW_ZONE,\n    'A sent email as an inbox receives it',\n    'On one message’s page. A widget here renders the stored design, or the plain-text body, through the renderer the send path uses.',\n  )\n  registerMarketingRecordRoutes()\n  // The site's overlays, for another plugin's picker to list (AGL-3080).\n  registerMarketingRecordLists()\n  Aglyn.registerConsoleExtension({\n    pluginId: BUNDLE_ID,\n    displayName: 'Marketing',\n    /*\n     * The host dashboard's `Last campaign` card (AGL-433). A widget rather\n     * than a direct import by the dashboard page, so it appears only on\n     * workspaces that have the plugin that owns the campaign history — a card\n     * about campaigns on a console with no campaigns page could only ever be\n     * blank, and its header links straight into `/marketing/campaigns`.\n     */\n    widgets: [\n      {\n        slot: Aglyn.CONSOLE_WIDGET_SLOTS.hostDashboard,\n        // The id a reader's dashboard preferences already name — it is what\n        // `isDashboardWidgetHidden` and the customize order are keyed on, so\n        // it is persisted and does not follow the plugin.\n        widgetId: 'email-campaign-glance',\n        title: 'Last campaign',\n        Component: CampaignGlanceCard,\n      },\n      // Which campaign or link brought a person, drawn where the plugins that\n      // keep and list people host a zone for it. They hand over what the\n      // record is and its id; neither imports this plugin.\n      {\n        slot: 'crmRecordAttribution',\n        widgetId: 'marketing-crm-record-attribution',\n        title: 'Campaign attribution',\n        Component: RecordAttributionWidget,\n      },\n      // The Emails page hosts its Messages section as a zone: a message is\n      // one send of a campaign, and every action on it is this plugin's route.\n      {\n        slot: 'emailMessages',\n        widgetId: 'marketing-email-messages',\n        title: 'Messages',\n        Component: EmailMessagesWidget,\n      },\n      // A template's page: what the sends built from it did, then who\n      // received them. The template is the Email plugin's; the sends are ours.\n      {\n        slot: 'emailTemplateReport',\n        widgetId: 'marketing-email-template-report',\n        title: 'Sent from this template',\n        Component: EmailTemplateReportCard,\n      },\n      {\n        slot: 'emailTemplateRecipients',\n        widgetId: 'marketing-email-template-recipients',\n        title: 'Recipients',\n        Component: EmailRecipientsCard,\n      },\n      // The Inbox's Campaigns tab is a zone; this is the card that fills it.\n      {\n        slot: 'inboxCampaigns',\n        widgetId: 'marketing-inbox-campaigns',\n        title: 'Campaigns',\n        Component: InboxCampaignsWidget,\n      },\n      {\n        slot: 'inboxRecordAttribution',\n        widgetId: 'marketing-inbox-record-attribution',\n        title: 'Campaign attribution',\n        Component: RecordAttributionWidget,\n      },\n      // The section experiments the besigner's Interactions section badges an\n      // element with and starts on a page's element; reported, never drawn.\n      {\n        slot: Aglyn.CONSOLE_WIDGET_SLOTS.besignerInteractions,\n        widgetId: 'marketing-besigner-section-experiments',\n        title: 'Section experiments',\n        Component: BesignerSectionExperiments,\n      },\n      // The staff organization page's sends and campaigns (AGL-3380), read\n      // only: staff see what the organization sent without joining it.\n      {\n        slot: Aglyn.CONSOLE_WIDGET_SLOTS.adminOrgDetail,\n        widgetId: 'marketing-staff-org-email',\n        title: 'Email campaigns',\n        Component: StaffOrgEmailCard,\n      },\n    ],\n    navItems: [\n      {\n        label: 'Marketing',\n        href: '/marketing',\n        // Sections as ROUTES (AGL-2501): each is a real URL the shell\n        // resolves and gates, so the page mounts the one being read.\n        sections: MARKETING_CONSOLE_SECTIONS,\n        navTabId: 'nav-tab-marketing',\n        icon: { path: mdiBullhornOutline.path },\n        header: {\n          title: 'Marketing',\n          icon: { path: mdiBullhornOutline.path },\n          docsTopic: 'marketingOverlays',\n        },\n        Component: MarketingConsolePage,\n      },\n    ],\n    /*\n     * The ORGANIZATION's Marketing hub, at `/[orgSlug]/marketing`: every\n     * section the site hub has, over every site. Campaigns and their sequence\n     * rollups belong to the organization, so this is where one campaign is\n     * placed across several sites; overlays, tests and conversions stay each\n     * site's and are read across them. Every site's mail is on the\n     * organization's Emails page, as a site's is on its own. The page is the\n     * same component; handed no site, it renders the org sections.\n     *\n     * It carries the SITE tab's id on purpose, the way the org CRM tab does:\n     * `release_marketing` names `nav-tab-marketing`, so one flag holds both\n     * halves of the surface, and the org half cannot ship while the site half\n     * is switched off.\n     */\n    orgNavItems: [\n      {\n        label: 'Marketing',\n        href: '/marketing',\n        sections: MARKETING_ORG_CONSOLE_SECTIONS,\n        navTabId: 'nav-tab-marketing',\n        icon: { path: mdiBullhornOutline.path },\n        header: {\n          title: 'Marketing',\n          icon: { path: mdiBullhornOutline.path },\n          docsTopic: 'marketingOverlays',\n        },\n        Component: MarketingConsolePage,\n      },\n    ],\n  })\n}\n\nexport * from './site'\n"],"names":["Aglyn","registerPluginZone","mdiBullhornOutline","lazy","CAMPAIGN_DESIGN_CREATE_ZONE","CAMPAIGN_DESIGN_PREVIEW_ZONE","CAMPAIGN_SENDER_EDITOR_ZONE","CAMPAIGN_TOPIC_OPTIONS_ZONE","CAMPAIGN_TOPIC_SELECT_ZONE","EXPERIMENT_RESULT_ZONE","EXPERIMENT_VARIANTS_ZONE","MARKETING_CONSOLE_SECTIONS","MARKETING_ORG_CONSOLE_SECTIONS","registerPluginTransferResourceUi","BUNDLE_ID","StaffOrgEmailCard","registerMarketingRecordLists","registerMarketingRecordRoutes","MarketingConsolePage","CampaignGlanceCard","InboxCampaignsWidget","EmailMessagesWidget","EmailTemplateReportCard","EmailRecipientsCard","RecordAttributionWidget","BesignerSectionExperiments","registerMarketingConsole","label","pluginId","zone","surface","description","bareZone","layout","registerConsoleExtension","displayName","widgets","slot","CONSOLE_WIDGET_SLOTS","hostDashboard","widgetId","title","Component","besignerInteractions","adminOrgDetail","navItems","href","sections","navTabId","icon","path","header","docsTopic","orgNavItems"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../libs/plugins/marketing/src/lib/plugin.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 * as Aglyn from '@aglyn/aglyn'\nimport {\n  registerPluginZone,\n  type PluginZone,\n} from '@aglyn/aglyn/plugin-manager/plugin-zones'\nimport { mdiBullhornOutline } from '@aglyn/shared-data-mdi'\nimport { lazy } from 'react'\nimport {\n  CAMPAIGN_DESIGN_CREATE_ZONE,\n  CAMPAIGN_DESIGN_PREVIEW_ZONE,\n  CAMPAIGN_SENDER_EDITOR_ZONE,\n  CAMPAIGN_TOPIC_OPTIONS_ZONE,\n  CAMPAIGN_TOPIC_SELECT_ZONE,\n} from './components/campaign-email-zones'\nimport {\n  EXPERIMENT_RESULT_ZONE,\n  EXPERIMENT_VARIANTS_ZONE,\n} from './components/experiment-zones'\nimport { HOST_OVERLAYS_ZONE, OVERLAY_EDITOR_ZONE } from './components/overlay-zones'\nimport { HOST_CAMPAIGNS_ZONE } from './components/campaign-list-zones'\nimport { MARKETING_INSIGHTS_ZONE } from './components/marketing-insight-zones'\nimport {\n  MARKETING_CONSOLE_SECTIONS,\n  MARKETING_ORG_CONSOLE_SECTIONS,\n} from './components/marketing-console-sections'\nimport { registerPluginTransferResourceUi } from '@aglyn/aglyn/plugin-manager/plugin-transfer-resources'\nimport { BUNDLE_ID } from './constants/bundle-common'\nimport { StaffOrgEmailCard } from './components/staff-org-email-card.component'\nimport { registerMarketingRecordLists } from './model/overlay-record-list'\nimport { registerMarketingRecordRoutes } from './model/marketing-record-routes'\n\n/** Code-split: the Marketing console page only loads when opened. */\nconst MarketingConsolePage = lazy(\n  () => import('./components/marketing-console-page'),\n)\n\n/** Dashboard glance card, loaded only where the shell renders the slot. */\nconst CampaignGlanceCard = lazy(\n  () => import('./components/campaign-glance-card.component'),\n)\n\n/**\n * The campaigns drawn in the Inbox's Campaigns section: one site's, or every\n * site's on the organization's Inbox.\n */\nconst InboxCampaignsWidget = lazy(\n  () => import('./components/inbox-campaigns-widget'),\n)\n\n/** The Emails page's Messages section: the list, one message, its composer. */\nconst EmailMessagesWidget = lazy(\n  () => import('./components/email-messages-widget'),\n)\n\n/** What the sends built from one template did, on the template's page. */\nconst EmailTemplateReportCard = lazy(\n  () => import('./components/email-template-report-card'),\n)\n\n/** Who received the sends built from one template, on the template's page. */\nconst EmailRecipientsCard = lazy(\n  () => import('./components/email-recipients-card'),\n)\n\n/** Loaded where a record page draws one of the attribution zones. */\nconst RecordAttributionWidget = lazy(\n  () => import('./components/record-attribution-widget'),\n)\n\n/** The site's section experiments, reported to the besigner's Interactions section. */\nconst BesignerSectionExperiments = lazy(\n  () => import('./components/besigner-section-experiments'),\n)\n\n/**\n * Marketing feature plugin (AGL-395). Console-only — overlays and popups\n * render on published sites through the tenant runtime, not a canvas\n * element of their own, so there is no UI bundle. The console half declares\n * the Marketing nav + page through the ConsoleExtension registry (always-on;\n * the surface itself is not release-flagged — its overlays/A-B cards run\n * their own per-plan checks off the passed `org`). The popup image picker\n * uses the shell's media browser via `useMediaPicker`.\n */\nexport function registerMarketingConsole(): void {\n  // How the Import & export hub names campaigns in a workspace package (AGL-3535).\n  registerPluginTransferResourceUi('marketing.campaigns', { label: 'Campaigns' }, { pluginId: BUNDLE_ID })\n  /*\n   * The two positions the A/B testing card hosts (AGL-2914), declared before\n   * the extension that draws the card. An id another plugin has already taken\n   * is refused, naming both. What each zone hands a widget is carried on its\n   * token, in `components/experiment-zones`, so a widget elsewhere is written\n   * against the same shape without importing this plugin.\n   */\n  registerPluginZone(\n    {\n      zone: EXPERIMENT_VARIANTS_ZONE,\n      label: 'A/B test variants',\n      surface: 'console',\n      description:\n        'In the experiment editor, beside the variants. A widget here proposes copy for the variants the editor holds; the dialog’s Save is the write, and nothing a widget returns starts or changes a test.',\n    },\n    // Named rather than left to the loader's marker, because this function is\n    // also called directly — by a spec, and by an app that loads the plugin\n    // without the loader — and a zone with no owner is refused.\n    { pluginId: BUNDLE_ID },\n  )\n  registerPluginZone(\n    {\n      zone: EXPERIMENT_RESULT_ZONE,\n      label: 'A/B test result',\n      surface: 'console',\n      description:\n        'Below the results of one test. A widget here explains what the figures show. There is nothing to apply, and a widget may not declare a winner the card has not.',\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  /*\n   * What a campaign email asks of whichever plugin keeps the mail itself —\n   * the topic catalog, the sending identities, the design document and its\n   * renderer. Each is a zone the composer or a message's page hosts; see\n   * `components/campaign-email-zones` for what each hands a widget. All are\n   * `bare`: a widget there is a field, a button, a drawer or nothing at all,\n   * and the stack's spacing around it would be a gap in a form.\n   */\n  const bareZone = <Props,>(\n    zone: PluginZone<Props>,\n    label: string,\n    description: string,\n  ) =>\n    registerPluginZone(\n      { zone, label, description, surface: 'console', layout: 'bare' },\n      { pluginId: BUNDLE_ID },\n    )\n  bareZone(\n    CAMPAIGN_TOPIC_SELECT_ZONE,\n    'An email’s topic',\n    'In the campaign composer’s field stack. A widget here is the picker for the stream the email belongs to: it is handed the chosen id and reports a new one through `onChange`. The composer records it; the widget writes nothing.',\n  )\n  bareZone(\n    CAMPAIGN_TOPIC_OPTIONS_ZONE,\n    'The topics a campaign can open on',\n    'Beside the drawers that create and edit a campaign. A widget here draws nothing: while `enabled` it reads the streams a recipient can still leave and answers through `onTopics`.',\n  )\n  bareZone(\n    CAMPAIGN_SENDER_EDITOR_ZONE,\n    'Add a sender while composing',\n    'Mounted by the campaign composer once its author asks to add a sender. A widget here is that editor, open in its add mode; `onSaved` names the sender it created.',\n  )\n  bareZone(\n    CAMPAIGN_DESIGN_CREATE_ZONE,\n    'A design for one email',\n    'In the campaign composer, beside the design picker. A widget here is the control that mints a design document and names it through `onCreated`; the composer records the choice on the campaign and opens the editor.',\n  )\n  bareZone(\n    CAMPAIGN_DESIGN_PREVIEW_ZONE,\n    'A sent email as an inbox receives it',\n    'On one message’s page. A widget here renders the stored design, or the plain-text body, through the renderer the send path uses.',\n  )\n  /*\n   * The overlays list's two positions (AGL-3603): another way to start an\n   * overlay beside New bar and New popup, and copy proposed among the\n   * editor's fields. What each hands a widget is carried on its token in\n   * `components/overlay-zones`; neither lets a widget write.\n   */\n  bareZone(\n    HOST_OVERLAYS_ZONE,\n    'Start an overlay',\n    'On a site’s Overlays section, beside New bar and New popup: another way to start an announcement bar or a popup. A widget hands proposed copy to `createOverlayDraft`; the list writes the overlay switched off and opens it in the editor.',\n  )\n  bareZone(\n    OVERLAY_EDITOR_ZONE,\n    'An overlay’s copy',\n    'Among the overlay editor’s fields. A widget is handed the copy as the editor holds it, the field limits and the popup triggers, and proposes copy through `proposeValues`, which fills the fields unsaved; the editor’s Save is the write.',\n  )\n  bareZone(\n    HOST_CAMPAIGNS_ZONE,\n    'Start a campaign',\n    'On the Campaigns section, a site’s or the organization’s, beside Create campaign and again in the empty list: another way to start a campaign. A widget is handed the site, the organization and, on the organization’s hub, the sites a campaign could be placed on; it writes nothing through the list.',\n  )\n  bareZone(\n    MARKETING_INSIGHTS_ZONE,\n    'A marketing report’s figures, in words',\n    'In the header of the Conversions section and of one campaign’s report, beside the page’s own actions. A widget is handed the site the figures are one site’s and what the report is about, reads the figures this plugin publishes as figure readers, and writes nothing.',\n  )\n  registerMarketingRecordRoutes()\n  // The site's overlays, for another plugin's picker to list (AGL-3080).\n  registerMarketingRecordLists()\n  Aglyn.registerConsoleExtension({\n    pluginId: BUNDLE_ID,\n    displayName: 'Marketing',\n    /*\n     * The host dashboard's `Last campaign` card (AGL-433). A widget rather\n     * than a direct import by the dashboard page, so it appears only on\n     * workspaces that have the plugin that owns the campaign history — a card\n     * about campaigns on a console with no campaigns page could only ever be\n     * blank, and its header links straight into `/marketing/campaigns`.\n     */\n    widgets: [\n      {\n        slot: Aglyn.CONSOLE_WIDGET_SLOTS.hostDashboard,\n        // The id a reader's dashboard preferences already name — it is what\n        // `isDashboardWidgetHidden` and the customize order are keyed on, so\n        // it is persisted and does not follow the plugin.\n        widgetId: 'email-campaign-glance',\n        title: 'Last campaign',\n        Component: CampaignGlanceCard,\n      },\n      // Which campaign or link brought a person, drawn where the plugins that\n      // keep and list people host a zone for it. They hand over what the\n      // record is and its id; neither imports this plugin.\n      {\n        slot: 'crmRecordAttribution',\n        widgetId: 'marketing-crm-record-attribution',\n        title: 'Campaign attribution',\n        Component: RecordAttributionWidget,\n      },\n      // The Emails page hosts its Messages section as a zone: a message is\n      // one send of a campaign, and every action on it is this plugin's route.\n      {\n        slot: 'emailMessages',\n        widgetId: 'marketing-email-messages',\n        title: 'Messages',\n        Component: EmailMessagesWidget,\n      },\n      // A template's page: what the sends built from it did, then who\n      // received them. The template is the Email plugin's; the sends are ours.\n      {\n        slot: 'emailTemplateReport',\n        widgetId: 'marketing-email-template-report',\n        title: 'Sent from this template',\n        Component: EmailTemplateReportCard,\n      },\n      {\n        slot: 'emailTemplateRecipients',\n        widgetId: 'marketing-email-template-recipients',\n        title: 'Recipients',\n        Component: EmailRecipientsCard,\n      },\n      // The Inbox's Campaigns tab is a zone; this is the card that fills it.\n      {\n        slot: 'inboxCampaigns',\n        widgetId: 'marketing-inbox-campaigns',\n        title: 'Campaigns',\n        Component: InboxCampaignsWidget,\n      },\n      {\n        slot: 'inboxRecordAttribution',\n        widgetId: 'marketing-inbox-record-attribution',\n        title: 'Campaign attribution',\n        Component: RecordAttributionWidget,\n      },\n      // The section experiments the besigner's Interactions section badges an\n      // element with and starts on a page's element; reported, never drawn.\n      {\n        slot: Aglyn.CONSOLE_WIDGET_SLOTS.besignerInteractions,\n        widgetId: 'marketing-besigner-section-experiments',\n        title: 'Section experiments',\n        Component: BesignerSectionExperiments,\n      },\n      // The staff organization page's sends and campaigns (AGL-3380), read\n      // only: staff see what the organization sent without joining it.\n      {\n        slot: Aglyn.CONSOLE_WIDGET_SLOTS.adminOrgDetail,\n        widgetId: 'marketing-staff-org-email',\n        title: 'Email campaigns',\n        Component: StaffOrgEmailCard,\n      },\n    ],\n    navItems: [\n      {\n        label: 'Marketing',\n        href: '/marketing',\n        // Sections as ROUTES (AGL-2501): each is a real URL the shell\n        // resolves and gates, so the page mounts the one being read.\n        sections: MARKETING_CONSOLE_SECTIONS,\n        navTabId: 'nav-tab-marketing',\n        icon: { path: mdiBullhornOutline.path },\n        header: {\n          title: 'Marketing',\n          icon: { path: mdiBullhornOutline.path },\n          docsTopic: 'marketingOverlays',\n        },\n        Component: MarketingConsolePage,\n      },\n    ],\n    /*\n     * The ORGANIZATION's Marketing hub, at `/[orgSlug]/marketing`: every\n     * section the site hub has, over every site. Campaigns and their sequence\n     * rollups belong to the organization, so this is where one campaign is\n     * placed across several sites; overlays, tests and conversions stay each\n     * site's and are read across them. Every site's mail is on the\n     * organization's Emails page, as a site's is on its own. The page is the\n     * same component; handed no site, it renders the org sections.\n     *\n     * It carries the SITE tab's id on purpose, the way the org CRM tab does:\n     * `release_marketing` names `nav-tab-marketing`, so one flag holds both\n     * halves of the surface, and the org half cannot ship while the site half\n     * is switched off.\n     */\n    orgNavItems: [\n      {\n        label: 'Marketing',\n        href: '/marketing',\n        sections: MARKETING_ORG_CONSOLE_SECTIONS,\n        navTabId: 'nav-tab-marketing',\n        icon: { path: mdiBullhornOutline.path },\n        header: {\n          title: 'Marketing',\n          icon: { path: mdiBullhornOutline.path },\n          docsTopic: 'marketingOverlays',\n        },\n        Component: MarketingConsolePage,\n      },\n    ],\n  })\n}\n\nexport * from './site'\n"],"names":["Aglyn","registerPluginZone","mdiBullhornOutline","lazy","CAMPAIGN_DESIGN_CREATE_ZONE","CAMPAIGN_DESIGN_PREVIEW_ZONE","CAMPAIGN_SENDER_EDITOR_ZONE","CAMPAIGN_TOPIC_OPTIONS_ZONE","CAMPAIGN_TOPIC_SELECT_ZONE","EXPERIMENT_RESULT_ZONE","EXPERIMENT_VARIANTS_ZONE","HOST_OVERLAYS_ZONE","OVERLAY_EDITOR_ZONE","HOST_CAMPAIGNS_ZONE","MARKETING_INSIGHTS_ZONE","MARKETING_CONSOLE_SECTIONS","MARKETING_ORG_CONSOLE_SECTIONS","registerPluginTransferResourceUi","BUNDLE_ID","StaffOrgEmailCard","registerMarketingRecordLists","registerMarketingRecordRoutes","MarketingConsolePage","CampaignGlanceCard","InboxCampaignsWidget","EmailMessagesWidget","EmailTemplateReportCard","EmailRecipientsCard","RecordAttributionWidget","BesignerSectionExperiments","registerMarketingConsole","label","pluginId","zone","surface","description","bareZone","layout","registerConsoleExtension","displayName","widgets","slot","CONSOLE_WIDGET_SLOTS","hostDashboard","widgetId","title","Component","besignerInteractions","adminOrgDetail","navItems","href","sections","navTabId","icon","path","header","docsTopic","orgNavItems"],"mappings":"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"}

package/src/lib/server/email-events.js

@@ -47,6 +47,7 @@ import { recordEmailDeliveryEvents, recordPersonEngagement } from "@aglyn/tenant
 import { recordEmailCampaignTouch } from "./email-campaign-touch.js";
 // The contact's own stamp is the record system's, asked through the core's
 // seam: what the record page, the list and the re-engagement audience read.
+import { runPluginEventHandlers } from "@aglyn/aglyn/plugin-manager/plugin-events";
 import { stampRecordEmailEngagement } from "@aglyn/aglyn/plugin-manager/plugin-record-email-state";
 import { isDocumentId } from "@aglyn/tenant-data-admin/server/document-id";
 import { getOrgForHost } from "@aglyn/tenant-data-admin/server/organizations";
@@ -458,6 +459,13 @@ import { suppressionId } from "./campaign-send.js";
                 hostId: hostRef.id,
                 events: outcomes
             }).catch(()=>null);
+            // The same first opens and clicks, for any plugin that counts a site's
+            // engagement of its own — a funnel's email step (AGL-3605). Isolated:
+            // a subscriber's failure never reaches the webhook's answer.
+            await runPluginEventHandlers('host.email.engaged', {
+                hostId: hostRef.id,
+                events: outcomes.filter((one)=>one.type === 'opened' || one.type === 'clicked')
+            }).catch(()=>null);
         }
         /*==========================================
      * THE ONE-TO-ONE EMAIL'S TIMELINE ENTRY (AGL-2615, AGL-3080).