An elegant Express middleware that provides a .response() helper to create consistent, standardized JSON responses across your API. Features include custom messages, TypeScript support, and zero dependencies.

In modern API development, consistency is key. Clients consuming your API expect a predictable response structure. This tiny helper enforces a standard JSON response format across all your endpoints, making your API more robust and easier to work with.

• ✅ Standardize Responses: Uniform structure (status, message, data, timestamp, path)
• 🚀 Lightweight & Fast: Zero dependencies, minimal overhead
• ✨ Easy to Use: Plug-and-play setup
• 🔒 Fully Typed: Built in TypeScript for safety and autocompletion

npm install server-response-helper

Import the default response middleware and register it with Express.

import express from 'express'; import response from 'server-response-helper'; const app = express(); app.use(response);

🏷️ Example A – custom message (string)

app.post('/api/login', (req, res) => { const user = { id: 1, name: 'Gautam' }; res.response(200, 'Login successful!', { user }); });

Result:

{ "status": 200, "message": "Login successful!", "data": { "user": { "id": 1, "name": "Gautam" } }, "timestamp": "2025-07-01T01:02:45.000Z", "path": "/api/login" }

🏷️ Example B – default message (number index)

app.get('/api/item/:id', (req, res) => { res.response(404); });

Assuming:

statusMessages[404] = ['Not found', 'Nothing here'];

Result:

{ "status": 404, "message": "Not found", "timestamp": "2025-07-01T01:02:45.000Z", "path": "/api/item/42" }

Express middleware that extends res with .response().

We welcome contributions! Here's how to get started:

git clone https://github.com/DevRGD/server-response-helper.git cd server-response-helper

npm ci

npm test

npm run lint npm run format

npm run build

Then push your feature branch and open a PR.

MIT © DevRGD. See the LICENSE file.