api-request-validator

This module is under construction

A library to validate API requests attributes

Install

$ npm install api-request-validator

Test

$ npm run test

Usage

Rules

| Rule | Description | Valid condition | |-----------------|-------------------------------|-----------------------------------| | required | value is required | value !== undefined | | enum | value must be quel to | enum.indexOf(value !== -1) | | type | type of value | typeof(value) === type | | regexp | regexp must be match value | regexp.exec(value) | | asyncMethods | custom async functions | () => true |

TO DO: Explain the difference between error and warning

const validationRules = {
  ['PAYLOAD_KEY']: {
    ['VALIDATION_RULE']: { 
      data: ...,
      error: { }
    },
    ['VALIDATION_RULE']: { 
      data: ...,
      warning: { }
    }
  }
}

Simple example: user registration payload validation

See the example here!

Scenarios of example

Constructor

api-request-validator export a class constructor. The best way to build the validator is to extend the Validator class and set RULES as first argument of super() in constructor(). This approach allows to pass methods to the validator, like this:

import Validator from 'api-request-validator'
  
class UserRegistrationValidator extends Validator {
  constructor(payload) {
    super(RULES, payload, {})
  }
  
  async beforeValidate() {
  
  }
  
  async afterValidate() {
  
  }
  
  async findExisting(email) {
    const existing = await User.findOne({ email ))
    return !existing
  }
  
  async isBlacklisted(email) {
    ...
  }
}

Or for simple case

const validator = new Validator(RULES, payload)

Example with express

app.post('/login, async (req, res, next) => {
  const validator = new LoginValidator(req.body)
  await validator.run()
  if (!validator.valid)
    return next(validator.error)
  if (validator.warnings)
    res.header('api-warnings', validator.warnings)
  
  ...
})

To do

• write correct documentation
• improve :)