config

type Auth struct {
	Type       string          `yaml:"type"`
	Attributes []AuthAttribute `yaml:"attributes,omitempty"`
	// Propagation controls how auth is applied to child folders and requests.
	// When set to "inherit", all folders and requests (except those with an
	// explicit folder_override) will have their auth cleared so they inherit
	// from the collection-level auth. Items with type "noauth" are left
	// untouched. Omit this field (or leave empty) to preserve the current
	// behaviour where each item keeps whatever auth was set previously.
	Propagation string `yaml:"propagation,omitempty"`
}

type AuthAttribute struct {
	Key   string `yaml:"key"`
	Value string `yaml:"value"`
	Type  string `yaml:"type,omitempty"`
}

type Backup struct {
	Enabled bool `yaml:"enabled"`
	// Keep is how many backups to retain per collection; 0 keeps all.
	Keep int `yaml:"keep"`
}

type Config struct {
	PostmanAPIKey string `yaml:"postman_api_key"`
	WorkspaceID   string `yaml:"workspace_id"`

	OpenAPI *OpenAPIConfig `yaml:"openapi,omitempty"`
	Export  *ExportConfig  `yaml:"export,omitempty"`
	Import  *ImportConfig  `yaml:"import,omitempty"`
}

type DocLinks struct {
	BaseURL string `yaml:"base_url"`
}

type ExportConfig struct {
	OutputDir    string   `yaml:"output_dir"`
	Collections  []string `yaml:"collections,omitempty"`
	Environments []string `yaml:"environments,omitempty"`
	Pretty       bool     `yaml:"pretty"`
}

type FolderOverride struct {
	Auth    *Auth    `yaml:"auth,omitempty"`
	Scripts *Scripts `yaml:"scripts,omitempty"`
}

type Header struct {
	Key      string `yaml:"key"`
	Value    string `yaml:"value"`
	Disabled bool   `yaml:"disabled"`
}

type ImportConfig struct {
	InputDir     string              `yaml:"input_dir"`
	Collections  *ImportEntityConfig `yaml:"collections,omitempty"`
	Environments *ImportEntityConfig `yaml:"environments,omitempty"`
}

type ImportEntityConfig struct {
	Names    []string `yaml:"names,omitempty"`
	Strategy string   `yaml:"strategy,omitempty"`
}

type OpenAPIConfig struct {
	Path              string                    `yaml:"path"`
	RootFile          string                    `yaml:"root_file,omitempty"`
	BaseURL           string                    `yaml:"base_url"`
	SanitizeEnums     bool                      `yaml:"sanitize_enums"`
	DocLinks          *DocLinks                 `yaml:"doc_links,omitempty"`
	CommonHeaders     []Header                  `yaml:"common_headers,omitempty"`
	CommonQueryParams []QueryParam              `yaml:"common_query_params,omitempty"`
	Auth              *Auth                     `yaml:"auth,omitempty"`
	Scripts           *Scripts                  `yaml:"scripts,omitempty"`
	FolderOverrides   map[string]FolderOverride `yaml:"folder_overrides,omitempty"`

	// ImportOptions are passed to Postman's OpenAPI importer and overlay
	// DefaultImportOptions.
	ImportOptions map[string]any `yaml:"import_options,omitempty"`

	// PreserveRequestData keeps header, parameter and body edits made in
	// Postman when an existing request is updated from the spec.
	PreserveRequestData bool `yaml:"preserve_request_data"`

	// StateDir stores local sync state: the baseline of each collection (the
	// collection generated by the last sync, used for three-way merges).
	StateDir string `yaml:"state_dir"`

	// Backup saves the current collection under <state_dir>/backups/ before
	// it is updated.
	Backup Backup `yaml:"backup"`
}

type QueryParam struct {
	Key      string `yaml:"key"`
	Value    string `yaml:"value"`
	Disabled bool   `yaml:"disabled"`
}

type Scripts struct {
	PreRequest string `yaml:"prerequest,omitempty"`
	Test       string `yaml:"test,omitempty"`
}