@asteby/storefront 0.17.0 → 0.18.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { b4 as ProductSort, bH 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, a as Address, bG 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, T as DeliveryMethod, bI as UnavailableRateProvider } from './account-settings-H6zuI7iG.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, bJ as dataExportBytes, bK as isAccountDeleteBlocked, bL as isReauthRequired, bM as isStorefrontError, bN as safeExportFilename } from './account-settings-H6zuI7iG.cjs';
+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';
 
@@ -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'> & {
@@ -383,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[];
@@ -393,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>;
@@ -832,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 = {
@@ -863,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 { 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, 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, 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, ReauthInput, ReauthResult, 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, 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, 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,5 +1,5 @@
-import { b4 as ProductSort, bH 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, a as Address, bG 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, T as DeliveryMethod, bI as UnavailableRateProvider } from './account-settings-DNcJKOQl.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, bJ as dataExportBytes, bK as isAccountDeleteBlocked, bL as isReauthRequired, bM as isStorefrontError, bN as safeExportFilename } from './account-settings-DNcJKOQl.js';
+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';
 
@@ -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'> & {
@@ -383,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[];
@@ -393,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>;
@@ -832,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 = {
@@ -863,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 { 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, 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, 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, ReauthInput, ReauthResult, 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, 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, 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.js

@@ -1,5 +1,5 @@
-import { isStorefrontError, availabilityLocale, StorefrontError, formatAvailabilityMessage, defaultCodeForStatus } from './chunk-IPUAZ3LQ.js';
-export { PICKUP_STEPS, SHIPPING_STEPS, StorefrontError, availabilityLocale, availabilityMessages, availabilityView, cartLineProblemView, declineMessage, declineMessageKey, formatAvailabilityMessage, formatVoucherExpiry, isStorefrontError, isTestInvoice, isTestShipment, nextAction, orderProgress, orderShipments, paymentErrorView, paymentIdempotencyKey, paymentMessages, paymentOutcome, productAvailability, resolveAvailability, safeHttpsUrl, safeTrackingUrl, schemaAvailability, shipmentsStatus, sortTrackingEvents } from './chunk-IPUAZ3LQ.js';
+import { isStorefrontError, availabilityLocale, StorefrontError, formatAvailabilityMessage, defaultCodeForStatus } from './chunk-5BJRZIS3.js';
+export { DEFAULT_FIT_TAG_PREFIX, MAX_SUBJECT_YEAR, MIN_SUBJECT_YEAR, PICKUP_STEPS, PRIVATE_MASK, SHIPPING_STEPS, SUBJECT_CATALOG_PAGE_BYTES, StorefrontError, availabilityLocale, availabilityMessages, availabilityView, cartLineProblemView, coversYear, declineMessage, declineMessageKey, fitTag, fitTagsAny, formatAvailabilityMessage, formatVoucherExpiry, isMasked, isStorefrontError, isTestInvoice, isTestShipment, nextAction, orderProgress, orderShipments, paymentErrorView, paymentIdempotencyKey, paymentMessages, paymentOutcome, productAvailability, reconcileSubjectValues, resolveAvailability, resolveSubject, safeHttpsUrl, safeTrackingUrl, schemaAvailability, shipmentsStatus, sortTrackingEvents, splitSubjectTree, subjectFields, subjectLevels, subjectOptions } from './chunk-5BJRZIS3.js';
 import { isValidPoint } from './chunk-45R47HYO.js';
 
 // src/money.ts
@@ -48,9 +48,14 @@ function appendParams(search, params) {
   return search;
 }
 function productListQuery(params = {}) {
-  const { filters, handles, ...rest } = params;
+  const { filters, handles, tags_any, ...rest } = params;
   const search = appendParams(new URLSearchParams(), rest);
   if (handles && handles.length > 0) search.set("handles", handles.join(","));
+  if (tags_any && tags_any.length > 0) {
+    if (tags_any.length > 5) throw new RangeError("tags_any takes at most 5 tags");
+    if (tags_any.some((t) => t.includes(",") || t.length > 120)) throw new TypeError("tags_any: a tag has at most 120 characters and no comma");
+    search.set("tags_any", tags_any.join(","));
+  }
   if (filters) {
     for (const [key, raw] of Object.entries(filters)) {
       const name = key.startsWith("filter.") ? key : `filter.${key}`;
@@ -497,6 +502,19 @@ function createStorefrontClient(config) {
         /** Physical delete (a profile leaves nothing behind). A saved default passes to another profile. */
         delete: (id, options) => write("DELETE", `/storefront/customer/fiscal-profiles/${enc(id)}`, void 0, options)
       },
+      /**
+       * 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: async (params, options) => (await get("/storefront/customer/subjects", params, { ...options, cache: "no-store" })).nodes,
+        create: (input, options) => write("POST", "/storefront/customer/subjects", input, options),
+        update: (id, patch, options) => write("PATCH", `/storefront/customer/subjects/${enc(id)}`, patch, options),
+        /** Physical delete (the item leaves nothing behind). The default of its kind passes to another item. */
+        delete: (id, options) => write("DELETE", `/storefront/customer/subjects/${enc(id)}`, void 0, options)
+      },
       addresses: {
         list: (options) => get("/storefront/customer/addresses", void 0, options),
         create: (address, options) => write("POST", "/storefront/customer/addresses", address, options),
@@ -505,6 +523,11 @@ function createStorefrontClient(config) {
       }
     },
     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: async (options) => (await getOrNull("/storefront/subject-kinds", void 0, options))?.nodes ?? [],
       theme: (options) => get("/storefront/content/theme", void 0, options),
       /** `null` when the page does not exist. */
       page: (handle, options) => getOrNull(`/storefront/content/pages/${enc(handle)}`, previewQuery(options), options),