Merge 80a21c8 into 1795778

README.md

@@ -45,6 +45,18 @@ isOld("GI-1234-BL"); //=> true
 isOld("DGP 1234 BL"); //=> true
 ```
 
+### isSpecial()
+
+Police, Air force, Army, Navy, etc. have special plates.
+
+```js
+import { isSpecial } from "spanish-car-plate";
+
+isSpecial("DGP 3874"); //=> true
+isSpecial("CNP-5764"); //=> true
+isSpecial("E8720"); //=> true
+```
+
 ### getCounter()
 
 ```js
@@ -78,6 +90,23 @@ getProvinceCode("M 1234 BL"); //=> "M"
 getProvinceCode("SO-1234 BL"); //=> "SO"
 ```
 
+### getSpecialCode()
+
+```js
+import { getSpecialCode } from "spanish-car-plate";
+
+getSpecialCode("DGP1234"); //=> "DGP"
+```
+
+### getSpecialName()
+
+```js
+import { getSpecialName } from "spanish-car-plate";
+
+getSpecialName("DGP1234"); //=> "Spanish Police"
+getSpecialName("CME1234"); //=> "Corps of the Mossos d'Esquadra"
+```
+
 ### parse()
 
 Get all the information about the plate

package.json

@@ -1,6 +1,6 @@
 {
   "name": "spanish-car-plate",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "Spanish Car Plate validation",
   "main": "dist/index.js",
   "license": "MIT",

src/_utils.js

@@ -1,3 +1,12 @@
+export function _partsSpecial(str) {
+  const cleaned = str.replace(
+    /^[\s]*([CMEDGPNATFSHMORW]{1,5})[^A-Z0-9]*([0-9]{4})[\s]*$/i,
+    "$1,$2"
+  );
+
+  return cleaned.split(",");
+}
+
 export function _partsOld(str) {
   const cleaned = str.replace(
     /^[\s]*([A-Z]{1,3})[^A-Z0-9]*([0-9]{4})[^A-Z0-9]*([A-Z]{2})[\s]*$/i,

src/getNumber.js

@@ -1,6 +1,7 @@
 import { isOld } from "./isOld";
 import { isValid } from "./isValid";
-import { _partsNew, _partsOld } from "./_utils";
+import { isSpecial } from "./isSpecial";
+import { _partsNew, _partsOld, _partsSpecial } from "./_utils";
 
 /**
  *
@@ -17,6 +18,9 @@ function getNumber(value) {
   if (isOld(str) === true) {
     const [, num] = _partsOld(str);
     return parseInt(num, 10);
+  } else if (isSpecial(str) === true) {
+    const [, num] = _partsSpecial(str);
+    return parseInt(num, 10);
   } else if (isValid(str)) {
     const [num] = _partsNew(str);
     return parseInt(num, 10);

src/getSpecialCode.js

@@ -0,0 +1,25 @@
+import { SPECIALS } from "./specials";
+import { isSpecial } from "./isSpecial";
+import { _partsSpecial } from "./_utils";
+
+/**
+ * Returns the special code for a valid car plate
+ * @param {string} value
+ * @returns {string}
+ * @since 0.0.7
+ * @example
+ * getSpecialCode("DGP-1234"); // => "DGP"
+ */
+function getSpecialCode(value) {
+  const str = !value ? "" : value;
+
+  if (!isSpecial(str)) {
+    return null;
+  }
+
+  const [code] = _partsSpecial(str);
+
+  return SPECIALS[code] ? code : null;
+}
+
+export { getSpecialCode };

src/getSpecialName.js

@@ -0,0 +1,19 @@
+import { SPECIALS } from "./specials";
+import { getSpecialCode } from "./getSpecialCode";
+
+/**
+ * Returns the special name for a valid car plate
+ * @param {string} value
+ * @returns {string}
+ * @since 0.0.7
+ * @example
+ * getSpecialCode("CME1234"); // => "Corps of the Mossos d'Esquadra"
+ */
+function getSpecialName(value) {
+  const str = !value ? "" : value;
+  const code = getSpecialCode(str);
+
+  return SPECIALS[code] || null;
+}
+
+export { getSpecialName };

src/index.js

@@ -1,8 +1,12 @@
 export { isValid } from "./isValid";
 export { isOld } from "./isOld";
+export { isSpecial } from "./isSpecial";
 export { getCounter } from "./getCounter";
 export { getNumber } from "./getNumber";
+export { getSpecialCode } from "./getSpecialCode";
+export { getSpecialName } from "./getSpecialName";
 export { getProvinceName } from "./getProvinceName";
 export { getProvinceCode } from "./getProvinceCode";
 export { parse } from "./parse";
 export { PROVINCES } from "./provinces";
+export { SPECIALS } from "./specials";

src/isSpecial.js

@@ -0,0 +1,29 @@
+import { _partsSpecial } from "./_utils";
+import { SPECIALS } from "./specials";
+
+/**
+ * Returns true if is a valid spacial car plate
+ * @param {string} value
+ * @returns {boolean}
+ * @since 0.0.7
+ * @example
+ * isSpecial("CME 2342"); // => true
+ * isSpecial("E 1660"); // => true
+ */
+function isSpecial(value) {
+  const str = !value ? "" : value;
+  const [code, num] = _partsSpecial(str);
+  const cleaned = `${code}${num}`;
+
+  if (cleaned.length < 5 || cleaned.length > 9) {
+    return false;
+  }
+
+  if (!SPECIALS[code]) {
+    return false;
+  }
+
+  return /^[CMEDGPNATFSHMORW]{1,5}[0-9]{4}$/i.test(cleaned);
+}
+
+export { isSpecial };