@livechat/accounts-sdk 2.1.2 → 2.1.4-beta.0

package/dist/index.cjs.js

@@ -5,11 +5,6 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var qs = require('qs');
 var Cookie = require('js-cookie');
 
-function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
-
-var qs__default = /*#__PURE__*/_interopDefaultLegacy(qs);
-var Cookie__default = /*#__PURE__*/_interopDefaultLegacy(Cookie);
-
 var errors = {
   extend: function (error) {
     if (error.oauth_exception && this.oauth_exception[error.oauth_exception]) {
@@ -37,7 +32,8 @@ var errors = {
       'Client not found, not provided or incorectly configured.',
 
     access_denied:
-      'Probably this application is installed on a different account and you do not have access to it.',
+      'Probably this application is installed on a different account ' +
+      'and you do not have access to it.',
 
     unsupported_response_type:
       'Provided response type is incorrect or unavailable for a given client.',
@@ -47,7 +43,6 @@ var errors = {
   },
 };
 
-/* eslint-disable require-jsdoc */
 class Listener {
   constructor(options = {}) {
     this.options = options;
@@ -113,7 +108,6 @@ class Listener {
  * Class for authentication using popup.
  */
 class Popup {
-  // eslint-disable-next-line require-jsdoc
   constructor(sdk, options) {
     this.options = options;
     this.sdk = sdk;
@@ -121,7 +115,7 @@ class Popup {
 
   /**
    * run popup authorization flow, should be called in a click handler to avoid beeing blocked
-   * @return {Promise} promise that resolves to authorize data or error
+   * @returns {Promise} promise that resolves to authorize data or error
    */
   authorize() {
     return new Promise((resolve, reject) => {
@@ -140,7 +134,7 @@ class Popup {
         resolve(authorizeData);
       });
 
-      var open = function () {
+      const open = function () {
         window.open(
           url,
           'livechat-login-popup',
@@ -149,7 +143,7 @@ class Popup {
       };
 
       if (document.requestStorageAccess) {
-        var promise = document.requestStorageAccess();
+        const promise = document.requestStorageAccess();
         promise.then(open, open);
       } else {
         open();
@@ -158,13 +152,13 @@ class Popup {
   }
 }
 
-/* eslint-disable require-jsdoc */
-
-/** @fileOverview
+/**
+ * @param {Record<string, unknown>} object Source object to pick properties from.
+ * @param {string[]} keys Keys to pick from the source object.
+ * @returns {Record<string, unknown>} A new object containing only the picked keys.
  * @author Auth0 https://github.com/auth0/auth0.js
  * @license MIT
  */
-
 function pick(object, keys) {
   return keys.reduce((prev, key) => {
     if (object[key]) {
@@ -174,9 +168,7 @@ function pick(object, keys) {
   }, {});
 }
 
-// eslint-disable-next-line require-jsdoc
 class Redirect {
-  // eslint-disable-next-line require-jsdoc
   constructor(sdk, options) {
     this.options = options;
     this.sdk = sdk;
@@ -192,7 +184,7 @@ class Redirect {
 
   /**
    * this function checks if the current origin was redirected to with authorize data
-   * @return {Promise} promise that resolves to authorize data or error
+   * @returns {Promise} promise that resolves to authorize data or error
    */
   authorizeData() {
     return new Promise((resolve, reject) => {
@@ -203,7 +195,7 @@ class Redirect {
         case 'token':
           requiredFields = ['access_token', 'expires_in', 'token_type'];
 
-          authorizeData = qs__default["default"].parse(window.location.hash.substring(1));
+          authorizeData = qs.parse(window.location.hash.substring(1));
           authorizeData = pick(authorizeData, [
             'access_token',
             'expires_in',
@@ -214,7 +206,7 @@ class Redirect {
 
           if (
             !requiredFields.every((field) =>
-              authorizeData.hasOwnProperty(field)
+              Object.prototype.hasOwnProperty.call(authorizeData, field)
             )
           ) {
             reject(errors.extend({identity_exception: 'unauthorized'}));
@@ -227,14 +219,14 @@ class Redirect {
         case 'code':
           requiredFields = ['code'];
 
-          authorizeData = qs__default["default"].parse(window.location.search, {
+          authorizeData = qs.parse(window.location.search, {
             ignoreQueryPrefix: true,
           });
           authorizeData = pick(authorizeData, ['state', 'code']);
 
           if (
             !requiredFields.every((field) =>
-              authorizeData.hasOwnProperty(field)
+              Object.prototype.hasOwnProperty.call(authorizeData, field)
             )
           ) {
             reject(errors.extend({identity_exception: 'unauthorized'}));
@@ -253,7 +245,6 @@ class Redirect {
  * Class for authentication using Iframe
  */
 class Iframe {
-  // eslint-disable-next-line require-jsdoc
   constructor(sdk, options) {
     this.options = options;
     this.sdk = sdk;
@@ -261,7 +252,7 @@ class Iframe {
 
   /**
    * run iframe authorization flow, not recommended because of ITP 2.0
-   * @return {Promise} promise that resolves to authorize data or error
+   * @returns {Promise} promise that resolves to authorize data or error
    */
   authorize() {
     return new Promise((resolve, reject) => {
@@ -294,12 +285,10 @@ class Iframe {
     });
   }
 
-  // eslint-disable-next-line require-jsdoc
   iframeID() {
     return this.options.client_id + this.options.response_type;
   }
 
-  // eslint-disable-next-line require-jsdoc
   removeIframe() {
     const ref = document.getElementById(this.iframeID());
     if (ref && ref.parentNode) {
@@ -308,13 +297,17 @@ class Iframe {
   }
 }
 
-/* eslint-disable require-jsdoc */
-
-/** @fileOverview
+/**
+ * @file
  * @author Auth0 https://github.com/auth0/auth0.js
  * @license MIT
  */
 
+/**
+ * A dummy storage mechanism that does not persist data.
+ * It provides methods to get, set, and remove items, but they do not perform any actual storage operations.
+ * This can be used as a fallback when no other storage mechanism is available.
+ */
 function DummyStorage() {}
 
 DummyStorage.prototype.getItem = function () {
@@ -325,15 +318,24 @@ DummyStorage.prototype.removeItem = function () {};
 
 DummyStorage.prototype.setItem = function () {};
 
-/* eslint-disable require-jsdoc */
+/**
+ * @file
+ * @author Auth0 https://github.com/auth0/auth0.js
+ * @license MIT
+ */
+
+
+/**
+ * A storage mechanism that uses cookies to store data. It provides methods to get, set, and remove items from cookies.
+ */
 function CookieStorage() {}
 
 CookieStorage.prototype.getItem = function (key) {
-  return Cookie__default["default"].get(key);
+  return Cookie.get(key);
 };
 
 CookieStorage.prototype.removeItem = function (key) {
-  Cookie__default["default"].remove(key);
+  Cookie.remove(key);
 };
 
 CookieStorage.prototype.setItem = function (key, value, options) {
@@ -348,11 +350,23 @@ CookieStorage.prototype.setItem = function (key, value, options) {
     },
     options
   );
-  Cookie__default["default"].set(key, value, params);
+  Cookie.set(key, value, params);
 };
 
-/* eslint-disable require-jsdoc */
+/**
+ * @file
+ * @author Auth0 https://github.com/auth0/auth0.js
+ * @license MIT
+ */
+
 
+/**
+ * A handler that manages the underlying storage mechanism, providing failover capabilities between localStorage, CookieStorage, and DummyStorage.
+ * It attempts to use localStorage by default, but falls back to CookieStorage if localStorage is unavailable or throws an error.
+ * If both localStorage and CookieStorage fail, it falls back to DummyStorage, which does not persist data.
+ * The handler provides methods to get, set, and remove items from the storage, with automatic failover in case of errors.
+ * @param {object} options Storage configuration options passed to the underlying StorageHandler.
+ */
 function StorageHandler(options) {
   this.storage = new CookieStorage();
   if (options.force_local_storage !== true) {
@@ -414,8 +428,17 @@ StorageHandler.prototype.setItem = function (key, value, options) {
   }
 };
 
-/* eslint-disable require-jsdoc */
+/**
+ * @file
+ * @author Auth0 https://github.com/auth0/auth0.js
+ * @license MIT
+ */
 
+
+/**
+ * A wrapper around the underlying storage mechanism that handles JSON serialization and deserialization.
+ * @param {object} options Storage configuration options passed to the underlying StorageHandler.
+ */
 function Storage(options) {
   this.handler = new StorageHandler(options);
 }
@@ -424,7 +447,7 @@ Storage.prototype.getItem = function (key) {
   const value = this.handler.getItem(key);
   try {
     return JSON.parse(value);
-  } catch (_) {
+  } catch {
     return value;
   }
 };
@@ -438,7 +461,7 @@ Storage.prototype.setItem = function (key, value, options) {
   return this.handler.setItem(key, json, options);
 };
 
-/* eslint-disable require-jsdoc */
+/* internal file */
 
 class Transaction {
   constructor(options) {
@@ -468,15 +491,16 @@ class Transaction {
   }
 }
 
-/** @fileOverview Javascript cryptography implementation.
+/**
  *
+ * @file Javascript cryptography implementation.
  * Crush to remove comments, shorten variable names and
  * generally reduce transmission size.
- *
  * @author Emily Stark
  * @author Mike Hamburg
  * @author Dan Boneh
  */
+
 /*jslint indent: 2, bitwise: false, nomen: false, plusplus: false, white: false, regexp: false */
 /*global document, window, escape, unescape, module, require, Uint32Array */
 
@@ -485,40 +509,15 @@ class Transaction {
  * @namespace
  */
 var sjcl = {
-  /**
-   * Symmetric ciphers.
-   * @namespace
-   */
-  cipher: {},
-
   /**
    * Hash functions.  Right now only SHA256 is implemented.
    * @namespace
    */
   hash: {},
 
-  /**
-   * Key exchange functions.  Right now only SRP is implemented.
-   * @namespace
-   */
-  keyexchange: {},
-
-  /**
-   * Cipher modes of operation.
-   * @namespace
-   */
-  mode: {},
-
-  /**
-   * Miscellaneous.  HMAC and PBKDF2.
-   * @namespace
-   */
-  misc: {},
-
   /**
    * Bit array encoders and decoders.
    * @namespace
-   *
    * @description
    * The members of this namespace are functions which translate between
    * SJCL's bitArrays and other objects (usually strings).  Because it
@@ -532,53 +531,21 @@ var sjcl = {
    * @namespace
    */
   exception: {
-    /**
-     * Ciphertext is corrupt.
-     * @constructor
-     */
-    corrupt: function (message) {
-      this.toString = function () {
-        return 'CORRUPT: ' + this.message;
-      };
-      this.message = message;
-    },
-
     /**
      * Invalid parameter.
-     * @constructor
+     * @param {string} message Error message describing the invalid parameter.
      */
     invalid: function (message) {
       this.toString = function () {
         return 'INVALID: ' + this.message;
       };
       this.message = message;
-    },
-
-    /**
-     * Bug or missing feature in SJCL.
-     * @constructor
-     */
-    bug: function (message) {
-      this.toString = function () {
-        return 'BUG: ' + this.message;
-      };
-      this.message = message;
-    },
-
-    /**
-     * Something isn't ready.
-     * @constructor
-     */
-    notReady: function (message) {
-      this.toString = function () {
-        return 'NOT READY: ' + this.message;
-      };
-      this.message = message;
-    },
-  },
+    }},
 };
-/** @fileOverview Arrays of bits, encoded as arrays of Numbers.
+
+/**
  *
+ * @file Arrays of bits, encoded as arrays of Numbers.
  * @author Emily Stark
  * @author Mike Hamburg
  * @author Dan Boneh
@@ -608,14 +575,17 @@ var sjcl = {
  * to ciphers like AES which want arrays of words.
  * </p>
  */
+/**
+ * @typedef {number[]} bitArray
+ */
 sjcl.bitArray = {
   /**
    * Array slices in units of bits.
    * @param {bitArray} a The array to slice.
-   * @param {Number} bstart The offset to the start of the slice, in bits.
-   * @param {Number} bend The offset to the end of the slice, in bits.  If this is undefined,
+   * @param {number} bstart The offset to the start of the slice, in bits.
+   * @param {number} [bend] The offset to the end of the slice, in bits.  If this is undefined,
    * slice until the end of the array.
-   * @return {bitArray} The requested slice.
+   * @returns {bitArray} The requested slice.
    */
   bitSlice: function (a, bstart, bend) {
     a = sjcl.bitArray
@@ -627,9 +597,9 @@ sjcl.bitArray = {
   /**
    * Extract a number packed into a bit array.
    * @param {bitArray} a The array to slice.
-   * @param {Number} bstart The offset to the start of the slice, in bits.
-   * @param {Number} blength The length of the number to extract.
-   * @return {Number} The requested slice.
+   * @param {number} bstart The offset to the start of the slice, in bits.
+   * @param {number} blength The length of the number to extract.
+   * @returns {number} The requested slice.
    */
   extract: function (a, bstart, blength) {
     // FIXME: this Math.floor is not necessary at all, but for some reason
@@ -651,7 +621,7 @@ sjcl.bitArray = {
    * Concatenate two bit arrays.
    * @param {bitArray} a1 The first array.
    * @param {bitArray} a2 The second array.
-   * @return {bitArray} The concatenation of a1 and a2.
+   * @returns {bitArray} The concatenation of a1 and a2.
    */
   concat: function (a1, a2) {
     if (a1.length === 0 || a2.length === 0) {
@@ -675,7 +645,7 @@ sjcl.bitArray = {
   /**
    * Find the length of an array of bits.
    * @param {bitArray} a The array.
-   * @return {Number} The length of a, in bits.
+   * @returns {number} The length of a, in bits.
    */
   bitLength: function (a) {
     var l = a.length,
@@ -690,8 +660,8 @@ sjcl.bitArray = {
   /**
    * Truncate an array.
    * @param {bitArray} a The array.
-   * @param {Number} len The length to truncate to, in bits.
-   * @return {bitArray} A new array, truncated to len bits.
+   * @param {number} len The length to truncate to, in bits.
+   * @returns {bitArray} A new array, truncated to len bits.
    */
   clamp: function (a, len) {
     if (a.length * 32 < len) {
@@ -712,10 +682,10 @@ sjcl.bitArray = {
 
   /**
    * Make a partial word for a bit array.
-   * @param {Number} len The number of bits in the word.
-   * @param {Number} x The bits.
-   * @param {Number} [_end=0] Pass 1 if x has already been shifted to the high side.
-   * @return {Number} The partial word.
+   * @param {number} len The number of bits in the word.
+   * @param {number} x The bits.
+   * @param {number} [_end] Pass 1 if x has already been shifted to the high side.
+   * @returns {number} The partial word.
    */
   partial: function (len, x, _end) {
     if (len === 32) {
@@ -726,8 +696,8 @@ sjcl.bitArray = {
 
   /**
    * Get the number of bits used by a partial word.
-   * @param {Number} x The partial word.
-   * @return {Number} The number of bits used by the partial word.
+   * @param {number} x The partial word.
+   * @returns {number} The number of bits used by the partial word.
    */
   getPartial: function (x) {
     return Math.round(x / 0x10000000000) || 32;
@@ -737,7 +707,7 @@ sjcl.bitArray = {
    * Compare two arrays for equality in a predictable amount of time.
    * @param {bitArray} a The first array.
    * @param {bitArray} b The second array.
-   * @return {boolean} true if a == b; false otherwise.
+   * @returns {boolean} true if a == b; false otherwise.
    */
   equal: function (a, b) {
     if (sjcl.bitArray.bitLength(a) !== sjcl.bitArray.bitLength(b)) {
@@ -751,11 +721,13 @@ sjcl.bitArray = {
     return x === 0;
   },
 
-  /** Shift an array right.
+  /**
+   * Shift an array right.
    * @param {bitArray} a The array to shift.
-   * @param {Number} shift The number of bits to shift.
-   * @param {Number} [carry=0] A byte to carry in
-   * @param {bitArray} [out=[]] An array to prepend to the output.
+   * @param {number} shift The number of bits to shift.
+   * @param {number} [carry] A word to carry in (defaults to 0).
+   * @param {bitArray} [out] An array to prepend to the output (defaults to []).
+   * @returns {bitArray} The shifted bitArray.
    * @private
    */
   _shiftRight: function (a, shift, carry, out) {
@@ -790,17 +762,22 @@ sjcl.bitArray = {
     return out;
   },
 
-  /** xor a block of 4 words together.
+  /**
+   * XOR a block of 4 words together.
+   * @param {bitArray} x The first 4-word block.
+   * @param {bitArray} y The second 4-word block.
+   * @returns {bitArray} The XOR result as a 4-word block.
    * @private
    */
   _xor4: function (x, y) {
     return [x[0] ^ y[0], x[1] ^ y[1], x[2] ^ y[2], x[3] ^ y[3]];
   },
 
-  /** byteswap a word array inplace.
+  /**
+   * byteswap a word array inplace.
    * (does not handle partial words)
    * @param {sjcl.bitArray} a word array
-   * @return {sjcl.bitArray} byteswapped array
+   * @returns {sjcl.bitArray} byteswapped array
    */
   byteswapM: function (a) {
     var i,
@@ -813,11 +790,12 @@ sjcl.bitArray = {
     return a;
   },
 };
-/** @fileOverview Bit array codec implementations.
+/**
  *
+ * @file Bit array codec implementations.
  * @author Emily Stark
  * @author Mike Hamburg
- * @author Dan Boneh
+ * @author Dan Boneh  
  */
 
 /**
@@ -825,7 +803,11 @@ sjcl.bitArray = {
  * @namespace
  */
 sjcl.codec.utf8String = {
-  /** Convert from a bitArray to a UTF-8 string. */
+  /**
+   * Convert from a bitArray to a UTF-8 string.
+   * @param {bitArray} arr The input bitArray to decode.
+   * @returns {string} The decoded UTF-8 string.
+   */
   fromBits: function (arr) {
     var out = '',
       bl = sjcl.bitArray.bitLength(arr),
@@ -841,7 +823,11 @@ sjcl.codec.utf8String = {
     return decodeURIComponent(escape(out));
   },
 
-  /** Convert from a UTF-8 string to a bitArray. */
+  /**
+   * Convert from a UTF-8 string to a bitArray.
+   * @param {string} str UTF-8 string to encode.
+   * @returns {bitArray} The encoded bitArray.
+   */
   toBits: function (str) {
     str = unescape(encodeURIComponent(str));
     var out = [],
@@ -860,16 +846,15 @@ sjcl.codec.utf8String = {
     return out;
   },
 };
-/** @fileOverview Javascript SHA-256 implementation.
+/**
  *
+ * @file Javascript SHA-256 implementation.
  * An older version of this implementation is available in the public
  * domain, but this one is (c) Emily Stark, Mike Hamburg, Dan Boneh,
  * Stanford University 2008-2010 and BSD-licensed for liability
  * reasons.
- *
  * Special thanks to Aldo Cortesi for pointing out several bugs in
  * this code.
- *
  * @author Emily Stark
  * @author Mike Hamburg
  * @author Dan Boneh
@@ -877,7 +862,7 @@ sjcl.codec.utf8String = {
 
 /**
  * Context for a SHA-256 operation in progress.
- * @constructor
+ * @param {sjcl.hash.sha256} [hash] Optional hash to initialize from.
  */
 sjcl.hash.sha256 = function (hash) {
   if (!this._key[0]) {
@@ -895,8 +880,8 @@ sjcl.hash.sha256 = function (hash) {
 /**
  * Hash a string or an array of words.
  * @static
- * @param {bitArray|String} data the data to hash.
- * @return {bitArray} The hash value, an array of 16 big-endian words.
+ * @param {bitArray | string} data the data to hash.
+ * @returns {bitArray} The hash value, an array of 16 big-endian words.
  */
 sjcl.hash.sha256.hash = function (data) {
   return new sjcl.hash.sha256().update(data).finalize();
@@ -911,7 +896,7 @@ sjcl.hash.sha256.prototype = {
 
   /**
    * Reset the hash state.
-   * @return this
+   * @returns {sjcl.hash.sha256} this
    */
   reset: function () {
     this._h = this._init.slice(0);
@@ -922,8 +907,8 @@ sjcl.hash.sha256.prototype = {
 
   /**
    * Input several words to the hash.
-   * @param {bitArray|String} data the data to hash.
-   * @return this
+   * @param {bitArray | string} data the data to hash.
+   * @returns {sjcl.hash.sha256} this
    */
   update: function (data) {
     if (typeof data === 'string') {
@@ -955,7 +940,7 @@ sjcl.hash.sha256.prototype = {
 
   /**
    * Complete hashing and output the hash value.
-   * @return {bitArray} The hash value, an array of 8 big-endian words.
+   * @returns {bitArray} The hash value, an array of 8 big-endian words.
    */
   finalize: function () {
     var i,
@@ -1018,6 +1003,11 @@ sjcl.hash.sha256.prototype = {
       factor,
       isPrime;
 
+    /**
+     * Get the fractional part of x scaled to a 32-bit word.
+     * @param {number} x Input number.
+     * @returns {number} A signed 32-bit integer representing the scaled fractional part.
+     */
     function frac(x) {
       return ((x - Math.floor(x)) * 0x100000000) | 0;
     }
@@ -1133,7 +1123,11 @@ sjcl.hash.sha256.prototype = {
   },
 };
 
-// eslint-disable-next-line require-jsdoc
+/**
+ * Encode a string as base64url (RFC 4648 §5).
+ * @param {string} str - The string to encode.
+ * @returns {string} The base64url-encoded string.
+ */
 function base64URLEncode(str) {
   return btoa(str).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
 }
@@ -1142,7 +1136,12 @@ var encoding = {
   base64URLEncode: base64URLEncode,
 };
 
-/* eslint-disable require-jsdoc */
+/**
+ * @file
+ * @author Auth0 https://github.com/auth0/auth0.js
+ * @license MIT
+ */
+
 
 class Persister {
   constructor(options, type) {
@@ -1169,7 +1168,12 @@ class Persister {
   }
 }
 
-/* eslint-disable require-jsdoc */
+/**
+ * @file
+ * @author Auth0 https://github.com/auth0/auth0.js
+ * @license MIT
+ */
+
 
 class RedirectUriParamsPersister {
   constructor(options) {
@@ -1178,12 +1182,13 @@ class RedirectUriParamsPersister {
 
   /**
    * Clears query and hash params from redirect_uri and persists them in storage
-   * @param {Object} params
+   * @param {object} params Params used to persist and normalize the redirect URI.
+   * @param {string} params.redirect_uri The redirect URI containing query and hash params to persist.
    */
   persist(params) {
     const redirectUrl = new URL(params.redirect_uri);
-    const queryParams = qs__default["default"].parse(redirectUrl.search.substring(1));
-    const hashParams = qs__default["default"].parse(redirectUrl.hash.substring(1));
+    const queryParams = qs.parse(redirectUrl.search.substring(1));
+    const hashParams = qs.parse(redirectUrl.hash.substring(1));
 
     this.persister.set(params.state, {
       query_params: queryParams,
@@ -1196,7 +1201,7 @@ class RedirectUriParamsPersister {
   /**
    * Retrieves persisted query and hash params from storage and updates current location accordingly.
    * Params returned by global accounts overrides persisted params in case of duplications.
-   * @param {Object} state
+   * @param {object} state Storage key used to retrieve persisted redirect URI params.
    */
   retrieve(state) {
     const redirectUriParams = this.persister.get(state, false);
@@ -1207,41 +1212,46 @@ class RedirectUriParamsPersister {
 
     const queryParams = {
       ...(redirectUriParams.query_params ?? {}),
-      ...qs__default["default"].parse(window.location.search.substring(1)),
+      ...qs.parse(window.location.search.substring(1)),
     };
 
     const hashParams = {
       ...(redirectUriParams.hash_params ?? {}),
-      ...qs__default["default"].parse(window.location.hash.substring(1)),
+      ...qs.parse(window.location.hash.substring(1)),
     };
 
     let uri = window.location.origin + window.location.pathname;
 
     if (queryParams) {
-      uri += '?' + qs__default["default"].stringify(queryParams);
+      uri += '?' + qs.stringify(queryParams);
     }
 
     if (hashParams) {
-      uri += '#' + qs__default["default"].stringify(hashParams);
+      uri += '#' + qs.stringify(hashParams);
     }
 
     window.history.replaceState({}, document.title, uri);
   }
 }
 
-/* eslint-disable require-jsdoc */
-
-/** @fileOverview
+/**
+ * @file
  * @author Auth0 https://github.com/auth0/auth0.js
  * @license MIT
  */
 
+/**
+ * Generates a random string of the specified length using characters from a defined set.
+ * @param {number} length The length of the random string to generate.
+ * @returns {string} The generated random string.
+ */
 function string(length) {
   const charset =
     '0123456789ABCDEFGHIJKLMNOPQRSTUVXYZabcdefghijklmnopqrstuvwxyz-._~';
   const charsetLength = charset.length;
   const cryptoObj = window.crypto || window.msCrypto;
-  const hasCrypto = cryptoObj && typeof cryptoObj.getRandomValues === 'function';
+  const hasCrypto =
+    cryptoObj && typeof cryptoObj.getRandomValues === 'function';
 
   if (!hasCrypto) {
     return generateWithMathRandom(length, charset, charsetLength);
@@ -1272,6 +1282,13 @@ function string(length) {
   return result.join('');
 }
 
+/**
+ * Generates a random string using `Math.random()` as a fallback when the Web Crypto API is unavailable.
+ * @param {number} length The length of the random string to generate.
+ * @param {string} charset The set of characters to choose from.
+ * @param {number} charsetLength The length of the provided character set.
+ * @returns {string} The generated random string.
+ */
 function generateWithMathRandom(length, charset, charsetLength) {
   let output = '';
   for (let i = 0; i < length; i++) {
@@ -1291,31 +1308,31 @@ var random = {
 class AccountsSDK {
   /**
    * Accounts SDK constructor
-   *
-   * @constructor
-   * @param {Object} options
-   * @param {String} options.client_id registered client ID
-   * @param {String} options.organization_id organization ID
-   * @param {String} [options.prompt=''] use `consent` to force consent prompt in popup and redirect flows
-   * @param {String} [options.response_type='token'] OAuth response type, use `token` or `code`
-   * @param {String} [options.popup_flow='auto'] `auto` - close popup when not required, `manual` - always show popup
-   * @param {String} [options.state=''] OAuth state param
-   * @param {Boolean} [options.verify_state=true] check if state matches after redirect
-   * @param {String} [options.scope=null] request exact scopes - must be configured for a given client id
-   * @param {String} [options.redirect_uri=''] OAuth redirect uri - default current location
-   * @param {String} [options.email_hint=''] fill in email in forms
-   * @param {String} [options.server_url='https://accounts.livechat.com'] authorization server url
-   * @param {String} [options.path=''] option to provide a path when loading accounts, for example '/signup'
-   * @param {Object} [options.tracking] tracking querystring params
-   * @param {Object} [options.transaction] options for transaction manager
-   * @param {String} [options.transaction.namespace='com.livechat.accounts'] transaction keys prefix
-   * @param {Number} [options.transaction.key_length=32] transaction random state length
-   * @param {Boolean} [options.transaction.force_local_storage=false] try to use local storage instead of cookies
-   * @param {Object} [options.pkce] PKCE configuration
-   * @param {Boolean} [options.pkce.enabled=true] Oauth 2.1 PKCE extension enabled
-   * @param {String} [options.pkce.code_verifier] override auto generated code verifier
-   * @param {Number} [options.pkce.code_verifier_length=128] code verifier length, between 43 and 128 characters https://tools.ietf.org/html/rfc7636#section-4.1
-   * @param {String} [options.pkce.code_challange_method='S256'] code challange method, use `S256` or `plain`
+   * @class
+   * @param {object} options configuration options for AccountsSDK
+   * @param {string} options.client_id registered client ID
+   * @param {string} options.organization_id organization ID
+   * @param {string} [options.prompt] use `consent` to force consent prompt in popup and redirect flows
+   * @param {string} [options.response_type] OAuth response type, use `token` or `code` (default: `token`)
+   * @param {string} [options.popup_flow] `auto` - close popup when not required, `manual` - always show popup (default: `auto`)
+   * @param {string} [options.state] OAuth state param (default: empty string)
+   * @param {boolean} [options.verify_state] check if state matches after redirect (default: `true`)
+   * @param {string} [options.scope] request exact scopes - must be configured for a given client id (default: `null`)
+   * @param {string} [options.redirect_uri] OAuth redirect uri - default current location (default: empty string)
+   * @param {string} [options.email_hint] fill in email in forms (default: `null`)
+   * @param {string} [options.server_url] authorization server url (default: `https://accounts.livechat.com`)
+   * @param {string} [options.path] option to provide a path when loading accounts, for example '/signup' (default: empty string)
+   * @param {object} [options.tracking] tracking querystring params
+   * @param {object} [options.transaction] options for transaction manager
+   * @param {string} [options.transaction.namespace] transaction keys prefix (default: `com.livechat.accounts`)
+   * @param {number} [options.transaction.key_length] transaction random state length (default: `32`)
+   * @param {boolean} [options.transaction.force_local_storage] try to use local storage instead of cookies (default: `false`)
+   * @param {object} [options.pkce] PKCE configuration
+   * @param {boolean} [options.pkce.enabled] Oauth 2.1 PKCE extension enabled (default: `true`)
+   * @param {string} [options.pkce.code_verifier] override auto generated code verifier
+   * @param {number} [options.pkce.code_verifier_length] code verifier length, between 43 and 128 characters
+   *   https://tools.ietf.org/html/rfc7636#section-4.1 (default: `128`)
+   * @param {string} [options.pkce.code_challange_method] code challange method, use `S256` or `plain` (default: `S256`)
    */
   constructor(options = {}) {
     if (options.client_id == null) {
@@ -1359,8 +1376,8 @@ class AccountsSDK {
 
   /**
    * use iframe for authorization
-   * @param {Object} options for overriding defaults
-   * @return {Iframe} instance of an iframe flow
+   * @param {object} options for overriding defaults
+   * @returns {Iframe} instance of an iframe flow
    */
   iframe(options = {}) {
     const localOptions = Object.assign({}, this.options, options);
@@ -1369,8 +1386,8 @@ class AccountsSDK {
 
   /**
    * use popup for authorization
-   * @param {Object} options for overriding defaults
-   * @return {Popup} instance of a popup flow
+   * @param {object} options for overriding defaults
+   * @returns {Popup} instance of a popup flow
    */
   popup(options = {}) {
     const localOptions = Object.assign({}, this.options, options);
@@ -1379,8 +1396,8 @@ class AccountsSDK {
 
   /**
    * use redirect for authorization
-   * @param {Object} options for overriding defaults
-   * @return {Redirect} instance of a redirect flow
+   * @param {object} options for overriding defaults
+   * @returns {Redirect} instance of a redirect flow
    */
   redirect(options = {}) {
     const localOptions = Object.assign({}, this.options, options);
@@ -1389,9 +1406,9 @@ class AccountsSDK {
 
   /**
    * create authorization url
-   * @param {Object} options for overriding defaults
-   * @param {String} flow set 'button' for popup and iframe
-   * @return {string} generated url
+   * @param {object} options for overriding defaults
+   * @param {string} flow set 'button' for popup and iframe
+   * @returns {string} generated url
    */
   authorizeURL(options = {}, flow = '') {
     const localOptions = Object.assign({}, this.options, options);
@@ -1443,7 +1460,7 @@ class AccountsSDK {
         random.string(localOptions.pkce.code_verifier_length);
 
       switch (localOptions.pkce.code_challange_method) {
-        case 'S256':
+        case 'S256': {
           const codeChallenge = sjcl.hash.sha256.hash(codeVerifier);
           Object.assign(params, {
             code_verifier: codeVerifier,
@@ -1451,6 +1468,7 @@ class AccountsSDK {
             code_challenge_method: localOptions.pkce.code_challange_method,
           });
           break;
+        }
 
         default:
           Object.assign(params, {
@@ -1466,13 +1484,13 @@ class AccountsSDK {
 
     delete params.code_verifier;
 
-    return url + '?' + qs__default["default"].stringify(params);
+    return url + '?' + qs.stringify(params);
   }
 
   /**
    * This function verifies if redirect transaction params are valid.
-   * @param {Object} authorizeData authorize data to validate and return transaction state - redirect state, pkce code verifier
-   * @return {Object} transaction state if valid, null otherwise
+   * @param {object} authorizeData authorize data to validate and return transaction state - redirect state, pkce code verifier
+   * @returns {object | null} transaction state if valid, null otherwise
    */
   verify(authorizeData) {
     const transactionData = this.transaction.get(authorizeData.state);
@@ -1487,5 +1505,5 @@ class AccountsSDK {
   }
 }
 
-exports["default"] = AccountsSDK;
+exports.default = AccountsSDK;
 //# sourceMappingURL=index.cjs.js.map