express-cargo

express-cargo is a middleware library for Express.js that makes handling request data easier and more type-safe. It provides class-based decorators and binding features to simplify complex request parsing and validation.

---

Features

• Class-based request parsing: Automatically bind request data (body, query, params, etc.) using decorators
• Type safety: Fully compatible with TypeScript
• Easy middleware integration: Seamlessly works with existing Express middleware

---

Directory Structure

/
├── apps/
│   ├── docs/         # Documentation built with Docusaurus
│   └── example/      # Example app demonstrating express-cargo
└── packages/
    └── express-cargo/ # express-cargo library source code

---

Installation

npm install express-cargo

---

Quick Start

import express from 'express'
import { body, bindingCargo, getCargo } from 'express-cargo'

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

class BodyExample {
  @body() number1!: number
  @body() number2!: number
}

app.post('/sum', bindingCargo(BodyExample), (req, res) => {
  const data = getCargo<BodyExample>(req)
  res.json({ sum: data.number1 + data.number2 })
})

app.listen(3000)

---

Examples & Documentation

• apps/example: Contains various practical code examples
• apps/docs: Official documentation and API guide

---

Development & Build

pnpm install
pnpm build

---

Contributing

1. Fork this repository and create a new branch
2. Commit your changes and open a pull request
3. Follow the Prettier and ESLint rules for code style

---

License

MIT