@rabbitio/ui-kit 1.0.0-beta.37 → 1.0.0-beta.39

package/dist/index.module.js

@@ -1,6 +1,8 @@
 import React, { useState, useRef, useEffect, useCallback } from 'react';
 import { BigNumber } from 'bignumber.js';
 import axios from 'axios';
+import { v4 } from 'uuid';
+import Hashes from 'jshashes';
 import EventBusInstance from 'eventbusjs';
 
 function createCommonjsModule(fn) {
@@ -1621,7 +1623,7 @@ var Logger = /*#__PURE__*/function () {
   return Logger;
 }();
 
-function _catch$4(body, recover) {
+function _catch$8(body, recover) {
   try {
     var result = body();
   } catch (e) {
@@ -1637,7 +1639,7 @@ function useCallHandlingErrors() {
     setState = _useState[1];
   return useCallback(function (functionToBeCalled, event) {
     try {
-      var _temp = _catch$4(function () {
+      var _temp = _catch$8(function () {
         return Promise.resolve(functionToBeCalled(event)).then(function () {});
       }, function (error) {
         Logger.logError(error, (functionToBeCalled == null ? void 0 : functionToBeCalled.name) || "errorBoundaryTrigger", "Caught by ErrorBoundary");
@@ -1675,6 +1677,96 @@ function useReferredState(initialValue) {
   return [reference, setReferredState];
 }
 
+var handleClickOutside = function handleClickOutside(exceptionsRefs, callback) {
+  function handleClick(event) {
+    var isExceptionClicked = exceptionsRefs.find(function (ref) {
+      return (ref == null ? void 0 : ref.current) && ref.current.contains(event.target);
+    });
+    if (!isExceptionClicked) {
+      callback();
+    }
+  }
+  document.addEventListener("click", handleClick);
+  return function () {
+    return document.removeEventListener("click", handleClick);
+  };
+};
+
+var PARAMETER_VALUES_SEPARATOR = "|*|"; // Sting that with high probability will not be in the user's data
+
+/**
+ * Adds specified parameter with values to the URL query string
+ *
+ * @param parameterName - String - name of the parameter
+ * @param values - Array of String values
+ * @param updateURLCallback - callback that will be called with the updated query string. Can be used to save it to URL
+ */
+function saveQueryParameterAndValues(parameterName, values, updateURLCallback) {
+  if (updateURLCallback === void 0) {
+    updateURLCallback = function updateURLCallback(newQueryString) {};
+  }
+  var parametersAndValues = parseSearchString();
+  parametersAndValues = parametersAndValues.filter(function (parameterAndValues) {
+    return parameterAndValues[0] !== parameterName;
+  });
+  var parameterValuesForURL = encodeURIComponent(values.join(PARAMETER_VALUES_SEPARATOR));
+  parametersAndValues.push([parameterName, parameterValuesForURL]);
+  var newQueryString = "?" + parametersAndValues.map(function (parameterAndValues) {
+    return parameterAndValues.join("=");
+  }).join("&");
+  updateURLCallback(newQueryString);
+  return newQueryString;
+}
+
+/**
+ * Removes specified parameter with values from the URL query string
+ *
+ * @param parameterName - String - name of the parameter
+ * @param updateURLCallback - callback that will be called with the updated query string. Can be used to save it to URL
+ */
+// TODO: [tests, moderate] units required the same as or other functions in this module
+function removeQueryParameterAndValues(parameterName, updateURLCallback) {
+  if (updateURLCallback === void 0) {
+    updateURLCallback = function updateURLCallback(newQueryString) {};
+  }
+  var parametersAndValues = parseSearchString();
+  parametersAndValues = parametersAndValues.filter(function (parameterAndValues) {
+    return parameterAndValues[0] !== parameterName;
+  });
+  var newQueryString = "?" + parametersAndValues.map(function (parameterAndValues) {
+    return parameterAndValues.join("=");
+  }).join("&");
+  updateURLCallback(newQueryString);
+  return newQueryString;
+}
+
+/**
+ * Retrieves parameter values from the URL query string.
+ *
+ * If there are several parameters with the same name in the URL then all their values are returned
+ *
+ * @param name {string} - parameter name
+ * @return {string[]} [] - if the parameter is not present in URL. [""] - if parameter present but has empty value
+ */
+function getQueryParameterValues(name) {
+  return parseSearchString().filter(function (parameterAndValue) {
+    return parameterAndValue[0] === name;
+  }).reduce(function (allValues, parameterAndValue) {
+    var values = decodeURIComponent(parameterAndValue[1] || "").split(PARAMETER_VALUES_SEPARATOR);
+    return [].concat(allValues, values);
+  }, []);
+}
+function parseSearchString() {
+  var _window$location$sear;
+  var trimmed = (((_window$location$sear = window.location.search) == null ? void 0 : _window$location$sear.slice(1)) || "").trim();
+  return trimmed && trimmed.split("&").map(function (parameterAndValue) {
+    return parameterAndValue.split("=");
+  }) || [];
+}
+function getQueryParameterSingleValue(name) {
+  return (getQueryParameterValues(name) || [])[0];
+}
+
 /**
  * This function improves the passed error object (its message) by adding the passed function name
  * and additional message to it.
@@ -1703,6 +1795,17 @@ function improvedErrorMessage(e, settingFunction, additionalMessage) {
   additionalMessage && (message += additionalMessage + " ");
   return message;
 }
+function logErrorOrOutputToConsole(e) {
+  try {
+    // TODO: [dev] remove this after few weeks of testing output in real life
+    // eslint-disable-next-line no-console
+    console.log("BEFORE SAFE", e);
+    Logger.log("logErrorOrOutputToConsole", safeStringify(e));
+  } catch (e) {
+    // eslint-disable-next-line no-console
+    console.log("logErrorOrOutputToConsole", e);
+  }
+}
 
 var FiatCurrenciesService = /*#__PURE__*/function () {
   function FiatCurrenciesService() {}
@@ -2574,7 +2677,109 @@ var Cache = /*#__PURE__*/function () {
   return Cache;
 }();
 
-function _catch$3(body, recover) {
+function _catch$7(body, recover) {
+  try {
+    var result = body();
+  } catch (e) {
+    return recover(e);
+  }
+  if (result && result.then) {
+    return result.then(void 0, recover);
+  }
+  return result;
+}
+function postponeExecution(execution, timeoutMS) {
+  if (timeoutMS === void 0) {
+    timeoutMS = 1000;
+  }
+  return new Promise(function (resolve, reject) {
+    setTimeout(function () {
+      try {
+        var _temp = _catch$7(function () {
+          return Promise.resolve(execution()).then(function (_execution) {
+            resolve(_execution);
+          });
+        }, function (e) {
+          reject(e);
+        });
+        return Promise.resolve(_temp && _temp.then ? _temp.then(function () {}) : void 0);
+      } catch (e) {
+        return Promise.reject(e);
+      }
+    }, timeoutMS);
+  });
+}
+
+var AxiosAdapter = /*#__PURE__*/function () {
+  function AxiosAdapter() {}
+  AxiosAdapter.call = function call(method) {
+    try {
+      var _arguments = arguments;
+      return Promise.resolve(axios[method].apply(axios, [].slice.call(_arguments, 1)));
+    } catch (e) {
+      return Promise.reject(e);
+    }
+  };
+  AxiosAdapter.get = function get() {
+    try {
+      var _arguments2 = arguments;
+      return Promise.resolve(axios.get.apply(axios, [].slice.call(_arguments2)));
+    } catch (e) {
+      return Promise.reject(e);
+    }
+  };
+  AxiosAdapter.post = function post() {
+    try {
+      var _arguments3 = arguments;
+      return Promise.resolve(axios.post.apply(axios, [].slice.call(_arguments3)));
+    } catch (e) {
+      return Promise.reject(e);
+    }
+  };
+  AxiosAdapter.put = function put() {
+    try {
+      var _arguments4 = arguments;
+      return Promise.resolve(axios.put.apply(axios, [].slice.call(_arguments4)));
+    } catch (e) {
+      return Promise.reject(e);
+    }
+  };
+  AxiosAdapter["delete"] = function _delete() {
+    try {
+      var _arguments5 = arguments;
+      return Promise.resolve(axios["delete"].apply(axios, [].slice.call(_arguments5)));
+    } catch (e) {
+      return Promise.reject(e);
+    }
+  };
+  AxiosAdapter.patch = function patch() {
+    try {
+      var _arguments6 = arguments;
+      return Promise.resolve(axios.patch.apply(axios, [].slice.call(_arguments6)));
+    } catch (e) {
+      return Promise.reject(e);
+    }
+  };
+  AxiosAdapter.options = function options() {
+    try {
+      var _arguments7 = arguments;
+      return Promise.resolve(axios.options.apply(axios, [].slice.call(_arguments7)));
+    } catch (e) {
+      return Promise.reject(e);
+    }
+  };
+  AxiosAdapter.head = function head() {
+    try {
+      var _arguments8 = arguments;
+      return Promise.resolve(axios.head.apply(axios, [].slice.call(_arguments8)));
+    } catch (e) {
+      return Promise.reject(e);
+    }
+  };
+  return AxiosAdapter;
+}();
+
+function _catch$6(body, recover) {
   try {
     var result = body();
   } catch (e) {
@@ -2590,7 +2795,7 @@ var EmailsApi = /*#__PURE__*/function () {
   EmailsApi.sendEmail = function sendEmail(subject, body) {
     try {
       var _this = this;
-      var _temp = _catch$3(function () {
+      var _temp = _catch$6(function () {
         var url = window.location.protocol + "//" + window.location.host + "/api/v1/" + _this.serverEndpointEntity;
         return Promise.resolve(axios.post(url, {
           subject: subject,
@@ -2608,6 +2813,1825 @@ var EmailsApi = /*#__PURE__*/function () {
 }();
 EmailsApi.serverEndpointEntity = "emails";
 
+/**
+ * This util helps to avoid duplicated calls to a shared resource.
+ * It tracks is there currently active calculation for the specific cache id and make all other requests
+ * with the same cache id waiting for this active calculation to be finished. When the calculation ends
+ * the resolver allows all the waiting requesters to get the data from cache and start their own calculations.
+ *
+ * This class should be instantiated inside some other service where you need to request some resource concurrently.
+ * Rules:
+ * 1. When you need to make a request inside your main service call 'getCachedOrWaitForCachedOrAcquireLock'
+ *    on the instance of this class and await for the result. If the flag allowing to start calculation is true
+ *    then you can request data inside your main service. Otherwise you should use the cached data as an another
+ *    requester just finished the most resent requesting and there is actual data in the cache that
+ *    is returned to you here.
+ * 1.1 Also you can acquire a lock directly if you don't want to get cached data. Use the corresponding method 'acquireLock'.
+ *
+ * 2. If you start requesting (when you successfully acquired the lock) then after receiving the result of your
+ *    requesting you should call the 'saveCachedData' so the retrieved data will appear in the cache.
+ *
+ * 3. If you successfully acquired the lock then you should after calling the 'saveCachedData' call
+ *    the 'releaseLock' - this is mandatory to release the lock and allow other requesters to perform their requests.
+ *    WARNING: If for any reason you forget to call this method then this class instance will wait perpetually for
+ *    the lock releasing and all your attempts to request the data will constantly fail. So usually call it
+ *    inside the 'finally' block.
+ *
+ * TODO: [tests, critical++] add unit tests - massively used logic and can produce sophisticated concurrency bugs
+ */
+
+function _settle$2(pact, state, value) {
+  if (!pact.s) {
+    if (value instanceof _Pact$2) {
+      if (value.s) {
+        if (state & 1) {
+          state = value.s;
+        }
+        value = value.v;
+      } else {
+        value.o = _settle$2.bind(null, pact, state);
+        return;
+      }
+    }
+    if (value && value.then) {
+      value.then(_settle$2.bind(null, pact, state), _settle$2.bind(null, pact, 2));
+      return;
+    }
+    pact.s = state;
+    pact.v = value;
+    const observer = pact.o;
+    if (observer) {
+      observer(pact);
+    }
+  }
+}
+
+/**
+ * Util class to control access to a resource when it can be called in parallel for the same result.
+ * (E.g. getting today coins-fiat rates from some API).
+ */
+var _Pact$2 = /*#__PURE__*/function () {
+  function _Pact() {}
+  _Pact.prototype.then = function (onFulfilled, onRejected) {
+    var result = new _Pact();
+    var state = this.s;
+    if (state) {
+      var callback = state & 1 ? onFulfilled : onRejected;
+      if (callback) {
+        try {
+          _settle$2(result, 1, callback(this.v));
+        } catch (e) {
+          _settle$2(result, 2, e);
+        }
+        return result;
+      } else {
+        return this;
+      }
+    }
+    this.o = function (_this) {
+      try {
+        var value = _this.v;
+        if (_this.s & 1) {
+          _settle$2(result, 1, onFulfilled ? onFulfilled(value) : value);
+        } else if (onRejected) {
+          _settle$2(result, 1, onRejected(value));
+        } else {
+          _settle$2(result, 2, value);
+        }
+      } catch (e) {
+        _settle$2(result, 2, e);
+      }
+    };
+    return result;
+  };
+  return _Pact;
+}();
+function _isSettledPact$2(thenable) {
+  return thenable instanceof _Pact$2 && thenable.s & 1;
+}
+function _for$1(test, update, body) {
+  var stage;
+  for (;;) {
+    var shouldContinue = test();
+    if (_isSettledPact$2(shouldContinue)) {
+      shouldContinue = shouldContinue.v;
+    }
+    if (!shouldContinue) {
+      return result;
+    }
+    if (shouldContinue.then) {
+      stage = 0;
+      break;
+    }
+    var result = body();
+    if (result && result.then) {
+      if (_isSettledPact$2(result)) {
+        result = result.s;
+      } else {
+        stage = 1;
+        break;
+      }
+    }
+    if (update) {
+      var updateValue = update();
+      if (updateValue && updateValue.then && !_isSettledPact$2(updateValue)) {
+        stage = 2;
+        break;
+      }
+    }
+  }
+  var pact = new _Pact$2();
+  var reject = _settle$2.bind(null, pact, 2);
+  (stage === 0 ? shouldContinue.then(_resumeAfterTest) : stage === 1 ? result.then(_resumeAfterBody) : updateValue.then(_resumeAfterUpdate)).then(void 0, reject);
+  return pact;
+  function _resumeAfterBody(value) {
+    result = value;
+    do {
+      if (update) {
+        updateValue = update();
+        if (updateValue && updateValue.then && !_isSettledPact$2(updateValue)) {
+          updateValue.then(_resumeAfterUpdate).then(void 0, reject);
+          return;
+        }
+      }
+      shouldContinue = test();
+      if (!shouldContinue || _isSettledPact$2(shouldContinue) && !shouldContinue.v) {
+        _settle$2(pact, 1, result);
+        return;
+      }
+      if (shouldContinue.then) {
+        shouldContinue.then(_resumeAfterTest).then(void 0, reject);
+        return;
+      }
+      result = body();
+      if (_isSettledPact$2(result)) {
+        result = result.v;
+      }
+    } while (!result || !result.then);
+    result.then(_resumeAfterBody).then(void 0, reject);
+  }
+  function _resumeAfterTest(shouldContinue) {
+    if (shouldContinue) {
+      result = body();
+      if (result && result.then) {
+        result.then(_resumeAfterBody).then(void 0, reject);
+      } else {
+        _resumeAfterBody(result);
+      }
+    } else {
+      _settle$2(pact, 1, result);
+    }
+  }
+  function _resumeAfterUpdate() {
+    if (shouldContinue = test()) {
+      if (shouldContinue.then) {
+        shouldContinue.then(_resumeAfterTest).then(void 0, reject);
+      } else {
+        _resumeAfterTest(shouldContinue);
+      }
+    } else {
+      _settle$2(pact, 1, result);
+    }
+  }
+}
+function _catch$5(body, recover) {
+  try {
+    var result = body();
+  } catch (e) {
+    return recover(e);
+  }
+  if (result && result.then) {
+    return result.then(void 0, recover);
+  }
+  return result;
+}
+var CacheAndConcurrentRequestsResolver = /*#__PURE__*/function () {
+  /**
+   * @param bio {string} unique identifier for the exact service
+   * @param cache {Cache} cache
+   * @param cacheTtl {number|null} time to live for cache ms. 0 or null means the cache cannot expire
+   * @param [maxCallAttemptsToWaitForAlreadyRunningRequest=100] {number} number of request allowed to do waiting for
+   *        result before we fail the original request. Use custom value only if you need to make the attempts count
+   *        and polling interval changes.
+   * @param [timeoutBetweenAttemptsToCheckWhetherAlreadyRunningRequestFinished=1000] {number}
+   *        timeout ms for polling for a result. if you change maxCallAttemptsToWaitForAlreadyRunningRequest
+   *        then this parameter maybe also require the custom value.
+   * @param [removeExpiredCacheAutomatically=true] {boolean}
+   */
+  function CacheAndConcurrentRequestsResolver(bio, cache, cacheTtl, removeExpiredCacheAutomatically, maxCallAttemptsToWaitForAlreadyRunningRequest, timeoutBetweenAttemptsToCheckWhetherAlreadyRunningRequestFinished) {
+    if (removeExpiredCacheAutomatically === void 0) {
+      removeExpiredCacheAutomatically = true;
+    }
+    if (maxCallAttemptsToWaitForAlreadyRunningRequest === void 0) {
+      maxCallAttemptsToWaitForAlreadyRunningRequest = 100;
+    }
+    if (timeoutBetweenAttemptsToCheckWhetherAlreadyRunningRequestFinished === void 0) {
+      timeoutBetweenAttemptsToCheckWhetherAlreadyRunningRequestFinished = 1000;
+    }
+    if (cacheTtl != null && cacheTtl < timeoutBetweenAttemptsToCheckWhetherAlreadyRunningRequestFinished * 2) {
+      /*
+       * During the lifetime of this service e.g. if the data is being retrieved slowly we can get
+       * RACE CONDITION when we constantly retrieve data and during retrieval it is expired, so we are trying
+       * to retrieve it again and again.
+       * We have a protection mechanism that we will wait no more than
+       * maxCallAttemptsToWaitForAlreadyRunningRequest * timeoutBetweenAttemptsToCheckWhetherAlreadyRunningRequestFinished
+       * but this additional check is aimed to reduce potential loading time for some requests.
+       */
+      throw new Error("DEV: Wrong parameters passed to construct " + bio + " - TTL " + cacheTtl + " should be 2 times greater than " + timeoutBetweenAttemptsToCheckWhetherAlreadyRunningRequestFinished);
+    }
+    this._bio = bio;
+    this._cache = cache;
+    this._cacheTtlMs = cacheTtl != null ? cacheTtl : null;
+    this._maxExecutionTimeMs = maxCallAttemptsToWaitForAlreadyRunningRequest * timeoutBetweenAttemptsToCheckWhetherAlreadyRunningRequestFinished;
+    this._removeExpiredCacheAutomatically = removeExpiredCacheAutomatically;
+    this._requestsManager = new ManagerOfRequestsToTheSameResource(bio, maxCallAttemptsToWaitForAlreadyRunningRequest, timeoutBetweenAttemptsToCheckWhetherAlreadyRunningRequestFinished);
+  }
+
+  /**
+   * When using this service this is the major method you should call to get data by cache id.
+   * This method checks is there cached data and ether
+   * - returns you flag that you can start requesting data from the shared resource
+   * - or if there is already started calculation waits until it is finished (removed from this service)
+   *   and returns you the retrieved data
+   * - or just returns you the cached data
+   *
+   * 'canStartDataRetrieval' equal true means that the lock was acquired, and you should manually call 'saveCachedData'
+   * if needed and then 'releaseLock' to mark this calculation as finished so other
+   * requesters can take their share of the resource.
+   *
+   * @param cacheId {string}
+   * @return {Promise<({
+   *             canStartDataRetrieval: true,
+   *             cachedData: any,
+   *             lockId: string
+   *         }|{
+   *             canStartDataRetrieval: false,
+   *             cachedData: any
+   *         })>}
+   */
+  var _proto = CacheAndConcurrentRequestsResolver.prototype;
+  _proto.getCachedOrWaitForCachedOrAcquireLock = function getCachedOrWaitForCachedOrAcquireLock(cacheId) {
+    try {
+      var _this = this;
+      return Promise.resolve(_catch$5(function () {
+        function _temp2() {
+          var _cached, _cached2;
+          return calculationId ? {
+            canStartDataRetrieval: true,
+            cachedData: (_cached = cached) != null ? _cached : cachedDataBackupIsPresentButExpired,
+            lockId: calculationId
+          } : {
+            canStartDataRetrieval: false,
+            cachedData: (_cached2 = cached) != null ? _cached2 : cachedDataBackupIsPresentButExpired
+          };
+        }
+        var startedAtTimestamp = Date.now();
+        var cached = _this._cache.get(cacheId);
+        var cachedDataBackupIsPresentButExpired = null;
+        if (cached != null && !_this._removeExpiredCacheAutomatically) {
+          var lastUpdateTimestamp = _this._cache.getLastUpdateTimestamp(cacheId);
+          if ((lastUpdateTimestamp != null ? lastUpdateTimestamp : 0) + _this._cacheTtlMs < Date.now()) {
+            /*
+             * Here we are manually clearing 'cached' value retrieved from cache to force the data loading.
+             * But we save its value first to the backup variable to be able to return this value if ongoing
+             * requesting fails.
+             */
+            cachedDataBackupIsPresentButExpired = cached;
+            cached = null;
+          }
+        }
+        var calculationId = null;
+        var isRetrievedCacheExpired = true;
+        var isWaitingForActiveCalculationSucceeded;
+        var weStillHaveSomeTimeToProceedExecution = true;
+        var _temp = _for$1(function () {
+          return calculationId == null && cached == null && !!isRetrievedCacheExpired && !!weStillHaveSomeTimeToProceedExecution;
+        }, void 0, function () {
+          return Promise.resolve(_this._requestsManager.startCalculationOrWaitForActiveToFinish(cacheId)).then(function (result) {
+            calculationId = typeof result === "string" ? result : null;
+            isWaitingForActiveCalculationSucceeded = typeof result === "boolean" ? result : null;
+            cached = _this._cache.get(cacheId);
+            isRetrievedCacheExpired = isWaitingForActiveCalculationSucceeded && cached == null;
+            weStillHaveSomeTimeToProceedExecution = Date.now() - startedAtTimestamp < _this._maxExecutionTimeMs;
+          });
+        });
+        return _temp && _temp.then ? _temp.then(_temp2) : _temp2(_temp);
+      }, function (e) {
+        improveAndRethrow(e, _this._bio + ".getCachedOrWaitForCachedOrAcquireLock");
+      }));
+    } catch (e) {
+      return Promise.reject(e);
+    }
+  }
+  /**
+   * Returns just the current cache value for the given id.
+   * Doesn't wait for the active calculation, doesn't acquire lock, just retrieves the current cache as it is.
+   *
+   * @param cacheId {string}
+   * @return {any}
+   */
+  ;
+  _proto.getCached = function getCached(cacheId) {
+    try {
+      return this._cache.get(cacheId);
+    } catch (e) {
+      improveAndRethrow(e, "getCached");
+    }
+  };
+  _proto._getTtl = function _getTtl() {
+    return this._removeExpiredCacheAutomatically ? this._cacheTtlMs : null;
+  }
+
+  /**
+   * Directly acquires the lock despite on cached data availability.
+   * So if this method returns result === true you can start the data retrieval.
+   *
+   * @param cacheId {string}
+   * @return {Promise<{ result: true, lockId: string }|{ result: false }>}
+   */;
+  _proto.acquireLock = function acquireLock(cacheId) {
+    try {
+      var _this2 = this;
+      return Promise.resolve(_catch$5(function () {
+        return Promise.resolve(_this2._requestsManager.acquireLock(cacheId));
+      }, function (e) {
+        improveAndRethrow(e, "acquireLock");
+      }));
+    } catch (e) {
+      return Promise.reject(e);
+    }
+  }
+  /**
+   * This method should be called only if you acquired a lock successfully.
+   *
+   * If the current lock id is not equal to the passed one the passed data will be ignored.
+   * Or you can do the synchronous data merging on your side and pass the
+   * wasDataMergedSynchronouslyWithMostRecentCacheState=true so your data will be stored
+   * despite on the lockId.
+   * WARNING: you should do this only if you are sure you perform the synchronous update.
+   *
+   * @param cacheId {string}
+   * @param lockId {string}
+   * @param data {any}
+   * @param [sessionDependentData=true] {boolean}
+   * @param [wasDataMergedSynchronouslyWithMostRecentCacheState=false]
+   */
+  ;
+  _proto.saveCachedData = function saveCachedData(cacheId, lockId, data, sessionDependentData, wasDataMergedSynchronouslyWithMostRecentCacheState) {
+    if (sessionDependentData === void 0) {
+      sessionDependentData = true;
+    }
+    if (wasDataMergedSynchronouslyWithMostRecentCacheState === void 0) {
+      wasDataMergedSynchronouslyWithMostRecentCacheState = false;
+    }
+    try {
+      if (wasDataMergedSynchronouslyWithMostRecentCacheState || this._requestsManager.isTheLockActiveOne(cacheId, lockId)) {
+        /* We save passed data only if the <caller> has the currently acquired lockId.
+         * If the passed lockId is not the active one it means that other code cleared/stopped the lock
+         * acquired by the <caller> recently due to some urgent/more prior changes.
+         *
+         * But we allow user to pass the 'wasDataMergedSynchronouslyWithMostRecentCacheState' flag
+         * that tells us that the user had taken the most recent cache value and merged his new data
+         * with that cached value (AFTER possibly performing async data retrieval). This means that we
+         * can ignore the fact that his lockId is no more relevant and save the passed data
+         * as it is synchronously merged with the most recent cached data. (Synchronously merged means that
+         * the lost update cannot occur during the merge time as JS execute the synchronous functions\
+         * till the end).
+         */
+        if (sessionDependentData) {
+          this._cache.putSessionDependentData(cacheId, data, this._getTtl());
+        } else {
+          this._cache.put(cacheId, data, this._getTtl());
+        }
+      }
+    } catch (e) {
+      improveAndRethrow(e, this._bio + ".saveCachedData");
+    }
+  }
+
+  /**
+   * Should be called then and only then if you successfully acquired a lock with the lock id.
+   *
+   * @param cacheId {string}
+   * @param lockId {string}
+   */;
+  _proto.releaseLock = function releaseLock(cacheId, lockId) {
+    try {
+      if (this._requestsManager.isTheLockActiveOne(cacheId, lockId)) {
+        this._requestsManager.finishActiveCalculation(cacheId);
+      }
+    } catch (e) {
+      improveAndRethrow(e, this._bio + ".releaseLock");
+    }
+  }
+
+  /**
+   * Actualized currently present cached data by key. Applies the provided function to the cached data.
+   *
+   * @param cacheId {string} id of cache entry
+   * @param synchronousCurrentCacheProcessor (function|null} synchronous function accepting cache entry. Should return
+   *        an object in following format:
+   *        {
+   *            isModified: boolean,
+   *            data: any
+   *        }
+   *        the flag signals whether data was changed during the processing or not
+   * @param [sessionDependent=true] {boolean} whether to mark the cache entry as session-dependent
+   */;
+  _proto.actualizeCachedData = function actualizeCachedData(cacheId, synchronousCurrentCacheProcessor, sessionDependent) {
+    if (sessionDependent === void 0) {
+      sessionDependent = true;
+    }
+    try {
+      var cached = this._cache.get(cacheId);
+      var result = synchronousCurrentCacheProcessor(cached);
+      if (result != null && result.isModified && (result == null ? void 0 : result.data) != null) {
+        if (sessionDependent) {
+          this._cache.putSessionDependentData(cacheId, result == null ? void 0 : result.data, this._getTtl());
+        } else {
+          this._cache.put(cacheId, result == null ? void 0 : result.data, this._getTtl());
+        }
+
+        /* Here we call the lock releasing to ensure the currently active calculation will be ignored.
+         * This is needed to ensure no 'lost update'.
+         * Lost update can occur if we change data in this method and after that some calculation finishes
+         * having the earlier data as its base to calculate its data set result. And the earlier data
+         * has no changes applied inside this method, so we will lose them.
+         *
+         * This is not so good solution: ideally, we should acquire lock before performing any data updating.
+         * But the goal of this method is to provide an instant ability to update the cached data.
+         * And if we start acquiring the lock here the data update can be postponed significantly.
+         * And this kills the desired nature of this method.
+         * So we better lose some data retrieval (means abusing the resource a bit) than lose
+         * the instant update expected after this method execution.
+         */
+        this._requestsManager.finishActiveCalculation(cacheId);
+      }
+    } catch (e) {
+      improveAndRethrow(e, this._bio + ".actualizeCachedData");
+    }
+  };
+  _proto.invalidate = function invalidate(key) {
+    this._cache.invalidate(key);
+    this._requestsManager.finishActiveCalculation(key);
+  };
+  _proto.invalidateContaining = function invalidateContaining(keyPart) {
+    this._cache.invalidateContaining(keyPart);
+    this._requestsManager.finishAllActiveCalculations(keyPart);
+  };
+  _proto.markAsExpiredButDontRemove = function markAsExpiredButDontRemove(key) {
+    if (this._removeExpiredCacheAutomatically) {
+      this._cache.markCacheItemAsExpiredButDontRemove(key, this._cacheTtlMs);
+    } else {
+      this._cache.setLastUpdateTimestamp(key, Date.now() - this._cacheTtlMs - 1);
+    }
+    this._requestsManager.finishAllActiveCalculations(key);
+  };
+  return CacheAndConcurrentRequestsResolver;
+}();
+var ManagerOfRequestsToTheSameResource = /*#__PURE__*/function () {
+  /**
+   * @param bio {string} resource-related identifier for logging
+   * @param [maxPollsCount=100] {number} max number of attempts to wait when waiting for a lock acquisition
+   * @param [timeoutDuration=1000] {number} timeout between the polls for a lock acquisition
+   */
+  function ManagerOfRequestsToTheSameResource(bio, maxPollsCount, timeoutDuration) {
+    if (maxPollsCount === void 0) {
+      maxPollsCount = 100;
+    }
+    if (timeoutDuration === void 0) {
+      timeoutDuration = 1000;
+    }
+    this.bio = bio;
+    this.maxPollsCount = maxPollsCount;
+    this.timeoutDuration = timeoutDuration;
+    this._activeCalculationsIds = new Map();
+    this._nextCalculationIds = new Map();
+  }
+
+  /**
+   * If there is no active calculation just creates uuid and returns it.
+   * If there is active calculation waits until it removed from the active calculation uuid variable.
+   *
+   * @param requestHash {string}
+   * @return {Promise<string|boolean>} returns uuid of new active calculation or true if waiting for active
+   *         calculation succeed or false if max attempts count exceeded
+   */
+  var _proto2 = ManagerOfRequestsToTheSameResource.prototype;
+  _proto2.startCalculationOrWaitForActiveToFinish = function startCalculationOrWaitForActiveToFinish(requestHash) {
+    try {
+      var _exit;
+      var _this3 = this;
+      var _temp3 = _catch$5(function () {
+        var activeCalculationIdForHash = _this3._activeCalculationsIds.get(requestHash);
+        if (activeCalculationIdForHash == null) {
+          var id = v4();
+          _this3._activeCalculationsIds.set(requestHash, id);
+          _exit = 1;
+          return id;
+        }
+        return Promise.resolve(_this3._waitForCalculationIdToFinish(requestHash, activeCalculationIdForHash, 0)).then(function (_await$_this3$_waitFo) {
+          _exit = 1;
+          return _await$_this3$_waitFo;
+        });
+      }, function (e) {
+        Logger.logError(e, "startCalculationOrWaitForActiveToFinish_" + _this3.bio);
+      });
+      return Promise.resolve(_temp3 && _temp3.then ? _temp3.then(function (_result3) {
+        return _exit ? _result3 : null;
+      }) : _exit ? _temp3 : null);
+    } catch (e) {
+      return Promise.reject(e);
+    }
+  }
+  /**
+   * Acquires lock to the resource by the provided hash.
+   *
+   * @param requestHash {string}
+   * @return {Promise<{ result: true, lockId: string }|{ result: false }>} result is true if the lock is successfully
+   *         acquired, false if the max allowed time to wait for acquisition expired or any unexpected error occurs
+   *         during the waiting.
+   */
+  ;
+  _proto2.acquireLock = function acquireLock(requestHash) {
+    try {
+      var _this4 = this;
+      return Promise.resolve(_catch$5(function () {
+        var _this4$_nextCalculati;
+        var activeId = _this4._activeCalculationsIds.get(requestHash);
+        var nextId = v4();
+        if (activeId == null) {
+          _this4._activeCalculationsIds.set(requestHash, nextId);
+          return {
+            result: true,
+            lockId: nextId
+          };
+        }
+        var currentNext = (_this4$_nextCalculati = _this4._nextCalculationIds.get(requestHash)) != null ? _this4$_nextCalculati : [];
+        currentNext.push(nextId);
+        _this4._nextCalculationIds.set(requestHash, currentNext);
+        return Promise.resolve(_this4._waitForCalculationIdToFinish(requestHash, activeId, 0, nextId)).then(function (waitingResult) {
+          return {
+            result: waitingResult,
+            lockId: waitingResult ? nextId : undefined
+          };
+        });
+      }, function (e) {
+        improveAndRethrow(e, "acquireLock");
+      }));
+    } catch (e) {
+      return Promise.reject(e);
+    }
+  }
+  /**
+   * Clears active calculation id.
+   * WARNING: if you forget to call this method the start* one will perform maxPollsCount attempts before finishing
+   * @param requestHash {string} hash of request. Helps to distinct the request for the same resource but
+   *        having different request parameters and hold a dedicated calculation id per this hash
+   */
+  ;
+  _proto2.finishActiveCalculation = function finishActiveCalculation(requestHash) {
+    if (requestHash === void 0) {
+      requestHash = "default";
+    }
+    try {
+      var _this$_nextCalculatio;
+      this._activeCalculationsIds["delete"](requestHash);
+      var next = (_this$_nextCalculatio = this._nextCalculationIds.get(requestHash)) != null ? _this$_nextCalculatio : [];
+      if (next.length) {
+        this._activeCalculationsIds.set(requestHash, next[0]);
+        this._nextCalculationIds.set(requestHash, next.slice(1));
+      }
+    } catch (e) {
+      improveAndRethrow(e, "finishActiveCalculation");
+    }
+  };
+  _proto2.finishAllActiveCalculations = function finishAllActiveCalculations(keyPart) {
+    var _this5 = this;
+    if (keyPart === void 0) {
+      keyPart = "";
+    }
+    try {
+      Array.from(this._activeCalculationsIds.keys()).forEach(function (hash) {
+        if (typeof hash === "string" && new RegExp(keyPart).test(hash)) {
+          _this5.finishActiveCalculation(hash);
+        }
+      });
+    } catch (e) {
+      improveAndRethrow(e, "finishAllActiveCalculations");
+    }
+  }
+
+  /**
+   * @param requestHash {string}
+   * @param lockId {string}
+   * @return {boolean}
+   */;
+  _proto2.isTheLockActiveOne = function isTheLockActiveOne(requestHash, lockId) {
+    try {
+      return this._activeCalculationsIds.get(requestHash) === lockId;
+    } catch (e) {
+      improveAndRethrow(e, "isTheLockActiveOne");
+    }
+  }
+
+  /**
+   * @param requestHash {string}
+   * @param activeCalculationId {string|null}
+   * @param [attemptIndex=0] {number}
+   * @param waitForCalculationId {string|null} if you want to wait for an exact id to appear as active then pass this parameter
+   * @return {Promise<boolean>} true
+   *                            - if the given calculation id is no more an active one
+   *                            - or it is equal to waitForCalculationId
+   *                            false
+   *                            - if waiting period exceeds the max allowed waiting time or unexpected error occurs
+   * @private
+   */;
+  _proto2._waitForCalculationIdToFinish = function _waitForCalculationIdToFinish(requestHash, activeCalculationId, attemptIndex, waitForCalculationId) {
+    if (attemptIndex === void 0) {
+      attemptIndex = 0;
+    }
+    if (waitForCalculationId === void 0) {
+      waitForCalculationId = null;
+    }
+    try {
+      var _this6 = this;
+      try {
+        if (attemptIndex + 1 > _this6.maxPollsCount) {
+          // Max number of polls for active calculation id change is achieved. So we return false.
+          return Promise.resolve(false);
+        }
+        var currentId = _this6._activeCalculationsIds.get(requestHash);
+        if (waitForCalculationId == null ? currentId !== activeCalculationId : currentId === waitForCalculationId) {
+          /* We return true depending on the usage of this function:
+           * 1. if there is calculation id that we should wait for to become an active then we return true only
+           *    if this id becomes the active one.
+           *
+           *    Theoretically we can fail to wait for the desired calculation id. This can be caused by wrong use of
+           *    this service or by any other mistakes/errors. But this waiting function will return false anyway if
+           *    the number of polls done exceeds the max allowed.
+           *
+           * 2. if we just wait for the currently active calculation id to be finished then we return true
+           *    when we notice that the current active id differs from the original passed into this function.
+           */
+          return Promise.resolve(true);
+        } else {
+          /* The original calculation id is still the active one, so we are scheduling a new attempt to check
+           * whether the active calculation id changed or not in timeoutDuration milliseconds.
+           */
+          var it = _this6;
+          return Promise.resolve(new Promise(function (resolve, reject) {
+            setTimeout(function () {
+              try {
+                resolve(it._waitForCalculationIdToFinish(requestHash, activeCalculationId, attemptIndex + 1));
+              } catch (e) {
+                reject(e);
+              }
+            }, _this6.timeoutDuration);
+          }));
+        }
+      } catch (e) {
+        Logger.logError(e, "_waitForCalculationIdToFinish", "Failed to wait for active calculation id change.");
+        return Promise.resolve(false);
+      }
+    } catch (e) {
+      return Promise.reject(e);
+    }
+  };
+  return ManagerOfRequestsToTheSameResource;
+}();
+
+// TODO: [refactoring, low] Consider removing this logic task_id=c360f2af75764bde8badd9ff1cc00d48
+var ConcurrentCalculationsMetadataHolder = /*#__PURE__*/function () {
+  function ConcurrentCalculationsMetadataHolder() {
+    this._calculations = {};
+  }
+  var _proto = ConcurrentCalculationsMetadataHolder.prototype;
+  _proto.startCalculation = function startCalculation(domain, calculationsHistoryMaxLength) {
+    if (calculationsHistoryMaxLength === void 0) {
+      calculationsHistoryMaxLength = 100;
+    }
+    if (!this._calculations[domain]) {
+      this._calculations[domain] = [];
+    }
+    if (this._calculations[domain].length > calculationsHistoryMaxLength) {
+      this._calculations[domain] = this._calculations[domain].slice(Math.round(calculationsHistoryMaxLength * 0.2));
+    }
+    var newCalculation = {
+      startTimestamp: Date.now(),
+      endTimestamp: null,
+      uuid: v4()
+    };
+    this._calculations[domain].push(newCalculation);
+    return newCalculation.uuid;
+  };
+  _proto.endCalculation = function endCalculation(domain, uuid, isFailed) {
+    if (isFailed === void 0) {
+      isFailed = false;
+    }
+    try {
+      var _calculation$endTimes, _calculation$startTim, _calculation$uuid;
+      var calculation = this._calculations[domain].find(function (calculation) {
+        return (calculation == null ? void 0 : calculation.uuid) === uuid;
+      });
+      if (calculation) {
+        calculation.endTimestamp = Date.now();
+        calculation.isFiled = isFailed;
+      }
+      var elapsed = ((((_calculation$endTimes = calculation == null ? void 0 : calculation.endTimestamp) != null ? _calculation$endTimes : 0) - ((_calculation$startTim = calculation == null ? void 0 : calculation.startTimestamp) != null ? _calculation$startTim : 0)) / 1000).toFixed(1);
+      Logger.log("endCalculation", elapsed + " ms: " + domain + "." + ((_calculation$uuid = calculation == null ? void 0 : calculation.uuid) != null ? _calculation$uuid : "").slice(0, 7));
+      return calculation;
+    } catch (e) {
+      Logger.logError(e, "endCalculation");
+    }
+  };
+  _proto.isCalculationLate = function isCalculationLate(domain, uuid) {
+    var queue = this._calculations[domain];
+    var analysingCalculation = queue.find(function (item) {
+      return item.uuid === uuid;
+    });
+    return analysingCalculation && !!queue.find(function (calculation) {
+      return calculation.endTimestamp != null && calculation.startTimestamp > analysingCalculation.startTimestamp;
+    });
+  };
+  _proto.printCalculationsWaitingMoreThanSpecifiedSeconds = function printCalculationsWaitingMoreThanSpecifiedSeconds(waitingLastsMs) {
+    var _this = this;
+    if (waitingLastsMs === void 0) {
+      waitingLastsMs = 2000;
+    }
+    var calculations = Object.keys(this._calculations).map(function (domain) {
+      return _this._calculations[domain].map(function (c) {
+        return _extends({}, c, {
+          domain: domain
+        });
+      });
+    }).flat().filter(function (c) {
+      return c.endTimestamp === null && Date.now() - c.startTimestamp > waitingLastsMs;
+    });
+    Logger.log("printCalculationsWaitingMoreThanSpecifiedSeconds", "Calculations waiting more than " + (waitingLastsMs / 1000).toFixed(1) + "s:\n" + calculations.map(function (c) {
+      return c.domain + "." + c.uuid.slice(0, 8) + ": " + (Date.now() - c.startTimestamp) + "\n";
+    }));
+  };
+  return ConcurrentCalculationsMetadataHolder;
+}();
+var concurrentCalculationsMetadataHolder = new ConcurrentCalculationsMetadataHolder();
+
+var ExternalServicesStatsCollector = /*#__PURE__*/function () {
+  function ExternalServicesStatsCollector() {
+    this.stats = new Map();
+  }
+  var _proto = ExternalServicesStatsCollector.prototype;
+  _proto.externalServiceFailed = function externalServiceFailed(serviceUrl, message) {
+    try {
+      var processMessage = function processMessage(stat, errorMessage) {
+        var _stat$errors, _errorMessage;
+        var errors = (_stat$errors = stat.errors) != null ? _stat$errors : {};
+        errorMessage = (_errorMessage = errorMessage) != null ? _errorMessage : "";
+        if (errorMessage.match(/.*network.+error.*/i)) {
+          errors["networkError"] = (errors["networkError"] || 0) + 1;
+        } else if (errorMessage.match(/.*timeout.+exceeded.*/i)) {
+          errors["timeoutExceeded"] = (errors["timeoutExceeded"] || 0) + 1;
+        } else if (errors["other"]) {
+          errors["other"].push(message);
+        } else {
+          errors["other"] = [message];
+        }
+        stat.errors = errors;
+      };
+      if (this.stats.has(serviceUrl)) {
+        var stat = this.stats.get(serviceUrl);
+        stat.callsCount += 1;
+        stat.failsCount += 1;
+        processMessage(stat, message);
+      } else {
+        this.stats.set(serviceUrl, {
+          callsCount: 1,
+          failsCount: 1
+        });
+        processMessage(this.stats.get(serviceUrl), message);
+      }
+    } catch (e) {
+      improveAndRethrow(e, "externalServiceFailed");
+    }
+  };
+  _proto.externalServiceCalledWithoutError = function externalServiceCalledWithoutError(serviceUrl) {
+    try {
+      if (this.stats.has(serviceUrl)) {
+        var stat = this.stats.get(serviceUrl);
+        stat.callsCount += 1;
+      } else {
+        this.stats.set(serviceUrl, {
+          callsCount: 1,
+          failsCount: 0
+        });
+      }
+    } catch (e) {
+      improveAndRethrow(e, "externalServiceCalledWithoutError");
+    }
+  }
+
+  /**
+   * Returns statistics about external services failures.
+   * Provides how many calls were performed and what the percent of failed calls. Also returns errors stat.
+   *
+   * @return {Array<object>} Array of objects of type { failsPerCent: number, calls: number }
+   *                         sorted by the highest fails percent desc
+   */;
+  _proto.getStats = function getStats() {
+    var _this = this;
+    try {
+      return Array.from(this.stats.keys()).map(function (key) {
+        var _stat$errors2;
+        var stat = _this.stats.get(key);
+        return {
+          url: key,
+          failsPerCent: (stat.failsCount / stat.callsCount * 100).toFixed(2),
+          calls: stat.callsCount,
+          errors: (_stat$errors2 = stat.errors) != null ? _stat$errors2 : []
+        };
+      }).sort(function (s1, s2) {
+        return s1.failsPerCent - s2.failsPerCent;
+      });
+    } catch (e) {
+      Logger.logError(e, "getStats");
+    }
+  };
+  return ExternalServicesStatsCollector;
+}();
+
+/**
+ * TODO: [refactoring, critical] update backend copy of this service. Also there is a task to extract this
+ *                               service and other related to it stuff to dedicated npm package task_id=b008ee5e4a3f42c08c73831c4bb3db4e
+ *
+ * Template service needed to avoid duplication of the same logic when we need to call
+ * external APIs to retrieve some data. The idea is to use several API providers to retrieve the same data. It helps to
+ * improve the reliability of a data retrieval.
+ */
+
+function _catch$4(body, recover) {
+  try {
+    var result = body();
+  } catch (e) {
+    return recover(e);
+  }
+  if (result && result.then) {
+    return result.then(void 0, recover);
+  }
+  return result;
+}
+function _settle$1(pact, state, value) {
+  if (!pact.s) {
+    if (value instanceof _Pact$1) {
+      if (value.s) {
+        if (state & 1) {
+          state = value.s;
+        }
+        value = value.v;
+      } else {
+        value.o = _settle$1.bind(null, pact, state);
+        return;
+      }
+    }
+    if (value && value.then) {
+      value.then(_settle$1.bind(null, pact, state), _settle$1.bind(null, pact, 2));
+      return;
+    }
+    pact.s = state;
+    pact.v = value;
+    var observer = pact.o;
+    if (observer) {
+      observer(pact);
+    }
+  }
+}
+var _Pact$1 = /*#__PURE__*/function () {
+  function _Pact() {}
+  _Pact.prototype.then = function (onFulfilled, onRejected) {
+    var result = new _Pact();
+    var state = this.s;
+    if (state) {
+      var callback = state & 1 ? onFulfilled : onRejected;
+      if (callback) {
+        try {
+          _settle$1(result, 1, callback(this.v));
+        } catch (e) {
+          _settle$1(result, 2, e);
+        }
+        return result;
+      } else {
+        return this;
+      }
+    }
+    this.o = function (_this) {
+      try {
+        var value = _this.v;
+        if (_this.s & 1) {
+          _settle$1(result, 1, onFulfilled ? onFulfilled(value) : value);
+        } else if (onRejected) {
+          _settle$1(result, 1, onRejected(value));
+        } else {
+          _settle$1(result, 2, value);
+        }
+      } catch (e) {
+        _settle$1(result, 2, e);
+      }
+    };
+    return result;
+  };
+  return _Pact;
+}();
+function _isSettledPact$1(thenable) {
+  return thenable instanceof _Pact$1 && thenable.s & 1;
+}
+function _for(test, update, body) {
+  var stage;
+  for (;;) {
+    var shouldContinue = test();
+    if (_isSettledPact$1(shouldContinue)) {
+      shouldContinue = shouldContinue.v;
+    }
+    if (!shouldContinue) {
+      return result;
+    }
+    if (shouldContinue.then) {
+      stage = 0;
+      break;
+    }
+    var result = body();
+    if (result && result.then) {
+      if (_isSettledPact$1(result)) {
+        result = result.s;
+      } else {
+        stage = 1;
+        break;
+      }
+    }
+    if (update) {
+      var updateValue = update();
+      if (updateValue && updateValue.then && !_isSettledPact$1(updateValue)) {
+        stage = 2;
+        break;
+      }
+    }
+  }
+  var pact = new _Pact$1();
+  var reject = _settle$1.bind(null, pact, 2);
+  (stage === 0 ? shouldContinue.then(_resumeAfterTest) : stage === 1 ? result.then(_resumeAfterBody) : updateValue.then(_resumeAfterUpdate)).then(void 0, reject);
+  return pact;
+  function _resumeAfterBody(value) {
+    result = value;
+    do {
+      if (update) {
+        updateValue = update();
+        if (updateValue && updateValue.then && !_isSettledPact$1(updateValue)) {
+          updateValue.then(_resumeAfterUpdate).then(void 0, reject);
+          return;
+        }
+      }
+      shouldContinue = test();
+      if (!shouldContinue || _isSettledPact$1(shouldContinue) && !shouldContinue.v) {
+        _settle$1(pact, 1, result);
+        return;
+      }
+      if (shouldContinue.then) {
+        shouldContinue.then(_resumeAfterTest).then(void 0, reject);
+        return;
+      }
+      result = body();
+      if (_isSettledPact$1(result)) {
+        result = result.v;
+      }
+    } while (!result || !result.then);
+    result.then(_resumeAfterBody).then(void 0, reject);
+  }
+  function _resumeAfterTest(shouldContinue) {
+    if (shouldContinue) {
+      result = body();
+      if (result && result.then) {
+        result.then(_resumeAfterBody).then(void 0, reject);
+      } else {
+        _resumeAfterBody(result);
+      }
+    } else {
+      _settle$1(pact, 1, result);
+    }
+  }
+  function _resumeAfterUpdate() {
+    if (shouldContinue = test()) {
+      if (shouldContinue.then) {
+        shouldContinue.then(_resumeAfterTest).then(void 0, reject);
+      } else {
+        _resumeAfterTest(shouldContinue);
+      }
+    } else {
+      _settle$1(pact, 1, result);
+    }
+  }
+}
+function _finallyRethrows$1(body, finalizer) {
+  try {
+    var result = body();
+  } catch (e) {
+    return finalizer(true, e);
+  }
+  if (result && result.then) {
+    return result.then(finalizer.bind(null, false), finalizer.bind(null, true));
+  }
+  return finalizer(false, result);
+}
+function _do(body, test) {
+  var awaitBody;
+  do {
+    var result = body();
+    if (result && result.then) {
+      if (_isSettledPact$1(result)) {
+        result = result.v;
+      } else {
+        awaitBody = true;
+        break;
+      }
+    }
+    var shouldContinue = test();
+    if (_isSettledPact$1(shouldContinue)) {
+      shouldContinue = shouldContinue.v;
+    }
+    if (!shouldContinue) {
+      return result;
+    }
+  } while (!shouldContinue.then);
+  var pact = new _Pact$1();
+  var reject = _settle$1.bind(null, pact, 2);
+  (awaitBody ? result.then(_resumeAfterBody) : shouldContinue.then(_resumeAfterTest)).then(void 0, reject);
+  return pact;
+  function _resumeAfterBody(value) {
+    result = value;
+    for (;;) {
+      shouldContinue = test();
+      if (_isSettledPact$1(shouldContinue)) {
+        shouldContinue = shouldContinue.v;
+      }
+      if (!shouldContinue) {
+        break;
+      }
+      if (shouldContinue.then) {
+        shouldContinue.then(_resumeAfterTest).then(void 0, reject);
+        return;
+      }
+      result = body();
+      if (result && result.then) {
+        if (_isSettledPact$1(result)) {
+          result = result.v;
+        } else {
+          result.then(_resumeAfterBody).then(void 0, reject);
+          return;
+        }
+      }
+    }
+    _settle$1(pact, 1, result);
+  }
+  function _resumeAfterTest(shouldContinue) {
+    if (shouldContinue) {
+      do {
+        result = body();
+        if (result && result.then) {
+          if (_isSettledPact$1(result)) {
+            result = result.v;
+          } else {
+            result.then(_resumeAfterBody).then(void 0, reject);
+            return;
+          }
+        }
+        shouldContinue = test();
+        if (_isSettledPact$1(shouldContinue)) {
+          shouldContinue = shouldContinue.v;
+        }
+        if (!shouldContinue) {
+          _settle$1(pact, 1, result);
+          return;
+        }
+      } while (!shouldContinue.then);
+      shouldContinue.then(_resumeAfterTest).then(void 0, reject);
+    } else {
+      _settle$1(pact, 1, result);
+    }
+  }
+}
+function _forTo$1(array, body, check) {
+  var i = -1,
+    pact,
+    reject;
+  function _cycle(result) {
+    try {
+      while (++i < array.length && (!check || !check())) {
+        result = body(i);
+        if (result && result.then) {
+          if (_isSettledPact$1(result)) {
+            result = result.v;
+          } else {
+            result.then(_cycle, reject || (reject = _settle$1.bind(null, pact = new _Pact$1(), 2)));
+            return;
+          }
+        }
+      }
+      if (pact) {
+        _settle$1(pact, 1, result);
+      } else {
+        pact = result;
+      }
+    } catch (e) {
+      _settle$1(pact || (pact = new _Pact$1()), 2, e);
+    }
+  }
+  _cycle();
+  return pact;
+}
+var RobustExternalAPICallerService = /*#__PURE__*/function () {
+  RobustExternalAPICallerService.getStats = function getStats() {
+    this.statsCollector.getStats();
+  }
+
+  /**
+   * @param bio {string} service name for logging
+   * @param providersData {ExternalApiProvider[]} array of providers
+   * @param [logger] {function} function to be used for logging
+   */;
+  function RobustExternalAPICallerService(bio, providersData, logger) {
+    providersData.forEach(function (provider) {
+      if (!provider.endpoint && provider.endpoint !== "" || !provider.httpMethod) {
+        throw new Error("Wrong format of providers data for: " + JSON.stringify(provider));
+      }
+    });
+
+    // We add niceFactor - just number to order the providers array by. It is helpful to call
+    // less robust APIs only if more robust fails
+    this.providers = providersData;
+    providersData.forEach(function (provider) {
+      return provider.resetNiceFactor();
+    });
+    this.bio = bio;
+    this._logger = Logger.logError;
+  }
+  var _proto = RobustExternalAPICallerService.prototype;
+  /**
+   * Performs data retrieval from external APIs. Tries providers till the data is retrieved.
+   *
+   * @param parametersValues {array} array of values of the parameters for URL query string [and/or body]
+   * @param timeoutMS {number} http timeout to wait for response. If provider has its specific timeout value then it is used
+   * @param [cancelToken] {object|undefined} axios token to force-cancel requests from high-level code
+   * @param [attemptsCount] {number|undefined} number of attempts to be performed
+   * @param [doNotFailForNowData] {boolean|undefined} pass true if you do not want us to throw an error if we retrieved null data from all the providers
+   * @return {Promise<any>} resolving to retrieved data (or array of results if specific provider requires
+   *         several requests. NOTE: we flatten nested arrays - results of each separate request done for the specific provider)
+   * @throws Error if requests to all providers are failed
+   */
+  _proto.callExternalAPI = function callExternalAPI(parametersValues, timeoutMS, cancelToken, attemptsCount, doNotFailForNowData) {
+    if (parametersValues === void 0) {
+      parametersValues = [];
+    }
+    if (timeoutMS === void 0) {
+      timeoutMS = 3500;
+    }
+    if (cancelToken === void 0) {
+      cancelToken = null;
+    }
+    if (attemptsCount === void 0) {
+      attemptsCount = 1;
+    }
+    if (doNotFailForNowData === void 0) {
+      doNotFailForNowData = false;
+    }
+    try {
+      var _this = this;
+      var result;
+      var calculationUuid = concurrentCalculationsMetadataHolder.startCalculation(_this.bio);
+      return Promise.resolve(_finallyRethrows$1(function () {
+        return _catch$4(function () {
+          function _temp5() {
+            var _result2, _result3;
+            if (((_result2 = result) == null ? void 0 : _result2.data) == null) {
+              // TODO: [feature, moderate] looks like we should not fail for null data as it is strange - the provider will fail when processing data internally
+              var error = new Error("Failed to retrieve data. It means all attempts have been failed. DEV: add more attempts to this data retrieval");
+              if (!doNotFailForNowData) {
+                throw error;
+              } else {
+                _this._logger(error, _this.bio + ".callExternalAPI");
+              }
+            }
+            return (_result3 = result) == null ? void 0 : _result3.data;
+          }
+          var i = 0;
+          var _temp4 = _for(function () {
+            var _result4, _result5;
+            return (i < attemptsCount || !!((_result4 = result) != null && _result4.shouldBeForceRetried)) && ((_result5 = result) == null ? void 0 : _result5.data) == null;
+          }, function () {
+            return ++i;
+          }, function () {
+            /**
+             * We use rpsFactor to improve re-attempting to call the providers if the last attempt resulted with
+             * the fail due to abused RPSes of some (most part of) providers.
+             * The _performCallAttempt in such a case will return increased rpsFactor inside the result object.
+             */
+            var rpsFactor = result ? result.rpsFactor : RobustExternalAPICallerService.defaultRPSFactor;
+            result = null;
+            var _temp3 = _catch$4(function () {
+              function _temp2() {
+                var _result$errors;
+                if ((_result$errors = result.errors) != null && _result$errors.length) {
+                  var errors = result.errors;
+                  _this._logger(new Error("Failed at attempt " + i + ". " + errors.length + " errors. Messages: " + safeStringify(errors.map(function (error) {
+                    return error.message;
+                  })) + ": " + safeStringify(errors) + "."), _this.bio + ".callExternalAPI", "", true);
+                }
+              }
+              var _temp = function (_result6) {
+                if (i === 0 && !((_result6 = result) != null && _result6.shouldBeForceRetried)) {
+                  return Promise.resolve(_this._performCallAttempt(parametersValues, timeoutMS, cancelToken, rpsFactor, doNotFailForNowData)).then(function (_this$_performCallAtt) {
+                    result = _this$_performCallAtt;
+                  });
+                } else {
+                  var maxRps = Math.max.apply(Math, _this.providers.map(function (provider) {
+                    var _provider$getRps;
+                    return (_provider$getRps = provider.getRps()) != null ? _provider$getRps : 0;
+                  }));
+                  var waitingTimeMs = maxRps ? 1000 / (maxRps / rpsFactor) : 0;
+                  return Promise.resolve(new Promise(function (resolve, reject) {
+                    setTimeout(function () {
+                      try {
+                        var _temp6 = _catch$4(function () {
+                          return Promise.resolve(_this._performCallAttempt(parametersValues, timeoutMS, cancelToken, rpsFactor, doNotFailForNowData)).then(function (_this$_performCallAtt2) {
+                            resolve(_this$_performCallAtt2);
+                          });
+                        }, function (e) {
+                          reject(e);
+                        });
+                        return Promise.resolve(_temp6 && _temp6.then ? _temp6.then(function () {}) : void 0);
+                      } catch (e) {
+                        return Promise.reject(e);
+                      }
+                    }, waitingTimeMs);
+                  })).then(function (_Promise) {
+                    result = _Promise;
+                  });
+                }
+              }();
+              return _temp && _temp.then ? _temp.then(_temp2) : _temp2(_temp);
+            }, function (e) {
+              _this._logger(e, _this.bio + ".callExternalAPI", "Failed to perform external providers calling");
+            });
+            if (_temp3 && _temp3.then) return _temp3.then(function () {});
+          });
+          return _temp4 && _temp4.then ? _temp4.then(_temp5) : _temp5(_temp4);
+        }, function (e) {
+          improveAndRethrow(e, _this.bio + ".callExternalAPI");
+        });
+      }, function (_wasThrown, _result) {
+        concurrentCalculationsMetadataHolder.endCalculation(_this.bio, calculationUuid);
+        if (_wasThrown) throw _result;
+        return _result;
+      }));
+    } catch (e) {
+      return Promise.reject(e);
+    }
+  };
+  _proto._performCallAttempt = function _performCallAttempt(parametersValues, timeoutMS, cancelToken, rpsFactor, doNotFailForNowData) {
+    try {
+      var _temp15 = function _temp15() {
+        var _data;
+        // If we are declining more than 50% of providers (by exceeding RPS) then we note that it better to retry the whole process of providers requesting
+        var shouldBeForceRetried = data == null && countOfRequestsDeclinedByRps > Math.floor(providers.length * 0.5);
+        var rpsMultiplier = shouldBeForceRetried ? RobustExternalAPICallerService.rpsMultiplier : 1;
+        return {
+          data: (_data = data) != null ? _data : null,
+          shouldBeForceRetried: shouldBeForceRetried,
+          rpsFactor: rpsFactor * rpsMultiplier,
+          errors: errors
+        };
+      };
+      var _this2 = this;
+      var providers = _this2._reorderProvidersByNiceFactor();
+      var data = undefined,
+        providerIndex = 0,
+        countOfRequestsDeclinedByRps = 0,
+        errors = [];
+      var _temp14 = _for(function () {
+        return !data && providerIndex < providers.length;
+      }, void 0, function () {
+        var provider = providers[providerIndex];
+        if (provider.isRpsExceeded()) {
+          /**
+           * Current provider's RPS is exceeded, so we try next provider. Also, we count such cases to make
+           * a decision about the force-retry need.
+           */
+          ++providerIndex;
+          ++countOfRequestsDeclinedByRps;
+          return;
+        }
+        var _temp13 = _finallyRethrows$1(function () {
+          return _catch$4(function () {
+            var _provider$specificHea;
+            function _temp12() {
+              if (iterationsData.length) {
+                if (httpMethods.length > 1) {
+                  data = provider.incorporateIterationsData(iterationsData);
+                } else {
+                  data = iterationsData[0];
+                }
+              } else if (!doNotFailForNowData) {
+                RobustExternalAPICallerService.statsCollector.externalServiceFailed(provider.getApiGroupId(), "Response data was null for some reason");
+                punishProvider(provider);
+              }
+            }
+            var axiosConfig = _extends({}, cancelToken ? {
+              cancelToken: cancelToken
+            } : {}, {
+              timeout: provider.timeout || timeoutMS,
+              headers: (_provider$specificHea = provider.specificHeaders) != null ? _provider$specificHea : {}
+            });
+            var httpMethods = Array.isArray(provider.httpMethod) ? provider.httpMethod : [provider.httpMethod];
+            var iterationsData = [];
+            var _temp11 = _forTo$1(httpMethods, function (subRequestIndex) {
+              function _temp10() {
+                var responsesDataForPages = responsesForPages.map(function (response) {
+                  return provider.getDataByResponse(response, parametersValues, subRequestIndex, iterationsData);
+                });
+                var allData = responsesDataForPages;
+                if (Array.isArray(responsesDataForPages[0])) {
+                  allData = responsesDataForPages.flat();
+                } else if (responsesDataForPages.length === 1) {
+                  allData = responsesDataForPages[0];
+                }
+                iterationsData.push(allData);
+              }
+              var query = provider.composeQueryString(parametersValues, subRequestIndex);
+              var endpoint = "" + provider.endpoint + query;
+              var axiosParams = [endpoint, axiosConfig];
+              if (["post", "put", "patch"].find(function (method) {
+                return method === httpMethods[subRequestIndex];
+              })) {
+                var _provider$composeBody;
+                var body = (_provider$composeBody = provider.composeBody(parametersValues, subRequestIndex)) != null ? _provider$composeBody : null;
+                axiosParams.splice(1, 0, body);
+              }
+              var pageNumber = 0;
+              var responsesForPages = [];
+              var hasNextPage = provider.doesSupportPagination();
+              var _temp9 = _do(function () {
+                function _temp8() {
+                  if (hasNextPage) {
+                    hasNextPage = !provider.checkWhetherResponseIsForLastPage(responsesForPages[pageNumber - 1], responsesForPages[pageNumber], pageNumber, subRequestIndex);
+                  }
+                  pageNumber++;
+                }
+                var _temp7 = function () {
+                  if (subRequestIndex === 0 && pageNumber === 0) {
+                    provider.actualizeLastCalledTimestamp();
+                    return Promise.resolve(AxiosAdapter.call.apply(AxiosAdapter, [httpMethods[subRequestIndex]].concat(axiosParams))).then(function (_AxiosAdapter$call) {
+                      responsesForPages[pageNumber] = _AxiosAdapter$call;
+                      RobustExternalAPICallerService.statsCollector.externalServiceCalledWithoutError(provider.getApiGroupId());
+                    });
+                  } else {
+                    if (pageNumber > 0) {
+                      var actualizedParams = provider.changeQueryParametersForPageNumber(parametersValues, responsesForPages[pageNumber - 1], pageNumber, subRequestIndex);
+                      var _query = provider.composeQueryString(actualizedParams, subRequestIndex);
+                      axiosParams[0] = "" + provider.endpoint + _query;
+                    }
+                    /**
+                     * For second and more request we postpone each request to not exceed RPS
+                     * of current provider. We use rpsFactor to dynamically increase the rps to avoid
+                     * too frequent calls if we continue failing to retrieve the data due to RPS exceeding.
+                     * TODO: [dev] test RPS factor logic (units or integration)
+                     */
+
+                    var waitingTimeMS = provider.getRps() ? 1000 / (provider.getRps() / rpsFactor) : 0;
+                    var postponeUntilRpsExceeded = function postponeUntilRpsExceeded(recursionLevel) {
+                      if (recursionLevel === void 0) {
+                        recursionLevel = 0;
+                      }
+                      try {
+                        return Promise.resolve(postponeExecution(function () {
+                          try {
+                            var _temp17 = function _temp17(_result8) {
+                              if (_exit) return _result8;
+                              provider.actualizeLastCalledTimestamp();
+                              return Promise.resolve(AxiosAdapter.call.apply(AxiosAdapter, [httpMethods[subRequestIndex]].concat(axiosParams)));
+                            };
+                            var _exit;
+                            var maxCountOfPostponingAttempts = 2;
+                            var _temp16 = function () {
+                              if (provider.isRpsExceeded() && recursionLevel < maxCountOfPostponingAttempts) {
+                                return Promise.resolve(postponeUntilRpsExceeded(recursionLevel + 1)).then(function (_await$postponeUntilR) {
+                                  _exit = 1;
+                                  return _await$postponeUntilR;
+                                });
+                              }
+                            }();
+                            return Promise.resolve(_temp16 && _temp16.then ? _temp16.then(_temp17) : _temp17(_temp16));
+                          } catch (e) {
+                            return Promise.reject(e);
+                          }
+                        }, waitingTimeMS));
+                      } catch (e) {
+                        return Promise.reject(e);
+                      }
+                    };
+                    return Promise.resolve(postponeUntilRpsExceeded()).then(function (_postponeUntilRpsExce) {
+                      responsesForPages[pageNumber] = _postponeUntilRpsExce;
+                    });
+                  }
+                }();
+                return _temp7 && _temp7.then ? _temp7.then(_temp8) : _temp8(_temp7);
+              }, function () {
+                return !!hasNextPage;
+              });
+              return _temp9 && _temp9.then ? _temp9.then(_temp10) : _temp10(_temp9);
+            });
+            return _temp11 && _temp11.then ? _temp11.then(_temp12) : _temp12(_temp11);
+          }, function (e) {
+            punishProvider(provider);
+            RobustExternalAPICallerService.statsCollector.externalServiceFailed(provider.getApiGroupId(), e == null ? void 0 : e.message);
+            errors.push(e);
+          });
+        }, function (_wasThrown2, _result7) {
+          providerIndex++;
+          if (_wasThrown2) throw _result7;
+          return _result7;
+        });
+        if (_temp13 && _temp13.then) return _temp13.then(function () {});
+      });
+      return Promise.resolve(_temp14 && _temp14.then ? _temp14.then(_temp15) : _temp15(_temp14));
+    } catch (e) {
+      return Promise.reject(e);
+    }
+  };
+  _proto._reorderProvidersByNiceFactor = function _reorderProvidersByNiceFactor() {
+    var providersCopy = [].concat(this.providers);
+    return providersCopy.sort(function (p1, p2) {
+      return p2.niceFactor - p1.niceFactor;
+    });
+  };
+  return RobustExternalAPICallerService;
+}();
+RobustExternalAPICallerService.statsCollector = new ExternalServicesStatsCollector();
+RobustExternalAPICallerService.defaultRPSFactor = 1;
+RobustExternalAPICallerService.rpsMultiplier = 1.05;
+function punishProvider(provider) {
+  provider.niceFactor = provider.niceFactor - 1;
+}
+
+/**
+ * Extended edit of RobustExternalApiCallerService supporting cache and management of concurrent requests
+ * to the same resource.
+ * TODO: [tests, critical] Massively used logic
+ */
+
+function _catch$3(body, recover) {
+  try {
+    var result = body();
+  } catch (e) {
+    return recover(e);
+  }
+  if (result && result.then) {
+    return result.then(void 0, recover);
+  }
+  return result;
+}
+function _finallyRethrows(body, finalizer) {
+  try {
+    var result = body();
+  } catch (e) {
+    return finalizer(true, e);
+  }
+  if (result && result.then) {
+    return result.then(finalizer.bind(null, false), finalizer.bind(null, true));
+  }
+  return finalizer(false, result);
+}
+var CachedRobustExternalApiCallerService = /*#__PURE__*/function () {
+  /**
+   * @param bio {string} unique service identifier
+   * @param cache {Cache} cache instance
+   * @param providersData {ExternalApiProvider[]} array of providers
+   * @param [cacheTtlMs=10000] {number} time to live for cache ms
+   * @param [maxCallAttemptsToWaitForAlreadyRunningRequest=50] {number} see details in CacheAndConcurrentRequestsResolver
+   * @param [timeoutBetweenAttemptsToCheckWhetherAlreadyRunningRequestFinished=3000] {number} see details in CacheAndConcurrentRequestsResolver
+   * @param [removeExpiredCacheAutomatically=true] {boolean} whether to remove cached data automatically when ttl exceeds
+   * @param [mergeCachedAndNewlyRetrievedData=null] {function} function accepting cached data, newly retrieved data and id field name for list items
+   *        and merging them. use if needed
+   */
+  function CachedRobustExternalApiCallerService(bio, cache, providersData, cacheTtlMs, removeExpiredCacheAutomatically, mergeCachedAndNewlyRetrievedData, maxCallAttemptsToWaitForAlreadyRunningRequest, timeoutBetweenAttemptsToCheckWhetherAlreadyRunningRequestFinished) {
+    if (cacheTtlMs === void 0) {
+      cacheTtlMs = 10000;
+    }
+    if (removeExpiredCacheAutomatically === void 0) {
+      removeExpiredCacheAutomatically = true;
+    }
+    if (mergeCachedAndNewlyRetrievedData === void 0) {
+      mergeCachedAndNewlyRetrievedData = null;
+    }
+    if (maxCallAttemptsToWaitForAlreadyRunningRequest === void 0) {
+      maxCallAttemptsToWaitForAlreadyRunningRequest = 100;
+    }
+    if (timeoutBetweenAttemptsToCheckWhetherAlreadyRunningRequestFinished === void 0) {
+      timeoutBetweenAttemptsToCheckWhetherAlreadyRunningRequestFinished = 1000;
+    }
+    this._provider = new RobustExternalAPICallerService("cached_" + bio, providersData, Logger.logError);
+    this._cacheTtlMs = cacheTtlMs;
+    this._cahceAndRequestsResolver = new CacheAndConcurrentRequestsResolver(bio, cache, cacheTtlMs, removeExpiredCacheAutomatically, maxCallAttemptsToWaitForAlreadyRunningRequest, timeoutBetweenAttemptsToCheckWhetherAlreadyRunningRequestFinished);
+    this._cahceIds = [];
+    this._mergeCachedAndNewlyRetrievedData = mergeCachedAndNewlyRetrievedData;
+  }
+
+  /**
+   * Calls the external API or returns data from cache. Just waits if the same data already requested.
+   *
+   * @param parametersValues {array} array of values of the parameters for URL query string [and/or body]
+   * @param timeoutMS {number} http timeout to wait for response. If provider has its specific timeout value then it is used
+   * @param [cancelToken] {object|undefined} axios token to force-cancel requests from high-level code
+   * @param [attemptsCount] {number|undefined} number of attempts to be performed
+   * @param [customHashFunctionForParams] {function|undefined} function without params calculating the hash to be
+   *        added to bio of the service to compose a unique parameters-specific cache id
+   * @param [doNotFailForNowData] {boolean|undefined} pass true if you do not want us to throw an error if we retrieved null data from all the providers
+   * @return {Promise<any>} resolving to retrieved data (or array of results if specific provider requires
+   *         several requests. NOTE: we flatten nested arrays - results of each separate request done for the specific provider)
+   * @throws Error if requests to all providers are failed
+   */
+  var _proto = CachedRobustExternalApiCallerService.prototype;
+  _proto.callExternalAPICached = function callExternalAPICached(parametersValues, timeoutMS, cancelToken, attemptsCount, customHashFunctionForParams, doNotFailForNowData) {
+    if (parametersValues === void 0) {
+      parametersValues = [];
+    }
+    if (timeoutMS === void 0) {
+      timeoutMS = 3500;
+    }
+    if (cancelToken === void 0) {
+      cancelToken = null;
+    }
+    if (attemptsCount === void 0) {
+      attemptsCount = 1;
+    }
+    if (customHashFunctionForParams === void 0) {
+      customHashFunctionForParams = null;
+    }
+    if (doNotFailForNowData === void 0) {
+      doNotFailForNowData = false;
+    }
+    try {
+      var _this = this;
+      var loggerSource = _this._provider.bio + ".callExternalAPICached";
+      var cacheId;
+      var result;
+      return Promise.resolve(_finallyRethrows(function () {
+        return _catch$3(function () {
+          cacheId = _this._calculateCacheId(parametersValues, customHashFunctionForParams);
+          return Promise.resolve(_this._cahceAndRequestsResolver.getCachedOrWaitForCachedOrAcquireLock(cacheId)).then(function (_this$_cahceAndReques) {
+            var _result2, _result4;
+            result = _this$_cahceAndReques;
+            return (_result2 = result) != null && _result2.canStartDataRetrieval ? Promise.resolve(_this._provider.callExternalAPI(parametersValues, timeoutMS, cancelToken, attemptsCount, doNotFailForNowData)).then(function (data) {
+              var canPerformMerge = typeof _this._mergeCachedAndNewlyRetrievedData === "function";
+              if (canPerformMerge) {
+                var mostRecentCached = _this._cahceAndRequestsResolver.getCached(cacheId);
+                data = _this._mergeCachedAndNewlyRetrievedData(mostRecentCached, data, parametersValues);
+              }
+              if (data != null) {
+                var _result3;
+                _this._cahceAndRequestsResolver.saveCachedData(cacheId, (_result3 = result) == null ? void 0 : _result3.lockId, data, true, canPerformMerge);
+                _this._cahceIds.indexOf(cacheId) < 0 && _this._cahceIds.push(cacheId);
+              }
+              return data;
+            }) : (_result4 = result) == null ? void 0 : _result4.cachedData;
+          });
+        }, function (e) {
+          improveAndRethrow(e, loggerSource);
+        });
+      }, function (_wasThrown, _result) {
+        var _result5;
+        _this._cahceAndRequestsResolver.releaseLock(cacheId, (_result5 = result) == null ? void 0 : _result5.lockId);
+        if (_wasThrown) throw _result;
+        return _result;
+      }));
+    } catch (e) {
+      return Promise.reject(e);
+    }
+  };
+  _proto.invalidateCaches = function invalidateCaches() {
+    var _this2 = this;
+    this._cahceIds.forEach(function (key) {
+      return _this2._cahceAndRequestsResolver.invalidate(key);
+    });
+  };
+  _proto.actualizeCachedData = function actualizeCachedData(params, synchronousCurrentCacheProcessor, customHashFunctionForParams, sessionDependent, actualizedAtTimestamp) {
+    if (customHashFunctionForParams === void 0) {
+      customHashFunctionForParams = null;
+    }
+    if (sessionDependent === void 0) {
+      sessionDependent = true;
+    }
+    var cacheId = this._calculateCacheId(params, customHashFunctionForParams);
+    this._cahceAndRequestsResolver.actualizeCachedData(cacheId, synchronousCurrentCacheProcessor, sessionDependent);
+  };
+  _proto.markCacheAsExpiredButDontRemove = function markCacheAsExpiredButDontRemove(parametersValues, customHashFunctionForParams) {
+    try {
+      this._cahceAndRequestsResolver.markAsExpiredButDontRemove(this._calculateCacheId(parametersValues, customHashFunctionForParams));
+    } catch (e) {
+      improveAndRethrow(e, "markCacheAsExpiredButDontRemove");
+    }
+  };
+  _proto._calculateCacheId = function _calculateCacheId(parametersValues, customHashFunctionForParams) {
+    if (customHashFunctionForParams === void 0) {
+      customHashFunctionForParams = null;
+    }
+    try {
+      var hash = typeof customHashFunctionForParams === "function" ? customHashFunctionForParams(parametersValues) : !parametersValues ? "" : new Hashes.SHA512().hex(safeStringify(parametersValues));
+      return this._provider.bio + "-" + hash;
+    } catch (e) {
+      improveAndRethrow(e, this._provider.bio + "_calculateCacheId");
+    }
+  };
+  return CachedRobustExternalApiCallerService;
+}();
+
+/**
+ * Utils class needed to perform cancelling of axios request inside some process.
+ * Provides cancel state and axios token for HTTP requests
+ */
+var CancelProcessing = /*#__PURE__*/function () {
+  function CancelProcessing() {
+    this._cancelToken = axios.CancelToken.source();
+    this._isCanceled = false;
+  }
+  var _proto = CancelProcessing.prototype;
+  _proto.cancel = function cancel() {
+    this._isCanceled = true;
+    this._cancelToken.cancel();
+  };
+  _proto.isCanceled = function isCanceled() {
+    return this._isCanceled;
+  };
+  _proto.getToken = function getToken() {
+    return this._cancelToken.token;
+  };
+  CancelProcessing.instance = function instance() {
+    return new CancelProcessing();
+  };
+  return CancelProcessing;
+}();
+
+var ExternalApiProvider = /*#__PURE__*/function () {
+  /**
+   * Creates an instance of external api provider.
+   *
+   * If you need sub-request then use 'subRequestIndex' to check current request index in functions below.
+   * Also use array for 'httpMethod'.
+   *
+   * If the endpoint of dedicated provider has pagination then you should customize the behavior using
+   * "changeQueryParametersForPageNumber", "checkWhetherResponseIsForLastPage".
+   *
+   * We perform RPS counting all over the App to avoid blocking our clients due to abuses of the providers.
+   *
+   * @param endpoint {string} URL to the provider's endpoint. Note: you can customize it using composeQueryString
+   * @param [httpMethod] {string|string[]} one of "get", "post", "put", "patch", "delete" or an array of these values
+   *        for request having sub-requests
+   * @param [timeout] {number} number of milliseconds to wait for the response
+   * @param [apiGroup] {ApiGroup} singleton object containing parameters of API group. Helpful when you use the same
+   *        api for different providers to avoid hardcoding RPS inside each provider what can cause mistakes
+   * @param [specificHeaders] {Object} contains specific keys (headers) and values (their content) if needed for this provider
+   * @param [maxPageLength] {number} optional number of items per page if the request supports pagination
+   */
+  function ExternalApiProvider(endpoint, httpMethod, timeout, apiGroup, specificHeaders, maxPageLength) {
+    var _maxPageLength, _specificHeaders;
+    if (specificHeaders === void 0) {
+      specificHeaders = {};
+    }
+    if (maxPageLength === void 0) {
+      maxPageLength = Number.MAX_SAFE_INTEGER;
+    }
+    this.endpoint = endpoint;
+    this.httpMethod = httpMethod != null ? httpMethod : "get";
+    // TODO: [refactoring, critical] We have two timeouts for robust data retrieval - here and inside the service method call, need to remain the only
+    this.timeout = timeout != null ? timeout : 10000;
+    // TODO: [refactoring, critical] We need single place for all RPSes as we use them as hardcoded constants now inside different services
+    this.apiGroup = apiGroup;
+    this.maxPageLength = (_maxPageLength = maxPageLength) != null ? _maxPageLength : Number.MAX_SAFE_INTEGER;
+    this.niceFactor = 1;
+    this.specificHeaders = (_specificHeaders = specificHeaders) != null ? _specificHeaders : {};
+  }
+  var _proto = ExternalApiProvider.prototype;
+  _proto.getRps = function getRps() {
+    var _this$apiGroup$rps;
+    return (_this$apiGroup$rps = this.apiGroup.rps) != null ? _this$apiGroup$rps : 2;
+  };
+  _proto.isRpsExceeded = function isRpsExceeded() {
+    return this.apiGroup.isRpsExceeded();
+  };
+  _proto.actualizeLastCalledTimestamp = function actualizeLastCalledTimestamp() {
+    this.apiGroup.actualizeLastCalledTimestamp();
+  };
+  _proto.getApiGroupId = function getApiGroupId() {
+    return this.apiGroup.id;
+  }
+
+  /**
+   * Some endpoint can require several sub requests. Example is one request to get confirmed transactions
+   * and another request for unconfirmed transactions. You should override this method to return true for such requests.
+   *
+   * @return {boolean} true if this provider requires several requests to retrieve the data
+   */;
+  _proto.doesRequireSubRequests = function doesRequireSubRequests() {
+    return false;
+  }
+
+  /**
+   * Some endpoint support pagination. Override this method if so and implement corresponding methods.
+   *
+   * @return {boolean} true if this provider requires several requests to retrieve the data
+   */;
+  _proto.doesSupportPagination = function doesSupportPagination() {
+    return false;
+  }
+
+  /**
+   * Composes a query string to be added to the endpoint of this provider.
+   *
+   * @param params {any[]} params array passed to the RobustExternalAPICallerService
+   * @param [subRequestIndex] {number} optional number of the sub-request the call is performed for
+   * @returns {string} query string to be concatenated with endpoint
+   */;
+  _proto.composeQueryString = function composeQueryString(params, subRequestIndex) {
+    return "";
+  }
+
+  /**
+   * Composes a body to be added to the request
+   *
+   * @param params {any[]} params array passed to the RobustExternalAPICallerService
+   * @param [subRequestIndex] {number} optional number of the sub-request the call is performed for
+   * @returns {string}
+   */;
+  _proto.composeBody = function composeBody(params, subRequestIndex) {
+    return "";
+  }
+
+  /**
+   * Extracts data from the response and returns it
+   *
+   * @param response {Object} HTTP response returned by provider
+   * @param [params] {any[]} params array passed to the RobustExternalAPICallerService
+   * @param [subRequestIndex] {number} optional number of the sub-request the call is performed for
+   * @param iterationsData {any[]} array of data retrieved from previous sub-requests
+   * @returns {any}
+   */;
+  _proto.getDataByResponse = function getDataByResponse(response, params, subRequestIndex, iterationsData) {
+    return [];
+  }
+
+  /**
+   * Function changing the query string according to page number and previous response
+   * Only for endpoints supporting pagination
+   *
+   * @param params {any[]} params array passed to the RobustExternalAPICallerService
+   * @param previousResponse {Object} HTTP response returned by provider for previous call (previous page)
+   * @param pageNumber {number} new page number. We count from 0. You need to manually increment with 1 if your
+   *        provider counts pages starting with 1
+   * @param [subRequestIndex] {number} optional number of the sub-request the call is performed for
+   * @returns {any[]}
+   */;
+  _proto.changeQueryParametersForPageNumber = function changeQueryParametersForPageNumber(params, previousResponse, pageNumber, subRequestIndex) {
+    return params;
+  }
+
+  /**
+   * Function checking whether the response is for the last page to stop requesting for a next page.
+   * Only for endpoints supporting pagination.
+   *
+   * @param previousResponse {Object} HTTP response returned by provider for previous call (previous page)
+   * @param currentResponse {Object} HTTP response returned by provider for current call (current page, next after the previous)
+   * @param currentPageNumber {number} current page number (for current response)
+   * @param [subRequestIndex] {number} optional number of the sub-request the call is performed for
+   * @returns {boolean}
+   */;
+  _proto.checkWhetherResponseIsForLastPage = function checkWhetherResponseIsForLastPage(previousResponse, currentResponse, currentPageNumber, subRequestIndex) {
+    return true;
+  }
+
+  /**
+   * Resets the nice factor to default value
+   */;
+  _proto.resetNiceFactor = function resetNiceFactor() {
+    this.niceFactor = 1;
+  }
+
+  /**
+   * Internal method used for requests requiring sub-requests.
+   *
+   * @param iterationsData {any[]} iterations data retrieved from getDataByResponse called per sub-request.
+   * @return {any} by default flatten the passed iterations data array. Should be redefined if you need another logic.
+   */;
+  _proto.incorporateIterationsData = function incorporateIterationsData(iterationsData) {
+    return iterationsData.flat();
+  };
+  return ExternalApiProvider;
+}();
+
 var ExistingSwap =
 /**
  * @param swapId {string}
@@ -4580,5 +6604,5 @@ PublicSwapService.PUBLIC_SWAP_DETAILS_FAIL_REASONS = {
 };
 PublicSwapService._fiatDecimalsCount = FiatCurrenciesService.getCurrencyDecimalCountByCode("USD");
 
-export { AmountUtils, AssetIcon, BaseSwapCreationInfo, Blockchain, Button, Cache, Coin, EmailsApi, ExistingSwap, ExistingSwapWithFiatData, FiatCurrenciesService, LoadingDots, Logger, LogsStorage, Protocol, PublicSwapService, SupportChat, SwapProvider, SwapUtils, SwapspaceSwapProvider, improveAndRethrow, safeStringify, useCallHandlingErrors, useReferredState };
+export { AmountUtils, AssetIcon, AxiosAdapter, BaseSwapCreationInfo, Blockchain, Button, Cache, CacheAndConcurrentRequestsResolver, CachedRobustExternalApiCallerService, CancelProcessing, Coin, EmailsApi, ExistingSwap, ExistingSwapWithFiatData, ExternalApiProvider, FiatCurrenciesService, LoadingDots, Logger, LogsStorage, Protocol, PublicSwapService, RobustExternalAPICallerService, SupportChat, SwapProvider, SwapUtils, SwapspaceSwapProvider, getQueryParameterSingleValue, getQueryParameterValues, handleClickOutside, improveAndRethrow, logErrorOrOutputToConsole, postponeExecution, removeQueryParameterAndValues, safeStringify, saveQueryParameterAndValues, useCallHandlingErrors, useReferredState };
 //# sourceMappingURL=index.module.js.map