@mohasinac/appkit 2.1.3 → 2.3.0

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

@@ -1,200 +0,0 @@
-/**
- * feat-products — single-item route handlers (GET/PATCH/DELETE /api/products/[id])
- *
- * Consuming projects can create a 2-line stub:
- *
- * ```ts
- * // app/api/products/[id]/route.ts
- * export { productItemGET as GET, productItemPATCH as PATCH, productItemDELETE as DELETE }
- *   from "@mohasinac/feat-products";
- * ```
- */
-
-import { NextResponse } from "next/server.js";
-import { z } from "zod";
-import { getProviders } from "../../../../contracts";
-import { createRouteHandler } from "../../../../next";
-import type { ProductItem } from "../../types/index";
-import { mediaFieldSchema } from "../../../media/types/index";
-
-type RouteContext = { params: Promise<{ id: string }> };
-
-type ProductRecord = ProductItem & {
-  sellerId?: string;
-};
-
-function getRepo() {
-  const { db } = getProviders();
-  if (!db) return null;
-  return db.getRepository<ProductRecord>("products");
-}
-
-const productUpdateSchema = z
-  .object({
-    title: z.string().min(1).max(200).optional(),
-    description: z.string().max(10000).optional(),
-    price: z.number().positive().optional(),
-    originalPrice: z.number().positive().optional(),
-    currency: z.string().length(3).optional(),
-    category: z.string().optional(),
-    status: z
-      .enum([
-        "draft",
-        "published",
-        "archived",
-        "sold",
-        "discontinued",
-        "out_of_stock",
-      ])
-      .optional(),
-    mainImage: z.string().optional(),
-    images: z.array(z.any()).optional(),
-    tags: z.array(z.string()).optional(),
-    featured: z.boolean().optional(),
-    isPromoted: z.boolean().optional(),
-    isAuction: z.boolean().optional(),
-    isPreOrder: z.boolean().optional(),
-    listingType: z
-      .enum(["fixed", "standard", "auction", "pre-order"])
-      .optional(),
-    media: z.array(mediaFieldSchema).optional(),
-  })
-  .passthrough();
-
-// ─── GET /api/products/[id] ───────────────────────────────────────────────────
-
-export async function GET(
-  _request: Request,
-  context: RouteContext,
-): Promise<NextResponse> {
-  try {
-    const { id } = await context.params;
-
-    const repo = getRepo();
-    if (!repo) {
-      return NextResponse.json(
-        { success: false, error: "Database provider not registered" },
-        { status: 503 },
-      );
-    }
-
-    // Support both Firestore document ID and URL slug
-    let item = await repo.findById(id);
-    if (!item) {
-      // Slug fallback: search by slug==id, status==published
-      const slugResult = await repo.findAll({
-        filters: `slug==${id},status==published`,
-        perPage: 1,
-      });
-      item = slugResult.data[0] ?? null;
-    }
-    if (!item) {
-      return NextResponse.json(
-        { success: false, error: "Product not found" },
-        { status: 404 },
-      );
-    }
-
-    return NextResponse.json({ success: true, data: item });
-  } catch (error) {
-    console.error("[feat-products] GET /api/products/[id] failed", error);
-    return NextResponse.json(
-      { success: false, error: "Failed to fetch product" },
-      { status: 500 },
-    );
-  }
-}
-
-// ─── PATCH /api/products/[id] ─────────────────────────────────────────────────
-// Auth required; the caller must be the owner, a moderator, or an admin.
-
-export const PATCH = createRouteHandler<
-  z.infer<typeof productUpdateSchema>,
-  { id: string }
->({
-  auth: true,
-  schema: productUpdateSchema,
-  handler: async ({ user, body, params }) => {
-    const { id } = params!;
-    const repo = getRepo();
-    if (!repo) {
-      return NextResponse.json(
-        { success: false, error: "Database provider not registered" },
-        { status: 503 },
-      );
-    }
-
-    const product = await repo.findById(id);
-    if (!product) {
-      return NextResponse.json(
-        { success: false, error: "Product not found" },
-        { status: 404 },
-      );
-    }
-
-    const isOwner = product.sellerId === user?.uid;
-    const isModerator = user?.role === "moderator";
-    const isAdmin = user?.role === "admin";
-
-    if (!isOwner && !isModerator && !isAdmin) {
-      return NextResponse.json(
-        { success: false, error: "Not authorized to update this product" },
-        { status: 403 },
-      );
-    }
-
-    const updated = await repo.update(id, {
-      ...(body as Partial<ProductItem>),
-      updatedAt: new Date().toISOString(),
-    });
-    return NextResponse.json({ success: true, data: updated });
-  },
-});
-
-// ─── DELETE /api/products/[id] ────────────────────────────────────────────────
-// Soft-delete (sets status to "discontinued"). Auth required.
-
-export const DELETE = createRouteHandler<never, { id: string }>({
-  auth: true,
-  handler: async ({ user, params }) => {
-    const { id } = params!;
-    const repo = getRepo();
-    if (!repo) {
-      return NextResponse.json(
-        { success: false, error: "Database provider not registered" },
-        { status: 503 },
-      );
-    }
-
-    const product = await repo.findById(id);
-    if (!product) {
-      return NextResponse.json(
-        { success: false, error: "Product not found" },
-        { status: 404 },
-      );
-    }
-
-    const isOwner = product.sellerId === user?.uid;
-    const isModerator = user?.role === "moderator";
-    const isAdmin = user?.role === "admin";
-
-    if (!isOwner && !isModerator && !isAdmin) {
-      return NextResponse.json(
-        { success: false, error: "Not authorized to delete this product" },
-        { status: 403 },
-      );
-    }
-
-    await repo.update(id, {
-      status: "discontinued" as ProductItem["status"],
-      updatedAt: new Date().toISOString(),
-    });
-    return NextResponse.json({ success: true });
-  },
-});
-
-export {
-  GET as productItemGET,
-  PATCH as productItemPATCH,
-  DELETE as productItemDELETE,
-};

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

@@ -1,242 +0,0 @@
-/**
- * feat-products — Next.js App Router API handlers (GET /api/products, POST /api/products)
- *
- * These handlers are exported so consuming projects can create 2-line stubs:
- *
- * ```ts
- * // app/api/products/route.ts
- * export { GET, POST } from "@mohasinac/feat-products";
- * ```
- *
- * The db provider must be registered via providers.config.ts before the first
- * request is handled.  Every read/write goes through the IRepository<ProductItem>
- * resolved from `getProviders().db.getRepository("products")`.
- */
-
-import { NextResponse } from "next/server.js";
-import { z } from "zod";
-import { getProviders } from "../../../contracts";
-import { createRouteHandler } from "../../../next";
-import type { ProductItem, ProductListResponse } from "../types/index";
-import { mediaFieldSchema } from "../../media/types/index";
-
-type ProductRecord = ProductItem & {
-  sellerId?: string;
-  sellerName?: string;
-};
-
-// ─── Mutation schemas ─────────────────────────────────────────────────────────
-// Minimal schemas for secured mutations — consumer apps can extend as needed.
-
-const productMutateSchema = z
-  .object({
-    title: z.string().min(1).max(200).optional(),
-    description: z.string().max(10000).optional(),
-    price: z.number().positive().optional(),
-    originalPrice: z.number().positive().optional(),
-    currency: z.string().length(3).optional(),
-    category: z.string().optional(),
-    status: z
-      .enum([
-        "draft",
-        "published",
-        "archived",
-        "sold",
-        "discontinued",
-        "out_of_stock",
-      ])
-      .optional(),
-    mainImage: z.string().optional(),
-    images: z.array(z.any()).optional(),
-    tags: z.array(z.string()).optional(),
-    featured: z.boolean().optional(),
-    isPromoted: z.boolean().optional(),
-    isAuction: z.boolean().optional(),
-    isPreOrder: z.boolean().optional(),
-    sellerId: z.string().optional(),
-    sellerName: z.string().optional(),
-    sellerEmail: z.string().email().optional(),
-    slug: z.string().optional(),
-    listingType: z
-      .enum(["fixed", "standard", "auction", "pre-order"])
-      .optional(),
-    media: z.array(mediaFieldSchema).optional(),
-  })
-  .passthrough();
-
-// ─── Helpers ──────────────────────────────────────────────────────────────────
-
-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;
-}
-
-/** Public fields callers may filter on via the ?filters= param. */
-const SAFE_PRODUCT_FILTER_FIELDS = new Set([
-  "status",
-  "category",
-  "brand",
-  "condition",
-  "sellerId",
-  "title",
-  "price",
-  "isAuction",
-  "isPreOrder",
-  "featured",
-  "isPromoted",
-  "stockQuantity",
-  "availableQuantity",
-  "tags",
-]);
-
-/**
- * Validates a raw Sieve filter string against an allowlist of safe fields.
- * Drops any clause whose field name is not in the allowlist.
- */
-function validateSieveFilters(
-  raw: string,
-  allowedFields: ReadonlySet<string>,
-): string {
-  return raw
-    .split(",")
-    .map((c) => c.trim())
-    .filter((c) => {
-      const m = c.match(/^([^<>=!@]+)\s*(?:==|!=|<=|>=|<|>|@=\*?)/);
-      return m ? allowedFields.has(m[1].trim()) : false;
-    })
-    .join(",");
-}
-
-function buildFilters(url: URL): string {
-  const parts: string[] = [];
-  const status = param(url, "status");
-  if (status) parts.push(`status==${status}`);
-  const category = param(url, "category");
-  if (category) parts.push(`category==${category}`);
-  const brand = param(url, "brand");
-  if (brand) parts.push(`brand==${brand}`);
-  const condition = param(url, "condition");
-  if (condition) parts.push(`condition==${condition}`);
-  const sellerId = param(url, "sellerId");
-  if (sellerId) parts.push(`sellerId==${sellerId}`);
-  const q = param(url, "q");
-  if (q) parts.push(`title@=*${q}`);
-  const minPrice = param(url, "minPrice");
-  if (minPrice !== null && !Number.isNaN(Number(minPrice)))
-    parts.push(`price>=${minPrice}`);
-  const maxPrice = param(url, "maxPrice");
-  if (maxPrice !== null && !Number.isNaN(Number(maxPrice)))
-    parts.push(`price<=${maxPrice}`);
-  const inStock = param(url, "inStock");
-  if (inStock === "true") parts.push("stockQuantity>0");
-  const isAuction = param(url, "isAuction");
-  if (isAuction !== null) parts.push(`isAuction==${isAuction}`);
-  const isPreOrder = param(url, "isPreOrder");
-  if (isPreOrder !== null) parts.push(`isPreOrder==${isPreOrder}`);
-  const featured = param(url, "featured");
-  if (featured === "true") parts.push("featured==true");
-  // Merge validated Sieve filters — only safe public fields allowed
-  const raw = param(url, "filters");
-  if (raw) {
-    const safe = validateSieveFilters(raw, SAFE_PRODUCT_FILTER_FIELDS);
-    if (safe) parts.push(safe);
-  }
-  return parts.join(",");
-}
-
-// ─── GET /api/products ────────────────────────────────────────────────────────
-
-export async function GET(request: Request): Promise<NextResponse> {
-  try {
-    const url = new URL(request.url);
-    const page = numParam(url, "page", 1);
-    const pageSize = numParam(url, "pageSize", 20);
-    const sort = param(url, "sorts") ?? param(url, "sort") ?? "-createdAt";
-    const filters = buildFilters(url);
-
-    const { db } = getProviders();
-    if (!db) {
-      return NextResponse.json(
-        { success: false, error: "Database provider not registered" },
-        { status: 503 },
-      );
-    }
-
-    const repo = db.getRepository<ProductRecord>("products");
-    const result = await repo.findAll({
-      filters,
-      sort,
-      page,
-      perPage: pageSize,
-    });
-
-    const totalPages = Math.max(1, Math.ceil(result.total / pageSize));
-    const body: ProductListResponse = {
-      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-products] GET /api/products failed", error);
-    return NextResponse.json(
-      { success: false, error: "Failed to fetch products" },
-      { status: 500 },
-    );
-  }
-}
-
-// ─── POST /api/products ───────────────────────────────────────────────────────
-// Requires seller, moderator, or admin role.
-
-export const POST = createRouteHandler({
-  auth: true,
-  roles: ["seller", "moderator", "admin"],
-  schema: productMutateSchema,
-  handler: async ({ user, body }) => {
-    const payload = body as Record<string, unknown>;
-    const userRecord = (user ?? {}) as Record<string, unknown>;
-    const { db } = getProviders();
-    if (!db) {
-      return NextResponse.json(
-        { success: false, error: "Database provider not registered" },
-        { status: 503 },
-      );
-    }
-    const repo = db.getRepository<ProductItem>("products");
-    const data: Partial<ProductItem> = {
-      ...(payload as Partial<ProductRecord>),
-      status: "draft",
-      sellerId:
-        typeof payload.sellerId === "string"
-          ? payload.sellerId
-          : typeof userRecord.uid === "string"
-            ? userRecord.uid
-            : undefined,
-      sellerName:
-        typeof payload.sellerName === "string"
-          ? payload.sellerName
-          : typeof userRecord.displayName === "string"
-            ? userRecord.displayName
-            : undefined,
-      createdAt: new Date().toISOString(),
-      updatedAt: new Date().toISOString(),
-    };
-    const created = await repo.create(data as Omit<ProductItem, "id">);
-    return NextResponse.json({ success: true, data: created }, { status: 201 });
-  },
-});

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

@@ -1,90 +0,0 @@
-import type { TableColumn, ColumnExtensionOpts } from "../../../contracts";
-import type { ProductItem } from "../types";
-
-/**
- * Default admin column definitions for a product table.
- * These are plain data — no React imports, no JSX.
- *
- * Use with `DataTable<T>` from `@mohasinac/feat-admin`.
- *
- * @example — consumer app overrides/extends columns
- * ```ts
- * import { productAdminColumns } from "@mohasinac/feat-products";
- * import type { ProductDocument } from "@/db/schema/product.schema";
- *
- * const columns: AdminTableColumn<ProductDocument>[] = [
- *   // keep base columns (cast is safe because ProductDocument extends ProductItem)
- *   ...(productAdminColumns as AdminTableColumn<ProductDocument>[]),
- *   // add app-specific column
- *   {
- *     key: "brand",
- *     header: "Brand",
- *     render: (p) => p.brand ?? "—",
- *   },
- * ];
- * ```
- *
- * @example — replace a single column's renderer
- * ```ts
- * const columns = productAdminColumns.map((col) =>
- *   col.key === "title"
- *     ? { ...col, render: (p: ProductDocument) => <Link href={p.slug}>{p.title}</Link> }
- *     : col
- * );
- * ```
- */
-export const productAdminColumns: TableColumn<ProductItem>[] = [
-  { key: "title", header: "Product", sortable: true },
-  {
-    key: "price",
-    header: "Price",
-    sortable: true,
-    render: (p) => `${p.currency ?? "₹"}${p.price.toLocaleString()}`,
-  },
-  { key: "category", header: "Category", sortable: true },
-  { key: "status", header: "Status", sortable: true },
-  { key: "condition", header: "Condition" },
-  {
-    key: "inStock",
-    header: "In Stock",
-    render: (p) => (p.inStock ? "Yes" : "No"),
-  },
-  {
-    key: "rating",
-    header: "Rating",
-    render: (p) =>
-      p.rating !== undefined
-        ? `${p.rating.toFixed(1)} (${p.reviewCount ?? 0})`
-        : "—",
-  },
-  { key: "createdAt", header: "Created", sortable: true },
-];
-
-/**
- * Build a merged column list from the base product columns.
- * - `overrides`: replace or augment a column by key
- * - `extras`: append additional columns at the end
- * - `omit`: remove columns by key
- *
- * @example
- * const cols = buildProductColumns<ProductDocument>({
- *   overrides: {
- *     title: { render: (p) => <TitleWithBadge product={p} /> },
- *   },
- *   extras: [{ key: "brand", header: "Brand", render: (p) => p.brand }],
- *   omit: ["condition"],
- * });
- */
-export function buildProductColumns<T extends ProductItem = ProductItem>(
-  opts?: ColumnExtensionOpts<T>,
-): TableColumn<T>[] {
-  const base = productAdminColumns 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/products/components/AuctionDetailView.tsx

@@ -1,58 +0,0 @@
-"use client";
-
-import React from "react";
-import { Div } from "../../../ui";
-import { Grid } from "../../../ui";
-
-export interface AuctionDetailViewProps {
-  labels?: { title?: string };
-  renderGallery?: (isLoading: boolean) => React.ReactNode;
-  renderInfo?: (isLoading: boolean) => React.ReactNode;
-  /** Desktop sticky bid sidebar (hidden on mobile, shown in col 3) */
-  renderBidForm?: () => React.ReactNode;
-  /** Mobile bid form shown below the grid on small screens */
-  renderMobileBidForm?: () => React.ReactNode;
-  renderBidHistory?: () => React.ReactNode;
-  renderRelated?: () => React.ReactNode;
-  renderBreadcrumb?: () => React.ReactNode;
-  renderSkeleton?: () => React.ReactNode;
-  renderNotFound?: () => React.ReactNode;
-  isLoading?: boolean;
-  className?: string;
-}
-
-export function AuctionDetailView({
-  renderBreadcrumb,
-  renderGallery,
-  renderInfo,
-  renderBidForm,
-  renderMobileBidForm,
-  renderBidHistory,
-  renderRelated,
-  renderSkeleton,
-  renderNotFound,
-  isLoading = false,
-  className = "",
-}: AuctionDetailViewProps) {
-  if (isLoading && renderSkeleton) {
-    return <>{renderSkeleton()}</>;
-  }
-  if (renderNotFound) {
-    return <>{renderNotFound()}</>;
-  }
-  return (
-    <Div className={className}>
-      {renderBreadcrumb?.()}
-      {/* 3-column grid: gallery | info | bid-sidebar (desktop only) */}
-      <Grid cols="productDetailTriplet" className="mt-6">
-        <Div>{renderGallery?.(isLoading)}</Div>
-        <Div>{renderInfo?.(isLoading)}</Div>
-        <Div className="hidden lg:block">{renderBidForm?.()}</Div>
-      </Grid>
-      {/* Mobile bid form — shown below grid on small screens */}
-      {renderMobileBidForm?.()}
-      {renderBidHistory?.()}
-      {renderRelated?.()}
-    </Div>
-  );
-}

package/src/features/products/components/AuctionsView.tsx

@@ -1,48 +0,0 @@
-"use client";
-
-import React from "react";
-import { Div, Heading } from "../../../ui";
-
-export interface AuctionsViewProps {
-  labels?: { title?: string; emptyText?: string };
-  renderSearch?: (value: string, onChange: (v: string) => void) => React.ReactNode;
-  renderFilters?: () => React.ReactNode;
-  renderActiveFilters?: () => React.ReactNode;
-  renderSort?: (value: string, onChange: (v: string) => void) => React.ReactNode;
-  renderGrid: (isLoading: boolean) => React.ReactNode;
-  renderPagination?: (total: number) => React.ReactNode;
-  total?: number;
-  isLoading?: boolean;
-  className?: string;
-}
-
-export function AuctionsView({
-  labels = {},
-  renderSearch,
-  renderFilters,
-  renderActiveFilters,
-  renderSort,
-  renderGrid,
-  renderPagination,
-  total = 0,
-  isLoading = false,
-  className = "",
-}: AuctionsViewProps) {
-  const [search, setSearch] = React.useState("");
-  const [sort, setSort] = React.useState("");
-  return (
-    <Div className={className}>
-      {labels.title && (
-        <Heading level={1} className="text-2xl font-bold mb-6">{labels.title}</Heading>
-      )}
-      <Div className="flex gap-2 mb-4">
-        {renderSearch?.(search, setSearch)}
-        {renderSort?.(sort, setSort)}
-      </Div>
-      {renderFilters?.()}
-      {renderActiveFilters?.()}
-      {renderGrid(isLoading)}
-      {renderPagination?.(total)}
-    </Div>
-  );
-}