openapi

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

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

type Loader interface {
	Load(ctx context.Context, src Source) (Document, error)
}

type LoaderOption func(*LoaderOptions)

type LoaderOptions struct {
	// FileSystem enables loading from an abstract filesystem; defaults to the
	// operating system if nil.
	FileSystem fs.FS

	// HTTPClient allows callers to inject custom HTTP behaviour (timeouts,
	// proxies). Nil means HTTP sources are disabled unless AllowHTTPFallback is
	// true.
	HTTPClient *http.Client

	// AllowHTTPFallback toggles the default HTTP loader using http.DefaultClient
	// when no client is supplied. Keeping this explicit preserves offline-first
	// behaviour promised in the README.
	AllowHTTPFallback bool

	// RequestTimeout caps remote fetch durations when AllowHTTPFallback is true.
	RequestTimeout time.Duration
}

type Operation struct {
	ID          string
	Method      string
	Path        string
	Summary     string
	Description string
	RequestBody Schema
	Responses   map[string]Schema
	Extensions  map[string]any `json:"Extensions,omitempty"`
}

type Parser interface {
	Operations(ctx context.Context, doc Document) (map[string]Operation, error)
}

type ParserOption func(*ParserOptions)

type ParserOptions struct {
	// ResolveReferences controls whether the parser eagerly resolves $ref
	// pointers. Defaults to true for full documents.
	ResolveReferences bool

	// AllowPartialDocuments gates loading component-only inputs. Defaults to
	// false per the README commitment to focus on full documents in v1.
	AllowPartialDocuments bool
}

type Schema struct {
	Ref              string
	Type             string
	Format           string
	Required         []string
	Properties       map[string]Schema
	Items            *Schema
	Enum             []any
	Description      string
	Default          any
	Minimum          *float64
	Maximum          *float64
	ExclusiveMinimum bool
	ExclusiveMaximum bool
	MinLength        *int
	MaxLength        *int
	Pattern          string
	Extensions       map[string]any `json:"Extensions,omitempty"`
}

type Source = schema.Source

type SourceKind = schema.SourceKind