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

package/dist/cjs/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/index.ts", "../../src/use-feature-flag.ts", "../../src/provider.tsx"],
-  "sourcesContent": ["export * from './use-feature-flag';\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 { Client, EvaluationDetails, FlagEvaluationOptions, FlagValue, JsonValue, ProviderEvents, ProviderStatus } from '@openfeature/web-sdk';\nimport { Dispatch, SetStateAction, useEffect, useState } from 'react';\nimport { useOpenFeatureClient } from './provider';\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/**\n * Evaluates a feature flag, returning a boolean.\n * By default, components will re-render when the flag value changes.\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(flagKey: string, defaultValue: boolean, options?: ReactFlagEvaluationOptions): 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 * @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(flagKey: string, defaultValue: boolean, options?: ReactFlagEvaluationOptions): EvaluationDetails<boolean> {\n  return attachHandlersAndResolve(flagKey, defaultValue, (client) => {\n    return client.getBooleanDetails;\n  },  options);\n}\n\n/**\n * Evaluates a feature flag, returning a string.\n * By default, components will re-render when the flag value changes.\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>(flagKey: string, defaultValue: T, options?: ReactFlagEvaluationOptions): T {\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 * @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>(flagKey: string, defaultValue: T, options?: ReactFlagEvaluationOptions): EvaluationDetails<T> {\n  return attachHandlersAndResolve(flagKey, defaultValue, (client) => {\n    return client.getStringDetails<T>;\n  },  options);\n}\n\n/**\n * Evaluates a feature flag, returning a number.\n * By default, components will re-render when the flag value changes.\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>(flagKey: string, defaultValue: T, options?: ReactFlagEvaluationOptions): T {\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 * @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>(flagKey: string, defaultValue: T, options?: ReactFlagEvaluationOptions): EvaluationDetails<T> {\n  return attachHandlersAndResolve(flagKey, defaultValue, (client) => {\n    return client.getNumberDetails<T>;\n  },  options);\n}\n\n/**\n * Evaluates a feature flag, returning an object.\n * By default, components will re-render when the flag value changes.\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>(flagKey: string, defaultValue: T, options?: ReactFlagEvaluationOptions): 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 * @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>(flagKey: string, defaultValue: T, options?: ReactFlagEvaluationOptions): EvaluationDetails<T> {\n  return attachHandlersAndResolve(flagKey, defaultValue, (client) => {\n    return client.getObjectDetails<T>;\n  },  options);\n}\n\nfunction attachHandlersAndResolve<T extends FlagValue>(flagKey: string, defaultValue: T, resolver: (client: Client) => (flagKey: string, defaultValue: T) => EvaluationDetails<T>, options?: ReactFlagEvaluationOptions): 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(client, updateState, ProviderEvents.ContextChanged, ProviderEvents.ConfigurationChanged, ProviderEvents.Ready);\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(client: Client, updateState: Dispatch<SetStateAction<object | undefined>>, ...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.then(\n    (value) => {\n      status = SuspendState.Success;\n      result = value;\n    },\n    (error) => {\n      status = SuspendState.Error;\n      result = error;\n    }\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};", "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,147 +1,255 @@
-// src/use-feature-flag.ts
-import { ProviderEvents, ProviderStatus } from "@openfeature/web-sdk";
+// src/evaluation/use-feature-flag.ts
+import {
+  ProviderEvents as ProviderEvents2,
+  ProviderStatus,
+  StandardResolutionReasons
+} from "@openfeature/web-sdk";
 import { useEffect, useState } from "react";
 
-// src/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/use-feature-flag.ts
-var DEFAULT_OPTIONS = {
-  updateOnContextChanged: true,
-  updateOnConfigurationChanged: true,
-  suspendUntilReady: true,
-  suspendWhileReconciling: false
-};
+// src/evaluation/use-feature-flag.ts
+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;
+}
 function useBooleanFlagValue(flagKey, defaultValue, options) {
   return useBooleanFlagDetails(flagKey, defaultValue, options).value;
 }
 function useBooleanFlagDetails(flagKey, defaultValue, options) {
-  return attachHandlersAndResolve(flagKey, defaultValue, (client) => {
-    return client.getBooleanDetails;
-  }, options);
+  return attachHandlersAndResolve(
+    flagKey,
+    defaultValue,
+    (client) => {
+      return client.getBooleanDetails;
+    },
+    options
+  );
 }
 function useStringFlagValue(flagKey, defaultValue, options) {
   return useStringFlagDetails(flagKey, defaultValue, options).value;
 }
 function useStringFlagDetails(flagKey, defaultValue, options) {
-  return attachHandlersAndResolve(flagKey, defaultValue, (client) => {
-    return client.getStringDetails;
-  }, options);
+  return attachHandlersAndResolve(
+    flagKey,
+    defaultValue,
+    (client) => {
+      return client.getStringDetails;
+    },
+    options
+  );
 }
 function useNumberFlagValue(flagKey, defaultValue, options) {
   return useNumberFlagDetails(flagKey, defaultValue, options).value;
 }
 function useNumberFlagDetails(flagKey, defaultValue, options) {
-  return attachHandlersAndResolve(flagKey, defaultValue, (client) => {
-    return client.getNumberDetails;
-  }, options);
+  return attachHandlersAndResolve(
+    flagKey,
+    defaultValue,
+    (client) => {
+      return client.getNumberDetails;
+    },
+    options
+  );
 }
 function useObjectFlagValue(flagKey, defaultValue, options) {
   return useObjectFlagDetails(flagKey, defaultValue, options).value;
 }
 function useObjectFlagDetails(flagKey, defaultValue, options) {
-  return attachHandlersAndResolve(flagKey, defaultValue, (client) => {
-    return client.getObjectDetails;
-  }, options);
+  return attachHandlersAndResolve(
+    flagKey,
+    defaultValue,
+    (client) => {
+      return client.getObjectDetails;
+    },
+    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 = () => {
     updateState({});
   };
   const suspendRef = () => {
-    suspend(client, updateState, ProviderEvents.ContextChanged, ProviderEvents.ConfigurationChanged, ProviderEvents.Ready);
+    suspend(
+      client,
+      updateState,
+      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));
+var HookFlagQuery = class {
+  constructor(_details) {
+    this._details = _details;
+  }
+  get details() {
+    return this._details;
+  }
+  get value() {
+    return this._details?.value;
+  }
+  get variant() {
+    return this._details.variant;
+  }
+  get flagMetadata() {
+    return this._details.flagMetadata;
+  }
+  get reason() {
+    return this._details.reason;
+  }
+  get isError() {
+    return !!this._details?.errorCode || this._details.reason == StandardResolutionReasons.ERROR;
+  }
+  get errorCode() {
+    return this._details?.errorCode;
+  }
+  get errorMessage() {
+    return this._details?.errorMessage;
+  }
+  get isAuthoritative() {
+    return !this.isError && this._details.reason != StandardResolutionReasons.STALE && this._details.reason != StandardResolutionReasons.DISABLED;
+  }
+  get type() {
+    return typeof this._details.value;
+  }
+};
+
+// 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);
 }
-function suspenseWrapper(promise) {
-  let status = 0 /* Pending */;
-  let result;
-  const suspended = promise.then(
-    (value) => {
-      status = 1 /* Success */;
-      result = value;
-    },
-    (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/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
@@ -150,12 +258,14 @@ export {
   OpenFeatureProvider,
   useBooleanFlagDetails,
   useBooleanFlagValue,
+  useFlag,
   useNumberFlagDetails,
   useNumberFlagValue,
   useObjectFlagDetails,
   useObjectFlagValue,
   useOpenFeatureClient,
   useStringFlagDetails,
-  useStringFlagValue
+  useStringFlagValue,
+  useWhenProviderReady
 };
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/use-feature-flag.ts", "../../src/provider.tsx", "../../src/index.ts"],
-  "sourcesContent": ["import { Client, EvaluationDetails, FlagEvaluationOptions, FlagValue, JsonValue, ProviderEvents, ProviderStatus } from '@openfeature/web-sdk';\nimport { Dispatch, SetStateAction, useEffect, useState } from 'react';\nimport { useOpenFeatureClient } from './provider';\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/**\n * Evaluates a feature flag, returning a boolean.\n * By default, components will re-render when the flag value changes.\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(flagKey: string, defaultValue: boolean, options?: ReactFlagEvaluationOptions): 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 * @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(flagKey: string, defaultValue: boolean, options?: ReactFlagEvaluationOptions): EvaluationDetails<boolean> {\n  return attachHandlersAndResolve(flagKey, defaultValue, (client) => {\n    return client.getBooleanDetails;\n  },  options);\n}\n\n/**\n * Evaluates a feature flag, returning a string.\n * By default, components will re-render when the flag value changes.\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>(flagKey: string, defaultValue: T, options?: ReactFlagEvaluationOptions): T {\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 * @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>(flagKey: string, defaultValue: T, options?: ReactFlagEvaluationOptions): EvaluationDetails<T> {\n  return attachHandlersAndResolve(flagKey, defaultValue, (client) => {\n    return client.getStringDetails<T>;\n  },  options);\n}\n\n/**\n * Evaluates a feature flag, returning a number.\n * By default, components will re-render when the flag value changes.\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>(flagKey: string, defaultValue: T, options?: ReactFlagEvaluationOptions): T {\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 * @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>(flagKey: string, defaultValue: T, options?: ReactFlagEvaluationOptions): EvaluationDetails<T> {\n  return attachHandlersAndResolve(flagKey, defaultValue, (client) => {\n    return client.getNumberDetails<T>;\n  },  options);\n}\n\n/**\n * Evaluates a feature flag, returning an object.\n * By default, components will re-render when the flag value changes.\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>(flagKey: string, defaultValue: T, options?: ReactFlagEvaluationOptions): 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 * @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>(flagKey: string, defaultValue: T, options?: ReactFlagEvaluationOptions): EvaluationDetails<T> {\n  return attachHandlersAndResolve(flagKey, defaultValue, (client) => {\n    return client.getObjectDetails<T>;\n  },  options);\n}\n\nfunction attachHandlersAndResolve<T extends FlagValue>(flagKey: string, defaultValue: T, resolver: (client: Client) => (flagKey: string, defaultValue: T) => EvaluationDetails<T>, options?: ReactFlagEvaluationOptions): 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(client, updateState, ProviderEvents.ContextChanged, ProviderEvents.ConfigurationChanged, ProviderEvents.Ready);\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(client: Client, updateState: Dispatch<SetStateAction<object | undefined>>, ...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.then(\n    (value) => {\n      status = SuspendState.Success;\n      result = value;\n    },\n    (error) => {\n      status = SuspendState.Error;\n      result = error;\n    }\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};", "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 './use-feature-flag';\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"]
 }