nestjs-mvc-tools/dist/lib/nest-mvc-exceptions.js

NestJS MVC Tools is a small set of tools designed to help you get started more easily with traditional web development approaches in NestJS.

"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.NestMvcBaseExceptionHandler = void 0;
/**
 * Base abstract class for NestJS MVC exception handling.
 * Provides common exception handling logic for MVC applications.
 * Use this class as a base when implementing custom ExceptionFilters.
 */
class NestMvcBaseExceptionHandler {
    /**
     * Executes common exception handling logic.
     * Call this method from child classes when needed.
     * @param exception - The exception to handle
     * @param req - Extended request object with MVC functionality
     * @param res - Express response object
     * @param logger - Optional logger for error output
     */
    async handleMvcException(exception, req, res, logger) {
        // HttpException 체크 (getStatus 메서드 존재 여부로 판별)
        // 
        // instanceof HttpException 체크가 자꾸 실패함,, Claude 왈 다음과 같음
        // 1. 라이브러리와 사용자 애플리케이션 간의 @nestjs/common 버전 차이
        // 2. npm/yarn의 중복 패키지 설치로 인한 서로 다른 HttpException 클래스 참조
        // 3. TypeScript 컴파일 시점과 런타임 시점의 타입 정보 불일치
        // 4. 패키지 호이스팅 문제로 인한 다른 모듈 경로의 HttpException 사용
        //
        // 일단 버전차이는 아닌데, 정상적인 코드가 자꾸 실행이 안되니 화가나서 다음과 같은 코드를 사용합니다.
        logger?.warn(`Exception occurred: ${exception.message || exception}`);
        if (typeof exception.getStatus === 'function') {
            const statusCode = exception.getStatus();
            // BadRequest(400)는 유효성 에러로 플래시 처리
            if (statusCode === 400) {
                return this.handleValidationError(exception, req, res, logger);
            }
            // 기타 HttpException은 해당 상태 코드로 에러 페이지 렌더링
            return this.renderErrorPage(exception.message, statusCode, req, res, logger);
        }
        // 알 수 없는 예외는 500으로 처리
        return this.renderErrorPage('Internal Server Error', 500, req, res, logger);
    }
    handleValidationError(exception, req, res, logger) {
        logger?.warn(`Validation error: ${exception.message}`);
        // 세션이 활성화된 경우에만 플래시 메시지 설정
        if (req?.session) {
            req.flash.error(exception.message).flashInput();
        }
        // 리다이렉트 URL 결정 (우선순위: _redirect_to > referer > 홈)
        const redirectUrl = req.body?._redirect_to || req.headers.referer || "/";
        return res.redirect(303, redirectUrl);
    }
    async renderErrorPage(errMsg, statusCode, req, res, logger) {
        logger?.warn(`Rendering error page: ${errMsg} (${statusCode})`);
        try {
            const html = await req.view.render("pages/errors/index", {
                error: errMsg,
                status: statusCode,
            });
            return res.status(statusCode).send(html);
        }
        catch (renderError) {
            // 에러 페이지 렌더링 실패 시 기본 텍스트 응답
            logger?.error(`Failed to render error page: ${renderError}`);
            return res.status(statusCode).send(`Error ${statusCode}: ${errMsg}`);
        }
    }
}
exports.NestMvcBaseExceptionHandler = NestMvcBaseExceptionHandler;