@asstio-dev/storefront 0.32.0 → 0.40.0-market.1

package/src/schema.d.ts

@@ -65,7 +65,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Brands with a page on this market (some product of the brand is sold here), by name. Empty when the site has no brand facet or the market no brand URL pattern. productCount counts product families with a variant of the brand sold here. */
+        /** Brands with a page on this market (some product of the brand is visible in the request's context), by name. Empty when the site has no brand facet or the market no brand URL pattern. productCount counts product families with a variant of the brand visible in the request's context; null when prices are hidden until login. */
         get: operations["ListBrands"];
         put?: never;
         post?: never;
@@ -108,7 +108,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/cart/lines": {
+    "/v1/cart/context": {
         parameters: {
             query?: never;
             header?: never;
@@ -117,14 +117,14 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        post: operations["AddCartLine"];
+        post: operations["SetCartContext"];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/cart/lines/{id}": {
+    "/v1/cart/lines": {
         parameters: {
             query?: never;
             header?: never;
@@ -133,14 +133,14 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        post?: never;
-        delete: operations["RemoveCartLine"];
+        post: operations["AddCartLine"];
+        delete?: never;
         options?: never;
         head?: never;
-        patch: operations["UpdateCartLine"];
+        patch?: never;
         trace?: never;
     };
-    "/v1/cart/market": {
+    "/v1/cart/lines/{id}": {
         parameters: {
             query?: never;
             header?: never;
@@ -149,11 +149,11 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        post: operations["SetCartMarket"];
-        delete?: never;
+        post?: never;
+        delete: operations["RemoveCartLine"];
         options?: never;
         head?: never;
-        patch?: never;
+        patch: operations["UpdateCartLine"];
         trace?: never;
     };
     "/v1/cart/shipping-estimate": {
@@ -179,7 +179,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Asstio category tree as data (facet source). Not pages. */
+        /** Asstio category tree as data (facet source). Not pages. productCount counts the products visible in the request's context under each node; null when prices are hidden until login. */
         get: operations["GetCategories"];
         put?: never;
         post?: never;
@@ -411,7 +411,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Look up a product by its own SKU or one of its variants'. matchedVariantId is set on a variant hit. */
+        /** Look up a product by its own SKU or one of its variants'. matchedVariantId is set on a variant hit; a product with no variant visible in the request's context is a 404. */
         get: operations["GetProductBySku"];
         put?: never;
         post?: never;
@@ -445,7 +445,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Product detail by current slug, historical slug or id. redirectTo is set for a historical slug. */
+        /** Product detail by current slug, historical slug or id, in the request's context: the from-offer, and the visible variants with their own offers. redirectTo is set for a historical slug; a product with no visible variant is a 404. */
         get: operations["GetProduct"];
         put?: never;
         post?: never;
@@ -462,7 +462,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** A product's variants, paged and in the product's order. filter[<axis>]=value narrows; options[].values[].available tells which values the other selections still allow. Use when the product's variants is null. */
+        /** A product's variants visible in the request's context, each with its own offer, paged and in the product's order. filter[<axis>]=value narrows; options[].values[].available tells which values the other selections still allow. Use when the product's variants is null. */
         get: operations["ListProductVariants"];
         put?: never;
         post?: never;
@@ -530,7 +530,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Site bootstrap: markets, URL patterns, config version. */
+        /** Site bootstrap: markets, locales, bindings, offer policy, capabilities, config version. */
         get: operations["GetSite"];
         put?: never;
         post?: never;
@@ -547,7 +547,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Ids, slugs, URLs and lastmod for sitemap.xml and selective revalidation. type=product|collection|brand, ?since= is inclusive; ?cursor=start walks the whole sitemap along nextCursor. */
+        /** Ids, slugs, URLs and lastmod for sitemap.xml and selective revalidation, per page binding (?binding=, default: the default binding; a secondary binding lists nothing). type=product|collection|brand, ?since= is inclusive; ?cursor=start walks the whole sitemap along nextCursor. */
         get: operations["GetSitemap"];
         put?: never;
         post?: never;
@@ -592,6 +592,14 @@ export interface components {
             street: null | string;
             street2: null | string;
         };
+        AlternateDto: {
+            bindingId: string;
+            country: string;
+            hreflang: string;
+            locale: string;
+            market: string;
+            url: string;
+        };
         AppliedFilterDto: {
             facet: string;
             label: string;
@@ -609,17 +617,27 @@ export interface components {
             valueKeys: string[] | null;
             values: string[] | null;
         };
+        BindingDto: {
+            basePath: string;
+            country: string;
+            hreflang: null | string;
+            id: string;
+            indexable: boolean;
+            locale: string;
+            market: string;
+            origin: string;
+            prefix: string;
+            primary: boolean;
+        };
         BrandDetailDto: {
-            alternateUrls: {
-                [key: string]: string;
-            };
+            alternates: components["schemas"]["AlternateDto"][];
             description: null | components["schemas"]["DescriptionDto"];
             facet: null | components["schemas"]["FacetLinkDto"];
             id: string;
             logo: null | components["schemas"]["MediaDescriptorDto"];
             name: string;
             /** Format: int64 */
-            productCount: number | string;
+            productCount: number | null;
             redirectTo: null | string;
             responsible: components["schemas"]["ResponsibleDto"];
             slug: string;
@@ -641,7 +659,7 @@ export interface components {
             logo: null | components["schemas"]["MediaDescriptorDto"];
             name: string;
             /** Format: int64 */
-            productCount: number | string;
+            productCount: number | null;
             slug: string;
             url: string;
         };
@@ -662,14 +680,15 @@ export interface components {
             components: components["schemas"]["BundleComponentDto"][];
         };
         CartDto: {
+            checkoutBlocked: boolean;
+            context: components["schemas"]["ContextDto"];
             currency: string;
             delivery: null | components["schemas"]["DeliveryRangeDto"];
-            grandTotalInc: string;
             lines: components["schemas"]["CartLineDto"][];
-            market: string;
+            quoteStatus: components["schemas"]["QuoteStatusDto"];
             status: string;
-            subtotalInc: string;
             token: string;
+            totals: components["schemas"]["CartTotalsDto"];
             /** Format: int32 */
             version: number | string;
             warnings: components["schemas"]["WarningDto"][];
@@ -679,11 +698,12 @@ export interface components {
             delivery: null | components["schemas"]["DeliveryRangeDto"];
             id: string;
             image: null | components["schemas"]["MediaDescriptorDto"];
-            price: components["schemas"]["PriceDto"];
+            linePrice: components["schemas"]["PricePairDto"];
             product: components["schemas"]["CartLineProductDto"];
             /** Format: int32 */
             quantity: number | string;
             sku: string;
+            unitPrice: components["schemas"]["PricePairDto"];
             variant: components["schemas"]["CartLineVariantDto"];
         };
         CartLineProductDto: {
@@ -707,12 +727,17 @@ export interface components {
         CartTokenDto: {
             token: string;
         };
+        CartTotalsDto: {
+            grandTotal: components["schemas"]["PricePairDto"];
+            rounding: null | string;
+            subtotal: components["schemas"]["PricePairDto"];
+        };
         CategoryNodeDto: {
             children: components["schemas"]["CategoryNodeDto"][];
             id: string;
             name: string;
             /** Format: int32 */
-            productCount: number | string;
+            productCount: number | null;
         };
         CategoryRefDto: {
             id: string;
@@ -850,9 +875,7 @@ export interface components {
             url: string;
         };
         CollectionListingResponse: {
-            alternateUrls: {
-                [key: string]: string;
-            };
+            alternates: components["schemas"]["AlternateDto"][];
             breadcrumb: components["schemas"]["CollectionCrumbDto"][];
             collection: components["schemas"]["CollectionDto"];
             listing: components["schemas"]["ListingResponse"];
@@ -867,6 +890,13 @@ export interface components {
         CompanyNameDto: {
             name: string;
         };
+        ContextDto: {
+            country: string;
+            currency: string;
+            customerKind: string;
+            locale: string;
+            market: string;
+        };
         DeliveryRangeDto: {
             /** Format: int32 */
             max: number;
@@ -885,6 +915,8 @@ export interface components {
             html: string;
             text: string;
         };
+        /** @enum {unknown} */
+        DisplayBasisDto: "ex" | "inc";
         ErasureRequest: {
             email: string;
         };
@@ -894,6 +926,7 @@ export interface components {
             key: string;
             label: string;
             match: string;
+            priceBasis: null | components["schemas"]["PriceBasisDto"];
             range: null | components["schemas"]["RangeDto"];
             searchable: boolean;
             truncated: boolean;
@@ -925,23 +958,28 @@ export interface components {
             threshold: null | string;
         };
         /** @enum {unknown} */
-        LineAvailability: "backorder" | "inStock";
+        LineAvailability: "backorder" | "inStock" | "unavailable";
         ListingResponse: {
             appliedFilters: components["schemas"]["AppliedFilterDto"][];
+            context: components["schemas"]["ContextDto"];
             facets: components["schemas"]["FacetDto"][];
             items: components["schemas"]["ProductCardDto"][];
             /** Format: int32 */
             page: number | string;
             /** Format: int32 */
             pageSize: number | string;
+            priceBasis: components["schemas"]["PriceBasisDto"];
             queryCorrection: null | string;
             redirect: null | string;
-            search?: null | components["schemas"]["SearchInfoDto"];
+            search: null | components["schemas"]["SearchInfoDto"];
             sort: components["schemas"]["SortDto"];
             /** Format: int64 */
             total: number | string;
             warnings: components["schemas"]["WarningDto"][];
         };
+        LocaleDto: {
+            tag: string;
+        };
         MarketCheckoutDto: {
             available: boolean;
             defaultOption: null | string;
@@ -950,10 +988,17 @@ export interface components {
         MarketDto: {
             checkout: components["schemas"]["MarketCheckoutDto"];
             code: string;
-            country: string;
+            countries: string[];
             currency: string;
-            language: string;
-            urlTemplate: string;
+            defaultCountry: string;
+            locales: components["schemas"]["MarketLocalesDto"];
+        };
+        MarketLocalesDto: {
+            allowed: string[];
+            defaultByCountry: {
+                [key: string]: string;
+            };
+            mode: string;
         };
         MediaDescriptorDto: {
             alt: {
@@ -1042,6 +1087,24 @@ export interface components {
             permissions: string[];
             role: string;
         };
+        OfferDto: {
+            compareAt: null | components["schemas"]["PricePairDto"];
+            displayBasis: components["schemas"]["DisplayBasisDto"];
+            listPrice: null | components["schemas"]["PricePairDto"];
+            offerStatus: components["schemas"]["OfferStatusDto"];
+            price: null | components["schemas"]["PricePairDto"];
+            purchaseStatus: components["schemas"]["PurchaseStatusDto"];
+            regular: null | components["schemas"]["PricePairDto"];
+            sale: null | components["schemas"]["SalePriceDto"];
+            stock: components["schemas"]["StockDto"];
+        };
+        OfferPolicyDto: {
+            companyDisplayBasis: components["schemas"]["DisplayBasisDto"];
+            offers: string;
+            publicDisplayBasis: components["schemas"]["DisplayBasisDto"];
+        };
+        /** @enum {unknown} */
+        OfferStatusDto: "available" | "loginRequired" | "notSoldHere" | "unavailable";
         OptionDto: {
             name: string;
             values: string[];
@@ -1130,13 +1193,28 @@ export interface components {
             street: null | string;
             url: null | string;
         };
-        PriceDto: {
-            amount: string;
-            compareAt: null | string;
+        PriceBasisDto: {
             currency: string;
-            vatIncluded: boolean;
-            vatRate: string;
+            source: string;
+            tax: components["schemas"]["DisplayBasisDto"];
+        };
+        PriceFromDto: {
+            price: components["schemas"]["PricePairDto"];
+            variantId: string;
         };
+        PricePairDto: {
+            currency: string;
+            ex: null | string;
+            inc: null | string;
+            status: components["schemas"]["PriceStatusDto"];
+            taxAmount: null | string;
+            taxCode: null | string;
+            taxComponents: components["schemas"]["TaxComponentDto"][];
+            taxRate: null | string;
+            taxTreatment: components["schemas"]["TaxTreatmentDto"];
+        };
+        /** @enum {unknown} */
+        PriceStatusDto: "complete" | "partial" | "unavailable";
         PrincipalDto: {
             company: null | components["schemas"]["CompanyNameDto"];
             id: string;
@@ -1147,15 +1225,14 @@ export interface components {
         ProductCardDto: {
             attributes: components["schemas"]["AttributeDto"][];
             brand: null | components["schemas"]["BrandDto"];
-            buyable: boolean;
             categories: components["schemas"]["CategoryRefDto"][];
             collections: string[];
             id: string;
             image: null | components["schemas"]["MediaDescriptorDto"];
-            inStock: boolean;
             name: string;
-            price: null | components["schemas"]["PriceDto"];
-            priceVaries: boolean;
+            offer: components["schemas"]["OfferDto"];
+            priceFrom: null | components["schemas"]["PriceFromDto"];
+            priceTo: null | components["schemas"]["PriceFromDto"];
             primaryCategory: null | components["schemas"]["CategoryRefDto"];
             shortDescription: null | string;
             sku: string;
@@ -1165,14 +1242,13 @@ export interface components {
             url: string;
         };
         ProductDto: {
-            alternateUrls: {
-                [key: string]: string;
-            };
+            alternates: components["schemas"]["AlternateDto"][];
             attributes: components["schemas"]["AttributeDto"][];
             brand: null | components["schemas"]["BrandDto"];
             bundle: null | components["schemas"]["BundleDto"];
             categories: components["schemas"]["CategoryRefDto"][];
             collections: components["schemas"]["CollectionRefDto"][];
+            context: components["schemas"]["ContextDto"];
             description: null | components["schemas"]["DescriptionDto"];
             files: components["schemas"]["MediaDescriptorDto"][];
             gtin: null | string;
@@ -1182,7 +1258,10 @@ export interface components {
             images: components["schemas"]["MediaDescriptorDto"][];
             matchedVariantId: null | string;
             name: string;
+            offer: components["schemas"]["OfferDto"];
             options: components["schemas"]["OptionDto"][];
+            priceFrom: null | components["schemas"]["PriceFromDto"];
+            priceTo: null | components["schemas"]["PriceFromDto"];
             primaryCategory: null | components["schemas"]["CategoryRefDto"];
             redirectTo: null | string;
             related: components["schemas"]["RelatedGroupDto"][];
@@ -1200,6 +1279,10 @@ export interface components {
             variantCount: number | string;
             variants: components["schemas"]["VariantDto"][] | null;
         };
+        /** @enum {unknown} */
+        PurchaseStatusDto: "available" | "unavailable";
+        /** @enum {unknown} */
+        QuoteStatusDto: "complete" | "partial" | "unavailable";
         RangeDto: {
             currency: null | string;
             max: string;
@@ -1223,6 +1306,13 @@ export interface components {
             importer: null | components["schemas"]["PartyDto"];
             manufacturer: null | components["schemas"]["PartyDto"];
         };
+        SalePriceDto: {
+            price: components["schemas"]["PricePairDto"];
+            /** Format: date-time */
+            validFrom: null | string;
+            /** Format: date-time */
+            validTo: null | string;
+        };
         SearchEventDto: {
             eventId: null | string;
             exposureId?: null | string;
@@ -1278,7 +1368,7 @@ export interface components {
             slug: string;
         };
         /** @enum {unknown} */
-        SelectedVariantStatus: "matched" | "notSoldHere" | "unknown";
+        SelectedVariantStatus: "loginRequired" | "matched" | "notSoldHere" | "unknown";
         SellabilityDto: {
             mode: components["schemas"]["SiteSellabilityMode"];
         };
@@ -1302,8 +1392,10 @@ export interface components {
             expiresAt: string;
             token: string;
         };
-        SetCartMarketRequest: {
-            market: string;
+        SetCartContextRequest: {
+            country?: null | string;
+            locale?: null | string;
+            market?: null | string;
         };
         ShippingEstimateDto: {
             available: boolean;
@@ -1350,24 +1442,33 @@ export interface components {
             consumer: boolean;
             paths: components["schemas"]["AccountPathsDto"];
         };
+        SiteCapabilitiesDto: {
+            checkout: boolean;
+            priceQueries: boolean;
+            stockQueries: boolean;
+        };
         SiteDto: {
             accounts: null | components["schemas"]["SiteAccountsDto"];
+            bindings: components["schemas"]["BindingDto"][];
+            capabilities: components["schemas"]["SiteCapabilitiesDto"];
             code: string;
             configVersion: string;
-            defaultMarket: string;
+            context: components["schemas"]["ContextDto"];
+            defaultBindingId: string;
+            locales: components["schemas"]["LocaleDto"][];
             markets: components["schemas"]["MarketDto"][];
             media: components["schemas"]["MediaDto"];
             name: string;
+            offerPolicy: components["schemas"]["OfferPolicyDto"];
             preview: boolean;
             sellability: components["schemas"]["SellabilityDto"];
+            suggestedLocale: null | string;
             urlPatterns: components["schemas"]["UrlPatternsDto"];
         };
         /** @enum {unknown} */
         SiteSellabilityMode: "backorder" | "onHand";
         SitemapEntryDto: {
-            alternateUrls: {
-                [key: string]: string;
-            };
+            alternates: components["schemas"]["AlternateDto"][];
             id: string;
             slug: string;
             /** Format: date-time */
@@ -1375,6 +1476,7 @@ export interface components {
             url: string;
         };
         SitemapResponse: {
+            bindingId: string;
             items: components["schemas"]["SitemapEntryDto"][];
             nextCursor: null | string;
             /** Format: int32 */
@@ -1401,6 +1503,13 @@ export interface components {
             email: null | string;
             returnPath?: null | string;
         };
+        StockDto: {
+            /** Format: int32 */
+            quantity: number | null;
+            status: components["schemas"]["StockStatusDto"];
+        };
+        /** @enum {unknown} */
+        StockStatusDto: "backorder" | "hidden" | "inStock" | "outOfStock";
         /**
          * Problem
          * @description RFC 9457 problem document. Branch on `code`: it is stable, unlike `title` and `detail`.
@@ -1448,6 +1557,14 @@ export interface components {
         SwitchPrincipalRequest: {
             principal: null | string;
         };
+        TaxComponentDto: {
+            amount: string;
+            jurisdiction: string;
+            rate: string;
+            taxCode: string;
+        };
+        /** @enum {unknown} */
+        TaxTreatmentDto: "exempt" | "export" | "reverseCharge" | "taxable";
         TrackingDto: {
             carrier: string;
             number: string;
@@ -1464,9 +1581,7 @@ export interface components {
         /** @enum {unknown} */
         VariantAvailability: "backorder" | "inStock" | "unavailable";
         VariantDto: {
-            availability: components["schemas"]["VariantAvailability"];
-            /** Format: int32 */
-            availableUnits: number;
+            availability: null | components["schemas"]["VariantAvailability"];
             backorderDelivery: null | components["schemas"]["DeliveryRangeDto"];
             brand: null | components["schemas"]["BrandDto"];
             delivery: null | components["schemas"]["DeliveryRangeDto"];
@@ -1476,14 +1591,12 @@ export interface components {
             id: string;
             image: null | components["schemas"]["MediaDescriptorDto"];
             images: components["schemas"]["MediaDescriptorDto"][];
-            inStock: boolean;
-            price: null | components["schemas"]["PriceDto"];
+            offer: components["schemas"]["OfferDto"];
             responsible: components["schemas"]["ResponsibleDto"];
             selectedOptions: {
                 [key: string]: string;
             };
             sku: string;
-            stock: string;
             url: null | string;
         };
         VariantOptionDto: {
@@ -1538,10 +1651,12 @@ export interface operations {
             header: {
                 /** @description The site's server key (sfk_srv_…). Account routes answer 403 SERVER_KEY_REQUIRED to any other key; server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
                 /** @description The shopper's IP address as the frontend server saw it. Trusted only with a verified server key; the sign-in rate limits are per shopper IP. */
                 "X-Shopper-Ip"?: string;
             };
@@ -1563,7 +1678,7 @@ export interface operations {
                     "application/json": components["schemas"]["SignInStartedDto"];
                 };
             };
-            /** @description problem+json. INVALID_EMAIL (email missing, longer than 320 characters, or not an address), or MARKET_UNKNOWN. An unsafe returnPath is dropped, not refused. */
+            /** @description problem+json. INVALID_EMAIL (email missing, longer than 320 characters, or not an address), or a refusal of the request's commerce headers: MARKET_REQUIRED (several markets, no X-Market and no default binding), MARKET_NOT_FOUND (an unknown or inactive market), COUNTRY_NOT_ALLOWED (the country is not in the market) or LOCALE_NOT_ALLOWED (the locale is not allowed for the market and country). An unsafe returnPath is dropped, not refused. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -1625,10 +1740,12 @@ export interface operations {
             header: {
                 /** @description The site's server key (sfk_srv_…). Account routes answer 403 SERVER_KEY_REQUIRED to any other key; server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
                 /** @description The shopper's IP address as the frontend server saw it. Trusted only with a verified server key; the sign-in rate limits are per shopper IP. */
                 "X-Shopper-Ip"?: string;
                 /** @description Optional. The browser's cart, for the cart resolution at sign-in (accounts B3). */
@@ -1652,7 +1769,7 @@ export interface operations {
                     "application/json": components["schemas"]["SignedInDto"];
                 };
             };
-            /** @description problem+json. SIGN_IN_INVALID: one code for a wrong, expired, exhausted (5 attempts), consumed or ineligible challenge and for a malformed body — start a new sign-in. Or MARKET_UNKNOWN. */
+            /** @description problem+json. SIGN_IN_INVALID: one code for a wrong, expired, exhausted (5 attempts), consumed or ineligible challenge and for a malformed body — start a new sign-in. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -1723,10 +1840,12 @@ export interface operations {
             header: {
                 /** @description The site's server key (sfk_srv_…). Account routes answer 403 SERVER_KEY_REQUIRED to any other key; server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
                 /** @description The shopper's IP address as the frontend server saw it. Trusted only with a verified server key; the sign-in rate limits are per shopper IP. */
                 "X-Shopper-Ip"?: string;
             };
@@ -1746,7 +1865,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description problem+json. MARKET_UNKNOWN (no such market on this site). */
+            /** @description problem+json. Not answered by this route: it has no 400 of its own, and X-Market, X-Country and X-Locale play no part in it. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -1813,10 +1932,14 @@ export interface operations {
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
+                /** @description Optional. The shopper session (sfs_…) of a signed-in shopper, server-to-server with the site's server key only: the request resolves with the session's principal, so its prices, offer and stock visibility apply, and the answer is private, no-store. On a site without accounts it is not read. Not in the CORS allow-list. */
+                "X-Shopper-Session"?: string;
             };
             path?: never;
             cookie?: never;
@@ -1832,7 +1955,7 @@ export interface operations {
                     "application/json": components["schemas"]["BrandPageDto"];
                 };
             };
-            /** @description problem+json. MARKET_UNKNOWN (no such market on this site) or INVALID_PAGE. */
+            /** @description problem+json. MARKET_REQUIRED (several markets, no X-Market and no default binding), MARKET_NOT_FOUND (an unknown or inactive market), COUNTRY_NOT_ALLOWED (the country is not in the market) or LOCALE_NOT_ALLOWED (the locale is not allowed for the market and country); INVALID_PAGE. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -1841,7 +1964,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID. */
+            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID; SESSION_INVALID when an X-Shopper-Session is sent on a site with accounts and does not validate (unknown, expired or revoked) — never a silent signed-out answer. Render signed-out and clear the session cookie. */
             401: {
                 headers: {
                     [name: string]: unknown;
@@ -1850,7 +1973,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret key was sent from a browser. */
+            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret or server key was sent from a browser. With X-Shopper-Session: SERVER_KEY_REQUIRED (any key but the site's server key) or SESSION_FROM_BROWSER (the header with an Origin header). A catalog read never answers PERMISSION_DENIED: a shopper who may not see prices reads the catalog with offerStatus loginRequired, and a price or stock query, where the operation takes one, is its 400. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -1877,7 +2000,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. PRICE_CONTEXT_NOT_READY (the request's price context is not projected yet; Retry-After) or PRICE_CONTEXT_UNAVAILABLE (it cannot be priced); SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -1894,10 +2017,14 @@ export interface operations {
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
+                /** @description Optional. The shopper session (sfs_…) of a signed-in shopper, server-to-server with the site's server key only: the request resolves with the session's principal, so its prices, offer and stock visibility apply, and the answer is private, no-store. On a site without accounts it is not read. Not in the CORS allow-list. */
+                "X-Shopper-Session"?: string;
             };
             path: {
                 slugOrId: string;
@@ -1915,7 +2042,7 @@ export interface operations {
                     "application/json": components["schemas"]["BrandDetailDto"];
                 };
             };
-            /** @description problem+json. MARKET_UNKNOWN (no such market on this site) or INVALID_PAGE. */
+            /** @description problem+json. MARKET_REQUIRED (several markets, no X-Market and no default binding), MARKET_NOT_FOUND (an unknown or inactive market), COUNTRY_NOT_ALLOWED (the country is not in the market) or LOCALE_NOT_ALLOWED (the locale is not allowed for the market and country). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -1924,7 +2051,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID. */
+            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID; SESSION_INVALID when an X-Shopper-Session is sent on a site with accounts and does not validate (unknown, expired or revoked) — never a silent signed-out answer. Render signed-out and clear the session cookie. */
             401: {
                 headers: {
                     [name: string]: unknown;
@@ -1933,7 +2060,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret key was sent from a browser. */
+            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret or server key was sent from a browser. With X-Shopper-Session: SERVER_KEY_REQUIRED (any key but the site's server key) or SESSION_FROM_BROWSER (the header with an Origin header). A catalog read never answers PERMISSION_DENIED: a shopper who may not see prices reads the catalog with offerStatus loginRequired, and a price or stock query, where the operation takes one, is its 400. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -1960,7 +2087,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. PRICE_CONTEXT_NOT_READY (the request's price context is not projected yet; Retry-After) or PRICE_CONTEXT_UNAVAILABLE (it cannot be priced); SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -1977,10 +2104,12 @@ export interface operations {
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
                 /** @description The bearer token returned by POST /v1/cart. Identifies which cart this request reads or mutates. */
                 "X-Cart-Token": string;
                 /** @description Optional. The shopper session (sfs_…) of a signed-in shopper, server-to-server with the site's server key only: it opens the principal's saved carts and orders, and is never needed for a guest cart or order. On a site without accounts it is not read. Not in the CORS allow-list. */
@@ -2054,7 +2183,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -2071,10 +2200,12 @@ export interface operations {
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
                 /** @description Optional. The shopper session (sfs_…) of a signed-in shopper, server-to-server with the site's server key only: it opens the principal's saved carts and orders, and is never needed for a guest cart or order. On a site without accounts it is not read. Not in the CORS allow-list. */
                 "X-Shopper-Session"?: string;
             };
@@ -2092,7 +2223,7 @@ export interface operations {
                     "application/json": components["schemas"]["CartDto"];
                 };
             };
-            /** @description problem+json. MARKET_UNKNOWN (no such market on this site) or INVALID_PAGE. */
+            /** @description problem+json. A refusal of the request's commerce headers: MARKET_REQUIRED, MARKET_NOT_FOUND, COUNTRY_REQUIRED (a market with several countries needs X-Country), COUNTRY_NOT_ALLOWED or LOCALE_NOT_ALLOWED. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -2137,7 +2268,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. PRICE_CONTEXT_NOT_READY (the requested price context is not projected yet; Retry-After), or PRICE_CONTEXT_UNAVAILABLE (it cannot be priced); nothing is written. SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -2148,20 +2279,20 @@ export interface operations {
             };
         };
     };
-    AddCartLine: {
+    SetCartContext: {
         parameters: {
             query?: never;
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
                 /** @description The bearer token returned by POST /v1/cart. Identifies which cart this request reads or mutates. */
                 "X-Cart-Token": string;
-                /** @description An opaque client-chosen key. Replaying the exact same add with the same key is a no-op (the line's quantity is not added twice); a different key, or none, tops the existing line up like any other add. */
-                "Idempotency-Key"?: string;
                 /** @description The cart's current version, as returned in the ETag header. When present and stale, the mutation is rejected with 409 CART_CONFLICT instead of being applied last-write-wins. */
                 "If-Match"?: string;
                 /** @description Optional. The shopper session (sfs_…) of a signed-in shopper, server-to-server with the site's server key only: it opens the principal's saved carts and orders, and is never needed for a guest cart or order. On a site without accounts it is not read. Not in the CORS allow-list. */
@@ -2172,7 +2303,7 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["AddCartLineRequest"];
+                "application/json": components["schemas"]["SetCartContextRequest"];
             };
         };
         responses: {
@@ -2185,7 +2316,7 @@ export interface operations {
                     "application/json": components["schemas"]["CartDto"];
                 };
             };
-            /** @description problem+json. NOT_FOUND (X-Cart-Token missing), INVALID_QUANTITY, or CART_FULL. */
+            /** @description problem+json. NOT_FOUND (X-Cart-Token missing), MARKET_NOT_FOUND, COUNTRY_NOT_ALLOWED (also when a market change leaves out a country it does not hold: a left-out member is the cart's stored one), or LOCALE_NOT_ALLOWED. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -2221,7 +2352,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. CART_CONFLICT (stale If-Match), STOCK_INSUFFICIENT, or PRODUCT_GONE. */
+            /** @description problem+json. CART_CONFLICT (stale If-Match). */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -2248,7 +2379,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. PRICE_CONTEXT_NOT_READY (the requested price context is not projected yet; Retry-After), or PRICE_CONTEXT_UNAVAILABLE (it cannot be priced); nothing is written. SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -2259,29 +2390,35 @@ export interface operations {
             };
         };
     };
-    RemoveCartLine: {
+    AddCartLine: {
         parameters: {
             query?: never;
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
                 /** @description The bearer token returned by POST /v1/cart. Identifies which cart this request reads or mutates. */
                 "X-Cart-Token": string;
+                /** @description An opaque client-chosen key. Replaying the exact same add with the same key is a no-op (the line's quantity is not added twice); a different key, or none, tops the existing line up like any other add. */
+                "Idempotency-Key"?: string;
                 /** @description The cart's current version, as returned in the ETag header. When present and stale, the mutation is rejected with 409 CART_CONFLICT instead of being applied last-write-wins. */
                 "If-Match"?: string;
                 /** @description Optional. The shopper session (sfs_…) of a signed-in shopper, server-to-server with the site's server key only: it opens the principal's saved carts and orders, and is never needed for a guest cart or order. On a site without accounts it is not read. Not in the CORS allow-list. */
                 "X-Shopper-Session"?: string;
             };
-            path: {
-                id: string;
-            };
+            path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AddCartLineRequest"];
+            };
+        };
         responses: {
             /** @description OK */
             200: {
@@ -2292,7 +2429,7 @@ export interface operations {
                     "application/json": components["schemas"]["CartDto"];
                 };
             };
-            /** @description problem+json. NOT_FOUND (X-Cart-Token missing). */
+            /** @description problem+json. NOT_FOUND (X-Cart-Token missing), INVALID_QUANTITY, CART_FULL, or a refusal of the cart's stored context (the site no longer sells it): MARKET_NOT_FOUND, COUNTRY_NOT_ALLOWED or LOCALE_NOT_ALLOWED. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -2310,7 +2447,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret or server key was sent from a browser. With X-Shopper-Session: SERVER_KEY_REQUIRED (any key but the site's server key) or SESSION_FROM_BROWSER (the header with an Origin header). PERMISSION_DENIED (extension permission: cart.edit): the principal may not change its saved cart. */
+            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret or server key was sent from a browser. With X-Shopper-Session: SERVER_KEY_REQUIRED (any key but the site's server key) or SESSION_FROM_BROWSER (the header with an Origin header). PERMISSION_DENIED (extension permission: cart.edit): the principal may not change its saved cart. Or PERMISSION_DENIED with permission login: prices are not shown to this shopper (sign in); with permission cart.edit also when the principal may not buy now (its company data is being re-validated). */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -2319,7 +2456,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. NOT_FOUND: no such cart. The same answer for a saved cart of another principal or account (with or without a session) and for a cart whose owner was erased. Or SITE_INACTIVE. */
+            /** @description problem+json. NOT_FOUND: no such cart. The same answer for a saved cart of another principal or account (with or without a session) and for a cart whose owner was erased. Or SITE_INACTIVE. Or PRODUCT_NOT_FOUND: the cart's context does not see the sku (not in its assortment or price list). */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -2328,7 +2465,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. CART_CONFLICT (stale If-Match). */
+            /** @description problem+json. CART_CONFLICT (stale If-Match), or STOCK_INSUFFICIENT. */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -2355,7 +2492,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. PRICE_CONTEXT_NOT_READY (the cart's price context is not projected yet; Retry-After), PRICE_CONTEXT_UNAVAILABLE (it cannot be priced), or TAX_UNAVAILABLE (the line's tax cannot be completed for the cart's destination; nothing is added); SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -2366,16 +2503,18 @@ export interface operations {
             };
         };
     };
-    UpdateCartLine: {
+    RemoveCartLine: {
         parameters: {
             query?: never;
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
                 /** @description The bearer token returned by POST /v1/cart. Identifies which cart this request reads or mutates. */
                 "X-Cart-Token": string;
                 /** @description The cart's current version, as returned in the ETag header. When present and stale, the mutation is rejected with 409 CART_CONFLICT instead of being applied last-write-wins. */
@@ -2388,11 +2527,7 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["UpdateCartLineRequest"];
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description OK */
             200: {
@@ -2403,7 +2538,7 @@ export interface operations {
                     "application/json": components["schemas"]["CartDto"];
                 };
             };
-            /** @description problem+json. NOT_FOUND (X-Cart-Token missing), or INVALID_QUANTITY. */
+            /** @description problem+json. NOT_FOUND (X-Cart-Token missing). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -2439,7 +2574,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. CART_CONFLICT (stale If-Match), STOCK_INSUFFICIENT, or PRODUCT_GONE. */
+            /** @description problem+json. CART_CONFLICT (stale If-Match). */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -2466,7 +2601,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -2477,16 +2612,18 @@ export interface operations {
             };
         };
     };
-    SetCartMarket: {
+    UpdateCartLine: {
         parameters: {
             query?: never;
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
                 /** @description The bearer token returned by POST /v1/cart. Identifies which cart this request reads or mutates. */
                 "X-Cart-Token": string;
                 /** @description The cart's current version, as returned in the ETag header. When present and stale, the mutation is rejected with 409 CART_CONFLICT instead of being applied last-write-wins. */
@@ -2494,12 +2631,14 @@ export interface operations {
                 /** @description Optional. The shopper session (sfs_…) of a signed-in shopper, server-to-server with the site's server key only: it opens the principal's saved carts and orders, and is never needed for a guest cart or order. On a site without accounts it is not read. Not in the CORS allow-list. */
                 "X-Shopper-Session"?: string;
             };
-            path?: never;
+            path: {
+                id: string;
+            };
             cookie?: never;
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["SetCartMarketRequest"];
+                "application/json": components["schemas"]["UpdateCartLineRequest"];
             };
         };
         responses: {
@@ -2512,7 +2651,7 @@ export interface operations {
                     "application/json": components["schemas"]["CartDto"];
                 };
             };
-            /** @description problem+json. NOT_FOUND (X-Cart-Token missing), or MARKET_UNKNOWN. */
+            /** @description problem+json. NOT_FOUND (X-Cart-Token missing), INVALID_QUANTITY, or a refusal of the cart's stored context (the site no longer sells it): MARKET_NOT_FOUND, COUNTRY_NOT_ALLOWED or LOCALE_NOT_ALLOWED. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -2530,7 +2669,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret or server key was sent from a browser. With X-Shopper-Session: SERVER_KEY_REQUIRED (any key but the site's server key) or SESSION_FROM_BROWSER (the header with an Origin header). PERMISSION_DENIED (extension permission: cart.edit): the principal may not change its saved cart. */
+            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret or server key was sent from a browser. With X-Shopper-Session: SERVER_KEY_REQUIRED (any key but the site's server key) or SESSION_FROM_BROWSER (the header with an Origin header). PERMISSION_DENIED (extension permission: cart.edit): the principal may not change its saved cart. Or PERMISSION_DENIED with permission login: prices are not shown to this shopper (sign in); with permission cart.edit also when the principal may not buy now (its company data is being re-validated). */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -2539,7 +2678,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. NOT_FOUND: no such cart. The same answer for a saved cart of another principal or account (with or without a session) and for a cart whose owner was erased. Or SITE_INACTIVE. */
+            /** @description problem+json. NOT_FOUND: no such cart. The same answer for a saved cart of another principal or account (with or without a session) and for a cart whose owner was erased. Or SITE_INACTIVE. Or PRODUCT_NOT_FOUND: the cart's context does not see the sku (not in its assortment or price list). */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -2548,7 +2687,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. CART_CONFLICT (stale If-Match). */
+            /** @description problem+json. CART_CONFLICT (stale If-Match), or STOCK_INSUFFICIENT. */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -2575,7 +2714,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. PRICE_CONTEXT_NOT_READY (the cart's price context is not projected yet; Retry-After), PRICE_CONTEXT_UNAVAILABLE (it cannot be priced), or TAX_UNAVAILABLE (the line's tax cannot be completed for the cart's destination; nothing is added); SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -2592,10 +2731,12 @@ export interface operations {
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
                 /** @description The bearer token returned by POST /v1/cart. Identifies which cart this request reads or mutates. */
                 "X-Cart-Token": string;
                 /** @description Optional. The shopper session (sfs_…) of a signed-in shopper, server-to-server with the site's server key only: it opens the principal's saved carts and orders, and is never needed for a guest cart or order. On a site without accounts it is not read. Not in the CORS allow-list. */
@@ -2669,7 +2810,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -2686,10 +2827,14 @@ export interface operations {
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
+                /** @description Optional. The shopper session (sfs_…) of a signed-in shopper, server-to-server with the site's server key only: the request resolves with the session's principal, so its prices, offer and stock visibility apply, and the answer is private, no-store. On a site without accounts it is not read. Not in the CORS allow-list. */
+                "X-Shopper-Session"?: string;
             };
             path?: never;
             cookie?: never;
@@ -2705,7 +2850,7 @@ export interface operations {
                     "application/json": components["schemas"]["CategoryNodeDto"][];
                 };
             };
-            /** @description problem+json. MARKET_UNKNOWN (no such market on this site) or INVALID_PAGE. */
+            /** @description problem+json. MARKET_REQUIRED (several markets, no X-Market and no default binding), MARKET_NOT_FOUND (an unknown or inactive market), COUNTRY_NOT_ALLOWED (the country is not in the market) or LOCALE_NOT_ALLOWED (the locale is not allowed for the market and country). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -2714,7 +2859,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID. */
+            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID; SESSION_INVALID when an X-Shopper-Session is sent on a site with accounts and does not validate (unknown, expired or revoked) — never a silent signed-out answer. Render signed-out and clear the session cookie. */
             401: {
                 headers: {
                     [name: string]: unknown;
@@ -2723,7 +2868,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret key was sent from a browser. */
+            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret or server key was sent from a browser. With X-Shopper-Session: SERVER_KEY_REQUIRED (any key but the site's server key) or SESSION_FROM_BROWSER (the header with an Origin header). A catalog read never answers PERMISSION_DENIED: a shopper who may not see prices reads the catalog with offerStatus loginRequired, and a price or stock query, where the operation takes one, is its 400. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -2750,7 +2895,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. PRICE_CONTEXT_NOT_READY (the request's price context is not projected yet; Retry-After) or PRICE_CONTEXT_UNAVAILABLE (it cannot be priced); SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -2767,10 +2912,12 @@ export interface operations {
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
                 /** @description The cart's bearer token. The checkout works on this cart. */
                 "X-Cart-Token": string;
                 /** @description Optional. The shopper session (sfs_…) of a signed-in shopper, server-to-server with the site's server key only: it opens the principal's saved carts and orders, and is never needed for a guest cart or order. On a site without accounts it is not read. Not in the CORS allow-list. */
@@ -2794,7 +2941,7 @@ export interface operations {
                     "application/json": components["schemas"]["CheckoutDto"];
                 };
             };
-            /** @description problem+json. NOT_FOUND (X-Cart-Token missing), OPTION_NOT_AVAILABLE, or ORIGIN_NOT_ALLOWED. */
+            /** @description problem+json. NOT_FOUND (X-Cart-Token missing), OPTION_NOT_AVAILABLE, ORIGIN_NOT_ALLOWED, or a refusal of the request's commerce headers: MARKET_REQUIRED, MARKET_NOT_FOUND, COUNTRY_REQUIRED, COUNTRY_NOT_ALLOWED or LOCALE_NOT_ALLOWED. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -2830,7 +2977,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. CART_EMPTY; CHECKOUT_CART_CHANGED (the corrected cart is in `cart`); CHECKOUT_IN_PROGRESS (Retry-After); CHECKOUT_MARKET_MISMATCH; COMPANY_CHECKOUT_UNAVAILABLE (a company principal: company checkout is not available yet). */
+            /** @description problem+json. CART_EMPTY; CHECKOUT_CART_CHANGED (the corrected cart is in `cart`; also while it is `checkoutBlocked`: a line partial, unavailable or no longer covered); CHECKOUT_IN_PROGRESS (Retry-After); CONTEXT_MISMATCH (the request's market or country is not the cart's: the message names the cart's, the cart is in `cart`, and only `POST /v1/cart/context` moves it); COMPANY_CHECKOUT_UNAVAILABLE (a company principal: company checkout is not available yet). */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -2866,7 +3013,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. CHECKOUT_UNAVAILABLE, SHIPPING_UNAVAILABLE (the market's shipping configuration cannot be served) or CHECKOUT_PROVIDER_UNAVAILABLE (Retry-After); SITE_REGISTRY_WARMING. */
+            /** @description problem+json. CHECKOUT_UNAVAILABLE (also, without Retry-After, for a cart in a currency that is not two-decimal or one whose quote carries a rounding component), SHIPPING_UNAVAILABLE (the market's shipping configuration cannot be served) or CHECKOUT_PROVIDER_UNAVAILABLE (Retry-After); PRICE_CONTEXT_NOT_READY (Retry-After) or PRICE_CONTEXT_UNAVAILABLE for the context the request's commerce headers name; SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -2883,10 +3030,12 @@ export interface operations {
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
                 /** @description The cart's bearer token. The checkout works on this cart. */
                 "X-Cart-Token": string;
                 /** @description Optional. The shopper session (sfs_…) of a signed-in shopper, server-to-server with the site's server key only: it opens the principal's saved carts and orders, and is never needed for a guest cart or order. On a site without accounts it is not read. Not in the CORS allow-list. */
@@ -2935,7 +3084,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. CHECKOUT_NOT_FOUND: no such attempt for this site and cart; the same answer when the attempt is not open to this caller — a company attempt without a session of its own membership, or a cart whose owner was erased, whatever token is sent. Or SITE_INACTIVE. */
+            /** @description problem+json. CHECKOUT_NOT_FOUND: no such attempt for this site and cart; the same answer when the attempt is not open to this caller — a company attempt without a session of its own membership, or a cart whose owner was erased, whatever token is sent. */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -2953,7 +3102,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -2970,10 +3119,12 @@ export interface operations {
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
                 /** @description Optional. When it names the attempt's cart, the answer carries the order's access token (complete) or opens the order (orders). */
                 "X-Cart-Token"?: string;
                 /** @description Optional. The shopper session (sfs_…) of a signed-in shopper, server-to-server with the site's server key only: it opens the principal's saved carts and orders, and is never needed for a guest cart or order. On a site without accounts it is not read. Not in the CORS allow-list. */
@@ -2995,7 +3146,7 @@ export interface operations {
                     "application/json": components["schemas"]["CheckoutStatusDto"];
                 };
             };
-            /** @description problem+json. MARKET_UNKNOWN (no such market on this site) or INVALID_PAGE. */
+            /** @description problem+json. Not answered by this route: it has no 400 of its own, and X-Market, X-Country and X-Locale play no part in it. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -3040,7 +3191,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -3057,10 +3208,12 @@ export interface operations {
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
                 /** @description The cart's bearer token. The checkout works on this cart. */
                 "X-Cart-Token": string;
                 /** @description Optional. The shopper session (sfs_…) of a signed-in shopper, server-to-server with the site's server key only: it opens the principal's saved carts and orders, and is never needed for a guest cart or order. On a site without accounts it is not read. Not in the CORS allow-list. */
@@ -3109,7 +3262,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. CHECKOUT_NOT_FOUND: no such attempt for this site and cart; the same answer when the attempt is not open to this caller — a company attempt without a session of its own membership, or a cart whose owner was erased, whatever token is sent. Or SITE_INACTIVE. */
+            /** @description problem+json. CHECKOUT_NOT_FOUND: no such attempt for this site and cart; the same answer when the attempt is not open to this caller — a company attempt without a session of its own membership, or a cart whose owner was erased, whatever token is sent. */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -3127,7 +3280,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -3144,10 +3297,14 @@ export interface operations {
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
+                /** @description Optional. The shopper session (sfs_…) of a signed-in shopper, server-to-server with the site's server key only: the request resolves with the session's principal, so its prices, offer and stock visibility apply, and the answer is private, no-store. On a site without accounts it is not read. Not in the CORS allow-list. */
+                "X-Shopper-Session"?: string;
             };
             path?: never;
             cookie?: never;
@@ -3163,7 +3320,7 @@ export interface operations {
                     "application/json": components["schemas"]["CollectionDto"][];
                 };
             };
-            /** @description problem+json. MARKET_UNKNOWN (no such market on this site) or INVALID_PAGE. */
+            /** @description problem+json. MARKET_REQUIRED (several markets, no X-Market and no default binding), MARKET_NOT_FOUND (an unknown or inactive market), COUNTRY_NOT_ALLOWED (the country is not in the market) or LOCALE_NOT_ALLOWED (the locale is not allowed for the market and country). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -3172,7 +3329,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID. */
+            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID; SESSION_INVALID when an X-Shopper-Session is sent on a site with accounts and does not validate (unknown, expired or revoked) — never a silent signed-out answer. Render signed-out and clear the session cookie. */
             401: {
                 headers: {
                     [name: string]: unknown;
@@ -3181,7 +3338,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret key was sent from a browser. */
+            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret or server key was sent from a browser. With X-Shopper-Session: SERVER_KEY_REQUIRED (any key but the site's server key) or SESSION_FROM_BROWSER (the header with an Origin header). A catalog read never answers PERMISSION_DENIED: a shopper who may not see prices reads the catalog with offerStatus loginRequired, and a price or stock query, where the operation takes one, is its 400. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -3208,7 +3365,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. PRICE_CONTEXT_NOT_READY (the request's price context is not projected yet; Retry-After) or PRICE_CONTEXT_UNAVAILABLE (it cannot be priced); SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -3240,10 +3397,14 @@ export interface operations {
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
+                /** @description Optional. The shopper session (sfs_…) of a signed-in shopper, server-to-server with the site's server key only: the request resolves with the session's principal, so its prices, offer and stock visibility apply, and the answer is private, no-store. On a site without accounts it is not read. Not in the CORS allow-list. */
+                "X-Shopper-Session"?: string;
             };
             path: {
                 slugOrId: string;
@@ -3261,7 +3422,7 @@ export interface operations {
                     "application/json": components["schemas"]["CollectionListingResponse"];
                 };
             };
-            /** @description problem+json. MARKET_UNKNOWN (no such market on this site) or INVALID_PAGE. */
+            /** @description problem+json. MARKET_REQUIRED (several markets, no X-Market and no default binding), MARKET_NOT_FOUND (an unknown or inactive market), COUNTRY_NOT_ALLOWED (the country is not in the market) or LOCALE_NOT_ALLOWED (the locale is not allowed for the market and country); INVALID_PAGE; PRICE_QUERY_UNSUPPORTED (a price sort, filter or facet where prices are not shown to this shopper, or on the ex-VAT basis where the country's ex amounts are incomplete) or STOCK_QUERY_UNSUPPORTED (a stock filter or facet where stock is not shown to this shopper). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -3270,7 +3431,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID. */
+            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID; SESSION_INVALID when an X-Shopper-Session is sent on a site with accounts and does not validate (unknown, expired or revoked) — never a silent signed-out answer. Render signed-out and clear the session cookie. */
             401: {
                 headers: {
                     [name: string]: unknown;
@@ -3279,7 +3440,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret key was sent from a browser. */
+            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret or server key was sent from a browser. With X-Shopper-Session: SERVER_KEY_REQUIRED (any key but the site's server key) or SESSION_FROM_BROWSER (the header with an Origin header). A catalog read never answers PERMISSION_DENIED: a shopper who may not see prices reads the catalog with offerStatus loginRequired, and a price or stock query, where the operation takes one, is its 400. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -3306,7 +3467,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. PRICE_CONTEXT_NOT_READY (the request's price context is not projected yet; Retry-After) or PRICE_CONTEXT_UNAVAILABLE (it cannot be priced); SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -3323,10 +3484,12 @@ export interface operations {
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
             };
             path?: never;
             cookie?: never;
@@ -3406,10 +3569,14 @@ export interface operations {
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
+                /** @description Optional. The shopper session (sfs_…) of a signed-in shopper, server-to-server with the site's server key only: the request resolves with the session's principal, so its prices, offer and stock visibility apply, and the answer is private, no-store. On a site without accounts it is not read. Not in the CORS allow-list. */
+                "X-Shopper-Session"?: string;
             };
             path?: never;
             cookie?: never;
@@ -3429,7 +3596,7 @@ export interface operations {
                     "application/json": components["schemas"]["SearchEventsResponse"];
                 };
             };
-            /** @description problem+json. EVENTS_INVALID (not JSON, not { "events": [ … ] }, no event or more than 50, or a body over 64 KB; nothing is stored), or MARKET_UNKNOWN. One bad event is not a 400: it is listed in the 202's rejected. */
+            /** @description problem+json. EVENTS_INVALID (not JSON, not { "events": [ … ] }, no event or more than 50, or a body over 64 KB; nothing is stored), or MARKET_REQUIRED (several markets, no X-Market and no default binding), MARKET_NOT_FOUND (an unknown or inactive market), COUNTRY_NOT_ALLOWED (the country is not in the market) or LOCALE_NOT_ALLOWED (the locale is not allowed for the market and country). One bad event is not a 400: it is listed in the 202's rejected. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -3438,7 +3605,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID. */
+            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID; SESSION_INVALID when an X-Shopper-Session is sent on a site with accounts and does not validate (unknown, expired or revoked) — never a silent signed-out answer. Render signed-out and clear the session cookie. */
             401: {
                 headers: {
                     [name: string]: unknown;
@@ -3447,7 +3614,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret key was sent from a browser. */
+            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret or server key was sent from a browser. With X-Shopper-Session: SERVER_KEY_REQUIRED (any key but the site's server key) or SESSION_FROM_BROWSER (the header with an Origin header). A catalog read never answers PERMISSION_DENIED: a shopper who may not see prices reads the catalog with offerStatus loginRequired, and a price or stock query, where the operation takes one, is its 400. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -3474,7 +3641,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. PRICE_CONTEXT_NOT_READY (the request's price context is not projected yet; Retry-After) or PRICE_CONTEXT_UNAVAILABLE (it cannot be priced); SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -3491,10 +3658,12 @@ export interface operations {
             header: {
                 /** @description The site's server key (sfk_srv_…). Account routes answer 403 SERVER_KEY_REQUIRED to any other key; server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
                 /** @description The shopper's IP address as the frontend server saw it. Trusted only with a verified server key; the sign-in rate limits are per shopper IP. */
                 "X-Shopper-Ip"?: string;
             };
@@ -3512,7 +3681,7 @@ export interface operations {
                     "application/json": components["schemas"]["AccountDto"];
                 };
             };
-            /** @description problem+json. MARKET_UNKNOWN (no such market on this site). */
+            /** @description problem+json. Not answered by this route: it has no 400 of its own, and X-Market, X-Country and X-Locale play no part in it. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -3574,10 +3743,12 @@ export interface operations {
             header: {
                 /** @description The site's server key (sfk_srv_…). Account routes answer 403 SERVER_KEY_REQUIRED to any other key; server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
                 /** @description The shopper's IP address as the frontend server saw it. Trusted only with a verified server key; the sign-in rate limits are per shopper IP. */
                 "X-Shopper-Ip"?: string;
             };
@@ -3595,7 +3766,7 @@ export interface operations {
                     "application/json": components["schemas"]["CartDto"];
                 };
             };
-            /** @description problem+json. MARKET_UNKNOWN (no such market on this site). */
+            /** @description problem+json. Not answered by this route: it has no 400 of its own, and X-Market, X-Country and X-Locale play no part in it. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -3631,6 +3802,15 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
+            /** @description problem+json. CART_EXPIRED: this cart token belongs to an expired cart. */
+            410: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["StorefrontProblem"];
+                };
+            };
             /** @description problem+json. RATE_LIMITED; retryAfterSeconds and the Retry-After header say how long to wait. */
             429: {
                 headers: {
@@ -3640,7 +3820,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_KEYS_SYNCING (the server key before the site's first key sync; Retry-After) or SITE_REGISTRY_WARMING. */
+            /** @description problem+json. SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -3657,10 +3837,12 @@ export interface operations {
             header: {
                 /** @description The site's server key (sfk_srv_…). Account routes answer 403 SERVER_KEY_REQUIRED to any other key; server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
                 /** @description The shopper's IP address as the frontend server saw it. Trusted only with a verified server key; the sign-in rate limits are per shopper IP. */
                 "X-Shopper-Ip"?: string;
             };
@@ -3678,7 +3860,7 @@ export interface operations {
                     "application/json": components["schemas"]["MyCompanyDto"];
                 };
             };
-            /** @description problem+json. MARKET_UNKNOWN (no such market on this site). */
+            /** @description problem+json. Not answered by this route: it has no 400 of its own, and X-Market, X-Country and X-Locale play no part in it. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -3740,10 +3922,12 @@ export interface operations {
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
                 /** @description Optional. When it names the attempt's cart, the answer carries the order's access token (complete) or opens the order (orders). */
                 "X-Cart-Token"?: string;
                 /** @description The order's access token, from the completion answer. A header only — never a query parameter. */
@@ -3767,7 +3951,7 @@ export interface operations {
                     "application/json": components["schemas"]["OrderDto"];
                 };
             };
-            /** @description problem+json. MARKET_UNKNOWN (no such market on this site) or INVALID_PAGE. */
+            /** @description problem+json. Not answered by this route: it has no 400 of its own, and X-Market, X-Country and X-Locale play no part in it. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -3846,10 +4030,14 @@ export interface operations {
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
+                /** @description Optional. The shopper session (sfs_…) of a signed-in shopper, server-to-server with the site's server key only: the request resolves with the session's principal, so its prices, offer and stock visibility apply, and the answer is private, no-store. On a site without accounts it is not read. Not in the CORS allow-list. */
+                "X-Shopper-Session"?: string;
             };
             path?: never;
             cookie?: never;
@@ -3865,7 +4053,7 @@ export interface operations {
                     "application/json": components["schemas"]["ListingResponse"];
                 };
             };
-            /** @description problem+json. MARKET_UNKNOWN (no such market on this site) or INVALID_PAGE. */
+            /** @description problem+json. MARKET_REQUIRED (several markets, no X-Market and no default binding), MARKET_NOT_FOUND (an unknown or inactive market), COUNTRY_NOT_ALLOWED (the country is not in the market) or LOCALE_NOT_ALLOWED (the locale is not allowed for the market and country); INVALID_PAGE; PRICE_QUERY_UNSUPPORTED (a price sort, filter or facet where prices are not shown to this shopper, or on the ex-VAT basis where the country's ex amounts are incomplete) or STOCK_QUERY_UNSUPPORTED (a stock filter or facet where stock is not shown to this shopper). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -3874,7 +4062,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID. */
+            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID; SESSION_INVALID when an X-Shopper-Session is sent on a site with accounts and does not validate (unknown, expired or revoked) — never a silent signed-out answer. Render signed-out and clear the session cookie. */
             401: {
                 headers: {
                     [name: string]: unknown;
@@ -3883,7 +4071,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret key was sent from a browser. */
+            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret or server key was sent from a browser. With X-Shopper-Session: SERVER_KEY_REQUIRED (any key but the site's server key) or SESSION_FROM_BROWSER (the header with an Origin header). A catalog read never answers PERMISSION_DENIED: a shopper who may not see prices reads the catalog with offerStatus loginRequired, and a price or stock query, where the operation takes one, is its 400. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -3910,7 +4098,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. PRICE_CONTEXT_NOT_READY (the request's price context is not projected yet; Retry-After) or PRICE_CONTEXT_UNAVAILABLE (it cannot be priced); SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -3927,10 +4115,14 @@ export interface operations {
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
+                /** @description Optional. The shopper session (sfs_…) of a signed-in shopper, server-to-server with the site's server key only: the request resolves with the session's principal, so its prices, offer and stock visibility apply, and the answer is private, no-store. On a site without accounts it is not read. Not in the CORS allow-list. */
+                "X-Shopper-Session"?: string;
             };
             path: {
                 sku: string;
@@ -3948,7 +4140,7 @@ export interface operations {
                     "application/json": components["schemas"]["ProductDto"];
                 };
             };
-            /** @description problem+json. MARKET_UNKNOWN (no such market on this site) or INVALID_PAGE. */
+            /** @description problem+json. MARKET_REQUIRED (several markets, no X-Market and no default binding), MARKET_NOT_FOUND (an unknown or inactive market), COUNTRY_NOT_ALLOWED (the country is not in the market) or LOCALE_NOT_ALLOWED (the locale is not allowed for the market and country). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -3957,7 +4149,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID. */
+            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID; SESSION_INVALID when an X-Shopper-Session is sent on a site with accounts and does not validate (unknown, expired or revoked) — never a silent signed-out answer. Render signed-out and clear the session cookie. */
             401: {
                 headers: {
                     [name: string]: unknown;
@@ -3966,7 +4158,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret key was sent from a browser. */
+            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret or server key was sent from a browser. With X-Shopper-Session: SERVER_KEY_REQUIRED (any key but the site's server key) or SESSION_FROM_BROWSER (the header with an Origin header). A catalog read never answers PERMISSION_DENIED: a shopper who may not see prices reads the catalog with offerStatus loginRequired, and a price or stock query, where the operation takes one, is its 400. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -3993,7 +4185,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. PRICE_CONTEXT_NOT_READY (the request's price context is not projected yet; Retry-After) or PRICE_CONTEXT_UNAVAILABLE (it cannot be priced); SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -4017,10 +4209,14 @@ export interface operations {
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
+                /** @description Optional. The shopper session (sfs_…) of a signed-in shopper, server-to-server with the site's server key only: the request resolves with the session's principal, so its prices, offer and stock visibility apply, and the answer is private, no-store. On a site without accounts it is not read. Not in the CORS allow-list. */
+                "X-Shopper-Session"?: string;
             };
             path: {
                 key: string;
@@ -4038,7 +4234,7 @@ export interface operations {
                     "application/json": components["schemas"]["FacetValuesResponse"];
                 };
             };
-            /** @description problem+json. MARKET_UNKNOWN (no such market on this site), INVALID_PAGE, or INVALID_QUERY (q present but blank, or longer than 100 characters), or FACET_NOT_SEARCHABLE (the facet exists but has no list of values to search in: a range, a toggle or a tree). */
+            /** @description problem+json. MARKET_REQUIRED (several markets, no X-Market and no default binding), MARKET_NOT_FOUND (an unknown or inactive market), COUNTRY_NOT_ALLOWED (the country is not in the market) or LOCALE_NOT_ALLOWED (the locale is not allowed for the market and country); INVALID_PAGE; INVALID_QUERY (q present but blank, or longer than 100 characters), FACET_NOT_SEARCHABLE (the facet exists but has no list of values to search in: a range, a toggle or a tree), or PRICE_QUERY_UNSUPPORTED (a price sort, filter or facet where prices are not shown to this shopper, or on the ex-VAT basis where the country's ex amounts are incomplete) or STOCK_QUERY_UNSUPPORTED (a stock filter or facet where stock is not shown to this shopper). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -4047,7 +4243,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID. */
+            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID; SESSION_INVALID when an X-Shopper-Session is sent on a site with accounts and does not validate (unknown, expired or revoked) — never a silent signed-out answer. Render signed-out and clear the session cookie. */
             401: {
                 headers: {
                     [name: string]: unknown;
@@ -4056,7 +4252,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret key was sent from a browser. */
+            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret or server key was sent from a browser. With X-Shopper-Session: SERVER_KEY_REQUIRED (any key but the site's server key) or SESSION_FROM_BROWSER (the header with an Origin header). A catalog read never answers PERMISSION_DENIED: a shopper who may not see prices reads the catalog with offerStatus loginRequired, and a price or stock query, where the operation takes one, is its 400. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -4083,7 +4279,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. PRICE_CONTEXT_NOT_READY (the request's price context is not projected yet; Retry-After) or PRICE_CONTEXT_UNAVAILABLE (it cannot be priced); SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -4103,10 +4299,14 @@ export interface operations {
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
+                /** @description Optional. The shopper session (sfs_…) of a signed-in shopper, server-to-server with the site's server key only: the request resolves with the session's principal, so its prices, offer and stock visibility apply, and the answer is private, no-store. On a site without accounts it is not read. Not in the CORS allow-list. */
+                "X-Shopper-Session"?: string;
             };
             path: {
                 slugOrId: string;
@@ -4124,7 +4324,7 @@ export interface operations {
                     "application/json": components["schemas"]["ProductDto"];
                 };
             };
-            /** @description problem+json. MARKET_UNKNOWN (no such market on this site) or INVALID_PAGE. */
+            /** @description problem+json. MARKET_REQUIRED (several markets, no X-Market and no default binding), MARKET_NOT_FOUND (an unknown or inactive market), COUNTRY_NOT_ALLOWED (the country is not in the market) or LOCALE_NOT_ALLOWED (the locale is not allowed for the market and country). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -4133,7 +4333,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID. */
+            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID; SESSION_INVALID when an X-Shopper-Session is sent on a site with accounts and does not validate (unknown, expired or revoked) — never a silent signed-out answer. Render signed-out and clear the session cookie. */
             401: {
                 headers: {
                     [name: string]: unknown;
@@ -4142,7 +4342,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret key was sent from a browser. */
+            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret or server key was sent from a browser. With X-Shopper-Session: SERVER_KEY_REQUIRED (any key but the site's server key) or SESSION_FROM_BROWSER (the header with an Origin header). A catalog read never answers PERMISSION_DENIED: a shopper who may not see prices reads the catalog with offerStatus loginRequired, and a price or stock query, where the operation takes one, is its 400. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -4169,7 +4369,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. PRICE_CONTEXT_NOT_READY (the request's price context is not projected yet; Retry-After) or PRICE_CONTEXT_UNAVAILABLE (it cannot be priced); SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -4195,10 +4395,14 @@ export interface operations {
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
+                /** @description Optional. The shopper session (sfs_…) of a signed-in shopper, server-to-server with the site's server key only: the request resolves with the session's principal, so its prices, offer and stock visibility apply, and the answer is private, no-store. On a site without accounts it is not read. Not in the CORS allow-list. */
+                "X-Shopper-Session"?: string;
             };
             path: {
                 slugOrId: string;
@@ -4216,7 +4420,7 @@ export interface operations {
                     "application/json": components["schemas"]["VariantPageDto"];
                 };
             };
-            /** @description problem+json. MARKET_UNKNOWN (no such market on this site), INVALID_PAGE, or INVALID_FILTER (an unknown option axis in filter[], or a non-boolean filter[in-stock]). */
+            /** @description problem+json. MARKET_REQUIRED (several markets, no X-Market and no default binding), MARKET_NOT_FOUND (an unknown or inactive market), COUNTRY_NOT_ALLOWED (the country is not in the market) or LOCALE_NOT_ALLOWED (the locale is not allowed for the market and country); INVALID_PAGE; INVALID_FILTER (an unknown option axis in filter[], or a non-boolean filter[in-stock]), or STOCK_QUERY_UNSUPPORTED (filter[in-stock] where stock is not shown to this shopper). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -4225,7 +4429,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID. */
+            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID; SESSION_INVALID when an X-Shopper-Session is sent on a site with accounts and does not validate (unknown, expired or revoked) — never a silent signed-out answer. Render signed-out and clear the session cookie. */
             401: {
                 headers: {
                     [name: string]: unknown;
@@ -4234,7 +4438,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret key was sent from a browser. */
+            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret or server key was sent from a browser. With X-Shopper-Session: SERVER_KEY_REQUIRED (any key but the site's server key) or SESSION_FROM_BROWSER (the header with an Origin header). A catalog read never answers PERMISSION_DENIED: a shopper who may not see prices reads the catalog with offerStatus loginRequired, and a price or stock query, where the operation takes one, is its 400. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -4261,7 +4465,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. PRICE_CONTEXT_NOT_READY (the request's price context is not projected yet; Retry-After) or PRICE_CONTEXT_UNAVAILABLE (it cannot be priced); SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -4281,10 +4485,14 @@ export interface operations {
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
+                /** @description Optional. The shopper session (sfs_…) of a signed-in shopper, server-to-server with the site's server key only: the request resolves with the session's principal, so its prices, offer and stock visibility apply, and the answer is private, no-store. On a site without accounts it is not read. Not in the CORS allow-list. */
+                "X-Shopper-Session"?: string;
             };
             path?: never;
             cookie?: never;
@@ -4300,7 +4508,7 @@ export interface operations {
                     "application/json": components["schemas"]["SuggestResponse"];
                 };
             };
-            /** @description problem+json. MARKET_UNKNOWN (no such market on this site), INVALID_PAGE, or INVALID_QUERY (q missing, blank or longer than 100 characters). */
+            /** @description problem+json. MARKET_REQUIRED (several markets, no X-Market and no default binding), MARKET_NOT_FOUND (an unknown or inactive market), COUNTRY_NOT_ALLOWED (the country is not in the market) or LOCALE_NOT_ALLOWED (the locale is not allowed for the market and country); INVALID_QUERY (q missing, blank or longer than 100 characters). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -4309,7 +4517,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID. */
+            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID; SESSION_INVALID when an X-Shopper-Session is sent on a site with accounts and does not validate (unknown, expired or revoked) — never a silent signed-out answer. Render signed-out and clear the session cookie. */
             401: {
                 headers: {
                     [name: string]: unknown;
@@ -4318,7 +4526,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret key was sent from a browser. */
+            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret or server key was sent from a browser. With X-Shopper-Session: SERVER_KEY_REQUIRED (any key but the site's server key) or SESSION_FROM_BROWSER (the header with an Origin header). A catalog read never answers PERMISSION_DENIED: a shopper who may not see prices reads the catalog with offerStatus loginRequired, and a price or stock query, where the operation takes one, is its 400. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -4345,7 +4553,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. PRICE_CONTEXT_NOT_READY (the request's price context is not projected yet; Retry-After) or PRICE_CONTEXT_UNAVAILABLE (it cannot be priced); SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -4362,10 +4570,12 @@ export interface operations {
             header: {
                 /** @description The site's server key (sfk_srv_…). Account routes answer 403 SERVER_KEY_REQUIRED to any other key; server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
                 /** @description The shopper's IP address as the frontend server saw it. Trusted only with a verified server key; the sign-in rate limits are per shopper IP. */
                 "X-Shopper-Ip"?: string;
             };
@@ -4383,7 +4593,7 @@ export interface operations {
                     "application/json": components["schemas"]["SessionDto"];
                 };
             };
-            /** @description problem+json. MARKET_UNKNOWN (no such market on this site). */
+            /** @description problem+json. Not answered by this route: it has no 400 of its own, and X-Market, X-Country and X-Locale play no part in it. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -4445,10 +4655,12 @@ export interface operations {
             header: {
                 /** @description The site's server key (sfk_srv_…). Account routes answer 403 SERVER_KEY_REQUIRED to any other key; server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
                 /** @description The shopper's IP address as the frontend server saw it. Trusted only with a verified server key; the sign-in rate limits are per shopper IP. */
                 "X-Shopper-Ip"?: string;
             };
@@ -4470,7 +4682,7 @@ export interface operations {
                     "application/json": components["schemas"]["SignedInDto"];
                 };
             };
-            /** @description problem+json. MARKET_UNKNOWN (no such market on this site). */
+            /** @description problem+json. Not answered by this route: it has no 400 of its own, and X-Market, X-Country and X-Locale play no part in it. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -4532,10 +4744,16 @@ export interface operations {
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
+                /** @description Read for suggestedLocale only, a hint for a locale picker. It selects nothing here or on any other route. */
                 "Accept-Language"?: string;
+                /** @description Optional. The shopper session (sfs_…) of a signed-in shopper, server-to-server with the site's server key only: the request resolves with the session's principal, so its prices, offer and stock visibility apply, and the answer is private, no-store. On a site without accounts it is not read. Not in the CORS allow-list. */
+                "X-Shopper-Session"?: string;
             };
             path?: never;
             cookie?: never;
@@ -4551,7 +4769,7 @@ export interface operations {
                     "application/json": components["schemas"]["SiteDto"];
                 };
             };
-            /** @description problem+json. MARKET_UNKNOWN (no such market on this site) or INVALID_PAGE. */
+            /** @description problem+json. MARKET_REQUIRED (several markets, no X-Market and no default binding), MARKET_NOT_FOUND (an unknown or inactive market), COUNTRY_NOT_ALLOWED (the country is not in the market) or LOCALE_NOT_ALLOWED (the locale is not allowed for the market and country). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -4560,7 +4778,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID. */
+            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID; SESSION_INVALID when an X-Shopper-Session is sent on a site with accounts and does not validate (unknown, expired or revoked) — never a silent signed-out answer. Render signed-out and clear the session cookie. */
             401: {
                 headers: {
                     [name: string]: unknown;
@@ -4569,7 +4787,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret key was sent from a browser. */
+            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret or server key was sent from a browser. With X-Shopper-Session: SERVER_KEY_REQUIRED (any key but the site's server key) or SESSION_FROM_BROWSER (the header with an Origin header). A catalog read never answers PERMISSION_DENIED: a shopper who may not see prices reads the catalog with offerStatus loginRequired, and a price or stock query, where the operation takes one, is its 400. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -4596,7 +4814,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. PRICE_CONTEXT_NOT_READY (the request's price context is not projected yet; Retry-After) or PRICE_CONTEXT_UNAVAILABLE (it cannot be priced); SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -4612,9 +4830,11 @@ export interface operations {
             query?: {
                 /** @description Which URLs to list. Defaults to product. */
                 type?: "brand" | "collection" | "product";
+                /** @description The page binding (`{market}/{COUNTRY}/{locale}`, one of `GET /v1/site` bindings) whose URLs are listed; defaults to the default binding. A secondary (non-indexable) binding lists nothing (an empty 200). An id the site does not publish is a 404 with code NOT_FOUND. The sitemap is always the public, anonymous one: X-Market, X-Country, X-Locale and a shopper session are ignored. */
+                binding?: string;
                 /** @description Inclusive ISO-8601 timestamp; only entries changed at or after it. An offset-free value is read as UTC. */
                 since?: string;
-                /** @description Cursor mode: start with "start", then pass each response's nextCursor until it is null. No result window applies. Not combined with page > 1. A value this endpoint did not issue for the same type is a 400 with code INVALID_CURSOR. */
+                /** @description Cursor mode: start with "start", then pass each response's nextCursor until it is null. No result window applies. Not combined with page > 1. A value this endpoint did not issue for the same site, binding, type and since is a 400 with code INVALID_CURSOR. A cursor continues on the catalog generation its walk started on; once that generation is gone (brand cursors: once another is active) or after an hour it is a 409 with code CURSOR_EXPIRED: restart from "start". */
                 cursor?: string;
                 /** @description Page mode only (no cursor). 1-based page. page × pageSize must not exceed 10000 (default pageSize 500, max 1000). Use cursor=start to walk past that. */
                 page?: number;
@@ -4624,10 +4844,12 @@ export interface operations {
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
                 "X-Site-Key": string;
-                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                /** @description Market code (e.g. "eur"). Optional when the site has one market; else the default binding's market. */
                 "X-Market"?: string;
-                /** @description BCP-47 language tag. Omit to use the market's language. */
-                "Accept-Language"?: string;
+                /** @description ISO 3166-1 alpha-2 country (e.g. "DE"). Optional when the market has one country; catalog reads fall back to the market's default country, cart and checkout require it. */
+                "X-Country"?: string;
+                /** @description Locale tag as the site spells it (e.g. "sv"). Optional: the country's default locale. Accept-Language selects nothing. */
+                "X-Locale"?: string;
             };
             path?: never;
             cookie?: never;
@@ -4643,7 +4865,7 @@ export interface operations {
                     "application/json": components["schemas"]["SitemapResponse"];
                 };
             };
-            /** @description problem+json. MARKET_UNKNOWN (no such market on this site), INVALID_PAGE, or INVALID_TYPE (an unknown type), INVALID_SINCE (since not an ISO-8601 timestamp) or INVALID_CURSOR (a cursor that is not start or a nextCursor issued for this type). */
+            /** @description problem+json. INVALID_PAGE, INVALID_TYPE (an unknown type), INVALID_SINCE (since not an ISO-8601 timestamp) or INVALID_CURSOR (a cursor that is not start or a nextCursor issued for this site, binding, type and since). MARKET_REQUIRED, MARKET_NOT_FOUND, COUNTRY_NOT_ALLOWED or LOCALE_NOT_ALLOWED when the site's config gives no usable binding (several markets and no default binding, or a binding its market no longer allows): these come from the config, never from a request header. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -4652,7 +4874,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID. */
+            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID; SESSION_INVALID when an X-Shopper-Session is sent on a site with accounts and does not validate (unknown, expired or revoked) — never a silent signed-out answer. Render signed-out and clear the session cookie. */
             401: {
                 headers: {
                     [name: string]: unknown;
@@ -4661,7 +4883,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret key was sent from a browser. */
+            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret or server key was sent from a browser. With X-Shopper-Session: SERVER_KEY_REQUIRED (any key but the site's server key) or SESSION_FROM_BROWSER (the header with an Origin header). */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -4670,7 +4892,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_INACTIVE, or NOT_FOUND for an unrouted path. */
+            /** @description problem+json. NOT_FOUND (a binding this site does not publish), or SITE_INACTIVE when the site itself is not live. */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -4679,6 +4901,15 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
+            /** @description problem+json. CURSOR_EXPIRED: the cursor's catalog generation is gone (a brand cursor: another generation is active) or the cursor is more than an hour old. Restart the walk from cursor=start. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["StorefrontProblem"];
+                };
+            };
             /** @description problem+json. RATE_LIMITED; retryAfterSeconds and the Retry-After header say how long to wait. */
             429: {
                 headers: {
@@ -4688,7 +4919,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["StorefrontProblem"];
                 };
             };
-            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            /** @description problem+json. PRICE_CONTEXT_NOT_READY (the request's price context is not projected yet; Retry-After) or PRICE_CONTEXT_UNAVAILABLE (it cannot be priced); SITE_KEYS_SYNCING (a secret or server key before the site's first key sync; Retry-After), SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
             503: {
                 headers: {
                     [name: string]: unknown;