swt

Nov 15, 2025

Changes in this version

type HandlerOptions

+ Logger *slog.Logger

+ ReplayChecker ReplayChecker

+ ReturnErrorDetails bool

+ type ReplayChecker interface

+ CheckAndRecord func(ctx context.Context, jti string) error

type Request

+ func (r *Request) BuildWithContext(ctx context.Context, key any, opts ...Option) (*http.Request, error)

type SecureWebhookToken

+ func ParseWithClaimsContext(ctx context.Context, tokenStr string, claims Claims, key any) (*SecureWebhookToken, error)

+ func ParseWithContext(ctx context.Context, tokenStr string, key any) (*SecureWebhookToken, error)

Nov 13, 2025

Changes in this version

+ var ErrInvalidHeaderClaim = errors.New("invalid token header claim")

+ type Hash string

+ func NewHash(alg string, data []byte) *Hash

+ func NewHashFromString(input string) *Hash

+ func (h *Hash) Algorithm() string

+ func (h *Hash) String() string

+ func (h *Hash) Sum() string

type Option

+ func WithRetryCount(rc uint) Option

type Request

+ func (r *Request) HasValidJSONData() bool

type Webhook

+ Hash *Hash

+ RetryCount uint

Jun 23, 2025

Changes in this version

+ var ErrInvalidTokenHandler = errors.New("invalid token handler function")

Jun 23, 2025

Changes in this version

+ var ErrInvalidToken = errors.New("invalid token - please use New or NewWithClaims to properly initialize token")

+ type Request struct

+ Data []byte

+ Event string

+ HashAlg string

+ Issuer string

+ URL string

+ func (r *Request) Build(key any, opts ...Option) (*http.Request, error)

+ func (r *Request) BuildHead(key any, opts ...Option) (*http.Request, error)

+ func (r *Request) BuildPost(key any, opts ...Option) (*http.Request, error)

Jun 11, 2025

Changes in this version

+ const HeadMaxDataSize

+ const SHA256

+ const SHA384

+ const SHA3_256

+ const SHA3_384

+ const SHA3_512

+ const SHA512

+ var ErrInvalidData = errors.New("invalid data")

+ var ErrInvalidJSON = errors.New("invalid json data")

+ var ErrInvalidOption = errors.New("invalid option")

+ var ErrMissingClaims = errors.New("missing claims")

+ var ErrUnsupportedHashAlgorithm = errors.New("unsupported hash algorithm")

+ func BuildHeadRequest(url, issuer, event string, data []byte, key any) (*http.Request, error)

+ func BuildPostRequest(url, issuer, event string, data []byte, key any) (*http.Request, error)

+ func BuildRequest(url, issuer, event string, data []byte, key any) (*http.Request, error)

+ func HashSum(hashAlg string, body []byte) (string, error)

+ func NewHandlerFunc(secret []byte, handleFn func(*SecureWebhookToken) error, opts *HandlerOptions) http.HandlerFunc

+ type Claims interface

+ GetID func() (string, error)

+ GetWebhook func() (Webhook, error)

+ type HandlerOptions struct

+ MaxBodySize int64

+ type Option func(swt *SecureWebhookToken)

+ func WithAudience(ids ...string) Option

+ func WithExpiresAt(t time.Time) Option

+ func WithID(id string) Option

+ func WithNotBefore(t time.Time) Option

+ func WithSigningMethod(method *jwt.SigningMethodHMAC) Option

+ func WithSubject(s string) Option

+ type SecureWebhookToken struct

+ func New(issuer, event string, data any, opts ...Option) *SecureWebhookToken

+ func NewWithClaims(c Claims, opts ...Option) *SecureWebhookToken

+ func Parse(tokenStr string, key any) (*SecureWebhookToken, error)

+ func ParseWithClaims(tokenStr string, claims Claims, key any) (*SecureWebhookToken, error)

+ func (swt *SecureWebhookToken) Algorithm() string

+ func (swt *SecureWebhookToken) Claims() Claims

+ func (swt *SecureWebhookToken) ID() string

+ func (swt *SecureWebhookToken) Issuer() string

+ func (swt *SecureWebhookToken) SignedString(key any) (string, error)

+ func (swt *SecureWebhookToken) String() string

+ func (swt *SecureWebhookToken) Valid() bool

+ func (swt *SecureWebhookToken) Validate() error

+ func (swt *SecureWebhookToken) Webhook() Webhook

+ type Webhook struct

+ Data any

+ Event string

+ type WebhookClaims struct

+ Webhook Webhook

+ func NewWebhookClaims(issuer, event string, data any) WebhookClaims

+ func (wc *WebhookClaims) GetID() (string, error)

+ func (wc *WebhookClaims) GetWebhook() (Webhook, error)

+ func (wc *WebhookClaims) MapClaims() jwt.MapClaims

+ func (wc *WebhookClaims) Validate() error

+ type WebhookData struct

+ Hash string

+ HashAlg string

+ Size int64