ir

type APIInfo struct {
	Title       string
	Version     string
	Description string
}

type AuthScheme struct {
	Name        string // Identifier from the spec
	GoName      string // Go identifier
	Type        AuthType
	Description string
	// For APIKey:
	APIKeyName string // Header/query parameter name
	APIKeyIn   string // "header", "query", "cookie"
	// For HTTP Bearer:
	BearerFormat string
	// For OAuth2:
	OAuthFlows *OAuthFlowsDef
}

type AuthType int

type DiscriminatorDef struct {
	PropertyName string
	Mapping      map[string]string // discriminator value -> Go type name
}

type EnumVal struct {
	Name    string // Go const name (e.g., PetStatusAvailable)
	Literal string // Rendered Go constant literal (quoted for strings)
}

type Field struct {
	Name                string // Go field name (PascalCase)
	JSONName            string // Original JSON property name (for struct tag)
	Type                string // Go type expression (e.g., "string", "*int64", "[]User")
	Description         string
	Required            bool
	IsPointer           bool // Whether to use pointer type (nullable or optional)
	OmitEmpty           bool // Whether to add omitempty to JSON tag
	Embedded            bool // Whether this is an embedded (anonymous) field
	Deprecated          bool
	ReadOnly            bool
	WriteOnly           bool
	PrimaryErrorMessage bool // Property annotated x-ms-primary-error-message
	CatchAll            bool // Synthetic field holding the schema's additionalProperties
}

type OAuthFlowDef struct {
	AuthorizationURL string
	TokenURL         string
	RefreshURL       string
	Scopes           map[string]string // scope name -> description
}

type OAuthFlowsDef struct {
	AuthorizationCode *OAuthFlowDef
	Implicit          *OAuthFlowDef
	ClientCredentials *OAuthFlowDef
	Password          *OAuthFlowDef
}

type OperationDef struct {
	Name            string // Go method name (e.g., "ListUsers")
	Summary         string // Short summary from the spec
	Description     string
	HTTPMethod      string // "GET", "POST", etc.
	Path            string // URL path template (e.g., "/users/{id}")
	Tags            []string
	PathParams      []*ParamDef
	QueryParams     []*ParamDef
	HeaderParams    []*ParamDef
	CookieParams    []*ParamDef
	RequestBody     *RequestBodyDef // nil if no body
	Responses       []*ResponseDef
	SuccessResponse *ResponseDef    // The primary 2xx response
	ErrorResponses  []*ResponseDef  // 4xx/5xx responses
	SecurityReqs    [][]SecurityReq // OR of (AND of scheme refs)
	// NoAuth records that the operation declares an empty security requirement,
	// which overrides the document's to say it takes no credential.
	NoAuth bool
	// EventType is the Go type of one server-sent event's payload, set when a
	// success response offers text/event-stream.
	EventType  string
	Deprecated bool
	Pagination *PaginationDef // nil if not paginated
}

type Package struct {
	Name        string          // Go package name
	Types       []*TypeDef      // All type definitions
	Operations  []*OperationDef // All API operations
	AuthSchemes []*AuthScheme   // Security schemes from the spec
	Servers     []*ServerDef    // Servers the spec declares, in spec order
	Info        *APIInfo        // API title, version, description
	UserAgent   string          // Default User-Agent for generated clients
	Warnings    []string        // Spec constructs the generator could not act on
	Webhooks    []*WebhookDef   // Inbound payloads: webhooks and callbacks
}

type PaginationDef struct {
	Style PaginationStyle
	// For cursor-based:
	CursorParam string // Query param name for the cursor
	CursorField string // Response field containing next cursor
	// For offset-based and page-based: the parameter that advances, and the one
	// that sizes a page.
	OffsetParam string
	LimitParam  string
	// Common:
	HasMoreField string // Response field indicating more pages exist (optional)
	TotalField   string // Response field with total count (optional)
	ItemsField   string // Response field containing the items array, empty when the response is the array
	ItemsType    string // Go element type of the items array (e.g., "Pet")
	// ItemsAreResponse marks a response that is the page rather than holding it.
	ItemsAreResponse bool
}

type PaginationStyle int

type ParamDef struct {
	Name        string // Go parameter name (camelCase)
	FieldName   string // Go struct field name (PascalCase) for params struct
	OrigName    string // Original parameter name from spec
	Location    string // "path", "query", "header", "cookie"
	Type        string // Go type expression
	Required    bool
	Description string
	Deprecated  bool
	Style       string // serialization style
	Explode     bool
	ContentType string // Media type when the parameter is serialized with content rather than a style
	// AllowReserved sends RFC 3986 reserved characters through unescaped.
	AllowReserved bool
}

type RequestBodyDef struct {
	Required    bool
	Description string
	ContentType string // Primary content type (e.g., "application/json")
	TypeName    string // Go type for the body
}

type ResponseDef struct {
	StatusCode   string // "200", "404", "default", etc.
	Description  string
	ContentType  string
	TypeName     string // Go type for the response body (empty if no body)
	ErrorWrapper string // Go type name of the generated wrapper carrying the parsed body
	IsError      bool   // Whether this is an error response (4xx/5xx)
	Headers      []*ResponseHeaderDef
}

type ResponseHeaderDef struct {
	Name        string
	GoName      string
	Type        string // string, int64, float64, or bool
	Description string
	Required    bool
}

type SecurityReq struct {
	SchemeName string
	Scopes     []string
}

type ServerDef struct {
	URL         string
	Description string
	Variables   []*ServerVar // Template variables, in the order they appear in URL
}

type ServerVar struct {
	Name        string // Name as it appears in the URL template
	GoName      string // Go parameter name
	Default     string
	Enum        []string
	Description string
}

type TypeDef struct {
	Name          string            // Go type name (PascalCase)
	Description   string            // GoDoc comment
	Kind          TypeKind          // Struct, Alias, Enum, Union
	GoType        string            // For aliases: the underlying Go type string
	Fields        []*Field          // For structs
	EnumValues    []*EnumVal        // For enums
	EnumGoType    string            // For enums: the underlying Go type (e.g., "string", "int")
	UnionTypes    []*UnionVariant   // For oneOf/anyOf unions
	BaseType      string            // For unions: the type holding the properties every variant shares
	BaseEmbedded  bool              // For unions: whether the variants embed BaseType rather than declaring its fields
	Discriminator *DiscriminatorDef // If polymorphic via discriminator
	IsNullable    bool
}

type TypeKind int

type UnionVariant struct {
	TypeName           string // Go type name of this variant
	DiscriminatorValue string // For discriminator-based dispatch
}

type WebhookDef struct {
	Name        string // Dispatch key: the webhook's name, or operation.callback
	GoName      string // Identifier fragment: Parse<GoName>Webhook
	Callback    bool   // Whether this came from an operation's callbacks
	Method      string // HTTP method the sender uses
	PayloadType string // Go type the body decodes into
	Description string
}