@ingridab/sdk 0.1.0-alpha.1

package/dist/index.d.ts

@@ -0,0 +1,3569 @@
+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
+ */
+declare type AddonAddonType = AddonAddonTypeEnum;
+
+declare type AddonAddonTypeEnum =
+| 'ADDON_TYPE_UNSPECIFIED'
+| 'CUSTOM'
+| 'CARRY_IN'
+| 'LEAVE_AT_DOOR'
+| 'UNWRAPPING';
+
+/**
+ * @description Common address entity that used almost everywhere in Ingrid\'s API.
+ */
+declare type Address = {
+    /**
+     * @type array | undefined
+     */
+    address_lines?: string[];
+    /**
+     * @description Number of the apartment.
+     * @type string | undefined
+     */
+    apartment_number?: string;
+    /**
+     * @type string | undefined
+     */
+    attn?: string;
+    /**
+     * @type string | undefined
+     */
+    building_name?: string;
+    /**
+     * @type string | undefined
+     */
+    care_of?: string;
+    /**
+     * @type string | undefined
+     */
+    city?: string;
+    /**
+     * @type object | undefined
+     */
+    coordinates?: Coordinates;
+    /**
+     * @description Country should be specified as two uppercase letters (ISO Alpha-2).\nExample `SE` for Sweden, `ES` for Spain.
+     * @type string | undefined
+     */
+    country?: string;
+    /**
+     * @type string | undefined
+     */
+    door_code?: string;
+    /**
+     * @type string | undefined
+     */
+    floor_number?: string;
+    /**
+     * @type string | undefined
+     */
+    name?: string;
+    /**
+     * @type string | undefined
+     */
+    po_box_id?: string;
+    /**
+     * @type string | undefined
+     */
+    postal_code?: string;
+    /**
+     * @type string | undefined
+     */
+    region?: string;
+    /**
+     * @description Name of the street.
+     * @type string | undefined
+     */
+    street?: string;
+    /**
+     * @description Number of the street.
+     * @type string | undefined
+     */
+    street_number?: string;
+    /**
+     * @type string | undefined
+     */
+    subregion?: string;
+};
+
+/**
+ * @description Ingrid Address API helps to collect clean addresses.\n\nAll errors follow RFC 7807 Problem Details format.
+ */
+declare type Address_2 = {
+    /**
+     * @description ISO 3166-1 alpha-2 country code.
+     * @minLength 2
+     * @maxLength 2
+     * @type string
+     */
+    countryCode: string;
+    /**
+     * @description Postal code.\nFormatting and validation rules are conditional and based on the country code.
+     * @type string
+     */
+    postalCode: string;
+    /**
+     * @description Required for countries:\n##### North America\n*   **US** (United States) - *State*\n*   **CA** (Canada) - *Province/Territory*\n*   **MX** (Mexico) - *State (Estado)*\n\n##### South America\n*   **BR** (Brazil) - *State (Estado)* \n*   **AR** (Argentina) - *Province*\n\n##### Asia Pacific\n*   **AU** (Australia) - *State/Territory*\n*   **CN** (China) - *Province*\n*   **JP** (Japan) - *Prefecture* \n*   **MY** (Malaysia) - *State*\n*   **KR** (South Korea) - *Province/City-Province*\n*   **ID** (Indonesia) - *Province*\n*   **TH** (Thailand) - *Province (Changwat)*\n\n##### Europe\n*   **IT** (Italy) - *Province* (2-letter abbreviation like MI, RM)\n*   **ES** (Spain) - *Province* \n*   **IE** (Ireland) - *County*
+     * @type string | undefined
+     */
+    administrativeArea?: string;
+    /**
+     * @description Usually the District, Suburb, or Neighborhood.\nTypically not required unless explicitly specified in our documentation.
+     * @type string | undefined
+     */
+    subAdministrativeArea?: string;
+    /**
+     * @description The primary locality of the address.\nUsually the City, Town, Village, or Municipality.
+     * @type string | undefined
+     */
+    locality?: string;
+    /**
+     * @description The neighborhood, suburb, or district within the locality.\nTypically not required unless explicitly specified in our documentation.\n\nCritical for:\n- Japan (chome/district names)\n- UK (London districts like \"Soho\" or \"Brixton\")\n- Latin America (colonia)
+     * @type string | undefined
+     */
+    subLocality?: string;
+    /**
+     * @description An ordered array of street address lines.\nIndex 0: Primary street info (Street name + Number, or Block number).\nIndex 1+: Secondary info (Apartment, Suite, Floor, Building Name).
+     * @type array | undefined
+     */
+    addressLines?: string[];
+    /**
+     * @type string | undefined
+     */
+    type?: AddressType;
+};
+
+/**
+ * @description Represents an address suitable for delivery.
+ */
+declare type AddressAddress = {
+    /**
+     * @description \nRefers to a ISO-3166 alpha 2 country code.
+     * @type string
+     */
+    country_code: 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) we store the subdivision name instead.\nExample: region for Hong Kong = `Kowloon`.
+     * @type string | undefined
+     */
+    region_code?: string;
+    /**
+     * @description Refers to a second-level administrative subdivision below the region (ISO-3166-2), without the country_code prefix.\nExample: region for Washington State = `WA` (from `US-WA`), subregion for King County = `033` (from `US-WA-033`).\nException: for some countries (e.g. Mexico, Hong Kong) we store the subdivision name instead.\nExample: subregion within Hong Kong/Kowloon = `Tsim Sha Tsui`.
+     * @type string | undefined
+     */
+    subregion_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 Street name of the address.
+     * @type string | undefined
+     */
+    street?: string;
+    /**
+     * @description Street number of the address.
+     * @type string | undefined
+     */
+    street_number?: string;
+    /**
+     * @description Apartment number of the address.
+     * @type string | undefined
+     */
+    apartment_number?: string;
+    /**
+     * @description Building name of the address.
+     * @type string | undefined
+     */
+    building_name?: string;
+    /**
+     * @description Floor number of the address.
+     * @type string | undefined
+     */
+    floor_number?: string;
+    /**
+     * @description PO Box identifier of the address.
+     * @type string | undefined
+     */
+    po_box_id?: string;
+    /**
+     * @description Full name associated with the address, for example company name.
+     * @type string | undefined
+     */
+    name?: string;
+    /**
+     * @description Care of information associated with the address.
+     * @type string | undefined
+     */
+    care_of?: 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?: AddressCoordinates;
+};
+
+/**
+ * @description Types of modifications the validation API made to the original address.
+ */
+declare type AddressChange = AddressChangeEnum;
+
+declare type AddressChangeEnum =
+| 'postalCodeFixed'
+| 'localityFixed'
+| 'spellingCorrected'
+| 'componentsAdded'
+| 'componentsRemoved';
+
+/**
+ * @description Represents a latitude/longitude pair.\nUnless specified otherwise, this must conform to the WGS84 standard.\nValues must be within normalized ranges.
+ */
+declare type AddressCoordinates = {
+    /**
+     * @description The latitude in degrees. Must be within the range -90.0 to +90.0, inclusive.
+     * @type number, double
+     */
+    lat: number;
+    /**
+     * @description The longitude in degrees. Must be within the range -180.0 to +180.0, inclusive.
+     * @type number, double
+     */
+    lng: number;
+};
+
+declare type AddressDebugParams = Pick<ParticleParamsMap['address'], 'customization'>;
+
+/**
+ * @description Response containing the full address resolved from a prediction ID.
+ */
+declare type AddressDetailsResponse = {
+    /**
+     * @description The full address resolved from the prediction.
+     */
+    address: Address_2;
+};
+
+declare type AddressParticleInputState = DeepPartial<V1AlphaAddressContact>;
+
+declare type AddressParticleParams = {
+    mode: 'postalCode' | 'addressForm';
+    prefillAddress?: RecipientContact;
+    customization?: {
+        address?: { vatTypes?: string[] };
+        addressBook?: { displayMode?: 'off' | 'inline' | 'popup' };
+        suggestions?: { displayMode?: 'inline' | 'popup' };
+    };
+};
+
+declare const addressParticleParamsValidator = z.object({
+    mode: z.enum(['postalCode', 'addressForm']),
+    prefillAddress: recipientContactValidator.optional(),
+    customization: z
+    .object({
+        address: z
+        .object({
+            vatTypes: z.array(z.string()).optional(), // TODO: TBD - we'll probably need multiselect input to handle this in the Playground
+        })
+        .optional(),
+        addressBook: z
+        .object({
+            displayMode: z.enum(['off', 'inline', 'popup']).optional(),
+        })
+        .optional(),
+        suggestions: z
+        .object({
+            displayMode: z.enum(['inline', 'popup']).optional(),
+        })
+        .optional(),
+    })
+    .optional(),
+}) satisfies z.ZodType<AddressParticleParams>;
+
+declare type AddressPresetParams = Pick<ParticleParamsMap['address'], 'mode' | 'prefillAddress'>;
+
+/**
+ * @description The contact to create.
+ */
+declare type AddressServiceCreateContactMutationRequest = V1AlphaAddressContact;
+
+declare type AddressServiceCreateContactPathParams = {
+    /**
+     * @description The resource id of the address book the contact should belong to.\nTypically this is the customer ID.
+     * @pattern [^/]+
+     * @type string
+     */
+    address_book_id: string;
+};
+
+/**
+ * @description A successful response.
+ */
+declare type AddressServiceDeleteContact200 = object;
+
+declare type AddressServiceDeleteContactPathParams = {
+    /**
+     * @description The resource id of the address book the contact belongs to.\nTypically this is the customer ID.
+     * @pattern [^/]+
+     * @type string
+     */
+    address_book_id: string;
+    /**
+     * @description The contact ID to delete.
+     * @pattern [^/]+
+     * @type string
+     */
+    contact_id: string;
+};
+
+declare type AddressServiceListContactsPathParams = {
+    /**
+     * @description The resource id of the set of contacts to retrieve.\nTypically this is the customer ID.
+     * @pattern [^/]+
+     * @type string
+     */
+    address_book_id: string;
+};
+
+declare type AddressServiceListContactsQueryParams = {
+    /**
+     * @description Country code defined as ISO 3166-1 alpha-2, country code of the addresses.
+     * @type string | undefined
+     */
+    country_code?: string;
+};
+
+/**
+ * @description The contact to update.
+ */
+declare type AddressServiceUpdateContactMutationRequest = {
+    /**
+     * @description Represents an address suitable for delivery.
+     * @type object
+     */
+    address: AddressAddress;
+    /**
+     * @description The email address of the contact.
+     * @type string | undefined
+     */
+    email?: string;
+    /**
+     * @description A phone number, including region and optional extension.
+     * @type object | undefined
+     */
+    phone_number?: ContactPhoneNumber_2;
+    /**
+     * @description Full name associated with the contact.
+     * @type string | undefined
+     */
+    name?: string;
+    /**
+     * @description First name associated with the contact.
+     * @type string | undefined
+     */
+    first_name?: string;
+    /**
+     * @description Last name associated with the contact.
+     * @type string | undefined
+     */
+    last_name?: string;
+    /**
+     * @description National ID number associated with the contact.
+     * @type string | undefined
+     */
+    national_id_number?: string;
+    /**
+     * @description Company name associated with the contact.
+     * @type string | undefined
+     */
+    company_name?: string;
+    /**
+     * @description VAT number associated with the contact.
+     * @type string | undefined
+     */
+    vat?: string;
+    /**
+     * @description Customs number associated with the contact.
+     * @type string | undefined
+     */
+    customs_number?: string;
+};
+
+declare type AddressSuggestionsService = {
+    list: DataResolver<
+        { params: AutocompleteAddressQuery['QueryParams']; token: string; siteId: string },
+    AutocompleteAddressQuery['Response']
+    >;
+    resolve: DataResolver<
+        {
+        params: GetAddressDetailsQuery['PathParams'];
+        token: string;
+        siteId: string;
+    },
+    GetAddressDetailsQuery['Response']
+    >;
+};
+
+declare type AddressType = AddressTypeEnum;
+
+declare type AddressTypeEnum = 'unknown' | 'residential' | 'commercial';
+
+declare type AddressValidationService = {
+    validateAddress: DataResolver<
+        { payload: ValidateAddressMutation['Request']; token: string; siteId: string },
+    ValidateAddressMutation['Response']
+    >;
+};
+
+declare type Alert = {
+    /**
+     * @type object | undefined
+     */
+    awaiting_supplier?: AlertAwaitingSupplierPayload;
+    /**
+     * @type string | undefined
+     */
+    created_at?: string;
+    /**
+     * @type object | undefined
+     */
+    delivery_attempt_failed?: AlertDeliveryAttemptFailedPayload;
+    /**
+     * @type object | undefined
+     */
+    delivery_delayed?: AlertDeliveryDelayedPayload;
+    /**
+     * @type object | undefined
+     */
+    delivery_delayed_from_carrier?: AlertDeliveryDelayedFromCarrierPayload;
+    /**
+     * @type object | undefined
+     */
+    estimated_delivery_time_updated?: AlertEstimatedDeliveryTimeUpdatedPayload;
+    /**
+     * @type object | undefined
+     */
+    linehaul?: AlertLinehaulPayload;
+    /**
+     * @type object | undefined
+     */
+    out_for_delivery?: AlertOutForDeliveryPayload;
+    /**
+     * @type object | undefined
+     */
+    submission_delayed?: AlertSubmissionDelayedPayload;
+    /**
+     * @type string | undefined
+     */
+    type?: AlertType;
+};
+
+declare type AlertAwaitingSupplierPayload = {
+    /**
+     * @type object | undefined
+     */
+    estimated_time?: EstimatedTime;
+    /**
+     * @description Provides a date interval. Depending on a case, `start` and `end` parts are not guaranteed to be present.
+     * @type object | undefined
+     */
+    estimated_time_range?: DateTimeRange;
+};
+
+declare type AlertDeliveryAttemptFailedPayload = object;
+
+declare type AlertDeliveryDelayedFromCarrierPayload = object;
+
+declare type AlertDeliveryDelayedPayload = object;
+
+declare type AlertEstimatedDeliveryTimeUpdatedPayload = object;
+
+declare type AlertLinehaulPayload = {
+    /**
+     * @type object | undefined
+     */
+    estimated_time?: EstimatedTime;
+    /**
+     * @description Provides a date interval. Depending on a case, `start` and `end` parts are not guaranteed to be present.
+     * @type object | undefined
+     */
+    estimated_time_range?: DateTimeRange;
+};
+
+declare type AlertOutForDeliveryPayload = object;
+
+declare type AlertSubmissionDelayedPayload = object;
+
+/**
+ * @default ALERT_UNDEFINED
+ */
+declare type AlertType = AlertTypeEnum;
+
+declare type AlertTypeEnum =
+| 'ALERT_UNDEFINED'
+| 'ALERT_DELIVERY_DELAYED'
+| 'ALERT_ESTIMATED_DELIVERY_TIME_UPDATED'
+| 'ALERT_DELIVERY_ATTEMPT_FAILED'
+| 'ALERT_OUT_FOR_DELIVERY'
+| 'ALERT_SUBMISSION_DELAYED'
+| 'ALERT_DELIVERY_DELAYED_FROM_CARRIER'
+| 'ALERT_AWAITING_SUPPLIER'
+| 'ALERT_LINEHAUL_TO_CARRIER';
+
+declare type AtlasErrorsBadRequestError = AtlasErrorsProblemDetails & {
+    /**
+     * @type number
+     */
+    status: AtlasErrorsBadRequestErrorStatusEnum;
+    /**
+     * @type string
+     */
+    title: AtlasErrorsBadRequestErrorTitleEnum;
+    /**
+     * @type string
+     */
+    type: AtlasErrorsBadRequestErrorTypeEnum;
+};
+
+declare type AtlasErrorsBadRequestErrorStatusEnum = 400;
+
+declare type AtlasErrorsBadRequestErrorTitleEnum = 'Bad Request';
+
+declare type AtlasErrorsBadRequestErrorTypeEnum =
+'https://docs.ingrid.com/developer-resources/ingrid-api/errors/common/bad-request';
+
+/**
+ * @description A detailed, machine-readable validation error.\nThis corresponds to the `finalDetailedError` in the Go package.
+ */
+declare type AtlasErrorsDetailedError = {
+    /**
+     * @description A stable, machine-readable error code (and translation key).\ne.g., \"error.email.required\"
+     * @type string
+     */
+    code: string;
+    /**
+     * @description The final, translated, human-readable message for this specific failure.
+     * @type string
+     */
+    detail: string;
+    /**
+     * @description The specific JSON path that caused the error.\ne.g., \"/email\"
+     * @type string, json-pointer
+     */
+    param: string;
+};
+
+declare type AtlasErrorsNotFoundError = AtlasErrorsProblemDetails & {
+    /**
+     * @type number
+     */
+    status: AtlasErrorsNotFoundErrorStatusEnum;
+    /**
+     * @type string
+     */
+    title: AtlasErrorsNotFoundErrorTitleEnum;
+    /**
+     * @type string
+     */
+    type: AtlasErrorsNotFoundErrorTypeEnum;
+};
+
+declare type AtlasErrorsNotFoundErrorStatusEnum = 404;
+
+declare type AtlasErrorsNotFoundErrorTitleEnum = 'Not Found';
+
+declare type AtlasErrorsNotFoundErrorTypeEnum =
+'https://docs.ingrid.com/developer-resources/ingrid-api/errors/common/not-found';
+
+/**
+ * @description The standard, RFC 9457-compliant error response for our B2B APIs.\nThis corresponds to the `finalProblemDetails` in the Go package.
+ */
+declare type AtlasErrorsProblemDetails = {
+    /**
+     * @description A URI reference that identifies the problem type.\nThis MUST link to public documentation.\ne.g., \"https://developer-next.ingrid.com/errors/validation-error\"
+     * @type string, uri
+     */
+    type: string;
+    /**
+     * @description A short, human-readable summary of the problem type (translated).\ne.g., \"Validation Failed\"
+     * @type string
+     */
+    title: string;
+    /**
+     * @description The HTTP status code.\ne.g., 400
+     * @type integer, int32
+     */
+    status: number;
+    /**
+     * @description A human-readable explanation specific to this occurrence (translated).\ne.g., \"One or more fields failed validation.\"
+     * @type string | undefined
+     */
+    detail?: string;
+    /**
+     * @description A unique identifier for the request that caused the error. Typically to be\nshared with Ingrid support for debugging.
+     * @type string | undefined, uri
+     */
+    instance?: string;
+    /**
+     * @description An array of detailed validation errors.\nThis is omitted if not applicable.
+     * @type array | undefined
+     */
+    errors?: AtlasErrorsDetailedError[];
+};
+
+declare type AtlasErrorsServerError = AtlasErrorsProblemDetails & {
+    /**
+     * @type number
+     */
+    status: AtlasErrorsServerErrorStatusEnum;
+    /**
+     * @type string
+     */
+    title: AtlasErrorsServerErrorTitleEnum;
+    /**
+     * @type string
+     */
+    type: AtlasErrorsServerErrorTypeEnum;
+};
+
+declare type AtlasErrorsServerErrorStatusEnum = 500;
+
+declare type AtlasErrorsServerErrorTitleEnum = 'Internal Server Error';
+
+declare type AtlasErrorsServerErrorTypeEnum =
+'https://docs.ingrid.com/developer-resources/ingrid-api/errors/common/internal-server-error';
+
+/**
+ * @description The request has succeeded.
+ */
+declare type AutocompleteAddress200 = SearchAddressesResponse;
+
+/**
+ * @description The server could not understand the request due to invalid syntax.
+ */
+declare type AutocompleteAddress400 = AtlasErrorsBadRequestError;
+
+/**
+ * @description Server error
+ */
+declare type AutocompleteAddress500 = AtlasErrorsServerError;
+
+declare type AutocompleteAddressQuery = {
+    Response: AutocompleteAddress200;
+    QueryParams: AutocompleteAddressQueryParams;
+    Errors: AutocompleteAddress400 | AutocompleteAddress500;
+};
+
+declare type AutocompleteAddressQueryParams = {
+    /**
+     * @description ISO 3166-1 alpha-2 country code.
+     * @pattern ^[A-Z]{2}$
+     * @type string
+     */
+    countryCode: CountryCode;
+    /**
+     * @description The text typed by the user. Ignored if `containerId` is provided.
+     * @type string | undefined
+     */
+    query?: string;
+    /**
+     * @description The ID of a parent result (where `action` was `expand`).\nUsed to fetch children (e.g., units in a building).
+     * @type string | undefined
+     */
+    containerId?: string;
+    /**
+     * @description Indicates which address field the user is currently editing.\nHelps the API optimize results for the relevant field context.
+     * @type string | undefined
+     */
+    focus?: AutocompleteFocus;
+};
+
+/**
+ * @description Indicates which address field the user is currently editing.\nHelps the API optimize results for the relevant field context.
+ */
+declare type AutocompleteFocus = AutocompleteFocusEnum;
+
+declare type AutocompleteFocusEnum =
+| 'addressLines'
+| 'postalCode'
+| 'locality'
+| 'administrativeArea';
+
+/**
+ * i18next uses interpolation of plural rule suffixes (https://cldr.unicode.org/index/cldr-spec/plural-rules#TOC-Determining-Plural-Categories)
+ * for type safety, cut the suffix out if it exists in translation source file
+ */
+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 BaseParticleDef<K extends ParticleType> = {
+    type: K;
+    customization?: ParticleCustomizationConfig<K>;
+    params: ParticleParamsMap[K];
+};
+
+/**
+ * @description A phone number, including region and optional extension.
+ */
+declare type ContactPhoneNumber = {
+    /**
+     * @description \nThe country code where the delivery will occur (ISO 3166-1 alpha-2).
+     * @type string
+     */
+    country_code: string;
+    /**
+     * @description The main phone number, formatted as per the region\'s conventions.
+     * @type string
+     */
+    number: string;
+    /**
+     * @description An optional phone number extension.
+     * @type string | undefined
+     */
+    extension?: string;
+};
+
+/**
+ * @description A phone number, including region and optional extension.
+ */
+declare type ContactPhoneNumber_2 = {
+    /**
+     * @description \nThe country code where the delivery will occur (ISO 3166-1 alpha-2).
+     * @type string
+     */
+    country_code: string;
+    /**
+     * @description The main phone number, formatted as per the region\'s conventions.
+     * @type string
+     */
+    number: string;
+    /**
+     * @description An optional phone number extension.
+     * @type string | undefined
+     */
+    extension?: string;
+};
+
+declare type ContactsService = {
+    listContactBookEntries: DataResolver<
+        {
+        params: AddressServiceListContactsPathParams & AddressServiceListContactsQueryParams;
+        token: string;
+    },
+        {
+        entries: { id: string; label: string; secondaryLabel: string }[];
+    }
+    >;
+    getContactBookEntry: DataResolver<
+        {
+        params: { entry_id: string; address_book_id: string };
+        token: string;
+    },
+        { address: V1AlphaAddressContact } | null
+    >;
+    upsertContactBookEntry: DataResolver<
+        {
+        payload:
+        | AddressServiceCreateContactMutationRequest
+        | AddressServiceUpdateContactMutationRequest;
+        params: AddressServiceCreateContactPathParams;
+        token: string;
+    },
+    V1AlphaAddressContact
+    >;
+    deleteContactBookEntry: DataResolver<
+        { params: AddressServiceDeleteContactPathParams; token: string },
+    AddressServiceDeleteContact200
+    >;
+};
+
+declare type Coordinates = {
+    /**
+     * @type number | undefined, double
+     */
+    lat?: number;
+    /**
+     * @type number | undefined, double
+     */
+    lng?: number;
+};
+
+/**
+ * @pattern ^[A-Z]{2}$
+ */
+declare type CountryCode = string;
+
+declare interface CountrySelectorDebugParams {
+    name: string;
+}
+
+declare type CountrySelectorParams = {
+    mode: 'select';
+    name: string;
+    customization?: Record<never, never>;
+};
+
+declare const countrySelectorParticleParamsValidator = z.object({
+    mode: z.enum(['select']),
+    name: z.string(),
+    customization: z.object({}).optional(),
+}) satisfies z.ZodType<CountrySelectorParams>;
+
+declare interface CountrySelectorPresetParams {
+    mode: ParticleParamsMap['countrySelector']['mode'];
+}
+
+export declare const createAddressMolecule: ({ mode, prefillAddress }: AddressPresetParams) => ({ customization }: AddressDebugParams) => {
+    type: "address";
+    customization: {
+        address?: {
+            vatTypes?: string[];
+        };
+        addressBook?: {
+            displayMode?: "off" | "inline" | "popup";
+        };
+        suggestions?: {
+            displayMode?: "inline" | "popup";
+        };
+    } | undefined;
+    params: {
+        mode: "postalCode" | "addressForm";
+        prefillAddress: RecipientContact | undefined;
+    };
+};
+
+export declare const createCountrySelectorMolecule: ({ mode }: CountrySelectorPresetParams) => ({ name }: CountrySelectorDebugParams) => {
+    type: "countrySelector";
+    params: {
+        mode: "select";
+        name: string;
+    };
+};
+
+export declare const createDeliveryMolecule: ({ mode }: DeliveryPresetParams) => ({ name, customization }: DeliveryDebugParams) => {
+    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;
+    };
+};
+
+export declare const createFreeShippingIndicatorMolecule: () => ({ name, customization }: FreeShippingIndicatorDebugParams) => {
+    type: "freeShippingIndicator";
+    customization: {
+        showExhaustedLevelsMessage?: boolean;
+    } | undefined;
+    params: {
+        name: string;
+    };
+};
+
+declare type DataResolver<Args, Output> = (args: Args) => Promise<Output>;
+
+/**
+ * @description Provides a date interval. Depending on a case, `start` and `end` parts are not guaranteed to be present.
+ */
+declare type DateTimeRange = {
+    /**
+     * @description End of the interval. Date is returned in RFC3339 format. Example `2018-09-08T22:47:31Z`.
+     * @type string | undefined
+     */
+    end?: string;
+    /**
+     * @type string | undefined
+     */
+    start?: string;
+};
+
+declare type DeepPartial<T> = T extends (infer U)[]
+? // this prevents the array elements from being undefined
+// DeepPartial<string[]> would be string[] | undefined instead of (string | undefined)[]
+DeepPartial<U>[]
+: T extends object
+? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+}
+: T;
+
+/**
+ * @description An Addon represents an additional service or feature offered with a delivery.
+ */
+declare type DeliveryAddon = {
+    /**
+     * @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
+     */
+    display_name: string;
+    /**
+     * @description The price of the addon in minor currency units, e.g., cents.
+     * @type string | undefined, int64
+     */
+    readonly price?: 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.
+     * @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;
+    /**
+     * @description Unique addon identifier.
+     * @type string | undefined
+     */
+    readonly id?: string;
+    /**
+     * @description The external identifier of an addon, used for integration purposes.
+     * @type string | undefined
+     */
+    readonly external_id?: string;
+    /**
+     * @description The display-friendly description of the addon.\nDisplay name and description are localized, if translations are provided.
+     * @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 = {
+    /**
+     * @description Available price levels for the carrier product.\nOnly the base price and prices with the `total_value` price rule are included.
+     * @type array | undefined
+     */
+    price_levels?: PriceLevelsPriceLevel[];
+};
+
+/**
+ * @description Information about a warehouse.\nAll this data is stored in the site configuration.
+ */
+declare type DeliveryCategoryWarehouse = {
+    /**
+     * @description Unique identifier of the warehouse.
+     * @type string
+     */
+    id: string;
+    /**
+     * @description Represents an address suitable for delivery.
+     * @type object
+     */
+    address: V1AlphaDeliveryAddress;
+    /**
+     * @description The external identifier of a warehouse, used for integration purposes.
+     * @type string | undefined
+     */
+    external_id?: string;
+};
+
+/**
+ * @description Represents a latitude/longitude pair.\nUnless specified otherwise, this must conform to the WGS84 standard.\nValues must be within normalized ranges.
+ */
+declare type DeliveryCoordinates = {
+    /**
+     * @description The latitude in degrees. Must be within the range -90.0 to +90.0, inclusive.
+     * @type number, double
+     */
+    lat: number;
+    /**
+     * @description The longitude in degrees. Must be within the range -180.0 to +180.0, inclusive.
+     * @type number, double
+     */
+    lng: number;
+};
+
+declare interface DeliveryDebugParams {
+    name: string;
+    customization?: ParticleCustomizationConfig<'delivery'>;
+}
+
+/**
+ * @description The DeliveryCategory represents a grouping of delivery options that share the same type and other characteristics.
+ */
+declare type DeliveryDeliveryCategory = {
+    /**
+     * @description The unique identifier of a delivery category.
+     * @type string
+     */
+    id: string;
+    /**
+     * @description The external identifier of a category, used for integration purposes.
+     * @type string | undefined
+     */
+    external_id?: 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.
+     * @type string
+     */
+    delivery_type: DeliveryCategoryDeliveryType;
+    /**
+     * @description A human-readable name of the category, which will be presented to the customer.
+     * @type string
+     */
+    display_name: string;
+    /**
+     * @description Defines the order in which the category will be presented to the customer.
+     * @type integer | undefined, int32
+     */
+    sort_order?: 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.
+     * @type string | undefined
+     */
+    readonly custom_info_text?: 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.
+     * @type string | undefined
+     */
+    id?: 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.
+     * @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
+     */
+    by_ref?: LocationByRef;
+};
+
+/**
+ * @description The DeliveryOption represents the details of a specific delivery option.
+ */
+declare type DeliveryDeliveryOption = {
+    /**
+     * @description The unique identifier of the delivery option.
+     * @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
+     */
+    price?: string;
+    /**
+     * @description URI of the product image, e.g., thumbnail.
+     * @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[];
+};
+
+/**
+ * @description Constraints on the node\'s handoff.
+ */
+declare type DeliveryNodeHandoff = {
+    /**
+     * @description The earliest time the node can hand off the delivery.
+     * @type string | undefined, date-time
+     */
+    earliest_time?: string;
+    /**
+     * @description The latest time the node can hand off the delivery.
+     * @type string | undefined, date-time
+     */
+    latest_time?: string;
+};
+
+/**
+ * @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
+ */
+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 = {
+    /**
+     * @description The name of the carrier company, e.g., \"DHL\", \"FedEx\".
+     * @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>;
+    /**
+     * @description Merchant-specific carrier product identifier.
+     * @type string
+     */
+    external_id: string;
+};
+
+/**
+ * @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 DeliveryParticleParams = {
+    mode: 'active' | 'passive';
+    name: string;
+    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;
+        };
+    };
+};
+
+declare const deliveryParticleParamsValidator = 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<DeliveryParticleParams>;
+
+/**
+ * @description The PickupLocation represents a physical location from which a delivery can be retrieved.
+ */
+declare type DeliveryPickupLocation = {
+    /**
+     * @description Internal location identifier, used within the system.
+     * @type string
+     */
+    id: string;
+    /**
+     * @description External identifier provided by the merchant or carrier.
+     * @type string
+     */
+    external_id: string;
+    /**
+     * @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
+     */
+    location_type?: PickupLocationLocationType;
+    /**
+     * @description The title of the location displayed to the customer.
+     * @type string
+     */
+    title: string;
+    /**
+     * @description Contact represents generic contact information.
+     * @type object | undefined
+     */
+    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;
+    /**
+     * @description Additional informational sections about the pickup location.
+     * @type array | undefined
+     */
+    sections?: PickupLocationSection[];
+    /**
+     * @description Distances define the walking and driving distances to the pickup location.
+     * @type object | undefined
+     */
+    distances?: PickupLocationDistances;
+};
+
+declare interface DeliveryPresetParams {
+    mode: ParticleParamsMap['delivery']['mode'];
+}
+
+/**
+ * @description ReturnPromise contains promise for returns and exchanges for a user and a cart.
+ */
+declare type DeliveryReturnsPromise = {
+    /**
+     * @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
+     */
+    readonly returns_enabled?: boolean;
+    /**
+     * @description Non-negative cost of returning the item, or items. Unit is cents.
+     * @type string | undefined, int64
+     */
+    readonly return_cost?: string;
+    /**
+     * @description Indicates whether exchanges are enabled. See `exchange_cost` for the associated cost.
+     * @type boolean | undefined
+     */
+    readonly exchanges_enabled?: boolean;
+    /**
+     * @description Non-negative cost of exchanging the item, or items. Unit is cents.
+     * @type string | undefined, int64
+     */
+    readonly exchange_cost?: string;
+    /**
+     * @description Time in days to return or exchange the item.
+     * @type integer | undefined, int32
+     */
+    readonly return_time_days?: number;
+    /**
+     * @description Return Policy text suitable for presentation to the customer.
+     * @type string | undefined
+     */
+    readonly return_policy_text?: string;
+    /**
+     * @description Return Policy URL, which is suitable for presentation to the customer.
+     * @type string | undefined
+     */
+    readonly return_policy_url?: string;
+    /**
+     * @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
+     */
+    readonly is_unavailable?: boolean;
+};
+
+declare type DeliveryService = {
+    getSession: DataResolver<GetDeliverySessionArgs, DeliverySession>;
+};
+
+/**
+ * @description A Session is the primary resource for handling the delivery options and the customer lifecycle.
+ */
+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;
+    /**
+     * @description Purchase describes purchase experience.
+     * @type object
+     */
+    purchase: SessionPurchase;
+    /**
+     * @description The deliveries included in this session.
+     * @type array
+     */
+    deliveries: V1AlphaDeliveryDelivery[];
+    /**
+     * @description The timestamp when the session was created.
+     * @type string | undefined, date-time
+     */
+    readonly create_time?: string;
+    /**
+     * @description The timestamp when the session was last updated.
+     * @type string | undefined, date-time
+     */
+    readonly update_time?: 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.
+     * @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;
+};
+
+/**
+ * @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 DeliveryTypeEnum =
+| 'UNKNOWN'
+| 'DELIVERY'
+| 'PICKUP'
+| 'MAILBOX'
+| 'INSTORE'
+| 'INWAREHOUSE';
+
+/**
+ * @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.
+ * @default UNKNOWN_DIRECTION_TYPE
+ */
+declare type DirectionType = DirectionTypeEnum;
+
+declare type DirectionTypeEnum = 'UNKNOWN_DIRECTION_TYPE' | 'OUTBOUND' | 'RETURN' | 'UNSPECIFIED';
+
+declare type DisplayItem = {
+    /**
+     * @type integer | undefined, int32
+     */
+    discount?: number;
+    /**
+     * @type string | undefined
+     */
+    image?: string;
+    /**
+     * @type string | undefined
+     */
+    name?: string;
+    /**
+     * @type integer | undefined, int32
+     */
+    price?: number;
+    /**
+     * @description quantity - current quantity of items.
+     * @type integer | undefined, int32
+     */
+    quantity?: number;
+    /**
+     * @type string | undefined
+     */
+    sku?: string;
+    /**
+     * @type integer | undefined, int32
+     */
+    total_price?: number;
+};
+
+declare type EstimatedTime = {
+    /**
+     * @description Earliest date in RFC3339 format.
+     * @type string | undefined
+     */
+    earliest?: string;
+    /**
+     * @description Latest date in RFC3339 format.
+     * @type string | undefined
+     */
+    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;
+};
+
+/**
+ * @description Relative represents an ETD as a range of time units.
+ */
+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;
+    /**
+     * @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
+     */
+    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<AddressParticleInputState>) => void;
+    selectionChange: (event: Event_2<{ deliveryId: string; categoryId: string }>) => void;
+    ready: () => void;
+    error: (error: unknown) => void;
+};
+
+declare type ExceptionStatus = {
+    /**
+     * @type string | undefined
+     */
+    created_at?: string;
+    /**
+     * @description status of the exception currently conforms to the `tracking.Status`.
+     * @type string | undefined
+     */
+    status?: string;
+};
+
+declare interface FreeShippingIndicatorDebugParams {
+    name: string;
+    customization?: ParticleCustomizationConfig<'freeShippingIndicator'>;
+}
+
+declare type FreeShippingIndicatorParams = {
+    name: string;
+    deliveryId?: string;
+    customization?: {
+        showExhaustedLevelsMessage?: boolean;
+    };
+};
+
+declare const freeShippingIndicatorParticleParamsValidator = z.object({
+    name: z.string(),
+    deliveryId: z.string().optional(),
+    customization: z
+    .object({
+        showExhaustedLevelsMessage: z.boolean().optional(),
+    })
+    .optional(),
+}) satisfies z.ZodType<FreeShippingIndicatorParams>;
+
+/**
+ * @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.
+ */
+declare type GetAddressDetails200 = AddressDetailsResponse;
+
+/**
+ * @description The server could not understand the request due to invalid syntax.
+ */
+declare type GetAddressDetails400 = AtlasErrorsBadRequestError;
+
+/**
+ * @description The server cannot find the requested resource.
+ */
+declare type GetAddressDetails404 = AtlasErrorsNotFoundError;
+
+/**
+ * @description Server error
+ */
+declare type GetAddressDetails500 = AtlasErrorsServerError;
+
+declare type GetAddressDetailsPathParams = {
+    /**
+     * @description The opaque identifier from a prediction (where `action` was `resolve`).
+     * @type string
+     */
+    id: string;
+};
+
+declare type GetAddressDetailsQuery = {
+    Response: GetAddressDetails200;
+    PathParams: GetAddressDetailsPathParams;
+    Errors: GetAddressDetails400 | GetAddressDetails404 | GetAddressDetails500;
+};
+
+declare type GetDeliverySessionArgs = z.infer<typeof deliveryArgsSchema>;
+
+declare type GetTrackingDataArgs = z.infer<typeof trackingArgsSchema>;
+
+declare type GetTrackingDataResponse = {
+    /**
+     * @type boolean
+     */
+    has_private_view: boolean;
+    /**
+     * @type object
+     */
+    order: Order;
+    /**
+     * @description parcel_options is a map of parcel tracking numbers to options.
+     * @type object | undefined
+     */
+    parcel_options?: Record<string, GetTrackingDataResponseOptions>;
+    /**
+     * @type string
+     */
+    site_id: string;
+    /**
+     * @type string
+     */
+    tos_id: string;
+};
+
+declare type GetTrackingDataResponseOptions = {
+    /**
+     * @type boolean | undefined
+     */
+    ica_bankid_flow?: boolean;
+};
+
+declare function initIngrid(params: Params): Promise<{
+    compound: {
+        mount: (containerSelector: string, options?: {
+            signal?: AbortSignal;
+        }) => Promise<void>;
+        unmount: (callback?: (() => void) | undefined) => void;
+        update: (newConfig: Partial<UpdatableConfig>) => void;
+        on: <K extends keyof EventsMap>(event: K, callback: EventsMap[K]) => () => boolean;
+    };
+    setLocale: (locale: Locale) => void;
+    __internal: SDKInternal;
+}>;
+export default initIngrid;
+
+declare const _internalBrand: unique symbol;
+
+declare type Item = {
+    /**
+     * @description Attributes represents a collection of key-value pairs containing additional item properties.\nBoth keys and values are strings. Examples: {\"brand\": \"Nike\", \"material\": \"cotton\"}.
+     * @type object | undefined
+     */
+    attributes?: Record<string, string>;
+    /**
+     * @description CancelledQuantity is the number of items that have been cancelled.
+     * @type integer | undefined, int32
+     */
+    cancelled_quantity?: number;
+    /**
+     * @description CancelledTotalPrice is the total price for all cancelled items of the same SKU in cents.
+     * @type integer | undefined, int32
+     */
+    cancelled_total_price?: number;
+    /**
+     * @description Discount is the discount for a given item in cents. Example: `20000` represents `200.00`.
+     * @type integer | undefined, int32
+     */
+    discount?: number;
+    /**
+     * @description Image is the URL of the image of the given cart item.
+     * @type string | undefined
+     */
+    image?: string;
+    /**
+     * @description Name is the product name or title.
+     * @type string | undefined
+     */
+    name?: string;
+    /**
+     * @description Price is the price of a single item with applied discounts in cents. Example: `20000` represents `200.00`.
+     * @type integer | undefined, int32
+     */
+    price?: number;
+    /**
+     * @description Quantity is the total number of a given non-cancelled product item in the cart.
+     * @type integer | undefined, int32
+     */
+    quantity?: number;
+    /**
+     * @description SKU is a unique product identifier.
+     * @type string | undefined
+     */
+    sku?: string;
+    /**
+     * @type integer | undefined, int32
+     */
+    total_price?: number;
+    /**
+     * @description Properties that define item variant.
+     * @type object | undefined
+     */
+    variant?: ItemVariant;
+};
+
+/**
+ * @description Properties that define item variant.
+ */
+declare type ItemVariant = {
+    /**
+     * @type string | undefined
+     */
+    color?: string;
+    /**
+     * @type string | undefined
+     */
+    size?: 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.
+ * @default LABEL_TYPE_UNKNOWN
+ */
+declare type LabelLabelType = LabelLabelTypeEnum;
+
+declare type LabelLabelTypeEnum =
+| 'LABEL_TYPE_UNKNOWN'
+| 'LABEL_TYPE_SUSTAINABILITY'
+| 'LABEL_TYPE_PRIORITY'
+| 'LABEL_TYPE_CUSTOM'
+| 'LABEL_TYPE_SWAN';
+
+declare type LineItem = {
+    /**
+     * @description Currency represented as a symbol (ISO-4217 - 3 letters string). Examples: USD, PLN, SEK.
+     * @type string
+     */
+    currency: string;
+    /**
+     * @description Discount is the discount for a given item in cents. Example: `20000` represents `200.00`.
+     * @type integer | undefined, int32
+     */
+    discount?: number;
+    /**
+     * @description Image is the URL of the image of the given cart item.
+     * @type string | undefined
+     */
+    image?: string;
+    /**
+     * @description Name is the product name or title.
+     * @type string | undefined
+     */
+    name?: string;
+    /**
+     * @description Price is the price of a single item with applied discounts in cents. Example: `20000` represents `200.00`.
+     * @type integer, int32
+     */
+    price: number;
+    /**
+     * @description Properties that define item variant.
+     * @type object | undefined
+     */
+    properties?: Record<string, string>;
+    /**
+     * @description Quantity is the total number of a given product item in the cart.
+     * @type integer, int32
+     */
+    quantity: number;
+    /**
+     * @description SKU is a unique product identifier.
+     * @type string
+     */
+    sku: string;
+    /**
+     * @type integer | undefined, int32
+     */
+    total_price?: number;
+};
+
+/**
+ * @description Represents the dimensions of the item.
+ */
+declare type LineItemDimensions = {
+    /**
+     * @description Height of the item in millimeters, must be greater than 0.
+     * @type integer, int32
+     */
+    height: number;
+    /**
+     * @description Length of the item in millimeters, must be greater than 0.
+     * @type integer, int32
+     */
+    length: number;
+    /**
+     * @description Width of the item in millimeters, must be greater than 0.
+     * @type integer, int32
+     */
+    width: number;
+};
+
+declare type Locale = 'en-US' | 'pl-PL' | 'sv-SE';
+
+declare type Location_2 = {
+    /**
+     * @description Common address entity that used almost everywhere in Ingrid\'s API.
+     * @type object
+     */
+    address: Address;
+    /**
+     * @description location_external_id - external identifier for the location.
+     * @type string | undefined
+     */
+    location_external_id?: string;
+    /**
+     * @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)
+     * @type string | undefined
+     */
+    location_type?: PickupLocationType;
+    /**
+     * @type object | undefined
+     */
+    operational_hours?: OperationalHours;
+    /**
+     * @description pickup_instructions - instructions for the customer to pick up the parcel.
+     * @type string | undefined
+     */
+    pickup_instructions?: string;
+};
+
+/**
+ * @description To reference an existing location.
+ */
+declare type LocationByRef = {
+    /**
+     * @description External identifier provided by the merchant or carrier.
+     * @type string
+     */
+    external_id: string;
+};
+
+/**
+ * @description To provide full information about the 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 MethodOverrides<T> = {
+    [K in keyof T]?: T[K] extends (...args: any[]) => any ? T[K] | WithDefault<T[K]> : never;
+};
+
+declare type MoleculesConfig = {
+    [K in ParticleType]: BaseParticleDef<K>;
+}[ParticleType][];
+
+declare type OperationalHours = {
+    /**
+     * @type array | undefined
+     */
+    free_text?: string[];
+    /**
+     * @type string | undefined
+     */
+    fri?: string;
+    /**
+     * @type string | undefined
+     */
+    mon?: string;
+    /**
+     * @type string | undefined
+     */
+    sat?: string;
+    /**
+     * @type string | undefined
+     */
+    sun?: string;
+    /**
+     * @type string | undefined
+     */
+    thu?: string;
+    /**
+     * @type string | undefined
+     */
+    tue?: string;
+    /**
+     * @type string | undefined
+     */
+    wed?: string;
+};
+
+declare type Order = {
+    /**
+     * @type string | undefined
+     */
+    access_token?: string;
+    /**
+     * @type string
+     */
+    analytics_id: string;
+    /**
+     * @type object | undefined
+     */
+    cart?: OrderCart;
+    /**
+     * @type string | undefined
+     */
+    external_id?: string;
+    /**
+     * @type array | undefined
+     */
+    items?: DisplayItem[];
+    /**
+     * @type array | undefined
+     */
+    parcels?: Parcel[];
+    /**
+     * @type string | undefined, int64
+     */
+    preselected_parcel_index?: string;
+    /**
+     * @type string | undefined
+     */
+    preselected_parcel_tracking_number?: string;
+    /**
+     * @description sender_name is the name of the sender of the order. This maybe a site name or a merchant name.
+     * @type string | undefined
+     */
+    sender_name?: string;
+    /**
+     * @type string | undefined
+     */
+    site_name?: string;
+};
+
+declare type OrderCart = {
+    /**
+     * @type string | undefined
+     */
+    currency?: string;
+    /**
+     * @type array | undefined
+     */
+    items?: Item[];
+    /**
+     * @type object | undefined
+     */
+    prices?: OrderCartPrices;
+};
+
+declare type OrderCartPrices = {
+    /**
+     * @description ShippingComponents represents the shipping components of the cart.
+     * @type array | undefined
+     */
+    shipping_components?: OrderCartPricesShippingComponent[];
+    /**
+     * @type object | undefined
+     */
+    total?: OrderCartPricesTotals;
+};
+
+declare type OrderCartPricesShippingComponent = {
+    /**
+     * @description Discount represents the discount of the shipping component in cents.
+     * @type integer | undefined, int32
+     */
+    discount?: number;
+    /**
+     * @description Name represents the name of the shipping component. Translated to the given locale.
+     * @type string | undefined
+     */
+    name?: string;
+    /**
+     * @description Price represents the price of the shipping component in cents.
+     * @type integer | undefined, int32
+     */
+    price?: number;
+};
+
+declare type OrderCartPricesTotals = {
+    /**
+     * @description Discount represents the total discount of the cart with a shipping discount included.
+     * @type integer | undefined, int32
+     */
+    discount?: number;
+    /**
+     * @description ItemsDiscount represents the total discount of the cart items in cents.
+     * @type integer | undefined, int32
+     */
+    items_discount?: number;
+    /**
+     * @description ItemsPrice represents the total price of the cart items in cents with items discount applied.
+     * @type integer | undefined, int32
+     */
+    items_price?: number;
+    /**
+     * @description Price represents the total price of the cart in cents with discount and shipping price applied.
+     * @type integer | undefined, int32
+     */
+    price?: number;
+    /**
+     * @description ShippingDiscount represents the total shipping discount of the cart in cents.
+     * @type integer | undefined, int32
+     */
+    shipping_discount?: number;
+    /**
+     * @description ShippingPrice represents the total shipping price of the cart in cents with shipping discount applied.
+     * @type integer | undefined, int32
+     */
+    shipping_price?: number;
+    /**
+     * @description Tax represents the total tax of the cart in cents.
+     * @type integer | undefined, int32
+     */
+    tax?: number;
+};
+
+export declare interface Params {
+    styles?: StyleTokens;
+    dataProviders?: {
+        services?: ServicesOverrides;
+    };
+    token: string;
+    siteId: string;
+    locale: Locale;
+    molecules: MoleculesConfig;
+    env?: 'production' | 'stage' | 'development';
+}
+
+declare type Parcel = {
+    /**
+     * @type array | undefined
+     */
+    alerts?: Alert[];
+    /**
+     * @type string | undefined
+     */
+    carrier?: string;
+    /**
+     * @description Enabled when we\'re not receiving tracking updates.\nLike when the always_show_tracking_links flag is enabled on the carrier product.
+     * @type boolean | undefined
+     */
+    carrier_fallback_enabled?: boolean;
+    /**
+     * @description carrier_link is the link to the carrier\'s tracking.
+     * @type string | undefined
+     */
+    carrier_link?: string;
+    /**
+     * @type string | undefined
+     */
+    carrier_product_id?: string;
+    /**
+     * @type string | undefined
+     */
+    carrier_product_ref?: string;
+    /**
+     * @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;
+    /**
+     * @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
+     */
+    direction_type?: DirectionType;
+    /**
+     * @type string | undefined
+     */
+    display_carrier_name?: string;
+    /**
+     * @type string | undefined
+     */
+    eta?: string;
+    /**
+     * @description Exceptions contains list af all exceptions that happened for a given parcel.
+     * @type array | undefined
+     */
+    exceptions?: ExceptionStatus[];
+    /**
+     * @type integer | undefined, int32
+     */
+    index?: number;
+    /**
+     * @type array | undefined
+     */
+    line_items?: LineItem[];
+    /**
+     * @type object | undefined
+     */
+    location?: Location_2;
+    /**
+     * @type array | undefined
+     */
+    progress?: ProgressItem[];
+    /**
+     * @type string | undefined
+     */
+    requested_shipping_method?: string;
+    /**
+     * @description sender_name is the name of the sender for this parcel.
+     * @type string | undefined
+     */
+    sender_name?: string;
+    /**
+     * @description Deprecated: use carrier_link instead.\nThe logic behind this value changes and the new field will guarantee the graceful switchover.
+     * @type string | undefined
+     */
+    tracking_link?: string;
+    /**
+     * @type string | undefined
+     */
+    tracking_number?: string;
+};
+
+declare type ParticleCustomizationConfig<T extends ParticleType> = ParticleCustomizationConfigMap[T];
+
+declare type ParticleCustomizationConfigMap = {
+    address: AddressParticleParams['customization'];
+    countrySelector: CountrySelectorParams['customization'];
+    delivery: DeliveryParticleParams['customization'];
+    freeShippingIndicator: FreeShippingIndicatorParams['customization'];
+    tracking: TrackingNumberParams['customization'];
+};
+
+declare type ParticleMapType = {
+    address: { readonly validator: typeof addressParticleParamsValidator };
+    countrySelector: { readonly validator: typeof countrySelectorParticleParamsValidator };
+    delivery: { readonly validator: typeof deliveryParticleParamsValidator };
+    freeShippingIndicator: {
+        readonly validator: typeof freeShippingIndicatorParticleParamsValidator;
+    };
+    tracking: { readonly validator: typeof trackingNumberParamsValidator };
+};
+
+declare type ParticleParamsMap = {
+    address: AddressParticleParams;
+    countrySelector: CountrySelectorParams;
+    delivery: DeliveryParticleParams;
+    freeShippingIndicator: FreeShippingIndicatorParams;
+    tracking: TrackingNumberParams;
+};
+
+declare type ParticleType = keyof ParticleMapType;
+
+/**
+ * @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
+ */
+declare type PickupLocationType = PickupLocationTypeEnum;
+
+declare type PickupLocationTypeEnum =
+| 'UNKNOWN_PICKUP_LOCATION_TYPE'
+| 'LOCKER'
+| 'STORE'
+| 'POSTOFFICE'
+| 'MANNED'
+| 'AGE_VERIFICATION';
+
+/**
+ * @description A single address prediction returned by the autocomplete endpoint.
+ */
+declare type Prediction = {
+    /**
+     * @description Opaque identifier. Passed to the details endpoint (if `action` is `resolve`) or back to the autocomplete endpoint as `containerId` (if `action` is `expand`).
+     * @type string
+     */
+    id: string;
+    /**
+     * @description Primary display text (e.g., \"Buckingham Road\").
+     * @type string
+     */
+    label: string;
+    /**
+     * @description Secondary display text providing additional context (e.g., \"Redcar, TS10 3JQ\").
+     * @type string | undefined
+     */
+    secondaryLabel?: string;
+    /**
+     * @description Indicates the client action when the user selects this prediction:\n- `resolve`: Leaf node. Call the details endpoint with this prediction\'s `id`.\n- `expand`: Container node. Call the autocomplete endpoint with `containerId` set to this prediction\'s `id`.
+     */
+    action: PredictionAction;
+    /**
+     * @description If `action` is `expand`, indicates how many child results are inside this container.\nUseful for UI badges (e.g., \"60 Addresses\").
+     * @type integer | undefined, int32
+     */
+    count?: number;
+    /**
+     * @description Semantic type of the result, useful for icon selection in the UI.
+     */
+    type?: PredictionType;
+};
+
+/**
+ * @description Indicates the client action when a user selects a prediction.
+ */
+declare type PredictionAction = PredictionActionEnum;
+
+declare type PredictionActionEnum = 'resolve' | 'expand';
+
+/**
+ * @description Semantic type of the prediction result, useful for icon selection in the UI.
+ */
+declare type PredictionType = PredictionTypeEnum;
+
+declare type PredictionTypeEnum = 'streetAddress' | 'postalCode' | 'locality' | 'premise' | 'street';
+
+declare type PriceLevelsPriceLevel = {
+    /**
+     * @description Indicates if this price level is active.
+     * @type boolean | undefined
+     */
+    active?: boolean;
+    /**
+     * @description Indicates if this is the base price.
+     * @type boolean | undefined
+     */
+    base?: boolean;
+    /**
+     * @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
+     */
+    activation_price?: string;
+    /**
+     * @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
+     */
+    delivery_price?: string;
+};
+
+declare type ProgressItem = {
+    /**
+     * @description Provides a date interval. Depending on a case, `start` and `end` parts are not guaranteed to be present.
+     * @type object | undefined
+     */
+    estimated_time?: DateTimeRange;
+    /**
+     * @type string
+     */
+    step: Step;
+    /**
+     * @type string
+     */
+    time: string;
+};
+
+declare type RawTranslationKey =
+| 'address.address_book.billing.modal.aria.label'
+| 'address.address_book.delivery.modal.aria.label'
+| 'address.confirm'
+| 'address.confirm.billing.aria.label'
+| 'address.confirm.delivery.aria.label'
+| 'address.delete'
+| 'address.delete_confirmation.banner.content'
+| 'address.delete_confirmation.banner.title'
+| 'address.edit'
+| 'address.edit.billing.aria.label'
+| 'address.edit.delivery.aria.label'
+| 'address.error_modal.category_lost.description'
+| 'address.error_modal.category_lost.title'
+| 'address.error_modal.confirm'
+| 'address.error_modal.general.description'
+| 'address.error_modal.general.title'
+| 'address.error_modal.invalid_postal_code.description'
+| 'address.error_modal.invalid_postal_code.title'
+| 'address.error_modal.location_lost.description'
+| 'address.error_modal.location_lost.title'
+| 'address.error_modal.no_options.description'
+| 'address.error_modal.no_options.title'
+| 'address.form.add_address'
+| 'address.form.add_company_data'
+| 'address.form.field.address_details.label'
+| 'address.form.field.address_line.label'
+| 'address.form.field.address_lines.hint'
+| 'address.form.field.address_lines.label'
+| 'address.form.field.apartment_number.label'
+| 'address.form.field.apartment_number.tooltip'
+| 'address.form.field.care_of.label'
+| 'address.form.field.city.label'
+| 'address.form.field.company_name.label'
+| 'address.form.field.country.label'
+| 'address.form.field.customs_number.label'
+| 'address.form.field.email.label'
+| 'address.form.field.email.tooltip'
+| 'address.form.field.first_name.label'
+| 'address.form.field.floor_number.label'
+| 'address.form.field.last_name.label'
+| 'address.form.field.name.label'
+| 'address.form.field.national_id_number.label'
+| 'address.form.field.phone_number.label'
+| 'address.form.field.phone_number.tooltip'
+| 'address.form.field.phone_number_country.label'
+| 'address.form.field.po_box_id.label'
+| 'address.form.field.postal_code.label'
+| 'address.form.field.region.label'
+| 'address.form.field.street.label'
+| 'address.form.field.street_number.label'
+| 'address.form.field.subregion.label'
+| 'address.form.field.vat.label'
+| 'address.form.field.vat_type.label'
+| 'address.form.field_optional'
+| 'address.form.validation.address_line.invalid'
+| 'address.form.validation.phone_number.invalid'
+| 'address.form.validation.postal_code.invalid'
+| 'address.form.validation.region.select_valid_region'
+| 'address.form.validation.street_number.missing'
+| 'address.form.validation.street_number.required'
+| 'address.form.vat_other_country'
+| 'address.list.add_new_address'
+| 'address.list.save_and_continue'
+| 'address.list.title'
+| 'address.save'
+| 'address.save_anyway'
+| 'address.suggestion.address_incorrect.description'
+| 'address.suggestion.address_incorrect.header'
+| 'address.suggestion.street_number.action'
+| 'address.suggestion.street_number.description'
+| 'address.suggestion.street_number.header'
+| 'address.suggestion.suggested_address.action'
+| 'address.suggestion.suggested_address.header'
+| 'address.suggestion_list.show_all'
+| 'address.use_different_address'
+| 'address.validation_modal.billing.aria.label'
+| 'address.validation_modal.delivery.aria.label'
+| 'address.verify.continue_anyway'
+| 'address.verify.continue_with_entered'
+| 'address.verify.edit_entered'
+| 'address.verify.entered'
+| 'address.verify.invalid_address_disclaimer'
+| 'address.verify.similar_address_disclaimer'
+| 'address.verify.suggested'
+| 'address.verify.title'
+| 'address.verify.use_suggested'
+| 'aria.open_popup'
+| 'compound.error_boundary.description'
+| 'compound.error_boundary.retry'
+| 'compound.error_boundary.title'
+| 'compound_footer.logo_alt'
+| 'country.GB'
+| 'country.PL'
+| 'country.SE'
+| 'country.US'
+| 'country_selector.select_country'
+| 'delivery.aria.open_carrier_popup'
+| 'delivery.cannot_load_thumbnail'
+| 'delivery.check_availability'
+| 'delivery.courier_instructions.add_popup_header'
+| 'delivery.courier_instructions.add_trigger'
+| 'delivery.courier_instructions.cancel'
+| 'delivery.courier_instructions.edit'
+| 'delivery.courier_instructions.remove'
+| 'delivery.courier_instructions.save'
+| '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.hide_details'
+| 'delivery.select_carrier'
+| 'delivery.show_details'
+| 'global.add_services'
+| 'global.address'
+| 'global.available_services'
+| 'global.back'
+| 'global.cancel'
+| 'global.change'
+| 'global.close'
+| 'global.continue'
+| 'global.country'
+| 'global.delete'
+| 'global.deliveries'
+| 'global.delivery'
+| 'global.delivery_options'
+| 'global.edit'
+| 'global.free'
+| 'global.loading'
+| 'global.pickup_locations'
+| 'global.postal_code'
+| 'global.save_my_choice'
+| 'global.select_pickup_location'
+| 'global.show'
+| 'global.show_available_services'
+| 'global.validation.invalid'
+| 'global.validation.invalid_email'
+| 'global.validation.max_length'
+| 'global.validation.min_length'
+| 'global.validation.required'
+| 'location_map.default_marker_label'
+| 'location_popup.toggle_map.label'
+| 'pickup_location.hide_opening_hours'
+| 'pickup_location.show_opening_hours'
+| 'pickup_location.walk'
+| 'product_list.first_product_and_more_one'
+| 'product_list.first_product_and_more_other'
+| 'product_list.hide_details'
+| 'product_list.products_one'
+| 'product_list.products_other'
+| 'product_list.quantity'
+| 'product_list.show_details'
+| 'returns.exchange_and_return_title'
+| 'returns.exchange_or_return_promise_days_one'
+| 'returns.exchange_or_return_promise_days_other'
+| 'returns.exchange_promise_days_one'
+| 'returns.exchange_promise_days_other'
+| 'returns.exchange_title'
+| 'returns.free_exchange'
+| 'returns.free_return'
+| 'returns.paid_exchange'
+| 'returns.paid_return'
+| 'returns.return_promise_days_one'
+| 'returns.return_promise_days_other'
+| 'returns.return_title'
+| 'split_delivery.of_total'
+| 'split_delivery.title'
+| 'time.absolute'
+| 'time.friday'
+| 'time.minute_unit_one'
+| 'time.minute_unit_other'
+| 'time.monday'
+| 'time.no_estimated_time'
+| 'time.relative'
+| 'time.relative_range'
+| 'time.saturday'
+| 'time.sunday'
+| 'time.thursday'
+| 'time.tuesday'
+| 'time.wednesday'
+| 'tracking.track_delivery_with';
+
+declare type RecipientContact = {
+    first_name?: string;
+    last_name?: string;
+    contact_id?: string;
+    address: {
+        country_code: string;
+        region_code?: string;
+        postal_code?: string;
+        city?: string;
+        address_lines?: string[];
+    };
+    email?: string;
+    phone_number?: {
+        country_code: string;
+        number: string;
+        extension?: string;
+    };
+};
+
+declare type RecursiveObjectValues<T> = T extends object ? RecursiveObjectValues<T[keyof T]> : T;
+
+declare interface SDKInternal {
+    readonly [_internalBrand]: never;
+}
+
+/**
+ * @description Response containing a list of address predictions from the autocomplete endpoint.
+ */
+declare type SearchAddressesResponse = {
+    /**
+     * @description List of address predictions matching the search query or container expansion.
+     * @type array
+     */
+    predictions: Prediction[];
+};
+
+/**
+ * @description Column contains a list of items displayed in a single section column.
+ */
+declare type SectionColumn = {
+    /**
+     * @description The items within the column.
+     * @type array
+     */
+    items: SectionItem[];
+};
+
+/**
+ * @description Item represents a single piece of information in a section.
+ */
+declare type SectionItem = {
+    /**
+     * @description The URI for the item\'s icon.
+     * @type string | undefined
+     */
+    icon_uri?: string;
+    /**
+     * @description The text description of the item.
+     * @type string | undefined
+     */
+    text?: string;
+    /**
+     * @description The URI for a link associated with the item.
+     * @type string | undefined
+     */
+    link_uri?: string;
+};
+
+declare type Services = {
+    delivery: {
+        getSession: DeliveryService['getSession'];
+    };
+    tracking: {
+        getTrackingData: TrackingService['getTrackingData'];
+    };
+    translations: {
+        formatMessage: TranslationsService['formatMessage'];
+        registerTranslations: TranslationsService['registerTranslations'];
+    };
+    address: {
+        listContactBookEntries: ContactsService['listContactBookEntries'];
+        getContactBookEntry: ContactsService['getContactBookEntry'];
+        upsertContactBookEntry: ContactsService['upsertContactBookEntry'];
+        deleteContactBookEntry: ContactsService['deleteContactBookEntry'];
+        listSuggestions: AddressSuggestionsService['list'];
+        resolveSuggestion: AddressSuggestionsService['resolve'];
+        validateAddress: AddressValidationService['validateAddress'];
+    };
+};
+
+export declare type ServicesOverrides = {
+    [Domain in keyof Services]?: MethodOverrides<Services[Domain]>;
+};
+
+/**
+ * @description Purchase describes purchase experience.
+ */
+declare type SessionPurchase = {
+    /**
+     * @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
+     */
+    total_discount?: string;
+    /**
+     * @description The total value of the purchase after discounts are applied (non-negative, in cents).
+     * @type string | undefined, int64
+     */
+    total_value?: string;
+    /**
+     * @description List of vouchers.
+     * @type array | undefined
+     */
+    vouchers?: string[];
+    /**
+     * @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
+     */
+    locales?: 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.
+ * @default STATE_UNSPECIFIED
+ */
+declare type SessionState = SessionStateEnum;
+
+declare type SessionStateEnum = 'STATE_UNSPECIFIED' | 'ACTIVE' | 'COMPLETED';
+
+/**
+ * @default STEP_UNKNOWN
+ */
+declare type Step = StepEnum;
+
+declare type StepEnum =
+| 'STEP_UNKNOWN'
+| 'STEP_CONFIRMED_BY_MERCHANT'
+| 'STEP_PREPARED_BY_MERCHANT'
+| 'STEP_SUBMITTED_TO_CARRIER'
+| 'STEP_ON_ROUTE'
+| 'STEP_DELIVERED_TO_PICKUP_POINT'
+| 'STEP_DELIVERED_TO_CONSUMER'
+| 'STEP_TERMINATED'
+| 'STEP_SENT_BACK'
+| 'STEP_RETURN_REQUESTED'
+| 'STEP_DELIVERED_TO_MERCHANT'
+| 'STEP_AWAITING_SUPPLIER'
+| 'STEP_LINEHAUL_TO_CARRIER'
+| 'STEP_RETURN_APPROVED'
+| 'STEP_RETURN_DECLINED'
+| 'STEP_RETURN_COMPLETED'
+| 'STEP_REPLACEMENT_SENT'
+| 'STEP_RETURN_CANCELLED';
+
+declare type StyleTokens = Partial<Record<ThemeCssVariables, string>>;
+
+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) }),
+]);
+
+declare type TrackingData = GetTrackingDataResponse;
+
+declare type TrackingNumberParams = {
+    parcelIndex: string;
+    customization?: Record<never, never>;
+};
+
+declare const trackingNumberParamsValidator = z.object({
+    parcelIndex: z.string(),
+    customization: z.object({}).optional(),
+}) satisfies z.ZodType<TrackingNumberParams>;
+
+declare type TrackingService = {
+    getTrackingData: DataResolver<GetTrackingDataArgs, TrackingData>;
+};
+
+declare type TranslationKey = BaseKey<RawTranslationKey>;
+
+declare type TranslationsService = {
+    formatMessage: (locale: Locale, key: TranslationKey, values?: Record<string, unknown>) => string;
+    registerTranslations: (
+    locale: Locale,
+    namespace: string,
+    translations: Record<string, string>
+    ) => void;
+};
+
+/** @public */
+declare interface UpdatableConfig {
+    styles?: StyleTokens;
+}
+
+/**
+ * @description Contact represents generic contact information.
+ */
+declare type V1AlphaAddressContact = {
+    /**
+     * @description The identifier of the contact.
+     * @type string | undefined
+     */
+    contact_id?: string;
+    /**
+     * @description Represents an address suitable for delivery.
+     * @type object
+     */
+    address: AddressAddress;
+    /**
+     * @description The email address of the contact.
+     * @type string | undefined
+     */
+    email?: string;
+    /**
+     * @description A phone number, including region and optional extension.
+     * @type object | undefined
+     */
+    phone_number?: ContactPhoneNumber_2;
+    /**
+     * @description Full name associated with the contact.
+     * @type string | undefined
+     */
+    name?: string;
+    /**
+     * @description First name associated with the contact.
+     * @type string | undefined
+     */
+    first_name?: string;
+    /**
+     * @description Last name associated with the contact.
+     * @type string | undefined
+     */
+    last_name?: string;
+    /**
+     * @description National ID number associated with the contact.
+     * @type string | undefined
+     */
+    national_id_number?: string;
+    /**
+     * @description Company name associated with the contact.
+     * @type string | undefined
+     */
+    company_name?: string;
+    /**
+     * @description VAT number associated with the contact.
+     * @type string | undefined
+     */
+    vat?: string;
+    /**
+     * @description Customs number associated with the contact.
+     * @type string | undefined
+     */
+    customs_number?: string;
+};
+
+/**
+ * @description Represents an address suitable for delivery.
+ */
+declare type V1AlphaDeliveryAddress = {
+    /**
+     * @description \nRefers to a ISO-3166 alpha 2 country code.
+     * @type string
+     */
+    country_code: 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`.
+     * @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;
+    /**
+     * @description The email address of the contact.
+     * @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.
+     * @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[];
+};
+
+/**
+ * @description The request has succeeded.
+ */
+declare type ValidateAddress200 = ValidationResult;
+
+/**
+ * @description The server could not understand the request due to invalid syntax.
+ */
+declare type ValidateAddress400 = AtlasErrorsBadRequestError;
+
+/**
+ * @description Server error
+ */
+declare type ValidateAddress500 = AtlasErrorsServerError;
+
+declare type ValidateAddressMutation = {
+    Response: ValidateAddress200;
+    Request: ValidateAddressMutationRequest;
+    Errors: ValidateAddress400 | ValidateAddress500;
+};
+
+declare type ValidateAddressMutationRequest = ValidateAddressRequest;
+
+/**
+ * @description Request to validate and standardize an address.
+ */
+declare type ValidateAddressRequest = {
+    /**
+     * @description The address to validate against postal reference data.
+     */
+    address: Address_2;
+};
+
+/**
+ * @description Metadata about the quality and granularity of the address match.
+ */
+declare type ValidationAnalysis = {
+    /**
+     * @description How granular the match was against reference data.
+     */
+    verificationLevel: VerificationLevel;
+    /**
+     * @description List of modifications the API made to the original address.
+     * @type array | undefined
+     */
+    changes?: AddressChange[];
+};
+
+/**
+ * @description Result of address validation against postal reference data.\nContains the validation status, a standardized candidate address, match analysis,\nand per-field reports for UI highlighting.
+ */
+declare type ValidationResult = {
+    /**
+     * @description High-level validation status for UI logic:\n- `valid`: High confidence match. Save the `candidate` automatically.\n- `suspect`: Match found but with significant changes. Prompt the user \"Did you mean?\".\n- `invalid`: No deliverable address found. Block submission.
+     */
+    status: ValidationStatus;
+    /**
+     * @description The standardized, corrected address.\nPresent if `status` is `valid` or `suspect`. Absent if `invalid`.
+     */
+    candidate?: Address_2;
+    /**
+     * @description Metadata about the quality of the match.
+     */
+    analysis: ValidationAnalysis;
+    /**
+     * @description Per-field validation status. Keys correspond to address field names.\nUseful for highlighting specific inputs in the UI (e.g., red border on postal code).
+     * @type object | undefined
+     */
+    fieldReports?: object;
+};
+
+/**
+ * @description High-level validation status for UI logic.\nActs as a traffic light for the address validation result.
+ */
+declare type ValidationStatus = ValidationStatusEnum;
+
+declare type ValidationStatusEnum = 'valid' | 'suspect' | 'invalid';
+
+declare const variableNames: {
+    readonly color: {
+        readonly bg: {
+            readonly primary: "color-bg-primary";
+            readonly primaryHover: "color-bg-primaryHover";
+            readonly primarySubtle: "color-bg-primarySubtle";
+            readonly primarySubtleHover: "color-bg-primarySubtleHover";
+            readonly primaryInverse: "color-bg-primaryInverse";
+            readonly primaryInverseHover: "color-bg-primaryInverseHover";
+            readonly secondaryInverse: "color-bg-secondaryInverse";
+            readonly secondaryInverseHover: "color-bg-secondaryInverseHover";
+            readonly primaryInverseSubtle: "color-bg-primaryInverseSubtle";
+            readonly primaryInverseSubtleHover: "color-bg-primaryInverseSubtleHover";
+            readonly primaryDisabled: "color-bg-primaryDisabled";
+            readonly secondary: "color-bg-secondary";
+            readonly secondaryHover: "color-bg-secondaryHover";
+            readonly tertiary: "color-bg-tertiary";
+            readonly tertiaryHover: "color-bg-tertiaryHover";
+            readonly danger: "color-bg-danger";
+            readonly dangerHover: "color-bg-dangerHover";
+            readonly dangerInverse: "color-bg-dangerInverse";
+            readonly dangerInverseHover: "color-bg-dangerInverseHover";
+            readonly dangerInverseSubtle: "color-bg-dangerInverseSubtle";
+            readonly dangerInverseSubtleHover: "color-bg-dangerInverseSubtleHover";
+            readonly dangerDisabled: "color-bg-dangerDisabled";
+            readonly warning: "color-bg-warning";
+            readonly warningHover: "color-bg-warningHover";
+            readonly warningInverse: "color-bg-warningInverse";
+            readonly warningInverseHover: "color-bg-warningInverseHover";
+            readonly warningInverseSubtle: "color-bg-warningInverseSubtle";
+            readonly warningInverseSubtleHover: "color-bg-warningInverseSubtleHover";
+            readonly warningDisabled: "color-bg-warningDisabled";
+            readonly success: "color-bg-success";
+            readonly successHover: "color-bg-successHover";
+            readonly successInverse: "color-bg-successInverse";
+            readonly successInverseHover: "color-bg-successInverseHover";
+            readonly successInverseSubtle: "color-bg-successInverseSubtle";
+            readonly successInverseSubtleHover: "color-bg-successInverseSubtleHover";
+            readonly successDisabled: "color-bg-successDisabled";
+            readonly accent: "color-bg-accent";
+            readonly inactive: "color-bg-inactive";
+            readonly inactiveHover: "color-bg-inactiveHover";
+            readonly inactiveSubtle: "color-bg-inactiveSubtle";
+            readonly inactiveSubtleHover: "color-bg-inactiveSubtleHover";
+            readonly inactiveDisabled: "color-bg-inactiveDisabled";
+            readonly accentHover: "color-bg-accentHover";
+            readonly accentInverse: "color-bg-accentInverse";
+            readonly accentInverseHover: "color-bg-accentInverseHover";
+            readonly accentInverseSubtle: "color-bg-accentInverseSubtle";
+            readonly accentInverseSubtleHover: "color-bg-accentInverseSubtleHover";
+            readonly accentDisabled: "color-bg-accentDisabled";
+            readonly primarySubtleDisabled: "color-bg-primarySubtleDisabled";
+            readonly shadow: "color-bg-shadow";
+        };
+        readonly fg: {
+            readonly primary: "color-fg-primary";
+            readonly primaryHover: "color-fg-primaryHover";
+            readonly primarySubtle: "color-fg-primarySubtle";
+            readonly primarySubtleHover: "color-fg-primarySubtleHover";
+            readonly primaryInverse: "color-fg-primaryInverse";
+            readonly primaryInverseHover: "color-fg-primaryInverseHover";
+            readonly primaryDisabled: "color-fg-primaryDisabled";
+            readonly primaryInverseDisabled: "color-fg-primaryInverseDisabled";
+            readonly secondary: "color-fg-secondary";
+            readonly secondaryHover: "color-fg-secondaryHover";
+            readonly danger: "color-fg-danger";
+            readonly dangerHover: "color-fg-dangerHover";
+            readonly dangerDisabled: "color-fg-dangerDisabled";
+            readonly dangerInverse: "color-fg-dangerInverse";
+            readonly dangerInverseHover: "color-fg-dangerInverseHover";
+            readonly dangerInverseDisabled: "color-fg-dangerInverseDisabled";
+            readonly warning: "color-fg-warning";
+            readonly warningHover: "color-fg-warningHover";
+            readonly warningDisabled: "color-fg-warningDisabled";
+            readonly warningInverse: "color-fg-warningInverse";
+            readonly warningInverseHover: "color-fg-warningInverseHover";
+            readonly warningInverseDisabled: "color-fg-warningInverseDisabled";
+            readonly success: "color-fg-success";
+            readonly successHover: "color-fg-successHover";
+            readonly successDisabled: "color-fg-successDisabled";
+            readonly successInverse: "color-fg-successInverse";
+            readonly successInverseHover: "color-fg-successInverseHover";
+            readonly successInverseDisabled: "color-fg-successInverseDisabled";
+            readonly accent: "color-fg-accent";
+            readonly inactive: "color-fg-inactive";
+            readonly inactiveHover: "color-fg-inactiveHover";
+            readonly inactiveSubtle: "color-fg-inactiveSubtle";
+            readonly inactiveSubtleHover: "color-fg-inactiveSubtleHover";
+            readonly inactiveDisabled: "color-fg-inactiveDisabled";
+            readonly inactiveInverse: "color-fg-inactiveInverse";
+            readonly inactiveInverseHover: "color-fg-inactiveInverseHover";
+            readonly inactiveInverseDisabled: "color-fg-inactiveInverseDisabled";
+            readonly accentHover: "color-fg-accentHover";
+            readonly accentDisabled: "color-fg-accentDisabled";
+            readonly accentInverse: "color-fg-accentInverse";
+            readonly accentInverseHover: "color-fg-accentInverseHover";
+            readonly accentInverseDisabled: "color-fg-accentInverseDisabled";
+            readonly primarySubtleInverse: "color-fg-primarySubtleInverse";
+            readonly primarySubtleInverseHover: "color-fg-primarySubtleInverseHover";
+            readonly primarySubtleDisabled: "color-fg-primarySubtleDisabled";
+        };
+        readonly border: {
+            readonly primary: "color-border-primary";
+            readonly primaryHover: "color-border-primaryHover";
+            readonly primarySubtle: "color-border-primarySubtle";
+            readonly secondary: "color-border-secondary";
+            readonly secondaryHover: "color-border-secondaryHover";
+            readonly primarySubtleHover: "color-border-primarySubtleHover";
+            readonly primaryDisabled: "color-border-primaryDisabled";
+            readonly primaryInverse: "color-border-primaryInverse";
+            readonly danger: "color-border-danger";
+            readonly dangerHover: "color-border-dangerHover";
+            readonly dangerDisabled: "color-border-dangerDisabled";
+            readonly dangerInverse: "color-border-dangerInverse";
+            readonly warning: "color-border-warning";
+            readonly warningHover: "color-border-warningHover";
+            readonly warningDisabled: "color-border-warningDisabled";
+            readonly warningInverse: "color-border-warningInverse";
+            readonly success: "color-border-success";
+            readonly successHover: "color-border-successHover";
+            readonly successDisabled: "color-border-successDisabled";
+            readonly successInverse: "color-border-successInverse";
+            readonly accent: "color-border-accent";
+            readonly inactive: "color-border-inactive";
+            readonly inactiveHover: "color-border-inactiveHover";
+            readonly inactiveSubtle: "color-border-inactiveSubtle";
+            readonly inactiveSubtleHover: "color-border-inactiveSubtleHover";
+            readonly inactiveDisabled: "color-border-inactiveDisabled";
+            readonly accentHover: "color-border-accentHover";
+            readonly accentDisabled: "color-border-accentDisabled";
+            readonly accentInverse: "color-border-accentInverse";
+        };
+    };
+    readonly radii: {
+        readonly '25': "radii-25";
+        readonly '50': "radii-50";
+        readonly '75': "radii-75";
+        readonly '100': "radii-100";
+        readonly '125': "radii-125";
+        readonly '200': "radii-200";
+        readonly '300': "radii-300";
+        readonly none: "radii-none";
+        readonly full: "radii-full";
+    };
+    readonly space: {
+        readonly '0': "space-0";
+        readonly '12': "space-12";
+        readonly '25': "space-25";
+        readonly '50': "space-50";
+        readonly '75': "space-75";
+        readonly '100': "space-100";
+        readonly '150': "space-150";
+        readonly '200': "space-200";
+        readonly '250': "space-250";
+        readonly '300': "space-300";
+    };
+    readonly size: {
+        readonly '0': "size-0";
+        readonly '12': "size-12";
+        readonly '25': "size-25";
+        readonly '50': "size-50";
+        readonly '75': "size-75";
+        readonly '100': "size-100";
+        readonly '150': "size-150";
+        readonly '200': "size-200";
+        readonly '300': "size-300";
+        readonly '350': "size-350";
+        readonly '400': "size-400";
+        readonly '600': "size-600";
+        readonly '800': "size-800";
+        readonly '1000': "size-1000";
+        readonly '1200': "size-1200";
+        readonly '1400': "size-1400";
+        readonly '1500': "size-1500";
+        readonly '1800': "size-1800";
+        readonly '2000': "size-2000";
+        readonly '2100': "size-2100";
+        readonly '3000': "size-3000";
+        readonly '4000': "size-4000";
+        readonly '4500': "size-4500";
+        readonly '6000': "size-6000";
+        readonly '8000': "size-8000";
+        readonly '9000': "size-9000";
+        readonly '12000': "size-12000";
+        readonly full: "size-full";
+    };
+    readonly font: {
+        readonly default: "font-default";
+    };
+    readonly borderWidth: {
+        readonly none: "borderWidth-none";
+        readonly default: "borderWidth-default";
+        readonly thick: "borderWidth-thick";
+        readonly thicker: "borderWidth-thicker";
+    };
+    readonly fontSize: {
+        readonly xsm: "fontSize-xsm";
+        readonly sm: "fontSize-sm";
+        readonly md: "fontSize-md";
+        readonly lg: "fontSize-lg";
+    };
+    readonly letterSpacing: {
+        readonly xsm: "letterSpacing-xsm";
+        readonly sm: "letterSpacing-sm";
+        readonly md: "letterSpacing-md";
+        readonly lg: "letterSpacing-lg";
+    };
+    readonly fontWeight: {
+        readonly regular: "fontWeight-regular";
+        readonly emphasis: "fontWeight-emphasis";
+    };
+    readonly lineHeight: {
+        readonly sm: "lineHeight-sm";
+        readonly md: "lineHeight-md";
+    };
+    readonly opacity: {
+        readonly none: "opacity-none";
+        readonly light: "opacity-light";
+        readonly medium: "opacity-medium";
+        readonly strong: "opacity-strong";
+        readonly full: "opacity-full";
+        readonly xlight: "opacity-xlight";
+    };
+    readonly shadow: {
+        readonly '0': "shadow-0";
+        readonly '50': "shadow-50";
+        readonly '150': "shadow-150";
+    };
+};
+
+/**
+ * @description Granularity of the address match against reference data.
+ */
+declare type VerificationLevel = VerificationLevelEnum;
+
+declare type VerificationLevelEnum = 'premise' | 'street' | 'locality' | 'none';
+
+declare type WithDefault<T extends (...args: any[]) => any> = {
+    readonly __tag: 'withDefault';
+    readonly factory: (defaultFn: T) => T;
+};
+
+export declare const withDefault: <T extends (...args: any[]) => any>(factory: (defaultFn: T) => T) => WithDefault<T>;
+
+export { }