@ingridab/sdk 0.1.0 → 0.3.0

package/dist/index.d.ts

@@ -1,22 +1,82 @@
 import { z } from 'zod';
 
 /**
- * @description AddonType defines the specific type of addon offered.\n\n - ADDON_TYPE_UNSPECIFIED: Addon type is unspecified or unknown.\n - CUSTOM: A custom addon specified by the carrier or merchant.\n - CARRY_IN: An addon for carrying the delivery item into the recipient\'s premises.\n - LEAVE_AT_DOOR: An addon for leaving the item at the door without requiring a signature.\n - UNWRAPPING: An addon for unwrapping the delivered item.
- * @default ADDON_TYPE_UNSPECIFIED
+ * @description ABTest is the A/B test assignment associated with this request.\nNot supported yet.
  */
-declare type AddonAddonType = AddonAddonTypeEnum;
+declare type ABTest = {
+    /**
+     * @description ExperimentID is the identifier of the experiment.
+     * @type string
+     */
+    experimentId: string;
+    /**
+     * @description VariantID is the identifier of the variant the user has been assigned to.
+     * @type string
+     */
+    variantId: string;
+};
+
+/**
+ * @description AddonType classifies an add-on service.
+ */
+declare type AddonType = AddonTypeEnum;
 
-declare type AddonAddonTypeEnum =
-| 'ADDON_TYPE_UNSPECIFIED'
-| 'CUSTOM'
-| 'CARRY_IN'
-| 'LEAVE_AT_DOOR'
-| 'UNWRAPPING';
+declare type AddonTypeEnum =
+| 'insurance'
+| 'signature'
+| 'age_verification'
+| 'id_verification'
+| 'notification'
+| 'other';
 
 /**
- * @description Common address entity that used almost everywhere in Ingrid\'s API.
+ * @description Address is a physical location in a global addressing context.\n\nValidation of postal code, administrative area, and other locality fields\nis conditional on the country code.
  */
 declare type Address = {
+    /**
+     * @description CountryCode is the ISO 3166-1 alpha-2 country code.
+     */
+    countryCode: CountryCode;
+    /**
+     * @description PostalCode is the postal code. Formatting and validation rules are\nconditional on the country code.
+     * @type string
+     */
+    postalCode: string;
+    /**
+     * @description AdministrativeArea is the first-level administrative subdivision\n(state, province, prefecture, etc.) as the ISO 3166-2 subdivision\ncode. Required for some destination countries — e.g. US, CA, MX, BR,\nAR, AU, CN, JP, MY, KR, ID, TH, IT, ES, IE — and ignored elsewhere.\nUse the country reference for specifics.
+     * @type string | undefined
+     */
+    administrativeArea?: string;
+    /**
+     * @description SubAdministrativeArea is the second-level administrative subdivision\n(county, district, etc.). Typically not required unless the country\nreference says otherwise.
+     * @type string | undefined
+     */
+    subAdministrativeArea?: string;
+    /**
+     * @description Locality is the primary locality of the address — usually the city,\ntown, village, or municipality.
+     * @type string | undefined
+     */
+    locality?: string;
+    /**
+     * @description SubLocality is the neighborhood, suburb, or district within the\nlocality. Required by some countries (e.g. JP chome, UK London\ndistricts, Latin-American colonias); see the country reference.
+     * @type string | undefined
+     */
+    subLocality?: string;
+    /**
+     * @description AddressLines are the ordered street address lines.\nIndex 0 holds primary street info (street name + number, or block\nnumber); subsequent indices hold secondary info (apartment, suite,\nfloor, building name).
+     * @type array | undefined
+     */
+    addressLines?: string[];
+    /**
+     * @description Type is the kind of address (residential, commercial, etc.).
+     */
+    type?: AddressType;
+};
+
+/**
+ * @description Common address entity that used almost everywhere in Ingrid\'s API.
+ */
+declare type Address_2 = {
     /**
      * @type array | undefined
      */
@@ -45,7 +105,7 @@ declare type Address = {
     /**
      * @type object | undefined
      */
-    coordinates?: Coordinates;
+    coordinates?: Coordinates_2;
     /**
      * @description Country should be specified as two uppercase letters (ISO Alpha-2).\nExample `SE` for Sweden, `ES` for Spain.
      * @type string | undefined
@@ -94,7 +154,7 @@ declare type Address = {
 /**
  * @description Ingrid Address API helps to collect clean addresses.\n\nAll errors follow RFC 7807 Problem Details format.
  */
-declare type Address_2 = {
+declare type Address_3 = {
     /**
      * @description ISO 3166-1 alpha-2 country code.
      * @minLength 2
@@ -135,7 +195,7 @@ declare type Address_2 = {
     /**
      * @type string | undefined
      */
-    type?: AddressType;
+    type?: AddressType_2;
 };
 
 /**
@@ -161,7 +221,7 @@ declare type AddressContactEntry = {
     companyName?: string;
 
     /** The address of the contact. */
-    address?: Address_2;
+    address?: Address_3;
 
     /** The email address of the contact. */
     email?: string;
@@ -194,7 +254,7 @@ declare type AddressDetailsResponse = {
     /**
      * @description The full address resolved from the prediction.
      */
-    address: Address_2;
+    address: Address_3;
 };
 
 /**
@@ -224,15 +284,13 @@ declare type AddressFormResponse = {
 
 declare type AddressFormService = {
     getAddressFormConfig: DataResolver<
-        { params: GetAddressFormQuery['QueryParams']; token: string },
+        { params: GetAddressFormQuery['QueryParams'] } & SDKManagedTokenArg,
     GetAddressFormQuery['Response']
     >;
 };
 
 /* Excluded from this release type: AddressMoleculeCustomization */
 
-declare type AddressMoleculeInputState = Partial<AddressContactEntry>;
-
 /**
  * Configuration params passed to the address molecule.
  *
@@ -248,8 +306,8 @@ declare type AddressMoleculeInputState = Partial<AddressContactEntry>;
  * ```
  */
 declare type AddressMoleculeParams = {
-    /** The rendering mode for the address molecule. Currently `'addressForm'` is supported. */
-    mode: 'addressForm';
+    /** The rendering mode for the address molecule. Currently `'addressForm'` and `'searchDriven'` are supported. */
+    mode: 'addressForm' | 'searchDriven';
     customization?: AddressMoleculePublicCustomization;
 };
 
@@ -266,7 +324,7 @@ declare type AddressMoleculePublicCustomization = {
         /**
          * Controls how the address book is presented.
          *
-         * @defaultValue `'inline'`
+         * @defaultValue `'off'`
          */
         displayMode?: 'off' | 'inline' | 'popup';
         /**
@@ -290,25 +348,31 @@ declare type AddressMoleculePublicCustomization = {
 
 declare type AddressSuggestionsService = {
     list: DataResolver<
-        { params: AutocompleteAddressQuery['QueryParams']; token: string },
+        { params: AutocompleteAddressQuery['QueryParams'] } & SDKManagedTokenArg,
     AutocompleteAddressQuery['Response']
     >;
     resolve: DataResolver<
         {
         params: GetAddressDetailsQuery['PathParams'] & GetAddressDetailsQuery['QueryParams'];
-        token: string;
-    },
+    } & SDKManagedTokenArg,
     GetAddressDetailsQuery['Response']
     >;
 };
 
+/**
+ * @description AddressType classifies an address.
+ */
 declare type AddressType = AddressTypeEnum;
 
+declare type AddressType_2 = AddressTypeEnum_2;
+
 declare type AddressTypeEnum = 'unknown' | 'residential' | 'commercial';
 
+declare type AddressTypeEnum_2 = 'unknown' | 'residential' | 'commercial';
+
 declare type AddressValidationService = {
     validateAddress: DataResolver<
-        { payload: ValidateAddressMutation['Request']; token: string },
+        { payload: ValidateAddressMutation['Request'] } & SDKManagedTokenArg,
     ValidateAddressMutation['Response']
     >;
 };
@@ -558,7 +622,7 @@ declare type AutocompleteAddressQueryParams = {
      * @pattern ^[A-Z]{2}$
      * @type string
      */
-    countryCode: CountryCode;
+    countryCode: CountryCode_2;
     /**
      * @description Site identifier, referring to which site the autocompletion is performed for.
      * @type string
@@ -598,12 +662,6 @@ declare type AutocompleteFocusEnum =
  */
 declare type BaseKey<K> = K extends `${infer B}_${Intl.LDMLPluralRule}` ? B : K;
 
-/**
- * TODO: this will come from the site config most probably and
- * the shape of the model will be different - for now it's kept as simple
- * as possible for MVP purposes
- */
-
 declare type BaseMoleculeDef<K extends MoleculeType> = {
     type: K;
     customization?: DeepPartial<MoleculeCustomizationConfig<K>>;
@@ -611,24 +669,45 @@ declare type BaseMoleculeDef<K extends MoleculeType> = {
 };
 
 /**
- * @description A phone number, including region and optional extension.
+ * @description Carrier identifies a delivery carrier.
+ */
+declare type Carrier = {
+    /**
+     * @description ID is the unique identifier for the carrier.
+     * @type string
+     */
+    id: string;
+    /**
+     * @description Name is the display name of the carrier.
+     * @type string
+     */
+    name: string;
+    /**
+     * @description LogoURL points to the carrier\'s logo image.
+     * @type string | undefined
+     */
+    logoUrl?: string;
+};
+
+/**
+ * @description CarrierProduct identifies a specific product offered by a carrier.
  */
-declare type ContactPhoneNumber = {
+declare type CarrierProduct = {
     /**
-     * @description \nThe country code where the delivery will occur (ISO 3166-1 alpha-2).
+     * @description ID is the unique identifier for the product.
      * @type string
      */
-    country_code: string;
+    id: string;
     /**
-     * @description The main phone number, formatted as per the region\'s conventions.
+     * @description Name is the display name of the product.
      * @type string
      */
-    number: string;
+    name: string;
     /**
-     * @description An optional phone number extension.
+     * @description Description is a description of the product.
      * @type string | undefined
      */
-    extension?: string;
+    description?: string;
 };
 
 declare type ContactsService = {
@@ -638,8 +717,7 @@ declare type ContactsService = {
             addressBookId: string;
             countryCode?: string;
         };
-        token: string;
-    },
+    } & SDKManagedTokenArg,
         {
         entries: { id: string; label: string; secondaryLabel: string }[];
     }
@@ -647,8 +725,7 @@ declare type ContactsService = {
     getContactBookEntry: DataResolver<
         {
         params: { id: string; addressBookId: string };
-        token: string;
-    },
+    } & SDKManagedTokenArg,
     AddressContactEntry
     >;
     upsertContactBookEntry: DataResolver<
@@ -657,17 +734,49 @@ declare type ContactsService = {
         params: {
             addressBookId: string;
         };
-        token: string;
-    },
+    } & SDKManagedTokenArg,
     AddressContactEntry
     >;
     deleteContactBookEntry: DataResolver<
-        { params: { addressBookId: string; id: string }; token: string },
+        { params: { addressBookId: string; id: string } } & SDKManagedTokenArg,
     object
     >;
 };
 
+/**
+ * @description Context is caller-supplied information used for personalisation and\nanalytics. All fields are optional and are not validated against the\noffer token.
+ */
+declare type Context = {
+    /**
+     * @description User describes the end user the request is being made on behalf of.
+     */
+    user?: User;
+    /**
+     * @description ABTest carries the A/B test assignment for this request. Not supported yet.
+     */
+    abTest?: ABTest;
+    /**
+     * @description Fingerprint is an opaque, caller-generated fingerprint of the end user (e.g. for fraud or analytics).
+     * @type string | undefined
+     */
+    fingerprint?: string;
+};
+
+/**
+ * @description Coordinates are geographic coordinates in the WGS 84 reference system.
+ */
 declare type Coordinates = {
+    /**
+     * @description Latitude in decimal degrees, in the range [-90, 90].
+     */
+    latitude: Latitude;
+    /**
+     * @description Longitude in decimal degrees, in the range [-180, 180].
+     */
+    longitude: Longitude;
+};
+
+declare type Coordinates_2 = {
     /**
      * @type number | undefined, double
      */
@@ -679,10 +788,18 @@ declare type Coordinates = {
 };
 
 /**
+ * @description CountryCode is an ISO 3166-1 alpha-2 two-letter country code.
+ * @minLength 2
+ * @maxLength 2
  * @pattern ^[A-Z]{2}$
  */
 declare type CountryCode = string;
 
+/**
+ * @pattern ^[A-Z]{2}$
+ */
+declare type CountryCode_2 = string;
+
 declare const countrySelectorMoleculeParamsValidator = z.object({
     mode: z.enum(['select']),
     name: z.string(),
@@ -696,19 +813,21 @@ declare type CountrySelectorParams = {
 };
 
 /**
- * Creates a molecule configuration for the address particle.
+ * Creates a molecule configuration for the address molecule.
  *
  * Renders an address form that collects and validates the shopper's shipping address.
  *
- * @param params - Configuration for the address particle. See `AddressParticleParams`.
+ * @param params - Configuration for the address molecule. See `AddressMoleculeParams`.
  * @returns A molecule descriptor to pass to the `molecules` array in {@link IngridInitParams}.
  *
  * @example
  * ```ts
- * const ingrid = await initIngrid({
+ * const instance = await ingrid.init({
  *   token: 'your-auth-token',
  *   siteId: 'your-site-id',
  *   locale: 'en-US',
+ *   countryCode: 'US',
+ *   currency: 'USD',
  *   molecules: [
  *     createAddressMolecule({
  *       mode: 'addressForm'
@@ -723,144 +842,15 @@ export declare const createAddressMolecule: ({ mode, customization }: MoleculePa
     type: "address";
     customization: AddressMoleculePublicCustomization | undefined;
     params: {
-        mode: "addressForm";
-    };
-};
-
-/**
- * Creates a molecule configuration for the country selector particle.
- *
- * Renders a country picker that allows the shopper to select their delivery country.
- * Changing the country refreshes available delivery options.
- *
- * @param params - Configuration for the country selector particle. See `CountrySelectorParams`.
- * @returns A molecule descriptor to pass to the `molecules` array in {@link IngridInitParams}.
- *
- * @example
- * ```ts
- * const ingrid = await initIngrid({
- *   token: 'your-auth-token',
- *   siteId: 'your-site-id',
- *   locale: 'en-US',
- *   molecules: [
- *     createCountrySelectorMolecule({ mode: 'select', name: 'country-picker' }),
- *   ],
- * });
- * ```
- *
- * @public
- */
-export declare const createCountrySelectorMolecule: ({ mode, name, }: MoleculeParamsMap["countrySelector"]) => {
-    type: "countrySelector";
-    params: {
-        mode: "select";
-        name: string;
-    };
-};
-
-/**
- * Creates a molecule configuration for the delivery particle.
- *
- * Renders a delivery options selector where the shopper can browse and choose a shipping method.
- * Use `mode: 'active'` for a checkout flow where the shopper makes a selection, and
- * `mode: 'passive'` for a read-only summary display.
- *
- * @param params - Configuration for the delivery particle. See `DeliveryParticleParams`.
- * @returns A molecule descriptor to pass to the `molecules` array in {@link IngridInitParams}.
- *
- * @example
- * ```ts
- * const ingrid = await initIngrid({
- *   token: 'your-auth-token',
- *   siteId: 'your-site-id',
- *   locale: 'en-US',
- *   molecules: [
- *     createDeliveryMolecule({ mode: 'active', name: 'main-delivery' }),
- *   ],
- * });
- * ```
- *
- * @public
- */
-export declare const createDeliveryMolecule: ({ mode, name, customization, }: MoleculeParamsMap["delivery"]) => {
-    type: "delivery";
-    customization: {
-        choice?: {
-            carrierInstructions?: "off" | "inline" | "popup";
-            gaplessAddonsList?: boolean;
-            gaplessCarrierList?: boolean;
-            gaplessDeliveryList?: boolean;
-            labels?: "off" | "chips" | "text";
-            showAddons?: boolean;
-            showCustomInfoText?: boolean;
-            showCustomText?: boolean;
-            showDiscountedPrice?: boolean;
-            showFreeShippingIndicator?: boolean;
-            showPrice?: boolean;
-            showRadioIndicator?: boolean;
-            showReturnPromise?: boolean;
-            showShippingLogo?: boolean;
-        };
-        location?: {
-            gaplessList?: boolean;
-            mapDefaultVisible?: boolean;
-            mapDefaultZoom?: number;
-            mapFitboundsMaxZoom?: number;
-            mapPosition?: "start" | "end";
-            mapToggleEnabled?: boolean;
-        };
-        productList?: {
-            defaultView?: "off" | "list" | "summary";
-            showImage?: boolean;
-            showMetadata?: boolean;
-            showPrice?: boolean;
-            showQuantity?: boolean;
-            summaryText?: "none" | "products" | "firstProductAndMore";
-        };
-        summary?: {
-            previewAddons?: boolean;
-            showFreeShippingIndicator?: boolean;
-        };
-    } | undefined;
-    params: {
-        mode: "active" | "passive";
-        name: string;
+        mode: "addressForm" | "searchDriven";
     };
 };
 
 /**
- * Creates a molecule configuration for the free shipping indicator particle.
- *
- * Renders a progress bar or message showing how close the shopper is to qualifying
- * for free shipping. Pair it with a delivery molecule that has `showFreeShippingIndicator`
- * enabled, or use it standalone via the `deliveryId` param.
- *
- * @param params - Configuration for the free shipping indicator particle. See `FreeShippingIndicatorParams`.
- * @returns A molecule descriptor to pass to the `molecules` array in {@link IngridInitParams}.
- *
- * @example
- * ```ts
- * const ingrid = await initIngrid({
- *   token: 'your-auth-token',
- *   siteId: 'your-site-id',
- *   locale: 'en-US',
- *   molecules: [
- *     createFreeShippingIndicatorMolecule({ name: 'free-shipping' }),
- *   ],
- * });
- * ```
- *
- * @public
+ * @description Currency is an ISO 4217 three-letter currency code.
+ * @pattern ^[A-Z]{3}$
  */
-export declare const createFreeShippingIndicatorMolecule: ({ name, customization, }: MoleculeParamsMap["freeShippingIndicator"]) => {
-    type: "freeShippingIndicator";
-    customization: {
-        showExhaustedLevelsMessage?: boolean;
-    } | undefined;
-    params: {
-        name: string;
-    };
-};
+declare type Currency = string;
 
 declare type DataResolver<Args, Output> = (args: Args) => Promise<Output>;
 
@@ -890,440 +880,133 @@ DeepPartial<U>[]
 : T;
 
 /**
- * @description An Addon represents an additional service or feature offered with a delivery.
+ * @description DeliveryAddress is a delivery destination address.\n\nIt extends Address with recipient- and delivery-specific fields and is used\nas the destination on `POST /v1/delivery/options` and\n`POST /v1/delivery/orders`.
  */
-declare type DeliveryAddon = {
+declare type DeliveryAddress = {
     /**
-     * @description The display-friendly name of the addon, e.g., \"Gift Wrapping\", \"Leave at Door\".\nDisplay name and description are localized, if translations are provided.
-     * @type string
+     * @description CountryCode is the ISO 3166-1 alpha-2 country code.
      */
-    display_name: string;
+    countryCode: CountryCode;
     /**
-     * @description The price of the addon in minor currency units, e.g., cents.
-     * @type string | undefined, int64
+     * @description PostalCode is the postal code. Formatting and validation rules are\nconditional on the country code.
+     * @type string
      */
-    readonly price?: string;
+    postalCode: string;
     /**
-     * @description AddonType defines the specific type of addon offered.\n\n - ADDON_TYPE_UNSPECIFIED: Addon type is unspecified or unknown.\n - CUSTOM: A custom addon specified by the carrier or merchant.\n - CARRY_IN: An addon for carrying the delivery item into the recipient\'s premises.\n - LEAVE_AT_DOOR: An addon for leaving the item at the door without requiring a signature.\n - UNWRAPPING: An addon for unwrapping the delivered item.
+     * @description AdministrativeArea is the first-level administrative subdivision\n(state, province, prefecture, etc.) as the ISO 3166-2 subdivision\ncode. Required for some destination countries — e.g. US, CA, MX, BR,\nAR, AU, CN, JP, MY, KR, ID, TH, IT, ES, IE — and ignored elsewhere.\nUse the country reference for specifics.
      * @type string | undefined
      */
-    addon_type?: AddonAddonType;
-    /**
-     * @description Indicates if this addon should be preselected by default.
-     * @type boolean | undefined
-     */
-    preselected?: boolean;
-    /**
-     * @description Indicates if this addon was chosen.
-     * @type boolean | undefined
-     */
-    chosen?: boolean;
+    administrativeArea?: string;
     /**
-     * @description Unique addon identifier.
+     * @description SubAdministrativeArea is the second-level administrative subdivision\n(county, district, etc.). Typically not required unless the country\nreference says otherwise.
      * @type string | undefined
      */
-    readonly id?: string;
+    subAdministrativeArea?: string;
     /**
-     * @description The external identifier of an addon, used for integration purposes.
+     * @description Locality is the primary locality of the address — usually the city,\ntown, village, or municipality.
      * @type string | undefined
      */
-    readonly external_id?: string;
+    locality?: string;
     /**
-     * @description The display-friendly description of the addon.\nDisplay name and description are localized, if translations are provided.
+     * @description SubLocality is the neighborhood, suburb, or district within the\nlocality. Required by some countries (e.g. JP chome, UK London\ndistricts, Latin-American colonias); see the country reference.
      * @type string | undefined
      */
-    readonly description?: string;
-};
-
-declare const deliveryArgsSchema = z.object({ sessionId: z.string(), token: z.string() });
-
-/**
- * @description DeliveryType defines the method or mode of delivery.\n\n - DELIVERY_TYPE_UNSPECIFIED: Delivery type is unspecified or unknown.\n - DELIVERY: Delivery to a customer\'s home or address.\n - PICKUP: Delivery to a service point or locker.\n - MAILBOX: Delivery to a customer\'s mailbox.\n - INSTORE: Delivery to a merchant\'s store for in-store pickup.
- * @default DELIVERY_TYPE_UNSPECIFIED
- */
-declare type DeliveryCategoryDeliveryType = DeliveryCategoryDeliveryTypeEnum;
-
-declare type DeliveryCategoryDeliveryTypeEnum =
-| 'DELIVERY_TYPE_UNSPECIFIED'
-| 'DELIVERY'
-| 'PICKUP'
-| 'MAILBOX'
-| 'INSTORE';
-
-/**
- * @description OptionsSource specifies the origin of the delivery options.\n\n - OPTIONS_SOURCE_UNSPECIFIED: Source of the options is unspecified.\n - FALLBACK: Delivery options come from a fallback configuration.\n - CARRIER: Delivery options are sourced directly from the carrier.
- * @default OPTIONS_SOURCE_UNSPECIFIED
- */
-declare type DeliveryCategoryOptionsSource = DeliveryCategoryOptionsSourceEnum;
-
-declare type DeliveryCategoryOptionsSourceEnum =
-| 'OPTIONS_SOURCE_UNSPECIFIED'
-| 'FALLBACK'
-| 'CARRIER';
-
-declare type DeliveryCategoryPriceLevels = {
+    subLocality?: string;
     /**
-     * @description Available price levels for the carrier product.\nOnly the base price and prices with the `total_value` price rule are included.
+     * @description AddressLines are the ordered street address lines.\nIndex 0 holds primary street info (street name + number, or block\nnumber); subsequent indices hold secondary info (apartment, suite,\nfloor, building name).
      * @type array | undefined
      */
-    price_levels?: PriceLevelsPriceLevel[];
-};
-
-/**
- * @description Information about a warehouse.\nAll this data is stored in the site configuration.
- */
-declare type DeliveryCategoryWarehouse = {
+    addressLines?: string[];
     /**
-     * @description Unique identifier of the warehouse.
-     * @type string
+     * @description Type is the kind of address (residential, commercial, etc.).
      */
-    id: string;
+    type?: AddressType;
     /**
-     * @description Represents an address suitable for delivery.
-     * @type object
+     * @description Instructions are free-text notes for the courier (door code, parking\nnotes, etc.). Honoured only when the selected service has\n`supports.courierInstructions: true`.
+     * @type string | undefined
      */
-    address: V1AlphaDeliveryAddress;
+    instructions?: string;
     /**
-     * @description The external identifier of a warehouse, used for integration purposes.
+     * @description RecipientName is the name of the recipient, formatted as expected in the destination country.
      * @type string | undefined
      */
-    external_id?: string;
+    recipientName?: string;
 };
 
 /**
- * @description Represents a latitude/longitude pair.\nUnless specified otherwise, this must conform to the WGS84 standard.\nValues must be within normalized ranges.
+ * @description DeliveryCategory groups services by delivery type and provides display\nmetadata to organise the UI.
  */
-declare type DeliveryCoordinates = {
-    /**
-     * @description The latitude in degrees. Must be within the range -90.0 to +90.0, inclusive.
-     * @type number, double
-     */
-    lat: number;
+declare type DeliveryCategory = {
     /**
-     * @description The longitude in degrees. Must be within the range -180.0 to +180.0, inclusive.
-     * @type number, double
+     * @description ID is the unique identifier for this category.
+     * @type string
      */
-    lng: number;
-};
-
-/**
- * @description The DeliveryCategory represents a grouping of delivery options that share the same type and other characteristics.
- */
-declare type DeliveryDeliveryCategory = {
+    id: string;
     /**
-     * @description The unique identifier of a delivery category.
+     * @description Name is the display name for this category.
      * @type string
      */
-    id: string;
+    name: string;
     /**
-     * @description The external identifier of a category, used for integration purposes.
-     * @type string | undefined
+     * @description DeliveryType is the kind of delivery for all services in this category.
      */
-    external_id?: string;
+    deliveryType: DeliveryType;
     /**
-     * @description DeliveryType defines the method or mode of delivery.\n\n - DELIVERY_TYPE_UNSPECIFIED: Delivery type is unspecified or unknown.\n - DELIVERY: Delivery to a customer\'s home or address.\n - PICKUP: Delivery to a service point or locker.\n - MAILBOX: Delivery to a customer\'s mailbox.\n - INSTORE: Delivery to a merchant\'s store for in-store pickup.
-     * @type string
+     * @description Services are the available delivery services in this category.
+     * @type array
      */
-    delivery_type: DeliveryCategoryDeliveryType;
+    services: DeliveryService_2[];
     /**
-     * @description A human-readable name of the category, which will be presented to the customer.
-     * @type string
+     * @description Preselected indicates whether this category should be pre-selected\nby default. At most one category per delivery group is preselected.
+     * @type boolean | undefined
      */
-    display_name: string;
+    preselected?: boolean;
     /**
-     * @description Defines the order in which the category will be presented to the customer.
+     * @description SortOrder is the sort order for displaying this category (lower numbers first).
      * @type integer | undefined, int32
      */
-    sort_order?: number;
+    sortOrder?: number;
     /**
-     * @description OptionsSource specifies the origin of the delivery options.\n\n - OPTIONS_SOURCE_UNSPECIFIED: Source of the options is unspecified.\n - FALLBACK: Delivery options come from a fallback configuration.\n - CARRIER: Delivery options are sourced directly from the carrier.
-     * @type string
-     */
-    options_source: DeliveryCategoryOptionsSource;
-    /**
-     * @description The delivery options available within this category.
-     * @type array
-     */
-    delivery_options: DeliveryDeliveryOption[];
-    /**
-     * @description Add-ons that are available for this category, e.g., gift wrapping, insurance.
-     * @type array | undefined
-     */
-    addons?: DeliveryAddon[];
-    /**
-     * @description Indicates if this category should be preselected by default.
-     * @type boolean | undefined
-     */
-    preselected?: boolean;
-    /**
-     * @description Indicates if this category was chosen by the user.
-     * @type boolean | undefined
-     */
-    chosen?: boolean;
-    /**
-     * @description Information about a warehouse.\nAll this data is stored in the site configuration.
-     * @type object | undefined
-     */
-    warehouse?: DeliveryCategoryWarehouse;
-    /**
-     * @description Tags associated with the delivery category, used for cross-reference purposes.
-     * @type array | undefined
-     */
-    readonly tags?: string[];
-    /**
-     * @description Information about active labels associated with the delivery category.\nLabels name and description are localized, if translations are provided.
-     * @type array | undefined
-     */
-    readonly labels?: DeliveryDeliveryCategoryLabel[];
-    /**
-     * @description Additional text that can be displayed with the category.\nThe presence of this field depends on the locale.
-     * @type string | undefined
-     */
-    readonly custom_text?: string;
-    /**
-     * @description Additional information that can be displayed with the category.\nThe presence of this field depends on the locale.
+     * @description CustomText is custom text to display alongside this category.
      * @type string | undefined
      */
-    readonly custom_info_text?: string;
+    customText?: string;
     /**
-     * @type object | undefined
-     */
-    readonly price_levels?: Record<string, DeliveryCategoryPriceLevels>;
-};
-
-/**
- * @description Labels provide additional, customer-facing information for the delivery category.
- */
-declare type DeliveryDeliveryCategoryLabel = {
-    /**
-     * @description Unique identifier of the label.
+     * @description WarningText is warning text to display for this category (e.g. delivery delays).
      * @type string | undefined
      */
-    id?: string;
+    warningText?: string;
     /**
-     * @description Display name of the label.
-     * @type string | undefined
-     */
-    name?: string;
-    /**
-     * @description Description of the label displayed to the customer.
-     * @type string | undefined
-     */
-    description?: string;
-    /**
-     * @description LabelType defines the type of label.\n\n - LABEL_TYPE_UNKNOWN: Label type is unknown.\n - LABEL_TYPE_SUSTAINABILITY: A sustainability-related label.\n - LABEL_TYPE_PRIORITY: A priority delivery label.\n - LABEL_TYPE_CUSTOM: A custom label defined by the merchant.\n - LABEL_TYPE_SWAN: A Nordic Swan eco-label.
-     * @type string | undefined
-     */
-    type?: LabelLabelType;
-    /**
-     * @description Color code for the label, e.g., hex value.
-     * @type string | undefined
-     */
-    color?: string;
-    /**
-     * @description URI or identifier for the label icon.
-     * @type string | undefined
-     */
-    icon?: string;
-    /**
-     * @description Color code for the label in dark mode, e.g., hex value.
-     * @type string | undefined
-     */
-    dark_mode_color?: string;
-};
-
-declare type DeliveryDeliveryNode = {
-    /**
-     * @description Constraints on the node\'s handoff.
-     * @type object | undefined
-     */
-    handoff?: DeliveryNodeHandoff;
-    /**
-     * @description Where the node is physically located.
-     * @type object
-     */
-    location: DeliveryDeliveryNodeLocation;
-    /**
-     * @description What roles the node can perform.
-     * @type array
-     */
-    roles: DeliveryNodeRole[];
-    /**
-     * @description Additional metadata about the node.\nFor cross-reference purposes.
+     * @description Tags are additional categorisation/filtering tags.
      * @type array | undefined
      */
     tags?: string[];
-};
-
-/**
- * @description Where the node is physically located.
- */
-declare type DeliveryDeliveryNodeLocation = {
     /**
-     * @description To provide full information about the location.
-     * @type object | undefined
-     */
-    by_value?: LocationByValue;
-    /**
-     * @description To reference an existing location.
-     * @type object | undefined
+     * @description ExternalID is an external identifier for merchant-specific integrations.
+     * @type string | undefined
      */
-    by_ref?: LocationByRef;
+    externalId?: string;
 };
 
 /**
- * @description The DeliveryOption represents the details of a specific delivery option.
+ * @description DeliveryGroup holds the delivery options for a single shipment. In\nsplit-shipment scenarios the response carries multiple groups.
  */
-declare type DeliveryDeliveryOption = {
+declare type DeliveryGroup = {
     /**
-     * @description The unique identifier of the delivery option.
+     * @description ID is the unique identifier for this delivery group. Used to\ncorrelate with fulfillment groups in the request.
      * @type string
      */
     id: string;
     /**
-     * @description The Carrier contains details about the shipping carrier associated with this delivery option.
-     * @type object
-     */
-    carrier: DeliveryOptionCarrier;
-    /**
-     * @description The PickupLocation represents a physical location from which a delivery can be retrieved.
-     * @type object | undefined
-     */
-    pickup_location?: DeliveryPickupLocation;
-    /**
-     * @description ETD stands for Estimated Time of Delivery.
-     * @type object
-     */
-    etd: DeliveryETD;
-    /**
-     * @description Indicates if this delivery option should be preselected by default.
-     * @type boolean | undefined
-     */
-    preselected?: boolean;
-    /**
-     * @description Indicates if this delivery option was chosen by the customer.
-     * @type boolean | undefined
-     */
-    chosen?: boolean;
-    /**
-     * @description The expiration timestamp in UTC of the delivery option.
-     * @type string | undefined, date-time
-     */
-    expire_time?: string;
-    /**
-     * @description Price associated with the delivery option in minor currency units, e.g., cents.
-     * @type string, int64
-     */
-    price: string;
-    /**
-     * @description Where delivery originates from.
-     * @type object
-     */
-    origin: DeliveryOptionOrigin;
-};
-
-/**
- * @description Represents a distance measurement with both spatial distance and estimated travel time.
- */
-declare type DeliveryDistance = {
-    /**
-     * @description Approximate distance in meters.
-     * @type string | undefined, int64
-     */
-    readonly meters?: string;
-    /**
-     * @description Approximate duration in minutes.
-     * @type string | undefined, int64
-     */
-    readonly minutes?: string;
-};
-
-/**
- * @description ETD stands for Estimated Time of Delivery.
- */
-declare type DeliveryETD = {
-    /**
-     * @description Relative represents an ETD as a range of time units.
-     * @type object | undefined
-     */
-    relative?: ETDRelative;
-    /**
-     * @description Absolute represents an ETD as a single or pair of timestamps.
-     * @type object | undefined
-     */
-    absolute?: ETDAbsolute;
-    /**
-     * @description Custom represents an ETD in a human-readable text format.
-     * @type object | undefined
-     */
-    custom?: ETDCustom;
-};
-
-/**
- * @description A Fulfillment details when a delivery can be fulfilled.
- */
-declare type DeliveryFulfillment = {
-    /**
-     * @description Readiness specifies a time range when the goods will be ready for shipment.
-     * @type object
-     */
-    readiness: FulfillmentReadiness;
-    /**
-     * @description List of category tags, to which the `Readiness` applies.\nIf empty, the `Readiness` applies to all categories.
-     * @type array | undefined
-     */
-    category_tags?: string[];
-};
-
-/**
- * @description Represents a single item.
- */
-declare type DeliveryLineItem = {
-    /**
-     * @description The unique item identifier of the item.
-     * @type string
-     */
-    sku: string;
-    /**
-     * @description The item name or title, which is suitable for presentation to the customer.
-     * @type string
-     */
-    title: string;
-    /**
-     * @description Total quantity of the item.
-     * @type integer, int32
-     */
-    quantity: number;
-    /**
-     * @description Weight of a single item in grams, must be greater than 0.
-     * @type integer | undefined, int32
-     */
-    weight?: number;
-    /**
-     * @description Represents the dimensions of the item.
-     * @type object | undefined
-     */
-    dimensions?: LineItemDimensions;
-    /**
-     * @description Non-negative discount applied to the item, or items. Unit is cents.
-     * @type string | undefined, int64
-     */
-    discount?: string;
-    /**
-     * @description Non-negative price of a single item after applying discounts. Unit is cents.
-     * @type string | undefined, int64
+     * @description Categories are the available delivery categories for this group.\nCategories organise services by delivery type (home delivery,\npickup, etc.).
+     * @type array
      */
-    price?: string;
+    categories: DeliveryCategory[];
     /**
-     * @description URI of the product image, e.g., thumbnail.
+     * @description FulfillmentGroupRef references the fulfillment group in the request that this delivery group corresponds to.
      * @type string | undefined
      */
-    image_uri?: string;
-    /**
-     * @description Used to control the behaviour of the filter/price rules.\nEquivalent of cart_items_attributes in the `Delivery Checkout` API.
-     * @type array | undefined
-     */
-    attributes?: string[];
+    fulfillmentGroupRef?: string;
 };
 
 declare type DeliveryMoleculeParams = {
@@ -1340,11 +1023,18 @@ declare type DeliveryMoleculeParams = {
             showCustomInfoText?: boolean;
             showCustomText?: boolean;
             showDiscountedPrice?: boolean;
+            zeroPriceDisplay?: 'free' | '0';
             showFreeShippingIndicator?: boolean;
             showPrice?: boolean;
             showRadioIndicator?: boolean;
             showReturnPromise?: boolean;
             showShippingLogo?: boolean;
+            showDeliveryTime?: boolean;
+            showLocationSection?: boolean;
+            showLocationAddress?: boolean;
+            showLocationCarrierName?: boolean;
+            showLocationType?: boolean;
+            categoryLabel?: 'name' | 'type';
         };
         location?: {
             gaplessList?: boolean;
@@ -1353,6 +1043,15 @@ declare type DeliveryMoleculeParams = {
             mapFitboundsMaxZoom?: number;
             mapPosition?: 'start' | 'end';
             mapToggleEnabled?: boolean;
+            zeroPriceDisplay?: 'free' | '0';
+            displayMode?: 'popup' | 'inline';
+            selectionControl?: 'radio' | 'disabled';
+            selectionAlignment?: 'left' | 'right';
+            showLocationAddress?: boolean;
+            showCarrierName?: boolean;
+            showLocationType?: boolean;
+            showOpeningHours?: boolean;
+            showPrice?: boolean;
         };
         productList?: {
             defaultView?: 'off' | 'list' | 'summary';
@@ -1361,276 +1060,166 @@ declare type DeliveryMoleculeParams = {
             showPrice?: boolean;
             showQuantity?: boolean;
             summaryText?: 'none' | 'products' | 'firstProductAndMore';
+            zeroPriceDisplay?: 'free' | '0';
         };
         summary?: {
             previewAddons?: boolean;
             showFreeShippingIndicator?: boolean;
+            showDiscountedPrice?: boolean;
+            zeroPriceDisplay?: 'free' | '0';
+            categoryLabel?: 'name' | 'type';
         };
     };
 };
 
 declare const deliveryMoleculeParamsValidator = z.object({
     customization: deliveryCustomizationValidator,
-
-    // TODO: the passive `mode` has hardcoded logic, but IMHO the behaviour should come from granular config (components + policies), not from `mode` branches.
-    // Just an simple example:
-    //  components: {
-    //    continue_button: { display: 'hidden' },
-    //    pickup_location: { display: 'popup', interaction: 'preview' // or edit }
-    //  }
-    //
-    //  actionPolicy: {
-    //    select_item: 'deny'
-    //  }
-    //
     mode: z.enum(['active', 'passive']),
     name: z.string(),
 }) satisfies z.ZodType<DeliveryMoleculeParams>;
 
 /**
- * @description Constraints on the node\'s handoff.
+ * @description DeliveryOptionsResponse is the response returned for a request to compute\ndelivery options.\n\nOptions are organised into groups (one per requested fulfillment group)\nand, within each group, into categories (by delivery type). Each service\nwithin a category is a selectable delivery option.
  */
-declare type DeliveryNodeHandoff = {
-    /**
-     * @description The earliest time the node can hand off the delivery.
-     * @type string | undefined, date-time
-     */
-    earliest_time?: string;
+declare type DeliveryOptionsResponse = {
     /**
-     * @description The latest time the node can hand off the delivery.
-     * @type string | undefined, date-time
+     * @description Groups are the delivery groups, one per fulfillment group in the\nrequest. For single-shipment orders this contains exactly one group;\nfor split shipments each group represents a separate delivery.
+     * @type array
      */
-    latest_time?: string;
+    groups: DeliveryGroup[];
 };
 
 /**
- * @description Set of available roles for the node.\n\n - ROLE_UNSPECIFIED: Role is unspecified.\n - ORIGIN: The node is the origin of the delivery.\n - DESTINATION: The node is the destination of the delivery.
- * @default ROLE_UNSPECIFIED
+ * @description DeliveryRoute is the journey from origin to destination for a delivery.\nComplex deliveries may include multiple legs.
  */
-declare type DeliveryNodeRole = DeliveryNodeRoleEnum;
-
-declare type DeliveryNodeRoleEnum = 'ROLE_UNSPECIFIED' | 'ORIGIN' | 'DESTINATION';
-
-/**
- * @description The Carrier contains details about the shipping carrier associated with this delivery option.
- */
-declare type DeliveryOptionCarrier = {
+declare type DeliveryRoute = {
     /**
-     * @description The name of the carrier company, e.g., \"DHL\", \"FedEx\".
+     * @description ID is the unique identifier for this route.
      * @type string
      */
-    name: string;
-    /**
-     * @description The product or service level name provided by the carrier, e.g., \"Parcel\", \"Standard\".
-     * @type string
-     */
-    product_name: string;
-    /**
-     * @description The product or service level identifier provided by the carrier, e.g., \"dhl-par\", \"ups-std\".
-     * @type string
-     */
-    product_id: string;
-    /**
-     * @description The original sort order assigned by the carrier.
-     * @type integer | undefined, int32
-     */
-    sort_order?: number;
-    /**
-     * @description Carrier-specific metadata.
-     * @type object | undefined
-     */
-    meta?: Record<string, string>;
+    id: string;
     /**
-     * @description Merchant-specific carrier product identifier.
-     * @type string
+     * @description Legs are the individual steps of the delivery journey.
+     * @type array
      */
-    external_id: string;
+    legs: RouteLeg[];
 };
 
-/**
- * @description Where delivery originates from.
- */
-declare type DeliveryOptionOrigin = {
-    /**
-     * @description Unique identifier of the origin.
-     * @type string
-     */
-    id: string;
-    /**
-     * @description Represents an address suitable for delivery.
-     * @type object
-     */
-    address: V1AlphaDeliveryAddress;
-    /**
-     * @description External identifier of the origin, used for integration purposes.
-     * @type string | undefined
-     */
-    external_id?: string;
+declare type DeliveryService = {
+    getDeliveryOptions: DataResolver<GetDeliveryOptionsArgs, DeliveryOptionsResponse>;
+    listLocations: DataResolver<ListLocationsArgs, ListLocationsResponse>;
 };
 
 /**
- * @description The PickupLocation represents a physical location from which a delivery can be retrieved.
+ * @description DeliveryService is a specific, selectable shipping option.
  */
-declare type DeliveryPickupLocation = {
+declare type DeliveryService_2 = {
     /**
-     * @description Internal location identifier, used within the system.
-     * @type string
+     * @description Carrier provides this delivery service.
      */
-    id: string;
+    carrier: Carrier;
     /**
-     * @description External identifier provided by the merchant or carrier.
-     * @type string
+     * @description Product is the carrier product for this delivery option. The product\n`id` is globally unique and should be used when selecting this\nservice.
      */
-    external_id: string;
+    product: CarrierProduct;
     /**
-     * @description LocationType defines the type of the pickup location.\n\n - LOCATION_TYPE_UNSPECIFIED: Unspecified type.\n - LOCKER: A locker pickup location.\n - STORE: A store pickup location.\n - POSTOFFICE: A post office pickup location.\n - MANNED: A manned pickup location, e.g., staffed desk.
-     * @type string | undefined
+     * @description DeliveryTime is when the delivery is expected to arrive.
      */
-    location_type?: PickupLocationLocationType;
+    deliveryTime: DeliveryTime;
     /**
-     * @description The title of the location displayed to the customer.
-     * @type string
+     * @description Price is the price for this delivery option.
      */
-    title: string;
+    price: ServicePrice;
     /**
-     * @description Contact represents generic contact information.
-     * @type object | undefined
+     * @description Location holds location details for the service.\n\n- For `instore` services this is set to the merchant store location.\n- For `pickup` services it is **not** populated by `/v1/delivery/options`.\n  Pickup locations are fetched separately via `POST /v1/delivery/locations`,\n  passing the service\'s `product.id` and the same `deliveryCriteria`.\n  This keeps the options response small and avoids unnecessary location\n  lookups when many pickup products are returned.
      */
-    visiting_contact?: V1AlphaDeliveryContact;
-    /**
-     * @description Contact represents generic contact information.
-     * @type object | undefined
-     */
-    delivery_contact?: V1AlphaDeliveryContact;
-    /**
-     * @description OperationalHours define when the pickup location is operating.
-     * @type object | undefined
-     */
-    operational_hours?: PickupLocationOperationalHours;
+    location?: Location_2;
     /**
-     * @description Additional informational sections about the pickup location.
+     * @description TimeSlots are the available time slots for scheduled delivery (if applicable).
      * @type array | undefined
      */
-    sections?: PickupLocationSection[];
-    /**
-     * @description Distances define the walking and driving distances to the pickup location.
-     * @type object | undefined
-     */
-    distances?: PickupLocationDistances;
-};
-
-/**
- * @description ReturnPromise contains promise for returns and exchanges for a user and a cart.
- */
-declare type DeliveryReturnsPromise = {
+    timeSlots?: TimeSlot[];
     /**
-     * @description Unique identifier for the return promise.
-     * @type string | undefined
-     */
-    readonly id?: string;
-    /**
-     * @description Currency code for the return promise, e.g., \"USD\", \"EUR\".
-     * @type string | undefined
-     */
-    readonly currency_code?: string;
-    /**
-     * @description Indicates whether returns are enabled. See `return_cost` for the associated cost.
-     * @type boolean | undefined
+     * @description Routes describe the delivery journey from origin to destination.
+     * @type array | undefined
      */
-    readonly returns_enabled?: boolean;
+    routes?: DeliveryRoute[];
     /**
-     * @description Non-negative cost of returning the item, or items. Unit is cents.
-     * @type string | undefined, int64
+     * @description Supports lists features supported by this service.
      */
-    readonly return_cost?: string;
+    supports?: ServiceSupports;
     /**
-     * @description Indicates whether exchanges are enabled. See `exchange_cost` for the associated cost.
-     * @type boolean | undefined
+     * @description AvailableAddons are the add-ons that can be selected with this service.
+     * @type array | undefined
      */
-    readonly exchanges_enabled?: boolean;
+    availableAddons?: ServiceAddon[];
     /**
-     * @description Non-negative cost of exchanging the item, or items. Unit is cents.
-     * @type string | undefined, int64
+     * @description DefaultAddons are the add-ons included by default with this service.
+     * @type array | undefined
      */
-    readonly exchange_cost?: string;
+    defaultAddons?: ServiceAddon[];
     /**
-     * @description Time in days to return or exchange the item.
-     * @type integer | undefined, int32
+     * @description Meta carries carrier-specific metadata.
+     * @type object | undefined
      */
-    readonly return_time_days?: number;
+    meta?: object;
     /**
-     * @description Return Policy text suitable for presentation to the customer.
+     * @description ExternalMethodID is an external method identifier for merchant integrations.
      * @type string | undefined
      */
-    readonly return_policy_text?: string;
+    externalMethodId?: string;
     /**
-     * @description Return Policy URL, which is suitable for presentation to the customer.
-     * @type string | undefined
+     * @description Preselected indicates whether this service is pre-selected within\nits category. At most one service per category is preselected.
+     * @type boolean | undefined
      */
-    readonly return_policy_url?: string;
+    preselected?: boolean;
     /**
-     * @description Indicates if the return promise is unavailable due to API failures or other issues.\nWhen true, consider displaying a \"Return details unavailable\" message to the end user.
-     * @type boolean | undefined
+     * @description Token is an opaque token representing this delivery offer. Pass\nthis token in the `selections` array when creating an order to\nselect this service.\n\nThe token is a signed, self-contained payload that encodes the\noffered price, delivery details, and a hash of the request context\n(fulfillment groups + destination).\n\nThe token has a limited validity period. When `deliveryTime.expires`\nis set, the offer is valid until that timestamp; when it is not\nset, the offer is subject to the default validity window for the\ncarrier and may still be rejected with `offer-expired` at\norder-creation time.\n\nAt order creation time, the server validates the token\'s signature,\nexpiry, and that the submitted cart and destination match what was\noriginally offered.
+     * @type string
      */
-    readonly is_unavailable?: boolean;
-};
-
-declare type DeliveryService = {
-    getSession: DataResolver<GetDeliverySessionArgs, DeliverySession>;
+    token: string;
 };
 
 /**
- * @description A Session is the primary resource for handling the delivery options and the customer lifecycle.
+ * @description DeliveryTime is the window in which a delivery is expected to occur.
  */
-declare type DeliverySession = {
-    /**
-     * @type string | undefined
-     */
-    name?: string;
-    /**
-     * @description State defines the current state of the session.\n\n - STATE_UNSPECIFIED: Default value. This value is unused.\n - ACTIVE: Session is active and can be modified.\n - COMPLETED: Session is completed and can not be modified.
-     * @type string | undefined
-     */
-    state?: SessionState;
+declare type DeliveryTime = {
     /**
-     * @description Purchase describes purchase experience.
-     * @type object
-     */
-    purchase: SessionPurchase;
-    /**
-     * @description The deliveries included in this session.
-     * @type array
+     * @description Earliest expected delivery date/time. When the time component is\n00:00:00, only the date is promised.
+     * @type string, date-time
      */
-    deliveries: V1AlphaDeliveryDelivery[];
+    earliest: string;
     /**
-     * @description The timestamp when the session was created.
-     * @type string | undefined, date-time
+     * @description Latest expected delivery date/time. When the time component is\n00:00:00, only the date is promised.
+     * @type string, date-time
      */
-    readonly create_time?: string;
+    latest: string;
     /**
-     * @description The timestamp when the session was last updated.
+     * @description Expires is when this delivery time estimate expires and may need to be refreshed.
      * @type string | undefined, date-time
      */
-    readonly update_time?: string;
+    expires?: string;
     /**
-     * @description The current etag of the session.\nIf an etag is provided and does not match the current etag of the session,\nupdates and completion will be blocked and an ABORTED error will be returned.
+     * @description Formatted is a human-readable formatted delivery time for display,\npre-formatted according to locale and merchant preferences.
      * @type string | undefined
      */
-    etag?: string;
-    /**
-     * @description ReturnPromise contains promise for returns and exchanges for a user and a cart.
-     * @type object | undefined
-     */
-    returns_promise?: DeliveryReturnsPromise;
+    formatted?: string;
 };
 
+/**
+ * @description DeliveryType is the kind of delivery a service performs.
+ */
+declare type DeliveryType = DeliveryTypeEnum;
+
 /**
  * @description - UNKNOWN: Delivery type is not known for some reason\n - DELIVERY: Home delivery\n - PICKUP: Delivery to a service point or a locker\n - MAILBOX: Delivery to customer\'s mailbox\n - INSTORE: Delivery to one of the merchants stores\n - INWAREHOUSE: Delivery to the warehouse. This type is used with chain delivery in warehouse-warehouse-delivery/pickup.
  * @default UNKNOWN
  */
-declare type DeliveryType = DeliveryTypeEnum;
+declare type DeliveryType_2 = DeliveryTypeEnum_2;
+
+declare type DeliveryTypeEnum = 'delivery' | 'pickup' | 'mailbox' | 'instore';
 
-declare type DeliveryTypeEnum =
+declare type DeliveryTypeEnum_2 =
 | 'UNKNOWN'
 | 'DELIVERY'
 | 'PICKUP'
@@ -1669,13 +1258,29 @@ declare type DisplayItem = {
      */
     quantity?: number;
     /**
-     * @type string | undefined
+     * @type string | undefined
+     */
+    sku?: string;
+    /**
+     * @type integer | undefined, int32
+     */
+    total_price?: number;
+};
+
+/**
+ * @description DistanceDetail is a detailed distance measurement with optional\ntravel-time estimate.
+ */
+declare type DistanceDetail = {
+    /**
+     * @description Meters is the distance value in meters.
+     * @type integer, int32
      */
-    sku?: string;
+    meters: number;
     /**
+     * @description DurationMinutes is the estimated travel duration in minutes.
      * @type integer | undefined, int32
      */
-    total_price?: number;
+    durationMinutes?: number;
 };
 
 declare type EstimatedTime = {
@@ -1691,75 +1296,41 @@ declare type EstimatedTime = {
     latest?: string;
 };
 
-/**
- * @description Absolute represents an ETD as a single or pair of timestamps.
- */
-declare type ETDAbsolute = {
-    /**
-     * @description The earliest possible delivery time. If unspecified, delivery is considered to be immediate.
-     * @type string | undefined, date-time
-     */
-    earliest_time?: string;
-    /**
-     * @description The latest possible delivery time. If unspecified, there is no guaranteed maximum time.
-     * @type string | undefined, date-time
-     */
-    latest_time?: string;
-};
-
-/**
- * @description Custom represents an ETD in a human-readable text format.
- */
-declare type ETDCustom = {
-    /**
-     * @description Description in a text form, e.g., \"Before Christmas\", \"Same day if ordered before 2PM\".
-     * @type string
-     */
-    text: string;
-};
+declare type Event_2<T> = { payload: T };
 
 /**
- * @description Relative represents an ETD as a range of time units.
+ * Map of all events emitted by the Ingrid compound.
+ *
+ * | Event             | When it fires                                                         |
+ * | ----------------- | --------------------------------------------------------------------- |
+ * | `ready`           | Compound is mounted and interactive                                   |
+ * | `addressSubmit`   | Shopper confirms the address form                                     |
+ * | `countryChange`   | Shopper selects a different country                                   |
+ * | `selectionChange` | Shopper selects a delivery option                                     |
+ * | `error`           | An unhandled error occurs during mount or is caught by the compound's error boundary at runtime |
+ *
+ * @remarks
+ * The `error` event fires in two situations:
+ * - **Mount failure** — an error thrown while loading or initialising the compound.
+ * - **Runtime boundary** — an unhandled React error caught by the compound's top-level
+ *   error boundary. In this case the compound renders a generic fallback UI and remains
+ *   alive; the integrator can use this event to log or react to the failure.
+ *
+ * Event names and payload shapes may evolve before the stable release.
+ *
+ * @public
  */
-declare type ETDRelative = {
-    /**
-     * @description TimeUnit specifies the unit of time measurement for ETD.\n\n - TIME_UNIT_UNSPECIFIED: Default value. This value is unused.\n - TIME_UNIT_MINUTE: Minutes\n - TIME_UNIT_HOUR: Hours\n - TIME_UNIT_DAY: Calendar days\n - TIME_UNIT_BUSINESS_DAY: Business days (excluding weekends and holidays)\n - TIME_UNIT_WEEK: Calendar weeks\n - TIME_UNIT_MONTH: Calendar months
-     * @type string
-     */
-    unit: ETDTimeUnit;
-    /**
-     * @description The minimum number of time units. If unspecified, there is no lower bound.\nValue of zero means delivery within the same time unit period (e.g., same day if unit is DAY).
-     * @type integer | undefined, int32
-     */
-    earliest?: number;
+export declare type EventsMap = {
+    countryChange: (event: Event_2<{ country_code: string }>) => void;
+    addressSubmit: (event: Event_2<Partial<AddressContactEntry>>) => void;
     /**
-     * @description Maximum number of time units. If unspecified, there is no upper bound.\nValue of zero means delivery within the same time unit period (e.g., same day if unit is DAY).
-     * @type integer | undefined, int32
+     * Fires when the shopper selects a delivery option. `groupId`/`categoryId`
+     * identify the choice within the options response; `serviceToken` is the
+     * signed offer token to hand to the orchestrator for backend order creation.
      */
-    latest?: number;
-};
-
-/**
- * @description TimeUnit specifies the unit of time measurement for ETD.\n\n - TIME_UNIT_UNSPECIFIED: Default value. This value is unused.\n - TIME_UNIT_MINUTE: Minutes\n - TIME_UNIT_HOUR: Hours\n - TIME_UNIT_DAY: Calendar days\n - TIME_UNIT_BUSINESS_DAY: Business days (excluding weekends and holidays)\n - TIME_UNIT_WEEK: Calendar weeks\n - TIME_UNIT_MONTH: Calendar months
- * @default TIME_UNIT_UNSPECIFIED
- */
-declare type ETDTimeUnit = ETDTimeUnitEnum;
-
-declare type ETDTimeUnitEnum =
-| 'TIME_UNIT_UNSPECIFIED'
-| 'TIME_UNIT_MINUTE'
-| 'TIME_UNIT_HOUR'
-| 'TIME_UNIT_DAY'
-| 'TIME_UNIT_BUSINESS_DAY'
-| 'TIME_UNIT_WEEK'
-| 'TIME_UNIT_MONTH';
-
-declare type Event_2<T> = { payload: T };
-
-declare type EventsMap = {
-    countryChange: (event: Event_2<{ country_code: string }>) => void;
-    addressSubmit: (event: Event_2<AddressMoleculeInputState>) => void;
-    selectionChange: (event: Event_2<{ deliveryId: string; categoryId: string }>) => void;
+    selectionChange: (
+    event: Event_2<{ groupId: string; categoryId: string; serviceToken: string }>
+    ) => void;
     ready: () => void;
     error: (error: unknown) => void;
 };
@@ -1783,7 +1354,7 @@ declare type FormMeta = {
     /**
      * @description ISO 3166-1 alpha-2 country code for this form configuration.
      */
-    countryCode: CountryCode;
+    countryCode: CountryCode_2;
     /**
      * @description Text direction. `rtl` (Right-to-Left) is critical for\nlanguages like Arabic or Hebrew.
      */
@@ -1795,12 +1366,20 @@ declare type FormMeta = {
     language: string;
 };
 
+/**
+ * @description Selects which address form configuration to return.
+ */
+declare type FormType = FormTypeEnum;
+
+declare type FormTypeEnum = 'delivery' | 'billing';
+
 declare const freeShippingIndicatorMoleculeParamsValidator = z.object({
     name: z.string(),
     deliveryId: z.string().optional(),
     customization: z
     .object({
         showExhaustedLevelsMessage: z.boolean().optional(),
+        zeroPriceDisplay: z.enum(['free', '0']).optional(),
     })
     .optional(),
 }) satisfies z.ZodType<FreeShippingIndicatorParams>;
@@ -1810,25 +1389,10 @@ declare type FreeShippingIndicatorParams = {
     deliveryId?: string;
     customization?: {
         showExhaustedLevelsMessage?: boolean;
+        zeroPriceDisplay?: 'free' | '0';
     };
 };
 
-/**
- * @description Readiness specifies a time range when the goods will be ready for shipment.
- */
-declare type FulfillmentReadiness = {
-    /**
-     * @description The earliest timestamp when the goods will be ready for shipment.
-     * @type string, date-time
-     */
-    earliest_time: string;
-    /**
-     * @description The latest timestamp when the goods will be ready for shipment.\nIf not specified, the goods will be ready indefinitely after start_time.
-     * @type string | undefined, date-time
-     */
-    latest_time?: string;
-};
-
 /**
  * @description The request has succeeded.
  */
@@ -1899,7 +1463,7 @@ declare type GetAddressFormQueryParams = {
      * @pattern ^[A-Z]{2}$
      * @type string
      */
-    countryCode: CountryCode;
+    countryCode: CountryCode_2;
     /**
      * @description Site identifier, referring to which site the form configurations are related to.
      * @type string
@@ -1910,11 +1474,32 @@ declare type GetAddressFormQueryParams = {
      * @type string | undefined
      */
     postalCode?: string;
+    /**
+     * @description Selects which address form configuration to return.
+     * @type string | undefined
+     */
+    type?: FormType;
 };
 
-declare type GetDeliverySessionArgs = z.infer<typeof deliveryArgsSchema>;
-
-declare type GetTrackingDataArgs = z.infer<typeof trackingArgsSchema>;
+/**
+ * Arguments for fetching delivery options in the stateless model.
+ *
+ * The cart/fulfillment data lives in the immutable snapshot referenced by
+ * `deliveryCriteria` (created server-to-server via `POST /v1/delivery-criteria`).
+ * Only per-request inputs are passed here.
+ */
+declare type GetDeliveryOptionsArgs = {
+    /** Opaque reference to the immutable delivery-criteria snapshot. */
+    deliveryCriteria: string;
+    /** Destination address; resolved from the snapshot when omitted. */
+    destination?: DeliveryAddress;
+    /** Personalisation/analytics context, unrelated to the snapshot. */
+    context?: Context;
+} & SDKManagedTokenArg;
+
+declare type GetTrackingDataArgs =
+| ({ locale: Locale } & SDKManagedTokenArg)
+| { email: string; tos_id: string; locale: Locale };
 
 declare type GetTrackingDataResponse = {
     /**
@@ -1938,6 +1523,10 @@ declare type GetTrackingDataResponse = {
      * @type string
      */
     tos_id: string;
+    /**
+     * @type object | undefined
+     */
+    withdrawal?: Withdrawal;
 };
 
 declare type GetTrackingDataResponseOptions = {
@@ -1983,13 +1572,20 @@ declare const ingrid: {
 export default ingrid;
 
 /**
- * The compound instance returned by {@link ingrid.init}, used to control the lifecycle
+ * The compound instance returned by `ingrid.init`, used to control the lifecycle
  * of the rendered Ingrid experience.
  *
  * @public
  */
 export declare interface IngridCompound {
-    /** Mounts the Ingrid experience into the DOM element matching `containerSelector`. */
+    /**
+     * Mounts the Ingrid experience into the DOM element matching `containerSelector`.
+     *
+     * @param containerSelector - CSS selector for the container element to mount into.
+     * @param options - Optional mount options.
+     * @param options.signal - An `AbortSignal` to cancel the mount. If the signal fires before
+     *   the compound finishes loading, the mount is silently abandoned and no error is thrown.
+     */
     mount(containerSelector: string, options?: {
         signal?: AbortSignal;
     }): Promise<void>;
@@ -1998,9 +1594,11 @@ export declare interface IngridCompound {
     /** Updates runtime configuration of the mounted experience. */
     update(newConfig: Partial<UpdatableConfig>): void;
     /**
-     * Subscribes to an SDK event.
+     * Subscribes to an SDK event. See {@link EventsMap} for available events and their payloads.
      *
-     * @returns An unsubscribe function.
+     * @param event - The event name to subscribe to.
+     * @param callback - Called each time the event fires.
+     * @returns An unsubscribe function - call it to stop listening.
      */
     on<K extends keyof EventsMap>(event: K, callback: EventsMap[K]): () => boolean;
 }
@@ -2023,13 +1621,30 @@ export declare interface IngridCompound {
  * @public
  */
 export declare interface IngridInitParams {
-    /** Authentication token for the Ingrid API. */
-    token: string;
-    /** Optional function to refresh the authentication token when it expires. */
-    refreshToken?: () => Promise<{
-        accessToken: string;
-        expiresAt: number;
-    }>;
+    /** Initial token for Ingrid built-in providers. */
+    token?: string;
+    /**
+     * Optional callback for short-lived Ingrid API tokens, which are preferred.
+     * Call your backend to fetch and return a fresh Ingrid API token along with its expiration timestamp: `{ accessToken, expiresAt }`.
+     */
+    refreshToken?: () => Promise<TokenRefreshResult>;
+    /**
+     * Callback that returns a fresh delivery-context reference (the opaque
+     * `deliveryCriteria` snapshot your backend creates via
+     * `POST /v1/delivery-criteria`). Required for the delivery molecule.
+     *
+     * The SDK calls this to bootstrap the delivery flow and again to transparently
+     * recover when a reference expires or is superseded.
+     *
+     * @example
+     * ```ts
+     * deliveryContextProvider: async () => {
+     *   const { deliveryContextReference } = await myBackend.getIngridDeliveryContext();
+     *   return deliveryContextReference;
+     * }
+     * ```
+     */
+    deliveryContextProvider?: () => Promise<string>;
     /** Ingrid site identifier. */
     siteId: string;
     /** The locale to use for the experience. */
@@ -2062,12 +1677,22 @@ export declare interface IngridInitParams {
 export declare interface IngridInstance {
     /** The compound instance used to mount, unmount, and update the Ingrid experience. */
     compound: IngridCompound;
-    /** Updates the active locale for the experience. */
+    /**
+     * Updates the active locale for the experience.
+     * If the locale is not supported, falls back to `'en-US'`.
+     */
     setLocale(locale: Locale): void;
     /** Updates the active purchase country code. */
     setPurchaseCountry(countryCode: string): void;
     /** Updates the active currency. */
     setCurrency(currency: string): void;
+    /**
+     * Pre-emptively sets the current delivery-context reference (e.g. after the
+     * cart changes and your backend issues a fresh `deliveryCriteria`). The
+     * delivery molecule discards stale options and refetches with the new
+     * reference.
+     */
+    setDeliveryContext(reference: string): void;
     /* Excluded from this release type: __internal */
 }
 
@@ -2147,17 +1772,9 @@ declare type ItemVariant = {
 };
 
 /**
- * @description LabelType defines the type of label.\n\n - LABEL_TYPE_UNKNOWN: Label type is unknown.\n - LABEL_TYPE_SUSTAINABILITY: A sustainability-related label.\n - LABEL_TYPE_PRIORITY: A priority delivery label.\n - LABEL_TYPE_CUSTOM: A custom label defined by the merchant.\n - LABEL_TYPE_SWAN: A Nordic Swan eco-label.
- * @default LABEL_TYPE_UNKNOWN
+ * @description Latitude is in decimal degrees (WGS 84) and ranges from -90 to 90.
  */
-declare type LabelLabelType = LabelLabelTypeEnum;
-
-declare type LabelLabelTypeEnum =
-| 'LABEL_TYPE_UNKNOWN'
-| 'LABEL_TYPE_SUSTAINABILITY'
-| 'LABEL_TYPE_PRIORITY'
-| 'LABEL_TYPE_CUSTOM'
-| 'LABEL_TYPE_SWAN';
+declare type Latitude = number;
 
 declare type LineItem = {
     /**
@@ -2207,34 +1824,98 @@ declare type LineItem = {
 };
 
 /**
- * @description Represents the dimensions of the item.
+ * Arguments for searching pickup locations for a given location-based product.
+ * Pickup locations are not embedded in the options response; they are fetched
+ * lazily here using the selected service's `product.id`.
+ */
+declare type ListLocationsArgs = {
+    /** Opaque reference to the immutable delivery-criteria snapshot. */
+    deliveryCriteria: string;
+    /** The carrier product to look up locations for (`DeliveryService.product.id`). */
+    productId: string;
+    /** Area to search around; resolved from the snapshot destination when omitted. */
+    address?: Address;
+    /** Optional coordinates to sort results by distance from. */
+    latitude?: number;
+    longitude?: number;
+    /** Max number of locations to return (defaults to 10, capped at 20). */
+    limit?: number;
+    /** Personalisation/analytics context, unrelated to the snapshot. */
+    context?: Context;
+} & SDKManagedTokenArg;
+
+/**
+ * @description ListLocationsResponse is the response containing pickup locations\nmatching the request.\n\nThe `for*` fields echo back the resolved request inputs (with snapshot\ndefaults applied) so the caller can see exactly which product, address,\nand reference point produced the listed locations.
  */
-declare type LineItemDimensions = {
+declare type ListLocationsResponse = {
     /**
-     * @description Height of the item in millimeters, must be greater than 0.
-     * @type integer, int32
+     * @description ForProductID is the carrier product the locations are listed for.
+     * @type string
      */
-    height: number;
+    forProductId: string;
     /**
-     * @description Length of the item in millimeters, must be greater than 0.
-     * @type integer, int32
+     * @description ForAddress is the address the locations are listed for, after applying snapshot defaults.
      */
-    length: number;
+    forAddress: Address;
     /**
-     * @description Width of the item in millimeters, must be greater than 0.
-     * @type integer, int32
+     * @description ForLatitude is the latitude used for distance-based sorting, when supplied.
      */
-    width: number;
+    forLatitude?: Latitude;
+    /**
+     * @description ForLongitude is the longitude used for distance-based sorting, when supplied.
+     */
+    forLongitude?: Longitude;
+    /**
+     * @description Locations matching the request, ordered by distance from the\nreference point when one was supplied. May be empty if no\nlocations match.
+     * @type array
+     */
+    locations: Location_2[];
 };
 
 declare type Locale = 'en-US' | 'pl-PL' | 'sv-SE';
 
+/**
+ * @description Location is a pickup point (service point, locker, store, etc.) where\nparcels can be collected.
+ */
 declare type Location_2 = {
+    /**
+     * @description ID is the unique identifier for this location.
+     * @type string
+     */
+    id: string;
+    /**
+     * @description Name is the display name of the location.
+     * @type string
+     */
+    name: string;
+    /**
+     * @description Distance from the reference point (the customer\'s address or\ncoordinates supplied in the request) to this location. Only\npopulated when a reference point was supplied.
+     */
+    distance?: LocationDistance;
+    /**
+     * @description Address is the physical address of the location.
+     */
+    address: Address;
+    /**
+     * @description Coordinates are the geographic coordinates of the location.
+     */
+    coordinates?: Coordinates;
+    /**
+     * @description LocationType is the kind of pickup location.
+     */
+    locationType?: LocationType;
+    /**
+     * @description OperationalHours are the operating hours for each day of the week.
+     */
+    operationalHours?: OperationalHours;
+};
+
+declare type Location_3 = {
     /**
      * @description Common address entity that used almost everywhere in Ingrid\'s API.
      * @type object
      */
-    address: Address;
+    address: Address_2;
     /**
      * @description location_external_id - external identifier for the location.
      * @type string | undefined
@@ -2248,7 +1929,7 @@ declare type Location_2 = {
     /**
      * @type object | undefined
      */
-    operational_hours?: OperationalHours;
+    operational_hours?: OperationalHours_2;
     /**
      * @description pickup_instructions - instructions for the customer to pick up the parcel.
      * @type string | undefined
@@ -2257,43 +1938,32 @@ declare type Location_2 = {
 };
 
 /**
- * @description To reference an existing location.
+ * @description LocationDistance is the distance from a reference point to a location.\nAt least one mode of travel is populated when a reference point is\nsupplied.
  */
-declare type LocationByRef = {
+declare type LocationDistance = {
     /**
-     * @description External identifier provided by the merchant or carrier.
-     * @type string
+     * @description Walking distance and estimated duration.
      */
-    external_id: string;
+    walking?: DistanceDetail;
+    /**
+     * @description Driving distance and estimated duration.
+     */
+    driving?: DistanceDetail;
 };
 
 /**
- * @description To provide full information about the location.
+ * @description LocationType classifies a pickup location.
  */
-declare type LocationByValue = {
-    /**
-     * @description External identifier provided by the merchant or carrier.
-     * @type string
-     */
-    external_id: string;
-    /**
-     * @description Contact represents generic contact information.
-     * @type object
-     */
-    delivery_contact: V1AlphaDeliveryContact;
-    /**
-     * @description Contact represents generic contact information.
-     * @type object | undefined
-     */
-    visiting_contact?: V1AlphaDeliveryContact;
-    /**
-     * @description Location name that is displayed to the customer.
-     * @type string | undefined
-     */
-    display_name?: string;
-};
+declare type LocationType = LocationTypeEnum;
+
+declare type LocationTypeEnum = 'manned' | 'locker' | 'post_office' | 'store';
 
-declare type MethodOverrides<T> = {
+/**
+ * @description Longitude is in decimal degrees (WGS 84) and ranges from -180 to 180.
+ */
+declare type Longitude = number;
+
+export declare type MethodOverrides<T> = {
     [K in keyof T]?: T[K] extends (...args: any[]) => any ? T[K] | WithDefaultProvider<T[K]> : never;
 };
 
@@ -2331,7 +2001,46 @@ declare type MoleculesConfig = {
 
 declare type MoleculeType = keyof MoleculeMapType;
 
+/**
+ * @description OperationalHours are the operating hours for a location, organised by\nday of the week.\n\nEach day field contains a free-form, human-readable representation of\nthe day\'s hours. Common forms:\n\n- A single window: `\"08:00-20:00\"`\n- Multiple windows separated by commas: `\"08:00-12:00, 13:00-18:00\"`\n- Closed: `\"closed\"`\n- Open all day: `\"24h\"` or `\"00:00-24:00\"`\n\nIf structured per-day data is not available from the carrier, populate\n`freeText` instead and leave the per-day fields empty. Times are\nexpressed in the location\'s local timezone.
+ */
 declare type OperationalHours = {
+    /**
+     * @type string | undefined
+     */
+    monday?: string;
+    /**
+     * @type string | undefined
+     */
+    tuesday?: string;
+    /**
+     * @type string | undefined
+     */
+    wednesday?: string;
+    /**
+     * @type string | undefined
+     */
+    thursday?: string;
+    /**
+     * @type string | undefined
+     */
+    friday?: string;
+    /**
+     * @type string | undefined
+     */
+    saturday?: string;
+    /**
+     * @type string | undefined
+     */
+    sunday?: string;
+    /**
+     * @description FreeText holds free-text operational hours when structured data is\nnot available. Used as a fallback when hours cannot be parsed into a\nday-by-day format.
+     * @type array | undefined
+     */
+    freeText?: string[];
+};
+
+declare type OperationalHours_2 = {
     /**
      * @type array | undefined
      */
@@ -2524,7 +2233,7 @@ declare type Parcel = {
      * @description - UNKNOWN: Delivery type is not known for some reason\n - DELIVERY: Home delivery\n - PICKUP: Delivery to a service point or a locker\n - MAILBOX: Delivery to customer\'s mailbox\n - INSTORE: Delivery to one of the merchants stores\n - INWAREHOUSE: Delivery to the warehouse. This type is used with chain delivery in warehouse-warehouse-delivery/pickup.
      * @type string | undefined
      */
-    delivery_type?: DeliveryType;
+    delivery_type?: DeliveryType_2;
     /**
      * @description Indicates intended direction of parcel, shipment etc.\n\n - OUTBOUND: From merchant to customer.\n - RETURN: Return from customer to merchant.\n - UNSPECIFIED: Unspecified means we do not know the direction. It is the default state when we do not know any better.
      * @type string | undefined
@@ -2554,7 +2263,7 @@ declare type Parcel = {
     /**
      * @type object | undefined
      */
-    location?: Location_2;
+    location?: Location_3;
     /**
      * @type array | undefined
      */
@@ -2579,97 +2288,6 @@ declare type Parcel = {
     tracking_number?: string;
 };
 
-/**
- * @description Distances define the walking and driving distances to the pickup location.
- */
-declare type PickupLocationDistances = {
-    /**
-     * @description Represents a distance measurement with both spatial distance and estimated travel time.
-     * @type object | undefined
-     */
-    walking?: DeliveryDistance;
-    /**
-     * @description Represents a distance measurement with both spatial distance and estimated travel time.
-     * @type object | undefined
-     */
-    driving?: DeliveryDistance;
-};
-
-/**
- * @description LocationType defines the type of the pickup location.\n\n - LOCATION_TYPE_UNSPECIFIED: Unspecified type.\n - LOCKER: A locker pickup location.\n - STORE: A store pickup location.\n - POSTOFFICE: A post office pickup location.\n - MANNED: A manned pickup location, e.g., staffed desk.
- * @default LOCATION_TYPE_UNSPECIFIED
- */
-declare type PickupLocationLocationType = PickupLocationLocationTypeEnum;
-
-declare type PickupLocationLocationTypeEnum =
-| 'LOCATION_TYPE_UNSPECIFIED'
-| 'LOCKER'
-| 'STORE'
-| 'POSTOFFICE'
-| 'MANNED';
-
-/**
- * @description OperationalHours define when the pickup location is operating.
- */
-declare type PickupLocationOperationalHours = {
-    /**
-     * @description Opening hours for Monday.
-     * @type array | undefined
-     */
-    monday?: string[];
-    /**
-     * @description Opening hours for Tuesday.
-     * @type array | undefined
-     */
-    tuesday?: string[];
-    /**
-     * @description Opening hours for Wednesday.
-     * @type array | undefined
-     */
-    wednesday?: string[];
-    /**
-     * @description Opening hours for Thursday.
-     * @type array | undefined
-     */
-    thursday?: string[];
-    /**
-     * @description Opening hours for Friday.
-     * @type array | undefined
-     */
-    friday?: string[];
-    /**
-     * @description Opening hours for Saturday.
-     * @type array | undefined
-     */
-    saturday?: string[];
-    /**
-     * @description Opening hours for Sunday.
-     * @type array | undefined
-     */
-    sunday?: string[];
-    /**
-     * @description Free-text operational hours for fallback.
-     * @type array | undefined
-     */
-    free_text?: string[];
-};
-
-/**
- * @description Section provides extra information about the pickup location.
- */
-declare type PickupLocationSection = {
-    /**
-     * @description The title of the section displayed to the customer.
-     * @type string
-     */
-    title: string;
-    /**
-     * @description The columns of items in the section.
-     * @type array
-     */
-    columns: SectionColumn[];
-};
-
 /**
  * @description - UNKNOWN_PICKUP_LOCATION_TYPE: Location type is not known for some reason\n - LOCKER: Locker location type. Example Instabox or a DHL locker\n - STORE: Can be a merchant\'s store or any other store that handles logistics\n - POSTOFFICE: Postal office\n - MANNED: A manned service point\n - AGE_VERIFICATION: Location that supports age verification (age check)
  * @default UNKNOWN_PICKUP_LOCATION_TYPE
@@ -2732,29 +2350,65 @@ declare type PredictionType = PredictionTypeEnum;
 
 declare type PredictionTypeEnum = 'streetAddress' | 'postalCode' | 'locality' | 'premise' | 'street';
 
-declare type PriceLevelsPriceLevel = {
+/**
+ * @description Price is a monetary amount in a specific currency, expressed in minor units.
+ */
+declare type Price = {
     /**
-     * @description Indicates if this price level is active.
-     * @type boolean | undefined
+     * @description Amount is the price in minor currency units (e.g. öre for SEK, cents\nfor USD). For example, `12500` represents `125.00 SEK` when\n`currency` is `SEK`.
+     * @type integer, int32
      */
-    active?: boolean;
+    amount: number;
     /**
-     * @description Indicates if this is the base price.
-     * @type boolean | undefined
+     * @description Currency is the ISO 4217 currency code.
+     */
+    currency: Currency;
+};
+
+/**
+ * @description PriceComponent is one component of a service\'s total price.\n\n`type` is the categorical kind of the component (machine-readable enum),\nwhile `id` is a stable identifier for this specific component within the\nservice. The same `type` may appear multiple times with different `id`s\n(e.g. two add-ons of type `addon`).
+ */
+declare type PriceComponent = {
+    /**
+     * @description ID is a stable identifier for this component within the service.\nDistinct from `type` — two components may share a `type` but always\nhave distinct `id`s.
+     * @type string
      */
-    base?: boolean;
+    id: string;
     /**
-     * @description The activation price for this level.\nUnit is the smallest currency unit, e.g., cents for USD, yen for JPY.
-     * @type string | undefined, int64
+     * @description Type is the categorical kind of price component.
      */
-    activation_price?: string;
+    type: PriceComponentType;
     /**
-     * @description The delivery price for this level.\nUnit is the smallest currency unit, e.g., cents for USD, yen for JPY.
-     * @type string | undefined, int64
+     * @description Amount for this component in minor currency units. Components sum to the parent `ServicePrice.amount`.
+     * @type integer, int32
+     */
+    amount: number;
+    /**
+     * @description NetAmount is the net amount before tax, in minor currency units.
+     * @type integer | undefined, int32
+     */
+    netAmount?: number;
+    /**
+     * @description TaxRate is the tax rate expressed as a decimal fraction in the range [0, 1].
+     * @minLength 0
+     * @maxLength 1
+     * @type number | undefined, float
+     */
+    taxRate?: number;
+    /**
+     * @description TaxAmount is the tax amount in minor currency units.
+     * @type integer | undefined, int32
      */
-    delivery_price?: string;
+    taxAmount?: number;
 };
 
+/**
+ * @description PriceComponentType classifies a price component.
+ */
+declare type PriceComponentType = PriceComponentTypeEnum;
+
+declare type PriceComponentTypeEnum = 'shipping' | 'addon' | 'discount' | 'surcharge';
+
 declare type ProgressItem = {
     /**
      * @description Provides a date interval. Depending on a case, `start` and `end` parts are not guaranteed to be present.
@@ -2883,14 +2537,21 @@ declare type RawTranslationKey =
 | 'delivery.courier_instructions.edit'
 | 'delivery.courier_instructions.remove'
 | 'delivery.courier_instructions.save'
+| 'delivery.filter_option.delivery'
+| 'delivery.filter_option.instore'
+| 'delivery.filter_option.mailbox'
+| 'delivery.filter_option.pickup'
 | 'delivery.fsi_levels_exhausted'
 | 'delivery.fsi_progress_bar_label'
-| 'delivery.fsi_remaining.DELIVERY'
-| 'delivery.fsi_remaining.DELIVERY_TYPE_UNSPECIFIED'
-| 'delivery.fsi_remaining.INSTORE'
-| 'delivery.fsi_remaining.MAILBOX'
-| 'delivery.fsi_remaining.PICKUP'
+| 'delivery.fsi_remaining.delivery'
+| 'delivery.fsi_remaining.instore'
+| 'delivery.fsi_remaining.mailbox'
+| 'delivery.fsi_remaining.pickup'
 | 'delivery.hide_details'
+| 'delivery.location.type.locker'
+| 'delivery.location.type.manned'
+| 'delivery.location.type.post_office'
+| 'delivery.location.type.store'
 | 'delivery.select_carrier'
 | 'delivery.show_details'
 | 'global.add_services'
@@ -2911,8 +2572,8 @@ declare type RawTranslationKey =
 | 'global.loading'
 | 'global.pickup_locations'
 | 'global.postal_code'
-| 'global.save_my_choice'
-| 'global.select_pickup_location'
+| 'global.save'
+| 'global.select_location'
 | 'global.show'
 | 'global.show_available_services'
 | 'global.validation.invalid'
@@ -2964,10 +2625,70 @@ declare type RawTranslationKey =
 
 declare type RecursiveObjectValues<T> = T extends object ? RecursiveObjectValues<T[keyof T]> : T;
 
+/**
+ * @description RouteLeg is a single leg in a delivery route.
+ */
+declare type RouteLeg = {
+    /**
+     * @description Sequence is the order of this leg in the route (1-based, unique within a route).
+     * @minLength 1
+     * @type integer, int32
+     */
+    sequence: number;
+    /**
+     * @description ShippingMethod is the carrier-specific shipping method used for this\nleg, in the `<carrier>-<product>` form. Independent from the\ntop-level `DeliveryService.product.id` because a service may chain\nmultiple shipping methods across legs.
+     * @type string
+     */
+    shippingMethod: string;
+    /**
+     * @description DeliveryType is the kind of delivery for this leg.
+     */
+    deliveryType: DeliveryType;
+    /**
+     * @description From is the origin of this leg.
+     */
+    from: RouteLocation;
+    /**
+     * @description To is the destination of this leg.
+     */
+    to: RouteLocation;
+};
+
+/**
+ * @description RouteLocation is one endpoint of a route leg.
+ */
+declare type RouteLocation = {
+    /**
+     * @description Type is the kind of location.
+     */
+    type: RouteLocationType;
+    /**
+     * @description Address of the location. Optional for warehouse/home which are known from context.
+     */
+    address?: Address;
+    /**
+     * @description ExternalID is an external identifier (e.g. service-point ID, store ID).
+     * @type string | undefined
+     */
+    externalId?: string;
+};
+
+/**
+ * @description RouteLocationType classifies a location in a delivery route.
+ */
+declare type RouteLocationType = RouteLocationTypeEnum;
+
+declare type RouteLocationTypeEnum = 'warehouse' | 'store' | 'home' | 'pickup' | 'hub';
+
 declare interface SDKInternal {
     readonly [_internalBrand]: never;
 }
 
+declare type SDKManagedTokenArg = {
+    /** @deprecated This is an internal SDK-managed token for builtin providers. Do not rely on this directly. Custom providers should implement their own authentication mechanism if needed.*/
+    token?: string;
+};
+
 /**
  * @description Response containing a list of address predictions from the autocomplete endpoint.
  */
@@ -2980,40 +2701,95 @@ declare type SearchAddressesResponse = {
 };
 
 /**
- * @description Column contains a list of items displayed in a single section column.
+ * @description ServiceAddon is an add-on service that can be selected with a delivery.
  */
-declare type SectionColumn = {
+declare type ServiceAddon = {
     /**
-     * @description The items within the column.
-     * @type array
+     * @description ID is the unique identifier for this add-on.
+     * @type string
+     */
+    id: string;
+    /**
+     * @description Name is the display name of the add-on.
+     * @type string
+     */
+    name: string;
+    /**
+     * @description Description is a description of the add-on.
+     * @type string | undefined
      */
-    items: SectionItem[];
+    description?: string;
+    /**
+     * @description Price for this add-on.
+     */
+    price?: Price;
+    /**
+     * @description ExternalID is an external identifier for merchant integrations.
+     * @type string | undefined
+     */
+    externalId?: string;
+    /**
+     * @description Type is the kind of add-on.
+     */
+    type?: AddonType;
+    /**
+     * @description Selected indicates whether this add-on is currently selected.
+     * @type boolean | undefined
+     */
+    selected?: boolean;
 };
 
 /**
- * @description Item represents a single piece of information in a section.
+ * @description ServicePrice is the pricing information for a delivery service.
  */
-declare type SectionItem = {
+declare type ServicePrice = {
     /**
-     * @description The URI for the item\'s icon.
-     * @type string | undefined
+     * @description Amount is the total price for this delivery option in minor currency units (e.g. cents/öre).
+     * @type integer, int32
      */
-    icon_uri?: string;
+    amount: number;
     /**
-     * @description The text description of the item.
-     * @type string | undefined
+     * @description Currency is the ISO 4217 currency code.
+     */
+    currency: Currency;
+    /**
+     * @description NetAmount is the net price before tax, in minor currency units. Populated when tax is applicable.
+     * @type integer | undefined, int32
+     */
+    netAmount?: number;
+    /**
+     * @description TaxRate is the tax rate expressed as a decimal fraction in the range\n[0, 1]. For example, `0.25` represents 25% VAT.
+     * @minLength 0
+     * @maxLength 1
+     * @type number | undefined, float
+     */
+    taxRate?: number;
+    /**
+     * @description TaxAmount is the tax amount in minor currency units. Equals `amount - netAmount` when both are populated.
+     * @type integer | undefined, int32
+     */
+    taxAmount?: number;
+    /**
+     * @description Components is the breakdown of the parts that make up `amount`\n(shipping, add-ons, surcharges, discounts). When populated, the\ncomponents sum to `amount`.
+     * @type array | undefined
      */
-    text?: string;
+    components?: PriceComponent[];
     /**
-     * @description The URI for a link associated with the item.
+     * @description Formatted is a human-readable formatted price for display.
      * @type string | undefined
      */
-    link_uri?: string;
+    formatted?: string;
+    /**
+     * @description IsFromPrice indicates whether this is a \"from\" price (the actual price may vary).
+     * @type boolean | undefined
+     */
+    isFromPrice?: boolean;
 };
 
 declare type Services = {
     delivery: {
-        getSession: DeliveryService['getSession'];
+        getDeliveryOptions: DeliveryService['getDeliveryOptions'];
+        listLocations: DeliveryService['listLocations'];
     };
     tracking: {
         getTrackingData: TrackingService['getTrackingData'];
@@ -3029,7 +2805,6 @@ declare type Services = {
      * ```ts
      * const entries = await services.address.listContactBookEntries({
      *   params: { addressBookId: 'book_123' },
-     *   token: authToken,
      * });
      * ```
      */
@@ -3053,54 +2828,44 @@ declare type Services = {
     };
 };
 
+/**
+ * Per-domain overrides for the SDK's internal data-fetching services.
+ * Each key maps to a domain (e.g. `address`), and each value is a partial map of
+ * method overrides for that domain. Supply a plain function to replace the default
+ * implementation entirely, or use {@link withDefaultProvider} to wrap it.
+ *
+ * @public
+ */
 export declare type ServicesOverrides = {
     [Domain in keyof Services]?: MethodOverrides<Services[Domain]>;
 };
 
 /**
- * @description Purchase describes purchase experience.
+ * @description ServiceSupports describes which optional inputs and capabilities a\ndelivery service accepts at order-creation time.\n\nA flag set to `false` (or omitted) means the corresponding input is\nignored if supplied.
  */
-declare type SessionPurchase = {
+declare type ServiceSupports = {
     /**
-     * @description \nThe country code where the delivery will occur (ISO 3166-1 alpha-2).
-     * @type string
-     */
-    country_code: string;
-    /**
-     * @description The currency code for the transaction (ISO 4217).
-     * @type string
-     */
-    currency_code: string;
-    /**
-     * @description The total discount applied to the purchase (non-negative, in cents).
-     * @type string | undefined, int64
+     * @description Search indicates whether location search is available — i.e. the\ncaller can list alternative pickup locations via\n`POST /v1/delivery/locations` and override the preselected one in\nthe order\'s `selections[].locationId`.
+     * @type boolean | undefined
      */
-    total_discount?: string;
+    search?: boolean;
     /**
-     * @description The total value of the purchase after discounts are applied (non-negative, in cents).
-     * @type string | undefined, int64
+     * @description DoorCode indicates whether a door code can be supplied via `selections[].doorCode`.
+     * @type boolean | undefined
      */
-    total_value?: string;
+    doorCode?: boolean;
     /**
-     * @description List of vouchers.
-     * @type array | undefined
+     * @description CourierInstructions indicates whether free-text courier instructions\ncan be supplied via `selections[].courierInstructions`.
+     * @type boolean | undefined
      */
-    vouchers?: string[];
+    courierInstructions?: boolean;
     /**
-     * @description Locales list defined as lc-CC compliant with ISO 3166-1, in order of preference(first supported one will be chosen).
-     * @type array | undefined
+     * @description CustomerNumber indicates whether a customer number is required or supported by the carrier (e.g. DHL lockers).
+     * @type boolean | undefined
      */
-    locales?: string[];
+    customerNumber?: boolean;
 };
 
-/**
- * @description State defines the current state of the session.\n\n - STATE_UNSPECIFIED: Default value. This value is unused.\n - ACTIVE: Session is active and can be modified.\n - COMPLETED: Session is completed and can not be modified.
- * @default STATE_UNSPECIFIED
- */
-declare type SessionState = SessionStateEnum;
-
-declare type SessionStateEnum = 'STATE_UNSPECIFIED' | 'ACTIVE' | 'COMPLETED';
-
 /**
  * @default STEP_UNKNOWN
  */
@@ -3137,10 +2902,52 @@ declare type TextDirectionEnum = 'ltr' | 'rtl';
 
 declare type ThemeCssVariables = `--${RecursiveObjectValues<typeof variableNames>}`;
 
-declare const trackingArgsSchema = z.union([
-z.object({ token: z.string(), locale: z.enum(localeList) }),
-z.object({ email: z.string(), tos_id: z.string(), locale: z.enum(localeList) }),
-]);
+/**
+ * @description TimeSlot is a selectable window for a scheduled delivery.
+ */
+declare type TimeSlot = {
+    /**
+     * @description ID is the unique identifier for this time slot. Use this when selecting a specific delivery window.
+     * @type string
+     */
+    id: string;
+    /**
+     * @description Start is the start of the delivery window.
+     * @type string, date-time
+     */
+    start: string;
+    /**
+     * @description End is the end of the delivery window.
+     * @type string, date-time
+     */
+    end: string;
+    /**
+     * @description Expires is when this time slot expires and is no longer bookable.
+     * @type string | undefined, date-time
+     */
+    expires?: string;
+    /**
+     * @description Formatted is a human-readable formatted time slot for display.
+     * @type string | undefined
+     */
+    formatted?: string;
+    /**
+     * @description AdditionalPrice is an additional price for selecting this time slot (if different from the base price).
+     */
+    additionalPrice?: Price;
+};
+
+/** Value returned by the SDK `refreshToken` callback. */
+declare type TokenRefreshResult = {
+    /** Fresh short-lived Ingrid API token. */
+    accessToken: string;
+    /**
+     * Expiry time for `accessToken` as a Unix epoch timestamp in milliseconds.
+     * The SDK uses this to refresh auth before expiry. If the value is stale,
+     * invalid, or affected by clock skew, the SDK refreshes reactively on 401 response.
+     */
+    expiresAt: number;
+};
 
 declare type TrackingData = GetTrackingDataResponse;
 
@@ -3169,132 +2976,40 @@ declare type TranslationsService = {
     ) => void;
 };
 
-/** @public */
-declare interface UpdatableConfig {
+/**
+ * Runtime configuration that can be updated on a mounted compound via {@link IngridCompound.update}.
+ *
+ * @public
+ */
+export declare interface UpdatableConfig {
+    /** Design token overrides to apply to the rendered experience without remounting. */
     styles?: StyleTokens;
 }
 
 /**
- * @description Represents an address suitable for delivery.
+ * @description User describes the end user the request is being made on behalf of.
  */
-declare type V1AlphaDeliveryAddress = {
+declare type User = {
     /**
-     * @description \nRefers to a ISO-3166 alpha 2 country code.
+     * @description ExternalRef is the merchant\'s reference for this user (e.g. customer ID).
      * @type string
      */
-    country_code: string;
+    externalRef: string;
     /**
-     * @description Refers to a first-level administrative subdivision code (ISO-3166-2) without the country_code prefix.\nExample: region for Washington, D.C. = `DC` (from `US-DC`).\nException: for some countries (e.g. Mexico, Hong Kong) the subdivision name is used instead.\nExample: region for Hong Kong = `Kowloon`.
+     * @description Name is the full name of the user.
      * @type string | undefined
      */
-    region_code?: string;
-    /**
-     * @description Refers to a postal code or zipcode.
-     * @type string | undefined
-     */
-    postal_code?: string;
-    /**
-     * @description Refers to a city, postal_town or locality.
-     * @type string | undefined
-     */
-    city?: string;
-    /**
-     * @description List of strings, each a part of the address, e.g., street name, street number, building name, floor.
-     * @type array | undefined
-     */
-    address_lines?: string[];
-    /**
-     * @description Represents a latitude/longitude pair.\nUnless specified otherwise, this must conform to the WGS84 standard.\nValues must be within normalized ranges.
-     * @type object | undefined
-     */
-    coordinates?: DeliveryCoordinates;
-};
-
-/**
- * @description Contact represents generic contact information.
- */
-declare type V1AlphaDeliveryContact = {
-    /**
-     * @description Represents an address suitable for delivery.
-     * @type object
-     */
-    address: V1AlphaDeliveryAddress;
+    name?: string;
     /**
-     * @description The email address of the contact.
+     * @description Email is the email address of the user.
      * @type string | undefined
      */
     email?: string;
     /**
-     * @description A phone number, including region and optional extension.
-     * @type object | undefined
-     */
-    phone_number?: ContactPhoneNumber;
-    /**
-     * @description The given name of the recipient.\nUses AIP-148 terminology; prefer given_name over first_name as the given name\nis not placed first in many cultures.\nIf the integrator cannot differentiate between given and family name,\nthe entire name may be supplied in this field.
-     * @type string | undefined
-     */
-    given_name?: string;
-    /**
-     * @description The family name of the recipient.\nUses AIP-148 terminology; prefer family_name over last_name as the family name\nis not placed last in many cultures.
-     * @type string | undefined
-     */
-    family_name?: string;
-    /**
-     * @description The company name of the recipient.
+     * @description Phone is the phone number of the user, including country code (E.164 format recommended).
      * @type string | undefined
      */
-    company_name?: string;
-};
-
-/**
- * @description The delivery represents a single delivery of goods to a recipient.\nIt includes information about the goods, the recipient details, the fulfillment methods and the delivery options.
- */
-declare type V1AlphaDeliveryDelivery = {
-    /**
-     * @description The unique identifier of a delivery.
-     * @type string
-     */
-    id: string;
-    /**
-     * @description The goods that are to be delivered.
-     * @type array
-     */
-    line_items: DeliveryLineItem[];
-    /**
-     * @description The available fulfillments for the delivery.\nIn the future this will be deprecated in favour of `nodes`.
-     * @type array
-     */
-    fulfillments: DeliveryFulfillment[];
-    /**
-     * @description Contact represents generic contact information.
-     * @type object
-     */
-    recipient_contact: V1AlphaDeliveryContact;
-    /**
-     * @description Used to control the behaviour of the filter/price rules.\nEquivalent of cart_attributes in the `Delivery Checkout` API.
-     * @type array | undefined
-     */
-    attributes?: string[];
-    /**
-     * @description The available delivery categories for this delivery.
-     * @type array | undefined
-     */
-    readonly delivery_categories?: DeliveryDeliveryCategory[];
-    /**
-     * @description ID of the TOS, only present for the session `complete` and `get` calls.
-     * @type string | undefined
-     */
-    readonly tos_id?: string;
-    /**
-     * @description ID assigned by the merchant to a specific delivery.\nOnly present for the session `complete` and `get` calls.\nUsed as external ID of the TOS.
-     * @type string | undefined
-     */
-    readonly external_id?: string;
-    /**
-     * @description List of nodes that take part in the delivery.
-     * @type array | undefined
-     */
-    nodes?: DeliveryDeliveryNode[];
+    phone?: string;
 };
 
 /**
@@ -3332,7 +3047,7 @@ declare type ValidateAddressRequest = {
     /**
      * @description The address to validate against postal reference data.
      */
-    address: Address_2;
+    address: Address_3;
 };
 
 /**
@@ -3361,7 +3076,7 @@ declare type ValidationResult = {
     /**
      * @description The standardized, corrected address.\nPresent if `status` is `valid` or `suspect`. Absent if `invalid`.
      */
-    candidate?: Address_2;
+    candidate?: Address_3;
     /**
      * @description Metadata about the quality of the match.
      */
@@ -3637,7 +3352,7 @@ declare type WithDefaultProvider<T extends (...args: any[]) => any> = {
  *
  * @param factory - Receives the SDK's default implementation as `defaultFn`.
  *   Return a new function that calls `defaultFn` wherever you want the original behaviour.
- * @returns A {@link WithDefaultProvider} wrapper understood by the SDK's service resolver.
+ * @returns A `WithDefaultProvider` wrapper understood by the SDK's service resolver.
  *
  * @example
  * ```ts
@@ -3662,4 +3377,91 @@ declare type WithDefaultProvider<T extends (...args: any[]) => any> = {
  */
 export declare const withDefaultProvider: <T extends (...args: any[]) => any>(factory: (defaultFn: T) => T) => WithDefaultProvider<T>;
 
+declare type Withdrawal = {
+    /**
+     * @type string | undefined
+     */
+    acknowledged_at?: string;
+    /**
+     * @type string | undefined
+     */
+    available_until?: string;
+    /**
+     * @type integer | undefined, int32
+     */
+    days_remaining?: number;
+    /**
+     * @type object | undefined
+     */
+    declared_by?: WithdrawalContact;
+    /**
+     * @type array | undefined
+     */
+    items?: WithdrawalItem[];
+    /**
+     * @type string | undefined
+     */
+    state?: WithdrawalState;
+    /**
+     * @type string | undefined
+     */
+    withdrawal_form_url?: string;
+};
+
+declare type WithdrawalContact = {
+    /**
+     * @type string | undefined
+     */
+    email?: string;
+    /**
+     * @type string | undefined
+     */
+    full_name?: string;
+};
+
+declare type WithdrawalItem = {
+    /**
+     * @description Discount for a given item in cents. Example `20000` represents `200.00`.
+     * @type integer | undefined, int32
+     */
+    discount?: number;
+    /**
+     * @description Image is an URL of the image of the given cart item.
+     * @type string | undefined
+     */
+    image?: string;
+    /**
+     * @description Name is a product name or title.
+     * @type string | undefined
+     */
+    name?: string;
+    /**
+     * @description Price of the single item with applied discounts in cents. Example `20000` represents `200.00`.
+     * @type integer | undefined, int32
+     */
+    price?: number;
+    /**
+     * @description Quantity is a total number of a given product item in the cart.
+     * @type integer | undefined, int32
+     */
+    quantity?: number;
+    /**
+     * @type string | undefined
+     */
+    sku?: string;
+};
+
+/**
+ * @default STATE_UNSPECIFIED
+ */
+declare type WithdrawalState = WithdrawalStateEnum;
+
+declare type WithdrawalStateEnum =
+| 'STATE_UNSPECIFIED'
+| 'STATE_AVAILABLE'
+| 'STATE_ALREADY_ACKNOWLEDGED'
+| 'STATE_NOT_DELIVERED_YET'
+| 'STATE_WITHDRAWAL_WINDOW_EXPIRED'
+| 'STATE_COUNTRY_NOT_ELIGIBLE';
+
 export { }