Service Reference

The service.Auth struct contains the core business logic for authentication. It is independent of the HTTP layer.

type Auth struct {
    Cfg    *config.Config
    Repo   *repository.Repository
    Mailer Mailer
    // ...
}

Constructor

Creates a new Auth service.

func New(cfg *config.Config, repo *repository.Repository, pathPrefix string) *Auth

Creates a new Auth service and initializes the repository connection based on the config.

func NewFromConfig(cfg *config.Config, pathPrefix string) (*Auth, error)

Creates a new user. It hashes the password, validates the password length (min 8 chars), and stores the user in the repository.

func (a *Auth) UserCreate(ctx context.Context, req *RequestBasicAuth) (*models.User, error)

Authenticates a user by email and password.

func (a Auth) UserAuthenticate(ctx context.Context, req RequestBasicAuth) (*models.User, error)

Updates a user's password. Enforces password validation rules.

func (a Auth) UserUpdatePassword(ctx context.Context, user *models.User, password string) (*models.User, error)

Updates user profile information.

func (a Auth) UserUpdate(ctx context.Context, user *models.User) (*models.User, error)

Deletes a user by their ID.

func (a Auth) UserDelete(ctx context.Context, id string) error

Generates a new pair of Access Token (JWT) and Refresh Token (Opaque) for a user.

func (a *Auth) TokenCreate(ctx context.Context, user *models.User) (*TokenResponse, error)

Validates a refresh token and issues a new pair of tokens.

func (a *Auth) TokenRefresh(ctx context.Context, refreshToken string) (*TokenResponse, error)

Revokes a refresh token immediately.

func (a *Auth) TokenRevoke(ctx context.Context, refreshToken string) error

Generates a reset token and sends it via email.

func (a *Auth) PasswordResetRequest(ctx context.Context, req RequestPasswordReset) error

Verifies the reset token and updates the user's password.

func (a *Auth) PasswordResetConfirm(ctx context.Context, req RequestPasswordResetConfirm) error

Generates a magic link token and sends it via email.

func (a *Auth) PasswordlessRequest(ctx context.Context, req service.RequestPasswordless) error

Verifies the magic link token and issues authentication tokens.

func (a *Auth) PasswordlessLogin(ctx context.Context, token string) (*TokenResponse, error)