@01.software/sdk 0.2.9-dev.260309.c56872d → 0.2.9-dev.260311.892250f

package/dist/index.d.cts

@@ -1,20 +1,228 @@
-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 { 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-BjvBwB8Z.cjs';
+export { n as ApiUsage, az as ApiUsageSelect, A as Audience, av as AudiencesSelect, bE as Auth, p as BillingHistory, aB as BillingHistorySelect, D as Brand, B as BrandLogo, aL as BrandLogosSelect, aK as BrandsSelect, b1 as CartItemsSelect, b0 as CartsSelect, g as CodeBlock, bD as CollectionsWidget, d as Config, J as Customer, Q as CustomerAddress, aZ as CustomerAddressesSelect, e as CustomerAuthOperations, K as CustomerGroup, N as CustomerGroupImage, a$ as CustomerGroupImagesSelect, a_ as CustomerGroupsSelect, aY as CustomersSelect, _ as Discount, b2 as DiscountsSelect, a4 as Document, b9 as DocumentCategoriesSelect, a7 as DocumentCategory, a5 as DocumentImage, bb as DocumentImagesSelect, a6 as DocumentType, ba as DocumentTypesSelect, b8 as DocumentsSelect, k as EmailLog, aw as EmailLogsSelect, Y as ExchangeProduct, aW as ExchangeProductsSelect, aV as ExchangesSelect, j as FieldConfig, at as FieldConfigsSelect, ah as Flow, bo as FlowCategoriesSelect, ai as FlowCategory, am as FlowEdgeType, bn as FlowEdgeTypesSelect, aj as FlowImage, bp as FlowImagesSelect, al as FlowNodeType, bm as FlowNodeTypesSelect, ak as FlowTag, bq as FlowTagsSelect, bl as FlowsSelect, F as Form, an as FormSubmission, by as FormSubmissionsSelect, bx as FormsSelect, W as FulfillmentItem, aS as FulfillmentItemsSelect, aR as FulfillmentsSelect, bh as GalleriesSelect, ad as Gallery, bj as GalleryCategoriesSelect, ae as GalleryCategory, af as GalleryImage, bi as GalleryImagesSelect, ag as GalleryTag, bk as GalleryTagsSelect, I as IframeBlock, L as LiveStream, s as LiveStreamImage, bw as LiveStreamImagesSelect, bv as LiveStreamsSelect, M as Media, au as MediaSelect, ac as Music, bf as MusicsSelect, aO as OrderProductsSelect, Z as OrderStatusLog, aQ as OrderStatusLogsSelect, aN as OrdersSelect, ao as PayloadKv, bz as PayloadKvSelect, ap as PayloadLockedDocument, bA as PayloadLockedDocumentsSelect, ar as PayloadMigration, bC as PayloadMigrationsSelect, aq as PayloadPreference, bB as PayloadPreferencesSelect, f as PlayerBlock, a8 as Playlist, bd as PlaylistCategoriesSelect, a9 as PlaylistCategory, aa as PlaylistImage, bg as PlaylistImagesSelect, ab as PlaylistTag, be as PlaylistTagsSelect, bc as PlaylistsSelect, $ as Post, a0 as PostAuthor, b4 as PostAuthorsSelect, b5 as PostCategoriesSelect, a2 as PostCategory, a1 as PostImage, b7 as PostImagesSelect, a3 as PostTag, b6 as PostTagsSelect, b3 as PostsSelect, aH as ProductCategoriesSelect, y as ProductCategory, H as ProductCollection, aJ as ProductCollectionsSelect, r as ProductImage, aM as ProductImagesSelect, x as ProductOption, aG as ProductOptionsSelect, z as ProductTag, aI as ProductTagsSelect, w as ProductVariant, aF as ProductVariantsSelect, aE as ProductsSelect, X as ReturnProduct, aU as ReturnProductsSelect, aT as ReturnsSelect, aX as ShippingPoliciesSelect, G as ShippingPolicy, o as Subscription, aA as SubscriptionsSelect, S as SupportedTimezones, i as Tenant, q as TenantLogo, aC as TenantLogosSelect, ay as TenantMetadataSelect, l as TenantMetadatum, m as TenantOgImage, aD as TenantOgImagesSelect, ax as TenantsSelect, aP as TransactionsSelect, h as User, U as UserAuthOperations, as as UsersSelect, V as Video, bs as VideoCategoriesSelect, u as VideoCategory, t as VideoImage, bu as VideoImagesSelect, v as VideoTag, bt as VideoTagsSelect, br as VideosSelect } from './payload-types-BjvBwB8Z.cjs';
+import { Sort, Where } from 'payload';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
-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 { P as PublicCollection, C as CollectionType } from './webhook-CszIpUKn.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-CszIpUKn.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';
+export { JwtPayload, createApiKey, createServerToken, decodeServerToken, parseApiKey, verifyServerToken } from './auth.cjs';
 
-interface OrderApiOptions {
+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);
+}
+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;
+        };
+        name: string;
+        code: string;
+        message: string;
+        status: number | undefined;
+        details: unknown;
+        userMessage: string | undefined;
+        suggestion: string | undefined;
+    };
+}
+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;
+
+type Environment = 'local' | 'development' | 'staging' | 'production';
+declare const API_URLS: Record<Environment, string>;
+/**
+ * 환경에 맞는 API URL을 반환합니다.
+ * 우선순위: baseUrl > environment > 환경변수 > 기본값(production)
+ */
+declare function resolveApiUrl(config?: {
+    baseUrl?: string;
+    environment?: Environment;
+}): string;
+interface ClientBrowserConfig {
+    clientKey: string;
+    /**
+     * API 환경 설정.
+     * - 'local': localhost:3000
+     * - 'development': dev.01.software
+     * - 'staging': stg.01.software
+     * - 'production': api.01.software
+     *
+     * baseUrl이 설정되면 이 값은 무시됩니다.
+     * @default 'production'
+     */
+    environment?: Environment;
+    /**
+     * 커스텀 API URL. 설정 시 environment 값은 무시됩니다.
+     * @example 'https://my-custom-api.example.com'
+     */
+    baseUrl?: string;
+    /**
+     * Customer authentication options.
+     * Used to initialize CustomerAuth on BrowserClient.
+     */
+    customer?: {
+        /**
+         * Automatically persist token in localStorage.
+         * - `true`: uses default key `'customer-token'`
+         * - `string`: uses the given string as localStorage key
+         *
+         * Handles SSR safely (no-op on server).
+         * When set, `token` and `onTokenChange` are ignored.
+         */
+        persist?: boolean | string;
+        /** Initial token (e.g. from SSR cookie) */
+        token?: string;
+        /** Called when token changes (login/logout) — use to persist in localStorage/cookie */
+        onTokenChange?: (token: string | null) => void;
+    };
+}
+interface ClientServerConfig extends ClientBrowserConfig {
+    secretKey: string;
+}
+interface ClientMetadata {
+    userAgent?: string;
+    timestamp: number;
+}
+interface ClientState {
+    metadata: ClientMetadata;
+}
+interface PaginationMeta {
+    page: number;
+    limit: number;
+    totalDocs: number;
+    totalPages: number;
+    hasNextPage: boolean;
+    hasPrevPage: boolean;
+    pagingCounter: number;
+    prevPage: number | null;
+    nextPage: number | null;
+}
+/**
+ * Payload CMS Find (List) Response
+ * GET /api/{collection}
+ */
+interface PayloadFindResponse<T = unknown> {
+    docs: T[];
+    totalDocs: number;
+    limit: number;
+    totalPages: number;
+    page: number;
+    pagingCounter: number;
+    hasPrevPage: boolean;
+    hasNextPage: boolean;
+    prevPage: number | null;
+    nextPage: number | null;
+}
+/**
+ * Payload CMS Create/Update Response
+ * POST /api/{collection}
+ * PATCH /api/{collection}/{id}
+ */
+interface PayloadMutationResponse<T = unknown> {
+    message: string;
+    doc: T;
+    errors?: unknown[];
+}
+interface ApiQueryOptions {
+    page?: number;
+    limit?: number;
+    sort?: Sort;
+    where?: Where;
+    depth?: number;
+    select?: Record<string, boolean>;
+}
+interface ApiQueryReactOptions {
+    keepPreviousData?: boolean;
+}
+interface DebugConfig {
+    logRequests?: boolean;
+    logResponses?: boolean;
+    logErrors?: boolean;
+}
+interface RetryConfig {
+    maxRetries?: number;
+    retryableStatuses?: number[];
+    retryDelay?: (attempt: number) => number;
+}
+interface ErrorLogger {
+    log(error: SDKError | Error, context?: Record<string, unknown>): void;
+}
+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;
+
+interface ServerApiOptions {
     clientKey: string;
     secretKey: string;
     baseUrl?: string;
 }
+declare abstract class BaseApi {
+    protected readonly clientKey: string;
+    protected readonly secretKey: string;
+    protected readonly baseUrl?: string;
+    constructor(apiName: string, options: ServerApiOptions);
+    protected request<T>(endpoint: string, body: unknown): Promise<T>;
+}
+
+type OrderApiOptions = ServerApiOptions;
 type CreateOrderParams = {
     orderNumber: string;
     customer?: string;
@@ -26,6 +234,7 @@ type CreateOrderParams = {
     shippingAddress: Order['shippingAddress'];
     orderProducts: Omit<OrderProduct, 'id' | 'brand' | 'createdAt' | 'updatedAt' | 'order' | 'status'>[];
     totalAmount: number;
+    shippingFee?: number;
     paymentId?: string;
     discountCode?: string;
 };
@@ -133,12 +342,8 @@ type UpdateExchangeParams = {
     exchangeId: string;
     status: 'processing' | 'shipped' | 'completed' | 'rejected';
 };
-declare class OrderApi {
-    private readonly clientKey;
-    private readonly secretKey;
-    private readonly baseUrl?;
+declare class OrderApi extends BaseApi {
     constructor(options: OrderApiOptions);
-    private request;
     createOrder(params: CreateOrderParams): Promise<Order>;
     updateOrder(params: UpdateOrderParams): Promise<Order>;
     getOrder(params: GetOrderParams): Promise<Order>;
@@ -210,11 +415,7 @@ declare class CartApi {
     }>;
 }
 
-interface ProductApiOptions {
-    clientKey: string;
-    secretKey: string;
-    baseUrl?: string;
-}
+type ProductApiOptions = ServerApiOptions;
 type StockCheckParams = {
     items: Array<{
         optionId: string;
@@ -232,21 +433,27 @@ type StockCheckResponse = {
     results: StockCheckResult[];
     allAvailable: boolean;
 };
-declare class ProductApi {
-    private readonly clientKey;
-    private readonly secretKey;
-    private readonly baseUrl?;
+declare class ProductApi extends BaseApi {
     constructor(options: ProductApiOptions);
-    private request;
     stockCheck(params: StockCheckParams): Promise<StockCheckResponse>;
 }
 
 interface GenerateMetadataOptions {
-    title?: string;
-    description?: string;
     siteName?: string;
 }
 
+interface FetchOptions extends RequestInit {
+    clientKey?: string;
+    secretKey?: string;
+    customerToken?: string;
+    timeout?: number;
+    baseUrl?: string;
+    debug?: boolean | DebugConfig;
+    retry?: RetryConfig;
+    /** Called on 401 when customerToken is set. Return a new token to retry, or null to fail. */
+    onUnauthorized?: () => Promise<string | null>;
+}
+
 declare class HttpClient {
     protected clientKey: string;
     protected secretKey?: string;
@@ -528,7 +735,7 @@ declare class CustomerAuth {
         page?: number;
         limit?: number;
         status?: string;
-    }): Promise<unknown>;
+    }): Promise<PayloadFindResponse<Order>>;
     /**
      * Get the current token (or null if not authenticated)
      */
@@ -548,19 +755,6 @@ declare class CustomerAuth {
     private requestJson;
 }
 
-declare function collectionKeys<T extends PublicCollection>(collection: T): {
-    all: readonly [T];
-    lists: () => readonly [T, "list"];
-    list: (options?: ApiQueryOptions) => readonly [T, "list", ApiQueryOptions | undefined];
-    details: () => readonly [T, "detail"];
-    detail: (id: string, options?: ApiQueryOptions) => readonly [T, "detail", string, ApiQueryOptions | undefined];
-    infinites: () => readonly [T, "infinite"];
-    infinite: (options?: Omit<ApiQueryOptions, "page">) => readonly [T, "infinite", Omit<ApiQueryOptions, "page"> | undefined];
-};
-declare const customerKeys: {
-    all: readonly ["customer"];
-    me: () => readonly ["customer", "me"];
-};
 interface CollectionQueryParams<T extends PublicCollection> {
     collection: T;
     options?: ApiQueryOptions;
@@ -575,62 +769,31 @@ interface CollectionInfiniteQueryParams<T extends PublicCollection> {
     options?: Omit<ApiQueryOptions, 'page'>;
     pageSize?: number;
 }
-type ReadOnlyQueryHooks = Omit<QueryHooks, 'useCreate' | 'useUpdate' | 'useRemove'>;
-declare class QueryHooks {
-    private queryClient;
-    private collectionClient;
-    private customerAuth?;
-    constructor(queryClient: QueryClient, collectionClient: CollectionClient, customerAuth?: CustomerAuth);
-    private ensureCustomerAuth;
-    useQuery<T extends PublicCollection>(params: CollectionQueryParams<T>, options?: {
-        enabled?: boolean;
-        staleTime?: number;
-        gcTime?: number;
-        refetchOnWindowFocus?: boolean;
-        refetchOnMount?: boolean;
-        refetchInterval?: number | false;
-        retry?: boolean | number;
-    }): _tanstack_react_query.UseQueryResult<CollectionType<T>[], Error>;
-    useSuspenseQuery<T extends PublicCollection>(params: CollectionQueryParams<T>, options?: {
-        staleTime?: number;
-        gcTime?: number;
-        refetchOnWindowFocus?: boolean;
-        refetchOnMount?: boolean;
-        refetchInterval?: number | false;
-        retry?: boolean | number;
-    }): _tanstack_react_query.UseSuspenseQueryResult<CollectionType<T>[], Error>;
-    useQueryById<T extends PublicCollection>(params: CollectionDetailQueryParams<T>, options?: {
-        enabled?: boolean;
-        staleTime?: number;
-        gcTime?: number;
-        refetchOnWindowFocus?: boolean;
-        refetchOnMount?: boolean;
-        refetchInterval?: number | false;
-        retry?: boolean | number;
-    }): _tanstack_react_query.UseQueryResult<_tanstack_react_query.NoInfer<CollectionType<T>>, Error>;
-    useSuspenseQueryById<T extends PublicCollection>(params: CollectionDetailQueryParams<T>, options?: {
-        staleTime?: number;
-        gcTime?: number;
-        refetchOnWindowFocus?: boolean;
-        refetchOnMount?: boolean;
-        refetchInterval?: number | false;
-        retry?: boolean | number;
-    }): _tanstack_react_query.UseSuspenseQueryResult<CollectionType<T>, Error>;
-    useInfiniteQuery<T extends PublicCollection>(params: CollectionInfiniteQueryParams<T>, options?: {
-        enabled?: boolean;
-        staleTime?: number;
-        gcTime?: number;
-        refetchOnWindowFocus?: boolean;
-        refetchOnMount?: boolean;
-        retry?: boolean | number;
-    }): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_react_query.InfiniteData<PayloadFindResponse<CollectionType<T>>, unknown>, Error>;
-    useSuspenseInfiniteQuery<T extends PublicCollection>(params: CollectionInfiniteQueryParams<T>, options?: {
-        staleTime?: number;
-        gcTime?: number;
-        refetchOnWindowFocus?: boolean;
-        refetchOnMount?: boolean;
-        retry?: boolean | number;
-    }): _tanstack_react_query.UseSuspenseInfiniteQueryResult<_tanstack_react_query.InfiniteData<PayloadFindResponse<CollectionType<T>>, unknown>, Error>;
+interface QueryOptions {
+    enabled?: boolean;
+    staleTime?: number;
+    gcTime?: number;
+    refetchOnWindowFocus?: boolean;
+    refetchOnMount?: boolean;
+    refetchInterval?: number | false;
+    retry?: boolean | number;
+}
+type SuspenseQueryOptions = Omit<QueryOptions, 'enabled'>;
+interface MutationCallbacks$1<TData> {
+    onSuccess?: (data: TData) => void;
+    onError?: (error: SDKError) => void;
+    onSettled?: () => void;
+}
+declare class CollectionHooks {
+    protected queryClient: QueryClient;
+    protected collectionClient: CollectionClient;
+    constructor(queryClient: QueryClient, collectionClient: CollectionClient);
+    useQuery<T extends PublicCollection>(params: CollectionQueryParams<T>, options?: QueryOptions): _tanstack_react_query.UseQueryResult<CollectionType<T>[], Error>;
+    useSuspenseQuery<T extends PublicCollection>(params: CollectionQueryParams<T>, options?: SuspenseQueryOptions): _tanstack_react_query.UseSuspenseQueryResult<CollectionType<T>[], Error>;
+    useQueryById<T extends PublicCollection>(params: CollectionDetailQueryParams<T>, options?: QueryOptions): _tanstack_react_query.UseQueryResult<_tanstack_react_query.NoInfer<CollectionType<T>>, Error>;
+    useSuspenseQueryById<T extends PublicCollection>(params: CollectionDetailQueryParams<T>, options?: SuspenseQueryOptions): _tanstack_react_query.UseSuspenseQueryResult<CollectionType<T>, Error>;
+    useInfiniteQuery<T extends PublicCollection>(params: CollectionInfiniteQueryParams<T>, options?: QueryOptions): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_react_query.InfiniteData<PayloadFindResponse<CollectionType<T>>, unknown>, Error>;
+    useSuspenseInfiniteQuery<T extends PublicCollection>(params: CollectionInfiniteQueryParams<T>, options?: SuspenseQueryOptions): _tanstack_react_query.UseSuspenseInfiniteQueryResult<_tanstack_react_query.InfiniteData<PayloadFindResponse<CollectionType<T>>, unknown>, Error>;
     prefetchQuery<T extends PublicCollection>(params: CollectionQueryParams<T>, options?: {
         staleTime?: number;
     }): Promise<void>;
@@ -643,22 +806,14 @@ declare class QueryHooks {
     }): Promise<void>;
     useCreate<T extends PublicCollection>(params: {
         collection: T;
-    }, options?: {
-        onSuccess?: (data: PayloadMutationResponse<CollectionType<T>>) => void;
-        onError?: (error: SDKError) => void;
-        onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<PayloadMutationResponse<CollectionType<T>>, SDKError, {
+    }, options?: MutationCallbacks$1<PayloadMutationResponse<CollectionType<T>>>): _tanstack_react_query.UseMutationResult<PayloadMutationResponse<CollectionType<T>>, SDKError, {
         data: Partial<CollectionType<T>>;
         file?: File | Blob;
         filename?: string;
     }, unknown>;
     useUpdate<T extends PublicCollection>(params: {
         collection: T;
-    }, options?: {
-        onSuccess?: (data: PayloadMutationResponse<CollectionType<T>>) => void;
-        onError?: (error: SDKError) => void;
-        onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<PayloadMutationResponse<CollectionType<T>>, SDKError, {
+    }, options?: MutationCallbacks$1<PayloadMutationResponse<CollectionType<T>>>): _tanstack_react_query.UseMutationResult<PayloadMutationResponse<CollectionType<T>>, SDKError, {
         id: string;
         data: Partial<CollectionType<T>>;
         file?: File | Blob;
@@ -666,16 +821,25 @@ declare class QueryHooks {
     }, unknown>;
     useRemove<T extends PublicCollection>(params: {
         collection: T;
-    }, options?: {
-        onSuccess?: (data: CollectionType<T>) => void;
-        onError?: (error: SDKError) => void;
-        onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<CollectionType<T>, SDKError, string, unknown>;
+    }, options?: MutationCallbacks$1<CollectionType<T>>): _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;
     setQueryData<T extends PublicCollection>(collection: T, type: 'list', data: CollectionType<T>[], options?: ApiQueryOptions): void;
     setQueryData<T extends PublicCollection>(collection: T, type: 'detail', id: string, data: CollectionType<T> | null, options?: ApiQueryOptions): void;
+}
+
+interface MutationCallbacks<TData> {
+    onSuccess?: (data: TData) => void;
+    onError?: (error: SDKError) => void;
+    onSettled?: () => void;
+}
+declare class CustomerHooks {
+    private queryClient;
+    private customerAuth?;
+    constructor(queryClient: QueryClient, customerAuth?: CustomerAuth);
+    private ensureCustomerAuth;
+    private invalidateMe;
     useCustomerMe(options?: {
         enabled?: boolean;
         staleTime?: number;
@@ -685,58 +849,22 @@ declare class QueryHooks {
         refetchInterval?: number | false;
         retry?: boolean | number;
     }): _tanstack_react_query.UseQueryResult<CustomerProfile | null, Error>;
-    useCustomerLogin(options?: {
-        onSuccess?: (data: CustomerAuthResponse) => void;
-        onError?: (error: SDKError) => void;
-        onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<CustomerAuthResponse, SDKError, CustomerLoginData, unknown>;
-    useCustomerRegister(options?: {
-        onSuccess?: (data: {
-            customer: CustomerProfile;
-        }) => void;
-        onError?: (error: SDKError) => void;
-        onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<{
+    useCustomerLogin(options?: MutationCallbacks<CustomerAuthResponse>): _tanstack_react_query.UseMutationResult<CustomerAuthResponse, SDKError, CustomerLoginData, unknown>;
+    useCustomerRegister(options?: MutationCallbacks<{
+        customer: CustomerProfile;
+    }>): _tanstack_react_query.UseMutationResult<{
         customer: CustomerProfile;
     }, SDKError, CustomerRegisterData, unknown>;
-    useCustomerLogout(options?: {
-        onSuccess?: () => void;
-        onError?: (error: SDKError) => void;
-        onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<void, SDKError, void, unknown>;
-    useCustomerForgotPassword(options?: {
-        onSuccess?: () => void;
-        onError?: (error: SDKError) => void;
-        onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<void, SDKError, string, unknown>;
-    useCustomerResetPassword(options?: {
-        onSuccess?: () => void;
-        onError?: (error: SDKError) => void;
-        onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<void, SDKError, {
+    useCustomerLogout(options?: MutationCallbacks<void>): _tanstack_react_query.UseMutationResult<void, SDKError, void, unknown>;
+    useCustomerForgotPassword(options?: MutationCallbacks<void>): _tanstack_react_query.UseMutationResult<void, SDKError, string, unknown>;
+    useCustomerResetPassword(options?: MutationCallbacks<void>): _tanstack_react_query.UseMutationResult<void, SDKError, {
         token: string;
         password: string;
     }, unknown>;
-    useCustomerVerifyEmail(options?: {
-        onSuccess?: () => void;
-        onError?: (error: SDKError) => void;
-        onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<void, SDKError, string, unknown>;
-    useCustomerRefreshToken(options?: {
-        onSuccess?: (data: CustomerRefreshResponse) => void;
-        onError?: (error: SDKError) => void;
-        onSettled?: () => void;
-    }): _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: SDKError) => void;
-        onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<void, SDKError, {
+    useCustomerVerifyEmail(options?: MutationCallbacks<void>): _tanstack_react_query.UseMutationResult<void, SDKError, string, unknown>;
+    useCustomerRefreshToken(options?: MutationCallbacks<CustomerRefreshResponse>): _tanstack_react_query.UseMutationResult<CustomerRefreshResponse, SDKError, unknown, unknown>;
+    useCustomerUpdateProfile(options?: MutationCallbacks<CustomerProfile>): _tanstack_react_query.UseMutationResult<CustomerProfile, SDKError, UpdateProfileData, unknown>;
+    useCustomerChangePassword(options?: MutationCallbacks<void>): _tanstack_react_query.UseMutationResult<void, SDKError, {
         currentPassword: string;
         newPassword: string;
     }, unknown>;
@@ -745,6 +873,43 @@ declare class QueryHooks {
     setCustomerData(data: CustomerProfile | null): void;
 }
 
+declare function collectionKeys<T extends PublicCollection>(collection: T): {
+    all: readonly [T];
+    lists: () => readonly [T, "list"];
+    list: (options?: ApiQueryOptions) => readonly [T, "list", ApiQueryOptions | undefined];
+    details: () => readonly [T, "detail"];
+    detail: (id: string, options?: ApiQueryOptions) => readonly [T, "detail", string, ApiQueryOptions | undefined];
+    infinites: () => readonly [T, "infinite"];
+    infinite: (options?: Omit<ApiQueryOptions, "page">) => readonly [T, "infinite", Omit<ApiQueryOptions, "page"> | undefined];
+};
+declare const customerKeys: {
+    all: readonly ["customer"];
+    me: () => readonly ["customer", "me"];
+};
+
+type ReadOnlyQueryHooks = Omit<QueryHooks, 'useCreate' | 'useUpdate' | 'useRemove'>;
+/**
+ * Composes CollectionHooks + CustomerHooks into a single API surface.
+ * All methods are delegated; no logic lives here.
+ */
+declare class QueryHooks extends CollectionHooks {
+    private _customer;
+    constructor(queryClient: QueryClient, collectionClient: CollectionClient, customerAuth?: CustomerAuth);
+    useCustomerMe: CustomerHooks['useCustomerMe'];
+    useCustomerLogin: CustomerHooks['useCustomerLogin'];
+    useCustomerRegister: CustomerHooks['useCustomerRegister'];
+    useCustomerLogout: CustomerHooks['useCustomerLogout'];
+    useCustomerForgotPassword: CustomerHooks['useCustomerForgotPassword'];
+    useCustomerResetPassword: CustomerHooks['useCustomerResetPassword'];
+    useCustomerVerifyEmail: CustomerHooks['useCustomerVerifyEmail'];
+    useCustomerRefreshToken: CustomerHooks['useCustomerRefreshToken'];
+    useCustomerUpdateProfile: CustomerHooks['useCustomerUpdateProfile'];
+    useCustomerChangePassword: CustomerHooks['useCustomerChangePassword'];
+    invalidateCustomerQueries: CustomerHooks['invalidateCustomerQueries'];
+    getCustomerData: CustomerHooks['getCustomerData'];
+    setCustomerData: CustomerHooks['setCustomerData'];
+}
+
 declare class BrowserClient {
     cart: CartApi;
     query: ReadOnlyQueryHooks;
@@ -796,9 +961,7 @@ declare const formatOrderName: (items: OrderItem[]) => string;
  * @param ref - The relation field value (T, string, number, null, or undefined)
  * @returns The resolved document object, or null if not populated
  */
-declare const resolveRelation: <T>(ref: T | string | null | undefined) => T | null;
-/** @deprecated Use `resolveRelation` instead */
-declare const objectFor: <T>(ref: T | string | null | undefined) => T | null;
+declare const resolveRelation: <T>(ref: T | string | number | null | undefined) => T | null;
 
 interface VideoThumbnailOptions {
     /** Width in pixels (default: 640) */
@@ -884,4 +1047,4 @@ declare function getVideoStreamUrl(playbackId: string): string;
  */
 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 };
+export { API_URLS, type AddItemParams, ApiError, type ApiQueryOptions, type ApiQueryReactOptions, type ApplyDiscountParams, BaseApi, BrowserClient, BrowserClient as BrowserClientType, type CalculateShippingParams, type CalculateShippingResult, Cart, CartApi, type CartApiOptions, CartItem, type CheckoutParams, type ClearCartParams, type ClientBrowserConfig, type ClientMetadata, type ClientServerConfig, type ClientState, CollectionClient, type CollectionDetailQueryParams, CollectionHooks, type CollectionInfiniteQueryParams, CollectionQueryBuilder, type CollectionQueryParams, CollectionType, ConfigError, type CreateExchangeParams, type CreateFulfillmentParams, type CreateOrderParams, type CreateReturnParams, CustomerAuth, type CustomerAuthOptions, type CustomerAuthResponse, CustomerHooks, type CustomerLoginData, type CustomerProfile, type CustomerRefreshResponse, type CustomerRegisterData, type DebugConfig, type DeepPartial, type Environment, type ErrorLogger, Exchange, type ExtractArrayType, Fulfillment, type GenerateMetadataOptions, type GetOrderParams, GoneError, NetworkError, Order, OrderApi, type OrderApiOptions, OrderProduct, type PaginationMeta, type PayloadFindResponse, type PayloadMutationResponse, Product, ProductApi, type ProductApiOptions, PublicCollection, QueryHooks, type ReadOnlyQueryBuilder, type ReadOnlyQueryHooks, type RemoveDiscountParams, type RemoveItemParams, type RetryConfig, Return, type ReturnWithRefundParams, SDKError, type ServerApiOptions, ServerClient, ServerClient as ServerClientType, ServiceUnavailableError, type StockCheckParams, type StockCheckResponse, type StockCheckResult, TimeoutError, Transaction, type UpdateExchangeParams, type UpdateFulfillmentParams, type UpdateItemParams, type UpdateOrderParams, type UpdateProfileData, type UpdateReturnParams, type UpdateTransactionParams, UsageLimitError, type ValidateDiscountParams, type ValidateDiscountResult, ValidationError, type VideoGifOptions, type VideoThumbnailOptions, collectionKeys, createBrowserClient, createServerClient, customerKeys, formatOrderName, generateOrderNumber, getQueryClient, getVideoGif, getVideoMp4Url, getVideoStoryboard, getVideoStreamUrl, getVideoThumbnail, isApiError, isConfigError, isGoneError, isNetworkError, isSDKError, isServiceUnavailableError, isTimeoutError, isUsageLimitError, isValidationError, resolveApiUrl, resolveRelation };