@01.software/sdk 0.32.0 → 0.34.0

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

@@ -1,6 +1,6 @@
-import { P as PublicCollection } from './const-Brk2Ff0q.cjs';
-import { P as PublicProduct, C as CollectionType } from './types-ByMrR_Z_.cjs';
-import { O as Order, i as Cart, j as CartItem, m as Transaction, n as Fulfillment, o as Return } from './payload-types-DVK1QCeU.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,15 +641,16 @@ type ProductListingSwatch = {
     optionId: EntityID;
     optionValueId: EntityID;
     label: string;
-    swatchColor: string | null;
-    thumbnail: ProductDetailMedia | null;
+    swatch: ProductOptionValueSwatch<ProductDetailMedia>;
     href: string;
     availableForSale: boolean;
 };
+type ProductListingCardRepresentativeVariant = ProductListingGroupsItem['groups'][number]['variants'][number];
 type ProductListingCard = {
     id: EntityID;
     href: string;
     title: string;
+    representativeVariant?: ProductListingCardRepresentativeVariant | null;
     primaryImage: ProductDetailMedia | null;
     priceRange: ProductListingCardPriceRange;
     availableForSale: boolean;
@@ -537,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;
@@ -577,6 +732,7 @@ type ProductSelectionResolution = {
     media: {
         primaryImage: ProductDetailMedia | null;
         images: ProductDetailMedia[];
+        source?: ProductMediaResolutionSource;
     };
     stock: {
         availableForSale: boolean;
@@ -609,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;
@@ -636,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.
  *
@@ -681,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;
@@ -696,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 = {
@@ -733,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;
@@ -747,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;
@@ -800,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;
@@ -810,8 +1026,9 @@ interface ProductDetail {
         content?: unknown;
         publishedAt?: string | null;
         status: string;
-        totalInventory: number;
+        totalInventory: number | null;
         totalVariants: number;
+        hasUnlimitedVariant: boolean;
         hasOnlyDefaultVariant: boolean;
     };
     variants: ProductDetailVariant[];
@@ -821,15 +1038,30 @@ 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';
+type ProductDetailResult = {
+    found: true;
+    product: ProductDetail;
+} | {
+    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 = {
@@ -857,7 +1089,6 @@ type ProductUpsertVariantInput = {
     barcode?: string | null;
     externalId?: string | null;
     isActive?: boolean;
-    thumbnail?: string | null;
     images?: string[];
     metadata?: unknown;
 };
@@ -869,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';
@@ -886,14 +1130,21 @@ 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 `null` on 404 regardless of reason (`not_found` / `not_published` /
-     * `feature_disabled`). For the reason behind a null,
-     * inspect `client.lastRequestId` against backend logs.
+     * Returns a discriminated result so storefronts can distinguish missing,
+     * unpublished, and feature-disabled products.
+     *
+     * Only product-detail 404 responses carrying one of those allowlisted reasons
+     * are mapped to `{ found: false, reason }`. Unknown or uncoded 404s, plus
+     * permission/auth errors such as tenant mismatch, continue to throw typed SDK
+     * errors instead of being collapsed into a storefront absence result.
      */
-    detail(params: ProductDetailParams): Promise<ProductDetail | null>;
+    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
@@ -942,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;
@@ -969,7 +1228,7 @@ type CreateOrderItem = {
      */
     totalPrice?: number;
 };
-type CreateOrderParams = {
+type CreateOrderParams = WithIdempotencyKey<{
     orderNumber: string;
     customer?: string;
     customerSnapshot: CustomerSnapshot;
@@ -979,7 +1238,7 @@ type CreateOrderParams = {
     shippingAmount?: number;
     pgPaymentId?: string;
     discountCode?: string;
-};
+}>;
 type UpdateOrderParams = {
     orderNumber: string;
     status: Order['status'];
@@ -993,7 +1252,7 @@ type UpdateTransactionParams = {
     paymentKey?: string;
     amount?: number;
 };
-type ConfirmPaymentParams = {
+type ConfirmPaymentParams = WithIdempotencyKey<{
     orderNumber?: string;
     pgPaymentId: string;
     pgProvider: string;
@@ -1004,40 +1263,84 @@ 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;
     quantity: number;
     restockAction?: RestockAction;
+    restockingFee?: number;
 };
-type ReturnWithRefundParams = {
+type ReturnWithRefundParams = WithIdempotencyKey<{
     orderNumber: string;
     reason?: ReturnReason;
     reasonDetail?: string;
     returnItems: ReturnWithRefundItem[];
     refundAmount: number;
+    returnShippingFee?: number;
     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;
@@ -1045,7 +1348,7 @@ type CreateFulfillmentParams = {
         orderItem: string;
         quantity: number;
     }>;
-};
+}>;
 type UpdateFulfillmentParams = {
     fulfillmentId: string;
     status: 'packed' | 'shipped' | 'delivered' | 'failed';
@@ -1069,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';
@@ -1086,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>;
@@ -1109,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>;
-        detail: (params: ProductDetailParams) => Promise<ProductDetail | null>;
+        listingGroupsCatalog: (params: ListingGroupsParams) => Promise<ProductListingGroupsResponse>;
+        detail: (params: ProductDetailParams) => Promise<ProductDetailResult>;
+        detailCatalog: (params: ProductDetailParams) => Promise<ProductDetailCatalogResult>;
     };
     readonly cart: {
         get: (cartId: string) => Promise<Cart>;
@@ -1142,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.).
@@ -1151,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. */
@@ -1302,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 UpdateTransactionParams 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 ProductOptionShape as aA, type ProductOptionValueShape as aB, type ProductSelectionAvailableValue as aC, type ProductSelectionByOptionValue as aD, ProductSelectionCodecError as aE, type ProductSelectionCodecOptions as aF, type ProductSelectionInput as aG, type ProductSelectionResolution as aH, type ProductSelectionResolutionContext as aI, type ProductVariantShape as aJ, type RemoveDiscountParams as aK, type RemoveItemParams as aL, type RequestOptions as aM, type ReturnItem as aN, type ReturnReason as aO, type ReturnWithRefundParams as aP, type ServerApiOptions as aQ, ShippingApi as aR, type ShippingApiOptions as aS, type StockCheckParams as aT, type StockCheckResponse as aU, type StockCheckResult as aV, type UpdateFulfillmentParams as aW, type UpdateItemParams as aX, type UpdateOrderParams as aY, type UpdateProfileData as aZ, type UpdateReturnParams as a_, type ProductDetailMedia as aa, type ProductDetailOption as ab, type ProductDetailOptionValue as ac, type ProductDetailParams as ad, type ProductDetailTag as ae, type ProductDetailVariant as af, type ProductDetailVariantOptionValue as ag, type ProductDetailVideo as ah, type ProductHrefGroup as ai, type ProductHrefOptions as aj, type ProductHrefProduct as ak, type ProductListingCard as al, type ProductListingCardPriceRange as am, type ProductListingGroup as an, type ProductListingGroupSummary as ao, type ProductListingGroupVariant as ap, type ProductListingGroupsItem as aq, type ProductListingGroupsProduct as ar, type ProductListingGroupsResponse as as, type ProductListingProductShape as at, type ProductListingProjection as au, type ProductListingSwatch as av, type ProductOptionMatrix as aw, type ProductOptionMatrixOption as ax, type ProductOptionMatrixValue as ay, type ProductOptionMatrixVariant as az, CustomerNamespace as b, type ValidateDiscountParams as b0, type ValidateDiscountResult as b1, buildProductHref as b2, buildProductListingCard as b3, buildProductListingGroupsByOption as b4, buildProductListingProjection as b5, buildProductOptionMatrix as b6, buildProductOptionMatrixFromDetail as b7, createProductSelectionCodec as b8, getAvailableOptionValues as b9, getProductSelectionImages as ba, getSelectedValueByOptionId as bb, normalizeProductSelection as bc, normalizeProductSelectionFromMatrix as bd, normalizeSelectedValueIds as be, parseProductSelection as bf, resolveProductSelection as bg, resolveProductSelectionFromMatrix as bh, resolveVariantForSelection as bi, stringifyProductSelection as bj, type ProductDetailPreviewParams as bk, type ProductDetailPreviewOptions as bl, type ProductUpsertParams as bm, type ProductUpsertResponse as bn, type ClientServerConfig as bo, 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 };