core

type ByteSize int64

type Connection struct {
	Driver string
	Name   string
	URL    string
	Pool   PoolConfig
}

type Context struct {
	Request        *RequestState             `json:"request"`
	Steps          map[string]map[string]any `json:"steps"`
	TimestampEpoch int64                     `json:"timestamp_epoch"`
	IngressTime    time.Time                 `json:"-"`
	Server         Server                    `json:"-"`
	RawRequest     *http.Request             `json:"-"`
}

type ContextOption func(*contextConfig)

type Duration time.Duration

type ErrorHandler func(w http.ResponseWriter, r *http.Request, problem ProblemDetailsError)

type Field struct {
	Name        string
	Type        string // "string", "int", "float", "bool", "any", "list(string)", etc.
	Required    bool
	Default     any // Evaluated static default or nil
	Description string
	Enum        []any  // Evaluated allowed values or nil
	Format      string // "email", "uuid", "date-time", etc.
	Pattern     string // Regex pattern or empty
	MinLength   *int
	MaxLength   *int
	Min         *float64
	Max         *float64
	MinItems    *int
	MaxItems    *int
	UniqueItems bool
}

type InvalidParam struct {
	Name   string `json:"name"`
	Reason string `json:"reason"`
}

type OpenAPIConfig struct {
	Title       string
	Version     string
	Description string
	Servers     []OpenAPIServer
	Tags        []OpenAPITag
	Contact     *OpenAPIContact
	License     *OpenAPILicense
}

type OpenAPIContact struct {
	Name  string
	Email string
	URL   string
}

type OpenAPILicense struct {
	Name string
	URL  string
}

type OpenAPIServer struct {
	URL         string
	Description string
}

type OpenAPITag struct {
	Name        string
	Description string
}

type Options struct {
	// ConfigPath is a file or directory of .hcl definitions.
	ConfigPath string

	// StrictTyping enforces request schema validation on all endpoints.
	StrictTyping bool

	// ErrorHandler formats error responses. If nil, RFC 9457 defaults are used.
	ErrorHandler ErrorHandler

	// Logger receives operational logs. If nil, logging is discarded.
	Logger *slog.Logger
}

type PoolConfig struct {
	MaxOpenConns    int
	MaxIdleConns    int
	ConnMaxLifetime Duration
	IdleTimeout     Duration
	Size            int
}

type ProblemDetailsError struct {
	Type          string         `json:"type,omitempty"`
	Title         string         `json:"title"`
	Status        int            `json:"status"`
	Detail        string         `json:"detail,omitempty"`
	Instance      string         `json:"instance,omitempty"`
	Step          string         `json:"step,omitempty"`
	InvalidParams []InvalidParam `json:"invalid_params,omitempty"`
	Extensions    map[string]any `json:"extensions,omitempty"`
}

type RequestState struct {
	Method  string            `json:"method"`
	Path    map[string]string `json:"path"`
	Query   map[string]string `json:"query"`
	Headers map[string]string `json:"headers"`
	Body    any               `json:"body"`
}

type Schema struct {
	Name        string
	Description string
	Fields      []Field
}

type Server struct {
	Host         string
	Port         int
	ReadTimeout  Duration
	WriteTimeout Duration
	IdleTimeout  Duration
	MaxBodySize  ByteSize
	ErrorBaseURL string // TODO: validate introducing a new block to put stuff like this
	OpenAPI      OpenAPIConfig
}

type StepHandler func(ctx *Context, args map[string]any) (any, error)

type StepResult = map[string]any