@mohasinac/appkit 2.1.3 → 2.3.0

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

@@ -1,105 +0,0 @@
-/**
- * feat-promotions — Next.js App Router API handler (GET /api/promotions)
- *
- * 2-line stub:
- * ```ts
- * // app/api/promotions/route.ts
- * export { GET } from "@mohasinac/feat-promotions";
- * ```
- *
- * Returns a paginated list of coupons/promotions filtered by active status
- * and/or public visibility. Suitable for a generic coupon listing page.
- *
- * Note: letitrip.in's /api/promotions endpoint returns a richer combined
- * response (promoted products + featured products + active coupons). Projects
- * needing that aggregation should keep a local route handler.
- *
- * Requires `db` registered in providers.config via `registerProviders()`.
- * Collection: "coupons"
- */
-
-import { NextResponse } from "next/server.js";
-import { getProviders } from "../../../contracts";
-import type { CouponItem, PromotionsListResponse } 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;
-}
-
-// ─── GET /api/promotions ──────────────────────────────────────────────────────
-// Query params:
-//   isActive  — "true" | "false" (default: "true")
-//   isPublic  — "true" filters to public coupons only
-//   scope     — "admin" | "seller"
-//   sellerId  — filter seller-scoped coupons
-//   sort      — Sieve sort field (default: "-createdAt")
-//   page / pageSize — pagination
-export async function GET(request: Request): Promise<NextResponse> {
-  try {
-    const url = new URL(request.url);
-    const sort = param(url, "sort") ?? "-createdAt";
-    const page = numParam(url, "page", 1);
-    const pageSize = numParam(url, "pageSize", 20);
-
-    const parts: string[] = [];
-
-    const isActive = param(url, "isActive") ?? "true";
-    parts.push(`isActive==${isActive}`);
-
-    const isPublic = param(url, "isPublic");
-    if (isPublic !== null) parts.push(`isPublic==${isPublic}`);
-
-    const scope = param(url, "scope");
-    if (scope) parts.push(`scope==${scope}`);
-
-    const sellerId = param(url, "sellerId");
-    if (sellerId) parts.push(`sellerId==${sellerId}`);
-
-    const filters = parts.join(",");
-
-    const { db } = getProviders();
-    if (!db) {
-      return NextResponse.json(
-        { success: false, error: "Database provider not registered" },
-        { status: 503 },
-      );
-    }
-
-    const repo = db.getRepository<CouponItem>("coupons");
-    const result = await repo.findAll({
-      filters,
-      sort,
-      page,
-      perPage: pageSize,
-    });
-
-    const totalPages = Math.max(1, Math.ceil(result.total / pageSize));
-    const body: PromotionsListResponse = {
-      items: result.data,
-      total: result.total,
-      page: result.page,
-      pageSize,
-      totalPages,
-      hasMore: result.page < totalPages,
-    };
-
-    const response = NextResponse.json({ success: true, data: body });
-    response.headers.set(
-      "Cache-Control",
-      "public, max-age=60, s-maxage=120, stale-while-revalidate=60",
-    );
-    return response;
-  } catch (error) {
-    console.error("[feat-promotions] GET /api/promotions failed", error);
-    return NextResponse.json(
-      { success: false, error: "Failed to fetch promotions" },
-      { status: 500 },
-    );
-  }
-}

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

@@ -1,60 +0,0 @@
-import type { TableColumn, ColumnExtensionOpts } from "../../../contracts";
-import type { CouponItem } from "../types";
-
-/**
- * Default admin column definitions for a coupons/promotions table.
- *
- * @example
- * const columns = buildCouponColumns<MyCoupon>({
- *   extras: [{ key: "campaignId", header: "Campaign", render: (c) => c.campaignId ?? "—" }],
- * });
- */
-export const couponAdminColumns: TableColumn<CouponItem>[] = [
-  { key: "code", header: "Code", sortable: true },
-  { key: "name", header: "Name", sortable: true },
-  { key: "type", header: "Type", sortable: true },
-  { key: "scope", header: "Scope" },
-  {
-    key: "discountValue",
-    header: "Discount",
-    render: (c) =>
-      c.type === "percentage"
-        ? `${c.discountValue}%`
-        : c.discountValue.toLocaleString(),
-  },
-  {
-    key: "usageCount",
-    header: "Used",
-    sortable: true,
-    render: (c) =>
-      c.maxUsageCount != null
-        ? `${c.usageCount} / ${c.maxUsageCount}`
-        : c.usageCount.toLocaleString(),
-  },
-  {
-    key: "isActive",
-    header: "Active",
-    render: (c) => (c.isActive ? "Yes" : "No"),
-  },
-  {
-    key: "isPublic",
-    header: "Public",
-    render: (c) => (c.isPublic ? "Yes" : "No"),
-  },
-  { key: "expiresAt", header: "Expires", sortable: true },
-  { key: "createdAt", header: "Created", sortable: true },
-];
-
-export function buildCouponColumns<T extends CouponItem = CouponItem>(
-  opts?: ColumnExtensionOpts<T>,
-): TableColumn<T>[] {
-  const base = couponAdminColumns 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/promotions/components/CouponCard.tsx

@@ -1,79 +0,0 @@
-import { Button, Div, Row, Span, Text } from "../../../ui";
-import type { CouponItem, CouponType } from "../types";
-
-const TYPE_COLORS: Record<CouponType, string> = {
-  percentage: "bg-purple-50 border-purple-200 text-purple-800",
-  fixed: "bg-green-50 border-green-200 text-green-800",
-  free_shipping: "bg-blue-50 border-blue-200 text-blue-800",
-  buy_x_get_y: "bg-orange-50 border-orange-200 text-orange-800",
-};
-
-interface CouponCardProps {
-  coupon: CouponItem;
-  labels?: {
-    copy?: string;
-    copied?: string;
-    expires?: string;
-    minOrder?: string;
-    off?: string;
-    freeShipping?: string;
-  };
-  onCopy?: (code: string) => void;
-  className?: string;
-}
-
-export function CouponCard({
-  coupon,
-  labels = {},
-  onCopy,
-  className = "",
-}: CouponCardProps) {
-  const colorClass = TYPE_COLORS[coupon.type] ?? TYPE_COLORS.percentage;
-  const expiry = coupon.expiresAt
-    ? new Date(coupon.expiresAt).toLocaleDateString()
-    : null;
-
-  const discountLabel =
-    coupon.type === "percentage"
-      ? `${coupon.discountValue}% ${labels.off ?? "OFF"}`
-      : coupon.type === "fixed"
-        ? `${coupon.discountValue} ${labels.off ?? "OFF"}`
-        : (labels.freeShipping ?? "Free Shipping");
-
-  return (
-    <Div className={`rounded-xl border-2 p-4 ${colorClass} ${className}`}>
-      <Div className="flex items-start justify-between gap-2 mb-2">
-        <Div>
-          <Text className="text-xl font-bold tracking-wide">
-            {discountLabel}
-          </Text>
-          <Text className="text-sm mt-0.5">{coupon.name}</Text>
-        </Div>
-        <Button
-          type="button"
-          onClick={() => onCopy?.(coupon.code)}
-          className="shrink-0 rounded-lg border border-current px-3 py-1.5 text-xs font-semibold hover:opacity-80 transition-opacity"
-        >
-          {coupon.code} — {labels.copy ?? "Copy"}
-        </Button>
-      </Div>
-
-      {coupon.description && (
-        <Text className="text-xs opacity-70 mb-2">{coupon.description}</Text>
-      )}
-
-      <Row wrap gap="sm" className="text-xs opacity-70">
-        {coupon.minOrderAmount && (
-          <Span>
-            {labels.minOrder ?? "Min order"}: {coupon.minOrderAmount}
-          </Span>
-        )}
-        {expiry && (
-          <Span>
-            {labels.expires ?? "Expires"}: {expiry}
-          </Span>
-        )}
-      </Row>
-    </Div>
-  );
-}

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/messages/en.json

@@ -1,20 +0,0 @@
-{
-  "card": {
-    "copy": "Copy",
-    "copied": "Copied!",
-    "expires": "Expires",
-    "minOrder": "Min order",
-    "off": "OFF",
-    "freeShipping": "Free Shipping"
-  },
-  "type": {
-    "percentage": "Percentage",
-    "fixed": "Fixed",
-    "free_shipping": "Free Shipping",
-    "buy_x_get_y": "Buy X Get Y"
-  },
-  "list": {
-    "title": "Promotions & Coupons",
-    "empty": "No active promotions right now."
-  }
-}

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