@01.software/sdk 0.33.0 → 0.34.0

package/dist/{types-BZKxss8Y.d.cts → types-DDhtZI6E.d.cts}

@@ -1,6 +1,6 @@
-import { P as PublicCollection } from './const-sPR2IkCe.cjs';
-import { P as PublicProduct, C as CollectionType } from './types-B3YT092I.cjs';
-import { O as Order, i as Cart, j as CartItem, m as Transaction, n as Fulfillment, o as Return } from './payload-types-dkeQyrDC.cjs';
+import { P as PublicCollection, S as ServerCollection } from './const-BTvdrXtY.cjs';
+import { C as CollectionType, P as PublicProduct } from './types-Bx558PU6.cjs';
+import { O as Order, i as Cart, j as CartItem, m as Transaction, n as Fulfillment, o as Return } from './payload-types-C7tb7Xbs.cjs';
 
 interface CommunityClientOptions {
     publishableKey?: string;
@@ -10,28 +10,18 @@ interface CommunityClientOptions {
     onUnauthorized?: () => Promise<string | null>;
     onRequestId?: (id: string | null) => void;
 }
-interface CommunityPost {
-    id: string;
-    title?: string | null;
-    displayTitle?: string | null;
-    content?: unknown;
-    categories?: string[];
-    thumbnail?: string;
-    viewCount?: number;
-    createdAt?: string;
-    updatedAt?: string;
-    [key: string]: unknown;
-}
-interface Comment {
-    id: string;
-    body: string;
-    post?: string;
-    parent?: string;
-    rootComment?: string;
-    createdAt?: string;
-    updatedAt?: string;
-    [key: string]: unknown;
-}
+/** Public read shape for `posts` (tenant-scoped author profiles). */
+type CommunityPost = CollectionType<'posts'>;
+/** Public read shape for `comments`. */
+type CommunityComment = CollectionType<'comments'>;
+/** @deprecated Use {@link CommunityComment}. */
+type Comment = CommunityComment;
+/** Public read shape for `post-categories`. */
+type CommunityPostCategory = CollectionType<'post-categories'>;
+/** Public read shape for `post-tags`. */
+type CommunityPostTag = CollectionType<'post-tags'>;
+type CommunityPostListSort = 'createdAt' | '-createdAt' | 'lastActivityAt' | '-lastActivityAt' | 'viewCount' | '-viewCount' | 'commentCount' | '-commentCount';
+type CommunityCommentListSort = 'createdAt' | '-createdAt';
 interface Reaction {
     id: string;
     post?: string;
@@ -79,6 +69,8 @@ declare class CommunityClient {
     private readonly onRequestId?;
     constructor(options: CommunityClientOptions);
     private buildQuery;
+    private buildPostsListQuery;
+    private buildCommentsListQuery;
     private execute;
     createPost(params: {
         title?: string | null;
@@ -86,6 +78,25 @@ declare class CommunityClient {
         categories?: string[];
         thumbnail?: string;
     }): Promise<CommunityPost>;
+    /**
+     * Public post feed. Server applies the same visibility contract as
+     * `communityPostRead` (published + visible + moderation-safe).
+     */
+    listPosts(params?: {
+        page?: number;
+        limit?: number;
+        categoryId?: string;
+        tagId?: string;
+        sort?: CommunityPostListSort;
+    }): Promise<PaginatedResponse<CommunityPost>>;
+    listPostCategories(params?: {
+        page?: number;
+        limit?: number;
+    }): Promise<PaginatedResponse<CommunityPostCategory>>;
+    listPostTags(params?: {
+        page?: number;
+        limit?: number;
+    }): Promise<PaginatedResponse<CommunityPostTag>>;
     getMyPosts(params?: {
         page?: number;
         limit?: number;
@@ -94,6 +105,7 @@ declare class CommunityClient {
         page?: number;
         limit?: number;
         period?: string;
+        metric?: 'reactions' | 'comments' | 'views' | 'activity';
     }): Promise<PaginatedResponse<CommunityPost>>;
     incrementView(params: {
         postId: string;
@@ -111,17 +123,33 @@ declare class CommunityClient {
         postId: string;
         body: string;
         parentId?: string;
-    }): Promise<Comment>;
+    }): Promise<CommunityComment>;
+    /**
+     * List comments for a post.
+     *
+     * - Default: all visible comments on the post (any depth).
+     * - `topLevelOnly: true`: only root comments (`parent` unset).
+     * - `rootComment`: comments belonging to a thread rooted at that comment.
+     */
     listComments(params: {
         postId: string;
         page?: number;
         limit?: number;
         rootComment?: string;
-    }): Promise<PaginatedResponse<Comment>>;
+        topLevelOnly?: boolean;
+        sort?: CommunityCommentListSort;
+    }): Promise<PaginatedResponse<CommunityComment>>;
+    /** Direct replies to a comment (`where[parent][equals]`). */
+    listReplies(params: {
+        commentId: string;
+        page?: number;
+        limit?: number;
+        sort?: CommunityCommentListSort;
+    }): Promise<PaginatedResponse<CommunityComment>>;
     updateComment(params: {
         commentId: string;
         body: string;
-    }): Promise<Comment>;
+    }): Promise<CommunityComment>;
     deleteComment(params: {
         commentId: string;
     }): Promise<{
@@ -136,7 +164,9 @@ declare class CommunityClient {
     }>;
     addReaction(params: {
         postId: string;
-        type: string;
+        typeSlug?: string;
+        /** @deprecated Use `typeSlug`. */
+        type?: string;
     }): Promise<Reaction>;
     removeReaction(params: {
         postId: string;
@@ -146,7 +176,9 @@ declare class CommunityClient {
     }>;
     addCommentReaction(params: {
         commentId: string;
-        type: string;
+        typeSlug?: string;
+        /** @deprecated Use `typeSlug`. */
+        type?: string;
     }): Promise<Reaction>;
     removeCommentReaction(params: {
         commentId: string;
@@ -157,6 +189,9 @@ declare class CommunityClient {
     getReactionSummary(params: {
         postId: string;
     }): Promise<ReactionSummary>;
+    getCommentReactionSummary(params: {
+        commentId: string;
+    }): Promise<ReactionSummary>;
     getReactionTypes(): Promise<PaginatedResponse<ReactionType>>;
     addBookmark(params: {
         postId: string;
@@ -170,6 +205,22 @@ declare class CommunityClient {
         page?: number;
         limit?: number;
     }): Promise<PaginatedResponse<Bookmark>>;
+    listProfileLists(params?: {
+        page?: number;
+        limit?: number;
+    }): Promise<PaginatedResponse<CollectionType<'customer-profile-lists'>>>;
+    getProfileList(params: {
+        slug: string;
+    } | {
+        id: string;
+    }): Promise<CollectionType<'customer-profile-lists'> | null>;
+    updatePublicProfile(body: {
+        displayName?: string | null;
+        handle?: string | null;
+        avatar?: string | null;
+        bio?: string | null;
+        bioRichText?: CollectionType<'customer-profiles'>['bioRichText'];
+    }): Promise<CollectionType<'customer-profiles'>>;
 }
 
 interface ServerApiOptions {
@@ -191,6 +242,34 @@ declare abstract class BaseApi {
     protected request<T>(endpoint: string, body: unknown, options?: RequestOptions): Promise<T>;
 }
 
+type ModerationApiOptions = ServerApiOptions;
+interface CommunityBan {
+    id: string;
+    customer: string;
+    isPermanent?: boolean;
+    bannedUntil?: string;
+    reason?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    [key: string]: unknown;
+}
+type BanCustomerParams = {
+    customerId: string;
+    isPermanent?: boolean;
+    bannedUntil?: string;
+    reason?: string;
+};
+type UnbanCustomerParams = {
+    customerId: string;
+};
+declare class ModerationApi extends BaseApi {
+    constructor(options: ModerationApiOptions);
+    banCustomer(params: BanCustomerParams): Promise<CommunityBan>;
+    unbanCustomer(params: UnbanCustomerParams): Promise<{
+        success: true;
+    }>;
+}
+
 interface CustomerAuthResponse {
     token: string;
     customer: CustomerProfile;
@@ -384,19 +463,81 @@ declare class CartApi {
     }>;
 }
 
+type NormalizedOptionSwatch<TMedia = unknown> = {
+    type: 'color' | 'media' | null;
+    color?: string | null;
+    mediaItemId?: string | number | null;
+    /** Inlined swatch media when the API populated mediaItemId before pool indexing. */
+    inlineMedia?: TMedia | null;
+};
+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';
+/** @deprecated Use {@link ProductSelectionMediaSource} or {@link ProductDisplayMediaSource}. */
+type ProductMediaResolutionSource = ProductSelectionMediaSource | ProductDisplayMediaSource;
+type ProductSelectionVariant<TMedia> = {
+    id?: string | number | null;
+    images?: Array<TMedia | string | number | null | undefined> | null;
+};
+type ProductSelectionOptionValue = {
+    id?: string | number | null;
+    swatch?: NormalizedOptionSwatch<unknown> | null;
+};
+type ProductSelectionMediaPointer = string | number | {
+    id?: string | number | null;
+} | 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;
+};
+type ResolveProductSelectionMediaResult<TMedia> = {
+    primaryImage: TMedia | null;
+    images: TMedia[];
+    source: ProductSelectionMediaSource;
+};
+type ResolveProductDisplayMediaInput<TMedia> = {
+    productMediaPool?: TMedia[] | null;
+    productPrimaryMediaItemId?: ProductSelectionMediaPointer;
+    listingPrimaryImage?: ProductSelectionMediaPointer;
+};
+type ResolveProductDisplayMediaResult<TMedia> = {
+    primaryImage: TMedia | null;
+    images: TMedia[];
+    source: ProductDisplayMediaSource;
+};
+declare function resolveProductSelectionMedia<TMedia>(input: ResolveProductSelectionMediaInput<TMedia>): ResolveProductSelectionMediaResult<TMedia>;
+declare function resolveProductDisplayMedia<TMedia>(input: ResolveProductDisplayMediaInput<TMedia>): ResolveProductDisplayMediaResult<TMedia>;
+type ListingPrimaryImageFallbackInput<TMedia> = {
+    productMediaPool?: TMedia[] | null;
+    productPrimaryMediaItemId?: ProductSelectionMediaPointer;
+    productThumbnail?: TMedia | string | number | null;
+    listingPrimaryImage?: TMedia | string | number | null;
+    resolvedPrimary?: TMedia | null;
+    resolvedSource?: ProductMediaResolutionSource;
+};
+declare function resolveListingPrimaryImagePointer<TMedia>(input: ListingPrimaryImageFallbackInput<TMedia>): string | null;
+
 type EntityID = string;
 type RelationshipValue = string | number | null | undefined | {
     id?: string | number | null;
 };
 type MediaValue = ProductDetailMedia | null | undefined;
+
+/** Raw Payload / REST swatch before strict public normalization. */
+type ProductOptionValueSwatchInput = {
+    type?: 'color' | 'media' | null;
+    color?: string | null;
+    mediaItemId?: RelationshipValue;
+};
 interface ProductOptionValueShape {
     id?: string | number | null;
     option?: RelationshipValue;
     value?: string | null;
     slug?: string | null;
-    swatchColor?: string | null;
-    thumbnail?: MediaValue;
-    images?: MediaValue[] | null;
+    swatch?: ProductOptionValueSwatch | ProductOptionValueSwatchInput | null;
     _order?: string | null;
     '_product-option-values_values_order'?: string | null;
 }
@@ -426,7 +567,11 @@ interface ProductVariantShape {
 interface ProductListingProductShape {
     id?: EntityID;
     thumbnail?: MediaValue;
+    primaryMediaItemId?: MediaValue;
     images?: MediaValue[] | null;
+    listing?: {
+        primaryImage?: MediaValue;
+    } | null;
 }
 type ProductOptionMatrixValue = {
     id: string;
@@ -434,9 +579,7 @@ type ProductOptionMatrixValue = {
     optionSlug: string;
     label: string;
     slug: string | null;
-    swatchColor?: string | null;
-    thumbnail?: MediaValue;
-    images?: MediaValue[] | null;
+    swatch: ProductOptionValueSwatch;
     order: string;
 };
 type ProductOptionMatrixOption = {
@@ -477,12 +620,11 @@ type ProductListingProjection = {
 type ProductListingGroup<TVariant extends ProductVariantShape = ProductVariantShape> = {
     optionId: EntityID;
     optionTitle: string;
+    optionSlug: string;
     optionValueId: EntityID;
     optionValueLabel: string;
     optionValueSlug: string | null;
-    optionValueSwatchColor?: string | null;
-    optionValueThumbnail?: MediaValue;
-    optionValueImages?: MediaValue[] | null;
+    optionValueSwatch: ProductOptionValueSwatch;
     variantIds: EntityID[];
     variantCount: number;
     variants: TVariant[];
@@ -499,8 +641,7 @@ type ProductListingSwatch = {
     optionId: EntityID;
     optionValueId: EntityID;
     label: string;
-    swatchColor: string | null;
-    thumbnail: ProductDetailMedia | null;
+    swatch: ProductOptionValueSwatch<ProductDetailMedia>;
     href: string;
     availableForSale: boolean;
 };
@@ -539,27 +680,39 @@ type CompatibilityProductSelectionParamEvent = {
     searchParam: string;
 };
 type LegacyProductSelectionParamEvent = CompatibilityProductSelectionParamEvent;
+type ProductSelectionUrlEmit = 'slug-compat' | 'canonical-id';
 type ProductSelectionCodecOptions = {
+    emit?: ProductSelectionUrlEmit;
+    /**
+     * When true, `resolveProductSelection()` fills unselected options to reach a
+     * concrete variant. Does not change codec parse/stringify behavior.
+     */
+    fillDefaults?: boolean;
     onCompatibilityOptionIdParam?: (event: CompatibilityProductSelectionParamEvent) => void;
     onLegacyOptionIdParam?: (event: LegacyProductSelectionParamEvent) => void;
 };
 type ProductSelectionResolutionContext = {
-    detail?: Pick<ProductDetail, 'images' | 'listing'>;
+    detail?: Pick<ProductDetail, 'images' | 'listing' | 'primaryMediaItemId'>;
     images?: ProductDetail['images'];
     listing?: ProductDetail['listing'];
+    primaryMediaItemId?: ProductDetail['primaryMediaItemId'];
+};
+type ProductSelectionAvailableSwatch = {
+    color?: string | null;
+    image?: MediaValue | null;
 };
 type ProductSelectionAvailableValue = {
     valueId: string;
     value: string;
+    label: string;
     slug: string;
     selected: boolean;
     available: boolean;
+    exists: boolean;
     availableForSale: boolean;
     isUnlimited: boolean;
     availableStock: number | null;
-    swatchColor?: string | null;
-    thumbnail?: MediaValue;
-    images?: MediaValue[] | null;
+    swatch: ProductOptionValueSwatch;
 };
 type ProductSelectionResolution = {
     normalizedSelection: NormalizedProductSelection;
@@ -579,6 +732,7 @@ type ProductSelectionResolution = {
     media: {
         primaryImage: ProductDetailMedia | null;
         images: ProductDetailMedia[];
+        source?: ProductMediaResolutionSource;
     };
     stock: {
         availableForSale: boolean;
@@ -611,6 +765,7 @@ declare function createProductSelectionCodec(detail: ProductDetail, options?: Pr
 };
 declare function resolveProductSelectionFromMatrix(matrix: ProductOptionMatrix<ProductDetailVariant>, selection?: ProductSelectionInput, options?: ProductSelectionCodecOptions, context?: ProductSelectionResolutionContext): ProductSelectionResolution;
 declare function resolveProductSelection(detail: ProductDetail, selection?: ProductSelectionInput, options?: ProductSelectionCodecOptions): ProductSelectionResolution;
+declare function selectNext(detail: ProductDetail, current: ProductSelectionInput | undefined, optionSlug: string, valueSlug: string, options?: ProductSelectionCodecOptions): NormalizedProductSelection;
 type ProductDetailImageMedia = Extract<ProductDetailMedia, {
     id?: string | number | null;
     url?: string | null;
@@ -638,13 +793,18 @@ type ProductHrefOptions = {
     matrix?: ProductOptionMatrix<ProductDetailVariant>;
     selection?: ProductSelectionInput;
     trailingSlash?: boolean;
+    emit?: ProductSelectionUrlEmit;
+    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?: {
+type ProductListingCardOptions = {
     basePath?: string;
     trailingSlash?: boolean;
-}): ProductListingCard;
+    emit?: ProductSelectionUrlEmit;
+    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;
 /**
  * Builds product-first listing groups for one primary option.
  *
@@ -683,13 +843,18 @@ type ListingGroupsParams = {
     productIds: string[];
 };
 type ListingGroupingState = 'grouped' | 'no_primary_option' | 'empty';
+type ListingGroupingEmptyReason = 'primary_option_not_linked' | 'primary_option_has_no_values' | 'no_variants_for_primary_option';
 type ProductListingGroupVariant = Pick<ProductVariantShape, 'id' | 'optionValues' | 'price' | 'compareAtPrice' | 'stock' | 'isUnlimited' | 'isActive' | 'thumbnail' | 'images' | '_order'>;
 type ProductListingGroupSummary = ProductListingGroup<ProductListingGroupVariant>;
 type ProductListingGroupsProductVariants = NonNullable<PublicProduct['variants']>;
+type ProductListingGroupsProductPrimaryMediaItemId = string | number | {
+    id?: string | number | null;
+} | null;
 type ProductListingGroupsProduct = Omit<PublicProduct, 'variants'> & {
     id: string;
     slug: string;
     title: string;
+    primaryMediaItemId?: ProductListingGroupsProductPrimaryMediaItemId;
     variants?: (Omit<ProductListingGroupsProductVariants, 'docs'> & {
         docs: ProductListingGroupVariant[];
     }) | null;
@@ -698,6 +863,8 @@ type ProductListingGroupsItem = {
     product: ProductListingGroupsProduct;
     primaryOptionId: string | null;
     listingGroupingState: ListingGroupingState;
+    /** Present only when `listingGroupingState` is `empty`. */
+    listingGroupingEmptyReason: ListingGroupingEmptyReason | null;
     groups: ProductListingGroupSummary[];
 };
 type ProductListingGroupsResponse = {
@@ -735,6 +902,20 @@ type ProductDetailMedia = string | number | {
     width?: number | null;
     height?: number | null;
 };
+type ProductOptionValueColorSwatch = {
+    type: 'color';
+    color: string;
+    mediaItemId?: null;
+};
+type ProductOptionValueMediaSwatch<TMedia = ProductDetailMedia> = {
+    type: 'media';
+    mediaItemId: TMedia;
+    color?: null;
+};
+type ProductOptionValueSwatch<TMedia = ProductDetailMedia> = ProductOptionValueColorSwatch | ProductOptionValueMediaSwatch<TMedia> | null;
+type ProductUpsertSwatchInput = ProductOptionValueColorSwatch | ProductOptionValueMediaSwatch<string>;
+type ProductDetailMediaValue = string | number | ProductDetailMedia | null;
+type ProductDetailSelectionMediaSource = 'variant_media_selected' | 'variant_media_matching' | 'option_swatch' | 'none';
 interface ProductDetailVariant {
     id: string | number;
     optionKey: string;
@@ -749,15 +930,18 @@ interface ProductDetailVariant {
     isActive: boolean;
     thumbnail?: ProductDetailMedia | null;
     images?: ProductDetailMedia[];
+    media?: {
+        primaryImage: ProductDetailMedia | null;
+        images: ProductDetailMedia[];
+        source: ProductDetailSelectionMediaSource;
+    };
     optionValues: ProductDetailVariantOptionValue[];
 }
 interface ProductDetailOptionValue {
     id: string | number;
     value: string;
     slug: string;
-    swatchColor?: string | null;
-    thumbnail?: ProductDetailMedia | null;
-    images?: ProductDetailMedia[] | null;
+    swatch?: ProductOptionValueSwatch<ProductDetailMedia>;
 }
 interface ProductDetailOption {
     id: string | number;
@@ -802,6 +986,36 @@ interface ProductDetailListing {
     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[];
+    options: ProductDetail['options'];
+    brand: ProductDetail['brand'];
+    categories: ProductDetail['categories'];
+    tags: ProductDetail['tags'];
+    images: ProductDetail['images'];
+    videos: ProductDetail['videos'];
+    primaryMediaItemId?: ProductDetail['primaryMediaItemId'];
+    listing: ProductDetailCatalogListing;
+}
+type StockSnapshotItemStatus = 'available' | 'not_published' | 'archived' | 'not_found';
+interface StockSnapshotItem {
+    variantId: string;
+    status: StockSnapshotItemStatus;
+    availableStock: number;
+    availableForSale: boolean;
+    isUnlimited: boolean;
+}
+interface StockSnapshotResponse {
+    snapshots: StockSnapshotItem[];
+}
+type StockSnapshotParams = {
+    variantIds: string[];
+};
 interface ProductDetail {
     product: {
         id: string | number;
@@ -824,6 +1038,8 @@ interface ProductDetail {
     tags: ProductDetailTag[];
     images: ProductDetailImage[];
     videos: ProductDetailVideo[];
+    /** Canonical product primary pointer (pool member). */
+    primaryMediaItemId?: ProductDetailMediaValue;
     listing: ProductDetailListing;
 }
 type ProductDetailUnavailableReason = 'not_found' | 'not_published' | 'feature_disabled';
@@ -834,13 +1050,18 @@ type ProductDetailResult = {
     found: false;
     reason: ProductDetailUnavailableReason;
 };
+type ProductDetailCatalogResult = {
+    found: true;
+    product: ProductDetailCatalog;
+} | {
+    found: false;
+    reason: ProductDetailUnavailableReason;
+};
 type ProductUpsertOptionValueInput = {
     id?: string;
     value: string;
     slug?: string;
-    swatchColor?: string | null;
-    thumbnail?: string | null;
-    images?: string[];
+    swatch?: ProductUpsertSwatchInput | null;
     metadata?: unknown;
 };
 type ProductUpsertOptionInput = {
@@ -868,7 +1089,6 @@ type ProductUpsertVariantInput = {
     barcode?: string | null;
     externalId?: string | null;
     isActive?: boolean;
-    thumbnail?: string | null;
     images?: string[];
     metadata?: unknown;
 };
@@ -880,9 +1100,22 @@ type ProductUpsertParams = {
     options?: ProductUpsertOptionInput[];
     variants?: ProductUpsertVariantInput[];
 };
+/** Console `POST /api/products/upsert` field allowlist error reasons. */
+declare const PRODUCT_UPSERT_UNKNOWN_FIELD_REASON: "unknown_field";
+declare const PRODUCT_UPSERT_READONLY_FIELD_REASON: "product_field_readonly";
+type ProductUpsertFieldValidationErrorReason = typeof PRODUCT_UPSERT_UNKNOWN_FIELD_REASON | typeof PRODUCT_UPSERT_READONLY_FIELD_REASON;
+/** 400 response body when upsert rejects unknown or server-managed product fields. */
+type ProductUpsertFieldValidationErrorBody = {
+    error: string;
+    reason: ProductUpsertFieldValidationErrorReason;
+    field: string;
+    requestId?: string;
+};
+declare function isProductUpsertFieldValidationErrorBody(value: unknown): value is ProductUpsertFieldValidationErrorBody;
 type ProductUpsertResponse = {
     ok: true;
     product: PublicProduct;
+    listingProjectionStale: boolean;
 } | {
     ok: false;
     failedEntity: 'product' | 'option' | 'option-value' | 'variant';
@@ -897,7 +1130,9 @@ declare class ProductApi extends BaseApi {
      * to remain available by the time an order is placed.
      */
     stockCheck(params: StockCheckParams): Promise<StockCheckResponse>;
+    stockSnapshot(params: StockSnapshotParams): Promise<StockSnapshotResponse>;
     listingGroups(params: ListingGroupsParams): Promise<ProductListingGroupsResponse>;
+    listingGroupsCatalog(params: ListingGroupsParams): Promise<ProductListingGroupsResponse>;
     /**
      * Fetch full product detail by slug or id.
      * Returns a discriminated result so storefronts can distinguish missing,
@@ -909,6 +1144,7 @@ declare class ProductApi extends BaseApi {
      * errors instead of being collapsed into a storefront absence result.
      */
     detail(params: ProductDetailParams): Promise<ProductDetailResult>;
+    detailCatalog(params: ProductDetailParams): Promise<ProductDetailCatalogResult>;
     /**
      * Atomically create or update a product together with its options,
      * option-values, and variants in a single transaction. Mirrors Shopify's
@@ -957,6 +1193,14 @@ declare class ShippingApi extends BaseApi {
 }
 
 type OrderApiOptions = ServerApiOptions;
+/** Header-only; never sent in the JSON body. */
+type WithIdempotencyKey<T> = T & {
+    /**
+     * Client-generated key for safe retries. Sent as `X-Idempotency-Key` when the
+     * server endpoint supports HTTP idempotency.
+     */
+    idempotencyKey?: string;
+};
 type CustomerSnapshot = {
     name?: string;
     email: string;
@@ -984,7 +1228,7 @@ type CreateOrderItem = {
      */
     totalPrice?: number;
 };
-type CreateOrderParams = {
+type CreateOrderParams = WithIdempotencyKey<{
     orderNumber: string;
     customer?: string;
     customerSnapshot: CustomerSnapshot;
@@ -994,7 +1238,7 @@ type CreateOrderParams = {
     shippingAmount?: number;
     pgPaymentId?: string;
     discountCode?: string;
-};
+}>;
 type UpdateOrderParams = {
     orderNumber: string;
     status: Order['status'];
@@ -1008,7 +1252,7 @@ type UpdateTransactionParams = {
     paymentKey?: string;
     amount?: number;
 };
-type ConfirmPaymentParams = {
+type ConfirmPaymentParams = WithIdempotencyKey<{
     orderNumber?: string;
     pgPaymentId: string;
     pgProvider: string;
@@ -1019,16 +1263,58 @@ type ConfirmPaymentParams = {
     receiptUrl?: string;
     approvedAt?: string;
     providerStatus?: string;
+    /** Provider event id; also used as idempotency key when `idempotencyKey` is omitted. */
     providerEventId?: string;
     confirmationSource?: 'provider_webhook' | 'provider_lookup' | 'provider_api_confirm' | 'manual_server';
     metadata?: Record<string, unknown>;
-};
+}>;
 type ConfirmPaymentResponse = {
     orderId: string;
     transactionId: string;
     status: 'paid';
     alreadyConfirmed?: boolean;
 };
+type CancelReasonCode = 'customer' | 'inventory' | 'fraud' | 'declined' | 'staff' | 'other';
+type CancelOrderStatus = 'pending' | 'paid' | 'failed' | 'canceled' | 'refunded' | 'preparing' | 'shipped' | 'delivered' | 'confirmed' | 'return_requested' | 'return_processing' | 'returned';
+type CancelOrderReconciliationStatus = Exclude<CancelOrderStatus, 'pending' | 'failed' | 'canceled'>;
+type CancelOrderResponseBase = {
+    orderId: string;
+};
+type CancelOrderUnpaidResponseFields = {
+    refundedAmount: 0;
+    providerRefunded: false;
+};
+type CancelOrderAlreadyCanceledResponseFields = {
+    refundedAmount: number;
+    providerRefunded: false;
+};
+type CancelOrderProviderRefundResponseFields = {
+    transactionId: string;
+    refundedAmount: number;
+    refundSeq: number;
+    providerRefunded: true;
+};
+type CancelOrderCommittedResponse = CancelOrderResponseBase & (CancelOrderUnpaidResponseFields | CancelOrderProviderRefundResponseFields) & {
+    status: 'canceled';
+    cancelCommitted: true;
+};
+type CancelOrderAlreadyCanceledResponse = CancelOrderResponseBase & CancelOrderAlreadyCanceledResponseFields & {
+    status: 'canceled';
+    cancelCommitted: false;
+    alreadyCanceled: true;
+};
+type CancelOrderReconciliationResponse = CancelOrderResponseBase & CancelOrderProviderRefundResponseFields & {
+    status: CancelOrderReconciliationStatus;
+    cancelCommitted: false;
+    reconciliationRequired: true;
+};
+type CancelOrderResponse = CancelOrderCommittedResponse | CancelOrderAlreadyCanceledResponse | CancelOrderReconciliationResponse;
+type CancelOrderParams = {
+    orderNumber: string;
+    reasonCode?: CancelReasonCode;
+    reasonDetail?: string;
+    idempotencyKey?: string;
+};
 type RestockAction = 'return_to_stock' | 'discard';
 type ReturnWithRefundItem = {
     orderItem: string | number;
@@ -1036,7 +1322,7 @@ type ReturnWithRefundItem = {
     restockAction?: RestockAction;
     restockingFee?: number;
 };
-type ReturnWithRefundParams = {
+type ReturnWithRefundParams = WithIdempotencyKey<{
     orderNumber: string;
     reason?: ReturnReason;
     reasonDetail?: string;
@@ -1046,15 +1332,15 @@ type ReturnWithRefundParams = {
     pgPaymentId: string;
     paymentKey?: string;
     refundReceiptUrl?: string;
-};
-type CheckoutParams = {
+}>;
+type CheckoutParams = WithIdempotencyKey<{
     cartId: string;
     orderNumber: string;
     customerSnapshot: CustomerSnapshot;
     pgPaymentId?: string;
     discountCode?: string;
-};
-type CreateFulfillmentParams = {
+}>;
+type CreateFulfillmentParams = WithIdempotencyKey<{
     orderNumber: string;
     carrier?: string;
     trackingNumber?: string;
@@ -1062,7 +1348,7 @@ type CreateFulfillmentParams = {
         orderItem: string;
         quantity: number;
     }>;
-};
+}>;
 type UpdateFulfillmentParams = {
     fulfillmentId: string;
     status: 'packed' | 'shipped' | 'delivered' | 'failed';
@@ -1086,13 +1372,13 @@ type BulkImportFulfillmentsResponse = {
         error: string;
     }>;
 };
-type CreateReturnParams = {
+type CreateReturnParams = WithIdempotencyKey<{
     orderNumber: string;
     reason?: ReturnReason;
     reasonDetail?: string;
     returnItems: ReturnItem[];
     refundAmount: number;
-};
+}>;
 type UpdateReturnParams = {
     returnId: string;
     status: 'processing' | 'approved' | 'rejected' | 'completed';
@@ -1103,6 +1389,7 @@ declare class OrderApi extends BaseApi {
     updateOrder(params: UpdateOrderParams): Promise<Order>;
     updateTransaction(params: UpdateTransactionParams): Promise<Transaction>;
     confirmPayment(params: ConfirmPaymentParams): Promise<ConfirmPaymentResponse>;
+    cancelOrder(params: CancelOrderParams): Promise<CancelOrderResponse>;
     checkout(params: CheckoutParams): Promise<Order>;
     createFulfillment(params: CreateFulfillmentParams): Promise<Fulfillment>;
     updateFulfillment(params: UpdateFulfillmentParams): Promise<Fulfillment>;
@@ -1126,8 +1413,11 @@ interface CommerceClientOptions {
 declare class CommerceClient {
     readonly product: {
         stockCheck: (params: StockCheckParams) => Promise<StockCheckResponse>;
+        stockSnapshot: (params: StockSnapshotParams) => Promise<StockSnapshotResponse>;
         listingGroups: (params: ListingGroupsParams) => Promise<ProductListingGroupsResponse>;
+        listingGroupsCatalog: (params: ListingGroupsParams) => Promise<ProductListingGroupsResponse>;
         detail: (params: ProductDetailParams) => Promise<ProductDetailResult>;
+        detailCatalog: (params: ProductDetailParams) => Promise<ProductDetailCatalogResult>;
     };
     readonly cart: {
         get: (cartId: string) => Promise<Cart>;
@@ -1159,6 +1449,59 @@ declare class CommerceClient {
     constructor(options: CommerceClientOptions);
 }
 
+interface ServerCommerceClientOptions {
+    publishableKey?: string;
+    secretKey: string;
+    apiUrl?: string;
+    onRequestId?: (id: string | null) => void;
+}
+declare class ServerCommerceClient {
+    readonly product: {
+        stockCheck: (params: StockCheckParams) => Promise<StockCheckResponse>;
+        listingGroups: (params: ListingGroupsParams) => Promise<ProductListingGroupsResponse>;
+        detail: (params: ProductDetailParams) => Promise<ProductDetailResult>;
+        previewDetail: (params: ProductDetailPreviewParams, options: ProductDetailPreviewOptions) => Promise<ProductDetail | null>;
+        upsert: (params: ProductUpsertParams) => Promise<ProductUpsertResponse>;
+    };
+    readonly cart: {
+        get: (cartId: string) => Promise<Cart>;
+        addItem: (params: AddItemParams) => Promise<CartItem>;
+        updateItem: (params: UpdateItemParams) => Promise<CartItem>;
+        removeItem: (params: RemoveItemParams) => Promise<{
+            success: boolean;
+        }>;
+        applyDiscount: (params: ApplyDiscountParams) => Promise<Cart>;
+        removeDiscount: (params: RemoveDiscountParams) => Promise<Cart>;
+        clear: (params: ClearCartParams) => Promise<{
+            success: boolean;
+        }>;
+    };
+    readonly orders: {
+        checkout: (params: CheckoutParams) => Promise<Order>;
+        create: (params: CreateOrderParams) => Promise<Order>;
+        update: (params: UpdateOrderParams) => Promise<Order>;
+        updateTransaction: (params: UpdateTransactionParams) => Promise<Transaction>;
+        confirmPayment: (params: ConfirmPaymentParams) => Promise<ConfirmPaymentResponse>;
+        cancelOrder: (params: CancelOrderParams) => Promise<CancelOrderResponse>;
+        createFulfillment: (params: CreateFulfillmentParams) => Promise<Fulfillment>;
+        updateFulfillment: (params: UpdateFulfillmentParams) => Promise<Fulfillment>;
+        bulkImportFulfillments: (params: BulkImportFulfillmentsParams) => Promise<BulkImportFulfillmentsResponse>;
+        createReturn: (params: CreateReturnParams) => Promise<Return>;
+        updateReturn: (params: UpdateReturnParams) => Promise<Return>;
+        returnWithRefund: (params: ReturnWithRefundParams) => Promise<{
+            return: Return;
+            transaction: Transaction | null;
+        }>;
+    };
+    readonly discounts: {
+        validate: (params: ValidateDiscountParams) => Promise<ValidateDiscountResult>;
+    };
+    readonly shipping: {
+        calculate: (params: CalculateShippingParams) => Promise<CalculateShippingResult>;
+    };
+    constructor(options: ServerCommerceClientOptions);
+}
+
 /**
  * Customer namespace. Currently exposes .auth; reserved for future customer-
  * scoped capabilities (addresses, preferences, etc.).
@@ -1168,6 +1511,257 @@ declare class CustomerNamespace {
     constructor(publishableKey: string, options?: CustomerAuthOptions, apiUrl?: string);
 }
 
+interface EventsClientOptions {
+    publishableKey?: string;
+    apiUrl?: string;
+    customerToken?: string | (() => string | null);
+    onUnauthorized?: () => Promise<string | null>;
+    onRequestId?: (id: string | null) => void;
+}
+type EventsDateParam = string | Date;
+interface EventsRangeParams {
+    start: EventsDateParam;
+    end: EventsDateParam;
+    limit?: number;
+    page?: number;
+    calendar?: string | string[];
+    calendarSlug?: string | string[];
+    category?: string | string[];
+    categorySlug?: string | string[];
+    tag?: string | string[];
+    tagSlug?: string | string[];
+}
+interface EventsTaxonomyItem {
+    id: string | number;
+    title?: string | null;
+    slug?: string | null;
+    description?: string | null;
+    color?: string | null;
+}
+interface EventsCalendarItem extends EventsTaxonomyItem {
+    timezone?: string | null;
+    visibility?: string | null;
+}
+interface EventsLocation {
+    type?: string | null;
+    name?: string | null;
+    address?: string | null;
+    onlineUrl?: string | null;
+    onlineNote?: string | null;
+}
+interface EventsOccurrenceLocation {
+    name?: string | null;
+    address?: string | null;
+    onlineUrl?: string | null;
+    note?: string | null;
+}
+interface EventsExternalSource {
+    provider?: string | null;
+    url?: string | null;
+}
+interface EventsRangeEvent {
+    id: string | number;
+    title?: string | null;
+    slug?: string | null;
+    description?: string | null;
+    startsAt?: string | null;
+    endsAt?: string | null;
+    timezone?: string | null;
+    isAllDay: boolean;
+    visibility?: string | null;
+    sourceType?: string | null;
+    registrationPolicy?: string | null;
+    externalRegistrationUrl?: string | null;
+    externalSource: EventsExternalSource | null;
+    location: EventsLocation | null;
+    calendars: EventsCalendarItem[];
+    categories: EventsTaxonomyItem[];
+    tags: EventsTaxonomyItem[];
+}
+interface EventsRangeOccurrence {
+    id: string | number;
+    instanceKey?: string | null;
+    startsAt?: string | null;
+    endsAt?: string | null;
+    timezone?: string | null;
+    isAllDay: boolean;
+    status?: string | null;
+    capacity?: number;
+    registrationCount?: number;
+    waitlistCount?: number;
+    locationOverride: EventsOccurrenceLocation | null;
+    event: EventsRangeEvent;
+}
+interface EventsRangeResponse {
+    range: {
+        start: string;
+        end: string;
+    };
+    docs: EventsRangeOccurrence[];
+    calendars: EventsCalendarItem[];
+    events: EventsRangeEvent[];
+    categories: EventsTaxonomyItem[];
+    tags: EventsTaxonomyItem[];
+    totalDocs: number;
+    limit: number;
+    page: number;
+    totalPages: number;
+    hasNextPage: boolean;
+    hasPrevPage: boolean;
+}
+interface EventRegistrationAttendeeInput {
+    name?: string;
+    email?: string;
+    phone?: string;
+}
+interface EventRegistrationAnswerInput {
+    question: string;
+    answer?: string;
+}
+interface EventRegistrationRegisterParams {
+    event: string;
+    occurrence: string;
+    quantity?: number;
+    attendee?: EventRegistrationAttendeeInput;
+    answers?: EventRegistrationAnswerInput[];
+}
+interface EventRegistrationPublic {
+    id?: string | number;
+    event?: unknown;
+    occurrence?: unknown;
+    registrationStatus?: string | null;
+    attendanceStatus?: string | null;
+    quantity?: number | null;
+    guestTokenExpiresAt?: string | null;
+}
+interface EventGuestRegistration extends EventRegistrationPublic {
+    attendee: {
+        name: string | null;
+        email: string | null;
+        phone: string | null;
+    } | null;
+    attendeeEmail: string | null;
+    answers: Array<{
+        question: string;
+        answer?: string;
+    }>;
+}
+interface EventRegistrationRegisterResponse {
+    registration: EventRegistrationPublic;
+    guestToken: string;
+    guestTokenExpiresAt: string;
+}
+interface EventGuestRegistrationResponse {
+    registration: EventGuestRegistration;
+}
+interface EventGuestCancelParams {
+    reason?: string;
+}
+declare class EventsClient {
+    private readonly publishableKey;
+    private readonly apiUrl?;
+    private readonly customerToken?;
+    private readonly onUnauthorized?;
+    private readonly onRequestId?;
+    constructor(options: EventsClientOptions);
+    getRange(params: EventsRangeParams): Promise<EventsRangeResponse>;
+    register(params: EventRegistrationRegisterParams): Promise<EventRegistrationRegisterResponse>;
+    getGuestRegistration(token: string): Promise<EventGuestRegistrationResponse>;
+    cancelGuestRegistration(token: string, params?: EventGuestCancelParams): Promise<EventGuestRegistrationResponse>;
+    private execute;
+}
+
+type TenantIntrospectionApiOptions = ServerApiOptions;
+type TenantFeatureProgressFeature = 'ecommerce';
+interface TenantFeatureProgressInput {
+    feature: TenantFeatureProgressFeature;
+    includeEvidence?: boolean;
+}
+type TenantFeatureProgressStatus = 'ready' | 'attention' | 'blocked';
+type TenantFeatureProgressItemState = 'complete' | 'incomplete' | 'blocked' | 'attention' | 'optional' | 'unknown' | 'manual' | 'not-applicable';
+type TenantFeatureProgressSeverity = 'required' | 'recommended' | 'optional';
+type TenantFeatureProgressEvidenceValue = string | number | boolean | null;
+interface TenantFeatureProgressItem {
+    id: string;
+    title: string;
+    state: TenantFeatureProgressItemState;
+    severity: TenantFeatureProgressSeverity;
+    summary: string;
+    evidence?: Record<string, TenantFeatureProgressEvidenceValue>;
+}
+interface TenantFeatureProgressGroup {
+    id: string;
+    title: string;
+    summary?: string;
+    items: TenantFeatureProgressItem[];
+}
+interface TenantFeatureProgressResponse {
+    schemaVersion: 1;
+    feature: TenantFeatureProgressFeature;
+    status: TenantFeatureProgressStatus;
+    generatedAt: string;
+    tenant: {
+        id: string;
+        name: string;
+        plan: string;
+    };
+    capability: {
+        effectiveFeatures: string[];
+        planBlocked: string[];
+        closureAdded: string[];
+    };
+    summary: {
+        complete: number;
+        total: number;
+        blocking: number;
+        manual: number;
+        unknown: number;
+    };
+    groups: TenantFeatureProgressGroup[];
+}
+interface CollectionFieldSchema {
+    name: string;
+    path: string;
+    type: string;
+    required?: true;
+    unique?: true;
+    hasMany?: true;
+    relationTo?: string | string[];
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+    hidden?: true;
+    systemManaged?: true;
+    writable?: boolean;
+    fields?: CollectionFieldSchema[];
+}
+interface CollectionSchemaResponse {
+    contractVersion: 1;
+    mode: 'effective';
+    collection: {
+        slug: string;
+        timestamps: boolean;
+        alwaysActive: boolean;
+        feature: string | null;
+        systemFields: string[];
+        visibility: {
+            collectionHidden: boolean;
+            hiddenFields: string[];
+        };
+        fields: CollectionFieldSchema[];
+    };
+}
+interface TenantIntrospectionClient {
+    collectionSchema: (collection: string) => Promise<CollectionSchemaResponse>;
+    featureProgress: (params: TenantFeatureProgressInput) => Promise<TenantFeatureProgressResponse>;
+}
+declare class TenantIntrospectionApi extends BaseApi implements TenantIntrospectionClient {
+    constructor(options: TenantIntrospectionApiOptions);
+    collectionSchema(collection: string): Promise<CollectionSchemaResponse>;
+    featureProgress(params: TenantFeatureProgressInput): Promise<TenantFeatureProgressResponse>;
+}
+
 interface ClientConfig {
     publishableKey: string;
     /** API base URL for staging, self-hosted, preview, or proxy deployments. */
@@ -1319,21 +1913,63 @@ interface RootQueryLookup<T extends string> {
     }>;
 }
 type RootReadOnlyQueryBuilder<T extends PublicCollection> = RootQueryLookup<T>;
+interface RootServerQueryBuilder<T extends ServerCollection> extends RootQueryLookup<T> {
+    create(data: Partial<CollectionType<T>>, options?: {
+        file?: File | Blob;
+        filename?: string;
+    }): Promise<PayloadMutationResponse<CollectionType<T>>>;
+    update(id: string, data: Partial<CollectionType<T>>, options?: {
+        file?: File | Blob;
+        filename?: string;
+    }): Promise<PayloadMutationResponse<CollectionType<T>>>;
+    updateMany(where: ApiQueryOptions['where'], data: Partial<CollectionType<T>>): Promise<PayloadFindResponse<CollectionType<T>>>;
+    remove(id: string): Promise<CollectionType<T>>;
+    removeMany(where: ApiQueryOptions['where']): Promise<PayloadFindResponse<CollectionType<T>>>;
+}
 interface RootCollectionClient {
     from<T extends PublicCollection>(collection: T): RootReadOnlyQueryBuilder<T>;
 }
+interface RootServerCollectionClient {
+    from<T extends ServerCollection>(collection: T): RootServerQueryBuilder<T>;
+}
 interface RootClient {
     commerce: CommerceClient;
     community: CommunityClient;
+    /** Set on {@link createClient} return values; optional for structural mocks. */
+    events?: EventsClient;
     customer: CustomerNamespace;
     collections: RootCollectionClient;
     lastRequestId: string | null;
     getState(): ClientState;
     getConfig(): ClientConfig;
 }
+interface RootServerClient {
+    commerce: ServerCommerceClient;
+    tenant: TenantIntrospectionClient;
+    /** Set on {@link createServerClient} return values; optional for structural mocks. */
+    events?: EventsClient;
+    community: CommunityClient & {
+        moderation: {
+            banCustomer: (p: BanCustomerParams) => Promise<CommunityBan>;
+            unbanCustomer: (p: UnbanCustomerParams) => Promise<{
+                success: true;
+            }>;
+        };
+    };
+    collections: RootServerCollectionClient;
+    lastRequestId: string | null;
+    getState(): ClientState;
+    getConfig(): Omit<ClientServerConfig, 'secretKey'>;
+}
+type RootClientWithEvents = RootClient & {
+    events: EventsClient;
+};
+type RootServerClientWithEvents = RootServerClient & {
+    events: EventsClient;
+};
 type DeepPartial<T> = {
     [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
 };
 type ExtractArrayType<T> = T extends (infer U)[] ? U : never;
 
-export { type NormalizedProductSelection as $, type ApiQueryOptions as A, BaseApi as B, CommerceClient as C, type DebugConfig as D, type ExtractArrayType as E, type CreateFulfillmentParams as F, type CreateOrderItem as G, type CreateOrderParams as H, type CreateReturnParams as I, CustomerAuth as J, type CustomerAuthOptions as K, type CustomerAuthResponse as L, type CustomerLoginData as M, type CustomerProfile as N, type CustomerRefreshResponse as O, type PayloadFindResponse as P, type CustomerRegisterData as Q, type RetryConfig as R, type Sort as S, type CustomerRegisterResponse as T, type CustomerSnapshot as U, DiscountApi as V, type Where as W, type DiscountApiOptions as X, type LegacyProductSelectionParamEvent as Y, type ListingGroupingState as Z, type ListingGroupsParams as _, CommunityClient as a, type UpdateItemParams as a$, OrderApi as a0, type OrderApiOptions as a1, ProductApi as a2, type ProductApiOptions as a3, type ProductDetail as a4, type ProductDetailBrand as a5, type ProductDetailCategory as a6, type ProductDetailImage as a7, type ProductDetailImageMedia as a8, type ProductDetailListing as a9, type ProductOptionMatrixOption as aA, type ProductOptionMatrixValue as aB, type ProductOptionMatrixVariant as aC, type ProductOptionShape as aD, type ProductOptionValueShape as aE, type ProductSelectionAvailableValue as aF, type ProductSelectionByOptionValue as aG, ProductSelectionCodecError as aH, type ProductSelectionCodecOptions as aI, type ProductSelectionInput as aJ, type ProductSelectionResolution as aK, type ProductSelectionResolutionContext as aL, type ProductVariantShape as aM, type RemoveDiscountParams as aN, type RemoveItemParams as aO, type RequestOptions as aP, type ReturnItem as aQ, type ReturnReason as aR, type ReturnWithRefundItem as aS, type ReturnWithRefundParams as aT, type ServerApiOptions as aU, ShippingApi as aV, type ShippingApiOptions as aW, type StockCheckParams as aX, type StockCheckResponse as aY, type StockCheckResult as aZ, type UpdateFulfillmentParams as a_, type ProductDetailMedia as aa, type ProductDetailOption as ab, type ProductDetailOptionValue as ac, type ProductDetailParams as ad, type ProductDetailResult as ae, type ProductDetailTag as af, type ProductDetailUnavailableReason as ag, type ProductDetailVariant as ah, type ProductDetailVariantOptionValue as ai, type ProductDetailVideo as aj, type ProductHrefGroup as ak, type ProductHrefOptions as al, type ProductHrefProduct as am, type ProductListingCard as an, type ProductListingCardPriceRange as ao, type ProductListingCardRepresentativeVariant as ap, type ProductListingGroup as aq, type ProductListingGroupSummary as ar, type ProductListingGroupVariant as as, type ProductListingGroupsItem as at, type ProductListingGroupsProduct as au, type ProductListingGroupsResponse as av, type ProductListingProductShape as aw, type ProductListingProjection as ax, type ProductListingSwatch as ay, type ProductOptionMatrix as az, CustomerNamespace as b, type UpdateOrderParams as b0, type UpdateProfileData as b1, type UpdateReturnParams as b2, type UpdateTransactionParams as b3, type ValidateDiscountParams as b4, type ValidateDiscountResult as b5, buildProductHref as b6, buildProductListingCard as b7, buildProductListingGroupsByOption as b8, buildProductListingProjection as b9, buildProductOptionMatrix as ba, buildProductOptionMatrixFromDetail as bb, createProductSelectionCodec as bc, getAvailableOptionValues as bd, getProductSelectionImages as be, getSelectedValueByOptionId as bf, normalizeProductSelection as bg, normalizeProductSelectionFromMatrix as bh, normalizeSelectedValueIds as bi, parseProductSelection as bj, resolveProductSelection as bk, resolveProductSelectionFromMatrix as bl, resolveVariantForSelection as bm, stringifyProductSelection as bn, type ProductDetailPreviewParams as bo, type ProductDetailPreviewOptions as bp, type ProductUpsertParams as bq, type ProductUpsertResponse as br, type ClientServerConfig as bs, type ClientState as c, type ClientConfig as d, type ClientMetadata as e, type DeepPartial as f, type PayloadMutationResponse as g, type RootClient as h, type RootCollectionClient as i, type RootReadOnlyQueryBuilder as j, type AddItemParams as k, type ApplyDiscountParams as l, type BulkImportFulfillmentsParams as m, type BulkImportFulfillmentsResponse as n, type CalculateShippingParams as o, type CalculateShippingResult as p, CartApi as q, type CartApiOptions as r, type CheckoutParams as s, type ClearCartParams as t, type CommerceClientOptions as u, type CommunityClientOptions as v, type CommunityPost as w, type CompatibilityProductSelectionParamEvent as x, type ConfirmPaymentParams as y, type ConfirmPaymentResponse as z };
+export { type TenantFeatureProgressGroup as $, type ApiQueryOptions as A, BaseApi as B, CommerceClient as C, type DebugConfig as D, EventsClient as E, type EventRegistrationRegisterResponse as F, type EventsCalendarItem as G, type EventsClientOptions as H, type EventsDateParam as I, type EventsExternalSource as J, type EventsLocation as K, type EventsOccurrenceLocation as L, type EventsRangeEvent as M, type EventsRangeOccurrence as N, type EventsRangeParams as O, type PayloadFindResponse as P, type EventsRangeResponse as Q, type RetryConfig as R, type Sort as S, type TenantIntrospectionClient as T, type UnbanCustomerParams as U, type EventsTaxonomyItem as V, type Where as W, ModerationApi as X, type RootServerClient as Y, type TenantFeatureProgressEvidenceValue as Z, type TenantFeatureProgressFeature as _, CommunityClient as a, type ListingGroupingEmptyReason as a$, type TenantFeatureProgressInput as a0, type TenantFeatureProgressItem as a1, type TenantFeatureProgressItemState as a2, type TenantFeatureProgressResponse as a3, type TenantFeatureProgressSeverity as a4, type TenantFeatureProgressStatus as a5, TenantIntrospectionApi as a6, type TenantIntrospectionApiOptions as a7, CustomerAuth as a8, type CustomerProfile as a9, type CancelOrderResponse as aA, type CancelReasonCode as aB, CartApi as aC, type CartApiOptions as aD, type CheckoutParams as aE, type ClearCartParams as aF, type Comment as aG, type CommerceClientOptions as aH, type CommunityClientOptions as aI, type CommunityComment as aJ, type CommunityCommentListSort as aK, type CommunityPost as aL, type CommunityPostCategory as aM, type CommunityPostListSort as aN, type CommunityPostTag as aO, type CompatibilityProductSelectionParamEvent as aP, type ConfirmPaymentParams as aQ, type ConfirmPaymentResponse as aR, type CreateFulfillmentParams as aS, type CreateOrderItem as aT, type CreateOrderParams as aU, type CreateReturnParams as aV, type CustomerAuthOptions as aW, type CustomerSnapshot as aX, DiscountApi as aY, type DiscountApiOptions as aZ, type LegacyProductSelectionParamEvent as a_, 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 ProductDetailParams as ag, type ProductDetailResult as ah, type ProductListingGroupsItem as ai, type ProductDetail as aj, type ProductDetailCatalog as ak, type StockSnapshotResponse as al, type ProductSelectionMediaSource as am, type ProductDisplayMediaSource as an, type ResolveProductSelectionMediaInput as ao, type ResolveProductSelectionMediaResult as ap, type ProductSelectionMediaPointer as aq, type RootClientWithEvents as ar, type AddItemParams as as, type ApplyDiscountParams as at, type BulkImportFulfillmentsParams as au, type BulkImportFulfillmentsResponse as av, type CalculateShippingParams as aw, type CalculateShippingResult as ax, type CancelOrderParams as ay, type CancelOrderReconciliationStatus as az, CustomerNamespace as b, type ProductUpsertFieldValidationErrorBody as b$, type ListingGroupingState as b0, type ListingGroupsParams as b1, type ListingPrimaryImageFallbackInput as b2, type MediaValue as b3, type NormalizedOptionSwatch as b4, type NormalizedProductSelection as b5, OrderApi as b6, type OrderApiOptions as b7, PRODUCT_UPSERT_READONLY_FIELD_REASON as b8, PRODUCT_UPSERT_UNKNOWN_FIELD_REASON as b9, type ProductListingGroupSummary as bA, type ProductListingGroupVariant as bB, type ProductListingGroupsProduct as bC, type ProductListingGroupsResponse as bD, type ProductListingProductShape as bE, type ProductListingProjection as bF, type ProductListingSwatch as bG, type ProductMediaResolutionSource as bH, type ProductOptionMatrix as bI, type ProductOptionMatrixOption as bJ, type ProductOptionMatrixValue as bK, type ProductOptionMatrixVariant as bL, type ProductOptionShape as bM, type ProductOptionValueShape as bN, type ProductOptionValueSwatch as bO, type ProductOptionValueSwatchInput as bP, type ProductSelectionAvailableSwatch as bQ, type ProductSelectionAvailableValue as bR, type ProductSelectionByOptionValue as bS, ProductSelectionCodecError as bT, type ProductSelectionCodecOptions as bU, type ProductSelectionInput as bV, type ProductSelectionOptionValue as bW, type ProductSelectionResolution as bX, type ProductSelectionResolutionContext as bY, type ProductSelectionUrlEmit as bZ, type ProductSelectionVariant as b_, ProductApi as ba, type ProductApiOptions as bb, type ProductDetailBrand as bc, type ProductDetailCatalogListing as bd, type ProductDetailCatalogResult as be, type ProductDetailCatalogVariant as bf, type ProductDetailCategory as bg, type ProductDetailImage as bh, type ProductDetailImageMedia as bi, type ProductDetailListing as bj, type ProductDetailMedia as bk, type ProductDetailOption as bl, type ProductDetailOptionValue as bm, type ProductDetailTag as bn, type ProductDetailUnavailableReason as bo, type ProductDetailVariant as bp, type ProductDetailVariantOptionValue as bq, type ProductDetailVideo as br, type ProductHrefGroup as bs, type ProductHrefOptions as bt, type ProductHrefProduct as bu, type ProductListingCard as bv, type ProductListingCardOptions as bw, type ProductListingCardPriceRange as bx, type ProductListingCardRepresentativeVariant as by, type ProductListingGroup as bz, type ClientState as c, type ProductUpsertFieldValidationErrorReason as c0, type ProductVariantShape as c1, type RemoveDiscountParams as c2, type RemoveItemParams as c3, type RequestOptions as c4, type ResolveProductDisplayMediaInput as c5, type ResolveProductDisplayMediaResult as c6, type ReturnItem as c7, type ReturnReason as c8, type ReturnWithRefundItem as c9, isProductUpsertFieldValidationErrorBody as cA, normalizeProductSelection as cB, normalizeProductSelectionFromMatrix as cC, normalizeSelectedValueIds as cD, parseProductSelection as cE, resolveListingPrimaryImagePointer as cF, resolveProductDisplayMedia as cG, resolveProductSelection as cH, resolveProductSelectionFromMatrix as cI, resolveProductSelectionMedia as cJ, resolveVariantForSelection as cK, selectNext as cL, selectedSwatchMediaItemId as cM, stringifyProductSelection as cN, type ReturnWithRefundParams as ca, ShippingApi as cb, type ShippingApiOptions as cc, type StockCheckParams as cd, type StockCheckResponse as ce, type StockCheckResult as cf, type StockSnapshotItem as cg, type StockSnapshotParams as ch, type UpdateFulfillmentParams as ci, type UpdateItemParams as cj, type UpdateOrderParams as ck, type UpdateReturnParams as cl, type UpdateTransactionParams as cm, type ValidateDiscountParams as cn, type ValidateDiscountResult as co, type WithIdempotencyKey as cp, buildProductHref as cq, buildProductListingCard as cr, buildProductListingGroupsByOption as cs, buildProductListingProjection as ct, buildProductOptionMatrix as cu, buildProductOptionMatrixFromDetail as cv, createProductSelectionCodec as cw, getAvailableOptionValues as cx, getProductSelectionImages as cy, getSelectedValueByOptionId as cz, type ClientConfig as d, type ClientMetadata as e, type DeepPartial as f, type ExtractArrayType as g, type PayloadMutationResponse as h, type RootClient as i, type RootCollectionClient as j, type RootReadOnlyQueryBuilder as k, type ServerApiOptions as l, ServerCommerceClient as m, type BanCustomerParams as n, type CommunityBan as o, type ClientServerConfig as p, type RootServerClientWithEvents as q, type CollectionFieldSchema as r, type CollectionSchemaResponse as s, type EventGuestCancelParams as t, type EventGuestRegistration as u, type EventGuestRegistrationResponse as v, type EventRegistrationAnswerInput as w, type EventRegistrationAttendeeInput as x, type EventRegistrationPublic as y, type EventRegistrationRegisterParams as z };