express-cargo — Simplify Request Data Handling in Express

[laggu]

Hello everyone,
I’ve built a middleware for Express developers called express-cargo, designed to make request data handling effortless.

Instead of manually dealing with req.body, req.query, and req.params, you can define a class and use decorators to map incoming request data automatically. It’s written in TypeScript and works seamlessly with decorators.

Features

• Declarative handling of body, query, params, and headers
• Type-safe with full TypeScript support
• Reduces boilerplate in route handlers
• Built-in validation decorators for request data integrity

Installation

npm install express-cargo reflect-metadata

Example

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)

Link

• github : https://github.com/Beyond-Imagination/express-cargo
• npm : https://www.npmjs.com/package/express-cargo