verant_id_cloud_scan 1.4.5-beta.4 → 1.4.5-beta.6

package/Api.js

@@ -4,47 +4,98 @@ import { FIELD_MAPPING, FIELD_DEFAULTS, getFieldValue } from "./FieldMapping.js"
 import { sanitizeFieldForDmv } from "./FormatUtils.js";
 
 /**
- * Environment Detection
+ * Environment Detection & Management
  *
- * Automatically detects staging vs production based on hostname.
- * Defaults to PRODUCTION for backwards compatibility with existing customers.
- * Only switches to staging for VerantID's own staging domains.
+ * Defaults to PRODUCTION for all hosts (including localhost).
+ * Only verify-staging.verantid.com automatically uses staging.
+ * Host apps can explicitly override via setEnvironment('staging' | 'production').
  */
-function getEnvironment() {
-  // Default to production for safety and backwards compatibility
+
+// Current environment - starts as null to trigger detection on first use
+let currentEnvironment = null;
+
+/**
+ * Detect environment based on hostname
+ * @returns {'staging' | 'production'}
+ */
+function detectEnvironment() {
+  // Default to production for all hosts
   let environment = 'production';
 
-  // Only override to staging if explicitly on a VerantID staging domain
+  // Only auto-switch to staging for VerantID's staging domain
   if (typeof window !== 'undefined') {
     const hostname = window.location.hostname;
 
-    // ONLY switch to staging for VerantID's own staging domains
-    if (hostname === 'verify-staging.verantid.com' ||
-        hostname === 'localhost' ||
-        hostname === '127.0.0.1' ||
-        hostname.startsWith('localhost:')) {
+    // ONLY verify-staging.verantid.com uses staging by default
+    if (hostname === 'verify-staging.verantid.com') {
       environment = 'staging';
     }
 
-    // All other hostnames (customer sites, verify.verantid.com, etc.) use production
+    // All other hostnames (localhost, customer sites, verify.verantid.com, etc.) use production
   }
 
   console.log('[CloudScan] Environment detected:', environment, 'on', typeof window !== 'undefined' ? window.location.hostname : 'server');
   return environment;
 }
 
-const env = getEnvironment();
+/**
+ * Get current environment (detects if not already set)
+ * @returns {'staging' | 'production'}
+ */
+function getEnvironment() {
+  if (currentEnvironment === null) {
+    currentEnvironment = detectEnvironment();
+  }
+  return currentEnvironment;
+}
 
-const licenseServerAddress = env === 'staging'
-  ? "https://lic-staging.verantid.com/api/v1"
-  : "https://lic.verantid.com/api/v1";
+/**
+ * Explicitly set the environment
+ * @param {'staging' | 'production'} environment
+ * @throws {Error} If environment is not 'staging' or 'production'
+ */
+export function setEnvironment(environment) {
+  if (environment !== 'staging' && environment !== 'production') {
+    throw new Error(`Invalid environment: "${environment}". Must be "staging" or "production".`);
+  }
+  currentEnvironment = environment;
+}
+
+/**
+ * Get license server address based on current environment
+ * @returns {string}
+ */
+function getLicenseServerAddress() {
+  const env = getEnvironment();
+  return env === 'staging'
+    ? "https://lic-staging.verantid.com/api/v1"
+    : "https://lic.verantid.com/api/v1";
+}
+
+/**
+ * Get DMV server address based on current environment
+ * @returns {string}
+ */
+function getDmvServerAddress() {
+  const env = getEnvironment();
+  return env === 'staging'
+    ? "https://dmv-check-server-staging-fcaab48bec21.herokuapp.com/api/v1/dmv_check"
+    : "https://dmv.verantid.com/api/v1/dmv_check";
+}
 
-const dmvServerAddress = env === 'staging'
-  ? "https://dmv-check-server-staging-fcaab48bec21.herokuapp.com/api/v1/dmv_check"
-  : "https://dmv.verantid.com/api/v1/dmv_check";
+/**
+ * Get Face Comparison server address based on current environment
+ * @returns {string}
+ */
+export function getFaceComparisonServerAddress() {
+  const env = getEnvironment();
+  return env === 'staging'
+    ? "https://staging.face.verantid.bluerocket.us/compare_id_and_face"
+    : "https://faceid.verantid.com/compare_id_and_face";
+}
 
 export const dmvCheck = async (clientId, scannerType, licenseData) => {
-  const url = dmvServerAddress;
+  const url = getDmvServerAddress();
 
   // Build the driver object dynamically.
   const driver = {};
@@ -135,7 +186,7 @@ export const dmvCheck = async (clientId, scannerType, licenseData) => {
 };
 
 export const checkDmvFeatureLicense = async (clientId) => {
-  const url = licenseServerAddress + "/dmv_verifications/check_license";
+  const url = getLicenseServerAddress() + "/dmv_verifications/check_license";
   const data = { client_id: clientId };
 
   try {
@@ -169,7 +220,7 @@ export const checkDmvFeatureLicense = async (clientId) => {
 };
 
 export const checkFaceComparisonFeatureLicense = async (clientId) => {
-  const url = licenseServerAddress + "/facial_scans/check_license";
+  const url = getLicenseServerAddress() + "/facial_scans/check_license";
   const data = { client_id: clientId };
 
   try {
@@ -203,7 +254,7 @@ export const checkFaceComparisonFeatureLicense = async (clientId) => {
 }
 
 export const checkLicense = async (clientId, macAddress) => {
-  const url = licenseServerAddress + "/check_license";
+  const url = getLicenseServerAddress() + "/check_license";
   const data = { client_id: clientId, mac_address: macAddress };
 
   try {
@@ -238,7 +289,7 @@ export const checkLicense = async (clientId, macAddress) => {
  * @returns {Promise<boolean>} True if autoDmv is enabled
  */
 export const checkAutoDmvEnabled = async (clientId) => {
-    const url = licenseServerAddress + "/check_feature_license";
+    const url = getLicenseServerAddress() + "/check_feature_license";
     const data = { client_id: clientId };
 
     try {
@@ -263,7 +314,7 @@ export const checkAutoDmvEnabled = async (clientId) => {
     }
   };
 export const getBarcodeLicenseKey = async () => {
-  const url = licenseServerAddress + "/get_barcode_license_key";
+  const url = getLicenseServerAddress() + "/get_barcode_license_key";
 
   try {
     const response = await fetch(url, {

package/CHANGELOG.md

@@ -0,0 +1,66 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.4.5-beta.6] - 2026-04-15
+
+### Added
+- UV/IR image support for IDXpressPlus scanner profile
+  - Added `licenseFrontUvBase64`, `licenseBackUvBase64`, `licenseFrontIrBase64`, and `licenseBackIrBase64` fields to scan results
+  - Scanner now captures and returns ultraviolet (UV) and infrared (IR) images alongside standard color images
+  - Image types supported: fclr (front color), rclr (rear color), fclruv (front UV), rclruv (rear UV), fgsir (front IR), rgsir (rear IR)
+
+### Fixed
+- UV/IR parameters no longer restored to disabled state after scanning
+  - Removed `fclrUvEnabled`, `rclrUvEnabled`, `fgsIrEnabled`, and `rgsIrEnabled` from `restoreParamKeys` in IDXpressPlus profile
+- Image extraction logic now captures all image types from scanner response instead of only front/back color images
+
+### Changed
+- Updated `ScannerApi.js` to extract UV/IR images from GetDocument response
+- Updated `CloudScan.js` public API functions (`scanId`, `localScanId`, `localContinueScanId`) to return UV/IR image data
+
+## [1.4.5-beta.5] - 2026-04-14
+
+### Changed
+- Applied dynamic environment URLs to face comparison feature
+
+## [1.4.5-beta.4] - 2026-04-14
+
+### Added
+- Error validation for invalid environment type
+
+### Changed
+- Updated default server URLs to production endpoints
+
+## [1.4.5-beta.3] - 2026-04-13
+
+### Fixed
+- Various bug fixes and code quality improvements
+
+## [1.4.5-beta.2] - 2026-04-12
+
+### Added
+- Dynamic environment detection for server URLs
+- Support for multiple deployment environments
+
+### Changed
+- Server address handling now supports trailing slashes
+- Code improvements based on Copilot suggestions
+
+## [1.4.5-beta.1] - 2026-04-11
+
+### Added
+- IDXpress scanner profiles support
+- New scanner profile configuration options
+
+---
+
+## Version Number Guide
+
+- **Major** (1.x.x): Breaking changes
+- **Minor** (x.4.x): New features, backwards compatible
+- **Patch** (x.x.5): Bug fixes, backwards compatible
+- **Beta** (x.x.x-beta.x): Pre-release versions for testing

package/CloudScan.js

@@ -15,7 +15,7 @@ import {
   scannerPresent,
 } from "./ScannerApi.js";
 import { VerificationModal } from "./VerificationModal.js";
-import { checkAutoDmvEnabled } from "./Api.js";
+import { checkAutoDmvEnabled, setEnvironment } from "./Api.js";
 import { formatSexCodeForDisplay, formatHeightForDisplay } from "./FormatUtils.js";
 
 let cachedLicenseFrontBase64 = "";
@@ -36,7 +36,7 @@ export const checkFaceCompareFeature = async (clientId) => {
   return await checkFaceComparisonFeatureLicense(clientId);
 }
 
-export { scannerPresent };
+export { scannerPresent, setEnvironment };
 
 export async function readImageBarcode(imageFile, clientId = null, scannerType = 'Upload') {
   let returnObj = {
@@ -119,6 +119,10 @@ export const scanId = async (
     barcodeResultsObject,
     licenseFrontBase64: "",
     licenseBackBase64: "",
+    licenseFrontUvBase64: "",
+    licenseBackUvBase64: "",
+    licenseFrontIrBase64: "",
+    licenseBackIrBase64: "",
     errorMessages: "",
   };
   let barcodelicenseKey = await getBarcodeLicenseKey();
@@ -148,6 +152,10 @@ export const scanId = async (
 
   returnObj.licenseFrontBase64 = scannerResponseObj.licenseFrontBase64;
   returnObj.licenseBackBase64 = scannerResponseObj.licenseBackBase64;
+  returnObj.licenseFrontUvBase64 = scannerResponseObj.licenseFrontUvBase64;
+  returnObj.licenseBackUvBase64 = scannerResponseObj.licenseBackUvBase64;
+  returnObj.licenseFrontIrBase64 = scannerResponseObj.licenseFrontIrBase64;
+  returnObj.licenseBackIrBase64 = scannerResponseObj.licenseBackIrBase64;
 
   if (includeData && scannerResponseObj.licenseBackBase64) {
     var img = document.createElement("img");
@@ -357,6 +365,10 @@ export const localScanId = async (scannerAddress, clientId) => {
     barcodeResultsObject,
     licenseFrontBase64: "",
     licenseBackBase64: "",
+    licenseFrontUvBase64: "",
+    licenseBackUvBase64: "",
+    licenseFrontIrBase64: "",
+    licenseBackIrBase64: "",
     errorMessages: "",
   };
 
@@ -381,6 +393,10 @@ export const localContinueScanId = async (scannerAddress, includeData, clientId
     barcodeResultsObject,
     licenseFrontBase64: "",
     licenseBackBase64: "",
+    licenseFrontUvBase64: "",
+    licenseBackUvBase64: "",
+    licenseFrontIrBase64: "",
+    licenseBackIrBase64: "",
     errorMessages: "",
   };
 

package/FaceComparison.js

@@ -1,7 +1,4 @@
-//prod
-const faceComparisonAddress = "https://faceid.verantid.com/compare_id_and_face";
-//staging
-// const faceComparisonAddress = "https://staging.face.verantid.bluerocket.us/compare_id_and_face";
+import { getFaceComparisonServerAddress } from "./Api.js";
 
 
 export async function compressImage(source, maxSize = 2 * 1024 * 1024) {
@@ -42,6 +39,7 @@ export async function compressImage(source, maxSize = 2 * 1024 * 1024) {
 }
 
 const startComparison = async (commandObj) => {
+  const faceComparisonAddress = getFaceComparisonServerAddress();
   return fetch(faceComparisonAddress, {
     method: "POST",
     headers: { "Content-Type": "application/json" },

package/ScannerApi.js

@@ -178,11 +178,19 @@ export async function scannerChain(
     scanDataResults: resultData,
     licenseFrontBase64: frontBase64,
     licenseBackBase64: backBase64,
+    licenseFrontUvBase64: frontUvBase64,
+    licenseBackUvBase64: backUvBase64,
+    licenseFrontIrBase64: frontIrBase64,
+    licenseBackIrBase64: backIrBase64,
   } = await startScanDocument(currentSessionId, profile, optGetDocumentParams);
 
   scanDataResults = resultData;
   licenseFrontBase64 = frontBase64;
   licenseBackBase64 = backBase64;
+  const licenseFrontUvBase64 = frontUvBase64;
+  const licenseBackUvBase64 = backUvBase64;
+  const licenseFrontIrBase64 = frontIrBase64;
+  const licenseBackIrBase64 = backIrBase64;
 
   if (!scanSuccess) {
     await closeScannerConnection(currentSessionId);
@@ -221,6 +229,10 @@ export async function scannerChain(
     scanDataResults,
     licenseFrontBase64: licenseFrontBase64,
     licenseBackBase64: licenseBackBase64,
+    licenseFrontUvBase64: licenseFrontUvBase64,
+    licenseBackUvBase64: licenseBackUvBase64,
+    licenseFrontIrBase64: licenseFrontIrBase64,
+    licenseBackIrBase64: licenseBackIrBase64,
     scannerProfile: profileName,
     errorMessages,
   };
@@ -390,16 +402,30 @@ async function startScanDocument(
     let scanDataResults = responseData;
     let licenseFrontBase64 = "";
     let licenseBackBase64 = "";
+    let licenseFrontUvBase64 = "";
+    let licenseBackUvBase64 = "";
+    let licenseFrontIrBase64 = "";
+    let licenseBackIrBase64 = "";
 
     const images = responseData.Images || [];
 
     // Check and set image data using profile-defined image types
     images.forEach((element) => {
-      if (element["ImageType"] === profile.frontImageType) {
-        licenseFrontBase64 = element["data"];
-      }
-      if (element["ImageType"] === profile.backImageType) {
-        licenseBackBase64 = element["data"];
+      const imageType = element["ImageType"];
+      const imageData = element["data"];
+
+      if (imageType === profile.frontImageType) {
+        licenseFrontBase64 = imageData;
+      } else if (imageType === profile.backImageType) {
+        licenseBackBase64 = imageData;
+      } else if (imageType === "fclruv") {
+        licenseFrontUvBase64 = imageData;
+      } else if (imageType === "rclruv") {
+        licenseBackUvBase64 = imageData;
+      } else if (imageType === "fgsir") {
+        licenseFrontIrBase64 = imageData;
+      } else if (imageType === "rgsir") {
+        licenseBackIrBase64 = imageData;
       }
     });
 
@@ -408,6 +434,10 @@ async function startScanDocument(
       scanDataResults,
       licenseFrontBase64,
       licenseBackBase64,
+      licenseFrontUvBase64,
+      licenseBackUvBase64,
+      licenseFrontIrBase64,
+      licenseBackIrBase64,
     };
   }
 
@@ -416,6 +446,10 @@ async function startScanDocument(
     scanDataResults: null,
     licenseFrontBase64: "",
     licenseBackBase64: "",
+    licenseFrontUvBase64: "",
+    licenseBackUvBase64: "",
+    licenseFrontIrBase64: "",
+    licenseBackIrBase64: "",
   };
 }
 

package/ScannerProfiles.js

@@ -80,6 +80,11 @@ const PROFILES = {
       fclrEnabled: "true",
       rgsEnabled: "false",
       rclrEnabled: "true",
+      clrUvIrResolution: "600dpi",
+      fclrUvEnabled: "true",
+      rclrUvEnabled: "true",
+      fgsIrEnabled: "true",
+      rgsIrEnabled: "true",
     },
     restoreParamKeys: [
       "FeedType",
@@ -93,6 +98,11 @@ const PROFILES = {
       "rgsEnabled",
       "rgsResolution",
       "rclrCompressionQuality",
+      "clrUvIrResolution",
+      "fclrUvEnabled",
+      "rclrUvEnabled",
+      "fgsIrEnabled",
+      "rgsIrEnabled",
     ],
     frontImageType: "fclr",
     backImageType: "rclr",

package/index.d.ts

@@ -77,3 +77,11 @@ declare module "verant_id_cloud_scan" {
 }
 
 export function scannerPresent(scannerAddress: string): Promise<boolean>;
+
+/**
+ * Explicitly set the API environment.
+ * By default, production is used for all hosts (including localhost).
+ * Only verify-staging.verantid.com automatically uses staging.
+ * @param environment - 'staging' or 'production'
+ */
+export function setEnvironment(environment: 'staging' | 'production'): void;

package/package.json

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