@shipengine/elements 2.26.5 → 2.28.0

package/dist/esm/elements/labels-grid/labels-grid.js

@@ -1,6 +1,7 @@
 import { jsx, jsxs, Fragment } from '@emotion/react/jsx-runtime';
+import { useGetServiceData } from '../../hooks/use-get-service-data.js';
 import { useSortableQuery } from '../../hooks/use-sortable-query.js';
-import { EmptyState, Button, Tag, TagColor, TagVariant, Typography, Next } from '@shipengine/giger';
+import { EmptyState, Button, Tag, TagColor, TagVariant, Skeleton, IconSize, Typography, Next } from '@shipengine/giger';
 import { toSnakeCase } from '../../utilities/formatString.js';
 import { useRef, useMemo, useEffect, useCallback } from 'react';
 import { useTranslation } from 'react-i18next';
@@ -19,6 +20,7 @@ import { useElements } from '../../elements-provider/elements-context-provider.j
 import { Spacer } from '../../components/spacer/spacer.js';
 import { PoweredByShipEngine } from '../../components/powered-by-shipengine/powered-by-shipengine.js';
 import { ErrorFallback } from '../../components/error-fallback/error-fallback.js';
+import { CarrierIcon } from '../../components/carrier-icon/carrier-icon.js';
 
 const Component = ({
   labelStatus,
@@ -104,6 +106,10 @@ const Component = ({
     sortDir: sortState.dir,
     columns: columnsArray
   });
+  const {
+    getServiceInfo,
+    isLoadingCarriers
+  } = useGetServiceData();
   useEffect(() => {
     if (prevStatus.current !== labelStatus) {
       pageConfig.pagerProps.resetCurrentPage();
@@ -290,14 +296,22 @@ const Component = ({
         }
       },
       shippingService: {
-        headerContent: t("list-labels:headers.shipping"),
+        headerContent: t("list-labels:headers.service"),
         renderCellContent: label => {
+          const serviceInfo = getServiceInfo(label);
           return jsxs(Fragment, {
-            children: [jsx(Typography, {
-              component: "p",
-              css: styles.tableParagraph,
-              variant: "body2",
-              children: label.serviceName || label.serviceCode
+            children: [isLoadingCarriers ? jsx(Skeleton, {}) : jsxs("div", {
+              css: styles.serviceCell,
+              children: [serviceInfo.hasCarrierIcon && serviceInfo.carrierCode && jsx(CarrierIcon, {
+                carrierCode: serviceInfo.carrierCode,
+                carrierName: serviceInfo.serviceName || serviceInfo.carrierCode,
+                size: IconSize.SIZE_SMALL
+              }), jsx(Typography, {
+                component: "p",
+                css: styles.tableParagraph,
+                variant: "body2",
+                children: serviceInfo.serviceName || t("list-labels:none")
+              })]
             }), label.trackable && jsx(Next.Link, {
               bold: false,
               href: label.trackingUrl,
@@ -350,17 +364,23 @@ const Component = ({
         }
       }
     });
+    const labelExpired = label => {
+      const ninetyDaysAgo = new Date();
+      ninetyDaysAgo.setDate(ninetyDaysAgo.getDate() - 90);
+      return new Date(label.createdAt) < ninetyDaysAgo;
+    };
     // Actual actions are only allowed for completed labels
     if ((features === null || features === void 0 ? void 0 : features.showActions) && labels.some(label => label.status === "completed")) {
       cols.push({
         headerContent: "",
         renderCellContent: label => {
           var _a, _b;
+          const isLabelExpired = labelExpired(label);
           const isLabelDelivered = label.trackingStatus === "delivered";
-          const isReprintAllowed = !!((_a = label.labelDownload) === null || _a === void 0 ? void 0 : _a.href) && label.status === "completed";
           const isVoidAllowed = !!onClickVoidLabel && label.status === "completed";
-          const isPrintFormsAllowed = !!((_b = label.formDownload) === null || _b === void 0 ? void 0 : _b.href) && label.status === "completed";
           const isViewDetailsAllowed = !!onClickViewDetails;
+          const isReprintAllowed = !!((_a = label.labelDownload) === null || _a === void 0 ? void 0 : _a.href) && label.status === "completed" && !isLabelExpired;
+          const isPrintFormsAllowed = !!((_b = label.formDownload) === null || _b === void 0 ? void 0 : _b.href) && label.status === "completed" && !isLabelExpired;
           const allowActionsMenu = isReprintAllowed || isVoidAllowed || isPrintFormsAllowed || isViewDetailsAllowed;
           if (isLabelDelivered || !allowActionsMenu) {
             return null;
@@ -389,7 +409,7 @@ const Component = ({
       });
     }
     return cols;
-  }, [t, toggleCreatedDateSort, sortState.createdAtDir, features === null || features === void 0 ? void 0 : features.columns, features === null || features === void 0 ? void 0 : features.showActions, labels, onClickExternalOrderId, onClickExternalShipmentId, onClickShipmentNumber, onClickTrackingNumber, onClickVoidLabel, onClickViewDetails, onClickPrintLabel, onClickPrintForms]);
+  }, [t, toggleCreatedDateSort, sortState.createdAtDir, features === null || features === void 0 ? void 0 : features.columns, features === null || features === void 0 ? void 0 : features.showActions, labels, onClickExternalOrderId, onClickExternalShipmentId, onClickShipmentNumber, getServiceInfo, isLoadingCarriers, onClickTrackingNumber, onClickVoidLabel, onClickViewDetails, onClickPrintLabel, onClickPrintForms]);
   const emptyContentComponent = useMemo(() => {
     if (isLoading) {
       return undefined;

package/dist/esm/elements/labels-grid/labels-grid.styles.js

@@ -6,6 +6,11 @@ const styles = createStyles({
   }, scopeTheme(theme).getComponentOverride("Table")),
   tableParagraph: {
     margin: 0
+  },
+  serviceCell: {
+    display: "flex",
+    alignItems: "center",
+    gap: "8px"
   }
 });
 

package/dist/esm/elements/manage-carriers/manage-carriers.js

@@ -4,8 +4,8 @@ import { useFundingSourcesAddFunds } from '@shipengine/react-api';
 import { useCallback } from 'react';
 import { createElement } from '../../create-element/create-element.js';
 import { ShipEngineCarriers } from '../../features/manage-carriers/manage-carriers.js';
-import en from '../../locales/en/index.js';
 import { ErrorFallback } from '../../components/error-fallback/error-fallback.js';
+import en from '../../locales/en/index.js';
 
 /**
  * # Manage-Carriers Element

package/dist/esm/elements/purchase-label/components/customs-forms/tax-ids/tax-ids.js

@@ -127,7 +127,7 @@ const TaxIds = ({
       })]
     }), jsxs(Grid, {
       noPadding: true,
-      children: [((_a = shipment.taxIdentifiers) === null || _a === void 0 ? void 0 : _a.length) && jsx(GridChild, {
+      children: [!!((_a = shipment.taxIdentifiers) === null || _a === void 0 ? void 0 : _a.length) && jsx(GridChild, {
         colSpan: 12,
         children: jsx(TaxIdList, {
           handleActionsClick: handleActionsClick,

package/dist/esm/elements/purchase-label/components/index.js

@@ -1,2 +1,3 @@
 export { RateForm } from './rate-form/rate-form.js';
 export { ShipmentForm } from './shipment-form/shipment-form.js';
+export { CustomsForms } from './customs-forms/customs-forms.js';

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

@@ -32,7 +32,6 @@ const RateView = ({
   rateOptions,
   rates,
   salesOrder,
-  selectedRate,
   shipment,
   showVatFeatures
 }) => {
@@ -76,9 +75,8 @@ const RateView = ({
   }, [features === null || features === void 0 ? void 0 : features.enablePudoUI, pudoRateOptions, rateOptions]);
   const {
     collapsedRateOptionList,
-    COLLAPSED_RATE_VIEW_LIMIT,
     filterVisibleRateOptions
-  } = useFilterVisibleRateOptions(expandedRateOptionList, selectedRate, preferredServiceCodes);
+  } = useFilterVisibleRateOptions(expandedRateOptionList, features);
   const handleShowMoreRates = useCallback(() => {
     var _a;
     setShowHiddenRates === null || setShowHiddenRates === void 0 ? void 0 : setShowHiddenRates(!showHiddenRates);
@@ -197,8 +195,8 @@ const RateView = ({
         onClick: onSelectRate,
         onPaperlessAcknowledgementChange: onPaperlessAcknowledgementChange,
         onSelectServicePoint: onSelectServicePoint,
-        options: showHiddenRates ? expandedRateOptionList : collapsedRateOptionList
-      }, rateSelectCommonProps)), expandedRateOptionList.length > COLLAPSED_RATE_VIEW_LIMIT && jsx(LinkAction, {
+        options: showHiddenRates || !collapsedRateOptionList.length ? expandedRateOptionList : collapsedRateOptionList
+      }, rateSelectCommonProps)), expandedRateOptionList.length > collapsedRateOptionList.length && !!collapsedRateOptionList.length && jsx(LinkAction, {
         css: styles.showMoreOrLessRatesButton,
         icon: showHiddenRates ? "chevronTop" : "chevronBottom",
         iconPlacement: "right",

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 {
@@ -514,13 +515,15 @@ const ShipmentForm = ({
   useEffect(() => {
     hasShipFromAddressErrors && toggleIsEditShipFromAddressFormOpen();
   }, [hasShipFromAddressErrors, toggleIsEditShipFromAddressFormOpen]);
+  const warehouseToEdit = useMemo(() => warehouses === null || warehouses === void 0 ? void 0 : warehouses.find(w => w.warehouseId === editShipFromAddressId), [editShipFromAddressId, warehouses]);
   const [editWarehouseForm, isEditWarehouseFormOpen, toggleIsEditWarehouseFormOpen] = useNestedForm(WarehouseForm, {
     formId: "edit-warehouse-form",
     onSubmit: payload => __awaiter(void 0, void 0, void 0, function* () {
       editShipFromAddressId && (yield handleSubmitEditWarehouse(payload, editShipFromAddressId));
     }),
     submitButtonTitle: t("actions.save"),
-    warehouse: warehouses === null || warehouses === void 0 ? void 0 : warehouses.find(w => w.warehouseId === editShipFromAddressId)
+    warehouse: warehouseToEdit,
+    shouldForceDefault: warehouseToEdit === null || warehouseToEdit === void 0 ? void 0 : warehouseToEdit.isDefault
   });
   const getFundingSourceInsuranceProviderKey = useCallback(provider => {
     if (provider === "parcelguard") {
@@ -532,7 +535,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 +543,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, showMediaMail) => {
+  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 (!showMediaMail && 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, features) => {
+  const collapsedRateOptionList = useMemo(() => filterRateOptions(rateOptions, features === null || features === void 0 ? void 0 : features.showMediaMail), [rateOptions, features]);
+  const filterVisibleRateOptions = useCallback(options => filterRateOptions(options, features === null || features === void 0 ? void 0 : features.showMediaMail), [features]);
   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/shipments-grid/hooks/use-shipments-grid.js

@@ -1,4 +1,4 @@
-import { useGetServiceName } from '../../../hooks/use-get-service-name.js';
+import { useGetServiceData } from '../../../hooks/use-get-service-data.js';
 import { useListShipments, useExportShipments, useGetShipment } from '@shipengine/react-api';
 import { createLocalFileFromBlobResponse } from '../../../utilities/files.js';
 import { useState, useEffect, useMemo } from 'react';
@@ -28,7 +28,7 @@ const useShipmentsGrid = ({
   const initialFilters = getInitialFilters(showShipmentIdFilter, showCreatedDateFilter);
   const {
     getServiceName
-  } = useGetServiceName();
+  } = useGetServiceData();
   const {
     page,
     pageSize,

package/dist/esm/elements/shipments-grid/shipments-grid.js

@@ -1,7 +1,8 @@
 import { __awaiter } from '../../_virtual/_tslib.js';
 import { jsx, jsxs, Fragment } from '@emotion/react/jsx-runtime';
+import { useGetServiceData } from '../../hooks/use-get-service-data.js';
 import { useSortableQuery } from '../../hooks/use-sortable-query.js';
-import { EmptyState, Button, Typography, Tag, TagColor, TagVariant } from '@shipengine/giger';
+import { EmptyState, Button, Typography, Skeleton, IconSize, Tag, TagColor, TagVariant } from '@shipengine/giger';
 import { useMemo } from 'react';
 import { useTranslation } from 'react-i18next';
 import { useShipmentsGrid } from './hooks/use-shipments-grid.js';
@@ -12,6 +13,7 @@ import en from '../../locales/en/index.js';
 import { createElement } from '../../create-element/create-element.js';
 import { useElements } from '../../elements-provider/elements-context-provider.js';
 import { ErrorState } from '../../components/error-state/error-state.js';
+import { CarrierIcon } from '../../components/carrier-icon/carrier-icon.js';
 import { CellFormattedDate } from '../../components/grid-controller/cell-formatted-date.js';
 import { SortableHeader } from '../../components/grid-controller/sortable-header/sortable-header.js';
 import { GridController } from '../../components/grid-controller/grid-controller.js';
@@ -85,6 +87,10 @@ const Component = ({
     sortBy: sortState.by,
     sortDir: sortState.dir
   });
+  const {
+    getServiceInfo,
+    isLoadingCarriers
+  } = useGetServiceData();
   const onRowClick = shipment => __awaiter(void 0, void 0, void 0, function* () {
     setActiveShipmentId(shipment.shipmentId);
     yield onRowClickProp === null || onRowClickProp === void 0 ? void 0 : onRowClickProp(shipment);
@@ -188,13 +194,21 @@ const Component = ({
       }) : "--";
     }
   }, {
-    headerContent: t("list-shipments:headers.shipping"),
+    headerContent: t("list-shipments:headers.service"),
     renderCellContent: shipment => {
-      return jsx(Typography, {
-        component: "p",
-        css: styles.tableParagraph,
-        variant: "body2",
-        children: shipment.serviceName || t("list-shipments:none")
+      const serviceInfo = getServiceInfo(shipment);
+      return isLoadingCarriers ? jsx(Skeleton, {}) : jsxs("div", {
+        css: styles.serviceCell,
+        children: [serviceInfo.hasCarrierIcon && serviceInfo.carrierCode && jsx(CarrierIcon, {
+          carrierCode: serviceInfo.carrierCode,
+          carrierName: serviceInfo.serviceName || serviceInfo.carrierCode,
+          size: IconSize.SIZE_SMALL
+        }), jsx(Typography, {
+          component: "p",
+          css: styles.tableParagraph,
+          variant: "body2",
+          children: serviceInfo.serviceName || t("list-shipments:none")
+        })]
       });
     }
   }, {

package/dist/esm/elements/shipments-grid/shipments-grid.styles.js

@@ -6,6 +6,11 @@ const styles = createStyles({
   }, scopeTheme(theme).getComponentOverride("Table")),
   tableParagraph: {
     margin: 0
+  },
+  serviceCell: {
+    display: "flex",
+    alignItems: "center",
+    gap: "8px"
   }
 });
 

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 };