Skip to content

decodeblock/expressjs-api-utility

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

49 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ExpressJS API Utility

License Latest Version Tests Status Total Downloads Contributors

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-utility

Usage

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 /me endpoint responses that return login status and user details.

Testing

Run tests using:

npm test

Ensure 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.

About

An ExpressJs package providing helper functions for streamlined API development. Simplify response handling and enhance the structure of your APIs.

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

 
 
 

Contributors