@shipengine/js-api 1.13.0 → 1.15.0

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, CarrierRegistration, CarrierRegistrationResponse, CreateFundingSource, CreditCardInfo, FundingSource, FundingSourceAddress, FundingSourceTransactionsResponse, MetadataResponse } from "./types";
+import { AddFundsResponse, CarrierRegistration, CarrierRegistrationResponse, CreateFundingSource, CreditCardInfo, FundingSource, FundingSourceAddress, FundingSourceCreateResponse, FundingSourceTransactionsResponse, InsuranceFundingSourceAcceptedTermsResponse, MetadataResponse } from "./types";
 /**
  * # Funding Sources API module - /v1/funding_sources
  * Docs: https://auctane.atlassian.net/wiki/spaces/SE/pages/3628370266/ShipEngine+Funding+Sources+API
@@ -23,9 +23,7 @@ export declare class FundingSourcesAPI {
      * The `create` method creates a new funding source for a given user. This requires
      * payment information to be collected from the user.
      */
-    create: (createFundingSource: CreateFundingSource) => Promise<import("axios").AxiosResponse<{
-        fundingSource: FundingSource;
-    }, any>>;
+    create: (createFundingSource: CreateFundingSource) => Promise<import("axios").AxiosResponse<FundingSourceCreateResponse, any>>;
     /**
      * The `update` method updates a funding source for a given user. This allows the
      * user to update the billing address or payment information associated with the
@@ -53,4 +51,10 @@ export declare class FundingSourcesAPI {
      * See the FundingSourceTransactions type for more information about return data.
      */
     transactions: (fundingSourceId: string, params?: PageableQuery & CreationRangeQuery) => Promise<import("axios").AxiosResponse<FundingSourceTransactionsResponse, any>>;
+    /**
+     * Now we can attach insurance providers to the user's Funding Source.
+     * This endpoint will retrieve all accepted insurance terms. For example
+     * if "ParcelGuard" appears here that means the user its using it.
+     */
+    insuranceAcceptedTerms: () => Promise<import("axios").AxiosResponse<InsuranceFundingSourceAcceptedTermsResponse, any>>;
 }

package/funding-sources/types.d.ts

@@ -25,6 +25,7 @@ export type AbbreviatedCreditCardInfo = {
     cardNumberLastFour: string;
     provider: Provider;
 };
+export type FundingSourceInsuranceProvider = "parcelguard" | "x_cover";
 export type Provider = "visa" | "mastercard" | "americanExpress" | "discover";
 export type FundingSourceCarrier = {
     acceptedTerms: Term[];
@@ -34,8 +35,15 @@ export type FundingSourceCarrier = {
     iovationBlackBox: IovationBlackBox;
     pickupAddress?: FundingSourceAddress;
 };
+export type CarrierRegistrationInsuranceProvider = {
+    acceptedTerms: Term[];
+    agreeToTerms: boolean;
+    fundingSourceId: string;
+    provider: FundingSourceInsuranceProvider;
+};
 export interface CarrierRegistration {
-    carriers: FundingSourceCarrier[];
+    carriers?: FundingSourceCarrier[];
+    insuranceProviders?: CarrierRegistrationInsuranceProvider[];
 }
 export interface FundingSourceAddress {
     addressLine1: string;
@@ -104,6 +112,12 @@ export type MetadataRegistrationRequirement = {
     requirementType: MetadataRequirement;
     satisfyingFormTypes: MetadataSatisfyingFormTypes[];
 };
+export type MetadataCarrierProfile = {
+    capabilities: MetadataCapability[] | null;
+    carrierCode: string;
+    registrationRequirements: MetadataRegistrationRequirement[];
+    requiredTerms: MetadataRequiredTerm[];
+};
 export type TransactionCategory = "adjustment" | "credit" | "debit" | "funds_added" | "insurance" | "label" | "refund" | "service_charge" | "unknown";
 export type FundingSourceTransaction = {
     description?: string | null;
@@ -124,6 +138,16 @@ export type FundingSourceTransaction = {
     transactionCategory: TransactionCategory;
     transactionDate: string;
 };
+export interface FundingSourceInsuranceProviderResponse {
+    errorMessage: null | string;
+    fundingSourceId: string;
+    isSuccessful: boolean;
+    provider: FundingSourceInsuranceProvider;
+}
+export interface FundingSourceCreateResponse {
+    fundingSource: FundingSource;
+    insuranceProviderAttachmentResults: FundingSourceInsuranceProviderResponse[];
+}
 export interface CarrierRegistrationResponse {
     carrierAttachmentResults: [
         {
@@ -134,6 +158,7 @@ export interface CarrierRegistrationResponse {
             nickname: string;
         }
     ];
+    insuranceProviderAttachmentResults: FundingSourceInsuranceProviderResponse[];
 }
 export interface MetadataResponse {
     defaultFundingSourceProfile: {
@@ -145,12 +170,7 @@ export interface MetadataResponse {
         requiredTerms: MetadataRequiredTerm[];
     };
     defaultRegionProfile: {
-        carrierProfiles: Array<{
-            capabilities: MetadataCapability[] | null;
-            carrierCode: string;
-            registrationRequirements: MetadataRegistrationRequirement[];
-            requiredTerms: MetadataRequiredTerm[];
-        }>;
+        carrierProfiles: MetadataCarrierProfile[];
         countryCode: string;
         currencyCode: string;
     };
@@ -164,4 +184,7 @@ export type AddFundsResponse = {
 export type FundingSourceTransactionsResponse = {
     transactions: FundingSourceTransaction[];
 } & PageableResult;
+export type InsuranceFundingSourceAcceptedTermsResponse = {
+    acceptedTerms: Term[];
+};
 export {};

package/index.js

@@ -1201,7 +1201,15 @@ class ConnectionsAPI {
     this.connectCarrier = (carrierName, formData) => __async$3(this, null, function* () {
       return yield this.client.post(
         `/v1/connections/carriers/${carrierName}`,
-        formData
+        formData,
+        {
+          // This actually doesn't work in-browser; redirects will still be followed if the location header
+          // is set. This is relying on the Elements Proxy stripping that header and putting it in the body.
+          maxRedirects: 0,
+          validateStatus: (status) => {
+            return status >= 200 && status < 400;
+          }
+        }
       );
     });
     /**
@@ -3483,8 +3491,9 @@ class FundingSourcesAPI {
      */
     this.create = (createFundingSource) => __async$2(this, null, function* () {
       const endUserIpAddress = yield getEndUserIpAddress();
-      if (!endUserIpAddress)
+      if (!endUserIpAddress) {
         return Promise.reject([new CodedError("Unable to get IP address")]);
+      }
       return yield this.client.post("/v1/funding_sources", __spreadValues$2({
         endUserIpAddress
       }, createFundingSource));
@@ -3496,8 +3505,9 @@ class FundingSourcesAPI {
      */
     this.update = (billingInfo, creditCardInfo, fundingSourceId) => __async$2(this, null, function* () {
       const endUserIpAddress = yield getEndUserIpAddress();
-      if (!endUserIpAddress)
+      if (!endUserIpAddress) {
         return Promise.reject([new CodedError("Unable to get IP address")]);
+      }
       return yield this.client.put(
         `/v1/funding_sources/${fundingSourceId}`,
         {
@@ -3513,8 +3523,9 @@ class FundingSourcesAPI {
      */
     this.registerCarrier = (carrier) => __async$2(this, null, function* () {
       const endUserIpAddress = yield getEndUserIpAddress();
-      if (!endUserIpAddress)
+      if (!endUserIpAddress) {
         return Promise.reject([new CodedError("Unable to get IP address")]);
+      }
       return yield this.client.post("/v1/registration/funding_source", __spreadValues$2({
         endUserIpAddress
       }, carrier));
@@ -3547,6 +3558,16 @@ class FundingSourcesAPI {
         }
       );
     };
+    /**
+     * Now we can attach insurance providers to the user's Funding Source.
+     * This endpoint will retrieve all accepted insurance terms. For example
+     * if "ParcelGuard" appears here that means the user its using it.
+     */
+    this.insuranceAcceptedTerms = () => {
+      return this.client.get(
+        "/v1/insurance/funding_source/accepted_terms"
+      );
+    };
     this.client = client;
   }
 }
@@ -3851,6 +3872,12 @@ class ServicePointsAPI {
     this.get = ({ carrierCode, countryCode, id }) => {
       return this.client.get(`/v1/service_points/${carrierCode}/${countryCode}/${id}`);
     };
+    /**
+     * Get an OAuth token to make HERE Maps API requests
+     */
+    this.getHereToken = () => {
+      return this.client.get("/here-api/generate-token");
+    };
     this.client = client;
   }
 }

package/index.mjs

@@ -1197,7 +1197,15 @@ class ConnectionsAPI {
     this.connectCarrier = (carrierName, formData) => __async$3(this, null, function* () {
       return yield this.client.post(
         `/v1/connections/carriers/${carrierName}`,
-        formData
+        formData,
+        {
+          // This actually doesn't work in-browser; redirects will still be followed if the location header
+          // is set. This is relying on the Elements Proxy stripping that header and putting it in the body.
+          maxRedirects: 0,
+          validateStatus: (status) => {
+            return status >= 200 && status < 400;
+          }
+        }
       );
     });
     /**
@@ -3479,8 +3487,9 @@ class FundingSourcesAPI {
      */
     this.create = (createFundingSource) => __async$2(this, null, function* () {
       const endUserIpAddress = yield getEndUserIpAddress();
-      if (!endUserIpAddress)
+      if (!endUserIpAddress) {
         return Promise.reject([new CodedError("Unable to get IP address")]);
+      }
       return yield this.client.post("/v1/funding_sources", __spreadValues$2({
         endUserIpAddress
       }, createFundingSource));
@@ -3492,8 +3501,9 @@ class FundingSourcesAPI {
      */
     this.update = (billingInfo, creditCardInfo, fundingSourceId) => __async$2(this, null, function* () {
       const endUserIpAddress = yield getEndUserIpAddress();
-      if (!endUserIpAddress)
+      if (!endUserIpAddress) {
         return Promise.reject([new CodedError("Unable to get IP address")]);
+      }
       return yield this.client.put(
         `/v1/funding_sources/${fundingSourceId}`,
         {
@@ -3509,8 +3519,9 @@ class FundingSourcesAPI {
      */
     this.registerCarrier = (carrier) => __async$2(this, null, function* () {
       const endUserIpAddress = yield getEndUserIpAddress();
-      if (!endUserIpAddress)
+      if (!endUserIpAddress) {
         return Promise.reject([new CodedError("Unable to get IP address")]);
+      }
       return yield this.client.post("/v1/registration/funding_source", __spreadValues$2({
         endUserIpAddress
       }, carrier));
@@ -3543,6 +3554,16 @@ class FundingSourcesAPI {
         }
       );
     };
+    /**
+     * Now we can attach insurance providers to the user's Funding Source.
+     * This endpoint will retrieve all accepted insurance terms. For example
+     * if "ParcelGuard" appears here that means the user its using it.
+     */
+    this.insuranceAcceptedTerms = () => {
+      return this.client.get(
+        "/v1/insurance/funding_source/accepted_terms"
+      );
+    };
     this.client = client;
   }
 }
@@ -3847,6 +3868,12 @@ class ServicePointsAPI {
     this.get = ({ carrierCode, countryCode, id }) => {
       return this.client.get(`/v1/service_points/${carrierCode}/${countryCode}/${id}`);
     };
+    /**
+     * Get an OAuth token to make HERE Maps API requests
+     */
+    this.getHereToken = () => {
+      return this.client.get("/here-api/generate-token");
+    };
     this.client = client;
   }
 }

package/package.json

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

package/service-points/api.d.ts

@@ -1,5 +1,5 @@
 import { AxiosInstance } from "axios";
-import type { GetServicePointParams, ListServicePointsOptions, ServicePointsListResponse } from "./types";
+import type { GetServicePointParams, HereTokenResponse, ListServicePointsOptions, ServicePointsListResponse } from "./types";
 /**
  * Service points api
  */
@@ -16,4 +16,8 @@ export declare class ServicePointsAPI {
      * Get a specific service point by its carrier code, country code, and id
      */
     get: ({ carrierCode, countryCode, id }: GetServicePointParams) => Promise<import("axios").AxiosResponse<any, any>>;
+    /**
+     * Get an OAuth token to make HERE Maps API requests
+     */
+    getHereToken: () => Promise<import("axios").AxiosResponse<HereTokenResponse, any>>;
 }

package/service-points/types.d.ts

@@ -72,3 +72,8 @@ export type GetServicePointParams = {
     countryCode: string;
     id: string;
 };
+export type HereTokenResponse = {
+    accessToken: string;
+    expiresIn: number;
+    tokenType: string;
+};