@salesmind-ai/design-system 0.1.7 → 0.1.8

package/dist/index.cjs

@@ -4050,23 +4050,146 @@ var PlatformBadge = React30.forwardRef(
   }
 );
 PlatformBadge.displayName = "PlatformBadge";
+var UtmContext = React30.createContext(null);
+
+// src/web/utm/useUtmDefaults.ts
+function useUtmDefaults() {
+  return React30.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
@@ -4093,10 +4216,13 @@ var OutboundLink = React30.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);
@@ -4121,16 +4247,20 @@ var OutboundLink = React30.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);
@@ -16692,6 +16822,265 @@ function JsonIcon() {
   );
 }
 
+// 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
+  };
+}
+
 Object.defineProperty(exports, "FormattedDate", {
   enumerable: true,
   get: function () { return reactIntl.FormattedDate; }
@@ -16999,6 +17388,15 @@ exports.TooltipProvider = TooltipProvider;
 exports.TooltipRoot = TooltipRoot;
 exports.TooltipTrigger = TooltipTrigger;
 exports.TrendIndicator = TrendIndicator;
+exports.UTM_CAMPAIGNS = UTM_CAMPAIGNS;
+exports.UTM_CONTENTS = UTM_CONTENTS;
+exports.UTM_MEDIUMS_ALL = UTM_MEDIUMS_ALL;
+exports.UTM_MEDIUMS_APP = UTM_MEDIUMS_APP;
+exports.UTM_MEDIUMS_MESSAGING = UTM_MEDIUMS_MESSAGING;
+exports.UTM_MEDIUMS_WEB = UTM_MEDIUMS_WEB;
+exports.UTM_SOURCES = UTM_SOURCES;
+exports.UTM_SOURCES_REQUIRING_SELLER = UTM_SOURCES_REQUIRING_SELLER;
+exports.UTM_TERMS = UTM_TERMS;
 exports.VARIANTS = VARIANTS;
 exports.ValueAnchor = ValueAnchor;
 exports.VersionedSeriesNavigator = VersionedSeriesNavigator;
@@ -17012,23 +17410,35 @@ exports.Z_INDEX = Z_INDEX;
 exports.alertMessages = alertMessages;
 exports.allMessages = allMessages;
 exports.appearanceMessages = appearanceMessages;
+exports.appendGovernedUTMs = appendGovernedUTMs;
 exports.appendUTMs = appendUTMs;
 exports.authMessages = authMessages;
+exports.buildBlockedError = buildBlockedError;
+exports.buildUtmUrl = buildUtmUrl;
 exports.calendarMessages = calendarMessages;
 exports.carouselMessages = carouselMessages;
+exports.classifyAndEnforce = classifyAndEnforce;
+exports.classifyUrl = classifyUrl;
 exports.commonMessages = commonMessages;
+exports.createAuditEntry = createAuditEntry;
 exports.dialogMessages = dialogMessages;
 exports.extractSpacingStyles = extractSpacingStyles;
 exports.formMessages = formMessages;
 exports.hexToRgb = hexToRgb;
 exports.initializeAppearance = initializeAppearance;
 exports.isExemptUrl = isExemptUrl;
+exports.isUtmExempt = isUtmExempt;
+exports.isValidUtmParams = isValidUtmParams;
 exports.methodologyMessages = methodologyMessages;
 exports.navigationMessages = navigationMessages;
 exports.paginationMessages = paginationMessages;
+exports.parseUtmParams = parseUtmParams;
 exports.prefersReducedMotion = prefersReducedMotion;
 exports.reportMessages = reportMessages;
+exports.requiresSellerAttribution = requiresSellerAttribution;
+exports.requiresUtm = requiresUtm;
 exports.resolveSpacing = resolveSpacing;
+exports.toFirstTouchAttribution = toFirstTouchAttribution;
 exports.toastMessages = toastMessages;
 exports.useAppearance = useAppearance;
 exports.useDateFormat = useDateFormat;
@@ -17040,5 +17450,7 @@ exports.useNumberFormat = useNumberFormat;
 exports.useRelativeTime = useRelativeTime;
 exports.useTextDirection = useTextDirection;
 exports.useToast = useToast;
+exports.validateCompliance = validateCompliance;
+exports.validateUtmField = validateUtmField;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map