@mohasinac/appkit 2.3.1 → 2.4.0

package/dist/features/products/components/ProductsIndexListing.js

@@ -1,27 +1,177 @@
 "use client";
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useState, useCallback, useMemo } from "react";
+import { X, ShoppingCart, Heart, SlidersHorizontal } from "lucide-react";
+import { useRouter } from "next/navigation";
 import { useUrlTable } from "../../../react/hooks/useUrlTable";
 import { useProducts } from "../hooks/useProducts";
-import { Div, Input, Pagination, SortDropdown, SlottedListingView, } from "../../../ui";
+import { Pagination, useToast, BulkActionsBar, ListingToolbar } from "../../../ui";
 import { ROUTES } from "../../../next";
-import { ProductGrid, ProductFilters } from ".";
+import { ProductGrid, ProductFilters, PRODUCT_PUBLIC_SORT_OPTIONS } from ".";
+import { useGuestCart } from "../../cart/hooks/useGuestCart";
+import { useGuestWishlist } from "../../wishlist/hooks/useGuestWishlist";
+import { pushCartOp, pushWishlistOp } from "../../cart/utils/pending-ops";
+import { useBulkSelection } from "../../../react/hooks/useBulkSelection";
+import { useCategoryTree, categoriesToFacetOptions } from "../../categories/hooks/useCategoryTree";
+const FILTER_KEYS = ["category", "condition", "minPrice", "maxPrice", "brand", "storeId", "freeShipping", "tags"];
 export function ProductsIndexListing({ initialData }) {
+    const router = useRouter();
     const table = useUrlTable({ defaults: { pageSize: "24", sort: "-createdAt" } });
+    const { showToast } = useToast();
+    const [searchInput, setSearchInput] = useState(table.get("q") || "");
+    const [filterOpen, setFilterOpen] = useState(false);
+    const showSold = table.get("showSold") === "true";
+    const [view, setView] = useState(table.get("view") || "card");
+    // Pending filter state — buffered until "Apply Filters" clicked
+    const [pendingFilters, setPendingFilters] = useState(() => Object.fromEntries(FILTER_KEYS.map((k) => [k, table.get(k)])));
+    const pendingTable = useMemo(() => ({
+        get: (key) => pendingFilters[key] ?? "",
+        getNumber: (key, fallback = 0) => {
+            const v = pendingFilters[key];
+            if (!v)
+                return fallback;
+            const n = Number(v);
+            return isNaN(n) ? fallback : n;
+        },
+        set: (key, value) => setPendingFilters((p) => ({ ...p, [key]: value })),
+        setMany: (updates) => setPendingFilters((p) => ({ ...p, ...updates })),
+        clear: (keys) => {
+            const ks = keys ?? FILTER_KEYS;
+            setPendingFilters((p) => ({
+                ...p,
+                ...Object.fromEntries(ks.map((k) => [k, ""])),
+            }));
+        },
+        setPage: (_) => { },
+        setPageSize: (_) => { },
+        setSort: (_) => { },
+        buildSieveParams: () => "",
+        buildSearchParams: () => "",
+        params: new URLSearchParams(),
+    }), [pendingFilters]);
+    const openFilters = useCallback(() => {
+        // Sync pending state from current URL when drawer opens
+        setPendingFilters(Object.fromEntries(FILTER_KEYS.map((k) => [k, table.get(k)])));
+        setFilterOpen(true);
+    }, [table]);
+    const applyFilters = useCallback(() => {
+        const updates = { page: "1" };
+        for (const k of FILTER_KEYS)
+            updates[k] = pendingFilters[k] ?? "";
+        table.setMany(updates);
+        setFilterOpen(false);
+    }, [pendingFilters, table]);
+    const clearFilters = useCallback(() => {
+        setPendingFilters(Object.fromEntries(FILTER_KEYS.map((k) => [k, ""])));
+    }, []);
+    const resetAll = useCallback(() => {
+        const updates = { q: "", sort: "", showSold: "" };
+        for (const k of FILTER_KEYS)
+            updates[k] = "";
+        table.setMany(updates);
+        setSearchInput("");
+    }, [table]);
+    const activeFilterCount = FILTER_KEYS.filter((k) => !!table.get(k)).length;
+    const hasActiveState = !!table.get("q") ||
+        table.get("showSold") === "true" ||
+        table.get("sort") !== "-createdAt" ||
+        activeFilterCount > 0;
+    const localCart = useGuestCart();
+    const localWishlist = useGuestWishlist();
+    const wishlistedIds = new Set(localWishlist.items.filter((i) => i.type === "product").map((i) => i.itemId));
+    const { categories } = useCategoryTree();
+    const categoryOptions = categoriesToFacetOptions(categories);
     const params = {
         q: table.get("q") || undefined,
         category: table.get("category") || undefined,
         minPrice: table.get("minPrice") ? Number(table.get("minPrice")) : undefined,
         maxPrice: table.get("maxPrice") ? Number(table.get("maxPrice")) : undefined,
         condition: table.get("condition") || undefined,
-        sort: table.get("sort") || undefined,
+        brand: table.get("brand") || undefined,
+        storeId: table.get("storeId") || undefined,
+        freeShipping: table.get("freeShipping") === "true" ? true : undefined,
+        sort: table.get("sort") || "-createdAt",
         page: table.getNumber("page", 1),
         perPage: table.getNumber("pageSize", 24),
         isAuction: false,
+        isPreOrder: false,
+        status: showSold ? undefined : "published",
     };
-    const { products, total, totalPages, page, isLoading } = useProducts(params, { initialData });
-    return (_jsx(Div, { className: "min-h-screen", children: _jsx(SlottedListingView, { portal: "public", manageSearch: true, manageSort: true, inlineToolbar: true, renderSearch: (search, setSearch) => (_jsx(Input, { value: search, onChange: (e) => setSearch(e.target.value), placeholder: "Search products...", className: "max-w-sm" })), renderSort: (value, onChange) => (_jsx(SortDropdown, { value: value, onChange: onChange, options: [
-                    { value: "-createdAt", label: "Newest First" },
-                    { value: "-price", label: "Price: High to Low" },
-                    { value: "price", label: "Price: Low to High" },
-                ] })), renderFilters: () => _jsx(ProductFilters, { table: table }), renderTable: () => (_jsx(ProductGrid, { products: products, getProductHref: (p) => String(ROUTES.PUBLIC.PRODUCT_DETAIL(p.slug || p.id)), view: table.get("view") || "card" })), renderPagination: () => (_jsx(Pagination, { currentPage: page, totalPages: totalPages, onPageChange: (p) => table.setPage(p) })), total: total, isLoading: isLoading }) }));
+    const { products, totalPages, page, isLoading } = useProducts(params, { initialData });
+    const selection = useBulkSelection({ items: products, keyExtractor: (p) => p.id });
+    const commitSearch = useCallback(() => {
+        table.set("q", searchInput.trim());
+        table.setPage(1);
+    }, [searchInput, table]);
+    const handleSearchKeyDown = (e) => {
+        if (e.key === "Enter")
+            commitSearch();
+    };
+    const handleViewToggle = (next) => {
+        setView(next);
+        table.set("view", next);
+    };
+    const handleWishlistToggle = useCallback((productId) => {
+        const isWishlisted = wishlistedIds.has(productId);
+        if (isWishlisted) {
+            localWishlist.remove(productId, "product");
+            pushWishlistOp({ op: "remove", itemId: productId, type: "product" });
+            showToast("Removed from wishlist", "info");
+        }
+        else {
+            localWishlist.add(productId, "product");
+            pushWishlistOp({ op: "add", itemId: productId, type: "product" });
+            showToast("Added to wishlist", "success");
+        }
+    }, [wishlistedIds, localWishlist, showToast]);
+    const handleAddToCart = useCallback((product) => {
+        localCart.add(product.id, 1, {
+            productTitle: product.title,
+            productImage: product.mainImage,
+            price: product.price,
+        });
+        pushCartOp({ op: "add", productId: product.id, quantity: 1, productTitle: product.title, productImage: product.mainImage, price: product.price });
+        showToast("Added to cart", "success");
+    }, [localCart, showToast]);
+    const handleBuyNow = useCallback((product) => {
+        localCart.add(product.id, 1, {
+            productTitle: product.title,
+            productImage: product.mainImage,
+            price: product.price,
+        });
+        pushCartOp({ op: "add", productId: product.id, quantity: 1, productTitle: product.title, productImage: product.mainImage, price: product.price });
+        router.push(String(ROUTES.USER.CART));
+    }, [localCart, router]);
+    return (_jsxs("div", { className: "min-h-screen", children: [_jsx(ListingToolbar, { filterCount: activeFilterCount, onFiltersClick: openFilters, searchValue: searchInput, searchPlaceholder: "Search products...", onSearchChange: setSearchInput, onSearchCommit: commitSearch, onSearchKeyDown: handleSearchKeyDown, sortValue: table.get("sort") || "-createdAt", sortOptions: PRODUCT_PUBLIC_SORT_OPTIONS, onSortChange: (v) => { table.set("sort", v); table.setPage(1); }, view: view === "card" ? "grid" : "list", onViewChange: (v) => handleViewToggle(v === "grid" ? "card" : "list"), onResetAll: resetAll, hasActiveState: hasActiveState, bulkMode: selection.isSelecting, bulkSelectedCount: selection.selectedCount, bulkTotalCount: products.length, onBulkSelectAll: selection.toggleAll, onBulkClear: selection.clearSelection, extra: _jsxs("label", { className: "flex items-center gap-1.5 cursor-pointer select-none shrink-0", children: [_jsx("span", { className: "hidden sm:inline text-xs text-zinc-600 dark:text-zinc-300 whitespace-nowrap", children: "Show sold" }), _jsx("button", { type: "button", role: "switch", "aria-checked": showSold, onClick: () => table.set("showSold", showSold ? "" : "true"), className: `relative inline-flex h-5 w-9 flex-shrink-0 items-center rounded-full transition-colors duration-200 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary focus-visible:ring-offset-1 ${showSold ? "bg-primary" : "bg-zinc-300 dark:bg-slate-600"}`, children: _jsx("span", { className: `inline-block h-3.5 w-3.5 transform rounded-full bg-white shadow-sm transition-transform duration-200 ${showSold ? "translate-x-[19px]" : "translate-x-[3px]"}` }) })] }) }), totalPages > 1 && (_jsx("div", { className: "sticky top-[calc(var(--header-height,0px)+44px)] z-10 flex justify-center bg-white/95 dark:bg-slate-900/95 backdrop-blur-sm border-b border-zinc-200 dark:border-slate-700 px-3 py-1.5", children: _jsx(Pagination, { currentPage: page, totalPages: totalPages, onPageChange: (p) => table.setPage(p) }) })), _jsx("div", { className: "py-6", children: isLoading ? (_jsx("div", { className: "grid grid-cols-2 sm:grid-cols-3 lg:grid-cols-4 gap-4", children: Array.from({ length: 10 }).map((_, i) => (_jsxs("div", { className: "rounded-xl border border-zinc-100 dark:border-slate-700 overflow-hidden animate-pulse", children: [_jsx("div", { className: "aspect-square bg-zinc-200 dark:bg-slate-700" }), _jsxs("div", { className: "p-3 space-y-2", children: [_jsx("div", { className: "h-3 bg-zinc-200 dark:bg-slate-700 rounded w-3/4" }), _jsx("div", { className: "h-3 bg-zinc-200 dark:bg-slate-700 rounded w-1/2" }), _jsx("div", { className: "h-4 bg-zinc-200 dark:bg-slate-700 rounded w-1/3" })] })] }, i))) })) : (_jsx(ProductGrid, { products: products, getProductHref: (p) => String(ROUTES.PUBLIC.PRODUCT_DETAIL(p.slug || p.id)), view: view, onWishlistToggle: handleWishlistToggle, wishlistedIds: wishlistedIds, onAddToCart: handleAddToCart, onBuyNow: handleBuyNow, selectionMode: selection.isSelecting, selectedIds: selection.selectedIdSet, onToggleSelect: selection.toggle })) }), _jsx(BulkActionsBar, { selectedCount: selection.selectedCount, onClearSelection: selection.clearSelection, actions: [
+                    {
+                        key: "cart",
+                        label: "Add to Cart",
+                        icon: _jsx(ShoppingCart, { className: "h-3.5 w-3.5" }),
+                        variant: "primary",
+                        onClick: () => {
+                            const selected = products.filter((p) => selection.selectedIdSet.has(p.id));
+                            selected.forEach((p) => {
+                                localCart.add(p.id, 1, { productTitle: p.title, productImage: p.mainImage, price: p.price });
+                                pushCartOp({ op: "add", productId: p.id, quantity: 1, productTitle: p.title, productImage: p.mainImage, price: p.price });
+                            });
+                            showToast(`${selected.length} items added to cart`, "success");
+                            selection.clearSelection();
+                        },
+                    },
+                    {
+                        key: "wishlist",
+                        label: "Wishlist",
+                        icon: _jsx(Heart, { className: "h-3.5 w-3.5" }),
+                        variant: "secondary",
+                        onClick: () => {
+                            const selected = products.filter((p) => selection.selectedIdSet.has(p.id));
+                            selected.forEach((p) => {
+                                localWishlist.add(p.id, "product");
+                                pushWishlistOp({ op: "add", itemId: p.id, type: "product" });
+                            });
+                            showToast(`${selected.length} items added to wishlist`, "success");
+                            selection.clearSelection();
+                        },
+                    },
+                ] }), filterOpen && (_jsxs(_Fragment, { children: [_jsx("div", { className: "fixed inset-0 z-40 bg-black/40", "aria-hidden": "true", onClick: () => setFilterOpen(false) }), _jsxs("div", { className: "fixed inset-y-0 left-0 z-50 flex w-80 flex-col bg-white dark:bg-slate-900 shadow-2xl", children: [_jsxs("div", { className: "flex items-center justify-between border-b border-zinc-200 dark:border-slate-700 px-4 py-3.5", children: [_jsxs("span", { className: "flex items-center gap-2 text-base font-semibold text-zinc-900 dark:text-zinc-100", children: [_jsx(SlidersHorizontal, { className: "h-4 w-4" }), "Filters"] }), _jsxs("div", { className: "flex items-center gap-2", children: [activeFilterCount > 0 && (_jsx("button", { type: "button", onClick: clearFilters, className: "text-xs text-zinc-500 hover:text-rose-500 dark:text-zinc-400 transition-colors", children: "Clear all" })), _jsx("button", { type: "button", onClick: () => setFilterOpen(false), "aria-label": "Close filters", className: "rounded-lg p-1.5 text-zinc-500 hover:bg-zinc-100 dark:hover:bg-slate-800 transition-colors", children: _jsx(X, { className: "h-5 w-5" }) })] })] }), _jsx("div", { className: "flex-1 overflow-y-auto px-4 py-4", children: _jsx(ProductFilters, { table: pendingTable, currencyPrefix: "\u20B9", categoryOptions: categoryOptions }) }), _jsx("div", { className: "border-t border-zinc-200 dark:border-slate-700 px-4 py-3.5", children: _jsxs("button", { type: "button", onClick: applyFilters, className: "w-full rounded-lg bg-primary py-2.5 text-sm font-semibold text-white hover:bg-primary-600 transition-colors active:scale-[0.98]", children: ["Apply Filters", activeFilterCount > 0 ? ` (${activeFilterCount})` : ""] }) })] })] }))] }));
 }

package/dist/features/products/components/ProductsIndexPageView.d.ts

@@ -1 +1,6 @@
-export declare function ProductsIndexPageView(): Promise<import("react/jsx-runtime").JSX.Element>;
+type SearchParams = Record<string, string | string[]>;
+export interface ProductsIndexPageViewProps {
+    searchParams?: SearchParams;
+}
+export declare function ProductsIndexPageView({ searchParams }: ProductsIndexPageViewProps): Promise<import("react/jsx-runtime").JSX.Element>;
+export {};

package/dist/features/products/components/ProductsIndexPageView.js

@@ -1,17 +1,50 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { productRepository } from "../../../repositories";
+import { ROUTES } from "../../../constants";
 import { Container, Heading, Main, Section } from "../../../ui";
 import { AdSlot } from "../../homepage/components/AdSlot";
 import { ProductsIndexListing } from "./ProductsIndexListing";
-export async function ProductsIndexPageView() {
+function sp(params, key) {
+    const v = params[key];
+    return Array.isArray(v) ? v[0] ?? "" : v ?? "";
+}
+function buildProductFilters(params) {
+    const parts = ["status==published", "isAuction==false"];
+    const condition = sp(params, "condition");
+    if (condition) {
+        const values = condition.split("|").filter(Boolean);
+        if (values.length === 1)
+            parts.push(`condition==${values[0]}`);
+        else if (values.length > 1)
+            parts.push(`condition==${values.join("|")}`);
+    }
+    const minPrice = sp(params, "minPrice");
+    const maxPrice = sp(params, "maxPrice");
+    if (minPrice)
+        parts.push(`price>=${minPrice}`);
+    if (maxPrice)
+        parts.push(`price<=${maxPrice}`);
+    const sellerId = sp(params, "seller");
+    if (sellerId)
+        parts.push(`sellerId==${sellerId}`);
+    const freeShipping = sp(params, "freeShipping");
+    if (freeShipping === "true")
+        parts.push("freeShipping==true");
+    return parts.join(",");
+}
+export async function ProductsIndexPageView({ searchParams = {} }) {
+    const sort = sp(searchParams, "sort") || "-createdAt";
+    const page = Number(sp(searchParams, "page")) || 1;
+    const pageSize = Number(sp(searchParams, "pageSize")) || 24;
+    const filters = buildProductFilters(searchParams);
     const result = await productRepository
         .list({
-        filters: "status==published,isAuction==false",
-        sorts: "-createdAt",
-        page: 1,
-        pageSize: 24,
+        filters,
+        sorts: sort,
+        page,
+        pageSize,
     })
         .catch(() => null);
     const products = result ?? null;
-    return (_jsx(Main, { children: _jsx(Section, { className: "py-10", children: _jsxs(Container, { size: "xl", children: [_jsx(Heading, { level: 1, className: "mb-8 text-3xl font-semibold text-zinc-900", children: "Products" }), _jsx(AdSlot, { id: "listing-sidebar-top", className: "mb-6" }), _jsx(ProductsIndexListing, { initialData: products }), _jsx(AdSlot, { id: "listing-sidebar-bottom", className: "mt-8" })] }) }) }));
+    return (_jsxs(Main, { children: [_jsx(Section, { className: "pt-8 pb-4 border-b border-zinc-100 dark:border-slate-800", children: _jsxs(Container, { size: "xl", children: [_jsx(Heading, { level: 1, className: "text-3xl font-bold text-zinc-900 dark:text-zinc-100", children: "Products" }), _jsx("p", { className: "mt-1 text-sm text-zinc-500 dark:text-zinc-400", children: "Discover amazing products and deals" }), _jsx("div", { className: "mt-3", children: _jsx("a", { href: ROUTES.PUBLIC.AUCTIONS, className: "inline-flex items-center gap-1.5 rounded-full border border-primary/30 bg-primary/10 px-4 py-1.5 text-xs font-medium text-primary-700 dark:text-primary-400 hover:bg-primary/15 transition-colors", children: "\uD83C\uDFF7\uFE0F Looking for unique deals? Browse Auctions \u2192" }) })] }) }), _jsxs(Container, { size: "xl", className: "px-4", children: [_jsx(AdSlot, { id: "listing-sidebar-top", className: "mb-4 mt-4" }), _jsx(ProductsIndexListing, { initialData: products }), _jsx(AdSlot, { id: "listing-sidebar-bottom", className: "mt-8" })] })] }));
 }

package/dist/features/products/components/RelatedProductsCarousel.d.ts

@@ -0,0 +1,7 @@
+import type { ProductItem } from "../types";
+interface RelatedProductsCarouselProps {
+    items: ProductItem[];
+    title?: string;
+}
+export declare function RelatedProductsCarousel({ items, title, }: RelatedProductsCarouselProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/features/products/components/RelatedProductsCarousel.js

@@ -0,0 +1,11 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { ROUTES } from "../../../next";
+import { THEME_CONSTANTS } from "../../../tokens";
+import { SectionCarousel } from "../../homepage/components/SectionCarousel";
+import { ProductCard } from "./ProductGrid";
+export function RelatedProductsCarousel({ items, title = "You might also like", }) {
+    if (items.length === 0)
+        return null;
+    return (_jsx(SectionCarousel, { title: title, pillLabel: "Related Products", headingVariant: "editorial", items: items, isLoading: false, perView: THEME_CONSTANTS.carousel.perView.standard, keyExtractor: (item) => item.id, renderItem: (item) => (_jsx(ProductCard, { product: item, href: item.slug || item.id ? String(ROUTES.PUBLIC.PRODUCT_DETAIL(item.slug || item.id)) : undefined })) }));
+}

package/dist/features/products/components/ShareButton.d.ts

@@ -0,0 +1,7 @@
+interface ShareButtonProps {
+    title?: string;
+    text?: string;
+    className?: string;
+}
+export declare function ShareButton({ title, text, className }: ShareButtonProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/features/products/components/ShareButton.js

@@ -0,0 +1,22 @@
+"use client";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+export function ShareButton({ title, text, className = "" }) {
+    const [copied, setCopied] = useState(false);
+    const handleShare = async () => {
+        const url = window.location.href;
+        if (navigator.share) {
+            try {
+                await navigator.share({ title: title ?? document.title, text, url });
+                return;
+            }
+            catch {
+                // user cancelled or browser blocked — fall through to clipboard
+            }
+        }
+        navigator.clipboard.writeText(url).catch(() => { });
+        setCopied(true);
+        setTimeout(() => setCopied(false), 2000);
+    };
+    return (_jsxs("button", { type: "button", onClick: handleShare, className: `inline-flex items-center gap-1.5 rounded-lg border border-zinc-200 dark:border-zinc-700 px-3 py-1.5 text-sm font-medium text-zinc-700 dark:text-zinc-300 hover:bg-zinc-50 dark:hover:bg-zinc-800 transition-colors ${className}`, "aria-label": "Share this page", children: ["\uD83D\uDD17 ", copied ? "Link Copied!" : "Share"] }));
+}

package/dist/features/products/components/index.d.ts

@@ -30,9 +30,12 @@ export { PlaceBidForm } from "./PlaceBidForm";
 export type { PlaceBidFormProps } from "./PlaceBidForm";
 export { MakeOfferForm } from "./MakeOfferForm";
 export type { MakeOfferFormProps } from "./MakeOfferForm";
+export { MakeOfferButton } from "./MakeOfferButton";
+export type { MakeOfferButtonProps } from "./MakeOfferButton";
 export { RelatedProducts } from "./RelatedProducts";
 export type { RelatedProductsProps } from "./RelatedProducts";
 export { ProductGalleryClient } from "./ProductGalleryClient";
 export type { ProductGalleryClientProps } from "./ProductGalleryClient";
 export { ProductTabsShell } from "./ProductTabsShell";
 export type { ProductTabsShellProps } from "./ProductTabsShell";
+export { RelatedProductsCarousel } from "./RelatedProductsCarousel";

package/dist/features/products/components/index.js

@@ -15,6 +15,8 @@ export { ProductTabs } from "./ProductTabs";
 export { BidHistory } from "./BidHistory";
 export { PlaceBidForm } from "./PlaceBidForm";
 export { MakeOfferForm } from "./MakeOfferForm";
+export { MakeOfferButton } from "./MakeOfferButton";
 export { RelatedProducts } from "./RelatedProducts";
 export { ProductGalleryClient } from "./ProductGalleryClient";
 export { ProductTabsShell } from "./ProductTabsShell";
+export { RelatedProductsCarousel } from "./RelatedProductsCarousel";

package/dist/features/products/hooks/useProducts.d.ts

@@ -2,6 +2,12 @@ import type { ProductItem, ProductListResponse, ProductListParams } from "../typ
 interface UseProductsOptions<T extends ProductItem = ProductItem> {
     initialData?: ProductListResponse;
     enabled?: boolean;
+    /**
+     * How long (ms) React Query considers the data fresh before background-refetching.
+     * Defaults to Infinity when `initialData` is supplied (SSR hydration — no refetch
+     * on mount). Callers can override with a lower value if live data is needed.
+     */
+    staleTime?: number;
     /**
      * Map each API item to a richer app-level type.
      * The API always returns `ProductItem`; use this to project it to your own
@@ -26,6 +32,7 @@ export declare function useProducts<T extends ProductItem = ProductItem>(params?
 interface UseProductOptions<T extends ProductItem = ProductItem> {
     initialData?: ProductItem;
     enabled?: boolean;
+    staleTime?: number;
     /**
      * Map the API item to a richer app-level type.
      * @example

package/dist/features/products/hooks/useProducts.js

@@ -21,8 +21,10 @@ export function useProducts(params = {}, opts) {
         sp.set("inStock", String(params.inStock));
     if (params.isAuction !== undefined)
         sp.set("isAuction", String(params.isAuction));
-    if (params.sellerId)
-        sp.set("sellerId", params.sellerId);
+    if (params.isPreOrder !== undefined)
+        sp.set("isPreOrder", String(params.isPreOrder));
+    if (params.storeId)
+        sp.set("storeId", params.storeId);
     if (params.sort)
         sp.set("sorts", params.sort);
     if (params.page)
@@ -31,11 +33,26 @@ export function useProducts(params = {}, opts) {
         sp.set("pageSize", String(params.perPage));
     if (params.featured !== undefined)
         sp.set("featured", String(params.featured));
+    if (params.minBid !== undefined)
+        sp.set("minBid", String(params.minBid));
+    if (params.maxBid !== undefined)
+        sp.set("maxBid", String(params.maxBid));
+    if (params.dateFrom)
+        sp.set("dateFrom", params.dateFrom);
+    if (params.dateTo)
+        sp.set("dateTo", params.dateTo);
+    if (params.preOrderProductionStatus)
+        sp.set("preOrderProductionStatus", params.preOrderProductionStatus);
+    if (params.brand)
+        sp.set("brand", params.brand);
+    if (params.freeShipping !== undefined)
+        sp.set("freeShipping", String(params.freeShipping));
     const qs = sp.toString();
     const query = useQuery({
         queryKey: ["products", qs],
         queryFn: () => apiClient.get(`${PRODUCT_ENDPOINTS.LIST}${qs ? `?${qs}` : ""}`),
         initialData: opts?.initialData,
+        staleTime: opts?.staleTime ?? (opts?.initialData !== undefined ? Infinity : 0),
         enabled: opts?.enabled,
     });
     const rawItems = query.data?.items ?? [];
@@ -55,6 +72,7 @@ export function useProduct(slug, opts) {
         queryKey: ["products", slug],
         queryFn: () => apiClient.get(PRODUCT_ENDPOINTS.BY_SLUG(slug)),
         initialData: opts?.initialData,
+        staleTime: opts?.staleTime ?? (opts?.initialData !== undefined ? Infinity : 0),
         enabled: opts?.enabled !== false && !!slug,
     });
     const product = query.data && opts?.transform

package/dist/features/products/repository/products.repository.d.ts

@@ -14,7 +14,7 @@ export declare class ProductRepository extends BaseRepository<ProductDocument> {
     protected mapDoc<D = ProductDocument>(snap: DocumentSnapshot): D;
     update(id: string, data: Partial<ProductDocument>): Promise<ProductDocument>;
     create(input: ProductCreateInput): Promise<ProductDocument>;
-    findBySeller(sellerId: string): Promise<ProductDocument[]>;
+    findByStore(storeId: string): Promise<ProductDocument[]>;
     findByStatus(status: ProductStatus): Promise<ProductDocument[]>;
     findFeatured(): Promise<ProductDocument[]>;
     findByCategory(category: string): Promise<ProductDocument[]>;
@@ -29,7 +29,7 @@ export declare class ProductRepository extends BaseRepository<ProductDocument> {
     updateBid(productId: string, bidAmount: number, bidCount: number): Promise<void>;
     findAvailable(): Promise<ProductDocument[]>;
     findActiveAuctions(): Promise<ProductDocument[]>;
-    deleteBySeller(sellerId: string): Promise<number>;
+    deleteByStore(storeId: string): Promise<number>;
     delete(id: string): Promise<void>;
     static readonly SIEVE_FIELDS: {
         id: {
@@ -64,11 +64,11 @@ export declare class ProductRepository extends BaseRepository<ProductDocument> {
             canFilter: boolean;
             canSort: boolean;
         };
-        sellerId: {
+        storeId: {
             canFilter: boolean;
             canSort: boolean;
         };
-        sellerName: {
+        storeName: {
             canFilter: boolean;
             canSort: boolean;
         };
@@ -184,9 +184,13 @@ export declare class ProductRepository extends BaseRepository<ProductDocument> {
             canFilter: boolean;
             canSort: boolean;
         };
+        freeShipping: {
+            canFilter: boolean;
+            canSort: boolean;
+        };
     };
     list(model: SieveModel, opts?: {
-        sellerId?: string;
+        storeId?: string;
         status?: string;
         categoriesIn?: string[];
     }): Promise<FirebaseSieveResult<ProductDocument>>;

package/dist/features/products/repository/products.repository.js

@@ -2,11 +2,10 @@ import { increment, serverTimestamp } from "../../../contracts/field-ops";
 import { DatabaseError } from "../../../errors";
 import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
 import { cacheManager } from "../../../core";
-import { decryptPiiFields, encryptPiiFields } from "../../../security";
 import { generateUniqueId, slugify } from "../../../utils";
-import { PRODUCT_COLLECTION, createAuctionId, createPreOrderId, createProductId, ProductStatusValues, } from "../schemas";
+import { PRODUCT_COLLECTION, ProductStatusValues, } from "../schemas";
 const PRODUCT_FIELDS = {
-    SELLER_ID: "sellerId",
+    STORE_ID: "storeId",
     STATUS: "status",
     FEATURED: "featured",
     CATEGORY: "category",
@@ -19,7 +18,6 @@ const PRODUCT_FIELDS = {
     AVAILABLE_QUANTITY: "availableQuantity",
     VIEW_COUNT: "viewCount",
 };
-const PRODUCT_PII_FIELDS = ["sellerName", "sellerEmail"];
 export class ProductRepository extends BaseRepository {
     constructor() {
         super(PRODUCT_COLLECTION);
@@ -56,47 +54,18 @@ export class ProductRepository extends BaseRepository {
         return product;
     }
     mapDoc(snap) {
-        const raw = super.mapDoc(snap);
-        return decryptPiiFields(raw, [
-            ...PRODUCT_PII_FIELDS,
-            "title", // decrypt legacy records where title was encrypted; passthrough if not encrypted
-        ]);
+        return super.mapDoc(snap);
     }
     async update(id, data) {
         this.cacheInvalidateForId(id);
-        const encrypted = encryptPiiFields(data, [...PRODUCT_PII_FIELDS]);
-        const updated = await super.update(id, encrypted);
+        const updated = await super.update(id, data);
         this.cacheSet(updated);
         return updated;
     }
     async create(input) {
-        const id = await generateUniqueId((count) => {
-            if (input.isAuction) {
-                return createAuctionId({
-                    name: input.title,
-                    category: input.category,
-                    condition: "new",
-                    sellerName: input.sellerName,
-                    count,
-                });
-            }
-            if (input.isPreOrder) {
-                return createPreOrderId({
-                    name: input.title,
-                    category: input.category,
-                    condition: "new",
-                    sellerName: input.sellerName,
-                    count,
-                });
-            }
-            return createProductId({
-                name: input.title,
-                category: input.category,
-                condition: "new",
-                sellerName: input.sellerName,
-                count,
-            });
-        }, async (candidateId) => {
+        // Slug = document ID: derive slug from title first, then ensure uniqueness.
+        const baseSlug = input.slug || slugify(input.title);
+        const id = await generateUniqueId((count) => (count === 0 ? baseSlug : `${baseSlug}-${count}`), async (candidateId) => {
             try {
                 const doc = await this.findById(candidateId);
                 return !!doc;
@@ -107,22 +76,21 @@ export class ProductRepository extends BaseRepository {
         });
         const productData = {
             ...input,
-            slug: input.slug || `${slugify(input.title)}-${Date.now()}`,
+            slug: id,
             availableQuantity: input.stockQuantity,
             createdAt: new Date(),
             updatedAt: new Date(),
         };
-        const encrypted = encryptPiiFields(productData, [...PRODUCT_PII_FIELDS]);
         await this.db
             .collection(this.collection)
             .doc(id)
-            .set(prepareForFirestore(encrypted));
+            .set(prepareForFirestore(productData));
         const created = { id, ...productData };
         this.cacheSet(created);
         return created;
     }
-    async findBySeller(sellerId) {
-        return this.findBy(PRODUCT_FIELDS.SELLER_ID, sellerId);
+    async findByStore(storeId) {
+        return this.findBy(PRODUCT_FIELDS.STORE_ID, storeId);
     }
     async findByStatus(status) {
         return this.findBy(PRODUCT_FIELDS.STATUS, status);
@@ -203,10 +171,10 @@ export class ProductRepository extends BaseRepository {
             .get();
         return snapshot.docs.map((doc) => this.mapDoc(doc));
     }
-    async deleteBySeller(sellerId) {
+    async deleteByStore(storeId) {
         try {
             const snapshot = await this.getCollection()
-                .where(PRODUCT_FIELDS.SELLER_ID, "==", sellerId)
+                .where(PRODUCT_FIELDS.STORE_ID, "==", storeId)
                 .get();
             if (snapshot.empty)
                 return 0;
@@ -216,7 +184,7 @@ export class ProductRepository extends BaseRepository {
             return snapshot.size;
         }
         catch (error) {
-            throw new DatabaseError(`Failed to delete products for seller: ${sellerId}`, error);
+            throw new DatabaseError(`Failed to delete products for store: ${storeId}`, error);
         }
     }
     async delete(id) {
@@ -228,8 +196,8 @@ export class ProductRepository extends BaseRepository {
         if (opts?.status) {
             baseQuery = baseQuery.where(PRODUCT_FIELDS.STATUS, "==", opts.status);
         }
-        if (opts?.sellerId) {
-            baseQuery = baseQuery.where(PRODUCT_FIELDS.SELLER_ID, "==", opts.sellerId);
+        if (opts?.storeId) {
+            baseQuery = baseQuery.where(PRODUCT_FIELDS.STORE_ID, "==", opts.storeId);
         }
         if (opts?.categoriesIn && opts.categoriesIn.length > 0) {
             baseQuery = baseQuery.where(PRODUCT_FIELDS.CATEGORY, "in", opts.categoriesIn);
@@ -313,8 +281,8 @@ ProductRepository.SIEVE_FIELDS = {
     brand: { canFilter: true, canSort: true },
     condition: { canFilter: true, canSort: false },
     status: { canFilter: true, canSort: true },
-    sellerId: { canFilter: true, canSort: false },
-    sellerName: { canFilter: true, canSort: true },
+    storeId: { canFilter: true, canSort: false },
+    storeName: { canFilter: true, canSort: true },
     featured: { canFilter: true, canSort: false },
     isAuction: { canFilter: true, canSort: false },
     isPreOrder: { canFilter: true, canSort: false },
@@ -343,6 +311,7 @@ ProductRepository.SIEVE_FIELDS = {
     features: { canFilter: true, canSort: false },
     insurance: { canFilter: true, canSort: false },
     currency: { canFilter: true, canSort: false },
+    freeShipping: { canFilter: true, canSort: false },
 };
 export class ProductsRepository extends ProductRepository {
 }