admin

type Actions struct {
	List   bool `json:"list"`
	Detail bool `json:"detail"`
	Create bool `json:"create"`
	Update bool `json:"update"`
	Delete bool `json:"delete"`
}

type AuthMeta struct {
	Mode      string `json:"mode"`
	Bootstrap string `json:"bootstrap"`
}

type Capabilities struct {
	View   bool `json:"view"`
	Create bool `json:"create"`
	Update bool `json:"update"`
	Delete bool `json:"delete"`
}

type Catalog struct {
	Models []ModelMeta `json:"models"`
}

type CatalogAux struct {
	Auth *AuthMeta `json:"auth,omitempty"`
}

type Choice struct {
	Value string `json:"value"`
	Label string `json:"label"`
}

type Field struct {
	Name     string    `json:"name"`
	Type     FieldType `json:"type"`
	Required bool      `json:"required"`
	ReadOnly bool      `json:"readonly"`
	Related  *Relation `json:"related,omitempty"`
	// Constraints copied from the model's validate tag when the registrar
	// leaves them empty. Strings so a decimal bound survives JSON.
	Minimum   string `json:"minimum,omitempty"`
	Maximum   string `json:"maximum,omitempty"`
	MaxLength int    `json:"max_length,omitempty"`
	Pattern   string `json:"pattern,omitempty"`
	// TagPattern is the pattern struct tag, kept apart from a validate
	// regex. make resource writes the slug alphabet here. A user regex
	// does not change the catalog kind.
	TagPattern string `json:"-"`
	Default    string `json:"default,omitempty"`
	// Format is the OpenAPI format from the model tag (email, uri, ip, time,
	// duration). The admin wire for email stays string; time and duration
	// have their own wires. Writes reject a value that fails the format.
	Format string `json:"format,omitempty"`
	// Choices are the stored value and display label of an enum. Empty
	// when the column is not an enum.
	Choices []Choice `json:"choices,omitempty"`
	// Column is the GORM/SQL column name. Empty means Name == JSON key ==
	// column (the v1 default). When set, it alone picks the model field the
	// admin reads and writes (Name is then only the JSON key); a column the
	// model does not have is a registration error. Not emitted in meta.
	Column string `json:"-"`
	// WriteOnly matches a public create field that is omitted from the
	// response (`gombit:"write"`). Row payloads leave it out. An update
	// applies it only when the body contains a new value.
	WriteOnly bool `json:"writeonly,omitempty"`
	// Accept and MaxBytes are a file or image field's upload policy (the
	// model's storage tag): the media types it accepts and its largest
	// file. Set at registration; the admin form uses them as hints, and
	// the server enforces them.
	Accept   []string `json:"accept,omitempty"`
	MaxBytes int64    `json:"max_bytes,omitempty"`
	// contains filtered or unexported fields
}

type FieldMeta struct {
	Name     string    `json:"name"`
	Type     FieldType `json:"type"`
	Required bool      `json:"required"`
	ReadOnly bool      `json:"readonly"`
	// WriteOnly is a create field the response omits (`gombit:"write"`).
	// The edit form leaves the key out until the operator sets a value.
	WriteOnly bool      `json:"writeonly,omitempty"`
	Related   *Relation `json:"related,omitempty"`
	Minimum   string    `json:"minimum,omitempty"`
	Maximum   string    `json:"maximum,omitempty"`
	MaxLength int       `json:"max_length,omitempty"`
	Pattern   string    `json:"pattern,omitempty"`
	Default   string    `json:"default,omitempty"`
	Format    string    `json:"format,omitempty"`
	Choices   []Choice  `json:"choices,omitempty"`
	// Accept and MaxBytes: a file or image field's upload policy, as hints
	// for the form (the server enforces them).
	Accept   []string `json:"accept,omitempty"`
	MaxBytes int64    `json:"max_bytes,omitempty"`
}

type FieldType string

type Host interface {
	API() huma.API
	DB() *gorm.DB
	Config() config.Config
}

type ModelMeta struct {
	Slug        string       `json:"slug"`
	Singular    string       `json:"singular"`
	Plural      string       `json:"plural"`
	PK          string       `json:"pk"`
	Fields      []FieldMeta  `json:"fields"`
	List        []string     `json:"list"`
	Search      []string     `json:"search"`
	Filter      []string     `json:"filter"`
	Ordering    []string     `json:"ordering"`
	Actions     Actions      `json:"actions"`
	Permissions Permissions  `json:"permissions"`
	Can         Capabilities `json:"can"`
}

type Options struct {
	// Slug is the URL key (products). Required, lowercase, unique per app.
	Slug string
	// Singular and Plural are UI labels. Empty values are derived at Register
	// from the Go type name and slug.
	Singular string
	Plural   string
	// PK is the JSON/field name of the primary key. Empty means derive the
	// GORM primary key at Register and store it.
	PK string
	// Fields is the concrete field list handlers read. Empty means derive a
	// default from the struct once, inside Register (see FieldsFrom).
	Fields []Field
	// List is the list-view column order.
	List []string
	// Search is the list of field names the search query param applies to.
	Search []string
	// Filter is the list of field names that may appear as list query keys.
	Filter []string
	// Ordering is the list of field names the ordering query param may use.
	// created_at and updated_at may appear here even if omitted from Fields.
	Ordering []string
	// Actions enables list / detail / create / update / delete. The zero
	// value (all false) defaults to all enabled.
	Actions Actions
	// Permissions are authorization keys enforced by the admin handlers.
	// Empty values default to admin.{slug}.{action}.
	Permissions Permissions
}

type Permissions struct {
	View   string `json:"view"`
	Create string `json:"create"`
	Update string `json:"update"`
	Delete string `json:"delete"`
}

type Relation struct {
	Slug       string `json:"slug"`
	Kind       string `json:"kind"`
	LabelField string `json:"label_field"`
}