config

type Builder struct {

	// StrictQueriesMode if true sets the strict mode for the query builder, that doesn't allow
	// unknown query keys
	StrictQueriesMode bool `mapstructure:"strict_queries"`

	// ErrorLimits defines the upper limit of the error number while getting the query
	ErrorLimits int `validate:"min=1,max=20" mapstructure:"error_limit"`

	// IncludeNestedLimit is a maximum value for nested includes (i.e. IncludeNestedLimit = 1
	// allows ?include=posts.comments but does not allow ?include=posts.comments.author)
	IncludeNestedLimit int `validate:"min=1,max=20" mapstructure:"include_nested_limit"`

	// FilterValueLimit is a maximum length of the filter values
	FilterValueLimit int `validate:"min=1,max=50" mapstructure:"filter_value_limit"`

	// Processor is the query processor for the query builder
	Processor *Processor `validate:"required" mapstructure:"processor"`
}

type Config struct {
	// Controller defines the configuration for the Controllers
	Controller *Controller `mapstructure:"controller"`

	// Gateway is the configuration for the gateway
	Gateway *Gateway `mapstructure:"gateway"`
}

type Connection struct {
	// Host defines the access hostname or the ip address
	Host string `mapstructure:"host" validate:"hostname|ip"`

	// Path is the connection path, just after the protocol and
	Path string `mapstructure:"path" validate:"isdefault|uri"`

	// Port is the connection port
	Port interface{} `mapstructure:"port"`

	// Protocol is the protocol used in the connection
	Protocol string `mapstructure:"protocol"`

	// RawURL is the raw connection url. If set it must define the protocol ('http://',
	// 'rpc://'...)
	RawURL string `mapstructure:"raw_url" validate:"isdefault|url"`

	// Username is the username used to get connection credential
	Username string `mapstructure:"username"`

	// Password is the password used to get connection credentials
	Password string `mapstructure:"password"`

	// Options contains connection dependent specific options
	Options map[string]interface{} `mapstructure:"options"`

	// MaxTimeout defines the maximum timeout for the given repository connection
	MaxTimeout *time.Duration `mapstructure:"max_timeout"`
}

type Controller struct {

	// NamingConvention is the naming convention used while preparing the models.
	// Allowed values:
	// - camel
	// - lowercamel
	// - snake
	// - kebab
	NamingConvention string `mapstructure:"naming_convention" validate:"isdefault|oneof=camel lowercamel snake kebab"`

	// DefaultSchema is the default schema name for the models within given controller
	DefaultSchema string `validate:"alphanum" mapstructure:"default_schema"`

	// ModelSchemas defines the model schemas used by api
	ModelSchemas map[string]*Schema `mapstructure:"schemas"`

	// StrictUnmarshalMode is the flag that defines if the unmarshaling should be in a
	// strict mode that checks if incoming values are all known to the controller
	// As well as the query builder doesn't allow unknown queries
	StrictUnmarshalMode bool `mapstructure:"strict_unmarshal"`

	// Debug sets the debug mode for the controller.
	Debug bool `mapstructure:"debug"`

	// Flags defines the controller default flags
	Flags *Flags `mapstructure:"flags"`

	// Repositories contains the connection configs for the given repository instance name
	Repositories map[string]*Repository `mapstructure:"repositories" validate:"-"`

	// DefaultRepositoryName defines default repositoy name
	DefaultRepositoryName string `mapstructure:"default_repository_name"`

	// DefaultRepository defines controller default repository
	DefaultRepository *Repository `mapstructure:"default_repository" validate:"-"`

	// Processor is the config used for the scope processor
	Processor *Processor `mapstructure:"processor" validate:"required"`

	// CreateValidatorAlias is the alias for the create validators
	CreateValidatorAlias string `mapstructure:"create_validator_alias"`

	// PatchValidatorAlias is the alis used for the Patch validator
	PatchValidatorAlias string `mapstructure:"patch_validator_alias"`

	// DefaultValidatorAlias is the alias used as a default validator alias
	DefaultValidatorAlias string `mapstructure:"default_validator_alias"`
}

type Endpoint struct {

	// Forbidden defines if the endpoint should not be used
	Forbidden bool `mapstructure:"forbidden"`

	// PresetFilters defines preset filters definitions for an endpoint
	PresetFilters []string `mapstructure:"preset_filters"`

	// PresetScope defines preset scopes for an endpoint
	PresetScope []string `mapstructure:"preset_scope"`

	// PrecheckFilters are the endpoints filters used to check the consistency of the query
	PrecheckFilters []string `mapstructure:"precheck_filters"`

	// PrecheckScope are the endpoint scopes used to check the consistency of the query
	PrecheckScope []string `mapstructure:"precheck_scope"`

	// PresetSorts are the sort fields used by default on given endpoint
	PresetSorts []string `mapstructure:"preset_sorts"`

	// PresetPagination are the default pagination for provided endpoint
	PresetPagination *Pagination `mapstructure:"preset_pagination"`

	// Flags contains boolean flags used by default on given endpoint
	Flags Flags `mapstructure:"flags"`

	// RelatedField contains constraints for the relationship or related (endpoint) field
	RelatedField EndpointConstraints `mapstructure:"related"`

	// CustomMiddlewares are the middlewares used for the provided endpoint
	CustomMiddlewares []string `mapstructure:"custom_middlewares"`
}

type EndpointConstraints struct {
	// PrecheckFilters are the endpoints filters used to check the consistency of the query
	PresetFilters []string `mapstructure:"preset_filters"`

	// PresetScope defines preset scopes for an endpoint
	PresetScope []string `mapstructure:"preset_scope"`

	// PrecheckFilters are the endpoints filters used to check the consistency of the query
	PrecheckFilters []string `mapstructure:"precheck_filters"`

	// PrecheckScope are the endpoint scopes used to check the consistency of the query
	PrecheckScope []string `mapstructure:"precheck_scope"`

	// PresetSorts are the sort fields used by default on given endpoint
	PresetSorts []string `mapstructure:"preset_sorts"`

	// PresetPagination are the default pagination for provided endpoint
	PresetPagination *Pagination `mapstructure:"preset_pagination"`
}

type Flags map[string]interface{}

type Gateway struct {
	// Port is the port used by the gateway service
	Port int `mapstructure:"port" validate:"required"`

	// Hostname is the hostname used by the gateway service
	Hostname string `mapstructure:"hostname" validate:"hostname"`

	// ReadTimeout is the maximum duration for reading the entire
	// request, including the body.
	//
	// Because ReadTimeout does not let Handlers make per-request
	// decisions on each request body's acceptable deadline or
	// upload rate, most users will prefer to use
	// ReadHeaderTimeout. It is valid to use them both.
	ReadTimeout time.Duration `mapstructure:"read_timeout"`

	// ReadHeaderTimeout is the amount of time allowed to read
	// request headers. The connection's read deadline is reset
	// after reading the headers and the Handler can decide what
	// is considered too slow for the body.
	ReadHeaderTimeout time.Duration `mapstructure:"read_header_timeout"`

	// WriteTimeout is the maximum duration before timing out
	// writes of the response. It is reset whenever a new
	// request's header is read. Like ReadTimeout, it does not
	// let Handlers make decisions on a per-request basis.
	WriteTimeout time.Duration `mapstructure:"write_timeout"`

	// IdleTimeout is the maximum amount of time to wait for the
	// next request when keep-alives are enabled. If IdleTimeout
	// is zero, the value of ReadTimeout is used. If both are
	// zero, ReadHeaderTimeout is used.
	IdleTimeout time.Duration `mapstructure:"idle_timeout"`

	// ShutdownTimeout defines the time (in seconds) in which the server would shutdown
	// On the os.Interrupt event
	ShutdownTimeout time.Duration `mapstructure:"shutdown_timeout"`

	TLSCertPath string `mapstructure:"tls_cert_path"`

	// Router defines the router configuration
	Router *Router `mapstructure:"router"`

	// QueryBuilder contains the query builder config
	QueryBuilder *Builder `mapstructure:"query_builder"`

	I18n *I18nConfig `mapstructure:"i18n"`
}

type I18nConfig struct {

	// SupportedLanguages represent supported languages tags
	SupportedLanguages []string
}

type ModelConfig struct {
	// Collection is the model's collection name
	Collection string `mapstructure:"collection"`

	// RepositoryName is the model's repository name, with the name provided in the initialization
	// process...
	RepositoryName string `mapstructure:"repository_name"`

	// Endpoints defines model's api endpoints configuration
	Endpoints ModelEndpoints `mapstructure:"endpoints"`

	// Map sets the model's Store values
	Map map[string]interface{} `mapstructure:"map"`

	// Repository defines the model's repository connection config
	Repository *Repository `mapstructure:"repository"`

	// AutoMigrate automatically migrates the model into the given repository structuring
	// I.e. sql creates or updates the table
	AutoMigrate bool `mapstructure:"automigrate"`
}

type ModelEndpoints struct {
	Create          Endpoint `mapstructure:"create"`
	Get             Endpoint `mapstructure:"get"`
	GetRelated      Endpoint `mapstructure:"get_related"`
	GetRelationship Endpoint `mapstructure:"get_relationship"`
	List            Endpoint `mapstructure:"list"`
	Patch           Endpoint `mapstructure:"patch"`
	Delete          Endpoint `mapstructure:"delete"`
}

type Pagination struct {
	Limit      int `mapstructure:"limit"`
	Offset     int `mapstructure:"offset"`
	PageSize   int `mapstructure:"page_size"`
	PageNumber int `mapstructure:"page_number"`
}

type PresetQuery struct {
	// Field defines the field to that the values should be set with
	Field string

	// ScopeRelations gets the values by the collection relations
	// i.e. if the collection 'blog' has a relationship of kind to many 'posts'
	//
	// Trying to filter the 'posts' by the specific blogs values can be made by providing
	// the ScopeRelations value i.e.: 'blogs.posts' with the Filter: '[blogs][id][$eq]=1'
	// This result with the possible
	ScopeRelations string

	Filters []string
}

type PresetScope struct {
	// Scope Query defines the preset scope
	ScopeQuery string
	Filter     string
}

type ProcessList []string

type Processor struct {
	DefaultTimeout time.Duration `mapstructure:"default_timeout"`

	// CreateProcesses are the default processes used inthe create method
	CreateProcesses ProcessList `mapstructure:"create_processes"`

	// DeleteProcesses are the default processes used inthe delete method
	DeleteProcesses ProcessList `mapstructure:"delete_processes"`

	// GetProcesses are the default processes used inthe get method
	GetProcesses ProcessList `mapstructure:"get_processes"`

	// ListProcesses are the default processes used inthe list method
	ListProcesses ProcessList `mapstructure:"list_processes"`

	// PatchProcesses are the default processes used inthe patch method
	PatchProcesses ProcessList `mapstructure:"patch_processes"`
}

type Repository struct {
	// DriverName defines the name for the repository driver
	DriverName string `mapstructure:"driver_name"`

	// Host defines the access hostname or the ip address
	Host string `mapstructure:"host" validate:"hostname|ip"`

	// Path is the connection path, just after the protocol and
	Path string `mapstructure:"path" validate:"isdefault|uri"`

	// Port is the connection port
	Port interface{} `mapstructure:"port"`

	// Protocol is the protocol used in the connection
	Protocol string `mapstructure:"protocol"`

	// RawURL is the raw connection url. If set it must define the protocol ('http://',
	// 'rpc://'...)
	RawURL string `mapstructure:"raw_url" validate:"isdefault|url"`

	// Username is the username used to get connection credential
	Username string `mapstructure:"username"`

	// Password is the password used to get connection credentials
	Password string `mapstructure:"password"`

	// Options contains connection dependent specific options
	Options map[string]interface{} `mapstructure:"options"`

	// MaxTimeout defines the maximum timeout for the given repository connection
	MaxTimeout *time.Duration `mapstructure:"max_timeout"`

	// DBName gets the database name
	DBName string `mapstructure:"dbname"`

	// SSLMode defines if the ssl is enabled
	SSLMode string `mapstructure:"sslmode"`
}

type Router struct {
	// Name gets the router by it's registered name
	Name string `mapstructure:"name"`

	// DefaultMiddlewares are the middlewares used as default for each endpoint
	// without middlewares set from the
	DefaultMiddlewares []string `mapstructure:"default_middlewares"`

	// Prefix is the url prefix for the API
	Prefix string `mapstructure:"prefix"`

	// DefaultPagination defines default ListPagination for the gateway
	DefaultPagination *Pagination `mapstructure:"default_pagination"`

	// CompressionLevel defines the compression level for the handler function writers
	CompressionLevel int `mapstructure:"compression_level" validate:"max=9,min=-2"`
}

type Schema struct {
	Name       string                  `mapstructure:"name"`
	Models     map[string]*ModelConfig `mapstructure:"models"`
	Local      bool                    `mapstructure:"local"`
	Connection *Connection             `mapstructure:"connection"`
}