@01.software/sdk 0.38.0 → 0.40.0

package/dist/query.d.cts

@@ -1,10 +1,10 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient, UseQueryResult, UseSuspenseQueryResult, InfiniteData, UseInfiniteQueryResult, UseSuspenseInfiniteQueryResult } from '@tanstack/react-query';
-import { e as ApiQueryOptions, P as PayloadFindResponse, l as PayloadMutationResponse, an as CustomerAuth, ao as CustomerProfile, ap as CustomerAuthResponse, aq as CustomerLoginData, ar as CustomerRegisterResponse, as as CustomerRegisterData, at as CustomerRefreshResponse, au as UpdateProfileData, av as ProductDetailParams, aw as ProductDetailResult, ax as ProductListingGroupsItem, ay as ProductListingGroupsCatalogItem, w as RootClient, ab as RootServerClient } from './types-CIGscmus.cjs';
-import './payload-types-m3jjhxk9.cjs';
-import { C as CollectionClient } from './collection-client-B0J9wMNE.cjs';
-import { S as ServerCollection, P as PublicCollection } from './const-B5KT72c7.cjs';
-import { C as CollectionType } from './types-D0ubzQw0.cjs';
+import { f as ApiQueryOptions, P as PayloadFindResponse, ax as PublicReadQueryOptions, n as PayloadMutationResponse, ay as CustomerAuth, az as CustomerProfile, aA as CustomerAuthResponse, aB as CustomerLoginData, aC as CustomerRegisterResponse, aD as CustomerRegisterData, aE as CustomerRefreshResponse, aF as UpdateProfileData, aG as ProductListingPageBaseParams, aH as ProductListingPageParams, aI as ProductDetailParams, aJ as ProductDetailResult, aK as ProductListingPageCatalogParams, aL as ProductListingPageResult, aM as ProductListingGroupsCatalogItem, aN as ProductListingPageFullParams, aO as ProductListingGroupsItem, S as Sort, W as Where, y as RootClient, al as RootServerClient } from './types-D5uHrPLr.cjs';
+import './payload-types-DC0xzR9i.cjs';
+import { C as CollectionClient } from './collection-client-VYwYi6u6.cjs';
+import { S as ServerCollection, P as PublicCollection } from './const-4BUtUdGU.cjs';
+import { C as CollectionType } from './types-BvpjooU-.cjs';
 import { SDKError } from './errors.cjs';
 export { a as RealtimeConnection, R as RealtimeEvent, b as RealtimeListener } from './realtime-D7HtUpqt.cjs';
 import './metadata.cjs';
@@ -17,18 +17,21 @@ declare function getQueryClient(): QueryClient;
  */
 declare function getStorefrontQueryClient(): QueryClient;
 
-interface CollectionQueryParams<T extends ServerCollection> {
+type CollectionReadOptions<TCollection extends ServerCollection> = [
+    TCollection
+] extends [PublicCollection] ? PublicReadQueryOptions : ApiQueryOptions;
+interface CollectionQueryParams<T extends ServerCollection, Options extends ApiQueryOptions = ApiQueryOptions> {
     collection: T;
-    options?: ApiQueryOptions;
+    options?: Options;
 }
-interface CollectionDetailQueryParams<T extends ServerCollection> {
+interface CollectionDetailQueryParams<T extends ServerCollection, Options extends ApiQueryOptions = ApiQueryOptions> {
     collection: T;
     id: string;
-    options?: ApiQueryOptions;
+    options?: Options;
 }
-interface CollectionInfiniteQueryParams<T extends ServerCollection> {
+interface CollectionInfiniteQueryParams<T extends ServerCollection, Options extends ApiQueryOptions = ApiQueryOptions> {
     collection: T;
-    options?: Omit<ApiQueryOptions, 'page'>;
+    options?: Omit<Options, 'page'>;
     pageSize?: number;
 }
 interface QueryOptions<TQueryFnData = unknown, TData = TQueryFnData> {
@@ -65,19 +68,19 @@ declare class CollectionHooks<TCollection extends ServerCollection = PublicColle
     protected queryClient: QueryClient;
     protected collectionClient: CollectionClient<TCollection>;
     constructor(queryClient: QueryClient, collectionClient: CollectionClient<TCollection>);
-    useQuery<T extends TCollection, TData = PayloadFindResponse<CollectionType<T>>>(params: CollectionQueryParams<T>, options?: QueryOptions<PayloadFindResponse<CollectionType<T>>, TData>): UseQueryResult<TData>;
-    useSuspenseQuery<T extends TCollection, TData = PayloadFindResponse<CollectionType<T>>>(params: CollectionQueryParams<T>, options?: SuspenseQueryOptions<PayloadFindResponse<CollectionType<T>>, TData>): UseSuspenseQueryResult<TData>;
-    useQueryById<T extends TCollection, TData = CollectionType<T>>(params: CollectionDetailQueryParams<T>, options?: QueryOptions<CollectionType<T>, TData>): UseQueryResult<TData>;
-    useSuspenseQueryById<T extends TCollection, TData = CollectionType<T>>(params: CollectionDetailQueryParams<T>, options?: SuspenseQueryOptions<CollectionType<T>, TData>): UseSuspenseQueryResult<TData>;
-    useInfiniteQuery<T extends TCollection, TData = InfiniteData<PayloadFindResponse<CollectionType<T>>>>(params: CollectionInfiniteQueryParams<T>, options?: InfiniteQueryOptions<PayloadFindResponse<CollectionType<T>>, TData>): UseInfiniteQueryResult<TData>;
-    useSuspenseInfiniteQuery<T extends TCollection, TData = InfiniteData<PayloadFindResponse<CollectionType<T>>>>(params: CollectionInfiniteQueryParams<T>, options?: SuspenseInfiniteQueryOptions<PayloadFindResponse<CollectionType<T>>, TData>): UseSuspenseInfiniteQueryResult<TData>;
-    prefetchQuery<T extends TCollection>(params: CollectionQueryParams<T>, options?: {
+    useQuery<T extends TCollection, TData = PayloadFindResponse<CollectionType<T>>>(params: CollectionQueryParams<T, CollectionReadOptions<TCollection>>, options?: QueryOptions<PayloadFindResponse<CollectionType<T>>, TData>): UseQueryResult<TData>;
+    useSuspenseQuery<T extends TCollection, TData = PayloadFindResponse<CollectionType<T>>>(params: CollectionQueryParams<T, CollectionReadOptions<TCollection>>, options?: SuspenseQueryOptions<PayloadFindResponse<CollectionType<T>>, TData>): UseSuspenseQueryResult<TData>;
+    useQueryById<T extends TCollection, TData = CollectionType<T>>(params: CollectionDetailQueryParams<T, CollectionReadOptions<TCollection>>, options?: QueryOptions<CollectionType<T>, TData>): UseQueryResult<TData>;
+    useSuspenseQueryById<T extends TCollection, TData = CollectionType<T>>(params: CollectionDetailQueryParams<T, CollectionReadOptions<TCollection>>, options?: SuspenseQueryOptions<CollectionType<T>, TData>): UseSuspenseQueryResult<TData>;
+    useInfiniteQuery<T extends TCollection, TData = InfiniteData<PayloadFindResponse<CollectionType<T>>>>(params: CollectionInfiniteQueryParams<T, CollectionReadOptions<TCollection>>, options?: InfiniteQueryOptions<PayloadFindResponse<CollectionType<T>>, TData>): UseInfiniteQueryResult<TData>;
+    useSuspenseInfiniteQuery<T extends TCollection, TData = InfiniteData<PayloadFindResponse<CollectionType<T>>>>(params: CollectionInfiniteQueryParams<T, CollectionReadOptions<TCollection>>, options?: SuspenseInfiniteQueryOptions<PayloadFindResponse<CollectionType<T>>, TData>): UseSuspenseInfiniteQueryResult<TData>;
+    prefetchQuery<T extends TCollection>(params: CollectionQueryParams<T, CollectionReadOptions<TCollection>>, options?: {
         staleTime?: number;
     }): Promise<void>;
-    prefetchQueryById<T extends TCollection>(params: CollectionDetailQueryParams<T>, options?: {
+    prefetchQueryById<T extends TCollection>(params: CollectionDetailQueryParams<T, CollectionReadOptions<TCollection>>, options?: {
         staleTime?: number;
     }): Promise<void>;
-    prefetchInfiniteQuery<T extends TCollection>(params: CollectionInfiniteQueryParams<T>, options?: {
+    prefetchInfiniteQuery<T extends TCollection>(params: CollectionInfiniteQueryParams<T, CollectionReadOptions<TCollection>>, options?: {
         pages?: number;
         staleTime?: number;
     }): Promise<void>;
@@ -148,7 +151,18 @@ declare class CustomerHooks {
 }
 
 type ProductListingGroupsQueryOptions = Pick<ApiQueryOptions, 'page' | 'limit' | 'sort' | 'where'>;
-type ReadOnlyQueryHooks = Omit<QueryHooks<PublicCollection>, 'useCreate' | 'useUpdate' | 'useRemove'>;
+type ReadOnlyQueryHooks = Omit<QueryHooks<PublicCollection>, 'useCreate' | 'useUpdate' | 'useRemove' | 'useProductListingGroupsQuery' | 'useSuspenseProductListingGroupsQuery' | 'useInfiniteProductListingGroupsQuery' | 'useSuspenseInfiniteProductListingGroupsQuery' | 'prefetchProductListingGroupsQuery' | 'prefetchInfiniteProductListingGroupsQuery' | 'useProductListingPage' | 'useSuspenseProductListingPage' | 'useInfiniteProductListingPage' | 'prefetchProductListingPage' | 'prefetchInfiniteProductListingPage'> & {
+    useProductListingPage<TData = ProductListingPageResult<ProductListingGroupsCatalogItem>>(params?: ProductListingPageCatalogParams, options?: QueryOptions<ProductListingPageResult<ProductListingGroupsCatalogItem>, TData>): UseQueryResult<TData>;
+    useSuspenseProductListingPage<TData = ProductListingPageResult<ProductListingGroupsCatalogItem>>(params?: ProductListingPageCatalogParams, options?: SuspenseQueryOptions<ProductListingPageResult<ProductListingGroupsCatalogItem>, TData>): UseSuspenseQueryResult<TData>;
+    useInfiniteProductListingPage<TData = InfiniteData<ProductListingPageResult<ProductListingGroupsCatalogItem>>>(params?: ProductListingPageCatalogInfiniteParams, options?: InfiniteQueryOptions<ProductListingPageResult<ProductListingGroupsCatalogItem>, TData>): UseInfiniteQueryResult<TData>;
+    prefetchProductListingPage(params?: ProductListingPageCatalogParams, options?: {
+        staleTime?: number;
+    }): Promise<void>;
+    prefetchInfiniteProductListingPage(params?: ProductListingPageCatalogInfiniteParams, options?: {
+        pages?: number;
+        staleTime?: number;
+    }): Promise<void>;
+};
 /**
  * Composes CollectionHooks + CustomerHooks into a single API surface.
  * All methods are delegated; no logic lives here.
@@ -158,10 +172,79 @@ interface ProductDetailCallable {
         detail: (params: ProductDetailParams) => Promise<ProductDetailResult>;
     };
 }
+interface ProductListingPageCatalogCallable {
+    product: {
+        listingPage: {
+            (params?: ProductListingPageCatalogParams): Promise<ProductListingPageResult<ProductListingGroupsCatalogItem>>;
+        };
+    };
+}
+interface ProductListingPageCallable extends ProductListingPageCatalogCallable {
+    product: ProductListingPageCatalogCallable['product'] & {
+        listingPage: ProductListingPageCatalogCallable['product']['listingPage'] & {
+            (params: ProductListingPageFullParams): Promise<ProductListingPageResult<ProductListingGroupsItem>>;
+            (params: ProductListingPageParams): Promise<ProductListingPageResult<ProductListingGroupsCatalogItem> | ProductListingPageResult<ProductListingGroupsItem>>;
+        };
+    };
+}
+type ProductCommerceCallable = ProductDetailCallable & ProductListingPageCallable;
+type ProductListingPageInfiniteParams = Omit<ProductListingPageBaseParams, 'page' | 'limit'> & {
+    mode?: ProductListingPageParams['mode'];
+    pageSize?: number;
+};
+type ProductListingPageCatalogInfiniteParams = Omit<ProductListingPageInfiniteParams, 'mode'> & {
+    mode?: 'catalog';
+};
+declare function productListingPageQueryOptions(commerceClient: ProductListingPageCatalogCallable, params?: ProductListingPageCatalogParams): {
+    queryKey: ReturnType<typeof productKeys.listingPage>;
+    queryFn: () => Promise<ProductListingPageResult<ProductListingGroupsCatalogItem>>;
+};
+declare function productListingPageQueryOptions(commerceClient: ProductListingPageCallable, params: ProductListingPageFullParams): {
+    queryKey: ReturnType<typeof productKeys.listingPage>;
+    queryFn: () => Promise<ProductListingPageResult<ProductListingGroupsItem>>;
+};
+declare function productListingPageQueryOptions(commerceClient: ProductListingPageCallable, params: ProductListingPageParams): {
+    queryKey: ReturnType<typeof productKeys.listingPage>;
+    queryFn: () => Promise<ProductListingPageResult<ProductListingGroupsCatalogItem> | ProductListingPageResult<ProductListingGroupsItem>>;
+};
+declare function productListingPageInfiniteQueryOptions(commerceClient: ProductListingPageCatalogCallable, params?: ProductListingPageCatalogInfiniteParams): {
+    queryKey: ReturnType<typeof productKeys.listingPageInfinite>;
+    queryFn: (args: {
+        pageParam: number;
+    }) => Promise<ProductListingPageResult<ProductListingGroupsCatalogItem>>;
+    initialPageParam: number;
+    getNextPageParam: (lastPage: ProductListingPageResult<ProductListingGroupsCatalogItem>) => number | null | undefined;
+};
+declare function productListingPageInfiniteQueryOptions(commerceClient: ProductListingPageCallable, params?: ProductListingPageInfiniteParams): {
+    queryKey: ReturnType<typeof productKeys.listingPageInfinite>;
+    queryFn: (args: {
+        pageParam: number;
+    }) => Promise<ProductListingPageResult<ProductListingGroupsCatalogItem> | ProductListingPageResult<ProductListingGroupsItem>>;
+    initialPageParam: number;
+    getNextPageParam: (lastPage: ProductListingPageResult<ProductListingGroupsCatalogItem | ProductListingGroupsItem>) => number | null | undefined;
+};
+declare function prefetchProductListingPage(queryClient: QueryClient, commerceClient: ProductListingPageCatalogCallable, params?: ProductListingPageCatalogParams, options?: {
+    staleTime?: number;
+}): Promise<void>;
+declare function prefetchProductListingPage(queryClient: QueryClient, commerceClient: ProductListingPageCallable, params: ProductListingPageFullParams, options?: {
+    staleTime?: number;
+}): Promise<void>;
+declare function prefetchProductListingPage(queryClient: QueryClient, commerceClient: ProductListingPageCallable, params: ProductListingPageParams, options?: {
+    staleTime?: number;
+}): Promise<void>;
+declare function prefetchInfiniteProductListingPage(queryClient: QueryClient, commerceClient: ProductListingPageCatalogCallable, params?: ProductListingPageCatalogInfiniteParams, options?: {
+    pages?: number;
+    staleTime?: number;
+}): Promise<void>;
+declare function prefetchInfiniteProductListingPage(queryClient: QueryClient, commerceClient: ProductListingPageCallable, params?: ProductListingPageInfiniteParams, options?: {
+    pages?: number;
+    staleTime?: number;
+}): Promise<void>;
 declare class QueryHooks<TCollection extends ServerCollection = PublicCollection> extends CollectionHooks<TCollection> {
     private _customer;
     private _commerce?;
-    constructor(queryClient: QueryClient, collectionClient: CollectionClient<TCollection>, customerAuth?: CustomerAuth, commerceClient?: ProductDetailCallable);
+    constructor(queryClient: QueryClient, collectionClient: CollectionClient<TCollection>, customerAuth?: CustomerAuth, commerceClient?: ProductCommerceCallable);
+    private ensureCommerce;
     useCustomerMe: CustomerHooks['useCustomerMe'];
     useCustomerLogin: CustomerHooks['useCustomerLogin'];
     useCustomerRegister: CustomerHooks['useCustomerRegister'];
@@ -226,6 +309,26 @@ declare class QueryHooks<TCollection extends ServerCollection = PublicCollection
         pages?: number;
         staleTime?: number;
     }): Promise<void>;
+    useProductListingPage<TData = ProductListingPageResult<ProductListingGroupsCatalogItem>>(params?: ProductListingPageCatalogParams, options?: QueryOptions<ProductListingPageResult<ProductListingGroupsCatalogItem>, TData>): UseQueryResult<TData>;
+    useProductListingPage<TData = ProductListingPageResult<ProductListingGroupsItem>>(params: ProductListingPageFullParams, options?: QueryOptions<ProductListingPageResult<ProductListingGroupsItem>, TData>): UseQueryResult<TData>;
+    useProductListingPage<TData = ProductListingPageResult<ProductListingGroupsCatalogItem> | ProductListingPageResult<ProductListingGroupsItem>>(params: ProductListingPageParams, options?: QueryOptions<ProductListingPageResult<ProductListingGroupsCatalogItem> | ProductListingPageResult<ProductListingGroupsItem>, TData>): UseQueryResult<TData>;
+    useSuspenseProductListingPage<TData = ProductListingPageResult<ProductListingGroupsCatalogItem>>(params?: ProductListingPageCatalogParams, options?: SuspenseQueryOptions<ProductListingPageResult<ProductListingGroupsCatalogItem>, TData>): UseSuspenseQueryResult<TData>;
+    useSuspenseProductListingPage<TData = ProductListingPageResult<ProductListingGroupsItem>>(params: ProductListingPageFullParams, options?: SuspenseQueryOptions<ProductListingPageResult<ProductListingGroupsItem>, TData>): UseSuspenseQueryResult<TData>;
+    useSuspenseProductListingPage<TData = ProductListingPageResult<ProductListingGroupsCatalogItem> | ProductListingPageResult<ProductListingGroupsItem>>(params: ProductListingPageParams, options?: SuspenseQueryOptions<ProductListingPageResult<ProductListingGroupsCatalogItem> | ProductListingPageResult<ProductListingGroupsItem>, TData>): UseSuspenseQueryResult<TData>;
+    useInfiniteProductListingPage<TData = InfiniteData<ProductListingPageResult<ProductListingGroupsCatalogItem | ProductListingGroupsItem>>>(params?: ProductListingPageInfiniteParams, options?: InfiniteQueryOptions<ProductListingPageResult<ProductListingGroupsCatalogItem | ProductListingGroupsItem>, TData>): UseInfiniteQueryResult<TData>;
+    prefetchProductListingPage(params?: ProductListingPageCatalogParams, options?: {
+        staleTime?: number;
+    }): Promise<void>;
+    prefetchProductListingPage(params: ProductListingPageFullParams, options?: {
+        staleTime?: number;
+    }): Promise<void>;
+    prefetchProductListingPage(params: ProductListingPageParams, options?: {
+        staleTime?: number;
+    }): Promise<void>;
+    prefetchInfiniteProductListingPage(params?: ProductListingPageInfiniteParams, options?: {
+        pages?: number;
+        staleTime?: number;
+    }): Promise<void>;
     useProductDetail(params: {
         slug: string;
     } | {
@@ -235,6 +338,18 @@ declare class QueryHooks<TCollection extends ServerCollection = PublicCollection
     useProductDetailById(id: string, options?: QueryOptions<ProductDetailResult>): UseQueryResult<ProductDetailResult>;
 }
 
+type ProductListingPageKeyParams = {
+    mode: 'catalog' | 'full';
+    page?: number;
+    limit?: number;
+    search?: string;
+    sort?: ProductListingPageParams['sort'];
+    filters?: NonNullable<ProductListingPageParams['filters']>;
+    basePath?: string;
+    trailingSlash?: boolean;
+    emit?: ProductListingPageParams['emit'];
+    preferCompleteVariantFromHint?: ProductListingPageParams['preferCompleteVariantFromHint'];
+};
 declare function collectionKeys<T extends ServerCollection>(collection: T): {
     all: readonly [T];
     lists: () => readonly [T, "list"];
@@ -242,7 +357,7 @@ declare function collectionKeys<T extends ServerCollection>(collection: T): {
     details: () => readonly [T, "detail"];
     detail: (id: string, options?: ApiQueryOptions) => readonly [T, "detail", string, ApiQueryOptions | undefined];
     infinites: () => readonly [T, "infinite"];
-    infinite: (options?: Omit<ApiQueryOptions, "page">) => readonly [T, "infinite", Omit<ApiQueryOptions, "page"> | undefined];
+    infinite: (options?: Omit<ApiQueryOptions, "page">, pageSize?: number) => readonly [T, "infinite", Omit<ApiQueryOptions, "page"> | undefined];
 };
 declare const customerKeys: {
     all: readonly ["customer"];
@@ -251,8 +366,18 @@ 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];
+    listingGroupsInfinite: (options?: Omit<ProductListingGroupsQueryOptions, "page" | "limit">, pageSize?: number) => readonly ["products", "listing-groups", "infinite", Omit<ProductListingGroupsQueryOptions, "page" | "limit"> | {
+        limit: number;
+        sort?: Sort;
+        where?: Where;
+    } | undefined];
+    listingGroupsCatalogInfinite: (options?: Omit<ProductListingGroupsQueryOptions, "page" | "limit">, pageSize?: number) => readonly ["products", "listing-groups", "catalog", "infinite", Omit<ProductListingGroupsQueryOptions, "page" | "limit"> | {
+        limit: number;
+        sort?: Sort;
+        where?: Where;
+    } | undefined];
+    listingPage: (params?: ProductListingPageParams) => readonly ["products", "listing-page", ProductListingPageKeyParams];
+    listingPageInfinite: (params?: Omit<ProductListingPageParams, "page" | "limit">, pageSize?: number) => readonly ["products", "listing-page", "infinite", ProductListingPageKeyParams];
     detail: (params: {
         slug: string;
     } | {
@@ -268,4 +393,4 @@ declare const productKeys: {
 declare function createQueryHooks(client: RootClient, queryClient?: QueryClient): ReadOnlyQueryHooks;
 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, getStorefrontQueryClient, productKeys };
+export { type CollectionDetailQueryParams, CollectionHooks, type CollectionInfiniteQueryParams, type CollectionQueryParams, CustomerHooks, type InfiniteQueryOptions, type ProductListingGroupsQueryOptions, type ProductListingPageCatalogInfiniteParams, type ProductListingPageInfiniteParams, QueryHooks, type QueryOptions, type ReadOnlyQueryHooks, type SuspenseInfiniteQueryOptions, type SuspenseQueryOptions, collectionKeys, createQueryHooks, createServerQueryHooks, customerKeys, getQueryClient, getStorefrontQueryClient, prefetchInfiniteProductListingPage, prefetchProductListingPage, productKeys, productListingPageInfiniteQueryOptions, productListingPageQueryOptions };

package/dist/query.d.ts

@@ -1,10 +1,10 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient, UseQueryResult, UseSuspenseQueryResult, InfiniteData, UseInfiniteQueryResult, UseSuspenseInfiniteQueryResult } from '@tanstack/react-query';
-import { e as ApiQueryOptions, P as PayloadFindResponse, l as PayloadMutationResponse, an as CustomerAuth, ao as CustomerProfile, ap as CustomerAuthResponse, aq as CustomerLoginData, ar as CustomerRegisterResponse, as as CustomerRegisterData, at as CustomerRefreshResponse, au as UpdateProfileData, av as ProductDetailParams, aw as ProductDetailResult, ax as ProductListingGroupsItem, ay as ProductListingGroupsCatalogItem, w as RootClient, ab as RootServerClient } from './types-D2xYdz4P.js';
-import './payload-types-m3jjhxk9.js';
-import { C as CollectionClient } from './collection-client-BroIWHY1.js';
-import { S as ServerCollection, P as PublicCollection } from './const-6XHz_jej.js';
-import { C as CollectionType } from './types-Cmrd1ezc.js';
+import { f as ApiQueryOptions, P as PayloadFindResponse, ax as PublicReadQueryOptions, n as PayloadMutationResponse, ay as CustomerAuth, az as CustomerProfile, aA as CustomerAuthResponse, aB as CustomerLoginData, aC as CustomerRegisterResponse, aD as CustomerRegisterData, aE as CustomerRefreshResponse, aF as UpdateProfileData, aG as ProductListingPageBaseParams, aH as ProductListingPageParams, aI as ProductDetailParams, aJ as ProductDetailResult, aK as ProductListingPageCatalogParams, aL as ProductListingPageResult, aM as ProductListingGroupsCatalogItem, aN as ProductListingPageFullParams, aO as ProductListingGroupsItem, S as Sort, W as Where, y as RootClient, al as RootServerClient } from './types-Umd-YTjM.js';
+import './payload-types-DC0xzR9i.js';
+import { C as CollectionClient } from './collection-client-CKFa99C6.js';
+import { S as ServerCollection, P as PublicCollection } from './const-ymprfiPf.js';
+import { C as CollectionType } from './types-Bh2p-EMc.js';
 import { SDKError } from './errors.js';
 export { a as RealtimeConnection, R as RealtimeEvent, b as RealtimeListener } from './realtime-D7HtUpqt.js';
 import './metadata.js';
@@ -17,18 +17,21 @@ declare function getQueryClient(): QueryClient;
  */
 declare function getStorefrontQueryClient(): QueryClient;
 
-interface CollectionQueryParams<T extends ServerCollection> {
+type CollectionReadOptions<TCollection extends ServerCollection> = [
+    TCollection
+] extends [PublicCollection] ? PublicReadQueryOptions : ApiQueryOptions;
+interface CollectionQueryParams<T extends ServerCollection, Options extends ApiQueryOptions = ApiQueryOptions> {
     collection: T;
-    options?: ApiQueryOptions;
+    options?: Options;
 }
-interface CollectionDetailQueryParams<T extends ServerCollection> {
+interface CollectionDetailQueryParams<T extends ServerCollection, Options extends ApiQueryOptions = ApiQueryOptions> {
     collection: T;
     id: string;
-    options?: ApiQueryOptions;
+    options?: Options;
 }
-interface CollectionInfiniteQueryParams<T extends ServerCollection> {
+interface CollectionInfiniteQueryParams<T extends ServerCollection, Options extends ApiQueryOptions = ApiQueryOptions> {
     collection: T;
-    options?: Omit<ApiQueryOptions, 'page'>;
+    options?: Omit<Options, 'page'>;
     pageSize?: number;
 }
 interface QueryOptions<TQueryFnData = unknown, TData = TQueryFnData> {
@@ -65,19 +68,19 @@ declare class CollectionHooks<TCollection extends ServerCollection = PublicColle
     protected queryClient: QueryClient;
     protected collectionClient: CollectionClient<TCollection>;
     constructor(queryClient: QueryClient, collectionClient: CollectionClient<TCollection>);
-    useQuery<T extends TCollection, TData = PayloadFindResponse<CollectionType<T>>>(params: CollectionQueryParams<T>, options?: QueryOptions<PayloadFindResponse<CollectionType<T>>, TData>): UseQueryResult<TData>;
-    useSuspenseQuery<T extends TCollection, TData = PayloadFindResponse<CollectionType<T>>>(params: CollectionQueryParams<T>, options?: SuspenseQueryOptions<PayloadFindResponse<CollectionType<T>>, TData>): UseSuspenseQueryResult<TData>;
-    useQueryById<T extends TCollection, TData = CollectionType<T>>(params: CollectionDetailQueryParams<T>, options?: QueryOptions<CollectionType<T>, TData>): UseQueryResult<TData>;
-    useSuspenseQueryById<T extends TCollection, TData = CollectionType<T>>(params: CollectionDetailQueryParams<T>, options?: SuspenseQueryOptions<CollectionType<T>, TData>): UseSuspenseQueryResult<TData>;
-    useInfiniteQuery<T extends TCollection, TData = InfiniteData<PayloadFindResponse<CollectionType<T>>>>(params: CollectionInfiniteQueryParams<T>, options?: InfiniteQueryOptions<PayloadFindResponse<CollectionType<T>>, TData>): UseInfiniteQueryResult<TData>;
-    useSuspenseInfiniteQuery<T extends TCollection, TData = InfiniteData<PayloadFindResponse<CollectionType<T>>>>(params: CollectionInfiniteQueryParams<T>, options?: SuspenseInfiniteQueryOptions<PayloadFindResponse<CollectionType<T>>, TData>): UseSuspenseInfiniteQueryResult<TData>;
-    prefetchQuery<T extends TCollection>(params: CollectionQueryParams<T>, options?: {
+    useQuery<T extends TCollection, TData = PayloadFindResponse<CollectionType<T>>>(params: CollectionQueryParams<T, CollectionReadOptions<TCollection>>, options?: QueryOptions<PayloadFindResponse<CollectionType<T>>, TData>): UseQueryResult<TData>;
+    useSuspenseQuery<T extends TCollection, TData = PayloadFindResponse<CollectionType<T>>>(params: CollectionQueryParams<T, CollectionReadOptions<TCollection>>, options?: SuspenseQueryOptions<PayloadFindResponse<CollectionType<T>>, TData>): UseSuspenseQueryResult<TData>;
+    useQueryById<T extends TCollection, TData = CollectionType<T>>(params: CollectionDetailQueryParams<T, CollectionReadOptions<TCollection>>, options?: QueryOptions<CollectionType<T>, TData>): UseQueryResult<TData>;
+    useSuspenseQueryById<T extends TCollection, TData = CollectionType<T>>(params: CollectionDetailQueryParams<T, CollectionReadOptions<TCollection>>, options?: SuspenseQueryOptions<CollectionType<T>, TData>): UseSuspenseQueryResult<TData>;
+    useInfiniteQuery<T extends TCollection, TData = InfiniteData<PayloadFindResponse<CollectionType<T>>>>(params: CollectionInfiniteQueryParams<T, CollectionReadOptions<TCollection>>, options?: InfiniteQueryOptions<PayloadFindResponse<CollectionType<T>>, TData>): UseInfiniteQueryResult<TData>;
+    useSuspenseInfiniteQuery<T extends TCollection, TData = InfiniteData<PayloadFindResponse<CollectionType<T>>>>(params: CollectionInfiniteQueryParams<T, CollectionReadOptions<TCollection>>, options?: SuspenseInfiniteQueryOptions<PayloadFindResponse<CollectionType<T>>, TData>): UseSuspenseInfiniteQueryResult<TData>;
+    prefetchQuery<T extends TCollection>(params: CollectionQueryParams<T, CollectionReadOptions<TCollection>>, options?: {
         staleTime?: number;
     }): Promise<void>;
-    prefetchQueryById<T extends TCollection>(params: CollectionDetailQueryParams<T>, options?: {
+    prefetchQueryById<T extends TCollection>(params: CollectionDetailQueryParams<T, CollectionReadOptions<TCollection>>, options?: {
         staleTime?: number;
     }): Promise<void>;
-    prefetchInfiniteQuery<T extends TCollection>(params: CollectionInfiniteQueryParams<T>, options?: {
+    prefetchInfiniteQuery<T extends TCollection>(params: CollectionInfiniteQueryParams<T, CollectionReadOptions<TCollection>>, options?: {
         pages?: number;
         staleTime?: number;
     }): Promise<void>;
@@ -148,7 +151,18 @@ declare class CustomerHooks {
 }
 
 type ProductListingGroupsQueryOptions = Pick<ApiQueryOptions, 'page' | 'limit' | 'sort' | 'where'>;
-type ReadOnlyQueryHooks = Omit<QueryHooks<PublicCollection>, 'useCreate' | 'useUpdate' | 'useRemove'>;
+type ReadOnlyQueryHooks = Omit<QueryHooks<PublicCollection>, 'useCreate' | 'useUpdate' | 'useRemove' | 'useProductListingGroupsQuery' | 'useSuspenseProductListingGroupsQuery' | 'useInfiniteProductListingGroupsQuery' | 'useSuspenseInfiniteProductListingGroupsQuery' | 'prefetchProductListingGroupsQuery' | 'prefetchInfiniteProductListingGroupsQuery' | 'useProductListingPage' | 'useSuspenseProductListingPage' | 'useInfiniteProductListingPage' | 'prefetchProductListingPage' | 'prefetchInfiniteProductListingPage'> & {
+    useProductListingPage<TData = ProductListingPageResult<ProductListingGroupsCatalogItem>>(params?: ProductListingPageCatalogParams, options?: QueryOptions<ProductListingPageResult<ProductListingGroupsCatalogItem>, TData>): UseQueryResult<TData>;
+    useSuspenseProductListingPage<TData = ProductListingPageResult<ProductListingGroupsCatalogItem>>(params?: ProductListingPageCatalogParams, options?: SuspenseQueryOptions<ProductListingPageResult<ProductListingGroupsCatalogItem>, TData>): UseSuspenseQueryResult<TData>;
+    useInfiniteProductListingPage<TData = InfiniteData<ProductListingPageResult<ProductListingGroupsCatalogItem>>>(params?: ProductListingPageCatalogInfiniteParams, options?: InfiniteQueryOptions<ProductListingPageResult<ProductListingGroupsCatalogItem>, TData>): UseInfiniteQueryResult<TData>;
+    prefetchProductListingPage(params?: ProductListingPageCatalogParams, options?: {
+        staleTime?: number;
+    }): Promise<void>;
+    prefetchInfiniteProductListingPage(params?: ProductListingPageCatalogInfiniteParams, options?: {
+        pages?: number;
+        staleTime?: number;
+    }): Promise<void>;
+};
 /**
  * Composes CollectionHooks + CustomerHooks into a single API surface.
  * All methods are delegated; no logic lives here.
@@ -158,10 +172,79 @@ interface ProductDetailCallable {
         detail: (params: ProductDetailParams) => Promise<ProductDetailResult>;
     };
 }
+interface ProductListingPageCatalogCallable {
+    product: {
+        listingPage: {
+            (params?: ProductListingPageCatalogParams): Promise<ProductListingPageResult<ProductListingGroupsCatalogItem>>;
+        };
+    };
+}
+interface ProductListingPageCallable extends ProductListingPageCatalogCallable {
+    product: ProductListingPageCatalogCallable['product'] & {
+        listingPage: ProductListingPageCatalogCallable['product']['listingPage'] & {
+            (params: ProductListingPageFullParams): Promise<ProductListingPageResult<ProductListingGroupsItem>>;
+            (params: ProductListingPageParams): Promise<ProductListingPageResult<ProductListingGroupsCatalogItem> | ProductListingPageResult<ProductListingGroupsItem>>;
+        };
+    };
+}
+type ProductCommerceCallable = ProductDetailCallable & ProductListingPageCallable;
+type ProductListingPageInfiniteParams = Omit<ProductListingPageBaseParams, 'page' | 'limit'> & {
+    mode?: ProductListingPageParams['mode'];
+    pageSize?: number;
+};
+type ProductListingPageCatalogInfiniteParams = Omit<ProductListingPageInfiniteParams, 'mode'> & {
+    mode?: 'catalog';
+};
+declare function productListingPageQueryOptions(commerceClient: ProductListingPageCatalogCallable, params?: ProductListingPageCatalogParams): {
+    queryKey: ReturnType<typeof productKeys.listingPage>;
+    queryFn: () => Promise<ProductListingPageResult<ProductListingGroupsCatalogItem>>;
+};
+declare function productListingPageQueryOptions(commerceClient: ProductListingPageCallable, params: ProductListingPageFullParams): {
+    queryKey: ReturnType<typeof productKeys.listingPage>;
+    queryFn: () => Promise<ProductListingPageResult<ProductListingGroupsItem>>;
+};
+declare function productListingPageQueryOptions(commerceClient: ProductListingPageCallable, params: ProductListingPageParams): {
+    queryKey: ReturnType<typeof productKeys.listingPage>;
+    queryFn: () => Promise<ProductListingPageResult<ProductListingGroupsCatalogItem> | ProductListingPageResult<ProductListingGroupsItem>>;
+};
+declare function productListingPageInfiniteQueryOptions(commerceClient: ProductListingPageCatalogCallable, params?: ProductListingPageCatalogInfiniteParams): {
+    queryKey: ReturnType<typeof productKeys.listingPageInfinite>;
+    queryFn: (args: {
+        pageParam: number;
+    }) => Promise<ProductListingPageResult<ProductListingGroupsCatalogItem>>;
+    initialPageParam: number;
+    getNextPageParam: (lastPage: ProductListingPageResult<ProductListingGroupsCatalogItem>) => number | null | undefined;
+};
+declare function productListingPageInfiniteQueryOptions(commerceClient: ProductListingPageCallable, params?: ProductListingPageInfiniteParams): {
+    queryKey: ReturnType<typeof productKeys.listingPageInfinite>;
+    queryFn: (args: {
+        pageParam: number;
+    }) => Promise<ProductListingPageResult<ProductListingGroupsCatalogItem> | ProductListingPageResult<ProductListingGroupsItem>>;
+    initialPageParam: number;
+    getNextPageParam: (lastPage: ProductListingPageResult<ProductListingGroupsCatalogItem | ProductListingGroupsItem>) => number | null | undefined;
+};
+declare function prefetchProductListingPage(queryClient: QueryClient, commerceClient: ProductListingPageCatalogCallable, params?: ProductListingPageCatalogParams, options?: {
+    staleTime?: number;
+}): Promise<void>;
+declare function prefetchProductListingPage(queryClient: QueryClient, commerceClient: ProductListingPageCallable, params: ProductListingPageFullParams, options?: {
+    staleTime?: number;
+}): Promise<void>;
+declare function prefetchProductListingPage(queryClient: QueryClient, commerceClient: ProductListingPageCallable, params: ProductListingPageParams, options?: {
+    staleTime?: number;
+}): Promise<void>;
+declare function prefetchInfiniteProductListingPage(queryClient: QueryClient, commerceClient: ProductListingPageCatalogCallable, params?: ProductListingPageCatalogInfiniteParams, options?: {
+    pages?: number;
+    staleTime?: number;
+}): Promise<void>;
+declare function prefetchInfiniteProductListingPage(queryClient: QueryClient, commerceClient: ProductListingPageCallable, params?: ProductListingPageInfiniteParams, options?: {
+    pages?: number;
+    staleTime?: number;
+}): Promise<void>;
 declare class QueryHooks<TCollection extends ServerCollection = PublicCollection> extends CollectionHooks<TCollection> {
     private _customer;
     private _commerce?;
-    constructor(queryClient: QueryClient, collectionClient: CollectionClient<TCollection>, customerAuth?: CustomerAuth, commerceClient?: ProductDetailCallable);
+    constructor(queryClient: QueryClient, collectionClient: CollectionClient<TCollection>, customerAuth?: CustomerAuth, commerceClient?: ProductCommerceCallable);
+    private ensureCommerce;
     useCustomerMe: CustomerHooks['useCustomerMe'];
     useCustomerLogin: CustomerHooks['useCustomerLogin'];
     useCustomerRegister: CustomerHooks['useCustomerRegister'];
@@ -226,6 +309,26 @@ declare class QueryHooks<TCollection extends ServerCollection = PublicCollection
         pages?: number;
         staleTime?: number;
     }): Promise<void>;
+    useProductListingPage<TData = ProductListingPageResult<ProductListingGroupsCatalogItem>>(params?: ProductListingPageCatalogParams, options?: QueryOptions<ProductListingPageResult<ProductListingGroupsCatalogItem>, TData>): UseQueryResult<TData>;
+    useProductListingPage<TData = ProductListingPageResult<ProductListingGroupsItem>>(params: ProductListingPageFullParams, options?: QueryOptions<ProductListingPageResult<ProductListingGroupsItem>, TData>): UseQueryResult<TData>;
+    useProductListingPage<TData = ProductListingPageResult<ProductListingGroupsCatalogItem> | ProductListingPageResult<ProductListingGroupsItem>>(params: ProductListingPageParams, options?: QueryOptions<ProductListingPageResult<ProductListingGroupsCatalogItem> | ProductListingPageResult<ProductListingGroupsItem>, TData>): UseQueryResult<TData>;
+    useSuspenseProductListingPage<TData = ProductListingPageResult<ProductListingGroupsCatalogItem>>(params?: ProductListingPageCatalogParams, options?: SuspenseQueryOptions<ProductListingPageResult<ProductListingGroupsCatalogItem>, TData>): UseSuspenseQueryResult<TData>;
+    useSuspenseProductListingPage<TData = ProductListingPageResult<ProductListingGroupsItem>>(params: ProductListingPageFullParams, options?: SuspenseQueryOptions<ProductListingPageResult<ProductListingGroupsItem>, TData>): UseSuspenseQueryResult<TData>;
+    useSuspenseProductListingPage<TData = ProductListingPageResult<ProductListingGroupsCatalogItem> | ProductListingPageResult<ProductListingGroupsItem>>(params: ProductListingPageParams, options?: SuspenseQueryOptions<ProductListingPageResult<ProductListingGroupsCatalogItem> | ProductListingPageResult<ProductListingGroupsItem>, TData>): UseSuspenseQueryResult<TData>;
+    useInfiniteProductListingPage<TData = InfiniteData<ProductListingPageResult<ProductListingGroupsCatalogItem | ProductListingGroupsItem>>>(params?: ProductListingPageInfiniteParams, options?: InfiniteQueryOptions<ProductListingPageResult<ProductListingGroupsCatalogItem | ProductListingGroupsItem>, TData>): UseInfiniteQueryResult<TData>;
+    prefetchProductListingPage(params?: ProductListingPageCatalogParams, options?: {
+        staleTime?: number;
+    }): Promise<void>;
+    prefetchProductListingPage(params: ProductListingPageFullParams, options?: {
+        staleTime?: number;
+    }): Promise<void>;
+    prefetchProductListingPage(params: ProductListingPageParams, options?: {
+        staleTime?: number;
+    }): Promise<void>;
+    prefetchInfiniteProductListingPage(params?: ProductListingPageInfiniteParams, options?: {
+        pages?: number;
+        staleTime?: number;
+    }): Promise<void>;
     useProductDetail(params: {
         slug: string;
     } | {
@@ -235,6 +338,18 @@ declare class QueryHooks<TCollection extends ServerCollection = PublicCollection
     useProductDetailById(id: string, options?: QueryOptions<ProductDetailResult>): UseQueryResult<ProductDetailResult>;
 }
 
+type ProductListingPageKeyParams = {
+    mode: 'catalog' | 'full';
+    page?: number;
+    limit?: number;
+    search?: string;
+    sort?: ProductListingPageParams['sort'];
+    filters?: NonNullable<ProductListingPageParams['filters']>;
+    basePath?: string;
+    trailingSlash?: boolean;
+    emit?: ProductListingPageParams['emit'];
+    preferCompleteVariantFromHint?: ProductListingPageParams['preferCompleteVariantFromHint'];
+};
 declare function collectionKeys<T extends ServerCollection>(collection: T): {
     all: readonly [T];
     lists: () => readonly [T, "list"];
@@ -242,7 +357,7 @@ declare function collectionKeys<T extends ServerCollection>(collection: T): {
     details: () => readonly [T, "detail"];
     detail: (id: string, options?: ApiQueryOptions) => readonly [T, "detail", string, ApiQueryOptions | undefined];
     infinites: () => readonly [T, "infinite"];
-    infinite: (options?: Omit<ApiQueryOptions, "page">) => readonly [T, "infinite", Omit<ApiQueryOptions, "page"> | undefined];
+    infinite: (options?: Omit<ApiQueryOptions, "page">, pageSize?: number) => readonly [T, "infinite", Omit<ApiQueryOptions, "page"> | undefined];
 };
 declare const customerKeys: {
     all: readonly ["customer"];
@@ -251,8 +366,18 @@ 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];
+    listingGroupsInfinite: (options?: Omit<ProductListingGroupsQueryOptions, "page" | "limit">, pageSize?: number) => readonly ["products", "listing-groups", "infinite", Omit<ProductListingGroupsQueryOptions, "page" | "limit"> | {
+        limit: number;
+        sort?: Sort;
+        where?: Where;
+    } | undefined];
+    listingGroupsCatalogInfinite: (options?: Omit<ProductListingGroupsQueryOptions, "page" | "limit">, pageSize?: number) => readonly ["products", "listing-groups", "catalog", "infinite", Omit<ProductListingGroupsQueryOptions, "page" | "limit"> | {
+        limit: number;
+        sort?: Sort;
+        where?: Where;
+    } | undefined];
+    listingPage: (params?: ProductListingPageParams) => readonly ["products", "listing-page", ProductListingPageKeyParams];
+    listingPageInfinite: (params?: Omit<ProductListingPageParams, "page" | "limit">, pageSize?: number) => readonly ["products", "listing-page", "infinite", ProductListingPageKeyParams];
     detail: (params: {
         slug: string;
     } | {
@@ -268,4 +393,4 @@ declare const productKeys: {
 declare function createQueryHooks(client: RootClient, queryClient?: QueryClient): ReadOnlyQueryHooks;
 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, getStorefrontQueryClient, productKeys };
+export { type CollectionDetailQueryParams, CollectionHooks, type CollectionInfiniteQueryParams, type CollectionQueryParams, CustomerHooks, type InfiniteQueryOptions, type ProductListingGroupsQueryOptions, type ProductListingPageCatalogInfiniteParams, type ProductListingPageInfiniteParams, QueryHooks, type QueryOptions, type ReadOnlyQueryHooks, type SuspenseInfiniteQueryOptions, type SuspenseQueryOptions, collectionKeys, createQueryHooks, createServerQueryHooks, customerKeys, getQueryClient, getStorefrontQueryClient, prefetchInfiniteProductListingPage, prefetchProductListingPage, productKeys, productListingPageInfiniteQueryOptions, productListingPageQueryOptions };