@shipengine/elements 2.24.1 → 2.25.0

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

@@ -4,7 +4,7 @@ import { getDefaultShipFromAddress } from '../utilities/shipengine/address.js';
 import { getIsCustomsRequiredForSalesOrder, getCustomsFromSalesOrder } from '../utilities/shipengine/sales-order.js';
 import { getShipmentByStatus } from '../utilities/shipengine/shipment.js';
 import { getDefaultWarehouse, getWarehouseById } from '../utilities/shipengine/warehouses.js';
-import { useMemo, useCallback, useEffect } from 'react';
+import { useState, useMemo, useCallback, useEffect } from 'react';
 import { useImportSalesOrder } from './use-import-sales-order.js';
 
 const useConfigureShipment = ({
@@ -20,6 +20,8 @@ const useConfigureShipment = ({
   warehouseId,
   useWarehouses = true
 }) => {
+  // Track when we've created a replacement shipment for a "not found" case
+  const [replacementShipmentId, setReplacementShipmentId] = useState();
   // Queue of incomplete requirement keys (i.e., Ship From addresses, Warehouses, Carriers)
   const incompleteRequirementsKeys = useMemo(() => [], []);
   const {
@@ -75,7 +77,7 @@ const useConfigureShipment = ({
     salesOrderIds: salesOrderId ? [salesOrderId] : salesOrder ? [salesOrder.salesOrderId] :
     // TODO: current workaround - revert to being undefined rather than empty list
     [],
-    shipmentIds: shipmentId ? [shipmentId] : externalShipment ? [externalShipment.shipmentId] : newV1Shipment ? [newV1Shipment.shipments[0].shipmentId] : undefined
+    shipmentIds: replacementShipmentId ? [replacementShipmentId] : shipmentId ? [shipmentId] : externalShipment ? [externalShipment.shipmentId] : newV1Shipment ? [newV1Shipment.shipments[0].shipmentId] : undefined
   });
   const {
     error: createSalesOrderShipmentErrors,
@@ -88,6 +90,19 @@ const useConfigureShipment = ({
   const cancelledShipment = getShipmentByStatus("cancelled", salesOrderShipments);
   const defaultWarehouse = getDefaultWarehouse(warehouses);
   const defaultShipFromAddress = getDefaultShipFromAddress(shipFromAddresses);
+  // Common function to create a V1 shipment
+  const createV1ShipmentWithDefaults = useCallback(() => __awaiter(void 0, void 0, void 0, function* () {
+    const v1Shipment = yield createV1Shipment(Object.assign({}, (defaultShipFromAddress === null || defaultShipFromAddress === void 0 ? void 0 : defaultShipFromAddress.originAddress) ? {
+      shipFrom: defaultShipFromAddress.originAddress
+    } : {
+      warehouseId: warehouseId ? warehouseId : defaultWarehouse.warehouseId
+    }));
+    if (v1Shipment) {
+      yield refetchSalesOrderShipments();
+      return v1Shipment;
+    }
+    return null;
+  }), [createV1Shipment, defaultShipFromAddress, defaultWarehouse, warehouseId, refetchSalesOrderShipments]);
   // 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;
@@ -137,16 +152,17 @@ const useConfigureShipment = ({
     }
     // Create a Shipment for one-off flow
     if (!salesOrderId && !externalOrderId && !externalOrderNumber && !orderSourceCode && !shipmentId && !externalShipmentId) {
-      const v1Shipment = yield createV1Shipment(Object.assign({}, (defaultShipFromAddress === null || defaultShipFromAddress === void 0 ? void 0 : defaultShipFromAddress.originAddress) ? {
-        shipFrom: defaultShipFromAddress.originAddress
-      } : {
-        warehouseId: warehouseId ? warehouseId : defaultWarehouse.warehouseId
-      }));
-      if (v1Shipment) {
-        yield refetchSalesOrderShipments();
-      }
+      yield createV1ShipmentWithDefaults();
+    }
+  }), [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]);
+  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);
     }
-  }), [createSalesOrderShipment, createV1Shipment, creatingSalesOrderShipment, creatingV1Shipment, defaultShipFromAddress, defaultWarehouse, externalOrderId, externalOrderNumber, externalShipmentId, incompleteRequirementsKeys, isExternalShipmentFetching, isExternalShipmentInitialLoading, isFetchingWarehouses, isInitialLoadingWarehouses, labelPurchasedSalesOrderShipment, listSalesOrderShipmentsInitiallyLoading, listSalesOrderShipmentsIsFetching, orderSourceCode, pendingSalesOrderShipment, refetchSalesOrderShipments, salesOrder, salesOrderId, salesOrderShipmentCreated, shipFromAddresses === null || shipFromAddresses === void 0 ? void 0 : shipFromAddresses.length, shipmentId, useWarehouses, v1shipmentCreated, warehouseId, warehouses]);
+  }), [createV1ShipmentWithDefaults]);
   const refetchPendingSalesOrderShipments = useCallback(() => __awaiter(void 0, void 0, void 0, function* () {
     const {
       data: shipments
@@ -178,13 +194,18 @@ const useConfigureShipment = ({
     errorCode: "invalid_status",
     errorSource: "elements",
     errorType: "business_rules"
-  })] : []), ...(incompleteRequirementsKeys.length > 0 ? [new CodedError(incompleteRequirementsKeys.length > 1 ? "no_carriers_and_warehouses" : incompleteRequirementsKeys[0], {
+  })] : []), ...(incompleteRequirementsKeys.length > 0 ? [new CodedError(incompleteRequirementsKeys.length === 1 ? "no_carriers_and_warehouses" : incompleteRequirementsKeys[0], {
     errorCode: "unknown",
     errorSource: "elements",
     errorType: "business_rules"
+  })] : []), ...((salesOrderShipments === null || salesOrderShipments === void 0 ? void 0 : salesOrderShipments.length) === 0 && shipmentId ? [new CodedError("shipment_not_found", {
+    errorCode: "invalid_status",
+    errorSource: "elements",
+    errorType: "business_rules"
   })] : [])];
   return {
     carriers,
+    createNewShipmentForNotFound,
     errors: errors.length > 0 ? errors : undefined,
     isLoading: (isSalesOrderLoading || !(salesOrderShipments === null || salesOrderShipments === void 0 ? void 0 : salesOrderShipments.length) || creatingSalesOrderShipment) && errors.length === 0,
     refetchPendingSalesOrderShipments,

package/dist/esm/hooks/use-helpers.js

@@ -1,4 +1,5 @@
 import { useListCarriers, useListWarehouses } from '@shipengine/react-api';
+import { getUsStates, getCountries } from '../utilities/address.js';
 import { isOnboarded, validateShipFromAddress } from '../utilities/checks.js';
 
 const useHelpers = () => {
@@ -15,7 +16,9 @@ const useHelpers = () => {
   return {
     helpersReady,
     sellerOnboarded,
-    validateShipFromAddress
+    validateShipFromAddress,
+    getCountries,
+    getUsStates
   };
 };
 

package/dist/esm/index.js

@@ -2,6 +2,7 @@ export * from '@shipengine/react-api';
 export { createStyles, scopeTheme } from './utilities/styles.js';
 export { getDefaultFeatures } from './utilities/feature-flags/feature-flags.js';
 export { getSellerIdFromToken, isOnboarded, validateShipFromAddress } from './utilities/checks.js';
+export { getCountries, getUsStates } from './utilities/address.js';
 export { Country, UsState, UsaCity, addressNameRegex, countries, countryCodes, euCountryCodes, postalCodeRegex, usCities, usStateCodes, usStates } from './constants/shipengine/address.js';
 import * as manageCarriers from './elements/manage-carriers/manage-carriers.js';
 export { manageCarriers as ManageCarriers };

package/dist/esm/locales/en/account-settings.json.js

@@ -24,6 +24,12 @@ var accoutSettings = {
 		labelLayout: "Shipping Label Layout",
 		unitSettings: "Units of Measure",
 		vatSettings: "Tax Settings"
+	},
+	errors: {
+		paymentMethod: {
+			title: "Error Updating Payment Method",
+			description: "There was an error updating your payment method. Ensure your payment information is correct and try again. If the problem persists, contact support at {{email}}."
+		}
 	}
 }
 };

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

@@ -161,10 +161,12 @@ var common = {
 		total: "Total"
 	},
 	errorMessages: {
+		fundingSourceCreationFailed: "Please check your payment and billing details, and confirm that your bank hasn’t blocked the payment method. If the issue persists, please contact support at {{email}}.",
 		contactSupport: "Your transaction may not have processed as expected. Please contact support at {{email}}.",
 		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}}.",
 		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

@@ -10,7 +10,8 @@ var purchaseLabel = {
 		showItems: "Show items",
 		showMoreRates: "Show more rates",
 		showFewerRates: "Show fewer rates",
-		saveRate: "Save Rate"
+		saveRate: "Save Rate",
+		createNewShipment: "Create New Shipment"
 	},
 	balance: {
 		currentBalance: "Available Funds:",
@@ -127,7 +128,6 @@ var purchaseLabel = {
 		otherLocations: "Other drop off points near you:",
 		noServicePointsForService: "There are no drop off locations for this service within 10km of your search area.",
 		error: "Unable to find drop off locations within 10km of your search area.",
-		paperless: "Print & Paperless",
 		localTimeDisclaimer: "Hours shown in local time"
 	},
 	shipToAddressFormFields: "Ship To Address Form Fields",
@@ -141,7 +141,9 @@ var purchaseLabel = {
 	},
 	warnings: {
 		parcelGuardShipDate: "ParcelGuard must be purchased within 48 hours of the ship date. Please update the ship date to continue."
-	}
+	},
+	paperlessAvailable: "Paperless available",
+	usePaperlessLabel: "Use Paperless Label (QR Code)"
 }
 };
 

package/dist/esm/package.json.js

@@ -1,3 +1,3 @@
-var version = "2.24.1";
+var version = "2.25.0";
 
 export { version };

package/dist/esm/utilities/address.js

@@ -0,0 +1,26 @@
+import { usStates, countries } from '../constants/shipengine/address.js';
+
+/**
+ * Returns a simplified list of countries for use in dropdowns and forms.
+ *
+ * @returns Array of country objects with name and code properties
+ */
+const getCountries = () => {
+  return countries.map(country => ({
+    name: country.name,
+    code: country.code
+  }));
+};
+/**
+ * Returns a simplified list of US states for use in dropdowns and forms.
+ *
+ * @returns Array of US state objects with name and code properties
+ */
+const getUsStates = () => {
+  return usStates.map(state => ({
+    name: state.name,
+    code: state.code
+  }));
+};
+
+export { getCountries, getUsStates };

package/dist/esm/utilities/index.js

@@ -1,3 +1,4 @@
 export { createStyles, scopeTheme } from './styles.js';
 export { getSellerIdFromToken, isOnboarded, validateShipFromAddress } from './checks.js';
+export { getCountries, getUsStates } from './address.js';
 export { getDefaultFeatures } from './feature-flags/feature-flags.js';

package/dist/esm/utilities/money.js

@@ -36,6 +36,19 @@ const calculateTotal = (...values) => {
     return value ? total + ((_a = value.amount) !== null && _a !== void 0 ? _a : 0) : total;
   }, 0);
 };
+/**
+ * @internal
+ *
+ * # Money Utils - maskCreditCardNumber
+ */
+const maskCreditCardNumber = cc => {
+  const sanitizedCC = cc.replace(/\s/g, "");
+  if (!sanitizedCC || sanitizedCC.length < 15 || sanitizedCC.length > 16) {
+    return cc;
+  }
+  const maskedCCNumber = "*".repeat(sanitizedCC.length - 4) + sanitizedCC.slice(-4);
+  return maskedCCNumber.replace(/(.{4})/g, "$1 ").trim();
+};
 /**
  * @internal
  *
@@ -94,4 +107,4 @@ const getCurrencySymbolFromString = currency => {
   return currencySymbol;
 };
 
-export { calculateTotal, currencySymbol, formatCreditCardNumber, formatExpiration, formatMoney, getCurrencyFromString, getCurrencySymbolFromString };
+export { calculateTotal, currencySymbol, formatCreditCardNumber, formatExpiration, formatMoney, getCurrencyFromString, getCurrencySymbolFromString, maskCreditCardNumber };

package/dist/esm/utilities/rate-warning-messages.js

@@ -0,0 +1,23 @@
+import rateMessages from '../data/rate-messages.json.js';
+
+/**
+ * Builds warning messages for a rate by combining messages from different sources:
+ * 1. Messages for serviceCode:shipDay combination
+ * 2. Messages for serviceCode:packageType combination
+ * 3. Messages for serviceCode only
+ * 4. Existing warning messages from the rate
+ */
+const buildRateWarningMessages = ({
+  serviceCode,
+  packageType,
+  shipDay,
+  existingWarningMessages = []
+}) => {
+  const keys = [shipDay && `${serviceCode}:${shipDay}`, packageType && `${serviceCode}:${packageType}`, serviceCode].filter(Boolean);
+  return [...keys.flatMap(key => {
+    var _a;
+    return (_a = rateMessages[key]) !== null && _a !== void 0 ? _a : [];
+  }), ...existingWarningMessages];
+};
+
+export { buildRateWarningMessages };

package/dist/esm/utilities/shipengine/warehouses.js

@@ -1,5 +1,6 @@
 const getDefaultWarehouse = warehouses => {
-  return warehouses === null || warehouses === void 0 ? void 0 : warehouses.find(w => w.isDefault);
+  var _a;
+  return (_a = warehouses === null || warehouses === void 0 ? void 0 : warehouses.find(w => w.isDefault)) !== null && _a !== void 0 ? _a : warehouses === null || warehouses === void 0 ? void 0 : warehouses[0];
 };
 const getWarehouseById = (warehouseId, warehouses) => {
   return warehouses === null || warehouses === void 0 ? void 0 : warehouses.find(w => w.warehouseId === warehouseId);

package/dist/esm/workflows/connect-external-carrier/connect-external-carrier.js

@@ -64,7 +64,7 @@ const Component = ({
     refetch: refetchSchema
   } = useGetCarrierConnectionForm({
     carrierName: selectedCarrier !== null && selectedCarrier !== void 0 ? selectedCarrier : "apicode-dummy-carrier",
-    enabled: false
+    enabled: !!selectedCarrier
   });
   useEffect(() => {
     if (selectedCarrier && needsRefetch) {
@@ -131,7 +131,9 @@ const Component = ({
       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(humps.camelize);
+        updatedSchema.required = updatedSchema.required.map(item => {
+          return typeof item === "string" ? humps.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
@@ -153,7 +155,9 @@ 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"]) {
-      updatedUiSchema["ui:order"] = [...updatedUiSchema["ui:order"], "nickname"].map(humps.camelize);
+      // 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.camelize(item) : item.map(i => humps.camelize(i));
+      updatedUiSchema["ui:order"] = [...updatedUiSchema["ui:order"], "nickname"].map(camelizeUIOrderItem);
     }
     return updatedUiSchema;
   }, [uiSchema, hasNicknameProperty]);

package/dist/esm/workflows/label-workflow/label-workflow.js

@@ -44,6 +44,7 @@ const Component = _a => {
     data: accountSettings
   } = useGetAccountSettings();
   const {
+    createNewShipmentForNotFound,
     shipment,
     salesOrder,
     isLoading: isConfiguringShipment,
@@ -57,19 +58,24 @@ const Component = _a => {
     useWarehouses: (_b = propFeatures === null || propFeatures === void 0 ? void 0 : propFeatures.shipmentForm) === null || _b === void 0 ? void 0 : _b.useWarehouses,
     warehouseId
   }));
+  // 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 {
     data: insuranceAccount,
     isInitialLoading: insuranceIsLoading
   } = useGetInsuranceAccount((shipment === null || shipment === void 0 ? void 0 : shipment.insuranceProvider) === SE.InsuranceProviderType.SHIPSURANCE ? SE.InsuranceProviderType.SHIPSURANCE : undefined);
   const {
     data: labelsResponse,
-    isLoading: isLabelsLoading,
+    isFetching: isLabelsLoading,
     error: listLabelsErrors,
     refetch: refetchLabels
   } = useListLabels({
-    enabled: _multiplexedId && "shipmentId" in _multiplexedId ? true : !!(shipment === null || shipment === void 0 ? void 0 : shipment.shipmentId),
+    enabled:
+    // Don't enable if we have a shipment_not_found error (avoid reusing bad ID)
+    hasShipmentNotFoundError ? false : _multiplexedId && "shipmentId" in _multiplexedId ? true : !!(shipment === null || shipment === void 0 ? void 0 : shipment.shipmentId),
     queryFnParams: {
-      shipmentId: _multiplexedId && "shipmentId" in _multiplexedId ? _multiplexedId.shipmentId : shipment === null || shipment === void 0 ? void 0 : shipment.shipmentId
+      shipmentId: (shipment === null || shipment === void 0 ? void 0 : shipment.shipmentId) || (!hasShipmentNotFoundError ? shipmentId : undefined)
     }
   });
   /**
@@ -173,6 +179,8 @@ const Component = _a => {
     data: shipment || salesOrder,
     errors: errors.length ? errors : undefined,
     isLoading: isLabelsLoading || isConfiguringShipment || insuranceIsLoading,
+    onCreateNewShipment: createNewShipmentForNotFound,
+    shipmentId: shipmentId,
     children: element && getElement(element)
   });
 };

package/dist/esm/workflows/onboarding/components/confirmation-and-submission-step/confirmation-and-submission-step.js

@@ -71,7 +71,7 @@ const ConfirmationAndSubmissionStep = ({
       }),
       children: [jsx(CcProviderLogo, {
         provider: provider,
-        width: 36
+        width: 56
       }), jsx(Typography, {
         variant: "body2",
         children: `**** **** **** ${last4 !== null && last4 !== void 0 ? last4 : "****"}`

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

@@ -1,8 +1,10 @@
 import { __awaiter } from '../../../../_virtual/_tslib.js';
+import { useScrubErrors } from '../../../../hooks/use-scrub-errors.js';
 import { useAddSandboxCarriers, useCreateFundingSource, useUpdateFundingSource, useRegisterCarrier } from '@shipengine/react-api';
 import { getSellerIdFromToken } from '../../../../utilities/checks.js';
 import { getDefaultWarehouse } from '../../../../utilities/shipengine/warehouses.js';
 import { useState, useCallback } from 'react';
+import { useTranslation } from 'react-i18next';
 import { useManageWarehouses } from '../../../../features/manage-warehouses/use-manage-warehouses.js';
 import { useElements } from '../../../../elements-provider/elements-context-provider.js';
 
@@ -13,6 +15,9 @@ const useConfirmationAndSubmissionStep = ({
     globalFeatures,
     getToken
   } = useElements();
+  const {
+    t
+  } = useTranslation();
   const [isSubmittingOnboarding, setIsSubmittingOnboarding] = useState(false);
   const {
     createWarehouse,
@@ -33,6 +38,15 @@ const useConfirmationAndSubmissionStep = ({
     mutateAsync: createFundingSource,
     reset: resetCreateFundingSource
   } = useCreateFundingSource();
+  const displayableCreateFundingSourceErrors = useScrubErrors({
+    errors: createFundingSourceErrors !== null && createFundingSourceErrors !== void 0 ? createFundingSourceErrors : undefined,
+    predicate: useCallback(e => e.message.includes("An unexpected error occurred."), []),
+    scrubber: useCallback(() => {
+      return `${t("common:errorMessages.fundingSourceCreationFailed", {
+        email: globalFeatures.supportEmailAddress
+      })} `;
+    }, [globalFeatures.supportEmailAddress, t])
+  });
   const {
     error: updatePaymentMethodErrors,
     isLoading: isUpdatingPaymentMethod,
@@ -294,7 +308,9 @@ const useConfirmationAndSubmissionStep = ({
     setIsSubmittingOnboarding(false);
   }), [onboardSeller, updateExistingFundingSource, onStepComplete, createFundingSourceErrors, registerCarrierErrors, updatePaymentMethodErrors, updateWarehouseErrors]);
   return {
-    createFundingSourceErrors,
+    createFundingSourceErrors: displayableCreateFundingSourceErrors === null || displayableCreateFundingSourceErrors === void 0 ? void 0 : displayableCreateFundingSourceErrors.map(message => ({
+      message
+    })),
     createOnboardingSubmissionHandler,
     isLoading: {
       connectingCarriers: isRegisteringCarriers,

package/dist/esm/workflows/onboarding/components/onboarding-wizard/onboarding-wizard.js

@@ -59,6 +59,7 @@ const OnboardingWizard = ({
     isLoadingTermsAgreementStep,
     fundingSourceRequiredTerms,
     fundingSourceMetadata,
+    hasFreeStampsConnected,
     handleSubmitTermsAgreement,
     refetchCarriers,
     refetchFundingSources,
@@ -165,8 +166,10 @@ const OnboardingWizard = ({
       return jsx(TermsAgreementStep, {
         carrierProfilesToRegister: carrierProfilesToRegister,
         enabledCarrierProfiles: enabledCarrierProfiles,
+        fundingSourceRequiredTerms: fundingSourceRequiredTerms,
         insuranceProviderProfiles: insuranceProviderProfiles,
-        onSubmit: handleSubmitTermsAgreement
+        onSubmit: handleSubmitTermsAgreement,
+        showStampsLogo: hasFreeStampsConnected
       });
     },
     label: t("onboarding:stepLabel.termsAgreement")

package/dist/esm/workflows/onboarding/components/terms-agreement-form/terms-agreement-form.js

@@ -18,6 +18,7 @@ import { SubmitButton } from '../../../../components/field/submit-button/submit-
 const TermsAgreementForm = ({
   carrierTerms,
   hideTerms,
+  requiredTerms = [],
   insuranceProviderTerms,
   isSubmitDisabled,
   onSubmit
@@ -96,7 +97,9 @@ const TermsAgreementForm = ({
               title: t("onboarding:termsAndAgreementLinkText.auctanePrivacyPolicy")
             }]
           }
-        }), !!carrierTerms.length && jsxs(Fragment, {
+        }), requiredTerms.map(term => jsx(DisplayTerm, {
+          term: term
+        }, term.termType)), !!carrierTerms.length && jsxs(Fragment, {
           children: [jsx(Spacer, {}), jsx(Typography, {
             bold: true,
             variant: "body1",

package/dist/esm/workflows/onboarding/components/terms-agreement-step/terms-agreement-step.js

@@ -14,7 +14,9 @@ const TermsAgreementStep = ({
   carrierProfilesToRegister,
   insuranceProviderProfiles,
   onSubmit,
-  enabledCarrierProfiles
+  enabledCarrierProfiles,
+  fundingSourceRequiredTerms,
+  showStampsLogo = false
 }) => {
   var _a, _b, _c, _d, _e;
   const {
@@ -47,8 +49,16 @@ const TermsAgreementStep = ({
     });
   }
   const renderCarrierLogos = () => {
+    var _a;
     if (!carrierProfilesToRegister.length) return null;
-    return carrierProfilesToRegister.map(p => {
+    const stampsCarrierProfile = {
+      carrierCode: "stamps_com",
+      carrierName: (_a = carrierFriendlyNames["stamps_com"]) === null || _a === void 0 ? void 0 : _a.name
+    };
+    // kind of a goofy way to just display stamps/usps logo without sending it in the payload to register
+    // we don't want to register stamps as a carrier if it's not being used as the primary payment method
+    const carriersToDisplay = showStampsLogo ? [stampsCarrierProfile, ...carrierProfilesToRegister] : carrierProfilesToRegister;
+    return carriersToDisplay.map(p => {
       var _a;
       return jsx(CarrierLogo, {
         carrierCode: p.carrierCode,
@@ -99,7 +109,8 @@ const TermsAgreementStep = ({
         carrierTerms: carrierTerms,
         hideTerms: hideTerms,
         insuranceProviderTerms: insuranceProviderTerms,
-        onSubmit: onSubmit
+        onSubmit: onSubmit,
+        requiredTerms: fundingSourceRequiredTerms
       })
     })]
   });

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

@@ -32,26 +32,25 @@ const useTermsAgreementStep = ({
   const fundingSourceRegion = fundingSourceMetadata === null || fundingSourceMetadata === void 0 ? void 0 : fundingSourceMetadata.defaultRegionProfile.countryCode;
   const fundingSourceCarrierProfiles = fundingSourceMetadata === null || fundingSourceMetadata === void 0 ? void 0 : fundingSourceMetadata.defaultRegionProfile.carrierProfiles;
   const carrierProfilesFilteredByRegion = filterFundingSourceCarriers(fundingSourceCarrierProfiles, fundingSourceRegion);
+  const hasFreeStampsConnected = carriers === null || carriers === void 0 ? void 0 : carriers.some(c => c.carrierCode === "stamps_com" && c.fundingSourceId === null);
   // filter carrier profiles based on enabled carriers
-  const enabledCarrierProfiles = carrierProfilesFilteredByRegion === null || carrierProfilesFilteredByRegion === void 0 ? void 0 : carrierProfilesFilteredByRegion.filter(c => enabledCarriers.includes(c.carrierCode));
+  const enabledCarrierProfiles = carrierProfilesFilteredByRegion === null || carrierProfilesFilteredByRegion === void 0 ? void 0 : carrierProfilesFilteredByRegion.filter(c => {
+    if (c.carrierCode === "stamps_com" && hasFreeStampsConnected) {
+      // if stamps_com is connected as a free account, we don't want to show it in the list of carriers to register. The funding source creation will convert it to a walleted carrier as the default carrier.
+      return false;
+    }
+    // filter out carriers that are not enabled by the feature flag
+    return enabledCarriers.includes(c.carrierCode);
+  });
   const carrierProfilesToRegister = useMemo(() => {
     if (!enabledCarrierProfiles) return [];
-    // add Stamps/USPS carrier ToS from funding source terms
-    const carrierProfiles = enabledCarrierProfiles.map(c => {
-      if (c.carrierCode === "stamps_com" && fundingSourceRequiredTerms) {
-        return Object.assign(Object.assign({}, c), {
-          requiredTerms: [...fundingSourceRequiredTerms, ...c.requiredTerms]
-        });
-      }
-      return c;
-    });
     // handle existing funding source
     const {
       fundingSourceId
     } = (fundingSources === null || fundingSources === void 0 ? void 0 : fundingSources[0]) || {};
-    if (!fundingSourceId || !carriers) return carrierProfiles;
+    if (!fundingSourceId || !carriers) return enabledCarrierProfiles;
     const connectedCarriers = carriers.filter(c => c.fundingSourceId === fundingSourceId);
-    return carrierProfiles.filter(profile => {
+    return enabledCarrierProfiles.filter(profile => {
       // filter out carriers that are already connected
       const isConnected = connectedCarriers.some(c => c.carrierCode === profile.carrierCode && c.fundingSourceId === fundingSourceId);
       // if stamps_com is enabled, and usps is connected to the funding source,
@@ -98,6 +97,7 @@ const useTermsAgreementStep = ({
     carrierProfilesToRegister,
     enabledCarrierProfiles,
     fundingSourceMetadata,
+    hasFreeStampsConnected,
     fundingSourceRequiredTerms,
     fundingSources,
     handleSubmitTermsAgreement,

package/dist/types/components/field/credit-card-input/credit-card-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"credit-card-input.d.ts","sourceRoot":"","sources":["../../../../../src/components/field/credit-card-input/credit-card-input.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,IAAI,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAIxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAYlE,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,gBAAgB,CAwB7D,CAAC"}
+{"version":3,"file":"credit-card-input.d.ts","sourceRoot":"","sources":["../../../../../src/components/field/credit-card-input/credit-card-input.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,IAAI,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAKxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAgBlE,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,gBAAgB,CAoC7D,CAAC"}

package/dist/types/components/field/rate-select/rate-card/rate-card.d.ts

@@ -1,5 +1,5 @@
 import type { WithCommonProps } from "@shipengine/giger";
-import type { ServicePoint } from "@shipengine/react-api";
+import type { LabelDisplayScheme, ServicePoint } from "@shipengine/react-api";
 import type { RateOption } from "@types";
 export type RateCardProps = Partial<RateOption> & WithCommonProps<{
     isAcknowledged?: boolean;
@@ -8,10 +8,12 @@ export type RateCardProps = Partial<RateOption> & WithCommonProps<{
     mapViewEnabled?: boolean;
     onClick?: (rateId: string) => void;
     onClickAcknowledgement?: (isAcknowledged: boolean) => void;
+    onPaperlessAcknowledgementChange?: (usePaperless?: boolean, labelDisplayScheme?: LabelDisplayScheme) => void;
     onSelectServicePoint?: (servicePoint?: ServicePoint) => void;
     selected?: boolean;
     selectedRateCost?: number;
     showVatFeatures?: boolean;
+    paperlessLabelChecked?: boolean;
 }>;
-export declare const RateCard: ({ carrierCode, carrierFriendlyName, carrierNickname, className, confirmationAmount, deliveryDays, insuranceAmount, isAcknowledged, messages, onClick, onClickAcknowledgement, onSelectServicePoint, otherAmount, rateId, requiresAcknowledgement, rateAcknowledgementMessage, selected, serviceCode, packageType, serviceType, shippingAmount, taxAmount, showVatFeatures, isLoading: servicePointsLoading, isPreferredRate, selectedRateCost, servicePoints, mapViewEnabled, rateDetails, }: RateCardProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export declare const RateCard: ({ carrierCode, carrierFriendlyName, carrierNickname, className, confirmationAmount, deliveryDays, insuranceAmount, isAcknowledged, messages, onClick, onClickAcknowledgement, onPaperlessAcknowledgementChange, onSelectServicePoint, otherAmount, rateId, requiresAcknowledgement, rateAcknowledgementMessage, selected, serviceCode, packageType, serviceType, shippingAmount, taxAmount, showVatFeatures, isLoading: servicePointsLoading, isPreferredRate, selectedRateCost, servicePoints, mapViewEnabled, rateDetails, paperlessDisplaySchemes, paperlessLabelChecked, }: RateCardProps) => import("@emotion/react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=rate-card.d.ts.map

package/dist/types/components/field/rate-select/rate-card/rate-card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rate-card.d.ts","sourceRoot":"","sources":["../../../../../../src/components/field/rate-select/rate-card/rate-card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAuC,UAAU,EAAE,MAAM,QAAQ,CAAC;AA4F9E,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,GAC7C,eAAe,CAAC;IACd,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,sBAAsB,CAAC,EAAE,CAAC,cAAc,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3D,oBAAoB,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;IAC7D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC,CAAC;AAEL,eAAO,MAAM,QAAQ,GAAI,8dA8BtB,aAAa,qDA0If,CAAC"}
+{"version":3,"file":"rate-card.d.ts","sourceRoot":"","sources":["../../../../../../src/components/field/rate-select/rate-card/rate-card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,KAAK,EAAuC,UAAU,EAAE,MAAM,QAAQ,CAAC;AA2F9E,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,GAC7C,eAAe,CAAC;IACd,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,sBAAsB,CAAC,EAAE,CAAC,cAAc,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3D,gCAAgC,CAAC,EAAE,CACjC,YAAY,CAAC,EAAE,OAAO,EACtB,kBAAkB,CAAC,EAAE,kBAAkB,KACpC,IAAI,CAAC;IACV,oBAAoB,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;IAC7D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC,CAAC,CAAC;AAEL,eAAO,MAAM,QAAQ,GAAI,gjBAiCtB,aAAa,qDAkKf,CAAC"}

package/dist/types/components/field/rate-select/rate-card/rate-card.styles.d.ts

@@ -2,10 +2,8 @@ import type { Theme } from "@emotion/react";
 export declare const getRateCardFirstLineSize: (theme: Theme) => string;
 export declare const styles: {
     acknowledgment: (theme: import("../../../../../typings/emotion").ScopedGigerTheme) => {
-        alignItems: string;
         color: string;
         display: string;
-        paddingTop: number;
     };
     divider: (theme: import("../../../../../typings/emotion").ScopedGigerTheme) => {
         borderColor: string;
@@ -27,5 +25,12 @@ export declare const styles: {
         right: number;
         top: number;
     };
+    paperlessText: (theme: import("../../../../../typings/emotion").ScopedGigerTheme) => {
+        display: string;
+        gap: number;
+        paddingTop: number;
+        color: string;
+        alignItems: string;
+    };
 };
 //# sourceMappingURL=rate-card.styles.d.ts.map

package/dist/types/components/field/rate-select/rate-card/rate-card.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rate-card.styles.d.ts","sourceRoot":"","sources":["../../../../../../src/components/field/rate-select/rate-card/rate-card.styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAG5C,eAAO,MAAM,wBAAwB,GAAI,OAAO,KAAK,WAA2C,CAAC;AAEjG,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BjB,CAAC"}
+{"version":3,"file":"rate-card.styles.d.ts","sourceRoot":"","sources":["../../../../../../src/components/field/rate-select/rate-card/rate-card.styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAG5C,eAAO,MAAM,wBAAwB,GAAI,OAAO,KAAK,WAA2C,CAAC;AAEjG,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCjB,CAAC"}

package/dist/types/components/field/rate-select/rate-select.d.ts

@@ -7,6 +7,7 @@ export type RateSelectProps = {
     isLoading?: boolean;
     mapViewEnabled?: boolean;
     nicknameFeature?: boolean;
+    onPaperlessAcknowledgementChange?: (usePaperlessLabel?: boolean, labelDisplayScheme?: SE.LabelDisplayScheme) => void;
     onSelectServicePoint?: (servicePoint?: SE.ServicePoint) => void;
     options: RateOption[];
     preferredServiceCodes?: RateFormProps["preferredServiceCodes"];

package/dist/types/components/field/rate-select/rate-select.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rate-select.d.ts","sourceRoot":"","sources":["../../../../../src/components/field/rate-select/rate-select.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAIzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AACjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAMlE,MAAM,MAAM,eAAe,GAAG;IAC5B,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oBAAoB,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,YAAY,KAAK,IAAI,CAAC;IAChE,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,qBAAqB,CAAC,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;IAC/D,mBAAmB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IACvD,kBAAkB,CAAC,EAAE,CAAC,eAAe,EAAE,OAAO,KAAK,IAAI,CAAC;IACxD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAaF,KAAK,iBAAiB,GAAG;IACvB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,eAAe,CAAC,eAAe,EAAE,iBAAiB,CA0D1E,CAAC"}
+{"version":3,"file":"rate-select.d.ts","sourceRoot":"","sources":["../../../../../src/components/field/rate-select/rate-select.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAIzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AACjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAMlE,MAAM,MAAM,eAAe,GAAG;IAC5B,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gCAAgC,CAAC,EAAE,CACjC,iBAAiB,CAAC,EAAE,OAAO,EAC3B,kBAAkB,CAAC,EAAE,EAAE,CAAC,kBAAkB,KACvC,IAAI,CAAC;IACV,oBAAoB,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,YAAY,KAAK,IAAI,CAAC;IAChE,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,qBAAqB,CAAC,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;IAC/D,mBAAmB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IACvD,kBAAkB,CAAC,EAAE,CAAC,eAAe,EAAE,OAAO,KAAK,IAAI,CAAC;IACxD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAaF,KAAK,iBAAiB,GAAG;IACvB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,eAAe,CAAC,eAAe,EAAE,iBAAiB,CAgF1E,CAAC"}

package/dist/types/components/forms/address-form/address-form-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"address-form-schema.d.ts","sourceRoot":"","sources":["../../../../../src/components/forms/address-form/address-form-schema.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAW7B,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+B7B,CAAC;AAEJ,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK7B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAClE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"address-form-schema.d.ts","sourceRoot":"","sources":["../../../../../src/components/forms/address-form/address-form-schema.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAU7B,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgC7B,CAAC;AAEJ,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK7B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAClE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC"}