<aside> 💡

프로젝트 데이터베이스와 연동되는 정보입니다.

• thumbnail은 단일 이미지로 업로드 해주세요
• screenshots들은 colGroup을 형성하도록 이미지 업로드 이후 드래그하여 배치해주세요
• 프로젝트가 ‘진행중인 프로젝트’에 속하는 경우 Period는 자동으로 startDate를 기준으로 삽입됩니다.
• Tech stack은 , 로 구분하여 입력해주세요 </aside>

Period

2025.06

Summary

Express에서 req.body/query/params를 직접 까지 않고, 데코레이터로 요청 데이터를 클래스에 바인딩·검증까지 해주는 TypeScript 미들웨어 express-cargo.

Description

express-cargo는 Express.js에서 반복적으로 발생하는 요청 데이터 파싱을 “클래스 + 데코레이터” 방식으로 선언적으로 정리해주는 미들웨어입니다. @Body, @Query, @Params, @Header 같은 데코레이터로 요청 값을 클래스 필드에 자동 바인딩하고, @Min 등 검증 데코레이터로 라우터 로직에 들어가기 전에 데이터 무결성을 확인해 라우트 핸들러를 더 깔끔하고 타입 세이프하게 유지할 수 있도록 설계되었습니다.

Goal

Express 라우트에서 흩어져 있는 요청 데이터 처리(바인딩/형 변환/검증) 보일러플레이트를 줄이고, TypeScript 데코레이터와 런타임 메타데이터를 활용해 선언적이고 확장 가능한 요청 파이프라인을 제공하는 것을 목표로 합니다.

Github

https://github.com/Beyond-Imagination/express-cargo

Demo

https://beyond-imagination.github.io/express-cargo/

Tech Stacks

TypeScript, Express.js

Thumbnail

Screenshots