@01.software/sdk 0.2.7 → 0.2.9-dev.260305.4f1735b

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-CRSz8jfP.cjs';
-export { k as ApiUsage, ae as ApiUsageSelect, A as Audience, aa as AudiencesSelect, b0 as Auth, m as BillingHistory, ag as BillingHistorySelect, u as Brand, B as BrandLogo, aq as BrandLogosSelect, ap as BrandsSelect, K as Cart, aG as CartItemsSelect, aF as CartsSelect, f as CodeBlock, a$ as CollectionsWidget, c as Config, w as Customer, z as CustomerAddress, aC as CustomerAddressesSelect, d as CustomerAuthOperations, x as CustomerGroup, y as CustomerGroupImage, aE as CustomerGroupImagesSelect, aD as CustomerGroupsSelect, aB as CustomersSelect, L as Discount, aH as DiscountsSelect, Y as Document, aP as DocumentCategoriesSelect, $ as DocumentCategory, _ as DocumentImage, aR as DocumentImagesSelect, Z as DocumentType, aQ as DocumentTypesSelect, aO as DocumentsSelect, E as EmailLog, ab as EmailLogsSelect, G as Exchange, H as ExchangeProduct, ax as ExchangeProductsSelect, aw as ExchangesSelect, F as Form, a3 as FormSubmission, aW as FormSubmissionsSelect, aV as FormsSelect, J as FulfillmentItem, az as FulfillmentItemsSelect, ay as FulfillmentsSelect, I as IframeBlock, M as Media, a9 as MediaSelect, a1 as Music, aT as MusicsSelect, at as OrderProductsSelect, as as OrdersSelect, a4 as PayloadKv, aX as PayloadKvSelect, a5 as PayloadLockedDocument, aY as PayloadLockedDocumentsSelect, a7 as PayloadMigration, a_ as PayloadMigrationsSelect, a6 as PayloadPreference, aZ as PayloadPreferencesSelect, e as PlayerBlock, a0 as Playlist, a2 as PlaylistImage, aU as PlaylistImagesSelect, aS as PlaylistsSelect, N as Post, V as PostAuthor, aK as PostAuthorsSelect, aL as PostCategoriesSelect, W as PostCategory, Q as PostImage, aN as PostImagesSelect, X as PostTag, aM as PostTagsSelect, aJ as PostsSelect, o as Product, am as ProductCategoriesSelect, r as ProductCategory, t as ProductCollection, ao as ProductCollectionsSelect, p as ProductImage, ar as ProductImagesSelect, al as ProductOptionsSelect, s as ProductTag, an as ProductTagsSelect, q as ProductVariant, ak as ProductVariantsSelect, aj as ProductsSelect, D as ReturnProduct, av as ReturnProductsSelect, au as ReturnsSelect, aI as ShippingPoliciesSelect, v as ShippingPolicy, l as Subscription, af as SubscriptionsSelect, S as SupportedTimezones, h as Tenant, n as TenantLogo, ah as TenantLogosSelect, ad as TenantMetadataSelect, i as TenantMetadatum, j as TenantOgImage, ai as TenantOgImagesSelect, ac as TenantsSelect, aA as TransactionsSelect, g as User, U as UserAuthOperations, a8 as UsersSelect } from './payload-types-CRSz8jfP.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-ZBsN9vPn.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-ZBsN9vPn.cjs';
+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-Bpi16SHO.cjs';
+export { k as ApiUsage, ae as ApiUsageSelect, A as Audience, aa as AudiencesSelect, b0 as Auth, m as BillingHistory, ag as BillingHistorySelect, u as Brand, B as BrandLogo, aq as BrandLogosSelect, ap as BrandsSelect, K as Cart, aG as CartItemsSelect, aF as CartsSelect, f as CodeBlock, a$ as CollectionsWidget, c as Config, w as Customer, z as CustomerAddress, aC as CustomerAddressesSelect, d as CustomerAuthOperations, x as CustomerGroup, y as CustomerGroupImage, aE as CustomerGroupImagesSelect, aD as CustomerGroupsSelect, aB as CustomersSelect, L as Discount, aH as DiscountsSelect, Y as Document, aP as DocumentCategoriesSelect, $ as DocumentCategory, _ as DocumentImage, aR as DocumentImagesSelect, Z as DocumentType, aQ as DocumentTypesSelect, aO as DocumentsSelect, E as EmailLog, ab as EmailLogsSelect, G as Exchange, H as ExchangeProduct, aA as ExchangeProductsSelect, az as ExchangesSelect, F as Form, a3 as FormSubmission, aW as FormSubmissionsSelect, aV as FormsSelect, J as FulfillmentItem, aw as FulfillmentItemsSelect, av as FulfillmentsSelect, I as IframeBlock, M as Media, a9 as MediaSelect, a1 as Music, aT as MusicsSelect, at as OrderProductsSelect, as as OrdersSelect, a4 as PayloadKv, aX as PayloadKvSelect, a5 as PayloadLockedDocument, aY as PayloadLockedDocumentsSelect, a7 as PayloadMigration, a_ as PayloadMigrationsSelect, a6 as PayloadPreference, aZ as PayloadPreferencesSelect, e as PlayerBlock, a0 as Playlist, a2 as PlaylistImage, aU as PlaylistImagesSelect, aS as PlaylistsSelect, N as Post, V as PostAuthor, aK as PostAuthorsSelect, aL as PostCategoriesSelect, W as PostCategory, Q as PostImage, aN as PostImagesSelect, X as PostTag, aM as PostTagsSelect, aJ as PostsSelect, o as Product, am as ProductCategoriesSelect, r as ProductCategory, t as ProductCollection, ao as ProductCollectionsSelect, p as ProductImage, ar as ProductImagesSelect, al as ProductOptionsSelect, s as ProductTag, an as ProductTagsSelect, q as ProductVariant, ak as ProductVariantsSelect, aj as ProductsSelect, D as ReturnProduct, ay as ReturnProductsSelect, ax as ReturnsSelect, aI as ShippingPoliciesSelect, v as ShippingPolicy, l as Subscription, af as SubscriptionsSelect, S as SupportedTimezones, h as Tenant, n as TenantLogo, ah as TenantLogosSelect, ad as TenantMetadataSelect, i as TenantMetadatum, j as TenantOgImage, ai as TenantOgImagesSelect, ac as TenantsSelect, au as TransactionsSelect, g as User, U as UserAuthOperations, a8 as UsersSelect } from './payload-types-Bpi16SHO.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-3qWmYUln.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-3qWmYUln.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-Dn5o0LXq.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-Dn5o0LXq.cjs';
+import { P as PublicCollection, C as CollectionType } from './webhook-DMN-IPra.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-DMN-IPra.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';
@@ -248,6 +248,16 @@ declare class CollectionClient extends HttpClient {
     requestDeleteMany<T = unknown>(endpoint: string, data: {
         where?: unknown;
     }): Promise<PayloadFindResponse<T>>;
+    /**
+     * Create document with file upload
+     * POST /api/{collection} (multipart/form-data)
+     */
+    requestCreateWithFile<T = unknown>(endpoint: string, data: unknown, file: File | Blob, filename?: string): Promise<PayloadMutationResponse<T>>;
+    /**
+     * Update document with file upload
+     * PATCH /api/{collection}/{id} (multipart/form-data)
+     */
+    requestUpdateWithFile<T = unknown>(endpoint: string, data: unknown, file: File | Blob, filename?: string): Promise<PayloadMutationResponse<T>>;
 }
 
 /**
@@ -270,19 +280,25 @@ declare class CollectionQueryBuilder<T extends PublicCollection> {
      * GET /api/{collection}/{id}
      * @returns Document object directly (no wrapper)
      */
-    findById(id: number | string, options?: ApiQueryOptions): Promise<CollectionType<T>>;
+    findById(id: string, options?: ApiQueryOptions): Promise<CollectionType<T>>;
     /**
      * Create a new document
      * POST /api/{collection}
      * @returns Payload CMS mutation response with doc and message
      */
-    create(data: Partial<CollectionType<T>>): Promise<PayloadMutationResponse<CollectionType<T>>>;
+    create(data: Partial<CollectionType<T>>, options?: {
+        file?: File | Blob;
+        filename?: string;
+    }): Promise<PayloadMutationResponse<CollectionType<T>>>;
     /**
      * Update a document by ID
      * PATCH /api/{collection}/{id}
      * @returns Payload CMS mutation response with doc and message
      */
-    update(id: number | string, data: Partial<CollectionType<T>>): Promise<PayloadMutationResponse<CollectionType<T>>>;
+    update(id: string, data: Partial<CollectionType<T>>, options?: {
+        file?: File | Blob;
+        filename?: string;
+    }): Promise<PayloadMutationResponse<CollectionType<T>>>;
     /**
      * Count documents
      * GET /api/{collection}/count
@@ -302,7 +318,7 @@ declare class CollectionQueryBuilder<T extends PublicCollection> {
      * Applies depth: 1 (image populate) automatically.
      * @returns Metadata (throws on 404)
      */
-    findMetadataById(id: number | string, metadataOptions?: GenerateMetadataOptions): Promise<Metadata>;
+    findMetadataById(id: string, metadataOptions?: GenerateMetadataOptions): Promise<Metadata>;
     /**
      * Update multiple documents (bulk update)
      * PATCH /api/{collection}
@@ -314,7 +330,7 @@ declare class CollectionQueryBuilder<T extends PublicCollection> {
      * DELETE /api/{collection}/{id}
      * @returns Deleted document object directly (no wrapper)
      */
-    remove(id: number | string): Promise<CollectionType<T>>;
+    remove(id: string): Promise<CollectionType<T>>;
     /**
      * Delete multiple documents (bulk delete)
      * DELETE /api/{collection}
@@ -328,11 +344,16 @@ interface CustomerAuthResponse {
     customer: CustomerProfile;
 }
 interface CustomerProfile {
-    id: number | string;
+    id: string;
     name: string;
     email?: string | null;
     phone?: string | null;
+    authProvider?: 'local' | 'google' | 'apple' | 'kakao' | 'naver' | null;
+    isGuest?: boolean | null;
     isVerified?: boolean | null;
+    marketingConsent?: boolean | null;
+    metadata?: Record<string, unknown> | null;
+    groups?: string[];
 }
 interface CustomerRegisterData {
     name: string;
@@ -437,7 +458,7 @@ declare function collectionKeys<T extends PublicCollection>(collection: T): {
     lists: () => readonly [T, "list"];
     list: (options?: ApiQueryOptions) => readonly [T, "list", ApiQueryOptions | undefined];
     details: () => readonly [T, "detail"];
-    detail: (id: string | number, options?: ApiQueryOptions) => readonly [T, "detail", string | number, ApiQueryOptions | undefined];
+    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];
 };
@@ -451,7 +472,7 @@ interface CollectionQueryParams<T extends PublicCollection> {
 }
 interface CollectionDetailQueryParams<T extends PublicCollection> {
     collection: T;
-    id: string | number;
+    id: string;
     options?: ApiQueryOptions;
 }
 interface CollectionInfiniteQueryParams<T extends PublicCollection> {
@@ -531,7 +552,11 @@ declare class QueryHooks {
         onSuccess?: (data: PayloadMutationResponse<CollectionType<T>>) => void;
         onError?: (error: Error) => void;
         onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<PayloadMutationResponse<CollectionType<T>>, Error, Partial<CollectionType<T>>, unknown>;
+    }): _tanstack_react_query.UseMutationResult<PayloadMutationResponse<CollectionType<T>>, Error, {
+        data: Partial<CollectionType<T>>;
+        file?: File | Blob;
+        filename?: string;
+    }, unknown>;
     useUpdate<T extends PublicCollection>(params: {
         collection: T;
     }, options?: {
@@ -539,8 +564,10 @@ declare class QueryHooks {
         onError?: (error: Error) => void;
         onSettled?: () => void;
     }): _tanstack_react_query.UseMutationResult<PayloadMutationResponse<CollectionType<T>>, Error, {
-        id: string | number;
+        id: string;
         data: Partial<CollectionType<T>>;
+        file?: File | Blob;
+        filename?: string;
     }, unknown>;
     useRemove<T extends PublicCollection>(params: {
         collection: T;
@@ -548,12 +575,12 @@ declare class QueryHooks {
         onSuccess?: (data: CollectionType<T>) => void;
         onError?: (error: Error) => void;
         onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<CollectionType<T>, Error, string | number, unknown>;
+    }): _tanstack_react_query.UseMutationResult<CollectionType<T>, Error, 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 | number, options?: ApiQueryOptions): CollectionType<T> | null | 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 | number, data: CollectionType<T> | null, options?: ApiQueryOptions): void;
+    setQueryData<T extends PublicCollection>(collection: T, type: 'detail', id: string, data: CollectionType<T> | null, options?: ApiQueryOptions): void;
     useCustomerMe(options?: {
         enabled?: boolean;
         staleTime?: number;
@@ -665,8 +692,8 @@ declare const formatOrderName: (options: ProductOption[]) => 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 | number | null | undefined) => T | null;
+declare const resolveRelation: <T>(ref: T | string | null | undefined) => T | null;
 /** @deprecated Use `resolveRelation` instead */
-declare const objectFor: <T>(ref: T | string | number | null | undefined) => T | null;
+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 };

package/dist/index.d.ts

@@ -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-CRSz8jfP.js';
-export { k as ApiUsage, ae as ApiUsageSelect, A as Audience, aa as AudiencesSelect, b0 as Auth, m as BillingHistory, ag as BillingHistorySelect, u as Brand, B as BrandLogo, aq as BrandLogosSelect, ap as BrandsSelect, K as Cart, aG as CartItemsSelect, aF as CartsSelect, f as CodeBlock, a$ as CollectionsWidget, c as Config, w as Customer, z as CustomerAddress, aC as CustomerAddressesSelect, d as CustomerAuthOperations, x as CustomerGroup, y as CustomerGroupImage, aE as CustomerGroupImagesSelect, aD as CustomerGroupsSelect, aB as CustomersSelect, L as Discount, aH as DiscountsSelect, Y as Document, aP as DocumentCategoriesSelect, $ as DocumentCategory, _ as DocumentImage, aR as DocumentImagesSelect, Z as DocumentType, aQ as DocumentTypesSelect, aO as DocumentsSelect, E as EmailLog, ab as EmailLogsSelect, G as Exchange, H as ExchangeProduct, ax as ExchangeProductsSelect, aw as ExchangesSelect, F as Form, a3 as FormSubmission, aW as FormSubmissionsSelect, aV as FormsSelect, J as FulfillmentItem, az as FulfillmentItemsSelect, ay as FulfillmentsSelect, I as IframeBlock, M as Media, a9 as MediaSelect, a1 as Music, aT as MusicsSelect, at as OrderProductsSelect, as as OrdersSelect, a4 as PayloadKv, aX as PayloadKvSelect, a5 as PayloadLockedDocument, aY as PayloadLockedDocumentsSelect, a7 as PayloadMigration, a_ as PayloadMigrationsSelect, a6 as PayloadPreference, aZ as PayloadPreferencesSelect, e as PlayerBlock, a0 as Playlist, a2 as PlaylistImage, aU as PlaylistImagesSelect, aS as PlaylistsSelect, N as Post, V as PostAuthor, aK as PostAuthorsSelect, aL as PostCategoriesSelect, W as PostCategory, Q as PostImage, aN as PostImagesSelect, X as PostTag, aM as PostTagsSelect, aJ as PostsSelect, o as Product, am as ProductCategoriesSelect, r as ProductCategory, t as ProductCollection, ao as ProductCollectionsSelect, p as ProductImage, ar as ProductImagesSelect, al as ProductOptionsSelect, s as ProductTag, an as ProductTagsSelect, q as ProductVariant, ak as ProductVariantsSelect, aj as ProductsSelect, D as ReturnProduct, av as ReturnProductsSelect, au as ReturnsSelect, aI as ShippingPoliciesSelect, v as ShippingPolicy, l as Subscription, af as SubscriptionsSelect, S as SupportedTimezones, h as Tenant, n as TenantLogo, ah as TenantLogosSelect, ad as TenantMetadataSelect, i as TenantMetadatum, j as TenantOgImage, ai as TenantOgImagesSelect, ac as TenantsSelect, aA as TransactionsSelect, g as User, U as UserAuthOperations, a8 as UsersSelect } from './payload-types-CRSz8jfP.js';
-import { F as FetchOptions, A as ApiQueryOptions, P as PayloadFindResponse, a as PayloadMutationResponse, C as ClientBrowserConfig, b as ClientState, c as ClientServerConfig } from './auth-D-_Ju7m5.js';
-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-D-_Ju7m5.js';
+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-Bpi16SHO.js';
+export { k as ApiUsage, ae as ApiUsageSelect, A as Audience, aa as AudiencesSelect, b0 as Auth, m as BillingHistory, ag as BillingHistorySelect, u as Brand, B as BrandLogo, aq as BrandLogosSelect, ap as BrandsSelect, K as Cart, aG as CartItemsSelect, aF as CartsSelect, f as CodeBlock, a$ as CollectionsWidget, c as Config, w as Customer, z as CustomerAddress, aC as CustomerAddressesSelect, d as CustomerAuthOperations, x as CustomerGroup, y as CustomerGroupImage, aE as CustomerGroupImagesSelect, aD as CustomerGroupsSelect, aB as CustomersSelect, L as Discount, aH as DiscountsSelect, Y as Document, aP as DocumentCategoriesSelect, $ as DocumentCategory, _ as DocumentImage, aR as DocumentImagesSelect, Z as DocumentType, aQ as DocumentTypesSelect, aO as DocumentsSelect, E as EmailLog, ab as EmailLogsSelect, G as Exchange, H as ExchangeProduct, aA as ExchangeProductsSelect, az as ExchangesSelect, F as Form, a3 as FormSubmission, aW as FormSubmissionsSelect, aV as FormsSelect, J as FulfillmentItem, aw as FulfillmentItemsSelect, av as FulfillmentsSelect, I as IframeBlock, M as Media, a9 as MediaSelect, a1 as Music, aT as MusicsSelect, at as OrderProductsSelect, as as OrdersSelect, a4 as PayloadKv, aX as PayloadKvSelect, a5 as PayloadLockedDocument, aY as PayloadLockedDocumentsSelect, a7 as PayloadMigration, a_ as PayloadMigrationsSelect, a6 as PayloadPreference, aZ as PayloadPreferencesSelect, e as PlayerBlock, a0 as Playlist, a2 as PlaylistImage, aU as PlaylistImagesSelect, aS as PlaylistsSelect, N as Post, V as PostAuthor, aK as PostAuthorsSelect, aL as PostCategoriesSelect, W as PostCategory, Q as PostImage, aN as PostImagesSelect, X as PostTag, aM as PostTagsSelect, aJ as PostsSelect, o as Product, am as ProductCategoriesSelect, r as ProductCategory, t as ProductCollection, ao as ProductCollectionsSelect, p as ProductImage, ar as ProductImagesSelect, al as ProductOptionsSelect, s as ProductTag, an as ProductTagsSelect, q as ProductVariant, ak as ProductVariantsSelect, aj as ProductsSelect, D as ReturnProduct, ay as ReturnProductsSelect, ax as ReturnsSelect, aI as ShippingPoliciesSelect, v as ShippingPolicy, l as Subscription, af as SubscriptionsSelect, S as SupportedTimezones, h as Tenant, n as TenantLogo, ah as TenantLogosSelect, ad as TenantMetadataSelect, i as TenantMetadatum, j as TenantOgImage, ai as TenantOgImagesSelect, ac as TenantsSelect, au as TransactionsSelect, g as User, U as UserAuthOperations, a8 as UsersSelect } from './payload-types-Bpi16SHO.js';
+import { F as FetchOptions, A as ApiQueryOptions, P as PayloadFindResponse, a as PayloadMutationResponse, C as ClientBrowserConfig, b as ClientState, c as ClientServerConfig } from './auth-BfGmV75P.js';
+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-BfGmV75P.js';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
-import { P as PublicCollection, C as CollectionType } from './webhook-C_DHB0Sw.js';
-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-C_DHB0Sw.js';
+import { P as PublicCollection, C as CollectionType } from './webhook-Bk-i0A59.js';
+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-Bk-i0A59.js';
 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.js';
 import 'payload';
@@ -248,6 +248,16 @@ declare class CollectionClient extends HttpClient {
     requestDeleteMany<T = unknown>(endpoint: string, data: {
         where?: unknown;
     }): Promise<PayloadFindResponse<T>>;
+    /**
+     * Create document with file upload
+     * POST /api/{collection} (multipart/form-data)
+     */
+    requestCreateWithFile<T = unknown>(endpoint: string, data: unknown, file: File | Blob, filename?: string): Promise<PayloadMutationResponse<T>>;
+    /**
+     * Update document with file upload
+     * PATCH /api/{collection}/{id} (multipart/form-data)
+     */
+    requestUpdateWithFile<T = unknown>(endpoint: string, data: unknown, file: File | Blob, filename?: string): Promise<PayloadMutationResponse<T>>;
 }
 
 /**
@@ -270,19 +280,25 @@ declare class CollectionQueryBuilder<T extends PublicCollection> {
      * GET /api/{collection}/{id}
      * @returns Document object directly (no wrapper)
      */
-    findById(id: number | string, options?: ApiQueryOptions): Promise<CollectionType<T>>;
+    findById(id: string, options?: ApiQueryOptions): Promise<CollectionType<T>>;
     /**
      * Create a new document
      * POST /api/{collection}
      * @returns Payload CMS mutation response with doc and message
      */
-    create(data: Partial<CollectionType<T>>): Promise<PayloadMutationResponse<CollectionType<T>>>;
+    create(data: Partial<CollectionType<T>>, options?: {
+        file?: File | Blob;
+        filename?: string;
+    }): Promise<PayloadMutationResponse<CollectionType<T>>>;
     /**
      * Update a document by ID
      * PATCH /api/{collection}/{id}
      * @returns Payload CMS mutation response with doc and message
      */
-    update(id: number | string, data: Partial<CollectionType<T>>): Promise<PayloadMutationResponse<CollectionType<T>>>;
+    update(id: string, data: Partial<CollectionType<T>>, options?: {
+        file?: File | Blob;
+        filename?: string;
+    }): Promise<PayloadMutationResponse<CollectionType<T>>>;
     /**
      * Count documents
      * GET /api/{collection}/count
@@ -302,7 +318,7 @@ declare class CollectionQueryBuilder<T extends PublicCollection> {
      * Applies depth: 1 (image populate) automatically.
      * @returns Metadata (throws on 404)
      */
-    findMetadataById(id: number | string, metadataOptions?: GenerateMetadataOptions): Promise<Metadata>;
+    findMetadataById(id: string, metadataOptions?: GenerateMetadataOptions): Promise<Metadata>;
     /**
      * Update multiple documents (bulk update)
      * PATCH /api/{collection}
@@ -314,7 +330,7 @@ declare class CollectionQueryBuilder<T extends PublicCollection> {
      * DELETE /api/{collection}/{id}
      * @returns Deleted document object directly (no wrapper)
      */
-    remove(id: number | string): Promise<CollectionType<T>>;
+    remove(id: string): Promise<CollectionType<T>>;
     /**
      * Delete multiple documents (bulk delete)
      * DELETE /api/{collection}
@@ -328,11 +344,16 @@ interface CustomerAuthResponse {
     customer: CustomerProfile;
 }
 interface CustomerProfile {
-    id: number | string;
+    id: string;
     name: string;
     email?: string | null;
     phone?: string | null;
+    authProvider?: 'local' | 'google' | 'apple' | 'kakao' | 'naver' | null;
+    isGuest?: boolean | null;
     isVerified?: boolean | null;
+    marketingConsent?: boolean | null;
+    metadata?: Record<string, unknown> | null;
+    groups?: string[];
 }
 interface CustomerRegisterData {
     name: string;
@@ -437,7 +458,7 @@ declare function collectionKeys<T extends PublicCollection>(collection: T): {
     lists: () => readonly [T, "list"];
     list: (options?: ApiQueryOptions) => readonly [T, "list", ApiQueryOptions | undefined];
     details: () => readonly [T, "detail"];
-    detail: (id: string | number, options?: ApiQueryOptions) => readonly [T, "detail", string | number, ApiQueryOptions | undefined];
+    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];
 };
@@ -451,7 +472,7 @@ interface CollectionQueryParams<T extends PublicCollection> {
 }
 interface CollectionDetailQueryParams<T extends PublicCollection> {
     collection: T;
-    id: string | number;
+    id: string;
     options?: ApiQueryOptions;
 }
 interface CollectionInfiniteQueryParams<T extends PublicCollection> {
@@ -531,7 +552,11 @@ declare class QueryHooks {
         onSuccess?: (data: PayloadMutationResponse<CollectionType<T>>) => void;
         onError?: (error: Error) => void;
         onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<PayloadMutationResponse<CollectionType<T>>, Error, Partial<CollectionType<T>>, unknown>;
+    }): _tanstack_react_query.UseMutationResult<PayloadMutationResponse<CollectionType<T>>, Error, {
+        data: Partial<CollectionType<T>>;
+        file?: File | Blob;
+        filename?: string;
+    }, unknown>;
     useUpdate<T extends PublicCollection>(params: {
         collection: T;
     }, options?: {
@@ -539,8 +564,10 @@ declare class QueryHooks {
         onError?: (error: Error) => void;
         onSettled?: () => void;
     }): _tanstack_react_query.UseMutationResult<PayloadMutationResponse<CollectionType<T>>, Error, {
-        id: string | number;
+        id: string;
         data: Partial<CollectionType<T>>;
+        file?: File | Blob;
+        filename?: string;
     }, unknown>;
     useRemove<T extends PublicCollection>(params: {
         collection: T;
@@ -548,12 +575,12 @@ declare class QueryHooks {
         onSuccess?: (data: CollectionType<T>) => void;
         onError?: (error: Error) => void;
         onSettled?: () => void;
-    }): _tanstack_react_query.UseMutationResult<CollectionType<T>, Error, string | number, unknown>;
+    }): _tanstack_react_query.UseMutationResult<CollectionType<T>, Error, 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 | number, options?: ApiQueryOptions): CollectionType<T> | null | 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 | number, data: CollectionType<T> | null, options?: ApiQueryOptions): void;
+    setQueryData<T extends PublicCollection>(collection: T, type: 'detail', id: string, data: CollectionType<T> | null, options?: ApiQueryOptions): void;
     useCustomerMe(options?: {
         enabled?: boolean;
         staleTime?: number;
@@ -665,8 +692,8 @@ declare const formatOrderName: (options: ProductOption[]) => 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 | number | null | undefined) => T | null;
+declare const resolveRelation: <T>(ref: T | string | null | undefined) => T | null;
 /** @deprecated Use `resolveRelation` instead */
-declare const objectFor: <T>(ref: T | string | number | null | undefined) => T | null;
+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 };

package/dist/index.js

@@ -317,7 +317,7 @@ function _fetch(url, options) {
         if (authToken) {
           headers.set("Authorization", `Bearer ${authToken}`);
         }
-        if (!headers.has("Content-Type") && requestInit.body) {
+        if (!headers.has("Content-Type") && requestInit.body && !(requestInit.body instanceof FormData)) {
           headers.set("Content-Type", "application/json");
         }
         const redactedHeaders = Object.fromEntries(headers.entries());
@@ -633,7 +633,7 @@ var ProductApi = class {
 
 // src/utils/types.ts
 var resolveRelation = (ref) => {
-  if (typeof ref === "string" || typeof ref === "number" || ref === null || ref === void 0)
+  if (typeof ref === "string" || ref === null || ref === void 0)
     return null;
   return ref;
 };
@@ -721,12 +721,18 @@ var CollectionQueryBuilder = class {
    * POST /api/{collection}
    * @returns Payload CMS mutation response with doc and message
    */
-  create(data) {
+  create(data, options) {
     return __async(this, null, function* () {
-      return this.api.requestCreate(
-        `/api/${String(this.collection)}`,
-        data
-      );
+      const endpoint = `/api/${String(this.collection)}`;
+      if (options == null ? void 0 : options.file) {
+        return this.api.requestCreateWithFile(
+          endpoint,
+          data,
+          options.file,
+          options.filename
+        );
+      }
+      return this.api.requestCreate(endpoint, data);
     });
   }
   /**
@@ -734,12 +740,18 @@ var CollectionQueryBuilder = class {
    * PATCH /api/{collection}/{id}
    * @returns Payload CMS mutation response with doc and message
    */
-  update(id, data) {
+  update(id, data, options) {
     return __async(this, null, function* () {
-      return this.api.requestUpdate(
-        `/api/${String(this.collection)}/${String(id)}`,
-        data
-      );
+      const endpoint = `/api/${String(this.collection)}/${String(id)}`;
+      if (options == null ? void 0 : options.file) {
+        return this.api.requestUpdateWithFile(
+          endpoint,
+          data,
+          options.file,
+          options.filename
+        );
+      }
+      return this.api.requestUpdate(endpoint, data);
     });
   }
   /**
@@ -939,6 +951,14 @@ var HttpClient = class {
 };
 
 // src/core/collection/collection-client.ts
+function buildPayloadFormData(data, file, filename) {
+  const formData = new FormData();
+  formData.append("file", file, filename);
+  if (data != null) {
+    formData.append("_payload", JSON.stringify(data));
+  }
+  return formData;
+}
 var CollectionClient = class extends HttpClient {
   constructor(clientKey, secretKey, baseUrl, getCustomerToken) {
     super(clientKey, secretKey, baseUrl, getCustomerToken);
@@ -1046,6 +1066,32 @@ var CollectionClient = class extends HttpClient {
       return this.parseFindResponse(response);
     });
   }
+  /**
+   * Create document with file upload
+   * POST /api/{collection} (multipart/form-data)
+   */
+  requestCreateWithFile(endpoint, data, file, filename) {
+    return __async(this, null, function* () {
+      const response = yield _fetch(endpoint, __spreadProps(__spreadValues({}, this.defaultOptions), {
+        method: "POST",
+        body: buildPayloadFormData(data, file, filename)
+      }));
+      return this.parseMutationResponse(response);
+    });
+  }
+  /**
+   * Update document with file upload
+   * PATCH /api/{collection}/{id} (multipart/form-data)
+   */
+  requestUpdateWithFile(endpoint, data, file, filename) {
+    return __async(this, null, function* () {
+      const response = yield _fetch(endpoint, __spreadProps(__spreadValues({}, this.defaultOptions), {
+        method: "PATCH",
+        body: buildPayloadFormData(data, file, filename)
+      }));
+      return this.parseMutationResponse(response);
+    });
+  }
 };
 
 // src/core/collection/const.ts
@@ -1494,8 +1540,11 @@ var QueryHooks = class {
   useCreate(params, options) {
     const { collection } = params;
     return useMutationOriginal({
-      mutationFn: (data) => __async(this, null, function* () {
-        return yield this.collectionClient.from(collection).create(data);
+      mutationFn: (variables) => __async(this, null, function* () {
+        return yield this.collectionClient.from(collection).create(
+          variables.data,
+          variables.file ? { file: variables.file, filename: variables.filename } : void 0
+        );
       }),
       onSuccess: (data) => {
         var _a;
@@ -1510,7 +1559,11 @@ var QueryHooks = class {
     const { collection } = params;
     return useMutationOriginal({
       mutationFn: (variables) => __async(this, null, function* () {
-        return yield this.collectionClient.from(collection).update(variables.id, variables.data);
+        return yield this.collectionClient.from(collection).update(
+          variables.id,
+          variables.data,
+          variables.file ? { file: variables.file, filename: variables.filename } : void 0
+        );
       }),
       onSuccess: (data) => {
         var _a;