@zonos/elements 1.3.281 → 1.3.283

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

@@ -119,6 +119,9 @@ export declare const stringsItalian: {
     'Company name (optional)': {
         value: string;
     };
+    'Complete your shipping address': {
+        value: string;
+    };
     Confirm: {
         value: string;
     };
@@ -536,6 +539,9 @@ export declare const stringsItalian: {
     'Return to merchant site': {
         value: string;
     };
+    'Save and continue': {
+        value: string;
+    };
     'Search countries': {
         value: string;
     };
@@ -554,6 +560,9 @@ export declare const stringsItalian: {
     '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 stringsItalian: {
     "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.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/stripe/zonos-custom-address/zonos-custom-address.d.ts

@@ -1,6 +1,5 @@
 import type { EventEmitter } from '../../../stencil-public-runtime';
 import type { ContactOption, Stripe, StripeAddressElementChangeEvent } from '@stripe/stripe-js';
-import type { ICountryJson } from "../../../components";
 import type { CheckoutAddressService } from "../../utils/iframe/CheckoutAddressService";
 import type { CustomAddressErrors } from "../../../types/checkout/form/CustomAddressErrors";
 import type { CountryFields } from "../../../types/CountryFields";
@@ -71,17 +70,6 @@ export declare class ZonosAddress {
      * Whether to start google place suggestions
      */
     startGooglePlaceSuggestions: boolean;
-    /**
-     * List of countries to show in the address element
-     */
-    shipToCountries: {
-        label: string;
-        value: string;
-    }[] | null;
-    /**
-     * Shipping zones from localization
-     */
-    shippingZones: ICountryJson | null;
     city: string;
     country: string;
     firstName: string;
@@ -129,6 +117,15 @@ export declare class ZonosAddress {
      * Unsubscribe function for address selected listener
      */
     private onAddressSelectedUnsubscribe?;
+    /**
+     * Memoized country options, keyed on the store references they derive from.
+     * `render()` runs on every keystroke, and rebuilding the list each time would
+     * re-sort ~244 countries and hand `zonos-stripe-select` a new array identity,
+     * re-rendering it needlessly. `@stencil/store` replaces these references
+     * wholesale rather than mutating them, so reference equality is a safe key.
+     */
+    private countryOptionsCache;
+    private getCountryOptions;
     private getStripeAddressInstance;
     private updateAddressEventData;
     isAddressFilledChanged(): void;
@@ -160,7 +157,6 @@ export declare class ZonosAddress {
     private initAddressSuggestions;
     countryChanged(countryCode: string): void;
     shouldEnabledCustomAddressChanged(): void;
-    shippingZonesChanged(): void;
     private renderCustomAddressForm;
     private onStoreCheckoutSessionIdChanged;
     disconnectedCallback(): void;

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/getAddressCountryOptions.d.ts

@@ -0,0 +1,29 @@
+import type { ICountryJson } from "../../../types/ICountryJson";
+export type ICountryOption = {
+    label: string;
+    value: string;
+};
+/**
+ * Builds the country options for an address form's country dropdown.
+ *
+ * Shipping addresses are restricted to the merchant's shipping zone, since we
+ * can only fulfill orders to those countries. Billing addresses are not — a
+ * shopper's card can be billed to any country, so restricting the billing
+ * country prevents them from checking out at all (05CHECK-915).
+ *
+ * When the full country list is unavailable we fall back to the shipping zone
+ * so the dropdown is never empty.
+ */
+export declare const getAddressCountryOptions: ({ allCountries, shippingZoneCountries, type, }: {
+    /**
+     * All countries, regardless of shipping zone. `null` until localization has
+     * initialized or when the countries request failed.
+     */
+    allCountries: ICountryJson | null;
+    /**
+     * Countries in the merchant's shipping zone. `null` until localization has
+     * initialized.
+     */
+    shippingZoneCountries: ICountryJson | null;
+    type: "billing" | "shipping";
+}) => ICountryOption[];

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[];