config

type Cache struct {
	Enabled bool
	Dir     string
}

type CacheConfig struct {
	Enabled bool   `toml:"enabled"`
	Dir     string `toml:"dir"`
}

type CodegenPluginConfig struct {
	Plugin  string         `toml:"plugin"`
	Out     string         `toml:"out"`
	Options map[string]any `toml:"options"`
}

type ColumnOverride struct {
	Column string        `toml:"column"`
	GoType GoTypeDetails `toml:"go_type"`
}

type Config struct {
	Package       string            `toml:"package"`
	Out           string            `toml:"out"`
	ModelsPackage string            `toml:"models_package"`
	ModelsImport  string            `toml:"models_import"`
	Language      Language          `toml:"language"`
	Database      Database          `toml:"database"`
	SQLiteDriver  Driver            `toml:"sqlite_driver"`
	Schemas       []string          `toml:"schemas"`
	Queries       []string          `toml:"queries"`
	CustomTypes   CustomTypesConfig `toml:"custom_types"`
	// Overrides are parsed separately to handle flexible go_type formats
	Generation GenerationOptions `toml:"generation"`
	// Rename is the [rename] table: exact SQL name → exported Go identifier.
	Rename          map[string]string     `toml:"rename"`
	PreparedQueries PreparedQueriesConfig `toml:"prepared_queries"`
	Cache           CacheConfig           `toml:"cache"`
	Verify          VerifyConfig          `toml:"verify"`
	Migrations      MigrationsConfig      `toml:"migrations"`
	Vet             VetConfig             `toml:"vet"`
	Plugins         []PluginConfig        `toml:"plugins"`
	Codegen         []CodegenPluginConfig `toml:"codegen"`
}

type CustomTypeMapping struct {
	CustomType string `toml:"custom_type"`
	SQLiteType string `toml:"sqlite_type"`
	GoType     string `toml:"go_type"`
	GoImport   string `toml:"go_import"`
	GoPackage  string `toml:"go_package"`
	Pointer    bool   `toml:"pointer"`
	// JSON, when true, binds the column to GoType as a JSON document: generated
	// code scans the column into a []byte holder and json.Unmarshal's it into the
	// struct, and json.Marshal's the struct back to []byte when binding it as a
	// query parameter. This round-trips a JSON/JSONB/TEXT column to a named Go
	// struct. It is additive: mappings without json=true are unchanged.
	JSON bool `toml:"json"`
}

type CustomTypesConfig struct {
	Mappings []CustomTypeMapping `toml:"mapping"`
}

type Database string

type DatabaseTypeOverride struct {
	DatabaseType string `toml:"db_type"`
	GoType       string `toml:"go_type"`
}

type Driver string

type GenerationOptions struct {
	EmitEmptySlices     bool   `toml:"emit_empty_slices"`
	EmitPreparedQueries bool   `toml:"emit_prepared_queries"`
	EmitJSONTags        bool   `toml:"emit_json_tags"`
	EmitPointersForNull bool   `toml:"emit_pointers_for_null"`
	SQLDialect          string `toml:"sql_dialect"`
	// EmitDBTags adds a db:"<column_name>" struct tag alongside any json tag.
	// Default false reproduces the pre-G7 output (no db tags).
	EmitDBTags bool `toml:"emit_db_tags"`
	// JSONTagsCaseStyle controls the casing of json struct-tag values:
	// "snake", "camel", "pascal", or "none" (omit json tags entirely). The empty
	// default reproduces today's exact json tags so existing goldens are unchanged.
	JSONTagsCaseStyle string `toml:"json_tags_case_style"`
	// EmitResultStructPointers makes :one return *Row and :many return []*Row.
	// Default false keeps value (non-pointer) result returns.
	EmitResultStructPointers bool `toml:"emit_result_struct_pointers"`
	// EmitParamsStructPointers passes the grouped <Method>Params argument as a
	// *<Method>Params. Default false keeps the value argument.
	EmitParamsStructPointers bool `toml:"emit_params_struct_pointers"`
	// EmitInterface toggles generation of the Querier interface (querier.gen.go).
	// db-catalyst defaults to emitting the interface (unlike sqlc, whose default is
	// false), so an unset/nil value is treated as true; emit_interface = false
	// suppresses the file. It is a *bool so an explicit false is distinguishable
	// from an omitted key.
	EmitInterface *bool `toml:"emit_interface"`
	// Initialisms renders SQL-derived Go identifiers with the golint/sqlc
	// initialism table (user_id → UserID, url_suffix → URLSuffix). Default
	// false keeps the legacy casing (UserId) so existing output is unchanged.
	Initialisms bool `toml:"initialisms"`
}

type GoTypeDetails struct {
	Import  string `toml:"import"`
	Package string `toml:"package"`
	Type    string `toml:"type"`
	Pointer bool   `toml:"pointer"`
}

type JobPlan struct {
	Package             string
	Out                 string
	Language            Language
	Database            Database
	SQLiteDriver        Driver
	Schemas             []string
	Queries             []string
	CustomTypes         []CustomTypeMapping
	ColumnOverrides     map[string]ColumnOverride
	EmitJSONTags        bool
	EmitPointersForNull bool
	// EmitDBTags adds db:"<column>" struct tags (G7). Default false.
	EmitDBTags bool
	// JSONTagsCaseStyle controls json tag value casing (G7): "snake", "camel",
	// "pascal", "none", or "" for the unchanged default.
	JSONTagsCaseStyle string
	// EmitResultStructPointers makes :one return *Row and :many []*Row (G7).
	EmitResultStructPointers bool
	// EmitParamsStructPointers passes <Method>Params as a pointer (G7).
	EmitParamsStructPointers bool
	// EmitInterface controls whether the Querier interface (querier.gen.go) is
	// generated (G7). Defaults to true.
	EmitInterface bool
	// Initialisms applies the golint/sqlc initialism table to SQL-derived Go
	// identifiers (issue #4). Default false keeps legacy casing.
	Initialisms bool
	// Rename maps exact SQL names (column/table tokens, e.g. "ip_address") to
	// the exported Go identifier to emit for them (e.g. "IPAddress"). Entries
	// win over Initialisms and apply regardless of that flag (issue #4).
	Rename          map[string]string
	PreparedQueries PreparedQueries
	SQLDialect      string
	Cache           Cache
	Verify          VerifyConfig
	Vet             VetConfig
	// ModelsPackage, when non-empty, splits the generated table-model structs
	// into a separate Go sub-package named (and sub-directory placed) under
	// this value, relative to Out. Empty keeps the single-package layout.
	ModelsPackage string
	// ModelsImport is the full Go import path of the models sub-package. It is
	// required whenever ModelsPackage is set so the main package can import the
	// split models deterministically without reading go.mod.
	ModelsImport string
	// Migrations controls migration-file awareness (goose, dbmate,
	// golang-migrate). An empty Format defaults to "auto" detection.
	Migrations MigrationsConfig
	// Plugins declares WASM codegen plugins (RFC 0002). Empty when no plugin is
	// configured, in which case generation is byte-identical to the no-plugin path.
	Plugins []PluginConfig
	// Codegen routes the IR to named plugins. Empty when no plugin is configured.
	Codegen []CodegenPluginConfig
}

type Language string

type LoadOptions struct {
	Strict   bool
	Resolver *fileset.Resolver
	// Logger receives warning messages. If nil, warnings are only added to Result.Warnings.
	Logger logging.Logger
}

type MigrationsConfig struct {
	Format string `toml:"format"`
}

type PluginConfig struct {
	Name string   `toml:"name"`
	WASM WASMSpec `toml:"wasm"`
}

type PreparedQueries struct {
	Enabled         bool
	Metrics         bool
	ThreadSafe      bool
	EmitEmptySlices bool
}

type PreparedQueriesConfig struct {
	Enabled         bool `toml:"enabled"`
	Metrics         bool `toml:"metrics"`
	ThreadSafe      bool `toml:"thread_safe"`
	EmitEmptySlices bool `toml:"emit_empty_slices"`
}

type Result struct {
	Plan     JobPlan
	Warnings []string
}

type VerifyConfig struct {
	Enabled bool   `toml:"enabled"`
	Engine  string `toml:"engine"`  // "sqlite" (default), "postgres"/"postgresql", or "mysql"
	Cache   string `toml:"cache"`   // offline cache path; default db-catalyst.verified.json
	Require bool   `toml:"require"` // if true, stale/missing cache fails generate
	// DSN is the data-source name used for PostgreSQL and MySQL verifiers.
	// Required when engine is "postgres", "postgresql", or "mysql".
	// May also be supplied via the DB_CATALYST_VERIFY_DSN environment variable;
	// the environment variable takes precedence over this field.
	DSN string `toml:"dsn"`
}

type VetConfig struct {
	// Disabled is a list of rule names to suppress. An empty slice enables all rules.
	Disabled []string `toml:"disabled"`
}

type WASMSpec struct {
	Path   string `toml:"path"`
	URL    string `toml:"url"`
	SHA256 string `toml:"sha256"`
}