games_app/backend/dist/middleware/auth.d.ts
2026-07-02 09:21:05 +02:00

27 lines
1.4 KiB
TypeScript

/**
* Express authentication middleware.
* Validates JWT bearer tokens and attaches the decoded payload to the request.
* Provides role-based access control via higher-order middleware factories.
*/
import { Request, Response, NextFunction } from 'express';
import { JwtPayload } from '../types';
/** Express request extended with the authenticated user's JWT payload. */
export interface AuthRequest extends Request {
user?: JwtPayload;
}
/**
* Verifies the Authorization bearer token and attaches the decoded user to the request.
*/
export declare function authMiddleware(req: AuthRequest, res: Response, next: NextFunction): Promise<void>;
/**
* Restricts access to users whose roles intersect the allowed list.
* `super_admin` satisfies routes that require `admin`.
*/
export declare function requireRoles(...roles: string[]): (req: AuthRequest, res: Response, next: NextFunction) => void;
/** Requires every listed permission on the JWT payload. */
export declare function requirePermissions(...perms: string[]): (req: AuthRequest, res: Response, next: NextFunction) => void;
/** Admin or super_admin. */
export declare function requireAdmin(): (req: AuthRequest, res: Response, next: NextFunction) => void;
/** Admin, moderator, or super_admin — support desk and similar staff tools. */
export declare function requireStaff(): (req: AuthRequest, res: Response, next: NextFunction) => void;
//# sourceMappingURL=auth.d.ts.map