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

package/dist/index.esm.js

@@ -28,7 +28,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.',
@@ -38,7 +39,6 @@ var errors = {
   },
 };
 
-/* eslint-disable require-jsdoc */
 class Listener {
   constructor(options = {}) {
     this.options = options;
@@ -104,7 +104,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;
@@ -112,7 +111,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) => {
@@ -131,7 +130,7 @@ class Popup {
         resolve(authorizeData);
       });
 
-      var open = function () {
+      const open = function () {
         window.open(
           url,
           'livechat-login-popup',
@@ -140,7 +139,7 @@ class Popup {
       };
 
       if (document.requestStorageAccess) {
-        var promise = document.requestStorageAccess();
+        const promise = document.requestStorageAccess();
         promise.then(open, open);
       } else {
         open();
@@ -149,13 +148,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]) {
@@ -165,9 +164,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;
@@ -183,7 +180,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) => {
@@ -205,7 +202,7 @@ class Redirect {
 
           if (
             !requiredFields.every((field) =>
-              authorizeData.hasOwnProperty(field)
+              Object.prototype.hasOwnProperty.call(authorizeData, field)
             )
           ) {
             reject(errors.extend({identity_exception: 'unauthorized'}));
@@ -225,7 +222,7 @@ class Redirect {
 
           if (
             !requiredFields.every((field) =>
-              authorizeData.hasOwnProperty(field)
+              Object.prototype.hasOwnProperty.call(authorizeData, field)
             )
           ) {
             reject(errors.extend({identity_exception: 'unauthorized'}));
@@ -244,7 +241,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;
@@ -252,7 +248,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) => {
@@ -285,12 +281,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) {
@@ -299,13 +293,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 () {
@@ -316,7 +314,16 @@ 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) {
@@ -342,8 +349,20 @@ CookieStorage.prototype.setItem = function (key, value, options) {
   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) {
@@ -405,8 +424,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);
 }
@@ -415,7 +443,7 @@ Storage.prototype.getItem = function (key) {
   const value = this.handler.getItem(key);
   try {
     return JSON.parse(value);
-  } catch (_) {
+  } catch {
     return value;
   }
 };
@@ -429,7 +457,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) {
@@ -459,15 +487,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 */
 
@@ -476,40 +505,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
@@ -523,53 +527,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
@@ -599,14 +571,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
@@ -618,9 +593,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
@@ -642,7 +617,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) {
@@ -666,7 +641,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,
@@ -681,8 +656,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) {
@@ -703,10 +678,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) {
@@ -717,8 +692,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;
@@ -728,7 +703,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)) {
@@ -742,11 +717,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) {
@@ -781,17 +758,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,
@@ -804,11 +786,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  
  */
 
 /**
@@ -816,7 +799,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),
@@ -832,7 +819,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 = [],
@@ -851,16 +842,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
@@ -868,7 +858,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]) {
@@ -886,8 +876,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();
@@ -902,7 +892,7 @@ sjcl.hash.sha256.prototype = {
 
   /**
    * Reset the hash state.
-   * @return this
+   * @returns {sjcl.hash.sha256} this
    */
   reset: function () {
     this._h = this._init.slice(0);
@@ -913,8 +903,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') {
@@ -946,7 +936,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,
@@ -1009,6 +999,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;
     }
@@ -1124,7 +1119,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(/=+$/, '');
 }
@@ -1133,7 +1132,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) {
@@ -1160,7 +1164,12 @@ class Persister {
   }
 }
 
-/* eslint-disable require-jsdoc */
+/**
+ * @file
+ * @author Auth0 https://github.com/auth0/auth0.js
+ * @license MIT
+ */
+
 
 class RedirectUriParamsPersister {
   constructor(options) {
@@ -1169,7 +1178,8 @@ 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);
@@ -1187,7 +1197,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);
@@ -1220,19 +1230,24 @@ class RedirectUriParamsPersister {
   }
 }
 
-/* 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);
@@ -1263,6 +1278,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++) {
@@ -1282,31 +1304,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) {
@@ -1350,8 +1372,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);
@@ -1360,8 +1382,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);
@@ -1370,8 +1392,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);
@@ -1380,9 +1402,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);
@@ -1434,7 +1456,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,
@@ -1442,6 +1464,7 @@ class AccountsSDK {
             code_challenge_method: localOptions.pkce.code_challange_method,
           });
           break;
+        }
 
         default:
           Object.assign(params, {
@@ -1462,8 +1485,8 @@ class AccountsSDK {
 
   /**
    * 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);