feature

type EvaluationContext struct {
	UserID   string         `json:"user_id,omitempty"`
	TenantID string         `json:"tenant_id,omitempty"`
	Groups   []string       `json:"groups,omitempty"`
	Attrs    map[string]any `json:"attrs,omitempty"`
}

type FeatureManager interface {
	// EvaluateBool evaluates a boolean feature flag.
	EvaluateBool(ctx context.Context, flagKey string, defaultVal bool, evalCtx EvaluationContext) bool

	// EvaluateString evaluates a string feature flag.
	EvaluateString(ctx context.Context, flagKey string, defaultVal string, evalCtx EvaluationContext) string

	// EvaluateInt evaluates an integer feature flag.
	EvaluateInt(ctx context.Context, flagKey string, defaultVal int, evalCtx EvaluationContext) int

	// EvaluateJSON evaluates a JSON object feature flag into the target out interface.
	EvaluateJSON(ctx context.Context, flagKey string, out any, evalCtx EvaluationContext) error
}