59 lines
3.2 KiB
TypeScript
59 lines
3.2 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>;
|
|
/**
|
|
* 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>;
|
|
/**
|
|
* 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
|