@mohasinac/appkit 2.1.3 → 2.3.0

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

@@ -1,75 +0,0 @@
-import type React from "react";
-import type { TableColumn } from "../../../contracts";
-
-// Re-export the base column type from contracts
-export type { TableColumn } from "../../../contracts";
-
-/**
- * Admin-specific column definition that narrows `render` to `React.ReactNode`.
- * Extends `TableColumn<T>` from `@mohasinac/contracts` so it is compatible
- * with column arrays built from the base type.
- */
-export interface AdminTableColumn<T = Record<string, unknown>> extends Omit<
-  TableColumn<T>,
-  "render"
-> {
-  render?: (row: T) => React.ReactNode;
-}
-
-export interface DashboardStats {
-  totalOrders?: number;
-  totalRevenue?: number;
-  totalUsers?: number;
-  totalProducts?: number;
-  pendingOrders?: number;
-  pendingReviews?: number;
-  newUsersToday?: number;
-  currency?: string;
-}
-
-export interface AdminListParams {
-  q?: string;
-  page?: number;
-  perPage?: number;
-  sort?: string;
-  filters?: string;
-}
-
-export interface AdminListResponse<T> {
-  items: T[];
-  total: number;
-  page: number;
-  perPage: number;
-  totalPages: number;
-}
-
-// ─── Analytics Types ──────────────────────────────────────────────────────────
-
-export interface AnalyticsMonthEntry {
-  month: string;
-  orders: number;
-  revenue: number;
-}
-
-export interface AnalyticsTopProduct {
-  productId: string;
-  title: string;
-  revenue: number;
-  orders: number;
-  mainImage?: string;
-}
-
-export interface AnalyticsSummary {
-  totalOrders: number;
-  totalRevenue: number;
-  newOrdersThisMonth: number;
-  revenueThisMonth: number;
-  totalProducts?: number;
-  publishedProducts?: number;
-}
-
-export interface AdminAnalyticsData {
-  summary: AnalyticsSummary;
-  ordersByMonth: AnalyticsMonthEntry[];
-  topProducts: AnalyticsTopProduct[];
-}

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

@@ -1,83 +0,0 @@
-/**
- * feat-auctions — Next.js App Router API handler (GET /api/bids)
- *
- * 2-line stub:
- * ```ts
- * // app/api/bids/route.ts
- * export { GET } from "@mohasinac/feat-auctions";
- * ```
- *
- * Requires `db` registered in providers.config via `registerProviders()`.
- * Collection: "bids"
- */
-
-import { NextResponse } from "next/server.js";
-import { getProviders } from "../../../contracts";
-import type { BidRecord, BidListResponse } 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/bids ────────────────────────────────────────────────────────────
-// Query params:
-//   auctionId — filter bids for a specific auction product (recommended)
-//   bidderId  — filter bids placed by a specific user
-//   sort      — Sieve sort field (default: "-amount" = highest bid first)
-//   page / pageSize — pagination
-export async function GET(request: Request): Promise<NextResponse> {
-  try {
-    const url = new URL(request.url);
-    const auctionId = param(url, "auctionId");
-    const bidderId = param(url, "bidderId");
-    const sort = param(url, "sort") ?? "-amount";
-    const page = numParam(url, "page", 1);
-    const pageSize = numParam(url, "pageSize", 50);
-
-    const parts: string[] = [];
-    if (auctionId) parts.push(`auctionId==${auctionId}`);
-    if (bidderId) parts.push(`bidderId==${bidderId}`);
-    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<BidRecord>("bids");
-    const result = await repo.findAll({
-      filters,
-      sort,
-      page,
-      perPage: pageSize,
-    });
-
-    const body: BidListResponse = {
-      items: result.data,
-      total: result.total,
-      hasMore: result.data.length === pageSize,
-    };
-
-    const response = NextResponse.json({ success: true, data: body });
-    response.headers.set(
-      "Cache-Control",
-      "public, max-age=10, s-maxage=15, stale-while-revalidate=30",
-    );
-    return response;
-  } catch (error) {
-    console.error("[feat-auctions] GET /api/bids failed", error);
-    return NextResponse.json(
-      { success: false, error: "Failed to fetch bids" },
-      { status: 500 },
-    );
-  }
-}

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

@@ -1,91 +0,0 @@
-import type { TableColumn, ColumnExtensionOpts } from "../../../contracts";
-import type { AuctionItem, BidRecord } from "../types";
-
-// ─── Auction columns ──────────────────────────────────────────────────────────
-
-/**
- * Default admin column definitions for an auction table.
- *
- * @example
- * const columns = buildAuctionColumns<MyAuction>({
- *   extras: [{ key: "reservePrice", header: "Reserve", render: (a) => a.reservePrice ?? "—" }],
- * });
- */
-export const auctionAdminColumns: TableColumn<AuctionItem>[] = [
-  { key: "title", header: "Title", sortable: true },
-  {
-    key: "startingBid",
-    header: "Starting Bid",
-    sortable: true,
-    render: (a) => `${a.currency} ${a.startingBid.toLocaleString()}`,
-  },
-  {
-    key: "currentBid",
-    header: "Current Bid",
-    sortable: true,
-    render: (a) =>
-      a.currentBid != null
-        ? `${a.currency} ${a.currentBid.toLocaleString()}`
-        : "No bids",
-  },
-  {
-    key: "bidCount",
-    header: "Bids",
-    sortable: true,
-    render: (a) => a.bidCount.toLocaleString(),
-  },
-  { key: "status", header: "Status", sortable: true },
-  {
-    key: "featured",
-    header: "Featured",
-    render: (a) => (a.featured ? "Yes" : "No"),
-  },
-  { key: "auctionEndDate", header: "Ends At", sortable: true },
-  { key: "createdAt", header: "Created", sortable: true },
-];
-
-export function buildAuctionColumns<T extends AuctionItem = AuctionItem>(
-  opts?: ColumnExtensionOpts<T>,
-): TableColumn<T>[] {
-  const base = auctionAdminColumns 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;
-}
-
-// ─── Bid columns ──────────────────────────────────────────────────────────────
-
-export const bidAdminColumns: TableColumn<BidRecord>[] = [
-  { key: "bidderDisplayName", header: "Bidder" },
-  {
-    key: "amount",
-    header: "Amount",
-    sortable: true,
-    render: (b) => `${b.currency} ${b.amount.toLocaleString()}`,
-  },
-  {
-    key: "isWinning",
-    header: "Winning",
-    render: (b) => (b.isWinning ? "Yes" : "—"),
-  },
-  { key: "placedAt", header: "Placed At", sortable: true },
-];
-
-export function buildBidColumns<T extends BidRecord = BidRecord>(
-  opts?: ColumnExtensionOpts<T>,
-): TableColumn<T>[] {
-  const base = bidAdminColumns 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/auctions/components/AuctionCard.tsx

@@ -1,149 +0,0 @@
-import { useState, useEffect } from "react";
-import type { AuctionItem } from "../types";
-import { Article, Button, Div, Heading, Span, Text } from "../../../ui";
-import { formatCurrency } from "../../../utils/number.formatter";
-
-interface AuctionCountdownProps {
-  endsAt: string;
-  className?: string;
-  labels?: { ended?: string; hours?: string; mins?: string; secs?: string };
-}
-
-function useCountdown(endsAt: string) {
-  const [msLeft, setMsLeft] = useState(
-    () => new Date(endsAt).getTime() - Date.now(),
-  );
-
-  useEffect(() => {
-    const id = setInterval(() => {
-      setMsLeft(new Date(endsAt).getTime() - Date.now());
-    }, 1000);
-    return () => clearInterval(id);
-  }, [endsAt]);
-
-  if (msLeft <= 0) return null;
-  const totalSecs = Math.floor(msLeft / 1000);
-  const h = Math.floor(totalSecs / 3600);
-  const m = Math.floor((totalSecs % 3600) / 60);
-  const s = totalSecs % 60;
-  return { h, m, s };
-}
-
-export function AuctionCountdown({
-  endsAt,
-  className = "",
-  labels = {},
-}: AuctionCountdownProps) {
-  const countdown = useCountdown(endsAt);
-
-  if (!countdown) {
-    return (
-      <Span className={`text-sm font-medium text-red-600 ${className}`}>
-        {labels.ended ?? "Ended"}
-      </Span>
-    );
-  }
-
-  const pad = (n: number) => String(n).padStart(2, "0");
-
-  return (
-    <Div className={`flex items-center gap-1 text-sm font-mono ${className}`}>
-      <Span className="rounded bg-gray-900 px-1.5 py-0.5 text-white">
-        {pad(countdown.h)}
-      </Span>
-      <Span className="text-gray-400">:</Span>
-      <Span className="rounded bg-gray-900 px-1.5 py-0.5 text-white">
-        {pad(countdown.m)}
-      </Span>
-      <Span className="text-gray-400">:</Span>
-      <Span className="rounded bg-gray-900 px-1.5 py-0.5 text-white">
-        {pad(countdown.s)}
-      </Span>
-    </Div>
-  );
-}
-
-interface AuctionCardProps {
-  auction: AuctionItem;
-  labels?: {
-    currentBid?: string;
-    startingBid?: string;
-    bids?: string;
-    placeBid?: string;
-    ended?: string;
-  };
-  onBid?: (auction: AuctionItem) => void;
-  className?: string;
-}
-
-export function AuctionCard({
-  auction,
-  labels = {},
-  onBid,
-  className = "",
-}: AuctionCardProps) {
-  const hasEnded = new Date(auction.auctionEndDate) <= new Date();
-  const displayBid = auction.currentBid ?? auction.startingBid;
-
-  return (
-    <Article
-      className={`rounded-xl border border-gray-200 bg-white overflow-hidden shadow-sm hover:shadow-md transition-shadow ${className}`}
-    >
-      {auction.mainImage && (
-        <Div className="aspect-square overflow-hidden relative">
-          <Div
-            role="img"
-            aria-label={auction.title}
-            className="h-full w-full bg-center bg-cover"
-            style={{ backgroundImage: `url(${auction.mainImage})` }}
-          />
-          <Span className="absolute top-2 left-2 rounded-full bg-orange-500 px-2 py-0.5 text-xs font-bold text-white">
-            AUCTION
-          </Span>
-        </Div>
-      )}
-      <Div className="p-4">
-        <Heading
-          level={3}
-          className="font-semibold text-gray-900 text-sm leading-snug mb-2 line-clamp-2"
-        >
-          {auction.title}
-        </Heading>
-
-        <Div className="flex items-center justify-between mb-2">
-          <Div>
-            <Text className="text-xs text-gray-400">
-              {labels.currentBid ?? "Current bid"}
-            </Text>
-            <Text className="text-base font-bold text-gray-900">
-              {formatCurrency(displayBid, auction.currency ?? "INR")}
-            </Text>
-          </Div>
-          <Div className="text-right">
-            <Text className="text-xs text-gray-400">
-              {auction.bidCount} {labels.bids ?? "bids"}
-            </Text>
-          </Div>
-        </Div>
-
-        <Div className="mb-3">
-          <AuctionCountdown
-            endsAt={auction.auctionEndDate}
-            labels={{ ended: labels.ended }}
-          />
-        </Div>
-
-        {!hasEnded && onBid && (
-          <Button
-            type="button"
-            variant="warning"
-            onClick={() => onBid(auction)}
-            className="w-full rounded-lg bg-orange-500 py-2 text-sm font-medium text-white hover:bg-orange-600 transition-colors"
-          >
-            {labels.placeBid ?? "Place Bid"}
-          </Button>
-        )}
-      </Div>
-    </Article>
-  );
-}

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

@@ -1 +0,0 @@
-export { AuctionCard, AuctionCountdown } from "./AuctionCard";

package/src/features/auctions/hooks/useAuctions.ts

@@ -1,145 +0,0 @@
-"use client";
-
-import { useQuery } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-import type {
-  AuctionListResponse,
-  AuctionListParams,
-  AuctionItem,
-  BidListResponse,
-  PublicBid,
-} from "../types";
-import type { ProductItem } from "../../products/types";
-
-type AuctionListQuery = AuctionListParams | URLSearchParams | string;
-
-interface UseAuctionsOptions {
-  enabled?: boolean;
-  endpoint?: string;
-  initialData?: AuctionListResponse;
-  queryKeyPrefix?: string;
-}
-
-interface UseAuctionDetailOptions {
-  enabled?: boolean;
-  productEndpoint?: string;
-  bidsEndpoint?: string;
-  refetchIntervalMs?: number;
-  productQueryKeyPrefix?: string;
-  bidsQueryKeyPrefix?: string;
-}
-
-function toQueryString(params: AuctionListQuery): string {
-  if (typeof params === "string") {
-    return params.startsWith("?") ? params.slice(1) : params;
-  }
-
-  if (params instanceof URLSearchParams) {
-    return params.toString();
-  }
-
-  const sp = new URLSearchParams();
-  Object.entries(params).forEach(([key, value]) => {
-    if (value !== undefined && value !== null && value !== "") {
-      sp.set(key, String(value));
-    }
-  });
-  return sp.toString();
-}
-
-export function useAuctions(
-  params: AuctionListQuery = {},
-  opts?: UseAuctionsOptions,
-) {
-  const endpoint = opts?.endpoint ?? "/api/auctions";
-  const queryKeyPrefix = opts?.queryKeyPrefix ?? "auctions";
-  const qs = toQueryString(params);
-
-  const { data, isLoading, error, refetch } = useQuery<AuctionListResponse>({
-    queryKey: [queryKeyPrefix, endpoint, qs],
-    queryFn: () =>
-      apiClient.get<AuctionListResponse>(`${endpoint}${qs ? `?${qs}` : ""}`),
-    enabled: opts?.enabled ?? true,
-    initialData: opts?.initialData,
-  });
-
-  return {
-    data,
-    auctions: data?.items ?? [],
-    total: data?.total ?? 0,
-    totalPages: data?.totalPages ?? 1,
-    hasMore: data?.hasMore ?? false,
-    isLoading,
-    error: error instanceof Error ? error.message : null,
-    refetch,
-  };
-}
-
-export function useAuction(slug: string, opts?: { enabled?: boolean }) {
-  const { data, isLoading, error, refetch } = useQuery<AuctionItem | null>({
-    queryKey: ["auction", slug],
-    queryFn: () => apiClient.get<AuctionItem>(`/api/auctions/${slug}`),
-    enabled: (opts?.enabled ?? true) && !!slug,
-  });
-
-  return {
-    auction: data ?? null,
-    isLoading,
-    error: error instanceof Error ? error.message : null,
-    refetch,
-  };
-}
-
-export function useAuctionBids(
-  auctionSlug: string,
-  limit = 10,
-  opts?: { enabled?: boolean },
-) {
-  const { data, isLoading, error } = useQuery<BidListResponse>({
-    queryKey: ["auction-bids", auctionSlug, limit],
-    queryFn: () =>
-      apiClient.get<BidListResponse>(
-        `/api/auctions/${auctionSlug}/bids?limit=${limit}`,
-      ),
-    enabled: (opts?.enabled ?? true) && !!auctionSlug,
-    refetchInterval: 15_000, // refresh every 15 s for real-time feel
-  });
-
-  return {
-    bids: data?.items ?? [],
-    total: data?.total ?? 0,
-    isLoading,
-    error: error instanceof Error ? error.message : null,
-  };
-}
-
-export function useAuctionDetail(id: string, opts?: UseAuctionDetailOptions) {
-  const enabled = opts?.enabled ?? true;
-  const productEndpoint = opts?.productEndpoint ?? `/api/products/${id}`;
-  const bidsEndpoint = opts?.bidsEndpoint ?? `/api/bids?productId=${id}`;
-  const productQueryKeyPrefix = opts?.productQueryKeyPrefix ?? "product";
-  const bidsQueryKeyPrefix = opts?.bidsQueryKeyPrefix ?? "bids";
-  const refetchIntervalMs = opts?.refetchIntervalMs ?? 60_000;
-
-  const productQuery = useQuery<ProductItem | null>({
-    queryKey: [productQueryKeyPrefix, id, productEndpoint],
-    queryFn: () => apiClient.get<ProductItem | null>(productEndpoint),
-    enabled: enabled && Boolean(id),
-  });
-
-  const product = productQuery.data ?? null;
-
-  const bidsQuery = useQuery<PublicBid[]>({
-    queryKey: [bidsQueryKeyPrefix, id, bidsEndpoint],
-    queryFn: () => apiClient.get<PublicBid[]>(bidsEndpoint),
-    enabled: enabled && Boolean(product?.isAuction),
-    refetchInterval: refetchIntervalMs,
-  });
-
-  return {
-    productQuery,
-    product,
-    bidsQuery,
-    bids: bidsQuery.data ?? [],
-  };
-}

package/src/features/auctions/hooks/usePlaceBid.ts

@@ -1,48 +0,0 @@
-"use client";
-
-import { useMutation, useQueryClient } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-
-export interface BidResult {
-  id: string;
-  productId: string;
-  bidAmount: number;
-  isWinning: boolean;
-  currency: string;
-  [key: string]: unknown;
-}
-
-export interface PlaceBidPayload {
-  productId: string;
-  bidAmount: number;
-}
-
-/**
- * usePlaceBid
- *
- * Mutation hook for placing a bid on an auction product.
- * Invalidates bid list and auction detail queries on success so the UI
- * reflects the new highest bid without a manual reload.
- *
- * @example
- * const { mutateAsync, isPending } = usePlaceBid();
- * const bid = await mutateAsync({ productId, bidAmount: amount });
- */
-export function usePlaceBid() {
-  const queryClient = useQueryClient();
-
-  return useMutation<BidResult, Error, PlaceBidPayload>({
-    mutationFn: async (data) => {
-      const result = await apiClient.post<{ bid: BidResult }>(
-        "/api/bids",
-        data,
-      );
-      return result.bid;
-    },
-    onSuccess: async (_, { productId }) => {
-      await queryClient.invalidateQueries({ queryKey: ["bids", productId] });
-      await queryClient.invalidateQueries({ queryKey: ["auction", productId] });
-      await queryClient.invalidateQueries({ queryKey: ["product", productId] });
-    },
-  });
-}

package/src/features/auctions/hooks/useRealtimeBids.ts

@@ -1,100 +0,0 @@
-"use client";
-
-import { useEffect, useState } from "react";
-import { logger } from "../../../core/Logger";
-
-export interface RealtimeBidData {
-  currentBid: number;
-  bidCount: number;
-  lastBid: {
-    amount: number;
-    bidderName: string;
-    timestamp: number;
-  } | null;
-  updatedAt: number;
-}
-
-export interface UseRealtimeBidsReturn {
-  /** Current highest bid — most recent value pushed from the server */
-  currentBid: number | null;
-  /** Total active bid count */
-  bidCount: number | null;
-  /** Info about the most recent bid placed */
-  lastBid: RealtimeBidData["lastBid"];
-  /** Whether the SSE connection is live */
-  connected: boolean;
-  /** Last time the data was updated (epoch ms) */
-  updatedAt: number | null;
-}
-
-/**
- * useRealtimeBids
- *
- * Subscribes to live auction bid updates via Server-Sent Events (SSE).
- *
- * Uses a streaming route that keeps a server-side listener open and pushes
- * updates to the browser via text/event-stream. No Firebase client SDK required.
- *
- * @param productId - The auction product ID to subscribe to, or null to disable
- * @param getEndpoint - Optional: override the SSE endpoint URL builder.
- *   Defaults to `/api/realtime/bids/{productId}`.
- *
- * @example
- * const { currentBid, bidCount, connected } = useRealtimeBids(productId);
- */
-export function useRealtimeBids(
-  productId: string | null,
-  getEndpoint: (id: string) => string = (id) => `/api/realtime/bids/${id}`,
-): UseRealtimeBidsReturn {
-  const [data, setData] = useState<RealtimeBidData | null>(null);
-  const [connected, setConnected] = useState(false);
-
-  useEffect(() => {
-    if (!productId || typeof EventSource === "undefined") {
-      setConnected(false);
-      return;
-    }
-
-    const url = getEndpoint(productId);
-    const es = new EventSource(url);
-
-    es.onmessage = (event) => {
-      try {
-        const msg = JSON.parse(event.data as string) as {
-          type: string;
-          data?: RealtimeBidData | null;
-        };
-        if (msg.type === "connected") {
-          setConnected(true);
-        } else if (msg.type === "update") {
-          setData(msg.data ?? null);
-          setConnected(true);
-        } else if (msg.type === "error") {
-          setConnected(false);
-        }
-      } catch {
-        logger.warn("[useRealtimeBids] Failed to parse SSE message");
-      }
-    };
-
-    es.onerror = () => {
-      // EventSource will attempt to reconnect automatically.
-      setConnected(false);
-      logger.warn("[useRealtimeBids] SSE connection error — will retry");
-    };
-
-    return () => {
-      es.close();
-      setConnected(false);
-    };
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [productId]);
-
-  return {
-    currentBid: data?.currentBid ?? null,
-    bidCount: data?.bidCount ?? null,
-    lastBid: data?.lastBid ?? null,
-    connected,
-    updatedAt: data?.updatedAt ?? null,
-  };
-}