Param-Validator

A Param Validator in Middleware for Sailsjs/Express.js

note: \
this project is under heavy developments.

Installing

Install node module

npm i param-validator

Add it as a middelware to your sails http.js .

 paramValidator: function (req, res, next) {
     let paramValidator = new ParamValidator(sails.config.ParamValidator
        , sails.log, sails.config.routes, sails.config.environment);
    paramValidator.validator(req, res, next);
},

Config :

Create a config file under Config folder with any name and put this content on it.

module.exports.ParamValidator = {
    projectBaseDIR: require('path').resolve(__dirname, '../'),
    validatorBaseRepo: 'api/ParamValidator/ValidatorBank',
    scriptBaseRepo: 'api/ParamValidator/ValidatorBank/script',
    excludePrefix: '^(\/upload\/center).*$',
}

• validatorBaseRepo :

  This config is required, and point to the path of your JSON defenition of param validation

• scriptBaseRepo :

  This cinfig is required, and point to the path of your script defenition of param validation

• excludePrefix :

  A regex that exclude any path from param validator

Param Validator

The JSON Object properties

• URL \

       The URL that should validate ( should be like route config )

• METHOD \

        The METHOD should be GET, PUT, DELETE or POST

• BODY or SCRIPT \

        The way of validations :D

  Validation config

• BODY : In this method, you can define a JSON file to validate your param automatically

  • Independed properties

    • type : number, date, string, array, object, email, phone, boolean`
      • Multi data type could assign to a param with separator |
    • required: define the param is required or not,default value is true
      • Depend properties
      • type number
        • min : minimum acceptable value
        • max : maximum acceptable value
      • type string
        • minLength : minimum acceptable lenght of string
        • maxLength : maximum acceptable lenght of string
        • length : acceptable lenght of string
      • type array
        • rows: in the rows we can define the param and flow the validation config as well.
      • type object
        • body: the properties of the JSON Object and can use all the validation config as well.

  • Addition operation

    • compareWithFiled : compare one pram with another ones
      • this param defined as an array, each rows of this arrasy should defined with a single string like operator:param_name
      • acceptable operators: all the valid logical compare operand in JS!
        • regex64 : validate a param with regex,this param should define in config file as an regex that encoded with base64

• SCRIPT: In this method you can write your own script to validate your param in your way

  • this param should contain the path of your validatior script file
  • the file should be under your scriptBaseRepo path
  • in valid param checking the script should return true value
  • on any invalidation just throw an Error
  • any Error message that you throwen will be send and formated in response
  • the script file should be like :

     module.exports.validator = function (params) {
          "use strict";
          return true;
    }

Some Validator Config

• Simple JSON Config

    {
  "URL": "/test/:param1/callcenter/:param2",
  "METHOD": "GET",
  "BODY": {
    "param1": {
      "type": "number"
    },
    "param2": {
      "type": "number",
      "min": 1,
      "max": 4,
      "required": false
    },
  }
  }

• Array Base JSON Config

  [
  {
    "URL": "/test1",
    "METHOD": "get",
    "BODY": {
     "date_from": {
      "type": "date",
      "required": false,
      "regex64": "aBase64String",
      "compareWithFiled": [
        "<:date_to"
      ]
    },
    "date_to": {
      "type": "date",
      "required": false,
      "regex64": "aBase64String",
      "compareWithFiled": [
        ">:date_from"
      ]
    }
    }
  },
  {
    "URL": "/test2",
    "METHOD": "get",
    "SCRIPT": "./script/testScript2.js"
  }
  ]

• single JSON Config

  {
    "URL": "/test3",
    "METHOD:"post",
    "BODY":{
     "details": {
      "type": "array",
      "required": false,
      "rows": {
        "type": "object",
        "body": {
          "detail_id": {
            "type": "number"
          },
          "language": {
            "type": "string",
            "required": false,
            "regex64": "aBase64String",
            "length": 5
          },
          "title": {
            "type": "string",
            "required": false,
            "maxLength": 1024
          },
          "channel": {
            "type": "string",
            "required": false
          }
        }
      }
    }
    }
  }

• A complext Config Desing
  ```
  {
  “group a”: [
  {

  "URL": "/test5/:id",
  "METHOD": "DELETE",
  "SCRIPT": "./script/something.js"

  },
  {

  "URL": "/test6",
  "METHOD": "POST",
  "SCRIPT": "./script/something2.js"

  }
  ],
  “group b”: [
  {

  "URL": "/test7",
  "METHOD": "PUT",
  "SCRIPT": "./script/something3.js"

  }
  ]
  }

```

Authors

• Amin Aghabeiki

License

This project is licensed under the MIT License - see the LICENSE file for details