@uniformdev/insights 20.37.1-alpha.7 → 20.38.2-alpha.9

package/dist/index.d.mts

@@ -84,6 +84,8 @@ type UniformInsights = {
     testResult: (result: TestEvent, compositionData?: UniformMetadata) => void;
     personalizationResult: (result: PersonalizationEvent, compositionData?: UniformMetadata) => void;
     goalConvert: (goalId: string, compositionData?: UniformMetadata) => void;
+    segmentUpdated: (segmentId: string, value: number, compositionData?: UniformMetadata) => void;
+    enrichmentUpdated: (enrichmentId: string, key: string, strength: number, compositionData?: UniformMetadata) => void;
     get sessionId(): string | undefined;
 };
 

package/dist/index.d.ts

@@ -84,6 +84,8 @@ type UniformInsights = {
     testResult: (result: TestEvent, compositionData?: UniformMetadata) => void;
     personalizationResult: (result: PersonalizationEvent, compositionData?: UniformMetadata) => void;
     goalConvert: (goalId: string, compositionData?: UniformMetadata) => void;
+    segmentUpdated: (segmentId: string, value: number, compositionData?: UniformMetadata) => void;
+    enrichmentUpdated: (enrichmentId: string, key: string, strength: number, compositionData?: UniformMetadata) => void;
     get sessionId(): string | undefined;
 };
 

package/dist/index.esm.js

@@ -217,6 +217,33 @@ var convertUniformMetadataToInsightsMetadata = (uniformMetadata) => {
   } : void 0;
 };
 
+// src/events/enrichment.ts
+var buildEnrichmentUpdatedMessage = ({
+  sessionId,
+  visitorId,
+  pageId,
+  projectId,
+  enrichmentId,
+  key,
+  strength,
+  compositionData
+}) => ({
+  action: "enrichment_updated",
+  version: "2",
+  session_id: sessionId,
+  visitor_id: visitorId,
+  page_view_id: pageId,
+  timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+  project_id: projectId,
+  payload: {
+    id: enrichmentId,
+    key,
+    strength
+  },
+  web_metadata: getWebMetadata(),
+  uniform: compositionData || {}
+});
+
 // src/events/goal.ts
 var buildGoalConvertMessage = (sessionId, visitorId, pageId, projectId, goalId, compositionData) => ({
   action: "goal_convert",
@@ -266,6 +293,31 @@ var buildPersonalizationResultMessage = (sessionId, visitorId, pageId, projectId
   uniform: compositionData || {}
 });
 
+// src/events/segment.ts
+var buildSegmentUpdatedMessage = ({
+  sessionId,
+  visitorId,
+  pageId,
+  projectId,
+  segmentId,
+  value,
+  compositionData
+}) => ({
+  action: "segment_updated",
+  version: "2",
+  session_id: sessionId,
+  visitor_id: visitorId,
+  page_view_id: pageId,
+  timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+  project_id: projectId,
+  payload: {
+    id: segmentId,
+    value
+  },
+  web_metadata: getWebMetadata(),
+  uniform: compositionData || {}
+});
+
 // src/events/session.ts
 var buildSessionStartMessage = (sessionId, visitorId, pageId, projectId, previousSessionId, compositionData) => ({
   action: "session_start",
@@ -364,6 +416,15 @@ var createMemoryStorage = () => {
 
 // src/plugin.ts
 var createInsightsCore = (options) => {
+  if (options.endpoint.type === "api" && !options.endpoint.host) {
+    throw new Error("Insights context plugin requires API host");
+  }
+  if (options.endpoint.type === "api" && !options.endpoint.apiKey) {
+    throw new Error("Insights context plugin requires API key");
+  }
+  if (!options.endpoint.projectId) {
+    throw new Error("Insights context plugin requires project ID");
+  }
   const {
     endpoint,
     storage: customStorage,
@@ -511,6 +572,37 @@ var createInsightsCore = (options) => {
       );
       addEvent(message);
     },
+    segmentUpdated: (segmentId, value, compositionData) => {
+      if (!storageData) {
+        return;
+      }
+      const message = buildSegmentUpdatedMessage({
+        sessionId: storageData.sessionId,
+        visitorId: storageData.visitorId,
+        pageId,
+        projectId: endpoint.projectId,
+        segmentId,
+        value,
+        compositionData
+      });
+      addEvent(message);
+    },
+    enrichmentUpdated: (enrichmentId, key, strength, compositionData) => {
+      if (!storageData) {
+        return;
+      }
+      const message = buildEnrichmentUpdatedMessage({
+        sessionId: storageData.sessionId,
+        visitorId: storageData.visitorId,
+        pageId,
+        projectId: endpoint.projectId,
+        enrichmentId,
+        key,
+        strength,
+        compositionData
+      });
+      addEvent(message);
+    },
     forget: () => {
       storage.clear();
       storageData = void 0;
@@ -527,6 +619,7 @@ var createInsightsPlugin = (options) => {
   let previousUrl = void 0;
   let isInitialized = false;
   let eventQueue = [];
+  let contextInstance = void 0;
   const processQueuedEvents = () => {
     if (isInitialized && eventQueue.length > 0) {
       eventQueue.forEach((event) => event());
@@ -540,12 +633,24 @@ var createInsightsPlugin = (options) => {
       eventQueue.push(eventFn);
     }
   };
+  const handleSegmentUpdates = (updatedScores, compositionData) => {
+    if (!contextInstance) {
+      return;
+    }
+    Object.entries(updatedScores).forEach(([scoreKey, value]) => {
+      const aggregateDimension = contextInstance.manifest.getAggregateDimensionByKey(scoreKey);
+      if (aggregateDimension) {
+        insights.segmentUpdated(scoreKey, value, compositionData);
+      }
+    });
+  };
   return {
     init: (context) => {
       if (typeof window === "undefined") {
         return () => {
         };
       }
+      contextInstance = context;
       const consentChanged = () => {
         if (context.storage.data.consent) {
           insights.init(context).then(() => {
@@ -599,11 +704,32 @@ var createInsightsPlugin = (options) => {
         context.events.off("canvasDataUpdated", handleCanvasDataUpdated);
       };
     },
-    update: (updatedData) => {
+    update: (updatedData, recalculatedScores) => {
+      var _a;
+      const compositionMetadata = convertUniformMetadataToInsightsMetadata(
+        (_a = updatedData.compositionMetadata) != null ? _a : contextInstance == null ? void 0 : contextInstance.getCompositionMetadata()
+      );
       if (updatedData.url && updatedData.url.toString() !== previousUrl) {
         previousUrl = updatedData.url.toString();
         queueEvent(() => {
-          insights.pageHit(convertUniformMetadataToInsightsMetadata(updatedData.compositionMetadata));
+          insights.pageHit(compositionMetadata);
+        });
+      }
+      if (updatedData.enrichments && updatedData.enrichments.length > 0) {
+        queueEvent(() => {
+          updatedData.enrichments.forEach((enrichmentData) => {
+            insights.enrichmentUpdated(
+              enrichmentData.cat,
+              enrichmentData.key,
+              enrichmentData.str,
+              compositionMetadata
+            );
+          });
+        });
+      }
+      if (recalculatedScores) {
+        queueEvent(() => {
+          handleSegmentUpdates(recalculatedScores, compositionMetadata);
         });
       }
     },

package/dist/index.js

@@ -253,6 +253,33 @@ var convertUniformMetadataToInsightsMetadata = (uniformMetadata) => {
   } : void 0;
 };
 
+// src/events/enrichment.ts
+var buildEnrichmentUpdatedMessage = ({
+  sessionId,
+  visitorId,
+  pageId,
+  projectId,
+  enrichmentId,
+  key,
+  strength,
+  compositionData
+}) => ({
+  action: "enrichment_updated",
+  version: "2",
+  session_id: sessionId,
+  visitor_id: visitorId,
+  page_view_id: pageId,
+  timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+  project_id: projectId,
+  payload: {
+    id: enrichmentId,
+    key,
+    strength
+  },
+  web_metadata: getWebMetadata(),
+  uniform: compositionData || {}
+});
+
 // src/events/goal.ts
 var buildGoalConvertMessage = (sessionId, visitorId, pageId, projectId, goalId, compositionData) => ({
   action: "goal_convert",
@@ -302,6 +329,31 @@ var buildPersonalizationResultMessage = (sessionId, visitorId, pageId, projectId
   uniform: compositionData || {}
 });
 
+// src/events/segment.ts
+var buildSegmentUpdatedMessage = ({
+  sessionId,
+  visitorId,
+  pageId,
+  projectId,
+  segmentId,
+  value,
+  compositionData
+}) => ({
+  action: "segment_updated",
+  version: "2",
+  session_id: sessionId,
+  visitor_id: visitorId,
+  page_view_id: pageId,
+  timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+  project_id: projectId,
+  payload: {
+    id: segmentId,
+    value
+  },
+  web_metadata: getWebMetadata(),
+  uniform: compositionData || {}
+});
+
 // src/events/session.ts
 var buildSessionStartMessage = (sessionId, visitorId, pageId, projectId, previousSessionId, compositionData) => ({
   action: "session_start",
@@ -400,6 +452,15 @@ var createMemoryStorage = () => {
 
 // src/plugin.ts
 var createInsightsCore = (options) => {
+  if (options.endpoint.type === "api" && !options.endpoint.host) {
+    throw new Error("Insights context plugin requires API host");
+  }
+  if (options.endpoint.type === "api" && !options.endpoint.apiKey) {
+    throw new Error("Insights context plugin requires API key");
+  }
+  if (!options.endpoint.projectId) {
+    throw new Error("Insights context plugin requires project ID");
+  }
   const {
     endpoint,
     storage: customStorage,
@@ -547,6 +608,37 @@ var createInsightsCore = (options) => {
       );
       addEvent(message);
     },
+    segmentUpdated: (segmentId, value, compositionData) => {
+      if (!storageData) {
+        return;
+      }
+      const message = buildSegmentUpdatedMessage({
+        sessionId: storageData.sessionId,
+        visitorId: storageData.visitorId,
+        pageId,
+        projectId: endpoint.projectId,
+        segmentId,
+        value,
+        compositionData
+      });
+      addEvent(message);
+    },
+    enrichmentUpdated: (enrichmentId, key, strength, compositionData) => {
+      if (!storageData) {
+        return;
+      }
+      const message = buildEnrichmentUpdatedMessage({
+        sessionId: storageData.sessionId,
+        visitorId: storageData.visitorId,
+        pageId,
+        projectId: endpoint.projectId,
+        enrichmentId,
+        key,
+        strength,
+        compositionData
+      });
+      addEvent(message);
+    },
     forget: () => {
       storage.clear();
       storageData = void 0;
@@ -563,6 +655,7 @@ var createInsightsPlugin = (options) => {
   let previousUrl = void 0;
   let isInitialized = false;
   let eventQueue = [];
+  let contextInstance = void 0;
   const processQueuedEvents = () => {
     if (isInitialized && eventQueue.length > 0) {
       eventQueue.forEach((event) => event());
@@ -576,12 +669,24 @@ var createInsightsPlugin = (options) => {
       eventQueue.push(eventFn);
     }
   };
+  const handleSegmentUpdates = (updatedScores, compositionData) => {
+    if (!contextInstance) {
+      return;
+    }
+    Object.entries(updatedScores).forEach(([scoreKey, value]) => {
+      const aggregateDimension = contextInstance.manifest.getAggregateDimensionByKey(scoreKey);
+      if (aggregateDimension) {
+        insights.segmentUpdated(scoreKey, value, compositionData);
+      }
+    });
+  };
   return {
     init: (context) => {
       if (typeof window === "undefined") {
         return () => {
         };
       }
+      contextInstance = context;
       const consentChanged = () => {
         if (context.storage.data.consent) {
           insights.init(context).then(() => {
@@ -635,11 +740,32 @@ var createInsightsPlugin = (options) => {
         context.events.off("canvasDataUpdated", handleCanvasDataUpdated);
       };
     },
-    update: (updatedData) => {
+    update: (updatedData, recalculatedScores) => {
+      var _a;
+      const compositionMetadata = convertUniformMetadataToInsightsMetadata(
+        (_a = updatedData.compositionMetadata) != null ? _a : contextInstance == null ? void 0 : contextInstance.getCompositionMetadata()
+      );
       if (updatedData.url && updatedData.url.toString() !== previousUrl) {
         previousUrl = updatedData.url.toString();
         queueEvent(() => {
-          insights.pageHit(convertUniformMetadataToInsightsMetadata(updatedData.compositionMetadata));
+          insights.pageHit(compositionMetadata);
+        });
+      }
+      if (updatedData.enrichments && updatedData.enrichments.length > 0) {
+        queueEvent(() => {
+          updatedData.enrichments.forEach((enrichmentData) => {
+            insights.enrichmentUpdated(
+              enrichmentData.cat,
+              enrichmentData.key,
+              enrichmentData.str,
+              compositionMetadata
+            );
+          });
+        });
+      }
+      if (recalculatedScores) {
+        queueEvent(() => {
+          handleSegmentUpdates(recalculatedScores, compositionMetadata);
         });
       }
     },

package/dist/index.mjs

@@ -217,6 +217,33 @@ var convertUniformMetadataToInsightsMetadata = (uniformMetadata) => {
   } : void 0;
 };
 
+// src/events/enrichment.ts
+var buildEnrichmentUpdatedMessage = ({
+  sessionId,
+  visitorId,
+  pageId,
+  projectId,
+  enrichmentId,
+  key,
+  strength,
+  compositionData
+}) => ({
+  action: "enrichment_updated",
+  version: "2",
+  session_id: sessionId,
+  visitor_id: visitorId,
+  page_view_id: pageId,
+  timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+  project_id: projectId,
+  payload: {
+    id: enrichmentId,
+    key,
+    strength
+  },
+  web_metadata: getWebMetadata(),
+  uniform: compositionData || {}
+});
+
 // src/events/goal.ts
 var buildGoalConvertMessage = (sessionId, visitorId, pageId, projectId, goalId, compositionData) => ({
   action: "goal_convert",
@@ -266,6 +293,31 @@ var buildPersonalizationResultMessage = (sessionId, visitorId, pageId, projectId
   uniform: compositionData || {}
 });
 
+// src/events/segment.ts
+var buildSegmentUpdatedMessage = ({
+  sessionId,
+  visitorId,
+  pageId,
+  projectId,
+  segmentId,
+  value,
+  compositionData
+}) => ({
+  action: "segment_updated",
+  version: "2",
+  session_id: sessionId,
+  visitor_id: visitorId,
+  page_view_id: pageId,
+  timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+  project_id: projectId,
+  payload: {
+    id: segmentId,
+    value
+  },
+  web_metadata: getWebMetadata(),
+  uniform: compositionData || {}
+});
+
 // src/events/session.ts
 var buildSessionStartMessage = (sessionId, visitorId, pageId, projectId, previousSessionId, compositionData) => ({
   action: "session_start",
@@ -364,6 +416,15 @@ var createMemoryStorage = () => {
 
 // src/plugin.ts
 var createInsightsCore = (options) => {
+  if (options.endpoint.type === "api" && !options.endpoint.host) {
+    throw new Error("Insights context plugin requires API host");
+  }
+  if (options.endpoint.type === "api" && !options.endpoint.apiKey) {
+    throw new Error("Insights context plugin requires API key");
+  }
+  if (!options.endpoint.projectId) {
+    throw new Error("Insights context plugin requires project ID");
+  }
   const {
     endpoint,
     storage: customStorage,
@@ -511,6 +572,37 @@ var createInsightsCore = (options) => {
       );
       addEvent(message);
     },
+    segmentUpdated: (segmentId, value, compositionData) => {
+      if (!storageData) {
+        return;
+      }
+      const message = buildSegmentUpdatedMessage({
+        sessionId: storageData.sessionId,
+        visitorId: storageData.visitorId,
+        pageId,
+        projectId: endpoint.projectId,
+        segmentId,
+        value,
+        compositionData
+      });
+      addEvent(message);
+    },
+    enrichmentUpdated: (enrichmentId, key, strength, compositionData) => {
+      if (!storageData) {
+        return;
+      }
+      const message = buildEnrichmentUpdatedMessage({
+        sessionId: storageData.sessionId,
+        visitorId: storageData.visitorId,
+        pageId,
+        projectId: endpoint.projectId,
+        enrichmentId,
+        key,
+        strength,
+        compositionData
+      });
+      addEvent(message);
+    },
     forget: () => {
       storage.clear();
       storageData = void 0;
@@ -527,6 +619,7 @@ var createInsightsPlugin = (options) => {
   let previousUrl = void 0;
   let isInitialized = false;
   let eventQueue = [];
+  let contextInstance = void 0;
   const processQueuedEvents = () => {
     if (isInitialized && eventQueue.length > 0) {
       eventQueue.forEach((event) => event());
@@ -540,12 +633,24 @@ var createInsightsPlugin = (options) => {
       eventQueue.push(eventFn);
     }
   };
+  const handleSegmentUpdates = (updatedScores, compositionData) => {
+    if (!contextInstance) {
+      return;
+    }
+    Object.entries(updatedScores).forEach(([scoreKey, value]) => {
+      const aggregateDimension = contextInstance.manifest.getAggregateDimensionByKey(scoreKey);
+      if (aggregateDimension) {
+        insights.segmentUpdated(scoreKey, value, compositionData);
+      }
+    });
+  };
   return {
     init: (context) => {
       if (typeof window === "undefined") {
         return () => {
         };
       }
+      contextInstance = context;
       const consentChanged = () => {
         if (context.storage.data.consent) {
           insights.init(context).then(() => {
@@ -599,11 +704,32 @@ var createInsightsPlugin = (options) => {
         context.events.off("canvasDataUpdated", handleCanvasDataUpdated);
       };
     },
-    update: (updatedData) => {
+    update: (updatedData, recalculatedScores) => {
+      var _a;
+      const compositionMetadata = convertUniformMetadataToInsightsMetadata(
+        (_a = updatedData.compositionMetadata) != null ? _a : contextInstance == null ? void 0 : contextInstance.getCompositionMetadata()
+      );
       if (updatedData.url && updatedData.url.toString() !== previousUrl) {
         previousUrl = updatedData.url.toString();
         queueEvent(() => {
-          insights.pageHit(convertUniformMetadataToInsightsMetadata(updatedData.compositionMetadata));
+          insights.pageHit(compositionMetadata);
+        });
+      }
+      if (updatedData.enrichments && updatedData.enrichments.length > 0) {
+        queueEvent(() => {
+          updatedData.enrichments.forEach((enrichmentData) => {
+            insights.enrichmentUpdated(
+              enrichmentData.cat,
+              enrichmentData.key,
+              enrichmentData.str,
+              compositionMetadata
+            );
+          });
+        });
+      }
+      if (recalculatedScores) {
+        queueEvent(() => {
+          handleSegmentUpdates(recalculatedScores, compositionMetadata);
         });
       }
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniformdev/insights",
-  "version": "20.37.1-alpha.7+a17ec25ff2",
+  "version": "20.38.2-alpha.9+de3aa3f1aa",
   "description": "Uniform Context Insights package",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "./dist/index.js",
@@ -50,7 +50,7 @@
     "vitest": "3.2.4"
   },
   "dependencies": {
-    "@uniformdev/context": "20.37.1-alpha.7+a17ec25ff2",
+    "@uniformdev/context": "20.38.2-alpha.9+de3aa3f1aa",
     "p-limit": "3.1.0"
   },
   "files": [
@@ -59,5 +59,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "a17ec25ff2021e850ee810f166345b086daa4224"
+  "gitHead": "de3aa3f1aa5fc604edb758087e3ab5cf81e71c43"
 }