@shipengine/elements 2.26.2 → 2.26.4

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

@@ -4,7 +4,6 @@ var jsxRuntime = require('@emotion/react/jsx-runtime');
 var giger = require('@shipengine/giger');
 var reactApi = require('@shipengine/react-api');
 var reactQuery = require('@tanstack/react-query');
-var humps = require('humps');
 var React = require('react');
 var reactI18next = require('react-i18next');
 var customExternalCarrierForm = require('./components/custom-external-carrier-form/custom-external-carrier-form.cjs');
@@ -18,25 +17,6 @@ var spacer = require('../../components/spacer/spacer.cjs');
 var buttonGroup = require('../../components/button-group/button-group.cjs');
 var errorFallback = require('../../components/error-fallback/error-fallback.cjs');
 
-function _interopNamespaceDefault(e) {
-  var n = Object.create(null);
-  if (e) {
-    Object.keys(e).forEach(function (k) {
-      if (k !== 'default') {
-        var d = Object.getOwnPropertyDescriptor(e, k);
-        Object.defineProperty(n, k, d.get ? d : {
-          enumerable: true,
-          get: function () { return e[k]; }
-        });
-      }
-    });
-  }
-  n.default = e;
-  return Object.freeze(n);
-}
-
-var humps__namespace = /*#__PURE__*/_interopNamespaceDefault(humps);
-
 /**
  * # ConnectExternalCarrier Component
  *
@@ -113,24 +93,6 @@ const Component = ({
   const formattedJsonSchema = React.useMemo(() => {
     if (!jsonSchema) return {};
     const jsonSchemaClone = JSON.parse(JSON.stringify(jsonSchema));
-    // if property has a ref key, map the property value to the value of the path
-    const mapRefPath = schema => {
-      const {
-        properties
-      } = schema;
-      if (!properties) return schema;
-      for (const key in properties) {
-        const property = properties[key];
-        if (property.$ref) {
-          const propKey = `${property.$ref}`.replace("#/", "");
-          const refPath = humps__namespace.camelize(propKey).split("/");
-          properties[key] = refPath.reduce((acc, path) => {
-            return acc === null || acc === void 0 ? void 0 : acc[path];
-          }, schema);
-        }
-      }
-      return schema;
-    };
     // add nickname to properties if it doesn't exist
     const addNicknameProperty = schema => {
       if (!(schema === null || schema === void 0 ? void 0 : schema.properties)) return schema;
@@ -147,27 +109,7 @@ const Component = ({
       updatedSchema.properties = updatedProperties;
       return updatedSchema;
     };
-    const standardizeCasing = schema => {
-      if (!schema) return schema;
-      const updatedSchema = Object.assign({}, schema);
-      // camelize required fields, as casing varies between carriers
-      if (updatedSchema.required && Array.isArray(updatedSchema.required)) {
-        updatedSchema.required = updatedSchema.required.map(item => {
-          return typeof item === "string" ? humps__namespace.camelize(item) : item;
-        });
-      }
-      // camelize property keys
-      // fail safe to ensure schema properties and required array match in the event the camelizeKeys from shipengine/js-api isn't consistent
-      // TODO: Fix edge cases with camelizeKeys in js-api and remove this
-      if (updatedSchema.properties && typeof updatedSchema.properties === "object") {
-        updatedSchema.properties = Object.entries(updatedSchema.properties).reduce((acc, [key, value]) => {
-          acc[humps__namespace.camelize(key)] = value;
-          return acc;
-        }, {});
-      }
-      return updatedSchema;
-    };
-    const newJsonSchema = standardizeCasing(addNicknameProperty(mapRefPath(jsonSchemaClone)));
+    const newJsonSchema = addNicknameProperty(jsonSchemaClone);
     return newJsonSchema;
   }, [jsonSchema, hasNicknameProperty]);
   const formattedUiSchema = React.useMemo(() => {
@@ -176,9 +118,7 @@ const Component = ({
     const updatedUiSchema = Object.assign({}, uiSchemaClone);
     // add nickname to ui:order and camelize the values to ensure consistency with jsonSchema properties and required array
     if (!hasNicknameProperty && updatedUiSchema["ui:order"]) {
-      // ui:order is typically an array of strings, but apparently can also be an array of arrays of strings, so we need to recursively camelize the items
-      const camelizeUIOrderItem = item => typeof item === "string" ? humps__namespace.camelize(item) : item.map(i => humps__namespace.camelize(i));
-      updatedUiSchema["ui:order"] = [...updatedUiSchema["ui:order"], "nickname"].map(camelizeUIOrderItem);
+      updatedUiSchema["ui:order"] = [...updatedUiSchema["ui:order"], "nickname"];
     }
     return updatedUiSchema;
   }, [uiSchema, hasNicknameProperty]);
@@ -196,7 +136,7 @@ const Component = ({
   if (schemaLoading || carriersLoading || needsRefetch) return jsxRuntime.jsx(loader.Loader, {
     message: t(selectedCarrier ? "loading.connectCarrierForm" : "loading.carriers")
   });
-  if (schemaError) {
+  if (schemaError && selectedCarrier && !customExternalCarrierForm.hasCustomExternalCarrierConnectionForm(selectedCarrier)) {
     return jsxRuntime.jsxs(jsxRuntime.Fragment, {
       children: [jsxRuntime.jsx(giger.InlineNotification, {
         type: giger.NotificationType.ERROR,

package/dist/cjs/workflows/label-workflow/label-workflow.cjs

@@ -62,7 +62,31 @@ 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 shipmentId = _multiplexedId && "shipmentId" in _multiplexedId ? _multiplexedId.shipmentId : undefined;
+  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 {
     data: insuranceAccount,
     isInitialLoading: insuranceIsLoading
@@ -180,9 +204,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/esm/components/cc-provider-logo/cc-provider-logo.js

@@ -12,7 +12,7 @@ const CcProviderLogo = ({
   height = 36
 }) => {
   const providerLogos = {
-    americanExpress: SvgAmex,
+    american_express: SvgAmex,
     discover: SvgDiscover,
     mastercard: SvgMastercard,
     visa: SvgVisa
@@ -23,6 +23,7 @@ const CcProviderLogo = ({
       size: IconSize.SIZE_LARGE
     });
   }
+  // TODO: LMNT-1810 - Add missing provider logos
   const Logo = providerLogos[provider];
   return jsx(Logo, {
     height: height,

package/dist/esm/components/forms/wallet-form/wallet-schema.js

@@ -75,7 +75,7 @@ const creditCardSchema = z.object({
     expirationMonth: expirationMonth,
     expirationYear: expirationYear,
     name: creditCard.name,
-    provider: creditCardVendor === "american-express" ? "americanExpress" : creditCardVendor
+    provider: creditCardVendor === "american-express" ? "american_express" : creditCardVendor
   };
 });
 const getWalletSchema = (emailRequirement, blackboxRequirement) => {

package/dist/esm/components/shipment-not-found-error/shipment-not-found-error.js

@@ -5,12 +5,26 @@ import { useTranslation } from 'react-i18next';
 import { styles } from './shipment-not-found-error.styles.js';
 
 const ShipmentNotFoundError = ({
-  shipmentId,
+  identifier,
   onCreateNewShipment
 }) => {
   const {
     t
   } = useTranslation(["common", "purchase-label"]);
+  const getIdentifierInfo = identifier => {
+    // Order should match the actual search priority in useConfigureShipment:
+    const identifierKeys = ["shipmentId", "externalShipmentId", "salesOrderId", "externalOrderId", "externalOrderNumber"];
+    const foundKey = identifierKeys.find(key => identifier === null || identifier === void 0 ? void 0 : identifier[key]);
+    const identifierKey = foundKey || "shipmentId";
+    return {
+      type: t(`purchase-label:identifierTypes.${identifierKey}`),
+      value: identifier === null || identifier === void 0 ? void 0 : identifier[identifierKey]
+    };
+  };
+  const {
+    type: identifierType,
+    value: identifierNumber
+  } = getIdentifierInfo(identifier);
   return jsxs("div", {
     css: styles.container,
     children: [jsx("div", {
@@ -22,7 +36,8 @@ const ShipmentNotFoundError = ({
     }), jsx("div", {
       css: styles.message,
       children: t("common:errorMessages.shipmentNotFound", {
-        id: shipmentId
+        identifierType,
+        identifierNumber
       })
     }), jsx(Button, {
       "data-testid": "create-new-shipment",

package/dist/esm/components/suspend-purchase/suspend-purchase.js

@@ -9,7 +9,7 @@ const SuspendPurchase = ({
   isLoading,
   data,
   onCreateNewShipment,
-  shipmentId
+  identifier
 }) => {
   const {
     t
@@ -36,8 +36,8 @@ const SuspendPurchase = ({
           throw new Error(t("common:errorMessages.labelHasBeenPurchased"));
         case "shipment_not_found":
           return jsx(ShipmentNotFoundError, {
-            onCreateNewShipment: onCreateNewShipment,
-            shipmentId: shipmentId
+            identifier: identifier,
+            onCreateNewShipment: onCreateNewShipment
           });
       }
     }

package/dist/esm/elements/purchase-label/hooks/use-address.js

@@ -160,7 +160,7 @@ const useAddress = ({
       if (warning && warning.error) return warning;
       const value = addressMinusGeolocation[key];
       if (!value) return warning;
-      if (/^[0-9\p{Script=Latin}\p{P}\p{S}\s]+$/u.test(value)) return warning;
+      if (/^[0-9A-Za-z\u00C0-\u017F\u0100-\u024F\u1E00-\u1EFF\u0020-\u002F\u003A-\u0040\u005B-\u0060\u007B-\u007E\u00A0-\u00BF\u2000-\u206F\u2E00-\u2E7F\s]+$/u.test(value)) return warning;
       if (key === "name" || key === "companyName") {
         return {
           error: false,

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

@@ -90,9 +90,15 @@ const Component = _a => {
   return jsx(SuspendPurchase, {
     data: shipment || salesOrder,
     errors: errors,
+    identifier: {
+      externalOrderId,
+      externalOrderNumber,
+      externalShipmentId,
+      salesOrderId,
+      shipmentId
+    },
     isLoading: isLoading || insuranceIsLoading,
     onCreateNewShipment: createNewShipmentForNotFound,
-    shipmentId: shipmentId,
     children: jsx(ConfigureShipment, Object.assign({
       currency: currency,
       features: features,

package/dist/esm/hooks/use-configure-shipment.js

@@ -20,8 +20,8 @@ const useConfigureShipment = ({
   warehouseId,
   useWarehouses = true
 }) => {
-  // Track when we've created a replacement shipment for a "not found" case
-  const [replacementShipmentId, setReplacementShipmentId] = useState();
+  // Track when user manually created a shipment for a "not found" case
+  const [manuallyCreatedShipmentId, setManuallyCreatedShipmentId] = useState();
   // Queue of incomplete requirement keys (i.e., Ship From addresses, Warehouses, Carriers)
   const incompleteRequirementsKeys = useMemo(() => [], []);
   const {
@@ -45,6 +45,7 @@ const useConfigureShipment = ({
     // Dont run Sales Order Import unless the Sales order info is present
     enabled: !!externalOrderNumber || !!orderSourceCode || !!salesOrderId || !!externalOrderId,
     externalOrderId,
+    externalOrderNumber,
     orderSourceCode,
     salesOrderId
   });
@@ -61,24 +62,49 @@ const useConfigureShipment = ({
     isInitialLoading: isExternalShipmentInitialLoading,
     isFetching: isExternalShipmentFetching
   } = useGetShipmentByExternalId({
-    enabled: !!externalShipmentId && !shipmentId,
+    enabled: !!externalShipmentId && !shipmentId && !manuallyCreatedShipmentId,
     queryFnParams: {
       externalId: externalShipmentId !== null && externalShipmentId !== void 0 ? externalShipmentId : ""
     }
+    // TODO: weird refetch on focus behavior
   });
+  // #region List Sales Order Shipments
+  const externalOrderIds = useMemo(() => {
+    return externalOrderId ? [externalOrderId] : undefined;
+  }, [externalOrderId]);
+  const salesOrderIds = useMemo(() => {
+    return salesOrderId ? [salesOrderId] : salesOrder ? [salesOrder.salesOrderId] :
+    // TODO: current workaround - revert to being undefined rather than empty list
+    [];
+  }, [salesOrderId, salesOrder]);
+  const shipmentIds = useMemo(() => {
+    return manuallyCreatedShipmentId ? [manuallyCreatedShipmentId] : shipmentId ? [shipmentId] : externalShipment ? [externalShipment.shipmentId] : newV1Shipment ? [newV1Shipment.shipments[0].shipmentId] : undefined;
+  }, [manuallyCreatedShipmentId, shipmentId, externalShipment, newV1Shipment]);
+  const listSalesOrderShipmentsParams = useMemo(() => {
+    // TODO: useListSalesOrderShipments needs to be able to use the enabled prop, this is a workaround
+    // Prevent query with stale params during shipment creation or when V1 shipment exists but manuallyCreatedShipmentId not set
+    if (creatingV1Shipment && !manuallyCreatedShipmentId || newV1Shipment && !manuallyCreatedShipmentId) {
+      return {};
+    }
+    if (manuallyCreatedShipmentId) {
+      return {
+        shipmentIds
+      };
+    }
+    return {
+      externalOrderIds,
+      salesOrderIds,
+      shipmentIds
+    };
+  }, [manuallyCreatedShipmentId, externalOrderIds, salesOrderIds, shipmentIds, creatingV1Shipment, newV1Shipment]);
   const {
     data: salesOrderShipments,
     error: listSalesOrderShipmentsErrors,
     refetch: refetchSalesOrderShipments,
     isInitialLoading: listSalesOrderShipmentsInitiallyLoading,
     isFetching: listSalesOrderShipmentsIsFetching
-  } = useListSalesOrderShipments({
-    externalOrderIds: externalOrderId ? [externalOrderId] : undefined,
-    salesOrderIds: salesOrderId ? [salesOrderId] : salesOrder ? [salesOrder.salesOrderId] :
-    // TODO: current workaround - revert to being undefined rather than empty list
-    [],
-    shipmentIds: replacementShipmentId ? [replacementShipmentId] : shipmentId ? [shipmentId] : externalShipment ? [externalShipment.shipmentId] : newV1Shipment ? [newV1Shipment.shipments[0].shipmentId] : undefined
-  });
+  } = useListSalesOrderShipments(listSalesOrderShipmentsParams);
+  // #endregion
   const {
     error: createSalesOrderShipmentErrors,
     mutateAsync: createSalesOrderShipment,
@@ -103,6 +129,7 @@ const useConfigureShipment = ({
     }
     return null;
   }), [createV1Shipment, defaultShipFromAddress, defaultWarehouse, warehouseId, refetchSalesOrderShipments]);
+  // #region Create Sales Order Shipment
   // Handles the creation of new shipments for the sales order flow and one-off flow
   const handleShipmentCreation = useCallback(() => __awaiter(void 0, void 0, void 0, function* () {
     var _a, _b, _c;
@@ -152,17 +179,23 @@ const useConfigureShipment = ({
     }
     // Create a Shipment for one-off flow
     if (!salesOrderId && !externalOrderId && !externalOrderNumber && !orderSourceCode && !shipmentId && !externalShipmentId) {
-      yield createV1ShipmentWithDefaults();
+      const v1Shipment = yield createV1ShipmentWithDefaults();
+      // Set manuallyCreatedShipmentId to ensure proper query parameter handling
+      if (v1Shipment) {
+        setManuallyCreatedShipmentId(v1Shipment.shipments[0].shipmentId);
+      }
     }
   }), [createSalesOrderShipment, createV1ShipmentWithDefaults, creatingSalesOrderShipment, creatingV1Shipment, defaultShipFromAddress, defaultWarehouse, externalOrderId, externalOrderNumber, externalShipmentId, incompleteRequirementsKeys, isExternalShipmentFetching, isExternalShipmentInitialLoading, isFetchingWarehouses, isInitialLoadingWarehouses, labelPurchasedSalesOrderShipment, listSalesOrderShipmentsInitiallyLoading, listSalesOrderShipmentsIsFetching, orderSourceCode, pendingSalesOrderShipment, salesOrder, salesOrderId, salesOrderShipmentCreated, shipFromAddresses === null || shipFromAddresses === void 0 ? void 0 : shipFromAddresses.length, shipmentId, useWarehouses, v1shipmentCreated, warehouseId, warehouses]);
+  // #endregion
   const createNewShipmentForNotFound = useCallback(() => __awaiter(void 0, void 0, void 0, function* () {
     // Force create a new shipment even if shipmentId exists (for shipment_not_found case)
     const v1Shipment = yield createV1ShipmentWithDefaults();
     if (v1Shipment) {
-      // Store the new shipment ID to override the stale one
-      setReplacementShipmentId(v1Shipment.shipments[0].shipmentId);
+      setManuallyCreatedShipmentId(v1Shipment.shipments[0].shipmentId);
+      // Refetch to ensure we have the latest shipment data
+      yield refetchSalesOrderShipments();
     }
-  }), [createV1ShipmentWithDefaults]);
+  }), [createV1ShipmentWithDefaults, refetchSalesOrderShipments]);
   const refetchPendingSalesOrderShipments = useCallback(() => __awaiter(void 0, void 0, void 0, function* () {
     const {
       data: shipments
@@ -186,7 +219,83 @@ 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 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 CodedError("shipment_cancelled", {
+  const isConfigureShipmentLoading = 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 = 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 = useMemo(() => {
+    if (manuallyCreatedShipmentId) return true;
+    if (pendingSalesOrderShipment) return true;
+    if (labelPurchasedSalesOrderShipment) return true;
+    return false;
+  }, [labelPurchasedSalesOrderShipment, manuallyCreatedShipmentId, pendingSalesOrderShipment]);
+  const showShipmentNotFoundError = 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 CodedError("shipment_cancelled", {
     errorCode: "invalid_status",
     errorSource: "elements",
     errorType: "business_rules"
@@ -198,16 +307,17 @@ const useConfigureShipment = ({
     errorCode: "unknown",
     errorSource: "elements",
     errorType: "business_rules"
-  })] : []), ...((salesOrderShipments === null || salesOrderShipments === void 0 ? void 0 : salesOrderShipments.length) === 0 && shipmentId ? [new CodedError("shipment_not_found", {
+  })] : []), ...(showShipmentNotFoundError ? [new CodedError("shipment_not_found", {
     errorCode: "invalid_status",
     errorSource: "elements",
     errorType: "business_rules"
   })] : [])];
+  // #endregion
   return {
     carriers,
     createNewShipmentForNotFound,
     errors: errors.length > 0 ? errors : undefined,
-    isLoading: (isSalesOrderLoading || !(salesOrderShipments === null || salesOrderShipments === void 0 ? void 0 : salesOrderShipments.length) || creatingSalesOrderShipment) && errors.length === 0,
+    isLoading: isConfigureShipmentLoading && errors.length === 0,
     refetchPendingSalesOrderShipments,
     salesOrder,
     shipment: pendingSalesOrderShipment !== null && pendingSalesOrderShipment !== void 0 ? pendingSalesOrderShipment : labelPurchasedSalesOrderShipment,

package/dist/esm/hooks/use-import-sales-order.js

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

package/dist/esm/locales/en/common.json.js

@@ -166,7 +166,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 shipment with ID: {{id}}.",
+		shipmentNotFound: "Cannot find {{identifierType}}: {{identifierNumber}}",
 		shipmentCancelled: "This shipment is Cancelled in ShipStation. Log into ShipStation to restore the order to Awaiting Shipment status.",
 		unableToLoad: {
 			accountSettings: "Unable to load account settings",

package/dist/esm/locales/en/purchase-label.json.js

@@ -30,6 +30,13 @@ 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"
 	},

package/dist/esm/package.json.js

@@ -1,3 +1,3 @@
-var version = "2.26.2";
+var version = "2.26.4";
 
 export { version };