cli

type APIError struct {
	StatusCode int
	Status     string
	Body       string
	Message    string
	Data       interface{}
}

type AuthRetryAction string

type AuthRetryEvent struct {
	Action      AuthRetryAction
	Attempt     int
	MaxAttempts int
	StatusCode  int
	Status      string
	Method      string
}

type Client struct {
	BaseURL         string
	Org             string
	Token           string
	APIName         string
	HTTPClient      *http.Client
	Debug           bool
	Log             *logrus.Entry
	TokenRefresh    func() (string, error)
	AuthRetryMax    int
	AuthRetryNotify func(AuthRetryEvent)
}

type Components struct {
	Schemas   map[string]*Schema     `yaml:"schemas"`
	Responses map[string]interface{} `yaml:"responses"`
}

type ConfigAPI struct {
	Base string `yaml:"base,omitempty"`
	Org  string `yaml:"org,omitempty"`
	Name string `yaml:"name,omitempty"`
}

type ConfigAPIKey struct {
	AuthnURL string `yaml:"authn_url,omitempty"`
	Key      string `yaml:"key,omitempty"`
	Token    string `yaml:"token,omitempty"`
}

type ConfigAuth struct {
	Token        string        `yaml:"token,omitempty"`
	TokenCommand string        `yaml:"token_command,omitempty"`
	OIDC         *ConfigOIDC   `yaml:"oidc,omitempty"`
	APIKey       *ConfigAPIKey `yaml:"api_key,omitempty"`
}

type ConfigFile struct {
	API  ConfigAPI  `yaml:"api"`
	Auth ConfigAuth `yaml:"auth"`
}

type ConfigOIDC struct {
	TokenURL     string `yaml:"token_url,omitempty"`
	ClientID     string `yaml:"client_id,omitempty"`
	ClientSecret string `yaml:"client_secret,omitempty"`
	Username     string `yaml:"username,omitempty"`
	Password     string `yaml:"password,omitempty"`
	Token        string `yaml:"token,omitempty"`
	RefreshToken string `yaml:"refresh_token,omitempty"`
	ExpiresAt    string `yaml:"expires_at,omitempty"`
}

type EnvOverride struct {
	// Name is the environment variable name (e.g. "NICO_BASE_URL").
	Name string
	// ConfigPath is a human-readable description of where the value lands.
	// Direct config fields use dotted YAML paths (e.g. "api.base"); env
	// vars that feed only the flag layer carry a parenthesized note instead.
	ConfigPath string
	// Value is the current value of the env var. Empty for unset env vars.
	Value string
	// Sensitive marks values that should be masked in casual display
	// (tokens, passwords, client secrets, NGC API keys).
	Sensitive bool
	// Applied is true when ApplyEnvOverrides actually wrote this value
	// back into the ConfigFile. Env vars that only feed flags
	// (e.g. NICO_KEYCLOAK_URL) are reported but not applied here.
	Applied bool
}

type MediaType struct {
	Schema *Schema `yaml:"schema"`
}

type Operation struct {
	OperationID string       `yaml:"operationId"`
	Summary     string       `yaml:"summary"`
	Description string       `yaml:"description"`
	Tags        []string     `yaml:"tags"`
	Parameters  []Parameter  `yaml:"parameters"`
	RequestBody *RequestBody `yaml:"requestBody"`
}

type Parameter struct {
	Name        string  `yaml:"name"`
	In          string  `yaml:"in"`
	Required    bool    `yaml:"required"`
	Description string  `yaml:"description"`
	Schema      *Schema `yaml:"schema"`
}

type PathItem struct {
	Parameters []Parameter `yaml:"parameters"`
	Get        *Operation  `yaml:"get"`
	Post       *Operation  `yaml:"post"`
	Patch      *Operation  `yaml:"patch"`
	Put        *Operation  `yaml:"put"`
	Delete     *Operation  `yaml:"delete"`
}

type RequestBody struct {
	Content map[string]MediaType `yaml:"content"`
}

type Schema struct {
	Ref        string             `yaml:"$ref"`
	Type       SchemaType         `yaml:"type"`
	Format     string             `yaml:"format"`
	Enum       []string           `yaml:"enum"`
	Properties map[string]*Schema `yaml:"properties"`
	Required   []string           `yaml:"required"`
	Items      *Schema            `yaml:"items"`
	MinLength  *int               `yaml:"minLength"`
	MaxLength  *int               `yaml:"maxLength"`
	Minimum    *int               `yaml:"minimum"`
	Maximum    *int               `yaml:"maximum"`
	Default    interface{}        `yaml:"default"`
}

type SchemaType string

type Server struct {
	URL         string `yaml:"url"`
	Description string `yaml:"description"`
}

type Spec struct {
	Info       SpecInfo            `yaml:"info"`
	Servers    []Server            `yaml:"servers"`
	Tags       []Tag               `yaml:"tags"`
	Paths      map[string]PathItem `yaml:"paths"`
	Components Components          `yaml:"components"`
}

type SpecInfo struct {
	Title   string `yaml:"title"`
	Version string `yaml:"version"`
}

type Tag struct {
	Name        string `yaml:"name"`
	Description string `yaml:"description"`
}

type TokenResponse struct {
	AccessToken  string `json:"access_token"`
	RefreshToken string `json:"refresh_token"`
	ExpiresIn    int    `json:"expires_in"`
	TokenType    string `json:"token_type"`
}