api/sanitiser/_boundary_country.js

var check = require('check-types');
var iso3166 = require('iso3166-1');

function sanitize(raw, clean) {
  // error & warning messages
  var messages = { errors: [], warnings: [] };

  // target input param
  var country = raw['boundary.country'];

  // param 'boundary.country' is optional and should not
  // error when simply not set by the user
  if (check.assigned(country)){

    // must be valid string
    if (!check.unemptyString(country)) {
      messages.errors.push('boundary.country is not a string');
    }

    // must be a valid ISO 3166 code
    else if (!containsIsoCode(country.toUpperCase())) {
      messages.errors.push(country + ' is not a valid ISO2/ISO3 country code');
    }

    // valid ISO 3166 country code, set alpha3 code on 'clean.boundary.country'
    else {
      // the only way for boundary.country to be assigned is if input is
      //  a string and a known ISO2 or ISO3
      clean['boundary.country'] = iso3166.to3(country.toUpperCase());
    }
  }

  return messages;
}

function containsIsoCode(isoCode) {
  return iso3166.list().some(function(row) {
    return row.alpha2 === isoCode || row.alpha3 === isoCode;
  });
}

module.exports = sanitize;