@mohasinac/appkit 2.1.3 → 2.3.0

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

@@ -1,47 +0,0 @@
-import type { TableColumn, ColumnExtensionOpts } from "../../../contracts";
-import type { Order } from "../types";
-
-/**
- * Default admin column definitions for an order table.
- *
- * @example
- * const columns = buildOrderColumns<MyOrder>({
- *   extras: [{ key: "giftMessage", header: "Gift", render: (o) => o.giftMessage ?? "—" }],
- * });
- */
-export const orderAdminColumns: TableColumn<Order>[] = [
-  { key: "id", header: "Order ID", sortable: true },
-  {
-    key: "total",
-    header: "Total",
-    sortable: true,
-    render: (o) => `${o.currency} ${o.total.toLocaleString()}`,
-  },
-  { key: "orderStatus", header: "Status", sortable: true },
-  { key: "paymentStatus", header: "Payment", sortable: true },
-  {
-    key: "items",
-    header: "Items",
-    render: (o) => o.items.length.toLocaleString(),
-  },
-  { key: "trackingNumber", header: "Tracking" },
-  { key: "createdAt", header: "Placed", sortable: true },
-  { key: "updatedAt", header: "Updated", sortable: true },
-];
-
-/**
- * Build a merged column list from the base order columns.
- */
-export function buildOrderColumns<T extends Order = Order>(
-  opts?: ColumnExtensionOpts<T>,
-): TableColumn<T>[] {
-  const base = orderAdminColumns 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/orders/components/OrdersList.tsx

@@ -1,168 +0,0 @@
-import { Div, Pagination, Row, Span, Text } from "../../../ui";
-import type { Order, OrderStatus } from "../types";
-import { formatCurrency } from "../../../utils/number.formatter";
-
-const STATUS_COLORS: Record<OrderStatus, string> = {
-  pending: "bg-yellow-100 text-yellow-700",
-  confirmed: "bg-blue-100 text-blue-700",
-  processing: "bg-blue-100 text-blue-700",
-  shipped: "bg-indigo-100 text-indigo-700",
-  delivered: "bg-green-100 text-green-700",
-  cancelled: "bg-red-100 text-red-700",
-  refunded: "bg-orange-100 text-orange-700",
-  return_requested: "bg-amber-100 text-amber-700",
-  returned: "bg-neutral-100 text-neutral-600",
-};
-
-interface OrderCardProps {
-  order: Order;
-  onClick?: (order: Order) => void;
-  labels?: Record<string, string>;
-}
-
-export function OrderCard({ order, onClick, labels = {} }: OrderCardProps) {
-  const date = order.createdAt
-    ? new Date(order.createdAt).toLocaleDateString("en-US", {
-        year: "numeric",
-        month: "short",
-        day: "numeric",
-      })
-    : "";
-  const statusColor =
-    STATUS_COLORS[order.orderStatus] ?? "bg-neutral-100 text-neutral-700";
-
-  return (
-    <Div
-      role={onClick ? "button" : undefined}
-      tabIndex={onClick ? 0 : undefined}
-      onKeyDown={
-        onClick
-          ? (e) => (e.key === "Enter" || e.key === " ") && onClick(order)
-          : undefined
-      }
-      onClick={onClick ? () => onClick(order) : undefined}
-      className={`rounded-xl border border-neutral-200 bg-white p-5 ${onClick ? "cursor-pointer transition hover:shadow-md" : ""}`}
-    >
-      <Row wrap align="start" justify="between" gap="3">
-        <Div>
-          <Text className="text-xs text-neutral-500">
-            Order #{order.id.slice(-8).toUpperCase()}
-          </Text>
-          {date && (
-            <Text className="mt-0.5 text-xs text-neutral-400">{date}</Text>
-          )}
-        </Div>
-        <Span
-          className={`rounded-full px-3 py-1 text-xs font-semibold capitalize ${statusColor}`}
-        >
-          {labels[order.orderStatus] ?? order.orderStatus.replace(/_/g, " ")}
-        </Span>
-      </Row>
-      <Row wrap gap="3" className="mt-4">
-        {order.items.slice(0, 3).map((item, i) => (
-          <Div key={i} className="flex items-center gap-2">
-            {item.image && (
-              <Div
-                role="img"
-                aria-label={item.title}
-                className="h-10 w-10 rounded-lg bg-center bg-cover"
-                style={{ backgroundImage: `url(${item.image})` }}
-              />
-            )}
-            <Div>
-              <Text className="text-sm font-medium text-neutral-900 line-clamp-1">
-                {item.title}
-              </Text>
-              <Text className="text-xs text-neutral-400">×{item.quantity}</Text>
-            </Div>
-          </Div>
-        ))}
-        {order.items.length > 3 && (
-          <Span className="self-center text-xs text-neutral-400">
-            +{order.items.length - 3} more
-          </Span>
-        )}
-      </Row>
-      <Div className="mt-4 flex items-center justify-between border-t border-neutral-100 pt-3">
-        <Span className="text-sm text-neutral-500">
-          {order.currency ?? "INR"} Total
-        </Span>
-        <Span className="font-semibold text-neutral-900">
-          {formatCurrency(order.total, order.currency ?? "INR")}
-        </Span>
-      </Div>
-    </Div>
-  );
-}
-
-interface OrdersListProps {
-  orders: Order[];
-  isLoading?: boolean;
-  onOrderClick?: (order: Order) => void;
-  totalPages?: number;
-  currentPage?: number;
-  onPageChange?: (page: number) => void;
-  emptyLabel?: string;
-}
-
-export function OrdersList({
-  orders,
-  isLoading,
-  onOrderClick,
-  totalPages = 1,
-  currentPage = 1,
-  onPageChange,
-  emptyLabel = "No orders found",
-}: OrdersListProps) {
-  if (isLoading) {
-    return (
-      <Div className="space-y-4">
-        {Array.from({ length: 3 }).map((_, i) => (
-          <Div
-            key={i}
-            className="animate-pulse rounded-xl border border-neutral-200 p-5"
-          >
-            <Div className="flex justify-between">
-              <Div className="space-y-1">
-                <Div className="h-3 w-20 rounded bg-neutral-200" />
-                <Div className="h-3 w-16 rounded bg-neutral-200" />
-              </Div>
-              <Div className="h-6 w-20 rounded-full bg-neutral-200" />
-            </Div>
-            <Div className="mt-4 flex gap-3">
-              <Div className="h-10 w-10 rounded-lg bg-neutral-200" />
-              <Div className="h-10 w-10 rounded-lg bg-neutral-200" />
-            </Div>
-          </Div>
-        ))}
-      </Div>
-    );
-  }
-
-  if (orders.length === 0) {
-    return (
-      <Text className="py-12 text-center text-sm text-neutral-500">
-        {emptyLabel}
-      </Text>
-    );
-  }
-
-  return (
-    <Div className="space-y-6">
-      <Div className="space-y-4">
-        {orders.map((order) => (
-          <OrderCard key={order.id} order={order} onClick={onOrderClick} />
-        ))}
-      </Div>
-      {totalPages > 1 && onPageChange && (
-        <Div className="flex justify-center">
-          <Pagination
-            currentPage={currentPage}
-            totalPages={totalPages}
-            onPageChange={onPageChange}
-          />
-        </Div>
-      )}
-    </Div>
-  );
-}

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

@@ -1 +0,0 @@
-export { OrderCard, OrdersList } from "./OrdersList";

package/src/features/orders/hooks/useOrders.ts

@@ -1,53 +0,0 @@
-"use client";
-import { useQuery } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-import type { Order, OrderListResponse, OrderListParams } from "../types";
-
-interface UseOrdersOptions {
-  initialData?: OrderListResponse;
-  enabled?: boolean;
-}
-
-export function useOrders(
-  params: OrderListParams = {},
-  opts?: UseOrdersOptions,
-) {
-  const sp = new URLSearchParams();
-  if (params.userId) sp.set("userId", params.userId);
-  if (params.orderStatus) sp.set("orderStatus", params.orderStatus);
-  if (params.paymentStatus) sp.set("paymentStatus", params.paymentStatus);
-  if (params.sort) sp.set("sort", params.sort);
-  if (params.page) sp.set("page", String(params.page));
-  if (params.perPage) sp.set("perPage", String(params.perPage));
-  const qs = sp.toString();
-
-  const query = useQuery<OrderListResponse>({
-    queryKey: ["orders", qs],
-    queryFn: () =>
-      apiClient.get<OrderListResponse>(`/api/orders${qs ? `?${qs}` : ""}`),
-    initialData: opts?.initialData,
-    enabled: opts?.enabled,
-  });
-
-  return {
-    orders: query.data?.items ?? [],
-    total: query.data?.total ?? 0,
-    totalPages: query.data?.totalPages ?? 1,
-    isLoading: query.isLoading,
-    error: query.error,
-  };
-}
-
-export function useOrder(
-  id: string,
-  opts?: { initialData?: Order; enabled?: boolean },
-) {
-  const query = useQuery<Order>({
-    queryKey: ["orders", id],
-    queryFn: () => apiClient.get<Order>(`/api/orders/${id}`),
-    initialData: opts?.initialData,
-    enabled: opts?.enabled !== false && !!id,
-  });
-
-  return { order: query.data, isLoading: query.isLoading, error: query.error };
-}

package/src/features/orders/index.ts

@@ -1,8 +0,0 @@
-export * from "./types";
-export * from "./hooks/useOrders";
-export * from "./components";
-export * from "./schemas";
-export * from "./columns";
-export * from "./utils/order-splitter";
-export { OrdersRepository } from "./repository/orders.repository";
-export { manifest } from "./manifest";

package/src/features/orders/manifest.ts

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

package/src/features/orders/messages/en.json

@@ -1,15 +0,0 @@
-{
-  "title": "Orders",
-  "noOrders": "No orders found",
-  "status": {
-    "pending": "Pending",
-    "confirmed": "Confirmed",
-    "processing": "Processing",
-    "shipped": "Shipped",
-    "delivered": "Delivered",
-    "cancelled": "Cancelled",
-    "refunded": "Refunded",
-    "return_requested": "Return Requested",
-    "returned": "Returned"
-  }
-}

package/src/features/orders/repository/orders.repository.ts

@@ -1,47 +0,0 @@
-import type {
-  IRepository,
-  PagedResult,
-  SieveQuery,
-} from "../../../contracts";
-import type { Order, OrderStatus } from "../types";
-
-export class OrdersRepository {
-  constructor(private readonly repo: IRepository<Order>) {}
-
-  async findAll(query?: SieveQuery): Promise<PagedResult<Order>> {
-    return this.repo.findAll(query ?? {});
-  }
-
-  async findByUser(
-    userId: string,
-    page = 1,
-    perPage = 10,
-  ): Promise<PagedResult<Order>> {
-    return this.repo.findAll({
-      filters: `userId==${userId}`,
-      sort: "-createdAt",
-      page,
-      perPage,
-    });
-  }
-
-  async findById(id: string): Promise<Order | null> {
-    return this.repo.findById(id);
-  }
-
-  async create(data: Omit<Order, "id">): Promise<Order> {
-    return this.repo.create(data);
-  }
-
-  async update(id: string, data: Partial<Order>): Promise<Order> {
-    return this.repo.update(id, data);
-  }
-
-  async updateStatus(id: string, status: OrderStatus): Promise<Order> {
-    return this.repo.update(id, { orderStatus: status });
-  }
-
-  async delete(id: string): Promise<void> {
-    return this.repo.delete(id);
-  }
-}

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

@@ -1,82 +0,0 @@
-import { z } from "zod";
-
-// ─── Sub-schemas ──────────────────────────────────────────────────────────────
-
-export const orderStatusSchema = z.enum([
-  "pending",
-  "confirmed",
-  "processing",
-  "shipped",
-  "delivered",
-  "cancelled",
-  "refunded",
-  "return_requested",
-  "returned",
-]);
-
-export const orderItemSchema = z.object({
-  productId: z.string(),
-  title: z.string(),
-  image: z.string().optional(),
-  price: z.number(),
-  quantity: z.number(),
-  currency: z.string().optional(),
-  sellerId: z.string().optional(),
-  attributes: z.record(z.string()).optional(),
-});
-
-export const orderTimelineSchema = z.object({
-  status: orderStatusSchema,
-  message: z.string().optional(),
-  timestamp: z.string(),
-  actor: z.string().optional(),
-});
-
-// ─── Base item schema ─────────────────────────────────────────────────────────
-
-/**
- * Base Zod schema for an order.
- * Apps can extend this to add their own fields:
- *
- * @example
- * import { orderSchema } from "@mohasinac/feat-orders";
- *
- * const myOrderSchema = orderSchema.extend({
- *   giftMessage: z.string().optional(),
- *   loyaltyPointsEarned: z.number().optional(),
- * });
- * type MyOrder = z.infer<typeof myOrderSchema>;
- */
-export const orderSchema = z.object({
-  id: z.string(),
-  userId: z.string(),
-  items: z.array(orderItemSchema),
-  // address shape is intentionally open to allow extending apps
-  address: z.record(z.unknown()),
-  orderStatus: orderStatusSchema,
-  paymentStatus: z.string(),
-  paymentGateway: z.string().optional(),
-  subtotal: z.number(),
-  shippingCost: z.number().optional(),
-  discount: z.number().optional(),
-  tax: z.number().optional(),
-  total: z.number(),
-  currency: z.string(),
-  couponCode: z.string().optional(),
-  trackingNumber: z.string().optional(),
-  shippingCarrier: z.string().optional(),
-  notes: z.string().optional(),
-  timeline: z.array(orderTimelineSchema).optional(),
-  createdAt: z.string().optional(),
-  updatedAt: z.string().optional(),
-});
-
-/** Base schema for list-query parameters. */
-export const orderListParamsSchema = z.object({
-  userId: z.string().optional(),
-  orderStatus: orderStatusSchema.optional(),
-  paymentStatus: z.string().optional(),
-  sort: z.string().optional(),
-  page: z.coerce.number().optional(),
-  perPage: z.coerce.number().optional(),
-});

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

@@ -1,97 +0,0 @@
-export type PaymentGateway =
-  | "razorpay"
-  | "stripe"
-  | "paypal"
-  | "cod"
-  | "upi"
-  | "whatsapp";
-
-export type PaymentStatus =
-  | "pending"
-  | "processing"
-  | "paid"
-  | "failed"
-  | "refunded"
-  | "partial_refund";
-
-export interface UserAddress {
-  id: string;
-  label?: string;
-  line1: string;
-  line2?: string;
-  city: string;
-  state: string;
-  postalCode: string;
-  country: string;
-  isDefault?: boolean;
-  phone?: string;
-}
-
-export type OrderStatus =
-  | "pending"
-  | "confirmed"
-  | "processing"
-  | "shipped"
-  | "delivered"
-  | "cancelled"
-  | "refunded"
-  | "return_requested"
-  | "returned";
-
-export interface OrderItem {
-  productId: string;
-  title: string;
-  image?: string;
-  price: number;
-  quantity: number;
-  currency?: string;
-  sellerId?: string;
-  attributes?: Record<string, string>;
-}
-
-export interface OrderTimeline {
-  status: OrderStatus;
-  message?: string;
-  timestamp: string;
-  actor?: string;
-}
-
-export interface Order {
-  id: string;
-  userId: string;
-  items: OrderItem[];
-  address: UserAddress;
-  orderStatus: OrderStatus;
-  paymentStatus: PaymentStatus;
-  paymentGateway?: PaymentGateway;
-  subtotal: number;
-  shippingCost?: number;
-  discount?: number;
-  tax?: number;
-  total: number;
-  currency: string;
-  couponCode?: string;
-  trackingNumber?: string;
-  shippingCarrier?: string;
-  notes?: string;
-  timeline?: OrderTimeline[];
-  createdAt?: string;
-  updatedAt?: string;
-}
-
-export interface OrderListResponse {
-  items: Order[];
-  total: number;
-  page: number;
-  perPage: number;
-  totalPages: number;
-}
-
-export interface OrderListParams {
-  userId?: string;
-  orderStatus?: OrderStatus;
-  paymentStatus?: PaymentStatus;
-  sort?: string;
-  page?: number;
-  perPage?: number;
-}

package/src/features/orders/utils/order-splitter.ts

@@ -1,48 +0,0 @@
-export type OrderType = "standard" | "preorder" | "auction" | "offer";
-
-export interface OrderGroup<T> {
-  items: T[];
-  orderType: OrderType;
-}
-
-export function splitCartIntoOrderGroups<
-  T extends {
-    item: {
-      itemId: string;
-      sellerId?: string;
-      isAuction?: boolean;
-      isPreOrder?: boolean;
-      isOffer?: boolean;
-    };
-  },
->(checks: T[]): OrderGroup<T>[] {
-  const groups = new Map<string, OrderGroup<T>>();
-
-  for (const check of checks) {
-    const { item } = check;
-    let key: string;
-    let orderType: OrderType;
-
-    if (item.isAuction) {
-      key = `auction:${item.itemId}`;
-      orderType = "auction";
-    } else if (item.isOffer) {
-      key = `offer:${item.itemId}`;
-      orderType = "offer";
-    } else if (item.isPreOrder) {
-      key = `preorder:${item.sellerId ?? "unknown"}`;
-      orderType = "preorder";
-    } else {
-      key = `standard:${item.sellerId ?? "unknown"}`;
-      orderType = "standard";
-    }
-
-    if (!groups.has(key)) {
-      groups.set(key, { items: [], orderType });
-    }
-
-    groups.get(key)!.items.push(check);
-  }
-
-  return Array.from(groups.values());
-}

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

@@ -1,67 +0,0 @@
-import type { TableColumn, ColumnExtensionOpts } from "../../../contracts";
-import type { PaymentRecord } from "../types";
-
-/**
- * Default admin columns for payment records.
- * Use `buildPaymentColumns()` to customise via overrides / extras / omit.
- */
-export const paymentAdminColumns: TableColumn<PaymentRecord>[] = [
-  {
-    key: "orderId",
-    header: "Order ID",
-    sortable: false,
-  },
-  {
-    key: "gateway",
-    header: "Gateway",
-    sortable: false,
-  },
-  {
-    key: "amount",
-    header: "Amount",
-    sortable: true,
-    render: (item) => `${item.currency ?? "INR"} ${item.amount}`,
-  },
-  {
-    key: "status",
-    header: "Status",
-    sortable: false,
-  },
-  {
-    key: "createdAt",
-    header: "Date",
-    sortable: true,
-  },
-];
-
-/**
- * Factory that returns columns for the payments admin table.
- *
- * @example
- * const cols = buildPaymentColumns<MyPaymentRecord>({
- *   extras: [{ key: "bankReference", header: "Bank Ref", render: (p) => p.bankReference }],
- *   omit: ["gateway"],
- * });
- */
-export function buildPaymentColumns<T extends PaymentRecord = PaymentRecord>(
-  opts?: ColumnExtensionOpts<T>
-): TableColumn<T>[] {
-  let base = paymentAdminColumns as unknown as TableColumn<T>[];
-
-  if (opts?.omit?.length) {
-    base = base.filter((c) => !opts.omit!.includes(c.key as string));
-  }
-
-  if (opts?.overrides) {
-    base = base.map((c) => {
-      const override = (opts.overrides as Record<string, Partial<TableColumn<T>>>)[c.key as string];
-      return override ? { ...c, ...override } : c;
-    });
-  }
-
-  if (opts?.extras?.length) {
-    base = [...base, ...opts.extras];
-  }
-
-  return base;
-}

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

@@ -1 +0,0 @@
-export {};

package/src/features/payments/hooks/usePayments.ts

@@ -1,23 +0,0 @@
-"use client";
-import { useQuery } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-import type { PaymentSettings } from "../types";
-
-export function usePaymentSettings(opts?: {
-  initialData?: PaymentSettings;
-  enabled?: boolean;
-}) {
-  const query = useQuery<PaymentSettings>({
-    queryKey: ["payment-settings"],
-    queryFn: () =>
-      apiClient.get<PaymentSettings>("/api/admin/payments/settings"),
-    initialData: opts?.initialData,
-    enabled: opts?.enabled,
-    staleTime: 10 * 60 * 1000,
-  });
-  return {
-    settings: query.data,
-    isLoading: query.isLoading,
-    error: query.error,
-  };
-}