user

type Locale string

type Secret string

type Session struct {
	// ID uniquely identifies the session.
	ID int64
	// UserSecret is the secret of the user that the session belongs to.
	UserSecret Secret
	// UserAgent is the user agent that the session was created with.
	UserAgent string
	// CreatedAt is the time that the session was created.
	CreatedAt time.Time
	// LastUsed is the time that the session was last used.
	LastUsed time.Time
	// ExpiresAt is the time that the session will expire.
	// If zero, the session does not expire.
	ExpiresAt time.Time
}

type SessionToken string

type User struct {
	Name   string
	Locale Locale
}

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

type UserServiceConfig struct {
	fx.In

	UserStorage
	UserSessionStorage
}

type UserSessionStorage interface {
	// RegisterSession registers a session for a user. The token is generated by
	// [UserService]. The userAgent is optional.
	RegisterSession(ctx context.Context, token []byte, userSecret Secret, userAgent string) error
	// ValidateSession validates a session for a user. The user that the session
	// belongs to is returned.
	ValidateSession(ctx context.Context, token []byte) (Session, error)
	// ListSessions lists all sessions for a user.
	ListSessions(ctx context.Context, userSecret Secret) ([]Session, error)
	// DeleteSession deletes a session for a user.
	DeleteSession(ctx context.Context, userSecret Secret, sessionID int64) error
}

type UserStorage interface {
	// CreateUser creates a user in the storage with the given name.
	CreateUser(ctx context.Context, secret Secret, name string) (User, error)
	// User gets the user identified by the given secret.
	User(ctx context.Context, secret Secret) (User, error)
	// UpdateUserName updates the user's name.
	UpdateUserName(ctx context.Context, secret Secret, name string) error
	// UpdateUserLocale updates the user's locale.
	UpdateUserLocale(ctx context.Context, secret Secret, locale Locale) error
}

type UserWithSecret struct {
	User
	Secret Secret
}