@mohasinac/appkit 2.1.3 → 2.3.0

package/src/features/reviews/api/[id]/route.ts

@@ -1,163 +0,0 @@
-/**
- * feat-reviews — GET / PATCH / DELETE /api/reviews/[id]
- *
- * Pure stub:
- * ```ts
- * // app/api/reviews/[id]/route.ts
- * export { reviewItemGET as GET, reviewItemPATCH as PATCH, reviewItemDELETE as DELETE }
- *   from "@mohasinac/feat-reviews";
- * ```
- */
-
-import { NextResponse } from "next/server.js";
-import { z } from "zod";
-import { getProviders } from "../../../../contracts";
-import { createRouteHandler } from "../../../../next";
-import type { Review } from "../../types/index";
-
-// ──── GET /api/reviews/[id] ───────────────────────────────────────────────────
-
-export async function GET(
-  _request: Request,
-  context: { params: Promise<{ id: string }> },
-): Promise<NextResponse> {
-  try {
-    const { id } = await context.params;
-
-    const { db } = getProviders();
-    if (!db) {
-      return NextResponse.json(
-        { success: false, error: "Database provider not registered" },
-        { status: 503 },
-      );
-    }
-
-    const repo = db.getRepository<Review>("reviews");
-    const review = await repo.findById(id);
-    if (!review) {
-      return NextResponse.json(
-        { success: false, error: "Review not found" },
-        { status: 404 },
-      );
-    }
-
-    return NextResponse.json({ success: true, data: review });
-  } catch (error) {
-    console.error("[feat-reviews] GET /api/reviews/[id] failed", error);
-    return NextResponse.json(
-      { success: false, error: "Failed to fetch review" },
-      { status: 500 },
-    );
-  }
-}
-
-export { GET as reviewItemGET };
-
-// ──── PATCH /api/reviews/[id] ─────────────────────────────────────────────────
-
-const reviewUpdateSchema = z
-  .object({
-    rating: z
-      .union([
-        z.literal(1),
-        z.literal(2),
-        z.literal(3),
-        z.literal(4),
-        z.literal(5),
-      ])
-      .optional(),
-    title: z.string().min(1).max(100).optional(),
-    comment: z.string().min(1).max(2000).optional(),
-    images: z.array(z.string().url()).max(10).optional(),
-    video: z.string().url().optional(),
-    status: z.enum(["pending", "approved", "rejected"]).optional(),
-  })
-  .passthrough();
-
-export const reviewItemPATCH = createRouteHandler({
-  auth: true,
-  schema: reviewUpdateSchema,
-  handler: async ({ request, user, body }) => {
-    const url = new URL(request.url);
-    const segments = url.pathname.split("/");
-    const id = segments[segments.length - 1];
-
-    const { db } = getProviders();
-    if (!db)
-      return NextResponse.json(
-        { success: false, error: "DB not configured" },
-        { status: 503 },
-      );
-
-    const repo = db.getRepository<Review>("reviews");
-    const review = await repo.findById(id);
-    if (!review)
-      return NextResponse.json(
-        { success: false, error: "Review not found" },
-        { status: 404 },
-      );
-
-    const isOwner = review.userId === user!.uid;
-    const isModerator = user!.role === "moderator";
-    const isAdmin = user!.role === "admin";
-
-    if (!isOwner && !isModerator && !isAdmin) {
-      return NextResponse.json(
-        { success: false, error: "Forbidden" },
-        { status: 403 },
-      );
-    }
-
-    // Owners can only edit content fields, not status
-    const patch =
-      isOwner && !isModerator && !isAdmin
-        ? { ...(body as object), status: review.status }
-        : (body as object);
-
-    const updated = await repo.update(id, {
-      ...patch,
-      updatedAt: new Date().toISOString(),
-    } as Partial<Review>);
-    return NextResponse.json({ success: true, data: updated });
-  },
-});
-
-// ──── DELETE /api/reviews/[id] ────────────────────────────────────────────────
-
-export const reviewItemDELETE = createRouteHandler({
-  auth: true,
-  handler: async ({ request, user }) => {
-    const url = new URL(request.url);
-    const segments = url.pathname.split("/");
-    const id = segments[segments.length - 1];
-
-    const { db } = getProviders();
-    if (!db)
-      return NextResponse.json(
-        { success: false, error: "DB not configured" },
-        { status: 503 },
-      );
-
-    const repo = db.getRepository<Review>("reviews");
-    const review = await repo.findById(id);
-    if (!review)
-      return NextResponse.json(
-        { success: false, error: "Review not found" },
-        { status: 404 },
-      );
-
-    const isOwner = review.userId === user!.uid;
-    const isModerator = user!.role === "moderator";
-    const isAdmin = user!.role === "admin";
-
-    if (!isOwner && !isModerator && !isAdmin) {
-      return NextResponse.json(
-        { success: false, error: "Forbidden" },
-        { status: 403 },
-      );
-    }
-
-    await repo.delete(id);
-    return NextResponse.json({ success: true });
-  },
-});

package/src/features/reviews/api/route.ts

@@ -1,216 +0,0 @@
-/**
- * feat-reviews — Next.js App Router API handler (GET/POST /api/reviews)
- *
- * 2-line stub for GET:
- * ```ts
- * // app/api/reviews/route.ts
- * export { GET, POST } from "@mohasinac/feat-reviews";
- * ```
- *
- * Query modes for GET:
- *   ?featured=true         → returns flat Review[] (for testimonial sections)
- *   ?latest=true           → paginated approved reviews, no productId required
- *   ?productId=<id>        → paginated + aggregate stats (averageRating, ratingDistribution)
- *
- * POST creates a new review; requires authentication.
- */
-
-import { NextResponse } from "next/server.js";
-import { z } from "zod";
-import { getProviders } from "../../../contracts";
-import { createRouteHandler } from "../../../next";
-import type { Review, ReviewListResponse } from "../types/index";
-
-function param(url: URL, key: string): string | null {
-  return url.searchParams.get(key);
-}
-
-function numParam(url: URL, key: string, fallback: number): number {
-  const v = url.searchParams.get(key);
-  const n = v !== null ? Number(v) : NaN;
-  return Number.isFinite(n) ? n : fallback;
-}
-
-function computeAggregates(reviews: Review[]): {
-  averageRating: number;
-  ratingDistribution: Record<number, number>;
-} {
-  const dist: Record<number, number> = { 1: 0, 2: 0, 3: 0, 4: 0, 5: 0 };
-  let total = 0;
-  let count = 0;
-  for (const r of reviews) {
-    if (r.status === "approved") {
-      dist[r.rating] = (dist[r.rating] ?? 0) + 1;
-      total += r.rating;
-      count++;
-    }
-  }
-  return {
-    averageRating: count > 0 ? total / count : 0,
-    ratingDistribution: dist,
-  };
-}
-
-export async function GET(request: Request): Promise<NextResponse> {
-  try {
-    const url = new URL(request.url);
-    const featured = param(url, "featured") === "true";
-    const latest = param(url, "latest") === "true";
-    const page = numParam(url, "page", 1);
-    const pageSize = numParam(url, "pageSize", 10);
-    const sort = param(url, "sorts") ?? param(url, "sort") ?? "-createdAt";
-
-    const { db } = getProviders();
-    if (!db) {
-      return NextResponse.json(
-        { success: false, error: "Database provider not registered" },
-        { status: 503 },
-      );
-    }
-
-    const repo = db.getRepository<Review>("reviews");
-
-    // ── ?featured=true ────────────────────────────────────────────────────────
-    // Returns flat Review[] for homepage testimonial sections.
-    if (featured) {
-      const result = await repo.findAll({
-        filters: "featured==true,status==approved",
-        sort,
-        perPage: Math.min(pageSize, 50),
-      });
-      const response = NextResponse.json({ success: true, data: result.data });
-      response.headers.set(
-        "Cache-Control",
-        "public, max-age=300, s-maxage=600, stale-while-revalidate=120",
-      );
-      return response;
-    }
-
-    // ── ?latest=true ──────────────────────────────────────────────────────────
-    // Paginated latest approved reviews, no productId required.
-    if (latest) {
-      const latestPageSize = numParam(url, "pageSize", 24);
-      const result = await repo.findAll({
-        filters: "status==approved",
-        sort,
-        page,
-        perPage: latestPageSize,
-      });
-      const totalPages = Math.max(1, Math.ceil(result.total / latestPageSize));
-      const body: ReviewListResponse = {
-        items: result.data,
-        total: result.total,
-        page: result.page,
-        pageSize: latestPageSize,
-        totalPages,
-        hasMore: result.page < totalPages,
-      };
-      const response = NextResponse.json({ success: true, data: body });
-      response.headers.set(
-        "Cache-Control",
-        "public, max-age=120, s-maxage=300, stale-while-revalidate=60",
-      );
-      return response;
-    }
-
-    // ── ?productId=<id> ───────────────────────────────────────────────────────
-    // Paginated reviews for a product with aggregate rating stats.
-    const productId = param(url, "productId");
-    if (!productId) {
-      return NextResponse.json(
-        { success: false, error: "productId query parameter is required" },
-        { status: 400 },
-      );
-    }
-
-    // Fetch all approved reviews for aggregate computation (no pagination)
-    const allResult = await repo.findAll({
-      filters: `productId==${productId},status==approved`,
-      perPage: 1000,
-    });
-    const { averageRating, ratingDistribution } = computeAggregates(
-      allResult.data,
-    );
-
-    // Fetch the current page for display
-    const pagedResult = await repo.findAll({
-      filters: `productId==${productId},status==approved`,
-      sort,
-      page,
-      perPage: pageSize,
-    });
-
-    const totalPages = Math.max(1, Math.ceil(pagedResult.total / pageSize));
-    const body: ReviewListResponse = {
-      items: pagedResult.data,
-      total: pagedResult.total,
-      page: pagedResult.page,
-      pageSize,
-      totalPages,
-      hasMore: pagedResult.page < totalPages,
-      averageRating,
-      ratingDistribution,
-    };
-
-    const response = NextResponse.json({ success: true, data: body });
-    response.headers.set(
-      "Cache-Control",
-      "public, max-age=120, s-maxage=300, stale-while-revalidate=60",
-    );
-    return response;
-  } catch (error) {
-    console.error("[feat-reviews] GET /api/reviews failed", error);
-    return NextResponse.json(
-      { success: false, error: "Failed to fetch reviews" },
-      { status: 500 },
-    );
-  }
-}
-
-// ---------------------------------------------------------------------------
-// POST /api/reviews — create a new review (authenticated)
-// ---------------------------------------------------------------------------
-
-const reviewCreateSchema = z
-  .object({
-    productId: z.string().min(1),
-    rating: z.union([
-      z.literal(1),
-      z.literal(2),
-      z.literal(3),
-      z.literal(4),
-      z.literal(5),
-    ]),
-    title: z.string().min(1).max(100).optional(),
-    comment: z.string().min(1).max(2000).optional(),
-    images: z.array(z.string().url()).max(10).optional(),
-    video: z.string().url().optional(),
-  })
-  .passthrough();
-
-export const POST = createRouteHandler({
-  auth: true,
-  schema: reviewCreateSchema,
-  handler: async ({ user, body }) => {
-    const { db } = getProviders();
-    if (!db) {
-      return NextResponse.json(
-        { success: false, error: "DB not configured" },
-        { status: 503 },
-      );
-    }
-
-    const repo = db.getRepository<Review>("reviews");
-    const now = new Date().toISOString();
-
-    const created = await repo.create({
-      ...(body as object),
-      userId: user!.uid,
-      status: "pending",
-      createdAt: now,
-      updatedAt: now,
-    } as unknown as Review);
-
-    return NextResponse.json({ success: true, data: created }, { status: 201 });
-  },
-});

package/src/features/reviews/columns/index.ts

@@ -1,57 +0,0 @@
-import type { TableColumn, ColumnExtensionOpts } from "../../../contracts";
-import type { Review } from "../types";
-
-/**
- * Default admin column definitions for a review table.
- *
- * @example
- * const columns = buildReviewColumns<MyReview>({
- *   extras: [{ key: "loyaltyPointsAwarded", header: "Points", render: (r) => r.loyaltyPointsAwarded ?? "—" }],
- * });
- */
-export const reviewAdminColumns: TableColumn<Review>[] = [
-  { key: "userName", header: "User" },
-  { key: "productTitle", header: "Product", sortable: true },
-  {
-    key: "rating",
-    header: "Rating",
-    sortable: true,
-    render: (r) => `${"★".repeat(r.rating)}${"☆".repeat(5 - r.rating)}`,
-  },
-  { key: "title", header: "Title" },
-  { key: "status", header: "Status", sortable: true },
-  {
-    key: "verified",
-    header: "Verified",
-    render: (r) => (r.verified ? "Yes" : "No"),
-  },
-  {
-    key: "featured",
-    header: "Featured",
-    render: (r) => (r.featured ? "Yes" : "No"),
-  },
-  {
-    key: "helpfulCount",
-    header: "Helpful",
-    sortable: true,
-    render: (r) => r.helpfulCount?.toLocaleString() ?? "0",
-  },
-  { key: "createdAt", header: "Created", sortable: true },
-];
-
-/**
- * Build a merged column list from the base review columns.
- */
-export function buildReviewColumns<T extends Review = Review>(
-  opts?: ColumnExtensionOpts<T>,
-): TableColumn<T>[] {
-  const base = reviewAdminColumns as TableColumn<T>[];
-  const omit = new Set(opts?.omit ?? []);
-  const cols = base
-    .filter((col) => !omit.has(col.key))
-    .map((col) => {
-      const ovr = opts?.overrides?.[col.key];
-      return ovr ? { ...col, ...ovr } : col;
-    });
-  return opts?.extras ? [...cols, ...opts.extras] : cols;
-}

package/src/features/reviews/components/ReviewModal.tsx

@@ -1,133 +0,0 @@
-"use client";
-
-import { useState } from "react";
-import {
-  Button,
-  Div,
-  Heading,
-  IconButton,
-  Modal,
-  Row,
-  Text,
-} from "../../../ui";
-import { StarRating } from "../../../ui";
-import type { Review } from "../types";
-
-// ─── ViewReviewModal ──────────────────────────────────────────────────────────
-
-export interface ViewReviewModalProps {
-  review: Review | null;
-  isOpen: boolean;
-  onClose: () => void;
-}
-
-/**
- * ViewReviewModal — full review details in a Modal overlay.
- * Shows all images, the full comment, and seller response if present.
- */
-export function ViewReviewModal({
-  review,
-  isOpen,
-  onClose,
-}: ViewReviewModalProps) {
-  const [lightboxIdx, setLightboxIdx] = useState<number | null>(null);
-
-  if (!review) return null;
-
-  const date = review.createdAt
-    ? new Date(review.createdAt).toLocaleDateString("en-US", {
-        year: "numeric",
-        month: "long",
-        day: "numeric",
-      })
-    : "";
-
-  return (
-    <Modal isOpen={isOpen} onClose={onClose} title="Review Details">
-      <Div className="space-y-4">
-        {/* Author + rating */}
-        <Div className="flex items-center gap-3">
-          {review.userAvatar ? (
-            <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})` }}
-            />
-          ) : (
-            <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">
-              {review.userName.charAt(0).toUpperCase()}
-            </Div>
-          )}
-          <Div>
-            <Div className="flex items-center gap-2">
-              <Text className="font-medium text-neutral-900 dark:text-white">
-                {review.userName}
-              </Text>
-              {review.verified && (
-                <Text className="text-xs text-green-600 dark:text-green-400">
-                  ✓ Verified purchase
-                </Text>
-              )}
-            </Div>
-            <Div className="flex items-center gap-2 mt-0.5">
-              <StarRating value={review.rating} size="sm" readOnly />
-              {date && (
-                <Text className="text-xs text-neutral-400 dark:text-zinc-500">
-                  {date}
-                </Text>
-              )}
-            </Div>
-          </Div>
-        </Div>
-
-        {/* Title + comment */}
-        {review.title && (
-          <Heading
-            level={4}
-            className="font-semibold text-neutral-900 dark:text-white"
-          >
-            {review.title}
-          </Heading>
-        )}
-        {review.comment && (
-          <Text className="text-sm leading-relaxed text-neutral-600 dark:text-zinc-400">
-            {review.comment}
-          </Text>
-        )}
-
-        {/* Images */}
-        {review.images && review.images.length > 0 && (
-          <Row wrap gap="sm">
-            {review.images.map((img, i) => (
-              <IconButton
-                key={i}
-                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={<Div />}
-              />
-            ))}
-          </Row>
-        )}
-
-        {/* Helpful */}
-        {(review.helpfulCount ?? 0) > 0 && (
-          <Text className="text-xs text-neutral-400 dark:text-zinc-500">
-            {review.helpfulCount} people found this helpful
-          </Text>
-        )}
-
-        <Div className="flex justify-end pt-2">
-          <Button variant="ghost" onClick={onClose}>
-            Close
-          </Button>
-        </Div>
-      </Div>
-    </Modal>
-  );
-}

package/src/features/reviews/components/ReviewSummary.tsx

@@ -1,82 +0,0 @@
-"use client";
-
-import React from "react";
-import { Div, Span, Text } from "../../../ui";
-import { StarRating } from "../../../ui";
-
-// ─── ReviewSummary ────────────────────────────────────────────────────────────
-
-export interface ReviewSummaryProps {
-  averageRating: number;
-  totalReviews: number;
-  /** Map of star value (1–5) → count. Example: { 5: 40, 4: 20, 3: 10, 2: 5, 1: 2 } */
-  distribution: Record<number, number>;
-  className?: string;
-}
-
-/**
- * ReviewSummary — aggregate rating block with breakdown bars.
- *
- * Shows:
- *  - Large average score + star display
- *  - "N reviews" count
- *  - Per-star percentage bars (5★ ... 1★)
- */
-export function ReviewSummary({
-  averageRating,
-  totalReviews,
-  distribution,
-  className = "",
-}: ReviewSummaryProps) {
-  const stars = [5, 4, 3, 2, 1];
-
-  return (
-    <Div
-      className={`flex flex-col gap-4 sm:flex-row sm:items-center sm:gap-8 ${className}`}
-    >
-      {/* Score block */}
-      <Div className="flex flex-col items-center gap-1 sm:items-start">
-        <Span className="text-5xl font-bold leading-none text-neutral-900 dark:text-white">
-          {averageRating.toFixed(1)}
-        </Span>
-        <StarRating value={averageRating} size="md" readOnly />
-        <Text className="text-sm text-neutral-500 dark:text-zinc-400">
-          {totalReviews.toLocaleString()} review
-          {totalReviews !== 1 ? "s" : ""}
-        </Text>
-      </Div>
-
-      {/* Breakdown bars */}
-      <Div className="flex flex-1 flex-col gap-2">
-        {stars.map((star) => {
-          const count = distribution[star] ?? 0;
-          const pct = totalReviews > 0 ? Math.round((count / totalReviews) * 100) : 0;
-          return (
-            <Div key={star} className="flex items-center gap-2">
-              <Span className="w-4 text-right text-xs font-medium text-neutral-600 dark:text-zinc-400 tabular-nums">
-                {star}
-              </Span>
-              <Span className="text-yellow-400 text-xs">★</Span>
-              <Div
-                className="flex-1 h-2 rounded-full bg-neutral-100 dark:bg-zinc-800 overflow-hidden"
-                role="progressbar"
-                aria-valuenow={pct}
-                aria-valuemin={0}
-                aria-valuemax={100}
-                aria-label={`${star} star: ${pct}%`}
-              >
-                <Div
-                  className="h-full rounded-full bg-yellow-400 transition-all duration-300"
-                  style={{ width: `${pct}%` }}
-                />
-              </Div>
-              <Span className="w-8 text-right text-xs text-neutral-400 dark:text-zinc-500 tabular-nums">
-                {pct}%
-              </Span>
-            </Div>
-          );
-        })}
-      </Div>
-    </Div>
-  );
-}