npm - @mohasinac/appkit - Versions diffs - 2.1.1 → 2.2.0 - Mend

@@ -0,0 +1,68 @@
+export * from "./firestore";
+import { z } from "zod";
+// ─── Sub-schemas ──────────────────────────────────────────────────────────────
+export const reviewStatusSchema = z.enum(["pending", "approved", "rejected"]);
+export const reviewImageSchema = z.object({
+    url: z.string(),
+    thumbnailUrl: z.string().optional(),
+});
+export const reviewVideoSchema = z.object({
+    url: z.string(),
+    thumbnailUrl: z.string().optional(),
+    duration: z.number().optional(),
+    trimStart: z.number().optional(),
+    trimEnd: z.number().optional(),
+});
+// ─── Base item schema ─────────────────────────────────────────────────────────
+/**
+ * Base Zod schema for a review.
+ * Apps can extend this to add their own fields:
+ *
+ * @example
+ * import { reviewSchema } from "@mohasinac/feat-reviews";
+ *
+ * const myReviewSchema = reviewSchema.extend({
+ *   purchaseVerifiedAt: z.string().optional(),
+ *   loyaltyPointsAwarded: z.number().optional(),
+ * });
+ * type MyReview = z.infer<typeof myReviewSchema>;
+ */
+export const reviewSchema = z.object({
+    id: z.string(),
+    productId: z.string(),
+    productTitle: z.string().optional(),
+    sellerId: z.string().optional(),
+    userId: z.string(),
+    userName: z.string(),
+    userAvatar: z.string().optional(),
+    rating: z.union([
+        z.literal(1),
+        z.literal(2),
+        z.literal(3),
+        z.literal(4),
+        z.literal(5),
+    ]),
+    title: z.string().optional(),
+    comment: z.string().optional(),
+    images: z.array(reviewImageSchema).optional(),
+    video: reviewVideoSchema.optional(),
+    status: reviewStatusSchema,
+    helpfulCount: z.number().optional(),
+    reportCount: z.number().optional(),
+    verified: z.boolean().optional(),
+    featured: z.boolean().optional(),
+    createdAt: z.string().optional(),
+    updatedAt: z.string().optional(),
+});
+/** Base schema for list-query parameters. */
+export const reviewListParamsSchema = z.object({
+    productId: z.string().optional(),
+    userId: z.string().optional(),
+    sellerId: z.string().optional(),
+    status: reviewStatusSchema.optional(),
+    rating: z.coerce.number().optional(),
+    featured: z.coerce.boolean().optional(),
+    page: z.coerce.number().optional(),
+    perPage: z.coerce.number().optional(),
+    sort: z.string().optional(),
+});

@@ -1,49 +1,10 @@
-import { NextResponse } from 'next/server.js';
 /**
- * feat-reviews — Next.js App Router API handler (GET/POST /api/reviews)
+ * @mohasinac/appkit/features/reviews/server
  *
- * 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.
- */
-declare function GET$1(request: Request): Promise<NextResponse>;
-declare const POST: (request: Request, context: {
-    params: Promise<Record<string, string>>;
-}) => Promise<Response>;
-/**
- * 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";
- * ```
+ * Server-only entry point — repositories and API route handlers.
  */
-declare function GET(_request: Request, context: {
-    params: Promise<{
-        id: string;
-    }>;
-}): Promise<NextResponse>;
-declare const reviewItemPATCH: (request: Request, context: {
-    params: Promise<Record<string, string>>;
-}) => Promise<Response>;
-declare const reviewItemDELETE: (request: Request, context: {
-    params: Promise<Record<string, string>>;
-}) => Promise<Response>;
-export { GET$1 as GET, POST, reviewItemDELETE, GET as reviewItemGET, reviewItemPATCH, GET$1 as reviewsGET };
+import "server-only";
+export * from "./actions";
+export { ReviewRepository, ReviewsRepository, reviewRepository, } from "./repository/reviews.repository";
+export { GET as reviewsGET, GET, POST } from "./api/route";
+export { reviewItemGET, reviewItemPATCH, reviewItemDELETE, } from "./api/[id]/route";

@mohasinac/appkit 2.1.1 → 2.2.0