@webiny/validation 5.15.0-beta.0

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["validation","Validation","setValidator","creditCard","email","eq","gt","gte","isIn","integer","json","lt","lte","maxLength","minLength","number","numeric","password","phone","required","url","dateGte","dateLte","timeGte","timeLte"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;;AACA;;AACA;;AACA;;AACA;;AACA;;AACA;;AACA;;AACA;;AACA;;AACA;;AACA;;AACA;;AACA;;AACA;;AACA;;AACA;;AACA;;AACA;;AACA;;AACA;;AACA;;AACA;;AACA;;AAEA,MAAMA,UAAU,GAAG,IAAIC,mBAAJ,EAAnB;;AACAD,UAAU,CAACE,YAAX,CAAwB,YAAxB,EAAsCC,mBAAtC;AACAH,UAAU,CAACE,YAAX,CAAwB,OAAxB,EAAiCE,cAAjC;AACAJ,UAAU,CAACE,YAAX,CAAwB,IAAxB,EAA8BG,WAA9B;AACAL,UAAU,CAACE,YAAX,CAAwB,IAAxB,EAA8BI,WAA9B;AACAN,UAAU,CAACE,YAAX,CAAwB,KAAxB,EAA+BK,YAA/B;AACAP,UAAU,CAACE,YAAX,CAAwB,IAAxB,EAA8BM,WAA9B;AACAR,UAAU,CAACE,YAAX,CAAwB,SAAxB,EAAmCO,gBAAnC;AACAT,UAAU,CAACE,YAAX,CAAwB,MAAxB,EAAgCQ,aAAhC;AACAV,UAAU,CAACE,YAAX,CAAwB,IAAxB,EAA8BS,WAA9B;AACAX,UAAU,CAACE,YAAX,CAAwB,KAAxB,EAA+BU,YAA/B;AACAZ,UAAU,CAACE,YAAX,CAAwB,WAAxB,EAAqCW,kBAArC;AACAb,UAAU,CAACE,YAAX,CAAwB,WAAxB,EAAqCY,kBAArC;AACAd,UAAU,CAACE,YAAX,CAAwB,QAAxB,EAAkCa,eAAlC;AACAf,UAAU,CAACE,YAAX,CAAwB,SAAxB,EAAmCc,gBAAnC;AACAhB,UAAU,CAACE,YAAX,CAAwB,UAAxB,EAAoCe,iBAApC;AACAjB,UAAU,CAACE,YAAX,CAAwB,OAAxB,EAAiCgB,cAAjC;AACAlB,UAAU,CAACE,YAAX,CAAwB,UAAxB,EAAoCiB,iBAApC;AACAnB,UAAU,CAACE,YAAX,CAAwB,KAAxB,EAA+BkB,YAA/B;AACApB,UAAU,CAACE,YAAX,CAAwB,SAAxB,EAAmCmB,gBAAnC;AACArB,UAAU,CAACE,YAAX,CAAwB,SAAxB,EAAmCoB,gBAAnC;AACAtB,UAAU,CAACE,YAAX,CAAwB,SAAxB,EAAmCqB,gBAAnC;AACAvB,UAAU,CAACE,YAAX,CAAwB,SAAxB,EAAmCsB,gBAAnC","sourcesContent":["import Validation from \"./validation\";\nimport ValidationError from \"./validationError\";\nimport creditCard from \"./validators/creditCard\";\nimport email from \"./validators/email\";\nimport eq from \"./validators/eq\";\nimport gt from \"./validators/gt\";\nimport gte from \"./validators/gte\";\nimport isIn from \"./validators/in\";\nimport integer from \"./validators/integer\";\nimport json from \"./validators/json\";\nimport lt from \"./validators/lt\";\nimport lte from \"./validators/lte\";\nimport maxLength from \"./validators/maxLength\";\nimport minLength from \"./validators/minLength\";\nimport number from \"./validators/number\";\nimport numeric from \"./validators/numeric\";\nimport password from \"./validators/password\";\nimport phone from \"./validators/phone\";\nimport required from \"./validators/required\";\nimport url from \"./validators/url\";\nimport dateGte from \"./validators/dateGte\";\nimport dateLte from \"./validators/dateLte\";\nimport timeGte from \"./validators/timeGte\";\nimport timeLte from \"./validators/timeLte\";\n\nconst validation = new Validation();\nvalidation.setValidator(\"creditCard\", creditCard);\nvalidation.setValidator(\"email\", email);\nvalidation.setValidator(\"eq\", eq);\nvalidation.setValidator(\"gt\", gt);\nvalidation.setValidator(\"gte\", gte);\nvalidation.setValidator(\"in\", isIn);\nvalidation.setValidator(\"integer\", integer);\nvalidation.setValidator(\"json\", json);\nvalidation.setValidator(\"lt\", lt);\nvalidation.setValidator(\"lte\", lte);\nvalidation.setValidator(\"maxLength\", maxLength);\nvalidation.setValidator(\"minLength\", minLength);\nvalidation.setValidator(\"number\", number);\nvalidation.setValidator(\"numeric\", numeric);\nvalidation.setValidator(\"password\", password);\nvalidation.setValidator(\"phone\", phone);\nvalidation.setValidator(\"required\", required);\nvalidation.setValidator(\"url\", url);\nvalidation.setValidator(\"dateGte\", dateGte);\nvalidation.setValidator(\"dateLte\", dateLte);\nvalidation.setValidator(\"timeGte\", timeGte);\nvalidation.setValidator(\"timeLte\", timeLte);\n\nexport { validation, Validation, ValidationError };\n"],"file":"index.js"}

package/package.json

@@ -0,0 +1,43 @@
+{
+	"name": "@webiny/validation",
+	"version": "5.15.0-beta.0",
+	"main": "index.js",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/webiny/webiny-js.git"
+	},
+	"description": "A simple data validation library, packed with frequently used validators.",
+	"contributors": [
+		"Pavel Denisjuk <pavel@webiny.com>",
+		"Sven Al Hamad <sven@webiny.com>",
+		"Adrian Smijulj <adrian@webiny.com>"
+	],
+	"license": "MIT",
+	"dependencies": {
+		"@babel/runtime": "7.15.3",
+		"isnumeric": "0.3.3",
+		"lodash": "4.17.21"
+	},
+	"devDependencies": {
+		"@babel/cli": "^7.5.5",
+		"@babel/core": "^7.5.5",
+		"@babel/preset-env": "^7.5.5",
+		"@babel/preset-typescript": "^7.8.3",
+		"@webiny/cli": "^5.15.0-beta.0",
+		"@webiny/project-utils": "^5.15.0-beta.0",
+		"babel-plugin-lodash": "^3.3.4",
+		"jest": "^26.6.3",
+		"merge": "^1.2.1",
+		"rimraf": "^3.0.2",
+		"typescript": "^4.1.3"
+	},
+	"publishConfig": {
+		"access": "public",
+		"directory": "dist"
+	},
+	"scripts": {
+		"build": "yarn webiny run build",
+		"watch": "yarn webiny run watch"
+	},
+	"gitHead": "baf2dbb8cae1b623b59d20fedc0cd0e11a310ca1"
+}

package/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @typedef Validator
+ * @name Validator
+ * @description This type defines the validator function.
+ * @param {any} value This is the value being validated.
+ * @param {Array<string>} parameters (Optional) This represents an array validator parameters.
+ * @throws {ValidationError}
+ */
+export declare type Validator = (value: any, params: Array<string>) => void;
+/**
+ * @typedef ValidateOptions
+ * @name ValidateOptions
+ * @description This is an object containing validation options.
+ * @property {boolean} throw Should validation throw on failure? Default: true.
+ */
+export declare type ValidateOptions = {
+    throw?: boolean;
+};
+/**
+ * @private
+ * @typedef ParsedValidators
+ * @name ParsedValidators
+ * @description An object containing validators with parameters: `{ [string]: Array<string> }`.
+ */
+export declare type ParsedValidators = {
+    [key: string]: Array<string>;
+};

package/types.js

@@ -0,0 +1,6 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+//# sourceMappingURL=types.js.map

package/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","sourcesContent":[],"file":"types.js"}

package/validation.d.ts

@@ -0,0 +1,62 @@
+import ValidationError from "./validationError";
+import { Validator, ValidateOptions, ParsedValidators } from "./types";
+/**
+ * Main class of Validation library.
+ * Exported as a singleton instance, it offers methods for sync/async data validation and overwriting or adding new validators.
+ *
+ * @class Validation
+ * @example
+ * import { validation } from '@webiny/validation';
+ *
+ * // `validation` is a preconfigured instance of Validation class.
+ * // From here you can either add new validators or use it as-is.
+ */
+declare class Validation {
+    /**
+     * Contains a list of all set validators.
+     * @private
+     */
+    __validators: {
+        [key: string]: Validator;
+    };
+    constructor();
+    /**
+     * Add new validator.
+     * @param name Validator name.
+     * @param callable Validator function which throws a ValidationError if validation fails.
+     * @returns {Validation}
+     */
+    setValidator(name: string, callable: Validator): this;
+    /**
+     * Get validator function by name.
+     * @param name Validator name.
+     * @returns {Validator} A validator function.
+     */
+    getValidator(name: string): Validator;
+    /**
+     * Asynchronously validates value.
+     * @param value Value to validate.
+     * @param validators A list of comma-separated validators (eg. required,number,gt:20).
+     * @param [options] Validation options.
+     * @returns {Promise<boolean | ValidationError>}
+     */
+    validate(value: any, validators: string, options?: ValidateOptions): Promise<boolean | ValidationError>;
+    /**
+     * Synchronously validates value.
+     * @param value Value to validate.
+     * @param validators A list of comma-separated validators (eg. required,number,gt:20).
+     * @param [options] Validation options.
+     * @returns {Promise<boolean | ValidationError>}
+     */
+    validateSync(value: any, validators: string, options?: ValidateOptions): boolean | ValidationError;
+    create(validators: string): any;
+    createSync(validators: string): any;
+    /**
+     * Parses a string of validators with parameters.
+     * @param validators A list of comma-separated validators (eg. required,number,gt:20).
+     * @returns {ParsedValidators}
+     * @private
+     */
+    __parseValidateProperty(validators: string): ParsedValidators;
+}
+export default Validation;

package/validation.js

@@ -0,0 +1,195 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+
+var _trim2 = _interopRequireDefault(require("lodash/trim"));
+
+var _isEmpty2 = _interopRequireDefault(require("lodash/isEmpty"));
+
+var _isString2 = _interopRequireDefault(require("lodash/isString"));
+
+var _validationError = _interopRequireDefault(require("./validationError"));
+
+const entries = validators => {
+  return Object.entries(validators);
+};
+
+const invalidRules = "Validators must be specified as a string (eg. required,minLength:10,email).";
+const createdValidators = {
+  async: {},
+  sync: {}
+};
+/**
+ * Main class of Validation library.
+ * Exported as a singleton instance, it offers methods for sync/async data validation and overwriting or adding new validators.
+ *
+ * @class Validation
+ * @example
+ * import { validation } from '@webiny/validation';
+ *
+ * // `validation` is a preconfigured instance of Validation class.
+ * // From here you can either add new validators or use it as-is.
+ */
+
+class Validation {
+  /**
+   * Contains a list of all set validators.
+   * @private
+   */
+  constructor() {
+    (0, _defineProperty2.default)(this, "__validators", void 0);
+    this.__validators = {};
+  }
+  /**
+   * Add new validator.
+   * @param name Validator name.
+   * @param callable Validator function which throws a ValidationError if validation fails.
+   * @returns {Validation}
+   */
+
+
+  setValidator(name, callable) {
+    this.__validators[name] = callable;
+    return this;
+  }
+  /**
+   * Get validator function by name.
+   * @param name Validator name.
+   * @returns {Validator} A validator function.
+   */
+
+
+  getValidator(name) {
+    if (!this.__validators[name]) {
+      throw new _validationError.default("Validator `" + name + "` does not exist!", name);
+    }
+
+    return this.__validators[name];
+  }
+  /**
+   * Asynchronously validates value.
+   * @param value Value to validate.
+   * @param validators A list of comma-separated validators (eg. required,number,gt:20).
+   * @param [options] Validation options.
+   * @returns {Promise<boolean | ValidationError>}
+   */
+
+
+  async validate(value, validators, options = {}) {
+    if ((0, _isString2.default)(validators) && (0, _isEmpty2.default)(validators)) {
+      return true;
+    }
+
+    if (!(0, _isString2.default)(validators)) {
+      throw new Error(invalidRules);
+    }
+
+    const parsedValidateProperty = this.__parseValidateProperty(validators);
+
+    for (const [name, params] of entries(parsedValidateProperty)) {
+      const validator = this.getValidator(name);
+
+      try {
+        await validator(value, params);
+      } catch (e) {
+        const validationError = new _validationError.default(e.message, name, value);
+
+        if (options.throw === false) {
+          return validationError;
+        }
+
+        throw validationError;
+      }
+    }
+
+    return true;
+  }
+  /**
+   * Synchronously validates value.
+   * @param value Value to validate.
+   * @param validators A list of comma-separated validators (eg. required,number,gt:20).
+   * @param [options] Validation options.
+   * @returns {Promise<boolean | ValidationError>}
+   */
+
+
+  validateSync(value, validators, options = {}) {
+    if ((0, _isString2.default)(validators) && (0, _isEmpty2.default)(validators)) {
+      return true;
+    }
+
+    if (!(0, _isString2.default)(validators)) {
+      throw new Error(invalidRules);
+    }
+
+    const parsedValidateProperty = this.__parseValidateProperty(validators);
+
+    for (const [name, params] of entries(parsedValidateProperty)) {
+      const validator = this.getValidator(name);
+
+      try {
+        validator(value, params);
+      } catch (e) {
+        const validationError = new _validationError.default(e.message, name, value);
+
+        if (options.throw === false) {
+          return validationError;
+        }
+
+        throw validationError;
+      }
+    }
+
+    return true;
+  }
+
+  create(validators) {
+    if (createdValidators.async[validators]) {
+      return createdValidators.async[validators];
+    }
+
+    createdValidators.async[validators] = value => this.validate(value, validators);
+
+    return createdValidators.async[validators];
+  }
+
+  createSync(validators) {
+    if (createdValidators.sync[validators]) {
+      return createdValidators.sync[validators];
+    }
+
+    createdValidators.sync[validators] = value => this.validateSync(value, validators);
+
+    return createdValidators.sync[validators];
+  }
+  /**
+   * Parses a string of validators with parameters.
+   * @param validators A list of comma-separated validators (eg. required,number,gt:20).
+   * @returns {ParsedValidators}
+   * @private
+   */
+
+
+  __parseValidateProperty(validators) {
+    const validate = validators.split(",");
+    const parsedValidators = {};
+    validate.forEach(v => {
+      const params = (0, _trim2.default)(v).split(":");
+      const vName = params.shift();
+      parsedValidators[vName] = params;
+    });
+    return parsedValidators;
+  }
+
+}
+
+var _default = Validation;
+exports.default = _default;
+//# sourceMappingURL=validation.js.map

package/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/validation.ts"],"names":["entries","validators","Object","invalidRules","createdValidators","async","sync","Validation","constructor","__validators","setValidator","name","callable","getValidator","ValidationError","validate","value","options","Error","parsedValidateProperty","__parseValidateProperty","params","validator","e","validationError","message","throw","validateSync","create","createSync","split","parsedValidators","forEach","v","vName","shift"],"mappings":"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","sourcesContent":["import _ from \"lodash\";\nimport ValidationError from \"./validationError\";\nimport { Validator, ValidateOptions, ParsedValidators } from \"./types\";\n\nconst entries = (validators: ParsedValidators): Array<[string, Array<string>]> => {\n    return Object.entries(validators);\n};\n\nconst invalidRules = \"Validators must be specified as a string (eg. required,minLength:10,email).\";\n\nconst createdValidators = {\n    async: {},\n    sync: {}\n};\n\n/**\n * Main class of Validation library.\n * Exported as a singleton instance, it offers methods for sync/async data validation and overwriting or adding new validators.\n *\n * @class Validation\n * @example\n * import { validation } from '@webiny/validation';\n *\n * // `validation` is a preconfigured instance of Validation class.\n * // From here you can either add new validators or use it as-is.\n */\nclass Validation {\n    /**\n     * Contains a list of all set validators.\n     * @private\n     */\n    __validators: { [key: string]: Validator };\n\n    constructor() {\n        this.__validators = {};\n    }\n\n    /**\n     * Add new validator.\n     * @param name Validator name.\n     * @param callable Validator function which throws a ValidationError if validation fails.\n     * @returns {Validation}\n     */\n    setValidator(name: string, callable: Validator): this {\n        this.__validators[name] = callable;\n        return this;\n    }\n\n    /**\n     * Get validator function by name.\n     * @param name Validator name.\n     * @returns {Validator} A validator function.\n     */\n    getValidator(name: string): Validator {\n        if (!this.__validators[name]) {\n            throw new ValidationError(\"Validator `\" + name + \"` does not exist!\", name);\n        }\n        return this.__validators[name];\n    }\n\n    /**\n     * Asynchronously validates value.\n     * @param value Value to validate.\n     * @param validators A list of comma-separated validators (eg. required,number,gt:20).\n     * @param [options] Validation options.\n     * @returns {Promise<boolean | ValidationError>}\n     */\n    async validate(\n        value: any,\n        validators: string,\n        options: ValidateOptions = {}\n    ): Promise<boolean | ValidationError> {\n        if (_.isString(validators) && _.isEmpty(validators)) {\n            return true;\n        }\n\n        if (!_.isString(validators)) {\n            throw new Error(invalidRules);\n        }\n\n        const parsedValidateProperty = this.__parseValidateProperty(validators);\n\n        for (const [name, params] of entries(parsedValidateProperty)) {\n            const validator = this.getValidator(name);\n            try {\n                await validator(value, params);\n            } catch (e) {\n                const validationError = new ValidationError(e.message, name, value);\n                if (options.throw === false) {\n                    return validationError;\n                }\n                throw validationError;\n            }\n        }\n        return true;\n    }\n\n    /**\n     * Synchronously validates value.\n     * @param value Value to validate.\n     * @param validators A list of comma-separated validators (eg. required,number,gt:20).\n     * @param [options] Validation options.\n     * @returns {Promise<boolean | ValidationError>}\n     */\n    validateSync(\n        value: any,\n        validators: string,\n        options: ValidateOptions = {}\n    ): boolean | ValidationError {\n        if (_.isString(validators) && _.isEmpty(validators)) {\n            return true;\n        }\n\n        if (!_.isString(validators)) {\n            throw new Error(invalidRules);\n        }\n\n        const parsedValidateProperty = this.__parseValidateProperty(validators);\n\n        for (const [name, params] of entries(parsedValidateProperty)) {\n            const validator = this.getValidator(name);\n            try {\n                validator(value, params);\n            } catch (e) {\n                const validationError = new ValidationError(e.message, name, value);\n                if (options.throw === false) {\n                    return validationError;\n                }\n                throw validationError;\n            }\n        }\n        return true;\n    }\n\n    create(validators: string) {\n        if (createdValidators.async[validators]) {\n            return createdValidators.async[validators];\n        }\n\n        createdValidators.async[validators] = value => this.validate(value, validators);\n        return createdValidators.async[validators];\n    }\n\n    createSync(validators: string) {\n        if (createdValidators.sync[validators]) {\n            return createdValidators.sync[validators];\n        }\n\n        createdValidators.sync[validators] = value => this.validateSync(value, validators);\n        return createdValidators.sync[validators];\n    }\n\n    /**\n     * Parses a string of validators with parameters.\n     * @param validators A list of comma-separated validators (eg. required,number,gt:20).\n     * @returns {ParsedValidators}\n     * @private\n     */\n    __parseValidateProperty(validators: string): ParsedValidators {\n        const validate: Array<string> = validators.split(\",\");\n\n        const parsedValidators: ParsedValidators = {};\n        validate.forEach((v: string) => {\n            const params = _.trim(v).split(\":\");\n            const vName = params.shift();\n            parsedValidators[vName] = params;\n        });\n        return parsedValidators;\n    }\n}\n\nexport default Validation;\n"],"file":"validation.js"}

package/validationError.d.ts

@@ -0,0 +1,10 @@
+/**
+ * This class is used by validators to throw an error when value validation fails.
+ */
+declare class ValidationError extends Error {
+    message: string;
+    validator: string;
+    value: any;
+    constructor(message?: string, validator?: string, value?: any);
+}
+export default ValidationError;

package/validationError.js

@@ -0,0 +1,30 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+
+/**
+ * This class is used by validators to throw an error when value validation fails.
+ */
+class ValidationError extends Error {
+  constructor(message = "", validator = null, value = null) {
+    super();
+    (0, _defineProperty2.default)(this, "message", void 0);
+    (0, _defineProperty2.default)(this, "validator", void 0);
+    (0, _defineProperty2.default)(this, "value", void 0);
+    this.message = message;
+    this.validator = validator;
+    this.value = value;
+  }
+
+}
+
+var _default = ValidationError;
+exports.default = _default;
+//# sourceMappingURL=validationError.js.map

package/validationError.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/validationError.ts"],"names":["ValidationError","Error","constructor","message","validator","value"],"mappings":";;;;;;;;;;;AAAA;AACA;AACA;AACA,MAAMA,eAAN,SAA8BC,KAA9B,CAAoC;AAKhCC,EAAAA,WAAW,CAACC,OAAO,GAAG,EAAX,EAAeC,SAAiB,GAAG,IAAnC,EAAyCC,KAAK,GAAG,IAAjD,EAAuD;AAC9D;AAD8D;AAAA;AAAA;AAE9D,SAAKF,OAAL,GAAeA,OAAf;AACA,SAAKC,SAAL,GAAiBA,SAAjB;AACA,SAAKC,KAAL,GAAaA,KAAb;AACH;;AAV+B;;eAarBL,e","sourcesContent":["/**\n * This class is used by validators to throw an error when value validation fails.\n */\nclass ValidationError extends Error {\n    message: string;\n    validator: string;\n    value: any;\n\n    constructor(message = \"\", validator: string = null, value = null) {\n        super();\n        this.message = message;\n        this.validator = validator;\n        this.value = value;\n    }\n}\n\nexport default ValidationError;\n"],"file":"validationError.js"}

package/validators/creditCard.d.ts

@@ -0,0 +1,15 @@
+declare const _default: (value: any) => void;
+/**
+ * @name creditCard
+ * @description Credit card validator. This validator will check if the given value is a credit card number.
+ * @param {any} value This is the value that will be validated.
+ * @throws {ValidationError}
+ * @example
+ * import { validation } from '@webiny/validation';
+ * validation.validate('notACreditCard', 'creditCard').then(() => {
+ *  // Valid
+ * }).catch(e => {
+ *  // Invalid
+ * });
+ */
+export default _default;

package/validators/creditCard.js

@@ -0,0 +1,70 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _validationError = _interopRequireDefault(require("./../validationError"));
+
+/**
+ * @name creditCard
+ * @description Credit card validator. This validator will check if the given value is a credit card number.
+ * @param {any} value This is the value that will be validated.
+ * @throws {ValidationError}
+ * @example
+ * import { validation } from '@webiny/validation';
+ * validation.validate('notACreditCard', 'creditCard').then(() => {
+ *  // Valid
+ * }).catch(e => {
+ *  // Invalid
+ * });
+ */
+var _default = value => {
+  if (!value) {
+    return;
+  }
+
+  value = value + "";
+
+  if (value.length < 12) {
+    throw new _validationError.default("Credit card number too short.");
+  }
+
+  if (/[^0-9-\s]+/.test(value)) {
+    throw new _validationError.default("Credit card number invalid.");
+  }
+
+  let nCheck = 0;
+  let nDigit = 0;
+  let bEven = false;
+  value = value.replace(/ /g, "");
+  value = value.replace(/\D/g, "");
+
+  for (let n = value.length - 1; n >= 0; n--) {
+    const cDigit = value.charAt(n);
+    nDigit = parseInt(cDigit);
+
+    if (bEven) {
+      nDigit *= 2;
+
+      if (nDigit > 9) {
+        nDigit -= 9;
+      }
+    }
+
+    nCheck += nDigit;
+    bEven = !bEven;
+  }
+
+  if (nCheck % 10 === 0) {
+    return;
+  }
+
+  throw new _validationError.default("Credit card number invalid.");
+};
+
+exports.default = _default;
+//# sourceMappingURL=creditCard.js.map