@behio/storefront-sdk 0.1.5 → 0.1.6

package/README.md

@@ -480,7 +480,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 +550,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.6",
   "description": "TypeScript SDK for Behio Headless E-Shop — core client + React hooks",
   "author": "Behio",
   "license": "MIT",