Added isFreightContainerID validator

README.md

@@ -102,6 +102,7 @@ Validator                               | Description
 **isBoolean(str [, options])**          | check if a string is a boolean.<br/>`options` is an object which defaults to `{ loose: false }`. If loose is is set to false, the validator will strictly match ['true', 'false', '0', '1']. If loose is set to true, the validator will also match 'yes', 'no', and will match a valid boolean string of any case. (eg: ['true', 'True', 'TRUE']).
 **isBtcAddress(str)**            | check if the string is a valid BTC address.
 **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}`.
+**isContainerID(str)**                   | check if the string is an ISO6346 shipping container identification.
 **isCreditCard(card, [, options])**                   | check if the string is a credit card.<br/><br/>  options is an optional object that can be supplied with the following key(s): `provider` is an optional key whose value should be a string, and defines the company issuing the credit card.  Valid values include `amex` , `dinersclub` , `discover` , `jcb` , `mastercard` , `unionpay` , `visa` or blank will check for any provider. 
 **isCurrency(str [, options])**            | check if the string is a valid currency amount.<br/><br/>`options` is an object which defaults to `{symbol: '$', require_symbol: false, allow_space_after_symbol: false, symbol_after_digits: false, allow_negatives: true, parens_for_negatives: false, negative_sign_before_digits: false, negative_sign_after_digits: false, allow_negative_sign_placeholder: false, thousands_separator: ',', decimal_separator: '.', allow_decimal: true, require_decimal: false, digits_after_decimal: [2], allow_space_after_digits: false}`.<br/>**Note:** The array `digits_after_decimal` is filled with the exact number of digits allowed not a range, for example a range 1 to 3 will be given as [1, 2, 3].
 **isDataURI(str)**                      | check if the string is a [data uri format](https://developer.mozilla.org/en-US/docs/Web/HTTP/data_URIs).

src/index.js

@@ -78,6 +78,7 @@ import isISIN from './lib/isISIN';
 import isISBN from './lib/isISBN';
 import isISSN from './lib/isISSN';
 import isTaxID from './lib/isTaxID';
+import isContainerID from './lib/isContainerID';
 
 import isMobilePhone, { locales as isMobilePhoneLocales } from './lib/isMobilePhone';
 
@@ -195,6 +196,7 @@ const validator = {
   isMobilePhoneLocales,
   isPostalCode,
   isPostalCodeLocales,
+  isContainerID,
   isEthereumAddress,
   isCurrency,
   isBtcAddress,

src/lib/isContainerID.js

@@ -0,0 +1,28 @@
+import assertString from './util/assertString';
+
+// https://en.wikipedia.org/wiki/ISO_6346
+const isContainerIdReg = new RegExp('^[A-Z]{3}U[0-9]{7}$');
+const isDigit = new RegExp('^[0-9]{1}');
+
+export default function isContainerID(str) {
+  assertString(str);
+  str = str.trim();
+
+  if (!isContainerIdReg.test(str)) return false;
+
+  let sum = 0;
+  for (let i = 0; i < str.length - 1; i++) {
+    if (!isDigit.test(str[i])) {
+      let convertedCode;
+      const letterCode = str.charCodeAt(i) - 55;
+      if (letterCode < 11) convertedCode = letterCode;
+      else if (letterCode >= 11 && letterCode <= 20) convertedCode = 12 + (letterCode % 11);
+      else if (letterCode >= 21 && letterCode <= 30) convertedCode = 23 + (letterCode % 21);
+      else convertedCode = 34 + (letterCode % 31);
+      sum += convertedCode * (2 ** i);
+    } else sum += str[i] * (2 ** i);
+  }
+
+  const checkSumDigit = sum % 11;
+  return Number(str[str.length - 1]) === checkSumDigit;
+}

test/validators.js

@@ -11837,6 +11837,31 @@ describe('Validators', () => {
     });
   });
 
+  it('should validate containerID', () => {
+    test({
+      validator: 'isContainerID',
+      valid: [
+        'HLXU2008419',
+        'TGHU7599330',
+        'ECMU4657496',
+        'MEDU6246078',
+        'YMLU2809976',
+        'MRKU0046221',
+        'EMCU3811879',
+        'OOLU8643084',
+        'HJCU1922713',
+      ],
+      invalid: [
+        'OOLU1922713',
+        'HJCU1922413',
+        'FCUI985619',
+        'ECMJ4657496',
+        'TBJA7176445',
+        'AFFU5962593',
+      ],
+    });
+  });
+
   // EU-UK valid numbers sourced from https://ec.europa.eu/taxation_customs/tin/specs/FS-TIN%20Algorithms-Public.docx or constructed by @tplessas.
   it('should validate taxID', () => {
     test({