session

Documentation

Index

• Constants
• func NewExpiresAt(ctx context.Context) *expiresAt
• func NewSessionStatus(num int) *status
• func SetSession(ctx context.Context, claim *Claim) context.Context
• type Claim
  • func GetSession(ctx context.Context) *Claim
  • func NewClaim(ctx context.Context, user user.User, sessionID shared.UUID[Session]) Claim
  • func NewClaimFromMap(claims jwt.MapClaims) Claim
  • func (c *Claim) Audience() string
  • func (c *Claim) ExpiresAt() time.Time
  • func (c *Claim) GenMapClaim() *jwt.MapClaims
  • func (c *Claim) IsExpired(ctx context.Context) bool
  • func (c *Claim) IssueAt() time.Time
  • func (c *Claim) Issuer() string
  • func (c *Claim) SessionID() (shared.UUID[Session], error)
  • func (c *Claim) UserID() (shared.UUID[user.User], error)
• type Session
  • func NewSession(sessionID shared.UUID[Session], userID shared.UUID[user.User], ...) *Session
  • func SortByLastActivity(sessions []Session) []Session
  • func (s *Session) Deactivate(ctx context.Context)
  • func (s *Session) ExpiresAt() time.Time
  • func (s *Session) IsActive(ctx context.Context) bool
  • func (s *Session) LastActivityAt() time.Time
  • func (s *Session) Provider() auth.AuthProviderName
  • func (s *Session) SessionID() shared.UUID[Session]
  • func (s *Session) Status() status
  • func (s *Session) UpdateLastActivity(ctx context.Context)
  • func (s *Session) UserID() shared.UUID[user.User]
• type SessionRepository
• type SessionService
• type TokenManager

Constants

const (
	SESSION_ACTIVE status = iota
	SESSION_INACTIVE
)

const (
	Issuer   = "https://api.kotohiro.com"
	Audience = "https://api.kotohiro.com"
)

Functions

func NewExpiresAt

func NewExpiresAt(ctx context.Context) *expiresAt

func NewSessionStatus

func NewSessionStatus(num int) *status

func SetSession

func SetSession(ctx context.Context, claim *Claim) context.Context

Types

type Claim

type Claim struct {
	Sub         string  `json:"sub"` // subject (user)
	Iat         int64   `json:"iat"` // issued at (seconds)
	Exp         int64   `json:"exp"` // expiration time (seconds)
	Jti         string  `json:"jti"` // JWT ID（SessionID）
	IconURL     *string `json:"iconURL,omitempty"`
	DisplayName *string `json:"displayName,omitempty"`
	DisplayID   *string `json:"displayId,omitempty"`
	IsVerify    bool    `json:"isVerify"`
}

func GetSession

func GetSession(ctx context.Context) *Claim

func NewClaim

func NewClaim(ctx context.Context, user user.User, sessionID shared.UUID[Session]) Claim

func NewClaimFromMap

func NewClaimFromMap(claims jwt.MapClaims) Claim

func (*Claim) Audience

func (c *Claim) Audience() string

func (*Claim) ExpiresAt

func (c *Claim) ExpiresAt() time.Time

func (*Claim) GenMapClaim

func (c *Claim) GenMapClaim() *jwt.MapClaims

func (*Claim) IsExpired

func (c *Claim) IsExpired(ctx context.Context) bool

func (*Claim) IssueAt

func (c *Claim) IssueAt() time.Time

func (*Claim) Issuer

func (c *Claim) Issuer() string

func (*Claim) SessionID

func (c *Claim) SessionID() (shared.UUID[Session], error)

func (*Claim) UserID

func (c *Claim) UserID() (shared.UUID[user.User], error)

type Session

type Session struct {
	// contains filtered or unexported fields
}

func NewSession

func NewSession(
	sessionID shared.UUID[Session],
	userID shared.UUID[user.User],
	authProvider auth.AuthProviderName,
	status status,
	expires time.Time,
	lastActivity time.Time,
) *Session

func SortByLastActivity

func SortByLastActivity(sessions []Session) []Session

func (*Session) Deactivate

func (s *Session) Deactivate(ctx context.Context)

func (*Session) ExpiresAt

func (s *Session) ExpiresAt() time.Time

func (*Session) IsActive

func (s *Session) IsActive(ctx context.Context) bool

func (*Session) LastActivityAt

func (s *Session) LastActivityAt() time.Time

func (*Session) Provider

func (s *Session) Provider() auth.AuthProviderName

func (*Session) SessionID

func (s *Session) SessionID() shared.UUID[Session]

func (*Session) Status

func (s *Session) Status() status

func (*Session) UpdateLastActivity

func (s *Session) UpdateLastActivity(ctx context.Context)

func (*Session) UserID

func (s *Session) UserID() shared.UUID[user.User]

type SessionRepository

type SessionRepository interface {
	Create(context.Context, Session) (*Session, error)
	Update(context.Context, Session) (*Session, error)
	FindBySessionID(context.Context, shared.UUID[Session]) (*Session, error)
	FindByUserID(context.Context, shared.UUID[user.User]) ([]Session, error)
}

type SessionService

type SessionService interface {
	RefreshSession(context.Context, shared.UUID[user.User]) (*Session, error)
	DeactivateUserSessions(context.Context, shared.UUID[user.User]) error
}

type TokenManager

type TokenManager interface {
	Generate(ctx context.Context, user user.User, sessionID shared.UUID[Session]) (string, error)
	Parse(ctx context.Context, token string) (*Claim, error)
	SetSession(ctx context.Context) context.Context
}