gosesh

Mar 16, 2025

Changes in this version

+ func WithAllowedHosts(hosts ...string) func(*Gosesh)

Mar 16, 2025

Changes in this version

+ func WithRedirectCookieName(name string) func(*Gosesh)

+ func WithRedirectParamName(name string) func(*Gosesh)

type Gosesh

+ func (gs *Gosesh) CallbackRedirect(defaultTarget string) http.HandlerFunc

+ func (gs *Gosesh) RedirectUnauthenticated(loginURL url.URL, isRedirectableOpt ...func(r *http.Request) bool) func(next http.Handler) http.Handler

Jul 13, 2024

Changes in this version

+ var ErrFailedDeletingSession = errors.New("failed deleting session(s)")

+ var ErrUnauthorized = errors.New("unauthorized")

+ func WithCookieDomain(domain string) func(*Gosesh)

type Gosesh

+ CookieDomain string

+ type HandlerDone func(http.ResponseWriter, *http.Request, error)

Jun 14, 2024

Changes in this version

type IDParser

+ ParseBytes func([]byte) (Identifier, error)

Jun 2, 2024

Changes in this version

+ type CallbackHandler func(http.ResponseWriter, *http.Request, error)

May 25, 2024

Changes in this version

+ const SessionContextKey

+ var ErrFailedCreatingSession = errors.New("failed creating session")

+ var ErrFailedExchangingToken = errors.New("failed exchanging token")

+ var ErrFailedGettingStateCookie = errors.New("failed getting state cookie")

+ var ErrFailedUnmarshallingData = errors.New("failed unmarshalling data")

+ var ErrFailedUpsertingUser = errors.New("failed upserting user")

+ var ErrInvalidStateCookie = errors.New("invalid state cookie")

+ func WithLogger(logger *slog.Logger) func(*Gosesh)

+ func WithNow(fn func() time.Time) func(*Gosesh)

+ func WithOAuth2StateCookieName(name string) func(*Gosesh)

+ func WithOrigin(origin *url.URL) func(*Gosesh)

+ func WithSessionActiveDuration(d time.Duration) func(*Gosesh)

+ func WithSessionCookieName(name string) func(*Gosesh)

+ func WithSessionIdleDuration(d time.Duration) func(*Gosesh)

+ type CreateSessionRequest struct

+ ExpireAt time.Time

+ IdleAt time.Time

+ UserID Identifier

+ type Gosesh struct

+ func New(parser IDParser, store Storer, opts ...NewOpts) *Gosesh

+ func (gs *Gosesh) Authenticate(next http.Handler) http.Handler

+ func (gs *Gosesh) AuthenticateAndRefresh(next http.Handler) http.Handler

+ func (gs *Gosesh) ExpireSessionCookie() *http.Cookie

+ func (gs *Gosesh) Host() string

+ func (gs *Gosesh) Logout(w http.ResponseWriter, r *http.Request) (*http.Request, error)

+ func (gs *Gosesh) LogoutHandler(completeHandler http.HandlerFunc) http.HandlerFunc

+ func (gs *Gosesh) OAuth2Begin(oauthCfg *oauth2.Config) http.HandlerFunc

+ func (gs *Gosesh) OAuth2Callback(w http.ResponseWriter, r *http.Request, user OAuth2User, config *oauth2.Config) error

+ func (gs *Gosesh) OauthStateCookie(value string, expires time.Time) http.Cookie

+ func (gs *Gosesh) RequireAuthentication(next http.Handler) http.Handler

+ func (gs *Gosesh) Scheme() string

+ func (gs *Gosesh) SessionCookie(identifier Identifier, expires time.Time) http.Cookie

+ type IDParser interface

+ Parse func([]byte) (Identifier, error)

+ type Identifier interface

+ type NewOpts func(*Gosesh)

+ type OAuth2Credentials struct

+ ClientID string

+ ClientSecret string

+ type OAuth2User interface

+ Request func(ctx context.Context, accessToken string) (*http.Response, error)

+ Unmarshal func(b []byte) error

+ type Session struct

+ ExpireAt time.Time

+ ID Identifier

+ IdleAt time.Time

+ UserID Identifier

+ func CurrentSession(r *http.Request) (*Session, bool)

+ type Storer interface

+ CreateSession func(ctx context.Context, req CreateSessionRequest) (*Session, error)

+ DeleteSession func(ctx context.Context, sessionID Identifier) error

+ DeleteUserSessions func(ctx context.Context, userID Identifier) (int, error)

+ GetSession func(ctx context.Context, sessionID Identifier) (*Session, error)

+ UpdateSession func(ctx context.Context, sessionID Identifier, req UpdateSessionValues) (*Session, error)

+ UpsertUser func(ctx context.Context, udr OAuth2User) (Identifier, error)

+ type UpdateSessionValues struct

+ ExpireAt time.Time

+ IdleAt time.Time