verant_id_cloud_scan 1.4.4 → 1.4.5

package/Api.js

@@ -1,6 +1,7 @@
 import { compressAndCompareImages } from "./FaceComparison.js";
 import { formatDateToISO, DATE_FIELDS } from "./DateUtils.js";
 import { FIELD_MAPPING, FIELD_DEFAULTS, getFieldValue } from "./FieldMapping.js";
+import { sanitizeFieldForDmv } from "./FormatUtils.js";
 
 //prod
 const licenseServerAddress = "https://lic.verantid.com/api/v1";
@@ -12,7 +13,7 @@ const dmvServerAddress = "https://dmv.verantid.com/api/v1/dmv_check";
 //   "https://dmv-check-server-staging-fcaab48bec21.herokuapp.com/api/v1/dmv_check";
 
 export const dmvCheck = async (clientId, scannerType, licenseData) => {
-  const url = dmvServerAddress; // make sure dmvServerAddress is defined elsewhere
+  const url = dmvServerAddress;
 
   // Build the driver object dynamically.
   const driver = {};
@@ -36,16 +37,8 @@ export const dmvCheck = async (clientId, scannerType, licenseData) => {
       value = formatDateToISO(value);
     }
 
-    // Convert sex_code from M/F to 1/2 for AAMVA compliance
-    if (fieldName === 'sex_code' && value) {
-      const sexStr = String(value).trim().toUpperCase();
-      if (sexStr === 'M' || sexStr === 'MALE') {
-        value = '1';
-      } else if (sexStr === 'F' || sexStr === 'FEMALE') {
-        value = '2';
-      }
-      // If already 1 or 2, keep as is
-    }
+    // Sanitize field value for DMV/AAMVA submission
+    value = sanitizeFieldForDmv(fieldName, value);
 
     driver[fieldName] = value;
   });

package/CloudScan.js

@@ -210,20 +210,33 @@ function getField(keyword, foundBarcodeString, beginNewline = true) {
     keywordOffset = keyword.length + 1; // +1 for \n
 
     if (foundIndex === -1) {
-      // Try 2: After DL subfile marker
-      foundIndex = foundBarcodeString.indexOf("DL" + keyword);
-      if (foundIndex !== -1) {
+      // Try 2: After DL subfile marker (common for first field on line)
+      const dlIndex = foundBarcodeString.indexOf("DL" + keyword);
+      if (dlIndex !== -1) {
+        // Make sure it's actually after a DL marker, not in the middle of data
+        // Check if "DL" appears right before our keyword
+        foundIndex = dlIndex;
         keywordOffset = keyword.length + 2; // +2 for "DL"
       }
     }
 
     if (foundIndex === -1) {
       // Try 3: After ZO subfile marker
-      foundIndex = foundBarcodeString.indexOf("ZO" + keyword);
-      if (foundIndex !== -1) {
+      const zoIndex = foundBarcodeString.indexOf("ZO" + keyword);
+      if (zoIndex !== -1) {
+        foundIndex = zoIndex;
         keywordOffset = keyword.length + 2; // +2 for "ZO"
       }
     }
+
+    if (foundIndex === -1) {
+      // Try 4: After ZW subfile marker (Washington enhanced licenses)
+      const zwIndex = foundBarcodeString.indexOf("ZW" + keyword);
+      if (zwIndex !== -1) {
+        foundIndex = zwIndex;
+        keywordOffset = keyword.length + 2; // +2 for "ZW"
+      }
+    }
   } else {
     // When beginNewline=false (used for DAQ workaround)
     foundIndex = foundBarcodeString.indexOf(keyword);
@@ -232,21 +245,32 @@ function getField(keyword, foundBarcodeString, beginNewline = true) {
 
   if (foundIndex === -1) return false;
 
-  // Find the next delimiter - could be \n (newline) or \r (carriage return)
-  var nextNewline = foundBarcodeString.indexOf("\n", foundIndex + 1);
-  var nextCarriageReturn = foundBarcodeString.indexOf("\r", foundIndex + 1);
-
-  // Use whichever delimiter comes first (or only one if the other is -1)
-  var m;
-  if (nextNewline === -1) {
-    m = nextCarriageReturn;
-  } else if (nextCarriageReturn === -1) {
-    m = nextNewline;
+  // Find the end of this field's value
+  // Strategy: Look for the next field code (3 uppercase letters starting with D or Z)
+  // Field codes can appear after: newline, carriage return, or space (for jurisdiction-specific Z* fields only)
+
+  const startPos = foundIndex + keywordOffset;
+  const remainingString = foundBarcodeString.substring(startPos);
+
+  // Look for the next field code pattern
+  // Standard field codes: DA*, DB*, DC*, DD*, DE*, DF*, DG*, DH*, DI*, DJ*, DK*, DL*, DM*, DN*, DO*, DP*
+  // Jurisdiction-specific: ZA*, ZB*, ZC*, ..., ZW*, ZX*, ZY*, ZZ*
+  // Pattern matches:
+  // - \nDAA, \nZNB (newline + field code starting with D or Z)
+  // - \rDAA (carriage return + field code)
+  // -  ZWZ (space + field code starting with Z - for jurisdiction codes that may appear mid-line)
+  const nextFieldPattern = /[\n\r]([D][A-Z]{2}|[Z][A-Z]{2})|\s([Z][A-Z]{2})/;
+  const match = remainingString.match(nextFieldPattern);
+
+  let endPos;
+  if (match) {
+    endPos = startPos + match.index;
   } else {
-    m = Math.min(nextNewline, nextCarriageReturn);
+    // No next field found, use end of string
+    endPos = foundBarcodeString.length;
   }
 
-  var subtext = foundBarcodeString.substring(foundIndex + keywordOffset, m);
+  var subtext = foundBarcodeString.substring(startPos, endPos).trim();
   return subtext;
 }
 
@@ -269,13 +293,25 @@ export function extractInformation(foundBarcodeString) {
         resultsArray[item.description] = formatHeightForDisplay(fieldValue);
       }
       // Parse FullName (DAA) into separate FirstName/LastName/MiddleName fields
-      // AAMVA standard format: LastName,FirstName,MiddleName
-      else if (item.description === 'FullName' && fieldValue.includes(',')) {
-        const parts = fieldValue.split(',').map(p => p.trim());
-        // Only set these if they don't already exist (some states use separate fields)
-        if (!resultsArray['LastName'] && parts[0]) resultsArray['LastName'] = parts[0];
-        if (!resultsArray['FirstName'] && parts[1]) resultsArray['FirstName'] = parts[1];
-        if (!resultsArray['MiddleName'] && parts[2]) resultsArray['MiddleName'] = parts[2];
+      else if (item.description === 'FullName') {
+        // AAMVA standard format: LastName,FirstName,MiddleName
+        if (fieldValue.includes(',')) {
+          const parts = fieldValue.split(',').map(p => p.trim());
+          // Only set these if they don't already exist (some states use separate fields)
+          if (!resultsArray['LastName'] && parts[0]) resultsArray['LastName'] = parts[0];
+          if (!resultsArray['FirstName'] && parts[1]) resultsArray['FirstName'] = parts[1];
+          if (!resultsArray['MiddleName'] && parts[2]) resultsArray['MiddleName'] = parts[2];
+        } else {
+          // Some states use space-separated format: "FIRST MIDDLE LAST"
+          const parts = fieldValue.split(/\s+/);
+          if (parts.length >= 2) {
+            if (!resultsArray['FirstName']) resultsArray['FirstName'] = parts[0];
+            if (!resultsArray['LastName']) resultsArray['LastName'] = parts[parts.length - 1];
+            if (parts.length >= 3 && !resultsArray['MiddleName']) {
+              resultsArray['MiddleName'] = parts.slice(1, -1).join(' ');
+            }
+          }
+        }
         // Also store the full name
         resultsArray[item.description] = fieldValue;
       }
@@ -291,6 +327,27 @@ export function extractInformation(foundBarcodeString) {
     }
   }
 
+  // Extract jurisdiction code from ANSI header if not found in fields
+  if (!resultsArray['MailingJurisdictionCode'] && !resultsArray['JurisdictionCode']) {
+    const ansiMatch = foundBarcodeString.match(/^ANSI\s+(\d{6})/);
+    if (ansiMatch) {
+      const issuerCode = ansiMatch[1];
+      // Map AAMVA IIN (Issuer Identification Number) to state codes
+      const iinToState = {
+        '636038': 'OH', // Ohio
+        '636026': 'CT', // Connecticut
+        '636045': 'WA', // Washington
+        '636036': 'NJ', // New Jersey
+        '636005': 'SC', // South Carolina
+        // Add more as needed
+      };
+      const state = iinToState[issuerCode];
+      if (state) {
+        resultsArray['MailingJurisdictionCode'] = state;
+      }
+    }
+  }
+
   return resultsArray;
 }
 

package/FormatUtils.js

@@ -1,6 +1,6 @@
 /**
  * FormatUtils.js
- * Utility functions for formatting barcode field data for display
+ * Utility functions for formatting barcode field data for display and AAMVA submission
  */
 
 /**
@@ -52,3 +52,147 @@ export function formatHeightForDisplay(height) {
   // Return original value for any other format
   return height;
 }
+
+/**
+ * Sanitizes field values for DMV/AAMVA submission
+ * Cleans up common issues with barcode data to ensure AAMVA acceptance
+ * @param {string} fieldName - The standardized field name (e.g., 'height', 'sex_code')
+ * @param {string} value - The field value to sanitize
+ * @returns {string} Sanitized value ready for AAMVA submission
+ */
+export function sanitizeFieldForDmv(fieldName, value) {
+  if (!value) return value;
+
+  switch (fieldName) {
+    case 'height':
+      return sanitizeHeight(value);
+
+    case 'sex_code':
+      return sanitizeSexCode(value);
+
+    case 'eye_color':
+      return sanitizeEyeColor(value);
+
+    case 'license_number':
+      return sanitizeLicenseNumber(value);
+
+    case 'postal_code':
+      return sanitizePostalCode(value);
+
+    case 'last_name':
+      return sanitizeLastName(value);
+
+    default:
+      return value;
+  }
+}
+
+/**
+ * Converts height to total inches for AAMVA
+ * Handles formats: "509" (5'9"), "066 in" (66 inches), "067" (67 inches)
+ * @param {string} height - Height value from barcode
+ * @returns {string} Total inches as numeric string
+ */
+function sanitizeHeight(height) {
+  let heightStr = String(height).trim();
+
+  // Remove " in", " cm", or any other suffix
+  heightStr = heightStr.replace(/\s*(in|cm|IN|CM)\s*$/i, '').trim();
+
+  // Check if it's in AAMVA 3-digit feet/inches format (e.g., "509" = 5'09")
+  if (/^\d{3}$/.test(heightStr)) {
+    const feet = parseInt(heightStr.charAt(0), 10);
+    const inches = parseInt(heightStr.substring(1), 10);
+    return String(feet * 12 + inches); // Convert to total inches
+  }
+
+  // If it's already a numeric value (with possible leading zeros), parse it
+  if (/^\d+$/.test(heightStr)) {
+    return String(parseInt(heightStr, 10)); // Remove leading zeros
+  }
+
+  // Otherwise keep as-is
+  return height;
+}
+
+/**
+ * Converts sex code from M/F to 1/2 for AAMVA
+ * @param {string} sexCode - Sex code from barcode
+ * @returns {string} AAMVA numeric code (1=Male, 2=Female)
+ */
+function sanitizeSexCode(sexCode) {
+  const sexStr = String(sexCode).trim().toUpperCase();
+
+  if (sexStr === 'M' || sexStr === 'MALE') {
+    return '1';
+  } else if (sexStr === 'F' || sexStr === 'FEMALE') {
+    return '2';
+  }
+
+  // If already 1 or 2, keep as is
+  return sexCode;
+}
+
+/**
+ * Validates eye color against AAMVA standard codes and logs an error if invalid
+ * Only transforms BRN → BRO (known alternative spelling for Brown)
+ * Example: "BRN" → "BRO"
+ * @param {string} eyeColor - Eye color from barcode
+ * @returns {string} Eye color value (unchanged unless BRN)
+ */
+function sanitizeEyeColor(eyeColor) {
+  // AAMVA-accepted eye color codes (official list)
+  const VALID_EYE_COLORS = ['BLK', 'BLU', 'BRO', 'DIC', 'GRY', 'GRN', 'HAZ', 'MAR', 'PNK', 'UNK'];
+
+  let value = String(eyeColor).trim();
+
+  // Map BRN → BRO (known alternative spelling for Brown)
+  if (value === 'BRN') {
+    value = 'BRO';
+  }
+
+  // Validate against AAMVA standard list and log error if invalid
+  if (!VALID_EYE_COLORS.includes(value)) {
+    console.error(
+      `[AAMVA Validation Error] Eye color "${value}" is not a valid AAMVA code. ` +
+      `Accepted values: BLK (Black), BLU (Blue), BRO (Brown), DIC (Dichromatic), ` +
+      `GRY (Gray), GRN (Green), HAZ (Hazel), MAR (Maroon), PNK (Pink), UNK (Unknown). ` +
+      `DMV verification will likely fail.`
+    );
+  }
+
+  return value;
+}
+
+/**
+ * Trims leading and trailing spaces from license number
+ * Preserves internal spaces as some jurisdictions may require them
+ * Example: "  QWE 234 KHL   " → "QWE 234 KHL"
+ * @param {string} licenseNumber - License number from barcode
+ * @returns {string} License number with leading/trailing spaces removed
+ */
+function sanitizeLicenseNumber(licenseNumber) {
+  return String(licenseNumber).trim();
+}
+
+/**
+ * Sanitizes postal code by removing dashes and trimming spaces
+ * AAMVA may not accept dashes in zip codes
+ * Example: "08223-1518" → "082231518", "  12345  " → "12345"
+ * @param {string} postalCode - Postal code from barcode
+ * @returns {string} Sanitized postal code without dashes or extra spaces
+ */
+function sanitizePostalCode(postalCode) {
+  return String(postalCode).replace(/-/g, '').trim();
+}
+
+/**
+ * Sanitizes last name by removing spaces (combines suffix with last name)
+ * When suffix is included in last name field, remove spaces for AAMVA
+ * Example: "MYLAST JR" → "MYLASTJR", "O'BRIEN III" → "O'BRIENIII"
+ * @param {string} lastName - Last name from barcode
+ * @returns {string} Last name with spaces removed
+ */
+function sanitizeLastName(lastName) {
+  return String(lastName).replace(/\s+/g, '');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "verant_id_cloud_scan",
-  "version": "1.4.4",
+  "version": "1.4.5",
   "description": "Verant ID Cloud Scan NPM Library",
   "main": "CloudScan.js",
   "types": "index.d.ts",