@amazon-sp-api-release/amazon-sp-api-sdk-js 1.0.0 → 1.1.0

package/src/shipping_v2/ApiClient.js

@@ -11,11 +11,11 @@
  *
  */
 
-import superagent from 'superagent';
-import querystring from 'querystring';
-import {URL} from 'node:url';
-import {RateLimitConfiguration} from '../../helper/RateLimitConfiguration.mjs';
-import {SuperagentRateLimiter} from '../../helper/SuperagentRateLimiter.mjs';
+import superagent from 'superagent'
+import querystring from 'querystring'
+import { URL } from 'node:url'
+import { RateLimitConfiguration } from '../../helper/RateLimitConfiguration.mjs'
+import { SuperagentRateLimiter } from '../../helper/SuperagentRateLimiter.mjs'
 
 /**
 * @module shipping_v2/ApiClient
@@ -27,85 +27,85 @@ import {SuperagentRateLimiter} from '../../helper/SuperagentRateLimiter.mjs';
 * @class
 */
 class LwaOAuthClient {
-    /**
+  /**
     * Private member to store LWA credential, refresh token or scope.
     * @type {Object<String, String>}
     */
-    #lwaClientInfo = {};
+  #lwaClientInfo = {}
 
-    /**
+  /**
     * Private member to cache access token that is retrieved by auto-retrieval.
     * @type {Map<String, {String, Number}> | null}
     */
-    #cachedTokenMap = null;
+  #cachedTokenMap = null
 
-    /**
+  /**
     * Constructs a new LwaOAuthClient.
     * @param {String} clientId LWA Client ID.
     * @param {String} clientSecret LWA Client Secret.
     * @param {String|null} refreshToken LWA Refresh token.
     * @param {String|null} scope LWA scope(s) for grantless operations.
     */
-    constructor(clientId, clientSecret, refreshToken = null, scope = null) {
-        this.#lwaClientInfo = {
-            clientId, clientSecret, refreshToken, scope
-        };
+  constructor (clientId, clientSecret, refreshToken = null, scope = null) {
+    this.#lwaClientInfo = {
+      clientId, clientSecret, refreshToken, scope
     }
+  }
 
-    /**
+  /**
      * Execute LWA refresh token flow to retrieve access token to be used for SP-API calls.
      * @returns {Promise<String>} LWA access token.
      */
-    retrieveAccessToken = async () => {
-        const key = JSON.stringify(this.#lwaClientInfo);
-
-        if (this.#cachedTokenMap) {
-            const cachedTokenItem = this.#cachedTokenMap.get(key);
-
-            if (cachedTokenItem) {
-                const cachedToken = cachedTokenItem.cachedToken;
-                const cachedTokenExpiration = cachedTokenItem.cachedTokenExpiration;
-                //Adjustment in milliseconds (60s) to avoid using nearly expired tokens
-                const adjustedExpiryTime = cachedTokenExpiration - 60000;
-                if (adjustedExpiryTime > Date.now()) {
-                    return Promise.resolve(cachedToken); 
-                } else {
-                    this.#cachedTokenMap.delete(key);
-                }
-            }
+  retrieveAccessToken = async () => {
+    const key = JSON.stringify(this.#lwaClientInfo)
+
+    if (this.#cachedTokenMap) {
+      const cachedTokenItem = this.#cachedTokenMap.get(key)
+
+      if (cachedTokenItem) {
+        const cachedToken = cachedTokenItem.cachedToken
+        const cachedTokenExpiration = cachedTokenItem.cachedTokenExpiration
+        // Adjustment in milliseconds (60s) to avoid using nearly expired tokens
+        const adjustedExpiryTime = cachedTokenExpiration - 60000
+        if (adjustedExpiryTime > Date.now()) {
+          return Promise.resolve(cachedToken)
+        } else {
+          this.#cachedTokenMap.delete(key)
         }
+      }
+    }
 
-        const res = await this.#doRefresh();
-        if (!this.#cachedTokenMap) {
-            this.#cachedTokenMap = new Map();
-        }
-        this.#cachedTokenMap.set(key, {cachedToken: res.access_token, cachedTokenExpiration: Date.now() + res.expires_in * 1000});
-        return res.access_token;
+    const res = await this.#doRefresh()
+    if (!this.#cachedTokenMap) {
+      this.#cachedTokenMap = new Map()
     }
+    this.#cachedTokenMap.set(key, { cachedToken: res.access_token, cachedTokenExpiration: Date.now() + res.expires_in * 1000 })
+    return res.access_token
+  }
 
-    /**
+  /**
      * Private method to execute LWA token refresh flow.
      * @returns {Promise<Object>} LWA token response.
      */
-    #doRefresh = async () => {
-        let requestBody = null;
-        if (this.#lwaClientInfo.scope) {
-            //grantless operations
-            requestBody = `grant_type=client_credentials&client_id=${this.#lwaClientInfo.clientId}&client_secret=${this.#lwaClientInfo.clientSecret}&scope=${this.#lwaClientInfo.scope}`;
-        } else {
-            requestBody = `grant_type=refresh_token&refresh_token=${this.#lwaClientInfo.refreshToken}&client_id=${this.#lwaClientInfo.clientId}&client_secret=${this.#lwaClientInfo.clientSecret}`;
-        }
-        const res = await superagent.post('https://api.amazon.com/auth/o2/token')
-            .send(requestBody)
-            .set("Content-Type", "application/x-www-form-urlencoded;charset=UTF-8");
-        return res.body;
+  #doRefresh = async () => {
+    let requestBody = null
+    if (this.#lwaClientInfo.scope) {
+      // grantless operations
+      requestBody = `grant_type=client_credentials&client_id=${this.#lwaClientInfo.clientId}&client_secret=${this.#lwaClientInfo.clientSecret}&scope=${this.#lwaClientInfo.scope}`
+    } else {
+      requestBody = `grant_type=refresh_token&refresh_token=${this.#lwaClientInfo.refreshToken}&client_id=${this.#lwaClientInfo.clientId}&client_secret=${this.#lwaClientInfo.clientSecret}`
     }
-
-    clearCachedTokenMap() {
-        if (this.#cachedTokenMap) {
-            this.#cachedTokenMap.clear();
-        }
+    const res = await superagent.post('https://api.amazon.com/auth/o2/token')
+      .send(requestBody)
+      .set('Content-Type', 'application/x-www-form-urlencoded;charset=UTF-8')
+    return res.body
+  }
+
+  clearCachedTokenMap () {
+    if (this.#cachedTokenMap) {
+      this.#cachedTokenMap.clear()
     }
+  }
 }
 
 /**
@@ -113,72 +113,72 @@ class LwaOAuthClient {
 * @class
 */
 class TokensApiClient {
-    /**
+  /**
     * Private member to execute LWA refresh token flow.
     * @type {Object<LwaOAuthClient>}
     */
-    #lwaClient = null;
+  #lwaClient = null
 
-    /**
+  /**
     * Private member to store 'dataElements' parameter for Tokens API call.
     * @type {Array<String>}
     */
-    #dataElements = null;
+  #dataElements = null
 
-    /**
+  /**
     * Constructs a new TokensApiClient.
     * @param {String} clientId LWA Client ID.
     * @param {String} clientSecret LWA Client Secret.
     * @param {String} refreshToken LWA Refresh token.
     * @param {Array<String>} dataElements Optional specifiers for PII data elements tp retrieve.
     */
-    constructor(clientId, clientSecret, refreshToken, dataElements) {
-        this.#lwaClient = new LwaOAuthClient(clientId, clientSecret, refreshToken, null);
-        if (dataElements && !Array.isArray(dataElements)) {
-            throw new Error(`dataElements parameter to TokensApiClient constructor must be array of string. Illegal parameter:${dataElements}`);
-        }
-        this.#dataElements = dataElements ? dataElements : null;
+  constructor (clientId, clientSecret, refreshToken, dataElements) {
+    this.#lwaClient = new LwaOAuthClient(clientId, clientSecret, refreshToken, null)
+    if (dataElements && !Array.isArray(dataElements)) {
+      throw new Error(`dataElements parameter to TokensApiClient constructor must be array of string. Illegal parameter:${dataElements}`)
     }
+    this.#dataElements = dataElements || null
+  }
 
-    /**
+  /**
      * Execute createRestrictedDataToken to retrieve RDT to be used for PII-handling SP-API calls.
      * @param {String} method method for SP-API request.
      * @param {String} url URL for SP-API call to be made.
      * @param {Array<String>} dataElements specify PII information to get from "buyerInfo", "shippingAddress" and "buyerTaxInformation".
      * @returns {Promise<String>} Restricted Data Token (RDT).
      */
-    retrieveRestrictedDataToken = async (method, url) => {
-        const accessToken = await this.#lwaClient.retrieveAccessToken();
-        const urlToRequest = new URL(url);
-        const res = await this.#doCreateRestrictedDataToken(accessToken, method, urlToRequest);
-        return res.restrictedDataToken;
-    }
-
-    /**
+  retrieveRestrictedDataToken = async (method, url) => {
+    const accessToken = await this.#lwaClient.retrieveAccessToken()
+    const urlToRequest = new URL(url)
+    const res = await this.#doCreateRestrictedDataToken(accessToken, method, urlToRequest)
+    return res.restrictedDataToken
+  }
+
+  /**
      * Private method to execute createRestrictedDataToken
      * @param {String} accessToken Access token to call RDT request.
      * @param {URL} url URL object for URL string manipulation.
      * @param {Array<String>} dataElements specify PII information to get from "buyerInfo", "shippingAddress" and "buyerTaxInformation".
      * @returns {Promise<Object>} createRestrictedDataToken response.
      */
-    #doCreateRestrictedDataToken = async (accessToken, method, url) => {
-        const tokenApiUrl = `${url.origin}/tokens/2021-03-01/restrictedDataToken`;
-        const pathToRequest = url.pathname;
-        const res = await superagent.post(tokenApiUrl)
-            .send(
-                {
-                    restrictedResources: [
-                        {
-                            method: method,
-                            path: pathToRequest,
-                            dataElements: this.#dataElements ? this.#dataElements : undefined,
-                        }
-                    ]
-                }
-            ).set("Content-Type", "application/json")
-            .set({"x-amz-access-token": accessToken});
-        return res.body;
-    }
+  #doCreateRestrictedDataToken = async (accessToken, method, url) => {
+    const tokenApiUrl = `${url.origin}/tokens/2021-03-01/restrictedDataToken`
+    const pathToRequest = url.pathname
+    const res = await superagent.post(tokenApiUrl)
+      .send(
+        {
+          restrictedResources: [
+            {
+              method,
+              path: pathToRequest,
+              dataElements: this.#dataElements ? this.#dataElements : undefined
+            }
+          ]
+        }
+      ).set('Content-Type', 'application/json')
+      .set({ 'x-amz-access-token': accessToken })
+    return res.body
+  }
 }
 
 /**
@@ -189,125 +189,125 @@ class TokensApiClient {
 * @class
 */
 export class ApiClient {
-    #tokenForApiCall = null;
-    #lwaClient = null;
-    #rdtClient = null;
-    #customizedRateLimiterMap = null;
-    #useRateLimiter = true;
+  #tokenForApiCall = null
+  #lwaClient = null
+  #rdtClient = null
+  #customizedRateLimiterMap = null
+  #useRateLimiter = true
 
-    /**
+  /**
     * Constructs a new ApiClient.
     * @param {String} baseUrl Base URL of endpoint ex. "https://sellingpartnerapi-na.amazon.com"
     */
-    constructor(baseUrl) {
-        /**
+  constructor (baseUrl) {
+    /**
          * The base URL against which to resolve every API call's (relative) path.
          * @type {String}
          * @default https://sellingpartnerapi-eu.amazon.com
          */
-        this.basePath = baseUrl ? baseUrl.replace(/\/+$/, '') : 'https://sellingpartnerapi-eu.amazon.com'.replace(/\/+$/, '');
+    this.basePath = baseUrl ? baseUrl.replace(/\/+$/, '') : 'https://sellingpartnerapi-eu.amazon.com'.replace(/\/+$/, '')
 
-        /**
+    /**
          * The authentication methods to be included for all API calls.
          * @type {Array<String>}
          */
-        this.authentications = {
-        }
+    this.authentications = {
+    }
 
-        /**
+    /**
          * The default HTTP headers to be included for all API calls.
          * @type {Array<String>}
          * @default {}
          */
-        this.defaultHeaders = {
-            'User-Agent': 'amazon-selling-partner-api-sdk/1.0.0/JavaScript'
-        };
+    this.defaultHeaders = {
+      'User-Agent': 'amazon-selling-partner-api-sdk/1.0.0/JavaScript'
+    }
 
-        /**
+    /**
          * The default HTTP timeout for all API calls.
          * @type {Number}
          * @default 60000
          */
-        this.timeout = 60000;
+    this.timeout = 60000
 
-        /**
+    /**
          * If set to false an additional timestamp parameter is added to all API GET calls to
          * prevent browser caching
          * @type {Boolean}
          * @default true
          */
-        this.cache = true;
+    this.cache = true
 
-        /**
+    /**
          * If set to true, the client will save the cookies from each server
          * response, and return them in the next request.
          * @default false
          */
-        this.enableCookies = false;
+    this.enableCookies = false
 
-        /*
+    /*
          * Used to save and return cookies in a node.js (non-browser) setting,
          * if this.enableCookies is set to true.
          */
-        if (typeof window === 'undefined') {
-          this.agent = new superagent.agent();
-        }
+    if (typeof window === 'undefined') {
+      this.agent = new superagent.agent()
+    }
 
-        /*
+    /*
          * Allow user to override superagent agent
          */
-         this.requestAgent = null;
+    this.requestAgent = null
 
-         /*
+    /*
          * Initialize customized rate limiter map
          */
-        this.#customizedRateLimiterMap = new Map();
-    }
+    this.#customizedRateLimiterMap = new Map()
+  }
 
-    /**
+  /**
     * Set customized rate limiter for one operation
     * For operations that customized rate limiter are not set
     * Will use default rate limiter
     * @param {String} operationName
     * @param {RateLimitConfiguration} config
     */
-    setCustomizedRateLimiterForOperation(operationName, config) {
-        this.#customizedRateLimiterMap.set(operationName, new SuperagentRateLimiter(config));
-    }
+  setCustomizedRateLimiterForOperation (operationName, config) {
+    this.#customizedRateLimiterMap.set(operationName, new SuperagentRateLimiter(config))
+  }
 
-    /**
+  /**
     * Disable customized rate limiter for one operation
     * Fall back to default rate limiter
     * @param {String} operationName
     */
-    disableCustomizedRatelimiterForOperation(operationName) {
-        this.#customizedRateLimiterMap.delete(operationName);
-    }
+  disableCustomizedRatelimiterForOperation (operationName) {
+    this.#customizedRateLimiterMap.delete(operationName)
+  }
 
-    /**
+  /**
     * Clear customized rate limiter for all operations
     * All operations will fall back to default rate limiter
     * @param {String} operationName
     */
-    disableCustomizedRatelimiterForAll() {
-        this.#customizedRateLimiterMap.clear();
-    }
+  disableCustomizedRatelimiterForAll () {
+    this.#customizedRateLimiterMap.clear()
+  }
 
-    /**
+  /**
     * Disable both default and customized rate limiter for all operations
     */
-    disableRateLimiter() {
-        this.#useRateLimiter = false;
-    }
+  disableRateLimiter () {
+    this.#useRateLimiter = false
+  }
 
-    /**
+  /**
     * Enable default or customized rate limiter for all operations
     */
-    enableRateLimiter() {
-        this.#useRateLimiter = true;
-    }
+  enableRateLimiter () {
+    this.#useRateLimiter = true
+  }
 
-    /**
+  /**
     * Returns this ApiClient so that you can chain the methods.
     * @param {String} clientId LWA client ID.
     * @param {String} clientSecret LWA client secret.
@@ -315,15 +315,15 @@ export class ApiClient {
     * @param {Array<String>} dataElementsOption specify PII information to get from "buyerInfo", "shippingAddress" and "buyerTaxInformation".
     * @returns {ApiClient} This ApiClient, which is going to use give accessToken for all API calls.
     */
-    enableAutoRetrievalRestrictedDataToken(clientId, clientSecret, refreshToken, dataElementsOption) {
-        if (!clientId || !clientSecret || !refreshToken) {
-            throw new Error('invalid parameter(s) to enableAutoRetrievalRestrictedDataToken.');
-        }
-        this.#rdtClient = new TokensApiClient(clientId, clientSecret, refreshToken, dataElementsOption);
-        return this;
+  enableAutoRetrievalRestrictedDataToken (clientId, clientSecret, refreshToken, dataElementsOption) {
+    if (!clientId || !clientSecret || !refreshToken) {
+      throw new Error('invalid parameter(s) to enableAutoRetrievalRestrictedDataToken.')
     }
+    this.#rdtClient = new TokensApiClient(clientId, clientSecret, refreshToken, dataElementsOption)
+    return this
+  }
 
-    /**
+  /**
     * Returns this ApiClient so that you can chain the methods.
     * @param {String} clientId LWA client ID.
     * @param {String} clientSecret LWA client secret.
@@ -331,88 +331,88 @@ export class ApiClient {
     * @param {String|null} scope LWA scope(s) for grantless operations.
     * @returns {ApiClient} This ApiClient, which is going to use give accessToken for all API calls.
     */
-    enableAutoRetrievalAccessToken(clientId, clientSecret, refreshToken = null, scope = null) {
-        if (!clientId || !clientSecret) {
-            throw new Error('invalid parameter(s) to enableAutoRetrievalAccessToken: clientId or clientSecret is null or undefined.');
-        } else if ((!refreshToken && !scope) || (refreshToken && scope)) {
-            throw new Error('invalid parameter(s) to enableAutoRetrievalAccessToken: either refreshToken or scope must be defined.');
-        }
-        this.#lwaClient = new LwaOAuthClient(clientId, clientSecret, refreshToken, scope);
-        return this;
+  enableAutoRetrievalAccessToken (clientId, clientSecret, refreshToken = null, scope = null) {
+    if (!clientId || !clientSecret) {
+      throw new Error('invalid parameter(s) to enableAutoRetrievalAccessToken: clientId or clientSecret is null or undefined.')
+    } else if ((!refreshToken && !scope) || (refreshToken && scope)) {
+      throw new Error('invalid parameter(s) to enableAutoRetrievalAccessToken: either refreshToken or scope must be defined.')
     }
+    this.#lwaClient = new LwaOAuthClient(clientId, clientSecret, refreshToken, scope)
+    return this
+  }
 
-    /**
+  /**
      * Clear Token Cache
      */
-    clearAccessTokenCache() {
-        if (this.#lwaClient) {
-            this.#lwaClient.clearCachedTokenMap();
-        }
+  clearAccessTokenCache () {
+    if (this.#lwaClient) {
+      this.#lwaClient.clearCachedTokenMap()
     }
+  }
 
-    /**
+  /**
     * Returns this ApiClient so that you can chain the methods.
     * @param {String} restrictedDataToken RDT token to use for SP-API call.
     * @returns {ApiClient} This ApiClient, which is going to use give RDT for all API calls.
     */
-    applyRestrictedDataToken(restrictedDataToken) {
-        this.#tokenForApiCall = restrictedDataToken;
-        return this;
-    }
+  applyRestrictedDataToken (restrictedDataToken) {
+    this.#tokenForApiCall = restrictedDataToken
+    return this
+  }
 
-    /**
+  /**
     * Applies authentication headers to the request.
     * @param {String} accessOrRdtToken Either Access Token or Restricted Data Token to add as 'x-amz-access-token'.
     * @returns {ApiClient} This ApiClient, which is going to use give RDT for all API calls.
     */
-    applyXAmzAccessTokenToRequest(accessOrRdtToken) {
-        if (!accessOrRdtToken) {
-            throw new Error('empty string, null or undefined passed to applyXAmzAccessTokenToRequest');
-        }
-        this.#tokenForApiCall = accessOrRdtToken;
-        return this;
-    }    
+  applyXAmzAccessTokenToRequest (accessOrRdtToken) {
+    if (!accessOrRdtToken) {
+      throw new Error('empty string, null or undefined passed to applyXAmzAccessTokenToRequest')
+    }
+    this.#tokenForApiCall = accessOrRdtToken
+    return this
+  }
 
-    /**
+  /**
     * Returns a string representation for an actual parameter.
     * @param param The actual parameter.
     * @returns {String} The string representation of <code>param</code>.
     */
-    paramToString(param) {
-        if (param == undefined || param == null) {
-            return '';
-        }
-        if (param instanceof Date) {
-            return param.toJSON();
-        }
-        return param.toString();
+  paramToString (param) {
+    if (param == undefined || param == null) {
+      return ''
+    }
+    if (param instanceof Date) {
+      return param.toJSON()
     }
+    return param.toString()
+  }
 
-    /**
+  /**
     * Builds full URL by appending the given path to the base URL and replacing path parameter place-holders with parameter values.
     * NOTE: query parameters are not handled here.
     * @param {String} path The path to append to the base URL.
     * @param {Object} pathParams The parameter values to append.
     * @returns {String} The encoded path with parameter values substituted.
     */
-    buildUrl(path, pathParams) {
-        if (!path.match(/^\//)) {
-            path = '/' + path;
-        }
-        var url = this.basePath + path;
-        url = url.replace(/\{([\w-]+)\}/g, (fullMatch, key) => {
-            var value;
-            if (pathParams.hasOwnProperty(key)) {
-                value = this.paramToString(pathParams[key]);
-            } else {
-                value = fullMatch;
-            }
-            return encodeURIComponent(value);
-        });
-        return url;
+  buildUrl (path, pathParams) {
+    if (!path.match(/^\//)) {
+      path = '/' + path
     }
-
-    /**
+    let url = this.basePath + path
+    url = url.replace(/\{([\w-]+)\}/g, (fullMatch, key) => {
+      let value
+      if (pathParams.hasOwnProperty(key)) {
+        value = this.paramToString(pathParams[key])
+      } else {
+        value = fullMatch
+      }
+      return encodeURIComponent(value)
+    })
+    return url
+  }
+
+  /**
     * Checks whether the given content type represents JSON.<br>
     * JSON content type examples:<br>
     * <ul>
@@ -423,60 +423,60 @@ export class ApiClient {
     * @param {String} contentType The MIME content type to check.
     * @returns {Boolean} <code>true</code> if <code>contentType</code> represents JSON, otherwise <code>false</code>.
     */
-    isJsonMime(contentType) {
-        return Boolean(contentType != null && contentType.match(/^application\/json(;.*)?$/i));
-    }
+  isJsonMime (contentType) {
+    return Boolean(contentType != null && contentType.match(/^application\/json(;.*)?$/i))
+  }
 
-    /**
+  /**
     * Chooses a content type from the given array, with JSON preferred; i.e. return JSON if included, otherwise return the first.
     * @param {Array<String>} contentTypes
     * @returns {String} The chosen content type, preferring JSON.
     */
-    jsonPreferredMime(contentTypes) {
-        for (var i = 0; i < contentTypes.length; i++) {
-            if (this.isJsonMime(contentTypes[i])) {
-                return contentTypes[i];
-            }
-        }
-        return contentTypes[0];
+  jsonPreferredMime (contentTypes) {
+    for (let i = 0; i < contentTypes.length; i++) {
+      if (this.isJsonMime(contentTypes[i])) {
+        return contentTypes[i]
+      }
     }
+    return contentTypes[0]
+  }
 
-    /**
+  /**
     * Checks whether the given parameter value represents file-like content.
     * @param param The parameter to check.
     * @returns {Boolean} <code>true</code> if <code>param</code> represents a file.
     */
-    isFileParam(param) {
-        // fs.ReadStream in Node.js and Electron (but not in runtime like browserify)
-        if (typeof require === 'function') {
-            let fs;
-            try {
-                fs = require('fs');
-            } catch (err) {}
-            if (fs && fs.ReadStream && param instanceof fs.ReadStream) {
-                return true;
-            }
-        }
-
-        // Buffer in Node.js
-        if (typeof Buffer === 'function' && param instanceof Buffer) {
-            return true;
-        }
+  isFileParam (param) {
+    // fs.ReadStream in Node.js and Electron (but not in runtime like browserify)
+    if (typeof require === 'function') {
+      let fs
+      try {
+        fs = require('fs')
+      } catch (err) {}
+      if (fs && fs.ReadStream && param instanceof fs.ReadStream) {
+        return true
+      }
+    }
 
-        // Blob in browser
-        if (typeof Blob === 'function' && param instanceof Blob) {
-            return true;
-        }
+    // Buffer in Node.js
+    if (typeof Buffer === 'function' && param instanceof Buffer) {
+      return true
+    }
 
-        // File in browser (it seems File object is also instance of Blob, but keep this for safe)
-        if (typeof File === 'function' && param instanceof File) {
-            return true;
-        }
+    // Blob in browser
+    if (typeof Blob === 'function' && param instanceof Blob) {
+      return true
+    }
 
-        return false;
+    // File in browser (it seems File object is also instance of Blob, but keep this for safe)
+    if (typeof File === 'function' && param instanceof File) {
+      return true
     }
 
-    /**
+    return false
+  }
+
+  /**
     * Normalizes parameter values:
     * <ul>
     * <li>remove nils</li>
@@ -486,87 +486,87 @@ export class ApiClient {
     * @param {Object<String, Object>} params The parameters as object properties.
     * @returns {Object<String, Object>} normalized parameters.
     */
-    normalizeParams(params) {
-        var newParams = {};
-        for (var key in params) {
-            if (params.hasOwnProperty(key) && params[key] != undefined && params[key] != null) {
-                var value = params[key];
-                if (this.isFileParam(value) || Array.isArray(value)) {
-                    newParams[key] = value;
-                } else {
-                    newParams[key] = this.paramToString(value);
-                }
-            }
+  normalizeParams (params) {
+    const newParams = {}
+    for (const key in params) {
+      if (params.hasOwnProperty(key) && params[key] != undefined && params[key] != null) {
+        const value = params[key]
+        if (this.isFileParam(value) || Array.isArray(value)) {
+          newParams[key] = value
+        } else {
+          newParams[key] = this.paramToString(value)
         }
-        return newParams;
+      }
     }
+    return newParams
+  }
 
-    /**
+  /**
     * Enumeration of collection format separator strategies.
     * @enum {String}
     * @readonly
     */
-    static CollectionFormatEnum = {
-        /**
+  static CollectionFormatEnum = {
+    /**
          * Comma-separated values. Value: <code>csv</code>
          * @const
          */
-        CSV: ',',
+    CSV: ',',
 
-        /**
+    /**
          * Space-separated values. Value: <code>ssv</code>
          * @const
          */
-        SSV: ' ',
+    SSV: ' ',
 
-        /**
+    /**
          * Tab-separated values. Value: <code>tsv</code>
          * @const
          */
-        TSV: '\t',
+    TSV: '\t',
 
-        /**
+    /**
          * Pipe(|)-separated values. Value: <code>pipes</code>
          * @const
          */
-        PIPES: '|',
+    PIPES: '|',
 
-        /**
+    /**
          * Native array. Value: <code>multi</code>
          * @const
          */
-        MULTI: 'multi'
-    };
+    MULTI: 'multi'
+  }
 
-    /**
+  /**
     * Builds a string representation of an array-type actual parameter, according to the given collection format.
     * @param {Array} param An array parameter.
     * @param {module:shipping_v2/ApiClient.CollectionFormatEnum} collectionFormat The array element separator strategy.
     * @returns {String|Array} A string representation of the supplied collection, using the specified delimiter. Returns
     * <code>param</code> as is if <code>collectionFormat</code> is <code>multi</code>.
     */
-    buildCollectionParam(param, collectionFormat) {
-        if (param == null) {
-            return null;
-        }
-        switch (collectionFormat) {
-            case 'csv':
-                return param.map(this.paramToString).join(',');
-            case 'ssv':
-                return param.map(this.paramToString).join(' ');
-            case 'tsv':
-                return param.map(this.paramToString).join('\t');
-            case 'pipes':
-                return param.map(this.paramToString).join('|');
-            case 'multi':
-                //return the array directly as SuperAgent will handle it as expected
-                return param.map(this.paramToString);
-            default:
-                throw new Error('Unknown collection format: ' + collectionFormat);
-        }
+  buildCollectionParam (param, collectionFormat) {
+    if (param == null) {
+      return null
+    }
+    switch (collectionFormat) {
+      case 'csv':
+        return param.map(this.paramToString).join(',')
+      case 'ssv':
+        return param.map(this.paramToString).join(' ')
+      case 'tsv':
+        return param.map(this.paramToString).join('\t')
+      case 'pipes':
+        return param.map(this.paramToString).join('|')
+      case 'multi':
+        // return the array directly as SuperAgent will handle it as expected
+        return param.map(this.paramToString)
+      default:
+        throw new Error('Unknown collection format: ' + collectionFormat)
     }
+  }
 
-    /**
+  /**
     * Deserializes an HTTP response body into a value of the specified type.
     * @param {Object} response A SuperAgent response object.
     * @param {(String|Array<String>|Object<String, Object>|Function)} returnType The type to return. Pass a string for simple types
@@ -575,25 +575,23 @@ export class ApiClient {
     * all properties on <code>data<code> will be converted to this type.
     * @returns A value of the specified type.
     */
-    deserialize(response, returnType) {
-        if (response == null || returnType == null || response.status == 204) {
-            return null;
-        }
-
-        // Rely on SuperAgent for parsing response body.
-        // See http://visionmedia.github.io/superagent/#parsing-response-bodies
-        var data = response.body;
-        if (data == null || (typeof data === 'object' && typeof data.length === 'undefined' && !Object.keys(data).length)) {
-            // SuperAgent does not always produce a body; use the unparsed response as a fallback
-            data = response.text;
-        }
+  deserialize (response, returnType) {
+    if (response == null || returnType == null || response.status == 204) {
+      return null
+    }
 
-        return ApiClient.convertToType(data, returnType);
+    // Rely on SuperAgent for parsing response body.
+    // See http://visionmedia.github.io/superagent/#parsing-response-bodies
+    let data = response.body
+    if (data == null || (typeof data === 'object' && typeof data.length === 'undefined' && !Object.keys(data).length)) {
+      // SuperAgent does not always produce a body; use the unparsed response as a fallback
+      data = response.text
     }
 
-    
+    return ApiClient.convertToType(data, returnType)
+  }
 
-    /**
+  /**
     * Invokes the REST service using the supplied settings and parameters.
     * @param {String} operation operation name.
     * @param {String} path The base URL to invoke.
@@ -607,139 +605,135 @@ export class ApiClient {
     * @param {Array<String>} accepts An array of acceptable response MIME types.
     * @param {(String|Array|ObjectFunction)} returnType The required type to return; can be a string for simple types or the
     * constructor for a complex type.
-    * @param {SuperagentRateLimiter} defaultRateLimiter The default rate limiter. 
+    * @param {SuperagentRateLimiter} defaultRateLimiter The default rate limiter.
     * @returns {Promise} A {@link https://www.promisejs.org/|Promise} object.
     */
-    async callApi(operation, path, httpMethod, pathParams,
-        queryParams, headerParams, formParams, bodyParam, contentTypes, accepts,
-        returnType, defaultRateLimiter) {
-
-        var url = this.buildUrl(path, pathParams);
-        var request = superagent(httpMethod, url);
-        if (!this.#tokenForApiCall && !this.#lwaClient && !this.#rdtClient) {
-            throw new Error('none of accessToken, RDT token and auto-retrieval is set.');
-        }
+  async callApi (operation, path, httpMethod, pathParams,
+    queryParams, headerParams, formParams, bodyParam, contentTypes, accepts,
+    returnType, defaultRateLimiter) {
+    const url = this.buildUrl(path, pathParams)
+    const request = superagent(httpMethod, url)
+    if (!this.#tokenForApiCall && !this.#lwaClient && !this.#rdtClient) {
+      throw new Error('none of accessToken, RDT token and auto-retrieval is set.')
+    }
 
-        if (this.#useRateLimiter) {
-            //Set rate limiter
-            if (this.#customizedRateLimiterMap.get(operation)) {
-                request.use(this.#customizedRateLimiterMap.get(operation).getPlugin());
-            } else if (defaultRateLimiter) {
-                request.use(defaultRateLimiter.getPlugin());
-            }
-        }
+    if (this.#useRateLimiter) {
+      // Set rate limiter
+      if (this.#customizedRateLimiterMap.get(operation)) {
+        request.use(this.#customizedRateLimiterMap.get(operation).getPlugin())
+      } else if (defaultRateLimiter) {
+        request.use(defaultRateLimiter.getPlugin())
+      }
+    }
 
-        // set query parameters
-        if (httpMethod.toUpperCase() === 'GET' && this.cache === false) {
-            queryParams['_'] = new Date().getTime();
-        }
+    // set query parameters
+    if (httpMethod.toUpperCase() === 'GET' && this.cache === false) {
+      queryParams._ = new Date().getTime()
+    }
 
-        request.query(this.normalizeParams(queryParams));
-
-        // set header parameters
-        request.set(this.defaultHeaders).set(this.normalizeParams(headerParams));
-
-        // set x-amz-access-token header
-        if (this.#tokenForApiCall) {
-            // add custom header for SP-API call.
-            request.set({"x-amz-access-token": this.#tokenForApiCall});
-        } else if (this.#rdtClient) {
-            const rdt = await this.#rdtClient.retrieveRestrictedDataToken(httpMethod, url);
-            request.set({"x-amz-access-token": rdt});
-        } else if (this.#lwaClient) {
-            // execute token refresh.
-            const accessToken = await this.#lwaClient.retrieveAccessToken();
-            request.set({"x-amz-access-token": accessToken});
-        }
+    request.query(this.normalizeParams(queryParams))
+
+    // set header parameters
+    request.set(this.defaultHeaders).set(this.normalizeParams(headerParams))
+
+    // set x-amz-access-token header
+    if (this.#tokenForApiCall) {
+      // add custom header for SP-API call.
+      request.set({ 'x-amz-access-token': this.#tokenForApiCall })
+    } else if (this.#rdtClient) {
+      const rdt = await this.#rdtClient.retrieveRestrictedDataToken(httpMethod, url)
+      request.set({ 'x-amz-access-token': rdt })
+    } else if (this.#lwaClient) {
+      // execute token refresh.
+      const accessToken = await this.#lwaClient.retrieveAccessToken()
+      request.set({ 'x-amz-access-token': accessToken })
+    }
 
-        // set requestAgent if it is set by user
-        if (this.requestAgent) {
-          request.agent(this.requestAgent);
-        }
+    // set requestAgent if it is set by user
+    if (this.requestAgent) {
+      request.agent(this.requestAgent)
+    }
 
-        // set request timeout
-        request.timeout(this.timeout);
+    // set request timeout
+    request.timeout(this.timeout)
+
+    const contentType = this.jsonPreferredMime(contentTypes)
+    if (contentType) {
+      // Issue with superagent and multipart/form-data (https://github.com/visionmedia/superagent/issues/746)
+      if (contentType != 'multipart/form-data') {
+        request.type(contentType)
+      }
+    } else if (!request.header['Content-Type']) {
+      request.type('application/json')
+    }
 
-        var contentType = this.jsonPreferredMime(contentTypes);
-        if (contentType) {
-            // Issue with superagent and multipart/form-data (https://github.com/visionmedia/superagent/issues/746)
-            if(contentType != 'multipart/form-data') {
-                request.type(contentType);
-            }
-        } else if (!request.header['Content-Type']) {
-            request.type('application/json');
-        }
+    if (contentType === 'application/x-www-form-urlencoded') {
+      request.send(querystring.stringify(this.normalizeParams(formParams)))
+    } else if (contentType == 'multipart/form-data') {
+      const _formParams = this.normalizeParams(formParams)
+      for (const key in _formParams) {
+        if (_formParams.hasOwnProperty(key)) {
+          if (this.isFileParam(_formParams[key])) {
+            // file field
+            request.attach(key, _formParams[key])
+          } else {
+            request.field(key, _formParams[key])
+          }
+        }
+      }
+    } else if (bodyParam) {
+      request.send(bodyParam)
+    }
 
-        if (contentType === 'application/x-www-form-urlencoded') {
-            request.send(querystring.stringify(this.normalizeParams(formParams)));
-        } else if (contentType == 'multipart/form-data') {
-            var _formParams = this.normalizeParams(formParams);
-            for (var key in _formParams) {
-                if (_formParams.hasOwnProperty(key)) {
-                    if (this.isFileParam(_formParams[key])) {
-                        // file field
-                        request.attach(key, _formParams[key]);
-                    } else {
-                        request.field(key, _formParams[key]);
-                    }
-                }
-            }
-        } else if (bodyParam) {
-            request.send(bodyParam);
-        }
+    const accept = this.jsonPreferredMime(accepts)
+    if (accept) {
+      request.accept(accept)
+    }
 
-        var accept = this.jsonPreferredMime(accepts);
-        if (accept) {
-            request.accept(accept);
-        }
+    if (returnType === 'Blob') {
+      request.responseType('blob')
+    } else if (returnType === 'String') {
+      request.responseType('string')
+    }
 
-        if (returnType === 'Blob') {
-          request.responseType('blob');
-        } else if (returnType === 'String') {
-          request.responseType('string');
-        }
+    // Attach previously saved cookies, if enabled
+    if (this.enableCookies) {
+      if (typeof window === 'undefined') {
+        this.agent.attachCookies(request)
+      } else {
+        request.withCredentials()
+      }
+    }
 
-        // Attach previously saved cookies, if enabled
-        if (this.enableCookies){
-            if (typeof window === 'undefined') {
-                this.agent.attachCookies(request);
-            }
-            else {
-                request.withCredentials();
+    return new Promise((resolve, reject) => {
+      request.end((error, response) => {
+        if (error) {
+          reject(error)
+        } else {
+          try {
+            const data = this.deserialize(response, returnType)
+            if (this.enableCookies && typeof window === 'undefined') {
+              this.agent.saveCookies(response)
             }
+            resolve({ data, response })
+          } catch (err) {
+            reject(err)
+          }
         }
+      })
+    })
+  }
 
-        return new Promise((resolve, reject) => {
-            request.end((error, response) => {
-                if (error) {
-                    reject(error);
-                } else {
-                    try {
-                        var data = this.deserialize(response, returnType);
-                        if (this.enableCookies && typeof window === 'undefined'){
-                            this.agent.saveCookies(response);
-                        }
-                        resolve({data, response});
-                    } catch (err) {
-                        reject(err);
-                    }
-                }
-            });
-        });
-
-        
-    }
-
-    /**
+  /**
     * Parses an ISO-8601 string representation of a date value.
     * @param {String} str The date value as a string.
     * @returns {Date} The parsed date object.
     */
-    static parseDate(str) {
-        return new Date(str);
-    }
+  static parseDate (str) {
+    return new Date(str)
+  }
 
-    /**
+  /**
     * Converts a value to the specified type.
     * @param {(String|Object)} data The data to convert, as a string or object.
     * @param {(String|Array<String>|Object<String, Object>|Function)} type The type to return. Pass a string for simple types
@@ -748,85 +742,82 @@ export class ApiClient {
     * all properties on <code>data<code> will be converted to this type.
     * @returns An instance of the specified type or null or undefined if data is null or undefined.
     */
-    static convertToType(data, type) {
-        if (data === null || data === undefined)
-            return data
-
-        switch (type) {
-            case 'Boolean':
-                return Boolean(data);
-            case 'Integer':
-                return parseInt(data, 10);
-            case 'Number':
-                return parseFloat(data);
-            case 'String':
-                return String(data);
-            case 'Date':
-                return ApiClient.parseDate(String(data));
-            case 'Blob':
-                return data;
-            default:
-                if (type === Object) {
-                    // generic object, return directly
-                    return data;
-                } else if (typeof type === 'function') {
-                    // for model type like: User
-                    return type.constructFromObject(data);
-                } else if (Array.isArray(type)) {
-                    // for array type like: ['String']
-                    var itemType = type[0];
-                    return data.map((item) => {
-                        return ApiClient.convertToType(item, itemType);
-                    });
-                } else if (typeof type === 'object') {
-                    // for plain object type like: {'String': 'Integer'}
-                    var keyType, valueType;
-                    for (var k in type) {
-                        if (type.hasOwnProperty(k)) {
-                            keyType = k;
-                            valueType = type[k];
-                            break;
-                        }
-                    }
-
-                    var result = {};
-                    for (var k in data) {
-                        if (data.hasOwnProperty(k)) {
-                            var key = ApiClient.convertToType(k, keyType);
-                            var value = ApiClient.convertToType(data[k], valueType);
-                            result[key] = value;
-                        }
-                    }
-
-                    return result;
-                } else {
-                    // for unknown type, return the data directly
-                    return data;
-                }
+  static convertToType (data, type) {
+    if (data === null || data === undefined) { return data }
+
+    switch (type) {
+      case 'Boolean':
+        return Boolean(data)
+      case 'Integer':
+        return parseInt(data, 10)
+      case 'Number':
+        return parseFloat(data)
+      case 'String':
+        return String(data)
+      case 'Date':
+        return ApiClient.parseDate(String(data))
+      case 'Blob':
+        return data
+      default:
+        if (type === Object) {
+          // generic object, return directly
+          return data
+        } else if (typeof type === 'function') {
+          // for model type like: User
+          return type.constructFromObject(data)
+        } else if (Array.isArray(type)) {
+          // for array type like: ['String']
+          const itemType = type[0]
+          return data.map((item) => {
+            return ApiClient.convertToType(item, itemType)
+          })
+        } else if (typeof type === 'object') {
+          // for plain object type like: {'String': 'Integer'}
+          let keyType, valueType
+          for (var k in type) {
+            if (type.hasOwnProperty(k)) {
+              keyType = k
+              valueType = type[k]
+              break
+            }
+          }
+
+          const result = {}
+          for (var k in data) {
+            if (data.hasOwnProperty(k)) {
+              const key = ApiClient.convertToType(k, keyType)
+              const value = ApiClient.convertToType(data[k], valueType)
+              result[key] = value
+            }
+          }
+
+          return result
+        } else {
+          // for unknown type, return the data directly
+          return data
         }
     }
+  }
 
-    /**
+  /**
     * Constructs a new map or array model from REST data.
     * @param data {Object|Array} The REST data.
     * @param obj {Object|Array} The target object or array.
     */
-    static constructFromObject(data, obj, itemType) {
-        if (Array.isArray(data)) {
-            for (var i = 0; i < data.length; i++) {
-                if (data.hasOwnProperty(i))
-                    obj[i] = ApiClient.convertToType(data[i], itemType);
-            }
-        } else {
-            for (var k in data) {
-                if (data.hasOwnProperty(k))
-                    obj[k] = ApiClient.convertToType(data[k], itemType);
-            }
-        }
+  static constructFromObject (data, obj, itemType) {
+    if (Array.isArray(data)) {
+      for (let i = 0; i < data.length; i++) {
+        if (data.hasOwnProperty(i)) { obj[i] = ApiClient.convertToType(data[i], itemType) }
+      }
+    } else {
+      for (const k in data) {
+        if (data.hasOwnProperty(k)) { obj[k] = ApiClient.convertToType(data[k], itemType) }
+      }
     }
+  }
 }
 /**
 * The default API client implementation.
 * @type {module:shipping_v2/ApiClient}
 */
-ApiClient.instance = new ApiClient();
+ApiClient.instance = new ApiClient()