Reviews

npm install @86d-store/reviews

import reviews from "@86d-store/reviews";
import { createModuleClient } from "@86d-store/core";

const client = createModuleClient([
  reviews({
    autoApprove: "false", // default: requires moderation
  }),
]);

createReview()         → pending
updateReviewStatus()   → approved  (publicly visible)
updateReviewStatus()   → rejected  (hidden from store)

{
  "productId": "prod_abc",
  "authorName": "Verified shopper",
  "authorEmail": "reviewer_contact_here",
  "rating": 5,
  "title": "Excellent product!",
  "body": "Exactly what I needed.",
  "images": [
    { "url": "https://example.com/photo.jpg", "caption": "Front view" }
  ]
}

{
  "reviews": [{ "id": "review_1234567890123", "rating": 5 }],
  "summary": {
    "average": 4.3,
    "count": 12,
    "distribution": { "1": 0, "2": 1, "3": 2, "4": 4, "5": 5 }
  }
}

{
  "reason": "spam",
  "details": "This review is advertising another product"
}

<ReviewsSummary productId={product.id} />

<ProductReviews productId={product.id} />

<ReviewForm productId={product.id} />

<ReviewCard />

<StarDisplay />

<StarPicker />

<DistributionBars />

type ReviewStatus = "pending" | "approved" | "rejected";
type ReportStatus = "pending" | "resolved" | "dismissed";
type ReviewSortBy = "recent" | "oldest" | "highest" | "lowest" | "helpful";

interface ReviewImage {
  url: string;
  caption?: string;
}

interface Review {
  id: string;
  productId: string;
  customerId?: string;
  authorName: string;
  authorEmail: string;
  rating: number;          // 1 to 5
  title?: string;
  body: string;
  status: ReviewStatus;
  isVerifiedPurchase: boolean;
  helpfulCount: number;
  images?: ReviewImage[];
  merchantResponse?: string;
  merchantResponseAt?: Date;
  moderationNote?: string;
  createdAt: Date;
  updatedAt: Date;
}

interface RatingSummary {
  average: number;
  count: number;
  distribution: Record<string, number>;
}

interface ReviewReport {
  id: string;
  reviewId: string;
  reporterId?: string;
  reason: string;
  details?: string;
  status: ReportStatus;
  createdAt: Date;
}