@asteby/storefront 0.24.0 → 0.26.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { bc as ProductSort, bY as TokenIntrospection, bF as Shop, bm as Region, bq as RegionPostalCode, d as AddressSuggestions, ba as ProductConnection, b7 as Product, D as Connection, B as Collection, au as LocationListParams, ar as Location, aA as NearestLocation, bJ as StockLevel, br as RestockSubscriptionInput, bs as RestockSubscriptionResult, p as CartLineInput, C as Cart, s as CartLineUpdateInput, i as CartBuyerInput, b as AddressInput, _ as DeliveryOptions, aZ as PaymentMethods, Y as DeliveryInput, am as InvoiceRequest, bk as RecommendationPlacement, v as CartRecommendations, x as CheckoutInput, z as CheckoutResult, bh as PromotionsList, aV as PaymentConfig, b2 as PaymentSubmitInput, aR as PaymentAttemptResult, K as CustomerIdentifier, S as CustomerSessionInput, Q as CustomerSession, F as CustomerCapabilities, N as CustomerRegisterInput, O as CustomerRegisterResult, V as CustomerVerifyRegistrationInput, L as CustomerPasswordLoginInput, T as CustomerSetPasswordInput, P as CustomerResetPasswordInput, E as Customer, U as CustomerUpdateInput, R as CustomerSessionInfo, bi as ReauthInput, bj as ReauthResult, J as CustomerEmailCodeInput, H as CustomerEmailChangeInput, I as CustomerEmailChangeRequested, G as CustomerEmailChangeConfirmInput, W as DataExportFile, A as AccountDeleteInput, aD as Order, bu as ReturnRequestInput, bt as ReturnRequest, an as InvoiceResult, b4 as PendingPayment, ak as InvoiceFileKind, aj as InvoiceFile, a5 as FiscalProfile, a6 as FiscalProfileInput, bO as Subject, bT as SubjectInput, bV as SubjectPatch, a as Address, bU as SubjectKind, bX as Theme, aO as Page, aw as Menu, e as Article, ay as Money, g as AvailabilityStatus, r as CartLineProblem, f as Availability, ag as InsufficientStockLine, bd as ProductVariant, X as DeclineCode, b3 as PaymentVoucher, a_ as PaymentNextStep, t as CartPromotions, bf as PromotionReward, ai as InvoiceDoc, by as Shipment, aB as NextAction, aH as OrderProgress, bC as ShipmentStatus, bz as ShipmentEvent, bQ as SubjectCatalogNode, bR as SubjectField, Z as DeliveryMethod, bZ as UnavailableRateProvider } from './account-settings-BZKux56f.cjs';
-export { c as AddressSuggestion, h as CartBuyer, j as CartCost, k as CartDelivery, l as CartDiscountCode, m as CartDiscountLine, n as CartInvoice, o as CartLine, q as CartLineMerchandise, u as CartRecommendation, w as CheckoutInfo, y as CheckoutPayment, M as CustomerPreferences, $ as Facet, a0 as FacetValue, a1 as FiscalDocumentEvidence, a2 as FiscalDocumentSource, a3 as FiscalIdentity, a4 as FiscalIdentityInput, a7 as FiscalVerification, a8 as GeoHint, a9 as IdentityCapture, aa as IdentityDocumentSpec, ab as IdentityFieldRule, ac as IdentityRulesV1, ad as IdentityStrategy, ae as Image, af as InsufficientStockDetails, ah as InvoiceAction, al as InvoiceReceiver, ao as InvoiceStage, ap as InvoiceSummary, aq as InvoicingCapabilities, as as LocationContacts, at as LocationKind, av as LocationPickup, ax as MenuItem, az as MoneyRange, aC as NextActionKind, aE as OrderLine, aF as OrderPickup, aG as OrderProblem, aI as OrderProgressStep, aJ as OrderSection, aK as OrderShippingService, aL as OrderStage, aM as OrderStepKey, aN as OrderStepState, aP as PageInfo, aQ as PaymentAction, aS as PaymentAttemptStatus, aT as PaymentClient, aU as PaymentClientCsp, aW as PaymentFlow, aX as PaymentInfo, aY as PaymentMethod, a$ as PaymentOption, b0 as PaymentOptionKey, b1 as PaymentPoint, b5 as PendingPaymentVoucher, b6 as PickupOption, b8 as ProductAttributeValue, b9 as ProductCategory, bb as ProductOption, be as PromotionAnnouncement, bg as PromotionTier, bl as Refund, bn as RegionFiscalEntry, bo as RegionFiscalId, bp as RegionPaymentMethod, bv as SEO, bw as Section, bx as SelectedOption, bA as ShipmentKind, bB as ShipmentMap, bD as ShipmentsSummary, bE as ShippingRate, bG as ShopBranch, bH as ShopContact, bI as ShopPolicies, bK as StorefrontError, bL as StorefrontErrorBody, bM as StorefrontErrorCode, bN as StorefrontErrorInit, bP as SubjectCatalog, bS as SubjectFieldType, bW as SubjectRef, b_ as dataExportBytes, b$ as isAccountDeleteBlocked, c0 as isReauthRequired, c1 as isStorefrontError, c2 as safeExportFilename } from './account-settings-BZKux56f.cjs';
+import { bf as ProductSort, c1 as TokenIntrospection, bK as Shop, bp as Region, bt as RegionPostalCode, d as AddressSuggestions, bd as ProductConnection, ba as Product, D as Connection, B as Collection, aw as LocationListParams, at as Location, aC as NearestLocation, bO as StockLevel, bu as RestockSubscriptionInput, bv as RestockSubscriptionResult, p as CartLineInput, C as Cart, s as CartLineUpdateInput, i as CartBuyerInput, b as AddressInput, _ as DeliveryOptions, b0 as PaymentMethods, Y as DeliveryInput, ao as InvoiceRequest, bn as RecommendationPlacement, v as CartRecommendations, x as CheckoutInput, z as CheckoutResult, bk as PromotionsList, aY as PaymentConfig, b5 as PaymentSubmitInput, aU as PaymentAttemptResult, K as CustomerIdentifier, S as CustomerSessionInput, Q as CustomerSession, F as CustomerCapabilities, N as CustomerRegisterInput, O as CustomerRegisterResult, V as CustomerVerifyRegistrationInput, L as CustomerPasswordLoginInput, T as CustomerSetPasswordInput, P as CustomerResetPasswordInput, E as Customer, U as CustomerUpdateInput, R as CustomerSessionInfo, bl as ReauthInput, bm as ReauthResult, J as CustomerEmailCodeInput, H as CustomerEmailChangeInput, I as CustomerEmailChangeRequested, G as CustomerEmailChangeConfirmInput, W as DataExportFile, A as AccountDeleteInput, aF as Order, ai as InvoiceConnection, bC as ShipmentConnection, bx as ReturnRequestInput, bw as ReturnRequest, ap as InvoiceResult, b7 as PendingPayment, al as InvoiceFileKind, ak as InvoiceFile, a5 as FiscalProfile, a6 as FiscalProfileInput, bT as Subject, bY as SubjectInput, b_ as SubjectPatch, a as Address, bZ as SubjectKind, c0 as Theme, aR as Page, ay as Menu, e as Article, aA as Money, g as AvailabilityStatus, r as CartLineProblem, f as Availability, ag as InsufficientStockLine, o as CartLine, bg as ProductVariant, X as DeclineCode, b6 as PaymentVoucher, b1 as PaymentNextStep, t as CartPromotions, bi as PromotionReward, aj as InvoiceDoc, bB as Shipment, aD as NextAction, aJ as OrderProgress, bH as ShipmentStatus, bD as ShipmentEvent, bV as SubjectCatalogNode, bW as SubjectField, Z as DeliveryMethod, c2 as UnavailableRateProvider, aS as PageInfo } from './account-settings-C0r3jJ72.cjs';
+export { c as AddressSuggestion, h as CartBuyer, j as CartCost, k as CartDelivery, l as CartDiscountCode, m as CartDiscountLine, n as CartInvoice, q as CartLineMerchandise, u as CartRecommendation, w as CheckoutInfo, y as CheckoutPayment, M as CustomerPreferences, $ as Facet, a0 as FacetValue, a1 as FiscalDocumentEvidence, a2 as FiscalDocumentSource, a3 as FiscalIdentity, a4 as FiscalIdentityInput, a7 as FiscalVerification, a8 as GeoHint, a9 as IdentityCapture, aa as IdentityDocumentSpec, ab as IdentityFieldRule, ac as IdentityRulesV1, ad as IdentityStrategy, ae as Image, af as InsufficientStockDetails, ah as InvoiceAction, am as InvoiceListNode, an as InvoiceReceiver, aq as InvoiceStage, ar as InvoiceSummary, as as InvoicingCapabilities, au as LocationContacts, av as LocationKind, ax as LocationPickup, az as MenuItem, aB as MoneyRange, aE as NextActionKind, aG as OrderLine, aH as OrderPickup, aI as OrderProblem, aK as OrderProgressStep, aL as OrderRef, aM as OrderSection, aN as OrderShippingService, aO as OrderStage, aP as OrderStepKey, aQ as OrderStepState, aT as PaymentAction, aV as PaymentAttemptStatus, aW as PaymentClient, aX as PaymentClientCsp, aZ as PaymentFlow, a_ as PaymentInfo, a$ as PaymentMethod, b2 as PaymentOption, b3 as PaymentOptionKey, b4 as PaymentPoint, b8 as PendingPaymentVoucher, b9 as PickupOption, bb as ProductAttributeValue, bc as ProductCategory, be as ProductOption, bh as PromotionAnnouncement, bj as PromotionTier, bo as Refund, bq as RegionFiscalEntry, br as RegionFiscalId, bs as RegionPaymentMethod, by as SEO, bz as Section, bA as SelectedOption, bE as ShipmentKind, bF as ShipmentListNode, bG as ShipmentMap, bI as ShipmentsSummary, bJ as ShippingRate, bL as ShopBranch, bM as ShopContact, bN as ShopPolicies, bP as StorefrontError, bQ as StorefrontErrorBody, bR as StorefrontErrorCode, bS as StorefrontErrorInit, bU as SubjectCatalog, bX as SubjectFieldType, b$ as SubjectRef, c3 as dataExportBytes, c4 as isAccountDeleteBlocked, c5 as isReauthRequired, c6 as isStorefrontError, c7 as safeExportFilename } from './account-settings-C0r3jJ72.cjs';
 import { GeoPoint } from './geo.cjs';
 export { OpenStatus, OpeningHours } from './geo.cjs';
 
@@ -11,6 +11,38 @@ type PaginationParams = {
     /** Cursor from `page_info.end_cursor`. */
     after?: string | null;
 };
+/**
+ * Cursor paging of the account lists (contract 1.19). `first` is 10 by default; a page has at most 50 (51–100 is cut to 50,
+ * more is a 400). `after` goes to the next
+ * (older) page with `page_info.end_cursor`; `before` goes back with `page_info.start_cursor`; never both.
+ */
+type AccountListParams = {
+    first?: number;
+    after?: string | null;
+    before?: string | null;
+    /** From this day (UTC, inclusive; `YYYY-MM-DD`) or an RFC 3339 instant. */
+    from?: string;
+    /** Until this day (UTC, inclusive; `YYYY-MM-DD`) or an RFC 3339 instant (exclusive). */
+    to?: string;
+    /** An exact order number (case-insensitive; a leading «#» is fine). */
+    q?: string;
+};
+/** Filters of `customer.orders.list` (derived ones are applied to bounded batches: a short page with `has_next_page` is valid). */
+type OrderListParams = AccountListParams & {
+    /** An order status (`placed`, `accepted`, `fulfilling`, `ready`, `shipped`, `delivered`, `cancelled`) or progress stage (`pending_payment`, `paid`, `preparing`, `ready_for_pickup`, `in_transit`, `out_for_delivery`, `refunded`). */
+    status?: string;
+    delivery_method?: 'shipping' | 'pickup';
+    /** With an invoice (issued or on its way) or without one. */
+    has_invoice?: boolean;
+};
+type InvoiceListParams = AccountListParams & {
+    /** `issued`, `pending`, `cancelled` or `error`. */
+    status?: string;
+};
+type ShipmentListParams = AccountListParams & {
+    /** A parcel status: `pending`, `label_created`, `in_transit`, `out_for_delivery`, `delivered`, `exception`, `returned`, `lost`, `cancelled`. */
+    status?: string;
+};
 type ProductListParams = PaginationParams & {
     /** Free-text search. */
     q?: string;
@@ -42,6 +74,8 @@ type ArticleListParams = Omit<PaginationParams, 'first'> & {
     tag?: string;
     q?: string;
 };
+/** The query of an account list: only what is set (no empty strings, no `undefined`), booleans as `true` / `false`. */
+declare function accountListQuery(params: (AccountListParams & Record<string, QueryValue | undefined>) | undefined): QueryParams | undefined;
 /** Appends params to a URLSearchParams, repeating keys for arrays and skipping nullish values. */
 declare function appendParams(search: URLSearchParams, params: QueryParams | undefined): URLSearchParams;
 /** Serializes product list params per the contract (`filter.<attr>` repeated, `handles` comma-separated). */
@@ -408,7 +442,31 @@ declare function createStorefrontClient(config: StorefrontClientOptions): {
          * repeat after success is also fine. Afterwards the token is dead: drop it.
          */
         deleteAccount: (input: AccountDeleteInput, options?: WriteOptions) => Promise<void>;
-        orders: (params?: PaginationParams, options?: RequestOptions) => Promise<Connection<Order>>;
+        /**
+         * The buyer's orders, newest first. Callable as before (`orders({ first })`) and, since contract 1.19, with
+         * `orders.list({ first, after, before, status, delivery_method, has_invoice, from, to, q })`: cursor paging
+         * (keyset, stable while new orders arrive), `page_info.start_cursor` / `has_previous_page` to go back, and
+         * `total_count` when it is cheap to know. An OPS older than 1.19 ignores the new parameters.
+         */
+        orders: ((params?: PaginationParams, options?: RequestOptions) => Promise<Connection<Order>>) & {
+            list: (params?: OrderListParams, options?: RequestOptions) => Promise<Connection<Order>>;
+        };
+        /**
+         * The buyer's invoices, one node per order that has them (`{ order, invoices }`), cursor-paged like `orders.list`.
+         * It replaces opening the detail of every order. An OPS older than 1.19 (no such route) is served from one page of
+         * orders and their details, so the account keeps working until the addon is updated.
+         */
+        invoices: {
+            list: (params?: InvoiceListParams, options?: RequestOptions) => Promise<InvoiceConnection>;
+        };
+        /**
+         * The buyer's shipments, one node per delivered order with its service and parcels (`{ order, stage, service,
+         * shipments }`), cursor-paged like `orders.list`, without tracking events or map (those come with `order(id)`).
+         * An OPS older than 1.19 is served from one page of orders and their details.
+         */
+        shipments: {
+            list: (params?: ShipmentListParams, options?: RequestOptions) => Promise<ShipmentConnection>;
+        };
         /** `null` when the order does not exist or belongs to someone else. */
         order: (id: string, options?: RequestOptions) => Promise<Order | null>;
         requestReturn: (orderId: string, input: ReturnRequestInput, options?: WriteOptions) => Promise<ReturnRequest>;
@@ -591,7 +649,7 @@ declare function isTokenPublishable(token: string | null | undefined): boolean;
 type AvailabilityTone = 'success' | 'warning' | 'danger' | 'info';
 type AvailabilityLocale = 'es' | 'en';
 /** Text keys, overridable per shop. `{n}` and `{date}` are replaced. */
-type AvailabilityMessageKey = 'status.in_stock' | 'status.low_stock' | 'status.low_stock_n' | 'status.out_of_stock' | 'status.backorder' | 'status.preorder' | 'sub.backorder_eta' | 'sub.preorder_date' | 'cta.add' | 'cta.out_of_stock' | 'cta.backorder' | 'cta.preorder' | 'sr.in_stock' | 'sr.low_stock' | 'sr.low_stock_n' | 'sr.out_of_stock' | 'sr.backorder' | 'sr.preorder' | 'option.sold_out' | 'option.backorder' | 'option.preorder' | 'max_per_order' | 'notify.title' | 'notify.email' | 'notify.phone' | 'notify.consent' | 'notify.submit' | 'notify.done' | 'notify.error' | 'problem.out_of_stock' | 'problem.insufficient_stock' | 'problem.insufficient_stock_n' | 'problem.adjust' | 'problem.remove' | 'conflict.title' | 'conflict.body' | 'conflict.dismiss';
+type AvailabilityMessageKey = 'status.in_stock' | 'status.low_stock' | 'status.low_stock_n' | 'status.out_of_stock' | 'status.backorder' | 'status.preorder' | 'sub.backorder_eta' | 'sub.preorder_date' | 'line.ships_on' | 'cta.add' | 'cta.out_of_stock' | 'cta.backorder' | 'cta.preorder' | 'sr.in_stock' | 'sr.low_stock' | 'sr.low_stock_n' | 'sr.out_of_stock' | 'sr.backorder' | 'sr.preorder' | 'option.sold_out' | 'option.backorder' | 'option.preorder' | 'max_per_order' | 'notify.title' | 'notify.email' | 'notify.phone' | 'notify.consent' | 'notify.submit' | 'notify.done' | 'notify.error' | 'problem.out_of_stock' | 'problem.insufficient_stock' | 'problem.insufficient_stock_n' | 'problem.adjust' | 'problem.remove' | 'conflict.title' | 'conflict.body' | 'conflict.dismiss';
 type AvailabilityMessages = Record<AvailabilityMessageKey, string>;
 /** `es-MX` -> `es`, `en-US` -> `en`; anything else falls back to Spanish. */
 declare function availabilityLocale(locale: string | null | undefined): AvailabilityLocale;
@@ -599,6 +657,13 @@ declare function availabilityLocale(locale: string | null | undefined): Availabi
 declare function availabilityMessages(locale: string | null | undefined, overrides?: Partial<AvailabilityMessages> | null): AvailabilityMessages;
 /** Replaces `{name}` placeholders. */
 declare function formatAvailabilityMessage(template: string, values?: Record<string, string | number>): string;
+/**
+ * Ship date of a cart line, `YYYY-MM-DD`, or `null`. Pure: it only picks what the server
+ * sent (`ships_on`, else `availability.restock_eta`, else the date part of `preorder_release_at`).
+ */
+declare function lineShipDate(line: Pick<CartLine, 'ships_on' | 'availability'>): string | null;
+/** Localized "Ships on: {date}" for a cart line, or `null` without a date. */
+declare function lineShipLabel(line: Pick<CartLine, 'ships_on' | 'availability'>, locale: string | null | undefined, overrides?: Partial<AvailabilityMessages> | null): string | null;
 type ResolveAvailabilityOptions = {
     /**
      * Polyfill only: shop-level "low stock" threshold to derive `low_stock` from
@@ -1013,4 +1078,96 @@ 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 { AccountDeleteInput, Address, AddressInput, type AddressSuggestParams, AddressSuggestions, 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, CustomerEmailChangeConfirmInput, CustomerEmailChangeInput, CustomerEmailChangeRequested, CustomerEmailCodeInput, CustomerIdentifier, CustomerPasswordLoginInput, CustomerRegisterInput, CustomerRegisterResult, CustomerResetPasswordInput, CustomerSession, CustomerSessionInfo, CustomerSessionInput, CustomerSetPasswordInput, CustomerUpdateInput, CustomerVerifyRegistrationInput, DEFAULT_FIT_TAG_PREFIX, DataExportFile, DeclineCode, type DeliveryChoice, type DeliveryChoiceKind, DeliveryInput, DeliveryMethod, type DeliveryNotices, DeliveryOptions, type DiagnoseOptions, type DiscountBarState, type DiscountBarView, type FetchLike, FiscalProfile, FiscalProfileInput, type FormatMoneyOptions, GeoPoint, InsufficientStockLine, InvoiceDoc, InvoiceFile, InvoiceFileKind, type InvoiceGroup, InvoiceRequest, InvoiceResult, Location, LocationListParams, MAX_SUBJECT_YEAR, MIN_SUBJECT_YEAR, MISSING_WEIGHT, type MarketInfo, type MarketSuggestion, Menu, Money, NOTE_MAX_LENGTH, NearestLocation, NextAction, Order, OrderProgress, PAYMENT_CHOICE_REFUSED_FIELD, PICKUP_STEPS, PRIVATE_MASK, 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, ReauthInput, ReauthResult, RecommendationPlacement, Region, RegionPostalCode, type RequestOptions, type ResolveAvailabilityOptions, type ResolvedSubject, RestockSubscriptionInput, RestockSubscriptionResult, ReturnRequest, ReturnRequestInput, SHIPPING_STEPS, SUBJECT_CATALOG_PAGE_BYTES, Shipment, ShipmentEvent, ShipmentStatus, type ShippingBarState, type ShippingBarView, Shop, StockLevel, type StorefrontClient, type StorefrontClientOptions, type StorefrontRequestContext, type StorefrontResponseContext, Subject, SubjectCatalogNode, SubjectField, SubjectInput, SubjectKind, type SubjectOption, SubjectPatch, type SubjectProblemCode, type SubjectProblems, type SubjectValues, Theme, TokenIntrospection, UnavailableRateProvider, type WriteOptions, appendParams, availabilityLocale, availabilityMessages, availabilityView, cartLineProblemView, clampPercent, classifyPaymentError, coversYear, createStorefrontClient, declineMessage, declineMessageKey, deliveryInput, deliveryNotices, diagnose, fitTag, fitTagsAny, formatAvailabilityMessage, formatMoney, formatVoucherExpiry, generateIdempotencyKey, groupInvoiceDocs, hreflangLinks, invoiceFileBytes, isMasked, isTestInvoice, isTestShipment, isTokenPublishable, maskToken, negotiateLocale, nextAction, normalizeClientIp, normalizeNote, opsSaysNotRetryable, orderProgress, orderShipments, parseDelivery, parseMoney, parseProductFilters, paymentErrorView, paymentIdempotencyKey, paymentMessages, paymentOutcome, preferredLanguages, productAvailability, productListQuery, promoProgressView, promotionMessages, reconcileSubjectValues, repairPath, resolveAvailability, resolveSubject, rewardLabel, safeHttpsUrl, safeInvoiceFilename, safeTrackingUrl, schemaAvailability, shipmentsStatus, sortTrackingEvents, splitSubjectTree, storefrontDomainHeader, subjectFields, subjectLevels, subjectOptions, suggestMarket, toMoney, visitorCountry };
+/**
+ * The URL side of the account lists (orders, invoices, shipments): what a list page reads from `?despues=…&estado=…`
+ * and the links to the previous / next page. Framework-free (React Router, Next or plain links all use it), pure and
+ * safe on untrusted input: everything read from a URL is validated, so a hand-edited or hostile query can never reach
+ * the API as anything but a well-formed filter.
+ *
+ * A list URL is the whole state of the page (cursor, filters, position), so it can be shared, bookmarked and used with
+ * the browser's back / forward buttons, and every link is a real `<a href>` that works without JavaScript.
+ */
+
+/** What a list page reads from its URL. Every field is optional; the cursors are opaque. */
+type ListQuery = {
+    /** `page_info.end_cursor` of the page before: this page continues after it. */
+    after?: string;
+    /** `page_info.start_cursor` of the page after: this page is the one before it. */
+    before?: string;
+    /** 1-based position of the first item of the page, only for the «showing 11–20» text (a cursor has no page number). */
+    pos?: number;
+    status?: string;
+    delivery?: 'shipping' | 'pickup';
+    invoice?: boolean;
+    /** `YYYY-MM-DD` */
+    from?: string;
+    /** `YYYY-MM-DD` */
+    to?: string;
+    q?: string;
+};
+/** The names a URL uses for each field, and the words for the values that are not free text. */
+type ListUrlNames = {
+    after: string;
+    before: string;
+    pos: string;
+    status: string;
+    delivery: string;
+    invoice: string;
+    from: string;
+    to: string;
+    q: string;
+    /** The URL word of each delivery method. */
+    deliveryValues: {
+        shipping: string;
+        pickup: string;
+    };
+    /** The URL words of `invoice` (with / without an invoice). */
+    invoiceValues: {
+        yes: string;
+        no: string;
+    };
+};
+/** Spanish URLs (`?despues=…&estado=en_camino&desde=2026-01-01`), the default of a Spanish store. */
+declare const LIST_URL_ES: ListUrlNames;
+/** English URLs, the same as the API's own parameter names. */
+declare const LIST_URL_EN: ListUrlNames;
+/**
+ * Reads and validates a list URL. Unknown or malformed values are dropped (never an error): a stale or hand-edited link
+ * simply shows the unfiltered list. `after` wins over `before` when both are present.
+ */
+declare function readListQuery(search: URLSearchParams | string | undefined | null, names?: ListUrlNames): ListQuery;
+/** Are there filters on (cursor and position are not filters)? */
+declare function isFiltered(query: ListQuery): boolean;
+/** The same query without cursor and position: the first page of the same filters. */
+declare function firstPageQuery(query: ListQuery): ListQuery;
+/** The API parameters of a list page. */
+declare function listApiParams(query: ListQuery, first: number): OrderListParams;
+/** `?despues=…&estado=…` (with the leading `?`), or `''` for the first page without filters. Keys in a stable order. */
+declare function listQueryString(query: ListQuery, names?: ListUrlNames): string;
+/** `path` + the query string. */
+declare const listHref: (path: string, query: ListQuery, names?: ListUrlNames) => string;
+/** What the page the buyer is on knows about itself, to build the links around it. */
+type ListPageState = {
+    query: ListQuery;
+    pageInfo: PageInfo | null | undefined;
+    /** Nodes on this page. */
+    count: number;
+    /** Page size asked for. */
+    first: number;
+};
+/** 1-based position of the first node of this page: known when it is the first page, else what the URL carried. */
+declare function pagePosition({ query, pageInfo, count }: Pick<ListPageState, 'query' | 'pageInfo' | 'count'>): number | undefined;
+/** The query of the next (older) page, or `null` at the end. */
+declare function nextPageQuery(state: ListPageState): ListQuery | null;
+/** The query of the previous (newer) page, or `null` on the first. */
+declare function previousPageQuery(state: ListPageState): ListQuery | null;
+/** «from»–«to» of «total» for the «showing 11–20 of 300» text; `null` when the page is empty or the position is unknown. */
+declare function pageRange(state: Pick<ListPageState, 'query' | 'pageInfo' | 'count'> & {
+    total?: number | null;
+}): {
+    from: number;
+    to: number;
+    total: number | null;
+} | null;
+
+export { AccountDeleteInput, type AccountListParams, Address, AddressInput, type AddressSuggestParams, AddressSuggestions, Article, type ArticleListParams, Availability, type AvailabilityLocale, type AvailabilityMessageKey, type AvailabilityMessages, AvailabilityStatus, type AvailabilityTone, type AvailabilityView, type AvailabilityViewOptions, CLIENT_IP_HEADER, COUNTRY_HEADERS, Cart, CartBuyerInput, CartLine, CartLineInput, CartLineProblem, type CartLineProblemView, CartLineUpdateInput, CartPromotions, CartRecommendations, CheckoutInput, CheckoutResult, Collection, type CollectionListParams, Connection, Customer, CustomerCapabilities, CustomerEmailChangeConfirmInput, CustomerEmailChangeInput, CustomerEmailChangeRequested, CustomerEmailCodeInput, CustomerIdentifier, CustomerPasswordLoginInput, CustomerRegisterInput, CustomerRegisterResult, CustomerResetPasswordInput, CustomerSession, CustomerSessionInfo, CustomerSessionInput, CustomerSetPasswordInput, CustomerUpdateInput, CustomerVerifyRegistrationInput, DEFAULT_FIT_TAG_PREFIX, DataExportFile, DeclineCode, type DeliveryChoice, type DeliveryChoiceKind, DeliveryInput, DeliveryMethod, type DeliveryNotices, DeliveryOptions, type DiagnoseOptions, type DiscountBarState, type DiscountBarView, type FetchLike, FiscalProfile, FiscalProfileInput, type FormatMoneyOptions, GeoPoint, InsufficientStockLine, InvoiceConnection, InvoiceDoc, InvoiceFile, InvoiceFileKind, type InvoiceGroup, type InvoiceListParams, InvoiceRequest, InvoiceResult, LIST_URL_EN, LIST_URL_ES, type ListPageState, type ListQuery, type ListUrlNames, Location, LocationListParams, MAX_SUBJECT_YEAR, MIN_SUBJECT_YEAR, MISSING_WEIGHT, type MarketInfo, type MarketSuggestion, Menu, Money, NOTE_MAX_LENGTH, NearestLocation, NextAction, Order, type OrderListParams, OrderProgress, PAYMENT_CHOICE_REFUSED_FIELD, PICKUP_STEPS, PRIVATE_MASK, Page, PageInfo, 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, ReauthInput, ReauthResult, RecommendationPlacement, Region, RegionPostalCode, type RequestOptions, type ResolveAvailabilityOptions, type ResolvedSubject, RestockSubscriptionInput, RestockSubscriptionResult, ReturnRequest, ReturnRequestInput, SHIPPING_STEPS, SUBJECT_CATALOG_PAGE_BYTES, Shipment, ShipmentConnection, ShipmentEvent, type ShipmentListParams, ShipmentStatus, type ShippingBarState, type ShippingBarView, Shop, StockLevel, type StorefrontClient, type StorefrontClientOptions, type StorefrontRequestContext, type StorefrontResponseContext, Subject, SubjectCatalogNode, SubjectField, SubjectInput, SubjectKind, type SubjectOption, SubjectPatch, type SubjectProblemCode, type SubjectProblems, type SubjectValues, Theme, TokenIntrospection, UnavailableRateProvider, type WriteOptions, accountListQuery, appendParams, availabilityLocale, availabilityMessages, availabilityView, cartLineProblemView, clampPercent, classifyPaymentError, coversYear, createStorefrontClient, declineMessage, declineMessageKey, deliveryInput, deliveryNotices, diagnose, firstPageQuery, fitTag, fitTagsAny, formatAvailabilityMessage, formatMoney, formatVoucherExpiry, generateIdempotencyKey, groupInvoiceDocs, hreflangLinks, invoiceFileBytes, isFiltered, isMasked, isTestInvoice, isTestShipment, isTokenPublishable, lineShipDate, lineShipLabel, listApiParams, listHref, listQueryString, maskToken, negotiateLocale, nextAction, nextPageQuery, normalizeClientIp, normalizeNote, opsSaysNotRetryable, orderProgress, orderShipments, pagePosition, pageRange, parseDelivery, parseMoney, parseProductFilters, paymentErrorView, paymentIdempotencyKey, paymentMessages, paymentOutcome, preferredLanguages, previousPageQuery, productAvailability, productListQuery, promoProgressView, promotionMessages, readListQuery, reconcileSubjectValues, repairPath, resolveAvailability, resolveSubject, rewardLabel, safeHttpsUrl, safeInvoiceFilename, safeTrackingUrl, schemaAvailability, shipmentsStatus, sortTrackingEvents, splitSubjectTree, storefrontDomainHeader, subjectFields, subjectLevels, subjectOptions, suggestMarket, toMoney, visitorCountry };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { bc as ProductSort, bY as TokenIntrospection, bF as Shop, bm as Region, bq as RegionPostalCode, d as AddressSuggestions, ba as ProductConnection, b7 as Product, D as Connection, B as Collection, au as LocationListParams, ar as Location, aA as NearestLocation, bJ as StockLevel, br as RestockSubscriptionInput, bs as RestockSubscriptionResult, p as CartLineInput, C as Cart, s as CartLineUpdateInput, i as CartBuyerInput, b as AddressInput, _ as DeliveryOptions, aZ as PaymentMethods, Y as DeliveryInput, am as InvoiceRequest, bk as RecommendationPlacement, v as CartRecommendations, x as CheckoutInput, z as CheckoutResult, bh as PromotionsList, aV as PaymentConfig, b2 as PaymentSubmitInput, aR as PaymentAttemptResult, K as CustomerIdentifier, S as CustomerSessionInput, Q as CustomerSession, F as CustomerCapabilities, N as CustomerRegisterInput, O as CustomerRegisterResult, V as CustomerVerifyRegistrationInput, L as CustomerPasswordLoginInput, T as CustomerSetPasswordInput, P as CustomerResetPasswordInput, E as Customer, U as CustomerUpdateInput, R as CustomerSessionInfo, bi as ReauthInput, bj as ReauthResult, J as CustomerEmailCodeInput, H as CustomerEmailChangeInput, I as CustomerEmailChangeRequested, G as CustomerEmailChangeConfirmInput, W as DataExportFile, A as AccountDeleteInput, aD as Order, bu as ReturnRequestInput, bt as ReturnRequest, an as InvoiceResult, b4 as PendingPayment, ak as InvoiceFileKind, aj as InvoiceFile, a5 as FiscalProfile, a6 as FiscalProfileInput, bO as Subject, bT as SubjectInput, bV as SubjectPatch, a as Address, bU as SubjectKind, bX as Theme, aO as Page, aw as Menu, e as Article, ay as Money, g as AvailabilityStatus, r as CartLineProblem, f as Availability, ag as InsufficientStockLine, bd as ProductVariant, X as DeclineCode, b3 as PaymentVoucher, a_ as PaymentNextStep, t as CartPromotions, bf as PromotionReward, ai as InvoiceDoc, by as Shipment, aB as NextAction, aH as OrderProgress, bC as ShipmentStatus, bz as ShipmentEvent, bQ as SubjectCatalogNode, bR as SubjectField, Z as DeliveryMethod, bZ as UnavailableRateProvider } from './account-settings-CrQV1rPU.js';
-export { c as AddressSuggestion, h as CartBuyer, j as CartCost, k as CartDelivery, l as CartDiscountCode, m as CartDiscountLine, n as CartInvoice, o as CartLine, q as CartLineMerchandise, u as CartRecommendation, w as CheckoutInfo, y as CheckoutPayment, M as CustomerPreferences, $ as Facet, a0 as FacetValue, a1 as FiscalDocumentEvidence, a2 as FiscalDocumentSource, a3 as FiscalIdentity, a4 as FiscalIdentityInput, a7 as FiscalVerification, a8 as GeoHint, a9 as IdentityCapture, aa as IdentityDocumentSpec, ab as IdentityFieldRule, ac as IdentityRulesV1, ad as IdentityStrategy, ae as Image, af as InsufficientStockDetails, ah as InvoiceAction, al as InvoiceReceiver, ao as InvoiceStage, ap as InvoiceSummary, aq as InvoicingCapabilities, as as LocationContacts, at as LocationKind, av as LocationPickup, ax as MenuItem, az as MoneyRange, aC as NextActionKind, aE as OrderLine, aF as OrderPickup, aG as OrderProblem, aI as OrderProgressStep, aJ as OrderSection, aK as OrderShippingService, aL as OrderStage, aM as OrderStepKey, aN as OrderStepState, aP as PageInfo, aQ as PaymentAction, aS as PaymentAttemptStatus, aT as PaymentClient, aU as PaymentClientCsp, aW as PaymentFlow, aX as PaymentInfo, aY as PaymentMethod, a$ as PaymentOption, b0 as PaymentOptionKey, b1 as PaymentPoint, b5 as PendingPaymentVoucher, b6 as PickupOption, b8 as ProductAttributeValue, b9 as ProductCategory, bb as ProductOption, be as PromotionAnnouncement, bg as PromotionTier, bl as Refund, bn as RegionFiscalEntry, bo as RegionFiscalId, bp as RegionPaymentMethod, bv as SEO, bw as Section, bx as SelectedOption, bA as ShipmentKind, bB as ShipmentMap, bD as ShipmentsSummary, bE as ShippingRate, bG as ShopBranch, bH as ShopContact, bI as ShopPolicies, bK as StorefrontError, bL as StorefrontErrorBody, bM as StorefrontErrorCode, bN as StorefrontErrorInit, bP as SubjectCatalog, bS as SubjectFieldType, bW as SubjectRef, b_ as dataExportBytes, b$ as isAccountDeleteBlocked, c0 as isReauthRequired, c1 as isStorefrontError, c2 as safeExportFilename } from './account-settings-CrQV1rPU.js';
+import { bf as ProductSort, c1 as TokenIntrospection, bK as Shop, bp as Region, bt as RegionPostalCode, d as AddressSuggestions, bd as ProductConnection, ba as Product, D as Connection, B as Collection, aw as LocationListParams, at as Location, aC as NearestLocation, bO as StockLevel, bu as RestockSubscriptionInput, bv as RestockSubscriptionResult, p as CartLineInput, C as Cart, s as CartLineUpdateInput, i as CartBuyerInput, b as AddressInput, _ as DeliveryOptions, b0 as PaymentMethods, Y as DeliveryInput, ao as InvoiceRequest, bn as RecommendationPlacement, v as CartRecommendations, x as CheckoutInput, z as CheckoutResult, bk as PromotionsList, aY as PaymentConfig, b5 as PaymentSubmitInput, aU as PaymentAttemptResult, K as CustomerIdentifier, S as CustomerSessionInput, Q as CustomerSession, F as CustomerCapabilities, N as CustomerRegisterInput, O as CustomerRegisterResult, V as CustomerVerifyRegistrationInput, L as CustomerPasswordLoginInput, T as CustomerSetPasswordInput, P as CustomerResetPasswordInput, E as Customer, U as CustomerUpdateInput, R as CustomerSessionInfo, bl as ReauthInput, bm as ReauthResult, J as CustomerEmailCodeInput, H as CustomerEmailChangeInput, I as CustomerEmailChangeRequested, G as CustomerEmailChangeConfirmInput, W as DataExportFile, A as AccountDeleteInput, aF as Order, ai as InvoiceConnection, bC as ShipmentConnection, bx as ReturnRequestInput, bw as ReturnRequest, ap as InvoiceResult, b7 as PendingPayment, al as InvoiceFileKind, ak as InvoiceFile, a5 as FiscalProfile, a6 as FiscalProfileInput, bT as Subject, bY as SubjectInput, b_ as SubjectPatch, a as Address, bZ as SubjectKind, c0 as Theme, aR as Page, ay as Menu, e as Article, aA as Money, g as AvailabilityStatus, r as CartLineProblem, f as Availability, ag as InsufficientStockLine, o as CartLine, bg as ProductVariant, X as DeclineCode, b6 as PaymentVoucher, b1 as PaymentNextStep, t as CartPromotions, bi as PromotionReward, aj as InvoiceDoc, bB as Shipment, aD as NextAction, aJ as OrderProgress, bH as ShipmentStatus, bD as ShipmentEvent, bV as SubjectCatalogNode, bW as SubjectField, Z as DeliveryMethod, c2 as UnavailableRateProvider, aS as PageInfo } from './account-settings-BnhDUPWx.js';
+export { c as AddressSuggestion, h as CartBuyer, j as CartCost, k as CartDelivery, l as CartDiscountCode, m as CartDiscountLine, n as CartInvoice, q as CartLineMerchandise, u as CartRecommendation, w as CheckoutInfo, y as CheckoutPayment, M as CustomerPreferences, $ as Facet, a0 as FacetValue, a1 as FiscalDocumentEvidence, a2 as FiscalDocumentSource, a3 as FiscalIdentity, a4 as FiscalIdentityInput, a7 as FiscalVerification, a8 as GeoHint, a9 as IdentityCapture, aa as IdentityDocumentSpec, ab as IdentityFieldRule, ac as IdentityRulesV1, ad as IdentityStrategy, ae as Image, af as InsufficientStockDetails, ah as InvoiceAction, am as InvoiceListNode, an as InvoiceReceiver, aq as InvoiceStage, ar as InvoiceSummary, as as InvoicingCapabilities, au as LocationContacts, av as LocationKind, ax as LocationPickup, az as MenuItem, aB as MoneyRange, aE as NextActionKind, aG as OrderLine, aH as OrderPickup, aI as OrderProblem, aK as OrderProgressStep, aL as OrderRef, aM as OrderSection, aN as OrderShippingService, aO as OrderStage, aP as OrderStepKey, aQ as OrderStepState, aT as PaymentAction, aV as PaymentAttemptStatus, aW as PaymentClient, aX as PaymentClientCsp, aZ as PaymentFlow, a_ as PaymentInfo, a$ as PaymentMethod, b2 as PaymentOption, b3 as PaymentOptionKey, b4 as PaymentPoint, b8 as PendingPaymentVoucher, b9 as PickupOption, bb as ProductAttributeValue, bc as ProductCategory, be as ProductOption, bh as PromotionAnnouncement, bj as PromotionTier, bo as Refund, bq as RegionFiscalEntry, br as RegionFiscalId, bs as RegionPaymentMethod, by as SEO, bz as Section, bA as SelectedOption, bE as ShipmentKind, bF as ShipmentListNode, bG as ShipmentMap, bI as ShipmentsSummary, bJ as ShippingRate, bL as ShopBranch, bM as ShopContact, bN as ShopPolicies, bP as StorefrontError, bQ as StorefrontErrorBody, bR as StorefrontErrorCode, bS as StorefrontErrorInit, bU as SubjectCatalog, bX as SubjectFieldType, b$ as SubjectRef, c3 as dataExportBytes, c4 as isAccountDeleteBlocked, c5 as isReauthRequired, c6 as isStorefrontError, c7 as safeExportFilename } from './account-settings-BnhDUPWx.js';
 import { GeoPoint } from './geo.js';
 export { OpenStatus, OpeningHours } from './geo.js';
 
@@ -11,6 +11,38 @@ type PaginationParams = {
     /** Cursor from `page_info.end_cursor`. */
     after?: string | null;
 };
+/**
+ * Cursor paging of the account lists (contract 1.19). `first` is 10 by default; a page has at most 50 (51–100 is cut to 50,
+ * more is a 400). `after` goes to the next
+ * (older) page with `page_info.end_cursor`; `before` goes back with `page_info.start_cursor`; never both.
+ */
+type AccountListParams = {
+    first?: number;
+    after?: string | null;
+    before?: string | null;
+    /** From this day (UTC, inclusive; `YYYY-MM-DD`) or an RFC 3339 instant. */
+    from?: string;
+    /** Until this day (UTC, inclusive; `YYYY-MM-DD`) or an RFC 3339 instant (exclusive). */
+    to?: string;
+    /** An exact order number (case-insensitive; a leading «#» is fine). */
+    q?: string;
+};
+/** Filters of `customer.orders.list` (derived ones are applied to bounded batches: a short page with `has_next_page` is valid). */
+type OrderListParams = AccountListParams & {
+    /** An order status (`placed`, `accepted`, `fulfilling`, `ready`, `shipped`, `delivered`, `cancelled`) or progress stage (`pending_payment`, `paid`, `preparing`, `ready_for_pickup`, `in_transit`, `out_for_delivery`, `refunded`). */
+    status?: string;
+    delivery_method?: 'shipping' | 'pickup';
+    /** With an invoice (issued or on its way) or without one. */
+    has_invoice?: boolean;
+};
+type InvoiceListParams = AccountListParams & {
+    /** `issued`, `pending`, `cancelled` or `error`. */
+    status?: string;
+};
+type ShipmentListParams = AccountListParams & {
+    /** A parcel status: `pending`, `label_created`, `in_transit`, `out_for_delivery`, `delivered`, `exception`, `returned`, `lost`, `cancelled`. */
+    status?: string;
+};
 type ProductListParams = PaginationParams & {
     /** Free-text search. */
     q?: string;
@@ -42,6 +74,8 @@ type ArticleListParams = Omit<PaginationParams, 'first'> & {
     tag?: string;
     q?: string;
 };
+/** The query of an account list: only what is set (no empty strings, no `undefined`), booleans as `true` / `false`. */
+declare function accountListQuery(params: (AccountListParams & Record<string, QueryValue | undefined>) | undefined): QueryParams | undefined;
 /** Appends params to a URLSearchParams, repeating keys for arrays and skipping nullish values. */
 declare function appendParams(search: URLSearchParams, params: QueryParams | undefined): URLSearchParams;
 /** Serializes product list params per the contract (`filter.<attr>` repeated, `handles` comma-separated). */
@@ -408,7 +442,31 @@ declare function createStorefrontClient(config: StorefrontClientOptions): {
          * repeat after success is also fine. Afterwards the token is dead: drop it.
          */
         deleteAccount: (input: AccountDeleteInput, options?: WriteOptions) => Promise<void>;
-        orders: (params?: PaginationParams, options?: RequestOptions) => Promise<Connection<Order>>;
+        /**
+         * The buyer's orders, newest first. Callable as before (`orders({ first })`) and, since contract 1.19, with
+         * `orders.list({ first, after, before, status, delivery_method, has_invoice, from, to, q })`: cursor paging
+         * (keyset, stable while new orders arrive), `page_info.start_cursor` / `has_previous_page` to go back, and
+         * `total_count` when it is cheap to know. An OPS older than 1.19 ignores the new parameters.
+         */
+        orders: ((params?: PaginationParams, options?: RequestOptions) => Promise<Connection<Order>>) & {
+            list: (params?: OrderListParams, options?: RequestOptions) => Promise<Connection<Order>>;
+        };
+        /**
+         * The buyer's invoices, one node per order that has them (`{ order, invoices }`), cursor-paged like `orders.list`.
+         * It replaces opening the detail of every order. An OPS older than 1.19 (no such route) is served from one page of
+         * orders and their details, so the account keeps working until the addon is updated.
+         */
+        invoices: {
+            list: (params?: InvoiceListParams, options?: RequestOptions) => Promise<InvoiceConnection>;
+        };
+        /**
+         * The buyer's shipments, one node per delivered order with its service and parcels (`{ order, stage, service,
+         * shipments }`), cursor-paged like `orders.list`, without tracking events or map (those come with `order(id)`).
+         * An OPS older than 1.19 is served from one page of orders and their details.
+         */
+        shipments: {
+            list: (params?: ShipmentListParams, options?: RequestOptions) => Promise<ShipmentConnection>;
+        };
         /** `null` when the order does not exist or belongs to someone else. */
         order: (id: string, options?: RequestOptions) => Promise<Order | null>;
         requestReturn: (orderId: string, input: ReturnRequestInput, options?: WriteOptions) => Promise<ReturnRequest>;
@@ -591,7 +649,7 @@ declare function isTokenPublishable(token: string | null | undefined): boolean;
 type AvailabilityTone = 'success' | 'warning' | 'danger' | 'info';
 type AvailabilityLocale = 'es' | 'en';
 /** Text keys, overridable per shop. `{n}` and `{date}` are replaced. */
-type AvailabilityMessageKey = 'status.in_stock' | 'status.low_stock' | 'status.low_stock_n' | 'status.out_of_stock' | 'status.backorder' | 'status.preorder' | 'sub.backorder_eta' | 'sub.preorder_date' | 'cta.add' | 'cta.out_of_stock' | 'cta.backorder' | 'cta.preorder' | 'sr.in_stock' | 'sr.low_stock' | 'sr.low_stock_n' | 'sr.out_of_stock' | 'sr.backorder' | 'sr.preorder' | 'option.sold_out' | 'option.backorder' | 'option.preorder' | 'max_per_order' | 'notify.title' | 'notify.email' | 'notify.phone' | 'notify.consent' | 'notify.submit' | 'notify.done' | 'notify.error' | 'problem.out_of_stock' | 'problem.insufficient_stock' | 'problem.insufficient_stock_n' | 'problem.adjust' | 'problem.remove' | 'conflict.title' | 'conflict.body' | 'conflict.dismiss';
+type AvailabilityMessageKey = 'status.in_stock' | 'status.low_stock' | 'status.low_stock_n' | 'status.out_of_stock' | 'status.backorder' | 'status.preorder' | 'sub.backorder_eta' | 'sub.preorder_date' | 'line.ships_on' | 'cta.add' | 'cta.out_of_stock' | 'cta.backorder' | 'cta.preorder' | 'sr.in_stock' | 'sr.low_stock' | 'sr.low_stock_n' | 'sr.out_of_stock' | 'sr.backorder' | 'sr.preorder' | 'option.sold_out' | 'option.backorder' | 'option.preorder' | 'max_per_order' | 'notify.title' | 'notify.email' | 'notify.phone' | 'notify.consent' | 'notify.submit' | 'notify.done' | 'notify.error' | 'problem.out_of_stock' | 'problem.insufficient_stock' | 'problem.insufficient_stock_n' | 'problem.adjust' | 'problem.remove' | 'conflict.title' | 'conflict.body' | 'conflict.dismiss';
 type AvailabilityMessages = Record<AvailabilityMessageKey, string>;
 /** `es-MX` -> `es`, `en-US` -> `en`; anything else falls back to Spanish. */
 declare function availabilityLocale(locale: string | null | undefined): AvailabilityLocale;
@@ -599,6 +657,13 @@ declare function availabilityLocale(locale: string | null | undefined): Availabi
 declare function availabilityMessages(locale: string | null | undefined, overrides?: Partial<AvailabilityMessages> | null): AvailabilityMessages;
 /** Replaces `{name}` placeholders. */
 declare function formatAvailabilityMessage(template: string, values?: Record<string, string | number>): string;
+/**
+ * Ship date of a cart line, `YYYY-MM-DD`, or `null`. Pure: it only picks what the server
+ * sent (`ships_on`, else `availability.restock_eta`, else the date part of `preorder_release_at`).
+ */
+declare function lineShipDate(line: Pick<CartLine, 'ships_on' | 'availability'>): string | null;
+/** Localized "Ships on: {date}" for a cart line, or `null` without a date. */
+declare function lineShipLabel(line: Pick<CartLine, 'ships_on' | 'availability'>, locale: string | null | undefined, overrides?: Partial<AvailabilityMessages> | null): string | null;
 type ResolveAvailabilityOptions = {
     /**
      * Polyfill only: shop-level "low stock" threshold to derive `low_stock` from
@@ -1013,4 +1078,96 @@ 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 { AccountDeleteInput, Address, AddressInput, type AddressSuggestParams, AddressSuggestions, 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, CustomerEmailChangeConfirmInput, CustomerEmailChangeInput, CustomerEmailChangeRequested, CustomerEmailCodeInput, CustomerIdentifier, CustomerPasswordLoginInput, CustomerRegisterInput, CustomerRegisterResult, CustomerResetPasswordInput, CustomerSession, CustomerSessionInfo, CustomerSessionInput, CustomerSetPasswordInput, CustomerUpdateInput, CustomerVerifyRegistrationInput, DEFAULT_FIT_TAG_PREFIX, DataExportFile, DeclineCode, type DeliveryChoice, type DeliveryChoiceKind, DeliveryInput, DeliveryMethod, type DeliveryNotices, DeliveryOptions, type DiagnoseOptions, type DiscountBarState, type DiscountBarView, type FetchLike, FiscalProfile, FiscalProfileInput, type FormatMoneyOptions, GeoPoint, InsufficientStockLine, InvoiceDoc, InvoiceFile, InvoiceFileKind, type InvoiceGroup, InvoiceRequest, InvoiceResult, Location, LocationListParams, MAX_SUBJECT_YEAR, MIN_SUBJECT_YEAR, MISSING_WEIGHT, type MarketInfo, type MarketSuggestion, Menu, Money, NOTE_MAX_LENGTH, NearestLocation, NextAction, Order, OrderProgress, PAYMENT_CHOICE_REFUSED_FIELD, PICKUP_STEPS, PRIVATE_MASK, 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, ReauthInput, ReauthResult, RecommendationPlacement, Region, RegionPostalCode, type RequestOptions, type ResolveAvailabilityOptions, type ResolvedSubject, RestockSubscriptionInput, RestockSubscriptionResult, ReturnRequest, ReturnRequestInput, SHIPPING_STEPS, SUBJECT_CATALOG_PAGE_BYTES, Shipment, ShipmentEvent, ShipmentStatus, type ShippingBarState, type ShippingBarView, Shop, StockLevel, type StorefrontClient, type StorefrontClientOptions, type StorefrontRequestContext, type StorefrontResponseContext, Subject, SubjectCatalogNode, SubjectField, SubjectInput, SubjectKind, type SubjectOption, SubjectPatch, type SubjectProblemCode, type SubjectProblems, type SubjectValues, Theme, TokenIntrospection, UnavailableRateProvider, type WriteOptions, appendParams, availabilityLocale, availabilityMessages, availabilityView, cartLineProblemView, clampPercent, classifyPaymentError, coversYear, createStorefrontClient, declineMessage, declineMessageKey, deliveryInput, deliveryNotices, diagnose, fitTag, fitTagsAny, formatAvailabilityMessage, formatMoney, formatVoucherExpiry, generateIdempotencyKey, groupInvoiceDocs, hreflangLinks, invoiceFileBytes, isMasked, isTestInvoice, isTestShipment, isTokenPublishable, maskToken, negotiateLocale, nextAction, normalizeClientIp, normalizeNote, opsSaysNotRetryable, orderProgress, orderShipments, parseDelivery, parseMoney, parseProductFilters, paymentErrorView, paymentIdempotencyKey, paymentMessages, paymentOutcome, preferredLanguages, productAvailability, productListQuery, promoProgressView, promotionMessages, reconcileSubjectValues, repairPath, resolveAvailability, resolveSubject, rewardLabel, safeHttpsUrl, safeInvoiceFilename, safeTrackingUrl, schemaAvailability, shipmentsStatus, sortTrackingEvents, splitSubjectTree, storefrontDomainHeader, subjectFields, subjectLevels, subjectOptions, suggestMarket, toMoney, visitorCountry };
+/**
+ * The URL side of the account lists (orders, invoices, shipments): what a list page reads from `?despues=…&estado=…`
+ * and the links to the previous / next page. Framework-free (React Router, Next or plain links all use it), pure and
+ * safe on untrusted input: everything read from a URL is validated, so a hand-edited or hostile query can never reach
+ * the API as anything but a well-formed filter.
+ *
+ * A list URL is the whole state of the page (cursor, filters, position), so it can be shared, bookmarked and used with
+ * the browser's back / forward buttons, and every link is a real `<a href>` that works without JavaScript.
+ */
+
+/** What a list page reads from its URL. Every field is optional; the cursors are opaque. */
+type ListQuery = {
+    /** `page_info.end_cursor` of the page before: this page continues after it. */
+    after?: string;
+    /** `page_info.start_cursor` of the page after: this page is the one before it. */
+    before?: string;
+    /** 1-based position of the first item of the page, only for the «showing 11–20» text (a cursor has no page number). */
+    pos?: number;
+    status?: string;
+    delivery?: 'shipping' | 'pickup';
+    invoice?: boolean;
+    /** `YYYY-MM-DD` */
+    from?: string;
+    /** `YYYY-MM-DD` */
+    to?: string;
+    q?: string;
+};
+/** The names a URL uses for each field, and the words for the values that are not free text. */
+type ListUrlNames = {
+    after: string;
+    before: string;
+    pos: string;
+    status: string;
+    delivery: string;
+    invoice: string;
+    from: string;
+    to: string;
+    q: string;
+    /** The URL word of each delivery method. */
+    deliveryValues: {
+        shipping: string;
+        pickup: string;
+    };
+    /** The URL words of `invoice` (with / without an invoice). */
+    invoiceValues: {
+        yes: string;
+        no: string;
+    };
+};
+/** Spanish URLs (`?despues=…&estado=en_camino&desde=2026-01-01`), the default of a Spanish store. */
+declare const LIST_URL_ES: ListUrlNames;
+/** English URLs, the same as the API's own parameter names. */
+declare const LIST_URL_EN: ListUrlNames;
+/**
+ * Reads and validates a list URL. Unknown or malformed values are dropped (never an error): a stale or hand-edited link
+ * simply shows the unfiltered list. `after` wins over `before` when both are present.
+ */
+declare function readListQuery(search: URLSearchParams | string | undefined | null, names?: ListUrlNames): ListQuery;
+/** Are there filters on (cursor and position are not filters)? */
+declare function isFiltered(query: ListQuery): boolean;
+/** The same query without cursor and position: the first page of the same filters. */
+declare function firstPageQuery(query: ListQuery): ListQuery;
+/** The API parameters of a list page. */
+declare function listApiParams(query: ListQuery, first: number): OrderListParams;
+/** `?despues=…&estado=…` (with the leading `?`), or `''` for the first page without filters. Keys in a stable order. */
+declare function listQueryString(query: ListQuery, names?: ListUrlNames): string;
+/** `path` + the query string. */
+declare const listHref: (path: string, query: ListQuery, names?: ListUrlNames) => string;
+/** What the page the buyer is on knows about itself, to build the links around it. */
+type ListPageState = {
+    query: ListQuery;
+    pageInfo: PageInfo | null | undefined;
+    /** Nodes on this page. */
+    count: number;
+    /** Page size asked for. */
+    first: number;
+};
+/** 1-based position of the first node of this page: known when it is the first page, else what the URL carried. */
+declare function pagePosition({ query, pageInfo, count }: Pick<ListPageState, 'query' | 'pageInfo' | 'count'>): number | undefined;
+/** The query of the next (older) page, or `null` at the end. */
+declare function nextPageQuery(state: ListPageState): ListQuery | null;
+/** The query of the previous (newer) page, or `null` on the first. */
+declare function previousPageQuery(state: ListPageState): ListQuery | null;
+/** «from»–«to» of «total» for the «showing 11–20 of 300» text; `null` when the page is empty or the position is unknown. */
+declare function pageRange(state: Pick<ListPageState, 'query' | 'pageInfo' | 'count'> & {
+    total?: number | null;
+}): {
+    from: number;
+    to: number;
+    total: number | null;
+} | null;
+
+export { AccountDeleteInput, type AccountListParams, Address, AddressInput, type AddressSuggestParams, AddressSuggestions, Article, type ArticleListParams, Availability, type AvailabilityLocale, type AvailabilityMessageKey, type AvailabilityMessages, AvailabilityStatus, type AvailabilityTone, type AvailabilityView, type AvailabilityViewOptions, CLIENT_IP_HEADER, COUNTRY_HEADERS, Cart, CartBuyerInput, CartLine, CartLineInput, CartLineProblem, type CartLineProblemView, CartLineUpdateInput, CartPromotions, CartRecommendations, CheckoutInput, CheckoutResult, Collection, type CollectionListParams, Connection, Customer, CustomerCapabilities, CustomerEmailChangeConfirmInput, CustomerEmailChangeInput, CustomerEmailChangeRequested, CustomerEmailCodeInput, CustomerIdentifier, CustomerPasswordLoginInput, CustomerRegisterInput, CustomerRegisterResult, CustomerResetPasswordInput, CustomerSession, CustomerSessionInfo, CustomerSessionInput, CustomerSetPasswordInput, CustomerUpdateInput, CustomerVerifyRegistrationInput, DEFAULT_FIT_TAG_PREFIX, DataExportFile, DeclineCode, type DeliveryChoice, type DeliveryChoiceKind, DeliveryInput, DeliveryMethod, type DeliveryNotices, DeliveryOptions, type DiagnoseOptions, type DiscountBarState, type DiscountBarView, type FetchLike, FiscalProfile, FiscalProfileInput, type FormatMoneyOptions, GeoPoint, InsufficientStockLine, InvoiceConnection, InvoiceDoc, InvoiceFile, InvoiceFileKind, type InvoiceGroup, type InvoiceListParams, InvoiceRequest, InvoiceResult, LIST_URL_EN, LIST_URL_ES, type ListPageState, type ListQuery, type ListUrlNames, Location, LocationListParams, MAX_SUBJECT_YEAR, MIN_SUBJECT_YEAR, MISSING_WEIGHT, type MarketInfo, type MarketSuggestion, Menu, Money, NOTE_MAX_LENGTH, NearestLocation, NextAction, Order, type OrderListParams, OrderProgress, PAYMENT_CHOICE_REFUSED_FIELD, PICKUP_STEPS, PRIVATE_MASK, Page, PageInfo, 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, ReauthInput, ReauthResult, RecommendationPlacement, Region, RegionPostalCode, type RequestOptions, type ResolveAvailabilityOptions, type ResolvedSubject, RestockSubscriptionInput, RestockSubscriptionResult, ReturnRequest, ReturnRequestInput, SHIPPING_STEPS, SUBJECT_CATALOG_PAGE_BYTES, Shipment, ShipmentConnection, ShipmentEvent, type ShipmentListParams, ShipmentStatus, type ShippingBarState, type ShippingBarView, Shop, StockLevel, type StorefrontClient, type StorefrontClientOptions, type StorefrontRequestContext, type StorefrontResponseContext, Subject, SubjectCatalogNode, SubjectField, SubjectInput, SubjectKind, type SubjectOption, SubjectPatch, type SubjectProblemCode, type SubjectProblems, type SubjectValues, Theme, TokenIntrospection, UnavailableRateProvider, type WriteOptions, accountListQuery, appendParams, availabilityLocale, availabilityMessages, availabilityView, cartLineProblemView, clampPercent, classifyPaymentError, coversYear, createStorefrontClient, declineMessage, declineMessageKey, deliveryInput, deliveryNotices, diagnose, firstPageQuery, fitTag, fitTagsAny, formatAvailabilityMessage, formatMoney, formatVoucherExpiry, generateIdempotencyKey, groupInvoiceDocs, hreflangLinks, invoiceFileBytes, isFiltered, isMasked, isTestInvoice, isTestShipment, isTokenPublishable, lineShipDate, lineShipLabel, listApiParams, listHref, listQueryString, maskToken, negotiateLocale, nextAction, nextPageQuery, normalizeClientIp, normalizeNote, opsSaysNotRetryable, orderProgress, orderShipments, pagePosition, pageRange, parseDelivery, parseMoney, parseProductFilters, paymentErrorView, paymentIdempotencyKey, paymentMessages, paymentOutcome, preferredLanguages, previousPageQuery, productAvailability, productListQuery, promoProgressView, promotionMessages, readListQuery, reconcileSubjectValues, repairPath, resolveAvailability, resolveSubject, rewardLabel, safeHttpsUrl, safeInvoiceFilename, safeTrackingUrl, schemaAvailability, shipmentsStatus, sortTrackingEvents, splitSubjectTree, storefrontDomainHeader, subjectFields, subjectLevels, subjectOptions, suggestMarket, toMoney, visitorCountry };