providers

type FlagConfig struct {
	// Key is the unique flag identifier
	Key string `json:"key" yaml:"key"`

	// Name is the human-readable name
	Name string `json:"name" yaml:"name"`

	// Description describes what this flag controls
	Description string `json:"description" yaml:"description"`

	// Type is the flag value type: "boolean", "string", "number", "json"
	Type string `json:"type" yaml:"type"`

	// Enabled is the default enabled state for boolean flags
	Enabled bool `json:"enabled" yaml:"enabled"`

	// Value is the default value for non-boolean flags
	Value any `json:"value" yaml:"value"`

	// Targeting defines user/group targeting rules
	Targeting []TargetingRule `json:"targeting" yaml:"targeting"`

	// Rollout defines percentage-based rollout
	Rollout *RolloutConfig `json:"rollout" yaml:"rollout"`
}

type FlagsmithConfig struct {
	// EnvironmentKey is your Flagsmith environment key
	EnvironmentKey string `json:"environment_key" yaml:"environment_key"`

	// APIURL is the Flagsmith API URL (default: https://edge.api.flagsmith.com/api/v1/)
	APIURL string `json:"api_url" yaml:"api_url"`

	// EnableLocalEvaluation enables local flag evaluation
	EnableLocalEvaluation bool `json:"enable_local_evaluation" yaml:"enable_local_evaluation"`

	// EnableAnalytics enables analytics tracking
	EnableAnalytics bool `json:"enable_analytics" yaml:"enable_analytics"`

	// CustomHeaders for additional HTTP headers
	CustomHeaders map[string]string `json:"custom_headers" yaml:"custom_headers"`

	// RequestTimeout in seconds
	RequestTimeout int `json:"request_timeout" yaml:"request_timeout"`

	// Retries for failed requests
	Retries int `json:"retries" yaml:"retries"`
}

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

type LaunchDarklyConfig struct {
	// SDKKey is your LaunchDarkly SDK key
	SDKKey string `json:"sdk_key" yaml:"sdk_key"`

	// BaseURI for custom endpoints (optional)
	BaseURI string `json:"base_uri" yaml:"base_uri"`

	// StreamURI for streaming connections (optional)
	StreamURI string `json:"stream_uri" yaml:"stream_uri"`

	// EventsURI for analytics events (optional)
	EventsURI string `json:"events_uri" yaml:"events_uri"`

	// StartWaitTime is the maximum time to wait for initialization
	StartWaitTime time.Duration `json:"start_wait_time" yaml:"start_wait_time"`

	// Offline mode for testing
	Offline bool `json:"offline" yaml:"offline"`

	// EnableEvents controls whether to send analytics events
	EnableEvents bool `json:"enable_events" yaml:"enable_events"`
}

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

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

type LocalProviderConfig struct {
	// Flags are the static flag definitions
	Flags map[string]FlagConfig `json:"flags" yaml:"flags"`
}

type PostHogConfig struct {
	// APIKey is your PostHog project API key
	APIKey string `json:"api_key" yaml:"api_key"`

	// Host is the PostHog host (default: https://app.posthog.com)
	Host string `json:"host" yaml:"host"`

	// PersonalAPIKey for admin operations (optional)
	PersonalAPIKey string `json:"personal_api_key" yaml:"personal_api_key"`

	// PollingInterval for flag refresh (default: 30s)
	PollingInterval time.Duration `json:"polling_interval" yaml:"polling_interval"`

	// HTTPClient allows custom HTTP client
	HTTPClient *http.Client `json:"-" yaml:"-"`

	// EnableLocalEvaluation enables local flag evaluation (faster)
	EnableLocalEvaluation bool `json:"enable_local_evaluation" yaml:"enable_local_evaluation"`
}

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

type RolloutConfig struct {
	// Percentage of users to enable (0-100)
	Percentage int `json:"percentage" yaml:"percentage"`

	// Attribute to use for consistent hashing (default: "user_id")
	Attribute string `json:"attribute" yaml:"attribute"`
}

type TargetingRule struct {
	// Attribute is the user attribute to match (e.g., "user_id", "email", "group")
	Attribute string `json:"attribute" yaml:"attribute"`

	// Operator is the comparison operator: "equals", "contains", "in", "not_in"
	Operator string `json:"operator" yaml:"operator"`

	// Values are the values to match against
	Values []string `json:"values" yaml:"values"`

	// Value is the flag value for matching users
	Value any `json:"value" yaml:"value"`
}

type UnleashConfig struct {
	// URL is the Unleash API URL
	URL string `json:"url" yaml:"url"`

	// APIToken for authentication
	APIToken string `json:"api_token" yaml:"api_token"`

	// AppName identifies your application
	AppName string `json:"app_name" yaml:"app_name"`

	// InstanceID uniquely identifies this instance (optional)
	InstanceID string `json:"instance_id" yaml:"instance_id"`

	// Environment name (optional)
	Environment string `json:"environment" yaml:"environment"`

	// ProjectName for multi-project setups (optional)
	ProjectName string `json:"project_name" yaml:"project_name"`

	// CustomHeaders for additional HTTP headers (optional)
	CustomHeaders map[string]string `json:"custom_headers" yaml:"custom_headers"`

	// DisableMetrics disables metrics reporting
	DisableMetrics bool `json:"disable_metrics" yaml:"disable_metrics"`
}

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

type UserContext struct {
	// UserID is the unique user identifier
	UserID string `json:"user_id"`

	// Email is the user email
	Email string `json:"email,omitempty"`

	// Name is the user name
	Name string `json:"name,omitempty"`

	// Groups are user group memberships
	Groups []string `json:"groups,omitempty"`

	// Attributes are custom attributes for targeting
	Attributes map[string]any `json:"attributes,omitempty"`

	// IP is the user IP address
	IP string `json:"ip,omitempty"`

	// Country is the user country code
	Country string `json:"country,omitempty"`
}