@aglyn/plugins-marketing 1.0.0-beta.228 → 1.0.0-beta.230

package/src/lib/components/marketing-insight-zones.js

@@ -0,0 +1,30 @@
+/**
+ * @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 { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useConsoleWidgetSlot } from "@aglyn/aglyn/app-utils/console-widget-slot-context";
+import { definePluginZone } from "@aglyn/aglyn/plugin-manager/plugin-zones";
+export const MARKETING_INSIGHTS_ZONE = definePluginZone('marketingInsights');
+/** The report's zone, drawn through the shell's renderer, or nothing outside the shell. */ export function MarketingInsightsZone(props) {
+    const Slot = useConsoleWidgetSlot();
+    return Slot ? /*#__PURE__*/ _jsx(Slot, _extends({
+        slot: MARKETING_INSIGHTS_ZONE.id
+    }, props)) : null;
+}
+MarketingInsightsZone.displayName = 'MarketingInsightsZone';
+
+//# sourceMappingURL=marketing-insight-zones.js.map

package/src/lib/components/marketing-insight-zones.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/components/marketing-insight-zones.tsx"],"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 { useConsoleWidgetSlot } from '@aglyn/aglyn/app-utils/console-widget-slot-context'\nimport { definePluginZone } from '@aglyn/aglyn/plugin-manager/plugin-zones'\n\n/**\n * The zone a marketing report hosts in its header (AGL-3603): the\n * Conversions section and one campaign's report.\n *\n * A widget here explains the figures the page shows, in words. It is handed\n * the site the figures are one site's — the site picked on the\n * organization's Conversions section, the site a campaign email was sent as —\n * and what the page is about, and nothing else: the figures it reads are the\n * ones this plugin publishes to other plugins as figure readers\n * (`server/marketing-figures.ts`), never this page's documents. There is\n * nothing to apply and nothing a widget may write.\n */\n\n/** What the report a widget sits on is about. */\nexport type MarketingInsightSubject = 'conversions' | 'campaign'\n\n/** What {@link MARKETING_INSIGHTS_ZONE} hands each widget. */\nexport interface MarketingInsightsZoneProps {\n  /** The site the figures are one site's; `null` when the page has none to name yet. */\n  hostId: string | null\n  subject: MarketingInsightSubject\n  /** One campaign's report: the subject line it is known by. `null` elsewhere. */\n  campaign: string | null\n}\n\nexport const MARKETING_INSIGHTS_ZONE =\n  definePluginZone<MarketingInsightsZoneProps>('marketingInsights')\n\n/** The report's zone, drawn through the shell's renderer, or nothing outside the shell. */\nexport function MarketingInsightsZone(props: MarketingInsightsZoneProps) {\n  const Slot = useConsoleWidgetSlot()\n  return Slot ? <Slot slot={MARKETING_INSIGHTS_ZONE.id} {...props} /> : null\n}\nMarketingInsightsZone.displayName = 'MarketingInsightsZone'\n"],"names":["useConsoleWidgetSlot","definePluginZone","MARKETING_INSIGHTS_ZONE","MarketingInsightsZone","props","Slot","slot","id","displayName"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;;AAEA,SAASA,oBAAoB,QAAQ,qDAAoD;AACzF,SAASC,gBAAgB,QAAQ,2CAA0C;AA2B3E,OAAO,MAAMC,0BACXD,iBAA6C,qBAAoB;AAEnE,yFAAyF,GACzF,OAAO,SAASE,sBAAsBC,KAAiC;IACrE,MAAMC,OAAOL;IACb,OAAOK,qBAAO,KAACA;QAAKC,MAAMJ,wBAAwBK,EAAE;OAAMH,UAAY;AACxE;AACAD,sBAAsBK,WAAW,GAAG"}

package/src/lib/components/overlay-zones.d.ts

@@ -0,0 +1,84 @@
+import type { OverlayCopyField, OverlayCopyProposal, OverlayPopupTrigger } from '../model/overlay-drafts';
+import type { HostOverlay } from '../model/overlays';
+/**
+ * The two zones the overlays list hosts (AGL-3603).
+ *
+ * The overlays — announcement bars and popups — are this plugin's: the
+ * documents, their schedule, their targeting and the order a visitor meets
+ * them in. A plugin that can WRITE copy for one may not be imported here, so
+ * the list hosts two positions and says what each hands a widget, drawn by the
+ * console shell's own renderer with every gate a console page's slot applies.
+ *
+ * ## A widget proposes; this plugin writes
+ *
+ * {@link HOST_OVERLAYS_ZONE}, beside New bar and New popup, hands a widget
+ * `createOverlayDraft`. The list cuts what it is handed to the overlay's own
+ * limits, writes it SWITCHED OFF through the same site-wide write a typed
+ * overlay takes, and opens it in the editor. A visitor sees nothing until a
+ * person turns it on.
+ *
+ * {@link OVERLAY_EDITOR_ZONE}, among the editor's fields, hands a widget the
+ * copy as the editor holds it and `proposeValues`, which fills the editor's
+ * own fields unsaved. The editor's Save is the only write.
+ */
+/** The limits and the trigger catalog a widget writes inside, as the list hands them over. */
+export interface MarketingOverlayRules {
+    limits: Readonly<Record<OverlayCopyField, number>>;
+    triggers: readonly OverlayPopupTrigger[];
+}
+/** What `createOverlayDraft` answers: the overlay it wrote, or why it wrote none. */
+export type MarketingOverlayDraftResult = {
+    ok: true;
+    id: string;
+} | {
+    ok: false;
+    error: string;
+};
+/** What {@link HOST_OVERLAYS_ZONE} hands each widget. */
+export interface MarketingHostOverlaysZoneProps extends MarketingOverlayRules {
+    hostId: string;
+    /**
+     * Writes a new overlay of `kind` from `proposal`, switched off, and opens it
+     * in the editor. Refused when the proposal has nothing the overlay needs —
+     * a bar's text, a popup's body — or when the write fails.
+     */
+    createOverlayDraft: (kind: HostOverlay['kind'], proposal: OverlayCopyProposal) => Promise<MarketingOverlayDraftResult>;
+}
+/** One overlay's copy as the editor holds it, as typed. */
+export interface MarketingOverlayEditorCopy {
+    name: string;
+    /** A bar's text. */
+    text: string;
+    headline: string;
+    body: string;
+    ctaLabel: string;
+    ctaHref: string;
+    trigger: string;
+    triggerValue: number | null;
+}
+/** What {@link OVERLAY_EDITOR_ZONE} hands each widget. */
+export interface MarketingOverlayEditorZoneProps extends MarketingOverlayRules {
+    hostId: string;
+    /** The overlay's id once it has been saved; empty while it is new. */
+    overlayId: string;
+    kind: HostOverlay['kind'];
+    copy: MarketingOverlayEditorCopy;
+    /**
+     * Fills the editor's fields with what a widget proposes, unsaved, cut to the
+     * limits; a trigger outside the catalog is ignored. `key` identifies the
+     * proposal so a widget can tell which of its own the editor is showing.
+     */
+    proposeValues: (proposal: OverlayCopyProposal, key: string) => void;
+}
+export declare const HOST_OVERLAYS_ZONE: import("@aglyn/aglyn/plugin-manager/plugin-zones").PluginZone<MarketingHostOverlaysZoneProps>;
+export declare const OVERLAY_EDITOR_ZONE: import("@aglyn/aglyn/plugin-manager/plugin-zones").PluginZone<MarketingOverlayEditorZoneProps>;
+/** The list's zone, drawn through the shell's renderer, or nothing outside the shell. */
+export declare function HostOverlaysZone(props: MarketingHostOverlaysZoneProps): import("react").JSX.Element;
+export declare namespace HostOverlaysZone {
+    var displayName: string;
+}
+/** The editor's zone, drawn through the shell's renderer, or nothing outside the shell. */
+export declare function OverlayEditorZone(props: MarketingOverlayEditorZoneProps): import("react").JSX.Element;
+export declare namespace OverlayEditorZone {
+    var displayName: string;
+}

package/src/lib/components/overlay-zones.js

@@ -0,0 +1,38 @@
+/**
+ * @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 { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useConsoleWidgetSlot } from "@aglyn/aglyn/app-utils/console-widget-slot-context";
+import { definePluginZone } from "@aglyn/aglyn/plugin-manager/plugin-zones";
+export const HOST_OVERLAYS_ZONE = definePluginZone('hostOverlays');
+export const OVERLAY_EDITOR_ZONE = definePluginZone('overlayEditor');
+/** The list's zone, drawn through the shell's renderer, or nothing outside the shell. */ export function HostOverlaysZone(props) {
+    const Slot = useConsoleWidgetSlot();
+    return Slot ? /*#__PURE__*/ _jsx(Slot, _extends({
+        slot: HOST_OVERLAYS_ZONE.id
+    }, props)) : null;
+}
+HostOverlaysZone.displayName = 'HostOverlaysZone';
+/** The editor's zone, drawn through the shell's renderer, or nothing outside the shell. */ export function OverlayEditorZone(props) {
+    const Slot = useConsoleWidgetSlot();
+    return Slot ? /*#__PURE__*/ _jsx(Slot, _extends({
+        slot: OVERLAY_EDITOR_ZONE.id
+    }, props)) : null;
+}
+OverlayEditorZone.displayName = 'OverlayEditorZone';
+
+//# sourceMappingURL=overlay-zones.js.map

package/src/lib/components/overlay-zones.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/components/overlay-zones.tsx"],"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 { useConsoleWidgetSlot } from '@aglyn/aglyn/app-utils/console-widget-slot-context'\nimport { definePluginZone } from '@aglyn/aglyn/plugin-manager/plugin-zones'\nimport type {\n  OverlayCopyField,\n  OverlayCopyProposal,\n  OverlayPopupTrigger,\n} from '../model/overlay-drafts'\nimport type { HostOverlay } from '../model/overlays'\n\n/**\n * The two zones the overlays list hosts (AGL-3603).\n *\n * The overlays — announcement bars and popups — are this plugin's: the\n * documents, their schedule, their targeting and the order a visitor meets\n * them in. A plugin that can WRITE copy for one may not be imported here, so\n * the list hosts two positions and says what each hands a widget, drawn by the\n * console shell's own renderer with every gate a console page's slot applies.\n *\n * ## A widget proposes; this plugin writes\n *\n * {@link HOST_OVERLAYS_ZONE}, beside New bar and New popup, hands a widget\n * `createOverlayDraft`. The list cuts what it is handed to the overlay's own\n * limits, writes it SWITCHED OFF through the same site-wide write a typed\n * overlay takes, and opens it in the editor. A visitor sees nothing until a\n * person turns it on.\n *\n * {@link OVERLAY_EDITOR_ZONE}, among the editor's fields, hands a widget the\n * copy as the editor holds it and `proposeValues`, which fills the editor's\n * own fields unsaved. The editor's Save is the only write.\n */\n\n/** The limits and the trigger catalog a widget writes inside, as the list hands them over. */\nexport interface MarketingOverlayRules {\n  limits: Readonly<Record<OverlayCopyField, number>>\n  triggers: readonly OverlayPopupTrigger[]\n}\n\n/** What `createOverlayDraft` answers: the overlay it wrote, or why it wrote none. */\nexport type MarketingOverlayDraftResult =\n  | { ok: true; id: string }\n  | { ok: false; error: string }\n\n/** What {@link HOST_OVERLAYS_ZONE} hands each widget. */\nexport interface MarketingHostOverlaysZoneProps extends MarketingOverlayRules {\n  hostId: string\n  /**\n   * Writes a new overlay of `kind` from `proposal`, switched off, and opens it\n   * in the editor. Refused when the proposal has nothing the overlay needs —\n   * a bar's text, a popup's body — or when the write fails.\n   */\n  createOverlayDraft: (\n    kind: HostOverlay['kind'],\n    proposal: OverlayCopyProposal,\n  ) => Promise<MarketingOverlayDraftResult>\n}\n\n/** One overlay's copy as the editor holds it, as typed. */\nexport interface MarketingOverlayEditorCopy {\n  name: string\n  /** A bar's text. */\n  text: string\n  headline: string\n  body: string\n  ctaLabel: string\n  ctaHref: string\n  trigger: string\n  triggerValue: number | null\n}\n\n/** What {@link OVERLAY_EDITOR_ZONE} hands each widget. */\nexport interface MarketingOverlayEditorZoneProps extends MarketingOverlayRules {\n  hostId: string\n  /** The overlay's id once it has been saved; empty while it is new. */\n  overlayId: string\n  kind: HostOverlay['kind']\n  copy: MarketingOverlayEditorCopy\n  /**\n   * Fills the editor's fields with what a widget proposes, unsaved, cut to the\n   * limits; a trigger outside the catalog is ignored. `key` identifies the\n   * proposal so a widget can tell which of its own the editor is showing.\n   */\n  proposeValues: (proposal: OverlayCopyProposal, key: string) => void\n}\n\nexport const HOST_OVERLAYS_ZONE =\n  definePluginZone<MarketingHostOverlaysZoneProps>('hostOverlays')\n\nexport const OVERLAY_EDITOR_ZONE =\n  definePluginZone<MarketingOverlayEditorZoneProps>('overlayEditor')\n\n/** The list's zone, drawn through the shell's renderer, or nothing outside the shell. */\nexport function HostOverlaysZone(props: MarketingHostOverlaysZoneProps) {\n  const Slot = useConsoleWidgetSlot()\n  return Slot ? <Slot slot={HOST_OVERLAYS_ZONE.id} {...props} /> : null\n}\nHostOverlaysZone.displayName = 'HostOverlaysZone'\n\n/** The editor's zone, drawn through the shell's renderer, or nothing outside the shell. */\nexport function OverlayEditorZone(props: MarketingOverlayEditorZoneProps) {\n  const Slot = useConsoleWidgetSlot()\n  return Slot ? <Slot slot={OVERLAY_EDITOR_ZONE.id} {...props} /> : null\n}\nOverlayEditorZone.displayName = 'OverlayEditorZone'\n"],"names":["useConsoleWidgetSlot","definePluginZone","HOST_OVERLAYS_ZONE","OVERLAY_EDITOR_ZONE","HostOverlaysZone","props","Slot","slot","id","displayName","OverlayEditorZone"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;;AAEA,SAASA,oBAAoB,QAAQ,qDAAoD;AACzF,SAASC,gBAAgB,QAAQ,2CAA0C;AAmF3E,OAAO,MAAMC,qBACXD,iBAAiD,gBAAe;AAElE,OAAO,MAAME,sBACXF,iBAAkD,iBAAgB;AAEpE,uFAAuF,GACvF,OAAO,SAASG,iBAAiBC,KAAqC;IACpE,MAAMC,OAAON;IACb,OAAOM,qBAAO,KAACA;QAAKC,MAAML,mBAAmBM,EAAE;OAAMH,UAAY;AACnE;AACAD,iBAAiBK,WAAW,GAAG;AAE/B,yFAAyF,GACzF,OAAO,SAASC,kBAAkBL,KAAsC;IACtE,MAAMC,OAAON;IACb,OAAOM,qBAAO,KAACA;QAAKC,MAAMJ,oBAAoBK,EAAE;OAAMH,UAAY;AACpE;AACAK,kBAAkBD,WAAW,GAAG"}

package/src/lib/components/site-runtime.js

@@ -18,7 +18,8 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import * as Aglyn from "@aglyn/aglyn";
 import { sendAnalyticsBeacon } from "@aglyn/aglyn/app-utils/analytics-beacon";
-import { trackAuthoredEvent, trackEvent } from "@aglyn/aglyn/app-utils/analytics-events";
+import { resolveAuthoredEventName, trackAuthoredEvent, trackEvent } from "@aglyn/aglyn/app-utils/analytics-events";
+import { recordSiteJourneyStep } from "@aglyn/aglyn/app-utils/site-journey";
 import { claimFirstCampaignTouch, notePageCampaigns, utmTouchField, whenUtmTouchConsentSettles } from "@aglyn/aglyn/app-utils/utm-touch";
 import { useEffect, useRef, useState } from "react";
 import * as MarketingModel from "../model/index.js";
@@ -38,6 +39,10 @@ import * as MarketingModel from "../model/index.js";
     }, overlayId ? {
         overlayId
     } : {}));
+    // A funnel step (AGL-3605): a click on a bar or popup, by the overlay.
+    if (overlay === 'barClick' || overlay === 'popupClick') {
+        recordSiteJourneyStep('overlay', overlayId);
+    }
     // GA mirror (wave v8): sites with Analytics configured see overlay
     // engagement in their own property; no-op without gtag.
     //
@@ -378,6 +383,10 @@ import * as MarketingModel from "../model/index.js";
                         // shared sanitizer and the reserved-name refusal like everything
                         // else, never raw gtag.
                         trackAuthoredEvent(step.eventName, step.params);
+                        // A funnel step (AGL-3605), under the name GA would receive; a
+                        // name GA would refuse is no step either.
+                        const journeyEvent = resolveAuthoredEventName(step.eventName).name;
+                        if (journeyEvent) recordSiteJourneyStep('event', journeyEvent);
                     } else if (step.type === 'siteAlert') {
                         var _step_message, _step_severity;
                         showToast(String((_step_message = step.message) != null ? _step_message : '').slice(0, 300), (_step_severity = step.severity) != null ? _step_severity : 'info');