@asteby/storefront 0.13.0 → 0.15.0

package/dist/index.js

@@ -1,81 +1,7 @@
-import { availabilityLocale, formatAvailabilityMessage } from './chunk-HBSB7XS2.js';
-export { availabilityLocale, availabilityMessages, availabilityView, cartLineProblemView, formatAvailabilityMessage, productAvailability, resolveAvailability, schemaAvailability } from './chunk-HBSB7XS2.js';
+import { isStorefrontError, availabilityLocale, StorefrontError, formatAvailabilityMessage, defaultCodeForStatus } from './chunk-IPUAZ3LQ.js';
+export { PICKUP_STEPS, SHIPPING_STEPS, StorefrontError, availabilityLocale, availabilityMessages, availabilityView, cartLineProblemView, declineMessage, declineMessageKey, formatAvailabilityMessage, formatVoucherExpiry, isStorefrontError, isTestInvoice, isTestShipment, nextAction, orderProgress, orderShipments, paymentErrorView, paymentIdempotencyKey, paymentMessages, paymentOutcome, productAvailability, resolveAvailability, safeHttpsUrl, safeTrackingUrl, schemaAvailability, shipmentsStatus, sortTrackingEvents } from './chunk-IPUAZ3LQ.js';
 import { isValidPoint } from './chunk-45R47HYO.js';
 
-// src/errors.ts
-var StorefrontError = class extends Error {
-  name = "StorefrontError";
-  status;
-  code;
-  field;
-  details;
-  url;
-  /** Scopes a `403 insufficient_scope` says the route needs (empty for any other error). */
-  requiredScopes;
-  /** `true`: repeating the request (same idempotency key) can succeed. `false`: not until someone fixes something. `undefined`: OPS did not say. */
-  retryable;
-  /** Seconds OPS asks to wait before retrying. */
-  retryAfter;
-  /** Checkout that a refused cart write can resume. */
-  checkoutId;
-  /** Current cart cost sent with a `price_mismatch` (untrusted shape). */
-  cost;
-  /** English version of `message`, when OPS sent one. */
-  messageEn;
-  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;
-    this.requiredScopes = init.requiredScopes ?? [];
-    this.retryable = init.retryable;
-    this.retryAfter = init.retryAfter;
-    this.checkoutId = init.checkoutId;
-    this.cost = init.cost;
-    this.messageEn = init.messageEn;
-  }
-  /**
-   * 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,
-      ...this.requiredScopes.length ? { requiredScopes: this.requiredScopes } : {},
-      ...this.retryable !== void 0 ? { retryable: this.retryable } : {},
-      ...this.retryAfter !== void 0 ? { retryAfter: this.retryAfter } : {},
-      ...this.checkoutId ? { checkoutId: this.checkoutId } : {}
-    };
-  }
-};
-function isStorefrontError(err) {
-  return err instanceof StorefrontError || typeof err === "object" && err !== null && err.name === "StorefrontError";
-}
-var STATUS_CODES = {
-  400: "validation",
-  401: "unauthorized",
-  403: "forbidden",
-  404: "not_found",
-  409: "conflict",
-  422: "invalid_state",
-  429: "rate_limited"
-};
-function defaultCodeForStatus(status) {
-  return STATUS_CODES[status] ?? (status >= 500 ? "server_error" : "invalid_response");
-}
-
 // src/money.ts
 function parseMoney(money) {
   if (money == null) return 0;
@@ -171,6 +97,7 @@ function joinUrl(baseUrl, path) {
   return baseUrl.replace(/\/+$/, "") + path;
 }
 function enc(segment) {
+  if (typeof segment !== "string" || /^(?:\.|%2e){1,2}$/i.test(segment)) throw new TypeError(`Invalid path segment: ${String(segment)}`);
   return encodeURIComponent(segment);
 }
 function linkSignals(signals) {
@@ -267,6 +194,7 @@ function createStorefrontClient(config) {
     const linked = linkSignals([options.signal, timeoutController?.signal]);
     const init = {
       ...passthrough,
+      ...spec.noRedirect ? { redirect: "error" } : {},
       method: spec.method,
       headers,
       ...spec.body !== void 0 ? { body: JSON.stringify(spec.body) } : {},
@@ -292,6 +220,10 @@ function createStorefrontClient(config) {
       linked.cleanup();
     }
     if (config.onResponse) await config.onResponse({ ...ctx, response: res, durationMs: Date.now() - started });
+    if (spec.noRedirect && res.redirected) {
+      await res.text().catch(() => void 0);
+      throw new StorefrontError({ status: 502, code: "invalid_response", message: "The answer was redirected; it is refused", url });
+    }
     if (res.status === 404 && spec.nullOn404) {
       await res.text().catch(() => void 0);
       return null;
@@ -347,6 +279,12 @@ function createStorefrontClient(config) {
      * has no region configured.
      */
     region: (options) => getOrNull("/storefront/region", void 0, options),
+    /**
+     * State and municipality of a postal code from the region pack (`null` when the code is not in its catalog, or the
+     * organization has no region pack). The source of `AddressFields.lookupPostalCode`: the state it fills is the one
+     * the server checks the address against.
+     */
+    postalCode: (zip, options) => getOrNull("/storefront/region/postal-code", { zip: zip.trim() }, options),
     products: {
       list: (params, options) => get("/storefront/products", productListQuery(params), options),
       /** `null` when the product does not exist or is unpublished. */
@@ -477,6 +415,39 @@ function createStorefrontClient(config) {
       order: (id, options) => getOrNull(`/storefront/customer/orders/${enc(id)}`, void 0, options),
       requestReturn: (orderId, input, options) => write("POST", `/storefront/customer/orders/${enc(orderId)}/returns`, input, options),
       requestInvoice: (orderId, input, options) => write("POST", `/storefront/customer/orders/${enc(orderId)}/invoice`, input, options),
+      /**
+       * Checkouts waiting for their payment (cash voucher: OXXO, SPEI). They are not orders yet; once the payment
+       * confirms they leave this list and show up in `orders`.
+       */
+      pendingPayments: async (params, options) => (
+        // An OPS older than the route answers 404: it has no pending payments to list (a 401 still throws).
+        await getOrNull("/storefront/customer/pending-payments", params, options) ?? {
+          nodes: [],
+          page_info: { has_next_page: false, end_cursor: null },
+          total_count: 0
+        }
+      ),
+      /**
+       * Reads one file (`pdf` | `xml`) of an invoice or credit note of the buyer's order, through the authenticated
+       * route (`order_invoice_file`): the answer is the file itself (base64), never a URL, so neither the buyer token
+       * nor a link of the PAC reaches the browser. Call it from YOUR server and stream the bytes
+       * (`invoiceFileBytes`). `null` when the order, the document or the file does not exist or is not the buyer's.
+       */
+      invoiceFile: async (orderId, invoiceId, kind, options) => {
+        if (kind !== "pdf" && kind !== "xml") throw new TypeError("invoiceFile: kind must be 'pdf' or 'xml'");
+        const file = await request({
+          method: "GET",
+          path: `/storefront/customer/orders/${enc(orderId)}/invoices/${enc(invoiceId)}/${kind}`,
+          options: { ...options, cache: "no-store" },
+          nullOn404: true,
+          noRedirect: true
+        });
+        if (file === null) return null;
+        if (!file || typeof file.content_base64 !== "string" || typeof file.filename !== "string" || typeof file.content_type !== "string") {
+          throw new StorefrontError({ status: 502, code: "invalid_response", message: "The invoice file answer is not a file" });
+        }
+        return { filename: file.filename, content_type: file.content_type, content_base64: file.content_base64 };
+      },
       addresses: {
         list: (options) => get("/storefront/customer/addresses", void 0, options),
         create: (address, options) => write("POST", "/storefront/customer/addresses", address, options),
@@ -571,243 +542,8 @@ async function diagnose(client, options = {}) {
   }
 }
 
-// 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",
-  "challenge.escape": "Cancelar y volver al pago",
-  "challenge.escape_hint": "\xBFTarda demasiado? Puedes cerrar la verificaci\xF3n. Si ya la aprobaste en tu banco, el pago a\xFAn puede completarse: te confirmamos aqu\xED antes de dejarte pagar de nuevo.",
-  "challenge.left": "Cerraste la verificaci\xF3n. Estamos confirmando con tu banco si el pago se complet\xF3; no vuelvas a pagar todav\xEDa."
-};
-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",
-  "challenge.escape": "Cancel and go back to payment",
-  "challenge.escape_hint": "Taking too long? You can close the verification. If you already approved it with your bank the payment may still go through: we confirm here before letting you pay again.",
-  "challenge.left": "You closed the verification. We are checking with your bank whether the payment went through; do not pay again yet."
-};
-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 };
-  }
-  const declared = e.retryable;
-  if (status >= 500 && declared === false) return { kind: "generic", message: m["error.generic"], retrySameAttempt: false, canRetry: true };
-  if (status === 0 || status === 502 || status === 503 || status === 504 || code === "network" || code === "timeout" || status >= 500) {
-    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 = {
+var ES = {
   "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!",
@@ -858,7 +594,7 @@ var ES2 = {
   "note.error": "No se pudo guardar la nota. Intenta de nuevo.",
   "note.counter": "{n} de {max} caracteres"
 };
-var EN2 = {
+var EN = {
   "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!",
@@ -909,9 +645,9 @@ var EN2 = {
   "note.error": "The note could not be saved. Please try again.",
   "note.counter": "{n} of {max} characters"
 };
-var CATALOG2 = { es: ES2, en: EN2 };
+var CATALOG = { es: ES, en: EN };
 function promotionMessages(locale, overrides) {
-  const base = CATALOG2[availabilityLocale(locale)];
+  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;
@@ -1058,6 +794,33 @@ function hreflangLinks(markets, path, defaultMarket, protocol = "https") {
   return links;
 }
 
+// src/invoice-docs.ts
+function groupInvoiceDocs(docs) {
+  const list = Array.isArray(docs) ? docs.filter((d) => !!d && typeof d === "object") : [];
+  const groups = list.filter((d) => d.kind !== "credit_note").map((invoice) => ({ invoice, creditNotes: [] }));
+  const orphans = [];
+  for (const d of list) {
+    if (d.kind !== "credit_note") continue;
+    const group = d.related_to ? groups.find((g) => g.invoice.id === d.related_to) : void 0;
+    if (group) group.creditNotes.push(d);
+    else orphans.push(d);
+  }
+  return { groups, orphans };
+}
+function invoiceFileBytes(file) {
+  const raw = typeof file.content_base64 === "string" ? file.content_base64.replace(/\s+/g, "") : "";
+  if (!/^[A-Za-z0-9+/]*={0,2}$/.test(raw) || raw.length % 4 === 1) throw new TypeError("invoice file is not valid base64");
+  const bin = atob(raw);
+  const out = new Uint8Array(bin.length);
+  for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
+  return out;
+}
+function safeInvoiceFilename(name, fallback = "factura") {
+  const base = typeof name === "string" ? name.split(/[\\/]/).pop() ?? "" : "";
+  const clean = base.replace(/[^A-Za-z0-9._-]+/g, "_").replace(/^\.+/, "").slice(0, 80);
+  return clean || fallback;
+}
+
 // src/delivery.ts
 function parseDelivery(value) {
   const raw = (value ?? "").trim();
@@ -1084,6 +847,6 @@ function deliveryNotices(delivery) {
   };
 }
 
-export { CLIENT_IP_HEADER, COUNTRY_HEADERS, MISSING_WEIGHT, NOTE_MAX_LENGTH, PAYMENT_CHOICE_REFUSED_FIELD, StorefrontError, appendParams, clampPercent, classifyPaymentError, createStorefrontClient, declineMessage, declineMessageKey, deliveryInput, deliveryNotices, diagnose, formatMoney, formatVoucherExpiry, generateIdempotencyKey, hreflangLinks, isStorefrontError, isTokenPublishable, maskToken, negotiateLocale, normalizeClientIp, normalizeNote, opsSaysNotRetryable, parseDelivery, parseMoney, parseProductFilters, paymentErrorView, paymentIdempotencyKey, paymentMessages, paymentOutcome, preferredLanguages, productListQuery, promoProgressView, promotionMessages, repairPath, rewardLabel, safeHttpsUrl, storefrontDomainHeader, suggestMarket, toMoney, visitorCountry };
+export { CLIENT_IP_HEADER, COUNTRY_HEADERS, MISSING_WEIGHT, NOTE_MAX_LENGTH, PAYMENT_CHOICE_REFUSED_FIELD, appendParams, clampPercent, classifyPaymentError, createStorefrontClient, deliveryInput, deliveryNotices, diagnose, formatMoney, generateIdempotencyKey, groupInvoiceDocs, hreflangLinks, invoiceFileBytes, isTokenPublishable, maskToken, negotiateLocale, normalizeClientIp, normalizeNote, opsSaysNotRetryable, parseDelivery, parseMoney, parseProductFilters, preferredLanguages, productListQuery, promoProgressView, promotionMessages, repairPath, rewardLabel, safeInvoiceFilename, storefrontDomainHeader, suggestMarket, toMoney, visitorCountry };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map