@zonos/elements 1.3.281 → 1.3.282

package/dist/types/components/store/translationStore/strings.japanese.d.ts

@@ -119,6 +119,9 @@ export declare const stringsJapanese: {
     'Company name (optional)': {
         value: string;
     };
+    'Complete your shipping address': {
+        value: string;
+    };
     Confirm: {
         value: string;
     };
@@ -536,6 +539,9 @@ export declare const stringsJapanese: {
     'Return to merchant site': {
         value: string;
     };
+    'Save and continue': {
+        value: string;
+    };
     'Search countries': {
         value: string;
     };
@@ -554,6 +560,9 @@ export declare const stringsJapanese: {
     'Select a language': {
         value: string;
     };
+    'Selected address': {
+        value: string;
+    };
     'Session does not have valid landed cost. Please contact [organizationName] for assistance.': {
         value: string;
     };
@@ -698,6 +707,9 @@ export declare const stringsJapanese: {
     "There's been an error updating your checkout session. Please reload and try again or contact support if the error persists": {
         value: string;
     };
+    'This saved address is missing information required to ship internationally. Please add the details below.': {
+        value: string;
+    };
     'To ensure delivery all address details must be in Latin characters.': {
         value: string;
     };

package/dist/types/components/store/translationStore/strings.korean.d.ts

@@ -119,6 +119,9 @@ export declare const stringsKorean: {
     'Company name (optional)': {
         value: string;
     };
+    'Complete your shipping address': {
+        value: string;
+    };
     Confirm: {
         value: string;
     };
@@ -536,6 +539,9 @@ export declare const stringsKorean: {
     'Return to merchant site': {
         value: string;
     };
+    'Save and continue': {
+        value: string;
+    };
     'Search countries': {
         value: string;
     };
@@ -554,6 +560,9 @@ export declare const stringsKorean: {
     'Select a language': {
         value: string;
     };
+    'Selected address': {
+        value: string;
+    };
     'Session does not have valid landed cost. Please contact [organizationName] for assistance.': {
         value: string;
     };
@@ -698,6 +707,9 @@ export declare const stringsKorean: {
     "There's been an error updating your checkout session. Please reload and try again or contact support if the error persists": {
         value: string;
     };
+    'This saved address is missing information required to ship internationally. Please add the details below.': {
+        value: string;
+    };
     'To ensure delivery all address details must be in Latin characters.': {
         value: string;
     };

package/dist/types/components/store/translationStore/strings.norwegian.d.ts

@@ -119,6 +119,9 @@ export declare const stringsNorwegian: {
     'Company name (optional)': {
         value: string;
     };
+    'Complete your shipping address': {
+        value: string;
+    };
     Confirm: {
         value: string;
     };
@@ -536,6 +539,9 @@ export declare const stringsNorwegian: {
     'Return to merchant site': {
         value: string;
     };
+    'Save and continue': {
+        value: string;
+    };
     'Search countries': {
         value: string;
     };
@@ -554,6 +560,9 @@ export declare const stringsNorwegian: {
     'Select a language': {
         value: string;
     };
+    'Selected address': {
+        value: string;
+    };
     'Session does not have valid landed cost. Please contact [organizationName] for assistance.': {
         value: string;
     };
@@ -698,6 +707,9 @@ export declare const stringsNorwegian: {
     "There's been an error updating your checkout session. Please reload and try again or contact support if the error persists": {
         value: string;
     };
+    'This saved address is missing information required to ship internationally. Please add the details below.': {
+        value: string;
+    };
     'To ensure delivery all address details must be in Latin characters.': {
         value: string;
     };

package/dist/types/components/store/translationStore/strings.polish.d.ts

@@ -119,6 +119,9 @@ export declare const stringsPolish: {
     'Company name (optional)': {
         value: string;
     };
+    'Complete your shipping address': {
+        value: string;
+    };
     Confirm: {
         value: string;
     };
@@ -536,6 +539,9 @@ export declare const stringsPolish: {
     'Return to merchant site': {
         value: string;
     };
+    'Save and continue': {
+        value: string;
+    };
     'Search countries': {
         value: string;
     };
@@ -554,6 +560,9 @@ export declare const stringsPolish: {
     'Select a language': {
         value: string;
     };
+    'Selected address': {
+        value: string;
+    };
     'Session does not have valid landed cost. Please contact [organizationName] for assistance.': {
         value: string;
     };
@@ -698,6 +707,9 @@ export declare const stringsPolish: {
     "There's been an error updating your checkout session. Please reload and try again or contact support if the error persists": {
         value: string;
     };
+    'This saved address is missing information required to ship internationally. Please add the details below.': {
+        value: string;
+    };
     'To ensure delivery all address details must be in Latin characters.': {
         value: string;
     };

package/dist/types/components/store/translationStore/strings.portuguese.d.ts

@@ -119,6 +119,9 @@ export declare const stringsPortuguese: {
     'Company name (optional)': {
         value: string;
     };
+    'Complete your shipping address': {
+        value: string;
+    };
     Confirm: {
         value: string;
     };
@@ -536,6 +539,9 @@ export declare const stringsPortuguese: {
     'Return to merchant site': {
         value: string;
     };
+    'Save and continue': {
+        value: string;
+    };
     'Search countries': {
         value: string;
     };
@@ -554,6 +560,9 @@ export declare const stringsPortuguese: {
     'Select a language': {
         value: string;
     };
+    'Selected address': {
+        value: string;
+    };
     'Session does not have valid landed cost. Please contact [organizationName] for assistance.': {
         value: string;
     };
@@ -698,6 +707,9 @@ export declare const stringsPortuguese: {
     "There's been an error updating your checkout session. Please reload and try again or contact support if the error persists": {
         value: string;
     };
+    'This saved address is missing information required to ship internationally. Please add the details below.': {
+        value: string;
+    };
     'To ensure delivery all address details must be in Latin characters.': {
         value: string;
     };

package/dist/types/components/store/translationStore/strings.russian.d.ts

@@ -119,6 +119,9 @@ export declare const stringsRussian: {
     'Company name (optional)': {
         value: string;
     };
+    'Complete your shipping address': {
+        value: string;
+    };
     Confirm: {
         value: string;
     };
@@ -536,6 +539,9 @@ export declare const stringsRussian: {
     'Return to merchant site': {
         value: string;
     };
+    'Save and continue': {
+        value: string;
+    };
     'Search countries': {
         value: string;
     };
@@ -554,6 +560,9 @@ export declare const stringsRussian: {
     'Select a language': {
         value: string;
     };
+    'Selected address': {
+        value: string;
+    };
     'Session does not have valid landed cost. Please contact [organizationName] for assistance.': {
         value: string;
     };
@@ -698,6 +707,9 @@ export declare const stringsRussian: {
     "There's been an error updating your checkout session. Please reload and try again or contact support if the error persists": {
         value: string;
     };
+    'This saved address is missing information required to ship internationally. Please add the details below.': {
+        value: string;
+    };
     'To ensure delivery all address details must be in Latin characters.': {
         value: string;
     };

package/dist/types/components/store/translationStore/strings.spanish.d.ts

@@ -119,6 +119,9 @@ export declare const stringsSpanish: {
     'Company name (optional)': {
         value: string;
     };
+    'Complete your shipping address': {
+        value: string;
+    };
     Confirm: {
         value: string;
     };
@@ -536,6 +539,9 @@ export declare const stringsSpanish: {
     'Return to merchant site': {
         value: string;
     };
+    'Save and continue': {
+        value: string;
+    };
     'Search countries': {
         value: string;
     };
@@ -554,6 +560,9 @@ export declare const stringsSpanish: {
     'Select a language': {
         value: string;
     };
+    'Selected address': {
+        value: string;
+    };
     'Session does not have valid landed cost. Please contact [organizationName] for assistance.': {
         value: string;
     };
@@ -698,6 +707,9 @@ export declare const stringsSpanish: {
     "There's been an error updating your checkout session. Please reload and try again or contact support if the error persists": {
         value: string;
     };
+    'This saved address is missing information required to ship internationally. Please add the details below.': {
+        value: string;
+    };
     'To ensure delivery all address details must be in Latin characters.': {
         value: string;
     };

package/dist/types/components/store/translationStore/strings.swedish.d.ts

@@ -119,6 +119,9 @@ export declare const stringsSwedish: {
     'Company name (optional)': {
         value: string;
     };
+    'Complete your shipping address': {
+        value: string;
+    };
     Confirm: {
         value: string;
     };
@@ -536,6 +539,9 @@ export declare const stringsSwedish: {
     'Return to merchant site': {
         value: string;
     };
+    'Save and continue': {
+        value: string;
+    };
     'Search countries': {
         value: string;
     };
@@ -554,6 +560,9 @@ export declare const stringsSwedish: {
     'Select a language': {
         value: string;
     };
+    'Selected address': {
+        value: string;
+    };
     'Session does not have valid landed cost. Please contact [organizationName] for assistance.': {
         value: string;
     };
@@ -698,6 +707,9 @@ export declare const stringsSwedish: {
     "There's been an error updating your checkout session. Please reload and try again or contact support if the error persists": {
         value: string;
     };
+    'This saved address is missing information required to ship internationally. Please add the details below.': {
+        value: string;
+    };
     'To ensure delivery all address details must be in Latin characters.': {
         value: string;
     };

package/dist/types/components/store/translationStore/strings.turkish.d.ts

@@ -119,6 +119,9 @@ export declare const stringsTurkish: {
     'Company name (optional)': {
         value: string;
     };
+    'Complete your shipping address': {
+        value: string;
+    };
     Confirm: {
         value: string;
     };
@@ -536,6 +539,9 @@ export declare const stringsTurkish: {
     'Return to merchant site': {
         value: string;
     };
+    'Save and continue': {
+        value: string;
+    };
     'Search countries': {
         value: string;
     };
@@ -554,6 +560,9 @@ export declare const stringsTurkish: {
     'Select a language': {
         value: string;
     };
+    'Selected address': {
+        value: string;
+    };
     'Session does not have valid landed cost. Please contact [organizationName] for assistance.': {
         value: string;
     };
@@ -698,6 +707,9 @@ export declare const stringsTurkish: {
     "There's been an error updating your checkout session. Please reload and try again or contact support if the error persists": {
         value: string;
     };
+    'This saved address is missing information required to ship internationally. Please add the details below.': {
+        value: string;
+    };
     'To ensure delivery all address details must be in Latin characters.': {
         value: string;
     };

package/dist/types/components/store/translationStore/strings.vietnamese.d.ts

@@ -119,6 +119,9 @@ export declare const stringsVietnamese: {
     'Company name (optional)': {
         value: string;
     };
+    'Complete your shipping address': {
+        value: string;
+    };
     Confirm: {
         value: string;
     };
@@ -536,6 +539,9 @@ export declare const stringsVietnamese: {
     'Return to merchant site': {
         value: string;
     };
+    'Save and continue': {
+        value: string;
+    };
     'Search countries': {
         value: string;
     };
@@ -554,6 +560,9 @@ export declare const stringsVietnamese: {
     'Select a language': {
         value: string;
     };
+    'Selected address': {
+        value: string;
+    };
     'Session does not have valid landed cost. Please contact [organizationName] for assistance.': {
         value: string;
     };
@@ -698,6 +707,9 @@ export declare const stringsVietnamese: {
     "There's been an error updating your checkout session. Please reload and try again or contact support if the error persists": {
         value: string;
     };
+    'This saved address is missing information required to ship internationally. Please add the details below.': {
+        value: string;
+    };
     'To ensure delivery all address details must be in Latin characters.': {
         value: string;
     };

package/dist/types/components/utils/checkout/applyAddressCompletion.d.ts

@@ -0,0 +1,25 @@
+import type { StripeAddressElementChangeEvent } from '@stripe/stripe-js';
+/**
+ * Values captured in the completion dialog for the fields that were missing from the Stripe
+ * Link address. Only the keys that were actually requested (and therefore provided) are present.
+ * When the last name is missing we also capture the first name, so the customer can correct the
+ * whole name at once (Link often stores just a first name in its single name input).
+ */
+export type AddressCompletionSubmit = {
+    firstName?: string;
+    lastName?: string;
+    postal_code?: string;
+    state?: string;
+};
+/**
+ * Merge the fields captured in the completion dialog back into a Stripe shipping address event,
+ * rebuilding the full name from the extracted first name and the provided/known last name and
+ * marking the address complete. Fields the customer wasn't asked for are left untouched.
+ *
+ * Pure: returns a new event object rather than mutating the input, so it can be unit-tested and
+ * assigned straight to the store.
+ */
+export declare const applyAddressCompletion: ({ data, event, }: {
+    data: AddressCompletionSubmit;
+    event: StripeAddressElementChangeEvent;
+}) => StripeAddressElementChangeEvent;

package/dist/types/components/utils/checkout/buildAddressContacts.d.ts

@@ -0,0 +1,21 @@
+import type { ContactOption, StripeAddressElementChangeEvent } from '@stripe/stripe-js';
+/**
+ * Map a Stripe address change event value into a Stripe `ContactOption`, used to
+ * pre-seed the address element's saved-address (contacts) list on remount.
+ */
+export declare const mapAddressEventToContact: (value: StripeAddressElementChangeEvent["value"]) => ContactOption;
+/**
+ * Build a dedupe key for a contact so we don't add a duplicate saved address. Compared
+ * case- and whitespace-insensitively on the distinguishing fields.
+ */
+export declare const getContactDedupKey: (contact: ContactOption) => string;
+/**
+ * Prepend the currently selected address (from the latest Stripe address event) to the
+ * list of default saved addresses so it stays selected when the address element is
+ * remounted (e.g. navigating between the customer and shipping steps). Avoids adding a
+ * duplicate contact when the current address already exists in the list.
+ */
+export declare const buildAddressContacts: ({ currentEvent, defaultAddress, }: {
+    currentEvent: StripeAddressElementChangeEvent | null;
+    defaultAddress: ContactOption[];
+}) => ContactOption[];

package/dist/types/components/utils/checkout/getMissingRequiredShippingFields.d.ts

@@ -0,0 +1,35 @@
+import type { StripeAddressElementChangeEvent } from '@stripe/stripe-js';
+/**
+ * Minimum number of characters we treat as a valid postal code. Mirrors the
+ * landed-cost readiness check in `stripe.ts` (`isAddressReadyToRequestLandedCost`).
+ */
+export declare const MIN_POSTAL_CODE_LENGTH = 3;
+export type MissingShippingFieldKey = 'lastName' | 'postal_code' | 'state';
+export type MissingShippingField = {
+    key: MissingShippingFieldKey;
+};
+/**
+ * The subset of per-country field requirements this check needs. Both the Zonos
+ * `CountryFields` config and the Stripe-derived country field list satisfy this shape,
+ * so callers can pass whatever `getCountryField` (in `stripe.ts`) returns.
+ */
+export type RequiredFieldConfig = {
+    stateRequired: boolean;
+    zipRequired: boolean;
+} | null;
+/**
+ * Determine which Zonos-required shipping fields are still missing even though Stripe
+ * reports the address as complete.
+ *
+ * Stripe Link autofills a saved address from a single name input, so it may return only a
+ * first name and, for some countries, omit the state / postal code while still reporting
+ * `complete: true`. This surfaces the fields Zonos needs for international shipping so the
+ * customer can supply just those, without duplicating fields Stripe already captures.
+ *
+ * Pure: the caller resolves `countryField` (via `getCountryField`) and passes it in, so
+ * this can be unit-tested without the stores.
+ */
+export declare const getMissingRequiredShippingFields: ({ countryField, event, }: {
+    countryField: RequiredFieldConfig;
+    event: StripeAddressElementChangeEvent | null;
+}) => MissingShippingField[];

package/dist/types/components.d.ts

@@ -6,7 +6,9 @@
  */
 import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
 import { ContactOption, PaymentIntent, Stripe, StripeAddressElementChangeEvent } from "@stripe/stripe-js";
+import { MissingShippingField } from "./components/utils/checkout/getMissingRequiredShippingFields";
 import { EnteredInfo, TranslatedAddressObject } from "./types/checkout/TranslatedText";
+import { AddressCompletionSubmit } from "./components/utils/checkout/applyAddressCompletion";
 import { EventPayloadMap, IframeSuggestionsResponsePayload } from "./components/utils/iframe/IframeHelpers";
 import { SubmitEventData } from "./components/checkout/zonos-checkout/zonos-address-update-dialog/zonos-address-update-dialog";
 import { CheckboxColorPrefix, Color, ColorPrefix } from "./types/styles/Color";
@@ -32,7 +34,9 @@ import { SelectOption } from "./components/common/zonos-stripe-select/zonos-stri
 import { ToggleItem } from "./types/common-ui/Toggle";
 import { VirtualScrollRenderItem } from "./types/common-ui/VirtualScroll";
 export { ContactOption, PaymentIntent, Stripe, StripeAddressElementChangeEvent } from "@stripe/stripe-js";
+export { MissingShippingField } from "./components/utils/checkout/getMissingRequiredShippingFields";
 export { EnteredInfo, TranslatedAddressObject } from "./types/checkout/TranslatedText";
+export { AddressCompletionSubmit } from "./components/utils/checkout/applyAddressCompletion";
 export { EventPayloadMap, IframeSuggestionsResponsePayload } from "./components/utils/iframe/IframeHelpers";
 export { SubmitEventData } from "./components/checkout/zonos-checkout/zonos-address-update-dialog/zonos-address-update-dialog";
 export { CheckboxColorPrefix, Color, ColorPrefix } from "./types/styles/Color";
@@ -80,6 +84,36 @@ export namespace Components {
          */
         "type": 'billing' | 'shipping';
     }
+    interface ZonosAddressCompletionDialog {
+        /**
+          * Whether or not the continue button is loading
+         */
+        "continueLoading": boolean;
+        /**
+          * Whether or not the dialog is open
+         */
+        "dialogOpen": boolean;
+        /**
+          * Whether or not the dialog is rendered in mobile mode
+         */
+        "isMobile": boolean;
+        /**
+          * The Zonos-required fields still missing from the selected address
+         */
+        "missingFields": MissingShippingField[];
+        /**
+          * The shipping address selected from Stripe, shown read-only for context
+         */
+        "shippingAddress": EnteredInfo;
+        /**
+          * Button color of the submit button
+         */
+        "submitBtnColor"?: string;
+        /**
+          * Button type of the submit button
+         */
+        "submitBtnType"?: HTMLZonosButtonElement['variant'];
+    }
     interface ZonosAddressDisplay {
         /**
           * Title for the address display
@@ -1568,6 +1602,10 @@ export interface ZonosAddressCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLZonosAddressElement;
 }
+export interface ZonosAddressCompletionDialogCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLZonosAddressCompletionDialogElement;
+}
 export interface ZonosAddressFormCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLZonosAddressFormElement;
@@ -1699,6 +1737,24 @@ declare global {
         prototype: HTMLZonosAddressElement;
         new (): HTMLZonosAddressElement;
     };
+    interface HTMLZonosAddressCompletionDialogElementEventMap {
+        "closeCompletionDialog": void;
+        "completionSubmit": AddressCompletionSubmit;
+    }
+    interface HTMLZonosAddressCompletionDialogElement extends Components.ZonosAddressCompletionDialog, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLZonosAddressCompletionDialogElementEventMap>(type: K, listener: (this: HTMLZonosAddressCompletionDialogElement, ev: ZonosAddressCompletionDialogCustomEvent<HTMLZonosAddressCompletionDialogElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLZonosAddressCompletionDialogElementEventMap>(type: K, listener: (this: HTMLZonosAddressCompletionDialogElement, ev: ZonosAddressCompletionDialogCustomEvent<HTMLZonosAddressCompletionDialogElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLZonosAddressCompletionDialogElement: {
+        prototype: HTMLZonosAddressCompletionDialogElement;
+        new (): HTMLZonosAddressCompletionDialogElement;
+    };
     interface HTMLZonosAddressDisplayElement extends Components.ZonosAddressDisplay, HTMLStencilElement {
     }
     var HTMLZonosAddressDisplayElement: {
@@ -2512,6 +2568,7 @@ declare global {
     };
     interface HTMLElementTagNameMap {
         "zonos-address": HTMLZonosAddressElement;
+        "zonos-address-completion-dialog": HTMLZonosAddressCompletionDialogElement;
         "zonos-address-display": HTMLZonosAddressDisplayElement;
         "zonos-address-form": HTMLZonosAddressFormElement;
         "zonos-address-suggestions": HTMLZonosAddressSuggestionsElement;
@@ -2622,6 +2679,44 @@ declare namespace LocalJSX {
          */
         "type": 'billing' | 'shipping';
     }
+    interface ZonosAddressCompletionDialog {
+        /**
+          * Whether or not the continue button is loading
+         */
+        "continueLoading"?: boolean;
+        /**
+          * Whether or not the dialog is open
+         */
+        "dialogOpen"?: boolean;
+        /**
+          * Whether or not the dialog is rendered in mobile mode
+         */
+        "isMobile"?: boolean;
+        /**
+          * The Zonos-required fields still missing from the selected address
+         */
+        "missingFields"?: MissingShippingField[];
+        /**
+          * Close dialog button click
+         */
+        "onCloseCompletionDialog"?: (event: ZonosAddressCompletionDialogCustomEvent<void>) => void;
+        /**
+          * Emitted with the captured values when the customer completes the missing fields
+         */
+        "onCompletionSubmit"?: (event: ZonosAddressCompletionDialogCustomEvent<AddressCompletionSubmit>) => void;
+        /**
+          * The shipping address selected from Stripe, shown read-only for context
+         */
+        "shippingAddress": EnteredInfo;
+        /**
+          * Button color of the submit button
+         */
+        "submitBtnColor"?: string;
+        /**
+          * Button type of the submit button
+         */
+        "submitBtnType"?: HTMLZonosButtonElement['variant'];
+    }
     interface ZonosAddressDisplay {
         /**
           * Title for the address display
@@ -4191,6 +4286,7 @@ declare namespace LocalJSX {
     }
     interface IntrinsicElements {
         "zonos-address": ZonosAddress;
+        "zonos-address-completion-dialog": ZonosAddressCompletionDialog;
         "zonos-address-display": ZonosAddressDisplay;
         "zonos-address-form": ZonosAddressForm;
         "zonos-address-suggestions": ZonosAddressSuggestions;
@@ -4275,6 +4371,7 @@ declare module "@stencil/core" {
     export namespace JSX {
         interface IntrinsicElements {
             "zonos-address": LocalJSX.ZonosAddress & JSXBase.HTMLAttributes<HTMLZonosAddressElement>;
+            "zonos-address-completion-dialog": LocalJSX.ZonosAddressCompletionDialog & JSXBase.HTMLAttributes<HTMLZonosAddressCompletionDialogElement>;
             "zonos-address-display": LocalJSX.ZonosAddressDisplay & JSXBase.HTMLAttributes<HTMLZonosAddressDisplayElement>;
             "zonos-address-form": LocalJSX.ZonosAddressForm & JSXBase.HTMLAttributes<HTMLZonosAddressFormElement>;
             "zonos-address-suggestions": LocalJSX.ZonosAddressSuggestions & JSXBase.HTMLAttributes<HTMLZonosAddressSuggestionsElement>;