@vercel/flags-core 1.8.0 → 1.9.0-af502ab-20260904110845

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @vercel/flags-core
 
+## 1.9.0-af502ab-20260904110845
+
+### Minor Changes
+
+- [#486](https://github.com/vercel/flags/pull/486) [`8505d17`](https://github.com/vercel/flags/commit/8505d179b6d1e43d3401cd7d6a7b89bf5ae92854) Thanks [@dferber90](https://github.com/dferber90)! - Add APIs for reporting flag exposures and override values.
+  
+  - The `experimental_reportExposures` client option for supplying an exposure
+    reporter.
+  - The `experimental_reportOverride` client method for reporting values set by
+    the Flags SDK override cookie.
+  - The `experimental_exposureLogging` option on `evaluate()` and
+    `bulkEvaluate()` for disabling exposure reporting for an individual call.
+  - Experiment assignment metadata on `EvaluationResult.experiment`.
+  - The `experimental_EvaluationOptions`,
+    `experimental_ExperimentAssignment`, `experimental_Exposure`, and
+    `experimental_ReportExposures` types.
+  
+  These APIs are not supported for general use yet. Do not use them unless
+  Vercel has explicitly enabled them for you.
+
 ## 1.8.0
 
 ### Minor Changes

package/README.md

@@ -24,6 +24,8 @@ const result = await client.evaluate<boolean>('show-new-feature', false, {
 });
 ```
 
+## Evaluation Metrics
+
 To associate evaluation metrics with an environment, pass the
 `metricEnvironment` option:
 

package/dist/{chunk-C3FUDFOP.cjs → chunk-5EM5QUML.cjs}

@@ -327,7 +327,43 @@ function getVariant(definition, index) {
     variantId
   };
 }
-function handleOutcome(params, outcome) {
+function getWeightedVariantIndex(params, assignment, seed) {
+  const lhs = access(assignment.base, params);
+  if (typeof lhs !== "string") return assignment.defaultVariant;
+  const bucket = _jsxxhash.xxHash32.call(void 0, lhs, seed);
+  const boundaries = getSplitBoundaries(assignment);
+  for (let index = 0; index < boundaries.length; index++) {
+    if (bucket < boundaries[index]) return index;
+  }
+  return assignment.defaultVariant;
+}
+function experimentAssignment(experiment, variantId, assignmentReason) {
+  if (variantId === null) return void 0;
+  return {
+    id: experiment.id,
+    variantId,
+    base: experiment.base,
+    rampId: experiment.rampId,
+    rampPercentage: experiment.rampPercentage,
+    assignmentReason
+  };
+}
+function outcomeAssignmentReason(outcome) {
+  if (typeof outcome === "number") return "variant";
+  switch (outcome.type) {
+    case "experiment":
+      return "experiment";
+    case "split":
+      return "split";
+    case "rollout":
+      return "rollout";
+    default: {
+      const { type } = outcome;
+      return exhaustivenessCheck(type);
+    }
+  }
+}
+function resolveOutcome(params, outcome) {
   if (typeof outcome === "number") {
     const variant = getVariant(params.definition, outcome);
     return {
@@ -337,32 +373,48 @@ function handleOutcome(params, outcome) {
   }
   switch (outcome.type) {
     case "split": {
-      const lhs = access(outcome.base, params);
-      const defaultOutcome = getVariant(
-        params.definition,
-        outcome.defaultVariant
+      const index = getWeightedVariantIndex(
+        params,
+        outcome,
+        params.definition.seed
       );
-      if (typeof lhs !== "string") {
-        return {
-          ...defaultOutcome,
-          outcomeType: "split" /* SPLIT */
-        };
-      }
-      const bucket = _jsxxhash.xxHash32.call(void 0, lhs, params.definition.seed);
-      const boundaries = getSplitBoundaries(outcome);
-      for (let index = 0; index < boundaries.length; index++) {
-        if (bucket < boundaries[index]) {
-          return {
-            ...getVariant(params.definition, index),
-            outcomeType: "split" /* SPLIT */
-          };
-        }
-      }
       return {
-        ...defaultOutcome,
+        ...getVariant(params.definition, index),
         outcomeType: "split" /* SPLIT */
       };
     }
+    case "experiment": {
+      const experiment = params.definition.experiment;
+      if (!experiment) {
+        throw new Error("@vercel/flags-core: Experiment not found");
+      }
+      const unitValue = access(experiment.base, params);
+      const defaultVariant = getVariant(
+        params.definition,
+        experiment.defaultVariant
+      );
+      const assignment = (variant, assignmentReason) => ({
+        ...variant,
+        outcomeType: "experiment" /* EXPERIMENT */,
+        experiment: experimentAssignment(
+          experiment,
+          variant.variantId,
+          assignmentReason
+        )
+      });
+      if (typeof unitValue !== "string") {
+        return assignment(defaultVariant, "not-enrolled");
+      }
+      const rampPercentage = _nullishCoalesce(experiment.rampPercentage, () => ( 100));
+      const enrolled = rampPercentage >= 100 || rampPercentage > 0 && _jsxxhash.xxHash32.call(void 0, unitValue, experiment.enrollmentSeed) < boundaryFor(rampPercentage, 100);
+      if (!enrolled) return assignment(defaultVariant, "not-enrolled");
+      const index = getWeightedVariantIndex(
+        params,
+        experiment,
+        params.definition.seed
+      );
+      return assignment(getVariant(params.definition, index), "experiment");
+    }
     case "rollout": {
       const lhs = access(outcome.base, params);
       const defaultOutcome = getVariant(
@@ -435,6 +487,19 @@ function handleOutcome(params, outcome) {
     }
   }
 }
+function handleOutcome(params, outcome, assignmentReason) {
+  const result = resolveOutcome(params, outcome);
+  const experiment = params.definition.experiment;
+  if (!experiment || result.experiment) return result;
+  return {
+    ...result,
+    experiment: experimentAssignment(
+      experiment,
+      result.variantId,
+      _nullishCoalesce(assignmentReason, () => ( outcomeAssignmentReason(outcome)))
+    )
+  };
+}
 function evaluate(params, _visited) {
   const envConfig = params.definition.environments[params.environment];
   if (typeof envConfig === "number") {
@@ -474,7 +539,7 @@ function evaluate(params, _visited) {
       (targetList) => matchTargetList(targetList, params)
     );
     if (matchedIndex > -1) {
-      return Object.assign(handleOutcome(params, matchedIndex), {
+      return Object.assign(handleOutcome(params, matchedIndex, "targeted"), {
         reason: "target_match" /* TARGET_MATCH */
       });
     }
@@ -508,7 +573,7 @@ function bulkEvaluate(flags, shared) {
 }
 
 // package.json
-var version = "1.8.0";
+var version = "1.9.0-af502ab-20260904110845";
 
 // src/lib/report-value.ts
 function internalReportValue(key, value, data) {
@@ -727,6 +792,8 @@ async function bulkEvaluate2(id, flags, entities) {
 }
 
 // src/create-raw-client.ts
+var _functions = require('@vercel/functions');
+var _lite = require('dequal/lite');
 var idCount = 0;
 async function performInitialize(instance, initFn) {
   try {
@@ -740,7 +807,8 @@ async function performInitialize(instance, initFn) {
 function createCreateRawClient(fns) {
   return function createRawClient({
     controller,
-    origin
+    origin,
+    experimental_reportExposures
   }) {
     const id = idCount++;
     controllerInstanceMap.set(id, {
@@ -748,6 +816,35 @@ function createCreateRawClient(fns) {
       initialized: false,
       initPromise: null
     });
+    function report(exposures, entity) {
+      if (!experimental_reportExposures || exposures.length === 0) return;
+      const pending = (async () => {
+        try {
+          await experimental_reportExposures(exposures, entity);
+        } catch (error) {
+          console.error(
+            "@vercel/flags-core: Failed to report experiment exposures",
+            error
+          );
+        }
+      })();
+      try {
+        _functions.waitUntil.call(void 0, pending);
+      } catch (e) {
+      }
+    }
+    function getExposure(flagKey, result) {
+      if (!result.experiment) return null;
+      return {
+        flagKey,
+        experimentId: result.experiment.id,
+        variantId: result.experiment.variantId,
+        base: result.experiment.base,
+        ...result.experiment.rampId === void 0 ? {} : { rampId: result.experiment.rampId },
+        ...result.experiment.rampPercentage === void 0 ? {} : { rampPercentage: result.experiment.rampPercentage },
+        assignmentReason: result.experiment.assignmentReason
+      };
+    }
     const api = {
       origin,
       initialize: async () => {
@@ -774,7 +871,7 @@ function createCreateRawClient(fns) {
         if (_optionalChain([instance, 'optionalAccess', _22 => _22.initPromise])) {
           try {
             await instance.initPromise;
-          } catch (e) {
+          } catch (e2) {
           }
         }
         return fns.getDatafile(id);
@@ -782,25 +879,92 @@ function createCreateRawClient(fns) {
       getFallbackDatafile: () => {
         return fns.getFallbackDatafile(id);
       },
-      evaluate: async (flagKey, defaultValue, entities) => {
+      evaluate: async (flagKey, defaultValue, entities, options) => {
         const instance = controllerInstanceMap.get(id);
         if (!_optionalChain([instance, 'optionalAccess', _23 => _23.initialized])) {
           try {
             await api.initialize();
-          } catch (e2) {
+          } catch (e3) {
+          }
+        }
+        const entity = _nullishCoalesce(entities, () => ( {}));
+        const result = await fns.evaluate(
+          id,
+          flagKey,
+          defaultValue,
+          entity
+        );
+        if (experimental_reportExposures && _optionalChain([options, 'optionalAccess', _24 => _24.experimental_exposureLogging]) !== false) {
+          const exposure = getExposure(flagKey, result);
+          if (exposure) {
+            report([exposure], entity);
           }
         }
-        return fns.evaluate(id, flagKey, defaultValue, entities);
+        return result;
       },
-      bulkEvaluate: async (flags, entities) => {
+      bulkEvaluate: async (flags, entities, options) => {
         const instance = controllerInstanceMap.get(id);
-        if (!_optionalChain([instance, 'optionalAccess', _24 => _24.initialized])) {
+        if (!_optionalChain([instance, 'optionalAccess', _25 => _25.initialized])) {
           try {
             await api.initialize();
-          } catch (e3) {
+          } catch (e4) {
+          }
+        }
+        const entity = _nullishCoalesce(entities, () => ( {}));
+        const results = await fns.bulkEvaluate(id, flags, entity);
+        if (experimental_reportExposures && _optionalChain([options, 'optionalAccess', _26 => _26.experimental_exposureLogging]) !== false) {
+          const exposures = [];
+          const seen = /* @__PURE__ */ new Set();
+          for (const flag of flags) {
+            if (seen.has(flag.key)) continue;
+            seen.add(flag.key);
+            const result = results[flag.key];
+            if (!result) continue;
+            const exposure = getExposure(flag.key, result);
+            if (exposure) exposures.push(exposure);
           }
+          report(exposures, entity);
+        }
+        return results;
+      },
+      experimental_reportOverride: async ({
+        key,
+        value,
+        entities
+      }) => {
+        if (!experimental_reportExposures) return;
+        try {
+          const instance = controllerInstanceMap.get(id);
+          if (!_optionalChain([instance, 'optionalAccess', _27 => _27.initialized])) await api.initialize();
+          const datafile = await fns.getDatafile(id);
+          const definition = datafile.definitions[key];
+          const experiment = _optionalChain([definition, 'optionalAccess', _28 => _28.experiment]);
+          if (!experiment) return;
+          const variantIndex = definition.variants.findIndex(
+            (variant) => _lite.dequal.call(void 0, variant, value)
+          );
+          const variantId = variantIndex < 0 ? null : _nullishCoalesce(_optionalChain([definition, 'access', _29 => _29.variantIds, 'optionalAccess', _30 => _30[variantIndex]]), () => ( null));
+          const entity = _nullishCoalesce(entities, () => ( {}));
+          report(
+            [
+              {
+                flagKey: key,
+                experimentId: experiment.id,
+                variantId,
+                base: experiment.base,
+                rampId: experiment.rampId,
+                rampPercentage: experiment.rampPercentage,
+                assignmentReason: "override"
+              }
+            ],
+            entity
+          );
+        } catch (error) {
+          console.error(
+            "@vercel/flags-core: Failed to report experiment override",
+            error
+          );
         }
-        return fns.bulkEvaluate(id, flags, entities);
       }
     };
     return api;
@@ -886,7 +1050,7 @@ var MAX_RETRIES = 3;
 var MAX_EVENTS_PER_REQUEST = 2e3;
 var EVALUATING_OIDC_TOKEN_HEADER = "X-Vercel-Flags-OIDC-Token";
 var FLUSH_REASON_HEADER = "X-Vercel-Flags-Flush-Reason";
-var isDebugMode = _optionalChain([process, 'access', _25 => _25.env, 'access', _26 => _26.DEBUG, 'optionalAccess', _27 => _27.includes, 'call', _28 => _28("@vercel/flags-core")]);
+var isDebugMode = _optionalChain([process, 'access', _31 => _31.env, 'access', _32 => _32.DEBUG, 'optionalAccess', _33 => _33.includes, 'call', _34 => _34("@vercel/flags-core")]);
 var debugLog = (...args) => {
   if (!isDebugMode) return;
   console.log(...args);
@@ -895,7 +1059,7 @@ async function getEvaluatingOidcToken(auth) {
   if (!auth.sdkKey) return void 0;
   try {
     return await _oidc.getVercelOidcToken.call(void 0, );
-  } catch (e4) {
+  } catch (e5) {
     return void 0;
   }
 }
@@ -965,7 +1129,7 @@ var SYMBOL_FOR_REQ_CONTEXT = /* @__PURE__ */ Symbol.for("@vercel/request-context
 var fromSymbol = globalThis;
 function getRequestContext() {
   try {
-    const ctx = _optionalChain([fromSymbol, 'access', _29 => _29[SYMBOL_FOR_REQ_CONTEXT], 'optionalAccess', _30 => _30.get, 'optionalCall', _31 => _31()]);
+    const ctx = _optionalChain([fromSymbol, 'access', _35 => _35[SYMBOL_FOR_REQ_CONTEXT], 'optionalAccess', _36 => _36.get, 'optionalCall', _37 => _37()]);
     if (ctx && Object.hasOwn(ctx, "headers")) {
       return {
         ctx,
@@ -973,13 +1137,13 @@ function getRequestContext() {
       };
     }
     return { ctx, headers: void 0 };
-  } catch (e5) {
+  } catch (e6) {
     return { ctx: void 0, headers: void 0 };
   }
 }
 
 // src/utils/scheduler.ts
-var _functions = require('@vercel/functions');
+
 var IDLE_FLUSH_WAIT_MS = 5e3;
 var IDLE_FLUSH_JITTER_RATIO = 0.2;
 var MAX_FLUSH_WAIT_MS = 6e4;
@@ -1003,7 +1167,7 @@ var Scheduler = (_class = class {
       })();
       try {
         _functions.waitUntil.call(void 0, this.pending);
-      } catch (e6) {
+      } catch (e7) {
       }
       this.maxTimeout = setTimeout(
         () => this.resolveScheduledFlush("max_timeout"),
@@ -1030,7 +1194,7 @@ var Scheduler = (_class = class {
   }
   resolveScheduledFlush(reason) {
     this.clearTimeouts();
-    _optionalChain([this, 'access', _32 => _32.resolveWait, 'optionalCall', _33 => _33(reason)]);
+    _optionalChain([this, 'access', _38 => _38.resolveWait, 'optionalCall', _39 => _39(reason)]);
   }
   reset() {
     this.pending = null;
@@ -1278,7 +1442,7 @@ var BundledSource = class {
    */
   async tryLoad() {
     const result = await this.getResult();
-    if (_optionalChain([result, 'optionalAccess', _34 => _34.state]) === "ok" && result.definitions) {
+    if (_optionalChain([result, 'optionalAccess', _40 => _40.state]) === "ok" && result.definitions) {
       return result.definitions;
     }
     return void 0;
@@ -1318,14 +1482,14 @@ async function fetchDatafile(options) {
       signal: controller.signal
     });
     clearTimeout(timeoutId);
-    _optionalChain([options, 'access', _35 => _35.signal, 'optionalAccess', _36 => _36.removeEventListener, 'call', _37 => _37("abort", onExternalAbort)]);
+    _optionalChain([options, 'access', _41 => _41.signal, 'optionalAccess', _42 => _42.removeEventListener, 'call', _43 => _43("abort", onExternalAbort)]);
     if (!res.ok) {
       throw new Error(`Failed to fetch data: ${res.statusText}`);
     }
     return res.json();
   } catch (error) {
     clearTimeout(timeoutId);
-    _optionalChain([options, 'access', _38 => _38.signal, 'optionalAccess', _39 => _39.removeEventListener, 'call', _40 => _40("abort", onExternalAbort)]);
+    _optionalChain([options, 'access', _44 => _44.signal, 'optionalAccess', _45 => _45.removeEventListener, 'call', _46 => _46("abort", onExternalAbort)]);
     throw error instanceof Error ? error : new Error("Unknown fetch error");
   }
 }
@@ -1393,7 +1557,7 @@ var TypedEmitter = (_class5 = class {constructor() { _class5.prototype.__init11.
     set.add(handler);
   }
   off(event, handler) {
-    _optionalChain([this, 'access', _41 => _41.handlers, 'access', _42 => _42.get, 'call', _43 => _43(event), 'optionalAccess', _44 => _44.delete, 'call', _45 => _45(handler)]);
+    _optionalChain([this, 'access', _47 => _47.handlers, 'access', _48 => _48.get, 'call', _49 => _49(event), 'optionalAccess', _50 => _50.delete, 'call', _51 => _51(handler)]);
   }
   emit(event, ...args) {
     const set = this.handlers.get(event);
@@ -1419,11 +1583,11 @@ var PollingSource = class extends TypedEmitter {
    * Emits 'data' on success, 'error' on failure.
    */
   async poll() {
-    if (_optionalChain([this, 'access', _46 => _46.abortController, 'optionalAccess', _47 => _47.signal, 'access', _48 => _48.aborted])) return;
+    if (_optionalChain([this, 'access', _52 => _52.abortController, 'optionalAccess', _53 => _53.signal, 'access', _54 => _54.aborted])) return;
     try {
       const data = await fetchDatafile({
         ...this.config,
-        signal: _optionalChain([this, 'access', _49 => _49.abortController, 'optionalAccess', _50 => _50.signal])
+        signal: _optionalChain([this, 'access', _55 => _55.abortController, 'optionalAccess', _56 => _56.signal])
       });
       this.emit("data", data);
     } catch (error) {
@@ -1452,7 +1616,7 @@ var PollingSource = class extends TypedEmitter {
       clearInterval(this.intervalId);
       this.intervalId = void 0;
     }
-    _optionalChain([this, 'access', _51 => _51.abortController, 'optionalAccess', _52 => _52.abort, 'call', _53 => _53()]);
+    _optionalChain([this, 'access', _57 => _57.abortController, 'optionalAccess', _58 => _58.abort, 'call', _59 => _59()]);
     this.abortController = void 0;
   }
 };
@@ -1526,7 +1690,7 @@ async function connectStream(config, callbacks) {
         if (pingTimeoutId !== void 0) clearTimeout(pingTimeoutId);
         if (!initialDataReceived) return;
         pingTimeoutId = setTimeout(() => {
-          _optionalChain([responseBody, 'optionalAccess', _54 => _54.cancel, 'call', _55 => _55(), 'access', _56 => _56.catch, 'call', _57 => _57(() => {
+          _optionalChain([responseBody, 'optionalAccess', _60 => _60.cancel, 'call', _61 => _61(), 'access', _62 => _62.catch, 'call', _63 => _63(() => {
           })]);
           connectionAbort.abort();
         }, PING_TIMEOUT_MS);
@@ -1545,7 +1709,7 @@ async function connectStream(config, callbacks) {
         if (vercelEnv) {
           headers["X-Vercel-Env"] = vercelEnv;
         }
-        const revision = _optionalChain([config, 'access', _58 => _58.revision, 'optionalCall', _59 => _59()]);
+        const revision = _optionalChain([config, 'access', _64 => _64.revision, 'optionalCall', _65 => _65()]);
         if (revision !== void 0) {
           headers["X-Revision"] = String(revision);
         }
@@ -1591,7 +1755,7 @@ async function connectStream(config, callbacks) {
               let message;
               try {
                 message = JSON.parse(line);
-              } catch (e7) {
+              } catch (e8) {
                 console.warn(
                   "@vercel/flags-core: Failed to parse stream message, skipping"
                 );
@@ -1607,7 +1771,7 @@ async function connectStream(config, callbacks) {
                 resetPingTimeout();
               }
               if (message.type === "primed") {
-                _optionalChain([onPrimed, 'optionalCall', _60 => _60(message)]);
+                _optionalChain([onPrimed, 'optionalCall', _66 => _66(message)]);
                 retryCount = 0;
                 if (!initialDataReceived) {
                   initialDataReceived = true;
@@ -1630,7 +1794,7 @@ async function connectStream(config, callbacks) {
         clearTimeout(pingTimeoutId);
         abortController.signal.removeEventListener("abort", onMainAbort);
         if (!abortController.signal.aborted) {
-          _optionalChain([onDisconnect, 'optionalCall', _61 => _61()]);
+          _optionalChain([onDisconnect, 'optionalCall', _67 => _67()]);
           retryCount++;
           const elapsed = Date.now() - lastAttemptTime;
           const minGap = Math.max(0, BASE_RETRY_DELAY_MS - elapsed);
@@ -1651,7 +1815,7 @@ async function connectStream(config, callbacks) {
         if (!connectionAbort.signal.aborted) {
           lastError = error;
         }
-        _optionalChain([onDisconnect, 'optionalCall', _62 => _62()]);
+        _optionalChain([onDisconnect, 'optionalCall', _68 => _68()]);
         retryCount++;
         const elapsed = Date.now() - lastAttemptTime;
         const minGap = Math.max(0, BASE_RETRY_DELAY_MS - elapsed);
@@ -1730,7 +1894,7 @@ var StreamSource = class extends TypedEmitter {
    * Stop the stream connection.
    */
   stop() {
-    _optionalChain([this, 'access', _63 => _63.abortController, 'optionalAccess', _64 => _64.abort, 'call', _65 => _65()]);
+    _optionalChain([this, 'access', _69 => _69.abortController, 'optionalAccess', _70 => _70.abort, 'call', _71 => _71()]);
     this.abortController = void 0;
     this.promise = void 0;
   }
@@ -1789,7 +1953,7 @@ var Controller = (_class6 = class {
     this.options = normalizeOptions(options);
     this.streamSource = new StreamSource(
       this.options,
-      () => _optionalChain([this, 'access', _66 => _66.data, 'optionalAccess', _67 => _67.revision])
+      () => _optionalChain([this, 'access', _72 => _72.data, 'optionalAccess', _73 => _73.revision])
     );
     this.pollingSource = new PollingSource(this.options);
     this.bundledSource = new BundledSource({
@@ -1897,7 +2061,7 @@ var Controller = (_class6 = class {
         if (bundled) {
           this.data = tagData(bundled, "bundled");
         }
-      } catch (e8) {
+      } catch (e9) {
       }
     }
     if (this.data) {
@@ -1999,7 +2163,7 @@ var Controller = (_class6 = class {
           this.data = tagData(fetched, "fetched");
           result = this.data;
           cacheStatus = "MISS";
-        } catch (e9) {
+        } catch (e10) {
           throw new Error(
             "@vercel/flags-core: No flag definitions available. Initialize the client or provide a datafile."
           );
@@ -2118,7 +2282,7 @@ var Controller = (_class6 = class {
           return true;
         }
         return false;
-      } catch (e10) {
+      } catch (e11) {
         return false;
       }
     }
@@ -2143,7 +2307,7 @@ var Controller = (_class6 = class {
         return true;
       }
       return false;
-    } catch (e11) {
+    } catch (e12) {
       clearTimeout(timeoutId);
       return false;
     }
@@ -2193,7 +2357,7 @@ var Controller = (_class6 = class {
         fetch: this.options.fetch
       });
       return tagData(fetched, "fetched");
-    } catch (e12) {
+    } catch (e13) {
     }
     throw new Error(
       "@vercel/flags-core: No flag definitions available during build. Provide a datafile or bundled definitions."
@@ -2227,7 +2391,7 @@ var Controller = (_class6 = class {
         this.data = tagData(fetched, "fetched");
         this.transition("degraded");
         return;
-      } catch (e13) {
+      } catch (e14) {
       }
     }
     throw new Error(
@@ -2279,7 +2443,7 @@ var Controller = (_class6 = class {
         this.data = tagData(fetched, "fetched");
         this.transition("degraded");
         return [this.data, "MISS"];
-      } catch (e14) {
+      } catch (e15) {
       }
     }
     throw new Error(
@@ -2331,11 +2495,11 @@ var Controller = (_class6 = class {
       duration: Date.now() - startTime,
       mode: mode === "streaming" ? "stream" : mode === "polling" ? "poll" : mode
     };
-    const configUpdatedAt = _optionalChain([this, 'access', _68 => _68.data, 'optionalAccess', _69 => _69.configUpdatedAt]);
+    const configUpdatedAt = _optionalChain([this, 'access', _74 => _74.data, 'optionalAccess', _75 => _75.configUpdatedAt]);
     if (typeof configUpdatedAt === "number") {
       trackOptions.configUpdatedAt = configUpdatedAt;
     }
-    const revision = _optionalChain([this, 'access', _70 => _70.data, 'optionalAccess', _71 => _71.revision]);
+    const revision = _optionalChain([this, 'access', _76 => _76.data, 'optionalAccess', _77 => _77.revision]);
     if (typeof revision === "number") {
       trackOptions.revision = revision;
     }
@@ -2368,7 +2532,7 @@ function parseSdkKeyFromFlagsConnectionString(text) {
     const params = new URLSearchParams(text.slice(6));
     const sdkKey = params.get("sdkKey");
     if (sdkKey && SDK_KEY_REGEX.test(sdkKey)) return sdkKey;
-  } catch (e15) {
+  } catch (e16) {
   }
   return null;
 }
@@ -2377,7 +2541,7 @@ function parseSdkKeyFromFlagsConnectionString(text) {
 async function getOidcToken() {
   try {
     return await _oidc.getVercelOidcToken.call(void 0, );
-  } catch (e16) {
+  } catch (e17) {
     throw new Error(
       [
         "@vercel/flags-core: Failed to get OIDC token.",
@@ -2445,11 +2609,13 @@ function make(createRawClient) {
     const optionsOnly = typeof sdkKeyOrConnectionStringOrOptions === "object" && sdkKeyOrConnectionStringOrOptions !== null;
     const sdkKeyOrConnectionString = optionsOnly ? void 0 : sdkKeyOrConnectionStringOrOptions;
     const createClientOptions = optionsOnly ? sdkKeyOrConnectionStringOrOptions : options;
+    const { experimental_reportExposures, ...controllerOptions } = _nullishCoalesce(createClientOptions, () => ( {}));
     const auth = new Authentication(sdkKeyOrConnectionString);
-    const controller = new Controller({ auth, ...createClientOptions });
+    const controller = new Controller({ auth, ...controllerOptions });
     return createRawClient({
       controller,
-      origin: { provider: "vercel", sdkKey: auth.sdkKey }
+      origin: { provider: "vercel", sdkKey: auth.sdkKey },
+      ...experimental_reportExposures ? { experimental_reportExposures } : {}
     });
   }
   function resetDefaultFlagsClient2() {
@@ -2499,4 +2665,4 @@ var {
 
 
 exports.ResolutionReason = ResolutionReason; exports.evaluate = evaluate; exports.FallbackNotFoundError = FallbackNotFoundError; exports.FallbackEntryNotFoundError = FallbackEntryNotFoundError; exports.Controller = Controller; exports.flagsClient = flagsClient; exports.resetDefaultFlagsClient = resetDefaultFlagsClient; exports.createClient = createClient;
-//# sourceMappingURL=chunk-C3FUDFOP.cjs.map
+//# sourceMappingURL=chunk-5EM5QUML.cjs.map