@mohasinac/appkit 2.1.3 → 2.3.0

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

@@ -1,88 +0,0 @@
-// appkit/src/seed/factories/user.factory.ts
-let _seq = 1;
-
-// ─── Indian name pools ─────────────────────────────────────────────────────────────────
-
-const FIRST_NAMES = [
-  "Priya", "Rahul", "Anjali", "Arjun", "Sneha", "Vikram", "Kavya", "Rohan",
-  "Pooja", "Aditya", "Deepa", "Karthik", "Meena", "Suresh", "Nisha", "Amit",
-  "Shalini", "Rajesh", "Divya", "Manish",
-] as const;
-
-const LAST_NAMES = [
-  "Sharma", "Patel", "Iyer", "Nair", "Singh", "Reddy", "Mehta", "Joshi",
-  "Gupta", "Pillai", "Rao", "Kumar", "Verma", "Shah", "Desai", "Chopra",
-  "Malhotra", "Saxena", "Kapoor", "Bhat",
-] as const;
-
-function pick<T>(arr: readonly T[], n: number): T {
-  return arr[n % arr.length];
-}
-
-export interface SeedBaseUserDocument {
-  uid: string;
-  email: string;
-  displayName: string;
-  photoURL?: string;
-  roles: string[];
-  emailVerified: boolean;
-  createdAt: Date;
-  updatedAt: Date;
-}
-
-export function makeUser(
-  overrides: Partial<SeedBaseUserDocument> = {},
-): SeedBaseUserDocument {
-  const n = _seq++;
-  const now = new Date();
-  const firstName = pick(FIRST_NAMES, n);
-  const lastName = pick(LAST_NAMES, n + 3);
-  const displayName = `${firstName} ${lastName}`;
-  return {
-    uid: overrides.uid ?? `user-${n}`,
-    email: overrides.email ?? `${firstName.toLowerCase()}.${lastName.toLowerCase()}${n}@example.com`,
-    displayName: overrides.displayName ?? displayName,
-    photoURL: overrides.photoURL,
-    roles: overrides.roles ?? ["user"],
-    emailVerified: overrides.emailVerified ?? true,
-    createdAt: overrides.createdAt ?? now,
-    updatedAt: overrides.updatedAt ?? now,
-    ...overrides,
-  };
-}
-
-/** Full user with all optional fields populated — for rendering tests */
-export function makeFullUser(
-  overrides: Partial<SeedBaseUserDocument> = {},
-): SeedBaseUserDocument {
-  return makeUser({
-    photoURL: "https://example.com/avatar.jpg",
-    emailVerified: true,
-    ...overrides,
-  });
-}
-
-/** Named fixtures used by seed scripts and integration tests */
-export const USER_FIXTURES = {
-  admin: makeFullUser({
-    uid: "admin-user-1",
-    email: "admin@example.com",
-    displayName: "Admin User",
-    roles: ["admin"],
-    emailVerified: true,
-  }),
-  seller: makeFullUser({
-    uid: "seller-user-1",
-    email: "seller@example.com",
-    displayName: "Seller User",
-    roles: ["seller"],
-    emailVerified: true,
-  }),
-  buyer: makeUser({
-    uid: "buyer-user-1",
-    email: "buyer@example.com",
-    displayName: "Buyer User",
-    roles: ["user"],
-    emailVerified: true,
-  }),
-};

package/src/seed/index.ts

@@ -1,84 +0,0 @@
-// appkit/src/seed/index.ts
-export type { SeedCollection, SeedConfig, SeedResult } from "./types";
-export { runSeed } from "./runner";
-
-// Factories — user
-export type { SeedBaseUserDocument } from "./factories/user.factory";
-export { makeUser, makeFullUser, USER_FIXTURES } from "./factories/user.factory";
-
-// Factories — product
-export type { SeedBaseProductDocument } from "./factories/product.factory";
-export { makeProduct, makeFullProduct, PRODUCT_FIXTURES } from "./factories/product.factory";
-
-// Factories — store
-export type { SeedBaseStoreDocument } from "./factories/store.factory";
-export { makeStore, makeFullStore, STORE_FIXTURES } from "./factories/store.factory";
-
-// Factories — order
-export type { SeedBaseOrderDocument, SeedBaseOrderItem } from "./factories/order.factory";
-export { makeOrder } from "./factories/order.factory";
-
-// Factories — review
-export type { SeedReviewDocument } from "./factories/review.factory";
-export { makeReview } from "./factories/review.factory";
-
-// Factories — blog
-export type { SeedBlogPostDocument } from "./factories/blog-post.factory";
-export { makeBlogPost } from "./factories/blog-post.factory";
-
-// Factories — faq
-export type { SeedFaqDocument } from "./factories/faq.factory";
-export { makeFaq } from "./factories/faq.factory";
-
-// Factories — category
-export type { SeedCategoryDocument } from "./factories/category.factory";
-export { makeCategory } from "./factories/category.factory";
-
-// Factories — carousel
-export type { SeedCarouselSlideDocument } from "./factories/carousel.factory";
-export { makeCarouselSlide } from "./factories/carousel.factory";
-
-// Factories — homepage
-export type {
-  SeedHomepageSectionDocument,
-  HomepageSectionType,
-} from "./factories/homepage-section.factory";
-export { makeHomepageSection } from "./factories/homepage-section.factory";
-
-// Factories — address
-export type { SeedAddressDocument } from "./factories/address.factory";
-export { makeAddress, makeFullAddress, ADDRESS_FIXTURES } from "./factories/address.factory";
-
-// Factories — cart
-export type { SeedCartDocument, SeedCartItemDocument } from "./factories/cart.factory";
-export { makeCart, makeCartItem, makeFullCart, CART_FIXTURES } from "./factories/cart.factory";
-
-// Factories — bid
-export type { SeedBidDocument } from "./factories/bid.factory";
-export { makeBid, makeWinningBid, BID_FIXTURES } from "./factories/bid.factory";
-
-// Factories — notification
-export type { SeedNotificationDocument, NotificationType } from "./factories/notification.factory";
-export { makeNotification, makeFullNotification, NOTIFICATION_FIXTURES } from "./factories/notification.factory";
-
-// Factories — session
-export type { SeedSessionDocument } from "./factories/session.factory";
-export { makeSession, makeRevokedSession, SESSION_FIXTURES } from "./factories/session.factory";
-
-// Factories — coupon
-export type { SeedCouponDocument, CouponDiscountType } from "./factories/coupon.factory";
-export { makeCoupon, makeFullCoupon, COUPON_FIXTURES } from "./factories/coupon.factory";
-
-// Factories — payout
-export type { SeedPayoutDocument, PayoutStatus } from "./factories/payout.factory";
-export { makePayout, makeFullPayout, PAYOUT_FIXTURES } from "./factories/payout.factory";
-
-// Defaults
-export { DEFAULT_CATEGORIES } from "./defaults/categories";
-export { DEFAULT_FAQS } from "./defaults/faqs";
-export { DEFAULT_HOMEPAGE_SECTIONS } from "./defaults/homepage-sections";
-
-// Test utilities (Firestore emulator + PII assertion)
-export { assertPiiRoundTrip, seedForTest } from "./test-utils";
-export type { TestSeedHandles } from "./test-utils";
-

package/src/seed/runner.ts

@@ -1,57 +0,0 @@
-// appkit/src/seed/runner.ts
-// Server-only — requires firebase-admin
-import type { SeedConfig, SeedResult } from "./types";
-import { encryptPiiFields } from "../security/pii-encrypt";
-
-const BATCH_SIZE = 400; // Firestore max batch is 500
-
-export async function runSeed(config: SeedConfig): Promise<SeedResult> {
-  const { getFirestore } = await import("firebase-admin/firestore");
-  const db = config.projectId ? getFirestore(config.projectId) : getFirestore();
-  const start = Date.now();
-  let totalDocuments = 0;
-
-  for (const collection of config.collections) {
-    const {
-      collection: name,
-      data,
-      idField = "id",
-      merge = false,
-      piiFields = [],
-    } = collection;
-
-    config.onProgress?.(name, 0, data.length);
-    let written = 0;
-
-    while (written < data.length) {
-      const slice = data.slice(written, written + BATCH_SIZE);
-      if (!config.dryRun) {
-        const batch = db.batch();
-        for (const rawDoc of slice) {
-          const doc = piiFields.length
-            ? encryptPiiFields(
-                rawDoc as Record<string, unknown>,
-                piiFields as string[],
-              )
-            : (rawDoc as Record<string, unknown>);
-          const id = String(
-            (rawDoc as Record<string, unknown>)[idField] ??
-              `auto-${written + slice.indexOf(rawDoc)}`,
-          );
-          const ref = db.collection(name).doc(id);
-          batch.set(ref, doc, { merge });
-        }
-        await batch.commit();
-      }
-      written += slice.length;
-      totalDocuments += slice.length;
-      config.onProgress?.(name, written, data.length);
-    }
-  }
-
-  return {
-    collections: config.collections.map((c) => c.collection),
-    totalDocuments,
-    durationMs: Date.now() - start,
-  };
-}

package/src/seed/test-utils.ts

@@ -1,155 +0,0 @@
-// appkit/src/seed/test-utils.ts
-// Server-only — used in integration tests and Firestore emulator setup.
-import type { SeedConfig } from "./types";
-import { runSeed } from "./runner";
-import { encryptPiiFields, decryptPiiFields, ENC_PREFIX } from "../security/pii-encrypt";
-import { DEFAULT_CATEGORIES } from "./defaults/categories";
-import { DEFAULT_FAQS } from "./defaults/faqs";
-import { makeProduct } from "./factories/product.factory";
-import { USER_FIXTURES } from "./factories/user.factory";
-import type { SeedBaseUserDocument } from "./factories/user.factory";
-import type { SeedBaseProductDocument } from "./factories/product.factory";
-import type { SeedBaseStoreDocument } from "./factories/store.factory";
-import { makeStore } from "./factories/store.factory";
-import type { SeedBaseOrderDocument } from "./factories/order.factory";
-import type { SeedCategoryDocument } from "./factories/category.factory";
-import type { SeedFaqDocument } from "./factories/faq.factory";
-
-// ---------------------------------------------------------------------------
-// PII round-trip assertion
-// ---------------------------------------------------------------------------
-
-/**
- * Assert that every `piiField` in `doc` is encrypted and can be decrypted
- * back to the original plaintext.
- *
- * Throws a descriptive error on any violation — use in tests.
- *
- * @example
- * ```ts
- * const user = makeFullUser({ email: "test@example.com", phone: "+919876543210" });
- * await assertPiiRoundTrip(user, ["email", "phone"]);
- * ```
- */
-export async function assertPiiRoundTrip<T extends Record<string, unknown>>(
-  doc: T,
-  piiFields: Array<keyof T & string>,
-): Promise<void> {
-  const encrypted = encryptPiiFields(doc, piiFields as string[]);
-
-  for (const field of piiFields) {
-    const val = encrypted[field] as string;
-    if (!val.startsWith(ENC_PREFIX)) {
-      throw new Error(
-        `assertPiiRoundTrip: field "${String(field)}" was NOT encrypted. Got: ${val}`,
-      );
-    }
-    // Verify blind index was written
-    const indexKey = `${String(field)}Index`;
-    if (!encrypted[indexKey]) {
-      throw new Error(
-        `assertPiiRoundTrip: blind index "${indexKey}" is missing after encryption.`,
-      );
-    }
-  }
-
-  const decrypted = decryptPiiFields(encrypted, piiFields as string[]);
-
-  for (const field of piiFields) {
-    if (decrypted[field] !== doc[field]) {
-      throw new Error(
-        `assertPiiRoundTrip: field "${String(field)}" round-trip mismatch. ` +
-          `Expected "${String(doc[field])}", got "${String(decrypted[field])}"`,
-      );
-    }
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Firestore emulator seed helper
-// ---------------------------------------------------------------------------
-
-export interface TestSeedHandles {
-  users: SeedBaseUserDocument[];
-  products: SeedBaseProductDocument[];
-  stores: SeedBaseStoreDocument[];
-  orders: SeedBaseOrderDocument[];
-  categories: SeedCategoryDocument[];
-  faqs: SeedFaqDocument[];
-}
-
-/**
- * Seed the Firestore emulator with a predictable, minimal dataset.
- *
- * Uses the `FIRESTORE_EMULATOR_PROJECT_ID` env var (default: "demo-test").
- * Requires the emulator to be running before calling this.
- *
- * @example
- * ```ts
- * // jest.setup.ts
- * beforeAll(async () => {
- *   const handles = await seedForTest();
- *   globalThis.__testUsers = handles.users;
- * });
- * ```
- */
-export async function seedForTest(
-  overrides?: Partial<{
-    users: SeedBaseUserDocument[];
-    products: SeedBaseProductDocument[];
-    stores: SeedBaseStoreDocument[];
-    orders: SeedBaseOrderDocument[];
-  }>,
-): Promise<TestSeedHandles> {
-  const users = overrides?.users ?? Object.values(USER_FIXTURES);
-  const products =
-    overrides?.products ??
-    Array.from({ length: 5 }, (_, i) => makeProduct({ id: `p-${i + 1}` }));
-  const stores = overrides?.stores ?? [makeStore({ id: "store-1" })];
-  const orders = overrides?.orders ?? [];
-
-  const seedConfig: SeedConfig = {
-    projectId:
-      process.env["FIRESTORE_EMULATOR_PROJECT_ID"] ?? "demo-test",
-    collections: [
-      {
-        collection: "users",
-        data: users,
-        idField: "uid",
-        piiFields: ["email"],
-      },
-      {
-        collection: "products",
-        data: products,
-      },
-      {
-        collection: "stores",
-        data: stores,
-        piiFields: ["ownerEmail"],
-      },
-      {
-        collection: "orders",
-        data: orders,
-      },
-      {
-        collection: "categories",
-        data: DEFAULT_CATEGORIES,
-      },
-      {
-        collection: "faqs",
-        data: DEFAULT_FAQS,
-      },
-    ],
-  };
-
-  await runSeed(seedConfig);
-
-  return {
-    users,
-    products,
-    stores,
-    orders,
-    categories: DEFAULT_CATEGORIES,
-    faqs: DEFAULT_FAQS,
-  };
-}

package/src/seed/types.ts

@@ -1,40 +0,0 @@
-// appkit/src/seed/types.ts
-
-export interface SeedCollection<T = unknown> {
-  /** Firestore collection name */
-  collection: string;
-  /** Fixture records to write */
-  data: T[];
-  /** Field to use as the Firestore document ID (default: "id") */
-  idField?: string;
-  /** Use Firestore set({ merge: true }) — default: false (overwrite) */
-  merge?: boolean;
-  /**
-   * Field names that contain PII.
-   * These are AES-256-GCM encrypted before writing to Firestore.
-   * A HMAC-SHA256 blind index is written to `<field>Index` alongside.
-   * Requires `PII_ENCRYPTION_KEY` env var (32-byte hex).
-   */
-  piiFields?: string[];
-}
-
-export interface SeedConfig {
-  /** Collections to seed in order */
-  collections: SeedCollection[];
-  /** Firestore project ID — defaults to process.env.FIREBASE_PROJECT_ID */
-  projectId?: string;
-  /** Write nothing; only log what would be written */
-  dryRun?: boolean;
-  /** Called after each successful batch write */
-  onProgress?: (
-    collectionName: string,
-    written: number,
-    total: number,
-  ) => void;
-}
-
-export interface SeedResult {
-  collections: string[];
-  totalDocuments: number;
-  durationMs: number;
-}

package/src/seo/index.ts

@@ -1,2 +0,0 @@
-export * from "./json-ld";
-export * from "./metadata";

package/src/seo/json-ld.ts

@@ -1,241 +0,0 @@
-/**
- * JSON-LD Structured Data Helpers
- *
- * Generates Schema.org JSON-LD objects for rich search results.
- *
- * @example
- * ```tsx
- * import { productJsonLd } from "./";
- * <script
- *   type="application/ld+json"
- *   dangerouslySetInnerHTML={{ __html: JSON.stringify(productJsonLd(product)) }}
- * />
- * ```
- */
-
-const SITE_URL = process.env.NEXT_PUBLIC_SITE_URL ?? "";
-const SITE_NAME = process.env.NEXT_PUBLIC_SITE_NAME ?? "App";
-
-// ─── Input Types ──────────────────────────────────────────────────────────────
-
-export interface ProductJsonLdInput {
-  id: string;
-  title: string;
-  description: string;
-  slug: string;
-  price: number;
-  currency: string;
-  mainImage?: string;
-  images?: string[];
-  sellerName?: string;
-  category?: string;
-  status?: string;
-  auctionEndDate?: Date;
-  isAuction?: boolean;
-}
-
-export interface ReviewJsonLdInput {
-  id: string;
-  authorName: string;
-  rating: number;
-  comment: string;
-  createdAt: Date;
-  productTitle?: string;
-}
-
-export interface FaqJsonLdInput {
-  question: string;
-  answer: string;
-}
-
-export interface BreadcrumbItem {
-  name: string;
-  url: string;
-}
-
-export interface BlogPostJsonLdInput {
-  title: string;
-  slug: string;
-  excerpt: string;
-  coverImage?: string;
-  publishedAt?: Date;
-  updatedAt?: Date;
-  authorName?: string;
-  authorAvatar?: string;
-  metaTitle?: string;
-  metaDescription?: string;
-}
-
-// ─── Helpers ─────────────────────────────────────────────────────────────────
-
-export function productJsonLd(
-  product: ProductJsonLdInput,
-): Record<string, unknown> {
-  const url = `${SITE_URL}/products/${product.slug}`;
-  const images = [
-    ...(product.mainImage ? [product.mainImage] : []),
-    ...(product.images || []),
-  ];
-
-  return {
-    "@context": "https://schema.org",
-    "@type": "Product",
-    name: product.title,
-    description: product.description,
-    url,
-    image: images.length > 0 ? images : undefined,
-    category: product.category,
-    offers: {
-      "@type": "Offer",
-      price: product.price,
-      priceCurrency: product.currency || "INR",
-      availability:
-        product.status === "published" || !product.status
-          ? "https://schema.org/InStock"
-          : product.status === "out_of_stock"
-            ? "https://schema.org/OutOfStock"
-            : "https://schema.org/Discontinued",
-      url,
-      seller: product.sellerName
-        ? { "@type": "Organization", name: product.sellerName }
-        : undefined,
-    },
-  };
-}
-
-export function reviewJsonLd(
-  review: ReviewJsonLdInput,
-): Record<string, unknown> {
-  return {
-    "@context": "https://schema.org",
-    "@type": "Review",
-    reviewBody: review.comment,
-    reviewRating: {
-      "@type": "Rating",
-      ratingValue: review.rating,
-      bestRating: 5,
-      worstRating: 1,
-    },
-    author: { "@type": "Person", name: review.authorName },
-    datePublished: review.createdAt.toISOString(),
-    ...(review.productTitle && {
-      itemReviewed: { "@type": "Product", name: review.productTitle },
-    }),
-  };
-}
-
-export function aggregateRatingJsonLd(
-  product: Pick<ProductJsonLdInput, "title" | "slug">,
-  stats: { average: number; count: number },
-): Record<string, unknown> {
-  return {
-    "@context": "https://schema.org",
-    "@type": "Product",
-    name: product.title,
-    url: `${SITE_URL}/products/${product.slug}`,
-    aggregateRating: {
-      "@type": "AggregateRating",
-      ratingValue: stats.average,
-      reviewCount: stats.count,
-      bestRating: 5,
-      worstRating: 1,
-    },
-  };
-}
-
-export function breadcrumbJsonLd(
-  items: BreadcrumbItem[],
-): Record<string, unknown> {
-  return {
-    "@context": "https://schema.org",
-    "@type": "BreadcrumbList",
-    itemListElement: items.map((item, index) => ({
-      "@type": "ListItem",
-      position: index + 1,
-      name: item.name,
-      item: item.url.startsWith("http") ? item.url : `${SITE_URL}${item.url}`,
-    })),
-  };
-}
-
-export function faqJsonLd(faqs: FaqJsonLdInput[]): Record<string, unknown> {
-  return {
-    "@context": "https://schema.org",
-    "@type": "FAQPage",
-    mainEntity: faqs.map((faq) => ({
-      "@type": "Question",
-      name: faq.question,
-      acceptedAnswer: { "@type": "Answer", text: faq.answer },
-    })),
-  };
-}
-
-export function blogPostJsonLd(
-  post: BlogPostJsonLdInput,
-): Record<string, unknown> {
-  const url = `${SITE_URL}/blog/${post.slug}`;
-  return {
-    "@context": "https://schema.org",
-    "@type": "BlogPosting",
-    headline: post.metaTitle || post.title,
-    description: post.metaDescription || post.excerpt,
-    url,
-    image: post.coverImage ? [post.coverImage] : undefined,
-    datePublished: post.publishedAt?.toISOString(),
-    dateModified:
-      post.updatedAt?.toISOString() || post.publishedAt?.toISOString(),
-    author: post.authorName
-      ? { "@type": "Person", name: post.authorName, image: post.authorAvatar }
-      : undefined,
-    publisher: { "@type": "Organization", name: SITE_NAME, url: SITE_URL },
-    mainEntityOfPage: { "@type": "WebPage", "@id": url },
-  };
-}
-
-export function organizationJsonLd(): Record<string, unknown> {
-  return {
-    "@context": "https://schema.org",
-    "@type": "Organization",
-    name: SITE_NAME,
-    url: SITE_URL,
-    logo: `${SITE_URL}/icons/icon-512x512.png`,
-    sameAs: [],
-    contactPoint: {
-      "@type": "ContactPoint",
-      contactType: "customer support",
-      url: `${SITE_URL}/contact`,
-    },
-  };
-}
-
-export function searchBoxJsonLd(): Record<string, unknown> {
-  return {
-    "@context": "https://schema.org",
-    "@type": "WebSite",
-    name: SITE_NAME,
-    url: SITE_URL,
-    potentialAction: {
-      "@type": "SearchAction",
-      target: {
-        "@type": "EntryPoint",
-        urlTemplate: `${SITE_URL}/search?q={search_term_string}`,
-      },
-      "query-input": "required name=search_term_string",
-    },
-  };
-}
-
-export function auctionJsonLd(
-  auction: ProductJsonLdInput,
-): Record<string, unknown> {
-  const url = `${SITE_URL}/products/${auction.slug}`;
-  const base = productJsonLd(auction);
-  return {
-    ...base,
-    "@type": ["Product", "Offer"],
-    url,
-    ...(auction.auctionEndDate && {
-      availabilityEnds: auction.auctionEndDate.toISOString(),
-    }),
-  };
-}