featureflags

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

type EvaluationContext struct {
	// UserID is the current user's ID.
	UserID string

	// OrganizationID is the current organization's ID.
	OrganizationID string

	// Attributes are additional attributes for targeting.
	Attributes map[string]any
}

type Flag struct {
	// Key is the unique identifier for the flag.
	Key string `json:"key"`

	// Name is a human-readable name for the flag.
	Name string `json:"name,omitempty"`

	// Description explains what the flag controls.
	Description string `json:"description,omitempty"`

	// Enabled indicates if the flag is globally enabled.
	Enabled bool `json:"enabled"`

	// Percentage is the rollout percentage (0-100) for gradual rollouts.
	// Only applies when Enabled is true.
	Percentage int `json:"percentage,omitempty"`

	// Targets are specific user or organization IDs that should have the flag enabled.
	Targets []string `json:"targets,omitempty"`

	// Metadata holds additional flag-specific data.
	Metadata map[string]any `json:"metadata,omitempty"`
}

type Store interface {
	// Get retrieves a flag by key.
	Get(ctx context.Context, key string) (*Flag, error)

	// GetAll retrieves all flags.
	GetAll(ctx context.Context) ([]*Flag, error)

	// Set creates or updates a flag.
	Set(ctx context.Context, flag *Flag) error

	// Delete removes a flag.
	Delete(ctx context.Context, key string) error
}