@uniformdev/context 20.6.2-alpha.11 → 20.7.1-alpha.102

package/LICENSE.txt

@@ -1,2 +1,2 @@
-© 2024 Uniform Systems, Inc. All Rights Reserved.
+© 2025 Uniform Systems, Inc. All Rights Reserved.
 See details of Uniform Systems, Inc. Master Subscription Agreement here: https://uniform.dev/eula

package/dist/api/api.d.mts

@@ -1,4 +1,4 @@
-import { aI as paths$7, $ as ManifestV2 } from '../types-CzIkFCDD.mjs';
+import { aJ as paths$7, $ as ManifestV2 } from '../types-HcKr1VVF.mjs';
 import 'mitt';
 
 type LimitPolicy = <ReturnValue>(func: () => Promise<ReturnValue>) => Promise<ReturnValue>;
@@ -43,6 +43,13 @@ declare class ApiClient<TOptions extends ClientOptions = ClientOptions> {
         /** Whether to expect a JSON response or not */
         expectNoContent?: boolean;
     }): Promise<TResponse>;
+    protected apiClientWithResponse<TResponse>(fetchUri: URL, options?: RequestInit & {
+        /** Whether to expect a JSON response or not */
+        expectNoContent?: boolean;
+    }): Promise<{
+        response: Response;
+        body: TResponse;
+    }>;
     protected createUrl(path: string, queryParams?: Record<string, string | boolean | undefined | null | number | Array<string | boolean | number>>, hostOverride?: string): URL;
     private ensureApiHost;
     private static getRequestId;
@@ -954,6 +961,8 @@ interface components$3 {
             subcategory?: string;
             /** @description The dimension's name (without category) */
             name: string;
+            /** @description Optional description of the dimension */
+            description?: string;
             /** @description The minimum score possible for the dimension */
             min: number;
             /** @description The maximum score possible for the dimension */

package/dist/api/api.d.ts

@@ -1,4 +1,4 @@
-import { aI as paths$7, $ as ManifestV2 } from '../types-CzIkFCDD.js';
+import { aJ as paths$7, $ as ManifestV2 } from '../types-HcKr1VVF.js';
 import 'mitt';
 
 type LimitPolicy = <ReturnValue>(func: () => Promise<ReturnValue>) => Promise<ReturnValue>;
@@ -43,6 +43,13 @@ declare class ApiClient<TOptions extends ClientOptions = ClientOptions> {
         /** Whether to expect a JSON response or not */
         expectNoContent?: boolean;
     }): Promise<TResponse>;
+    protected apiClientWithResponse<TResponse>(fetchUri: URL, options?: RequestInit & {
+        /** Whether to expect a JSON response or not */
+        expectNoContent?: boolean;
+    }): Promise<{
+        response: Response;
+        body: TResponse;
+    }>;
     protected createUrl(path: string, queryParams?: Record<string, string | boolean | undefined | null | number | Array<string | boolean | number>>, hostOverride?: string): URL;
     private ensureApiHost;
     private static getRequestId;
@@ -954,6 +961,8 @@ interface components$3 {
             subcategory?: string;
             /** @description The dimension's name (without category) */
             name: string;
+            /** @description Optional description of the dimension */
+            description?: string;
             /** @description The minimum score possible for the dimension */
             min: number;
             /** @description The maximum score possible for the dimension */

package/dist/api/api.js

@@ -123,6 +123,9 @@ var ApiClient = class _ApiClient {
     };
   }
   async apiClient(fetchUri, options) {
+    return (await this.apiClientWithResponse(fetchUri, options)).body;
+  }
+  async apiClientWithResponse(fetchUri, options) {
     return this.options.limitPolicy(async () => {
       var _a;
       const coreHeaders = this.options.apiKey ? {
@@ -170,9 +173,12 @@ var ApiClient = class _ApiClient {
         );
       }
       if (options == null ? void 0 : options.expectNoContent) {
-        return null;
+        return { response: apiResponse, body: null };
       }
-      return await apiResponse.json();
+      return {
+        response: apiResponse,
+        body: await apiResponse.json()
+      };
     });
   }
   createUrl(path, queryParams, hostOverride) {

package/dist/api/api.mjs

@@ -58,6 +58,9 @@ var ApiClient = class _ApiClient {
     };
   }
   async apiClient(fetchUri, options) {
+    return (await this.apiClientWithResponse(fetchUri, options)).body;
+  }
+  async apiClientWithResponse(fetchUri, options) {
     return this.options.limitPolicy(async () => {
       var _a;
       const coreHeaders = this.options.apiKey ? {
@@ -105,9 +108,12 @@ var ApiClient = class _ApiClient {
         );
       }
       if (options == null ? void 0 : options.expectNoContent) {
-        return null;
+        return { response: apiResponse, body: null };
       }
-      return await apiResponse.json();
+      return {
+        response: apiResponse,
+        body: await apiResponse.json()
+      };
     });
   }
   createUrl(path, queryParams, hostOverride) {

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { O as OutputSeverity, L as LogDrain, C as ContextPlugin, S as ScoreVector, A as AggregateDimension, T as TransitionDataStore, a as StorageCommands, V as VisitorData, Q as Quirks, b as TransitionDataStoreOptions, D as DecayFunction, c as CriteriaEvaluator, d as StringMatch, e as VariantMatchCriteria, f as LogMessage, P as PersonalizedVariant, g as PersonalizeOptions, h as Context, i as PersonalizedResult, j as VariationMatchDimensionCriteria, k as PersonalizationSelectionAlgorithmOptions, l as DevToolsEvents } from './types-CzIkFCDD.mjs';
-export { a7 as AggregateDimensionInput, ad as BehaviorTag, m as CONTEXTUAL_EDITING_TEST_NAME, n as CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID, u as ContextEvents, v as ContextInstance, q as ContextOptions, aF as ContextState, aG as ContextStateUpdate, Z as CriteriaEvaluatorParameters, Y as CriteriaEvaluatorResult, au as DecayOptions, y as DevToolsActions, E as DevToolsDataEvent, z as DevToolsEvent, I as DevToolsForgetEvent, F as DevToolsHelloEvent, B as DevToolsLogEvent, H as DevToolsRawCommandsEvent, x as DevToolsState, w as DevToolsUiVersion, G as DevToolsUpdateEvent, ab as DimensionMatch, a4 as EnrichmentCategory, aA as EnrichmentData, aD as EventData, aH as GoalStateUpdate, az as Goals, X as GroupCriteriaEvaluator, an as IdentifyCommand, U as LogMessageGroup, R as LogMessageSingle, J as LogMessages, W as ManifestInstance, $ as ManifestV2, M as MessageCategory, N as MessageFunc, ai as ModifyScoreCommand, aj as ModifySessionScoreCommand, a5 as NumberMatch, s as PersonalizationEvent, r as PersonalizationEventVariantId, a0 as PersonalizationManifest, o as PersonalizationSelectionAlgorithm, p as PersonalizationSelectionAlgorithms, aB as PersonalizeControlVariant, aC as PersonalizeVariants, ac as QuirkMatch, as as SERVER_STATE_ID, ar as ServerToClientTransitionState, ak as SetConsentCommand, ao as SetControlGroupCommand, ah as SetGoalCommand, ap as SetPersonalizeVariantControlCommand, al as SetQuirkCommand, am as SetTestCommand, K as Severity, a1 as Signal, a3 as SignalCriteria, a2 as SignalCriteriaGroup, _ as SignalData, ag as StorageCommand, a6 as TestDefinition, t as TestEvent, a8 as TestOptions, af as TestResult, ae as TestVariant, ay as Tests, at as TransitionDataStoreEvents, aa as VariationMatchMetadata, ax as VisitorDataStore, aw as VisitorDataStoreEvents, av as VisitorDataStoreOptions, aq as areCommandsEqual, aE as emptyVisitorData, a9 as testVariations } from './types-CzIkFCDD.mjs';
+import { O as OutputSeverity, L as LogDrain, C as ContextPlugin, S as ScoreVector, A as AggregateDimension, T as TransitionDataStore, a as StorageCommands, V as VisitorData, Q as Quirks, b as TransitionDataStoreOptions, D as DecayFunction, c as CriteriaEvaluator, d as StringMatch, e as VariantMatchCriteria, f as LogMessage, P as PersonalizedVariant, g as PersonalizeOptions, h as Context, i as PersonalizedResult, j as VariationMatchDimensionCriteria, k as PersonalizationSelectionAlgorithmOptions, l as DevToolsEvents } from './types-HcKr1VVF.mjs';
+export { a7 as AggregateDimensionInput, ad as BehaviorTag, m as CONTEXTUAL_EDITING_TEST_NAME, n as CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID, aF as CompositionMetadata, u as ContextEvents, v as ContextInstance, q as ContextOptions, aG as ContextState, aH as ContextStateUpdate, Z as CriteriaEvaluatorParameters, Y as CriteriaEvaluatorResult, au as DecayOptions, y as DevToolsActions, E as DevToolsDataEvent, z as DevToolsEvent, I as DevToolsForgetEvent, F as DevToolsHelloEvent, B as DevToolsLogEvent, H as DevToolsRawCommandsEvent, x as DevToolsState, w as DevToolsUiVersion, G as DevToolsUpdateEvent, ab as DimensionMatch, a4 as EnrichmentCategory, aA as EnrichmentData, aD as EventData, aI as GoalStateUpdate, az as Goals, X as GroupCriteriaEvaluator, an as IdentifyCommand, U as LogMessageGroup, R as LogMessageSingle, J as LogMessages, W as ManifestInstance, $ as ManifestV2, M as MessageCategory, N as MessageFunc, ai as ModifyScoreCommand, aj as ModifySessionScoreCommand, a5 as NumberMatch, s as PersonalizationEvent, r as PersonalizationEventVariantId, a0 as PersonalizationManifest, o as PersonalizationSelectionAlgorithm, p as PersonalizationSelectionAlgorithms, aB as PersonalizeControlVariant, aC as PersonalizeVariants, ac as QuirkMatch, as as SERVER_STATE_ID, ar as ServerToClientTransitionState, ak as SetConsentCommand, ao as SetControlGroupCommand, ah as SetGoalCommand, ap as SetPersonalizeVariantControlCommand, al as SetQuirkCommand, am as SetTestCommand, K as Severity, a1 as Signal, a3 as SignalCriteria, a2 as SignalCriteriaGroup, _ as SignalData, ag as StorageCommand, a6 as TestDefinition, t as TestEvent, a8 as TestOptions, af as TestResult, ae as TestVariant, ay as Tests, at as TransitionDataStoreEvents, aa as VariationMatchMetadata, ax as VisitorDataStore, aw as VisitorDataStoreEvents, av as VisitorDataStoreOptions, aq as areCommandsEqual, aE as emptyVisitorData, a9 as testVariations } from './types-HcKr1VVF.mjs';
 import Cookies from 'js-cookie';
 import 'mitt';
 
@@ -72,6 +72,7 @@ declare class CookieTransitionDataStore extends TransitionDataStore {
 declare const TYPE_SEP = "~";
 declare const PAIR_SEP = "!";
 declare const KV_SEP = "-";
+declare const QUIRK_KV_SEP = "=";
 declare const QUIRK_SEP = "!!";
 declare function parseScoreCookie(cookieValue: string | undefined, quirkCookieValue?: string): Partial<VisitorData> | undefined;
 declare function parseQuirkCookie(quirkCookieValue: string): Quirks;
@@ -229,9 +230,13 @@ type InsightsEndpoint = {
     apiKey?: string;
     projectId?: string;
 };
+
 type EnableUniformInsightsOptions = {
     endpoint: InsightsEndpoint;
 };
+/**
+ * @deprecated Use `import { enableUniformInsights } from '@uniformdev/insights'` instead
+ */
 declare const enableUniformInsights: (options: EnableUniformInsightsOptions) => ContextPlugin;
 
 type QuickConnectConfig = {
@@ -242,4 +247,4 @@ type QuickConnectConfig = {
 declare function serializeQuickConnect(config: QuickConnectConfig): string;
 declare function parseQuickConnect(serialized: string): Required<QuickConnectConfig>;
 
-export { AggregateDimension, type ConsoleDebugLogDrainOptions, Context, type ContextDevToolOptions, ContextPlugin, CookieTransitionDataStore, type CookieTransitionDataStoreOptions, CriteriaEvaluator, DecayFunction, DevToolsEvents, ENR_SEPARATOR, EdgeNodeTagName, type EdgePersonalizeComponentOptions, type EdgeTestComponentOptions, EdgeTransitionDataStore, type EdgeTransitionDataStoreOptions, type EnableUniformInsightsOptions, KV_SEP, type LinearDecayOptions, LogDrain, LogMessage, OutputSeverity, PAIR_SEP, PersonalizationSelectionAlgorithmOptions, PersonalizeOptions, PersonalizedResult, PersonalizedVariant, QUIRK_SEP, type QuickConnectConfig, Quirks, STRONGEST_SCORE_PERSONALIZATION_ALGORITHM, ScoreVector, ScriptType, StorageCommands, StringMatch, TOP_DOWN_CRITERIA_PERSONALIZATION_ALGORITHM, TYPE_SEP, TransitionDataStore, TransitionDataStoreOptions, UNIFORM_DEFAULT_COOKIE_NAME, UNIFORM_DEFAULT_QUIRK_COOKIE_NAME, VariantMatchCriteria, VariationMatchDimensionCriteria, VisitorData, computeAggregateDimensions, cookieEvaluator, createConsoleLogDrain, createDebugConsoleLogDrain, createLinearDecay, currentPageEvaluator, decodeCookieType, decodePersonalizeVariants, enableConsoleLogDrain, enableContextDevTools, enableDebugConsoleLogDrain, enableUniformInsights, encodeCookieType, evaluateVariantMatch, eventEvaluator, explainStringMatch, explainStringMatchCriteria, getEnrichmentVectorKey, isStringMatch, pageViewCountDimension, pageViewCountEvaluator, parseCookieScores, parseCookieType, parseQuickConnect, parseQuirkCookie, parseScoreCookie, personalizeVariations, queryStringEvaluator, quirkEvaluator, serializeCookie, serializeCookieType, serializePersonalizeVariants, serializeQuickConnect, serializeQuirks, strongestScorePersonalizationSelectionAlgorithm, topDownCriteriaPersonalizationSelectionAlgorithm };
+export { AggregateDimension, type ConsoleDebugLogDrainOptions, Context, type ContextDevToolOptions, ContextPlugin, CookieTransitionDataStore, type CookieTransitionDataStoreOptions, CriteriaEvaluator, DecayFunction, DevToolsEvents, ENR_SEPARATOR, EdgeNodeTagName, type EdgePersonalizeComponentOptions, type EdgeTestComponentOptions, EdgeTransitionDataStore, type EdgeTransitionDataStoreOptions, type EnableUniformInsightsOptions, KV_SEP, type LinearDecayOptions, LogDrain, LogMessage, OutputSeverity, PAIR_SEP, PersonalizationSelectionAlgorithmOptions, PersonalizeOptions, PersonalizedResult, PersonalizedVariant, QUIRK_KV_SEP, QUIRK_SEP, type QuickConnectConfig, Quirks, STRONGEST_SCORE_PERSONALIZATION_ALGORITHM, ScoreVector, ScriptType, StorageCommands, StringMatch, TOP_DOWN_CRITERIA_PERSONALIZATION_ALGORITHM, TYPE_SEP, TransitionDataStore, TransitionDataStoreOptions, UNIFORM_DEFAULT_COOKIE_NAME, UNIFORM_DEFAULT_QUIRK_COOKIE_NAME, VariantMatchCriteria, VariationMatchDimensionCriteria, VisitorData, computeAggregateDimensions, cookieEvaluator, createConsoleLogDrain, createDebugConsoleLogDrain, createLinearDecay, currentPageEvaluator, decodeCookieType, decodePersonalizeVariants, enableConsoleLogDrain, enableContextDevTools, enableDebugConsoleLogDrain, enableUniformInsights, encodeCookieType, evaluateVariantMatch, eventEvaluator, explainStringMatch, explainStringMatchCriteria, getEnrichmentVectorKey, isStringMatch, pageViewCountDimension, pageViewCountEvaluator, parseCookieScores, parseCookieType, parseQuickConnect, parseQuirkCookie, parseScoreCookie, personalizeVariations, queryStringEvaluator, quirkEvaluator, serializeCookie, serializeCookieType, serializePersonalizeVariants, serializeQuickConnect, serializeQuirks, strongestScorePersonalizationSelectionAlgorithm, topDownCriteriaPersonalizationSelectionAlgorithm };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { O as OutputSeverity, L as LogDrain, C as ContextPlugin, S as ScoreVector, A as AggregateDimension, T as TransitionDataStore, a as StorageCommands, V as VisitorData, Q as Quirks, b as TransitionDataStoreOptions, D as DecayFunction, c as CriteriaEvaluator, d as StringMatch, e as VariantMatchCriteria, f as LogMessage, P as PersonalizedVariant, g as PersonalizeOptions, h as Context, i as PersonalizedResult, j as VariationMatchDimensionCriteria, k as PersonalizationSelectionAlgorithmOptions, l as DevToolsEvents } from './types-CzIkFCDD.js';
-export { a7 as AggregateDimensionInput, ad as BehaviorTag, m as CONTEXTUAL_EDITING_TEST_NAME, n as CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID, u as ContextEvents, v as ContextInstance, q as ContextOptions, aF as ContextState, aG as ContextStateUpdate, Z as CriteriaEvaluatorParameters, Y as CriteriaEvaluatorResult, au as DecayOptions, y as DevToolsActions, E as DevToolsDataEvent, z as DevToolsEvent, I as DevToolsForgetEvent, F as DevToolsHelloEvent, B as DevToolsLogEvent, H as DevToolsRawCommandsEvent, x as DevToolsState, w as DevToolsUiVersion, G as DevToolsUpdateEvent, ab as DimensionMatch, a4 as EnrichmentCategory, aA as EnrichmentData, aD as EventData, aH as GoalStateUpdate, az as Goals, X as GroupCriteriaEvaluator, an as IdentifyCommand, U as LogMessageGroup, R as LogMessageSingle, J as LogMessages, W as ManifestInstance, $ as ManifestV2, M as MessageCategory, N as MessageFunc, ai as ModifyScoreCommand, aj as ModifySessionScoreCommand, a5 as NumberMatch, s as PersonalizationEvent, r as PersonalizationEventVariantId, a0 as PersonalizationManifest, o as PersonalizationSelectionAlgorithm, p as PersonalizationSelectionAlgorithms, aB as PersonalizeControlVariant, aC as PersonalizeVariants, ac as QuirkMatch, as as SERVER_STATE_ID, ar as ServerToClientTransitionState, ak as SetConsentCommand, ao as SetControlGroupCommand, ah as SetGoalCommand, ap as SetPersonalizeVariantControlCommand, al as SetQuirkCommand, am as SetTestCommand, K as Severity, a1 as Signal, a3 as SignalCriteria, a2 as SignalCriteriaGroup, _ as SignalData, ag as StorageCommand, a6 as TestDefinition, t as TestEvent, a8 as TestOptions, af as TestResult, ae as TestVariant, ay as Tests, at as TransitionDataStoreEvents, aa as VariationMatchMetadata, ax as VisitorDataStore, aw as VisitorDataStoreEvents, av as VisitorDataStoreOptions, aq as areCommandsEqual, aE as emptyVisitorData, a9 as testVariations } from './types-CzIkFCDD.js';
+import { O as OutputSeverity, L as LogDrain, C as ContextPlugin, S as ScoreVector, A as AggregateDimension, T as TransitionDataStore, a as StorageCommands, V as VisitorData, Q as Quirks, b as TransitionDataStoreOptions, D as DecayFunction, c as CriteriaEvaluator, d as StringMatch, e as VariantMatchCriteria, f as LogMessage, P as PersonalizedVariant, g as PersonalizeOptions, h as Context, i as PersonalizedResult, j as VariationMatchDimensionCriteria, k as PersonalizationSelectionAlgorithmOptions, l as DevToolsEvents } from './types-HcKr1VVF.js';
+export { a7 as AggregateDimensionInput, ad as BehaviorTag, m as CONTEXTUAL_EDITING_TEST_NAME, n as CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID, aF as CompositionMetadata, u as ContextEvents, v as ContextInstance, q as ContextOptions, aG as ContextState, aH as ContextStateUpdate, Z as CriteriaEvaluatorParameters, Y as CriteriaEvaluatorResult, au as DecayOptions, y as DevToolsActions, E as DevToolsDataEvent, z as DevToolsEvent, I as DevToolsForgetEvent, F as DevToolsHelloEvent, B as DevToolsLogEvent, H as DevToolsRawCommandsEvent, x as DevToolsState, w as DevToolsUiVersion, G as DevToolsUpdateEvent, ab as DimensionMatch, a4 as EnrichmentCategory, aA as EnrichmentData, aD as EventData, aI as GoalStateUpdate, az as Goals, X as GroupCriteriaEvaluator, an as IdentifyCommand, U as LogMessageGroup, R as LogMessageSingle, J as LogMessages, W as ManifestInstance, $ as ManifestV2, M as MessageCategory, N as MessageFunc, ai as ModifyScoreCommand, aj as ModifySessionScoreCommand, a5 as NumberMatch, s as PersonalizationEvent, r as PersonalizationEventVariantId, a0 as PersonalizationManifest, o as PersonalizationSelectionAlgorithm, p as PersonalizationSelectionAlgorithms, aB as PersonalizeControlVariant, aC as PersonalizeVariants, ac as QuirkMatch, as as SERVER_STATE_ID, ar as ServerToClientTransitionState, ak as SetConsentCommand, ao as SetControlGroupCommand, ah as SetGoalCommand, ap as SetPersonalizeVariantControlCommand, al as SetQuirkCommand, am as SetTestCommand, K as Severity, a1 as Signal, a3 as SignalCriteria, a2 as SignalCriteriaGroup, _ as SignalData, ag as StorageCommand, a6 as TestDefinition, t as TestEvent, a8 as TestOptions, af as TestResult, ae as TestVariant, ay as Tests, at as TransitionDataStoreEvents, aa as VariationMatchMetadata, ax as VisitorDataStore, aw as VisitorDataStoreEvents, av as VisitorDataStoreOptions, aq as areCommandsEqual, aE as emptyVisitorData, a9 as testVariations } from './types-HcKr1VVF.js';
 import Cookies from 'js-cookie';
 import 'mitt';
 
@@ -72,6 +72,7 @@ declare class CookieTransitionDataStore extends TransitionDataStore {
 declare const TYPE_SEP = "~";
 declare const PAIR_SEP = "!";
 declare const KV_SEP = "-";
+declare const QUIRK_KV_SEP = "=";
 declare const QUIRK_SEP = "!!";
 declare function parseScoreCookie(cookieValue: string | undefined, quirkCookieValue?: string): Partial<VisitorData> | undefined;
 declare function parseQuirkCookie(quirkCookieValue: string): Quirks;
@@ -229,9 +230,13 @@ type InsightsEndpoint = {
     apiKey?: string;
     projectId?: string;
 };
+
 type EnableUniformInsightsOptions = {
     endpoint: InsightsEndpoint;
 };
+/**
+ * @deprecated Use `import { enableUniformInsights } from '@uniformdev/insights'` instead
+ */
 declare const enableUniformInsights: (options: EnableUniformInsightsOptions) => ContextPlugin;
 
 type QuickConnectConfig = {
@@ -242,4 +247,4 @@ type QuickConnectConfig = {
 declare function serializeQuickConnect(config: QuickConnectConfig): string;
 declare function parseQuickConnect(serialized: string): Required<QuickConnectConfig>;
 
-export { AggregateDimension, type ConsoleDebugLogDrainOptions, Context, type ContextDevToolOptions, ContextPlugin, CookieTransitionDataStore, type CookieTransitionDataStoreOptions, CriteriaEvaluator, DecayFunction, DevToolsEvents, ENR_SEPARATOR, EdgeNodeTagName, type EdgePersonalizeComponentOptions, type EdgeTestComponentOptions, EdgeTransitionDataStore, type EdgeTransitionDataStoreOptions, type EnableUniformInsightsOptions, KV_SEP, type LinearDecayOptions, LogDrain, LogMessage, OutputSeverity, PAIR_SEP, PersonalizationSelectionAlgorithmOptions, PersonalizeOptions, PersonalizedResult, PersonalizedVariant, QUIRK_SEP, type QuickConnectConfig, Quirks, STRONGEST_SCORE_PERSONALIZATION_ALGORITHM, ScoreVector, ScriptType, StorageCommands, StringMatch, TOP_DOWN_CRITERIA_PERSONALIZATION_ALGORITHM, TYPE_SEP, TransitionDataStore, TransitionDataStoreOptions, UNIFORM_DEFAULT_COOKIE_NAME, UNIFORM_DEFAULT_QUIRK_COOKIE_NAME, VariantMatchCriteria, VariationMatchDimensionCriteria, VisitorData, computeAggregateDimensions, cookieEvaluator, createConsoleLogDrain, createDebugConsoleLogDrain, createLinearDecay, currentPageEvaluator, decodeCookieType, decodePersonalizeVariants, enableConsoleLogDrain, enableContextDevTools, enableDebugConsoleLogDrain, enableUniformInsights, encodeCookieType, evaluateVariantMatch, eventEvaluator, explainStringMatch, explainStringMatchCriteria, getEnrichmentVectorKey, isStringMatch, pageViewCountDimension, pageViewCountEvaluator, parseCookieScores, parseCookieType, parseQuickConnect, parseQuirkCookie, parseScoreCookie, personalizeVariations, queryStringEvaluator, quirkEvaluator, serializeCookie, serializeCookieType, serializePersonalizeVariants, serializeQuickConnect, serializeQuirks, strongestScorePersonalizationSelectionAlgorithm, topDownCriteriaPersonalizationSelectionAlgorithm };
+export { AggregateDimension, type ConsoleDebugLogDrainOptions, Context, type ContextDevToolOptions, ContextPlugin, CookieTransitionDataStore, type CookieTransitionDataStoreOptions, CriteriaEvaluator, DecayFunction, DevToolsEvents, ENR_SEPARATOR, EdgeNodeTagName, type EdgePersonalizeComponentOptions, type EdgeTestComponentOptions, EdgeTransitionDataStore, type EdgeTransitionDataStoreOptions, type EnableUniformInsightsOptions, KV_SEP, type LinearDecayOptions, LogDrain, LogMessage, OutputSeverity, PAIR_SEP, PersonalizationSelectionAlgorithmOptions, PersonalizeOptions, PersonalizedResult, PersonalizedVariant, QUIRK_KV_SEP, QUIRK_SEP, type QuickConnectConfig, Quirks, STRONGEST_SCORE_PERSONALIZATION_ALGORITHM, ScoreVector, ScriptType, StorageCommands, StringMatch, TOP_DOWN_CRITERIA_PERSONALIZATION_ALGORITHM, TYPE_SEP, TransitionDataStore, TransitionDataStoreOptions, UNIFORM_DEFAULT_COOKIE_NAME, UNIFORM_DEFAULT_QUIRK_COOKIE_NAME, VariantMatchCriteria, VariationMatchDimensionCriteria, VisitorData, computeAggregateDimensions, cookieEvaluator, createConsoleLogDrain, createDebugConsoleLogDrain, createLinearDecay, currentPageEvaluator, decodeCookieType, decodePersonalizeVariants, enableConsoleLogDrain, enableContextDevTools, enableDebugConsoleLogDrain, enableUniformInsights, encodeCookieType, evaluateVariantMatch, eventEvaluator, explainStringMatch, explainStringMatchCriteria, getEnrichmentVectorKey, isStringMatch, pageViewCountDimension, pageViewCountEvaluator, parseCookieScores, parseCookieType, parseQuickConnect, parseQuirkCookie, parseScoreCookie, personalizeVariations, queryStringEvaluator, quirkEvaluator, serializeCookie, serializeCookieType, serializePersonalizeVariants, serializeQuickConnect, serializeQuirks, strongestScorePersonalizationSelectionAlgorithm, topDownCriteriaPersonalizationSelectionAlgorithm };

package/dist/index.esm.js

@@ -227,6 +227,10 @@ var ManifestInstance = class {
     }
     return (_d = (_c = __privateGet(this, _mf).pz) == null ? void 0 : _c.enr) == null ? void 0 : _d[scoreKey.substring(0, enrichmentIndex)];
   }
+  getAggregateDimensionByKey(scoreKey) {
+    var _a, _b;
+    return (_b = (_a = __privateGet(this, _mf).pz) == null ? void 0 : _a.agg) == null ? void 0 : _b[scoreKey];
+  }
 };
 _mf = new WeakMap();
 _signalInstances = new WeakMap();
@@ -796,6 +800,7 @@ function strongestScorePersonalizationSelectionAlgorithm({
     const needsConsentToPersonalize = context.requireConsentForPersonalization;
     const isInGlobalControlGroup = (_a = context.storage.data.controlGroup) != null ? _a : false;
     const personalizationAllowed = !needsConsentToPersonalize || context.storage.data.consent;
+    let originalIndex = 0;
     for (const variation of variations) {
       const isInvalidFormat = variation.pz && typeof variation.pz !== "object";
       let validVariation;
@@ -813,12 +818,19 @@ function strongestScorePersonalizationSelectionAlgorithm({
         if (score === void 0 || score <= 0) {
           continue;
         }
-        variationMatches.push({ variation: validVariation, score });
+        variationMatches.push({ variation: validVariation, score, originalIndex });
+        originalIndex++;
       } else {
         defaultVariations.push(validVariation);
       }
     }
-    variationMatches.sort((a, b) => b.score - a.score);
+    variationMatches.sort((a, b) => {
+      const scoreComparison = b.score - a.score;
+      if (scoreComparison === 0) {
+        return a.originalIndex - b.originalIndex;
+      }
+      return scoreComparison;
+    });
     const result = [];
     for (let i = 0; i < variationMatches.length; i++) {
       const variationMatch = variationMatches[i];
@@ -917,11 +929,11 @@ var testVariations = ({
     }
     if (!selectedVariant) {
       const distributions = normalizeVariationDistributions(variations);
-      const random = Math.floor(Math.random() * 100);
+      const random = Math.random() * 100;
       let distributionOffset = 0;
       selectedVariant = variations.find((variant, index) => {
         const distribution = distributions[index];
-        if ((random > distributionOffset || random === 0) && random <= distributionOffset + distribution) {
+        if (random >= distributionOffset && random < distributionOffset + distribution) {
           return variant;
         }
         distributionOffset += distribution;
@@ -933,6 +945,9 @@ var testVariations = ({
     }
     if (selectedVariant) {
       onLogMessage == null ? void 0 : onLogMessage(["info", 404, selectedVariant.id]);
+      if (selectedVariant.control === void 0) {
+        selectedVariant.control = variations.findIndex((variation) => variation.id === selectedVariantId) === 0;
+      }
     }
     return {
       result: selectedVariant,
@@ -1114,6 +1129,7 @@ _quirksEnabled = new WeakMap();
 var TYPE_SEP = "~";
 var PAIR_SEP = "!";
 var KV_SEP = "-";
+var QUIRK_KV_SEP = "=";
 var QUIRK_SEP = "!!";
 function parseScoreCookie(cookieValue, quirkCookieValue) {
   if (!cookieValue) return;
@@ -1137,7 +1153,7 @@ function parseScoreCookie(cookieValue, quirkCookieValue) {
 function parseQuirkCookie(quirkCookieValue) {
   const pairs = quirkCookieValue.split(QUIRK_SEP);
   const splitPairs = pairs.map((pair) => {
-    const sep = pair.indexOf(KV_SEP);
+    const sep = pair.indexOf(QUIRK_KV_SEP);
     if (sep === -1) {
       return void 0;
     }
@@ -1238,7 +1254,7 @@ function serializeCookieType(type) {
   return Object.entries(type).map((kv) => kv.join(KV_SEP)).join(PAIR_SEP);
 }
 function serializeQuirks(quirks) {
-  return Object.entries(quirks).map((kv) => kv.join(KV_SEP)).join(QUIRK_SEP);
+  return Object.entries(quirks).map((kv) => kv.join(QUIRK_KV_SEP)).join(QUIRK_SEP);
 }
 
 // src/storage/EdgeTransitionDataStore.ts
@@ -1729,6 +1745,9 @@ var Context = class {
             __privateSet(this, _scores, state.ssv);
             __privateGet(this, _mitt3).emit("log", ["debug", 130, state]);
           }
+          if (state.compositionMetadata) {
+            __privateGet(this, _state).compositionMetadata = state.compositionMetadata;
+          }
         },
         onLogMessage: (message) => __privateGet(this, _mitt3).emit("log", message)
       });
@@ -1881,10 +1900,16 @@ var Context = class {
           scores: __privateGet(this, _serverTransitionState) ? __privateMethod(this, _Context_instances, calculateScores_fn).call(this, this.storage.data) : __privateGet(this, _scores)
         })
       );
+      const previousCompositionMetadata = __privateGet(this, _state).compositionMetadata;
       __privateSet(this, _state, {
         ...__privateGet(this, _state),
         ...newData
       });
+      if (newData.compositionMetadata && // deep equal is not too bad, as we only have 1 level of depth in dynamic inputs
+      !dequal5(previousCompositionMetadata, __privateGet(this, _state).compositionMetadata)) {
+        __privateGet(this, _mitt3).emit("canvasDataUpdated", __privateGet(this, _state).compositionMetadata);
+        __privateGet(this, _state).compositionMetadata = newData.compositionMetadata;
+      }
       await this.storage.updateData(commands);
       if (__privateGet(this, _serverTransitionState)) {
         await this.processServerCommands({
@@ -1896,7 +1921,9 @@ var Context = class {
           __privateMethod(this, _Context_instances, emitTest_fn).call(this, {
             name: testName,
             variantId: testVariantId,
-            variantAssigned: true
+            variantAssigned: true,
+            control: false,
+            compositionMetadata: void 0
           });
         });
         const haveQuirksChanged = __privateGet(this, _serverTransitionState) && !dequal5(__privateGet(this, _serverTransitionState).quirks, this.storage.data.quirks);
@@ -1912,7 +1939,7 @@ var Context = class {
           if (!plugin.update) {
             continue;
           }
-          await plugin.update(newData);
+          await plugin.update(newData, __privateGet(this, _scores));
         }
       }
       (_e = __privateGet(this, _commands)) == null ? void 0 : _e.push(...commands);
@@ -1978,7 +2005,7 @@ var Context = class {
   }
   /** Executes an A/B test with a given set of variants, showing the visitor's assigned variant (or selecting one to assign, if none is set yet) */
   test(options) {
-    var _a, _b, _c;
+    var _a, _b, _c, _d, _e;
     if (options.name === CONTEXTUAL_EDITING_TEST_NAME) {
       const selectedVariant = (_a = options.variations.find((variant) => variant.id === CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID)) != null ? _a : options.variations.at(-1);
       const value2 = {
@@ -1995,7 +2022,9 @@ var Context = class {
     __privateMethod(this, _Context_instances, emitTest_fn).call(this, {
       name: options.name,
       variantId: (_c = (_b = value.result) == null ? void 0 : _b.id) != null ? _c : void 0,
-      variantAssigned: value.variantAssigned
+      variantAssigned: value.variantAssigned,
+      control: (_e = (_d = value.result) == null ? void 0 : _d.control) != null ? _e : false,
+      compositionMetadata: options.compositionMetadata
     });
     return value;
   }
@@ -2024,7 +2053,8 @@ var Context = class {
         control: variation.control
       })),
       control: this.storage.data.controlGroup,
-      changed: true
+      changed: true,
+      compositionMetadata: options.compositionMetadata
     };
     if (previousPlacement && dequal5(eventData.variantIds, previousPlacement)) {
       eventData.changed = false;
@@ -2038,7 +2068,10 @@ var Context = class {
    * @param fromAllDevices for an identified user, whether to delete all their data (for the entire account) - true, or data for this device (sign out) - false
    */
   async forget(fromAllDevices) {
-    __privateSet(this, _state, {});
+    const previousCompositionMetadata = __privateGet(this, _state).compositionMetadata;
+    __privateSet(this, _state, {
+      compositionMetadata: previousCompositionMetadata
+    });
     if (__privateGet(this, _plugins)) {
       for (let i = 0; i < __privateGet(this, _plugins).length; i++) {
         const plugin = __privateGet(this, _plugins)[i];
@@ -2061,7 +2094,8 @@ var Context = class {
       ssv: __privateGet(this, _scores),
       tests: {},
       personalizeVariants: this.storage.data.personalizeVariants,
-      commands: __privateGet(this, _commands)
+      commands: __privateGet(this, _commands),
+      compositionMetadata: __privateGet(this, _state).compositionMetadata
     };
     const allTests = this.storage.data.tests;
     Object.entries(allTests).map(([testName, testValue]) => {
@@ -2084,6 +2118,27 @@ var Context = class {
     __privateGet(this, _pzCache)[event.name] = event.variantIds;
     __privateGet(this, _mitt3).emit("personalizationResult", event);
   }
+  /**
+   * Gets the current canvas data
+   */
+  getCompositionMetadata() {
+    return __privateGet(this, _state).compositionMetadata;
+  }
+  /**
+   * Updates the canvas data and emits a canvasDataUpdated event
+   */
+  async updateCompositionMetadata(newData) {
+    const currentCanvas = __privateGet(this, _state).compositionMetadata || {};
+    const updatedCanvas = { ...currentCanvas, ...newData };
+    if (!dequal5(currentCanvas, updatedCanvas)) {
+      __privateSet(this, _state, {
+        ...__privateGet(this, _state),
+        compositionMetadata: updatedCanvas
+      });
+      __privateGet(this, _mitt3).emit("canvasDataUpdated", updatedCanvas);
+      __privateGet(this, _mitt3).emit("log", ["info", 4, "Canvas data updated"]);
+    }
+  }
 };
 _personalizationSelectionAlgorithms = new WeakMap();
 _serverTransitionState = new WeakMap();
@@ -2248,8 +2303,31 @@ var ScriptType = /* @__PURE__ */ ((ScriptType2) => {
 })(ScriptType || {});
 var EdgeNodeTagName = "nesitag";
 
-// src/insights/index.ts
-import { v4 } from "uuid";
+// src/insights/storage.ts
+var createInsightsStorage = () => {
+  const STORAGE_KEY2 = "ufin";
+  return {
+    get: () => {
+      const data = localStorage.getItem(STORAGE_KEY2);
+      if (!data) {
+        return;
+      }
+      return JSON.parse(data);
+    },
+    set: (data) => {
+      const toSet = {
+        ...data,
+        updated: Date.now()
+      };
+      localStorage.setItem(STORAGE_KEY2, JSON.stringify(toSet));
+    },
+    clear: () => {
+      localStorage.removeItem(STORAGE_KEY2);
+    }
+  };
+};
+
+// src/insights/types.ts
 var getBasePayload = () => {
   const timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;
   const locale = navigator.languages && navigator.languages.length ? navigator.languages[0] : navigator.userLanguage || navigator.language || navigator.browserLanguage || "en";
@@ -2262,13 +2340,34 @@ var getBasePayload = () => {
     href: window.location.href
   };
 };
+var generateVisitorId = () => {
+  return `visitor_${generalRandomId()}`;
+};
+var generateSessionId = () => {
+  return `session_${generalRandomId()}`;
+};
+var generatePageId = () => {
+  return `page_${generalRandomId()}`;
+};
+var generalRandomId = () => {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    const id = crypto.randomUUID();
+    return id.replaceAll("-", "").toLowerCase();
+  }
+  return Math.random().toString(32).substring(2);
+};
+
+// src/insights/v1.ts
 var createInsightsClient = ({ endpoint }) => {
   let endpointUrl;
   const apiKey = endpoint.apiKey;
   const projectId = endpoint.projectId;
   if (endpoint.type === "api") {
     const url = new URL(endpoint.host);
-    url.pathname = "/v0/events";
+    url.pathname = `/v0/events`;
+    if (endpoint.host.includes("tinybird.co")) {
+      url.pathname = "/v0/events";
+    }
     url.searchParams.set("name", "analytics_events");
     endpointUrl = url.toString();
   } else {
@@ -2398,38 +2497,7 @@ var createInsightsClient = ({ endpoint }) => {
     }
   };
 };
-var createInsightsStorage = () => {
-  const STORAGE_KEY2 = "ufin";
-  return {
-    get: () => {
-      const data = localStorage.getItem(STORAGE_KEY2);
-      if (!data) {
-        return;
-      }
-      return JSON.parse(data);
-    },
-    set: (data) => {
-      const toSet = {
-        ...data,
-        updated: Date.now()
-      };
-      localStorage.setItem(STORAGE_KEY2, JSON.stringify(toSet));
-    },
-    clear: () => {
-      localStorage.removeItem(STORAGE_KEY2);
-    }
-  };
-};
-var generateVisitorId = () => {
-  return `visitor_${generalRandomId()}`;
-};
-var generateSessionId = () => {
-  return `session_${generalRandomId()}`;
-};
-var generatePageId = () => {
-  return `page_${generalRandomId()}`;
-};
-var createInsights = ({
+var createInsightsV1 = ({
   endpoint,
   sessionDurationSeconds = 30 * 60
 }) => {
@@ -2530,8 +2598,10 @@ var createInsights = ({
     }
   };
 };
+
+// src/insights/index.ts
 var enableUniformInsights = (options) => {
-  const insights = createInsights({
+  const insights = createInsightsV1({
     endpoint: options.endpoint
   });
   let previousUrl = void 0;
@@ -2577,8 +2647,8 @@ var enableUniformInsights = (options) => {
       };
     },
     update: (context) => {
-      if (context.url && context.url !== previousUrl) {
-        previousUrl = context.url;
+      if (context.url && context.url.toString() !== previousUrl) {
+        previousUrl = context.url.toString();
         insights.pageHit();
       }
     },
@@ -2587,10 +2657,6 @@ var enableUniformInsights = (options) => {
     }
   };
 };
-var generalRandomId = () => {
-  const id = v4();
-  return id.replaceAll("-", "").toLowerCase();
-};
 
 // src/logging/enableConsoleLogDrain.ts
 import rfdc2 from "rfdc";
@@ -2787,6 +2853,7 @@ export {
   KV_SEP,
   ManifestInstance,
   PAIR_SEP,
+  QUIRK_KV_SEP,
   QUIRK_SEP,
   SERVER_STATE_ID,
   STRONGEST_SCORE_PERSONALIZATION_ALGORITHM,