@mohasinac/appkit 2.2.0 → 2.3.1

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

@@ -41,18 +41,19 @@ export declare const couponItemSchema: z.ZodObject<{
     updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     id: string;
-    createdAt: string;
-    updatedAt: string;
     code: string;
-    type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
     scope: "admin" | "seller";
     name: string;
+    type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
+    createdAt: string;
+    updatedAt: string;
+    isActive: boolean;
     description: string;
     isPublic: boolean;
-    isActive: boolean;
     discountValue: number;
     usageCount: number;
     sellerId?: string | undefined;
+    startsAt?: string | undefined;
     storeId?: string | undefined;
     expiresAt?: string | undefined;
     minOrderAmount?: number | undefined;
@@ -63,21 +64,21 @@ export declare const couponItemSchema: z.ZodObject<{
     getQuantity?: number | undefined;
     applicableProductIds?: string[] | undefined;
     applicableCategoryIds?: string[] | undefined;
-    startsAt?: string | undefined;
 }, {
     id: string;
-    createdAt: string;
-    updatedAt: string;
     code: string;
-    type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
     scope: "admin" | "seller";
     name: string;
+    type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
+    createdAt: string;
+    updatedAt: string;
+    isActive: boolean;
     description: string;
     isPublic: boolean;
-    isActive: boolean;
     discountValue: number;
     usageCount: number;
     sellerId?: string | undefined;
+    startsAt?: string | undefined;
     storeId?: string | undefined;
     expiresAt?: string | undefined;
     minOrderAmount?: number | undefined;
@@ -88,7 +89,6 @@ export declare const couponItemSchema: z.ZodObject<{
     getQuantity?: number | undefined;
     applicableProductIds?: string[] | undefined;
     applicableCategoryIds?: string[] | undefined;
-    startsAt?: string | undefined;
 }>;
 export declare const promotionsListParamsSchema: z.ZodObject<{
     scope: z.ZodOptional<z.ZodEnum<["admin", "seller"]>>;
@@ -100,18 +100,18 @@ export declare const promotionsListParamsSchema: z.ZodObject<{
     sort: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     sort?: string | undefined;
-    pageSize?: number | undefined;
-    sellerId?: string | undefined;
-    filters?: string | undefined;
-    page?: number | undefined;
     scope?: "admin" | "seller" | undefined;
     isActive?: boolean | undefined;
-}, {
-    sort?: string | undefined;
+    page?: number | undefined;
     pageSize?: number | undefined;
-    sellerId?: string | undefined;
     filters?: string | undefined;
-    page?: number | undefined;
+    sellerId?: string | undefined;
+}, {
+    sort?: string | undefined;
     scope?: "admin" | "seller" | undefined;
     isActive?: boolean | undefined;
+    page?: number | undefined;
+    pageSize?: number | undefined;
+    filters?: string | undefined;
+    sellerId?: string | undefined;
 }>;

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

@@ -1,6 +1,6 @@
 export * from "./firestore";
 import { z } from "zod";
-// ─── Sub-schemas ──────────────────────────────────────────────────────────────
+// --- Sub-schemas --------------------------------------------------------------
 export const couponTypeSchema = z.enum([
     "percentage",
     "fixed",
@@ -8,7 +8,7 @@ export const couponTypeSchema = z.enum([
     "buy_x_get_y",
 ]);
 export const couponScopeSchema = z.enum(["admin", "seller"]);
-// ─── Base item schema ─────────────────────────────────────────────────────────
+// --- Base item schema ---------------------------------------------------------
 /**
  * Base Zod schema for a coupon/promotion.
  * Apps can extend this to add their own fields:

package/dist/features/promotions/server.d.ts

@@ -3,7 +3,6 @@
  *
  * Server-only entry point for promotions repositories and API route handlers.
  */
-import "server-only";
 export * from "./actions";
 export { PromotionsRepository } from "./repository/promotions.repository";
 export { couponsRepository } from "./repository/coupons.repository";

package/dist/features/promotions/server.js

@@ -3,7 +3,6 @@
  *
  * Server-only entry point for promotions repositories and API route handlers.
  */
-import "server-only";
 export * from "./actions";
 export { PromotionsRepository } from "./repository/promotions.repository";
 export { couponsRepository } from "./repository/coupons.repository";

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

@@ -1,2 +1,2 @@
-// ─── Coupon types ─────────────────────────────────────────────────────────────
+// --- Coupon types -------------------------------------------------------------
 export {};

package/dist/features/reviews/api/[id]/route.js

@@ -12,7 +12,7 @@ import { NextResponse } from "next/server.js";
 import { z } from "zod";
 import { getProviders } from "../../../../contracts";
 import { createRouteHandler } from "../../../../next";
-// ──── GET /api/reviews/[id] ───────────────────────────────────────────────────
+// ---- GET /api/reviews/[id] ---------------------------------------------------
 export async function GET(_request, context) {
     try {
         const { id } = await context.params;
@@ -33,7 +33,7 @@ export async function GET(_request, context) {
     }
 }
 export { GET as reviewItemGET };
-// ──── PATCH /api/reviews/[id] ─────────────────────────────────────────────────
+// ---- PATCH /api/reviews/[id] -------------------------------------------------
 const reviewUpdateSchema = z
     .object({
     rating: z
@@ -83,7 +83,7 @@ export const reviewItemPATCH = createRouteHandler({
         return NextResponse.json({ success: true, data: updated });
     },
 });
-// ──── DELETE /api/reviews/[id] ────────────────────────────────────────────────
+// ---- DELETE /api/reviews/[id] ------------------------------------------------
 export const reviewItemDELETE = createRouteHandler({
     auth: true,
     handler: async ({ request, user }) => {

package/dist/features/reviews/api/route.js

@@ -56,7 +56,7 @@ export async function GET(request) {
             return NextResponse.json({ success: false, error: "Database provider not registered" }, { status: 503 });
         }
         const repo = db.getRepository("reviews");
-        // ── ?featured=true ────────────────────────────────────────────────────────
+        // -- ?featured=true --------------------------------------------------------
         // Returns flat Review[] for homepage testimonial sections.
         if (featured) {
             const result = await repo.findAll({
@@ -68,7 +68,7 @@ export async function GET(request) {
             response.headers.set("Cache-Control", "public, max-age=300, s-maxage=600, stale-while-revalidate=120");
             return response;
         }
-        // ── ?latest=true ──────────────────────────────────────────────────────────
+        // -- ?latest=true ----------------------------------------------------------
         // Paginated latest approved reviews, no productId required.
         if (latest) {
             const latestPageSize = numParam(url, "pageSize", 24);
@@ -91,7 +91,7 @@ export async function GET(request) {
             response.headers.set("Cache-Control", "public, max-age=120, s-maxage=300, stale-while-revalidate=60");
             return response;
         }
-        // ── ?productId=<id> ───────────────────────────────────────────────────────
+        // -- ?productId=<id> -------------------------------------------------------
         // Paginated reviews for a product with aggregate rating stats.
         const productId = param(url, "productId");
         if (!productId) {

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

@@ -1,4 +1,3 @@
-"use client";
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { useTranslations } from "next-intl";
 import { FilterFacetSection } from "../../filters/FilterFacetSection";

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

@@ -1,9 +1,12 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useState } from "react";
-import { Button, Div, Heading, IconButton, Modal, Row, Text, } from "../../../ui";
+import { Button, Div, Heading, IconButton, Modal, RichText, Row, Text, } from "../../../ui";
 import { StarRating } from "../../../ui";
+import { maskName } from "../../../security";
+import { THEME_CONSTANTS } from "../../../tokens";
 import { getDefaultLocale } from "../../../core/baseline-resolver";
+import { normalizeRichTextHtml } from "../../../utils/string.formatter";
 /**
  * ViewReviewModal — full review details in a Modal overlay.
  * Shows all images, the full comment, and seller response if present.
@@ -12,6 +15,7 @@ export function ViewReviewModal({ review, isOpen, onClose, }) {
     const [lightboxIdx, setLightboxIdx] = useState(null);
     if (!review)
         return null;
+    const displayName = maskName(review.userName);
     const date = review.createdAt
         ? new Date(review.createdAt).toLocaleDateString(getDefaultLocale(), {
             year: "numeric",
@@ -19,7 +23,7 @@ export function ViewReviewModal({ review, isOpen, onClose, }) {
             day: "numeric",
         })
         : "";
-    return (_jsx(Modal, { isOpen: isOpen, onClose: onClose, title: "Review Details", children: _jsxs(Div, { className: "space-y-4", children: [_jsxs(Row, { className: "gap-3", children: [review.userAvatar ? (_jsx(Div, { role: "img", "aria-label": review.userName, className: "h-10 w-10 flex-shrink-0 rounded-full bg-center bg-cover", style: { backgroundImage: `url(${review.userAvatar})` } })) : (_jsx(Div, { className: "flex h-10 w-10 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: review.userName.charAt(0).toUpperCase() })), _jsxs(Div, { children: [_jsxs(Row, { className: "gap-2", children: [_jsx(Text, { className: "font-medium text-neutral-900 dark:text-white", children: review.userName }), review.verified && (_jsx(Text, { className: "text-xs text-green-600 dark:text-green-400", children: "\u2713 Verified purchase" }))] }), _jsxs(Row, { className: "gap-2 mt-0.5", children: [_jsx(StarRating, { value: review.rating, size: "sm", readOnly: true }), date && (_jsx(Text, { className: "text-xs text-neutral-400 dark:text-zinc-500", children: date }))] })] })] }), review.title && (_jsx(Heading, { level: 4, className: "font-semibold text-neutral-900 dark:text-white", children: review.title })), review.comment && (_jsx(Text, { className: "text-sm leading-relaxed text-neutral-600 dark:text-zinc-400", children: review.comment })), review.images && review.images.length > 0 && (_jsx(Row, { wrap: true, gap: "sm", children: review.images.map((img, i) => (_jsx(IconButton, { "aria-label": `View image ${i + 1}`, onClick: () => setLightboxIdx(i), variant: "ghost", className: `h-20 w-20 rounded-lg border bg-center bg-cover transition hover:opacity-80 p-0 ${lightboxIdx === i ? "ring-2 ring-primary-500" : "border-neutral-100 dark:border-zinc-700"}`, style: {
+    return (_jsx(Modal, { isOpen: isOpen, onClose: onClose, title: "Review Details", children: _jsxs(Div, { className: "space-y-4", children: [_jsxs(Row, { className: "gap-3", children: [review.userAvatar ? (_jsx(Div, { role: "img", "aria-label": displayName, className: "h-10 w-10 flex-shrink-0 rounded-full bg-center bg-cover", style: { backgroundImage: `url(${review.userAvatar})` } })) : (_jsx(Div, { className: "flex h-10 w-10 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: displayName.charAt(0).toUpperCase() })), _jsxs(Div, { children: [_jsxs(Row, { className: "gap-2", children: [_jsx(Text, { className: "font-medium text-neutral-900 dark:text-white", children: displayName }), review.verified && (_jsx(Text, { className: `text-xs ${THEME_CONSTANTS.themed.textSuccess}`, children: "\u2713 Verified purchase" }))] }), _jsxs(Row, { className: "gap-2 mt-0.5", children: [_jsx(StarRating, { value: review.rating, size: "sm", readOnly: true }), date && (_jsx(Text, { className: "text-xs text-neutral-400 dark:text-zinc-500", children: date }))] })] })] }), review.title && (_jsx(Heading, { level: 4, className: "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: "text-sm leading-relaxed text-neutral-600 dark:text-zinc-400" })), review.images && review.images.length > 0 && (_jsx(Row, { wrap: true, gap: "sm", children: review.images.map((img, i) => (_jsx(IconButton, { "aria-label": `View image ${i + 1}`, onClick: () => setLightboxIdx(i), variant: "ghost", className: `h-20 w-20 rounded-lg border bg-center bg-cover transition hover:opacity-80 p-0 ${lightboxIdx === i ? "ring-2 ring-primary-500" : "border-neutral-100 dark:border-zinc-700"}`, style: {
                             backgroundImage: `url(${img.thumbnailUrl ?? img.url})`,
                         }, icon: _jsx(Div, {}) }, i))) })), (review.helpfulCount ?? 0) > 0 && (_jsxs(Text, { className: "text-xs text-neutral-400 dark:text-zinc-500", children: [review.helpfulCount, " people found this helpful"] })), _jsx(Div, { className: "flex justify-end pt-2", children: _jsx(Button, { variant: "ghost", onClick: onClose, children: "Close" }) })] }) }));
 }

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

@@ -1,4 +1,3 @@
-"use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Div, Span, Text } from "../../../ui";
 import { StarRating } from "../../../ui";

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

@@ -0,0 +1,5 @@
+import type { Review } from "../types";
+export interface ReviewsIndexListingProps {
+    reviews: Review[];
+}
+export declare function ReviewsIndexListing({ reviews }: ReviewsIndexListingProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,55 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo, useState } from "react";
+import { Div, Grid, Pagination, SlottedListingView, SortDropdown, Stack, Text, } from "../../../ui";
+import { ReviewCard } from "./ReviewsList";
+const PAGE_SIZE = 12;
+const SORT_OPTIONS = [
+    { value: "-createdAt", label: "Newest First" },
+    { value: "createdAt", label: "Oldest First" },
+    { value: "-rating", label: "Highest Rating" },
+    { value: "rating", label: "Lowest Rating" },
+];
+const STAR_OPTIONS = [
+    { value: "", label: "All Ratings" },
+    { value: "5", label: "5 Stars" },
+    { value: "4", label: "4 Stars" },
+    { value: "3", label: "3 Stars" },
+    { value: "2", label: "2 Stars" },
+    { value: "1", label: "1 Star" },
+];
+export function ReviewsIndexListing({ reviews }) {
+    const [sort, setSort] = useState("-createdAt");
+    const [starFilter, setStarFilter] = useState("");
+    const [page, setPage] = useState(1);
+    const filtered = useMemo(() => {
+        let result = [...reviews];
+        if (starFilter) {
+            const star = parseInt(starFilter, 10);
+            result = result.filter((r) => r.rating === star);
+        }
+        result.sort((a, b) => {
+            if (sort === "-rating")
+                return b.rating - a.rating;
+            if (sort === "rating")
+                return a.rating - b.rating;
+            const aTime = a.createdAt ? new Date(a.createdAt).getTime() : 0;
+            const bTime = b.createdAt ? new Date(b.createdAt).getTime() : 0;
+            return sort === "createdAt" ? aTime - bTime : bTime - aTime;
+        });
+        return result;
+    }, [reviews, sort, starFilter]);
+    const totalPages = Math.max(1, Math.ceil(filtered.length / PAGE_SIZE));
+    const paginated = filtered.slice((page - 1) * PAGE_SIZE, page * PAGE_SIZE);
+    const handleSort = (val) => {
+        setSort(val);
+        setPage(1);
+    };
+    const handleStarFilter = (val) => {
+        setStarFilter(val);
+        setPage(1);
+    };
+    return (_jsx(Div, { className: "min-h-screen", children: _jsx(SlottedListingView, { portal: "public", manageSearch: false, manageSort: false, inlineToolbar: true, renderSort: () => (_jsx(SortDropdown, { value: sort, onChange: handleSort, options: SORT_OPTIONS })), renderFilters: () => (_jsxs(Div, { className: "space-y-2 p-4", children: [_jsx(Text, { className: "text-sm font-semibold text-zinc-700 dark:text-zinc-300", children: "Filter by Rating" }), STAR_OPTIONS.map((opt) => (_jsx("button", { type: "button", onClick: () => handleStarFilter(opt.value), className: `block w-full rounded-lg px-3 py-2 text-left text-sm transition ${starFilter === opt.value
+                            ? "bg-zinc-900 text-white dark:bg-zinc-100 dark:text-zinc-900"
+                            : "text-zinc-700 hover:bg-zinc-100 dark:text-zinc-300 dark:hover:bg-slate-800"}`, children: opt.label }, opt.value)))] })), renderTable: () => paginated.length === 0 ? (_jsx(Stack, { align: "center", gap: "3", className: "justify-center py-24 text-center", children: _jsx(Text, { className: "text-xl font-medium text-zinc-900 dark:text-zinc-50", children: "No reviews found" }) })) : (_jsx(Grid, { cols: 3, gap: "md", children: paginated.map((review) => (_jsx(ReviewCard, { review: review }, review.id))) })), renderPagination: () => totalPages > 1 ? (_jsx(Pagination, { currentPage: page, totalPages: totalPages, onPageChange: setPage })) : null, total: filtered.length, isLoading: false }) }));
+}

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

@@ -0,0 +1 @@
+export declare function ReviewsIndexPageView(): Promise<import("react/jsx-runtime").JSX.Element>;

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

@@ -0,0 +1,9 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { reviewRepository } from "../../../repositories";
+import { Container, Heading, Main, Section } from "../../../ui";
+import { AdSlot } from "../../homepage/components/AdSlot";
+import { ReviewsIndexListing } from "./ReviewsIndexListing";
+export async function ReviewsIndexPageView() {
+    const reviews = await reviewRepository.findByStatus("approved").catch(() => []);
+    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 dark:text-zinc-50", children: "Reviews" }), _jsx(AdSlot, { id: "listing-sidebar-top", className: "mb-6" }), _jsx(ReviewsIndexListing, { reviews: reviews }), _jsx(AdSlot, { id: "listing-sidebar-bottom", className: "mt-8" })] }) }) }));
+}

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

@@ -1,8 +1,9 @@
-"use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Div, Heading, Pagination, Row, Skeleton, Span, Stack, Text, } from "../../../ui";
+import { Div, Heading, Pagination, RichText, Row, Skeleton, Span, Stack, Text, } from "../../../ui";
 import { StarRating } from "../../../ui";
+import { maskName } from "../../../security";
 import { getDefaultLocale } from "../../../core/baseline-resolver";
+import { normalizeRichTextHtml } from "../../../utils/string.formatter";
 export function ReviewCard({ review, className = "" }) {
     const date = review.createdAt
         ? new Date(review.createdAt).toLocaleDateString(getDefaultLocale(), {
@@ -11,8 +12,9 @@ export function ReviewCard({ review, className = "" }) {
             day: "numeric",
         })
         : "";
-    const initials = review.userName.charAt(0).toUpperCase();
-    return (_jsxs(Div, { className: `rounded-xl border border-neutral-200 bg-white p-5 dark:border-zinc-700 dark:bg-zinc-900 ${className}`, children: [_jsxs(Div, { className: "flex items-start gap-3", children: [review.userAvatar ? (_jsx(Div, { role: "img", "aria-label": review.userName, 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: review.userName }), review.verified && (_jsx(Span, { className: "rounded-full bg-green-100 px-2 py-0.5 text-xs font-medium text-green-700 dark:bg-green-900/30 dark:text-green-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(Text, { className: "mt-2 text-sm leading-relaxed text-neutral-600 dark:text-zinc-400", children: review.comment })), 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"] }))] }));
+    const displayName = maskName(review.userName);
+    const initials = displayName.charAt(0).toUpperCase();
+    return (_jsxs(Div, { className: `rounded-xl border border-neutral-200 bg-white p-5 dark:border-zinc-700 dark:bg-zinc-900 ${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"] }))] }));
 }
 export function ReviewsList({ reviews, isLoading, totalPages = 1, currentPage = 1, onPageChange, emptyLabel = "No reviews yet", }) {
     if (isLoading) {

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

@@ -8,3 +8,5 @@ export type { ViewReviewModalProps } from "./ReviewModal";
 export { ViewReviewModal } from "./ReviewModal";
 export { ReviewsListView } from "./ReviewsListView";
 export type { ReviewsListViewProps } from "./ReviewsListView";
+export { ReviewsIndexListing } from "./ReviewsIndexListing";
+export type { ReviewsIndexListingProps } from "./ReviewsIndexListing";

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

@@ -3,3 +3,4 @@ export { ReviewFilters, REVIEW_SORT_OPTIONS, REVIEW_FILTER_KEYS, REVIEW_ADMIN_SO
 export { ReviewSummary } from "./ReviewSummary";
 export { ViewReviewModal } from "./ReviewModal";
 export { ReviewsListView } from "./ReviewsListView";
+export { ReviewsIndexListing } from "./ReviewsIndexListing";

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

@@ -1,7 +1,7 @@
-"use client";
 import { useMutation } from "@tanstack/react-query";
 import { apiClient } from "../../../http";
 import { REVIEW_ENDPOINTS } from "../../../constants/api-endpoints";
+import { normalizeRichTextHtml } from "../../../utils/string.formatter";
 export function useCreateReview(onSuccess, onError) {
     return useMutation({
         mutationFn: (data) => {
@@ -10,6 +10,7 @@ export function useCreateReview(onSuccess, onError) {
             }
             return apiClient.post(REVIEW_ENDPOINTS.LIST, {
                 ...data,
+                comment: normalizeRichTextHtml(data.comment),
                 images: data.images ?? [],
                 videoUrl: data.videoUrl,
             });

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

@@ -1,4 +1,3 @@
-"use client";
 import { useQuery } from "@tanstack/react-query";
 import { apiClient } from "../../../http";
 import { REVIEW_ENDPOINTS } from "../../../constants/api-endpoints";

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

@@ -21,14 +21,14 @@ export declare const reviewVideoSchema: z.ZodObject<{
     url: string;
     trimEnd?: number | undefined;
     trimStart?: number | undefined;
-    duration?: number | undefined;
     thumbnailUrl?: string | undefined;
+    duration?: number | undefined;
 }, {
     url: string;
     trimEnd?: number | undefined;
     trimStart?: number | undefined;
-    duration?: number | undefined;
     thumbnailUrl?: string | undefined;
+    duration?: number | undefined;
 }>;
 /**
  * Base Zod schema for a review.
@@ -74,14 +74,14 @@ export declare const reviewSchema: z.ZodObject<{
         url: string;
         trimEnd?: number | undefined;
         trimStart?: number | undefined;
-        duration?: number | undefined;
         thumbnailUrl?: string | undefined;
+        duration?: number | undefined;
     }, {
         url: string;
         trimEnd?: number | undefined;
         trimStart?: number | undefined;
-        duration?: number | undefined;
         thumbnailUrl?: string | undefined;
+        duration?: number | undefined;
     }>>;
     status: z.ZodEnum<["pending", "approved", "rejected"]>;
     helpfulCount: z.ZodOptional<z.ZodNumber>;
@@ -93,21 +93,21 @@ export declare const reviewSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     id: string;
     status: "pending" | "approved" | "rejected";
+    rating: 1 | 2 | 3 | 4 | 5;
     userId: string;
-    userName: string;
-    rating: 2 | 1 | 4 | 3 | 5;
     productId: string;
-    createdAt?: string | undefined;
-    updatedAt?: string | undefined;
-    sellerId?: string | undefined;
+    userName: string;
     title?: string | undefined;
     video?: {
         url: string;
         trimEnd?: number | undefined;
         trimStart?: number | undefined;
-        duration?: number | undefined;
         thumbnailUrl?: string | undefined;
+        duration?: number | undefined;
     } | undefined;
+    createdAt?: string | undefined;
+    updatedAt?: string | undefined;
+    sellerId?: string | undefined;
     images?: {
         url: string;
         thumbnailUrl?: string | undefined;
@@ -115,28 +115,28 @@ export declare const reviewSchema: z.ZodObject<{
     productTitle?: string | undefined;
     featured?: boolean | undefined;
     verified?: boolean | undefined;
-    userAvatar?: string | undefined;
     comment?: string | undefined;
+    userAvatar?: string | undefined;
     helpfulCount?: number | undefined;
     reportCount?: number | undefined;
 }, {
     id: string;
     status: "pending" | "approved" | "rejected";
+    rating: 1 | 2 | 3 | 4 | 5;
     userId: string;
-    userName: string;
-    rating: 2 | 1 | 4 | 3 | 5;
     productId: string;
-    createdAt?: string | undefined;
-    updatedAt?: string | undefined;
-    sellerId?: string | undefined;
+    userName: string;
     title?: string | undefined;
     video?: {
         url: string;
         trimEnd?: number | undefined;
         trimStart?: number | undefined;
-        duration?: number | undefined;
         thumbnailUrl?: string | undefined;
+        duration?: number | undefined;
     } | undefined;
+    createdAt?: string | undefined;
+    updatedAt?: string | undefined;
+    sellerId?: string | undefined;
     images?: {
         url: string;
         thumbnailUrl?: string | undefined;
@@ -144,8 +144,8 @@ export declare const reviewSchema: z.ZodObject<{
     productTitle?: string | undefined;
     featured?: boolean | undefined;
     verified?: boolean | undefined;
-    userAvatar?: string | undefined;
     comment?: string | undefined;
+    userAvatar?: string | undefined;
     helpfulCount?: number | undefined;
     reportCount?: number | undefined;
 }>;
@@ -162,22 +162,22 @@ export declare const reviewListParamsSchema: z.ZodObject<{
     sort: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     sort?: string | undefined;
-    perPage?: number | undefined;
-    sellerId?: string | undefined;
     status?: "pending" | "approved" | "rejected" | undefined;
-    userId?: string | undefined;
     page?: number | undefined;
+    perPage?: number | undefined;
+    sellerId?: string | undefined;
     rating?: number | undefined;
+    userId?: string | undefined;
     productId?: string | undefined;
     featured?: boolean | undefined;
 }, {
     sort?: string | undefined;
-    perPage?: number | undefined;
-    sellerId?: string | undefined;
     status?: "pending" | "approved" | "rejected" | undefined;
-    userId?: string | undefined;
     page?: number | undefined;
+    perPage?: number | undefined;
+    sellerId?: string | undefined;
     rating?: number | undefined;
+    userId?: string | undefined;
     productId?: string | undefined;
     featured?: boolean | undefined;
 }>;

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

@@ -1,6 +1,6 @@
 export * from "./firestore";
 import { z } from "zod";
-// ─── Sub-schemas ──────────────────────────────────────────────────────────────
+// --- Sub-schemas --------------------------------------------------------------
 export const reviewStatusSchema = z.enum(["pending", "approved", "rejected"]);
 export const reviewImageSchema = z.object({
     url: z.string(),
@@ -13,7 +13,7 @@ export const reviewVideoSchema = z.object({
     trimStart: z.number().optional(),
     trimEnd: z.number().optional(),
 });
-// ─── Base item schema ─────────────────────────────────────────────────────────
+// --- Base item schema ---------------------------------------------------------
 /**
  * Base Zod schema for a review.
  * Apps can extend this to add their own fields:

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

@@ -3,7 +3,6 @@
  *
  * Server-only entry point — repositories and API route handlers.
  */
-import "server-only";
 export * from "./actions";
 export { ReviewRepository, ReviewsRepository, reviewRepository, } from "./repository/reviews.repository";
 export { GET as reviewsGET, GET, POST } from "./api/route";

package/dist/features/reviews/server.js

@@ -3,7 +3,6 @@
  *
  * Server-only entry point — repositories and API route handlers.
  */
-import "server-only";
 export * from "./actions";
 export { ReviewRepository, ReviewsRepository, reviewRepository, } from "./repository/reviews.repository";
 export { GET as reviewsGET, GET, POST } from "./api/route";

package/dist/features/search/api/route.js

@@ -29,7 +29,7 @@ function numParam(url, key, fallback) {
     const n = v !== null ? Number(v) : NaN;
     return Number.isFinite(n) ? n : fallback;
 }
-// ─── GET /api/search ──────────────────────────────────────────────────────────
+// --- GET /api/search ----------------------------------------------------------
 export async function GET(request) {
     try {
         const url = new URL(request.url);

package/dist/features/search/components/Search.d.ts

@@ -1,4 +1,3 @@
-import "client-only";
 import type { LucideIcon } from "lucide-react";
 import type { NavSuggestionRecord } from "../hooks/useNavSuggestions";
 export interface SearchQuickLink {