@01.software/sdk 0.2.3 → 0.2.5

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-COjt2QTn.cjs';
-export { l as ApiUsage, ag as ApiUsageSelect, A as Audience, aa as AudiencesSelect, a$ as Auth, n as BillingHistory, ai as BillingHistorySelect, u as Brand, B as BrandLogo, ar as BrandLogosSelect, aq as BrandsSelect, K as Cart, aG as CartItemsSelect, aF as CartsSelect, f as CodeBlock, 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, aU 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, aT as PlaylistImagesSelect, aS as PlaylistsSelect, N as Post, V as PostAuthor, aN as PostAuthorsSelect, aK as PostCategoriesSelect, W as PostCategory, Q as PostImage, aM as PostImagesSelect, X as PostTag, aL as PostTagsSelect, aJ as PostsSelect, o as Product, am as ProductCategoriesSelect, r as ProductCategory, t as ProductCollection, ap as ProductCollectionsSelect, p as ProductImage, ao 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, m as Subscription, ah as SubscriptionsSelect, S as SupportedTimezones, h as Tenant, k as TenantLogo, ae as TenantLogosSelect, ad as TenantMetadataSelect, i as TenantMetadatum, j as TenantOgImage, af as TenantOgImagesSelect, ac as TenantsSelect, aA as TransactionsSelect, g as User, U as UserAuthOperations, a8 as UsersSelect } from './payload-types-COjt2QTn.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-C7hwnGOb.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-C7hwnGOb.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-BFIUYPDZ.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-BFIUYPDZ.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-CP8gKMvj.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-CP8gKMvj.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-CxTZjVol.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-CxTZjVol.cjs';
+import { P as PublicCollection, C as CollectionType } from './webhook-BM5spkSP.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-BM5spkSP.cjs';
 import { Metadata } from 'next';
 import { GenerateMetadataOptions } from './metadata.cjs';
 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';
@@ -35,7 +35,7 @@ type UpdateTransactionParams = {
     receiptUrl: Transaction['receiptUrl'];
 };
 type CheckoutParams = {
-    cartId: number;
+    cartId: string;
     paymentId: string;
     orderNumber: string;
     customerSnapshot: {
@@ -49,7 +49,7 @@ type CreateFulfillmentParams = {
     carrier?: string;
     trackingNumber?: string;
     items: Array<{
-        orderProduct: number;
+        orderProduct: string;
         quantity: number;
     }>;
 };
@@ -61,13 +61,13 @@ type CreateReturnParams = {
     reason?: 'change_of_mind' | 'defective' | 'wrong_delivery' | 'damaged' | 'other';
     reasonDetail?: string;
     returnProducts: Array<{
-        orderProduct: number;
+        orderProduct: string;
         quantity: number;
     }>;
     refundAmount: number;
 };
 type UpdateReturnParams = {
-    returnId: number;
+    returnId: string;
     status: 'processing' | 'approved' | 'rejected' | 'completed';
 };
 type ReturnWithRefundParams = {
@@ -75,7 +75,7 @@ type ReturnWithRefundParams = {
     reason?: string;
     reasonDetail?: string;
     returnProducts: Array<{
-        orderProduct: number;
+        orderProduct: string;
         quantity: number;
     }>;
     refundAmount: number;
@@ -109,18 +109,18 @@ interface CartApiOptions {
     baseUrl?: string;
 }
 type AddItemParams = {
-    cartId: number;
-    product: number;
-    variant: number;
-    option: number;
+    cartId: string;
+    product: string;
+    variant: string;
+    option: string;
     quantity: number;
 };
 type UpdateItemParams = {
-    cartItemId: number;
+    cartItemId: string;
     quantity: number;
 };
 type RemoveItemParams = {
-    cartItemId: number;
+    cartItemId: string;
 };
 declare class CartApi {
     private readonly clientKey;
@@ -143,12 +143,12 @@ interface ProductApiOptions {
 }
 type StockCheckParams = {
     items: Array<{
-        optionId: number;
+        optionId: string;
         quantity: number;
     }>;
 };
 type StockCheckResult = {
-    optionId: number;
+    optionId: string;
     available: boolean;
     availableStock: number;
     requestedQuantity: number;
@@ -343,6 +343,15 @@ interface CustomerRefreshResponse {
     token: string;
 }
 interface CustomerAuthOptions {
+    /**
+     * 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 */
@@ -644,15 +653,15 @@ declare const formatOrderName: (options: ProductOption[]) => string;
 
 /**
  * Resolves a Payload CMS relation field value.
- * When depth is 0, relation fields return just the ID (number).
+ * When depth is 0, relation fields return just the ID (string or number).
  * When depth > 0, they return the full document object (T).
  * This utility normalizes both cases to T | null.
  *
- * @param ref - The relation field value (T, number, null, or undefined)
+ * @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 | number | null | undefined) => T | null;
+declare const resolveRelation: <T>(ref: T | string | number | null | undefined) => T | null;
 /** @deprecated Use `resolveRelation` instead */
-declare const objectFor: <T>(ref: T | number | null | undefined) => T | null;
+declare const objectFor: <T>(ref: T | string | number | 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 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-COjt2QTn.js';
-export { l as ApiUsage, ag as ApiUsageSelect, A as Audience, aa as AudiencesSelect, a$ as Auth, n as BillingHistory, ai as BillingHistorySelect, u as Brand, B as BrandLogo, ar as BrandLogosSelect, aq as BrandsSelect, K as Cart, aG as CartItemsSelect, aF as CartsSelect, f as CodeBlock, 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, aU 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, aT as PlaylistImagesSelect, aS as PlaylistsSelect, N as Post, V as PostAuthor, aN as PostAuthorsSelect, aK as PostCategoriesSelect, W as PostCategory, Q as PostImage, aM as PostImagesSelect, X as PostTag, aL as PostTagsSelect, aJ as PostsSelect, o as Product, am as ProductCategoriesSelect, r as ProductCategory, t as ProductCollection, ap as ProductCollectionsSelect, p as ProductImage, ao 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, m as Subscription, ah as SubscriptionsSelect, S as SupportedTimezones, h as Tenant, k as TenantLogo, ae as TenantLogosSelect, ad as TenantMetadataSelect, i as TenantMetadatum, j as TenantOgImage, af as TenantOgImagesSelect, ac as TenantsSelect, aA as TransactionsSelect, g as User, U as UserAuthOperations, a8 as UsersSelect } from './payload-types-COjt2QTn.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-C-9PVtsp.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-C-9PVtsp.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-BFIUYPDZ.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-BFIUYPDZ.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-j2yUrezU.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-j2yUrezU.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-DhK15oyO.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-DhK15oyO.js';
+import { P as PublicCollection, C as CollectionType } from './webhook-BBp77Khg.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-BBp77Khg.js';
 import { Metadata } from 'next';
 import { GenerateMetadataOptions } from './metadata.js';
 export { b as IMAGE_SIZES, I as ImageData, a as ImagePalette, f as ImagePlaceholderOptions, d as getImageLqip, e as getImagePalette, h as getImagePlaceholderStyle, c as getImageSrcSet, g as getImageUrl } from './image-TT8lTsk5.js';
@@ -35,7 +35,7 @@ type UpdateTransactionParams = {
     receiptUrl: Transaction['receiptUrl'];
 };
 type CheckoutParams = {
-    cartId: number;
+    cartId: string;
     paymentId: string;
     orderNumber: string;
     customerSnapshot: {
@@ -49,7 +49,7 @@ type CreateFulfillmentParams = {
     carrier?: string;
     trackingNumber?: string;
     items: Array<{
-        orderProduct: number;
+        orderProduct: string;
         quantity: number;
     }>;
 };
@@ -61,13 +61,13 @@ type CreateReturnParams = {
     reason?: 'change_of_mind' | 'defective' | 'wrong_delivery' | 'damaged' | 'other';
     reasonDetail?: string;
     returnProducts: Array<{
-        orderProduct: number;
+        orderProduct: string;
         quantity: number;
     }>;
     refundAmount: number;
 };
 type UpdateReturnParams = {
-    returnId: number;
+    returnId: string;
     status: 'processing' | 'approved' | 'rejected' | 'completed';
 };
 type ReturnWithRefundParams = {
@@ -75,7 +75,7 @@ type ReturnWithRefundParams = {
     reason?: string;
     reasonDetail?: string;
     returnProducts: Array<{
-        orderProduct: number;
+        orderProduct: string;
         quantity: number;
     }>;
     refundAmount: number;
@@ -109,18 +109,18 @@ interface CartApiOptions {
     baseUrl?: string;
 }
 type AddItemParams = {
-    cartId: number;
-    product: number;
-    variant: number;
-    option: number;
+    cartId: string;
+    product: string;
+    variant: string;
+    option: string;
     quantity: number;
 };
 type UpdateItemParams = {
-    cartItemId: number;
+    cartItemId: string;
     quantity: number;
 };
 type RemoveItemParams = {
-    cartItemId: number;
+    cartItemId: string;
 };
 declare class CartApi {
     private readonly clientKey;
@@ -143,12 +143,12 @@ interface ProductApiOptions {
 }
 type StockCheckParams = {
     items: Array<{
-        optionId: number;
+        optionId: string;
         quantity: number;
     }>;
 };
 type StockCheckResult = {
-    optionId: number;
+    optionId: string;
     available: boolean;
     availableStock: number;
     requestedQuantity: number;
@@ -343,6 +343,15 @@ interface CustomerRefreshResponse {
     token: string;
 }
 interface CustomerAuthOptions {
+    /**
+     * 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 */
@@ -644,15 +653,15 @@ declare const formatOrderName: (options: ProductOption[]) => string;
 
 /**
  * Resolves a Payload CMS relation field value.
- * When depth is 0, relation fields return just the ID (number).
+ * When depth is 0, relation fields return just the ID (string or number).
  * When depth > 0, they return the full document object (T).
  * This utility normalizes both cases to T | null.
  *
- * @param ref - The relation field value (T, number, null, or undefined)
+ * @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 | number | null | undefined) => T | null;
+declare const resolveRelation: <T>(ref: T | string | number | null | undefined) => T | null;
 /** @deprecated Use `resolveRelation` instead */
-declare const objectFor: <T>(ref: T | number | null | undefined) => T | null;
+declare const objectFor: <T>(ref: T | string | number | 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 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

@@ -633,7 +633,8 @@ var ProductApi = class {
 
 // src/utils/types.ts
 var resolveRelation = (ref) => {
-  if (typeof ref === "number" || ref === null || ref === void 0) return null;
+  if (typeof ref === "string" || typeof ref === "number" || ref === null || ref === void 0)
+    return null;
   return ref;
 };
 var objectFor = resolveRelation;
@@ -1078,11 +1079,21 @@ var COLLECTIONS = [
 var DEFAULT_TIMEOUT2 = 15e3;
 var CustomerAuth = class {
   constructor(clientKey, baseUrl, options) {
-    var _a;
+    var _a, _b;
     this.clientKey = clientKey;
     this.baseUrl = baseUrl;
-    this.token = (_a = options == null ? void 0 : options.token) != null ? _a : null;
-    this.onTokenChange = options == null ? void 0 : options.onTokenChange;
+    if (options == null ? void 0 : options.persist) {
+      const key = typeof options.persist === "string" ? options.persist : "customer-token";
+      const isBrowser = typeof window !== "undefined";
+      this.token = isBrowser ? (_a = localStorage.getItem(key)) != null ? _a : null : null;
+      this.onTokenChange = isBrowser ? (token) => {
+        if (token) localStorage.setItem(key, token);
+        else localStorage.removeItem(key);
+      } : void 0;
+    } else {
+      this.token = (_b = options == null ? void 0 : options.token) != null ? _b : null;
+      this.onTokenChange = options == null ? void 0 : options.onTokenChange;
+    }
   }
   /**
    * Register a new customer account
@@ -1261,7 +1272,11 @@ var CustomerAuth = class {
           body.error
         );
       }
-      return res.json();
+      try {
+        return yield res.json();
+      } catch (e) {
+        throw new ApiError("Invalid JSON response from server", res.status, void 0, "INVALID_RESPONSE");
+      }
     });
   }
 };
@@ -1272,7 +1287,9 @@ function makeQueryClient() {
   return new QueryClient({
     defaultOptions: {
       queries: {
-        // SSR/RSC: server-fetched data doesn't auto-refetch; use refetch()/invalidate() to refresh
+        // Infinite staleTime: server-fetched data persists until explicitly invalidated.
+        // For browser clients needing fresher data, override per-query:
+        //   useQuery({ ..., staleTime: 5 * 60 * 1000 })
         staleTime: Number.POSITIVE_INFINITY,
         refetchOnWindowFocus: false
       },