@mohasinac/appkit 2.3.1 → 2.4.0

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

@@ -3,7 +3,53 @@ 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" })] }) }) }));
+function sp(params, key) {
+    const v = params[key];
+    return Array.isArray(v) ? v[0] ?? "" : v ?? "";
+}
+function buildReviewFilters(params) {
+    const parts = ["status==approved"];
+    const rating = sp(params, "rating");
+    if (rating) {
+        const values = rating.split("|").filter(Boolean);
+        if (values.length === 1)
+            parts.push(`rating==${values[0]}`);
+        else if (values.length > 1)
+            parts.push(`rating==${values.join("|")}`);
+    }
+    const minVotes = sp(params, "minVotes");
+    if (minVotes)
+        parts.push(`helpfulCount>=${minVotes}`);
+    const maxVotes = sp(params, "maxVotes");
+    if (maxVotes)
+        parts.push(`helpfulCount<=${maxVotes}`);
+    const dateFrom = sp(params, "dateFrom");
+    const dateTo = sp(params, "dateTo");
+    if (dateFrom)
+        parts.push(`createdAt>=${dateFrom}`);
+    if (dateTo)
+        parts.push(`createdAt<=${dateTo}`);
+    const q = sp(params, "q");
+    if (q)
+        parts.push(`productTitle@=*${q}`);
+    return parts.join(",");
+}
+export async function ReviewsIndexPageView({ searchParams = {} }) {
+    const sort = sp(searchParams, "sort") || "-createdAt";
+    const page = Number(sp(searchParams, "page")) || 1;
+    const filters = buildReviewFilters(searchParams);
+    const result = await reviewRepository
+        .listAll({ filters, sorts: sort, page, pageSize: 12 })
+        .catch(() => null);
+    const initialData = result
+        ? {
+            items: result.items,
+            total: result.total,
+            page: result.page,
+            pageSize: result.pageSize,
+            totalPages: result.totalPages,
+            hasMore: result.hasMore,
+        }
+        : undefined;
+    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, { initialData: initialData }), _jsx(AdSlot, { id: "listing-sidebar-bottom", className: "mt-8" })] }) }) }));
 }

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

@@ -1,9 +1,12 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import Link from "next/link";
 import { Div, Heading, Pagination, RichText, Row, Skeleton, Span, Stack, Text, } from "../../../ui";
 import { StarRating } from "../../../ui";
+import { THEME_CONSTANTS } from "../../../tokens";
 import { maskName } from "../../../security";
 import { getDefaultLocale } from "../../../core/baseline-resolver";
 import { normalizeRichTextHtml } from "../../../utils/string.formatter";
+import { ROUTES } from "../../../next";
 export function ReviewCard({ review, className = "" }) {
     const date = review.createdAt
         ? new Date(review.createdAt).toLocaleDateString(getDefaultLocale(), {
@@ -14,7 +17,12 @@ export function ReviewCard({ review, className = "" }) {
         : "";
     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"] }))] }));
+    const reviewHref = String(ROUTES.PUBLIC.REVIEW_DETAIL(review.id));
+    const productHref = review.productId
+        ? String(ROUTES.PUBLIC.PRODUCT_DETAIL(review.productId))
+        : null;
+    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/components/index.d.ts

@@ -10,3 +10,4 @@ export { ReviewsListView } from "./ReviewsListView";
 export type { ReviewsListViewProps } from "./ReviewsListView";
 export { ReviewsIndexListing } from "./ReviewsIndexListing";
 export type { ReviewsIndexListingProps } from "./ReviewsIndexListing";
+export type { ReviewDetailPageViewProps } from "./ReviewDetailPageView";

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

@@ -9,7 +9,7 @@ export function useReviews(params = {}, opts) {
         sp.set("userId", params.userId);
     if (params.status)
         sp.set("status", params.status);
-    if (params.rating)
+    if (params.rating !== undefined)
         sp.set("rating", String(params.rating));
     if (params.featured !== undefined)
         sp.set("featured", String(params.featured));
@@ -19,11 +19,26 @@ export function useReviews(params = {}, opts) {
         sp.set("perPage", String(params.perPage));
     if (params.sort)
         sp.set("sort", params.sort);
+    if (params.q)
+        sp.set("q", params.q);
+    if (params.dateFrom)
+        sp.set("dateFrom", params.dateFrom);
+    if (params.dateTo)
+        sp.set("dateTo", params.dateTo);
+    if (params.minVotes !== undefined)
+        sp.set("minVotes", String(params.minVotes));
+    if (params.maxVotes !== undefined)
+        sp.set("maxVotes", String(params.maxVotes));
+    // General listing mode (no productId)
+    if (!params.productId && !params.userId && !params.storeId) {
+        sp.set("latest", "true");
+    }
     const qs = sp.toString();
     const query = useQuery({
         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,13 +45,18 @@ export interface ReviewListResponse {
 export interface ReviewListParams {
     productId?: string;
     userId?: string;
-    sellerId?: string;
+    storeId?: string;
     status?: ReviewStatus;
-    rating?: number;
+    rating?: number | string;
     featured?: boolean;
     page?: number;
     perPage?: number;
     sort?: string;
+    q?: string;
+    dateFrom?: string;
+    dateTo?: string;
+    minVotes?: number;
+    maxVotes?: number;
 }
 export interface CreateReviewInput {
     productId: string;

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,7 @@
+import type { ScammerDocument } from "../schemas/firestore";
+export interface ScamProfileViewProps {
+    scammer: ScammerDocument;
+    /** When true the contest/report buttons are direct links; otherwise show sign-in prompts. */
+    isAuthenticated: boolean;
+}
+export declare function ScamProfileView({ scammer, isAuthenticated }: ScamProfileViewProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/scams/components/ScamProfileView.js

@@ -0,0 +1,49 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import Link from "next/link";
+import { Shield, Phone, Wallet, Mail, AlertOctagon, Flag, Eye, Users, Calendar, ExternalLink, FileText, MessageSquare, Link2, } from "lucide-react";
+import { Container, Heading, Main, Section, Text, Grid, Stack, Row, Card, CardHeader, CardBody, Badge, Alert, Breadcrumb, EmptyState, } from "../../../ui";
+import { SCAM_PLATFORM_LABELS, SCAMMER_STATUS_LABELS, SOCIAL_PLATFORM_LABELS, CONTEST_TYPE_LABELS, } from "../schemas/firestore";
+import { SCAM_TYPE_LABELS, getScamType } from "../constants/scam-types";
+import { ROUTES } from "../../../next/routing/route-map";
+function formatDate(d) {
+    if (!d)
+        return "";
+    try {
+        return new Date(d).toLocaleDateString("en-IN", { dateStyle: "medium" });
+    }
+    catch {
+        return String(d);
+    }
+}
+function formatPaise(paise) {
+    if (!paise)
+        return "";
+    return `₹${(paise / 100).toLocaleString("en-IN")}`;
+}
+function IdentityChip({ label, value, icon, }) {
+    return (_jsx(Card, { variant: "outlined", padding: "sm", children: _jsxs(Row, { gap: "sm", align: "center", children: [_jsx("span", { className: "text-[color:var(--appkit-color-text-muted,theme(colors.zinc.400))]", children: icon }), _jsxs(Stack, { gap: "none", children: [_jsx(Text, { className: "text-[11px] font-medium uppercase tracking-wide", variant: "secondary", children: label }), _jsx(Text, { className: "truncate text-sm font-medium", children: value })] })] }) }));
+}
+function statusVariant(status) {
+    if (status === "verified")
+        return "danger";
+    if (status === "pending_review")
+        return "warning";
+    return "inactive";
+}
+export function ScamProfileView({ scammer, isAuthenticated }) {
+    const reportHref = String(ROUTES.PUBLIC.SCAM_REPORT);
+    const registryHref = String(ROUTES.PUBLIC.SCAMS);
+    const contestLoginHref = `${String(ROUTES.AUTH.LOGIN)}?redirect=${encodeURIComponent(`/scams/${scammer.id}`)}`;
+    return (_jsxs(Main, { children: [_jsx("div", { className: "border-b appkit-breadcrumb-strip", children: _jsx(Container, { size: "xl", className: "py-3", children: _jsx(Breadcrumb, { items: [
+                            { label: "Home", href: "/" },
+                            { label: "Scam Registry", href: registryHref },
+                            { label: scammer.displayNames[0] ?? "Profile" },
+                        ] }) }) }), _jsx(Section, { className: "py-10", children: _jsx(Container, { size: "xl", children: _jsxs(Grid, { cols: "twoThird", gap: "lg", children: [_jsxs(Stack, { gap: "lg", children: [_jsx(Card, { variant: "elevated", padding: "lg", children: _jsxs(Stack, { gap: "md", children: [_jsxs(Row, { justify: "between", gap: "md", align: "start", className: "flex-wrap", children: [_jsxs(Stack, { gap: "xs", children: [_jsx(Heading, { level: 1, className: "text-2xl font-bold", children: scammer.displayNames[0] }), scammer.displayNames.length > 1 && (_jsxs(Text, { variant: "secondary", className: "text-sm", children: ["Also known as: ", scammer.displayNames.slice(1).join(", ")] }))] }), _jsx(Badge, { variant: statusVariant(scammer.status), children: SCAMMER_STATUS_LABELS[scammer.status] ?? scammer.status })] }), _jsxs(Row, { gap: "xs", wrap: true, children: [_jsx(Badge, { variant: "warning", children: SCAM_TYPE_LABELS[scammer.scamType] ?? scammer.scamType }), _jsxs(Badge, { variant: "default", children: ["via ", SCAM_PLATFORM_LABELS[scammer.scamPlatform] ?? scammer.scamPlatform] }), scammer.tags.includes("repeat_offender") && (_jsx(Badge, { variant: "danger", children: "Repeat Offender" }))] }), _jsxs(Row, { gap: "md", wrap: true, children: [_jsxs(Text, { variant: "secondary", className: "flex items-center gap-1.5 text-sm", children: [_jsx(Eye, { className: "h-4 w-4" }), scammer.views, " views"] }), _jsxs(Text, { variant: "secondary", className: "flex items-center gap-1.5 text-sm", children: [_jsx(Users, { className: "h-4 w-4" }), scammer.incidentCount + 1, " victim", scammer.incidentCount !== 0 ? "s" : "", " reported"] }), _jsxs(Text, { variant: "secondary", className: "flex items-center gap-1.5 text-sm", children: [_jsx(Calendar, { className: "h-4 w-4" }), "Reported ", formatDate(scammer.createdAt)] }), scammer.amountLost ? (_jsxs(Text, { className: "text-sm font-medium text-[color:var(--appkit-color-danger,theme(colors.red.600))]", children: [formatPaise(scammer.amountLost), " lost (primary incident)"] })) : null] })] }) }), (scammer.phones.length > 0 ||
+                                        scammer.upiIds.length > 0 ||
+                                        scammer.emails.length > 0) && (_jsxs(Stack, { gap: "sm", children: [_jsx(Heading, { level: 2, className: "text-base font-semibold", children: "Contact Identifiers" }), _jsxs(Grid, { cols: 2, gap: "sm", children: [scammer.phones.map((p) => (_jsx(IdentityChip, { label: "Phone", value: p, icon: _jsx(Phone, { className: "h-4 w-4" }) }, p))), scammer.upiIds.map((u) => (_jsx(IdentityChip, { label: "UPI ID", value: u, icon: _jsx(Wallet, { className: "h-4 w-4" }) }, u))), scammer.emails.map((e) => (_jsx(IdentityChip, { label: "Email", value: e, icon: _jsx(Mail, { className: "h-4 w-4" }) }, e)))] })] })), scammer.socialMedia.length > 0 && (_jsxs(Stack, { gap: "sm", children: [_jsx(Heading, { level: 2, className: "text-base font-semibold", children: "Social Media Profiles" }), _jsx(Stack, { gap: "xs", children: scammer.socialMedia.map((sm, i) => (_jsxs(Row, { gap: "sm", align: "center", children: [_jsx(ExternalLink, { className: "h-4 w-4 shrink-0 text-[color:var(--appkit-color-text-muted,theme(colors.zinc.400))]" }), _jsxs(Text, { className: "text-sm font-medium", children: [SOCIAL_PLATFORM_LABELS[sm.platform] ?? sm.platform, ":"] }), sm.url ? (_jsx("a", { href: sm.url, target: "_blank", rel: "noopener noreferrer", className: "text-sm text-[color:var(--appkit-color-primary,theme(colors.blue.600))] hover:underline", children: sm.handle })) : (_jsx(Text, { variant: "secondary", className: "text-sm", children: sm.handle }))] }, i))) })] })), scammer.itemInvolved && (_jsxs(Stack, { gap: "xs", children: [_jsx(Heading, { level: 2, className: "text-base font-semibold", children: "Item Involved" }), _jsx(Text, { variant: "secondary", className: "text-sm", children: scammer.itemInvolved })] })), _jsxs(Stack, { gap: "sm", children: [_jsx(Heading, { level: 2, className: "text-base font-semibold", children: "What Happened" }), _jsx(Card, { variant: "flat", padding: "md", children: _jsx(Text, { className: "text-sm leading-relaxed", children: scammer.description }) })] }), (() => {
+                                        const scamTypeDef = getScamType(scammer.scamType);
+                                        if (!scamTypeDef || scamTypeDef.howToAvoid.length === 0)
+                                            return null;
+                                        return (_jsxs(Stack, { gap: "sm", children: [_jsx(Heading, { level: 2, className: "text-base font-semibold", children: "How to Avoid This Scam" }), _jsx(Card, { variant: "flat", padding: "md", children: _jsx(Stack, { gap: "xs", as: "ol", children: scamTypeDef.howToAvoid.map((tip, i) => (_jsxs(Row, { gap: "sm", align: "start", as: "li", children: [_jsx("span", { className: "flex h-5 w-5 shrink-0 items-center justify-center rounded-full bg-[color:var(--appkit-color-success,theme(colors.green.600))]/10 text-xs font-bold text-[color:var(--appkit-color-success,theme(colors.green.700))]", children: i + 1 }), _jsx(Text, { variant: "secondary", className: "text-sm leading-relaxed", children: tip })] }, i))) }) })] }));
+                                    })(), scammer.evidence.length > 0 && (_jsxs(Stack, { gap: "sm", children: [_jsx(Heading, { level: 2, className: "text-base font-semibold", children: "Evidence" }), _jsx(Row, { gap: "sm", wrap: true, children: scammer.evidence.map((url, i) => (_jsx("a", { href: url, target: "_blank", rel: "noopener noreferrer", children: _jsx("img", { src: url, alt: `Evidence ${i + 1}`, className: "h-32 w-auto rounded-lg border object-cover shadow-sm hover:opacity-90" }) }, i))) })] })), _jsxs(Stack, { gap: "sm", children: [_jsx(Heading, { level: 2, className: "text-base font-semibold", children: "Additional Incidents" }), _jsx(EmptyState, { icon: _jsx(FileText, { className: "h-8 w-8" }), title: "No additional incidents yet", description: "Other victims' reports linked to this profile will appear here once verified." })] }), _jsxs(Stack, { gap: "sm", children: [_jsx(Heading, { level: 2, className: "text-base font-semibold", children: "Community Discussion" }), _jsx(EmptyState, { icon: _jsx(MessageSquare, { className: "h-8 w-8" }), title: "No comments yet", description: "Comments and victim testimonials will appear here." })] }), _jsxs(Stack, { gap: "sm", children: [_jsx(Heading, { level: 2, className: "text-base font-semibold", children: "Related Profiles" }), _jsx(EmptyState, { icon: _jsx(Link2, { className: "h-8 w-8" }), title: "No related profiles", description: "Other scammer profiles linked to this person will appear here." })] })] }), _jsxs(Stack, { gap: "md", children: [_jsxs(Card, { variant: "elevated", padding: "md", children: [_jsx(CardHeader, { children: _jsx(Heading, { level: 3, className: "text-sm font-semibold uppercase tracking-wide", children: "Actions" }) }), _jsx(CardBody, { children: _jsxs(Stack, { gap: "sm", children: [isAuthenticated ? (_jsxs(Link, { href: reportHref, className: "appkit-button appkit-button--outline appkit-button--md flex w-full items-center gap-2", children: [_jsx(AlertOctagon, { className: "h-4 w-4 text-[color:var(--appkit-color-danger,theme(colors.red.500))]" }), "Report another incident"] })) : (_jsxs(Link, { href: `${String(ROUTES.AUTH.LOGIN)}?redirect=${encodeURIComponent(reportHref)}`, className: "appkit-button appkit-button--outline appkit-button--md flex w-full items-center gap-2", children: [_jsx(AlertOctagon, { className: "h-4 w-4 text-[color:var(--appkit-color-danger,theme(colors.red.500))]" }), "Sign in to report an incident"] })), isAuthenticated ? (_jsxs(Link, { href: `/scams/${scammer.id}/contest`, className: "appkit-button appkit-button--outline appkit-button--md flex w-full items-center gap-2", children: [_jsx(Flag, { className: "h-4 w-4 text-[color:var(--appkit-color-warning,theme(colors.amber.500))]" }), "Contest this profile"] })) : (_jsxs(Link, { href: contestLoginHref, className: "appkit-button appkit-button--ghost appkit-button--md flex w-full items-center gap-2", children: [_jsx(Flag, { className: "h-4 w-4" }), "Sign in to contest"] })), _jsx(Text, { variant: "secondary", className: "text-xs", children: "All contest submissions are reviewed by our moderation team before any changes are made." })] }) })] }), _jsxs(Card, { variant: "outlined", padding: "md", children: [_jsx(CardHeader, { children: _jsx(Heading, { level: 3, className: "text-sm font-semibold uppercase tracking-wide", children: "Contest Options" }) }), _jsx(CardBody, { children: _jsx(Stack, { gap: "xs", as: "ul", children: Object.entries(CONTEST_TYPE_LABELS).map(([, label]) => (_jsxs(Row, { gap: "sm", align: "start", as: "li", children: [_jsx("span", { className: "mt-1.5 h-1.5 w-1.5 shrink-0 rounded-full bg-[color:var(--appkit-color-border,theme(colors.zinc.300))]" }), _jsx(Text, { variant: "secondary", className: "text-xs", children: label })] }, label))) }) })] }), scammer.verifiedAt && (_jsx(Alert, { variant: "success", compact: true, children: _jsxs(Row, { gap: "xs", align: "center", children: [_jsx(Shield, { className: "h-3.5 w-3.5 shrink-0" }), _jsxs(Text, { className: "text-xs font-medium", children: ["Verified by LetItRip moderation on ", formatDate(scammer.verifiedAt)] })] }) }))] })] }) }) })] }));
+}

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

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