express-cargo

express-cargo는 Express.js에서 request 데이터를 더욱 쉽고 타입 안전하게 관리할 수 있도록 도와주는 미들웨어 라이브러리입니다.
클래스 기반의 데코레이터와 바인딩 기능을 제공하여, 복잡한 request 파싱과 검증을 간결하게 처리할 수 있습니다.

설치

npm install express-cargo reflect-metadata

TypeScript 설정

express-cargo는 TypeScript 데코레이터와 런타임 타입 메타데이터를 사용합니다. 정상적으로 동작시키기 위해서는 TypeScript를 설치하고 몇 가지 컴파일 옵션을 활성화해야 합니다.

1. TypeScript 설치 (아직 설치하지 않았다면)

npm install -D typescript

2. 데코레이터 지원 활성화

tsconfig.json에 다음을 추가하세요:

{
    "compilerOptions": {
        "experimentalDecorators": true,
        "emitDecoratorMetadata": true
    }
}

빠른 시작

import express from 'express'
import { Body, bindingCargo, getCargo, Min, Header, Params } from 'express-cargo'

const app = express()
app.use(express.json())

class RequestExample {
    @Body()
    name!: string

    @Body()
    @Min(0)
    age!: number

    @Params('id')
    id!: number

    @Header()
    authorization!: string
}

app.post('/:id', bindingCargo(RequestExample), (req, res) => {
    const data = getCargo<RequestExample>(req)
    // write your code with bound data
})

app.listen(3000)

문서

전체 가이드와 API 레퍼런스:
👉 express-cargo 문서

주요 특징

• 클래스 기반 request 파싱: 데코레이터로 body, query, param 등 request 데이터를 자동으로 바인딩
• 타입 안전성: TypeScript와 완벽하게 호환
• 간편한 미들웨어 적용: 기존 Express 미들웨어와 쉽게 통합

요청 바인딩 데코레이터

검증 데코레이터

Transform 데코레이터