@vercel/flags-core 1.8.1 → 1.8.2

package/dist/index.next-js.cjs

@@ -7,7 +7,7 @@
 
 
 
-var _chunkCKL562EUcjs = require('./chunk-CKL562EU.cjs');
+var _chunk3WMSFQ2Fcjs = require('./chunk-3WMSFQ2F.cjs');
 
 
 
@@ -18,5 +18,5 @@ var _chunkCKL562EUcjs = require('./chunk-CKL562EU.cjs');
 
 
 
-exports.Controller = _chunkCKL562EUcjs.Controller; exports.FallbackEntryNotFoundError = _chunkCKL562EUcjs.FallbackEntryNotFoundError; exports.FallbackNotFoundError = _chunkCKL562EUcjs.FallbackNotFoundError; exports.FlagNetworkDataSource = _chunkCKL562EUcjs.Controller; exports.Reason = _chunkCKL562EUcjs.ResolutionReason; exports.createClient = _chunkCKL562EUcjs.createClient; exports.evaluate = _chunkCKL562EUcjs.evaluate; exports.flagsClient = _chunkCKL562EUcjs.flagsClient; exports.resetDefaultFlagsClient = _chunkCKL562EUcjs.resetDefaultFlagsClient;
+exports.Controller = _chunk3WMSFQ2Fcjs.Controller; exports.FallbackEntryNotFoundError = _chunk3WMSFQ2Fcjs.FallbackEntryNotFoundError; exports.FallbackNotFoundError = _chunk3WMSFQ2Fcjs.FallbackNotFoundError; exports.FlagNetworkDataSource = _chunk3WMSFQ2Fcjs.Controller; exports.Reason = _chunk3WMSFQ2Fcjs.ResolutionReason; exports.createClient = _chunk3WMSFQ2Fcjs.createClient; exports.evaluate = _chunk3WMSFQ2Fcjs.evaluate; exports.flagsClient = _chunk3WMSFQ2Fcjs.flagsClient; exports.resetDefaultFlagsClient = _chunk3WMSFQ2Fcjs.resetDefaultFlagsClient;
 //# sourceMappingURL=index.next-js.cjs.map

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, 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-CIONStRG.cjs';
-export { c as Packed, d as Value, f as experimental_EvaluationOptions, g as experimental_ExperimentAssignment, h as experimental_Exposure } from './types-CIONStRG.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-DLWRa9bG.cjs';
+export { c as Packed, d as Value, f as experimental_EvaluationOptions, g as experimental_ExperimentAssignment, h as experimental_Exposure } from './types-DLWRa9bG.cjs';
 
 interface TrackEvaluationOptions {
     flagKey: string;
@@ -62,6 +62,12 @@ type ControllerOptions = {
      * @default globalThis.fetch
      */
     fetch?: typeof globalThis.fetch;
+    /**
+     * Custom function for keeping background work alive after a response has
+     * been sent.
+     * @default waitUntil from `@vercel/functions`
+     */
+    waitUntil?: WaitUntil;
     /**
      * Environment included with evaluation metrics sent to the ingest endpoint.
      * Falls back to the `VERCEL_ENV` environment variable when not set.
@@ -280,4 +286,4 @@ declare const createClient: {
     <Entities = Record<string, unknown>>(sdkKeyOrConnectionString?: string, options?: CreateClientOptions<Entities>): FlagsClient<Entities>;
 };
 
-export { BundledDefinitions, Controller, type ControllerOptions, type CreateClientOptions, Datafile, DatafileInput, EvaluationParams, EvaluationResult, FallbackEntryNotFoundError, FallbackNotFoundError, Controller as FlagNetworkDataSource, type ControllerOptions as FlagNetworkDataSourceOptions, FlagsClient, PollingOptions, ResolutionReason as Reason, StreamOptions, createClient, evaluate, experimental_ReportExposures, flagsClient, resetDefaultFlagsClient };
+export { BundledDefinitions, Controller, type ControllerOptions, type CreateClientOptions, Datafile, DatafileInput, EvaluationParams, EvaluationResult, FallbackEntryNotFoundError, FallbackNotFoundError, Controller as FlagNetworkDataSource, type ControllerOptions as FlagNetworkDataSourceOptions, FlagsClient, PollingOptions, ResolutionReason as Reason, StreamOptions, WaitUntil, createClient, evaluate, experimental_ReportExposures, flagsClient, resetDefaultFlagsClient };

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, 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-CIONStRG.js';
-export { c as Packed, d as Value, f as experimental_EvaluationOptions, g as experimental_ExperimentAssignment, h as experimental_Exposure } from './types-CIONStRG.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-DLWRa9bG.js';
+export { c as Packed, d as Value, f as experimental_EvaluationOptions, g as experimental_ExperimentAssignment, h as experimental_Exposure } from './types-DLWRa9bG.js';
 
 interface TrackEvaluationOptions {
     flagKey: string;
@@ -62,6 +62,12 @@ type ControllerOptions = {
      * @default globalThis.fetch
      */
     fetch?: typeof globalThis.fetch;
+    /**
+     * Custom function for keeping background work alive after a response has
+     * been sent.
+     * @default waitUntil from `@vercel/functions`
+     */
+    waitUntil?: WaitUntil;
     /**
      * Environment included with evaluation metrics sent to the ingest endpoint.
      * Falls back to the `VERCEL_ENV` environment variable when not set.
@@ -280,4 +286,4 @@ declare const createClient: {
     <Entities = Record<string, unknown>>(sdkKeyOrConnectionString?: string, options?: CreateClientOptions<Entities>): FlagsClient<Entities>;
 };
 
-export { BundledDefinitions, Controller, type ControllerOptions, type CreateClientOptions, Datafile, DatafileInput, EvaluationParams, EvaluationResult, FallbackEntryNotFoundError, FallbackNotFoundError, Controller as FlagNetworkDataSource, type ControllerOptions as FlagNetworkDataSourceOptions, FlagsClient, PollingOptions, ResolutionReason as Reason, StreamOptions, createClient, evaluate, experimental_ReportExposures, flagsClient, resetDefaultFlagsClient };
+export { BundledDefinitions, Controller, type ControllerOptions, type CreateClientOptions, Datafile, DatafileInput, EvaluationParams, EvaluationResult, FallbackEntryNotFoundError, FallbackNotFoundError, Controller as FlagNetworkDataSource, type ControllerOptions as FlagNetworkDataSourceOptions, FlagsClient, PollingOptions, ResolutionReason as Reason, StreamOptions, WaitUntil, createClient, evaluate, experimental_ReportExposures, flagsClient, resetDefaultFlagsClient };

package/dist/index.next-js.js

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

package/dist/openfeature.default.cjs

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

package/dist/openfeature.default.d.cts

@@ -1,4 +1,4 @@
-import { F as FlagsClient } from './types-CIONStRG.cjs';
+import { F as FlagsClient } from './types-DLWRa9bG.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-CIONStRG.js';
+import { F as FlagsClient } from './types-DLWRa9bG.js';
 import * as _openfeature_server_sdk from '@openfeature/server-sdk';
 
 /**

package/dist/openfeature.default.js

@@ -1,7 +1,7 @@
 import {
   createClient,
   flagsClient
-} from "./chunk-5BWCBI7I.js";
+} from "./chunk-AMDRNXFQ.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 _chunkCKL562EUcjs = require('./chunk-CKL562EU.cjs');
+var _chunk3WMSFQ2Fcjs = require('./chunk-3WMSFQ2F.cjs');
 
 // src/openfeature.make.ts
 
@@ -150,7 +150,7 @@ function make(createClient2, defaultFlagsClient) {
 }
 
 // src/openfeature.next-js.ts
-var VercelProvider = make(_chunkCKL562EUcjs.createClient, _chunkCKL562EUcjs.flagsClient);
+var VercelProvider = make(_chunk3WMSFQ2Fcjs.createClient, _chunk3WMSFQ2Fcjs.flagsClient);
 
 
 exports.VercelProvider = VercelProvider;

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

@@ -1,4 +1,4 @@
-import { F as FlagsClient } from './types-CIONStRG.cjs';
+import { F as FlagsClient } from './types-DLWRa9bG.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-CIONStRG.js';
+import { F as FlagsClient } from './types-DLWRa9bG.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-DYSF37WV.js";
+} from "./chunk-KK44WKSW.js";
 
 // src/openfeature.make.ts
 import {

package/dist/{types-CIONStRG.d.cts → types-DLWRa9bG.d.cts}

@@ -15,6 +15,8 @@ type PollingOptions = {
     /** Timeout in ms to wait for initial poll before falling back */
     initTimeoutMs: number;
 };
+/** Keeps an asynchronous task alive after a response has been sent */
+type WaitUntil = (promise: Promise<unknown>) => void;
 /** Input type for creating a datafile (without metrics) */
 type DatafileInput = Packed.Data & {
     /**
@@ -156,9 +158,11 @@ type FlagsClient<Entities = Record<string, unknown>> = {
         sdkKey?: string;
     };
     /**
-     * Evaluate a feature flag
+     * Evaluate a feature flag.
      *
-     * Requires initialize() to have been called and awaited first.
+     * Initializes the client automatically on first use. Initialization failures
+     * are caught so evaluation can try its fallback sources and defaultValue.
+     * With request-scoped Vercel OIDC, call this inside a request handler.
      *
      * @param flagKey
      * @param defaultValue
@@ -173,7 +177,9 @@ type FlagsClient<Entities = Record<string, unknown>> = {
      * Avoids the per-flag overhead of separate `evaluate()` invocations (in particular,
      * the parallel promises and repeated datafile reads they would entail).
      *
-     * Requires initialize() to have been called and awaited first.
+     * Initializes the client automatically on first use. Initialization failures
+     * are caught so evaluation can try its fallback sources and default values.
+     * With request-scoped Vercel OIDC, call this inside a request handler.
      *
      * @param flags Array of `{ key, defaultValue? }` entries to evaluate.
      * @param entities Shared entities used for every flag in the bulk call.
@@ -193,7 +199,13 @@ type FlagsClient<Entities = Record<string, unknown>> = {
         entities?: E;
     }) => Promise<void>;
     /**
-     * Retrieve the latest datafile during startup, and set up subscriptions if needed.
+     * Load flag definitions and set up subscriptions if needed.
+     *
+     * Optional: evaluate() and bulkEvaluate() initialize automatically. This method
+     * rejects if initialization fails, while evaluation can still try fallbacks.
+     * With request-scoped Vercel OIDC, call this inside a request handler, not at
+     * module scope. Creating the client at module scope is safe; starting and
+     * caching an initialization promise there can run before a token is available.
      */
     initialize(): void | Promise<void>;
     /**
@@ -677,4 +689,4 @@ declare namespace Packed {
     };
 }
 
-export { type BundledDefinitions as B, type ControllerInterface as C, type DatafileInput as D, type EvaluationParams as E, type FlagsClient as F, type MetricEnvironment as M, type PollingOptions as P, ResolutionReason as R, type StreamOptions as S, type VariantId as V, type Datafile as a, type EvaluationResult as b, Packed as c, type Value as d, type experimental_ReportExposures as e, type experimental_EvaluationOptions as f, type experimental_ExperimentAssignment as g, type experimental_Exposure as h };
+export { type BundledDefinitions as B, type ControllerInterface as C, type DatafileInput as D, type EvaluationParams as E, type FlagsClient as F, type MetricEnvironment as M, type PollingOptions as P, ResolutionReason as R, type StreamOptions as S, type VariantId as V, type WaitUntil as W, type Datafile as a, type EvaluationResult as b, Packed as c, type Value as d, type experimental_ReportExposures as e, type experimental_EvaluationOptions as f, type experimental_ExperimentAssignment as g, type experimental_Exposure as h };

package/dist/{types-CIONStRG.d.ts → types-DLWRa9bG.d.ts}

@@ -15,6 +15,8 @@ type PollingOptions = {
     /** Timeout in ms to wait for initial poll before falling back */
     initTimeoutMs: number;
 };
+/** Keeps an asynchronous task alive after a response has been sent */
+type WaitUntil = (promise: Promise<unknown>) => void;
 /** Input type for creating a datafile (without metrics) */
 type DatafileInput = Packed.Data & {
     /**
@@ -156,9 +158,11 @@ type FlagsClient<Entities = Record<string, unknown>> = {
         sdkKey?: string;
     };
     /**
-     * Evaluate a feature flag
+     * Evaluate a feature flag.
      *
-     * Requires initialize() to have been called and awaited first.
+     * Initializes the client automatically on first use. Initialization failures
+     * are caught so evaluation can try its fallback sources and defaultValue.
+     * With request-scoped Vercel OIDC, call this inside a request handler.
      *
      * @param flagKey
      * @param defaultValue
@@ -173,7 +177,9 @@ type FlagsClient<Entities = Record<string, unknown>> = {
      * Avoids the per-flag overhead of separate `evaluate()` invocations (in particular,
      * the parallel promises and repeated datafile reads they would entail).
      *
-     * Requires initialize() to have been called and awaited first.
+     * Initializes the client automatically on first use. Initialization failures
+     * are caught so evaluation can try its fallback sources and default values.
+     * With request-scoped Vercel OIDC, call this inside a request handler.
      *
      * @param flags Array of `{ key, defaultValue? }` entries to evaluate.
      * @param entities Shared entities used for every flag in the bulk call.
@@ -193,7 +199,13 @@ type FlagsClient<Entities = Record<string, unknown>> = {
         entities?: E;
     }) => Promise<void>;
     /**
-     * Retrieve the latest datafile during startup, and set up subscriptions if needed.
+     * Load flag definitions and set up subscriptions if needed.
+     *
+     * Optional: evaluate() and bulkEvaluate() initialize automatically. This method
+     * rejects if initialization fails, while evaluation can still try fallbacks.
+     * With request-scoped Vercel OIDC, call this inside a request handler, not at
+     * module scope. Creating the client at module scope is safe; starting and
+     * caching an initialization promise there can run before a token is available.
      */
     initialize(): void | Promise<void>;
     /**
@@ -677,4 +689,4 @@ declare namespace Packed {
     };
 }
 
-export { type BundledDefinitions as B, type ControllerInterface as C, type DatafileInput as D, type EvaluationParams as E, type FlagsClient as F, type MetricEnvironment as M, type PollingOptions as P, ResolutionReason as R, type StreamOptions as S, type VariantId as V, type Datafile as a, type EvaluationResult as b, Packed as c, type Value as d, type experimental_ReportExposures as e, type experimental_EvaluationOptions as f, type experimental_ExperimentAssignment as g, type experimental_Exposure as h };
+export { type BundledDefinitions as B, type ControllerInterface as C, type DatafileInput as D, type EvaluationParams as E, type FlagsClient as F, type MetricEnvironment as M, type PollingOptions as P, ResolutionReason as R, type StreamOptions as S, type VariantId as V, type WaitUntil as W, type Datafile as a, type EvaluationResult as b, Packed as c, type Value as d, type experimental_ReportExposures as e, type experimental_EvaluationOptions as f, type experimental_ExperimentAssignment as g, type experimental_Exposure as h };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/flags-core",
-  "version": "1.8.1",
+  "version": "1.8.2",
   "description": "A server-side client for Vercel Flags",
   "keywords": [
     "vercel",