@mohasinac/appkit 4.11.2 → 4.11.3

package/dist/features/promotions/repository/coupons.repository.js

@@ -376,7 +376,7 @@ export class CouponsRepository extends BaseRepository {
      *          `eligibleSubtotal` (the order slice the discount is based on)
      *          and `eligibleProductIds` (the `productId` values that qualify).
      */
-    async validateCouponForCart(code, userId, cartItems) {
+    async validateCouponForCart(code, userId, cartItems, opts) {
         const check = await this._fetchAndValidateCoupon(code, userId);
         if (!check.ok)
             return check.result;
@@ -400,25 +400,39 @@ export class CouponsRepository extends BaseRepository {
             eligible = eligible.filter((item) => item.listingType !== "auction");
         }
         // Apply product/category restrictions from the coupon itself
-        const { applicableProducts, applicableCategories, excludeProducts } = coupon.restrictions;
+        const { applicableProducts, applicableCategories, excludeProducts, excludeCategories, } = coupon.restrictions;
         if (applicableProducts && applicableProducts.length > 0) {
             eligible = eligible.filter((item) => applicableProducts.includes(item.productId));
         }
         if (excludeProducts && excludeProducts.length > 0) {
             eligible = eligible.filter((item) => !excludeProducts.includes(item.productId));
         }
-        // Note: category filtering requires product metadata — skipped here but
-        // the restriction is stored and can be enforced by the order service.
-        void applicableCategories;
+        // Category restrictions need product metadata the cart doesn't snapshot,
+        // so they are resolved through the injected callback. A product carries
+        // `categorySlugs[]` (1-to-many), so the test is set intersection.
+        const needsCategories = (applicableCategories?.length ?? 0) > 0 ||
+            (excludeCategories?.length ?? 0) > 0;
+        if (needsCategories && eligible.length > 0 && opts?.resolveCategorySlugs) {
+            const slugsByProduct = await opts.resolveCategorySlugs(eligible.map((item) => item.productId));
+            const slugsFor = (productId) => slugsByProduct.get(productId) ?? [];
+            if (applicableCategories && applicableCategories.length > 0) {
+                eligible = eligible.filter((item) => slugsFor(item.productId).some((slug) => applicableCategories.includes(slug)));
+            }
+            if (excludeCategories && excludeCategories.length > 0) {
+                eligible = eligible.filter((item) => !slugsFor(item.productId).some((slug) => excludeCategories.includes(slug)));
+            }
+        }
         if (eligible.length === 0) {
             return {
                 valid: false,
                 coupon,
                 message: coupon.applicableToAuctions === true
                     ? "This coupon only applies to auction items"
-                    : scope === "seller"
-                        ? "This coupon is not valid for the items in your cart from this seller"
-                        : "No eligible items found for this coupon",
+                    : needsCategories
+                        ? "This coupon does not apply to any of the categories in your cart"
+                        : scope === "seller"
+                            ? "This coupon is not valid for the items in your cart from this seller"
+                            : "No eligible items found for this coupon",
             };
         }
         const eligibleSubtotal = eligible.reduce((sum, item) => sum + item.price * item.quantity, 0);

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

@@ -37,7 +37,6 @@ export interface RestrictionsConfig {
     excludeProducts?: string[];
     excludeCategories?: string[];
     firstTimeUserOnly: boolean;
-    combineWithSellerCoupons: boolean;
 }
 export interface CouponStats {
     totalUses: number;

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

@@ -62,7 +62,7 @@ export const COUPON_TYPE_LABELS = {
 export const DEFAULT_COUPON_DATA = {
     usage: { currentUsage: 0 },
     validity: { isActive: true, startDate: new Date(), endDate: undefined },
-    restrictions: { firstTimeUserOnly: false, combineWithSellerCoupons: false },
+    restrictions: { firstTimeUserOnly: false },
     stats: { totalUses: 0, totalRevenue: 0, totalDiscount: 0 },
 };
 export const COUPONS_PUBLIC_FIELDS = [

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

@@ -93,10 +93,8 @@ export declare const restrictionsConfigSchema: z.ZodObject<{
     excludeProducts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     excludeCategories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     firstTimeUserOnly: z.ZodBoolean;
-    combineWithSellerCoupons: z.ZodBoolean;
 }, "strip", z.ZodTypeAny, {
     firstTimeUserOnly: boolean;
-    combineWithSellerCoupons: boolean;
     applicableProducts?: string[] | undefined;
     applicableCategories?: string[] | undefined;
     applicableSellers?: string[] | undefined;
@@ -104,7 +102,6 @@ export declare const restrictionsConfigSchema: z.ZodObject<{
     excludeCategories?: string[] | undefined;
 }, {
     firstTimeUserOnly: boolean;
-    combineWithSellerCoupons: boolean;
     applicableProducts?: string[] | undefined;
     applicableCategories?: string[] | undefined;
     applicableSellers?: string[] | undefined;
@@ -239,10 +236,8 @@ export declare const couponFirestoreSchema: z.ZodObject<{
         excludeProducts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         excludeCategories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         firstTimeUserOnly: z.ZodBoolean;
-        combineWithSellerCoupons: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
         firstTimeUserOnly: boolean;
-        combineWithSellerCoupons: boolean;
         applicableProducts?: string[] | undefined;
         applicableCategories?: string[] | undefined;
         applicableSellers?: string[] | undefined;
@@ -250,7 +245,6 @@ export declare const couponFirestoreSchema: z.ZodObject<{
         excludeCategories?: string[] | undefined;
     }, {
         firstTimeUserOnly: boolean;
-        combineWithSellerCoupons: boolean;
         applicableProducts?: string[] | undefined;
         applicableCategories?: string[] | undefined;
         applicableSellers?: string[] | undefined;
@@ -311,7 +305,6 @@ export declare const couponFirestoreSchema: z.ZodObject<{
     };
     restrictions: {
         firstTimeUserOnly: boolean;
-        combineWithSellerCoupons: boolean;
         applicableProducts?: string[] | undefined;
         applicableCategories?: string[] | undefined;
         applicableSellers?: string[] | undefined;
@@ -370,7 +363,6 @@ export declare const couponFirestoreSchema: z.ZodObject<{
     };
     restrictions: {
         firstTimeUserOnly: boolean;
-        combineWithSellerCoupons: boolean;
         applicableProducts?: string[] | undefined;
         applicableCategories?: string[] | undefined;
         applicableSellers?: string[] | undefined;
@@ -450,10 +442,8 @@ export declare const claimedCouponSnapshotSchema: z.ZodObject<{
         excludeProducts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         excludeCategories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         firstTimeUserOnly: z.ZodBoolean;
-        combineWithSellerCoupons: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
         firstTimeUserOnly: boolean;
-        combineWithSellerCoupons: boolean;
         applicableProducts?: string[] | undefined;
         applicableCategories?: string[] | undefined;
         applicableSellers?: string[] | undefined;
@@ -461,7 +451,6 @@ export declare const claimedCouponSnapshotSchema: z.ZodObject<{
         excludeCategories?: string[] | undefined;
     }, {
         firstTimeUserOnly: boolean;
-        combineWithSellerCoupons: boolean;
         applicableProducts?: string[] | undefined;
         applicableCategories?: string[] | undefined;
         applicableSellers?: string[] | undefined;
@@ -479,7 +468,6 @@ export declare const claimedCouponSnapshotSchema: z.ZodObject<{
     };
     restrictions: {
         firstTimeUserOnly: boolean;
-        combineWithSellerCoupons: boolean;
         applicableProducts?: string[] | undefined;
         applicableCategories?: string[] | undefined;
         applicableSellers?: string[] | undefined;
@@ -499,7 +487,6 @@ export declare const claimedCouponSnapshotSchema: z.ZodObject<{
     };
     restrictions: {
         firstTimeUserOnly: boolean;
-        combineWithSellerCoupons: boolean;
         applicableProducts?: string[] | undefined;
         applicableCategories?: string[] | undefined;
         applicableSellers?: string[] | undefined;
@@ -541,10 +528,8 @@ export declare const claimedCouponFirestoreSchema: z.ZodObject<{
             excludeProducts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             excludeCategories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             firstTimeUserOnly: z.ZodBoolean;
-            combineWithSellerCoupons: z.ZodBoolean;
         }, "strip", z.ZodTypeAny, {
             firstTimeUserOnly: boolean;
-            combineWithSellerCoupons: boolean;
             applicableProducts?: string[] | undefined;
             applicableCategories?: string[] | undefined;
             applicableSellers?: string[] | undefined;
@@ -552,7 +537,6 @@ export declare const claimedCouponFirestoreSchema: z.ZodObject<{
             excludeCategories?: string[] | undefined;
         }, {
             firstTimeUserOnly: boolean;
-            combineWithSellerCoupons: boolean;
             applicableProducts?: string[] | undefined;
             applicableCategories?: string[] | undefined;
             applicableSellers?: string[] | undefined;
@@ -570,7 +554,6 @@ export declare const claimedCouponFirestoreSchema: z.ZodObject<{
         };
         restrictions: {
             firstTimeUserOnly: boolean;
-            combineWithSellerCoupons: boolean;
             applicableProducts?: string[] | undefined;
             applicableCategories?: string[] | undefined;
             applicableSellers?: string[] | undefined;
@@ -590,7 +573,6 @@ export declare const claimedCouponFirestoreSchema: z.ZodObject<{
         };
         restrictions: {
             firstTimeUserOnly: boolean;
-            combineWithSellerCoupons: boolean;
             applicableProducts?: string[] | undefined;
             applicableCategories?: string[] | undefined;
             applicableSellers?: string[] | undefined;
@@ -651,7 +633,6 @@ export declare const claimedCouponFirestoreSchema: z.ZodObject<{
         };
         restrictions: {
             firstTimeUserOnly: boolean;
-            combineWithSellerCoupons: boolean;
             applicableProducts?: string[] | undefined;
             applicableCategories?: string[] | undefined;
             applicableSellers?: string[] | undefined;
@@ -692,7 +673,6 @@ export declare const claimedCouponFirestoreSchema: z.ZodObject<{
         };
         restrictions: {
             firstTimeUserOnly: boolean;
-            combineWithSellerCoupons: boolean;
             applicableProducts?: string[] | undefined;
             applicableCategories?: string[] | undefined;
             applicableSellers?: string[] | undefined;

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

@@ -45,7 +45,6 @@ export const restrictionsConfigSchema = z.object({
     excludeProducts: z.array(z.string()).optional(),
     excludeCategories: z.array(z.string()).optional(),
     firstTimeUserOnly: z.boolean(),
-    combineWithSellerCoupons: z.boolean(),
 });
 export const couponStatsSchema = z.object({
     totalUses: z.number().int().nonnegative(),

package/dist/features/reviews/actions/review-actions.js

@@ -174,9 +174,13 @@ export async function listReviewsBySeller(sellerId) {
     }
     const reviewBatches = await Promise.all(productIds
         .slice(0, 20)
-        .map((id) => reviewRepository.findApprovedByProduct(id).catch(() => [])));
+        .map((id) => reviewRepository.findApprovedByProduct(id, 50).catch(() => [])));
+    // Each per-product batch is newest-first, but concatenating them yields product order,
+    // not chronological order — the flattened list has to be re-sorted or callers get an
+    // arbitrarily interleaved "latest reviews" list.
     return reviewBatches
         .flat()
+        .sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime())
         .map((item) => maskPublicReview(item));
 }
 export async function getHomepageReviews() {

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

@@ -14,7 +14,8 @@ export async function ReviewDetailPageView({ id }) {
         return (_jsx(Main, { children: _jsx(Section, { padding: "y-6xl", children: _jsx(Container, { size: "sm", children: _jsxs(Div, { className: "text-left", children: [_jsx(Text, { className: "mb-4", size: "5xl", "aria-hidden": "true", children: "\uD83D\uDD0D" }), _jsx(Heading, { color: "inverse", level: 1, className: "text-[var(--appkit-color-text)] dark: mb-2", size: "2xl", weight: "bold", children: "Review not found" }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] mb-6", size: "sm", 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-[var(--appkit-space-2)] rounded-lg bg-primary px-[var(--appkit-space-5)] py-[var(--appkit-space-2-5)] text-[length:var(--appkit-text-sm)] font-medium text-white hover:bg-primary-600 transition-colors", children: "\u2190 Back to Reviews" })] }) }) }) }));
     }
     const [sameProductDocs, sameStoreDocs] = await Promise.all([
-        reviewRepository.findApprovedByProduct(review.productId).catch(() => []),
+        // 12 = the 6 rendered below, with headroom for the current review + any filtered out.
+        reviewRepository.findApprovedByProduct(review.productId, 12).catch(() => []),
         storeSlug ? reviewRepository.findApprovedByStore(storeSlug).catch(() => []) : Promise.resolve([]),
     ]);
     const sameProductReviews = sameProductDocs.filter((r) => r.id !== review.id).slice(0, 6);

package/dist/features/reviews/components/ReviewFilters.d.ts

@@ -70,5 +70,11 @@ export interface ReviewFiltersProps {
     variant?: ReviewFilterVariant;
     /** Optional brand options for filter by brand */
     brandOptions?: FacetOption[];
+    /**
+     * Restrict which filter controls render. Callers that only *apply* a subset must pass
+     * it here — a rendered control whose value the caller never reads is a silent no-op,
+     * which reads to the user as a broken filter. Omit to keep the variant's full set.
+     */
+    keys?: readonly string[];
 }
-export declare function ReviewFilters({ table, variant, brandOptions, }: ReviewFiltersProps): import("react").JSX.Element;
+export declare function ReviewFilters({ table, variant, brandOptions, keys, }: ReviewFiltersProps): import("react").JSX.Element;

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

@@ -38,7 +38,8 @@ export function getReviewSortOptions(variant) {
             return REVIEW_PUBLIC_SORT_OPTIONS;
     }
 }
-export function ReviewFilters({ table, variant = "admin", brandOptions, }) {
+export function ReviewFilters({ table, variant = "admin", brandOptions, keys, }) {
+    const shows = (key) => (keys ? keys.includes(key) : true);
     const t = useTranslations("filters");
     const statusOptions = [
         { value: "pending", label: t("reviewStatusPending") },
@@ -59,6 +60,6 @@ export function ReviewFilters({ table, variant = "admin", brandOptions, }) {
         ? table.get("rating").split("|").filter(Boolean)
         : [];
     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" : "") }), _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 }), _jsx(SwitchFilter, { title: "Media", label: "Show reviews with photos only", checked: table.get("hasImages") === "true", onChange: (v) => table.set("hasImages", v ? "true" : "") })] }));
+    const showStatus = variant !== "public" && shows(TABLE_KEYS.STATUS);
+    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 })), shows(TABLE_KEYS.RATING) && (_jsx(FilterFacetSection, { title: t("rating"), options: ratingOptions, selected: selectedRating, onChange: (vals) => table.set("rating", vals.join("|")), searchable: false, defaultCollapsed: variant === "admin" })), shows(TABLE_KEYS.BRAND) && 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 })), shows(TABLE_KEYS.DATE_FROM) && (_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" : "") })] })), shows("minVotes") && (_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 })), shows("hasImages") && (_jsx(SwitchFilter, { title: "Media", label: "Show reviews with photos only", checked: table.get("hasImages") === "true", onChange: (v) => table.set("hasImages", v ? "true" : "") }))] }));
 }

package/dist/features/reviews/components/ReviewsIndexListing.d.ts

@@ -4,4 +4,10 @@ export interface ReviewsIndexListingProps {
     initialData?: ReviewListResponse;
     variant?: "admin" | "seller" | "public";
 }
+/**
+ * The public `/reviews` index. Everything below the props is `ReviewsListingPanel` —
+ * this file and `StoreReviewsListing` used to be near-identical copies of the same
+ * toolbar + sticky pagination + filter drawer + card grid, and the detail-page reviews
+ * tab would have been a third. See the Duplication Decision Framework (Rule of Three).
+ */
 export declare function ReviewsIndexListing({ initialData, variant, }: ReviewsIndexListingProps): React.JSX.Element;

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

@@ -1,112 +1,12 @@
 "use client";
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useState, useCallback, useMemo } from "react";
-import { useUrlTable } from "../../../react/hooks/useUrlTable";
-import { Div, ListingFilterDrawer, ListingToolbar, Pagination, Row, Stack, Text, StickyToolbar } from "../../../ui";
-import { ReviewCard } from "./ReviewsList";
-import { ReviewFilters, REVIEW_PUBLIC_SORT_OPTIONS } from "./ReviewFilters";
-import { useReviews } from "../hooks/useReviews";
-import { TABLE_KEYS, VIEW_MODE } from "../../../constants/table-keys";
-import { sortBy } from "../../../constants/sort";
-import { REVIEW_FIELDS } from "../../../constants/field-names";
-const __P = {
-    p4: "p-[var(--appkit-space-4)]",
-};
-const __O = {
-    hidden: "overflow-hidden",
-};
-const PAGE_SIZE = 12;
-const DEFAULT_SORT = sortBy(REVIEW_FIELDS.CREATED_AT);
-const FILTER_KEYS = ["rating", TABLE_KEYS.DATE_FROM, TABLE_KEYS.DATE_TO, "minVotes", "maxVotes", "hasImages"];
-const SORT_OPTION_LABELS = {
-    sortNewest: "Newest First",
-    sortOldest: "Oldest First",
-    sortHighestRated: "Highest Rated",
-    sortLowestRated: "Lowest Rated",
-};
+import { jsx as _jsx } from "react/jsx-runtime";
+import { ReviewsListingPanel } from "./ReviewsListingPanel";
+/**
+ * The public `/reviews` index. Everything below the props is `ReviewsListingPanel` —
+ * this file and `StoreReviewsListing` used to be near-identical copies of the same
+ * toolbar + sticky pagination + filter drawer + card grid, and the detail-page reviews
+ * tab would have been a third. See the Duplication Decision Framework (Rule of Three).
+ */
 export function ReviewsIndexListing({ initialData, variant = "public", }) {
-    const table = useUrlTable({ defaults: { pageSize: String(PAGE_SIZE), sort: DEFAULT_SORT } });
-    const [searchInput, setSearchInput] = useState(table.get(TABLE_KEYS.QUERY) || "");
-    const [filterOpen, setFilterOpen] = useState(false);
-    const [view, setView] = useState(table.get(TABLE_KEYS.VIEW) || VIEW_MODE.GRID);
-    const handleViewToggle = (next) => {
-        if (next === VIEW_MODE.TABLE)
-            return;
-        setView(next);
-        table.set(TABLE_KEYS.VIEW, next);
-    };
-    const sort = table.get(TABLE_KEYS.SORT) || DEFAULT_SORT;
-    const currentPage = table.getNumber(TABLE_KEYS.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 = { [TABLE_KEYS.QUERY]: "", [TABLE_KEYS.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(TABLE_KEYS.QUERY) ||
-        table.get(TABLE_KEYS.SORT) !== DEFAULT_SORT ||
-        activeFilterCount > 0;
-    const commitSearch = useCallback(() => {
-        table.set(TABLE_KEYS.QUERY, searchInput.trim());
-    }, [searchInput, table]);
-    const { reviews, totalPages, isLoading } = useReviews({
-        q: table.get(TABLE_KEYS.QUERY) || undefined,
-        rating: table.get(TABLE_KEYS.RATING) || undefined,
-        dateFrom: table.get(TABLE_KEYS.DATE_FROM) || undefined,
-        dateTo: table.get(TABLE_KEYS.DATE_TO) || undefined,
-        minVotes: table.get("minVotes") ? Number(table.get("minVotes")) : undefined,
-        maxVotes: table.get("maxVotes") ? Number(table.get("maxVotes")) : undefined,
-        hasImages: table.get("hasImages") === "true" ? true : undefined,
-        sort,
-        page: currentPage,
-        perPage: PAGE_SIZE,
-    }, { initialData });
-    const sortOptions = REVIEW_PUBLIC_SORT_OPTIONS.map((opt) => ({
-        value: opt.value,
-        label: SORT_OPTION_LABELS[opt.key] ?? opt.key,
-    }));
-    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(TABLE_KEYS.SORT, v); }, view: view, onViewChange: handleViewToggle, onResetAll: resetAll, hasActiveState: hasActiveState }), totalPages > 1 && (_jsx(StickyToolbar, { offset: "header+pagination", tone: "translucent", border: true, padding: "toolbar", children: _jsx(Row, { justify: "center", children: _jsx(Pagination, { currentPage: currentPage, totalPages: totalPages, onPageChange: (p) => table.setPage(p) }) }) })), _jsx(Div, { padding: "y-lg", children: isLoading ? (_jsx(Div, { layout: "grid", gap: "6", className: "grid-cols-1 sm:grid-cols-2 lg:grid-cols-3", children: Array.from({ length: 6 }).map((_, i) => (_jsx(Div, { className: `${__O.hidden} animate-pulse`, border: "subtle", rounded: "xl", children: _jsxs(Stack, { className: `${__P.p4}`, gap: "3", children: [_jsx(Div, { className: "h-4 w-3/4", surface: "subtle", rounded: "default" }), _jsx(Div, { className: "h-3 w-full", surface: "subtle", rounded: "default" }), _jsx(Div, { className: "h-3 w-2/3", surface: "subtle", rounded: "default" })] }) }, i))) })) : reviews.length === 0 ? (_jsx(Text, { paddingY: "3xl", color: "muted", size: "sm", align: "start", children: "No reviews found." })) : view === "list" ? (_jsx(Stack, { className: "divide-y divide-zinc-100 divide-[var(--appkit-color-border-subtle)]", border: "subtle", rounded: "xl", children: reviews.map((review) => (_jsx(ReviewCard, { review: review }, review.id))) })) : (_jsx(Div, { layout: "grid", gap: "6", className: "grid-cols-1 sm:grid-cols-2 lg:grid-cols-3", children: reviews.map((review) => (_jsx(ReviewCard, { review: review }, review.id))) })) }), _jsx(ListingFilterDrawer, { open: filterOpen, onClose: () => setFilterOpen(false), onApply: applyFilters, onClear: clearFilters, activeCount: activeFilterCount, children: _jsx(ReviewFilters, { table: pendingTable, variant: variant }) })] }));
+    return (_jsx(ReviewsListingPanel, { source: { kind: "all" }, stateMode: "url", initialData: initialData, variant: variant, showSummary: false, className: "min-h-screen" }));
 }

package/dist/features/reviews/components/ReviewsListingPanel.d.ts

@@ -0,0 +1,41 @@
+import React from "react";
+import type { ReviewListResponse } from "../types";
+import type { ReviewCardContext } from "./ReviewsList";
+/**
+ * Which reviews this panel lists. `product` and `all` go through `/api/reviews`;
+ * `store` goes through `/api/stores/[slug]/reviews`, which is the only endpoint that
+ * can fan a store's reviews out across its products.
+ */
+export type ReviewsSource = {
+    kind: "product";
+    productId: string;
+} | {
+    kind: "store";
+    storeSlug: string;
+} | {
+    kind: "all";
+};
+export interface ReviewsListingPanelProps {
+    source: ReviewsSource;
+    pageSize?: number;
+    context?: ReviewCardContext;
+    /**
+     * `"url"` writes page/sort/filters to the query string — right for the dedicated
+     * review pages (shareable, SEO route segments read them back).
+     *
+     * `"local"` keeps that state in the component. Detail pages must use this: `useUrlTable`
+     * calls `router.replace()` on every change, which re-runs the whole product/auction RSC
+     * tree just to turn a page of reviews.
+     */
+    stateMode?: "url" | "local";
+    /** SSR-seeded page 1. Only applied while the panel is genuinely at its default query. */
+    initialData?: ReviewListResponse;
+    /** Rating + count line above the toolbar. */
+    showSummary?: boolean;
+    /** Free-text search over product titles — meaningless on a single-product list. */
+    showSearch?: boolean;
+    variant?: "admin" | "seller" | "public";
+    emptyLabel?: string;
+    className?: string;
+}
+export declare function ReviewsListingPanel({ source, pageSize, context, stateMode, initialData, showSummary, showSearch, variant, emptyLabel, className, }: ReviewsListingPanelProps): React.JSX.Element;