games_app/backend/dist/controllers/authController.d.ts
2026-07-07 15:03:17 +02:00

73 lines
3.8 KiB
TypeScript

/**
* Auth controller — HTTP handlers for registration, login, token refresh, 2FA, and password changes.
*/
import { Request, Response } from 'express';
import { AuthRequest } from '../middleware/auth';
/**
* Registers a new user with email and password.
* @param req - Request body: `email`, `password`.
* @param res - 201 with `{ message, userId }` on success, 400 on validation or registration failure.
*/
export declare function register(req: Request, res: Response): Promise<void>;
export declare function validateReferralCode(req: Request, res: Response): Promise<void>;
/**
* Public captcha configuration for the login form (Turnstile).
*/
export declare function getCaptchaConfig(_req: Request, res: Response): Promise<void>;
/**
* Authenticates a user with email and password, optionally requiring a TOTP code when 2FA is enabled.
* @param req - Request body: `email`, `password`, optional `totpCode`. IP and user-agent are forwarded for audit.
* @param res - JSON with access/refresh tokens on success, 401 on invalid credentials.
*/
export declare function login(req: Request, res: Response): Promise<void>;
/**
* Issues a new access/refresh token pair using a valid refresh token.
* @param req - Request body: `refreshToken`.
* @param res - JSON with new tokens on success, 401 if the refresh token is invalid or expired.
*/
export declare function refresh(req: Request, res: Response): Promise<void>;
/**
* Starts TOTP 2FA setup for the authenticated user and returns the secret and QR code data.
* @param req - Authenticated request; user ID is taken from the JWT.
* @param res - JSON with TOTP setup details on success, 400 on failure.
*/
export declare function setup2FA(req: AuthRequest, res: Response): Promise<void>;
/**
* Confirms and enables TOTP 2FA for the authenticated user using a verification code.
* @param req - Authenticated request. Body: `code` (TOTP verification code).
* @param res - JSON `{ message: '2FA enabled' }` on success, 400 if the code is missing or invalid.
*/
export declare function enable2FA(req: AuthRequest, res: Response): Promise<void>;
/**
* Revokes the refresh token in the request body (logout).
*/
export declare function logout(req: Request, res: Response): Promise<void>;
/**
* Revokes all refresh tokens for the authenticated user.
*/
export declare function logoutAll(req: AuthRequest, res: Response): Promise<void>;
export declare function disable2FA(req: AuthRequest, res: Response): Promise<void>;
export declare function regenerateRecoveryCodes(req: AuthRequest, res: Response): Promise<void>;
/**
* Changes the authenticated user's password after verifying the current password.
* @param req - Authenticated request. Body: `currentPassword`, `newPassword`.
* @param res - JSON `{ message: 'Password updated' }` on success, 400 on validation or auth failure.
*/
export declare function changePassword(req: AuthRequest, res: Response): Promise<void>;
/**
* Sends a verification email to the authenticated user's address on file.
* @param req - Authenticated request
* @param res - JSON with success message; includes devVerifyUrl in non-production console mode
*/
export declare function sendVerificationEmail(req: AuthRequest, res: Response): Promise<void>;
/**
* Confirms email ownership using a single-use token from the verification link.
* @param req - Body or query: `token`
* @param res - JSON success message on valid token
*/
export declare function verifyEmail(req: Request, res: Response): Promise<void>;
export declare function resendVerificationEmail(req: Request, res: Response): Promise<void>;
export declare function forgotPassword(req: Request, res: Response): Promise<void>;
export declare function resetPassword(req: Request, res: Response): Promise<void>;
export declare function validateResetToken(req: Request, res: Response): Promise<void>;
//# sourceMappingURL=authController.d.ts.map