cf-crud-service-api-builder

Build an HTTP API for a crud-service

Usage no npm install needed!

<script type="module">
  import cfCrudServiceApiBuilder from 'https://cdn.skypack.dev/cf-crud-service-api-builder';
</script>

README

cf-crud-service-api-builder

Build an HTTP API for a crud-service.

Installation

npm install --save cf-crud-service-api-builder

Usage

const crudServiceApiBuilder = require('cf-crud-service-api-builder')
const router = require('express')()
const logger = require('bunyan').createLogger()
const service = require('./service')
const middleware = require('./auth-check-middleware')

crudServiceApiBuilder(service, '/widgets', router, logger, middleware)

Hooks

When using the api builder, you can hook into certain actions to manipulate the request data before it is sent to the database or the response data before it is sent to the requester.


const api = crudServiceApiBuilder(service, '/article', router, logger, middleware)

api.hook('create:request', function (data, cb) {
  // do whatever you like with the data
  cb(null, data)
})

Supported hooks are:

  • create:request
  • create:response
  • read:response
  • update:request
  • update:response
  • partialUpdate:request
  • partialUpdate:response

Events

When using the api builder, you can listen for certain events so that you can add hooks to perform your own actions after a request has been succesful. e.g


const api = crudServiceApiBuilder(service, '/article', router, logger, middleware)

api.on('create', function (req, newArticle) {
  // do whatever you like with the req and article object
})

Supported events are:

  • create
  • update
  • partialUpdate
  • delete

Credits

Built by developers at Clock.

Licence

Licensed under the ISC