magiclink

type Config[CustomCreateArgs, CustomReadResponse, CustomKeyMeta any] struct {
	ErrorHandler     ErrorHandler
	JWKS             JWKSArgs[CustomKeyMeta]
	CustomRedirector Redirector[CustomCreateArgs, CustomReadResponse, CustomKeyMeta]
	ServiceURL       *url.URL
	SecretQueryKey   string
	Store            Storage[CustomCreateArgs, CustomReadResponse, CustomKeyMeta]
}

type CreateArgs[CustomCreateArgs any] struct {
	// Custom is additional data or metadata for your use case.
	Custom CustomCreateArgs

	// JWTClaims is a data structure that can marshal to JSON as the JWT Claims. Make sure to embed AND populate
	// jwt.RegisteredClaims if your use case supports standard claims. If you shadow the .Valid() method of the
	// interface, be sure to call .RegisteredClaims.Valid() in your implementation. If you are using a non-memory
	// Storage implementation, be sure the data structure is the proper Go type after being read. Use of this field is
	// OPTIONAL and RECOMMENDED for most use cases.
	JWTClaims jwt.Claims

	// JWTKeyID is the key ID of the key used to sign the JWT. If this is empty, the first key in the JWK Set will be
	// used. If no key with the key ID is present when the magic link is visited, the service will produce a HTTP 500
	// error. Use of this field is OPTIONAL.
	JWTKeyID *string

	// JWTSigningMethod is a string that can be passed to jwt.GetSigningMethod to get the appropriate jwt.SigningMethod
	// to sign the JWT with. Do not populate this field unless you know what you are doing. By default, the most secure
	// method will be used. If a key type other than ECDSA, EdDSA, or RSA is used, then the most secure HMAC signing
	// method will be chosen by default. Use of this field is OPTIONAL and NOT RECOMMENDED for most use cases.
	JWTSigningMethod string

	// RedirectQueryKey is the URL query key used in the redirect. It will contain the JWT. If this is empty, "jwt" will
	// be used. Use of this field is OPTIONAL.
	RedirectQueryKey string

	// RedirectURL is the URL to redirect to after the JWT is verified. Use of this field is REQUIRED for all use cases.
	RedirectURL *url.URL
}

type CreateResponse struct {
	MagicLink *url.URL
	Secret    string
}

type ErrorHandler interface {
	// Handle consumes an error and writes a response to the given writer. The set of possible errors to check by
	// unwrapping with errors.Is is documented above the interface's source code.
	Handle(args ErrorHandlerArgs)
}

type ErrorHandlerArgs struct {
	Err                   error
	Request               *http.Request
	SuggestedResponseCode int
	Writer                http.ResponseWriter
}

type ErrorHandlerFunc func(args ErrorHandlerArgs)

type JWKSArgs[CustomKeyMeta any] struct {
	CacheRefresh time.Duration
	Store        jwkset.Storage[CustomKeyMeta]
}

type MagicLink[CustomCreateArgs, CustomReadResponse, CustomKeyMeta any] struct {
	Store Storage[CustomCreateArgs, CustomReadResponse, CustomKeyMeta]
	// contains filtered or unexported fields
}

type ReCAPTCHAV3Config struct {
	APKPackageName []string                `json:"apkPackageName"`
	Action         []string                `json:"action"`
	Hostname       []string                `json:"hostname"`
	MinScore       float64                 `json:"minScore"`
	SecretKey      string                  `json:"secretKey"`
	TemplateData   ReCAPTCHAV3TemplateData `json:"templateData"`

	Verifier recaptcha.VerifierV3 `json:"-"`
}

type ReCAPTCHAV3Redirector[CustomCreateArgs, CustomReadResponse, CustomKeyMeta any] struct {
	// contains filtered or unexported fields
}

type ReCAPTCHAV3TemplateData struct {
	ButtonBypass bool          `json:"buttonBypass"`
	ButtonText   string        `json:"buttonText"`
	CSS          template.CSS  `json:"css"`
	Code         string        `json:"code"`
	HTMLTitle    string        `json:"htmlTitle"`
	Instruction  string        `json:"instruction"`
	SiteKey      template.HTML `json:"siteKey"`
	Title        string        `json:"title"`

	FormAction string `json:"-"`
}

type ReadResponse[CustomCreateArgs, CustomReadResponse any] struct {
	// Custom is additional data or metadata for your use case.
	Custom CustomReadResponse
	// CreateArgs are the parameters used to create the magic link.
	CreateArgs CreateArgs[CustomCreateArgs]
}

type Redirector[CustomCreateArgs, CustomReadResponse, CustomKeyMeta any] interface {
	Redirect(args RedirectorArgs[CustomCreateArgs, CustomReadResponse, CustomKeyMeta])
}

type RedirectorArgs[CustomCreateArgs, CustomReadResponse, CustomKeyMeta any] struct {
	ReadAndExpireLink func(ctx context.Context, secret string) (jwtB64 string, response ReadResponse[CustomCreateArgs, CustomReadResponse], err error)
	Request           *http.Request
	Secret            string
	Writer            http.ResponseWriter
}

type Storage[CustomCreateArgs, CustomReadResponse, CustomKeyMeta any] interface {
	// CreateLink creates a secret for the given parameters and stores the pair. The secret is returned to the caller.
	CreateLink(ctx context.Context, args CreateArgs[CustomCreateArgs]) (secret string, err error)
	// ReadLink finds the creation parameters for the given secret. ErrLinkNotFound is returned if the secret is not
	// found or was deleted/expired. This will automatically expire the link.
	ReadLink(ctx context.Context, secret string) (ReadResponse[CustomCreateArgs, CustomReadResponse], error)
}