@configdirector/openfeature-server-provider 1.11.1 → 1.13.0

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

@@ -1,4 +1,4 @@
-import { EvaluationContext, JsonValue, OpenFeatureEventEmitter, Paradigm, Provider, ProviderMetadata, ResolutionDetails } from "@openfeature/server-sdk";
+import { EvaluationContext, JsonValue, OpenFeatureEventEmitter, Paradigm, Provider, ProviderMetadata, ResolutionDetails, TrackingEventDetails } from "@openfeature/server-sdk";
 
 //#region ../shared/src/types.d.ts
 declare const ConfigTypeList: readonly ["custom", "boolean", "string", "integer", "float", "enum", "url", "json"];
@@ -13,6 +13,12 @@ type ConfigState = {
   type: ConfigType;
   value: string | undefined | null;
   valueId?: string | undefined | null;
+  variation?: {
+    id: string;
+    name?: string | undefined | null;
+  } | undefined | null;
+  ruleId?: string | undefined | null;
+  shareId?: string | undefined | null;
 };
 type ConfigDirectorLoggingLevel = "debug" | "info" | "warn" | "error" | "off";
 interface ConfigDirectorLogger {
@@ -24,15 +30,65 @@ interface ConfigDirectorLogger {
 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" | "cached";
-type ConfigEvaluation = {
-  key: string;
-  value: ConfigValueType;
+/**
+ * Why an evaluation returned the value it did. `found-match` returns a value from ConfigDirector,
+ * and `cached` a value kept on the device while a client SDK waits for live values.
+ * `rollout-skipped-no-identifier` returns the default targeting rule value: a server SDK skipped a
+ * percentage rollout because the context has no `id` to place it in a share. `value-missing`
+ * returns the in-code default value because the config has no value. Every other reason returns the
+ * in-code default value because of an error: the config does not exist (`config-state-missing`), no
+ * values have arrived yet (`client-not-ready`), or the value cannot be read as the type of the in-code
+ * default value.
+ */
+type EvaluationReason = "found-match" | "rollout-skipped-no-identifier" | "config-state-missing" | "client-not-ready" | "type-mismatch" | "value-missing" | "invalid-number" | "invalid-json" | "invalid-boolean" | "cached";
+/**
+ * One of the values a config can serve, such as the control or a treatment of an experiment.
+ */
+type Variation = {
+  /** The ID ConfigDirector assigned to the variation, which stays the same when it is renamed. */id: string; /** The variation's name, when it has one. */
+  name?: string;
+};
+/**
+ * One evaluation of a config: the value it returned, why, and the context it was evaluated for.
+ */
+type ConfigEvaluation<T extends ConfigValueType = ConfigValueType> = {
+  /** The config key that was evaluated. */key: string; /** The value returned, which is the in-code default value when {@link isDefaultValue} is `true`. */
+  value: T; /** The ID ConfigDirector assigned to the value returned, when ConfigDirector sent one with it. */
   valueId?: string;
-  isDefaultValue: boolean;
-  reason: EvaluationReason;
+  /**
+   * The variation that was served. It is `undefined` when the config has no variations or the
+   * in-code default value is returned.
+   */
+  variation?: Variation; /** Whether the evaluation returned the in-code default value. */
+  isDefaultValue: boolean; /** Why the evaluation returned this value. */
+  reason: EvaluationReason; /** The context the config was evaluated for, if any. */
   context?: ConfigDirectorContext;
 };
+/**
+ * A value in the details of a tracked event: a string, a number, a boolean, or an array or object
+ * of such values.
+ */
+type TrackedEventDetailValue = string | number | boolean | TrackedEventDetailValue[] | {
+  [key: string]: TrackedEventDetailValue;
+};
+/**
+ * Details of a tracked event, such as the plan a customer chose. Details with more than 20
+ * top-level keys, or larger than 1 KB as JSON, are left out and the event is still reported.
+ */
+type TrackedEventDetails = {
+  [key: string]: TrackedEventDetailValue;
+};
+/**
+ * What a tracked event carries besides its name.
+ */
+type TrackOptions = {
+  /**
+   * A number the event measures, such as an amount of money, a count or a duration. A value that
+   * is not a finite number is left out and the event is still reported.
+   */
+  value?: number; /** Details of the event. */
+  details?: TrackedEventDetails;
+};
 /**
  * The context to be sent to ConfigDirector: the user or other entity, such as a device or an
  * organization, that configs are evaluated for. This context will be used for targeting rules
@@ -312,6 +368,17 @@ interface ConfigDirectorClient {
    * @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;
+  /**
+   * Evaluates a config as {@link getValue} does and returns the evaluation: the value, the reason it
+   * was served, its value ID and its variation. Like every read, it fires `configEvaluated` and is
+   * counted in telemetry.
+   *
+   * @returns The evaluation, whose `value` is what {@link getValue} returns
+   * @param configKey The config key to evaluate
+   * @param defaultValue The in-code default value, returned when no value from ConfigDirector can be served
+   * @param context The user's context to be used for targeting rules evaluation (optional)
+   */
+  evaluate<T extends ConfigValueType>(configKey: string, defaultValue: T, context?: ConfigDirectorContext): ConfigEvaluation<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
@@ -349,6 +416,21 @@ interface ConfigDirectorClient {
     context?: ConfigDirectorContext;
     configKeys?: string[];
   }): Record<string, ConfigState>;
+  /**
+   * Reports to ConfigDirector that something happened, such as a completed checkout, so it can be
+   * counted. The event is sent with the next telemetry batch. `track` never throws, and does nothing
+   * in `offline` mode.
+   *
+   * An event counts for an experiment only when it is tracked for a context with an `id`, the one
+   * the experiment's config was evaluated for. Without a context, or for a context without an
+   * `id`, the event is still reported.
+   *
+   * @param eventName The name of the event, 1 to 150 characters. An event with any other name is
+   * not reported and a warning is logged.
+   * @param context The context the event happened for (optional)
+   * @param options The event's {@link TrackOptions.value} and {@link TrackOptions.details} (optional)
+   */
+  track(eventName: string, context?: ConfigDirectorContext, options?: TrackOptions): void;
   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;
   /**
@@ -369,7 +451,6 @@ declare class ConfigDirectorInitializationError extends Error {
 //#region src/ConfigDirectorProvider.d.ts
 declare class ConfigDirectorProvider implements Provider {
   private readonly client;
-  private readonly readyHandler;
   readonly metadata: ProviderMetadata;
   readonly runsOn: Paradigm;
   readonly events: OpenFeatureEventEmitter;
@@ -387,8 +468,8 @@ declare class ConfigDirectorProvider implements Provider {
   resolveStringEvaluation(flagKey: string, defaultValue: string, context: EvaluationContext): Promise<ResolutionDetails<string>>;
   resolveNumberEvaluation(flagKey: string, defaultValue: number, context: EvaluationContext): Promise<ResolutionDetails<number>>;
   resolveObjectEvaluation<T extends JsonValue>(flagKey: string, defaultValue: T, context: EvaluationContext): Promise<ResolutionDetails<T>>;
+  track(trackingEventName: string, context: EvaluationContext, trackingEventDetails: TrackingEventDetails): void;
   onClose?(): Promise<void>;
-  private evaluate;
   private mapContext;
 }
 //#endregion

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","../../shared/src/native-values.ts","../../js-server-sdk/src/types.ts","../../shared/src/errors.ts","../src/ConfigDirectorProvider.ts"],"mappings":"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"}
+{"version":3,"file":"configdirector-openfeature-server-provider.d.cts","names":[],"sources":["../../shared/src/types.ts","../../shared/src/native-values.ts","../../js-server-sdk/src/types.ts","../../shared/src/errors.ts","../src/ConfigDirectorProvider.ts"],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-import { EvaluationContext, JsonValue, OpenFeatureEventEmitter, Paradigm, Provider, ProviderMetadata, ResolutionDetails } from "@openfeature/server-sdk";
+import { EvaluationContext, JsonValue, OpenFeatureEventEmitter, Paradigm, Provider, ProviderMetadata, ResolutionDetails, TrackingEventDetails } from "@openfeature/server-sdk";
 
 //#region ../shared/src/types.d.ts
 declare const ConfigTypeList: readonly ["custom", "boolean", "string", "integer", "float", "enum", "url", "json"];
@@ -13,6 +13,12 @@ type ConfigState = {
   type: ConfigType;
   value: string | undefined | null;
   valueId?: string | undefined | null;
+  variation?: {
+    id: string;
+    name?: string | undefined | null;
+  } | undefined | null;
+  ruleId?: string | undefined | null;
+  shareId?: string | undefined | null;
 };
 type ConfigDirectorLoggingLevel = "debug" | "info" | "warn" | "error" | "off";
 interface ConfigDirectorLogger {
@@ -24,15 +30,65 @@ interface ConfigDirectorLogger {
 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" | "cached";
-type ConfigEvaluation = {
-  key: string;
-  value: ConfigValueType;
+/**
+ * Why an evaluation returned the value it did. `found-match` returns a value from ConfigDirector,
+ * and `cached` a value kept on the device while a client SDK waits for live values.
+ * `rollout-skipped-no-identifier` returns the default targeting rule value: a server SDK skipped a
+ * percentage rollout because the context has no `id` to place it in a share. `value-missing`
+ * returns the in-code default value because the config has no value. Every other reason returns the
+ * in-code default value because of an error: the config does not exist (`config-state-missing`), no
+ * values have arrived yet (`client-not-ready`), or the value cannot be read as the type of the in-code
+ * default value.
+ */
+type EvaluationReason = "found-match" | "rollout-skipped-no-identifier" | "config-state-missing" | "client-not-ready" | "type-mismatch" | "value-missing" | "invalid-number" | "invalid-json" | "invalid-boolean" | "cached";
+/**
+ * One of the values a config can serve, such as the control or a treatment of an experiment.
+ */
+type Variation = {
+  /** The ID ConfigDirector assigned to the variation, which stays the same when it is renamed. */id: string; /** The variation's name, when it has one. */
+  name?: string;
+};
+/**
+ * One evaluation of a config: the value it returned, why, and the context it was evaluated for.
+ */
+type ConfigEvaluation<T extends ConfigValueType = ConfigValueType> = {
+  /** The config key that was evaluated. */key: string; /** The value returned, which is the in-code default value when {@link isDefaultValue} is `true`. */
+  value: T; /** The ID ConfigDirector assigned to the value returned, when ConfigDirector sent one with it. */
   valueId?: string;
-  isDefaultValue: boolean;
-  reason: EvaluationReason;
+  /**
+   * The variation that was served. It is `undefined` when the config has no variations or the
+   * in-code default value is returned.
+   */
+  variation?: Variation; /** Whether the evaluation returned the in-code default value. */
+  isDefaultValue: boolean; /** Why the evaluation returned this value. */
+  reason: EvaluationReason; /** The context the config was evaluated for, if any. */
   context?: ConfigDirectorContext;
 };
+/**
+ * A value in the details of a tracked event: a string, a number, a boolean, or an array or object
+ * of such values.
+ */
+type TrackedEventDetailValue = string | number | boolean | TrackedEventDetailValue[] | {
+  [key: string]: TrackedEventDetailValue;
+};
+/**
+ * Details of a tracked event, such as the plan a customer chose. Details with more than 20
+ * top-level keys, or larger than 1 KB as JSON, are left out and the event is still reported.
+ */
+type TrackedEventDetails = {
+  [key: string]: TrackedEventDetailValue;
+};
+/**
+ * What a tracked event carries besides its name.
+ */
+type TrackOptions = {
+  /**
+   * A number the event measures, such as an amount of money, a count or a duration. A value that
+   * is not a finite number is left out and the event is still reported.
+   */
+  value?: number; /** Details of the event. */
+  details?: TrackedEventDetails;
+};
 /**
  * The context to be sent to ConfigDirector: the user or other entity, such as a device or an
  * organization, that configs are evaluated for. This context will be used for targeting rules
@@ -312,6 +368,17 @@ interface ConfigDirectorClient {
    * @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;
+  /**
+   * Evaluates a config as {@link getValue} does and returns the evaluation: the value, the reason it
+   * was served, its value ID and its variation. Like every read, it fires `configEvaluated` and is
+   * counted in telemetry.
+   *
+   * @returns The evaluation, whose `value` is what {@link getValue} returns
+   * @param configKey The config key to evaluate
+   * @param defaultValue The in-code default value, returned when no value from ConfigDirector can be served
+   * @param context The user's context to be used for targeting rules evaluation (optional)
+   */
+  evaluate<T extends ConfigValueType>(configKey: string, defaultValue: T, context?: ConfigDirectorContext): ConfigEvaluation<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
@@ -349,6 +416,21 @@ interface ConfigDirectorClient {
     context?: ConfigDirectorContext;
     configKeys?: string[];
   }): Record<string, ConfigState>;
+  /**
+   * Reports to ConfigDirector that something happened, such as a completed checkout, so it can be
+   * counted. The event is sent with the next telemetry batch. `track` never throws, and does nothing
+   * in `offline` mode.
+   *
+   * An event counts for an experiment only when it is tracked for a context with an `id`, the one
+   * the experiment's config was evaluated for. Without a context, or for a context without an
+   * `id`, the event is still reported.
+   *
+   * @param eventName The name of the event, 1 to 150 characters. An event with any other name is
+   * not reported and a warning is logged.
+   * @param context The context the event happened for (optional)
+   * @param options The event's {@link TrackOptions.value} and {@link TrackOptions.details} (optional)
+   */
+  track(eventName: string, context?: ConfigDirectorContext, options?: TrackOptions): void;
   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;
   /**
@@ -369,7 +451,6 @@ declare class ConfigDirectorInitializationError extends Error {
 //#region src/ConfigDirectorProvider.d.ts
 declare class ConfigDirectorProvider implements Provider {
   private readonly client;
-  private readonly readyHandler;
   readonly metadata: ProviderMetadata;
   readonly runsOn: Paradigm;
   readonly events: OpenFeatureEventEmitter;
@@ -387,8 +468,8 @@ declare class ConfigDirectorProvider implements Provider {
   resolveStringEvaluation(flagKey: string, defaultValue: string, context: EvaluationContext): Promise<ResolutionDetails<string>>;
   resolveNumberEvaluation(flagKey: string, defaultValue: number, context: EvaluationContext): Promise<ResolutionDetails<number>>;
   resolveObjectEvaluation<T extends JsonValue>(flagKey: string, defaultValue: T, context: EvaluationContext): Promise<ResolutionDetails<T>>;
+  track(trackingEventName: string, context: EvaluationContext, trackingEventDetails: TrackingEventDetails): void;
   onClose?(): Promise<void>;
-  private evaluate;
   private mapContext;
 }
 //#endregion

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","../../shared/src/native-values.ts","../../js-server-sdk/src/types.ts","../../shared/src/errors.ts","../src/ConfigDirectorProvider.ts"],"mappings":"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"}
+{"version":3,"file":"configdirector-openfeature-server-provider.d.mts","names":[],"sources":["../../shared/src/types.ts","../../shared/src/native-values.ts","../../js-server-sdk/src/types.ts","../../shared/src/errors.ts","../src/ConfigDirectorProvider.ts"],"mappings":"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"}