@mohasinac/appkit 2.1.3 → 2.3.0

package/src/seed/factories/category.factory.ts

@@ -1,30 +0,0 @@
-// appkit/src/seed/factories/category.factory.ts
-let _seq = 1;
-
-export interface SeedCategoryDocument {
-  id: string;
-  name: string;
-  slug: string;
-  parentId?: string | null;
-  icon?: string;
-  image?: string;
-  sortOrder: number;
-  isActive: boolean;
-}
-
-export function makeCategory(
-  overrides: Partial<SeedCategoryDocument> = {},
-): SeedCategoryDocument {
-  const n = _seq++;
-  return {
-    id: overrides.id ?? `category-${n}`,
-    name: overrides.name ?? `Category ${n}`,
-    slug: overrides.slug ?? `category-${n}`,
-    parentId: overrides.parentId ?? null,
-    icon: overrides.icon,
-    image: overrides.image,
-    sortOrder: overrides.sortOrder ?? n,
-    isActive: overrides.isActive ?? true,
-    ...overrides,
-  };
-}

package/src/seed/factories/coupon.factory.ts

@@ -1,67 +0,0 @@
-// appkit/src/seed/factories/coupon.factory.ts
-let _seq = 1;
-
-export type CouponDiscountType = "percent" | "fixed";
-
-export interface SeedCouponDocument {
-  id: string;
-  code: string;
-  discountType: CouponDiscountType;
-  discountValue: number;
-  minOrderAmount?: number;
-  maxUses?: number;
-  usedCount?: number;
-  expiresAt?: Date;
-  sellerId?: string;
-  isActive?: boolean;
-  createdAt: Date;
-  updatedAt: Date;
-}
-
-export function makeCoupon(
-  overrides: Partial<SeedCouponDocument> = {},
-): SeedCouponDocument {
-  const n = _seq++;
-  const now = new Date();
-  return {
-    id: overrides.id ?? `coupon-${n}`,
-    code: overrides.code ?? `SAVE${n * 10}`,
-    discountType: overrides.discountType ?? "percent",
-    discountValue: overrides.discountValue ?? 10,
-    usedCount: overrides.usedCount ?? 0,
-    isActive: overrides.isActive ?? true,
-    createdAt: overrides.createdAt ?? now,
-    updatedAt: overrides.updatedAt ?? now,
-    ...overrides,
-  };
-}
-
-export function makeFullCoupon(
-  overrides: Partial<SeedCouponDocument> = {},
-): SeedCouponDocument {
-  const expiresAt = new Date();
-  expiresAt.setMonth(expiresAt.getMonth() + 3);
-  return makeCoupon({
-    minOrderAmount: 500,
-    maxUses: 100,
-    expiresAt,
-    sellerId: "seller-1",
-    ...overrides,
-  });
-}
-
-export const COUPON_FIXTURES = {
-  percentOff: makeFullCoupon({
-    id: "coupon-1",
-    code: "WELCOME10",
-    discountType: "percent",
-    discountValue: 10,
-  }),
-  fixedOff: makeFullCoupon({
-    id: "coupon-2",
-    code: "FLAT100",
-    discountType: "fixed",
-    discountValue: 100,
-    minOrderAmount: 999,
-  }),
-};

package/src/seed/factories/faq.factory.ts

@@ -1,28 +0,0 @@
-// appkit/src/seed/factories/faq.factory.ts
-let _seq = 1;
-
-export interface SeedFaqDocument {
-  id: string;
-  question: string;
-  answer: string;
-  category: string;
-  sortOrder: number;
-  voteCount: number;
-  isActive: boolean;
-}
-
-export function makeFaq(
-  overrides: Partial<SeedFaqDocument> = {},
-): SeedFaqDocument {
-  const n = _seq++;
-  return {
-    id: overrides.id ?? `faq-${n}`,
-    question: overrides.question ?? `Frequently asked question ${n}`,
-    answer: overrides.answer ?? "This is the answer to the frequently asked question.",
-    category: overrides.category ?? "general",
-    sortOrder: overrides.sortOrder ?? n,
-    voteCount: overrides.voteCount ?? 0,
-    isActive: overrides.isActive ?? true,
-    ...overrides,
-  };
-}

package/src/seed/factories/homepage-section.factory.ts

@@ -1,35 +0,0 @@
-// appkit/src/seed/factories/homepage-section.factory.ts
-let _seq = 1;
-
-export type HomepageSectionType =
-  | "hero"
-  | "featured-products"
-  | "categories"
-  | "blog"
-  | "faqs"
-  | "stats"
-  | "testimonials"
-  | "banner";
-
-export interface SeedHomepageSectionDocument {
-  id: string;
-  type: HomepageSectionType;
-  sortOrder: number;
-  isActive: boolean;
-  content: Record<string, unknown>;
-}
-
-export function makeHomepageSection(
-  type: HomepageSectionType,
-  overrides: Partial<SeedHomepageSectionDocument> = {},
-): SeedHomepageSectionDocument {
-  const n = _seq++;
-  return {
-    id: overrides.id ?? `section-${n}`,
-    type,
-    sortOrder: overrides.sortOrder ?? n,
-    isActive: overrides.isActive ?? true,
-    content: overrides.content ?? {},
-    ...overrides,
-  };
-}

package/src/seed/factories/notification.factory.ts

@@ -1,68 +0,0 @@
-// appkit/src/seed/factories/notification.factory.ts
-let _seq = 1;
-
-export type NotificationType =
-  | "order_placed"
-  | "order_shipped"
-  | "order_delivered"
-  | "order_cancelled"
-  | "bid_outbid"
-  | "bid_won"
-  | "review_received"
-  | "payout_completed"
-  | "system";
-
-export interface SeedNotificationDocument {
-  id: string;
-  userId: string;
-  type: NotificationType | string;
-  title: string;
-  body?: string;
-  read?: boolean;
-  link?: string;
-  createdAt: Date;
-}
-
-export function makeNotification(
-  overrides: Partial<SeedNotificationDocument> = {},
-): SeedNotificationDocument {
-  const n = _seq++;
-  return {
-    id: overrides.id ?? `notification-${n}`,
-    userId: overrides.userId ?? `user-${n}`,
-    type: overrides.type ?? "system",
-    title: overrides.title ?? `Notification ${n}`,
-    read: overrides.read ?? false,
-    createdAt: overrides.createdAt ?? new Date(),
-    ...overrides,
-  };
-}
-
-export function makeFullNotification(
-  overrides: Partial<SeedNotificationDocument> = {},
-): SeedNotificationDocument {
-  return makeNotification({
-    body: "Your order has been shipped and is on its way.",
-    link: "/orders/order-1",
-    ...overrides,
-  });
-}
-
-export const NOTIFICATION_FIXTURES = {
-  orderShipped: makeFullNotification({
-    id: "notification-1",
-    userId: "buyer-user-1",
-    type: "order_shipped",
-    title: "Your order has shipped!",
-    body: "Order #1234 is on its way. Expected delivery: 2–3 days.",
-    link: "/orders/order-1",
-  }),
-  bidWon: makeFullNotification({
-    id: "notification-2",
-    userId: "buyer-user-1",
-    type: "bid_won",
-    title: "You won the auction!",
-    body: "Congratulations! You won the auction for Product 1.",
-    link: "/auctions/auction-1",
-  }),
-};

package/src/seed/factories/order.factory.ts

@@ -1,43 +0,0 @@
-// appkit/src/seed/factories/order.factory.ts
-let _seq = 1;
-
-export interface SeedBaseOrderItem {
-  productId: string;
-  productTitle: string;
-  quantity: number;
-  unitPrice: number;
-  totalPrice: number;
-}
-
-export interface SeedBaseOrderDocument {
-  id: string;
-  userId: string;
-  items: SeedBaseOrderItem[];
-  status: "pending" | "confirmed" | "shipped" | "delivered" | "cancelled";
-  paymentStatus: "pending" | "paid" | "failed" | "refunded";
-  totalPrice: number;
-  currency: string;
-  orderDate: Date;
-  createdAt: Date;
-  updatedAt: Date;
-}
-
-export function makeOrder(
-  overrides: Partial<SeedBaseOrderDocument> = {},
-): SeedBaseOrderDocument {
-  const n = _seq++;
-  const now = new Date();
-  return {
-    id: overrides.id ?? `order-${n}`,
-    userId: overrides.userId ?? "user-1",
-    items: overrides.items ?? [],
-    status: overrides.status ?? "confirmed",
-    paymentStatus: overrides.paymentStatus ?? "paid",
-    totalPrice: overrides.totalPrice ?? 0,
-    currency: overrides.currency ?? "INR",
-    orderDate: overrides.orderDate ?? now,
-    createdAt: overrides.createdAt ?? now,
-    updatedAt: overrides.updatedAt ?? now,
-    ...overrides,
-  };
-}

package/src/seed/factories/payout.factory.ts

@@ -1,62 +0,0 @@
-// appkit/src/seed/factories/payout.factory.ts
-let _seq = 1;
-
-export type PayoutStatus = "pending" | "processing" | "paid" | "failed";
-
-export interface SeedPayoutDocument {
-  id: string;
-  sellerId: string;
-  orderId: string;
-  amount: number;
-  status: PayoutStatus;
-  platformFee?: number;
-  commissionRate?: number;
-  settledAt?: Date;
-  /** PII — encrypted before Firestore write by seed runner */
-  bankAccount?: string;
-  createdAt: Date;
-  updatedAt: Date;
-}
-
-export function makePayout(
-  overrides: Partial<SeedPayoutDocument> = {},
-): SeedPayoutDocument {
-  const n = _seq++;
-  const now = new Date();
-  return {
-    id: overrides.id ?? `payout-${n}`,
-    sellerId: overrides.sellerId ?? "seller-1",
-    orderId: overrides.orderId ?? `order-${n}`,
-    amount: overrides.amount ?? 900,
-    status: overrides.status ?? "pending",
-    createdAt: overrides.createdAt ?? now,
-    updatedAt: overrides.updatedAt ?? now,
-    ...overrides,
-  };
-}
-
-export function makeFullPayout(
-  overrides: Partial<SeedPayoutDocument> = {},
-): SeedPayoutDocument {
-  const settledAt = new Date();
-  settledAt.setDate(settledAt.getDate() - 2);
-  return makePayout({
-    platformFee: 100,
-    commissionRate: 10,
-    bankAccount: "ACC123456789",
-    status: "paid",
-    settledAt,
-    ...overrides,
-  });
-}
-
-export const PAYOUT_FIXTURES = {
-  pending: makePayout({
-    id: "payout-pending-1",
-    orderId: "order-1",
-  }),
-  settled: makeFullPayout({
-    id: "payout-settled-1",
-    orderId: "order-2",
-  }),
-};

package/src/seed/factories/product.factory.ts

@@ -1,120 +0,0 @@
-// appkit/src/seed/factories/product.factory.ts
-let _seq = 1;
-
-// ─── Helpers ─────────────────────────────────────────────────────────────────
-/** Deterministic pick from array using sequence number (no Math.random). */
-function pick<T>(arr: readonly T[], n: number): T {
-  return arr[n % arr.length];
-}
-
-/** Deterministic integer in [min, max] range based on n. */
-function irand(n: number, min: number, max: number): number {
-  return min + (((n * 2_654_435_761) >>> 0) % (max - min + 1));
-}
-
-// ─── Realistic data pools (INR / Indian market) ───────────────────────────────
-const PRODUCT_NAMES = [
-  "Handloom Cotton Saree", "Silver Oxidised Jhumkas", "Brass Pooja Diya Set",
-  "Khadi Kurta & Pyjama Set", "Terracotta Flower Vase", "Sandalwood Incense Sticks",
-  "Batik Print Salwar Suit", "Copper Water Bottle", "Warli Art Wall Frame",
-  "Clay Tea Kadai Set", "Jute Laptop Bag", "Madhubani Painting Print",
-  "Organic Tulsi Green Tea", "Kantha Embroidered Cushion", "Brass Dancing Ganesha Figurine",
-  "Block Print Bedsheet Set", "Bamboo Cutlery Kit", "Dhokra Metal Elephant",
-  "Rajasthani Mojari Jutti", "Coconut Shell Bowl Set",
-] as const;
-
-const CATEGORIES = [
-  "clothing", "jewellery", "home-decor", "food-beverages",
-  "art-crafts", "wellness", "accessories", "kitchenware",
-] as const;
-
-const TAGS_POOL = [
-  ["handmade", "artisan"], ["featured", "new-arrival"], ["bestseller", "eco-friendly"],
-  ["sale"], ["handcrafted", "traditional"], ["organic", "sustainable"],
-  ["limited-edition"], ["gift-worthy", "premium"],
-] as const;
-
-export interface SeedBaseProductDocument {
-  id: string;
-  title: string;
-  description: string;
-  slug: string;
-  seoTitle?: string;
-  price: number;
-  currency: string;
-  stockQuantity: number;
-  availableQuantity: number;
-  mainImage: string;
-  images: string[];
-  status: "draft" | "published" | "archived";
-  category: string;
-  tags: string[];
-  createdAt: Date;
-  updatedAt: Date;
-}
-
-export function makeProduct(
-  overrides: Partial<SeedBaseProductDocument> = {},
-): SeedBaseProductDocument {
-  const n = _seq++;
-  const now = new Date();
-  const title = pick(PRODUCT_NAMES, n);
-  const category = pick(CATEGORIES, n);
-  const price = irand(n, 99, 9999);
-  const stock = irand(n + 7, 5, 200);
-  return {
-    id: overrides.id ?? `product-${n}`,
-    title: overrides.title ?? title,
-    description: overrides.description ?? `Authentic ${title} — handcrafted by skilled Indian artisans.`,
-    slug: overrides.slug ?? `product-${n}`,
-    seoTitle: overrides.seoTitle ?? `Buy ${title} Online | Free Shipping`,
-    price: overrides.price ?? price,
-    currency: overrides.currency ?? "INR",
-    stockQuantity: overrides.stockQuantity ?? stock,
-    availableQuantity: overrides.availableQuantity ?? Math.max(0, stock - irand(n, 0, 5)),
-    mainImage: overrides.mainImage ?? "",
-    images: overrides.images ?? [],
-    status: overrides.status ?? "published",
-    category: overrides.category ?? category,
-    tags: overrides.tags ?? [...pick(TAGS_POOL, n)],
-    createdAt: overrides.createdAt ?? now,
-    updatedAt: overrides.updatedAt ?? now,
-    ...overrides,
-  };
-}
-
-/** Full product with all optional fields populated — for rendering tests */
-export function makeFullProduct(
-  overrides: Partial<SeedBaseProductDocument> = {},
-): SeedBaseProductDocument {
-  return makeProduct({
-    mainImage: "https://example.com/product.jpg",
-    images: [
-      "https://example.com/product-1.jpg",
-      "https://example.com/product-2.jpg",
-    ],
-    seoTitle: "Buy Amazing Product Online",
-    tags: ["featured", "new-arrival"],
-    ...overrides,
-  });
-}
-
-/** Named fixtures used by seed scripts and integration tests */
-export const PRODUCT_FIXTURES = {
-  basic: makeProduct({ id: "product-1", title: "Basic Product", slug: "basic-product" }),
-  full: makeFullProduct({
-    id: "product-2",
-    title: "Full Product",
-    slug: "full-product",
-    price: 1499,
-    category: "clothing",
-    tags: ["featured"],
-  }),
-  outOfStock: makeProduct({
-    id: "product-3",
-    title: "Out of Stock Product",
-    slug: "out-of-stock-product",
-    stockQuantity: 0,
-    availableQuantity: 0,
-  }),
-};

package/src/seed/factories/review.factory.ts

@@ -1,67 +0,0 @@
-// appkit/src/seed/factories/review.factory.ts
-let _seq = 1;
-
-// Realistic rating distribution: mostly 4–5 stars with occasional lower ratings
-const RATING_DIST = [5, 5, 4, 5, 4, 3, 5, 4, 5, 2] as const;
-
-const REVIEW_TITLES = [
-  "Excellent quality!", "Beautifully crafted", "Worth every rupee",
-  "Exceeded expectations", "Good value for money", "Authentic and unique",
-  "Some quality issues", "Lovely gift option", "Super fast delivery", "Not as described",
-] as const;
-
-const REVIEW_COMMENTS = [
-  "The craftsmanship is outstanding. Exactly as shown in the pictures. Will buy again!",
-  "Beautiful product, very well made. Received many compliments. Packaging was also great.",
-  "Good quality for the price. Shipping was quick. Overall satisfied with the purchase.",
-  "Absolutely love it! The artisan detail is incredible. Highly recommend to everyone.",
-  "Product is good but took a bit longer to arrive. Quality is as expected.",
-  "Looks authentic and well-crafted. My family loved it as a gift.",
-  "Minor colour variation from the photos but still beautiful in person.",
-  "Perfect for home decor. Sturdy and packed well. Very happy with this purchase.",
-  "Fast shipping, product matches description. Good seller.",
-  "The quality could be better for this price. Average experience overall.",
-] as const;
-
-function pick<T>(arr: readonly T[], n: number): T {
-  return arr[n % arr.length];
-}
-
-function irand(n: number, min: number, max: number): number {
-  return min + (((n * 2_654_435_761) >>> 0) % (max - min + 1));
-}
-
-export interface SeedReviewDocument {
-  id: string;
-  productId: string;
-  userId: string;
-  rating: 1 | 2 | 3 | 4 | 5;
-  title: string;
-  comment: string;
-  images: string[];
-  status: "published" | "pending" | "rejected";
-  helpfulCount: number;
-  verified: boolean;
-  createdAt: Date;
-}
-
-export function makeReview(
-  overrides: Partial<SeedReviewDocument> = {},
-): SeedReviewDocument {
-  const n = _seq++;
-  const now = new Date();
-  return {
-    id: overrides.id ?? `review-${n}`,
-    productId: overrides.productId ?? "product-1",
-    userId: overrides.userId ?? "user-1",
-    rating: overrides.rating ?? (pick(RATING_DIST, n) as 1 | 2 | 3 | 4 | 5),
-    title: overrides.title ?? pick(REVIEW_TITLES, n),
-    comment: overrides.comment ?? pick(REVIEW_COMMENTS, n),
-    images: overrides.images ?? [],
-    status: overrides.status ?? "published",
-    helpfulCount: overrides.helpfulCount ?? irand(n, 0, 47),
-    verified: overrides.verified ?? (n % 5 !== 0), // 80% verified
-    createdAt: overrides.createdAt ?? now,
-    ...overrides,
-  };
-}

package/src/seed/factories/session.factory.ts

@@ -1,49 +0,0 @@
-// appkit/src/seed/factories/session.factory.ts
-let _seq = 1;
-
-export interface SeedSessionDocument {
-  id: string;
-  userId: string;
-  userAgent: string;
-  ip: string;
-  createdAt: Date;
-  lastActiveAt?: Date;
-  revokedAt?: Date;
-}
-
-export function makeSession(
-  overrides: Partial<SeedSessionDocument> = {},
-): SeedSessionDocument {
-  const n = _seq++;
-  const now = new Date();
-  return {
-    id: overrides.id ?? `session-${n}`,
-    userId: overrides.userId ?? `user-${n}`,
-    userAgent:
-      overrides.userAgent ??
-      "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
-    ip: overrides.ip ?? "203.0.113.1",
-    createdAt: overrides.createdAt ?? now,
-    lastActiveAt: overrides.lastActiveAt ?? now,
-    ...overrides,
-  };
-}
-
-export function makeRevokedSession(
-  overrides: Partial<SeedSessionDocument> = {},
-): SeedSessionDocument {
-  const revokedAt = new Date();
-  revokedAt.setDate(revokedAt.getDate() - 1);
-  return makeSession({ revokedAt, ...overrides });
-}
-
-export const SESSION_FIXTURES = {
-  active: makeSession({
-    id: "session-active-1",
-    userId: "buyer-user-1",
-  }),
-  revoked: makeRevokedSession({
-    id: "session-revoked-1",
-    userId: "buyer-user-1",
-  }),
-};

package/src/seed/factories/store.factory.ts

@@ -1,69 +0,0 @@
-// appkit/src/seed/factories/store.factory.ts
-let _seq = 1;
-
-export interface SeedBaseStoreDocument {
-  id: string;
-  name: string;
-  slug: string;
-  description: string;
-  logo: string;
-  coverImage: string;
-  ownerId: string;
-  status: "active" | "inactive" | "suspended";
-  /** PII — encrypted before Firestore write by seed runner */
-  ownerEmail?: string;
-  commissionRate?: number;
-  createdAt: Date;
-  updatedAt: Date;
-}
-
-export function makeStore(
-  overrides: Partial<SeedBaseStoreDocument> = {},
-): SeedBaseStoreDocument {
-  const n = _seq++;
-  const now = new Date();
-  const slug = overrides.slug ?? `store-${n}`;
-  return {
-    id: overrides.id ?? `store-${n}`,
-    name: overrides.name ?? `Store ${n}`,
-    slug,
-    description: overrides.description ?? "A great store with amazing products.",
-    logo: overrides.logo ?? "",
-    coverImage: overrides.coverImage ?? "",
-    ownerId: overrides.ownerId ?? "seller-1",
-    status: overrides.status ?? "active",
-    createdAt: overrides.createdAt ?? now,
-    updatedAt: overrides.updatedAt ?? now,
-    ...overrides,
-  };
-}
-
-/** Full store with all optional fields populated — for rendering + PII tests */
-export function makeFullStore(
-  overrides: Partial<SeedBaseStoreDocument> = {},
-): SeedBaseStoreDocument {
-  return makeStore({
-    logo: "https://example.com/logo.jpg",
-    coverImage: "https://example.com/cover.jpg",
-    ownerEmail: "seller@example.com",
-    commissionRate: 10,
-    ...overrides,
-  });
-}
-
-/** Named fixtures used by seed scripts and integration tests */
-export const STORE_FIXTURES = {
-  main: makeFullStore({
-    id: "store-1",
-    name: "Main Store",
-    slug: "main-store",
-    ownerId: "seller-user-1",
-    ownerEmail: "seller@example.com",
-  }),
-  secondary: makeStore({
-    id: "store-2",
-    name: "Secondary Store",
-    slug: "secondary-store",
-    ownerId: "seller-user-1",
-  }),
-};