@01.software/sdk 0.12.0 → 0.13.0

package/dist/index.d.ts

@@ -1,22 +1,17 @@
-import { O as Order, a as OrderItem$1, T as Transaction, b as Fulfillment, R as Return, c as Cart, d as CartItem, P as Product } from './payload-types-BX9al1wy.js';
-export { D as Document, I as Image, e as Post, f as PostCategory, g as PostTag, h as ProductVariant, i as Tenant, V as Video } from './payload-types-BX9al1wy.js';
+import { O as Order, a as Cart, b as CartItem, P as Product, c as OrderItem$1, T as Transaction, d as Fulfillment, R as Return } from './payload-types-DqX4iuTW.js';
+export { D as Document, I as Image, e as Post, f as PostCategory, g as PostTag, h as ProductVariant, i as Tenant, V as Video } from './payload-types-DqX4iuTW.js';
 import { Sort, Where } from 'payload';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient, InfiniteData } from '@tanstack/react-query';
 import { Metadata } from 'next';
-import { P as PublicCollection } from './const-CWbOFesW.js';
-export { a as COLLECTIONS, C as Collection } from './const-CWbOFesW.js';
-import { C as CollectionType } from './webhook-I-iZO5-K.js';
-export { a as WebhookEvent, b as WebhookHandler, W as WebhookOperation, c as WebhookOptions, d as createTypedWebhookHandler, h as handleWebhook, i as isValidWebhookEvent } from './webhook-I-iZO5-K.js';
+import { C as CollectionType } from './webhook-CX21PpBt.js';
+export { a as WebhookEvent, b as WebhookHandler, W as WebhookOperation, c as WebhookOptions, d as createTypedWebhookHandler, h as handleWebhook, i as isValidWebhookEvent } from './webhook-CX21PpBt.js';
+import { P as PublicCollection } from './const-DSTPrI77.js';
+export { a as COLLECTIONS, C as Collection } from './const-DSTPrI77.js';
 export { a as RealtimeConnection, R as RealtimeEvent, b as RealtimeListener } from './realtime-D7HtUpqt.js';
 export { b as IMAGE_SIZES, I as ImageData, a as ImagePalette, f as ImagePlaceholderOptions, d as getImageLqip, e as getImagePalette, h as getImagePlaceholderStyle, c as getImageSrcSet, g as getImageUrl } from './image-TT8lTsk5.js';
 export { e as VideoGifOptions, V as VideoThumbnailOptions, a as getVideoGif, c as getVideoMp4Url, d as getVideoStoryboard, b as getVideoStreamUrl, g as getVideoThumbnail } from './video-DbLL8yuc.js';
 
-/**
- * API URL을 반환합니다.
- * 환경변수 SOFTWARE_API_URL 또는 NEXT_PUBLIC_SOFTWARE_API_URL로 오버라이드 가능.
- * 빌드 시 버전에 따라 기본값 결정: dev 빌드 → api-dev, 정식 → api.01.software
- */
 declare function resolveApiUrl(): string;
 interface ClientConfig {
     publishableKey: string;
@@ -43,6 +38,13 @@ interface ClientConfig {
 }
 interface ClientServerConfig extends ClientConfig {
     secretKey: string;
+    /**
+     * Tenant ID for pat01_ API keys. When provided alongside a pat01_ key,
+     * every server request includes X-Tenant-Id so the API can scope the
+     * request to the correct tenant. Not needed for sk01_ keys (tenant is
+     * encoded in the key itself).
+     */
+    tenantId?: string;
 }
 interface ClientMetadata {
     userAgent?: string;
@@ -88,6 +90,13 @@ interface PayloadMutationResponse<T = unknown> {
     doc: T;
     errors?: unknown[];
 }
+/**
+ * Do NOT replace with `Pick<FindOptions>` from `payload`. Payload's generic
+ * types (`JoinQuery<TSlug>`, `PopulateType`) depend on `PayloadTypes` module
+ * augmentation; external SDK consumers who skip that get degenerate types
+ * (`never` / `{}`). Only non-generic `Sort`/`Where` are safe to import.
+ * Excluded vs native: Local-API-only fields, `locale`/`fallbackLocale`.
+ */
 interface ApiQueryOptions {
     page?: number;
     limit?: number;
@@ -105,6 +114,12 @@ interface ApiQueryOptions {
         where?: Where;
         count?: boolean;
     } | false> | false;
+    /** Set to `false` to skip the count query — returns docs without totalDocs/totalPages */
+    pagination?: boolean;
+    /** Include draft versions (access control still applies on the server) */
+    draft?: boolean;
+    /** Include soft-deleted documents (requires `trash` enabled on the collection) */
+    trash?: boolean;
 }
 interface DebugConfig {
     logRequests?: boolean;
@@ -121,357 +136,137 @@ type DeepPartial<T> = {
 };
 type ExtractArrayType<T> = T extends (infer U)[] ? U : never;
 
-interface ServerApiOptions {
-    publishableKey?: string;
-    secretKey: string;
-}
-interface RequestOptions {
-    method?: 'GET' | 'POST' | 'PATCH' | 'DELETE';
-    headers?: Record<string, string>;
-}
-declare abstract class BaseApi {
-    protected readonly publishableKey: string;
-    protected readonly secretKey: string;
-    constructor(apiName: string, options: ServerApiOptions);
-    protected request<T>(endpoint: string, body: unknown, options?: RequestOptions): Promise<T>;
-}
-
-type OrderApiOptions = ServerApiOptions;
-type CustomerSnapshot = {
-    name?: string;
-    email: string;
-    phone?: string;
-};
-type ReturnReason = 'change_of_mind' | 'defective' | 'wrong_delivery' | 'damaged' | 'other';
-type ReturnProductItem = {
-    orderItem: string;
-    quantity: number;
-};
-type CreateOrderParams = {
-    orderNumber: string;
-    customer?: string;
-    customerSnapshot: CustomerSnapshot;
-    shippingAddress: Order['shippingAddress'];
-    orderProducts: Pick<OrderItem$1, 'product' | 'variant' | 'quantity' | 'unitPrice' | 'totalPrice'>[];
-    totalAmount: number;
-    shippingFee?: number;
-    paymentId?: string;
-    discountCode?: string;
-};
-type UpdateOrderParams = {
-    orderNumber: string;
-    status: Order['status'];
-};
-type UpdateTransactionParams = {
-    paymentId: string;
-    status: Transaction['status'];
-    paymentMethod?: string;
-    receiptUrl?: string;
-};
-type CheckoutParams = {
-    cartId: string;
-    orderNumber: string;
-    customerSnapshot: CustomerSnapshot;
-    paymentId?: string;
-    discountCode?: string;
-};
-type ValidateDiscountParams = {
-    code: string;
-    orderAmount: number;
-    customerId?: string;
-};
-type ValidateDiscountResult = {
-    valid: boolean;
-    code: string;
-    type?: 'percentage' | 'fixed_amount' | 'free_shipping' | 'tiered';
-    discountAmount: number;
-    freeShipping?: boolean;
-    reason?: string;
-};
-type CalculateShippingParams = {
-    shippingPolicyId?: string;
-    orderAmount: number;
-    postalCode?: string;
-};
-type CalculateShippingResult = {
-    shippingFee: number;
-    baseAmount: number;
-    extraFee: number;
-    freeShipping: boolean;
-    freeShippingMinAmount: number | null;
-    isJeju: boolean;
-    isRemoteIsland: boolean;
-};
-type CreateFulfillmentParams = {
-    orderNumber: string;
-    carrier?: string;
-    trackingNumber?: string;
-    items: Array<{
-        orderItem: string;
-        quantity: number;
-    }>;
-};
-type UpdateFulfillmentParams = {
-    fulfillmentId: string;
-    status: 'packed' | 'shipped' | 'delivered' | 'failed';
-    carrier?: string;
-    trackingNumber?: string;
-};
-type GetOrderParams = {
-    orderNumber: string;
-};
-type CreateReturnParams = {
-    orderNumber: string;
-    reason?: ReturnReason;
-    reasonDetail?: string;
-    returnProducts: ReturnProductItem[];
-    refundAmount: number;
-};
-type UpdateReturnParams = {
-    returnId: string;
-    status: 'processing' | 'approved' | 'rejected' | 'completed';
-};
-type ReturnWithRefundParams = {
-    orderNumber: string;
-    reason?: ReturnReason;
-    reasonDetail?: string;
-    returnProducts: ReturnProductItem[];
-    refundAmount: number;
-    paymentId: string;
-    refundReceiptUrl?: string;
-};
-declare class OrderApi extends BaseApi {
-    constructor(options: OrderApiOptions);
-    createOrder(params: CreateOrderParams): Promise<Order>;
-    updateOrder(params: UpdateOrderParams): Promise<Order>;
-    getOrder(params: GetOrderParams): Promise<Order>;
-    updateTransaction(params: UpdateTransactionParams): Promise<Transaction>;
-    checkout(params: CheckoutParams): Promise<Order>;
-    createFulfillment(params: CreateFulfillmentParams): Promise<Fulfillment>;
-    updateFulfillment(params: UpdateFulfillmentParams): Promise<Fulfillment>;
-    returnWithRefund(params: ReturnWithRefundParams): Promise<{
-        return: Return;
-        transaction: Transaction | null;
-    }>;
-    createReturn(params: CreateReturnParams): Promise<Return>;
-    updateReturn(params: UpdateReturnParams): Promise<Return>;
-    validateDiscount(params: ValidateDiscountParams): Promise<ValidateDiscountResult>;
-    calculateShipping(params: CalculateShippingParams): Promise<CalculateShippingResult>;
-}
-
-interface CartApiOptions {
-    publishableKey?: string;
-    secretKey?: string;
-    customerToken?: string | (() => string | null);
-    onUnauthorized?: () => Promise<string | null>;
-}
-type AddItemParams = {
-    cartId: string;
-    product: string;
-    variant: string;
-    option: string;
-    quantity: number;
-};
-type UpdateItemParams = {
-    cartItemId: string;
-    quantity: number;
-};
-type RemoveItemParams = {
-    cartItemId: string;
-};
-type ApplyDiscountParams = {
-    cartId: string;
-    discountCode: string;
-};
-type RemoveDiscountParams = {
-    cartId: string;
-};
-type ClearCartParams = {
-    cartId: string;
-};
-declare class CartApi {
-    private readonly publishableKey;
-    private readonly secretKey?;
-    private readonly customerToken?;
-    private readonly onUnauthorized?;
-    constructor(options: CartApiOptions);
-    private execute;
-    getCart(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>;
-    clearCart(params: ClearCartParams): Promise<{
-        success: boolean;
-    }>;
+interface GenerateMetadataOptions {
+    siteName?: string;
 }
 
-type EntityID = string;
-type RelationshipValue = string | number | null | undefined | {
-    id?: string | number | null;
-};
-type MediaValue = {
-    id?: EntityID | null;
-} | EntityID | null | undefined;
-interface ProductOptionValueShape {
-    id?: string | number | null;
-    option?: RelationshipValue;
-    value?: string | null;
-    slug?: string | null;
-    _order?: string | null;
-    '_product-option-values_values_order'?: string | null;
-}
-interface ProductOptionShape {
-    id?: string | number | null;
-    title?: string | null;
-    _order?: string | null;
-    '_product-options_options_order'?: string | null;
-    values?: {
-        docs?: unknown[];
-    } | null;
-}
-interface ProductVariantShape {
-    id?: string | number | null;
-    optionValues?: unknown[] | null;
-    price?: number | null;
-    compareAtPrice?: number | null;
-    stock?: number | null;
-    isUnlimited?: boolean | null;
-    isActive?: boolean | null;
-    thumbnail?: MediaValue;
-    images?: MediaValue[] | null;
-    _order?: string | null;
-}
-interface ProductListingProductShape {
-    id?: EntityID;
-    thumbnail?: MediaValue;
-    images?: MediaValue[] | null;
-}
-type ProductOptionMatrixValue = {
-    id: string;
-    optionId: string;
-    label: string;
-    slug: string | null;
-    order: string;
-};
-type ProductOptionMatrixOption = {
-    id: string;
-    title: string;
-    order: string;
-    values: ProductOptionMatrixValue[];
-};
-type ProductOptionMatrixVariant<TVariant extends ProductVariantShape = ProductVariantShape> = {
-    id: string;
-    optionValueIds: string[];
-    optionValueByOptionId: Map<string, string>;
-    source: TVariant;
-};
-type ProductOptionMatrix<TVariant extends ProductVariantShape = ProductVariantShape> = {
-    options: ProductOptionMatrixOption[];
-    optionIds: string[];
-    optionById: Map<string, ProductOptionMatrixOption>;
-    valueById: Map<string, ProductOptionMatrixValue>;
-    valueToOptionId: Map<string, string>;
-    variants: ProductOptionMatrixVariant<TVariant>[];
-};
-type ProductListingProjection = {
-    selectionHintVariant: EntityID | null;
-    primaryImage: EntityID | null;
-    minPrice: number | null;
-    maxPrice: number | null;
-    minCompareAtPrice: number | null;
-    maxCompareAtPrice: number | null;
-    isPriceRange: boolean;
-    availableForSale: boolean;
-};
-type ProductListingGroup<TVariant extends ProductVariantShape = ProductVariantShape> = {
-    optionId: EntityID;
-    optionTitle: string;
-    optionValueId: EntityID;
-    optionValueLabel: string;
-    optionValueSlug: string | null;
-    variantIds: EntityID[];
-    variantCount: number;
-    variants: TVariant[];
-    listing: ProductListingProjection;
-};
-declare function buildProductOptionMatrix<TVariant extends ProductVariantShape = ProductVariantShape>({ options, variants, }: {
-    options: ProductOptionShape[];
-    variants?: TVariant[];
-}): ProductOptionMatrix<TVariant>;
-declare function getSelectedValueByOptionId<TVariant extends ProductVariantShape = ProductVariantShape>(matrix: ProductOptionMatrix<TVariant>, selectedValueIds: Iterable<unknown>): Map<string, string>;
-declare function normalizeSelectedValueIds<TVariant extends ProductVariantShape = ProductVariantShape>(matrix: ProductOptionMatrix<TVariant>, selectedValueIds: Iterable<unknown>): string[];
-declare function getAvailableOptionValues<TVariant extends ProductVariantShape = ProductVariantShape>(matrix: ProductOptionMatrix<TVariant>, optionId: string, selectedValueIds: Iterable<unknown>): ProductOptionMatrixValue[];
-declare function resolveVariantForSelection<TVariant extends ProductVariantShape = ProductVariantShape>(matrix: ProductOptionMatrix<TVariant>, selectedValueIds: Iterable<unknown>): ProductOptionMatrixVariant<TVariant> | undefined;
-declare function buildProductListingProjection(product: ProductListingProductShape | null | undefined, variants: ProductVariantShape[]): ProductListingProjection;
-declare function buildProductListingGroupsByOption<TVariant extends ProductVariantShape = ProductVariantShape>(args: {
-    product: ProductListingProductShape | null | undefined;
-    options: ProductOptionShape[];
-    variants: TVariant[];
-    primaryOptionId?: string | null;
-}): ProductListingGroup<TVariant>[];
-
-type ProductApiOptions = ServerApiOptions;
-type StockCheckParams = {
-    items: Array<{
-        variantId: string;
-        quantity: number;
-    }>;
-};
-type StockCheckResult = {
-    variantId: string;
-    available: boolean;
-    availableStock: number;
-    requestedQuantity: number;
-    error?: string;
-};
-type StockCheckResponse = {
-    results: StockCheckResult[];
-    allAvailable: boolean;
-};
-type ListingGroupsParams = {
-    productIds: string[];
-};
-type ProductListingGroupSummary = Omit<ProductListingGroup, 'variants'>;
-type ProductListingGroupsItem = {
-    product: Product;
-    primaryOptionId: string | null;
-    groups: ProductListingGroupSummary[];
-};
-type ProductListingGroupsResponse = {
-    docs: ProductListingGroupsItem[];
-};
-declare class ProductApi extends BaseApi {
-    constructor(options: ProductApiOptions);
-    stockCheck(params: StockCheckParams): Promise<StockCheckResponse>;
-    listingGroups(params: ListingGroupsParams): Promise<ProductListingGroupsResponse>;
+declare class SDKError extends Error {
+    readonly code: string;
+    readonly status?: number;
+    readonly details?: unknown;
+    readonly userMessage?: string;
+    readonly suggestion?: string;
+    readonly requestId?: string;
+    constructor(code: string, message: string, status?: number, details?: unknown, userMessage?: string, suggestion?: string, requestId?: string);
+    getUserMessage(): string;
+    toJSON(): {
+        requestId?: string | undefined;
+        name: string;
+        code: string;
+        message: string;
+        status: number | undefined;
+        details: unknown;
+        userMessage: string | undefined;
+        suggestion: string | undefined;
+    };
 }
-
-interface GenerateMetadataOptions {
-    siteName?: string;
+declare class NetworkError extends SDKError {
+    constructor(message: string, status?: number, details?: unknown, userMessage?: string, suggestion?: string);
+}
+declare class ValidationError extends SDKError {
+    constructor(message: string, details?: unknown, userMessage?: string, suggestion?: string);
+}
+declare class ApiError extends SDKError {
+    constructor(message: string, status: number, details?: unknown, userMessage?: string, suggestion?: string);
+}
+declare class ConfigError extends SDKError {
+    constructor(message: string, details?: unknown, userMessage?: string, suggestion?: string);
+}
+declare class TimeoutError extends SDKError {
+    constructor(message?: string, details?: unknown, userMessage?: string, suggestion?: string);
+}
+declare class GoneError extends SDKError {
+    constructor(message?: string, details?: unknown, userMessage?: string, suggestion?: string);
+}
+declare class ServiceUnavailableError extends SDKError {
+    readonly retryAfter?: number;
+    constructor(message?: string, retryAfter?: number, details?: unknown, userMessage?: string, suggestion?: string);
+}
+declare class UsageLimitError extends SDKError {
+    readonly usage: {
+        limit: number;
+        current: number;
+        remaining: number;
+    };
+    constructor(message: string, usage: {
+        limit: number;
+        current: number;
+        remaining: number;
+    }, details?: unknown, userMessage?: string, suggestion?: string);
+    toJSON(): {
+        usage: {
+            limit: number;
+            current: number;
+            remaining: number;
+        };
+        requestId?: string | undefined;
+        name: string;
+        code: string;
+        message: string;
+        status: number | undefined;
+        details: unknown;
+        userMessage: string | undefined;
+        suggestion: string | undefined;
+    };
+}
+declare class AuthError extends SDKError {
+    constructor(message: string, details?: unknown, userMessage?: string, suggestion?: string, requestId?: string);
 }
+declare class PermissionError extends SDKError {
+    constructor(message: string, details?: unknown, userMessage?: string, suggestion?: string, requestId?: string);
+}
+declare class NotFoundError extends SDKError {
+    constructor(message: string, details?: unknown, userMessage?: string, suggestion?: string, requestId?: string);
+}
+declare class ConflictError extends SDKError {
+    constructor(message: string, details?: unknown, userMessage?: string, suggestion?: string, requestId?: string);
+}
+declare class RateLimitError extends SDKError {
+    readonly retryAfter?: number;
+    constructor(message: string, retryAfter?: number, details?: unknown, userMessage?: string, suggestion?: string, requestId?: string);
+}
+declare function isSDKError(error: unknown): error is SDKError;
+declare function isNetworkError(error: unknown): error is NetworkError;
+declare function isValidationError(error: unknown): error is ValidationError;
+declare function isApiError(error: unknown): error is ApiError;
+declare function isConfigError(error: unknown): error is ConfigError;
+declare function isTimeoutError(error: unknown): error is TimeoutError;
+declare function isGoneError(error: unknown): error is GoneError;
+declare function isServiceUnavailableError(error: unknown): error is ServiceUnavailableError;
+declare function isUsageLimitError(error: unknown): error is UsageLimitError;
+declare function isAuthError(error: unknown): error is AuthError;
+declare function isPermissionError(error: unknown): error is PermissionError;
+declare function isNotFoundError(error: unknown): error is NotFoundError;
+declare function isConflictError(error: unknown): error is ConflictError;
+declare function isRateLimitError(error: unknown): error is RateLimitError;
+declare const createAuthError: (message: string, details?: unknown, userMessage?: string, suggestion?: string, requestId?: string) => AuthError;
+declare const createPermissionError: (message: string, details?: unknown, userMessage?: string, suggestion?: string, requestId?: string) => PermissionError;
+declare const createNotFoundError: (message: string, details?: unknown, userMessage?: string, suggestion?: string, requestId?: string) => NotFoundError;
+declare const createConflictError: (message: string, details?: unknown, userMessage?: string, suggestion?: string, requestId?: string) => ConflictError;
+declare const createRateLimitError: (message: string, retryAfter?: number, details?: unknown, userMessage?: string, suggestion?: string, requestId?: string) => RateLimitError;
 
 interface FetchOptions extends RequestInit {
     publishableKey?: string;
     secretKey?: string;
     customerToken?: string;
+    tenantId?: string;
     timeout?: number;
     debug?: boolean | DebugConfig;
     retry?: RetryConfig;
-    /** Called on 401 when customerToken is set. Return a new token to retry, or null to fail. */
+    /** Called on 401 when customerToken is set and reason=token_expired. Return a new token to retry, or null to fail. */
     onUnauthorized?: () => Promise<string | null>;
 }
 
 declare class HttpClient {
     protected publishableKey: string;
     protected secretKey?: string;
+    protected tenantId?: string;
     private getCustomerToken?;
     private onUnauthorized?;
-    constructor(publishableKey: string, secretKey?: string, getCustomerToken?: () => string | null, onUnauthorized?: () => Promise<string | null>);
+    private onRequestId?;
+    constructor(publishableKey: string, secretKey?: string, getCustomerToken?: () => string | null, onUnauthorized?: () => Promise<string | null>, onRequestId?: (id: string | null) => void, tenantId?: string);
     protected get defaultOptions(): FetchOptions;
+    protected fetchWithTracking(url: string, opts: FetchOptions): Promise<Response>;
     protected buildUrl(endpoint: string, options?: ApiQueryOptions): string;
     protected assertJsonResponse(response: Response): void;
     /**
@@ -639,8 +434,10 @@ declare class CollectionQueryBuilder<T extends PublicCollection> {
 interface CommunityClientOptions {
     publishableKey?: string;
     secretKey?: string;
+    tenantId?: string;
     customerToken?: string | (() => string | null);
     onUnauthorized?: () => Promise<string | null>;
+    onRequestId?: (id: string | null) => void;
 }
 interface Thread {
     id: string;
@@ -689,16 +486,6 @@ interface ReactionType {
     emoji?: string;
     [key: string]: unknown;
 }
-interface CommunityBan {
-    id: string;
-    customer: string;
-    isPermanent?: boolean;
-    bannedUntil?: string;
-    reason?: string;
-    createdAt?: string;
-    updatedAt?: string;
-    [key: string]: unknown;
-}
 interface PaginatedResponse<T> {
     docs: T[];
     totalDocs: number;
@@ -714,9 +501,12 @@ interface PaginatedResponse<T> {
 declare class CommunityClient {
     private readonly publishableKey;
     private readonly secretKey?;
+    private readonly tenantId?;
     private readonly customerToken?;
     private readonly onUnauthorized?;
+    private readonly onRequestId?;
     constructor(options: CommunityClientOptions);
+    private buildQuery;
     private execute;
     createThread(params: {
         title: string;
@@ -808,16 +598,52 @@ declare class CommunityClient {
         page?: number;
         limit?: number;
     }): Promise<PaginatedResponse<Bookmark>>;
-    banCustomer(params: {
-        customerId: string;
-        isPermanent?: boolean;
-        bannedUntil?: string;
-        reason?: string;
-    }): Promise<CommunityBan>;
-    unbanCustomer(params: {
-        customerId: string;
-    }): Promise<{
-        success: boolean;
+}
+
+interface ServerApiOptions {
+    publishableKey?: string;
+    secretKey: string;
+    tenantId?: string;
+    onRequestId?: (id: string | null) => void;
+}
+interface RequestOptions {
+    method?: 'GET' | 'POST' | 'PATCH' | 'DELETE';
+    headers?: Record<string, string>;
+}
+declare abstract class BaseApi {
+    protected readonly publishableKey: string;
+    protected readonly secretKey: string;
+    protected readonly tenantId?: string;
+    protected readonly onRequestId?: (id: string | null) => void;
+    constructor(apiName: string, options: ServerApiOptions);
+    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;
     }>;
 }
 
@@ -961,87 +787,456 @@ declare class CustomerAuth {
      */
     isAuthenticated(): boolean;
     /**
-     * Internal: make a request with timeout and error handling.
-     * Auth endpoints don't retry — failures are final.
+     * Internal: make a request with timeout and error handling.
+     * Auth endpoints don't retry — failures are final.
+     */
+    private requestJson;
+}
+
+/**
+ * Customer namespace. Currently exposes .auth; reserved for future customer-
+ * scoped capabilities (addresses, preferences, etc.).
+ */
+declare class CustomerNamespace {
+    readonly auth: CustomerAuth;
+    constructor(publishableKey: string, options?: CustomerAuthOptions);
+}
+
+interface CartApiOptions {
+    publishableKey?: string;
+    secretKey?: string;
+    tenantId?: string;
+    customerToken?: string | (() => string | null);
+    onUnauthorized?: () => Promise<string | null>;
+    onRequestId?: (id: string | null) => void;
+}
+type AddItemParams = {
+    cartId: string;
+    product: string;
+    variant: string;
+    option: string;
+    quantity: number;
+};
+type UpdateItemParams = {
+    cartItemId: string;
+    quantity: number;
+};
+type RemoveItemParams = {
+    cartItemId: string;
+};
+type ApplyDiscountParams = {
+    cartId: string;
+    discountCode: string;
+};
+type RemoveDiscountParams = {
+    cartId: string;
+};
+type ClearCartParams = {
+    cartId: string;
+};
+declare class CartApi {
+    private readonly publishableKey;
+    private readonly secretKey?;
+    private readonly tenantId?;
+    private readonly customerToken?;
+    private readonly onUnauthorized?;
+    private readonly onRequestId?;
+    constructor(options: CartApiOptions);
+    private execute;
+    getCart(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>;
+    clearCart(params: ClearCartParams): Promise<{
+        success: boolean;
+    }>;
+}
+
+type EntityID = string;
+type RelationshipValue = string | number | null | undefined | {
+    id?: string | number | null;
+};
+type MediaValue = {
+    id?: EntityID | null;
+} | EntityID | null | undefined;
+interface ProductOptionValueShape {
+    id?: string | number | null;
+    option?: RelationshipValue;
+    value?: string | null;
+    slug?: string | null;
+    _order?: string | null;
+    '_product-option-values_values_order'?: string | null;
+}
+interface ProductOptionShape {
+    id?: string | number | null;
+    title?: string | null;
+    _order?: string | null;
+    '_product-options_options_order'?: string | null;
+    values?: {
+        docs?: unknown[];
+    } | null;
+}
+interface ProductVariantShape {
+    id?: string | number | null;
+    optionValues?: unknown[] | null;
+    price?: number | null;
+    compareAtPrice?: number | null;
+    stock?: number | null;
+    isUnlimited?: boolean | null;
+    isActive?: boolean | null;
+    thumbnail?: MediaValue;
+    images?: MediaValue[] | null;
+    _order?: string | null;
+}
+interface ProductListingProductShape {
+    id?: EntityID;
+    thumbnail?: MediaValue;
+    images?: MediaValue[] | null;
+}
+type ProductOptionMatrixValue = {
+    id: string;
+    optionId: string;
+    label: string;
+    slug: string | null;
+    order: string;
+};
+type ProductOptionMatrixOption = {
+    id: string;
+    title: string;
+    order: string;
+    values: ProductOptionMatrixValue[];
+};
+type ProductOptionMatrixVariant<TVariant extends ProductVariantShape = ProductVariantShape> = {
+    id: string;
+    optionValueIds: string[];
+    optionValueByOptionId: Map<string, string>;
+    source: TVariant;
+};
+type ProductOptionMatrix<TVariant extends ProductVariantShape = ProductVariantShape> = {
+    options: ProductOptionMatrixOption[];
+    optionIds: string[];
+    optionById: Map<string, ProductOptionMatrixOption>;
+    valueById: Map<string, ProductOptionMatrixValue>;
+    valueToOptionId: Map<string, string>;
+    variants: ProductOptionMatrixVariant<TVariant>[];
+};
+type ProductListingProjection = {
+    selectionHintVariant: EntityID | null;
+    primaryImage: EntityID | null;
+    minPrice: number | null;
+    maxPrice: number | null;
+    minCompareAtPrice: number | null;
+    maxCompareAtPrice: number | null;
+    isPriceRange: boolean;
+    availableForSale: boolean;
+};
+type ProductListingGroup<TVariant extends ProductVariantShape = ProductVariantShape> = {
+    optionId: EntityID;
+    optionTitle: string;
+    optionValueId: EntityID;
+    optionValueLabel: string;
+    optionValueSlug: string | null;
+    variantIds: EntityID[];
+    variantCount: number;
+    variants: TVariant[];
+    listing: ProductListingProjection;
+};
+declare function buildProductOptionMatrix<TVariant extends ProductVariantShape = ProductVariantShape>({ options, variants, }: {
+    options: ProductOptionShape[];
+    variants?: TVariant[];
+}): ProductOptionMatrix<TVariant>;
+declare function getSelectedValueByOptionId<TVariant extends ProductVariantShape = ProductVariantShape>(matrix: ProductOptionMatrix<TVariant>, selectedValueIds: Iterable<unknown>): Map<string, string>;
+declare function normalizeSelectedValueIds<TVariant extends ProductVariantShape = ProductVariantShape>(matrix: ProductOptionMatrix<TVariant>, selectedValueIds: Iterable<unknown>): string[];
+declare function getAvailableOptionValues<TVariant extends ProductVariantShape = ProductVariantShape>(matrix: ProductOptionMatrix<TVariant>, optionId: string, selectedValueIds: Iterable<unknown>): ProductOptionMatrixValue[];
+declare function resolveVariantForSelection<TVariant extends ProductVariantShape = ProductVariantShape>(matrix: ProductOptionMatrix<TVariant>, selectedValueIds: Iterable<unknown>): ProductOptionMatrixVariant<TVariant> | undefined;
+declare function buildProductListingProjection(product: ProductListingProductShape | null | undefined, variants: ProductVariantShape[]): ProductListingProjection;
+declare function buildProductListingGroupsByOption<TVariant extends ProductVariantShape = ProductVariantShape>(args: {
+    product: ProductListingProductShape | null | undefined;
+    options: ProductOptionShape[];
+    variants: TVariant[];
+    primaryOptionId?: string | null;
+}): ProductListingGroup<TVariant>[];
+
+type ProductApiOptions = ServerApiOptions;
+type StockCheckParams = {
+    items: Array<{
+        variantId: string;
+        quantity: number;
+    }>;
+};
+type StockCheckResult = {
+    variantId: string;
+    available: boolean;
+    availableStock: number;
+    requestedQuantity: number;
+    error?: string;
+};
+type StockCheckResponse = {
+    results: StockCheckResult[];
+    allAvailable: boolean;
+};
+type ListingGroupsParams = {
+    productIds: string[];
+};
+type ProductListingGroupSummary = Omit<ProductListingGroup, 'variants'>;
+type ProductListingGroupsItem = {
+    product: Product;
+    primaryOptionId: string | null;
+    groups: ProductListingGroupSummary[];
+};
+type ProductListingGroupsResponse = {
+    docs: ProductListingGroupsItem[];
+};
+declare class ProductApi extends BaseApi {
+    constructor(options: ProductApiOptions);
+    /**
+     * Check point-in-time stock availability for one or more product variants.
+     * Results reflect available stock at the moment of the call and are not guaranteed
+     * to remain available by the time an order is placed.
      */
-    private requestJson;
+    stockCheck(params: StockCheckParams): Promise<StockCheckResponse>;
+    listingGroups(params: ListingGroupsParams): Promise<ProductListingGroupsResponse>;
 }
 
-declare class SDKError extends Error {
-    readonly code: string;
-    readonly status?: number;
-    readonly details?: unknown;
-    readonly userMessage?: string;
-    readonly suggestion?: string;
-    constructor(code: string, message: string, status?: number, details?: unknown, userMessage?: string, suggestion?: string);
-    getUserMessage(): string;
-    toJSON(): {
-        name: string;
-        code: string;
-        message: string;
-        status: number | undefined;
-        details: unknown;
-        userMessage: string | undefined;
-        suggestion: string | undefined;
-    };
-}
-declare class NetworkError extends SDKError {
-    constructor(message: string, status?: number, details?: unknown, userMessage?: string, suggestion?: string);
-}
-declare class ValidationError extends SDKError {
-    constructor(message: string, details?: unknown, userMessage?: string, suggestion?: string);
+type DiscountApiOptions = ServerApiOptions;
+type ValidateDiscountParams = {
+    code: string;
+    orderAmount: number;
+};
+type ValidateDiscountResult = {
+    valid: boolean;
+    code: string;
+    type?: 'percentage' | 'fixed_amount' | 'free_shipping' | 'tiered';
+    discountAmount: number;
+    freeShipping?: boolean;
+    reason?: string;
+};
+declare class DiscountApi extends BaseApi {
+    constructor(options: DiscountApiOptions);
+    validate(params: ValidateDiscountParams): Promise<ValidateDiscountResult>;
 }
-declare class ApiError extends SDKError {
-    constructor(message: string, status: number, details?: unknown, userMessage?: string, suggestion?: string);
+
+type ShippingApiOptions = ServerApiOptions;
+type CalculateShippingParams = {
+    shippingPolicyId?: string;
+    orderAmount: number;
+    postalCode?: string;
+};
+type CalculateShippingResult = {
+    shippingAmount: number;
+    baseShippingAmount: number;
+    extraShippingAmount: number;
+    freeShipping: boolean;
+    freeShippingMinAmount: number | null;
+    isJeju: boolean;
+    isRemoteIsland: boolean;
+};
+declare class ShippingApi extends BaseApi {
+    constructor(options: ShippingApiOptions);
+    calculate(params: CalculateShippingParams): Promise<CalculateShippingResult>;
 }
-declare class ConfigError extends SDKError {
-    constructor(message: string, details?: unknown, userMessage?: string, suggestion?: string);
+
+type OrderApiOptions = ServerApiOptions;
+type CustomerSnapshot = {
+    name?: string;
+    email: string;
+    phone?: string;
+};
+type ReturnReason = 'change_of_mind' | 'defective' | 'wrong_delivery' | 'damaged' | 'other';
+type ReturnItem = {
+    orderItem: string;
+    quantity: number;
+};
+type CreateOrderParams = {
+    orderNumber: string;
+    customer?: string;
+    customerSnapshot: CustomerSnapshot;
+    shippingAddress: Order['shippingAddress'];
+    orderItems: Pick<OrderItem$1, 'product' | 'variant' | 'quantity' | 'unitPrice' | 'totalPrice'>[];
+    totalAmount: number;
+    shippingAmount?: number;
+    pgPaymentId?: string;
+    discountCode?: string;
+};
+type UpdateOrderParams = {
+    orderNumber: string;
+    status: Order['status'];
+};
+type UpdateTransactionParams = {
+    pgPaymentId: string;
+    status: Transaction['status'];
+    paymentMethod?: string;
+    receiptUrl?: string;
+};
+type CheckoutParams = {
+    cartId: string;
+    orderNumber: string;
+    customerSnapshot: CustomerSnapshot;
+    pgPaymentId?: string;
+    discountCode?: string;
+};
+type CreateFulfillmentParams = {
+    orderNumber: string;
+    carrier?: string;
+    trackingNumber?: string;
+    items: Array<{
+        orderItem: string;
+        quantity: number;
+    }>;
+};
+type UpdateFulfillmentParams = {
+    fulfillmentId: string;
+    status: 'packed' | 'shipped' | 'delivered' | 'failed';
+    carrier?: string;
+    trackingNumber?: string;
+};
+type BulkImportFulfillmentsParams = {
+    items: Array<{
+        orderNumber: string;
+        carrier?: string;
+        trackingNumber?: string;
+    }>;
+};
+type BulkImportFulfillmentsResponse = {
+    succeeded: Array<{
+        orderNumber: string;
+        fulfillmentId: string;
+    }>;
+    failed: Array<{
+        orderNumber: string;
+        error: string;
+    }>;
+};
+type CreateReturnParams = {
+    orderNumber: string;
+    reason?: ReturnReason;
+    reasonDetail?: string;
+    returnItems: ReturnItem[];
+    refundAmount: number;
+};
+type UpdateReturnParams = {
+    returnId: string;
+    status: 'processing' | 'approved' | 'rejected' | 'completed';
+};
+type ReturnWithRefundParams = {
+    orderNumber: string;
+    reason?: ReturnReason;
+    reasonDetail?: string;
+    returnItems: ReturnItem[];
+    refundAmount: number;
+    pgPaymentId: string;
+    refundReceiptUrl?: string;
+};
+declare class OrderApi extends BaseApi {
+    constructor(options: OrderApiOptions);
+    createOrder(params: CreateOrderParams): Promise<Order>;
+    updateOrder(params: UpdateOrderParams): Promise<Order>;
+    updateTransaction(params: UpdateTransactionParams): Promise<Transaction>;
+    checkout(params: CheckoutParams): Promise<Order>;
+    createFulfillment(params: CreateFulfillmentParams): Promise<Fulfillment>;
+    updateFulfillment(params: UpdateFulfillmentParams): Promise<Fulfillment>;
+    bulkImportFulfillments(params: BulkImportFulfillmentsParams): Promise<BulkImportFulfillmentsResponse>;
+    returnWithRefund(params: ReturnWithRefundParams): Promise<{
+        return: Return;
+        transaction: Transaction | null;
+    }>;
+    createReturn(params: CreateReturnParams): Promise<Return>;
+    updateReturn(params: UpdateReturnParams): Promise<Return>;
 }
-declare class TimeoutError extends SDKError {
-    constructor(message?: string, details?: unknown, userMessage?: string, suggestion?: string);
+
+interface CommerceClientOptions {
+    publishableKey: string;
+    customerToken: () => string | null;
+    onUnauthorized?: () => Promise<string | null>;
+    onRequestId?: (id: string | null) => void;
+    customerAuth: CustomerAuth;
 }
-declare class GoneError extends SDKError {
-    constructor(message?: string, details?: unknown, userMessage?: string, suggestion?: string);
+declare class CommerceClient {
+    readonly product: {
+        stockCheck: (params: StockCheckParams) => Promise<StockCheckResponse>;
+        listingGroups: (params: ListingGroupsParams) => Promise<ProductListingGroupsResponse>;
+    };
+    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>;
+        listMine: (options?: {
+            page?: number;
+            limit?: number;
+            status?: string;
+        }) => Promise<PayloadFindResponse<Order>>;
+    };
+    readonly discounts: {
+        validate: (params: ValidateDiscountParams) => Promise<ValidateDiscountResult>;
+    };
+    readonly shipping: {
+        calculate: (params: CalculateShippingParams) => Promise<CalculateShippingResult>;
+    };
+    constructor(options: CommerceClientOptions);
 }
-declare class ServiceUnavailableError extends SDKError {
-    readonly retryAfter?: number;
-    constructor(message?: string, retryAfter?: number, details?: unknown, userMessage?: string, suggestion?: string);
+
+interface ServerCommerceClientOptions {
+    publishableKey?: string;
+    secretKey: string;
+    tenantId?: string;
+    onRequestId?: (id: string | null) => void;
 }
-declare class UsageLimitError extends SDKError {
-    readonly usage: {
-        limit: number;
-        current: number;
-        remaining: number;
+declare class ServerCommerceClient {
+    readonly product: {
+        stockCheck: (params: StockCheckParams) => Promise<StockCheckResponse>;
+        listingGroups: (params: ListingGroupsParams) => Promise<ProductListingGroupsResponse>;
     };
-    constructor(message: string, usage: {
-        limit: number;
-        current: number;
-        remaining: number;
-    }, details?: unknown, userMessage?: string, suggestion?: string);
-    toJSON(): {
-        usage: {
-            limit: number;
-            current: number;
-            remaining: number;
-        };
-        name: string;
-        code: string;
-        message: string;
-        status: number | undefined;
-        details: unknown;
-        userMessage: string | undefined;
-        suggestion: string | undefined;
+    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>;
+        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);
 }
-declare function isSDKError(error: unknown): error is SDKError;
-declare function isNetworkError(error: unknown): error is NetworkError;
-declare function isValidationError(error: unknown): error is ValidationError;
-declare function isApiError(error: unknown): error is ApiError;
-declare function isConfigError(error: unknown): error is ConfigError;
-declare function isTimeoutError(error: unknown): error is TimeoutError;
-declare function isGoneError(error: unknown): error is GoneError;
-declare function isServiceUnavailableError(error: unknown): error is ServiceUnavailableError;
-declare function isUsageLimitError(error: unknown): error is UsageLimitError;
 
 interface CollectionQueryParams<T extends PublicCollection> {
     collection: T;
@@ -1243,16 +1438,16 @@ declare class QueryHooks extends CollectionHooks {
 }
 
 declare class Client {
-    cart: CartApi;
+    commerce: CommerceClient;
     community: CommunityClient;
+    customer: CustomerNamespace;
     query: ReadOnlyQueryHooks;
     collections: CollectionClient;
     queryClient: QueryClient;
-    customer: CustomerAuth;
+    lastRequestId: string | null;
     protected state: ClientState;
     protected config: ClientConfig;
     constructor(options: ClientConfig);
-    from<T extends PublicCollection>(collection: T): ReadOnlyQueryBuilder<T>;
     getState(): ClientState;
     getConfig(): ClientConfig;
 }
@@ -1264,17 +1459,22 @@ declare class Client {
 declare function createClient(options: ClientConfig): Client;
 
 declare class ServerClient {
-    api: OrderApi;
-    cart: CartApi;
-    community: CommunityClient;
-    product: ProductApi;
+    commerce: ServerCommerceClient;
+    community: CommunityClient & {
+        moderation: {
+            banCustomer: (p: BanCustomerParams) => Promise<CommunityBan>;
+            unbanCustomer: (p: UnbanCustomerParams) => Promise<{
+                success: true;
+            }>;
+        };
+    };
     query: QueryHooks;
     collections: CollectionClient;
     queryClient: QueryClient;
+    lastRequestId: string | null;
     protected state: ClientState;
     protected config: ClientServerConfig;
     constructor(options: ClientServerConfig);
-    from<T extends PublicCollection>(collection: T): CollectionQueryBuilder<T>;
     getState(): ClientState;
     getConfig(): Omit<ClientServerConfig, 'secretKey'>;
 }
@@ -1304,4 +1504,4 @@ declare const formatOrderName: (items: OrderItem[]) => string;
  */
 declare const resolveRelation: <T>(ref: T | string | number | null | undefined) => T | null;
 
-export { type AddItemParams, ApiError, type ApiQueryOptions, type ApplyDiscountParams, BaseApi, type CalculateShippingParams, type CalculateShippingResult, Cart, CartApi, type CartApiOptions, CartItem, type CheckoutParams, type ClearCartParams, Client, type ClientConfig, type ClientMetadata, type ClientServerConfig, type ClientState, Client as ClientType, CollectionClient, type CollectionDetailQueryParams, CollectionHooks, type CollectionInfiniteQueryParams, CollectionQueryBuilder, type CollectionQueryParams, CollectionType, CommunityClient, type CommunityClientOptions, ConfigError, type CreateFulfillmentParams, type CreateOrderParams, type CreateReturnParams, CustomerAuth, type CustomerAuthOptions, type CustomerAuthResponse, CustomerHooks, type CustomerLoginData, type CustomerProfile, type CustomerRefreshResponse, type CustomerRegisterData, type CustomerRegisterResponse, type CustomerSnapshot, type DebugConfig, type DeepPartial, type ExtractArrayType, type GenerateMetadataOptions, type GetOrderParams, GoneError, type InfiniteQueryOptions, type ListingGroupsParams, NetworkError, Order, OrderApi, type OrderApiOptions, type PaginationMeta, type PayloadFindResponse, type PayloadMutationResponse, Product, ProductApi, type ProductApiOptions, type ProductListingGroup, type ProductListingGroupSummary, type ProductListingGroupsItem, type ProductListingGroupsQueryOptions, type ProductListingGroupsResponse, type ProductListingProductShape, type ProductListingProjection, type ProductOptionMatrix, type ProductOptionMatrixOption, type ProductOptionMatrixValue, type ProductOptionMatrixVariant, type ProductOptionShape, type ProductOptionValueShape, type ProductVariantShape, PublicCollection, QueryHooks, type QueryOptions, type ReadOnlyQueryBuilder, type ReadOnlyQueryHooks, type RemoveDiscountParams, type RemoveItemParams, type RequestOptions, type RetryConfig, type ReturnProductItem, type ReturnReason, type ReturnWithRefundParams, SDKError, type ServerApiOptions, ServerClient, ServerClient as ServerClientType, ServiceUnavailableError, type StockCheckParams, type StockCheckResponse, type StockCheckResult, type SuspenseInfiniteQueryOptions, type SuspenseQueryOptions, TimeoutError, type UpdateFulfillmentParams, type UpdateItemParams, type UpdateOrderParams, type UpdateProfileData, type UpdateReturnParams, type UpdateTransactionParams, UsageLimitError, type ValidateDiscountParams, type ValidateDiscountResult, ValidationError, buildProductListingGroupsByOption, buildProductListingProjection, buildProductOptionMatrix, collectionKeys, createClient, createServerClient, customerKeys, formatOrderName, generateOrderNumber, getAvailableOptionValues, getQueryClient, getSelectedValueByOptionId, isApiError, isConfigError, isGoneError, isNetworkError, isSDKError, isServiceUnavailableError, isTimeoutError, isUsageLimitError, isValidationError, normalizeSelectedValueIds, productKeys, resolveApiUrl, resolveRelation, resolveVariantForSelection };
+export { type AddItemParams, ApiError, type ApiQueryOptions, type ApplyDiscountParams, AuthError, type BanCustomerParams, BaseApi, type BulkImportFulfillmentsParams, type BulkImportFulfillmentsResponse, type CalculateShippingParams, type CalculateShippingResult, Cart, CartApi, type CartApiOptions, CartItem, type CheckoutParams, type ClearCartParams, Client, type ClientConfig, type ClientMetadata, type ClientServerConfig, type ClientState, Client as ClientType, CollectionClient, type CollectionDetailQueryParams, CollectionHooks, type CollectionInfiniteQueryParams, CollectionQueryBuilder, type CollectionQueryParams, CollectionType, CommerceClient, type CommerceClientOptions, type CommunityBan, CommunityClient, type CommunityClientOptions, ConfigError, ConflictError, type CreateFulfillmentParams, type CreateOrderParams, type CreateReturnParams, CustomerAuth, type CustomerAuthOptions, type CustomerAuthResponse, CustomerHooks, type CustomerLoginData, CustomerNamespace, type CustomerProfile, type CustomerRefreshResponse, type CustomerRegisterData, type CustomerRegisterResponse, type CustomerSnapshot, type DebugConfig, type DeepPartial, DiscountApi, type DiscountApiOptions, type ExtractArrayType, type GenerateMetadataOptions, GoneError, type InfiniteQueryOptions, type ListingGroupsParams, ModerationApi, type ModerationApiOptions, NetworkError, NotFoundError, Order, OrderApi, type OrderApiOptions, type PaginationMeta, type PayloadFindResponse, type PayloadMutationResponse, PermissionError, Product, ProductApi, type ProductApiOptions, type ProductListingGroup, type ProductListingGroupSummary, type ProductListingGroupsItem, type ProductListingGroupsQueryOptions, type ProductListingGroupsResponse, type ProductListingProductShape, type ProductListingProjection, type ProductOptionMatrix, type ProductOptionMatrixOption, type ProductOptionMatrixValue, type ProductOptionMatrixVariant, type ProductOptionShape, type ProductOptionValueShape, type ProductVariantShape, PublicCollection, QueryHooks, type QueryOptions, RateLimitError, type ReadOnlyQueryBuilder, type ReadOnlyQueryHooks, type RemoveDiscountParams, type RemoveItemParams, type RequestOptions, type RetryConfig, type ReturnItem, type ReturnReason, type ReturnWithRefundParams, SDKError, type ServerApiOptions, ServerClient, ServerClient as ServerClientType, ServerCommerceClient, type ServerCommerceClientOptions, ServiceUnavailableError, ShippingApi, type ShippingApiOptions, type StockCheckParams, type StockCheckResponse, type StockCheckResult, type SuspenseInfiniteQueryOptions, type SuspenseQueryOptions, TimeoutError, type UnbanCustomerParams, type UpdateFulfillmentParams, type UpdateItemParams, type UpdateOrderParams, type UpdateProfileData, type UpdateReturnParams, type UpdateTransactionParams, UsageLimitError, type ValidateDiscountParams, type ValidateDiscountResult, ValidationError, buildProductListingGroupsByOption, buildProductListingProjection, buildProductOptionMatrix, collectionKeys, createAuthError, createClient, createConflictError, createNotFoundError, createPermissionError, createRateLimitError, createServerClient, customerKeys, formatOrderName, generateOrderNumber, getAvailableOptionValues, getQueryClient, getSelectedValueByOptionId, isApiError, isAuthError, isConfigError, isConflictError, isGoneError, isNetworkError, isNotFoundError, isPermissionError, isRateLimitError, isSDKError, isServiceUnavailableError, isTimeoutError, isUsageLimitError, isValidationError, normalizeSelectedValueIds, productKeys, resolveApiUrl, resolveRelation, resolveVariantForSelection };