@vercel/flags-core 1.9.0 → 1.10.0-0037f35-20261006132750

package/dist/index.next-js.d.cts

@@ -1,5 +1,5 @@
-import { V as VariantId, R as ResolutionReason, D as DatafileInput, S as StreamOptions, P as PollingOptions, W as WaitUntil, M as MetricEnvironment, C as ControllerInterface, a as Datafile, B as BundledDefinitions, e as experimental_ReportExposures, E as EvaluationParams, b as EvaluationResult, F as FlagsClient } from './types-1OK52NNi.cjs';
-export { c as Packed, d as Value, f as experimental_EvaluationOptions, g as experimental_ExperimentAssignment, h as experimental_Exposure } from './types-1OK52NNi.cjs';
+import { V as VariantId, R as ResolutionReason, D as DatafileInput, S as StreamOptions, P as PollingOptions, W as WaitUntil, M as MetricEnvironment, C as ControllerInterface, a as Datafile, B as BundledDefinitions, e as experimental_ReportExposures, E as EvaluationParams, b as EvaluationResult, F as FlagsClient } from './types-DpVlT3fI.cjs';
+export { c as Packed, d as Value, f as experimental_EvaluationOptions, g as experimental_ExperimentAssignment, h as experimental_Exposure } from './types-DpVlT3fI.cjs';
 
 interface TrackEvaluationOptions {
     flagKey: string;
@@ -51,6 +51,37 @@ type ControllerOptions = {
      * @default true
      */
     polling?: boolean | PollingOptions;
+    /**
+     * Use request version headers instead of streaming or polling at runtime.
+     * Initialization starts no network activity; reads fetch only when needed.
+     * An evaluation without a version header permanently falls back to stream/poll.
+     * Disabling both stream and polling still selects offline mode.
+     * @default process.env.VERCEL === '1'
+     */
+    vercel?: boolean;
+    /**
+     * How long reads may serve stale cached data while refreshing in the background.
+     * Header-driven reads measure from the last fetch or matching version header.
+     * Streaming data is fresh for 60 seconds after the last message and polling data
+     * for its interval plus the 10-second fetch deadline; this window follows, after
+     * which reads wait for the refresh. Accepts finite, non-negative seconds,
+     * including fractional seconds. Set to 0 to block as soon as data is no longer fresh.
+     * @default 10
+     */
+    staleWhileRevalidate?: number;
+    /**
+     * How long runtime reads may use cached data after the first consecutive
+     * stream/poll/header failure or stream disconnect. Accepts nonnegative seconds or Infinity.
+     * Fractional seconds are supported.
+     * Zero disables fallback immediately; positive windows include the deadline.
+     * Any successful source response, or a matching stream primed revision, resets the
+     * allowance. A routine stream reconnect takes about a second, so keep this above
+     * the reconnect delay. Applies to evaluations and getDatafile(). Without a live
+     * source, data older than staleWhileRevalidate plus this window waits for a refresh.
+     * Build/offline behavior is unchanged.
+     * @default Infinity
+     */
+    staleIfError?: number;
     /**
      * Override build step detection
      * - `true`: Treat as build step (use datafile/bundled only, no network)
@@ -98,14 +129,22 @@ type ControllerOptions = {
  * - No streaming or polling
  *
  * **Runtime — streaming mode** (stream enabled):
- * - Uses streaming exclusively; polling is never started, even if configured
- * - Init fallback (no data yet): constructor datafile → bundled → throw
- * - Read fallback (post-init): in-memory value → constructor datafile → bundled → throw
+ * - Streams exclusively; a startup timeout keeps connecting in the background
+ * - Retains provided/bundled data during startup; fetches if the cache remains empty
+ * - Stale reads serve the cache; expired reads wait for the stream to confirm, never HTTP
+ * - Polling starts only once the stream gives up (retries exhausted, 401, or token failure)
+ * - Without a live source (`degraded`), reads apply stale-while-revalidate over HTTP
  *
  * **Runtime — polling mode** (polling enabled, stream disabled):
- * - Uses polling exclusively
+ * - Uses polling exclusively; a 401 stops polling and reads revalidate over HTTP
  * - Same fallback chains as streaming mode
  *
+ * **Runtime — Vercel mode** (vercel enabled, with stream or polling enabled):
+ * - Loads provided/bundled data before selecting the mode; no startup network
+ * - HeaderSource checks request versions and refreshes when needed
+ * - An evaluation without a valid project version header permanently starts stream/poll
+ * - Cache applies version acceptance and stale-if-error to all served data
+ *
  * **Runtime — offline mode** (neither stream nor polling):
  * - Init fallback: constructor datafile → bundled → one-time fetch → throw
  * - Read fallback: in-memory value → constructor datafile → bundled → one-time fetch → throw
@@ -113,12 +152,15 @@ type ControllerOptions = {
 declare class Controller implements ControllerInterface {
     private options;
     private state;
-    private data;
+    private readonly cache;
     private dataViewSource;
     private dataViewBase;
     private streamSource;
     private pollingSource;
     private bundledSource;
+    private headerSource;
+    private sourceStartup;
+    private readonly degradedReadPolicy;
     private usageTracker;
     private isFirstGetData;
     private buildDataPromise;
@@ -127,13 +169,17 @@ declare class Controller implements ControllerInterface {
     constructor(options: ControllerOptions);
     private onStreamData;
     private onStreamPrimed;
+    private onStreamPing;
     private onStreamConnected;
     private onStreamDisconnected;
-    private onPollData;
-    private onPollError;
+    private onStreamExhausted;
+    private onSourceError;
+    private onPollingError;
     private wireSourceEvents;
     private unwireSourceEvents;
+    private debugState;
     private transition;
+    private get isShutdown();
     private get isConnected();
     private get mode();
     /**
@@ -142,6 +188,7 @@ declare class Controller implements ControllerInterface {
      * Build step: datafile → bundled → one-time fetch
      * Streaming mode: stream → datafile → bundled
      * Polling mode (no stream): poll → datafile → bundled
+     * Vercel mode: datafile → bundled; fetch only on a read
      * Offline mode (neither): datafile → bundled → one-time fetch
      */
     initialize(): Promise<void>;
@@ -154,36 +201,62 @@ declare class Controller implements ControllerInterface {
      */
     shutdown(): Promise<void>;
     /**
-     * Returns the datafile with metrics.
-     * Uses in-memory data if available, otherwise falls back to bundled,
-     * then to a one-time fetch if called without prior initialization.
+     * Returns the datafile with metrics as a snapshot: it never starts streaming
+     * or polling. Cached data is served through the active source policy
+     * (header checks and HTTP revalidation); an empty cache loads bundled
+     * definitions, then performs a one-time fetch.
      */
     getDatafile(): Promise<Datafile>;
     /**
      * Returns the bundled fallback datafile.
      */
     getFallbackDatafile(): Promise<BundledDefinitions>;
+    private toDatafile;
     /**
      * Resolves the current data, using the appropriate strategy for the
      * current mode. Returns tagged data and cache status.
      *
      * Build step: cached → bundled → one-time fetch
-     * Runtime with cache: return cached data
-     * Runtime without cache: stream/poll → datafile → bundled → fetch → throw
+     * Runtime: source policy chooses cached data or refresh; fall back if empty.
      */
     private resolveData;
+    /** Initializes the active runtime source, then resolves through its policy. */
+    private resolveRuntimeData;
     /**
-     * Attempts to initialize via stream with timeout.
-     * Returns true if stream connected successfully within timeout.
+     * Resolves data for getDatafile() without starting a runtime source.
+     * Build step: cached → bundled → one-time fetch
+     * Runtime: cached data through the source policy; otherwise bundled → one-time fetch → throw
+     */
+    private resolveSnapshot;
+    private get cacheReadPolicy();
+    /**
+     * Without a live source nothing confirms the cache, so reads apply plain
+     * stale-while-revalidate over HTTP from the two public windows: data
+     * refreshed within `staleWhileRevalidateMs` is served as is, older data is
+     * served while refreshing in the background, and data older than that
+     * window plus `staleIfErrorMs` is expired and waits for the refresh. An
+     * unknown age is not known to be old, so it refreshes in the background.
+     * Offline clients never refresh.
+     */
+    private createDegradedReadPolicy;
+    /**
+     * Advances through the runtime source chain. Every caller uses the same path:
+     * request headers → stream → polling → direct cache refresh.
+     */
+    private activateFallbackSource;
+    private startFallbackSource;
+    /**
+     * Attempts to initialize via stream with timeout. A timeout leaves the
+     * stream connecting in the background; a rejection means it gave up.
      */
     private tryInitializeStream;
     /**
-     * Attempts to initialize via polling with timeout.
-     * Returns true if first poll succeeded within timeout.
-     *
-     * Only used when streaming is disabled and polling is the primary source.
+     * Waits for the first poll whenever polling becomes the active runtime source.
+     * On timeout, initialization falls back while the pending poll and interval
+     * continue in the background. Poll errors propagate if no data is cached or
+     * the client is shutting down.
      */
-    private tryInitializePolling;
+    private initializePolling;
     private noteUnauthorized;
     /**
      * Initializes data for build step environments.
@@ -192,13 +265,19 @@ declare class Controller implements ControllerInterface {
     /**
      * Retrieves data during build steps.
      * Concurrent callers share a single load promise. The first caller to
-     * populate `this.data` gets cacheStatus MISS; subsequent callers get HIT.
+     * populate the cache gets cacheStatus MISS; subsequent callers get HIT.
      */
     private resolveDataForBuildStep;
     /**
      * Loads data for a build step: bundled → one-time fetch.
      */
     private loadBuildData;
+    private fetchOnce;
+    /**
+     * Stores a last-resort fetch as a source response, which clears any failure,
+     * and serves it through the cache boundary.
+     */
+    private acceptLastResortFetch;
     /**
      * Shared fallback chain used by both initialize() and resolveData().
      */
@@ -209,24 +288,10 @@ declare class Controller implements ControllerInterface {
      */
     private noDefinitionsError;
     /**
-     * Retrieves data using the fallback chain (called when no cached data exists).
-     * Streaming mode: stream → datafile → bundled.
-     * Polling mode: poll → datafile → bundled.
-     * Offline mode: datafile → bundled → one-time fetch.
-     */
-    private resolveDataWithFallbacks;
-    /**
-     * Checks if the incoming data is newer than the current in-memory data.
-     * Returns true if the update should proceed, false if it should be skipped.
-     *
-     * Always accepts the update if:
-     * - There is no current data
-     * - The current data has no configUpdatedAt
-     * - The incoming data has no configUpdatedAt
-     *
-     * Skips the update only when both have configUpdatedAt and incoming is not newer.
+     * Retrieves data when the cache is empty in offline mode:
+     * datafile → bundled → one-time fetch.
      */
-    private isNewerData;
+    private resolveStaticFallbackData;
     /**
      * Tracks a read operation for usage analytics.
      * During build steps, only the first read is tracked.

package/dist/index.next-js.d.ts

@@ -1,5 +1,5 @@
-import { V as VariantId, R as ResolutionReason, D as DatafileInput, S as StreamOptions, P as PollingOptions, W as WaitUntil, M as MetricEnvironment, C as ControllerInterface, a as Datafile, B as BundledDefinitions, e as experimental_ReportExposures, E as EvaluationParams, b as EvaluationResult, F as FlagsClient } from './types-1OK52NNi.js';
-export { c as Packed, d as Value, f as experimental_EvaluationOptions, g as experimental_ExperimentAssignment, h as experimental_Exposure } from './types-1OK52NNi.js';
+import { V as VariantId, R as ResolutionReason, D as DatafileInput, S as StreamOptions, P as PollingOptions, W as WaitUntil, M as MetricEnvironment, C as ControllerInterface, a as Datafile, B as BundledDefinitions, e as experimental_ReportExposures, E as EvaluationParams, b as EvaluationResult, F as FlagsClient } from './types-DpVlT3fI.js';
+export { c as Packed, d as Value, f as experimental_EvaluationOptions, g as experimental_ExperimentAssignment, h as experimental_Exposure } from './types-DpVlT3fI.js';
 
 interface TrackEvaluationOptions {
     flagKey: string;
@@ -51,6 +51,37 @@ type ControllerOptions = {
      * @default true
      */
     polling?: boolean | PollingOptions;
+    /**
+     * Use request version headers instead of streaming or polling at runtime.
+     * Initialization starts no network activity; reads fetch only when needed.
+     * An evaluation without a version header permanently falls back to stream/poll.
+     * Disabling both stream and polling still selects offline mode.
+     * @default process.env.VERCEL === '1'
+     */
+    vercel?: boolean;
+    /**
+     * How long reads may serve stale cached data while refreshing in the background.
+     * Header-driven reads measure from the last fetch or matching version header.
+     * Streaming data is fresh for 60 seconds after the last message and polling data
+     * for its interval plus the 10-second fetch deadline; this window follows, after
+     * which reads wait for the refresh. Accepts finite, non-negative seconds,
+     * including fractional seconds. Set to 0 to block as soon as data is no longer fresh.
+     * @default 10
+     */
+    staleWhileRevalidate?: number;
+    /**
+     * How long runtime reads may use cached data after the first consecutive
+     * stream/poll/header failure or stream disconnect. Accepts nonnegative seconds or Infinity.
+     * Fractional seconds are supported.
+     * Zero disables fallback immediately; positive windows include the deadline.
+     * Any successful source response, or a matching stream primed revision, resets the
+     * allowance. A routine stream reconnect takes about a second, so keep this above
+     * the reconnect delay. Applies to evaluations and getDatafile(). Without a live
+     * source, data older than staleWhileRevalidate plus this window waits for a refresh.
+     * Build/offline behavior is unchanged.
+     * @default Infinity
+     */
+    staleIfError?: number;
     /**
      * Override build step detection
      * - `true`: Treat as build step (use datafile/bundled only, no network)
@@ -98,14 +129,22 @@ type ControllerOptions = {
  * - No streaming or polling
  *
  * **Runtime — streaming mode** (stream enabled):
- * - Uses streaming exclusively; polling is never started, even if configured
- * - Init fallback (no data yet): constructor datafile → bundled → throw
- * - Read fallback (post-init): in-memory value → constructor datafile → bundled → throw
+ * - Streams exclusively; a startup timeout keeps connecting in the background
+ * - Retains provided/bundled data during startup; fetches if the cache remains empty
+ * - Stale reads serve the cache; expired reads wait for the stream to confirm, never HTTP
+ * - Polling starts only once the stream gives up (retries exhausted, 401, or token failure)
+ * - Without a live source (`degraded`), reads apply stale-while-revalidate over HTTP
  *
  * **Runtime — polling mode** (polling enabled, stream disabled):
- * - Uses polling exclusively
+ * - Uses polling exclusively; a 401 stops polling and reads revalidate over HTTP
  * - Same fallback chains as streaming mode
  *
+ * **Runtime — Vercel mode** (vercel enabled, with stream or polling enabled):
+ * - Loads provided/bundled data before selecting the mode; no startup network
+ * - HeaderSource checks request versions and refreshes when needed
+ * - An evaluation without a valid project version header permanently starts stream/poll
+ * - Cache applies version acceptance and stale-if-error to all served data
+ *
  * **Runtime — offline mode** (neither stream nor polling):
  * - Init fallback: constructor datafile → bundled → one-time fetch → throw
  * - Read fallback: in-memory value → constructor datafile → bundled → one-time fetch → throw
@@ -113,12 +152,15 @@ type ControllerOptions = {
 declare class Controller implements ControllerInterface {
     private options;
     private state;
-    private data;
+    private readonly cache;
     private dataViewSource;
     private dataViewBase;
     private streamSource;
     private pollingSource;
     private bundledSource;
+    private headerSource;
+    private sourceStartup;
+    private readonly degradedReadPolicy;
     private usageTracker;
     private isFirstGetData;
     private buildDataPromise;
@@ -127,13 +169,17 @@ declare class Controller implements ControllerInterface {
     constructor(options: ControllerOptions);
     private onStreamData;
     private onStreamPrimed;
+    private onStreamPing;
     private onStreamConnected;
     private onStreamDisconnected;
-    private onPollData;
-    private onPollError;
+    private onStreamExhausted;
+    private onSourceError;
+    private onPollingError;
     private wireSourceEvents;
     private unwireSourceEvents;
+    private debugState;
     private transition;
+    private get isShutdown();
     private get isConnected();
     private get mode();
     /**
@@ -142,6 +188,7 @@ declare class Controller implements ControllerInterface {
      * Build step: datafile → bundled → one-time fetch
      * Streaming mode: stream → datafile → bundled
      * Polling mode (no stream): poll → datafile → bundled
+     * Vercel mode: datafile → bundled; fetch only on a read
      * Offline mode (neither): datafile → bundled → one-time fetch
      */
     initialize(): Promise<void>;
@@ -154,36 +201,62 @@ declare class Controller implements ControllerInterface {
      */
     shutdown(): Promise<void>;
     /**
-     * Returns the datafile with metrics.
-     * Uses in-memory data if available, otherwise falls back to bundled,
-     * then to a one-time fetch if called without prior initialization.
+     * Returns the datafile with metrics as a snapshot: it never starts streaming
+     * or polling. Cached data is served through the active source policy
+     * (header checks and HTTP revalidation); an empty cache loads bundled
+     * definitions, then performs a one-time fetch.
      */
     getDatafile(): Promise<Datafile>;
     /**
      * Returns the bundled fallback datafile.
      */
     getFallbackDatafile(): Promise<BundledDefinitions>;
+    private toDatafile;
     /**
      * Resolves the current data, using the appropriate strategy for the
      * current mode. Returns tagged data and cache status.
      *
      * Build step: cached → bundled → one-time fetch
-     * Runtime with cache: return cached data
-     * Runtime without cache: stream/poll → datafile → bundled → fetch → throw
+     * Runtime: source policy chooses cached data or refresh; fall back if empty.
      */
     private resolveData;
+    /** Initializes the active runtime source, then resolves through its policy. */
+    private resolveRuntimeData;
     /**
-     * Attempts to initialize via stream with timeout.
-     * Returns true if stream connected successfully within timeout.
+     * Resolves data for getDatafile() without starting a runtime source.
+     * Build step: cached → bundled → one-time fetch
+     * Runtime: cached data through the source policy; otherwise bundled → one-time fetch → throw
+     */
+    private resolveSnapshot;
+    private get cacheReadPolicy();
+    /**
+     * Without a live source nothing confirms the cache, so reads apply plain
+     * stale-while-revalidate over HTTP from the two public windows: data
+     * refreshed within `staleWhileRevalidateMs` is served as is, older data is
+     * served while refreshing in the background, and data older than that
+     * window plus `staleIfErrorMs` is expired and waits for the refresh. An
+     * unknown age is not known to be old, so it refreshes in the background.
+     * Offline clients never refresh.
+     */
+    private createDegradedReadPolicy;
+    /**
+     * Advances through the runtime source chain. Every caller uses the same path:
+     * request headers → stream → polling → direct cache refresh.
+     */
+    private activateFallbackSource;
+    private startFallbackSource;
+    /**
+     * Attempts to initialize via stream with timeout. A timeout leaves the
+     * stream connecting in the background; a rejection means it gave up.
      */
     private tryInitializeStream;
     /**
-     * Attempts to initialize via polling with timeout.
-     * Returns true if first poll succeeded within timeout.
-     *
-     * Only used when streaming is disabled and polling is the primary source.
+     * Waits for the first poll whenever polling becomes the active runtime source.
+     * On timeout, initialization falls back while the pending poll and interval
+     * continue in the background. Poll errors propagate if no data is cached or
+     * the client is shutting down.
      */
-    private tryInitializePolling;
+    private initializePolling;
     private noteUnauthorized;
     /**
      * Initializes data for build step environments.
@@ -192,13 +265,19 @@ declare class Controller implements ControllerInterface {
     /**
      * Retrieves data during build steps.
      * Concurrent callers share a single load promise. The first caller to
-     * populate `this.data` gets cacheStatus MISS; subsequent callers get HIT.
+     * populate the cache gets cacheStatus MISS; subsequent callers get HIT.
      */
     private resolveDataForBuildStep;
     /**
      * Loads data for a build step: bundled → one-time fetch.
      */
     private loadBuildData;
+    private fetchOnce;
+    /**
+     * Stores a last-resort fetch as a source response, which clears any failure,
+     * and serves it through the cache boundary.
+     */
+    private acceptLastResortFetch;
     /**
      * Shared fallback chain used by both initialize() and resolveData().
      */
@@ -209,24 +288,10 @@ declare class Controller implements ControllerInterface {
      */
     private noDefinitionsError;
     /**
-     * Retrieves data using the fallback chain (called when no cached data exists).
-     * Streaming mode: stream → datafile → bundled.
-     * Polling mode: poll → datafile → bundled.
-     * Offline mode: datafile → bundled → one-time fetch.
-     */
-    private resolveDataWithFallbacks;
-    /**
-     * Checks if the incoming data is newer than the current in-memory data.
-     * Returns true if the update should proceed, false if it should be skipped.
-     *
-     * Always accepts the update if:
-     * - There is no current data
-     * - The current data has no configUpdatedAt
-     * - The incoming data has no configUpdatedAt
-     *
-     * Skips the update only when both have configUpdatedAt and incoming is not newer.
+     * Retrieves data when the cache is empty in offline mode:
+     * datafile → bundled → one-time fetch.
      */
-    private isNewerData;
+    private resolveStaticFallbackData;
     /**
      * Tracks a read operation for usage analytics.
      * During build steps, only the first read is tracked.

package/dist/index.next-js.js

@@ -7,7 +7,7 @@ import {
   evaluate,
   flagsClient,
   resetDefaultFlagsClient
-} from "./chunk-TDZBUVBG.js";
+} from "./chunk-D4522FGO.js";
 export {
   Controller,
   FallbackEntryNotFoundError,

package/dist/openfeature.default.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); var _class;
 
 
-var _chunkPGKH4XQ7cjs = require('./chunk-PGKH4XQ7.cjs');
+var _chunkITB5XQD3cjs = require('./chunk-ITB5XQD3.cjs');
 
 // src/openfeature.make.ts
 
@@ -150,7 +150,7 @@ function make(createClient2, defaultFlagsClient) {
 }
 
 // src/openfeature.default.ts
-var VercelProvider = make(_chunkPGKH4XQ7cjs.createClient, _chunkPGKH4XQ7cjs.flagsClient);
+var VercelProvider = make(_chunkITB5XQD3cjs.createClient, _chunkITB5XQD3cjs.flagsClient);
 
 
 exports.VercelProvider = VercelProvider;

package/dist/openfeature.default.d.cts

@@ -1,4 +1,4 @@
-import { F as FlagsClient } from './types-1OK52NNi.cjs';
+import { F as FlagsClient } from './types-DpVlT3fI.cjs';
 import * as _openfeature_server_sdk from '@openfeature/server-sdk';
 
 /**

package/dist/openfeature.default.d.ts

@@ -1,4 +1,4 @@
-import { F as FlagsClient } from './types-1OK52NNi.js';
+import { F as FlagsClient } from './types-DpVlT3fI.js';
 import * as _openfeature_server_sdk from '@openfeature/server-sdk';
 
 /**

package/dist/openfeature.default.js

@@ -1,7 +1,7 @@
 import {
   createClient,
   flagsClient
-} from "./chunk-SLNLPFKU.js";
+} from "./chunk-SYXANNZ4.js";
 
 // src/openfeature.make.ts
 import {

package/dist/openfeature.next-js.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); var _class;
 
 
-var _chunkW742GGZUcjs = require('./chunk-W742GGZU.cjs');
+var _chunkW6776MKFcjs = require('./chunk-W6776MKF.cjs');
 
 // src/openfeature.make.ts
 
@@ -150,7 +150,7 @@ function make(createClient2, defaultFlagsClient) {
 }
 
 // src/openfeature.next-js.ts
-var VercelProvider = make(_chunkW742GGZUcjs.createClient, _chunkW742GGZUcjs.flagsClient);
+var VercelProvider = make(_chunkW6776MKFcjs.createClient, _chunkW6776MKFcjs.flagsClient);
 
 
 exports.VercelProvider = VercelProvider;

package/dist/openfeature.next-js.d.cts

@@ -1,4 +1,4 @@
-import { F as FlagsClient } from './types-1OK52NNi.cjs';
+import { F as FlagsClient } from './types-DpVlT3fI.cjs';
 import * as _openfeature_server_sdk from '@openfeature/server-sdk';
 
 /**

package/dist/openfeature.next-js.d.ts

@@ -1,4 +1,4 @@
-import { F as FlagsClient } from './types-1OK52NNi.js';
+import { F as FlagsClient } from './types-DpVlT3fI.js';
 import * as _openfeature_server_sdk from '@openfeature/server-sdk';
 
 /**

package/dist/openfeature.next-js.js

@@ -1,7 +1,7 @@
 import {
   createClient,
   flagsClient
-} from "./chunk-TDZBUVBG.js";
+} from "./chunk-D4522FGO.js";
 
 // src/openfeature.make.ts
 import {

package/dist/{types-1OK52NNi.d.cts → types-DpVlT3fI.d.cts}

@@ -31,6 +31,12 @@ type DatafileInput = Packed.Data & {
      * Some older responses might return a string instead of a number. Both will be timestamps.
      */
     configUpdatedAt?: number | string;
+    /**
+     * When this datafile was successfully fetched, as Unix epoch milliseconds.
+     * Preserved when bundled, serialized, or supplied to another client.
+     * Omit when the original fetch time is unknown; loading data does not reset it.
+     */
+    fetchedAt?: number;
     /** Version number of the data */
     revision?: number;
 };
@@ -61,7 +67,7 @@ type Metrics = {
     /** Whether the stream is currently connected */
     connectionState: 'connected' | 'disconnected';
     /** The current operating mode of the client */
-    mode: 'streaming' | 'polling' | 'build' | 'offline';
+    mode: 'streaming' | 'polling' | 'build' | 'vercel' | 'offline';
     /** Time in ms for the pure flag evaluation logic (only present on EvaluationResult) */
     evaluationMs?: number;
 };

package/dist/{types-1OK52NNi.d.ts → types-DpVlT3fI.d.ts}

@@ -31,6 +31,12 @@ type DatafileInput = Packed.Data & {
      * Some older responses might return a string instead of a number. Both will be timestamps.
      */
     configUpdatedAt?: number | string;
+    /**
+     * When this datafile was successfully fetched, as Unix epoch milliseconds.
+     * Preserved when bundled, serialized, or supplied to another client.
+     * Omit when the original fetch time is unknown; loading data does not reset it.
+     */
+    fetchedAt?: number;
     /** Version number of the data */
     revision?: number;
 };
@@ -61,7 +67,7 @@ type Metrics = {
     /** Whether the stream is currently connected */
     connectionState: 'connected' | 'disconnected';
     /** The current operating mode of the client */
-    mode: 'streaming' | 'polling' | 'build' | 'offline';
+    mode: 'streaming' | 'polling' | 'build' | 'vercel' | 'offline';
     /** Time in ms for the pure flag evaluation logic (only present on EvaluationResult) */
     evaluationMs?: number;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/flags-core",
-  "version": "1.9.0",
+  "version": "1.10.0-0037f35-20261006132750",
   "description": "A server-side client for Vercel Flags",
   "keywords": [
     "vercel",