features

type Attributes struct {
	Canary       bool     `json:"canary"`
	Platforms    []string `json:"platforms"`
	Environments []string `json:"environments"`
	Regions      []string `json:"regions"`
}

type Condition struct {
	Key      string      `json:"key"`
	Operator string      `json:"operator"`
	Value    interface{} `json:"value"`
}

type EvaluationOptions struct {

	// Platform represents the platform context (e.g., "web", "mobile") from which
	// the evaluation is being made. This helps apply platform-specific rollouts.
	Platform string

	// Environment indicates the current deployment environment (e.g., "production", "staging").
	// It's used to evaluate rollout targeting based on environment.
	Environment string

	// Region indicates the geographical or logical region of the request (e.g., "us", "eu").
	// It helps evaluate region-specific rollout rules.
	Region string

	// EvaluationBucketKey is an optional identifier used to ensure deterministic bucketing during feature evaluation.
	//
	// If provided, the feature flag engine uses this ID (e.g., user ID, session ID, device ID) to calculate
	// a consistent hash-based bucket value. This ensures that the same entity (user/device/session) will
	// consistently receive the same variant across multiple evaluations, enabling reliable A/B testing,
	// canary rollouts, or gradual feature exposure.
	//
	// If EvaluationBucketKey is not provided, the engine falls back to random bucketing using a pseudo-random number generator.
	// This is useful for anonymous users or stateless scenarios but will not guarantee consistency across requests.
	EvaluationBucketKey string

	// RuleContext contains dynamic key-value pairs that represent runtime facts
	// about the user or request, such as "userTier", "userId", or "subscriptionLevel".
	// These are used to evaluate rule-based conditions within the feature definition.
	RuleContext map[string]interface{}
}

type Feature struct {
	Name         string      `json:"name"`
	Description  string      `json:"description"`
	Owner        string      `json:"owner"`
	Enabled      bool        `json:"enabled"`
	Schedule     *Schedule   `json:"schedule"`
	Datatype     string      `json:"datatype"`
	DefaultValue interface{} `json:"defaultValue"`
	Variants     []*Variant  `json:"variants"`
	Rules        *Rules      `json:"rules"`
	Rollouts     []*Rollout  `json:"rollouts"`
	Metadata     *Metadata   `json:"metadata"`
}

type FeatureConfig struct {
	Version    string              `json:"version"`
	Attributes *Attributes         `json:"attributes"`
	Features   map[string]*Feature `json:"features"`
}

type FeatureSourceType uint8 // FeatureSourceType represents the source type of the feature config.

type InitOptions struct {

	// SourceType determines the origin of the feature flag configuration.
	// Supported values are:
	//   - FeatureSourceFile: The configuration is read from a file on disk.
	//   - FeatureSourceRawBytes: The configuration is provided directly as a raw JSON string.
	SourceType FeatureSourceType

	// Input contains either the full JSON content (when SourceType is SourceRawBytes)
	// or the absolute/relative file path to the configuration file (when SourceType is SourceFile).
	Input string

	// EnableWatch indicates whether the watch functionality is enabled.
	// When set to true, the system will monitor and respond to changes in real-time.
	// When EnableWatch is true, the WatcherOptions field must be set to a valid watcher configuration.
	// This allows the system to automatically reload or update the feature flags
	EnableWatch bool

	// WatcherOptions represents the configuration options for the watcher component.
	// It allows customization of the behavior and settings of the watcher, which is
	// responsible for monitoring and responding to specific events or changes.
	//
	// Fields in WatcherOptions may include parameters such as polling intervals,
	// event filters, logging preferences, and other settings that influence how
	// the watcher operates.
	WatcherOptions *watcher.WatcherOptions
}

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

type Metadata struct {
	CreatedAt string   `json:"createdAt"`
	Tags      []string `json:"tags"`
}

type Rollout struct {
	Platform    string  `json:"platform"`
	Environment string  `json:"environment"`
	Region      string  `json:"region"`
	Percentage  float64 `json:"percentage"`
}

type Rules struct {
	Conjunction string       `json:"conjunction"`
	Conditions  []*Condition `json:"conditions"`
}

type Schedule struct {
	Start string `json:"start"`
	End   string `json:"end"`
}

type Variant struct {
	Name   string  `json:"name"`
	Weight float64 `json:"weight"`
	Label  string  `json:"label"`
}