@01.software/sdk 0.2.9-dev.260306.4e16dd4 → 0.2.9-dev.260309.c56872d

package/dist/index.d.cts

@@ -1,11 +1,11 @@
-import { O as Order, a as OrderProduct, T as Transaction, b as Fulfillment, R as Return, C as CartItem, P as ProductOption } from './payload-types-p9NaGmQA.cjs';
-export { k as ApiUsage, ag as ApiUsageSelect, A as Audience, ac as AudiencesSelect, b4 as Auth, m as BillingHistory, ai as BillingHistorySelect, u as Brand, B as BrandLogo, as as BrandLogosSelect, ar as BrandsSelect, K as Cart, aI as CartItemsSelect, aH as CartsSelect, f as CodeBlock, b3 as CollectionsWidget, c as Config, w as Customer, z as CustomerAddress, aE as CustomerAddressesSelect, d as CustomerAuthOperations, x as CustomerGroup, y as CustomerGroupImage, aG as CustomerGroupImagesSelect, aF as CustomerGroupsSelect, aD as CustomersSelect, L as Discount, aJ as DiscountsSelect, Y as Document, aR as DocumentCategoriesSelect, $ as DocumentCategory, _ as DocumentImage, aT as DocumentImagesSelect, Z as DocumentType, aS as DocumentTypesSelect, aQ as DocumentsSelect, E as EmailLog, ad as EmailLogsSelect, H as Exchange, J as ExchangeProduct, aC as ExchangeProductsSelect, aB as ExchangesSelect, a3 as Flow, a4 as FlowImage, aY as FlowImagesSelect, aX as FlowsSelect, F as Form, a5 as FormSubmission, a_ as FormSubmissionsSelect, aZ as FormsSelect, D as FulfillmentItem, ay as FulfillmentItemsSelect, ax as FulfillmentsSelect, I as IframeBlock, M as Media, ab as MediaSelect, a1 as Music, aV as MusicsSelect, av as OrderProductsSelect, au as OrdersSelect, a6 as PayloadKv, a$ as PayloadKvSelect, a7 as PayloadLockedDocument, b0 as PayloadLockedDocumentsSelect, a9 as PayloadMigration, b2 as PayloadMigrationsSelect, a8 as PayloadPreference, b1 as PayloadPreferencesSelect, e as PlayerBlock, a0 as Playlist, a2 as PlaylistImage, aW as PlaylistImagesSelect, aU as PlaylistsSelect, N as Post, V as PostAuthor, aM as PostAuthorsSelect, aN as PostCategoriesSelect, W as PostCategory, Q as PostImage, aP as PostImagesSelect, X as PostTag, aO as PostTagsSelect, aL as PostsSelect, o as Product, ao as ProductCategoriesSelect, r as ProductCategory, t as ProductCollection, aq as ProductCollectionsSelect, p as ProductImage, at as ProductImagesSelect, an as ProductOptionsSelect, s as ProductTag, ap as ProductTagsSelect, q as ProductVariant, am as ProductVariantsSelect, al as ProductsSelect, G as ReturnProduct, aA as ReturnProductsSelect, az as ReturnsSelect, aK as ShippingPoliciesSelect, v as ShippingPolicy, l as Subscription, ah as SubscriptionsSelect, S as SupportedTimezones, h as Tenant, n as TenantLogo, aj as TenantLogosSelect, af as TenantMetadataSelect, i as TenantMetadatum, j as TenantOgImage, ak as TenantOgImagesSelect, ae as TenantsSelect, aw as TransactionsSelect, g as User, U as UserAuthOperations, aa as UsersSelect } from './payload-types-p9NaGmQA.cjs';
-import { F as FetchOptions, A as ApiQueryOptions, P as PayloadFindResponse, a as PayloadMutationResponse, C as ClientBrowserConfig, b as ClientState, c as ClientServerConfig } from './auth-Hs3cAUfV.cjs';
-export { t as API_URLS, f as ApiError, y as ApiQueryReactOptions, w as ClientMetadata, g as ConfigError, d as DebugConfig, D as DeepPartial, s as Environment, e as ErrorLogger, E as ExtractArrayType, J as JwtPayload, N as NetworkError, x as PaginationMeta, R as RetryConfig, S as SDKError, T as TimeoutError, U as UsageLimitError, V as ValidationError, q as createApiKey, o as createServerToken, p as decodeServerToken, k as isApiError, l as isConfigError, h as isNetworkError, i as isSDKError, m as isTimeoutError, n as isUsageLimitError, j as isValidationError, r as parseApiKey, u as resolveApiUrl, v as verifyServerToken } from './auth-Hs3cAUfV.cjs';
+import { O as Order, a as OrderProduct, T as Transaction, b as Fulfillment, R as Return, E as Exchange, C as Cart, c as CartItem, P as Product } from './payload-types-2wbfaDxp.cjs';
+export { m as ApiUsage, ap as ApiUsageSelect, A as Audience, al as AudiencesSelect, bm as Auth, o as BillingHistory, ar as BillingHistorySelect, w as Brand, B as BrandLogo, aB as BrandLogosSelect, aA as BrandsSelect, aT as CartItemsSelect, aS as CartsSelect, g as CodeBlock, bl as CollectionsWidget, d as Config, y as Customer, G as CustomerAddress, aP as CustomerAddressesSelect, e as CustomerAuthOperations, z as CustomerGroup, D as CustomerGroupImage, aR as CustomerGroupImagesSelect, aQ as CustomerGroupsSelect, aO as CustomersSelect, N as Discount, aU as DiscountsSelect, Z as Document, a$ as DocumentCategoriesSelect, a0 as DocumentCategory, $ as DocumentImage, b1 as DocumentImagesSelect, _ as DocumentType, b0 as DocumentTypesSelect, a_ as DocumentsSelect, j as EmailLog, am as EmailLogsSelect, K as ExchangeProduct, aM as ExchangeProductsSelect, aL as ExchangesSelect, a7 as Flow, a9 as FlowEdgeType, ba as FlowEdgeTypesSelect, aa as FlowImage, bb as FlowImagesSelect, a8 as FlowNodeType, b9 as FlowNodeTypesSelect, b8 as FlowsSelect, F as Form, ae as FormSubmission, bg as FormSubmissionsSelect, bf as FormsSelect, H as FulfillmentItem, aI as FulfillmentItemsSelect, aH as FulfillmentsSelect, b5 as GalleriesSelect, a4 as Gallery, b7 as GalleryCategoriesSelect, a6 as GalleryCategory, a5 as GalleryImage, b6 as GalleryImagesSelect, I as IframeBlock, ac as LiveStream, ad as LiveStreamImage, be as LiveStreamImagesSelect, bd as LiveStreamsSelect, M as Media, ak as MediaSelect, a2 as Music, b3 as MusicsSelect, aE as OrderProductsSelect, L as OrderStatusLog, aG as OrderStatusLogsSelect, aD as OrdersSelect, af as PayloadKv, bh as PayloadKvSelect, ag as PayloadLockedDocument, bi as PayloadLockedDocumentsSelect, ai as PayloadMigration, bk as PayloadMigrationsSelect, ah as PayloadPreference, bj as PayloadPreferencesSelect, f as PlayerBlock, a1 as Playlist, a3 as PlaylistImage, b4 as PlaylistImagesSelect, b2 as PlaylistsSelect, Q as Post, W as PostAuthor, aW as PostAuthorsSelect, aX as PostCategoriesSelect, X as PostCategory, V as PostImage, aZ as PostImagesSelect, Y as PostTag, aY as PostTagsSelect, aV as PostsSelect, ax as ProductCategoriesSelect, t as ProductCategory, v as ProductCollection, az as ProductCollectionsSelect, q as ProductImage, aC as ProductImagesSelect, s as ProductOption, aw as ProductOptionsSelect, u as ProductTag, ay as ProductTagsSelect, r as ProductVariant, av as ProductVariantsSelect, au as ProductsSelect, J as ReturnProduct, aK as ReturnProductsSelect, aJ as ReturnsSelect, aN as ShippingPoliciesSelect, x as ShippingPolicy, n as Subscription, aq as SubscriptionsSelect, S as SupportedTimezones, i as Tenant, p as TenantLogo, as as TenantLogosSelect, ao as TenantMetadataSelect, k as TenantMetadatum, l as TenantOgImage, at as TenantOgImagesSelect, an as TenantsSelect, aF as TransactionsSelect, h as User, U as UserAuthOperations, aj as UsersSelect, ab as Video, bc as VideosSelect } from './payload-types-2wbfaDxp.cjs';
+import { F as FetchOptions, A as ApiQueryOptions, P as PayloadFindResponse, a as PayloadMutationResponse, S as SDKError, C as ClientBrowserConfig, b as ClientState, c as ClientServerConfig } from './auth-CAV8xgZk.cjs';
+export { x as API_URLS, f as ApiError, H as ApiQueryReactOptions, z as ClientMetadata, g as ConfigError, d as DebugConfig, D as DeepPartial, w as Environment, e as ErrorLogger, E as ExtractArrayType, G as GoneError, J as JwtPayload, N as NetworkError, B as PaginationMeta, R as RetryConfig, h as ServiceUnavailableError, T as TimeoutError, U as UsageLimitError, V as ValidationError, t as createApiKey, r as createServerToken, s as decodeServerToken, l as isApiError, m as isConfigError, o as isGoneError, j as isNetworkError, i as isSDKError, p as isServiceUnavailableError, n as isTimeoutError, q as isUsageLimitError, k as isValidationError, u as parseApiKey, y as resolveApiUrl, v as verifyServerToken } from './auth-CAV8xgZk.cjs';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
-import { P as PublicCollection, C as CollectionType } from './webhook-B9foVPGW.cjs';
-export { b as COLLECTIONS, a as Collection, c as WebhookEvent, d as WebhookHandler, W as WebhookOperation, e as WebhookOptions, f as createTypedWebhookHandler, h as handleWebhook, i as isValidWebhookEvent } from './webhook-B9foVPGW.cjs';
+import { P as PublicCollection, C as CollectionType } from './webhook-Byzl1A0g.cjs';
+export { b as COLLECTIONS, a as Collection, c as WebhookEvent, d as WebhookHandler, W as WebhookOperation, e as WebhookOptions, f as createTypedWebhookHandler, h as handleWebhook, i as isValidWebhookEvent } from './webhook-Byzl1A0g.cjs';
 import { Metadata } from 'next';
 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.cjs';
 import 'payload';
@@ -16,12 +16,18 @@ interface OrderApiOptions {
     baseUrl?: string;
 }
 type CreateOrderParams = {
-    paymentId: string;
     orderNumber: string;
-    email: string;
+    customer?: string;
+    customerSnapshot: {
+        name?: string;
+        email: string;
+        phone?: string;
+    };
     shippingAddress: Order['shippingAddress'];
     orderProducts: Omit<OrderProduct, 'id' | 'brand' | 'createdAt' | 'updatedAt' | 'order' | 'status'>[];
     totalAmount: number;
+    paymentId?: string;
+    discountCode?: string;
 };
 type UpdateOrderParams = {
     orderNumber: string;
@@ -30,18 +36,45 @@ type UpdateOrderParams = {
 type UpdateTransactionParams = {
     paymentId: string;
     status: Transaction['status'];
-    paymentMethod: Transaction['paymentMethod'];
-    receiptUrl: Transaction['receiptUrl'];
+    paymentMethod?: string;
+    receiptUrl?: string;
 };
 type CheckoutParams = {
     cartId: string;
-    paymentId: string;
     orderNumber: string;
     customerSnapshot: {
         name?: string;
         email: string;
         phone?: string;
     };
+    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;
+    baseFee: number;
+    extraFee: number;
+    freeShipping: boolean;
+    freeShippingThreshold: number | null;
+    isJeju: boolean;
 };
 type CreateFulfillmentParams = {
     orderNumber: string;
@@ -52,6 +85,12 @@ type CreateFulfillmentParams = {
         quantity: number;
     }>;
 };
+type UpdateFulfillmentParams = {
+    fulfillmentId: string;
+    status: 'packed' | 'shipped' | 'delivered' | 'failed';
+    carrier?: string;
+    trackingNumber?: string;
+};
 type GetOrderParams = {
     orderNumber: string;
 };
@@ -71,7 +110,7 @@ type UpdateReturnParams = {
 };
 type ReturnWithRefundParams = {
     orderNumber: string;
-    reason?: string;
+    reason?: 'change_of_mind' | 'defective' | 'wrong_delivery' | 'damaged' | 'other';
     reasonDetail?: string;
     returnProducts: Array<{
         orderProduct: string;
@@ -81,6 +120,19 @@ type ReturnWithRefundParams = {
     paymentId: string;
     refundReceiptUrl?: string;
 };
+type CreateExchangeParams = {
+    orderNumber: string;
+    reason?: 'wrong_size' | 'wrong_color' | 'defective' | 'other';
+    reasonDetail?: string;
+    exchangeProducts: Array<{
+        orderProduct: string;
+        quantity: number;
+    }>;
+};
+type UpdateExchangeParams = {
+    exchangeId: string;
+    status: 'processing' | 'shipped' | 'completed' | 'rejected';
+};
 declare class OrderApi {
     private readonly clientKey;
     private readonly secretKey;
@@ -93,12 +145,17 @@ declare class OrderApi {
     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>;
+    createExchange(params: CreateExchangeParams): Promise<Exchange>;
+    updateExchange(params: UpdateExchangeParams): Promise<Exchange>;
 }
 
 interface CartApiOptions {
@@ -106,6 +163,7 @@ interface CartApiOptions {
     secretKey?: string;
     customerToken?: string | (() => string | null);
     baseUrl?: string;
+    onUnauthorized?: () => Promise<string | null>;
 }
 type AddItemParams = {
     cartId: string;
@@ -121,18 +179,35 @@ type UpdateItemParams = {
 type RemoveItemParams = {
     cartItemId: string;
 };
+type ApplyDiscountParams = {
+    cartId: string;
+    discountCode: string;
+};
+type RemoveDiscountParams = {
+    cartId: string;
+};
+type ClearCartParams = {
+    cartId: string;
+};
 declare class CartApi {
     private readonly clientKey;
     private readonly secretKey?;
     private readonly customerToken?;
     private readonly baseUrl?;
+    private readonly onUnauthorized?;
     constructor(options: CartApiOptions);
-    private request;
+    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 ProductApiOptions {
@@ -177,7 +252,8 @@ declare class HttpClient {
     protected secretKey?: string;
     protected baseUrl?: string;
     private getCustomerToken?;
-    constructor(clientKey: string, secretKey?: string, baseUrl?: string, getCustomerToken?: () => string | null);
+    private onUnauthorized?;
+    constructor(clientKey: string, secretKey?: string, baseUrl?: string, getCustomerToken?: () => string | null, onUnauthorized?: () => Promise<string | null>);
     protected get defaultOptions(): FetchOptions;
     protected buildUrl(endpoint: string, options?: ApiQueryOptions): string;
     protected assertJsonResponse(response: Response): void;
@@ -199,7 +275,7 @@ declare class HttpClient {
 }
 
 declare class CollectionClient extends HttpClient {
-    constructor(clientKey: string, secretKey?: string, baseUrl?: string, getCustomerToken?: () => string | null);
+    constructor(clientKey: string, secretKey?: string, baseUrl?: string, getCustomerToken?: () => string | null, onUnauthorized?: () => Promise<string | null>);
     from<T extends PublicCollection>(collection: T): CollectionQueryBuilder<T>;
     /**
      * Find documents (list query)
@@ -368,6 +444,11 @@ interface CustomerLoginData {
 interface CustomerRefreshResponse {
     token: string;
 }
+interface UpdateProfileData {
+    name?: string;
+    phone?: string;
+    marketingConsent?: boolean;
+}
 interface CustomerAuthOptions {
     /**
      * Automatically persist token in localStorage.
@@ -395,6 +476,7 @@ declare class CustomerAuth {
     private baseUrl;
     private token;
     private onTokenChange?;
+    private refreshPromise;
     constructor(clientKey: string, baseUrl: string, options?: CustomerAuthOptions);
     /**
      * Register a new customer account
@@ -410,6 +492,7 @@ declare class CustomerAuth {
      * Refresh the current token. Requires a valid (non-expired) token.
      */
     refreshToken(): Promise<CustomerRefreshResponse>;
+    private _doRefreshToken;
     /**
      * Clear the stored token
      */
@@ -426,6 +509,10 @@ declare class CustomerAuth {
      * Reset password using a token from the reset email
      */
     resetPassword(token: string, password: string): Promise<void>;
+    /**
+     * Update the authenticated customer's profile (name, phone, marketingConsent)
+     */
+    updateProfile(data: UpdateProfileData): Promise<CustomerProfile>;
     /**
      * Change the password of the currently authenticated customer
      */
@@ -434,6 +521,14 @@ declare class CustomerAuth {
      * Verify email using the verification token
      */
     verifyEmail(token: string): Promise<void>;
+    /**
+     * Get the authenticated customer's orders with pagination and optional status filter
+     */
+    getMyOrders(options?: {
+        page?: number;
+        limit?: number;
+        status?: string;
+    }): Promise<unknown>;
     /**
      * Get the current token (or null if not authenticated)
      */
@@ -550,9 +645,9 @@ declare class QueryHooks {
         collection: T;
     }, options?: {
         onSuccess?: (data: PayloadMutationResponse<CollectionType<T>>) => void;
-        onError?: (error: Error) => void;
+        onError?: (error: SDKError) => void;
         onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<PayloadMutationResponse<CollectionType<T>>, Error, {
+    }): _tanstack_react_query.UseMutationResult<PayloadMutationResponse<CollectionType<T>>, SDKError, {
         data: Partial<CollectionType<T>>;
         file?: File | Blob;
         filename?: string;
@@ -561,9 +656,9 @@ declare class QueryHooks {
         collection: T;
     }, options?: {
         onSuccess?: (data: PayloadMutationResponse<CollectionType<T>>) => void;
-        onError?: (error: Error) => void;
+        onError?: (error: SDKError) => void;
         onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<PayloadMutationResponse<CollectionType<T>>, Error, {
+    }): _tanstack_react_query.UseMutationResult<PayloadMutationResponse<CollectionType<T>>, SDKError, {
         id: string;
         data: Partial<CollectionType<T>>;
         file?: File | Blob;
@@ -573,9 +668,9 @@ declare class QueryHooks {
         collection: T;
     }, options?: {
         onSuccess?: (data: CollectionType<T>) => void;
-        onError?: (error: Error) => void;
+        onError?: (error: SDKError) => void;
         onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<CollectionType<T>, Error, string, unknown>;
+    }): _tanstack_react_query.UseMutationResult<CollectionType<T>, SDKError, string, unknown>;
     invalidateQueries<T extends PublicCollection>(collection: T, type?: 'list' | 'detail' | 'infinite'): Promise<void>;
     getQueryData<T extends PublicCollection>(collection: T, type: 'list', options?: ApiQueryOptions): CollectionType<T>[] | undefined;
     getQueryData<T extends PublicCollection>(collection: T, type: 'detail', id: string, options?: ApiQueryOptions): CollectionType<T> | null | undefined;
@@ -592,51 +687,56 @@ declare class QueryHooks {
     }): _tanstack_react_query.UseQueryResult<CustomerProfile | null, Error>;
     useCustomerLogin(options?: {
         onSuccess?: (data: CustomerAuthResponse) => void;
-        onError?: (error: Error) => void;
+        onError?: (error: SDKError) => void;
         onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<CustomerAuthResponse, Error, CustomerLoginData, unknown>;
+    }): _tanstack_react_query.UseMutationResult<CustomerAuthResponse, SDKError, CustomerLoginData, unknown>;
     useCustomerRegister(options?: {
         onSuccess?: (data: {
             customer: CustomerProfile;
         }) => void;
-        onError?: (error: Error) => void;
+        onError?: (error: SDKError) => void;
         onSettled?: () => void;
     }): _tanstack_react_query.UseMutationResult<{
         customer: CustomerProfile;
-    }, Error, CustomerRegisterData, unknown>;
+    }, SDKError, CustomerRegisterData, unknown>;
     useCustomerLogout(options?: {
         onSuccess?: () => void;
-        onError?: (error: Error) => void;
+        onError?: (error: SDKError) => void;
         onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<void, Error, void, unknown>;
+    }): _tanstack_react_query.UseMutationResult<void, SDKError, void, unknown>;
     useCustomerForgotPassword(options?: {
         onSuccess?: () => void;
-        onError?: (error: Error) => void;
+        onError?: (error: SDKError) => void;
         onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
+    }): _tanstack_react_query.UseMutationResult<void, SDKError, string, unknown>;
     useCustomerResetPassword(options?: {
         onSuccess?: () => void;
-        onError?: (error: Error) => void;
+        onError?: (error: SDKError) => void;
         onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<void, Error, {
+    }): _tanstack_react_query.UseMutationResult<void, SDKError, {
         token: string;
         password: string;
     }, unknown>;
     useCustomerVerifyEmail(options?: {
         onSuccess?: () => void;
-        onError?: (error: Error) => void;
+        onError?: (error: SDKError) => void;
         onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
+    }): _tanstack_react_query.UseMutationResult<void, SDKError, string, unknown>;
     useCustomerRefreshToken(options?: {
         onSuccess?: (data: CustomerRefreshResponse) => void;
-        onError?: (error: Error) => void;
+        onError?: (error: SDKError) => void;
         onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<CustomerRefreshResponse, Error, void, unknown>;
+    }): _tanstack_react_query.UseMutationResult<CustomerRefreshResponse, SDKError, void, unknown>;
+    useCustomerUpdateProfile(options?: {
+        onSuccess?: (data: CustomerProfile) => void;
+        onError?: (error: SDKError) => void;
+        onSettled?: () => void;
+    }): _tanstack_react_query.UseMutationResult<CustomerProfile, SDKError, UpdateProfileData, unknown>;
     useCustomerChangePassword(options?: {
         onSuccess?: () => void;
-        onError?: (error: Error) => void;
+        onError?: (error: SDKError) => void;
         onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<void, Error, {
+    }): _tanstack_react_query.UseMutationResult<void, SDKError, {
         currentPassword: string;
         newPassword: string;
     }, unknown>;
@@ -657,6 +757,7 @@ declare class BrowserClient {
     constructor(options: ClientBrowserConfig);
     from<T extends PublicCollection>(collection: T): ReadOnlyQueryBuilder<T>;
     getState(): ClientState;
+    getConfig(): ClientBrowserConfig;
 }
 declare function createBrowserClient(options: ClientBrowserConfig): BrowserClient;
 
@@ -681,7 +782,10 @@ declare function getQueryClient(): QueryClient;
 
 declare const generateOrderNumber: () => string;
 
-declare const formatOrderName: (options: ProductOption[]) => string;
+type OrderItem = {
+    product: Product | string | null | undefined;
+};
+declare const formatOrderName: (items: OrderItem[]) => string;
 
 /**
  * Resolves a Payload CMS relation field value.
@@ -696,4 +800,88 @@ declare const resolveRelation: <T>(ref: T | string | null | undefined) => T | nu
 /** @deprecated Use `resolveRelation` instead */
 declare const objectFor: <T>(ref: T | string | null | undefined) => T | null;
 
-export { type AddItemParams, ApiQueryOptions, BrowserClient, BrowserClient as BrowserClientType, CartApi, type CartApiOptions, CartItem, type CheckoutParams, ClientBrowserConfig, ClientServerConfig, ClientState, CollectionClient, type CollectionDetailQueryParams, type CollectionInfiniteQueryParams, CollectionQueryBuilder, type CollectionQueryParams, CollectionType, type CreateFulfillmentParams, type CreateOrderParams, type CreateReturnParams, CustomerAuth, type CustomerAuthOptions, type CustomerAuthResponse, type CustomerLoginData, type CustomerProfile, type CustomerRefreshResponse, type CustomerRegisterData, Fulfillment, type GenerateMetadataOptions, type GetOrderParams, Order, OrderApi, type OrderApiOptions, OrderProduct, PayloadFindResponse, PayloadMutationResponse, ProductApi, type ProductApiOptions, ProductOption, PublicCollection, QueryHooks, type ReadOnlyQueryBuilder, type ReadOnlyQueryHooks, type RemoveItemParams, Return, type ReturnWithRefundParams, ServerClient, ServerClient as ServerClientType, type StockCheckParams, type StockCheckResponse, type StockCheckResult, Transaction, type UpdateItemParams, type UpdateOrderParams, type UpdateReturnParams, type UpdateTransactionParams, collectionKeys, createBrowserClient, createServerClient, customerKeys, formatOrderName, generateOrderNumber, getQueryClient, objectFor, resolveRelation };
+interface VideoThumbnailOptions {
+    /** Width in pixels (default: 640) */
+    width?: number;
+    /** Height in pixels (auto if omitted) */
+    height?: number;
+    /** Time offset in seconds (default: 0) */
+    time?: number;
+    /** Fit mode (default: 'smartcrop') */
+    fitMode?: 'preserve' | 'stretch' | 'crop' | 'smartcrop' | 'pad';
+    /** Flip horizontally */
+    flipH?: boolean;
+    /** Flip vertically */
+    flipV?: boolean;
+    /** Rotation in degrees (90, 180, 270) */
+    rotate?: 90 | 180 | 270;
+}
+/**
+ * Returns a Mux thumbnail URL for a video.
+ *
+ * @example
+ * ```ts
+ * getVideoThumbnail('abc123')
+ * // => 'https://image.mux.com/abc123/thumbnail.jpg?width=640'
+ *
+ * getVideoThumbnail('abc123', { width: 320, time: 5 })
+ * // => 'https://image.mux.com/abc123/thumbnail.jpg?width=320&time=5'
+ * ```
+ */
+declare function getVideoThumbnail(playbackId: string, options?: VideoThumbnailOptions): string;
+interface VideoGifOptions {
+    /** Width in pixels (default: 320) */
+    width?: number;
+    /** Start time in seconds (default: 0) */
+    start?: number;
+    /** End time in seconds (default: start + 5) */
+    end?: number;
+    /** Frames per second (default: 15) */
+    fps?: number;
+}
+/**
+ * Returns a Mux animated GIF URL for a video.
+ *
+ * @example
+ * ```ts
+ * getVideoGif('abc123')
+ * // => 'https://image.mux.com/abc123/animated.gif?width=320'
+ *
+ * getVideoGif('abc123', { width: 240, start: 2, end: 6 })
+ * // => 'https://image.mux.com/abc123/animated.gif?width=240&start=2&end=6'
+ * ```
+ */
+declare function getVideoGif(playbackId: string, options?: VideoGifOptions): string;
+/**
+ * Returns a Mux storyboard VTT URL for timeline hover previews.
+ *
+ * @example
+ * ```ts
+ * getVideoStoryboard('abc123')
+ * // => 'https://image.mux.com/abc123/storyboard.vtt'
+ * ```
+ */
+declare function getVideoStoryboard(playbackId: string): string;
+/**
+ * Returns the HLS stream URL for a video.
+ *
+ * @example
+ * ```ts
+ * getVideoStreamUrl('abc123')
+ * // => 'https://stream.mux.com/abc123.m3u8'
+ * ```
+ */
+declare function getVideoStreamUrl(playbackId: string): string;
+/**
+ * Returns a Mux MP4 download URL for a video.
+ * Only available if the asset was created with `mp4_support` enabled.
+ *
+ * @example
+ * ```ts
+ * getVideoMp4Url('abc123', 'high')
+ * // => 'https://stream.mux.com/abc123/high.mp4'
+ * ```
+ */
+declare function getVideoMp4Url(playbackId: string, resolution?: 'high' | 'medium' | 'low'): string;
+
+export { type AddItemParams, ApiQueryOptions, type ApplyDiscountParams, BrowserClient, BrowserClient as BrowserClientType, type CalculateShippingParams, type CalculateShippingResult, Cart, CartApi, type CartApiOptions, CartItem, type CheckoutParams, type ClearCartParams, ClientBrowserConfig, ClientServerConfig, ClientState, CollectionClient, type CollectionDetailQueryParams, type CollectionInfiniteQueryParams, CollectionQueryBuilder, type CollectionQueryParams, CollectionType, type CreateExchangeParams, type CreateFulfillmentParams, type CreateOrderParams, type CreateReturnParams, CustomerAuth, type CustomerAuthOptions, type CustomerAuthResponse, type CustomerLoginData, type CustomerProfile, type CustomerRefreshResponse, type CustomerRegisterData, Exchange, Fulfillment, type GenerateMetadataOptions, type GetOrderParams, Order, OrderApi, type OrderApiOptions, OrderProduct, PayloadFindResponse, PayloadMutationResponse, Product, ProductApi, type ProductApiOptions, PublicCollection, QueryHooks, type ReadOnlyQueryBuilder, type ReadOnlyQueryHooks, type RemoveDiscountParams, type RemoveItemParams, Return, type ReturnWithRefundParams, SDKError, ServerClient, ServerClient as ServerClientType, type StockCheckParams, type StockCheckResponse, type StockCheckResult, Transaction, type UpdateExchangeParams, type UpdateFulfillmentParams, type UpdateItemParams, type UpdateOrderParams, type UpdateProfileData, type UpdateReturnParams, type UpdateTransactionParams, type ValidateDiscountParams, type ValidateDiscountResult, type VideoGifOptions, type VideoThumbnailOptions, collectionKeys, createBrowserClient, createServerClient, customerKeys, formatOrderName, generateOrderNumber, getQueryClient, getVideoGif, getVideoMp4Url, getVideoStoryboard, getVideoStreamUrl, getVideoThumbnail, objectFor, resolveRelation };