@uniformdev/context 12.2.1-alpha.177 → 13.0.1-alpha.132

package/dist/{types-1ad8439c.d.ts → types-5f88cc63.d.ts}

@@ -1,3 +1,4 @@
+import { c as components, e as external } from './v2-manifest.swagger-ff2af13e';
 import * as mitt from 'mitt';
 
 declare type StorageCommand<TID extends string = string, TData = unknown> = {
@@ -99,9 +100,12 @@ declare type VisitorData = {
     controlGroup?: boolean;
 };
 declare const emptyVisitorData: () => VisitorData;
+/**
+ * Expresses a 'patch' to the Uniform Context state
+ */
 declare type ContextState = {
     cookies: Record<string, string>;
-    url: URL;
+    url?: URL;
     quirks: Quirks;
     enrichments: EnrichmentData[];
     events: EventData[];
@@ -188,25 +192,65 @@ declare abstract class TransitionDataStore {
     getClientTransitionState(): ServerToClientTransitionState | undefined;
 }
 
-declare type CookieAdapter = {
-    get: (name: string) => string | undefined;
-    set: (name: string, value: string) => void;
-    remove: (name: string) => void;
+declare type SharedTypes = external['uniform-context-types.swagger.yml']['components']['schemas'];
+declare type ManifestV2 = components['schemas']['ManifestV2'];
+declare type PersonalizationManifest = components['schemas']['PersonalizationManifest'];
+declare type Signal = SharedTypes['Signal'];
+declare type SignalCriteriaGroup = SharedTypes['SignalCriteriaGroup'];
+declare type SignalCriteria = SharedTypes['SignalCriteria'];
+declare type EnrichmentCategory = SharedTypes['EnrichmentCategory'];
+declare type StringMatch = SharedTypes['StringMatch'];
+declare type NumberMatch = SharedTypes['NumberMatch'];
+declare type TestDefinition = SharedTypes['Test'];
+declare type AggregateDimension = SharedTypes['AggregateDimension'];
+declare type AggregateDimensionInput = SharedTypes['AggregateDimensionInput'];
+
+/**
+ * The result of evaluating a signal criteria.
+ */
+declare type CriteriaEvaluatorResult = {
+    /** Whether the criteria evaluated to true or not */
+    result: boolean;
+    /**
+     * Whether the value of the criteria changed from the previous state
+     * If ALL criteria on a signal have NOT changed, the signal is skipped
+     * and its score is left alone.
+     */
+    changed: boolean;
 };
-declare type DecayOptions = {
-    now: number;
-    lastUpd: number | undefined;
-    scores: ScoreVector;
-    sessionScores: ScoreVector;
+declare type CriteriaEvaluatorParameters = {
+    /** The update being made to the Context state */
+    update: ContextStateUpdate;
+    /** Current criteria to evaluate the update against */
+    criteria: SignalCriteria;
+    /**
+     * The storage commands that will be executed by this update.
+     * If the evaluation requires custom commands, push them into this parameter.
+     * NOTE: needing to use this is very rare and should be avoided if possible.
+     */
+    commands: StorageCommands[];
+    /** The parent signal containing the criteria we are evaluating */
+    signal: SignalData;
+    /** Function to emit log notices to the Context log */
+    onLogMessage?: (message: LogMessage) => void;
+};
+declare type SignalData = Signal & {
+    id: string;
 };
 /**
- * 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
+ * A type that evaluates a signal criteria type and
+ * decides if it matches the current Context state or not.
  */
-declare type DecayFunction = (options: DecayOptions) => boolean;
+declare type CriteriaEvaluator = ((parameters: CriteriaEvaluatorParameters) => CriteriaEvaluatorResult) & {
+    /** If true the criteria will always execute even if a short-circuit would normally skip it */
+    alwaysExecute?: boolean;
+};
+
+declare class GroupCriteriaEvaluator {
+    #private;
+    constructor(criteriaEvaluators: Record<string, CriteriaEvaluator>);
+    evaluate(update: ContextStateUpdate, crit: SignalCriteriaGroup, commands: StorageCommands[], signal: SignalData, onLogMessage?: (message: LogMessage) => void): CriteriaEvaluatorResult;
+}
 
 /** Defines all error codes and their parameter(s)  */
 declare type LogMessages = {
@@ -220,12 +264,16 @@ declare type LogMessages = {
     3: MessageFunc<ScoreVector>;
     /** Context emitted updated quirks */
     4: MessageFunc<Quirks>;
+    /** Tried to set enrichment category that did not exist */
+    5: MessageFunc<EnrichmentData>;
     /** Storage received update commands */
     101: MessageFunc<StorageCommands[]>;
     /** Storage data was updated */
     102: MessageFunc<VisitorData>;
     /** Storage data was deleted bool: fromAllDevices */
     103: MessageFunc<boolean>;
+    /** Visitor was assigned or removed from control group */
+    104: MessageFunc<boolean>;
     /** Storage score was truncated to its cap */
     110: MessageFunc<{
         dim: string;
@@ -236,13 +284,53 @@ declare type LogMessages = {
     120: MessageFunc;
     /** Server to client transition score data was loaded */
     130: MessageFunc<ScoreVector>;
-    /** Test did not exist */
+    /** Server to client transition data was discarded */
+    131: MessageFunc;
+    /** Decay function executed */
+    140: MessageFunc<string>;
+    /** Signals evaluation beginning */
+    200: MessageFunc;
+    /** Evaluation of a specific signal beginning */
+    201: MessageFunc<SignalData>;
+    /** Evaluation of a group beginning */
+    202: MessageFunc<SignalCriteriaGroup>;
+    203: MessageFunc<{
+        criteria: SignalCriteria;
+        result: CriteriaEvaluatorResult;
+        explanation: string;
+    }>;
+    /** Result of evaluating a criteria group */
+    204: MessageFunc<CriteriaEvaluatorResult>;
+    /** Personalization placement executing */
+    300: MessageFunc<{
+        name: string;
+        take?: number;
+    }>;
+    /** Personalization placement testing variation */
+    301: MessageFunc<{
+        id: string;
+        op?: string;
+    }>;
+    /** Processed a personalization criteria */
+    302: MessageFunc<{
+        matched: boolean;
+        description: string;
+    }>;
+    /** Final result for a personalized variation */
+    303: MessageFunc<boolean>;
+    /** A/B test placement executing */
+    400: MessageFunc<string>;
+    /** A/B Test definition did not exist */
     401: MessageFunc<string>;
     /** Previously shown test variant no longer in variant data */
     402: MessageFunc<{
-        test: string;
-        variant: string;
+        missingVariant: string;
+        variants: string[];
     }>;
+    /** Selected a new A/B test variation */
+    403: MessageFunc<string>;
+    /** Displaying A/B test variation */
+    404: MessageFunc<string>;
     /** gtag was not present on the page to emit events to */
     700: MessageFunc;
     /** Enabled gtag event signal redirection */
@@ -250,15 +338,41 @@ declare type LogMessages = {
 };
 
 declare type Severity = 'debug' | 'info' | 'warn' | 'error';
+declare type MessageCategory = 'context' | 'storage' | 'testing' | 'personalization' | 'gtag' | 'signals';
 declare type OutputSeverity = Severity | 'none';
-declare type MessageFunc<TArg = void> = (arg: TArg) => [string, string, ...any];
-declare type LogMessage<TID extends keyof LogMessages = keyof LogMessages> = [
+declare type MessageFunc<TArg = void> = (arg: TArg) => [
+    /** Category of the message */
+    MessageCategory,
+    /** Log message text */
+    string,
+    /** Log message */
+    ...unknown[]
+];
+declare type LogMessage = LogMessageSingle | LogMessageGroup;
+declare type LogMessageSingle<TID extends keyof LogMessages = keyof LogMessages> = [
     severity: Severity,
     id: TID,
     ...args: Parameters<LogMessages[TID]>
 ];
+declare type LogMessageGroup<TID extends keyof LogMessages = keyof LogMessages> = [severity: Severity, id: TID, group: 'GROUP', ...args: Parameters<LogMessages[TID]>] | [severity: Severity, id: TID, group: 'ENDGROUP'];
 declare type LogDrain = (message: LogMessage) => void;
 
+declare 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
+ */
+declare type DecayFunction = (options: DecayOptions) => boolean;
+
 declare type VisitorDataStoreOptions = {
     /** Transition storage used to transfer server or edge side execution state to the client. Unused for client side only. */
     transitionStore?: TransitionDataStore;
@@ -344,9 +458,10 @@ declare class VisitorDataStore {
 declare class ManifestInstance {
     #private;
     readonly data: ManifestV2;
-    constructor({ manifest, evaluator, }: {
+    constructor({ manifest, evaluator, onLogMessage, }: {
         manifest: ManifestV2;
         evaluator?: GroupCriteriaEvaluator;
+        onLogMessage?: (message: LogMessage) => void;
     });
     rollForControlGroup(): boolean;
     getTest(name: string): TestDefinition | undefined;
@@ -358,316 +473,6 @@ declare class ManifestInstance {
     getDimensionByKey(scoreKey: string): EnrichmentCategory | Signal | undefined;
 }
 
-/**
- * This file was auto-generated by openapi-typescript.
- * Do not make direct changes to the file.
- */
-interface paths {
-    "/api/v2/manifest": {
-        /**
-         * Fetches the Intent 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: {
-                    preview?: boolean;
-                    projectId: string;
-                };
-            };
-            responses: {
-                /** OK */
-                200: {
-                    content: {
-                        "application/json": components["schemas"]["ManifestV2"];
-                    };
-                };
-                400: external["swagger.yml"]["components"]["responses"]["BadRequestError"];
-                401: external["swagger.yml"]["components"]["responses"]["UnauthorizedError"];
-                403: external["swagger.yml"]["components"]["responses"]["ForbiddenError"];
-                /** No manifest has ever been published, and the API key does not have preview permissions */
-                404: {
-                    content: {
-                        "text/plain": string;
-                    };
-                };
-                429: external["swagger.yml"]["components"]["responses"]["RateLimitError"];
-                500: external["swagger.yml"]["components"]["responses"]["InternalServerError"];
-            };
-        };
-    };
-}
-interface components {
-    schemas: {
-        ManifestV2: {
-            project: {
-                pz?: components["schemas"]["PersonalizationManifest"];
-                /** @description A/B test settings */
-                test?: {
-                    [key: string]: external["uniform-context-types.swagger.yml"]["components"]["schemas"]["Test"];
-                };
-            };
-        };
-        PersonalizationManifest: {
-            /** @description Map of all signals defined for personalization criteria */
-            sig?: {
-                [key: string]: external["uniform-context-types.swagger.yml"]["components"]["schemas"]["Signal"];
-            };
-            /** @description Map of all enrichment categories defined for personalization criteria */
-            enr?: {
-                [key: string]: external["uniform-context-types.swagger.yml"]["components"]["schemas"]["EnrichmentCategory"];
-            };
-            /** @description Map of all aggregate dimensions (intents or audiences) defined for personalization criteria */
-            agg?: {
-                [key: string]: external["uniform-context-types.swagger.yml"]["components"]["schemas"]["AggregateDimension"];
-            };
-            /** @description Percentage of visitors that will be used as a personalization control group (not shown any personalization) */
-            control?: number;
-        };
-    };
-}
-interface external {
-    "swagger.yml": {
-        paths: {};
-        components: {
-            schemas: {
-                Error: {
-                    /** @description Error message(s) that occurred while processing the request */
-                    errorMessage?: string[] | string;
-                };
-            };
-            responses: {
-                /** Request input validation failed */
-                BadRequestError: {
-                    content: {
-                        "application/json": external["swagger.yml"]["components"]["schemas"]["Error"];
-                    };
-                };
-                /** API key or token was not valid */
-                UnauthorizedError: {
-                    content: {
-                        "application/json": external["swagger.yml"]["components"]["schemas"]["Error"];
-                    };
-                };
-                /** Permission was denied */
-                ForbiddenError: {
-                    content: {
-                        "application/json": external["swagger.yml"]["components"]["schemas"]["Error"];
-                    };
-                };
-                /** Too many requests in allowed time period */
-                RateLimitError: unknown;
-                /** Execution error occurred */
-                InternalServerError: unknown;
-            };
-        };
-        operations: {};
-    };
-    "uniform-context-types.swagger.yml": {
-        paths: {};
-        components: {
-            schemas: {
-                EnrichmentCategory: {
-                    /** @description The maximum visitor score allowed for enrichment keys in this category */
-                    cap: number;
-                };
-                PreviewSignal: external["uniform-context-types.swagger.yml"]["components"]["schemas"]["Signal"] & {
-                    /** @description Friendly name of the signal */
-                    name: string;
-                    /** @description Description of the signal */
-                    description?: string;
-                };
-                Signal: {
-                    /** @description The signal strength per activation (each time its criteria are true, this score is added) */
-                    str: number;
-                    /** @description The maximum visitor score allowed for this signal */
-                    cap: number;
-                    /**
-                     * @description How long the signal's score should persist
-                     * '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)
-                     */
-                    dur: "s" | "p" | "t";
-                    crit: external["uniform-context-types.swagger.yml"]["components"]["schemas"]["RootSignalCriteriaGroup"];
-                };
-                RootSignalCriteriaGroup: {
-                    /** @description Criteria type (Group of other criteria) */
-                    type: "G";
-                    /**
-                     * @description The logical operator to apply to the criteria groups
-                     * & = AND
-                     * | = OR
-                     *
-                     * Default is `&` if unspecified.
-                     *
-                     * @default &
-                     */
-                    op?: "&" | "|";
-                    /** @description The criteria clauses that make up this grouping of criteria */
-                    clauses: (external["uniform-context-types.swagger.yml"]["components"]["schemas"]["SignalCriteriaGroup"] | external["uniform-context-types.swagger.yml"]["components"]["schemas"]["SignalCriteria"])[];
-                };
-                SignalCriteriaGroup: {
-                    /** @description Criteria type (Group of other criteria) */
-                    type: "G";
-                    /**
-                     * @description The logical operator to apply to the criteria groups
-                     * & = AND
-                     * | = OR
-                     *
-                     * Default is `&` if unspecified.
-                     */
-                    op?: "&" | "|";
-                    /** @description The criteria clauses that make up this grouping of criteria */
-                    clauses: (external["uniform-context-types.swagger.yml"]["components"]["schemas"]["SignalCriteriaGroup"] | external["uniform-context-types.swagger.yml"]["components"]["schemas"]["SignalCriteria"])[];
-                };
-                SignalCriteria: external["uniform-context-types.swagger.yml"]["components"]["schemas"]["CookieCriteria"] | external["uniform-context-types.swagger.yml"]["components"]["schemas"]["QueryStringCriteria"] | external["uniform-context-types.swagger.yml"]["components"]["schemas"]["QuirkCriteria"] | external["uniform-context-types.swagger.yml"]["components"]["schemas"]["EventCriteria"] | external["uniform-context-types.swagger.yml"]["components"]["schemas"]["CurrentPageCriteria"] | external["uniform-context-types.swagger.yml"]["components"]["schemas"]["PageViewCountCriteria"];
-                /** @description Matches a URL query string parameter value */
-                QueryStringCriteria: {
-                    type: "QS";
-                    /** @description The name of the query string parameter to match */
-                    queryName: string;
-                    /** @description The value to match the query string parameter against */
-                    match: external["uniform-context-types.swagger.yml"]["components"]["schemas"]["StringMatch"];
-                };
-                /** @description Matches a web cookie value */
-                CookieCriteria: {
-                    type: "CK";
-                    /** @description The name of the cookie to match */
-                    cookieName: string;
-                    /** @description The value to match the cookie against */
-                    match: external["uniform-context-types.swagger.yml"]["components"]["schemas"]["StringMatch"];
-                };
-                /** @description Matches a visitor quirk key and value */
-                QuirkCriteria: {
-                    type: "QK";
-                    /** @description The name of the quirk key to match */
-                    key: string;
-                    /** @description The quirk value to match against */
-                    match: external["uniform-context-types.swagger.yml"]["components"]["schemas"]["StringMatch"];
-                };
-                /** @description Matches an analytics event name being fired */
-                EventCriteria: {
-                    type: "EVT";
-                    /** @description How to match the event name */
-                    event: external["uniform-context-types.swagger.yml"]["components"]["schemas"]["StringMatch"];
-                };
-                /**
-                 * @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: {
-                    type: "PV";
-                    /** @description The page/route path to match as a page that has been visited */
-                    path: external["uniform-context-types.swagger.yml"]["components"]["schemas"]["StringMatch"];
-                };
-                PageViewCountCriteria: {
-                    type: "PVC";
-                    /** @description The expression to match the page view count against */
-                    match: external["uniform-context-types.swagger.yml"]["components"]["schemas"]["NumberMatch"];
-                };
-                /** @description Describes a match expression on a string */
-                StringMatch: {
-                    /** @description The right hand side of the match expression */
-                    rhs: string;
-                    /**
-                     * @description The match operator
-                     * '=' = exact match
-                     * '~' = contains match
-                     * '//' = regular expression match
-                     *
-                     * Any of the above can be prefixed with '!' to invert the match (i.e. != for 'not an exact match')
-                     */
-                    op: "=" | "~" | "//" | "!=" | "!~" | "!//";
-                    /** @description The case sensitivity of the match. Defaults to false if unspecified. */
-                    cs?: boolean;
-                } | {
-                    /**
-                     * @description The type of match to perform
-                     * '*' = exists with any value
-                     * '!*' = does not exist
-                     */
-                    op: "*" | "!*";
-                };
-                /** @description Describes a match expression on a number */
-                NumberMatch: {
-                    /** @description The right hand side of the match expression */
-                    rhs: number;
-                    /**
-                     * @description The type of match to perform
-                     * '=' = exact match
-                     * '!=' = not an exact match
-                     * '<' = less than match expression
-                     * '>' = greater than match expression
-                     */
-                    op: "=" | "<" | ">" | "!=";
-                };
-                /** @description Defines an aggregate dimension that is a grouping of other dimensions' scores; an intent or audience. */
-                AggregateDimension: {
-                    /** @description Input dimensions to the aggregate dimension */
-                    inputs: external["uniform-context-types.swagger.yml"]["components"]["schemas"]["AggregateDimensionInput"][];
-                };
-                /** @description Defines an input dimension to an aggregate dimension */
-                AggregateDimensionInput: {
-                    /**
-                     * @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.
-                     *
-                     * '+' = add to the final score
-                     * '-' = subtract from the final score
-                     * 'c' = clear the final score (if the input dimension has any score at all, this aggreate will have no score regardless of other inputs)
-                     *
-                     * Default if unspecified: '+'
-                     *
-                     * @default +
-                     */
-                    sign?: "+" | "-" | "c";
-                };
-                Test: {
-                    /** @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;
-                };
-            };
-        };
-        operations: {};
-    };
-}
-
-declare type SharedTypes = external['uniform-context-types.swagger.yml']['components']['schemas'];
-declare type ManifestV2 = components['schemas']['ManifestV2'];
-declare type PersonalizationManifest = components['schemas']['PersonalizationManifest'];
-declare type Signal = SharedTypes['Signal'];
-declare type SignalCriteriaGroup = SharedTypes['SignalCriteriaGroup'];
-declare type SignalCriteria = SharedTypes['SignalCriteria'];
-declare type EnrichmentCategory = SharedTypes['EnrichmentCategory'];
-declare type StringMatch = SharedTypes['StringMatch'];
-declare type NumberMatch = SharedTypes['NumberMatch'];
-declare type TestDefinition = SharedTypes['Test'];
-declare type AggregateDimension = SharedTypes['AggregateDimension'];
-declare type AggregateDimensionInput = SharedTypes['AggregateDimensionInput'];
-
-/**
- * A type that evaluates a signal criteria type and
- * decides if it matches the current Context state or not.
- * @returns {boolean} - true for a match, false for no match
- * */
-declare type CriteriaEvaluator = (update: ContextStateUpdate, criteria: SignalCriteria, commands: StorageCommands[], signal: Signal, dimension: string) => boolean;
-
-declare class GroupCriteriaEvaluator {
-    #private;
-    constructor(criteriaEvaluators: Record<string, CriteriaEvaluator>);
-    evaluate(update: ContextStateUpdate, crit: SignalCriteriaGroup, commands: StorageCommands[], signal: Signal, dimension: string): boolean;
-}
-
 /** Content that is tagged for adding enrichment score when triggered by behavior (i.e. being shown that content) */
 declare type BehaviorTag = {
     beh?: EnrichmentData[];
@@ -707,39 +512,6 @@ declare type TestResult<TVariant> = {
      */
     variantAssigned: boolean;
 };
-/** Defines the shape of arbitrarily tagged content where the tag can be for a test, behaviour, or personalization */
-declare type TaggedContent = PersonalizedVariant & TestVariant & BehaviorTag & {
-    /** @deprecated no longer used */
-    intents?: IntentTagVector;
-};
-/**
- * A vector keyed by intent ID which contains magnitude and configuration data for each intent ID that has been tagged
- * @deprecated no longer used
- */
-declare type IntentTagVector = Record<string, IntentTagAxis>;
-/**
- * An individual intent tag magnitude value in an IntentTagVector
- * @deprecated no longer used
- */
-interface IntentTagAxis {
-    /** If this is true, don't use this intent tag when calculating personalization. If false or unspecified, personalization is allowed. */
-    noPn?: boolean;
-    /** If this is true, don't use this intent tag when calculating behavior. If false or unspecified, behavior is allowed. */
-    noBeh?: boolean;
-    /**
-     * If this is true, ANY strength in the tagged intent will result in selecting this variant to personalize,
-     * regardless of other intents' strengths. If more than one tag is override,
-     * they are sorted normally.
-     */
-    override?: boolean;
-    /**
-     * Sets the minimum visitor score required to trigger this variation.
-     * If more than one intent tag matches, the one with the highest threshold will win.
-     */
-    threshold?: number;
-    /** Strength of the intent tag. If unspecified, IntentTagStrength.Normal should be inferred */
-    str?: number | string;
-}
 
 declare type PersonalizeOptions<TVariant> = {
     /** Name of placement (sent to analytics) */
@@ -748,8 +520,9 @@ declare type PersonalizeOptions<TVariant> = {
     variations: Iterable<TVariant>;
     /** Maximum number of variants to place (default: 1) */
     take?: number;
+    onLogMessage?: (message: LogMessage) => void;
 };
-declare function personalizeVariations<TVariant extends PersonalizedVariant>({ context, variations, take, }: PersonalizeOptions<TVariant> & {
+declare function personalizeVariations<TVariant extends PersonalizedVariant>({ name, context, variations, take, onLogMessage, }: PersonalizeOptions<TVariant> & {
     context: Context;
 }): PersonalizedResult<TVariant>;
 
@@ -806,8 +579,9 @@ declare type TestOptions<TVariant extends TestVariant> = {
     /** Variations that are being tested. */
     variations: TVariant[];
 };
-declare const testVariations: <TVariant extends TestVariant>({ name, context, variations, }: TestOptions<TVariant> & {
+declare const testVariations: <TVariant extends TestVariant>({ name, context, variations, onLogMessage, }: TestOptions<TVariant> & {
     context: Context;
+    onLogMessage?: ((message: LogMessage) => void) | undefined;
 }) => TestResult<TVariant>;
 
 /**
@@ -876,7 +650,7 @@ declare type ContextEvents = {
      * Note that event handlers attached to this event will not catch events
      * logged during initialisation of the Context unless they are attached as plugins to the constructor.
      */
-    log: LogMessage;
+    log: LogMessage | LogMessageGroup;
     /** Test variant has been selected */
     testResult: TestEvent;
     /** Personalization variants have been selected */
@@ -901,8 +675,19 @@ declare class Context implements Context {
         };
     };
     readonly storage: VisitorDataStore;
+    /**
+     * Updates the Context with new data of any sort, such as
+     * new URLs, cookies, quirks, and enrichments.
+     *
+     * Only properties that are set in the data parameter will be updated.
+     * Properties that do not result in a changed state,
+     * i.e. pushing the same URL or cookies as before,
+     * will NOT result in a recomputation of signal state.
+     */
     update(newData: Partial<ContextState>): Promise<void>;
+    /** use test() instead */
     getTestVariantId(testName: string): string | null | undefined;
+    /** use test() instead */
     setTestVariantId(testName: string, variantId: string): void;
     /**
      * Writes a message to the Context log sink.
@@ -984,4 +769,4 @@ declare global {
     }
 }
 
-export { Severity as $, AggregateDimension as A, VisitorDataStoreOptions as B, CookieAdapter as C, DecayFunction as D, EnrichmentCategory as E, VisitorDataStoreEvents as F, GroupCriteriaEvaluator as G, VisitorDataStore as H, IdentifyCommand as I, ServerToClientTransitionState as J, SERVER_STATE_ID as K, LogDrain as L, ManifestInstance as M, NumberMatch as N, OutputSeverity as O, PersonalizationManifest as P, Quirks as Q, TransitionDataStoreEvents as R, StorageCommands as S, TransitionDataStore as T, ContextOptions as U, VisitorData as V, PersonalizationEvent as W, TestEvent as X, ContextEvents as Y, Context as Z, LogMessages as _, TransitionDataStoreOptions as a, MessageFunc as a0, LogMessage as a1, testVariations as a2, TestOptions as a3, PersonalizeOptions as a4, personalizeVariations as a5, DimensionMatch as a6, BehaviorTag as a7, PersonalizedVariant as a8, PersonalizedResult as a9, TestVariant as aa, TestResult as ab, TaggedContent as ac, DevToolsUiVersion as ad, DevToolsState as ae, DevToolsActions as af, DevToolsEvent as ag, DevToolsEvents as ah, DevToolsLogEvent as ai, DevToolsDataEvent as aj, DevToolsHelloEvent as ak, DevToolsUpdateEvent as al, DevToolsRawCommandsEvent as am, DevToolsForgetEvent as an, paths as ao, ContextPlugin as b, CriteriaEvaluator as c, StringMatch as d, ScoreVector as e, VariantMatchCriteria as f, ManifestV2 as g, Signal as h, SignalCriteriaGroup as i, SignalCriteria as j, TestDefinition as k, AggregateDimensionInput as l, Tests as m, EnrichmentData as n, EventData as o, emptyVisitorData as p, ContextState as q, ContextStateUpdate as r, StorageCommand as s, ModifyScoreCommand as t, ModifySessionScoreCommand as u, SetConsentCommand as v, SetQuirkCommand as w, SetTestCommand as x, SetControlGroupCommand as y, DecayOptions as z };
+export { ContextEvents as $, AggregateDimension as A, SetTestCommand as B, ContextPlugin as C, DecayFunction as D, EnrichmentCategory as E, SetControlGroupCommand as F, GroupCriteriaEvaluator as G, DecayOptions as H, IdentifyCommand as I, VisitorDataStoreOptions as J, VisitorDataStoreEvents as K, LogDrain as L, ManifestInstance as M, NumberMatch as N, OutputSeverity as O, PersonalizationManifest as P, Quirks as Q, VisitorDataStore as R, StorageCommands as S, TransitionDataStore as T, ServerToClientTransitionState as U, VisitorData as V, SERVER_STATE_ID as W, TransitionDataStoreEvents as X, ContextOptions as Y, PersonalizationEvent as Z, TestEvent as _, TransitionDataStoreOptions as a, Context as a0, LogMessages as a1, Severity as a2, MessageCategory as a3, MessageFunc as a4, LogMessageSingle as a5, LogMessageGroup as a6, testVariations as a7, TestOptions as a8, PersonalizeOptions as a9, personalizeVariations as aa, DimensionMatch as ab, BehaviorTag as ac, PersonalizedVariant as ad, PersonalizedResult as ae, TestVariant as af, TestResult as ag, DevToolsUiVersion as ah, DevToolsState as ai, DevToolsActions as aj, DevToolsEvent as ak, DevToolsEvents as al, DevToolsLogEvent as am, DevToolsDataEvent as an, DevToolsHelloEvent as ao, DevToolsUpdateEvent as ap, DevToolsRawCommandsEvent as aq, DevToolsForgetEvent as ar, CriteriaEvaluator as b, StringMatch as c, ScoreVector as d, VariantMatchCriteria as e, LogMessage as f, ManifestV2 as g, Signal as h, SignalCriteriaGroup as i, SignalCriteria as j, TestDefinition as k, AggregateDimensionInput as l, CriteriaEvaluatorResult as m, CriteriaEvaluatorParameters as n, SignalData as o, Tests as p, EnrichmentData as q, EventData as r, emptyVisitorData as s, ContextState as t, ContextStateUpdate as u, StorageCommand as v, ModifyScoreCommand as w, ModifySessionScoreCommand as x, SetConsentCommand as y, SetQuirkCommand as z };