@windstream/react-shared-components 0.1.19 → 0.1.20

package/dist/utils/index.d.ts

@@ -1,6 +1,111 @@
 import { ClassValue } from 'clsx';
 export { ClassValue, clsx } from 'clsx';
 
+/**
+ * UTM Parameter Types
+ *
+ * Type definitions for UTM tracking parameters used across Kinetic applications.
+ */
+/** All tracked UTM and click-ID parameter names */
+type UTMProperty = "utm_content" | "utm_medium" | "utm_campaign" | "utm_source" | "utm_term" | "utm_campaign_id" | "utm_adgroup_id" | "fbclid" | "gclid" | "msclkid";
+/** Partial record of UTM parameter values */
+type UTMProperties = Partial<Record<UTMProperty, string>>;
+/** Segment campaign context schema */
+interface CampaignProperties {
+    name?: string;
+    source?: string;
+    medium?: string;
+    term?: string;
+    content?: string;
+    campaign_id?: string;
+    adgroup_id?: string;
+    gclid?: string;
+    fbclid?: string;
+    msclkid?: string;
+}
+/** List of all UTM parameter names for filtering */
+declare const UTM_PARAM_NAMES: UTMProperty[];
+
+/**
+ * Cookie Helpers for UTM Parameter Storage
+ *
+ * Provides Base64-encoded JSON cookie storage for UTM parameters.
+ */
+
+/**
+ * Reads UTM parameters from the Base64-encoded cookie.
+ * @returns Parsed UTMProperties or null if cookie doesn't exist / is invalid.
+ */
+declare function getUTMs(): UTMProperties | null;
+/**
+ * Stores UTM parameters as a Base64-encoded JSON cookie.
+ * @param utms - The UTM properties to store.
+ * @param domain - Cookie domain (defaults to `.windstream.com`).
+ */
+declare function setUTMs(utms: UTMProperties, domain?: string): void;
+/**
+ * Removes the UTM cookie.
+ * @param domain - Cookie domain (defaults to `.windstream.com`).
+ */
+declare function removeUTMs(domain?: string): void;
+
+/**
+ * UTM Parameter Helpers
+ *
+ * Functions for extracting, combining, and mapping UTM parameters
+ * for marketing campaign attribution.
+ */
+
+/**
+ * Extracts UTM parameters from the current page URL.
+ * Parses window.location.search for the 10 tracked UTM/click-ID params.
+ * @returns UTMProperties with any found values, or null if none found.
+ */
+declare function getUtmParametersFromURL(): UTMProperties | null;
+/**
+ * Smart-merges existing (cookie) UTMs with newly arrived (URL) UTMs.
+ *
+ * Logic:
+ * - If the same campaign (campaign, medium, source, campaign_id, adgroup_id,
+ *   fbclid, gclid, msclkid all match): preserve existing utm_content and
+ *   utm_term (first-touch attribution for ad content/keyword).
+ * - If only campaign-level UTMs changed (no new content/term provided):
+ *   carry forward existing content/term from cookie.
+ * - If completely different campaign: new UTMs fully overwrite.
+ *
+ * @param existing - UTM values currently stored in cookie.
+ * @param incoming - UTM values extracted from the current URL.
+ * @returns Merged UTMProperties.
+ */
+declare function combineExistingAndNewUTMs(existing: UTMProperties | null, incoming: UTMProperties | null): UTMProperties;
+/**
+ * Generates synthetic UTM parameters for organic/direct traffic
+ * based on document.referrer.
+ *
+ * - No referrer → direct / direct
+ * - Google/Bing → organic / google or bing
+ * - Other external site (not windstream.com) → referral / <domain>
+ * - Internal (windstream.com) → null (no cookie set)
+ *
+ * @returns UTMProperties for organic traffic, or null for internal nav.
+ */
+declare function getOrganicTrafficUtmParameters(): UTMProperties | null;
+/**
+ * Maps UTMProperties to Segment's campaign context schema.
+ * @param utms - The UTM properties (typically from cookie).
+ * @returns CampaignProperties for Segment context.
+ */
+declare function getCampaignProperties(utms: UTMProperties | null): CampaignProperties | null;
+/**
+ * Builds a URL with non-UTM query params preserved and UTM params stripped.
+ * Used by the Link/Button component when preserveQueryParameters is true.
+ *
+ * @param href - The target URL/path.
+ * @param currentSearch - The current page's search string (e.g. "?foo=bar&utm_source=google").
+ * @returns The href with non-UTM params merged and UTM params removed.
+ */
+declare function buildPreservedQueryHref(href: string, currentSearch: string): string;
+
 /**
  * Utility function to combine class names using clsx
  * @param inputs - Class values to combine
@@ -8,4 +113,5 @@ export { ClassValue, clsx } from 'clsx';
  */
 declare const cx: (...val: ClassValue[]) => string;
 
-export { cx };
+export { UTM_PARAM_NAMES, buildPreservedQueryHref, combineExistingAndNewUTMs, cx, getCampaignProperties, getOrganicTrafficUtmParameters, getUTMs, getUtmParametersFromURL, removeUTMs, setUTMs };
+export type { CampaignProperties, UTMProperties, UTMProperty };

package/dist/utils/index.esm.js

@@ -1,2 +1,2 @@
-import{clsx as e}from"clsx";export{clsx}from"clsx";import{extendTailwindMerge as a}from"tailwind-merge";const n=a({extend:{classGroups:{"font-variants":["heading1","heading2","heading3","heading4","heading5","heading6","subheading1","subheading2","subheading3","subheading4","subheading5","subheading6","body1","body2","body3","footnote","micro","label1","label2","label3","label4"],"button-sizes":["btn-small","btn-medium","btn-large","btn-x-large"]}}}),i=(...a)=>n(e(...a));export{i as cx};
+import{clsx as t}from"clsx";export{clsx}from"clsx";import{extendTailwindMerge as e}from"tailwind-merge";import{Base64 as n}from"js-base64";import u from"js-cookie";const m="utm_parameters",r=".windstream.com";function i(){if("undefined"==typeof window)return null;const t=u.get(m);if(!t)return null;try{const e=n.decode(t);return JSON.parse(e)}catch(t){return null}}function o(t,e=r){if("undefined"==typeof window)return;const i=JSON.stringify(t),o=n.encode(i);u.set(m,o,{domain:e,path:"/",sameSite:"Lax"})}function c(t=r){u.remove(m,{domain:t,path:"/"})}const a=["utm_content","utm_medium","utm_campaign","utm_source","utm_term","utm_campaign_id","utm_adgroup_id","fbclid","gclid","msclkid"];function d(){if("undefined"==typeof window)return null;const t=new URLSearchParams(window.location.search),e={};let n=!1;for(const u of a){const m=t.get(u);m&&(e[u]=m,n=!0)}return n?e:null}function s(t,e){if(!e)return t||{};if(!t)return e;if(["utm_campaign","utm_medium","utm_source","utm_campaign_id","utm_adgroup_id","fbclid","gclid","msclkid"].every(n=>(t[n]||"")===(e[n]||"")))return{...e,utm_content:t.utm_content||e.utm_content,utm_term:t.utm_term||e.utm_term};const n=!!e.utm_content,u=!!e.utm_term;return{...e,...!n&&t.utm_content&&{utm_content:t.utm_content},...!u&&t.utm_term&&{utm_term:t.utm_term}}}function l(){if("undefined"==typeof document)return null;const t=document.referrer;if(!t)return{utm_medium:"direct",utm_source:"direct"};let e;try{e=new URL(t).hostname.toLowerCase()}catch(t){return{utm_medium:"direct",utm_source:"direct"}}return e.includes("windstream.com")||e.includes("gokinetic.com")?null:e.includes("google.")?{utm_medium:"organic",utm_source:"google"}:e.includes("bing.")?{utm_medium:"organic",utm_source:"bing"}:{utm_medium:"referral",utm_source:e}}function _(t){if(!t)return null;const e={};return t.utm_campaign&&(e.name=t.utm_campaign),t.utm_source&&(e.source=t.utm_source),t.utm_medium&&(e.medium=t.utm_medium),t.utm_term&&(e.term=t.utm_term),t.utm_content&&(e.content=t.utm_content),t.utm_campaign_id&&(e.campaign_id=t.utm_campaign_id),t.utm_adgroup_id&&(e.adgroup_id=t.utm_adgroup_id),t.gclid&&(e.gclid=t.gclid),t.fbclid&&(e.fbclid=t.fbclid),t.msclkid&&(e.msclkid=t.msclkid),Object.keys(e).length>0?e:null}function g(t,e){if(!e)return t;const n=new URLSearchParams(e),u=new Set(a),m=new Set([...u,"searchtext","page"]);let r,i;try{if(t.startsWith("http://")||t.startsWith("https://")){const e=new URL(t);r=e.origin+e.pathname,i=e.searchParams}else{const[e,n]=t.split("?");r=e,i=new URLSearchParams(n||"")}}catch(e){return t}const o=new URLSearchParams(i);n.forEach((t,e)=>{m.has(e.toLowerCase())||o.has(e)||o.set(e,t)});const c=o.toString();return c?`${r}?${c}`:r}const f=e({extend:{classGroups:{"font-variants":["heading1","heading2","heading3","heading4","heading5","heading6","subheading1","subheading2","subheading3","subheading4","subheading5","subheading6","body1","body2","body3","footnote","micro","label1","label2","label3","label4"],"button-sizes":["btn-small","btn-medium","btn-large","btn-x-large"]}}}),h=(...e)=>f(t(...e));export{a as UTM_PARAM_NAMES,g as buildPreservedQueryHref,s as combineExistingAndNewUTMs,h as cx,_ as getCampaignProperties,l as getOrganicTrafficUtmParameters,i as getUTMs,d as getUtmParametersFromURL,c as removeUTMs,o as setUTMs};
 //# sourceMappingURL=index.esm.js.map

package/dist/utils/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","sources":["../../src/utils/index.ts"],"sourcesContent":[null],"names":["twMerge","extendTailwindMerge","extend","classGroups","cx","val","clsx"],"mappings":"wGAGA,MAAMA,EAAUC,EAAoB,CAElCC,OAAQ,CACNC,YAAa,CACX,gBAA0B,CACxB,WACA,WACA,WACA,WACA,WACA,WACA,cACA,cACA,cACA,cACA,cACA,cACA,QACA,QACA,QACA,WACA,QACA,SACA,SACA,SACA,UAEF,eAAyB,CACvB,YACA,aACA,YACA,mBAWKC,EAAK,IAAIC,IAAsBL,EAAQM,KAAQD"}
+{"version":3,"file":"index.esm.js","sources":["../../src/utils/cookie.ts","../../src/types/utm.ts","../../src/utils/utm.ts","../../src/utils/index.ts"],"sourcesContent":[null,null,null,null],"names":["UTM_COOKIE_KEY","DEFAULT_DOMAIN","getUTMs","window","raw","Cookies","get","decoded","Base64","decode","JSON","parse","_a","setUTMs","utms","domain","json","stringify","encoded","encode","set","path","sameSite","removeUTMs","remove","UTM_PARAM_NAMES","getUtmParametersFromURL","searchParams","URLSearchParams","location","search","found","param","value","combineExistingAndNewUTMs","existing","incoming","every","key","utm_content","utm_term","hasNewContent","hasNewTerm","getOrganicTrafficUtmParameters","document","referrer","utm_medium","utm_source","referrerHost","URL","hostname","toLowerCase","includes","getCampaignProperties","campaign","utm_campaign","name","source","medium","term","content","utm_campaign_id","campaign_id","utm_adgroup_id","adgroup_id","gclid","fbclid","msclkid","Object","keys","length","buildPreservedQueryHref","href","currentSearch","currentParams","utmSet","Set","stripParams","basePath","targetParams","startsWith","url","origin","pathname","query","split","merged","forEach","has","queryString","toString","twMerge","extendTailwindMerge","extend","classGroups","cx","val","clsx"],"mappings":"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"}

package/dist/utils/index.js

@@ -1,2 +1,2 @@
-"use strict";var e=require("clsx");const n=require("tailwind-merge").extendTailwindMerge({extend:{classGroups:{"font-variants":["heading1","heading2","heading3","heading4","heading5","heading6","subheading1","subheading2","subheading3","subheading4","subheading5","subheading6","body1","body2","body3","footnote","micro","label1","label2","label3","label4"],"button-sizes":["btn-small","btn-medium","btn-large","btn-x-large"]}}});Object.defineProperty(exports,"clsx",{enumerable:!0,get:function(){return e.clsx}}),exports.cx=(...a)=>n(e.clsx(...a));
+"use strict";var e=require("clsx"),t=require("tailwind-merge"),n=require("js-base64"),r=require("js-cookie");const u="utm_parameters",i=".windstream.com";const m=["utm_content","utm_medium","utm_campaign","utm_source","utm_term","utm_campaign_id","utm_adgroup_id","fbclid","gclid","msclkid"];const c=t.extendTailwindMerge({extend:{classGroups:{"font-variants":["heading1","heading2","heading3","heading4","heading5","heading6","subheading1","subheading2","subheading3","subheading4","subheading5","subheading6","body1","body2","body3","footnote","micro","label1","label2","label3","label4"],"button-sizes":["btn-small","btn-medium","btn-large","btn-x-large"]}}});Object.defineProperty(exports,"clsx",{enumerable:!0,get:function(){return e.clsx}}),exports.UTM_PARAM_NAMES=m,exports.buildPreservedQueryHref=function(e,t){if(!t)return e;const n=new URLSearchParams(t),r=new Set(m),u=new Set([...r,"searchtext","page"]);let i,c;try{if(e.startsWith("http://")||e.startsWith("https://")){const t=new URL(e);i=t.origin+t.pathname,c=t.searchParams}else{const[t,n]=e.split("?");i=t,c=new URLSearchParams(n||"")}}catch(t){return e}const o=new URLSearchParams(c);n.forEach((e,t)=>{u.has(t.toLowerCase())||o.has(t)||o.set(t,e)});const s=o.toString();return s?`${i}?${s}`:i},exports.combineExistingAndNewUTMs=function(e,t){if(!t)return e||{};if(!e)return t;if(["utm_campaign","utm_medium","utm_source","utm_campaign_id","utm_adgroup_id","fbclid","gclid","msclkid"].every(n=>(e[n]||"")===(t[n]||"")))return{...t,utm_content:e.utm_content||t.utm_content,utm_term:e.utm_term||t.utm_term};const n=!!t.utm_content,r=!!t.utm_term;return{...t,...!n&&e.utm_content&&{utm_content:e.utm_content},...!r&&e.utm_term&&{utm_term:e.utm_term}}},exports.cx=(...t)=>c(e.clsx(...t)),exports.getCampaignProperties=function(e){if(!e)return null;const t={};return e.utm_campaign&&(t.name=e.utm_campaign),e.utm_source&&(t.source=e.utm_source),e.utm_medium&&(t.medium=e.utm_medium),e.utm_term&&(t.term=e.utm_term),e.utm_content&&(t.content=e.utm_content),e.utm_campaign_id&&(t.campaign_id=e.utm_campaign_id),e.utm_adgroup_id&&(t.adgroup_id=e.utm_adgroup_id),e.gclid&&(t.gclid=e.gclid),e.fbclid&&(t.fbclid=e.fbclid),e.msclkid&&(t.msclkid=e.msclkid),Object.keys(t).length>0?t:null},exports.getOrganicTrafficUtmParameters=function(){if("undefined"==typeof document)return null;const e=document.referrer;if(!e)return{utm_medium:"direct",utm_source:"direct"};let t;try{t=new URL(e).hostname.toLowerCase()}catch(e){return{utm_medium:"direct",utm_source:"direct"}}return t.includes("windstream.com")||t.includes("gokinetic.com")?null:t.includes("google.")?{utm_medium:"organic",utm_source:"google"}:t.includes("bing.")?{utm_medium:"organic",utm_source:"bing"}:{utm_medium:"referral",utm_source:t}},exports.getUTMs=function(){if("undefined"==typeof window)return null;const e=r.get(u);if(!e)return null;try{const t=n.Base64.decode(e);return JSON.parse(t)}catch(e){return null}},exports.getUtmParametersFromURL=function(){if("undefined"==typeof window)return null;const e=new URLSearchParams(window.location.search),t={};let n=!1;for(const r of m){const u=e.get(r);u&&(t[r]=u,n=!0)}return n?t:null},exports.removeUTMs=function(e=i){r.remove(u,{domain:e,path:"/"})},exports.setUTMs=function(e,t=i){if("undefined"==typeof window)return;const m=JSON.stringify(e),c=n.Base64.encode(m);r.set(u,c,{domain:t,path:"/",sameSite:"Lax"})};
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/utils/index.ts"],"sourcesContent":[null],"names":["twMerge","extendTailwindMerge","extend","classGroups","val","clsx"],"mappings":"mCAGA,MAAMA,4BAAUC,oBAAoB,CAElCC,OAAQ,CACNC,YAAa,CACX,gBAA0B,CACxB,WACA,WACA,WACA,WACA,WACA,WACA,cACA,cACA,cACA,cACA,cACA,cACA,QACA,QACA,QACA,WACA,QACA,SACA,SACA,SACA,UAEF,eAAyB,CACvB,YACA,aACA,YACA,kHAWU,IAAIC,IAAsBJ,EAAQK,EAAAA,QAAQD"}
+{"version":3,"file":"index.js","sources":["../../src/utils/cookie.ts","../../src/types/utm.ts","../../src/utils/index.ts","../../src/utils/utm.ts"],"sourcesContent":[null,null,null,null],"names":["UTM_COOKIE_KEY","DEFAULT_DOMAIN","UTM_PARAM_NAMES","twMerge","extendTailwindMerge","extend","classGroups","href","currentSearch","currentParams","URLSearchParams","utmSet","Set","stripParams","basePath","targetParams","startsWith","url","URL","origin","pathname","searchParams","path","query","split","_a","merged","forEach","value","key","has","toLowerCase","set","queryString","toString","existing","incoming","every","utm_content","utm_term","hasNewContent","hasNewTerm","val","clsx","utms","campaign","utm_campaign","name","utm_source","source","utm_medium","medium","term","content","utm_campaign_id","campaign_id","utm_adgroup_id","adgroup_id","gclid","fbclid","msclkid","Object","keys","length","document","referrer","referrerHost","hostname","includes","window","raw","Cookies","get","decoded","Base64","decode","JSON","parse","location","search","found","param","domain","remove","json","stringify","encoded","encode","sameSite"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windstream/react-shared-components",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "type": "module",
   "description": "Shared React components for Kinetic applications",
   "main": "dist/index.js",
@@ -104,12 +104,17 @@
     "@types/react-modal": "3.16.3",
     "@types/react-transition-group": "4.4.12",
     "clsx": "2.1.1",
+    "js-cookie": "^3.0.5",
+    "js-base64": "^3.7.7",
     "react-modal": "3.16.3",
     "react-select": "5.10.2",
     "react-transition-group": "4.4.5",
     "@radix-ui/react-dialog": "1.0.5",
     "framer-motion": "10.12.16"
   },
+  "optionalDependencies": {
+    "@types/js-cookie": "^3.0.6"
+  },
   "devDependencies": {
     "@ianvs/prettier-plugin-sort-imports": "4.7.0",
     "@rollup/plugin-commonjs": "28.0.6",

package/src/components/brand-button/index.tsx

@@ -42,7 +42,7 @@ export const BrandButton = forwardRef<
         primary_inverse:
           "bg-bg-surface-inverse text-text-inverse enabled:hover:bg-bg-fill-inverse-hover focus:ring-bg-surface-inverse",
         secondary:
-          "border border-border-secondary-on-bg-fill bg-bg-fill-secondary text-text hover:bg-bg-fill-secondary-hover focus:bg-bg-fill-secondary focus:ring-input-border-hover"
+          "border border-border-secondary-on-bg-fill bg-bg-fill-secondary text-text hover:bg-bg-fill-secondary-hover focus:bg-bg-fill-secondary focus:ring-input-border-hover",
       };
       const stateClasses = cx(
         (disabled || isLoading) && "cursor-not-allowed",

package/src/contentful/blocks/button/index.tsx

@@ -5,6 +5,7 @@ import { BrandButton } from "@shared/components/brand-button";
 import { Button as CoreButton } from "@shared/components/button";
 import { Link } from "@shared/components/link";
 import { MaterialIcon } from "@shared/components/material-icon";
+import { buildPreservedQueryHref } from "@shared/utils/utm";
 
 export const Button: React.FC<ButtonProps> = props => {
   const {
@@ -27,6 +28,7 @@ export const Button: React.FC<ButtonProps> = props => {
     onClick,
     iconName,
     size,
+    preserveQueryParameters,
     ...rest
   } = props;
 
@@ -56,16 +58,24 @@ export const Button: React.FC<ButtonProps> = props => {
     onClick?.(event);
   }
 
+  // Resolve the final href — merge non-UTM query params when preserveQueryParameters is true
+  const currentSearch =
+    typeof window !== "undefined" ? window.location.search : "";
+  const resolvedHref =
+    href && preserveQueryParameters && currentSearch
+      ? buildPreservedQueryHref(href, currentSearch)
+      : href;
+
   let CTA = (
     <CoreButton onClick={buttonClick} className={buttonClassName} {...rest} />
   );
 
   switch (showButtonAs) {
     case "solid":
-      CTA = href ? (
+      CTA = resolvedHref ? (
         <BrandButton
           as="a"
-          href={href}
+          href={resolvedHref}
           id={anchorId}
           variant={buttonVariant}
           text={buttonLabel}
@@ -89,7 +99,7 @@ export const Button: React.FC<ButtonProps> = props => {
     case "text":
       CTA = (
         <Link
-          href={href}
+          href={resolvedHref}
           target={target}
           variant={linkVariant || "default"}
           className={`text-text-brand ${linkClassName || ""}`}

package/src/contentful/blocks/button/types.ts

@@ -1,7 +1,7 @@
 import React from "react";
 
-import { CheckPlansProps } from "@shared/types/micro-components";
 import { ResponsiveSize } from "@shared/components/brand-button/types";
+import { CheckPlansProps } from "@shared/types/micro-components";
 
 export type ButtonProps = {
   showButtonAs?: "solid" | "text" | "unstyled";

package/src/contentful/blocks/floating-banner/index.tsx

@@ -74,7 +74,11 @@ export const FloatingBanner: React.FC<FloatingBannerProps> = ({
           </div>
           {cta && (
             <div className="mt-5 flex justify-center lg:mt-0 lg:w-[500px] lg:items-center">
-              <Button {...cta} buttonVariant="secondary" size={{ base: "medium", md: "large" }}></Button>
+              <Button
+                {...cta}
+                buttonVariant="secondary"
+                size={{ base: "medium", md: "large" }}
+              ></Button>
             </div>
           )}
         </div>

package/src/utils/index.ts

@@ -47,3 +47,19 @@ export const cx = (...val: ClassValue[]) => twMerge(clsx(...val));
 
 export { clsx };
 export type { ClassValue };
+
+// UTM & Cookie utilities
+export { getUTMs, setUTMs, removeUTMs } from "./cookie";
+export {
+  getUtmParametersFromURL,
+  combineExistingAndNewUTMs,
+  getOrganicTrafficUtmParameters,
+  getCampaignProperties,
+  buildPreservedQueryHref,
+} from "./utm";
+export type {
+  UTMProperty,
+  UTMProperties,
+  CampaignProperties,
+} from "../types/utm";
+export { UTM_PARAM_NAMES } from "../types/utm";