@safepassage/sdk 3.0.4 → 3.0.6

package/dist/safepassage.min.js

@@ -1,3 +1,3 @@
-/* SafePassage SDK v3.0.4 - Redirect Implementation with Enhanced Security */
-"use strict";var SafePassageSDK=(()=>{var u=Object.defineProperty;var G=Object.getOwnPropertyDescriptor;var J=Object.getOwnPropertyNames;var X=Object.prototype.hasOwnProperty;var p=(t,e)=>()=>(t&&(e=t(t=0)),e);var g=(t,e)=>{for(var n in e)u(t,n,{get:e[n],enumerable:!0})},Y=(t,e,n,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of J(e))!X.call(t,r)&&r!==n&&u(t,r,{get:()=>e[r],enumerable:!(i=G(e,r))||i.enumerable});return t};var P=t=>Y(u({},"__esModule",{value:!0}),t);function z(t,e){return T[e].includes(t)}function b(t,e,n=[]){let{origin:i}=t;return z(i,e)||n.length>0&&n.some(o=>{if(o.startsWith("*.")){let s=o.slice(2);return i.endsWith(`.${s}`)||i===`https://${s}`||i===`http://${s}`}return i===o})?!0:(console.warn(`SafePassage Security: Blocked PostMessage from untrusted origin: ${i}`,{environment:e,trustedOrigins:T[e],allowedCustomOrigins:n,eventType:t.data?.type}),!1)}function x(t,e){let{data:n}=t;return!n||typeof n!="object"?{isValid:!1,error:"Invalid message format"}:n.type!=="safepassage:verification:complete"?{isValid:!1,error:"Invalid message type"}:!n.sessionId||n.sessionId!==e?{isValid:!1,error:"Session ID mismatch"}:!n.status||!["verified","failed","cancelled"].includes(n.status)?{isValid:!1,error:"Invalid status value"}:{isValid:!0}}function V(t){if(t==="production"&&window.location.protocol!=="https:"){let e=window.location.href.replace("http:","https:");console.error("SafePassage Security: HTTPS required in production. Redirecting...",{current:window.location.href,redirect:e}),window.location.replace(e)}}function h(t,e){try{let n=new URL(t);if(e==="production"&&n.protocol!=="https:")return{isValid:!1,error:"HTTPS required for return URLs in production"};if(e==="development"&&!(n.hostname==="localhost"||n.hostname==="127.0.0.1"||n.hostname.endsWith(".local"))&&n.protocol!=="https:")return{isValid:!1,error:"Non-localhost URLs must use HTTPS"};if(e==="staging"&&n.protocol!=="https:")return{isValid:!1,error:"HTTPS required for return URLs in staging"};let i=[/data:/i,/javascript:/i,/vbscript:/i,/file:/i,/ftp:/i];for(let r of i)if(r.test(t))return{isValid:!1,error:"Blocked suspicious URL scheme"};return{isValid:!0}}catch{return{isValid:!1,error:"Invalid URL format"}}}function a(t,e){console.warn(`SafePassage Security Event: ${t}`,{timestamp:new Date().toISOString(),userAgent:navigator.userAgent,url:window.location.href,...e})}var T,f,L,m=p(()=>{"use strict";T={production:["https://verify.safepassageapp.com","https://portal.safepassageapp.com","https://api.safepassageapp.com"],staging:["https://verify-staging.safepassageapp.com","https://portal-staging.safepassageapp.com","https://api-staging.safepassageapp.com"],development:["http://localhost:5173","http://localhost:3000","http://localhost:3001","http://localhost:3002","http://127.0.0.1:5173","http://127.0.0.1:3000","http://127.0.0.1:3001","http://127.0.0.1:3002"]};f=class{constructor(){this.attempts=new Map;this.maxAttempts=5;this.timeWindow=6e4}isAllowed(e){let n=Date.now(),r=(this.attempts.get(e)||[]).filter(o=>n-o<this.timeWindow);return r.length>=this.maxAttempts?(console.warn(`SafePassage Security: Rate limit exceeded for ${e}`),!1):(r.push(n),this.attempts.set(e,r),!0)}reset(e){this.attempts.delete(e)}},L=new f});var R={};g(R,{createSignedState:()=>Q,generateHMAC:()=>w,generateSecureToken:()=>M,getSigningSecret:()=>v,parseSignedState:()=>ee,verifyHMAC:()=>C});async function w(t,e){let n=new TextEncoder,i=n.encode(e),r=n.encode(t),o=await crypto.subtle.importKey("raw",i,{name:"HMAC",hash:"SHA-256"},!1,["sign"]),s=await crypto.subtle.sign("HMAC",o,r);return Array.from(new Uint8Array(s)).map(l=>l.toString(16).padStart(2,"0")).join("")}async function C(t,e,n){try{let i=await w(t,n);return Z(e,i)}catch{return!1}}function Z(t,e){if(t.length!==e.length)return!1;let n=0;for(let i=0;i<t.length;i++)n|=t.charCodeAt(i)^e.charCodeAt(i);return n===0}function M(t=32){let e=new Uint8Array(t);return crypto.getRandomValues(e),Array.from(e,n=>n.toString(16).padStart(2,"0")).join("")}function v(t){return{production:"safepassage-prod-hmac-2025",staging:"safepassage-stage-hmac-2025",development:"safepassage-dev-hmac-2025"}[t]}async function Q(t,e){let n={...t,timestamp:Date.now(),nonce:M(16)},i=JSON.stringify(n),r=v(e),o=await w(i,r);return btoa(JSON.stringify({data:n,signature:o}))}async function ee(t,e,n=D){try{let i=atob(t),r=JSON.parse(i);if(!r.data||!r.signature)return console.warn("SafePassage: Invalid signed state format"),null;let{data:o,signature:s}=r,l=JSON.stringify(o),F=v(e);if(!await C(l,s,F))return console.warn("SafePassage: State signature verification failed"),null;if(o.timestamp){let E=Date.now()-o.timestamp;if(E>n)return console.warn("SafePassage: State parameter expired",{age:E,maxAge:n}),null}let{timestamp:ce,nonce:le,...B}=o;return B}catch(i){return console.warn("SafePassage: Failed to parse signed state",i),null}}var _=p(()=>{"use strict";S()});function k(t){if(!t.apiKey)throw new Error("apiKey is required");if(t.apiKey.length>N)throw new Error(`apiKey exceeds maximum length of ${N} characters`);if(!te.test(t.apiKey))throw new Error("Invalid apiKey format. Expected pk_xxx (public) or sk_xxx (private)");if(typeof window<"u"&&t.apiKey.startsWith("sk_"))throw new Error("Secret keys (sk_) should never be used in browser code for security reasons. Secret keys expose your account to unauthorized access if used client-side. Please use your public key (pk_) instead. If you need to use features that require a secret key (like custom challenge age), create the session server-side and pass the sessionId to startVerificationWithSession(). See: https://docs.safepassageapp.com/server-side-sessions");if(!t.returnUrl)throw new Error("returnUrl is required");if(t.returnUrl.length>d)throw new Error(`returnUrl exceeds maximum length of ${d} characters`);if(!t.cancelUrl)throw new Error("cancelUrl is required");if(t.cancelUrl.length>d)throw new Error(`cancelUrl exceeds maximum length of ${d} characters`);let e=ne(),n=h(t.returnUrl,e);if(!n.isValid)throw new Error(`returnUrl validation failed: ${n.error}`);let i=h(t.cancelUrl,e);if(!i.isValid)throw new Error(`cancelUrl validation failed: ${i.error}`);if(t.defaultChallengeAge!==void 0){if(t.defaultChallengeAge<$)throw new Error(`defaultChallengeAge must be at least ${$}`);if(t.defaultChallengeAge>O)throw new Error(`defaultChallengeAge cannot exceed ${O}`)}if(t.defaultVerificationMode&&!["L1","L2"].includes(t.defaultVerificationMode))throw new Error("defaultVerificationMode must be L1 or L2");if(t.mode&&!["redirect","new-tab"].includes(t.mode))throw new Error("mode must be redirect or new-tab")}function ne(){let t=window.location.hostname;return t==="localhost"||t==="127.0.0.1"||t.includes(".local")?"development":t.includes("staging")||t.includes("stage")?"staging":"production"}async function K(t,e){let{createSignedState:n}=await Promise.resolve().then(()=>(_(),R));return n(t,e)}var $,O,d,N,D,te,S=p(()=>{"use strict";m();$=25,O=150,d=2048,N=128,D=6e5,te=/^(pk_|sk_)[a-zA-Z0-9]+$/});function y(t){let e=ie[t];if((t==="production"||t==="staging")&&!e.startsWith("https://"))throw new Error(`HTTPS required for ${t} environment`);return e}function re(t){let n={production:"https://api.safepassageapp.com",staging:"https://api-staging.safepassageapp.com",development:"http://localhost:3001"}[t];if((t==="production"||t==="staging")&&!n.startsWith("https://"))throw new Error(`HTTPS required for API URLs in ${t} environment`);return n}function W(t){let e=window.location.protocol==="https:",n=window.location.hostname;switch(t){case"production":if(!e)throw new Error("SafePassage requires HTTPS in production environment");break;case"staging":e||console.warn("SafePassage Warning: HTTPS strongly recommended in staging environment");break;case"development":let i=n==="localhost"||n==="127.0.0.1"||n.includes(".local");!e&&!i&&console.warn("SafePassage Warning: HTTPS recommended for non-localhost development");break}try{y(t),re(t)}catch(i){throw new Error(`Environment configuration validation failed: ${i}`)}}var ie,H=p(()=>{"use strict";ie={production:"https://verify.safepassageapp.com",staging:"https://verify-staging.safepassageapp.com",development:"http://localhost:5173"}});var q={};g(q,{SafePassage:()=>c,default:()=>oe});var c,oe,I=p(()=>{"use strict";S();H();m();c=class{constructor(e){this.popupWindow=null;this.messageListener=null;this.popupMonitorInterval=null;this.unloadListener=null;this.isVerificationInProgress=!1;this.currentSessionId=null;k(e),this.config={...e,environment:e.environment||this.detectEnvironment(),mode:e.mode||"redirect"},W(this.config.environment),V(this.config.environment),a("SDK_INITIALIZED",{environment:this.config.environment,mode:this.config.mode,origin:window.location.origin,protocol:window.location.protocol,hostname:window.location.hostname}),this.setupAutoCleanup()}async verify(e={}){let n=this.isPublicKey(),i=e.sessionId;if(n&&!i&&(i=await this.createInternalSession(e)),!n&&!i)throw new Error("sessionId is required for private API keys - must be a merchant-generated UUID v4");if(!i)throw new Error("Failed to create or obtain sessionId");if(this.isVerificationInProgress){let r=new Error(`Verification already in progress for session ${this.currentSessionId?.substring(0,8)}...`);throw a("RACE_CONDITION_PREVENTED",{currentSession:this.currentSessionId?.substring(0,8)+"...",attemptedSession:e.sessionId?e.sessionId.substring(0,8)+"...":"undefined",origin:window.location.origin}),this.config.onError?.(r),r}this.isVerificationInProgress=!0,this.currentSessionId=i;try{let r=`${this.config.apiKey}:${window.location.origin}`;if(!L.isAllowed(r)){let s=new Error("Too many verification attempts. Please wait before trying again.");throw a("RATE_LIMIT_EXCEEDED",{apiKey:this.config.apiKey.substring(0,8)+"...",origin:window.location.origin,sessionId:i?i.substring(0,8)+"...":"undefined"}),this.config.onError?.(s),s}let o=await this.buildVerificationUrl({...e,sessionId:i});a("VERIFICATION_INITIATED",{environment:this.config.environment,mode:this.config.mode,sessionId:i?i.substring(0,8)+"...":"undefined",origin:window.location.origin}),this.config.mode==="new-tab"?this.openNewTab(o,i):(this.unlockVerification(),this.redirect(o))}catch(r){throw this.unlockVerification(),r}}async buildVerificationUrl(e){let n=y(this.config.environment),i=e.challengeAge!==void 0,r=e.verificationMode!==void 0,o=i||r,s=await K({merchantId:this.config.apiKey,sessionId:e.sessionId,returnUrl:this.config.returnUrl,cancelUrl:this.config.cancelUrl,challengeAge:e.challengeAge||this.config.defaultChallengeAge,verificationMode:e.verificationMode||this.config.defaultVerificationMode,hasOverrides:o,externalUserId:e.externalUserId,timestamp:Date.now()},this.config.environment),l=new URLSearchParams({state:s,sessionId:e.sessionId,mode:this.config.mode});return`${n}/verify?${l.toString()}`}redirect(e){window.location.href=e}openNewTab(e,n){if(this.cleanup(),this.popupMonitorInterval&&(clearInterval(this.popupMonitorInterval),this.popupMonitorInterval=null),this.popupWindow=window.open(e,"safepassage-verify","width=600,height=700"),!this.popupWindow){this.config.onError?.(new Error("Failed to open verification window. Please check popup blocker settings."));return}this.messageListener=i=>{if(!b(i,this.config.environment)){a("POSTMESSAGE_ORIGIN_BLOCKED",{origin:i.origin,environment:this.config.environment,expectedOrigins:`SafePassage trusted origins for ${this.config.environment}`,messageType:i.data?.type});return}let r=x(i,n);if(!r.isValid){a("POSTMESSAGE_VALIDATION_FAILED",{error:r.error,origin:i.origin,sessionId:n.substring(0,8)+"...",messageType:i.data?.type});return}let o={sessionId:i.data.sessionId,status:i.data.status};a("VERIFICATION_COMPLETED",{status:o.status,sessionId:n.substring(0,8)+"...",origin:i.origin}),this.cleanup(),this.unlockVerification(),this.popupMonitorInterval&&(clearInterval(this.popupMonitorInterval),this.popupMonitorInterval=null),o.status==="verified"?this.config.onComplete?.(o):o.status==="cancelled"?this.config.onCancel?.():this.config.onError?.(new Error(`Verification failed: ${o.status}`))},window.addEventListener("message",this.messageListener),this.popupMonitorInterval=setInterval(()=>{this.popupWindow&&this.popupWindow.closed&&(a("POPUP_CLOSED_BY_USER",{sessionId:n.substring(0,8)+"...",environment:this.config.environment}),this.cleanup(),this.unlockVerification(),this.config.onCancel?.())},500)}setupAutoCleanup(){if(this.unloadListener=()=>{a("SDK_AUTO_CLEANUP",{environment:this.config.environment,trigger:"page_unload"}),this.cleanup(),this.unlockVerification()},window.addEventListener("beforeunload",this.unloadListener),window.addEventListener("pagehide",this.unloadListener),window.history&&window.history.pushState){let e=window.history.pushState;window.history.pushState=(...n)=>(this.cleanup(),this.unlockVerification(),e.apply(window.history,n))}}detectEnvironment(){let e=window.location.hostname;return e==="localhost"||e==="127.0.0.1"||e.includes(".local")?"development":e.includes("staging")||e.includes("stage")?"staging":"production"}unlockVerification(){this.isVerificationInProgress=!1,this.currentSessionId=null,a("VERIFICATION_UNLOCKED",{environment:this.config.environment,origin:window.location.origin})}cleanup(){this.popupWindow&&!this.popupWindow.closed&&this.popupWindow.close(),this.popupWindow=null,this.messageListener&&(window.removeEventListener("message",this.messageListener),this.messageListener=null),this.popupMonitorInterval&&(clearInterval(this.popupMonitorInterval),this.popupMonitorInterval=null)}removeAutoCleanupListeners(){this.unloadListener&&(window.removeEventListener("beforeunload",this.unloadListener),window.removeEventListener("pagehide",this.unloadListener),this.unloadListener=null)}destroy(){a("SDK_DESTROYED",{environment:this.config.environment,origin:window.location.origin}),this.cleanup(),this.unlockVerification(),this.removeAutoCleanupListeners()}isPublicKey(){return this.config.apiKey.startsWith("pk_")}async createInternalSession(e){let n=crypto.randomUUID();try{let i=this.getPortalApiUrl(),r=await fetch(`${i}/api/v1/sessions/create`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.config.apiKey}`},body:JSON.stringify({merchantId:this.config.apiKey,sessionId:n,returnUrl:this.config.returnUrl,cancelUrl:this.config.cancelUrl,challengeAge:e.challengeAge,verificationMode:e.verificationMode,merchantName:document.title||window.location.hostname,externalUserId:e.externalUserId})});if(!r.ok){let s=await r.json().catch(()=>({}));throw new Error(`Failed to create session: ${r.status} ${r.statusText}. ${s.message||""}`)}let o=await r.json();return a("INTERNAL_SESSION_CREATED",{sessionId:n.substring(0,8)+"...",environment:this.config.environment,apiKeyType:"public"}),n}catch(i){let r=i instanceof Error?i.message:String(i);throw a("INTERNAL_SESSION_FAILED",{error:r,environment:this.config.environment,apiKeyType:"public"}),this.config.onError?.(i),new Error(`Failed to create verification session: ${r}`)}}getPortalApiUrl(){switch(this.config.environment){case"production":return"https://api.safepassageapp.com";case"staging":return"https://api-staging.safepassageapp.com";case"development":default:return"http://localhost:3001"}}},oe=c});var se={};g(se,{SafePassage:()=>c,VERSION:()=>j,default:()=>c});function U(){crypto.randomUUID||(crypto.randomUUID=function(){let t=new Uint8Array(16);crypto.getRandomValues(t),t[6]=t[6]&15|64,t[8]=t[8]&63|128;let e=Array.from(t).map(n=>n.toString(16).padStart(2,"0")).join("");return[e.slice(0,8),e.slice(8,12),e.slice(12,16),e.slice(16,20),e.slice(20,32)].join("-")})}function A(){let t=[];if(!window.crypto||!window.crypto.getRandomValues)throw new Error("SafePassage SDK requires Web Crypto API support");if(!window.crypto.subtle)throw new Error("SafePassage SDK requires Web Crypto subtle API for HMAC operations");crypto.randomUUID||t.push("crypto.randomUUID not supported, using polyfill"),window.URLSearchParams||t.push("URLSearchParams not supported, consider adding a polyfill for IE 11 support");try{if({a:{b:1}}?.a?.b!==1)throw new Error}catch{t.push("Optional chaining (?.) not supported, ensure transpilation for older browsers")}t.length>0&&console.warn("SafePassage SDK Browser Compatibility:",t.join("; "))}I();typeof window<"u"&&(U(),A());var j="3.0.4";if(typeof window<"u"&&window){let{SafePassage:t}=(I(),P(q));window.SafePassage=t,window.SafePassage.VERSION=j}return P(se);})();
+/* SafePassage SDK v3.0.6 - Redirect Implementation with Enhanced Security */
+"use strict";var SafePassageSDK=(()=>{var u=Object.defineProperty;var G=Object.getOwnPropertyDescriptor;var J=Object.getOwnPropertyNames;var X=Object.prototype.hasOwnProperty;var p=(t,e)=>()=>(t&&(e=t(t=0)),e);var g=(t,e)=>{for(var n in e)u(t,n,{get:e[n],enumerable:!0})},Y=(t,e,n,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of J(e))!X.call(t,r)&&r!==n&&u(t,r,{get:()=>e[r],enumerable:!(i=G(e,r))||i.enumerable});return t};var P=t=>Y(u({},"__esModule",{value:!0}),t);function z(t,e){return b[e].includes(t)}function T(t,e,n=[]){let{origin:i}=t;return z(i,e)||n.length>0&&n.some(o=>{if(o.startsWith("*.")){let a=o.slice(2);return i.endsWith(`.${a}`)||i===`https://${a}`||i===`http://${a}`}return i===o})?!0:(console.warn(`SafePassage Security: Blocked PostMessage from untrusted origin: ${i}`,{environment:e,trustedOrigins:b[e],allowedCustomOrigins:n,eventType:t.data?.type}),!1)}function x(t,e){let{data:n}=t;return!n||typeof n!="object"?{isValid:!1,error:"Invalid message format"}:n.type!=="safepassage:verification:complete"?{isValid:!1,error:"Invalid message type"}:!n.sessionId||n.sessionId!==e?{isValid:!1,error:"Session ID mismatch"}:!n.status||!["verified","failed","cancelled"].includes(n.status)?{isValid:!1,error:"Invalid status value"}:{isValid:!0}}function V(t){if(t==="production"&&window.location.protocol!=="https:"){let e=window.location.href.replace("http:","https:");console.error("SafePassage Security: HTTPS required in production. Redirecting...",{current:window.location.href,redirect:e}),window.location.replace(e)}}function h(t,e){try{let n=new URL(t);if(e==="production"&&n.protocol!=="https:")return{isValid:!1,error:"HTTPS required for return URLs in production"};if(e==="development"&&!(n.hostname==="localhost"||n.hostname==="127.0.0.1"||n.hostname.endsWith(".local"))&&n.protocol!=="https:")return{isValid:!1,error:"Non-localhost URLs must use HTTPS"};if(e==="staging"&&n.protocol!=="https:")return{isValid:!1,error:"HTTPS required for return URLs in staging"};let i=[/data:/i,/javascript:/i,/vbscript:/i,/file:/i,/ftp:/i];for(let r of i)if(r.test(t))return{isValid:!1,error:"Blocked suspicious URL scheme"};return{isValid:!0}}catch{return{isValid:!1,error:"Invalid URL format"}}}function s(t,e){console.warn(`SafePassage Security Event: ${t}`,{timestamp:new Date().toISOString(),userAgent:navigator.userAgent,url:window.location.href,...e})}var b,f,L,m=p(()=>{"use strict";b={production:["https://av.safepassageapp.com","https://portal.safepassageapp.com","https://api.safepassageapp.com"],staging:["https://av.safepassageapp.com","https://portal.safepassageapp.com","https://api.safepassageapp.com"],development:["http://localhost:5173","http://localhost:3000","http://localhost:3001","http://localhost:3002","http://127.0.0.1:5173","http://127.0.0.1:3000","http://127.0.0.1:3001","http://127.0.0.1:3002"]};f=class{constructor(){this.attempts=new Map;this.maxAttempts=5;this.timeWindow=6e4}isAllowed(e){let n=Date.now(),r=(this.attempts.get(e)||[]).filter(o=>n-o<this.timeWindow);return r.length>=this.maxAttempts?(console.warn(`SafePassage Security: Rate limit exceeded for ${e}`),!1):(r.push(n),this.attempts.set(e,r),!0)}reset(e){this.attempts.delete(e)}},L=new f});var C={};g(C,{createSignedState:()=>Q,generateHMAC:()=>w,generateSecureToken:()=>R,getSigningSecret:()=>v,parseSignedState:()=>ee,verifyHMAC:()=>M});async function w(t,e){let n=new TextEncoder,i=n.encode(e),r=n.encode(t),o=await crypto.subtle.importKey("raw",i,{name:"HMAC",hash:"SHA-256"},!1,["sign"]),a=await crypto.subtle.sign("HMAC",o,r);return Array.from(new Uint8Array(a)).map(l=>l.toString(16).padStart(2,"0")).join("")}async function M(t,e,n){try{let i=await w(t,n);return Z(e,i)}catch{return!1}}function Z(t,e){if(t.length!==e.length)return!1;let n=0;for(let i=0;i<t.length;i++)n|=t.charCodeAt(i)^e.charCodeAt(i);return n===0}function R(t=32){let e=new Uint8Array(t);return crypto.getRandomValues(e),Array.from(e,n=>n.toString(16).padStart(2,"0")).join("")}function v(t){return{production:"safepassage-prod-hmac-2025",staging:"safepassage-prod-hmac-2025",development:"safepassage-dev-hmac-2025"}[t]}async function Q(t,e){let n={...t,timestamp:Date.now(),nonce:R(16)},i=JSON.stringify(n),r=v(e),o=await w(i,r);return btoa(JSON.stringify({data:n,signature:o}))}async function ee(t,e,n=k){try{let i=atob(t),r=JSON.parse(i);if(!r.data||!r.signature)return console.warn("SafePassage: Invalid signed state format"),null;let{data:o,signature:a}=r,l=JSON.stringify(o),F=v(e);if(!await M(l,a,F))return console.warn("SafePassage: State signature verification failed"),null;if(o.timestamp){let E=Date.now()-o.timestamp;if(E>n)return console.warn("SafePassage: State parameter expired",{age:E,maxAge:n}),null}let{timestamp:ce,nonce:le,...B}=o;return B}catch(i){return console.warn("SafePassage: Failed to parse signed state",i),null}}var _=p(()=>{"use strict";S()});function N(t){if(!t.apiKey)throw new Error("apiKey is required");if(t.apiKey.length>D)throw new Error(`apiKey exceeds maximum length of ${D} characters`);if(!te.test(t.apiKey))throw new Error("Invalid apiKey format. Expected pk_xxx (public) or sk_xxx (private)");if(typeof window<"u"&&t.apiKey.startsWith("sk_"))throw new Error("Secret keys (sk_) should never be used in browser code for security reasons. Secret keys expose your account to unauthorized access if used client-side. Please use your public key (pk_) instead. If you need to use features that require a secret key (like custom challenge age), create the session server-side and pass the sessionId to startVerificationWithSession(). See: https://docs.safepassageapp.com/server-side-sessions");if(!t.returnUrl)throw new Error("returnUrl is required");if(t.returnUrl.length>d)throw new Error(`returnUrl exceeds maximum length of ${d} characters`);if(!t.cancelUrl)throw new Error("cancelUrl is required");if(t.cancelUrl.length>d)throw new Error(`cancelUrl exceeds maximum length of ${d} characters`);let e=ne(),n=h(t.returnUrl,e);if(!n.isValid)throw new Error(`returnUrl validation failed: ${n.error}`);let i=h(t.cancelUrl,e);if(!i.isValid)throw new Error(`cancelUrl validation failed: ${i.error}`);if(t.defaultChallengeAge!==void 0){if(t.defaultChallengeAge<O)throw new Error(`defaultChallengeAge must be at least ${O}`);if(t.defaultChallengeAge>$)throw new Error(`defaultChallengeAge cannot exceed ${$}`)}if(t.defaultVerificationMode&&!["L1","L2"].includes(t.defaultVerificationMode))throw new Error("defaultVerificationMode must be L1 or L2");if(t.mode&&!["redirect","new-tab"].includes(t.mode))throw new Error("mode must be redirect or new-tab")}function ne(){let t=window.location.hostname;return t==="localhost"||t==="127.0.0.1"||t.includes(".local")?"development":t.includes("staging")||t.includes("stage")?"staging":"production"}async function K(t,e){let{createSignedState:n}=await Promise.resolve().then(()=>(_(),C));return n(t,e)}var O,$,d,D,k,te,S=p(()=>{"use strict";m();O=25,$=150,d=2048,D=128,k=6e5,te=/^(pk_|sk_)[a-zA-Z0-9]+$/});function y(t){let e=ie[t];if((t==="production"||t==="staging")&&!e.startsWith("https://"))throw new Error(`HTTPS required for ${t} environment`);return e}function re(t){let n={production:"https://api.safepassageapp.com",staging:"https://api.safepassageapp.com",development:"http://localhost:3001"}[t];if((t==="production"||t==="staging")&&!n.startsWith("https://"))throw new Error(`HTTPS required for API URLs in ${t} environment`);return n}function W(t){let e=window.location.protocol==="https:",n=window.location.hostname;switch(t){case"production":if(!e)throw new Error("SafePassage requires HTTPS in production environment");break;case"staging":e||console.warn("SafePassage Warning: HTTPS strongly recommended in staging environment");break;case"development":{let i=n==="localhost"||n==="127.0.0.1"||n.includes(".local");!e&&!i&&console.warn("SafePassage Warning: HTTPS recommended for non-localhost development");break}}try{y(t),re(t)}catch(i){throw new Error(`Environment configuration validation failed: ${i}`)}}var ie,H=p(()=>{"use strict";ie={production:"https://av.safepassageapp.com",staging:"https://av.safepassageapp.com",development:"http://localhost:5173"}});var q={};g(q,{SafePassage:()=>c,default:()=>oe});var c,oe,I=p(()=>{"use strict";S();H();m();c=class{constructor(e){this.popupWindow=null;this.messageListener=null;this.popupMonitorInterval=null;this.unloadListener=null;this.isVerificationInProgress=!1;this.currentSessionId=null;N(e),this.config={...e,environment:e.environment||this.detectEnvironment(),mode:e.mode||"redirect"},W(this.config.environment),V(this.config.environment),s("SDK_INITIALIZED",{environment:this.config.environment,mode:this.config.mode,origin:window.location.origin,protocol:window.location.protocol,hostname:window.location.hostname}),this.setupAutoCleanup()}async verify(e={}){let n=this.isPublicKey(),i=e.sessionId;if(n&&!i&&(i=await this.createInternalSession(e)),!n&&!i)throw new Error("sessionId is required for private API keys - must be a merchant-generated UUID v4");if(!i)throw new Error("Failed to create or obtain sessionId");if(this.isVerificationInProgress){let r=new Error(`Verification already in progress for session ${this.currentSessionId?.substring(0,8)}...`);throw s("RACE_CONDITION_PREVENTED",{currentSession:this.currentSessionId?.substring(0,8)+"...",attemptedSession:e.sessionId?e.sessionId.substring(0,8)+"...":"undefined",origin:window.location.origin}),this.config.onError?.(r),r}this.isVerificationInProgress=!0,this.currentSessionId=i;try{let r=`${this.config.apiKey}:${window.location.origin}`;if(!L.isAllowed(r)){let a=new Error("Too many verification attempts. Please wait before trying again.");throw s("RATE_LIMIT_EXCEEDED",{apiKey:this.config.apiKey.substring(0,8)+"...",origin:window.location.origin,sessionId:i?i.substring(0,8)+"...":"undefined"}),this.config.onError?.(a),a}let o=await this.buildVerificationUrl({...e,sessionId:i});s("VERIFICATION_INITIATED",{environment:this.config.environment,mode:this.config.mode,sessionId:i?i.substring(0,8)+"...":"undefined",origin:window.location.origin}),this.config.mode==="new-tab"?this.openNewTab(o,i):(this.unlockVerification(),this.redirect(o))}catch(r){throw this.unlockVerification(),r}}async buildVerificationUrl(e){let n=y(this.config.environment),i=e.challengeAge!==void 0,r=e.verificationMode!==void 0,o=i||r,a=await K({merchantId:this.config.apiKey,sessionId:e.sessionId,returnUrl:this.config.returnUrl,cancelUrl:this.config.cancelUrl,challengeAge:e.challengeAge||this.config.defaultChallengeAge,verificationMode:e.verificationMode||this.config.defaultVerificationMode,hasOverrides:o,externalUserId:e.externalUserId,timestamp:Date.now(),apiUrl:this.getPortalApiUrl(),engineUrl:this.getEngineUrl(),wsUrl:this.getWebSocketUrl(),environment:this.config.environment,features:{captureMode:"enhanced_verification",testMode:!1,warmupPeriodMs:2e3,qualityThreshold:.6}},this.config.environment),l=new URLSearchParams({state:a,sessionId:e.sessionId,mode:this.config.mode});return`${n}/?${l.toString()}`}redirect(e){window.location.href=e}openNewTab(e,n){if(this.cleanup(),this.popupMonitorInterval&&(clearInterval(this.popupMonitorInterval),this.popupMonitorInterval=null),this.popupWindow=window.open(e,"safepassage-verify","width=600,height=700"),!this.popupWindow){this.config.onError?.(new Error("Failed to open verification window. Please check popup blocker settings."));return}this.messageListener=i=>{if(!T(i,this.config.environment)){s("POSTMESSAGE_ORIGIN_BLOCKED",{origin:i.origin,environment:this.config.environment,expectedOrigins:`SafePassage trusted origins for ${this.config.environment}`,messageType:i.data?.type});return}let r=x(i,n);if(!r.isValid){s("POSTMESSAGE_VALIDATION_FAILED",{error:r.error,origin:i.origin,sessionId:n.substring(0,8)+"...",messageType:i.data?.type});return}let o={sessionId:i.data.sessionId,status:i.data.status};s("VERIFICATION_COMPLETED",{status:o.status,sessionId:n.substring(0,8)+"...",origin:i.origin}),this.cleanup(),this.unlockVerification(),this.popupMonitorInterval&&(clearInterval(this.popupMonitorInterval),this.popupMonitorInterval=null),o.status==="verified"?this.config.onComplete?.(o):o.status==="cancelled"?this.config.onCancel?.():this.config.onError?.(new Error(`Verification failed: ${o.status}`))},window.addEventListener("message",this.messageListener),this.popupMonitorInterval=setInterval(()=>{this.popupWindow&&this.popupWindow.closed&&(s("POPUP_CLOSED_BY_USER",{sessionId:n.substring(0,8)+"...",environment:this.config.environment}),this.cleanup(),this.unlockVerification(),this.config.onCancel?.())},500)}setupAutoCleanup(){if(this.unloadListener=()=>{s("SDK_AUTO_CLEANUP",{environment:this.config.environment,trigger:"page_unload"}),this.cleanup(),this.unlockVerification()},window.addEventListener("beforeunload",this.unloadListener),window.addEventListener("pagehide",this.unloadListener),window.history&&window.history.pushState){let e=window.history.pushState;window.history.pushState=(...n)=>(this.cleanup(),this.unlockVerification(),e.apply(window.history,n))}}detectEnvironment(){let e=window.location.hostname;return e==="localhost"||e==="127.0.0.1"||e.includes(".local")?"development":e.includes("staging")||e.includes("stage")?"staging":"production"}unlockVerification(){this.isVerificationInProgress=!1,this.currentSessionId=null,s("VERIFICATION_UNLOCKED",{environment:this.config.environment,origin:window.location.origin})}cleanup(){this.popupWindow&&!this.popupWindow.closed&&this.popupWindow.close(),this.popupWindow=null,this.messageListener&&(window.removeEventListener("message",this.messageListener),this.messageListener=null),this.popupMonitorInterval&&(clearInterval(this.popupMonitorInterval),this.popupMonitorInterval=null)}removeAutoCleanupListeners(){this.unloadListener&&(window.removeEventListener("beforeunload",this.unloadListener),window.removeEventListener("pagehide",this.unloadListener),this.unloadListener=null)}destroy(){s("SDK_DESTROYED",{environment:this.config.environment,origin:window.location.origin}),this.cleanup(),this.unlockVerification(),this.removeAutoCleanupListeners()}getPortalApiUrl(){switch(this.config.environment){case"development":return"http://localhost:3001";case"staging":case"production":return"https://api.safepassageapp.com";default:return"https://api.safepassageapp.com"}}getEngineUrl(){switch(this.config.environment){case"development":return"http://localhost:8000";case"staging":case"production":return"https://engine.safepassageapp.com";default:return"https://engine.safepassageapp.com"}}getWebSocketUrl(){switch(this.config.environment){case"development":return"ws://localhost:8000/safe-passage-llm/api/v1/websocket/stream";case"staging":case"production":return"wss://engine.safepassageapp.com/safe-passage-llm/api/v1/websocket/stream";default:return"wss://engine.safepassageapp.com/safe-passage-llm/api/v1/websocket/stream"}}isPublicKey(){return this.config.apiKey.startsWith("pk_")}async createInternalSession(e){let n=crypto.randomUUID();try{let i=this.getPortalApiUrl(),r=await fetch(`${i}/api/v1/sessions/create`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.config.apiKey}`},body:JSON.stringify({merchantId:this.config.apiKey,sessionId:n,returnUrl:this.config.returnUrl,cancelUrl:this.config.cancelUrl,challengeAge:e.challengeAge,verificationMode:e.verificationMode,merchantName:document.title||window.location.hostname,externalUserId:e.externalUserId})});if(!r.ok){let o=await r.json().catch(()=>({}));throw new Error(`Failed to create session: ${r.status} ${r.statusText}. ${o.message||""}`)}return await r.json(),s("INTERNAL_SESSION_CREATED",{sessionId:n.substring(0,8)+"...",environment:this.config.environment,apiKeyType:"public"}),n}catch(i){let r=i instanceof Error?i.message:String(i);throw s("INTERNAL_SESSION_FAILED",{error:r,environment:this.config.environment,apiKeyType:"public"}),this.config.onError?.(i),new Error(`Failed to create verification session: ${r}`)}}},oe=c});var se={};g(se,{SafePassage:()=>c,VERSION:()=>j,default:()=>c});function U(){crypto.randomUUID||(crypto.randomUUID=function(){let t=new Uint8Array(16);crypto.getRandomValues(t),t[6]=t[6]&15|64,t[8]=t[8]&63|128;let e=Array.from(t).map(n=>n.toString(16).padStart(2,"0")).join("");return[e.slice(0,8),e.slice(8,12),e.slice(12,16),e.slice(16,20),e.slice(20,32)].join("-")})}function A(){let t=[];if(!window.crypto||!window.crypto.getRandomValues)throw new Error("SafePassage SDK requires Web Crypto API support");if(!window.crypto.subtle)throw new Error("SafePassage SDK requires Web Crypto subtle API for HMAC operations");crypto.randomUUID||t.push("crypto.randomUUID not supported, using polyfill"),window.URLSearchParams||t.push("URLSearchParams not supported, consider adding a polyfill for IE 11 support");try{if({a:{b:1}}?.a?.b!==1)throw new Error}catch{t.push("Optional chaining (?.) not supported, ensure transpilation for older browsers")}t.length>0&&console.warn("SafePassage SDK Browser Compatibility:",t.join("; "))}I();typeof window<"u"&&(U(),A());var j="3.0.6";if(typeof window<"u"&&window){let{SafePassage:t}=(I(),P(q)),e=window;e.SafePassage=t,e.SafePassage&&(e.SafePassage.VERSION=j)}return P(se);})();
 if(typeof SafePassageSDK !== "undefined" && SafePassageSDK.SafePassage) { window.SafePassage = SafePassageSDK.SafePassage; window.SafePassage.VERSION = SafePassageSDK.VERSION; }

package/dist/types/index.d.ts

@@ -100,6 +100,16 @@ export interface StatePayload {
     hasOverrides?: boolean;
     externalUserId?: string;
     timestamp: number;
+    apiUrl?: string;
+    engineUrl?: string;
+    wsUrl?: string;
+    environment?: 'production' | 'staging' | 'development';
+    features?: {
+        captureMode: 'basic_verification' | 'enhanced_verification';
+        testMode: boolean;
+        warmupPeriodMs: number;
+        qualityThreshold: number;
+    };
 }
 export interface SessionValidationResponse {
     sessionId: string;

package/dist/utils/__mocks__/polyfills.d.ts

@@ -0,0 +1,3 @@
+export declare function setupPolyfills(): void;
+export declare function checkBrowserCompatibility(): void;
+export declare function polyfillCryptoRandomUUID(): void;

package/dist/utils/__mocks__/polyfills.js

@@ -0,0 +1,10 @@
+// Mock polyfills to avoid browser API checks in tests
+export function setupPolyfills() {
+    // Do nothing in tests
+}
+export function checkBrowserCompatibility() {
+    // Do nothing in tests
+}
+export function polyfillCryptoRandomUUID() {
+    // Already mocked in test setup
+}

package/dist/utils/crypto.d.ts

@@ -1,31 +1,105 @@
 /**
  * Crypto utilities for SafePassage SDK - Browser compatible
+ *
+ * Provides cryptographic functions for the SafePassage SDK using Web Crypto API.
+ * These utilities handle HMAC signing, state parameter protection, and secure
+ * token generation for client-side security measures.
+ *
+ * IMPORTANT SECURITY NOTE:
+ * Client-side cryptography provides defense-in-depth but cannot be considered
+ * secure against determined attackers. True security comes from server-side
+ * validation. These functions are primarily for tamper resistance and
+ * integrity checking.
+ *
+ * Features:
+ * - HMAC-SHA256 signing and verification using Web Crypto API
+ * - Constant-time string comparison to prevent timing attacks
+ * - Secure random token generation
+ * - Signed state parameter creation and parsing
+ * - Environment-specific secret derivation
+ * - Timestamp and nonce-based replay protection
+ *
+ * @author SafePassage Engineering
+ * @version 1.0.0
  */
 /**
  * Generate HMAC-SHA256 signature using Web Crypto API
- * Note: This is client-side HMAC, the secret is known to the client.
- * For true security, verification should still happen server-side.
+ *
+ * Creates an HMAC-SHA256 signature for the given data using the provided secret.
+ * Uses the browser's Web Crypto API for cryptographic operations.
+ *
+ * SECURITY NOTE: This is client-side HMAC where the secret is known to the client.
+ * It provides tamper resistance but not true security. Server-side verification
+ * is required for actual security.
+ *
+ * @param {string} data - Data to sign
+ * @param {string} secret - HMAC secret key
+ * @returns {Promise<string>} Promise resolving to hex-encoded HMAC signature
+ * @export
  */
 export declare function generateHMAC(data: string, secret: string): Promise<string>;
 /**
  * Verify HMAC-SHA256 signature using Web Crypto API
+ *
+ * Verifies an HMAC-SHA256 signature against the provided data and secret.
+ * Uses constant-time comparison to prevent timing attacks.
+ *
+ * @param {string} data - Original data that was signed
+ * @param {string} signature - HMAC signature to verify
+ * @param {string} secret - HMAC secret key
+ * @returns {Promise<boolean>} Promise resolving to true if signature is valid
+ * @export
  */
 export declare function verifyHMAC(data: string, signature: string, secret: string): Promise<boolean>;
 /**
  * Generate a secure random token for client-side use
+ *
+ * Creates a cryptographically secure random token using the browser's
+ * crypto.getRandomValues() function.
+ *
+ * @param {number} [length=32] - Token length in bytes
+ * @returns {string} Hex-encoded random token
+ * @export
  */
 export declare function generateSecureToken(length?: number): string;
 /**
  * Environment-specific secret derivation
- * In a real implementation, this would derive from environment variables
- * For client-side use, this provides basic tamper resistance
+ *
+ * Returns environment-specific secrets for HMAC signing. In a real implementation,
+ * this would derive from environment variables. For client-side use, this provides
+ * basic tamper resistance only.
+ *
+ * WARNING: Client-side secrets are NOT secure against determined attackers.
+ * This is defense-in-depth only. Real security comes from server-side validation.
+ *
+ * @param {'production' | 'staging' | 'development'} environment - Target environment
+ * @returns {string} Environment-specific secret
+ * @export
  */
 export declare function getSigningSecret(environment: 'production' | 'staging' | 'development'): string;
 /**
  * Create signed state parameter with timestamp and integrity protection
+ *
+ * Creates a signed state parameter containing the payload with added timestamp
+ * and nonce for freshness and replay protection. The entire payload is signed
+ * using HMAC-SHA256 and base64 encoded for URL safety.
+ *
+ * @param {unknown} payload - Data to include in state parameter
+ * @param {'production' | 'staging' | 'development'} environment - Target environment
+ * @returns {Promise<string>} Promise resolving to base64-encoded signed state
+ * @export
  */
-export declare function createSignedState(payload: any, environment: 'production' | 'staging' | 'development'): Promise<string>;
+export declare function createSignedState(payload: unknown, environment: 'production' | 'staging' | 'development'): Promise<string>;
 /**
  * Verify and parse signed state parameter
+ *
+ * Parses and verifies a signed state parameter, checking the HMAC signature
+ * and timestamp freshness. Returns the original payload if validation succeeds.
+ *
+ * @param {string} signedState - Base64-encoded signed state parameter
+ * @param {'production' | 'staging' | 'development'} environment - Source environment
+ * @param {number} [maxAge] - Maximum age in milliseconds
+ * @returns {Promise<unknown | null>} Promise resolving to payload or null if invalid
+ * @export
  */
-export declare function parseSignedState(signedState: string, environment: 'production' | 'staging' | 'development', maxAge?: number): Promise<any | null>;
+export declare function parseSignedState(signedState: string, environment: 'production' | 'staging' | 'development', maxAge?: number): Promise<unknown | null>;

package/dist/utils/crypto.js

@@ -1,11 +1,42 @@
 /**
  * Crypto utilities for SafePassage SDK - Browser compatible
+ *
+ * Provides cryptographic functions for the SafePassage SDK using Web Crypto API.
+ * These utilities handle HMAC signing, state parameter protection, and secure
+ * token generation for client-side security measures.
+ *
+ * IMPORTANT SECURITY NOTE:
+ * Client-side cryptography provides defense-in-depth but cannot be considered
+ * secure against determined attackers. True security comes from server-side
+ * validation. These functions are primarily for tamper resistance and
+ * integrity checking.
+ *
+ * Features:
+ * - HMAC-SHA256 signing and verification using Web Crypto API
+ * - Constant-time string comparison to prevent timing attacks
+ * - Secure random token generation
+ * - Signed state parameter creation and parsing
+ * - Environment-specific secret derivation
+ * - Timestamp and nonce-based replay protection
+ *
+ * @author SafePassage Engineering
+ * @version 1.0.0
  */
 import { STATE_EXPIRY_MS } from './validation';
 /**
  * Generate HMAC-SHA256 signature using Web Crypto API
- * Note: This is client-side HMAC, the secret is known to the client.
- * For true security, verification should still happen server-side.
+ *
+ * Creates an HMAC-SHA256 signature for the given data using the provided secret.
+ * Uses the browser's Web Crypto API for cryptographic operations.
+ *
+ * SECURITY NOTE: This is client-side HMAC where the secret is known to the client.
+ * It provides tamper resistance but not true security. Server-side verification
+ * is required for actual security.
+ *
+ * @param {string} data - Data to sign
+ * @param {string} secret - HMAC secret key
+ * @returns {Promise<string>} Promise resolving to hex-encoded HMAC signature
+ * @export
  */
 export async function generateHMAC(data, secret) {
     // Encode the secret and data as Uint8Array
@@ -18,11 +49,20 @@ export async function generateHMAC(data, secret) {
     const signature = await crypto.subtle.sign('HMAC', key, dataBuffer);
     // Convert to hex string
     return Array.from(new Uint8Array(signature))
-        .map(b => b.toString(16).padStart(2, '0'))
+        .map((b) => b.toString(16).padStart(2, '0'))
         .join('');
 }
 /**
  * Verify HMAC-SHA256 signature using Web Crypto API
+ *
+ * Verifies an HMAC-SHA256 signature against the provided data and secret.
+ * Uses constant-time comparison to prevent timing attacks.
+ *
+ * @param {string} data - Original data that was signed
+ * @param {string} signature - HMAC signature to verify
+ * @param {string} secret - HMAC secret key
+ * @returns {Promise<boolean>} Promise resolving to true if signature is valid
+ * @export
  */
 export async function verifyHMAC(data, signature, secret) {
     try {
@@ -35,6 +75,13 @@ export async function verifyHMAC(data, signature, secret) {
 }
 /**
  * Constant-time string comparison to prevent timing attacks
+ *
+ * Compares two strings in constant time to prevent timing-based attacks
+ * that could leak information about the expected signature.
+ *
+ * @param {string} a - First string to compare
+ * @param {string} b - Second string to compare
+ * @returns {boolean} True if strings are equal
  */
 function constantTimeCompare(a, b) {
     if (a.length !== b.length) {
@@ -48,36 +95,61 @@ function constantTimeCompare(a, b) {
 }
 /**
  * Generate a secure random token for client-side use
+ *
+ * Creates a cryptographically secure random token using the browser's
+ * crypto.getRandomValues() function.
+ *
+ * @param {number} [length=32] - Token length in bytes
+ * @returns {string} Hex-encoded random token
+ * @export
  */
 export function generateSecureToken(length = 32) {
     const array = new Uint8Array(length);
     crypto.getRandomValues(array);
-    return Array.from(array, b => b.toString(16).padStart(2, '0')).join('');
+    return Array.from(array, (b) => b.toString(16).padStart(2, '0')).join('');
 }
 /**
  * Environment-specific secret derivation
- * In a real implementation, this would derive from environment variables
- * For client-side use, this provides basic tamper resistance
+ *
+ * Returns environment-specific secrets for HMAC signing. In a real implementation,
+ * this would derive from environment variables. For client-side use, this provides
+ * basic tamper resistance only.
+ *
+ * WARNING: Client-side secrets are NOT secure against determined attackers.
+ * This is defense-in-depth only. Real security comes from server-side validation.
+ *
+ * @param {'production' | 'staging' | 'development'} environment - Target environment
+ * @returns {string} Environment-specific secret
+ * @export
  */
 export function getSigningSecret(environment) {
     // WARNING: Client-side secrets are NOT secure against determined attackers
     // This is defense-in-depth only. Real security comes from server-side validation.
     const baseSecrets = {
         production: 'safepassage-prod-hmac-2025',
-        staging: 'safepassage-stage-hmac-2025',
-        development: 'safepassage-dev-hmac-2025'
+        staging: 'safepassage-prod-hmac-2025', // Use production secrets for staging
+        development: 'safepassage-dev-hmac-2025',
     };
     return baseSecrets[environment];
 }
 /**
  * Create signed state parameter with timestamp and integrity protection
+ *
+ * Creates a signed state parameter containing the payload with added timestamp
+ * and nonce for freshness and replay protection. The entire payload is signed
+ * using HMAC-SHA256 and base64 encoded for URL safety.
+ *
+ * @param {unknown} payload - Data to include in state parameter
+ * @param {'production' | 'staging' | 'development'} environment - Target environment
+ * @returns {Promise<string>} Promise resolving to base64-encoded signed state
+ * @export
  */
 export async function createSignedState(payload, environment) {
     // Add timestamp for freshness
     const timestampedPayload = {
         ...payload,
         timestamp: Date.now(),
-        nonce: generateSecureToken(16) // Add nonce to prevent replay attacks
+        nonce: generateSecureToken(16), // Add nonce to prevent replay attacks
     };
     const dataString = JSON.stringify(timestampedPayload);
     const secret = getSigningSecret(environment);
@@ -85,12 +157,21 @@ export async function createSignedState(payload, environment) {
     // Combine data and signature
     const signedPayload = {
         data: timestampedPayload,
-        signature
+        signature,
     };
     return btoa(JSON.stringify(signedPayload));
 }
 /**
  * Verify and parse signed state parameter
+ *
+ * Parses and verifies a signed state parameter, checking the HMAC signature
+ * and timestamp freshness. Returns the original payload if validation succeeds.
+ *
+ * @param {string} signedState - Base64-encoded signed state parameter
+ * @param {'production' | 'staging' | 'development'} environment - Source environment
+ * @param {number} [maxAge] - Maximum age in milliseconds
+ * @returns {Promise<unknown | null>} Promise resolving to payload or null if invalid
+ * @export
  */
 export async function parseSignedState(signedState, environment, maxAge = STATE_EXPIRY_MS) {
     try {
@@ -118,6 +199,7 @@ export async function parseSignedState(signedState, environment, maxAge = STATE_
             }
         }
         // Remove internal fields before returning
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
         const { timestamp, nonce, ...payload } = data;
         return payload;
     }

package/dist/utils/environment.js

@@ -2,14 +2,15 @@
  * Environment utilities for SafePassage SDK with security enforcement
  */
 const ENVIRONMENT_URLS = {
-    production: 'https://verify.safepassageapp.com',
-    staging: 'https://verify-staging.safepassageapp.com',
-    development: 'http://localhost:5173'
+    production: 'https://av.safepassageapp.com',
+    staging: 'https://av.safepassageapp.com',
+    development: 'http://localhost:5173',
 };
 export function getEnvironmentUrl(environment) {
     const url = ENVIRONMENT_URLS[environment];
     // Security check: Ensure production/staging always use HTTPS
-    if ((environment === 'production' || environment === 'staging') && !url.startsWith('https://')) {
+    if ((environment === 'production' || environment === 'staging') &&
+        !url.startsWith('https://')) {
         throw new Error(`HTTPS required for ${environment} environment`);
     }
     return url;
@@ -17,12 +18,13 @@ export function getEnvironmentUrl(environment) {
 export function getApiUrl(environment) {
     const apiUrls = {
         production: 'https://api.safepassageapp.com',
-        staging: 'https://api-staging.safepassageapp.com',
-        development: 'http://localhost:3001'
+        staging: 'https://api.safepassageapp.com',
+        development: 'http://localhost:3001',
     };
     const url = apiUrls[environment];
     // Security check: Ensure production/staging always use HTTPS
-    if ((environment === 'production' || environment === 'staging') && !url.startsWith('https://')) {
+    if ((environment === 'production' || environment === 'staging') &&
+        !url.startsWith('https://')) {
         throw new Error(`HTTPS required for API URLs in ${environment} environment`);
     }
     return url;
@@ -32,9 +34,12 @@ export function getApiUrl(environment) {
  */
 export function detectEnvironment() {
     const hostname = window.location.hostname;
-    if (hostname === 'localhost' || hostname === '127.0.0.1' || hostname.includes('.local')) {
+    if (hostname === 'localhost' ||
+        hostname === '127.0.0.1' ||
+        hostname.includes('.local')) {
         // Warn if using HTTP in development with non-localhost domains
-        if (window.location.protocol === 'http:' && !hostname.match(/^(localhost|127\.0\.0\.1)$/)) {
+        if (window.location.protocol === 'http:' &&
+            !hostname.match(/^(localhost|127\.0\.0\.1)$/)) {
             console.warn('SafePassage Security Warning: Using HTTP with non-localhost domain in development');
         }
         return 'development';
@@ -70,12 +75,15 @@ export function validateEnvironmentSecurity(environment) {
                 console.warn('SafePassage Warning: HTTPS strongly recommended in staging environment');
             }
             break;
-        case 'development':
-            const isLocalhost = hostname === 'localhost' || hostname === '127.0.0.1' || hostname.includes('.local');
+        case 'development': {
+            const isLocalhost = hostname === 'localhost' ||
+                hostname === '127.0.0.1' ||
+                hostname.includes('.local');
             if (!isSecure && !isLocalhost) {
                 console.warn('SafePassage Warning: HTTPS recommended for non-localhost development');
             }
             break;
+        }
     }
     // Validate environment URLs
     try {

package/dist/utils/polyfills.js

@@ -8,23 +8,26 @@
 export function setupPolyfills() {
     // Polyfill crypto.randomUUID if not available
     if (!crypto.randomUUID) {
-        crypto.randomUUID = function () {
-            // Generate 16 random bytes
-            const array = new Uint8Array(16);
-            crypto.getRandomValues(array);
-            // Set version (4) and variant bits
-            array[6] = (array[6] & 0x0f) | 0x40; // Version 4
-            array[8] = (array[8] & 0x3f) | 0x80; // Variant 10
-            // Convert to hex string with dashes
-            const hex = Array.from(array).map(b => b.toString(16).padStart(2, '0')).join('');
-            return [
-                hex.slice(0, 8),
-                hex.slice(8, 12),
-                hex.slice(12, 16),
-                hex.slice(16, 20),
-                hex.slice(20, 32)
-            ].join('-');
-        };
+        crypto.randomUUID =
+            function () {
+                // Generate 16 random bytes
+                const array = new Uint8Array(16);
+                crypto.getRandomValues(array);
+                // Set version (4) and variant bits
+                array[6] = (array[6] & 0x0f) | 0x40; // Version 4
+                array[8] = (array[8] & 0x3f) | 0x80; // Variant 10
+                // Convert to hex string with dashes
+                const hex = Array.from(array)
+                    .map((b) => b.toString(16).padStart(2, '0'))
+                    .join('');
+                return [
+                    hex.slice(0, 8),
+                    hex.slice(8, 12),
+                    hex.slice(12, 16),
+                    hex.slice(16, 20),
+                    hex.slice(20, 32),
+                ].join('-');
+            };
     }
     // Note: URLSearchParams is widely supported (IE 11 doesn't support it, but we're not targeting IE 11)
     // If needed, a polyfill can be added here

package/dist/utils/security.d.ts

@@ -46,5 +46,5 @@ export declare const verificationRateLimit: VerificationRateLimit;
 /**
  * Security event logging for monitoring
  */
-export declare function logSecurityEvent(event: string, details: any): void;
+export declare function logSecurityEvent(event: string, details: unknown): void;
 export {};