npm - @openfeature/server-sdk - Versions diffs - 1.12.0 → 1.13.0 - Mend

@openfeature/server-sdk 1.12.0 → 1.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/README.md CHANGED Viewed

@@ -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/server-sdk-v1.12.0">
-    <img alt="Release" src="https://img.shields.io/static/v1?label=release&message=v1.12.0&color=blue&style=for-the-badge" />
+  <a href="https://github.com/open-feature/js-sdk/releases/tag/server-sdk-v1.13.0">
+    <img alt="Release" src="https://img.shields.io/static/v1?label=release&message=v1.13.0&color=blue&style=for-the-badge" />
   </a>
   <!-- x-release-please-end -->
   <br/>
@@ -86,16 +86,17 @@ See [here](https://open-feature.github.io/js-sdk/modules/_openfeature_server_sdk
 ## 🌟 Features
-| Status | Features                | Description                                                                                                                        |
-| ------ | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
-| ✅      | [Providers](#providers) | Integrate with a commercial, open source, or in-house feature management tool.                                                     |
-| ✅      | [Targeting](#targeting) | Contextually-aware flag evaluation using [evaluation context](https://openfeature.dev/docs/reference/concepts/evaluation-context). |
-| ✅      | [Hooks](#hooks)         | Add functionality to various stages of the flag evaluation life-cycle.                                                             |
-| ✅      | [Logging](#logging)     | Integrate with popular logging packages.                                                                                           |
-| ✅      | [Domains](#domains)     | Logically bind clients with providers.                                                                                             |
-| ✅      | [Eventing](#eventing)   | React to state changes in the provider or flag management system.                                                                  |
-| ✅      | [Shutdown](#shutdown)   | Gracefully clean up a provider during application shutdown.                                                                        |
-| ✅      | [Extending](#extending) | Extend OpenFeature with custom providers and hooks.                                                                                |
+| Status | Features                                                            | Description                                                                                                                                                  |
+|--------|---------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| ✅      | [Providers](#providers)                                             | Integrate with a commercial, open source, or in-house feature management tool.                                                                               |
+| ✅      | [Targeting](#targeting)                                             | Contextually-aware flag evaluation using [evaluation context](https://openfeature.dev/docs/reference/concepts/evaluation-context).                           |
+| ✅      | [Hooks](#hooks)                                                     | Add functionality to various stages of the flag evaluation life-cycle.                                                                                       |
+| ✅      | [Logging](#logging)                                                 | Integrate with popular logging packages.                                                                                                                     |
+| ✅      | [Domains](#domains)                                                 | Logically bind clients with providers.                                                                                                                       |
+| ✅      | [Eventing](#eventing)                                               | React to state changes in the provider or flag management system.                                                                                            |
+| ✅      | [Shutdown](#shutdown)                                               | Gracefully clean up a provider during application shutdown.                                                                                                  |
+| ✅      | [Transaction Context Propagation](#transaction-context-propagation) | Set a specific [evaluation context](https://openfeature.dev/docs/reference/concepts/evaluation-context) for a transaction (e.g. an HTTP request or a thread) |                                                                                                                               |
+| ✅      | [Extending](#extending)                                             | Extend OpenFeature with custom providers and hooks.                                                                                                          |
 <sub>Implemented: ✅ | In-progress: ⚠️ | Not implemented yet: ❌</sub>
@@ -113,7 +114,7 @@ To register a provider and ensure it is ready before further actions are taken,
 ```ts
 await OpenFeature.setProviderAndWait(new MyProvider());
-```
+```
 #### Synchronous
@@ -186,7 +187,7 @@ import type { Logger } from "@openfeature/server-sdk";
 // The logger can be anything that conforms with the Logger interface
 const logger: Logger = console;
-// Sets a global logger
+// Sets a global logger
 OpenFeature.setLogger(logger);
 // Sets a client logger
@@ -251,6 +252,32 @@ client.addHandler(ProviderEvents.Error, (eventDetails) => {
 });
 ```
+### Transaction Context Propagation
+Transaction context is a container for transaction-specific evaluation context (e.g. user id, user agent, IP).
+Transaction context can be set where specific data is available (e.g. an auth service or request handler) and by using the transaction context propagator it will automatically be applied to all flag evaluations within a transaction (e.g. a request or thread).
+The following example shows an Express middleware using transaction context propagation to propagate the request ip and user id into request scoped transaction context.
+```ts
+import express, { Request, Response, NextFunction } from "express";
+import { OpenFeature, AsyncLocalStorageTransactionContextPropagator } from '@openfeature/server-sdk';
+OpenFeature.setTransactionContextPropagator(new AsyncLocalStorageTransactionContextPropagator())
+/**
+ * This example is based on an express middleware.
+ */
+const app = express();
+app.use((req: Request, res: Response, next: NextFunction) => {
+  const ip = res.headers.get("X-Forwarded-For")
+  OpenFeature.setTransactionContext({ targetingKey: req.user.id, ipAddress: ip }, () => {
+    // The transaction context is used in any flag evaluation throughout the whole call chain of next
+    next();
+  });
+})
+```
 ### Shutdown
 The OpenFeature API provides a close function to perform a cleanup of all registered providers.
@@ -279,7 +306,6 @@ import {
   Logger,
   Provider,
   ProviderEventEmitter,
-  ProviderStatus,
   ResolutionDetails
 } from '@openfeature/server-sdk';
@@ -305,10 +331,8 @@ class MyProvider implements Provider {
     // code to evaluate an object
   }
-  status?: ProviderStatus | undefined;
   // implement with "new OpenFeatureEventEmitter()", and use "emit()" to emit events
-  events?: ProviderEventEmitter<AnyProviderEvent> | undefined;
+  events?: ProviderEventEmitter<AnyProviderEvent> | undefined;
   initialize?(context?: EvaluationContext | undefined): Promise<void> {
     // code to initialize your provider

package/dist/cjs/index.js CHANGED Viewed

@@ -1,9 +1,7 @@
 "use strict";
-var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -18,19 +16,12 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  AsyncLocalStorageTransactionContextPropagator: () => AsyncLocalStorageTransactionContextPropagator,
   InMemoryProvider: () => InMemoryProvider,
   NOOP_PROVIDER: () => NOOP_PROVIDER,
   NOOP_TRANSACTION_CONTEXT_PROPAGATOR: () => NOOP_TRANSACTION_CONTEXT_PROPAGATOR,
@@ -38,23 +29,42 @@ __export(src_exports, {
   OpenFeatureAPI: () => OpenFeatureAPI,
   OpenFeatureClient: () => OpenFeatureClient,
   OpenFeatureEventEmitter: () => OpenFeatureEventEmitter,
-  ProviderEvents: () => import_core5.ServerProviderEvents
+  ProviderEvents: () => import_core2.ServerProviderEvents,
+  ProviderStatus: () => import_core3.ServerProviderStatus
 });
 module.exports = __toCommonJS(src_exports);
 // src/client/open-feature-client.ts
 var import_core7 = require("@openfeature/core");
-// src/provider/no-op-provider.ts
+// src/open-feature.ts
+var import_core6 = require("@openfeature/core");
+// src/events/open-feature-event-emitter.ts
 var import_core = require("@openfeature/core");
+var import_node_events = require("events");
+var OpenFeatureEventEmitter = class extends import_core.GenericEventEmitter {
+  eventEmitter = new import_node_events.EventEmitter({ captureRejections: true });
+  constructor() {
+    super();
+    this.eventEmitter.on("error", (err) => {
+      this._logger?.error("Error running event handler:", err);
+    });
+  }
+};
+// src/events/events.ts
+var import_core2 = require("@openfeature/core");
+// src/provider/provider.ts
+var import_core3 = require("@openfeature/core");
+// src/provider/no-op-provider.ts
 var REASON_NO_OP = "No-op";
 var NoopFeatureProvider = class {
   metadata = {
     name: "No-op Provider"
   };
-  get status() {
-    return import_core.ProviderStatus.NOT_READY;
-  }
   resolveBooleanEvaluation(_, defaultValue) {
     return this.noOp(defaultValue);
   }
@@ -77,17 +87,17 @@ var NoopFeatureProvider = class {
 var NOOP_PROVIDER = new NoopFeatureProvider();
 // src/provider/in-memory-provider/in-memory-provider.ts
-var import_core3 = require("@openfeature/core");
+var import_core5 = require("@openfeature/core");
 // src/provider/in-memory-provider/variant-not-found-error.ts
-var import_core2 = require("@openfeature/core");
-var VariantFoundError = class _VariantFoundError extends import_core2.OpenFeatureError {
+var import_core4 = require("@openfeature/core");
+var VariantFoundError = class _VariantFoundError extends import_core4.OpenFeatureError {
   code;
   constructor(message) {
     super(message);
     Object.setPrototypeOf(this, _VariantFoundError.prototype);
     this.name = "VariantFoundError";
-    this.code = import_core2.ErrorCode.GENERAL;
+    this.code = import_core4.ErrorCode.GENERAL;
   }
 };
@@ -109,7 +119,7 @@ var InMemoryProvider = class {
   putConfiguration(flagConfiguration) {
     const flagsChanged = Object.entries(flagConfiguration).filter(([key, value]) => this._flagConfiguration[key] !== value).map(([key]) => key);
     this._flagConfiguration = { ...flagConfiguration };
-    this.events.emit(import_core5.ServerProviderEvents.ConfigurationChanged, { flagsChanged });
+    this.events.emit(import_core2.ServerProviderEvents.ConfigurationChanged, { flagsChanged });
   }
   resolveBooleanEvaluation(flagKey, defaultValue, context, logger) {
     return this.resolveFlagWithReason(flagKey, defaultValue, context, logger);
@@ -127,12 +137,12 @@ var InMemoryProvider = class {
     try {
       const resolutionResult = this.lookupFlagValue(flagKey, defaultValue, ctx, logger);
       if (typeof resolutionResult?.value != typeof defaultValue) {
-        throw new import_core3.TypeMismatchError();
+        throw new import_core5.TypeMismatchError();
       }
       return resolutionResult;
     } catch (error) {
-      if (!(error instanceof import_core3.OpenFeatureError)) {
-        throw new import_core3.GeneralError(error?.message || "unknown error");
+      if (!(error instanceof import_core5.OpenFeatureError)) {
+        throw new import_core5.GeneralError(error?.message || "unknown error");
       }
       throw error;
     }
@@ -141,11 +151,11 @@ var InMemoryProvider = class {
     if (!(flagKey in this._flagConfiguration)) {
       const message = `no flag found with key ${flagKey}`;
       logger?.debug(message);
-      throw new import_core3.FlagNotFoundError(message);
+      throw new import_core5.FlagNotFoundError(message);
     }
     const flagSpec = this._flagConfiguration[flagKey];
     if (flagSpec.disabled) {
-      return { value: defaultValue, reason: import_core3.StandardResolutionReasons.DISABLED };
+      return { value: defaultValue, reason: import_core5.StandardResolutionReasons.DISABLED };
     }
     const isContextEval = ctx && flagSpec?.contextEvaluator;
     const variant = isContextEval ? flagSpec.contextEvaluator?.(ctx) : flagSpec.defaultVariant;
@@ -158,47 +168,42 @@ var InMemoryProvider = class {
     return {
       value,
       ...variant && { variant },
-      reason: isContextEval ? import_core3.StandardResolutionReasons.TARGETING_MATCH : import_core3.StandardResolutionReasons.STATIC
+      reason: isContextEval ? import_core5.StandardResolutionReasons.TARGETING_MATCH : import_core5.StandardResolutionReasons.STATIC
     };
   }
 };
-// src/open-feature.ts
-var import_core6 = require("@openfeature/core");
 // src/transaction-context/no-op-transaction-context-propagator.ts
 var NoopTransactionContextPropagator = class {
   getTransactionContext() {
     return {};
   }
-  setTransactionContext(_, callback) {
-    callback();
+  setTransactionContext(_, callback, ...args) {
+    callback(...args);
   }
 };
 var NOOP_TRANSACTION_CONTEXT_PROPAGATOR = new NoopTransactionContextPropagator();
-// src/events/open-feature-event-emitter.ts
-var import_core4 = require("@openfeature/core");
-var import_events = __toESM(require("events"));
-var OpenFeatureEventEmitter = class extends import_core4.GenericEventEmitter {
-  eventEmitter = new import_events.default({ captureRejections: true });
-  constructor() {
-    super();
-    this.eventEmitter.on("error", (err) => {
-      this._logger?.error("Error running event handler:", err);
-    });
+// src/transaction-context/async-local-storage-transaction-context-propagator.ts
+var import_async_hooks = require("async_hooks");
+var AsyncLocalStorageTransactionContextPropagator = class {
+  asyncLocalStorage = new import_async_hooks.AsyncLocalStorage();
+  getTransactionContext() {
+    return this.asyncLocalStorage.getStore() ?? {};
+  }
+  setTransactionContext(transactionContext, callback, ...args) {
+    this.asyncLocalStorage.run(transactionContext, callback, ...args);
   }
 };
-// src/events/events.ts
-var import_core5 = require("@openfeature/core");
 // src/open-feature.ts
 var GLOBAL_OPENFEATURE_API_KEY = Symbol.for("@openfeature/js-sdk/api");
 var _globalThis = globalThis;
 var OpenFeatureAPI = class _OpenFeatureAPI extends import_core6.OpenFeatureCommonAPI {
-  _events = new OpenFeatureEventEmitter();
-  _defaultProvider = NOOP_PROVIDER;
+  _statusEnumType = import_core3.ServerProviderStatus;
+  _apiEmitter = new OpenFeatureEventEmitter();
+  _defaultProvider = new import_core6.ProviderWrapper(NOOP_PROVIDER, import_core3.ServerProviderStatus.NOT_READY, this._statusEnumType);
+  _domainScopedProviders = /* @__PURE__ */ new Map();
   _createEventEmitter = () => new OpenFeatureEventEmitter();
   _transactionContextPropagator = NOOP_TRANSACTION_CONTEXT_PROPAGATOR;
   constructor() {
@@ -218,6 +223,12 @@ var OpenFeatureAPI = class _OpenFeatureAPI extends import_core6.OpenFeatureCommo
     _globalThis[GLOBAL_OPENFEATURE_API_KEY] = instance;
     return instance;
   }
+  getProviderStatus(domain) {
+    if (!domain) {
+      return this._defaultProvider.status;
+    }
+    return this._domainScopedProviders.get(domain)?.status ?? this._defaultProvider.status;
+  }
   setContext(context) {
     this._context = context;
     return this;
@@ -231,6 +242,7 @@ var OpenFeatureAPI = class _OpenFeatureAPI extends import_core6.OpenFeatureCommo
     const context = (0, import_core6.objectOrUndefined)(domainOrContext) ?? (0, import_core6.objectOrUndefined)(versionOrContext) ?? (0, import_core6.objectOrUndefined)(contextOrUndefined);
     return new OpenFeatureClient(
       () => this.getProviderForClient(domain),
+      () => this.getProviderStatus(domain),
       () => this.buildAndCacheEventEmitterForClient(domain),
       () => this._logger,
       { domain, version },
@@ -273,8 +285,9 @@ var OpenFeature = OpenFeatureAPI.getInstance();
 // src/client/open-feature-client.ts
 var OpenFeatureClient = class {
-  constructor(providerAccessor, emitterAccessor, globalLogger, options, context = {}) {
+  constructor(providerAccessor, providerStatusAccessor, emitterAccessor, globalLogger, options, context = {}) {
     this.providerAccessor = providerAccessor;
+    this.providerStatusAccessor = providerStatusAccessor;
     this.emitterAccessor = emitterAccessor;
     this.globalLogger = globalLogger;
     this.options = options;
@@ -292,9 +305,12 @@ var OpenFeatureClient = class {
       providerMetadata: this.providerAccessor().metadata
     };
   }
+  get providerStatus() {
+    return this.providerStatusAccessor();
+  }
   addHandler(eventType, handler) {
     this.emitterAccessor().addHandler(eventType, handler);
-    const shouldRunNow = (0, import_core7.statusMatchesEvent)(eventType, this._provider.status);
+    const shouldRunNow = (0, import_core7.statusMatchesEvent)(eventType, this._providerStatus);
     if (shouldRunNow) {
       try {
         handler({
@@ -407,6 +423,11 @@ var OpenFeatureClient = class {
     };
     try {
       const frozenContext = await this.beforeHooks(allHooks, hookContext, options);
+      if (this.providerStatus === import_core3.ServerProviderStatus.NOT_READY) {
+        throw new import_core7.ProviderNotReadyError("provider has not yet initialized");
+      } else if (this.providerStatus === import_core3.ServerProviderStatus.FATAL) {
+        throw new import_core7.ProviderFatalError("provider is in an irrecoverable error state");
+      }
       const resolution = await resolver.call(this._provider, flagKey, defaultValue, frozenContext, this._logger);
       const evaluationDetails = {
         ...resolution,
@@ -475,6 +496,9 @@ var OpenFeatureClient = class {
   get _provider() {
     return this.providerAccessor();
   }
+  get _providerStatus() {
+    return this.providerStatusAccessor();
+  }
   get _logger() {
     return this._clientLogger || this.globalLogger();
   }
@@ -484,6 +508,7 @@ var OpenFeatureClient = class {
 __reExport(src_exports, require("@openfeature/core"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AsyncLocalStorageTransactionContextPropagator,
   InMemoryProvider,
   NOOP_PROVIDER,
   NOOP_TRANSACTION_CONTEXT_PROPAGATOR,
@@ -492,6 +517,7 @@ __reExport(src_exports, require("@openfeature/core"), module.exports);
   OpenFeatureClient,
   OpenFeatureEventEmitter,
   ProviderEvents,
+  ProviderStatus,
   ...require("@openfeature/core")
 });
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/index.ts", "../../src/client/open-feature-client.ts", "../../src/provider/no-op-provider.ts", "../../src/provider/in-memory-provider/in-memory-provider.ts", "../../src/provider/in-memory-provider/variant-not-found-error.ts", "../../src/open-feature.ts", "../../src/transaction-context/no-op-transaction-context-propagator.ts", "../../src/events/open-feature-event-emitter.ts", "../../src/events/events.ts"],
-  "sourcesContent": ["export * from './client';\nexport * from './provider';\nexport * from './evaluation';\nexport * from './open-feature';\nexport * from './transaction-context';\nexport * from './events';\nexport * from './hooks';\nexport * from '@openfeature/core';\n", "import {\n  ClientMetadata,\n  ErrorCode,\n  EvaluationContext,\n  EvaluationDetails,\n  EventHandler,\n  FlagValue,\n  FlagValueType,\n  HookContext,\n  JsonValue,\n  Logger,\n  ManageContext,\n  OpenFeatureError,\n  ResolutionDetails,\n  SafeLogger,\n  StandardResolutionReasons,\n  statusMatchesEvent,\n} from '@openfeature/core';\nimport { FlagEvaluationOptions } from '../evaluation';\nimport { ProviderEvents } from '../events';\nimport { InternalEventEmitter } from '../events/internal/internal-event-emitter';\nimport { Hook } from '../hooks';\nimport { OpenFeature } from '../open-feature';\nimport { Provider } from '../provider';\nimport { Client } from './client';\n\ntype OpenFeatureClientOptions = {\n  /**\n   * @deprecated Use `domain` instead.\n   */\n  name?: string;\n  domain?: string;\n  version?: string;\n};\n\nexport class OpenFeatureClient implements Client, ManageContext<OpenFeatureClient> {\n  private _context: EvaluationContext;\n  private _hooks: Hook[] = [];\n  private _clientLogger?: Logger;\n\n  constructor(\n    // we always want the client to use the current provider,\n    // so pass a function to always access the currently registered one.\n    private readonly providerAccessor: () => Provider,\n    private readonly emitterAccessor: () => InternalEventEmitter,\n    private readonly globalLogger: () => Logger,\n    private readonly options: OpenFeatureClientOptions,\n    context: EvaluationContext = {},\n  ) {\n    this._context = context;\n  }\n\n  get metadata(): ClientMetadata {\n    return {\n      // Use domain if name is not provided\n      name: this.options.domain ?? this.options.name,\n      domain: this.options.domain ?? this.options.name,\n      version: this.options.version,\n      providerMetadata: this.providerAccessor().metadata,\n    };\n  }\n\n  addHandler(eventType: ProviderEvents, handler: EventHandler): void {\n    this.emitterAccessor().addHandler(eventType, handler);\n    const shouldRunNow = statusMatchesEvent(eventType, this._provider.status);\n\n    if (shouldRunNow) {\n      // run immediately, we're in the matching state\n      try {\n        handler({\n          clientName: this.metadata.name,\n          domain: this.metadata.domain,\n          providerName: this._provider.metadata.name,\n        });\n      } catch (err) {\n        this._logger?.error('Error running event handler:', err);\n      }\n    }\n  }\n\n  removeHandler(eventType: ProviderEvents, handler: EventHandler) {\n    this.emitterAccessor().removeHandler(eventType, handler);\n  }\n\n  getHandlers(eventType: ProviderEvents) {\n    return this.emitterAccessor().getHandlers(eventType);\n  }\n\n  setLogger(logger: Logger): OpenFeatureClient {\n    this._clientLogger = new SafeLogger(logger);\n    return this;\n  }\n\n  setContext(context: EvaluationContext): OpenFeatureClient {\n    this._context = context;\n    return this;\n  }\n\n  getContext(): EvaluationContext {\n    return this._context;\n  }\n\n  addHooks(...hooks: Hook[]): OpenFeatureClient {\n    this._hooks = [...this._hooks, ...hooks];\n    return this;\n  }\n\n  getHooks(): Hook[] {\n    return this._hooks;\n  }\n\n  clearHooks(): OpenFeatureClient {\n    this._hooks = [];\n    return this;\n  }\n\n  async getBooleanValue(\n    flagKey: string,\n    defaultValue: boolean,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<boolean> {\n    return (await this.getBooleanDetails(flagKey, defaultValue, context, options)).value;\n  }\n\n  getBooleanDetails(\n    flagKey: string,\n    defaultValue: boolean,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<EvaluationDetails<boolean>> {\n    return this.evaluate<boolean>(\n      flagKey,\n      this._provider.resolveBooleanEvaluation,\n      defaultValue,\n      'boolean',\n      context,\n      options,\n    );\n  }\n\n  async getStringValue<T extends string = string>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<T> {\n    return (await this.getStringDetails<T>(flagKey, defaultValue, context, options)).value;\n  }\n\n  getStringDetails<T extends string = string>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<EvaluationDetails<T>> {\n    return this.evaluate<T>(\n      flagKey,\n      // this isolates providers from our restricted string generic argument.\n      this._provider.resolveStringEvaluation as () => Promise<EvaluationDetails<T>>,\n      defaultValue,\n      'string',\n      context,\n      options,\n    );\n  }\n\n  async getNumberValue<T extends number = number>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<T> {\n    return (await this.getNumberDetails(flagKey, defaultValue, context, options)).value;\n  }\n\n  getNumberDetails<T extends number = number>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<EvaluationDetails<T>> {\n    return this.evaluate<T>(\n      flagKey,\n      // this isolates providers from our restricted number generic argument.\n      this._provider.resolveNumberEvaluation as () => Promise<EvaluationDetails<T>>,\n      defaultValue,\n      'number',\n      context,\n      options,\n    );\n  }\n\n  async getObjectValue<T extends JsonValue = JsonValue>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<T> {\n    return (await this.getObjectDetails(flagKey, defaultValue, context, options)).value;\n  }\n\n  getObjectDetails<T extends JsonValue = JsonValue>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<EvaluationDetails<T>> {\n    return this.evaluate<T>(flagKey, this._provider.resolveObjectEvaluation, defaultValue, 'object', context, options);\n  }\n\n  private async evaluate<T extends FlagValue>(\n    flagKey: string,\n    resolver: (\n      flagKey: string,\n      defaultValue: T,\n      context: EvaluationContext,\n      logger: Logger,\n    ) => Promise<ResolutionDetails<T>>,\n    defaultValue: T,\n    flagType: FlagValueType,\n    invocationContext: EvaluationContext = {},\n    options: FlagEvaluationOptions = {},\n  ): Promise<EvaluationDetails<T>> {\n    // merge global, client, and evaluation context\n\n    const allHooks = [\n      ...OpenFeature.getHooks(),\n      ...this.getHooks(),\n      ...(options.hooks || []),\n      ...(this._provider.hooks || []),\n    ];\n    const allHooksReversed = [...allHooks].reverse();\n\n    // merge global and client contexts\n    const mergedContext = {\n      ...OpenFeature.getContext(),\n      ...OpenFeature.getTransactionContext(),\n      ...this._context,\n      ...invocationContext,\n    };\n\n    // this reference cannot change during the course of evaluation\n    // it may be used as a key in WeakMaps\n    const hookContext: Readonly<HookContext> = {\n      flagKey,\n      defaultValue,\n      flagValueType: flagType,\n      clientMetadata: this.metadata,\n      providerMetadata: OpenFeature.providerMetadata,\n      context: mergedContext,\n      logger: this._logger,\n    };\n\n    try {\n      const frozenContext = await this.beforeHooks(allHooks, hookContext, options);\n\n      // run the referenced resolver, binding the provider.\n      const resolution = await resolver.call(this._provider, flagKey, defaultValue, frozenContext, this._logger);\n\n      const evaluationDetails = {\n        ...resolution,\n        flagMetadata: Object.freeze(resolution.flagMetadata ?? {}),\n        flagKey,\n      };\n\n      await this.afterHooks(allHooksReversed, hookContext, evaluationDetails, options);\n\n      return evaluationDetails;\n    } catch (err: unknown) {\n      const errorMessage: string = (err as Error)?.message;\n      const errorCode: ErrorCode = (err as OpenFeatureError)?.code || ErrorCode.GENERAL;\n\n      await this.errorHooks(allHooksReversed, hookContext, err, options);\n\n      return {\n        errorCode,\n        errorMessage,\n        value: defaultValue,\n        reason: StandardResolutionReasons.ERROR,\n        flagMetadata: Object.freeze({}),\n        flagKey,\n      };\n    } finally {\n      await this.finallyHooks(allHooksReversed, hookContext, options);\n    }\n  }\n\n  private async beforeHooks(hooks: Hook[], hookContext: HookContext, options: FlagEvaluationOptions) {\n    for (const hook of hooks) {\n      // freeze the hookContext\n      Object.freeze(hookContext);\n\n      // use Object.assign to avoid modification of frozen hookContext\n      Object.assign(hookContext.context, {\n        ...hookContext.context,\n        ...(await hook?.before?.(hookContext, Object.freeze(options.hookHints))),\n      });\n    }\n\n    // after before hooks, freeze the EvaluationContext.\n    return Object.freeze(hookContext.context);\n  }\n\n  private async afterHooks(\n    hooks: Hook[],\n    hookContext: HookContext,\n    evaluationDetails: EvaluationDetails<FlagValue>,\n    options: FlagEvaluationOptions,\n  ) {\n    // run \"after\" hooks sequentially\n    for (const hook of hooks) {\n      await hook?.after?.(hookContext, evaluationDetails, options.hookHints);\n    }\n  }\n\n  private async errorHooks(hooks: Hook[], hookContext: HookContext, err: unknown, options: FlagEvaluationOptions) {\n    // run \"error\" hooks sequentially\n    for (const hook of hooks) {\n      try {\n        await hook?.error?.(hookContext, err, options.hookHints);\n      } catch (err) {\n        this._logger.error(`Unhandled error during 'error' hook: ${err}`);\n        if (err instanceof Error) {\n          this._logger.error(err.stack);\n        }\n        this._logger.error((err as Error)?.stack);\n      }\n    }\n  }\n\n  private async finallyHooks(hooks: Hook[], hookContext: HookContext, options: FlagEvaluationOptions) {\n    // run \"finally\" hooks sequentially\n    for (const hook of hooks) {\n      try {\n        await hook?.finally?.(hookContext, options.hookHints);\n      } catch (err) {\n        this._logger.error(`Unhandled error during 'finally' hook: ${err}`);\n        if (err instanceof Error) {\n          this._logger.error(err.stack);\n        }\n        this._logger.error((err as Error)?.stack);\n      }\n    }\n  }\n\n  private get _provider(): Provider {\n    return this.providerAccessor();\n  }\n\n  private get _logger() {\n    return this._clientLogger || this.globalLogger();\n  }\n}\n", "import { ResolutionDetails, JsonValue, ProviderStatus } from '@openfeature/core';\nimport { Provider } from './provider';\n\nconst REASON_NO_OP = 'No-op';\n\n/**\n * The No-op provider is set by default, and simply always returns the default value.\n */\nclass NoopFeatureProvider implements Provider {\n  readonly metadata = {\n    name: 'No-op Provider',\n  } as const;\n\n  get status(): ProviderStatus {\n    /**\n     * This is due to the NoopProvider not being a real provider.\n     * We do not want it to trigger the Ready event handlers, so we never set this to ready.\n     * With the NoopProvider assigned, the client can be assumed to be uninitialized.\n     * https://github.com/open-feature/js-sdk/pull/429#discussion_r1202642654\n     */\n    return ProviderStatus.NOT_READY;\n  }\n\n  resolveBooleanEvaluation(_: string, defaultValue: boolean): Promise<ResolutionDetails<boolean>> {\n    return this.noOp(defaultValue);\n  }\n\n  resolveStringEvaluation(_: string, defaultValue: string): Promise<ResolutionDetails<string>> {\n    return this.noOp(defaultValue);\n  }\n\n  resolveNumberEvaluation(_: string, defaultValue: number): Promise<ResolutionDetails<number>> {\n    return this.noOp(defaultValue);\n  }\n\n  resolveObjectEvaluation<T extends JsonValue>(_: string, defaultValue: T): Promise<ResolutionDetails<T>> {\n    return this.noOp<T>(defaultValue);\n  }\n\n  private noOp<T>(defaultValue: T) {\n    return Promise.resolve({\n      value: defaultValue,\n      reason: REASON_NO_OP,\n    });\n  }\n}\n\nexport const NOOP_PROVIDER = new NoopFeatureProvider();\n", "import {\n  EvaluationContext,\n  FlagNotFoundError,\n  FlagValueType,\n  GeneralError,\n  JsonValue,\n  Logger,\n  OpenFeatureError,\n  ResolutionDetails,\n  StandardResolutionReasons,\n  TypeMismatchError\n} from '@openfeature/core';\nimport { Provider } from '../provider';\nimport { Flag, FlagConfiguration } from './flag-configuration';\nimport { VariantFoundError } from './variant-not-found-error';\nimport { OpenFeatureEventEmitter, ProviderEvents } from '../..';\n\n/**\n * A simple OpenFeature provider intended for demos and as a test stub.\n */\nexport class InMemoryProvider implements Provider {\n  public readonly events = new OpenFeatureEventEmitter();\n  public readonly runsOn = 'server';\n  readonly metadata = {\n    name: 'in-memory',\n  } as const;\n  private _flagConfiguration: FlagConfiguration;\n\n  constructor(flagConfiguration: FlagConfiguration = {}) {\n    this._flagConfiguration = { ...flagConfiguration };\n  }\n\n  /**\n   * Overwrites the configured flags.\n   * @param { FlagConfiguration } flagConfiguration new flag configuration\n   */\n  putConfiguration(flagConfiguration: FlagConfiguration) {\n    const flagsChanged = Object.entries(flagConfiguration)\n      .filter(([key, value]) => this._flagConfiguration[key] !== value)\n      .map(([key]) => key);\n\n    this._flagConfiguration = { ...flagConfiguration };\n    this.events.emit(ProviderEvents.ConfigurationChanged, { flagsChanged });\n  }\n\n  resolveBooleanEvaluation(\n    flagKey: string,\n    defaultValue: boolean,\n    context?: EvaluationContext,\n    logger?: Logger,\n  ): Promise<ResolutionDetails<boolean>> {\n    return this.resolveFlagWithReason<boolean>(flagKey, defaultValue, context, logger);\n  }\n\n  resolveNumberEvaluation(\n    flagKey: string,\n    defaultValue: number,\n    context?: EvaluationContext,\n    logger?: Logger,\n  ): Promise<ResolutionDetails<number>> {\n    return this.resolveFlagWithReason<number>(flagKey, defaultValue, context, logger);\n  }\n\n  async resolveStringEvaluation(\n    flagKey: string,\n    defaultValue: string,\n    context?: EvaluationContext,\n    logger?: Logger,\n  ): Promise<ResolutionDetails<string>> {\n    return this.resolveFlagWithReason<string>(flagKey, defaultValue, context, logger);\n  }\n\n  async resolveObjectEvaluation<T extends JsonValue>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    logger?: Logger,\n  ): Promise<ResolutionDetails<T>> {\n    return this.resolveFlagWithReason<T>(flagKey, defaultValue, context, logger);\n  }\n\n  private async resolveFlagWithReason<T extends JsonValue | FlagValueType>(\n    flagKey: string,\n    defaultValue: T,\n    ctx?: EvaluationContext,\n    logger?: Logger,\n  ): Promise<ResolutionDetails<T>> {\n    try {\n      const resolutionResult = this.lookupFlagValue(flagKey, defaultValue, ctx, logger);\n\n      if (typeof resolutionResult?.value != typeof defaultValue) {\n        throw new TypeMismatchError();\n      }\n\n      return resolutionResult;\n    } catch (error: unknown) {\n      if (!(error instanceof OpenFeatureError)) {\n        throw new GeneralError((error as Error)?.message || 'unknown error'); \n      }\n      throw error;\n    }\n  }\n\n  private lookupFlagValue<T extends JsonValue | FlagValueType>(\n    flagKey: string,\n    defaultValue: T,\n    ctx?: EvaluationContext,\n    logger?: Logger,\n  ): ResolutionDetails<T> {\n    if (!(flagKey in this._flagConfiguration)) {\n      const message = `no flag found with key ${flagKey}`;\n      logger?.debug(message);\n      throw new FlagNotFoundError(message);\n    }\n    const flagSpec: Flag = this._flagConfiguration[flagKey];\n\n    if (flagSpec.disabled) {\n      return { value: defaultValue, reason: StandardResolutionReasons.DISABLED };\n    }\n\n    const isContextEval = ctx && flagSpec?.contextEvaluator;\n    const variant = isContextEval ? flagSpec.contextEvaluator?.(ctx) : flagSpec.defaultVariant;\n\n    const value = variant && flagSpec?.variants[variant];\n\n    if (value === undefined) {\n      const message = `no value associated with variant ${variant}`;\n      logger?.error(message);\n      throw new VariantFoundError(message);\n    }\n\n    return {\n      value: value as T,\n      ...(variant && { variant }),\n      reason: isContextEval ? StandardResolutionReasons.TARGETING_MATCH : StandardResolutionReasons.STATIC,\n    };\n  }\n}\n", "import { ErrorCode, OpenFeatureError } from '@openfeature/core';\n\n/**\n * A custom error for the in-memory provider.\n * Indicates the resolved or default variant doesn't exist.\n */\nexport class VariantFoundError extends OpenFeatureError {\n  code: ErrorCode;\n  constructor(message?: string) {\n    super(message);\n    Object.setPrototypeOf(this, VariantFoundError.prototype);\n    this.name = 'VariantFoundError';\n    this.code = ErrorCode.GENERAL;\n  }\n}\n", "import { NOOP_PROVIDER, Provider } from './provider';\nimport {\n  ManageContext,\n  OpenFeatureCommonAPI,\n  EvaluationContext,\n  objectOrUndefined,\n  stringOrUndefined,\n} from '@openfeature/core';\nimport {\n  ManageTransactionContextPropagator,\n  NOOP_TRANSACTION_CONTEXT_PROPAGATOR,\n  TransactionContext,\n  TransactionContextPropagator,\n} from './transaction-context';\nimport { Client, OpenFeatureClient } from './client';\nimport { OpenFeatureEventEmitter } from './events';\nimport { Hook } from './hooks';\n\n// use a symbol as a key for the global singleton\nconst GLOBAL_OPENFEATURE_API_KEY = Symbol.for('@openfeature/js-sdk/api');\n\ntype OpenFeatureGlobal = {\n  [GLOBAL_OPENFEATURE_API_KEY]?: OpenFeatureAPI;\n};\nconst _globalThis = globalThis as OpenFeatureGlobal;\n\nexport class OpenFeatureAPI\n  extends OpenFeatureCommonAPI<Provider, Hook>\n  implements ManageContext<OpenFeatureAPI>, ManageTransactionContextPropagator<OpenFeatureCommonAPI<Provider>>\n{\n  protected _events = new OpenFeatureEventEmitter();\n  protected _defaultProvider: Provider = NOOP_PROVIDER;\n  protected _createEventEmitter = () => new OpenFeatureEventEmitter();\n\n  private _transactionContextPropagator: TransactionContextPropagator = NOOP_TRANSACTION_CONTEXT_PROPAGATOR;\n\n  private constructor() {\n    super('server');\n  }\n\n  /**\n   * Gets a singleton instance of the OpenFeature API.\n   * @ignore\n   * @returns {OpenFeatureAPI} OpenFeature API\n   */\n  static getInstance(): OpenFeatureAPI {\n    const globalApi = _globalThis[GLOBAL_OPENFEATURE_API_KEY];\n    if (globalApi) {\n      return globalApi;\n    }\n\n    const instance = new OpenFeatureAPI();\n    _globalThis[GLOBAL_OPENFEATURE_API_KEY] = instance;\n    return instance;\n  }\n\n  setContext(context: EvaluationContext): this {\n    this._context = context;\n    return this;\n  }\n\n  getContext(): EvaluationContext {\n    return this._context;\n  }\n\n  /**\n   * A factory function for creating new domainless OpenFeature clients.\n   * Clients can contain their own state (e.g. logger, hook, context).\n   * Multiple clients can be used to segment feature flag configuration.\n   *\n   * All domainless or unbound clients use the default provider set via {@link this.setProvider setProvider}.\n   * @param {EvaluationContext} context Evaluation context that should be set on the client to used during flag evaluations\n   * @returns {Client} OpenFeature Client\n   */\n  getClient(context?: EvaluationContext): Client;\n  /**\n   * A factory function for creating new domain scoped OpenFeature clients.\n   * Clients can contain their own state (e.g. logger, hook, context).\n   * Multiple clients can be used to segment feature flag configuration.\n   *\n   * If there is already a provider bound to this domain via {@link this.setProvider setProvider}, this provider will be used.\n   * Otherwise, the default provider is used until a provider is assigned to that domain.\n   * @param {string} domain An identifier which logically binds clients with providers\n   * @param {EvaluationContext} context Evaluation context that should be set on the client to used during flag evaluations\n   * @returns {Client} OpenFeature Client\n   */\n  getClient(domain: string, context?: EvaluationContext): Client;\n  /**\n   * A factory function for creating new domain scoped OpenFeature clients.\n   * Clients can contain their own state (e.g. logger, hook, context).\n   * Multiple clients can be used to segment feature flag configuration.\n   *\n   * If there is already a provider bound to this domain via {@link this.setProvider setProvider}, this provider will be used.\n   * Otherwise, the default provider is used until a provider is assigned to that domain.\n   * @param {string} domain An identifier which logically binds clients with providers\n   * @param {string} version The version of the client (only used for metadata)\n   * @param {EvaluationContext} context Evaluation context that should be set on the client to used during flag evaluations\n   * @returns {Client} OpenFeature Client\n   */\n  getClient(domain: string, version: string, context?: EvaluationContext): Client;\n  getClient(\n    domainOrContext?: string | EvaluationContext,\n    versionOrContext?: string | EvaluationContext,\n    contextOrUndefined?: EvaluationContext,\n  ): Client {\n    const domain = stringOrUndefined(domainOrContext);\n    const version = stringOrUndefined(versionOrContext);\n    const context =\n      objectOrUndefined<EvaluationContext>(domainOrContext) ??\n      objectOrUndefined<EvaluationContext>(versionOrContext) ??\n      objectOrUndefined<EvaluationContext>(contextOrUndefined);\n\n    return new OpenFeatureClient(\n      () => this.getProviderForClient(domain),\n      () => this.buildAndCacheEventEmitterForClient(domain),\n      () => this._logger,\n      { domain, version },\n      context,\n    );\n  }\n\n  /**\n   * Clears all registered providers and resets the default provider.\n   * @returns {Promise<void>}\n   */\n  clearProviders(): Promise<void> {\n    return super.clearProvidersAndSetDefault(NOOP_PROVIDER);\n  }\n\n  setTransactionContextPropagator(\n    transactionContextPropagator: TransactionContextPropagator,\n  ): OpenFeatureCommonAPI<Provider> {\n    const baseMessage = 'Invalid TransactionContextPropagator, will not be set: ';\n    if (typeof transactionContextPropagator?.getTransactionContext !== 'function') {\n      this._logger.error(`${baseMessage}: getTransactionContext is not a function.`);\n    } else if (typeof transactionContextPropagator?.setTransactionContext !== 'function') {\n      this._logger.error(`${baseMessage}: setTransactionContext is not a function.`);\n    } else {\n      this._transactionContextPropagator = transactionContextPropagator;\n    }\n    return this;\n  }\n\n  setTransactionContext<R>(\n    transactionContext: TransactionContext,\n    callback: (...args: unknown[]) => R,\n    ...args: unknown[]\n  ): void {\n    this._transactionContextPropagator.setTransactionContext(transactionContext, callback, ...args);\n  }\n\n  getTransactionContext(): TransactionContext {\n    try {\n      return this._transactionContextPropagator.getTransactionContext();\n    } catch (err: unknown) {\n      const error = err as Error | undefined;\n      this._logger.error(`Error getting transaction context: ${error?.message}, returning empty context.`);\n      this._logger.error(error?.stack);\n      return {};\n    }\n  }\n}\n\n/**\n * A singleton instance of the OpenFeature API.\n * @returns {OpenFeatureAPI} OpenFeature API\n */\nexport const OpenFeature = OpenFeatureAPI.getInstance();\n", "import { EvaluationContext } from '@openfeature/core';\nimport { TransactionContextPropagator } from './transaction-context';\n\nclass NoopTransactionContextPropagator implements TransactionContextPropagator {\n  getTransactionContext(): EvaluationContext {\n    return {};\n  }\n\n  setTransactionContext(_: EvaluationContext, callback: () => void): void {\n    callback();\n  }\n}\n\nexport const NOOP_TRANSACTION_CONTEXT_PROPAGATOR = new NoopTransactionContextPropagator();\n", "import { GenericEventEmitter } from '@openfeature/core';\nimport EventEmitter from 'events';\nimport { ProviderEvents } from './events';\n\n/**\n * The OpenFeatureEventEmitter can be used by provider developers to emit\n * events at various parts of the provider lifecycle.\n * \n * NOTE: Ready and error events are automatically emitted by the SDK based on\n * the result of the initialize method.\n */\nexport class OpenFeatureEventEmitter extends GenericEventEmitter<ProviderEvents> {\n  protected readonly eventEmitter = new EventEmitter({ captureRejections: true });\n\n   constructor() {\n      super();\n      this.eventEmitter.on('error', (err) => {\n        this._logger?.error('Error running event handler:', err);\n      });\n    }\n};", "import { ServerProviderEvents } from '@openfeature/core';\n\nexport { ServerProviderEvents as ProviderEvents };"],
-  "mappings": "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",
-  "names": ["import_core", "import_core", "import_core", "import_core", "import_core", "EventEmitter", "import_core", "err"]
+  "sources": ["../../src/index.ts", "../../src/client/open-feature-client.ts", "../../src/open-feature.ts", "../../src/events/open-feature-event-emitter.ts", "../../src/events/events.ts", "../../src/provider/provider.ts", "../../src/provider/no-op-provider.ts", "../../src/provider/in-memory-provider/in-memory-provider.ts", "../../src/provider/in-memory-provider/variant-not-found-error.ts", "../../src/transaction-context/no-op-transaction-context-propagator.ts", "../../src/transaction-context/async-local-storage-transaction-context-propagator.ts"],
+  "sourcesContent": ["export * from './client';\nexport * from './provider';\nexport * from './evaluation';\nexport * from './open-feature';\nexport * from './transaction-context';\nexport * from './events';\nexport * from './hooks';\nexport * from '@openfeature/core';\n", "import {\n  ClientMetadata,\n  ErrorCode,\n  EvaluationContext,\n  EvaluationDetails,\n  EventHandler,\n  FlagValue,\n  FlagValueType,\n  HookContext,\n  JsonValue,\n  Logger,\n  ManageContext,\n  OpenFeatureError,\n  ProviderFatalError,\n  ProviderNotReadyError,\n  ResolutionDetails,\n  SafeLogger,\n  StandardResolutionReasons,\n  statusMatchesEvent,\n} from '@openfeature/core';\nimport { FlagEvaluationOptions } from '../evaluation';\nimport { ProviderEvents } from '../events';\nimport { InternalEventEmitter } from '../events/internal/internal-event-emitter';\nimport { Hook } from '../hooks';\nimport { OpenFeature } from '../open-feature';\nimport { Provider, ProviderStatus } from '../provider';\nimport { Client } from './client';\n\ntype OpenFeatureClientOptions = {\n  /**\n   * @deprecated Use `domain` instead.\n   */\n  name?: string;\n  domain?: string;\n  version?: string;\n};\n\nexport class OpenFeatureClient implements Client, ManageContext<OpenFeatureClient> {\n  private _context: EvaluationContext;\n  private _hooks: Hook[] = [];\n  private _clientLogger?: Logger;\n\n  constructor(\n    // we always want the client to use the current provider,\n    // so pass a function to always access the currently registered one.\n    private readonly providerAccessor: () => Provider,\n    private readonly providerStatusAccessor: () => ProviderStatus,\n    private readonly emitterAccessor: () => InternalEventEmitter,\n    private readonly globalLogger: () => Logger,\n    private readonly options: OpenFeatureClientOptions,\n    context: EvaluationContext = {},\n  ) {\n    this._context = context;\n  }\n\n  get metadata(): ClientMetadata {\n    return {\n      // Use domain if name is not provided\n      name: this.options.domain ?? this.options.name,\n      domain: this.options.domain ?? this.options.name,\n      version: this.options.version,\n      providerMetadata: this.providerAccessor().metadata,\n    };\n  }\n\n  get providerStatus(): ProviderStatus {\n    return this.providerStatusAccessor();\n  }\n\n  addHandler(eventType: ProviderEvents, handler: EventHandler): void {\n    this.emitterAccessor().addHandler(eventType, handler);\n    const shouldRunNow = statusMatchesEvent(eventType, this._providerStatus);\n\n    if (shouldRunNow) {\n      // run immediately, we're in the matching state\n      try {\n        handler({\n          clientName: this.metadata.name,\n          domain: this.metadata.domain,\n          providerName: this._provider.metadata.name,\n        });\n      } catch (err) {\n        this._logger?.error('Error running event handler:', err);\n      }\n    }\n  }\n\n  removeHandler(eventType: ProviderEvents, handler: EventHandler) {\n    this.emitterAccessor().removeHandler(eventType, handler);\n  }\n\n  getHandlers(eventType: ProviderEvents) {\n    return this.emitterAccessor().getHandlers(eventType);\n  }\n\n  setLogger(logger: Logger): OpenFeatureClient {\n    this._clientLogger = new SafeLogger(logger);\n    return this;\n  }\n\n  setContext(context: EvaluationContext): OpenFeatureClient {\n    this._context = context;\n    return this;\n  }\n\n  getContext(): EvaluationContext {\n    return this._context;\n  }\n\n  addHooks(...hooks: Hook[]): OpenFeatureClient {\n    this._hooks = [...this._hooks, ...hooks];\n    return this;\n  }\n\n  getHooks(): Hook[] {\n    return this._hooks;\n  }\n\n  clearHooks(): OpenFeatureClient {\n    this._hooks = [];\n    return this;\n  }\n\n  async getBooleanValue(\n    flagKey: string,\n    defaultValue: boolean,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<boolean> {\n    return (await this.getBooleanDetails(flagKey, defaultValue, context, options)).value;\n  }\n\n  getBooleanDetails(\n    flagKey: string,\n    defaultValue: boolean,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<EvaluationDetails<boolean>> {\n    return this.evaluate<boolean>(\n      flagKey,\n      this._provider.resolveBooleanEvaluation,\n      defaultValue,\n      'boolean',\n      context,\n      options,\n    );\n  }\n\n  async getStringValue<T extends string = string>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<T> {\n    return (await this.getStringDetails<T>(flagKey, defaultValue, context, options)).value;\n  }\n\n  getStringDetails<T extends string = string>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<EvaluationDetails<T>> {\n    return this.evaluate<T>(\n      flagKey,\n      // this isolates providers from our restricted string generic argument.\n      this._provider.resolveStringEvaluation as () => Promise<EvaluationDetails<T>>,\n      defaultValue,\n      'string',\n      context,\n      options,\n    );\n  }\n\n  async getNumberValue<T extends number = number>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<T> {\n    return (await this.getNumberDetails(flagKey, defaultValue, context, options)).value;\n  }\n\n  getNumberDetails<T extends number = number>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<EvaluationDetails<T>> {\n    return this.evaluate<T>(\n      flagKey,\n      // this isolates providers from our restricted number generic argument.\n      this._provider.resolveNumberEvaluation as () => Promise<EvaluationDetails<T>>,\n      defaultValue,\n      'number',\n      context,\n      options,\n    );\n  }\n\n  async getObjectValue<T extends JsonValue = JsonValue>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<T> {\n    return (await this.getObjectDetails(flagKey, defaultValue, context, options)).value;\n  }\n\n  getObjectDetails<T extends JsonValue = JsonValue>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<EvaluationDetails<T>> {\n    return this.evaluate<T>(flagKey, this._provider.resolveObjectEvaluation, defaultValue, 'object', context, options);\n  }\n\n  private async evaluate<T extends FlagValue>(\n    flagKey: string,\n    resolver: (\n      flagKey: string,\n      defaultValue: T,\n      context: EvaluationContext,\n      logger: Logger,\n    ) => Promise<ResolutionDetails<T>>,\n    defaultValue: T,\n    flagType: FlagValueType,\n    invocationContext: EvaluationContext = {},\n    options: FlagEvaluationOptions = {},\n  ): Promise<EvaluationDetails<T>> {\n    // merge global, client, and evaluation context\n\n    const allHooks = [\n      ...OpenFeature.getHooks(),\n      ...this.getHooks(),\n      ...(options.hooks || []),\n      ...(this._provider.hooks || []),\n    ];\n    const allHooksReversed = [...allHooks].reverse();\n\n    // merge global and client contexts\n    const mergedContext = {\n      ...OpenFeature.getContext(),\n      ...OpenFeature.getTransactionContext(),\n      ...this._context,\n      ...invocationContext,\n    };\n\n    // this reference cannot change during the course of evaluation\n    // it may be used as a key in WeakMaps\n    const hookContext: Readonly<HookContext> = {\n      flagKey,\n      defaultValue,\n      flagValueType: flagType,\n      clientMetadata: this.metadata,\n      providerMetadata: OpenFeature.providerMetadata,\n      context: mergedContext,\n      logger: this._logger,\n    };\n\n    try {\n      const frozenContext = await this.beforeHooks(allHooks, hookContext, options);\n\n      // short circuit evaluation entirely if provider is in a bad state\n      if (this.providerStatus === ProviderStatus.NOT_READY) {\n        throw new ProviderNotReadyError('provider has not yet initialized');\n      } else if (this.providerStatus === ProviderStatus.FATAL) {\n        throw new ProviderFatalError('provider is in an irrecoverable error state');\n      }\n\n      // run the referenced resolver, binding the provider.\n      const resolution = await resolver.call(this._provider, flagKey, defaultValue, frozenContext, this._logger);\n\n      const evaluationDetails = {\n        ...resolution,\n        flagMetadata: Object.freeze(resolution.flagMetadata ?? {}),\n        flagKey,\n      };\n\n      await this.afterHooks(allHooksReversed, hookContext, evaluationDetails, options);\n\n      return evaluationDetails;\n    } catch (err: unknown) {\n      const errorMessage: string = (err as Error)?.message;\n      const errorCode: ErrorCode = (err as OpenFeatureError)?.code || ErrorCode.GENERAL;\n\n      await this.errorHooks(allHooksReversed, hookContext, err, options);\n\n      return {\n        errorCode,\n        errorMessage,\n        value: defaultValue,\n        reason: StandardResolutionReasons.ERROR,\n        flagMetadata: Object.freeze({}),\n        flagKey,\n      };\n    } finally {\n      await this.finallyHooks(allHooksReversed, hookContext, options);\n    }\n  }\n\n  private async beforeHooks(hooks: Hook[], hookContext: HookContext, options: FlagEvaluationOptions) {\n    for (const hook of hooks) {\n      // freeze the hookContext\n      Object.freeze(hookContext);\n\n      // use Object.assign to avoid modification of frozen hookContext\n      Object.assign(hookContext.context, {\n        ...hookContext.context,\n        ...(await hook?.before?.(hookContext, Object.freeze(options.hookHints))),\n      });\n    }\n\n    // after before hooks, freeze the EvaluationContext.\n    return Object.freeze(hookContext.context);\n  }\n\n  private async afterHooks(\n    hooks: Hook[],\n    hookContext: HookContext,\n    evaluationDetails: EvaluationDetails<FlagValue>,\n    options: FlagEvaluationOptions,\n  ) {\n    // run \"after\" hooks sequentially\n    for (const hook of hooks) {\n      await hook?.after?.(hookContext, evaluationDetails, options.hookHints);\n    }\n  }\n\n  private async errorHooks(hooks: Hook[], hookContext: HookContext, err: unknown, options: FlagEvaluationOptions) {\n    // run \"error\" hooks sequentially\n    for (const hook of hooks) {\n      try {\n        await hook?.error?.(hookContext, err, options.hookHints);\n      } catch (err) {\n        this._logger.error(`Unhandled error during 'error' hook: ${err}`);\n        if (err instanceof Error) {\n          this._logger.error(err.stack);\n        }\n        this._logger.error((err as Error)?.stack);\n      }\n    }\n  }\n\n  private async finallyHooks(hooks: Hook[], hookContext: HookContext, options: FlagEvaluationOptions) {\n    // run \"finally\" hooks sequentially\n    for (const hook of hooks) {\n      try {\n        await hook?.finally?.(hookContext, options.hookHints);\n      } catch (err) {\n        this._logger.error(`Unhandled error during 'finally' hook: ${err}`);\n        if (err instanceof Error) {\n          this._logger.error(err.stack);\n        }\n        this._logger.error((err as Error)?.stack);\n      }\n    }\n  }\n\n  private get _provider(): Provider {\n    return this.providerAccessor();\n  }\n\n  private get _providerStatus(): ProviderStatus {\n    return this.providerStatusAccessor();\n  }\n\n  private get _logger() {\n    return this._clientLogger || this.globalLogger();\n  }\n}\n", "import {\n  EvaluationContext,\n  ManageContext,\n  OpenFeatureCommonAPI,\n  ProviderWrapper,\n  objectOrUndefined,\n  stringOrUndefined,\n} from '@openfeature/core';\nimport { Client, OpenFeatureClient } from './client';\nimport { OpenFeatureEventEmitter } from './events';\nimport { Hook } from './hooks';\nimport { NOOP_PROVIDER, Provider, ProviderStatus } from './provider';\nimport {\n  ManageTransactionContextPropagator,\n  NOOP_TRANSACTION_CONTEXT_PROPAGATOR,\n  TransactionContext,\n  TransactionContextPropagator,\n} from './transaction-context';\nimport { ServerProviderStatus } from '@openfeature/core';\n\n// use a symbol as a key for the global singleton\nconst GLOBAL_OPENFEATURE_API_KEY = Symbol.for('@openfeature/js-sdk/api');\n\ntype OpenFeatureGlobal = {\n  [GLOBAL_OPENFEATURE_API_KEY]?: OpenFeatureAPI;\n};\nconst _globalThis = globalThis as OpenFeatureGlobal;\n\nexport class OpenFeatureAPI\n  extends OpenFeatureCommonAPI<ServerProviderStatus, Provider, Hook>\n  implements ManageContext<OpenFeatureAPI>, ManageTransactionContextPropagator<OpenFeatureCommonAPI<ServerProviderStatus, Provider>>\n{\n  protected _statusEnumType: typeof ProviderStatus = ProviderStatus;\n  protected _apiEmitter = new OpenFeatureEventEmitter();\n  protected _defaultProvider: ProviderWrapper<Provider, ServerProviderStatus> = new ProviderWrapper(NOOP_PROVIDER, ProviderStatus.NOT_READY, this._statusEnumType);\n  protected _domainScopedProviders: Map<string, ProviderWrapper<Provider, ServerProviderStatus>> = new Map();\n  protected _createEventEmitter = () => new OpenFeatureEventEmitter();\n\n  private _transactionContextPropagator: TransactionContextPropagator = NOOP_TRANSACTION_CONTEXT_PROPAGATOR;\n\n  private constructor() {\n    super('server');\n  }\n\n  /**\n   * Gets a singleton instance of the OpenFeature API.\n   * @ignore\n   * @returns {OpenFeatureAPI} OpenFeature API\n   */\n  static getInstance(): OpenFeatureAPI {\n    const globalApi = _globalThis[GLOBAL_OPENFEATURE_API_KEY];\n    if (globalApi) {\n      return globalApi;\n    }\n\n    const instance = new OpenFeatureAPI();\n    _globalThis[GLOBAL_OPENFEATURE_API_KEY] = instance;\n    return instance;\n  }\n\n  private getProviderStatus(domain?: string): ProviderStatus {\n    if (!domain) {\n      return this._defaultProvider.status;\n    }\n\n    return this._domainScopedProviders.get(domain)?.status ?? this._defaultProvider.status;\n  }\n\n  setContext(context: EvaluationContext): this {\n    this._context = context;\n    return this;\n  }\n\n  getContext(): EvaluationContext {\n    return this._context;\n  }\n\n  /**\n   * A factory function for creating new domainless OpenFeature clients.\n   * Clients can contain their own state (e.g. logger, hook, context).\n   * Multiple clients can be used to segment feature flag configuration.\n   *\n   * All domainless or unbound clients use the default provider set via {@link this.setProvider setProvider}.\n   * @param {EvaluationContext} context Evaluation context that should be set on the client to used during flag evaluations\n   * @returns {Client} OpenFeature Client\n   */\n  getClient(context?: EvaluationContext): Client;\n  /**\n   * A factory function for creating new domain scoped OpenFeature clients.\n   * Clients can contain their own state (e.g. logger, hook, context).\n   * Multiple clients can be used to segment feature flag configuration.\n   *\n   * If there is already a provider bound to this domain via {@link this.setProvider setProvider}, this provider will be used.\n   * Otherwise, the default provider is used until a provider is assigned to that domain.\n   * @param {string} domain An identifier which logically binds clients with providers\n   * @param {EvaluationContext} context Evaluation context that should be set on the client to used during flag evaluations\n   * @returns {Client} OpenFeature Client\n   */\n  getClient(domain: string, context?: EvaluationContext): Client;\n  /**\n   * A factory function for creating new domain scoped OpenFeature clients.\n   * Clients can contain their own state (e.g. logger, hook, context).\n   * Multiple clients can be used to segment feature flag configuration.\n   *\n   * If there is already a provider bound to this domain via {@link this.setProvider setProvider}, this provider will be used.\n   * Otherwise, the default provider is used until a provider is assigned to that domain.\n   * @param {string} domain An identifier which logically binds clients with providers\n   * @param {string} version The version of the client (only used for metadata)\n   * @param {EvaluationContext} context Evaluation context that should be set on the client to used during flag evaluations\n   * @returns {Client} OpenFeature Client\n   */\n  getClient(domain: string, version: string, context?: EvaluationContext): Client;\n  getClient(\n    domainOrContext?: string | EvaluationContext,\n    versionOrContext?: string | EvaluationContext,\n    contextOrUndefined?: EvaluationContext,\n  ): Client {\n    const domain = stringOrUndefined(domainOrContext);\n    const version = stringOrUndefined(versionOrContext);\n    const context =\n      objectOrUndefined<EvaluationContext>(domainOrContext) ??\n      objectOrUndefined<EvaluationContext>(versionOrContext) ??\n      objectOrUndefined<EvaluationContext>(contextOrUndefined);\n\n    return new OpenFeatureClient(\n      () => this.getProviderForClient(domain),\n      () => this.getProviderStatus(domain),\n      () => this.buildAndCacheEventEmitterForClient(domain),\n      () => this._logger,\n      { domain, version },\n      context,\n    );\n  }\n\n  /**\n   * Clears all registered providers and resets the default provider.\n   * @returns {Promise<void>}\n   */\n  clearProviders(): Promise<void> {\n    return super.clearProvidersAndSetDefault(NOOP_PROVIDER);\n  }\n\n  setTransactionContextPropagator(\n    transactionContextPropagator: TransactionContextPropagator,\n  ): OpenFeatureCommonAPI<ServerProviderStatus, Provider> {\n    const baseMessage = 'Invalid TransactionContextPropagator, will not be set: ';\n    if (typeof transactionContextPropagator?.getTransactionContext !== 'function') {\n      this._logger.error(`${baseMessage}: getTransactionContext is not a function.`);\n    } else if (typeof transactionContextPropagator?.setTransactionContext !== 'function') {\n      this._logger.error(`${baseMessage}: setTransactionContext is not a function.`);\n    } else {\n      this._transactionContextPropagator = transactionContextPropagator;\n    }\n    return this;\n  }\n\n  setTransactionContext<TArgs extends unknown[], R>(\n    transactionContext: TransactionContext,\n    callback: (...args: TArgs) => R,\n    ...args: TArgs\n  ): void {\n    this._transactionContextPropagator.setTransactionContext(transactionContext, callback, ...args);\n  }\n\n  getTransactionContext(): TransactionContext {\n    try {\n      return this._transactionContextPropagator.getTransactionContext();\n    } catch (err: unknown) {\n      const error = err as Error | undefined;\n      this._logger.error(`Error getting transaction context: ${error?.message}, returning empty context.`);\n      this._logger.error(error?.stack);\n      return {};\n    }\n  }\n}\n\n/**\n * A singleton instance of the OpenFeature API.\n * @returns {OpenFeatureAPI} OpenFeature API\n */\nexport const OpenFeature = OpenFeatureAPI.getInstance();\n", "import { GenericEventEmitter } from '@openfeature/core';\nimport { EventEmitter } from 'node:events';\nimport { ProviderEvents } from './events';\n\n/**\n * The OpenFeatureEventEmitter can be used by provider developers to emit\n * events at various parts of the provider lifecycle.\n * \n * NOTE: Ready and error events are automatically emitted by the SDK based on\n * the result of the initialize method.\n */\nexport class OpenFeatureEventEmitter extends GenericEventEmitter<ProviderEvents> {\n  protected readonly eventEmitter = new EventEmitter({ captureRejections: true });\n\n   constructor() {\n      super();\n      this.eventEmitter.on('error', (err) => {\n        this._logger?.error('Error running event handler:', err);\n      });\n    }\n};", "import { ServerProviderEvents } from '@openfeature/core';\n\nexport { ServerProviderEvents as ProviderEvents };", "import { CommonProvider, EvaluationContext, JsonValue, Logger, ResolutionDetails, ServerProviderStatus } from '@openfeature/core';\nimport { Hook } from '../hooks';\n\nexport { ServerProviderStatus as ProviderStatus };\n\n/**\n * Interface that providers must implement to resolve flag values for their particular\n * backend or vendor.\n *\n * Implementation for resolving all the required flag types must be defined.\n */\nexport interface Provider extends CommonProvider<ServerProviderStatus> {\n  /**\n   * A provider hook exposes a mechanism for provider authors to register hooks\n   * to tap into various stages of the flag evaluation lifecycle. These hooks can\n   * be used to perform side effects and mutate the context for purposes of the\n   * provider. Provider hooks are not configured or controlled by the application author.\n   */\n  readonly hooks?: Hook[];\n\n  /**\n   * Resolve a boolean flag and its evaluation details.\n   */\n  resolveBooleanEvaluation(\n    flagKey: string,\n    defaultValue: boolean,\n    context: EvaluationContext,\n    logger: Logger,\n  ): Promise<ResolutionDetails<boolean>>;\n\n  /**\n   * Resolve a string flag and its evaluation details.\n   */\n  resolveStringEvaluation(\n    flagKey: string,\n    defaultValue: string,\n    context: EvaluationContext,\n    logger: Logger,\n  ): Promise<ResolutionDetails<string>>;\n\n  /**\n   * Resolve a numeric flag and its evaluation details.\n   */\n  resolveNumberEvaluation(\n    flagKey: string,\n    defaultValue: number,\n    context: EvaluationContext,\n    logger: Logger,\n  ): Promise<ResolutionDetails<number>>;\n\n  /**\n   * Resolve and parse an object flag and its evaluation details.\n   */\n  resolveObjectEvaluation<T extends JsonValue>(\n    flagKey: string,\n    defaultValue: T,\n    context: EvaluationContext,\n    logger: Logger,\n  ): Promise<ResolutionDetails<T>>;\n}\n", "import { JsonValue, ResolutionDetails } from '@openfeature/core';\nimport { Provider } from './provider';\n\nconst REASON_NO_OP = 'No-op';\n\n/**\n * The No-op provider is set by default, and simply always returns the default value.\n */\nclass NoopFeatureProvider implements Provider {\n  readonly metadata = {\n    name: 'No-op Provider',\n  } as const;\n\n  resolveBooleanEvaluation(_: string, defaultValue: boolean): Promise<ResolutionDetails<boolean>> {\n    return this.noOp(defaultValue);\n  }\n\n  resolveStringEvaluation(_: string, defaultValue: string): Promise<ResolutionDetails<string>> {\n    return this.noOp(defaultValue);\n  }\n\n  resolveNumberEvaluation(_: string, defaultValue: number): Promise<ResolutionDetails<number>> {\n    return this.noOp(defaultValue);\n  }\n\n  resolveObjectEvaluation<T extends JsonValue>(_: string, defaultValue: T): Promise<ResolutionDetails<T>> {\n    return this.noOp<T>(defaultValue);\n  }\n\n  private noOp<T>(defaultValue: T) {\n    return Promise.resolve({\n      value: defaultValue,\n      reason: REASON_NO_OP,\n    });\n  }\n}\n\nexport const NOOP_PROVIDER = new NoopFeatureProvider();\n", "import {\n  EvaluationContext,\n  FlagNotFoundError,\n  FlagValueType,\n  GeneralError,\n  JsonValue,\n  Logger,\n  OpenFeatureError,\n  ResolutionDetails,\n  StandardResolutionReasons,\n  TypeMismatchError\n} from '@openfeature/core';\nimport { Provider } from '../provider';\nimport { Flag, FlagConfiguration } from './flag-configuration';\nimport { VariantFoundError } from './variant-not-found-error';\nimport { OpenFeatureEventEmitter, ProviderEvents } from '../..';\n\n/**\n * A simple OpenFeature provider intended for demos and as a test stub.\n */\nexport class InMemoryProvider implements Provider {\n  public readonly events = new OpenFeatureEventEmitter();\n  public readonly runsOn = 'server';\n  readonly metadata = {\n    name: 'in-memory',\n  } as const;\n  private _flagConfiguration: FlagConfiguration;\n\n  constructor(flagConfiguration: FlagConfiguration = {}) {\n    this._flagConfiguration = { ...flagConfiguration };\n  }\n\n  /**\n   * Overwrites the configured flags.\n   * @param { FlagConfiguration } flagConfiguration new flag configuration\n   */\n  putConfiguration(flagConfiguration: FlagConfiguration) {\n    const flagsChanged = Object.entries(flagConfiguration)\n      .filter(([key, value]) => this._flagConfiguration[key] !== value)\n      .map(([key]) => key);\n\n    this._flagConfiguration = { ...flagConfiguration };\n    this.events.emit(ProviderEvents.ConfigurationChanged, { flagsChanged });\n  }\n\n  resolveBooleanEvaluation(\n    flagKey: string,\n    defaultValue: boolean,\n    context?: EvaluationContext,\n    logger?: Logger,\n  ): Promise<ResolutionDetails<boolean>> {\n    return this.resolveFlagWithReason<boolean>(flagKey, defaultValue, context, logger);\n  }\n\n  resolveNumberEvaluation(\n    flagKey: string,\n    defaultValue: number,\n    context?: EvaluationContext,\n    logger?: Logger,\n  ): Promise<ResolutionDetails<number>> {\n    return this.resolveFlagWithReason<number>(flagKey, defaultValue, context, logger);\n  }\n\n  async resolveStringEvaluation(\n    flagKey: string,\n    defaultValue: string,\n    context?: EvaluationContext,\n    logger?: Logger,\n  ): Promise<ResolutionDetails<string>> {\n    return this.resolveFlagWithReason<string>(flagKey, defaultValue, context, logger);\n  }\n\n  async resolveObjectEvaluation<T extends JsonValue>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    logger?: Logger,\n  ): Promise<ResolutionDetails<T>> {\n    return this.resolveFlagWithReason<T>(flagKey, defaultValue, context, logger);\n  }\n\n  private async resolveFlagWithReason<T extends JsonValue | FlagValueType>(\n    flagKey: string,\n    defaultValue: T,\n    ctx?: EvaluationContext,\n    logger?: Logger,\n  ): Promise<ResolutionDetails<T>> {\n    try {\n      const resolutionResult = this.lookupFlagValue(flagKey, defaultValue, ctx, logger);\n\n      if (typeof resolutionResult?.value != typeof defaultValue) {\n        throw new TypeMismatchError();\n      }\n\n      return resolutionResult;\n    } catch (error: unknown) {\n      if (!(error instanceof OpenFeatureError)) {\n        throw new GeneralError((error as Error)?.message || 'unknown error'); \n      }\n      throw error;\n    }\n  }\n\n  private lookupFlagValue<T extends JsonValue | FlagValueType>(\n    flagKey: string,\n    defaultValue: T,\n    ctx?: EvaluationContext,\n    logger?: Logger,\n  ): ResolutionDetails<T> {\n    if (!(flagKey in this._flagConfiguration)) {\n      const message = `no flag found with key ${flagKey}`;\n      logger?.debug(message);\n      throw new FlagNotFoundError(message);\n    }\n    const flagSpec: Flag = this._flagConfiguration[flagKey];\n\n    if (flagSpec.disabled) {\n      return { value: defaultValue, reason: StandardResolutionReasons.DISABLED };\n    }\n\n    const isContextEval = ctx && flagSpec?.contextEvaluator;\n    const variant = isContextEval ? flagSpec.contextEvaluator?.(ctx) : flagSpec.defaultVariant;\n\n    const value = variant && flagSpec?.variants[variant];\n\n    if (value === undefined) {\n      const message = `no value associated with variant ${variant}`;\n      logger?.error(message);\n      throw new VariantFoundError(message);\n    }\n\n    return {\n      value: value as T,\n      ...(variant && { variant }),\n      reason: isContextEval ? StandardResolutionReasons.TARGETING_MATCH : StandardResolutionReasons.STATIC,\n    };\n  }\n}\n", "import { ErrorCode, OpenFeatureError } from '@openfeature/core';\n\n/**\n * A custom error for the in-memory provider.\n * Indicates the resolved or default variant doesn't exist.\n */\nexport class VariantFoundError extends OpenFeatureError {\n  code: ErrorCode;\n  constructor(message?: string) {\n    super(message);\n    Object.setPrototypeOf(this, VariantFoundError.prototype);\n    this.name = 'VariantFoundError';\n    this.code = ErrorCode.GENERAL;\n  }\n}\n", "import { EvaluationContext } from '@openfeature/core';\nimport { TransactionContext, TransactionContextPropagator } from './transaction-context';\n\nclass NoopTransactionContextPropagator implements TransactionContextPropagator {\n  getTransactionContext(): EvaluationContext {\n    return {};\n  }\n\n  setTransactionContext<TArgs extends unknown[], R>(\n    _: TransactionContext,\n    callback: (...args: TArgs) => R,\n    ...args: TArgs\n  ): void {\n    callback(...args);\n  }\n}\n\nexport const NOOP_TRANSACTION_CONTEXT_PROPAGATOR = new NoopTransactionContextPropagator();\n", "import { EvaluationContext } from '@openfeature/core';\nimport { TransactionContext, TransactionContextPropagator } from './transaction-context';\nimport { AsyncLocalStorage } from 'async_hooks';\n\nexport class AsyncLocalStorageTransactionContextPropagator implements TransactionContextPropagator {\n  private asyncLocalStorage = new AsyncLocalStorage<EvaluationContext>();\n\n  getTransactionContext(): EvaluationContext {\n    return this.asyncLocalStorage.getStore() ?? {};\n  }\n\n  setTransactionContext<TArgs extends unknown[], R>(\n    transactionContext: TransactionContext,\n    callback: (...args: TArgs) => R,\n    ...args: TArgs\n  ): void {\n    this.asyncLocalStorage.run(transactionContext, callback, ...args);\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["import_core", "import_core", "import_core", "import_core", "import_core", "import_core", "err"]
 }

package/dist/esm/index.js CHANGED Viewed

@@ -1,21 +1,46 @@
 // src/client/open-feature-client.ts
 import {
   ErrorCode as ErrorCode2,
+  ProviderFatalError,
+  ProviderNotReadyError,
   SafeLogger,
   StandardResolutionReasons as StandardResolutionReasons2,
   statusMatchesEvent
 } from "@openfeature/core";
+// src/open-feature.ts
+import {
+  OpenFeatureCommonAPI,
+  ProviderWrapper,
+  objectOrUndefined,
+  stringOrUndefined
+} from "@openfeature/core";
+// src/events/open-feature-event-emitter.ts
+import { GenericEventEmitter } from "@openfeature/core";
+import { EventEmitter } from "events";
+var OpenFeatureEventEmitter = class extends GenericEventEmitter {
+  eventEmitter = new EventEmitter({ captureRejections: true });
+  constructor() {
+    super();
+    this.eventEmitter.on("error", (err) => {
+      this._logger?.error("Error running event handler:", err);
+    });
+  }
+};
+// src/events/events.ts
+import { ServerProviderEvents } from "@openfeature/core";
+// src/provider/provider.ts
+import { ServerProviderStatus } from "@openfeature/core";
 // src/provider/no-op-provider.ts
-import { ProviderStatus } from "@openfeature/core";
 var REASON_NO_OP = "No-op";
 var NoopFeatureProvider = class {
   metadata = {
     name: "No-op Provider"
   };
-  get status() {
-    return ProviderStatus.NOT_READY;
-  }
   resolveBooleanEvaluation(_, defaultValue) {
     return this.noOp(defaultValue);
   }
@@ -130,46 +155,37 @@ var InMemoryProvider = class {
   }
 };
-// src/open-feature.ts
-import {
-  OpenFeatureCommonAPI,
-  objectOrUndefined,
-  stringOrUndefined
-} from "@openfeature/core";
 // src/transaction-context/no-op-transaction-context-propagator.ts
 var NoopTransactionContextPropagator = class {
   getTransactionContext() {
     return {};
   }
-  setTransactionContext(_, callback) {
-    callback();
+  setTransactionContext(_, callback, ...args) {
+    callback(...args);
   }
 };
 var NOOP_TRANSACTION_CONTEXT_PROPAGATOR = new NoopTransactionContextPropagator();
-// src/events/open-feature-event-emitter.ts
-import { GenericEventEmitter } from "@openfeature/core";
-import EventEmitter from "events";
-var OpenFeatureEventEmitter = class extends GenericEventEmitter {
-  eventEmitter = new EventEmitter({ captureRejections: true });
-  constructor() {
-    super();
-    this.eventEmitter.on("error", (err) => {
-      this._logger?.error("Error running event handler:", err);
-    });
+// src/transaction-context/async-local-storage-transaction-context-propagator.ts
+import { AsyncLocalStorage } from "async_hooks";
+var AsyncLocalStorageTransactionContextPropagator = class {
+  asyncLocalStorage = new AsyncLocalStorage();
+  getTransactionContext() {
+    return this.asyncLocalStorage.getStore() ?? {};
+  }
+  setTransactionContext(transactionContext, callback, ...args) {
+    this.asyncLocalStorage.run(transactionContext, callback, ...args);
   }
 };
-// src/events/events.ts
-import { ServerProviderEvents } from "@openfeature/core";
 // src/open-feature.ts
 var GLOBAL_OPENFEATURE_API_KEY = Symbol.for("@openfeature/js-sdk/api");
 var _globalThis = globalThis;
 var OpenFeatureAPI = class _OpenFeatureAPI extends OpenFeatureCommonAPI {
-  _events = new OpenFeatureEventEmitter();
-  _defaultProvider = NOOP_PROVIDER;
+  _statusEnumType = ServerProviderStatus;
+  _apiEmitter = new OpenFeatureEventEmitter();
+  _defaultProvider = new ProviderWrapper(NOOP_PROVIDER, ServerProviderStatus.NOT_READY, this._statusEnumType);
+  _domainScopedProviders = /* @__PURE__ */ new Map();
   _createEventEmitter = () => new OpenFeatureEventEmitter();
   _transactionContextPropagator = NOOP_TRANSACTION_CONTEXT_PROPAGATOR;
   constructor() {
@@ -189,6 +205,12 @@ var OpenFeatureAPI = class _OpenFeatureAPI extends OpenFeatureCommonAPI {
     _globalThis[GLOBAL_OPENFEATURE_API_KEY] = instance;
     return instance;
   }
+  getProviderStatus(domain) {
+    if (!domain) {
+      return this._defaultProvider.status;
+    }
+    return this._domainScopedProviders.get(domain)?.status ?? this._defaultProvider.status;
+  }
   setContext(context) {
     this._context = context;
     return this;
@@ -202,6 +224,7 @@ var OpenFeatureAPI = class _OpenFeatureAPI extends OpenFeatureCommonAPI {
     const context = objectOrUndefined(domainOrContext) ?? objectOrUndefined(versionOrContext) ?? objectOrUndefined(contextOrUndefined);
     return new OpenFeatureClient(
       () => this.getProviderForClient(domain),
+      () => this.getProviderStatus(domain),
       () => this.buildAndCacheEventEmitterForClient(domain),
       () => this._logger,
       { domain, version },
@@ -244,8 +267,9 @@ var OpenFeature = OpenFeatureAPI.getInstance();
 // src/client/open-feature-client.ts
 var OpenFeatureClient = class {
-  constructor(providerAccessor, emitterAccessor, globalLogger, options, context = {}) {
+  constructor(providerAccessor, providerStatusAccessor, emitterAccessor, globalLogger, options, context = {}) {
     this.providerAccessor = providerAccessor;
+    this.providerStatusAccessor = providerStatusAccessor;
     this.emitterAccessor = emitterAccessor;
     this.globalLogger = globalLogger;
     this.options = options;
@@ -263,9 +287,12 @@ var OpenFeatureClient = class {
       providerMetadata: this.providerAccessor().metadata
     };
   }
+  get providerStatus() {
+    return this.providerStatusAccessor();
+  }
   addHandler(eventType, handler) {
     this.emitterAccessor().addHandler(eventType, handler);
-    const shouldRunNow = statusMatchesEvent(eventType, this._provider.status);
+    const shouldRunNow = statusMatchesEvent(eventType, this._providerStatus);
     if (shouldRunNow) {
       try {
         handler({
@@ -378,6 +405,11 @@ var OpenFeatureClient = class {
     };
     try {
       const frozenContext = await this.beforeHooks(allHooks, hookContext, options);
+      if (this.providerStatus === ServerProviderStatus.NOT_READY) {
+        throw new ProviderNotReadyError("provider has not yet initialized");
+      } else if (this.providerStatus === ServerProviderStatus.FATAL) {
+        throw new ProviderFatalError("provider is in an irrecoverable error state");
+      }
       const resolution = await resolver.call(this._provider, flagKey, defaultValue, frozenContext, this._logger);
       const evaluationDetails = {
         ...resolution,
@@ -446,6 +478,9 @@ var OpenFeatureClient = class {
   get _provider() {
     return this.providerAccessor();
   }
+  get _providerStatus() {
+    return this.providerStatusAccessor();
+  }
   get _logger() {
     return this._clientLogger || this.globalLogger();
   }
@@ -454,6 +489,7 @@ var OpenFeatureClient = class {
 // src/index.ts
 export * from "@openfeature/core";
 export {
+  AsyncLocalStorageTransactionContextPropagator,
   InMemoryProvider,
   NOOP_PROVIDER,
   NOOP_TRANSACTION_CONTEXT_PROPAGATOR,
@@ -461,6 +497,7 @@ export {
   OpenFeatureAPI,
   OpenFeatureClient,
   OpenFeatureEventEmitter,
-  ServerProviderEvents as ProviderEvents
+  ServerProviderEvents as ProviderEvents,
+  ServerProviderStatus as ProviderStatus
 };
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/client/open-feature-client.ts", "../../src/provider/no-op-provider.ts", "../../src/provider/in-memory-provider/in-memory-provider.ts", "../../src/provider/in-memory-provider/variant-not-found-error.ts", "../../src/open-feature.ts", "../../src/transaction-context/no-op-transaction-context-propagator.ts", "../../src/events/open-feature-event-emitter.ts", "../../src/events/events.ts", "../../src/index.ts"],
-  "sourcesContent": ["import {\n  ClientMetadata,\n  ErrorCode,\n  EvaluationContext,\n  EvaluationDetails,\n  EventHandler,\n  FlagValue,\n  FlagValueType,\n  HookContext,\n  JsonValue,\n  Logger,\n  ManageContext,\n  OpenFeatureError,\n  ResolutionDetails,\n  SafeLogger,\n  StandardResolutionReasons,\n  statusMatchesEvent,\n} from '@openfeature/core';\nimport { FlagEvaluationOptions } from '../evaluation';\nimport { ProviderEvents } from '../events';\nimport { InternalEventEmitter } from '../events/internal/internal-event-emitter';\nimport { Hook } from '../hooks';\nimport { OpenFeature } from '../open-feature';\nimport { Provider } from '../provider';\nimport { Client } from './client';\n\ntype OpenFeatureClientOptions = {\n  /**\n   * @deprecated Use `domain` instead.\n   */\n  name?: string;\n  domain?: string;\n  version?: string;\n};\n\nexport class OpenFeatureClient implements Client, ManageContext<OpenFeatureClient> {\n  private _context: EvaluationContext;\n  private _hooks: Hook[] = [];\n  private _clientLogger?: Logger;\n\n  constructor(\n    // we always want the client to use the current provider,\n    // so pass a function to always access the currently registered one.\n    private readonly providerAccessor: () => Provider,\n    private readonly emitterAccessor: () => InternalEventEmitter,\n    private readonly globalLogger: () => Logger,\n    private readonly options: OpenFeatureClientOptions,\n    context: EvaluationContext = {},\n  ) {\n    this._context = context;\n  }\n\n  get metadata(): ClientMetadata {\n    return {\n      // Use domain if name is not provided\n      name: this.options.domain ?? this.options.name,\n      domain: this.options.domain ?? this.options.name,\n      version: this.options.version,\n      providerMetadata: this.providerAccessor().metadata,\n    };\n  }\n\n  addHandler(eventType: ProviderEvents, handler: EventHandler): void {\n    this.emitterAccessor().addHandler(eventType, handler);\n    const shouldRunNow = statusMatchesEvent(eventType, this._provider.status);\n\n    if (shouldRunNow) {\n      // run immediately, we're in the matching state\n      try {\n        handler({\n          clientName: this.metadata.name,\n          domain: this.metadata.domain,\n          providerName: this._provider.metadata.name,\n        });\n      } catch (err) {\n        this._logger?.error('Error running event handler:', err);\n      }\n    }\n  }\n\n  removeHandler(eventType: ProviderEvents, handler: EventHandler) {\n    this.emitterAccessor().removeHandler(eventType, handler);\n  }\n\n  getHandlers(eventType: ProviderEvents) {\n    return this.emitterAccessor().getHandlers(eventType);\n  }\n\n  setLogger(logger: Logger): OpenFeatureClient {\n    this._clientLogger = new SafeLogger(logger);\n    return this;\n  }\n\n  setContext(context: EvaluationContext): OpenFeatureClient {\n    this._context = context;\n    return this;\n  }\n\n  getContext(): EvaluationContext {\n    return this._context;\n  }\n\n  addHooks(...hooks: Hook[]): OpenFeatureClient {\n    this._hooks = [...this._hooks, ...hooks];\n    return this;\n  }\n\n  getHooks(): Hook[] {\n    return this._hooks;\n  }\n\n  clearHooks(): OpenFeatureClient {\n    this._hooks = [];\n    return this;\n  }\n\n  async getBooleanValue(\n    flagKey: string,\n    defaultValue: boolean,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<boolean> {\n    return (await this.getBooleanDetails(flagKey, defaultValue, context, options)).value;\n  }\n\n  getBooleanDetails(\n    flagKey: string,\n    defaultValue: boolean,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<EvaluationDetails<boolean>> {\n    return this.evaluate<boolean>(\n      flagKey,\n      this._provider.resolveBooleanEvaluation,\n      defaultValue,\n      'boolean',\n      context,\n      options,\n    );\n  }\n\n  async getStringValue<T extends string = string>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<T> {\n    return (await this.getStringDetails<T>(flagKey, defaultValue, context, options)).value;\n  }\n\n  getStringDetails<T extends string = string>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<EvaluationDetails<T>> {\n    return this.evaluate<T>(\n      flagKey,\n      // this isolates providers from our restricted string generic argument.\n      this._provider.resolveStringEvaluation as () => Promise<EvaluationDetails<T>>,\n      defaultValue,\n      'string',\n      context,\n      options,\n    );\n  }\n\n  async getNumberValue<T extends number = number>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<T> {\n    return (await this.getNumberDetails(flagKey, defaultValue, context, options)).value;\n  }\n\n  getNumberDetails<T extends number = number>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<EvaluationDetails<T>> {\n    return this.evaluate<T>(\n      flagKey,\n      // this isolates providers from our restricted number generic argument.\n      this._provider.resolveNumberEvaluation as () => Promise<EvaluationDetails<T>>,\n      defaultValue,\n      'number',\n      context,\n      options,\n    );\n  }\n\n  async getObjectValue<T extends JsonValue = JsonValue>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<T> {\n    return (await this.getObjectDetails(flagKey, defaultValue, context, options)).value;\n  }\n\n  getObjectDetails<T extends JsonValue = JsonValue>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<EvaluationDetails<T>> {\n    return this.evaluate<T>(flagKey, this._provider.resolveObjectEvaluation, defaultValue, 'object', context, options);\n  }\n\n  private async evaluate<T extends FlagValue>(\n    flagKey: string,\n    resolver: (\n      flagKey: string,\n      defaultValue: T,\n      context: EvaluationContext,\n      logger: Logger,\n    ) => Promise<ResolutionDetails<T>>,\n    defaultValue: T,\n    flagType: FlagValueType,\n    invocationContext: EvaluationContext = {},\n    options: FlagEvaluationOptions = {},\n  ): Promise<EvaluationDetails<T>> {\n    // merge global, client, and evaluation context\n\n    const allHooks = [\n      ...OpenFeature.getHooks(),\n      ...this.getHooks(),\n      ...(options.hooks || []),\n      ...(this._provider.hooks || []),\n    ];\n    const allHooksReversed = [...allHooks].reverse();\n\n    // merge global and client contexts\n    const mergedContext = {\n      ...OpenFeature.getContext(),\n      ...OpenFeature.getTransactionContext(),\n      ...this._context,\n      ...invocationContext,\n    };\n\n    // this reference cannot change during the course of evaluation\n    // it may be used as a key in WeakMaps\n    const hookContext: Readonly<HookContext> = {\n      flagKey,\n      defaultValue,\n      flagValueType: flagType,\n      clientMetadata: this.metadata,\n      providerMetadata: OpenFeature.providerMetadata,\n      context: mergedContext,\n      logger: this._logger,\n    };\n\n    try {\n      const frozenContext = await this.beforeHooks(allHooks, hookContext, options);\n\n      // run the referenced resolver, binding the provider.\n      const resolution = await resolver.call(this._provider, flagKey, defaultValue, frozenContext, this._logger);\n\n      const evaluationDetails = {\n        ...resolution,\n        flagMetadata: Object.freeze(resolution.flagMetadata ?? {}),\n        flagKey,\n      };\n\n      await this.afterHooks(allHooksReversed, hookContext, evaluationDetails, options);\n\n      return evaluationDetails;\n    } catch (err: unknown) {\n      const errorMessage: string = (err as Error)?.message;\n      const errorCode: ErrorCode = (err as OpenFeatureError)?.code || ErrorCode.GENERAL;\n\n      await this.errorHooks(allHooksReversed, hookContext, err, options);\n\n      return {\n        errorCode,\n        errorMessage,\n        value: defaultValue,\n        reason: StandardResolutionReasons.ERROR,\n        flagMetadata: Object.freeze({}),\n        flagKey,\n      };\n    } finally {\n      await this.finallyHooks(allHooksReversed, hookContext, options);\n    }\n  }\n\n  private async beforeHooks(hooks: Hook[], hookContext: HookContext, options: FlagEvaluationOptions) {\n    for (const hook of hooks) {\n      // freeze the hookContext\n      Object.freeze(hookContext);\n\n      // use Object.assign to avoid modification of frozen hookContext\n      Object.assign(hookContext.context, {\n        ...hookContext.context,\n        ...(await hook?.before?.(hookContext, Object.freeze(options.hookHints))),\n      });\n    }\n\n    // after before hooks, freeze the EvaluationContext.\n    return Object.freeze(hookContext.context);\n  }\n\n  private async afterHooks(\n    hooks: Hook[],\n    hookContext: HookContext,\n    evaluationDetails: EvaluationDetails<FlagValue>,\n    options: FlagEvaluationOptions,\n  ) {\n    // run \"after\" hooks sequentially\n    for (const hook of hooks) {\n      await hook?.after?.(hookContext, evaluationDetails, options.hookHints);\n    }\n  }\n\n  private async errorHooks(hooks: Hook[], hookContext: HookContext, err: unknown, options: FlagEvaluationOptions) {\n    // run \"error\" hooks sequentially\n    for (const hook of hooks) {\n      try {\n        await hook?.error?.(hookContext, err, options.hookHints);\n      } catch (err) {\n        this._logger.error(`Unhandled error during 'error' hook: ${err}`);\n        if (err instanceof Error) {\n          this._logger.error(err.stack);\n        }\n        this._logger.error((err as Error)?.stack);\n      }\n    }\n  }\n\n  private async finallyHooks(hooks: Hook[], hookContext: HookContext, options: FlagEvaluationOptions) {\n    // run \"finally\" hooks sequentially\n    for (const hook of hooks) {\n      try {\n        await hook?.finally?.(hookContext, options.hookHints);\n      } catch (err) {\n        this._logger.error(`Unhandled error during 'finally' hook: ${err}`);\n        if (err instanceof Error) {\n          this._logger.error(err.stack);\n        }\n        this._logger.error((err as Error)?.stack);\n      }\n    }\n  }\n\n  private get _provider(): Provider {\n    return this.providerAccessor();\n  }\n\n  private get _logger() {\n    return this._clientLogger || this.globalLogger();\n  }\n}\n", "import { ResolutionDetails, JsonValue, ProviderStatus } from '@openfeature/core';\nimport { Provider } from './provider';\n\nconst REASON_NO_OP = 'No-op';\n\n/**\n * The No-op provider is set by default, and simply always returns the default value.\n */\nclass NoopFeatureProvider implements Provider {\n  readonly metadata = {\n    name: 'No-op Provider',\n  } as const;\n\n  get status(): ProviderStatus {\n    /**\n     * This is due to the NoopProvider not being a real provider.\n     * We do not want it to trigger the Ready event handlers, so we never set this to ready.\n     * With the NoopProvider assigned, the client can be assumed to be uninitialized.\n     * https://github.com/open-feature/js-sdk/pull/429#discussion_r1202642654\n     */\n    return ProviderStatus.NOT_READY;\n  }\n\n  resolveBooleanEvaluation(_: string, defaultValue: boolean): Promise<ResolutionDetails<boolean>> {\n    return this.noOp(defaultValue);\n  }\n\n  resolveStringEvaluation(_: string, defaultValue: string): Promise<ResolutionDetails<string>> {\n    return this.noOp(defaultValue);\n  }\n\n  resolveNumberEvaluation(_: string, defaultValue: number): Promise<ResolutionDetails<number>> {\n    return this.noOp(defaultValue);\n  }\n\n  resolveObjectEvaluation<T extends JsonValue>(_: string, defaultValue: T): Promise<ResolutionDetails<T>> {\n    return this.noOp<T>(defaultValue);\n  }\n\n  private noOp<T>(defaultValue: T) {\n    return Promise.resolve({\n      value: defaultValue,\n      reason: REASON_NO_OP,\n    });\n  }\n}\n\nexport const NOOP_PROVIDER = new NoopFeatureProvider();\n", "import {\n  EvaluationContext,\n  FlagNotFoundError,\n  FlagValueType,\n  GeneralError,\n  JsonValue,\n  Logger,\n  OpenFeatureError,\n  ResolutionDetails,\n  StandardResolutionReasons,\n  TypeMismatchError\n} from '@openfeature/core';\nimport { Provider } from '../provider';\nimport { Flag, FlagConfiguration } from './flag-configuration';\nimport { VariantFoundError } from './variant-not-found-error';\nimport { OpenFeatureEventEmitter, ProviderEvents } from '../..';\n\n/**\n * A simple OpenFeature provider intended for demos and as a test stub.\n */\nexport class InMemoryProvider implements Provider {\n  public readonly events = new OpenFeatureEventEmitter();\n  public readonly runsOn = 'server';\n  readonly metadata = {\n    name: 'in-memory',\n  } as const;\n  private _flagConfiguration: FlagConfiguration;\n\n  constructor(flagConfiguration: FlagConfiguration = {}) {\n    this._flagConfiguration = { ...flagConfiguration };\n  }\n\n  /**\n   * Overwrites the configured flags.\n   * @param { FlagConfiguration } flagConfiguration new flag configuration\n   */\n  putConfiguration(flagConfiguration: FlagConfiguration) {\n    const flagsChanged = Object.entries(flagConfiguration)\n      .filter(([key, value]) => this._flagConfiguration[key] !== value)\n      .map(([key]) => key);\n\n    this._flagConfiguration = { ...flagConfiguration };\n    this.events.emit(ProviderEvents.ConfigurationChanged, { flagsChanged });\n  }\n\n  resolveBooleanEvaluation(\n    flagKey: string,\n    defaultValue: boolean,\n    context?: EvaluationContext,\n    logger?: Logger,\n  ): Promise<ResolutionDetails<boolean>> {\n    return this.resolveFlagWithReason<boolean>(flagKey, defaultValue, context, logger);\n  }\n\n  resolveNumberEvaluation(\n    flagKey: string,\n    defaultValue: number,\n    context?: EvaluationContext,\n    logger?: Logger,\n  ): Promise<ResolutionDetails<number>> {\n    return this.resolveFlagWithReason<number>(flagKey, defaultValue, context, logger);\n  }\n\n  async resolveStringEvaluation(\n    flagKey: string,\n    defaultValue: string,\n    context?: EvaluationContext,\n    logger?: Logger,\n  ): Promise<ResolutionDetails<string>> {\n    return this.resolveFlagWithReason<string>(flagKey, defaultValue, context, logger);\n  }\n\n  async resolveObjectEvaluation<T extends JsonValue>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    logger?: Logger,\n  ): Promise<ResolutionDetails<T>> {\n    return this.resolveFlagWithReason<T>(flagKey, defaultValue, context, logger);\n  }\n\n  private async resolveFlagWithReason<T extends JsonValue | FlagValueType>(\n    flagKey: string,\n    defaultValue: T,\n    ctx?: EvaluationContext,\n    logger?: Logger,\n  ): Promise<ResolutionDetails<T>> {\n    try {\n      const resolutionResult = this.lookupFlagValue(flagKey, defaultValue, ctx, logger);\n\n      if (typeof resolutionResult?.value != typeof defaultValue) {\n        throw new TypeMismatchError();\n      }\n\n      return resolutionResult;\n    } catch (error: unknown) {\n      if (!(error instanceof OpenFeatureError)) {\n        throw new GeneralError((error as Error)?.message || 'unknown error'); \n      }\n      throw error;\n    }\n  }\n\n  private lookupFlagValue<T extends JsonValue | FlagValueType>(\n    flagKey: string,\n    defaultValue: T,\n    ctx?: EvaluationContext,\n    logger?: Logger,\n  ): ResolutionDetails<T> {\n    if (!(flagKey in this._flagConfiguration)) {\n      const message = `no flag found with key ${flagKey}`;\n      logger?.debug(message);\n      throw new FlagNotFoundError(message);\n    }\n    const flagSpec: Flag = this._flagConfiguration[flagKey];\n\n    if (flagSpec.disabled) {\n      return { value: defaultValue, reason: StandardResolutionReasons.DISABLED };\n    }\n\n    const isContextEval = ctx && flagSpec?.contextEvaluator;\n    const variant = isContextEval ? flagSpec.contextEvaluator?.(ctx) : flagSpec.defaultVariant;\n\n    const value = variant && flagSpec?.variants[variant];\n\n    if (value === undefined) {\n      const message = `no value associated with variant ${variant}`;\n      logger?.error(message);\n      throw new VariantFoundError(message);\n    }\n\n    return {\n      value: value as T,\n      ...(variant && { variant }),\n      reason: isContextEval ? StandardResolutionReasons.TARGETING_MATCH : StandardResolutionReasons.STATIC,\n    };\n  }\n}\n", "import { ErrorCode, OpenFeatureError } from '@openfeature/core';\n\n/**\n * A custom error for the in-memory provider.\n * Indicates the resolved or default variant doesn't exist.\n */\nexport class VariantFoundError extends OpenFeatureError {\n  code: ErrorCode;\n  constructor(message?: string) {\n    super(message);\n    Object.setPrototypeOf(this, VariantFoundError.prototype);\n    this.name = 'VariantFoundError';\n    this.code = ErrorCode.GENERAL;\n  }\n}\n", "import { NOOP_PROVIDER, Provider } from './provider';\nimport {\n  ManageContext,\n  OpenFeatureCommonAPI,\n  EvaluationContext,\n  objectOrUndefined,\n  stringOrUndefined,\n} from '@openfeature/core';\nimport {\n  ManageTransactionContextPropagator,\n  NOOP_TRANSACTION_CONTEXT_PROPAGATOR,\n  TransactionContext,\n  TransactionContextPropagator,\n} from './transaction-context';\nimport { Client, OpenFeatureClient } from './client';\nimport { OpenFeatureEventEmitter } from './events';\nimport { Hook } from './hooks';\n\n// use a symbol as a key for the global singleton\nconst GLOBAL_OPENFEATURE_API_KEY = Symbol.for('@openfeature/js-sdk/api');\n\ntype OpenFeatureGlobal = {\n  [GLOBAL_OPENFEATURE_API_KEY]?: OpenFeatureAPI;\n};\nconst _globalThis = globalThis as OpenFeatureGlobal;\n\nexport class OpenFeatureAPI\n  extends OpenFeatureCommonAPI<Provider, Hook>\n  implements ManageContext<OpenFeatureAPI>, ManageTransactionContextPropagator<OpenFeatureCommonAPI<Provider>>\n{\n  protected _events = new OpenFeatureEventEmitter();\n  protected _defaultProvider: Provider = NOOP_PROVIDER;\n  protected _createEventEmitter = () => new OpenFeatureEventEmitter();\n\n  private _transactionContextPropagator: TransactionContextPropagator = NOOP_TRANSACTION_CONTEXT_PROPAGATOR;\n\n  private constructor() {\n    super('server');\n  }\n\n  /**\n   * Gets a singleton instance of the OpenFeature API.\n   * @ignore\n   * @returns {OpenFeatureAPI} OpenFeature API\n   */\n  static getInstance(): OpenFeatureAPI {\n    const globalApi = _globalThis[GLOBAL_OPENFEATURE_API_KEY];\n    if (globalApi) {\n      return globalApi;\n    }\n\n    const instance = new OpenFeatureAPI();\n    _globalThis[GLOBAL_OPENFEATURE_API_KEY] = instance;\n    return instance;\n  }\n\n  setContext(context: EvaluationContext): this {\n    this._context = context;\n    return this;\n  }\n\n  getContext(): EvaluationContext {\n    return this._context;\n  }\n\n  /**\n   * A factory function for creating new domainless OpenFeature clients.\n   * Clients can contain their own state (e.g. logger, hook, context).\n   * Multiple clients can be used to segment feature flag configuration.\n   *\n   * All domainless or unbound clients use the default provider set via {@link this.setProvider setProvider}.\n   * @param {EvaluationContext} context Evaluation context that should be set on the client to used during flag evaluations\n   * @returns {Client} OpenFeature Client\n   */\n  getClient(context?: EvaluationContext): Client;\n  /**\n   * A factory function for creating new domain scoped OpenFeature clients.\n   * Clients can contain their own state (e.g. logger, hook, context).\n   * Multiple clients can be used to segment feature flag configuration.\n   *\n   * If there is already a provider bound to this domain via {@link this.setProvider setProvider}, this provider will be used.\n   * Otherwise, the default provider is used until a provider is assigned to that domain.\n   * @param {string} domain An identifier which logically binds clients with providers\n   * @param {EvaluationContext} context Evaluation context that should be set on the client to used during flag evaluations\n   * @returns {Client} OpenFeature Client\n   */\n  getClient(domain: string, context?: EvaluationContext): Client;\n  /**\n   * A factory function for creating new domain scoped OpenFeature clients.\n   * Clients can contain their own state (e.g. logger, hook, context).\n   * Multiple clients can be used to segment feature flag configuration.\n   *\n   * If there is already a provider bound to this domain via {@link this.setProvider setProvider}, this provider will be used.\n   * Otherwise, the default provider is used until a provider is assigned to that domain.\n   * @param {string} domain An identifier which logically binds clients with providers\n   * @param {string} version The version of the client (only used for metadata)\n   * @param {EvaluationContext} context Evaluation context that should be set on the client to used during flag evaluations\n   * @returns {Client} OpenFeature Client\n   */\n  getClient(domain: string, version: string, context?: EvaluationContext): Client;\n  getClient(\n    domainOrContext?: string | EvaluationContext,\n    versionOrContext?: string | EvaluationContext,\n    contextOrUndefined?: EvaluationContext,\n  ): Client {\n    const domain = stringOrUndefined(domainOrContext);\n    const version = stringOrUndefined(versionOrContext);\n    const context =\n      objectOrUndefined<EvaluationContext>(domainOrContext) ??\n      objectOrUndefined<EvaluationContext>(versionOrContext) ??\n      objectOrUndefined<EvaluationContext>(contextOrUndefined);\n\n    return new OpenFeatureClient(\n      () => this.getProviderForClient(domain),\n      () => this.buildAndCacheEventEmitterForClient(domain),\n      () => this._logger,\n      { domain, version },\n      context,\n    );\n  }\n\n  /**\n   * Clears all registered providers and resets the default provider.\n   * @returns {Promise<void>}\n   */\n  clearProviders(): Promise<void> {\n    return super.clearProvidersAndSetDefault(NOOP_PROVIDER);\n  }\n\n  setTransactionContextPropagator(\n    transactionContextPropagator: TransactionContextPropagator,\n  ): OpenFeatureCommonAPI<Provider> {\n    const baseMessage = 'Invalid TransactionContextPropagator, will not be set: ';\n    if (typeof transactionContextPropagator?.getTransactionContext !== 'function') {\n      this._logger.error(`${baseMessage}: getTransactionContext is not a function.`);\n    } else if (typeof transactionContextPropagator?.setTransactionContext !== 'function') {\n      this._logger.error(`${baseMessage}: setTransactionContext is not a function.`);\n    } else {\n      this._transactionContextPropagator = transactionContextPropagator;\n    }\n    return this;\n  }\n\n  setTransactionContext<R>(\n    transactionContext: TransactionContext,\n    callback: (...args: unknown[]) => R,\n    ...args: unknown[]\n  ): void {\n    this._transactionContextPropagator.setTransactionContext(transactionContext, callback, ...args);\n  }\n\n  getTransactionContext(): TransactionContext {\n    try {\n      return this._transactionContextPropagator.getTransactionContext();\n    } catch (err: unknown) {\n      const error = err as Error | undefined;\n      this._logger.error(`Error getting transaction context: ${error?.message}, returning empty context.`);\n      this._logger.error(error?.stack);\n      return {};\n    }\n  }\n}\n\n/**\n * A singleton instance of the OpenFeature API.\n * @returns {OpenFeatureAPI} OpenFeature API\n */\nexport const OpenFeature = OpenFeatureAPI.getInstance();\n", "import { EvaluationContext } from '@openfeature/core';\nimport { TransactionContextPropagator } from './transaction-context';\n\nclass NoopTransactionContextPropagator implements TransactionContextPropagator {\n  getTransactionContext(): EvaluationContext {\n    return {};\n  }\n\n  setTransactionContext(_: EvaluationContext, callback: () => void): void {\n    callback();\n  }\n}\n\nexport const NOOP_TRANSACTION_CONTEXT_PROPAGATOR = new NoopTransactionContextPropagator();\n", "import { GenericEventEmitter } from '@openfeature/core';\nimport EventEmitter from 'events';\nimport { ProviderEvents } from './events';\n\n/**\n * The OpenFeatureEventEmitter can be used by provider developers to emit\n * events at various parts of the provider lifecycle.\n * \n * NOTE: Ready and error events are automatically emitted by the SDK based on\n * the result of the initialize method.\n */\nexport class OpenFeatureEventEmitter extends GenericEventEmitter<ProviderEvents> {\n  protected readonly eventEmitter = new EventEmitter({ captureRejections: true });\n\n   constructor() {\n      super();\n      this.eventEmitter.on('error', (err) => {\n        this._logger?.error('Error running event handler:', err);\n      });\n    }\n};", "import { ServerProviderEvents } from '@openfeature/core';\n\nexport { ServerProviderEvents as ProviderEvents };", "export * from './client';\nexport * from './provider';\nexport * from './evaluation';\nexport * from './open-feature';\nexport * from './transaction-context';\nexport * from './events';\nexport * from './hooks';\nexport * from '@openfeature/core';\n"],
-  "mappings": "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",
+  "sources": ["../../src/client/open-feature-client.ts", "../../src/open-feature.ts", "../../src/events/open-feature-event-emitter.ts", "../../src/events/events.ts", "../../src/provider/provider.ts", "../../src/provider/no-op-provider.ts", "../../src/provider/in-memory-provider/in-memory-provider.ts", "../../src/provider/in-memory-provider/variant-not-found-error.ts", "../../src/transaction-context/no-op-transaction-context-propagator.ts", "../../src/transaction-context/async-local-storage-transaction-context-propagator.ts", "../../src/index.ts"],
+  "sourcesContent": ["import {\n  ClientMetadata,\n  ErrorCode,\n  EvaluationContext,\n  EvaluationDetails,\n  EventHandler,\n  FlagValue,\n  FlagValueType,\n  HookContext,\n  JsonValue,\n  Logger,\n  ManageContext,\n  OpenFeatureError,\n  ProviderFatalError,\n  ProviderNotReadyError,\n  ResolutionDetails,\n  SafeLogger,\n  StandardResolutionReasons,\n  statusMatchesEvent,\n} from '@openfeature/core';\nimport { FlagEvaluationOptions } from '../evaluation';\nimport { ProviderEvents } from '../events';\nimport { InternalEventEmitter } from '../events/internal/internal-event-emitter';\nimport { Hook } from '../hooks';\nimport { OpenFeature } from '../open-feature';\nimport { Provider, ProviderStatus } from '../provider';\nimport { Client } from './client';\n\ntype OpenFeatureClientOptions = {\n  /**\n   * @deprecated Use `domain` instead.\n   */\n  name?: string;\n  domain?: string;\n  version?: string;\n};\n\nexport class OpenFeatureClient implements Client, ManageContext<OpenFeatureClient> {\n  private _context: EvaluationContext;\n  private _hooks: Hook[] = [];\n  private _clientLogger?: Logger;\n\n  constructor(\n    // we always want the client to use the current provider,\n    // so pass a function to always access the currently registered one.\n    private readonly providerAccessor: () => Provider,\n    private readonly providerStatusAccessor: () => ProviderStatus,\n    private readonly emitterAccessor: () => InternalEventEmitter,\n    private readonly globalLogger: () => Logger,\n    private readonly options: OpenFeatureClientOptions,\n    context: EvaluationContext = {},\n  ) {\n    this._context = context;\n  }\n\n  get metadata(): ClientMetadata {\n    return {\n      // Use domain if name is not provided\n      name: this.options.domain ?? this.options.name,\n      domain: this.options.domain ?? this.options.name,\n      version: this.options.version,\n      providerMetadata: this.providerAccessor().metadata,\n    };\n  }\n\n  get providerStatus(): ProviderStatus {\n    return this.providerStatusAccessor();\n  }\n\n  addHandler(eventType: ProviderEvents, handler: EventHandler): void {\n    this.emitterAccessor().addHandler(eventType, handler);\n    const shouldRunNow = statusMatchesEvent(eventType, this._providerStatus);\n\n    if (shouldRunNow) {\n      // run immediately, we're in the matching state\n      try {\n        handler({\n          clientName: this.metadata.name,\n          domain: this.metadata.domain,\n          providerName: this._provider.metadata.name,\n        });\n      } catch (err) {\n        this._logger?.error('Error running event handler:', err);\n      }\n    }\n  }\n\n  removeHandler(eventType: ProviderEvents, handler: EventHandler) {\n    this.emitterAccessor().removeHandler(eventType, handler);\n  }\n\n  getHandlers(eventType: ProviderEvents) {\n    return this.emitterAccessor().getHandlers(eventType);\n  }\n\n  setLogger(logger: Logger): OpenFeatureClient {\n    this._clientLogger = new SafeLogger(logger);\n    return this;\n  }\n\n  setContext(context: EvaluationContext): OpenFeatureClient {\n    this._context = context;\n    return this;\n  }\n\n  getContext(): EvaluationContext {\n    return this._context;\n  }\n\n  addHooks(...hooks: Hook[]): OpenFeatureClient {\n    this._hooks = [...this._hooks, ...hooks];\n    return this;\n  }\n\n  getHooks(): Hook[] {\n    return this._hooks;\n  }\n\n  clearHooks(): OpenFeatureClient {\n    this._hooks = [];\n    return this;\n  }\n\n  async getBooleanValue(\n    flagKey: string,\n    defaultValue: boolean,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<boolean> {\n    return (await this.getBooleanDetails(flagKey, defaultValue, context, options)).value;\n  }\n\n  getBooleanDetails(\n    flagKey: string,\n    defaultValue: boolean,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<EvaluationDetails<boolean>> {\n    return this.evaluate<boolean>(\n      flagKey,\n      this._provider.resolveBooleanEvaluation,\n      defaultValue,\n      'boolean',\n      context,\n      options,\n    );\n  }\n\n  async getStringValue<T extends string = string>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<T> {\n    return (await this.getStringDetails<T>(flagKey, defaultValue, context, options)).value;\n  }\n\n  getStringDetails<T extends string = string>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<EvaluationDetails<T>> {\n    return this.evaluate<T>(\n      flagKey,\n      // this isolates providers from our restricted string generic argument.\n      this._provider.resolveStringEvaluation as () => Promise<EvaluationDetails<T>>,\n      defaultValue,\n      'string',\n      context,\n      options,\n    );\n  }\n\n  async getNumberValue<T extends number = number>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<T> {\n    return (await this.getNumberDetails(flagKey, defaultValue, context, options)).value;\n  }\n\n  getNumberDetails<T extends number = number>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<EvaluationDetails<T>> {\n    return this.evaluate<T>(\n      flagKey,\n      // this isolates providers from our restricted number generic argument.\n      this._provider.resolveNumberEvaluation as () => Promise<EvaluationDetails<T>>,\n      defaultValue,\n      'number',\n      context,\n      options,\n    );\n  }\n\n  async getObjectValue<T extends JsonValue = JsonValue>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<T> {\n    return (await this.getObjectDetails(flagKey, defaultValue, context, options)).value;\n  }\n\n  getObjectDetails<T extends JsonValue = JsonValue>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    options?: FlagEvaluationOptions,\n  ): Promise<EvaluationDetails<T>> {\n    return this.evaluate<T>(flagKey, this._provider.resolveObjectEvaluation, defaultValue, 'object', context, options);\n  }\n\n  private async evaluate<T extends FlagValue>(\n    flagKey: string,\n    resolver: (\n      flagKey: string,\n      defaultValue: T,\n      context: EvaluationContext,\n      logger: Logger,\n    ) => Promise<ResolutionDetails<T>>,\n    defaultValue: T,\n    flagType: FlagValueType,\n    invocationContext: EvaluationContext = {},\n    options: FlagEvaluationOptions = {},\n  ): Promise<EvaluationDetails<T>> {\n    // merge global, client, and evaluation context\n\n    const allHooks = [\n      ...OpenFeature.getHooks(),\n      ...this.getHooks(),\n      ...(options.hooks || []),\n      ...(this._provider.hooks || []),\n    ];\n    const allHooksReversed = [...allHooks].reverse();\n\n    // merge global and client contexts\n    const mergedContext = {\n      ...OpenFeature.getContext(),\n      ...OpenFeature.getTransactionContext(),\n      ...this._context,\n      ...invocationContext,\n    };\n\n    // this reference cannot change during the course of evaluation\n    // it may be used as a key in WeakMaps\n    const hookContext: Readonly<HookContext> = {\n      flagKey,\n      defaultValue,\n      flagValueType: flagType,\n      clientMetadata: this.metadata,\n      providerMetadata: OpenFeature.providerMetadata,\n      context: mergedContext,\n      logger: this._logger,\n    };\n\n    try {\n      const frozenContext = await this.beforeHooks(allHooks, hookContext, options);\n\n      // short circuit evaluation entirely if provider is in a bad state\n      if (this.providerStatus === ProviderStatus.NOT_READY) {\n        throw new ProviderNotReadyError('provider has not yet initialized');\n      } else if (this.providerStatus === ProviderStatus.FATAL) {\n        throw new ProviderFatalError('provider is in an irrecoverable error state');\n      }\n\n      // run the referenced resolver, binding the provider.\n      const resolution = await resolver.call(this._provider, flagKey, defaultValue, frozenContext, this._logger);\n\n      const evaluationDetails = {\n        ...resolution,\n        flagMetadata: Object.freeze(resolution.flagMetadata ?? {}),\n        flagKey,\n      };\n\n      await this.afterHooks(allHooksReversed, hookContext, evaluationDetails, options);\n\n      return evaluationDetails;\n    } catch (err: unknown) {\n      const errorMessage: string = (err as Error)?.message;\n      const errorCode: ErrorCode = (err as OpenFeatureError)?.code || ErrorCode.GENERAL;\n\n      await this.errorHooks(allHooksReversed, hookContext, err, options);\n\n      return {\n        errorCode,\n        errorMessage,\n        value: defaultValue,\n        reason: StandardResolutionReasons.ERROR,\n        flagMetadata: Object.freeze({}),\n        flagKey,\n      };\n    } finally {\n      await this.finallyHooks(allHooksReversed, hookContext, options);\n    }\n  }\n\n  private async beforeHooks(hooks: Hook[], hookContext: HookContext, options: FlagEvaluationOptions) {\n    for (const hook of hooks) {\n      // freeze the hookContext\n      Object.freeze(hookContext);\n\n      // use Object.assign to avoid modification of frozen hookContext\n      Object.assign(hookContext.context, {\n        ...hookContext.context,\n        ...(await hook?.before?.(hookContext, Object.freeze(options.hookHints))),\n      });\n    }\n\n    // after before hooks, freeze the EvaluationContext.\n    return Object.freeze(hookContext.context);\n  }\n\n  private async afterHooks(\n    hooks: Hook[],\n    hookContext: HookContext,\n    evaluationDetails: EvaluationDetails<FlagValue>,\n    options: FlagEvaluationOptions,\n  ) {\n    // run \"after\" hooks sequentially\n    for (const hook of hooks) {\n      await hook?.after?.(hookContext, evaluationDetails, options.hookHints);\n    }\n  }\n\n  private async errorHooks(hooks: Hook[], hookContext: HookContext, err: unknown, options: FlagEvaluationOptions) {\n    // run \"error\" hooks sequentially\n    for (const hook of hooks) {\n      try {\n        await hook?.error?.(hookContext, err, options.hookHints);\n      } catch (err) {\n        this._logger.error(`Unhandled error during 'error' hook: ${err}`);\n        if (err instanceof Error) {\n          this._logger.error(err.stack);\n        }\n        this._logger.error((err as Error)?.stack);\n      }\n    }\n  }\n\n  private async finallyHooks(hooks: Hook[], hookContext: HookContext, options: FlagEvaluationOptions) {\n    // run \"finally\" hooks sequentially\n    for (const hook of hooks) {\n      try {\n        await hook?.finally?.(hookContext, options.hookHints);\n      } catch (err) {\n        this._logger.error(`Unhandled error during 'finally' hook: ${err}`);\n        if (err instanceof Error) {\n          this._logger.error(err.stack);\n        }\n        this._logger.error((err as Error)?.stack);\n      }\n    }\n  }\n\n  private get _provider(): Provider {\n    return this.providerAccessor();\n  }\n\n  private get _providerStatus(): ProviderStatus {\n    return this.providerStatusAccessor();\n  }\n\n  private get _logger() {\n    return this._clientLogger || this.globalLogger();\n  }\n}\n", "import {\n  EvaluationContext,\n  ManageContext,\n  OpenFeatureCommonAPI,\n  ProviderWrapper,\n  objectOrUndefined,\n  stringOrUndefined,\n} from '@openfeature/core';\nimport { Client, OpenFeatureClient } from './client';\nimport { OpenFeatureEventEmitter } from './events';\nimport { Hook } from './hooks';\nimport { NOOP_PROVIDER, Provider, ProviderStatus } from './provider';\nimport {\n  ManageTransactionContextPropagator,\n  NOOP_TRANSACTION_CONTEXT_PROPAGATOR,\n  TransactionContext,\n  TransactionContextPropagator,\n} from './transaction-context';\nimport { ServerProviderStatus } from '@openfeature/core';\n\n// use a symbol as a key for the global singleton\nconst GLOBAL_OPENFEATURE_API_KEY = Symbol.for('@openfeature/js-sdk/api');\n\ntype OpenFeatureGlobal = {\n  [GLOBAL_OPENFEATURE_API_KEY]?: OpenFeatureAPI;\n};\nconst _globalThis = globalThis as OpenFeatureGlobal;\n\nexport class OpenFeatureAPI\n  extends OpenFeatureCommonAPI<ServerProviderStatus, Provider, Hook>\n  implements ManageContext<OpenFeatureAPI>, ManageTransactionContextPropagator<OpenFeatureCommonAPI<ServerProviderStatus, Provider>>\n{\n  protected _statusEnumType: typeof ProviderStatus = ProviderStatus;\n  protected _apiEmitter = new OpenFeatureEventEmitter();\n  protected _defaultProvider: ProviderWrapper<Provider, ServerProviderStatus> = new ProviderWrapper(NOOP_PROVIDER, ProviderStatus.NOT_READY, this._statusEnumType);\n  protected _domainScopedProviders: Map<string, ProviderWrapper<Provider, ServerProviderStatus>> = new Map();\n  protected _createEventEmitter = () => new OpenFeatureEventEmitter();\n\n  private _transactionContextPropagator: TransactionContextPropagator = NOOP_TRANSACTION_CONTEXT_PROPAGATOR;\n\n  private constructor() {\n    super('server');\n  }\n\n  /**\n   * Gets a singleton instance of the OpenFeature API.\n   * @ignore\n   * @returns {OpenFeatureAPI} OpenFeature API\n   */\n  static getInstance(): OpenFeatureAPI {\n    const globalApi = _globalThis[GLOBAL_OPENFEATURE_API_KEY];\n    if (globalApi) {\n      return globalApi;\n    }\n\n    const instance = new OpenFeatureAPI();\n    _globalThis[GLOBAL_OPENFEATURE_API_KEY] = instance;\n    return instance;\n  }\n\n  private getProviderStatus(domain?: string): ProviderStatus {\n    if (!domain) {\n      return this._defaultProvider.status;\n    }\n\n    return this._domainScopedProviders.get(domain)?.status ?? this._defaultProvider.status;\n  }\n\n  setContext(context: EvaluationContext): this {\n    this._context = context;\n    return this;\n  }\n\n  getContext(): EvaluationContext {\n    return this._context;\n  }\n\n  /**\n   * A factory function for creating new domainless OpenFeature clients.\n   * Clients can contain their own state (e.g. logger, hook, context).\n   * Multiple clients can be used to segment feature flag configuration.\n   *\n   * All domainless or unbound clients use the default provider set via {@link this.setProvider setProvider}.\n   * @param {EvaluationContext} context Evaluation context that should be set on the client to used during flag evaluations\n   * @returns {Client} OpenFeature Client\n   */\n  getClient(context?: EvaluationContext): Client;\n  /**\n   * A factory function for creating new domain scoped OpenFeature clients.\n   * Clients can contain their own state (e.g. logger, hook, context).\n   * Multiple clients can be used to segment feature flag configuration.\n   *\n   * If there is already a provider bound to this domain via {@link this.setProvider setProvider}, this provider will be used.\n   * Otherwise, the default provider is used until a provider is assigned to that domain.\n   * @param {string} domain An identifier which logically binds clients with providers\n   * @param {EvaluationContext} context Evaluation context that should be set on the client to used during flag evaluations\n   * @returns {Client} OpenFeature Client\n   */\n  getClient(domain: string, context?: EvaluationContext): Client;\n  /**\n   * A factory function for creating new domain scoped OpenFeature clients.\n   * Clients can contain their own state (e.g. logger, hook, context).\n   * Multiple clients can be used to segment feature flag configuration.\n   *\n   * If there is already a provider bound to this domain via {@link this.setProvider setProvider}, this provider will be used.\n   * Otherwise, the default provider is used until a provider is assigned to that domain.\n   * @param {string} domain An identifier which logically binds clients with providers\n   * @param {string} version The version of the client (only used for metadata)\n   * @param {EvaluationContext} context Evaluation context that should be set on the client to used during flag evaluations\n   * @returns {Client} OpenFeature Client\n   */\n  getClient(domain: string, version: string, context?: EvaluationContext): Client;\n  getClient(\n    domainOrContext?: string | EvaluationContext,\n    versionOrContext?: string | EvaluationContext,\n    contextOrUndefined?: EvaluationContext,\n  ): Client {\n    const domain = stringOrUndefined(domainOrContext);\n    const version = stringOrUndefined(versionOrContext);\n    const context =\n      objectOrUndefined<EvaluationContext>(domainOrContext) ??\n      objectOrUndefined<EvaluationContext>(versionOrContext) ??\n      objectOrUndefined<EvaluationContext>(contextOrUndefined);\n\n    return new OpenFeatureClient(\n      () => this.getProviderForClient(domain),\n      () => this.getProviderStatus(domain),\n      () => this.buildAndCacheEventEmitterForClient(domain),\n      () => this._logger,\n      { domain, version },\n      context,\n    );\n  }\n\n  /**\n   * Clears all registered providers and resets the default provider.\n   * @returns {Promise<void>}\n   */\n  clearProviders(): Promise<void> {\n    return super.clearProvidersAndSetDefault(NOOP_PROVIDER);\n  }\n\n  setTransactionContextPropagator(\n    transactionContextPropagator: TransactionContextPropagator,\n  ): OpenFeatureCommonAPI<ServerProviderStatus, Provider> {\n    const baseMessage = 'Invalid TransactionContextPropagator, will not be set: ';\n    if (typeof transactionContextPropagator?.getTransactionContext !== 'function') {\n      this._logger.error(`${baseMessage}: getTransactionContext is not a function.`);\n    } else if (typeof transactionContextPropagator?.setTransactionContext !== 'function') {\n      this._logger.error(`${baseMessage}: setTransactionContext is not a function.`);\n    } else {\n      this._transactionContextPropagator = transactionContextPropagator;\n    }\n    return this;\n  }\n\n  setTransactionContext<TArgs extends unknown[], R>(\n    transactionContext: TransactionContext,\n    callback: (...args: TArgs) => R,\n    ...args: TArgs\n  ): void {\n    this._transactionContextPropagator.setTransactionContext(transactionContext, callback, ...args);\n  }\n\n  getTransactionContext(): TransactionContext {\n    try {\n      return this._transactionContextPropagator.getTransactionContext();\n    } catch (err: unknown) {\n      const error = err as Error | undefined;\n      this._logger.error(`Error getting transaction context: ${error?.message}, returning empty context.`);\n      this._logger.error(error?.stack);\n      return {};\n    }\n  }\n}\n\n/**\n * A singleton instance of the OpenFeature API.\n * @returns {OpenFeatureAPI} OpenFeature API\n */\nexport const OpenFeature = OpenFeatureAPI.getInstance();\n", "import { GenericEventEmitter } from '@openfeature/core';\nimport { EventEmitter } from 'node:events';\nimport { ProviderEvents } from './events';\n\n/**\n * The OpenFeatureEventEmitter can be used by provider developers to emit\n * events at various parts of the provider lifecycle.\n * \n * NOTE: Ready and error events are automatically emitted by the SDK based on\n * the result of the initialize method.\n */\nexport class OpenFeatureEventEmitter extends GenericEventEmitter<ProviderEvents> {\n  protected readonly eventEmitter = new EventEmitter({ captureRejections: true });\n\n   constructor() {\n      super();\n      this.eventEmitter.on('error', (err) => {\n        this._logger?.error('Error running event handler:', err);\n      });\n    }\n};", "import { ServerProviderEvents } from '@openfeature/core';\n\nexport { ServerProviderEvents as ProviderEvents };", "import { CommonProvider, EvaluationContext, JsonValue, Logger, ResolutionDetails, ServerProviderStatus } from '@openfeature/core';\nimport { Hook } from '../hooks';\n\nexport { ServerProviderStatus as ProviderStatus };\n\n/**\n * Interface that providers must implement to resolve flag values for their particular\n * backend or vendor.\n *\n * Implementation for resolving all the required flag types must be defined.\n */\nexport interface Provider extends CommonProvider<ServerProviderStatus> {\n  /**\n   * A provider hook exposes a mechanism for provider authors to register hooks\n   * to tap into various stages of the flag evaluation lifecycle. These hooks can\n   * be used to perform side effects and mutate the context for purposes of the\n   * provider. Provider hooks are not configured or controlled by the application author.\n   */\n  readonly hooks?: Hook[];\n\n  /**\n   * Resolve a boolean flag and its evaluation details.\n   */\n  resolveBooleanEvaluation(\n    flagKey: string,\n    defaultValue: boolean,\n    context: EvaluationContext,\n    logger: Logger,\n  ): Promise<ResolutionDetails<boolean>>;\n\n  /**\n   * Resolve a string flag and its evaluation details.\n   */\n  resolveStringEvaluation(\n    flagKey: string,\n    defaultValue: string,\n    context: EvaluationContext,\n    logger: Logger,\n  ): Promise<ResolutionDetails<string>>;\n\n  /**\n   * Resolve a numeric flag and its evaluation details.\n   */\n  resolveNumberEvaluation(\n    flagKey: string,\n    defaultValue: number,\n    context: EvaluationContext,\n    logger: Logger,\n  ): Promise<ResolutionDetails<number>>;\n\n  /**\n   * Resolve and parse an object flag and its evaluation details.\n   */\n  resolveObjectEvaluation<T extends JsonValue>(\n    flagKey: string,\n    defaultValue: T,\n    context: EvaluationContext,\n    logger: Logger,\n  ): Promise<ResolutionDetails<T>>;\n}\n", "import { JsonValue, ResolutionDetails } from '@openfeature/core';\nimport { Provider } from './provider';\n\nconst REASON_NO_OP = 'No-op';\n\n/**\n * The No-op provider is set by default, and simply always returns the default value.\n */\nclass NoopFeatureProvider implements Provider {\n  readonly metadata = {\n    name: 'No-op Provider',\n  } as const;\n\n  resolveBooleanEvaluation(_: string, defaultValue: boolean): Promise<ResolutionDetails<boolean>> {\n    return this.noOp(defaultValue);\n  }\n\n  resolveStringEvaluation(_: string, defaultValue: string): Promise<ResolutionDetails<string>> {\n    return this.noOp(defaultValue);\n  }\n\n  resolveNumberEvaluation(_: string, defaultValue: number): Promise<ResolutionDetails<number>> {\n    return this.noOp(defaultValue);\n  }\n\n  resolveObjectEvaluation<T extends JsonValue>(_: string, defaultValue: T): Promise<ResolutionDetails<T>> {\n    return this.noOp<T>(defaultValue);\n  }\n\n  private noOp<T>(defaultValue: T) {\n    return Promise.resolve({\n      value: defaultValue,\n      reason: REASON_NO_OP,\n    });\n  }\n}\n\nexport const NOOP_PROVIDER = new NoopFeatureProvider();\n", "import {\n  EvaluationContext,\n  FlagNotFoundError,\n  FlagValueType,\n  GeneralError,\n  JsonValue,\n  Logger,\n  OpenFeatureError,\n  ResolutionDetails,\n  StandardResolutionReasons,\n  TypeMismatchError\n} from '@openfeature/core';\nimport { Provider } from '../provider';\nimport { Flag, FlagConfiguration } from './flag-configuration';\nimport { VariantFoundError } from './variant-not-found-error';\nimport { OpenFeatureEventEmitter, ProviderEvents } from '../..';\n\n/**\n * A simple OpenFeature provider intended for demos and as a test stub.\n */\nexport class InMemoryProvider implements Provider {\n  public readonly events = new OpenFeatureEventEmitter();\n  public readonly runsOn = 'server';\n  readonly metadata = {\n    name: 'in-memory',\n  } as const;\n  private _flagConfiguration: FlagConfiguration;\n\n  constructor(flagConfiguration: FlagConfiguration = {}) {\n    this._flagConfiguration = { ...flagConfiguration };\n  }\n\n  /**\n   * Overwrites the configured flags.\n   * @param { FlagConfiguration } flagConfiguration new flag configuration\n   */\n  putConfiguration(flagConfiguration: FlagConfiguration) {\n    const flagsChanged = Object.entries(flagConfiguration)\n      .filter(([key, value]) => this._flagConfiguration[key] !== value)\n      .map(([key]) => key);\n\n    this._flagConfiguration = { ...flagConfiguration };\n    this.events.emit(ProviderEvents.ConfigurationChanged, { flagsChanged });\n  }\n\n  resolveBooleanEvaluation(\n    flagKey: string,\n    defaultValue: boolean,\n    context?: EvaluationContext,\n    logger?: Logger,\n  ): Promise<ResolutionDetails<boolean>> {\n    return this.resolveFlagWithReason<boolean>(flagKey, defaultValue, context, logger);\n  }\n\n  resolveNumberEvaluation(\n    flagKey: string,\n    defaultValue: number,\n    context?: EvaluationContext,\n    logger?: Logger,\n  ): Promise<ResolutionDetails<number>> {\n    return this.resolveFlagWithReason<number>(flagKey, defaultValue, context, logger);\n  }\n\n  async resolveStringEvaluation(\n    flagKey: string,\n    defaultValue: string,\n    context?: EvaluationContext,\n    logger?: Logger,\n  ): Promise<ResolutionDetails<string>> {\n    return this.resolveFlagWithReason<string>(flagKey, defaultValue, context, logger);\n  }\n\n  async resolveObjectEvaluation<T extends JsonValue>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n    logger?: Logger,\n  ): Promise<ResolutionDetails<T>> {\n    return this.resolveFlagWithReason<T>(flagKey, defaultValue, context, logger);\n  }\n\n  private async resolveFlagWithReason<T extends JsonValue | FlagValueType>(\n    flagKey: string,\n    defaultValue: T,\n    ctx?: EvaluationContext,\n    logger?: Logger,\n  ): Promise<ResolutionDetails<T>> {\n    try {\n      const resolutionResult = this.lookupFlagValue(flagKey, defaultValue, ctx, logger);\n\n      if (typeof resolutionResult?.value != typeof defaultValue) {\n        throw new TypeMismatchError();\n      }\n\n      return resolutionResult;\n    } catch (error: unknown) {\n      if (!(error instanceof OpenFeatureError)) {\n        throw new GeneralError((error as Error)?.message || 'unknown error'); \n      }\n      throw error;\n    }\n  }\n\n  private lookupFlagValue<T extends JsonValue | FlagValueType>(\n    flagKey: string,\n    defaultValue: T,\n    ctx?: EvaluationContext,\n    logger?: Logger,\n  ): ResolutionDetails<T> {\n    if (!(flagKey in this._flagConfiguration)) {\n      const message = `no flag found with key ${flagKey}`;\n      logger?.debug(message);\n      throw new FlagNotFoundError(message);\n    }\n    const flagSpec: Flag = this._flagConfiguration[flagKey];\n\n    if (flagSpec.disabled) {\n      return { value: defaultValue, reason: StandardResolutionReasons.DISABLED };\n    }\n\n    const isContextEval = ctx && flagSpec?.contextEvaluator;\n    const variant = isContextEval ? flagSpec.contextEvaluator?.(ctx) : flagSpec.defaultVariant;\n\n    const value = variant && flagSpec?.variants[variant];\n\n    if (value === undefined) {\n      const message = `no value associated with variant ${variant}`;\n      logger?.error(message);\n      throw new VariantFoundError(message);\n    }\n\n    return {\n      value: value as T,\n      ...(variant && { variant }),\n      reason: isContextEval ? StandardResolutionReasons.TARGETING_MATCH : StandardResolutionReasons.STATIC,\n    };\n  }\n}\n", "import { ErrorCode, OpenFeatureError } from '@openfeature/core';\n\n/**\n * A custom error for the in-memory provider.\n * Indicates the resolved or default variant doesn't exist.\n */\nexport class VariantFoundError extends OpenFeatureError {\n  code: ErrorCode;\n  constructor(message?: string) {\n    super(message);\n    Object.setPrototypeOf(this, VariantFoundError.prototype);\n    this.name = 'VariantFoundError';\n    this.code = ErrorCode.GENERAL;\n  }\n}\n", "import { EvaluationContext } from '@openfeature/core';\nimport { TransactionContext, TransactionContextPropagator } from './transaction-context';\n\nclass NoopTransactionContextPropagator implements TransactionContextPropagator {\n  getTransactionContext(): EvaluationContext {\n    return {};\n  }\n\n  setTransactionContext<TArgs extends unknown[], R>(\n    _: TransactionContext,\n    callback: (...args: TArgs) => R,\n    ...args: TArgs\n  ): void {\n    callback(...args);\n  }\n}\n\nexport const NOOP_TRANSACTION_CONTEXT_PROPAGATOR = new NoopTransactionContextPropagator();\n", "import { EvaluationContext } from '@openfeature/core';\nimport { TransactionContext, TransactionContextPropagator } from './transaction-context';\nimport { AsyncLocalStorage } from 'async_hooks';\n\nexport class AsyncLocalStorageTransactionContextPropagator implements TransactionContextPropagator {\n  private asyncLocalStorage = new AsyncLocalStorage<EvaluationContext>();\n\n  getTransactionContext(): EvaluationContext {\n    return this.asyncLocalStorage.getStore() ?? {};\n  }\n\n  setTransactionContext<TArgs extends unknown[], R>(\n    transactionContext: TransactionContext,\n    callback: (...args: TArgs) => R,\n    ...args: TArgs\n  ): void {\n    this.asyncLocalStorage.run(transactionContext, callback, ...args);\n  }\n}\n", "export * from './client';\nexport * from './provider';\nexport * from './evaluation';\nexport * from './open-feature';\nexport * from './transaction-context';\nexport * from './events';\nexport * from './hooks';\nexport * from '@openfeature/core';\n"],
+  "mappings": "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",
   "names": ["ErrorCode", "StandardResolutionReasons", "OpenFeatureError", "OpenFeatureError", "ErrorCode", "StandardResolutionReasons", "err"]
 }

package/dist/types.d.ts CHANGED Viewed

@@ -1,7 +1,8 @@
-import { BaseHook, FlagValue, EvaluationContext, HookHints, EvaluationDetails, JsonValue, EvaluationLifeCycle, ManageContext, ManageLogger, Eventing, ClientMetadata, GenericEventEmitter, ServerProviderEvents, CommonProvider, Logger, ResolutionDetails, ProviderStatus, EventHandler, OpenFeatureCommonAPI } from '@openfeature/core';
+import * as _openfeature_core from '@openfeature/core';
+import { BaseHook, FlagValue, EvaluationContext, HookHints, EvaluationDetails, JsonValue, CommonProvider, ServerProviderStatus, Logger, ResolutionDetails, GenericEventEmitter, ServerProviderEvents, EvaluationLifeCycle, ManageContext, ManageLogger, Eventing, ClientMetadata, EventHandler, OpenFeatureCommonAPI, ProviderWrapper } from '@openfeature/core';
 export * from '@openfeature/core';
-export { ServerProviderEvents as ProviderEvents } from '@openfeature/core';
-import EventEmitter from 'events';
+export { ServerProviderEvents as ProviderEvents, ServerProviderStatus as ProviderStatus } from '@openfeature/core';
+import { EventEmitter } from 'node:events';
 type Hook = BaseHook<FlagValue, Promise<EvaluationContext | void> | EvaluationContext | void, Promise<void> | void>;
@@ -96,37 +97,13 @@ interface Features {
     getObjectDetails<T extends JsonValue = JsonValue>(flagKey: string, defaultValue: T, context?: EvaluationContext, options?: FlagEvaluationOptions): Promise<EvaluationDetails<T>>;
 }
-interface Client extends EvaluationLifeCycle<Client>, Features, ManageContext<Client>, ManageLogger<Client>, Eventing {
-    readonly metadata: ClientMetadata;
-}
-/**
- * The OpenFeatureEventEmitter can be used by provider developers to emit
- * events at various parts of the provider lifecycle.
- *
- * NOTE: Ready and error events are automatically emitted by the SDK based on
- * the result of the initialize method.
- */
-declare class OpenFeatureEventEmitter extends GenericEventEmitter<ServerProviderEvents> {
-    protected readonly eventEmitter: EventEmitter;
-    constructor();
-}
-/**
- * The InternalEventEmitter is not exported publicly and should only be used within the SDK. It extends the
- * OpenFeatureEventEmitter to include additional properties that can be included
- * in the event details.
- */
-declare abstract class InternalEventEmitter extends GenericEventEmitter<ServerProviderEvents> {
-}
 /**
  * Interface that providers must implement to resolve flag values for their particular
  * backend or vendor.
  *
  * Implementation for resolving all the required flag types must be defined.
  */
-interface Provider extends CommonProvider {
+interface Provider extends CommonProvider<ServerProviderStatus> {
     /**
      * A provider hook exposes a mechanism for provider authors to register hooks
      * to tap into various stages of the flag evaluation lifecycle. These hooks can
@@ -159,7 +136,6 @@ declare class NoopFeatureProvider implements Provider {
     readonly metadata: {
         readonly name: "No-op Provider";
     };
-    get status(): ProviderStatus;
     resolveBooleanEvaluation(_: string, defaultValue: boolean): Promise<ResolutionDetails<boolean>>;
     resolveStringEvaluation(_: string, defaultValue: string): Promise<ResolutionDetails<string>>;
     resolveNumberEvaluation(_: string, defaultValue: number): Promise<ResolutionDetails<number>>;
@@ -226,6 +202,34 @@ declare class InMemoryProvider implements Provider {
     private lookupFlagValue;
 }
+/**
+ * The OpenFeatureEventEmitter can be used by provider developers to emit
+ * events at various parts of the provider lifecycle.
+ *
+ * NOTE: Ready and error events are automatically emitted by the SDK based on
+ * the result of the initialize method.
+ */
+declare class OpenFeatureEventEmitter extends GenericEventEmitter<ServerProviderEvents> {
+    protected readonly eventEmitter: EventEmitter;
+    constructor();
+}
+interface Client extends EvaluationLifeCycle<Client>, Features, ManageContext<Client>, ManageLogger<Client>, Eventing<ServerProviderEvents> {
+    readonly metadata: ClientMetadata;
+    /**
+     * Returns the status of the associated provider.
+     */
+    readonly providerStatus: ServerProviderStatus;
+}
+/**
+ * The InternalEventEmitter is not exported publicly and should only be used within the SDK. It extends the
+ * OpenFeatureEventEmitter to include additional properties that can be included
+ * in the event details.
+ */
+declare abstract class InternalEventEmitter extends GenericEventEmitter<ServerProviderEvents> {
+}
 type OpenFeatureClientOptions = {
     /**
      * @deprecated Use `domain` instead.
@@ -236,17 +240,19 @@ type OpenFeatureClientOptions = {
 };
 declare class OpenFeatureClient implements Client, ManageContext<OpenFeatureClient> {
     private readonly providerAccessor;
+    private readonly providerStatusAccessor;
     private readonly emitterAccessor;
     private readonly globalLogger;
     private readonly options;
     private _context;
     private _hooks;
     private _clientLogger?;
-    constructor(providerAccessor: () => Provider, emitterAccessor: () => InternalEventEmitter, globalLogger: () => Logger, options: OpenFeatureClientOptions, context?: EvaluationContext);
+    constructor(providerAccessor: () => Provider, providerStatusAccessor: () => ServerProviderStatus, emitterAccessor: () => InternalEventEmitter, globalLogger: () => Logger, options: OpenFeatureClientOptions, context?: EvaluationContext);
     get metadata(): ClientMetadata;
+    get providerStatus(): ServerProviderStatus;
     addHandler(eventType: ServerProviderEvents, handler: EventHandler): void;
     removeHandler(eventType: ServerProviderEvents, handler: EventHandler): void;
-    getHandlers(eventType: ServerProviderEvents): EventHandler[];
+    getHandlers(eventType: ServerProviderEvents): EventHandler<ServerProviderEvents | _openfeature_core.AllProviderEvents>[];
     setLogger(logger: Logger): OpenFeatureClient;
     setContext(context: EvaluationContext): OpenFeatureClient;
     getContext(): EvaluationContext;
@@ -267,6 +273,7 @@ declare class OpenFeatureClient implements Client, ManageContext<OpenFeatureClie
     private errorHooks;
     private finallyHooks;
     private get _provider();
+    private get _providerStatus();
     private get _logger();
 }
@@ -278,13 +285,9 @@ declare class OpenFeatureClient implements Client, ManageContext<OpenFeatureClie
 type TransactionContext = EvaluationContext;
 interface ManageTransactionContextPropagator<T> extends TransactionContextPropagator {
     /**
-     * EXPERIMENTAL: Transaction context propagation is experimental and subject to change.
-     * The OpenFeature Enhancement Proposal regarding transaction context can be found [here](https://github.com/open-feature/ofep/pull/32).
-     *
      * Sets a transaction context propagator on this receiver. The transaction context
      * propagator is responsible for persisting context for the duration of a single
      * transaction.
-     * @experimental
      * @template T The type of the receiver
      * @param {TransactionContextPropagator} transactionContextPropagator The context propagator to be used
      * @returns {T} The receiver (this object)
@@ -293,38 +296,59 @@ interface ManageTransactionContextPropagator<T> extends TransactionContextPropag
 }
 interface TransactionContextPropagator {
     /**
-     * EXPERIMENTAL: Transaction context propagation is experimental and subject to change.
-     * The OpenFeature Enhancement Proposal regarding transaction context can be found [here](https://github.com/open-feature/ofep/pull/32).
-     *
      * Returns the currently defined transaction context using the registered transaction
      * context propagator.
-     * @experimental
      * @returns {TransactionContext} The current transaction context
      */
     getTransactionContext(): TransactionContext;
     /**
-     * EXPERIMENTAL: Transaction context propagation is experimental and subject to change.
-     * The OpenFeature Enhancement Proposal regarding transaction context can be found [here](https://github.com/open-feature/ofep/pull/32).
-     *
      * Sets the transaction context using the registered transaction context propagator.
-     * @experimental
+     * Runs the {@link callback} function, in which the {@link transactionContext} will be available by calling
+     * {@link this#getTransactionContext}.
+     *
+     * The {@link TransactionContextPropagator} must persist the {@link transactionContext} and make it available
+     * to {@link callback} via {@link this#getTransactionContext}.
+     *
+     * The precedence of merging context can be seen in {@link https://openfeature.dev/specification/sections/evaluation-context#requirement-323 the specification}.
+     *
+     * Example:
+     *
+     * ```js
+     * app.use((req: Request, res: Response, next: NextFunction) => {
+     *     const ip = res.headers.get("X-Forwarded-For")
+     *     OpenFeature.setTransactionContext({ targetingKey: req.user.id, ipAddress: ip }, () => {
+     *         // The transaction context is used in any flag evaluation throughout the whole call chain of next
+     *         next();
+     *     });
+     * })
+     *
+     * ```
+     * @template TArgs The optional args passed to the callback function
      * @template R The return value of the callback
      * @param {TransactionContext} transactionContext The transaction specific context
-     * @param {(...args: unknown[]) => R} callback Callback function used to set the transaction context on the stack
+     * @param {(...args: unknown[]) => R} callback Callback function to run
      * @param {...unknown[]} args Optional arguments that are passed to the callback function
      */
-    setTransactionContext<R>(transactionContext: TransactionContext, callback: (...args: unknown[]) => R, ...args: unknown[]): void;
+    setTransactionContext<TArgs extends unknown[], R>(transactionContext: TransactionContext, callback: (...args: TArgs) => R, ...args: TArgs): void;
 }
 declare class NoopTransactionContextPropagator implements TransactionContextPropagator {
     getTransactionContext(): EvaluationContext;
-    setTransactionContext(_: EvaluationContext, callback: () => void): void;
+    setTransactionContext<TArgs extends unknown[], R>(_: TransactionContext, callback: (...args: TArgs) => R, ...args: TArgs): void;
 }
 declare const NOOP_TRANSACTION_CONTEXT_PROPAGATOR: NoopTransactionContextPropagator;
-declare class OpenFeatureAPI extends OpenFeatureCommonAPI<Provider, Hook> implements ManageContext<OpenFeatureAPI>, ManageTransactionContextPropagator<OpenFeatureCommonAPI<Provider>> {
-    protected _events: OpenFeatureEventEmitter;
-    protected _defaultProvider: Provider;
+declare class AsyncLocalStorageTransactionContextPropagator implements TransactionContextPropagator {
+    private asyncLocalStorage;
+    getTransactionContext(): EvaluationContext;
+    setTransactionContext<TArgs extends unknown[], R>(transactionContext: TransactionContext, callback: (...args: TArgs) => R, ...args: TArgs): void;
+}
+declare class OpenFeatureAPI extends OpenFeatureCommonAPI<ServerProviderStatus, Provider, Hook> implements ManageContext<OpenFeatureAPI>, ManageTransactionContextPropagator<OpenFeatureCommonAPI<ServerProviderStatus, Provider>> {
+    protected _statusEnumType: typeof ServerProviderStatus;
+    protected _apiEmitter: OpenFeatureEventEmitter;
+    protected _defaultProvider: ProviderWrapper<Provider, ServerProviderStatus>;
+    protected _domainScopedProviders: Map<string, ProviderWrapper<Provider, ServerProviderStatus>>;
     protected _createEventEmitter: () => OpenFeatureEventEmitter;
     private _transactionContextPropagator;
     private constructor();
@@ -334,6 +358,7 @@ declare class OpenFeatureAPI extends OpenFeatureCommonAPI<Provider, Hook> implem
      * @returns {OpenFeatureAPI} OpenFeature API
      */
     static getInstance(): OpenFeatureAPI;
+    private getProviderStatus;
     setContext(context: EvaluationContext): this;
     getContext(): EvaluationContext;
     /**
@@ -376,8 +401,8 @@ declare class OpenFeatureAPI extends OpenFeatureCommonAPI<Provider, Hook> implem
      * @returns {Promise<void>}
      */
     clearProviders(): Promise<void>;
-    setTransactionContextPropagator(transactionContextPropagator: TransactionContextPropagator): OpenFeatureCommonAPI<Provider>;
-    setTransactionContext<R>(transactionContext: TransactionContext, callback: (...args: unknown[]) => R, ...args: unknown[]): void;
+    setTransactionContextPropagator(transactionContextPropagator: TransactionContextPropagator): OpenFeatureCommonAPI<ServerProviderStatus, Provider>;
+    setTransactionContext<TArgs extends unknown[], R>(transactionContext: TransactionContext, callback: (...args: TArgs) => R, ...args: TArgs): void;
     getTransactionContext(): TransactionContext;
 }
 /**
@@ -386,4 +411,4 @@ declare class OpenFeatureAPI extends OpenFeatureCommonAPI<Provider, Hook> implem
  */
 declare const OpenFeature: OpenFeatureAPI;
-export { Client, Features, FlagEvaluationOptions, Hook, InMemoryProvider, ManageTransactionContextPropagator, NOOP_PROVIDER, NOOP_TRANSACTION_CONTEXT_PROPAGATOR, OpenFeature, OpenFeatureAPI, OpenFeatureClient, OpenFeatureEventEmitter, Provider, TransactionContext, TransactionContextPropagator };
+export { AsyncLocalStorageTransactionContextPropagator, Client, Features, FlagEvaluationOptions, Hook, InMemoryProvider, ManageTransactionContextPropagator, NOOP_PROVIDER, NOOP_TRANSACTION_CONTEXT_PROPAGATOR, OpenFeature, OpenFeatureAPI, OpenFeatureClient, OpenFeatureEventEmitter, Provider, TransactionContext, TransactionContextPropagator };

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@openfeature/server-sdk",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "OpenFeature SDK for JavaScript",
   "main": "./dist/cjs/index.js",
   "files": [
@@ -48,9 +48,9 @@
     "node": ">=16"
   },
   "peerDependencies": {
-    "@openfeature/core": "0.0.26"
+    "@openfeature/core": "0.0.27"
   },
   "devDependencies": {
-    "@openfeature/core": "0.0.26"
+    "@openfeature/core": "0.0.27"
   }
 }