@shipengine/elements 2.9.1 → 2.11.0

package/src/locales/en/index.d.ts

@@ -53,6 +53,7 @@ declare const _default: {
             showItems: string;
             void: string;
             download: string;
+            fileClaim: string;
         };
         fields: {
             dimensions: string;
@@ -68,6 +69,20 @@ declare const _default: {
             insuredValue: string;
             deliveryConfirmation: string;
         };
+        insurance: {
+            parcelguard: {
+                title: string;
+                description: string;
+                cta: {
+                    title: string;
+                    description: string;
+                };
+                registerSuccess: {
+                    title: string;
+                    description: string;
+                };
+            };
+        };
         highVolumeForms: string;
         multipleShippingServices: string;
         sections: {
@@ -110,12 +125,6 @@ declare const _default: {
     };
     "register-wallet": {
         sections: {
-            setup: {
-                title: string;
-                subtitle: string;
-                descriptionTitle: string;
-                description: string;
-            };
             billing: {
                 title: string;
                 cardSubTitle: string;
@@ -128,6 +137,17 @@ declare const _default: {
                 title: string;
                 subtitle: string;
             };
+            insuranceProviders: {
+                parcelguard: {
+                    description: string;
+                    terms: string;
+                    termsLink: string;
+                    popover: {
+                        title: string;
+                        description: string;
+                    };
+                };
+            };
             notifications: {
                 error: {
                     title: string;
@@ -222,6 +242,7 @@ declare const _default: {
         };
         cta: {
             addPackageDetails: string;
+            parcelguard: string;
         };
         errorMessages: {
             customsItemsRequired: string;
@@ -292,6 +313,17 @@ declare const _default: {
             dhlExpressTermsAcknowledgement: string;
             noRateService: string;
         };
+        windsorFramework: {
+            movementIndicator: string;
+            movementIndicators: {
+                b2c: string;
+                c2b: string;
+                c2c: string;
+                b2b: string;
+            };
+            notAtRisk: string;
+            notAtRiskShipmentTootip: string;
+        };
         requirements: {
             noWarehouse: string;
             noCarrier: string;
@@ -322,6 +354,7 @@ declare const _default: {
         shipToAddressFormFields: string;
         sections: {
             customsForm: string;
+            windsorFramework: string;
             shipment: string;
             rate_one: string;
             rate_other: string;
@@ -346,6 +379,10 @@ declare const _default: {
             shipFromAddress: string;
             fundingAndCarrierConnection: string;
         };
+        termsAgreement: {
+            title: string;
+            subtitle: string;
+        };
         warehouse: {
             title: string;
             subtitle: string;
@@ -622,6 +659,7 @@ declare const _default: {
             continue: string;
             delete: string;
             edit: string;
+            enable: string;
             hide: string;
             parse: string;
             purchase: string;
@@ -782,6 +820,14 @@ declare const _default: {
             unknown: string;
             noRatesAvailable: string;
             refreshAndTryAgain: string;
+            windsorFramework: {
+                doNotConform: string;
+                pleaseAddTheFollowingTaxIds: string;
+                windsorFrameworkDefaultMessage: string;
+                shipperEori: string;
+                recipientEori: string;
+                ukims: string;
+            };
         };
         errorTypes: {
             accountStatus: string;
@@ -795,6 +841,7 @@ declare const _default: {
             system: string;
             unknown: string;
             validation: string;
+            windsorFramework: string;
         };
         grid: {
             "row-count_one": string;
@@ -821,8 +868,10 @@ declare const _default: {
         insuranceProviders: {
             carrier: string;
             none: string;
+            parcelguard: string;
             shipsurance: string;
             thirdParty: string;
+            x_cover: string;
         };
         loading: {
             accountSettings: string;
@@ -900,6 +949,9 @@ declare const _default: {
             platform: string;
             user: string;
         };
+        tags: {
+            new: string;
+        };
         terms: {
             fields: {
                 agreement: string;
@@ -907,6 +959,7 @@ declare const _default: {
             agreeToTerms: string;
             carriersTitle: string;
             fundingSourceTitle: string;
+            insuranceProvidersTitle: string;
             shipEngineTitle: string;
         };
         weight: {

package/src/types/carrier-metadata.d.ts

@@ -29,7 +29,7 @@ export type CarrierTerms = {
 export type CarrierWithFriendlyName = {
     name: string;
 };
-export type CarrierMetadata = Record<string, CarrierWithFriendlyName>;
+export type ElementsCarrierMetadata = Record<string, CarrierWithFriendlyName>;
 export type CarrierMetadataFromFundingSource = {
     carrierProfile: SE.MetadataCarrierProfile;
     friendlyName: string;

package/src/types/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./carrier-metadata";
 export * from "./shipping-preset";
 export * from "./preferred-rates";
+export * from "./insurance-metadata";

package/src/types/insurance-metadata.d.ts

@@ -0,0 +1,25 @@
+import { SE } from "@shipengine/react-api";
+/**
+ * @internal
+ *
+ * # Insurance Metadata - Insurance Provider With Friendly Name
+ */
+export type InsuranceProviderWithFriendlyName = {
+    friendlyName: "ParcelGuard" | "XCover";
+    provider: SE.FundingSourceInsuranceProvider;
+};
+/**
+ * @internal
+ *
+ * # Insurance Metadata - Insurance Provider Profile
+ */
+export type InsuranceProviderProfile = {
+    agreedToTerms?: boolean;
+    terms: SE.MetadataOptionalTerm;
+} & InsuranceProviderWithFriendlyName;
+/**
+ * @internal
+ *
+ * # Insurance Metadata - Insurance Provider Record
+ */
+export type InsuranceProviderRecord = Record<string, InsuranceProviderWithFriendlyName>;

package/src/utilities/feature-flags/types.d.ts

@@ -42,6 +42,10 @@ export type ShipmentFormFeatures = {
      * varying shipment configurations. This is useful for rate shopping.
      */
     browseRates?: boolean;
+    /**
+     * Enables the `carrier insurance` feature, allowing users to select carrier insurance when insuring their shipment.
+     */
+    includeCarrierInsurance?: boolean;
     /**
      * Enables the `shipsurance insurance` feature, allowing users to select Shipsurance when insuring their shipment.
      */
@@ -64,6 +68,10 @@ export type ShipmentSummaryFeatures = {
     schedulePickup?: boolean;
 };
 export type PurchaseLabelFeatures = {
+    /**
+     * Feature still in beta. When enabled, the Windsor Framework will display forms, messaging, and error messages if a shipment requires specific Windsor Framework features.
+     */
+    betaEnableWindsorFramework?: boolean;
     /**
      * List of all supported `countries` available in ShipEngine Elements.
      */
@@ -115,6 +123,34 @@ export type AccountSettingsFeatures = {
      */
     showVatSettings?: boolean;
 };
+export type LabelColumnName = "shipmentId" | "labelId" | "packages" | "recipient" | "shippingService" | "createdDate" | "shipDate" | "status" | "trackingStatus";
+export type BaseLabelColumnConfig = {
+    /**
+     * The name identifying the column
+     */
+    name: Exclude<LabelColumnName, "shipmentId" | "labelId">;
+};
+export type FilterableLabelColumnConfig = {
+    /**
+     * Allow filtering by this column
+     */
+    allowFilter?: boolean;
+    /**
+     * The name identifying the column
+     */
+    name: Extract<LabelColumnName, "shipmentId" | "labelId">;
+};
+export type LabelColumnConfig = BaseLabelColumnConfig | FilterableLabelColumnConfig;
+export type LabelsGridFeatures = {
+    /**
+     * Configure label grid columns
+     */
+    columns?: LabelColumnConfig[];
+    /**
+     * Configure label grid columns
+     */
+    showActions?: boolean;
+};
 export type GlobalFeatures = {
     /**
      * Availible "Bring your own carrier" carrier codes for carriers that may be added. If this is omitted, new carriers may not be added by this element.
@@ -124,6 +160,10 @@ export type GlobalFeatures = {
      * list of all walleted carriers that are enabled for use in Elements.
      */
     enabledShipEngineCarriers?: EnabledShipEngineCarriers;
+    /**
+     * Enable parcel guard related features for the different parts of UI
+     */
+    enableParcelGuard?: boolean;
     /**
      * Use Elements in Sandbox mode. Requires a sandbox partner.
      */
@@ -140,6 +180,7 @@ export type GlobalFeatures = {
 export type ElementsFeatureFlags = {
     accountSettingsFeatures?: AccountSettingsFeatures;
     globalFeatures?: GlobalFeatures;
+    labelsGridFeatures?: LabelsGridFeatures;
     purchaseLabelFeatures?: PurchaseLabelFeatures;
     shipmentSummaryFeatures?: ShipmentSummaryFeatures;
 };

package/src/utilities/index.d.ts

@@ -13,6 +13,6 @@ export * from "./rate-details";
 export * from "./rates";
 export * from "./shipengine";
 export * from "./styles";
-export * from "./tracking-status-formatter";
+export * from "./tracking-formatter";
 export * from "./validation";
 export * from "./vat";

package/src/utilities/shipengine/carrier.d.ts

@@ -15,6 +15,22 @@ export declare const isUspsCarrier: (carrierCode: string) => boolean;
  * @category Utilities
  */
 export declare const isUpsCarrier: (carrierCode: string) => boolean;
+/**
+ * @internal
+ *
+ * # Carrier Utilities - isYodelCarrier
+ *
+ * @category Utilities
+ */
+export declare const isYodelCarrier: (carrierCode: string) => boolean;
+/**
+ * @internal
+ *
+ * # Carrier Utilities - isEvriCarrier
+ *
+ * @category Utilities
+ */
+export declare const isEvriCarrier: (carrierCode: string) => boolean;
 /**
  * @internal
  *

package/src/utilities/shipengine/index.d.ts

@@ -6,3 +6,4 @@ export * from "./shipment";
 export * from "./weight";
 export * from "./package";
 export * from "./warehouses";
+export * from "./insurance";

package/src/utilities/shipengine/insurance.d.ts

@@ -0,0 +1,17 @@
+import { SE } from "@shipengine/react-api";
+/**
+ * @internal
+ *
+ * # Insurance Utilities - getInsuranceProviderWithFriendlyName
+ *
+ * @category Utilities
+ */
+export declare const getInsuranceProviderWithFriendlyName: (termType: string) => import("../../types").InsuranceProviderWithFriendlyName;
+/**
+ * @internal
+ *
+ * # Insurance Utilities - getIsInsuraceProviderAccepted
+ *
+ * @category Utilities
+ */
+export declare const getIsInsuraceProviderAccepted: (termType: string, acceptedTerms?: SE.Term[]) => boolean;

package/src/utilities/tracking-formatter.d.ts

@@ -0,0 +1,9 @@
+export declare const trackingStatusFormatter: (status: string) => string | undefined;
+/**
+ * @internal
+ *
+ * # Format Tracking Number Utility Function
+ *
+ * - This is a utility function that formats the tracking number to display only the last 25 characters, in reverse truncated fashion as the last numbers of a tracking number are the most unique/important.
+ */
+export declare const formatTrackingNumber: (trackingNumber: string) => string;

package/src/workflows/account-settings/account-settings.d.ts

@@ -89,6 +89,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     showItems: string;
                     void: string;
                     download: string;
+                    fileClaim: string;
                 };
                 fields: {
                     dimensions: string;
@@ -104,6 +105,20 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     insuredValue: string;
                     deliveryConfirmation: string;
                 };
+                insurance: {
+                    parcelguard: {
+                        title: string;
+                        description: string;
+                        cta: {
+                            title: string;
+                            description: string;
+                        };
+                        registerSuccess: {
+                            title: string;
+                            description: string;
+                        };
+                    };
+                };
                 highVolumeForms: string;
                 multipleShippingServices: string;
                 sections: {
@@ -123,9 +138,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                 verifiedVat: string;
                 vatFormErrors: {
                     invalidFieldValue: string;
-                    verificationFailure: string; /**
-                     * `features` is a set of feature flags you would like to enable or disable in this component.
-                     */
+                    verificationFailure: string;
                     forbidden: string;
                     connectionNotSupported: string;
                     genericTitle: string;
@@ -148,12 +161,6 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
             };
             "register-wallet": {
                 sections: {
-                    setup: {
-                        title: string;
-                        subtitle: string;
-                        descriptionTitle: string;
-                        description: string;
-                    };
                     billing: {
                         title: string;
                         cardSubTitle: string;
@@ -166,6 +173,17 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                         title: string;
                         subtitle: string;
                     };
+                    insuranceProviders: {
+                        parcelguard: {
+                            description: string;
+                            terms: string;
+                            termsLink: string;
+                            popover: {
+                                title: string;
+                                description: string;
+                            };
+                        };
+                    };
                     notifications: {
                         error: {
                             title: string;
@@ -260,6 +278,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                 };
                 cta: {
                     addPackageDetails: string;
+                    parcelguard: string;
                 };
                 errorMessages: {
                     customsItemsRequired: string;
@@ -330,6 +349,17 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     dhlExpressTermsAcknowledgement: string;
                     noRateService: string;
                 };
+                windsorFramework: {
+                    movementIndicator: string;
+                    movementIndicators: {
+                        b2c: string;
+                        c2b: string;
+                        c2c: string;
+                        b2b: string;
+                    };
+                    notAtRisk: string;
+                    notAtRiskShipmentTootip: string;
+                };
                 requirements: {
                     noWarehouse: string;
                     noCarrier: string;
@@ -360,6 +390,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                 shipToAddressFormFields: string;
                 sections: {
                     customsForm: string;
+                    windsorFramework: string;
                     shipment: string;
                     rate_one: string;
                     rate_other: string;
@@ -384,6 +415,10 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     shipFromAddress: string;
                     fundingAndCarrierConnection: string;
                 };
+                termsAgreement: {
+                    title: string;
+                    subtitle: string;
+                };
                 warehouse: {
                     title: string;
                     subtitle: string;
@@ -660,6 +695,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     continue: string;
                     delete: string;
                     edit: string;
+                    enable: string;
                     hide: string;
                     parse: string;
                     purchase: string;
@@ -820,6 +856,14 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     unknown: string;
                     noRatesAvailable: string;
                     refreshAndTryAgain: string;
+                    windsorFramework: {
+                        doNotConform: string;
+                        pleaseAddTheFollowingTaxIds: string;
+                        windsorFrameworkDefaultMessage: string;
+                        shipperEori: string;
+                        recipientEori: string;
+                        ukims: string;
+                    };
                 };
                 errorTypes: {
                     accountStatus: string;
@@ -833,6 +877,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     system: string;
                     unknown: string;
                     validation: string;
+                    windsorFramework: string;
                 };
                 grid: {
                     "row-count_one": string;
@@ -859,8 +904,10 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                 insuranceProviders: {
                     carrier: string;
                     none: string;
+                    parcelguard: string;
                     shipsurance: string;
                     thirdParty: string;
+                    x_cover: string;
                 };
                 loading: {
                     accountSettings: string;
@@ -938,6 +985,9 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     platform: string;
                     user: string;
                 };
+                tags: {
+                    new: string;
+                };
                 terms: {
                     fields: {
                         agreement: string;
@@ -945,6 +995,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     agreeToTerms: string;
                     carriersTitle: string;
                     fundingSourceTitle: string;
+                    insuranceProvidersTitle: string;
                     shipEngineTitle: string;
                 };
                 weight: {
@@ -1005,9 +1056,6 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     externalCarriers: string;
                     labelLayout: string;
                     unitSettings: string;
-                    /**
-                     * `features` is a set of feature flags you would like to enable or disable in this component.
-                     */
                     vatSettings: string;
                 };
             };

package/src/workflows/account-settings/use-get-panel-props.d.ts

@@ -1,9 +1,9 @@
 import { CollapsiblePanelProps } from "../../components";
 import { ExternalCarriersProps, UnitSettingsProps } from "../../features";
-import { LabelLayoutSettingsProps } from "../../features/label-layout/label-layout";
 import { ManageWarehousesProps } from "../../features/manage-warehouses/";
-type SettingProps = ExternalCarriersProps | LabelLayoutSettingsProps | UnitSettingsProps | ManageWarehousesProps;
-export type SettingPropsIntersection = ExternalCarriersProps & LabelLayoutSettingsProps & UnitSettingsProps & ManageWarehousesProps;
+import { SelectLabelLayoutSettingsProps } from "../../features/select-label-layout/select-label-layout";
+type SettingProps = ExternalCarriersProps | SelectLabelLayoutSettingsProps | UnitSettingsProps | ManageWarehousesProps;
+export type SettingPropsIntersection = ExternalCarriersProps & SelectLabelLayoutSettingsProps & UnitSettingsProps & ManageWarehousesProps;
 export declare const useGetPanelProps: () => {
     getSettingPanelProps: (setting: string) => [panelProps?: CollapsiblePanelProps, settingProps?: SettingProps];
 };