merchi_cart 1.4.5 → 1.4.6

package/esm/CartProvider.js

@@ -32,6 +32,7 @@ import { makeProduct } from './utilities/product';
 import { getSavedCheckoutCustomer, saveCheckoutAddress } from './utilities/local_storage';
 import { makeUser } from './utilities/user';
 import { persistTestCheckoutFlag, readTestCheckoutFlag } from './utilities/test_checkout';
+import { appendJobSourceToFormData, captureAndReadJobSource, cartNeedsSourceUpdate, jobSourceFieldsForApi } from './utilities/job_source';
 import { jsx as _jsx } from "react/jsx-runtime";
 var CartContext = /*#__PURE__*/createContext({
   cart: {},
@@ -500,66 +501,57 @@ var CartProvider = function CartProvider(_ref) {
   }
   function _createCartAndCookie() {
     _createCartAndCookie = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2(callback) {
-      var isTest, _cart, created, _cartJson;
+      var isTest, jobSource, _cart, query, created, _cartJson;
       return _regeneratorRuntime().wrap(function _callee2$(_context2) {
         while (1) switch (_context2.prev = _context2.next) {
           case 0:
             setFetchingCart(true);
             _context2.prev = 1;
             isTest = readTestCheckoutFlag();
+            jobSource = jobSourceFieldsForApi(captureAndReadJobSource());
             _cart = makeCart({
               domain: {
                 id: domainId
               },
               isTest: isTest
             }, true);
-            if (!isTest) {
-              _context2.next = 11;
-              break;
-            }
-            _context2.next = 7;
+            query = [['embed', JSON.stringify(cartEmbed)], ['skip_rights', 'y']];
+            if (isTest) query.push(['is_test', 'true']);
+            _context2.next = 9;
             return merchi.authenticatedFetch('/carts/', {
               method: 'POST',
-              body: _cart.toFormData(),
-              query: [['embed', JSON.stringify(cartEmbed)], ['skip_rights', 'y'], ['is_test', 'true']]
+              body: appendJobSourceToFormData(_cart.toFormData(), jobSource),
+              query: query
             });
-          case 7:
+          case 9:
             created = _context2.sent;
             _cart.fromJson(created.cart);
             _context2.next = 13;
-            break;
-          case 11:
-            _context2.next = 13;
-            return _cart.create({
-              embed: cartEmbed
-            });
-          case 13:
-            _context2.next = 15;
             return _cart.toJson();
-          case 15:
+          case 13:
             _cartJson = _context2.sent;
             if (domainId) setCartCookie(Number(domainId), _cartJson, undefined, isTest);
-            _context2.next = 19;
+            _context2.next = 17;
             return attachSavedClientIfNeeded(_cartJson);
-          case 19:
+          case 17:
             _cartJson = _context2.sent;
             setCart(_objectSpread({}, _cartJson));
             if (callback) callback();
-            _context2.next = 27;
+            _context2.next = 25;
             break;
-          case 24:
-            _context2.prev = 24;
+          case 22:
+            _context2.prev = 22;
             _context2.t0 = _context2["catch"](1);
             alertError(_context2.t0.errorMessage || _context2.t0.message || 'Unable to fetch cart.');
-          case 27:
-            _context2.prev = 27;
+          case 25:
+            _context2.prev = 25;
             setFetchingCart(false);
-            return _context2.finish(27);
-          case 30:
+            return _context2.finish(25);
+          case 28:
           case "end":
             return _context2.stop();
         }
-      }, _callee2, null, [[1, 24, 27, 30]]);
+      }, _callee2, null, [[1, 22, 25, 28]]);
     }));
     return _createCartAndCookie.apply(this, arguments);
   }
@@ -568,7 +560,7 @@ var CartProvider = function CartProvider(_ref) {
   }
   function _getCart() {
     _getCart = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3(cartIdAndToken) {
-      var id, _cart2, _cartJson2, isTest;
+      var id, _cart2, _cartJson2, isTest, jobSource, saved;
       return _regeneratorRuntime().wrap(function _callee3$(_context3) {
         while (1) switch (_context3.prev = _context3.next) {
           case 0:
@@ -596,37 +588,53 @@ var CartProvider = function CartProvider(_ref) {
           case 14:
             return _context3.abrupt("return");
           case 15:
-            if (!(stripeIsValidAndActive(_cartJson2) || isTest)) {
+            jobSource = jobSourceFieldsForApi(captureAndReadJobSource());
+            if (!cartNeedsSourceUpdate(_cartJson2, jobSource)) {
               _context3.next = 22;
               break;
             }
-            _context3.next = 18;
+            _context3.next = 19;
+            return merchi.authenticatedFetch("/carts/".concat(_cart2.id, "/"), {
+              method: 'PATCH',
+              body: appendJobSourceToFormData(_cart2.toFormData(), jobSource),
+              query: [['embed', JSON.stringify(cartEmbed)], ['skip_rights', 'y']]
+            });
+          case 19:
+            saved = _context3.sent;
+            _cart2.fromJson(saved.cart);
+            _cartJson2 = _cart2.toJson();
+          case 22:
+            if (!(stripeIsValidAndActive(_cartJson2) || isTest)) {
+              _context3.next = 29;
+              break;
+            }
+            _context3.next = 25;
             return attachSavedClientIfNeeded(_cartJson2);
-          case 18:
+          case 25:
             _cartJson2 = _context3.sent;
             setCart(_objectSpread({}, _cartJson2));
-            _context3.next = 24;
+            _context3.next = 31;
             break;
-          case 22:
+          case 29:
             console.error("MErhci cart error: Stripe payment " + "options have not been correctly set up. " + "Check the company profile payment options tab " + "to set and edit stripe payment options.");
             setCartSettingsInvalid(true);
-          case 24:
-            _context3.next = 30;
+          case 31:
+            _context3.next = 37;
             break;
-          case 26:
-            _context3.prev = 26;
+          case 33:
+            _context3.prev = 33;
             _context3.t0 = _context3["catch"](3);
-            _context3.next = 30;
+            _context3.next = 37;
             return createCartAndCookie();
-          case 30:
-            _context3.prev = 30;
+          case 37:
+            _context3.prev = 37;
             setFetchingCart(false);
-            return _context3.finish(30);
-          case 33:
+            return _context3.finish(37);
+          case 40:
           case "end":
             return _context3.stop();
         }
-      }, _callee3, null, [[3, 26, 30, 33]]);
+      }, _callee3, null, [[3, 33, 37, 40]]);
     }));
     return _getCart.apply(this, arguments);
   }

package/esm/utilities/index.js

@@ -6,6 +6,7 @@ export * from './currency';
 export * from './helpers';
 export * from './invoice';
 export * from './job';
+export * from './job_source';
 export * from './local_storage';
 export * from './product';
 export * from './shipment';

package/esm/utilities/job_source.js

@@ -0,0 +1,139 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+export var JOB_SOURCE_STORAGE_KEY = 'merchi_job_source';
+var CLICK_ID_PARAMS = ['gclid', 'gbraid', 'wbraid', 'fbclid', 'msclkid'];
+var UTM_PARAMS = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_content', 'utm_term'];
+function trimTo(value, limit) {
+  if (!value) return undefined;
+  var text = value.trim().slice(0, limit);
+  return text || undefined;
+}
+function readSearchParams() {
+  if (typeof window === 'undefined') return new URLSearchParams();
+  try {
+    return new URLSearchParams(window.location.search);
+  } catch (_unused) {
+    return new URLSearchParams();
+  }
+}
+function readStoredSource() {
+  if (typeof window === 'undefined') return null;
+  try {
+    var raw = window.localStorage.getItem(JOB_SOURCE_STORAGE_KEY);
+    if (!raw) return null;
+    var parsed = JSON.parse(raw);
+    if (!parsed || _typeof(parsed) !== 'object') return null;
+    return parsed;
+  } catch (_unused2) {
+    return null;
+  }
+}
+function writeStoredSource(source) {
+  if (typeof window === 'undefined') return;
+  try {
+    window.localStorage.setItem(JOB_SOURCE_STORAGE_KEY, JSON.stringify(source));
+  } catch (_unused3) {
+    // Ignore quota / private-mode failures.
+  }
+}
+function currentLanding() {
+  if (typeof window === 'undefined') return undefined;
+  try {
+    var path = "".concat(window.location.pathname || '/').concat(window.location.search || '');
+    return trimTo(path, 512);
+  } catch (_unused4) {
+    return undefined;
+  }
+}
+function currentReferrer() {
+  if (typeof document === 'undefined') return undefined;
+  try {
+    return trimTo(document.referrer, 512);
+  } catch (_unused5) {
+    return undefined;
+  }
+}
+export function sourceFromLocation() {
+  var params = readSearchParams();
+  var source = {
+    utmSource: trimTo(params.get('utm_source'), 256),
+    utmMedium: trimTo(params.get('utm_medium'), 256),
+    utmCampaign: trimTo(params.get('utm_campaign'), 256),
+    utmContent: trimTo(params.get('utm_content'), 256),
+    utmTerm: trimTo(params.get('utm_term'), 256),
+    sourceLanding: currentLanding(),
+    sourceReferrer: currentReferrer()
+  };
+  var _iterator = _createForOfIteratorHelper(CLICK_ID_PARAMS),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var key = _step.value;
+      var value = trimTo(params.get(key), 256);
+      if (value) {
+        source.sourceClickId = value;
+        break;
+      }
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return source;
+}
+export function hasPaidClick(source) {
+  return Boolean(source === null || source === void 0 ? void 0 : source.sourceClickId);
+}
+export function hasSourceData(source) {
+  if (!source) return false;
+  return Boolean(source.utmSource || source.utmMedium || source.utmCampaign || source.utmContent || source.utmTerm || source.sourceClickId || source.sourceLanding || source.sourceReferrer);
+}
+export function captureAndReadJobSource() {
+  var incoming = sourceFromLocation();
+  var stored = readStoredSource();
+  if (hasPaidClick(incoming) || !hasSourceData(stored)) {
+    var next = _objectSpread(_objectSpread({}, stored || {}), Object.fromEntries(Object.entries(incoming).filter(function (_ref) {
+      var _ref2 = _slicedToArray(_ref, 2),
+        value = _ref2[1];
+      return Boolean(value);
+    })));
+    if (hasSourceData(next)) writeStoredSource(next);
+    return next;
+  }
+  return stored || incoming;
+}
+export function jobSourceFieldsForApi(source) {
+  var resolved = source || captureAndReadJobSource();
+  var out = {};
+  Object.keys(resolved).forEach(function (key) {
+    var value = resolved[key];
+    if (value) out[key] = value;
+  });
+  return out;
+}
+export function cartNeedsSourceUpdate(cart, source) {
+  if (!hasSourceData(source)) return false;
+  if (!(cart !== null && cart !== void 0 && cart.utmSource) && !(cart !== null && cart !== void 0 && cart.sourceClickId) && !(cart !== null && cart !== void 0 && cart.sourceChannel)) return true;
+  return Boolean(source.sourceClickId && !(cart !== null && cart !== void 0 && cart.sourceClickId));
+}
+export var JOB_SOURCE_URL_KEYS = [].concat(UTM_PARAMS, CLICK_ID_PARAMS);
+export function appendJobSourceToFormData(data, source) {
+  var fields = jobSourceFieldsForApi(source);
+  Object.keys(fields).forEach(function (key) {
+    var value = fields[key];
+    if (value) data.append(key, value);
+  });
+  return data;
+}

package/esm/utilities/job_source.test.js

@@ -0,0 +1,75 @@
+import { JOB_SOURCE_STORAGE_KEY, captureAndReadJobSource, cartNeedsSourceUpdate, hasPaidClick } from './job_source';
+describe('job source capture', function () {
+  var originalLocation = window.location;
+  var originalReferrer = document.referrer;
+  beforeEach(function () {
+    window.localStorage.clear();
+    delete window.location;
+    window.location = {
+      search: '',
+      pathname: '/tyvek-wristbands'
+    };
+    Object.defineProperty(document, 'referrer', {
+      configurable: true,
+      value: ''
+    });
+  });
+  afterEach(function () {
+    window.location = originalLocation;
+    Object.defineProperty(document, 'referrer', {
+      configurable: true,
+      value: originalReferrer
+    });
+    window.localStorage.clear();
+  });
+  it('captures google ads click ids and landing path', function () {
+    window.location = {
+      search: '?utm_source=google&utm_medium=cpc&gclid=EAIa&utm_campaign=bands',
+      pathname: '/tyvek-wristbands'
+    };
+    var source = captureAndReadJobSource();
+    expect(source.utmSource).toBe('google');
+    expect(source.utmMedium).toBe('cpc');
+    expect(source.utmCampaign).toBe('bands');
+    expect(source.sourceClickId).toBe('EAIa');
+    expect(source.sourceLanding).toBe('/tyvek-wristbands?utm_source=google&utm_medium=cpc&gclid=EAIa&utm_campaign=bands');
+    expect(hasPaidClick(source)).toBe(true);
+  });
+  it('keeps first-touch UTMs unless a paid click arrives later', function () {
+    window.location = {
+      search: '?utm_source=newsletter&utm_medium=email',
+      pathname: '/'
+    };
+    captureAndReadJobSource();
+    window.location = {
+      search: '?utm_source=google&utm_medium=cpc',
+      pathname: '/product'
+    };
+    expect(captureAndReadJobSource().utmSource).toBe('newsletter');
+    window.location = {
+      search: '?gclid=NEWCLICK&utm_source=google',
+      pathname: '/product'
+    };
+    expect(captureAndReadJobSource().sourceClickId).toBe('NEWCLICK');
+    expect(window.localStorage.getItem(JOB_SOURCE_STORAGE_KEY)).toContain('NEWCLICK');
+  });
+  it('knows when an existing cart still needs source fields', function () {
+    expect(cartNeedsSourceUpdate({}, {
+      utmSource: 'google',
+      sourceClickId: 'x'
+    })).toBe(true);
+    expect(cartNeedsSourceUpdate({
+      utmSource: 'google'
+    }, {
+      utmSource: 'google',
+      sourceClickId: 'x'
+    })).toBe(true);
+    expect(cartNeedsSourceUpdate({
+      utmSource: 'google',
+      sourceClickId: 'x'
+    }, {
+      utmSource: 'google',
+      sourceClickId: 'x'
+    })).toBe(false);
+  });
+});

package/lib/CartProvider.js

@@ -19,6 +19,7 @@ var _product = require("./utilities/product");
 var _local_storage = require("./utilities/local_storage");
 var _user = require("./utilities/user");
 var _test_checkout = require("./utilities/test_checkout");
+var _job_source = require("./utilities/job_source");
 var _jsxRuntime = require("react/jsx-runtime");
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { "default": e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n["default"] = e, t && t.set(e, n), n; }
@@ -507,66 +508,57 @@ var CartProvider = function CartProvider(_ref) {
   }
   function _createCartAndCookie() {
     _createCartAndCookie = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2(callback) {
-      var isTest, _cart, created, _cartJson;
+      var isTest, jobSource, _cart, query, created, _cartJson;
       return _regeneratorRuntime().wrap(function _callee2$(_context2) {
         while (1) switch (_context2.prev = _context2.next) {
           case 0:
             setFetchingCart(true);
             _context2.prev = 1;
             isTest = (0, _test_checkout.readTestCheckoutFlag)();
+            jobSource = (0, _job_source.jobSourceFieldsForApi)((0, _job_source.captureAndReadJobSource)());
             _cart = (0, _cart3.makeCart)({
               domain: {
                 id: domainId
               },
               isTest: isTest
             }, true);
-            if (!isTest) {
-              _context2.next = 11;
-              break;
-            }
-            _context2.next = 7;
+            query = [['embed', JSON.stringify(_helpers.cartEmbed)], ['skip_rights', 'y']];
+            if (isTest) query.push(['is_test', 'true']);
+            _context2.next = 9;
             return merchi.authenticatedFetch('/carts/', {
               method: 'POST',
-              body: _cart.toFormData(),
-              query: [['embed', JSON.stringify(_helpers.cartEmbed)], ['skip_rights', 'y'], ['is_test', 'true']]
+              body: (0, _job_source.appendJobSourceToFormData)(_cart.toFormData(), jobSource),
+              query: query
             });
-          case 7:
+          case 9:
             created = _context2.sent;
             _cart.fromJson(created.cart);
             _context2.next = 13;
-            break;
-          case 11:
-            _context2.next = 13;
-            return _cart.create({
-              embed: _helpers.cartEmbed
-            });
-          case 13:
-            _context2.next = 15;
             return _cart.toJson();
-          case 15:
+          case 13:
             _cartJson = _context2.sent;
             if (domainId) (0, _cookie.setCartCookie)(Number(domainId), _cartJson, undefined, isTest);
-            _context2.next = 19;
+            _context2.next = 17;
             return attachSavedClientIfNeeded(_cartJson);
-          case 19:
+          case 17:
             _cartJson = _context2.sent;
             setCart(_objectSpread({}, _cartJson));
             if (callback) callback();
-            _context2.next = 27;
+            _context2.next = 25;
             break;
-          case 24:
-            _context2.prev = 24;
+          case 22:
+            _context2.prev = 22;
             _context2.t0 = _context2["catch"](1);
             alertError(_context2.t0.errorMessage || _context2.t0.message || 'Unable to fetch cart.');
-          case 27:
-            _context2.prev = 27;
+          case 25:
+            _context2.prev = 25;
             setFetchingCart(false);
-            return _context2.finish(27);
-          case 30:
+            return _context2.finish(25);
+          case 28:
           case "end":
             return _context2.stop();
         }
-      }, _callee2, null, [[1, 24, 27, 30]]);
+      }, _callee2, null, [[1, 22, 25, 28]]);
     }));
     return _createCartAndCookie.apply(this, arguments);
   }
@@ -575,7 +567,7 @@ var CartProvider = function CartProvider(_ref) {
   }
   function _getCart() {
     _getCart = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3(cartIdAndToken) {
-      var id, _cart2, _cartJson2, isTest;
+      var id, _cart2, _cartJson2, isTest, jobSource, saved;
       return _regeneratorRuntime().wrap(function _callee3$(_context3) {
         while (1) switch (_context3.prev = _context3.next) {
           case 0:
@@ -603,37 +595,53 @@ var CartProvider = function CartProvider(_ref) {
           case 14:
             return _context3.abrupt("return");
           case 15:
-            if (!((0, _cart3.stripeIsValidAndActive)(_cartJson2) || isTest)) {
+            jobSource = (0, _job_source.jobSourceFieldsForApi)((0, _job_source.captureAndReadJobSource)());
+            if (!(0, _job_source.cartNeedsSourceUpdate)(_cartJson2, jobSource)) {
               _context3.next = 22;
               break;
             }
-            _context3.next = 18;
+            _context3.next = 19;
+            return merchi.authenticatedFetch("/carts/".concat(_cart2.id, "/"), {
+              method: 'PATCH',
+              body: (0, _job_source.appendJobSourceToFormData)(_cart2.toFormData(), jobSource),
+              query: [['embed', JSON.stringify(_helpers.cartEmbed)], ['skip_rights', 'y']]
+            });
+          case 19:
+            saved = _context3.sent;
+            _cart2.fromJson(saved.cart);
+            _cartJson2 = _cart2.toJson();
+          case 22:
+            if (!((0, _cart3.stripeIsValidAndActive)(_cartJson2) || isTest)) {
+              _context3.next = 29;
+              break;
+            }
+            _context3.next = 25;
             return attachSavedClientIfNeeded(_cartJson2);
-          case 18:
+          case 25:
             _cartJson2 = _context3.sent;
             setCart(_objectSpread({}, _cartJson2));
-            _context3.next = 24;
+            _context3.next = 31;
             break;
-          case 22:
+          case 29:
             console.error("MErhci cart error: Stripe payment " + "options have not been correctly set up. " + "Check the company profile payment options tab " + "to set and edit stripe payment options.");
             setCartSettingsInvalid(true);
-          case 24:
-            _context3.next = 30;
+          case 31:
+            _context3.next = 37;
             break;
-          case 26:
-            _context3.prev = 26;
+          case 33:
+            _context3.prev = 33;
             _context3.t0 = _context3["catch"](3);
-            _context3.next = 30;
+            _context3.next = 37;
             return createCartAndCookie();
-          case 30:
-            _context3.prev = 30;
+          case 37:
+            _context3.prev = 37;
             setFetchingCart(false);
-            return _context3.finish(30);
-          case 33:
+            return _context3.finish(37);
+          case 40:
           case "end":
             return _context3.stop();
         }
-      }, _callee3, null, [[3, 26, 30, 33]]);
+      }, _callee3, null, [[3, 33, 37, 40]]);
     }));
     return _getCart.apply(this, arguments);
   }

package/lib/utilities/index.d.ts

@@ -6,6 +6,7 @@ export * from './currency';
 export * from './helpers';
 export * from './invoice';
 export * from './job';
+export * from './job_source';
 export * from './local_storage';
 export * from './product';
 export * from './shipment';

package/lib/utilities/index.js

@@ -91,6 +91,17 @@ Object.keys(_job).forEach(function (key) {
     }
   });
 });
+var _job_source = require("./job_source");
+Object.keys(_job_source).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _job_source[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _job_source[key];
+    }
+  });
+});
 var _local_storage = require("./local_storage");
 Object.keys(_local_storage).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/lib/utilities/job_source.d.ts

@@ -0,0 +1,23 @@
+export declare const JOB_SOURCE_STORAGE_KEY = "merchi_job_source";
+export interface JobSourceFields {
+    utmSource?: string;
+    utmMedium?: string;
+    utmCampaign?: string;
+    utmContent?: string;
+    utmTerm?: string;
+    sourceClickId?: string;
+    sourceLanding?: string;
+    sourceReferrer?: string;
+}
+export declare function sourceFromLocation(): JobSourceFields;
+export declare function hasPaidClick(source: JobSourceFields | null | undefined): boolean;
+export declare function hasSourceData(source: JobSourceFields | null | undefined): boolean;
+export declare function captureAndReadJobSource(): JobSourceFields;
+export declare function jobSourceFieldsForApi(source?: JobSourceFields | null): JobSourceFields;
+export declare function cartNeedsSourceUpdate(cart: {
+    utmSource?: string;
+    sourceClickId?: string;
+    sourceChannel?: string;
+} | null | undefined, source: JobSourceFields): boolean;
+export declare const JOB_SOURCE_URL_KEYS: ("gclid" | "gbraid" | "wbraid" | "fbclid" | "msclkid" | "utm_source" | "utm_medium" | "utm_campaign" | "utm_content" | "utm_term")[];
+export declare function appendJobSourceToFormData(data: FormData, source?: JobSourceFields | null): FormData;

package/lib/utilities/job_source.js

@@ -0,0 +1,152 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.JOB_SOURCE_URL_KEYS = exports.JOB_SOURCE_STORAGE_KEY = void 0;
+exports.appendJobSourceToFormData = appendJobSourceToFormData;
+exports.captureAndReadJobSource = captureAndReadJobSource;
+exports.cartNeedsSourceUpdate = cartNeedsSourceUpdate;
+exports.hasPaidClick = hasPaidClick;
+exports.hasSourceData = hasSourceData;
+exports.jobSourceFieldsForApi = jobSourceFieldsForApi;
+exports.sourceFromLocation = sourceFromLocation;
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+var JOB_SOURCE_STORAGE_KEY = exports.JOB_SOURCE_STORAGE_KEY = 'merchi_job_source';
+var CLICK_ID_PARAMS = ['gclid', 'gbraid', 'wbraid', 'fbclid', 'msclkid'];
+var UTM_PARAMS = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_content', 'utm_term'];
+function trimTo(value, limit) {
+  if (!value) return undefined;
+  var text = value.trim().slice(0, limit);
+  return text || undefined;
+}
+function readSearchParams() {
+  if (typeof window === 'undefined') return new URLSearchParams();
+  try {
+    return new URLSearchParams(window.location.search);
+  } catch (_unused) {
+    return new URLSearchParams();
+  }
+}
+function readStoredSource() {
+  if (typeof window === 'undefined') return null;
+  try {
+    var raw = window.localStorage.getItem(JOB_SOURCE_STORAGE_KEY);
+    if (!raw) return null;
+    var parsed = JSON.parse(raw);
+    if (!parsed || _typeof(parsed) !== 'object') return null;
+    return parsed;
+  } catch (_unused2) {
+    return null;
+  }
+}
+function writeStoredSource(source) {
+  if (typeof window === 'undefined') return;
+  try {
+    window.localStorage.setItem(JOB_SOURCE_STORAGE_KEY, JSON.stringify(source));
+  } catch (_unused3) {
+    // Ignore quota / private-mode failures.
+  }
+}
+function currentLanding() {
+  if (typeof window === 'undefined') return undefined;
+  try {
+    var path = "".concat(window.location.pathname || '/').concat(window.location.search || '');
+    return trimTo(path, 512);
+  } catch (_unused4) {
+    return undefined;
+  }
+}
+function currentReferrer() {
+  if (typeof document === 'undefined') return undefined;
+  try {
+    return trimTo(document.referrer, 512);
+  } catch (_unused5) {
+    return undefined;
+  }
+}
+function sourceFromLocation() {
+  var params = readSearchParams();
+  var source = {
+    utmSource: trimTo(params.get('utm_source'), 256),
+    utmMedium: trimTo(params.get('utm_medium'), 256),
+    utmCampaign: trimTo(params.get('utm_campaign'), 256),
+    utmContent: trimTo(params.get('utm_content'), 256),
+    utmTerm: trimTo(params.get('utm_term'), 256),
+    sourceLanding: currentLanding(),
+    sourceReferrer: currentReferrer()
+  };
+  var _iterator = _createForOfIteratorHelper(CLICK_ID_PARAMS),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var key = _step.value;
+      var value = trimTo(params.get(key), 256);
+      if (value) {
+        source.sourceClickId = value;
+        break;
+      }
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return source;
+}
+function hasPaidClick(source) {
+  return Boolean(source === null || source === void 0 ? void 0 : source.sourceClickId);
+}
+function hasSourceData(source) {
+  if (!source) return false;
+  return Boolean(source.utmSource || source.utmMedium || source.utmCampaign || source.utmContent || source.utmTerm || source.sourceClickId || source.sourceLanding || source.sourceReferrer);
+}
+function captureAndReadJobSource() {
+  var incoming = sourceFromLocation();
+  var stored = readStoredSource();
+  if (hasPaidClick(incoming) || !hasSourceData(stored)) {
+    var next = _objectSpread(_objectSpread({}, stored || {}), Object.fromEntries(Object.entries(incoming).filter(function (_ref) {
+      var _ref2 = _slicedToArray(_ref, 2),
+        value = _ref2[1];
+      return Boolean(value);
+    })));
+    if (hasSourceData(next)) writeStoredSource(next);
+    return next;
+  }
+  return stored || incoming;
+}
+function jobSourceFieldsForApi(source) {
+  var resolved = source || captureAndReadJobSource();
+  var out = {};
+  Object.keys(resolved).forEach(function (key) {
+    var value = resolved[key];
+    if (value) out[key] = value;
+  });
+  return out;
+}
+function cartNeedsSourceUpdate(cart, source) {
+  if (!hasSourceData(source)) return false;
+  if (!(cart !== null && cart !== void 0 && cart.utmSource) && !(cart !== null && cart !== void 0 && cart.sourceClickId) && !(cart !== null && cart !== void 0 && cart.sourceChannel)) return true;
+  return Boolean(source.sourceClickId && !(cart !== null && cart !== void 0 && cart.sourceClickId));
+}
+var JOB_SOURCE_URL_KEYS = exports.JOB_SOURCE_URL_KEYS = [].concat(UTM_PARAMS, CLICK_ID_PARAMS);
+function appendJobSourceToFormData(data, source) {
+  var fields = jobSourceFieldsForApi(source);
+  Object.keys(fields).forEach(function (key) {
+    var value = fields[key];
+    if (value) data.append(key, value);
+  });
+  return data;
+}

package/lib/utilities/job_source.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "merchi_cart",
-  "version": "1.4.5",
+  "version": "1.4.6",
   "description": "Merchi's cart",
   "source": "src/index.ts",
   "main": "lib/index.js",

package/src/CartProvider.tsx

@@ -21,6 +21,12 @@ import {
 } from './utilities/local_storage';
 import { makeUser } from './utilities/user';
 import { persistTestCheckoutFlag, readTestCheckoutFlag } from './utilities/test_checkout';
+import {
+  appendJobSourceToFormData,
+  captureAndReadJobSource,
+  cartNeedsSourceUpdate,
+  jobSourceFieldsForApi,
+} from './utilities/job_source';
 
 export interface PropsCart {
   cart: any;
@@ -622,21 +628,19 @@ const CartProvider = ({
     setFetchingCart(true);
     try {
       const isTest = readTestCheckoutFlag();
+      const jobSource = jobSourceFieldsForApi(captureAndReadJobSource());
       const cart = makeCart({domain: {id: domainId}, isTest}, true);
-      if (isTest) {
-        const created = await merchi.authenticatedFetch('/carts/', {
-          method: 'POST',
-          body: cart.toFormData(),
-          query: [
-            ['embed', JSON.stringify(cartEmbed)],
-            ['skip_rights', 'y'],
-            ['is_test', 'true'],
-          ],
-        });
-        cart.fromJson(created.cart);
-      } else {
-        await cart.create({embed: cartEmbed});
-      }
+      const query: Array<[string, string]> = [
+        ['embed', JSON.stringify(cartEmbed)],
+        ['skip_rights', 'y'],
+      ];
+      if (isTest) query.push(['is_test', 'true']);
+      const created = await merchi.authenticatedFetch('/carts/', {
+        method: 'POST',
+        body: appendJobSourceToFormData(cart.toFormData() as FormData, jobSource),
+        query,
+      });
+      cart.fromJson(created.cart);
       let cartJson = await cart.toJson();
       if (domainId) setCartCookie(Number(domainId), cartJson, undefined, isTest);
       cartJson = await attachSavedClientIfNeeded(cartJson);
@@ -663,6 +667,19 @@ const CartProvider = ({
         await createCartAndCookie();
         return;
       }
+      const jobSource = jobSourceFieldsForApi(captureAndReadJobSource());
+      if (cartNeedsSourceUpdate(cartJson, jobSource)) {
+        const saved = await merchi.authenticatedFetch(`/carts/${cart.id}/`, {
+          method: 'PATCH',
+          body: appendJobSourceToFormData(cart.toFormData() as FormData, jobSource),
+          query: [
+            ['embed', JSON.stringify(cartEmbed)],
+            ['skip_rights', 'y'],
+          ],
+        });
+        cart.fromJson(saved.cart);
+        cartJson = cart.toJson();
+      }
       if (stripeIsValidAndActive(cartJson) || isTest) {
         cartJson = await attachSavedClientIfNeeded(cartJson);
         setCart({...cartJson});

package/src/utilities/index.ts

@@ -6,6 +6,7 @@ export * from './currency';
 export * from './helpers';
 export * from './invoice';
 export * from './job';
+export * from './job_source';
 export * from './local_storage';
 export * from './product';
 export * from './shipment';

package/src/utilities/job_source.test.ts

@@ -0,0 +1,86 @@
+import {
+  JOB_SOURCE_STORAGE_KEY,
+  captureAndReadJobSource,
+  cartNeedsSourceUpdate,
+  hasPaidClick,
+} from './job_source';
+
+describe('job source capture', () => {
+  const originalLocation = window.location;
+  const originalReferrer = document.referrer;
+
+  beforeEach(() => {
+    window.localStorage.clear();
+    delete (window as any).location;
+    (window as any).location = {
+      search: '',
+      pathname: '/tyvek-wristbands',
+    };
+    Object.defineProperty(document, 'referrer', {
+      configurable: true,
+      value: '',
+    });
+  });
+
+  afterEach(() => {
+    (window as any).location = originalLocation;
+    Object.defineProperty(document, 'referrer', {
+      configurable: true,
+      value: originalReferrer,
+    });
+    window.localStorage.clear();
+  });
+
+  it('captures google ads click ids and landing path', () => {
+    (window as any).location = {
+      search: '?utm_source=google&utm_medium=cpc&gclid=EAIa&utm_campaign=bands',
+      pathname: '/tyvek-wristbands',
+    };
+    const source = captureAndReadJobSource();
+    expect(source.utmSource).toBe('google');
+    expect(source.utmMedium).toBe('cpc');
+    expect(source.utmCampaign).toBe('bands');
+    expect(source.sourceClickId).toBe('EAIa');
+    expect(source.sourceLanding).toBe(
+      '/tyvek-wristbands?utm_source=google&utm_medium=cpc&gclid=EAIa&utm_campaign=bands'
+    );
+    expect(hasPaidClick(source)).toBe(true);
+  });
+
+  it('keeps first-touch UTMs unless a paid click arrives later', () => {
+    (window as any).location = {
+      search: '?utm_source=newsletter&utm_medium=email',
+      pathname: '/',
+    };
+    captureAndReadJobSource();
+    (window as any).location = {
+      search: '?utm_source=google&utm_medium=cpc',
+      pathname: '/product',
+    };
+    expect(captureAndReadJobSource().utmSource).toBe('newsletter');
+    (window as any).location = {
+      search: '?gclid=NEWCLICK&utm_source=google',
+      pathname: '/product',
+    };
+    expect(captureAndReadJobSource().sourceClickId).toBe('NEWCLICK');
+    expect(window.localStorage.getItem(JOB_SOURCE_STORAGE_KEY)).toContain('NEWCLICK');
+  });
+
+  it('knows when an existing cart still needs source fields', () => {
+    expect(
+      cartNeedsSourceUpdate({}, { utmSource: 'google', sourceClickId: 'x' })
+    ).toBe(true);
+    expect(
+      cartNeedsSourceUpdate(
+        { utmSource: 'google' },
+        { utmSource: 'google', sourceClickId: 'x' }
+      )
+    ).toBe(true);
+    expect(
+      cartNeedsSourceUpdate(
+        { utmSource: 'google', sourceClickId: 'x' },
+        { utmSource: 'google', sourceClickId: 'x' }
+      )
+    ).toBe(false);
+  });
+});

package/src/utilities/job_source.ts

@@ -0,0 +1,165 @@
+export const JOB_SOURCE_STORAGE_KEY = 'merchi_job_source';
+
+const CLICK_ID_PARAMS = ['gclid', 'gbraid', 'wbraid', 'fbclid', 'msclkid'] as const;
+const UTM_PARAMS = [
+  'utm_source',
+  'utm_medium',
+  'utm_campaign',
+  'utm_content',
+  'utm_term',
+] as const;
+
+export interface JobSourceFields {
+  utmSource?: string;
+  utmMedium?: string;
+  utmCampaign?: string;
+  utmContent?: string;
+  utmTerm?: string;
+  sourceClickId?: string;
+  sourceLanding?: string;
+  sourceReferrer?: string;
+}
+
+function trimTo(value: string | null | undefined, limit: number): string | undefined {
+  if (!value) return undefined;
+  const text = value.trim().slice(0, limit);
+  return text || undefined;
+}
+
+function readSearchParams(): URLSearchParams {
+  if (typeof window === 'undefined') return new URLSearchParams();
+  try {
+    return new URLSearchParams(window.location.search);
+  } catch {
+    return new URLSearchParams();
+  }
+}
+
+function readStoredSource(): JobSourceFields | null {
+  if (typeof window === 'undefined') return null;
+  try {
+    const raw = window.localStorage.getItem(JOB_SOURCE_STORAGE_KEY);
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== 'object') return null;
+    return parsed as JobSourceFields;
+  } catch {
+    return null;
+  }
+}
+
+function writeStoredSource(source: JobSourceFields) {
+  if (typeof window === 'undefined') return;
+  try {
+    window.localStorage.setItem(JOB_SOURCE_STORAGE_KEY, JSON.stringify(source));
+  } catch {
+    // Ignore quota / private-mode failures.
+  }
+}
+
+function currentLanding(): string | undefined {
+  if (typeof window === 'undefined') return undefined;
+  try {
+    const path = `${window.location.pathname || '/'}${window.location.search || ''}`;
+    return trimTo(path, 512);
+  } catch {
+    return undefined;
+  }
+}
+
+function currentReferrer(): string | undefined {
+  if (typeof document === 'undefined') return undefined;
+  try {
+    return trimTo(document.referrer, 512);
+  } catch {
+    return undefined;
+  }
+}
+
+export function sourceFromLocation(): JobSourceFields {
+  const params = readSearchParams();
+  const source: JobSourceFields = {
+    utmSource: trimTo(params.get('utm_source'), 256),
+    utmMedium: trimTo(params.get('utm_medium'), 256),
+    utmCampaign: trimTo(params.get('utm_campaign'), 256),
+    utmContent: trimTo(params.get('utm_content'), 256),
+    utmTerm: trimTo(params.get('utm_term'), 256),
+    sourceLanding: currentLanding(),
+    sourceReferrer: currentReferrer(),
+  };
+  for (const key of CLICK_ID_PARAMS) {
+    const value = trimTo(params.get(key), 256);
+    if (value) {
+      source.sourceClickId = value;
+      break;
+    }
+  }
+  return source;
+}
+
+export function hasPaidClick(source: JobSourceFields | null | undefined): boolean {
+  return Boolean(source?.sourceClickId);
+}
+
+export function hasSourceData(source: JobSourceFields | null | undefined): boolean {
+  if (!source) return false;
+  return Boolean(
+    source.utmSource ||
+      source.utmMedium ||
+      source.utmCampaign ||
+      source.utmContent ||
+      source.utmTerm ||
+      source.sourceClickId ||
+      source.sourceLanding ||
+      source.sourceReferrer
+  );
+}
+
+export function captureAndReadJobSource(): JobSourceFields {
+  const incoming = sourceFromLocation();
+  const stored = readStoredSource();
+  if (hasPaidClick(incoming) || !hasSourceData(stored)) {
+    const next = {
+      ...(stored || {}),
+      ...Object.fromEntries(
+        Object.entries(incoming).filter(([, value]) => Boolean(value))
+      ),
+    } as JobSourceFields;
+    if (hasSourceData(next)) writeStoredSource(next);
+    return next;
+  }
+  return stored || incoming;
+}
+
+export function jobSourceFieldsForApi(source?: JobSourceFields | null): JobSourceFields {
+  const resolved = source || captureAndReadJobSource();
+  const out: JobSourceFields = {};
+  (Object.keys(resolved) as Array<keyof JobSourceFields>).forEach((key) => {
+    const value = resolved[key];
+    if (value) out[key] = value;
+  });
+  return out;
+}
+
+export function cartNeedsSourceUpdate(
+  cart: { utmSource?: string; sourceClickId?: string; sourceChannel?: string } | null | undefined,
+  source: JobSourceFields
+): boolean {
+  if (!hasSourceData(source)) return false;
+  if (!cart?.utmSource && !cart?.sourceClickId && !cart?.sourceChannel) return true;
+  return Boolean(source.sourceClickId && !cart?.sourceClickId);
+}
+
+export const JOB_SOURCE_URL_KEYS = [...UTM_PARAMS, ...CLICK_ID_PARAMS];
+
+export function appendJobSourceToFormData(
+  data: FormData,
+  source?: JobSourceFields | null
+): FormData {
+  const fields = jobSourceFieldsForApi(source);
+  (Object.keys(fields) as Array<keyof JobSourceFields>).forEach((key) => {
+    const value = fields[key];
+    if (value) data.append(key, value);
+  });
+  return data;
+}