@asteby/storefront 0.5.0 → 0.6.0

package/dist/index.cjs

@@ -6,14 +6,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 };
   }
@@ -50,7 +62,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,
@@ -58,7 +70,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}`;
@@ -171,6 +183,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
   });
 }
@@ -302,6 +315,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). */
@@ -317,13 +337,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`,
@@ -364,18 +408,677 @@ function createStorefrontClient(config) {
   return client;
 }
 
+// src/availability.ts
+var ES = {
+  "status.in_stock": "Disponible",
+  "status.low_stock": "Pocas piezas",
+  "status.low_stock_n": "Quedan {n}",
+  "status.out_of_stock": "Agotado",
+  "status.backorder": "Bajo pedido",
+  "status.preorder": "Preventa",
+  "sub.backorder_eta": "Se env\xEDa a partir del {date}",
+  "sub.preorder_date": "Sale a la venta el {date}",
+  "cta.add": "Agregar al carrito",
+  "cta.out_of_stock": "Agotado",
+  "cta.backorder": "Pedir bajo pedido",
+  "cta.preorder": "Apartar en preventa",
+  "sr.in_stock": "Disponible",
+  "sr.low_stock": "Quedan pocas piezas",
+  "sr.low_stock_n": "Quedan solo {n} piezas",
+  "sr.out_of_stock": "Producto agotado",
+  "sr.backorder": "Disponible bajo pedido",
+  "sr.preorder": "Disponible en preventa",
+  "option.sold_out": "agotado",
+  "option.backorder": "bajo pedido",
+  "option.preorder": "preventa",
+  max_per_order: "M\xE1ximo {n} por pedido",
+  "notify.title": "Av\xEDsame cuando vuelva",
+  "notify.email": "Correo electr\xF3nico",
+  "notify.phone": "WhatsApp o tel\xE9fono",
+  "notify.consent": "Acepto recibir un aviso cuando vuelva a estar disponible",
+  "notify.submit": "Av\xEDsame",
+  "notify.done": "Listo. Te avisaremos cuando vuelva a estar disponible.",
+  "notify.error": "No pudimos guardar tu aviso. Revisa tus datos e int\xE9ntalo de nuevo.",
+  "problem.out_of_stock": "Ya no hay existencias",
+  "problem.insufficient_stock": "No hay suficientes piezas para esta cantidad",
+  "problem.insufficient_stock_n": "Solo puedes llevar {n}",
+  "problem.adjust": "Ajustar a {n}",
+  "problem.remove": "Quitar",
+  "conflict.title": "Algunos productos cambiaron de existencias",
+  "conflict.body": "Revisa las l\xEDneas marcadas. Tu carrito y tus datos se conservaron; ajusta o quita lo que ya no est\xE1 disponible y contin\xFAa.",
+  "conflict.dismiss": "Entendido"
+};
+var EN = {
+  "status.in_stock": "In stock",
+  "status.low_stock": "Low stock",
+  "status.low_stock_n": "Only {n} left",
+  "status.out_of_stock": "Sold out",
+  "status.backorder": "Made to order",
+  "status.preorder": "Pre-order",
+  "sub.backorder_eta": "Ships from {date}",
+  "sub.preorder_date": "Available on {date}",
+  "cta.add": "Add to cart",
+  "cta.out_of_stock": "Sold out",
+  "cta.backorder": "Order now, ships later",
+  "cta.preorder": "Pre-order",
+  "sr.in_stock": "In stock",
+  "sr.low_stock": "Low stock",
+  "sr.low_stock_n": "Only {n} left in stock",
+  "sr.out_of_stock": "Sold out",
+  "sr.backorder": "Available to order, ships later",
+  "sr.preorder": "Available for pre-order",
+  "option.sold_out": "sold out",
+  "option.backorder": "made to order",
+  "option.preorder": "pre-order",
+  max_per_order: "Maximum {n} per order",
+  "notify.title": "Notify me when it is back",
+  "notify.email": "Email",
+  "notify.phone": "WhatsApp or phone",
+  "notify.consent": "I agree to receive a notice when it is back in stock",
+  "notify.submit": "Notify me",
+  "notify.done": "Done. We will let you know when it is back in stock.",
+  "notify.error": "We could not save your request. Check your details and try again.",
+  "problem.out_of_stock": "No longer in stock",
+  "problem.insufficient_stock": "Not enough stock for this quantity",
+  "problem.insufficient_stock_n": "You can take up to {n}",
+  "problem.adjust": "Adjust to {n}",
+  "problem.remove": "Remove",
+  "conflict.title": "Some items changed stock",
+  "conflict.body": "Review the marked lines. Your cart and your details were kept; adjust or remove what is no longer available and continue.",
+  "conflict.dismiss": "Got it"
+};
+var CATALOG = { es: ES, en: EN };
+function availabilityLocale(locale) {
+  return (locale ?? "").toLowerCase().startsWith("en") ? "en" : "es";
+}
+function availabilityMessages(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;
+}
+function formatAvailabilityMessage(template, values = {}) {
+  return template.replace(/\{(\w+)\}/g, (m, k) => k in values ? String(values[k]) : m);
+}
+function formatDate(value, locale) {
+  if (!value) return null;
+  const d = /^\d{4}-\d{2}-\d{2}$/.test(value) ? /* @__PURE__ */ new Date(`${value}T00:00:00Z`) : new Date(value);
+  if (Number.isNaN(d.getTime())) return null;
+  try {
+    return new Intl.DateTimeFormat(locale || "es", { dateStyle: "long", timeZone: "UTC" }).format(d);
+  } catch {
+    return value.slice(0, 10);
+  }
+}
+function resolveAvailability(source, options = {}) {
+  const a = source.availability;
+  if (a && typeof a === "object" && typeof a.status === "string") return a;
+  const qty = typeof source.quantity_available === "number" ? source.quantity_available : null;
+  const sellable = source.available_for_sale && (qty === null || qty > 0);
+  const threshold = options.lowStockThreshold;
+  const low = sellable && qty !== null && typeof threshold === "number" && threshold > 0 && qty <= threshold;
+  const status = !sellable ? "out_of_stock" : low ? "low_stock" : "in_stock";
+  return {
+    status,
+    quantity: sellable ? qty : null,
+    max_per_order: sellable ? qty : null,
+    restock_eta: null,
+    preorder_release_at: null,
+    // Old servers have no subscription route: never offer a form that cannot work.
+    notify_available: false
+  };
+}
+var TONES = {
+  in_stock: "success",
+  low_stock: "warning",
+  out_of_stock: "danger",
+  backorder: "info",
+  preorder: "info"
+};
+function availabilityView(availability, locale, options = {}) {
+  const m = availabilityMessages(locale, options.messages);
+  const known = ["in_stock", "low_stock", "out_of_stock", "backorder", "preorder"].includes(availability.status);
+  const status = known ? availability.status : "out_of_stock";
+  const qty = typeof availability.quantity === "number" && availability.quantity > 0 ? availability.quantity : null;
+  const f = formatAvailabilityMessage;
+  let label;
+  let sr;
+  let cta;
+  let sublabel = null;
+  let enabled = true;
+  switch (status) {
+    case "in_stock":
+      label = m["status.in_stock"];
+      sr = m["sr.in_stock"];
+      cta = m["cta.add"];
+      break;
+    case "low_stock":
+      label = qty !== null ? f(m["status.low_stock_n"], { n: qty }) : m["status.low_stock"];
+      sr = qty !== null ? f(m["sr.low_stock_n"], { n: qty }) : m["sr.low_stock"];
+      cta = m["cta.add"];
+      break;
+    case "backorder": {
+      label = m["status.backorder"];
+      sr = m["sr.backorder"];
+      cta = m["cta.backorder"];
+      const date = formatDate(availability.restock_eta, locale);
+      if (date) sublabel = f(m["sub.backorder_eta"], { date });
+      break;
+    }
+    case "preorder": {
+      label = m["status.preorder"];
+      sr = m["sr.preorder"];
+      cta = m["cta.preorder"];
+      const date = formatDate(availability.preorder_release_at ?? availability.restock_eta, locale);
+      if (date) sublabel = f(m["sub.preorder_date"], { date });
+      break;
+    }
+    default:
+      label = m["status.out_of_stock"];
+      sr = m["sr.out_of_stock"];
+      cta = m["cta.out_of_stock"];
+      enabled = false;
+  }
+  return {
+    status,
+    tone: TONES[status],
+    label,
+    sublabel,
+    ctaLabel: cta,
+    ctaEnabled: enabled,
+    showNotify: status === "out_of_stock" && availability.notify_available === true,
+    srText: sublabel ? `${sr}. ${sublabel}` : sr,
+    maxPerOrder: typeof availability.max_per_order === "number" && availability.max_per_order > 0 ? availability.max_per_order : null,
+    showOnCard: status !== "in_stock"
+  };
+}
+function cartLineProblemView(problem, locale, options = {}) {
+  const m = availabilityMessages(locale, options.messages);
+  const code = "code" in problem ? problem.code : problem.status === "out_of_stock" ? "out_of_stock" : "insufficient_stock";
+  const max = typeof problem.max_quantity === "number" && problem.max_quantity >= 0 ? problem.max_quantity : null;
+  const canAdjust = max !== null && max > 0 && (options.lineQuantity === void 0 || max !== options.lineQuantity);
+  const message = code === "out_of_stock" || max === 0 ? m["problem.out_of_stock"] : max !== null ? formatAvailabilityMessage(m["problem.insufficient_stock_n"], { n: max }) : m["problem.insufficient_stock"];
+  return {
+    code,
+    message,
+    adjustTo: canAdjust ? max : null,
+    adjustLabel: canAdjust ? formatAvailabilityMessage(m["problem.adjust"], { n: max }) : null,
+    removeLabel: m["problem.remove"]
+  };
+}
+var SCHEMA_AVAILABILITY = {
+  in_stock: "https://schema.org/InStock",
+  low_stock: "https://schema.org/LimitedAvailability",
+  out_of_stock: "https://schema.org/OutOfStock",
+  backorder: "https://schema.org/BackOrder",
+  preorder: "https://schema.org/PreOrder"
+};
+function schemaAvailability(status) {
+  return SCHEMA_AVAILABILITY[status] ?? SCHEMA_AVAILABILITY.out_of_stock;
+}
+function productAvailability(product, options = {}) {
+  if (product.availability) return product.availability;
+  const all = product.variants.map((v) => resolveAvailability(v, options));
+  const rank = ["in_stock", "low_stock", "backorder", "preorder", "out_of_stock"];
+  const best = all.slice().sort((a, b) => rank.indexOf(a.status) - rank.indexOf(b.status))[0];
+  return best ?? resolveAvailability(product, options);
+}
+
+// src/payments.ts
+var ES2 = {
+  "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 EN2 = {
+  "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 CATALOG2 = { es: ES2, en: EN2 };
+function paymentMessages(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 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 ES3 = {
+  "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 EN3 = {
+  "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 CATALOG3 = { es: ES3, en: EN3 };
+function promotionMessages(locale, overrides) {
+  const base = CATALOG3[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 };
+}
+
 exports.CLIENT_IP_HEADER = CLIENT_IP_HEADER;
+exports.NOTE_MAX_LENGTH = NOTE_MAX_LENGTH;
 exports.StorefrontError = StorefrontError;
 exports.appendParams = appendParams;
+exports.availabilityLocale = availabilityLocale;
+exports.availabilityMessages = availabilityMessages;
+exports.availabilityView = availabilityView;
+exports.cartLineProblemView = cartLineProblemView;
+exports.clampPercent = clampPercent;
 exports.createStorefrontClient = createStorefrontClient;
+exports.declineMessage = declineMessage;
+exports.declineMessageKey = declineMessageKey;
+exports.formatAvailabilityMessage = formatAvailabilityMessage;
 exports.formatMoney = formatMoney;
+exports.formatVoucherExpiry = formatVoucherExpiry;
 exports.generateIdempotencyKey = generateIdempotencyKey;
 exports.isStorefrontError = isStorefrontError;
 exports.isTokenPublishable = isTokenPublishable;
 exports.normalizeClientIp = normalizeClientIp;
+exports.normalizeNote = normalizeNote;
 exports.parseMoney = parseMoney;
 exports.parseProductFilters = parseProductFilters;
+exports.paymentErrorView = paymentErrorView;
+exports.paymentIdempotencyKey = paymentIdempotencyKey;
+exports.paymentMessages = paymentMessages;
+exports.paymentOutcome = paymentOutcome;
+exports.productAvailability = productAvailability;
 exports.productListQuery = productListQuery;
+exports.promoProgressView = promoProgressView;
+exports.promotionMessages = promotionMessages;
+exports.resolveAvailability = resolveAvailability;
+exports.rewardLabel = rewardLabel;
+exports.safeHttpsUrl = safeHttpsUrl;
+exports.schemaAvailability = schemaAvailability;
 exports.toMoney = toMoney;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map