@adobe/spacecat-shared-rum-api-client 2.38.1 → 2.38.2

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [@adobe/spacecat-shared-rum-api-client-v2.38.2](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-rum-api-client-v2.38.1...@adobe/spacecat-shared-rum-api-client-v2.38.2) (2025-10-15)
+
+
+### Bug Fixes
+
+* **traffic-attribution:** enforce earned-llm for llm providers ([#1028](https://github.com/adobe/spacecat-shared/issues/1028)) ([550c411](https://github.com/adobe/spacecat-shared/commit/550c411220ffc50a0d8ee6eb954f3e439efc5b0e))
+
 # [@adobe/spacecat-shared-rum-api-client-v2.38.1](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-rum-api-client-v2.38.0...@adobe/spacecat-shared-rum-api-client-v2.38.1) (2025-10-09)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/spacecat-shared-rum-api-client",
-  "version": "2.38.1",
+  "version": "2.38.2",
   "description": "Shared modules of the Spacecat Services - Rum API client",
   "type": "module",
   "engines": {

package/src/common/traffic.js

@@ -138,6 +138,29 @@ const not = (truth) => (text) => {
 
 const notEmpty = (text) => hasText(text);
 
+/*
+ * --------- ENFORCEMENTS ----------------
+ */
+
+const ENFORCEMENTS = [
+  // vendors 'openai', 'claude', and 'perplexity' can only be earned/llm
+  {
+    when: (state) => state.vendor === 'openai' || state.vendor === 'claude' || state.vendor === 'perplexity',
+    enforce: (state) => ({ ...state, type: 'earned', category: 'llm' }),
+  },
+  // if utm_source=chatgpt.com, force earned/llm and vendor=openai
+  {
+    when: (state, ctx) => (ctx.utmSourceRaw || '').toLowerCase() === 'chatgpt.com',
+    enforce: (state) => ({ ...state, type: 'earned', category: 'llm', vendor: 'openai' }),
+  },
+];
+
+function applyEnforcements(initialState, context) {
+  return ENFORCEMENTS
+    .reduce((acc, rule) => (
+      rule.when(acc, context) ? rule.enforce(acc, context) : acc), initialState);
+}
+
 /*
  * --------- RULES ----------------
  */
@@ -246,18 +269,29 @@ export function classifyTrafficSource(url, referrer, utmSource, utmMedium, track
 
   const sanitize = (str) => (str || '').toLowerCase().replace(/[^a-zA-Z0-9]/, '');
 
-  const { type, category } = rules.find((rule) => (
+  const match = rules.find((rule) => (
     rule.referrer(referrerDomain)
     && rule.utmSource(sanitize(utmSource))
     && rule.utmMedium(sanitize(utmMedium))
     && rule.tracking(trackingParams)
   ));
+  const { type, category } = match;
   const vendor = classifyVendor(referrerDomain, utmSource, utmMedium);
 
+  const enforced = applyEnforcements(
+    { type, category, vendor },
+    {
+      utmSourceRaw: utmSource,
+      utmSource: sanitize(utmSource),
+      utmMedium: sanitize(utmMedium),
+      referrerDomain,
+    },
+  );
+
   return {
-    type,
-    category,
-    vendor,
+    type: enforced.type,
+    category: enforced.category,
+    vendor: enforced.vendor,
   };
 }