@openfeature/react-sdk 0.2.4-experimental → 0.3.0-experimental

package/README.md

@@ -16,8 +16,8 @@
     <img alt="Specification" src="https://img.shields.io/static/v1?label=specification&message=v0.7.0&color=yellow&style=for-the-badge" />
   </a>
   <!-- x-release-please-start-version -->
-  <a href="https://github.com/open-feature/js-sdk/releases/tag/react-sdk-v0.2.4-experimental">
-    <img alt="Release" src="https://img.shields.io/static/v1?label=release&message=v0.2.4-experimental&color=blue&style=for-the-badge" />
+  <a href="https://github.com/open-feature/js-sdk/releases/tag/react-sdk-v0.3.0-experimental">
+    <img alt="Release" src="https://img.shields.io/static/v1?label=release&message=v0.3.0-experimental&color=blue&style=for-the-badge" />
   </a>
   <!-- x-release-please-end -->
   <br/>
@@ -50,10 +50,13 @@ In addition to the feature provided by the [web sdk](https://openfeature.dev/doc
     - [yarn](#yarn)
     - [Required peer dependencies](#required-peer-dependencies)
   - [Usage](#usage)
-  - [Multiple Providers and Domains](#multiple-providers-and-domains)
-  - [Re-rendering with Context Changes](#re-rendering-with-context-changes)
-  - [Re-rendering with Flag Configuration Changes](#re-rendering-with-flag-configuration-changes)
-  - [Suspense Support](#suspense-support)
+    - [OpenFeatureProvider context provider](#openfeatureprovider-context-provider)
+    - [Evaluation hooks](#evaluation-hooks)
+    - [Multiple Providers and Domains](#multiple-providers-and-domains)
+    - [Re-rendering with Context Changes](#re-rendering-with-context-changes)
+    - [Re-rendering with Flag Configuration Changes](#re-rendering-with-flag-configuration-changes)
+    - [Suspense Support](#suspense-support)
+- [FAQ and troubleshooting](#faq-and-troubleshooting)
 - [Resources](#resources)
 
 ## Quick start
@@ -87,7 +90,9 @@ The following list contains the peer dependencies of `@openfeature/react-sdk` wi
 
 ### Usage
 
-The `OpenFeatureProvider` represents a scope for feature flag evaluations within a React application.
+#### OpenFeatureProvider context provider
+
+The `OpenFeatureProvider` is a [React context provider](https://react.dev/reference/react/createContext#provider) which represents a scope for feature flag evaluations within a React application.
 It binds an OpenFeature client to all evaluations within child components, and allows the use of evaluation hooks.
 The example below shows how to use the `OpenFeatureProvider` with OpenFeature's `InMemoryProvider`.
 
@@ -123,9 +128,15 @@ function App() {
     </OpenFeatureProvider>
   );
 }
+```
+
+#### Evaluation hooks
 
+Within the provider, you can use the various evaluation hooks to evaluate flags. 
+
+```tsx
 function Page() {
-  // Use the "query-style" flag evaluation hook.
+  // Use the "query-style" flag evaluation hook, specifying a flag-key and a default value.
   const { value: showNewMessage } = useFlag('new-message', true);
   return (
     <div className="App">
@@ -135,9 +146,8 @@ function Page() {
     </div>
   )
 }
-
-export default App;
 ```
+
 You can use the strongly-typed flag value and flag evaluation detail hooks as well, if you prefer.
 
 ```tsx
@@ -159,8 +169,7 @@ const {
 } = useBooleanFlagDetails('new-message', false);
 ```
 
-### Multiple Providers and Domains
-
+#### Multiple Providers and Domains
 
 Multiple providers can be used by passing a `domain` to the `OpenFeatureProvider`:
 
@@ -183,11 +192,11 @@ OpenFeature.getClient('my-domain');
 
 For more information about `domains`, refer to the [web SDK](https://github.com/open-feature/js-sdk/blob/main/packages/client/README.md).
 
-### Re-rendering with Context Changes
+#### Re-rendering with Context Changes
 
 By default, if the OpenFeature [evaluation context](https://openfeature.dev/docs/reference/concepts/evaluation-context) is modified, components will be re-rendered.
 This is useful in cases where flag values are dependant on user-attributes or other application state (user logged in, items in card, etc).
-You can disable this feature in the hook options:
+You can disable this feature in the hook options (or in the [OpenFeatureProvider](#openfeatureprovider-context-provider)):
 
 ```tsx
 function Page() {
@@ -200,11 +209,11 @@ function Page() {
 
 For more information about how evaluation context works in the React SDK, see the documentation on OpenFeature's [static context SDK paradigm](https://openfeature.dev/specification/glossary/#static-context-paradigm).
 
-### Re-rendering with Flag Configuration Changes
+#### Re-rendering with Flag Configuration Changes
 
 By default, if the underlying provider emits a `ConfigurationChanged` event, components will be re-rendered.
 This is useful if you want your UI to immediately reflect changes in the backend flag configuration.
-You can disable this feature in the hook options:
+You can disable this feature in the hook options (or in the [OpenFeatureProvider](#openfeatureprovider-context-provider)):
 
 ```tsx
 function Page() {
@@ -217,11 +226,11 @@ function Page() {
 
 Note that if your provider doesn't support updates, this configuration has no impact.
 
-### Suspense Support
+#### Suspense Support
 
 Frequently, providers need to perform some initial startup tasks.
-It may be desireable not to display components with feature flags until this is complete.
-Built-in [suspense](https://react.dev/reference/react/Suspense) support makes this easy: 
+It may be desireable not to display components with feature flags until this is complete, or when the context changes.
+Built-in [suspense](https://react.dev/reference/react/Suspense) support makes this easy.
 
 ```tsx
 function Content() {
@@ -252,6 +261,37 @@ function Fallback() {
   // component to render before READY.
   return <p>Waiting for provider to be ready...</p>;
 }
+
+```
+
+This can be disabled in the hook options (or in the [OpenFeatureProvider](#openfeatureprovider-context-provider)).
+
+## FAQ and troubleshooting
+
+> I get an error that says something like: `A React component suspended while rendering, but no fallback UI was specified.`
+
+The OpenFeature React SDK features built-in [suspense support](#suspense-support).
+This means that it will render your loading fallback automatically while the your provider starts up, and during context reconciliation for any of your components using feature flags!
+However, you will see this error if you neglect to create a suspense boundary around any components using feature flags; add a suspense boundary to resolve this issue.
+Alternatively, you can disable this feature by setting `suspendWhileReconciling=false` and `suspendUntilReady=false` in the [evaluation hooks](#evaluation-hooks) or the [OpenFeatureProvider](#openfeatureprovider-context-provider) (which applies to all evaluation hooks in child components).
+
+> I get odd rendering issues, or errors when components mount, if I use the suspense features.
+
+In React 16/17's "Legacy Suspense", when a component suspends, its sibling components initially mount and then are hidden.
+This can cause surprising effects and inconsistencies if sibling components are rendered while the provider is still getting ready.
+To fix this, you can upgrade to React 18, which uses "Concurrent Suspense", in which siblings are not mounted until their suspended sibling resolves.
+Alternatively, if you cannot upgrade to React 18, you can use the `useWhenProviderReady` utility hook in any sibling components to prevent them from mounting until the provider is ready.
+
+> I am using multiple `OpenFeatureProvider` contexts, but they are sharing the same provider or evaluation context. Why?
+
+The `OpenFeatureProvider` binds a `client` to all child components, but the provider and context associated with that client is controlled by the `domain` parameter.
+This is consistent with all OpenFeature SDKs.
+To scope an OpenFeatureProvider to a particular provider/context set the `domain` parameter on your `OpenFeatureProvider`:
+
+```tsx
+<OpenFeatureProvider domain={'my-domain'}>
+  <Page></Page>
+</OpenFeatureProvider>
 ```
 
 ## Resources

package/dist/cjs/index.js

@@ -41,41 +41,99 @@ __export(src_exports, {
   useObjectFlagValue: () => useObjectFlagValue,
   useOpenFeatureClient: () => useOpenFeatureClient,
   useStringFlagDetails: () => useStringFlagDetails,
-  useStringFlagValue: () => useStringFlagValue
+  useStringFlagValue: () => useStringFlagValue,
+  useWhenProviderReady: () => useWhenProviderReady
 });
 module.exports = __toCommonJS(src_exports);
 
 // src/evaluation/use-feature-flag.ts
 var import_web_sdk2 = require("@openfeature/web-sdk");
-var import_react = require("react");
+var import_react3 = require("react");
 
-// src/provider/provider.tsx
-var React = __toESM(require("react"));
-var import_web_sdk = require("@openfeature/web-sdk");
-var Context = React.createContext(void 0);
-var OpenFeatureProvider = ({ client, domain, children }) => {
-  if (!client) {
-    client = import_web_sdk.OpenFeature.getClient(domain);
-  }
-  return /* @__PURE__ */ React.createElement(Context.Provider, { value: client }, children);
+// src/common/options.ts
+var DEFAULT_OPTIONS = {
+  updateOnContextChanged: true,
+  updateOnConfigurationChanged: true,
+  suspendUntilReady: true,
+  suspendWhileReconciling: true
+};
+var normalizeOptions = (options) => {
+  const defaultOptionsIfMissing = !options ? {} : options;
+  const suspendUntilReady = "suspendUntilReady" in defaultOptionsIfMissing ? defaultOptionsIfMissing.suspendUntilReady : defaultOptionsIfMissing.suspend;
+  const suspendWhileReconciling = "suspendWhileReconciling" in defaultOptionsIfMissing ? defaultOptionsIfMissing.suspendWhileReconciling : defaultOptionsIfMissing.suspend;
+  return {
+    updateOnContextChanged: defaultOptionsIfMissing.updateOnContextChanged,
+    updateOnConfigurationChanged: defaultOptionsIfMissing.updateOnConfigurationChanged,
+    // only return these if properly set (no undefined to allow overriding with spread)
+    ...typeof suspendUntilReady === "boolean" && { suspendUntilReady },
+    ...typeof suspendWhileReconciling === "boolean" && { suspendWhileReconciling }
+  };
 };
-var useOpenFeatureClient = () => {
-  const client = React.useContext(Context);
+
+// src/common/suspend.ts
+var import_web_sdk = require("@openfeature/web-sdk");
+function suspend(client, updateState, ...resumeEvents) {
+  let suspendResolver;
+  const suspendPromise = new Promise((resolve) => {
+    suspendResolver = () => {
+      resolve();
+      resumeEvents.forEach((e) => {
+        client.removeHandler(e, suspendResolver);
+      });
+      client.removeHandler(import_web_sdk.ProviderEvents.Error, suspendResolver);
+    };
+    resumeEvents.forEach((e) => {
+      client.addHandler(e, suspendResolver);
+    });
+    client.addHandler(import_web_sdk.ProviderEvents.Error, suspendResolver);
+  });
+  updateState(suspenseWrapper(suspendPromise));
+}
+function suspenseWrapper(promise) {
+  let status = 0 /* Pending */;
+  let result;
+  const suspended = promise.then((value) => {
+    status = 1 /* Success */;
+    result = value;
+  }).catch((error) => {
+    status = 2 /* Error */;
+    result = error;
+  });
+  return () => {
+    switch (status) {
+      case 0 /* Pending */:
+        throw suspended;
+      case 1 /* Success */:
+        return result;
+      case 2 /* Error */:
+        throw result;
+      default:
+        throw new Error("Suspending promise is in an unknown state.");
+    }
+  };
+}
+
+// src/provider/context.ts
+var import_react = __toESM(require("react"));
+var Context = import_react.default.createContext(void 0);
+function useProviderOptions() {
+  const { options } = import_react.default.useContext(Context) || {};
+  return normalizeOptions(options);
+}
+
+// src/provider/use-open-feature-client.ts
+var import_react2 = __toESM(require("react"));
+function useOpenFeatureClient() {
+  const { client } = import_react2.default.useContext(Context) || {};
   if (!client) {
     throw new Error(
       "No OpenFeature client available - components using OpenFeature must be wrapped with an <OpenFeatureProvider>"
     );
   }
   return client;
-};
+}
 
 // src/evaluation/use-feature-flag.ts
-var DEFAULT_OPTIONS = {
-  updateOnContextChanged: true,
-  updateOnConfigurationChanged: true,
-  suspendUntilReady: true,
-  suspendWhileReconciling: false
-};
 function useFlag(flagKey, defaultValue, options) {
   const query = typeof defaultValue === "boolean" ? new HookFlagQuery(useBooleanFlagDetails(flagKey, defaultValue, options)) : typeof defaultValue === "number" ? new HookFlagQuery(useNumberFlagDetails(flagKey, defaultValue, options)) : typeof defaultValue === "string" ? new HookFlagQuery(useStringFlagDetails(flagKey, defaultValue, options)) : new HookFlagQuery(useObjectFlagDetails(flagKey, defaultValue, options));
   return query;
@@ -133,8 +191,8 @@ function useObjectFlagDetails(flagKey, defaultValue, options) {
   );
 }
 function attachHandlersAndResolve(flagKey, defaultValue, resolver, options) {
-  const defaultedOptions = { ...DEFAULT_OPTIONS, ...options };
-  const [, updateState] = (0, import_react.useState)();
+  const defaultedOptions = { ...DEFAULT_OPTIONS, ...useProviderOptions(), ...normalizeOptions(options) };
+  const [, updateState] = (0, import_react3.useState)();
   const client = useOpenFeatureClient();
   const forceUpdate = () => {
     updateState({});
@@ -148,7 +206,7 @@ function attachHandlersAndResolve(flagKey, defaultValue, resolver, options) {
       import_web_sdk2.ProviderEvents.Ready
     );
   };
-  (0, import_react.useEffect)(() => {
+  (0, import_react3.useEffect)(() => {
     if (client.providerStatus === import_web_sdk2.ProviderStatus.NOT_READY) {
       client.addHandler(import_web_sdk2.ProviderEvents.Ready, forceUpdate);
       if (defaultedOptions.suspendUntilReady) {
@@ -167,7 +225,7 @@ function attachHandlersAndResolve(flagKey, defaultValue, resolver, options) {
       client.removeHandler(import_web_sdk2.ProviderEvents.Reconciling, suspendRef);
     };
   }, []);
-  (0, import_react.useEffect)(() => {
+  (0, import_react3.useEffect)(() => {
     if (defaultedOptions.updateOnConfigurationChanged) {
       client.addHandler(import_web_sdk2.ProviderEvents.ConfigurationChanged, forceUpdate);
     }
@@ -177,46 +235,6 @@ function attachHandlersAndResolve(flagKey, defaultValue, resolver, options) {
   }, []);
   return resolver(client).call(client, flagKey, defaultValue);
 }
-function suspend(client, updateState, ...resumeEvents) {
-  let suspendResolver;
-  const suspendPromise = new Promise((resolve) => {
-    suspendResolver = () => {
-      resolve();
-      resumeEvents.forEach((e) => {
-        client.removeHandler(e, suspendResolver);
-      });
-      client.removeHandler(import_web_sdk2.ProviderEvents.Error, suspendResolver);
-    };
-    resumeEvents.forEach((e) => {
-      client.addHandler(e, suspendResolver);
-    });
-    client.addHandler(import_web_sdk2.ProviderEvents.Error, suspendResolver);
-  });
-  updateState(suspenseWrapper(suspendPromise));
-}
-function suspenseWrapper(promise) {
-  let status = 0 /* Pending */;
-  let result;
-  const suspended = promise.then((value) => {
-    status = 1 /* Success */;
-    result = value;
-  }).catch((error) => {
-    status = 2 /* Error */;
-    result = error;
-  });
-  return () => {
-    switch (status) {
-      case 0 /* Pending */:
-        throw suspended;
-      case 1 /* Success */:
-        return result;
-      case 2 /* Error */:
-        throw result;
-      default:
-        throw new Error("Suspending promise is in an unknown state.");
-    }
-  };
-}
 var HookFlagQuery = class {
   constructor(_details) {
     this._details = _details;
@@ -253,6 +271,31 @@ var HookFlagQuery = class {
   }
 };
 
+// src/provider/provider.tsx
+var import_web_sdk3 = require("@openfeature/web-sdk");
+var React3 = __toESM(require("react"));
+function OpenFeatureProvider({ client, domain, children, ...options }) {
+  if (!client) {
+    client = import_web_sdk3.OpenFeature.getClient(domain);
+  }
+  return /* @__PURE__ */ React3.createElement(Context.Provider, { value: { client, options } }, children);
+}
+
+// src/provider/use-when-provider-ready.ts
+var import_web_sdk4 = require("@openfeature/web-sdk");
+var import_react4 = require("react");
+function useWhenProviderReady(options) {
+  const [, updateState] = (0, import_react4.useState)();
+  const client = useOpenFeatureClient();
+  const defaultedOptions = { ...DEFAULT_OPTIONS, ...useProviderOptions(), ...normalizeOptions(options) };
+  (0, import_react4.useEffect)(() => {
+    if (defaultedOptions.suspendUntilReady && client.providerStatus === import_web_sdk4.ProviderStatus.NOT_READY) {
+      suspend(client, updateState, import_web_sdk4.ProviderEvents.Ready);
+    }
+  }, []);
+  return client.providerStatus === import_web_sdk4.ProviderStatus.READY;
+}
+
 // src/index.ts
 __reExport(src_exports, require("@openfeature/web-sdk"), module.exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/index.ts", "../../src/evaluation/use-feature-flag.ts", "../../src/provider/provider.tsx"],
-  "sourcesContent": ["export * from './evaluation';\nexport * from './query';\nexport * from './provider';\n// re-export the web-sdk so consumers can access that API from the react-sdk\nexport * from '@openfeature/web-sdk';\n", "import {\n  Client,\n  EvaluationDetails,\n  FlagEvaluationOptions,\n  FlagValue,\n  JsonValue,\n  ProviderEvents,\n  ProviderStatus,\n  StandardResolutionReasons,\n} from '@openfeature/web-sdk';\nimport { Dispatch, SetStateAction, useEffect, useState } from 'react';\nimport { useOpenFeatureClient } from '../provider';\nimport { FlagQuery } from '../query';\n\ntype ReactFlagEvaluationOptions = {\n  /**\n   * Suspend flag evaluations while the provider is not ready.\n   * Set to false if you don't want to show suspense fallbacks until the provider is initialized.\n   * Defaults to true.\n   */\n  suspendUntilReady?: boolean;\n  /**\n   * Suspend flag evaluations while the provider's context is being reconciled.\n   * Set to true if you want to show suspense fallbacks while flags are re-evaluated after context changes.\n   * Defaults to false.\n   */\n  suspendWhileReconciling?: boolean;\n  /**\n   * Update the component if the provider emits a ConfigurationChanged event.\n   * Set to false to prevent components from re-rendering when flag value changes\n   * are received by the associated provider.\n   * Defaults to true.\n   */\n  updateOnConfigurationChanged?: boolean;\n  /**\n   * Update the component when the OpenFeature context changes.\n   * Set to false to prevent components from re-rendering when attributes which\n   * may be factors in flag evaluation change.\n   * Defaults to true.\n   */\n  updateOnContextChanged?: boolean;\n} & FlagEvaluationOptions;\n\nconst DEFAULT_OPTIONS: ReactFlagEvaluationOptions = {\n  updateOnContextChanged: true,\n  updateOnConfigurationChanged: true,\n  suspendUntilReady: true,\n  suspendWhileReconciling: false,\n};\n\nenum SuspendState {\n  Pending,\n  Success,\n  Error,\n}\n\n// This type is a bit wild-looking, but I think we need it.\n// We have to use the conditional, because otherwise useFlag('key', false) would return false, not boolean (too constrained).\n// We have a duplicate for the hook return below, this one is just used for casting because the name isn't as clear\ntype ConstrainedFlagQuery<T> = FlagQuery<\n  T extends boolean\n    ? boolean\n    : T extends number\n      ? number\n      : T extends string\n        ? string\n        : T extends JsonValue\n          ? T\n          : JsonValue\n>;\n\n/**\n * Evaluates a feature flag generically, returning an react-flavored queryable object.\n * The resolver method to use is based on the type of the defaultValue.\n * For type-specific hooks, use {@link useBooleanFlagValue}, {@link useBooleanFlagDetails} and equivalents.\n * By default, components will re-render when the flag value changes.\n * @param {string} flagKey the flag identifier\n * @template {FlagValue} T A optional generic argument constraining the default.\n * @param {T} defaultValue the default value; used to determine what resolved type should be used.\n * @param {ReactFlagEvaluationOptions} options for this evaluation\n * @returns { FlagQuery } a queryable object containing useful information about the flag.\n */\nexport function useFlag<T extends FlagValue = FlagValue>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): FlagQuery<\nT extends boolean\n  ? boolean\n  : T extends number\n    ? number\n    : T extends string\n      ? string\n      : T extends JsonValue\n        ? T\n        : JsonValue\n> {\n  // use the default value to determine the resolver to call\n  const query =\n    typeof defaultValue === 'boolean'\n      ? new HookFlagQuery<boolean>(useBooleanFlagDetails(flagKey, defaultValue, options))\n      : typeof defaultValue === 'number'\n        ? new HookFlagQuery<number>(useNumberFlagDetails(flagKey, defaultValue, options))\n        : typeof defaultValue === 'string'\n          ? new HookFlagQuery<string>(useStringFlagDetails(flagKey, defaultValue, options))\n          : new HookFlagQuery<JsonValue>(useObjectFlagDetails(flagKey, defaultValue, options));\n  // TS sees this as HookFlagQuery<JsonValue>, because the compiler isn't aware of the `typeof` checks above.\n  return query as unknown as ConstrainedFlagQuery<T>;\n}\n\n/**\n * Evaluates a feature flag, returning a boolean.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @param {boolean} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { boolean} a EvaluationDetails object for this evaluation\n */\nexport function useBooleanFlagValue(\n  flagKey: string,\n  defaultValue: boolean,\n  options?: ReactFlagEvaluationOptions,\n): boolean {\n  return useBooleanFlagDetails(flagKey, defaultValue, options).value;\n}\n\n/**\n * Evaluates a feature flag, returning evaluation details.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @param {boolean} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { EvaluationDetails<boolean>} a EvaluationDetails object for this evaluation\n */\nexport function useBooleanFlagDetails(\n  flagKey: string,\n  defaultValue: boolean,\n  options?: ReactFlagEvaluationOptions,\n): EvaluationDetails<boolean> {\n  return attachHandlersAndResolve(\n    flagKey,\n    defaultValue,\n    (client) => {\n      return client.getBooleanDetails;\n    },\n    options,\n  );\n}\n\n/**\n * Evaluates a feature flag, returning a string.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @template {string} [T=string] A optional generic argument constraining the string\n * @param {T} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { boolean} a EvaluationDetails object for this evaluation\n */\nexport function useStringFlagValue<T extends string = string>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): string {\n  return useStringFlagDetails(flagKey, defaultValue, options).value;\n}\n\n/**\n * Evaluates a feature flag, returning evaluation details.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @template {string} [T=string] A optional generic argument constraining the string\n * @param {T} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { EvaluationDetails<string>} a EvaluationDetails object for this evaluation\n */\nexport function useStringFlagDetails<T extends string = string>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): EvaluationDetails<string> {\n  return attachHandlersAndResolve(\n    flagKey,\n    defaultValue,\n    (client) => {\n      return client.getStringDetails<T>;\n    },\n    options,\n  );\n}\n\n/**\n * Evaluates a feature flag, returning a number.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @template {number} [T=number] A optional generic argument constraining the number\n * @param {T} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { boolean} a EvaluationDetails object for this evaluation\n */\nexport function useNumberFlagValue<T extends number = number>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): number {\n  return useNumberFlagDetails(flagKey, defaultValue, options).value;\n}\n\n/**\n * Evaluates a feature flag, returning evaluation details.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @template {number} [T=number] A optional generic argument constraining the number\n * @param {T} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { EvaluationDetails<number>} a EvaluationDetails object for this evaluation\n */\nexport function useNumberFlagDetails<T extends number = number>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): EvaluationDetails<number> {\n  return attachHandlersAndResolve(\n    flagKey,\n    defaultValue,\n    (client) => {\n      return client.getNumberDetails<T>;\n    },\n    options,\n  );\n}\n\n/**\n * Evaluates a feature flag, returning an object.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @template {JsonValue} [T=JsonValue] A optional generic argument describing the structure\n * @param {T} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { boolean} a EvaluationDetails object for this evaluation\n */\nexport function useObjectFlagValue<T extends JsonValue = JsonValue>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): T {\n  return useObjectFlagDetails<T>(flagKey, defaultValue, options).value;\n}\n\n/**\n * Evaluates a feature flag, returning evaluation details.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @param {T} defaultValue the default value\n * @template {JsonValue} [T=JsonValue] A optional generic argument describing the structure\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { EvaluationDetails<T>} a EvaluationDetails object for this evaluation\n */\nexport function useObjectFlagDetails<T extends JsonValue = JsonValue>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): EvaluationDetails<T> {\n  return attachHandlersAndResolve(\n    flagKey,\n    defaultValue,\n    (client) => {\n      return client.getObjectDetails<T>;\n    },\n    options,\n  );\n}\n\nfunction attachHandlersAndResolve<T extends FlagValue>(\n  flagKey: string,\n  defaultValue: T,\n  resolver: (client: Client) => (flagKey: string, defaultValue: T) => EvaluationDetails<T>,\n  options?: ReactFlagEvaluationOptions,\n): EvaluationDetails<T> {\n  const defaultedOptions = { ...DEFAULT_OPTIONS, ...options };\n  const [, updateState] = useState<object | undefined>();\n  const client = useOpenFeatureClient();\n  const forceUpdate = () => {\n    updateState({});\n  };\n  const suspendRef = () => {\n    suspend(\n      client,\n      updateState,\n      ProviderEvents.ContextChanged,\n      ProviderEvents.ConfigurationChanged,\n      ProviderEvents.Ready,\n    );\n  };\n\n  useEffect(() => {\n    if (client.providerStatus === ProviderStatus.NOT_READY) {\n      // update when the provider is ready\n      client.addHandler(ProviderEvents.Ready, forceUpdate);\n      if (defaultedOptions.suspendUntilReady) {\n        suspend(client, updateState, ProviderEvents.Ready);\n      }\n    }\n\n    if (defaultedOptions.updateOnContextChanged) {\n      // update when the context changes\n      client.addHandler(ProviderEvents.ContextChanged, forceUpdate);\n      if (defaultedOptions.suspendWhileReconciling) {\n        client.addHandler(ProviderEvents.Reconciling, suspendRef);\n      }\n    }\n    return () => {\n      // cleanup the handlers\n      client.removeHandler(ProviderEvents.Ready, forceUpdate);\n      client.removeHandler(ProviderEvents.ContextChanged, forceUpdate);\n      client.removeHandler(ProviderEvents.Reconciling, suspendRef);\n    };\n  }, []);\n\n  useEffect(() => {\n    if (defaultedOptions.updateOnConfigurationChanged) {\n      // update when the provider configuration changes\n      client.addHandler(ProviderEvents.ConfigurationChanged, forceUpdate);\n    }\n    return () => {\n      // cleanup the handlers\n      client.removeHandler(ProviderEvents.ConfigurationChanged, forceUpdate);\n    };\n  }, []);\n\n  return resolver(client).call(client, flagKey, defaultValue);\n}\n\n/**\n * Suspend function. If this runs, components using the calling hook will be suspended.\n * @param {Client} client the OpenFeature client\n * @param {Function} updateState the state update function\n * @param {ProviderEvents[]} resumeEvents list of events which will resume the suspend\n */\nfunction suspend(\n  client: Client,\n  updateState: Dispatch<SetStateAction<object | undefined>>,\n  ...resumeEvents: ProviderEvents[]\n) {\n  let suspendResolver: () => void;\n\n  const suspendPromise = new Promise<void>((resolve) => {\n    suspendResolver = () => {\n      resolve();\n      resumeEvents.forEach((e) => {\n        client.removeHandler(e, suspendResolver); // remove handlers once they've run\n      });\n      client.removeHandler(ProviderEvents.Error, suspendResolver);\n    };\n    resumeEvents.forEach((e) => {\n      client.addHandler(e, suspendResolver);\n    });\n    client.addHandler(ProviderEvents.Error, suspendResolver); // we never want to throw, resolve with errors - we may make this configurable later\n  });\n  updateState(suspenseWrapper(suspendPromise));\n}\n\n/**\n * Promise wrapper that throws unresolved promises to support React suspense.\n * @param {Promise<T>} promise to wrap\n * @template T flag type\n * @returns {Function} suspense-compliant lambda\n */\nfunction suspenseWrapper<T>(promise: Promise<T>) {\n  let status: SuspendState = SuspendState.Pending;\n  let result: T;\n\n  const suspended = promise\n    .then((value) => {\n      status = SuspendState.Success;\n      result = value;\n    })\n    .catch((error) => {\n      status = SuspendState.Error;\n      result = error;\n    });\n\n  return () => {\n    switch (status) {\n      case SuspendState.Pending:\n        throw suspended;\n      case SuspendState.Success:\n        return result;\n      case SuspendState.Error:\n        throw result;\n      default:\n        throw new Error('Suspending promise is in an unknown state.');\n    }\n  };\n}\n\n// FlagQuery implementation, do not export\nclass HookFlagQuery<T extends FlagValue = FlagValue> implements FlagQuery {\n  constructor(private _details: EvaluationDetails<T>) {}\n\n  get details() {\n    return this._details;\n  }\n\n  get value() {\n    return this._details?.value;\n  }\n\n  get variant() {\n    return this._details.variant;\n  }\n\n  get flagMetadata() {\n    return this._details.flagMetadata;\n  }\n\n  get reason() {\n    return this._details.reason;\n  }\n\n  get isError() {\n    return !!this._details?.errorCode || this._details.reason == StandardResolutionReasons.ERROR;\n  }\n\n  get errorCode() {\n    return this._details?.errorCode;\n  }\n\n  get errorMessage() {\n    return this._details?.errorMessage;\n  }\n\n  get isAuthoritative() {\n    return (\n      !this.isError &&\n      this._details.reason != StandardResolutionReasons.STALE &&\n      this._details.reason != StandardResolutionReasons.DISABLED\n    );\n  }\n\n  get type() {\n    return typeof this._details.value;\n  }\n}\n", "import * as React from 'react';\nimport { Client, OpenFeature } from '@openfeature/web-sdk';\n\ntype ClientOrDomain =\n  | {\n      /**\n       * An identifier which logically binds clients with providers\n       * @see OpenFeature.setProvider() and overloads.\n       */\n      domain?: string;\n      client?: never;\n    }\n  | {\n      /**\n       * OpenFeature client to use.\n       */\n      client?: Client;\n      domain?: never;\n    };\n\ntype ProviderProps = {\n  children?: React.ReactNode;\n} & ClientOrDomain;\n\nconst Context = React.createContext<Client | undefined>(undefined);\n\nexport const OpenFeatureProvider = ({ client, domain, children }: ProviderProps) => {\n  if (!client) {\n    client = OpenFeature.getClient(domain);\n  }\n\n  return <Context.Provider value={client}>{children}</Context.Provider>;\n};\n\nexport const useOpenFeatureClient = () => {\n  const client = React.useContext(Context);\n\n  if (!client) {\n    throw new Error(\n      'No OpenFeature client available - components using OpenFeature must be wrapped with an <OpenFeatureProvider>'\n    );\n  }\n\n  return client;\n};\n"],
-  "mappings": "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",
-  "names": ["import_web_sdk"]
+  "sources": ["../../src/index.ts", "../../src/evaluation/use-feature-flag.ts", "../../src/common/options.ts", "../../src/common/suspend.ts", "../../src/provider/context.ts", "../../src/provider/use-open-feature-client.ts", "../../src/provider/provider.tsx", "../../src/provider/use-when-provider-ready.ts"],
+  "sourcesContent": ["export * from './evaluation';\nexport * from './query';\nexport * from './provider';\n// re-export the web-sdk so consumers can access that API from the react-sdk\nexport * from '@openfeature/web-sdk';\n", "import {\n  Client,\n  EvaluationDetails,\n  FlagValue,\n  JsonValue,\n  ProviderEvents,\n  ProviderStatus,\n  StandardResolutionReasons\n} from '@openfeature/web-sdk';\nimport { useEffect, useState } from 'react';\nimport { DEFAULT_OPTIONS, ReactFlagEvaluationOptions, normalizeOptions } from '../common/options';\nimport { suspend } from '../common/suspend';\nimport { useProviderOptions } from '../provider/context';\nimport { useOpenFeatureClient } from '../provider/use-open-feature-client';\nimport { FlagQuery } from '../query';\n\n// This type is a bit wild-looking, but I think we need it.\n// We have to use the conditional, because otherwise useFlag('key', false) would return false, not boolean (too constrained).\n// We have a duplicate for the hook return below, this one is just used for casting because the name isn't as clear\ntype ConstrainedFlagQuery<T> = FlagQuery<\n  T extends boolean\n    ? boolean\n    : T extends number\n      ? number\n      : T extends string\n        ? string\n        : T extends JsonValue\n          ? T\n          : JsonValue\n>;\n\n/**\n * Evaluates a feature flag generically, returning an react-flavored queryable object.\n * The resolver method to use is based on the type of the defaultValue.\n * For type-specific hooks, use {@link useBooleanFlagValue}, {@link useBooleanFlagDetails} and equivalents.\n * By default, components will re-render when the flag value changes.\n * @param {string} flagKey the flag identifier\n * @template {FlagValue} T A optional generic argument constraining the default.\n * @param {T} defaultValue the default value; used to determine what resolved type should be used.\n * @param {ReactFlagEvaluationOptions} options for this evaluation\n * @returns { FlagQuery } a queryable object containing useful information about the flag.\n */\nexport function useFlag<T extends FlagValue = FlagValue>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): FlagQuery<\nT extends boolean\n  ? boolean\n  : T extends number\n    ? number\n    : T extends string\n      ? string\n      : T extends JsonValue\n        ? T\n        : JsonValue\n> {\n  // use the default value to determine the resolver to call\n  const query =\n    typeof defaultValue === 'boolean'\n      ? new HookFlagQuery<boolean>(useBooleanFlagDetails(flagKey, defaultValue, options))\n      : typeof defaultValue === 'number'\n        ? new HookFlagQuery<number>(useNumberFlagDetails(flagKey, defaultValue, options))\n        : typeof defaultValue === 'string'\n          ? new HookFlagQuery<string>(useStringFlagDetails(flagKey, defaultValue, options))\n          : new HookFlagQuery<JsonValue>(useObjectFlagDetails(flagKey, defaultValue, options));\n  // TS sees this as HookFlagQuery<JsonValue>, because the compiler isn't aware of the `typeof` checks above.\n  return query as unknown as ConstrainedFlagQuery<T>;\n}\n\n/**\n * Evaluates a feature flag, returning a boolean.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @param {boolean} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { boolean} a EvaluationDetails object for this evaluation\n */\nexport function useBooleanFlagValue(\n  flagKey: string,\n  defaultValue: boolean,\n  options?: ReactFlagEvaluationOptions,\n): boolean {\n  return useBooleanFlagDetails(flagKey, defaultValue, options).value;\n}\n\n/**\n * Evaluates a feature flag, returning evaluation details.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @param {boolean} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { EvaluationDetails<boolean>} a EvaluationDetails object for this evaluation\n */\nexport function useBooleanFlagDetails(\n  flagKey: string,\n  defaultValue: boolean,\n  options?: ReactFlagEvaluationOptions,\n): EvaluationDetails<boolean> {\n  return attachHandlersAndResolve(\n    flagKey,\n    defaultValue,\n    (client) => {\n      return client.getBooleanDetails;\n    },\n    options,\n  );\n}\n\n/**\n * Evaluates a feature flag, returning a string.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @template {string} [T=string] A optional generic argument constraining the string\n * @param {T} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { boolean} a EvaluationDetails object for this evaluation\n */\nexport function useStringFlagValue<T extends string = string>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): string {\n  return useStringFlagDetails(flagKey, defaultValue, options).value;\n}\n\n/**\n * Evaluates a feature flag, returning evaluation details.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @template {string} [T=string] A optional generic argument constraining the string\n * @param {T} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { EvaluationDetails<string>} a EvaluationDetails object for this evaluation\n */\nexport function useStringFlagDetails<T extends string = string>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): EvaluationDetails<string> {\n  return attachHandlersAndResolve(\n    flagKey,\n    defaultValue,\n    (client) => {\n      return client.getStringDetails<T>;\n    },\n    options,\n  );\n}\n\n/**\n * Evaluates a feature flag, returning a number.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @template {number} [T=number] A optional generic argument constraining the number\n * @param {T} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { boolean} a EvaluationDetails object for this evaluation\n */\nexport function useNumberFlagValue<T extends number = number>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): number {\n  return useNumberFlagDetails(flagKey, defaultValue, options).value;\n}\n\n/**\n * Evaluates a feature flag, returning evaluation details.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @template {number} [T=number] A optional generic argument constraining the number\n * @param {T} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { EvaluationDetails<number>} a EvaluationDetails object for this evaluation\n */\nexport function useNumberFlagDetails<T extends number = number>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): EvaluationDetails<number> {\n  return attachHandlersAndResolve(\n    flagKey,\n    defaultValue,\n    (client) => {\n      return client.getNumberDetails<T>;\n    },\n    options,\n  );\n}\n\n/**\n * Evaluates a feature flag, returning an object.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @template {JsonValue} [T=JsonValue] A optional generic argument describing the structure\n * @param {T} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { boolean} a EvaluationDetails object for this evaluation\n */\nexport function useObjectFlagValue<T extends JsonValue = JsonValue>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): T {\n  return useObjectFlagDetails<T>(flagKey, defaultValue, options).value;\n}\n\n/**\n * Evaluates a feature flag, returning evaluation details.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @param {T} defaultValue the default value\n * @template {JsonValue} [T=JsonValue] A optional generic argument describing the structure\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { EvaluationDetails<T>} a EvaluationDetails object for this evaluation\n */\nexport function useObjectFlagDetails<T extends JsonValue = JsonValue>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): EvaluationDetails<T> {\n  return attachHandlersAndResolve(\n    flagKey,\n    defaultValue,\n    (client) => {\n      return client.getObjectDetails<T>;\n    },\n    options,\n  );\n}\n\nfunction attachHandlersAndResolve<T extends FlagValue>(\n  flagKey: string,\n  defaultValue: T,\n  resolver: (client: Client) => (flagKey: string, defaultValue: T) => EvaluationDetails<T>,\n  options?: ReactFlagEvaluationOptions,\n): EvaluationDetails<T> {\n  // highest priority > evaluation hook options > provider options > default options > lowest priority\n  const defaultedOptions = { ...DEFAULT_OPTIONS, ...useProviderOptions(), ...normalizeOptions(options)};\n  const [, updateState] = useState<object | undefined>();\n  const client = useOpenFeatureClient();\n  const forceUpdate = () => {\n    updateState({});\n  };\n  const suspendRef = () => {\n    suspend(\n      client,\n      updateState,\n      ProviderEvents.ContextChanged,\n      ProviderEvents.ConfigurationChanged,\n      ProviderEvents.Ready,\n    );\n  };\n\n  useEffect(() => {\n    if (client.providerStatus === ProviderStatus.NOT_READY) {\n      // update when the provider is ready\n      client.addHandler(ProviderEvents.Ready, forceUpdate);\n      if (defaultedOptions.suspendUntilReady) {\n        suspend(client, updateState, ProviderEvents.Ready);\n      }\n    }\n\n    if (defaultedOptions.updateOnContextChanged) {\n      // update when the context changes\n      client.addHandler(ProviderEvents.ContextChanged, forceUpdate);\n      if (defaultedOptions.suspendWhileReconciling) {\n        client.addHandler(ProviderEvents.Reconciling, suspendRef);\n      }\n    }\n    return () => {\n      // cleanup the handlers\n      client.removeHandler(ProviderEvents.Ready, forceUpdate);\n      client.removeHandler(ProviderEvents.ContextChanged, forceUpdate);\n      client.removeHandler(ProviderEvents.Reconciling, suspendRef);\n    };\n  }, []);\n\n  useEffect(() => {\n    if (defaultedOptions.updateOnConfigurationChanged) {\n      // update when the provider configuration changes\n      client.addHandler(ProviderEvents.ConfigurationChanged, forceUpdate);\n    }\n    return () => {\n      // cleanup the handlers\n      client.removeHandler(ProviderEvents.ConfigurationChanged, forceUpdate);\n    };\n  }, []);\n\n  return resolver(client).call(client, flagKey, defaultValue);\n}\n\n// FlagQuery implementation, do not export\nclass HookFlagQuery<T extends FlagValue = FlagValue> implements FlagQuery {\n  constructor(private _details: EvaluationDetails<T>) {}\n\n  get details() {\n    return this._details;\n  }\n\n  get value() {\n    return this._details?.value;\n  }\n\n  get variant() {\n    return this._details.variant;\n  }\n\n  get flagMetadata() {\n    return this._details.flagMetadata;\n  }\n\n  get reason() {\n    return this._details.reason;\n  }\n\n  get isError() {\n    return !!this._details?.errorCode || this._details.reason == StandardResolutionReasons.ERROR;\n  }\n\n  get errorCode() {\n    return this._details?.errorCode;\n  }\n\n  get errorMessage() {\n    return this._details?.errorMessage;\n  }\n\n  get isAuthoritative() {\n    return (\n      !this.isError &&\n      this._details.reason != StandardResolutionReasons.STALE &&\n      this._details.reason != StandardResolutionReasons.DISABLED\n    );\n  }\n\n  get type() {\n    return typeof this._details.value;\n  }\n}\n", "import { FlagEvaluationOptions } from '@openfeature/web-sdk';\n\nexport type ReactFlagEvaluationOptions = ({\n  /**\n   * Enable or disable all suspense functionality.\n   * Cannot be used in conjunction with `suspendUntilReady` and `suspendWhileReconciling` options.\n   */\n  suspend?: boolean;\n  suspendUntilReady?: never;\n  suspendWhileReconciling?: never;\n} | {\n  /**\n   * Suspend flag evaluations while the provider is not ready.\n   * Set to false if you don't want to show suspense fallbacks until the provider is initialized.\n   * Defaults to true.\n   * Cannot be used in conjunction with `suspend` option.\n   */\n  suspendUntilReady?: boolean;\n  /**\n   * Suspend flag evaluations while the provider's context is being reconciled.\n   * Set to true if you want to show suspense fallbacks while flags are re-evaluated after context changes.\n   * Defaults to true.\n   * Cannot be used in conjunction with `suspend` option.\n   */\n  suspendWhileReconciling?: boolean;\n  suspend?: never;\n}) & {\n  /**\n   * Update the component if the provider emits a ConfigurationChanged event.\n   * Set to false to prevent components from re-rendering when flag value changes\n   * are received by the associated provider.\n   * Defaults to true.\n   */\n  updateOnConfigurationChanged?: boolean;\n  /**\n   * Update the component when the OpenFeature context changes.\n   * Set to false to prevent components from re-rendering when attributes which\n   * may be factors in flag evaluation change.\n   * Defaults to true.\n   */\n  updateOnContextChanged?: boolean;\n} & FlagEvaluationOptions;\n\nexport type NormalizedOptions = Omit<ReactFlagEvaluationOptions, 'suspend'>;\n\n/**\n * Default options.\n * DO NOT EXPORT PUBLICLY\n * @internal\n */\nexport const DEFAULT_OPTIONS: ReactFlagEvaluationOptions = {\n  updateOnContextChanged: true,\n  updateOnConfigurationChanged: true,\n  suspendUntilReady: true,\n  suspendWhileReconciling: true,\n};\n\n/**\n * Returns normalization options (all `undefined` fields removed, and `suspend` decomposed to `suspendUntilReady` and `suspendWhileReconciling`).\n * DO NOT EXPORT PUBLICLY\n * @internal\n * @param {ReactFlagEvaluationOptions} options  options to normalize\n * @returns {NormalizedOptions} normalized options\n */\nexport const normalizeOptions: (options?: ReactFlagEvaluationOptions) => NormalizedOptions = (options?: ReactFlagEvaluationOptions) => {\n  const defaultOptionsIfMissing = !options ? {} : options;\n  // fall-back the suspense options\n  const suspendUntilReady = 'suspendUntilReady' in defaultOptionsIfMissing ? defaultOptionsIfMissing.suspendUntilReady : defaultOptionsIfMissing.suspend;\n  const suspendWhileReconciling = 'suspendWhileReconciling' in defaultOptionsIfMissing ? defaultOptionsIfMissing.suspendWhileReconciling : defaultOptionsIfMissing.suspend;\n  return {\n    updateOnContextChanged: defaultOptionsIfMissing.updateOnContextChanged,\n    updateOnConfigurationChanged: defaultOptionsIfMissing.updateOnConfigurationChanged,\n    // only return these if properly set (no undefined to allow overriding with spread)\n    ...(typeof suspendUntilReady === 'boolean' && {suspendUntilReady}),\n    ...(typeof suspendWhileReconciling === 'boolean' && {suspendWhileReconciling}),\n  };\n};\n", "import { Client, ProviderEvents } from '@openfeature/web-sdk';\nimport { Dispatch, SetStateAction } from 'react';\n\nenum SuspendState {\n  Pending,\n  Success,\n  Error,\n}\n\n/**\n * Suspend function. If this runs, components using the calling hook will be suspended.\n * DO NOT EXPORT PUBLICLY \n * @internal\n * @param {Client} client the OpenFeature client\n * @param {Function} updateState the state update function\n * @param {ProviderEvents[]} resumeEvents list of events which will resume the suspend\n */\nexport function suspend(\n  client: Client,\n  updateState: Dispatch<SetStateAction<object | undefined>>,\n  ...resumeEvents: ProviderEvents[]\n) {\n  let suspendResolver: () => void;\n\n  const suspendPromise = new Promise<void>((resolve) => {\n    suspendResolver = () => {\n      resolve();\n      resumeEvents.forEach((e) => {\n        client.removeHandler(e, suspendResolver); // remove handlers once they've run\n      });\n      client.removeHandler(ProviderEvents.Error, suspendResolver);\n    };\n    resumeEvents.forEach((e) => {\n      client.addHandler(e, suspendResolver);\n    });\n    client.addHandler(ProviderEvents.Error, suspendResolver); // we never want to throw, resolve with errors - we may make this configurable later\n  });\n  updateState(suspenseWrapper(suspendPromise));\n}\n\n/**\n * Promise wrapper that throws unresolved promises to support React suspense.\n * DO NOT EXPORT PUBLICLY\n * @internal\n * @param {Promise<T>} promise to wrap\n * @template T flag type\n * @returns {Function} suspense-compliant lambda\n */\nexport function suspenseWrapper<T>(promise: Promise<T>) {\n  let status: SuspendState = SuspendState.Pending;\n  let result: T;\n\n  const suspended = promise\n    .then((value) => {\n      status = SuspendState.Success;\n      result = value;\n    })\n    .catch((error) => {\n      status = SuspendState.Error;\n      result = error;\n    });\n\n  return () => {\n    switch (status) {\n      case SuspendState.Pending:\n        throw suspended;\n      case SuspendState.Success:\n        return result;\n      case SuspendState.Error:\n        throw result;\n      default:\n        throw new Error('Suspending promise is in an unknown state.');\n    }\n  };\n}\n", "import { Client } from '@openfeature/web-sdk';\nimport React from 'react';\nimport { NormalizedOptions, ReactFlagEvaluationOptions, normalizeOptions } from '../common/options';\n\n/**\n * The underlying React context.\n * DO NOT EXPORT PUBLICLY\n * @internal\n */\nexport const Context = React.createContext<{ client: Client; options: ReactFlagEvaluationOptions } | undefined>(undefined);\n\n/**\n * Get a normalized copy of the options used for this OpenFeatureProvider, see {@link normalizeOptions}.\n * DO NOT EXPORT PUBLICLY\n * @internal\n * @returns {NormalizedOptions} normalized options the defaulted options, not defaulted or normalized.\n */\nexport function useProviderOptions(): NormalizedOptions {\n  const { options } = React.useContext(Context) || {};\n  return normalizeOptions(options);\n}\n", "import React from 'react';\nimport { Context } from './context';\nimport { Client } from '@openfeature/web-sdk';\n\n/**\n * Get the {@link Client} instance for this OpenFeatureProvider context.\n * Note that the provider to which this is bound is determined by the OpenFeatureProvider's domain.\n * @returns {Client} client for this scope\n */\nexport function useOpenFeatureClient(): Client {\n  const { client } = React.useContext(Context) || {};\n\n  if (!client) {\n    throw new Error(\n      'No OpenFeature client available - components using OpenFeature must be wrapped with an <OpenFeatureProvider>',\n    );\n  }\n\n  return client;\n}\n", "import { Client, OpenFeature } from '@openfeature/web-sdk';\nimport * as React from 'react';\nimport { ReactFlagEvaluationOptions } from '../common/options';\nimport { Context } from './context';\n\ntype ClientOrDomain =\n  | {\n      /**\n       * An identifier which logically binds clients with providers\n       * @see OpenFeature.setProvider() and overloads.\n       */\n      domain?: string;\n      client?: never;\n    }\n  | {\n      /**\n       * OpenFeature client to use.\n       */\n      client?: Client;\n      domain?: never;\n    };\n\ntype ProviderProps = {\n  children?: React.ReactNode;\n} & ClientOrDomain &\n  ReactFlagEvaluationOptions;\n\n  /**\n   * Provides a scope for evaluating feature flags by binding a client to all child components.\n   * @param {ProviderProps} properties props for the context provider\n   * @returns {OpenFeatureProvider} context provider\n   */\nexport function OpenFeatureProvider({ client, domain, children, ...options }: ProviderProps) {\n  if (!client) {\n    client = OpenFeature.getClient(domain);\n  }\n\n  return <Context.Provider value={{ client, options }}>{children}</Context.Provider>;\n}\n", "import { ProviderEvents, ProviderStatus } from '@openfeature/web-sdk';\nimport { useEffect, useState } from 'react';\nimport { DEFAULT_OPTIONS, ReactFlagEvaluationOptions, normalizeOptions } from '../common/options';\nimport { suspend } from '../common/suspend';\nimport { useProviderOptions } from './context';\nimport { useOpenFeatureClient } from './use-open-feature-client';\n\ntype Options = Pick<ReactFlagEvaluationOptions, 'suspendUntilReady'>;\n\n/**\n * Utility hook that triggers suspense until the provider is {@link ProviderStatus.READY}, without evaluating any flags.\n * Especially useful for React v16/17 \"Legacy Suspense\", in which siblings to suspending components are\n * initially mounted and then hidden (see: https://github.com/reactwg/react-18/discussions/7).\n * @param {Options} options options for suspense\n * @returns {boolean} boolean indicating if provider is {@link ProviderStatus.READY}, useful if suspense is disabled and you want to handle loaders on your own\n */\nexport function useWhenProviderReady(options?: Options): boolean {\n  const [, updateState] = useState<object | undefined>();\n  const client = useOpenFeatureClient();\n  // highest priority > evaluation hook options > provider options > default options > lowest priority\n  const defaultedOptions = { ...DEFAULT_OPTIONS, ...useProviderOptions(), ...normalizeOptions(options)};\n\n  useEffect(() => {\n    if (defaultedOptions.suspendUntilReady && client.providerStatus === ProviderStatus.NOT_READY) {\n      suspend(client, updateState, ProviderEvents.Ready);\n    }\n  }, []);\n\n  return client.providerStatus === ProviderStatus.READY;\n}\n"],
+  "mappings": "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",
+  "names": ["import_web_sdk", "import_react", "React", "import_react", "React", "import_web_sdk", "React", "import_web_sdk", "import_react"]
 }

package/dist/esm/index.js

@@ -1,38 +1,95 @@
 // src/evaluation/use-feature-flag.ts
 import {
-  ProviderEvents,
+  ProviderEvents as ProviderEvents2,
   ProviderStatus,
   StandardResolutionReasons
 } from "@openfeature/web-sdk";
 import { useEffect, useState } from "react";
 
-// src/provider/provider.tsx
-import * as React from "react";
-import { OpenFeature } from "@openfeature/web-sdk";
-var Context = React.createContext(void 0);
-var OpenFeatureProvider = ({ client, domain, children }) => {
-  if (!client) {
-    client = OpenFeature.getClient(domain);
-  }
-  return /* @__PURE__ */ React.createElement(Context.Provider, { value: client }, children);
+// src/common/options.ts
+var DEFAULT_OPTIONS = {
+  updateOnContextChanged: true,
+  updateOnConfigurationChanged: true,
+  suspendUntilReady: true,
+  suspendWhileReconciling: true
+};
+var normalizeOptions = (options) => {
+  const defaultOptionsIfMissing = !options ? {} : options;
+  const suspendUntilReady = "suspendUntilReady" in defaultOptionsIfMissing ? defaultOptionsIfMissing.suspendUntilReady : defaultOptionsIfMissing.suspend;
+  const suspendWhileReconciling = "suspendWhileReconciling" in defaultOptionsIfMissing ? defaultOptionsIfMissing.suspendWhileReconciling : defaultOptionsIfMissing.suspend;
+  return {
+    updateOnContextChanged: defaultOptionsIfMissing.updateOnContextChanged,
+    updateOnConfigurationChanged: defaultOptionsIfMissing.updateOnConfigurationChanged,
+    // only return these if properly set (no undefined to allow overriding with spread)
+    ...typeof suspendUntilReady === "boolean" && { suspendUntilReady },
+    ...typeof suspendWhileReconciling === "boolean" && { suspendWhileReconciling }
+  };
 };
-var useOpenFeatureClient = () => {
-  const client = React.useContext(Context);
+
+// src/common/suspend.ts
+import { ProviderEvents } from "@openfeature/web-sdk";
+function suspend(client, updateState, ...resumeEvents) {
+  let suspendResolver;
+  const suspendPromise = new Promise((resolve) => {
+    suspendResolver = () => {
+      resolve();
+      resumeEvents.forEach((e) => {
+        client.removeHandler(e, suspendResolver);
+      });
+      client.removeHandler(ProviderEvents.Error, suspendResolver);
+    };
+    resumeEvents.forEach((e) => {
+      client.addHandler(e, suspendResolver);
+    });
+    client.addHandler(ProviderEvents.Error, suspendResolver);
+  });
+  updateState(suspenseWrapper(suspendPromise));
+}
+function suspenseWrapper(promise) {
+  let status = 0 /* Pending */;
+  let result;
+  const suspended = promise.then((value) => {
+    status = 1 /* Success */;
+    result = value;
+  }).catch((error) => {
+    status = 2 /* Error */;
+    result = error;
+  });
+  return () => {
+    switch (status) {
+      case 0 /* Pending */:
+        throw suspended;
+      case 1 /* Success */:
+        return result;
+      case 2 /* Error */:
+        throw result;
+      default:
+        throw new Error("Suspending promise is in an unknown state.");
+    }
+  };
+}
+
+// src/provider/context.ts
+import React from "react";
+var Context = React.createContext(void 0);
+function useProviderOptions() {
+  const { options } = React.useContext(Context) || {};
+  return normalizeOptions(options);
+}
+
+// src/provider/use-open-feature-client.ts
+import React2 from "react";
+function useOpenFeatureClient() {
+  const { client } = React2.useContext(Context) || {};
   if (!client) {
     throw new Error(
       "No OpenFeature client available - components using OpenFeature must be wrapped with an <OpenFeatureProvider>"
     );
   }
   return client;
-};
+}
 
 // src/evaluation/use-feature-flag.ts
-var DEFAULT_OPTIONS = {
-  updateOnContextChanged: true,
-  updateOnConfigurationChanged: true,
-  suspendUntilReady: true,
-  suspendWhileReconciling: false
-};
 function useFlag(flagKey, defaultValue, options) {
   const query = typeof defaultValue === "boolean" ? new HookFlagQuery(useBooleanFlagDetails(flagKey, defaultValue, options)) : typeof defaultValue === "number" ? new HookFlagQuery(useNumberFlagDetails(flagKey, defaultValue, options)) : typeof defaultValue === "string" ? new HookFlagQuery(useStringFlagDetails(flagKey, defaultValue, options)) : new HookFlagQuery(useObjectFlagDetails(flagKey, defaultValue, options));
   return query;
@@ -90,7 +147,7 @@ function useObjectFlagDetails(flagKey, defaultValue, options) {
   );
 }
 function attachHandlersAndResolve(flagKey, defaultValue, resolver, options) {
-  const defaultedOptions = { ...DEFAULT_OPTIONS, ...options };
+  const defaultedOptions = { ...DEFAULT_OPTIONS, ...useProviderOptions(), ...normalizeOptions(options) };
   const [, updateState] = useState();
   const client = useOpenFeatureClient();
   const forceUpdate = () => {
@@ -100,80 +157,40 @@ function attachHandlersAndResolve(flagKey, defaultValue, resolver, options) {
     suspend(
       client,
       updateState,
-      ProviderEvents.ContextChanged,
-      ProviderEvents.ConfigurationChanged,
-      ProviderEvents.Ready
+      ProviderEvents2.ContextChanged,
+      ProviderEvents2.ConfigurationChanged,
+      ProviderEvents2.Ready
     );
   };
   useEffect(() => {
     if (client.providerStatus === ProviderStatus.NOT_READY) {
-      client.addHandler(ProviderEvents.Ready, forceUpdate);
+      client.addHandler(ProviderEvents2.Ready, forceUpdate);
       if (defaultedOptions.suspendUntilReady) {
-        suspend(client, updateState, ProviderEvents.Ready);
+        suspend(client, updateState, ProviderEvents2.Ready);
       }
     }
     if (defaultedOptions.updateOnContextChanged) {
-      client.addHandler(ProviderEvents.ContextChanged, forceUpdate);
+      client.addHandler(ProviderEvents2.ContextChanged, forceUpdate);
       if (defaultedOptions.suspendWhileReconciling) {
-        client.addHandler(ProviderEvents.Reconciling, suspendRef);
+        client.addHandler(ProviderEvents2.Reconciling, suspendRef);
       }
     }
     return () => {
-      client.removeHandler(ProviderEvents.Ready, forceUpdate);
-      client.removeHandler(ProviderEvents.ContextChanged, forceUpdate);
-      client.removeHandler(ProviderEvents.Reconciling, suspendRef);
+      client.removeHandler(ProviderEvents2.Ready, forceUpdate);
+      client.removeHandler(ProviderEvents2.ContextChanged, forceUpdate);
+      client.removeHandler(ProviderEvents2.Reconciling, suspendRef);
     };
   }, []);
   useEffect(() => {
     if (defaultedOptions.updateOnConfigurationChanged) {
-      client.addHandler(ProviderEvents.ConfigurationChanged, forceUpdate);
+      client.addHandler(ProviderEvents2.ConfigurationChanged, forceUpdate);
     }
     return () => {
-      client.removeHandler(ProviderEvents.ConfigurationChanged, forceUpdate);
+      client.removeHandler(ProviderEvents2.ConfigurationChanged, forceUpdate);
     };
   }, []);
   return resolver(client).call(client, flagKey, defaultValue);
 }
-function suspend(client, updateState, ...resumeEvents) {
-  let suspendResolver;
-  const suspendPromise = new Promise((resolve) => {
-    suspendResolver = () => {
-      resolve();
-      resumeEvents.forEach((e) => {
-        client.removeHandler(e, suspendResolver);
-      });
-      client.removeHandler(ProviderEvents.Error, suspendResolver);
-    };
-    resumeEvents.forEach((e) => {
-      client.addHandler(e, suspendResolver);
-    });
-    client.addHandler(ProviderEvents.Error, suspendResolver);
-  });
-  updateState(suspenseWrapper(suspendPromise));
-}
-function suspenseWrapper(promise) {
-  let status = 0 /* Pending */;
-  let result;
-  const suspended = promise.then((value) => {
-    status = 1 /* Success */;
-    result = value;
-  }).catch((error) => {
-    status = 2 /* Error */;
-    result = error;
-  });
-  return () => {
-    switch (status) {
-      case 0 /* Pending */:
-        throw suspended;
-      case 1 /* Success */:
-        return result;
-      case 2 /* Error */:
-        throw result;
-      default:
-        throw new Error("Suspending promise is in an unknown state.");
-    }
-  };
-}
 var HookFlagQuery = class {
   constructor(_details) {
     this._details = _details;
@@ -210,6 +227,31 @@ var HookFlagQuery = class {
   }
 };
 
+// src/provider/provider.tsx
+import { OpenFeature } from "@openfeature/web-sdk";
+import * as React3 from "react";
+function OpenFeatureProvider({ client, domain, children, ...options }) {
+  if (!client) {
+    client = OpenFeature.getClient(domain);
+  }
+  return /* @__PURE__ */ React3.createElement(Context.Provider, { value: { client, options } }, children);
+}
+
+// src/provider/use-when-provider-ready.ts
+import { ProviderEvents as ProviderEvents3, ProviderStatus as ProviderStatus2 } from "@openfeature/web-sdk";
+import { useEffect as useEffect2, useState as useState2 } from "react";
+function useWhenProviderReady(options) {
+  const [, updateState] = useState2();
+  const client = useOpenFeatureClient();
+  const defaultedOptions = { ...DEFAULT_OPTIONS, ...useProviderOptions(), ...normalizeOptions(options) };
+  useEffect2(() => {
+    if (defaultedOptions.suspendUntilReady && client.providerStatus === ProviderStatus2.NOT_READY) {
+      suspend(client, updateState, ProviderEvents3.Ready);
+    }
+  }, []);
+  return client.providerStatus === ProviderStatus2.READY;
+}
+
 // src/index.ts
 export * from "@openfeature/web-sdk";
 export {
@@ -223,6 +265,7 @@ export {
   useObjectFlagValue,
   useOpenFeatureClient,
   useStringFlagDetails,
-  useStringFlagValue
+  useStringFlagValue,
+  useWhenProviderReady
 };
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/evaluation/use-feature-flag.ts", "../../src/provider/provider.tsx", "../../src/index.ts"],
-  "sourcesContent": ["import {\n  Client,\n  EvaluationDetails,\n  FlagEvaluationOptions,\n  FlagValue,\n  JsonValue,\n  ProviderEvents,\n  ProviderStatus,\n  StandardResolutionReasons,\n} from '@openfeature/web-sdk';\nimport { Dispatch, SetStateAction, useEffect, useState } from 'react';\nimport { useOpenFeatureClient } from '../provider';\nimport { FlagQuery } from '../query';\n\ntype ReactFlagEvaluationOptions = {\n  /**\n   * Suspend flag evaluations while the provider is not ready.\n   * Set to false if you don't want to show suspense fallbacks until the provider is initialized.\n   * Defaults to true.\n   */\n  suspendUntilReady?: boolean;\n  /**\n   * Suspend flag evaluations while the provider's context is being reconciled.\n   * Set to true if you want to show suspense fallbacks while flags are re-evaluated after context changes.\n   * Defaults to false.\n   */\n  suspendWhileReconciling?: boolean;\n  /**\n   * Update the component if the provider emits a ConfigurationChanged event.\n   * Set to false to prevent components from re-rendering when flag value changes\n   * are received by the associated provider.\n   * Defaults to true.\n   */\n  updateOnConfigurationChanged?: boolean;\n  /**\n   * Update the component when the OpenFeature context changes.\n   * Set to false to prevent components from re-rendering when attributes which\n   * may be factors in flag evaluation change.\n   * Defaults to true.\n   */\n  updateOnContextChanged?: boolean;\n} & FlagEvaluationOptions;\n\nconst DEFAULT_OPTIONS: ReactFlagEvaluationOptions = {\n  updateOnContextChanged: true,\n  updateOnConfigurationChanged: true,\n  suspendUntilReady: true,\n  suspendWhileReconciling: false,\n};\n\nenum SuspendState {\n  Pending,\n  Success,\n  Error,\n}\n\n// This type is a bit wild-looking, but I think we need it.\n// We have to use the conditional, because otherwise useFlag('key', false) would return false, not boolean (too constrained).\n// We have a duplicate for the hook return below, this one is just used for casting because the name isn't as clear\ntype ConstrainedFlagQuery<T> = FlagQuery<\n  T extends boolean\n    ? boolean\n    : T extends number\n      ? number\n      : T extends string\n        ? string\n        : T extends JsonValue\n          ? T\n          : JsonValue\n>;\n\n/**\n * Evaluates a feature flag generically, returning an react-flavored queryable object.\n * The resolver method to use is based on the type of the defaultValue.\n * For type-specific hooks, use {@link useBooleanFlagValue}, {@link useBooleanFlagDetails} and equivalents.\n * By default, components will re-render when the flag value changes.\n * @param {string} flagKey the flag identifier\n * @template {FlagValue} T A optional generic argument constraining the default.\n * @param {T} defaultValue the default value; used to determine what resolved type should be used.\n * @param {ReactFlagEvaluationOptions} options for this evaluation\n * @returns { FlagQuery } a queryable object containing useful information about the flag.\n */\nexport function useFlag<T extends FlagValue = FlagValue>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): FlagQuery<\nT extends boolean\n  ? boolean\n  : T extends number\n    ? number\n    : T extends string\n      ? string\n      : T extends JsonValue\n        ? T\n        : JsonValue\n> {\n  // use the default value to determine the resolver to call\n  const query =\n    typeof defaultValue === 'boolean'\n      ? new HookFlagQuery<boolean>(useBooleanFlagDetails(flagKey, defaultValue, options))\n      : typeof defaultValue === 'number'\n        ? new HookFlagQuery<number>(useNumberFlagDetails(flagKey, defaultValue, options))\n        : typeof defaultValue === 'string'\n          ? new HookFlagQuery<string>(useStringFlagDetails(flagKey, defaultValue, options))\n          : new HookFlagQuery<JsonValue>(useObjectFlagDetails(flagKey, defaultValue, options));\n  // TS sees this as HookFlagQuery<JsonValue>, because the compiler isn't aware of the `typeof` checks above.\n  return query as unknown as ConstrainedFlagQuery<T>;\n}\n\n/**\n * Evaluates a feature flag, returning a boolean.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @param {boolean} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { boolean} a EvaluationDetails object for this evaluation\n */\nexport function useBooleanFlagValue(\n  flagKey: string,\n  defaultValue: boolean,\n  options?: ReactFlagEvaluationOptions,\n): boolean {\n  return useBooleanFlagDetails(flagKey, defaultValue, options).value;\n}\n\n/**\n * Evaluates a feature flag, returning evaluation details.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @param {boolean} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { EvaluationDetails<boolean>} a EvaluationDetails object for this evaluation\n */\nexport function useBooleanFlagDetails(\n  flagKey: string,\n  defaultValue: boolean,\n  options?: ReactFlagEvaluationOptions,\n): EvaluationDetails<boolean> {\n  return attachHandlersAndResolve(\n    flagKey,\n    defaultValue,\n    (client) => {\n      return client.getBooleanDetails;\n    },\n    options,\n  );\n}\n\n/**\n * Evaluates a feature flag, returning a string.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @template {string} [T=string] A optional generic argument constraining the string\n * @param {T} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { boolean} a EvaluationDetails object for this evaluation\n */\nexport function useStringFlagValue<T extends string = string>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): string {\n  return useStringFlagDetails(flagKey, defaultValue, options).value;\n}\n\n/**\n * Evaluates a feature flag, returning evaluation details.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @template {string} [T=string] A optional generic argument constraining the string\n * @param {T} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { EvaluationDetails<string>} a EvaluationDetails object for this evaluation\n */\nexport function useStringFlagDetails<T extends string = string>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): EvaluationDetails<string> {\n  return attachHandlersAndResolve(\n    flagKey,\n    defaultValue,\n    (client) => {\n      return client.getStringDetails<T>;\n    },\n    options,\n  );\n}\n\n/**\n * Evaluates a feature flag, returning a number.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @template {number} [T=number] A optional generic argument constraining the number\n * @param {T} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { boolean} a EvaluationDetails object for this evaluation\n */\nexport function useNumberFlagValue<T extends number = number>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): number {\n  return useNumberFlagDetails(flagKey, defaultValue, options).value;\n}\n\n/**\n * Evaluates a feature flag, returning evaluation details.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @template {number} [T=number] A optional generic argument constraining the number\n * @param {T} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { EvaluationDetails<number>} a EvaluationDetails object for this evaluation\n */\nexport function useNumberFlagDetails<T extends number = number>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): EvaluationDetails<number> {\n  return attachHandlersAndResolve(\n    flagKey,\n    defaultValue,\n    (client) => {\n      return client.getNumberDetails<T>;\n    },\n    options,\n  );\n}\n\n/**\n * Evaluates a feature flag, returning an object.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @template {JsonValue} [T=JsonValue] A optional generic argument describing the structure\n * @param {T} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { boolean} a EvaluationDetails object for this evaluation\n */\nexport function useObjectFlagValue<T extends JsonValue = JsonValue>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): T {\n  return useObjectFlagDetails<T>(flagKey, defaultValue, options).value;\n}\n\n/**\n * Evaluates a feature flag, returning evaluation details.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @param {T} defaultValue the default value\n * @template {JsonValue} [T=JsonValue] A optional generic argument describing the structure\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { EvaluationDetails<T>} a EvaluationDetails object for this evaluation\n */\nexport function useObjectFlagDetails<T extends JsonValue = JsonValue>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): EvaluationDetails<T> {\n  return attachHandlersAndResolve(\n    flagKey,\n    defaultValue,\n    (client) => {\n      return client.getObjectDetails<T>;\n    },\n    options,\n  );\n}\n\nfunction attachHandlersAndResolve<T extends FlagValue>(\n  flagKey: string,\n  defaultValue: T,\n  resolver: (client: Client) => (flagKey: string, defaultValue: T) => EvaluationDetails<T>,\n  options?: ReactFlagEvaluationOptions,\n): EvaluationDetails<T> {\n  const defaultedOptions = { ...DEFAULT_OPTIONS, ...options };\n  const [, updateState] = useState<object | undefined>();\n  const client = useOpenFeatureClient();\n  const forceUpdate = () => {\n    updateState({});\n  };\n  const suspendRef = () => {\n    suspend(\n      client,\n      updateState,\n      ProviderEvents.ContextChanged,\n      ProviderEvents.ConfigurationChanged,\n      ProviderEvents.Ready,\n    );\n  };\n\n  useEffect(() => {\n    if (client.providerStatus === ProviderStatus.NOT_READY) {\n      // update when the provider is ready\n      client.addHandler(ProviderEvents.Ready, forceUpdate);\n      if (defaultedOptions.suspendUntilReady) {\n        suspend(client, updateState, ProviderEvents.Ready);\n      }\n    }\n\n    if (defaultedOptions.updateOnContextChanged) {\n      // update when the context changes\n      client.addHandler(ProviderEvents.ContextChanged, forceUpdate);\n      if (defaultedOptions.suspendWhileReconciling) {\n        client.addHandler(ProviderEvents.Reconciling, suspendRef);\n      }\n    }\n    return () => {\n      // cleanup the handlers\n      client.removeHandler(ProviderEvents.Ready, forceUpdate);\n      client.removeHandler(ProviderEvents.ContextChanged, forceUpdate);\n      client.removeHandler(ProviderEvents.Reconciling, suspendRef);\n    };\n  }, []);\n\n  useEffect(() => {\n    if (defaultedOptions.updateOnConfigurationChanged) {\n      // update when the provider configuration changes\n      client.addHandler(ProviderEvents.ConfigurationChanged, forceUpdate);\n    }\n    return () => {\n      // cleanup the handlers\n      client.removeHandler(ProviderEvents.ConfigurationChanged, forceUpdate);\n    };\n  }, []);\n\n  return resolver(client).call(client, flagKey, defaultValue);\n}\n\n/**\n * Suspend function. If this runs, components using the calling hook will be suspended.\n * @param {Client} client the OpenFeature client\n * @param {Function} updateState the state update function\n * @param {ProviderEvents[]} resumeEvents list of events which will resume the suspend\n */\nfunction suspend(\n  client: Client,\n  updateState: Dispatch<SetStateAction<object | undefined>>,\n  ...resumeEvents: ProviderEvents[]\n) {\n  let suspendResolver: () => void;\n\n  const suspendPromise = new Promise<void>((resolve) => {\n    suspendResolver = () => {\n      resolve();\n      resumeEvents.forEach((e) => {\n        client.removeHandler(e, suspendResolver); // remove handlers once they've run\n      });\n      client.removeHandler(ProviderEvents.Error, suspendResolver);\n    };\n    resumeEvents.forEach((e) => {\n      client.addHandler(e, suspendResolver);\n    });\n    client.addHandler(ProviderEvents.Error, suspendResolver); // we never want to throw, resolve with errors - we may make this configurable later\n  });\n  updateState(suspenseWrapper(suspendPromise));\n}\n\n/**\n * Promise wrapper that throws unresolved promises to support React suspense.\n * @param {Promise<T>} promise to wrap\n * @template T flag type\n * @returns {Function} suspense-compliant lambda\n */\nfunction suspenseWrapper<T>(promise: Promise<T>) {\n  let status: SuspendState = SuspendState.Pending;\n  let result: T;\n\n  const suspended = promise\n    .then((value) => {\n      status = SuspendState.Success;\n      result = value;\n    })\n    .catch((error) => {\n      status = SuspendState.Error;\n      result = error;\n    });\n\n  return () => {\n    switch (status) {\n      case SuspendState.Pending:\n        throw suspended;\n      case SuspendState.Success:\n        return result;\n      case SuspendState.Error:\n        throw result;\n      default:\n        throw new Error('Suspending promise is in an unknown state.');\n    }\n  };\n}\n\n// FlagQuery implementation, do not export\nclass HookFlagQuery<T extends FlagValue = FlagValue> implements FlagQuery {\n  constructor(private _details: EvaluationDetails<T>) {}\n\n  get details() {\n    return this._details;\n  }\n\n  get value() {\n    return this._details?.value;\n  }\n\n  get variant() {\n    return this._details.variant;\n  }\n\n  get flagMetadata() {\n    return this._details.flagMetadata;\n  }\n\n  get reason() {\n    return this._details.reason;\n  }\n\n  get isError() {\n    return !!this._details?.errorCode || this._details.reason == StandardResolutionReasons.ERROR;\n  }\n\n  get errorCode() {\n    return this._details?.errorCode;\n  }\n\n  get errorMessage() {\n    return this._details?.errorMessage;\n  }\n\n  get isAuthoritative() {\n    return (\n      !this.isError &&\n      this._details.reason != StandardResolutionReasons.STALE &&\n      this._details.reason != StandardResolutionReasons.DISABLED\n    );\n  }\n\n  get type() {\n    return typeof this._details.value;\n  }\n}\n", "import * as React from 'react';\nimport { Client, OpenFeature } from '@openfeature/web-sdk';\n\ntype ClientOrDomain =\n  | {\n      /**\n       * An identifier which logically binds clients with providers\n       * @see OpenFeature.setProvider() and overloads.\n       */\n      domain?: string;\n      client?: never;\n    }\n  | {\n      /**\n       * OpenFeature client to use.\n       */\n      client?: Client;\n      domain?: never;\n    };\n\ntype ProviderProps = {\n  children?: React.ReactNode;\n} & ClientOrDomain;\n\nconst Context = React.createContext<Client | undefined>(undefined);\n\nexport const OpenFeatureProvider = ({ client, domain, children }: ProviderProps) => {\n  if (!client) {\n    client = OpenFeature.getClient(domain);\n  }\n\n  return <Context.Provider value={client}>{children}</Context.Provider>;\n};\n\nexport const useOpenFeatureClient = () => {\n  const client = React.useContext(Context);\n\n  if (!client) {\n    throw new Error(\n      'No OpenFeature client available - components using OpenFeature must be wrapped with an <OpenFeatureProvider>'\n    );\n  }\n\n  return client;\n};\n", "export * from './evaluation';\nexport * from './query';\nexport * from './provider';\n// re-export the web-sdk so consumers can access that API from the react-sdk\nexport * from '@openfeature/web-sdk';\n"],
-  "mappings": "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",
-  "names": []
+  "sources": ["../../src/evaluation/use-feature-flag.ts", "../../src/common/options.ts", "../../src/common/suspend.ts", "../../src/provider/context.ts", "../../src/provider/use-open-feature-client.ts", "../../src/provider/provider.tsx", "../../src/provider/use-when-provider-ready.ts", "../../src/index.ts"],
+  "sourcesContent": ["import {\n  Client,\n  EvaluationDetails,\n  FlagValue,\n  JsonValue,\n  ProviderEvents,\n  ProviderStatus,\n  StandardResolutionReasons\n} from '@openfeature/web-sdk';\nimport { useEffect, useState } from 'react';\nimport { DEFAULT_OPTIONS, ReactFlagEvaluationOptions, normalizeOptions } from '../common/options';\nimport { suspend } from '../common/suspend';\nimport { useProviderOptions } from '../provider/context';\nimport { useOpenFeatureClient } from '../provider/use-open-feature-client';\nimport { FlagQuery } from '../query';\n\n// This type is a bit wild-looking, but I think we need it.\n// We have to use the conditional, because otherwise useFlag('key', false) would return false, not boolean (too constrained).\n// We have a duplicate for the hook return below, this one is just used for casting because the name isn't as clear\ntype ConstrainedFlagQuery<T> = FlagQuery<\n  T extends boolean\n    ? boolean\n    : T extends number\n      ? number\n      : T extends string\n        ? string\n        : T extends JsonValue\n          ? T\n          : JsonValue\n>;\n\n/**\n * Evaluates a feature flag generically, returning an react-flavored queryable object.\n * The resolver method to use is based on the type of the defaultValue.\n * For type-specific hooks, use {@link useBooleanFlagValue}, {@link useBooleanFlagDetails} and equivalents.\n * By default, components will re-render when the flag value changes.\n * @param {string} flagKey the flag identifier\n * @template {FlagValue} T A optional generic argument constraining the default.\n * @param {T} defaultValue the default value; used to determine what resolved type should be used.\n * @param {ReactFlagEvaluationOptions} options for this evaluation\n * @returns { FlagQuery } a queryable object containing useful information about the flag.\n */\nexport function useFlag<T extends FlagValue = FlagValue>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): FlagQuery<\nT extends boolean\n  ? boolean\n  : T extends number\n    ? number\n    : T extends string\n      ? string\n      : T extends JsonValue\n        ? T\n        : JsonValue\n> {\n  // use the default value to determine the resolver to call\n  const query =\n    typeof defaultValue === 'boolean'\n      ? new HookFlagQuery<boolean>(useBooleanFlagDetails(flagKey, defaultValue, options))\n      : typeof defaultValue === 'number'\n        ? new HookFlagQuery<number>(useNumberFlagDetails(flagKey, defaultValue, options))\n        : typeof defaultValue === 'string'\n          ? new HookFlagQuery<string>(useStringFlagDetails(flagKey, defaultValue, options))\n          : new HookFlagQuery<JsonValue>(useObjectFlagDetails(flagKey, defaultValue, options));\n  // TS sees this as HookFlagQuery<JsonValue>, because the compiler isn't aware of the `typeof` checks above.\n  return query as unknown as ConstrainedFlagQuery<T>;\n}\n\n/**\n * Evaluates a feature flag, returning a boolean.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @param {boolean} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { boolean} a EvaluationDetails object for this evaluation\n */\nexport function useBooleanFlagValue(\n  flagKey: string,\n  defaultValue: boolean,\n  options?: ReactFlagEvaluationOptions,\n): boolean {\n  return useBooleanFlagDetails(flagKey, defaultValue, options).value;\n}\n\n/**\n * Evaluates a feature flag, returning evaluation details.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @param {boolean} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { EvaluationDetails<boolean>} a EvaluationDetails object for this evaluation\n */\nexport function useBooleanFlagDetails(\n  flagKey: string,\n  defaultValue: boolean,\n  options?: ReactFlagEvaluationOptions,\n): EvaluationDetails<boolean> {\n  return attachHandlersAndResolve(\n    flagKey,\n    defaultValue,\n    (client) => {\n      return client.getBooleanDetails;\n    },\n    options,\n  );\n}\n\n/**\n * Evaluates a feature flag, returning a string.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @template {string} [T=string] A optional generic argument constraining the string\n * @param {T} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { boolean} a EvaluationDetails object for this evaluation\n */\nexport function useStringFlagValue<T extends string = string>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): string {\n  return useStringFlagDetails(flagKey, defaultValue, options).value;\n}\n\n/**\n * Evaluates a feature flag, returning evaluation details.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @template {string} [T=string] A optional generic argument constraining the string\n * @param {T} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { EvaluationDetails<string>} a EvaluationDetails object for this evaluation\n */\nexport function useStringFlagDetails<T extends string = string>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): EvaluationDetails<string> {\n  return attachHandlersAndResolve(\n    flagKey,\n    defaultValue,\n    (client) => {\n      return client.getStringDetails<T>;\n    },\n    options,\n  );\n}\n\n/**\n * Evaluates a feature flag, returning a number.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @template {number} [T=number] A optional generic argument constraining the number\n * @param {T} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { boolean} a EvaluationDetails object for this evaluation\n */\nexport function useNumberFlagValue<T extends number = number>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): number {\n  return useNumberFlagDetails(flagKey, defaultValue, options).value;\n}\n\n/**\n * Evaluates a feature flag, returning evaluation details.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @template {number} [T=number] A optional generic argument constraining the number\n * @param {T} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { EvaluationDetails<number>} a EvaluationDetails object for this evaluation\n */\nexport function useNumberFlagDetails<T extends number = number>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): EvaluationDetails<number> {\n  return attachHandlersAndResolve(\n    flagKey,\n    defaultValue,\n    (client) => {\n      return client.getNumberDetails<T>;\n    },\n    options,\n  );\n}\n\n/**\n * Evaluates a feature flag, returning an object.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @template {JsonValue} [T=JsonValue] A optional generic argument describing the structure\n * @param {T} defaultValue the default value\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { boolean} a EvaluationDetails object for this evaluation\n */\nexport function useObjectFlagValue<T extends JsonValue = JsonValue>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): T {\n  return useObjectFlagDetails<T>(flagKey, defaultValue, options).value;\n}\n\n/**\n * Evaluates a feature flag, returning evaluation details.\n * By default, components will re-render when the flag value changes.\n * For a generic hook returning a queryable interface, see {@link useFlag}.\n * @param {string} flagKey the flag identifier\n * @param {T} defaultValue the default value\n * @template {JsonValue} [T=JsonValue] A optional generic argument describing the structure\n * @param {ReactFlagEvaluationOptions} options options for this evaluation\n * @returns { EvaluationDetails<T>} a EvaluationDetails object for this evaluation\n */\nexport function useObjectFlagDetails<T extends JsonValue = JsonValue>(\n  flagKey: string,\n  defaultValue: T,\n  options?: ReactFlagEvaluationOptions,\n): EvaluationDetails<T> {\n  return attachHandlersAndResolve(\n    flagKey,\n    defaultValue,\n    (client) => {\n      return client.getObjectDetails<T>;\n    },\n    options,\n  );\n}\n\nfunction attachHandlersAndResolve<T extends FlagValue>(\n  flagKey: string,\n  defaultValue: T,\n  resolver: (client: Client) => (flagKey: string, defaultValue: T) => EvaluationDetails<T>,\n  options?: ReactFlagEvaluationOptions,\n): EvaluationDetails<T> {\n  // highest priority > evaluation hook options > provider options > default options > lowest priority\n  const defaultedOptions = { ...DEFAULT_OPTIONS, ...useProviderOptions(), ...normalizeOptions(options)};\n  const [, updateState] = useState<object | undefined>();\n  const client = useOpenFeatureClient();\n  const forceUpdate = () => {\n    updateState({});\n  };\n  const suspendRef = () => {\n    suspend(\n      client,\n      updateState,\n      ProviderEvents.ContextChanged,\n      ProviderEvents.ConfigurationChanged,\n      ProviderEvents.Ready,\n    );\n  };\n\n  useEffect(() => {\n    if (client.providerStatus === ProviderStatus.NOT_READY) {\n      // update when the provider is ready\n      client.addHandler(ProviderEvents.Ready, forceUpdate);\n      if (defaultedOptions.suspendUntilReady) {\n        suspend(client, updateState, ProviderEvents.Ready);\n      }\n    }\n\n    if (defaultedOptions.updateOnContextChanged) {\n      // update when the context changes\n      client.addHandler(ProviderEvents.ContextChanged, forceUpdate);\n      if (defaultedOptions.suspendWhileReconciling) {\n        client.addHandler(ProviderEvents.Reconciling, suspendRef);\n      }\n    }\n    return () => {\n      // cleanup the handlers\n      client.removeHandler(ProviderEvents.Ready, forceUpdate);\n      client.removeHandler(ProviderEvents.ContextChanged, forceUpdate);\n      client.removeHandler(ProviderEvents.Reconciling, suspendRef);\n    };\n  }, []);\n\n  useEffect(() => {\n    if (defaultedOptions.updateOnConfigurationChanged) {\n      // update when the provider configuration changes\n      client.addHandler(ProviderEvents.ConfigurationChanged, forceUpdate);\n    }\n    return () => {\n      // cleanup the handlers\n      client.removeHandler(ProviderEvents.ConfigurationChanged, forceUpdate);\n    };\n  }, []);\n\n  return resolver(client).call(client, flagKey, defaultValue);\n}\n\n// FlagQuery implementation, do not export\nclass HookFlagQuery<T extends FlagValue = FlagValue> implements FlagQuery {\n  constructor(private _details: EvaluationDetails<T>) {}\n\n  get details() {\n    return this._details;\n  }\n\n  get value() {\n    return this._details?.value;\n  }\n\n  get variant() {\n    return this._details.variant;\n  }\n\n  get flagMetadata() {\n    return this._details.flagMetadata;\n  }\n\n  get reason() {\n    return this._details.reason;\n  }\n\n  get isError() {\n    return !!this._details?.errorCode || this._details.reason == StandardResolutionReasons.ERROR;\n  }\n\n  get errorCode() {\n    return this._details?.errorCode;\n  }\n\n  get errorMessage() {\n    return this._details?.errorMessage;\n  }\n\n  get isAuthoritative() {\n    return (\n      !this.isError &&\n      this._details.reason != StandardResolutionReasons.STALE &&\n      this._details.reason != StandardResolutionReasons.DISABLED\n    );\n  }\n\n  get type() {\n    return typeof this._details.value;\n  }\n}\n", "import { FlagEvaluationOptions } from '@openfeature/web-sdk';\n\nexport type ReactFlagEvaluationOptions = ({\n  /**\n   * Enable or disable all suspense functionality.\n   * Cannot be used in conjunction with `suspendUntilReady` and `suspendWhileReconciling` options.\n   */\n  suspend?: boolean;\n  suspendUntilReady?: never;\n  suspendWhileReconciling?: never;\n} | {\n  /**\n   * Suspend flag evaluations while the provider is not ready.\n   * Set to false if you don't want to show suspense fallbacks until the provider is initialized.\n   * Defaults to true.\n   * Cannot be used in conjunction with `suspend` option.\n   */\n  suspendUntilReady?: boolean;\n  /**\n   * Suspend flag evaluations while the provider's context is being reconciled.\n   * Set to true if you want to show suspense fallbacks while flags are re-evaluated after context changes.\n   * Defaults to true.\n   * Cannot be used in conjunction with `suspend` option.\n   */\n  suspendWhileReconciling?: boolean;\n  suspend?: never;\n}) & {\n  /**\n   * Update the component if the provider emits a ConfigurationChanged event.\n   * Set to false to prevent components from re-rendering when flag value changes\n   * are received by the associated provider.\n   * Defaults to true.\n   */\n  updateOnConfigurationChanged?: boolean;\n  /**\n   * Update the component when the OpenFeature context changes.\n   * Set to false to prevent components from re-rendering when attributes which\n   * may be factors in flag evaluation change.\n   * Defaults to true.\n   */\n  updateOnContextChanged?: boolean;\n} & FlagEvaluationOptions;\n\nexport type NormalizedOptions = Omit<ReactFlagEvaluationOptions, 'suspend'>;\n\n/**\n * Default options.\n * DO NOT EXPORT PUBLICLY\n * @internal\n */\nexport const DEFAULT_OPTIONS: ReactFlagEvaluationOptions = {\n  updateOnContextChanged: true,\n  updateOnConfigurationChanged: true,\n  suspendUntilReady: true,\n  suspendWhileReconciling: true,\n};\n\n/**\n * Returns normalization options (all `undefined` fields removed, and `suspend` decomposed to `suspendUntilReady` and `suspendWhileReconciling`).\n * DO NOT EXPORT PUBLICLY\n * @internal\n * @param {ReactFlagEvaluationOptions} options  options to normalize\n * @returns {NormalizedOptions} normalized options\n */\nexport const normalizeOptions: (options?: ReactFlagEvaluationOptions) => NormalizedOptions = (options?: ReactFlagEvaluationOptions) => {\n  const defaultOptionsIfMissing = !options ? {} : options;\n  // fall-back the suspense options\n  const suspendUntilReady = 'suspendUntilReady' in defaultOptionsIfMissing ? defaultOptionsIfMissing.suspendUntilReady : defaultOptionsIfMissing.suspend;\n  const suspendWhileReconciling = 'suspendWhileReconciling' in defaultOptionsIfMissing ? defaultOptionsIfMissing.suspendWhileReconciling : defaultOptionsIfMissing.suspend;\n  return {\n    updateOnContextChanged: defaultOptionsIfMissing.updateOnContextChanged,\n    updateOnConfigurationChanged: defaultOptionsIfMissing.updateOnConfigurationChanged,\n    // only return these if properly set (no undefined to allow overriding with spread)\n    ...(typeof suspendUntilReady === 'boolean' && {suspendUntilReady}),\n    ...(typeof suspendWhileReconciling === 'boolean' && {suspendWhileReconciling}),\n  };\n};\n", "import { Client, ProviderEvents } from '@openfeature/web-sdk';\nimport { Dispatch, SetStateAction } from 'react';\n\nenum SuspendState {\n  Pending,\n  Success,\n  Error,\n}\n\n/**\n * Suspend function. If this runs, components using the calling hook will be suspended.\n * DO NOT EXPORT PUBLICLY \n * @internal\n * @param {Client} client the OpenFeature client\n * @param {Function} updateState the state update function\n * @param {ProviderEvents[]} resumeEvents list of events which will resume the suspend\n */\nexport function suspend(\n  client: Client,\n  updateState: Dispatch<SetStateAction<object | undefined>>,\n  ...resumeEvents: ProviderEvents[]\n) {\n  let suspendResolver: () => void;\n\n  const suspendPromise = new Promise<void>((resolve) => {\n    suspendResolver = () => {\n      resolve();\n      resumeEvents.forEach((e) => {\n        client.removeHandler(e, suspendResolver); // remove handlers once they've run\n      });\n      client.removeHandler(ProviderEvents.Error, suspendResolver);\n    };\n    resumeEvents.forEach((e) => {\n      client.addHandler(e, suspendResolver);\n    });\n    client.addHandler(ProviderEvents.Error, suspendResolver); // we never want to throw, resolve with errors - we may make this configurable later\n  });\n  updateState(suspenseWrapper(suspendPromise));\n}\n\n/**\n * Promise wrapper that throws unresolved promises to support React suspense.\n * DO NOT EXPORT PUBLICLY\n * @internal\n * @param {Promise<T>} promise to wrap\n * @template T flag type\n * @returns {Function} suspense-compliant lambda\n */\nexport function suspenseWrapper<T>(promise: Promise<T>) {\n  let status: SuspendState = SuspendState.Pending;\n  let result: T;\n\n  const suspended = promise\n    .then((value) => {\n      status = SuspendState.Success;\n      result = value;\n    })\n    .catch((error) => {\n      status = SuspendState.Error;\n      result = error;\n    });\n\n  return () => {\n    switch (status) {\n      case SuspendState.Pending:\n        throw suspended;\n      case SuspendState.Success:\n        return result;\n      case SuspendState.Error:\n        throw result;\n      default:\n        throw new Error('Suspending promise is in an unknown state.');\n    }\n  };\n}\n", "import { Client } from '@openfeature/web-sdk';\nimport React from 'react';\nimport { NormalizedOptions, ReactFlagEvaluationOptions, normalizeOptions } from '../common/options';\n\n/**\n * The underlying React context.\n * DO NOT EXPORT PUBLICLY\n * @internal\n */\nexport const Context = React.createContext<{ client: Client; options: ReactFlagEvaluationOptions } | undefined>(undefined);\n\n/**\n * Get a normalized copy of the options used for this OpenFeatureProvider, see {@link normalizeOptions}.\n * DO NOT EXPORT PUBLICLY\n * @internal\n * @returns {NormalizedOptions} normalized options the defaulted options, not defaulted or normalized.\n */\nexport function useProviderOptions(): NormalizedOptions {\n  const { options } = React.useContext(Context) || {};\n  return normalizeOptions(options);\n}\n", "import React from 'react';\nimport { Context } from './context';\nimport { Client } from '@openfeature/web-sdk';\n\n/**\n * Get the {@link Client} instance for this OpenFeatureProvider context.\n * Note that the provider to which this is bound is determined by the OpenFeatureProvider's domain.\n * @returns {Client} client for this scope\n */\nexport function useOpenFeatureClient(): Client {\n  const { client } = React.useContext(Context) || {};\n\n  if (!client) {\n    throw new Error(\n      'No OpenFeature client available - components using OpenFeature must be wrapped with an <OpenFeatureProvider>',\n    );\n  }\n\n  return client;\n}\n", "import { Client, OpenFeature } from '@openfeature/web-sdk';\nimport * as React from 'react';\nimport { ReactFlagEvaluationOptions } from '../common/options';\nimport { Context } from './context';\n\ntype ClientOrDomain =\n  | {\n      /**\n       * An identifier which logically binds clients with providers\n       * @see OpenFeature.setProvider() and overloads.\n       */\n      domain?: string;\n      client?: never;\n    }\n  | {\n      /**\n       * OpenFeature client to use.\n       */\n      client?: Client;\n      domain?: never;\n    };\n\ntype ProviderProps = {\n  children?: React.ReactNode;\n} & ClientOrDomain &\n  ReactFlagEvaluationOptions;\n\n  /**\n   * Provides a scope for evaluating feature flags by binding a client to all child components.\n   * @param {ProviderProps} properties props for the context provider\n   * @returns {OpenFeatureProvider} context provider\n   */\nexport function OpenFeatureProvider({ client, domain, children, ...options }: ProviderProps) {\n  if (!client) {\n    client = OpenFeature.getClient(domain);\n  }\n\n  return <Context.Provider value={{ client, options }}>{children}</Context.Provider>;\n}\n", "import { ProviderEvents, ProviderStatus } from '@openfeature/web-sdk';\nimport { useEffect, useState } from 'react';\nimport { DEFAULT_OPTIONS, ReactFlagEvaluationOptions, normalizeOptions } from '../common/options';\nimport { suspend } from '../common/suspend';\nimport { useProviderOptions } from './context';\nimport { useOpenFeatureClient } from './use-open-feature-client';\n\ntype Options = Pick<ReactFlagEvaluationOptions, 'suspendUntilReady'>;\n\n/**\n * Utility hook that triggers suspense until the provider is {@link ProviderStatus.READY}, without evaluating any flags.\n * Especially useful for React v16/17 \"Legacy Suspense\", in which siblings to suspending components are\n * initially mounted and then hidden (see: https://github.com/reactwg/react-18/discussions/7).\n * @param {Options} options options for suspense\n * @returns {boolean} boolean indicating if provider is {@link ProviderStatus.READY}, useful if suspense is disabled and you want to handle loaders on your own\n */\nexport function useWhenProviderReady(options?: Options): boolean {\n  const [, updateState] = useState<object | undefined>();\n  const client = useOpenFeatureClient();\n  // highest priority > evaluation hook options > provider options > default options > lowest priority\n  const defaultedOptions = { ...DEFAULT_OPTIONS, ...useProviderOptions(), ...normalizeOptions(options)};\n\n  useEffect(() => {\n    if (defaultedOptions.suspendUntilReady && client.providerStatus === ProviderStatus.NOT_READY) {\n      suspend(client, updateState, ProviderEvents.Ready);\n    }\n  }, []);\n\n  return client.providerStatus === ProviderStatus.READY;\n}\n", "export * from './evaluation';\nexport * from './query';\nexport * from './provider';\n// re-export the web-sdk so consumers can access that API from the react-sdk\nexport * from '@openfeature/web-sdk';\n"],
+  "mappings": "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",
+  "names": ["ProviderEvents", "React", "React", "ProviderEvents", "React", "ProviderEvents", "ProviderStatus", "useEffect", "useState", "useState", "useEffect", "ProviderStatus", "ProviderEvents"]
 }

package/dist/types.d.ts

@@ -1,8 +1,49 @@
-import { FlagValue as FlagValue$1, JsonValue, EvaluationDetails as EvaluationDetails$1, FlagEvaluationOptions, Client } from '@openfeature/web-sdk';
+import { FlagEvaluationOptions, FlagValue as FlagValue$1, JsonValue, EvaluationDetails as EvaluationDetails$1, Client } from '@openfeature/web-sdk';
 export * from '@openfeature/web-sdk';
 import { FlagValue, EvaluationDetails, FlagMetadata, StandardResolutionReasons, ErrorCode } from '@openfeature/core';
 import * as React from 'react';
 
+type ReactFlagEvaluationOptions = ({
+    /**
+     * Enable or disable all suspense functionality.
+     * Cannot be used in conjunction with `suspendUntilReady` and `suspendWhileReconciling` options.
+     */
+    suspend?: boolean;
+    suspendUntilReady?: never;
+    suspendWhileReconciling?: never;
+} | {
+    /**
+     * Suspend flag evaluations while the provider is not ready.
+     * Set to false if you don't want to show suspense fallbacks until the provider is initialized.
+     * Defaults to true.
+     * Cannot be used in conjunction with `suspend` option.
+     */
+    suspendUntilReady?: boolean;
+    /**
+     * Suspend flag evaluations while the provider's context is being reconciled.
+     * Set to true if you want to show suspense fallbacks while flags are re-evaluated after context changes.
+     * Defaults to true.
+     * Cannot be used in conjunction with `suspend` option.
+     */
+    suspendWhileReconciling?: boolean;
+    suspend?: never;
+}) & {
+    /**
+     * Update the component if the provider emits a ConfigurationChanged event.
+     * Set to false to prevent components from re-rendering when flag value changes
+     * are received by the associated provider.
+     * Defaults to true.
+     */
+    updateOnConfigurationChanged?: boolean;
+    /**
+     * Update the component when the OpenFeature context changes.
+     * Set to false to prevent components from re-rendering when attributes which
+     * may be factors in flag evaluation change.
+     * Defaults to true.
+     */
+    updateOnContextChanged?: boolean;
+} & FlagEvaluationOptions;
+
 interface FlagQuery<T extends FlagValue = FlagValue> {
     /**
      * A structure representing the result of the flag evaluation process
@@ -51,34 +92,6 @@ interface FlagQuery<T extends FlagValue = FlagValue> {
     readonly type: 'string' | 'number' | 'bigint' | 'boolean' | 'symbol' | 'undefined' | 'object' | 'function';
 }
 
-type ReactFlagEvaluationOptions = {
-    /**
-     * Suspend flag evaluations while the provider is not ready.
-     * Set to false if you don't want to show suspense fallbacks until the provider is initialized.
-     * Defaults to true.
-     */
-    suspendUntilReady?: boolean;
-    /**
-     * Suspend flag evaluations while the provider's context is being reconciled.
-     * Set to true if you want to show suspense fallbacks while flags are re-evaluated after context changes.
-     * Defaults to false.
-     */
-    suspendWhileReconciling?: boolean;
-    /**
-     * Update the component if the provider emits a ConfigurationChanged event.
-     * Set to false to prevent components from re-rendering when flag value changes
-     * are received by the associated provider.
-     * Defaults to true.
-     */
-    updateOnConfigurationChanged?: boolean;
-    /**
-     * Update the component when the OpenFeature context changes.
-     * Set to false to prevent components from re-rendering when attributes which
-     * may be factors in flag evaluation change.
-     * Defaults to true.
-     */
-    updateOnContextChanged?: boolean;
-} & FlagEvaluationOptions;
 /**
  * Evaluates a feature flag generically, returning an react-flavored queryable object.
  * The resolver method to use is based on the type of the defaultValue.
@@ -194,8 +207,29 @@ type ClientOrDomain = {
 };
 type ProviderProps = {
     children?: React.ReactNode;
-} & ClientOrDomain;
-declare const OpenFeatureProvider: ({ client, domain, children }: ProviderProps) => React.JSX.Element;
-declare const useOpenFeatureClient: () => Client;
+} & ClientOrDomain & ReactFlagEvaluationOptions;
+/**
+ * Provides a scope for evaluating feature flags by binding a client to all child components.
+ * @param {ProviderProps} properties props for the context provider
+ * @returns {OpenFeatureProvider} context provider
+ */
+declare function OpenFeatureProvider({ client, domain, children, ...options }: ProviderProps): React.JSX.Element;
+
+/**
+ * Get the {@link Client} instance for this OpenFeatureProvider context.
+ * Note that the provider to which this is bound is determined by the OpenFeatureProvider's domain.
+ * @returns {Client} client for this scope
+ */
+declare function useOpenFeatureClient(): Client;
+
+type Options = Pick<ReactFlagEvaluationOptions, 'suspendUntilReady'>;
+/**
+ * Utility hook that triggers suspense until the provider is {@link ProviderStatus.READY}, without evaluating any flags.
+ * Especially useful for React v16/17 "Legacy Suspense", in which siblings to suspending components are
+ * initially mounted and then hidden (see: https://github.com/reactwg/react-18/discussions/7).
+ * @param {Options} options options for suspense
+ * @returns {boolean} boolean indicating if provider is {@link ProviderStatus.READY}, useful if suspense is disabled and you want to handle loaders on your own
+ */
+declare function useWhenProviderReady(options?: Options): boolean;
 
-export { FlagQuery, OpenFeatureProvider, useBooleanFlagDetails, useBooleanFlagValue, useFlag, useNumberFlagDetails, useNumberFlagValue, useObjectFlagDetails, useObjectFlagValue, useOpenFeatureClient, useStringFlagDetails, useStringFlagValue };
+export { FlagQuery, OpenFeatureProvider, useBooleanFlagDetails, useBooleanFlagValue, useFlag, useNumberFlagDetails, useNumberFlagValue, useObjectFlagDetails, useObjectFlagValue, useOpenFeatureClient, useStringFlagDetails, useStringFlagValue, useWhenProviderReady };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfeature/react-sdk",
-  "version": "0.2.4-experimental",
+  "version": "0.3.0-experimental",
   "description": "OpenFeature React SDK",
   "main": "./dist/cjs/index.js",
   "files": [