@configdirector/openfeature-server-provider 0.9.4 → 0.10.0

package/dist/configdirector-openfeature-server-provider.d.cts

@@ -1,31 +1,43 @@
-import { ConfigDirectorClient, ConfigDirectorClientOptions, ConfigDirectorContext, ConfigDirectorLogMessageDecorator, ConfigDirectorLogger, ConfigDirectorLoggingLevel, ConfigValueType } from "@js-client-core/index";
 import { EvaluationContext, JsonValue, OpenFeatureEventEmitter, Paradigm, Provider, ProviderMetadata, ResolutionDetails } from "@openfeature/server-sdk";
 
 //#region ../shared/src/types.d.ts
+declare const ConfigTypeList: readonly ["custom", "boolean", "string", "integer", "float", "enum", "url", "json"];
+type ConfigType = (typeof ConfigTypeList)[number];
 type ConfigEnumLikeType = {
   [key: string]: string | number;
 };
-type ConfigValueType$1 = string | number | boolean | object | ConfigEnumLikeType;
-interface ConfigDirectorLogger$1 {
+type ConfigValueType = string | number | boolean | object | ConfigEnumLikeType;
+type ConfigState = {
+  id: string;
+  key: string;
+  type: ConfigType;
+  value: string | undefined | null;
+  valueId?: string | undefined | null;
+};
+type ConfigDirectorLoggingLevel = "debug" | "info" | "warn" | "error" | "off";
+interface ConfigDirectorLogger {
   debug(message: string, ...args: any): void;
   info(message: string, ...args: any): void;
   warn(message: string, ...args: any): void;
   error(message: string, ...args: any): void;
 }
+interface ConfigDirectorLogMessageDecorator {
+  decorateMessage(message: string): string;
+}
 type EvaluationReason = "found-match" | "config-state-missing" | "client-not-ready" | "type-mismatch" | "value-missing" | "invalid-number" | "invalid-json" | "invalid-boolean";
 type ConfigEvaluation = {
   key: string;
-  value: ConfigValueType$1;
+  value: ConfigValueType;
   valueId?: string;
   isDefaultValue: boolean;
   reason: EvaluationReason;
-  context?: ConfigDirectorContext$1;
+  context?: ConfigDirectorContext;
 };
 /**
  * The user's context to be sent to ConfigDirector. This context will be used for targeting
  * rules evaluation.
  */
-type ConfigDirectorContext$1 = {
+type ConfigDirectorContext = {
   /**
    * The user's identifier. This should be a value that uniquely identifies an application
    * user.
@@ -70,7 +82,7 @@ type ConnectionMode = "streaming" | "polling" | "one-time";
 /**
  * Configuration options for the {@link ConfigDirectorClient}
  */
-type ConfigDirectorClientOptions$1 = {
+type ConfigDirectorClientOptions = {
   /**
    * Application metadata that remains constant through the lifetime of the connection
    */
@@ -127,7 +139,7 @@ type ConfigDirectorClientOptions$1 = {
    *   { logger: createConsoleLogger("debug") },
    * );
    */
-  logger?: ConfigDirectorLogger$1;
+  logger?: ConfigDirectorLogger;
   /**
    * Telemetry tunning. It is unlikely these settings need to be adjusted. However, in cases where
    * your application has a large number of evaluations per second, you can adjust these settings
@@ -188,6 +200,91 @@ type ClientHooks = {
   configEvaluated?: HookHandler<"configEvaluated"> | HookHandler<"configEvaluated">[];
 };
 type HookHandler<TEvent extends keyof ClientEvents> = (payload: ClientEvents[TEvent]) => void;
+type WatchHandler<T extends ConfigValueType> = (message: T) => void;
+/**
+ * The ConfigDirector SDK client object.
+ *
+ * Applications should create a single instance of `ConfigDirectorClient`, and call
+ * {@link initialize} during application initialization.
+ */
+interface ConfigDirectorClient {
+  /**
+   * Initializes the connection to ConfigDirector to retrieve config definitions. Until
+   * initialization is successful, all flags will return their default value provided to
+   * {@link watch} or {@link getValue}.
+   *
+   * If the connection fails or is interrupted with a transient error (network error,
+   * internal server error, etc) the client will continue to attempt to connect. However,
+   * if the connection fails with a persistent error, like an invalid SDK key, the client will
+   * not attempt to re-connect and an error will be logged to the console or the provided
+   * logger.
+   */
+  initialize(): Promise<void>;
+  /**
+   * Returns whether or not the client is ready after calling {@link initialize}
+   *
+   * The definition of ready is that the connection to the server was successful, and config definitions
+   * were received.
+   */
+  get isReady(): boolean;
+  /**
+   * Evaluates a config and returns its value based on the current context and targeting rules
+   *
+   * @returns The evaluated config value, or the `defaultValue` if the config state was unavailable
+   * @param configKey The config key to evaluate
+   * @param defaultValue The default value to be returned if the config state is unavailable. For
+   * example, if the client cannot connect to the server due to network conditions, or if getValue
+   * is called before initialization is done.
+   * @param context The user's context to be used for targeting rules evaluation (optional)
+   */
+  getValue<T extends ConfigValueType>(configKey: string, defaultValue: T, context?: ConfigDirectorContext): T;
+  /**
+   * Watches for changes to a a config evaluation value. Whenever the config value changes, the
+   * provided callback function will be called with the new value. Changes can happen due to updates
+   * to the config in the ConfigDirector dashboard, or if the context is updated via {@link updateContext}.
+   *
+   * @returns An 'unwatch' function that can be called to remove the subscriber
+   *
+   * @param configKey The config key to watch
+   * @param defaultValue The default value to be referenced if the config state is unavailable
+   * @param callback The callback function to be called whenever the config value is updated
+   * @param context The user's context to be used for targeting rules evaluation (optional)
+   */
+  watch<T extends ConfigValueType>(configKey: string, defaultValue: T, callback: WatchHandler<T>, context?: ConfigDirectorContext): () => void;
+  /**
+   * Removes a particular subscriber to the given `configKey`, or all subscribers if no callback
+   * is provided.
+   *
+   * @param configKey The config key to remove subscribers from
+   * @param callback The subscriber to be removed. If not provided, all subscribers are removed for
+   * the given `configKey`.
+   */
+  unwatch<T extends ConfigValueType>(configKey: string, callback?: WatchHandler<T>): void;
+  /**
+   * Removes all subscribers from all config keys
+   */
+  unwatchAll(): void;
+  /**
+   * Returns the evaluated {@link ConfigState} for every known config key, or only the keys
+   * listed in `configKeys` when provided.
+   *
+   * Intended for SSR hydration — does NOT record telemetry events. Returns an empty object
+   * when the client is not yet ready.
+   */
+  getAllConfigs(options?: {
+    context?: ConfigDirectorContext;
+    configKeys?: string[];
+  }): Record<string, ConfigState>;
+  on<T extends keyof ClientEvents>(eventName: T, handler: (args: ClientEvents[T]) => void): void;
+  off<T extends keyof ClientEvents>(eventName: T, handler?: (args: ClientEvents[T]) => void): void;
+  /**
+   * Disposes of the client. All connections are closed, and all event and config key subscribers
+   * are removed.
+   *
+   * Intended to be called when your application shuts down
+   */
+  dispose(): void;
+}
 //#endregion
 //#region src/ConfigDirectorProvider.d.ts
 declare class ConfigDirectorProvider implements Provider {
@@ -196,7 +293,7 @@ declare class ConfigDirectorProvider implements Provider {
   readonly metadata: ProviderMetadata;
   readonly runsOn: Paradigm;
   readonly events: OpenFeatureEventEmitter;
-  constructor(clientSdkKey: string, clientOptions?: ConfigDirectorClientOptions$1);
+  constructor(clientSdkKey: string, clientOptions?: ConfigDirectorClientOptions);
   initialize(): Promise<void>;
   resolveBooleanEvaluation(flagKey: string, defaultValue: boolean, context: EvaluationContext): Promise<ResolutionDetails<boolean>>;
   resolveStringEvaluation(flagKey: string, defaultValue: string, context: EvaluationContext): Promise<ResolutionDetails<string>>;

package/dist/configdirector-openfeature-server-provider.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"configdirector-openfeature-server-provider.d.cts","names":[],"sources":["../../shared/src/types.ts","../../js-server-sdk/src/types.ts","../src/ConfigDirectorProvider.ts"],"mappings":";;;;KAYY,kBAAA;EAAA,CAAwB,GAAA;AAAA;AAAA,KAExB,iBAAA,wCAAuD,kBAAA;AAAA,UAiBlD,sBAAA;EACf,KAAA,CAAM,OAAA,aAAoB,IAAA;EAE1B,IAAA,CAAK,OAAA,aAAoB,IAAA;EAEzB,IAAA,CAAK,OAAA,aAAoB,IAAA;EAEzB,KAAA,CAAM,OAAA,aAAoB,IAAA;AAAA;AAAA,KAOhB,gBAAA;AAAA,KAUA,gBAAA;EACV,GAAA;EACA,KAAA,EAAO,iBAAA;EACP,OAAA;EACA,cAAA;EACA,MAAA,EAAQ,gBAAA;EACR,OAAA,GAAU,uBAAA;AAAA;;AANZ;;;KAYY,uBAAA;EAPF;;;;;;;;EAgBR,EAAA;EAhBA;;;;EAsBA,IAAA;EArB+B;AAMjC;;;EAqBE,MAAA;IAAA,CAAY,GAAA;EAAA;EAAZ;;;;;AAgBF;;EAPE,SAAA;AAAA;;AAYF;;;KALY,yBAAA;EACV,UAAA;EACA,OAAA;AAAA;AAAA,KAGU,cAAA;;;;AAjGZ;;KCeY,6BAAA;EDfwB;;AAEpC;ECiBE,QAAA,GAAW,yBAAA;;;;EAIX,UAAA;IDJmC;;;;;;;;;;;ICgBjC,IAAA,GAAO,cAAA;IDTT;;;;;AAOF;ICSI,eAAA;IDTwB;;;AAU5B;;;;;ICQI,OAAA;IDF6B;;;;;ICQ7B,GAAA;EAAA;EDTF;;;;;;AAOF;;;;;;;ECiBE,MAAA,GAAS,sBAAA;EDaT;;;AAOF;;;;ECXE,SAAA;IDgBU;;;;;;;;AClFZ;IA4EI,eAAA;IA5EmC;;;;;;;;IAsFnC,aAAA;EAAA;EAlEA;;;;;;;;;;;;;;AAuFJ;EAHE,KAAA,GAAQ,WAAA;AAAA;AAAA,KAGE,YAAA;EACV,cAAA;IAAkB,IAAA;EAAA;EAClB,WAAA;EACA,eAAA;IAAmB,UAAA,EAAY,gBAAA;EAAA;AAAA;AAAA,KAGrB,WAAA;EACV,WAAA,GAAc,WAAA,kBAA6B,WAAA;EAC3C,cAAA,GAAiB,WAAA,qBAAgC,WAAA;EACjD,eAAA,GAAkB,WAAA,sBAAiC,WAAA;AAAA;AAAA,KAGzC,WAAA,sBAAiC,YAAA,KAAiB,OAAA,EAAS,YAAA,CAAa,MAAA;;;cCrIvE,sBAAA,YAAkC,QAAA;EAAA,iBAC5B,MAAA;EAAA,iBACA,YAAA;EAAA,SAER,QAAA,EAAU,gBAAA;EAAA,SAGV,MAAA,EAAQ,QAAA;EAAA,SACR,MAAA,EAAM,uBAAA;cAEI,YAAA,UAAsB,aAAA,GAAgB,6BAAA;EAiBnD,UAAA,CAAA,GAAU,OAAA;EAMhB,wBAAA,CACE,OAAA,UACA,YAAA,WACA,OAAA,EAAS,iBAAA,GACR,OAAA,CAAQ,iBAAA;EAIX,uBAAA,CACE,OAAA,UACA,YAAA,UACA,OAAA,EAAS,iBAAA,GACR,OAAA,CAAQ,iBAAA;EAIX,uBAAA,CACE,OAAA,UACA,YAAA,UACA,OAAA,EAAS,iBAAA,GACR,OAAA,CAAQ,iBAAA;EAIX,uBAAA,WAAkC,SAAA,CAAA,CAChC,OAAA,UACA,YAAA,EAAc,CAAA,EACd,OAAA,EAAS,iBAAA,GACR,OAAA,CAAQ,iBAAA,CAAkB,CAAA;EAM7B,OAAA,CAAA,CAAA,GAAY,OAAA;EAAA,QAKJ,QAAA;EAAA,QAWA,UAAA;AAAA"}
+{"version":3,"file":"configdirector-openfeature-server-provider.d.cts","names":[],"sources":["../../shared/src/types.ts","../../js-server-sdk/src/types.ts","../src/ConfigDirectorProvider.ts"],"mappings":"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"}

package/dist/configdirector-openfeature-server-provider.d.mts

@@ -1,31 +1,43 @@
 import { EvaluationContext, JsonValue, OpenFeatureEventEmitter, Paradigm, Provider, ProviderMetadata, ResolutionDetails } from "@openfeature/server-sdk";
-import { ConfigDirectorClient, ConfigDirectorClientOptions, ConfigDirectorContext, ConfigDirectorLogMessageDecorator, ConfigDirectorLogger, ConfigDirectorLoggingLevel, ConfigValueType } from "@js-client-core/index";
 
 //#region ../shared/src/types.d.ts
+declare const ConfigTypeList: readonly ["custom", "boolean", "string", "integer", "float", "enum", "url", "json"];
+type ConfigType = (typeof ConfigTypeList)[number];
 type ConfigEnumLikeType = {
   [key: string]: string | number;
 };
-type ConfigValueType$1 = string | number | boolean | object | ConfigEnumLikeType;
-interface ConfigDirectorLogger$1 {
+type ConfigValueType = string | number | boolean | object | ConfigEnumLikeType;
+type ConfigState = {
+  id: string;
+  key: string;
+  type: ConfigType;
+  value: string | undefined | null;
+  valueId?: string | undefined | null;
+};
+type ConfigDirectorLoggingLevel = "debug" | "info" | "warn" | "error" | "off";
+interface ConfigDirectorLogger {
   debug(message: string, ...args: any): void;
   info(message: string, ...args: any): void;
   warn(message: string, ...args: any): void;
   error(message: string, ...args: any): void;
 }
+interface ConfigDirectorLogMessageDecorator {
+  decorateMessage(message: string): string;
+}
 type EvaluationReason = "found-match" | "config-state-missing" | "client-not-ready" | "type-mismatch" | "value-missing" | "invalid-number" | "invalid-json" | "invalid-boolean";
 type ConfigEvaluation = {
   key: string;
-  value: ConfigValueType$1;
+  value: ConfigValueType;
   valueId?: string;
   isDefaultValue: boolean;
   reason: EvaluationReason;
-  context?: ConfigDirectorContext$1;
+  context?: ConfigDirectorContext;
 };
 /**
  * The user's context to be sent to ConfigDirector. This context will be used for targeting
  * rules evaluation.
  */
-type ConfigDirectorContext$1 = {
+type ConfigDirectorContext = {
   /**
    * The user's identifier. This should be a value that uniquely identifies an application
    * user.
@@ -70,7 +82,7 @@ type ConnectionMode = "streaming" | "polling" | "one-time";
 /**
  * Configuration options for the {@link ConfigDirectorClient}
  */
-type ConfigDirectorClientOptions$1 = {
+type ConfigDirectorClientOptions = {
   /**
    * Application metadata that remains constant through the lifetime of the connection
    */
@@ -127,7 +139,7 @@ type ConfigDirectorClientOptions$1 = {
    *   { logger: createConsoleLogger("debug") },
    * );
    */
-  logger?: ConfigDirectorLogger$1;
+  logger?: ConfigDirectorLogger;
   /**
    * Telemetry tunning. It is unlikely these settings need to be adjusted. However, in cases where
    * your application has a large number of evaluations per second, you can adjust these settings
@@ -188,6 +200,91 @@ type ClientHooks = {
   configEvaluated?: HookHandler<"configEvaluated"> | HookHandler<"configEvaluated">[];
 };
 type HookHandler<TEvent extends keyof ClientEvents> = (payload: ClientEvents[TEvent]) => void;
+type WatchHandler<T extends ConfigValueType> = (message: T) => void;
+/**
+ * The ConfigDirector SDK client object.
+ *
+ * Applications should create a single instance of `ConfigDirectorClient`, and call
+ * {@link initialize} during application initialization.
+ */
+interface ConfigDirectorClient {
+  /**
+   * Initializes the connection to ConfigDirector to retrieve config definitions. Until
+   * initialization is successful, all flags will return their default value provided to
+   * {@link watch} or {@link getValue}.
+   *
+   * If the connection fails or is interrupted with a transient error (network error,
+   * internal server error, etc) the client will continue to attempt to connect. However,
+   * if the connection fails with a persistent error, like an invalid SDK key, the client will
+   * not attempt to re-connect and an error will be logged to the console or the provided
+   * logger.
+   */
+  initialize(): Promise<void>;
+  /**
+   * Returns whether or not the client is ready after calling {@link initialize}
+   *
+   * The definition of ready is that the connection to the server was successful, and config definitions
+   * were received.
+   */
+  get isReady(): boolean;
+  /**
+   * Evaluates a config and returns its value based on the current context and targeting rules
+   *
+   * @returns The evaluated config value, or the `defaultValue` if the config state was unavailable
+   * @param configKey The config key to evaluate
+   * @param defaultValue The default value to be returned if the config state is unavailable. For
+   * example, if the client cannot connect to the server due to network conditions, or if getValue
+   * is called before initialization is done.
+   * @param context The user's context to be used for targeting rules evaluation (optional)
+   */
+  getValue<T extends ConfigValueType>(configKey: string, defaultValue: T, context?: ConfigDirectorContext): T;
+  /**
+   * Watches for changes to a a config evaluation value. Whenever the config value changes, the
+   * provided callback function will be called with the new value. Changes can happen due to updates
+   * to the config in the ConfigDirector dashboard, or if the context is updated via {@link updateContext}.
+   *
+   * @returns An 'unwatch' function that can be called to remove the subscriber
+   *
+   * @param configKey The config key to watch
+   * @param defaultValue The default value to be referenced if the config state is unavailable
+   * @param callback The callback function to be called whenever the config value is updated
+   * @param context The user's context to be used for targeting rules evaluation (optional)
+   */
+  watch<T extends ConfigValueType>(configKey: string, defaultValue: T, callback: WatchHandler<T>, context?: ConfigDirectorContext): () => void;
+  /**
+   * Removes a particular subscriber to the given `configKey`, or all subscribers if no callback
+   * is provided.
+   *
+   * @param configKey The config key to remove subscribers from
+   * @param callback The subscriber to be removed. If not provided, all subscribers are removed for
+   * the given `configKey`.
+   */
+  unwatch<T extends ConfigValueType>(configKey: string, callback?: WatchHandler<T>): void;
+  /**
+   * Removes all subscribers from all config keys
+   */
+  unwatchAll(): void;
+  /**
+   * Returns the evaluated {@link ConfigState} for every known config key, or only the keys
+   * listed in `configKeys` when provided.
+   *
+   * Intended for SSR hydration — does NOT record telemetry events. Returns an empty object
+   * when the client is not yet ready.
+   */
+  getAllConfigs(options?: {
+    context?: ConfigDirectorContext;
+    configKeys?: string[];
+  }): Record<string, ConfigState>;
+  on<T extends keyof ClientEvents>(eventName: T, handler: (args: ClientEvents[T]) => void): void;
+  off<T extends keyof ClientEvents>(eventName: T, handler?: (args: ClientEvents[T]) => void): void;
+  /**
+   * Disposes of the client. All connections are closed, and all event and config key subscribers
+   * are removed.
+   *
+   * Intended to be called when your application shuts down
+   */
+  dispose(): void;
+}
 //#endregion
 //#region src/ConfigDirectorProvider.d.ts
 declare class ConfigDirectorProvider implements Provider {
@@ -196,7 +293,7 @@ declare class ConfigDirectorProvider implements Provider {
   readonly metadata: ProviderMetadata;
   readonly runsOn: Paradigm;
   readonly events: OpenFeatureEventEmitter;
-  constructor(clientSdkKey: string, clientOptions?: ConfigDirectorClientOptions$1);
+  constructor(clientSdkKey: string, clientOptions?: ConfigDirectorClientOptions);
   initialize(): Promise<void>;
   resolveBooleanEvaluation(flagKey: string, defaultValue: boolean, context: EvaluationContext): Promise<ResolutionDetails<boolean>>;
   resolveStringEvaluation(flagKey: string, defaultValue: string, context: EvaluationContext): Promise<ResolutionDetails<string>>;

package/dist/configdirector-openfeature-server-provider.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"configdirector-openfeature-server-provider.d.mts","names":[],"sources":["../../shared/src/types.ts","../../js-server-sdk/src/types.ts","../src/ConfigDirectorProvider.ts"],"mappings":";;;;KAYY,kBAAA;EAAA,CAAwB,GAAA;AAAA;AAAA,KAExB,iBAAA,wCAAuD,kBAAA;AAAA,UAiBlD,sBAAA;EACf,KAAA,CAAM,OAAA,aAAoB,IAAA;EAE1B,IAAA,CAAK,OAAA,aAAoB,IAAA;EAEzB,IAAA,CAAK,OAAA,aAAoB,IAAA;EAEzB,KAAA,CAAM,OAAA,aAAoB,IAAA;AAAA;AAAA,KAOhB,gBAAA;AAAA,KAUA,gBAAA;EACV,GAAA;EACA,KAAA,EAAO,iBAAA;EACP,OAAA;EACA,cAAA;EACA,MAAA,EAAQ,gBAAA;EACR,OAAA,GAAU,uBAAA;AAAA;;AANZ;;;KAYY,uBAAA;EAPF;;;;;;;;EAgBR,EAAA;EAhBA;;;;EAsBA,IAAA;EArB+B;AAMjC;;;EAqBE,MAAA;IAAA,CAAY,GAAA;EAAA;EAAZ;;;;;AAgBF;;EAPE,SAAA;AAAA;;AAYF;;;KALY,yBAAA;EACV,UAAA;EACA,OAAA;AAAA;AAAA,KAGU,cAAA;;;;AAjGZ;;KCeY,6BAAA;EDfwB;;AAEpC;ECiBE,QAAA,GAAW,yBAAA;;;;EAIX,UAAA;IDJmC;;;;;;;;;;;ICgBjC,IAAA,GAAO,cAAA;IDTT;;;;;AAOF;ICSI,eAAA;IDTwB;;;AAU5B;;;;;ICQI,OAAA;IDF6B;;;;;ICQ7B,GAAA;EAAA;EDTF;;;;;;AAOF;;;;;;;ECiBE,MAAA,GAAS,sBAAA;EDaT;;;AAOF;;;;ECXE,SAAA;IDgBU;;;;;;;;AClFZ;IA4EI,eAAA;IA5EmC;;;;;;;;IAsFnC,aAAA;EAAA;EAlEA;;;;;;;;;;;;;;AAuFJ;EAHE,KAAA,GAAQ,WAAA;AAAA;AAAA,KAGE,YAAA;EACV,cAAA;IAAkB,IAAA;EAAA;EAClB,WAAA;EACA,eAAA;IAAmB,UAAA,EAAY,gBAAA;EAAA;AAAA;AAAA,KAGrB,WAAA;EACV,WAAA,GAAc,WAAA,kBAA6B,WAAA;EAC3C,cAAA,GAAiB,WAAA,qBAAgC,WAAA;EACjD,eAAA,GAAkB,WAAA,sBAAiC,WAAA;AAAA;AAAA,KAGzC,WAAA,sBAAiC,YAAA,KAAiB,OAAA,EAAS,YAAA,CAAa,MAAA;;;cCrIvE,sBAAA,YAAkC,QAAA;EAAA,iBAC5B,MAAA;EAAA,iBACA,YAAA;EAAA,SAER,QAAA,EAAU,gBAAA;EAAA,SAGV,MAAA,EAAQ,QAAA;EAAA,SACR,MAAA,EAAM,uBAAA;cAEI,YAAA,UAAsB,aAAA,GAAgB,6BAAA;EAiBnD,UAAA,CAAA,GAAU,OAAA;EAMhB,wBAAA,CACE,OAAA,UACA,YAAA,WACA,OAAA,EAAS,iBAAA,GACR,OAAA,CAAQ,iBAAA;EAIX,uBAAA,CACE,OAAA,UACA,YAAA,UACA,OAAA,EAAS,iBAAA,GACR,OAAA,CAAQ,iBAAA;EAIX,uBAAA,CACE,OAAA,UACA,YAAA,UACA,OAAA,EAAS,iBAAA,GACR,OAAA,CAAQ,iBAAA;EAIX,uBAAA,WAAkC,SAAA,CAAA,CAChC,OAAA,UACA,YAAA,EAAc,CAAA,EACd,OAAA,EAAS,iBAAA,GACR,OAAA,CAAQ,iBAAA,CAAkB,CAAA;EAM7B,OAAA,CAAA,CAAA,GAAY,OAAA;EAAA,QAKJ,QAAA;EAAA,QAWA,UAAA;AAAA"}
+{"version":3,"file":"configdirector-openfeature-server-provider.d.mts","names":[],"sources":["../../shared/src/types.ts","../../js-server-sdk/src/types.ts","../src/ConfigDirectorProvider.ts"],"mappings":"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"}