feat(isBIC): add isBIC validation (#1071)

* feature(isBIC): add isBIC validation
- validate valid BIC
- refers part of #951

* chore: add on BIC definition

README.md

@@ -83,6 +83,7 @@ Validator                               | Description
 **isBase32(str)**                       | check if a string is base32 encoded.
 **isBase64(str)**                       | check if a string is base64 encoded.
 **isBefore(str [, date])**              | check if the string is a date that's before the specified date.
+**isBIC(str)**                          | check if a string is a BIC (Bank Idenfication Code) or SWIFT code.
 **isBoolean(str)**                      | check if a string is a boolean.
 **isByteLength(str [, options])**          | check if the string's length (in UTF-8 bytes) falls in a range.<br/><br/>`options` is an object which defaults to `{min:0, max: undefined}`.
 **isCreditCard(str)**                   | check if the string is a credit card.

index.js

@@ -71,6 +71,8 @@ var _isHexColor = _interopRequireDefault(require("./lib/isHexColor"));
 
 var _isISRC = _interopRequireDefault(require("./lib/isISRC"));
 
+var _isBIC = _interopRequireDefault(require("./lib/isBIC"));
+
 var _isMD = _interopRequireDefault(require("./lib/isMD5"));
 
 var _isHash = _interopRequireDefault(require("./lib/isHash"));
@@ -172,6 +174,7 @@ var validator = {
   isIPRange: _isIPRange.default,
   isFQDN: _isFQDN.default,
   isBoolean: _isBoolean.default,
+  isBIC: _isBIC.default,
   isAlpha: _isAlpha.default,
   isAlphaLocales: _isAlpha.locales,
   isAlphanumeric: _isAlphanumeric.default,

lib/isBIC.js

@@ -0,0 +1,20 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = isBIC;
+
+var _assertString = _interopRequireDefault(require("./util/assertString"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+var isBICReg = /^[A-z]{4}[A-z]{2}\w{2}(\w{3})?$/;
+
+function isBIC(str) {
+  (0, _assertString.default)(str);
+  return isBICReg.test(str);
+}
+
+module.exports = exports.default;
+module.exports.default = exports.default;

src/index.js

@@ -39,6 +39,8 @@ import isHexColor from './lib/isHexColor';
 
 import isISRC from './lib/isISRC';
 
+import isBIC from './lib/isBIC';
+
 import isMD5 from './lib/isMD5';
 import isHash from './lib/isHash';
 import isJWT from './lib/isJWT';
@@ -113,6 +115,7 @@ const validator = {
   isIPRange,
   isFQDN,
   isBoolean,
+  isBIC,
   isAlpha,
   isAlphaLocales,
   isAlphanumeric,

src/lib/isBIC.js

@@ -0,0 +1,8 @@
+import assertString from './util/assertString';
+
+const isBICReg = /^[A-z]{4}[A-z]{2}\w{2}(\w{3})?$/;
+
+export default function isBIC(str) {
+  assertString(str);
+  return isBICReg.test(str);
+}

test/validators.js

@@ -3002,6 +3002,26 @@ describe('Validators', () => {
     });
   });
 
+  it('should validate BIC codes', () => {
+    test({
+      validator: 'isBIC',
+      valid: [
+        'SBICKEN1345',
+        'SBICKEN1',
+        'SBICKENY',
+        'SBICKEN1YYP',
+      ],
+      invalid: [
+        'SBIC23NXXX',
+        'S23CKENXXXX',
+        'SBICKENXX',
+        'SBICKENXX9',
+        'SBICKEN13458',
+        'SBICKEN',
+      ],
+    });
+  });
+
   it('should validate that integer strings are divisible by a number', () => {
     test({
       validator: 'isDivisibleBy',

validator.js

@@ -940,6 +940,12 @@ function isISRC(str) {
   return isrc.test(str);
 }
 
+var isBICReg = /^[A-z]{4}[A-z]{2}\w{2}(\w{3})?$/;
+function isBIC(str) {
+  assertString(str);
+  return isBICReg.test(str);
+}
+
 var md5 = /^[a-f0-9]{32}$/;
 function isMD5(str) {
   assertString(str);
@@ -2037,6 +2043,7 @@ var validator = {
   isIPRange: isIPRange,
   isFQDN: isFQDN,
   isBoolean: isBoolean,
+  isBIC: isBIC,
   isAlpha: isAlpha,
   isAlphaLocales: locales,
   isAlphanumeric: isAlphanumeric,