@shipengine/js-api 2.4.0 → 2.5.1

package/account-settings/api.d.ts

@@ -1,5 +1,5 @@
 import { AxiosInstance } from "axios";
-import { AccountImage, AccountImageResponse, AccountImagesResponse, AccountSettings, UpdateAccountImage } from "./types";
+import { AccountImage, AccountImageResponse, AccountImagesResponse, ShipEngineAccountSettings, UpdateAccountImage } from "./types";
 /**
  * # Account Settings API module - /v1/account/settings
  */
@@ -9,13 +9,13 @@ export declare class AccountSettingsAPI {
     /**
      * The `get` method retrieves the account settings for a given user.
      */
-    get: () => Promise<import("axios").AxiosResponse<AccountSettings, any>>;
+    get: () => Promise<import("axios").AxiosResponse<ShipEngineAccountSettings, any>>;
     /**
      * The `update` method updates specific account settings for a given user.
      *
-     * @params Partial<AccountSettings> The account settings to update.
+     * @params Partial<ShipEngineAccountSettings> The account settings to update.
      */
-    update: (settings: Partial<AccountSettings>) => Promise<import("axios").AxiosResponse<AccountSettings, any>>;
+    update: (settings: Partial<ShipEngineAccountSettings>) => Promise<import("axios").AxiosResponse<ShipEngineAccountSettings, any>>;
     /**
      * The `createImage` method creates an image that can be used in your printed labels.
      */

package/account-settings/types.d.ts

@@ -2,7 +2,7 @@ import { DimensionUnit } from "../dimensions";
 import { LabelLayout } from "../labels";
 import { PageableResult } from "../resources";
 import { WeightUnit } from "../weight";
-export interface AccountSettings {
+export interface ShipEngineAccountSettings {
     defaultLabelLayout: LabelLayout;
     dimensionsUnit: DimensionUnit;
     taxIdentifier?: string;

package/client.d.ts

@@ -72,12 +72,23 @@ export interface ShipEngineAPIConfig {
  */
 export declare class ShipEngineAPI {
     private client;
-    private sandboxToken?;
+    private getSandboxToken?;
+    sandboxToken?: string;
     constructor(token: string, { baseURL, headers, getToken, getSandboxToken, onApiError }: ShipEngineAPIConfig);
     /**
      * The `token` method takes in a string and sets it as the Authorization header for all requests.
      */
     set token(token: string);
+    get token(): string;
+    /**
+     * The `getTenant` method get the current token (based on `isSandbox` prop) and will get the Tenant ID from
+     * that token (also known as Seller ID)
+     */
+    getTenant(isSandbox?: boolean): Promise<string | null>;
+    /**
+     * The `getTenantFromToken` method receives a token and returns the Tenant ID associated with it.
+     */
+    private getTenantFromToken;
     /**
      * The `accountSettings` method provides access to the Account Settings endpoints
      * in ShipEngine API.

package/index.js

@@ -180,7 +180,7 @@ class AccountSettingsAPI {
     /**
      * The `update` method updates specific account settings for a given user.
      *
-     * @params Partial<AccountSettings> The account settings to update.
+     * @params Partial<ShipEngineAccountSettings> The account settings to update.
      */
     this.update = (settings) => {
       return this.client.put("/v1/account/settings", settings);
@@ -975,7 +975,7 @@ var ipaddr = {
 	}).call(commonjsGlobal);
 } (ipaddr));
 
-var __async$5 = (__this, __arguments, generator) => {
+var __async$6 = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
     var fulfilled = (value) => {
       try {
@@ -995,7 +995,7 @@ var __async$5 = (__this, __arguments, generator) => {
     step((generator = generator.apply(__this, __arguments)).next());
   });
 };
-const getEndUserIpAddress = () => __async$5(void 0, null, function* () {
+const getEndUserIpAddress = () => __async$6(void 0, null, function* () {
   try {
     const response = yield axios.get("https://api.ipify.org/?format=json");
     if (response.data.ip && ipaddrExports.isValid(response.data.ip)) {
@@ -1038,7 +1038,7 @@ var __objRest = (source, exclude) => {
     }
   return target;
 };
-var __async$4 = (__this, __arguments, generator) => {
+var __async$5 = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
     var fulfilled = (value) => {
       try {
@@ -1078,7 +1078,7 @@ class CarriersAPI {
     /**
      * The `connect` method connects a carrier account to a user's ShipEngine account.
      */
-    this.connect = (_a) => __async$4(this, null, function* () {
+    this.connect = (_a) => __async$5(this, null, function* () {
       var _b = _a, { carrierCode } = _b, connection = __objRest(_b, ["carrierCode"]);
       const endUserIpAddress = yield getEndUserIpAddress();
       if (!endUserIpAddress)
@@ -1169,7 +1169,7 @@ class CarriersAPI {
   }
 }
 
-var __async$3 = (__this, __arguments, generator) => {
+var __async$4 = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
     var fulfilled = (value) => {
       try {
@@ -1211,7 +1211,7 @@ class ConnectionsAPI {
     /**
      * The `connectCarrier` method connects a carrier to account.
      */
-    this.connectCarrier = (carrierName, formData) => __async$3(this, null, function* () {
+    this.connectCarrier = (carrierName, formData) => __async$4(this, null, function* () {
       return yield this.client.post(
         `/v1/connections/carriers/${carrierName}`,
         formData,
@@ -1397,6 +1397,64 @@ var humps = {
 	})(commonjsGlobal);
 } (humps));
 
+class InvalidTokenError extends Error {
+}
+InvalidTokenError.prototype.name = "InvalidTokenError";
+function b64DecodeUnicode(str) {
+    return decodeURIComponent(atob(str).replace(/(.)/g, (m, p) => {
+        let code = p.charCodeAt(0).toString(16).toUpperCase();
+        if (code.length < 2) {
+            code = "0" + code;
+        }
+        return "%" + code;
+    }));
+}
+function base64UrlDecode(str) {
+    let output = str.replace(/-/g, "+").replace(/_/g, "/");
+    switch (output.length % 4) {
+        case 0:
+            break;
+        case 2:
+            output += "==";
+            break;
+        case 3:
+            output += "=";
+            break;
+        default:
+            throw new Error("base64 string is not of the correct length");
+    }
+    try {
+        return b64DecodeUnicode(output);
+    }
+    catch (err) {
+        return atob(output);
+    }
+}
+function jwtDecode(token, options) {
+    if (typeof token !== "string") {
+        throw new InvalidTokenError("Invalid token specified: must be a string");
+    }
+    options || (options = {});
+    const pos = options.header === true ? 0 : 1;
+    const part = token.split(".")[pos];
+    if (typeof part !== "string") {
+        throw new InvalidTokenError(`Invalid token specified: missing part #${pos + 1}`);
+    }
+    let decoded;
+    try {
+        decoded = base64UrlDecode(part);
+    }
+    catch (e) {
+        throw new InvalidTokenError(`Invalid token specified: invalid base64 for part #${pos + 1} (${e.message})`);
+    }
+    try {
+        return JSON.parse(decoded);
+    }
+    catch (e) {
+        throw new InvalidTokenError(`Invalid token specified: invalid json for part #${pos + 1} (${e.message})`);
+    }
+}
+
 /* eslint complexity: [2, 18], max-statements: [2, 33] */
 var shams = function hasSymbols() {
 	if (typeof Symbol !== 'function' || typeof Object.getOwnPropertySymbols !== 'function') { return false; }
@@ -3482,7 +3540,7 @@ var __spreadValues$3 = (a, b) => {
     }
   return a;
 };
-var __async$2 = (__this, __arguments, generator) => {
+var __async$3 = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
     var fulfilled = (value) => {
       try {
@@ -3521,7 +3579,7 @@ class FundingSourcesAPI {
      * The `create` method creates a new funding source for a given user. This requires
      * payment information to be collected from the user.
      */
-    this.create = (createFundingSource) => __async$2(this, null, function* () {
+    this.create = (createFundingSource) => __async$3(this, null, function* () {
       const endUserIpAddress = yield getEndUserIpAddress();
       if (!endUserIpAddress) {
         return Promise.reject([new CodedError("Unable to get IP address")]);
@@ -3535,7 +3593,7 @@ class FundingSourcesAPI {
      * user to update the billing address or payment information associated with the
      * funding source.
      */
-    this.update = (billingInfo, creditCardInfo, fundingSourceId) => __async$2(this, null, function* () {
+    this.update = (billingInfo, creditCardInfo, fundingSourceId) => __async$3(this, null, function* () {
       const endUserIpAddress = yield getEndUserIpAddress();
       if (!endUserIpAddress) {
         return Promise.reject([new CodedError("Unable to get IP address")]);
@@ -3553,7 +3611,7 @@ class FundingSourcesAPI {
      * The `registerCarrier` method registers a carrier account and associates
      * it with a given funding source.
      */
-    this.registerCarrier = (carrier) => __async$2(this, null, function* () {
+    this.registerCarrier = (carrier) => __async$3(this, null, function* () {
       const endUserIpAddress = yield getEndUserIpAddress();
       if (!endUserIpAddress) {
         return Promise.reject([new CodedError("Unable to get IP address")]);
@@ -3565,7 +3623,7 @@ class FundingSourcesAPI {
     /**
      * The `addFunds` method allows you to add funds to a funding source.
      */
-    this.addFunds = (amount, fundingSourceId) => __async$2(this, null, function* () {
+    this.addFunds = (amount, fundingSourceId) => __async$3(this, null, function* () {
       return yield this.client.put(
         `/v1/funding_sources/${fundingSourceId}/add_funds`,
         amount
@@ -3575,7 +3633,7 @@ class FundingSourcesAPI {
      * The `metadata` method returns seller-specific requirements for creating funding sources
      * and attaching carriers
      */
-    this.metadata = () => __async$2(this, null, function* () {
+    this.metadata = () => __async$3(this, null, function* () {
       return yield this.client.get("/v1/funding_sources/metadata");
     });
     /**
@@ -3874,6 +3932,26 @@ class SalesOrdersAPI {
   }
 }
 
+var __async$2 = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
 class SellersAPI {
   constructor(client) {
     /**
@@ -3882,6 +3960,55 @@ class SellersAPI {
     this.listSandboxSellerIds = ({ sellerId }) => {
       return this.client.get(`/v1/sellers/sandbox_sellers/${sellerId}`);
     };
+    /**
+     * Given a seller ID, returns a list of API Keys created for that seller.
+     */
+    this.listSellerApiKeys = (props) => {
+      return this.client.get(`/v1/sellers/api_keys?sellerId=${props.sellerId}`, {
+        isSandbox: props.isSandbox
+      });
+    };
+    /**
+     * Creates an API Key for a Seller ID
+     */
+    this.createSellerApiKey = ({
+      description,
+      sellerId,
+      isSandbox
+    }) => {
+      return this.client.post(
+        "/v1/sellers/create_key",
+        {
+          description,
+          sellerId
+        },
+        {
+          isSandbox
+        }
+      );
+    };
+    /**
+     * Deletes an API Key
+     */
+    this.deleteSellerApiKey = (_0) => __async$2(this, [_0], function* ({
+      encryptedApiKey,
+      sellerId,
+      isSandbox
+    }) {
+      const sellerApiKeys = yield this.listSellerApiKeys({ isSandbox, sellerId });
+      if (!sellerApiKeys.data.find((sellerApiKey) => sellerApiKey.encryptedApiKey === encryptedApiKey)) {
+        return Promise.reject([
+          new CodedError("Missing Seller ID from Token", {
+            errorCode: "unauthorized",
+            errorSource: "client",
+            errorType: "security"
+          })
+        ]);
+      }
+      return this.client.delete("/v1/sellers", {
+        data: encryptedApiKey
+      });
+    });
     /**
      * Creates a sandbox seller account for a given seller ID
      * you can pass in a flag to try to reuse the carrier connection.
@@ -21445,6 +21572,7 @@ const logger = E({
 });
 class ShipEngineAPI {
   constructor(token, { baseURL, headers, getToken, getSandboxToken, onApiError }) {
+    this.getSandboxToken = getSandboxToken;
     const client = axios.create({
       baseURL,
       headers: __spreadProps(__spreadValues({}, headers), {
@@ -21548,6 +21676,35 @@ class ShipEngineAPI {
   set token(token) {
     this.client.defaults.headers.common["Authorization"] = `Bearer ${token}`;
   }
+  get token() {
+    return this.client.defaults.headers.common["Authorization"];
+  }
+  /**
+   * The `getTenant` method get the current token (based on `isSandbox` prop) and will get the Tenant ID from
+   * that token (also known as Seller ID)
+   */
+  getTenant(isSandbox) {
+    return __async(this, null, function* () {
+      var _a;
+      if (!isSandbox) {
+        return this.getTenantFromToken(this.token);
+      }
+      if (!this.sandboxToken) {
+        this.sandboxToken = yield (_a = this.getSandboxToken) == null ? void 0 : _a.call(this);
+      }
+      return this.getTenantFromToken(this.sandboxToken);
+    });
+  }
+  /**
+   * The `getTenantFromToken` method receives a token and returns the Tenant ID associated with it.
+   */
+  getTenantFromToken(token) {
+    try {
+      return jwtDecode(token).tenant;
+    } catch (e) {
+      return null;
+    }
+  }
   /**
    * The `accountSettings` method provides access to the Account Settings endpoints
    * in ShipEngine API.

package/index.mjs

@@ -176,7 +176,7 @@ class AccountSettingsAPI {
     /**
      * The `update` method updates specific account settings for a given user.
      *
-     * @params Partial<AccountSettings> The account settings to update.
+     * @params Partial<ShipEngineAccountSettings> The account settings to update.
      */
     this.update = (settings) => {
       return this.client.put("/v1/account/settings", settings);
@@ -971,7 +971,7 @@ var ipaddr = {
 	}).call(commonjsGlobal);
 } (ipaddr));
 
-var __async$5 = (__this, __arguments, generator) => {
+var __async$6 = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
     var fulfilled = (value) => {
       try {
@@ -991,7 +991,7 @@ var __async$5 = (__this, __arguments, generator) => {
     step((generator = generator.apply(__this, __arguments)).next());
   });
 };
-const getEndUserIpAddress = () => __async$5(void 0, null, function* () {
+const getEndUserIpAddress = () => __async$6(void 0, null, function* () {
   try {
     const response = yield axios.get("https://api.ipify.org/?format=json");
     if (response.data.ip && ipaddrExports.isValid(response.data.ip)) {
@@ -1034,7 +1034,7 @@ var __objRest = (source, exclude) => {
     }
   return target;
 };
-var __async$4 = (__this, __arguments, generator) => {
+var __async$5 = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
     var fulfilled = (value) => {
       try {
@@ -1074,7 +1074,7 @@ class CarriersAPI {
     /**
      * The `connect` method connects a carrier account to a user's ShipEngine account.
      */
-    this.connect = (_a) => __async$4(this, null, function* () {
+    this.connect = (_a) => __async$5(this, null, function* () {
       var _b = _a, { carrierCode } = _b, connection = __objRest(_b, ["carrierCode"]);
       const endUserIpAddress = yield getEndUserIpAddress();
       if (!endUserIpAddress)
@@ -1165,7 +1165,7 @@ class CarriersAPI {
   }
 }
 
-var __async$3 = (__this, __arguments, generator) => {
+var __async$4 = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
     var fulfilled = (value) => {
       try {
@@ -1207,7 +1207,7 @@ class ConnectionsAPI {
     /**
      * The `connectCarrier` method connects a carrier to account.
      */
-    this.connectCarrier = (carrierName, formData) => __async$3(this, null, function* () {
+    this.connectCarrier = (carrierName, formData) => __async$4(this, null, function* () {
       return yield this.client.post(
         `/v1/connections/carriers/${carrierName}`,
         formData,
@@ -1393,6 +1393,64 @@ var humps = {
 	})(commonjsGlobal);
 } (humps));
 
+class InvalidTokenError extends Error {
+}
+InvalidTokenError.prototype.name = "InvalidTokenError";
+function b64DecodeUnicode(str) {
+    return decodeURIComponent(atob(str).replace(/(.)/g, (m, p) => {
+        let code = p.charCodeAt(0).toString(16).toUpperCase();
+        if (code.length < 2) {
+            code = "0" + code;
+        }
+        return "%" + code;
+    }));
+}
+function base64UrlDecode(str) {
+    let output = str.replace(/-/g, "+").replace(/_/g, "/");
+    switch (output.length % 4) {
+        case 0:
+            break;
+        case 2:
+            output += "==";
+            break;
+        case 3:
+            output += "=";
+            break;
+        default:
+            throw new Error("base64 string is not of the correct length");
+    }
+    try {
+        return b64DecodeUnicode(output);
+    }
+    catch (err) {
+        return atob(output);
+    }
+}
+function jwtDecode(token, options) {
+    if (typeof token !== "string") {
+        throw new InvalidTokenError("Invalid token specified: must be a string");
+    }
+    options || (options = {});
+    const pos = options.header === true ? 0 : 1;
+    const part = token.split(".")[pos];
+    if (typeof part !== "string") {
+        throw new InvalidTokenError(`Invalid token specified: missing part #${pos + 1}`);
+    }
+    let decoded;
+    try {
+        decoded = base64UrlDecode(part);
+    }
+    catch (e) {
+        throw new InvalidTokenError(`Invalid token specified: invalid base64 for part #${pos + 1} (${e.message})`);
+    }
+    try {
+        return JSON.parse(decoded);
+    }
+    catch (e) {
+        throw new InvalidTokenError(`Invalid token specified: invalid json for part #${pos + 1} (${e.message})`);
+    }
+}
+
 /* eslint complexity: [2, 18], max-statements: [2, 33] */
 var shams = function hasSymbols() {
 	if (typeof Symbol !== 'function' || typeof Object.getOwnPropertySymbols !== 'function') { return false; }
@@ -3478,7 +3536,7 @@ var __spreadValues$3 = (a, b) => {
     }
   return a;
 };
-var __async$2 = (__this, __arguments, generator) => {
+var __async$3 = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
     var fulfilled = (value) => {
       try {
@@ -3517,7 +3575,7 @@ class FundingSourcesAPI {
      * The `create` method creates a new funding source for a given user. This requires
      * payment information to be collected from the user.
      */
-    this.create = (createFundingSource) => __async$2(this, null, function* () {
+    this.create = (createFundingSource) => __async$3(this, null, function* () {
       const endUserIpAddress = yield getEndUserIpAddress();
       if (!endUserIpAddress) {
         return Promise.reject([new CodedError("Unable to get IP address")]);
@@ -3531,7 +3589,7 @@ class FundingSourcesAPI {
      * user to update the billing address or payment information associated with the
      * funding source.
      */
-    this.update = (billingInfo, creditCardInfo, fundingSourceId) => __async$2(this, null, function* () {
+    this.update = (billingInfo, creditCardInfo, fundingSourceId) => __async$3(this, null, function* () {
       const endUserIpAddress = yield getEndUserIpAddress();
       if (!endUserIpAddress) {
         return Promise.reject([new CodedError("Unable to get IP address")]);
@@ -3549,7 +3607,7 @@ class FundingSourcesAPI {
      * The `registerCarrier` method registers a carrier account and associates
      * it with a given funding source.
      */
-    this.registerCarrier = (carrier) => __async$2(this, null, function* () {
+    this.registerCarrier = (carrier) => __async$3(this, null, function* () {
       const endUserIpAddress = yield getEndUserIpAddress();
       if (!endUserIpAddress) {
         return Promise.reject([new CodedError("Unable to get IP address")]);
@@ -3561,7 +3619,7 @@ class FundingSourcesAPI {
     /**
      * The `addFunds` method allows you to add funds to a funding source.
      */
-    this.addFunds = (amount, fundingSourceId) => __async$2(this, null, function* () {
+    this.addFunds = (amount, fundingSourceId) => __async$3(this, null, function* () {
       return yield this.client.put(
         `/v1/funding_sources/${fundingSourceId}/add_funds`,
         amount
@@ -3571,7 +3629,7 @@ class FundingSourcesAPI {
      * The `metadata` method returns seller-specific requirements for creating funding sources
      * and attaching carriers
      */
-    this.metadata = () => __async$2(this, null, function* () {
+    this.metadata = () => __async$3(this, null, function* () {
       return yield this.client.get("/v1/funding_sources/metadata");
     });
     /**
@@ -3870,6 +3928,26 @@ class SalesOrdersAPI {
   }
 }
 
+var __async$2 = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
 class SellersAPI {
   constructor(client) {
     /**
@@ -3878,6 +3956,55 @@ class SellersAPI {
     this.listSandboxSellerIds = ({ sellerId }) => {
       return this.client.get(`/v1/sellers/sandbox_sellers/${sellerId}`);
     };
+    /**
+     * Given a seller ID, returns a list of API Keys created for that seller.
+     */
+    this.listSellerApiKeys = (props) => {
+      return this.client.get(`/v1/sellers/api_keys?sellerId=${props.sellerId}`, {
+        isSandbox: props.isSandbox
+      });
+    };
+    /**
+     * Creates an API Key for a Seller ID
+     */
+    this.createSellerApiKey = ({
+      description,
+      sellerId,
+      isSandbox
+    }) => {
+      return this.client.post(
+        "/v1/sellers/create_key",
+        {
+          description,
+          sellerId
+        },
+        {
+          isSandbox
+        }
+      );
+    };
+    /**
+     * Deletes an API Key
+     */
+    this.deleteSellerApiKey = (_0) => __async$2(this, [_0], function* ({
+      encryptedApiKey,
+      sellerId,
+      isSandbox
+    }) {
+      const sellerApiKeys = yield this.listSellerApiKeys({ isSandbox, sellerId });
+      if (!sellerApiKeys.data.find((sellerApiKey) => sellerApiKey.encryptedApiKey === encryptedApiKey)) {
+        return Promise.reject([
+          new CodedError("Missing Seller ID from Token", {
+            errorCode: "unauthorized",
+            errorSource: "client",
+            errorType: "security"
+          })
+        ]);
+      }
+      return this.client.delete("/v1/sellers", {
+        data: encryptedApiKey
+      });
+    });
     /**
      * Creates a sandbox seller account for a given seller ID
      * you can pass in a flag to try to reuse the carrier connection.
@@ -21441,6 +21568,7 @@ const logger = E({
 });
 class ShipEngineAPI {
   constructor(token, { baseURL, headers, getToken, getSandboxToken, onApiError }) {
+    this.getSandboxToken = getSandboxToken;
     const client = axios.create({
       baseURL,
       headers: __spreadProps(__spreadValues({}, headers), {
@@ -21544,6 +21672,35 @@ class ShipEngineAPI {
   set token(token) {
     this.client.defaults.headers.common["Authorization"] = `Bearer ${token}`;
   }
+  get token() {
+    return this.client.defaults.headers.common["Authorization"];
+  }
+  /**
+   * The `getTenant` method get the current token (based on `isSandbox` prop) and will get the Tenant ID from
+   * that token (also known as Seller ID)
+   */
+  getTenant(isSandbox) {
+    return __async(this, null, function* () {
+      var _a;
+      if (!isSandbox) {
+        return this.getTenantFromToken(this.token);
+      }
+      if (!this.sandboxToken) {
+        this.sandboxToken = yield (_a = this.getSandboxToken) == null ? void 0 : _a.call(this);
+      }
+      return this.getTenantFromToken(this.sandboxToken);
+    });
+  }
+  /**
+   * The `getTenantFromToken` method receives a token and returns the Tenant ID associated with it.
+   */
+  getTenantFromToken(token) {
+    try {
+      return jwtDecode(token).tenant;
+    } catch (e) {
+      return null;
+    }
+  }
   /**
    * The `accountSettings` method provides access to the Account Settings endpoints
    * in ShipEngine API.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shipengine/js-api",
-  "version": "2.4.0",
+  "version": "2.5.1",
   "main": "./index.js",
   "types": "./index.d.ts",
   "exports": {
@@ -17,6 +17,7 @@
     "tsconfig": "./tsconfig.lib.json"
   },
   "peerDependencies": {
-    "axios": "^0.26.1"
+    "axios": "^0.26.1",
+    "jwt-decode": "^4.0.0"
   }
 }

package/sellers/api.d.ts

@@ -1,6 +1,6 @@
 import { AxiosInstance } from "axios";
-import { SandboxableMutation } from "../resources";
-import type { ListSandboxSellersParams, SandboxMethodParams } from "./types";
+import { SandboxableMutation, SandboxableQuery } from "../resources";
+import type { CreateSellerApiKeyParams, DeleteSellerApiKeyParams, ListSandboxSellersParams, SandboxMethodParams, SellerApiKey } from "./types";
 /**
  * Sellers API endpoints
  */
@@ -11,6 +11,20 @@ export declare class SellersAPI {
      * Given a seller ID, returns a list of sandbox seller IDs for that seller.
      */
     listSandboxSellerIds: ({ sellerId }: ListSandboxSellersParams) => Promise<import("axios").AxiosResponse<string[], any>>;
+    /**
+     * Given a seller ID, returns a list of API Keys created for that seller.
+     */
+    listSellerApiKeys: (props: SandboxableQuery<{
+        sellerId: string;
+    }>) => Promise<import("axios").AxiosResponse<SellerApiKey[], any>>;
+    /**
+     * Creates an API Key for a Seller ID
+     */
+    createSellerApiKey: ({ description, sellerId, isSandbox, }: SandboxableMutation<CreateSellerApiKeyParams>) => Promise<import("axios").AxiosResponse<SellerApiKey, any>>;
+    /**
+     * Deletes an API Key
+     */
+    deleteSellerApiKey: ({ encryptedApiKey, sellerId, isSandbox, }: SandboxableMutation<DeleteSellerApiKeyParams>) => Promise<import("axios").AxiosResponse<void, any>>;
     /**
      * Creates a sandbox seller account for a given seller ID
      * you can pass in a flag to try to reuse the carrier connection.

package/sellers/types.d.ts

@@ -1,7 +1,25 @@
 export type ListSandboxSellersParams = {
     sellerId: string;
 };
+export type ListSellerApiKeysParams = {
+    sellerId: string;
+};
 export type SandboxMethodParams = {
     sellerId: string;
     tryReuseCarrierConnection?: boolean;
 };
+export type DeleteSellerApiKeyParams = {
+    encryptedApiKey: string;
+    sellerId: string;
+};
+export type CreateSellerApiKeyParams = {
+    description?: string;
+    sellerId: string;
+};
+export type SellerApiKey = {
+    accountId: number;
+    apiKeyId: number;
+    createdAt: string;
+    description?: string;
+    encryptedApiKey: string;
+};