@01.software/sdk 0.2.4 → 0.2.6

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-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-DTkwMgvi.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-DTkwMgvi.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-D0px2DCK.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-D0px2DCK.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-BICuhJxS.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-BICuhJxS.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-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 { P as PublicCollection, C as CollectionType } from './webhook--_n7O-Ed.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--_n7O-Ed.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 */

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-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-CWsLf5vd.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-CWsLf5vd.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-D0px2DCK.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-D0px2DCK.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-Cj3nVn_P.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-Cj3nVn_P.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-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 { P as PublicCollection, C as CollectionType } from './webhook-vrlAV1K7.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-vrlAV1K7.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 */

package/dist/index.js

@@ -1079,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
@@ -1262,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");
+      }
     });
   }
 };
@@ -1273,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
       },