entity

type Action uint8

type Attribute struct {
	Name        string
	Alias       string
	Description string
	Domain      Domain
	Excluded    bool   // true removes the column from all responses (field projection)
	Mask        string // optional mask rule name (see mask package)
}

type Constraint struct {
	Kind ConstraintKind
	Expr string
}

type ConstraintKind uint8

type Domain struct {
	Type        string
	Nullable    bool
	Constraints []Constraint
}

type Entity struct {
	Name        string
	Source      string
	DataSource  string
	Schema      string
	Description string
	Kind        Kind
	Attributes  []Attribute
	Keys        []Key
	ForeignKeys []ForeignKey
	Role        RoleAccess
	FieldAccess FieldAccess
	MCP         MCPFlags
	RowPolicies RowPolicies
	Relations   []Relationship
	// Params is the ordered list of formal parameter names for a KindProcedure
	// entity. execute_entity binds a caller's named args to positional CALL
	// placeholders in this exact order; a stored procedure whose params are not
	// declared cannot be executed (fail-closed) since positional binding would
	// otherwise be guesswork.
	Params []string
}

type FieldAccess map[string]FieldPermissions

type FieldPermissions struct {
	Read  []string
	Write []string
}

type ForeignKey struct {
	Name        string
	Columns     []string
	RefRelation string
	RefColumns  []string
}

type Key struct {
	Name    string
	Columns []string
	Primary bool
}

type Kind uint8

type MCPFlags struct {
	DMLTools         bool // expose the seven DML tools for this entity
	CustomTool       bool // register a stored procedure as a named tool
	TrustedProcedure bool // procedure passed explicit DBA cost/safety review
}

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

type Relationship struct {
	Name        string
	Target      string
	Cardinality string
	JoinOn      map[string]string // this field -> target field
}

type Resolved struct {
	Entity     Entity
	Attributes []Attribute
}

type RoleAccess map[Action][]string

type RowPolicies map[string]relalg.Predicate