@ideem/zsm-client-sdk 2.2.5 → 2.4.0

package/README.md

@@ -29,3 +29,9 @@ An example application demonstrating how to integrate this SDK into an applicati
 
 ## Support
 You can receive support and get your questions answered by emailing <a href="mailto:support@useideem.com">support@useideem.com</a>.
+
+### License
+Please refer to the LICENSE file in this directory for the license governing the use of this SDK.
+
+### Release Notes
+Please refer to the RELEASE_NOTES.txt file in this directory for the release notes of this SDK.

package/RELEASE_NOTES.txt

@@ -0,0 +1,116 @@
+ZSM Client SDK for Browser Apps
+Latest version: v2.3.0
+Latest release date: March 24, 2025
+
+The ZSM Client SDK for Browser Apps provides the resources needed to integrate Ideem's FIDO2 Authenticator
+and Universal MFA into a browser application. 
+
+## Resources: 
+- UMFA Documentation: https://docs.useideem.com/umfa_sdk/browser/index.html
+- FIDO2 Documentation: https://docs.useideem.com/fido2_sdk/browser/index.html
+- Support: support@useideem.com 
+
+## Known Issues
+- None
+
+----
+
+## Release 2.4.0 - May 1, 2025 [ NPM PACKAGE RELEASE ] **[ LATEST ]**
+- Minor bug fixes and improvements
+- Updates to documentation
+- Adds event emitters to the UMFAClient and FIDO2Client for on-the-fly initializations
+- Adds extended multi-tenancy support for the UMFAClient and FIDO2Client
+- Adds increased detail to performance logging
+- Extends secure local storage support
+
+## Release 2.3.0 - Mar 24, 2025
+- Minor bug fixes and improvements
+- Updates to documentation
+- Introduces web-worker-driven JS SDK Client for browser-based applications
+- Significant performance improvements to the UMFA JS Client
+- Updates native mobile SDKs to support the new optimized flows
+- Adds unenroll/webauthnDelete functionality to UMFAClient and FIDO2Client (browser, mobile, and native)
+- Updates data parsing and replication in SQL and Oracle environments
+
+## Release 2.2.12 - Mar 14, 2025
+- Minor bug fixes and improvements
+- Updates to documentation
+- Improves server-side TLS handling performance
+- Adds optimized flows to the UMFA CLI Client
+
+## Release 2.2.11 - Mar 5, 2025
+- Minor bug fixes and improvements
+- Updates to documentation
+- Updates to UMFA CLI for enhanced trace reporting
+- Updates Affinity rules
+- Native Webauthn apps and sdk updates
+- Improves package and file versioning for safer deployments
+
+## Release 2.2.10 - Feb 27, 2025
+- Minor bug fixes and improvements
+- Updates to documentation
+- Performance upgrades to AS2 environment
+- Extended Trace Map and Host URL Parameter Renames
+- Updates to Android-based tls security
+- CLI updates for compression formats
+
+## Release 2.2.9 - Feb 14, 2025
+- Minor bug fixes and improvements
+- Updates to documentation
+- Adjustments to deployment process
+- React Native SDK updates
+- Extended trace mapping implementation
+
+## Release 2.2.8 - Feb 7, 2025 [ NPM PACKAGE RELEASE ]
+- Minor bug fixes and improvements
+- Updates to documentation
+- Adds support for the latest version of the React Native SDK
+- Adds 2 New production-ready environments
+- Updates binaries for use with M-class Macs
+- Improves WASM binary benchmarks
+
+## Release 2.2.7 - Jan 31, 2025
+- Minor bug fixes and improvements
+- Updates to documentation
+- Removed validate token message from UMFA demo transcript
+- Fixes condition in which mobile portrait view loses contact with clear and docs buttons.
+- Removed dependency on colored crate
+- Added new API for enhanced security features
+
+## Release 2.2.6 - January 24, 2024 [ NPM PACKAGE RELEASE ]
+- Minor bug fixes and improvements
+- Updates to documentation
+- Increased high-latency tolerance timeout from a 65-second max to a 300-second max.
+- Expand Performance Logging
+
+## Release 2.2.4 - January 22, 2024 [ NPM PACKAGE RELEASE ]
+- Minor bug fixes and improvements
+- Updates to documentation
+- AS2 support added
+
+## Release 2.2.3 - January 20, 2024 [ NPM PACKAGE RELEASE ]
+- Minor bug fixes and improvements
+- Updates to documentation
+- Stability and format improvements
+
+## Release v2.2.2 - January 13, 2024 [ NPM PACKAGE RELEASE ]
+- Minor bug fixes and improvements
+- Updates to documentation
+- Deployment via NPM
+- Addition of Vue support (foundation for other web frameworks)
+- Addition of checkEnrollment() and enroll() APIs
+- Addition of SDK-to-server API Key for reporting purposes (not security)
+- Removal of validateToken() API.  Token validation is to be via server-to-server for security reasons.
+
+## Release v2.2.1 - December 9, 2024 [ NPM PACKAGE RELEASE ]
+- Performance and stability improvements
+- WASM size reduction
+- Reduced expiration time to 30 seconds for the JWT returned by Authenticate
+- Restructured SDK files to be more organized
+- Modified application configuration approach to use a configuration json file,
+  but can also be overridden in the code.
+- Improvements to Demo apps at https://demo.useideem.com
+
+## Release v2.2.0 - November 19, 2024 [ NPM PACKAGE RELEASE ]
+- Addition of FIDO2 Authenticator interfaces
+- Addition of Universal MFA interfaces

package/ZSMClientSDK.js

@@ -0,0 +1,473 @@
+// Alias environment-specific global object
+const GLOBAL = typeof globalThis  !== "undefined" ? globalThis
+             : typeof self        !== "undefined" ? self
+             : typeof window      !== "undefined" ? window
+             : typeof global      !== "undefined" ? global
+             : (() => { throw new Error("Unable to determine global scope"); })();
+
+// Error class for worker errors
+class WorkerError extends Error {
+    constructor(name, message, ...details) {
+        super(message);
+        this.name = name ? `Worker ${name} Error` : 'Worker Error';
+        if (details.length) this.details = details;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, WorkerError);
+        } else {
+            this.stack = (new Error(message)).stack;
+        }
+    }
+}
+
+class ZSMClientBase {
+    constructor(config) {
+        this.config                = config;
+        this.clientWorker          = null;
+        this.timeoutTimer          = null;
+        GLOBAL.zsmClient           = null;
+    }
+
+    /**
+     * @name            init
+     * @description     Initializes the ZSMClient instance and sets up the worker.
+     * @param           {String}                clientType          The type of client to initialize [default: 'UMFAClient']
+     * @param           {Object}                config              The configuration object for the client [default: this.config]
+     * @returns         {Promise<ZSMClientBase>}                    A promise that resolves to the initialized ZSMClient instance.
+     */
+    async init(clientType='UMFAClient', config=this.config) {
+        if(GLOBAL.clientWorker) GLOBAL.clientWorker.terminate();
+        const workerPath    = GLOBAL?.workerPath ? GLOBAL.workerPath
+                            : config?.workerPath ? config.workerPath
+                            : './worker.js';
+        const pathResolver  = (import.meta && import.meta?.resolve) ? import.meta?.resolve(workerPath)
+                            : (import.meta && import.meta?.url) ? import.meta?.url.replace(/\/[^\/]+$/, '/' + workerPath)
+                            : document?.currentScript ? document?.currentScript?.src?.replace(/\/[^\/]+$/, '/' + workerPath)
+                            : workerPath;
+        GLOBAL.clientWorker = this.clientWorker = new Worker(new URL(pathResolver));
+        GLOBAL.zsmClient    = this;
+        await this.callWorkerFunction("init", {config, clientType}, false);
+        return this;
+    }
+
+    /**
+     * @name            callWorkerFunction
+     * @description     Calls a function in the worker and returns a promise that resolves with the result.
+     * @param           {String}                functionName        The name of the function to call in the worker.
+     * @param           {Object}                data                The data to pass to the worker function.
+     * @param           {Boolean}               responseExpected    Whether an acknowledgement is expected [Default: true]
+     * @returns         {Promise<Object>}                           A promise that resolves with the result of the worker function.
+     */
+    async callWorkerFunction(functionName, data, responseExpected=true) {
+        let workerPromise = new Promise((resolve, reject) => {
+            this.clientWorker.postMessage({functionName, data });
+            if(responseExpected) this.timeoutTimer = GLOBAL.setTimeout(() => reject(new WorkerError('Transaction', 'Transaction timed out after 60 seconds!')), 60000);
+
+            this.clientWorker.onmessage = (event) => {
+                GLOBAL.clearTimeout(this.timeoutTimer);
+
+                let workerResponse = event.data;
+
+                if(GLOBAL.showWorkerTelemetry && (workerResponse.result || workerResponse.error)) {
+                    console.groupCollapsed(`%cWorker posted to Main Thread a response to invocation:`, 'font-weight:bold; color:#F60;', functionName)
+                    console.log(`%c   Function Invoked:`, 'font-weight:100; color:#AAA;', workerResponse.functionName);
+                    console.log(`%c   Success Status:`, 'font-weight:100; color:#AAA;', workerResponse.success ? 'true' : 'false');
+                    console.log(`%c   Result value:`, 'font-weight:100; color:#AAA;', (workerResponse.success ? workerResponse.result : workerResponse.error));
+                    console.log(`%c   Response Object:`, 'font-weight:100; color:#AAA;', workerResponse);
+                    console.groupEnd();
+                }
+
+                if (workerResponse instanceof Error || workerResponse.error || !workerResponse.success) {
+                    return reject(workerResponse.error);
+                }
+                resolve(workerResponse.result);
+            };
+
+            this.clientWorker.onerror        = (err)                => { GLOBAL.clearTimeout(this.timeoutTimer); reject(new WorkerError('', err.message)); };
+            this.clientWorker.onmessageerror = (err)                => { GLOBAL.clearTimeout(this.timeoutTimer); reject(new WorkerError('Message', err.message)); };
+        });
+
+        /**
+         * @event           workerEvent
+         * @description     Event triggered when the worker posts an event to the main thread.
+         * @param           {String}                eventName           The name of the event.
+         * @param           {Object}                eventData           The data associated with the event.
+         * @returns         {void}
+         * @emits           {CustomEvent}           event               The event object containing the received event name and data.
+         * @example         GLOBAL.addEventListener('workerEvent', (event) => {
+         * @                    console.log('Received event from worker:', event.detail.eventName, event.detail.eventData);
+         * @                });
+         */
+        this.clientWorker.addEventListener('message', (event) => {
+            if(!event.data || !event.data.eventName) return;
+            const { eventName, eventData } = event.data;
+            if(GLOBAL.showWorkerTelemetry) console.log(`%cWorker posted to Main Thread an event:`, 'font-weight:bold; color:#F60;', eventName, eventData);
+            GLOBAL.dispatchEvent(new CustomEvent(eventName, { detail: eventData }));
+        });
+        return workerPromise;
+    }
+}
+
+class UMFAClient extends ZSMClientBase {
+    constructor(config) {
+        super(config);
+        this.init                  = super.init.bind(this);
+        this.callWorkerFunction    = super.callWorkerFunction.bind(this);
+        this.checkEnrollment       = this.checkEnrollment.bind(this);
+        this.enroll                = this.enroll.bind(this);
+        this.authenticate          = this.authenticate.bind(this);
+        this.optimizedEnroll       = this.optimizedEnroll.bind(this);
+        this.optimizedAuthenticate = this.optimizedAuthenticate.bind(this);
+        this.init('UMFAClient');
+    }
+
+    async checkEnrollment(user)       { return await this.callWorkerFunction('checkEnrollment',       user); }
+    async enroll(user)                { return await this.callWorkerFunction('enroll',                user); }
+    async authenticate(user)          { return await this.callWorkerFunction('authenticate',          user); }
+    async optimizedEnroll(user)       { return await this.callWorkerFunction('optimizedEnroll',       user); }
+    async optimizedAuthenticate(user) { return await this.callWorkerFunction('optimizedAuthenticate', user); }
+    async unenroll(user)              { return await this.callWorkerFunction('unenroll',              user); }
+}
+
+class FIDO2Client extends ZSMClientBase {
+    constructor(config) {
+        super(config);
+        this.init                  = super.init.bind(this);
+        this.callWorkerFunction    = super.callWorkerFunction.bind(this);
+        this.checkEnrollment       = this.checkEnrollment.bind(this);
+        this.checkIdentity         = this.checkIdentity.bind(this);
+        this.webauthnCreate        = this.webauthnCreate.bind(this);
+        this.webauthnGet           = this.webauthnGet.bind(this);
+        this.webauthnRetrieve      = this.webauthnRetrieve.bind(this);
+        this.webauthnDelete        = this.webauthnDelete.bind(this);
+        this.init('FIDO2Client');
+    }
+
+    async checkIdentity(user, auto=true) { return await this.callWorkerFunction('checkIdentity',   [user, auto]); }
+    async checkEnrollment(user)          { return await this.callWorkerFunction('checkEnrollment',  user); }
+    async webauthnCreate(user)           { return await this.callWorkerFunction('webauthnCreate',   user); }
+    async webauthnGet(user)              { return await this.callWorkerFunction('webauthnGet',      user); }
+    async webauthnRetrieve(user)         { return await this.callWorkerFunction('webauthnRetrieve', user); }
+    async webauthnDelete(user)           { return await this.callWorkerFunction('webauthnDelete',   user); }
+}
+
+function amendPerformanceLoggingToClass(cls) {
+    GLOBAL.sessionStamp = new Date();
+    GLOBAL.sessionStamp = new Date(GLOBAL.sessionStamp.getTime() - (GLOBAL.sessionStamp.getTimezoneOffset() * 60000)).toISOString().slice(11, -5);
+    GLOBAL.exportCount  = 0;
+
+    if(GLOBAL.logStack == null) {
+        GLOBAL.logStack  = [];
+        GLOBAL.getLogs   = () => GLOBAL.logStack.sort((a, b) => a.stamp - b.stamp);
+        GLOBAL.clearLogs = () => {GLOBAL.logStack = []; };
+        GLOBAL.showLogs  = () => {
+            if(!GLOBAL.logStack || GLOBAL.logStack.length === 0) return console.info('There are no logs currently in the stack!');
+
+            const getTime = (ISOStamp) => new Date(ISOStamp).toISOString().split('T')[1].slice(0,-1);
+
+            (function parseLog(stack=[...GLOBAL.logStack], parentEndTime = Infinity) {
+                while (stack.length > 0 && stack[0].startTime < parentEndTime) {
+                    let markS, markE, spanName, indE, duration, stamps;
+                    markS = stack.shift();
+                    spanName = markS.name.slice(0, -6);
+                    indE = stack.findIndex(log => log.name === spanName + "-END");
+                    if (indE !== -1) markE = stack.splice(indE, 1)[0];
+                    duration = (markE != null) ? (markE.startTime - markS.startTime).toFixed(4) + 'ms' : 'ONGOING';
+                    stamps = (markE != null) ? getTime(markS.stamp) + " - " + getTime(markE.stamp) : getTime(markS.stamp) + " - ...";
+
+                    console.groupCollapsed(spanName.replace(/-/g, ' :: ') + ' :: ' + duration + " (" + stamps + ")");
+                    parseLog(stack, markE.startTime);
+                    console.groupEnd();
+                }
+            })()
+        }
+
+        GLOBAL.addPerfMarker = (tag) => {
+            const {name, startTime} = performance.mark(tag).toJSON();
+            GLOBAL.logStack.push({
+                type    : "MAINTHREAD",
+                order   : GLOBAL.logStack.length,
+                name,
+                absTime : startTime,
+                stamp   : performance.timeOrigin + startTime
+            });
+        }
+    }
+
+    return class extends cls {
+        constructor(...args) {
+            super(...args);
+
+            Object.getOwnPropertyNames(this).forEach(propName => {
+                if (propName === "constructor" || typeof this[propName] !== "function") return;
+
+                const originalMethod  = this[propName];
+                let markerTagPrefix = `[MAINTHREAD]-${cls.name}-${propName}`;
+                this[propName] = function(...args) {
+                    if(propName === "callWorkerFunction") markerTagPrefix = `[MAINTHREAD]-${cls.name}-${propName}-${args[0]}`;
+                    GLOBAL.addPerfMarker(markerTagPrefix + "-START");
+                    const result = originalMethod.apply(this, args);
+                    if (result && typeof result.then === 'function') {
+                        return result.finally(() => GLOBAL.addPerfMarker(markerTagPrefix + "-END"));
+                    } else {
+                        GLOBAL.addPerfMarker(markerTagPrefix + "-END");
+                        return result;
+                    }
+                };
+            });
+        }
+    };
+}
+
+//
+if(typeof UMFAClient !== "undefined" && UMFAClient instanceof Function) UMFAClient = amendPerformanceLoggingToClass(UMFAClient);
+if(typeof FIDO2Client !== "undefined" && FIDO2Client instanceof Function) FIDO2Client = amendPerformanceLoggingToClass(FIDO2Client);
+
+let masterLogs = [];
+if(window){
+    let tzO = new Date().getTimezoneOffset() * 60000;
+
+    GLOBAL.getAllLogs    = async (showCSV) => {
+        let res = await zsmClient.callWorkerFunction("getLogs");
+        let {logs, timeOrigin} = JSON.parse(res);
+        let timeDifferential = performance.timeOrigin - timeOrigin;
+        if(!showCSV) {
+            console.groupCollapsed('RAW logs');
+            GLOBAL.logStack.forEach(mainRecord => console.info('mainRecord :', mainRecord));
+            logs.forEach(workerRecord => {
+                workerRecord.absTime = workerRecord.absTime - timeDifferential;
+                console.info('workerRecord :', workerRecord);
+            });
+            console.groupEnd();
+        }
+        let allLogs = [...GLOBAL.logStack, ...logs];
+        allLogs = allLogs.sort((a, b) => a.absTime - b.absTime);
+        allLogs = allLogs.map((log, i) => Object.assign(log, {stamp: log.absTime + performance.timeOrigin, order:i}));
+        if(!showCSV) {
+            console.groupCollapsed('ALL logs (Combined and Sorted)');
+            masterLogs = [...masterLogs, ...allLogs];
+            allLogs.forEach(log => console.info('log :', log));
+            console.groupEnd();
+        }
+        console.groupCollapsed('ALL logs (Combined and Sorted)');
+        allLogs = allLogs.map(log => {
+            if(!localStorage) return log;
+            let activeEnv = localStorage.getItem('activeEnv');
+            if(!activeEnv) return log;
+            if(! /RELPARTYSERVER|CRYPTOSERVER/.test(log.type)) return log;
+            // log.type += '-' + activeEnv.toUpperCase();
+            return log;
+        });
+        allLogs.forEach(log => console.info('log :', log));
+        console.groupEnd();
+
+        return allLogs;
+    };
+
+    GLOBAL.showLogs = async (showCSV=false) => {
+        const getTime = (ISOStamp, timeOnly=true) => {
+            try{
+                return timeOnly ? new Date((+ISOStamp - tzO)).toISOString().slice(11,-1) : new Date(+ISOStamp - tzO).toISOString();
+            }catch(e){
+                console.error('Error parsing ISOStamp:', ISOStamp, e);
+                return ISOStamp;
+            }
+        }
+        const stripStartEnd = (name) => name.replace(/-(START|END)$/gi, '');
+
+        function recursivelyMoveChildLogsIntoStartNode(stack) {
+            let processedLogs   = [];
+            while (stack.length > 0) {
+                let startingMarker  = stack.shift();
+                if(/-END$/i.test(startingMarker.name)) {
+                    continue;
+                }
+                let endingMarker    = stack.findIndex(log => log.name === stripStartEnd(startingMarker.name) + '-END'),
+                dateTimeStamps  = [],
+                fullDateStamps  = [],
+                stackSubset     = [],
+                totalDuration   = 0,
+                networkLatency  = 0,
+                computeDuration = 0;
+
+                if(!~endingMarker) {
+                    stackSubset    = stack;
+                    endingMarker   = stack.length;
+                    totalDuration  = 'ONGOING';
+                    dateTimeStamps.push(getTime(startingMarker.stamp), '...?');
+                    fullDateStamps.push(getTime(startingMarker.stamp, false), '...?');
+
+                }else{
+                    stackSubset    = stack.splice(0, endingMarker+1);
+                    endingMarker   = stackSubset[stackSubset.length-1];
+                    totalDuration  = endingMarker.absTime - startingMarker.absTime;
+                    dateTimeStamps.push(getTime(startingMarker.stamp), getTime(endingMarker.stamp));
+                    fullDateStamps.push(getTime(startingMarker.stamp, false), getTime(endingMarker.stamp, false));
+
+                }
+
+                processedLogs.push(Object.assign(startingMarker, {
+                    name: stripStartEnd(startingMarker.name),
+                    children: recursivelyMoveChildLogsIntoStartNode(stackSubset),
+                    totalDuration,
+                    dateTimeStamps,
+                    fullDateStamps,
+                    networkLatency,
+                    computeDuration
+                }));
+            }
+            return processedLogs;
+        }
+
+        function recursivelyComputeCumulativeNetworkLatency(node) {
+            let nodeLatency = 0;
+            if(node.clientToServerLatency) nodeLatency += node.clientToServerLatency;
+            if(node.serverToClientLatency) nodeLatency += node.serverToClientLatency;
+
+            if (Array.isArray(node.children) && node.children.length > 0) {
+                node.children.forEach(child => {
+                    nodeLatency += recursivelyComputeCumulativeNetworkLatency(child);
+                });
+            }
+            node.networkLatency = nodeLatency;
+            return nodeLatency;
+        }
+
+        function calculateComputeDurationForNode(node) {
+            if(!node.children) return node.computeDuration = totalDuration;
+            node.computeDuration = (node.children.reduce((acc,child)=>{
+                return acc - child.totalDuration;
+            }, node.totalDuration))
+            node.children.forEach(calculateComputeDurationForNode)
+        }
+
+        let exportableStack = [];
+
+        function recursivelyOutputLogsToConsole(stack, depth = 0) {
+            let outputColors={
+                'MAINTHREAD': '#509',
+                'WORKER': '#009',
+                'RELPARTYSERVER': '#076',
+                'CRYPTOSERVER': '#700',
+                'RELPARTY': '#076',
+                'CRYPTO': '#700',
+            };
+
+            function formatNumberColumn(num, NaNValue='0.000') {
+                let opValue = isNaN(num) ? NaNValue : Math.abs(num).toFixed(3);
+                let lPadStr = ' '.repeat(12 - opValue.length);
+                return lPadStr + opValue;
+            }
+
+            stack.forEach(item => {
+                let spacePadding = ' '.repeat(100);
+                let exportableRecord = {}
+                let sequence          = item.order;
+                let nameElements      = (item.name.match(/\[(.*?)\]-(.*)$/) || new Array(3).fill('')).slice(1,3);
+                let threadName        = (nameElements[0] + spacePadding).replace('SERVER', '').slice(0, 14);
+                let processName       = (nameElements[1] + spacePadding).slice(0, 70-(depth*2));
+                let totalDuration     = formatNumberColumn(item?.totalDuration, 'ONGOING');
+                let computeDuration   = (/ONGOING/.test(totalDuration)) ? formatNumberColumn('ONGOING', 'ONGOING') : formatNumberColumn(item?.computeDuration);
+                let networkLatency    = (/ONGOING/.test(totalDuration)) ? formatNumberColumn('ONGOING', 'ONGOING') : formatNumberColumn(item?.networkLatency);
+                let cumulativeCompute;
+                if(/ONGOING/.test(totalDuration)) cumulativeCompute = formatNumberColumn('ONGOING', 'ONGOING');
+                else {
+                    if(totalDuration < (Math.abs(networkLatency) + Math.abs(computeDuration))) totalDuration = formatNumberColumn(Math.abs(networkLatency) + Math.abs(computeDuration));
+                    cumulativeCompute = formatNumberColumn((totalDuration - networkLatency - computeDuration), 'ONGOING');
+                }
+                let indentionDepth    = depth;
+                if (/^CRYPTO/.test(threadName)) {
+                    indentionDepth = depth + 2;
+                    processName  = processName.slice(0, -4);
+                }
+
+                let indentionPads     = depth > 0 ? '  '.repeat(indentionDepth-1) + '   '                          : ' ';
+                let detailPads        = depth > 0 ? '  '.repeat(indentionDepth-1) + ' '.repeat(threadName.length) + '    '  : '  ' + ' '.repeat(threadName.length);
+                let timeSpan          = item?.dateTimeStamps ? ('   ' + item.dateTimeStamps[0])           : 'N/A';
+
+                // if(!showCSV) {
+                    let outputLine = `  ${threadName}${indentionPads} ${processName} ${totalDuration} ${networkLatency} ${cumulativeCompute} ${computeDuration} ${timeSpan}`;
+                    console.groupCollapsed(`%c${outputLine}`, `color: ${outputColors[item.type]}; font-weight: 500;`);
+                    console.info(`%c${detailPads} Sequence:                    `, `color: ${outputColors[item.type]}; font-weight: 700;`, sequence);
+                    console.info(`%c${detailPads} Thread Name:                 `, `color: ${outputColors[item.type]}; font-weight: 700;`, threadName.trim());
+                    console.info(`%c${detailPads} Process Name:                `, `color: ${outputColors[item.type]}; font-weight: 700;`, processName.trim());
+                    console.info(`%c${detailPads} Abs. Performance Mark:       `, `color: ${outputColors[item.type]}; font-weight: 700;`, (item?.absTime??'') + 'ms from timeOrigin');
+                    console.info(`%c${detailPads} TimeStamp (Start):           `, `color: ${outputColors[item.type]}; font-weight: 700;`, (item?.dateTimeStamps[0]??''));
+                    console.info(`%c${detailPads} TimeStamp (End):             `, `color: ${outputColors[item.type]}; font-weight: 700;`, (item?.dateTimeStamps[1]??''));
+                    console.info(`%c${detailPads} Cumulative Tot. Duration:    `, `color: ${outputColors[item.type]}; font-weight: 700;`, (/ONGOING/.test(totalDuration) ? 'ONGOING' : totalDuration.trim() + 'ms'));
+                    console.info(`%c${detailPads} Cumulative Network Latency:  `, `color: ${outputColors[item.type]}; font-weight: 700;`, (/ONGOING/.test(networkLatency) ? 'ONGOING' : networkLatency.trim() + 'ms'));
+                    console.info(`%c${detailPads} Cumulative Compute Duration: `, `color: ${outputColors[item.type]}; font-weight: 700;`, (/ONGOING/.test(cumulativeCompute) ? 'ONGOING' : cumulativeCompute.trim() + 'ms'));
+                    console.info(`%c${detailPads} Process Compute Duration:    `, `color: ${outputColors[item.type]}; font-weight: 700;`, (/ONGOING/.test(computeDuration) ? 'ONGOING' : computeDuration.trim() + 'ms'));
+                    console.info(`%c${detailPads} ================================================================`, `color: ${outputColors[item.type]}; font-weight: 700;`, "\n\n");
+                    console.groupEnd();
+                // } else if(!showCSV || showCSV) {
+                    let activeEnv = '';
+                    let pageHost = window.location.host;
+
+                    if(localStorage && localStorage.getItem('activeEnv')) {
+                        activeEnv = (/RELPARTY|CRYPTO/.test(threadName)) ? localStorage.getItem('activeEnv') : 'N/A';
+                    }
+                    exportableRecord = {
+                        sequence          : sequence,
+                        threadName        : threadName.trim(),
+                        processName       : processName.trim(),
+                        absTime           : (item?.absTime) ? (item.absTime.toFixed(5)) : '',
+                        totalDuration     : (/ONGOING/.test(totalDuration) ? 'ONGOING' : +(totalDuration.trim())),
+                        networkLatency    : (/ONGOING/.test(networkLatency) ? 'ONGOING' : +(networkLatency.trim())),
+                        cumulativeCompute : (/ONGOING/.test(cumulativeCompute) ? 'ONGOING' : +(cumulativeCompute.trim())),
+                        computeDuration   : (/ONGOING/.test(computeDuration) ? 'ONGOING' : +(computeDuration.trim())),
+                        startTime         : (item?.fullDateStamps[0]?.replace(/[TZ]/g, ' ').trim() ?? ''),
+                        endTime           : (item?.fullDateStamps[1]?.replace(/[TZ]/g, ' ').trim() ?? ''),
+                        spawnsChildren    : item?.children ? item.children.length : 0,
+                        host              : pageHost,
+                        remoteAPIEnv      : activeEnv,
+                    };
+
+                    exportableStack.push(exportableRecord);
+                // }
+                if(item.children.length > 0) recursivelyOutputLogsToConsole(item.children, depth + 1);
+            });
+            return exportableStack.length ? exportableStack : undefined;
+        }
+
+        let allLogs = await GLOBAL.getAllLogs(showCSV);
+        let processedStack = recursivelyMoveChildLogsIntoStartNode(allLogs);
+        processedStack.forEach(root => recursivelyComputeCumulativeNetworkLatency(root));
+        processedStack.forEach(root => calculateComputeDurationForNode(root));
+        if(!showCSV) console.info(`%c${'  THREAD          PROCESS NAME                                                               DURATION      NETWORK      TOT.COMP.     COMPUTE    START TIME'}`, 'color: #000; font-weight: 700;');
+        let exportableData = recursivelyOutputLogsToConsole(processedStack);
+        console.log('exportableData :', exportableData);
+        if(!showCSV || !exportableData) return;
+        let csvData = exportableData.flatMap((log, i) => {
+            let retVal = [Object.values(log)];
+            retVal[0][0] = i + 1;
+            retVal = ['"' + retVal[0].join('","') + '"'];
+            if(i === 0) retVal.unshift('"' + Object.keys(log).join('","') + '"');
+            return retVal;
+        });
+
+        try {
+            GLOBAL.exportCount++;
+            console.groupCollapsed(`CSV Data Exported as %c${GLOBAL.sessionStamp}-${(GLOBAL.exportCount)}.csv`, 'color: #F60; font-weight: 700;');
+            let blobdtMIME = new Blob([csvData.join('\n')], { type: "text/csv" });
+            let url = URL.createObjectURL(blobdtMIME)
+            let anchor = document.createElement("a")
+            anchor.id = "download"
+            anchor.setAttribute("download", `${GLOBAL.sessionStamp}-${(GLOBAL.exportCount)}.csv`);
+            anchor.href = url;
+            anchor.click();
+            console.info(`CSV Data:\n${csvData.join('\n')}\n...EOS`);
+            URL.revokeObjectURL(url);
+            GLOBAL.logStack  = [];
+            zsmClient.callWorkerFunction("clearLogs", true);
+            console.groupEnd();
+        } catch (error) {
+            console.error('Error during download:', error);
+            console.groupEnd();
+        }
+
+        return exportableData;
+    }
+
+}
+
+export { UMFAClient, FIDO2Client };

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@ideem/zsm-client-sdk",
-    "version": "2.2.5",
-    "description": "A monolithic library exporting UMFAClient and FIDO2Client.",
+    "version": "2.4.0",
+    "description": "ZSM makes 2FA easy and invisible for everyone, all the time, using advanced cryptography like MPC to establish cryptographic proof of the origin of any transaction or login attempt, while eliminating opportunities for social engineering. ZSM has no reliance on specific hardware. Our cryptographic module has completed FIPS 140-3 NIST approved lab testing, is FIDO2-ready, and is on the Modules In Progress (MIP) list. Superior Usability. no opt-in, no codes, no downloads, no authenticator apps. Better Security.",
     "author": "@JJ (Jason Jurusz) <jj@useideem.com>/<nerdy.deeds@done.cheap>",
     "keywords": [
         "ideem",
@@ -22,7 +22,7 @@
     ],
     "scripts": {
         "start": "echo 'This is a library, not an application. No start script defined. To use, import the library.'",
-        "inc": "npm version patch && cd ..; sleep 1; npm pack ./npm-package"
+        "inc": "npm version patch && cd ..; sleep 1; npm pack ./pkg_files"
     },
     "collaborators": [
         "Joel Teply <joel@useideem.com>",
@@ -30,20 +30,25 @@
         "Brian Koziel <brian@useideem.com>",
         "@JJ <jj@useideem.com>"
     ],
-    "main": "zsm-client-sdk.js",
-    "module": "zsm-client-sdk.js",
-    "browser": "zsm-client-sdk.js",
     "license": "SEE LICENSE IN LICENSE",
     "repository": {
         "type": "git",
-        "url": "https://github.com/useideem/vHSM.git"
+        "url": "github:useideem/vHSM"
     },
-    "bugs": "https://github.com/useideem/vHSM/issues",
     "homepage": "http://useideem.com",
+    "bugs": "https://github.com/useideem/vHSM/issues",
     "files": [
-        "zsm-client-sdk.js"
+        "worker.js",
+        "ZSMClientSDK.js",
+        "RELEASE_NOTES.txt",
+        "LICENSE",
+        "README.md"
     ],
     "engines": {
-        "node": ">=20.0.0"
-    }
+        "node": ">=12.0.0"
+    },
+    "sideEffects": [
+        "worker.js",
+        "ZSMClientSDK.js"
+    ]
 }