ibantools 4.1.4 → 4.1.5

package/build/ibantools.js

@@ -8,7 +8,7 @@
  * @package Documentation
  * @author Saša Jovanić
  * @module ibantools
- * @version 4.1.4
+ * @version 4.1.5
  * @license MPL-2.0
  * @preferred
  */
@@ -27,21 +27,16 @@ exports.countrySpecs = exports.extractBIC = exports.validateBIC = exports.Valida
  * ```
  */
 function isValidIBAN(iban) {
-    if (iban !== undefined && iban !== null) {
-        var reg = new RegExp('^[0-9]{2}$', '');
-        var spec = exports.countrySpecs[iban.slice(0, 2)];
-        if (spec !== undefined &&
-            spec.bban_regexp &&
-            spec.bban_regexp !== null &&
-            spec.chars &&
-            spec.chars === iban.length &&
-            reg.test(iban.slice(2, 4)) &&
-            isValidBBAN(iban.slice(4), iban.slice(0, 2)) &&
-            isValidIBANChecksum(iban)) {
-            return true;
-        }
-    }
-    return false;
+    if (iban === undefined || iban === null)
+        return false;
+    var reg = new RegExp('^[0-9]{2}$', '');
+    var spec = exports.countrySpecs[iban.slice(0, 2)];
+    if (spec === undefined || spec.bban_regexp === undefined || spec.bban_regexp === null || spec.chars === undefined)
+        return false;
+    return (spec.chars === iban.length &&
+        reg.test(iban.slice(2, 4)) &&
+        isValidBBAN(iban.slice(4), iban.slice(0, 2)) &&
+        isValidIBANChecksum(iban));
 }
 exports.isValidIBAN = isValidIBAN;
 /**
@@ -115,21 +110,21 @@ exports.validateIBAN = validateIBAN;
  * ```
  */
 function isValidBBAN(bban, countryCode) {
-    if (bban !== undefined && bban !== null && countryCode !== undefined && countryCode !== null) {
-        var spec = exports.countrySpecs[countryCode];
-        if (spec !== undefined &&
-            spec !== null &&
-            spec.bban_regexp &&
-            spec.bban_regexp !== null &&
-            spec.chars &&
-            spec.chars !== null &&
-            spec.chars - 4 === bban.length &&
-            checkFormatBBAN(bban, spec.bban_regexp)) {
-            if (spec.bban_validation_func) {
-                return spec.bban_validation_func(bban.replace(/[\s.]+/g, ''));
-            }
-            return true;
+    if (bban === undefined || bban === null || countryCode === undefined || countryCode === null)
+        return false;
+    var spec = exports.countrySpecs[countryCode];
+    if (spec === undefined ||
+        spec === null ||
+        spec.bban_regexp === undefined ||
+        spec.bban_regexp === null ||
+        spec.chars === undefined ||
+        spec.chars === null)
+        return false;
+    if (spec.chars - 4 === bban.length && checkFormatBBAN(bban, spec.bban_regexp)) {
+        if (spec.bban_validation_func) {
+            return spec.bban_validation_func(bban.replace(/[\s.]+/g, ''));
         }
+        return true;
     }
     return false;
 }
@@ -192,10 +187,11 @@ exports.composeIBAN = composeIBAN;
  */
 function extractIBAN(iban) {
     var result = {};
-    result.iban = iban;
-    if (isValidIBAN(iban)) {
-        result.bban = iban.slice(4);
-        result.countryCode = iban.slice(0, 2);
+    var eFormatIBAN = electronicFormatIBAN(iban);
+    result.iban = eFormatIBAN || iban;
+    if (!!eFormatIBAN && isValidIBAN(eFormatIBAN)) {
+        result.bban = eFormatIBAN.slice(4);
+        result.countryCode = eFormatIBAN.slice(0, 2);
         result.valid = true;
     }
     else {
@@ -263,43 +259,54 @@ exports.friendlyFormatIBAN = friendlyFormatIBAN;
  * @ignore
  */
 function isValidIBANChecksum(iban) {
+    var countryCode = iban.slice(0, 2);
     var providedChecksum = parseInt(iban.slice(2, 4), 10);
-    var temp = iban.slice(3) + iban.slice(0, 2) + '00';
-    var validationString = '';
-    for (var n = 1; n < temp.length; n++) {
-        var c = temp.charCodeAt(n);
-        if (c >= 65) {
-            validationString += (c - 55).toString();
-        }
-        else {
-            validationString += temp[n];
-        }
-    }
-    while (validationString.length > 2) {
-        var part = validationString.slice(0, 6);
-        validationString = (parseInt(part, 10) % 97).toString() + validationString.slice(part.length);
-    }
-    var rest = parseInt(validationString, 10) % 97;
+    var bban = iban.slice(4);
+    // Wikipedia[validating_iban] says there are a specif way to check if a IBAN is valid but
+    // it. It says 'If the remainder is 1, the check digit test is passed and the
+    // IBAN might be valid.'. might, MIGHT!
+    // We don't want might but want yes or no. Since every BBAN is IBAN from the fifth
+    // (slice(4)) we can generate the IBAN from BBAN and country code(two first characters)
+    // from in the IBAN.
+    // To generate the (generate the iban check digits)[generating-iban-check]
+    //   Move the country code to the end
+    //   remove the checksum from the begging
+    //   Add "00" to the end
+    //   modulo 97 on the amount
+    //   subtract remainder from 98, (98 - remainder)
+    //   Add a leading 0 if the remainder is less then 10 (padStart(2, "0")) (we skip this
+    //     since we compare int, not string)
+    //
+    // [validating_iban][https://en.wikipedia.org/wiki/International_Bank_Account_Number#Validating_the_IBAN]
+    // [generating-iban-check][https://en.wikipedia.org/wiki/International_Bank_Account_Number#Generating_IBAN_check_digits]
+    var validationString = replaceCharaterWithCode("".concat(bban).concat(countryCode, "00"));
+    var rest = mod9710(validationString);
     return 98 - rest === providedChecksum;
 }
+/**
+ * Iban contain characters and should be converted to intereger by 55 substracted
+ * from there ascii value
+ *
+ * @ignore
+ */
+function replaceCharaterWithCode(str) {
+    // It is slower but alot more readable
+    // https://jsbench.me/ttkzgsekae/1
+    return str
+        .split('')
+        .map(function (c) {
+        var code = c.charCodeAt(0);
+        return code >= 65 ? (code - 55).toString() : c;
+    })
+        .join('');
+}
 /**
  * MOD-97-10
  *
  * @ignore
  */
 function mod9710Iban(iban) {
-    iban = iban.slice(3) + iban.slice(0, 4);
-    var validationString = '';
-    for (var n = 1; n < iban.length; n++) {
-        var c = iban.charCodeAt(n);
-        if (c >= 65) {
-            validationString += (c - 55).toString();
-        }
-        else {
-            validationString += iban[n];
-        }
-    }
-    return mod9710(validationString);
+    return mod9710(replaceCharaterWithCode(iban.slice(3) + iban.slice(0, 4)));
 }
 /**
  * Returns specifications for all countries, even those who are not
@@ -328,10 +335,10 @@ function getCountrySpecifications() {
     for (var countyCode in exports.countrySpecs) {
         var county = exports.countrySpecs[countyCode];
         countyMap[countyCode] = {
-            chars: county.chars ? county.chars : null,
-            bban_regexp: county.bban_regexp ? county.bban_regexp : null,
-            IBANRegistry: county.IBANRegistry ? county.IBANRegistry : false,
-            SEPA: county.SEPA ? county.SEPA : false,
+            chars: county.chars || null,
+            bban_regexp: county.bban_regexp || null,
+            IBANRegistry: county.IBANRegistry || false,
+            SEPA: county.SEPA || false,
         };
     }
     return countyMap;
@@ -462,12 +469,17 @@ var checkBelgianBBAN = function (bban) {
  */
 var mod9710 = function (validationString) {
     while (validationString.length > 2) {
+        // > Any computer programming language or software package that is used to compute D
+        // > mod 97 directly must have the ability to handle integers of more than 30 digits.
+        // > In practice, this can only be done by software that either supports
+        // > arbitrary-precision arithmetic or that can handle 219-bit (unsigned) integers
+        // https://en.wikipedia.org/wiki/International_Bank_Account_Number#Modulo_operation_on_IBAN
         var part = validationString.slice(0, 6);
-        var value = parseInt(part, 10) % 97;
-        if (isNaN(value)) {
+        var partInt = parseInt(part, 10);
+        if (isNaN(partInt)) {
             return NaN;
         }
-        validationString = value.toString() + validationString.slice(part.length);
+        validationString = (partInt % 97) + validationString.slice(part.length);
     }
     return parseInt(validationString, 10) % 97;
 };
@@ -1214,7 +1226,13 @@ exports.countrySpecs = {
         IBANRegistry: true,
         SEPA: true,
     },
-    NO: { chars: 15, bban_regexp: '^[0-9]{11}$', bban_validation_func: checkNorwayBBAN, IBANRegistry: true, SEPA: true },
+    NO: {
+        chars: 15,
+        bban_regexp: '^[0-9]{11}$',
+        bban_validation_func: checkNorwayBBAN,
+        IBANRegistry: true,
+        SEPA: true,
+    },
     NP: {},
     NR: {},
     NU: {},

package/jsnext/ibantools.js

@@ -8,7 +8,7 @@
  * @package Documentation
  * @author Saša Jovanić
  * @module ibantools
- * @version 4.1.4
+ * @version 4.1.5
  * @license MPL-2.0
  * @preferred
  */
@@ -25,21 +25,16 @@
  * ```
  */
 export function isValidIBAN(iban) {
-    if (iban !== undefined && iban !== null) {
-        var reg = new RegExp('^[0-9]{2}$', '');
-        var spec = countrySpecs[iban.slice(0, 2)];
-        if (spec !== undefined &&
-            spec.bban_regexp &&
-            spec.bban_regexp !== null &&
-            spec.chars &&
-            spec.chars === iban.length &&
-            reg.test(iban.slice(2, 4)) &&
-            isValidBBAN(iban.slice(4), iban.slice(0, 2)) &&
-            isValidIBANChecksum(iban)) {
-            return true;
-        }
-    }
-    return false;
+    if (iban === undefined || iban === null)
+        return false;
+    var reg = new RegExp('^[0-9]{2}$', '');
+    var spec = countrySpecs[iban.slice(0, 2)];
+    if (spec === undefined || spec.bban_regexp === undefined || spec.bban_regexp === null || spec.chars === undefined)
+        return false;
+    return (spec.chars === iban.length &&
+        reg.test(iban.slice(2, 4)) &&
+        isValidBBAN(iban.slice(4), iban.slice(0, 2)) &&
+        isValidIBANChecksum(iban));
 }
 /**
  * IBAM validation errors
@@ -111,21 +106,21 @@ export function validateIBAN(iban) {
  * ```
  */
 export function isValidBBAN(bban, countryCode) {
-    if (bban !== undefined && bban !== null && countryCode !== undefined && countryCode !== null) {
-        var spec = countrySpecs[countryCode];
-        if (spec !== undefined &&
-            spec !== null &&
-            spec.bban_regexp &&
-            spec.bban_regexp !== null &&
-            spec.chars &&
-            spec.chars !== null &&
-            spec.chars - 4 === bban.length &&
-            checkFormatBBAN(bban, spec.bban_regexp)) {
-            if (spec.bban_validation_func) {
-                return spec.bban_validation_func(bban.replace(/[\s.]+/g, ''));
-            }
-            return true;
+    if (bban === undefined || bban === null || countryCode === undefined || countryCode === null)
+        return false;
+    var spec = countrySpecs[countryCode];
+    if (spec === undefined ||
+        spec === null ||
+        spec.bban_regexp === undefined ||
+        spec.bban_regexp === null ||
+        spec.chars === undefined ||
+        spec.chars === null)
+        return false;
+    if (spec.chars - 4 === bban.length && checkFormatBBAN(bban, spec.bban_regexp)) {
+        if (spec.bban_validation_func) {
+            return spec.bban_validation_func(bban.replace(/[\s.]+/g, ''));
         }
+        return true;
     }
     return false;
 }
@@ -185,10 +180,11 @@ export function composeIBAN(params) {
  */
 export function extractIBAN(iban) {
     var result = {};
-    result.iban = iban;
-    if (isValidIBAN(iban)) {
-        result.bban = iban.slice(4);
-        result.countryCode = iban.slice(0, 2);
+    var eFormatIBAN = electronicFormatIBAN(iban);
+    result.iban = eFormatIBAN || iban;
+    if (!!eFormatIBAN && isValidIBAN(eFormatIBAN)) {
+        result.bban = eFormatIBAN.slice(4);
+        result.countryCode = eFormatIBAN.slice(0, 2);
         result.valid = true;
     }
     else {
@@ -253,43 +249,54 @@ export function friendlyFormatIBAN(iban, separator) {
  * @ignore
  */
 function isValidIBANChecksum(iban) {
+    var countryCode = iban.slice(0, 2);
     var providedChecksum = parseInt(iban.slice(2, 4), 10);
-    var temp = iban.slice(3) + iban.slice(0, 2) + '00';
-    var validationString = '';
-    for (var n = 1; n < temp.length; n++) {
-        var c = temp.charCodeAt(n);
-        if (c >= 65) {
-            validationString += (c - 55).toString();
-        }
-        else {
-            validationString += temp[n];
-        }
-    }
-    while (validationString.length > 2) {
-        var part = validationString.slice(0, 6);
-        validationString = (parseInt(part, 10) % 97).toString() + validationString.slice(part.length);
-    }
-    var rest = parseInt(validationString, 10) % 97;
+    var bban = iban.slice(4);
+    // Wikipedia[validating_iban] says there are a specif way to check if a IBAN is valid but
+    // it. It says 'If the remainder is 1, the check digit test is passed and the
+    // IBAN might be valid.'. might, MIGHT!
+    // We don't want might but want yes or no. Since every BBAN is IBAN from the fifth
+    // (slice(4)) we can generate the IBAN from BBAN and country code(two first characters)
+    // from in the IBAN.
+    // To generate the (generate the iban check digits)[generating-iban-check]
+    //   Move the country code to the end
+    //   remove the checksum from the begging
+    //   Add "00" to the end
+    //   modulo 97 on the amount
+    //   subtract remainder from 98, (98 - remainder)
+    //   Add a leading 0 if the remainder is less then 10 (padStart(2, "0")) (we skip this
+    //     since we compare int, not string)
+    //
+    // [validating_iban][https://en.wikipedia.org/wiki/International_Bank_Account_Number#Validating_the_IBAN]
+    // [generating-iban-check][https://en.wikipedia.org/wiki/International_Bank_Account_Number#Generating_IBAN_check_digits]
+    var validationString = replaceCharaterWithCode("".concat(bban).concat(countryCode, "00"));
+    var rest = mod9710(validationString);
     return 98 - rest === providedChecksum;
 }
+/**
+ * Iban contain characters and should be converted to intereger by 55 substracted
+ * from there ascii value
+ *
+ * @ignore
+ */
+function replaceCharaterWithCode(str) {
+    // It is slower but alot more readable
+    // https://jsbench.me/ttkzgsekae/1
+    return str
+        .split('')
+        .map(function (c) {
+        var code = c.charCodeAt(0);
+        return code >= 65 ? (code - 55).toString() : c;
+    })
+        .join('');
+}
 /**
  * MOD-97-10
  *
  * @ignore
  */
 function mod9710Iban(iban) {
-    iban = iban.slice(3) + iban.slice(0, 4);
-    var validationString = '';
-    for (var n = 1; n < iban.length; n++) {
-        var c = iban.charCodeAt(n);
-        if (c >= 65) {
-            validationString += (c - 55).toString();
-        }
-        else {
-            validationString += iban[n];
-        }
-    }
-    return mod9710(validationString);
+    return mod9710(replaceCharaterWithCode(iban.slice(3) + iban.slice(0, 4)));
 }
 /**
  * Returns specifications for all countries, even those who are not
@@ -318,10 +325,10 @@ export function getCountrySpecifications() {
     for (var countyCode in countrySpecs) {
         var county = countrySpecs[countyCode];
         countyMap[countyCode] = {
-            chars: county.chars ? county.chars : null,
-            bban_regexp: county.bban_regexp ? county.bban_regexp : null,
-            IBANRegistry: county.IBANRegistry ? county.IBANRegistry : false,
-            SEPA: county.SEPA ? county.SEPA : false,
+            chars: county.chars || null,
+            bban_regexp: county.bban_regexp || null,
+            IBANRegistry: county.IBANRegistry || false,
+            SEPA: county.SEPA || false,
         };
     }
     return countyMap;
@@ -448,12 +455,17 @@ var checkBelgianBBAN = function (bban) {
  */
 var mod9710 = function (validationString) {
     while (validationString.length > 2) {
+        // > Any computer programming language or software package that is used to compute D
+        // > mod 97 directly must have the ability to handle integers of more than 30 digits.
+        // > In practice, this can only be done by software that either supports
+        // > arbitrary-precision arithmetic or that can handle 219-bit (unsigned) integers
+        // https://en.wikipedia.org/wiki/International_Bank_Account_Number#Modulo_operation_on_IBAN
         var part = validationString.slice(0, 6);
-        var value = parseInt(part, 10) % 97;
-        if (isNaN(value)) {
+        var partInt = parseInt(part, 10);
+        if (isNaN(partInt)) {
             return NaN;
         }
-        validationString = value.toString() + validationString.slice(part.length);
+        validationString = (partInt % 97) + validationString.slice(part.length);
     }
     return parseInt(validationString, 10) % 97;
 };
@@ -1200,7 +1212,13 @@ export var countrySpecs = {
         IBANRegistry: true,
         SEPA: true,
     },
-    NO: { chars: 15, bban_regexp: '^[0-9]{11}$', bban_validation_func: checkNorwayBBAN, IBANRegistry: true, SEPA: true },
+    NO: {
+        chars: 15,
+        bban_regexp: '^[0-9]{11}$',
+        bban_validation_func: checkNorwayBBAN,
+        IBANRegistry: true,
+        SEPA: true,
+    },
     NP: {},
     NR: {},
     NU: {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ibantools",
-  "version": "4.1.4",
+  "version": "4.1.5",
   "description": "Validation, extraction and creation of IBAN, BBAN, BIC/SWIFT numbers plus some other helpful stuff like ISO 3136-1 alpha 2 country list",
   "keywords": [
     "IBAN",
@@ -53,14 +53,12 @@
     "@typescript-eslint/eslint-plugin": "^4.28.4",
     "@typescript-eslint/parser": "^4.28.4",
     "chai": "^4.3.4",
-    "cheerio": "^0.22",
     "coveralls": "^3.1.1",
     "docdash": "^1.2.0",
     "eslint": "^7.31.0",
     "eslint-config-prettier": "^8.3.0",
     "eslint-plugin-prettier": "^4.0.0",
     "gulp": "^4.0.2",
-    "gulp-mocha": "^8.0",
     "gulp-rename": "^2.0",
     "gulp-shell": "^0.8.0",
     "gulp-typescript": "^5.0",

package/ChangeLog

@@ -1,275 +0,0 @@
-2022-02-03  Saša Jovanić <sasa@simplify.ba>
-	* Version 4.1.4
-	* Fix issue #103 - Remove Dutch BBAN validation
-	* Various development dependencies upgrades
-
-2021-12-17  Saša Jovanić <sasa@simplify.ba>
-	* Version 4.1.3
-	* Fix issue #85 - Fix NaN issue when calling `validateIBAN`
-
-2021-12-14  Saša Jovanić <sasa@simplify.ba>
-	* Version 4.1.2
-	* Fix issue #83 - Fix problem when country can not be found when calling `validateIBAN`
-
-2021-12-05  Saša Jovanić <sasa@simplify.ba>
-	* Version 4.1.1
-	* Added Hungarian (HU) BBAN validation
-
-2021-12-01  Saša Jovanić <sasa@simplify.ba>
-	* Improve test coverage
-
-2021-11-30  Saša Jovanić <sasa@simplify.ba>
-	* Added Estonian (EE) BBAN validation
-	* Added Finland (FI) BBAN validation
-	* Aland Islands (AX) uses BBAN valkidation from Finland
-	* Added French (FR) and Monaco (MC) BBAN validation
-
-2021-11-28  Saša Jovanić <sasa@simplify.ba>
-	* Added Czech (CZ) BBAN validation
-
-2021-11-27  Saša Jovanić <sasa@simplify.ba>
-	* Added Croatian (HR) BBAN validation
-
-2021-11-25  Saša Jovanić <sasa@simplify.ba>
-	* Version 4.1.0
-	* Added Belgian (BE) extra BBAN validation
-	* Added mod97/10 BBAN validation for countries that do it that way: BA, ME, MK, PT, RS and SI
-
-2021-11-24  Saša Jovanić <sasa@simplify.ba>
-	* Added Netherlands (NL) extra BBAN validation
-	* Added extra error code when validating IBAN `WrongAccountBankBranchChecksum` that indicates when checksum for account number or bank or branch code is incorrect
-
-2021-11-23  Saša Jovanić <sasa@simplify.ba>
-	* Version 4.0.1
-	* Fixed bug when validating Spain IBAN
-
-2021-11-18  Saša Jovanić <sasa@simplify.ba>
-	* Updated README with new and updated badges
-	* Fixed documentation on GH pages
-	* Added dependabot dependency updates and merged some created dependency pull requests
-	* Added Node 17 to build version on GitHub actions
-	* Added GitHub CodeQL workflow
-
-2021-11-17  Saša Jovanić <sasa@simplify.ba>
-	* Version 4.0.0
-	* Fixed Senegal (SN) regular expression
-	* Updated Burundi (BI) specification
-	* Added Spain (ES) extra BBAN validation
-	* Added Poland (PL) extra BBAN validation
-	* Added test to check for extra BBAN validation function
-
-2021-09-30  Simen Mailund Svendsen <simen.m.s@hotmail.com>
-	* Fix invalid norwegian BBANS (failing MOD11 check) being incorrectly returned as valid
-
-2021-07-24  Saša Jovanić <sasa@simplify.ba>
-	* Version 3.3.1
-	* Fixed issue not showing AD and BG as SEPA countries
-	* Fixed issue when incorrectly showing GL and FO as SEPA countryes
-	* Fixed incorrect documentation for `composeIBAN`
-	* Updates list of supported Node.js versions
-	* Update dev dependencies
-
-2021-05-05 Daniel Friesen <d@danf.ca>
-  * Fixed `validateIBAN`'s handling of unsupported countries like US
-  * Added checksum validation for unsupported/unknown countries to `validateIBAN`
-
-2021-04-03  Saša Jovanić <sasa@simplify.ba>
-	* Coverage improved to 100%
-
-2021-04-03  Saša Jovanić <sasa@simplify.ba>
-	* Version 3.3.0
-	* Error codes for IBAN and BIC validation. Added `validateIBAN` and `validateBIC` methods that will return error codes.
-
-2021-04-03  Saša Jovanić <sasa@simplify.ba>
-	* Version 3.2.5
-	* (Dependabot) Bump y18n from 3.2.1 to 3.2.2
-
-2021-03-29  Xavier Alvarez
-	* Fix validation for Burkina Faso, Benin, Algeria and Mali
-
-2021-03-10  Saša Jovanić  <sasa@simplify.ba>
-	* Version 3.2.4
-	* Exported `countrySpecs` to restore a bit of compatibility broken in 3.2.3
-	* Updated development dependencies
-	* Documentation is now part of master branch
-
-2021-02-07  Saša Jovanić  <sasa@simplify.ba>
-	* Version 3.2.3
-	* Dependabot PR merged
-
-2021-02-06  Richard Leurs
-	* Improve bundle size
-
-2020-11-10  Saša Jovanić  <sasa@simplify.ba>
-	* Version 3.2.2
-	* Fixed support for Cape Verde
-	* Dependabot PR merged
-
-2020-11-10  Saša Jovanić  <sasa@simplify.ba>
-	* Switch from `jsdoc` to `typedoc` for documentation generation
-	* Typo in interface name fixed, this will require mayor version release
-
-2020-11-09  Saša Jovanić  <sasa@simplify.ba>
-	* Removed `tslint` and added `eslint` and `prettier` to be used with `gulp lint` task
-	* Added GitHub Action for linting to workflow
-	* Updated PR template on GitHub and modified `CONTRIBUTING.md` document
-
-2020-11-04  Saša Jovanić  <sasa@simplify.ba>
-	* Version 3.2.1
-	* Merged PR from @witoldsz: Fixed Azerbaijan IBAN check regexp
-
-2020-11-04  Saša Jovanić  <sasa@simplify.ba>
-	* Removed Travis CI integration and integrated Github Action to show badge on master branch and status on pull requests
-	* Upgraded to `typescript` 4
-
-2020-11-03  Saša Jovanić  <sasa@simplify.ba>
-	* Version 3.2.0
-	* Added Node 15 and removed node 13 to Travis environments
-	* Updated various development dependencies
-	* Test file is no longer written in TypeScript - types/chai is a problem when building for ES5
-	* Switched from `istanbul` to `nyc` for code coverage
-	* Added Libya as new addition to official IBAN registry
-	* Fix crash when `isValidBIC` receives `null` or `undefined`
-	* Added Github Build Action as preparation to move away from Travis CI
-
-2020-06-21  Saša Jovanić  <sasa@simplify.ba>
-	* Version 3.1.0
-	* Merged PR from @EarthlingRich (Richard Leurs) that adds `isSEPACountry` function.
-	* Fixed RegExp for Seychelles
-	* Added Node 14 to Travis environments
-
-2020-04-05  Saša Jovanić  <sasa@simplify.ba>
-	* Version 3.0.0
-
-2020-03-31  Saša Jovanić  <sasa@simplify.ba>
-	* Updated some dev dependencies
-
-2020-03-29  Saša Jovanić  <sasa@simplify.ba>
-	* Merged #18 - Drop country names from output - PR from @eemeli (Eemeli Aro) that removes country names from functions output. Country code is still present. This will reduce total bundle size. If you still need country names, please use `countrynames` or `country-iso` packages.
-	* Merged various dependabot pull requests.
-	* Added prettier as dev dependency.
-	* Upgraded dependencies based on `npm audit`.
-	* Added node 13 and dropped node 11 on Travis.
-	* Added Egypt as new addition to official IBAN specification.
-	* Added countries that are not in official IBAN specification published by Swift: Algeria, Angola, Benin, Burkina Faso, Burundi, Cameroon, Cape Verde, Iran, Ivory Coast, Madagascar, Mali, Mozambique, Senegal, Comoros, Chad, Gabon, Honduras, Morocco, Nicaragua, Niger, Togo, Central African Republic, Djibouti, Equatorial Guinea and Guinea-Bissau.
-
-2019-08-12  Saša Jovanić  <sasa@simplify.ba>
-	* Released varsion 2.2.0
-	* Fixed Swift register PDF link on README file
-	* Fixed problem with invalid IBAN checksum structure (GH16)
-	* When checking if IBAN checksum is valid we will generate IBAN checksum and compare it with existing one instead of checking if result of mod97-10 is 1
-	* Added `strict` flag to tsconfig
-
-2019-05-05  Saša Jovanić  <sasa@simplify.ba>
-	* Updated development dependencies to latest versions
-	* Updated deep dependencies that have security issues
-
-2019-05-05  Saša Jovanić  <sasa@simplify.ba>
-	* Released varsion 2.1.0
-	* Merged PR1 - Renamed `main:jsnext` to `modules` - Thanks @NeoLegends (PR1/GH9)
-	* Upraded various packages containing security vulnerabilities using `npm audit fix`
-	* Upgraded Gulp to version 4 and all gulp tasks
-	* Added Vatican City State (GH13)
-	* `friendlyFormatIBAN` and `electronicFormatIBAN` will return `null` when non-string value is provided (GH15).
-	* Fixed issue with `extractBIC` when argument is provided in lowercase (GH12).
-
-2018-03-11  Saša Jovanić  <sasa@simplify.ba>
-	* Released version 2.0.0
-	* BREAKING: `isValidIBAN` does not accept IBAN with `-` and ` ` any more - IBAN must be already in electronic format
-	* `getCountrySpecifications` now returns all countries (ISO-3166-1 alpha-2 + `XK` - temporary country code for Kosovo) with `IBANRegistry` boolean property that indicates if country is in IBAN registry or not
-	* `extractIBAN` now requires IBAN in electronic format
-	* `isValidBIC` now also checks if Country exists
-	* `extractBIC` also returns property `countryCode`
-	* Added `tslint` as development dependency
-
-2018-02-13  Saša Jovanić  <sasa@simplify.ba>
-	* Released version 1.6.0
-	* Fixed link to latest IBAN registry PDF document
-	* Fixed validation for Costa Rica (it has 18 digits now, not 17)
-	* Added Republic of Belarus
-	* Added Iraq
-	* Renamed `Palestinian teritories` to `State of Palestine`, as in IBAN registry
-	* Added El Salvador
-	* Updated develpoment dependencies
-	* `ExtractIBANResult` now also contains `iban` that represents IBAN electronic format
-	* `electronicFormatIBAN` now removes only spaces and dashes, not the other unicode characters
-
-2017-11-15  Saša Jovanić  <sasa@simplify.ba>
-	* Released version 1.5.1
-	* Fixed mistake in BIC validation regexp when brach code is present (GH-5)
-	* Added node.js 9 to TravisCI
-
-2017-10-10  Saša Jovanić  <sasa@simplify.ba>
-	* Released version 1.5.0
-	* Fixed typos in source code and documentation (GH-4)
-
-2017-10-05  Saša Jovanić  <sasa@simplify.ba>
-	* Changed documentation theme to `docdash`
-	* Fixed links in README to avoid broken links in documentation
-	* Updated `coverals` package
-
-2017-10-05  Saša Jovanić  <sasa@simplify.ba>
-	* Released version 1.4.0
-	* Added code of conduct
-	* Updated mocha development dependency to 4.0
-	* Added contribution guide
-	* Updated JSDoc to latest version
-	* Added issue and pull request template
-
-2017-08-23  Saša Jovanić  <sasa@simplify.ba>
-	* Now using @types - typings removed
-
-2017-08-22  Saša Jovanić  <sasa@simplify.ba>
-	* Updated development dependencies
-	* Added node version 8 to TravisCI tests
-
-2017-03-09  Saša Jovanić  <sasa@simplify.ba>
-	* Released version 1.3.0
-	* Fixed `jsnext:main` file output
-	* Fixed problem with BIC/SWIFT validation when branch code is part of BIC/SWIFT
-	* extractBIC will return `branchCode` as '619' (primary office) if branch code in not part of BIC/SWIFT number
-	* Fixed README file
-	* Updated development dependencies
-
-2017-02-04  Saša Jovanić  <sasa@simplify.ba>
-	* Released version 1.2.0
-	* Added BIC/SWIFT validation
-	* Added BIC/SWIFT extraction
-	* Updated TypeScript definitions
-
-2017-01-29  Saša Jovanić  <sasa@simplify.ba>
-	* Removed testing on Node 4 and 5 in TravisCI and added testing on 7
-	* Updated dev dependencies
-	* Removed TSLint deprecations
-	* Fixed ducumentation
-
-2016-08-30  Saša Jovanić  <sasa@simplify.ba>
-	* Removed CodeCov codes
-	* Added Coveralls badge and integration
-	* Added Dependency CI badge
-
-2016-08-27  Saša Jovanić  <sasa@simplify.ba>
-	* Released version 1.1.0
-	* Added Sao Tome And Principe (ST)
-	* Added Saint Lucia (LC)
-	* Added Aland Islands (AX)
-	* Added French Guyana (GF)
-	* Added Guadeloupe (GP)
-	* Added Martinique (MQ)
-	* Added Reunion (RE)
-	* Added French Polynesia (PF)
-	* Added French Southern Territories (TF)
-	* Added Mayotte (YT)
-	* Added New Caledonia (NC)
-	* Added Saint Barthelemy (BL)
-	* Added Saint Martin (MF)
-	* Added Saint Pierre et Miquelon (PM)
-	* Added Wallis and Futuna Islands (WF)
-	* Added Seychelles (SC)
-	* Fixed Republic of Azerbaijan and Jordan regexps
-	* Fixed some of the country names
-	* Added Node 6 to Travis CI
-	* Added Codecov to Travis CI config file
-	* Added this ChangeLog
-	* Updated development dependencies and typings
-	* Removed old script that used to retrive IBAN countries and codes from Wikipedia