config

type AuthMode string

type CacheSection struct {
	Dir          string `toml:"dir,omitempty"`
	DiscoveryTTL string `toml:"discovery_ttl,omitempty"`
	AccessTTL    string `toml:"access_ttl,omitempty"`
	SchemaTTL    string `toml:"schema_ttl,omitempty"`
	IdentityTTL  string `toml:"identity_ttl,omitempty"`
	SkillsTTL    string `toml:"skills_ttl,omitempty"`
}

type Defaults struct {
	Output         string `toml:"output,omitempty"`
	Depth          *int   `toml:"depth,omitempty"`
	Limit          *int   `toml:"limit,omitempty"`
	Timeout        string `toml:"timeout,omitempty"`
	Deadline       string `toml:"deadline,omitempty"`
	MaxRetries     *int   `toml:"max_retries,omitempty"`
	Concurrency    *int   `toml:"concurrency,omitempty"`
	Redact         *bool  `toml:"redact,omitempty"`
	AcceptLanguage string `toml:"accept_language,omitempty"`
	MaxBulk        *int   `toml:"max_bulk,omitempty"`
	ConfirmWrites  *bool  `toml:"confirm_writes,omitempty"`
	Locale         string `toml:"locale,omitempty"`
	FallbackLocale string `toml:"fallback_locale,omitempty"`
	ErrorsTo       string `toml:"errors_to,omitempty"`
}

type Env map[string]string

type File struct {
	Version        int                `toml:"version,omitempty"`
	DefaultProfile string             `toml:"default_profile,omitempty"`
	Defaults       Defaults           `toml:"defaults,omitempty"`
	Cache          CacheSection       `toml:"cache,omitempty"`
	Logging        LoggingSection     `toml:"logging,omitempty"`
	Update         UpdateSection      `toml:"update,omitempty"`
	Profiles       map[string]Profile `toml:"profiles,omitempty"`

	// APIKey is not a legal key anywhere (§4.2); it is decoded only so the
	// hard error can name it.
	APIKey string `toml:"api_key,omitempty"`

	// Path is where the file came from; it is what `pay config explain`
	// prints as "user:/abs/config.toml" or "project:/abs/pay.toml" (§4.5).
	Path string `toml:"-"`
	// Exists is false for a file that was absent, which is not an error.
	Exists bool `toml:"-"`
	// Kind is "user" or "project"; it prefixes the source string.
	Kind string `toml:"-"`
	// UnknownKeys are decoded-but-unrecognised keys, surfaced as warnings so a
	// typo like `base_ur1` is visible without being fatal.
	UnknownKeys []string `toml:"-"`
}

type Flags struct {
	Profile          string
	BaseURL          string
	APIPath          string
	GraphQLPath      string
	GraphQLRoute     string
	AuthCollection   string
	AuthMode         string
	AuthHeaderScheme string

	Output         string
	ErrorsTo       string
	Path           string
	Locale         string
	FallbackLocale string
	AcceptLanguage string

	Timeout  string
	Deadline string
	CacheTTL string

	Depth       *int
	Limit       *int
	MaxDocs     *int
	MaxRetries  *int
	Concurrency *int

	Redact             *bool
	InsecureSkipVerify *bool
	NoCache            *bool
	Refresh            *bool
	Yes                *bool
	DryRun             *bool
	NoAudit            *bool
	Quiet              *bool
	Verbose            *bool

	LogLevel  string
	LogFormat string
}

type Input struct {
	Flags   Flags
	Env     Env
	Project *File
	User    *File
}

type KeyringMode string

type LoggingSection struct {
	Level  string `toml:"level,omitempty"`
	Format string `toml:"format,omitempty"`
}

type Paths struct {
	ConfigDir  string
	CacheDir   string
	StateDir   string
	ConfigFile string

	Sources map[string]string
}

type Profile struct {
	BaseURL            string              `toml:"base_url,omitempty"`
	APIPath            string              `toml:"api_path,omitempty"`
	GraphQLRoute       string              `toml:"graphql_route,omitempty"`
	GraphQLPath        string              `toml:"graphql_path,omitempty"`
	AuthCollection     string              `toml:"auth_collection,omitempty"`
	AuthMode           string              `toml:"auth_mode,omitempty"`
	AuthHeaderScheme   string              `toml:"auth_header_scheme,omitempty"`
	Label              string              `toml:"label,omitempty"`
	APIKeyEnv          string              `toml:"api_key_env,omitempty"`
	CredentialHelper   string              `toml:"credential_helper,omitempty"`
	InsecureSkipVerify *bool               `toml:"insecure_skip_verify,omitempty"`
	Headers            map[string]string   `toml:"headers,omitempty"`
	Blocks             map[string][]string `toml:"blocks,omitempty"`

	// Optional pins. Each one turns a discovered-or-unknown value into a
	// configured one and flips the matching *_source to "configured" (§4.2).
	IDType          string   `toml:"id_type,omitempty"`
	Locales         []string `toml:"locales,omitempty"`
	PayloadVersion  string   `toml:"payload_version,omitempty"`
	DBAdapter       string   `toml:"db_adapter,omitempty"`
	EchoCheckIgnore []string `toml:"echo_check_ignore,omitempty"`
	CustomEndpoints []string `toml:"custom_endpoints,omitempty"`

	// APIKey is never a legal key (§4.2); see File.Validate.
	APIKey string `toml:"api_key,omitempty"`
}

type Project struct {
	// Dir is the directory that anchored the discovery — the first one going
	// up that contained any marker at all.
	Dir string
	// ConfigPath is ./pay.toml, the committed project config (§4.3).
	ConfigPath string
	// PackageJSON is the nearest package.json (§7.11 source 2).
	PackageJSON string
	// PayloadConfig is the nearest payload.config.ts / .js / .mjs, at the root
	// or under src/ (§7.10).
	PayloadConfig string
	// SrcDir is the payload config's directory when it lives in src/.
	SrcDir string
	// GitRoot is the directory holding .git; the walk stops after it.
	GitRoot string
	// Start is the directory the walk began in.
	Start string
	// contains filtered or unexported fields
}

type Resolved struct {
	Profile        string
	ProfileDefined bool
	Label          string

	BaseURL          string
	APIPath          string
	GraphQLRoute     string
	GraphQLPath      string
	AuthCollection   string
	AuthMode         AuthMode
	AuthHeaderScheme string
	APIKeyEnv        string
	CredentialHelper string
	Headers          map[string]string
	KeyringMode      KeyringMode

	Output         string
	ErrorsTo       string
	Path           string
	Locale         string
	FallbackLocale string
	AcceptLanguage string

	Timeout     time.Duration
	Deadline    time.Duration
	Depth       int
	Limit       int
	MaxDocs     int
	MaxRetries  int
	Concurrency int
	MaxBulk     int

	Redact             bool
	ConfirmWrites      bool
	InsecureSkipVerify bool
	NoCache            bool
	Refresh            bool
	CacheTTL           time.Duration
	Yes                bool
	DryRun             bool
	NoAudit            bool
	Quiet              bool
	Verbose            bool

	CacheDir     string
	DiscoveryTTL time.Duration
	AccessTTL    time.Duration
	SchemaTTL    time.Duration
	IdentityTTL  time.Duration
	SkillsTTL    time.Duration

	LogLevel  string
	LogFormat string

	UpdateAuto    bool
	UpdateChannel string

	// Optional pins (§4.2). An empty value means "not configured"; the
	// matching *Source entry says so explicitly.
	IDType          string
	Locales         []string
	PayloadVersion  string
	DBAdapter       string
	EchoCheckIgnore []string
	CustomEndpoints []string
	Blocks          map[string][]string

	// ConcurrencyClamped is true when the requested concurrency exceeded
	// MaxConcurrency and was lowered.
	ConcurrencyClamped bool
	// Warnings are non-fatal configuration observations for the caller to put
	// in the envelope (§10): a moved base_url credential, an unset ${ENV} in a
	// header, an unknown key in a config file.
	Warnings []string
	// Sources maps a setting name to its §4.5 provenance string.
	Sources map[string]string
	// contains filtered or unexported fields
}

type ScanResult struct {
	Root string `json:"root,omitempty"`

	PayloadVersion       string `json:"payload_version,omitempty"`
	PayloadVersionSource string `json:"payload_version_source"`
	PackageJSON          string `json:"package_json,omitempty"`

	// DBAdapter is inferred from the project's @payloadcms/db-* dependency.
	// §7.11 only defines "configured" and "inferred" for this field, so a
	// package.json match reports "inferred" — which deliberately does NOT
	// unlock §9.3's client-side operator block, since that requires
	// "configured".
	DBAdapter       string `json:"db_adapter"`
	DBAdapterSource string `json:"db_adapter_source"`

	BlockSlugs     []string          `json:"blocks,omitempty"`
	BlocksSource   string            `json:"blocks_source"`
	BlockSlugFiles []string          `json:"block_slug_files,omitempty"`
	SlugFile       map[string]string `json:"-"`

	FilesScanned int   `json:"files_scanned"`
	BytesScanned int64 `json:"bytes_scanned"`
	Truncated    bool  `json:"truncated,omitempty"`
}

type Setting struct {
	Value  any    `json:"value"`
	Source string `json:"source"`
}

type UpdateSection struct {
	Auto    *bool  `toml:"auto,omitempty"`
	Channel string `toml:"channel,omitempty"`
}