@doswiftly/storefront-sdk 16.1.0 → 18.0.0

package/dist/core/generated/operation-types.d.ts

@@ -72,7 +72,11 @@ export type Attribute = {
     /** Attribute value. Null when the key is set without an associated value. */
     value?: Maybe<Scalars['String']['output']>;
 };
-export type AttributeBillingMode = 'BUNDLED' | 'SEPARATE_LINE';
+export declare const AttributeBillingMode: {
+    readonly Bundled: "BUNDLED";
+    readonly SeparateLine: "SEPARATE_LINE";
+};
+export type AttributeBillingMode = typeof AttributeBillingMode[keyof typeof AttributeBillingMode];
 export type AttributeDefinition = {
     /** Display order */
     displayOrder: Scalars['Int']['output'];
@@ -88,14 +92,19 @@ export type AttributeDefinition = {
     isVisible: Scalars['Boolean']['output'];
     /** Attribute name (e.g., "Color", "Size") */
     name: Scalars['String']['output'];
-    /** Faza 3 Opcja A (2026-05-17): opcjonalne grupowanie atrybutu (np. "inventory", "marketing", "content"). NULL = atrybut bez grupy. Pomaga storefront-devom rozpoznać "te atrybuty są custom dane ERP" vs "te są filtrowalne cechy katalogu". */
+    /** Optional grouping namespace (e.g. "inventory", "marketing", "content"). NULL = ungrouped. Helps distinguish custom ERP-data attributes from filterable catalog facets. */
     namespace?: Maybe<Scalars['String']['output']>;
     /** Range bounds (for NUMBER, CURRENCY) */
     rangeBounds?: Maybe<AttributeRangeBounds>;
     /** Attribute data type */
     type: AttributeType;
 };
-export type AttributeFillingMode = 'BOTH' | 'CUSTOMER' | 'MERCHANT';
+export declare const AttributeFillingMode: {
+    readonly Both: "BOTH";
+    readonly Customer: "CUSTOMER";
+    readonly Merchant: "MERCHANT";
+};
+export type AttributeFillingMode = typeof AttributeFillingMode[keyof typeof AttributeFillingMode];
 export type AttributeFilterValue = {
     /** Option ID or value identifier */
     id: Scalars['ID']['output'];
@@ -113,13 +122,13 @@ export type AttributeFilterValue = {
     value: Scalars['String']['output'];
 };
 export type AttributeFilterValueConnection = {
-    /** Paginated edges z cursorami */
+    /** Paginated edges with cursors */
     edges: Array<AttributeFilterValueEdge>;
     /** Shortcut: edges.map(e => e.node) */
     nodes: Array<AttributeFilterValue>;
     /** Relay pagination info (hasNextPage, hasPreviousPage, cursors) */
     pageInfo: PageInfo;
-    /** Total number of attribute options matching the filter (po zastosowaniu search + context). NIE zmienia się przy paginacji — pokazuje pełną liczbę dla counter UI. */
+    /** Total number of attribute options matching the filter (after applying search + context). Stable across pagination — shows the full count for a counter UI. */
     totalCount: Scalars['Int']['output'];
 };
 export type AttributeFilterValueEdge = {
@@ -134,7 +143,11 @@ export type AttributeInput = {
     /** Attribute value */
     value?: InputMaybe<Scalars['String']['input']>;
 };
-export type AttributeOptionSurchargeType = 'FIXED' | 'PERCENT';
+export declare const AttributeOptionSurchargeType: {
+    readonly Fixed: "FIXED";
+    readonly Percent: "PERCENT";
+};
+export type AttributeOptionSurchargeType = typeof AttributeOptionSurchargeType[keyof typeof AttributeOptionSurchargeType];
 export type AttributeRangeBounds = {
     /** Currency code for CURRENCY type */
     currencyCode?: Maybe<Scalars['String']['output']>;
@@ -184,24 +197,38 @@ export type AttributeSelectionInput = {
 export type AttributeSwatch = {
     /** Hex color code (e.g., #FF5733) */
     colorHex?: Maybe<Scalars['String']['output']>;
-    /** Image URL for pattern swatches */
-    imageUrl?: Maybe<Scalars['String']['output']>;
+    /** Image swatch for pattern/material attributes (e.g. fabric texture, wood grain). Use `image { url(transform: { maxWidth: 80 }) altText }` for small swatch tiles. Mutually meaningful with `colorHex` only when storefront chooses to render texture-over-color preview. */
+    image?: Maybe<Image>;
 };
-export type AttributeType = 'BOOLEAN' | 'CHECKBOX' | 'COLOR' | 'CURRENCY' | 'DATE' | 'FILE' | 'IMAGE' | 'NUMBER' | 'RADIO' | 'SELECT' | 'TEXT' | 'TEXTAREA';
+export declare const AttributeType: {
+    readonly Boolean: "BOOLEAN";
+    readonly Checkbox: "CHECKBOX";
+    readonly Color: "COLOR";
+    readonly Currency: "CURRENCY";
+    readonly Date: "DATE";
+    readonly File: "FILE";
+    readonly Image: "IMAGE";
+    readonly Number: "NUMBER";
+    readonly Radio: "RADIO";
+    readonly Select: "SELECT";
+    readonly Text: "TEXT";
+    readonly Textarea: "TEXTAREA";
+};
+export type AttributeType = typeof AttributeType[keyof typeof AttributeType];
 export type AvailableFilters = {
-    /** Liczba currently applied filters w `currentFilters` (Storefront UI renderuje "Filtry (3)" w sidebar header). */
+    /** Number of currently applied filters in `currentFilters` (render as "Filters (3)" in a sidebar header). */
     activeCount: Scalars['Int']['output'];
     /** Filterable attributes with values */
     attributes: Array<AttributeDefinition>;
-    /** Boolean facet count: liczba produktów w current context spełniających `Product.isAvailable` (przynajmniej jeden aktywny wariant z untracked inventory LUB available>0). Exclude-self: jeśli `available: true` jest w `currentFilters`, count IGNORUJE ten filtr i pokazuje "ile produktów dostępnych w bazowym kontekście" (nie "ile teraz widać"). Spójne semantically z `attributes[].filterValues[].productCount` (per-enum-value facet) i `brands[].productCount` (per-brand facet) — wszystkie używają exclude-self per dimension. Untracked inventory (gift cards, digital, na-zamówienie) zawsze liczy się jako available. */
+    /** Boolean facet count: number of products in the current context that satisfy `Product.isAvailable` (at least one active variant with untracked inventory OR available>0). Exclude-self: if `available: true` is in `currentFilters`, the count IGNORES that filter and shows "how many products are available in the base context" (not "how many are visible right now"). Semantically consistent with `attributes[].filterValues[].productCount` (per-enum-value facet) and `brands[].productCount` (per-brand facet) — all use exclude-self per dimension. Untracked inventory (gift cards, digital, made-to-order) always counts as available. */
     availableCount: Scalars['Int']['output'];
-    /** Faza 3 (2026-05-17): canonical Brand entities z product counts w current context. Storefront UI renderuje checkbox list / dropdown z logo per brand. Klik → `filters: [{brand: {handle}}]`. Tylko brandy z >0 produktów w current product set + isActive=true. */
+    /** Canonical Brand entities with product counts in the current context. Render a checkbox list / dropdown with a logo per brand; clicking maps to `filters: [{brand: {handle}}]`. Only brands with >0 products in the current product set and isActive=true are returned. */
     brands?: Maybe<Array<BrandFilterValue>>;
     /** Categories available for filtering */
     categories?: Maybe<Array<CategoryFilterOption>>;
     /** Price range for filtering */
     priceRange?: Maybe<PriceRange>;
-    /** Total products w current context (categoryId/collectionId/searchQuery) PRZED zaaplikowaniem faceted filters z `currentFilters`. Spójne z `ProductConnection.totalCount` Relay Connection spec — gdy `currentFilters` jest pusty, `AvailableFilters.totalCount` === `products(filters).totalCount`. Użyj do "Wszystkie produkty (N)" w sidebar header. */
+    /** Total products in the current context (categoryId/collectionId/searchQuery) BEFORE applying the faceted filters in `currentFilters`. Consistent with the `ProductConnection.totalCount` Relay Connection spec — when `currentFilters` is empty, `AvailableFilters.totalCount` === `products(filters).totalCount`. Use for "All products (N)" in a sidebar header. */
     totalCount: Scalars['Int']['output'];
 };
 export type AvailablePaymentMethods = {
@@ -356,7 +383,13 @@ export type BlogPostEdge = {
     /** Blog post node */
     node: BlogPost;
 };
-export type BlogPostStatus = 'ARCHIVED' | 'DRAFT' | 'PUBLISHED' | 'SCHEDULED';
+export declare const BlogPostStatus: {
+    readonly Archived: "ARCHIVED";
+    readonly Draft: "DRAFT";
+    readonly Published: "PUBLISHED";
+    readonly Scheduled: "SCHEDULED";
+};
+export type BlogPostStatus = typeof BlogPostStatus[keyof typeof BlogPostStatus];
 export type BlogTag = {
     /** URL-friendly handle */
     handle: Scalars['String']['output'];
@@ -388,8 +421,8 @@ export type Brand = {
     handle: Scalars['String']['output'];
     /** Brand unique identifier */
     id: Scalars['ID']['output'];
-    /** Brand logo URL (CDN-served, storefront-rendered) */
-    logo?: Maybe<Scalars['String']['output']>;
+    /** Brand logo image. Use `logo { url(transform: { maxWidth: 200 }) altText }` for responsive sizing on brand tiles, breadcrumbs, and brand landing pages. */
+    logo?: Maybe<Image>;
     /** Brand display name (e.g. "Funko", "Nintendo") */
     name: Scalars['String']['output'];
 };
@@ -404,15 +437,15 @@ export type BrandColors = {
     secondary?: Maybe<BrandColorGroup>;
 };
 export type BrandFilterValue = {
-    /** Brand handle (refetch payload — paste w ProductFilter.brand.handle) */
+    /** Brand handle (refetch payload — paste into ProductFilter.brand.handle) */
     handle: Scalars['String']['output'];
     /** Brand ID */
     id: Scalars['ID']['output'];
-    /** Brand logo URL (UI rendering) */
-    logo?: Maybe<Scalars['String']['output']>;
+    /** Brand logo image (UI rendering — facet sidebars / dropdowns). Use `logo { url(transform: { maxWidth: 80 }) altText }` for small thumbs. */
+    logo?: Maybe<Image>;
     /** Brand name */
     name: Scalars['String']['output'];
-    /** Liczba produktów z tym brandem w current product set */
+    /** Number of products with this brand in the current product set */
     productCount: Scalars['Int']['output'];
 };
 export type BusinessHour = {
@@ -474,7 +507,7 @@ export type Cart = Node & {
     appliedGiftCards: Array<CartAppliedGiftCard>;
     /** Cart-level custom attributes (free-form key/value). Use for cart-wide metadata such as B2B PO number or marketing source. Replace (not merge) the list with `cartUpdateAttributes`. */
     attributes: Array<CartAttribute>;
-    /** Available payment methods dla tego cart (shop-configured providers) */
+    /** Available payment methods for this cart — deduplicated per type, sorted by merchant priority. */
     availablePaymentMethods: Array<PaymentMethod>;
     /** Shipping methods available for this cart at the given destination. Reads the cart subtotal and weight directly — for pre-cart preview (e.g. a product detail page calculator) use the top-level `availableShippingMethods(address, cart)` query instead. Returns an empty `methods` list plus a `DIGITAL_ONLY_NO_SHIPPING` user error when the cart has no shippable items; the storefront can use this to skip the shipping step entirely. */
     availableShippingMethods: AvailableShippingMethodsPayload;
@@ -508,6 +541,8 @@ export type Cart = Node & {
     recommendations?: Maybe<CartRecommendations>;
     /** True when at least one line in the cart requires physical shipping. False when every line is non-physical (digital, gift card, service, subscription). Use as the single signal to render or skip the shipping step in checkout. */
     requiresShipping: Scalars['Boolean']['output'];
+    /** Optional concrete instrument code selected within `selectedPaymentMethod` (e.g. `"blik"`, `"mb"`, `"154"`). Set when the buyer clicks a specific instrument tile on the storefront (per `PaymentMethod.instruments`). Pre-payment intent: copied to `Order.paymentInstrument` on `cartComplete`. Cross-reference with `availablePaymentMethods.methods[].instruments[]` to resolve `displayName` / `brandImage { url }`. */
+    selectedPaymentInstrument?: Maybe<Scalars['String']['output']>;
     /** The payment method currently selected on the cart. Null until the buyer picks a method via `cartSelectPaymentMethod`. */
     selectedPaymentMethod?: Maybe<PaymentMethod>;
     /** The shipping method currently selected on the cart (label + cost). Null until the buyer picks a method. */
@@ -520,6 +555,8 @@ export type Cart = Node & {
     totalQuantity: Scalars['Int']['output'];
     /** When the cart was last modified (ISO 8601). */
     updatedAt: Scalars['DateTime']['output'];
+    /** Non-fatal advisories computed at query time. Currently emitted: `PAYMENT_SELECTION_STALE` when `selectedPaymentMethod` / `selectedPaymentInstrument` are no longer in live gateway capabilities (storefront re-prompts the buyer). Read-only — backend state is not mutated. */
+    warnings: Array<CartWarning>;
 };
 export type CartAddLinesPayload = {
     /** The updated cart on success; null when `userErrors` is non-empty. */
@@ -619,6 +656,18 @@ export type CartBuyerIdentityInput = {
     /** Buyer phone number. Free-form; max 30 chars. */
     phone?: InputMaybe<Scalars['String']['input']>;
 };
+export type CartClearPaymentSelectionInput = {
+    /** ID of the cart to clear payment selection on. */
+    cartId: Scalars['ID']['input'];
+};
+export type CartClearPaymentSelectionPayload = {
+    /** The updated cart with cleared payment selection. */
+    cart?: Maybe<Cart>;
+    /** Business / validation errors carrying a stable `CartErrorCode` in `code` (e.g. `ALREADY_COMPLETED`). */
+    userErrors: Array<UserError>;
+    /** Non-fatal advisories — the mutation itself succeeded. */
+    warnings: Array<CartWarning>;
+};
 export type CartCompleteInput = {
     /** ID of the cart to complete. */
     cartId: Scalars['ID']['input'];
@@ -814,8 +863,12 @@ export type CartRemoveLinesPayload = {
 export type CartSelectPaymentMethodInput = {
     /** ID of the cart to update. */
     cartId: Scalars['ID']['input'];
-    /** ID of the chosen payment method (matches a `PaymentMethod.id` from `availablePaymentMethods`). */
-    paymentMethodId: Scalars['ID']['input'];
+    /** Category of the payment method the buyer picked (matches `PaymentMethod.type` from `availablePaymentMethods`). */
+    methodType: PaymentMethodType;
+    /** Optional gateway-specific instrument code (`blik`, `mb`, `c`, `154`, ...) from `PaymentMethod.instruments[].code`. Requires `preferredProvider` to be set — instrument codes are provider-specific. No restrictive format is enforced, since different gateways may use `.` / `:` / `/` in future codes. */
+    preferredInstrument?: InputMaybe<Scalars['String']['input']>;
+    /** Optional override of `PaymentMethod.preferredProvider`. Pass a `PaymentProvider` enum value (`PAYU`, `PRZELEWY24`, ...) read off `providersAvailable` / `PaymentInstrument.provider` when the buyer explicitly picks a gateway. Symmetric with the output — forward `instrument.provider` straight back, no case conversion. */
+    preferredProvider?: InputMaybe<PaymentProvider>;
 };
 export type CartSelectPaymentMethodPayload = {
     /** The updated cart with `selectedPaymentMethod` populated. */
@@ -875,7 +928,14 @@ export type CartShippingMethod = {
     /** Display title for the checkout summary (e.g. "DPD Standard, 2 days"). */
     title: Scalars['String']['output'];
 };
-export type CartStatus = 'ABANDONED' | 'ACTIVE' | 'CONVERTED' | 'EXPIRED' | 'RECOVERED';
+export declare const CartStatus: {
+    readonly Abandoned: "ABANDONED";
+    readonly Active: "ACTIVE";
+    readonly Converted: "CONVERTED";
+    readonly Expired: "EXPIRED";
+    readonly Recovered: "RECOVERED";
+};
+export type CartStatus = typeof CartStatus[keyof typeof CartStatus];
 export type CartUpdateAttributesPayload = {
     /** The updated cart on success. */
     cart?: Maybe<Cart>;
@@ -936,7 +996,14 @@ export type CartWarning = {
     /** What the warning is about — a cart line ID when the warning refers to a specific item, or a field path otherwise. */
     target: Scalars['String']['output'];
 };
-export type CartWarningCode = 'MERCHANDISE_NOT_AVAILABLE' | 'MERCHANDISE_NOT_ENOUGH_STOCK' | 'PAYMENTS_AMOUNT_REGION_MISMATCH' | 'SHIPPING_METHOD_AUTO_CLEARED';
+export declare const CartWarningCode: {
+    readonly MerchandiseNotAvailable: "MERCHANDISE_NOT_AVAILABLE";
+    readonly MerchandiseNotEnoughStock: "MERCHANDISE_NOT_ENOUGH_STOCK";
+    readonly PaymentsAmountRegionMismatch: "PAYMENTS_AMOUNT_REGION_MISMATCH";
+    readonly PaymentSelectionStale: "PAYMENT_SELECTION_STALE";
+    readonly ShippingMethodAutoCleared: "SHIPPING_METHOD_AUTO_CLEARED";
+};
+export type CartWarningCode = typeof CartWarningCode[keyof typeof CartWarningCode];
 export type Category = {
     /** Child categories */
     children: Array<Category>;
@@ -1031,8 +1098,16 @@ export type CollectionEdge = {
     /** Collection node */
     node: Collection;
 };
-export type CompensationType = 'REFUND' | 'STORE_CREDIT';
-export type ContentFormat = 'HTML' | 'MARKDOWN';
+export declare const CompensationType: {
+    readonly Refund: "REFUND";
+    readonly StoreCredit: "STORE_CREDIT";
+};
+export type CompensationType = typeof CompensationType[keyof typeof CompensationType];
+export declare const ContentFormat: {
+    readonly Html: "HTML";
+    readonly Markdown: "MARKDOWN";
+};
+export type ContentFormat = typeof ContentFormat[keyof typeof ContentFormat];
 export type ConvertedPriceRange = {
     /** Maximum variant price (converted) */
     maxVariantPrice: PriceMoney;
@@ -1040,20 +1115,59 @@ export type ConvertedPriceRange = {
     minVariantPrice: PriceMoney;
 };
 export type Country = Node & {
-    /** Języki wspierane przez sklep dostępne w tym kraju */
+    /** Shop languages available in this country */
     availableLanguages: Array<Language>;
-    /** Primary currency w tym kraju */
+    /** Primary currency in this country */
     currency: Currency;
-    /** Globally-unique identifier (np. "country:PL") */
+    /** Globally-unique identifier (e.g. "country:PL") */
     id: Scalars['ID']['output'];
     /** ISO 3166-1 alpha-2 country code */
     isoCode: CountryCode;
-    /** English name kraju (np. "Poland", "Germany") */
+    /** English country name (e.g. "Poland", "Germany") */
     name: Scalars['String']['output'];
-    /** System jednostek (metric/imperial) */
+    /** Measurement system (metric/imperial) */
     unitSystem: UnitSystem;
 };
-export type CountryCode = 'AT' | 'AU' | 'BE' | 'BG' | 'CA' | 'CH' | 'CY' | 'CZ' | 'DE' | 'DK' | 'EE' | 'ES' | 'FI' | 'FR' | 'GB' | 'GR' | 'HR' | 'HU' | 'IE' | 'IS' | 'IT' | 'LI' | 'LT' | 'LU' | 'LV' | 'MT' | 'NL' | 'NO' | 'NZ' | 'PL' | 'PT' | 'RO' | 'SE' | 'SI' | 'SK' | 'US' | 'ZZ';
+export declare const CountryCode: {
+    readonly At: "AT";
+    readonly Au: "AU";
+    readonly Be: "BE";
+    readonly Bg: "BG";
+    readonly Ca: "CA";
+    readonly Ch: "CH";
+    readonly Cy: "CY";
+    readonly Cz: "CZ";
+    readonly De: "DE";
+    readonly Dk: "DK";
+    readonly Ee: "EE";
+    readonly Es: "ES";
+    readonly Fi: "FI";
+    readonly Fr: "FR";
+    readonly Gb: "GB";
+    readonly Gr: "GR";
+    readonly Hr: "HR";
+    readonly Hu: "HU";
+    readonly Ie: "IE";
+    readonly Is: "IS";
+    readonly It: "IT";
+    readonly Li: "LI";
+    readonly Lt: "LT";
+    readonly Lu: "LU";
+    readonly Lv: "LV";
+    readonly Mt: "MT";
+    readonly Nl: "NL";
+    readonly No: "NO";
+    readonly Nz: "NZ";
+    readonly Pl: "PL";
+    readonly Pt: "PT";
+    readonly Ro: "RO";
+    readonly Se: "SE";
+    readonly Si: "SI";
+    readonly Sk: "SK";
+    readonly Us: "US";
+    readonly Zz: "ZZ";
+};
+export type CountryCode = typeof CountryCode[keyof typeof CountryCode];
 export type Currency = {
     /** ISO 4217 currency code */
     code: CurrencyCode;
@@ -1066,7 +1180,176 @@ export type Currency = {
     /** Symbol position relative to amount */
     symbolPosition: CurrencySymbolPosition;
 };
-export type CurrencyCode = 'AED' | 'AFN' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BMD' | 'BND' | 'BOB' | 'BOV' | 'BRL' | 'BSD' | 'BTN' | 'BWP' | 'BYN' | 'BZD' | 'CAD' | 'CDF' | 'CHE' | 'CHF' | 'CHW' | 'CLF' | 'CLP' | 'CNY' | 'COP' | 'COU' | 'CRC' | 'CUC' | 'CUP' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EGP' | 'ERN' | 'ETB' | 'EUR' | 'FJD' | 'FKP' | 'GBP' | 'GEL' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KPW' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MRU' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MXV' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SEK' | 'SGD' | 'SHP' | 'SLE' | 'SOS' | 'SRD' | 'SSP' | 'STN' | 'SVC' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'USN' | 'UYI' | 'UYU' | 'UYW' | 'UZS' | 'VED' | 'VES' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XCD' | 'XOF' | 'XPF' | 'XXX' | 'YER' | 'ZAR' | 'ZMW' | 'ZWG';
+export declare const CurrencyCode: {
+    readonly Aed: "AED";
+    readonly Afn: "AFN";
+    readonly All: "ALL";
+    readonly Amd: "AMD";
+    readonly Ang: "ANG";
+    readonly Aoa: "AOA";
+    readonly Ars: "ARS";
+    readonly Aud: "AUD";
+    readonly Awg: "AWG";
+    readonly Azn: "AZN";
+    readonly Bam: "BAM";
+    readonly Bbd: "BBD";
+    readonly Bdt: "BDT";
+    readonly Bgn: "BGN";
+    readonly Bhd: "BHD";
+    readonly Bif: "BIF";
+    readonly Bmd: "BMD";
+    readonly Bnd: "BND";
+    readonly Bob: "BOB";
+    readonly Bov: "BOV";
+    readonly Brl: "BRL";
+    readonly Bsd: "BSD";
+    readonly Btn: "BTN";
+    readonly Bwp: "BWP";
+    readonly Byn: "BYN";
+    readonly Bzd: "BZD";
+    readonly Cad: "CAD";
+    readonly Cdf: "CDF";
+    readonly Che: "CHE";
+    readonly Chf: "CHF";
+    readonly Chw: "CHW";
+    readonly Clf: "CLF";
+    readonly Clp: "CLP";
+    readonly Cny: "CNY";
+    readonly Cop: "COP";
+    readonly Cou: "COU";
+    readonly Crc: "CRC";
+    readonly Cuc: "CUC";
+    readonly Cup: "CUP";
+    readonly Cve: "CVE";
+    readonly Czk: "CZK";
+    readonly Djf: "DJF";
+    readonly Dkk: "DKK";
+    readonly Dop: "DOP";
+    readonly Dzd: "DZD";
+    readonly Egp: "EGP";
+    readonly Ern: "ERN";
+    readonly Etb: "ETB";
+    readonly Eur: "EUR";
+    readonly Fjd: "FJD";
+    readonly Fkp: "FKP";
+    readonly Gbp: "GBP";
+    readonly Gel: "GEL";
+    readonly Ghs: "GHS";
+    readonly Gip: "GIP";
+    readonly Gmd: "GMD";
+    readonly Gnf: "GNF";
+    readonly Gtq: "GTQ";
+    readonly Gyd: "GYD";
+    readonly Hkd: "HKD";
+    readonly Hnl: "HNL";
+    readonly Htg: "HTG";
+    readonly Huf: "HUF";
+    readonly Idr: "IDR";
+    readonly Ils: "ILS";
+    readonly Inr: "INR";
+    readonly Iqd: "IQD";
+    readonly Irr: "IRR";
+    readonly Isk: "ISK";
+    readonly Jmd: "JMD";
+    readonly Jod: "JOD";
+    readonly Jpy: "JPY";
+    readonly Kes: "KES";
+    readonly Kgs: "KGS";
+    readonly Khr: "KHR";
+    readonly Kmf: "KMF";
+    readonly Kpw: "KPW";
+    readonly Krw: "KRW";
+    readonly Kwd: "KWD";
+    readonly Kyd: "KYD";
+    readonly Kzt: "KZT";
+    readonly Lak: "LAK";
+    readonly Lbp: "LBP";
+    readonly Lkr: "LKR";
+    readonly Lrd: "LRD";
+    readonly Lsl: "LSL";
+    readonly Lyd: "LYD";
+    readonly Mad: "MAD";
+    readonly Mdl: "MDL";
+    readonly Mga: "MGA";
+    readonly Mkd: "MKD";
+    readonly Mmk: "MMK";
+    readonly Mnt: "MNT";
+    readonly Mop: "MOP";
+    readonly Mru: "MRU";
+    readonly Mur: "MUR";
+    readonly Mvr: "MVR";
+    readonly Mwk: "MWK";
+    readonly Mxn: "MXN";
+    readonly Mxv: "MXV";
+    readonly Myr: "MYR";
+    readonly Mzn: "MZN";
+    readonly Nad: "NAD";
+    readonly Ngn: "NGN";
+    readonly Nio: "NIO";
+    readonly Nok: "NOK";
+    readonly Npr: "NPR";
+    readonly Nzd: "NZD";
+    readonly Omr: "OMR";
+    readonly Pab: "PAB";
+    readonly Pen: "PEN";
+    readonly Pgk: "PGK";
+    readonly Php: "PHP";
+    readonly Pkr: "PKR";
+    readonly Pln: "PLN";
+    readonly Pyg: "PYG";
+    readonly Qar: "QAR";
+    readonly Ron: "RON";
+    readonly Rsd: "RSD";
+    readonly Rub: "RUB";
+    readonly Rwf: "RWF";
+    readonly Sar: "SAR";
+    readonly Sbd: "SBD";
+    readonly Scr: "SCR";
+    readonly Sdg: "SDG";
+    readonly Sek: "SEK";
+    readonly Sgd: "SGD";
+    readonly Shp: "SHP";
+    readonly Sle: "SLE";
+    readonly Sos: "SOS";
+    readonly Srd: "SRD";
+    readonly Ssp: "SSP";
+    readonly Stn: "STN";
+    readonly Svc: "SVC";
+    readonly Syp: "SYP";
+    readonly Szl: "SZL";
+    readonly Thb: "THB";
+    readonly Tjs: "TJS";
+    readonly Tmt: "TMT";
+    readonly Tnd: "TND";
+    readonly Top: "TOP";
+    readonly Try: "TRY";
+    readonly Ttd: "TTD";
+    readonly Twd: "TWD";
+    readonly Tzs: "TZS";
+    readonly Uah: "UAH";
+    readonly Ugx: "UGX";
+    readonly Usd: "USD";
+    readonly Usn: "USN";
+    readonly Uyi: "UYI";
+    readonly Uyu: "UYU";
+    readonly Uyw: "UYW";
+    readonly Uzs: "UZS";
+    readonly Ved: "VED";
+    readonly Ves: "VES";
+    readonly Vnd: "VND";
+    readonly Vuv: "VUV";
+    readonly Wst: "WST";
+    readonly Xaf: "XAF";
+    readonly Xcd: "XCD";
+    readonly Xof: "XOF";
+    readonly Xpf: "XPF";
+    readonly Xxx: "XXX";
+    readonly Yer: "YER";
+    readonly Zar: "ZAR";
+    readonly Zmw: "ZMW";
+    readonly Zwg: "ZWG";
+};
+export type CurrencyCode = typeof CurrencyCode[keyof typeof CurrencyCode];
 export type CurrencyConversion = {
     /** Converted amount */
     convertedAmount: Scalars['Float']['output'];
@@ -1087,8 +1370,17 @@ export type CurrencyConversion = {
     /** Rate with margin applied */
     rateWithMargin?: Maybe<Scalars['Float']['output']>;
 };
-export type CurrencyRateSource = 'ECB' | 'FIXER' | 'MANUAL';
-export type CurrencySymbolPosition = 'AFTER' | 'BEFORE';
+export declare const CurrencyRateSource: {
+    readonly Ecb: "ECB";
+    readonly Fixer: "FIXER";
+    readonly Manual: "MANUAL";
+};
+export type CurrencyRateSource = typeof CurrencyRateSource[keyof typeof CurrencyRateSource];
+export declare const CurrencySymbolPosition: {
+    readonly After: "AFTER";
+    readonly Before: "BEFORE";
+};
+export type CurrencySymbolPosition = typeof CurrencySymbolPosition[keyof typeof CurrencySymbolPosition];
 export type Customer = Node & {
     /** Saved address book of the customer (Relay Connection). Use to render an address picker on checkout. */
     addresses: MailingAddressConnection;
@@ -1124,6 +1416,8 @@ export type Customer = Node & {
     phone?: Maybe<Scalars['String']['output']>;
     /** Customer-wide Polish business registry number (REGON, 9 or 14 digits with checksum). */
     regon?: Maybe<Scalars['String']['output']>;
+    /** Expiry of the access token authenticating the current request (ISO 8601). Present only on the authenticated current customer (the `customer` query); null otherwise. Schedule a proactive `customerRefreshToken` before this to keep the session alive. */
+    sessionExpiresAt?: Maybe<Scalars['DateTime']['output']>;
     /** Merchant-assigned segmentation tags (e.g. "vip", "wholesale", "b2b"). Use to customise UI / pricing rules on the storefront. */
     tags: Array<Scalars['String']['output']>;
     /** Customer-wide Polish tax ID (NIP, 10 digits with checksum). Default for new addresses; can be overridden per address via `MailingAddress.taxId`. */
@@ -1243,7 +1537,11 @@ export type CustomerSignupPayload = {
     /** Validation / business errors carrying a stable `CustomerErrorCode` in `code` (e.g. `TAKEN`, `INVALID`, `PASSWORD_TOO_WEAK`, `BAD_DOMAIN`). */
     userErrors: Array<UserError>;
 };
-export type CustomerType = 'COMPANY' | 'INDIVIDUAL';
+export declare const CustomerType: {
+    readonly Company: "COMPANY";
+    readonly Individual: "INDIVIDUAL";
+};
+export type CustomerType = typeof CustomerType[keyof typeof CustomerType];
 export type CustomerUpdateAddressPayload = {
     /** Updated address */
     address?: Maybe<MailingAddress>;
@@ -1264,15 +1562,37 @@ export type DeliveryEstimate = {
     /** Minimum expected delivery time in business days. */
     minDays?: Maybe<Scalars['Int']['output']>;
 };
-export type DeliveryType = 
-/** Courier delivery to the street address — no pickup point required. */
-'HOME'
-/** Automated parcel locker — the buyer collects from a 24/7 self-service machine. */
- | 'LOCKER'
-/** Staffed pickup point / parcel shop — the buyer collects the parcel at a counter. */
- | 'PICKUP_POINT';
-export type DiscountApplicationType = 'BUY_X_GET_Y' | 'FIXED_AMOUNT' | 'FREE_SHIPPING' | 'PERCENTAGE';
-export type DiscountErrorCode = 'CUSTOMER_GROUP_NOT_ELIGIBLE' | 'CUSTOMER_NOT_ELIGIBLE' | 'CUSTOMER_USAGE_LIMIT_REACHED' | 'DISCOUNT_COMBINATION_NOT_ALLOWED' | 'EXPIRED' | 'INACTIVE' | 'MINIMUM_ORDER_NOT_MET' | 'MINIMUM_QUANTITY_NOT_MET' | 'NOT_FOUND' | 'NOT_STARTED' | 'SHOP_NOT_FOUND' | 'USAGE_LIMIT_REACHED';
+export declare const DeliveryType: {
+    /** Courier delivery to the street address — no pickup point required. */
+    readonly Home: "HOME";
+    /** Automated parcel locker — the buyer collects from a 24/7 self-service machine. */
+    readonly Locker: "LOCKER";
+    /** Staffed pickup point / parcel shop — the buyer collects the parcel at a counter. */
+    readonly PickupPoint: "PICKUP_POINT";
+};
+export type DeliveryType = typeof DeliveryType[keyof typeof DeliveryType];
+export declare const DiscountApplicationType: {
+    readonly BuyXGetY: "BUY_X_GET_Y";
+    readonly FixedAmount: "FIXED_AMOUNT";
+    readonly FreeShipping: "FREE_SHIPPING";
+    readonly Percentage: "PERCENTAGE";
+};
+export type DiscountApplicationType = typeof DiscountApplicationType[keyof typeof DiscountApplicationType];
+export declare const DiscountErrorCode: {
+    readonly CustomerGroupNotEligible: "CUSTOMER_GROUP_NOT_ELIGIBLE";
+    readonly CustomerNotEligible: "CUSTOMER_NOT_ELIGIBLE";
+    readonly CustomerUsageLimitReached: "CUSTOMER_USAGE_LIMIT_REACHED";
+    readonly DiscountCombinationNotAllowed: "DISCOUNT_COMBINATION_NOT_ALLOWED";
+    readonly Expired: "EXPIRED";
+    readonly Inactive: "INACTIVE";
+    readonly MinimumOrderNotMet: "MINIMUM_ORDER_NOT_MET";
+    readonly MinimumQuantityNotMet: "MINIMUM_QUANTITY_NOT_MET";
+    readonly NotFound: "NOT_FOUND";
+    readonly NotStarted: "NOT_STARTED";
+    readonly ShopNotFound: "SHOP_NOT_FOUND";
+    readonly UsageLimitReached: "USAGE_LIMIT_REACHED";
+};
+export type DiscountErrorCode = typeof DiscountErrorCode[keyof typeof DiscountErrorCode];
 export type DiscountInfo = {
     /** The discount code as entered. */
     code: Scalars['String']['output'];
@@ -1304,10 +1624,18 @@ export type Domain = {
     host: Scalars['String']['output'];
     /** Whether HTTPS is enforced */
     isSslEnabled: Scalars['Boolean']['output'];
-    /** Full URL z protocol */
+    /** Full URL including protocol */
     url: Scalars['URL']['output'];
 };
-export type EmailMarketingState = 'INVALID' | 'NOT_SUBSCRIBED' | 'PENDING' | 'REDACTED' | 'SUBSCRIBED' | 'UNSUBSCRIBED';
+export declare const EmailMarketingState: {
+    readonly Invalid: "INVALID";
+    readonly NotSubscribed: "NOT_SUBSCRIBED";
+    readonly Pending: "PENDING";
+    readonly Redacted: "REDACTED";
+    readonly Subscribed: "SUBSCRIBED";
+    readonly Unsubscribed: "UNSUBSCRIBED";
+};
+export type EmailMarketingState = typeof EmailMarketingState[keyof typeof EmailMarketingState];
 export type EntityAttributeField = {
     /** AttributeDefinition ID */
     definitionId: Scalars['ID']['output'];
@@ -1350,8 +1678,18 @@ export type Filter = {
     /** Available values for this filter, with product counts */
     values: Array<FilterValue>;
 };
-export type FilterPresentation = 'IMAGE' | 'SWATCH' | 'TEXT';
-export type FilterType = 'BOOLEAN' | 'LIST' | 'PRICE_RANGE';
+export declare const FilterPresentation: {
+    readonly Image: "IMAGE";
+    readonly Swatch: "SWATCH";
+    readonly Text: "TEXT";
+};
+export type FilterPresentation = typeof FilterPresentation[keyof typeof FilterPresentation];
+export declare const FilterType: {
+    readonly Boolean: "BOOLEAN";
+    readonly List: "LIST";
+    readonly PriceRange: "PRICE_RANGE";
+};
+export type FilterType = typeof FilterType[keyof typeof FilterType];
 export type FilterValue = {
     /** Number of products matching this value in current result set */
     count: Scalars['Int']['output'];
@@ -1414,7 +1752,16 @@ export type GiftCardError = {
     /** Human-readable error message */
     message: Scalars['String']['output'];
 };
-export type GiftCardErrorCode = 'ALREADY_USED' | 'CURRENCY_MISMATCH' | 'DISABLED' | 'EXPIRED' | 'INSUFFICIENT_BALANCE' | 'INVALID_CODE_FORMAT' | 'NOT_FOUND';
+export declare const GiftCardErrorCode: {
+    readonly AlreadyUsed: "ALREADY_USED";
+    readonly CurrencyMismatch: "CURRENCY_MISMATCH";
+    readonly Disabled: "DISABLED";
+    readonly Expired: "EXPIRED";
+    readonly InsufficientBalance: "INSUFFICIENT_BALANCE";
+    readonly InvalidCodeFormat: "INVALID_CODE_FORMAT";
+    readonly NotFound: "NOT_FOUND";
+};
+export type GiftCardErrorCode = typeof GiftCardErrorCode[keyof typeof GiftCardErrorCode];
 export type GiftCardLineRecipient = {
     /** Personalised message included with the gift card. */
     message?: Maybe<Scalars['String']['output']>;
@@ -1423,7 +1770,13 @@ export type GiftCardLineRecipient = {
     /** Recipient display name shown in the gift card email. */
     recipientName?: Maybe<Scalars['String']['output']>;
 };
-export type GiftCardStatus = 'ACTIVE' | 'DISABLED' | 'EXPIRED' | 'USED';
+export declare const GiftCardStatus: {
+    readonly Active: "ACTIVE";
+    readonly Disabled: "DISABLED";
+    readonly Expired: "EXPIRED";
+    readonly Used: "USED";
+};
+export type GiftCardStatus = typeof GiftCardStatus[keyof typeof GiftCardStatus];
 export type GiftCardValidatePayload = {
     /** User errors */
     userErrors: Array<UserError>;
@@ -1484,22 +1837,49 @@ export type Language = {
     /** Native language name */
     nativeName: Scalars['String']['output'];
 };
-export type LanguageCode = 'CS' | 'DA' | 'DE' | 'EN' | 'ES' | 'FI' | 'FR' | 'HR' | 'HU' | 'IT' | 'LT' | 'LV' | 'NL' | 'NO' | 'PL' | 'PT' | 'RO' | 'SK' | 'SL' | 'SV' | 'UK';
-export type LanguageDirection = 'LTR' | 'RTL';
+export declare const LanguageCode: {
+    readonly Cs: "CS";
+    readonly Da: "DA";
+    readonly De: "DE";
+    readonly En: "EN";
+    readonly Es: "ES";
+    readonly Fi: "FI";
+    readonly Fr: "FR";
+    readonly Hr: "HR";
+    readonly Hu: "HU";
+    readonly It: "IT";
+    readonly Lt: "LT";
+    readonly Lv: "LV";
+    readonly Nl: "NL";
+    readonly No: "NO";
+    readonly Pl: "PL";
+    readonly Pt: "PT";
+    readonly Ro: "RO";
+    readonly Sk: "SK";
+    readonly Sl: "SL";
+    readonly Sv: "SV";
+    readonly Uk: "UK";
+};
+export type LanguageCode = typeof LanguageCode[keyof typeof LanguageCode];
+export declare const LanguageDirection: {
+    readonly Ltr: "LTR";
+    readonly Rtl: "RTL";
+};
+export type LanguageDirection = typeof LanguageDirection[keyof typeof LanguageDirection];
 export type LinkedVariantSummary = {
-    /** Available stock (stock − active reservations, zawsze ≥ 0). */
+    /** Available stock (stock − active reservations, always ≥ 0). */
     availableStock: Scalars['Int']['output'];
-    /** Variant ID (w tenant DB). */
+    /** Variant ID. */
     id: Scalars['ID']['output'];
-    /** Czy w tej chwili dostępny do zakupu (uwzględnia allowBackorder). */
+    /** Whether currently purchasable (accounts for allowBackorder). */
     isAvailable: Scalars['Boolean']['output'];
     /** Parent product ID. */
     productId: Scalars['ID']['output'];
-    /** SKU jeśli zdefiniowany. */
+    /** SKU when defined. */
     sku?: Maybe<Scalars['String']['output']>;
-    /** Variant name (e.g., "Finiszer Zewnętrzny SD"). */
+    /** Variant name (e.g., "Large / Graphite"). */
     title: Scalars['String']['output'];
-    /** Czy magazyn śledzi stock dla tego wariantu. */
+    /** Whether inventory is tracked for this variant. */
     trackQuantity: Scalars['Boolean']['output'];
 };
 export type LocaleCurrencyMapping = {
@@ -1509,13 +1889,13 @@ export type LocaleCurrencyMapping = {
     locale: Scalars['String']['output'];
 };
 export type Localization = {
-    /** Wszystkie wsparte kraje (z aktywnych shipping zones) */
+    /** All supported countries (from active shipping zones) */
     availableCountries: Array<Country>;
-    /** Wszystkie wsparte języki sklepu */
+    /** All supported shop languages */
     availableLanguages: Array<Language>;
-    /** Aktualny kraj klienta (z `@inContext` lub geo-detection) */
+    /** The customer current country (from `@inContext` or geo-detection) */
     country: Country;
-    /** Aktualny język klienta (z `Accept-Language` lub `@inContext`) */
+    /** The customer current language (from `Accept-Language` or `@inContext`) */
     language: Language;
 };
 export type Location = {
@@ -1576,7 +1956,13 @@ export type LocationEdge = {
     /** The location node */
     node: Location;
 };
-export type LocationType = 'DROPSHIPPER' | 'FULFILLMENT_CENTER' | 'STORE' | 'WAREHOUSE';
+export declare const LocationType: {
+    readonly Dropshipper: "DROPSHIPPER";
+    readonly FulfillmentCenter: "FULFILLMENT_CENTER";
+    readonly Store: "STORE";
+    readonly Warehouse: "WAREHOUSE";
+};
+export type LocationType = typeof LocationType[keyof typeof LocationType];
 export type LoyaltyAction = {
     /** Whether action is enabled */
     isEnabled: Scalars['Boolean']['output'];
@@ -1689,7 +2075,14 @@ export type LoyaltyTier = {
     /** Tier type (null for custom tiers) */
     type?: Maybe<LoyaltyTierType>;
 };
-export type LoyaltyTierType = 'BRONZE' | 'DIAMOND' | 'GOLD' | 'PLATINUM' | 'SILVER';
+export declare const LoyaltyTierType: {
+    readonly Bronze: "BRONZE";
+    readonly Diamond: "DIAMOND";
+    readonly Gold: "GOLD";
+    readonly Platinum: "PLATINUM";
+    readonly Silver: "SILVER";
+};
+export type LoyaltyTierType = typeof LoyaltyTierType[keyof typeof LoyaltyTierType];
 export type LoyaltyTransaction = {
     /** Balance after transaction */
     balanceAfter: Scalars['Int']['output'];
@@ -1722,7 +2115,19 @@ export type LoyaltyTransactionEdge = {
     /** The transaction */
     node: LoyaltyTransaction;
 };
-export type LoyaltyTransactionType = 'ADJUST' | 'EARN_BIRTHDAY' | 'EARN_BONUS' | 'EARN_PURCHASE' | 'EARN_REFERRAL' | 'EARN_REVIEW' | 'EARN_SIGNUP' | 'EXPIRE' | 'REDEEM' | 'REFUND_REVERSAL';
+export declare const LoyaltyTransactionType: {
+    readonly Adjust: "ADJUST";
+    readonly EarnBirthday: "EARN_BIRTHDAY";
+    readonly EarnBonus: "EARN_BONUS";
+    readonly EarnPurchase: "EARN_PURCHASE";
+    readonly EarnReferral: "EARN_REFERRAL";
+    readonly EarnReview: "EARN_REVIEW";
+    readonly EarnSignup: "EARN_SIGNUP";
+    readonly Expire: "EXPIRE";
+    readonly Redeem: "REDEEM";
+    readonly RefundReversal: "REFUND_REVERSAL";
+};
+export type LoyaltyTransactionType = typeof LoyaltyTransactionType[keyof typeof LoyaltyTransactionType];
 export type MailingAddress = Node & {
     /** City / town. */
     city?: Maybe<Scalars['String']['output']>;
@@ -1781,7 +2186,12 @@ export type MailingAddressEdge = {
     /** MailingAddress node */
     node: MailingAddress;
 };
-export type MarketingOptInLevel = 'CONFIRMED_OPT_IN' | 'SINGLE_OPT_IN' | 'UNKNOWN';
+export declare const MarketingOptInLevel: {
+    readonly ConfirmedOptIn: "CONFIRMED_OPT_IN";
+    readonly SingleOptIn: "SINGLE_OPT_IN";
+    readonly Unknown: "UNKNOWN";
+};
+export type MarketingOptInLevel = typeof MarketingOptInLevel[keyof typeof MarketingOptInLevel];
 export type Menu = {
     /** URL handle (e.g., main-menu, footer) */
     handle: Scalars['String']['output'];
@@ -1811,7 +2221,19 @@ export type MenuItem = {
     url?: Maybe<Scalars['URL']['output']>;
 };
 export type MenuItemResource = Brand | Category | Collection | Product | ShopPage;
-export type MenuItemType = 'BLOG' | 'BRAND' | 'CATALOG' | 'CATEGORY' | 'COLLECTION' | 'FRONTPAGE' | 'HTTP' | 'PAGE' | 'PRODUCT' | 'SEARCH';
+export declare const MenuItemType: {
+    readonly Blog: "BLOG";
+    readonly Brand: "BRAND";
+    readonly Catalog: "CATALOG";
+    readonly Category: "CATEGORY";
+    readonly Collection: "COLLECTION";
+    readonly Frontpage: "FRONTPAGE";
+    readonly Http: "HTTP";
+    readonly Page: "PAGE";
+    readonly Product: "PRODUCT";
+    readonly Search: "SEARCH";
+};
+export type MenuItemType = typeof MenuItemType[keyof typeof MenuItemType];
 export type Money = {
     /** Amount as a decimal string in major currency units (e.g. "12.99"). String, not float — preserves precision across locales. */
     amount: Scalars['Decimal']['output'];
@@ -1823,6 +2245,8 @@ export type Mutation = {
     cartAddLines: CartAddLinesPayload;
     /** Apply a gift card to the cart by full code. The card is debited at `cartComplete`. Rate-limited to 5 requests per minute per IP+shop (gift card codes form a finite enumerable space). */
     cartApplyGiftCard: CartApplyGiftCardPayload;
+    /** Clear all payment selection state on the cart in a single atomic operation. Use for accordion "back to method picker" flows in the storefront UI. Idempotent — calling twice yields the same end state. The cart must be `ACTIVE` (CONVERTED carts reject with `ALREADY_COMPLETED`). */
+    cartClearPaymentSelection: CartClearPaymentSelectionPayload;
     /** Finalise the cart into an `Order`. The cart is locked and no longer accepts mutations. Payment is initiated separately via `paymentCreate` — check `order.canCreatePayment` to decide whether to render a "Pay now" button or send the buyer directly to the confirmation page (for offline methods such as cash on delivery). Rate-limited to 5 requests per minute per IP+shop; pass an `idempotencyKey` to guard against duplicate orders on retry. */
     cartComplete: CartCompletePayload;
     /** Create a new cart. All fields on `input` are optional — call with no input to create an empty cart, or pass initial lines, buyer identity, attributes, discount codes, email and a shipping address to skip the corresponding follow-up calls. */
@@ -1833,7 +2257,7 @@ export type Mutation = {
     cartRemoveGiftCard: CartRemoveGiftCardPayload;
     /** Remove one or more lines from the cart by `CartLine.id`. Equivalent to `cartUpdateLines` with `quantity: 0` but lets the storefront express the intent explicitly. */
     cartRemoveLines: CartRemoveLinesPayload;
-    /** Select a payment method on the cart. Validates against the active shop payment methods and currency. The selection is finalised at `cartComplete`; payment itself is initiated via a separate `paymentCreate` mutation after the order is created. */
+    /** Select a payment method on the cart by category (BLIK, CARD, BANK_TRANSFER, ...). Backend resolves the preferred provider from `MerchantPaymentConfig` at `paymentCreate` time. Optional `preferredProvider` overrides the merchant priority when the buyer explicitly picks a gateway from `PaymentMethod.providersAvailable`. Optional `preferredInstrument` enables instrument-level deep-link na gateway hosted page (BLIK ekran, mBank flow, etc.) — wymaga `preferredProvider`. */
     cartSelectPaymentMethod: CartSelectPaymentMethodPayload;
     /** Select a shipping method on the cart. Validates the method against the cart contents and the shipping address (must be eligible for the destination, and a pickup point must be set when the method delivers to a locker / collection point). Updates `cost.totalShipping` and the grand total. */
     cartSelectShippingMethod: CartSelectShippingMethodPayload;
@@ -1931,7 +2355,7 @@ export type Order = Node & {
     lineItems: OrderLineItemConnection;
     /** Human-readable order number shown to the buyer and the merchant (e.g. "1042"). Distinct from `id`. */
     orderNumber: Scalars['String']['output'];
-    /** Category of the payment method on the order (CARD, BLIK, BANK_TRANSFER, CASH_ON_DELIVERY, OTHER). Use to drive iconography and copy on the confirmation page (e.g. show the card icon for CARD, the BLIK logo for BLIK). */
+    /** Category of the payment method on the order (CARD, BLIK, BANK_TRANSFER, INSTALLMENT, WALLET, CASH_ON_DELIVERY, OTHER). Use to drive iconography and copy on the confirmation page (e.g. show the card icon for CARD, the BLIK logo for BLIK, the wallet icon for WALLET — Apple Pay / Google Pay). */
     paymentMethodType: PaymentMethodType;
     /** Payment progress (UNPAID, PENDING, AUTHORIZED, PAID, PARTIALLY_PAID, PARTIALLY_REFUNDED, REFUNDED, FAILED, CHARGEBACK, VOIDED, REFUND_PENDING). */
     paymentStatus: OrderPaymentStatus;
@@ -1962,23 +2386,33 @@ export type OrderEdge = {
     /** Order node */
     node: Order;
 };
-export type OrderFulfillmentStatus = 'DELIVERED' | 'FULFILLED' | 'IN_TRANSIT' | 'LOST' | 'PARTIALLY_FULFILLED' | 'PARTIALLY_RETURNED' | 'RETURNED' | 'UNFULFILLED';
+export declare const OrderFulfillmentStatus: {
+    readonly Delivered: "DELIVERED";
+    readonly Fulfilled: "FULFILLED";
+    readonly InTransit: "IN_TRANSIT";
+    readonly Lost: "LOST";
+    readonly PartiallyFulfilled: "PARTIALLY_FULFILLED";
+    readonly PartiallyReturned: "PARTIALLY_RETURNED";
+    readonly Returned: "RETURNED";
+    readonly Unfulfilled: "UNFULFILLED";
+};
+export type OrderFulfillmentStatus = typeof OrderFulfillmentStatus[keyof typeof OrderFulfillmentStatus];
 export type OrderLineItem = {
     /** Unique identifier */
     id: Scalars['ID']['output'];
-    /** Całkowita cena linii z momentu zakupu (unitPrice × quantity, minor units) */
+    /** Line total captured at purchase time (unitPrice × quantity, minor units) */
     originalTotalPrice: Money;
-    /** Cena jednostkowa z momentu zakupu (minor units, include BUNDLED surcharges) */
+    /** Unit price captured at purchase time (minor units, includes BUNDLED surcharges) */
     originalUnitPrice: Money;
-    /** Ilość zamówiona (snapshot z checkout) */
+    /** Quantity ordered (snapshot from checkout) */
     quantity: Scalars['Int']['output'];
-    /** Ilość już zrealizowana (shipped — per-item fulfillment tracking) */
+    /** Quantity already fulfilled (shipped — per-item fulfillment tracking) */
     quantityFulfilled: Scalars['Int']['output'];
-    /** Ilość pozostała do zwrotu/refund (quantity - returnedQuantity, clamp ≥ 0). Industry-standard semantyka dla refund tracking. */
+    /** Quantity still eligible for return/refund (quantity − returnedQuantity, clamped ≥ 0). Industry-standard semantics for refund tracking. */
     refundableQuantity: Scalars['Int']['output'];
-    /** Nazwa produktu z momentu zakupu (snapshot). NIE live `Product.name` — preserved nawet po edycji produktu (KSeF/invoice compliance). */
+    /** Product name captured at purchase time (snapshot). Not the live `Product.name` — preserved even after the product is edited (invoice compliance). */
     title: Scalars['String']['output'];
-    /** Live wariant produktu (fresh image/price). Null jeśli wariant został usunięty po zakupie — consumer powinien użyć `title` jako fallback. */
+    /** Live product variant (fresh image/price). Null when the variant was deleted after purchase — consumers should fall back to `title`. */
     variant?: Maybe<ProductVariant>;
 };
 export type OrderLineItemConnection = {
@@ -1988,7 +2422,7 @@ export type OrderLineItemConnection = {
     nodes: Array<OrderLineItem>;
     /** Pagination info */
     pageInfo: PageInfo;
-    /** Total count of line items in the order (convention parity z OrderConnection/MailingAddressConnection) */
+    /** Total count of line items in the order (convention parity with OrderConnection/MailingAddressConnection) */
     totalCount: Scalars['Int']['output'];
 };
 export type OrderLineItemEdge = {
@@ -1997,7 +2431,20 @@ export type OrderLineItemEdge = {
     /** Order line item node */
     node: OrderLineItem;
 };
-export type OrderPaymentStatus = 'AUTHORIZED' | 'CHARGEBACK' | 'FAILED' | 'PAID' | 'PARTIALLY_PAID' | 'PARTIALLY_REFUNDED' | 'PENDING' | 'REFUNDED' | 'REFUND_PENDING' | 'UNPAID' | 'VOIDED';
+export declare const OrderPaymentStatus: {
+    readonly Authorized: "AUTHORIZED";
+    readonly Chargeback: "CHARGEBACK";
+    readonly Failed: "FAILED";
+    readonly Paid: "PAID";
+    readonly PartiallyPaid: "PARTIALLY_PAID";
+    readonly PartiallyRefunded: "PARTIALLY_REFUNDED";
+    readonly Pending: "PENDING";
+    readonly Refunded: "REFUNDED";
+    readonly RefundPending: "REFUND_PENDING";
+    readonly Unpaid: "UNPAID";
+    readonly Voided: "VOIDED";
+};
+export type OrderPaymentStatus = typeof OrderPaymentStatus[keyof typeof OrderPaymentStatus];
 export type OrderTotals = {
     /** Order subtotal — items only, before tax, shipping and discounts. */
     subtotal: Money;
@@ -2029,31 +2476,107 @@ export type PaymentCreateInput = {
 export type PaymentCreatePayload = {
     /** The created (or reused) payment session on success; null when `userErrors` is non-empty. */
     payment?: Maybe<PaymentSession>;
-    /** Business / validation errors carrying a stable `PaymentErrorCode` in `code` (e.g. `ORDER_NOT_FOUND`, `ORDER_ALREADY_PAID`, `ORDER_NOT_PAYABLE`, `PAYMENT_PROVIDER_NOT_CONFIGURED`, `RETURN_URL_INVALID`, `PAYMENT_FAILED`). */
+    /** Business / validation errors carrying a stable `PaymentErrorCode` in `code` (e.g. `ORDER_NOT_FOUND`, `ORDER_ALREADY_PAID`, `ORDER_NOT_PAYABLE`, `PAYMENT_PROVIDER_NOT_CONFIGURED`, `RETURN_URL_INVALID`, `PAYMENT_FAILED`, `INSTRUMENT_PRESELECTION_FAILED`). */
     userErrors: Array<UserError>;
-};
-export type PaymentInitiationFlow = 'INSTANT_DIRECT' | 'OFFLINE_MANUAL' | 'ONLINE_EMBEDDED' | 'ONLINE_REDIRECT';
+    /** Non-blocking signals — backend state change context (e.g. instrument auto-cleared, server-side adjustment). Default empty array. Storefront branches per `code` for UI retry hints / analytics events. */
+    warnings: Array<PaymentWarning>;
+};
+export declare const PaymentInitiationFlow: {
+    readonly InstantDirect: "INSTANT_DIRECT";
+    readonly OfflineManual: "OFFLINE_MANUAL";
+    readonly OnlineEmbedded: "ONLINE_EMBEDDED";
+    readonly OnlineRedirect: "ONLINE_REDIRECT";
+};
+export type PaymentInitiationFlow = typeof PaymentInitiationFlow[keyof typeof PaymentInitiationFlow];
+export type PaymentInstrument = {
+    /** Optional brand image (bank logo, wallet icon). Use as tile artwork via `brandImage { url(transform: { maxWidth: 64 }) altText }`. Null when the gateway does not expose one or the instrument has no brand visual (BLIK code). */
+    brandImage?: Maybe<Image>;
+    /** Gateway-specific instrument identifier (PayU: `"blik"`/`"mb"`/`"c"`, P24: numeric ID string `"154"`). Pass as `preferredInstrument` in `cartSelectPaymentMethod`. Stable per provider — the gateway does not renumber. */
+    code: Scalars['String']['output'];
+    /** UX rendering hint — how the storefront should render this instrument (prominent button vs branded tile vs dropdown vs radio). Backend-agnostic mapping to visual treatment. */
+    displayHint: PaymentInstrumentDisplayHint;
+    /** Buyer-facing display name (e.g. "BLIK", "mBank", "ING Bank Śląski", "Apple Pay"). */
+    displayName: Scalars['String']['output'];
+    /** True when the instrument is currently enabled in the gateway live capabilities. The storefront can gray-out the tile when false instead of hiding it (observability for the merchant). */
+    enabled: Scalars['Boolean']['output'];
+    /** Provider that handles this instrument (UPPERCASE enum). Required for cross-provider dedupe (e.g. a BLIK code offered by both PayU and P24 — distinct instruments despite the same method type). */
+    provider: PaymentProvider;
+    /** Semantic type classifying the instrument within the method (BLIK code vs bank vs wallet vs card brand). Storefront-facing dispatch for per-instrument UI components. */
+    type: PaymentInstrumentType;
+};
+export declare const PaymentInstrumentDisplayHint: {
+    readonly BrandedTile: "BRANDED_TILE";
+    readonly DropdownOption: "DROPDOWN_OPTION";
+    readonly ProminentButton: "PROMINENT_BUTTON";
+    readonly RadioOption: "RADIO_OPTION";
+};
+export type PaymentInstrumentDisplayHint = typeof PaymentInstrumentDisplayHint[keyof typeof PaymentInstrumentDisplayHint];
+export declare const PaymentInstrumentType: {
+    readonly Bank: "BANK";
+    readonly BlikCode: "BLIK_CODE";
+    readonly CardBrand: "CARD_BRAND";
+    readonly Other: "OTHER";
+    readonly Wallet: "WALLET";
+};
+export type PaymentInstrumentType = typeof PaymentInstrumentType[keyof typeof PaymentInstrumentType];
 export type PaymentMethod = {
+    /** True when the buyer can actually pick this method right now. False when the resolving gateway is temporarily unavailable (incident/maintenance) or reported the method as disabled. Storefront UI should gray-out the tile when false instead of hiding it — gives merchants observability into routing failures. */
+    available: Scalars['Boolean']['output'];
     /** Optional buyer-facing description shown under the name (e.g. "Pay with your bank app"). */
     description?: Maybe<Scalars['String']['output']>;
-    /** Optional icon URL configured by the merchant. Use as the method tile artwork. */
-    icon?: Maybe<Scalars['String']['output']>;
+    /** Optional icon image configured by the merchant. Use `icon { url(transform: { maxWidth: 64 }) altText }` as the method tile artwork in the payment picker. */
+    icon?: Maybe<Image>;
     /** Stable ID of the payment method. Pass to `cartSelectPaymentMethod` to select it. */
     id: Scalars['ID']['output'];
+    /** Concrete instruments exposed by gateway providers within this method (BLIK code, branded banks, wallets, card brands). Null when no provider exposes granular data for this method. Empty array when a gateway exposes them but all instruments are disabled or removed by post-filtering (cross-provider leak prevention). Render the list and pass `code` as `preferredInstrument` in `cartSelectPaymentMethod` to deep-link the gateway to this screen. */
+    instruments?: Maybe<Array<PaymentInstrument>>;
     /** True when the merchant has marked this method as the default. Pre-select it in the picker. */
     isDefault: Scalars['Boolean']['output'];
     /** Display name configured by the merchant (e.g. "BLIK", "Credit card", "Cash on delivery"). */
     name: Scalars['String']['output'];
     /** Merchant-configured display position — lower values come first in the picker. */
     position: Scalars['Float']['output'];
-    /** Provider code (e.g. "payu", "stripe", "p24", "cash_on_delivery"). Identifies the integration behind the method; do not branch UI on it — use `type` instead. */
-    provider: Scalars['String']['output'];
+    /** Preferred provider (UPPERCASE enum) that the backend will route to when the buyer picks this method type and does not specify `preferredProvider`. Populated only when at least one provider supports the type. */
+    preferredProvider?: Maybe<PaymentProvider>;
+    /** Provider (e.g. `PAYU`, `STRIPE`, `PRZELEWY24`, `CASH_ON_DELIVERY`). Identifies the integration behind the method; do not branch UI on it — use `type` instead. */
+    provider: PaymentProvider;
+    /** Providers (UPPERCASE enum: `PAYU`, `PRZELEWY24`, ...) that can fulfil this method type for the current shop, ordered by merchant priority. Pre-select `preferredProvider`; expose the rest only when the buyer wants to choose explicitly. Single-element array when only one provider supports the type. */
+    providersAvailable?: Maybe<Array<PaymentProvider>>;
     /** ISO 4217 currency codes the method accepts. Null when the method accepts the shop currency without restriction. */
     supportedCurrencies?: Maybe<Array<Scalars['String']['output']>>;
-    /** Category of the method (CARD, BLIK, BANK_TRANSFER, CASH_ON_DELIVERY, OTHER). Drives iconography and copy. */
+    /** Category of the method (CARD, BLIK, BANK_TRANSFER, INSTALLMENT, WALLET, CASH_ON_DELIVERY, OTHER). Drives iconography and copy. */
     type: PaymentMethodType;
-};
-export type PaymentMethodType = 'BANK_TRANSFER' | 'BLIK' | 'CARD' | 'CASH_ON_DELIVERY' | 'OTHER';
+    /** When `available` is false, this enum carries the diagnostic reason (GATEWAY_DOWN, GATEWAY_DISABLED, NO_INSTRUMENTS, CREDENTIALS_INVALID). Null when `available` is true. UI can render context-aware copy ("PayU is temporarily down" vs "Method not configured"). */
+    unavailableReason?: Maybe<PaymentMethodUnavailableReason>;
+};
+export declare const PaymentMethodType: {
+    readonly BankTransfer: "BANK_TRANSFER";
+    readonly Blik: "BLIK";
+    readonly Card: "CARD";
+    readonly CashOnDelivery: "CASH_ON_DELIVERY";
+    readonly Installment: "INSTALLMENT";
+    readonly Other: "OTHER";
+    readonly Wallet: "WALLET";
+};
+export type PaymentMethodType = typeof PaymentMethodType[keyof typeof PaymentMethodType];
+export declare const PaymentMethodUnavailableReason: {
+    readonly CredentialsInvalid: "CREDENTIALS_INVALID";
+    readonly GatewayDisabled: "GATEWAY_DISABLED";
+    readonly GatewayDown: "GATEWAY_DOWN";
+    readonly NoInstruments: "NO_INSTRUMENTS";
+};
+export type PaymentMethodUnavailableReason = typeof PaymentMethodUnavailableReason[keyof typeof PaymentMethodUnavailableReason];
+export declare const PaymentProvider: {
+    readonly BankTransfer: "BANK_TRANSFER";
+    readonly CashOnDelivery: "CASH_ON_DELIVERY";
+    readonly GiftCard: "GIFT_CARD";
+    readonly ManualPayment: "MANUAL_PAYMENT";
+    readonly Payu: "PAYU";
+    readonly Przelewy24: "PRZELEWY24";
+    readonly Stripe: "STRIPE";
+    readonly TestGateway: "TEST_GATEWAY";
+};
+export type PaymentProvider = typeof PaymentProvider[keyof typeof PaymentProvider];
 export type PaymentSession = {
     /** Client secret / token for the in-page payment widget. Populated only when `flow` is ONLINE_EMBEDDED. Treat as sensitive — do not log. */
     clientSecret?: Maybe<Scalars['String']['output']>;
@@ -2073,15 +2596,27 @@ export type PaymentSession = {
     status: OrderPaymentStatus;
 };
 export type PaymentSettings = {
-    /** Country code sklepu — driver dostępności metod płatności */
+    /** Shop country code — drives payment method availability */
     countryCode: CountryCode;
-    /** Primary currency użyty do procesowania płatności */
+    /** Primary currency used to process payments */
     currencyCode: CurrencyCode;
-    /** Waluty displayable on storefront (Money.currencyCode allowlist) */
+    /** Currencies displayable on the storefront (Money.currencyCode allowlist) */
     enabledPresentmentCurrencies: Array<CurrencyCode>;
-    /** Kody aktywnych payment providerów dla tego sklepu (z IntegrationProvider table, type=PAYMENT). Np. ["payu", "cash_on_delivery"]. Storefront-dev używa do warunkowania UI checkout. */
+    /** Codes of the payment providers active for this shop. E.g. ["payu", "cash_on_delivery"]. Use to conditionally render the checkout UI. */
     paymentProviders: Array<Scalars['String']['output']>;
 };
+export type PaymentWarning = {
+    /** Machine-readable code — branch on this to dispatch UI retry hints. Add a new code only when there is a distinct UX response. */
+    code: PaymentWarningCode;
+    /** Pre-translated user-facing message describing what happened (Polish-first per shop locale). */
+    message: Scalars['String']['output'];
+    /** Optional additional hint string for UI dispatch — currently unused for `INSTRUMENT_CLEARED_FOR_RETRY` (semantic encoded in `message`). Reserved for future warning codes (e.g. `SLOW_GATEWAY_RESPONSE` → "Retry in 30s"). */
+    retryHint?: Maybe<Scalars['String']['output']>;
+};
+export declare const PaymentWarningCode: {
+    readonly InstrumentClearedForRetry: "INSTRUMENT_CLEARED_FOR_RETRY";
+};
+export type PaymentWarningCode = typeof PaymentWarningCode[keyof typeof PaymentWarningCode];
 export type PickupPoint = {
     /** Point address as a single human-readable line — show alongside the name on the confirmation page. */
     address?: Maybe<Scalars['String']['output']>;
@@ -2159,11 +2694,11 @@ export type Product = Node & {
     attributes: Array<ProductAttributeDefinition>;
     /** Average rating (1-5) */
     averageRating?: Maybe<Scalars['Float']['output']>;
-    /** Canonical brand entity (Faza 3, 2026-05-17). Resolved via DataLoader (N+1 safe dla list queries). Null gdy product nie ma przypisanego brand_id. */
+    /** Canonical brand entity. Resolved via DataLoader (N+1 safe for list queries). Null when the product has no assigned brand. */
     brand?: Maybe<Brand>;
-    /** Wszystkie kategorie do których produkt należy (M2M przez ProductCategory junction). Posortowane po junction.sortOrder ASC. Empty list gdy produkt nie jest w żadnej kategorii. */
+    /** All categories the product belongs to (M2M via the ProductCategory junction). Sorted by junction.sortOrder ASC. Empty list when the product is in no category. */
     categories: Array<Category>;
-    /** Compare-at price range (Money pair). Null gdy żaden variant nie ma compareAtPrice. */
+    /** Compare-at price range (Money pair). Null when no variant has a compareAtPrice. */
     compareAtPriceRange?: Maybe<ProductPriceRange>;
     /** Opt-in: compare-at price range with conversion transparency. */
     compareAtPriceRangeWithConversion?: Maybe<ConvertedPriceRange>;
@@ -2189,9 +2724,9 @@ export type Product = Node & {
     options: Array<ProductOption>;
     /** Price range (Money pair). Default field — industry-standard schema. */
     priceRange: ProductPriceRange;
-    /** Opt-in: price range with full conversion transparency (exchangeRate, baseCurrency, isConverted). Use dla currency-converter UI gdy customer ma preferred currency inną niż shop base. */
+    /** Opt-in: price range with full conversion transparency (exchangeRate, baseCurrency, isConverted). Use for a currency-converter UI when the customer has a preferred currency different from the shop base. */
     priceRangeWithConversion?: Maybe<ConvertedPriceRange>;
-    /** Domyślna kategoria dla breadcrumb/nav (= categories[0] po sortOrder). Null gdy produkt nie jest w żadnej kategorii. */
+    /** Default category for breadcrumb/nav (= categories[0] by sortOrder). Null when the product is in no category. */
     primaryCategory?: Maybe<Category>;
     /** Similar products recommendations */
     recommendations?: Maybe<ProductRecommendations>;
@@ -2211,9 +2746,9 @@ export type Product = Node & {
     updatedAt: Scalars['DateTime']['output'];
     /** Product variants (Relay Connection) */
     variants: ProductVariantConnection;
-    /** Legacy vendor/brand name (free-text). Preferred: `brand` field (canonical Brand entity, Faza 3). */
+    /** Legacy vendor/brand name (free-text). Preferred: `brand` field (canonical Brand entity). */
     vendor?: Maybe<Scalars['String']['output']>;
-    /** Catalog visibility (Faza 1.5) — PUBLIC | HIDDEN | BUNDLE_ONLY */
+    /** Catalog visibility — PUBLIC | HIDDEN | BUNDLE_ONLY */
     visibility: ProductVisibility;
 };
 export type ProductAttributeDefinition = {
@@ -2257,15 +2792,15 @@ export type ProductAttributeOption = {
     isDefault: Scalars['Boolean']['output'];
     /** Display label shown to customer */
     label: Scalars['String']['output'];
-    /** Summary powiązanego ProductVariant (Faza 1.5). Null gdy option nie ma linkedVariantId albo wariant został usunięty. */
+    /** Summary of the linked ProductVariant. Null when the option has no linkedVariantId or the variant was deleted. */
     linkedVariant?: Maybe<LinkedVariantSummary>;
-    /** Linked ProductVariant ID for component stock decrement (Faza 1.5 — Hidden Products pattern) */
+    /** Linked ProductVariant ID for component stock decrement (hidden-products pattern). */
     linkedVariantId?: Maybe<Scalars['ID']['output']>;
     /** Sort order */
     sortOrder: Scalars['Int']['output'];
-    /** Surcharge amount when selected (FIXED = grosze; PERCENT = thousandths of percent — Faza 2) */
+    /** Surcharge amount when selected (FIXED = minor currency units; PERCENT = thousandths of percent). */
     surchargeAmount?: Maybe<Scalars['Int']['output']>;
-    /** Surcharge type — FIXED | PERCENT (Faza 2) */
+    /** Surcharge type — FIXED | PERCENT. */
     surchargeType?: Maybe<AttributeOptionSurchargeType>;
     /** Internal value (slug-style) */
     value: Scalars['String']['output'];
@@ -2299,7 +2834,12 @@ export type ProductOption = {
     /** Available values, ordered by sortOrder */
     values: Array<ProductOptionValue>;
 };
-export type ProductOptionInputType = 'COLOR_SWATCH' | 'SELECT' | 'TEXT';
+export declare const ProductOptionInputType: {
+    readonly ColorSwatch: "COLOR_SWATCH";
+    readonly Select: "SELECT";
+    readonly Text: "TEXT";
+};
+export type ProductOptionInputType = typeof ProductOptionInputType[keyof typeof ProductOptionInputType];
 export type ProductOptionValue = {
     /** Hex colour for COLOR_SWATCH rendering (e.g. "#FF0000"). Null for other types. */
     colorHex?: Maybe<Scalars['String']['output']>;
@@ -2343,8 +2883,8 @@ export type ProductReview = {
     /** Helpful votes count (upvotes) */
     helpfulCount: Scalars['Int']['output'];
     id: Scalars['ID']['output'];
-    /** Review images */
-    images: Array<Scalars['String']['output']>;
+    /** Review image attachments uploaded by the reviewer. Use `images { url(transform: { maxWidth: 600 }) altText }` for responsive gallery rendering in the review card. */
+    images: Array<Image>;
     /** Is verified purchase */
     isVerifiedPurchase: Scalars['Boolean']['output'];
     productId: Scalars['ID']['output'];
@@ -2370,7 +2910,14 @@ export type ProductReviewEdge = {
     cursor: Scalars['String']['output'];
     node: ProductReview;
 };
-export type ProductTypeEnum = 'DIGITAL' | 'GIFT_CARD' | 'PHYSICAL' | 'SERVICE' | 'SUBSCRIPTION';
+export declare const ProductTypeEnum: {
+    readonly Digital: "DIGITAL";
+    readonly GiftCard: "GIFT_CARD";
+    readonly Physical: "PHYSICAL";
+    readonly Service: "SERVICE";
+    readonly Subscription: "SUBSCRIPTION";
+};
+export type ProductTypeEnum = typeof ProductTypeEnum[keyof typeof ProductTypeEnum];
 export type ProductVariant = {
     /** Variant custom field values (post-Opcja A unified custom fields). */
     attributes: Array<EntityAttributeField>;
@@ -2398,7 +2945,7 @@ export type ProductVariant = {
     sku?: Maybe<Scalars['String']['output']>;
     /** Display position of this variant within the parent product list. Lower values come first. */
     sortOrder?: Maybe<Scalars['Int']['output']>;
-    /** Per-location stock availability. Null for single-location shops. Resolved by StoreAvailabilityResolver with `near`, `locationType`, and `@inContext(preferredLocationId)` support. */
+    /** Per-location stock availability. Null for single-location shops. Resolved per-location with `near`, `locationType`, and `@inContext(preferredLocationId)` support. */
     storeAvailability?: Maybe<StoreAvailabilityConnection>;
     /** Display title of the variant (e.g. "Large / Red"). Composed from the variant options. */
     title: Scalars['String']['output'];
@@ -2421,13 +2968,18 @@ export type ProductVariantEdge = {
     /** Variant node */
     node: ProductVariant;
 };
-export type ProductVisibility = 'BUNDLE_ONLY' | 'HIDDEN' | 'PUBLIC';
+export declare const ProductVisibility: {
+    readonly BundleOnly: "BUNDLE_ONLY";
+    readonly Hidden: "HIDDEN";
+    readonly Public: "PUBLIC";
+};
+export type ProductVisibility = typeof ProductVisibility[keyof typeof ProductVisibility];
 export type Query = {
     /** List of all currencies supported by the system (ECB rates) */
     allSupportedCurrencies: Array<Currency>;
-    /** Paginated + searchable attribute options dla drill-into filter UI (np. dropdown z 800 licencjami + search input). Honors product context z exclude-self per attribute. Sort: COUNT_DESC default (most popular first), LABEL_ASC dla alfabetycznego z polskim collation. */
+    /** Paginated + searchable attribute options for a drill-into filter UI (e.g. a dropdown of 800 licenses + search input). Honors product context with exclude-self per attribute. Sort: COUNT_DESC default (most popular first), LABEL_ASC for alphabetical (Polish collation). */
     attributeOptionsSearch: AttributeFilterValueConnection;
-    /** Payment methods active for the current shop, plus the merchant default. Shop-level — independent of cart contents in this iteration. Fetch once for the checkout payment step. */
+    /** Payment methods active for the current shop, plus the merchant default. Returns one row per `PaymentMethodType` (BLIK, CARD, BANK_TRANSFER, ...) with `providersAvailable` (provider codes sorted by merchant priority) and `preferredProvider` (the head of the list). Shop-level — independent of cart contents. */
     availablePaymentMethods: AvailablePaymentMethods;
     /** Standalone shipping-method preview for an address — does not require a cart. Pass an optional `cart` summary (subtotal, weight, currency) to evaluate price-based / weight-based rules and free-shipping thresholds. For an already-created cart, prefer `cart.availableShippingMethods(address)` — it reads the cart contents directly. */
     availableShippingMethods: AvailableShippingMethodsPayload;
@@ -2447,7 +2999,7 @@ export type Query = {
     cart?: Maybe<Cart>;
     /** Preview whether a discount code is currently applicable to a cart — read-only, no cart side effects. Use for inline feedback while the buyer types a code, before calling `cartDiscountCodesUpdate`. Result depends on the cart subtotal (minimum-order rules) so do not cache aggressively: prefer `fetchPolicy: "network-only"` or include `cart.subtotal` in the cache key. */
     cartValidateDiscountCode: DiscountValidationResult;
-    /** Lista kategorii (Relay Connection) z opcjonalnym filtrem rootsOnly/parentId */
+    /** List of categories (Relay Connection) with optional rootsOnly/parentId filtering */
     categories: CategoryConnection;
     /** Get category by ID or slug */
     category?: Maybe<Category>;
@@ -2477,9 +3029,9 @@ export type Query = {
     giftCardValidate: GiftCardValidatePayload;
     /** Get available languages for this shop */
     languages: Array<Language>;
-    /** Localization context (kraje, języki, aktualny kraj/język klienta) */
+    /** Localization context (countries, languages, the customer current country/language) */
     localization: Localization;
-    /** Fetch a single active location by ID. Returns null when missing, inactive, or owned by another shop (tenant isolation via StorefrontShopGuard). */
+    /** Fetch a single active location by ID. Returns null when missing, inactive, or owned by another shop (tenant isolation enforced server-side). */
     location?: Maybe<Location>;
     /** Paginated locations for the current shop. Supports proximity (`near`), pickup-only filter (`hasPickupEnabled`), and `locationType` filter. */
     locations: LocationConnection;
@@ -2497,7 +3049,7 @@ export type Query = {
     menu?: Maybe<Menu>;
     /** Universal ID-based lookup (Relay Node spec) */
     node?: Maybe<Node>;
-    /** Batch ID-based lookup; same NodeType dla all IDs. Missing/wrong IDs → null entries (preserved length). */
+    /** Batch ID-based lookup; same NodeType for all IDs. Missing/wrong IDs → null entries (preserved length). */
     nodes: Array<Maybe<Node>>;
     /** Fetch a single order by its opaque access token (guest order access without a session). Optional `email` argument enables defense-in-depth: if provided, must match the order buyer email (case-insensitive); on mismatch the query returns null exactly like an invalid token. Rate-limited to 5 requests per minute per IP+shop. Response carries Cache-Control: no-store. */
     orderByToken?: Maybe<Order>;
@@ -2548,7 +3100,16 @@ export type Query = {
     /** Get customer wishlists (requires customer auth) */
     wishlists: WishlistConnection;
 };
-export type RecommendationType = 'CROSS_SELL' | 'FREQUENTLY_BOUGHT_TOGETHER' | 'PERSONALIZED' | 'RECENTLY_VIEWED' | 'SIMILAR' | 'TRENDING' | 'UPSELL';
+export declare const RecommendationType: {
+    readonly CrossSell: "CROSS_SELL";
+    readonly FrequentlyBoughtTogether: "FREQUENTLY_BOUGHT_TOGETHER";
+    readonly Personalized: "PERSONALIZED";
+    readonly RecentlyViewed: "RECENTLY_VIEWED";
+    readonly Similar: "SIMILAR";
+    readonly Trending: "TRENDING";
+    readonly Upsell: "UPSELL";
+};
+export type RecommendationType = typeof RecommendationType[keyof typeof RecommendationType];
 export type RedeemRewardPayload = {
     /** Generated discount code for DISCOUNT type rewards */
     discountCode?: Maybe<Scalars['String']['output']>;
@@ -2646,8 +3207,8 @@ export type ReturnItem = {
     condition?: Maybe<Scalars['String']['output']>;
     /** Item ID */
     id: Scalars['ID']['output'];
-    /** Product image URL */
-    imageUrl?: Maybe<Scalars['String']['output']>;
+    /** Product image at time of return submission. Use `image { url(transform: { maxWidth: ... }) altText }` for responsive thumbnails in the merchant return dashboard. */
+    image?: Maybe<Image>;
     /** Evidence photos */
     photos?: Maybe<Array<ReturnItemPhoto>>;
     /** Product title */
@@ -2685,7 +3246,16 @@ export type ReturnPayload = {
     /** User errors */
     userErrors: Array<UserError>;
 };
-export type ReturnReason = 'BETTER_PRICE' | 'CHANGED_MIND' | 'DAMAGED_SHIPPING' | 'DEFECTIVE' | 'NOT_AS_DESCRIBED' | 'OTHER' | 'WRONG_ITEM';
+export declare const ReturnReason: {
+    readonly BetterPrice: "BETTER_PRICE";
+    readonly ChangedMind: "CHANGED_MIND";
+    readonly DamagedShipping: "DAMAGED_SHIPPING";
+    readonly Defective: "DEFECTIVE";
+    readonly NotAsDescribed: "NOT_AS_DESCRIBED";
+    readonly Other: "OTHER";
+    readonly WrongItem: "WRONG_ITEM";
+};
+export type ReturnReason = typeof ReturnReason[keyof typeof ReturnReason];
 export type ReturnReasonOption = {
     /** Description/help text */
     description?: Maybe<Scalars['String']['output']>;
@@ -2704,7 +3274,25 @@ export type ReturnShippingLabel = {
     /** URL to download the shipping label */
     url: Scalars['String']['output'];
 };
-export type ReturnStatus = 'APPROVED' | 'CANCELLED' | 'COMPLETED' | 'DRAFT' | 'EXCHANGED' | 'EXPIRED' | 'FAILED' | 'INSPECTING' | 'IN_TRANSIT' | 'LABEL_GENERATED' | 'RECEIVED' | 'REFUNDED' | 'REFUND_PENDING' | 'REJECTED' | 'REPLACED' | 'REQUESTED';
+export declare const ReturnStatus: {
+    readonly Approved: "APPROVED";
+    readonly Cancelled: "CANCELLED";
+    readonly Completed: "COMPLETED";
+    readonly Draft: "DRAFT";
+    readonly Exchanged: "EXCHANGED";
+    readonly Expired: "EXPIRED";
+    readonly Failed: "FAILED";
+    readonly Inspecting: "INSPECTING";
+    readonly InTransit: "IN_TRANSIT";
+    readonly LabelGenerated: "LABEL_GENERATED";
+    readonly Received: "RECEIVED";
+    readonly Refunded: "REFUNDED";
+    readonly RefundPending: "REFUND_PENDING";
+    readonly Rejected: "REJECTED";
+    readonly Replaced: "REPLACED";
+    readonly Requested: "REQUESTED";
+};
+export type ReturnStatus = typeof ReturnStatus[keyof typeof ReturnStatus];
 export type ReviewPayload = {
     review?: Maybe<ProductReview>;
     /** User errors */
@@ -2799,8 +3387,8 @@ export type ShipmentEvent = {
 export type ShipmentItem = {
     /** Item ID */
     id: Scalars['ID']['output'];
-    /** Product image URL */
-    imageUrl?: Maybe<Scalars['String']['output']>;
+    /** Live variant image with snapshot fallback. Use `image { url(transform: { maxWidth: 200, preferredContentType: WEBP }) altText }` for responsive thumbnails. Returns `null` when the variant has been deleted since fulfillment — render a placeholder client-side. */
+    image?: Maybe<Image>;
     /** Quantity shipped */
     quantity: Scalars['Int']['output'];
     /** Product SKU */
@@ -2826,7 +3414,18 @@ export type ShipmentPayload = {
     /** User errors */
     userErrors: Array<UserError>;
 };
-export type ShipmentStatus = 'CANCELLED' | 'CREATED' | 'DELIVERED' | 'EXCEPTION' | 'IN_TRANSIT' | 'LABEL_PRINTED' | 'OUT_FOR_DELIVERY' | 'PICKED_UP' | 'RETURNED';
+export declare const ShipmentStatus: {
+    readonly Cancelled: "CANCELLED";
+    readonly Created: "CREATED";
+    readonly Delivered: "DELIVERED";
+    readonly Exception: "EXCEPTION";
+    readonly InTransit: "IN_TRANSIT";
+    readonly LabelPrinted: "LABEL_PRINTED";
+    readonly OutForDelivery: "OUT_FOR_DELIVERY";
+    readonly PickedUp: "PICKED_UP";
+    readonly Returned: "RETURNED";
+};
+export type ShipmentStatus = typeof ShipmentStatus[keyof typeof ShipmentStatus];
 export type ShippingAddressInput = {
     /** City / town. */
     city?: InputMaybe<Scalars['String']['input']>;
@@ -2850,8 +3449,8 @@ export type ShippingAddressInput = {
 export type ShippingCarrier = {
     /** Stable carrier identifier. Null when the method does not map to a registered carrier (e.g. local pickup configured by the merchant). */
     id?: Maybe<Scalars['ID']['output']>;
-    /** URL of the carrier logo. Use for the method tile in the shipping picker. */
-    logoUrl?: Maybe<Scalars['String']['output']>;
+    /** Carrier logo image. Use `logo { url(transform: { maxWidth: 64 }) altText }` for the method tile in the shipping picker. */
+    logo?: Maybe<Image>;
     /** Carrier display name (e.g. "InPost", "DPD", "DHL"). */
     name: Scalars['String']['output'];
     /** Carrier service code as configured by the merchant (e.g. "inpost_paczkomat"). Useful when integrating carrier widgets. */
@@ -2876,7 +3475,7 @@ export type Shop = {
     contactPhone?: Maybe<Scalars['String']['output']>;
     /** Default currency code (ISO 4217) */
     currencyCode: CurrencyCode;
-    /** Customer account URL (login/orders) — z primaryDomain */
+    /** Customer account URL (login/orders) — derived from primaryDomain */
     customerAccountUrl?: Maybe<Scalars['URL']['output']>;
     /** Default language code (ISO 639-1) */
     defaultLanguage?: Maybe<LanguageCode>;
@@ -2890,7 +3489,7 @@ export type Shop = {
     localeToCurrencyMap: Array<LocaleCurrencyMapping>;
     /** Shop logo */
     logo?: Maybe<Image>;
-    /** Money display format z `{{amount}}` placeholder, np. "{{amount}} zł" */
+    /** Money display format with the `{{amount}}` placeholder, e.g. "{{amount}} zł" */
     moneyFormat: Scalars['String']['output'];
     /** Shop name */
     name: Scalars['String']['output'];
@@ -3071,7 +3670,17 @@ export type StoreAvailabilityEdge = {
     /** The availability node */
     node: StoreAvailability;
 };
-export type StorefrontOrderStatus = 'CANCELLED' | 'COMPLETED' | 'CONFIRMED' | 'DRAFT' | 'EXPIRED' | 'ON_HOLD' | 'PENDING' | 'PROCESSING';
+export declare const StorefrontOrderStatus: {
+    readonly Cancelled: "CANCELLED";
+    readonly Completed: "COMPLETED";
+    readonly Confirmed: "CONFIRMED";
+    readonly Draft: "DRAFT";
+    readonly Expired: "EXPIRED";
+    readonly OnHold: "ON_HOLD";
+    readonly Pending: "PENDING";
+    readonly Processing: "PROCESSING";
+};
+export type StorefrontOrderStatus = typeof StorefrontOrderStatus[keyof typeof StorefrontOrderStatus];
 export type SubscribeToMarketingPayload = {
     /** Always true (anti-enumeration). Backend may silently skip enqueue if rate-limited or already SUBSCRIBED. */
     accepted: Scalars['Boolean']['output'];
@@ -3081,8 +3690,8 @@ export type SubscribeToMarketingPayload = {
 export type TierBenefit = {
     /** Benefit description */
     description?: Maybe<Scalars['String']['output']>;
-    /** Benefit icon */
-    icon?: Maybe<Scalars['String']['output']>;
+    /** Benefit icon image. Use `icon { url(transform: { maxWidth: 48 }) altText }` for small visual markers on the tier benefits list. */
+    icon?: Maybe<Image>;
     /** Benefit name */
     name: Scalars['String']['output'];
 };
@@ -3116,7 +3725,11 @@ export type Translations = {
     /** Namespaces with translations */
     namespaces: Array<TranslationNamespace>;
 };
-export type UnitSystem = 'IMPERIAL_SYSTEM' | 'METRIC_SYSTEM';
+export declare const UnitSystem: {
+    readonly ImperialSystem: "IMPERIAL_SYSTEM";
+    readonly MetricSystem: "METRIC_SYSTEM";
+};
+export type UnitSystem = typeof UnitSystem[keyof typeof UnitSystem];
 export type UnsubscribeFromMarketingPayload = {
     /** Always true (anti-enumeration). */
     accepted: Scalars['Boolean']['output'];
@@ -3149,7 +3762,13 @@ export type Weight = {
     /** Weight magnitude, interpreted according to `unit`. */
     value: Scalars['Float']['output'];
 };
-export type WeightUnit = 'GRAMS' | 'KILOGRAMS' | 'OUNCES' | 'POUNDS';
+export declare const WeightUnit: {
+    readonly Grams: "GRAMS";
+    readonly Kilograms: "KILOGRAMS";
+    readonly Ounces: "OUNCES";
+    readonly Pounds: "POUNDS";
+};
+export type WeightUnit = typeof WeightUnit[keyof typeof WeightUnit];
 export type Wishlist = {
     /** Created date */
     createdAt: Scalars['DateTime']['output'];
@@ -3210,8 +3829,18 @@ export type AvailablePaymentMethodsQueryVariables = Exact<{
 }>;
 export type AvailablePaymentMethodsQuery = {
     availablePaymentMethods: {
-        methods: Array<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
-        defaultMethod?: Maybe<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
+        methods: Array<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position' | 'providersAvailable' | 'preferredProvider' | 'available' | 'unavailableReason'> & {
+            icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+            instruments?: Maybe<Array<(Pick<PaymentInstrument, 'provider' | 'code' | 'type' | 'displayName' | 'displayHint' | 'enabled'> & {
+                brandImage?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+            })>>;
+        })>;
+        defaultMethod?: Maybe<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position' | 'providersAvailable' | 'preferredProvider' | 'available' | 'unavailableReason'> & {
+            icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+            instruments?: Maybe<Array<(Pick<PaymentInstrument, 'provider' | 'code' | 'type' | 'displayName' | 'displayHint' | 'enabled'> & {
+                brandImage?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+            })>>;
+        })>;
     };
 };
 export type CartAddLinesMutationVariables = Exact<{
@@ -3220,7 +3849,7 @@ export type CartAddLinesMutationVariables = Exact<{
 }>;
 export type CartAddLinesMutation = {
     cartAddLines: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrument' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3266,7 +3895,9 @@ export type CartAddLinesMutation = {
             selectedShippingMethod?: Maybe<(Pick<CartShippingMethod, 'handle' | 'title'> & {
                 price: Pick<Money, 'amount' | 'currencyCode'>;
             })>;
-            selectedPaymentMethod?: Maybe<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
+            selectedPaymentMethod?: Maybe<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'> & {
+                icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+            })>;
             appliedGiftCards: Array<(Pick<CartAppliedGiftCard, 'id' | 'maskedCode' | 'lastCharacters'> & {
                 appliedAmount: Pick<Money, 'amount' | 'currencyCode'>;
                 remainingBalance: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3282,7 +3913,7 @@ export type CartApplyGiftCardMutationVariables = Exact<{
 }>;
 export type CartApplyGiftCardMutation = {
     cartApplyGiftCard: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrument' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3328,7 +3959,9 @@ export type CartApplyGiftCardMutation = {
             selectedShippingMethod?: Maybe<(Pick<CartShippingMethod, 'handle' | 'title'> & {
                 price: Pick<Money, 'amount' | 'currencyCode'>;
             })>;
-            selectedPaymentMethod?: Maybe<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
+            selectedPaymentMethod?: Maybe<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'> & {
+                icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+            })>;
             appliedGiftCards: Array<(Pick<CartAppliedGiftCard, 'id' | 'maskedCode' | 'lastCharacters'> & {
                 appliedAmount: Pick<Money, 'amount' | 'currencyCode'>;
                 remainingBalance: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3347,7 +3980,9 @@ export type CartAvailableShippingMethodsQuery = {
     cart?: Maybe<(Pick<Cart, 'id' | 'requiresShipping'> & {
         availableShippingMethods: {
             methods: Array<(Pick<AvailableShippingMethod, 'id' | 'name' | 'description' | 'deliveryType' | 'isFree' | 'sortOrder'> & {
-                carrier?: Maybe<Pick<ShippingCarrier, 'id' | 'name' | 'logoUrl' | 'serviceCode'>>;
+                carrier?: Maybe<(Pick<ShippingCarrier, 'id' | 'name' | 'serviceCode'> & {
+                    logo?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+                })>;
                 price: Pick<Money, 'amount' | 'currencyCode'>;
                 estimatedDelivery?: Maybe<Pick<DeliveryEstimate, 'minDays' | 'maxDays' | 'description'>>;
                 freeShippingProgress?: Maybe<(Pick<FreeShippingProgress, 'qualifies' | 'progressPercent' | 'message'> & {
@@ -3365,6 +4000,70 @@ export type CartAvailableShippingMethodsQuery = {
         };
     })>;
 };
+export type CartClearPaymentSelectionMutationVariables = Exact<{
+    input: CartClearPaymentSelectionInput;
+}>;
+export type CartClearPaymentSelectionMutation = {
+    cartClearPaymentSelection: {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrument' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+            cost: {
+                total: Pick<Money, 'amount' | 'currencyCode'>;
+                subtotal: Pick<Money, 'amount' | 'currencyCode'>;
+                totalTax?: Maybe<Pick<Money, 'amount' | 'currencyCode'>>;
+                totalDuty?: Maybe<Pick<Money, 'amount' | 'currencyCode'>>;
+                checkoutCharge?: Maybe<Pick<Money, 'amount' | 'currencyCode'>>;
+                totalDiscount: Pick<Money, 'amount' | 'currencyCode'>;
+                totalShipping?: Maybe<Pick<Money, 'amount' | 'currencyCode'>>;
+            };
+            lines: (Pick<CartLineConnection, 'totalCount'> & {
+                nodes: Array<(Pick<CartLine, 'id' | 'quantity' | 'productId' | 'productTitle' | 'productHandle' | 'productType' | 'requiresShipping'> & {
+                    variant: (Pick<ProductVariant, 'id' | 'title' | 'sku' | 'isAvailable' | 'availableStock' | 'barcode' | 'sortOrder'> & {
+                        price: Pick<Money, 'amount' | 'currencyCode'>;
+                        compareAtPrice?: Maybe<Pick<Money, 'amount' | 'currencyCode'>>;
+                        image?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+                        selectedOptions: Array<Pick<SelectedOption, 'name' | 'value'>>;
+                        weight?: Maybe<Pick<Weight, 'value' | 'unit'>>;
+                    });
+                    cost: {
+                        pricePerUnit: Pick<Money, 'amount' | 'currencyCode'>;
+                        subtotal: Pick<Money, 'amount' | 'currencyCode'>;
+                        total: Pick<Money, 'amount' | 'currencyCode'>;
+                        compareAtPricePerUnit?: Maybe<Pick<Money, 'amount' | 'currencyCode'>>;
+                    };
+                    attributes: Array<Pick<Attribute, 'key' | 'value'>>;
+                    attributeSelections: Array<Pick<AttributeSelection, 'attributeDefinitionId' | 'attributeName' | 'type' | 'fillingMode' | 'billingMode' | 'optionId' | 'optionLabel' | 'optionIds' | 'textValue' | 'surchargeAmount' | 'surchargeType' | 'taxClassId' | 'linkedVariantId'>>;
+                    giftCardRecipient?: Maybe<Pick<GiftCardLineRecipient, 'recipientEmail' | 'recipientName' | 'message'>>;
+                })>;
+                pageInfo: Pick<PageInfo, 'hasNextPage' | 'hasPreviousPage' | 'startCursor' | 'endCursor'>;
+            });
+            buyerIdentity?: Maybe<Pick<CartBuyerIdentity, 'email' | 'phone' | 'countryCode'>>;
+            discountCodes: Array<Pick<CartDiscountCode, 'code' | 'isApplicable'>>;
+            discountAllocations: Array<(Pick<CartDiscountAllocation, 'discountCode'> & {
+                amount: Pick<Money, 'amount' | 'currencyCode'>;
+            })>;
+            attributes: Array<Pick<CartAttribute, 'key' | 'value'>>;
+            shippingAddress?: Maybe<(Pick<MailingAddress, 'id' | 'firstName' | 'lastName' | 'name' | 'company' | 'streetLine1' | 'streetLine2' | 'city' | 'state' | 'stateCode' | 'country' | 'countryCode' | 'postalCode' | 'phone' | 'isDefault' | 'taxId' | 'vatNumber'> & {
+                pickupPoint?: Maybe<Pick<PickupPoint, 'provider' | 'pointId' | 'name' | 'address'>>;
+            })>;
+            billingAddress?: Maybe<(Pick<MailingAddress, 'id' | 'firstName' | 'lastName' | 'name' | 'company' | 'streetLine1' | 'streetLine2' | 'city' | 'state' | 'stateCode' | 'country' | 'countryCode' | 'postalCode' | 'phone' | 'isDefault' | 'taxId' | 'vatNumber'> & {
+                pickupPoint?: Maybe<Pick<PickupPoint, 'provider' | 'pointId' | 'name' | 'address'>>;
+            })>;
+            selectedShippingMethod?: Maybe<(Pick<CartShippingMethod, 'handle' | 'title'> & {
+                price: Pick<Money, 'amount' | 'currencyCode'>;
+            })>;
+            selectedPaymentMethod?: Maybe<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'> & {
+                icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+            })>;
+            appliedGiftCards: Array<(Pick<CartAppliedGiftCard, 'id' | 'maskedCode' | 'lastCharacters'> & {
+                appliedAmount: Pick<Money, 'amount' | 'currencyCode'>;
+                remainingBalance: Pick<Money, 'amount' | 'currencyCode'>;
+            })>;
+            completedOrder?: Maybe<Pick<Order, 'id' | 'orderNumber' | 'accessToken' | 'status' | 'paymentStatus' | 'fulfillmentStatus'>>;
+        })>;
+        userErrors: Array<Pick<UserError, 'message' | 'code' | 'field'>>;
+        warnings: Array<Pick<CartWarning, 'message' | 'code' | 'target'>>;
+    };
+};
 export type CartCompleteMutationVariables = Exact<{
     input: CartCompleteInput;
 }>;
@@ -3390,7 +4089,7 @@ export type CartCreateMutationVariables = Exact<{
 }>;
 export type CartCreateMutation = {
     cartCreate: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrument' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3436,7 +4135,9 @@ export type CartCreateMutation = {
             selectedShippingMethod?: Maybe<(Pick<CartShippingMethod, 'handle' | 'title'> & {
                 price: Pick<Money, 'amount' | 'currencyCode'>;
             })>;
-            selectedPaymentMethod?: Maybe<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
+            selectedPaymentMethod?: Maybe<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'> & {
+                icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+            })>;
             appliedGiftCards: Array<(Pick<CartAppliedGiftCard, 'id' | 'maskedCode' | 'lastCharacters'> & {
                 appliedAmount: Pick<Money, 'amount' | 'currencyCode'>;
                 remainingBalance: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3453,7 +4154,7 @@ export type CartDiscountCodesUpdateMutationVariables = Exact<{
 }>;
 export type CartDiscountCodesUpdateMutation = {
     cartDiscountCodesUpdate: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrument' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3499,7 +4200,9 @@ export type CartDiscountCodesUpdateMutation = {
             selectedShippingMethod?: Maybe<(Pick<CartShippingMethod, 'handle' | 'title'> & {
                 price: Pick<Money, 'amount' | 'currencyCode'>;
             })>;
-            selectedPaymentMethod?: Maybe<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
+            selectedPaymentMethod?: Maybe<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'> & {
+                icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+            })>;
             appliedGiftCards: Array<(Pick<CartAppliedGiftCard, 'id' | 'maskedCode' | 'lastCharacters'> & {
                 appliedAmount: Pick<Money, 'amount' | 'currencyCode'>;
                 remainingBalance: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3514,7 +4217,7 @@ export type CartQueryVariables = Exact<{
     id: Scalars['ID']['input'];
 }>;
 export type CartQuery = {
-    cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+    cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrument' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
         cost: {
             total: Pick<Money, 'amount' | 'currencyCode'>;
             subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3560,7 +4263,9 @@ export type CartQuery = {
         selectedShippingMethod?: Maybe<(Pick<CartShippingMethod, 'handle' | 'title'> & {
             price: Pick<Money, 'amount' | 'currencyCode'>;
         })>;
-        selectedPaymentMethod?: Maybe<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
+        selectedPaymentMethod?: Maybe<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'> & {
+            icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+        })>;
         appliedGiftCards: Array<(Pick<CartAppliedGiftCard, 'id' | 'maskedCode' | 'lastCharacters'> & {
             appliedAmount: Pick<Money, 'amount' | 'currencyCode'>;
             remainingBalance: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3573,7 +4278,7 @@ export type CartRemoveGiftCardMutationVariables = Exact<{
 }>;
 export type CartRemoveGiftCardMutation = {
     cartRemoveGiftCard: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrument' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3619,7 +4324,9 @@ export type CartRemoveGiftCardMutation = {
             selectedShippingMethod?: Maybe<(Pick<CartShippingMethod, 'handle' | 'title'> & {
                 price: Pick<Money, 'amount' | 'currencyCode'>;
             })>;
-            selectedPaymentMethod?: Maybe<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
+            selectedPaymentMethod?: Maybe<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'> & {
+                icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+            })>;
             appliedGiftCards: Array<(Pick<CartAppliedGiftCard, 'id' | 'maskedCode' | 'lastCharacters'> & {
                 appliedAmount: Pick<Money, 'amount' | 'currencyCode'>;
                 remainingBalance: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3636,7 +4343,7 @@ export type CartRemoveLinesMutationVariables = Exact<{
 }>;
 export type CartRemoveLinesMutation = {
     cartRemoveLines: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrument' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3682,7 +4389,9 @@ export type CartRemoveLinesMutation = {
             selectedShippingMethod?: Maybe<(Pick<CartShippingMethod, 'handle' | 'title'> & {
                 price: Pick<Money, 'amount' | 'currencyCode'>;
             })>;
-            selectedPaymentMethod?: Maybe<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
+            selectedPaymentMethod?: Maybe<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'> & {
+                icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+            })>;
             appliedGiftCards: Array<(Pick<CartAppliedGiftCard, 'id' | 'maskedCode' | 'lastCharacters'> & {
                 appliedAmount: Pick<Money, 'amount' | 'currencyCode'>;
                 remainingBalance: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3698,7 +4407,7 @@ export type CartSelectPaymentMethodMutationVariables = Exact<{
 }>;
 export type CartSelectPaymentMethodMutation = {
     cartSelectPaymentMethod: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrument' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3744,7 +4453,9 @@ export type CartSelectPaymentMethodMutation = {
             selectedShippingMethod?: Maybe<(Pick<CartShippingMethod, 'handle' | 'title'> & {
                 price: Pick<Money, 'amount' | 'currencyCode'>;
             })>;
-            selectedPaymentMethod?: Maybe<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
+            selectedPaymentMethod?: Maybe<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'> & {
+                icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+            })>;
             appliedGiftCards: Array<(Pick<CartAppliedGiftCard, 'id' | 'maskedCode' | 'lastCharacters'> & {
                 appliedAmount: Pick<Money, 'amount' | 'currencyCode'>;
                 remainingBalance: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3760,7 +4471,7 @@ export type CartSelectShippingMethodMutationVariables = Exact<{
 }>;
 export type CartSelectShippingMethodMutation = {
     cartSelectShippingMethod: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrument' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3806,7 +4517,9 @@ export type CartSelectShippingMethodMutation = {
             selectedShippingMethod?: Maybe<(Pick<CartShippingMethod, 'handle' | 'title'> & {
                 price: Pick<Money, 'amount' | 'currencyCode'>;
             })>;
-            selectedPaymentMethod?: Maybe<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
+            selectedPaymentMethod?: Maybe<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'> & {
+                icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+            })>;
             appliedGiftCards: Array<(Pick<CartAppliedGiftCard, 'id' | 'maskedCode' | 'lastCharacters'> & {
                 appliedAmount: Pick<Money, 'amount' | 'currencyCode'>;
                 remainingBalance: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3822,7 +4535,7 @@ export type CartSetBillingAddressMutationVariables = Exact<{
 }>;
 export type CartSetBillingAddressMutation = {
     cartSetBillingAddress: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrument' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3868,7 +4581,9 @@ export type CartSetBillingAddressMutation = {
             selectedShippingMethod?: Maybe<(Pick<CartShippingMethod, 'handle' | 'title'> & {
                 price: Pick<Money, 'amount' | 'currencyCode'>;
             })>;
-            selectedPaymentMethod?: Maybe<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
+            selectedPaymentMethod?: Maybe<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'> & {
+                icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+            })>;
             appliedGiftCards: Array<(Pick<CartAppliedGiftCard, 'id' | 'maskedCode' | 'lastCharacters'> & {
                 appliedAmount: Pick<Money, 'amount' | 'currencyCode'>;
                 remainingBalance: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3884,7 +4599,7 @@ export type CartSetShippingAddressMutationVariables = Exact<{
 }>;
 export type CartSetShippingAddressMutation = {
     cartSetShippingAddress: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrument' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3930,7 +4645,9 @@ export type CartSetShippingAddressMutation = {
             selectedShippingMethod?: Maybe<(Pick<CartShippingMethod, 'handle' | 'title'> & {
                 price: Pick<Money, 'amount' | 'currencyCode'>;
             })>;
-            selectedPaymentMethod?: Maybe<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
+            selectedPaymentMethod?: Maybe<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'> & {
+                icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+            })>;
             appliedGiftCards: Array<(Pick<CartAppliedGiftCard, 'id' | 'maskedCode' | 'lastCharacters'> & {
                 appliedAmount: Pick<Money, 'amount' | 'currencyCode'>;
                 remainingBalance: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3947,7 +4664,7 @@ export type CartUpdateAttributesMutationVariables = Exact<{
 }>;
 export type CartUpdateAttributesMutation = {
     cartUpdateAttributes: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrument' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3993,7 +4710,9 @@ export type CartUpdateAttributesMutation = {
             selectedShippingMethod?: Maybe<(Pick<CartShippingMethod, 'handle' | 'title'> & {
                 price: Pick<Money, 'amount' | 'currencyCode'>;
             })>;
-            selectedPaymentMethod?: Maybe<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
+            selectedPaymentMethod?: Maybe<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'> & {
+                icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+            })>;
             appliedGiftCards: Array<(Pick<CartAppliedGiftCard, 'id' | 'maskedCode' | 'lastCharacters'> & {
                 appliedAmount: Pick<Money, 'amount' | 'currencyCode'>;
                 remainingBalance: Pick<Money, 'amount' | 'currencyCode'>;
@@ -4010,7 +4729,7 @@ export type CartUpdateBuyerIdentityMutationVariables = Exact<{
 }>;
 export type CartUpdateBuyerIdentityMutation = {
     cartUpdateBuyerIdentity: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrument' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -4056,7 +4775,9 @@ export type CartUpdateBuyerIdentityMutation = {
             selectedShippingMethod?: Maybe<(Pick<CartShippingMethod, 'handle' | 'title'> & {
                 price: Pick<Money, 'amount' | 'currencyCode'>;
             })>;
-            selectedPaymentMethod?: Maybe<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
+            selectedPaymentMethod?: Maybe<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'> & {
+                icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+            })>;
             appliedGiftCards: Array<(Pick<CartAppliedGiftCard, 'id' | 'maskedCode' | 'lastCharacters'> & {
                 appliedAmount: Pick<Money, 'amount' | 'currencyCode'>;
                 remainingBalance: Pick<Money, 'amount' | 'currencyCode'>;
@@ -4072,7 +4793,7 @@ export type CartUpdateGiftCardRecipientMutationVariables = Exact<{
 }>;
 export type CartUpdateGiftCardRecipientMutation = {
     cartUpdateGiftCardRecipient: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrument' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -4118,7 +4839,9 @@ export type CartUpdateGiftCardRecipientMutation = {
             selectedShippingMethod?: Maybe<(Pick<CartShippingMethod, 'handle' | 'title'> & {
                 price: Pick<Money, 'amount' | 'currencyCode'>;
             })>;
-            selectedPaymentMethod?: Maybe<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
+            selectedPaymentMethod?: Maybe<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'> & {
+                icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+            })>;
             appliedGiftCards: Array<(Pick<CartAppliedGiftCard, 'id' | 'maskedCode' | 'lastCharacters'> & {
                 appliedAmount: Pick<Money, 'amount' | 'currencyCode'>;
                 remainingBalance: Pick<Money, 'amount' | 'currencyCode'>;
@@ -4135,7 +4858,7 @@ export type CartUpdateLinesMutationVariables = Exact<{
 }>;
 export type CartUpdateLinesMutation = {
     cartUpdateLines: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrument' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -4181,7 +4904,9 @@ export type CartUpdateLinesMutation = {
             selectedShippingMethod?: Maybe<(Pick<CartShippingMethod, 'handle' | 'title'> & {
                 price: Pick<Money, 'amount' | 'currencyCode'>;
             })>;
-            selectedPaymentMethod?: Maybe<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
+            selectedPaymentMethod?: Maybe<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'> & {
+                icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+            })>;
             appliedGiftCards: Array<(Pick<CartAppliedGiftCard, 'id' | 'maskedCode' | 'lastCharacters'> & {
                 appliedAmount: Pick<Money, 'amount' | 'currencyCode'>;
                 remainingBalance: Pick<Money, 'amount' | 'currencyCode'>;
@@ -4198,7 +4923,7 @@ export type CartUpdateNoteMutationVariables = Exact<{
 }>;
 export type CartUpdateNoteMutation = {
     cartUpdateNote: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrument' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -4244,7 +4969,9 @@ export type CartUpdateNoteMutation = {
             selectedShippingMethod?: Maybe<(Pick<CartShippingMethod, 'handle' | 'title'> & {
                 price: Pick<Money, 'amount' | 'currencyCode'>;
             })>;
-            selectedPaymentMethod?: Maybe<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
+            selectedPaymentMethod?: Maybe<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'> & {
+                icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+            })>;
             appliedGiftCards: Array<(Pick<CartAppliedGiftCard, 'id' | 'maskedCode' | 'lastCharacters'> & {
                 appliedAmount: Pick<Money, 'amount' | 'currencyCode'>;
                 remainingBalance: Pick<Money, 'amount' | 'currencyCode'>;
@@ -4291,6 +5018,7 @@ export type PaymentCreateMutation = {
     paymentCreate: {
         payment?: Maybe<Pick<PaymentSession, 'id' | 'orderId' | 'flow' | 'provider' | 'redirectUrl' | 'clientSecret' | 'status' | 'expiresAt'>>;
         userErrors: Array<Pick<UserError, 'message' | 'code' | 'field'>>;
+        warnings: Array<Pick<PaymentWarning, 'message' | 'code' | 'retryHint'>>;
     };
 };
 export type CustomerAddressesQueryVariables = Exact<{
@@ -4327,7 +5055,7 @@ export type CustomerQueryVariables = Exact<{
     [key: string]: never;
 }>;
 export type CustomerQuery = {
-    customer?: Maybe<(Pick<Customer, 'id' | 'email' | 'firstName' | 'lastName' | 'displayName' | 'phone' | 'isEmailVerified' | 'emailMarketing' | 'orderCount' | 'createdAt' | 'updatedAt'> & {
+    customer?: Maybe<(Pick<Customer, 'id' | 'email' | 'firstName' | 'lastName' | 'displayName' | 'phone' | 'isEmailVerified' | 'emailMarketing' | 'orderCount' | 'createdAt' | 'updatedAt' | 'sessionExpiresAt'> & {
         defaultAddress?: Maybe<Pick<MailingAddress, 'id' | 'streetLine1' | 'streetLine2' | 'city' | 'company' | 'country' | 'countryCode' | 'firstName' | 'lastName' | 'name' | 'phone' | 'state' | 'stateCode' | 'postalCode' | 'isDefault'>>;
         totalSpent: Pick<Money, 'amount' | 'currencyCode'>;
     })>;
@@ -4346,7 +5074,7 @@ export type CustomerSignupMutationVariables = Exact<{
 }>;
 export type CustomerSignupMutation = {
     customerSignup: {
-        customer?: Maybe<(Pick<Customer, 'id' | 'email' | 'firstName' | 'lastName' | 'displayName' | 'phone' | 'isEmailVerified' | 'emailMarketing' | 'orderCount' | 'createdAt' | 'updatedAt'> & {
+        customer?: Maybe<(Pick<Customer, 'id' | 'email' | 'firstName' | 'lastName' | 'displayName' | 'phone' | 'isEmailVerified' | 'emailMarketing' | 'orderCount' | 'createdAt' | 'updatedAt' | 'sessionExpiresAt'> & {
             defaultAddress?: Maybe<Pick<MailingAddress, 'id' | 'streetLine1' | 'streetLine2' | 'city' | 'company' | 'country' | 'countryCode' | 'firstName' | 'lastName' | 'name' | 'phone' | 'state' | 'stateCode' | 'postalCode' | 'isDefault'>>;
             totalSpent: Pick<Money, 'amount' | 'currencyCode'>;
         })>;
@@ -4355,11 +5083,30 @@ export type CustomerSignupMutation = {
     };
 };
 export type AvailablePaymentMethodsFragment = {
-    methods: Array<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
-    defaultMethod?: Maybe<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
+    methods: Array<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position' | 'providersAvailable' | 'preferredProvider' | 'available' | 'unavailableReason'> & {
+        icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+        instruments?: Maybe<Array<(Pick<PaymentInstrument, 'provider' | 'code' | 'type' | 'displayName' | 'displayHint' | 'enabled'> & {
+            brandImage?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+        })>>;
+    })>;
+    defaultMethod?: Maybe<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position' | 'providersAvailable' | 'preferredProvider' | 'available' | 'unavailableReason'> & {
+        icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+        instruments?: Maybe<Array<(Pick<PaymentInstrument, 'provider' | 'code' | 'type' | 'displayName' | 'displayHint' | 'enabled'> & {
+            brandImage?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+        })>>;
+    })>;
 };
-export type PaymentMethodFragment = Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>;
-export type CartFragment = (Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+export type PaymentMethodFragment = (Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position' | 'providersAvailable' | 'preferredProvider' | 'available' | 'unavailableReason'> & {
+    icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+    instruments?: Maybe<Array<(Pick<PaymentInstrument, 'provider' | 'code' | 'type' | 'displayName' | 'displayHint' | 'enabled'> & {
+        brandImage?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+    })>>;
+});
+export type PaymentInstrumentFragment = (Pick<PaymentInstrument, 'provider' | 'code' | 'type' | 'displayName' | 'displayHint' | 'enabled'> & {
+    brandImage?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+});
+export type ImageThumbnailFragment = Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>;
+export type CartFragment = (Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrument' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
     cost: {
         total: Pick<Money, 'amount' | 'currencyCode'>;
         subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -4405,7 +5152,9 @@ export type CartFragment = (Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' |
     selectedShippingMethod?: Maybe<(Pick<CartShippingMethod, 'handle' | 'title'> & {
         price: Pick<Money, 'amount' | 'currencyCode'>;
     })>;
-    selectedPaymentMethod?: Maybe<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
+    selectedPaymentMethod?: Maybe<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'> & {
+        icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+    })>;
     appliedGiftCards: Array<(Pick<CartAppliedGiftCard, 'id' | 'maskedCode' | 'lastCharacters'> & {
         appliedAmount: Pick<Money, 'amount' | 'currencyCode'>;
         remainingBalance: Pick<Money, 'amount' | 'currencyCode'>;
@@ -4453,7 +5202,6 @@ export type ProductVariantFragment = (Pick<ProductVariant, 'id' | 'title' | 'sku
     weight?: Maybe<Pick<Weight, 'value' | 'unit'>>;
 });
 export type MoneyFragment = Pick<Money, 'amount' | 'currencyCode'>;
-export type ImageThumbnailFragment = Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>;
 export type SelectedOptionFragment = Pick<SelectedOption, 'name' | 'value'>;
 export type AttributeSelectionFragment = Pick<AttributeSelection, 'attributeDefinitionId' | 'attributeName' | 'type' | 'fillingMode' | 'billingMode' | 'optionId' | 'optionLabel' | 'optionIds' | 'textValue' | 'surchargeAmount' | 'surchargeType' | 'taxClassId' | 'linkedVariantId'>;
 export type CartBuyerIdentityFragment = Pick<CartBuyerIdentity, 'email' | 'phone' | 'countryCode'>;
@@ -4472,12 +5220,16 @@ export type CartAppliedGiftCardFragment = (Pick<CartAppliedGiftCard, 'id' | 'mas
     appliedAmount: Pick<Money, 'amount' | 'currencyCode'>;
     remainingBalance: Pick<Money, 'amount' | 'currencyCode'>;
 });
-export type CartSelectedPaymentMethodFragment = Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>;
+export type CartSelectedPaymentMethodFragment = (Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'> & {
+    icon?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+});
 export type PageInfoFragment = Pick<PageInfo, 'hasNextPage' | 'hasPreviousPage' | 'startCursor' | 'endCursor'>;
 export type UserErrorFragment = Pick<UserError, 'message' | 'code' | 'field'>;
 export type CartWarningFragment = Pick<CartWarning, 'message' | 'code' | 'target'>;
 export type AvailableShippingMethodFragment = (Pick<AvailableShippingMethod, 'id' | 'name' | 'description' | 'deliveryType' | 'isFree' | 'sortOrder'> & {
-    carrier?: Maybe<Pick<ShippingCarrier, 'id' | 'name' | 'logoUrl' | 'serviceCode'>>;
+    carrier?: Maybe<(Pick<ShippingCarrier, 'id' | 'name' | 'serviceCode'> & {
+        logo?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+    })>;
     price: Pick<Money, 'amount' | 'currencyCode'>;
     estimatedDelivery?: Maybe<Pick<DeliveryEstimate, 'minDays' | 'maxDays' | 'description'>>;
     freeShippingProgress?: Maybe<(Pick<FreeShippingProgress, 'qualifies' | 'progressPercent' | 'message'> & {
@@ -4486,7 +5238,9 @@ export type AvailableShippingMethodFragment = (Pick<AvailableShippingMethod, 'id
         remaining?: Maybe<Pick<Money, 'amount' | 'currencyCode'>>;
     })>;
 });
-export type ShippingCarrierFragment = Pick<ShippingCarrier, 'id' | 'name' | 'logoUrl' | 'serviceCode'>;
+export type ShippingCarrierFragment = (Pick<ShippingCarrier, 'id' | 'name' | 'serviceCode'> & {
+    logo?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+});
 export type DeliveryEstimateFragment = Pick<DeliveryEstimate, 'minDays' | 'maxDays' | 'description'>;
 export type FreeShippingProgressFragment = (Pick<FreeShippingProgress, 'qualifies' | 'progressPercent' | 'message'> & {
     currentAmount?: Maybe<Pick<Money, 'amount' | 'currencyCode'>>;
@@ -4505,9 +5259,10 @@ export type OrderFragment = (Pick<Order, 'id' | 'orderNumber' | 'accessToken' |
     })>;
 });
 export type PaymentSessionFragment = Pick<PaymentSession, 'id' | 'orderId' | 'flow' | 'provider' | 'redirectUrl' | 'clientSecret' | 'status' | 'expiresAt'>;
+export type PaymentWarningFragment = Pick<PaymentWarning, 'message' | 'code' | 'retryHint'>;
 export type CustomerAccessTokenFieldsFragment = Pick<CustomerAccessToken, 'accessToken' | 'expiresAt'>;
 export type UserErrorFieldsFragment = Pick<UserError, 'message' | 'field' | 'code'>;
-export type CustomerFieldsFragment = (Pick<Customer, 'id' | 'email' | 'firstName' | 'lastName' | 'displayName' | 'phone' | 'isEmailVerified' | 'emailMarketing' | 'orderCount' | 'createdAt' | 'updatedAt'> & {
+export type CustomerFieldsFragment = (Pick<Customer, 'id' | 'email' | 'firstName' | 'lastName' | 'displayName' | 'phone' | 'isEmailVerified' | 'emailMarketing' | 'orderCount' | 'createdAt' | 'updatedAt' | 'sessionExpiresAt'> & {
     defaultAddress?: Maybe<Pick<MailingAddress, 'id' | 'streetLine1' | 'streetLine2' | 'city' | 'company' | 'country' | 'countryCode' | 'firstName' | 'lastName' | 'name' | 'phone' | 'state' | 'stateCode' | 'postalCode' | 'isDefault'>>;
     totalSpent: Pick<Money, 'amount' | 'currencyCode'>;
 });