@01.software/sdk 0.33.0 → 0.35.0

package/dist/query.cjs

@@ -29,6 +29,7 @@ __export(query_exports, {
   createServerQueryHooks: () => createServerQueryHooks,
   customerKeys: () => customerKeys,
   getQueryClient: () => getQueryClient,
+  getStorefrontQueryClient: () => getStorefrontQueryClient,
   productKeys: () => productKeys
 });
 module.exports = __toCommonJS(query_exports);
@@ -53,6 +54,7 @@ function makeQueryClient() {
   });
 }
 var browserQueryClient;
+var browserStorefrontQueryClient;
 function getQueryClient() {
   if (import_react_query.isServer) {
     return makeQueryClient();
@@ -62,6 +64,30 @@ function getQueryClient() {
   }
   return browserQueryClient;
 }
+var STOREFRONT_STALE_TIME_MS = 6e4;
+function makeStorefrontQueryClient() {
+  return new import_react_query.QueryClient({
+    defaultOptions: {
+      queries: {
+        staleTime: STOREFRONT_STALE_TIME_MS,
+        refetchOnWindowFocus: false
+      },
+      dehydrate: {
+        shouldDehydrateQuery: (query) => (0, import_react_query.defaultShouldDehydrateQuery)(query) || query.state.status === "pending",
+        shouldRedactErrors: () => false
+      }
+    }
+  });
+}
+function getStorefrontQueryClient() {
+  if (import_react_query.isServer) {
+    return makeStorefrontQueryClient();
+  }
+  if (!browserStorefrontQueryClient) {
+    browserStorefrontQueryClient = makeStorefrontQueryClient();
+  }
+  return browserStorefrontQueryClient;
+}
 
 // src/core/query/query-keys.ts
 function collectionKeys(collection) {
@@ -81,7 +107,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"]
 };
@@ -341,7 +369,7 @@ var CollectionHooks = class {
 // src/core/query/customer-hooks.ts
 var import_react_query3 = require("@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);
@@ -597,6 +625,42 @@ var CustomerHooks = class {
 
 // src/core/query/query-hooks.ts
 var import_react_query4 = require("@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);
@@ -622,9 +686,21 @@ var QueryHooks = class extends CollectionHooks {
     const { placeholderData, ...restOptions } = options ?? {};
     return (0, import_react_query4.useQuery)({
       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 (0, import_react_query4.useQuery)({
+      queryKey: productKeys.listingGroupsCatalog(queryOptions),
+      queryFn: async () => fetchProductListingGroupsCatalogQuery(
+        this.collectionClient,
+        queryOptions
       ),
       ...restOptions,
       ...placeholderData !== void 0 && {
@@ -636,9 +712,17 @@ var QueryHooks = class extends CollectionHooks {
     const queryOptions = params.options;
     return (0, import_react_query4.useSuspenseQuery)({
       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 (0, import_react_query4.useSuspenseQuery)({
+      queryKey: productKeys.listingGroupsCatalog(queryOptions),
+      queryFn: async () => fetchProductListingGroupsCatalogQuery(
+        this.collectionClient,
+        queryOptions
       ),
       ...options
     });
@@ -650,12 +734,28 @@ var QueryHooks = class extends CollectionHooks {
     } = params;
     return (0, import_react_query4.useInfiniteQuery)({
       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 (0, import_react_query4.useInfiniteQuery)({
+      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
@@ -668,12 +768,28 @@ var QueryHooks = class extends CollectionHooks {
     } = params;
     return (0, import_react_query4.useSuspenseInfiniteQuery)({
       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 (0, import_react_query4.useSuspenseInfiniteQuery)({
+      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
@@ -683,9 +799,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
     });
@@ -697,12 +821,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,
@@ -711,11 +852,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 (0, import_react_query4.useQuery)({
       queryKey: productKeys.detail(params),
       queryFn: () => this._commerce.product.detail(params),
-      enabled
+      enabled: queryEnabled,
+      ...restOptions
     });
   }
   useProductDetailBySlug(slug, options) {
@@ -1097,9 +1240,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;
@@ -1292,15 +1438,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))
   };
@@ -1408,8 +1557,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);
@@ -1421,8 +1570,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.`,
@@ -1655,6 +1804,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}