jwt

type ContextExtractor func(ctx context.Context) (string, error)

type ExtractorBuilder interface {
	// What decoder to use when unmarshalling
	SetDecoder(dec JSONDecoder) ExtractorBuilder
	// ContextExtractor lets you set a custom extractor from context.Context
	SetContextExtractor(extractor ContextExtractor) ExtractorBuilder
	// SetBase64Decoder lets you customize base64.Encoding, standard or URL or other
	SetBase64Decoder(dec *base64.Encoding) ExtractorBuilder
	Build() TokenExtractor
}

type JSONDecoder func(data []byte, v interface{}) error

type Token interface {
	// Raw returns JWT token as is: Base64("<algo>.<payload>.<signature>")
	Raw() string
	// Payload returns the payload (middle part) of JWT after base64 decode: UnBase64("<payload>")
	Payload() []byte
	// Map extracts token values (it's a JSON) to a map
	Map() (map[string]interface{}, error)
	// Decode extracts token values to a specified struct, struct should be a pointer
	// 	{
	// 		Subject string `json:"sub"`
	// 		Issuer string `json:"iss"`
	//		...
	// 	}
	Decode(target interface{}) error
}

type TokenExtractor interface {
	// FromContext should try to extract a token from the Context using `ContextExtractor`
	FromContext(ctx context.Context) (Token, error)
	// FromString accepts a JWT token in form of a string
	//	xxxxx.yyyyy.zzzzz
	FromString(str string) (Token, error)
}