@behio/storefront-sdk 0.1.5 → 0.1.7

package/README.md

@@ -121,7 +121,6 @@ export function Providers({ children }: { children: React.ReactNode }) {
   return (
     <BehioProvider
       apiKey={process.env.NEXT_PUBLIC_BEHIO_API_KEY!}  // e.g. "pk_live_6d3f255..."
-      baseUrl={process.env.NEXT_PUBLIC_BEHIO_API_URL}  // optional — defaults to https://api.behio.com
       locale="cs"
       currency="CZK"
       storage="cookies"       // "cookies" | "localStorage" | "memory"
@@ -154,19 +153,9 @@ Set your env variables:
 ```bash
 # .env.local
 NEXT_PUBLIC_BEHIO_API_KEY=pk_live_xxxxxxxxxxxx
-NEXT_PUBLIC_BEHIO_API_URL=https://api.behio.com       # production
-# NEXT_PUBLIC_BEHIO_API_URL=http://localhost:7007     # local dev
 
 # For server-side (Server Actions, RSC) — NEVER expose to client
 BEHIO_API_KEY=sk_live_xxxxxxxxxxxx
-BEHIO_API_URL=https://api.behio.com
-```
-
-**Optional:** Hide the backend URL behind a proxy. Add a Next.js rewrite in `next.config.ts` and set `baseUrl="/api"`:
-```typescript
-async rewrites() {
-  return [{ source: '/api/:path*', destination: 'https://api.behio.com/:path*' }];
-}
 ```
 
 ## 2. Fetch data with hooks
@@ -212,7 +201,6 @@ export default async function ProductPage({ params }: { params: Promise<{ slug:
   const { slug } = await params;
   const shop = new BehioStorefront({
     apiKey: process.env.BEHIO_API_KEY!,
-    baseUrl: process.env.BEHIO_API_URL,
   });
   const initialData = await shop.catalog.getProduct(slug);
   return <ProductDetail slug={slug} initialData={initialData} />;
@@ -361,7 +349,6 @@ import { BehioStorefront } from '@behio/storefront-sdk';
 export default async function ProductsPage() {
   const shop = new BehioStorefront({
     apiKey: process.env.BEHIO_API_KEY!,         // ← private, server-only
-    baseUrl: process.env.BEHIO_API_URL,
   });
 
   const products = await shop.catalog.getProducts({ limit: 24 });
@@ -390,7 +377,6 @@ import { cookies } from 'next/headers';
 function getShop() {
   return new BehioStorefront({
     apiKey: process.env.BEHIO_API_KEY!,
-    baseUrl: process.env.BEHIO_API_URL,
   });
 }
 
@@ -466,7 +452,6 @@ import { BehioStorefront } from '@behio/storefront-sdk';
 
 const shop = new BehioStorefront({
   apiKey: 'pk_live_xxx',
-  baseUrl: 'https://api.behio.com',  // optional
   locale: 'cs',                       // optional
   currency: 'CZK',                    // optional
   timeout: 30000,                     // optional — request timeout (ms)
@@ -480,7 +465,12 @@ Every API method returns a Promise. Types are fully auto-completed.
 
 ```typescript
 // Catalog
-const products = await shop.catalog.getProducts({ limit: 20, sort: 'newest' });
+const products = await shop.catalog.getProducts({
+  limit: 20,
+  sort: 'newest',
+  categories: ['electronics', 'books'], // array filters sent as repeated query params
+  hasDiscount: true,
+});
 const product = await shop.catalog.getProduct('my-product-slug');
 const { categories } = await shop.catalog.getCategories();
 
@@ -545,20 +535,80 @@ const { data, isLoading, error } = useShopInfo();
 ```
 
 ### useProducts
+
+Supports **both** traditional pagination and infinite scroll from one hook.
+
 ```typescript
-const { data, isLoading, error } = useProducts({
+const {
+  items,          // flat array (all pages merged) — for infinite scroll
+  data,           // PaginatedResponse (current page) — for traditional pagination
+  total, totalPages, currentPage, limit,
+
+  // Traditional pagination
+  page, setPage,
+
+  // Infinite scroll
+  loadMore, hasMore, isLoadingMore,
+
+  // State
+  isLoading, isFetching, error, isError, refetch,
+} = useProducts({
   page: 1,
   limit: 24,
-  category: 'electronics',
-  label: 'new',
+
+  // Scalar filters
+  category: 'electronics',        // single category slug
+  label: 'new',                   // single label slug
   priceMin: 100,
   priceMax: 5000,
-  sort: 'price_asc',
+  currency: 'CZK',
+  locale: 'cs',
+  sort: 'price_asc',              // or ProductSort.PRICE_ASC
   inStock: true,
   search: 'keyboard',
   customFields: { material: 'aluminum' },
+
+  // Array filters — sent as repeated query params (?ids=a&ids=b)
+  ids: ['prod_1', 'prod_2'],            // filter to specific IDs
+  slugs: ['red-shoes', 'blue-hat'],     // filter to specific slugs
+  categories: ['electronics', 'books'], // OR logic (in ANY of these)
+  labels: ['sale', 'new'],              // AND logic (must have ALL)
+  excludeIds: ['prod_999'],             // exclude specific IDs (e.g. related products)
+  excludeCategories: ['archive'],       // exclude products in these categories
+
+  // Boolean / time filters
+  hasDiscount: true,                    // only products with compareAtPrice
+  isFeatured: true,                     // only featured products
+  createdAfter: Date.now() - 7 * 864e5, // created in last 7 days (epoch ms)
+
+  // Hook options
+  enabled: true,                        // skip fetch until true
+  initialData: prefetchedData,          // SSR hydration
 });
-// data: PaginatedResponse<ProductListItem>
+```
+
+**Infinite scroll example:**
+```tsx
+const { items, loadMore, hasMore, isLoadingMore } = useProducts({ limit: 24 });
+
+return (
+  <>
+    {items.map(p => <ProductCard key={p.id} product={p} />)}
+    {hasMore && <button onClick={loadMore} disabled={isLoadingMore}>Load more</button>}
+  </>
+);
+```
+
+**Traditional pagination example:**
+```tsx
+const { data, page, setPage, totalPages } = useProducts({ limit: 24 });
+
+return (
+  <>
+    {data?.items.map(p => <ProductCard key={p.id} product={p} />)}
+    <Pagination page={page} total={totalPages} onChange={setPage} />
+  </>
+);
 ```
 
 ### useProduct

package/package.json

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