@asteby/storefront 0.6.0 → 0.8.0

package/dist/index.d.cts

@@ -75,6 +75,18 @@ type StorefrontClientOptions = {
     fetch?: FetchLike;
     /** Sent as `Accept-Language`. */
     locale?: string;
+    /**
+     * Public host of the storefront (`godsnutrition.com`), sent as `X-Storefront-Domain`. Platform (`pt_`)
+     * tokens need it to pick the organization; with an org-scoped token it only scopes the market.
+     */
+    domain?: string;
+    /**
+     * Market the request is for (`mx`, `us`), sent as `<domain>#<market>` in `X-Storefront-Domain`. It lets ONE
+     * public domain serve several markets (the storefront routes by path prefix, e.g. `/us`): OPS honors it
+     * when the organization has that market active and otherwise falls back to the domain's own market.
+     * Ignored without `domain`.
+     */
+    market?: string;
     /** Extra headers on every request. */
     headers?: Record<string, string>;
     /**
@@ -285,6 +297,8 @@ declare function createStorefrontClient(config: StorefrontClientOptions): {
     };
 };
 type StorefrontClient = ReturnType<typeof createStorefrontClient>;
+/** `X-Storefront-Domain` value: the host, plus `#<market>` when a valid market code is given. */
+declare function storefrontDomainHeader(domain: string, market?: string | null): string;
 
 type StorefrontErrorInit = {
     status: number;
@@ -573,4 +587,63 @@ type PromoProgressView = {
  */
 declare function promoProgressView(promotions: CartPromotions | null | undefined, locale?: string | null, overrides?: Partial<PromotionMessages> | null): PromoProgressView;
 
-export { Address, AddressInput, Article, type ArticleListParams, Availability, type AvailabilityLocale, type AvailabilityMessageKey, type AvailabilityMessages, AvailabilityStatus, type AvailabilityTone, type AvailabilityView, type AvailabilityViewOptions, CLIENT_IP_HEADER, Cart, CartBuyerInput, CartLineInput, CartLineProblem, type CartLineProblemView, CartLineUpdateInput, CartPromotions, CartRecommendations, CheckoutInput, CheckoutResult, Collection, type CollectionListParams, Connection, Customer, CustomerIdentifier, CustomerSession, CustomerSessionInput, DeclineCode, DeliveryInput, DeliveryOptions, type DiscountBarState, type DiscountBarView, type FetchLike, type FormatMoneyOptions, GeoPoint, InsufficientStockLine, InvoiceRequest, InvoiceResult, Location, LocationListParams, Menu, Money, NOTE_MAX_LENGTH, NearestLocation, Order, Page, type PaginationParams, PaymentAttemptResult, PaymentConfig, type PaymentErrorKind, type PaymentErrorView, type PaymentLocale, type PaymentMessageKey, type PaymentMessages, PaymentMethods, PaymentNextStep, type PaymentOutcome, type PaymentOutcomeKind, PaymentSubmitInput, PaymentVoucher, type PreviewOptions, Product, ProductConnection, type ProductListParams, ProductSort, ProductVariant, type PromoProgressView, type PromotionLocale, type PromotionMessageKey, type PromotionMessages, PromotionReward, PromotionsList, type QueryParams, type QueryValue, RecommendationPlacement, type RequestOptions, type ResolveAvailabilityOptions, RestockSubscriptionInput, RestockSubscriptionResult, ReturnRequest, ReturnRequestInput, type ShippingBarState, type ShippingBarView, Shop, StockLevel, type StorefrontClient, type StorefrontClientOptions, StorefrontError, StorefrontErrorCode, type StorefrontErrorInit, type StorefrontRequestContext, type StorefrontResponseContext, Theme, type WriteOptions, appendParams, availabilityLocale, availabilityMessages, availabilityView, cartLineProblemView, clampPercent, createStorefrontClient, declineMessage, declineMessageKey, formatAvailabilityMessage, formatMoney, formatVoucherExpiry, generateIdempotencyKey, isStorefrontError, isTokenPublishable, normalizeClientIp, normalizeNote, parseMoney, parseProductFilters, paymentErrorView, paymentIdempotencyKey, paymentMessages, paymentOutcome, productAvailability, productListQuery, promoProgressView, promotionMessages, resolveAvailability, rewardLabel, safeHttpsUrl, schemaAvailability, toMoney };
+/**
+ * Detección de mercado por visita (país + idioma), pura y sin DOM: sirve en el servidor de cualquier tienda.
+ *
+ * Reglas (mejores prácticas de i18n para comercio):
+ * - El mercado canónico lo fija el DOMINIO (OPS liga cada dominio verificado a un mercado: org_domains.market_code).
+ *   Esto no lo decide la geolocalización: así cada URL tiene un solo idioma/moneda (SEO, hreflang, caché de CDN).
+ * - La geolocalización solo SUGIERE (banner "¿Ver la tienda de Estados Unidos?"); nunca redirige sola, nunca a rastreadores
+ *   y respeta la elección guardada del comprador.
+ * - Precios, impuestos y envío NO dependen de la IP: dependen del mercado del dominio y de la dirección de entrega.
+ * - El país sale de las cabeceras que pone el CDN/proxy (no se puede confiar en ellas si el servidor está expuesto
+ *   directo a internet: solo se leen con `trustProxy`).
+ */
+type MarketInfo = {
+    /** Código del mercado en OPS ("mx", "us"). */
+    code: string;
+    /** ISO 3166-1 alfa-2 a los que vende. */
+    countries: string[];
+    /** BCP 47 por defecto ("es-MX", "en-US"). */
+    locale: string;
+    /** ISO 4217 ("MXN", "USD"). */
+    currency: string;
+    /** Dominio público del mercado, si es distinto del actual ("godsnutrition.com"). */
+    host?: string;
+};
+/** Cabeceras de país de los CDN/proxies más comunes, en orden de preferencia. */
+declare const COUNTRY_HEADERS: readonly ["cf-ipcountry", "cloudfront-viewer-country", "x-vercel-ip-country", "x-appengine-country", "x-country-code"];
+/** País del visitante según el CDN. `null` si no viene, es desconocido (XX), Tor (T1) o no es ISO alfa-2. */
+declare function visitorCountry(headers: Headers, { trustProxy }?: {
+    trustProxy?: boolean;
+}): string | null;
+/** Idiomas de Accept-Language ordenados por q (mayor primero), en minúsculas. */
+declare function preferredLanguages(acceptLanguage: string | null | undefined): string[];
+/** Mejor idioma entre los que ofrece la tienda: coincidencia exacta, luego por idioma base; si no, el de `fallback`. */
+declare function negotiateLocale(acceptLanguage: string | null | undefined, available: string[], fallback: string): string;
+type MarketSuggestion = {
+    market: MarketInfo;
+    /** Qué disparó la sugerencia. El país manda; el idioma solo si el CDN no dio país. */
+    reason: 'country' | 'language';
+};
+/**
+ * ¿Conviene sugerir otro mercado a esta visita? `null` si no (ya está en el correcto, rastreador, ya eligió, o no hay otro).
+ * `chosen` es el código que el comprador guardó al elegir a mano ("market" en cookie): si existe, no se vuelve a sugerir.
+ */
+declare function suggestMarket({ headers, markets, current, chosen, trustProxy, }: {
+    headers: Headers;
+    markets: MarketInfo[];
+    current: string;
+    chosen?: string | null;
+    trustProxy?: boolean;
+}): MarketSuggestion | null;
+/**
+ * Enlaces `hreflang` para <head>: un alterno por mercado con dominio propio, más x-default (el mercado por defecto).
+ * `path` es la ruta con query actual ("/productos/x"). Es lo que permite a buscadores servir cada país en su idioma.
+ */
+declare function hreflangLinks(markets: MarketInfo[], path: string, defaultMarket: string, protocol?: string): {
+    hrefLang: string;
+    href: string;
+}[];
+
+export { Address, AddressInput, Article, type ArticleListParams, Availability, type AvailabilityLocale, type AvailabilityMessageKey, type AvailabilityMessages, AvailabilityStatus, type AvailabilityTone, type AvailabilityView, type AvailabilityViewOptions, CLIENT_IP_HEADER, COUNTRY_HEADERS, Cart, CartBuyerInput, CartLineInput, CartLineProblem, type CartLineProblemView, CartLineUpdateInput, CartPromotions, CartRecommendations, CheckoutInput, CheckoutResult, Collection, type CollectionListParams, Connection, Customer, CustomerIdentifier, CustomerSession, CustomerSessionInput, DeclineCode, DeliveryInput, DeliveryOptions, type DiscountBarState, type DiscountBarView, type FetchLike, type FormatMoneyOptions, GeoPoint, InsufficientStockLine, InvoiceRequest, InvoiceResult, Location, LocationListParams, type MarketInfo, type MarketSuggestion, Menu, Money, NOTE_MAX_LENGTH, NearestLocation, Order, Page, type PaginationParams, PaymentAttemptResult, PaymentConfig, type PaymentErrorKind, type PaymentErrorView, type PaymentLocale, type PaymentMessageKey, type PaymentMessages, PaymentMethods, PaymentNextStep, type PaymentOutcome, type PaymentOutcomeKind, PaymentSubmitInput, PaymentVoucher, type PreviewOptions, Product, ProductConnection, type ProductListParams, ProductSort, ProductVariant, type PromoProgressView, type PromotionLocale, type PromotionMessageKey, type PromotionMessages, PromotionReward, PromotionsList, type QueryParams, type QueryValue, RecommendationPlacement, type RequestOptions, type ResolveAvailabilityOptions, RestockSubscriptionInput, RestockSubscriptionResult, ReturnRequest, ReturnRequestInput, type ShippingBarState, type ShippingBarView, Shop, StockLevel, type StorefrontClient, type StorefrontClientOptions, StorefrontError, StorefrontErrorCode, type StorefrontErrorInit, type StorefrontRequestContext, type StorefrontResponseContext, Theme, type WriteOptions, appendParams, availabilityLocale, availabilityMessages, availabilityView, cartLineProblemView, clampPercent, createStorefrontClient, declineMessage, declineMessageKey, formatAvailabilityMessage, formatMoney, formatVoucherExpiry, generateIdempotencyKey, hreflangLinks, isStorefrontError, isTokenPublishable, negotiateLocale, normalizeClientIp, normalizeNote, parseMoney, parseProductFilters, paymentErrorView, paymentIdempotencyKey, paymentMessages, paymentOutcome, preferredLanguages, productAvailability, productListQuery, promoProgressView, promotionMessages, resolveAvailability, rewardLabel, safeHttpsUrl, schemaAvailability, storefrontDomainHeader, suggestMarket, toMoney, visitorCountry };

package/dist/index.d.ts

@@ -75,6 +75,18 @@ type StorefrontClientOptions = {
     fetch?: FetchLike;
     /** Sent as `Accept-Language`. */
     locale?: string;
+    /**
+     * Public host of the storefront (`godsnutrition.com`), sent as `X-Storefront-Domain`. Platform (`pt_`)
+     * tokens need it to pick the organization; with an org-scoped token it only scopes the market.
+     */
+    domain?: string;
+    /**
+     * Market the request is for (`mx`, `us`), sent as `<domain>#<market>` in `X-Storefront-Domain`. It lets ONE
+     * public domain serve several markets (the storefront routes by path prefix, e.g. `/us`): OPS honors it
+     * when the organization has that market active and otherwise falls back to the domain's own market.
+     * Ignored without `domain`.
+     */
+    market?: string;
     /** Extra headers on every request. */
     headers?: Record<string, string>;
     /**
@@ -285,6 +297,8 @@ declare function createStorefrontClient(config: StorefrontClientOptions): {
     };
 };
 type StorefrontClient = ReturnType<typeof createStorefrontClient>;
+/** `X-Storefront-Domain` value: the host, plus `#<market>` when a valid market code is given. */
+declare function storefrontDomainHeader(domain: string, market?: string | null): string;
 
 type StorefrontErrorInit = {
     status: number;
@@ -573,4 +587,63 @@ type PromoProgressView = {
  */
 declare function promoProgressView(promotions: CartPromotions | null | undefined, locale?: string | null, overrides?: Partial<PromotionMessages> | null): PromoProgressView;
 
-export { Address, AddressInput, Article, type ArticleListParams, Availability, type AvailabilityLocale, type AvailabilityMessageKey, type AvailabilityMessages, AvailabilityStatus, type AvailabilityTone, type AvailabilityView, type AvailabilityViewOptions, CLIENT_IP_HEADER, Cart, CartBuyerInput, CartLineInput, CartLineProblem, type CartLineProblemView, CartLineUpdateInput, CartPromotions, CartRecommendations, CheckoutInput, CheckoutResult, Collection, type CollectionListParams, Connection, Customer, CustomerIdentifier, CustomerSession, CustomerSessionInput, DeclineCode, DeliveryInput, DeliveryOptions, type DiscountBarState, type DiscountBarView, type FetchLike, type FormatMoneyOptions, GeoPoint, InsufficientStockLine, InvoiceRequest, InvoiceResult, Location, LocationListParams, Menu, Money, NOTE_MAX_LENGTH, NearestLocation, Order, Page, type PaginationParams, PaymentAttemptResult, PaymentConfig, type PaymentErrorKind, type PaymentErrorView, type PaymentLocale, type PaymentMessageKey, type PaymentMessages, PaymentMethods, PaymentNextStep, type PaymentOutcome, type PaymentOutcomeKind, PaymentSubmitInput, PaymentVoucher, type PreviewOptions, Product, ProductConnection, type ProductListParams, ProductSort, ProductVariant, type PromoProgressView, type PromotionLocale, type PromotionMessageKey, type PromotionMessages, PromotionReward, PromotionsList, type QueryParams, type QueryValue, RecommendationPlacement, type RequestOptions, type ResolveAvailabilityOptions, RestockSubscriptionInput, RestockSubscriptionResult, ReturnRequest, ReturnRequestInput, type ShippingBarState, type ShippingBarView, Shop, StockLevel, type StorefrontClient, type StorefrontClientOptions, StorefrontError, StorefrontErrorCode, type StorefrontErrorInit, type StorefrontRequestContext, type StorefrontResponseContext, Theme, type WriteOptions, appendParams, availabilityLocale, availabilityMessages, availabilityView, cartLineProblemView, clampPercent, createStorefrontClient, declineMessage, declineMessageKey, formatAvailabilityMessage, formatMoney, formatVoucherExpiry, generateIdempotencyKey, isStorefrontError, isTokenPublishable, normalizeClientIp, normalizeNote, parseMoney, parseProductFilters, paymentErrorView, paymentIdempotencyKey, paymentMessages, paymentOutcome, productAvailability, productListQuery, promoProgressView, promotionMessages, resolveAvailability, rewardLabel, safeHttpsUrl, schemaAvailability, toMoney };
+/**
+ * Detección de mercado por visita (país + idioma), pura y sin DOM: sirve en el servidor de cualquier tienda.
+ *
+ * Reglas (mejores prácticas de i18n para comercio):
+ * - El mercado canónico lo fija el DOMINIO (OPS liga cada dominio verificado a un mercado: org_domains.market_code).
+ *   Esto no lo decide la geolocalización: así cada URL tiene un solo idioma/moneda (SEO, hreflang, caché de CDN).
+ * - La geolocalización solo SUGIERE (banner "¿Ver la tienda de Estados Unidos?"); nunca redirige sola, nunca a rastreadores
+ *   y respeta la elección guardada del comprador.
+ * - Precios, impuestos y envío NO dependen de la IP: dependen del mercado del dominio y de la dirección de entrega.
+ * - El país sale de las cabeceras que pone el CDN/proxy (no se puede confiar en ellas si el servidor está expuesto
+ *   directo a internet: solo se leen con `trustProxy`).
+ */
+type MarketInfo = {
+    /** Código del mercado en OPS ("mx", "us"). */
+    code: string;
+    /** ISO 3166-1 alfa-2 a los que vende. */
+    countries: string[];
+    /** BCP 47 por defecto ("es-MX", "en-US"). */
+    locale: string;
+    /** ISO 4217 ("MXN", "USD"). */
+    currency: string;
+    /** Dominio público del mercado, si es distinto del actual ("godsnutrition.com"). */
+    host?: string;
+};
+/** Cabeceras de país de los CDN/proxies más comunes, en orden de preferencia. */
+declare const COUNTRY_HEADERS: readonly ["cf-ipcountry", "cloudfront-viewer-country", "x-vercel-ip-country", "x-appengine-country", "x-country-code"];
+/** País del visitante según el CDN. `null` si no viene, es desconocido (XX), Tor (T1) o no es ISO alfa-2. */
+declare function visitorCountry(headers: Headers, { trustProxy }?: {
+    trustProxy?: boolean;
+}): string | null;
+/** Idiomas de Accept-Language ordenados por q (mayor primero), en minúsculas. */
+declare function preferredLanguages(acceptLanguage: string | null | undefined): string[];
+/** Mejor idioma entre los que ofrece la tienda: coincidencia exacta, luego por idioma base; si no, el de `fallback`. */
+declare function negotiateLocale(acceptLanguage: string | null | undefined, available: string[], fallback: string): string;
+type MarketSuggestion = {
+    market: MarketInfo;
+    /** Qué disparó la sugerencia. El país manda; el idioma solo si el CDN no dio país. */
+    reason: 'country' | 'language';
+};
+/**
+ * ¿Conviene sugerir otro mercado a esta visita? `null` si no (ya está en el correcto, rastreador, ya eligió, o no hay otro).
+ * `chosen` es el código que el comprador guardó al elegir a mano ("market" en cookie): si existe, no se vuelve a sugerir.
+ */
+declare function suggestMarket({ headers, markets, current, chosen, trustProxy, }: {
+    headers: Headers;
+    markets: MarketInfo[];
+    current: string;
+    chosen?: string | null;
+    trustProxy?: boolean;
+}): MarketSuggestion | null;
+/**
+ * Enlaces `hreflang` para <head>: un alterno por mercado con dominio propio, más x-default (el mercado por defecto).
+ * `path` es la ruta con query actual ("/productos/x"). Es lo que permite a buscadores servir cada país en su idioma.
+ */
+declare function hreflangLinks(markets: MarketInfo[], path: string, defaultMarket: string, protocol?: string): {
+    hrefLang: string;
+    href: string;
+}[];
+
+export { Address, AddressInput, Article, type ArticleListParams, Availability, type AvailabilityLocale, type AvailabilityMessageKey, type AvailabilityMessages, AvailabilityStatus, type AvailabilityTone, type AvailabilityView, type AvailabilityViewOptions, CLIENT_IP_HEADER, COUNTRY_HEADERS, Cart, CartBuyerInput, CartLineInput, CartLineProblem, type CartLineProblemView, CartLineUpdateInput, CartPromotions, CartRecommendations, CheckoutInput, CheckoutResult, Collection, type CollectionListParams, Connection, Customer, CustomerIdentifier, CustomerSession, CustomerSessionInput, DeclineCode, DeliveryInput, DeliveryOptions, type DiscountBarState, type DiscountBarView, type FetchLike, type FormatMoneyOptions, GeoPoint, InsufficientStockLine, InvoiceRequest, InvoiceResult, Location, LocationListParams, type MarketInfo, type MarketSuggestion, Menu, Money, NOTE_MAX_LENGTH, NearestLocation, Order, Page, type PaginationParams, PaymentAttemptResult, PaymentConfig, type PaymentErrorKind, type PaymentErrorView, type PaymentLocale, type PaymentMessageKey, type PaymentMessages, PaymentMethods, PaymentNextStep, type PaymentOutcome, type PaymentOutcomeKind, PaymentSubmitInput, PaymentVoucher, type PreviewOptions, Product, ProductConnection, type ProductListParams, ProductSort, ProductVariant, type PromoProgressView, type PromotionLocale, type PromotionMessageKey, type PromotionMessages, PromotionReward, PromotionsList, type QueryParams, type QueryValue, RecommendationPlacement, type RequestOptions, type ResolveAvailabilityOptions, RestockSubscriptionInput, RestockSubscriptionResult, ReturnRequest, ReturnRequestInput, type ShippingBarState, type ShippingBarView, Shop, StockLevel, type StorefrontClient, type StorefrontClientOptions, StorefrontError, StorefrontErrorCode, type StorefrontErrorInit, type StorefrontRequestContext, type StorefrontResponseContext, Theme, type WriteOptions, appendParams, availabilityLocale, availabilityMessages, availabilityView, cartLineProblemView, clampPercent, createStorefrontClient, declineMessage, declineMessageKey, formatAvailabilityMessage, formatMoney, formatVoucherExpiry, generateIdempotencyKey, hreflangLinks, isStorefrontError, isTokenPublishable, negotiateLocale, normalizeClientIp, normalizeNote, parseMoney, parseProductFilters, paymentErrorView, paymentIdempotencyKey, paymentMessages, paymentOutcome, preferredLanguages, productAvailability, productListQuery, promoProgressView, promotionMessages, resolveAvailability, rewardLabel, safeHttpsUrl, schemaAvailability, storefrontDomainHeader, suggestMarket, toMoney, visitorCountry };

package/dist/index.js

@@ -203,6 +203,7 @@ function createStorefrontClient(config) {
     headers.set("Accept", "application/json");
     headers.set("Authorization", `Bearer ${config.token}`);
     if (config.locale) headers.set("Accept-Language", config.locale);
+    if (config.domain) headers.set("X-Storefront-Domain", storefrontDomainHeader(config.domain, config.market));
     const customerToken = options.customerToken !== void 0 ? options.customerToken : config.customerToken;
     if (customerToken) headers.set("X-Customer-Token", customerToken);
     const clientIp = options.clientIp !== void 0 ? options.clientIp : config.clientIp;
@@ -405,6 +406,11 @@ function createStorefrontClient(config) {
   };
   return client;
 }
+function storefrontDomainHeader(domain, market) {
+  const host = domain.trim();
+  const code = (market ?? "").trim().toLowerCase();
+  return code && /^[a-z0-9_-]{1,32}$/.test(code) ? `${host}#${code}` : host;
+}
 
 // src/payments.ts
 var ES = {
@@ -826,6 +832,65 @@ function promoProgressView(promotions, locale, overrides) {
   return { discount, shipping };
 }
 
-export { CLIENT_IP_HEADER, NOTE_MAX_LENGTH, StorefrontError, appendParams, clampPercent, createStorefrontClient, declineMessage, declineMessageKey, formatMoney, formatVoucherExpiry, generateIdempotencyKey, isStorefrontError, isTokenPublishable, normalizeClientIp, normalizeNote, parseMoney, parseProductFilters, paymentErrorView, paymentIdempotencyKey, paymentMessages, paymentOutcome, productListQuery, promoProgressView, promotionMessages, rewardLabel, safeHttpsUrl, toMoney };
+// src/market.ts
+var COUNTRY_HEADERS = ["cf-ipcountry", "cloudfront-viewer-country", "x-vercel-ip-country", "x-appengine-country", "x-country-code"];
+var BOT = /bot|crawl|spider|slurp|bing|facebookexternalhit|embedly|preview|lighthouse|headless|curl|wget/i;
+function visitorCountry(headers, { trustProxy = true } = {}) {
+  if (!trustProxy) return null;
+  for (const name of COUNTRY_HEADERS) {
+    const value = headers.get(name)?.trim().toUpperCase();
+    if (value && /^[A-Z]{2}$/.test(value) && value !== "XX" && value !== "T1") return value;
+  }
+  return null;
+}
+function preferredLanguages(acceptLanguage) {
+  if (!acceptLanguage) return [];
+  return acceptLanguage.split(",").map((part, index) => {
+    const [tag = "", ...params] = part.trim().split(";");
+    const q = Number(params.find((p) => p.trim().startsWith("q="))?.split("=")[1] ?? 1);
+    return { tag: tag.trim().toLowerCase(), q: Number.isFinite(q) ? q : 0, index };
+  }).filter((l) => l.tag && l.tag !== "*" && l.q > 0).sort((a, b) => b.q - a.q || a.index - b.index).map((l) => l.tag);
+}
+function negotiateLocale(acceptLanguage, available, fallback) {
+  const lowered = new Map(available.map((l) => [l.toLowerCase(), l]));
+  for (const wanted of preferredLanguages(acceptLanguage)) {
+    const exact = lowered.get(wanted);
+    if (exact) return exact;
+    const base = wanted.split("-")[0];
+    const sameBase = available.find((l) => l.toLowerCase().split("-")[0] === base);
+    if (sameBase) return sameBase;
+  }
+  return fallback;
+}
+function suggestMarket({
+  headers,
+  markets,
+  current,
+  chosen,
+  trustProxy = true
+}) {
+  if (chosen || markets.length < 2) return null;
+  if (BOT.test(headers.get("user-agent") ?? "")) return null;
+  const country = visitorCountry(headers, { trustProxy });
+  if (country) {
+    const target = markets.find((m) => m.countries.includes(country));
+    return target && target.code !== current ? { market: target, reason: "country" } : null;
+  }
+  for (const tag of preferredLanguages(headers.get("accept-language"))) {
+    const region = tag.split("-")[1]?.toUpperCase();
+    if (!region) continue;
+    const target = markets.find((m) => m.countries.includes(region));
+    if (target) return target.code !== current ? { market: target, reason: "language" } : null;
+  }
+  return null;
+}
+function hreflangLinks(markets, path, defaultMarket, protocol = "https") {
+  const links = markets.filter((m) => m.host).map((m) => ({ hrefLang: m.locale, href: `${protocol}://${m.host}${path}` }));
+  const fallback = markets.find((m) => m.code === defaultMarket && m.host);
+  if (fallback) links.push({ hrefLang: "x-default", href: `${protocol}://${fallback.host}${path}` });
+  return links;
+}
+
+export { CLIENT_IP_HEADER, COUNTRY_HEADERS, NOTE_MAX_LENGTH, StorefrontError, appendParams, clampPercent, createStorefrontClient, declineMessage, declineMessageKey, formatMoney, formatVoucherExpiry, generateIdempotencyKey, hreflangLinks, isStorefrontError, isTokenPublishable, negotiateLocale, normalizeClientIp, normalizeNote, parseMoney, parseProductFilters, paymentErrorView, paymentIdempotencyKey, paymentMessages, paymentOutcome, preferredLanguages, productListQuery, promoProgressView, promotionMessages, rewardLabel, safeHttpsUrl, storefrontDomainHeader, suggestMarket, toMoney, visitorCountry };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map