@shipengine/js-api 4.4.0 → 4.5.0

package/account-billing/types.d.ts

@@ -1,16 +1,8 @@
-import { Provider } from "../funding-sources/types";
-/** @internal */
-export type AccountBillingProvider = Provider;
+import { AbbreviatedCreditCardInfo, BankAccountInfo } from "../payments";
 /** @internal */
 type PaymentMethod = {
-    bankAccountInfo: {
-        lastFour: string;
-        provider: string;
-    } | null;
-    creditCardInfo: {
-        cardNumberLastFour: string;
-        provider: AccountBillingProvider;
-    } | null;
+    bankAccountInfo: BankAccountInfo | null;
+    creditCardInfo: AbbreviatedCreditCardInfo | null;
     paymentMethodId?: string;
 };
 /** @internal */

package/client.d.ts

@@ -22,6 +22,7 @@ import { ServicePointsAPI } from "./service-points";
 import { ShipmentsAPI } from "./shipments";
 import { ShippingRulesAPI } from "./shipping-rules";
 import { ThemesAPI } from "./themes";
+import { UsersApi } from "./users";
 import { WarehousesAPI } from "./warehouses";
 import { WebhooksAPI } from "./webhooks";
 /**
@@ -252,4 +253,10 @@ export declare class ShipEngineAPI {
      * @see {@link AuctanePayAPI | The Auctane Pay API module}
      */
     get auctanePay(): AuctanePayAPI;
+    /**
+     * The `users` method provides access to Users endpoints in ShipEngine API.
+     *
+     * @see {@link UsersApi | The Users API module}
+     */
+    get users(): UsersApi;
 }

package/funding-sources/api.d.ts

@@ -1,7 +1,7 @@
 import { AxiosInstance } from "axios";
 import { Money } from "../payments";
 import { CreationRangeQuery, PageableQuery } from "../resources";
-import { AddFundsResponse, AuctanePayInfo, BankAccountInfo, CarrierRegistration, CarrierRegistrationResponse, CreateFundingSource, CreditCardInfo, FundingSource, FundingSourceAddress, FundingSourceCreateResponse, FundingSourceTransactionsResponse, InsuranceFundingSourceAcceptedTermsResponse, MetadataResponse } from "./types";
+import { AddFundsResponse, AuctanePayInfo, CarrierRegistration, CarrierRegistrationResponse, CreateFundingSource, CreditCardInfo, FundingSource, FundingSourceAddress, FundingSourceCreateResponse, FundingSourceTransactionsResponse, InsuranceFundingSourceAcceptedTermsResponse, MetadataResponse } from "./types";
 /**
  * @internal
  * # Funding Sources API module - /v1/funding_sources
@@ -30,7 +30,7 @@ export declare class FundingSourcesAPI {
      * user to update the billing address or payment information associated with the
      * funding source.
      */
-    update: (billingInfo: FundingSourceAddress, creditCardInfo: CreditCardInfo | undefined, bankAccountInfo: BankAccountInfo | undefined, auctanePayInfo: AuctanePayInfo | undefined, fundingSourceId: string) => Promise<import("axios").AxiosResponse<{
+    update: (billingInfo: FundingSourceAddress, creditCardInfo: CreditCardInfo | undefined, auctanePayInfo: AuctanePayInfo | undefined, fundingSourceId: string) => Promise<import("axios").AxiosResponse<{
         fundingSource: FundingSource;
     }, any>>;
     /**

package/funding-sources/types.d.ts

@@ -1,3 +1,4 @@
+import { AbbreviatedCreditCardInfo, BankAccountInfo, Provider } from "../payments";
 import { PageableResult } from "../resources";
 /**
  * @internal
@@ -12,7 +13,6 @@ export type CreateFundingSource = {
     billingInfo: FundingSourceAddress;
     iovationBlackBox: IovationBlackBox;
     paymentMethod: {
-        bankAccountInfo?: BankAccountInfo;
         creditCardInfo?: CreditCardInfo;
         paymentMethodId?: string;
         sessionId?: string;
@@ -29,22 +29,10 @@ export type FundingSource = {
         bankAccountInfo: BankAccountInfo | null;
         creditCardInfo: AbbreviatedCreditCardInfo | null;
         paymentMethodId?: string;
-        sessionId?: string;
     };
 };
 /** @internal */
-export type AbbreviatedCreditCardInfo = {
-    cardNumberLastFour: string;
-    provider: Provider;
-};
-/** @internal */
 export type FundingSourceInsuranceProvider = "parcelguard" | "x_cover";
-/**
- * @internal
- * Used for creating new funding source without Auctane Pay.
- * As well for receiving existing funding source information.
- */
-export type Provider = "visa" | "mastercard" | "american_express" | "discover" | "maestro" | "diners_club" | "ach" | "jcb" | "pulse" | "star" | "union_pay";
 /** @internal */
 export interface FundingSourcePickupAddress extends Omit<FundingSourceAddress, "email" | "phone"> {
     email?: string;
@@ -98,10 +86,6 @@ export interface CreditCardInfo {
     name: string;
     provider: Provider;
 }
-export interface BankAccountInfo {
-    lastFour: string;
-    provider: string;
-}
 /** @internal */
 export interface Term {
     termType: string;

package/index.d.ts

@@ -32,3 +32,4 @@ export * from "./webhooks";
 export * from "./weight";
 export * from "./zones";
 export * from "./sellers";
+export * from "./users";

package/index.js

@@ -3545,7 +3545,7 @@ class FundingSourcesAPI {
      * user to update the billing address or payment information associated with the
      * funding source.
      */
-    this.update = (billingInfo, creditCardInfo, bankAccountInfo, auctanePayInfo, fundingSourceId) => __async$4(this, null, function* () {
+    this.update = (billingInfo, creditCardInfo, auctanePayInfo, fundingSourceId) => __async$4(this, null, function* () {
       const endUserIpAddress = yield getEndUserIpAddress();
       if (!endUserIpAddress) {
         return Promise.reject([new CodedError("Unable to get IP address")]);
@@ -3556,7 +3556,6 @@ class FundingSourcesAPI {
           billingInfo,
           endUserIpAddress,
           paymentMethod: __spreadValues$3({
-            bankAccountInfo,
             creditCardInfo
           }, auctanePayInfo)
         }
@@ -4285,6 +4284,19 @@ class ThemesAPI {
   }
 }
 
+class UsersApi {
+  constructor(client) {
+    this.client = client;
+    /**
+     * The `list` gets all the users of the current Seller.
+     */
+    this.list = (options) => {
+      return this.client.get("/v1/users", { params: options });
+    };
+    this.client = client;
+  }
+}
+
 class WarehousesAPI {
   constructor(client) {
     this.client = client;
@@ -22006,6 +22018,14 @@ class ShipEngineAPI {
   get auctanePay() {
     return new AuctanePayAPI(this.client);
   }
+  /**
+   * The `users` method provides access to Users endpoints in ShipEngine API.
+   *
+   * @see {@link UsersApi | The Users API module}
+   */
+  get users() {
+    return new UsersApi(this.client);
+  }
 }
 
 exports.AccountBillingAPI = AccountBillingAPI;
@@ -22045,6 +22065,7 @@ exports.ShipEngineAPI = ShipEngineAPI;
 exports.ShipmentsAPI = ShipmentsAPI;
 exports.ShippingRulesAPI = ShippingRulesAPI;
 exports.ThemesAPI = ThemesAPI;
+exports.UsersApi = UsersApi;
 exports.WarehousesAPI = WarehousesAPI;
 exports.WebhooksAPI = WebhooksAPI;
 exports.camelizeKeys = camelizeKeys;

package/index.mjs

@@ -3541,7 +3541,7 @@ class FundingSourcesAPI {
      * user to update the billing address or payment information associated with the
      * funding source.
      */
-    this.update = (billingInfo, creditCardInfo, bankAccountInfo, auctanePayInfo, fundingSourceId) => __async$4(this, null, function* () {
+    this.update = (billingInfo, creditCardInfo, auctanePayInfo, fundingSourceId) => __async$4(this, null, function* () {
       const endUserIpAddress = yield getEndUserIpAddress();
       if (!endUserIpAddress) {
         return Promise.reject([new CodedError("Unable to get IP address")]);
@@ -3552,7 +3552,6 @@ class FundingSourcesAPI {
           billingInfo,
           endUserIpAddress,
           paymentMethod: __spreadValues$3({
-            bankAccountInfo,
             creditCardInfo
           }, auctanePayInfo)
         }
@@ -4281,6 +4280,19 @@ class ThemesAPI {
   }
 }
 
+class UsersApi {
+  constructor(client) {
+    this.client = client;
+    /**
+     * The `list` gets all the users of the current Seller.
+     */
+    this.list = (options) => {
+      return this.client.get("/v1/users", { params: options });
+    };
+    this.client = client;
+  }
+}
+
 class WarehousesAPI {
   constructor(client) {
     this.client = client;
@@ -22002,6 +22014,14 @@ class ShipEngineAPI {
   get auctanePay() {
     return new AuctanePayAPI(this.client);
   }
+  /**
+   * The `users` method provides access to Users endpoints in ShipEngine API.
+   *
+   * @see {@link UsersApi | The Users API module}
+   */
+  get users() {
+    return new UsersApi(this.client);
+  }
 }
 
-export { AccountBillingAPI, AccountBillingPlanAPI, AccountBillingPlanChangeType, AccountSettingsAPI, AddressesAPI, AuctanePayAPI, CarriersAPI, CodedError, ConfirmationType, ConnectionsAPI, CreditCardVendor, Currency, CustomPackagesAPI, CustomsContentsType, CustomsNonDeliveryType, FundingSourcesAPI, InsuranceAPI, InsuranceProviderType, InvoiceAddressAPI, LabelsAPI, MetadataCapability, MetadataRequirement, MetadataSatisfyingFormTypes, MovementIndicator, OrderSourcesAPI, RateCardStatus, RateCardsAPI, RatesAPI, types as SE, SalesOrderShipmentsAPI, SalesOrdersAPI, SellersAPI, ServicePointsAPI, ShipEngineAPI, ShipmentsAPI, ShippingRulesAPI, ThemesAPI, WarehousesAPI, WebhooksAPI, camelizeKeys, decamelizeKeys, getEndUserIpAddress, isCodedError, isCodedErrors, isDataCodedErrors, isInvalidTokenError, parseError };
+export { AccountBillingAPI, AccountBillingPlanAPI, AccountBillingPlanChangeType, AccountSettingsAPI, AddressesAPI, AuctanePayAPI, CarriersAPI, CodedError, ConfirmationType, ConnectionsAPI, CreditCardVendor, Currency, CustomPackagesAPI, CustomsContentsType, CustomsNonDeliveryType, FundingSourcesAPI, InsuranceAPI, InsuranceProviderType, InvoiceAddressAPI, LabelsAPI, MetadataCapability, MetadataRequirement, MetadataSatisfyingFormTypes, MovementIndicator, OrderSourcesAPI, RateCardStatus, RateCardsAPI, RatesAPI, types as SE, SalesOrderShipmentsAPI, SalesOrdersAPI, SellersAPI, ServicePointsAPI, ShipEngineAPI, ShipmentsAPI, ShippingRulesAPI, ThemesAPI, UsersApi, WarehousesAPI, WebhooksAPI, camelizeKeys, decamelizeKeys, getEndUserIpAddress, isCodedError, isCodedErrors, isDataCodedErrors, isInvalidTokenError, parseError };

package/labels/types.d.ts

@@ -10,6 +10,9 @@ export type LabelFormat = "pdf" | "png" | "zpl";
 export type LabelLayout = "4x6" | "letter";
 export type LabelStatus = "processing" | "completed" | "error" | "voided";
 export type LabelTrackingStatus = "unknown" | "in_transit" | "delivered" | "error";
+/**
+ * Columns available for label exports
+ */
 export type LabelColumns = "shipment_id" | "label_id" | "external_order_id" | "external_shipment_id" | "packages" | "recipient" | "shipping_service" | "created_date" | "ship_date" | "status" | "tracking_status";
 export type Label = {
     alternativeIdentifiers?: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shipengine/js-api",
-  "version": "4.4.0",
+  "version": "4.5.0",
   "main": "./index.js",
   "types": "./index.d.ts",
   "exports": {

package/payments/types.d.ts

@@ -17,6 +17,27 @@ export interface CreditCard {
     number: string;
     type: CreditCardVendor;
 }
+/**
+ * @category Entities
+ */
+export interface BankAccountInfo {
+    institutionName: string;
+    lastFour: string;
+    provider: string;
+}
+/**
+ * @category Entities
+ */
+export type AbbreviatedCreditCardInfo = {
+    cardNumberLastFour: string;
+    provider: Provider;
+};
+/**
+ * @category Entities
+ * Used for creating new funding source without Auctane Pay.
+ * As well for receiving existing funding source and subscription billing information.
+ */
+export type Provider = "visa" | "mastercard" | "american_express" | "discover" | "maestro" | "diners_club" | "ach" | "jcb" | "pulse" | "star" | "union_pay";
 /**
  * @category Entities
  */

package/types.d.ts

@@ -31,3 +31,4 @@ export * from "./weight/types";
 export * from "./weight-band/types";
 export * from "./zones/types";
 export * from "./sellers/types";
+export * from "./users/types";

package/users/api.d.ts

@@ -0,0 +1,14 @@
+import { AxiosInstance } from "axios";
+import { UserListOptions, UserListResponse } from "./types";
+/**
+ * # Users API module - /v1/users
+ * @link https://docs.shipstation.com/openapi/users
+ */
+export declare class UsersApi {
+    private client;
+    constructor(client: AxiosInstance);
+    /**
+     * The `list` gets all the users of the current Seller.
+     */
+    list: (options?: UserListOptions) => Promise<import("axios").AxiosResponse<UserListResponse, any>>;
+}

package/users/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./api";
+export * from "./types";

package/users/types.d.ts

@@ -0,0 +1,17 @@
+import { CreationRangeQuery, ModificationRangeQuery, PageableQuery, PageableResult, SortableQuery } from "../resources";
+export type UserStatus = "Active" | "Inactive" | "Locked_out" | "Email_lock";
+export type User = {
+    createdAt: string;
+    email: string;
+    lastLoginAt: string;
+    name: string;
+    status: UserStatus;
+    userId: string;
+    username: string;
+};
+export type UserListOptions = {
+    status?: UserStatus;
+} & PageableQuery & CreationRangeQuery & ModificationRangeQuery & SortableQuery;
+export type UserListResponse = {
+    users: User[];
+} & PageableResult;