@01.software/sdk 0.33.0 → 0.35.0

package/dist/query.d.cts

@@ -1,16 +1,21 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient, UseQueryResult, UseSuspenseQueryResult, InfiniteData, UseInfiniteQueryResult, UseSuspenseInfiniteQueryResult } from '@tanstack/react-query';
-import { A as ApiQueryOptions, P as PayloadFindResponse, g as PayloadMutationResponse, J as CustomerAuth, N as CustomerProfile, L as CustomerAuthResponse, M as CustomerLoginData, T as CustomerRegisterResponse, Q as CustomerRegisterData, O as CustomerRefreshResponse, b1 as UpdateProfileData, ad as ProductDetailParams, ae as ProductDetailResult, at as ProductListingGroupsItem, h as RootClient } from './types-BZKxss8Y.cjs';
-import './payload-types-dkeQyrDC.cjs';
-import { C as CollectionClient } from './collection-client-De6eKW1J.cjs';
-import { c as ServerCollection, P as PublicCollection } from './const-sPR2IkCe.cjs';
-import { C as CollectionType } from './types-B3YT092I.cjs';
-import { S as SDKError } from './index-BGEhoDUs.cjs';
+import { A as ApiQueryOptions, P as PayloadFindResponse, h as PayloadMutationResponse, a8 as CustomerAuth, a9 as CustomerProfile, aa as CustomerAuthResponse, ab as CustomerLoginData, ac as CustomerRegisterResponse, ad as CustomerRegisterData, ae as CustomerRefreshResponse, af as UpdateProfileData, ag as ProductDetailParams, ah as ProductDetailResult, ai as ProductListingGroupsItem, i as RootClient, Y as RootServerClient } from './types-DDhtZI6E.cjs';
+import './payload-types-C7tb7Xbs.cjs';
+import { C as CollectionClient } from './collection-client-CR2B8c1v.cjs';
+import { S as ServerCollection, P as PublicCollection } from './const-BTvdrXtY.cjs';
+import { C as CollectionType } from './types-Bx558PU6.cjs';
+import { SDKError } from './errors.cjs';
 export { a as RealtimeConnection, R as RealtimeEvent, b as RealtimeListener } from './realtime-D7HtUpqt.cjs';
-import { ServerClient } from './server.cjs';
 import './metadata.cjs';
 
+/** Default React Query client (SSR hydration-friendly: infinite staleTime). */
 declare function getQueryClient(): QueryClient;
+/**
+ * Browser storefront client: refetches catalog data after ~1 minute instead of
+ * keeping SSR data fresh forever. Use with `createQueryHooks(client, queryClient)`.
+ */
+declare function getStorefrontQueryClient(): QueryClient;
 
 interface CollectionQueryParams<T extends ServerCollection> {
     collection: T;
@@ -172,22 +177,41 @@ declare class QueryHooks<TCollection extends ServerCollection = PublicCollection
     useProductListingGroupsQuery<TData = PayloadFindResponse<ProductListingGroupsItem>>(params: {
         options?: ProductListingGroupsQueryOptions;
     }, options?: QueryOptions<PayloadFindResponse<ProductListingGroupsItem>, TData>): UseQueryResult<TData>;
+    useProductListingGroupsCatalogQuery<TData = PayloadFindResponse<ProductListingGroupsItem>>(params: {
+        options?: ProductListingGroupsQueryOptions;
+    }, options?: QueryOptions<PayloadFindResponse<ProductListingGroupsItem>, TData>): UseQueryResult<TData>;
     useSuspenseProductListingGroupsQuery<TData = PayloadFindResponse<ProductListingGroupsItem>>(params: {
         options?: ProductListingGroupsQueryOptions;
     }, options?: SuspenseQueryOptions<PayloadFindResponse<ProductListingGroupsItem>, TData>): UseSuspenseQueryResult<TData>;
+    useSuspenseProductListingGroupsCatalogQuery<TData = PayloadFindResponse<ProductListingGroupsItem>>(params: {
+        options?: ProductListingGroupsQueryOptions;
+    }, options?: SuspenseQueryOptions<PayloadFindResponse<ProductListingGroupsItem>, TData>): UseSuspenseQueryResult<TData>;
     useInfiniteProductListingGroupsQuery<TData = InfiniteData<PayloadFindResponse<ProductListingGroupsItem>>>(params: {
         options?: Omit<ProductListingGroupsQueryOptions, 'page' | 'limit'>;
         pageSize?: number;
     }, options?: InfiniteQueryOptions<PayloadFindResponse<ProductListingGroupsItem>, TData>): UseInfiniteQueryResult<TData>;
+    useInfiniteProductListingGroupsCatalogQuery<TData = InfiniteData<PayloadFindResponse<ProductListingGroupsItem>>>(params: {
+        options?: Omit<ProductListingGroupsQueryOptions, 'page' | 'limit'>;
+        pageSize?: number;
+    }, options?: InfiniteQueryOptions<PayloadFindResponse<ProductListingGroupsItem>, TData>): UseInfiniteQueryResult<TData>;
     useSuspenseInfiniteProductListingGroupsQuery<TData = InfiniteData<PayloadFindResponse<ProductListingGroupsItem>>>(params: {
         options?: Omit<ProductListingGroupsQueryOptions, 'page' | 'limit'>;
         pageSize?: number;
     }, options?: SuspenseInfiniteQueryOptions<PayloadFindResponse<ProductListingGroupsItem>, TData>): UseSuspenseInfiniteQueryResult<TData>;
+    useSuspenseInfiniteProductListingGroupsCatalogQuery<TData = InfiniteData<PayloadFindResponse<ProductListingGroupsItem>>>(params: {
+        options?: Omit<ProductListingGroupsQueryOptions, 'page' | 'limit'>;
+        pageSize?: number;
+    }, options?: SuspenseInfiniteQueryOptions<PayloadFindResponse<ProductListingGroupsItem>, TData>): UseSuspenseInfiniteQueryResult<TData>;
     prefetchProductListingGroupsQuery(params: {
         options?: ProductListingGroupsQueryOptions;
     }, options?: {
         staleTime?: number;
     }): Promise<void>;
+    prefetchProductListingGroupsCatalogQuery(params: {
+        options?: ProductListingGroupsQueryOptions;
+    }, options?: {
+        staleTime?: number;
+    }): Promise<void>;
     prefetchInfiniteProductListingGroupsQuery(params: {
         options?: Omit<ProductListingGroupsQueryOptions, 'page' | 'limit'>;
         pageSize?: number;
@@ -195,19 +219,20 @@ declare class QueryHooks<TCollection extends ServerCollection = PublicCollection
         pages?: number;
         staleTime?: number;
     }): Promise<void>;
+    prefetchInfiniteProductListingGroupsCatalogQuery(params: {
+        options?: Omit<ProductListingGroupsQueryOptions, 'page' | 'limit'>;
+        pageSize?: number;
+    }, options?: {
+        pages?: number;
+        staleTime?: number;
+    }): Promise<void>;
     useProductDetail(params: {
         slug: string;
     } | {
         id: string;
-    }, options?: {
-        enabled?: boolean;
-    }): UseQueryResult<ProductDetailResult>;
-    useProductDetailBySlug(slug: string, options?: {
-        enabled?: boolean;
-    }): UseQueryResult<ProductDetailResult>;
-    useProductDetailById(id: string, options?: {
-        enabled?: boolean;
-    }): UseQueryResult<ProductDetailResult>;
+    }, options?: QueryOptions<ProductDetailResult>): UseQueryResult<ProductDetailResult>;
+    useProductDetailBySlug(slug: string, options?: QueryOptions<ProductDetailResult>): UseQueryResult<ProductDetailResult>;
+    useProductDetailById(id: string, options?: QueryOptions<ProductDetailResult>): UseQueryResult<ProductDetailResult>;
 }
 
 declare function collectionKeys<T extends ServerCollection>(collection: T): {
@@ -225,7 +250,9 @@ declare const customerKeys: {
 };
 declare const productKeys: {
     listingGroups: (options?: ProductListingGroupsQueryOptions) => readonly ["products", "listing-groups", "list", ProductListingGroupsQueryOptions | undefined];
+    listingGroupsCatalog: (options?: ProductListingGroupsQueryOptions) => readonly ["products", "listing-groups", "catalog", ProductListingGroupsQueryOptions | undefined];
     listingGroupsInfinite: (options?: Omit<ProductListingGroupsQueryOptions, "page" | "limit">) => readonly ["products", "listing-groups", "infinite", Omit<ProductListingGroupsQueryOptions, "page" | "limit"> | undefined];
+    listingGroupsCatalogInfinite: (options?: Omit<ProductListingGroupsQueryOptions, "page" | "limit">) => readonly ["products", "listing-groups", "catalog", "infinite", Omit<ProductListingGroupsQueryOptions, "page" | "limit"> | undefined];
     detail: (params: {
         slug: string;
     } | {
@@ -239,6 +266,6 @@ declare const productKeys: {
 };
 
 declare function createQueryHooks(client: RootClient, queryClient?: QueryClient): ReadOnlyQueryHooks;
-declare function createServerQueryHooks(client: ServerClient, queryClient?: QueryClient): QueryHooks<ServerCollection>;
+declare function createServerQueryHooks(client: RootServerClient, queryClient?: QueryClient): QueryHooks<ServerCollection>;
 
-export { type CollectionDetailQueryParams, CollectionHooks, type CollectionInfiniteQueryParams, type CollectionQueryParams, CustomerHooks, type InfiniteQueryOptions, type ProductListingGroupsQueryOptions, QueryHooks, type QueryOptions, type ReadOnlyQueryHooks, type SuspenseInfiniteQueryOptions, type SuspenseQueryOptions, collectionKeys, createQueryHooks, createServerQueryHooks, customerKeys, getQueryClient, productKeys };
+export { type CollectionDetailQueryParams, CollectionHooks, type CollectionInfiniteQueryParams, type CollectionQueryParams, CustomerHooks, type InfiniteQueryOptions, type ProductListingGroupsQueryOptions, QueryHooks, type QueryOptions, type ReadOnlyQueryHooks, type SuspenseInfiniteQueryOptions, type SuspenseQueryOptions, collectionKeys, createQueryHooks, createServerQueryHooks, customerKeys, getQueryClient, getStorefrontQueryClient, productKeys };

package/dist/query.d.ts

@@ -1,16 +1,21 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient, UseQueryResult, UseSuspenseQueryResult, InfiniteData, UseInfiniteQueryResult, UseSuspenseInfiniteQueryResult } from '@tanstack/react-query';
-import { A as ApiQueryOptions, P as PayloadFindResponse, g as PayloadMutationResponse, J as CustomerAuth, N as CustomerProfile, L as CustomerAuthResponse, M as CustomerLoginData, T as CustomerRegisterResponse, Q as CustomerRegisterData, O as CustomerRefreshResponse, b1 as UpdateProfileData, ad as ProductDetailParams, ae as ProductDetailResult, at as ProductListingGroupsItem, h as RootClient } from './types-BHh0YLmq.js';
-import './payload-types-dkeQyrDC.js';
-import { C as CollectionClient } from './collection-client-B6SlhzIP.js';
-import { c as ServerCollection, P as PublicCollection } from './const-DwmSDeWq.js';
-import { C as CollectionType } from './types-Cel_4L9t.js';
-import { S as SDKError } from './index-BGEhoDUs.js';
+import { A as ApiQueryOptions, P as PayloadFindResponse, h as PayloadMutationResponse, a8 as CustomerAuth, a9 as CustomerProfile, aa as CustomerAuthResponse, ab as CustomerLoginData, ac as CustomerRegisterResponse, ad as CustomerRegisterData, ae as CustomerRefreshResponse, af as UpdateProfileData, ag as ProductDetailParams, ah as ProductDetailResult, ai as ProductListingGroupsItem, i as RootClient, Y as RootServerClient } from './types-Byo_Rty4.js';
+import './payload-types-C7tb7Xbs.js';
+import { C as CollectionClient } from './collection-client-DkREjhQ9.js';
+import { S as ServerCollection, P as PublicCollection } from './const-CdqCauHQ.js';
+import { C as CollectionType } from './types-1ylMrCuW.js';
+import { SDKError } from './errors.js';
 export { a as RealtimeConnection, R as RealtimeEvent, b as RealtimeListener } from './realtime-D7HtUpqt.js';
-import { ServerClient } from './server.js';
 import './metadata.js';
 
+/** Default React Query client (SSR hydration-friendly: infinite staleTime). */
 declare function getQueryClient(): QueryClient;
+/**
+ * Browser storefront client: refetches catalog data after ~1 minute instead of
+ * keeping SSR data fresh forever. Use with `createQueryHooks(client, queryClient)`.
+ */
+declare function getStorefrontQueryClient(): QueryClient;
 
 interface CollectionQueryParams<T extends ServerCollection> {
     collection: T;
@@ -172,22 +177,41 @@ declare class QueryHooks<TCollection extends ServerCollection = PublicCollection
     useProductListingGroupsQuery<TData = PayloadFindResponse<ProductListingGroupsItem>>(params: {
         options?: ProductListingGroupsQueryOptions;
     }, options?: QueryOptions<PayloadFindResponse<ProductListingGroupsItem>, TData>): UseQueryResult<TData>;
+    useProductListingGroupsCatalogQuery<TData = PayloadFindResponse<ProductListingGroupsItem>>(params: {
+        options?: ProductListingGroupsQueryOptions;
+    }, options?: QueryOptions<PayloadFindResponse<ProductListingGroupsItem>, TData>): UseQueryResult<TData>;
     useSuspenseProductListingGroupsQuery<TData = PayloadFindResponse<ProductListingGroupsItem>>(params: {
         options?: ProductListingGroupsQueryOptions;
     }, options?: SuspenseQueryOptions<PayloadFindResponse<ProductListingGroupsItem>, TData>): UseSuspenseQueryResult<TData>;
+    useSuspenseProductListingGroupsCatalogQuery<TData = PayloadFindResponse<ProductListingGroupsItem>>(params: {
+        options?: ProductListingGroupsQueryOptions;
+    }, options?: SuspenseQueryOptions<PayloadFindResponse<ProductListingGroupsItem>, TData>): UseSuspenseQueryResult<TData>;
     useInfiniteProductListingGroupsQuery<TData = InfiniteData<PayloadFindResponse<ProductListingGroupsItem>>>(params: {
         options?: Omit<ProductListingGroupsQueryOptions, 'page' | 'limit'>;
         pageSize?: number;
     }, options?: InfiniteQueryOptions<PayloadFindResponse<ProductListingGroupsItem>, TData>): UseInfiniteQueryResult<TData>;
+    useInfiniteProductListingGroupsCatalogQuery<TData = InfiniteData<PayloadFindResponse<ProductListingGroupsItem>>>(params: {
+        options?: Omit<ProductListingGroupsQueryOptions, 'page' | 'limit'>;
+        pageSize?: number;
+    }, options?: InfiniteQueryOptions<PayloadFindResponse<ProductListingGroupsItem>, TData>): UseInfiniteQueryResult<TData>;
     useSuspenseInfiniteProductListingGroupsQuery<TData = InfiniteData<PayloadFindResponse<ProductListingGroupsItem>>>(params: {
         options?: Omit<ProductListingGroupsQueryOptions, 'page' | 'limit'>;
         pageSize?: number;
     }, options?: SuspenseInfiniteQueryOptions<PayloadFindResponse<ProductListingGroupsItem>, TData>): UseSuspenseInfiniteQueryResult<TData>;
+    useSuspenseInfiniteProductListingGroupsCatalogQuery<TData = InfiniteData<PayloadFindResponse<ProductListingGroupsItem>>>(params: {
+        options?: Omit<ProductListingGroupsQueryOptions, 'page' | 'limit'>;
+        pageSize?: number;
+    }, options?: SuspenseInfiniteQueryOptions<PayloadFindResponse<ProductListingGroupsItem>, TData>): UseSuspenseInfiniteQueryResult<TData>;
     prefetchProductListingGroupsQuery(params: {
         options?: ProductListingGroupsQueryOptions;
     }, options?: {
         staleTime?: number;
     }): Promise<void>;
+    prefetchProductListingGroupsCatalogQuery(params: {
+        options?: ProductListingGroupsQueryOptions;
+    }, options?: {
+        staleTime?: number;
+    }): Promise<void>;
     prefetchInfiniteProductListingGroupsQuery(params: {
         options?: Omit<ProductListingGroupsQueryOptions, 'page' | 'limit'>;
         pageSize?: number;
@@ -195,19 +219,20 @@ declare class QueryHooks<TCollection extends ServerCollection = PublicCollection
         pages?: number;
         staleTime?: number;
     }): Promise<void>;
+    prefetchInfiniteProductListingGroupsCatalogQuery(params: {
+        options?: Omit<ProductListingGroupsQueryOptions, 'page' | 'limit'>;
+        pageSize?: number;
+    }, options?: {
+        pages?: number;
+        staleTime?: number;
+    }): Promise<void>;
     useProductDetail(params: {
         slug: string;
     } | {
         id: string;
-    }, options?: {
-        enabled?: boolean;
-    }): UseQueryResult<ProductDetailResult>;
-    useProductDetailBySlug(slug: string, options?: {
-        enabled?: boolean;
-    }): UseQueryResult<ProductDetailResult>;
-    useProductDetailById(id: string, options?: {
-        enabled?: boolean;
-    }): UseQueryResult<ProductDetailResult>;
+    }, options?: QueryOptions<ProductDetailResult>): UseQueryResult<ProductDetailResult>;
+    useProductDetailBySlug(slug: string, options?: QueryOptions<ProductDetailResult>): UseQueryResult<ProductDetailResult>;
+    useProductDetailById(id: string, options?: QueryOptions<ProductDetailResult>): UseQueryResult<ProductDetailResult>;
 }
 
 declare function collectionKeys<T extends ServerCollection>(collection: T): {
@@ -225,7 +250,9 @@ declare const customerKeys: {
 };
 declare const productKeys: {
     listingGroups: (options?: ProductListingGroupsQueryOptions) => readonly ["products", "listing-groups", "list", ProductListingGroupsQueryOptions | undefined];
+    listingGroupsCatalog: (options?: ProductListingGroupsQueryOptions) => readonly ["products", "listing-groups", "catalog", ProductListingGroupsQueryOptions | undefined];
     listingGroupsInfinite: (options?: Omit<ProductListingGroupsQueryOptions, "page" | "limit">) => readonly ["products", "listing-groups", "infinite", Omit<ProductListingGroupsQueryOptions, "page" | "limit"> | undefined];
+    listingGroupsCatalogInfinite: (options?: Omit<ProductListingGroupsQueryOptions, "page" | "limit">) => readonly ["products", "listing-groups", "catalog", "infinite", Omit<ProductListingGroupsQueryOptions, "page" | "limit"> | undefined];
     detail: (params: {
         slug: string;
     } | {
@@ -239,6 +266,6 @@ declare const productKeys: {
 };
 
 declare function createQueryHooks(client: RootClient, queryClient?: QueryClient): ReadOnlyQueryHooks;
-declare function createServerQueryHooks(client: ServerClient, queryClient?: QueryClient): QueryHooks<ServerCollection>;
+declare function createServerQueryHooks(client: RootServerClient, queryClient?: QueryClient): QueryHooks<ServerCollection>;
 
-export { type CollectionDetailQueryParams, CollectionHooks, type CollectionInfiniteQueryParams, type CollectionQueryParams, CustomerHooks, type InfiniteQueryOptions, type ProductListingGroupsQueryOptions, QueryHooks, type QueryOptions, type ReadOnlyQueryHooks, type SuspenseInfiniteQueryOptions, type SuspenseQueryOptions, collectionKeys, createQueryHooks, createServerQueryHooks, customerKeys, getQueryClient, productKeys };
+export { type CollectionDetailQueryParams, CollectionHooks, type CollectionInfiniteQueryParams, type CollectionQueryParams, CustomerHooks, type InfiniteQueryOptions, type ProductListingGroupsQueryOptions, QueryHooks, type QueryOptions, type ReadOnlyQueryHooks, type SuspenseInfiniteQueryOptions, type SuspenseQueryOptions, collectionKeys, createQueryHooks, createServerQueryHooks, customerKeys, getQueryClient, getStorefrontQueryClient, productKeys };

package/dist/query.js

@@ -22,6 +22,7 @@ function makeQueryClient() {
   });
 }
 var browserQueryClient;
+var browserStorefrontQueryClient;
 function getQueryClient() {
   if (isServer) {
     return makeQueryClient();
@@ -31,6 +32,30 @@ function getQueryClient() {
   }
   return browserQueryClient;
 }
+var STOREFRONT_STALE_TIME_MS = 6e4;
+function makeStorefrontQueryClient() {
+  return new QueryClient({
+    defaultOptions: {
+      queries: {
+        staleTime: STOREFRONT_STALE_TIME_MS,
+        refetchOnWindowFocus: false
+      },
+      dehydrate: {
+        shouldDehydrateQuery: (query) => defaultShouldDehydrateQuery(query) || query.state.status === "pending",
+        shouldRedactErrors: () => false
+      }
+    }
+  });
+}
+function getStorefrontQueryClient() {
+  if (isServer) {
+    return makeStorefrontQueryClient();
+  }
+  if (!browserStorefrontQueryClient) {
+    browserStorefrontQueryClient = makeStorefrontQueryClient();
+  }
+  return browserStorefrontQueryClient;
+}
 
 // src/core/query/query-keys.ts
 function collectionKeys(collection) {
@@ -50,7 +75,9 @@ var customerKeys = {
 };
 var productKeys = {
   listingGroups: (options) => ["products", "listing-groups", "list", options],
+  listingGroupsCatalog: (options) => ["products", "listing-groups", "catalog", options],
   listingGroupsInfinite: (options) => ["products", "listing-groups", "infinite", options],
+  listingGroupsCatalogInfinite: (options) => ["products", "listing-groups", "catalog", "infinite", options],
   detail: (params) => ["products", "detail", params],
   detailAll: () => ["products", "detail"]
 };
@@ -319,7 +346,7 @@ import {
   useMutation as useMutationOriginal2
 } from "@tanstack/react-query";
 
-// src/core/internal/errors/index.ts
+// src/core/errors.ts
 var SDKError = class extends Error {
   constructor(code, message, status, details, userMessage, suggestion, requestId) {
     super(message);
@@ -580,6 +607,42 @@ import {
   useSuspenseInfiniteQuery as useSuspenseInfiniteQueryOriginal2,
   useSuspenseQuery as useSuspenseQueryOriginal2
 } from "@tanstack/react-query";
+
+// src/core/internal/utils/query-string.ts
+function appendListingGroupsQuerySearchParams(search, options) {
+  if (options?.page != null) search.set("page", String(options.page));
+  if (options?.limit != null) search.set("limit", String(options.limit));
+  if (options?.sort != null) {
+    const sort = options.sort;
+    search.set(
+      "sort",
+      Array.isArray(sort) ? sort.join(",") : sort
+    );
+  }
+  if (options?.where != null) {
+    search.set("whereJson", JSON.stringify(options.where));
+  }
+}
+function listingGroupsQueryCatalogUrl(options) {
+  const search = new URLSearchParams();
+  appendListingGroupsQuerySearchParams(search, options);
+  const query = search.toString();
+  return `/api/products/listing-groups/query/catalog${query ? `?${query}` : ""}`;
+}
+
+// src/core/query/query-hooks.ts
+var LISTING_GROUPS_QUERY_PATH = "/api/products/listing-groups/query";
+function fetchProductListingGroupsQuery(collectionClient, queryOptions) {
+  return collectionClient.requestFindEndpoint(
+    LISTING_GROUPS_QUERY_PATH,
+    { options: queryOptions }
+  );
+}
+function fetchProductListingGroupsCatalogQuery(collectionClient, queryOptions) {
+  return collectionClient.requestFindEndpointGet(
+    listingGroupsQueryCatalogUrl(queryOptions)
+  );
+}
 var QueryHooks = class extends CollectionHooks {
   constructor(queryClient, collectionClient, customerAuth, commerceClient) {
     super(queryClient, collectionClient);
@@ -605,9 +668,21 @@ var QueryHooks = class extends CollectionHooks {
     const { placeholderData, ...restOptions } = options ?? {};
     return useQueryOriginal3({
       queryKey: productKeys.listingGroups(queryOptions),
-      queryFn: async () => this.collectionClient.requestFindEndpoint(
-        "/api/products/listing-groups/query",
-        { options: queryOptions }
+      queryFn: async () => fetchProductListingGroupsQuery(this.collectionClient, queryOptions),
+      ...restOptions,
+      ...placeholderData !== void 0 && {
+        placeholderData
+      }
+    });
+  }
+  useProductListingGroupsCatalogQuery(params, options) {
+    const queryOptions = params.options;
+    const { placeholderData, ...restOptions } = options ?? {};
+    return useQueryOriginal3({
+      queryKey: productKeys.listingGroupsCatalog(queryOptions),
+      queryFn: async () => fetchProductListingGroupsCatalogQuery(
+        this.collectionClient,
+        queryOptions
       ),
       ...restOptions,
       ...placeholderData !== void 0 && {
@@ -619,9 +694,17 @@ var QueryHooks = class extends CollectionHooks {
     const queryOptions = params.options;
     return useSuspenseQueryOriginal2({
       queryKey: productKeys.listingGroups(queryOptions),
-      queryFn: async () => this.collectionClient.requestFindEndpoint(
-        "/api/products/listing-groups/query",
-        { options: queryOptions }
+      queryFn: async () => fetchProductListingGroupsQuery(this.collectionClient, queryOptions),
+      ...options
+    });
+  }
+  useSuspenseProductListingGroupsCatalogQuery(params, options) {
+    const queryOptions = params.options;
+    return useSuspenseQueryOriginal2({
+      queryKey: productKeys.listingGroupsCatalog(queryOptions),
+      queryFn: async () => fetchProductListingGroupsCatalogQuery(
+        this.collectionClient,
+        queryOptions
       ),
       ...options
     });
@@ -633,12 +716,28 @@ var QueryHooks = class extends CollectionHooks {
     } = params;
     return useInfiniteQueryOriginal2({
       queryKey: productKeys.listingGroupsInfinite(queryOptions),
-      queryFn: async ({ pageParam }) => this.collectionClient.requestFindEndpoint(
-        "/api/products/listing-groups/query",
-        {
-          options: { ...queryOptions, page: pageParam, limit: pageSize }
-        }
-      ),
+      queryFn: async ({ pageParam }) => fetchProductListingGroupsQuery(this.collectionClient, {
+        ...queryOptions,
+        page: pageParam,
+        limit: pageSize
+      }),
+      initialPageParam: 1,
+      getNextPageParam: (lastPage) => lastPage.hasNextPage ? lastPage.nextPage : void 0,
+      ...options
+    });
+  }
+  useInfiniteProductListingGroupsCatalogQuery(params, options) {
+    const {
+      options: queryOptions,
+      pageSize = 20
+    } = params;
+    return useInfiniteQueryOriginal2({
+      queryKey: productKeys.listingGroupsCatalogInfinite(queryOptions),
+      queryFn: async ({ pageParam }) => fetchProductListingGroupsCatalogQuery(this.collectionClient, {
+        ...queryOptions,
+        page: pageParam,
+        limit: pageSize
+      }),
       initialPageParam: 1,
       getNextPageParam: (lastPage) => lastPage.hasNextPage ? lastPage.nextPage : void 0,
       ...options
@@ -651,12 +750,28 @@ var QueryHooks = class extends CollectionHooks {
     } = params;
     return useSuspenseInfiniteQueryOriginal2({
       queryKey: productKeys.listingGroupsInfinite(queryOptions),
-      queryFn: async ({ pageParam }) => this.collectionClient.requestFindEndpoint(
-        "/api/products/listing-groups/query",
-        {
-          options: { ...queryOptions, page: pageParam, limit: pageSize }
-        }
-      ),
+      queryFn: async ({ pageParam }) => fetchProductListingGroupsQuery(this.collectionClient, {
+        ...queryOptions,
+        page: pageParam,
+        limit: pageSize
+      }),
+      initialPageParam: 1,
+      getNextPageParam: (lastPage) => lastPage.hasNextPage ? lastPage.nextPage : void 0,
+      ...options
+    });
+  }
+  useSuspenseInfiniteProductListingGroupsCatalogQuery(params, options) {
+    const {
+      options: queryOptions,
+      pageSize = 20
+    } = params;
+    return useSuspenseInfiniteQueryOriginal2({
+      queryKey: productKeys.listingGroupsCatalogInfinite(queryOptions),
+      queryFn: async ({ pageParam }) => fetchProductListingGroupsCatalogQuery(this.collectionClient, {
+        ...queryOptions,
+        page: pageParam,
+        limit: pageSize
+      }),
       initialPageParam: 1,
       getNextPageParam: (lastPage) => lastPage.hasNextPage ? lastPage.nextPage : void 0,
       ...options
@@ -666,9 +781,17 @@ var QueryHooks = class extends CollectionHooks {
     const queryOptions = params.options;
     return this.queryClient.prefetchQuery({
       queryKey: productKeys.listingGroups(queryOptions),
-      queryFn: async () => this.collectionClient.requestFindEndpoint(
-        "/api/products/listing-groups/query",
-        { options: queryOptions }
+      queryFn: async () => fetchProductListingGroupsQuery(this.collectionClient, queryOptions),
+      ...options
+    });
+  }
+  async prefetchProductListingGroupsCatalogQuery(params, options) {
+    const queryOptions = params.options;
+    return this.queryClient.prefetchQuery({
+      queryKey: productKeys.listingGroupsCatalog(queryOptions),
+      queryFn: async () => fetchProductListingGroupsCatalogQuery(
+        this.collectionClient,
+        queryOptions
       ),
       ...options
     });
@@ -680,12 +803,29 @@ var QueryHooks = class extends CollectionHooks {
     } = params;
     return this.queryClient.prefetchInfiniteQuery({
       queryKey: productKeys.listingGroupsInfinite(queryOptions),
-      queryFn: async ({ pageParam }) => this.collectionClient.requestFindEndpoint(
-        "/api/products/listing-groups/query",
-        {
-          options: { ...queryOptions, page: pageParam, limit: pageSize }
-        }
-      ),
+      queryFn: async ({ pageParam }) => fetchProductListingGroupsQuery(this.collectionClient, {
+        ...queryOptions,
+        page: pageParam,
+        limit: pageSize
+      }),
+      initialPageParam: 1,
+      getNextPageParam: (lastPage) => lastPage.hasNextPage ? lastPage.nextPage : void 0,
+      pages: options?.pages ?? 1,
+      staleTime: options?.staleTime
+    });
+  }
+  async prefetchInfiniteProductListingGroupsCatalogQuery(params, options) {
+    const {
+      options: queryOptions,
+      pageSize = 20
+    } = params;
+    return this.queryClient.prefetchInfiniteQuery({
+      queryKey: productKeys.listingGroupsCatalogInfinite(queryOptions),
+      queryFn: async ({ pageParam }) => fetchProductListingGroupsCatalogQuery(this.collectionClient, {
+        ...queryOptions,
+        page: pageParam,
+        limit: pageSize
+      }),
       initialPageParam: 1,
       getNextPageParam: (lastPage) => lastPage.hasNextPage ? lastPage.nextPage : void 0,
       pages: options?.pages ?? 1,
@@ -694,11 +834,13 @@ var QueryHooks = class extends CollectionHooks {
   }
   useProductDetail(params, options) {
     const discriminator = "slug" in params ? params.slug : params.id;
-    const enabled = options?.enabled !== false && Boolean(discriminator);
+    const { enabled, ...restOptions } = options ?? {};
+    const queryEnabled = enabled !== false && Boolean(discriminator);
     return useQueryOriginal3({
       queryKey: productKeys.detail(params),
       queryFn: () => this._commerce.product.detail(params),
-      enabled
+      enabled: queryEnabled,
+      ...restOptions
     });
   }
   useProductDetailBySlug(slug, options) {
@@ -1080,9 +1222,12 @@ function resolveApiUrl(apiUrl) {
 
 // src/core/internal/utils/http.ts
 var DEFAULT_TIMEOUT = 3e4;
+var STOREFRONT_BROWSER_TIMEOUT = 15e3;
 var DEFAULT_RETRYABLE_STATUSES = [408, 429, 500, 502, 503, 504];
 var NON_RETRYABLE_STATUSES = [400, 401, 403, 404, 409, 422];
 var SAFE_METHODS = ["GET", "HEAD", "OPTIONS"];
+var DEFAULT_MAX_RETRIES = 3;
+var STOREFRONT_BROWSER_MAX_RETRIES = 1;
 function debugLog(debug, type, message, data) {
   if (!debug) return;
   const shouldLog = debug === true || type === "request" && debug.logRequests || type === "response" && debug.logResponses || type === "error" && debug.logErrors;
@@ -1275,15 +1420,18 @@ async function httpFetch(url, options) {
     publishableKey,
     secretKey,
     customerToken,
-    timeout = DEFAULT_TIMEOUT,
+    timeout: timeoutOption = DEFAULT_TIMEOUT,
     debug,
     retry,
     onUnauthorized,
     ...requestInit
   } = options || {};
   const baseUrl = resolveApiUrl(apiUrl);
+  const method = (requestInit.method || "GET").toUpperCase();
+  const isPublishableKeyBrowserGet = typeof window !== "undefined" && !secretKey && !customerToken && Boolean(publishableKey) && SAFE_METHODS.includes(method);
+  const timeout = timeoutOption === DEFAULT_TIMEOUT && isPublishableKeyBrowserGet ? STOREFRONT_BROWSER_TIMEOUT : timeoutOption;
   const retryConfig = {
-    maxRetries: retry?.maxRetries ?? 3,
+    maxRetries: retry?.maxRetries ?? (isPublishableKeyBrowserGet ? STOREFRONT_BROWSER_MAX_RETRIES : DEFAULT_MAX_RETRIES),
     retryableStatuses: retry?.retryableStatuses ?? DEFAULT_RETRYABLE_STATUSES,
     retryDelay: retry?.retryDelay ?? ((attempt) => Math.min(1e3 * 2 ** attempt, 1e4))
   };
@@ -1391,8 +1539,8 @@ async function httpFetch(url, options) {
           ),
           requestId
         );
-        const method = (requestInit.method || "GET").toUpperCase();
-        if (attempt < retryConfig.maxRetries && SAFE_METHODS.includes(method) && retryConfig.retryableStatuses.includes(response.status)) {
+        const method2 = (requestInit.method || "GET").toUpperCase();
+        if (attempt < retryConfig.maxRetries && SAFE_METHODS.includes(method2) && retryConfig.retryableStatuses.includes(response.status)) {
           lastError = error;
           const retryDelay = retryConfig.retryDelay(attempt);
           debugLog(debug, "error", `Retrying in ${retryDelay}ms...`, error);
@@ -1404,8 +1552,8 @@ async function httpFetch(url, options) {
       return response;
     } catch (error) {
       debugLog(debug, "error", url, error);
-      const method = (requestInit.method || "GET").toUpperCase();
-      const isSafe = SAFE_METHODS.includes(method);
+      const method2 = (requestInit.method || "GET").toUpperCase();
+      const isSafe = SAFE_METHODS.includes(method2);
       if (error instanceof Error && error.name === "AbortError") {
         const timeoutError = createTimeoutError(
           `Request timed out after ${timeout}ms.`,
@@ -1638,6 +1786,16 @@ var CollectionClient = class extends HttpClient {
     });
     return this.parseFindResponse(response);
   }
+  /**
+   * Find-like response from a cacheable GET custom endpoint.
+   */
+  async requestFindEndpointGet(endpoint) {
+    const response = await this.fetchWithTracking(endpoint, {
+      ...this.defaultOptions,
+      method: "GET"
+    });
+    return this.parseFindResponse(response);
+  }
   /**
    * Find document by ID
    * GET /api/{collection}/{id}
@@ -1831,6 +1989,7 @@ export {
   createServerQueryHooks,
   customerKeys,
   getQueryClient,
+  getStorefrontQueryClient,
   productKeys
 };
 //# sourceMappingURL=query.js.map