@shipengine/elements 2.26.5 → 2.28.0

package/dist/cjs/hooks/use-import-sales-order.cjs

@@ -5,26 +5,49 @@ var reactApi = require('@shipengine/react-api');
 var reactQuery = require('@tanstack/react-query');
 var React = require('react');
 
+/**
+ * Imports and retrieves sales orders by either:
+ * - Sales order ID lookup
+ * - External order ID/number search
+ *
+ * 1. First attempts to find the sales order using provided identifiers
+ * 2. If no order is found and initial fetches have run, automatically refreshes order sources
+ * 3. Invalidates relevant queries after successful refresh to refetch updated data
+ *
+ * @returns Object:
+ * - `salesOrder`: The found sales order, or undefined
+ * - `isLoading`: Boolean indicating if the hook is currently loading data
+ * - `errors`: Array of errors from failed queries, or undefined
+ */
 const useImportSalesOrder = ({
   enabled,
   externalOrderId,
+  externalOrderNumber,
   orderSourceCode,
   salesOrderId
 }) => {
   var _a, _b, _c;
   const queryClient = reactQuery.useQueryClient();
   const [refreshAttempted, setRefreshAttempted] = React.useState(false);
-  // attempt to get sales order through external id means
-  const orderByExternalIdQuery = reactApi.useGetSalesOrderByExternalOrderId(externalOrderId, {
-    enabled: enabled && !!externalOrderId && !salesOrderId
+  // Fetch sales order by External Order ID or External Order Number
+  const salesOrderByExternalIdQuery = reactApi.useListSalesOrders({
+    externalOrderId,
+    externalOrderNumber
   });
   // if an order was found through external search disable this query
-  const orderByIdQuery = reactApi.useGetSalesOrder(salesOrderId, {
+  const salesOrderByIdQuery = reactApi.useGetSalesOrder(salesOrderId, {
     enabled: enabled && !!salesOrderId
   });
-  const salesOrder = React.useMemo(() => salesOrderId ? orderByIdQuery.data : orderByExternalIdQuery.data, [salesOrderId, orderByIdQuery.data, orderByExternalIdQuery.data]);
+  const salesOrder = React.useMemo(() => {
+    if (salesOrderId) {
+      return salesOrderByIdQuery.data;
+    } else if (salesOrderByExternalIdQuery.data && salesOrderByExternalIdQuery.data.length > 0) {
+      return salesOrderByExternalIdQuery.data[0];
+    }
+    return undefined;
+  }, [salesOrderId, salesOrderByIdQuery.data, salesOrderByExternalIdQuery.data]);
   // Determine if the initial fetch attempts (if applicable) have settled without finding data
-  const initialFetchSettled = (salesOrderId ? !orderByIdQuery.isInitialLoading && !orderByIdQuery.isFetching : true) && (externalOrderId && !salesOrderId ? !orderByExternalIdQuery.isLoading && !orderByExternalIdQuery.isFetching : true);
+  const initialFetchSettled = (salesOrderId ? !salesOrderByIdQuery.isInitialLoading && !salesOrderByIdQuery.isFetching : true) && ((externalOrderNumber || externalOrderId) && !salesOrderId ? !salesOrderByExternalIdQuery.isLoading && !salesOrderByExternalIdQuery.isFetching : true);
   const shouldAttemptRefresh = enabled && initialFetchSettled && !salesOrder && !refreshAttempted;
   const listOrderSourcesQuery = reactApi.useListOrderSources({
     enabled: shouldAttemptRefresh
@@ -34,6 +57,17 @@ const useImportSalesOrder = ({
     isLoading: isRefreshingOrderSource,
     mutateAsync: refreshOrderSource
   } = reactApi.useRefreshOrderSource();
+  const invalidateSalesOrderQueries = React.useCallback(() => {
+    if (salesOrderId) {
+      void queryClient.invalidateQueries({
+        queryKey: ["useGetSalesOrder", salesOrderId]
+      });
+    } else if (externalOrderId || externalOrderNumber) {
+      void queryClient.invalidateQueries({
+        queryKey: ["useListSalesOrders", externalOrderId, externalOrderNumber]
+      });
+    }
+  }, [queryClient, salesOrderId, externalOrderId, externalOrderNumber]);
   React.useEffect(() => {
     if (listOrderSourcesQuery.isSuccess && listOrderSourcesQuery.data && shouldAttemptRefresh && !isRefreshingOrderSource) {
       const orderSourcesToRefresh = orderSourceCode ? listOrderSourcesQuery.data.filter(o => o.orderSourceCode.includes(orderSourceCode) && o.active) : listOrderSourcesQuery.data.filter(o => o.active);
@@ -41,29 +75,20 @@ const useImportSalesOrder = ({
         setRefreshAttempted(true);
         void (() => _tslib.__awaiter(void 0, void 0, void 0, function* () {
           yield Promise.all(orderSourcesToRefresh.map(o => refreshOrderSource(o.orderSourceId, {
-            // Invalidate relevant queries on successful refresh
+            // Invalidate relevant queries
             onSuccess: () => {
-              if (salesOrderId) {
-                void queryClient.invalidateQueries({
-                  queryKey: ["useGetSalesOrder", salesOrderId]
-                });
-              }
-              if (externalOrderId && !salesOrderId) {
-                void queryClient.invalidateQueries({
-                  queryKey: ["useGetSalesOrderByExternalOrderId", externalOrderId]
-                });
-              }
+              invalidateSalesOrderQueries();
             }
           })));
         }))();
       }
     }
   }, [externalOrderId, isRefreshingOrderSource, listOrderSourcesQuery.data, listOrderSourcesQuery.isSuccess, orderSourceCode, queryClient, refreshOrderSource, salesOrderId, shouldAttemptRefresh]);
-  const isLoading = orderByIdQuery.isInitialLoading || orderByExternalIdQuery.isInitialLoading || listOrderSourcesQuery.isInitialLoading || isRefreshingOrderSource;
-  const errors = [...((_a = orderByIdQuery.error) !== null && _a !== void 0 ? _a : []), ...((_b = orderByExternalIdQuery.error) !== null && _b !== void 0 ? _b : []), ...((_c = listOrderSourcesQuery.error) !== null && _c !== void 0 ? _c : []), ...(refreshOrderSourceErrors !== null && refreshOrderSourceErrors !== void 0 ? refreshOrderSourceErrors : [])];
+  const isLoading = salesOrderByIdQuery.isInitialLoading || salesOrderByExternalIdQuery.isInitialLoading || listOrderSourcesQuery.isInitialLoading || isRefreshingOrderSource;
+  const errors = [...((_a = salesOrderByIdQuery.error) !== null && _a !== void 0 ? _a : []), ...((_b = salesOrderByExternalIdQuery.error) !== null && _b !== void 0 ? _b : []), ...((_c = listOrderSourcesQuery.error) !== null && _c !== void 0 ? _c : []), ...(refreshOrderSourceErrors !== null && refreshOrderSourceErrors !== void 0 ? refreshOrderSourceErrors : [])];
   return {
     errors: errors.length > 0 ? errors : undefined,
-    isLoading,
+    isLoading: isLoading && errors.length === 0,
     salesOrder
   };
 };

package/dist/cjs/hooks/use-manage-funding-source-insurance.cjs

@@ -2,14 +2,16 @@
 
 var _tslib = require('../_virtual/_tslib.cjs');
 var reactApi = require('@shipengine/react-api');
+var insurance = require('../utilities/shipengine/insurance.cjs');
 var React = require('react');
 var elementsContextProvider = require('../elements-provider/elements-context-provider.cjs');
 
 const useManageFundingSourceInsurance = () => {
-  var _a;
+  var _a, _b;
   const {
     globalFeatures: {
-      enableParcelGuard
+      enableParcelGuard,
+      enableXCover
     }
   } = elementsContextProvider.useElements();
   const {
@@ -21,25 +23,12 @@ const useManageFundingSourceInsurance = () => {
     data: insuranceAcceptedTerms,
     isLoading: loadingInsuranceAcceptedTerms
   } = reactApi.useGetInsuranceFundingSourceAcceptedTerms({
-    enabled: enableParcelGuard
+    enabled: enableParcelGuard || enableXCover
   });
   const insuranceProviderProfiles = React.useMemo(() => {
     var _a;
-    return (_a = fundingSourceMetadata === null || fundingSourceMetadata === void 0 ? void 0 : fundingSourceMetadata.data) === null || _a === void 0 ? void 0 : _a.defaultFundingSourceProfile.optionalTerms.map(terms => {
-      const providerLookup = {
-        parcelguard_terms: "parcelguard"
-      };
-      const friendlyNameLookup = {
-        parcelguard_terms: "ParcelGuard"
-      };
-      const provider = providerLookup[terms.termType];
-      const friendlyName = friendlyNameLookup[terms.termType];
-      return {
-        friendlyName,
-        provider,
-        terms
-      };
-    });
+    const optionalTerms = (_a = fundingSourceMetadata === null || fundingSourceMetadata === void 0 ? void 0 : fundingSourceMetadata.data) === null || _a === void 0 ? void 0 : _a.defaultFundingSourceProfile.optionalTerms;
+    return insurance.groupTermsByProvider(optionalTerms);
   }, [fundingSourceMetadata]);
   const {
     mutateAsync: registerCarrier
@@ -79,12 +68,15 @@ const useManageFundingSourceInsurance = () => {
     }
   }), [fundingSources, insuranceProviderProfiles, registerCarrier]);
   const hasInsuranceToRegister = React.useMemo(() => {
-    return enableParcelGuard &&
-    // has insurance provider profiles but none have been accepted AND has a funding source
-    !!(insuranceProviderProfiles === null || insuranceProviderProfiles === void 0 ? void 0 : insuranceProviderProfiles.length) && (insuranceAcceptedTerms === null || insuranceAcceptedTerms === void 0 ? void 0 : insuranceAcceptedTerms.acceptedTerms.length) === 0 && !!(fundingSources === null || fundingSources === void 0 ? void 0 : fundingSources.length);
-  }, [enableParcelGuard, insuranceProviderProfiles === null || insuranceProviderProfiles === void 0 ? void 0 : insuranceProviderProfiles.length, insuranceAcceptedTerms === null || insuranceAcceptedTerms === void 0 ? void 0 : insuranceAcceptedTerms.acceptedTerms.length, fundingSources === null || fundingSources === void 0 ? void 0 : fundingSources.length]);
+    var _a, _b;
+    const isProviderEnabled = insurance.getIsFundingSourceInsuranceProviderEnabledAndSupported(insuranceProviderProfiles, enableXCover, enableParcelGuard);
+    const hasProfiles = Boolean(insuranceProviderProfiles === null || insuranceProviderProfiles === void 0 ? void 0 : insuranceProviderProfiles.length);
+    const hasNoAcceptedTerms = ((_b = (_a = insuranceAcceptedTerms === null || insuranceAcceptedTerms === void 0 ? void 0 : insuranceAcceptedTerms.acceptedTerms) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0) === 0;
+    const hasFundingSources = Boolean(fundingSources === null || fundingSources === void 0 ? void 0 : fundingSources.length);
+    return isProviderEnabled && hasProfiles && hasNoAcceptedTerms && hasFundingSources;
+  }, [insuranceProviderProfiles, enableXCover, enableParcelGuard, (_a = insuranceAcceptedTerms === null || insuranceAcceptedTerms === void 0 ? void 0 : insuranceAcceptedTerms.acceptedTerms) === null || _a === void 0 ? void 0 : _a.length, fundingSources === null || fundingSources === void 0 ? void 0 : fundingSources.length]);
   return {
-    fundingSourceCountryCode: (_a = fundingSourceMetadata === null || fundingSourceMetadata === void 0 ? void 0 : fundingSourceMetadata.data) === null || _a === void 0 ? void 0 : _a.defaultFundingSourceProfile.countryCode,
+    fundingSourceCountryCode: (_b = fundingSourceMetadata === null || fundingSourceMetadata === void 0 ? void 0 : fundingSourceMetadata.data) === null || _b === void 0 ? void 0 : _b.defaultFundingSourceProfile.countryCode,
     hasInsuranceToRegister,
     insuranceAcceptedTerms: insuranceAcceptedTerms === null || insuranceAcceptedTerms === void 0 ? void 0 : insuranceAcceptedTerms.acceptedTerms,
     insuranceProviderProfiles,

package/dist/cjs/index.cjs

@@ -22,6 +22,8 @@ var selectLabelLayoutElement = require('./elements/select-label-layout/select-la
 var paymentMethodSettingsElement = require('./elements/payment-method-settings/payment-method-settings-element.cjs');
 var carrierServices = require('./workflows/carrier-services/carrier-services.cjs');
 var transactionHistoryElement = require('./elements/transaction-history/transaction-history-element.cjs');
+var customsFormElement = require('./elements/customs-form/customs-form-element.cjs');
+var customsFormTypes = require('./elements/customs-form/customs-form-types.cjs');
 var useAddressValidation = require('./hooks/use-address-validation.cjs');
 var useHelpers = require('./hooks/use-helpers.cjs');
 var useConfigureShipment = require('./hooks/use-configure-shipment.cjs');
@@ -77,6 +79,9 @@ exports.SelectLabelLayout = selectLabelLayoutElement;
 exports.PaymentMethodSettings = paymentMethodSettingsElement;
 exports.CarrierServices = carrierServices;
 exports.TransactionHistory = transactionHistoryElement;
+exports.CustomsForm = customsFormElement;
+exports.extractCustomsFormData = customsFormTypes.extractCustomsFormData;
+exports.getDefaultCustomsFormValues = customsFormTypes.getDefaultCustomsFormValues;
 exports.useAddressValidation = useAddressValidation.useAddressValidation;
 exports.useHelpers = useHelpers.useHelpers;
 exports.useConfigureShipment = useConfigureShipment.useConfigureShipment;

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

@@ -248,7 +248,7 @@ var common = {
 		parcelguard: "ParcelGuard",
 		shipsurance: "Shipsurance",
 		thirdParty: "Third Party",
-		x_cover: "XCover"
+		xCover: "XCover"
 	},
 	loading: {
 		accountSettings: "Loading account settings...",

package/dist/cjs/locales/en/list-labels.json.cjs

@@ -3,12 +3,13 @@
 var listLabels = {
 	"list-labels": {
 	title: "List Labels",
+	none: "None",
 	headers: {
 		created: "Created Date",
 		shipmentId: "Shipment ID",
 		parcels: "Parcels",
 		recipient: "Recipient",
-		shipping: "Shipping",
+		service: "Service",
 		shipDate: "Ship Date",
 		status: "Label Status",
 		trackingStatus: "Delivery Status",

package/dist/cjs/locales/en/list-shipments.json.cjs

@@ -7,7 +7,7 @@ var listShipments = {
 	headers: {
 		created: "Created Date",
 		modified: "Modified Date",
-		shipping: "Shipping",
+		service: "Service",
 		shipmentId: "Shipment ID",
 		parcels: "Parcels",
 		recipient: "Recipient",

package/dist/cjs/locales/en/manage-warehouses.json.cjs

@@ -7,6 +7,8 @@ var manageWarehouses = {
 	editWarehouse: "Edit Address",
 	contactName: "Contact Name",
 	"default": "Default",
+	forcedDefault: "This is your default Ship From Address",
+	forcedDefaultNew: "This will be your default Ship From Address",
 	isDefault: "Set as default Ship From address",
 	locationName: "Location Name",
 	residentialAddress: "Residential Address",

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

@@ -93,7 +93,15 @@ var purchaseLabel = {
 		rateSavings: "Save ${{amount}}",
 		upsGroundSaverTermsAcknowledgement: "To start shipping with UPS Ground Saver, you are confirming that you have agreed to the <1>terms and conditions</1>",
 		dhlExpressTermsAcknowledgement: "To start shipping with DHL, you are confirming that you have agreed to the <1>terms and conditions</1>",
-		noRateService: "Rate and services will be billed based on carrier."
+		noRateService: "Rate and services will be billed based on carrier.",
+		rateAttributes: {
+			bestValue: "Best Value",
+			cheapest: "Cheapest",
+			fastest: "Fastest",
+			bestValueTooltip: "Lowest cost option arriving on a specified date within 4 days, with free carrier coverage up to $100 and a free dropoff option.",
+			cheapestTooltip: "Lowest cost option.",
+			fastestTooltip: "Fastest delivery option."
+		}
 	},
 	windsorFramework: {
 		movementIndicator: "Movement Indicator",

package/dist/cjs/package.json.cjs

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

package/dist/cjs/utilities/feature-flags/feature-flags.cjs

@@ -28,6 +28,7 @@ const defaultFeatureFlags = {
   globalFeatures: {
     disableShadowDOM: false,
     enableParcelGuard: true,
+    enableXCover: false,
     isSandbox: false,
     poweredByShipEngine: true,
     showVatSettings: false,
@@ -50,7 +51,8 @@ const defaultFeatureFlags = {
       labelLayout: false,
       nicknameRate: true,
       requireDhlTermsAcknowledgement: false,
-      saveRate: true
+      saveRate: true,
+      showMediaMail: false
     },
     shipmentForm: {
       addOns: true,

package/dist/cjs/utilities/shipengine/carrier.cjs

@@ -2,6 +2,7 @@
 
 var icon = require('../../assets/parcelguard/icon.svg.cjs');
 var logo = require('../../assets/parcelguard/logo.svg.cjs');
+var logo$1 = require('../../assets/xcover/logo.svg.cjs');
 
 const USPS_CARRIER_CODES = ["usps", "stamps_com"];
 /**
@@ -59,6 +60,9 @@ const getLogoOrIconByCarrierCode = (carrierCode, type) => {
   if (carrierCode === "parcelguard") {
     return type === "logo" ? logo : icon;
   }
+  if (carrierCode === "xcover") {
+    return logo$1;
+  }
   const carrierCodeOverrides = {
     stamps_com: "stamps_com_wl",
     usps: "stamps_com_wl"

package/dist/cjs/utilities/shipengine/index.cjs

@@ -54,5 +54,8 @@ exports.isMetricWeightUnit = weight.isMetricWeightUnit;
 exports.isFlatRatePackageCode = _package.isFlatRatePackageCode;
 exports.getDefaultWarehouse = warehouses.getDefaultWarehouse;
 exports.getWarehouseById = warehouses.getWarehouseById;
+exports.filterProfilesByAcceptedTerms = insurance.filterProfilesByAcceptedTerms;
 exports.getInsuranceProviderWithFriendlyName = insurance.getInsuranceProviderWithFriendlyName;
+exports.getIsFundingSourceInsuranceProviderEnabledAndSupported = insurance.getIsFundingSourceInsuranceProviderEnabledAndSupported;
 exports.getIsInsuraceProviderAccepted = insurance.getIsInsuraceProviderAccepted;
+exports.groupTermsByProvider = insurance.groupTermsByProvider;

package/dist/cjs/utilities/shipengine/insurance.cjs

@@ -12,6 +12,22 @@ var insuranceProviderMetadatas = require('../../data/insurance-provider-metadata
 const getInsuranceProviderWithFriendlyName = termType => {
   return insuranceProviderMetadatas.default[termType];
 };
+/**
+ * @internal
+ *
+ * # Insurance Utilities - getIsFundingSourceInsuranceProviderEnabledAndSupported
+ *
+ * Determines if any insurance providers are enabled and supported based on feature flags and funding source data.
+ *
+ * @category Utilities
+ */
+const getIsFundingSourceInsuranceProviderEnabledAndSupported = (insuranceProviders, xcoverEnabled, parcelguardEnabled) => {
+  if (!(insuranceProviders === null || insuranceProviders === void 0 ? void 0 : insuranceProviders.length)) return false;
+  const supportedProviders = insuranceProviders.map(p => p.provider);
+  if (xcoverEnabled && supportedProviders.includes("xcover")) return true;
+  if (parcelguardEnabled && supportedProviders.includes("parcelguard")) return true;
+  return false;
+};
 /**
  * @internal
  *
@@ -22,6 +38,53 @@ const getInsuranceProviderWithFriendlyName = termType => {
 const getIsInsuraceProviderAccepted = (termType, acceptedTerms) => {
   return !!(acceptedTerms === null || acceptedTerms === void 0 ? void 0 : acceptedTerms.map(t => t.termType).includes(termType));
 };
+/**
+ * @internal
+ *
+ * # Insurance Utilities - groupTermsByProvider
+ *
+ * Groups optional terms by insurance provider, creating InsuranceProviderProfile objects.
+ *
+ * @category Utilities
+ */
+const groupTermsByProvider = optionalTerms => {
+  if (!optionalTerms) return [];
+  // Group terms by provider
+  const providerTermsMap = new Map();
+  optionalTerms.forEach(term => {
+    const providerInfo = getInsuranceProviderWithFriendlyName(term.termType);
+    if (providerInfo === null || providerInfo === void 0 ? void 0 : providerInfo.provider) {
+      const existingTerms = providerTermsMap.get(providerInfo.provider) || [];
+      providerTermsMap.set(providerInfo.provider, [...existingTerms, term]);
+    }
+  });
+  // Convert Map to InsuranceProviderProfile array
+  return Array.from(providerTermsMap.entries()).map(([, terms]) => {
+    const providerInfo = getInsuranceProviderWithFriendlyName(terms[0].termType);
+    return Object.assign(Object.assign({}, providerInfo), {
+      terms
+    });
+  });
+};
+/**
+ * @internal
+ *
+ * # Insurance Utilities - filterProfilesByAcceptedTerms
+ *
+ * Filters insurance provider profiles to exclude those that have already been accepted.
+ *
+ * @category Utilities
+ */
+const filterProfilesByAcceptedTerms = (profiles, acceptedTerms) => {
+  if (!(acceptedTerms === null || acceptedTerms === void 0 ? void 0 : acceptedTerms.length)) return profiles;
+  const connectedTermTypes = new Set(acceptedTerms.map(t => t.termType));
+  return profiles.filter(profile => {
+    return !profile.terms.some(term => connectedTermTypes.has(term.termType));
+  });
+};
 
+exports.filterProfilesByAcceptedTerms = filterProfilesByAcceptedTerms;
 exports.getInsuranceProviderWithFriendlyName = getInsuranceProviderWithFriendlyName;
+exports.getIsFundingSourceInsuranceProviderEnabledAndSupported = getIsFundingSourceInsuranceProviderEnabledAndSupported;
 exports.getIsInsuraceProviderAccepted = getIsInsuraceProviderAccepted;
+exports.groupTermsByProvider = groupTermsByProvider;

package/dist/cjs/workflows/onboarding/components/confirmation-and-submission-step/use-confirmation-and-submission-step.cjs

@@ -107,12 +107,12 @@ const useConfirmationAndSubmissionStep = ({
     iovationBlackbox
   }) {
     const addressToRegister = address !== null && address !== void 0 ? address : defaultWarehouse.originAddress;
-    // parcel guard check
-    const insuranceProviders = globalFeatures.enableParcelGuard ? insuranceProviderProfiles === null || insuranceProviderProfiles === void 0 ? void 0 : insuranceProviderProfiles.map(p => ({
-      acceptedTerms: [{
-        termType: p.terms.termType,
-        version: p.terms.version
-      }],
+    // funding source insurance check
+    const insuranceProviders = globalFeatures.enableParcelGuard || globalFeatures.enableXCover ? insuranceProviderProfiles === null || insuranceProviderProfiles === void 0 ? void 0 : insuranceProviderProfiles.map(p => ({
+      acceptedTerms: p.terms.map(term => ({
+        termType: term.termType,
+        version: term.version
+      })),
       agreeToTerms: true,
       fundingSourceId,
       provider: p.provider
@@ -146,7 +146,7 @@ const useConfirmationAndSubmissionStep = ({
       console.error(error);
       throw error;
     }
-  }), [registerCarrier, globalFeatures.enableParcelGuard]);
+  }), [globalFeatures.enableParcelGuard, globalFeatures.enableXCover, registerCarrier]);
   const onboardSeller = React.useCallback(({
     carrierProfiles,
     fundingSourceRequiredTerms,
@@ -205,7 +205,7 @@ const useConfirmationAndSubmissionStep = ({
           yield createHandleCarrierConnections({
             carrierProfiles,
             defaultWarehouse: warehouse,
-            insuranceProviderProfiles: globalFeatures.enableParcelGuard ? insuranceProviderProfiles : undefined
+            insuranceProviderProfiles
           })(fundingSource.fundingSource.fundingSourceId, {
             iovationBlackbox
           });
@@ -215,7 +215,7 @@ const useConfirmationAndSubmissionStep = ({
         }
       }
     }
-  }), [addSandboxCarriers, createFundingSource, createHandleCarrierConnections, createOrUpdateWarehouse, getToken, globalFeatures.enableParcelGuard, globalFeatures.isSandbox]);
+  }), [addSandboxCarriers, createFundingSource, createHandleCarrierConnections, createOrUpdateWarehouse, getToken, globalFeatures.isSandbox]);
   const updateExistingFundingSource = React.useCallback(({
     carrierProfiles,
     fundingSource,

package/dist/cjs/workflows/onboarding/components/ship-from-address-step/ship-from-address-step.cjs

@@ -45,7 +45,7 @@ const ShipFromAddressStep = ({
     }), jsxRuntime.jsx(warehouseForm.WarehouseForm, {
       onSubmit: onSubmit,
       requireEmail: true,
-      shouldForceDefault: (pendingWarehouse === null || pendingWarehouse === void 0 ? void 0 : pendingWarehouse.isDefault) || (pendingShipFrom === null || pendingShipFrom === void 0 ? void 0 : pendingShipFrom.isDefault),
+      shouldForceDefault: true,
       submitButtonTitle: t("actions.continue"),
       useStrictSchema: true,
       warehouse: pendingWarehouse !== null && pendingWarehouse !== void 0 ? pendingWarehouse : pendingShipFrom

package/dist/cjs/workflows/onboarding/components/terms-agreement-form/terms-agreement-form.cjs

@@ -30,7 +30,8 @@ const TermsAgreementForm = ({
   } = reactI18next.useTranslation();
   const {
     globalFeatures: {
-      enableParcelGuard
+      enableParcelGuard,
+      enableXCover
     }
   } = elementsContextProvider.useElements();
   const [showTerms, setShowTerms] = React.useState(false);
@@ -109,7 +110,7 @@ const TermsAgreementForm = ({
           }), carrierTerms.map((term, idx) => jsxRuntime.jsx(displayTerm.DisplayTerm, {
             terms: term
           }, idx))]
-        }), enableParcelGuard && !!insuranceProviderTerms.length && jsxRuntime.jsxs(jsxRuntime.Fragment, {
+        }), (enableParcelGuard || enableXCover) && !!insuranceProviderTerms.length && jsxRuntime.jsxs(jsxRuntime.Fragment, {
           children: [jsxRuntime.jsx(spacer.Spacer, {}), jsxRuntime.jsx(giger.Typography, {
             bold: true,
             variant: "body1",

package/dist/cjs/workflows/onboarding/components/terms-agreement-step/terms-agreement-step.cjs

@@ -22,13 +22,14 @@ const TermsAgreementStep = ({
   fundingSourceRequiredTerms,
   showStampsLogo = false
 }) => {
-  var _a, _b, _c, _d, _e;
+  var _a, _b, _c, _d, _e, _f;
   const {
     t
   } = reactI18next.useTranslation("onboarding");
   const {
     globalFeatures: {
-      enableParcelGuard
+      enableParcelGuard,
+      enableXCover
     }
   } = elementsContextProvider.useElements();
   const carrierFriendlyNames = useCarrierMetadata.useCarrierMetadata();
@@ -41,11 +42,12 @@ const TermsAgreementStep = ({
     };
   });
   const insuranceProviderTerms = (_a = insuranceProviderProfiles === null || insuranceProviderProfiles === void 0 ? void 0 : insuranceProviderProfiles.flatMap(p => p.terms)) !== null && _a !== void 0 ? _a : [];
-  const showParcelGuard = enableParcelGuard && ((_b = insuranceProviderProfiles === null || insuranceProviderProfiles === void 0 ? void 0 : insuranceProviderProfiles.length) !== null && _b !== void 0 ? _b : 0) > 0;
-  const hasInsuranceToRegister = showParcelGuard && ((_c = insuranceProviderProfiles === null || insuranceProviderProfiles === void 0 ? void 0 : insuranceProviderProfiles.length) !== null && _c !== void 0 ? _c : 0) > 0;
+  const showParcelGuard = enableParcelGuard && ((_b = insuranceProviderProfiles === null || insuranceProviderProfiles === void 0 ? void 0 : insuranceProviderProfiles[0]) === null || _b === void 0 ? void 0 : _b.friendlyName) === "ParcelGuard";
+  const showXCover = enableXCover && ((_c = insuranceProviderProfiles === null || insuranceProviderProfiles === void 0 ? void 0 : insuranceProviderProfiles[0]) === null || _c === void 0 ? void 0 : _c.friendlyName) === "XCover";
+  const hasInsuranceToRegister = (showParcelGuard || showXCover) && ((_d = insuranceProviderProfiles === null || insuranceProviderProfiles === void 0 ? void 0 : insuranceProviderProfiles.length) !== null && _d !== void 0 ? _d : 0) > 0;
   const hasEnabledCarriersConfigurationError = !showStampsLogo && (!enabledCarrierProfiles || (enabledCarrierProfiles === null || enabledCarrierProfiles === void 0 ? void 0 : enabledCarrierProfiles.length) === 0);
-  const hasAlreadyConnectedCarriers = ((_d = enabledCarrierProfiles === null || enabledCarrierProfiles === void 0 ? void 0 : enabledCarrierProfiles.length) !== null && _d !== void 0 ? _d : 0) > 0 && carrierProfilesToRegister.length === 0 && (insuranceProviderProfiles === null || insuranceProviderProfiles === void 0 ? void 0 : insuranceProviderProfiles.length) === 0;
-  const hasCarriersToRegister = ((_e = enabledCarrierProfiles === null || enabledCarrierProfiles === void 0 ? void 0 : enabledCarrierProfiles.length) !== null && _e !== void 0 ? _e : 0) > 0 && carrierProfilesToRegister.length > 0;
+  const hasAlreadyConnectedCarriers = ((_e = enabledCarrierProfiles === null || enabledCarrierProfiles === void 0 ? void 0 : enabledCarrierProfiles.length) !== null && _e !== void 0 ? _e : 0) > 0 && carrierProfilesToRegister.length === 0 && (insuranceProviderProfiles === null || insuranceProviderProfiles === void 0 ? void 0 : insuranceProviderProfiles.length) === 0;
+  const hasCarriersToRegister = ((_f = enabledCarrierProfiles === null || enabledCarrierProfiles === void 0 ? void 0 : enabledCarrierProfiles.length) !== null && _f !== void 0 ? _f : 0) > 0 && carrierProfilesToRegister.length > 0;
   // Handle case where partner has not correctly enabled carriers and there is no insurance to register
   // Insurance does not get set in the same enabled carriers list and should bypass this check
   if (hasEnabledCarriersConfigurationError && !hasInsuranceToRegister) {

package/dist/cjs/workflows/onboarding/components/terms-agreement-step/use-terms-agreement-step.cjs

@@ -69,25 +69,10 @@ const useTermsAgreementStep = ({
     });
   }, [fundingSourceRequiredTerms, fundingSources, carriers, enabledCarrierProfiles]);
   const insuranceProviderProfiles = React.useMemo(() => {
-    const insuranceProfiles = fundingSourceMetadata === null || fundingSourceMetadata === void 0 ? void 0 : fundingSourceMetadata.defaultFundingSourceProfile.optionalTerms.map(terms => {
-      return Object.assign(Object.assign({}, insurance.getInsuranceProviderWithFriendlyName(terms.termType)), {
-        terms
-      });
-    });
-    if (!insuranceProfiles) return [];
-    // filter out insurance profiles that are already connected from insurance accepted terms
-    const connectedInsuranceProfiles = insuranceAcceptedTerms === null || insuranceAcceptedTerms === void 0 ? void 0 : insuranceAcceptedTerms.acceptedTerms.map(terms => {
-      return Object.assign(Object.assign({}, insurance.getInsuranceProviderWithFriendlyName(terms.termType)), {
-        terms
-      });
-    });
-    return insuranceProfiles.filter(profile => {
-      const isConnected = connectedInsuranceProfiles === null || connectedInsuranceProfiles === void 0 ? void 0 : connectedInsuranceProfiles.some(c => c.terms.termType === profile.terms.termType);
-      if (isConnected) {
-        return false;
-      }
-      return true;
-    });
+    const optionalTerms = fundingSourceMetadata === null || fundingSourceMetadata === void 0 ? void 0 : fundingSourceMetadata.defaultFundingSourceProfile.optionalTerms;
+    const acceptedTerms = insuranceAcceptedTerms === null || insuranceAcceptedTerms === void 0 ? void 0 : insuranceAcceptedTerms.acceptedTerms;
+    const profiles = insurance.groupTermsByProvider(optionalTerms);
+    return insurance.filterProfilesByAcceptedTerms(profiles, acceptedTerms);
   }, [fundingSourceMetadata, insuranceAcceptedTerms]);
   const handleSubmitTermsAgreement = React.useCallback(() => {
     onStepComplete();

package/dist/esm/assets/xcover/logo.svg.js

@@ -0,0 +1,23 @@
+import * as React from 'react';
+
+var _path, _path2, _path3;
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+var SvgLogo = function SvgLogo(props) {
+  return /*#__PURE__*/React.createElement("svg", _extends({
+    width: 55,
+    height: 55,
+    fill: "none",
+    xmlns: "http://www.w3.org/2000/svg"
+  }, props), _path || (_path = /*#__PURE__*/React.createElement("path", {
+    d: "m37.192 29.2-4.853-8.145 4.622-8.135a.65.65 0 0 0 0-.598.525.525 0 0 0-.195-.222.567.567 0 0 0-.29-.089H30.41a.593.593 0 0 0-.283.082.554.554 0 0 0-.202.206l-1.735 3.118 2.96 4.994a1.402 1.402 0 0 1 0 1.426l-2.766 4.89 1.868 3.118c.047.081.115.15.198.198a.58.58 0 0 0 .276.078h6.053a.617.617 0 0 0 .293-.092.575.575 0 0 0 .205-.218.64.64 0 0 0 0-.61",
+    fill: "#FFE600"
+  })), _path2 || (_path2 = /*#__PURE__*/React.createElement("path", {
+    d: "m29.622 20.825-2.706-4.545-2.341-4.004a.555.555 0 0 0-.204-.2.593.593 0 0 0-.281-.076h-5.981a.579.579 0 0 0-.29.09.538.538 0 0 0-.196.22.64.64 0 0 0 0 .61l4.853 8.216-4.634 8.053a.618.618 0 0 0 0 .599c.044.09.11.17.194.23a.48.48 0 0 1 .121 0 .951.951 0 0 0 .17 0h6.066a.567.567 0 0 0 .288-.084.527.527 0 0 0 .197-.215l2.196-3.832 2.548-4.406a.63.63 0 0 0 0-.633",
+    fill: "#FFE600"
+  })), _path3 || (_path3 = /*#__PURE__*/React.createElement("path", {
+    d: "M2.703 40.333.147 36.31a.232.232 0 0 1-.005-.248.225.225 0 0 1 .223-.106h1.849a.269.269 0 0 1 .202.118l1.453 2.362 1.476-2.362a.259.259 0 0 1 .202-.118h1.849c.217 0 .334.19.217.354l-2.571 4.023 2.657 4.244a.23.23 0 0 1-.077.337.224.224 0 0 1-.125.025h-1.74a.284.284 0 0 1-.218-.118l-1.655-2.59-1.647 2.59a.299.299 0 0 1-.217.118H.264c-.218 0-.335-.197-.218-.362l2.657-4.244ZM13.828 35.973a4.095 4.095 0 0 1 2.987 1.156.238.238 0 0 1 0 .352l-.963 1.01a.226.226 0 0 1-.31 0 2.495 2.495 0 0 0-1.668-.635c-.67 0-1.312.269-1.785.747a2.561 2.561 0 0 0-.739 1.802c0 .676.266 1.324.74 1.802a2.511 2.511 0 0 0 1.784.747 2.622 2.622 0 0 0 1.652-.597.233.233 0 0 1 .319 0l.97 1.033a.262.262 0 0 1 0 .337 4.238 4.238 0 0 1-3.032 1.21 4.41 4.41 0 0 1-1.758-.288 4.443 4.443 0 0 1-1.506-.96 4.53 4.53 0 0 1 0-6.484c.433-.42.945-.746 1.506-.96a4.409 4.409 0 0 1 1.758-.287l.045.015ZM23.211 35.954a4.635 4.635 0 0 1 2.546.75 4.512 4.512 0 0 1 1.691 2.011c.35.82.443 1.724.269 2.596a4.47 4.47 0 0 1-1.247 2.305 4.6 4.6 0 0 1-2.34 1.236 4.653 4.653 0 0 1-2.645-.25 4.56 4.56 0 0 1-2.057-1.652 4.436 4.436 0 0 1 .553-5.674c.424-.418.927-.75 1.481-.977a4.638 4.638 0 0 1 1.75-.345Zm0 6.98c.504.004.998-.14 1.418-.414.42-.273.748-.662.942-1.119.194-.456.246-.96.149-1.445a2.483 2.483 0 0 0-.697-1.281 2.556 2.556 0 0 0-1.304-.684 2.583 2.583 0 0 0-1.472.146 2.53 2.53 0 0 0-1.14.926 2.464 2.464 0 0 0 .323 3.14 2.564 2.564 0 0 0 1.781.732ZM29.234 36.281a.219.219 0 0 1 .015-.225.23.23 0 0 1 .09-.078.24.24 0 0 1 .12-.022h1.737a.245.245 0 0 1 .216.14l2.153 4.646h.08l2.154-4.646a.251.251 0 0 1 .092-.1.262.262 0 0 1 .132-.04h1.73a.23.23 0 0 1 .217.095.213.213 0 0 1 .006.23l-4.098 8.52a.227.227 0 0 1-.086.101.238.238 0 0 1-.13.038h-.129a.246.246 0 0 1-.134-.037.235.235 0 0 1-.09-.102l-4.075-8.52ZM39.415 36.199a.25.25 0 0 1 .076-.171.263.263 0 0 1 .176-.074h5.48c.066 0 .13.026.177.072a.241.241 0 0 1 .074.173v1.39a.241.241 0 0 1-.074.173.255.255 0 0 1-.178.071h-3.66v1.58h3.01a.263.263 0 0 1 .177.073.249.249 0 0 1 .076.171v1.406a.242.242 0 0 1-.074.173.256.256 0 0 1-.178.072h-3.012v1.737h3.661c.067 0 .131.026.178.072a.24.24 0 0 1 .074.173v1.405a.24.24 0 0 1-.074.173.255.255 0 0 1-.178.072h-5.479a.264.264 0 0 1-.176-.074.25.25 0 0 1-.076-.17v-8.497ZM47.862 36.199c0-.065.026-.127.073-.173a.253.253 0 0 1 .176-.071h3.923a2.843 2.843 0 0 1 1.848.626c.519.42.866 1.007.979 1.656a2.69 2.69 0 0 1-.367 1.878A2.793 2.793 0 0 1 52.96 41.3l1.796 3.26a.24.24 0 0 1-.091.35.254.254 0 0 1-.134.028h-1.748a.262.262 0 0 1-.21-.118l-1.74-3.401h-.91v3.252a.258.258 0 0 1-.077.168.269.269 0 0 1-.172.076H48.11a.253.253 0 0 1-.176-.072.242.242 0 0 1-.073-.172v-8.473Zm4.027 3.59c.268-.014.521-.127.707-.318.185-.19.29-.442.292-.705a.975.975 0 0 0-.295-.688 1.019 1.019 0 0 0-.704-.289h-1.966v2h1.966Z",
+    fill: "#000"
+  })));
+};
+
+export { SvgLogo as default };

package/dist/esm/components/field/rate-select/rate-card/rate-attribute-item/index.js

@@ -0,0 +1 @@
+export { RateAttributeItem } from './rate-attribute-item.js';

package/dist/esm/components/field/rate-select/rate-card/rate-attribute-item/rate-attribute-item.js

@@ -0,0 +1,54 @@
+import { jsxs, jsx } from '@emotion/react/jsx-runtime';
+import { useHoverableTooltip, Typography, Icon, IconSize, Tooltip } from '@shipengine/giger';
+import { IconNames } from '@shipengine/giger-theme';
+import { useRef } from 'react';
+import { useTranslation } from 'react-i18next';
+import { styles } from './rate-attribute-item.styles.js';
+
+const RateAttributeItem = ({
+  attribute,
+  tooltipId
+}) => {
+  const {
+    t
+  } = useTranslation("purchase-label");
+  const tooltipRef = useRef(null);
+  const {
+    opened
+  } = useHoverableTooltip(tooltipRef);
+  const rateAttributeMap = {
+    best_value: {
+      name: t("rates.rateAttributes.bestValue"),
+      description: t("rates.rateAttributes.bestValueTooltip")
+    },
+    cheapest: {
+      name: t("rates.rateAttributes.cheapest"),
+      description: t("rates.rateAttributes.cheapestTooltip")
+    },
+    fastest: {
+      name: t("rates.rateAttributes.fastest"),
+      description: t("rates.rateAttributes.fastestTooltip")
+    }
+  };
+  const rateAttribute = rateAttributeMap[attribute];
+  return jsxs("li", {
+    css: styles.attribute,
+    children: [jsx(Typography, {
+      component: "span",
+      variant: "small",
+      children: rateAttribute.name
+    }), jsx(Icon, {
+      css: styles.attributeIcon,
+      name: IconNames.INFO_FILLED,
+      ref: tooltipRef,
+      size: IconSize.SIZE_SMALL
+    }), tooltipRef.current && jsx(Tooltip, {
+      id: tooltipId,
+      isOpen: opened,
+      reference: tooltipRef.current,
+      children: rateAttribute.description
+    })]
+  });
+};
+
+export { RateAttributeItem };