@salesmind-ai/design-system 0.1.6 → 0.1.8

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 };
+// 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=index.js.map
 //# sourceMappingURL=index.js.map