legacy-libs/aproba/index.js

   1 'use strict'
   2
   3 function isArguments (thingy) {
   4   return thingy != null && typeof thingy === 'object' && thingy.hasOwnProperty('callee')
   5 }
   6
   7 var types = {
   8   '*': {label: 'any', check: function () { return true }},
   9   A: {label: 'array', check: function (thingy) { return Array.isArray(thingy) || isArguments(thingy) }},
  10   S: {label: 'string', check: function (thingy) { return typeof thingy === 'string' }},
  11   N: {label: 'number', check: function (thingy) { return typeof thingy === 'number' }},
  12   F: {label: 'function', check: function (thingy) { return typeof thingy === 'function' }},
  13   O: {label: 'object', check: function (thingy) { return typeof thingy === 'object' && thingy != null && !types.A.check(thingy) && !types.E.check(thingy) }},
  14   B: {label: 'boolean', check: function (thingy) { return typeof thingy === 'boolean' }},
  15   E: {label: 'error', check: function (thingy) { return thingy instanceof Error }},
  16   Z: {label: 'null', check: function (thingy) { return thingy == null }}
  17 }
  18
  19 function addSchema (schema, arity) {
  20   var group = arity[schema.length] = arity[schema.length] || []
  21   if (group.indexOf(schema) === -1) group.push(schema)
  22 }
  23
  24 var validate = module.exports = function (rawSchemas, args) {
  25   if (arguments.length !== 2) throw wrongNumberOfArgs(['SA'], arguments.length)
  26   if (!rawSchemas) throw missingRequiredArg(0, 'rawSchemas')
  27   if (!args) throw missingRequiredArg(1, 'args')
  28   if (!types.S.check(rawSchemas)) throw invalidType(0, ['string'], rawSchemas)
  29   if (!types.A.check(args)) throw invalidType(1, ['array'], args)
  30   var schemas = rawSchemas.split('|')
  31   var arity = {}
  32
  33   schemas.forEach(function (schema) {
  34     for (var ii = 0; ii < schema.length; ++ii) {
  35       var type = schema[ii]
  36       if (!types[type]) throw unknownType(ii, type)
  37     }
  38     if (/E.*E/.test(schema)) throw moreThanOneError(schema)
  39     addSchema(schema, arity)
  40     if (/E/.test(schema)) {
  41       addSchema(schema.replace(/E.*$/, 'E'), arity)
  42       addSchema(schema.replace(/E/, 'Z'), arity)
  43       if (schema.length === 1) addSchema('', arity)
  44     }
  45   })
  46   var matching = arity[args.length]
  47   if (!matching) {
  48     throw wrongNumberOfArgs(Object.keys(arity), args.length)
  49   }
  50   for (var ii = 0; ii < args.length; ++ii) {
  51     var newMatching = matching.filter(function (schema) {
  52       var type = schema[ii]
  53       var typeCheck = types[type].check
  54       return typeCheck(args[ii])
  55     })
  56     if (!newMatching.length) {
  57       var labels = matching.map(function (schema) {
  58         return types[schema[ii]].label
  59       }).filter(function (schema) { return schema != null })
  60       throw invalidType(ii, labels, args[ii])
  61     }
  62     matching = newMatching
  63   }
  64 }
  65
  66 function missingRequiredArg (num) {
  67   return newException('EMISSINGARG', 'Missing required argument #' + (num + 1))
  68 }
  69
  70 function unknownType (num, type) {
  71   return newException('EUNKNOWNTYPE', 'Unknown type ' + type + ' in argument #' + (num + 1))
  72 }
  73
  74 function invalidType (num, expectedTypes, value) {
  75   var valueType
  76   Object.keys(types).forEach(function (typeCode) {
  77     if (types[typeCode].check(value)) valueType = types[typeCode].label
  78   })
  79   return newException('EINVALIDTYPE', 'Argument #' + (num + 1) + ': Expected ' +
  80     englishList(expectedTypes) + ' but got ' + valueType)
  81 }
  82
  83 function englishList (list) {
  84   return list.join(', ').replace(/, ([^,]+)$/, ' or $1')
  85 }
  86
  87 function wrongNumberOfArgs (expected, got) {
  88   var english = englishList(expected)
  89   var args = expected.every(function (ex) { return ex.length === 1 })
  90     ? 'argument'
  91     : 'arguments'
  92   return newException('EWRONGARGCOUNT', 'Expected ' + english + ' ' + args + ' but got ' + got)
  93 }
  94
  95 function moreThanOneError (schema) {
  96   return newException('ETOOMANYERRORTYPES',
  97     'Only one error type per argument signature is allowed, more than one found in "' + schema + '"')
  98 }
  99
 100 function newException (code, msg) {
 101   var e = new Error(msg)
 102   e.code = code
 103   if (Error.captureStackTrace) Error.captureStackTrace(e, validate)
 104   return e
 105 }