@revturbine/sdk 0.7.8 → 0.7.10

package/dist/optimizely.d.ts

@@ -0,0 +1,416 @@
+import { Client, UserAttributes } from '@optimizely/optimizely-sdk';
+import { toJSONSchema, JSONSchemaMeta } from 'zod/v4/core';
+import { z } from 'zod';
+
+type OverrideParameters = Parameters<NonNullable<NonNullable<Parameters<typeof toJSONSchema>[1]>['override']>>[0];
+type OverrideSchemaParameters = Omit<OverrideParameters, 'zodSchema'>;
+type IExtensionType = any;
+type ISpecificationExtension = {
+  [extensionName: IExtensionName]: IExtensionType;
+};
+interface ExternalDocumentationObject extends ISpecificationExtension {
+  description?: string;
+  url: string;
+}
+type ParameterLocation = 'query' | 'header' | 'path' | 'cookie';
+type ParameterStyle = 'matrix' | 'label' | 'form' | 'simple' | 'spaceDelimited' | 'pipeDelimited' | 'deepObject';
+interface BaseParameterObject extends ISpecificationExtension {
+  description?: string;
+  required?: boolean;
+  deprecated?: boolean;
+  allowEmptyValue?: boolean;
+  style?: ParameterStyle;
+  explode?: boolean;
+  allowReserved?: boolean;
+  schema?: SchemaObject | ReferenceObject;
+  examples?: {
+    [param: string]: ExampleObject | ReferenceObject;
+  };
+  example?: any;
+  content?: ContentObject;
+}
+interface ParameterObject extends BaseParameterObject {
+  name: string;
+  in: ParameterLocation;
+}
+interface ContentObject {
+  [mediatype: string]: MediaTypeObject;
+}
+interface MediaTypeObject extends ISpecificationExtension {
+  schema?: SchemaObject | ReferenceObject;
+  examples?: ExamplesObject;
+  example?: any;
+  encoding?: EncodingObject;
+}
+interface EncodingObject extends ISpecificationExtension {
+  [property: string]: EncodingPropertyObject | any;
+}
+interface EncodingPropertyObject {
+  contentType?: string;
+  headers?: {
+    [key: string]: HeaderObject | ReferenceObject;
+  };
+  style?: string;
+  explode?: boolean;
+  allowReserved?: boolean;
+  [key: string]: any;
+}
+interface ExampleObject {
+  summary?: string;
+  description?: string;
+  value?: any;
+  externalValue?: string;
+  [property: string]: any;
+}
+interface HeaderObject extends BaseParameterObject {
+  $ref?: string;
+}
+interface ExamplesObject {
+  [name: string]: ExampleObject | ReferenceObject;
+}
+interface ReferenceObject {
+  $ref: string;
+  summary?: string;
+  description?: string;
+}
+type SchemaObjectType = 'integer' | 'number' | 'string' | 'boolean' | 'object' | 'null' | 'array';
+interface SchemaObject extends ISpecificationExtension {
+  $ref?: string;
+  discriminator?: DiscriminatorObject;
+  readOnly?: boolean;
+  writeOnly?: boolean;
+  xml?: XmlObject;
+  externalDocs?: ExternalDocumentationObject;
+  example?: any;
+  examples?: any[];
+  deprecated?: boolean;
+  type?: SchemaObjectType | SchemaObjectType[];
+  format?: 'int32' | 'int64' | 'float' | 'double' | 'byte' | 'binary' | 'date' | 'date-time' | 'password' | string;
+  allOf?: (SchemaObject | ReferenceObject)[];
+  oneOf?: (SchemaObject | ReferenceObject)[];
+  anyOf?: (SchemaObject | ReferenceObject)[];
+  not?: SchemaObject | ReferenceObject;
+  items?: SchemaObject | ReferenceObject;
+  properties?: {
+    [propertyName: string]: SchemaObject | ReferenceObject;
+  };
+  additionalProperties?: SchemaObject | ReferenceObject | boolean;
+  propertyNames?: SchemaObject | ReferenceObject;
+  description?: string;
+  default?: any;
+  title?: string;
+  multipleOf?: number;
+  maximum?: number;
+  const?: any;
+  exclusiveMaximum?: number;
+  minimum?: number;
+  exclusiveMinimum?: number;
+  maxLength?: number;
+  minLength?: number;
+  pattern?: string;
+  maxItems?: number;
+  minItems?: number;
+  uniqueItems?: boolean;
+  maxProperties?: number;
+  minProperties?: number;
+  required?: string[];
+  enum?: any[];
+  prefixItems?: (SchemaObject | ReferenceObject)[];
+  contentMediaType?: string;
+  contentEncoding?: string;
+}
+interface DiscriminatorObject {
+  propertyName: string;
+  mapping?: {
+    [key: string]: string;
+  };
+}
+interface XmlObject extends ISpecificationExtension {
+  name?: string;
+  namespace?: string;
+  prefix?: string;
+  attribute?: boolean;
+  wrapped?: boolean;
+}
+type ZodOpenApiOverrideMetaContext = OverrideSchemaParameters;
+type ZodOpenApiOverrideMeta = (ctx: ZodOpenApiOverrideMetaContext) => void;
+interface ZodOpenApiBaseMetadata {
+  /**
+   * Used to set metadata for a parameter
+   */
+  param?: Partial<ParameterObject> & {
+    /**
+     * Used to output this Zod Schema in the components parameters section. Any usage of this Zod Schema will then be transformed into a $ref.
+     */
+    id?: string;
+  };
+  /**
+   * Used to set metadata for a response header
+   */
+  header?: Partial<HeaderObject> & {
+    /**
+     * Used to output this Zod Schema in the components headers section. Any usage of this Zod Schema will then be transformed into a $ref.
+     */
+    id?: string;
+  };
+  /**
+   * Use to override the rendered schema
+   */
+  override?: SchemaObject | ZodOpenApiOverrideMeta;
+  /**
+   * For use only if this Zod Schema is manually registered in the `components` section
+   * and is not used anywhere else in the document.
+   * Defaults to `output` if not specified.
+   */
+  unusedIO?: 'input' | 'output';
+  /**
+   * An alternate id to use for this schema in the event a registered schema is used in both a request and response schema.
+   * If not specified, the id will be simply derived as the id of the schema plus an `Output` suffix. Please note that `id` must be set.
+   */
+  outputId?: string;
+}
+interface ZodOpenApiMetadata extends ZodOpenApiBaseMetadata, JSONSchemaMeta {
+  examples?: unknown[];
+  /**
+   * @deprecated - Use `examples` instead.
+   * Use of `example` is discouraged, and later versions of OpenAPI specification may remove it.
+   */
+  example?: unknown;
+}
+declare module 'zod/v4' {
+  interface GlobalMeta extends ZodOpenApiMetadata {}
+}
+
+/**
+ * User schemas — Zod definitions for user context, trial status, and usage.
+ *
+ * These are external/SDK-facing types that describe an identified user's
+ * current state (plan, entitlements, usage, personalization tokens).
+ */
+
+/** A single usage entry derived from a credits / usage_limit entitlement. */
+declare const UserUsageEntrySchema: z.ZodObject<{
+    entitlement_handle: z.ZodString;
+    unit: z.ZodString;
+    amount: z.ZodNumber;
+    limit: z.ZodOptional<z.ZodNumber>;
+    reset_date: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Plan context for the identified user (plan 191 Q-1 amendment): `handle` is
+ * the plan's `unique_handle` — the same matching identity as the flat
+ * top-level `plan_handle` — renamed from `id`, which in practice was always
+ * populated with the handle anyway. There is no `id` in plan context.
+ */
+declare const UserPlanContextSchema: z.ZodObject<{
+    handle: z.ZodString;
+    name: z.ZodString;
+    price: z.ZodOptional<z.ZodString>;
+    billing_period: z.ZodOptional<z.ZodEnum<{
+        monthly: "monthly";
+        annual: "annual";
+        none: "none";
+    }>>;
+}, z.core.$strip>;
+
+// AUTO-GENERATED by scripts/generate-zod-outputs.ts - do not edit.
+
+
+type UserPlanContext = z.infer<typeof UserPlanContextSchema>;
+type UserUsageEntry = z.infer<typeof UserUsageEntrySchema>;
+
+/**
+ * Pure utility functions extracted from web-sdk/customer-side.ts.
+ *
+ * No side effects, no browser APIs, no `this` — just transforms.
+ */
+
+/** JSON-serializable value for SDK data bags. */
+type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+
+/**
+ * User context lifecycle — pure functions for building, merging,
+ * and deriving targeting state from user context + RevTurbineConfig.
+ */
+
+/** SDK-facing user context (widened for customer convenience). */
+interface UserContextSnapshot {
+    id?: string;
+    /**
+     * THE plan matching identity — the plan's `unique_handle` (plan 191 Q-1).
+     * Rule targets, segment plan predicates, and plan resolution match on this
+     * value alone.
+     */
+    plan_handle?: string;
+    /**
+     * The plan as a bare handle string, or as `{ handle, name, … }` (plan 191
+     * Q-1 amendment — the object's identity symbol is `handle`; there is no
+     * `id` in plan context). Both shapes carry the same matching identity as
+     * the flat `plan_handle` above, which wins when both are set.
+     */
+    plan?: string | UserPlanContext;
+    custom?: Record<string, JsonValue>;
+    entitlements?: Record<string, boolean>;
+    usage?: Record<string, UserUsageEntry>;
+    personalization?: Record<string, JsonValue>;
+    /** Canonical experiment-handle to variant-handle assignments. */
+    experiments?: Record<string, string>;
+}
+
+/**
+ * Trait namespace — allows multiple trait-contributing providers to register
+ * under `traits:<namespace>` and merge into the unified traits bag.
+ *
+ * SDK built-ins: `'traits:trial'`, `'traits:usage'`.
+ * Customers can register any namespace (e.g. `'traits:permissions'`,
+ * `'traits:feature_flags'`).
+ */
+type TraitsNamespace = `traits:${string}`;
+/**
+ * Domain names recognized by the SDK provider registry.
+ * Each domain maps to a specific decision-engine input primitive.
+ *
+ * The `traits` domain and any `traits:<namespace>` domain are merged
+ * into a single `traits` slot in `ResolvedProviderContext`.
+ */
+type DomainProviderName = 'plan' | 'entitlements' | 'segments' | 'experiments' | 'content' | 'rules' | 'traits' | 'theme' | 'events' | 'cta' | TraitsNamespace;
+/** Immutable inputs available while resolving a domain provider. */
+interface DomainProviderResolutionInput {
+    /** Current caller-supplied and trusted server-enriched context snapshot. */
+    readonly userContext: Readonly<UserContextSnapshot>;
+    /** Changes whenever identity or user context changes. */
+    readonly contextRevision: string;
+    /** Aborted when this resolution is no longer valid for the current identity. */
+    readonly signal: AbortSignal;
+}
+/**
+ * Base interface all domain providers implement.
+ *
+ * A domain provider supplies a named slice of the decision-engine's input:
+ * current plan, entitlement state, user segments, marketing content, rules,
+ * or custom traits.
+ */
+interface DomainProvider<D extends DomainProviderName = DomainProviderName, T = unknown> {
+    /** Provider domain name — used as the registry key. */
+    readonly domain: D;
+    /**
+     * Resolve the current value. Called before placement decisions.
+     * May be async (e.g. reading from a database or API).
+     */
+    resolve(input?: DomainProviderResolutionInput): T | Promise<T>;
+    /**
+     * Optional: subscribe to changes (enables push-based invalidation).
+     * Returns an unsubscribe function.
+     */
+    subscribe?(listener: (next: T) => void): () => void;
+    /** Cache TTL in ms. 0 = re-resolve every call (default). */
+    cacheTtlMs?: number;
+    /** Customer-controlled revision used to invalidate cached provider output. */
+    readonly providerRevision?: string | number;
+}
+/**
+ * The user's experiment assignments, keyed by **experiment handle** with the
+ * assigned **variant handle** as the value (plan 183).
+ *
+ * Handles on both sides, deliberately: a handle is the canonical, version-stable
+ * identifier, which is what a `Segment.experiment_handle` match and an analytics
+ * grouping must key on. The version id — which *definition* of the experiment
+ * was live — travels separately in telemetry, never as the match key.
+ *
+ * A map because a user can be enrolled in several experiments at once. Absent or
+ * empty means enrolled in nothing, which is distinct from "assigned to control".
+ */
+interface ExperimentProviderState {
+    /** `{ [experimentHandle]: variantHandle }`. */
+    assignments: Record<string, string>;
+    /** Structured outcomes keyed by experiment handle, when supplied by the provider. */
+    selections?: Record<string, ExperimentVariantSelection>;
+}
+/** Named reasons for a provider not returning an assignment. */
+type ExperimentVariantNonAssignmentReason = 'not_enrolled' | 'provider_not_ready' | 'provider_unavailable' | 'provider_error' | 'timeout' | 'aborted' | 'unknown_variant' | 'invalid_handle' | 'mapping_missing' | 'provider_missing' | 'ownership_conflict' | 'assignment_conflict';
+/**
+ * Normalized result returned for one canonical experiment handle.
+ * Missing and failed vendor values remain explicit and never become control.
+ */
+type ExperimentVariantSelection = {
+    status: 'assigned';
+    experimentHandle: string;
+    variantHandle: string;
+    providerHandle?: string;
+    providerRevision?: string | number;
+} | {
+    status: 'not_assigned' | 'unavailable' | 'unsupported';
+    experimentHandle: string;
+    reason: ExperimentVariantNonAssignmentReason;
+    providerHandle?: string;
+    providerRevision?: string | number;
+};
+/**
+ * Supplies experiment enrollment and variant assignment.
+ *
+ * The binding declares whether RevTurbine manages the desired allocation or an
+ * external provider is authoritative. Both modes satisfy this one interface,
+ * so segment matching, decisions and telemetry never need to know which
+ * produced a value.
+ */
+interface ExperimentAssignmentProvider extends DomainProvider<'experiments', ExperimentProviderState> {
+    readonly domain: 'experiments';
+    /** Stable diagnostic identifier; vendor credentials never belong here. */
+    readonly providerHandle?: string;
+    /** Canonical RevTurbine experiment handles this provider owns. */
+    readonly ownedExperimentHandles?: readonly string[];
+}
+
+/**
+ * Optimizely-backed experiment assignment provider.
+ *
+ * The customer injects an initialized client. The adapter contains no SDK
+ * credentials and is shipped only from the optional Optimizely entry point.
+ */
+
+/** One RevTurbine experiment handle mapped to an Optimizely experiment key. */
+interface OptimizelyExperimentBinding {
+    /** Stable RevTurbine experiment handle used by decisions and telemetry. */
+    experimentHandle: string;
+    /** Experiment key configured in the customer-owned Optimizely project. */
+    experimentKey: string;
+    /** Optional allowlist that rejects unexpected Optimizely variation keys. */
+    allowedVariants?: readonly string[];
+}
+/** Options for the separately bundled Optimizely assignment adapter. */
+interface OptimizelyExperimentAssignmentOptions {
+    /** An initialized customer-owned Optimizely client. */
+    client: Pick<Client, 'getVariation'>;
+    /** Explicit experiment mappings; no naming convention is assumed. */
+    bindings: readonly OptimizelyExperimentBinding[];
+    /** Override how the Optimizely user id is derived from current context. */
+    userId?: (input: DomainProviderResolutionInput) => string | undefined;
+    /** Optional customer-owned Optimizely attributes for audience evaluation. */
+    attributes?: (input: DomainProviderResolutionInput) => UserAttributes | undefined;
+    /** Customer-controlled revision for Optimizely datafile/context changes. */
+    providerRevision?: string | number;
+}
+/** Machine-readable reasons an Optimizely assignment cannot be normalized. */
+type OptimizelyAssignmentErrorReason = 'duplicate_experiment_handle' | 'invalid_binding' | 'unexpected_variant';
+/** Raised for invalid Optimizely mappings or variation values. */
+declare class OptimizelyAssignmentError extends Error {
+    /** Stable reason suitable for diagnostics and structured SDK outcomes. */
+    readonly reason: OptimizelyAssignmentErrorReason;
+    /** RevTurbine experiment whose mapping failed. */
+    readonly experimentHandle: string;
+    /** Optimizely experiment key used for lookup. */
+    readonly experimentKey: string;
+    /** Construct a named Optimizely normalization failure. */
+    constructor(reason: OptimizelyAssignmentErrorReason, binding: OptimizelyExperimentBinding, detail: string);
+}
+/**
+ * Create an assignment provider backed by an initialized Optimizely client.
+ * A null variation is retained as explicit non-enrollment and never converted
+ * to a control assignment.
+ */
+declare function createOptimizelyExperimentAssignmentProvider(options: OptimizelyExperimentAssignmentOptions): ExperimentAssignmentProvider;
+
+export { OptimizelyAssignmentError, createOptimizelyExperimentAssignmentProvider };
+export type { OptimizelyAssignmentErrorReason, OptimizelyExperimentAssignmentOptions, OptimizelyExperimentBinding };

package/dist/optimizely.js

@@ -0,0 +1,2 @@
+var m=Object.defineProperty;var x=(e,i,n)=>i in e?m(e,i,{enumerable:true,configurable:true,writable:true,value:n}):e[i]=n;var p=(e,i,n)=>x(e,typeof i!="symbol"?i+"":i,n);var s=class extends Error{constructor(n,t,d){super(`Optimizely assignment for experiment "${t.experimentHandle}" (experiment key "${t.experimentKey}") failed: ${d}`);p(this,"reason");p(this,"experimentHandle");p(this,"experimentKey");this.name="OptimizelyAssignmentError",this.reason=n,this.experimentHandle=t.experimentHandle,this.experimentKey=t.experimentKey;}};function v(e){let i=new Set;for(let n of e){if(!n.experimentHandle.trim()||!n.experimentKey.trim())throw new s("invalid_binding",n,"experiment handles and Optimizely keys must be non-empty");if(i.has(n.experimentHandle))throw new s("duplicate_experiment_handle",n,"the experiment handle is mapped more than once");i.add(n.experimentHandle);}}function u(e){return v(e.bindings),{domain:"experiments",providerHandle:"optimizely",providerRevision:e.providerRevision,ownedExperimentHandles:e.bindings.map(i=>i.experimentHandle),resolve(i){let n=new AbortController,t=i??{userContext:{},contextRevision:"legacy",signal:n.signal},d=e.userId?.(t)??t.userContext.id,l={},a={};for(let r of e.bindings){if(!d){a[r.experimentHandle]={status:"unavailable",experimentHandle:r.experimentHandle,reason:"provider_not_ready",providerHandle:"optimizely",...e.providerRevision!==void 0?{providerRevision:e.providerRevision}:{}};continue}let o=e.client.getVariation(r.experimentKey,d,e.attributes?.(t));if(o===null||o.length===0){a[r.experimentHandle]={status:"not_assigned",experimentHandle:r.experimentHandle,reason:"not_enrolled",providerHandle:"optimizely",...e.providerRevision!==void 0?{providerRevision:e.providerRevision}:{}};continue}if(r.allowedVariants&&!r.allowedVariants.includes(o))throw new s("unexpected_variant",r,`variant "${o}" is outside the configured allowlist`);l[r.experimentHandle]=o,a[r.experimentHandle]={status:"assigned",experimentHandle:r.experimentHandle,variantHandle:o,providerHandle:"optimizely",...e.providerRevision!==void 0?{providerRevision:e.providerRevision}:{}};}return {assignments:l,selections:a}}}}export{s as OptimizelyAssignmentError,u as createOptimizelyExperimentAssignmentProvider};//# sourceMappingURL=optimizely.js.map
+//# sourceMappingURL=optimizely.js.map

package/dist/optimizely.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../providers/optimizely-experiment-provider.ts"],"names":["OptimizelyAssignmentError","reason","binding","detail","__publicField","validateBindings","bindings","handles","createOptimizelyExperimentAssignmentProvider","options","input","fallbackController","resolutionInput","userId","assignments","selections","variant"],"mappings":"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","file":"optimizely.js","sourcesContent":["/**\n * Optimizely-backed experiment assignment provider.\n *\n * The customer injects an initialized client. The adapter contains no SDK\n * credentials and is shipped only from the optional Optimizely entry point.\n */\nimport type { Client, UserAttributes } from '@optimizely/optimizely-sdk';\nimport type {\n  DomainProviderResolutionInput,\n  ExperimentAssignmentProvider,\n  ExperimentProviderState,\n} from '@revt-eng/core';\n\n/** One RevTurbine experiment handle mapped to an Optimizely experiment key. */\nexport interface OptimizelyExperimentBinding {\n  /** Stable RevTurbine experiment handle used by decisions and telemetry. */\n  experimentHandle: string;\n  /** Experiment key configured in the customer-owned Optimizely project. */\n  experimentKey: string;\n  /** Optional allowlist that rejects unexpected Optimizely variation keys. */\n  allowedVariants?: readonly string[];\n}\n\n/** Options for the separately bundled Optimizely assignment adapter. */\nexport interface OptimizelyExperimentAssignmentOptions {\n  /** An initialized customer-owned Optimizely client. */\n  client: Pick<Client, 'getVariation'>;\n  /** Explicit experiment mappings; no naming convention is assumed. */\n  bindings: readonly OptimizelyExperimentBinding[];\n  /** Override how the Optimizely user id is derived from current context. */\n  userId?: (input: DomainProviderResolutionInput) => string | undefined;\n  /** Optional customer-owned Optimizely attributes for audience evaluation. */\n  attributes?: (input: DomainProviderResolutionInput) => UserAttributes | undefined;\n  /** Customer-controlled revision for Optimizely datafile/context changes. */\n  providerRevision?: string | number;\n}\n\n/** Machine-readable reasons an Optimizely assignment cannot be normalized. */\nexport type OptimizelyAssignmentErrorReason =\n  | 'duplicate_experiment_handle'\n  | 'invalid_binding'\n  | 'unexpected_variant';\n\n/** Raised for invalid Optimizely mappings or variation values. */\nexport class OptimizelyAssignmentError extends Error {\n  /** Stable reason suitable for diagnostics and structured SDK outcomes. */\n  readonly reason: OptimizelyAssignmentErrorReason;\n  /** RevTurbine experiment whose mapping failed. */\n  readonly experimentHandle: string;\n  /** Optimizely experiment key used for lookup. */\n  readonly experimentKey: string;\n\n  /** Construct a named Optimizely normalization failure. */\n  constructor(\n    reason: OptimizelyAssignmentErrorReason,\n    binding: OptimizelyExperimentBinding,\n    detail: string,\n  ) {\n    super(\n      `Optimizely assignment for experiment \"${binding.experimentHandle}\" `\n      + `(experiment key \"${binding.experimentKey}\") failed: ${detail}`,\n    );\n    this.name = 'OptimizelyAssignmentError';\n    this.reason = reason;\n    this.experimentHandle = binding.experimentHandle;\n    this.experimentKey = binding.experimentKey;\n  }\n}\n\nfunction validateBindings(bindings: readonly OptimizelyExperimentBinding[]): void {\n  const handles = new Set<string>();\n  for (const binding of bindings) {\n    if (!binding.experimentHandle.trim() || !binding.experimentKey.trim()) {\n      throw new OptimizelyAssignmentError(\n        'invalid_binding',\n        binding,\n        'experiment handles and Optimizely keys must be non-empty',\n      );\n    }\n    if (handles.has(binding.experimentHandle)) {\n      throw new OptimizelyAssignmentError(\n        'duplicate_experiment_handle',\n        binding,\n        'the experiment handle is mapped more than once',\n      );\n    }\n    handles.add(binding.experimentHandle);\n  }\n}\n\n/**\n * Create an assignment provider backed by an initialized Optimizely client.\n * A null variation is retained as explicit non-enrollment and never converted\n * to a control assignment.\n */\nexport function createOptimizelyExperimentAssignmentProvider(\n  options: OptimizelyExperimentAssignmentOptions,\n): ExperimentAssignmentProvider {\n  validateBindings(options.bindings);\n\n  return {\n    domain: 'experiments',\n    providerHandle: 'optimizely',\n    providerRevision: options.providerRevision,\n    ownedExperimentHandles: options.bindings.map((binding) => binding.experimentHandle),\n    resolve(input?: DomainProviderResolutionInput): ExperimentProviderState {\n      const fallbackController = new AbortController();\n      const resolutionInput = input ?? {\n        userContext: {},\n        contextRevision: 'legacy',\n        signal: fallbackController.signal,\n      };\n      const userId = options.userId?.(resolutionInput) ?? resolutionInput.userContext.id;\n      const assignments: Record<string, string> = {};\n      const selections: NonNullable<ExperimentProviderState['selections']> = {};\n\n      for (const binding of options.bindings) {\n        if (!userId) {\n          selections[binding.experimentHandle] = {\n            status: 'unavailable',\n            experimentHandle: binding.experimentHandle,\n            reason: 'provider_not_ready',\n            providerHandle: 'optimizely',\n            ...(options.providerRevision !== undefined\n              ? { providerRevision: options.providerRevision }\n              : {}),\n          };\n          continue;\n        }\n\n        const variant = options.client.getVariation(\n          binding.experimentKey,\n          userId,\n          options.attributes?.(resolutionInput),\n        );\n        if (variant === null || variant.length === 0) {\n          selections[binding.experimentHandle] = {\n            status: 'not_assigned',\n            experimentHandle: binding.experimentHandle,\n            reason: 'not_enrolled',\n            providerHandle: 'optimizely',\n            ...(options.providerRevision !== undefined\n              ? { providerRevision: options.providerRevision }\n              : {}),\n          };\n          continue;\n        }\n        if (binding.allowedVariants && !binding.allowedVariants.includes(variant)) {\n          throw new OptimizelyAssignmentError(\n            'unexpected_variant',\n            binding,\n            `variant \"${variant}\" is outside the configured allowlist`,\n          );\n        }\n\n        assignments[binding.experimentHandle] = variant;\n        selections[binding.experimentHandle] = {\n          status: 'assigned',\n          experimentHandle: binding.experimentHandle,\n          variantHandle: variant,\n          providerHandle: 'optimizely',\n          ...(options.providerRevision !== undefined\n            ? { providerRevision: options.providerRevision }\n            : {}),\n        };\n      }\n\n      return { assignments, selections };\n    },\n  };\n}\n"]}

package/dist/types/server-node/local-server.d.ts

@@ -31,7 +31,7 @@ export interface LocalEvaluationServerOptions {
     providers: AnyDomainProvider[];
     /** RevTurbineConfig for local placement resolution. */
     exportedConfig?: ConfigArtifact;
-    /** Target fallback for legacy configs that predate environment stamping. */
+    /** Target fallback for legacy configs. Omitted or blank resolves to `production`. */
     environmentId?: string;
     /** Optional storage for interaction state (defaults to in-memory). */
     storage?: RevTurbineStorage;

package/dist/types/server-node/local-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-server.d.ts","sourceRoot":"","sources":["../../../../server-node/local-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EACV,uBAAuB,EAGxB,MAAM,SAAS,CAAC;AASjB,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,4FAA4F;IAC5F,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,uDAAuD;IACvD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC,CAAC;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;gBAE/B,OAAO,EAAE,4BAA4B;IAyB3C,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAwDlF;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B,GACpC,qBAAqB,CAEvB"}
+{"version":3,"file":"local-server.d.ts","sourceRoot":"","sources":["../../../../server-node/local-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EACV,uBAAuB,EAGxB,MAAM,SAAS,CAAC;AASjB,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,4FAA4F;IAC5F,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,uDAAuD;IACvD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,qFAAqF;IACrF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC,CAAC;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;gBAE/B,OAAO,EAAE,4BAA4B;IAyB3C,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAwDlF;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B,GACpC,qBAAqB,CAEvB"}

package/dist/types/web-sdk/browser-runtime.d.ts

@@ -35,7 +35,7 @@ import { type ConfigArtifact } from './config-artifact';
 export interface BrowserRuntimeOptions extends Omit<LocalRuntimeOptions, 'storage' | 'impressionStore' | 'exportedConfig'> {
     /** Canonical Playbook or deprecated RevTurbineConfig input. */
     exportedConfig: ConfigArtifact;
-    /** Target fallback for legacy configs that predate environment stamping. */
+    /** Target fallback for legacy configs. Omitted or blank resolves to `production`. */
     environmentId?: string;
     /**
      * Override the storage backend. When omitted, `localStorage` is used

package/dist/types/web-sdk/browser-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-runtime.d.ts","sourceRoot":"","sources":["../../../browser-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,YAAY,EAA0B,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAM3B,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CACjD,mBAAmB,EACnB,SAAS,GAAG,iBAAiB,GAAG,gBAAgB,CACjD;IACC,+DAA+D;IAC/D,cAAc,EAAE,cAAc,CAAC;IAE/B,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAE5B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAMD,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAuB;gBAE3C,OAAO,EAAE,qBAAqB;IAqC1C;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}
+{"version":3,"file":"browser-runtime.d.ts","sourceRoot":"","sources":["../../../browser-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,YAAY,EAA0B,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAO3B,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CACjD,mBAAmB,EACnB,SAAS,GAAG,iBAAiB,GAAG,gBAAgB,CACjD;IACC,+DAA+D;IAC/D,cAAc,EAAE,cAAc,CAAC;IAE/B,qFAAqF;IACrF,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAE5B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAMD,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAuB;gBAE3C,OAAO,EAAE,qBAAqB;IAqC1C;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/types/web-sdk/customer-side.d.ts

@@ -1,5 +1,5 @@
 import { DomainProviderRegistry } from './providers/registry';
-import type { AnyDomainProvider } from './providers/types';
+import type { AnyDomainProvider, ExperimentVariantSelection } from './providers/types';
 import { type ResolvedBranding } from './branding';
 import type { BrandingConfig } from './generated';
 import type { ControlPlaneEventType } from './control-plane-events';
@@ -534,9 +534,9 @@ export interface RevTurbineInitOptions {
     trustedManifestKeys?: readonly TrustedKey[];
     /**
      * Environment identifier stamped on every ingested clickstream event
-     * (`TrackEvent.environment_id`, e.g. `'prod'` / `'staging'`). Lets a
+     * (`TrackEvent.environment_id`, e.g. `'production'` / `'staging'`). Lets a
      * tenant separate analytics by deployment environment. Defaults to
-     * `'default'` when omitted.
+     * `'production'` when omitted, empty, or whitespace-only.
      */
     environmentId?: string;
     /**
@@ -651,6 +651,8 @@ export interface RevTurbineInitOptions {
     providerFailureSlotBehavior?: RevTurbineProviderFailureSlotBehavior;
     /** Typed domain providers (plan, entitlements, segments, content, rules, traits). */
     domainProviders?: AnyDomainProvider[];
+    /** Maximum time for one client experiment provider resolution. Default: 5000ms. */
+    experimentProviderTimeoutMs?: number;
     /** Optional UI path resolver map used by `validateUiPathResolvers()`. */
     uiPathResolvers?: RevTurbineUiPathResolverMap;
     /**
@@ -1312,6 +1314,9 @@ export declare class RevTurbineCustomerSdk {
     private readonly placements;
     private readonly syncedSurfaceSlotIds;
     private userContext;
+    private contextRevision;
+    private providerResolutionController;
+    private lastEffectiveContext?;
     private pageContext;
     /**
      * Secure per-user client token (`rt_client_`, plan 157). Minted by the
@@ -1400,6 +1405,17 @@ export declare class RevTurbineCustomerSdk {
      * interpolation (e.g. `{{usage_remaining}}`).
      */
     private synthesizeProviderContext;
+    private immutableProviderUserContext;
+    private invalidateEffectiveContext;
+    private resolveEffectiveProviderContext;
+    /**
+     * Resolve the normalized variant used by RevTurbine decisions and telemetry.
+     * Missing, conflicting, and unavailable assignments remain explicit and are
+     * never converted to a control variant.
+     */
+    getExperimentVariant(experimentHandle: string): Promise<ExperimentVariantSelection>;
+    /** Return the immutable ephemeral context currently entering local evaluation. */
+    getEffectiveUserContext(): Promise<Readonly<RevTurbineUserContext>>;
     private markAllSegmentsDirty;
     private markSegmentsDirtyForFields;
     private toSegmentEvaluationTraits;