@asteby/storefront 0.12.0 → 0.14.0

package/dist/mockup.d.cts

@@ -1,4 +1,4 @@
-import { aE as Product, aK as ProductVariant } from './types-BQ3S6VjF.cjs';
+import { aV as Product, a$ as ProductVariant } from './types-BuKb-zbi.cjs';
 import './geo.cjs';
 
 /**

package/dist/mockup.d.ts

@@ -1,4 +1,4 @@
-import { aE as Product, aK as ProductVariant } from './types-C_rsJRCl.js';
+import { aV as Product, a$ as ProductVariant } from './types-BeTemDg6.js';
 import './geo.js';
 
 /**

package/dist/node.cjs

@@ -47,7 +47,7 @@ function maskToken(token) {
 }
 
 // src/node.ts
-var SDK_VERSION = true ? "0.12.0" : "dev";
+var SDK_VERSION = true ? "0.14.0" : "dev";
 function createFileTokenSource(file, options = {}) {
   const ttl = options.ttlMs ?? 3e4;
   const now = options.now ?? Date.now;

package/dist/node.js

@@ -11,7 +11,7 @@ function maskToken(token) {
 }
 
 // src/node.ts
-var SDK_VERSION = true ? "0.12.0" : "dev";
+var SDK_VERSION = true ? "0.14.0" : "dev";
 function createFileTokenSource(file, options = {}) {
   const ttl = options.ttlMs ?? 3e4;
   const now = options.now ?? Date.now;

package/dist/{types-C_rsJRCl.d.ts → types-BeTemDg6.d.ts}

@@ -576,16 +576,224 @@ type OrderLine = {
     total: Money;
     image: Image | null;
 };
+/**
+ * Enums the server may grow (contract 1.8): every union here keeps `(string & {})`, so a value this SDK does not know
+ * type-checks and the UI shows a safe fallback instead of breaking.
+ */
+type OrderStage = 'pending_payment' | 'paid' | 'preparing' | 'ready_for_pickup' | 'shipped' | 'in_transit' | 'out_for_delivery' | 'delivered' | 'cancelled' | 'refunded' | (string & {});
+type OrderStepKey = 'paid' | 'preparing' | 'ready_for_pickup' | 'shipped' | 'in_transit' | 'delivered' | (string & {});
+type OrderStepState = 'done' | 'current' | 'pending' | 'problem' | (string & {});
+type OrderProgressStep = {
+    key: OrderStepKey;
+    state: OrderStepState;
+    at?: string | null;
+};
+/** What stops the order. `code` is open: `delivery_exception`, `returned`, `lost`, `payment_failed`, ... */
+type OrderProblem = {
+    code: string;
+    at?: string | null;
+};
+/** Unified timeline of the order (payment, preparation, shipping, delivery). */
+type OrderProgress = {
+    stage: OrderStage;
+    problem?: OrderProblem | null;
+    steps: OrderProgressStep[];
+};
+type NextActionKind = 'pay' | 'track' | 'pickup' | 'download_invoice' | 'request_invoice' | 'correct_invoice_data' | 'contact_store' | 'none' | (string & {});
+/** The one thing the store should offer the buyer on this order. `href` is `https` only (tracking or voucher). */
+type NextAction = {
+    kind: NextActionKind;
+    href?: string | null;
+    /** Id of the shipment or invoice the action points at. */
+    ref?: string | null;
+};
+type ShipmentStatus = 'pending' | 'label_created' | 'in_transit' | 'out_for_delivery' | 'delivered' | 'exception' | 'returned' | 'lost' | 'cancelled' | (string & {});
+type ShipmentKind = 'outbound' | 'return' | 'pickup' | 'local' | (string & {});
+type ShipmentEvent = {
+    id: string;
+    status: ShipmentStatus;
+    description?: string | null;
+    /** City / state text; never an address. */
+    location?: string | null;
+    occurred_at: string;
+    source?: 'carrier' | 'store' | null | (string & {});
+};
+/** Approximate point (city or state), rounded by the server. Never an address. */
+type GeoHint = {
+    label: string;
+    lat: number;
+    lng: number;
+    precision: 'city' | 'state' | (string & {});
+};
+type ShipmentMap = {
+    origin?: GeoHint | null;
+    destination?: GeoHint | null;
+    path?: GeoHint[];
+};
+/**
+ * A shipment as the buyer sees it. A `test_mode` shipment (sandbox) is never shown as real: hide it or mark it
+ * "test". `label_url` exists only on `kind: 'return'`.
+ */
+type Shipment = {
+    id: string;
+    number?: string | null;
+    kind: ShipmentKind;
+    status: ShipmentStatus;
+    environment?: 'production' | 'sandbox' | (string & {});
+    test_mode?: boolean;
+    carrier?: string | null;
+    /** Key of the carrier logo in the SDK brand set (`dhl`, `estafeta`...). */
+    carrier_logo_key?: string | null;
+    service?: string | null;
+    tracking_number?: string | null;
+    /** `https` only. */
+    tracking_url?: string | null;
+    shipped_at?: string | null;
+    delivered_at?: string | null;
+    /** `YYYY-MM-DD`. */
+    promised_by?: string | null;
+    label_url?: string | null;
+    /** At most 50, newest first. */
+    events: ShipmentEvent[];
+    map?: ShipmentMap | null;
+};
+/** List-view summary of the shipments of an order. */
+type ShipmentsSummary = {
+    count: number;
+    status: ShipmentStatus;
+    carrier?: string | null;
+    tracking_url?: string | null;
+};
+/** An invoice or credit note of an order (extends `InvoiceSummary`). Links, when present, are short-lived and never the PAC's. */
+type InvoiceDoc = InvoiceSummary & {
+    id: string;
+    /** `issued | pending | cancelled | error` (open). */
+    status: 'issued' | 'pending' | 'cancelled' | 'error' | (string & {});
+    kind: 'invoice' | 'credit_note' | (string & {});
+    total?: Money | null;
+    issued_at?: string | null;
+    cancelled_at?: string | null;
+    series?: string | null;
+    folio_number?: string | null;
+    /** Id of the invoice a credit note corrects. */
+    related_to?: string | null;
+    links_expire_at?: string | null;
+    /** Invoice from a sandbox PAC: hide it or mark it "test, no fiscal validity". */
+    test_mode?: boolean;
+    environment?: 'production' | 'sandbox' | (string & {});
+};
+type PaymentInfo = {
+    method_label: string;
+    family?: 'card' | 'cash_voucher' | 'transfer' | 'wallet' | 'other' | null | (string & {});
+    status: 'paid' | 'pending' | 'failed' | 'refunded' | 'partially_refunded' | (string & {});
+    amount: Money;
+    paid_at?: string | null;
+};
+type Refund = {
+    id: string;
+    amount: Money;
+    status: 'requested' | 'processing' | 'completed' | 'failed' | (string & {});
+    method_label?: string | null;
+    created_at: string;
+    completed_at?: string | null;
+    return_id?: string | null;
+};
+/** A section of the order the server could not read; the rest of the order is still valid. */
+type OrderSection = 'shipments' | 'invoices' | 'payments' | 'refunds' | (string & {});
+type OrderPickup = {
+    location_id?: string | null;
+    name?: string | null;
+    address?: string | null;
+    city?: string | null;
+    phone?: string | null;
+    ready_at?: string | null;
+    delivered_at?: string | null;
+};
 type Order = {
     id: string;
     number: string;
+    /** Open: `placed`, `paid`, `shipped`, `fulfilled`... Prefer `progress`. */
     status: string;
     created_at: string;
     total: Money;
     lines: OrderLine[];
     /** Invoice state; absent on older servers. */
     invoice?: InvoiceSummary;
+    delivery_method?: 'shipping' | 'pickup' | null | (string & {});
+    pickup?: OrderPickup | null;
+    payment_status?: string | null;
+    subtotal?: Money;
+    tax?: Money;
+    shipping?: Money;
+    discount?: Money;
+    tax_included?: boolean;
+    shipping_method?: string | null;
+    /** Detail only: the address as the checkout captured it (the buyer's own). */
+    shipping_address?: Record<string, unknown> | null;
+    /** @deprecated Use `shipments[0].tracking_number`: it does not say if it is a sandbox guide. */
+    tracking?: string | null;
+    /** @deprecated Use `shipments`. */
+    fulfillments?: {
+        status: string;
+        tracking?: string | null;
+        shipped_at?: string | null;
+    }[];
+    returns?: {
+        id: string;
+        status: string;
+        created_at?: string | null;
+    }[];
+    /** Servers older than contract 1.8 omit it: use `orderProgress(order)`. */
+    progress?: OrderProgress;
+    /** Servers older than contract 1.8 omit it: use `nextAction(order)`. */
+    next_action?: NextAction | null;
+    /** Detail only. */
+    shipments?: Shipment[];
+    /** List only (the detail carries `shipments`). */
+    shipments_summary?: ShipmentsSummary;
+    /** Detail only: invoices and credit notes. */
+    invoices?: InvoiceDoc[];
+    /** Detail only. */
+    payments?: PaymentInfo[];
+    /** Detail only. */
+    refunds?: Refund[];
+    /** Sections that could not be read (`shipments`, `invoices`...): show a retry there, the rest is fine. */
+    degraded?: OrderSection[];
+};
+/** Cash voucher of a payment still waiting (OXXO, SPEI...). */
+type PendingPaymentVoucher = {
+    provider?: string | null;
+    method?: string | null;
+    reference: string | null;
+    barcode: string | null;
+    clabe: string | null;
+    /** `https` only. */
+    voucher_url?: string | null;
+    instructions?: string | null;
+    expires_at: string | null;
+    amount: Money;
+};
+/** A checkout waiting for its payment: there is no order yet (the order exists once the payment confirms). */
+type PendingPayment = {
+    /** Checkout id. */
+    id: string;
+    number: null;
+    status: 'pending_payment' | 'expired' | (string & {});
+    created_at: string;
+    total: Money;
+    expires_at: string | null;
+    payment: PendingPaymentVoucher;
+};
+/**
+ * A file of an invoice (`pdf` or `xml`), already read on the server so the browser never sees the buyer token nor a URL
+ * of the PAC. Serve it from your own route: `invoiceFileBytes(file)` gives the bytes.
+ */
+type InvoiceFile = {
+    filename: string;
+    content_type: string;
+    content_base64: string;
 };
+type InvoiceFileKind = 'pdf' | 'xml';
 type ReturnRequestInput = {
     lines: {
         sku: string;
@@ -1180,4 +1388,4 @@ type IdentityRulesV1 = {
     fields: IdentityFieldRule[];
 };
 
-export type { IdentityRulesV1 as $, Address as A, CustomerCapabilities as B, Cart as C, CustomerIdentifier as D, CustomerPasswordLoginInput as E, CustomerRegisterInput as F, CustomerRegisterResult as G, CustomerResetPasswordInput as H, CustomerSession as I, CustomerSessionInput as J, CustomerSetPasswordInput as K, CustomerUpdateInput as L, CustomerVerifyRegistrationInput as M, DeclineCode as N, DeliveryInput as O, DeliveryMethod as P, DeliveryOptions as Q, Facet as R, FacetValue as S, FiscalDocumentEvidence as T, FiscalDocumentSource as U, FiscalIdentity as V, FiscalIdentityInput as W, FiscalVerification as X, IdentityCapture as Y, IdentityDocumentSpec as Z, IdentityFieldRule as _, AddressInput as a, ShippingRate as a$, IdentityStrategy as a0, Image as a1, InsufficientStockDetails as a2, InsufficientStockLine as a3, InvoiceAction as a4, InvoiceRequest as a5, InvoiceResult as a6, InvoiceStage as a7, InvoiceSummary as a8, InvoicingCapabilities as a9, PaymentPoint as aA, PaymentSubmitInput as aB, PaymentVoucher as aC, PickupOption as aD, Product as aE, ProductAttributeValue as aF, ProductCategory as aG, ProductConnection as aH, ProductOption as aI, ProductSort as aJ, ProductVariant as aK, PromotionAnnouncement as aL, PromotionReward as aM, PromotionTier as aN, PromotionsList as aO, RecommendationPlacement as aP, Region as aQ, RegionFiscalEntry as aR, RegionFiscalId as aS, RegionPaymentMethod as aT, RestockSubscriptionInput as aU, RestockSubscriptionResult as aV, ReturnRequest as aW, ReturnRequestInput as aX, SEO as aY, Section as aZ, SelectedOption as a_, Location as aa, LocationContacts as ab, LocationKind as ac, LocationListParams as ad, LocationPickup as ae, Menu as af, MenuItem as ag, Money as ah, MoneyRange as ai, NearestLocation as aj, Order as ak, OrderLine as al, Page as am, PageInfo as an, PaymentAction as ao, PaymentAttemptResult as ap, PaymentAttemptStatus as aq, PaymentClient as ar, PaymentClientCsp as as, PaymentConfig as at, PaymentFlow as au, PaymentMethod as av, PaymentMethods as aw, PaymentNextStep as ax, PaymentOption as ay, PaymentOptionKey as az, Article as b, Shop as b0, ShopBranch as b1, ShopContact as b2, ShopPolicies as b3, StockLevel as b4, StorefrontErrorBody as b5, StorefrontErrorCode as b6, Theme as b7, TokenIntrospection as b8, UnavailableRateProvider as b9, Availability as c, AvailabilityStatus as d, CartBuyer as e, CartBuyerInput as f, CartCost as g, CartDelivery as h, CartDiscountCode as i, CartDiscountLine as j, CartInvoice as k, CartLine as l, CartLineInput as m, CartLineMerchandise as n, CartLineProblem as o, CartLineUpdateInput as p, CartPromotions as q, CartRecommendation as r, CartRecommendations as s, CheckoutInfo as t, CheckoutInput as u, CheckoutPayment as v, CheckoutResult as w, Collection as x, Connection as y, Customer as z };
+export type { IdentityFieldRule as $, Address as A, CustomerCapabilities as B, Cart as C, CustomerIdentifier as D, CustomerPasswordLoginInput as E, CustomerRegisterInput as F, CustomerRegisterResult as G, CustomerResetPasswordInput as H, CustomerSession as I, CustomerSessionInput as J, CustomerSetPasswordInput as K, CustomerUpdateInput as L, CustomerVerifyRegistrationInput as M, DeclineCode as N, DeliveryInput as O, DeliveryMethod as P, DeliveryOptions as Q, Facet as R, FacetValue as S, FiscalDocumentEvidence as T, FiscalDocumentSource as U, FiscalIdentity as V, FiscalIdentityInput as W, FiscalVerification as X, GeoHint as Y, IdentityCapture as Z, IdentityDocumentSpec as _, AddressInput as a, ProductVariant as a$, IdentityRulesV1 as a0, IdentityStrategy as a1, Image as a2, InsufficientStockDetails as a3, InsufficientStockLine as a4, InvoiceAction as a5, InvoiceDoc as a6, InvoiceFile as a7, InvoiceFileKind as a8, InvoiceRequest as a9, Page as aA, PageInfo as aB, PaymentAction as aC, PaymentAttemptResult as aD, PaymentAttemptStatus as aE, PaymentClient as aF, PaymentClientCsp as aG, PaymentConfig as aH, PaymentFlow as aI, PaymentInfo as aJ, PaymentMethod as aK, PaymentMethods as aL, PaymentNextStep as aM, PaymentOption as aN, PaymentOptionKey as aO, PaymentPoint as aP, PaymentSubmitInput as aQ, PaymentVoucher as aR, PendingPayment as aS, PendingPaymentVoucher as aT, PickupOption as aU, Product as aV, ProductAttributeValue as aW, ProductCategory as aX, ProductConnection as aY, ProductOption as aZ, ProductSort as a_, InvoiceResult as aa, InvoiceStage as ab, InvoiceSummary as ac, InvoicingCapabilities as ad, Location as ae, LocationContacts as af, LocationKind as ag, LocationListParams as ah, LocationPickup as ai, Menu as aj, MenuItem as ak, Money as al, MoneyRange as am, NearestLocation as an, NextAction as ao, NextActionKind as ap, Order as aq, OrderLine as ar, OrderPickup as as, OrderProblem as at, OrderProgress as au, OrderProgressStep as av, OrderSection as aw, OrderStage as ax, OrderStepKey as ay, OrderStepState as az, Article as b, PromotionAnnouncement as b0, PromotionReward as b1, PromotionTier as b2, PromotionsList as b3, RecommendationPlacement as b4, Refund as b5, Region as b6, RegionFiscalEntry as b7, RegionFiscalId as b8, RegionPaymentMethod as b9, RestockSubscriptionInput as ba, RestockSubscriptionResult as bb, ReturnRequest as bc, ReturnRequestInput as bd, SEO as be, Section as bf, SelectedOption as bg, Shipment as bh, ShipmentEvent as bi, ShipmentKind as bj, ShipmentMap as bk, ShipmentStatus as bl, ShipmentsSummary as bm, ShippingRate as bn, Shop as bo, ShopBranch as bp, ShopContact as bq, ShopPolicies as br, StockLevel as bs, StorefrontErrorBody as bt, StorefrontErrorCode as bu, Theme as bv, TokenIntrospection as bw, UnavailableRateProvider as bx, Availability as c, AvailabilityStatus as d, CartBuyer as e, CartBuyerInput as f, CartCost as g, CartDelivery as h, CartDiscountCode as i, CartDiscountLine as j, CartInvoice as k, CartLine as l, CartLineInput as m, CartLineMerchandise as n, CartLineProblem as o, CartLineUpdateInput as p, CartPromotions as q, CartRecommendation as r, CartRecommendations as s, CheckoutInfo as t, CheckoutInput as u, CheckoutPayment as v, CheckoutResult as w, Collection as x, Connection as y, Customer as z };

package/dist/{types-BQ3S6VjF.d.cts → types-BuKb-zbi.d.cts}

@@ -576,16 +576,224 @@ type OrderLine = {
     total: Money;
     image: Image | null;
 };
+/**
+ * Enums the server may grow (contract 1.8): every union here keeps `(string & {})`, so a value this SDK does not know
+ * type-checks and the UI shows a safe fallback instead of breaking.
+ */
+type OrderStage = 'pending_payment' | 'paid' | 'preparing' | 'ready_for_pickup' | 'shipped' | 'in_transit' | 'out_for_delivery' | 'delivered' | 'cancelled' | 'refunded' | (string & {});
+type OrderStepKey = 'paid' | 'preparing' | 'ready_for_pickup' | 'shipped' | 'in_transit' | 'delivered' | (string & {});
+type OrderStepState = 'done' | 'current' | 'pending' | 'problem' | (string & {});
+type OrderProgressStep = {
+    key: OrderStepKey;
+    state: OrderStepState;
+    at?: string | null;
+};
+/** What stops the order. `code` is open: `delivery_exception`, `returned`, `lost`, `payment_failed`, ... */
+type OrderProblem = {
+    code: string;
+    at?: string | null;
+};
+/** Unified timeline of the order (payment, preparation, shipping, delivery). */
+type OrderProgress = {
+    stage: OrderStage;
+    problem?: OrderProblem | null;
+    steps: OrderProgressStep[];
+};
+type NextActionKind = 'pay' | 'track' | 'pickup' | 'download_invoice' | 'request_invoice' | 'correct_invoice_data' | 'contact_store' | 'none' | (string & {});
+/** The one thing the store should offer the buyer on this order. `href` is `https` only (tracking or voucher). */
+type NextAction = {
+    kind: NextActionKind;
+    href?: string | null;
+    /** Id of the shipment or invoice the action points at. */
+    ref?: string | null;
+};
+type ShipmentStatus = 'pending' | 'label_created' | 'in_transit' | 'out_for_delivery' | 'delivered' | 'exception' | 'returned' | 'lost' | 'cancelled' | (string & {});
+type ShipmentKind = 'outbound' | 'return' | 'pickup' | 'local' | (string & {});
+type ShipmentEvent = {
+    id: string;
+    status: ShipmentStatus;
+    description?: string | null;
+    /** City / state text; never an address. */
+    location?: string | null;
+    occurred_at: string;
+    source?: 'carrier' | 'store' | null | (string & {});
+};
+/** Approximate point (city or state), rounded by the server. Never an address. */
+type GeoHint = {
+    label: string;
+    lat: number;
+    lng: number;
+    precision: 'city' | 'state' | (string & {});
+};
+type ShipmentMap = {
+    origin?: GeoHint | null;
+    destination?: GeoHint | null;
+    path?: GeoHint[];
+};
+/**
+ * A shipment as the buyer sees it. A `test_mode` shipment (sandbox) is never shown as real: hide it or mark it
+ * "test". `label_url` exists only on `kind: 'return'`.
+ */
+type Shipment = {
+    id: string;
+    number?: string | null;
+    kind: ShipmentKind;
+    status: ShipmentStatus;
+    environment?: 'production' | 'sandbox' | (string & {});
+    test_mode?: boolean;
+    carrier?: string | null;
+    /** Key of the carrier logo in the SDK brand set (`dhl`, `estafeta`...). */
+    carrier_logo_key?: string | null;
+    service?: string | null;
+    tracking_number?: string | null;
+    /** `https` only. */
+    tracking_url?: string | null;
+    shipped_at?: string | null;
+    delivered_at?: string | null;
+    /** `YYYY-MM-DD`. */
+    promised_by?: string | null;
+    label_url?: string | null;
+    /** At most 50, newest first. */
+    events: ShipmentEvent[];
+    map?: ShipmentMap | null;
+};
+/** List-view summary of the shipments of an order. */
+type ShipmentsSummary = {
+    count: number;
+    status: ShipmentStatus;
+    carrier?: string | null;
+    tracking_url?: string | null;
+};
+/** An invoice or credit note of an order (extends `InvoiceSummary`). Links, when present, are short-lived and never the PAC's. */
+type InvoiceDoc = InvoiceSummary & {
+    id: string;
+    /** `issued | pending | cancelled | error` (open). */
+    status: 'issued' | 'pending' | 'cancelled' | 'error' | (string & {});
+    kind: 'invoice' | 'credit_note' | (string & {});
+    total?: Money | null;
+    issued_at?: string | null;
+    cancelled_at?: string | null;
+    series?: string | null;
+    folio_number?: string | null;
+    /** Id of the invoice a credit note corrects. */
+    related_to?: string | null;
+    links_expire_at?: string | null;
+    /** Invoice from a sandbox PAC: hide it or mark it "test, no fiscal validity". */
+    test_mode?: boolean;
+    environment?: 'production' | 'sandbox' | (string & {});
+};
+type PaymentInfo = {
+    method_label: string;
+    family?: 'card' | 'cash_voucher' | 'transfer' | 'wallet' | 'other' | null | (string & {});
+    status: 'paid' | 'pending' | 'failed' | 'refunded' | 'partially_refunded' | (string & {});
+    amount: Money;
+    paid_at?: string | null;
+};
+type Refund = {
+    id: string;
+    amount: Money;
+    status: 'requested' | 'processing' | 'completed' | 'failed' | (string & {});
+    method_label?: string | null;
+    created_at: string;
+    completed_at?: string | null;
+    return_id?: string | null;
+};
+/** A section of the order the server could not read; the rest of the order is still valid. */
+type OrderSection = 'shipments' | 'invoices' | 'payments' | 'refunds' | (string & {});
+type OrderPickup = {
+    location_id?: string | null;
+    name?: string | null;
+    address?: string | null;
+    city?: string | null;
+    phone?: string | null;
+    ready_at?: string | null;
+    delivered_at?: string | null;
+};
 type Order = {
     id: string;
     number: string;
+    /** Open: `placed`, `paid`, `shipped`, `fulfilled`... Prefer `progress`. */
     status: string;
     created_at: string;
     total: Money;
     lines: OrderLine[];
     /** Invoice state; absent on older servers. */
     invoice?: InvoiceSummary;
+    delivery_method?: 'shipping' | 'pickup' | null | (string & {});
+    pickup?: OrderPickup | null;
+    payment_status?: string | null;
+    subtotal?: Money;
+    tax?: Money;
+    shipping?: Money;
+    discount?: Money;
+    tax_included?: boolean;
+    shipping_method?: string | null;
+    /** Detail only: the address as the checkout captured it (the buyer's own). */
+    shipping_address?: Record<string, unknown> | null;
+    /** @deprecated Use `shipments[0].tracking_number`: it does not say if it is a sandbox guide. */
+    tracking?: string | null;
+    /** @deprecated Use `shipments`. */
+    fulfillments?: {
+        status: string;
+        tracking?: string | null;
+        shipped_at?: string | null;
+    }[];
+    returns?: {
+        id: string;
+        status: string;
+        created_at?: string | null;
+    }[];
+    /** Servers older than contract 1.8 omit it: use `orderProgress(order)`. */
+    progress?: OrderProgress;
+    /** Servers older than contract 1.8 omit it: use `nextAction(order)`. */
+    next_action?: NextAction | null;
+    /** Detail only. */
+    shipments?: Shipment[];
+    /** List only (the detail carries `shipments`). */
+    shipments_summary?: ShipmentsSummary;
+    /** Detail only: invoices and credit notes. */
+    invoices?: InvoiceDoc[];
+    /** Detail only. */
+    payments?: PaymentInfo[];
+    /** Detail only. */
+    refunds?: Refund[];
+    /** Sections that could not be read (`shipments`, `invoices`...): show a retry there, the rest is fine. */
+    degraded?: OrderSection[];
+};
+/** Cash voucher of a payment still waiting (OXXO, SPEI...). */
+type PendingPaymentVoucher = {
+    provider?: string | null;
+    method?: string | null;
+    reference: string | null;
+    barcode: string | null;
+    clabe: string | null;
+    /** `https` only. */
+    voucher_url?: string | null;
+    instructions?: string | null;
+    expires_at: string | null;
+    amount: Money;
+};
+/** A checkout waiting for its payment: there is no order yet (the order exists once the payment confirms). */
+type PendingPayment = {
+    /** Checkout id. */
+    id: string;
+    number: null;
+    status: 'pending_payment' | 'expired' | (string & {});
+    created_at: string;
+    total: Money;
+    expires_at: string | null;
+    payment: PendingPaymentVoucher;
+};
+/**
+ * A file of an invoice (`pdf` or `xml`), already read on the server so the browser never sees the buyer token nor a URL
+ * of the PAC. Serve it from your own route: `invoiceFileBytes(file)` gives the bytes.
+ */
+type InvoiceFile = {
+    filename: string;
+    content_type: string;
+    content_base64: string;
 };
+type InvoiceFileKind = 'pdf' | 'xml';
 type ReturnRequestInput = {
     lines: {
         sku: string;
@@ -1180,4 +1388,4 @@ type IdentityRulesV1 = {
     fields: IdentityFieldRule[];
 };
 
-export type { IdentityRulesV1 as $, Address as A, CustomerCapabilities as B, Cart as C, CustomerIdentifier as D, CustomerPasswordLoginInput as E, CustomerRegisterInput as F, CustomerRegisterResult as G, CustomerResetPasswordInput as H, CustomerSession as I, CustomerSessionInput as J, CustomerSetPasswordInput as K, CustomerUpdateInput as L, CustomerVerifyRegistrationInput as M, DeclineCode as N, DeliveryInput as O, DeliveryMethod as P, DeliveryOptions as Q, Facet as R, FacetValue as S, FiscalDocumentEvidence as T, FiscalDocumentSource as U, FiscalIdentity as V, FiscalIdentityInput as W, FiscalVerification as X, IdentityCapture as Y, IdentityDocumentSpec as Z, IdentityFieldRule as _, AddressInput as a, ShippingRate as a$, IdentityStrategy as a0, Image as a1, InsufficientStockDetails as a2, InsufficientStockLine as a3, InvoiceAction as a4, InvoiceRequest as a5, InvoiceResult as a6, InvoiceStage as a7, InvoiceSummary as a8, InvoicingCapabilities as a9, PaymentPoint as aA, PaymentSubmitInput as aB, PaymentVoucher as aC, PickupOption as aD, Product as aE, ProductAttributeValue as aF, ProductCategory as aG, ProductConnection as aH, ProductOption as aI, ProductSort as aJ, ProductVariant as aK, PromotionAnnouncement as aL, PromotionReward as aM, PromotionTier as aN, PromotionsList as aO, RecommendationPlacement as aP, Region as aQ, RegionFiscalEntry as aR, RegionFiscalId as aS, RegionPaymentMethod as aT, RestockSubscriptionInput as aU, RestockSubscriptionResult as aV, ReturnRequest as aW, ReturnRequestInput as aX, SEO as aY, Section as aZ, SelectedOption as a_, Location as aa, LocationContacts as ab, LocationKind as ac, LocationListParams as ad, LocationPickup as ae, Menu as af, MenuItem as ag, Money as ah, MoneyRange as ai, NearestLocation as aj, Order as ak, OrderLine as al, Page as am, PageInfo as an, PaymentAction as ao, PaymentAttemptResult as ap, PaymentAttemptStatus as aq, PaymentClient as ar, PaymentClientCsp as as, PaymentConfig as at, PaymentFlow as au, PaymentMethod as av, PaymentMethods as aw, PaymentNextStep as ax, PaymentOption as ay, PaymentOptionKey as az, Article as b, Shop as b0, ShopBranch as b1, ShopContact as b2, ShopPolicies as b3, StockLevel as b4, StorefrontErrorBody as b5, StorefrontErrorCode as b6, Theme as b7, TokenIntrospection as b8, UnavailableRateProvider as b9, Availability as c, AvailabilityStatus as d, CartBuyer as e, CartBuyerInput as f, CartCost as g, CartDelivery as h, CartDiscountCode as i, CartDiscountLine as j, CartInvoice as k, CartLine as l, CartLineInput as m, CartLineMerchandise as n, CartLineProblem as o, CartLineUpdateInput as p, CartPromotions as q, CartRecommendation as r, CartRecommendations as s, CheckoutInfo as t, CheckoutInput as u, CheckoutPayment as v, CheckoutResult as w, Collection as x, Connection as y, Customer as z };
+export type { IdentityFieldRule as $, Address as A, CustomerCapabilities as B, Cart as C, CustomerIdentifier as D, CustomerPasswordLoginInput as E, CustomerRegisterInput as F, CustomerRegisterResult as G, CustomerResetPasswordInput as H, CustomerSession as I, CustomerSessionInput as J, CustomerSetPasswordInput as K, CustomerUpdateInput as L, CustomerVerifyRegistrationInput as M, DeclineCode as N, DeliveryInput as O, DeliveryMethod as P, DeliveryOptions as Q, Facet as R, FacetValue as S, FiscalDocumentEvidence as T, FiscalDocumentSource as U, FiscalIdentity as V, FiscalIdentityInput as W, FiscalVerification as X, GeoHint as Y, IdentityCapture as Z, IdentityDocumentSpec as _, AddressInput as a, ProductVariant as a$, IdentityRulesV1 as a0, IdentityStrategy as a1, Image as a2, InsufficientStockDetails as a3, InsufficientStockLine as a4, InvoiceAction as a5, InvoiceDoc as a6, InvoiceFile as a7, InvoiceFileKind as a8, InvoiceRequest as a9, Page as aA, PageInfo as aB, PaymentAction as aC, PaymentAttemptResult as aD, PaymentAttemptStatus as aE, PaymentClient as aF, PaymentClientCsp as aG, PaymentConfig as aH, PaymentFlow as aI, PaymentInfo as aJ, PaymentMethod as aK, PaymentMethods as aL, PaymentNextStep as aM, PaymentOption as aN, PaymentOptionKey as aO, PaymentPoint as aP, PaymentSubmitInput as aQ, PaymentVoucher as aR, PendingPayment as aS, PendingPaymentVoucher as aT, PickupOption as aU, Product as aV, ProductAttributeValue as aW, ProductCategory as aX, ProductConnection as aY, ProductOption as aZ, ProductSort as a_, InvoiceResult as aa, InvoiceStage as ab, InvoiceSummary as ac, InvoicingCapabilities as ad, Location as ae, LocationContacts as af, LocationKind as ag, LocationListParams as ah, LocationPickup as ai, Menu as aj, MenuItem as ak, Money as al, MoneyRange as am, NearestLocation as an, NextAction as ao, NextActionKind as ap, Order as aq, OrderLine as ar, OrderPickup as as, OrderProblem as at, OrderProgress as au, OrderProgressStep as av, OrderSection as aw, OrderStage as ax, OrderStepKey as ay, OrderStepState as az, Article as b, PromotionAnnouncement as b0, PromotionReward as b1, PromotionTier as b2, PromotionsList as b3, RecommendationPlacement as b4, Refund as b5, Region as b6, RegionFiscalEntry as b7, RegionFiscalId as b8, RegionPaymentMethod as b9, RestockSubscriptionInput as ba, RestockSubscriptionResult as bb, ReturnRequest as bc, ReturnRequestInput as bd, SEO as be, Section as bf, SelectedOption as bg, Shipment as bh, ShipmentEvent as bi, ShipmentKind as bj, ShipmentMap as bk, ShipmentStatus as bl, ShipmentsSummary as bm, ShippingRate as bn, Shop as bo, ShopBranch as bp, ShopContact as bq, ShopPolicies as br, StockLevel as bs, StorefrontErrorBody as bt, StorefrontErrorCode as bu, Theme as bv, TokenIntrospection as bw, UnavailableRateProvider as bx, Availability as c, AvailabilityStatus as d, CartBuyer as e, CartBuyerInput as f, CartCost as g, CartDelivery as h, CartDiscountCode as i, CartDiscountLine as j, CartInvoice as k, CartLine as l, CartLineInput as m, CartLineMerchandise as n, CartLineProblem as o, CartLineUpdateInput as p, CartPromotions as q, CartRecommendation as r, CartRecommendations as s, CheckoutInfo as t, CheckoutInput as u, CheckoutPayment as v, CheckoutResult as w, Collection as x, Connection as y, Customer as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteby/storefront",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "Typed client for the Storefront API v1 (catalog, cart, checkout, customer, content) using only global fetch — Node 20+, edge runtimes and browsers — plus an in-memory mock of the whole contract and, in `@asteby/storefront/fiscal-document`, a country-agnostic engine that reads a buyer's fiscal document (PDF) in the browser or Node.",
   "license": "Apache-2.0",
   "repository": {