@eluvio/elv-js-helpers/build/ModelFactory/defBoundedIntModel.js

A collection of Javascript helper functions used by several Eluvio libraries.

'use strict'
const IntegerModel = require('../Model/IntegerModel')

const assertBounded = require('../ModelAssertion/assertBounded')

/**
 * Returns an [ObjectModel](http://objectmodel.js.org/) which will validate that an input is:
 *
 *  * A [Javascript Number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)
 *  * An integer
 *  * Greater than a specified lower bound (if specified) or equal to the lower bound (if lower inclusivity is specified)
 *  * Less than a specified upper bound (if specified) or equal to the upper bound (if upper inclusivity is specified)
 *
 * Note that it is possible to specify no bounds at all, in which case the returned Model will only check that input is
 * an integer.
 *
 * @function
 * @category ModelFactory
 * @sig String -> (Number | null) -> (Number | null) -> (Boolean | null) ->  (Boolean | null) -> (* -> Integer | THROW)
 * @param {String} name - the name of the generated Model
 * @param {(Number | null)} lowerBound - The lower bound that must be satisfied. If `null`, no lower bound will be checked.
 * @param {(Number | null)} upperBound - The upper bound that must be satisfied. If `null`, no upper bound will be checked.
 * @param {(Boolean | null)} lowerInclusive - If `true` (and `lowerBound` is not `null`) then input is allowed to equal `lowerBound`.
 * @param {(Boolean | null)} upperInclusive - If `true` (and `upperBound` is not `null`) then input is allowed to equal `upperBound`.
 * @returns {Function} Returns an [ObjectModel](http://objectmodel.js.org/) that can be called with an input
 * @example
 *
 * 'use strict'
 * const defBoundedIntModel = require('@eluvio/elv-js-helpers/ModelFactory/defBoundedIntModel')
 *
 * const CartonEggCountModel = defBoundedIntModel('CartonEggCount', 0, 12, true, true)
 *
 * CartonEggCountModel(-1)     //=> EXCEPTION: 'Value must be >= 0 and <= 12 (got: -1)'
 *
 * CartonEggCountModel(0)      //=> 0
 *
 * CartonEggCountModel(4.2)    //=> EXCEPTION: 'Value must be an integer (got: 4.2)'
 *
 * CartonEggCountModel(6)      //=> 6
 *
 * CartonEggCountModel(42)     //=> EXCEPTION: 'Value must be >= 0 and <= 12 (got: 42)'
 *
 * CartonEggCountModel('foo')  //=> EXCEPTION: 'expecting Number, got String "foo"'
 *
 */
const defBoundedIntModel = (name, lowerBound, upperBound, lowerInclusive, upperInclusive) =>
  IntegerModel
    .extend()
    .assert(
      ...assertBounded(
        IntegerModel,
        lowerBound,
        upperBound,
        lowerInclusive,
        upperInclusive
      )
    )
    .as(name)

module.exports = defBoundedIntModel