Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

auth

package

Go to main page

Versions in this module

v0

v0.0.4

Jan 19, 2026

v0.0.3

Jan 18, 2026

Changes in this version

type Service

+ func (s *Service) AssignRole(ctx context.Context, userID, roleName string) error

+ func (s *Service) AssignRoleByID(ctx context.Context, userID, roleID string) error

+ func (s *Service) GetUserRoles(ctx context.Context, userID string) ([]*models.Role, error)

+ func (s *Service) HasAllPermissions(ctx context.Context, userID string, permissionNames []string) (bool, error)

+ func (s *Service) HasAllRoles(ctx context.Context, userID string, roleNames []string) (bool, error)

+ func (s *Service) HasAnyPermission(ctx context.Context, userID string, permissionNames []string) (bool, error)

+ func (s *Service) HasAnyRole(ctx context.Context, userID string, roleNames []string) (bool, error)

+ func (s *Service) RemoveRole(ctx context.Context, userID, roleName string) error

+ func (s *Service) RemoveRoleByID(ctx context.Context, userID, roleID string) error

v0.0.2

Nov 29, 2025

v0.0.1

Nov 27, 2025

Changes in this version

+ var ErrEmailAlreadyExists = errors.New("email already exists")

+ var ErrInvalidCredentials = errors.New("invalid credentials")

+ var ErrInvalidRefreshToken = errors.New("invalid refresh token")

+ var ErrPermissionDenied = errors.New("permission denied")

+ var ErrUserInactive = errors.New("user account is inactive")

+ var ErrUserNotFound = errors.New("user not found")

+ type AuthResponse struct

+ AccessToken string

+ ExpiresAt time.Time

+ RefreshToken string

+ User *models.User

+ type ChangePasswordRequest struct

+ NewPassword string

+ OldPassword string

+ type GoogleOAuthCallbackRequest struct

+ Code string

+ State string

+ func ParseGoogleOAuthCallback(callbackURL string) (*GoogleOAuthCallbackRequest, error)

+ func ParseGoogleOAuthCallbackFromForm(form url.Values) (*GoogleOAuthCallbackRequest, error)

+ type GoogleOAuthURLRequest struct

+ State string

+ type LoginRequest struct

+ Email string

+ Password string

+ type RefreshTokenRequest struct

+ RefreshToken string

+ type RegisterRequest struct

+ Email string

+ FirstName string

+ LastName string

+ Password string

+ type RequestPasswordResetRequest struct

+ Email string

+ type ResetPasswordRequest struct

+ NewPassword string

+ Token string

+ type Service struct

+ func NewService(cfg *config.Config, store store.Store) (*Service, error)

+ func (s *Service) ChangePassword(ctx context.Context, userID string, req ChangePasswordRequest) error

+ func (s *Service) GetGoogleOAuthAccounts(ctx context.Context, userID string) ([]*models.OAuthAccount, error)

+ func (s *Service) GetGoogleOAuthURL(req GoogleOAuthURLRequest) (string, error)

+ func (s *Service) GetUserByID(ctx context.Context, userID string) (*models.User, error)

+ func (s *Service) GetUserPermissions(ctx context.Context, userID string) ([]*models.Permission, error)

+ func (s *Service) HandleGoogleOAuthCallback(ctx context.Context, req GoogleOAuthCallbackRequest) (*AuthResponse, error)

+ func (s *Service) HasPermission(ctx context.Context, userID, permissionName string) (bool, error)

+ func (s *Service) HasRole(ctx context.Context, userID, roleName string) (bool, error)

+ func (s *Service) Login(ctx context.Context, req LoginRequest) (*AuthResponse, error)

+ func (s *Service) Logout(ctx context.Context, userID string) error

+ func (s *Service) RefreshAccessToken(ctx context.Context, refreshTokenString string) (*AuthResponse, error)

+ func (s *Service) Register(ctx context.Context, req RegisterRequest) (*AuthResponse, error)

+ func (s *Service) RequestPasswordReset(ctx context.Context, email string) (string, error)

+ func (s *Service) ResendVerificationEmail(ctx context.Context, userID string) (string, error)

+ func (s *Service) ResetPassword(ctx context.Context, req ResetPasswordRequest) error

+ func (s *Service) UnlinkGoogleOAuth(ctx context.Context, userID string, accountID string) error

+ func (s *Service) ValidateToken(tokenString string) (*tokens.Claims, error)

+ func (s *Service) VerifyEmail(ctx context.Context, token string) error

+ type VerifyEmailRequest struct

+ Token string