@asteby/storefront 0.5.0 → 0.6.0

package/dist/index.js

@@ -1,3 +1,5 @@
+import { availabilityLocale, formatAvailabilityMessage } from './chunk-HBSB7XS2.js';
+export { availabilityLocale, availabilityMessages, availabilityView, cartLineProblemView, formatAvailabilityMessage, productAvailability, resolveAvailability, schemaAvailability } from './chunk-HBSB7XS2.js';
 import { isValidPoint } from './chunk-45R47HYO.js';
 
 // src/errors.ts
@@ -6,14 +8,26 @@ var StorefrontError = class extends Error {
   status;
   code;
   field;
+  details;
   url;
   constructor(init) {
     super(init.message, init.cause === void 0 ? void 0 : { cause: init.cause });
     this.status = init.status;
     this.code = init.code;
     this.field = init.field;
+    this.details = init.details;
     this.url = init.url;
   }
+  /**
+   * Affected lines of a `409 insufficient_stock` (empty for any other error or a
+   * server older than contract 1.1). The cart is untouched: show the lines and
+   * let the buyer adjust or remove them.
+   */
+  get stockLines() {
+    const lines = this.details?.lines;
+    if (this.code !== "insufficient_stock" || !Array.isArray(lines)) return [];
+    return lines.filter((l) => typeof l === "object" && l !== null && typeof l.sku === "string");
+  }
   toJSON() {
     return { name: this.name, status: this.status, code: this.code, message: this.message, field: this.field };
   }
@@ -46,7 +60,7 @@ function formatMoney(money, locale, options = {}) {
   const whole = Number.isInteger(value);
   const digits = options.withoutTrailingZeros && whole ? 0 : void 0;
   try {
-    const fmt = new Intl.NumberFormat(locale, {
+    const fmt2 = new Intl.NumberFormat(locale, {
       ...options.withoutCurrency ? { style: "decimal", minimumFractionDigits: digits ?? 2, maximumFractionDigits: digits ?? 2 } : {
         style: "currency",
         currency: money.currency_code,
@@ -54,7 +68,7 @@ function formatMoney(money, locale, options = {}) {
         ...digits === 0 ? { minimumFractionDigits: 0, maximumFractionDigits: 0 } : {}
       }
     });
-    return fmt.format(value);
+    return fmt2.format(value);
   } catch {
     const amount = digits === 0 ? String(value) : value.toFixed(2);
     return options.withoutCurrency ? amount : `${amount} ${money.currency_code}`;
@@ -167,6 +181,7 @@ async function readError(res, url) {
     code: e?.code ?? defaultCodeForStatus(res.status),
     message: e?.message ?? `Storefront API responded ${res.status}${res.statusText ? " " + res.statusText : ""}`,
     ...e?.field ? { field: e.field } : {},
+    ...e?.details !== void 0 ? { details: e.details } : {},
     url
   });
 }
@@ -298,6 +313,13 @@ function createStorefrontClient(config) {
       /** Stock for up to 250 SKUs. */
       get: (skus, options) => get("/storefront/stock", { sku: skus }, options)
     },
+    restock: {
+      /**
+       * "Notify me when it is back". Idempotent per contact + SKU; always answers `202 pending`.
+       * Only offered when `availability.notify_available` is true. Needs `customer:write`.
+       */
+      subscribe: (input, options) => write("POST", "/storefront/restock-subscriptions", input, options)
+    },
     carts: {
       create: (input = {}, options) => write("POST", "/storefront/carts", input, options),
       /** `null` when the cart does not exist (e.g. expired cookie). */
@@ -313,13 +335,37 @@ function createStorefrontClient(config) {
       /** Payment providers active for the cart's market; send the chosen `key` as `payment_method`. */
       paymentMethods: (id, options) => get(cartPath(id, "/payment-methods"), void 0, options),
       setDelivery: (id, delivery, options) => write("PUT", cartPath(id, "/delivery"), delivery, options),
+      /** Order note (up to 1000 characters). `null` or empty clears it. */
+      setNote: (id, note, options) => write("PUT", cartPath(id, "/note"), { note }, options),
+      /**
+       * Cross-sell suggestions: only sellable variants, with `unlocks` when adding one reaches the next
+       * discount tier. `first` 1-8 (default 4). `private, no-store`; ask on demand, not on every render.
+       */
+      recommendations: (id, params = {}, options) => get(cartPath(id, "/recommendations"), params, options),
       /** Reserves stock and creates the order. Sends `Idempotency-Key` (auto-generated if omitted). */
       checkout: (id, input, options = {}) => write("POST", cartPath(id, "/checkout"), input, {
         ...options,
         idempotencyKey: options.idempotencyKey ?? generateIdempotencyKey()
       })
     },
+    promotions: {
+      /** Public promotions and the entry pop-up announcement for the request's market (cacheable). */
+      list: (options) => get("/storefront/promotions", void 0, options)
+    },
     checkouts: {
+      /** What to mount for an embedded checkout (public key, options, amount) and whether it can still be paid. Never cache. */
+      paymentConfig: (id, options) => getOrNull(`/storefront/checkouts/${enc(id)}/payment-config`, void 0, options),
+      /**
+       * Pays a checkout in the page. The browser brings only what the provider SDK returned (`provider_data`);
+       * the amount is the server's. `idempotencyKey` is REQUIRED (use `paymentIdempotencyKey(checkoutId, attempt)`):
+       * repeating a call with the same key never charges twice. Needs a server token (`checkout:write`).
+       */
+      pay: (id, input, options) => {
+        if (!options || typeof options.idempotencyKey !== "string" || !options.idempotencyKey.trim()) {
+          throw new TypeError("checkouts.pay: idempotencyKey is required");
+        }
+        return write("POST", `/storefront/checkouts/${enc(id)}/payment`, input, options);
+      },
       /**
        * Reads a placed checkout (same shape as the `carts.checkout` result). `order.number` is `null` until OPS
        * has created the order (a few hundred ms after checkout); poll once or twice and, if it is still `null`,
@@ -360,6 +406,426 @@ function createStorefrontClient(config) {
   return client;
 }
 
-export { CLIENT_IP_HEADER, StorefrontError, appendParams, createStorefrontClient, formatMoney, generateIdempotencyKey, isStorefrontError, isTokenPublishable, normalizeClientIp, parseMoney, parseProductFilters, productListQuery, toMoney };
+// src/payments.ts
+var ES = {
+  "decline.insufficient_funds": "Tu tarjeta no tiene saldo suficiente. Prueba con otra tarjeta o paga en efectivo.",
+  "decline.invalid_cvc": "El c\xF3digo de seguridad no es correcto. Rev\xEDsalo e intenta de nuevo.",
+  "decline.invalid_expiry": "La fecha de vencimiento no es correcta.",
+  "decline.invalid_card_data": "Revisa los datos de tu tarjeta.",
+  "decline.call_issuer": "Tu banco necesita que autorices este pago. Llama al n\xFAmero al reverso de tu tarjeta y vuelve a intentarlo.",
+  "decline.card_disabled": "Tu tarjeta no est\xE1 activa. Act\xEDvala con tu banco o usa otra.",
+  "decline.duplicate": "Ya hiciste un pago igual hace un momento. Revisa tu correo antes de volver a pagar.",
+  "decline.max_attempts": "Llegaste al l\xEDmite de intentos con esta tarjeta. Usa otra o paga en efectivo.",
+  "decline.authentication_failed": "Tu banco no pudo verificar el pago. Intenta de nuevo o usa otra tarjeta.",
+  "decline.declined": "Tu banco rechaz\xF3 el pago. Usa otra tarjeta o paga en efectivo.",
+  "state.loading": "Cargando pago seguro\u2026",
+  "state.processing": "Procesando pago\u2026",
+  "state.approved": "\xA1Pago aprobado!",
+  "state.in_review": "Tu pago est\xE1 en revisi\xF3n. Te avisamos por correo en m\xE1ximo 2 d\xEDas h\xE1biles. No vuelvas a pagar.",
+  "state.voucher": "Tu ficha de pago est\xE1 lista. El pedido se confirma cuando pagues.",
+  "state.challenge": "Tu banco necesita verificar el pago. Termina la verificaci\xF3n para continuar.",
+  "state.expired": "La ficha venci\xF3. Vuelve a armar tu carrito para pagar.",
+  "state.cancelled": "El pago se cancel\xF3. Puedes intentarlo de nuevo.",
+  "state.redirect": "Te llevamos a la p\xE1gina de pago\u2026",
+  "state.fallback": "No pudimos cargar el formulario seguro de tarjeta. Puedes pagar con tarjeta en el sitio del proveedor y regresar aqu\xED.",
+  "error.network": "No pudimos conectar. Revisa tu conexi\xF3n e intenta de nuevo; no se te cobrar\xE1 dos veces.",
+  "error.card_data": "Revisa los datos de tu tarjeta.",
+  "error.price_mismatch": "El total cambi\xF3. Revisa el nuevo total y vuelve a pagar.",
+  "error.payment_in_progress": "Ya hay un pago en proceso para este pedido. No vuelvas a pagar; revisa tu correo.",
+  "error.expired": "Tu apartado venci\xF3. Vuelve a armar tu carrito.",
+  "error.too_many_attempts": "Por seguridad no podemos intentar con m\xE1s tarjetas. Paga en efectivo o escr\xEDbenos.",
+  "error.generic": "No pudimos procesar tu pago. Intenta de nuevo.",
+  "action.retry": "Reintentar",
+  "action.try_again": "Intentar de nuevo",
+  "action.pay": "Pagar",
+  "action.cancel": "Cancelar",
+  "voucher.title": "Ficha de pago",
+  "voucher.point": "Punto de pago",
+  "voucher.reference": "Referencia",
+  "voucher.amount": "Monto exacto",
+  "voucher.expires": "Vence el {date}",
+  "voucher.clabe": "CLABE",
+  "voucher.barcode": "C\xF3digo de barras",
+  "voucher.open": "Ver o imprimir ficha",
+  "voucher.email": "Tambi\xE9n te la enviamos a tu correo.",
+  "form.label": "Datos de tu tarjeta",
+  "challenge.title": "Verificaci\xF3n de tu banco"
+};
+var EN = {
+  "decline.insufficient_funds": "Your card has insufficient funds. Try another card or pay in cash.",
+  "decline.invalid_cvc": "The security code is not correct. Check it and try again.",
+  "decline.invalid_expiry": "The expiry date is not correct.",
+  "decline.invalid_card_data": "Check your card details.",
+  "decline.call_issuer": "Your bank needs you to authorize this payment. Call the number on the back of your card and try again.",
+  "decline.card_disabled": "Your card is not active. Activate it with your bank or use another one.",
+  "decline.duplicate": "You already made the same payment a moment ago. Check your email before paying again.",
+  "decline.max_attempts": "You reached the attempt limit for this card. Use another card or pay in cash.",
+  "decline.authentication_failed": "Your bank could not verify the payment. Try again or use another card.",
+  "decline.declined": "Your bank declined the payment. Use another card or pay in cash.",
+  "state.loading": "Loading secure payment\u2026",
+  "state.processing": "Processing payment\u2026",
+  "state.approved": "Payment approved!",
+  "state.in_review": "Your payment is under review. We will email you within 2 business days. Do not pay again.",
+  "state.voucher": "Your payment voucher is ready. The order is confirmed once you pay.",
+  "state.challenge": "Your bank needs to verify the payment. Finish the verification to continue.",
+  "state.expired": "The voucher expired. Rebuild your cart to pay.",
+  "state.cancelled": "The payment was cancelled. You can try again.",
+  "state.redirect": "Taking you to the payment page\u2026",
+  "state.fallback": "We could not load the secure card form. You can pay by card on the provider site and come back here.",
+  "error.network": "We could not connect. Check your connection and try again; you will not be charged twice.",
+  "error.card_data": "Check your card details.",
+  "error.price_mismatch": "The total changed. Review the new total and pay again.",
+  "error.payment_in_progress": "A payment is already in progress for this order. Do not pay again; check your email.",
+  "error.expired": "Your reservation expired. Rebuild your cart.",
+  "error.too_many_attempts": "For security we cannot try more cards. Pay in cash or contact us.",
+  "error.generic": "We could not process your payment. Please try again.",
+  "action.retry": "Retry",
+  "action.try_again": "Try again",
+  "action.pay": "Pay",
+  "action.cancel": "Cancel",
+  "voucher.title": "Payment voucher",
+  "voucher.point": "Payment point",
+  "voucher.reference": "Reference",
+  "voucher.amount": "Exact amount",
+  "voucher.expires": "Expires on {date}",
+  "voucher.clabe": "CLABE",
+  "voucher.barcode": "Barcode",
+  "voucher.open": "View or print voucher",
+  "voucher.email": "We also emailed it to you.",
+  "form.label": "Your card details",
+  "challenge.title": "Your bank verification"
+};
+var CATALOG = { es: ES, en: EN };
+function paymentMessages(locale, overrides) {
+  const base = CATALOG[availabilityLocale(locale)];
+  if (!overrides) return base;
+  const out = { ...base };
+  for (const [k, v] of Object.entries(overrides)) if (typeof v === "string" && k in base) out[k] = v;
+  return out;
+}
+var DECLINE_CODES = /* @__PURE__ */ new Set([
+  "insufficient_funds",
+  "invalid_cvc",
+  "invalid_expiry",
+  "invalid_card_data",
+  "call_issuer",
+  "card_disabled",
+  "duplicate",
+  "max_attempts",
+  "authentication_failed",
+  "declined"
+]);
+function declineMessageKey(code) {
+  return `decline.${code && DECLINE_CODES.has(code) ? code : "declined"}`;
+}
+function declineMessage(code, locale, overrides) {
+  return paymentMessages(locale, overrides)[declineMessageKey(code)];
+}
+function safeHttpsUrl(value) {
+  if (typeof value !== "string" || value.length > 2048) return null;
+  try {
+    const u = new URL(value);
+    if (u.protocol !== "https:" || u.username || u.password) return null;
+    return u.toString();
+  } catch {
+    return null;
+  }
+}
+var NEXT_STEP = {
+  insufficient_funds: "use_other_card",
+  invalid_cvc: "fix_card_data",
+  invalid_expiry: "fix_card_data",
+  invalid_card_data: "fix_card_data",
+  call_issuer: "contact_issuer",
+  card_disabled: "use_other_card",
+  duplicate: "check_email",
+  max_attempts: "use_other_card",
+  authentication_failed: "retry",
+  declined: "use_other_card"
+};
+function voucherMoney(v) {
+  const a = v.amount;
+  if (a && typeof a === "object" && typeof a.amount === "string") return a;
+  const text = typeof a === "number" ? String(a) : typeof a === "string" ? a : "";
+  if (!text || !/^\d+(\.\d+)?$/.test(text) || !v.currency) return null;
+  return { amount: text.includes(".") ? text : `${text}.00`, currency_code: v.currency };
+}
+function paymentOutcome(result, locale, overrides) {
+  const m = paymentMessages(locale, overrides);
+  const p = result.payment;
+  const action = p.action ?? null;
+  const base = {
+    decline_code: null,
+    retryable: false,
+    redirect_url: null,
+    challenge: null,
+    voucher: null,
+    attempts_left: typeof result.attempts_left === "number" ? result.attempts_left : null,
+    next_step: p.next_step ?? null
+  };
+  const out = (kind, message, extra = {}) => ({ ...base, kind, message, ...extra });
+  if (p.status === "paid") return out("approved", m["state.approved"]);
+  if (p.status === "failed") {
+    const code = p.decline_code ?? "declined";
+    const known = DECLINE_CODES.has(code) ? code : "declined";
+    return out("rejected", m[declineMessageKey(code)], {
+      decline_code: known,
+      next_step: p.next_step ?? NEXT_STEP[known],
+      retryable: p.retryable !== false && base.attempts_left !== 0
+    });
+  }
+  if (p.status === "expired") return out("expired", m["state.expired"], { next_step: "rebuild_cart" });
+  if (p.status === "cancelled") return out("cancelled", m["state.cancelled"], { retryable: true, next_step: "rebuild_cart" });
+  if (action?.type === "redirect") {
+    const url = safeHttpsUrl(action.redirect_url);
+    if (url) return out("redirect", m["state.redirect"], { redirect_url: url });
+  }
+  if (p.status === "requires_action" || p.status === "pending") {
+    if (action?.type === "voucher" && action.voucher) {
+      const { amount: _a, currency: _c, voucher_url, ...rest } = action.voucher;
+      return out("voucher", m["state.voucher"], {
+        next_step: "pay_cash",
+        voucher: { ...rest, voucher_url: safeHttpsUrl(voucher_url), amount: voucherMoney(action.voucher) }
+      });
+    }
+    if (action?.type === "challenge" && action.challenge) {
+      return out("challenge", m["state.challenge"], {
+        challenge: { url: safeHttpsUrl(action.challenge.url), creq: typeof action.challenge.creq === "string" ? action.challenge.creq : null }
+      });
+    }
+  }
+  return out("in_review", m["state.in_review"]);
+}
+function paymentErrorView(err, locale, overrides) {
+  const m = paymentMessages(locale, overrides);
+  const e = err ?? {};
+  const status = typeof e.status === "number" ? e.status : 0;
+  const code = typeof e.code === "string" ? e.code : "";
+  if (code === "price_mismatch") {
+    return { kind: "price_mismatch", message: m["error.price_mismatch"], retrySameAttempt: false, canRetry: true };
+  }
+  if (status === 409 && code === "expired") return { kind: "expired", message: m["error.expired"], retrySameAttempt: false, canRetry: false };
+  if (status === 409 && code === "payment_in_progress") {
+    return { kind: "payment_in_progress", message: m["error.payment_in_progress"], retrySameAttempt: false, canRetry: false };
+  }
+  if (status === 409) return { kind: "generic", message: m["error.generic"], retrySameAttempt: false, canRetry: true };
+  if (status === 429 || code === "too_many_attempts") {
+    return { kind: "too_many_attempts", message: m["error.too_many_attempts"], retrySameAttempt: false, canRetry: false };
+  }
+  if (status === 0 || status === 502 || status === 503 || status === 504 || code === "network" || code === "timeout") {
+    return { kind: "network", message: m["error.network"], retrySameAttempt: true, canRetry: true };
+  }
+  return { kind: "generic", message: m["error.generic"], retrySameAttempt: false, canRetry: true };
+}
+function formatVoucherExpiry(expiresAt, locale, overrides) {
+  if (!expiresAt) return null;
+  const d = new Date(expiresAt);
+  if (Number.isNaN(d.getTime())) return null;
+  let date;
+  try {
+    date = new Intl.DateTimeFormat(locale ?? void 0, { dateStyle: "long", timeStyle: "short" }).format(d);
+  } catch {
+    date = d.toISOString();
+  }
+  return formatAvailabilityMessage(paymentMessages(locale, overrides)["voucher.expires"], { date });
+}
+function paymentIdempotencyKey(checkoutId, attempt) {
+  return `pay-${checkoutId}-${attempt}`;
+}
+
+// src/promotions.ts
+var ES2 = {
+  "discount.next": "A\xF1ade {remaining} para activar tu descuento autom\xE1tico",
+  "discount.next_upgrade": "A\xF1ade {remaining} para subir a {reward}",
+  "discount.applied": "\xA1Tienes {reward} de descuento!",
+  "discount.max": "\xA1Tienes {reward} de descuento, el m\xE1ximo!",
+  "discount.suppressed": "Tu c\xF3digo de descuento ya te da un mejor precio.",
+  "discount.unlocks": "Desbloqueas {reward} de descuento",
+  "discount.remaining": "Te faltan {remaining}",
+  "shipping.progress": "A\xF1ade {remaining} para env\xEDo gratis",
+  "shipping.reached": "\xA1Felicidades! Tienes env\xEDo gratis",
+  "shipping.always": "Env\xEDo gratis en todo tu pedido",
+  "reward.free_shipping": "Env\xEDo gratis",
+  "bar.discount": "Progreso del descuento autom\xE1tico",
+  "bar.shipping": "Progreso del env\xEDo gratis",
+  "popup.close": "Cerrar",
+  "popup.valid_until": "V\xE1lido hasta el {date}",
+  "popup.limited_time": "Por tiempo limitado",
+  "popup.discount_tier": "{reward} comprando {threshold}",
+  "popup.free_shipping_min": "Env\xEDo gratis desde {threshold}",
+  "popup.free_shipping_always": "Env\xEDos gratis sin m\xEDnimo de compra",
+  "upsell.title": "Completa tu compra y desbloquea m\xE1s",
+  "upsell.subtitle": "Descuento autom\xE1tico",
+  "upsell.next_level": "Siguiente nivel",
+  "upsell.you_miss": "Te faltan {remaining}",
+  "upsell.unlocks_reward": "Desbloqueas {reward} de descuento",
+  "upsell.total_saved": "Total ahorrado",
+  "upsell.current_benefit": "Beneficio actual",
+  "upsell.status": "Estado",
+  "upsell.status_pending": "Pendiente",
+  "upsell.status_active": "Activo",
+  "upsell.next_reward": "Siguiente recompensa {reward} \xB7 {threshold}",
+  "upsell.suggestions": "Suma y desbloquea \xB7 Productos que pueden interesarte",
+  "upsell.add": "Agregar y avanzar +",
+  "upsell.adding": "Agregando\u2026",
+  "upsell.flavor": "Sabor",
+  "upsell.unlocks_badge": "Desbloquea tu {reward}",
+  "upsell.unlocked": "\xA1Desbloqueaste {reward}!",
+  "upsell.best": "Tienes el mejor descuento: {reward}",
+  "upsell.skip": "Continuar sin agregar",
+  "upsell.continue": "Continuar al pago",
+  "upsell.footer": "Tu mejor descuento se aplica autom\xE1ticamente",
+  "upsell.sold_out": "Se agot\xF3 este sabor, elige otro.",
+  "upsell.error": "No pudimos agregarlo. Intenta de nuevo.",
+  "note.label": "A\xF1adir nota",
+  "note.placeholder": "Instrucciones para tu pedido",
+  "note.save": "Guardar nota",
+  "note.saving": "Guardando\u2026",
+  "note.saved": "Guardada",
+  "note.error": "No se pudo guardar la nota. Intenta de nuevo.",
+  "note.counter": "{n} de {max} caracteres"
+};
+var EN2 = {
+  "discount.next": "Add {remaining} to unlock your automatic discount",
+  "discount.next_upgrade": "Add {remaining} to move up to {reward}",
+  "discount.applied": "You have {reward} off!",
+  "discount.max": "You have {reward} off, the maximum!",
+  "discount.suppressed": "Your discount code already gives you a better price.",
+  "discount.unlocks": "Unlock {reward} off",
+  "discount.remaining": "{remaining} to go",
+  "shipping.progress": "Add {remaining} for free shipping",
+  "shipping.reached": "Congratulations! You get free shipping",
+  "shipping.always": "Free shipping on your whole order",
+  "reward.free_shipping": "Free shipping",
+  "bar.discount": "Automatic discount progress",
+  "bar.shipping": "Free shipping progress",
+  "popup.close": "Close",
+  "popup.valid_until": "Valid until {date}",
+  "popup.limited_time": "Limited time",
+  "popup.discount_tier": "{reward} when you spend {threshold}",
+  "popup.free_shipping_min": "Free shipping from {threshold}",
+  "popup.free_shipping_always": "Free shipping, no minimum purchase",
+  "upsell.title": "Complete your purchase and unlock more",
+  "upsell.subtitle": "Automatic discount",
+  "upsell.next_level": "Next level",
+  "upsell.you_miss": "{remaining} to go",
+  "upsell.unlocks_reward": "Unlock {reward} off",
+  "upsell.total_saved": "Total saved",
+  "upsell.current_benefit": "Current benefit",
+  "upsell.status": "Status",
+  "upsell.status_pending": "Pending",
+  "upsell.status_active": "Active",
+  "upsell.next_reward": "Next reward {reward} \xB7 {threshold}",
+  "upsell.suggestions": "Add and unlock \xB7 Products you may like",
+  "upsell.add": "Add and move up +",
+  "upsell.adding": "Adding\u2026",
+  "upsell.flavor": "Flavor",
+  "upsell.unlocks_badge": "Unlocks your {reward}",
+  "upsell.unlocked": "You unlocked {reward}!",
+  "upsell.best": "You have the best discount: {reward}",
+  "upsell.skip": "Continue without adding",
+  "upsell.continue": "Continue to payment",
+  "upsell.footer": "Your best discount is applied automatically",
+  "upsell.sold_out": "This flavor sold out, pick another one.",
+  "upsell.error": "We could not add it. Please try again.",
+  "note.label": "Add a note",
+  "note.placeholder": "Instructions for your order",
+  "note.save": "Save note",
+  "note.saving": "Saving\u2026",
+  "note.saved": "Saved",
+  "note.error": "The note could not be saved. Please try again.",
+  "note.counter": "{n} of {max} characters"
+};
+var CATALOG2 = { es: ES2, en: EN2 };
+function promotionMessages(locale, overrides) {
+  const base = CATALOG2[availabilityLocale(locale)];
+  if (!overrides) return base;
+  const out = { ...base };
+  for (const [k, v] of Object.entries(overrides)) if (typeof v === "string" && k in base) out[k] = v;
+  return out;
+}
+var NOTE_MAX_LENGTH = 1e3;
+function normalizeNote(note) {
+  const t = (note ?? "").trim();
+  return t ? t.slice(0, NOTE_MAX_LENGTH) : null;
+}
+function rewardLabel(reward, locale, overrides) {
+  const m = promotionMessages(locale, overrides);
+  if (reward.kind === "free_shipping") return m["reward.free_shipping"];
+  if (reward.kind === "fixed") return formatMoney(reward.amount, locale ?? void 0, { withoutTrailingZeros: true });
+  const n = Number.parseFloat(reward.percent);
+  let num = reward.percent;
+  try {
+    if (Number.isFinite(n)) num = new Intl.NumberFormat(locale ?? void 0, { maximumFractionDigits: 4 }).format(n);
+  } catch {
+  }
+  return availabilityLocale(locale) === "en" ? `${num}%` : `${num} %`;
+}
+function clampPercent(value) {
+  const n = typeof value === "number" ? value : Number.parseFloat(String(value));
+  if (!Number.isFinite(n)) return 0;
+  return Math.min(100, Math.max(0, Math.round(n)));
+}
+var fmt = (money, locale) => formatMoney(money, locale ?? void 0, { withoutTrailingZeros: true });
+function promoProgressView(promotions, locale, overrides) {
+  if (!promotions) return { discount: null, shipping: null };
+  const m = promotionMessages(locale, overrides);
+  const f = (tpl, vars) => formatAvailabilityMessage(tpl, vars);
+  let discount = null;
+  const hasTiers = promotions.tiers.length > 0 || promotions.next_tier !== null || promotions.applied !== null;
+  if (hasTiers) {
+    const next = promotions.next_tier;
+    const applied = promotions.applied;
+    const appliedReward = applied ? rewardLabel(applied.reward, locale, overrides) : null;
+    let state;
+    let text;
+    if (promotions.suppressed?.reason === "code_better" && !applied) {
+      state = "suppressed";
+      text = m["discount.suppressed"];
+    } else if (!next) {
+      state = "max";
+      text = appliedReward ? f(m["discount.max"], { reward: appliedReward }) : m["discount.suppressed"];
+    } else if (applied) {
+      state = "upgrade";
+      text = f(m["discount.next_upgrade"], { remaining: fmt(next.remaining, locale), reward: rewardLabel(next.reward, locale, overrides) });
+    } else {
+      state = "next";
+      text = f(m["discount.next"], { remaining: fmt(next.remaining, locale) });
+    }
+    discount = {
+      state,
+      percent: clampPercent(promotions.percent_of_max),
+      text,
+      valueText: text,
+      remaining: next?.remaining ?? null,
+      rewardText: next ? rewardLabel(next.reward, locale, overrides) : appliedReward,
+      appliedText: appliedReward ? f(m["discount.applied"], { reward: appliedReward }) : null,
+      nextText: next ? f(m["discount.unlocks"], { reward: rewardLabel(next.reward, locale, overrides) }) : null,
+      tiers: promotions.tiers.map((t) => ({
+        id: t.id,
+        label: rewardLabel(t.reward, locale, overrides),
+        threshold: fmt(t.threshold, locale),
+        reached: t.reached,
+        position: clampPercent(t.percent_of_max)
+      }))
+    };
+  }
+  let shipping = null;
+  const fs = promotions.free_shipping;
+  if (fs) {
+    const noMinimum = Number.parseFloat(fs.threshold.amount) === 0;
+    if (noMinimum) {
+      shipping = { state: "always", percent: 100, text: m["shipping.always"], valueText: m["shipping.always"], remaining: null, showBar: false };
+    } else if (fs.reached) {
+      shipping = { state: "reached", percent: 100, text: m["shipping.reached"], valueText: m["shipping.reached"], remaining: null, showBar: true };
+    } else {
+      const text = f(m["shipping.progress"], { remaining: fmt(fs.remaining, locale) });
+      shipping = { state: "progress", percent: clampPercent(fs.percent), text, valueText: text, remaining: fs.remaining, showBar: true };
+    }
+  }
+  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 };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map