@shipengine/elements 2.26.5 → 2.27.0

package/dist/esm/elements/purchase-label/components/shipment-form/shipment-form.js

@@ -104,7 +104,8 @@ const ShipmentForm = ({
   const {
     locale: defaultLocale,
     globalFeatures: {
-      enableParcelGuard
+      enableParcelGuard,
+      enableXCover
     }
   } = useElements();
   const {
@@ -532,7 +533,7 @@ const ShipmentForm = ({
   }, []);
   const insuranceProviderKey = useMemo(() => {
     var _a, _b, _c;
-    if (enableParcelGuard && !hasInsuranceToRegister) {
+    if ((enableParcelGuard || enableXCover) && !hasInsuranceToRegister) {
       const provider = (_a = insuranceProviderProfiles === null || insuranceProviderProfiles === void 0 ? void 0 : insuranceProviderProfiles[0]) === null || _a === void 0 ? void 0 : _a.provider;
       const fundingSourceProviderKey = getFundingSourceInsuranceProviderKey(provider);
       if (fundingSourceProviderKey) {
@@ -540,7 +541,7 @@ const ShipmentForm = ({
       }
     }
     return (_c = (_b = insuranceProviderOptions[0]) === null || _b === void 0 ? void 0 : _b.value.toUpperCase()) !== null && _c !== void 0 ? _c : "NONE";
-  }, [enableParcelGuard, hasInsuranceToRegister, insuranceProviderOptions, insuranceProviderProfiles, getFundingSourceInsuranceProviderKey]);
+  }, [enableParcelGuard, enableXCover, hasInsuranceToRegister, insuranceProviderOptions, insuranceProviderProfiles, getFundingSourceInsuranceProviderKey]);
   const [registerInsuranceForm, isRegisterInsuranceFormOpen, toggleisRegisterInsuranceFormOpen] = useNestedForm(RegisterFundingSourceInsuranceForm, {
     formId: "register-funding-source-insurance-form",
     insuranceProviderProfile: insuranceProviderProfiles === null || insuranceProviderProfiles === void 0 ? void 0 : insuranceProviderProfiles[0],

package/dist/esm/elements/purchase-label/hooks/use-filter-visible-rate-options/use-filter-visible-rate-options.js

@@ -1,24 +1,48 @@
 import { useMemo, useCallback } from 'react';
 
 const COLLAPSED_RATE_VIEW_LIMIT = 4;
-const filterRateOptions = (rateOptions, selectedRate, preferredServiceCodes) => {
-  // Show the selected rate
-  const isSelectedRate = option => !!(selectedRate === null || selectedRate === void 0 ? void 0 : selectedRate.rateId) && option.rateId === selectedRate.rateId;
-  // Show the rate if it is a preferred service
-  const isPreferredService = option => !!option.serviceCode && !!(preferredServiceCodes === null || preferredServiceCodes === void 0 ? void 0 : preferredServiceCodes.includes(option.serviceCode));
-  // Show the first 5 rates in the list
-  const isWithinRateViewLimit = index => index < COLLAPSED_RATE_VIEW_LIMIT;
-  return rateOptions.filter((option, index) => isSelectedRate(option) || isPreferredService(option) || isWithinRateViewLimit(index));
+const filterRateOptions = rateOptions => {
+  const hasRateAttributes = option => {
+    var _a;
+    return !!((_a = option.rateAttributes) === null || _a === void 0 ? void 0 : _a.length);
+  };
+  const isMediaMail = option => option.serviceCode === "usps_media_mail";
+  const result = [];
+  const ratesWithAttributes = [];
+  const ratesWithoutAttributes = [];
+  // Classify rates (excluding Media Mail from both categories)
+  for (const option of rateOptions) {
+    if (isMediaMail(option)) {
+      continue; // Skip Media Mail entirely - it will only show in "Show more"
+    }
+    if (hasRateAttributes(option)) {
+      ratesWithAttributes.push(option);
+    } else {
+      ratesWithoutAttributes.push(option);
+    }
+  }
+  // Add up to 3 rates with attributes
+  const attributedRatesToShow = ratesWithAttributes.slice(0, 3);
+  result.push(...attributedRatesToShow);
+  // Fill remaining slots up to COLLAPSED_RATE_VIEW_LIMIT (4) with regular rates
+  const remainingSlots = COLLAPSED_RATE_VIEW_LIMIT - result.length;
+  const regularRatesToShow = ratesWithoutAttributes.slice(0, remainingSlots);
+  result.push(...regularRatesToShow);
+  return result;
 };
 /**
  * @internal
  *
  * # Filter Visible Rate Options Hook
  *
+ * Filters rate options for the collapsed view, showing up to 4 rates:
+ * - Up to 3 rates with attributes (best_value, cheapest, fastest)
+ * - Fill remaining slots with regular rates
+ * - Media Mail is always excluded from the collapsed view
  */
-const useFilterVisibleRateOptions = (rateOptions, selectedRate, preferredServiceCodes) => {
-  const collapsedRateOptionList = useMemo(() => filterRateOptions(rateOptions, selectedRate, preferredServiceCodes), [rateOptions, selectedRate, preferredServiceCodes]);
-  const filterVisibleRateOptions = useCallback(options => filterRateOptions(options, selectedRate, preferredServiceCodes), [selectedRate, preferredServiceCodes]);
+const useFilterVisibleRateOptions = rateOptions => {
+  const collapsedRateOptionList = useMemo(() => filterRateOptions(rateOptions), [rateOptions]);
+  const filterVisibleRateOptions = useCallback(options => filterRateOptions(options), []);
   return {
     COLLAPSED_RATE_VIEW_LIMIT,
     collapsedRateOptionList,

package/dist/esm/elements/purchase-label/hooks/use-insurance-provider-options.js

@@ -24,11 +24,11 @@ const useInsuranceProviderOptions = (insuranceAccount, features) => {
     refetchInsuranceAcceptedTerms
   } = useGetFundingSourceInsuranceProvider();
   const insuranceProviderOptions = useMemo(() => Object.values(SE.InsuranceProviderType).flatMap(v => {
-    return v === "none" || v === "funding_source" || v === "parcelguard" && (v !== fundingSourceInsuranceProvider || !globalFeatures.enableParcelGuard) || v === "x_cover" && v !== fundingSourceInsuranceProvider || v === "carrier" && !(features === null || features === void 0 ? void 0 : features.includeCarrierInsurance) || v === "third_party" && !(features === null || features === void 0 ? void 0 : features.includeThirdPartyInsurance) || v === "shipsurance" && (!(insuranceAccount === null || insuranceAccount === void 0 ? void 0 : insuranceAccount.amount) || !(features === null || features === void 0 ? void 0 : features.includeShipsuranceInsurance)) ? [] : {
+    return v === "none" || v === "funding_source" || v === "parcelguard" && (v !== fundingSourceInsuranceProvider || !globalFeatures.enableParcelGuard) || v === "x_cover" && (v !== fundingSourceInsuranceProvider || !globalFeatures.enableXCover) || v === "carrier" && !(features === null || features === void 0 ? void 0 : features.includeCarrierInsurance) || v === "third_party" && !(features === null || features === void 0 ? void 0 : features.includeThirdPartyInsurance) || v === "shipsurance" && (!(insuranceAccount === null || insuranceAccount === void 0 ? void 0 : insuranceAccount.amount) || !(features === null || features === void 0 ? void 0 : features.includeShipsuranceInsurance)) ? [] : {
       label: t(`insuranceProviders.${humps.camelize(v)}`),
       value: v
     };
-  }), [fundingSourceInsuranceProvider, globalFeatures.enableParcelGuard, features, insuranceAccount === null || insuranceAccount === void 0 ? void 0 : insuranceAccount.amount, t]);
+  }), [fundingSourceInsuranceProvider, globalFeatures.enableParcelGuard, globalFeatures.enableXCover, features, insuranceAccount === null || insuranceAccount === void 0 ? void 0 : insuranceAccount.amount, t]);
   return {
     fundingSourceInsuranceProvider,
     insuranceProviderOptions,

package/dist/esm/elements-provider/elements-context-provider.js

@@ -1,5 +1,5 @@
 import { jsx } from '@emotion/react/jsx-runtime';
-import { createContext, useContext } from 'react';
+import { useContext, createContext } from 'react';
 import { getDefaultFeatures, deepMergeFeatures } from '../utilities/feature-flags/feature-flags.js';
 
 const DEFAULT_LOCALE = "en-US";

package/dist/esm/factories/shipengine/address.js

@@ -0,0 +1,111 @@
+import { faker } from '@faker-js/faker';
+import { Factory } from 'fishery';
+
+/**
+ * @category Factories
+ */
+const addressFactory = Factory.define(({
+  params,
+  transientParams
+}) => {
+  var _a, _b, _c, _d;
+  const addressLine2 = (_a = params.addressLine2) !== null && _a !== void 0 ? _a : faker.helpers.maybe(() => faker.address.secondaryAddress(), {
+    probability: 0.25
+  });
+  const addressLine3 = (_b = params.addressLine3) !== null && _b !== void 0 ? _b : addressLine2 && faker.helpers.maybe(() => faker.address.secondaryAddress());
+  let countryCode = (_c = params.countryCode) !== null && _c !== void 0 ? _c : "US";
+  // Random country code could still be US
+  while (transientParams.isInternational && countryCode === "US") {
+    countryCode = faker.address.countryCode();
+  }
+  const stateProvince = (_d = params.stateProvince) !== null && _d !== void 0 ? _d : faker.address.stateAbbr();
+  return {
+    addressLine1: faker.address.streetAddress(),
+    addressLine2,
+    addressLine3,
+    addressResidentialIndicator: faker.helpers.maybe(() => faker.helpers.arrayElement(["yes", "no"])),
+    cityLocality: faker.address.city(),
+    companyName: faker.helpers.maybe(() => faker.company.name()),
+    countryCode,
+    name: faker.name.fullName(),
+    phone: faker.phone.number(),
+    postalCode: faker.address.zipCodeByState(stateProvince),
+    stateProvince
+  };
+});
+/**
+ * @category Factories
+ */
+const addressValidationFactory = Factory.define(({
+  associations,
+  params
+}) => {
+  var _a, _b;
+  const status = params.status || faker.helpers.arrayElement(["unverified", "verified", "warning", "error"]);
+  return {
+    matchedAddress: (_a = associations.matchedAddress) !== null && _a !== void 0 ? _a : faker.helpers.maybe(() => addressFactory.build(), {
+      probability: ["verified", "error"].includes(status) ? 0 : 0.8
+    }),
+    messages: [],
+    originalAddress: (_b = associations.originalAddress) !== null && _b !== void 0 ? _b : addressFactory.build(),
+    status
+  };
+});
+/**
+ * Mock the addressValidation object used to hyrdate address valiation feature
+ * on the shipment form.
+ * @category Factory
+ */
+Factory.define(({
+  params
+}) => {
+  const addressValidation = addressValidationFactory.build({
+    status: params.status
+  }, {
+    associations: {
+      matchedAddress: addressFactory.build()
+    }
+  });
+  if (!addressValidation.matchedAddress) throw new Error("addressPreferenceFactory did not generate a matchedAddress");
+  return Object.assign(Object.assign({}, addressValidation), {
+    alternative: addressValidation.originalAddress,
+    alternativeSource: "originalAddress",
+    isModified: true,
+    selection: addressValidation.matchedAddress,
+    selectionSource: "matchedAddress",
+    toggle: () => addressFactory.build()
+  });
+});
+/**
+ * Mock the addressValidationPreference object used to hyrdate the address valiation feature
+ * used for warehouse management and onboarding.
+ * @category Factory
+ */
+Factory.define(() => {
+  const addressValidation = addressValidationFactory.build();
+  const address = addressFactory.build();
+  const validationType = faker.helpers.arrayElement(["EXACT", "SOFT", "SUGGESTED", "ERROR"]);
+  switch (validationType) {
+    case "EXACT":
+    case "SOFT":
+      return {
+        address: address,
+        validationType: faker.helpers.arrayElement(["EXACT", "SOFT"])
+      };
+    case "SUGGESTED":
+    case "ERROR":
+      return {
+        validation: addressValidation,
+        validationType: faker.helpers.arrayElement(["SUGGESTED", "ERROR"])
+      };
+    default:
+      {
+        return {
+          validation: addressValidation,
+          validationType: "ERROR"
+        };
+      }
+  }
+});
+
+export { addressFactory, addressValidationFactory };

package/dist/esm/factories/shipengine/money.js

@@ -0,0 +1,19 @@
+import { faker } from '@faker-js/faker';
+import { SE } from '@shipengine/react-api';
+import { Factory } from 'fishery';
+
+/**
+ * @category Factories
+ */
+const moneyFactory = Factory.define(({
+  transientParams
+}) => ({
+  amount: faker.datatype.number({
+    max: 1000,
+    min: 5,
+    precision: 0.01
+  }),
+  currency: (transientParams === null || transientParams === void 0 ? void 0 : transientParams.isInternational) ? faker.helpers.arrayElement(Object.values(SE.Currency)) : SE.Currency.USD
+}));
+
+export { moneyFactory };

package/dist/esm/factories/shipengine/order-source.js

@@ -0,0 +1,34 @@
+import { faker } from '@faker-js/faker';
+import { Factory } from 'fishery';
+
+const randomOrderSourceCode = () => faker.helpers.arrayElement(["3dcart", "abantecart", "acumatica", "acumatica_v2", "alibaba", "amazon", "amazon_au", "amazon_ca", "amazon_de", "amazon_es", "amazon_fr", "amazon_it", "amazon_jp", "amazon_mx", "amazon_uk", "americommerce", "auctane-orders", "back-market", "bandcamp", "big_cartel", "bigcommerce", "bigcommerce_v3", "bigcommerce_v2", "bizelo", "bluepark", "bonanza", "brightpearl", "cdiscount", "celery", "channeladvisor", "channelsale", "choxi", "cin7", "commerceinterface", "corecommerce", "coupang", "cratejoy", "cs-cart", "custom_store", "dear_systems", "dummy-marketplace", "ebay", "ebay_au", "ebay_ca", "ebay_uk", "ebay_fr", "ebay_v2", "ecwid", "ecwid_v1", "edesk", "ekm", "etsy", "facebook", "fnac", "foxycart", "freestyle", "fullscreen_direct", "geekseller", "goodsie", "google", "google_checkout", "gorgias", "groopdealz", "groupon_goods", "handshake", "hatch", "highwire", "homeroots", "houzz", "idealo_de", "inksoft", "jane", "jet", "kaufland", "labelapi", "lemonstand", "lengow", "liftoff", "linnworks", "listingmirror", "magento", "zoey", "magento_go", "memberly", "mercado_libre", "mijoshop", "best_buy_ca", "catch", "darty", "fanatics", "kohls", "kroger", "urbn", "miva_merchant", "morecommerce", "mozu", "neto", "newegg", "newegg_business", "newegg_ca", "notonthehighstreet", "oauth_dummy", "odbc", "onbuy", "opencart", "order_time", "ordersource_api", "oscommerce", "overstock", "oxatis", "paypal", "paypal_v2", "payvment", "penny", "prestashop", "rakuten", "best_buy", "rakuten-fr", "rate_browser", "redditgifts", "reverb", "revolutionparts", "salesforce_commerce_cloud", "salesforce_core", "sap_anywhere", "scout_topshelf", "sears", "securestore", "sellbrite", "selleractive", "shipengine_api", "shipengine_merchant", "shipstation", "shop_premium_outlets", "shopify", "shoppingfeed", "shopware_de", "simplepart", "skuvault", "soldsie", "sophio", "spark_shipping", "spree", "spreesy", "square", "squarespace", "stitch_labs", "storenvy", "stripe", "suredone", "tanga", "tophatter", "trade_me", "tradegecko", "ultracart", "unbranded_ecommerce_store", "unleashed", "vault", "visualsoft", "volo", "volusion", "vtex", "walmart", "walmart_ca", "wayfair", "webflow", "weebly", "wish", "wix", "woocommerce", "woocommerce_v2", "woot", "x-cart", "yahoo", "sec_yumbles", "zen_cart", "zonos"]);
+/**
+ * @category Factories
+ */
+const orderSourceRefreshInfoFactory = Factory.define(() => {
+  const lastRefreshAttempt = faker.date.recent();
+  return {
+    lastRefreshAttempt: lastRefreshAttempt.toISOString(),
+    refreshDate: faker.date.recent(1, lastRefreshAttempt).toISOString(),
+    status: faker.helpers.arrayElement(["idle", "preparing_update", "updating", "error", "unknown"])
+  };
+});
+/**
+ * @category Factories
+ */
+Factory.define(({
+  associations,
+  params
+}) => {
+  var _a;
+  return {
+    active: faker.datatype.boolean(),
+    orderSourceCode: randomOrderSourceCode(),
+    orderSourceFriendlyName: faker.company.name(),
+    orderSourceId: faker.datatype.uuid(),
+    orderSourceNickname: faker.random.words(),
+    refreshInfo: (_a = associations.refreshInfo) !== null && _a !== void 0 ? _a : orderSourceRefreshInfoFactory.build(params.refreshInfo)
+  };
+});
+
+export { orderSourceRefreshInfoFactory, randomOrderSourceCode };

package/dist/esm/factories/shipengine/package.js

@@ -0,0 +1,39 @@
+import { faker } from '@faker-js/faker';
+import { Factory } from 'fishery';
+import { randomShipengineSlug } from '../utils.js';
+
+/**
+ * @internal
+ *
+ * # Package Factory
+ *
+ * @category Factories
+ */
+const packageFactory = Factory.define(({
+  transientParams
+}) => ({
+  description: faker.lorem.sentence(),
+  dimensions: (transientParams === null || transientParams === void 0 ? void 0 : transientParams.noDimensions) ? undefined : {
+    height: faker.datatype.number({
+      max: 50,
+      min: 1,
+      precision: 0.1
+    }),
+    length: faker.datatype.number({
+      max: 50,
+      min: 1,
+      precision: 0.1
+    }),
+    unit: faker.helpers.arrayElement(["inch", "centimeter"]),
+    width: faker.datatype.number({
+      max: 50,
+      min: 1,
+      precision: 0.1
+    })
+  },
+  name: faker.random.words(),
+  packageCode: randomShipengineSlug(2),
+  packageId: randomShipengineSlug(3)
+}));
+
+export { packageFactory };

package/dist/esm/factories/shipengine/resource.js

@@ -0,0 +1,21 @@
+import { faker } from '@faker-js/faker';
+import { Factory } from 'fishery';
+
+/**
+ * @category Factories
+ */
+const downloadFactory = Factory.define(() => ({
+  href: faker.internet.url(),
+  pdf: faker.internet.url(),
+  png: faker.internet.url(),
+  zpl: faker.internet.url()
+}));
+/**
+ * @category Factories
+ */
+Factory.define(() => ({
+  href: faker.internet.url(),
+  type: faker.word.noun()
+}));
+
+export { downloadFactory };

package/dist/esm/factories/shipengine/shipment.js

@@ -0,0 +1,168 @@
+import { __rest } from '../../_virtual/_tslib.js';
+import { faker } from '@faker-js/faker';
+import { SE } from '@shipengine/react-api';
+import { Factory } from 'fishery';
+import { randomShipengineSlug, randomShipengineId, tristateValue } from '../utils.js';
+import { addressFactory, addressValidationFactory } from './address.js';
+import { moneyFactory } from './money.js';
+import { randomOrderSourceCode } from './order-source.js';
+import { packageFactory } from './package.js';
+import { downloadFactory } from './resource.js';
+import { weightWithUnitFactory } from './weight.js';
+
+const randomDeliveryConfirmation = () => faker.helpers.arrayElement(Object.values(SE.ConfirmationType));
+const randomInsuranceProvider = (allowNone = true) => {
+  const availableProviders = Object.values(SE.InsuranceProviderType).filter(p => allowNone ? p : p !== "none");
+  return faker.helpers.arrayElement(availableProviders);
+};
+/**
+ * @category Factories
+ */
+const productFactory = Factory.define(() => ({
+  countryOfOrigin: faker.address.countryCode(),
+  description: faker.commerce.productName(),
+  harmonizedTariffCode: faker.datatype.string(),
+  quantity: faker.datatype.number({
+    max: 10,
+    min: 1
+  }),
+  sku: faker.random.numeric(10),
+  skuDescription: faker.helpers.maybe(() => faker.lorem.sentence()),
+  unitOfMeasure: faker.helpers.maybe(() => faker.word.noun()),
+  value: moneyFactory.build()
+}));
+/**
+ * @category Factories
+ */
+const shipmentItemFactory = Factory.define(({
+  params
+}) => ({
+  asin: faker.helpers.maybe(() => faker.random.alphaNumeric(10)),
+  externalOrderId: faker.random.alphaNumeric(10),
+  externalOrderItemId: faker.random.alphaNumeric(10),
+  name: faker.commerce.productName(),
+  orderSourceCode: randomOrderSourceCode(),
+  quantity: faker.datatype.number({
+    max: 10,
+    min: 1
+  }),
+  salesOrderItemId: params.salesOrderId && faker.random.alphaNumeric(6),
+  sku: faker.random.numeric(10)
+}));
+/**
+ * @category Factories
+ */
+const shipmentPackageFactory = Factory.define(({
+  associations,
+  params,
+  transientParams
+}) => {
+  var _a, _b, _c, _d, _e;
+  const _f = packageFactory.build(params),
+    pkg = __rest(_f, ["name"]);
+  const isInsured = tristateValue(true, false, faker.datatype.boolean(), (_b = (_a = params.insuredValue) === null || _a === void 0 ? void 0 : _a.amount) !== null && _b !== void 0 ? _b : transientParams.isInsured);
+  return Object.assign(Object.assign({}, pkg), {
+    insuredValue: (_c = associations.insuredValue) !== null && _c !== void 0 ? _c : isInsured ? moneyFactory.build(params.insuredValue) : undefined,
+    labelDownload: (_d = associations.labelDownload) !== null && _d !== void 0 ? _d : transientParams.isShipped ? downloadFactory.build(params.labelDownload) : undefined,
+    labelMessages: associations.labelMessages,
+    products: transientParams.isInternational ? productFactory.buildList(1) : [],
+    trackingNumber: transientParams.isShipped ? faker.random.alphaNumeric(12, {
+      casing: "upper"
+    }) : undefined,
+    weight: (_e = associations.weight) !== null && _e !== void 0 ? _e : weightWithUnitFactory.build(params.weight)
+  });
+});
+/**
+ * @category Factories
+ */
+const shipmentFactory = Factory.define(({
+  associations,
+  params,
+  sequence,
+  transientParams
+}) => {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x;
+  const shipTo = (_a = associations.shipTo) !== null && _a !== void 0 ? _a : addressFactory.build(params.shipTo, {
+    transient: {
+      isInternational: transientParams.isInternational
+    }
+  });
+  let insuranceProvider = SE.InsuranceProviderType.NONE;
+  if (transientParams.insuredValue || transientParams.isInsured) {
+    insuranceProvider = (_b = params.insuranceProvider) !== null && _b !== void 0 ? _b : randomInsuranceProvider(false);
+  } else if (transientParams.insuredValue === undefined && transientParams.isInsured === undefined) {
+    insuranceProvider = randomInsuranceProvider(true);
+  }
+  const shipDateObj = faker.date.soon(7);
+  shipDateObj.setHours(0, 0, 0, 0);
+  const totalWeight = (_c = associations.totalWeight) !== null && _c !== void 0 ? _c : weightWithUnitFactory.build(params.totalWeight);
+  return {
+    addressValidation: (_d = associations.addressValidation) !== null && _d !== void 0 ? _d : addressValidationFactory.build(params.addressValidation, {
+      associations: {
+        originalAddress: shipTo
+      }
+    }),
+    amountPaid: moneyFactory.build(),
+    carrierId: (_f = (_e = transientParams === null || transientParams === void 0 ? void 0 : transientParams.service) === null || _e === void 0 ? void 0 : _e.carrierId) !== null && _f !== void 0 ? _f : randomShipengineId(),
+    confirmation: randomDeliveryConfirmation(),
+    createdAt: faker.date.past().toISOString(),
+    customs: (_g = associations.customs) !== null && _g !== void 0 ? _g : transientParams.isInternational ? {
+      contents: faker.helpers.arrayElement(["documents", "gift", "merchandise", "returned_goods", "sample"]),
+      nonDelivery: faker.helpers.arrayElement(["return_to_sender", "treat_as_abandoned"])
+    } : undefined,
+    externalOrderId: faker.random.alphaNumeric(10),
+    externalShipmentId: faker.random.alphaNumeric(10),
+    insuranceProvider,
+    items: shipmentItemFactory.buildList(faker.datatype.number({
+      max: 10,
+      min: 1
+    }), transientParams.salesOrder ? {
+      externalOrderId: transientParams.salesOrder.externalOrderId,
+      orderSourceCode: transientParams.salesOrder.orderSource.orderSourceCode,
+      salesOrderId: (_h = transientParams.salesOrder) === null || _h === void 0 ? void 0 : _h.salesOrderId
+    } : {}),
+    modifiedAt: faker.date.recent().toISOString(),
+    orderSourceCode: (_k = (_j = transientParams.salesOrder) === null || _j === void 0 ? void 0 : _j.orderSource.orderSourceCode) !== null && _k !== void 0 ? _k : randomOrderSourceCode(),
+    packages: (_l = associations.packages) !== null && _l !== void 0 ? _l : shipmentPackageFactory.buildList(1, (_m = params.packages) === null || _m === void 0 ? void 0 : _m[0], {
+      associations: {
+        weight: totalWeight
+      },
+      transient: {
+        isInsured: insuranceProvider !== "none",
+        isInternational: transientParams.isInternational,
+        isShipped: transientParams.isShipped
+      }
+    }),
+    returnTo: (_q = (_o = associations.returnTo) !== null && _o !== void 0 ? _o : (_p = transientParams.warehouse) === null || _p === void 0 ? void 0 : _p.returnAddress) !== null && _q !== void 0 ? _q : addressFactory.build(),
+    serviceCode: (_s = (_r = transientParams.service) === null || _r === void 0 ? void 0 : _r.serviceCode) !== null && _s !== void 0 ? _s : randomShipengineSlug(),
+    shipDate: shipDateObj.toISOString(),
+    shipFrom: (_v = (_t = associations.shipFrom) !== null && _t !== void 0 ? _t : (_u = transientParams.warehouse) === null || _u === void 0 ? void 0 : _u.originAddress) !== null && _v !== void 0 ? _v : addressFactory.build(),
+    shipmentId: `se-${30000 + sequence}`,
+    shipmentStatus: transientParams.isShipped ? "label_purchased" : "pending",
+    shippingPaid: moneyFactory.build(),
+    shipTo,
+    tags: (_w = associations.tags) !== null && _w !== void 0 ? _w : [],
+    taxPaid: moneyFactory.build(),
+    totalWeight,
+    warehouseId: (_x = transientParams.warehouse) === null || _x === void 0 ? void 0 : _x.warehouseId
+  };
+});
+/**
+ * @category Factories
+ */
+const salesOrderShipmentFactory = Factory.define(({
+  associations,
+  params,
+  transientParams
+}) => {
+  var _a, _b, _c;
+  const shipment = shipmentFactory.build(params, {
+    associations,
+    transient: transientParams
+  });
+  return Object.assign(Object.assign({}, shipment), {
+    salesOrderIds: (_a = associations.salesOrderIds) !== null && _a !== void 0 ? _a : [(_c = (_b = transientParams.salesOrder) === null || _b === void 0 ? void 0 : _b.salesOrderId) !== null && _c !== void 0 ? _c : faker.datatype.uuid()]
+  });
+});
+
+export { productFactory, randomDeliveryConfirmation, randomInsuranceProvider, salesOrderShipmentFactory, shipmentFactory, shipmentItemFactory, shipmentPackageFactory };

package/dist/esm/factories/shipengine/weight.js

@@ -0,0 +1,40 @@
+import { faker } from '@faker-js/faker';
+import { Factory } from 'fishery';
+
+const randomWeightUnit = () => faker.helpers.arrayElement(["pound", "ounce", "gram", "kilogram"]);
+/**
+ * @category Factories
+ */
+Factory.define(() => ({
+  fractional: faker.datatype.number({
+    max: 16,
+    min: 0
+  }),
+  whole: faker.datatype.number({
+    max: 20,
+    min: 0
+  })
+}));
+/**
+ * @category Factories
+ */
+const weightFactory = Factory.define(() => ({
+  value: faker.datatype.number({
+    max: 20,
+    min: 1,
+    precision: 0.1
+  })
+}));
+/**
+ * @category Factories
+ */
+const weightWithUnitFactory = Factory.define(({
+  params
+}) => {
+  const weight = weightFactory.build(params);
+  return Object.assign(Object.assign({}, weight), {
+    unit: randomWeightUnit()
+  });
+});
+
+export { randomWeightUnit, weightFactory, weightWithUnitFactory };

package/dist/esm/factories/utils.js

@@ -0,0 +1,15 @@
+import { faker } from '@faker-js/faker';
+
+const randomShipengineId = (length = 5) => `se-${faker.random.numeric(length)}`;
+const randomShipengineSlug = wordCount => faker.lorem.slug(wordCount).replace("-", "_");
+const tristateValue = (ifTrue, ifFalse, ifUndefined, value) => {
+  if (value === undefined) {
+    return ifUndefined;
+  }
+  if (value) {
+    return ifTrue;
+  }
+  return ifFalse;
+};
+
+export { randomShipengineId, randomShipengineSlug, tristateValue };

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

@@ -1,6 +1,6 @@
 import { useListCarriers, useGetFundingSourceMetadata, useGetInsuranceFundingSourceAcceptedTerms } from '@shipengine/react-api';
 import { filterFundingSourceCarriers } from '../../../utilities/shipengine/carrier.js';
-import { getIsInsuraceProviderAccepted, getInsuranceProviderWithFriendlyName } from '../../../utilities/shipengine/insurance.js';
+import { groupTermsByProvider, getIsInsuraceProviderAccepted } from '../../../utilities/shipengine/insurance.js';
 import { useMemo } from 'react';
 import { useCarrierMetadata } from './use-carrier-metadata.js';
 
@@ -36,12 +36,10 @@ const useListFundingSourceCarriers = () => {
   //TODO: Remove hardcoded carrierMetadata and insuranceProviderMetadata when the friendlyName is available in the funding source metadata response
   const carrierMetadata = useCarrierMetadata();
   const insuranceProviderProfiles = useMemo(() => {
-    return optionalTerms.map(t => {
-      return Object.assign({
-        agreedToTerms: getIsInsuraceProviderAccepted(t.termType, insuranceProviderAcceptedTerms === null || insuranceProviderAcceptedTerms === void 0 ? void 0 : insuranceProviderAcceptedTerms.acceptedTerms),
-        terms: Object.assign({}, t)
-      }, getInsuranceProviderWithFriendlyName(t.termType));
-    });
+    const groupedProfiles = groupTermsByProvider(optionalTerms);
+    return groupedProfiles.map(profile => Object.assign(Object.assign({}, profile), {
+      agreedToTerms: profile.terms.some(term => 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/esm/features/manage-carriers/manage-carriers.js

@@ -8,6 +8,7 @@ import { useState, useMemo, useCallback } from 'react';
 import { useTranslation } from 'react-i18next';
 import { styles } from './manage-carriers.styles.js';
 import { useListFundingSourceCarriers } from './hooks/use-list-funding-source-carriers.js';
+import { getIsFundingSourceInsuranceProviderEnabledAndSupported } from '../../utilities/shipengine/insurance.js';
 import { SkeletonCarrierRow } from '../../components/skeleton/skeleton-carrier-row.js';
 import { ManageFunding } from '../manage-funding/manage-funding.js';
 import { ManageCarriersRow } from './manage-carriers-row/manage-carriers-row.js';
@@ -41,6 +42,7 @@ const ShipEngineCarriers = ({
     refetch: refetchCarriers,
     refetchInsuranceProviderAcceptedTerms
   } = useListFundingSourceCarriers();
+  const isInsuranceEnabled = getIsFundingSourceInsuranceProviderEnabledAndSupported(insuranceProviderProfiles, globalFeatures.enableXCover, globalFeatures.enableParcelGuard);
   const hasConnectedCarriers = useMemo(() => fundingSourceCarriers === null || fundingSourceCarriers === void 0 ? void 0 : fundingSourceCarriers.some(c => c.isConnected), [fundingSourceCarriers]);
   const {
     data: warehouses
@@ -101,10 +103,10 @@ const ShipEngineCarriers = ({
   const handleRegisterProvider = useCallback(p => __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
@@ -176,12 +178,12 @@ const ShipEngineCarriers = ({
             }),
             setCarrierToConnect: setCarrierToConnect
           })
-        }, carrier.carrier.carrierProfile.carrierCode)), globalFeatures.enableParcelGuard && (insuranceProviderProfiles === null || insuranceProviderProfiles === void 0 ? void 0 : insuranceProviderProfiles.map(p => jsx("li", {
+        }, carrier.carrier.carrierProfile.carrierCode)), isInsuranceEnabled && (insuranceProviderProfiles === null || insuranceProviderProfiles === void 0 ? void 0 : insuranceProviderProfiles.map(p => jsx("li", {
           children: jsx(ManageInsuranceProviderRow, {
             insuranceProviderProfile: p,
             registerProvider: handleRegisterProvider
           })
-        }, p.terms.termType)))]
+        }, p.terms[0].termType)))]
       })
     })]
   });