@ideem/zsm-client-sdk 2.8.1 → 2.9.1

package/CHANGELOG.md

@@ -12,7 +12,18 @@ and Universal MFA into a browser application.
 
 ----
 
-## Release 2.8.1 - Mat 8, 2026 [ NPM PACKAGE RELEASE ] **latest release**
+## Release 2.9.1 - June 18, 2026 [ NPM PACKAGE RELEASE ] **latest release**
+  - Minor bug fixes and improvements
+  - Provides a workaround for an issue in which certain browser extensions (e.g. credential managers) interfere with the webauthn flows by overriding the `navigator.credentials.get` method.
+  - Adds a new property to the data returned by `checkAllEnrollments()` called `isUsingPasswordManager`, which is a boolean that indicates whether or not the `navigator.credentials.get` method has been overridden by an external source (e.g. a browser extension like a password manager). This allows consumers to detect when their users are using password managers that may interfere with the webauthn flows, and adjust their UI/UX accordingly (e.g. by displaying a warning message about potential issues with password managers, or by providing additional guidance on how to use the SDK effectively in conjunction with password managers).
+  
+## Release 2.9.0 - May 17, 2026
+- Adds an optional `installation_id` override mechanism for bridging contexts:
+  - Rust extern `__ideem_get_install_id_override_v1` declared on `globalThis` via `#[wasm_bindgen(catch)]`, embedded in `WASMRustInterface.js` (which runs in the page context).
+  - Consumers install the JS-side getter at page scope: `globalThis.__ideem_get_install_id_override_v1 = () => value`.
+- Non-bridging contexts unchanged — `InstallationID::get()` falls through to the existing IndexedDB-derived value when no override getter is installed (the `catch` arm in the extern handles the missing-getter case).
+
+## Release 2.8.1 - Mat 8, 2026 [ NPM PACKAGE RELEASE ]
 - Minor bug fixes and improvements
 - Alters Webauthn object to provide Passkeys+ support Android WebViews
 

package/ErrorHandler.js

@@ -1,154 +1 @@
-/**
- * @file            zsm-client-sdk/ErrorHandler.js
- * @name            ErrorHandler
- * @description     A centralized error handling singleton for managing sequential errors in ZSM client SDK operations, intended to facilitate self-healing from repeated Relying Party server operation errors.
- * @param           {ZSMAPI}        zsmAPIInstance          An optional instance of a ZSM API (e.g., WebAuthnClient) to facilitate local credential purging.
- * @setter          {ZSMAPI}        ERR.zsmAPI              Sets the ZSM API instance (WebAuthnClient, etc.) to facilitate local credential purging.
- * @setter          {string}        ERR.userIdentifier      Sets the active userIdentifier (used for local credential purging).
- * @method          ERR.error(errType, message, options)    Generates & returns an Error object, increments sequential error count, and triggers individual or global IDB record purging (by count)
- * @method          ERR.reset()                             Resets the sequential error count to zero.
- * @exports         ERR                                     An instance of the ErrorHandler singleton.
- * 
- * @notes           IMPORTANT: If unable to unbind the active user at 3+ errors, or either setter value is unset, OR the count reaches 5, the entire ideem IndexedDB gets purged.
- * 
- * @notes           IMPORTANT: the `reset()` method MUST be called to reset the sequential error count upon successful transaction with the RP (see: makePostRequest in RelyingPartyBase.js).
- * 
- * @notes           IMPORTANT: This class relies on a valid userIdentifier and zsmAPIInstance being set PRIOR to invoking the error() method to facilitate local credential purging when necessary.
- * @example         ERR.zsmAPI = webAuthnClientInstance;                                                                              // Set the ZSM API instance (e.g., WebAuthnClient)
- * @example         ERR.userIdentifier = 'user123';                                                                                   // Set the active userIdentifier
- * @example         throw new Error("An example error.");                                                                      // Generate and throw an error via the ErrorHandler
- * 
- * @notes           The sequential error count is persisted in sessionStorage to survive page reloads within the same browser session.
- * 
- */
-class ErrorHandler {
-    #sequentialErrorCount;                                                                                                            // Number of sequential errors encountered
-    #zsmAPIInstance       = null;                                                                                                     // Instance of ZSM API (e.g., WebAuthnClient)
-    #activeUserIdentifier = null;                                                                                                     // Currently active userIdentifier
-
-    constructor(zsmAPIInstance=null) {
-        try {   this.#sequentialErrorCount = Number(sessionStorage.getItem('zsmSequentialErrorCt') || 0); }                           // Try to retrieve sequential error count from sessionStorage...
-        catch { this.#sequentialErrorCount = 0; }                                                                                     // ...and roll over to 0 if unable to do so (or it's absent)
-        this.#zsmAPIInstance               = zsmAPIInstance                                        || null;                           // Set ZSM API instance if provided, else null
-    }
-
-    get #count()           { return this.#sequentialErrorCount; }                                                                     // Get sequential error count
-    set #count(v)          { try { sessionStorage.setItem('zsmSequentialErrorCt', (this.#sequentialErrorCount = v)); }catch(e){} }    // Set sequential error count and store in sessionStorage
-    get #userIdentifier()  { return this.#activeUserIdentifier; }                                                                     // Get active userIdentifier
-    set userIdentifier(id) { return (this.#activeUserIdentifier = id); }                                                              // Set active userIdentifier
-    get #zsmAPI()          { return this.#zsmAPIInstance; }                                                                           // Get ZSM API instance
-    set zsmAPI(instance)   { return (this.#zsmAPIInstance = instance); }                                                              // Set ZSM API instance
-
-    /** 
-     * @name            purgeLocalCredentialForActiveUser
-     * @description     Attempts to purge the local ZSM credential data for the currently active userIdentifier via the associated ZSM API instance. Failing that, purges the entire local IndexedDB database.
-     * @throws          {Promise<void>}                 Rollover functionality (full reset) is triggered if userIdentifier or zsmAPIInstance is unset, or unable to unbind active user
-     * @returns         {Promise<void>}
-     * @memberOf        ErrorHandler
-     * @private
-     * @async
-     */
-    async #purgeLocalCredentialForActiveUser() {
-        try {
-            
-            const uid = this.#userIdentifier;                                                                                         // Use the active userIdentifier...
-            if(!uid || uid === '')   throw new Error(`No active userIdentifier is set on this ErrorHandler.`);                        // ...or throw an error if not set
-            if(this.#zsmAPI == null) throw new Error(`No ZSM API instance is associated with this ErrorHandler.`);                    // Throw an error if no WebAuthnClient instance is yet set
-            await this.#zsmAPI.unbindFromDevice(uid);                                                                                 // Attempt to unenroll the active user from the device via the WebAuthnClient
-            console.info(`[ErrorHandler] :: Local ZSM credential data purged for ${uid}`);
-        } catch (err) {
-            console.warn(new Error(`[ErrorHandler] :: purgeLocalCredentialForActiveUser :: ${err.message}.`, err));
-            console.warn(`\n\nBecause local credential purge failed, attempting to purge entire local IndexedDB instead.`);
-            this.#purgeLocalIDB();                                                                                                    // If unable to unbind the active user, purge the entire IndexedDB instead
-        }
-    }
-
-    /**
-     * @name            purgeLocalIDB
-     * @description     Attempts to purge the entire local IndexedDB database named 'ideem', removing all credential and ZSM data.
-     * @returns         {void}
-     * @memberOf        ErrorHandler
-     * @private
-     */
-    #purgeLocalIDB() {
-        try {
-            indexedDB.deleteDatabase('ideem');                                                                                        // Delete the entire 'ideem' IndexedDB database
-            console.info(`[ErrorHandler] :: Local IndexedDB purged of all credential and ZSM data.`);
-        } catch (err) {
-            console.error(`[ErrorHandler] :: purgeLocalIDB :: Unable to purge local IndexedDB (usually this is due to the local store being absent).\nDetails:\n`, err);
-        }
-    }
-
-    /**
-     * @name            processErrorCountsForGeneratedError
-     * @description     Processes the sequential error count after an error has been generated, triggering local credential or IndexedDB purging as necessary.
-     * @param           {Error}         errOP               The newly-generated or amended error object.
-     * @returns         {Error}                             The same error object passed in, for chaining.
-     * @memberOf        ErrorHandler
-     * @private
-     */
-    #processErrorCountsForGeneratedError(errOP) {
-        if(this.#count === 3) {                                                                                                       // IF sequential error count is exactly 3...
-            this.#purgeLocalCredentialForActiveUser();                                                                                //   ...purge local credential for active user
-        } else if(this.#count >= 5) {                                                                                                 // ELSE IF sequential error count is 5 or more...
-            this.#purgeLocalIDB();                                                                                                    //   ...purge entire local IndexedDB
-            this.reset();                                                                                                             //   ...reset the sequential error count
-        }
-        return errOP;                                                                                                                 // Return the [new|amended] error object
-    }
-    
-    /**
-     * @name            reset
-     * @description     Resets the sequential error count to zero and persists the change in sessionStorage.
-     * @param           {...any}        args                Optional arguments to pass through transparently.
-     * @returns         {void|any|Array<any>}               For 0 args: undefined; 1 arg: that arg; multiple args: array of those args.
-     * @memberOf        ErrorHandler
-     */
-    reset(...args) {
-        this.#count = 0;                                                                                                              // Reset the sequential error count and store it in sessionStorage
-        console.info(`[ErrorHandler] :: reset :: Sequential Error Count reset to 0.`);                                                // Log the reset action
-        return    (typeof args === 'array' && args.length === 0) ? void(0)                                                            // Pass through received arguments transparently, if any
-                : (typeof args === 'array' && args.length === 1) ? args[0] 
-                : args;
-    }
-
-    /**
-     * @name            error
-     * @description     Generates & returns an Error object, increments sequential error count, and triggers individual or global IDB record purging (by count)
-     * @param           {function|Error}       errType         Either an Error constructor function (e.g., Error, TypeError; counted) or existing Error object to amend (not counted).
-     * @param           {string}               message         The error message to associate with the generated or amended Error object.
-     * @param           {Object}               options         Optional additional options to pass to the Error constructor.
-     * @returns         {Error}                                The newly-generated or amended Error object.
-     * @memberOf        ErrorHandler
-     * @notes           This method is designed to be resilient as hell; if anything's wrong with its invocation, it will STILL return a valid Error object (albeit a generic one).
-     */
-    error(errType=Error, message="An error occurred.", options={}) {
-        let errOP;
-        try {
-            if(typeof message !== 'string') message = "An error occurred.";                                                           // Ensure message is a string (or supplant it with a default)
-            if(options == null || typeof options !== 'object') options = {};                                                          // Ensure options is an object (or supplant it with an empty one)
-            if(typeof errType === 'string') {                                                                                         // [NEW ERROR] Only the error message was provided as a string...
-                message = errType;                                                                                                    // ...so shift it into the message...
-                errType = Error;                                                                                                      // ...and set errType to the generic Error constructor
-            } else if(typeof errType === 'function') {                                                                                // [NEW ERROR] A constructor function was provided
-                errOP = new errType(message, options);                                                                                // Attempt to create the error object
-                if(!(errOP instanceof Error)) {                                                                                       // IF the newly-created object is NOT an Error...
-                    errOP = new Error(message, options);                                                                              //   ...replace it with a generic Error object (still with message & options)
-                }
-                this.#count = this.#count + 1;                                                                                        // Increment the sequential error count
-            } else if (errType instanceof Error) {                                                                                    // [EXISTING ERROR] An existing error object was provided
-                errOP = new errType.constructor(message, options);                                                                    // Create a new Error object of the previous's prototype...
-                errOP.cause = errType;                                                                                                // ...and leverage its cause to preserve the causal stack trace
-            } else {                                                                                                                  // [INVALID INPUT] Neither a constructor function nor an existing error object was provided
-                throw new Error(`Invalid errType provided to ErrorHandler.error(): must be either an Error constructor function or an existing Error object.`);
-            }
-            return this.#processErrorCountsForGeneratedError(errOP);                                                                  // Post-process the count and return the [new|amended] error object
-        }catch(e) {
-            this.#count = this.#count + 1;                                                                                            // Increment the sequential error count
-            errOP = new Error(`[ErrorHandler] :: error :: An error occurred while attempting to process another error.\nDetails:\n${e.message}\n\nOriginal Error Message:\n${message}`);
-            return this.#processErrorCountsForGeneratedError(errOP);                                                                  // Post-process the count and return the rollover hail mary error object
-        }
-    }
-}
-const ERR = new ErrorHandler();                                                                                              // Export a singleton instance of the ErrorHandler
-export default ERR 
+const r=new class{#r;#e=null;#t=null;constructor(r=null){try{this.#r=Number(sessionStorage.getItem("zsmSequentialErrorCt")||0)}catch{this.#r=0}this.#e=r||null}get#n(){return this.#r}set#n(r){try{sessionStorage.setItem("zsmSequentialErrorCt",this.#r=r)}catch(r){}}get#o(){return this.#t}set userIdentifier(r){return this.#t=r}get#s(){return this.#e}set zsmAPI(r){return this.#e=r}async#i(){try{const r=this.#o;if(!r||""===r)throw new Error("No active userIdentifier is set on this ErrorHandler.");if(null==this.#s)throw new Error("No ZSM API instance is associated with this ErrorHandler.");await this.#s.unbindFromDevice(r),console.info(`[ErrorHandler] :: Local ZSM credential data purged for ${r}`)}catch(r){console.warn(new Error(`[ErrorHandler] :: purgeLocalCredentialForActiveUser :: ${r.message}.`,r)),console.warn("\n\nBecause local credential purge failed, attempting to purge entire local IndexedDB instead."),this.#a()}}#a(){try{indexedDB.deleteDatabase("ideem"),console.info("[ErrorHandler] :: Local IndexedDB purged of all credential and ZSM data.")}catch(r){console.error("[ErrorHandler] :: purgeLocalIDB :: Unable to purge local IndexedDB (usually this is due to the local store being absent).\nDetails:\n",r)}}#c(r){return 3===this.#n?this.#i():this.#n>=5&&(this.#a(),this.reset()),r}reset(...r){return this.#n=0,console.info("[ErrorHandler] :: reset :: Sequential Error Count reset to 0."),"array"==typeof r&&0===r.length?void 0:"array"==typeof r&&1===r.length?r[0]:r}error(r=Error,e="An error occurred.",t={}){let n;try{if("string"!=typeof e&&(e="An error occurred."),null!=t&&"object"==typeof t||(t={}),"string"==typeof r)e=r,r=Error;else if("function"==typeof r)n=new r(e,t),n instanceof Error||(n=new Error(e,t)),this.#n=this.#n+1;else{if(!(r instanceof Error))throw new Error("Invalid errType provided to ErrorHandler.error(): must be either an Error constructor function or an existing Error object.");n=new r.constructor(e,t),n.cause=r}return this.#c(n)}catch(r){return this.#n=this.#n+1,n=new Error(`[ErrorHandler] :: error :: An error occurred while attempting to process another error.\nDetails:\n${r.message}\n\nOriginal Error Message:\n${e}`),this.#c(n)}}};export default r;

package/EventCoordinator.js

@@ -1,295 +1 @@
-import GLOBAL from './GlobalScoping.js';
-
-// baseStack is a Map that holds the initial state of the event stack. It is defaulted to those classes that are ALWAYS present in the ZSMClient package, and
-// constitutes the minimum set of classes that are both expected in ALL permutations of the SDK, and which are REQUIRED for the ZSMClient package to function.
-// Additional classes are added contextually (their status STARTING at "PENDING") when the client app imports them, and CAN remove a baseStack entry entirely.
-// Each event inside represents a class used by the NPM Package's "main" export - ZSMClientSDK - and tracks its status throughout its initialization lifecycle
-// (status include: UNREGISTERED, PENDING, READY, or ERROR). Each time a class's status changes, the event stack is updated, and, once all classes reach their
-// respective READY statuses, the ZSMClient package is considered fully initialized, and a custom event is dispatched to notify the client app that the SDK is
-// finished loading and is ready for use. Additional possible event stack entries (at time of this writing) include: WORKER, PERFORMANCELOGGER, PASSKEYCLIENT.
-
-let baseStack = new Map([
-    ["SELECTEDCLIENT", "UNREGISTERED"], // Active client class - UMFAClient or FIDO2Client (dynamically set by client's import choice) - that's being imported
-    ["RELYINGPARTY",   "UNREGISTERED"], // The RelyingParty class (extended from RelyingPartyBase) used for registration/authentication calls to the RP Server
-    ["WEBAUTHNCLIENT", "UNREGISTERED"]  // The WebAuthnClient class (extended from WebAuthnClientBase) used to coordinate the MPCRound calls to the ZSM Server
-]);
-
-// EventCoordinator is a class instance that both represents and manages the event stack, allows for dynamically updating class initialization statuses (along
-// with dispatching the relevant custom events associated with those changes), and provides a means for additional, plug-in NPM Packages' classes to be added,
-// monitored, and included in the overall ZSMClient package's readiness state. Note: the act of importing EventCoordinator (or any other package, really) will
-// initialize it as a singleton, so it manages its own state, and there is no concern if it is imported multiple times; it always refers to the same instance.
-class EventCoordinator {
-    constructor(initialStack = baseStack) {
-        this.coreSDKClass    = null;                                    // The core SDK class that is user-facing (if any; usually ZSMClientSDK)
-        this._selectedClient = null;                                    // The active customer-facing SDK client (UMFAClient or FIDO2Client)
-        this._eventStack     = new Map(initialStack);                   // Clone the initialStack provided to ensure it isn't modified by reference
-        this.cleanState      = new Map(initialStack);                   // Store the initial state of the event stack as cleanState, so it can be reset later
-        
-        // Even if the GLOBAL scope does not support event dispatches, while we will not be able to dispatch events, we can still manage the app's event stack
-        this.scopeSupportsEventDispatch = (typeof GLOBAL.dispatchEvent === 'function' && typeof CustomEvent === 'function');
-    }
-    get supported()      { return this.scopeSupportsEventDispatch;                 }                    // Returns true/false if GLOBAL scope supports events
-    get statusOptions()  { return ['UNREGISTERED', 'PENDING', 'READY', 'ERROR'];   }                    // Returns the possible status options for events
-    get stack()          { return this._eventStack;                                }                    // Returns the current event stack as a Map
-    get length()         { return [...this._eventStack.keys()].length;             }                    // Returns count of all events in the stack
-    get keys()           { return [...this._eventStack.keys()];                    }                    // Returns array of event names in the stack
-    get values()         { return [...this._eventStack.values()];                  }                    // Returns array of event statuses in the stack
-    get entries()        { return [...this._eventStack.entries()];                 }                    // Returns array of [name, status] pairs in the stack
-    get object()         { return Object.fromEntries(this.entries);                }                    // Returns the event stack as a plain object
-    get unregistered()   { return this.lengthByStatus('UNREGISTERED');             }                    // Returns count of events with status "UNREGISTERED"
-    get pending()        { return this.lengthByStatus('PENDING');                  }                    // Returns count of events with status "PENDING"
-    get ready()          { return this.lengthByStatus('READY');                    }                    // Returns count of events with status "READY"
-    get error()          { return this.lengthByStatus('ERROR');                    }                    // Returns count of events with status "ERROR"
-    get incomplete()     { return this.length - this.ready;                        }                    // Returns count of events that are NOT "READY"
-    get containsErrors() { return this.error > 0;                                  }                    // Returns true/false if any events' status is "ERROR"
-    get done()           { return (this.ready === this.length);                    }                    // Returns true/false if all events are "READY"
-    get client()         { return this._selectedClient;                            }                    // Returns the currently selected client (UMFA/FIDO2)
-    get status()         { return this.containsErrors ? 'ERROR' 
-                                : this.done           ? 'READY'
-                                : !!this.unregistered ? 'INCOMPLETE REGISTRATIONS' 
-                                : 'PENDING';                                       }
-    set client(value)    { this._selectedClient = value;                           }                    // Returns the currently selected client (UMFA/FIDO2)
-    set coreReady(value) { this.coreSDKClass.ready          = !!value;             }
-    set coreErrs(value)  { this.coreSDKClass.containsErrors = !!value;             }
-
-    /**
-     * @name            setCoreSDKClass
-     * @description     Sets the core SDK class reference on the EventCoordinator instance, and defines its "finished" method.
-     * @param           {string}            classDesc       The name of the client class being initialized (UMFAClient or FIDO2Client).
-     * @param           {Object}            classRef        The reference to the core SDK class being initialized.
-     * @returns         {void}
-     */
-    setCoreSDKClass(classDesc, classRef) {
-        const core = (this.coreSDKClass = classRef);                            // Set a reference to the core class on the singleton instance, then...
-        core.ready = false;                                                     // ... set its default ready state to false
-        core.containsErrors = false;                                            // ... set its default containsErrors state to false
-        Object.defineProperty(core, "finished", {                               // ... and define a "finished" function on the core object...
-            value: this.finished.bind(this),                                    //     ... binding it to the method on this singleton instance
-            enumerable: false, writable: false, configurable: false             //     ... and making it non-enumerable, non-writable, and non-configurable
-        });
-        this.specifyClient(classDesc);                                          // ... finally, specify the client class that is being initialized.
-    }
-
-    /**
-     * @name            specifyClient
-     * @description     Specifies the active client class (UMFAClient or FIDO2Client) being initialized.
-     * @param           {string}            selectedClient     The name of the client class being initialized (UMFAClient or FIDO2Client).
-     * @returns         {void}
-     */
-    specifyClient(selectedClient) {
-        if (!selectedClient || typeof selectedClient !== 'string' || !selectedClient.length) 
-            throw new TypeError(`[ZSM EventCoordinator] :: specifyClient :: Invalid 'selectedClient' value: "${selectedClient}". 'selectedClient' is required and expects a String.`);
-
-        if (this.client == null) {
-            this._eventStack.delete('SELECTEDCLIENT');
-            this.cleanState.delete('SELECTEDCLIENT');
-            this.client = selectedClient.toUpperCase();
-        }
-    }
-
-    /**
-     * @name            summarizeEventStack
-     * @description     Logs a summary of the current event stack to the console.
-     * @param           {...any}            triggerData     Additional data to include in the log (e.g., the event that triggered the update).
-     * @returns         {void}
-     */
-    summarizeEventStack (...triggerData) {
-        let summaryObject = this.object,
-            { client, containsErrors, done } = this;
-
-        summaryObject[`counts (${this.length})`] = {
-            total        : this.length,
-            unregistered : this.unregistered,
-            pending      : this.pending,
-            ready        : this.ready,
-            error        : this.error
-        };
-
-        let opFn = (typeof console?.l === 'function') ? console.l : console.log;
-        opFn(`[ZSM EventCoordinator] :: Event Update!\n${(!!triggerData.length) ? `(ACTIVE EVENT: '${triggerData.join(': ')}')\n` : ''}  Status summary:\n`, Object.assign({client, containsErrors, done}, summaryObject));
-    }
-
-    /**
-     * @name            dispatchEvent
-     * @description     Dispatches a custom event with the given name and detail.
-     * @param           {string}            classDesc       The name of the event to dispatch.
-     * @param           {Object}            eventDetail     The detail object to attach to the event.
-     * @returns         {void}
-     */
-    dispatchEvent(eventName, eventDetail={}) {
-        if (!this.scopeSupportsEventDispatch) return;
-        GLOBAL.dispatchEvent(new CustomEvent(eventName, { detail: eventDetail }));
-    }
-
-    /**
-     * @name            update
-     * @description     Updates the status of a specific event in the event stack.
-     * @param           {string}            classDesc       The name of the event to update.
-     * @param           {string}            eventStatus     The new status for the event (accepts: UNREGISTERED, PENDING, READY, ERROR).
-     * @throws          {TypeError}                         If the classDesc is invalid or eventStatus is not one of the allowed values.
-     * @returns         {Object}                            Returns the updated event stack object.
-     */
-    update (classDesc, eventStatus="PENDING") {    
-        if (!classDesc || typeof classDesc !== 'string' || !classDesc.length) 
-            throw new TypeError(`[ZSM EventCoordinator] :: update :: Invalid 'classDesc' value: "${classDesc}". 'classDesc' is required and expects a String.`);
-
-        if(classDesc === 'SELECTEDCLIENT'){
-            if(!this.client) throw new TypeError(`[ZSM EventCoordinator] :: update :: Status for 'SELECTEDCLIENT' cannot be updated until a client is specified!`);
-            classDesc = this.client;
-        }
-        classDesc = classDesc.toUpperCase();
-
-        eventStatus =  (!eventStatus || typeof eventStatus !== 'string' || !eventStatus.length) ? "PENDING" : eventStatus.toUpperCase();
-
-        if (!this.statusOptions.includes(eventStatus)) 
-            throw new TypeError(`[ZSM EventCoordinator] :: update :: Invalid 'eventStatus' value: "${eventStatus}". Accepts: ${this.statusOptions.join(', ')}.`);
-
-        this._eventStack.set(classDesc, eventStatus);
-
-        if( this.containsErrors ) {
-            const errorMsg = `[ZSM EventCoordinator] :: Initialization Error! :: The ZSMClient initialization contains errors and is unable to continue!]\nModules containing errors:\n  - ${this.byStatus('ERROR').join('\n  -')}.`;
-            this.coreErrs = true; // Set the core SDK class error state to true
-            if(window && window?.queueMicrotask) {
-                queueMicrotask(() => this.dispatchEvent('ZSMClientError', {
-                    message: errorMsg,
-                    modules: this.byStatus('ERROR')
-                }));
-            }else  this.dispatchEvent('ZSMClientError', { message: errorMsg, modules: this.object });
-            console.error(errorMsg);
-            return this.object; // don't throw here
-        }
-
-        if (this.done) {
-            this.coreReady = true; // Set the core SDK class ready state to true
-            if(window && window?.queueMicrotask) {
-                queueMicrotask(() => this.dispatchEvent('ZSMClientReady', {
-                    ready: true
-                }));
-            }else  this.dispatchEvent('ZSMClientReady', { ready: true });
-        }
-
-        if(GLOBAL.showEvents) this.summarizeEventStack(classDesc, eventStatus);
-        return this.object;
-    }
-    
-    /**
-     * @name            byStatus
-     * @description     Retrieves all event names that match a specific status.
-     * @param           {string}            eventStatus     The status to filter events by (accepts: UNREGISTERED, PENDING, READY, ERROR).
-     * @throws          {TypeError}                         If the eventStatus is invalid or not one of the allowed values.
-     * @returns         {Array}                             Returns an array of event names that match the specified status.
-     */
-    byStatus(eventStatus) {
-        if (!eventStatus || typeof eventStatus !== 'string' || !eventStatus.length || !["UNREGISTERED", "PENDING", "READY", "ERROR"].includes(eventStatus)) 
-            throw new Error(`[ZSM EventCoordinator] :: byStatus :: Invalid 'eventStatus' value: "${eventStatus}". Valid statuses are: UNREGISTERED, PENDING, READY, ERROR.`);
-        return this.entries.flatMap(([k, v]) => v === eventStatus ? [k] : []);
-    }
-
-    /**
-     * @name            lengthByStatus
-     * @description     Returns the count of events that match a specific status.
-     * @param           {string}            eventStatus     The status to filter events by (accepts: UNREGISTERED, PENDING, READY, ERROR).
-     * @throws          {TypeError}                         If the eventStatus is invalid or not one of the allowed values.
-     * @returns         {number}                            Returns the count of events with the specified status.
-     */
-    lengthByStatus(eventStatus) {
-        return this.byStatus(eventStatus).length || 0;
-    }
-
-    /**
-     * @name            reset
-     * @description     Resets the event stack to its initial state (cleanState).
-     * @returns         {Object}                            Returns the reset event stack object.
-     */
-    reset() {
-        this.keys.forEach(key => this._eventStack.set(key, 'PENDING'));
-
-        if(window && window?.queueMicrotask) {
-            queueMicrotask(() => this.dispatchEvent('ZSMClientEventStackReset', { stack: this.object }));
-        } else  this.dispatchEvent('ZSMClientEventStackReset', { stack: this.object });
-        return this.object;
-    }
-
-    /**
-     * @name            finished
-     * @description     Waits for the ZSMClient initialization to complete, either by checking the done state or by listening for the ZSMClientReady event.
-     * @param           {function|number}   callbackFnOrTimeout     A callback function to call when the initialization is done, or a timeout in milliseconds to wait before rejecting.
-     * @param           {function|any}      callbackFnOrFirstArg    An optional callback function to call when the initialization is done (if timeout is specified), or the first argument to pass to the callback function.
-     * @param           {array<any>}        args                    Additional arguments to pass to the callback function.
-     * @returns         {Promise<boolean>}                          Resolves to true if the initialization is done, or rejects with an error if it takes too long or contains errors.
-     * @throws          {Error}                                     If the initialization takes too long or contains errors.
-     * @throws          {Error}                                     If some portion of the initialization fails.
-     */
-    async finished(callbackFnOrTimeout, callbackFnOrFirstArg, ...args) {
-        if (this.done) return Promise.resolve(true);
-
-        let timeoutID,
-            callbackFn,
-            onSDKReady,
-            onSDKError,
-            terminatePoll = false, 
-            timeoutDuration = 20000;
-
-        if(!isNaN(callbackFnOrTimeout)) {
-            timeoutDuration = callbackFnOrTimeout;
-            if(typeof callbackFnOrFirstArg === 'function') {
-                callbackFn = callbackFnOrFirstArg;
-            }
-        }else if(typeof callbackFnOrTimeout === 'function') {
-            callbackFn = callbackFnOrTimeout;
-            args.unshift(callbackFnOrFirstArg);
-        }
-
-        return new Promise((resolve, reject) => {
-            onSDKReady = () => { 
-                terminatePoll = true;
-                if(callbackFn) callbackFn(...args);                                         // Call the callback function if provided
-                resolve(true);                                                              // Resolve the promise with a value of true
-            };
-            onSDKError = (e) => { 
-                terminatePoll = true;
-                reject(new Error(`[ZSM EventCoordinator] :: finished :: Initialization Error! :: ${e.message || e}\nModules containing errors:\n  - ${this.byStatus('ERROR').join('\n  -')}.`));
-            };
-            if (this.done) onSDKReady();
-            if (this.containsErrors) onSDKError({ detail: { modules: this.byStatus('ERROR') } });
-
-            const onTimeout = () => {
-                terminatePoll = true;
-                if (this.done) return;
-                reject(new Error("[ZSM EventCoordinator] :: Timeout Error: ZSMClient initialization took too long to complete. Please check your network connection or server status."));
-            };
-
-            timeoutID = setTimeout(onTimeout, timeoutDuration);
-
-            if (this.scopeSupportsEventDispatch) {
-                GLOBAL.addEventListener('ZSMClientReady', onSDKReady, { once: true });
-                GLOBAL.addEventListener('ZSMClientError', onSDKError, { once: true });
-            } else {
-                const poll = () => {
-                    if (this.done) {
-                        onSDKReady();
-                    } else if (this.containsErrors) {
-                        onSDKError("[ZSM EventCoordinator] :: finished :: Error: ZSMClient initialization contains errors and is unable to continue.");
-                    }
-                    else if (!terminatePoll) setTimeout(poll, 200);
-                };
-                poll();
-            }
-        })
-        .catch(err => {
-            throw new Error(`[ZSM EventCoordinator] :: finished :: Initialization Error! :: ${err.message || err}\nModules containing errors:\n  - ${this.byStatus('ERROR').join('\n  -')}.`);
-        })
-        .finally(() => {
-            clearTimeout(timeoutID);
-            if (this.scopeSupportsEventDispatch) {
-                GLOBAL.removeEventListener('ZSMClientReady', onSDKReady);
-                GLOBAL.removeEventListener('ZSMClientError', onSDKError);
-            }
-        });
-    }
-}
-
-const eventCoordinator = new EventCoordinator(); // Create a singleton instance of EventCoordinator
-
-export default eventCoordinator;
-export { eventCoordinator };
+import t from"./GlobalScoping.js";let e=new Map([["SELECTEDCLIENT","UNREGISTERED"],["RELYINGPARTY","UNREGISTERED"],["WEBAUTHNCLIENT","UNREGISTERED"]]);const n=new class{constructor(n=e){this.coreSDKClass=null,this._selectedClient=null,this._eventStack=new Map(n),this.cleanState=new Map(n),this.scopeSupportsEventDispatch="function"==typeof t.dispatchEvent&&"function"==typeof CustomEvent}get supported(){return this.scopeSupportsEventDispatch}get statusOptions(){return["UNREGISTERED","PENDING","READY","ERROR"]}get stack(){return this._eventStack}get length(){return[...this._eventStack.keys()].length}get keys(){return[...this._eventStack.keys()]}get values(){return[...this._eventStack.values()]}get entries(){return[...this._eventStack.entries()]}get object(){return Object.fromEntries(this.entries)}get unregistered(){return this.lengthByStatus("UNREGISTERED")}get pending(){return this.lengthByStatus("PENDING")}get ready(){return this.lengthByStatus("READY")}get error(){return this.lengthByStatus("ERROR")}get incomplete(){return this.length-this.ready}get containsErrors(){return this.error>0}get done(){return this.ready===this.length}get client(){return this._selectedClient}get status(){return this.containsErrors?"ERROR":this.done?"READY":this.unregistered?"INCOMPLETE REGISTRATIONS":"PENDING"}set client(t){this._selectedClient=t}set coreReady(t){this.coreSDKClass.ready=!!t}set coreErrs(t){this.coreSDKClass.containsErrors=!!t}setCoreSDKClass(t,e){const n=this.coreSDKClass=e;n.ready=!1,n.containsErrors=!1,Object.defineProperty(n,"finished",{value:this.finished.bind(this),enumerable:!1,writable:!1,configurable:!1}),this.specifyClient(t)}specifyClient(t){if(!t||"string"!=typeof t||!t.length)throw new TypeError(`[ZSM EventCoordinator] :: specifyClient :: Invalid 'selectedClient' value: "${t}". 'selectedClient' is required and expects a String.`);null==this.client&&(this._eventStack.delete("SELECTEDCLIENT"),this.cleanState.delete("SELECTEDCLIENT"),this.client=t.toUpperCase())}summarizeEventStack(...t){let e=this.object,{client:n,containsErrors:s,done:i}=this;e[`counts (${this.length})`]={total:this.length,unregistered:this.unregistered,pending:this.pending,ready:this.ready,error:this.error},("function"==typeof console?.l?console.l:console.log)(`[ZSM EventCoordinator] :: Event Update!\n${t.length?`(ACTIVE EVENT: '${t.join(": ")}')\n`:""}  Status summary:\n`,Object.assign({client:n,containsErrors:s,done:i},e))}dispatchEvent(e,n={}){this.scopeSupportsEventDispatch&&t.dispatchEvent(new CustomEvent(e,{detail:n}))}update(e,n="PENDING"){if(!e||"string"!=typeof e||!e.length)throw new TypeError(`[ZSM EventCoordinator] :: update :: Invalid 'classDesc' value: "${e}". 'classDesc' is required and expects a String.`);if("SELECTEDCLIENT"===e){if(!this.client)throw new TypeError("[ZSM EventCoordinator] :: update :: Status for 'SELECTEDCLIENT' cannot be updated until a client is specified!");e=this.client}if(e=e.toUpperCase(),n=n&&"string"==typeof n&&n.length?n.toUpperCase():"PENDING",!this.statusOptions.includes(n))throw new TypeError(`[ZSM EventCoordinator] :: update :: Invalid 'eventStatus' value: "${n}". Accepts: ${this.statusOptions.join(", ")}.`);if(this._eventStack.set(e,n),this.containsErrors){const t=`[ZSM EventCoordinator] :: Initialization Error! :: The ZSMClient initialization contains errors and is unable to continue!]\nModules containing errors:\n  - ${this.byStatus("ERROR").join("\n  -")}.`;return this.coreErrs=!0,window&&window?.queueMicrotask?queueMicrotask(()=>this.dispatchEvent("ZSMClientError",{message:t,modules:this.byStatus("ERROR")})):this.dispatchEvent("ZSMClientError",{message:t,modules:this.object}),console.error(t),this.object}return this.done&&(this.coreReady=!0,window&&window?.queueMicrotask?queueMicrotask(()=>this.dispatchEvent("ZSMClientReady",{ready:!0})):this.dispatchEvent("ZSMClientReady",{ready:!0})),t.showEvents&&this.summarizeEventStack(e,n),this.object}byStatus(t){if(!t||"string"!=typeof t||!t.length||!["UNREGISTERED","PENDING","READY","ERROR"].includes(t))throw new Error(`[ZSM EventCoordinator] :: byStatus :: Invalid 'eventStatus' value: "${t}". Valid statuses are: UNREGISTERED, PENDING, READY, ERROR.`);return this.entries.flatMap(([e,n])=>n===t?[e]:[])}lengthByStatus(t){return this.byStatus(t).length||0}reset(){return this.keys.forEach(t=>this._eventStack.set(t,"PENDING")),window&&window?.queueMicrotask?queueMicrotask(()=>this.dispatchEvent("ZSMClientEventStackReset",{stack:this.object})):this.dispatchEvent("ZSMClientEventStackReset",{stack:this.object}),this.object}async finished(e,n,...s){if(this.done)return Promise.resolve(!0);let i,r,o,a,E=!1,c=2e4;return isNaN(e)?"function"==typeof e&&(r=e,s.unshift(n)):(c=e,"function"==typeof n&&(r=n)),new Promise((e,n)=>{o=()=>{E=!0,r&&r(...s),e(!0)},a=t=>{E=!0,n(new Error(`[ZSM EventCoordinator] :: finished :: Initialization Error! :: ${t.message||t}\nModules containing errors:\n  - ${this.byStatus("ERROR").join("\n  -")}.`))},this.done&&o(),this.containsErrors&&a({detail:{modules:this.byStatus("ERROR")}});if(i=setTimeout(()=>{E=!0,this.done||n(new Error("[ZSM EventCoordinator] :: Timeout Error: ZSMClient initialization took too long to complete. Please check your network connection or server status."))},c),this.scopeSupportsEventDispatch)t.addEventListener("ZSMClientReady",o,{once:!0}),t.addEventListener("ZSMClientError",a,{once:!0});else{const t=()=>{this.done?o():this.containsErrors?a("[ZSM EventCoordinator] :: finished :: Error: ZSMClient initialization contains errors and is unable to continue."):E||setTimeout(t,200)};t()}}).catch(t=>{throw new Error(`[ZSM EventCoordinator] :: finished :: Initialization Error! :: ${t.message||t}\nModules containing errors:\n  - ${this.byStatus("ERROR").join("\n  -")}.`)}).finally(()=>{clearTimeout(i),this.scopeSupportsEventDispatch&&(t.removeEventListener("ZSMClientReady",o),t.removeEventListener("ZSMClientError",a))})}};export default n;export{n as eventCoordinator};

package/FIDO2Client.js

@@ -1,15 +1 @@
-import eventCoordinator from './EventCoordinator.js';
-import FIDO2ClientBase  from './FIDO2ClientBase.js';
-
-class FIDO2Client extends FIDO2ClientBase {
-    /**
-     * Constructs a FIDO2Client object by extending the FIDO2ClientBase class.
-     * @param {Object} config - The configuration for ZSM initialization (ref: ./zsm_app_config.json)
-     */
-    constructor(config) {
-        super(config);
-        eventCoordinator.update('FIDO2Client', 'READY');
-    }
-}
-
-export {FIDO2Client};
+import t from"./EventCoordinator.js";import o from"./FIDO2ClientBase.js";class r extends o{constructor(o){super(o),t.update("FIDO2Client","READY")}}export{r as FIDO2Client};