@mozilla/nimbus-schemas 2025.1.1 → 3000.0.0

package/index.d.ts

@@ -7,7 +7,7 @@
  */
 
 /**
- * A unique, stable indentifier for the user used as an input to bucket hashing.
+ * A unique, stable identifier for the user used as an input to bucket hashing.
  */
 export type RandomizationUnit = "normandy_id" | "nimbus_id" | "user_id" | "group_id";
 export type DesktopApplication = "firefox-desktop" | "firefox-desktop-background-task";
@@ -49,52 +49,40 @@ export interface DesktopAllVersionsNimbusExperiment {
    */
   slug: string;
   /**
-   * Unique identifier for the experiiment.
-   *
-   * This is a duplicate of slug, but is required field for all Remote Settings records.
+   * Unique identifier for the experiment. This is a duplicate of slug,             but is required field for all Remote Settings records.
    */
   id: string;
   /**
-   * A slug identifying the targeted product of this experiment.
-   *
-   * It should be a lowercased_with_underscores name that is short and unambiguous and it should match the app_name found in https://probeinfo.telemetry.mozilla.org/glean/repositories. Examples are "fenix" and "firefox_desktop".
+   * A slug identifying the targeted product of this experiment.             It should be a lowercased_with_underscores name that is short and                 unambiguous and it should match the app_name found in                     https://probeinfo.telemetry.mozilla.org/glean/repositories.                         Examples are "fenix" and "firefox_desktop".
    */
   appName: string;
   /**
-   * The platform identifier for the targeted app.
-   *
-   * This should match app's identifier exactly as it appears in the relevant app store listing (for relevant platforms) or the app's Glean initialization (for other platforms).
-   *
-   * Examples are "org.mozilla.firefox_beta" and "firefox-desktop".
+   * The platform identifier for the targeted app.             This should match app's identifier exactly as it appears in                 the relevant app store listing (for relevant platforms) or the app's                      Glean initialization (for other platforms). Examples are                       "org.mozilla.firefox_beta" and "firefox-desktop".
    */
   appId: string;
   /**
-   * A specific channel of an application such as "nightly", "beta", or "release".
+   * A specific channel of an application such as 'nightly',             'beta', or 'release'.
    */
   channel: string;
   /**
-   * Public name of the experiment that will be displayed on "about:studies".
+   * Public name of the experiment displayed on 'about:studies'.
    */
   userFacingName: string;
   /**
-   * Short public description of the experiment that will be displayed on "about:studies".
+   * Short public description of the experiment.             that will be displayed on "about:studies".
    */
   userFacingDescription: string;
   /**
-   * When this property is set to true, the SDK should not enroll new users into the experiment that have not already been enrolled.
+   * When this property is set to true, the SDK should not enroll              new users into the experiment that have not already been enrolled.
    */
   isEnrollmentPaused: boolean;
   /**
-   * When this property is set to true, treat this experiment as a rollout.
-   *
-   * Rollouts are currently handled as single-branch experiments separated from the bucketing namespace for normal experiments.
-   *
-   * See-also: https://mozilla-hub.atlassian.net/browse/SDK-405
+   * When this property is set to true, treat this experiment               as a rollout. Rollouts are currently handled as single-branch               experiments separated from the bucketing namespace for normal experiments.               See-also: https://mozilla-hub.atlassian.net/browse/SDK-405
    */
   isRollout?: boolean;
   bucketConfig: ExperimentBucketConfig;
   /**
-   * A list of outcomes relevant to the experiment analysis.
+   * List of outcomes relevant to analysis.
    */
   outcomes?: ExperimentOutcome[];
   /**
@@ -106,49 +94,35 @@ export interface DesktopAllVersionsNimbusExperiment {
    */
   targeting?: string | null;
   /**
-   * Actual publish date of the experiment.
-   *
-   * Note that this value is expected to be null in Remote Settings.
+   * Actual publish date of the experiment.         Note that this value is expected to be null in Remote Settings.
    */
   startDate: string | null;
   /**
-   * Actual enrollment end date of the experiment.
-   *
-   * Note that this value is expected to be null in Remote Settings.
+   * Actual enrollment end date of the experiment.             Note that this value is expected to be null in Remote Settings.
    */
   enrollmentEndDate?: string | null;
   /**
-   * Actual end date of this experiment.
-   *
-   * Note that this field is expected to be null in Remote Settings.
+   * Actual end date of this experiment.              Note that this field is expected to be null in Remote Settings.
    */
   endDate: string | null;
   /**
-   * Duration of the experiment from the start date in days.
-   *
-   * Note that this property is only used during the analysis phase (i.e., not by the SDK).
+   * Duration of the experiment from the start date in days.             Note that this property is only used during the analysis phase                 (i.e., not by the SDK).
    */
   proposedDuration?: number;
   /**
-   * This represents the number of days that we expect to enroll new users.
-   *
-   * Note that this property is only used during the analysis phase (i.e., not by the SDK).
+   * This represents the number of days that we expect to             enroll new users. Note that this property is only used during                  the analysis phase (i.e., not by the SDK).
    */
   proposedEnrollment: number;
   /**
-   * The slug of the reference branch (i.e., the branch we consider "control").
+   * The slug of the reference branch             (i.e., the branch we consider "control").
    */
   referenceBranch: string | null;
   /**
-   * The list of locale codes (e.g., "en-US" or "fr") that this experiment is targeting.
-   *
-   * If null, all locales are targeted.
+   * The list of locale codes (e.g., "en-US" or "fr") that this             experiment is targeting. If null, all locales are targeted.
    */
   locales?: string[] | null;
   /**
-   * The date that this experiment was first published to Remote Settings.
-   *
-   * If null, it has not yet been published.
+   * The date that this experiment was first published to             Remote Settings. If null, it has not yet been published.
    */
   publishedDate?: string | null;
   /**
@@ -156,7 +130,7 @@ export interface DesktopAllVersionsNimbusExperiment {
    */
   branches: DesktopAllVersionsExperimentBranch[];
   /**
-   * When this property is set to true, treat this experiment as aFirefox Labs experiment
+   * When this property is set to true, treat this experiment as a             Firefox Labs experiment
    */
   isFirefoxLabsOptIn?: boolean;
   /**
@@ -172,7 +146,7 @@ export interface DesktopAllVersionsNimbusExperiment {
    */
   firefoxLabsDescription?: string | null;
   /**
-   * Links that will be used with the firefoxLabsDescription Fluent ID. May be null for Firefox Labs Opt-In recipes that do not use links.
+   * Links that will be used with the Firefox Labs             description Fluent ID. May be null for Firefox Labs Opt-In recipes                 that do not use links.
    */
   firefoxLabsDescriptionLinks?: {
     [k: string]: string;
@@ -183,12 +157,13 @@ export interface DesktopAllVersionsNimbusExperiment {
   featureValidationOptOut?: boolean;
   /**
    * Does the experiment require a restart to take effect?
-   *
-   * Only used by Firefox Labs Opt-Ins.
    */
   requiresRestart?: boolean;
   localizations?: ExperimentLocalizations | null;
 }
+/**
+ * Common Bucketing Configuration used across all versions.
+ */
 export interface ExperimentBucketConfig {
   randomizationUnit: RandomizationUnit;
   /**
@@ -204,9 +179,7 @@ export interface ExperimentBucketConfig {
    */
   count: number;
   /**
-   * The total number of buckets.
-   *
-   * You can assume this will always be 10000
+   * The total number of buckets. You can assume             this will always be 10000.
    */
   total: number;
 }
@@ -233,8 +206,7 @@ export interface DesktopAllVersionsExperimentBranch {
   slug: string;
   /**
    * Relative ratio of population for the branch.
-   *
-   * e.g., if branch A=1 and branch B=3, then branch A would get 25% of the population.
+   * e.g., if branch A=1 and branch B=3, then branch A                 would get 25% of the population.
    */
   ratio: number;
   /**
@@ -279,107 +251,6 @@ export interface ExperimentLocalizations {
     [k: string]: string;
   };
 }
-/**
- * A feature.
- */
-export interface DesktopFeature {
-  /**
-   * The description of the feature.
-   */
-  description: string;
-  /**
-   * Whether or not this feature records exposure telemetry.
-   */
-  hasExposure: boolean;
-  /**
-   * A description of the exposure telemetry collected by this feature.
-   *
-   * Only required if hasExposure is true.
-   */
-  exposureDescription?: string;
-  /**
-   * The owner of the feature.
-   */
-  owner: string;
-  /**
-   * If true, the feature values will be cached in prefs so that they can be read before Nimbus is initialized during Firefox startup.
-   */
-  isEarlyStartup?: boolean;
-  /**
-   * The applications that can enroll in experiments for this feature.
-   *
-   * Defaults to "firefox-desktop".
-   */
-  applications?: DesktopApplication[];
-  /**
-   * The variables that this feature can set.
-   */
-  variables: {
-    [k: string]: DesktopFeatureVariable;
-  };
-  schema?: NimbusFeatureSchema;
-}
-/**
- * A feature variable.
- */
-export interface DesktopFeatureVariable {
-  /**
-   * A description of the feature.
-   */
-  description: string;
-  type: FeatureVariableType;
-  /**
-   * An optional list of possible string or integer values.
-   *
-   * Only allowed when type is string or int.
-   *
-   * The types in the enum must match the type of the field.
-   */
-  enum?: string[] | number[];
-  /**
-   * A pref that provides the default value for a feature when none is present.
-   */
-  fallbackPref?: string;
-  /**
-   * A pref that should be set to the value of this variable when enrolling in experiments.
-   *
-   * Using a string is deprecated and unsupported in Firefox 124+.
-   */
-  setPref?: string | SetPref;
-}
-export interface SetPref {
-  branch: PrefBranch;
-  /**
-   * The name of the pref to set.
-   */
-  pref: string;
-}
-/**
- * Information about a JSON schema.
- */
-export interface NimbusFeatureSchema {
-  /**
-   * The resource:// or chrome:// URI that can be loaded at runtime within Firefox.
-   *
-   * Required by Firefox so that Nimbus can import the schema for validation.
-   */
-  uri: string;
-  /**
-   * The path to the schema file in the source checkout.
-   *
-   * Required by Experimenter so that it can find schema files in source checkouts.
-   */
-  path: string;
-}
-/**
- * The Firefox Desktop-specific feature manifest.
- *
- * Firefox Desktop requires different fields for its features compared to the general
- * Nimbus feature manifest.
- */
-export interface DesktopFeatureManifest {
-  [k: string]: DesktopFeature;
-}
 /**
  * A Nimbus experiment for Firefox Desktop.
  *
@@ -396,52 +267,40 @@ export interface DesktopNimbusExperiment {
    */
   slug: string;
   /**
-   * Unique identifier for the experiiment.
-   *
-   * This is a duplicate of slug, but is required field for all Remote Settings records.
+   * Unique identifier for the experiment. This is a duplicate of slug,             but is required field for all Remote Settings records.
    */
   id: string;
   /**
-   * A slug identifying the targeted product of this experiment.
-   *
-   * It should be a lowercased_with_underscores name that is short and unambiguous and it should match the app_name found in https://probeinfo.telemetry.mozilla.org/glean/repositories. Examples are "fenix" and "firefox_desktop".
+   * A slug identifying the targeted product of this experiment.             It should be a lowercased_with_underscores name that is short and                 unambiguous and it should match the app_name found in                     https://probeinfo.telemetry.mozilla.org/glean/repositories.                         Examples are "fenix" and "firefox_desktop".
    */
   appName: string;
   /**
-   * The platform identifier for the targeted app.
-   *
-   * This should match app's identifier exactly as it appears in the relevant app store listing (for relevant platforms) or the app's Glean initialization (for other platforms).
-   *
-   * Examples are "org.mozilla.firefox_beta" and "firefox-desktop".
+   * The platform identifier for the targeted app.             This should match app's identifier exactly as it appears in                 the relevant app store listing (for relevant platforms) or the app's                      Glean initialization (for other platforms). Examples are                       "org.mozilla.firefox_beta" and "firefox-desktop".
    */
   appId: string;
   /**
-   * A specific channel of an application such as "nightly", "beta", or "release".
+   * A specific channel of an application such as 'nightly',             'beta', or 'release'.
    */
   channel: string;
   /**
-   * Public name of the experiment that will be displayed on "about:studies".
+   * Public name of the experiment displayed on 'about:studies'.
    */
   userFacingName: string;
   /**
-   * Short public description of the experiment that will be displayed on "about:studies".
+   * Short public description of the experiment.             that will be displayed on "about:studies".
    */
   userFacingDescription: string;
   /**
-   * When this property is set to true, the SDK should not enroll new users into the experiment that have not already been enrolled.
+   * When this property is set to true, the SDK should not enroll              new users into the experiment that have not already been enrolled.
    */
   isEnrollmentPaused: boolean;
   /**
-   * When this property is set to true, treat this experiment as a rollout.
-   *
-   * Rollouts are currently handled as single-branch experiments separated from the bucketing namespace for normal experiments.
-   *
-   * See-also: https://mozilla-hub.atlassian.net/browse/SDK-405
+   * When this property is set to true, treat this experiment               as a rollout. Rollouts are currently handled as single-branch               experiments separated from the bucketing namespace for normal experiments.               See-also: https://mozilla-hub.atlassian.net/browse/SDK-405
    */
   isRollout?: boolean;
   bucketConfig: ExperimentBucketConfig;
   /**
-   * A list of outcomes relevant to the experiment analysis.
+   * List of outcomes relevant to analysis.
    */
   outcomes?: ExperimentOutcome[];
   /**
@@ -453,49 +312,35 @@ export interface DesktopNimbusExperiment {
    */
   targeting?: string | null;
   /**
-   * Actual publish date of the experiment.
-   *
-   * Note that this value is expected to be null in Remote Settings.
+   * Actual publish date of the experiment.         Note that this value is expected to be null in Remote Settings.
    */
   startDate: string | null;
   /**
-   * Actual enrollment end date of the experiment.
-   *
-   * Note that this value is expected to be null in Remote Settings.
+   * Actual enrollment end date of the experiment.             Note that this value is expected to be null in Remote Settings.
    */
   enrollmentEndDate?: string | null;
   /**
-   * Actual end date of this experiment.
-   *
-   * Note that this field is expected to be null in Remote Settings.
+   * Actual end date of this experiment.              Note that this field is expected to be null in Remote Settings.
    */
   endDate: string | null;
   /**
-   * Duration of the experiment from the start date in days.
-   *
-   * Note that this property is only used during the analysis phase (i.e., not by the SDK).
+   * Duration of the experiment from the start date in days.             Note that this property is only used during the analysis phase                 (i.e., not by the SDK).
    */
   proposedDuration?: number;
   /**
-   * This represents the number of days that we expect to enroll new users.
-   *
-   * Note that this property is only used during the analysis phase (i.e., not by the SDK).
+   * This represents the number of days that we expect to             enroll new users. Note that this property is only used during                  the analysis phase (i.e., not by the SDK).
    */
   proposedEnrollment: number;
   /**
-   * The slug of the reference branch (i.e., the branch we consider "control").
+   * The slug of the reference branch             (i.e., the branch we consider "control").
    */
   referenceBranch: string | null;
   /**
-   * The list of locale codes (e.g., "en-US" or "fr") that this experiment is targeting.
-   *
-   * If null, all locales are targeted.
+   * The list of locale codes (e.g., "en-US" or "fr") that this             experiment is targeting. If null, all locales are targeted.
    */
   locales?: string[] | null;
   /**
-   * The date that this experiment was first published to Remote Settings.
-   *
-   * If null, it has not yet been published.
+   * The date that this experiment was first published to             Remote Settings. If null, it has not yet been published.
    */
   publishedDate?: string | null;
   /**
@@ -503,7 +348,7 @@ export interface DesktopNimbusExperiment {
    */
   branches: DesktopExperimentBranch[];
   /**
-   * When this property is set to true, treat this experiment as aFirefox Labs experiment
+   * When this property is set to true, treat this experiment as a             Firefox Labs experiment
    */
   isFirefoxLabsOptIn?: boolean;
   /**
@@ -519,7 +364,7 @@ export interface DesktopNimbusExperiment {
    */
   firefoxLabsDescription?: string | null;
   /**
-   * Links that will be used with the firefoxLabsDescription Fluent ID. May be null for Firefox Labs Opt-In recipes that do not use links.
+   * Links that will be used with the Firefox Labs             description Fluent ID. May be null for Firefox Labs Opt-In recipes                 that do not use links.
    */
   firefoxLabsDescriptionLinks?: {
     [k: string]: string;
@@ -530,8 +375,6 @@ export interface DesktopNimbusExperiment {
   featureValidationOptOut?: boolean;
   /**
    * Does the experiment require a restart to take effect?
-   *
-   * Only used by Firefox Labs Opt-Ins.
    */
   requiresRestart?: boolean;
   localizations?: ExperimentLocalizations | null;
@@ -546,8 +389,7 @@ export interface DesktopExperimentBranch {
   slug: string;
   /**
    * Relative ratio of population for the branch.
-   *
-   * e.g., if branch A=1 and branch B=3, then branch A would get 25% of the population.
+   * e.g., if branch A=1 and branch B=3, then branch A                 would get 25% of the population.
    */
   ratio: number;
   /**
@@ -560,15 +402,123 @@ export interface DesktopExperimentBranch {
   firefoxLabsTitle?: string | null;
 }
 /**
- * The SDK-specific feature manifest.
+ * A Nimbus experiment for Nimbus SDK-based applications.
  */
-export interface SdkFeatureManifest {
-  [k: string]: SdkFeature;
+export interface SdkNimbusExperiment {
+  /**
+   * Version of the NimbusExperiment schema this experiment refers to
+   */
+  schemaVersion: string;
+  /**
+   * Unique identifier for the experiment
+   */
+  slug: string;
+  /**
+   * Unique identifier for the experiment. This is a duplicate of slug,             but is required field for all Remote Settings records.
+   */
+  id: string;
+  /**
+   * A slug identifying the targeted product of this experiment.             It should be a lowercased_with_underscores name that is short and                 unambiguous and it should match the app_name found in                     https://probeinfo.telemetry.mozilla.org/glean/repositories.                         Examples are "fenix" and "firefox_desktop".
+   */
+  appName: string;
+  /**
+   * The platform identifier for the targeted app.             This should match app's identifier exactly as it appears in                 the relevant app store listing (for relevant platforms) or the app's                      Glean initialization (for other platforms). Examples are                       "org.mozilla.firefox_beta" and "firefox-desktop".
+   */
+  appId: string;
+  /**
+   * A specific channel of an application such as 'nightly',             'beta', or 'release'.
+   */
+  channel: string;
+  /**
+   * Public name of the experiment displayed on 'about:studies'.
+   */
+  userFacingName: string;
+  /**
+   * Short public description of the experiment.             that will be displayed on "about:studies".
+   */
+  userFacingDescription: string;
+  /**
+   * When this property is set to true, the SDK should not enroll              new users into the experiment that have not already been enrolled.
+   */
+  isEnrollmentPaused: boolean;
+  /**
+   * When this property is set to true, treat this experiment               as a rollout. Rollouts are currently handled as single-branch               experiments separated from the bucketing namespace for normal experiments.               See-also: https://mozilla-hub.atlassian.net/browse/SDK-405
+   */
+  isRollout?: boolean;
+  bucketConfig: ExperimentBucketConfig;
+  /**
+   * List of outcomes relevant to analysis.
+   */
+  outcomes?: ExperimentOutcome[];
+  /**
+   * A list of featureIds the experiment contains configurations for.
+   */
+  featureIds?: string[];
+  /**
+   * A JEXL targeting expression used to filter out experiments.
+   */
+  targeting?: string | null;
+  /**
+   * Actual publish date of the experiment.         Note that this value is expected to be null in Remote Settings.
+   */
+  startDate: string | null;
+  /**
+   * Actual enrollment end date of the experiment.             Note that this value is expected to be null in Remote Settings.
+   */
+  enrollmentEndDate?: string | null;
+  /**
+   * Actual end date of this experiment.              Note that this field is expected to be null in Remote Settings.
+   */
+  endDate: string | null;
+  /**
+   * Duration of the experiment from the start date in days.             Note that this property is only used during the analysis phase                 (i.e., not by the SDK).
+   */
+  proposedDuration?: number;
+  /**
+   * This represents the number of days that we expect to             enroll new users. Note that this property is only used during                  the analysis phase (i.e., not by the SDK).
+   */
+  proposedEnrollment: number;
+  /**
+   * The slug of the reference branch             (i.e., the branch we consider "control").
+   */
+  referenceBranch: string | null;
+  /**
+   * The list of locale codes (e.g., "en-US" or "fr") that this             experiment is targeting. If null, all locales are targeted.
+   */
+  locales?: string[] | null;
+  /**
+   * The date that this experiment was first published to             Remote Settings. If null, it has not yet been published.
+   */
+  publishedDate?: string | null;
+  /**
+   * Branch configuration for the SDK experiment.
+   */
+  branches: SdkExperimentBranch[];
+}
+/**
+ * The branch definition for SDK-based applications.
+ *
+ * Supported on Firefox for Android 96+, Firefox for iOS 39+, and all versions of Cirrus.
+ */
+export interface SdkExperimentBranch {
+  /**
+   * Identifier for the branch.
+   */
+  slug: string;
+  /**
+   * Relative ratio of population for the branch.
+   * e.g., if branch A=1 and branch B=3, then branch A                 would get 25% of the population.
+   */
+  ratio: number;
+  /**
+   * An array of feature configurations.
+   */
+  features: ExperimentFeatureConfig[];
 }
 /**
  * A feature.
  */
-export interface SdkFeature {
+export interface DesktopFeature {
   /**
    * The description of the feature.
    */
@@ -583,59 +533,143 @@ export interface SdkFeature {
    * Only required if hasExposure is true.
    */
   exposureDescription?: string;
+  /**
+   * The owner of the feature.
+   */
+  owner: string;
+  /**
+   * If true, the feature values will be cached in prefs so that they can be read before Nimbus is initialized during Firefox startup.
+   */
+  isEarlyStartup?: boolean;
+  /**
+   * The applications that can enroll in experiments for this feature.
+   *
+   * Defaults to "firefox-desktop".
+   */
+  applications?: DesktopApplication[];
   /**
    * The variables that this feature can set.
    */
   variables: {
-    [k: string]: SdkFeatureVariable;
+    [k: string]: DesktopFeatureVariable;
   };
+  schema?: NimbusFeatureSchema;
+  /**
+   * If true, clients can enroll in multiple experiments and rollouts that use this feature.
+   */
+  allowCoenrollment?: boolean;
 }
 /**
  * A feature variable.
  */
-export interface SdkFeatureVariable {
+export interface DesktopFeatureVariable {
   /**
    * A description of the feature.
    */
   description: string;
   type: FeatureVariableType;
   /**
-   * An optional list of possible string values.
+   * An optional list of possible string or integer values.
    *
-   * Only allowed when type is string.
+   * Only allowed when type is string or int.
+   *
+   * The types in the enum must match the type of the field.
    */
-  enum?: string[];
+  enum?: string[] | number[];
+  /**
+   * A pref that provides the default value for a feature when none is present.
+   */
+  fallbackPref?: string;
+  /**
+   * A pref that should be set to the value of this variable when enrolling in experiments.
+   *
+   * Using a string is deprecated and unsupported in Firefox 124+.
+   */
+  setPref?: string | SetPref;
+}
+export interface SetPref {
+  branch: PrefBranch;
+  /**
+   * The name of the pref to set.
+   */
+  pref: string;
 }
 /**
- * A Nimbus experiment for Nimbus SDK-based applications.
+ * Information about a JSON schema.
  */
-export interface SdkNimbusExperiment {
+export interface NimbusFeatureSchema {
   /**
-   * Branch configuration for the experiment.
+   * The resource:// or chrome:// URI that can be loaded at runtime within Firefox.
+   *
+   * Required by Firefox so that Nimbus can import the schema for validation.
    */
-  branches: SdkExperimentBranch[];
+  uri: string;
+  /**
+   * The path to the schema file in the source checkout.
+   *
+   * Required by Experimenter so that it can find schema files in source checkouts.
+   */
+  path: string;
 }
 /**
- * The branch definition for SDK-based applications
+ * The Firefox Desktop-specific feature manifest.
  *
- * Supported on Firefox for Android 96+ and Firefox for iOS 39+ and all versions of
- * Cirrus.
+ * Firefox Desktop requires different fields for its features compared to the general
+ * Nimbus feature manifest.
  */
-export interface SdkExperimentBranch {
+export interface DesktopFeatureManifest {
+  [k: string]: DesktopFeature;
+}
+/**
+ * The SDK-specific feature manifest.
+ */
+export interface SdkFeatureManifest {
+  [k: string]: SdkFeature;
+}
+/**
+ * A feature.
+ */
+export interface SdkFeature {
   /**
-   * Identifier for the branch.
+   * The description of the feature.
    */
-  slug: string;
+  description: string;
   /**
-   * Relative ratio of population for the branch.
+   * Whether or not this feature records exposure telemetry.
+   */
+  hasExposure: boolean;
+  /**
+   * A description of the exposure telemetry collected by this feature.
    *
-   * e.g., if branch A=1 and branch B=3, then branch A would get 25% of the population.
+   * Only required if hasExposure is true.
    */
-  ratio: number;
+  exposureDescription?: string;
   /**
-   * An array of feature configurations.
+   * The variables that this feature can set.
    */
-  features: ExperimentFeatureConfig[];
+  variables: {
+    [k: string]: SdkFeatureVariable;
+  };
+  /**
+   * If true, clients can enroll in multiple experiments and rollouts that use this feature.
+   */
+  "allow-coenrollment"?: boolean;
+}
+/**
+ * A feature variable.
+ */
+export interface SdkFeatureVariable {
+  /**
+   * A description of the feature.
+   */
+  description: string;
+  type: FeatureVariableType;
+  /**
+   * An optional list of possible string values.
+   *
+   * Only allowed when type is string.
+   */
+  enum?: string[];
 }
 export interface AnalysisError {
   analysis_basis?: AnalysisBasis | null;