@behio/storefront-sdk 0.2.0 → 0.3.0

package/dist/react.mjs

@@ -1,6 +1,6 @@
 import {
   BehioStorefront
-} from "./chunk-EFFPOXWL.mjs";
+} from "./chunk-45FTJKSW.mjs";
 
 // src/react/provider.tsx
 import { useRef, useEffect, useMemo } from "react";
@@ -720,13 +720,77 @@ function useAddresses(options) {
   };
 }
 
+// src/react/hooks/use-address-autocomplete.ts
+import { useState as useState3, useEffect as useEffect3, useRef as useRef2, useCallback as useCallback6 } from "react";
+import { useQuery as useQuery12 } from "@tanstack/react-query";
+var AC_KEY = ["behio", "address-autocomplete"];
+function useAddressAutocomplete(options) {
+  const { country, debounce = 300, minChars = 3, enabled = true } = options;
+  const { client } = useBehio();
+  const [query, setQuery] = useState3("");
+  const [debouncedQuery, setDebouncedQuery] = useState3("");
+  const [selected, setSelected] = useState3(null);
+  const [isSelecting, setIsSelecting] = useState3(false);
+  const timerRef = useRef2(void 0);
+  useEffect3(() => {
+    if (timerRef.current) clearTimeout(timerRef.current);
+    if (query.length < minChars) {
+      setDebouncedQuery("");
+      return;
+    }
+    timerRef.current = setTimeout(() => {
+      setDebouncedQuery(query);
+    }, debounce);
+    return () => {
+      if (timerRef.current) clearTimeout(timerRef.current);
+    };
+  }, [query, debounce, minChars]);
+  const { data, isLoading } = useQuery12({
+    queryKey: [...AC_KEY, debouncedQuery, country],
+    queryFn: () => client.addresses.autocomplete(debouncedQuery, country),
+    enabled: enabled && debouncedQuery.length >= minChars,
+    staleTime: 6e4
+    // Cache suggestions for 1 min
+  });
+  const select = useCallback6(
+    async (placeId) => {
+      setIsSelecting(true);
+      try {
+        const detail = await client.addresses.getDetail(placeId);
+        setSelected(detail);
+        setQuery(detail.formattedAddress);
+        setDebouncedQuery("");
+        return detail;
+      } finally {
+        setIsSelecting(false);
+      }
+    },
+    [client]
+  );
+  const clear = useCallback6(() => {
+    setQuery("");
+    setDebouncedQuery("");
+    setSelected(null);
+  }, []);
+  return {
+    query,
+    setQuery,
+    suggestions: data?.suggestions ?? [],
+    isLoading: isLoading && debouncedQuery.length >= minChars,
+    select,
+    selected,
+    isSelecting,
+    clear
+  };
+}
+
 // src/react/hooks/use-orders.ts
-import { useCallback as useCallback6, useMemo as useMemo3, useState as useState3 } from "react";
+import { useCallback as useCallback7, useMemo as useMemo3, useState as useState4 } from "react";
 import { useInfiniteQuery as useInfiniteQuery2 } from "@tanstack/react-query";
 function useOrders(options) {
   const { client } = useBehio();
   const { page: initialPage, limit, enabled } = options ?? {};
-  const [page, setPage] = useState3(initialPage ?? 1);
+  const [page, setPage] = useState4(initialPage ?? 1);
   const infinite = useInfiniteQuery2({
     queryKey: ["behio", "orders", limit, page],
     queryFn: ({ pageParam }) => client.orders.list({ limit, page: pageParam }),
@@ -740,13 +804,13 @@ function useOrders(options) {
     [infinite.data]
   );
   const lastPage = infinite.data?.pages[infinite.data.pages.length - 1];
-  const loadMore = useCallback6(() => {
+  const loadMore = useCallback7(() => {
     if (infinite.hasNextPage && !infinite.isFetchingNextPage) {
       return infinite.fetchNextPage();
     }
     return Promise.resolve();
   }, [infinite]);
-  const goToPage = useCallback6((newPage) => {
+  const goToPage = useCallback7((newPage) => {
     setPage(newPage);
   }, []);
   return {
@@ -772,16 +836,16 @@ function useOrders(options) {
 }
 
 // src/react/hooks/use-order.ts
-import { useCallback as useCallback7 } from "react";
-import { useQuery as useQuery12, useMutation as useMutation5, useQueryClient as useQueryClient6 } from "@tanstack/react-query";
+import { useCallback as useCallback8 } from "react";
+import { useQuery as useQuery13, useMutation as useMutation5, useQueryClient as useQueryClient7 } from "@tanstack/react-query";
 function useOrder(orderNumber, options) {
   const { client } = useBehio();
-  const queryClient = useQueryClient6();
+  const queryClient = useQueryClient7();
   const {
     data,
     isLoading,
     error
-  } = useQuery12({
+  } = useQuery13({
     queryKey: ["behio", "order", orderNumber],
     queryFn: () => client.orders.get(orderNumber),
     enabled: options?.enabled !== false && !!orderNumber && !!client.getAccessToken()
@@ -793,7 +857,7 @@ function useOrder(orderNumber, options) {
       queryClient.invalidateQueries({ queryKey: ["behio", "orders"] });
     }
   });
-  const cancel = useCallback7(
+  const cancel = useCallback8(
     () => cancelMutation.mutateAsync(),
     [cancelMutation]
   );
@@ -807,12 +871,12 @@ function useOrder(orderNumber, options) {
 }
 
 // src/react/hooks/use-checkout.ts
-import { useState as useState4, useCallback as useCallback8 } from "react";
-import { useMutation as useMutation6, useQueryClient as useQueryClient7 } from "@tanstack/react-query";
+import { useState as useState5, useCallback as useCallback9 } from "react";
+import { useMutation as useMutation6, useQueryClient as useQueryClient8 } from "@tanstack/react-query";
 function useCheckout() {
   const { client, storage } = useBehio();
-  const queryClient = useQueryClient7();
-  const [order, setOrder] = useState4(null);
+  const queryClient = useQueryClient8();
+  const [order, setOrder] = useState5(null);
   const mutation = useMutation6({
     mutationFn: (input) => client.checkout.createOrder(input),
     onSuccess: (result) => {
@@ -822,11 +886,11 @@ function useCheckout() {
       queryClient.invalidateQueries({ queryKey: ["behio", "orders"] });
     }
   });
-  const createOrder = useCallback8(
+  const createOrder = useCallback9(
     (input) => mutation.mutateAsync(input),
     [mutation]
   );
-  const reset = useCallback8(() => {
+  const reset = useCallback9(() => {
     setOrder(null);
     mutation.reset();
   }, [mutation]);
@@ -840,10 +904,10 @@ function useCheckout() {
 }
 
 // src/react/hooks/use-pages.ts
-import { useQuery as useQuery13 } from "@tanstack/react-query";
+import { useQuery as useQuery14 } from "@tanstack/react-query";
 function usePages(locale, options) {
   const { client } = useBehio();
-  return useQuery13({
+  return useQuery14({
     queryKey: ["behio", "pages", locale],
     queryFn: async () => {
       const result = await client.pages.list(locale);
@@ -854,7 +918,7 @@ function usePages(locale, options) {
 }
 function usePage(slug, locale, options) {
   const { client } = useBehio();
-  return useQuery13({
+  return useQuery14({
     queryKey: ["behio", "page", slug, locale],
     queryFn: () => client.pages.get(slug, locale),
     enabled: options?.enabled !== false && !!slug
@@ -862,10 +926,10 @@ function usePage(slug, locale, options) {
 }
 
 // src/react/hooks/use-shop-info.ts
-import { useQuery as useQuery14 } from "@tanstack/react-query";
+import { useQuery as useQuery15 } from "@tanstack/react-query";
 function useShopInfo(options) {
   const { client } = useBehio();
-  return useQuery14({
+  return useQuery15({
     queryKey: ["behio", "shop-info"],
     queryFn: () => client.getShopInfo(),
     enabled: options?.enabled !== false
@@ -873,11 +937,11 @@ function useShopInfo(options) {
 }
 
 // src/react/hooks/use-shop-seo.ts
-import { useQuery as useQuery15 } from "@tanstack/react-query";
+import { useQuery as useQuery16 } from "@tanstack/react-query";
 function useShopSeo(options) {
   const { client } = useBehio();
   const { locale, initialData, enabled = true } = options ?? {};
-  return useQuery15({
+  return useQuery16({
     queryKey: ["behio", "shop-seo", locale ?? "_default"],
     queryFn: () => client.getShopSeo(locale),
     initialData,
@@ -886,10 +950,10 @@ function useShopSeo(options) {
 }
 
 // src/react/hooks/use-bundles.ts
-import { useQuery as useQuery16 } from "@tanstack/react-query";
+import { useQuery as useQuery17 } from "@tanstack/react-query";
 function useBundles(options) {
   const { client } = useBehio();
-  return useQuery16({
+  return useQuery17({
     queryKey: ["behio", "bundles"],
     queryFn: () => client.catalog.getBundles(),
     enabled: options?.enabled ?? true,
@@ -898,7 +962,7 @@ function useBundles(options) {
 }
 function useBundle(slug, options) {
   const { client } = useBehio();
-  return useQuery16({
+  return useQuery17({
     queryKey: ["behio", "bundle", slug],
     queryFn: () => client.catalog.getBundle(slug),
     enabled: Boolean(slug) && (options?.enabled ?? true),
@@ -907,10 +971,10 @@ function useBundle(slug, options) {
 }
 
 // src/react/hooks/use-cross-sell.ts
-import { useQuery as useQuery17 } from "@tanstack/react-query";
+import { useQuery as useQuery18 } from "@tanstack/react-query";
 function useCrossSell(productSlug, options) {
   const { client } = useBehio();
-  return useQuery17({
+  return useQuery18({
     queryKey: ["behio", "cross-sell", productSlug],
     queryFn: () => client.catalog.getCrossSell(productSlug),
     enabled: Boolean(productSlug) && (options?.enabled ?? true),
@@ -919,10 +983,10 @@ function useCrossSell(productSlug, options) {
 }
 
 // src/react/hooks/use-product-promotions.ts
-import { useQuery as useQuery18 } from "@tanstack/react-query";
+import { useQuery as useQuery19 } from "@tanstack/react-query";
 function useProductPromotions(productSlug, options) {
   const { client } = useBehio();
-  return useQuery18({
+  return useQuery19({
     queryKey: ["behio", "product-promotions", productSlug],
     queryFn: () => client.catalog.getProductPromotions(productSlug),
     enabled: Boolean(productSlug) && (options?.enabled ?? true),
@@ -931,11 +995,11 @@ function useProductPromotions(productSlug, options) {
 }
 
 // src/react/hooks/use-gift-card.ts
-import { useQuery as useQuery19 } from "@tanstack/react-query";
+import { useQuery as useQuery20 } from "@tanstack/react-query";
 function useGiftCardBalance(code, options) {
   const { client } = useBehio();
   const trimmed = code?.trim();
-  return useQuery19({
+  return useQuery20({
     queryKey: ["behio", "gift-card-balance", trimmed],
     queryFn: () => client.catalog.checkGiftCard(trimmed),
     enabled: Boolean(trimmed && trimmed.length >= 6) && (options?.enabled ?? true)
@@ -943,11 +1007,11 @@ function useGiftCardBalance(code, options) {
 }
 
 // src/react/hooks/use-wishlist.ts
-import { useQuery as useQuery20, useMutation as useMutation7, useQueryClient as useQueryClient8 } from "@tanstack/react-query";
+import { useQuery as useQuery21, useMutation as useMutation7, useQueryClient as useQueryClient9 } from "@tanstack/react-query";
 function useWishlist(options) {
   const { client } = useBehio();
-  const qc = useQueryClient8();
-  const query = useQuery20({
+  const qc = useQueryClient9();
+  const query = useQuery21({
     queryKey: ["behio", "wishlist"],
     queryFn: () => client.wishlist.get(),
     enabled: options?.enabled ?? true
@@ -970,7 +1034,7 @@ function useWishlist(options) {
 }
 function useIsInWishlist(productId) {
   const { client } = useBehio();
-  return useQuery20({
+  return useQuery21({
     queryKey: ["behio", "wishlist-check", productId],
     queryFn: () => client.wishlist.isInWishlist(productId),
     enabled: Boolean(productId)
@@ -978,10 +1042,10 @@ function useIsInWishlist(productId) {
 }
 
 // src/react/hooks/use-reviews.ts
-import { useQuery as useQuery21, useMutation as useMutation8, useQueryClient as useQueryClient9 } from "@tanstack/react-query";
+import { useQuery as useQuery22, useMutation as useMutation8, useQueryClient as useQueryClient10 } from "@tanstack/react-query";
 function useProductReviews(productId, options) {
   const { client } = useBehio();
-  return useQuery21({
+  return useQuery22({
     queryKey: ["behio", "reviews", productId, options?.page ?? 1],
     queryFn: () => client.reviews.getProductReviews(productId, options?.page, options?.limit),
     enabled: Boolean(productId) && (options?.enabled ?? true)
@@ -989,7 +1053,7 @@ function useProductReviews(productId, options) {
 }
 function useSubmitReview() {
   const { client } = useBehio();
-  const qc = useQueryClient9();
+  const qc = useQueryClient10();
   return useMutation8({
     mutationFn: (input) => client.reviews.submit(input),
     onSuccess: (_, input) => qc.invalidateQueries({ queryKey: ["behio", "reviews", input.productId] })
@@ -997,7 +1061,7 @@ function useSubmitReview() {
 }
 
 // src/react/hooks/use-returns.ts
-import { useQuery as useQuery22, useMutation as useMutation9 } from "@tanstack/react-query";
+import { useQuery as useQuery23, useMutation as useMutation9 } from "@tanstack/react-query";
 function useSubmitReturn() {
   const { client } = useBehio();
   return useMutation9({
@@ -1006,7 +1070,7 @@ function useSubmitReturn() {
 }
 function useReturnStatus(returnId, email) {
   const { client } = useBehio();
-  return useQuery22({
+  return useQuery23({
     queryKey: ["behio", "return-status", returnId],
     queryFn: () => client.returns.getStatus(returnId, email),
     enabled: Boolean(returnId && email)
@@ -1014,11 +1078,11 @@ function useReturnStatus(returnId, email) {
 }
 
 // src/react/hooks/use-consent.ts
-import { useQuery as useQuery23, useMutation as useMutation10, useQueryClient as useQueryClient10 } from "@tanstack/react-query";
+import { useQuery as useQuery24, useMutation as useMutation10, useQueryClient as useQueryClient11 } from "@tanstack/react-query";
 function useCookieConsent(visitorId) {
   const { client } = useBehio();
-  const qc = useQueryClient10();
-  const query = useQuery23({
+  const qc = useQueryClient11();
+  const query = useQuery24({
     queryKey: ["behio", "consent", visitorId],
     queryFn: () => client.consent.get(visitorId),
     enabled: Boolean(visitorId)
@@ -1039,7 +1103,7 @@ function useCookieConsent(visitorId) {
 }
 
 // src/react/hooks/use-quotes.ts
-import { useMutation as useMutation11, useQuery as useQuery24 } from "@tanstack/react-query";
+import { useMutation as useMutation11, useQuery as useQuery25 } from "@tanstack/react-query";
 function useSubmitQuote() {
   const { client } = useBehio();
   return useMutation11({
@@ -1048,7 +1112,7 @@ function useSubmitQuote() {
 }
 function useQuoteStatus(quoteId) {
   const { client } = useBehio();
-  return useQuery24({
+  return useQuery25({
     queryKey: ["behio", "quote-status", quoteId],
     queryFn: () => client.quotes.getStatus(quoteId),
     enabled: Boolean(quoteId)
@@ -1082,6 +1146,7 @@ export {
   formatPrice,
   localStorageAdapter,
   memoryStorage,
+  useAddressAutocomplete,
   useAddresses,
   useAuth,
   useBehio,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@behio/storefront-sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "TypeScript SDK for Behio Headless E-Shop — core client + React hooks",
   "author": "Behio",
   "license": "MIT",