contracts

type Authenable interface {
	UserID() string
	SetUserID(string)
}

type Cachable interface {
	Get(id string) interface{}
	Set(id string, value interface{}, ttl time.Duration)
	Del(id string)
	Push(id string, value interface{})
	Pop(id string) interface{}
	Flush()
	GC()
}

type Callable func(Context) (int, interface{})

type Context interface {
	Request() Request
	Response() Response
	Auth() Authenable
	URL(string, map[string]string) string
	Cache() Cachable
	Session() Session
}

type Mango interface {
	Any(string, Callable, ...ThenableFunc)
	Get(string, Callable, ...ThenableFunc)
	Post(string, Callable, ...ThenableFunc)
	Put(string, Callable, ...ThenableFunc)
	Delete(string, Callable, ...ThenableFunc)
	Group(string, func(Router), ...ThenableFunc)
	Use(ThenableFunc)
	SetDefaultRoute(Callable)
	SetCachable(Cachable)
	Start(string)
	StartTLS(string, string, string)
	StartAutoTLS(string, autocert.Cache, ...string)
	ServeHTTP(http.ResponseWriter, *http.Request)
	On(event string, fn func())
}

type Request interface {
	Parent() *http.Request
	IP() string
	File(string) (UploadedFile, error)
	Form(string) string
	Query(string) string
	Arg(string) string
	Input(string) string
	JSON(interface{}) error
	IsTLS() bool
	Header() http.Header
	Method() string
	URI() string
	URL() *url.URL
	Host() string
	SetArgs(map[string]string)
	Args() map[string]string
}

type Response interface {
	Parent() http.ResponseWriter
	Write([]byte) (int, error)
	WriteString(string) (int, error)
	WriteJSON(interface{}) error
	Header() http.Header
	Clear()
	Size() int
	Status() int
	SetStatus(int)
	SetCookie(*http.Cookie)
	DelCookie(string)
	Redirect(int, string) (int, interface{})
	Buffered() []byte
	Send() error
}

type Route interface {
	Method() string
	Path() string
	SetPath(string)
	Pathable() *regexp.Regexp
	Callable() Callable
	ThenStack() []ThenableFunc
	IsStatic() bool
}

type Router interface {
	Any(string, Callable, ...ThenableFunc)
	Get(string, Callable, ...ThenableFunc)
	Post(string, Callable, ...ThenableFunc)
	Put(string, Callable, ...ThenableFunc)
	Delete(string, Callable, ...ThenableFunc)
	Group(string, func(Router), ...ThenableFunc)
	Use(...ThenableFunc)
	Prefixes() []string
	ThenableStack() []ThenableFunc
	SetThenableStack(...ThenableFunc)
	ToMatch(Request) (Route, map[string]string)
	SetDefaultRoute(Callable)
}

type Session interface {
	Set(string, interface{})
	Get(string) (interface{}, bool)
}

type ThenableContext interface {
	Context
	Next()
}

type ThenableFunc func(ThenableContext)

type UploadedFile interface {
	Header() textproto.MIMEHeader
	Filename() string
	Size() int64
	StoreAs(path string, name string) (string, error)
	Store(path string) (string, error)
}