@mohasinac/appkit 2.1.3 → 2.2.0

package/src/features/promotions/components/PromotionsView.tsx

@@ -1,129 +0,0 @@
-import React from "react";
-import { Div, Heading, Section, Text } from "../../../ui";
-
-export interface PromotionProductItem {
-  id: string;
-  title: string;
-  price?: number;
-  currency?: string;
-  image?: string;
-}
-
-export interface PromotionsViewProductSectionProps {
-  title: string;
-  subtitle?: string;
-  /** Render the product grid — use your app's ProductGrid/ProductCard here */
-  renderProducts: () => React.ReactNode;
-  /** If false/undefined, the section is hidden */
-  hasProducts?: boolean;
-}
-
-export function PromotionsViewProductSection({
-  title,
-  subtitle,
-  renderProducts,
-  hasProducts,
-}: PromotionsViewProductSectionProps) {
-  if (!hasProducts) return null;
-  return (
-    <Section>
-      <Div className="mb-6">
-        <Heading level={2}>{title}</Heading>
-        {subtitle && (
-          <Text variant="secondary" className="mt-1">
-            {subtitle}
-          </Text>
-        )}
-      </Div>
-      {renderProducts()}
-    </Section>
-  );
-}
-
-export interface PromotionsViewProps {
-  labels: {
-    exclusiveOffersBadge: string;
-    title: string;
-    subtitle: string;
-    emptyDeals: string;
-    checkBack: string;
-    couponsTitle: string;
-    couponsSubtitle: string;
-    emptyCoupons: string;
-    dealsTitle: string;
-    dealsSubtitle: string;
-    featuredTitle: string;
-    featuredSubtitle: string;
-  };
-  hasContent: boolean;
-  heroBannerClass?: string;
-  /** Render the coupon grid */
-  renderCoupons?: () => React.ReactNode;
-  couponsCount?: number;
-  /** Render the promoted products section */
-  renderDealsSection?: () => React.ReactNode;
-  /** Render the featured products section */
-  renderFeaturedSection?: () => React.ReactNode;
-}
-
-export function PromotionsView({
-  labels,
-  hasContent,
-  heroBannerClass = "bg-gradient-to-br from-rose-500 to-orange-500",
-  renderCoupons,
-  couponsCount = 0,
-  renderDealsSection,
-  renderFeaturedSection,
-}: PromotionsViewProps) {
-  return (
-    <Div className="min-h-screen bg-white dark:bg-slate-900">
-      <Div className={`${heroBannerClass} text-white py-16`}>
-        <Div className="max-w-5xl mx-auto px-4 sm:px-6 lg:px-8 text-center">
-          <Text className="text-white font-medium mb-2 uppercase tracking-widest text-sm">
-            🎉 {labels.exclusiveOffersBadge}
-          </Text>
-          <Heading level={1} variant="none" className="text-white mb-4">
-            {labels.title}
-          </Heading>
-          <Text variant="none" className="text-lg text-white/90 max-w-2xl mx-auto">
-            {labels.subtitle}
-          </Text>
-        </Div>
-      </Div>
-
-      <Div className="max-w-5xl mx-auto px-4 sm:px-6 lg:px-8 py-12 space-y-12">
-        {!hasContent && (
-          <Div className="text-center py-16">
-            <Heading level={2} className="mb-2">{labels.emptyDeals}</Heading>
-            <Text variant="secondary">{labels.checkBack}</Text>
-          </Div>
-        )}
-
-        {hasContent && (
-          <Div className="space-y-12">
-            <Section>
-              <Div className="mb-6">
-                <Heading level={2}>{labels.couponsTitle}</Heading>
-                {couponsCount > 0 && (
-                  <Text variant="secondary" className="mt-1">
-                    {labels.couponsSubtitle}
-                  </Text>
-                )}
-              </Div>
-              {couponsCount > 0 ? (
-                renderCoupons?.()
-              ) : (
-                <Text variant="secondary" size="sm">
-                  {labels.emptyCoupons}
-                </Text>
-              )}
-            </Section>
-
-            {renderDealsSection?.()}
-            {renderFeaturedSection?.()}
-          </Div>
-        )}
-      </Div>
-    </Div>
-  );
-}

package/src/features/promotions/components/index.ts

@@ -1,7 +0,0 @@
-export { CouponCard } from "./CouponCard";
-export { PromotionsView, PromotionsViewProductSection } from "./PromotionsView";
-export type {
-  PromotionsViewProps,
-  PromotionsViewProductSectionProps,
-  PromotionProductItem,
-} from "./PromotionsView";

package/src/features/promotions/hooks/usePromotions.ts

@@ -1,59 +0,0 @@
-"use client";
-
-import { useQuery } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-import type {
-  PromotionsListResponse,
-  PromotionsListParams,
-  CouponItem,
-} from "../types";
-
-export function usePromotions(
-  params: PromotionsListParams = {},
-  opts?: { enabled?: boolean },
-) {
-  const sp = new URLSearchParams();
-  if (params.scope) sp.set("scope", params.scope);
-  if (params.isActive !== undefined)
-    sp.set("isActive", String(params.isActive));
-  if (params.sellerId) sp.set("sellerId", params.sellerId);
-  if (params.page) sp.set("page", String(params.page));
-  if (params.pageSize) sp.set("pageSize", String(params.pageSize));
-  if (params.sort) sp.set("sorts", params.sort);
-  if (params.filters) sp.set("filters", params.filters);
-  const qs = sp.toString();
-
-  const { data, isLoading, error, refetch } = useQuery<PromotionsListResponse>({
-    queryKey: ["promotions", qs],
-    queryFn: () =>
-      apiClient.get<PromotionsListResponse>(
-        `/api/promotions${qs ? `?${qs}` : ""}`,
-      ),
-    enabled: opts?.enabled ?? true,
-  });
-
-  return {
-    promotions: data?.items ?? [],
-    total: data?.total ?? 0,
-    totalPages: data?.totalPages ?? 0,
-    hasMore: data?.hasMore ?? false,
-    isLoading,
-    error: error instanceof Error ? error.message : null,
-    refetch,
-  };
-}
-
-export function useCoupon(code: string, opts?: { enabled?: boolean }) {
-  const { data, isLoading, error } = useQuery<CouponItem | null>({
-    queryKey: ["coupon", code],
-    queryFn: () =>
-      apiClient.get<CouponItem>(`/api/coupons/${encodeURIComponent(code)}`),
-    enabled: (opts?.enabled ?? true) && !!code,
-  });
-
-  return {
-    coupon: data ?? null,
-    isLoading,
-    error: error instanceof Error ? error.message : null,
-  };
-}

package/src/features/promotions/index.ts

@@ -1,7 +0,0 @@
-export * from "./types";
-export * from "./schemas";
-export * from "./columns";
-export * from "./hooks/usePromotions";
-export * from "./components";
-export { PromotionsRepository } from "./repository/promotions.repository";
-export { manifest } from "./manifest";

package/src/features/promotions/manifest.ts

@@ -1,16 +0,0 @@
-import type { FeatureManifest } from "../../contracts";
-
-export const manifest: FeatureManifest = {
-  name: "promotions",
-  i18nNamespace: "promotions",
-  envKeys: [],
-  routes: [
-    { segment: "[locale]/promotions", exports: { default: "PromotionsView" } },
-  ],
-  apiRoutes: [
-    { segment: "api/promotions", methods: ["GET"] },
-    { segment: "api/coupons/validate", methods: ["POST"] },
-    { segment: "api/admin/coupons", methods: ["GET", "POST"] },
-    { segment: "api/admin/coupons/[id]", methods: ["GET", "PATCH", "DELETE"] },
-  ],
-};

package/src/features/promotions/repository/promotions.repository.ts

@@ -1,62 +0,0 @@
-import type {
-  IRepository,
-  PagedResult,
-  SieveQuery,
-} from "../../../contracts";
-import type { CouponItem } from "../types";
-
-export class PromotionsRepository {
-  constructor(private readonly repo: IRepository<CouponItem>) {}
-
-  async findAll(query?: SieveQuery): Promise<PagedResult<CouponItem>> {
-    return this.repo.findAll(query ?? {});
-  }
-
-  async findById(id: string): Promise<CouponItem | null> {
-    return this.repo.findById(id);
-  }
-
-  async findByCode(code: string): Promise<CouponItem | null> {
-    const result = await this.repo.findAll({
-      filters: `code==${code.toUpperCase()},isActive==true`,
-      perPage: 1,
-    });
-    return result.data[0] ?? null;
-  }
-
-  async findActive(page = 1, perPage = 20): Promise<PagedResult<CouponItem>> {
-    return this.repo.findAll({
-      filters: "isActive==true,isPublic==true",
-      sort: "-createdAt",
-      page,
-      perPage,
-    });
-  }
-
-  async findBySeller(
-    sellerId: string,
-    page = 1,
-    perPage = 20,
-  ): Promise<PagedResult<CouponItem>> {
-    return this.repo.findAll({
-      filters: `sellerId==${sellerId}`,
-      sort: "-createdAt",
-      page,
-      perPage,
-    });
-  }
-
-  async create(
-    data: Omit<CouponItem, "id" | "createdAt" | "updatedAt">,
-  ): Promise<CouponItem> {
-    return this.repo.create(data);
-  }
-
-  async update(id: string, data: Partial<CouponItem>): Promise<CouponItem> {
-    return this.repo.update(id, data);
-  }
-
-  async delete(id: string): Promise<void> {
-    return this.repo.delete(id);
-  }
-}

package/src/features/promotions/schemas/index.ts

@@ -1,63 +0,0 @@
-import { z } from "zod";
-
-// ─── Sub-schemas ──────────────────────────────────────────────────────────────
-
-export const couponTypeSchema = z.enum([
-  "percentage",
-  "fixed",
-  "free_shipping",
-  "buy_x_get_y",
-]);
-
-export const couponScopeSchema = z.enum(["admin", "seller"]);
-
-// ─── Base item schema ─────────────────────────────────────────────────────────
-
-/**
- * Base Zod schema for a coupon/promotion.
- * Apps can extend this to add their own fields:
- *
- * @example
- * import { couponItemSchema } from "@mohasinac/feat-promotions";
- *
- * const mySchema = couponItemSchema.extend({
- *   campaignId: z.string().optional(),
- *   affiliateCode: z.string().optional(),
- * });
- */
-export const couponItemSchema = z.object({
-  id: z.string(),
-  code: z.string(),
-  name: z.string(),
-  description: z.string(),
-  type: couponTypeSchema,
-  scope: couponScopeSchema,
-  discountValue: z.number(),
-  minOrderAmount: z.number().optional(),
-  maxDiscountAmount: z.number().optional(),
-  maxUsageCount: z.number().optional(),
-  usageCount: z.number(),
-  perUserLimit: z.number().optional(),
-  buyQuantity: z.number().optional(),
-  getQuantity: z.number().optional(),
-  applicableProductIds: z.array(z.string()).optional(),
-  applicableCategoryIds: z.array(z.string()).optional(),
-  sellerId: z.string().optional(),
-  storeId: z.string().optional(),
-  isPublic: z.boolean(),
-  isActive: z.boolean(),
-  startsAt: z.string().optional(),
-  expiresAt: z.string().optional(),
-  createdAt: z.string(),
-  updatedAt: z.string(),
-});
-
-export const promotionsListParamsSchema = z.object({
-  scope: couponScopeSchema.optional(),
-  isActive: z.coerce.boolean().optional(),
-  sellerId: z.string().optional(),
-  page: z.coerce.number().optional(),
-  pageSize: z.coerce.number().optional(),
-  filters: z.string().optional(),
-  sort: z.string().optional(),
-});

package/src/features/promotions/server.ts

@@ -1,7 +0,0 @@
-/**
- * @mohasinac/appkit/features/promotions/server
- *
- * Server-only entry point for promotions API route handlers.
- */
-
-export { GET as promotionsGET, GET } from "./api/route";

package/src/features/promotions/types/index.ts

@@ -1,65 +0,0 @@
-// ─── Coupon types ─────────────────────────────────────────────────────────────
-
-export type CouponType =
-  | "percentage"
-  | "fixed"
-  | "free_shipping"
-  | "buy_x_get_y";
-export type CouponScope = "admin" | "seller";
-
-export interface CouponItem {
-  id: string;
-  code: string;
-  name: string;
-  description: string;
-  type: CouponType;
-  scope: CouponScope;
-  discountValue: number;
-  minOrderAmount?: number;
-  maxDiscountAmount?: number;
-  maxUsageCount?: number;
-  usageCount: number;
-  perUserLimit?: number;
-  buyQuantity?: number;
-  getQuantity?: number;
-  applicableProductIds?: string[];
-  applicableCategoryIds?: string[];
-  sellerId?: string;
-  storeId?: string;
-  isPublic: boolean;
-  isActive: boolean;
-  startsAt?: string;
-  expiresAt?: string;
-  createdAt: string;
-  updatedAt: string;
-}
-
-// ─── Apply coupon result ──────────────────────────────────────────────────────
-
-export interface ApplyCouponResult {
-  valid: boolean;
-  coupon?: CouponItem;
-  discountAmount: number;
-  message?: string;
-}
-
-// ─── List response ────────────────────────────────────────────────────────────
-
-export interface PromotionsListResponse {
-  items: CouponItem[];
-  total: number;
-  page: number;
-  pageSize: number;
-  totalPages: number;
-  hasMore: boolean;
-}
-
-export interface PromotionsListParams {
-  scope?: CouponScope;
-  isActive?: boolean;
-  sellerId?: string;
-  page?: number;
-  pageSize?: number;
-  filters?: string;
-  sort?: string;
-}

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 });
-  },
-});