spec

type AbsentRule struct {
	WhenEmptyForRequestedIDs bool `yaml:"when_empty_for_requested_ids"`
}

type Binding struct {
	API           string            `yaml:"api"`
	Each          string            `yaml:"each"`
	Capture       any               `yaml:"capture"`
	Hooks         BindingHooks      `yaml:"hooks"`
	Request       map[string]any    `yaml:"request"`
	Response      BindingResponse   `yaml:"response"`
	RequireAny    []Requirement     `yaml:"require_any"`
	RequireAll    []Requirement     `yaml:"require_all"`
	Idempotency   Idempotency       `yaml:"idempotency"`
	Retry         TransitionRetry   `yaml:"retry"`
	IDFrom        string            `yaml:"id_from"`
	RequestIDFrom string            `yaml:"request_id_from"`
	ContextFrom   map[string]string `yaml:"context_from"`
	Wait          string            `yaml:"wait"`
}

type BindingHooks struct {
	Before     []string      `yaml:"before"`
	AfterError []string      `yaml:"after_error"`
	APICalls   []HookAPICall `yaml:"api_calls"`
}

type BindingResponse struct {
	Items        string               `yaml:"items"`
	Status       string               `yaml:"status"`
	Success      []string             `yaml:"success"`
	ErrorCode    string               `yaml:"error_code"`
	ErrorMessage string               `yaml:"error_message"`
	RequestID    string               `yaml:"request_id"`
	Match        BindingResponseMatch `yaml:"match"`
}

type BindingResponseMatch struct {
	Capture string            `yaml:"capture"`
	By      []string          `yaml:"by"`
	Fields  map[string]string `yaml:"fields"`
}

type ConditionalRequirement struct {
	WhenAny    []string `yaml:"when_any"`
	RequireAny []string `yaml:"require_any"`
}

type Conflict struct {
	Any     []string `yaml:"any"`
	WithAny []string `yaml:"with_any"`
}

type Filter struct {
	Target      string        `yaml:"target"`
	Type        string        `yaml:"type"`
	KeyPrefix   string        `yaml:"key_prefix"`
	Description LocalizedText `yaml:"description"`
}

type HookAPICall struct {
	Hook      string        `yaml:"hook"`
	API       string        `yaml:"api"`
	Phase     string        `yaml:"phase"`
	Condition string        `yaml:"condition"`
	Purpose   LocalizedText `yaml:"purpose"`
}

type Idempotency struct {
	Field  string `yaml:"field"`
	Prefix string `yaml:"prefix"`
}

type Identity struct {
	Field      string     `yaml:"field"`
	Prefix     string     `yaml:"prefix"`
	OutputRoot OutputRoot `yaml:"output_root"`
}

type LocalizedText map[string]string

type Operation struct {
	Description LocalizedText            `yaml:"description"`
	Help        LocalizedText            `yaml:"help"`
	Input       OperationInput           `yaml:"input"`
	RequireAny  []Requirement            `yaml:"require_any"`
	RequireWhen []ConditionalRequirement `yaml:"require_when"`
	Conflicts   []Conflict               `yaml:"conflicts"`
	Filters     map[string]Filter        `yaml:"filters"`
	Call        OperationCall            `yaml:"call"`
	Workflow    []WorkflowStep           `yaml:"workflow"`
	Emit        any                      `yaml:"emit"`
	Output      OperationOutput          `yaml:"output"`
	Examples    []string                 `yaml:"examples"`
	Aliases     []string                 `yaml:"aliases"`
}

type OperationCall struct {
	Probe    string   `yaml:"probe"`
	Many     bool     `yaml:"many"`
	IDs      []string `yaml:"ids"`
	NotFound string   `yaml:"not_found"`
}

type OperationFieldRef struct {
	Name           string
	Required       bool
	HasRequired    bool
	Repeatable     bool
	HasRepeatable  bool
	Positional     bool
	PositionalMany bool
	AllowEmpty     bool
	Brief          bool
	HasBrief       bool
	Schema         bool
	HasSchema      bool
	FlagName       string
	InputStyle     string
	Default        any
	Enum           []string
	Description    LocalizedText
}

type OperationFields []OperationFieldRef

type OperationInput struct {
	Fields   OperationFields `yaml:"fields"`
	Controls OperationFields `yaml:"controls"`
}

type OperationOutput struct {
	Fields map[string]any `yaml:"fields"`
	Select []OutputSelect `yaml:"select"`
}

type OutputRoot struct {
	One  string `yaml:"one"`
	Many string `yaml:"many"`
}

type OutputSelect struct {
	From                string   `yaml:"from"`
	Match               string   `yaml:"match"`
	By                  []string `yaml:"by"`
	Fields              []string `yaml:"fields"`
	SingleKey           string   `yaml:"single_key"`
	ManyKey             string   `yaml:"many_key"`
	First               bool     `yaml:"first"`
	UseMatchWhenMissing bool     `yaml:"use_match_when_missing"`
	FallbackToMatch     bool     `yaml:"-"`
}

type Param struct {
	Type           string        `yaml:"type"`
	Description    LocalizedText `yaml:"description"`
	Required       bool          `yaml:"required"`
	Repeatable     bool          `yaml:"repeatable"`
	Positional     bool          `yaml:"positional"`
	PositionalMany bool          `yaml:"positional_many"`
	AllowEmpty     bool          `yaml:"allow_empty"`
	FlagName       string        `yaml:"-"`
	Split          string        `yaml:"split"`
	Use            string        `yaml:"use"`
	Default        any           `yaml:"default"`
	Max            *int          `yaml:"max"`
	Enum           []string      `yaml:"enum"`
}

type Probe struct {
	API      string            `yaml:"api"`
	Request  map[string]any    `yaml:"request"`
	Response ProbeResponse     `yaml:"response"`
	Errors   map[string]string `yaml:"errors"`
}

type ProbeField struct {
	Path              string                `yaml:"path"`
	From              string                `yaml:"from"`
	Each              map[string]ProbeField `yaml:"each"`
	Lower             string                `yaml:"lower"`
	First             []string              `yaml:"first"`
	Int               string                `yaml:"int"`
	Port              string                `yaml:"port"`
	DefaultEmptyArray bool                  `yaml:"default_empty_array"`
}

type ProbeResponse struct {
	Items       string                `yaml:"items"`
	Item        string                `yaml:"item"`
	Total       string                `yaml:"total"`
	NextToken   string                `yaml:"next_token"`
	RequestID   string                `yaml:"request_id"`
	ID          string                `yaml:"id"`
	State       string                `yaml:"state"`
	Normalize   map[string]string     `yaml:"normalize"`
	Fields      map[string]ProbeField `yaml:"fields"`
	ExtraFields map[string]ProbeField `yaml:"extra_fields"`
	Absent      AbsentRule            `yaml:"absent"`
}

type ProductSpec struct {
	SchemaVersion         int           `yaml:"schema_version"`
	Product               string        `yaml:"product"`
	Aliases               []string      `yaml:"aliases"`
	Priority              int           `yaml:"priority"`
	Resources             []string      `yaml:"resources"`
	ExposeDefaultResource bool          `yaml:"expose_default_resource"`
	Description           LocalizedText `yaml:"description"`
	Examples              []string      `yaml:"examples"`
}

type Requirement struct {
	Request string `yaml:"request"`
	Raw     string `yaml:"raw"`
	Each    string `yaml:"each"`
}

type ResourceRef struct {
	Product  string
	Resource string
	Parent   string
}

type ResourceSchema struct {
	Fields map[string]SchemaField `yaml:"fields"`
}

type ResourceSpec struct {
	SchemaVersion int    `yaml:"schema_version"`
	Product       string `yaml:"product"`
	APIProduct    string `yaml:"api_product"`
	// Provider selects the request transport. Empty and "aliyun" use the
	// Alibaba Cloud OpenAPI caller; other providers must be explicitly
	// supported by the CLI.
	Provider string `yaml:"provider"`
	// FixedRegion pins the effective region for every operation of this
	// resource, overriding the user-configured region. Used for API families
	// served in a single region only: both the RegionId parameter and the
	// endpoint are resolved from the pinned region.
	FixedRegion string                   `yaml:"fixed_region"`
	Resource    string                   `yaml:"resource"`
	Parent      string                   `yaml:"parent"`
	Kind        string                   `yaml:"kind"`
	Aliases     []string                 `yaml:"aliases"`
	DisplayName LocalizedText            `yaml:"display_name"`
	Description LocalizedText            `yaml:"description"`
	Help        LocalizedText            `yaml:"help"`
	Examples    []string                 `yaml:"examples"`
	Messages    map[string]LocalizedText `yaml:"messages"`
	Identity    Identity                 `yaml:"identity"`
	Schema      ResourceSchema           `yaml:"schema"`
	Controls    map[string]SchemaField   `yaml:"controls"`
	Probes      map[string]Probe         `yaml:"probes"`
	Waiters     map[string]Waiter        `yaml:"waiters"`
	Bindings    map[string]Binding       `yaml:"bindings"`
	Operations  map[string]Operation     `yaml:"operations"`
}

type SchemaField struct {
	Type           string                 `yaml:"type"`
	Description    LocalizedText          `yaml:"description"`
	Required       bool                   `yaml:"required"`
	Repeatable     bool                   `yaml:"repeatable"`
	Positional     bool                   `yaml:"positional"`
	PositionalMany bool                   `yaml:"positional_many"`
	AllowEmpty     bool                   `yaml:"allow_empty"`
	InputStyle     string                 `yaml:"input_style"`
	Default        any                    `yaml:"default"`
	Max            *int                   `yaml:"max"`
	Enum           []string               `yaml:"enum"`
	Items          *SchemaField           `yaml:"items"`
	Fields         map[string]SchemaField `yaml:"fields"`
}

type Transition struct {
	Call          string          `yaml:"-"`
	Request       map[string]any  `yaml:"-"`
	Idempotency   Idempotency     `yaml:"-"`
	Retry         TransitionRetry `yaml:"-"`
	IDFrom        string          `yaml:"-"`
	RequestIDFrom string          `yaml:"-"`
	Wait          string          `yaml:"-"`
}

type TransitionRetry struct {
	Policy          string   `yaml:"policy"`
	Errors          []string `yaml:"errors"`
	InitialInterval string   `yaml:"initial_interval"`
	MaxInterval     string   `yaml:"max_interval"`
	Timeout         string   `yaml:"timeout"`
	// When optionally gates the retry on a condition evaluated against the
	// execution context (e.g. "input.force"). When set and the condition is
	// falsy, the matched errors surface immediately instead of being retried.
	When string `yaml:"when"`
}

type Waiter struct {
	Probe    string          `yaml:"probe"`
	Target   string          `yaml:"target"`
	Interval string          `yaml:"interval"`
	Timeout  string          `yaml:"timeout"`
	Failure  WaiterFailure   `yaml:"failure"`
	Pending  []WaiterPending `yaml:"pending"`
	Match    WaiterMatch     `yaml:"match"`
}

type WaiterFailure struct {
	States []string `yaml:"states"`
}

type WaiterMatch struct {
	Capture          string            `yaml:"capture"`
	By               []string          `yaml:"by"`
	ProbeEachCapture bool              `yaml:"probe_each_capture"`
	StateOnly        bool              `yaml:"state_only"`
	Fields           map[string]string `yaml:"fields"`
	Contains         map[string]string `yaml:"contains"`
	Excludes         map[string]string `yaml:"excludes"`
}

type WaiterPending struct {
	Field  string   `yaml:"field"`
	Values []string `yaml:"values"`
}

type WorkflowStep struct {
	Binding    string   `yaml:"binding"`
	WaitUnless string   `yaml:"wait_unless"`
	Wait       string   `yaml:"wait"`
	Probe      string   `yaml:"probe"`
	Many       bool     `yaml:"many"`
	IDs        []string `yaml:"ids"`
	As         string   `yaml:"as"`
	NotFound   string   `yaml:"not_found"`
	When       string   `yaml:"when"`
	WhenAny    []string `yaml:"when_any"`
	Merge      bool     `yaml:"merge"`
	Append     bool     `yaml:"append"`
	Unless     string   `yaml:"unless"`
	Emit       any      `yaml:"emit"`
}