schema

type AMQP struct {
	Exchange    string                  // Exchange name, can be empty
	Key         Template[NotifyContext] // Routing key, usually required
	Retry       int                     // maximum number of retries (negative means no retries)
	Timeout     time.Duration           // publish timeout
	Interval    time.Duration           // interval between attempts (publish message)
	Headers     map[string]string       // arbitrary headers (only string supported)
	Type        string                  // optional content type property; if not set and message is nil, type is set to application/json
	Correlation Template[NotifyContext] // optional correlation ID template (commonly result ID)
	ID          Template[NotifyContext] // optional correlation ID template (commonly result ID), useful for client-side deduplication
	Message     Template[NotifyContext] // payload content, if not set - JSON representation of storage result
}

type Credentials struct {
	User   string
	Groups []string
	Email  string
}

type Field struct {
	Name        string                   // column name in database.
	Label       string                   // short name of field which will be shown in UI, if not set - [Field.Name] is used.
	Description string                   // (markdown) optional description for the field, also shown in UI as help text.
	Required    bool                     // make field as required: empty values will not be accepted as well as at least one option should be selected.
	Disabled    bool                     // user input will be ignored, by field will be visible in UI. Doesn't apply for options.
	Hidden      bool                     // user input will be ignored, field not visible in UI
	Default     Template[RequestContext] // golang template expression for the default value.  Doesn't apply for options with [Field.Multiple].
	Type        Type                     // (default [TypeString]) field type used for user input validation.
	Pattern     string                   // optional regexp to validate content, applicable only for string type
	Options     []Option                 // allowed values. If [Field.Multiple] set, it acts as "any of", otherwise "one of".
	Multiple    bool                     // allow picking multiple options. Column type in database MUST be ARRAY of corresponding type.
	Multiline   bool                     // multiline input (for [TypeString] only)
	Icon        string                   // optional MDI icon
}

type FieldError struct {
	Name  string
	Error error
}

type Form struct {
	Name        string                   // unique form name, if not set - file name without extension will be used.
	Table       string                   // database table name
	Title       string                   // optional title for the form
	Description Template[RequestContext] // (markdown) optional description of the form
	Fields      []Field                  // form fields
	Webhooks    []Webhook                // Webhook (HTTP) notification
	AMQP        []AMQP                   // AMQP notification
	Success     Template[ResultContext]  // markdown message for success (also go template with available .Result)
	Failed      Template[ResultContext]  // markdown message for failed (also go template with .Error)
	Policy      *Policy                  // optional access policy
	Codes       utils.Set[string]        // optional access tokens
}

type NotifyContext struct {
	Form   *Form
	Result map[string]any
}

type Option struct {
	Label string // label for UI
	Value string // if not set - Label is used, allowed value should match textual representation of form value
}

type Policy struct{ cel.Program }

type RequestContext struct {
	Headers     http.Header
	Query       url.Values
	Form        url.Values
	Code        string       // access code
	Credentials *Credentials // optional user credentials
}

type ResultContext struct {
	Form   *Form
	Result map[string]any
	Error  error
}

type Template[T any] struct {
	Valid bool
	Value *template.Template
}

type Type string

type Webhook struct {
	URL      string                  // URL for POST webhook, where payload is JSON with fields from database column.
	Method   string                  // HTTP method to perform, default is POST
	Retry    int                     // maximum number of retries (negative means no retries)
	Timeout  time.Duration           // request timeout
	Interval time.Duration           // interval between attempts (for non 2xx code)
	Headers  map[string]string       // arbitrary headers (ex: Authorization)
	Message  Template[NotifyContext] // payload content, if not set - JSON representation of storage result
}