@asteby/storefront 0.12.0 → 0.14.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { GeoPoint } from './geo.cjs';
 export { OpenStatus, OpeningHours } from './geo.cjs';
-import { aJ as ProductSort, b8 as TokenIntrospection, b0 as Shop, aQ as Region, aH as ProductConnection, aE as Product, y as Connection, x as Collection, ad as LocationListParams, aa as Location, aj as NearestLocation, b4 as StockLevel, aU as RestockSubscriptionInput, aV as RestockSubscriptionResult, m as CartLineInput, C as Cart, p as CartLineUpdateInput, f as CartBuyerInput, a as AddressInput, Q as DeliveryOptions, aw as PaymentMethods, O as DeliveryInput, a5 as InvoiceRequest, aP as RecommendationPlacement, s as CartRecommendations, u as CheckoutInput, w as CheckoutResult, aO as PromotionsList, at as PaymentConfig, aB as PaymentSubmitInput, ap as PaymentAttemptResult, D as CustomerIdentifier, J as CustomerSessionInput, I as CustomerSession, B as CustomerCapabilities, F as CustomerRegisterInput, G as CustomerRegisterResult, M as CustomerVerifyRegistrationInput, E as CustomerPasswordLoginInput, K as CustomerSetPasswordInput, H as CustomerResetPasswordInput, z as Customer, L as CustomerUpdateInput, ak as Order, aX as ReturnRequestInput, aW as ReturnRequest, a6 as InvoiceResult, A as Address, b7 as Theme, am as Page, af as Menu, b as Article, b6 as StorefrontErrorCode, a3 as InsufficientStockLine, ah as Money, d as AvailabilityStatus, o as CartLineProblem, c as Availability, aK as ProductVariant, N as DeclineCode, aC as PaymentVoucher, ax as PaymentNextStep, q as CartPromotions, aM as PromotionReward, P as DeliveryMethod, b9 as UnavailableRateProvider } from './types-BQ3S6VjF.cjs';
-export { e as CartBuyer, g as CartCost, h as CartDelivery, i as CartDiscountCode, j as CartDiscountLine, k as CartInvoice, l as CartLine, n as CartLineMerchandise, r as CartRecommendation, t as CheckoutInfo, v as CheckoutPayment, R as Facet, S as FacetValue, T as FiscalDocumentEvidence, U as FiscalDocumentSource, V as FiscalIdentity, W as FiscalIdentityInput, X as FiscalVerification, Y as IdentityCapture, Z as IdentityDocumentSpec, _ as IdentityFieldRule, $ as IdentityRulesV1, a0 as IdentityStrategy, a1 as Image, a2 as InsufficientStockDetails, a4 as InvoiceAction, a7 as InvoiceStage, a8 as InvoiceSummary, a9 as InvoicingCapabilities, ab as LocationContacts, ac as LocationKind, ae as LocationPickup, ag as MenuItem, ai as MoneyRange, al as OrderLine, an as PageInfo, ao as PaymentAction, aq as PaymentAttemptStatus, ar as PaymentClient, as as PaymentClientCsp, au as PaymentFlow, av as PaymentMethod, ay as PaymentOption, az as PaymentOptionKey, aA as PaymentPoint, aD as PickupOption, aF as ProductAttributeValue, aG as ProductCategory, aI as ProductOption, aL as PromotionAnnouncement, aN as PromotionTier, aR as RegionFiscalEntry, aS as RegionFiscalId, aT as RegionPaymentMethod, aY as SEO, aZ as Section, a_ as SelectedOption, a$ as ShippingRate, b1 as ShopBranch, b2 as ShopContact, b3 as ShopPolicies, b5 as StorefrontErrorBody } from './types-BQ3S6VjF.cjs';
+import { a_ as ProductSort, bw as TokenIntrospection, bo as Shop, b6 as Region, aY as ProductConnection, aV as Product, y as Connection, x as Collection, ah as LocationListParams, ae as Location, an as NearestLocation, bs as StockLevel, ba as RestockSubscriptionInput, bb as RestockSubscriptionResult, m as CartLineInput, C as Cart, p as CartLineUpdateInput, f as CartBuyerInput, a as AddressInput, Q as DeliveryOptions, aL as PaymentMethods, O as DeliveryInput, a9 as InvoiceRequest, b4 as RecommendationPlacement, s as CartRecommendations, u as CheckoutInput, w as CheckoutResult, b3 as PromotionsList, aH as PaymentConfig, aQ as PaymentSubmitInput, aD as PaymentAttemptResult, D as CustomerIdentifier, J as CustomerSessionInput, I as CustomerSession, B as CustomerCapabilities, F as CustomerRegisterInput, G as CustomerRegisterResult, M as CustomerVerifyRegistrationInput, E as CustomerPasswordLoginInput, K as CustomerSetPasswordInput, H as CustomerResetPasswordInput, z as Customer, L as CustomerUpdateInput, aq as Order, bd as ReturnRequestInput, bc as ReturnRequest, aa as InvoiceResult, aS as PendingPayment, a8 as InvoiceFileKind, a7 as InvoiceFile, A as Address, bv as Theme, aA as Page, aj as Menu, b as Article, bu as StorefrontErrorCode, a4 as InsufficientStockLine, al as Money, d as AvailabilityStatus, o as CartLineProblem, c as Availability, a$ as ProductVariant, N as DeclineCode, aR as PaymentVoucher, aM as PaymentNextStep, q as CartPromotions, b1 as PromotionReward, a6 as InvoiceDoc, bh as Shipment, ao as NextAction, au as OrderProgress, bl as ShipmentStatus, bi as ShipmentEvent, P as DeliveryMethod, bx as UnavailableRateProvider } from './types-BuKb-zbi.cjs';
+export { e as CartBuyer, g as CartCost, h as CartDelivery, i as CartDiscountCode, j as CartDiscountLine, k as CartInvoice, l as CartLine, n as CartLineMerchandise, r as CartRecommendation, t as CheckoutInfo, v as CheckoutPayment, R as Facet, S as FacetValue, T as FiscalDocumentEvidence, U as FiscalDocumentSource, V as FiscalIdentity, W as FiscalIdentityInput, X as FiscalVerification, Y as GeoHint, Z as IdentityCapture, _ as IdentityDocumentSpec, $ as IdentityFieldRule, a0 as IdentityRulesV1, a1 as IdentityStrategy, a2 as Image, a3 as InsufficientStockDetails, a5 as InvoiceAction, ab as InvoiceStage, ac as InvoiceSummary, ad as InvoicingCapabilities, af as LocationContacts, ag as LocationKind, ai as LocationPickup, ak as MenuItem, am as MoneyRange, ap as NextActionKind, ar as OrderLine, as as OrderPickup, at as OrderProblem, av as OrderProgressStep, aw as OrderSection, ax as OrderStage, ay as OrderStepKey, az as OrderStepState, aB as PageInfo, aC as PaymentAction, aE as PaymentAttemptStatus, aF as PaymentClient, aG as PaymentClientCsp, aI as PaymentFlow, aJ as PaymentInfo, aK as PaymentMethod, aN as PaymentOption, aO as PaymentOptionKey, aP as PaymentPoint, aT as PendingPaymentVoucher, aU as PickupOption, aW as ProductAttributeValue, aX as ProductCategory, aZ as ProductOption, b0 as PromotionAnnouncement, b2 as PromotionTier, b5 as Refund, b7 as RegionFiscalEntry, b8 as RegionFiscalId, b9 as RegionPaymentMethod, be as SEO, bf as Section, bg as SelectedOption, bj as ShipmentKind, bk as ShipmentMap, bm as ShipmentsSummary, bn as ShippingRate, bp as ShopBranch, bq as ShopContact, br as ShopPolicies, bt as StorefrontErrorBody } from './types-BuKb-zbi.cjs';
 
 type QueryValue = string | number | boolean | null | undefined;
 type QueryParams = Record<string, QueryValue | QueryValue[]>;
@@ -145,6 +145,11 @@ type RequestSpec = {
     options?: WriteOptions;
     /** Resolve `null` instead of throwing on 404. */
     nullOn404?: boolean;
+    /**
+     * Never follow a redirect (`redirect: 'error'`, and a redirected answer is refused): for answers that carry the
+     * buyer's documents, so neither the customer token nor the request ever travels to another host.
+     */
+    noRedirect?: boolean;
 };
 /** Header the gateway reads (only for tokens with `trust_client_ip`). */
 declare const CLIENT_IP_HEADER = "X-Storefront-Client-IP";
@@ -317,6 +322,18 @@ declare function createStorefrontClient(config: StorefrontClientOptions): {
         order: (id: string, options?: RequestOptions) => Promise<Order | null>;
         requestReturn: (orderId: string, input: ReturnRequestInput, options?: WriteOptions) => Promise<ReturnRequest>;
         requestInvoice: (orderId: string, input: InvoiceRequest, options?: WriteOptions) => Promise<InvoiceResult>;
+        /**
+         * 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: (params?: PaginationParams, options?: RequestOptions) => Promise<Connection<PendingPayment>>;
+        /**
+         * 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: (orderId: string, invoiceId: string, kind: InvoiceFileKind, options?: RequestOptions) => Promise<InvoiceFile | null>;
         addresses: {
             list: (options?: RequestOptions) => Promise<{
                 nodes: Address[];
@@ -605,7 +622,7 @@ declare function productAvailability(product: Pick<Product, 'variants' | 'availa
  */
 
 type PaymentLocale = AvailabilityLocale;
-type PaymentMessageKey = `decline.${DeclineCode}` | 'state.loading' | 'state.processing' | 'state.approved' | 'state.in_review' | 'state.voucher' | 'state.challenge' | 'state.expired' | 'state.cancelled' | 'state.redirect' | 'state.fallback' | 'error.network' | 'error.card_data' | 'error.price_mismatch' | 'error.payment_in_progress' | 'error.expired' | 'error.too_many_attempts' | 'error.generic' | 'action.retry' | 'action.try_again' | 'action.pay' | 'action.cancel' | 'voucher.title' | 'voucher.point' | 'voucher.reference' | 'voucher.amount' | 'voucher.expires' | 'voucher.clabe' | 'voucher.barcode' | 'voucher.open' | 'voucher.email' | 'form.label' | 'challenge.title';
+type PaymentMessageKey = `decline.${DeclineCode}` | 'state.loading' | 'state.processing' | 'state.approved' | 'state.in_review' | 'state.voucher' | 'state.challenge' | 'state.expired' | 'state.cancelled' | 'state.redirect' | 'state.fallback' | 'error.network' | 'error.card_data' | 'error.price_mismatch' | 'error.payment_in_progress' | 'error.expired' | 'error.too_many_attempts' | 'error.generic' | 'action.retry' | 'action.try_again' | 'action.pay' | 'action.cancel' | 'voucher.title' | 'voucher.point' | 'voucher.reference' | 'voucher.amount' | 'voucher.expires' | 'voucher.clabe' | 'voucher.barcode' | 'voucher.open' | 'voucher.email' | 'form.label' | 'challenge.title' | 'challenge.escape' | 'challenge.escape_hint' | 'challenge.left';
 type PaymentMessages = Record<PaymentMessageKey, string>;
 /** Catalog for a locale (`es-MX` -> es, `en-US` -> en) with the shop's per-key overrides applied. */
 declare function paymentMessages(locale: string | null | undefined, overrides?: Partial<PaymentMessages> | null): PaymentMessages;
@@ -786,6 +803,53 @@ declare function hreflangLinks(markets: MarketInfo[], path: string, defaultMarke
     href: string;
 }[];
 
+/** Steps of an order that ships, in order. */
+declare const SHIPPING_STEPS: readonly ["paid", "preparing", "shipped", "in_transit", "delivered"];
+/** Steps of an order the buyer picks up. */
+declare const PICKUP_STEPS: readonly ["paid", "preparing", "ready_for_pickup", "delivered"];
+/** A shipment the buyer can be told about as real: not a sandbox one. */
+declare function isTestShipment(s: Pick<Shipment, 'test_mode' | 'environment'> | null | undefined): boolean;
+/** An invoice or credit note from a sandbox PAC. */
+declare function isTestInvoice(d: Pick<InvoiceDoc, 'test_mode' | 'environment'> | null | undefined): boolean;
+/** `https` URL with no credentials, or `null`. The only kind of link a tracking or voucher button may carry. */
+declare function safeTrackingUrl(value: unknown): string | null;
+/** Newest first, invalid dates last, ties keep the server's order; at most `limit` (default 50, the contract's cap). */
+declare function sortTrackingEvents(events: readonly ShipmentEvent[] | null | undefined, limit?: number): ShipmentEvent[];
+/** The shipments of the order that count: outbound/pickup/local first, returns after; stable otherwise. */
+declare function orderShipments(order: Pick<Order, 'shipments'> | null | undefined): Shipment[];
+/**
+ * The unified progress. The server's `order.progress` wins when it is well formed; otherwise it is derived, so a store
+ * on an older OPS still gets a timeline. Pending payment, cancelled and refunded orders have no steps to walk: `steps`
+ * lists them as `pending` (or `[]` when cancelled/refunded) and the stage says why.
+ */
+declare function orderProgress(order: Order): OrderProgress;
+/**
+ * The action to put first. The server's `next_action` wins (its `href` is re-checked: only `https`); an older server
+ * gets one derived from the order and its invoice. Never `null`: `{ kind: 'none' }` means "nothing to offer".
+ */
+declare function nextAction(order: Order): NextAction;
+/** Latest known status among the live (non-sandbox, non-return) shipments, or `null`. */
+declare function shipmentsStatus(order: Order): ShipmentStatus | null;
+
+/** Invoices and credit notes of an order, and the bytes of a downloaded file. Pure; no URL of the PAC ever passes here. */
+
+type InvoiceGroup = {
+    invoice: InvoiceDoc;
+    creditNotes: InvoiceDoc[];
+};
+/**
+ * Groups credit notes under the invoice they correct (`related_to`), keeping the server's order. A credit note whose
+ * invoice is not in the list (or has no `related_to`) is returned in `orphans`, never dropped.
+ */
+declare function groupInvoiceDocs(docs: readonly InvoiceDoc[] | null | undefined): {
+    groups: InvoiceGroup[];
+    orphans: InvoiceDoc[];
+};
+/** Decodes `content_base64` of a downloaded invoice file. Throws `TypeError` when it is not valid base64. */
+declare function invoiceFileBytes(file: Pick<InvoiceFile, 'content_base64'>): Uint8Array;
+/** A download filename that is safe in a `Content-Disposition` header: no path, quotes, control characters or spaces. */
+declare function safeInvoiceFilename(name: unknown, fallback?: string): string;
+
 /** Kind of a delivery radio: `ship` (address only, quote later), `rate` (a quoted rate) or `pickup` (a branch). */
 type DeliveryChoiceKind = 'ship' | 'rate' | 'pickup';
 type DeliveryChoice = {
@@ -817,4 +881,4 @@ type DeliveryNotices = {
 /** Splits `delivery.unavailable` into the `missing_weight` notice and the generic one. */
 declare function deliveryNotices(delivery: Pick<DeliveryOptions, 'unavailable' | 'partial'> | null | undefined): DeliveryNotices;
 
-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, CustomerCapabilities, CustomerIdentifier, CustomerPasswordLoginInput, CustomerRegisterInput, CustomerRegisterResult, CustomerResetPasswordInput, CustomerSession, CustomerSessionInput, CustomerSetPasswordInput, CustomerUpdateInput, CustomerVerifyRegistrationInput, DeclineCode, type DeliveryChoice, type DeliveryChoiceKind, DeliveryInput, DeliveryMethod, type DeliveryNotices, DeliveryOptions, type DiagnoseOptions, type DiscountBarState, type DiscountBarView, type FetchLike, type FormatMoneyOptions, GeoPoint, InsufficientStockLine, InvoiceRequest, InvoiceResult, Location, LocationListParams, MISSING_WEIGHT, type MarketInfo, type MarketSuggestion, Menu, Money, NOTE_MAX_LENGTH, NearestLocation, Order, PAYMENT_CHOICE_REFUSED_FIELD, Page, type PaginationParams, PaymentAttemptResult, PaymentConfig, type PaymentErrorClass, type PaymentErrorClassKind, type PaymentErrorKind, type PaymentErrorLike, 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, Region, 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, TokenIntrospection, UnavailableRateProvider, type WriteOptions, appendParams, availabilityLocale, availabilityMessages, availabilityView, cartLineProblemView, clampPercent, classifyPaymentError, createStorefrontClient, declineMessage, declineMessageKey, deliveryInput, deliveryNotices, diagnose, formatAvailabilityMessage, formatMoney, formatVoucherExpiry, generateIdempotencyKey, hreflangLinks, isStorefrontError, isTokenPublishable, maskToken, negotiateLocale, normalizeClientIp, normalizeNote, opsSaysNotRetryable, parseDelivery, parseMoney, parseProductFilters, paymentErrorView, paymentIdempotencyKey, paymentMessages, paymentOutcome, preferredLanguages, productAvailability, productListQuery, promoProgressView, promotionMessages, repairPath, resolveAvailability, rewardLabel, safeHttpsUrl, schemaAvailability, storefrontDomainHeader, suggestMarket, toMoney, visitorCountry };
+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, CustomerCapabilities, CustomerIdentifier, CustomerPasswordLoginInput, CustomerRegisterInput, CustomerRegisterResult, CustomerResetPasswordInput, CustomerSession, CustomerSessionInput, CustomerSetPasswordInput, CustomerUpdateInput, CustomerVerifyRegistrationInput, DeclineCode, type DeliveryChoice, type DeliveryChoiceKind, DeliveryInput, DeliveryMethod, type DeliveryNotices, DeliveryOptions, type DiagnoseOptions, type DiscountBarState, type DiscountBarView, type FetchLike, type FormatMoneyOptions, GeoPoint, InsufficientStockLine, InvoiceDoc, InvoiceFile, InvoiceFileKind, type InvoiceGroup, InvoiceRequest, InvoiceResult, Location, LocationListParams, MISSING_WEIGHT, type MarketInfo, type MarketSuggestion, Menu, Money, NOTE_MAX_LENGTH, NearestLocation, NextAction, Order, OrderProgress, PAYMENT_CHOICE_REFUSED_FIELD, PICKUP_STEPS, Page, type PaginationParams, PaymentAttemptResult, PaymentConfig, type PaymentErrorClass, type PaymentErrorClassKind, type PaymentErrorKind, type PaymentErrorLike, type PaymentErrorView, type PaymentLocale, type PaymentMessageKey, type PaymentMessages, PaymentMethods, PaymentNextStep, type PaymentOutcome, type PaymentOutcomeKind, PaymentSubmitInput, PaymentVoucher, PendingPayment, type PreviewOptions, Product, ProductConnection, type ProductListParams, ProductSort, ProductVariant, type PromoProgressView, type PromotionLocale, type PromotionMessageKey, type PromotionMessages, PromotionReward, PromotionsList, type QueryParams, type QueryValue, RecommendationPlacement, Region, type RequestOptions, type ResolveAvailabilityOptions, RestockSubscriptionInput, RestockSubscriptionResult, ReturnRequest, ReturnRequestInput, SHIPPING_STEPS, Shipment, ShipmentEvent, ShipmentStatus, type ShippingBarState, type ShippingBarView, Shop, StockLevel, type StorefrontClient, type StorefrontClientOptions, StorefrontError, StorefrontErrorCode, type StorefrontErrorInit, type StorefrontRequestContext, type StorefrontResponseContext, Theme, TokenIntrospection, UnavailableRateProvider, type WriteOptions, appendParams, availabilityLocale, availabilityMessages, availabilityView, cartLineProblemView, clampPercent, classifyPaymentError, createStorefrontClient, declineMessage, declineMessageKey, deliveryInput, deliveryNotices, diagnose, formatAvailabilityMessage, formatMoney, formatVoucherExpiry, generateIdempotencyKey, groupInvoiceDocs, hreflangLinks, invoiceFileBytes, isStorefrontError, isTestInvoice, isTestShipment, isTokenPublishable, maskToken, negotiateLocale, nextAction, normalizeClientIp, normalizeNote, opsSaysNotRetryable, orderProgress, orderShipments, parseDelivery, parseMoney, parseProductFilters, paymentErrorView, paymentIdempotencyKey, paymentMessages, paymentOutcome, preferredLanguages, productAvailability, productListQuery, promoProgressView, promotionMessages, repairPath, resolveAvailability, rewardLabel, safeHttpsUrl, safeInvoiceFilename, safeTrackingUrl, schemaAvailability, shipmentsStatus, sortTrackingEvents, storefrontDomainHeader, suggestMarket, toMoney, visitorCountry };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { GeoPoint } from './geo.js';
 export { OpenStatus, OpeningHours } from './geo.js';
-import { aJ as ProductSort, b8 as TokenIntrospection, b0 as Shop, aQ as Region, aH as ProductConnection, aE as Product, y as Connection, x as Collection, ad as LocationListParams, aa as Location, aj as NearestLocation, b4 as StockLevel, aU as RestockSubscriptionInput, aV as RestockSubscriptionResult, m as CartLineInput, C as Cart, p as CartLineUpdateInput, f as CartBuyerInput, a as AddressInput, Q as DeliveryOptions, aw as PaymentMethods, O as DeliveryInput, a5 as InvoiceRequest, aP as RecommendationPlacement, s as CartRecommendations, u as CheckoutInput, w as CheckoutResult, aO as PromotionsList, at as PaymentConfig, aB as PaymentSubmitInput, ap as PaymentAttemptResult, D as CustomerIdentifier, J as CustomerSessionInput, I as CustomerSession, B as CustomerCapabilities, F as CustomerRegisterInput, G as CustomerRegisterResult, M as CustomerVerifyRegistrationInput, E as CustomerPasswordLoginInput, K as CustomerSetPasswordInput, H as CustomerResetPasswordInput, z as Customer, L as CustomerUpdateInput, ak as Order, aX as ReturnRequestInput, aW as ReturnRequest, a6 as InvoiceResult, A as Address, b7 as Theme, am as Page, af as Menu, b as Article, b6 as StorefrontErrorCode, a3 as InsufficientStockLine, ah as Money, d as AvailabilityStatus, o as CartLineProblem, c as Availability, aK as ProductVariant, N as DeclineCode, aC as PaymentVoucher, ax as PaymentNextStep, q as CartPromotions, aM as PromotionReward, P as DeliveryMethod, b9 as UnavailableRateProvider } from './types-C_rsJRCl.js';
-export { e as CartBuyer, g as CartCost, h as CartDelivery, i as CartDiscountCode, j as CartDiscountLine, k as CartInvoice, l as CartLine, n as CartLineMerchandise, r as CartRecommendation, t as CheckoutInfo, v as CheckoutPayment, R as Facet, S as FacetValue, T as FiscalDocumentEvidence, U as FiscalDocumentSource, V as FiscalIdentity, W as FiscalIdentityInput, X as FiscalVerification, Y as IdentityCapture, Z as IdentityDocumentSpec, _ as IdentityFieldRule, $ as IdentityRulesV1, a0 as IdentityStrategy, a1 as Image, a2 as InsufficientStockDetails, a4 as InvoiceAction, a7 as InvoiceStage, a8 as InvoiceSummary, a9 as InvoicingCapabilities, ab as LocationContacts, ac as LocationKind, ae as LocationPickup, ag as MenuItem, ai as MoneyRange, al as OrderLine, an as PageInfo, ao as PaymentAction, aq as PaymentAttemptStatus, ar as PaymentClient, as as PaymentClientCsp, au as PaymentFlow, av as PaymentMethod, ay as PaymentOption, az as PaymentOptionKey, aA as PaymentPoint, aD as PickupOption, aF as ProductAttributeValue, aG as ProductCategory, aI as ProductOption, aL as PromotionAnnouncement, aN as PromotionTier, aR as RegionFiscalEntry, aS as RegionFiscalId, aT as RegionPaymentMethod, aY as SEO, aZ as Section, a_ as SelectedOption, a$ as ShippingRate, b1 as ShopBranch, b2 as ShopContact, b3 as ShopPolicies, b5 as StorefrontErrorBody } from './types-C_rsJRCl.js';
+import { a_ as ProductSort, bw as TokenIntrospection, bo as Shop, b6 as Region, aY as ProductConnection, aV as Product, y as Connection, x as Collection, ah as LocationListParams, ae as Location, an as NearestLocation, bs as StockLevel, ba as RestockSubscriptionInput, bb as RestockSubscriptionResult, m as CartLineInput, C as Cart, p as CartLineUpdateInput, f as CartBuyerInput, a as AddressInput, Q as DeliveryOptions, aL as PaymentMethods, O as DeliveryInput, a9 as InvoiceRequest, b4 as RecommendationPlacement, s as CartRecommendations, u as CheckoutInput, w as CheckoutResult, b3 as PromotionsList, aH as PaymentConfig, aQ as PaymentSubmitInput, aD as PaymentAttemptResult, D as CustomerIdentifier, J as CustomerSessionInput, I as CustomerSession, B as CustomerCapabilities, F as CustomerRegisterInput, G as CustomerRegisterResult, M as CustomerVerifyRegistrationInput, E as CustomerPasswordLoginInput, K as CustomerSetPasswordInput, H as CustomerResetPasswordInput, z as Customer, L as CustomerUpdateInput, aq as Order, bd as ReturnRequestInput, bc as ReturnRequest, aa as InvoiceResult, aS as PendingPayment, a8 as InvoiceFileKind, a7 as InvoiceFile, A as Address, bv as Theme, aA as Page, aj as Menu, b as Article, bu as StorefrontErrorCode, a4 as InsufficientStockLine, al as Money, d as AvailabilityStatus, o as CartLineProblem, c as Availability, a$ as ProductVariant, N as DeclineCode, aR as PaymentVoucher, aM as PaymentNextStep, q as CartPromotions, b1 as PromotionReward, a6 as InvoiceDoc, bh as Shipment, ao as NextAction, au as OrderProgress, bl as ShipmentStatus, bi as ShipmentEvent, P as DeliveryMethod, bx as UnavailableRateProvider } from './types-BeTemDg6.js';
+export { e as CartBuyer, g as CartCost, h as CartDelivery, i as CartDiscountCode, j as CartDiscountLine, k as CartInvoice, l as CartLine, n as CartLineMerchandise, r as CartRecommendation, t as CheckoutInfo, v as CheckoutPayment, R as Facet, S as FacetValue, T as FiscalDocumentEvidence, U as FiscalDocumentSource, V as FiscalIdentity, W as FiscalIdentityInput, X as FiscalVerification, Y as GeoHint, Z as IdentityCapture, _ as IdentityDocumentSpec, $ as IdentityFieldRule, a0 as IdentityRulesV1, a1 as IdentityStrategy, a2 as Image, a3 as InsufficientStockDetails, a5 as InvoiceAction, ab as InvoiceStage, ac as InvoiceSummary, ad as InvoicingCapabilities, af as LocationContacts, ag as LocationKind, ai as LocationPickup, ak as MenuItem, am as MoneyRange, ap as NextActionKind, ar as OrderLine, as as OrderPickup, at as OrderProblem, av as OrderProgressStep, aw as OrderSection, ax as OrderStage, ay as OrderStepKey, az as OrderStepState, aB as PageInfo, aC as PaymentAction, aE as PaymentAttemptStatus, aF as PaymentClient, aG as PaymentClientCsp, aI as PaymentFlow, aJ as PaymentInfo, aK as PaymentMethod, aN as PaymentOption, aO as PaymentOptionKey, aP as PaymentPoint, aT as PendingPaymentVoucher, aU as PickupOption, aW as ProductAttributeValue, aX as ProductCategory, aZ as ProductOption, b0 as PromotionAnnouncement, b2 as PromotionTier, b5 as Refund, b7 as RegionFiscalEntry, b8 as RegionFiscalId, b9 as RegionPaymentMethod, be as SEO, bf as Section, bg as SelectedOption, bj as ShipmentKind, bk as ShipmentMap, bm as ShipmentsSummary, bn as ShippingRate, bp as ShopBranch, bq as ShopContact, br as ShopPolicies, bt as StorefrontErrorBody } from './types-BeTemDg6.js';
 
 type QueryValue = string | number | boolean | null | undefined;
 type QueryParams = Record<string, QueryValue | QueryValue[]>;
@@ -145,6 +145,11 @@ type RequestSpec = {
     options?: WriteOptions;
     /** Resolve `null` instead of throwing on 404. */
     nullOn404?: boolean;
+    /**
+     * Never follow a redirect (`redirect: 'error'`, and a redirected answer is refused): for answers that carry the
+     * buyer's documents, so neither the customer token nor the request ever travels to another host.
+     */
+    noRedirect?: boolean;
 };
 /** Header the gateway reads (only for tokens with `trust_client_ip`). */
 declare const CLIENT_IP_HEADER = "X-Storefront-Client-IP";
@@ -317,6 +322,18 @@ declare function createStorefrontClient(config: StorefrontClientOptions): {
         order: (id: string, options?: RequestOptions) => Promise<Order | null>;
         requestReturn: (orderId: string, input: ReturnRequestInput, options?: WriteOptions) => Promise<ReturnRequest>;
         requestInvoice: (orderId: string, input: InvoiceRequest, options?: WriteOptions) => Promise<InvoiceResult>;
+        /**
+         * 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: (params?: PaginationParams, options?: RequestOptions) => Promise<Connection<PendingPayment>>;
+        /**
+         * 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: (orderId: string, invoiceId: string, kind: InvoiceFileKind, options?: RequestOptions) => Promise<InvoiceFile | null>;
         addresses: {
             list: (options?: RequestOptions) => Promise<{
                 nodes: Address[];
@@ -605,7 +622,7 @@ declare function productAvailability(product: Pick<Product, 'variants' | 'availa
  */
 
 type PaymentLocale = AvailabilityLocale;
-type PaymentMessageKey = `decline.${DeclineCode}` | 'state.loading' | 'state.processing' | 'state.approved' | 'state.in_review' | 'state.voucher' | 'state.challenge' | 'state.expired' | 'state.cancelled' | 'state.redirect' | 'state.fallback' | 'error.network' | 'error.card_data' | 'error.price_mismatch' | 'error.payment_in_progress' | 'error.expired' | 'error.too_many_attempts' | 'error.generic' | 'action.retry' | 'action.try_again' | 'action.pay' | 'action.cancel' | 'voucher.title' | 'voucher.point' | 'voucher.reference' | 'voucher.amount' | 'voucher.expires' | 'voucher.clabe' | 'voucher.barcode' | 'voucher.open' | 'voucher.email' | 'form.label' | 'challenge.title';
+type PaymentMessageKey = `decline.${DeclineCode}` | 'state.loading' | 'state.processing' | 'state.approved' | 'state.in_review' | 'state.voucher' | 'state.challenge' | 'state.expired' | 'state.cancelled' | 'state.redirect' | 'state.fallback' | 'error.network' | 'error.card_data' | 'error.price_mismatch' | 'error.payment_in_progress' | 'error.expired' | 'error.too_many_attempts' | 'error.generic' | 'action.retry' | 'action.try_again' | 'action.pay' | 'action.cancel' | 'voucher.title' | 'voucher.point' | 'voucher.reference' | 'voucher.amount' | 'voucher.expires' | 'voucher.clabe' | 'voucher.barcode' | 'voucher.open' | 'voucher.email' | 'form.label' | 'challenge.title' | 'challenge.escape' | 'challenge.escape_hint' | 'challenge.left';
 type PaymentMessages = Record<PaymentMessageKey, string>;
 /** Catalog for a locale (`es-MX` -> es, `en-US` -> en) with the shop's per-key overrides applied. */
 declare function paymentMessages(locale: string | null | undefined, overrides?: Partial<PaymentMessages> | null): PaymentMessages;
@@ -786,6 +803,53 @@ declare function hreflangLinks(markets: MarketInfo[], path: string, defaultMarke
     href: string;
 }[];
 
+/** Steps of an order that ships, in order. */
+declare const SHIPPING_STEPS: readonly ["paid", "preparing", "shipped", "in_transit", "delivered"];
+/** Steps of an order the buyer picks up. */
+declare const PICKUP_STEPS: readonly ["paid", "preparing", "ready_for_pickup", "delivered"];
+/** A shipment the buyer can be told about as real: not a sandbox one. */
+declare function isTestShipment(s: Pick<Shipment, 'test_mode' | 'environment'> | null | undefined): boolean;
+/** An invoice or credit note from a sandbox PAC. */
+declare function isTestInvoice(d: Pick<InvoiceDoc, 'test_mode' | 'environment'> | null | undefined): boolean;
+/** `https` URL with no credentials, or `null`. The only kind of link a tracking or voucher button may carry. */
+declare function safeTrackingUrl(value: unknown): string | null;
+/** Newest first, invalid dates last, ties keep the server's order; at most `limit` (default 50, the contract's cap). */
+declare function sortTrackingEvents(events: readonly ShipmentEvent[] | null | undefined, limit?: number): ShipmentEvent[];
+/** The shipments of the order that count: outbound/pickup/local first, returns after; stable otherwise. */
+declare function orderShipments(order: Pick<Order, 'shipments'> | null | undefined): Shipment[];
+/**
+ * The unified progress. The server's `order.progress` wins when it is well formed; otherwise it is derived, so a store
+ * on an older OPS still gets a timeline. Pending payment, cancelled and refunded orders have no steps to walk: `steps`
+ * lists them as `pending` (or `[]` when cancelled/refunded) and the stage says why.
+ */
+declare function orderProgress(order: Order): OrderProgress;
+/**
+ * The action to put first. The server's `next_action` wins (its `href` is re-checked: only `https`); an older server
+ * gets one derived from the order and its invoice. Never `null`: `{ kind: 'none' }` means "nothing to offer".
+ */
+declare function nextAction(order: Order): NextAction;
+/** Latest known status among the live (non-sandbox, non-return) shipments, or `null`. */
+declare function shipmentsStatus(order: Order): ShipmentStatus | null;
+
+/** Invoices and credit notes of an order, and the bytes of a downloaded file. Pure; no URL of the PAC ever passes here. */
+
+type InvoiceGroup = {
+    invoice: InvoiceDoc;
+    creditNotes: InvoiceDoc[];
+};
+/**
+ * Groups credit notes under the invoice they correct (`related_to`), keeping the server's order. A credit note whose
+ * invoice is not in the list (or has no `related_to`) is returned in `orphans`, never dropped.
+ */
+declare function groupInvoiceDocs(docs: readonly InvoiceDoc[] | null | undefined): {
+    groups: InvoiceGroup[];
+    orphans: InvoiceDoc[];
+};
+/** Decodes `content_base64` of a downloaded invoice file. Throws `TypeError` when it is not valid base64. */
+declare function invoiceFileBytes(file: Pick<InvoiceFile, 'content_base64'>): Uint8Array;
+/** A download filename that is safe in a `Content-Disposition` header: no path, quotes, control characters or spaces. */
+declare function safeInvoiceFilename(name: unknown, fallback?: string): string;
+
 /** Kind of a delivery radio: `ship` (address only, quote later), `rate` (a quoted rate) or `pickup` (a branch). */
 type DeliveryChoiceKind = 'ship' | 'rate' | 'pickup';
 type DeliveryChoice = {
@@ -817,4 +881,4 @@ type DeliveryNotices = {
 /** Splits `delivery.unavailable` into the `missing_weight` notice and the generic one. */
 declare function deliveryNotices(delivery: Pick<DeliveryOptions, 'unavailable' | 'partial'> | null | undefined): DeliveryNotices;
 
-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, CustomerCapabilities, CustomerIdentifier, CustomerPasswordLoginInput, CustomerRegisterInput, CustomerRegisterResult, CustomerResetPasswordInput, CustomerSession, CustomerSessionInput, CustomerSetPasswordInput, CustomerUpdateInput, CustomerVerifyRegistrationInput, DeclineCode, type DeliveryChoice, type DeliveryChoiceKind, DeliveryInput, DeliveryMethod, type DeliveryNotices, DeliveryOptions, type DiagnoseOptions, type DiscountBarState, type DiscountBarView, type FetchLike, type FormatMoneyOptions, GeoPoint, InsufficientStockLine, InvoiceRequest, InvoiceResult, Location, LocationListParams, MISSING_WEIGHT, type MarketInfo, type MarketSuggestion, Menu, Money, NOTE_MAX_LENGTH, NearestLocation, Order, PAYMENT_CHOICE_REFUSED_FIELD, Page, type PaginationParams, PaymentAttemptResult, PaymentConfig, type PaymentErrorClass, type PaymentErrorClassKind, type PaymentErrorKind, type PaymentErrorLike, 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, Region, 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, TokenIntrospection, UnavailableRateProvider, type WriteOptions, appendParams, availabilityLocale, availabilityMessages, availabilityView, cartLineProblemView, clampPercent, classifyPaymentError, createStorefrontClient, declineMessage, declineMessageKey, deliveryInput, deliveryNotices, diagnose, formatAvailabilityMessage, formatMoney, formatVoucherExpiry, generateIdempotencyKey, hreflangLinks, isStorefrontError, isTokenPublishable, maskToken, negotiateLocale, normalizeClientIp, normalizeNote, opsSaysNotRetryable, parseDelivery, parseMoney, parseProductFilters, paymentErrorView, paymentIdempotencyKey, paymentMessages, paymentOutcome, preferredLanguages, productAvailability, productListQuery, promoProgressView, promotionMessages, repairPath, resolveAvailability, rewardLabel, safeHttpsUrl, schemaAvailability, storefrontDomainHeader, suggestMarket, toMoney, visitorCountry };
+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, CustomerCapabilities, CustomerIdentifier, CustomerPasswordLoginInput, CustomerRegisterInput, CustomerRegisterResult, CustomerResetPasswordInput, CustomerSession, CustomerSessionInput, CustomerSetPasswordInput, CustomerUpdateInput, CustomerVerifyRegistrationInput, DeclineCode, type DeliveryChoice, type DeliveryChoiceKind, DeliveryInput, DeliveryMethod, type DeliveryNotices, DeliveryOptions, type DiagnoseOptions, type DiscountBarState, type DiscountBarView, type FetchLike, type FormatMoneyOptions, GeoPoint, InsufficientStockLine, InvoiceDoc, InvoiceFile, InvoiceFileKind, type InvoiceGroup, InvoiceRequest, InvoiceResult, Location, LocationListParams, MISSING_WEIGHT, type MarketInfo, type MarketSuggestion, Menu, Money, NOTE_MAX_LENGTH, NearestLocation, NextAction, Order, OrderProgress, PAYMENT_CHOICE_REFUSED_FIELD, PICKUP_STEPS, Page, type PaginationParams, PaymentAttemptResult, PaymentConfig, type PaymentErrorClass, type PaymentErrorClassKind, type PaymentErrorKind, type PaymentErrorLike, type PaymentErrorView, type PaymentLocale, type PaymentMessageKey, type PaymentMessages, PaymentMethods, PaymentNextStep, type PaymentOutcome, type PaymentOutcomeKind, PaymentSubmitInput, PaymentVoucher, PendingPayment, type PreviewOptions, Product, ProductConnection, type ProductListParams, ProductSort, ProductVariant, type PromoProgressView, type PromotionLocale, type PromotionMessageKey, type PromotionMessages, PromotionReward, PromotionsList, type QueryParams, type QueryValue, RecommendationPlacement, Region, type RequestOptions, type ResolveAvailabilityOptions, RestockSubscriptionInput, RestockSubscriptionResult, ReturnRequest, ReturnRequestInput, SHIPPING_STEPS, Shipment, ShipmentEvent, ShipmentStatus, type ShippingBarState, type ShippingBarView, Shop, StockLevel, type StorefrontClient, type StorefrontClientOptions, StorefrontError, StorefrontErrorCode, type StorefrontErrorInit, type StorefrontRequestContext, type StorefrontResponseContext, Theme, TokenIntrospection, UnavailableRateProvider, type WriteOptions, appendParams, availabilityLocale, availabilityMessages, availabilityView, cartLineProblemView, clampPercent, classifyPaymentError, createStorefrontClient, declineMessage, declineMessageKey, deliveryInput, deliveryNotices, diagnose, formatAvailabilityMessage, formatMoney, formatVoucherExpiry, generateIdempotencyKey, groupInvoiceDocs, hreflangLinks, invoiceFileBytes, isStorefrontError, isTestInvoice, isTestShipment, isTokenPublishable, maskToken, negotiateLocale, nextAction, normalizeClientIp, normalizeNote, opsSaysNotRetryable, orderProgress, orderShipments, parseDelivery, parseMoney, parseProductFilters, paymentErrorView, paymentIdempotencyKey, paymentMessages, paymentOutcome, preferredLanguages, productAvailability, productListQuery, promoProgressView, promotionMessages, repairPath, resolveAvailability, rewardLabel, safeHttpsUrl, safeInvoiceFilename, safeTrackingUrl, schemaAvailability, shipmentsStatus, sortTrackingEvents, storefrontDomainHeader, suggestMarket, toMoney, visitorCountry };