@shipengine/elements 2.26.4 → 2.27.0

package/dist/cjs/features/manage-carriers/hooks/use-list-funding-source-carriers.cjs

@@ -38,12 +38,10 @@ const useListFundingSourceCarriers = () => {
   //TODO: Remove hardcoded carrierMetadata and insuranceProviderMetadata when the friendlyName is available in the funding source metadata response
   const carrierMetadata = useCarrierMetadata.useCarrierMetadata();
   const insuranceProviderProfiles = React.useMemo(() => {
-    return optionalTerms.map(t => {
-      return Object.assign({
-        agreedToTerms: insurance.getIsInsuraceProviderAccepted(t.termType, insuranceProviderAcceptedTerms === null || insuranceProviderAcceptedTerms === void 0 ? void 0 : insuranceProviderAcceptedTerms.acceptedTerms),
-        terms: Object.assign({}, t)
-      }, insurance.getInsuranceProviderWithFriendlyName(t.termType));
-    });
+    const groupedProfiles = insurance.groupTermsByProvider(optionalTerms);
+    return groupedProfiles.map(profile => Object.assign(Object.assign({}, profile), {
+      agreedToTerms: profile.terms.some(term => insurance.getIsInsuraceProviderAccepted(term.termType, insuranceProviderAcceptedTerms === null || insuranceProviderAcceptedTerms === void 0 ? void 0 : insuranceProviderAcceptedTerms.acceptedTerms))
+    }));
   }, [optionalTerms, insuranceProviderAcceptedTerms]);
   const normalizeCarrierCode = (carrierCode, nickname) => carrierCode === "usps" || (nickname === null || nickname === void 0 ? void 0 : nickname.includes("free")) ? "stamps_com" : carrierCode;
   const normalizeConnectedCarrierCodes = new Set(connectedCarriers === null || connectedCarriers === void 0 ? void 0 : connectedCarriers.map(c => normalizeCarrierCode(c.carrierCode, c.nickname)));

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

@@ -10,6 +10,7 @@ var React = require('react');
 var reactI18next = require('react-i18next');
 var manageCarriers_styles = require('./manage-carriers.styles.cjs');
 var useListFundingSourceCarriers = require('./hooks/use-list-funding-source-carriers.cjs');
+var insurance = require('../../utilities/shipengine/insurance.cjs');
 var skeletonCarrierRow = require('../../components/skeleton/skeleton-carrier-row.cjs');
 var manageFunding = require('../manage-funding/manage-funding.cjs');
 var manageCarriersRow = require('./manage-carriers-row/manage-carriers-row.cjs');
@@ -43,6 +44,7 @@ const ShipEngineCarriers = ({
     refetch: refetchCarriers,
     refetchInsuranceProviderAcceptedTerms
   } = useListFundingSourceCarriers.useListFundingSourceCarriers();
+  const isInsuranceEnabled = insurance.getIsFundingSourceInsuranceProviderEnabledAndSupported(insuranceProviderProfiles, globalFeatures.enableXCover, globalFeatures.enableParcelGuard);
   const hasConnectedCarriers = React.useMemo(() => fundingSourceCarriers === null || fundingSourceCarriers === void 0 ? void 0 : fundingSourceCarriers.some(c => c.isConnected), [fundingSourceCarriers]);
   const {
     data: warehouses
@@ -103,10 +105,10 @@ const ShipEngineCarriers = ({
   const handleRegisterProvider = React.useCallback(p => _tslib.__awaiter(void 0, void 0, void 0, function* () {
     return yield handleRegistration({
       insuranceProviders: [{
-        acceptedTerms: [{
-          termType: p.terms.termType,
-          version: p.terms.version
-        }],
+        acceptedTerms: [...p.terms.map(term => ({
+          termType: term.termType,
+          version: term.version
+        }))],
         agreeToTerms: true,
         fundingSourceId: fundingSourceId !== null && fundingSourceId !== void 0 ? fundingSourceId : "",
         provider: p.provider
@@ -178,12 +180,12 @@ const ShipEngineCarriers = ({
             }),
             setCarrierToConnect: setCarrierToConnect
           })
-        }, carrier.carrier.carrierProfile.carrierCode)), globalFeatures.enableParcelGuard && (insuranceProviderProfiles === null || insuranceProviderProfiles === void 0 ? void 0 : insuranceProviderProfiles.map(p => jsxRuntime.jsx("li", {
+        }, carrier.carrier.carrierProfile.carrierCode)), isInsuranceEnabled && (insuranceProviderProfiles === null || insuranceProviderProfiles === void 0 ? void 0 : insuranceProviderProfiles.map(p => jsxRuntime.jsx("li", {
           children: jsxRuntime.jsx(manageInsuranceProviderRow.ManageInsuranceProviderRow, {
             insuranceProviderProfile: p,
             registerProvider: handleRegisterProvider
           })
-        }, p.terms.termType)))]
+        }, p.terms[0].termType)))]
       })
     })]
   });

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

@@ -221,83 +221,7 @@ const useConfigureShipment = ({
     if (isInitialLoadingCarriers || isFetchingCarriers) return;
     if ((carriers === null || carriers === void 0 ? void 0 : carriers.length) === 0) incompleteRequirementsKeys.push("no_carriers");
   }, [carriers, incompleteRequirementsKeys, isFetchingCarriers, isInitialLoadingCarriers]);
-  const isConfigureShipmentLoading = React.useMemo(() => {
-    if (isSalesOrderLoading) return true;
-    if (listSalesOrderShipmentsInitiallyLoading) return true;
-    if (listSalesOrderShipmentsIsFetching) return true;
-    if (creatingSalesOrderShipment) return true;
-    if (creatingV1Shipment) return true;
-    // Include external shipment loading states to prevent premature error display
-    // Only keep loading if we're actually fetching and don't have an error yet
-    // Skip this check if we already have an error to avoid infinite loading
-    if (externalShipmentId && isExternalShipmentFetching && !getExternalShipmentErrors && !isExternalShipmentInitialLoading) {
-      return true;
-    }
-    // Check if this is a one-off flow (no identifiers provided)
-    const isOneOffFlow = !salesOrderId && !externalOrderId && !externalOrderNumber && !orderSourceCode && !shipmentId && !externalShipmentId;
-    // For one-off flow, keep loading until we have shipment data or V1 creation is complete
-    if (isOneOffFlow && !pendingSalesOrderShipment && !labelPurchasedSalesOrderShipment) {
-      return true;
-    }
-    // Only consider empty salesOrderShipments array as loading if we're not initially loading and have valid identifiers
-    const shouldReturnTrueForEmptyShipments = (salesOrderShipments === null || salesOrderShipments === void 0 ? void 0 : salesOrderShipments.length) === 0 && !listSalesOrderShipmentsInitiallyLoading && !listSalesOrderShipmentsIsFetching;
-    if (shouldReturnTrueForEmptyShipments) {
-      return true;
-    }
-    return false;
-  }, [isSalesOrderLoading, listSalesOrderShipmentsInitiallyLoading, listSalesOrderShipmentsIsFetching, creatingSalesOrderShipment, creatingV1Shipment, isExternalShipmentInitialLoading, isExternalShipmentFetching, getExternalShipmentErrors,
-  // This was missing!
-  salesOrderId, externalOrderId, externalOrderNumber, orderSourceCode, shipmentId, externalShipmentId, pendingSalesOrderShipment, labelPurchasedSalesOrderShipment, salesOrderShipments === null || salesOrderShipments === void 0 ? void 0 : salesOrderShipments.length]);
-  // #region Custom Error Mapping
-  const hasGetShipmentErrors = React.useMemo(() => {
-    // Check for explicit API errors
-    if (listSalesOrderShipmentsErrors) return true;
-    if (getExternalShipmentErrors) return true;
-    if (importSalesOrderErrors) return true;
-    // Only treat empty results as error if we're not loading and have finished initial fetch
-    if ((salesOrderShipments === null || salesOrderShipments === void 0 ? void 0 : salesOrderShipments.length) === 0 && shipmentId && !listSalesOrderShipmentsInitiallyLoading && !listSalesOrderShipmentsIsFetching) {
-      return true;
-    }
-    return false;
-  }, [listSalesOrderShipmentsErrors, getExternalShipmentErrors, importSalesOrderErrors, salesOrderShipments === null || salesOrderShipments === void 0 ? void 0 : salesOrderShipments.length, shipmentId, listSalesOrderShipmentsInitiallyLoading, listSalesOrderShipmentsIsFetching]);
-  const hasValidShipmentData = React.useMemo(() => {
-    if (manuallyCreatedShipmentId) return true;
-    if (pendingSalesOrderShipment) return true;
-    if (labelPurchasedSalesOrderShipment) return true;
-    return false;
-  }, [labelPurchasedSalesOrderShipment, manuallyCreatedShipmentId, pendingSalesOrderShipment]);
-  const showShipmentNotFoundError = React.useMemo(() => {
-    // Don't show error if we have a manually created shipment
-    if (manuallyCreatedShipmentId) {
-      return false;
-    }
-    // Don't show error if we're creating a V1 shipment
-    if (creatingV1Shipment || newV1Shipment) {
-      return false;
-    }
-    // For external shipment ID, show error if we're not in loading state
-    // and we don't have valid shipment data
-    if (externalShipmentId && !isConfigureShipmentLoading && !hasValidShipmentData) {
-      return true;
-    }
-    // Don't show error if external shipment is still loading, unless we have explicit errors
-    if (externalShipmentId && (isExternalShipmentInitialLoading || isExternalShipmentFetching) && !getExternalShipmentErrors) {
-      return false;
-    }
-    // Show error immediately if we have shipment errors, even if still loading
-    if (hasGetShipmentErrors) {
-      return true;
-    }
-    // Check if this is a one-off flow (no identifiers provided)
-    const isOneOffFlow = !salesOrderId && !externalOrderId && !externalOrderNumber && !orderSourceCode && !shipmentId && !externalShipmentId;
-    // Don't show error for one-off flow until we've attempted shipment creation
-    if (isOneOffFlow && !v1shipmentCreated) {
-      return false;
-    }
-    // Otherwise, only show if not loading and no valid shipment data
-    return !isConfigureShipmentLoading && !hasValidShipmentData;
-  }, [manuallyCreatedShipmentId, creatingV1Shipment, newV1Shipment, hasGetShipmentErrors, isExternalShipmentInitialLoading, isExternalShipmentFetching, getExternalShipmentErrors, listSalesOrderShipmentsErrors, importSalesOrderErrors, salesOrderId, externalOrderId, externalOrderNumber, orderSourceCode, shipmentId, externalShipmentId, v1shipmentCreated, isConfigureShipmentLoading, hasValidShipmentData, pendingSalesOrderShipment, externalShipment]);
-  const errors = [...(listWarehouseErrors !== null && listWarehouseErrors !== void 0 ? listWarehouseErrors : []), ...(createSalesOrderShipmentErrors !== null && createSalesOrderShipmentErrors !== void 0 ? createSalesOrderShipmentErrors : []), ...(createV1ShipmentErrors !== null && createV1ShipmentErrors !== void 0 ? createV1ShipmentErrors : []), ...(errorWhenShipmentCancelled && cancelledShipment ? [new reactApi.CodedError("shipment_cancelled", {
+  const errors = [...(listWarehouseErrors !== null && listWarehouseErrors !== void 0 ? listWarehouseErrors : []), ...(createSalesOrderShipmentErrors !== null && createSalesOrderShipmentErrors !== void 0 ? createSalesOrderShipmentErrors : []), ...(createV1ShipmentErrors !== null && createV1ShipmentErrors !== void 0 ? createV1ShipmentErrors : []), ...(listSalesOrderShipmentsErrors !== null && listSalesOrderShipmentsErrors !== void 0 ? listSalesOrderShipmentsErrors : []), ...(getExternalShipmentErrors !== null && getExternalShipmentErrors !== void 0 ? getExternalShipmentErrors : []), ...(importSalesOrderErrors !== null && importSalesOrderErrors !== void 0 ? importSalesOrderErrors : []), ...(errorWhenShipmentCancelled && cancelledShipment ? [new reactApi.CodedError("shipment_cancelled", {
     errorCode: "invalid_status",
     errorSource: "elements",
     errorType: "business_rules"
@@ -309,17 +233,16 @@ const useConfigureShipment = ({
     errorCode: "unknown",
     errorSource: "elements",
     errorType: "business_rules"
-  })] : []), ...(showShipmentNotFoundError ? [new reactApi.CodedError("shipment_not_found", {
+  })] : []), ...((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"
   })] : [])];
-  // #endregion
   return {
     carriers,
     createNewShipmentForNotFound,
     errors: errors.length > 0 ? errors : undefined,
-    isLoading: isConfigureShipmentLoading && errors.length === 0,
+    isLoading: (isSalesOrderLoading || !(salesOrderShipments === null || salesOrderShipments === void 0 ? void 0 : salesOrderShipments.length) || creatingSalesOrderShipment) && errors.length === 0,
     refetchPendingSalesOrderShipments,
     salesOrder: salesOrder$1,
     shipment: pendingSalesOrderShipment !== null && pendingSalesOrderShipment !== void 0 ? pendingSalesOrderShipment : labelPurchasedSalesOrderShipment,

package/dist/cjs/hooks/use-get-funding-source-insurance-provider.cjs

@@ -16,14 +16,15 @@ var elementsContextProvider = require('../elements-provider/elements-context-pro
 const useGetFundingSourceInsuranceProvider = () => {
   const {
     globalFeatures: {
-      enableParcelGuard
+      enableParcelGuard,
+      enableXCover
     }
   } = elementsContextProvider.useElements();
   const {
     data,
     refetch: refetchInsuranceAcceptedTerms
   } = reactApi.useGetInsuranceFundingSourceAcceptedTerms({
-    enabled: enableParcelGuard
+    enabled: enableParcelGuard || enableXCover
   });
   const fundingSourceInsuranceProvider = React.useMemo(() => {
     var _a;
@@ -32,13 +33,12 @@ const useGetFundingSourceInsuranceProvider = () => {
       if (enableParcelGuard && term.termType === "parcelguard_terms") {
         provider = "parcelguard";
       }
-      // TODO: once x_cover is enabled, confirm the term type and uncomment
-      // if (term.termType === "x_cover_terms") {
-      //   provider = "x_cover";
-      // }
+      if (enableXCover && term.termType === "xcover_terms") {
+        provider = "x_cover";
+      }
     });
     return provider;
-  }, [data, enableParcelGuard]);
+  }, [data === null || data === void 0 ? void 0 : data.acceptedTerms, enableParcelGuard, enableXCover]);
   return {
     fundingSourceInsuranceProvider,
     refetchInsuranceAcceptedTerms

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

@@ -170,7 +170,7 @@ var common = {
 		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 {{identifierType}}: {{identifierNumber}}",
+		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",
@@ -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/purchase-label.json.cjs

@@ -32,13 +32,6 @@ var purchaseLabel = {
 		saveRateFailedMessage: "Saving DHL Express Worldwide rates is temporarily unavailable. Please try again later.",
 		saveRateFailedTitle: "Unable To Save Rate"
 	},
-	identifierTypes: {
-		externalOrderId: "External Order ID",
-		externalOrderNumber: "External Order Number",
-		externalShipmentId: "External Shipment ID",
-		salesOrderId: "Sales Order ID",
-		shipmentId: "Shipment ID"
-	},
 	errorTypes: {
 		results: "No results returned"
 	},
@@ -100,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.4";
+var version = "2.27.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,

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/label-workflow/label-workflow.cjs

@@ -62,31 +62,7 @@ const Component = _a => {
   }));
   // Track if we have a shipment_not_found error to avoid reusing the bad shipment ID
   const hasShipmentNotFoundError = configureShipmentErrors === null || configureShipmentErrors === void 0 ? void 0 : configureShipmentErrors.some(error => error.message === "shipment_not_found");
-  const getMultiplexedIdentifier = React.useCallback(() => {
-    if (_multiplexedId && "shipmentId" in _multiplexedId) {
-      return {
-        shipmentId: _multiplexedId.shipmentId
-      };
-    } else if (_multiplexedId && "externalShipmentId" in _multiplexedId) {
-      return {
-        externalShipmentId: _multiplexedId.externalShipmentId
-      };
-    } else if (_multiplexedId && "salesOrderId" in _multiplexedId) {
-      return {
-        salesOrderId: _multiplexedId.salesOrderId
-      };
-    } else if (_multiplexedId && "externalOrderNumber" in _multiplexedId) {
-      return {
-        externalOrderNumber: _multiplexedId.externalOrderNumber
-      };
-    } else if (_multiplexedId && "externalOrderId" in _multiplexedId) {
-      return {
-        externalOrderId: _multiplexedId.externalOrderId
-      };
-    }
-    return {};
-  }, [_multiplexedId]);
-  const shipmentId = getMultiplexedIdentifier().shipmentId;
+  const shipmentId = _multiplexedId && "shipmentId" in _multiplexedId ? _multiplexedId.shipmentId : undefined;
   const {
     data: insuranceAccount,
     isInitialLoading: insuranceIsLoading
@@ -204,9 +180,9 @@ const Component = _a => {
   return jsxRuntime.jsx(suspendPurchase.SuspendPurchase, {
     data: shipment$1 || salesOrder,
     errors: errors.length ? errors : undefined,
-    identifier: getMultiplexedIdentifier(),
     isLoading: isLabelsLoading || isConfiguringShipment || insuranceIsLoading,
     onCreateNewShipment: createNewShipmentForNotFound,
+    shipmentId: shipmentId,
     children: element && getElement(element)
   });
 };

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/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) {