1.1.1 • Published 1 year ago
@decodeblock/expressjs-api-utility v1.1.1
ExpressJS API Utility
A utility library for ExpressJS applications that provides helper functions to streamline API response handling. Simplify JSON response formatting and enhance your API development process.
Installation
Install the package via npm:
npm install @decodeblock/expressjs-api-utilityUsage
Example
Using the ResponseStatus and ApiResponder class for handling JSON responses in an ExpressJS application:
const express = require('express');
const { ApiResponder, ResponseStatus } = require('@decodeblock/expressjs-api-utility');
const app = express();
app.get('/success', (req, res) => {
ApiResponder.successResponse(res, 'Request was successful', ResponseStatus.HTTP_OK, { data: 'Your data here' });
});
app.get('/failure', (req, res) => {
ApiResponder.failureResponse(res, 'Request failed', ResponseStatus.HTTP_NOT_FOUND, { error: 'Bad Request' });
});
app.listen(3000, () => {
console.log('Server is running on port 3000');
});The ApiResponder class provides the following methods:
successResponse(res, message, code, data, metadata = null): For successful responses.failureResponse(res, message, code, data, metadata = null): For error responses.meEndpointResponse(res, user): For/meendpoint responses that return login status and user details.
Testing
Run tests using:
npm testEnsure that you have your test framework (e.g., Jest) set up to test the API utility functions.
Changelog
Detailed changes for each release are documented in the CHANGELOG.
Contributing
We welcome contributions! Please see the CONTRIBUTING guide for details.
Credits
License
This package is licensed under the MIT License.