@uniformdev/context 20.84.0 → 20.86.0

package/dist/api/api.d.mts

@@ -1,4 +1,4 @@
-import { p as paths$7, M as ManifestV2 } from '../types-DovaM4gV.mjs';
+import { p as paths$7, M as ManifestV2 } from '../types-p9vnD820.mjs';
 import 'mitt';
 
 type LimitPolicy = <ReturnValue>(func: () => Promise<ReturnValue>) => Promise<ReturnValue>;

package/dist/api/api.d.ts

@@ -1,4 +1,4 @@
-import { p as paths$7, M as ManifestV2 } from '../types-DovaM4gV.js';
+import { p as paths$7, M as ManifestV2 } from '../types-p9vnD820.js';
 import 'mitt';
 
 type LimitPolicy = <ReturnValue>(func: () => Promise<ReturnValue>) => Promise<ReturnValue>;

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-DovaM4gV.mjs';
-export { m as AggregateDimensionInput, B as BehaviorTag, n as CONTEXTUAL_EDITING_TEST_NAME, o as CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID, q as CompositionMetadata, r as ContextEvents, s as ContextInstance, t as ContextOptions, u as ContextState, v as ContextStateUpdate, w as CriteriaEvaluatorParameters, x as CriteriaEvaluatorResult, y as DecayOptions, z as DevToolsActions, E as DevToolsDataEvent, F as DevToolsEvent, G as DevToolsForgetEvent, H as DevToolsHelloEvent, I as DevToolsLogEvent, J as DevToolsRawCommandsEvent, K as DevToolsState, N as DevToolsUiVersion, R as DevToolsUpdateEvent, U as DimensionMatch, W as EnrichmentCategory, X as EnrichmentData, Y as EventData, Z as GoalStateUpdate, _ as Goals, $ as GroupCriteriaEvaluator, a0 as IdentifyCommand, a1 as LogMessageGroup, a2 as LogMessageSingle, a3 as LogMessages, a4 as ManifestInstance, M as ManifestV2, a5 as MessageCategory, a6 as MessageFunc, a7 as ModifyScoreCommand, a8 as ModifySessionScoreCommand, a9 as NumberMatch, aa as PersonalizationEvent, ab as PersonalizationEventVariantId, ac as PersonalizationManifest, ad as PersonalizationSelectionAlgorithm, ae as PersonalizationSelectionAlgorithms, af as PersonalizeControlVariant, ag as PersonalizeVariants, ah as QuirkMatch, ai as SERVER_STATE_ID, aj as ServerToClientTransitionState, ak as SetConsentCommand, al as SetControlGroupCommand, am as SetGoalCommand, an as SetPersonalizeVariantControlCommand, ao as SetQuirkCommand, ap as SetTestCommand, aq as Severity, ar as Signal, as as SignalCriteria, at as SignalCriteriaGroup, au as SignalData, av as StorageCommand, aw as TestDefinition, ax as TestEvent, ay as TestOptions, az as TestResult, aA as TestVariant, aB as Tests, aC as TransitionDataStoreEvents, aD as VariationMatchMetadata, aE as VisitorDataStore, aF as VisitorDataStoreEvents, aG as VisitorDataStoreOptions, aH as areCommandsEqual, aI as emptyVisitorData, aJ as testVariations } from './types-DovaM4gV.mjs';
+import { O as OutputSeverity, L as LogDrain, C as ContextPlugin, S as ScoreVector, A as AggregateDimension, T as TransitionDataStore, a as LogMessage, b as StorageCommands, V as VisitorData, Q as Quirks, c as TransitionDataStoreOptions, D as DecayFunction, d as CriteriaEvaluator, e as StringMatch, f as VariantMatchCriteria, P as PersonalizedVariant, g as PersonalizeOptions, h as Context, i as PersonalizedResult, j as VariationMatchDimensionCriteria, k as PersonalizationSelectionAlgorithmOptions, l as DevToolsEvents } from './types-p9vnD820.mjs';
+export { m as AggregateDimensionInput, B as BehaviorTag, n as CONTEXTUAL_EDITING_TEST_NAME, o as CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID, q as CompositionMetadata, r as ContextEvents, s as ContextInstance, t as ContextOptions, u as ContextState, v as ContextStateUpdate, w as CriteriaEvaluatorParameters, x as CriteriaEvaluatorResult, y as DecayOptions, z as DevToolsActions, E as DevToolsDataEvent, F as DevToolsEvent, G as DevToolsForgetEvent, H as DevToolsHelloEvent, I as DevToolsLogEvent, J as DevToolsRawCommandsEvent, K as DevToolsState, N as DevToolsUiVersion, R as DevToolsUpdateEvent, U as DimensionMatch, W as EnrichmentCategory, X as EnrichmentData, Y as EventData, Z as GoalStateUpdate, _ as Goals, $ as GroupCriteriaEvaluator, a0 as IdentifyCommand, a1 as LogMessageGroup, a2 as LogMessageSingle, a3 as LogMessages, a4 as ManifestInstance, M as ManifestV2, a5 as MessageCategory, a6 as MessageFunc, a7 as ModifyScoreCommand, a8 as ModifySessionScoreCommand, a9 as NumberMatch, aa as PersonalizationEvent, ab as PersonalizationEventVariantId, ac as PersonalizationManifest, ad as PersonalizationSelectionAlgorithm, ae as PersonalizationSelectionAlgorithms, af as PersonalizeControlVariant, ag as PersonalizeVariants, ah as QuirkMatch, ai as SERVER_STATE_ID, aj as ServerToClientTransitionState, ak as SetConsentCommand, al as SetControlGroupCommand, am as SetGoalCommand, an as SetPersonalizeVariantControlCommand, ao as SetQuirkCommand, ap as SetTestCommand, aq as Severity, ar as Signal, as as SignalCriteria, at as SignalCriteriaGroup, au as SignalData, av as StorageCommand, aw as TestDefinition, ax as TestEvent, ay as TestOptions, az as TestResult, aA as TestVariant, aB as Tests, aC as TransitionDataStoreEvents, aD as VariationMatchMetadata, aE as VisitorDataStore, aF as VisitorDataStoreEvents, aG as VisitorDataStoreOptions, aH as areCommandsEqual, aI as emptyVisitorData, aJ as testVariations } from './types-p9vnD820.mjs';
 import 'mitt';
 
 /**
@@ -55,6 +55,27 @@ type CookieTransitionDataStoreOptions = {
      * local storage is the master copy. Defaults to SameSite=Lax.
      */
     cookieAttributes?: Cookies.CookieAttributes;
+    /**
+     * Ceiling on the size in bytes of the transition cookie, measured on the percent-encoded
+     * `name=value` pair as the request header carries it.
+     *
+     * When the visitor's data does not fit, the least valuable parts are dropped until it does,
+     * deterministically: dimensions the cookie would write as zero, then remaining dimensions by
+     * ascending score, then personalize variants, then test assignments. Control group membership
+     * is never dropped, so a budget below the cookie's empty cost is refused at construction.
+     *
+     * Covers this cookie only, not the quirk cookie, its attributes or other cookies on the domain.
+     * Local storage remains the complete copy, so only what the server is told is lost.
+     *
+     * @defaultValue undefined - the cookie is unbounded
+     */
+    maxBytes?: number;
+    /**
+     * Called with log messages the store emits, such as a report of what `maxBytes` dropped.
+     * Also settable after construction, which is how a host that builds the store as an argument
+     * to its `Context` points it at {@link Context.log}.
+     */
+    onLogMessage?: (message: LogMessage) => void;
 };
 declare const UNIFORM_DEFAULT_COOKIE_NAME = "ufvd";
 declare const UNIFORM_DEFAULT_QUIRK_COOKIE_NAME = "ufvdqk";
@@ -64,7 +85,9 @@ declare const UNIFORM_DEFAULT_QUIRK_COOKIE_NAME = "ufvdqk";
  */
 declare class CookieTransitionDataStore extends TransitionDataStore {
     #private;
-    constructor({ serverCookieValue, experimental_quirksEnabled, quirkCookieValue, quirkCookieName, cookieName, cookieAttributes, }: CookieTransitionDataStoreOptions);
+    /** Where the store's log messages go. See {@link CookieTransitionDataStoreOptions.onLogMessage}. */
+    onLogMessage: ((message: LogMessage) => void) | undefined;
+    constructor({ serverCookieValue, experimental_quirksEnabled, quirkCookieValue, quirkCookieName, cookieName, cookieAttributes, maxBytes, onLogMessage, }: CookieTransitionDataStoreOptions);
     handleDelete(): Promise<void>;
     handleUpdateData(_: StorageCommands[], computedValue: VisitorData): Promise<void>;
 }
@@ -77,7 +100,19 @@ declare function parseQuirkCookie(quirkCookieValue: string): Quirks;
 declare function parseCookieScores(type: string | undefined): Record<string, string>;
 declare function parseCookieType(type: string | undefined): Record<string, string>;
 declare function decodeCookieType(type: Record<string, string>): Record<string, number>;
-declare function serializeCookie(data: VisitorData): string;
+type SerializeCookieOptions = {
+    /**
+     * Ceiling on the size in bytes of the percent-encoded `name=value` pair.
+     * Parts of the visitor data are dropped until the cookie fits; see the drop order on
+     * {@link CookieTransitionDataStoreOptions.maxBytes}.
+     */
+    maxBytes?: number;
+    /** Cookie name, counted toward `maxBytes` along with the `=` that follows it. */
+    cookieName?: string;
+    /** Called once, when `maxBytes` forced at least one drop, with what was dropped. */
+    onBudgetExceeded?: (dropped: string[], bytes: number, maxBytes: number) => void;
+};
+declare function serializeCookie(data: VisitorData, options?: SerializeCookieOptions): string;
 declare function serializePersonalizeVariants({ personalizeVariants, }: Pick<VisitorData, 'personalizeVariants'>): string;
 declare function decodePersonalizeVariants(data: string | undefined): VisitorData['personalizeVariants'];
 declare function encodeCookieType(type: Record<string, number>): Record<string, string>;
@@ -225,4 +260,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, 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, 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, KV_SEP, type LinearDecayOptions, LogDrain, LogMessage, OutputSeverity, PAIR_SEP, PersonalizationSelectionAlgorithmOptions, PersonalizeOptions, PersonalizedResult, PersonalizedVariant, QUIRK_SEP, type QuickConnectConfig, Quirks, STRONGEST_SCORE_PERSONALIZATION_ALGORITHM, ScoreVector, ScriptType, type SerializeCookieOptions, 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, 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-DovaM4gV.js';
-export { m as AggregateDimensionInput, B as BehaviorTag, n as CONTEXTUAL_EDITING_TEST_NAME, o as CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID, q as CompositionMetadata, r as ContextEvents, s as ContextInstance, t as ContextOptions, u as ContextState, v as ContextStateUpdate, w as CriteriaEvaluatorParameters, x as CriteriaEvaluatorResult, y as DecayOptions, z as DevToolsActions, E as DevToolsDataEvent, F as DevToolsEvent, G as DevToolsForgetEvent, H as DevToolsHelloEvent, I as DevToolsLogEvent, J as DevToolsRawCommandsEvent, K as DevToolsState, N as DevToolsUiVersion, R as DevToolsUpdateEvent, U as DimensionMatch, W as EnrichmentCategory, X as EnrichmentData, Y as EventData, Z as GoalStateUpdate, _ as Goals, $ as GroupCriteriaEvaluator, a0 as IdentifyCommand, a1 as LogMessageGroup, a2 as LogMessageSingle, a3 as LogMessages, a4 as ManifestInstance, M as ManifestV2, a5 as MessageCategory, a6 as MessageFunc, a7 as ModifyScoreCommand, a8 as ModifySessionScoreCommand, a9 as NumberMatch, aa as PersonalizationEvent, ab as PersonalizationEventVariantId, ac as PersonalizationManifest, ad as PersonalizationSelectionAlgorithm, ae as PersonalizationSelectionAlgorithms, af as PersonalizeControlVariant, ag as PersonalizeVariants, ah as QuirkMatch, ai as SERVER_STATE_ID, aj as ServerToClientTransitionState, ak as SetConsentCommand, al as SetControlGroupCommand, am as SetGoalCommand, an as SetPersonalizeVariantControlCommand, ao as SetQuirkCommand, ap as SetTestCommand, aq as Severity, ar as Signal, as as SignalCriteria, at as SignalCriteriaGroup, au as SignalData, av as StorageCommand, aw as TestDefinition, ax as TestEvent, ay as TestOptions, az as TestResult, aA as TestVariant, aB as Tests, aC as TransitionDataStoreEvents, aD as VariationMatchMetadata, aE as VisitorDataStore, aF as VisitorDataStoreEvents, aG as VisitorDataStoreOptions, aH as areCommandsEqual, aI as emptyVisitorData, aJ as testVariations } from './types-DovaM4gV.js';
+import { O as OutputSeverity, L as LogDrain, C as ContextPlugin, S as ScoreVector, A as AggregateDimension, T as TransitionDataStore, a as LogMessage, b as StorageCommands, V as VisitorData, Q as Quirks, c as TransitionDataStoreOptions, D as DecayFunction, d as CriteriaEvaluator, e as StringMatch, f as VariantMatchCriteria, P as PersonalizedVariant, g as PersonalizeOptions, h as Context, i as PersonalizedResult, j as VariationMatchDimensionCriteria, k as PersonalizationSelectionAlgorithmOptions, l as DevToolsEvents } from './types-p9vnD820.js';
+export { m as AggregateDimensionInput, B as BehaviorTag, n as CONTEXTUAL_EDITING_TEST_NAME, o as CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID, q as CompositionMetadata, r as ContextEvents, s as ContextInstance, t as ContextOptions, u as ContextState, v as ContextStateUpdate, w as CriteriaEvaluatorParameters, x as CriteriaEvaluatorResult, y as DecayOptions, z as DevToolsActions, E as DevToolsDataEvent, F as DevToolsEvent, G as DevToolsForgetEvent, H as DevToolsHelloEvent, I as DevToolsLogEvent, J as DevToolsRawCommandsEvent, K as DevToolsState, N as DevToolsUiVersion, R as DevToolsUpdateEvent, U as DimensionMatch, W as EnrichmentCategory, X as EnrichmentData, Y as EventData, Z as GoalStateUpdate, _ as Goals, $ as GroupCriteriaEvaluator, a0 as IdentifyCommand, a1 as LogMessageGroup, a2 as LogMessageSingle, a3 as LogMessages, a4 as ManifestInstance, M as ManifestV2, a5 as MessageCategory, a6 as MessageFunc, a7 as ModifyScoreCommand, a8 as ModifySessionScoreCommand, a9 as NumberMatch, aa as PersonalizationEvent, ab as PersonalizationEventVariantId, ac as PersonalizationManifest, ad as PersonalizationSelectionAlgorithm, ae as PersonalizationSelectionAlgorithms, af as PersonalizeControlVariant, ag as PersonalizeVariants, ah as QuirkMatch, ai as SERVER_STATE_ID, aj as ServerToClientTransitionState, ak as SetConsentCommand, al as SetControlGroupCommand, am as SetGoalCommand, an as SetPersonalizeVariantControlCommand, ao as SetQuirkCommand, ap as SetTestCommand, aq as Severity, ar as Signal, as as SignalCriteria, at as SignalCriteriaGroup, au as SignalData, av as StorageCommand, aw as TestDefinition, ax as TestEvent, ay as TestOptions, az as TestResult, aA as TestVariant, aB as Tests, aC as TransitionDataStoreEvents, aD as VariationMatchMetadata, aE as VisitorDataStore, aF as VisitorDataStoreEvents, aG as VisitorDataStoreOptions, aH as areCommandsEqual, aI as emptyVisitorData, aJ as testVariations } from './types-p9vnD820.js';
 import 'mitt';
 
 /**
@@ -55,6 +55,27 @@ type CookieTransitionDataStoreOptions = {
      * local storage is the master copy. Defaults to SameSite=Lax.
      */
     cookieAttributes?: Cookies.CookieAttributes;
+    /**
+     * Ceiling on the size in bytes of the transition cookie, measured on the percent-encoded
+     * `name=value` pair as the request header carries it.
+     *
+     * When the visitor's data does not fit, the least valuable parts are dropped until it does,
+     * deterministically: dimensions the cookie would write as zero, then remaining dimensions by
+     * ascending score, then personalize variants, then test assignments. Control group membership
+     * is never dropped, so a budget below the cookie's empty cost is refused at construction.
+     *
+     * Covers this cookie only, not the quirk cookie, its attributes or other cookies on the domain.
+     * Local storage remains the complete copy, so only what the server is told is lost.
+     *
+     * @defaultValue undefined - the cookie is unbounded
+     */
+    maxBytes?: number;
+    /**
+     * Called with log messages the store emits, such as a report of what `maxBytes` dropped.
+     * Also settable after construction, which is how a host that builds the store as an argument
+     * to its `Context` points it at {@link Context.log}.
+     */
+    onLogMessage?: (message: LogMessage) => void;
 };
 declare const UNIFORM_DEFAULT_COOKIE_NAME = "ufvd";
 declare const UNIFORM_DEFAULT_QUIRK_COOKIE_NAME = "ufvdqk";
@@ -64,7 +85,9 @@ declare const UNIFORM_DEFAULT_QUIRK_COOKIE_NAME = "ufvdqk";
  */
 declare class CookieTransitionDataStore extends TransitionDataStore {
     #private;
-    constructor({ serverCookieValue, experimental_quirksEnabled, quirkCookieValue, quirkCookieName, cookieName, cookieAttributes, }: CookieTransitionDataStoreOptions);
+    /** Where the store's log messages go. See {@link CookieTransitionDataStoreOptions.onLogMessage}. */
+    onLogMessage: ((message: LogMessage) => void) | undefined;
+    constructor({ serverCookieValue, experimental_quirksEnabled, quirkCookieValue, quirkCookieName, cookieName, cookieAttributes, maxBytes, onLogMessage, }: CookieTransitionDataStoreOptions);
     handleDelete(): Promise<void>;
     handleUpdateData(_: StorageCommands[], computedValue: VisitorData): Promise<void>;
 }
@@ -77,7 +100,19 @@ declare function parseQuirkCookie(quirkCookieValue: string): Quirks;
 declare function parseCookieScores(type: string | undefined): Record<string, string>;
 declare function parseCookieType(type: string | undefined): Record<string, string>;
 declare function decodeCookieType(type: Record<string, string>): Record<string, number>;
-declare function serializeCookie(data: VisitorData): string;
+type SerializeCookieOptions = {
+    /**
+     * Ceiling on the size in bytes of the percent-encoded `name=value` pair.
+     * Parts of the visitor data are dropped until the cookie fits; see the drop order on
+     * {@link CookieTransitionDataStoreOptions.maxBytes}.
+     */
+    maxBytes?: number;
+    /** Cookie name, counted toward `maxBytes` along with the `=` that follows it. */
+    cookieName?: string;
+    /** Called once, when `maxBytes` forced at least one drop, with what was dropped. */
+    onBudgetExceeded?: (dropped: string[], bytes: number, maxBytes: number) => void;
+};
+declare function serializeCookie(data: VisitorData, options?: SerializeCookieOptions): string;
 declare function serializePersonalizeVariants({ personalizeVariants, }: Pick<VisitorData, 'personalizeVariants'>): string;
 declare function decodePersonalizeVariants(data: string | undefined): VisitorData['personalizeVariants'];
 declare function encodeCookieType(type: Record<string, number>): Record<string, string>;
@@ -225,4 +260,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, 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, 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, KV_SEP, type LinearDecayOptions, LogDrain, LogMessage, OutputSeverity, PAIR_SEP, PersonalizationSelectionAlgorithmOptions, PersonalizeOptions, PersonalizedResult, PersonalizedVariant, QUIRK_SEP, type QuickConnectConfig, Quirks, STRONGEST_SCORE_PERSONALIZATION_ALGORITHM, ScoreVector, ScriptType, type SerializeCookieOptions, 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, 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

@@ -1074,11 +1074,14 @@ var bton = (base64) => {
   return sign ? -number : number;
 };
 
+// src/storage/util/zeroScore.ts
+var isZeroCookieScore = (score) => Math.abs(score) < 1;
+
 // src/storage/CookieTransitionDataStore.ts
 var ssr = typeof document === "undefined";
 var UNIFORM_DEFAULT_COOKIE_NAME = "ufvd";
 var UNIFORM_DEFAULT_QUIRK_COOKIE_NAME = `ufvdqk`;
-var _cookieName, _quirkCookieName, _cookieAttributes, _quirksEnabled;
+var _cookieName, _quirkCookieName, _cookieAttributes, _quirksEnabled, _maxBytes;
 var CookieTransitionDataStore = class extends TransitionDataStore {
   constructor({
     serverCookieValue,
@@ -1086,7 +1089,9 @@ var CookieTransitionDataStore = class extends TransitionDataStore {
     quirkCookieValue,
     quirkCookieName = UNIFORM_DEFAULT_QUIRK_COOKIE_NAME,
     cookieName = UNIFORM_DEFAULT_COOKIE_NAME,
-    cookieAttributes = { sameSite: "lax" }
+    cookieAttributes = { sameSite: "lax" },
+    maxBytes,
+    onLogMessage
   }) {
     super({
       initialData: ssr ? parseScoreCookie(serverCookieValue, experimental_quirksEnabled ? quirkCookieValue : void 0) : void 0
@@ -1095,10 +1100,21 @@ var CookieTransitionDataStore = class extends TransitionDataStore {
     __privateAdd(this, _quirkCookieName);
     __privateAdd(this, _cookieAttributes);
     __privateAdd(this, _quirksEnabled);
+    __privateAdd(this, _maxBytes);
+    /** Where the store's log messages go. See {@link CookieTransitionDataStoreOptions.onLogMessage}. */
+    __publicField(this, "onLogMessage");
     __privateSet(this, _cookieName, cookieName);
     __privateSet(this, _cookieAttributes, cookieAttributes);
     __privateSet(this, _quirkCookieName, quirkCookieName);
     __privateSet(this, _quirksEnabled, experimental_quirksEnabled || false);
+    __privateSet(this, _maxBytes, maxBytes);
+    this.onLogMessage = onLogMessage;
+    const minimumBytes = minimumCookieBytes(cookieName);
+    if (maxBytes !== void 0 && maxBytes < minimumBytes) {
+      throw new Error(
+        `maxBytes of ${maxBytes} is below the ${minimumBytes} bytes the "${cookieName}" cookie costs when it carries nothing but control group membership, so no visitor could ever meet it.`
+      );
+    }
   }
   handleDelete() {
     if (ssr) return Promise.resolve();
@@ -1108,7 +1124,15 @@ var CookieTransitionDataStore = class extends TransitionDataStore {
   async handleUpdateData(_, computedValue) {
     if (ssr) return;
     if (computedValue.consent) {
-      Cookies.set(__privateGet(this, _cookieName), serializeCookie(computedValue), __privateGet(this, _cookieAttributes));
+      const cookieValue = serializeCookie(computedValue, {
+        maxBytes: __privateGet(this, _maxBytes),
+        cookieName: __privateGet(this, _cookieName),
+        onBudgetExceeded: (dropped, bytes, maxBytes) => {
+          var _a;
+          return (_a = this.onLogMessage) == null ? void 0 : _a.call(this, ["info", 151, { dropped, bytes, maxBytes }]);
+        }
+      });
+      Cookies.set(__privateGet(this, _cookieName), cookieValue, __privateGet(this, _cookieAttributes));
       if (__privateGet(this, _quirksEnabled) && Object.keys(computedValue.quirks || {}).length) {
         const quirkCookieValue = serializeQuirks(computedValue.quirks || {});
         Cookies.set(__privateGet(this, _quirkCookieName), quirkCookieValue, __privateGet(this, _cookieAttributes));
@@ -1125,6 +1149,7 @@ _cookieName = new WeakMap();
 _quirkCookieName = new WeakMap();
 _cookieAttributes = new WeakMap();
 _quirksEnabled = new WeakMap();
+_maxBytes = new WeakMap();
 var TYPE_SEP = "~";
 var PAIR_SEP = "!";
 var KV_SEP = "-";
@@ -1196,18 +1221,71 @@ function decodeCookieType(type) {
     return acc;
   }, {});
 }
-function serializeCookie(data) {
+function serializeCookie(data, options = {}) {
+  const { maxBytes, cookieName = UNIFORM_DEFAULT_COOKIE_NAME, onBudgetExceeded } = options;
+  const parts = {
+    tests: { ...data.tests },
+    sessionScores: encodeCookieType(data.sessionScores),
+    scores: encodeCookieType(data.scores),
+    controlGroup: data.controlGroup ? "1" : "0",
+    personalizeVariants: encodePersonalizeVariants(data.personalizeVariants)
+  };
+  let value = serializeCookieParts(parts);
+  if (maxBytes === void 0) {
+    return value;
+  }
+  const overhead = encodeCookieName(cookieName).length + 1;
+  const measure = () => overhead + Cookies.converter.write(value, cookieName).length;
+  if (measure() <= maxBytes) {
+    return value;
+  }
+  const candidates = dropCandidates(parts, data);
+  const dropped = [];
+  for (let i = 0; i < candidates.length && measure() > maxBytes; i++) {
+    const { bucket, key } = candidates[i];
+    delete parts[bucket][key];
+    dropped.push(`${bucket}.${key}`);
+    value = serializeCookieParts(parts);
+  }
+  if (dropped.length) {
+    onBudgetExceeded == null ? void 0 : onBudgetExceeded(dropped, measure(), maxBytes);
+  }
+  return value;
+}
+function serializeCookieParts(parts) {
   return [
-    serializeCookieType(data.tests),
-    serializeCookieType(encodeCookieType(data.sessionScores)),
-    serializeCookieType(encodeCookieType(data.scores)),
-    data.controlGroup ? "1" : "0",
-    serializePersonalizeVariants(data)
+    serializeCookieType(parts.tests),
+    serializeCookieType(parts.sessionScores),
+    serializeCookieType(parts.scores),
+    parts.controlGroup,
+    serializeCookieType(parts.personalizeVariants)
   ].join(TYPE_SEP);
 }
+function dropCandidates(parts, data) {
+  const dimensions = ["sessionScores", "scores"].flatMap(
+    (bucket, order) => Object.keys(parts[bucket]).map((key) => {
+      var _a;
+      return { bucket, key, order, score: (_a = data[bucket][key]) != null ? _a : 0 };
+    })
+  );
+  dimensions.sort(
+    (a, b) => Number(isZeroCookieScore(b.score)) - Number(isZeroCookieScore(a.score)) || a.score - b.score || a.order - b.order || (a.key < b.key ? -1 : 1)
+  );
+  const keysOf = (bucket) => Object.keys(parts[bucket]).sort().map((key) => ({ bucket, key }));
+  return [...dimensions, ...keysOf("personalizeVariants"), ...keysOf("tests")];
+}
+function minimumCookieBytes(cookieName) {
+  return encodeCookieName(cookieName).length + 6;
+}
+function encodeCookieName(name) {
+  return encodeURIComponent(name).replace(/%(2[346B]|5E|60|7C)/g, decodeURIComponent).replace(/\(/g, "%28").replace(/\)/g, "%29");
+}
 function serializePersonalizeVariants({
   personalizeVariants
 }) {
+  return serializeCookieType(encodePersonalizeVariants(personalizeVariants));
+}
+function encodePersonalizeVariants(personalizeVariants) {
   const data = {};
   if (typeof personalizeVariants === "object") {
     Object.keys(personalizeVariants).forEach((personalizationName) => {
@@ -1219,8 +1297,7 @@ function serializePersonalizeVariants({
       data[personalizationName] = results.join(",");
     });
   }
-  const serialized = serializeCookieType(data);
-  return serialized;
+  return data;
 }
 function decodePersonalizeVariants(data) {
   const parsed = parseCookieType(data);
@@ -1293,6 +1370,9 @@ fetchData_fn = async function() {
   }
 };
 
+// src/storage/util/systemDimension.ts
+var isSystemDimension = (dimension) => dimension.startsWith("$");
+
 // src/storage/linearDecay.ts
 function createLinearDecay(options) {
   const { gracePeriod = 864e5, decayRate = 1 / 30, decayCap = 0.95 } = options != null ? options : {};
@@ -1318,7 +1398,7 @@ function createLinearDecay(options) {
 }
 function decayVector(vector, decay) {
   for (const key in vector) {
-    if (key.startsWith("$")) {
+    if (isSystemDimension(key)) {
       continue;
     }
     vector[key] *= decay;
@@ -1462,7 +1542,7 @@ key_fn = function(key) {
 
 // src/storage/VisitorDataStore.ts
 var STORAGE_KEY = "ufvisitor";
-var _mitt2, _persist, _visitTimeout, _options, _VisitorDataStore_instances, currentData_get, replaceData_fn, setVisitTimeout_fn, isExpired_fn, handleCaps_fn, defaultData_fn;
+var _mitt2, _persist, _visitTimeout, _options, _VisitorDataStore_instances, currentData_get, replaceData_fn, setVisitTimeout_fn, isExpired_fn, handleCaps_fn, pruningManifest_get, handlePruning_fn, pruneScores_fn, defaultData_fn;
 var VisitorDataStore = class {
   constructor(options) {
     __privateAdd(this, _VisitorDataStore_instances);
@@ -1580,6 +1660,7 @@ replaceData_fn = function(data, quiet = false) {
     sessionScores: data.sessionScores,
     onLogMessage: __privateGet(this, _options).onLogMessage
   });
+  __privateMethod(this, _VisitorDataStore_instances, handlePruning_fn).call(this, data);
   const haveScoresChanged = !dequal4(oldData == null ? void 0 : oldData.visitorData.scores, data.scores);
   const haveSessionScoresChanged = !dequal4(oldData == null ? void 0 : oldData.visitorData.sessionScores, data.sessionScores);
   const haveQuirksChanged = !dequal4(oldData == null ? void 0 : oldData.visitorData.quirks, data.quirks);
@@ -1657,6 +1738,58 @@ handleCaps_fn = function(scores) {
     }
   }
 };
+pruningManifest_get = function() {
+  var _a, _b, _c, _d, _e;
+  const project = (_b = (_a = __privateGet(this, _options).manifest) == null ? void 0 : _a.data) == null ? void 0 : _b.project;
+  const populated = [(_c = project == null ? void 0 : project.pz) == null ? void 0 : _c.sig, (_d = project == null ? void 0 : project.pz) == null ? void 0 : _d.enr, (_e = project == null ? void 0 : project.pz) == null ? void 0 : _e.agg, project == null ? void 0 : project.test].some(
+    (definitions) => definitions && Object.keys(definitions).length > 0
+  );
+  return populated ? __privateGet(this, _options).manifest : void 0;
+};
+/**
+ * IMPORTANT: This function mutates the input data, as #replaceData does.
+ *
+ * Removes stored keys that the host has opted to stop carrying. The two manifest-driven
+ * prunes are skipped entirely when no populated manifest is loaded, so a partial load destroys
+ * nothing; zero-score pruning consults no manifest and always runs when enabled.
+ */
+handlePruning_fn = function(data) {
+  var _a, _b;
+  const { pruneUnknownTests, pruneUnknownDimensions } = __privateGet(this, _options);
+  const manifest = pruneUnknownTests || pruneUnknownDimensions ? __privateGet(this, _VisitorDataStore_instances, pruningManifest_get) : void 0;
+  const pruned = [];
+  if (pruneUnknownTests && manifest) {
+    for (const test in data.tests) {
+      if (!manifest.getTest(test)) {
+        delete data.tests[test];
+        pruned.push(`tests.${test}`);
+      }
+    }
+  }
+  __privateMethod(this, _VisitorDataStore_instances, pruneScores_fn).call(this, data.scores, "scores", pruned, manifest);
+  __privateMethod(this, _VisitorDataStore_instances, pruneScores_fn).call(this, data.sessionScores, "sessionScores", pruned, manifest);
+  if (pruned.length) {
+    (_b = (_a = __privateGet(this, _options)).onLogMessage) == null ? void 0 : _b.call(_a, ["info", 150, pruned]);
+  }
+};
+/**
+ * IMPORTANT: This function mutates the input scores.
+ */
+pruneScores_fn = function(scores, bucket, pruned, manifest) {
+  const { pruneUnknownDimensions, pruneZeroScores } = __privateGet(this, _options);
+  if (!pruneUnknownDimensions && !pruneZeroScores) {
+    return;
+  }
+  const pruneUnknown = pruneUnknownDimensions && manifest;
+  for (const dim in scores) {
+    const isUnknown = pruneUnknown && !isSystemDimension(dim) && !manifest.getDimensionByKey(dim);
+    const isZero = pruneZeroScores && (pruneZeroScores === "round" ? isZeroCookieScore(scores[dim]) : scores[dim] === 0);
+    if (isUnknown || isZero) {
+      delete scores[dim];
+      pruned.push(`${bucket}.${dim}`);
+    }
+  }
+};
 defaultData_fn = function() {
   var _a, _b, _c;
   return {
@@ -2388,6 +2521,13 @@ var messageContent = {
   ],
   131: () => ["storage", "server to client transition data was discarded"],
   140: (decayMessage) => ["storage", `score decay was applied: ${decayMessage}`],
+  150: (keys) => ["storage", `pruned from stored visitor data: ${keys.join(", ")}`],
+  151: ({ dropped, bytes, maxBytes }) => [
+    "storage",
+    `transition cookie exceeded its ${maxBytes} byte budget; dropped ${dropped.join(
+      ", "
+    )} to reach ${bytes} bytes`
+  ],
   // SIGNAL EVAL
   200: () => ["signals", "evaluating signals"],
   201: (signal) => ["signals", `evaluating signal ${signal.id} (${signal.dur})`],

package/dist/index.js

@@ -1166,11 +1166,14 @@ var bton = (base64) => {
   return sign ? -number : number;
 };
 
+// src/storage/util/zeroScore.ts
+var isZeroCookieScore = (score) => Math.abs(score) < 1;
+
 // src/storage/CookieTransitionDataStore.ts
 var ssr = typeof document === "undefined";
 var UNIFORM_DEFAULT_COOKIE_NAME = "ufvd";
 var UNIFORM_DEFAULT_QUIRK_COOKIE_NAME = `ufvdqk`;
-var _cookieName, _quirkCookieName, _cookieAttributes, _quirksEnabled;
+var _cookieName, _quirkCookieName, _cookieAttributes, _quirksEnabled, _maxBytes;
 var CookieTransitionDataStore = class extends TransitionDataStore {
   constructor({
     serverCookieValue,
@@ -1178,7 +1181,9 @@ var CookieTransitionDataStore = class extends TransitionDataStore {
     quirkCookieValue,
     quirkCookieName = UNIFORM_DEFAULT_QUIRK_COOKIE_NAME,
     cookieName = UNIFORM_DEFAULT_COOKIE_NAME,
-    cookieAttributes = { sameSite: "lax" }
+    cookieAttributes = { sameSite: "lax" },
+    maxBytes,
+    onLogMessage
   }) {
     super({
       initialData: ssr ? parseScoreCookie(serverCookieValue, experimental_quirksEnabled ? quirkCookieValue : void 0) : void 0
@@ -1187,10 +1192,21 @@ var CookieTransitionDataStore = class extends TransitionDataStore {
     __privateAdd(this, _quirkCookieName);
     __privateAdd(this, _cookieAttributes);
     __privateAdd(this, _quirksEnabled);
+    __privateAdd(this, _maxBytes);
+    /** Where the store's log messages go. See {@link CookieTransitionDataStoreOptions.onLogMessage}. */
+    __publicField(this, "onLogMessage");
     __privateSet(this, _cookieName, cookieName);
     __privateSet(this, _cookieAttributes, cookieAttributes);
     __privateSet(this, _quirkCookieName, quirkCookieName);
     __privateSet(this, _quirksEnabled, experimental_quirksEnabled || false);
+    __privateSet(this, _maxBytes, maxBytes);
+    this.onLogMessage = onLogMessage;
+    const minimumBytes = minimumCookieBytes(cookieName);
+    if (maxBytes !== void 0 && maxBytes < minimumBytes) {
+      throw new Error(
+        `maxBytes of ${maxBytes} is below the ${minimumBytes} bytes the "${cookieName}" cookie costs when it carries nothing but control group membership, so no visitor could ever meet it.`
+      );
+    }
   }
   handleDelete() {
     if (ssr) return Promise.resolve();
@@ -1200,7 +1216,15 @@ var CookieTransitionDataStore = class extends TransitionDataStore {
   async handleUpdateData(_, computedValue) {
     if (ssr) return;
     if (computedValue.consent) {
-      import_js_cookie.default.set(__privateGet(this, _cookieName), serializeCookie(computedValue), __privateGet(this, _cookieAttributes));
+      const cookieValue = serializeCookie(computedValue, {
+        maxBytes: __privateGet(this, _maxBytes),
+        cookieName: __privateGet(this, _cookieName),
+        onBudgetExceeded: (dropped, bytes, maxBytes) => {
+          var _a;
+          return (_a = this.onLogMessage) == null ? void 0 : _a.call(this, ["info", 151, { dropped, bytes, maxBytes }]);
+        }
+      });
+      import_js_cookie.default.set(__privateGet(this, _cookieName), cookieValue, __privateGet(this, _cookieAttributes));
       if (__privateGet(this, _quirksEnabled) && Object.keys(computedValue.quirks || {}).length) {
         const quirkCookieValue = serializeQuirks(computedValue.quirks || {});
         import_js_cookie.default.set(__privateGet(this, _quirkCookieName), quirkCookieValue, __privateGet(this, _cookieAttributes));
@@ -1217,6 +1241,7 @@ _cookieName = new WeakMap();
 _quirkCookieName = new WeakMap();
 _cookieAttributes = new WeakMap();
 _quirksEnabled = new WeakMap();
+_maxBytes = new WeakMap();
 var TYPE_SEP = "~";
 var PAIR_SEP = "!";
 var KV_SEP = "-";
@@ -1288,18 +1313,71 @@ function decodeCookieType(type) {
     return acc;
   }, {});
 }
-function serializeCookie(data) {
+function serializeCookie(data, options = {}) {
+  const { maxBytes, cookieName = UNIFORM_DEFAULT_COOKIE_NAME, onBudgetExceeded } = options;
+  const parts = {
+    tests: { ...data.tests },
+    sessionScores: encodeCookieType(data.sessionScores),
+    scores: encodeCookieType(data.scores),
+    controlGroup: data.controlGroup ? "1" : "0",
+    personalizeVariants: encodePersonalizeVariants(data.personalizeVariants)
+  };
+  let value = serializeCookieParts(parts);
+  if (maxBytes === void 0) {
+    return value;
+  }
+  const overhead = encodeCookieName(cookieName).length + 1;
+  const measure = () => overhead + import_js_cookie.default.converter.write(value, cookieName).length;
+  if (measure() <= maxBytes) {
+    return value;
+  }
+  const candidates = dropCandidates(parts, data);
+  const dropped = [];
+  for (let i = 0; i < candidates.length && measure() > maxBytes; i++) {
+    const { bucket, key } = candidates[i];
+    delete parts[bucket][key];
+    dropped.push(`${bucket}.${key}`);
+    value = serializeCookieParts(parts);
+  }
+  if (dropped.length) {
+    onBudgetExceeded == null ? void 0 : onBudgetExceeded(dropped, measure(), maxBytes);
+  }
+  return value;
+}
+function serializeCookieParts(parts) {
   return [
-    serializeCookieType(data.tests),
-    serializeCookieType(encodeCookieType(data.sessionScores)),
-    serializeCookieType(encodeCookieType(data.scores)),
-    data.controlGroup ? "1" : "0",
-    serializePersonalizeVariants(data)
+    serializeCookieType(parts.tests),
+    serializeCookieType(parts.sessionScores),
+    serializeCookieType(parts.scores),
+    parts.controlGroup,
+    serializeCookieType(parts.personalizeVariants)
   ].join(TYPE_SEP);
 }
+function dropCandidates(parts, data) {
+  const dimensions = ["sessionScores", "scores"].flatMap(
+    (bucket, order) => Object.keys(parts[bucket]).map((key) => {
+      var _a;
+      return { bucket, key, order, score: (_a = data[bucket][key]) != null ? _a : 0 };
+    })
+  );
+  dimensions.sort(
+    (a, b) => Number(isZeroCookieScore(b.score)) - Number(isZeroCookieScore(a.score)) || a.score - b.score || a.order - b.order || (a.key < b.key ? -1 : 1)
+  );
+  const keysOf = (bucket) => Object.keys(parts[bucket]).sort().map((key) => ({ bucket, key }));
+  return [...dimensions, ...keysOf("personalizeVariants"), ...keysOf("tests")];
+}
+function minimumCookieBytes(cookieName) {
+  return encodeCookieName(cookieName).length + 6;
+}
+function encodeCookieName(name) {
+  return encodeURIComponent(name).replace(/%(2[346B]|5E|60|7C)/g, decodeURIComponent).replace(/\(/g, "%28").replace(/\)/g, "%29");
+}
 function serializePersonalizeVariants({
   personalizeVariants
 }) {
+  return serializeCookieType(encodePersonalizeVariants(personalizeVariants));
+}
+function encodePersonalizeVariants(personalizeVariants) {
   const data = {};
   if (typeof personalizeVariants === "object") {
     Object.keys(personalizeVariants).forEach((personalizationName) => {
@@ -1311,8 +1389,7 @@ function serializePersonalizeVariants({
       data[personalizationName] = results.join(",");
     });
   }
-  const serialized = serializeCookieType(data);
-  return serialized;
+  return data;
 }
 function decodePersonalizeVariants(data) {
   const parsed = parseCookieType(data);
@@ -1385,6 +1462,9 @@ fetchData_fn = async function() {
   }
 };
 
+// src/storage/util/systemDimension.ts
+var isSystemDimension = (dimension) => dimension.startsWith("$");
+
 // src/storage/linearDecay.ts
 function createLinearDecay(options) {
   const { gracePeriod = 864e5, decayRate = 1 / 30, decayCap = 0.95 } = options != null ? options : {};
@@ -1410,7 +1490,7 @@ function createLinearDecay(options) {
 }
 function decayVector(vector, decay) {
   for (const key in vector) {
-    if (key.startsWith("$")) {
+    if (isSystemDimension(key)) {
       continue;
     }
     vector[key] *= decay;
@@ -1554,7 +1634,7 @@ key_fn = function(key) {
 
 // src/storage/VisitorDataStore.ts
 var STORAGE_KEY = "ufvisitor";
-var _mitt2, _persist, _visitTimeout, _options, _VisitorDataStore_instances, currentData_get, replaceData_fn, setVisitTimeout_fn, isExpired_fn, handleCaps_fn, defaultData_fn;
+var _mitt2, _persist, _visitTimeout, _options, _VisitorDataStore_instances, currentData_get, replaceData_fn, setVisitTimeout_fn, isExpired_fn, handleCaps_fn, pruningManifest_get, handlePruning_fn, pruneScores_fn, defaultData_fn;
 var VisitorDataStore = class {
   constructor(options) {
     __privateAdd(this, _VisitorDataStore_instances);
@@ -1672,6 +1752,7 @@ replaceData_fn = function(data, quiet = false) {
     sessionScores: data.sessionScores,
     onLogMessage: __privateGet(this, _options).onLogMessage
   });
+  __privateMethod(this, _VisitorDataStore_instances, handlePruning_fn).call(this, data);
   const haveScoresChanged = !(0, import_lite4.dequal)(oldData == null ? void 0 : oldData.visitorData.scores, data.scores);
   const haveSessionScoresChanged = !(0, import_lite4.dequal)(oldData == null ? void 0 : oldData.visitorData.sessionScores, data.sessionScores);
   const haveQuirksChanged = !(0, import_lite4.dequal)(oldData == null ? void 0 : oldData.visitorData.quirks, data.quirks);
@@ -1749,6 +1830,58 @@ handleCaps_fn = function(scores) {
     }
   }
 };
+pruningManifest_get = function() {
+  var _a, _b, _c, _d, _e;
+  const project = (_b = (_a = __privateGet(this, _options).manifest) == null ? void 0 : _a.data) == null ? void 0 : _b.project;
+  const populated = [(_c = project == null ? void 0 : project.pz) == null ? void 0 : _c.sig, (_d = project == null ? void 0 : project.pz) == null ? void 0 : _d.enr, (_e = project == null ? void 0 : project.pz) == null ? void 0 : _e.agg, project == null ? void 0 : project.test].some(
+    (definitions) => definitions && Object.keys(definitions).length > 0
+  );
+  return populated ? __privateGet(this, _options).manifest : void 0;
+};
+/**
+ * IMPORTANT: This function mutates the input data, as #replaceData does.
+ *
+ * Removes stored keys that the host has opted to stop carrying. The two manifest-driven
+ * prunes are skipped entirely when no populated manifest is loaded, so a partial load destroys
+ * nothing; zero-score pruning consults no manifest and always runs when enabled.
+ */
+handlePruning_fn = function(data) {
+  var _a, _b;
+  const { pruneUnknownTests, pruneUnknownDimensions } = __privateGet(this, _options);
+  const manifest = pruneUnknownTests || pruneUnknownDimensions ? __privateGet(this, _VisitorDataStore_instances, pruningManifest_get) : void 0;
+  const pruned = [];
+  if (pruneUnknownTests && manifest) {
+    for (const test in data.tests) {
+      if (!manifest.getTest(test)) {
+        delete data.tests[test];
+        pruned.push(`tests.${test}`);
+      }
+    }
+  }
+  __privateMethod(this, _VisitorDataStore_instances, pruneScores_fn).call(this, data.scores, "scores", pruned, manifest);
+  __privateMethod(this, _VisitorDataStore_instances, pruneScores_fn).call(this, data.sessionScores, "sessionScores", pruned, manifest);
+  if (pruned.length) {
+    (_b = (_a = __privateGet(this, _options)).onLogMessage) == null ? void 0 : _b.call(_a, ["info", 150, pruned]);
+  }
+};
+/**
+ * IMPORTANT: This function mutates the input scores.
+ */
+pruneScores_fn = function(scores, bucket, pruned, manifest) {
+  const { pruneUnknownDimensions, pruneZeroScores } = __privateGet(this, _options);
+  if (!pruneUnknownDimensions && !pruneZeroScores) {
+    return;
+  }
+  const pruneUnknown = pruneUnknownDimensions && manifest;
+  for (const dim in scores) {
+    const isUnknown = pruneUnknown && !isSystemDimension(dim) && !manifest.getDimensionByKey(dim);
+    const isZero = pruneZeroScores && (pruneZeroScores === "round" ? isZeroCookieScore(scores[dim]) : scores[dim] === 0);
+    if (isUnknown || isZero) {
+      delete scores[dim];
+      pruned.push(`${bucket}.${dim}`);
+    }
+  }
+};
 defaultData_fn = function() {
   var _a, _b, _c;
   return {
@@ -2480,6 +2613,13 @@ var messageContent = {
   ],
   131: () => ["storage", "server to client transition data was discarded"],
   140: (decayMessage) => ["storage", `score decay was applied: ${decayMessage}`],
+  150: (keys) => ["storage", `pruned from stored visitor data: ${keys.join(", ")}`],
+  151: ({ dropped, bytes, maxBytes }) => [
+    "storage",
+    `transition cookie exceeded its ${maxBytes} byte budget; dropped ${dropped.join(
+      ", "
+    )} to reach ${bytes} bytes`
+  ],
   // SIGNAL EVAL
   200: () => ["signals", "evaluating signals"],
   201: (signal) => ["signals", `evaluating signal ${signal.id} (${signal.dur})`],

package/dist/index.mjs

@@ -1074,11 +1074,14 @@ var bton = (base64) => {
   return sign ? -number : number;
 };
 
+// src/storage/util/zeroScore.ts
+var isZeroCookieScore = (score) => Math.abs(score) < 1;
+
 // src/storage/CookieTransitionDataStore.ts
 var ssr = typeof document === "undefined";
 var UNIFORM_DEFAULT_COOKIE_NAME = "ufvd";
 var UNIFORM_DEFAULT_QUIRK_COOKIE_NAME = `ufvdqk`;
-var _cookieName, _quirkCookieName, _cookieAttributes, _quirksEnabled;
+var _cookieName, _quirkCookieName, _cookieAttributes, _quirksEnabled, _maxBytes;
 var CookieTransitionDataStore = class extends TransitionDataStore {
   constructor({
     serverCookieValue,
@@ -1086,7 +1089,9 @@ var CookieTransitionDataStore = class extends TransitionDataStore {
     quirkCookieValue,
     quirkCookieName = UNIFORM_DEFAULT_QUIRK_COOKIE_NAME,
     cookieName = UNIFORM_DEFAULT_COOKIE_NAME,
-    cookieAttributes = { sameSite: "lax" }
+    cookieAttributes = { sameSite: "lax" },
+    maxBytes,
+    onLogMessage
   }) {
     super({
       initialData: ssr ? parseScoreCookie(serverCookieValue, experimental_quirksEnabled ? quirkCookieValue : void 0) : void 0
@@ -1095,10 +1100,21 @@ var CookieTransitionDataStore = class extends TransitionDataStore {
     __privateAdd(this, _quirkCookieName);
     __privateAdd(this, _cookieAttributes);
     __privateAdd(this, _quirksEnabled);
+    __privateAdd(this, _maxBytes);
+    /** Where the store's log messages go. See {@link CookieTransitionDataStoreOptions.onLogMessage}. */
+    __publicField(this, "onLogMessage");
     __privateSet(this, _cookieName, cookieName);
     __privateSet(this, _cookieAttributes, cookieAttributes);
     __privateSet(this, _quirkCookieName, quirkCookieName);
     __privateSet(this, _quirksEnabled, experimental_quirksEnabled || false);
+    __privateSet(this, _maxBytes, maxBytes);
+    this.onLogMessage = onLogMessage;
+    const minimumBytes = minimumCookieBytes(cookieName);
+    if (maxBytes !== void 0 && maxBytes < minimumBytes) {
+      throw new Error(
+        `maxBytes of ${maxBytes} is below the ${minimumBytes} bytes the "${cookieName}" cookie costs when it carries nothing but control group membership, so no visitor could ever meet it.`
+      );
+    }
   }
   handleDelete() {
     if (ssr) return Promise.resolve();
@@ -1108,7 +1124,15 @@ var CookieTransitionDataStore = class extends TransitionDataStore {
   async handleUpdateData(_, computedValue) {
     if (ssr) return;
     if (computedValue.consent) {
-      Cookies.set(__privateGet(this, _cookieName), serializeCookie(computedValue), __privateGet(this, _cookieAttributes));
+      const cookieValue = serializeCookie(computedValue, {
+        maxBytes: __privateGet(this, _maxBytes),
+        cookieName: __privateGet(this, _cookieName),
+        onBudgetExceeded: (dropped, bytes, maxBytes) => {
+          var _a;
+          return (_a = this.onLogMessage) == null ? void 0 : _a.call(this, ["info", 151, { dropped, bytes, maxBytes }]);
+        }
+      });
+      Cookies.set(__privateGet(this, _cookieName), cookieValue, __privateGet(this, _cookieAttributes));
       if (__privateGet(this, _quirksEnabled) && Object.keys(computedValue.quirks || {}).length) {
         const quirkCookieValue = serializeQuirks(computedValue.quirks || {});
         Cookies.set(__privateGet(this, _quirkCookieName), quirkCookieValue, __privateGet(this, _cookieAttributes));
@@ -1125,6 +1149,7 @@ _cookieName = new WeakMap();
 _quirkCookieName = new WeakMap();
 _cookieAttributes = new WeakMap();
 _quirksEnabled = new WeakMap();
+_maxBytes = new WeakMap();
 var TYPE_SEP = "~";
 var PAIR_SEP = "!";
 var KV_SEP = "-";
@@ -1196,18 +1221,71 @@ function decodeCookieType(type) {
     return acc;
   }, {});
 }
-function serializeCookie(data) {
+function serializeCookie(data, options = {}) {
+  const { maxBytes, cookieName = UNIFORM_DEFAULT_COOKIE_NAME, onBudgetExceeded } = options;
+  const parts = {
+    tests: { ...data.tests },
+    sessionScores: encodeCookieType(data.sessionScores),
+    scores: encodeCookieType(data.scores),
+    controlGroup: data.controlGroup ? "1" : "0",
+    personalizeVariants: encodePersonalizeVariants(data.personalizeVariants)
+  };
+  let value = serializeCookieParts(parts);
+  if (maxBytes === void 0) {
+    return value;
+  }
+  const overhead = encodeCookieName(cookieName).length + 1;
+  const measure = () => overhead + Cookies.converter.write(value, cookieName).length;
+  if (measure() <= maxBytes) {
+    return value;
+  }
+  const candidates = dropCandidates(parts, data);
+  const dropped = [];
+  for (let i = 0; i < candidates.length && measure() > maxBytes; i++) {
+    const { bucket, key } = candidates[i];
+    delete parts[bucket][key];
+    dropped.push(`${bucket}.${key}`);
+    value = serializeCookieParts(parts);
+  }
+  if (dropped.length) {
+    onBudgetExceeded == null ? void 0 : onBudgetExceeded(dropped, measure(), maxBytes);
+  }
+  return value;
+}
+function serializeCookieParts(parts) {
   return [
-    serializeCookieType(data.tests),
-    serializeCookieType(encodeCookieType(data.sessionScores)),
-    serializeCookieType(encodeCookieType(data.scores)),
-    data.controlGroup ? "1" : "0",
-    serializePersonalizeVariants(data)
+    serializeCookieType(parts.tests),
+    serializeCookieType(parts.sessionScores),
+    serializeCookieType(parts.scores),
+    parts.controlGroup,
+    serializeCookieType(parts.personalizeVariants)
   ].join(TYPE_SEP);
 }
+function dropCandidates(parts, data) {
+  const dimensions = ["sessionScores", "scores"].flatMap(
+    (bucket, order) => Object.keys(parts[bucket]).map((key) => {
+      var _a;
+      return { bucket, key, order, score: (_a = data[bucket][key]) != null ? _a : 0 };
+    })
+  );
+  dimensions.sort(
+    (a, b) => Number(isZeroCookieScore(b.score)) - Number(isZeroCookieScore(a.score)) || a.score - b.score || a.order - b.order || (a.key < b.key ? -1 : 1)
+  );
+  const keysOf = (bucket) => Object.keys(parts[bucket]).sort().map((key) => ({ bucket, key }));
+  return [...dimensions, ...keysOf("personalizeVariants"), ...keysOf("tests")];
+}
+function minimumCookieBytes(cookieName) {
+  return encodeCookieName(cookieName).length + 6;
+}
+function encodeCookieName(name) {
+  return encodeURIComponent(name).replace(/%(2[346B]|5E|60|7C)/g, decodeURIComponent).replace(/\(/g, "%28").replace(/\)/g, "%29");
+}
 function serializePersonalizeVariants({
   personalizeVariants
 }) {
+  return serializeCookieType(encodePersonalizeVariants(personalizeVariants));
+}
+function encodePersonalizeVariants(personalizeVariants) {
   const data = {};
   if (typeof personalizeVariants === "object") {
     Object.keys(personalizeVariants).forEach((personalizationName) => {
@@ -1219,8 +1297,7 @@ function serializePersonalizeVariants({
       data[personalizationName] = results.join(",");
     });
   }
-  const serialized = serializeCookieType(data);
-  return serialized;
+  return data;
 }
 function decodePersonalizeVariants(data) {
   const parsed = parseCookieType(data);
@@ -1293,6 +1370,9 @@ fetchData_fn = async function() {
   }
 };
 
+// src/storage/util/systemDimension.ts
+var isSystemDimension = (dimension) => dimension.startsWith("$");
+
 // src/storage/linearDecay.ts
 function createLinearDecay(options) {
   const { gracePeriod = 864e5, decayRate = 1 / 30, decayCap = 0.95 } = options != null ? options : {};
@@ -1318,7 +1398,7 @@ function createLinearDecay(options) {
 }
 function decayVector(vector, decay) {
   for (const key in vector) {
-    if (key.startsWith("$")) {
+    if (isSystemDimension(key)) {
       continue;
     }
     vector[key] *= decay;
@@ -1462,7 +1542,7 @@ key_fn = function(key) {
 
 // src/storage/VisitorDataStore.ts
 var STORAGE_KEY = "ufvisitor";
-var _mitt2, _persist, _visitTimeout, _options, _VisitorDataStore_instances, currentData_get, replaceData_fn, setVisitTimeout_fn, isExpired_fn, handleCaps_fn, defaultData_fn;
+var _mitt2, _persist, _visitTimeout, _options, _VisitorDataStore_instances, currentData_get, replaceData_fn, setVisitTimeout_fn, isExpired_fn, handleCaps_fn, pruningManifest_get, handlePruning_fn, pruneScores_fn, defaultData_fn;
 var VisitorDataStore = class {
   constructor(options) {
     __privateAdd(this, _VisitorDataStore_instances);
@@ -1580,6 +1660,7 @@ replaceData_fn = function(data, quiet = false) {
     sessionScores: data.sessionScores,
     onLogMessage: __privateGet(this, _options).onLogMessage
   });
+  __privateMethod(this, _VisitorDataStore_instances, handlePruning_fn).call(this, data);
   const haveScoresChanged = !dequal4(oldData == null ? void 0 : oldData.visitorData.scores, data.scores);
   const haveSessionScoresChanged = !dequal4(oldData == null ? void 0 : oldData.visitorData.sessionScores, data.sessionScores);
   const haveQuirksChanged = !dequal4(oldData == null ? void 0 : oldData.visitorData.quirks, data.quirks);
@@ -1657,6 +1738,58 @@ handleCaps_fn = function(scores) {
     }
   }
 };
+pruningManifest_get = function() {
+  var _a, _b, _c, _d, _e;
+  const project = (_b = (_a = __privateGet(this, _options).manifest) == null ? void 0 : _a.data) == null ? void 0 : _b.project;
+  const populated = [(_c = project == null ? void 0 : project.pz) == null ? void 0 : _c.sig, (_d = project == null ? void 0 : project.pz) == null ? void 0 : _d.enr, (_e = project == null ? void 0 : project.pz) == null ? void 0 : _e.agg, project == null ? void 0 : project.test].some(
+    (definitions) => definitions && Object.keys(definitions).length > 0
+  );
+  return populated ? __privateGet(this, _options).manifest : void 0;
+};
+/**
+ * IMPORTANT: This function mutates the input data, as #replaceData does.
+ *
+ * Removes stored keys that the host has opted to stop carrying. The two manifest-driven
+ * prunes are skipped entirely when no populated manifest is loaded, so a partial load destroys
+ * nothing; zero-score pruning consults no manifest and always runs when enabled.
+ */
+handlePruning_fn = function(data) {
+  var _a, _b;
+  const { pruneUnknownTests, pruneUnknownDimensions } = __privateGet(this, _options);
+  const manifest = pruneUnknownTests || pruneUnknownDimensions ? __privateGet(this, _VisitorDataStore_instances, pruningManifest_get) : void 0;
+  const pruned = [];
+  if (pruneUnknownTests && manifest) {
+    for (const test in data.tests) {
+      if (!manifest.getTest(test)) {
+        delete data.tests[test];
+        pruned.push(`tests.${test}`);
+      }
+    }
+  }
+  __privateMethod(this, _VisitorDataStore_instances, pruneScores_fn).call(this, data.scores, "scores", pruned, manifest);
+  __privateMethod(this, _VisitorDataStore_instances, pruneScores_fn).call(this, data.sessionScores, "sessionScores", pruned, manifest);
+  if (pruned.length) {
+    (_b = (_a = __privateGet(this, _options)).onLogMessage) == null ? void 0 : _b.call(_a, ["info", 150, pruned]);
+  }
+};
+/**
+ * IMPORTANT: This function mutates the input scores.
+ */
+pruneScores_fn = function(scores, bucket, pruned, manifest) {
+  const { pruneUnknownDimensions, pruneZeroScores } = __privateGet(this, _options);
+  if (!pruneUnknownDimensions && !pruneZeroScores) {
+    return;
+  }
+  const pruneUnknown = pruneUnknownDimensions && manifest;
+  for (const dim in scores) {
+    const isUnknown = pruneUnknown && !isSystemDimension(dim) && !manifest.getDimensionByKey(dim);
+    const isZero = pruneZeroScores && (pruneZeroScores === "round" ? isZeroCookieScore(scores[dim]) : scores[dim] === 0);
+    if (isUnknown || isZero) {
+      delete scores[dim];
+      pruned.push(`${bucket}.${dim}`);
+    }
+  }
+};
 defaultData_fn = function() {
   var _a, _b, _c;
   return {
@@ -2388,6 +2521,13 @@ var messageContent = {
   ],
   131: () => ["storage", "server to client transition data was discarded"],
   140: (decayMessage) => ["storage", `score decay was applied: ${decayMessage}`],
+  150: (keys) => ["storage", `pruned from stored visitor data: ${keys.join(", ")}`],
+  151: ({ dropped, bytes, maxBytes }) => [
+    "storage",
+    `transition cookie exceeded its ${maxBytes} byte budget; dropped ${dropped.join(
+      ", "
+    )} to reach ${bytes} bytes`
+  ],
   // SIGNAL EVAL
   200: () => ["signals", "evaluating signals"],
   201: (signal) => ["signals", `evaluating signal ${signal.id} (${signal.dur})`],

package/dist/{types-DovaM4gV.d.mts → types-p9vnD820.d.mts}

@@ -666,6 +666,41 @@ type VisitorDataStoreOptions = {
      * Only required if using multiple Context instances on the same domain and need to separate them.
      */
     partitionKey?: string;
+    /**
+     * Removes stored A/B test assignments for tests that are no longer in the manifest.
+     * Does nothing until a manifest with contents is loaded - an empty manifest is read as a
+     * manifest that did not load, not as a project that deleted everything - so a partial or
+     * failed load cannot destroy anything. Pruning is irreversible.
+     *
+     * @defaultValue false
+     */
+    pruneUnknownTests?: boolean;
+    /**
+     * Removes stored dimensions that are no longer in the manifest - a signal whose key is gone,
+     * or an enrichment whose category is gone. Dimensions Uniform writes itself, whose keys begin
+     * with `$`, are kept: they are never in the manifest.
+     * Does nothing until a manifest with contents is loaded - an empty manifest is read as a
+     * manifest that did not load, not as a project that deleted everything - so a partial or
+     * failed load cannot destroy anything. Pruning is irreversible.
+     *
+     * @defaultValue false
+     */
+    pruneUnknownDimensions?: boolean;
+    /**
+     * Removes stored dimensions whose score is zero. Pruning is irreversible.
+     *
+     * `true` removes a score of exactly zero. A decayed 0.6 is real data on the client, so it stays.
+     *
+     * `'round'` also removes any score whose magnitude is below 1, negatives included - every score
+     * the transition cookie would write as zero - so the cookie and local storage hold the same keys.
+     *
+     * Note that the weakest-dimension personalization operator is affected by pruning zeros, since a
+     * pruned dimension is no longer a candidate for it. Every other operator reads an absent
+     * dimension as zero, which is what it was.
+     *
+     * @defaultValue false
+     */
+    pruneZeroScores?: boolean | 'round';
 };
 type VisitorDataStoreEvents = {
     /**
@@ -846,6 +881,14 @@ type LogMessages = {
     131: MessageFunc;
     /** Decay function executed */
     140: MessageFunc<string>;
+    /** Keys were pruned from the stored visitor data */
+    150: MessageFunc<string[]>;
+    /** Transition cookie did not fit its byte budget, so data was dropped from it */
+    151: MessageFunc<{
+        dropped: string[];
+        bytes: number;
+        maxBytes: number;
+    }>;
     /** Signals evaluation beginning */
     200: MessageFunc;
     /** Evaluation of a specific signal beginning */
@@ -1396,4 +1439,4 @@ declare global {
     }
 }
 
-export { GroupCriteriaEvaluator as $, type AggregateDimension as A, type BehaviorTag as B, type ContextPlugin as C, type DecayFunction as D, type DevToolsDataEvent as E, type DevToolsEvent as F, type DevToolsForgetEvent as G, type DevToolsHelloEvent as H, type DevToolsLogEvent as I, type DevToolsRawCommandsEvent as J, type DevToolsState as K, type LogDrain as L, type ManifestV2 as M, type DevToolsUiVersion as N, type OutputSeverity as O, type PersonalizedVariant as P, type Quirks as Q, type DevToolsUpdateEvent as R, type ScoreVector as S, TransitionDataStore as T, type DimensionMatch as U, type VisitorData as V, type EnrichmentCategory as W, type EnrichmentData as X, type EventData as Y, type GoalStateUpdate as Z, type Goals as _, type StorageCommands as a, type IdentifyCommand as a0, type LogMessageGroup as a1, type LogMessageSingle as a2, type LogMessages as a3, ManifestInstance as a4, type MessageCategory as a5, type MessageFunc as a6, type ModifyScoreCommand as a7, type ModifySessionScoreCommand as a8, type NumberMatch as a9, type TestVariant as aA, type Tests as aB, type TransitionDataStoreEvents as aC, type VariationMatchMetadata as aD, VisitorDataStore as aE, type VisitorDataStoreEvents as aF, type VisitorDataStoreOptions as aG, areCommandsEqual as aH, emptyVisitorData as aI, testVariations as aJ, type PersonalizationEvent as aa, type PersonalizationEventVariantId as ab, type PersonalizationManifest as ac, type PersonalizationSelectionAlgorithm as ad, type PersonalizationSelectionAlgorithms as ae, type PersonalizeControlVariant as af, type PersonalizeVariants as ag, type QuirkMatch as ah, SERVER_STATE_ID as ai, type ServerToClientTransitionState as aj, type SetConsentCommand as ak, type SetControlGroupCommand as al, type SetGoalCommand as am, type SetPersonalizeVariantControlCommand as an, type SetQuirkCommand as ao, type SetTestCommand as ap, type Severity as aq, type Signal as ar, type SignalCriteria as as, type SignalCriteriaGroup as at, type SignalData as au, type StorageCommand as av, type TestDefinition as aw, type TestEvent as ax, type TestOptions as ay, type TestResult as az, type TransitionDataStoreOptions as b, type CriteriaEvaluator as c, type StringMatch as d, type VariantMatchCriteria as e, type LogMessage as f, type PersonalizeOptions as g, Context as h, type PersonalizedResult as i, type VariationMatchDimensionCriteria as j, type PersonalizationSelectionAlgorithmOptions as k, type DevToolsEvents as l, type AggregateDimensionInput as m, CONTEXTUAL_EDITING_TEST_NAME as n, CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID as o, type paths as p, type CompositionMetadata as q, type ContextEvents as r, type ContextInstance as s, type ContextOptions as t, type ContextState as u, type ContextStateUpdate as v, type CriteriaEvaluatorParameters as w, type CriteriaEvaluatorResult as x, type DecayOptions as y, type DevToolsActions as z };
+export { GroupCriteriaEvaluator as $, type AggregateDimension as A, type BehaviorTag as B, type ContextPlugin as C, type DecayFunction as D, type DevToolsDataEvent as E, type DevToolsEvent as F, type DevToolsForgetEvent as G, type DevToolsHelloEvent as H, type DevToolsLogEvent as I, type DevToolsRawCommandsEvent as J, type DevToolsState as K, type LogDrain as L, type ManifestV2 as M, type DevToolsUiVersion as N, type OutputSeverity as O, type PersonalizedVariant as P, type Quirks as Q, type DevToolsUpdateEvent as R, type ScoreVector as S, TransitionDataStore as T, type DimensionMatch as U, type VisitorData as V, type EnrichmentCategory as W, type EnrichmentData as X, type EventData as Y, type GoalStateUpdate as Z, type Goals as _, type LogMessage as a, type IdentifyCommand as a0, type LogMessageGroup as a1, type LogMessageSingle as a2, type LogMessages as a3, ManifestInstance as a4, type MessageCategory as a5, type MessageFunc as a6, type ModifyScoreCommand as a7, type ModifySessionScoreCommand as a8, type NumberMatch as a9, type TestVariant as aA, type Tests as aB, type TransitionDataStoreEvents as aC, type VariationMatchMetadata as aD, VisitorDataStore as aE, type VisitorDataStoreEvents as aF, type VisitorDataStoreOptions as aG, areCommandsEqual as aH, emptyVisitorData as aI, testVariations as aJ, type PersonalizationEvent as aa, type PersonalizationEventVariantId as ab, type PersonalizationManifest as ac, type PersonalizationSelectionAlgorithm as ad, type PersonalizationSelectionAlgorithms as ae, type PersonalizeControlVariant as af, type PersonalizeVariants as ag, type QuirkMatch as ah, SERVER_STATE_ID as ai, type ServerToClientTransitionState as aj, type SetConsentCommand as ak, type SetControlGroupCommand as al, type SetGoalCommand as am, type SetPersonalizeVariantControlCommand as an, type SetQuirkCommand as ao, type SetTestCommand as ap, type Severity as aq, type Signal as ar, type SignalCriteria as as, type SignalCriteriaGroup as at, type SignalData as au, type StorageCommand as av, type TestDefinition as aw, type TestEvent as ax, type TestOptions as ay, type TestResult as az, type StorageCommands as b, type TransitionDataStoreOptions as c, type CriteriaEvaluator as d, type StringMatch as e, type VariantMatchCriteria as f, type PersonalizeOptions as g, Context as h, type PersonalizedResult as i, type VariationMatchDimensionCriteria as j, type PersonalizationSelectionAlgorithmOptions as k, type DevToolsEvents as l, type AggregateDimensionInput as m, CONTEXTUAL_EDITING_TEST_NAME as n, CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID as o, type paths as p, type CompositionMetadata as q, type ContextEvents as r, type ContextInstance as s, type ContextOptions as t, type ContextState as u, type ContextStateUpdate as v, type CriteriaEvaluatorParameters as w, type CriteriaEvaluatorResult as x, type DecayOptions as y, type DevToolsActions as z };

package/dist/{types-DovaM4gV.d.ts → types-p9vnD820.d.ts}

@@ -666,6 +666,41 @@ type VisitorDataStoreOptions = {
      * Only required if using multiple Context instances on the same domain and need to separate them.
      */
     partitionKey?: string;
+    /**
+     * Removes stored A/B test assignments for tests that are no longer in the manifest.
+     * Does nothing until a manifest with contents is loaded - an empty manifest is read as a
+     * manifest that did not load, not as a project that deleted everything - so a partial or
+     * failed load cannot destroy anything. Pruning is irreversible.
+     *
+     * @defaultValue false
+     */
+    pruneUnknownTests?: boolean;
+    /**
+     * Removes stored dimensions that are no longer in the manifest - a signal whose key is gone,
+     * or an enrichment whose category is gone. Dimensions Uniform writes itself, whose keys begin
+     * with `$`, are kept: they are never in the manifest.
+     * Does nothing until a manifest with contents is loaded - an empty manifest is read as a
+     * manifest that did not load, not as a project that deleted everything - so a partial or
+     * failed load cannot destroy anything. Pruning is irreversible.
+     *
+     * @defaultValue false
+     */
+    pruneUnknownDimensions?: boolean;
+    /**
+     * Removes stored dimensions whose score is zero. Pruning is irreversible.
+     *
+     * `true` removes a score of exactly zero. A decayed 0.6 is real data on the client, so it stays.
+     *
+     * `'round'` also removes any score whose magnitude is below 1, negatives included - every score
+     * the transition cookie would write as zero - so the cookie and local storage hold the same keys.
+     *
+     * Note that the weakest-dimension personalization operator is affected by pruning zeros, since a
+     * pruned dimension is no longer a candidate for it. Every other operator reads an absent
+     * dimension as zero, which is what it was.
+     *
+     * @defaultValue false
+     */
+    pruneZeroScores?: boolean | 'round';
 };
 type VisitorDataStoreEvents = {
     /**
@@ -846,6 +881,14 @@ type LogMessages = {
     131: MessageFunc;
     /** Decay function executed */
     140: MessageFunc<string>;
+    /** Keys were pruned from the stored visitor data */
+    150: MessageFunc<string[]>;
+    /** Transition cookie did not fit its byte budget, so data was dropped from it */
+    151: MessageFunc<{
+        dropped: string[];
+        bytes: number;
+        maxBytes: number;
+    }>;
     /** Signals evaluation beginning */
     200: MessageFunc;
     /** Evaluation of a specific signal beginning */
@@ -1396,4 +1439,4 @@ declare global {
     }
 }
 
-export { GroupCriteriaEvaluator as $, type AggregateDimension as A, type BehaviorTag as B, type ContextPlugin as C, type DecayFunction as D, type DevToolsDataEvent as E, type DevToolsEvent as F, type DevToolsForgetEvent as G, type DevToolsHelloEvent as H, type DevToolsLogEvent as I, type DevToolsRawCommandsEvent as J, type DevToolsState as K, type LogDrain as L, type ManifestV2 as M, type DevToolsUiVersion as N, type OutputSeverity as O, type PersonalizedVariant as P, type Quirks as Q, type DevToolsUpdateEvent as R, type ScoreVector as S, TransitionDataStore as T, type DimensionMatch as U, type VisitorData as V, type EnrichmentCategory as W, type EnrichmentData as X, type EventData as Y, type GoalStateUpdate as Z, type Goals as _, type StorageCommands as a, type IdentifyCommand as a0, type LogMessageGroup as a1, type LogMessageSingle as a2, type LogMessages as a3, ManifestInstance as a4, type MessageCategory as a5, type MessageFunc as a6, type ModifyScoreCommand as a7, type ModifySessionScoreCommand as a8, type NumberMatch as a9, type TestVariant as aA, type Tests as aB, type TransitionDataStoreEvents as aC, type VariationMatchMetadata as aD, VisitorDataStore as aE, type VisitorDataStoreEvents as aF, type VisitorDataStoreOptions as aG, areCommandsEqual as aH, emptyVisitorData as aI, testVariations as aJ, type PersonalizationEvent as aa, type PersonalizationEventVariantId as ab, type PersonalizationManifest as ac, type PersonalizationSelectionAlgorithm as ad, type PersonalizationSelectionAlgorithms as ae, type PersonalizeControlVariant as af, type PersonalizeVariants as ag, type QuirkMatch as ah, SERVER_STATE_ID as ai, type ServerToClientTransitionState as aj, type SetConsentCommand as ak, type SetControlGroupCommand as al, type SetGoalCommand as am, type SetPersonalizeVariantControlCommand as an, type SetQuirkCommand as ao, type SetTestCommand as ap, type Severity as aq, type Signal as ar, type SignalCriteria as as, type SignalCriteriaGroup as at, type SignalData as au, type StorageCommand as av, type TestDefinition as aw, type TestEvent as ax, type TestOptions as ay, type TestResult as az, type TransitionDataStoreOptions as b, type CriteriaEvaluator as c, type StringMatch as d, type VariantMatchCriteria as e, type LogMessage as f, type PersonalizeOptions as g, Context as h, type PersonalizedResult as i, type VariationMatchDimensionCriteria as j, type PersonalizationSelectionAlgorithmOptions as k, type DevToolsEvents as l, type AggregateDimensionInput as m, CONTEXTUAL_EDITING_TEST_NAME as n, CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID as o, type paths as p, type CompositionMetadata as q, type ContextEvents as r, type ContextInstance as s, type ContextOptions as t, type ContextState as u, type ContextStateUpdate as v, type CriteriaEvaluatorParameters as w, type CriteriaEvaluatorResult as x, type DecayOptions as y, type DevToolsActions as z };
+export { GroupCriteriaEvaluator as $, type AggregateDimension as A, type BehaviorTag as B, type ContextPlugin as C, type DecayFunction as D, type DevToolsDataEvent as E, type DevToolsEvent as F, type DevToolsForgetEvent as G, type DevToolsHelloEvent as H, type DevToolsLogEvent as I, type DevToolsRawCommandsEvent as J, type DevToolsState as K, type LogDrain as L, type ManifestV2 as M, type DevToolsUiVersion as N, type OutputSeverity as O, type PersonalizedVariant as P, type Quirks as Q, type DevToolsUpdateEvent as R, type ScoreVector as S, TransitionDataStore as T, type DimensionMatch as U, type VisitorData as V, type EnrichmentCategory as W, type EnrichmentData as X, type EventData as Y, type GoalStateUpdate as Z, type Goals as _, type LogMessage as a, type IdentifyCommand as a0, type LogMessageGroup as a1, type LogMessageSingle as a2, type LogMessages as a3, ManifestInstance as a4, type MessageCategory as a5, type MessageFunc as a6, type ModifyScoreCommand as a7, type ModifySessionScoreCommand as a8, type NumberMatch as a9, type TestVariant as aA, type Tests as aB, type TransitionDataStoreEvents as aC, type VariationMatchMetadata as aD, VisitorDataStore as aE, type VisitorDataStoreEvents as aF, type VisitorDataStoreOptions as aG, areCommandsEqual as aH, emptyVisitorData as aI, testVariations as aJ, type PersonalizationEvent as aa, type PersonalizationEventVariantId as ab, type PersonalizationManifest as ac, type PersonalizationSelectionAlgorithm as ad, type PersonalizationSelectionAlgorithms as ae, type PersonalizeControlVariant as af, type PersonalizeVariants as ag, type QuirkMatch as ah, SERVER_STATE_ID as ai, type ServerToClientTransitionState as aj, type SetConsentCommand as ak, type SetControlGroupCommand as al, type SetGoalCommand as am, type SetPersonalizeVariantControlCommand as an, type SetQuirkCommand as ao, type SetTestCommand as ap, type Severity as aq, type Signal as ar, type SignalCriteria as as, type SignalCriteriaGroup as at, type SignalData as au, type StorageCommand as av, type TestDefinition as aw, type TestEvent as ax, type TestOptions as ay, type TestResult as az, type StorageCommands as b, type TransitionDataStoreOptions as c, type CriteriaEvaluator as d, type StringMatch as e, type VariantMatchCriteria as f, type PersonalizeOptions as g, Context as h, type PersonalizedResult as i, type VariationMatchDimensionCriteria as j, type PersonalizationSelectionAlgorithmOptions as k, type DevToolsEvents as l, type AggregateDimensionInput as m, CONTEXTUAL_EDITING_TEST_NAME as n, CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID as o, type paths as p, type CompositionMetadata as q, type ContextEvents as r, type ContextInstance as s, type ContextOptions as t, type ContextState as u, type ContextStateUpdate as v, type CriteriaEvaluatorParameters as w, type CriteriaEvaluatorResult as x, type DecayOptions as y, type DevToolsActions as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniformdev/context",
-  "version": "20.84.0",
+  "version": "20.86.0",
   "description": "Uniform Context core package",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "./dist/index.js",
@@ -70,5 +70,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "aed567f635f70f4ba169010c0a1bcaebfe23d0f9"
+  "gitHead": "f0e4c0eb0eac24eb1e38a5bd536832f0261b003b"
 }