@bacano/sdk 1.1.19 → 1.2.1

package/STOREFRONT_FORMS.md

@@ -1,5 +1,12 @@
 # Formularios de websites
 
+Desde SDK 1.2.0, `BacanoForm` instrumenta interacciones mediante el provider
+global de marketing. Para modales montados ocultos, pasar `visible={open}`.
+Renderers personalizados usan `useBacanoFormTracking`. Leer la sección de
+interacciones en [STOREFRONT_MARKETING.md](./STOREFRONT_MARKETING.md) y los
+[ejemplos de migración](./skills/bacano-web/references/interactions.md).
+No añadir un segundo listener ni convertir aperturas en leads.
+
 Los formularios públicos de Bacano son definiciones tipadas y versionadas. El
 storefront decide dónde se muestran y cómo lucen; Bacano controla su estructura,
 estado y validaciones. La definición nunca contiene HTML ni JavaScript arbitrario.
@@ -35,6 +42,57 @@ idempotente estable y llama `client.forms.submitResponse(...)`. Un formulario
 pausado muestra su mensaje de indisponibilidad y deja de operar sin reconstruir
 el storefront.
 
+## Preseleccionar desde un botón externo
+
+Usa `values` y `onValuesChange` juntos para controlar el estado. El botón mezcla
+solo el campo que cambia: no reemplaces todo el objeto ni desmontes el formulario
+para preseleccionar. El visitante puede seguir editando cualquier campo.
+
+```tsx
+import { useRef, useState } from "react";
+import { BacanoForm, type BacanoFormValues } from "@bacano/sdk/react/forms";
+
+export function ProjectInquiry() {
+  const [values, setValues] = useState<BacanoFormValues>({});
+  const sectionRef = useRef<HTMLElement>(null);
+
+  return (
+    <>
+      <button
+        type="button"
+        onClick={() => {
+          setValues((current) => ({ ...current, producto: "gaia" }));
+          sectionRef.current?.scrollIntoView({ behavior: "smooth", block: "start" });
+        }}
+      >
+        Me interesa Gaia
+      </button>
+      <section ref={sectionRef}>
+        <BacanoForm
+          formKey="contacto"
+          values={values}
+          onValuesChange={setValues}
+        />
+      </section>
+    </>
+  );
+}
+```
+
+- `producto` debe ser la key real del campo publicado y `gaia` el `value`
+  real de la opción, no su label. Usa `string[]` para `multi_select` y booleanos
+  para `checkbox`. Las validaciones publicadas siguen aplicándose.
+- Puedes inicializar `useState` con la preselección, incluso antes de cargar
+  la definición. Un cambio externo no reinicia los pasos ni los otros campos.
+- `onValuesChange` entrega el objeto completo tras cada edición del visitante;
+  los cambios externos se hacen sobre el estado del componente padre.
+- Las keys ajenas a la definición publicada no se envían. Si compartes un
+  componente entre distintos sitios o formularios, reinicia su estado al cambiar
+  de identidad; no reutilices los datos de un visitante entre formularios.
+- Sin `onSubmit` se mantiene el envío oficial, incluyendo la selección. No
+  necesitas otro endpoint, eventos DOM ni un formulario paralelo.
+- Omitir ambas props conserva el funcionamiento anterior, con estado interno.
+
 ## Estructura del formulario
 
 La definición tiene tres niveles explícitos:

package/STOREFRONT_MARKETING.md

@@ -120,8 +120,6 @@ Valores de `contactPlacement`:
 - `header`
 - `footer`
 - `contact_page`
-- `checkout`
-- `other` únicamente cuando ninguna ubicación canónica describe el contacto
 
 El campo es opcional, no acepta textos visibles ni valores libres y el runtime
 lo ignora cuando el evento no es `contact`. Una ubicación nueva debe añadirse
@@ -276,9 +274,9 @@ Antes de declarar un storefront listo:
 ## Checklist corto para agentes
 
 - [ ] Leí este contrato antes de instrumentar.
-- [ ] Uso únicamente `useMarketing().track()`.
+- [ ] Uso el runtime oficial mediante `track`, `useBacanoCta` y los formularios oficiales.
 - [ ] Uso `product_variant_id` como `itemId`.
-- [ ] Emito eventos después del éxito, no antes.
+- [ ] Cada evento representa su hecho: un intento no se presenta como éxito.
 - [ ] Instrumenté todos los contactos con método y ubicación.
 - [ ] Los contactos de producto incluyen item, cantidad y valor.
 - [ ] No emito conversiones autoritativas desde el navegador.
@@ -289,3 +287,104 @@ Antes de declarar un storefront listo:
 La guía de gobierno, persistencia y eventos autoritativos vive en
 `docs/websites/MARKETING_MEASUREMENT_STOREFRONTS_CHECKLIST.md` dentro del
 repositorio Bacano. Este archivo es el contrato distribuible para storefronts.
+
+## Interacciones y formularios — SDK 1.2.0
+
+Aplicable también a webs informativas y de servicios. No exige checkout ni
+configurar un proveedor ausente. Esta versión agrega instrumentación; no crea
+un dashboard de embudos dentro de Bacano ni publica configuraciones remotas.
+
+| Evento Bacano | GA4 | Meta | Clarity | Propietario y condición |
+| --- | --- | --- | --- | --- |
+| `cta_click` | `cta_click` | personalizado `cta_click` | `cta_click` | CTA pulsado, no hover |
+| `form_open` | `form_open` | personalizado `form_open` | `form_open` | Formulario pasa a estar presentado; no implica inicio |
+| `form_start` | `form_start` | personalizado `form_start` | `form_start` | Primera respuesta introducida/seleccionada por la persona |
+| `form_step_complete` | `form_step_complete` | personalizado `form_step_complete` | `form_step_complete` | Paso validado y avance, una vez por paso/diligenciamiento |
+| `form_submit_attempt` | `form_submit_attempt` | personalizado `form_submit_attempt` | `form_submit_attempt` | Intento de envío final, incluso si la validación lo rechaza |
+| `form_submit_error` | `form_submit_error` | personalizado `form_submit_error` | `form_submit_error` | Fallo de ese intento; categoría segura |
+| `form_submit_success` | `form_submit_success` | personalizado `form_submit_success` | `form_submit_success` | Resultado oficial `accepted: true` y UUID de respuesta |
+
+GA4 y Meta reciben solamente `form_key`, `cta_id`, `placement`, `step_key`
+cuando corresponden y `error_category` para errores. Los identificadores son
+técnicos, estables, 1–64 caracteres, patrón `[a-z][a-z0-9_-]*`; no labels,
+respuestas, emails ni teléfonos. `cta_click` exige `ctaId`; los eventos de
+formulario exigen `formKey`; completar un paso exige `stepKey`. Categorías:
+`validation`, `network`, `rejected`, `unavailable`. Parámetros inválidos
+rechazan el evento completo. Clarity recibe solo el nombre, no esos parámetros.
+GA4 recibe además URL saneada, `event_id`, destino explícito y debug según
+configuración. Meta recibe la misma identidad mediante `eventID`, dirigida
+solo al píxel configurado, no a todos los píxeles de la página.
+
+`BacanoForm` instrumenta apertura, primera edición, pasos, intento y resultado.
+Un formulario montado dentro de un contenedor oculto necesita `visible={open}`;
+no se intenta adivinar CSS o extraer textos del DOM. Siempre visible significa
+presentado en la página, no una impresión garantizada dentro del viewport.
+Los cambios programáticos de `values` no cuentan como primera edición.
+Un renderer personalizado usa `useBacanoFormTracking` y conserva su propia UI.
+Los CTA usan `useBacanoCta`; no instrumentar el mismo clic también con `track`.
+Ver [ejemplos y migración](./skills/bacano-web/references/interactions.md).
+
+### Persistencia, antispam y conversiones
+
+`accepted: true, responseId: null` conserva el mensaje genérico de aceptación,
+pero **no** emite éxito. No revelar el motivo al visitante. Un `onSubmit`
+personalizado que devuelve `void` conserva su comportamiento visual, pero no
+demuestra persistencia para medición; devolver el resultado de
+`client.forms.submitResponse()` cuando se usa ese flujo.
+
+Una respuesta guardada no prueba que se haya creado un lead nuevo. Esta
+integración **no emite `generate_lead` ni `Lead`**, tampoco para `CAPTURE_LEAD`:
+la resolución de identidad pertenece al backend y su resultado no forma parte
+del contrato público. Una futura conversión autoritativa debe definirse ahí,
+con identidad compartida si se envía también por navegador; no inferirla de
+este evento de interacción. No duplicar la captura del lead por campaña.
+
+### Deduplicación y atribución
+
+- El runtime descarta repeticiones de `(eventName, eventId)` entre sus últimas
+  1.000 identidades. No es una garantía entre recargas ni un acuse del proveedor.
+- CTA: el helper agrupa doble clic del mismo botón dentro de 400 ms, sin
+  impedir su acción. Un clic posterior es legítimo y recibe otra identidad.
+- Cerrar/reabrir genera otra apertura; no otro inicio mientras el formulario
+  permanezca montado. Desmontar/montar inicia otro diligenciamiento. Un render
+  o la repetición de efectos de Strict Mode no equivalen a reabrir.
+- Un envío pendiente no acepta otro simultáneo. Un reintento tras error genera
+  otro intento analítico, pero conserva la `idempotencyKey` de persistencia.
+  Éxito usa el UUID de respuesta para no duplicarlo dentro del runtime.
+- Se reutiliza la atribución existente: `utm_content` se conserva como
+  `content`, junto a las demás UTM. Cada interacción recaptura la ubicación
+  usando ese mismo almacenamiento; navegación sin UTM no borra el origen.
+  No se copian click IDs de un proveedor a parámetros personalizados de otro.
+- Las respuestas conservan atribución en Bacano; CTA/aperturas se envían a los
+  proveedores, no se guardan como una secuencia propia en Bacano. No prometer
+  seguimiento completo entre dispositivos, navegadores o bloqueadores.
+
+GA4 puede medir formularios automáticamente. Al adoptar este contrato, revisar
+y desactivar **Form interactions** de Enhanced Measurement para que `form_start`
+no tenga dos propietarios. El SDK no cambia esa configuración de la cuenta.
+No tratar el `form_submit` automático como evidencia de guardado.
+[Referencia oficial de GA4](https://support.google.com/analytics/answer/9216061?hl=en).
+
+### Privacidad y diagnóstico
+
+El único `BacanoMarketingProvider` acepta `measurementAllowed={false}` cuando
+el gestor de consentimiento del sitio todavía no permite medir. No carga
+scripts, no captura atribución nueva ni emite eventos en ese estado. Este
+interruptor no sustituye el gestor de consentimiento, no borra almacenamiento
+previo ni descarga scripts de terceros que ya estaban cargados. Tampoco
+autoriza publicidad por el hecho de aceptar términos de compra.
+
+Config desactivada, dominio distinto, preview o proveedores ausentes son no-op.
+Diagnósticos: `MARKETING_DISABLED`, `MEASUREMENT_NOT_ALLOWED`,
+`DOMAIN_NOT_ALLOWED`, `PROVIDER_NOT_CONFIGURED`, `PREVIEW_DISABLED`,
+`PUBLIC_CONFIG_UNAVAILABLE`, `INVALID_INTERACTION`, `INVALID_EVENT`,
+`SCRIPT_LOAD_FAILED`, `EVENT_DISPATCH_FAILED`, `EVENT_DISPATCHED`.
+Un fallo de descarga no permite distinguir por sí solo bloqueador, CSP o red.
+`EVENT_DISPATCHED` significa únicamente pasado al adaptador; no recepción
+externa. Ni un callback de diagnóstico que falle puede bloquear el formulario.
+
+No incluir PII en rutas ni en valores UTM: sanear una URL no identifica toda la
+información personal que el sitio pudiera introducir en su ruta. No evadir
+Core Setup/Protected Data Mode o consentimiento mediante campos alternativos.
+La coherencia entre píxel y CAPI se revisa del lado Bacano; no exponer tokens
+ni inventar un segundo destino público para intentar corregirla en el sitio.

package/index.cjs

@@ -2957,6 +2957,9 @@ var ALLOWED_MARKETING_PARAMETERS = /* @__PURE__ */ new Set([
 function sanitizeMarketingUrl(input, baseUrl) {
   try {
     const url = new URL(input, baseUrl);
+    if (url.protocol !== "http:" && url.protocol !== "https:") return "";
+    url.username = "";
+    url.password = "";
     const safeParameters = new URLSearchParams();
     for (const [key, value] of url.searchParams.entries()) {
       if (ALLOWED_MARKETING_PARAMETERS.has(key.toLowerCase()) && !SENSITIVE_PARAMETER_PATTERNS.some((pattern) => pattern.test(key))) {
@@ -5732,50 +5735,65 @@ function createContentModule(graphqlUrl, getHeaders, getContext, storageUrl) {
   };
 }
 
-// libs/sdk/src/marketing/clarity.ts
-var initializedDestinations = /* @__PURE__ */ new Set();
-function clarityWindow() {
-  return typeof window === "undefined" ? null : window;
-}
-function prepareClarity(projectId) {
-  const target = clarityWindow();
-  if (!target || initializedDestinations.has(projectId)) return;
-  if (!target.clarity) {
-    const clarity = function() {
-      clarity.q ??= [];
-      clarity.q.push(arguments);
-    };
-    target.clarity = clarity;
+// libs/sdk/src/marketing/interactions.ts
+var WEBSITE_INTERACTION_EVENTS = [
+  "cta_click",
+  "form_open",
+  "form_start",
+  "form_step_complete",
+  "form_submit_attempt",
+  "form_submit_error",
+  "form_submit_success"
+];
+function isInteractionEvent(name) {
+  return WEBSITE_INTERACTION_EVENTS.some((candidate) => candidate === name);
+}
+function isInteractionIdentifier(value) {
+  return typeof value === "string" && /^[a-z][a-z0-9_-]{0,63}$/.test(value);
+}
+function isBrowserMarketingEvent(name) {
+  return isInteractionEvent(name) || [
+    "page_view",
+    "search",
+    "view_item_list",
+    "select_item",
+    "view_item",
+    "add_to_cart",
+    "remove_from_cart",
+    "view_cart",
+    "begin_checkout",
+    "add_shipping_info",
+    "add_payment_info",
+    "contact"
+  ].includes(name);
+}
+function interactionParameters(event) {
+  if (!isInteractionEvent(event.eventName)) return {};
+  if (event.eventName === "cta_click" ? !isInteractionIdentifier(event.ctaId) : !isInteractionIdentifier(event.formKey))
+    return null;
+  if (event.eventName === "form_step_complete" && !isInteractionIdentifier(event.stepKey))
+    return null;
+  if (event.eventName === "form_submit_error" && !["validation", "network", "rejected", "unavailable"].includes(
+    event.errorCategory ?? ""
+  ))
+    return null;
+  const params = {};
+  for (const [key, value] of Object.entries({
+    form_key: event.formKey,
+    cta_id: event.ctaId,
+    placement: event.placement,
+    step_key: event.stepKey
+  })) {
+    if (value === void 0) continue;
+    if (!isInteractionIdentifier(value)) return null;
+    params[key] = value;
   }
-  initializedDestinations.add(projectId);
+  if (event.eventName === "form_submit_error" && event.errorCategory)
+    params.error_category = event.errorCategory;
+  return params;
 }
-function loadClarityScript(projectId) {
-  if (typeof document === "undefined") return;
-  const id = `bacano-clarity-${projectId}`;
-  if (document.getElementById(id)) return;
-  const script = document.createElement("script");
-  script.id = id;
-  script.async = true;
-  script.src = `https://www.clarity.ms/tag/${encodeURIComponent(projectId)}`;
-  script.referrerPolicy = "strict-origin-when-cross-origin";
-  document.head.appendChild(script);
-}
-function sendClarityEvent(eventName) {
-  clarityWindow()?.clarity?.("event", eventName);
-}
-
-// libs/sdk/src/marketing/domain.ts
-function matchesCanonicalMarketingHost(canonicalDomain, currentHostname) {
-  if (canonicalDomain === void 0) return true;
-  if (!canonicalDomain?.trim()) return false;
-  try {
-    const configuredHost = new URL(
-      canonicalDomain.includes("://") ? canonicalDomain : `https://${canonicalDomain}`
-    ).hostname.toLowerCase();
-    return currentHostname.toLowerCase() === configuredHost;
-  } catch {
-    return false;
-  }
+function newMarketingEventId() {
+  return typeof crypto !== "undefined" && "randomUUID" in crypto ? crypto.randomUUID() : `evt_${Date.now()}_${Math.random().toString(16).slice(2)}`;
 }
 
 // libs/sdk/src/marketing/ga4.ts
@@ -5803,19 +5821,20 @@ var WEBSITE_MARKETING_CONTACT_PLACEMENTS = [
   "contact_page"
 ];
 
-// libs/sdk/src/marketing/runtime.ts
+// libs/sdk/src/marketing/browser-adapters.ts
 var initializedGa4Destinations = /* @__PURE__ */ new Set();
 var initializedMetaDestinations = /* @__PURE__ */ new Set();
 function marketingWindow() {
   return typeof window === "undefined" ? null : window;
 }
-function loadScriptOnce(id, source) {
+function loadScriptOnce(id, source, onError) {
   if (typeof document === "undefined" || document.getElementById(id)) return;
   const script = document.createElement("script");
   script.id = id;
   script.async = true;
   script.src = source;
   script.referrerPolicy = "strict-origin-when-cross-origin";
+  script.onerror = () => onError?.();
   document.head.appendChild(script);
 }
 function prepareGa4(measurementId) {
@@ -5830,10 +5849,11 @@ function prepareGa4(measurementId) {
   target.gtag("config", measurementId, { send_page_view: false });
   initializedGa4Destinations.add(measurementId);
 }
-function loadGa4Script(measurementId) {
+function loadGa4Script(measurementId, onError) {
   loadScriptOnce(
     `bacano-ga4-${measurementId}`,
-    `https://www.googletagmanager.com/gtag/js?id=${encodeURIComponent(measurementId)}`
+    `https://www.googletagmanager.com/gtag/js?id=${encodeURIComponent(measurementId)}`,
+    onError
   );
 }
 function captureGa4ClientId(measurementId, websiteId, diagnostic) {
@@ -5881,10 +5901,11 @@ function prepareMeta(pixelId) {
   target.fbq("init", pixelId);
   initializedMetaDestinations.add(pixelId);
 }
-function loadMetaScript() {
+function loadMetaScript(onError) {
   loadScriptOnce(
     "bacano-meta-pixel",
-    "https://connect.facebook.net/en_US/fbevents.js"
+    "https://connect.facebook.net/en_US/fbevents.js",
+    onError
   );
 }
 function scheduleScriptLoad(load, strategy) {
@@ -5948,10 +5969,12 @@ function contactPlacementFor(event) {
   }
   return placement;
 }
-function sendGa4(event, diagnosticMode) {
+function sendGa4(event, diagnosticMode, measurementId) {
   const target = marketingWindow();
   const contactPlacement = contactPlacementFor(event);
   target?.gtag?.("event", event.eventName, {
+    send_to: measurementId,
+    ...interactionParameters(event),
     currency: event.currency,
     value: event.value,
     search_term: event.searchTerm,
@@ -5968,15 +5991,17 @@ function sendGa4(event, diagnosticMode) {
     debug_mode: diagnosticMode ? true : void 0
   });
 }
-function sendMeta(event) {
+function sendMeta(event, pixelId) {
   const target = marketingWindow();
   const eventName = metaEventName(event.eventName);
   const isStandard = eventName !== event.eventName;
   const contactPlacement = contactPlacementFor(event);
   target?.fbq?.(
-    isStandard ? "track" : "trackCustom",
+    isStandard ? "trackSingle" : "trackSingleCustom",
+    pixelId,
     eventName,
     {
+      ...interactionParameters(event),
       currency: event.currency,
       value: event.value,
       search_string: event.searchTerm,
@@ -5993,14 +6018,69 @@ function sendMeta(event) {
     { eventID: event.eventId }
   );
 }
-function newEventId() {
-  return typeof crypto !== "undefined" && "randomUUID" in crypto ? crypto.randomUUID() : `evt_${Date.now()}_${Math.random().toString(16).slice(2)}`;
+
+// libs/sdk/src/marketing/clarity.ts
+var initializedDestinations = /* @__PURE__ */ new Set();
+function clarityWindow() {
+  return typeof window === "undefined" ? null : window;
 }
+function prepareClarity(projectId) {
+  const target = clarityWindow();
+  if (!target || initializedDestinations.has(projectId)) return;
+  if (!target.clarity) {
+    const clarity = function() {
+      clarity.q ??= [];
+      clarity.q.push(arguments);
+    };
+    target.clarity = clarity;
+  }
+  initializedDestinations.add(projectId);
+}
+function loadClarityScript(projectId, onError) {
+  if (typeof document === "undefined") return;
+  const id = `bacano-clarity-${projectId}`;
+  if (document.getElementById(id)) return;
+  const script = document.createElement("script");
+  script.id = id;
+  script.async = true;
+  script.src = `https://www.clarity.ms/tag/${encodeURIComponent(projectId)}`;
+  script.referrerPolicy = "strict-origin-when-cross-origin";
+  script.onerror = () => onError?.();
+  document.head.appendChild(script);
+}
+function sendClarityEvent(eventName) {
+  clarityWindow()?.clarity?.("event", eventName);
+}
+
+// libs/sdk/src/marketing/domain.ts
+function matchesCanonicalMarketingHost(canonicalDomain, currentHostname) {
+  if (canonicalDomain === void 0) return true;
+  if (!canonicalDomain?.trim()) return false;
+  try {
+    const configuredHost = new URL(
+      canonicalDomain.includes("://") ? canonicalDomain : `https://${canonicalDomain}`
+    ).hostname.toLowerCase();
+    return currentHostname.toLowerCase() === configuredHost;
+  } catch {
+    return false;
+  }
+}
+
+// libs/sdk/src/marketing/runtime.ts
 function createWebsiteMarketingRuntime(options) {
   let destroyed = false;
+  const dispatched = /* @__PURE__ */ new Set();
+  const observer = options.diagnostic;
+  const diagnostic = (value) => {
+    try {
+      observer?.(value);
+    } catch {
+    }
+  };
+  options = { ...options, diagnostic };
   let cancelScheduledLoad = () => void 0;
   const target = marketingWindow();
-  const enabled = options.config.enabled && Boolean(
+  const enabled = options.config.enabled && options.measurementAllowed !== false && Boolean(
     target && matchesCanonicalMarketingHost(
       options.canonicalDomain,
       target.location.hostname
@@ -6008,25 +6088,59 @@ function createWebsiteMarketingRuntime(options) {
   ) && Boolean(
     options.config.destinations.ga4 || options.config.destinations.meta || options.config.destinations.clarity
   );
+  if (!enabled)
+    diagnostic({
+      level: "debug",
+      code: !options.config.enabled ? "MARKETING_DISABLED" : options.measurementAllowed === false ? "MEASUREMENT_NOT_ALLOWED" : !target ? "SERVER_RENDER" : !matchesCanonicalMarketingHost(
+        options.canonicalDomain,
+        target.location.hostname
+      ) ? "DOMAIN_NOT_ALLOWED" : "PROVIDER_NOT_CONFIGURED",
+      message: "Measurement is inactive; no events are emitted"
+    });
   if (enabled) {
+    const guard = (provider, action) => {
+      try {
+        action();
+      } catch {
+        diagnostic({
+          level: "warning",
+          code: "RUNTIME_INITIALIZATION_FAILED",
+          message: `${provider}: initialization failed`
+        });
+      }
+    };
+    const scriptError = (provider) => () => diagnostic({
+      level: "warning",
+      code: "SCRIPT_LOAD_FAILED",
+      message: `${provider}: script could not load (network, CSP or blocker); external reception is unverified`
+    });
     try {
       if (options.config.destinations.ga4) {
-        prepareGa4(options.config.destinations.ga4.measurementId);
+        const { measurementId } = options.config.destinations.ga4;
+        guard("GA4", () => prepareGa4(measurementId));
       }
       if (options.config.destinations.meta) {
-        prepareMeta(options.config.destinations.meta.pixelId);
+        const { pixelId } = options.config.destinations.meta;
+        guard("Meta", () => prepareMeta(pixelId));
       }
       if (options.config.destinations.clarity) {
-        prepareClarity(options.config.destinations.clarity.projectId);
+        const { projectId } = options.config.destinations.clarity;
+        guard("Clarity", () => prepareClarity(projectId));
       }
       cancelScheduledLoad = scheduleScriptLoad(() => {
         if (destroyed) return;
         if (options.config.destinations.ga4) {
-          loadGa4Script(options.config.destinations.ga4.measurementId);
+          const { measurementId } = options.config.destinations.ga4;
+          guard("GA4", () => loadGa4Script(measurementId, scriptError("GA4")));
         }
-        if (options.config.destinations.meta) loadMetaScript();
+        if (options.config.destinations.meta)
+          guard("Meta", () => loadMetaScript(scriptError("Meta")));
         if (options.config.destinations.clarity) {
-          loadClarityScript(options.config.destinations.clarity.projectId);
+          const { projectId } = options.config.destinations.clarity;
+          guard(
+            "Clarity",
+            () => loadClarityScript(projectId, scriptError("Clarity"))
+          );
         }
       }, options.scriptLoadStrategy);
       captureWebsiteMarketingAttribution(
@@ -6048,11 +6162,11 @@ function createWebsiteMarketingRuntime(options) {
       if (options.config.destinations.meta) {
         refreshWebsiteMarketingMetaContext(options.websiteId);
       }
-    } catch (error) {
+    } catch {
       options.diagnostic?.({
         level: "warning",
         code: "RUNTIME_INITIALIZATION_FAILED",
-        message: error instanceof Error ? error.message : "Initialization failed"
+        message: "Marketing initialization failed; external reception is unverified"
       });
     }
   }
@@ -6060,41 +6174,96 @@ function createWebsiteMarketingRuntime(options) {
     enabled,
     track(input) {
       if (!enabled || destroyed) return;
+      if (!isBrowserMarketingEvent(input.eventName)) {
+        diagnostic({
+          level: "warning",
+          code: "INVALID_EVENT",
+          message: "Unknown or server-owned event rejected"
+        });
+        return;
+      }
+      try {
+        captureWebsiteMarketingAttribution(
+          options.websiteId,
+          options.config.attributionWindowDays
+        );
+      } catch {
+      }
       const event = {
         ...input,
         schemaVersion: 1,
-        eventId: input.eventId ?? newEventId(),
+        eventId: input.eventId ?? newMarketingEventId(),
         occurredAt: input.occurredAt ?? (/* @__PURE__ */ new Date()).toISOString(),
         currency: input.currency ?? options.config.currencyCode,
         pageLocation: sanitizeMarketingUrl(
           input.pageLocation ?? (typeof window === "undefined" ? "" : window.location.href)
         )
       };
-      try {
-        if (options.config.destinations.ga4) {
-          sendGa4(event, options.config.destinations.ga4.diagnosticMode);
+      if (isInteractionEvent(event.eventName)) {
+        if (!interactionParameters(event) || !/^[a-zA-Z0-9_-]{1,100}$/.test(event.eventId)) {
+          diagnostic({
+            level: "warning",
+            code: "INVALID_INTERACTION",
+            message: "Interaction rejected by the public contract",
+            eventName: event.eventName
+          });
+          return;
         }
-        if (options.config.destinations.meta) sendMeta(event);
-        if (options.config.destinations.clarity) {
-          sendClarityEvent(event.eventName);
+        for (const key of [
+          "currency",
+          "value",
+          "searchTerm",
+          "itemListId",
+          "itemListName",
+          "shippingTier",
+          "paymentType",
+          "contactMethod",
+          "contactPlacement",
+          "items",
+          "pageTitle"
+        ])
+          delete event[key];
+      }
+      const identity = `${event.eventName}:${event.eventId}`;
+      if (dispatched.has(identity)) return;
+      dispatched.add(identity);
+      const oldest = dispatched.values().next().value;
+      if (dispatched.size > 1e3 && oldest) dispatched.delete(oldest);
+      const dispatch = (provider, send) => {
+        try {
+          send();
+          diagnostic({
+            level: "debug",
+            code: "EVENT_DISPATCHED",
+            message: `${provider}: passed to adapter; external reception is unverified`,
+            eventName: event.eventName
+          });
+        } catch {
+          diagnostic({
+            level: "warning",
+            code: "EVENT_DISPATCH_FAILED",
+            message: `${provider}: adapter failed`,
+            eventName: event.eventName
+          });
         }
-        options.diagnostic?.({
-          level: "debug",
-          code: "EVENT_DISPATCHED",
-          message: "Marketing event dispatched",
-          eventName: event.eventName
-        });
-      } catch (error) {
-        options.diagnostic?.({
-          level: "warning",
-          code: "EVENT_DISPATCH_FAILED",
-          message: error instanceof Error ? error.message : "Dispatch failed",
-          eventName: event.eventName
-        });
+      };
+      if (options.config.destinations.ga4) {
+        const ga4 = options.config.destinations.ga4;
+        dispatch(
+          "GA4",
+          () => sendGa4(event, ga4.diagnosticMode, ga4.measurementId)
+        );
+      }
+      if (options.config.destinations.meta) {
+        const meta = options.config.destinations.meta;
+        dispatch("Meta", () => sendMeta(event, meta.pixelId));
+      }
+      if (options.config.destinations.clarity) {
+        dispatch("Clarity", () => sendClarityEvent(event.eventName));
       }
     },
     captureAttribution() {
-      if (!enabled) return null;
+      if (!enabled || destroyed) return null;
       captureWebsiteMarketingAttribution(
         options.websiteId,
         options.config.attributionWindowDays
@@ -6105,7 +6274,7 @@ function createWebsiteMarketingRuntime(options) {
       return getWebsiteMarketingAttribution(options.websiteId);
     },
     getAttribution() {
-      if (!enabled) return null;
+      if (!enabled || destroyed) return null;
       if (options.config.destinations.meta) {
         refreshWebsiteMarketingMetaContext(options.websiteId);
       }