@uniformdev/context 20.70.0 → 20.70.1-alpha.10

package/dist/{types-BAWsX0zQ.d.mts → types-C0Mthca3.d.mts}

@@ -1,402 +1,6 @@
 import * as mitt from 'mitt';
 import { Emitter } from 'mitt';
 
-type Quirks = {
-    [key: string]: string;
-};
-type Tests = {
-    [key: string]: string;
-};
-type ScoreVector = {
-    [key: string]: number;
-};
-type Goals = {
-    [key: string]: boolean;
-};
-type EnrichmentData = {
-    /** Enrichment category name */
-    cat: string;
-    /** Enrichment key value */
-    key: string;
-    /** Strength value (amount of score added when viewing content) */
-    str: number;
-};
-type PersonalizeControlVariant = {
-    index: number;
-    control: boolean;
-};
-type PersonalizeVariants = {
-    [key: string]: PersonalizeControlVariant[];
-};
-/** An event that has occurred (i.e. an analytics track) which may trigger an Event signal */
-type EventData = {
-    /** The event name that has been fired */
-    event: string;
-};
-type VisitorData = {
-    /**
-     * Quirk key-value data.
-     * NOTE: Context.quirks is more commonly correct if you need to read quirks data.
-     */
-    quirks: Quirks;
-    /** A/B test variant selections */
-    tests: Tests;
-    /**
-     * Personalization score data for the current session (merge with all time for totals)
-     * NOTE: Context.scores is more commonly correct to read scores instead of this value.
-     */
-    sessionScores: ScoreVector;
-    /**
-     * Personalization score data for all time (merge with session for totals)
-     * NOTE: Context.scores is more commonly correct to read scores instead of this value.
-     */
-    scores: ScoreVector;
-    /**
-     * Goals that this user has triggered.
-     */
-    goals?: Goals;
-    /**
-     * Whether consent has been given to store the visitor data
-     * If false or not set: visitor data is stored in memory and is lost if the browser refreshes
-     * If true: visitor data is stored in localStorage and any other transition storage if registered
-     */
-    consent?: boolean;
-    /**
-     * Whether the visitor has been assigned to the personalization control group -
-     * visitors who are not shown personalization. If this is true, all scores will be zeroed,
-     * and score updates will be ignored. This has no effect on quirks or tests.
-     *
-     * If this value is not set, a random roll will be performed to determine membership,
-     * based on the control group size.
-     */
-    controlGroup?: boolean;
-    /**
-     * Records of personalized variants that have been shown to the visitor and their control group status
-     */
-    personalizeVariants?: PersonalizeVariants;
-};
-declare const emptyVisitorData: () => VisitorData;
-/**
- * Canvas-specific data that should be managed separately from regular context updates
- */
-type CompositionMetadata = {
-    /** The composition ID always required, otherwise whole metadata should not be set */
-    compositionId: string;
-    /** The matched route from router endpoint. Same as matched project map node pathname */
-    matchedRoute?: string;
-    /** Dynamic inputs for the route */
-    dynamicInputs?: Record<string, string>;
-};
-/**
- * Expresses a 'patch' to the Uniform Context state
- */
-type ContextState = {
-    cookies: Record<string, string | undefined>;
-    url?: URL;
-    quirks: Quirks;
-    enrichments: EnrichmentData[];
-    events: EventData[];
-    /**
-     * Metadata about the composition that is being rendered right now.
-     * if you have multiple compositions on the page, please set this one manually.
-     */
-    compositionMetadata?: CompositionMetadata;
-};
-type ContextStateUpdate = {
-    /** The new effective state of the visitor after this state update is applied */
-    state: Partial<ContextState>;
-    /** The last state of the visitor before this state update */
-    previousState: Partial<ContextState>;
-    /** The visitor we are updating */
-    visitor: VisitorData;
-    /** The visitor's scores before this state update */
-    scores: ScoreVector;
-};
-type GoalStateUpdate = {
-    scores: ScoreVector | undefined;
-    quirks: Quirks | undefined;
-};
-
-type StorageCommand<TID extends string = string, TData = unknown> = {
-    type: TID;
-    data: TData;
-};
-/** Commands that can be issued to alter the storage of Uniform Context data */
-type StorageCommands = ModifyScoreCommand | ModifySessionScoreCommand | SetConsentCommand | SetQuirkCommand | SetTestCommand | IdentifyCommand | SetControlGroupCommand | SetPersonalizeVariantControlCommand | SetGoalCommand;
-/**
- * Converts the goal specified.
- */
-type SetGoalCommand = StorageCommand<'setgoal', {
-    goal: string;
-}>;
-/**
- * Changes the visitor's permanent score for a given dimension
- */
-type ModifyScoreCommand = StorageCommand<'modscore', {
-    dimension: string;
-    delta: number;
-}>;
-/**
- * Changes the visitor's session (time-based) score for a given dimension
- */
-type ModifySessionScoreCommand = StorageCommand<'modscoreS', {
-    dimension: string;
-    delta: number;
-}>;
-/**
- * Changes the visitor's storage consent setting.
- * Setting consent to false will trigger deletion of any stored data for the visitor.
- * Scores are still collected in-memory when consent is false; just not persisted.
- */
-type SetConsentCommand = StorageCommand<'consent', boolean>;
-/** Sets a permanent quirk key and value for the visitor */
-type SetQuirkCommand = StorageCommand<'setquirk', {
-    key: string;
-    value: string;
-}>;
-/** Sets a specific variant as being this visitor's variant on an A/B test */
-type SetTestCommand = StorageCommand<'settest', {
-    test: string;
-    variant: string;
-}>;
-/**
- * Identifies the visitor as being a specific unique identifier.
- * NOTE: this only has an effect when using an external cross-device transition storage system.
- * NOTE: you cannot read the identified visitor ID back from the storage system once it is set.
- */
-type IdentifyCommand = StorageCommand<'identify', {
-    identity: string;
-}>;
-/**
- * Sets whether the current visitor is in the personalization control group
- * (Will not be exposed to personalization or gather classification data; WILL see A/B tests)
- * In most cases this should not be sent as the membership is computed automatically for visitors;
- * this command is intended mostly for diagnostics and testing purposes.
- */
-type SetControlGroupCommand = StorageCommand<'setcontrol', boolean>;
-type SetPersonalizeVariantControlCommand = StorageCommand<'setpersonalizecontrol', {
-    personlizationName: string;
-    index: number;
-    control: boolean;
-}>;
-declare const areCommandsEqual: (a: StorageCommands, b: StorageCommands) => boolean;
-
-type TransitionDataStoreOptions = {
-    initialData?: Partial<VisitorData>;
-};
-type ServerToClientTransitionState = Pick<Partial<VisitorData>, 'quirks' | 'tests' | 'personalizeVariants'> & {
-    /**
-     * Server Score Vector - the resultant scores _on the server side_ after the server/edge render completes
-     * Note that the client side does not trust these scores; they are only used until it's done with initial
-     * recomputation.
-     */
-    ssv?: ScoreVector;
-    /**
-     * Storage commands that the server
-     */
-    commands?: StorageCommands[];
-    /**
-     * Composition metadata from the server side
-     */
-    compositionMetadata?: CompositionMetadata;
-};
-declare const SERVER_STATE_ID = "__UNIFORM_DATA__";
-type TransitionDataStoreEvents = {
-    /**
-     * Fired when the data is updated asynchronously
-     * (i.e. a promise resolves with new data from a backend)
-     *
-     * NOT fired for synchronous updates (e.g. calling updateData()), unless this also results in an async update of the data afterwards.
-     * NOT fired if an asynchronous update does not result in any change compared to the last known data.
-     */
-    dataUpdatedAsync: Partial<VisitorData>;
-};
-declare abstract class TransitionDataStore {
-    #private;
-    constructor({ initialData }: TransitionDataStoreOptions);
-    get data(): Partial<VisitorData> | undefined;
-    get initialData(): Partial<VisitorData> | undefined;
-    /**
-     * Subscribe to events from the transition storage
-     */
-    readonly events: {
-        on: {
-            <Key extends "dataUpdatedAsync">(type: Key, handler: mitt.Handler<TransitionDataStoreEvents[Key]>): void;
-            (type: "*", handler: mitt.WildcardHandler<TransitionDataStoreEvents>): void;
-        };
-        off: {
-            <Key extends "dataUpdatedAsync">(type: Key, handler?: mitt.Handler<TransitionDataStoreEvents[Key]> | undefined): void;
-            (type: "*", handler: mitt.WildcardHandler<TransitionDataStoreEvents>): void;
-        };
-    };
-    /**
-     * Updates data in the transition storage.
-     * @param commands Commands to execute against existing stored value (event based stores)
-     * @param computedValue Pre-computed new value against existing value (object based stores)
-     * @returns Resolved promise when the data has been updated
-     */
-    updateData(commands: StorageCommands[], computedValue: VisitorData): Promise<void>;
-    /**
-     * Deletes a visitor's stored data, forgetting them.
-     * @param fromAllDevices - false: logout from this device ID. true: forget all data about the visitor and their identity.
-     */
-    delete(fromAllDevices?: boolean): Promise<void>;
-    /**
-     * Deletes a visitor's stored data, forgetting them.
-     * Important: do not emit any async score update events from this function.
-     * @param fromAllDevices - false: logout from this device ID. true: forget all data about the visitor and their identity.
-     */
-    abstract handleDelete(fromAllDevices?: boolean): Promise<void>;
-    /**
-     * Updates visitor data in the transition store.
-     *
-     * NOTE: The updated data is optimistically stored in TransitionDataStore automatically,
-     * so unless the updated data is _changed_ by the backend data store, there is no need
-     * to emit async score changed events when the visitor data is done updating.
-     */
-    abstract handleUpdateData(commands: StorageCommands[], computedValue: VisitorData): Promise<void>;
-    protected signalAsyncDataUpdate(newScores: Partial<VisitorData>): void;
-    /**
-     * When we load on the client side after a server side rendering has occurred (server to client transition),
-     * we can have a page script (ID: __UNIFORM_DATA__) that contains the computed visitor data from the SSR/edge render.
-     * This data is injected into the first render to allow score syncing and the server to request commands be applied
-     * to the client side data store.
-     */
-    getClientTransitionState(): ServerToClientTransitionState | undefined;
-}
-
-type DecayOptions = {
-    now: number;
-    lastUpd: number | undefined;
-    scores: ScoreVector;
-    sessionScores: ScoreVector;
-    onLogMessage?: (message: LogMessage) => void;
-};
-/**
- * Computes decay of visitor scores over time.
- * NOTE: it is expected that this function mutates the incoming score vectors,
- * if it needs to apply score decay. The data store ensures immutability already.
- *
- * @returns true if any decay was applied, false otherwise
- */
-type DecayFunction = (options: DecayOptions) => boolean;
-
-type VisitorDataStoreOptions = {
-    /** Transition storage used to transfer server or edge side execution state to the client. Unused for client side only. */
-    transitionStore?: TransitionDataStore;
-    /** Duration of a 'visit' measured by this number of milliseconds without performing any updates */
-    visitLifespan?: number;
-    /** Personalization manifest data. If set, the data store will automatically apply score caps in the manifest data. */
-    manifest?: ManifestInstance;
-    /** Allows decaying of scores over time based on time between visits. Default: no decay */
-    decay?: DecayFunction;
-    /**
-     * Sets the default value of storage consent for new unknown visitors.
-     * If storage consent is not given, only in-memory data will be stored which is lost when the browser leaves the page.
-     * @default false - consent is not given for new visitors until they explicitly give it with an update command
-     */
-    defaultConsent?: boolean;
-    /**
-     * Function called when server-to-client transfer state is loaded and contains server-side computed scores.
-     * These scores are used as a temporary shim for the current scores on the client side, until score computation
-     * is completed the first time (which occurs when the current url is fed into the Context).
-     *
-     * Because the feed of the URL may be marginally delayed (for example in React it's in an effect so it's a second render),
-     * one render might be done with _no_ scores unless we dropped the server scores in temporarily, resulting in a flash of unpersonalized content.
-     */
-    onServerTransitionReceived?: (state: ServerToClientTransitionState) => void;
-    /** Called when a log message is emitted from the data store */
-    onLogMessage?: (message: LogMessage) => void;
-    /**
-     * Optionally specify a prefix for all storage keys.
-     * Only required if using multiple Context instances on the same domain and need to separate them.
-     */
-    partitionKey?: string;
-};
-type VisitorDataStoreEvents = {
-    /**
-     * Fired when the stored data is updated.
-     * This is fired for any update, whether from integrated or transition storage.
-     * The event is NOT fired if an update does not result in any score changes.
-     */
-    scoresUpdated: Pick<VisitorData, 'scores' | 'sessionScores'>;
-    /**
-     * Fired when stored quirks are updated.
-     * This is fired for any update, whether from integrated or transition storage.
-     * The event is NOT fired if an update does not result in any quirk changes.
-     */
-    quirksUpdated: Pick<VisitorData, 'quirks'>;
-    /**
-     * Fired when test variant selection is updated.
-     */
-    testsUpdated: Pick<VisitorData, 'tests'>;
-    /**
-     * Fired when storage consent is changed
-     */
-    consentUpdated: Pick<VisitorData, 'consent'>;
-    /**
-     * Fired when visitor control group membership is changed
-     */
-    controlGroupUpdated: Pick<VisitorData, 'controlGroup'>;
-    /**
-     * Fired when a goal is converted
-     */
-    goalConverted: {
-        goalId: string;
-    };
-    /** Fired when storage update commands are done executing */
-    commandsExecuted: StorageCommands[];
-};
-declare class VisitorDataStore {
-    #private;
-    constructor(options: VisitorDataStoreOptions);
-    /** Gets the current visitor data. This property is always up to date. */
-    get data(): VisitorData;
-    get decayEnabled(): boolean;
-    get options(): VisitorDataStoreOptions;
-    /**
-     * Subscribe to events from storage
-     */
-    readonly events: {
-        on: {
-            <Key extends keyof VisitorDataStoreEvents>(type: Key, handler: mitt.Handler<VisitorDataStoreEvents[Key]>): void;
-            (type: "*", handler: mitt.WildcardHandler<VisitorDataStoreEvents>): void;
-        };
-        off: {
-            <Key extends keyof VisitorDataStoreEvents>(type: Key, handler?: mitt.Handler<VisitorDataStoreEvents[Key]> | undefined): void;
-            (type: "*", handler: mitt.WildcardHandler<VisitorDataStoreEvents>): void;
-        };
-    };
-    /** Push data update command(s) into the visitor data */
-    updateData(commands: StorageCommands[]): Promise<void>;
-    /**
-     * Deletes visitor data (forgetting them)
-     * In most cases you should use forget() on the Context instead of this function, which also clears the Context state.
-     * @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
-     */
-    delete(fromAllDevices: boolean): Promise<void>;
-}
-
-declare class ManifestInstance {
-    #private;
-    readonly data: ManifestV2;
-    constructor({ manifest, evaluator, onLogMessage, }: {
-        manifest: ManifestV2;
-        evaluator?: GroupCriteriaEvaluator;
-        onLogMessage?: (message: LogMessage) => void;
-    });
-    rollForControlGroup(): boolean;
-    getTest(name: string): TestDefinition | undefined;
-    computeSignals(update: ContextStateUpdate): StorageCommands[];
-    computeGoals(data: GoalStateUpdate): StorageCommands[];
-    /**
-     * Computes aggregated scores based on other dimensions
-     */
-    computeAggregateDimensions(primitiveScores: ScoreVector): ScoreVector;
-    getDimensionByKey(scoreKey: string): EnrichmentCategory | Signal | undefined;
-    getAggregateDimensionByKey(scoreKey: string): AggregateDimension | undefined;
-}
-
 interface paths {
     "/api/v2/manifest": {
         parameters: {
@@ -405,9 +9,10 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** @description Fetches the optimization Manifest for a given project.
+        /**
+         * @description Fetches the optimization Manifest for a given project.
          *     If no manifest has ever been published, and an API key is used that has preview manifest permissions then the current preview manifest will be returned (in delivery format).
-         *      */
+         */
         get: {
             parameters: {
                 query: {
@@ -520,7 +125,6 @@ interface components {
              *     | = OR
              *
              *     Default is `&` if unspecified
-             *
              * @enum {string}
              */
             op?: "&" | "|";
@@ -538,7 +142,6 @@ interface components {
              *     '//' = regular expression match
              *
              *     Any of the above can be prefixed with '!' to invert the match (i.e. != for 'not an exact match')
-             *
              * @enum {string}
              */
             op: "=" | "~" | "//" | "!=" | "!~" | "!//";
@@ -549,7 +152,6 @@ interface components {
              * @description The type of match to perform
              *     '*' = exists with any value
              *     '!*' = does not exist
-             *
              * @enum {string}
              */
             op: "*" | "!*";
@@ -588,9 +190,10 @@ interface components {
             /** @description How to match the event name */
             event: components["schemas"]["StringMatch"];
         };
-        /** @description Matches the current page's absolute path (i.e. /path/to/page.html)
+        /**
+         * @description Matches the current page's absolute path (i.e. /path/to/page.html)
          *     Does not include the query string or protocol and hostname (i.e. NOT https://foo.com/path/to/page.html?query=something)
-         *      */
+         */
         CurrentPageCriteria: {
             /** @enum {string} */
             type: "PV";
@@ -607,7 +210,6 @@ interface components {
              *     '!=' = not an exact match
              *     '<' = less than match expression
              *     '>' = greater than match expression
-             *
              * @enum {string}
              */
             op: "=" | "<" | ">" | "!=";
@@ -631,7 +233,6 @@ interface components {
              *     | = OR
              *
              *     Default is `&` if unspecified
-             *
              * @default &
              * @enum {string}
              */
@@ -656,7 +257,6 @@ interface components {
              *     's' = current session (expires after a period of inactivity)
              *     'p' = permanent (expires as far in the future as possible, may be limited by browser security settings)
              *     't' = transient (score tracks the current state of the criteria every time scores are updated)
-             *
              * @enum {string}
              */
             dur: "s" | "p" | "t";
@@ -669,14 +269,15 @@ interface components {
         };
         /** @description Defines an input dimension to an aggregate dimension */
         AggregateDimensionInput: {
-            /** @description Dimension name to reference as an input.
+            /**
+             * @description Dimension name to reference as an input.
              *     For enrichment inputs, use CATEGORY_KEY as the dimension.
              *     Enrichments, signals, and other aggregate dimensions may be referenced.
              *
              *     Note that creating a cycle of aggregate dimensions is allowed, however
              *     the final score will _ignore_ the cycled aggregate dimension in the result.
              *     This can be used to create mutually exclusive aggregates
-             *      */
+             */
             dim: string;
             /**
              * @description The sign of the input dimension controls how it affects the aggregate dimension's final score.
@@ -686,7 +287,6 @@ interface components {
              *     'c' = clear the final score (if the input dimension has any score at all, this aggregate will have no score regardless of other inputs)
              *
              *     Default if unspecified: '+'
-             *
              * @default +
              * @enum {string}
              */
@@ -701,58 +301,454 @@ interface components {
             /** @description Winning variation ID - if set, the test will not run and this variation is shown to all visitors (the test is closed) */
             wv?: string;
         };
-        Error: {
-            /** @description Error message(s) that occurred while processing the request */
-            errorMessage?: string[] | string;
+        Error: {
+            /** @description Error message(s) that occurred while processing the request */
+            errorMessage?: string[] | string;
+        };
+    };
+    responses: {
+        /** @description Request input validation failed */
+        BadRequestError: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["Error"];
+            };
+        };
+        /** @description API key or token was not valid */
+        UnauthorizedError: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["Error"];
+            };
+        };
+        /** @description Permission was denied */
+        ForbiddenError: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["Error"];
+            };
+        };
+        /** @description Too many requests in allowed time period */
+        RateLimitError: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content?: never;
+        };
+        /** @description Execution error occurred */
+        InternalServerError: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content?: never;
+        };
+    };
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+
+type Quirks = {
+    [key: string]: string;
+};
+type Tests = {
+    [key: string]: string;
+};
+type ScoreVector = {
+    [key: string]: number;
+};
+type Goals = {
+    [key: string]: boolean;
+};
+type EnrichmentData = {
+    /** Enrichment category name */
+    cat: string;
+    /** Enrichment key value */
+    key: string;
+    /** Strength value (amount of score added when viewing content) */
+    str: number;
+};
+type PersonalizeControlVariant = {
+    index: number;
+    control: boolean;
+};
+type PersonalizeVariants = {
+    [key: string]: PersonalizeControlVariant[];
+};
+/** An event that has occurred (i.e. an analytics track) which may trigger an Event signal */
+type EventData = {
+    /** The event name that has been fired */
+    event: string;
+};
+type VisitorData = {
+    /**
+     * Quirk key-value data.
+     * NOTE: Context.quirks is more commonly correct if you need to read quirks data.
+     */
+    quirks: Quirks;
+    /** A/B test variant selections */
+    tests: Tests;
+    /**
+     * Personalization score data for the current session (merge with all time for totals)
+     * NOTE: Context.scores is more commonly correct to read scores instead of this value.
+     */
+    sessionScores: ScoreVector;
+    /**
+     * Personalization score data for all time (merge with session for totals)
+     * NOTE: Context.scores is more commonly correct to read scores instead of this value.
+     */
+    scores: ScoreVector;
+    /**
+     * Goals that this user has triggered.
+     */
+    goals?: Goals;
+    /**
+     * Whether consent has been given to store the visitor data
+     * If false or not set: visitor data is stored in memory and is lost if the browser refreshes
+     * If true: visitor data is stored in localStorage and any other transition storage if registered
+     */
+    consent?: boolean;
+    /**
+     * Whether the visitor has been assigned to the personalization control group -
+     * visitors who are not shown personalization. If this is true, all scores will be zeroed,
+     * and score updates will be ignored. This has no effect on quirks or tests.
+     *
+     * If this value is not set, a random roll will be performed to determine membership,
+     * based on the control group size.
+     */
+    controlGroup?: boolean;
+    /**
+     * Records of personalized variants that have been shown to the visitor and their control group status
+     */
+    personalizeVariants?: PersonalizeVariants;
+};
+declare const emptyVisitorData: () => VisitorData;
+/**
+ * Canvas-specific data that should be managed separately from regular context updates
+ */
+type CompositionMetadata = {
+    /** The composition ID always required, otherwise whole metadata should not be set */
+    compositionId: string;
+    /** The matched route from router endpoint. Same as matched project map node pathname */
+    matchedRoute?: string;
+    /** Dynamic inputs for the route */
+    dynamicInputs?: Record<string, string>;
+};
+/**
+ * Expresses a 'patch' to the Uniform Context state
+ */
+type ContextState = {
+    cookies: Record<string, string | undefined>;
+    url?: URL;
+    quirks: Quirks;
+    enrichments: EnrichmentData[];
+    events: EventData[];
+    /**
+     * Metadata about the composition that is being rendered right now.
+     * if you have multiple compositions on the page, please set this one manually.
+     */
+    compositionMetadata?: CompositionMetadata;
+};
+type ContextStateUpdate = {
+    /** The new effective state of the visitor after this state update is applied */
+    state: Partial<ContextState>;
+    /** The last state of the visitor before this state update */
+    previousState: Partial<ContextState>;
+    /** The visitor we are updating */
+    visitor: VisitorData;
+    /** The visitor's scores before this state update */
+    scores: ScoreVector;
+};
+type GoalStateUpdate = {
+    scores: ScoreVector | undefined;
+    quirks: Quirks | undefined;
+};
+
+type StorageCommand<TID extends string = string, TData = unknown> = {
+    type: TID;
+    data: TData;
+};
+/** Commands that can be issued to alter the storage of Uniform Context data */
+type StorageCommands = ModifyScoreCommand | ModifySessionScoreCommand | SetConsentCommand | SetQuirkCommand | SetTestCommand | IdentifyCommand | SetControlGroupCommand | SetPersonalizeVariantControlCommand | SetGoalCommand;
+/**
+ * Converts the goal specified.
+ */
+type SetGoalCommand = StorageCommand<'setgoal', {
+    goal: string;
+}>;
+/**
+ * Changes the visitor's permanent score for a given dimension
+ */
+type ModifyScoreCommand = StorageCommand<'modscore', {
+    dimension: string;
+    delta: number;
+}>;
+/**
+ * Changes the visitor's session (time-based) score for a given dimension
+ */
+type ModifySessionScoreCommand = StorageCommand<'modscoreS', {
+    dimension: string;
+    delta: number;
+}>;
+/**
+ * Changes the visitor's storage consent setting.
+ * Setting consent to false will trigger deletion of any stored data for the visitor.
+ * Scores are still collected in-memory when consent is false; just not persisted.
+ */
+type SetConsentCommand = StorageCommand<'consent', boolean>;
+/** Sets a permanent quirk key and value for the visitor */
+type SetQuirkCommand = StorageCommand<'setquirk', {
+    key: string;
+    value: string;
+}>;
+/** Sets a specific variant as being this visitor's variant on an A/B test */
+type SetTestCommand = StorageCommand<'settest', {
+    test: string;
+    variant: string;
+}>;
+/**
+ * Identifies the visitor as being a specific unique identifier.
+ * NOTE: this only has an effect when using an external cross-device transition storage system.
+ * NOTE: you cannot read the identified visitor ID back from the storage system once it is set.
+ */
+type IdentifyCommand = StorageCommand<'identify', {
+    identity: string;
+}>;
+/**
+ * Sets whether the current visitor is in the personalization control group
+ * (Will not be exposed to personalization or gather classification data; WILL see A/B tests)
+ * In most cases this should not be sent as the membership is computed automatically for visitors;
+ * this command is intended mostly for diagnostics and testing purposes.
+ */
+type SetControlGroupCommand = StorageCommand<'setcontrol', boolean>;
+type SetPersonalizeVariantControlCommand = StorageCommand<'setpersonalizecontrol', {
+    personlizationName: string;
+    index: number;
+    control: boolean;
+}>;
+declare const areCommandsEqual: (a: StorageCommands, b: StorageCommands) => boolean;
+
+type TransitionDataStoreOptions = {
+    initialData?: Partial<VisitorData>;
+};
+type ServerToClientTransitionState = Pick<Partial<VisitorData>, 'quirks' | 'tests' | 'personalizeVariants'> & {
+    /**
+     * Server Score Vector - the resultant scores _on the server side_ after the server/edge render completes
+     * Note that the client side does not trust these scores; they are only used until it's done with initial
+     * recomputation.
+     */
+    ssv?: ScoreVector;
+    /**
+     * Storage commands that the server
+     */
+    commands?: StorageCommands[];
+    /**
+     * Composition metadata from the server side
+     */
+    compositionMetadata?: CompositionMetadata;
+};
+declare const SERVER_STATE_ID = "__UNIFORM_DATA__";
+type TransitionDataStoreEvents = {
+    /**
+     * Fired when the data is updated asynchronously
+     * (i.e. a promise resolves with new data from a backend)
+     *
+     * NOT fired for synchronous updates (e.g. calling updateData()), unless this also results in an async update of the data afterwards.
+     * NOT fired if an asynchronous update does not result in any change compared to the last known data.
+     */
+    dataUpdatedAsync: Partial<VisitorData>;
+};
+declare abstract class TransitionDataStore {
+    #private;
+    constructor({ initialData }: TransitionDataStoreOptions);
+    get data(): Partial<VisitorData> | undefined;
+    get initialData(): Partial<VisitorData> | undefined;
+    /**
+     * Subscribe to events from the transition storage
+     */
+    readonly events: {
+        on: {
+            <Key extends "dataUpdatedAsync">(type: Key, handler: mitt.Handler<TransitionDataStoreEvents[Key]>): void;
+            (type: "*", handler: mitt.WildcardHandler<TransitionDataStoreEvents>): void;
+        };
+        off: {
+            <Key extends "dataUpdatedAsync">(type: Key, handler?: mitt.Handler<TransitionDataStoreEvents[Key]> | undefined): void;
+            (type: "*", handler: mitt.WildcardHandler<TransitionDataStoreEvents>): void;
         };
     };
-    responses: {
-        /** @description Request input validation failed */
-        BadRequestError: {
-            headers: {
-                [name: string]: unknown;
-            };
-            content: {
-                "application/json": components["schemas"]["Error"];
-            };
-        };
-        /** @description API key or token was not valid */
-        UnauthorizedError: {
-            headers: {
-                [name: string]: unknown;
-            };
-            content: {
-                "application/json": components["schemas"]["Error"];
-            };
-        };
-        /** @description Permission was denied */
-        ForbiddenError: {
-            headers: {
-                [name: string]: unknown;
-            };
-            content: {
-                "application/json": components["schemas"]["Error"];
-            };
-        };
-        /** @description Too many requests in allowed time period */
-        RateLimitError: {
-            headers: {
-                [name: string]: unknown;
-            };
-            content?: never;
+    /**
+     * Updates data in the transition storage.
+     * @param commands Commands to execute against existing stored value (event based stores)
+     * @param computedValue Pre-computed new value against existing value (object based stores)
+     * @returns Resolved promise when the data has been updated
+     */
+    updateData(commands: StorageCommands[], computedValue: VisitorData): Promise<void>;
+    /**
+     * Deletes a visitor's stored data, forgetting them.
+     * @param fromAllDevices - false: logout from this device ID. true: forget all data about the visitor and their identity.
+     */
+    delete(fromAllDevices?: boolean): Promise<void>;
+    /**
+     * Deletes a visitor's stored data, forgetting them.
+     * Important: do not emit any async score update events from this function.
+     * @param fromAllDevices - false: logout from this device ID. true: forget all data about the visitor and their identity.
+     */
+    abstract handleDelete(fromAllDevices?: boolean): Promise<void>;
+    /**
+     * Updates visitor data in the transition store.
+     *
+     * NOTE: The updated data is optimistically stored in TransitionDataStore automatically,
+     * so unless the updated data is _changed_ by the backend data store, there is no need
+     * to emit async score changed events when the visitor data is done updating.
+     */
+    abstract handleUpdateData(commands: StorageCommands[], computedValue: VisitorData): Promise<void>;
+    protected signalAsyncDataUpdate(newScores: Partial<VisitorData>): void;
+    /**
+     * When we load on the client side after a server side rendering has occurred (server to client transition),
+     * we can have a page script (ID: __UNIFORM_DATA__) that contains the computed visitor data from the SSR/edge render.
+     * This data is injected into the first render to allow score syncing and the server to request commands be applied
+     * to the client side data store.
+     */
+    getClientTransitionState(): ServerToClientTransitionState | undefined;
+}
+
+type DecayOptions = {
+    now: number;
+    lastUpd: number | undefined;
+    scores: ScoreVector;
+    sessionScores: ScoreVector;
+    onLogMessage?: (message: LogMessage) => void;
+};
+/**
+ * Computes decay of visitor scores over time.
+ * NOTE: it is expected that this function mutates the incoming score vectors,
+ * if it needs to apply score decay. The data store ensures immutability already.
+ *
+ * @returns true if any decay was applied, false otherwise
+ */
+type DecayFunction = (options: DecayOptions) => boolean;
+
+type VisitorDataStoreOptions = {
+    /** Transition storage used to transfer server or edge side execution state to the client. Unused for client side only. */
+    transitionStore?: TransitionDataStore;
+    /** Duration of a 'visit' measured by this number of milliseconds without performing any updates */
+    visitLifespan?: number;
+    /** Personalization manifest data. If set, the data store will automatically apply score caps in the manifest data. */
+    manifest?: ManifestInstance;
+    /** Allows decaying of scores over time based on time between visits. Default: no decay */
+    decay?: DecayFunction;
+    /**
+     * Sets the default value of storage consent for new unknown visitors.
+     * If storage consent is not given, only in-memory data will be stored which is lost when the browser leaves the page.
+     * @default false - consent is not given for new visitors until they explicitly give it with an update command
+     */
+    defaultConsent?: boolean;
+    /**
+     * Function called when server-to-client transfer state is loaded and contains server-side computed scores.
+     * These scores are used as a temporary shim for the current scores on the client side, until score computation
+     * is completed the first time (which occurs when the current url is fed into the Context).
+     *
+     * Because the feed of the URL may be marginally delayed (for example in React it's in an effect so it's a second render),
+     * one render might be done with _no_ scores unless we dropped the server scores in temporarily, resulting in a flash of unpersonalized content.
+     */
+    onServerTransitionReceived?: (state: ServerToClientTransitionState) => void;
+    /** Called when a log message is emitted from the data store */
+    onLogMessage?: (message: LogMessage) => void;
+    /**
+     * Optionally specify a prefix for all storage keys.
+     * Only required if using multiple Context instances on the same domain and need to separate them.
+     */
+    partitionKey?: string;
+};
+type VisitorDataStoreEvents = {
+    /**
+     * Fired when the stored data is updated.
+     * This is fired for any update, whether from integrated or transition storage.
+     * The event is NOT fired if an update does not result in any score changes.
+     */
+    scoresUpdated: Pick<VisitorData, 'scores' | 'sessionScores'>;
+    /**
+     * Fired when stored quirks are updated.
+     * This is fired for any update, whether from integrated or transition storage.
+     * The event is NOT fired if an update does not result in any quirk changes.
+     */
+    quirksUpdated: Pick<VisitorData, 'quirks'>;
+    /**
+     * Fired when test variant selection is updated.
+     */
+    testsUpdated: Pick<VisitorData, 'tests'>;
+    /**
+     * Fired when storage consent is changed
+     */
+    consentUpdated: Pick<VisitorData, 'consent'>;
+    /**
+     * Fired when visitor control group membership is changed
+     */
+    controlGroupUpdated: Pick<VisitorData, 'controlGroup'>;
+    /**
+     * Fired when a goal is converted
+     */
+    goalConverted: {
+        goalId: string;
+    };
+    /** Fired when storage update commands are done executing */
+    commandsExecuted: StorageCommands[];
+};
+declare class VisitorDataStore {
+    #private;
+    constructor(options: VisitorDataStoreOptions);
+    /** Gets the current visitor data. This property is always up to date. */
+    get data(): VisitorData;
+    get decayEnabled(): boolean;
+    get options(): VisitorDataStoreOptions;
+    /**
+     * Subscribe to events from storage
+     */
+    readonly events: {
+        on: {
+            <Key extends keyof VisitorDataStoreEvents>(type: Key, handler: mitt.Handler<VisitorDataStoreEvents[Key]>): void;
+            (type: "*", handler: mitt.WildcardHandler<VisitorDataStoreEvents>): void;
         };
-        /** @description Execution error occurred */
-        InternalServerError: {
-            headers: {
-                [name: string]: unknown;
-            };
-            content?: never;
+        off: {
+            <Key extends keyof VisitorDataStoreEvents>(type: Key, handler?: mitt.Handler<VisitorDataStoreEvents[Key]> | undefined): void;
+            (type: "*", handler: mitt.WildcardHandler<VisitorDataStoreEvents>): void;
         };
     };
-    parameters: never;
-    requestBodies: never;
-    headers: never;
-    pathItems: never;
+    /** Push data update command(s) into the visitor data */
+    updateData(commands: StorageCommands[]): Promise<void>;
+    /**
+     * Deletes visitor data (forgetting them)
+     * In most cases you should use forget() on the Context instead of this function, which also clears the Context state.
+     * @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
+     */
+    delete(fromAllDevices: boolean): Promise<void>;
+}
+
+declare class ManifestInstance {
+    #private;
+    readonly data: ManifestV2;
+    constructor({ manifest, evaluator, onLogMessage, }: {
+        manifest: ManifestV2;
+        evaluator?: GroupCriteriaEvaluator;
+        onLogMessage?: (message: LogMessage) => void;
+    });
+    rollForControlGroup(): boolean;
+    getTest(name: string): TestDefinition | undefined;
+    computeSignals(update: ContextStateUpdate): StorageCommands[];
+    computeGoals(data: GoalStateUpdate): StorageCommands[];
+    /**
+     * Computes aggregated scores based on other dimensions
+     */
+    computeAggregateDimensions(primitiveScores: ScoreVector): ScoreVector;
+    getDimensionByKey(scoreKey: string): EnrichmentCategory | Signal | undefined;
+    getAggregateDimensionByKey(scoreKey: string): AggregateDimension | undefined;
 }
 
 type ManifestV2 = components['schemas']['ManifestV2'];
@@ -1400,4 +1396,4 @@ declare global {
     }
 }
 
-export { type LogMessageGroup as $, type AggregateDimension as A, type BehaviorTag as B, type ContextPlugin as C, type DecayFunction as D, type DevToolsEvent as E, type DevToolsForgetEvent as F, type DevToolsHelloEvent as G, type DevToolsLogEvent as H, type DevToolsRawCommandsEvent as I, type DevToolsState as J, type DevToolsUiVersion as K, type LogDrain as L, type DevToolsUpdateEvent as M, type DimensionMatch as N, type OutputSeverity as O, type PersonalizedVariant as P, type Quirks as Q, type EnrichmentCategory as R, type ScoreVector as S, TransitionDataStore as T, type EnrichmentData as U, type VisitorData as V, type EventData as W, type GoalStateUpdate as X, type Goals as Y, GroupCriteriaEvaluator as Z, type IdentifyCommand as _, type StorageCommands as a, type LogMessageSingle as a0, type LogMessages as a1, ManifestInstance as a2, type ManifestV2 as a3, type MessageCategory as a4, type MessageFunc as a5, type ModifyScoreCommand as a6, type ModifySessionScoreCommand as a7, type NumberMatch as a8, type PersonalizationEvent as a9, type Tests as aA, type TransitionDataStoreEvents as aB, type VariationMatchMetadata as aC, VisitorDataStore as aD, type VisitorDataStoreEvents as aE, type VisitorDataStoreOptions as aF, areCommandsEqual as aG, emptyVisitorData as aH, testVariations as aI, type paths as aJ, type PersonalizationEventVariantId as aa, type PersonalizationManifest as ab, type PersonalizationSelectionAlgorithm as ac, type PersonalizationSelectionAlgorithms as ad, type PersonalizeControlVariant as ae, type PersonalizeVariants as af, type QuirkMatch as ag, SERVER_STATE_ID as ah, type ServerToClientTransitionState as ai, type SetConsentCommand as aj, type SetControlGroupCommand as ak, type SetGoalCommand as al, type SetPersonalizeVariantControlCommand as am, type SetQuirkCommand as an, type SetTestCommand as ao, type Severity as ap, type Signal as aq, type SignalCriteria as ar, type SignalCriteriaGroup as as, type SignalData as at, type StorageCommand as au, type TestDefinition as av, type TestEvent as aw, type TestOptions as ax, type TestResult as ay, type TestVariant 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 CompositionMetadata as p, type ContextEvents as q, type ContextInstance as r, type ContextOptions as s, type ContextState as t, type ContextStateUpdate as u, type CriteriaEvaluatorParameters as v, type CriteriaEvaluatorResult as w, type DecayOptions as x, type DevToolsActions as y, type DevToolsDataEvent 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 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 };