@mohasinac/appkit 2.1.3 → 2.3.0

package/src/features/search/repository/search.repository.ts

@@ -1,64 +0,0 @@
-import type {
-  IReadRepository,
-  SieveQuery,
-  PagedResult,
-} from "../../../contracts";
-import type { SearchProductItem, SearchQuery, SearchResponse } from "../types";
-
-/**
- * SearchRepository
- *
- * Wraps IReadRepository<SearchProductItem> to provide domain-specific
- * search query building. Injected at the application layer — this class
- * has zero knowledge of Firestore, Prisma, or any concrete DB.
- */
-export class SearchRepository {
-  constructor(private readonly repo: IReadRepository<SearchProductItem>) {}
-
-  async search(query: SearchQuery): Promise<SearchResponse> {
-    const filterParts: string[] = [];
-
-    if (query.q) filterParts.push(`title_=${query.q}`);
-    if (query.category) filterParts.push(`category==${query.category}`);
-    if (query.subcategory)
-      filterParts.push(`subcategory==${query.subcategory}`);
-    if (query.minPrice !== undefined)
-      filterParts.push(`price>=${String(query.minPrice)}`);
-    if (query.maxPrice !== undefined)
-      filterParts.push(`price<=${String(query.maxPrice)}`);
-    if (query.condition) filterParts.push(`condition==${query.condition}`);
-    if (query.isAuction === true) filterParts.push("isAuction==true");
-    if (query.isAuction === false) filterParts.push("isAuction==false");
-    if (query.isPreOrder === true) filterParts.push("isPreOrder==true");
-    if (query.inStock === true) filterParts.push("availableQuantity>0");
-    if (query.minRating !== undefined)
-      filterParts.push(`averageRating>=${String(query.minRating)}`);
-
-    filterParts.push("status==published");
-
-    const sieveQuery: SieveQuery = {
-      filters: filterParts.join(","),
-      sort: query.sort
-        ? query.sort.startsWith("-")
-          ? query.sort.slice(1)
-          : query.sort
-        : "createdAt",
-      order: query.sort?.startsWith("-") ? "desc" : "asc",
-      page: query.page ?? 1,
-      perPage: query.pageSize ?? 24,
-    };
-
-    const result: PagedResult<SearchProductItem> =
-      await this.repo.findAll(sieveQuery);
-
-    return {
-      items: result.data,
-      q: query.q ?? "",
-      total: result.total,
-      page: result.page,
-      pageSize: result.perPage,
-      totalPages: result.totalPages,
-      hasMore: result.page < result.totalPages,
-    };
-  }
-}

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

@@ -1,36 +0,0 @@
-import { z } from "zod";
-
-/**
- * Schema for a search result product item.
- *
- * @example
- * import { searchProductItemSchema } from "@mohasinac/feat-search";
- *
- * const mySchema = searchProductItemSchema.extend({
- *   brandTag: z.string().optional(),
- * });
- */
-export const searchProductItemSchema = z.object({
-  id: z.string(),
-  title: z.string(),
-  price: z.number().optional(),
-  currency: z.string().optional(),
-  mainImage: z.string().optional(),
-  status: z.string().optional(),
-  featured: z.boolean().optional(),
-  isAuction: z.boolean().optional(),
-  isPromoted: z.boolean().optional(),
-  slug: z.string(),
-});
-
-/**
- * Form/query schema for a search request.
- */
-export const searchQuerySchema = z.object({
-  q: z.string().min(1),
-  category: z.string().optional(),
-  minPrice: z.number().optional(),
-  maxPrice: z.number().optional(),
-  sort: z.string().optional(),
-  page: z.number().int().positive().default(1),
-});

package/src/features/search/server.ts

@@ -1,3 +0,0 @@
-export { SearchRepository } from "./repository/search.repository";
-export { manifest } from "./manifest";
-export { GET as searchGET, GET } from "./api/route";

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

@@ -1,59 +0,0 @@
-// Domain types for @mohasinac/feat-search
-
-// ─── Product card data used in search results ─────────────────────────────────
-
-export interface SearchProductItem {
-  id: string;
-  title: string;
-  description?: string;
-  price: number;
-  currency: string;
-  mainImage?: string;
-  images?: string[];
-  status: string;
-  featured?: boolean;
-  isAuction?: boolean;
-  currentBid?: number;
-  isPromoted?: boolean;
-  slug: string;
-  availableQuantity?: number;
-}
-
-// ─── Search API response ──────────────────────────────────────────────────────
-
-export interface SearchResponse {
-  items: SearchProductItem[];
-  q: string;
-  total: number;
-  page: number;
-  pageSize: number;
-  totalPages: number;
-  hasMore: boolean;
-}
-
-// ─── Search query parameters ──────────────────────────────────────────────────
-
-export interface SearchQuery {
-  q?: string;
-  category?: string;
-  subcategory?: string;
-  minPrice?: number;
-  maxPrice?: number;
-  condition?: string;
-  isAuction?: boolean;
-  isPreOrder?: boolean;
-  inStock?: boolean;
-  minRating?: number;
-  sort?: string;
-  page?: number;
-  pageSize?: number;
-}
-
-// ─── Category option for filter facets ───────────────────────────────────────
-
-export interface SearchCategoryOption {
-  id: string;
-  name: string;
-  slug?: string;
-  tier?: number;
-}

package/src/features/seller/api/coupons/route.ts

@@ -1,57 +0,0 @@
-/**
- * feat-seller — GET /api/seller/coupons
- *
- * Returns all coupons owned by the authenticated seller.
- * Queries the `coupons` collection filtered by `sellerId == uid`.
- *
- * Response: `{ success: true, data: { coupons: CouponDocument[], total: number } }`
- *
- * Consumer stub:
- * ```ts
- * // src/app/api/seller/coupons/route.ts
- * export { sellerCouponsGET as GET } from "@mohasinac/feat-seller";
- * ```
- */
-
-import { NextResponse } from "next/server.js";
-import { getProviders } from "../../../../contracts";
-import { createRouteHandler } from "../../../../next";
-
-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;
-}
-
-export const GET = createRouteHandler({
-  roles: ["seller", "admin", "moderator"],
-  handler: async ({ request, user }): Promise<NextResponse> => {
-    const url = new URL(request.url);
-    const page = Math.max(1, numParam(url, "page", 1));
-    const pageSize = Math.min(200, Math.max(1, numParam(url, "pageSize", 100)));
-    const sort =
-      url.searchParams.get("sorts") ??
-      url.searchParams.get("sort") ??
-      "-createdAt";
-
-    const { db } = getProviders();
-    if (!db)
-      return NextResponse.json(
-        { success: false, error: "DB not configured" },
-        { status: 503 },
-      );
-
-    const repo = db.getRepository<Record<string, unknown>>("coupons");
-    const result = await repo.findAll({
-      filters: `sellerId==${user!.uid}`,
-      sort,
-      page,
-      perPage: pageSize,
-    });
-
-    return NextResponse.json({
-      success: true,
-      data: { coupons: result.data, total: result.total },
-    });
-  },
-});

package/src/features/seller/api/offers/route.ts

@@ -1,73 +0,0 @@
-/**
- * feat-seller — GET /api/seller/offers
- *
- * Returns all incoming offers for the authenticated seller.
- * Queries the `offers` collection filtered by `sellerId == uid`.
- *
- * Response: `{ success: true, data: { offers: OfferDocument[], total: number } }`
- *
- * Consumer stub:
- * ```ts
- * // src/app/api/seller/offers/route.ts
- * export { sellerOffersGET as GET } from "@mohasinac/feat-seller";
- * ```
- */
-
-import { NextResponse } from "next/server.js";
-import { getProviders } from "../../../../contracts";
-import { createRouteHandler } from "../../../../next";
-
-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;
-}
-
-export const GET = createRouteHandler({
-  roles: ["seller", "admin", "moderator"],
-  handler: async ({ request, user }): Promise<NextResponse> => {
-    const url = new URL(request.url);
-    const page = Math.max(1, numParam(url, "page", 1));
-    const pageSize = Math.min(100, Math.max(1, numParam(url, "pageSize", 50)));
-    const sort =
-      url.searchParams.get("sorts") ??
-      url.searchParams.get("sort") ??
-      "-createdAt";
-
-    // Optional status filter passed by client
-    const parts: string[] = [`sellerId==${user!.uid}`];
-    const status = url.searchParams.get("status");
-    if (status && status !== "all") parts.push(`status==${status}`);
-    const extraFilters = url.searchParams.get("filters");
-    if (extraFilters) parts.push(extraFilters);
-
-    const { db } = getProviders();
-    if (!db)
-      return NextResponse.json(
-        { success: false, error: "DB not configured" },
-        { status: 503 },
-      );
-
-    const repo = db.getRepository<Record<string, unknown>>("offers");
-    const result = await repo.findAll({
-      filters: parts.join(","),
-      sort,
-      page,
-      perPage: pageSize,
-    });
-
-    const totalPages = Math.max(1, Math.ceil(result.total / pageSize));
-
-    return NextResponse.json({
-      success: true,
-      data: {
-        items: result.data,
-        total: result.total,
-        page: result.page,
-        pageSize,
-        totalPages,
-        hasMore: result.page < totalPages,
-      },
-    });
-  },
-});

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

@@ -1,75 +0,0 @@
-/**
- * feat-seller — GET /api/seller/products
- *
- * Returns the authenticated seller's own products.
- * Enforces `sellerId=={uid}` server-side to prevent spoofing.
- *
- * Response shape matches letitrip's local route exactly so the
- * `useSellerProducts` hook needs no transform.
- *
- * Consumer stub:
- * ```ts
- * export { sellerProductsGET as GET } from "@mohasinac/feat-seller";
- * ```
- */
-
-import { NextResponse } from "next/server.js";
-import { getProviders } from "../../../../contracts";
-import { createRouteHandler } from "../../../../next";
-
-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;
-}
-
-export const GET = createRouteHandler({
-  roles: ["seller", "admin", "moderator"],
-  handler: async ({ request, user }): Promise<NextResponse> => {
-    const url = new URL(request.url);
-    const page = Math.max(1, numParam(url, "page", 1));
-    const pageSize = Math.min(100, Math.max(1, numParam(url, "pageSize", 25)));
-    const clientFilters = url.searchParams.get("filters") ?? "";
-    const sort =
-      url.searchParams.get("sorts") ??
-      url.searchParams.get("sort") ??
-      "-createdAt";
-
-    // Server-side security: force sellerId filter so sellers can't see others' products
-    const sellerFilter = `sellerId==${user!.uid}`;
-    const combinedFilters = clientFilters
-      ? `${sellerFilter},${clientFilters}`
-      : sellerFilter;
-
-    const { db } = getProviders();
-    if (!db)
-      return NextResponse.json(
-        { success: false, error: "DB not configured" },
-        { status: 503 },
-      );
-
-    const repo = db.getRepository<Record<string, unknown>>("products");
-    const result = await repo.findAll({
-      filters: combinedFilters,
-      sort,
-      page,
-      perPage: pageSize,
-    });
-    const totalPages = Math.max(1, Math.ceil(result.total / pageSize));
-
-    // Keep same response shape as local route so useSellerProducts hook needs no changes
-    return NextResponse.json({
-      success: true,
-      data: {
-        products: result.data,
-        meta: {
-          page: result.page,
-          limit: pageSize,
-          total: result.total,
-          totalPages,
-          hasMore: result.page < totalPages,
-        },
-      },
-    });
-  },
-});

package/src/features/seller/api/store/route.ts

@@ -1,41 +0,0 @@
-/**
- * feat-seller — GET /api/seller/store
- *
- * Returns the authenticated seller's own StoreDocument.
- * Queries the `stores` collection filtered by `ownerId == uid`.
- *
- * Response: `{ success: true, data: { store: StoreDocument | null } }`
- *
- * Consumer stub:
- * ```ts
- * // src/app/api/seller/store/route.ts
- * export { sellerStoreGET as GET } from "@mohasinac/feat-seller";
- * ```
- */
-
-import { NextResponse } from "next/server.js";
-import { getProviders } from "../../../../contracts";
-import { createRouteHandler } from "../../../../next";
-
-export const GET = createRouteHandler({
-  roles: ["seller", "admin", "moderator"],
-  handler: async ({ user }): Promise<NextResponse> => {
-    const { db } = getProviders();
-    if (!db)
-      return NextResponse.json(
-        { success: false, error: "DB not configured" },
-        { status: 503 },
-      );
-
-    const repo = db.getRepository<Record<string, unknown>>("stores");
-    const result = await repo.findAll({
-      filters: `ownerId==${user!.uid}`,
-      perPage: 1,
-    });
-
-    return NextResponse.json({
-      success: true,
-      data: { store: result.data[0] ?? null },
-    });
-  },
-});

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

@@ -1,103 +0,0 @@
-import type { TableColumn, ColumnExtensionOpts } from "../../../contracts";
-import type { SellerStore, PayoutRecord } from "../types";
-
-// ─── Seller store columns ─────────────────────────────────────────────────────
-
-/**
- * Default admin column definitions for the seller/store admin table.
- *
- * @example
- * const columns = buildSellerColumns<MySeller>({
- *   extras: [{ key: "tier", header: "Tier", render: (s) => s.tier ?? "standard" }],
- * });
- */
-export const sellerAdminColumns: TableColumn<SellerStore>[] = [
-  { key: "storeName", header: "Store Name", sortable: true },
-  { key: "ownerId", header: "Owner ID" },
-  { key: "storeCategory", header: "Category", sortable: true },
-  { key: "status", header: "Status", sortable: true },
-  {
-    key: "isPublic",
-    header: "Public",
-    render: (s) => (s.isPublic ? "Yes" : "No"),
-  },
-  {
-    key: "totalProducts",
-    header: "Products",
-    sortable: true,
-    render: (s) => s.stats?.totalProducts?.toLocaleString() ?? "—",
-  },
-  {
-    key: "itemsSold",
-    header: "Sold",
-    sortable: true,
-    render: (s) => s.stats?.itemsSold?.toLocaleString() ?? "—",
-  },
-  {
-    key: "averageRating",
-    header: "Rating",
-    sortable: true,
-    render: (s) =>
-      s.stats?.averageRating != null
-        ? s.stats.averageRating.toFixed(1)
-        : "—",
-  },
-  { key: "createdAt", header: "Created", sortable: true },
-];
-
-export function buildSellerColumns<T extends SellerStore = SellerStore>(
-  opts?: ColumnExtensionOpts<T>,
-): TableColumn<T>[] {
-  const base = sellerAdminColumns 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;
-}
-
-// ─── Payout columns ───────────────────────────────────────────────────────────
-
-/**
- * Default admin column definitions for the payout table.
- *
- * @example
- * const columns = buildPayoutColumns<MyPayout>({
- *   extras: [{ key: "gstAmount", header: "GST", render: (p) => p.gstAmount ?? "—" }],
- * });
- */
-export const payoutAdminColumns: TableColumn<PayoutRecord>[] = [
-  { key: "sellerName", header: "Seller", sortable: true },
-  {
-    key: "amount",
-    header: "Amount",
-    sortable: true,
-    render: (p) => `${p.currency} ${p.amount.toLocaleString()}`,
-  },
-  {
-    key: "platformFee",
-    header: "Platform Fee",
-    render: (p) => `${p.currency} ${p.platformFee.toLocaleString()}`,
-  },
-  { key: "status", header: "Status", sortable: true },
-  { key: "paymentMethod", header: "Method" },
-  { key: "requestedAt", header: "Requested", sortable: true },
-  { key: "processedAt", header: "Processed", sortable: true },
-];
-
-export function buildPayoutColumns<T extends PayoutRecord = PayoutRecord>(
-  opts?: ColumnExtensionOpts<T>,
-): TableColumn<T>[] {
-  const base = payoutAdminColumns 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/seller/components/SellerAddressesView.tsx

@@ -1,32 +0,0 @@
-"use client";
-
-import React from "react";
-import { Div, Heading } from "../../../ui";
-
-export interface SellerAddressesViewProps {
-  labels?: { title?: string; addButton?: string };
-  renderHeader?: (onAdd: () => void) => React.ReactNode;
-  renderAddressList: (isLoading: boolean) => React.ReactNode;
-  renderModal?: () => React.ReactNode;
-  isLoading?: boolean;
-  className?: string;
-}
-
-export function SellerAddressesView({
-  labels = {},
-  renderHeader,
-  renderAddressList,
-  renderModal,
-  isLoading = false,
-  className = "",
-}: SellerAddressesViewProps) {
-  return (
-    <Div className={className}>
-      {renderHeader ? renderHeader(() => {}) : labels.title ? (
-        <Heading level={1} className="text-2xl font-bold mb-6">{labels.title}</Heading>
-      ) : null}
-      {renderAddressList(isLoading)}
-      {renderModal?.()}
-    </Div>
-  );
-}

package/src/features/seller/components/SellerAnalyticsView.tsx

@@ -1,38 +0,0 @@
-"use client";
-
-import React from "react";
-import { Div, Heading } from "../../../ui";
-
-export interface SellerAnalyticsViewProps {
-  labels?: { title?: string };
-  renderDateRange?: (from: string, to: string, onChange: (from: string, to: string) => void) => React.ReactNode;
-  renderStats?: (isLoading: boolean) => React.ReactNode;
-  renderCharts?: () => React.ReactNode;
-  renderTopProducts?: () => React.ReactNode;
-  isLoading?: boolean;
-  className?: string;
-}
-
-export function SellerAnalyticsView({
-  labels = {},
-  renderDateRange,
-  renderStats,
-  renderCharts,
-  renderTopProducts,
-  isLoading = false,
-  className = "",
-}: SellerAnalyticsViewProps) {
-  const [from, setFrom] = React.useState("");
-  const [to, setTo] = React.useState("");
-  return (
-    <Div className={className}>
-      {labels.title && (
-        <Heading level={1} className="text-2xl font-bold mb-6">{labels.title}</Heading>
-      )}
-      {renderDateRange?.(from, to, (f, t) => { setFrom(f); setTo(t); })}
-      {renderStats?.(isLoading)}
-      {renderCharts?.()}
-      {renderTopProducts?.()}
-    </Div>
-  );
-}

package/src/features/seller/components/SellerAuctionsView.tsx

@@ -1,48 +0,0 @@
-"use client";
-
-import React from "react";
-import { Div, Heading } from "../../../ui";
-
-export interface SellerAuctionsViewProps {
-  labels?: { title?: string; addButton?: string; emptyText?: string };
-  renderHeader?: (onAdd: () => void) => React.ReactNode;
-  renderSearch?: (value: string, onChange: (v: string) => void) => React.ReactNode;
-  renderFilters?: () => React.ReactNode;
-  renderActiveFilters?: () => React.ReactNode;
-  renderTable: (selectedIds: string[], onSelectionChange: (ids: string[]) => void, isLoading: boolean) => React.ReactNode;
-  renderPagination?: (total: number) => React.ReactNode;
-  renderModal?: () => React.ReactNode;
-  total?: number;
-  isLoading?: boolean;
-  className?: string;
-}
-
-export function SellerAuctionsView({
-  labels = {},
-  renderHeader,
-  renderSearch,
-  renderFilters,
-  renderActiveFilters,
-  renderTable,
-  renderPagination,
-  renderModal,
-  total = 0,
-  isLoading = false,
-  className = "",
-}: SellerAuctionsViewProps) {
-  const [search, setSearch] = React.useState("");
-  const [selectedIds, setSelectedIds] = React.useState<string[]>([]);
-  return (
-    <Div className={className}>
-      {renderHeader ? renderHeader(() => {}) : labels.title ? (
-        <Heading level={1} className="text-2xl font-bold mb-6">{labels.title}</Heading>
-      ) : null}
-      {renderSearch?.(search, setSearch)}
-      {renderFilters?.()}
-      {renderActiveFilters?.()}
-      {renderTable(selectedIds, setSelectedIds, isLoading)}
-      {renderPagination?.(total)}
-      {renderModal?.()}
-    </Div>
-  );
-}

package/src/features/seller/components/SellerCouponsView.tsx

@@ -1,48 +0,0 @@
-"use client";
-
-import React from "react";
-import { Div, Heading } from "../../../ui";
-
-export interface SellerCouponsViewProps {
-  labels?: { title?: string; addButton?: string; emptyText?: string };
-  renderHeader?: (onAdd: () => void) => React.ReactNode;
-  renderSearch?: (value: string, onChange: (v: string) => void) => React.ReactNode;
-  renderFilters?: () => React.ReactNode;
-  renderActiveFilters?: () => React.ReactNode;
-  renderTable: (selectedIds: string[], onSelectionChange: (ids: string[]) => void, isLoading: boolean) => React.ReactNode;
-  renderPagination?: (total: number) => React.ReactNode;
-  renderModal?: () => React.ReactNode;
-  total?: number;
-  isLoading?: boolean;
-  className?: string;
-}
-
-export function SellerCouponsView({
-  labels = {},
-  renderHeader,
-  renderSearch,
-  renderFilters,
-  renderActiveFilters,
-  renderTable,
-  renderPagination,
-  renderModal,
-  total = 0,
-  isLoading = false,
-  className = "",
-}: SellerCouponsViewProps) {
-  const [search, setSearch] = React.useState("");
-  const [selectedIds, setSelectedIds] = React.useState<string[]>([]);
-  return (
-    <Div className={className}>
-      {renderHeader ? renderHeader(() => {}) : labels.title ? (
-        <Heading level={1} className="text-2xl font-bold mb-6">{labels.title}</Heading>
-      ) : null}
-      {renderSearch?.(search, setSearch)}
-      {renderFilters?.()}
-      {renderActiveFilters?.()}
-      {renderTable(selectedIds, setSelectedIds, isLoading)}
-      {renderPagination?.(total)}
-      {renderModal?.()}
-    </Div>
-  );
-}