Versions in this module Expand all Collapse all v0 v0.1.1 Nov 12, 2026 v0.1.0 Oct 14, 2026 Changes in this version + const ColApprovalHash + const ColApprovedAt + const ColBindingHash + const ColCreatedAt + const ColExpiresAt + const ColID + const ColIP + const ColIdentifier + const ColName + const ColScope + const ColStatus + const ColUserAgent + const CookieName + const DefaultMaxAttempts + const DefaultPage + const DefaultTTL + const EndpointApprove + const EndpointContext + const EndpointPoll + const EndpointStart + const EndpointVerifyOTP + const PluginName + const PurposeOTP + const PurposeSignIn + const TableAliasChallenge + const TableNameChallenge + var ChallengeApproval = sqlb.Col[[]byte](TableChallenge, ColApprovalHash) + var ChallengeApprovedAt = sqlb.Col[*time.Time](TableChallenge, ColApprovedAt) + var ChallengeBinding = sqlb.Col[[]byte](TableChallenge, ColBindingHash) + var ChallengeCreatedAt = sqlb.Col[time.Time](TableChallenge, ColCreatedAt) + var ChallengeExpiresAt = sqlb.Col[time.Time](TableChallenge, ColExpiresAt) + var ChallengeID = sqlb.Col[string](TableChallenge, ColID) + var ChallengeIP = sqlb.Col[string](TableChallenge, ColIP) + var ChallengeIdentifier = sqlb.Col[string](TableChallenge, ColIdentifier) + var ChallengeName = sqlb.Col[string](TableChallenge, ColName) + var ChallengeScope = sqlb.Col[string](TableChallenge, ColScope) + var ChallengeStatus = sqlb.Col[Status](TableChallenge, ColStatus) + var ChallengeUserAgent = sqlb.Col[string](TableChallenge, ColUserAgent) + var ErrBadAttempt = errors.New("emailchallenge: WithMaxAttempts needs a positive count") + var ErrBadKinds = errors.New(...) + var ErrBadMode = errors.New("emailchallenge: LinkMode must be CrossDevice or SameDevice") + var ErrBadTTL = errors.New("emailchallenge: WithTTL needs a positive duration") + var ErrInvalid = auth.NewError("emailchallenge.invalid", http.StatusBadRequest, ...) + var ErrNoBase = errors.New("emailchallenge: links need auth.WithBaseURL or emailchallenge.Links") + var ErrNoKinds = errors.New(...) + var ErrWrongBrowser = auth.NewError("emailchallenge.wrong_browser", http.StatusForbidden, ...) + var TableChallenge = sqlb.Table + func DefaultText(link, code, userAgent, ip string) string + type ContextResult struct + ExpiresAt *time.Time + IP string + Identifier string + State State + UserAgent string + type LinkMode string + const CrossDevice + const SameDevice + type Option func(*Plugin) + func Kinds(kinds ...auth.IdentifierKindName) Option + func Links(fn func(t auth.Token) string) Option + func SignUp() Option + func WithLinkMode(m LinkMode) Option + func WithMaxAttempts(n int) Option + func WithTTL(d time.Duration) Option + type Plugin struct + func New(opts ...Option) *Plugin + func (p *Plugin) Approve(ctx context.Context, token auth.Token) (Result, error) + func (p *Plugin) Context(ctx context.Context, token auth.Token) (ContextResult, error) + func (p *Plugin) Init(a *auth.Auth) error + func (p *Plugin) Name() string + func (p *Plugin) Operations() []auth.Operation + func (p *Plugin) OptionErr() error + func (p *Plugin) Poll(ctx context.Context, pollToken auth.Token) (Result, error) + func (p *Plugin) RateLimits() []auth.RateRule + func (p *Plugin) SignsIn() bool + func (p *Plugin) Start(ctx context.Context, identifier, name string) (Result, error) + func (p *Plugin) Sweep(ctx context.Context, cutoff time.Time) (int64, error) + func (p *Plugin) Tables() []sqlb.Table + func (p *Plugin) TypedMigrations(engine string, t auth.SQLTypes) ([]auth.Migration, error) + func (p *Plugin) Validate(c *auth.Config) error + func (p *Plugin) VerifyOTP(ctx context.Context, pollToken auth.Token, otp string) (Result, error) + type Result struct + Created bool + ExpiresAt *time.Time + PollToken auth.WireToken + SecondFactorRequired bool + State State + Token auth.Token + User *auth.UserView + type StartOrToken struct + Identifier string + Name string + OTP string + PollToken auth.WireToken + Token auth.WireToken + func (r StartOrToken) RateIdentifier() string + type State string + const StateApproved + const StateCompleted + const StateExpired + const StateInvalid + const StateNeedsConfirmation + const StatePending + const StateWrongBrowser + type Status string + const StatusApproved + const StatusPending + type TokenRequest struct + PollToken auth.WireToken + Token auth.WireToken