handlers

Documentation

Index

• Constants
• func ApiErrorWithCode(c codes.Code) error
• func ApiErrorWithCodeAndMessage(c codes.Code, msg string, args ...interface{}) error
• func ErrorHandler(logger hclog.Logger) runtime.ErrorHandlerFunc
• func ForbiddenError() error
• func GetOpts(opt ...Option) options
• func InvalidArgumentErrorf(msg string, fields map[string]string) *apiError
• func JSONMarshaler() *runtime.JSONPb
• func MaskContains(paths []string, s string) bool
• func NotFoundError() error
• func NotFoundErrorf(msg string, a ...interface{}) *apiError
• func OutgoingInterceptor(ctx context.Context, w http.ResponseWriter, m proto.Message) error
• func ProtoToStruct(p proto.Message) (*structpb.Struct, error)
• func StructToProto(fields *structpb.Struct, p proto.Message, opt ...Option) error
• func ToApiError(e error) *pb.Error
• func UnauthenticatedError() error
• func ValidId(i Id, prefixes ...string) bool
• func ValidNameDescription(in string) bool
• func ValidateCreateRequest(i ApiResource, fn CustomValidatorFunc) error
• func ValidateDeleteRequest(fn CustomValidatorFunc, r DeleteRequest, prefix ...string) error
• func ValidateGetRequest(fn CustomValidatorFunc, r GetRequest, prefix ...string) error
• func ValidateUpdateRequest(r UpdateRequest, i ApiResource, fn CustomValidatorFunc, prefix ...string) error
• type ApiResource
• type CustomValidatorFunc
• type DeleteRequest
• type Filter
  • func NewFilter(f string) (*Filter, error)
  • func (f *Filter) Match(item interface{}) bool
• type GetRequest
• type Id
• type MaskManager
  • func NewMaskManager(dest protoreflect.ProtoMessage, src ...protoreflect.ProtoMessage) (MaskManager, error)
  • func (m MaskManager) Translate(paths []string) []string
• type Option
  • func WithAuthorizedActions(acts []string) Option
  • func WithAuthorizedCollectionActions(colActs map[string]*structpb.ListValue) Option
  • func WithDiscardUnknownFields(discard bool) Option
  • func WithLogger(logger hclog.Logger) Option
  • func WithOutputFields(fields *perms.OutputFieldsMap) Option
  • func WithScope(scp *scopes.ScopeInfo) Option
  • func WithUserIsAnonymous(anonListing bool) Option
• type UpdateRequest

Constants

const (
	HttpOnlyCookieName  = "wt-http-token-cookie"
	JsVisibleCookieName = "wt-js-token-cookie"
)

Functions

func ApiErrorWithCode

func ApiErrorWithCode(c codes.Code) error

ApiErrorWithCode returns an api error with the provided code.

func ApiErrorWithCodeAndMessage

func ApiErrorWithCodeAndMessage(c codes.Code, msg string, args ...interface{}) error

ApiErrorWithCodeAndMessage returns an api error with the provided code and message.

func ErrorHandler

func ErrorHandler(logger hclog.Logger) runtime.ErrorHandlerFunc

func ForbiddenError

func ForbiddenError() error

func GetOpts

func GetOpts(opt ...Option) options

GetOpts - iterate the inbound Options and return a struct

func InvalidArgumentErrorf

func InvalidArgumentErrorf(msg string, fields map[string]string) *apiError

func JSONMarshaler

func JSONMarshaler() *runtime.JSONPb

JSONMarshaler provides marshaler used for marshalling all proto as JSON in a format expected by the user facing controller API.

func MaskContains

func MaskContains(paths []string, s string) bool

func NotFoundError

func NotFoundError() error

NotFoundError returns an ApiError indicating a resource couldn't be found.

func NotFoundErrorf

func NotFoundErrorf(msg string, a ...interface{}) *apiError

NotFoundErrorf returns an ApiError indicating a resource couldn't be found.

func OutgoingInterceptor

func OutgoingInterceptor(ctx context.Context, w http.ResponseWriter, m proto.Message) error

func ProtoToStruct

func ProtoToStruct(p proto.Message) (*structpb.Struct, error)

func StructToProto

func StructToProto(fields *structpb.Struct, p proto.Message, opt ...Option) error

func ToApiError

func ToApiError(e error) *pb.Error

func UnauthenticatedError

func UnauthenticatedError() error

func ValidId

func ValidId(i Id, prefixes ...string) bool

func ValidNameDescription

func ValidNameDescription(in string) bool

func ValidateCreateRequest

func ValidateCreateRequest(i ApiResource, fn CustomValidatorFunc) error

func ValidateDeleteRequest

func ValidateDeleteRequest(fn CustomValidatorFunc, r DeleteRequest, prefix ...string) error

func ValidateGetRequest

func ValidateGetRequest(fn CustomValidatorFunc, r GetRequest, prefix ...string) error

func ValidateUpdateRequest

func ValidateUpdateRequest(r UpdateRequest, i ApiResource, fn CustomValidatorFunc, prefix ...string) error

Types

type ApiResource

type ApiResource interface {
	GetId() string
	GetScope() *scopes.ScopeInfo
	GetName() *wrappers.StringValue
	GetDescription() *wrappers.StringValue
	GetCreatedTime() *timestamp.Timestamp
	GetUpdatedTime() *timestamp.Timestamp
	GetVersion() uint32
}

type CustomValidatorFunc

type CustomValidatorFunc func() map[string]string

var NoopValidatorFn CustomValidatorFunc = func() map[string]string { return nil }

type DeleteRequest

type DeleteRequest interface {
	GetId() string
}

type Filter

type Filter struct {
	// contains filtered or unexported fields
}

func NewFilter

func NewFilter(f string) (*Filter, error)

NewFilter returns a Filter which can be evluated against. An empty string paramter indicates all items passed to it should succeed.

func (*Filter) Match

func (f *Filter) Match(item interface{}) bool

Match returns if the provided interface matches the filter. If the filter does not match the structure of the object being Matched, false is returned. TODO: Support more than just matching against the item being filtered. Also allow matching against

values in the request or the request context itself.

type GetRequest

type GetRequest interface {
	GetId() string
}

type Id

type Id string

A boundary resource identifier

type MaskManager

type MaskManager map[string]string

func NewMaskManager

func NewMaskManager(dest protoreflect.ProtoMessage, src ...protoreflect.ProtoMessage) (MaskManager, error)

NewMaskManager returns a mask manager that can translate field masks into the first proto from all subsequent protos assuming they are both using the mask_mapping custom option. Error is returned if no mappings are found or if one of the passed protos has a mapping that doesn't reciprocate.

func (MaskManager) Translate

func (m MaskManager) Translate(paths []string) []string

Translate takes a field mask's paths and returns paths translated for the destination's protobuf.

type Option

type Option func(*options)

Option - how Options are passed as arguments. Some of these are used for types within the handlers package, and some are for handlers to re-use across the various handler types.

func WithAuthorizedActions

func WithAuthorizedActions(acts []string) Option

WithAuthorizedActions provides an option when creating responses to include the given authorized actions if allowed

func WithAuthorizedCollectionActions

func WithAuthorizedCollectionActions(colActs map[string]*structpb.ListValue) Option

WithAuthorizedCollectionActions provides an option when creating responses to include the given authorized collection actions if allowed

func WithDiscardUnknownFields

func WithDiscardUnknownFields(discard bool) Option

WithDiscardUnknownFields provides an option to cause StructToProto to ignore unknown fields. This is useful in some instances when we need to unmarshal a value from a pb.Struct after we've added some custom extra fields.

func WithLogger

func WithLogger(logger hclog.Logger) Option

WithLogger provides an option include a logger

func WithOutputFields

func WithOutputFields(fields *perms.OutputFieldsMap) Option

WithOutputFields provides an option when creating responses to only include specific fields

func WithScope

func WithScope(scp *scopes.ScopeInfo) Option

WithScope provides an option when creating responses to include the given scope if allowed

func WithUserIsAnonymous

func WithUserIsAnonymous(anonListing bool) Option

DEPRECATED: Superceded by WithOutputFields. Will be removed once all handlers have been migrated to that.

type UpdateRequest

type UpdateRequest interface {
	GetId() string
	GetUpdateMask() *field_mask.FieldMask
}