@tokenoftrust/storefront-runner 2.0.29 → 2.0.30

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tokenoftrust/storefront-runner",
-  "version": "2.0.29",
+  "version": "2.0.30",
   "license": "SEE LICENSE IN LICENSE",
   "description": "World-shareable storefront runner: multi-tenant renderer on Astro/Cloudflare. No control plane.",
   "packageManager": "pnpm@11.9.0",

package/packages/public-runtime/src/integration/contact-sales-action-source.ts

@@ -0,0 +1,75 @@
+/**
+ * The platform-owned browser binding for the two reviewed contact-sales CTAs.
+ *
+ * This is deliberately not a general interaction adapter. Both DOM identifiers and
+ * the emitted semantic name are fixed below; the source reads no labels, URLs,
+ * selectors supplied by a caller, event detail, or arbitrary DOM data.
+ */
+import type { PlatformManagedActionActivation, PlatformManagedActionSource } from "./managed-analytics-bridge.js";
+
+/** The only reviewed CTA identities that may raise this marketing action. */
+export const CONTACT_SALES_ACTION_SOURCES = [
+  { ctaId: "cta-book-demo", logicalId: "contact-sales-book-demo" },
+  { ctaId: "contact-sales", logicalId: "contact-sales-lower" },
+] as const;
+
+const CONTACT_SALES_ACTION_NAME = "user_clicked_contact_sales_mktg" as const;
+const CORRELATION_TTL_MS = 60 * 60 * 1000;
+
+export interface ContactSalesActionElement {
+  addEventListener(type: "click", listener: () => void): void;
+  removeEventListener(type: "click", listener: () => void): void;
+}
+
+/** The narrow DOM seam used only to find the two fixed platform CTA identities. */
+export interface ContactSalesActionDocument {
+  querySelectorAll(selector: string): ArrayLike<ContactSalesActionElement>;
+}
+
+export interface ContactSalesActionSourceOptions {
+  document?: ContactSalesActionDocument;
+  planRevision: string;
+  now?: () => number;
+}
+
+/**
+ * Bind literal `data-cta-id` values to a typed source for the managed-analytics
+ * bridge. A keyboard activation of an anchor/button produces its native `click`, so
+ * it follows this same semantic path without a separate key listener.
+ */
+export function createContactSalesActionSource(
+  options: ContactSalesActionSourceOptions,
+): PlatformManagedActionSource {
+  const document = options.document;
+  const now = options.now ?? Date.now;
+  let sequence = 0;
+
+  return {
+    subscribe(listener) {
+      if (!document || typeof document.querySelectorAll !== "function") return () => {};
+      const removals: Array<() => void> = [];
+      for (const source of CONTACT_SALES_ACTION_SOURCES) {
+        const nodes = document.querySelectorAll(`[data-cta-id="${source.ctaId}"]`);
+        for (const node of Array.from(nodes)) {
+          const emit = (): void => {
+            sequence += 1;
+            const at = now();
+            const activation: PlatformManagedActionActivation = {
+              logicalId: `${source.logicalId}-${options.planRevision}-${sequence}`,
+              name: CONTACT_SALES_ACTION_NAME,
+              correlation: {
+                id: `contact-sales-${options.planRevision}`,
+                expiresAt: new Date(at + CORRELATION_TTL_MS).toISOString(),
+              },
+              sequence,
+            };
+            listener(activation);
+          };
+          node.addEventListener("click", emit);
+          removals.push(() => node.removeEventListener("click", emit));
+        }
+      }
+      return () => removals.splice(0).forEach((remove) => remove());
+    },
+  };
+}

package/packages/public-runtime/src/integration/index.ts

@@ -76,6 +76,7 @@ export * from "./events-catalog.js";
 export * from "./commerce-broker.js";
 export * from "./managed-analytics.js";
 export * from "./managed-analytics-bridge.js";
+export * from "./contact-sales-action-source.js";
 export * from "./g2-action-boundary.js";
 export * from "./correlation-token.js";
 export * from "./order-conversion.js";

package/packages/public-runtime/src/integration/lifecycle-boot.ts

@@ -45,6 +45,10 @@ import { validateBrowserEnvironment, BROWSER_ENVIRONMENT_GLOBAL, type BrowserEnv
 import { makePlatformAdapterRuntimeLoader } from "./platform-adapter-runtime.js";
 import { ManagedAnalyticsEventBrokerBridge } from "./managed-analytics-bridge.js";
 import { minimizePageAttribution, type ManagedPageViewInput } from "./managed-analytics.js";
+import {
+  createContactSalesActionSource,
+  type ContactSalesActionDocument,
+} from "./contact-sales-action-source.js";
 
 /** The window property holding the single per-document lifecycle (idempotent boot guard). */
 export const LIFECYCLE_SINGLETON_GLOBAL = "__TOT_INTEGRATION_LIFECYCLE__";
@@ -68,7 +72,7 @@ export interface LifecycleWindow {
    * analytics data allowlist accepts no other document state — no title, no DOM, no
    * globals — so this is deliberately the narrowest slice that supports attribution.
    */
-  document?: { referrer?: string };
+  document?: { referrer?: string; querySelectorAll?: ContactSalesActionDocument["querySelectorAll"] };
   [key: string]: unknown;
 }
 
@@ -337,7 +341,16 @@ export function bootIntegrationLifecycle(
     commerceBroker,
     managedAnalytics: {
       bridge: options.managedAnalyticsBridge ??
-        new ManagedAnalyticsEventBrokerBridge({ broker: commerceBroker }),
+        new ManagedAnalyticsEventBrokerBridge({
+          broker: commerceBroker,
+          actionSource: createContactSalesActionSource({
+            document: typeof win.document?.querySelectorAll === "function"
+              ? win.document as ContactSalesActionDocument
+              : undefined,
+            planRevision: descriptor.planRevision,
+            now: options.now ?? Date.now,
+          }),
+        }),
       pageView: () => documentPageView(win, descriptor, options.now ?? Date.now),
     },
   });