@mohasinac/appkit 2.3.2 → 2.4.1

package/dist/features/reviews/components/ReviewDetailPageView.js

@@ -1,18 +1,14 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import Link from "next/link";
-import { reviewRepository, storeRepository } from "../../../repositories";
+import { reviewRepository } from "../../../repositories";
 import { Container, Main, Section } from "../../../ui";
 import { ROUTES } from "../../../next";
 import { ReviewDetailShell } from "./ReviewDetailShell";
 export async function ReviewDetailPageView({ id }) {
-    const review = await reviewRepository.findById(id).catch(() => null);
-    // Resolve store slug from sellerId so the shell can link to the store page
-    const storeSlug = review?.sellerId
-        ? await storeRepository
-            .findAll({ filters: `ownerId==${review.sellerId}`, pageSize: 1 })
-            .then((r) => r?.items?.[0]?.storeSlug ?? null)
-            .catch(() => null)
-        : null;
+    const doc = await reviewRepository.findById(id).catch(() => null);
+    const review = doc;
+    // storeId === storeSlug for stores in this project (pure slug IDs)
+    const storeSlug = doc?.storeId ?? null;
     if (!review || review.status !== "approved") {
         return (_jsx(Main, { children: _jsx(Section, { className: "py-24", children: _jsx(Container, { size: "sm", children: _jsxs("div", { className: "text-center", children: [_jsx("p", { className: "text-5xl mb-4", "aria-hidden": "true", children: "\uD83D\uDD0D" }), _jsx("h1", { className: "text-2xl font-bold text-neutral-900 dark:text-white mb-2", children: "Review not found" }), _jsx("p", { className: "text-sm text-neutral-500 dark:text-zinc-400 mb-6", children: "This review may have been removed or is no longer available." }), _jsx(Link, { href: String(ROUTES.PUBLIC.REVIEWS), className: "inline-flex items-center gap-2 rounded-lg bg-primary px-5 py-2.5 text-sm font-medium text-white hover:bg-primary-600 transition-colors", children: "\u2190 Back to Reviews" })] }) }) }) }));
     }

package/dist/features/reviews/components/ReviewFilters.js

@@ -56,5 +56,5 @@ export function ReviewFilters({ table, variant = "admin", brandOptions, }) {
         : [];
     const isAdmin = variant === "admin";
     const showStatus = variant !== "public";
-    return (_jsxs(Div, { children: [showStatus && (_jsx(FilterFacetSection, { title: t("status"), options: statusOptions, selected: selectedStatus, onChange: (vals) => table.set("status", vals.join("|")), searchable: false, defaultCollapsed: false })), _jsx(FilterFacetSection, { title: t("rating"), options: ratingOptions, selected: selectedRating, onChange: (vals) => table.set("rating", vals.join("|")), searchable: false, defaultCollapsed: variant === "admin" }), brandOptions && brandOptions.length > 0 && (_jsx(FilterFacetSection, { title: t("brand"), options: brandOptions, selected: table.get("brand") ? [table.get("brand")] : [], onChange: (vals) => table.set("brand", vals[0] ?? ""), searchable: brandOptions.length > 6, selectionMode: "single", defaultCollapsed: true })), _jsx(RangeFilter, { title: t("dateRange"), type: "date", minValue: table.get("dateFrom"), maxValue: table.get("dateTo"), onMinChange: (v) => table.set("dateFrom", v), onMaxChange: (v) => table.set("dateTo", v), minPlaceholder: t("minDate"), maxPlaceholder: t("maxDate"), defaultCollapsed: true }), isAdmin && (_jsxs(_Fragment, { children: [_jsx(SwitchFilter, { title: t("verified"), label: t("showVerifiedOnly"), checked: table.get("verified") === "true", onChange: (v) => table.set("verified", v ? "true" : ""), defaultCollapsed: true }), _jsx(SwitchFilter, { title: t("featured"), label: t("showFeaturedOnly"), checked: table.get("featured") === "true", onChange: (v) => table.set("featured", v ? "true" : ""), defaultCollapsed: true })] })), _jsx(RangeFilter, { title: t("votesRange"), minValue: table.get("minVotes"), maxValue: table.get("maxVotes"), onMinChange: (v) => table.set("minVotes", v), onMaxChange: (v) => table.set("maxVotes", v), minBound: 0, maxBound: 10000, step: 1, minPlaceholder: t("minVotes"), maxPlaceholder: t("maxVotes"), defaultCollapsed: true })] }));
+    return (_jsxs(Div, { children: [showStatus && (_jsx(FilterFacetSection, { title: t("status"), options: statusOptions, selected: selectedStatus, onChange: (vals) => table.set("status", vals.join("|")), searchable: false, defaultCollapsed: false })), _jsx(FilterFacetSection, { title: t("rating"), options: ratingOptions, selected: selectedRating, onChange: (vals) => table.set("rating", vals.join("|")), searchable: false, defaultCollapsed: variant === "admin" }), brandOptions && brandOptions.length > 0 && (_jsx(FilterFacetSection, { title: t("brand"), options: brandOptions, selected: table.get("brand") ? [table.get("brand")] : [], onChange: (vals) => table.set("brand", vals[0] ?? ""), searchable: brandOptions.length > 6, selectionMode: "single", defaultCollapsed: true })), _jsx(RangeFilter, { title: t("dateRange"), type: "date", minValue: table.get("dateFrom"), maxValue: table.get("dateTo"), onMinChange: (v) => table.set("dateFrom", v), onMaxChange: (v) => table.set("dateTo", v), minPlaceholder: t("minDate"), maxPlaceholder: t("maxDate"), defaultCollapsed: true }), isAdmin && (_jsxs(_Fragment, { children: [_jsx(SwitchFilter, { title: t("verified"), label: t("showVerifiedOnly"), checked: table.get("verified") === "true", onChange: (v) => table.set("verified", v ? "true" : "") }), _jsx(SwitchFilter, { title: t("featured"), label: t("showFeaturedOnly"), checked: table.get("featured") === "true", onChange: (v) => table.set("featured", v ? "true" : "") })] })), _jsx(RangeFilter, { title: t("votesRange"), minValue: table.get("minVotes"), maxValue: table.get("maxVotes"), onMinChange: (v) => table.set("minVotes", v), onMaxChange: (v) => table.set("maxVotes", v), minBound: 0, maxBound: 10000, step: 1, minPlaceholder: t("minVotes"), maxPlaceholder: t("maxVotes"), defaultCollapsed: true })] }));
 }

package/dist/features/reviews/components/ReviewsIndexListing.js

@@ -1,28 +1,79 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { useState, useCallback } from "react";
-import { Search, SlidersHorizontal, X } from "lucide-react";
+import { useState, useCallback, useMemo } from "react";
+import { X } from "lucide-react";
 import { useUrlTable } from "../../../react/hooks/useUrlTable";
-import { Pagination, SortDropdown } from "../../../ui";
+import { Pagination, ListingToolbar } from "../../../ui";
 import { ReviewCard } from "./ReviewsList";
 import { ReviewFilters, REVIEW_PUBLIC_SORT_OPTIONS } from "./ReviewFilters";
 import { useReviews } from "../hooks/useReviews";
 const PAGE_SIZE = 12;
+const FILTER_KEYS = ["rating", "dateFrom", "dateTo", "minVotes", "maxVotes"];
 export function ReviewsIndexListing({ initialData, variant = "public", }) {
     const table = useUrlTable({ defaults: { pageSize: String(PAGE_SIZE), sort: "-createdAt" } });
     const [searchInput, setSearchInput] = useState(table.get("q") || "");
     const [filterOpen, setFilterOpen] = useState(false);
     const sort = table.get("sort") || "-createdAt";
     const currentPage = table.getNumber("page", 1);
+    // 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(() => {
+        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: "" };
+        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("sort") !== "-createdAt" ||
+        activeFilterCount > 0;
     const commitSearch = useCallback(() => {
         table.set("q", searchInput.trim());
         table.setPage(1);
     }, [searchInput, table]);
-    const closeFilters = () => setFilterOpen(false);
-    const ratingRaw = table.get("rating");
     const { reviews, total, totalPages, isLoading } = useReviews({
         q: table.get("q") || undefined,
-        rating: ratingRaw || undefined,
+        rating: table.get("rating") || undefined,
         dateFrom: table.get("dateFrom") || undefined,
         dateTo: table.get("dateTo") || undefined,
         minVotes: table.get("minVotes") ? Number(table.get("minVotes")) : undefined,
@@ -35,5 +86,5 @@ export function ReviewsIndexListing({ initialData, variant = "public", }) {
         value: opt.value,
         label: opt.key,
     }));
-    return (_jsxs("div", { className: "min-h-screen", children: [_jsx("div", { className: "sticky top-0 z-20 border-b border-zinc-200 dark:border-slate-700 bg-white/95 dark:bg-slate-900/95 backdrop-blur-sm py-2.5 px-4", children: _jsxs("div", { className: "flex items-center gap-2.5 max-w-full", children: [_jsxs("button", { type: "button", onClick: () => setFilterOpen(true), className: "flex shrink-0 items-center gap-2 rounded-lg border border-zinc-300 dark:border-slate-600 px-3.5 py-2 text-sm font-medium text-zinc-700 dark:text-zinc-200 hover:bg-zinc-50 dark:hover:bg-slate-800 transition-colors", children: [_jsx(SlidersHorizontal, { className: "h-4 w-4" }), _jsx("span", { className: "hidden sm:inline", children: "Filters" })] }), _jsxs("div", { className: "flex flex-1 items-center overflow-hidden rounded-lg border border-zinc-300 dark:border-slate-600 bg-white dark:bg-slate-900", children: [_jsx("input", { type: "text", value: searchInput, onChange: (e) => setSearchInput(e.target.value), onKeyDown: (e) => e.key === "Enter" && commitSearch(), placeholder: "Search reviews by product name...", className: "min-w-0 flex-1 bg-transparent px-3 py-2 text-sm text-zinc-900 dark:text-zinc-100 placeholder-zinc-400 outline-none" }), searchInput && (_jsx("button", { type: "button", onClick: () => { setSearchInput(""); table.set("q", ""); table.setPage(1); }, className: "px-2 text-zinc-400 hover:text-zinc-600 transition-colors", "aria-label": "Clear search", children: _jsx(X, { className: "h-3.5 w-3.5" }) })), _jsx("button", { type: "button", onClick: commitSearch, className: "flex shrink-0 items-center justify-center px-3 py-2 text-zinc-400 hover:text-primary dark:hover:text-primary-400 transition-colors", "aria-label": "Search", children: _jsx(Search, { className: "h-4 w-4" }) })] }), _jsxs("div", { className: "flex shrink-0 items-center gap-1.5 text-sm text-zinc-500 dark:text-zinc-400", children: [_jsx("span", { className: "hidden md:inline whitespace-nowrap", children: "Sort by" }), _jsx(SortDropdown, { value: sort, onChange: (v) => { table.set("sort", v); table.setPage(1); }, options: sortOptions })] })] }) }), _jsxs("div", { className: "py-6", children: [isLoading ? (_jsx("div", { className: "grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-6", children: Array.from({ length: 6 }).map((_, i) => (_jsx("div", { className: "rounded-xl border border-zinc-100 dark:border-slate-700 overflow-hidden animate-pulse", children: _jsxs("div", { className: "p-4 space-y-3", children: [_jsx("div", { className: "h-4 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-full" }), _jsx("div", { className: "h-3 bg-zinc-200 dark:bg-slate-700 rounded w-2/3" })] }) }, i))) })) : reviews.length === 0 ? (_jsx("p", { className: "py-12 text-center text-sm text-zinc-500 dark:text-zinc-400", children: "No reviews found." })) : (_jsx("div", { className: "grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-6", children: reviews.map((review) => (_jsx(ReviewCard, { review: review }, review.id))) })), totalPages > 1 && (_jsx("div", { className: "mt-8 flex justify-center", children: _jsx(Pagination, { currentPage: currentPage, totalPages: totalPages, onPageChange: (p) => table.setPage(p) }) }))] }), filterOpen && (_jsxs(_Fragment, { children: [_jsx("div", { className: "fixed inset-0 z-40 bg-black/40", "aria-hidden": "true", onClick: closeFilters }), _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"] }), _jsx("button", { type: "button", onClick: closeFilters, "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(ReviewFilters, { table: table, variant: variant }) }), _jsx("div", { className: "border-t border-zinc-200 dark:border-slate-700 px-4 py-3.5", children: _jsx("button", { type: "button", onClick: closeFilters, className: "w-full rounded-lg bg-primary py-2.5 text-sm font-semibold text-white hover:bg-primary-600 transition-colors", children: "Apply filters" }) })] })] }))] }));
+    return (_jsxs("div", { className: "min-h-screen", children: [_jsx(ListingToolbar, { filterCount: activeFilterCount, onFiltersClick: openFilters, searchValue: searchInput, searchPlaceholder: "Search reviews by product name...", onSearchChange: setSearchInput, onSearchCommit: commitSearch, sortValue: sort, sortOptions: sortOptions, onSortChange: (v) => { table.set("sort", v); table.setPage(1); }, hideViewToggle: true, onResetAll: resetAll, hasActiveState: hasActiveState }), 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: currentPage, totalPages: totalPages, onPageChange: (p) => table.setPage(p) }) })), _jsx("div", { className: "py-6", children: isLoading ? (_jsx("div", { className: "grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-6", children: Array.from({ length: 6 }).map((_, i) => (_jsx("div", { className: "rounded-xl border border-zinc-100 dark:border-slate-700 overflow-hidden animate-pulse", children: _jsxs("div", { className: "p-4 space-y-3", children: [_jsx("div", { className: "h-4 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-full" }), _jsx("div", { className: "h-3 bg-zinc-200 dark:bg-slate-700 rounded w-2/3" })] }) }, i))) })) : reviews.length === 0 ? (_jsx("p", { className: "py-12 text-center text-sm text-zinc-500 dark:text-zinc-400", children: "No reviews found." })) : (_jsx("div", { className: "grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-6", children: reviews.map((review) => (_jsx(ReviewCard, { review: review }, review.id))) })) }), 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: [_jsx("span", { className: "flex items-center gap-2 text-base font-semibold text-zinc-900 dark:text-zinc-100", children: "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(ReviewFilters, { table: pendingTable, variant: variant }) }), _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/reviews/components/ReviewsList.js

@@ -21,8 +21,8 @@ export function ReviewCard({ review, className = "" }) {
     const productHref = review.productId
         ? String(ROUTES.PUBLIC.PRODUCT_DETAIL(review.productId))
         : null;
-    const card = (_jsxs(Div, { className: `group flex flex-col h-full rounded-xl border border-neutral-200 bg-white p-5 dark:border-zinc-700 dark:bg-zinc-900 transition-shadow hover:shadow-md cursor-pointer ${className}`, children: [_jsxs(Div, { className: "flex items-start gap-3", children: [review.userAvatar ? (_jsx(Div, { role: "img", "aria-label": displayName, className: "h-9 w-9 flex-shrink-0 rounded-full bg-center bg-cover", style: { backgroundImage: `url(${review.userAvatar})` } })) : (_jsx(Div, { className: "flex h-9 w-9 flex-shrink-0 items-center justify-center rounded-full bg-neutral-200 text-sm font-medium text-neutral-600 dark:bg-zinc-700 dark:text-zinc-300", children: initials })), _jsxs(Div, { className: "flex-1 min-w-0", children: [_jsxs(Row, { wrap: true, gap: "sm", children: [_jsx(Span, { className: "font-medium text-neutral-900 dark:text-white", children: displayName }), review.verified && (_jsx(Span, { className: "rounded-full bg-emerald-100 px-2 py-0.5 text-xs font-medium text-emerald-700 dark:bg-emerald-900/30 dark:text-emerald-400", children: "Verified" })), date && (_jsx(Span, { className: "text-xs text-neutral-400 dark:text-zinc-500", children: date }))] }), _jsx(Div, { className: "mt-1", children: _jsx(StarRating, { value: review.rating, size: "sm", readOnly: true }) })] })] }), review.title && (_jsx(Heading, { level: 4, className: "mt-3 font-semibold text-neutral-900 dark:text-white", children: review.title })), review.comment && (_jsx(RichText, { html: normalizeRichTextHtml(review.comment), proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "mt-2 text-sm leading-relaxed text-neutral-600 dark:text-zinc-400" })), review.images && review.images.length > 0 && (_jsx(Row, { wrap: true, gap: "sm", className: "mt-3", children: review.images.map((img, i) => (_jsx(Div, { role: "img", "aria-label": `Review image ${i + 1}`, className: "h-16 w-16 rounded-lg bg-center bg-cover border border-neutral-100 dark:border-zinc-700", style: { backgroundImage: `url(${img.thumbnailUrl ?? img.url})` } }, i))) })), (review.helpfulCount ?? 0) > 0 && (_jsxs(Text, { className: "mt-3 text-xs text-neutral-400 dark:text-zinc-500", children: [review.helpfulCount, " found this helpful"] })), productHref && (_jsxs(Div, { className: "mt-auto pt-3 flex items-center gap-1.5 text-xs font-medium text-neutral-500 dark:text-zinc-400 border-t border-neutral-100 dark:border-zinc-800", children: [_jsx("span", { "aria-hidden": "true", children: "\uD83D\uDCE6" }), _jsx("span", { className: THEME_CONSTANTS.utilities.textClamp1, children: review.productTitle ?? "View Product" }), _jsx("span", { "aria-hidden": "true", className: "ml-auto text-primary group-hover:translate-x-0.5 transition-transform", children: "\u2192" })] }))] }));
-    return (_jsx(Link, { href: reviewHref, className: "block h-full", children: card }));
+    const hasFooter = !!(review.storeSlug && review.storeName) || !!productHref;
+    return (_jsxs(Div, { className: `group flex flex-col h-full rounded-xl border border-neutral-200 bg-white p-5 dark:border-zinc-700 dark:bg-zinc-900 transition-shadow hover:shadow-md ${className}`, children: [_jsxs(Link, { href: reviewHref, className: "flex flex-col flex-1 min-h-0", children: [_jsxs(Div, { className: "flex items-start gap-3", children: [review.userAvatar ? (_jsx(Div, { role: "img", "aria-label": displayName, className: "h-9 w-9 flex-shrink-0 rounded-full bg-center bg-cover", style: { backgroundImage: `url(${review.userAvatar})` } })) : (_jsx(Div, { className: "flex h-9 w-9 flex-shrink-0 items-center justify-center rounded-full bg-neutral-200 text-sm font-medium text-neutral-600 dark:bg-zinc-700 dark:text-zinc-300", children: initials })), _jsxs(Div, { className: "flex-1 min-w-0", children: [_jsxs(Row, { wrap: true, gap: "sm", children: [_jsx(Span, { className: "font-medium text-neutral-900 dark:text-white", children: displayName }), review.verified && (_jsx(Span, { className: "rounded-full bg-emerald-100 px-2 py-0.5 text-xs font-medium text-emerald-700 dark:bg-emerald-900/30 dark:text-emerald-400", children: "Verified" })), date && (_jsx(Span, { className: "text-xs text-neutral-400 dark:text-zinc-500", children: date }))] }), _jsx(Div, { className: "mt-1", children: _jsx(StarRating, { value: review.rating, size: "sm", readOnly: true }) })] })] }), review.title && (_jsx(Heading, { level: 4, className: "mt-3 font-semibold text-neutral-900 dark:text-white", children: review.title })), review.comment && (_jsx(RichText, { html: normalizeRichTextHtml(review.comment), proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "mt-2 text-sm leading-relaxed text-neutral-600 dark:text-zinc-400" })), review.images && review.images.length > 0 && (_jsx(Row, { wrap: true, gap: "sm", className: "mt-3", children: review.images.map((img, i) => (_jsx(Div, { role: "img", "aria-label": `Review image ${i + 1}`, className: "h-16 w-16 rounded-lg bg-center bg-cover border border-neutral-100 dark:border-zinc-700", style: { backgroundImage: `url(${img.thumbnailUrl ?? img.url})` } }, i))) })), (review.helpfulCount ?? 0) > 0 && (_jsxs(Text, { className: "mt-3 text-xs text-neutral-400 dark:text-zinc-500", children: [review.helpfulCount, " found this helpful"] }))] }), hasFooter && (_jsxs(Div, { className: "mt-3 pt-3 border-t border-neutral-100 dark:border-zinc-800 flex flex-col gap-1.5", children: [review.storeSlug && review.storeName && (_jsxs(Link, { href: String(ROUTES.PUBLIC.STORE_DETAIL(review.storeSlug)), className: "flex items-center gap-1.5 text-xs font-medium text-primary hover:underline", children: [_jsx("span", { "aria-hidden": "true", children: "\uD83C\uDFEA" }), _jsx("span", { className: THEME_CONSTANTS.utilities.textClamp1, children: review.storeName })] })), productHref && (_jsxs(Link, { href: productHref, className: "flex items-center gap-1.5 text-xs font-medium text-neutral-500 dark:text-zinc-400 hover:text-neutral-700 dark:hover:text-zinc-200", children: [_jsx("span", { "aria-hidden": "true", children: "\uD83D\uDCE6" }), _jsx("span", { className: THEME_CONSTANTS.utilities.textClamp1, children: review.productTitle ?? "View Product" }), _jsx("span", { "aria-hidden": "true", className: "ml-auto text-primary group-hover:translate-x-0.5 transition-transform", children: "\u2192" })] }))] }))] }));
 }
 export function ReviewsList({ reviews, isLoading, totalPages = 1, currentPage = 1, onPageChange, emptyLabel = "No reviews yet", }) {
     if (isLoading) {

package/dist/features/reviews/hooks/useReviews.d.ts

@@ -3,6 +3,7 @@ interface UseReviewsOptions {
     initialData?: ReviewListResponse;
     enabled?: boolean;
     endpoint?: string;
+    staleTime?: number;
 }
 export declare function useReviews(params?: ReviewListParams, opts?: UseReviewsOptions): {
     reviews: import("..").Review[];

package/dist/features/reviews/hooks/useReviews.js

@@ -30,7 +30,7 @@ export function useReviews(params = {}, opts) {
     if (params.maxVotes !== undefined)
         sp.set("maxVotes", String(params.maxVotes));
     // General listing mode (no productId)
-    if (!params.productId && !params.userId && !params.sellerId) {
+    if (!params.productId && !params.userId && !params.storeId) {
         sp.set("latest", "true");
     }
     const qs = sp.toString();
@@ -38,6 +38,7 @@ export function useReviews(params = {}, opts) {
         queryKey: ["reviews", qs],
         queryFn: () => apiClient.get(`${REVIEW_ENDPOINTS.LIST}${qs ? `?${qs}` : ""}`),
         initialData: opts?.initialData,
+        staleTime: opts?.staleTime ?? (opts?.initialData !== undefined ? Infinity : 0),
         enabled: opts?.enabled,
     });
     return {

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

@@ -14,6 +14,7 @@ declare class ReviewRepository extends BaseRepository<ReviewDocument> {
     update(reviewId: string, data: Partial<ReviewDocument>): Promise<ReviewDocument>;
     findByProduct(productId: string): Promise<ReviewDocument[]>;
     findApprovedByProduct(productId: string): Promise<ReviewDocument[]>;
+    findApprovedByStore(storeId: string): Promise<ReviewDocument[]>;
     findByUser(userId: string): Promise<ReviewDocument[]>;
     findPending(): Promise<ReviewDocument[]>;
     findByStatus(status: ReviewStatus): Promise<ReviewDocument[]>;
@@ -29,9 +30,9 @@ declare class ReviewRepository extends BaseRepository<ReviewDocument> {
      */
     getApprovedRatingAggregate(productId: string): Promise<ReviewRatingAggregate>;
     /**
-     * Cloud Functions compatibility: approved review count + average by seller.
+     * Cloud Functions compatibility: approved review count + average by store.
      */
-    getApprovedRatingAggregateBySeller(sellerId: string): Promise<ReviewRatingAggregate>;
+    getApprovedRatingAggregateByStore(storeId: string): Promise<ReviewRatingAggregate>;
     static readonly SIEVE_FIELDS: {
         id: {
             canFilter: boolean;
@@ -57,7 +58,11 @@ declare class ReviewRepository extends BaseRepository<ReviewDocument> {
             canFilter: boolean;
             canSort: boolean;
         };
-        sellerId: {
+        storeId: {
+            canFilter: boolean;
+            canSort: boolean;
+        };
+        storeName: {
             canFilter: boolean;
             canSort: boolean;
         };
@@ -95,7 +100,7 @@ declare class ReviewRepository extends BaseRepository<ReviewDocument> {
         };
     };
     listForProduct(productId: string, model: SieveModel): Promise<FirebaseSieveResult<ReviewDocument>>;
-    listForSeller(sellerId: string, model: SieveModel): Promise<FirebaseSieveResult<ReviewDocument>>;
+    listForStore(storeId: string, model: SieveModel): Promise<FirebaseSieveResult<ReviewDocument>>;
     listAll(model: SieveModel): Promise<FirebaseSieveResult<ReviewDocument>>;
 }
 declare const reviewRepository: ReviewRepository;

package/dist/features/reviews/repository/reviews.repository.js

@@ -4,7 +4,7 @@ import { createReviewId, REVIEW_COLLECTION, } from "../schemas";
 const REVIEW_FIELDS = {
     PRODUCT_ID: "productId",
     USER_ID: "userId",
-    SELLER_ID: "sellerId",
+    STORE_ID: "storeId",
     STATUS: "status",
     FEATURED: "featured",
     CREATED_AT: "createdAt",
@@ -63,6 +63,16 @@ class ReviewRepository extends BaseRepository {
             .get();
         return snapshot.docs.map((doc) => this.mapDoc(doc));
     }
+    async findApprovedByStore(storeId) {
+        const snapshot = await this.db
+            .collection(this.collection)
+            .where(REVIEW_FIELDS.STORE_ID, "==", storeId)
+            .where(REVIEW_FIELDS.STATUS, "==", "approved")
+            .orderBy("createdAt", "desc")
+            .limit(50)
+            .get();
+        return snapshot.docs.map((doc) => this.mapDoc(doc));
+    }
     async findByUser(userId) {
         return this.findBy(REVIEW_FIELDS.USER_ID, userId);
     }
@@ -152,12 +162,12 @@ class ReviewRepository extends BaseRepository {
         return { count, avgRating };
     }
     /**
-     * Cloud Functions compatibility: approved review count + average by seller.
+     * Cloud Functions compatibility: approved review count + average by store.
      */
-    async getApprovedRatingAggregateBySeller(sellerId) {
+    async getApprovedRatingAggregateByStore(storeId) {
         const snapshot = await this.db
             .collection(this.collection)
-            .where(REVIEW_FIELDS.SELLER_ID, "==", sellerId)
+            .where(REVIEW_FIELDS.STORE_ID, "==", storeId)
             .where(REVIEW_FIELDS.STATUS, "==", "approved")
             .get();
         if (snapshot.empty) {
@@ -177,8 +187,8 @@ class ReviewRepository extends BaseRepository {
             maxPageSize: 50,
         });
     }
-    async listForSeller(sellerId, model) {
-        const baseQuery = this.getCollection().where(REVIEW_FIELDS.SELLER_ID, "==", sellerId);
+    async listForStore(storeId, model) {
+        const baseQuery = this.getCollection().where(REVIEW_FIELDS.STORE_ID, "==", storeId);
         return this.sieveQuery(model, ReviewRepository.SIEVE_FIELDS, {
             baseQuery,
             defaultPageSize: 10,
@@ -199,7 +209,8 @@ ReviewRepository.SIEVE_FIELDS = {
     userId: { canFilter: true, canSort: false },
     userNameIndex: { canFilter: true, canSort: false },
     userName: { canFilter: false, canSort: false },
-    sellerId: { canFilter: true, canSort: false },
+    storeId: { canFilter: true, canSort: false },
+    storeName: { canFilter: true, canSort: false },
     status: { canFilter: true, canSort: true },
     rating: { canFilter: true, canSort: true },
     verified: { canFilter: true, canSort: false },

package/dist/features/reviews/schemas/firestore.d.ts

@@ -19,7 +19,8 @@ export interface ReviewDocument {
     id: string;
     productId: string;
     productTitle: string;
-    sellerId?: string;
+    storeId?: string;
+    storeName?: string;
     userId: string;
     userName: string;
     userAvatar?: string;
@@ -36,13 +37,15 @@ export interface ReviewDocument {
     reportCount: number;
     verified: boolean;
     featured?: boolean;
+    sellerReply?: string;
+    sellerRepliedAt?: Date;
     createdAt: Date;
     updatedAt: Date;
     approvedAt?: Date;
     rejectedAt?: Date;
 }
 export declare const REVIEW_COLLECTION: "reviews";
-export declare const REVIEW_INDEXED_FIELDS: readonly ["productId", "userId", "status", "rating", "verified", "featured", "createdAt"];
+export declare const REVIEW_INDEXED_FIELDS: readonly ["productId", "storeId", "userId", "status", "rating", "verified", "featured", "createdAt"];
 export declare const DEFAULT_REVIEW_DATA: Partial<ReviewDocument>;
 export declare const REVIEW_PUBLIC_FIELDS: readonly ["id", "productId", "userName", "userAvatar", "rating", "title", "comment", "helpfulCount", "verified", "images", "createdAt"];
 export declare const REVIEW_UPDATABLE_FIELDS: readonly ["rating", "title", "comment", "images"];

package/dist/features/reviews/schemas/firestore.js

@@ -11,6 +11,7 @@ export const ReviewStatusValues = {
 export const REVIEW_COLLECTION = "reviews";
 export const REVIEW_INDEXED_FIELDS = [
     "productId",
+    "storeId",
     "userId",
     "status",
     "rating",

package/dist/features/reviews/schemas/index.d.ts

@@ -47,7 +47,8 @@ export declare const reviewSchema: z.ZodObject<{
     id: z.ZodString;
     productId: z.ZodString;
     productTitle: z.ZodOptional<z.ZodString>;
-    sellerId: z.ZodOptional<z.ZodString>;
+    storeSlug: z.ZodOptional<z.ZodString>;
+    storeName: z.ZodOptional<z.ZodString>;
     userId: z.ZodString;
     userName: z.ZodString;
     userAvatar: z.ZodOptional<z.ZodString>;
@@ -93,9 +94,9 @@ export declare const reviewSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     id: string;
     status: "pending" | "approved" | "rejected";
+    productId: string;
     rating: 1 | 2 | 3 | 4 | 5;
     userId: string;
-    productId: string;
     userName: string;
     title?: string | undefined;
     video?: {
@@ -107,24 +108,25 @@ export declare const reviewSchema: z.ZodObject<{
     } | undefined;
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
-    sellerId?: string | undefined;
+    productTitle?: string | undefined;
     images?: {
         url: string;
         thumbnailUrl?: string | undefined;
     }[] | undefined;
-    productTitle?: string | undefined;
-    featured?: boolean | undefined;
-    verified?: boolean | undefined;
     comment?: string | undefined;
+    featured?: boolean | undefined;
+    storeName?: string | undefined;
+    storeSlug?: string | undefined;
     userAvatar?: string | undefined;
+    verified?: boolean | undefined;
     helpfulCount?: number | undefined;
     reportCount?: number | undefined;
 }, {
     id: string;
     status: "pending" | "approved" | "rejected";
+    productId: string;
     rating: 1 | 2 | 3 | 4 | 5;
     userId: string;
-    productId: string;
     userName: string;
     title?: string | undefined;
     video?: {
@@ -136,16 +138,17 @@ export declare const reviewSchema: z.ZodObject<{
     } | undefined;
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
-    sellerId?: string | undefined;
+    productTitle?: string | undefined;
     images?: {
         url: string;
         thumbnailUrl?: string | undefined;
     }[] | undefined;
-    productTitle?: string | undefined;
-    featured?: boolean | undefined;
-    verified?: boolean | undefined;
     comment?: string | undefined;
+    featured?: boolean | undefined;
+    storeName?: string | undefined;
+    storeSlug?: string | undefined;
     userAvatar?: string | undefined;
+    verified?: boolean | undefined;
     helpfulCount?: number | undefined;
     reportCount?: number | undefined;
 }>;
@@ -153,7 +156,7 @@ export declare const reviewSchema: z.ZodObject<{
 export declare const reviewListParamsSchema: z.ZodObject<{
     productId: z.ZodOptional<z.ZodString>;
     userId: z.ZodOptional<z.ZodString>;
-    sellerId: z.ZodOptional<z.ZodString>;
+    storeId: z.ZodOptional<z.ZodString>;
     status: z.ZodOptional<z.ZodEnum<["pending", "approved", "rejected"]>>;
     rating: z.ZodOptional<z.ZodNumber>;
     featured: z.ZodOptional<z.ZodBoolean>;
@@ -163,21 +166,21 @@ export declare const reviewListParamsSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     sort?: string | undefined;
     status?: "pending" | "approved" | "rejected" | undefined;
+    productId?: string | undefined;
     page?: number | undefined;
     perPage?: number | undefined;
-    sellerId?: string | undefined;
+    storeId?: string | undefined;
     rating?: number | undefined;
     userId?: string | undefined;
-    productId?: string | undefined;
     featured?: boolean | undefined;
 }, {
     sort?: string | undefined;
     status?: "pending" | "approved" | "rejected" | undefined;
+    productId?: string | undefined;
     page?: number | undefined;
     perPage?: number | undefined;
-    sellerId?: string | undefined;
+    storeId?: string | undefined;
     rating?: number | undefined;
     userId?: string | undefined;
-    productId?: string | undefined;
     featured?: boolean | undefined;
 }>;

package/dist/features/reviews/schemas/index.js

@@ -31,7 +31,8 @@ export const reviewSchema = z.object({
     id: z.string(),
     productId: z.string(),
     productTitle: z.string().optional(),
-    sellerId: z.string().optional(),
+    storeSlug: z.string().optional(),
+    storeName: z.string().optional(),
     userId: z.string(),
     userName: z.string(),
     userAvatar: z.string().optional(),
@@ -58,7 +59,7 @@ export const reviewSchema = z.object({
 export const reviewListParamsSchema = z.object({
     productId: z.string().optional(),
     userId: z.string().optional(),
-    sellerId: z.string().optional(),
+    storeId: z.string().optional(),
     status: reviewStatusSchema.optional(),
     rating: z.coerce.number().optional(),
     featured: z.coerce.boolean().optional(),

package/dist/features/reviews/types/index.d.ts

@@ -14,7 +14,8 @@ export interface Review {
     id: string;
     productId: string;
     productTitle?: string;
-    sellerId?: string;
+    storeSlug?: string;
+    storeName?: string;
     userId: string;
     userName: string;
     userAvatar?: string;
@@ -44,7 +45,7 @@ export interface ReviewListResponse {
 export interface ReviewListParams {
     productId?: string;
     userId?: string;
-    sellerId?: string;
+    storeId?: string;
     status?: ReviewStatus;
     rating?: number | string;
     featured?: boolean;

package/dist/features/scams/actions/scam-actions.d.ts

@@ -0,0 +1,29 @@
+import type { ScammerDocument, ScammerIncidentDocument, ScammerCommentDocument } from "../schemas/firestore";
+export interface ScammerProfilePageData {
+    scammer: ScammerDocument;
+    incidents: ScammerIncidentDocument[];
+    comments: ScammerCommentDocument[];
+    relatedScammers: ScammerDocument[];
+}
+export interface ScammerListResult {
+    items: ScammerDocument[];
+    total: number;
+    page: number;
+    pageSize: number;
+    hasMore: boolean;
+}
+/**
+ * List verified scammer profiles for the public registry page.
+ * Accepts sieve-style searchParams from Next.js page props.
+ */
+export declare function listVerifiedScammers(searchParams?: Record<string, string | string[]>): Promise<ScammerListResult>;
+/**
+ * Fetch a single verified scammer by id or seoSlug.
+ * Also increments the view counter (fire-and-forget).
+ */
+export declare function getPublicScammerById(id: string): Promise<ScammerDocument | null>;
+/**
+ * Fetch full profile page data: main doc + verified incidents + public comments + related scammers.
+ * Returns null if not found or not verified.
+ */
+export declare function getScammerProfilePageData(id: string): Promise<ScammerProfilePageData | null>;

package/dist/features/scams/actions/scam-actions.js

@@ -0,0 +1,62 @@
+"use server";
+import { scammerRepository } from "../repository/scammer.repository";
+/**
+ * List verified scammer profiles for the public registry page.
+ * Accepts sieve-style searchParams from Next.js page props.
+ */
+export async function listVerifiedScammers(searchParams) {
+    const params = searchParams ?? {};
+    const page = Math.max(1, Number(params.p ?? params.page ?? 1));
+    const pageSize = Math.min(50, Math.max(1, Number(params.ps ?? params.pageSize ?? 20)));
+    const sort = String(params.s ?? params.sort ?? "-createdAt");
+    // scamType / scamPlatform filter chips — status==verified is enforced by the base query
+    const filters = [];
+    if (params.scamType)
+        filters.push(`scamType==${params.scamType}`);
+    if (params.scamPlatform)
+        filters.push(`scamPlatform==${params.scamPlatform}`);
+    const result = await scammerRepository.listVerified({
+        filters: filters.join(",") || undefined,
+        sorts: sort,
+        page,
+        pageSize,
+    });
+    return {
+        items: result.items,
+        total: result.total,
+        page,
+        pageSize,
+        hasMore: result.hasMore,
+    };
+}
+/**
+ * Fetch a single verified scammer by id or seoSlug.
+ * Also increments the view counter (fire-and-forget).
+ */
+export async function getPublicScammerById(id) {
+    // Try direct id lookup first; fall back to seoSlug query.
+    let doc = await scammerRepository.findById(id).catch(() => null);
+    if (!doc) {
+        doc = await scammerRepository.findBySeoSlug(id).catch(() => null);
+    }
+    if (!doc || doc.status !== "verified")
+        return null;
+    // Increment views — non-blocking.
+    scammerRepository.incrementViews(doc.id).catch(() => { });
+    return doc;
+}
+/**
+ * Fetch full profile page data: main doc + verified incidents + public comments + related scammers.
+ * Returns null if not found or not verified.
+ */
+export async function getScammerProfilePageData(id) {
+    const scammer = await getPublicScammerById(id);
+    if (!scammer)
+        return null;
+    const [incidents, comments, relatedScammers] = await Promise.all([
+        scammerRepository.listPublicIncidents(scammer.id),
+        scammerRepository.listPublicComments(scammer.id),
+        scammerRepository.findManyById(scammer.relatedScammerIds),
+    ]);
+    return { scammer, incidents, comments, relatedScammers };
+}

package/dist/features/scams/components/ScamProfileView.d.ts

@@ -0,0 +1,10 @@
+import type { ScammerDocument, ScammerIncidentDocument, ScammerCommentDocument } from "../schemas/firestore";
+export interface ScamProfileViewProps {
+    scammer: ScammerDocument;
+    /** When true the contest/report buttons are direct links; otherwise show sign-in prompts. */
+    isAuthenticated: boolean;
+    incidents?: ScammerIncidentDocument[];
+    comments?: ScammerCommentDocument[];
+    relatedScammers?: ScammerDocument[];
+}
+export declare function ScamProfileView({ scammer, isAuthenticated, incidents, comments, relatedScammers, }: ScamProfileViewProps): import("react/jsx-runtime").JSX.Element;