models

type CheckDef struct {
	Name       string
	Expression string
}

type CppNoneGenerator struct{}

type EnumDef struct {
	Name    string      // enum type name
	Comment string      // leading comment / docstring
	Values  []EnumValue // enum constants
}

type EnumValue struct {
	Name    string
	Number  int32
	Comment string // inline or leading comment
}

type FieldBehavior int

type FieldDef struct {
	// Proto source
	Name      string // proto field name (snake_case)
	ProtoType string // proto type (string, int32, etc.)
	Number    int    // proto field number
	Repeated  bool   // repeated field

	// Map field support: map<KeyType, ValueType>
	IsMap        bool   // true when the field is a proto map
	MapKeyType   string // key type for map fields (e.g. "string")
	MapValueType string // value type for map fields (e.g. "string")

	// Oneof support
	OneofGroup string // name of the oneof group this field belongs to

	// Enum support
	IsEnum       bool   // true when the field type is a proto enum
	EnumTypeName string // original enum type name (e.g. "SourceStatus")

	// From [(buffalo.models.field)]
	Alias             string
	Description       string
	PrimaryKey        bool
	AutoIncrement     bool
	Nullable          bool
	Unique            bool
	DefaultValue      string
	MaxLength         int32
	MinLength         int32
	Precision         int32
	Scale             int32
	CustomType        string
	DBType            string
	Visibility        FieldVisibility
	Behavior          FieldBehavior
	Sensitive         bool
	Deprecated        bool
	DeprecatedMessage string
	Index             bool
	IndexType         IndexType
	JSONName          string
	XMLName           string
	OmitEmpty         bool
	Relation          *RelationDef
	Example           string
	Comment           string
	AutoGenerate      bool
	AutoNow           bool
	AutoNowAdd        bool
	Sequence          string
	Collation         string
	Ignore            bool
	DBIgnore          bool
	APIIgnore         bool
	Tags              []string
	Metadata          map[string]string
}

type FieldVisibility int

type GenerateOptions struct {
	// Language target (go, python, cpp, rust).
	Language string

	// ORM plugin to use.
	ORM ORMPlugin

	// Output directory for generated models.
	OutputDir string

	// Package / module name.
	Package string

	// Pb2ImportPrefix is the dotted Python module prefix prepended to pb2 imports.
	// Example: "araviec_apis.generated.python" produces
	//   from araviec_apis.generated.python.araviec.common.v1.msg_pb2 import ...
	// When empty, proto file paths are used as-is (no prefix).
	Pb2ImportPrefix string

	// BaseModelFields — extra fields injected into BaseModel.
	BaseModelFields []FieldDef

	// GenerateBaseModel — whether to emit a BaseModel class/struct.
	GenerateBaseModel bool

	// GenerateInit — generate __init__.py for Python.
	GenerateInit bool

	// FixImports — fix relative imports for Python.
	FixImports bool

	// PreserveProtoStructure — mirror proto directory structure.
	PreserveProtoStructure bool

	// Verbose — emit extra comments in generated code.
	Verbose bool
}

type GeneratedFile struct {
	Path    string // Relative output path (e.g. "models/user.py")
	Content string // Generated source code
}

type GoGORMGenerator struct{}

type GoNoneGenerator struct{}

type GoSQLXGenerator struct{}

type IndexDef struct {
	Name    string
	Columns []string
	Unique  bool
	Type    IndexType
	Where   string // partial index condition
	Comment string
}

type IndexType int

type ModelCodeGenerator interface {
	// Language returns the target language identifier ("go", "python", etc.).
	Language() string

	// ORMName returns the ORM / framework name ("None", "pydantic", "gorm", etc.).
	ORMName() string

	// GenerateBaseModel produces the base model class / struct.
	GenerateBaseModel(opts GenerateOptions) (GeneratedFile, error)

	// GenerateModel produces a single model file from a ModelDef.
	GenerateModel(model ModelDef, opts GenerateOptions) ([]GeneratedFile, error)

	// GenerateEnum produces source for a standalone enum definition.
	// Returns empty file if enums are emitted inline within GenerateModel.
	GenerateEnum(enum EnumDef, opts GenerateOptions) (GeneratedFile, error)

	// GenerateInit produces __init__.py or mod.rs or similar index file.
	// May return empty file if not applicable for the language.
	GenerateInit(models []ModelDef, opts GenerateOptions) (GeneratedFile, error)
}

type ModelDef struct {
	// Proto source
	MessageName string // original proto message name
	Package     string // proto package (e.g. "myservice")
	FilePath    string // source .proto file path

	// Model-level options (from [(buffalo.models.model)])
	Name              string   // class/struct name override
	TableName         string   // optional DB table name
	Schema            string   // optional DB schema
	Description       string   // docstring
	Tags              []string // arbitrary tags
	Abstract          bool     // abstract model
	Extends           string   // parent model name
	Mixins            []string // mixin model names
	SoftDelete        bool     // add deleted_at
	Timestamps        bool     // add created_at / updated_at
	Deprecated        bool     // deprecated model
	DeprecatedMessage string
	Generate          []string // what to generate: "model", "repo", "factory"

	// Composite constraints
	Indexes []IndexDef
	Uniques []UniqueDef
	Checks  []CheckDef

	// Nested enums within this message
	Enums []EnumDef

	// Oneof groups within this message
	Oneofs []OneofDef

	// Nested messages (sub-structs) within this message
	NestedMessages []ModelDef

	// Fields (ordered)
	Fields []FieldDef
}

type ModelsPlugin struct {
	// contains filtered or unexported fields
}

type ORMPlugin struct {
	Name    string // "None", "pydantic", "sqlalchemy", "gorm", "diesel", etc.
	Version string // optional required version (e.g. "2.0")
}

type OnAction int

type OneofDef struct {
	Name    string     // oneof group name
	Comment string     // leading comment / docstring
	Fields  []FieldDef // fields within the oneof
}

type ProtoFileOption struct {
	Name  string
	Value string
}

type ProtoImport struct {
	Path     string // e.g. "google/protobuf/any.proto"
	Modifier string // "weak", "public", or ""
}

type PythonNoneGenerator struct{}

type PythonPydanticGenerator struct {
	// contains filtered or unexported fields
}

type PythonSQLAlchemyGenerator struct {
	// contains filtered or unexported fields
}

type RelationDef struct {
	Type       RelationType
	Model      string // target model name
	ForeignKey string
	References string // default "id"
	JoinTable  string // for many_to_many
	OnDelete   OnAction
	OnUpdate   OnAction
	Eager      bool
	Through    string // intermediate model
	InverseOf  string // inverse relation field
}

type RelationType int

type RustDieselGenerator struct {
	// contains filtered or unexported fields
}

type RustNoneGenerator struct{}

type TypescriptNoneGenerator struct{}

type TypescriptZodGenerator struct{}

type UniqueDef struct {
	Name    string
	Columns []string
}