functional-express
Functional helpers for dealing with Express.js routes. Provides a cleaner API for dealing with extracting request values and completing responses.
Installation
Using npm:
$ npm install functional-express
Using yarn:
$ yarn add functional-express
Usage
Completers
Completers fulfill the response of a request.
async
The async
completer takes a function which returns a Promise
. The result of the Promise
's
success or failure determines the response. On success, the value of the promise is passed as the body of the response
with an HTTP 200. On failure, an HTTP 500 is sent to the response.
Signature
Complete
Example
;; Router .route'/' .post somePromise, , );
Extractors
params
The params
extractor extracts path parameter values and passes them to an inner function.
Signature
AsyncNestedFunc | NestedFunc | Complete
Example
;; Router .route'/:pathA/:pathB' .post params, ;
bodyRaw
The bodyRaw
extractor extracts the request body, unaltered, and passes it to an inner function.
Signature
AsyncNestedFunc | NestedFunc | Complete
Example
;; Router .route'/' .post bodyRaw, ;
body
The body
extractor extracts the request body and validates it against a
class-validator decorated class. If the class is validated,
it is passed to an inner function and can be used subsequently. If the class fails validation, an HTTP 500
is sent to the response with the validation failure output passed as the body.
Signature
AsyncNestedFunc | NestedFunc | Complete
Example
;;; Router .route'/' .post bodySomeClass,, ;
Questions?
Open an issue and I'll try to answer asap!
Contributions?
If you'd like to contribute, open a PR and I'll look over it asap. All contributions will be made available under the MIT license.