@revturbine/sdk 0.7.7 → 0.7.9

package/dist/growthbook.d.ts

@@ -1,5 +1,6 @@
 import { GrowthBook } from '@growthbook/growthbook';
 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'>;
@@ -180,6 +181,84 @@ 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.
@@ -197,6 +276,15 @@ type TraitsNamespace = `traits:${string}`;
  * 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.
  *
@@ -211,7 +299,7 @@ interface DomainProvider<D extends DomainProviderName = DomainProviderName, T =
      * Resolve the current value. Called before placement decisions.
      * May be async (e.g. reading from a database or API).
      */
-    resolve(): T | Promise<T>;
+    resolve(input?: DomainProviderResolutionInput): T | Promise<T>;
     /**
      * Optional: subscribe to changes (enables push-based invalidation).
      * Returns an unsubscribe function.
@@ -219,6 +307,8 @@ interface DomainProvider<D extends DomainProviderName = DomainProviderName, T =
     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
@@ -235,7 +325,28 @@ interface DomainProvider<D extends DomainProviderName = DomainProviderName, T =
 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.
  *
@@ -246,6 +357,10 @@ interface ExperimentProviderState {
  */
 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[];
 }
 
 /**
@@ -271,9 +386,11 @@ interface GrowthBookExperimentAssignmentOptions {
     client: Pick<GrowthBook<Record<string, string>>, 'evalFeature'>;
     /** Explicit experiment-to-feature mappings; no naming convention is assumed. */
     bindings: readonly GrowthBookExperimentBinding[];
+    /** Customer-controlled revision for feature/config changes. */
+    providerRevision?: string | number;
 }
 /** Machine-readable reasons a GrowthBook assignment cannot be normalized. */
-type GrowthBookAssignmentErrorReason = 'duplicate_experiment_handle' | 'unknown_feature' | 'invalid_variant' | 'unexpected_variant';
+type GrowthBookAssignmentErrorReason = 'duplicate_experiment_handle' | 'invalid_binding' | 'unknown_feature' | 'invalid_variant' | 'unexpected_variant';
 /** Raised when GrowthBook cannot produce a valid normalized assignment. */
 declare class GrowthBookAssignmentError extends Error {
     /** Stable reason suitable for logs and error handling. */

package/dist/growthbook.js

@@ -1,2 +1,2 @@
-var s=Object.defineProperty;var d=(r,n,e)=>n in r?s(r,n,{enumerable:true,configurable:true,writable:true,value:e}):r[n]=e;var i=(r,n,e)=>d(r,typeof n!="symbol"?n+"":n,e);var o=class extends Error{constructor(e,t,a){super(`GrowthBook assignment for experiment "${t.experimentHandle}" (feature "${t.featureKey}") failed: ${a}`);i(this,"reason");i(this,"experimentHandle");i(this,"featureKey");this.name="GrowthBookAssignmentError",this.reason=e,this.experimentHandle=t.experimentHandle,this.featureKey=t.featureKey;}};function m(r){let n=new Set;for(let e of r){if(n.has(e.experimentHandle))throw new o("duplicate_experiment_handle",e,"the experiment handle is mapped more than once");n.add(e.experimentHandle);}}function p(r){return m(r.bindings),{domain:"experiments",resolve(){let n={};for(let e of r.bindings){let t=r.client.evalFeature(e.featureKey);if(t.source==="unknownFeature")throw new o("unknown_feature",e,"GrowthBook reported an unknown feature");if(typeof t.value!="string"||t.value.length===0)throw new o("invalid_variant",e,"the evaluated value must be a non-empty string variant handle");if(e.allowedVariants&&!e.allowedVariants.includes(t.value))throw new o("unexpected_variant",e,`variant "${t.value}" is outside the configured allowlist`);n[e.experimentHandle]=t.value;}return {assignments:n}}}}export{o as GrowthBookAssignmentError,p as createGrowthBookExperimentAssignmentProvider};//# sourceMappingURL=growthbook.js.map
+var s=Object.defineProperty;var d=(r,n,e)=>n in r?s(r,n,{enumerable:true,configurable:true,writable:true,value:e}):r[n]=e;var i=(r,n,e)=>d(r,typeof n!="symbol"?n+"":n,e);var o=class extends Error{constructor(e,t,a){super(`GrowthBook assignment for experiment "${t.experimentHandle}" (feature "${t.featureKey}") failed: ${a}`);i(this,"reason");i(this,"experimentHandle");i(this,"featureKey");this.name="GrowthBookAssignmentError",this.reason=e,this.experimentHandle=t.experimentHandle,this.featureKey=t.featureKey;}};function m(r){let n=new Set;for(let e of r){if(!e.experimentHandle.trim()||!e.featureKey.trim())throw new o("invalid_binding",e,"experiment handles and GrowthBook feature keys must be non-empty");if(n.has(e.experimentHandle))throw new o("duplicate_experiment_handle",e,"the experiment handle is mapped more than once");n.add(e.experimentHandle);}}function p(r){return m(r.bindings),{domain:"experiments",providerHandle:"growthbook",providerRevision:r.providerRevision,ownedExperimentHandles:r.bindings.map(n=>n.experimentHandle),resolve(){let n={};for(let e of r.bindings){let t=r.client.evalFeature(e.featureKey);if(t.source==="unknownFeature")throw new o("unknown_feature",e,"GrowthBook reported an unknown feature");if(typeof t.value!="string"||t.value.length===0)throw new o("invalid_variant",e,"the evaluated value must be a non-empty string variant handle");if(e.allowedVariants&&!e.allowedVariants.includes(t.value))throw new o("unexpected_variant",e,`variant "${t.value}" is outside the configured allowlist`);n[e.experimentHandle]=t.value;}return {assignments:n}}}}export{o as GrowthBookAssignmentError,p as createGrowthBookExperimentAssignmentProvider};//# sourceMappingURL=growthbook.js.map
 //# sourceMappingURL=growthbook.js.map

package/dist/growthbook.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../providers/growthbook-experiment-provider.ts"],"names":["GrowthBookAssignmentError","reason","binding","detail","__publicField","validateBindings","bindings","handles","createGrowthBookExperimentAssignmentProvider","options","assignments","result"],"mappings":"AAuCO,IAAA,CAAA,CAAA,MAAA,CAAA,cAAA,CAAA,IAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,CAAA,IAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,UAAA,CAAA,IAAA,CAAA,YAAA,CAAA,IAAA,CAAA,QAAA,CAAA,IAAA,CAAA,KAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,IAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,CAAA,CAAA,CAAA,CAAA,OAAA,CAAA,EAAA,QAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,IAAMA,EAAN,cAAwC,KAAM,CASnD,WAAA,CACEC,EACAC,CAAAA,CACAC,CAAAA,CACA,CACA,KAAA,CACE,yCAAyCD,CAAAA,CAAQ,gBAAgB,eAClDA,CAAAA,CAAQ,UAAU,cAAcC,CAAM,CAAA,CACvD,CAAA,CAfFC,CAAAA,CAAA,KAAS,QAAA,CAAA,CAETA,CAAAA,CAAA,KAAS,kBAAA,CAAA,CAETA,CAAAA,CAAA,KAAS,YAAA,CAAA,CAYP,IAAA,CAAK,IAAA,CAAO,2BAAA,CACZ,KAAK,MAAA,CAASH,CAAAA,CACd,KAAK,gBAAA,CAAmBC,CAAAA,CAAQ,iBAChC,IAAA,CAAK,UAAA,CAAaA,CAAAA,CAAQ,WAC5B,CACF,EAEA,SAASG,CAAAA,CAAiBC,CAAAA,CAAwD,CAChF,IAAMC,CAAAA,CAAU,IAAI,GAAA,CACpB,QAAWL,CAAAA,IAAWI,CAAAA,CAAU,CAC9B,GAAIC,CAAAA,CAAQ,IAAIL,CAAAA,CAAQ,gBAAgB,CAAA,CACtC,MAAM,IAAIF,CAAAA,CACR,6BAAA,CACAE,EACA,gDACF,CAAA,CAEFK,EAAQ,GAAA,CAAIL,CAAAA,CAAQ,gBAAgB,EACtC,CACF,CASO,SAASM,EACdC,CAAAA,CAC8B,CAC9B,OAAAJ,CAAAA,CAAiBI,CAAAA,CAAQ,QAAQ,CAAA,CAE1B,CACL,MAAA,CAAQ,aAAA,CACR,OAAA,EAAmC,CACjC,IAAMC,CAAAA,CAAsC,EAAC,CAE7C,IAAA,IAAWR,KAAWO,CAAAA,CAAQ,QAAA,CAAU,CACtC,IAAME,CAAAA,CAASF,EAAQ,MAAA,CAAO,WAAA,CAAYP,CAAAA,CAAQ,UAAU,EAC5D,GAAIS,CAAAA,CAAO,SAAW,gBAAA,CACpB,MAAM,IAAIX,CAAAA,CACR,iBAAA,CACAE,CAAAA,CACA,wCACF,EAGF,GAAI,OAAOS,EAAO,KAAA,EAAU,QAAA,EAAYA,EAAO,KAAA,CAAM,MAAA,GAAW,CAAA,CAC9D,MAAM,IAAIX,CAAAA,CACR,iBAAA,CACAE,CAAAA,CACA,+DACF,EAGF,GAAIA,CAAAA,CAAQ,eAAA,EAAmB,CAACA,EAAQ,eAAA,CAAgB,QAAA,CAASS,EAAO,KAAK,CAAA,CAC3E,MAAM,IAAIX,CAAAA,CACR,oBAAA,CACAE,CAAAA,CACA,YAAYS,CAAAA,CAAO,KAAK,uCAC1B,CAAA,CAGFD,CAAAA,CAAYR,EAAQ,gBAAgB,CAAA,CAAIS,CAAAA,CAAO,MACjD,CAEA,OAAO,CAAE,YAAAD,CAAY,CACvB,CACF,CACF","file":"growthbook.js","sourcesContent":["/**\n * GrowthBook-backed experiment assignment provider.\n *\n * The GrowthBook client is injected by the customer. This adapter therefore\n * evaluates the customer's real GrowthBook instance without bundling its SDK,\n * fetching credentials, or accepting executable customer code.\n */\nimport type { GrowthBook } from '@growthbook/growthbook';\nimport type {\n  ExperimentAssignmentProvider,\n  ExperimentProviderState,\n} from '@revt-eng/core';\n\n/** One RevTurbine experiment handle mapped to its GrowthBook feature key. */\nexport interface GrowthBookExperimentBinding {\n  /** Stable RevTurbine experiment handle emitted in normalized assignments. */\n  experimentHandle: string;\n  /** GrowthBook feature key whose evaluated string value is the variant handle. */\n  featureKey: string;\n  /** Optional allowlist that rejects unexpected GrowthBook variant values. */\n  allowedVariants?: readonly string[];\n}\n\n/** Options for the separately bundled GrowthBook assignment adapter. */\nexport interface GrowthBookExperimentAssignmentOptions {\n  /** An initialized customer-owned GrowthBook client. */\n  client: Pick<GrowthBook<Record<string, string>>, 'evalFeature'>;\n  /** Explicit experiment-to-feature mappings; no naming convention is assumed. */\n  bindings: readonly GrowthBookExperimentBinding[];\n}\n\n/** Machine-readable reasons a GrowthBook assignment cannot be normalized. */\nexport type GrowthBookAssignmentErrorReason =\n  | 'duplicate_experiment_handle'\n  | 'unknown_feature'\n  | 'invalid_variant'\n  | 'unexpected_variant';\n\n/** Raised when GrowthBook cannot produce a valid normalized assignment. */\nexport class GrowthBookAssignmentError extends Error {\n  /** Stable reason suitable for logs and error handling. */\n  readonly reason: GrowthBookAssignmentErrorReason;\n  /** RevTurbine experiment whose assignment failed. */\n  readonly experimentHandle: string;\n  /** GrowthBook feature evaluated for the assignment. */\n  readonly featureKey: string;\n\n  /** Construct a named GrowthBook normalization failure. */\n  constructor(\n    reason: GrowthBookAssignmentErrorReason,\n    binding: GrowthBookExperimentBinding,\n    detail: string,\n  ) {\n    super(\n      `GrowthBook assignment for experiment \"${binding.experimentHandle}\" `\n      + `(feature \"${binding.featureKey}\") failed: ${detail}`,\n    );\n    this.name = 'GrowthBookAssignmentError';\n    this.reason = reason;\n    this.experimentHandle = binding.experimentHandle;\n    this.featureKey = binding.featureKey;\n  }\n}\n\nfunction validateBindings(bindings: readonly GrowthBookExperimentBinding[]): void {\n  const handles = new Set<string>();\n  for (const binding of bindings) {\n    if (handles.has(binding.experimentHandle)) {\n      throw new GrowthBookAssignmentError(\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 GrowthBook client.\n *\n * Each GrowthBook feature must evaluate to a non-empty string variant handle.\n * Unknown features and invalid values fail explicitly instead of being\n * converted to an empty assignment or fabricated fallback.\n */\nexport function createGrowthBookExperimentAssignmentProvider(\n  options: GrowthBookExperimentAssignmentOptions,\n): ExperimentAssignmentProvider {\n  validateBindings(options.bindings);\n\n  return {\n    domain: 'experiments',\n    resolve(): ExperimentProviderState {\n      const assignments: Record<string, string> = {};\n\n      for (const binding of options.bindings) {\n        const result = options.client.evalFeature(binding.featureKey);\n        if (result.source === 'unknownFeature') {\n          throw new GrowthBookAssignmentError(\n            'unknown_feature',\n            binding,\n            'GrowthBook reported an unknown feature',\n          );\n        }\n\n        if (typeof result.value !== 'string' || result.value.length === 0) {\n          throw new GrowthBookAssignmentError(\n            'invalid_variant',\n            binding,\n            'the evaluated value must be a non-empty string variant handle',\n          );\n        }\n\n        if (binding.allowedVariants && !binding.allowedVariants.includes(result.value)) {\n          throw new GrowthBookAssignmentError(\n            'unexpected_variant',\n            binding,\n            `variant \"${result.value}\" is outside the configured allowlist`,\n          );\n        }\n\n        assignments[binding.experimentHandle] = result.value;\n      }\n\n      return { assignments };\n    },\n  };\n}\n"]}
+{"version":3,"sources":["../providers/growthbook-experiment-provider.ts"],"names":["GrowthBookAssignmentError","reason","binding","detail","__publicField","validateBindings","bindings","handles","createGrowthBookExperimentAssignmentProvider","options","assignments","result"],"mappings":"0KA0CO,IAAMA,CAAAA,CAAN,cAAwC,KAAM,CASnD,YACEC,CAAAA,CACAC,CAAAA,CACAC,EACA,CACA,KAAA,CACE,yCAAyCD,CAAAA,CAAQ,gBAAgB,eAClDA,CAAAA,CAAQ,UAAU,cAAcC,CAAM,CAAA,CACvD,CAAA,CAfFC,CAAAA,CAAA,IAAA,CAAS,QAAA,CAAA,CAETA,EAAA,IAAA,CAAS,kBAAA,CAAA,CAETA,EAAA,IAAA,CAAS,YAAA,CAAA,CAYP,KAAK,IAAA,CAAO,2BAAA,CACZ,KAAK,MAAA,CAASH,CAAAA,CACd,KAAK,gBAAA,CAAmBC,CAAAA,CAAQ,iBAChC,IAAA,CAAK,UAAA,CAAaA,EAAQ,WAC5B,CACF,EAEA,SAASG,CAAAA,CAAiBC,CAAAA,CAAwD,CAChF,IAAMC,CAAAA,CAAU,IAAI,GAAA,CACpB,IAAA,IAAWL,KAAWI,CAAAA,CAAU,CAC9B,GAAI,CAACJ,CAAAA,CAAQ,iBAAiB,IAAA,EAAK,EAAK,CAACA,CAAAA,CAAQ,UAAA,CAAW,MAAK,CAC/D,MAAM,IAAIF,CAAAA,CACR,iBAAA,CACAE,CAAAA,CACA,kEACF,CAAA,CAEF,GAAIK,EAAQ,GAAA,CAAIL,CAAAA,CAAQ,gBAAgB,CAAA,CACtC,MAAM,IAAIF,CAAAA,CACR,6BAAA,CACAE,CAAAA,CACA,gDACF,CAAA,CAEFK,CAAAA,CAAQ,IAAIL,CAAAA,CAAQ,gBAAgB,EACtC,CACF,CASO,SAASM,CAAAA,CACdC,CAAAA,CAC8B,CAC9B,OAAAJ,CAAAA,CAAiBI,CAAAA,CAAQ,QAAQ,CAAA,CAE1B,CACL,OAAQ,aAAA,CACR,cAAA,CAAgB,aAChB,gBAAA,CAAkBA,CAAAA,CAAQ,iBAC1B,sBAAA,CAAwBA,CAAAA,CAAQ,SAAS,GAAA,CAAKP,CAAAA,EAAYA,EAAQ,gBAAgB,CAAA,CAClF,OAAA,EAAmC,CACjC,IAAMQ,CAAAA,CAAsC,EAAC,CAE7C,IAAA,IAAWR,KAAWO,CAAAA,CAAQ,QAAA,CAAU,CACtC,IAAME,CAAAA,CAASF,CAAAA,CAAQ,MAAA,CAAO,WAAA,CAAYP,CAAAA,CAAQ,UAAU,CAAA,CAC5D,GAAIS,EAAO,MAAA,GAAW,gBAAA,CACpB,MAAM,IAAIX,CAAAA,CACR,iBAAA,CACAE,CAAAA,CACA,wCACF,CAAA,CAGF,GAAI,OAAOS,CAAAA,CAAO,OAAU,QAAA,EAAYA,CAAAA,CAAO,MAAM,MAAA,GAAW,CAAA,CAC9D,MAAM,IAAIX,CAAAA,CACR,kBACAE,CAAAA,CACA,+DACF,EAGF,GAAIA,CAAAA,CAAQ,iBAAmB,CAACA,CAAAA,CAAQ,eAAA,CAAgB,QAAA,CAASS,CAAAA,CAAO,KAAK,EAC3E,MAAM,IAAIX,EACR,oBAAA,CACAE,CAAAA,CACA,YAAYS,CAAAA,CAAO,KAAK,CAAA,qCAAA,CAC1B,CAAA,CAGFD,CAAAA,CAAYR,CAAAA,CAAQ,gBAAgB,CAAA,CAAIS,CAAAA,CAAO,MACjD,CAEA,OAAO,CAAE,WAAA,CAAAD,CAAY,CACvB,CACF,CACF","file":"growthbook.js","sourcesContent":["/**\n * GrowthBook-backed experiment assignment provider.\n *\n * The GrowthBook client is injected by the customer. This adapter therefore\n * evaluates the customer's real GrowthBook instance without bundling its SDK,\n * fetching credentials, or accepting executable customer code.\n */\nimport type { GrowthBook } from '@growthbook/growthbook';\nimport type {\n  ExperimentAssignmentProvider,\n  ExperimentProviderState,\n} from '@revt-eng/core';\n\n/** One RevTurbine experiment handle mapped to its GrowthBook feature key. */\nexport interface GrowthBookExperimentBinding {\n  /** Stable RevTurbine experiment handle emitted in normalized assignments. */\n  experimentHandle: string;\n  /** GrowthBook feature key whose evaluated string value is the variant handle. */\n  featureKey: string;\n  /** Optional allowlist that rejects unexpected GrowthBook variant values. */\n  allowedVariants?: readonly string[];\n}\n\n/** Options for the separately bundled GrowthBook assignment adapter. */\nexport interface GrowthBookExperimentAssignmentOptions {\n  /** An initialized customer-owned GrowthBook client. */\n  client: Pick<GrowthBook<Record<string, string>>, 'evalFeature'>;\n  /** Explicit experiment-to-feature mappings; no naming convention is assumed. */\n  bindings: readonly GrowthBookExperimentBinding[];\n  /** Customer-controlled revision for feature/config changes. */\n  providerRevision?: string | number;\n}\n\n/** Machine-readable reasons a GrowthBook assignment cannot be normalized. */\nexport type GrowthBookAssignmentErrorReason =\n  | 'duplicate_experiment_handle'\n  | 'invalid_binding'\n  | 'unknown_feature'\n  | 'invalid_variant'\n  | 'unexpected_variant';\n\n/** Raised when GrowthBook cannot produce a valid normalized assignment. */\nexport class GrowthBookAssignmentError extends Error {\n  /** Stable reason suitable for logs and error handling. */\n  readonly reason: GrowthBookAssignmentErrorReason;\n  /** RevTurbine experiment whose assignment failed. */\n  readonly experimentHandle: string;\n  /** GrowthBook feature evaluated for the assignment. */\n  readonly featureKey: string;\n\n  /** Construct a named GrowthBook normalization failure. */\n  constructor(\n    reason: GrowthBookAssignmentErrorReason,\n    binding: GrowthBookExperimentBinding,\n    detail: string,\n  ) {\n    super(\n      `GrowthBook assignment for experiment \"${binding.experimentHandle}\" `\n      + `(feature \"${binding.featureKey}\") failed: ${detail}`,\n    );\n    this.name = 'GrowthBookAssignmentError';\n    this.reason = reason;\n    this.experimentHandle = binding.experimentHandle;\n    this.featureKey = binding.featureKey;\n  }\n}\n\nfunction validateBindings(bindings: readonly GrowthBookExperimentBinding[]): void {\n  const handles = new Set<string>();\n  for (const binding of bindings) {\n    if (!binding.experimentHandle.trim() || !binding.featureKey.trim()) {\n      throw new GrowthBookAssignmentError(\n        'invalid_binding',\n        binding,\n        'experiment handles and GrowthBook feature keys must be non-empty',\n      );\n    }\n    if (handles.has(binding.experimentHandle)) {\n      throw new GrowthBookAssignmentError(\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 GrowthBook client.\n *\n * Each GrowthBook feature must evaluate to a non-empty string variant handle.\n * Unknown features and invalid values fail explicitly instead of being\n * converted to an empty assignment or fabricated fallback.\n */\nexport function createGrowthBookExperimentAssignmentProvider(\n  options: GrowthBookExperimentAssignmentOptions,\n): ExperimentAssignmentProvider {\n  validateBindings(options.bindings);\n\n  return {\n    domain: 'experiments',\n    providerHandle: 'growthbook',\n    providerRevision: options.providerRevision,\n    ownedExperimentHandles: options.bindings.map((binding) => binding.experimentHandle),\n    resolve(): ExperimentProviderState {\n      const assignments: Record<string, string> = {};\n\n      for (const binding of options.bindings) {\n        const result = options.client.evalFeature(binding.featureKey);\n        if (result.source === 'unknownFeature') {\n          throw new GrowthBookAssignmentError(\n            'unknown_feature',\n            binding,\n            'GrowthBook reported an unknown feature',\n          );\n        }\n\n        if (typeof result.value !== 'string' || result.value.length === 0) {\n          throw new GrowthBookAssignmentError(\n            'invalid_variant',\n            binding,\n            'the evaluated value must be a non-empty string variant handle',\n          );\n        }\n\n        if (binding.allowedVariants && !binding.allowedVariants.includes(result.value)) {\n          throw new GrowthBookAssignmentError(\n            'unexpected_variant',\n            binding,\n            `variant \"${result.value}\" is outside the configured allowlist`,\n          );\n        }\n\n        assignments[binding.experimentHandle] = result.value;\n      }\n\n      return { assignments };\n    },\n  };\n}\n"]}