TK-FB-Project/api.hyungi.net/config/middleware.js

/**
 * 미들웨어 설정
 *
 * Express 애플리케이션의 모든 미들웨어를 등록하는 중앙화된 설정 파일
 *
 * @author TK-FB-Project
 * @since 2025-12-11
 */

const express = require('express');
const cors = require('cors');
const helmet = require('helmet');
const compression = require('compression');
const path = require('path');
const helmetOptions = require('./security');
const corsOptions = require('./cors');
const { responseMiddleware } = require('../utils/responseFormatter');
const logger = require('../utils/logger');

/**
 * 모든 미들웨어를 Express 앱에 등록
 * @param {Express.Application} app - Express 애플리케이션 인스턴스
 */
function setupMiddlewares(app) {
  // 보안 헤더 설정 (Helmet)
  app.use(helmet(helmetOptions));

  // 성능 최적화 - Compression
  app.use(compression({
    filter: (req, res) => {
      if (req.headers['x-no-compression']) {
        return false;
      }
      return compression.filter(req, res);
    },
    level: 6, // 압축 레벨 (1-9, 6이 기본값)
    threshold: 1024 // 1KB 이상만 압축
  }));

  // 요청 바디 파싱 - 용량 제한 확장
  app.use(express.urlencoded({ extended: true, limit: '50mb' }));
  app.use(express.json({ limit: '50mb' }));

  // 응답 포맷터 미들웨어
  app.use(responseMiddleware);

  // CORS 설정
  app.use(cors(corsOptions));

  // 정적 파일 서빙
  app.use(express.static(path.join(__dirname, '../public')));
  app.use('/uploads', express.static(path.join(__dirname, '../uploads')));

  // Rate Limiting (필요시 활성화)
  // const rateLimit = require('express-rate-limit');
  // const limiter = rateLimit({
  //   windowMs: 15 * 60 * 1000, // 15분
  //   max: 100 // IP당 최대 100 요청
  // });
  // app.use('/api/', limiter);

  logger.info('미들웨어 설정 완료');
}

module.exports = setupMiddlewares;