@mohasinac/appkit 2.1.3 → 2.3.0

package/src/features/seller/repository/seller.repository.ts

@@ -1,100 +0,0 @@
-import type {
-  IRepository,
-  PagedResult,
-  SieveQuery,
-} from "../../../contracts";
-import type { SellerStore, PayoutRecord } from "../types";
-
-export class SellerRepository {
-  constructor(private readonly repo: IRepository<SellerStore>) {}
-
-  async findAll(query?: SieveQuery): Promise<PagedResult<SellerStore>> {
-    return this.repo.findAll(query ?? {});
-  }
-
-  async findById(id: string): Promise<SellerStore | null> {
-    return this.repo.findById(id);
-  }
-
-  async findByOwner(ownerId: string): Promise<SellerStore | null> {
-    const result = await this.repo.findAll({
-      filters: `ownerId==${ownerId}`,
-      perPage: 1,
-    });
-    return result.data[0] ?? null;
-  }
-
-  async findBySlug(storeSlug: string): Promise<SellerStore | null> {
-    const result = await this.repo.findAll({
-      filters: `storeSlug==${storeSlug},status==active`,
-      perPage: 1,
-    });
-    return result.data[0] ?? null;
-  }
-
-  async findActive(page = 1, perPage = 20): Promise<PagedResult<SellerStore>> {
-    return this.repo.findAll({
-      filters: "status==active,isPublic==true",
-      sort: "-stats.totalProducts",
-      page,
-      perPage,
-    });
-  }
-
-  async create(
-    data: Omit<SellerStore, "id" | "createdAt" | "updatedAt">,
-  ): Promise<SellerStore> {
-    return this.repo.create(data);
-  }
-
-  async update(id: string, data: Partial<SellerStore>): Promise<SellerStore> {
-    return this.repo.update(id, data);
-  }
-}
-
-export class PayoutsRepository {
-  constructor(private readonly repo: IRepository<PayoutRecord>) {}
-
-  async findAll(query?: SieveQuery): Promise<PagedResult<PayoutRecord>> {
-    return this.repo.findAll(query ?? {});
-  }
-
-  async findBySeller(
-    sellerId: string,
-    page = 1,
-    perPage = 20,
-  ): Promise<PagedResult<PayoutRecord>> {
-    return this.repo.findAll({
-      filters: `sellerId==${sellerId}`,
-      sort: "-requestedAt",
-      page,
-      perPage,
-    });
-  }
-
-  async findPending(): Promise<PayoutRecord[]> {
-    const result = await this.repo.findAll({
-      filters: "status==pending",
-      sort: "requestedAt",
-    });
-    return result.data;
-  }
-
-  async create(
-    data: Omit<PayoutRecord, "id" | "createdAt" | "updatedAt">,
-  ): Promise<PayoutRecord> {
-    return this.repo.create(data);
-  }
-
-  async updateStatus(
-    id: string,
-    status: "processing" | "completed" | "failed",
-    adminNote?: string,
-  ): Promise<PayoutRecord> {
-    return this.repo.update(id, {
-      status,
-      adminNote,
-      processedAt: new Date().toISOString(),
-    });
-  }
-}

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

@@ -1,113 +0,0 @@
-import { z } from "zod";
-
-// ─── Sub-schemas ──────────────────────────────────────────────────────────────
-
-export const storeStatusSchema = z.enum([
-  "pending",
-  "active",
-  "suspended",
-  "rejected",
-]);
-
-export const payoutStatusSchema = z.enum([
-  "pending",
-  "processing",
-  "completed",
-  "failed",
-]);
-
-export const payoutPaymentMethodSchema = z.enum([
-  "bank_transfer",
-  "upi",
-]);
-
-export const socialLinksSchema = z.object({
-  twitter: z.string().optional(),
-  instagram: z.string().optional(),
-  facebook: z.string().optional(),
-  linkedin: z.string().optional(),
-});
-
-// ─── SellerStore schema ───────────────────────────────────────────────────────
-
-/**
- * Base Zod schema for a seller's store.
- * Apps can extend this to add their own fields:
- *
- * @example
- * import { sellerStoreSchema } from "@mohasinac/feat-seller";
- *
- * const mySellerSchema = sellerStoreSchema.extend({
- *   tier: z.enum(["standard", "premium"]).optional(),
- *   gstNumber: z.string().optional(),
- * });
- * type MySeller = z.infer<typeof mySellerSchema>;
- */
-export const sellerStoreSchema = z.object({
-  id: z.string(),
-  storeSlug: z.string(),
-  ownerId: z.string(),
-  storeName: z.string(),
-  storeDescription: z.string().optional(),
-  storeCategory: z.string().optional(),
-  storeLogoURL: z.string().optional(),
-  storeBannerURL: z.string().optional(),
-  status: storeStatusSchema,
-  bio: z.string().optional(),
-  location: z.string().optional(),
-  website: z.string().optional(),
-  socialLinks: socialLinksSchema.optional(),
-  returnPolicy: z.string().optional(),
-  shippingPolicy: z.string().optional(),
-  isPublic: z.boolean(),
-  isVacationMode: z.boolean().optional(),
-  vacationMessage: z.string().optional(),
-  stats: z
-    .object({
-      totalProducts: z.number(),
-      itemsSold: z.number(),
-      totalReviews: z.number(),
-      averageRating: z.number().optional(),
-    })
-    .optional(),
-  createdAt: z.string(),
-  updatedAt: z.string(),
-});
-
-// ─── PayoutRecord schema ──────────────────────────────────────────────────────
-
-export const payoutRecordSchema = z.object({
-  id: z.string(),
-  sellerId: z.string(),
-  sellerName: z.string(),
-  sellerEmail: z.string(),
-  amount: z.number(),
-  grossAmount: z.number(),
-  platformFee: z.number(),
-  platformFeeRate: z.number(),
-  currency: z.string(),
-  status: payoutStatusSchema,
-  paymentMethod: payoutPaymentMethodSchema,
-  orderIds: z.array(z.string()),
-  requestedAt: z.string(),
-  processedAt: z.string().optional(),
-  createdAt: z.string(),
-  updatedAt: z.string(),
-});
-
-export const sellerListParamsSchema = z.object({
-  status: storeStatusSchema.optional(),
-  category: z.string().optional(),
-  q: z.string().optional(),
-  page: z.coerce.number().optional(),
-  perPage: z.coerce.number().optional(),
-  sort: z.string().optional(),
-});
-
-export const payoutListParamsSchema = z.object({
-  sellerId: z.string().optional(),
-  status: payoutStatusSchema.optional(),
-  page: z.coerce.number().optional(),
-  perPage: z.coerce.number().optional(),
-  sort: z.string().optional(),
-});

package/src/features/seller/server.ts

@@ -1,10 +0,0 @@
-/**
- * @mohasinac/appkit/features/seller/server
- *
- * Server-only entry point for seller API route handlers.
- */
-
-export { GET as sellerProductsGET } from "./api/products/route";
-export { GET as sellerStoreGET } from "./api/store/route";
-export { GET as sellerCouponsGET } from "./api/coupons/route";
-export { GET as sellerOffersGET } from "./api/offers/route";

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

@@ -1,185 +0,0 @@
-// ─── Store ────────────────────────────────────────────────────────────────────
-
-export type StoreStatus = "pending" | "active" | "suspended" | "rejected";
-
-export interface SellerStore {
-  id: string;
-  storeSlug: string;
-  ownerId: string;
-  storeName: string;
-  storeDescription?: string;
-  storeCategory?: string;
-  storeLogoURL?: string;
-  storeBannerURL?: string;
-  status: StoreStatus;
-  bio?: string;
-  location?: string;
-  website?: string;
-  socialLinks?: {
-    twitter?: string;
-    instagram?: string;
-    facebook?: string;
-    linkedin?: string;
-  };
-  returnPolicy?: string;
-  shippingPolicy?: string;
-  isPublic: boolean;
-  isVacationMode?: boolean;
-  vacationMessage?: string;
-  stats?: {
-    totalProducts: number;
-    itemsSold: number;
-    totalReviews: number;
-    averageRating?: number;
-  };
-  createdAt: string;
-  updatedAt: string;
-}
-
-// ─── Payout ───────────────────────────────────────────────────────────────────
-
-export type PayoutStatus = "pending" | "processing" | "completed" | "failed";
-export type PayoutPaymentMethod = "bank_transfer" | "upi";
-
-export interface PayoutBankAccount {
-  accountHolderName: string;
-  accountNumberMasked: string;
-  ifscCode: string;
-  bankName: string;
-}
-
-export interface PayoutRecord {
-  id: string;
-  sellerId: string;
-  sellerName: string;
-  sellerEmail: string;
-  amount: number;
-  grossAmount: number;
-  platformFee: number;
-  platformFeeRate: number;
-  currency: string;
-  status: PayoutStatus;
-  paymentMethod: PayoutPaymentMethod;
-  bankAccount?: PayoutBankAccount;
-  upiId?: string;
-  notes?: string;
-  adminNote?: string;
-  orderIds: string[];
-  gatewayFee?: number;
-  gstAmount?: number;
-  isAutomatic?: boolean;
-  requestedAt: string;
-  processedAt?: string;
-  createdAt: string;
-  updatedAt: string;
-}
-
-// ─── Payout settings ──────────────────────────────────────────────────────────
-
-export interface SellerPayoutSettings {
-  preferredMethod: PayoutPaymentMethod;
-  bankAccount?: PayoutBankAccount;
-  upiId?: string;
-  autoPayoutEnabled: boolean;
-  autoPayoutThreshold: number;
-}
-
-// ─── Dashboard stats ──────────────────────────────────────────────────────────
-
-export interface SellerDashboardStats {
-  totalRevenue: number;
-  pendingPayouts: number;
-  activeListings: number;
-  totalOrders: number;
-  pendingOrders: number;
-  averageRating?: number;
-  currency: string;
-}
-
-// ─── Analytics ────────────────────────────────────────────────────────────────
-
-export interface SellerRevenueDataPoint {
-  date: string;
-  revenue: number;
-  orders: number;
-}
-
-export interface SellerAnalytics {
-  revenueData: SellerRevenueDataPoint[];
-  topProducts: Array<{
-    productId: string;
-    title: string;
-    revenue: number;
-    orders: number;
-  }>;
-  conversionRate: number;
-  period: string;
-}
-
-export interface SellerAnalyticsSummary {
-  totalOrders: number;
-  totalRevenue: number;
-  totalProducts: number;
-  publishedProducts: number;
-}
-
-export interface SellerAnalyticsMonthEntry {
-  month: string;
-  orders: number;
-  revenue: number;
-}
-
-export interface SellerAnalyticsTopProduct {
-  productId: string;
-  title: string;
-  revenue: number;
-  orders: number;
-  mainImage?: string;
-}
-
-// ─── List responses ───────────────────────────────────────────────────────────
-
-export interface PayoutListResponse {
-  items: PayoutRecord[];
-  total: number;
-  page: number;
-  pageSize: number;
-  totalPages: number;
-  hasMore: boolean;
-}
-
-export interface SellerListResponse {
-  items: SellerStore[];
-  total: number;
-  page: number;
-  pageSize: number;
-  totalPages: number;
-  hasMore: boolean;
-}
-
-// ─── Inputs ───────────────────────────────────────────────────────────────────
-
-export interface UpdateSellerStoreInput {
-  storeName?: string;
-  storeDescription?: string;
-  storeCategory?: string;
-  bio?: string;
-  location?: string;
-  website?: string;
-  socialLinks?: SellerStore["socialLinks"];
-  returnPolicy?: string;
-  shippingPolicy?: string;
-  isPublic?: boolean;
-  isVacationMode?: boolean;
-  vacationMessage?: string;
-}
-
-export interface RequestPayoutInput {
-  amount: number;
-  currency: string;
-  paymentMethod: PayoutPaymentMethod;
-  bankAccount?: PayoutBankAccount;
-  upiId?: string;
-  notes?: string;
-  orderIds: string[];
-}

package/src/features/stores/api/[storeSlug]/auctions/route.ts

@@ -1,134 +0,0 @@
-/**
- * feat-stores — store auctions (GET /api/stores/[storeSlug]/auctions)
- *
- * 2-line stub:
- * ```ts
- * // app/api/stores/[storeSlug]/auctions/route.ts
- * export { storeAuctionsGET as GET } from "@mohasinac/feat-stores";
- * ```
- *
- * Returns published auction listings for a store, paginated.
- * Query params: sorts, page, pageSize, filters (extra Sieve filter string).
- *
- * Requires `db` registered in providers.config via `registerProviders()`.
- * Collections: "stores", "products"
- */
-
-import { NextResponse } from "next/server.js";
-import { getProviders } from "../../../../../contracts";
-import type {
-  StoreAuctionItem,
-  StoreProductsResponse,
-} from "../../../types/index";
-
-interface StoreEntity {
-  ownerId: string;
-}
-
-const SAFE_STORE_AUCTION_FILTER_FIELDS = new Set(["price", "category"]);
-
-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(",");
-}
-
-type RouteContext = { params: Promise<{ storeSlug: string }> };
-
-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/stores/[storeSlug]/auctions ─────────────────────────────────────
-export async function GET(
-  request: Request,
-  context: RouteContext,
-): Promise<NextResponse> {
-  try {
-    const { storeSlug } = await context.params;
-    const url = new URL(request.url);
-
-    const { db } = getProviders();
-    if (!db) {
-      return NextResponse.json(
-        { success: false, error: "Database provider not registered" },
-        { status: 503 },
-      );
-    }
-
-    // Resolve store by slug
-    const storesRepo = db.getRepository<StoreEntity>("stores");
-    const storeResult = await storesRepo.findAll({
-      filters: `storeSlug==${storeSlug},status==active,isPublic==true`,
-      perPage: 1,
-    });
-    const store = storeResult.data[0];
-    if (!store) {
-      return NextResponse.json(
-        { success: false, error: "Store not found" },
-        { status: 404 },
-      );
-    }
-
-    const sort = param(url, "sorts") ?? "-createdAt";
-    const page = numParam(url, "page", 1);
-    const pageSize = numParam(url, "pageSize", 24);
-
-    const filterParts = [
-      `sellerId==${store.ownerId}`,
-      "status==published",
-      "isAuction==true",
-    ];
-    const extra = param(url, "filters");
-    if (extra) {
-      const safe = validateSieveFilters(
-        extra,
-        SAFE_STORE_AUCTION_FILTER_FIELDS,
-      );
-      if (safe) filterParts.push(safe);
-    }
-
-    const productsRepo = db.getRepository<StoreAuctionItem>("products");
-    const result = await productsRepo.findAll({
-      filters: filterParts.join(","),
-      sort,
-      order: sort.startsWith("-") ? "desc" : "asc",
-      page,
-      perPage: pageSize,
-    });
-
-    const body: StoreProductsResponse = {
-      items: result.data,
-      total: result.total,
-      page: result.page,
-      pageSize: result.perPage,
-      totalPages: result.totalPages,
-      hasMore: result.page < result.totalPages,
-    };
-
-    return NextResponse.json({ success: true, data: body });
-  } catch (error) {
-    console.error(
-      "[feat-stores] GET /api/stores/[storeSlug]/auctions failed",
-      error,
-    );
-    return NextResponse.json(
-      { success: false, error: "Failed to fetch store auctions" },
-      { status: 500 },
-    );
-  }
-}

package/src/features/stores/api/[storeSlug]/products/route.ts

@@ -1,139 +0,0 @@
-/**
- * feat-stores — store products (GET /api/stores/[storeSlug]/products)
- *
- * 2-line stub:
- * ```ts
- * // app/api/stores/[storeSlug]/products/route.ts
- * export { storeProductsGET as GET } from "@mohasinac/feat-stores";
- * ```
- *
- * Returns published non-auction products for a store, paginated.
- * Query params: sorts, page, pageSize, filters (extra Sieve filter string).
- *
- * Requires `db` registered in providers.config via `registerProviders()`.
- * Collections: "stores", "products"
- */
-
-import { NextResponse } from "next/server.js";
-import { getProviders } from "../../../../../contracts";
-import type {
-  StoreProductItem,
-  StoreProductsResponse,
-} from "../../../types/index";
-
-interface StoreEntity {
-  ownerId: string;
-}
-
-type RouteContext = { params: Promise<{ storeSlug: string }> };
-
-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;
-}
-
-const SAFE_STORE_PRODUCT_FILTER_FIELDS = new Set([
-  "category",
-  "price",
-  "brand",
-  "condition",
-]);
-
-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(",");
-}
-
-// ─── GET /api/stores/[storeSlug]/products ─────────────────────────────────────
-export async function GET(
-  request: Request,
-  context: RouteContext,
-): Promise<NextResponse> {
-  try {
-    const { storeSlug } = await context.params;
-    const url = new URL(request.url);
-
-    const { db } = getProviders();
-    if (!db) {
-      return NextResponse.json(
-        { success: false, error: "Database provider not registered" },
-        { status: 503 },
-      );
-    }
-
-    // Resolve store by slug
-    const storesRepo = db.getRepository<StoreEntity>("stores");
-    const storeResult = await storesRepo.findAll({
-      filters: `storeSlug==${storeSlug},status==active,isPublic==true`,
-      perPage: 1,
-    });
-    const store = storeResult.data[0];
-    if (!store) {
-      return NextResponse.json(
-        { success: false, error: "Store not found" },
-        { status: 404 },
-      );
-    }
-
-    const sort = param(url, "sorts") ?? "-createdAt";
-    const page = numParam(url, "page", 1);
-    const pageSize = numParam(url, "pageSize", 24);
-
-    const filterParts = [
-      `sellerId==${store.ownerId}`,
-      "status==published",
-      "isAuction==false",
-    ];
-    const extra = param(url, "filters");
-    if (extra) {
-      const safe = validateSieveFilters(
-        extra,
-        SAFE_STORE_PRODUCT_FILTER_FIELDS,
-      );
-      if (safe) filterParts.push(safe);
-    }
-
-    const productsRepo = db.getRepository<StoreProductItem>("products");
-    const result = await productsRepo.findAll({
-      filters: filterParts.join(","),
-      sort,
-      order: sort.startsWith("-") ? "desc" : "asc",
-      page,
-      perPage: pageSize,
-    });
-
-    const body: StoreProductsResponse = {
-      items: result.data,
-      total: result.total,
-      page: result.page,
-      pageSize: result.perPage,
-      totalPages: result.totalPages,
-      hasMore: result.page < result.totalPages,
-    };
-
-    return NextResponse.json({ success: true, data: body });
-  } catch (error) {
-    console.error(
-      "[feat-stores] GET /api/stores/[storeSlug]/products failed",
-      error,
-    );
-    return NextResponse.json(
-      { success: false, error: "Failed to fetch store products" },
-      { status: 500 },
-    );
-  }
-}