common

Documentation

Index

• Constants
• func HasContentType(headers http.Header, mimetype string) bool
• func ParseQueryParams(r *http.Request) map[string]any
• func ParseRequestData(r *http.Request) (any, error)
• type HandlerFunc
• type PermissionState
  • func NewPermissionState() *PermissionState
  • func (ps *PermissionState) Grant()
• type PermissionStatus
• type Response
  • func InternalServerErrorResponse(ctx context.Context, err error) Response
  • func NewJsonResponse(status int, body any, meta *ResponseMetadata) Response
  • func NewRedirectResponse(url *url.URL) Response
• type ResponseMetadata
• type RuntimeError
  • func NewAuthenticationFailedErr() RuntimeError
  • func NewAuthenticationFailedMessageErr(message string) RuntimeError
  • func NewForeignKeyConstraintError(column string) RuntimeError
  • func NewHttpMethodNotAllowedError(message string) RuntimeError
  • func NewInputMalformedError(message string) RuntimeError
  • func NewMethodNotFoundError() RuntimeError
  • func NewNotFoundError(message string) RuntimeError
  • func NewNotNullError(column string) RuntimeError
  • func NewPermissionError() RuntimeError
  • func NewUniquenessError(columns []string) RuntimeError
  • func NewValidationError(message string) RuntimeError
  • func (r RuntimeError) Error() string
  • func (r RuntimeError) Extensions() map[string]any

Constants

const (
	// An unexpected internal error happened.
	ErrInternal = "ERR_INTERNAL"
	// The input arguments provided are not valid.
	ErrInvalidInput = "ERR_INVALID_INPUT"
	// The input provided is malformed and cannot be parsed.
	ErrInputMalformed = "ERR_INPUT_MALFORMED"
	// Authentication failed when trying to identify the identity.
	ErrAuthenticationFailed = "ERR_AUTHENTICATION_FAILED"
	// Permission denied when trying to access some resource.
	ErrPermissionDenied = "ERR_PERMISSION_DENIED"
	// Record cannot be found with the provided parameters.
	ErrRecordNotFound = "ERR_RECORD_NOT_FOUND"
	// The path or action does not exist.
	ErrMethodNotFound = "ERR_ACTION_NOT_FOUND"
	// The HTTP method is not allowed for this request.
	ErrHttpMethodNotAllowed = "ERR_HTTP_METHOD_NOT_ALLOWED"
	// An unexpected error happened from user code
	ErrUnknown = "ERR_UNKNOWN"
)

Functions

func HasContentType

func HasContentType(headers http.Header, mimetype string) bool

func ParseQueryParams

func ParseQueryParams(r *http.Request) map[string]any

ParseQueryParams will parse the parmeters in the request query string.

func ParseRequestData

func ParseRequestData(r *http.Request) (any, error)

ParseRequestData will parse the request based on the Content-Type header. Defaults to parsing as a JSON request body.

Types

type HandlerFunc

type HandlerFunc func(r *http.Request) Response

type PermissionState

type PermissionState struct {
	Status PermissionStatus `json:"status"`
}

func NewPermissionState

func NewPermissionState() *PermissionState

func (*PermissionState) Grant

func (ps *PermissionState) Grant()

type PermissionStatus

type PermissionStatus string

const (
	PermissionGranted PermissionStatus = "granted"
	PermissionUnknown PermissionStatus = "unknown"
)

type Response

type Response struct {
	Status  int
	Body    []byte
	Headers map[string][]string
}

func InternalServerErrorResponse

func InternalServerErrorResponse(ctx context.Context, err error) Response

func NewJsonResponse

func NewJsonResponse(status int, body any, meta *ResponseMetadata) Response

func NewRedirectResponse

func NewRedirectResponse(url *url.URL) Response

type ResponseMetadata

type ResponseMetadata struct {
	Headers http.Header
	Status  int
}

type RuntimeError

type RuntimeError struct {
	Code    string
	Message string
}

func NewAuthenticationFailedErr

func NewAuthenticationFailedErr() RuntimeError

func NewAuthenticationFailedMessageErr

func NewAuthenticationFailedMessageErr(message string) RuntimeError

func NewForeignKeyConstraintError

func NewForeignKeyConstraintError(column string) RuntimeError

func NewHttpMethodNotAllowedError

func NewHttpMethodNotAllowedError(message string) RuntimeError

func NewInputMalformedError

func NewInputMalformedError(message string) RuntimeError

func NewMethodNotFoundError

func NewMethodNotFoundError() RuntimeError

func NewNotFoundError

func NewNotFoundError(message string) RuntimeError

func NewNotNullError

func NewNotNullError(column string) RuntimeError

func NewPermissionError

func NewPermissionError() RuntimeError

func NewUniquenessError

func NewUniquenessError(columns []string) RuntimeError

func NewValidationError

func NewValidationError(message string) RuntimeError

func (RuntimeError) Error

func (r RuntimeError) Error() string

func (RuntimeError) Extensions

func (r RuntimeError) Extensions() map[string]any