@asteby/storefront 0.16.1 → 0.18.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
+import { b4 as ProductSort, bQ as TokenIntrospection, bx as Shop, be as Region, bi as RegionPostalCode, b2 as ProductConnection, a$ as Product, z as Connection, y as Collection, an as LocationListParams, ak as Location, at as NearestLocation, bB as StockLevel, bj as RestockSubscriptionInput, bk as RestockSubscriptionResult, n as CartLineInput, C as Cart, q as CartLineUpdateInput, g as CartBuyerInput, b as AddressInput, U as DeliveryOptions, aR as PaymentMethods, S as DeliveryInput, af as InvoiceRequest, bc as RecommendationPlacement, t as CartRecommendations, v as CheckoutInput, x as CheckoutResult, b9 as PromotionsList, aN as PaymentConfig, aW as PaymentSubmitInput, aJ as PaymentAttemptResult, E as CustomerIdentifier, M as CustomerSessionInput, K as CustomerSession, D as CustomerCapabilities, H as CustomerRegisterInput, I as CustomerRegisterResult, P as CustomerVerifyRegistrationInput, F as CustomerPasswordLoginInput, N as CustomerSetPasswordInput, J as CustomerResetPasswordInput, B as Customer, O as CustomerUpdateInput, L as CustomerSessionInfo, ba as ReauthInput, bb as ReauthResult, Q as DataExportFile, A as AccountDeleteInput, aw as Order, bm as ReturnRequestInput, bl as ReturnRequest, ag as InvoiceResult, aY as PendingPayment, ae as InvoiceFileKind, ad as InvoiceFile, $ as FiscalProfile, a0 as FiscalProfileInput, bG as Subject, bL as SubjectInput, bN as SubjectPatch, a as Address, bM as SubjectKind, bP as Theme, aG as Page, ap as Menu, c as Article, ar as Money, e as AvailabilityStatus, p as CartLineProblem, d as Availability, aa as InsufficientStockLine, b5 as ProductVariant, R as DeclineCode, aX as PaymentVoucher, aS as PaymentNextStep, r as CartPromotions, b7 as PromotionReward, ac as InvoiceDoc, bq as Shipment, au as NextAction, aA as OrderProgress, bu as ShipmentStatus, br as ShipmentEvent, bI as SubjectCatalogNode, bJ as SubjectField, T as DeliveryMethod, bR as UnavailableRateProvider } from './account-settings-DAzmXHIn.cjs';
+export { f as CartBuyer, h as CartCost, i as CartDelivery, j as CartDiscountCode, k as CartDiscountLine, l as CartInvoice, m as CartLine, o as CartLineMerchandise, s as CartRecommendation, u as CheckoutInfo, w as CheckoutPayment, G as CustomerPreferences, V as Facet, W as FacetValue, X as FiscalDocumentEvidence, Y as FiscalDocumentSource, Z as FiscalIdentity, _ as FiscalIdentityInput, a1 as FiscalVerification, a2 as GeoHint, a3 as IdentityCapture, a4 as IdentityDocumentSpec, a5 as IdentityFieldRule, a6 as IdentityRulesV1, a7 as IdentityStrategy, a8 as Image, a9 as InsufficientStockDetails, ab as InvoiceAction, ah as InvoiceStage, ai as InvoiceSummary, aj as InvoicingCapabilities, al as LocationContacts, am as LocationKind, ao as LocationPickup, aq as MenuItem, as as MoneyRange, av as NextActionKind, ax as OrderLine, ay as OrderPickup, az as OrderProblem, aB as OrderProgressStep, aC as OrderSection, aD as OrderStage, aE as OrderStepKey, aF as OrderStepState, aH as PageInfo, aI as PaymentAction, aK as PaymentAttemptStatus, aL as PaymentClient, aM as PaymentClientCsp, aO as PaymentFlow, aP as PaymentInfo, aQ as PaymentMethod, aT as PaymentOption, aU as PaymentOptionKey, aV as PaymentPoint, aZ as PendingPaymentVoucher, a_ as PickupOption, b0 as ProductAttributeValue, b1 as ProductCategory, b3 as ProductOption, b6 as PromotionAnnouncement, b8 as PromotionTier, bd as Refund, bf as RegionFiscalEntry, bg as RegionFiscalId, bh as RegionPaymentMethod, bn as SEO, bo as Section, bp as SelectedOption, bs as ShipmentKind, bt as ShipmentMap, bv as ShipmentsSummary, bw as ShippingRate, by as ShopBranch, bz as ShopContact, bA as ShopPolicies, bC as StorefrontError, bD as StorefrontErrorBody, bE as StorefrontErrorCode, bF as StorefrontErrorInit, bH as SubjectCatalog, bK as SubjectFieldType, bO as SubjectRef, bS as dataExportBytes, bT as isAccountDeleteBlocked, bU as isReauthRequired, bV as isStorefrontError, bW as safeExportFilename } from './account-settings-DAzmXHIn.cjs';
 import { GeoPoint } from './geo.cjs';
 export { OpenStatus, OpeningHours } from './geo.cjs';
-import { b0 as ProductSort, bz as TokenIntrospection, br as Shop, b8 as Region, bc as RegionPostalCode, a_ as ProductConnection, aX as Product, y as Connection, x as Collection, aj as LocationListParams, ag as Location, ap as NearestLocation, bv as StockLevel, bd as RestockSubscriptionInput, be as RestockSubscriptionResult, m as CartLineInput, C as Cart, p as CartLineUpdateInput, f as CartBuyerInput, a as AddressInput, Q as DeliveryOptions, aN as PaymentMethods, O as DeliveryInput, ab as InvoiceRequest, b6 as RecommendationPlacement, s as CartRecommendations, u as CheckoutInput, w as CheckoutResult, b5 as PromotionsList, aJ as PaymentConfig, aS as PaymentSubmitInput, aF 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, as as Order, bg as ReturnRequestInput, bf as ReturnRequest, ac as InvoiceResult, aU as PendingPayment, aa as InvoiceFileKind, a9 as InvoiceFile, X as FiscalProfile, Y as FiscalProfileInput, A as Address, by as Theme, aC as Page, al as Menu, b as Article, bx as StorefrontErrorCode, a6 as InsufficientStockLine, an as Money, d as AvailabilityStatus, o as CartLineProblem, c as Availability, b1 as ProductVariant, N as DeclineCode, aT as PaymentVoucher, aO as PaymentNextStep, q as CartPromotions, b3 as PromotionReward, a8 as InvoiceDoc, bk as Shipment, aq as NextAction, aw as OrderProgress, bo as ShipmentStatus, bl as ShipmentEvent, P as DeliveryMethod, bA as UnavailableRateProvider } from './types-C5nEQicj.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, Z as FiscalVerification, _ as GeoHint, $ as IdentityCapture, a0 as IdentityDocumentSpec, a1 as IdentityFieldRule, a2 as IdentityRulesV1, a3 as IdentityStrategy, a4 as Image, a5 as InsufficientStockDetails, a7 as InvoiceAction, ad as InvoiceStage, ae as InvoiceSummary, af as InvoicingCapabilities, ah as LocationContacts, ai as LocationKind, ak as LocationPickup, am as MenuItem, ao as MoneyRange, ar as NextActionKind, at as OrderLine, au as OrderPickup, av as OrderProblem, ax as OrderProgressStep, ay as OrderSection, az as OrderStage, aA as OrderStepKey, aB as OrderStepState, aD as PageInfo, aE as PaymentAction, aG as PaymentAttemptStatus, aH as PaymentClient, aI as PaymentClientCsp, aK as PaymentFlow, aL as PaymentInfo, aM as PaymentMethod, aP as PaymentOption, aQ as PaymentOptionKey, aR as PaymentPoint, aV as PendingPaymentVoucher, aW as PickupOption, aY as ProductAttributeValue, aZ as ProductCategory, a$ as ProductOption, b2 as PromotionAnnouncement, b4 as PromotionTier, b7 as Refund, b9 as RegionFiscalEntry, ba as RegionFiscalId, bb as RegionPaymentMethod, bh as SEO, bi as Section, bj as SelectedOption, bm as ShipmentKind, bn as ShipmentMap, bp as ShipmentsSummary, bq as ShippingRate, bs as ShopBranch, bt as ShopContact, bu as ShopPolicies, bw as StorefrontErrorBody } from './types-C5nEQicj.cjs';
 
 type QueryValue = string | number | boolean | null | undefined;
 type QueryParams = Record<string, QueryValue | QueryValue[]>;
@@ -29,6 +29,11 @@ type ProductListParams = PaginationParams & {
     filters?: Record<string, QueryValue | QueryValue[]>;
     /** Restrict to these handles (max 100). Serialized comma-separated. */
     handles?: string[];
+    /**
+     * Only products carrying at least one of these tags (OR, at most 5 of 120 characters; contract 1.9). Serialized
+     * comma-separated. A parts store passes `fitTagsAny(fitKey)` (`fit:<key>`, `fit:universal`); any tag works.
+     */
+    tags_any?: string[];
 };
 type CollectionListParams = PaginationParams;
 type ArticleListParams = Omit<PaginationParams, 'first'> & {
@@ -323,6 +328,37 @@ declare function createStorefrontClient(config: StorefrontClientOptions): {
         get: (options?: RequestOptions) => Promise<Customer>;
         /** Updates the profile and the saved fiscal data; `fiscal: null` deletes the latter. `422` with `field: 'fiscal.<field>'`. */
         update: (input: CustomerUpdateInput, options?: WriteOptions) => Promise<Customer>;
+        /**
+         * Active sessions of the buyer («Devices»; contract 1.9). Private, never cached. The list carries no address
+         * and no token: only what the buyer needs to recognize their own devices.
+         */
+        sessions: {
+            list: (options?: RequestOptions) => Promise<CustomerSessionInfo[]>;
+            /** Closes one session. Repeating it is fine. `404` for a session that is not the buyer's. Closing the current one is a sign-out. */
+            revoke: (id: string, options?: WriteOptions) => Promise<void>;
+            /** Closes every session except the one making the call. */
+            revokeOthers: (options?: WriteOptions) => Promise<void>;
+        };
+        /**
+         * Confirms the buyer's identity again with their password or a sign-in code (`requestOtp` first). The
+         * confirmation lasts `valid_for_seconds` (a few minutes) and counts only for the session that made the call;
+         * exporting data and deleting the account need it (`403 reauth_required` otherwise, see `isReauthRequired`).
+         * A wrong credential is always the same `400`; too many tries is `429` (`StorefrontError.retryAfter`).
+         */
+        reauth: (input: ReauthInput, options?: WriteOptions) => Promise<ReauthResult>;
+        /**
+         * The buyer's data as a JSON file (contract 1.9, `capabilities().data_export`). Needs a recent `reauth`. It is
+         * built on request and is neither stored nor emailed: call it from YOUR server, stream the bytes
+         * (`dataExportBytes`, `safeExportFilename`) with `Cache-Control: no-store`, and keep nothing. Three a day per account.
+         */
+        exportData: (options?: WriteOptions) => Promise<DataExportFile>;
+        /**
+         * Deletes the buyer's account (contract 1.9, `capabilities().account_delete`). Needs a recent `reauth` and the
+         * text the buyer typed in `confirm`. Personal data is erased; orders and invoices are kept by the store.
+         * `409` (see `isAccountDeleteBlocked`) while an order is on its way or a payment is pending. Idempotent: a
+         * 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>>;
         /** `null` when the order does not exist or belongs to someone else. */
         order: (id: string, options?: RequestOptions) => Promise<Order | null>;
@@ -352,6 +388,21 @@ declare function createStorefrontClient(config: StorefrontClientOptions): {
             /** Physical delete (a profile leaves nothing behind). A saved default passes to another profile. */
             delete: (id: string, options?: WriteOptions) => Promise<void>;
         };
+        /**
+         * Saved items of the buyer («My items», «My garage»; contract 1.9, `capabilities().subjects`). Personal data:
+         * private, never cached, never logged. `422` with `field: 'attributes.<field>'` when the kind refuses a value
+         * (it never echoes it); `409` for an item already saved or past the limit; `429` for too many saves; `404` for
+         * an item that is not the buyer's. The server builds `label` and `fit_key`; private fields come back masked.
+         */
+        subjects: {
+            list: (params?: {
+                kind?: string;
+            }, options?: RequestOptions) => Promise<Subject[]>;
+            create: (input: SubjectInput, options?: WriteOptions) => Promise<Subject>;
+            update: (id: string, patch: SubjectPatch, options?: WriteOptions) => Promise<Subject>;
+            /** Physical delete (the item leaves nothing behind). The default of its kind passes to another item. */
+            delete: (id: string, options?: WriteOptions) => Promise<void>;
+        };
         addresses: {
             list: (options?: RequestOptions) => Promise<{
                 nodes: Address[];
@@ -362,6 +413,11 @@ declare function createStorefrontClient(config: StorefrontClientOptions): {
         };
     };
     content: {
+        /**
+         * The kinds of buyer item the organization declares («My garage») and their catalogs (contract 1.9; public,
+         * cacheable). `[]` when it declares none or the server predates the route: the store has no such section.
+         */
+        subjectKinds: (options?: RequestOptions) => Promise<SubjectKind[]>;
         theme: (options?: RequestOptions) => Promise<Theme>;
         /** `null` when the page does not exist. */
         page: (handle: string, options?: PreviewOptions) => Promise<Page | null>;
@@ -376,73 +432,6 @@ type StorefrontClient = ReturnType<typeof createStorefrontClient>;
 /** `X-Storefront-Domain` value: the host, plus `#<market>` when a valid market code is given. */
 declare function storefrontDomainHeader(domain: string, market?: string | null): string;
 
-type StorefrontErrorInit = {
-    status: number;
-    code: StorefrontErrorCode;
-    message: string;
-    field?: string;
-    /** Raw `error.details` from the body (untrusted shape). */
-    details?: unknown;
-    /** Request URL that failed (without credentials). */
-    url?: string;
-    cause?: unknown;
-    /** Scopes named by the gateway on a `403 insufficient_scope`. */
-    requiredScopes?: string[];
-    /** `error.retryable` as OPS declared it (payment failures). `undefined` = OPS did not say. */
-    retryable?: boolean;
-    /** `error.retry_after` in seconds. */
-    retryAfter?: number;
-    /** `error.checkout_id`: the checkout a refused cart write can resume. */
-    checkoutId?: string;
-    /** `error.cost` of a `price_mismatch` (the cart's current cost; untrusted shape). */
-    cost?: unknown;
-    /** `error.message_en`. */
-    messageEn?: string;
-};
-/**
- * Error thrown by the client for any non-2xx response, network failure,
- * timeout or abort. `status` is `0` when no HTTP response was received.
- */
-declare class StorefrontError extends Error {
-    readonly name = "StorefrontError";
-    readonly status: number;
-    readonly code: StorefrontErrorCode;
-    readonly field: string | undefined;
-    readonly details: unknown;
-    readonly url: string | undefined;
-    /** Scopes a `403 insufficient_scope` says the route needs (empty for any other error). */
-    readonly requiredScopes: string[];
-    /** `true`: repeating the request (same idempotency key) can succeed. `false`: not until someone fixes something. `undefined`: OPS did not say. */
-    readonly retryable: boolean | undefined;
-    /** Seconds OPS asks to wait before retrying. */
-    readonly retryAfter: number | undefined;
-    /** Checkout that a refused cart write can resume. */
-    readonly checkoutId: string | undefined;
-    /** Current cart cost sent with a `price_mismatch` (untrusted shape). */
-    readonly cost: unknown;
-    /** English version of `message`, when OPS sent one. */
-    readonly messageEn: string | undefined;
-    constructor(init: StorefrontErrorInit);
-    /**
-     * Affected lines of a `409 insufficient_stock` (empty for any other error or a
-     * server older than contract 1.1). The cart is untouched: show the lines and
-     * let the buyer adjust or remove them.
-     */
-    get stockLines(): InsufficientStockLine[];
-    toJSON(): {
-        checkoutId?: string | undefined;
-        retryAfter?: number | undefined;
-        retryable?: boolean | undefined;
-        requiredScopes?: string[] | undefined;
-        name: string;
-        status: number;
-        code: StorefrontErrorCode;
-        message: string;
-        field: string | undefined;
-    };
-}
-declare function isStorefrontError(err: unknown): err is StorefrontError;
-
 /**
  * Classification of the failures of a card payment (`POST pay` / `GET status`). No texts, no DOM, no server APIs: the
  * shop's server uses it to answer with `kind` and `retryable`, and the browser transport uses it to decide whether to
@@ -868,6 +857,82 @@ declare function invoiceFileBytes(file: Pick<InvoiceFile, 'content_base64'>): Ui
 /** 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;
 
+declare const MIN_SUBJECT_YEAR = 1900;
+declare const MAX_SUBJECT_YEAR = 2100;
+type SubjectOption = {
+    value: string;
+    label: string;
+};
+type SubjectValues = Record<string, string | number | null | undefined>;
+/** Why a value was refused (the server answers `422` with the field `attributes.<key>` and never the value). */
+type SubjectProblemCode = 'required' | 'unknown' | 'invalid' | 'not_in_catalog' | 'year_range' | 'catalog_unavailable';
+type SubjectProblems = Record<string, SubjectProblemCode>;
+type ResolvedSubject = {
+    /** Built from the labels of the catalog and the public values, in field order. */
+    label: string;
+    /** `''` when a placeholder of the template has no value (the item then never matches a product). */
+    fit_key: string;
+    /** Public values, as the server stores them in `attributes`. */
+    attributes: Record<string, string | number>;
+    /** Private values: never in the label, the key or a tag. */
+    private: Record<string, string>;
+};
+/** Does the option cover the model year? Declared `ranges` win; else `from`/`to`; an option with none covers any year. */
+declare function coversYear(node: Pick<SubjectCatalogNode, 'from' | 'to' | 'ranges'>, year: number): boolean;
+/** The catalog fields that make the tree's levels, in order: `source: catalog` and not a year. */
+declare function subjectLevels(kind: Pick<SubjectKind, 'fields'>): SubjectField[];
+/** The visible fields of a form: everything the buyer fills in, in the order of the kind. */
+declare function subjectFields(kind: Pick<SubjectKind, 'fields'>): SubjectField[];
+/**
+ * The options a catalog field offers given what is already chosen (a cascade: a level shows nothing until the previous
+ * one is chosen). A level narrows by the chosen year when the option declares years; a year field offers the model
+ * years the chosen options cover (newest first), or nothing when no option declares years (a free number then).
+ */
+declare function subjectOptions(kind: SubjectKind, fieldKey: string, values: SubjectValues): SubjectOption[];
+/**
+ * Drops what was chosen and is no longer valid after a change (a new make clears the model; a year the model does not
+ * cover is cleared), in field order. Free values are never touched.
+ */
+declare function reconcileSubjectValues(kind: SubjectKind, values: SubjectValues): SubjectValues;
+/**
+ * Validates and resolves the values the way the server does: unknown field, wrong type, a value missing from the
+ * catalog and a year outside the chosen options' years are refused, naming the field only.
+ */
+declare function resolveSubject(kind: SubjectKind, values: SubjectValues): {
+    ok: true;
+    subject: ResolvedSubject;
+} | {
+    ok: false;
+    problems: SubjectProblems;
+};
+/** The mask the server puts in place of a private value («••34»). */
+declare const PRIVATE_MASK = "\u2022\u2022";
+declare const isMasked: (v: unknown) => boolean;
+/** Prefix of the tag that publishes compatibility (`<prefix><fit_key>`), as in `FitmentConfig.tagPrefix`. */
+declare const DEFAULT_FIT_TAG_PREFIX = "fit:";
+/** The product tag that marks a part as fitting the item with this key. */
+declare const fitTag: (fitKey: string, prefix?: string) => string;
+/**
+ * The `tags_any` of a listing "only what fits my item": its own tag plus the universal one (`<prefix>universal`).
+ * `[]` when the item has no key (it does not resolve completely): ask for nothing rather than for the wrong thing.
+ */
+declare function fitTagsAny(fitKey: string | null | undefined, opts?: {
+    prefix?: string;
+    universal?: boolean;
+}): string[];
+/**
+ * Budget of one catalog page, in bytes of the `tree` prop as OPS stores it (text, so every quote is escaped). Publishing
+ * a page is ONE write of at most 64 KiB that carries the draft and the published copy: ~28 KB of tree per page.
+ */
+declare const SUBJECT_CATALOG_PAGE_BYTES: number;
+/**
+ * Splits a catalog tree by its first level into parts that each fit one page (`subject_catalog` section, prop `tree`).
+ * Publish part `i` on its own page and name them all in the kind's `catalog_ref` (`["page:x-1", "page:x-2", …]`); the
+ * server joins them back. A real parts catalog (make → model → engine) does not fit in one page. Throws `RangeError`
+ * when a single first-level option is larger than the budget on its own (split that level by hand, or trim labels).
+ */
+declare function splitSubjectTree(tree: Record<string, SubjectCatalogNode>, maxBytes?: number): Record<string, SubjectCatalogNode>[];
+
 /** 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 = {
@@ -899,4 +964,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, FiscalProfile, FiscalProfileInput, 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, RegionPostalCode, 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 };
+export { AccountDeleteInput, 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, 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 };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
+import { b4 as ProductSort, bQ as TokenIntrospection, bx as Shop, be as Region, bi as RegionPostalCode, b2 as ProductConnection, a$ as Product, z as Connection, y as Collection, an as LocationListParams, ak as Location, at as NearestLocation, bB as StockLevel, bj as RestockSubscriptionInput, bk as RestockSubscriptionResult, n as CartLineInput, C as Cart, q as CartLineUpdateInput, g as CartBuyerInput, b as AddressInput, U as DeliveryOptions, aR as PaymentMethods, S as DeliveryInput, af as InvoiceRequest, bc as RecommendationPlacement, t as CartRecommendations, v as CheckoutInput, x as CheckoutResult, b9 as PromotionsList, aN as PaymentConfig, aW as PaymentSubmitInput, aJ as PaymentAttemptResult, E as CustomerIdentifier, M as CustomerSessionInput, K as CustomerSession, D as CustomerCapabilities, H as CustomerRegisterInput, I as CustomerRegisterResult, P as CustomerVerifyRegistrationInput, F as CustomerPasswordLoginInput, N as CustomerSetPasswordInput, J as CustomerResetPasswordInput, B as Customer, O as CustomerUpdateInput, L as CustomerSessionInfo, ba as ReauthInput, bb as ReauthResult, Q as DataExportFile, A as AccountDeleteInput, aw as Order, bm as ReturnRequestInput, bl as ReturnRequest, ag as InvoiceResult, aY as PendingPayment, ae as InvoiceFileKind, ad as InvoiceFile, $ as FiscalProfile, a0 as FiscalProfileInput, bG as Subject, bL as SubjectInput, bN as SubjectPatch, a as Address, bM as SubjectKind, bP as Theme, aG as Page, ap as Menu, c as Article, ar as Money, e as AvailabilityStatus, p as CartLineProblem, d as Availability, aa as InsufficientStockLine, b5 as ProductVariant, R as DeclineCode, aX as PaymentVoucher, aS as PaymentNextStep, r as CartPromotions, b7 as PromotionReward, ac as InvoiceDoc, bq as Shipment, au as NextAction, aA as OrderProgress, bu as ShipmentStatus, br as ShipmentEvent, bI as SubjectCatalogNode, bJ as SubjectField, T as DeliveryMethod, bR as UnavailableRateProvider } from './account-settings-Cw3PamUA.js';
+export { f as CartBuyer, h as CartCost, i as CartDelivery, j as CartDiscountCode, k as CartDiscountLine, l as CartInvoice, m as CartLine, o as CartLineMerchandise, s as CartRecommendation, u as CheckoutInfo, w as CheckoutPayment, G as CustomerPreferences, V as Facet, W as FacetValue, X as FiscalDocumentEvidence, Y as FiscalDocumentSource, Z as FiscalIdentity, _ as FiscalIdentityInput, a1 as FiscalVerification, a2 as GeoHint, a3 as IdentityCapture, a4 as IdentityDocumentSpec, a5 as IdentityFieldRule, a6 as IdentityRulesV1, a7 as IdentityStrategy, a8 as Image, a9 as InsufficientStockDetails, ab as InvoiceAction, ah as InvoiceStage, ai as InvoiceSummary, aj as InvoicingCapabilities, al as LocationContacts, am as LocationKind, ao as LocationPickup, aq as MenuItem, as as MoneyRange, av as NextActionKind, ax as OrderLine, ay as OrderPickup, az as OrderProblem, aB as OrderProgressStep, aC as OrderSection, aD as OrderStage, aE as OrderStepKey, aF as OrderStepState, aH as PageInfo, aI as PaymentAction, aK as PaymentAttemptStatus, aL as PaymentClient, aM as PaymentClientCsp, aO as PaymentFlow, aP as PaymentInfo, aQ as PaymentMethod, aT as PaymentOption, aU as PaymentOptionKey, aV as PaymentPoint, aZ as PendingPaymentVoucher, a_ as PickupOption, b0 as ProductAttributeValue, b1 as ProductCategory, b3 as ProductOption, b6 as PromotionAnnouncement, b8 as PromotionTier, bd as Refund, bf as RegionFiscalEntry, bg as RegionFiscalId, bh as RegionPaymentMethod, bn as SEO, bo as Section, bp as SelectedOption, bs as ShipmentKind, bt as ShipmentMap, bv as ShipmentsSummary, bw as ShippingRate, by as ShopBranch, bz as ShopContact, bA as ShopPolicies, bC as StorefrontError, bD as StorefrontErrorBody, bE as StorefrontErrorCode, bF as StorefrontErrorInit, bH as SubjectCatalog, bK as SubjectFieldType, bO as SubjectRef, bS as dataExportBytes, bT as isAccountDeleteBlocked, bU as isReauthRequired, bV as isStorefrontError, bW as safeExportFilename } from './account-settings-Cw3PamUA.js';
 import { GeoPoint } from './geo.js';
 export { OpenStatus, OpeningHours } from './geo.js';
-import { b0 as ProductSort, bz as TokenIntrospection, br as Shop, b8 as Region, bc as RegionPostalCode, a_ as ProductConnection, aX as Product, y as Connection, x as Collection, aj as LocationListParams, ag as Location, ap as NearestLocation, bv as StockLevel, bd as RestockSubscriptionInput, be as RestockSubscriptionResult, m as CartLineInput, C as Cart, p as CartLineUpdateInput, f as CartBuyerInput, a as AddressInput, Q as DeliveryOptions, aN as PaymentMethods, O as DeliveryInput, ab as InvoiceRequest, b6 as RecommendationPlacement, s as CartRecommendations, u as CheckoutInput, w as CheckoutResult, b5 as PromotionsList, aJ as PaymentConfig, aS as PaymentSubmitInput, aF 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, as as Order, bg as ReturnRequestInput, bf as ReturnRequest, ac as InvoiceResult, aU as PendingPayment, aa as InvoiceFileKind, a9 as InvoiceFile, X as FiscalProfile, Y as FiscalProfileInput, A as Address, by as Theme, aC as Page, al as Menu, b as Article, bx as StorefrontErrorCode, a6 as InsufficientStockLine, an as Money, d as AvailabilityStatus, o as CartLineProblem, c as Availability, b1 as ProductVariant, N as DeclineCode, aT as PaymentVoucher, aO as PaymentNextStep, q as CartPromotions, b3 as PromotionReward, a8 as InvoiceDoc, bk as Shipment, aq as NextAction, aw as OrderProgress, bo as ShipmentStatus, bl as ShipmentEvent, P as DeliveryMethod, bA as UnavailableRateProvider } from './types-DSHzYSHU.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, Z as FiscalVerification, _ as GeoHint, $ as IdentityCapture, a0 as IdentityDocumentSpec, a1 as IdentityFieldRule, a2 as IdentityRulesV1, a3 as IdentityStrategy, a4 as Image, a5 as InsufficientStockDetails, a7 as InvoiceAction, ad as InvoiceStage, ae as InvoiceSummary, af as InvoicingCapabilities, ah as LocationContacts, ai as LocationKind, ak as LocationPickup, am as MenuItem, ao as MoneyRange, ar as NextActionKind, at as OrderLine, au as OrderPickup, av as OrderProblem, ax as OrderProgressStep, ay as OrderSection, az as OrderStage, aA as OrderStepKey, aB as OrderStepState, aD as PageInfo, aE as PaymentAction, aG as PaymentAttemptStatus, aH as PaymentClient, aI as PaymentClientCsp, aK as PaymentFlow, aL as PaymentInfo, aM as PaymentMethod, aP as PaymentOption, aQ as PaymentOptionKey, aR as PaymentPoint, aV as PendingPaymentVoucher, aW as PickupOption, aY as ProductAttributeValue, aZ as ProductCategory, a$ as ProductOption, b2 as PromotionAnnouncement, b4 as PromotionTier, b7 as Refund, b9 as RegionFiscalEntry, ba as RegionFiscalId, bb as RegionPaymentMethod, bh as SEO, bi as Section, bj as SelectedOption, bm as ShipmentKind, bn as ShipmentMap, bp as ShipmentsSummary, bq as ShippingRate, bs as ShopBranch, bt as ShopContact, bu as ShopPolicies, bw as StorefrontErrorBody } from './types-DSHzYSHU.js';
 
 type QueryValue = string | number | boolean | null | undefined;
 type QueryParams = Record<string, QueryValue | QueryValue[]>;
@@ -29,6 +29,11 @@ type ProductListParams = PaginationParams & {
     filters?: Record<string, QueryValue | QueryValue[]>;
     /** Restrict to these handles (max 100). Serialized comma-separated. */
     handles?: string[];
+    /**
+     * Only products carrying at least one of these tags (OR, at most 5 of 120 characters; contract 1.9). Serialized
+     * comma-separated. A parts store passes `fitTagsAny(fitKey)` (`fit:<key>`, `fit:universal`); any tag works.
+     */
+    tags_any?: string[];
 };
 type CollectionListParams = PaginationParams;
 type ArticleListParams = Omit<PaginationParams, 'first'> & {
@@ -323,6 +328,37 @@ declare function createStorefrontClient(config: StorefrontClientOptions): {
         get: (options?: RequestOptions) => Promise<Customer>;
         /** Updates the profile and the saved fiscal data; `fiscal: null` deletes the latter. `422` with `field: 'fiscal.<field>'`. */
         update: (input: CustomerUpdateInput, options?: WriteOptions) => Promise<Customer>;
+        /**
+         * Active sessions of the buyer («Devices»; contract 1.9). Private, never cached. The list carries no address
+         * and no token: only what the buyer needs to recognize their own devices.
+         */
+        sessions: {
+            list: (options?: RequestOptions) => Promise<CustomerSessionInfo[]>;
+            /** Closes one session. Repeating it is fine. `404` for a session that is not the buyer's. Closing the current one is a sign-out. */
+            revoke: (id: string, options?: WriteOptions) => Promise<void>;
+            /** Closes every session except the one making the call. */
+            revokeOthers: (options?: WriteOptions) => Promise<void>;
+        };
+        /**
+         * Confirms the buyer's identity again with their password or a sign-in code (`requestOtp` first). The
+         * confirmation lasts `valid_for_seconds` (a few minutes) and counts only for the session that made the call;
+         * exporting data and deleting the account need it (`403 reauth_required` otherwise, see `isReauthRequired`).
+         * A wrong credential is always the same `400`; too many tries is `429` (`StorefrontError.retryAfter`).
+         */
+        reauth: (input: ReauthInput, options?: WriteOptions) => Promise<ReauthResult>;
+        /**
+         * The buyer's data as a JSON file (contract 1.9, `capabilities().data_export`). Needs a recent `reauth`. It is
+         * built on request and is neither stored nor emailed: call it from YOUR server, stream the bytes
+         * (`dataExportBytes`, `safeExportFilename`) with `Cache-Control: no-store`, and keep nothing. Three a day per account.
+         */
+        exportData: (options?: WriteOptions) => Promise<DataExportFile>;
+        /**
+         * Deletes the buyer's account (contract 1.9, `capabilities().account_delete`). Needs a recent `reauth` and the
+         * text the buyer typed in `confirm`. Personal data is erased; orders and invoices are kept by the store.
+         * `409` (see `isAccountDeleteBlocked`) while an order is on its way or a payment is pending. Idempotent: a
+         * 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>>;
         /** `null` when the order does not exist or belongs to someone else. */
         order: (id: string, options?: RequestOptions) => Promise<Order | null>;
@@ -352,6 +388,21 @@ declare function createStorefrontClient(config: StorefrontClientOptions): {
             /** Physical delete (a profile leaves nothing behind). A saved default passes to another profile. */
             delete: (id: string, options?: WriteOptions) => Promise<void>;
         };
+        /**
+         * Saved items of the buyer («My items», «My garage»; contract 1.9, `capabilities().subjects`). Personal data:
+         * private, never cached, never logged. `422` with `field: 'attributes.<field>'` when the kind refuses a value
+         * (it never echoes it); `409` for an item already saved or past the limit; `429` for too many saves; `404` for
+         * an item that is not the buyer's. The server builds `label` and `fit_key`; private fields come back masked.
+         */
+        subjects: {
+            list: (params?: {
+                kind?: string;
+            }, options?: RequestOptions) => Promise<Subject[]>;
+            create: (input: SubjectInput, options?: WriteOptions) => Promise<Subject>;
+            update: (id: string, patch: SubjectPatch, options?: WriteOptions) => Promise<Subject>;
+            /** Physical delete (the item leaves nothing behind). The default of its kind passes to another item. */
+            delete: (id: string, options?: WriteOptions) => Promise<void>;
+        };
         addresses: {
             list: (options?: RequestOptions) => Promise<{
                 nodes: Address[];
@@ -362,6 +413,11 @@ declare function createStorefrontClient(config: StorefrontClientOptions): {
         };
     };
     content: {
+        /**
+         * The kinds of buyer item the organization declares («My garage») and their catalogs (contract 1.9; public,
+         * cacheable). `[]` when it declares none or the server predates the route: the store has no such section.
+         */
+        subjectKinds: (options?: RequestOptions) => Promise<SubjectKind[]>;
         theme: (options?: RequestOptions) => Promise<Theme>;
         /** `null` when the page does not exist. */
         page: (handle: string, options?: PreviewOptions) => Promise<Page | null>;
@@ -376,73 +432,6 @@ type StorefrontClient = ReturnType<typeof createStorefrontClient>;
 /** `X-Storefront-Domain` value: the host, plus `#<market>` when a valid market code is given. */
 declare function storefrontDomainHeader(domain: string, market?: string | null): string;
 
-type StorefrontErrorInit = {
-    status: number;
-    code: StorefrontErrorCode;
-    message: string;
-    field?: string;
-    /** Raw `error.details` from the body (untrusted shape). */
-    details?: unknown;
-    /** Request URL that failed (without credentials). */
-    url?: string;
-    cause?: unknown;
-    /** Scopes named by the gateway on a `403 insufficient_scope`. */
-    requiredScopes?: string[];
-    /** `error.retryable` as OPS declared it (payment failures). `undefined` = OPS did not say. */
-    retryable?: boolean;
-    /** `error.retry_after` in seconds. */
-    retryAfter?: number;
-    /** `error.checkout_id`: the checkout a refused cart write can resume. */
-    checkoutId?: string;
-    /** `error.cost` of a `price_mismatch` (the cart's current cost; untrusted shape). */
-    cost?: unknown;
-    /** `error.message_en`. */
-    messageEn?: string;
-};
-/**
- * Error thrown by the client for any non-2xx response, network failure,
- * timeout or abort. `status` is `0` when no HTTP response was received.
- */
-declare class StorefrontError extends Error {
-    readonly name = "StorefrontError";
-    readonly status: number;
-    readonly code: StorefrontErrorCode;
-    readonly field: string | undefined;
-    readonly details: unknown;
-    readonly url: string | undefined;
-    /** Scopes a `403 insufficient_scope` says the route needs (empty for any other error). */
-    readonly requiredScopes: string[];
-    /** `true`: repeating the request (same idempotency key) can succeed. `false`: not until someone fixes something. `undefined`: OPS did not say. */
-    readonly retryable: boolean | undefined;
-    /** Seconds OPS asks to wait before retrying. */
-    readonly retryAfter: number | undefined;
-    /** Checkout that a refused cart write can resume. */
-    readonly checkoutId: string | undefined;
-    /** Current cart cost sent with a `price_mismatch` (untrusted shape). */
-    readonly cost: unknown;
-    /** English version of `message`, when OPS sent one. */
-    readonly messageEn: string | undefined;
-    constructor(init: StorefrontErrorInit);
-    /**
-     * Affected lines of a `409 insufficient_stock` (empty for any other error or a
-     * server older than contract 1.1). The cart is untouched: show the lines and
-     * let the buyer adjust or remove them.
-     */
-    get stockLines(): InsufficientStockLine[];
-    toJSON(): {
-        checkoutId?: string | undefined;
-        retryAfter?: number | undefined;
-        retryable?: boolean | undefined;
-        requiredScopes?: string[] | undefined;
-        name: string;
-        status: number;
-        code: StorefrontErrorCode;
-        message: string;
-        field: string | undefined;
-    };
-}
-declare function isStorefrontError(err: unknown): err is StorefrontError;
-
 /**
  * Classification of the failures of a card payment (`POST pay` / `GET status`). No texts, no DOM, no server APIs: the
  * shop's server uses it to answer with `kind` and `retryable`, and the browser transport uses it to decide whether to
@@ -868,6 +857,82 @@ declare function invoiceFileBytes(file: Pick<InvoiceFile, 'content_base64'>): Ui
 /** 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;
 
+declare const MIN_SUBJECT_YEAR = 1900;
+declare const MAX_SUBJECT_YEAR = 2100;
+type SubjectOption = {
+    value: string;
+    label: string;
+};
+type SubjectValues = Record<string, string | number | null | undefined>;
+/** Why a value was refused (the server answers `422` with the field `attributes.<key>` and never the value). */
+type SubjectProblemCode = 'required' | 'unknown' | 'invalid' | 'not_in_catalog' | 'year_range' | 'catalog_unavailable';
+type SubjectProblems = Record<string, SubjectProblemCode>;
+type ResolvedSubject = {
+    /** Built from the labels of the catalog and the public values, in field order. */
+    label: string;
+    /** `''` when a placeholder of the template has no value (the item then never matches a product). */
+    fit_key: string;
+    /** Public values, as the server stores them in `attributes`. */
+    attributes: Record<string, string | number>;
+    /** Private values: never in the label, the key or a tag. */
+    private: Record<string, string>;
+};
+/** Does the option cover the model year? Declared `ranges` win; else `from`/`to`; an option with none covers any year. */
+declare function coversYear(node: Pick<SubjectCatalogNode, 'from' | 'to' | 'ranges'>, year: number): boolean;
+/** The catalog fields that make the tree's levels, in order: `source: catalog` and not a year. */
+declare function subjectLevels(kind: Pick<SubjectKind, 'fields'>): SubjectField[];
+/** The visible fields of a form: everything the buyer fills in, in the order of the kind. */
+declare function subjectFields(kind: Pick<SubjectKind, 'fields'>): SubjectField[];
+/**
+ * The options a catalog field offers given what is already chosen (a cascade: a level shows nothing until the previous
+ * one is chosen). A level narrows by the chosen year when the option declares years; a year field offers the model
+ * years the chosen options cover (newest first), or nothing when no option declares years (a free number then).
+ */
+declare function subjectOptions(kind: SubjectKind, fieldKey: string, values: SubjectValues): SubjectOption[];
+/**
+ * Drops what was chosen and is no longer valid after a change (a new make clears the model; a year the model does not
+ * cover is cleared), in field order. Free values are never touched.
+ */
+declare function reconcileSubjectValues(kind: SubjectKind, values: SubjectValues): SubjectValues;
+/**
+ * Validates and resolves the values the way the server does: unknown field, wrong type, a value missing from the
+ * catalog and a year outside the chosen options' years are refused, naming the field only.
+ */
+declare function resolveSubject(kind: SubjectKind, values: SubjectValues): {
+    ok: true;
+    subject: ResolvedSubject;
+} | {
+    ok: false;
+    problems: SubjectProblems;
+};
+/** The mask the server puts in place of a private value («••34»). */
+declare const PRIVATE_MASK = "\u2022\u2022";
+declare const isMasked: (v: unknown) => boolean;
+/** Prefix of the tag that publishes compatibility (`<prefix><fit_key>`), as in `FitmentConfig.tagPrefix`. */
+declare const DEFAULT_FIT_TAG_PREFIX = "fit:";
+/** The product tag that marks a part as fitting the item with this key. */
+declare const fitTag: (fitKey: string, prefix?: string) => string;
+/**
+ * The `tags_any` of a listing "only what fits my item": its own tag plus the universal one (`<prefix>universal`).
+ * `[]` when the item has no key (it does not resolve completely): ask for nothing rather than for the wrong thing.
+ */
+declare function fitTagsAny(fitKey: string | null | undefined, opts?: {
+    prefix?: string;
+    universal?: boolean;
+}): string[];
+/**
+ * Budget of one catalog page, in bytes of the `tree` prop as OPS stores it (text, so every quote is escaped). Publishing
+ * a page is ONE write of at most 64 KiB that carries the draft and the published copy: ~28 KB of tree per page.
+ */
+declare const SUBJECT_CATALOG_PAGE_BYTES: number;
+/**
+ * Splits a catalog tree by its first level into parts that each fit one page (`subject_catalog` section, prop `tree`).
+ * Publish part `i` on its own page and name them all in the kind's `catalog_ref` (`["page:x-1", "page:x-2", …]`); the
+ * server joins them back. A real parts catalog (make → model → engine) does not fit in one page. Throws `RangeError`
+ * when a single first-level option is larger than the budget on its own (split that level by hand, or trim labels).
+ */
+declare function splitSubjectTree(tree: Record<string, SubjectCatalogNode>, maxBytes?: number): Record<string, SubjectCatalogNode>[];
+
 /** 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 = {
@@ -899,4 +964,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, FiscalProfile, FiscalProfileInput, 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, RegionPostalCode, 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 };
+export { AccountDeleteInput, 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, 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 };