flag

type ContextKey = scope.ContextKey

type CreateInput struct {
	Key          string
	Type         Type
	DefaultValue any
	Description  string
	Tags         []string
	Enabled      bool
}

type Definition struct {
	core.Entity
	ID           id.ID             `json:"id"`
	Key          string            `json:"key"`
	Type         Type              `json:"type"`
	DefaultValue any               `json:"default_value"`
	Description  string            `json:"description"`
	Tags         []string          `json:"tags,omitempty"`
	Variants     []Variant         `json:"variants,omitempty"`
	Enabled      bool              `json:"enabled"`
	AppID        string            `json:"app_id"`
	Metadata     map[string]string `json:"metadata,omitempty"`
}

type Detail struct {
	Value       any         `json:"value"`
	Reason      string      `json:"reason"`
	MatchedRule *Rule       `json:"matched_rule,omitempty"`
	Trace       []TraceStep `json:"trace"`
}

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

type EngineOption func(*Engine)

type ListOpts struct {
	Limit  int
	Offset int
	AppID  string

	// Type restricts the list to flags of one value type. Empty means every
	// type.
	Type Type
}

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

type ManagerOption func(*Manager)

type Rule struct {
	core.Entity
	ID          id.ID      `json:"id"`
	FlagKey     string     `json:"flag_key"`
	AppID       string     `json:"app_id"`
	Priority    int        `json:"priority"` // lower = higher priority
	Type        RuleType   `json:"type"`
	Config      RuleConfig `json:"config"`
	ReturnValue any        `json:"return_value"`
}

type RuleConfig struct {
	// WhenTenant: match specific tenant IDs.
	TenantIDs []string `json:"tenant_ids,omitempty"`

	// WhenTenantTag: match tenants with a specific tag.
	TagKey   string `json:"tag_key,omitempty"`
	TagValue string `json:"tag_value,omitempty"`

	// WhenUser: match specific user IDs.
	UserIDs []string `json:"user_ids,omitempty"`

	// Rollout: percentage (0-100).
	Percentage int `json:"percentage,omitempty"`

	// Schedule: time-based activation.
	StartAt *time.Time `json:"start_at,omitempty"`
	EndAt   *time.Time `json:"end_at,omitempty"`

	// Custom: plugin-evaluated.
	Evaluator string         `json:"evaluator,omitempty"` // plugin name
	Params    map[string]any `json:"params,omitempty"`
}

type RuleInput struct {
	Type        RuleType
	Config      RuleConfig
	ReturnValue any
}

type RuleType string

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

type ServiceOption func(*Service)

type Store interface {
	// DefineFlag creates or updates a flag definition.
	DefineFlag(ctx context.Context, f *Definition) error

	// GetFlagDefinition retrieves a flag definition by key and app ID.
	GetFlagDefinition(ctx context.Context, key, appID string) (*Definition, error)

	// ListFlagDefinitions returns the flag definitions for an app in key
	// order, filtered by opts.Type and then paged. An empty result is an
	// empty slice, never nil.
	ListFlagDefinitions(ctx context.Context, appID string, opts ListOpts) ([]*Definition, error)

	// DeleteFlagDefinition removes a flag definition and its rules.
	DeleteFlagDefinition(ctx context.Context, key, appID string) error

	// SetFlagRules replaces all targeting rules for a flag.
	SetFlagRules(ctx context.Context, key, appID string, rules []*Rule) error

	// GetFlagRules returns targeting rules for a flag, ordered by priority.
	GetFlagRules(ctx context.Context, key, appID string) ([]*Rule, error)

	// SetFlagTenantOverride sets a direct per-tenant override value.
	SetFlagTenantOverride(ctx context.Context, key, appID, tenantID string, value any) error

	// GetFlagTenantOverride retrieves a tenant override for a flag.
	GetFlagTenantOverride(ctx context.Context, key, appID, tenantID string) (any, error)

	// DeleteFlagTenantOverride removes a tenant override.
	DeleteFlagTenantOverride(ctx context.Context, key, appID, tenantID string) error

	// ListFlagTenantOverrides returns all tenant overrides for a flag.
	ListFlagTenantOverrides(ctx context.Context, key, appID string) ([]*TenantOverride, error)

	// CountFlagDefinitions returns the total number of flag definitions for
	// an app, independent of any paging.
	CountFlagDefinitions(ctx context.Context, appID string) (int64, error)

	// CountFlagDefinitionsMatching returns the number of flag definitions for
	// an app that match opts.Type. Limit and Offset are ignored, so it is the
	// total behind a page returned by ListFlagDefinitions with the same opts.
	CountFlagDefinitionsMatching(ctx context.Context, appID string, opts ListOpts) (int64, error)
}

type TenantOverride struct {
	core.Entity
	ID       id.ID  `json:"id"`
	FlagKey  string `json:"flag_key"`
	AppID    string `json:"app_id"`
	TenantID string `json:"tenant_id"`
	Value    any    `json:"value"`
}

type TraceStep struct {
	RuleID   string   `json:"rule_id"`
	Priority int      `json:"priority"`
	Type     RuleType `json:"type"`
	Matched  bool     `json:"matched"`
	Reached  bool     `json:"reached"`
	Note     string   `json:"note,omitempty"`
}

type Type string

type UpdateInput struct {
	Description  *string
	DefaultValue *any
	Tags         *[]string
}

type ValidationError struct {
	Field   string
	Message string
}

type Variant struct {
	Value       any    `json:"value"`
	Description string `json:"description"`
}