postman

type ConvertResult struct {
	// Records is the list of converted IR records.
	Records []ir.IRRecord

	// Metadata contains API-level metadata from the collection.
	Metadata *ir.APIMetadata

	// TagDefinitions contains tag definitions from folder structure.
	TagDefinitions []ir.TagDefinition

	// Warnings contains non-fatal issues encountered during conversion.
	Warnings []string
}

type Converter struct {
	// Variables is a map of variable names to values for resolution.
	// Collection-level variables are added automatically.
	Variables map[string]string

	// BaseURL is the value to use for {{url}} or {{baseUrl}} variables.
	BaseURL string

	// IncludeHeaders controls whether to include HTTP headers in output.
	IncludeHeaders bool

	// IncludeDisabled includes disabled headers and query params.
	IncludeDisabled bool

	// FilterHeaders is a list of header names to exclude (case-insensitive).
	// By default, sensitive auth headers are not filtered since Postman collections
	// typically contain example/placeholder values.
	FilterHeaders []string

	// GenerateIDs controls whether to generate UUIDs for records without IDs.
	GenerateIDs bool

	// PreserveAuth converts Postman auth configurations to request headers.
	PreserveAuth bool
}

type ConverterOption func(*Converter)