@01.software/sdk 0.38.0 → 0.40.0

package/dist/{types-CIGscmus.d.cts → types-Umd-YTjM.d.ts}

@@ -1,6 +1,6 @@
-import { P as PublicCollection, S as ServerCollection } from './const-B5KT72c7.cjs';
-import { C as CollectionType, P as PublicProduct } from './types-D0ubzQw0.cjs';
-import { O as Order, l as Transaction, m as Fulfillment, R as Return } from './payload-types-m3jjhxk9.cjs';
+import { P as PublicCollection, S as ServerCollection } from './const-ymprfiPf.js';
+import { C as CollectionType, P as PublicProduct } from './types-Bh2p-EMc.js';
+import { O as Order, m as Transaction, n as Fulfillment, R as Return } from './payload-types-DC0xzR9i.js';
 
 interface CustomerScopedApiOptions {
     publishableKey?: string;
@@ -424,6 +424,7 @@ type PublicOrderItem = {
     quantity?: number | null;
     unitPrice?: number | null;
     discountedUnitPrice?: number | null;
+    discountedTotalPrice?: number | null;
     totalPrice?: number | null;
     options?: unknown;
     createdAt?: string | null;
@@ -433,11 +434,14 @@ type PublicOrderItem = {
 type PublicOrder = {
     id?: string | number;
     orderNumber?: string | null;
+    /** @deprecated Read-only compatibility alias. Prefer the independent axes. */
     status?: string | null;
+    /** @deprecated Read-only compatibility alias. Prefer the independent axes. */
     displayStatus?: string | null;
     primaryDisplayStatus?: string | null;
     displayFinancialStatus?: string | null;
     displayFulfillmentStatus?: string | null;
+    returnStatus?: string | null;
     returnDisplayStatus?: string | null;
     totalAmount?: number | null;
     subtotalAmount?: number | null;
@@ -533,7 +537,7 @@ type UpdateOrderParams = {
     orderNumber: string;
     status: 'confirmed';
 };
-type TransactionStatus = 'pending' | 'paid' | 'failed' | 'canceled';
+type TransactionStatus = 'pending' | 'paid' | 'failed' | 'canceled' | 'refunded';
 type UpdateTransactionParams = {
     pgPaymentId: string;
     status: TransactionStatus;
@@ -756,6 +760,12 @@ declare class OrderApi extends BaseApi {
     confirmPayment(params: ConfirmPaymentParams): Promise<ConfirmPaymentResponse>;
     cancelOrder(params: CancelOrderParams): Promise<CancelOrderResponse>;
     resolveCancelRefund(params: ResolveCancelRefundParams): Promise<ResolveCancelRefundResponse>;
+    /**
+     * Returns a `PublicOrder`-compatible shape even when the server backs the
+     * response with a Checkout (checkout/order separation, #1285). `orderNumber`
+     * stays the stable cross-window key. A breaking `PublicCheckout` split is a
+     * deferred follow-up (design D10 / Q3-b); do not change this return type here.
+     */
     checkout(params: CheckoutParams): Promise<PublicOrder>;
     createFulfillment(params: CreateFulfillmentParams): Promise<Fulfillment>;
     prepareFulfillmentOrder(params: PrepareFulfillmentOrderParams): Promise<PrepareFulfillmentOrderResponse>;
@@ -831,6 +841,17 @@ interface CustomerAuthOptions {
     onTokenChange?: (token: string | null) => void;
 }
 
+type CustomerOrderListOptions = {
+    page?: number;
+    limit?: number;
+    displayFinancialStatus?: string;
+    displayFulfillmentStatus?: string;
+    returnStatus?: string;
+    primaryDisplayStatus?: string;
+    returnDisplayStatus?: string;
+    /** @deprecated Read-only compatibility alias filter. Prefer independent status axes. */
+    status?: string;
+};
 /**
  * Customer authentication client.
  *
@@ -884,11 +905,7 @@ declare class CustomerAuth {
     /**
      * Get the authenticated customer's orders with pagination and optional status filter
      */
-    getMyOrders(options?: {
-        page?: number;
-        limit?: number;
-        status?: string;
-    }): Promise<PayloadFindResponse<PublicOrder>>;
+    getMyOrders(options?: CustomerOrderListOptions): Promise<PayloadFindResponse<PublicOrder>>;
     /**
      * Get the current token (or null if not authenticated)
      */
@@ -1021,7 +1038,7 @@ type NormalizedOptionSwatch<TMedia = unknown> = {
 };
 declare function selectedSwatchMediaItemId(swatch: NormalizedOptionSwatch | null | undefined): string | null;
 type ProductSelectionMediaSource = 'variant_media_selected' | 'variant_media_matching' | 'option_swatch' | 'none';
-type ProductDisplayMediaSource = 'listing_primary' | 'product_primary' | 'product_pool' | 'none';
+type ProductDisplayMediaSource = 'featured_image' | 'product_pool' | 'none';
 /** @deprecated Use {@link ProductSelectionMediaSource} or {@link ProductDisplayMediaSource}. */
 type ProductMediaResolutionSource = ProductSelectionMediaSource | ProductDisplayMediaSource;
 type ProductSelectionVariant<TMedia> = {
@@ -1037,7 +1054,6 @@ type ProductSelectionMediaPointer = string | number | {
 } | null;
 type ResolveProductSelectionMediaInput<TMedia> = {
     productMediaPool?: TMedia[] | null;
-    productPrimaryMediaItemId?: ProductSelectionMediaPointer;
     selectedVariant?: ProductSelectionVariant<TMedia> | null;
     matchingVariants?: Array<ProductSelectionVariant<TMedia> | null | undefined> | null;
     selectedOptionValues?: Array<ProductSelectionOptionValue | null | undefined> | null;
@@ -1049,8 +1065,7 @@ type ResolveProductSelectionMediaResult<TMedia> = {
 };
 type ResolveProductDisplayMediaInput<TMedia> = {
     productMediaPool?: TMedia[] | null;
-    productPrimaryMediaItemId?: ProductSelectionMediaPointer;
-    listingPrimaryImage?: ProductSelectionMediaPointer;
+    featuredImage?: ProductSelectionMediaPointer;
 };
 type ResolveProductDisplayMediaResult<TMedia> = {
     primaryImage: TMedia | null;
@@ -1059,15 +1074,13 @@ type ResolveProductDisplayMediaResult<TMedia> = {
 };
 declare function resolveProductSelectionMedia<TMedia>(input: ResolveProductSelectionMediaInput<TMedia>): ResolveProductSelectionMediaResult<TMedia>;
 declare function resolveProductDisplayMedia<TMedia>(input: ResolveProductDisplayMediaInput<TMedia>): ResolveProductDisplayMediaResult<TMedia>;
-type ListingPrimaryImageFallbackInput<TMedia> = {
+type FeaturedImagePointerInput<TMedia> = {
     productMediaPool?: TMedia[] | null;
-    productPrimaryMediaItemId?: ProductSelectionMediaPointer;
-    productThumbnail?: TMedia | string | number | null;
-    listingPrimaryImage?: TMedia | string | number | null;
+    featuredImage?: TMedia | string | number | null;
     resolvedPrimary?: TMedia | null;
     resolvedSource?: ProductMediaResolutionSource;
 };
-declare function resolveListingPrimaryImagePointer<TMedia>(input: ListingPrimaryImageFallbackInput<TMedia>): string | null;
+declare function resolveFeaturedImagePointer<TMedia>(input: FeaturedImagePointerInput<TMedia>): string | null;
 
 type EntityID = string;
 type RelationshipValue = string | number | null | undefined | {
@@ -1115,12 +1128,27 @@ interface ProductVariantShape {
 }
 interface ProductListingProductShape {
     id?: EntityID;
-    thumbnail?: MediaValue;
-    primaryMediaItemId?: MediaValue;
     images?: MediaValue[] | null;
-    listing?: {
-        primaryImage?: MediaValue;
+    featuredImage?: MediaValue;
+    priceRange?: {
+        minVariantPrice?: {
+            amount?: number | null;
+        } | null;
+        maxVariantPrice?: {
+            amount?: number | null;
+        } | null;
+        isPriceRange?: boolean | null;
+    } | null;
+    compareAtPriceRange?: {
+        minVariantPrice?: {
+            amount?: number | null;
+        } | null;
+        maxVariantPrice?: {
+            amount?: number | null;
+        } | null;
     } | null;
+    availableForSale?: boolean | null;
+    selectedOrFirstAvailableVariant?: RelationshipValue | ProductVariantShape;
 }
 type ProductOptionMatrixValue = {
     id: string;
@@ -1156,7 +1184,7 @@ type ProductOptionMatrix<TVariant extends ProductVariantShape = ProductVariantSh
     valueToOptionSlug: Map<string, string>;
     variants: ProductOptionMatrixVariant<TVariant>[];
 };
-type ProductListingProjection = {
+type ProductListingGroupProjection = {
     selectionHintVariant: EntityID | null;
     primaryImage: EntityID | null;
     minPrice: number | null;
@@ -1177,7 +1205,7 @@ type ProductListingGroup<TVariant extends ProductVariantShape = ProductVariantSh
     variantIds: EntityID[];
     variantCount: number;
     variants: TVariant[];
-    listing: ProductListingProjection;
+    listing: ProductListingGroupProjection;
 };
 type ProductListingCardPriceRange = {
     minPrice: number | null;
@@ -1194,7 +1222,8 @@ type ProductListingSwatch = {
     href: string;
     availableForSale: boolean;
 };
-type ProductListingCardRepresentativeVariant = ProductListingGroupsItem['groups'][number]['variants'][number];
+type ProductListingCardSourceItem = ProductListingGroupsCatalogItem | ProductListingGroupsItem;
+type ProductListingCardRepresentativeVariant = ProductListingCardSourceItem['groups'][number]['variants'][number];
 type ProductListingCard = {
     id: EntityID;
     href: string;
@@ -1241,10 +1270,10 @@ type ProductSelectionCodecOptions = {
     onLegacyOptionIdParam?: (event: LegacyProductSelectionParamEvent) => void;
 };
 type ProductSelectionResolutionContext = {
-    detail?: Pick<ProductDetail, 'images' | 'listing' | 'primaryMediaItemId'>;
+    detail?: Pick<ProductDetail, 'featuredImage' | 'images' | 'selectedOrFirstAvailableVariant'>;
+    featuredImage?: ProductDetail['featuredImage'];
     images?: ProductDetail['images'];
-    listing?: ProductDetail['listing'];
-    primaryMediaItemId?: ProductDetail['primaryMediaItemId'];
+    selectedOrFirstAvailableVariant?: ProductDetail['selectedOrFirstAvailableVariant'];
 };
 type ProductSelectionAvailableSwatch = {
     color?: string | null;
@@ -1352,8 +1381,8 @@ type ProductListingCardOptions = {
     preferCompleteVariantFromHint?: boolean;
 };
 declare function buildProductHref(product: ProductHrefProduct, group?: ProductHrefGroup | null, options?: ProductHrefOptions): string;
-declare function buildProductListingProjection(product: ProductListingProductShape | null | undefined, variants: ProductVariantShape[]): ProductListingProjection;
-declare function buildProductListingCard(item: ProductListingGroupsItem, options?: ProductListingCardOptions): ProductListingCard;
+declare function buildProductListingGroupProjection(product: ProductListingProductShape | null | undefined, variants: ProductVariantShape[]): ProductListingGroupProjection;
+declare function buildProductListingCard(item: ProductListingCardSourceItem, options?: ProductListingCardOptions): ProductListingCard;
 /** Shopify `priceRangeV2` naming for persisted listing projection fields. */
 declare function toShopifyPriceRangeV2(listing: {
     minPrice?: number | null;
@@ -1367,33 +1396,22 @@ declare function toShopifyPriceRangeV2(listing: {
     };
 };
 /**
- * PLP-safe query preset for the `products` collection.
- *
- * Payload's top-level `type: 'join'` fields on `products` (`variants`,
- * `options`) return at most 10 docs by default when queried via the REST API.
- * Storefront PLPs calling `client.collections.from('products').find()` without
- * explicit join limits silently receive truncated variant/option join data.
- * `buildProductListingGroupsByOption()` then drops primary-option values with
- * no matching variant in the response — a common cause of missing color swatches
- * even when the product has more variants than the default join cap.
+ * Server-side PLP query preset for raw `products` collection reads.
  *
- * Spread this constant into your `find()` call to raise both top-level limits:
+ * Greenfield storefronts should prefer
+ * `client.commerce.product.listingPage()` because it calls the shaped catalog
+ * endpoint, preserves pagination metadata, returns card-ready `cards`, and
+ * avoids exposing inventory quantities.
  *
- * ```typescript
- * const { docs } = await client.collections.from('products').find({
- *   ...PRODUCT_PLP_FIND_OPTIONS,
- *   where: { status: { equals: 'published' } },
- *   limit: 24,
- * })
- * ```
+ * This preset remains only for server-auth raw product query code
+ * that deliberately understands Payload join behavior. It raises top-level
+ * `products.options` and `products.variants` join limits, but it cannot fix
+ * nested `options[].values.docs` joins because the Payload REST `joins` param
+ * is flat.
  *
- * **Limitation:** This preset cures top-level `products.options` and
- * `products.variants` join truncation. It cannot cure the nested
- * `options[].values.docs` join — the Payload REST `joins` param is flat and
- * nested join limits require the listing-groups endpoint. Prefer
- * `commerce.product.listingGroupsCatalog()` + `buildProductListingCard()` as
- * the primary PLP path; they apply unlimited join fetches server-side and
- * return pre-grouped data ready for rendering.
+ * It is not accepted by publishable
+ * `createClient().collections.from('products').find()` because browser-public
+ * raw reads are constrained to `depth: 0`, `joins: false`, and no `populate`.
  */
 declare const PRODUCT_PLP_FIND_OPTIONS: ApiQueryOptions;
 /**
@@ -1463,8 +1481,6 @@ type ProductFieldsInput = {
     description?: string | null;
     status?: string;
     slug?: string;
-    primaryMediaItemId?: string | null;
-    thumbnail?: string | null;
     images?: string[];
     vendor?: string | null;
     productType?: string | null;
@@ -1527,19 +1543,33 @@ type ProductListingGroupSummary = ProductListingGroup<ProductListingGroupVariant
 type ProductListingGroupCatalogVariant = Omit<ProductListingGroupVariant, 'stock'>;
 type ProductListingGroupCatalogSummary = ProductListingGroup<ProductListingGroupCatalogVariant>;
 type ProductListingGroupsProductVariants = NonNullable<PublicProduct['variants']>;
-type ProductListingGroupsProductPrimaryMediaItemId = string | number | {
-    id?: string | number | null;
-} | null;
-type ProductListingGroupsProduct = Omit<PublicProduct, 'variants'> & {
+type ProductListingGroupsProduct = Omit<PublicProduct, 'createdAt' | 'updatedAt' | 'variants'> & {
     id: string;
     slug: string;
     title: string;
-    primaryMediaItemId?: ProductListingGroupsProductPrimaryMediaItemId;
+    createdAt?: PublicProduct['createdAt'];
+    updatedAt?: PublicProduct['updatedAt'];
+    featuredImage?: ProductDetailMedia | null;
+    priceRange?: ProductPriceRange;
+    compareAtPriceRange?: ProductMoneyRange;
+    availableForSale?: boolean | null;
+    selectedOrFirstAvailableVariant?: ProductListingGroupVariant | string | number | null;
     variants?: (Omit<ProductListingGroupsProductVariants, 'docs'> & {
         docs: ProductListingGroupVariant[];
     }) | null;
 };
-type ProductListingGroupsCatalogProduct = Omit<ProductListingGroupsProduct, 'variants'> & {
+type ProductListingGroupsCatalogProduct = {
+    id: string;
+    slug: string;
+    handle?: string | null;
+    title: string;
+    subtitle?: ProductListingGroupsProduct['subtitle'];
+    images?: ProductListingGroupsProduct['images'];
+    featuredImage?: ProductDetailMedia | null;
+    priceRange?: ProductPriceRange;
+    compareAtPriceRange?: ProductMoneyRange;
+    availableForSale?: boolean | null;
+    selectedOrFirstAvailableVariant?: ProductListingGroupCatalogVariant | string | number | null;
     variants?: (Omit<NonNullable<ProductListingGroupsProduct['variants']>, 'docs'> & {
         docs: ProductListingGroupCatalogVariant[];
     }) | null;
@@ -1565,6 +1595,36 @@ type ProductListingGroupsResponse = {
 type ProductListingGroupsCatalogResponse = Omit<ProductListingGroupsResponse, 'docs'> & {
     docs: ProductListingGroupsCatalogItem[];
 };
+type ProductListingPageSort = 'id' | '-id' | 'slug' | '-slug' | 'handle' | '-handle' | 'createdAt' | '-createdAt' | 'updatedAt' | '-updatedAt' | 'title' | '-title' | 'priceRange.minVariantPrice.amount' | '-priceRange.minVariantPrice.amount' | 'priceRange.maxVariantPrice.amount' | '-priceRange.maxVariantPrice.amount' | 'availableForSale' | '-availableForSale';
+type ProductListingPageFilters = {
+    ids?: string[];
+    slugs?: string[];
+    handles?: string[];
+    categoryIds?: string[];
+    tagIds?: string[];
+    price?: {
+        min?: number;
+        max?: number;
+    };
+    availableForSale?: boolean;
+};
+type ProductListingPageBaseParams = {
+    page?: number;
+    limit?: number;
+    search?: string;
+    sort?: ProductListingPageSort | ProductListingPageSort[];
+    filters?: ProductListingPageFilters;
+} & ProductListingCardOptions;
+type ProductListingPageCatalogParams = ProductListingPageBaseParams & {
+    mode?: 'catalog';
+};
+type ProductListingPageFullParams = ProductListingPageBaseParams & {
+    mode: 'full';
+};
+type ProductListingPageParams = ProductListingPageCatalogParams | ProductListingPageFullParams;
+type ProductListingPageResult<TItem> = PayloadFindResponse<TItem> & {
+    cards: ProductListingCard[];
+};
 type ProductDetailParams = {
     slug: string;
 } | {
@@ -1601,7 +1661,6 @@ type ProductOptionValueMediaSwatch<TMedia = ProductDetailMedia> = {
     color?: null;
 };
 type ProductOptionValueSwatch<TMedia = ProductDetailMedia> = ProductOptionValueColorSwatch | ProductOptionValueMediaSwatch<TMedia> | null;
-type ProductDetailMediaValue = string | number | ProductDetailMedia | null;
 type ProductDetailSelectionMediaSource = 'variant_media_selected' | 'variant_media_matching' | 'option_swatch' | 'none';
 interface ProductDetailVariant {
     id: string | number;
@@ -1663,20 +1722,18 @@ interface ProductDetailVideo {
     id: string | number;
     url?: string | null;
 }
-interface ProductDetailListing {
-    minPrice?: number | null;
-    maxPrice?: number | null;
-    minCompareAtPrice?: number | null;
-    maxCompareAtPrice?: number | null;
+interface ProductMoneyRange {
+    minVariantPrice: {
+        amount: number | null;
+    };
+    maxVariantPrice: {
+        amount: number | null;
+    };
+}
+interface ProductPriceRange extends ProductMoneyRange {
     isPriceRange?: boolean | null;
-    primaryImage?: ProductDetailMedia | null;
-    availableForSale?: boolean | null;
-    selectionHintVariant?: string | number | null;
 }
 type ProductDetailCatalogVariant = Omit<ProductDetailVariant, 'stock' | 'reservedStock'>;
-type ProductDetailCatalogListing = Omit<ProductDetailListing, 'availableForSale'> & {
-    liveStockRequired: true;
-};
 interface ProductDetailCatalog {
     product: Omit<ProductDetail['product'], 'totalInventory'>;
     variants: ProductDetailCatalogVariant[];
@@ -1686,8 +1743,11 @@ interface ProductDetailCatalog {
     tags: ProductDetail['tags'];
     images: ProductDetail['images'];
     videos: ProductDetail['videos'];
-    primaryMediaItemId?: ProductDetail['primaryMediaItemId'];
-    listing: ProductDetailCatalogListing;
+    featuredImage?: ProductDetail['featuredImage'];
+    priceRange?: ProductPriceRange;
+    compareAtPriceRange?: ProductMoneyRange;
+    availableForSale?: boolean | null;
+    selectedOrFirstAvailableVariant?: ProductDetailCatalogVariant | string | number | null;
 }
 type StockSnapshotItemStatus = 'available' | 'not_published' | 'archived' | 'not_found';
 interface StockSnapshotItem {
@@ -1725,9 +1785,16 @@ interface ProductDetail {
     tags: ProductDetailTag[];
     images: ProductDetailImage[];
     videos: ProductDetailVideo[];
-    /** Canonical product primary pointer (pool member). */
-    primaryMediaItemId?: ProductDetailMediaValue;
-    listing: ProductDetailListing;
+    /** Shopify-shaped product/card image, resolved from the first product image. */
+    featuredImage?: ProductDetailMedia | null;
+    /** Shopify-shaped product price range derived from active variants. */
+    priceRange?: ProductPriceRange;
+    /** Shopify-shaped compare-at price range derived from active variants. */
+    compareAtPriceRange?: ProductMoneyRange;
+    /** Product-level sellability derived from active variants and inventory. */
+    availableForSale?: boolean | null;
+    /** Default variant for PDP/card selection, equivalent to Shopify selectedOrFirstAvailableVariant. */
+    selectedOrFirstAvailableVariant?: ProductDetailVariant | string | number | null;
 }
 type ProductDetailUnavailableReason = 'not_found' | 'not_published' | 'feature_disabled';
 type ProductDetailResult = {
@@ -1760,7 +1827,7 @@ declare function isProductUpsertFieldValidationErrorBody(value: unknown): value
 type ProductUpsertResponse = {
     ok: true;
     product: PublicProduct;
-    listingProjectionStale: boolean;
+    productProjectionStale: boolean;
 } | {
     ok: false;
     failedEntity: 'product' | 'option' | 'option-value' | 'variant';
@@ -1778,6 +1845,9 @@ declare class ProductApi extends BaseApi {
     stockSnapshot(params: StockSnapshotParams): Promise<StockSnapshotResponse>;
     listingGroups(params: ListingGroupsParams): Promise<ProductListingGroupsResponse>;
     listingGroupsCatalog(params: ListingGroupsParams): Promise<ProductListingGroupsCatalogResponse>;
+    listingPage(params?: ProductListingPageCatalogParams): Promise<ProductListingPageResult<ProductListingGroupsCatalogItem>>;
+    listingPage(params: ProductListingPageFullParams): Promise<ProductListingPageResult<ProductListingGroupsItem>>;
+    listingPage(params: ProductListingPageParams): Promise<ProductListingPageResult<ProductListingGroupsCatalogItem> | ProductListingPageResult<ProductListingGroupsItem>>;
     /**
      * Fetch full product detail by slug or id.
      * Returns a discriminated result so storefronts can distinguish missing,
@@ -1849,8 +1919,11 @@ declare class CommerceClient {
     readonly product: {
         stockCheck: (params: StockCheckParams) => Promise<StockCheckResponse>;
         stockSnapshot: (params: StockSnapshotParams) => Promise<StockSnapshotResponse>;
-        listingGroups: (params: ListingGroupsParams) => Promise<ProductListingGroupsResponse>;
+        listingGroups: (params: ListingGroupsParams) => Promise<ProductListingGroupsCatalogResponse>;
         listingGroupsCatalog: (params: ListingGroupsParams) => Promise<ProductListingGroupsCatalogResponse>;
+        listingPage: {
+            (params?: ProductListingPageCatalogParams): Promise<ProductListingPageResult<ProductListingGroupsCatalogItem>>;
+        };
         detail: (params: ProductDetailParams) => Promise<ProductDetailResult>;
         detailCatalog: (params: ProductDetailParams) => Promise<ProductDetailCatalogResult>;
     };
@@ -1869,11 +1942,7 @@ declare class CommerceClient {
     };
     readonly orders: {
         checkout: (params: CheckoutParams) => Promise<PublicOrder>;
-        listMine: (options?: {
-            page?: number;
-            limit?: number;
-            status?: string;
-        }) => Promise<PayloadFindResponse<PublicOrder>>;
+        listMine: (options?: CustomerOrderListOptions) => Promise<PayloadFindResponse<PublicOrder>>;
     };
     readonly discounts: {
         validate: (params: ValidateDiscountParams) => Promise<ValidateDiscountResult>;
@@ -1884,6 +1953,85 @@ declare class CommerceClient {
     constructor(options: CommerceClientOptions);
 }
 
+type StorefrontContentReference = {
+    id?: string | number | null;
+    title?: string | null;
+    name?: string | null;
+    slug?: string | null;
+    displayName?: string | null;
+    handle?: string | null;
+    color?: string | null;
+    image?: PublicMediaAsset | null;
+    thumbnail?: PublicMediaAsset | null;
+    avatar?: PublicMediaAsset | null;
+};
+type StorefrontLink = {
+    id?: string | number | null;
+    title?: string | null;
+    subtitle?: string | null;
+    url?: string | null;
+    description?: string | null;
+    slug?: string | null;
+    type?: 'external' | 'social' | 'internal' | string | null;
+    platform?: string | null;
+    opensInNewTab?: boolean | null;
+    noFollow?: boolean | null;
+    expiresAt?: string | null;
+    isFeatured?: boolean | null;
+    publishedAt?: string | null;
+    createdAt?: string | null;
+    updatedAt?: string | null;
+    categories?: StorefrontContentReference[] | StorefrontContentReference | null;
+    tags?: StorefrontContentReference[] | StorefrontContentReference | null;
+    thumbnail?: PublicMediaAsset | null;
+    icon?: PublicMediaAsset | null;
+};
+type StorefrontGalleryItem = {
+    id?: string | number | null;
+    title?: string | null;
+    description?: string | null;
+    content?: unknown;
+    createdAt?: string | null;
+    updatedAt?: string | null;
+    gallery?: StorefrontContentReference | string | null;
+    image?: PublicMediaAsset | null;
+};
+type StorefrontLinksSort = 'createdAt' | '-createdAt' | 'updatedAt' | '-updatedAt' | 'publishedAt' | '-publishedAt' | 'title' | '-title' | 'isFeatured' | '-isFeatured';
+type StorefrontGalleryItemsSort = 'manual' | 'createdAt' | '-createdAt' | 'updatedAt' | '-updatedAt' | 'title' | '-title';
+type StorefrontContentListOptions<TSort extends string = string> = {
+    page?: number;
+    limit?: number;
+    sort?: TSort;
+};
+type StorefrontLinksListOptions = StorefrontContentListOptions<StorefrontLinksSort> & {
+    categoryId?: string;
+    categorySlug?: string;
+    tagId?: string;
+    tagSlug?: string;
+    featured?: boolean;
+};
+type StorefrontGalleryItemsListOptions = StorefrontContentListOptions<StorefrontGalleryItemsSort> & ({
+    galleryId: string;
+    gallerySlug?: string;
+} | {
+    galleryId?: string;
+    gallerySlug: string;
+});
+type ContentClientOptions = {
+    publishableKey: string;
+    apiUrl?: string;
+    onRequestId?: (id: string | null) => void;
+};
+declare class ContentClient {
+    readonly links: {
+        list: (options?: StorefrontLinksListOptions) => Promise<PayloadFindResponse<StorefrontLink>>;
+    };
+    readonly galleryItems: {
+        list: (options: StorefrontGalleryItemsListOptions) => Promise<PayloadFindResponse<StorefrontGalleryItem>>;
+    };
+    constructor(options: ContentClientOptions);
+}
+
 interface ServerCommerceClientOptions {
     publishableKey?: string;
     secretKey: string;
@@ -1894,6 +2042,11 @@ declare class ServerCommerceClient {
     readonly product: {
         stockCheck: (params: StockCheckParams) => Promise<StockCheckResponse>;
         listingGroups: (params: ListingGroupsParams) => Promise<ProductListingGroupsResponse>;
+        listingPage: {
+            (params?: ProductListingPageCatalogParams): Promise<ProductListingPageResult<ProductListingGroupsCatalogItem>>;
+            (params: ProductListingPageFullParams): Promise<ProductListingPageResult<ProductListingGroupsItem>>;
+            (params: ProductListingPageParams): Promise<ProductListingPageResult<ProductListingGroupsCatalogItem> | ProductListingPageResult<ProductListingGroupsItem>>;
+        };
         detail: (params: ProductDetailParams) => Promise<ProductDetailResult>;
         previewDetail: (params: ProductDetailPreviewParams, options: ProductDetailPreviewOptions) => Promise<ProductDetail | null>;
         upsert: (params: ProductUpsertParams) => Promise<ProductUpsertResponse>;
@@ -1961,8 +2114,8 @@ interface EventsRangeParams {
     end: EventsDateParam;
     limit?: number;
     page?: number;
-    calendar?: string | string[];
-    calendarSlug?: string | string[];
+    calendar?: string;
+    calendarSlug?: string;
     category?: string | string[];
     categorySlug?: string | string[];
     tag?: string | string[];
@@ -2011,7 +2164,7 @@ interface EventsRangeEvent {
     externalRegistrationUrl?: string | null;
     externalSource: EventsExternalSource | null;
     location: EventsLocation | null;
-    calendars: EventsCalendarItem[];
+    calendar: EventsCalendarItem;
     categories: EventsTaxonomyItem[];
     tags: EventsTaxonomyItem[];
 }
@@ -2035,7 +2188,7 @@ interface EventsRangeResponse {
         end: string;
     };
     docs: EventsRangeOccurrence[];
-    calendars: EventsCalendarItem[];
+    calendar: EventsCalendarItem | null;
     events: EventsRangeEvent[];
     categories: EventsTaxonomyItem[];
     tags: EventsTaxonomyItem[];
@@ -2332,6 +2485,20 @@ interface ApiQueryOptions {
     /** Include soft-deleted documents (requires `trash` enabled on the collection) */
     trash?: boolean;
 }
+type PublicReadQueryOptions = Omit<ApiQueryOptions, 'depth' | 'joins' | 'populate'> & {
+    /**
+     * Publishable collection reads stay unpopulated. Use shaped commerce/community
+     * endpoints or a server client when populated relations are required.
+     */
+    depth?: 0;
+    /**
+     * Publishable collection reads disable Payload join fields to avoid accidental
+     * exposure and expensive generic list responses.
+     */
+    joins?: false;
+    /** Publishable collection reads do not support relationship populate maps. */
+    populate?: never;
+};
 interface DebugConfig {
     logRequests?: boolean;
     logResponses?: boolean;
@@ -2342,14 +2509,14 @@ interface RetryConfig {
     retryableStatuses?: number[];
     retryDelay?: (attempt: number) => number;
 }
-interface RootQueryLookup<T extends string> {
-    find(options?: ApiQueryOptions): Promise<PayloadFindResponse<CollectionType<T>>>;
-    findById(id: string | number, options?: ApiQueryOptions): Promise<CollectionType<T>>;
-    count(options?: ApiQueryOptions): Promise<{
+interface RootQueryLookup<T extends string, Options extends ApiQueryOptions = ApiQueryOptions> {
+    find(options?: Options): Promise<PayloadFindResponse<CollectionType<T>>>;
+    findById(id: string | number, options?: Options): Promise<CollectionType<T>>;
+    count(options?: Options): Promise<{
         totalDocs: number;
     }>;
 }
-type RootReadOnlyQueryBuilder<T extends PublicCollection> = RootQueryLookup<T>;
+type RootReadOnlyQueryBuilder<T extends PublicCollection> = RootQueryLookup<T, PublicReadQueryOptions>;
 interface RootServerQueryBuilder<T extends ServerCollection> extends RootQueryLookup<T> {
     create(data: Partial<CollectionType<T>>, options?: {
         file?: File | Blob;
@@ -2372,6 +2539,7 @@ interface RootServerCollectionClient {
 interface RootClient {
     commerce: CommerceClient;
     community: CommunityClient;
+    content: ContentClient;
     /** Set on {@link createClient} return values; optional for structural mocks. */
     events?: EventsClient;
     customer: CustomerNamespace;
@@ -2409,4 +2577,4 @@ type DeepPartial<T> = {
 };
 type ExtractArrayType<T> = T extends (infer U)[] ? U : never;
 
-export { type EventsCalendarItem as $, type AddItemParams as A, BaseApi as B, CommerceClient as C, type DebugConfig as D, EventsClient as E, ServerCommerceClient as F, type BanCustomerParams as G, type CommunityBan as H, type UnbanCustomerParams as I, type ClientServerConfig as J, type RootServerClientWithEvents as K, type CollectionFieldSchema as L, type CollectionSchemaResponse as M, type EventGuestCancelParams as N, type EventGuestRegistration as O, type PayloadFindResponse as P, type EventGuestRegistrationResponse as Q, type RemoveDiscountParams as R, type Sort as S, type TenantIntrospectionClient as T, type UpdateItemParams as U, type EventRegistrationAnswerInput as V, type Where as W, type EventRegistrationAttendeeInput as X, type EventRegistrationPublic as Y, type EventRegistrationRegisterParams as Z, type EventRegistrationRegisterResponse as _, CommunityClient as a, type CommunityPublicAuthorSnapshot as a$, type EventsClientOptions as a0, type EventsDateParam as a1, type EventsExternalSource as a2, type EventsLocation as a3, type EventsOccurrenceLocation as a4, type EventsRangeEvent as a5, type EventsRangeOccurrence as a6, type EventsRangeParams as a7, type EventsRangeResponse as a8, type EventsTaxonomyItem as a9, type ProductDetailCatalog as aA, type StockSnapshotResponse as aB, type ProductSelectionMediaSource as aC, type ProductDisplayMediaSource as aD, type ResolveProductSelectionMediaInput as aE, type ResolveProductSelectionMediaResult as aF, type ProductSelectionMediaPointer as aG, type RootClientWithEvents as aH, type BulkImportFulfillmentsParams as aI, type BulkImportFulfillmentsResponse as aJ, type CalculateShippingParams as aK, type CalculateShippingResult as aL, type CancelOrderParams as aM, type CancelOrderReconciliationStatus as aN, type CancelOrderResponse as aO, type CancelReasonCode as aP, CartApi as aQ, type CartApiOptions as aR, type Comment as aS, type CommerceClientOptions as aT, type CommunityClientOptions as aU, type CommunityComment as aV, type CommunityCommentListSort as aW, type CommunityPost as aX, type CommunityPostCategory as aY, type CommunityPostListSort as aZ, type CommunityPostTag as a_, ModerationApi as aa, type RootServerClient as ab, type TenantFeatureProgressEvidenceValue as ac, type TenantFeatureProgressFeature as ad, type TenantFeatureProgressGroup as ae, type TenantFeatureProgressInput as af, type TenantFeatureProgressItem as ag, type TenantFeatureProgressItemState as ah, type TenantFeatureProgressResponse as ai, type TenantFeatureProgressSeverity as aj, type TenantFeatureProgressStatus as ak, TenantIntrospectionApi as al, type TenantIntrospectionApiOptions as am, CustomerAuth as an, type CustomerProfile as ao, type CustomerAuthResponse as ap, type CustomerLoginData as aq, type CustomerRegisterResponse as ar, type CustomerRegisterData as as, type CustomerRefreshResponse as at, type UpdateProfileData as au, type ProductDetailParams as av, type ProductDetailResult as aw, type ProductListingGroupsItem as ax, type ProductListingGroupsCatalogItem as ay, type ProductDetail as az, CustomerNamespace as b, type ProductMediaResolutionSource as b$, type CommunityPublicMediaAsset as b0, type CommunityPublicReference as b1, type CompatibilityProductSelectionParamEvent as b2, type ConfirmPaymentParams as b3, type ConfirmPaymentResponse as b4, type CreateFulfillmentParams as b5, type CreateOrderItem as b6, type CreateOrderParams as b7, type CreateReturnParams as b8, type CustomerAuthOptions as b9, type ProductDetailMedia as bA, type ProductDetailOption as bB, type ProductDetailOptionValue as bC, type ProductDetailTag as bD, type ProductDetailUnavailableReason as bE, type ProductDetailVariant as bF, type ProductDetailVariantOptionValue as bG, type ProductDetailVideo as bH, type ProductHrefGroup as bI, type ProductHrefOptions as bJ, type ProductHrefProduct as bK, type ProductListingCard as bL, type ProductListingCardOptions as bM, type ProductListingCardPriceRange as bN, type ProductListingCardRepresentativeVariant as bO, type ProductListingGroup as bP, type ProductListingGroupCatalogSummary as bQ, type ProductListingGroupCatalogVariant as bR, type ProductListingGroupSummary as bS, type ProductListingGroupVariant as bT, type ProductListingGroupsCatalogProduct as bU, type ProductListingGroupsCatalogResponse as bV, type ProductListingGroupsProduct as bW, type ProductListingGroupsResponse as bX, type ProductListingProductShape as bY, type ProductListingProjection as bZ, type ProductListingSwatch as b_, type CustomerSnapshot as ba, DiscountApi as bb, type DiscountApiOptions as bc, type LegacyProductSelectionParamEvent as bd, type ListingGroupsParams as be, type ListingPrimaryImageFallbackInput as bf, type MediaValue as bg, type NormalizedOptionSwatch as bh, type NormalizedProductSelection as bi, OrderApi as bj, type OrderApiOptions as bk, PRODUCT_PLP_FIND_OPTIONS as bl, PRODUCT_UPSERT_READONLY_FIELD_REASON as bm, PRODUCT_UPSERT_UNKNOWN_FIELD_REASON as bn, type PrepareFulfillmentOrderParams as bo, type PrepareFulfillmentOrderResponse as bp, ProductApi as bq, type ProductApiOptions as br, type ProductDetailBrand as bs, type ProductDetailCatalogListing as bt, type ProductDetailCatalogResult as bu, type ProductDetailCatalogVariant as bv, type ProductDetailCategory as bw, type ProductDetailImage as bx, type ProductDetailImageMedia as by, type ProductDetailListing as bz, type ClientState as c, resolveListingPrimaryImagePointer as c$, type ProductOptionMatrix as c0, type ProductOptionMatrixOption as c1, type ProductOptionMatrixValue as c2, type ProductOptionMatrixVariant as c3, type ProductOptionShape as c4, type ProductOptionValueShape as c5, type ProductOptionValueSwatch as c6, type ProductOptionValueSwatchInput as c7, type ProductSelectionAvailableSwatch as c8, type ProductSelectionAvailableValue as c9, type StockCheckParams as cA, type StockCheckResponse as cB, type StockCheckResult as cC, type StockSnapshotItem as cD, type StockSnapshotParams as cE, type UpdateFulfillmentParams as cF, type UpdateOrderParams as cG, type UpdateReturnParams as cH, type UpdateTransactionParams as cI, type ValidateDiscountParams as cJ, type ValidateDiscountResult as cK, type WithIdempotencyKey as cL, buildProductHref as cM, buildProductListingCard as cN, buildProductListingGroupsByOption as cO, buildProductListingProjection as cP, buildProductOptionMatrix as cQ, buildProductOptionMatrixFromDetail as cR, createProductSelectionCodec as cS, getAvailableOptionValues as cT, getProductSelectionImages as cU, getSelectedValueByOptionId as cV, isProductUpsertFieldValidationErrorBody as cW, normalizeProductSelection as cX, normalizeProductSelectionFromMatrix as cY, normalizeSelectedValueIds as cZ, parseProductSelection as c_, type ProductSelectionByOptionValue as ca, ProductSelectionCodecError as cb, type ProductSelectionCodecOptions as cc, type ProductSelectionInput as cd, type ProductSelectionOptionValue as ce, type ProductSelectionResolution as cf, type ProductSelectionResolutionContext as cg, type ProductSelectionUrlEmit as ch, type ProductSelectionVariant as ci, type ProductUpsertFieldValidationErrorBody as cj, type ProductUpsertFieldValidationErrorReason as ck, type ProductVariantShape as cl, type RequestOptions as cm, type ResolveCancelRefundFailedResponse as cn, type ResolveCancelRefundOutcome as co, type ResolveCancelRefundParams as cp, type ResolveCancelRefundResponse as cq, type ResolveCancelRefundSucceededResponse as cr, type ResolveProductDisplayMediaInput as cs, type ResolveProductDisplayMediaResult as ct, type ReturnItem as cu, type ReturnReason as cv, type ReturnWithRefundItem as cw, type ReturnWithRefundParams as cx, ShippingApi as cy, type ShippingApiOptions as cz, type ClientConfig as d, resolveProductDisplayMedia as d0, resolveProductSelection as d1, resolveProductSelectionFromMatrix as d2, resolveProductSelectionMedia as d3, resolveVariantForSelection as d4, selectNext as d5, selectedSwatchMediaItemId as d6, stringifyProductSelection as d7, toShopifyPriceRangeV2 as d8, type ApiQueryOptions as e, type ApplyDiscountParams as f, type CheckoutParams as g, type ClearCartParams as h, type ClientMetadata as i, type DeepPartial as j, type ExtractArrayType as k, type PayloadMutationResponse as l, type PublicCart as m, type PublicCartItem as n, type PublicCartReference as o, type PublicMediaAsset as p, type PublicMediaSize as q, type PublicOrder as r, type PublicOrderItem as s, type PublicOrderReference as t, type RemoveItemParams as u, type RetryConfig as v, type RootClient as w, type RootCollectionClient as x, type RootReadOnlyQueryBuilder as y, type ServerApiOptions as z };
+export { type CollectionFieldSchema as $, type AddItemParams as A, type RootReadOnlyQueryBuilder as B, CommerceClient as C, type DebugConfig as D, EventsClient as E, type StorefrontContentListOptions as F, type StorefrontContentReference as G, type StorefrontGalleryItem as H, type StorefrontGalleryItemsListOptions as I, type StorefrontGalleryItemsSort as J, type StorefrontLink as K, type StorefrontLinksListOptions as L, type StorefrontLinksSort as M, BaseApi as N, type ServerApiOptions as O, type PayloadFindResponse as P, ServerCommerceClient as Q, type RemoveDiscountParams as R, type Sort as S, type TenantIntrospectionClient as T, type UpdateItemParams as U, type BanCustomerParams as V, type Where as W, type CommunityBan as X, type UnbanCustomerParams as Y, type ClientServerConfig as Z, type RootServerClientWithEvents as _, CommunityClient as a, type CalculateShippingResult as a$, type CollectionSchemaResponse as a0, type EventGuestCancelParams as a1, type EventGuestRegistration as a2, type EventGuestRegistrationResponse as a3, type EventRegistrationAnswerInput as a4, type EventRegistrationAttendeeInput as a5, type EventRegistrationPublic as a6, type EventRegistrationRegisterParams as a7, type EventRegistrationRegisterResponse as a8, type EventsCalendarItem as a9, type CustomerAuthResponse as aA, type CustomerLoginData as aB, type CustomerRegisterResponse as aC, type CustomerRegisterData as aD, type CustomerRefreshResponse as aE, type UpdateProfileData as aF, type ProductListingPageBaseParams as aG, type ProductListingPageParams as aH, type ProductDetailParams as aI, type ProductDetailResult as aJ, type ProductListingPageCatalogParams as aK, type ProductListingPageResult as aL, type ProductListingGroupsCatalogItem as aM, type ProductListingPageFullParams as aN, type ProductListingGroupsItem as aO, type ProductDetail as aP, type ProductDetailCatalog as aQ, type StockSnapshotResponse as aR, type ProductSelectionMediaSource as aS, type ProductDisplayMediaSource as aT, type ResolveProductSelectionMediaInput as aU, type ResolveProductSelectionMediaResult as aV, type ProductSelectionMediaPointer as aW, type RootClientWithEvents as aX, type BulkImportFulfillmentsParams as aY, type BulkImportFulfillmentsResponse as aZ, type CalculateShippingParams as a_, type EventsClientOptions as aa, type EventsDateParam as ab, type EventsExternalSource as ac, type EventsLocation as ad, type EventsOccurrenceLocation as ae, type EventsRangeEvent as af, type EventsRangeOccurrence as ag, type EventsRangeParams as ah, type EventsRangeResponse as ai, type EventsTaxonomyItem as aj, ModerationApi as ak, type RootServerClient as al, type TenantFeatureProgressEvidenceValue as am, type TenantFeatureProgressFeature as an, type TenantFeatureProgressGroup as ao, type TenantFeatureProgressInput as ap, type TenantFeatureProgressItem as aq, type TenantFeatureProgressItemState as ar, type TenantFeatureProgressResponse as as, type TenantFeatureProgressSeverity as at, type TenantFeatureProgressStatus as au, TenantIntrospectionApi as av, type TenantIntrospectionApiOptions as aw, type PublicReadQueryOptions as ax, CustomerAuth as ay, type CustomerProfile as az, ContentClient as b, type ProductListingCardOptions as b$, type CancelOrderParams as b0, type CancelOrderReconciliationStatus as b1, type CancelOrderResponse as b2, type CancelReasonCode as b3, CartApi as b4, type CartApiOptions as b5, type Comment as b6, type CommerceClientOptions as b7, type CommunityClientOptions as b8, type CommunityComment as b9, OrderApi as bA, type OrderApiOptions as bB, PRODUCT_PLP_FIND_OPTIONS as bC, PRODUCT_UPSERT_READONLY_FIELD_REASON as bD, PRODUCT_UPSERT_UNKNOWN_FIELD_REASON as bE, type PrepareFulfillmentOrderParams as bF, type PrepareFulfillmentOrderResponse as bG, ProductApi as bH, type ProductApiOptions as bI, type ProductDetailBrand as bJ, type ProductDetailCatalogResult as bK, type ProductDetailCatalogVariant as bL, type ProductDetailCategory as bM, type ProductDetailImage as bN, type ProductDetailImageMedia as bO, type ProductDetailMedia as bP, type ProductDetailOption as bQ, type ProductDetailOptionValue as bR, type ProductDetailTag as bS, type ProductDetailUnavailableReason as bT, type ProductDetailVariant as bU, type ProductDetailVariantOptionValue as bV, type ProductDetailVideo as bW, type ProductHrefGroup as bX, type ProductHrefOptions as bY, type ProductHrefProduct as bZ, type ProductListingCard as b_, type CommunityCommentListSort as ba, type CommunityPost as bb, type CommunityPostCategory as bc, type CommunityPostListSort as bd, type CommunityPostTag as be, type CommunityPublicAuthorSnapshot as bf, type CommunityPublicMediaAsset as bg, type CommunityPublicReference as bh, type CompatibilityProductSelectionParamEvent as bi, type ConfirmPaymentParams as bj, type ConfirmPaymentResponse as bk, type CreateFulfillmentParams as bl, type CreateOrderItem as bm, type CreateOrderParams as bn, type CreateReturnParams as bo, type CustomerAuthOptions as bp, type CustomerOrderListOptions as bq, type CustomerSnapshot as br, DiscountApi as bs, type DiscountApiOptions as bt, type FeaturedImagePointerInput as bu, type LegacyProductSelectionParamEvent as bv, type ListingGroupsParams as bw, type MediaValue as bx, type NormalizedOptionSwatch as by, type NormalizedProductSelection as bz, CustomerNamespace as c, type UpdateTransactionParams as c$, type ProductListingCardPriceRange as c0, type ProductListingCardRepresentativeVariant as c1, type ProductListingGroup as c2, type ProductListingGroupCatalogSummary as c3, type ProductListingGroupCatalogVariant as c4, type ProductListingGroupProjection as c5, type ProductListingGroupSummary as c6, type ProductListingGroupVariant as c7, type ProductListingGroupsCatalogProduct as c8, type ProductListingGroupsCatalogResponse as c9, type ProductSelectionUrlEmit as cA, type ProductSelectionVariant as cB, type ProductUpsertFieldValidationErrorBody as cC, type ProductUpsertFieldValidationErrorReason as cD, type ProductVariantShape as cE, type RequestOptions as cF, type ResolveCancelRefundFailedResponse as cG, type ResolveCancelRefundOutcome as cH, type ResolveCancelRefundParams as cI, type ResolveCancelRefundResponse as cJ, type ResolveCancelRefundSucceededResponse as cK, type ResolveProductDisplayMediaInput as cL, type ResolveProductDisplayMediaResult as cM, type ReturnItem as cN, type ReturnReason as cO, type ReturnWithRefundItem as cP, type ReturnWithRefundParams as cQ, ShippingApi as cR, type ShippingApiOptions as cS, type StockCheckParams as cT, type StockCheckResponse as cU, type StockCheckResult as cV, type StockSnapshotItem as cW, type StockSnapshotParams as cX, type UpdateFulfillmentParams as cY, type UpdateOrderParams as cZ, type UpdateReturnParams as c_, type ProductListingGroupsProduct as ca, type ProductListingGroupsResponse as cb, type ProductListingPageFilters as cc, type ProductListingPageSort as cd, type ProductListingProductShape as ce, type ProductListingSwatch as cf, type ProductMediaResolutionSource as cg, type ProductMoneyRange as ch, type ProductOptionMatrix as ci, type ProductOptionMatrixOption as cj, type ProductOptionMatrixValue as ck, type ProductOptionMatrixVariant as cl, type ProductOptionShape as cm, type ProductOptionValueShape as cn, type ProductOptionValueSwatch as co, type ProductOptionValueSwatchInput as cp, type ProductPriceRange as cq, type ProductSelectionAvailableSwatch as cr, type ProductSelectionAvailableValue as cs, type ProductSelectionByOptionValue as ct, ProductSelectionCodecError as cu, type ProductSelectionCodecOptions as cv, type ProductSelectionInput as cw, type ProductSelectionOptionValue as cx, type ProductSelectionResolution as cy, type ProductSelectionResolutionContext as cz, type ClientState as d, type ValidateDiscountParams as d0, type ValidateDiscountResult as d1, type WithIdempotencyKey as d2, buildProductHref as d3, buildProductListingCard as d4, buildProductListingGroupProjection as d5, buildProductListingGroupsByOption as d6, buildProductOptionMatrix as d7, buildProductOptionMatrixFromDetail as d8, createProductSelectionCodec as d9, getAvailableOptionValues as da, getProductSelectionImages as db, getSelectedValueByOptionId as dc, isProductUpsertFieldValidationErrorBody as dd, normalizeProductSelection as de, normalizeProductSelectionFromMatrix as df, normalizeSelectedValueIds as dg, parseProductSelection as dh, resolveFeaturedImagePointer as di, resolveProductDisplayMedia as dj, resolveProductSelection as dk, resolveProductSelectionFromMatrix as dl, resolveProductSelectionMedia as dm, resolveVariantForSelection as dn, selectNext as dp, selectedSwatchMediaItemId as dq, stringifyProductSelection as dr, toShopifyPriceRangeV2 as ds, type ClientConfig as e, type ApiQueryOptions as f, type ApplyDiscountParams as g, type CheckoutParams as h, type ClearCartParams as i, type ClientMetadata as j, type ContentClientOptions as k, type DeepPartial as l, type ExtractArrayType as m, type PayloadMutationResponse as n, type PublicCart as o, type PublicCartItem as p, type PublicCartReference as q, type PublicMediaAsset as r, type PublicMediaSize as s, type PublicOrder as t, type PublicOrderItem as u, type PublicOrderReference as v, type RemoveItemParams as w, type RetryConfig as x, type RootClient as y, type RootCollectionClient as z };