config

type Config struct {
	Output  Output  `yaml:"output"`
	OpenAPI OpenAPI `yaml:"openapi"`

	// Package is the Go import path prefix every generated file uses
	// for its imports - the equivalent of <module>/<relPathFromGoMod>
	// for the project root. Not loaded from YAML: populated at gen
	// time by [ResolveModulePath], which walks up from the project
	// root looking for a go.mod and computes the effective import
	// path. The manifest carries no module field; go.mod's `module`
	// line is the sole source of truth.
	Package string `yaml:"-"`
}

type OAuthFlow struct {
	AuthorizationURL string            `yaml:"authorizationUrl,omitempty"`
	TokenURL         string            `yaml:"tokenUrl,omitempty"`
	RefreshURL       string            `yaml:"refreshUrl,omitempty"`
	Scopes           map[string]string `yaml:"scopes,omitempty"`
}

type OAuthFlows struct {
	Implicit          *OAuthFlow `yaml:"implicit,omitempty"`
	Password          *OAuthFlow `yaml:"password,omitempty"`
	ClientCredentials *OAuthFlow `yaml:"clientCredentials,omitempty"`
	AuthorizationCode *OAuthFlow `yaml:"authorizationCode,omitempty"`
}

type OpenAPI struct {
	Title           string                    `yaml:"title"`
	Version         string                    `yaml:"version"`
	Description     string                    `yaml:"description"`
	BasePath        string                    `yaml:"basePath"`
	SecuritySchemes map[string]SecurityScheme `yaml:"securitySchemes"`
}

type Output struct {
	Types      string `yaml:"types"`
	Transport  string `yaml:"transport"`
	Routes     string `yaml:"routes"`
	Service    string `yaml:"service"`
	Main       string `yaml:"main"`
	Svccontext string `yaml:"svccontext"`
	OpenAPI    string `yaml:"openapi"`
	// Middleware is the scaffold-once output dir for middleware
	// implementation files. The corresponding type declarations live
	// next to svccontext.go (see GenerateProjectMiddlewares).
	Middleware string `yaml:"middleware"`
	// Config is the scaffold-once directory holding the runtime
	// configuration package (config.go + config.yaml +
	// example.config.yaml). main.go reads from `<Config>/config.yaml`
	// at boot. Defaults to `./config`.
	Config string `yaml:"config"`
	// FileCase selects the naming convention for GENERATED file and
	// directory names derived from DSL identifiers - the per-method
	// handler/service files and the per-service directory. `snake`
	// (default) yields `create_user.go` / `user_service/`, `kebab`
	// yields `create-user.go` / `user-service/`, `camel` yields
	// `createUser.go` / `userService/`. It affects on-disk names only:
	// URL routes stay kebab-case, and Go package names / identifiers
	// are unchanged.
	FileCase string `yaml:"fileCase"`
}

type SecurityScheme struct {
	// Type is the OpenAPI 3.1 scheme type: "http", "apiKey", "oauth2",
	// "openIdConnect", or "mutualTLS". Required.
	Type string `yaml:"type"`
	// Scheme is the HTTP authentication scheme name (`bearer`, `basic`).
	// Used only when Type == "http".
	Scheme string `yaml:"scheme,omitempty"`
	// BearerFormat hints at the bearer token shape (e.g. "JWT").
	BearerFormat string `yaml:"bearerFormat,omitempty"`
	// In is the apiKey location: "header", "query", or "cookie".
	In string `yaml:"in,omitempty"`
	// Name is the apiKey header / query / cookie name.
	Name string `yaml:"name,omitempty"`
	// OpenIDConnectURL is the discovery URL for openIdConnect.
	OpenIDConnectURL string `yaml:"openIdConnectUrl,omitempty"`
	// Flows configures the OAuth2 flows. Required (with at least one flow)
	// when Type == "oauth2" - the OpenAPI spec mandates a `flows` object, and
	// omitting it produces an invalid document that downstream client
	// generators (e.g. @hey-api/openapi-ts) reject.
	Flows *OAuthFlows `yaml:"flows,omitempty"`
}