appconfig

type AccountSettings struct {
	DeletionProtection *DeletionProtectionSettings `json:"DeletionProtection,omitempty"`
}

type Application struct {
	CreatedAt   time.Time `json:"CreatedAt,omitzero"`
	UpdatedAt   time.Time `json:"UpdatedAt,omitzero"`
	ID          string    `json:"Id"`
	Name        string    `json:"Name"`
	Description string    `json:"Description,omitempty"`
}

type AppliedExtension struct {
	Parameters             map[string]string `json:"Parameters,omitempty"`
	ExtensionAssociationID string            `json:"ExtensionAssociationId,omitempty"`
	ExtensionID            string            `json:"ExtensionId,omitempty"`
	VersionNumber          int32             `json:"VersionNumber,omitempty"`
}

type AttributeValue struct {
	BooleanValue *bool     `json:"BooleanValue,omitempty"`
	NumberValue  *float64  `json:"NumberValue,omitempty"`
	StringValue  *string   `json:"StringValue,omitempty"`
	NumberArray  []float64 `json:"NumberArray,omitempty"`
	StringArray  []string  `json:"StringArray,omitempty"`
}

type ConfigurationProfile struct {
	ApplicationID    string      `json:"ApplicationId"`
	ID               string      `json:"Id"`
	Name             string      `json:"Name"`
	Description      string      `json:"Description,omitempty"`
	LocationURI      string      `json:"LocationUri"`
	Type             string      `json:"Type,omitempty"`
	RetrievalRoleArn string      `json:"RetrievalRoleArn,omitempty"`
	Validators       []Validator `json:"Validators,omitempty"`
}

type DeletionProtectionSettings struct {
	Enabled                   *bool  `json:"Enabled,omitempty"`
	ProtectionPeriodInMinutes *int32 `json:"ProtectionPeriodInMinutes,omitempty"`
}

type Deployment struct {
	StartedAt                   time.Time          `json:"StartedAt,omitzero"`
	CompletedAt                 time.Time          `json:"CompletedAt,omitzero"`
	ApplicationID               string             `json:"ApplicationId"`
	EnvironmentID               string             `json:"EnvironmentId"`
	ConfigurationProfileID      string             `json:"ConfigurationProfileId"`
	DeploymentStrategyID        string             `json:"DeploymentStrategyId"`
	ConfigurationVersion        string             `json:"ConfigurationVersion"`
	State                       string             `json:"State"`
	TriggeredBy                 string             `json:"TriggeredBy,omitempty"`
	Description                 string             `json:"Description,omitempty"`
	ConfigurationName           string             `json:"ConfigurationName,omitempty"`
	ConfigurationLocationURI    string             `json:"ConfigurationLocationUri,omitempty"`
	GrowthType                  string             `json:"GrowthType,omitempty"`
	VersionLabel                string             `json:"VersionLabel,omitempty"`
	EventLog                    []DeploymentEvent  `json:"EventLog,omitempty"`
	AppliedExtensions           []AppliedExtension `json:"AppliedExtensions,omitempty"`
	PercentageComplete          float32            `json:"PercentageComplete,omitempty"`
	GrowthFactor                float32            `json:"GrowthFactor,omitempty"`
	DeploymentNumber            int32              `json:"DeploymentNumber"`
	DeploymentDurationInMinutes int32              `json:"DeploymentDurationInMinutes,omitempty"`
	FinalBakeTimeInMinutes      int32              `json:"FinalBakeTimeInMinutes,omitempty"`
}

type DeploymentEvent struct {
	OccurredAt  time.Time `json:"OccurredAt,omitzero"`
	EventType   string    `json:"EventType"`
	Description string    `json:"Description,omitempty"`
	TriggeredBy string    `json:"TriggeredBy,omitempty"`
}

type DeploymentParameters struct {
	DynamicExtensionParameters map[string]string `json:"DynamicExtensionParameters,omitempty"`
	Tags                       map[string]string `json:"Tags,omitempty"`
}

type DeploymentStrategy struct {
	CreatedAt                   time.Time `json:"CreatedAt,omitzero"`
	UpdatedAt                   time.Time `json:"UpdatedAt,omitzero"`
	ID                          string    `json:"Id"`
	Name                        string    `json:"Name"`
	Description                 string    `json:"Description,omitempty"`
	GrowthType                  string    `json:"GrowthType"`
	ReplicateTo                 string    `json:"ReplicateTo"`
	DeploymentDurationInMinutes int32     `json:"DeploymentDurationInMinutes"`
	GrowthFactor                float32   `json:"GrowthFactor"`
	FinalBakeTimeInMinutes      int32     `json:"FinalBakeTimeInMinutes"`
}

type Environment struct {
	CreatedAt     time.Time `json:"CreatedAt,omitzero"`
	UpdatedAt     time.Time `json:"UpdatedAt,omitzero"`
	ApplicationID string    `json:"ApplicationId"`
	ID            string    `json:"Id"`
	Name          string    `json:"Name"`
	Description   string    `json:"Description,omitempty"`
	State         string    `json:"State"`
	Monitors      []Monitor `json:"Monitors,omitempty"`
}

type ExperimentDefinition struct {
	CreatedAt              time.Time   `json:"CreatedAt,omitzero"`
	UpdatedAt              time.Time   `json:"UpdatedAt,omitzero"`
	ApplicationID          string      `json:"ApplicationId"`
	ID                     string      `json:"Id"`
	Name                   string      `json:"Name"`
	ConfigurationProfileID string      `json:"ConfigurationProfileId"`
	EnvironmentID          string      `json:"EnvironmentId"`
	FlagKey                string      `json:"FlagKey"`
	AudienceDescription    string      `json:"AudienceDescription,omitempty"`
	AudienceRule           string      `json:"AudienceRule"`
	Hypothesis             string      `json:"Hypothesis,omitempty"`
	LaunchCriteria         string      `json:"LaunchCriteria,omitempty"`
	KmsKeyIdentifier       string      `json:"KmsKeyIdentifier,omitempty"`
	Status                 string      `json:"Status"`
	Control                Treatment   `json:"Control"`
	Treatments             []Treatment `json:"Treatments,omitempty"`
}

type ExperimentDefinitionSnapshot struct {
	ApplicationID          string      `json:"ApplicationId"`
	AudienceDescription    string      `json:"AudienceDescription,omitempty"`
	AudienceRule           string      `json:"AudienceRule"`
	ConfigurationProfileID string      `json:"ConfigurationProfileId"`
	Control                Treatment   `json:"Control"`
	EnvironmentID          string      `json:"EnvironmentId"`
	FlagKey                string      `json:"FlagKey"`
	Hypothesis             string      `json:"Hypothesis,omitempty"`
	ID                     string      `json:"Id"`
	LaunchCriteria         string      `json:"LaunchCriteria,omitempty"`
	Name                   string      `json:"Name"`
	Treatments             []Treatment `json:"Treatments,omitempty"`
}

type ExperimentRun struct {
	StartedAt                    time.Time                     `json:"StartedAt,omitzero"`
	EndedAt                      time.Time                     `json:"EndedAt,omitzero"`
	UpdatedAt                    time.Time                     `json:"UpdatedAt,omitzero"`
	ApplicationID                string                        `json:"ApplicationId"`
	ExperimentDefinitionID       string                        `json:"ExperimentDefinitionId"`
	Description                  string                        `json:"Description,omitempty"`
	Status                       string                        `json:"Status"`
	Result                       *ExperimentRunResult          `json:"Result,omitempty"`
	ExperimentDefinitionSnapshot *ExperimentDefinitionSnapshot `json:"ExperimentDefinitionSnapshot,omitempty"`
	TreatmentOverrides           TreatmentOverrides            `json:"TreatmentOverrides,omitzero"`
	Events                       []ExperimentRunEvent          `json:"-"`
	ExposurePercentage           float32                       `json:"ExposurePercentage,omitempty"`
	Run                          int32                         `json:"Run"`
}

type ExperimentRunEvent struct {
	OccurredAt           time.Time          `json:"OccurredAt,omitzero"`
	TreatmentOverrides   TreatmentOverrides `json:"TreatmentOverrides,omitzero"`
	AssociatedDeployment string             `json:"AssociatedDeployment,omitempty"`
	Description          string             `json:"Description,omitempty"`
	EventType            string             `json:"EventType"`
	TriggeredBy          string             `json:"TriggeredBy,omitempty"`
	ExposurePercentage   float32            `json:"ExposurePercentage,omitempty"`
}

type ExperimentRunResult struct {
	ExecutiveSummary   string `json:"ExecutiveSummary,omitempty"`
	ReasonsNotToLaunch string `json:"ReasonsNotToLaunch,omitempty"`
	ReasonsToLaunch    string `json:"ReasonsToLaunch,omitempty"`
}

type Extension struct {
	Actions       map[string][]ExtensionAction  `json:"Actions,omitempty"`
	Parameters    map[string]ExtensionParameter `json:"Parameters,omitempty"`
	Arn           string                        `json:"Arn"`
	Description   string                        `json:"Description,omitempty"`
	ID            string                        `json:"Id"`
	Name          string                        `json:"Name"`
	VersionNumber int32                         `json:"VersionNumber"`
}

type ExtensionAction struct {
	Name        string `json:"Name,omitempty"`
	Description string `json:"Description,omitempty"`
	RoleArn     string `json:"RoleArn,omitempty"`
	URI         string `json:"Uri,omitempty"`
}

type ExtensionAssociation struct {
	Parameters             map[string]string `json:"Parameters,omitempty"`
	Arn                    string            `json:"Arn"`
	ExtensionArn           string            `json:"ExtensionArn"`
	ID                     string            `json:"Id"`
	ResourceArn            string            `json:"ResourceArn"`
	ExtensionVersionNumber int32             `json:"ExtensionVersionNumber"`
}

type ExtensionParameter struct {
	Description string `json:"Description,omitempty"`
	Required    bool   `json:"Required,omitempty"`
}

type FlagValue struct {
	AttributeValues map[string]AttributeValue `json:"AttributeValues,omitempty"`
	Enabled         bool                      `json:"Enabled"`
}

type Handler struct {
	Backend StorageBackend
}

type HostedConfigurationVersion struct {
	CreatedAt              time.Time `json:"CreatedAt,omitzero"`
	ApplicationID          string    `json:"ApplicationId"`
	ConfigurationProfileID string    `json:"ConfigurationProfileId"`
	ContentType            string    `json:"ContentType"`
	Description            string    `json:"Description,omitempty"`
	VersionLabel           string    `json:"VersionLabel,omitempty"`
	Content                []byte    `json:"-"`
	VersionNumber          int32     `json:"VersionNumber"`
}

type InMemoryBackend struct {
	// contains filtered or unexported fields
}

type Monitor struct {
	AlarmArn     string `json:"AlarmArn"`
	AlarmRoleArn string `json:"AlarmRoleArn,omitempty"`
}

type Provider struct{}

type StorageBackend interface {
	// PaginationSecret returns the HMAC secret used to sign pagination tokens.
	PaginationSecret() string

	// Snapshot and Restore implement persistence.Persistable. Handler
	// delegates to them (see persistence.go) so cli.go's generic
	// setupPersistence picks AppConfig up.
	Snapshot(ctx context.Context) []byte
	Restore(ctx context.Context, data []byte) error

	// CreateApplication creates a new AppConfig application. tags are
	// applied inline at creation time (see CreateExperimentDefinition's
	// doc comment for why TagResource is not used for this).
	CreateApplication(name, description string, tags map[string]string) (*Application, error)
	// GetApplication retrieves an application by ID.
	GetApplication(applicationID string) (*Application, error)
	// ListApplications returns paginated applications.
	ListApplications(nextToken string, maxResults int) ([]Application, string)
	// UpdateApplication updates an application's name and description. A nil
	// name/description means the field was omitted from the request and must
	// be left unchanged (real UpdateApplicationInput.Name/Description are
	// optional *string members; only a present, non-nil member overwrites
	// the existing value -- see AWS AppConfig's UpdateApplication contract).
	UpdateApplication(applicationID string, name, description *string) (*Application, error)
	// DeleteApplication deletes an application by ID.
	DeleteApplication(applicationID string) error

	// CreateEnvironment creates a new environment within an application.
	// tags are applied inline at creation time (see CreateApplication).
	CreateEnvironment(
		applicationID, name, description string,
		monitors []Monitor,
		tags map[string]string,
	) (*Environment, error)
	// GetEnvironment retrieves an environment by application and environment ID.
	GetEnvironment(applicationID, environmentID string) (*Environment, error)
	// ListEnvironments returns paginated environments for an application.
	ListEnvironments(applicationID, nextToken string, maxResults int) ([]Environment, string, error)
	// UpdateEnvironment updates an environment's name, description, and
	// monitors. A nil name/description leaves the field unchanged (see
	// UpdateApplication doc); a nil monitors leaves the existing monitor
	// list unchanged, while a non-nil (possibly empty) slice replaces it,
	// matching UpdateEnvironmentInput's optional Monitors member.
	UpdateEnvironment(
		applicationID, environmentID string,
		name, description *string,
		monitors *[]Monitor,
	) (*Environment, error)
	// DeleteEnvironment deletes an environment.
	DeleteEnvironment(applicationID, environmentID string) error

	// CreateConfigurationProfile creates a new configuration profile. tags
	// are applied inline at creation time (see CreateApplication).
	CreateConfigurationProfile(
		applicationID, name, description, locationURI, profileType, retrievalRoleArn string,
		validators []Validator,
		tags map[string]string,
	) (*ConfigurationProfile, error)
	// GetConfigurationProfile retrieves a configuration profile.
	GetConfigurationProfile(applicationID, profileID string) (*ConfigurationProfile, error)
	// ListConfigurationProfiles returns paginated profiles for an application.
	ListConfigurationProfiles(
		applicationID, nextToken string,
		maxResults int,
	) ([]ConfigurationProfile, string, error)
	// UpdateConfigurationProfile updates a configuration profile. Nil
	// name/description/retrievalRoleArn leave the field unchanged; a nil
	// validators leaves the existing validator list unchanged, while a
	// non-nil (possibly empty) slice replaces it -- matching
	// UpdateConfigurationProfileInput's optional members.
	UpdateConfigurationProfile(
		applicationID, profileID string,
		name, description, retrievalRoleArn *string,
		validators *[]Validator,
	) (*ConfigurationProfile, error)
	// DeleteConfigurationProfile deletes a configuration profile.
	DeleteConfigurationProfile(applicationID, profileID string) error

	// CreateHostedConfigurationVersion creates a hosted configuration
	// version. latestVersionNumber implements the optional
	// optimistic-concurrency check real AWS binds to the
	// "Latest-Version-Number" request header: when non-nil, it must match
	// the profile's current latest version or the call is rejected.
	CreateHostedConfigurationVersion(
		applicationID, profileID, contentType, description, versionLabel string,
		content []byte,
		latestVersionNumber *int32,
	) (*HostedConfigurationVersion, error)
	// GetHostedConfigurationVersion retrieves a hosted configuration version.
	GetHostedConfigurationVersion(
		applicationID, profileID string,
		versionNumber int32,
	) (*HostedConfigurationVersion, error)
	// ListHostedConfigurationVersions returns paginated versions for a profile.
	ListHostedConfigurationVersions(
		applicationID, profileID, nextToken, versionLabel string,
		maxResults int,
	) ([]HostedConfigurationVersion, string, error)
	// DeleteHostedConfigurationVersion deletes a hosted configuration version.
	DeleteHostedConfigurationVersion(applicationID, profileID string, versionNumber int32) error

	// CreateDeploymentStrategy creates a new deployment strategy. tags are
	// applied inline at creation time (see CreateApplication).
	CreateDeploymentStrategy(
		name, description string,
		deploymentDuration, bakeTime int32,
		growthFactor float32,
		growthType, replicateTo string,
		tags map[string]string,
	) (*DeploymentStrategy, error)
	// GetDeploymentStrategy retrieves a deployment strategy by ID.
	GetDeploymentStrategy(strategyID string) (*DeploymentStrategy, error)
	// ListDeploymentStrategies returns paginated deployment strategies.
	ListDeploymentStrategies(nextToken string, maxResults int) ([]DeploymentStrategy, string)
	// UpdateDeploymentStrategy updates a deployment strategy. A nil
	// description leaves the field unchanged (real
	// UpdateDeploymentStrategyInput.Description is an optional *string
	// member); name has no counterpart in the real API and is applied only
	// when non-empty, matching this backend's pre-existing behavior.
	UpdateDeploymentStrategy(
		strategyID, name string,
		description *string,
		deploymentDuration, bakeTime int32,
		growthFactor float32,
	) (*DeploymentStrategy, error)
	// DeleteDeploymentStrategy deletes a deployment strategy.
	DeleteDeploymentStrategy(strategyID string) error

	// StartDeployment starts a deployment.
	StartDeployment(
		applicationID, environmentID, configProfileID, strategyID, configVersion, description string,
	) (*Deployment, error)
	// GetDeployment retrieves a deployment by application, environment, and deployment number.
	GetDeployment(applicationID, environmentID string, deploymentNumber int32) (*Deployment, error)
	// ListDeployments returns paginated deployments for an environment.
	ListDeployments(
		applicationID, environmentID, nextToken string,
		maxResults int,
	) ([]Deployment, string, error)
	// StopDeployment stops an in-progress deployment, or -- when
	// allowRevert is true and the deployment is already COMPLETE --
	// reverts the environment to the previous configuration version
	// (real StopDeploymentInput.AllowRevert semantics).
	StopDeployment(applicationID, environmentID string, deploymentNumber int32, allowRevert bool) error

	// ListTagsForResource returns the tags for a resource by ARN.
	ListTagsForResource(resourceArn string) (map[string]string, error)
	// TagResource adds or updates tags on a resource.
	TagResource(resourceArn string, tags map[string]string) error
	// UntagResource removes tags from a resource.
	UntagResource(resourceArn string, tagKeys []string) error

	// CreateExtension creates a new AppConfig extension. tags are applied
	// inline at creation time (see CreateApplication).
	CreateExtension(
		name, description string,
		actions map[string][]ExtensionAction,
		parameters map[string]ExtensionParameter,
		tags map[string]string,
	) (*Extension, error)
	// GetExtension retrieves an extension by identifier (ID or name) and
	// optional version number (0 means unspecified: the highest version).
	GetExtension(extensionIdentifier string, versionNumber int32) (*Extension, error)
	// ListExtensions returns paginated extensions, optionally filtered by name.
	ListExtensions(
		nextToken string,
		maxResults int,
		nameFilter string,
	) ([]Extension, string)
	// UpdateExtension updates an extension's description, actions, and
	// parameters. A nil description leaves the field unchanged (real
	// UpdateExtensionInput.Description is an optional *string member).
	UpdateExtension(
		extensionIdentifier string,
		description *string,
		actions map[string][]ExtensionAction,
		parameters map[string]ExtensionParameter,
	) (*Extension, error)
	// DeleteExtension deletes an extension version by identifier (ID or
	// name) and optional version number (0 means unspecified: the highest
	// version).
	DeleteExtension(extensionIdentifier string, versionNumber int32) error

	// CreateExtensionAssociation creates an association between an
	// extension and a resource. tags are applied inline at creation time
	// (see CreateApplication).
	CreateExtensionAssociation(
		extensionIdentifier, resourceIdentifier string,
		parameters map[string]string,
		extensionVersionNumber *int32,
		tags map[string]string,
	) (*ExtensionAssociation, error)
	// GetExtensionAssociation retrieves an extension association by ID.
	GetExtensionAssociation(extensionAssociationID string) (*ExtensionAssociation, error)
	// ListExtensionAssociations returns paginated extension associations.
	ListExtensionAssociations(
		nextToken, extensionIdentifier, resourceIdentifier string,
		maxResults int,
	) ([]ExtensionAssociation, string)
	// UpdateExtensionAssociation updates an extension association's parameters.
	UpdateExtensionAssociation(
		extensionAssociationID string,
		parameters map[string]string,
	) (*ExtensionAssociation, error)
	// DeleteExtensionAssociation deletes an extension association by ID.
	DeleteExtensionAssociation(extensionAssociationID string) error

	// GetAccountSettings returns the account-level AppConfig settings.
	GetAccountSettings() (*AccountSettings, error)
	// UpdateAccountSettings updates account-level AppConfig settings.
	UpdateAccountSettings(deletionProtection *DeletionProtectionSettings) (*AccountSettings, error)

	// GetConfiguration retrieves the latest deployed configuration (deprecated API).
	GetConfiguration(
		application, environment, configuration string,
	) (*HostedConfigurationVersion, error)
	// ValidateConfiguration validates a configuration version against its validators.
	ValidateConfiguration(applicationID, profileID, configurationVersion string) error

	// CurrentDeployedConfiguration returns the content, content type, and
	// version label of the configuration currently active (the most
	// recently COMPLETEd deployment) for the given
	// application/environment/configuration-profile, each resolved by ID
	// or name exactly like GetConfiguration. It has no caller within this
	// package today -- it is a public read accessor exposed for a future
	// appconfig -> appconfigdata bridge (bd gopherstack-uiyi): once a
	// deployment completes, cli.go wiring (out of scope for this change)
	// can call this and push the result into
	// appconfigdata's SetConfiguration(app, env, profile, content,
	// contentType) so GetLatestConfiguration polling reflects real
	// deployment state instead of an unpopulated store.
	CurrentDeployedConfiguration(
		application, environment, configuration string,
	) (content []byte, contentType, versionLabel string, err error)

	// CreateExperimentDefinition creates a new experiment definition
	// attached to a feature-flag configuration profile. applicationIdentifier,
	// environmentIdentifier, and configurationProfileIdentifier are each
	// resolved by ID or name and validated against real backend state.
	// control must be non-nil with a non-nil FlagValue; every element of
	// treatments must likewise carry a non-nil FlagValue. Key on both is
	// server-generated (see the Treatment doc comment in models.go). tags
	// are applied inline to the new definition's ARN at creation time (see
	// CreateExperimentDefinition's doc comment in experiment_definitions.go
	// for why -- avoids the inline-Tags-dropped bug tracked by bd
	// gopherstack-lcan).
	CreateExperimentDefinition(
		applicationIdentifier, name, environmentIdentifier, configurationProfileIdentifier, flagKey,
		audienceRule, audienceDescription, hypothesis, launchCriteria string,
		control *Treatment,
		treatments []Treatment,
		tags map[string]string,
	) (*ExperimentDefinition, error)
	// GetExperimentDefinition retrieves an experiment definition by
	// application and experiment definition identifier (each accepted by
	// ID or name).
	GetExperimentDefinition(
		applicationIdentifier, experimentDefinitionIdentifier string,
	) (*ExperimentDefinition, error)
	// ListExperimentDefinitions returns experiment definitions across the
	// account, optionally filtered by application/configuration-profile/
	// environment identifier and status. An identifier filter that cannot
	// be resolved yields an empty result (a filter with no matches), not
	// an error.
	ListExperimentDefinitions(
		applicationIdentifier, configurationProfileIdentifier, environmentIdentifier, status, nextToken string,
		maxResults int,
	) ([]ExperimentDefinition, string)
	// UpdateExperimentDefinition updates an experiment definition. A nil
	// pointer field means the request omitted it and it is left unchanged;
	// a non-nil treatments fully replaces the treatment list (fresh Keys
	// assigned). Returns ErrConflict if a RUNNING run currently exists for
	// this definition, matching real AWS's "cannot update ... while an
	// experiment run is active."
	UpdateExperimentDefinition(
		applicationIdentifier, experimentDefinitionIdentifier string,
		audienceDescription, audienceRule *string,
		control *Treatment,
		hypothesis, launchCriteria *string,
		treatments *[]Treatment,
	) (*ExperimentDefinition, error)
	// DeleteExperimentDefinition archives (deleteType "ARCHIVE", the
	// default this backend applies when deleteType is empty -- see the doc
	// comment in experiment_definitions.go for why) or permanently
	// destroys (deleteType "DESTROY") an experiment definition. DESTROY
	// cascade-deletes every run, run event, and tag scoped to it.
	DeleteExperimentDefinition(applicationIdentifier, experimentDefinitionIdentifier, deleteType string) error

	// StartExperimentRun starts a new run of an experiment definition.
	// Only one run may be RUNNING per definition at a time (ErrConflict
	// otherwise). exposurePercentage nil defaults to 0 -- see the doc
	// comment in experiment_runs.go. tags are applied inline to the new
	// run's own ARN, same inline-tagging fix as CreateExperimentDefinition.
	StartExperimentRun(
		applicationIdentifier, experimentDefinitionIdentifier, description string,
		exposurePercentage *float32,
		treatmentOverrides map[string]string,
		tags map[string]string,
	) (*ExperimentRun, error)
	// GetExperimentRun retrieves an experiment run by application,
	// experiment definition identifier, and run number.
	GetExperimentRun(
		applicationIdentifier, experimentDefinitionIdentifier string, run int32,
	) (*ExperimentRun, error)
	// ListExperimentRuns returns paginated runs for an experiment
	// definition, optionally filtered by status.
	ListExperimentRuns(
		applicationIdentifier, experimentDefinitionIdentifier, status, nextToken string,
		maxResults int,
	) ([]ExperimentRun, string, error)
	// UpdateExperimentRun updates a RUNNING experiment run's description,
	// exposure percentage (which can only increase, matching real AWS),
	// and/or treatment overrides. A nil field is left unchanged. Returns
	// ErrBadRequest if the run is not RUNNING or the new exposure
	// percentage would decrease it.
	UpdateExperimentRun(
		applicationIdentifier, experimentDefinitionIdentifier string,
		run int32,
		description *string,
		exposurePercentage *float32,
		treatmentOverrides *TreatmentOverrides,
	) (*ExperimentRun, error)
	// StopExperimentRun stops a RUNNING experiment run, moving it to DONE.
	// Returns ErrBadRequest if the run is not currently RUNNING.
	StopExperimentRun(
		applicationIdentifier, experimentDefinitionIdentifier string,
		run int32,
		result *ExperimentRunResult,
	) (*ExperimentRun, error)
	// ListExperimentRunEvents returns the events this backend actually
	// recorded during the run's lifecycle (RUN_STARTED/EXPOSURE_UPDATED/
	// OVERRIDES_UPDATED/RUN_STOPPED), most-recent-first -- never a
	// fabricated timeline.
	ListExperimentRunEvents(
		applicationIdentifier, experimentDefinitionIdentifier string,
		run int32,
		nextToken string,
		maxResults int,
	) ([]ExperimentRunEvent, string, error)
}

type Treatment struct {
	FlagValue   *FlagValue `json:"FlagValue,omitempty"`
	Description string     `json:"Description,omitempty"`
	Key         string     `json:"Key,omitempty"`
	Weight      float32    `json:"Weight"`
}

type TreatmentOverrides struct {
	Inline map[string]string `json:"Inline,omitempty"`
}

type Validator struct {
	Type    string `json:"Type"`    // JSON_SCHEMA or LAMBDA
	Content string `json:"Content"` // JSON schema doc or Lambda ARN
}