@shipengine/elements 2.24.1 → 2.26.0

package/dist/cjs/features/manage-carriers/manage-carriers-row/manage-carriers-row.cjs

@@ -7,6 +7,7 @@ var reactApi = require('@shipengine/react-api');
 var React = require('react');
 var reactI18next = require('react-i18next');
 var manageCarriersRow_styles = require('./manage-carriers-row.styles.cjs');
+var upsTermsDisclosure = require('../../../components/ups-terms-disclosure/ups-terms-disclosure.cjs');
 var addressPreferenceContext = require('../../../components/address-preference-context/address-preference-context.cjs');
 var registerFundingSourceCarrierForm = require('../register-funding-source-carrier-form/register-funding-source-carrier-form.cjs');
 var carrierIcon = require('../../../components/carrier-icon/carrier-icon.cjs');
@@ -34,6 +35,10 @@ const ManageCarriersRow = ({
   const requirementTypes = carrierProfile.registrationRequirements.map(r => r.requirementType);
   const requiresAddress = requirementTypes.includes(reactApi.SE.MetadataRequirement.PickupAddress);
   const requiresTermsAcceptance = carrierProfile.requiredTerms.length > 0;
+  const requiredCarrierTerms = {
+    links: carrierProfile.requiredTerms.flatMap(term => term.links),
+    disclosure: carrierProfile.carrierCode === "ups_walleted" ? jsxRuntime.jsx(upsTermsDisclosure.UPSTermsDisclosure, {}) : undefined
+  };
   const handleRegister = values => _tslib.__awaiter(void 0, void 0, void 0, function* () {
     setIsSubmitting(true);
     showDropDown && setShowDropDown(false);
@@ -96,7 +101,7 @@ const ManageCarriersRow = ({
           onCancel: () => setShowDropDown(false),
           onSubmit: handleRegister,
           requirementTypes: requirementTypes,
-          terms: carrierProfile.requiredTerms
+          terms: requiredCarrierTerms
         })
       })
     })]

package/dist/cjs/features/manage-carriers/register-funding-source-carrier-form/register-funding-source-carrier-form.cjs

@@ -151,9 +151,9 @@ const RegisterFundingSourceCarrierForm = ({
             children: [jsxRuntime.jsx(giger.Typography, {
               variant: "heading4",
               children: t("terms.carriersTitle")
-            }), terms.map((term, index) => jsxRuntime.jsx(displayTerm.DisplayTerm, {
-              term: term
-            }, index))]
+            }), jsxRuntime.jsx(displayTerm.DisplayTerm, {
+              terms: terms
+            })]
           }), jsxRuntime.jsx(buttonGroup.ButtonGroup, {
             justify: "end",
             children: jsxRuntime.jsx(giger.Button, {

package/dist/cjs/features/payment-method-settings/payment-method-settings.cjs

@@ -3,11 +3,14 @@
 var _tslib = require('../../_virtual/_tslib.cjs');
 var jsxRuntime = require('@emotion/react/jsx-runtime');
 var useToggle = require('../../hooks/use-toggle.cjs');
+var giger = require('@shipengine/giger');
 var reactApi = require('@shipengine/react-api');
 var React = require('react');
 var reactI18next = require('react-i18next');
 var editBillingForm = require('../../components/forms/edit-billing-form/edit-billing-form.cjs');
 var walletCard = require('../../components/wallet-card/wallet-card.cjs');
+var elementsContextProvider = require('../../elements-provider/elements-context-provider.cjs');
+var spacer = require('../../components/spacer/spacer.cjs');
 var loader = require('../../components/loader/loader.cjs');
 var zeroState = require('../../components/zero-state/zero-state.cjs');
 
@@ -18,37 +21,72 @@ const PaymentMethodSettings = ({
   const {
     t
   } = reactI18next.useTranslation();
+  const {
+    globalFeatures
+  } = elementsContextProvider.useElements();
+  const {
+    supportEmailAddress
+  } = globalFeatures;
   const [showEditBilling, toggleShowEditBilling] = useToggle.useToggle(false);
   const [isUpdatingBilling, setIsUpdatingBilling] = React.useState(false);
   const {
-    mutateAsync: updateBilling
+    error: updateBillingError,
+    mutateAsync: updateBilling,
+    reset: resetUpdateFundingSource
   } = reactApi.useUpdateFundingSource();
   const {
     data: fundingSources,
     refetch: refetchFundingSources,
     isLoading: fundingSourceLoading
   } = reactApi.useListFundingSources();
-  const fundingSourceId = (_a = fundingSources === null || fundingSources === void 0 ? void 0 : fundingSources[0]) === null || _a === void 0 ? void 0 : _a.fundingSourceId;
+  const {
+    fundingSourceId,
+    billingInfo
+  } = (_a = fundingSources === null || fundingSources === void 0 ? void 0 : fundingSources[0]) !== null && _a !== void 0 ? _a : {};
   const handleUpdateBilling = (billingInfo, creditCardInfo) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
     if (fundingSourceId) {
-      setIsUpdatingBilling(true);
-      yield updateBilling({
-        billingInfo,
-        creditCardInfo,
-        fundingSourceId
-      });
-      yield refetchFundingSources();
-      toggleShowEditBilling(false);
-      setIsUpdatingBilling(false);
+      try {
+        setIsUpdatingBilling(true);
+        yield updateBilling({
+          billingInfo,
+          creditCardInfo,
+          fundingSourceId
+        });
+        yield refetchFundingSources();
+        toggleShowEditBilling(false);
+      } catch (error) {
+        console.error("Error updating billing:", error);
+        // error is handled by the mutation
+      } finally {
+        setIsUpdatingBilling(false);
+      }
     }
   });
-  if (showEditBilling) return jsxRuntime.jsx(editBillingForm.EditBillingForm, {
-    isLoading: isUpdatingBilling,
-    onCancel: () => {
-      toggleShowEditBilling(false);
-    },
-    // eslint-disable-next-line @typescript-eslint/no-misused-promises
-    onSubmit: handleUpdateBilling
+  if (showEditBilling) return jsxRuntime.jsxs(jsxRuntime.Fragment, {
+    children: [jsxRuntime.jsx(editBillingForm.EditBillingForm, {
+      billingInfo: billingInfo,
+      isLoading: isUpdatingBilling,
+      onCancel: () => {
+        toggleShowEditBilling(false);
+        resetUpdateFundingSource();
+      },
+      onSubmit: (billingInfo, creditCardInfo) => {
+        void handleUpdateBilling(billingInfo, creditCardInfo);
+      }
+    }), (updateBillingError === null || updateBillingError === void 0 ? void 0 : updateBillingError.length) && jsxRuntime.jsxs(jsxRuntime.Fragment, {
+      children: [jsxRuntime.jsx(spacer.Spacer, {
+        multiplier: 2
+      }), jsxRuntime.jsx(giger.InlineNotification, {
+        css: {
+          textAlign: "left"
+        },
+        title: t("account-settings:errors.paymentMethod.title"),
+        type: giger.NotificationType.ERROR,
+        children: t("account-settings:errors.paymentMethod.description", {
+          email: supportEmailAddress
+        })
+      })]
+    })]
   });else {
     if (fundingSourceLoading) return jsxRuntime.jsx(loader.Loader, {
       message: t("loading.paymentMethod")

package/dist/cjs/hooks/use-configure-shipment.cjs

@@ -22,6 +22,8 @@ const useConfigureShipment = ({
   warehouseId,
   useWarehouses = true
 }) => {
+  // Track when we've created a replacement shipment for a "not found" case
+  const [replacementShipmentId, setReplacementShipmentId] = React.useState();
   // Queue of incomplete requirement keys (i.e., Ship From addresses, Warehouses, Carriers)
   const incompleteRequirementsKeys = React.useMemo(() => [], []);
   const {
@@ -77,7 +79,7 @@ const useConfigureShipment = ({
     salesOrderIds: salesOrderId ? [salesOrderId] : salesOrder$1 ? [salesOrder$1.salesOrderId] :
     // TODO: current workaround - revert to being undefined rather than empty list
     [],
-    shipmentIds: shipmentId ? [shipmentId] : externalShipment ? [externalShipment.shipmentId] : newV1Shipment ? [newV1Shipment.shipments[0].shipmentId] : undefined
+    shipmentIds: replacementShipmentId ? [replacementShipmentId] : shipmentId ? [shipmentId] : externalShipment ? [externalShipment.shipmentId] : newV1Shipment ? [newV1Shipment.shipments[0].shipmentId] : undefined
   });
   const {
     error: createSalesOrderShipmentErrors,
@@ -90,6 +92,19 @@ const useConfigureShipment = ({
   const cancelledShipment = shipment.getShipmentByStatus("cancelled", salesOrderShipments);
   const defaultWarehouse = warehouses.getDefaultWarehouse(warehouses$1);
   const defaultShipFromAddress = address.getDefaultShipFromAddress(shipFromAddresses);
+  // Common function to create a V1 shipment
+  const createV1ShipmentWithDefaults = React.useCallback(() => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+    const v1Shipment = yield createV1Shipment(Object.assign({}, (defaultShipFromAddress === null || defaultShipFromAddress === void 0 ? void 0 : defaultShipFromAddress.originAddress) ? {
+      shipFrom: defaultShipFromAddress.originAddress
+    } : {
+      warehouseId: warehouseId ? warehouseId : defaultWarehouse.warehouseId
+    }));
+    if (v1Shipment) {
+      yield refetchSalesOrderShipments();
+      return v1Shipment;
+    }
+    return null;
+  }), [createV1Shipment, defaultShipFromAddress, defaultWarehouse, warehouseId, refetchSalesOrderShipments]);
   // Handles the creation of new shipments for the sales order flow and one-off flow
   const handleShipmentCreation = React.useCallback(() => _tslib.__awaiter(void 0, void 0, void 0, function* () {
     var _a, _b, _c;
@@ -139,16 +154,17 @@ const useConfigureShipment = ({
     }
     // Create a Shipment for one-off flow
     if (!salesOrderId && !externalOrderId && !externalOrderNumber && !orderSourceCode && !shipmentId && !externalShipmentId) {
-      const v1Shipment = yield createV1Shipment(Object.assign({}, (defaultShipFromAddress === null || defaultShipFromAddress === void 0 ? void 0 : defaultShipFromAddress.originAddress) ? {
-        shipFrom: defaultShipFromAddress.originAddress
-      } : {
-        warehouseId: warehouseId ? warehouseId : defaultWarehouse.warehouseId
-      }));
-      if (v1Shipment) {
-        yield refetchSalesOrderShipments();
-      }
+      yield createV1ShipmentWithDefaults();
+    }
+  }), [createSalesOrderShipment, createV1ShipmentWithDefaults, creatingSalesOrderShipment, creatingV1Shipment, defaultShipFromAddress, defaultWarehouse, externalOrderId, externalOrderNumber, externalShipmentId, incompleteRequirementsKeys, isExternalShipmentFetching, isExternalShipmentInitialLoading, isFetchingWarehouses, isInitialLoadingWarehouses, labelPurchasedSalesOrderShipment, listSalesOrderShipmentsInitiallyLoading, listSalesOrderShipmentsIsFetching, orderSourceCode, pendingSalesOrderShipment, salesOrder$1, salesOrderId, salesOrderShipmentCreated, shipFromAddresses === null || shipFromAddresses === void 0 ? void 0 : shipFromAddresses.length, shipmentId, useWarehouses, v1shipmentCreated, warehouseId, warehouses$1]);
+  const createNewShipmentForNotFound = React.useCallback(() => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+    // Force create a new shipment even if shipmentId exists (for shipment_not_found case)
+    const v1Shipment = yield createV1ShipmentWithDefaults();
+    if (v1Shipment) {
+      // Store the new shipment ID to override the stale one
+      setReplacementShipmentId(v1Shipment.shipments[0].shipmentId);
     }
-  }), [createSalesOrderShipment, createV1Shipment, creatingSalesOrderShipment, creatingV1Shipment, defaultShipFromAddress, defaultWarehouse, externalOrderId, externalOrderNumber, externalShipmentId, incompleteRequirementsKeys, isExternalShipmentFetching, isExternalShipmentInitialLoading, isFetchingWarehouses, isInitialLoadingWarehouses, labelPurchasedSalesOrderShipment, listSalesOrderShipmentsInitiallyLoading, listSalesOrderShipmentsIsFetching, orderSourceCode, pendingSalesOrderShipment, refetchSalesOrderShipments, salesOrder$1, salesOrderId, salesOrderShipmentCreated, shipFromAddresses === null || shipFromAddresses === void 0 ? void 0 : shipFromAddresses.length, shipmentId, useWarehouses, v1shipmentCreated, warehouseId, warehouses$1]);
+  }), [createV1ShipmentWithDefaults]);
   const refetchPendingSalesOrderShipments = React.useCallback(() => _tslib.__awaiter(void 0, void 0, void 0, function* () {
     const {
       data: shipments
@@ -180,13 +196,18 @@ const useConfigureShipment = ({
     errorCode: "invalid_status",
     errorSource: "elements",
     errorType: "business_rules"
-  })] : []), ...(incompleteRequirementsKeys.length > 0 ? [new reactApi.CodedError(incompleteRequirementsKeys.length > 1 ? "no_carriers_and_warehouses" : incompleteRequirementsKeys[0], {
+  })] : []), ...(incompleteRequirementsKeys.length > 0 ? [new reactApi.CodedError(incompleteRequirementsKeys.length === 1 ? "no_carriers_and_warehouses" : incompleteRequirementsKeys[0], {
     errorCode: "unknown",
     errorSource: "elements",
     errorType: "business_rules"
+  })] : []), ...((salesOrderShipments === null || salesOrderShipments === void 0 ? void 0 : salesOrderShipments.length) === 0 && shipmentId ? [new reactApi.CodedError("shipment_not_found", {
+    errorCode: "invalid_status",
+    errorSource: "elements",
+    errorType: "business_rules"
   })] : [])];
   return {
     carriers,
+    createNewShipmentForNotFound,
     errors: errors.length > 0 ? errors : undefined,
     isLoading: (isSalesOrderLoading || !(salesOrderShipments === null || salesOrderShipments === void 0 ? void 0 : salesOrderShipments.length) || creatingSalesOrderShipment) && errors.length === 0,
     refetchPendingSalesOrderShipments,

package/dist/cjs/hooks/use-helpers.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
 var reactApi = require('@shipengine/react-api');
+var address = require('../utilities/address.cjs');
 var checks = require('../utilities/checks.cjs');
 
 const useHelpers = () => {
@@ -17,7 +18,9 @@ const useHelpers = () => {
   return {
     helpersReady,
     sellerOnboarded,
-    validateShipFromAddress: checks.validateShipFromAddress
+    validateShipFromAddress: checks.validateShipFromAddress,
+    getCountries: address.getCountries,
+    getUsStates: address.getUsStates
   };
 };
 

package/dist/cjs/index.cjs

@@ -4,7 +4,8 @@ var reactApi = require('@shipengine/react-api');
 var styles = require('./utilities/styles.cjs');
 var featureFlags = require('./utilities/feature-flags/feature-flags.cjs');
 var checks = require('./utilities/checks.cjs');
-var address = require('./constants/shipengine/address.cjs');
+var address = require('./utilities/address.cjs');
+var address$1 = require('./constants/shipengine/address.cjs');
 var manageCarriers = require('./elements/manage-carriers/manage-carriers.cjs');
 var manageWarehouses = require('./elements/manage-warehouses/manage-warehouses.cjs');
 var purchaseLabel = require('./elements/purchase-label/purchase-label.cjs');
@@ -46,17 +47,19 @@ exports.getDefaultFeatures = featureFlags.getDefaultFeatures;
 exports.getSellerIdFromToken = checks.getSellerIdFromToken;
 exports.isOnboarded = checks.isOnboarded;
 exports.validateShipFromAddress = checks.validateShipFromAddress;
-exports.Country = address.Country;
-exports.UsState = address.UsState;
-exports.UsaCity = address.UsaCity;
-exports.addressNameRegex = address.addressNameRegex;
-exports.countries = address.countries;
-exports.countryCodes = address.countryCodes;
-exports.euCountryCodes = address.euCountryCodes;
-exports.postalCodeRegex = address.postalCodeRegex;
-exports.usCities = address.usCities;
-exports.usStateCodes = address.usStateCodes;
-exports.usStates = address.usStates;
+exports.getCountries = address.getCountries;
+exports.getUsStates = address.getUsStates;
+exports.Country = address$1.Country;
+exports.UsState = address$1.UsState;
+exports.UsaCity = address$1.UsaCity;
+exports.addressNameRegex = address$1.addressNameRegex;
+exports.countries = address$1.countries;
+exports.countryCodes = address$1.countryCodes;
+exports.euCountryCodes = address$1.euCountryCodes;
+exports.postalCodeRegex = address$1.postalCodeRegex;
+exports.usCities = address$1.usCities;
+exports.usStateCodes = address$1.usStateCodes;
+exports.usStates = address$1.usStates;
 exports.ManageCarriers = manageCarriers;
 exports.ManageWarehouses = manageWarehouses;
 exports.PurchaseLabel = purchaseLabel;

package/dist/cjs/locales/en/account-settings.json.cjs

@@ -26,6 +26,12 @@ var accoutSettings = {
 		labelLayout: "Shipping Label Layout",
 		unitSettings: "Units of Measure",
 		vatSettings: "Tax Settings"
+	},
+	errors: {
+		paymentMethod: {
+			title: "Error Updating Payment Method",
+			description: "There was an error updating your payment method. Ensure your payment information is correct and try again. If the problem persists, contact support at {{email}}."
+		}
 	}
 }
 };

package/dist/cjs/locales/en/common.json.cjs

@@ -165,10 +165,12 @@ var common = {
 		total: "Total"
 	},
 	errorMessages: {
+		fundingSourceCreationFailed: "Please check your payment and billing details, and confirm that your bank hasn’t blocked the payment method. If the issue persists, please contact support at {{email}}.",
 		contactSupport: "Your transaction may not have processed as expected. Please contact support at {{email}}.",
 		invalidNameOrCompany: "Recipient name and company name (if provided) must have two characters in first and last name.",
 		parsingFailure: "Parsing failed. Please check address and try again.",
 		incompleteLabelPurchaseRequirements: "Please add your {{requirements}} to continue purchasing a label.",
+		shipmentNotFound: "Cannot find shipment with ID: {{id}}.",
 		shipmentCancelled: "This shipment is Cancelled in ShipStation. Log into ShipStation to restore the order to Awaiting Shipment status.",
 		unableToLoad: {
 			accountSettings: "Unable to load account settings",

package/dist/cjs/locales/en/grid-controller.json.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+var gridController = {
+	"grid-controller": {
+	showExportCSV: {
+		button: "Export CSV",
+		"generic-error-message": "We couldn’t export your CSV. Please try again.",
+		"limit-error": "We're sorry, but exporting more than {{LIMIT_GRID_ITEMS_EXPORT}} items is not supported at this time."
+	}
+}
+};
+
+module.exports = gridController;

package/dist/cjs/locales/en/index.cjs

@@ -3,6 +3,7 @@
 var accountSettings = require('./account-settings.json.cjs');
 var common = require('./common.json.cjs');
 var connectCarrier = require('./connect-carrier.json.cjs');
+var gridController = require('./grid-controller.json.cjs');
 var listLabels = require('./list-labels.json.cjs');
 var listShipments = require('./list-shipments.json.cjs');
 var manageCarriers = require('./manage-carriers.json.cjs');
@@ -20,6 +21,6 @@ var viewShipment = require('./view-shipment.json.cjs');
 var voidLabel = require('./void-label.json.cjs');
 var walletHistory = require('./wallet-history.json.cjs');
 
-var en = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, accountSettings), common.default), connectCarrier), listLabels), listShipments), manageDefaults), manageDefaults), manageFunding), manageWarehouses), onboarding.default), paymentMethod), purchaseLabel), rateDetails), registerCarrier), registerWallet), manageCarriers), vatSettings), viewShipment), voidLabel), walletHistory);
+var en = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, accountSettings), common.default), connectCarrier), listLabels), listShipments), manageDefaults), manageDefaults), manageFunding), manageWarehouses), onboarding.default), paymentMethod), purchaseLabel), rateDetails), registerCarrier), registerWallet), manageCarriers), vatSettings), viewShipment), voidLabel), walletHistory), gridController);
 
 module.exports = en;

package/dist/cjs/locales/en/onboarding.json.cjs

@@ -26,6 +26,11 @@ var onboarding = {
 		title: "Activate ShipEngine Services",
 		subtitle: "Your account includes access to services from these partners."
 	},
+	upsDisclosure: {
+		title: "UPS Promotional Rates and Technology Agreements",
+		line1: "I have read and agree to the Terms and Conditions and the Privacy Policy, and I confirm that information I have provided is accurate and truthful.",
+		line2: "To start shipping with UPS, you must first agree to the following: UPS®, the UPS brandmark, UPS Ready® and the color brown are trademarks of the United Parcel Service of America, Inc. All Rights Reserved."
+	},
 	warehouse: {
 		title: "Ship From Address",
 		subtitle: "Enter your default Ship From Address",

package/dist/cjs/locales/en/purchase-label.json.cjs

@@ -12,7 +12,8 @@ var purchaseLabel = {
 		showItems: "Show items",
 		showMoreRates: "Show more rates",
 		showFewerRates: "Show fewer rates",
-		saveRate: "Save Rate"
+		saveRate: "Save Rate",
+		createNewShipment: "Create New Shipment"
 	},
 	balance: {
 		currentBalance: "Available Funds:",
@@ -129,7 +130,6 @@ var purchaseLabel = {
 		otherLocations: "Other drop off points near you:",
 		noServicePointsForService: "There are no drop off locations for this service within 10km of your search area.",
 		error: "Unable to find drop off locations within 10km of your search area.",
-		paperless: "Print & Paperless",
 		localTimeDisclaimer: "Hours shown in local time"
 	},
 	shipToAddressFormFields: "Ship To Address Form Fields",
@@ -143,7 +143,9 @@ var purchaseLabel = {
 	},
 	warnings: {
 		parcelGuardShipDate: "ParcelGuard must be purchased within 48 hours of the ship date. Please update the ship date to continue."
-	}
+	},
+	paperlessAvailable: "Paperless available",
+	usePaperlessLabel: "Use Paperless Label (QR Code)"
 }
 };
 

package/dist/cjs/package.json.cjs

@@ -1,5 +1,5 @@
 'use strict';
 
-var version = "2.24.1";
+var version = "2.26.0";
 
 exports.version = version;

package/dist/cjs/utilities/address.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+var address = require('../constants/shipengine/address.cjs');
+
+/**
+ * Returns a simplified list of countries for use in dropdowns and forms.
+ *
+ * @returns Array of country objects with name and code properties
+ */
+const getCountries = () => {
+  return address.countries.map(country => ({
+    name: country.name,
+    code: country.code
+  }));
+};
+/**
+ * Returns a simplified list of US states for use in dropdowns and forms.
+ *
+ * @returns Array of US state objects with name and code properties
+ */
+const getUsStates = () => {
+  return address.usStates.map(state => ({
+    name: state.name,
+    code: state.code
+  }));
+};
+
+exports.getCountries = getCountries;
+exports.getUsStates = getUsStates;

package/dist/cjs/utilities/files.cjs

@@ -0,0 +1,35 @@
+'use strict';
+
+/**
+ * Creates a local file from an AxiosResponse containing a blob.
+ */
+const createLocalFileFromBlobResponse = (type, {
+  data: blob
+}) => {
+  const url = URL.createObjectURL(new Blob([blob], {
+    type: blob.type
+  }));
+  const fileName = type === "label" ? "labels-download" : "shipments-download";
+  triggerDownload(url, fileName);
+};
+/**
+ * Triggers the download of the sent URL.
+ * @param {string} url - The URL for the download.
+ * @param {string} filename - The filename for the download.
+ */
+const triggerDownload = (url, filename) => {
+  const downloadLink = createInvisibleAnchor(url, filename);
+  document.body.appendChild(downloadLink);
+  downloadLink.click();
+  document.body.removeChild(downloadLink);
+};
+const createInvisibleAnchor = (url, filename) => {
+  const downloadLink = document.createElement("a");
+  downloadLink.setAttribute("href", url);
+  downloadLink.setAttribute("download", filename);
+  downloadLink.style.display = "none";
+  return downloadLink;
+};
+
+exports.createLocalFileFromBlobResponse = createLocalFileFromBlobResponse;
+exports.triggerDownload = triggerDownload;

package/dist/cjs/utilities/formatString.cjs

@@ -19,9 +19,18 @@ const replaceSpacesWithDashes = str => str === null || str === void 0 ? void 0 :
 const addSpaceBetweenWords = str => str.replace(/([a-z])([A-Z])/g, "$1 $2") // add space if there is a lowercase letter followed by an uppercase letter
 .replace(/(?<=[a-zA-Z])(\d)/g, " $1") // add space if there is a letter followed by a number
 .trim();
+/**
+ * Converts a string from camelCase or PascalCase to snake_case
+ *
+ * @example
+ * toSnakeCase("helloWorld") // returns "hello_world"
+ * toSnakeCase("HelloWorld") // returns "hello_world"
+ */
+const toSnakeCase = str => str.replace(/[A-Z]/g, letter => `_${letter.toLowerCase()}`);
 
 exports.addSpaceBetweenWords = addSpaceBetweenWords;
 exports.capitalizeFirstLetter = capitalizeFirstLetter;
 exports.capitalizeFirstLetterOfEachWord = capitalizeFirstLetterOfEachWord;
 exports.pascalize = pascalize;
 exports.replaceSpacesWithDashes = replaceSpacesWithDashes;
+exports.toSnakeCase = toSnakeCase;

package/dist/cjs/utilities/index.cjs

@@ -2,6 +2,8 @@
 
 var styles = require('./styles.cjs');
 var checks = require('./checks.cjs');
+var files = require('./files.cjs');
+var address = require('./address.cjs');
 var featureFlags = require('./feature-flags/feature-flags.cjs');
 
 
@@ -11,4 +13,7 @@ exports.scopeTheme = styles.scopeTheme;
 exports.getSellerIdFromToken = checks.getSellerIdFromToken;
 exports.isOnboarded = checks.isOnboarded;
 exports.validateShipFromAddress = checks.validateShipFromAddress;
+exports.createLocalFileFromBlobResponse = files.createLocalFileFromBlobResponse;
+exports.getCountries = address.getCountries;
+exports.getUsStates = address.getUsStates;
 exports.getDefaultFeatures = featureFlags.getDefaultFeatures;

package/dist/cjs/utilities/money.cjs

@@ -38,6 +38,19 @@ const calculateTotal = (...values) => {
     return value ? total + ((_a = value.amount) !== null && _a !== void 0 ? _a : 0) : total;
   }, 0);
 };
+/**
+ * @internal
+ *
+ * # Money Utils - maskCreditCardNumber
+ */
+const maskCreditCardNumber = cc => {
+  const sanitizedCC = cc.replace(/\s/g, "");
+  if (!sanitizedCC || sanitizedCC.length < 15 || sanitizedCC.length > 16) {
+    return cc;
+  }
+  const maskedCCNumber = "*".repeat(sanitizedCC.length - 4) + sanitizedCC.slice(-4);
+  return maskedCCNumber.replace(/(.{4})/g, "$1 ").trim();
+};
 /**
  * @internal
  *
@@ -103,3 +116,4 @@ exports.formatExpiration = formatExpiration;
 exports.formatMoney = formatMoney;
 exports.getCurrencyFromString = getCurrencyFromString;
 exports.getCurrencySymbolFromString = getCurrencySymbolFromString;
+exports.maskCreditCardNumber = maskCreditCardNumber;

package/dist/cjs/utilities/rate-warning-messages.cjs

@@ -0,0 +1,25 @@
+'use strict';
+
+var rateMessages = require('../data/rate-messages.json.cjs');
+
+/**
+ * Builds warning messages for a rate by combining messages from different sources:
+ * 1. Messages for serviceCode:shipDay combination
+ * 2. Messages for serviceCode:packageType combination
+ * 3. Messages for serviceCode only
+ * 4. Existing warning messages from the rate
+ */
+const buildRateWarningMessages = ({
+  serviceCode,
+  packageType,
+  shipDay,
+  existingWarningMessages = []
+}) => {
+  const keys = [shipDay && `${serviceCode}:${shipDay}`, packageType && `${serviceCode}:${packageType}`, serviceCode].filter(Boolean);
+  return [...keys.flatMap(key => {
+    var _a;
+    return (_a = rateMessages.default[key]) !== null && _a !== void 0 ? _a : [];
+  }), ...existingWarningMessages];
+};
+
+exports.buildRateWarningMessages = buildRateWarningMessages;

package/dist/cjs/utilities/shipengine/warehouses.cjs

@@ -1,7 +1,8 @@
 'use strict';
 
 const getDefaultWarehouse = warehouses => {
-  return warehouses === null || warehouses === void 0 ? void 0 : warehouses.find(w => w.isDefault);
+  var _a;
+  return (_a = warehouses === null || warehouses === void 0 ? void 0 : warehouses.find(w => w.isDefault)) !== null && _a !== void 0 ? _a : warehouses === null || warehouses === void 0 ? void 0 : warehouses[0];
 };
 const getWarehouseById = (warehouseId, warehouses) => {
   return warehouses === null || warehouses === void 0 ? void 0 : warehouses.find(w => w.warehouseId === warehouseId);

package/dist/cjs/workflows/connect-external-carrier/connect-external-carrier.cjs

@@ -85,7 +85,7 @@ const Component = ({
     refetch: refetchSchema
   } = reactApi.useGetCarrierConnectionForm({
     carrierName: selectedCarrier !== null && selectedCarrier !== void 0 ? selectedCarrier : "apicode-dummy-carrier",
-    enabled: false
+    enabled: !!selectedCarrier
   });
   React.useEffect(() => {
     if (selectedCarrier && needsRefetch) {
@@ -152,7 +152,9 @@ const Component = ({
       const updatedSchema = Object.assign({}, schema);
       // camelize required fields, as casing varies between carriers
       if (updatedSchema.required && Array.isArray(updatedSchema.required)) {
-        updatedSchema.required = updatedSchema.required.map(humps__namespace.camelize);
+        updatedSchema.required = updatedSchema.required.map(item => {
+          return typeof item === "string" ? humps__namespace.camelize(item) : item;
+        });
       }
       // camelize property keys
       // fail safe to ensure schema properties and required array match in the event the camelizeKeys from shipengine/js-api isn't consistent
@@ -174,7 +176,9 @@ const Component = ({
     const updatedUiSchema = Object.assign({}, uiSchemaClone);
     // add nickname to ui:order and camelize the values to ensure consistency with jsonSchema properties and required array
     if (!hasNicknameProperty && updatedUiSchema["ui:order"]) {
-      updatedUiSchema["ui:order"] = [...updatedUiSchema["ui:order"], "nickname"].map(humps__namespace.camelize);
+      // ui:order is typically an array of strings, but apparently can also be an array of arrays of strings, so we need to recursively camelize the items
+      const camelizeUIOrderItem = item => typeof item === "string" ? humps__namespace.camelize(item) : item.map(i => humps__namespace.camelize(i));
+      updatedUiSchema["ui:order"] = [...updatedUiSchema["ui:order"], "nickname"].map(camelizeUIOrderItem);
     }
     return updatedUiSchema;
   }, [uiSchema, hasNicknameProperty]);