verant_id_cloud_scan 1.4.5-beta.4 → 1.4.5-beta.5

package/Api.js

@@ -4,47 +4,87 @@ 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";
+}
 
-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 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";
+}
 
 export const dmvCheck = async (clientId, scannerType, licenseData) => {
-  const url = dmvServerAddress;
+  const url = getDmvServerAddress();
 
   // Build the driver object dynamically.
   const driver = {};
@@ -135,7 +175,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 +209,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 +243,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 +278,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 +303,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/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 = {

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.5",
   "description": "Verant ID Cloud Scan NPM Library",
   "main": "CloudScan.js",
   "types": "index.d.ts",