@salesmind-ai/design-system 0.1.7 → 0.1.9

package/dist/web/index.d.cts

@@ -1,5 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
+import { U as UtmParams } from '../audit-CiyPkxk1.cjs';
+export { F as FirstTouchAttribution, a as UTM_CAMPAIGNS, b as UTM_CONTENTS, c as UTM_MEDIUMS_ALL, d as UTM_MEDIUMS_APP, e as UTM_MEDIUMS_MESSAGING, f as UTM_MEDIUMS_WEB, g as UTM_SOURCES, h as UTM_SOURCES_REQUIRING_SELLER, i as UTM_TERMS, j as UrlClassification, k as UtmAuditEntry, l as UtmBlockedError, m as UtmCampaign, n as UtmComplianceResult, o as UtmComplianceStatus, p as UtmConfidence, q as UtmContent, r as UtmMedium, s as UtmMediumAppPage, t as UtmMediumMessaging, u as UtmMediumWebPage, v as UtmOverrides, w as UtmSource, x as UtmSourceRequiringSeller, y as UtmTerm, z as buildBlockedError, A as buildUtmUrl, B as classifyAndEnforce, C as classifyUrl, D as createAuditEntry, E as isUtmExempt, G as isValidUtmParams, H as parseUtmParams, I as requiresSellerAttribution, J as requiresUtm, K as toFirstTouchAttribution, L as validateCompliance, M as validateUtmField } from '../audit-CiyPkxk1.cjs';
 
 /**
  * Schema.org SEO Generator Types
@@ -407,7 +409,7 @@ declare function createSchemaGenerators(brand: BrandConfig, supportedLanguages?:
         inLanguage: string;
         worksFor: {
             name: string;
-            '@id'?: string;
+            '@id'?: string | undefined;
         } | {
             '@type': string;
             '@id': `${string}/#organization`;
@@ -887,4 +889,28 @@ declare function AnalyticsProvider({ onTrack, debug, children }: AnalyticsProvid
  */
 declare function useAnalytics(): AnalyticsContextValue;
 
-export { type AnalyticsContextValue, type AnalyticsEventProps, type AnalyticsLoaderConfig, AnalyticsProvider, type AnalyticsProviderProps, type ArticleMeta, type BrandConfig, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, type CareerForSchema, type ConsentStatus, CookieConsent, type CookieConsentLabels, type CookieConsentProps, type CustomerOrganizationMeta, type FAQItem, type GlossaryTermForSchema, type HowToMeta, type HowToStep, type ItemForList, JsonLd, type JsonLdProps, type PersonMeta, type PricingPlan, type BreadcrumbItem as SeoBreadcrumbItem, type ServiceMotion, type TestimonialForSchema, type TrackFn, type TranscriptForSchema, type VideoObjectMeta, aggregateRatingFromTestimonials, buildPageGraph, canonicalUrl, createAnalyticsLoader, createEntityIds, createSchemaGenerators, loadClarity, loadGoogleAnalytics, useAnalytics, useCookieConsent };
+interface UtmProviderProps {
+    /** Default UTM parameters for all descendants. */
+    params: UtmParams;
+    children: ReactNode;
+}
+/**
+ * Provides governed UTM defaults to all `OutboundLink` and UTM-aware
+ * components in the subtree.
+ *
+ * @example
+ * ```tsx
+ * <UtmProvider params={{ source: 'website', medium: 'webBlogPost', campaign: 'demo' }}>
+ *   <BlogPostPage />
+ * </UtmProvider>
+ * ```
+ */
+declare function UtmProvider({ params, children }: UtmProviderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Read the nearest UtmProvider's default params.
+ * Returns `null` when no provider is present (callers should fall back gracefully).
+ */
+declare function useUtmDefaults(): UtmParams | null;
+
+export { type AnalyticsContextValue, type AnalyticsEventProps, type AnalyticsLoaderConfig, AnalyticsProvider, type AnalyticsProviderProps, type ArticleMeta, type BrandConfig, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, type CareerForSchema, type ConsentStatus, CookieConsent, type CookieConsentLabels, type CookieConsentProps, type CustomerOrganizationMeta, type FAQItem, type GlossaryTermForSchema, type HowToMeta, type HowToStep, type ItemForList, JsonLd, type JsonLdProps, type PersonMeta, type PricingPlan, type BreadcrumbItem as SeoBreadcrumbItem, type ServiceMotion, type TestimonialForSchema, type TrackFn, type TranscriptForSchema, UtmParams, UtmProvider, type UtmProviderProps, type VideoObjectMeta, aggregateRatingFromTestimonials, buildPageGraph, canonicalUrl, createAnalyticsLoader, createEntityIds, createSchemaGenerators, loadClarity, loadGoogleAnalytics, useAnalytics, useCookieConsent, useUtmDefaults };

package/dist/web/index.d.ts

@@ -1,5 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
+import { U as UtmParams } from '../audit-CiyPkxk1.js';
+export { F as FirstTouchAttribution, a as UTM_CAMPAIGNS, b as UTM_CONTENTS, c as UTM_MEDIUMS_ALL, d as UTM_MEDIUMS_APP, e as UTM_MEDIUMS_MESSAGING, f as UTM_MEDIUMS_WEB, g as UTM_SOURCES, h as UTM_SOURCES_REQUIRING_SELLER, i as UTM_TERMS, j as UrlClassification, k as UtmAuditEntry, l as UtmBlockedError, m as UtmCampaign, n as UtmComplianceResult, o as UtmComplianceStatus, p as UtmConfidence, q as UtmContent, r as UtmMedium, s as UtmMediumAppPage, t as UtmMediumMessaging, u as UtmMediumWebPage, v as UtmOverrides, w as UtmSource, x as UtmSourceRequiringSeller, y as UtmTerm, z as buildBlockedError, A as buildUtmUrl, B as classifyAndEnforce, C as classifyUrl, D as createAuditEntry, E as isUtmExempt, G as isValidUtmParams, H as parseUtmParams, I as requiresSellerAttribution, J as requiresUtm, K as toFirstTouchAttribution, L as validateCompliance, M as validateUtmField } from '../audit-CiyPkxk1.js';
 
 /**
  * Schema.org SEO Generator Types
@@ -407,7 +409,7 @@ declare function createSchemaGenerators(brand: BrandConfig, supportedLanguages?:
         inLanguage: string;
         worksFor: {
             name: string;
-            '@id'?: string;
+            '@id'?: string | undefined;
         } | {
             '@type': string;
             '@id': `${string}/#organization`;
@@ -887,4 +889,28 @@ declare function AnalyticsProvider({ onTrack, debug, children }: AnalyticsProvid
  */
 declare function useAnalytics(): AnalyticsContextValue;
 
-export { type AnalyticsContextValue, type AnalyticsEventProps, type AnalyticsLoaderConfig, AnalyticsProvider, type AnalyticsProviderProps, type ArticleMeta, type BrandConfig, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, type CareerForSchema, type ConsentStatus, CookieConsent, type CookieConsentLabels, type CookieConsentProps, type CustomerOrganizationMeta, type FAQItem, type GlossaryTermForSchema, type HowToMeta, type HowToStep, type ItemForList, JsonLd, type JsonLdProps, type PersonMeta, type PricingPlan, type BreadcrumbItem as SeoBreadcrumbItem, type ServiceMotion, type TestimonialForSchema, type TrackFn, type TranscriptForSchema, type VideoObjectMeta, aggregateRatingFromTestimonials, buildPageGraph, canonicalUrl, createAnalyticsLoader, createEntityIds, createSchemaGenerators, loadClarity, loadGoogleAnalytics, useAnalytics, useCookieConsent };
+interface UtmProviderProps {
+    /** Default UTM parameters for all descendants. */
+    params: UtmParams;
+    children: ReactNode;
+}
+/**
+ * Provides governed UTM defaults to all `OutboundLink` and UTM-aware
+ * components in the subtree.
+ *
+ * @example
+ * ```tsx
+ * <UtmProvider params={{ source: 'website', medium: 'webBlogPost', campaign: 'demo' }}>
+ *   <BlogPostPage />
+ * </UtmProvider>
+ * ```
+ */
+declare function UtmProvider({ params, children }: UtmProviderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Read the nearest UtmProvider's default params.
+ * Returns `null` when no provider is present (callers should fall back gracefully).
+ */
+declare function useUtmDefaults(): UtmParams | null;
+
+export { type AnalyticsContextValue, type AnalyticsEventProps, type AnalyticsLoaderConfig, AnalyticsProvider, type AnalyticsProviderProps, type ArticleMeta, type BrandConfig, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, type CareerForSchema, type ConsentStatus, CookieConsent, type CookieConsentLabels, type CookieConsentProps, type CustomerOrganizationMeta, type FAQItem, type GlossaryTermForSchema, type HowToMeta, type HowToStep, type ItemForList, JsonLd, type JsonLdProps, type PersonMeta, type PricingPlan, type BreadcrumbItem as SeoBreadcrumbItem, type ServiceMotion, type TestimonialForSchema, type TrackFn, type TranscriptForSchema, UtmParams, UtmProvider, type UtmProviderProps, type VideoObjectMeta, aggregateRatingFromTestimonials, buildPageGraph, canonicalUrl, createAnalyticsLoader, createEntityIds, createSchemaGenerators, loadClarity, loadGoogleAnalytics, useAnalytics, useCookieConsent, useUtmDefaults };

package/dist/web/index.js

@@ -1,5 +1,6 @@
+"use client";
 import { jsx, jsxs } from 'react/jsx-runtime';
-import React, { forwardRef, useState, useEffect, createContext, useCallback, useMemo, useContext } from 'react';
+import React, { createContext, forwardRef, useState, useEffect, useContext, useCallback, useMemo } from 'react';
 import { Slot } from '@radix-ui/react-slot';
 import clsx from 'clsx';
 import { AnimatePresence, motion } from 'framer-motion';
@@ -649,23 +650,146 @@ var Button = React.forwardRef(
   }
 );
 Button.displayName = "Button";
+var UtmContext = createContext(null);
+
+// src/web/utm/useUtmDefaults.ts
+function useUtmDefaults() {
+  return useContext(UtmContext);
+}
+
+// src/web/utm/builders.ts
+var PLACEHOLDER_ORIGIN = "https://__placeholder__.internal";
+function buildUtmUrl(baseUrl, params) {
+  const isRelative = baseUrl.startsWith("/");
+  let url;
+  try {
+    url = isRelative ? new URL(baseUrl, PLACEHOLDER_ORIGIN) : new URL(baseUrl);
+  } catch {
+    return baseUrl;
+  }
+  const existingParams = [];
+  url.searchParams.forEach((value, key) => {
+    existingParams.push([key, value]);
+  });
+  for (const [key] of existingParams) {
+    url.searchParams.delete(key);
+  }
+  for (const [key, value] of existingParams) {
+    if (!key.startsWith("utm_")) {
+      url.searchParams.set(key, value);
+    }
+  }
+  url.searchParams.set("utm_source", params.source);
+  url.searchParams.set("utm_medium", params.medium);
+  url.searchParams.set("utm_campaign", params.campaign);
+  if (params.term !== void 0) {
+    url.searchParams.set("utm_term", params.term);
+  }
+  if (params.content !== void 0) {
+    url.searchParams.set("utm_content", params.content);
+  }
+  if (isRelative) {
+    return url.href.replace(PLACEHOLDER_ORIGIN, "");
+  }
+  return url.href;
+}
+
+// src/web/utm/classifiers.ts
+var INTERNAL_PATTERNS = [
+  /^\/(?!\/)/,
+  // Relative paths
+  /^https?:\/\/(www\.)?sales-mind\.ai/i,
+  // Marketing site
+  /^https?:\/\/app\.sales-mind\.ai/i,
+  // Web app
+  /^https?:\/\/apps\.sales-mind\.ai/i,
+  // Web app (legacy)
+  /^https?:\/\/meet\.sales-mind\.ai/i,
+  // Booking
+  /^https?:\/\/docs\.sales-mind\.ai/i
+  // Docs
+];
+var SYSTEM_PATTERNS = [
+  /^https?:\/\/.*\/api\//i,
+  // API endpoints
+  /^https?:\/\/.*\/webhook/i,
+  // Webhooks
+  /^https?:\/\/.*\/oauth/i,
+  // OAuth callbacks
+  /^https?:\/\/.*\/callback/i,
+  // Callbacks
+  /^https?:\/\/.*\.supabase\.(co|com)/i,
+  // Supabase
+  /^https?:\/\/.*\.firebaseapp\.com/i,
+  // Firebase
+  /^https?:\/\/.*\.cloudfunctions\.net/i
+  // Cloud Functions
+];
+var ASSET_PATTERNS = [
+  /\.(css|js|mjs|map|woff2?|ttf|eot|svg|png|jpe?g|gif|webp|avif|ico|pdf)(\?.*)?$/i
+];
+var CONVERSION_PATTERNS = [
+  /^https?:\/\/(www\.)?calendly\.com/i,
+  /^https?:\/\/(checkout\.)?stripe\.com/i,
+  /^https?:\/\/buy\.stripe\.com/i,
+  /^https?:\/\/chromewebstore\.google\.com/i,
+  /^https?:\/\/meet\.sales-mind\.ai/i
+];
+var PROTOCOL_EXEMPT = [
+  /^mailto:/i,
+  /^tel:/i,
+  /^#/,
+  /^javascript:/i
+];
+function classifyUrl(url) {
+  if (PROTOCOL_EXEMPT.some((p) => p.test(url))) return "protocol";
+  if (ASSET_PATTERNS.some((p) => p.test(url))) return "asset";
+  if (SYSTEM_PATTERNS.some((p) => p.test(url))) return "system";
+  if (CONVERSION_PATTERNS.some((p) => p.test(url))) return "conversion";
+  if (INTERNAL_PATTERNS.some((p) => p.test(url))) return "internal";
+  return "external";
+}
+function requiresUtm(url) {
+  const classification = classifyUrl(url);
+  return classification === "external" || classification === "conversion";
+}
+function isUtmExempt(url) {
+  const classification = classifyUrl(url);
+  return classification === "protocol" || classification === "asset" || classification === "system" || classification === "internal";
+}
 
 // src/components/OutboundLink/outbound-link-utils.ts
-var CONSTANT_UTM_SOURCE = "salesmind";
+var LEGACY_UTM_SOURCE = "salesmind";
 var EXEMPT_PATTERNS = [
   /^https?:\/\/(www\.)?(stripe\.com|checkout\.stripe\.com|paypal\.com)/i,
   /^https?:\/\/(www\.)?github\.com\/login\/oauth/i
 ];
 var isExemptUrl = (urlStr) => {
   if (urlStr.startsWith("mailto:") || urlStr.startsWith("tel:")) return true;
+  const classification = classifyUrl(urlStr);
+  if (classification === "system" || classification === "protocol" || classification === "asset") {
+    return true;
+  }
   return EXEMPT_PATTERNS.some((pattern) => pattern.test(urlStr));
 };
+var appendGovernedUTMs = (href, params, preserveExisting = true) => {
+  try {
+    const url = new URL(href);
+    if (preserveExisting) {
+      const hasAll = url.searchParams.has("utm_source") && url.searchParams.has("utm_medium") && url.searchParams.has("utm_campaign");
+      if (hasAll) return href;
+    }
+    return buildUtmUrl(href, params);
+  } catch {
+    return href;
+  }
+};
 var appendUTMs = (href, context, pageSlug, options) => {
   try {
     const url = new URL(href);
     const { mediumOverride = "outbound_link", campaignOverride, preserveExisting = true } = options;
     const utms = {
-      utm_source: CONSTANT_UTM_SOURCE,
+      utm_source: LEGACY_UTM_SOURCE,
       utm_medium: mediumOverride,
       utm_campaign: campaignOverride || pageSlug,
       utm_content: context
@@ -692,10 +816,13 @@ var OutboundLink = forwardRef(
     preserveExistingUTM = true,
     openInNewTab = true,
     disableTracking = false,
+    utmParams,
     onClick,
     children,
     ...props
   }, ref) => {
+    const contextParams = useUtmDefaults();
+    const resolvedUtmParams = utmParams ?? contextParams;
     let hostname = "";
     try {
       const url = new URL(href);
@@ -720,16 +847,20 @@ var OutboundLink = forwardRef(
       }
       const isExempt = isExemptUrl(href) || disableTracking;
       if (isExternal && !isExempt) {
-        const pageSlug = window.location.pathname.replace(/^\/|\/$/g, "") || "home";
-        setFinalHref(appendUTMs(href, context, pageSlug, {
-          mediumOverride: currentMedium,
-          campaignOverride,
-          preserveExisting: preserveExistingUTM
-        }));
+        if (resolvedUtmParams) {
+          setFinalHref(appendGovernedUTMs(href, resolvedUtmParams, preserveExistingUTM));
+        } else {
+          const pageSlug = window.location.pathname.replace(/^\/|\/$/g, "") || "home";
+          setFinalHref(appendUTMs(href, context, pageSlug, {
+            mediumOverride: currentMedium,
+            campaignOverride,
+            preserveExisting: preserveExistingUTM
+          }));
+        }
       } else {
         setFinalHref(href);
       }
-    }, [href, context, mediumOverride, campaignOverride, preserveExistingUTM, disableTracking]);
+    }, [href, context, mediumOverride, campaignOverride, preserveExistingUTM, disableTracking, resolvedUtmParams]);
     const handleClick = (e) => {
       if (typeof window === "undefined" || disableTracking) {
         onClick?.(e);
@@ -902,6 +1033,268 @@ function useAnalytics() {
   return useContext(AnalyticsContext) ?? NOOP_VALUE;
 }
 
-export { AnalyticsProvider, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, CookieConsent, JsonLd, aggregateRatingFromTestimonials, buildPageGraph, canonicalUrl, createAnalyticsLoader, createEntityIds, createSchemaGenerators, loadClarity, loadGoogleAnalytics, useAnalytics, useCookieConsent };
-//# sourceMappingURL=index.js.map
+// src/web/utm/constants.ts
+var UTM_SOURCES = [
+  "linkedin",
+  "whatsapp",
+  "intercom",
+  "email",
+  "website",
+  "app",
+  "chromeStore",
+  "stripe",
+  "direct"
+];
+var UTM_MEDIUMS_MESSAGING = [
+  "dm",
+  "group",
+  "email",
+  "inAppChat",
+  "organicPost",
+  "paidAd",
+  "qrCode",
+  "redirect",
+  "storeListing"
+];
+var UTM_MEDIUMS_APP = [
+  "appHome",
+  "appDashboard",
+  "appInbox",
+  "appContacts",
+  "appCampaigns",
+  "appSettings",
+  "appBilling",
+  "appCheckout",
+  "appOnboarding",
+  "appSupport",
+  "appCalendar"
+];
+var UTM_MEDIUMS_WEB = [
+  "webHome",
+  "webDemo",
+  "webPricing",
+  "webFeatures",
+  "webUseCase",
+  "webSolution",
+  "webIndustry",
+  "webIntegrations",
+  "webBlog",
+  "webBlogPost",
+  "webLanding",
+  "webComparison",
+  "webCaseStudy",
+  "webAbout",
+  "webContact",
+  "webCareers",
+  "webLegal",
+  "webDocs",
+  "webAffiliate"
+];
+var UTM_MEDIUMS_ALL = [
+  ...UTM_MEDIUMS_MESSAGING,
+  ...UTM_MEDIUMS_APP,
+  ...UTM_MEDIUMS_WEB
+];
+var UTM_CAMPAIGNS = [
+  "discoveryCall",
+  "demo",
+  "trial",
+  "onboarding",
+  "upgrade",
+  "renewal",
+  "retention",
+  "accountSupport",
+  "supportCall",
+  "partnerCall",
+  "hiring",
+  "interviewCall"
+];
+var UTM_TERMS = [
+  "julienGadea",
+  "bramSmith",
+  "florentDupont",
+  "sawLin",
+  "evaSupport",
+  "team",
+  "auto"
+];
+var UTM_CONTENTS = [
+  "ctaPrimary",
+  "ctaSecondary",
+  "ctaHeader",
+  "ctaFooter",
+  "ctaInline",
+  "buttonPrimary",
+  "buttonSecondary",
+  "banner",
+  "popup",
+  "variantA",
+  "variantB",
+  "variantC"
+];
+var UTM_SOURCES_REQUIRING_SELLER = [
+  "linkedin",
+  "whatsapp",
+  "intercom",
+  "email"
+];
+
+// src/web/utm/validators.ts
+function validateUtmField(field, value) {
+  switch (field) {
+    case "source":
+      return UTM_SOURCES.includes(value);
+    case "medium":
+      return UTM_MEDIUMS_ALL.includes(value);
+    case "campaign":
+      return UTM_CAMPAIGNS.includes(value);
+    case "term":
+      return UTM_TERMS.includes(value);
+    case "content":
+      return UTM_CONTENTS.includes(value);
+    default:
+      return false;
+  }
+}
+function isValidUtmParams(params) {
+  if (!params.source || !params.medium || !params.campaign) {
+    return false;
+  }
+  if (!validateUtmField("source", params.source)) return false;
+  if (!validateUtmField("medium", params.medium)) return false;
+  if (!validateUtmField("campaign", params.campaign)) return false;
+  if (params.term !== void 0 && !validateUtmField("term", params.term)) return false;
+  if (params.content !== void 0 && !validateUtmField("content", params.content)) return false;
+  return true;
+}
+function validateCompliance(url, params) {
+  const errors = [];
+  const classification = classifyUrl(url);
+  const needsUtm = requiresUtm(url);
+  if (!needsUtm) {
+    return {
+      status: "compliant",
+      url,
+      params: params ?? null,
+      errors: []
+    };
+  }
+  if (!params) {
+    return {
+      status: "blocked",
+      url,
+      params: null,
+      errors: [`URL classified as '${classification}' requires UTM parameters but none provided`]
+    };
+  }
+  if (!params.source) errors.push("Missing required field: utm_source");
+  if (!params.medium) errors.push("Missing required field: utm_medium");
+  if (!params.campaign) errors.push("Missing required field: utm_campaign");
+  if (params.source && !validateUtmField("source", params.source)) {
+    errors.push(`Invalid utm_source: '${params.source}'. Must be one of: ${UTM_SOURCES.join(", ")}`);
+  }
+  if (params.medium && !validateUtmField("medium", params.medium)) {
+    errors.push(`Invalid utm_medium: '${params.medium}'. Must be one of governed enum values`);
+  }
+  if (params.campaign && !validateUtmField("campaign", params.campaign)) {
+    errors.push(`Invalid utm_campaign: '${params.campaign}'. Must be one of: ${UTM_CAMPAIGNS.join(", ")}`);
+  }
+  if (params.term !== void 0 && params.term && !validateUtmField("term", params.term)) {
+    errors.push(`Invalid utm_term: '${params.term}'. Must be one of: ${UTM_TERMS.join(", ")}`);
+  }
+  if (params.content !== void 0 && params.content && !validateUtmField("content", params.content)) {
+    errors.push(`Invalid utm_content: '${params.content}'. Must be one of: ${UTM_CONTENTS.join(", ")}`);
+  }
+  const allValues = [];
+  if (params.source) allValues.push(params.source);
+  if (params.medium) allValues.push(params.medium);
+  if (params.campaign) allValues.push(params.campaign);
+  if (params.term) allValues.push(params.term);
+  if (params.content) allValues.push(params.content);
+  for (const value of allValues) {
+    if (/\s/.test(value)) errors.push(`Value '${value}' contains spaces`);
+    if (/_/.test(value)) errors.push(`Value '${value}' contains underscores`);
+    if (/-/.test(value)) errors.push(`Value '${value}' contains hyphens`);
+    if (/[^\x20-\x7E]/.test(value)) errors.push(`Value '${value}' contains non-ASCII characters`);
+    if (value === value.toUpperCase() && value.length > 1) errors.push(`Value '${value}' is ALL CAPS`);
+  }
+  const status = errors.length === 0 ? "compliant" : "blocked";
+  return { status, url, params, errors };
+}
+function classifyAndEnforce(url, params) {
+  return validateCompliance(url, params);
+}
+function buildBlockedError(reason, url) {
+  return {
+    status: "UTM_COMPLIANCE_BLOCKED",
+    reason,
+    requiredFix: reason,
+    correctedExample: url ?? null
+  };
+}
+
+// src/web/utm/attribution.ts
+function parseUtmParams(search) {
+  if (!search) return {};
+  const params = new URLSearchParams(search);
+  const result = {};
+  const source = params.get("utm_source");
+  if (source && UTM_SOURCES.includes(source)) {
+    result.source = source;
+  }
+  const medium = params.get("utm_medium");
+  if (medium) {
+    result.medium = medium;
+  }
+  const campaign = params.get("utm_campaign");
+  if (campaign && UTM_CAMPAIGNS.includes(campaign)) {
+    result.campaign = campaign;
+  }
+  const term = params.get("utm_term");
+  if (term && UTM_TERMS.includes(term)) {
+    result.term = term;
+  }
+  const content = params.get("utm_content");
+  if (content && UTM_CONTENTS.includes(content)) {
+    result.content = content;
+  }
+  return result;
+}
+function toFirstTouchAttribution(params) {
+  return {
+    firstTouchSource: params.source,
+    firstTouchMedium: params.medium,
+    firstTouchCampaign: params.campaign,
+    firstTouchSeller: params.term ?? null
+  };
+}
+function requiresSellerAttribution(source) {
+  return UTM_SOURCES_REQUIRING_SELLER.includes(source);
+}
+
+// src/web/utm/audit.ts
+function createAuditEntry(url, params, generatorContext, confidence) {
+  const utmParts = [];
+  if (params) {
+    if (params.source) utmParts.push(`utm_source=${params.source}`);
+    if (params.medium) utmParts.push(`utm_medium=${params.medium}`);
+    if (params.campaign) utmParts.push(`utm_campaign=${params.campaign}`);
+    if (params.term) utmParts.push(`utm_term=${params.term}`);
+    if (params.content) utmParts.push(`utm_content=${params.content}`);
+  }
+  return {
+    url,
+    utmString: utmParts.join("&"),
+    generatorContext,
+    sellerAttribution: params?.term ?? null,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    confidence
+  };
+}
+function UtmProvider({ params, children }) {
+  return /* @__PURE__ */ jsx(UtmContext.Provider, { value: params, children });
+}
+
+export { AnalyticsProvider, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, CookieConsent, JsonLd, UTM_CAMPAIGNS, UTM_CONTENTS, UTM_MEDIUMS_ALL, UTM_MEDIUMS_APP, UTM_MEDIUMS_MESSAGING, UTM_MEDIUMS_WEB, UTM_SOURCES, UTM_SOURCES_REQUIRING_SELLER, UTM_TERMS, UtmProvider, aggregateRatingFromTestimonials, buildBlockedError, buildPageGraph, buildUtmUrl, canonicalUrl, classifyAndEnforce, classifyUrl, createAnalyticsLoader, createAuditEntry, createEntityIds, createSchemaGenerators, isUtmExempt, isValidUtmParams, loadClarity, loadGoogleAnalytics, parseUtmParams, requiresSellerAttribution, requiresUtm, toFirstTouchAttribution, useAnalytics, useCookieConsent, useUtmDefaults, validateCompliance, validateUtmField };
+//# sourceMappingURL=out.js.map
 //# sourceMappingURL=index.js.map