config

type Config struct {
	// Schema is the path to the Federation v2 supergraph SDL.
	// It is used both as the routing table and as the GraphQL schema for type generation.
	Schema string `yaml:"schema"`

	// Query lists glob patterns or explicit paths to .graphql operation files.
	Query []string `yaml:"query"`

	// Client configures the generated client Go file.
	Client PackageConfig `yaml:"client"`

	// Model optionally generates model types into a separate file.
	Model PackageConfig `yaml:"model,omitempty"`

	// SubgraphURLs overrides subgraph URLs at runtime.
	// Keys are join__Graph enum values (e.g. "PRODUCTS").
	SubgraphURLs map[string]string `yaml:"subgraph_urls,omitempty"`

	// Bindings maps GraphQL scalar names to Go types. Equivalent to genqlient's
	// bindings: section.
	Bindings map[string]TypeBinding `yaml:"bindings,omitempty"`

	// Generate controls optional generation behaviours.
	Generate *GenerateConfig `yaml:"generate,omitempty"`

	// URLMode controls how subgraph URLs appear in generated plan specs.
	// "baked" (default): URLs from the supergraph SDL are embedded in the
	// plan spec constants at generation time. NewClient takes only an *http.Client.
	// "enum": plan specs use subgraph enum names; URLs are provided at runtime.
	// NewClient takes an additional subgraphURLs map[string]string parameter.
	// Use "enum" when the supergraph SDL contains placeholder URLs (e.g. "unused").
	URLMode string `yaml:"url_mode,omitempty"`

	// Dir is the base directory for resolving relative paths (not serialised).
	Dir string `yaml:"-"`

	// Verbose enables per-file / per-operation progress diagnostics on stderr
	// during generation. Set by the CLI's --verbose flag; not serialised.
	Verbose bool `yaml:"-"`
}

type GenerateConfig struct {
	ClientInterfaceName *string `yaml:"clientInterfaceName,omitempty"`
	// ExportOperations is a path to write a JSON manifest of all generated operations.
	// Empty means no manifest is written.
	ExportOperations string `yaml:"export_operations,omitempty"`
	// Optional controls how nullable GraphQL fields are represented in Go.
	// "pointer" (default): nullable T → *T; "value": nullable T → T (zero = absent).
	Optional string `yaml:"optional,omitempty"`
}

type PackageConfig struct {
	Filename string `yaml:"filename"`
	Package  string `yaml:"package"`
}

type TypeBinding struct {
	Type        string `yaml:"type"`
	Marshaler   string `yaml:"marshaler,omitempty"`
	Unmarshaler string `yaml:"unmarshaler,omitempty"`
}