kitebuilder

type API struct {
	ID                  string                        `json:"ksuid,omitempty"`
	URL                 string                        `json:"url"`
	SecurityDefinitions map[string]SecurityDefinition `json:"securityDefinitions"`
	Paths               map[Path]Operations           `json:"paths"`
}

type ContentType string

type Operation struct {
	Description string        `json:"description,omitempty"`
	OperationID string        `json:"operationId,omitempty"`
	Parameters  []Parameter   `json:"parameter,omitempty"`
	Consumes    []ContentType `json:"consume,omitempty"`
	Produces    []ContentType `json:"produce,omitempty"`
}

type OperationTypes string

type Operations map[OperationTypes]Operation

type Parameter struct {
	Description string      `json:"description,omitempty"`
	In          string      `json:"in,omitempty"`
	Name        string      `json:"name,omitempty"`
	Required    interface{} `json:"required,omitempty"`

	Schema *Schema `json:"schema,omitempty"` // if in == "body"

	// if in != "body"
	Type            string      `json:"type,omitempty"`
	AllowEmptyValue bool        `json:"allowEmptyValue,omitempty"`
	Pattern         string      `json:"pattern,omitempty"`
	Format          string      `json:"format,omitempty"`
	Example         interface{} `json:"example,omitempty"`

	Minimum   float64 `json:"minimum,omitempty"`
	Maximum   float64 `json:"maximum,omitempty"`
	MaxLength uint64  `json:"maxLength,omitempty"`
	MaxItems  uint64  `json:"maxItems,omitempty"`
	MinLength uint64  `json:"minLength,omitempty"`
	MinItems  uint64  `json:"minItems,omitempty"`

	Enum    []interface{} `json:"enum,omitempty"` // can be [1,2,3] ["a", "b", "c"]
	Default interface{}   `json:"default,omitempty"`

	Items *Schema `json:"items,omitempty"`
}

type Path string

type Schema struct {
	Properties       map[string]Schema `json:"properties,omitempty"`
	Type             string            `json:"type,omitempty" yaml:"type,omitempty"`
	Title            string            `json:"title,omitempty" yaml:"title,omitempty"`
	Format           string            `json:"format,omitempty" yaml:"format,omitempty"`
	Description      string            `json:"description,omitempty" yaml:"description,omitempty"`
	Enum             []interface{}     `json:"enum,omitempty" yaml:"enum,omitempty"`
	Default          interface{}       `json:"default,omitempty" yaml:"default,omitempty"`
	Example          interface{}       `json:"example,omitempty" yaml:"example,omitempty"`
	Name             string            `json:"name,omitempty"`
	CollectionFormat string            `json:"collectionFormat,omitempty"`

	// Array-related, here for struct compactness
	UniqueItems bool `json:"uniqueItems,omitempty" yaml:"uniqueItems,omitempty"`
	// Number-related, here for struct compactness
	ExclusiveMin bool `json:"exclusiveMinimum,omitempty" yaml:"exclusiveMinimum,omitempty"`
	ExclusiveMax bool `json:"exclusiveMaximum,omitempty" yaml:"exclusiveMaximum,omitempty"`
	// Properties
	Nullable bool `json:"nullable,omitempty" yaml:"nullable,omitempty"`
	ReadOnly bool `json:"readOnly,omitempty" yaml:"readOnly,omitempty"`
	// can be either []string or bool. We don't actually pay attention to this field
	WriteOnly       bool        `json:"writeOnly,omitempty" yaml:"writeOnly,omitempty"`
	AllowEmptyValue bool        `json:"allowEmptyValue,omitempty" yaml:"allowEmptyValue,omitempty"`
	XML             interface{} `json:"xml,omitempty" yaml:"xml,omitempty"`
	Deprecated      bool        `json:"deprecated,omitempty" yaml:"deprecated,omitempty"`

	// Number
	Min        float64 `json:"minimum,omitempty" yaml:"minimum,omitempty"`
	Max        float64 `json:"maximum,omitempty" yaml:"maximum,omitempty"`
	MultipleOf float64 `json:"multipleOf,omitempty" yaml:"multipleOf,omitempty"`

	// String
	MinLength uint64 `json:"minLength,omitempty" yaml:"minLength,omitempty"`
	MaxLength uint64 `json:"maxLength,omitempty" yaml:"maxLength,omitempty"`
	Pattern   string `json:"pattern,omitempty" yaml:"pattern,omitempty"`

	// Array
	MinItems             uint64  `json:"minItems,omitempty" yaml:"minItems,omitempty"`
	MaxItems             uint64  `json:"maxItems,omitempty" yaml:"maxItems,omitempty"`
	Items                *Schema `json:"items,omitempty" yaml:"items,omitempty"`
	AdditionalProperties *Schema `json:"additional_properties,omitempty"`

	// Object
	Required interface{} `json:"required,omitempty" yaml:"required,omitempty"`

	MinProps uint64   `json:"minProperties,omitempty" yaml:"minProperties,omitempty"`
	MaxProps uint64   `json:"maxProperties,omitempty" yaml:"maxProperties,omitempty"`
	AllOf    []Schema `json:"allOf,omitempty"`
}

type SecurityDefinition struct {
	In   string `json:"in"`
	Name string `json:"name"`
	Type string `json:"type"`
}

type Typer interface {
	GetType() string
	GetName() string
	GetExample() interface{}
	GetFormat() string
	GetPattern() string
	GetDefault() interface{}

	GetIn() string // exclusive to parameter, so a schema should return empty

	GetMinimum() float64
	GetMaximum() float64

	GetProperties() map[string]Schema
	GetAdditionalProperties() *Schema
	GetSchema() *Schema
	GetItems() *Schema
	GetAllOf() []Schema
}