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

package/src/lib/components/record-attribution-widget.d.ts

@@ -27,6 +27,11 @@ export interface RecordAttributionWidgetProps {
     hostId?: string | null;
     recordKind?: string;
     recordId?: string;
+    /**
+     * The campaigns the host's record is filed under, when the host knows them
+     * (AGL-3461) — the Inbox hands a submission's form and page campaigns.
+     */
+    filedUnder?: readonly string[];
 }
 export declare function RecordAttributionWidget(props: RecordAttributionWidgetProps): import("react").JSX.Element;
 export declare namespace RecordAttributionWidget {

package/src/lib/components/record-attribution-widget.js

@@ -14,18 +14,21 @@
  * 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 { CAMPAIGN_CONVERSION_KINDS } from "../model/campaign-conversions.js";
 import ConversionAttribution from "./conversion-attribution.component.js";
 const isConversionKind = (kind)=>CAMPAIGN_CONVERSION_KINDS.includes(kind);
 export function RecordAttributionWidget(props) {
-    const { hostId, recordKind, recordId } = props;
+    const { hostId, recordKind, recordId, filedUnder } = props;
     if (!hostId || !recordId || !isConversionKind(recordKind)) return null;
-    return /*#__PURE__*/ _jsx(ConversionAttribution, {
+    return /*#__PURE__*/ _jsx(ConversionAttribution, _extends({
         hostId: hostId,
         kind: recordKind,
         refId: recordId
-    });
+    }, Array.isArray(filedUnder) && filedUnder.length ? {
+        filedUnder
+    } : {}));
 }
 RecordAttributionWidget.displayName = 'RecordAttributionWidget';
 export default RecordAttributionWidget;

package/src/lib/components/record-attribution-widget.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/components/record-attribution-widget.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\n'use client'\n\nimport {\n  CAMPAIGN_CONVERSION_KINDS,\n  type CampaignConversionKind,\n} from '../model/campaign-conversions'\nimport ConversionAttribution from './conversion-attribution.component'\n\n/**\n * The widget this plugin draws in another plugin's record-attribution zone.\n *\n * The CRM and the Inbox each host a zone on a record and hand it\n * `{ hostId, recordKind, recordId }` in their own words. Those words are the\n * identify moments this plugin credits a conversion at, so the widget reads\n * the kind as one — and draws nothing for a kind it never credits, rather\n * than reading a document that cannot exist.\n */\nexport interface RecordAttributionWidgetProps {\n  hostId?: string | null\n  recordKind?: string\n  recordId?: string\n}\n\nconst isConversionKind = (kind: unknown): kind is CampaignConversionKind =>\n  (CAMPAIGN_CONVERSION_KINDS as readonly unknown[]).includes(kind)\n\nexport function RecordAttributionWidget(props: RecordAttributionWidgetProps) {\n  const { hostId, recordKind, recordId } = props\n  if (!hostId || !recordId || !isConversionKind(recordKind)) return null\n  return <ConversionAttribution hostId={hostId} kind={recordKind} refId={recordId} />\n}\nRecordAttributionWidget.displayName = 'RecordAttributionWidget'\n\nexport default RecordAttributionWidget\n"],"names":["CAMPAIGN_CONVERSION_KINDS","ConversionAttribution","isConversionKind","kind","includes","RecordAttributionWidget","props","hostId","recordKind","recordId","refId","displayName"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;AAEA,SACEA,yBAAyB,QAEpB,mCAA+B;AACtC,OAAOC,2BAA2B,wCAAoC;AAiBtE,MAAMC,mBAAmB,CAACC,OACxB,AAACH,0BAAiDI,QAAQ,CAACD;AAE7D,OAAO,SAASE,wBAAwBC,KAAmC;IACzE,MAAM,EAAEC,MAAM,EAAEC,UAAU,EAAEC,QAAQ,EAAE,GAAGH;IACzC,IAAI,CAACC,UAAU,CAACE,YAAY,CAACP,iBAAiBM,aAAa,OAAO;IAClE,qBAAO,KAACP;QAAsBM,QAAQA;QAAQJ,MAAMK;QAAYE,OAAOD;;AACzE;AACAJ,wBAAwBM,WAAW,GAAG;AAEtC,eAAeN,wBAAuB"}
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/components/record-attribution-widget.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\n'use client'\n\nimport {\n  CAMPAIGN_CONVERSION_KINDS,\n  type CampaignConversionKind,\n} from '../model/campaign-conversions'\nimport ConversionAttribution from './conversion-attribution.component'\n\n/**\n * The widget this plugin draws in another plugin's record-attribution zone.\n *\n * The CRM and the Inbox each host a zone on a record and hand it\n * `{ hostId, recordKind, recordId }` in their own words. Those words are the\n * identify moments this plugin credits a conversion at, so the widget reads\n * the kind as one — and draws nothing for a kind it never credits, rather\n * than reading a document that cannot exist.\n */\nexport interface RecordAttributionWidgetProps {\n  hostId?: string | null\n  recordKind?: string\n  recordId?: string\n  /**\n   * The campaigns the host's record is filed under, when the host knows them\n   * (AGL-3461) — the Inbox hands a submission's form and page campaigns.\n   */\n  filedUnder?: readonly string[]\n}\n\nconst isConversionKind = (kind: unknown): kind is CampaignConversionKind =>\n  (CAMPAIGN_CONVERSION_KINDS as readonly unknown[]).includes(kind)\n\nexport function RecordAttributionWidget(props: RecordAttributionWidgetProps) {\n  const { hostId, recordKind, recordId, filedUnder } = props\n  if (!hostId || !recordId || !isConversionKind(recordKind)) return null\n  return (\n    <ConversionAttribution\n      hostId={hostId}\n      kind={recordKind}\n      refId={recordId}\n      {...(Array.isArray(filedUnder) && filedUnder.length ? { filedUnder } : {})}\n    />\n  )\n}\nRecordAttributionWidget.displayName = 'RecordAttributionWidget'\n\nexport default RecordAttributionWidget\n"],"names":["CAMPAIGN_CONVERSION_KINDS","ConversionAttribution","isConversionKind","kind","includes","RecordAttributionWidget","props","hostId","recordKind","recordId","filedUnder","refId","Array","isArray","length","displayName"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;AAEA,SACEA,yBAAyB,QAEpB,mCAA+B;AACtC,OAAOC,2BAA2B,wCAAoC;AAsBtE,MAAMC,mBAAmB,CAACC,OACxB,AAACH,0BAAiDI,QAAQ,CAACD;AAE7D,OAAO,SAASE,wBAAwBC,KAAmC;IACzE,MAAM,EAAEC,MAAM,EAAEC,UAAU,EAAEC,QAAQ,EAAEC,UAAU,EAAE,GAAGJ;IACrD,IAAI,CAACC,UAAU,CAACE,YAAY,CAACP,iBAAiBM,aAAa,OAAO;IAClE,qBACE,KAACP;QACCM,QAAQA;QACRJ,MAAMK;QACNG,OAAOF;OACFG,MAAMC,OAAO,CAACH,eAAeA,WAAWI,MAAM,GAAG;QAAEJ;IAAW,IAAI,CAAC;AAG9E;AACAL,wBAAwBU,WAAW,GAAG;AAEtC,eAAeV,wBAAuB"}

package/src/lib/components/site-runtime.d.ts

@@ -1,4 +1,9 @@
 import type { SiteRuntimeProps } from '@aglyn/aglyn';
+/** The page-props slice the server enricher writes for a page filed under a campaign. */
+export interface CampaignPageData {
+    screenId: string;
+    campaignIds: string[];
+}
 /**
  * The marketing plugin's site runtime (AGL-419), relocated verbatim from
  * the tenant catch-all: announcement bar + popup rendering (AGL-195/200),

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

@@ -19,7 +19,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 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 { utmTouchField } from "@aglyn/aglyn/app-utils/utm-touch";
+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";
 /**
@@ -886,7 +886,9 @@ function AnnouncementBar(props) {
                 }),
                 popup.imageUrl && !Aglyn.isRefusedAuthorImageSrc(popup.imageUrl) ? // eslint-disable-next-line @next/next/no-img-element
                 /*#__PURE__*/ _jsx("img", {
-                    src: popup.imageUrl,
+                    src: Aglyn.siteRelativeMediaSrc(popup.imageUrl, {
+                        hostId
+                    }),
                     // AGL-1896. This was a hardcoded `alt=""` with no field behind
                     // it. Still empty when the author left it empty — a decorative
                     // banner beside its own headline is the case `alt=""` exists for
@@ -1015,6 +1017,100 @@ function AnnouncementBar(props) {
         })
     });
 }
+/**
+ * Pageviews already reported to their campaigns, keyed by host and address.
+ * Module scope for the reason the pageview beacon's guard is: a page remounts
+ * on its own, and a remount is not a second visit.
+ */ const campaignVisitsReported = new Set();
+/**
+ * How long the visit report waits for the visitor's storage consent to
+ * settle before it reports the view alone. Long enough for the region check
+ * a consent posture runs on load; short enough that a stalled one still
+ * counts the page view.
+ */ const CAMPAIGN_VISIT_CONSENT_WAIT_MS = 10000;
+/**
+ * A PAGE FILED UNDER A CAMPAIGN IS A CAMPAIGN TOUCH (AGL-3461).
+ *
+ * On every pageview this tells the core which campaigns the page is filed
+ * under — the touch every conversion door on the page then reports, live and
+ * with nothing written, and the one the device remembers under the visitor's
+ * analytics grant (`utm-touch.ts`). A page filed under nothing clears the
+ * live touch and keeps the remembered one.
+ *
+ * And it reports the visit to each campaign through the site collector's
+ * `campaignVisit` beacon: a view of the campaign's page, and — when this is
+ * the device's first campaign touch in the window — a first visit. A link
+ * carrying a `utm_campaign` label is a touch too, credited as a first visit
+ * to the campaign that declares it; the server answers which one. The
+ * first-touch claim waits for consent to settle, because asked before it an
+ * unresolved state would read as "may not remember", and the view would be
+ * counted as nobody's first.
+ *
+ * Renders nothing.
+ */ function CampaignPageTouch(props) {
+    var _ref, _ref1;
+    const { hostId, campaignPage } = props;
+    const screenId = (_ref = campaignPage == null ? void 0 : campaignPage.screenId) != null ? _ref : '';
+    const idsKey = ((_ref1 = campaignPage == null ? void 0 : campaignPage.campaignIds) != null ? _ref1 : []).join(',');
+    useEffect(()=>{
+        var _get;
+        if (typeof window === 'undefined') return undefined;
+        const ids = idsKey ? idsKey.split(',') : [];
+        notePageCampaigns(ids.length ? {
+            screenId,
+            containerIds: ids,
+            path: window.location.pathname
+        } : null);
+        if (!hostId) return undefined;
+        const label = ((_get = new URLSearchParams(window.location.search).get('utm_campaign')) != null ? _get : '').trim().toLowerCase().slice(0, 100);
+        if (!ids.length && !label) return undefined;
+        const visitKey = `${hostId}\x00${window.location.pathname}${window.location.search}`;
+        if (campaignVisitsReported.has(visitKey)) return undefined;
+        let done = false;
+        const report = (allowed)=>{
+            if (done) return;
+            done = true;
+            campaignVisitsReported.add(visitKey);
+            const claimed = allowed ? claimFirstCampaignTouch([
+                ...ids.map((id)=>`c:${id}`),
+                ...label ? [
+                    `u:${label}`
+                ] : []
+            ]) : [];
+            const first = claimed.filter((key)=>key.startsWith('c:')).map((key)=>key.slice(2));
+            const firstLabel = Boolean(label) && claimed.includes(`u:${label}`);
+            // A label arrival on a page filed under nothing is only a first visit;
+            // with nothing first about it there is nothing to count.
+            if (!ids.length && !firstLabel) return;
+            sendAnalyticsBeacon(_extends({
+                hostId,
+                campaignVisit: '1'
+            }, ids.length ? {
+                screenId,
+                campaignIds: ids
+            } : {}, first.length ? {
+                first
+            } : {}, firstLabel ? {
+                utmCampaign: label,
+                firstLabel: true
+            } : {}));
+        };
+        const withdraw = whenUtmTouchConsentSettles(report);
+        const timer = window.setTimeout(()=>{
+            withdraw();
+            report(false);
+        }, CAMPAIGN_VISIT_CONSENT_WAIT_MS);
+        return ()=>{
+            withdraw();
+            window.clearTimeout(timer);
+        };
+    }, [
+        hostId,
+        screenId,
+        idsKey
+    ]);
+    return null;
+}
 /**
  * The marketing plugin's site runtime (AGL-419), relocated verbatim from
  * the tenant catch-all: announcement bar + popup rendering (AGL-195/200),
@@ -1022,7 +1118,7 @@ function AnnouncementBar(props) {
  * (AGL-256/257), and automation-triggered overlays. Reads back exactly the
  * page-props slices its server enricher wrote (site-contract shapes).
  */ export function MarketingSiteRuntime({ hostId, screens, page }) {
-    var _page_experiments, _page_clientAutomations, _automationOverlay_popup_frequencyDays;
+    var _page_experiments, _page_clientAutomations, _page_campaignPage, _automationOverlay_popup_frequencyDays;
     var _page_data, _automationOverlay_bar, _automationOverlay_popup;
     const [automationOverlay, setAutomationOverlay] = useState(null);
     const announcementBar = page['announcementBar'];
@@ -1030,8 +1126,13 @@ function AnnouncementBar(props) {
     const experiments = (_page_experiments = page['experiments']) != null ? _page_experiments : [];
     const clientAutomations = (_page_clientAutomations = page['clientAutomations']) != null ? _page_clientAutomations : [];
     const automationOverlays = page['automationOverlays'];
+    const campaignPage = (_page_campaignPage = page['campaignPage']) != null ? _page_campaignPage : null;
     return /*#__PURE__*/ _jsxs(_Fragment, {
         children: [
+            /*#__PURE__*/ _jsx(CampaignPageTouch, {
+                hostId: hostId,
+                campaignPage: campaignPage
+            }),
             announcementBar ? /*#__PURE__*/ _jsx(AnnouncementBar, {
                 bar: announcementBar,
                 hostId: hostId