manifest

type Entity struct {
	// Name is the PascalCase entity name (e.g., "User", "BlogPost").
	Name string `yaml:"name"`

	// Fields lists the entity's data fields (not including ID or timestamps).
	Fields []Field `yaml:"fields"`

	// Timestamps controls whether CreatedAt and UpdatedAt fields are included.
	// When true, the entity struct includes time.Time fields and the repository
	// implementations automatically manage them.
	Timestamps bool `yaml:"timestamps"`

	// SoftDelete controls whether the entity supports soft deletion.
	// When true, a DeletedAt *time.Time field is added and Delete operations
	// set this field rather than removing the row. List operations filter
	// out soft-deleted entities by default.
	SoftDelete bool `yaml:"soft_delete"`
}

type Field struct {
	// Name is the field name in snake_case (e.g., "first_name", "email").
	// Templates convert this to PascalCase for Go struct fields and to the
	// appropriate casing for JSON tags, SQL columns, and proto fields.
	Name string `yaml:"name"`

	// Type is the abstract field type. See FieldType constants.
	Type FieldType `yaml:"type"`

	// Required indicates whether the field must be provided on create.
	// Required fields generate non-pointer struct fields and NOT NULL SQL
	// constraints. Optional fields generate pointer struct fields.
	Required bool `yaml:"required"`

	// Unique indicates whether the field must have a unique value across
	// all entities. Unique fields generate UNIQUE SQL constraints and
	// additional repository methods (e.g., GetByEmail for a unique email field).
	Unique bool `yaml:"unique"`

	// EnumValues holds the allowed values when Type is "enum".
	// Ignored for other field types. Templates generate a typed string
	// enum with these values.
	EnumValues []string `yaml:"enum_values,omitempty"`
}

type FieldType string

type Manifest struct {
	// Project is the human-readable project name (e.g., "my-backend").
	Project string `yaml:"project"`

	// Module is the Go module path (e.g., "github.com/user/my-backend").
	Module string `yaml:"module"`

	// Version is the project version (e.g., "0.1.0").
	Version string `yaml:"version"`

	// Protocols lists the enabled protocol adapters (e.g., ["rest", "grpc"]).
	Protocols []string `yaml:"protocols"`

	// Database is the selected database backend ("sqlite", "postgres", or "none").
	Database string `yaml:"database"`

	// Auth is the selected authentication strategy ("jwt", "apikey", or "none").
	Auth string `yaml:"auth"`

	// Middleware lists the enabled middleware (e.g., ["ratelimit", "cors"]).
	Middleware []string `yaml:"middleware"`

	// Entities lists all scaffolded domain entities with their field definitions.
	Entities []Entity `yaml:"entities"`
}

type ValidationError struct {
	Issues []string
}