@uniformdev/insights 20.31.1-alpha.185 → 20.35.1-alpha.188

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,10 +416,19 @@ 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,
-    batchConfig = DEFAULT_BATCH_CONFIG,
+    batchConfig,
     sessionDurationSeconds = 30 * 60,
     getVisitorId = generateVisitorId,
     getSessionId = generateSessionId
@@ -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,31 @@ var createInsightsPlugin = (options) => {
       eventQueue.push(eventFn);
     }
   };
+  const previousScores = {};
+  const handleScoreUpdates = (updatedScores, compositionData) => {
+    if (!contextInstance) {
+      return;
+    }
+    Object.entries(updatedScores).forEach(([scoreKey, value]) => {
+      var _a, _b;
+      if (previousScores[scoreKey] === value) {
+        return;
+      }
+      const aggregateDimension = contextInstance.manifest.getAggregateDimensionByKey(scoreKey);
+      const signalDimension = (_b = (_a = contextInstance.manifest.data.project.pz) == null ? void 0 : _a.sig) == null ? void 0 : _b[scoreKey];
+      if (aggregateDimension || signalDimension) {
+        insights.segmentUpdated(scoreKey, value, compositionData);
+        previousScores[scoreKey] = value;
+      }
+    });
+  };
   return {
     init: (context) => {
       if (typeof window === "undefined") {
         return () => {
         };
       }
+      contextInstance = context;
       const consentChanged = () => {
         if (context.storage.data.consent) {
           insights.init(context).then(() => {
@@ -599,11 +711,32 @@ var createInsightsPlugin = (options) => {
         context.events.off("canvasDataUpdated", handleCanvasDataUpdated);
       };
     },
-    update: (context) => {
-      if (context.url && context.url.toString() !== previousUrl) {
-        previousUrl = context.url.toString();
+    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(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(() => {
-          insights.pageHit(convertUniformMetadataToInsightsMetadata(context.compositionMetadata));
+          handleScoreUpdates(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,10 +452,19 @@ 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,
-    batchConfig = DEFAULT_BATCH_CONFIG,
+    batchConfig,
     sessionDurationSeconds = 30 * 60,
     getVisitorId = generateVisitorId,
     getSessionId = generateSessionId
@@ -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,31 @@ var createInsightsPlugin = (options) => {
       eventQueue.push(eventFn);
     }
   };
+  const previousScores = {};
+  const handleScoreUpdates = (updatedScores, compositionData) => {
+    if (!contextInstance) {
+      return;
+    }
+    Object.entries(updatedScores).forEach(([scoreKey, value]) => {
+      var _a, _b;
+      if (previousScores[scoreKey] === value) {
+        return;
+      }
+      const aggregateDimension = contextInstance.manifest.getAggregateDimensionByKey(scoreKey);
+      const signalDimension = (_b = (_a = contextInstance.manifest.data.project.pz) == null ? void 0 : _a.sig) == null ? void 0 : _b[scoreKey];
+      if (aggregateDimension || signalDimension) {
+        insights.segmentUpdated(scoreKey, value, compositionData);
+        previousScores[scoreKey] = value;
+      }
+    });
+  };
   return {
     init: (context) => {
       if (typeof window === "undefined") {
         return () => {
         };
       }
+      contextInstance = context;
       const consentChanged = () => {
         if (context.storage.data.consent) {
           insights.init(context).then(() => {
@@ -635,11 +747,32 @@ var createInsightsPlugin = (options) => {
         context.events.off("canvasDataUpdated", handleCanvasDataUpdated);
       };
     },
-    update: (context) => {
-      if (context.url && context.url.toString() !== previousUrl) {
-        previousUrl = context.url.toString();
+    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(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(() => {
-          insights.pageHit(convertUniformMetadataToInsightsMetadata(context.compositionMetadata));
+          handleScoreUpdates(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,10 +416,19 @@ 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,
-    batchConfig = DEFAULT_BATCH_CONFIG,
+    batchConfig,
     sessionDurationSeconds = 30 * 60,
     getVisitorId = generateVisitorId,
     getSessionId = generateSessionId
@@ -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,31 @@ var createInsightsPlugin = (options) => {
       eventQueue.push(eventFn);
     }
   };
+  const previousScores = {};
+  const handleScoreUpdates = (updatedScores, compositionData) => {
+    if (!contextInstance) {
+      return;
+    }
+    Object.entries(updatedScores).forEach(([scoreKey, value]) => {
+      var _a, _b;
+      if (previousScores[scoreKey] === value) {
+        return;
+      }
+      const aggregateDimension = contextInstance.manifest.getAggregateDimensionByKey(scoreKey);
+      const signalDimension = (_b = (_a = contextInstance.manifest.data.project.pz) == null ? void 0 : _a.sig) == null ? void 0 : _b[scoreKey];
+      if (aggregateDimension || signalDimension) {
+        insights.segmentUpdated(scoreKey, value, compositionData);
+        previousScores[scoreKey] = value;
+      }
+    });
+  };
   return {
     init: (context) => {
       if (typeof window === "undefined") {
         return () => {
         };
       }
+      contextInstance = context;
       const consentChanged = () => {
         if (context.storage.data.consent) {
           insights.init(context).then(() => {
@@ -599,11 +711,32 @@ var createInsightsPlugin = (options) => {
         context.events.off("canvasDataUpdated", handleCanvasDataUpdated);
       };
     },
-    update: (context) => {
-      if (context.url && context.url.toString() !== previousUrl) {
-        previousUrl = context.url.toString();
+    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(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(() => {
-          insights.pageHit(convertUniformMetadataToInsightsMetadata(context.compositionMetadata));
+          handleScoreUpdates(recalculatedScores, compositionMetadata);
         });
       }
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniformdev/insights",
-  "version": "20.31.1-alpha.185+f4131987e9",
+  "version": "20.35.1-alpha.188+c2a5b9c45f",
   "description": "Uniform Context Insights package",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "./dist/index.js",
@@ -43,14 +43,12 @@
     "@types/js-cookie": "3.0.6",
     "@types/node": "^20.0.0",
     "@types/uuid": "9.0.4",
-    "@vitest/coverage-v8": "3.2.4",
     "benny": "3.7.1",
     "vite": "^7.0.6",
-    "vite-tsconfig-paths": "^5.1.4",
-    "vitest": "3.2.4"
+    "vite-tsconfig-paths": "^5.1.4"
   },
   "dependencies": {
-    "@uniformdev/context": "20.31.1-alpha.185+f4131987e9",
+    "@uniformdev/context": "20.35.1-alpha.188+c2a5b9c45f",
     "p-limit": "3.1.0"
   },
   "files": [
@@ -59,5 +57,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "f4131987e95aa361d3061636de450994ffb65651"
+  "gitHead": "c2a5b9c45fdbcd3199fba23e38beaf7ca0388c35"
 }