@mohasinac/appkit 2.1.3 → 2.3.0

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

@@ -1,155 +0,0 @@
-/**
- * feat-stores — store reviews aggregate (GET /api/stores/[storeSlug]/reviews)
- *
- * 2-line stub:
- * ```ts
- * // app/api/stores/[storeSlug]/reviews/route.ts
- * export { storeReviewsGET as GET } from "@mohasinac/feat-stores";
- * ```
- *
- * Aggregates approved reviews from up to 20 published products in a store.
- * Returns: reviews[], averageRating, totalReviews, ratingDistribution.
- *
- * Requires `db` registered in providers.config via `registerProviders()`.
- * Collections: "stores", "products", "reviews"
- */
-
-import { NextResponse } from "next/server.js";
-import { getProviders } from "../../../../../contracts";
-
-type RouteContext = { params: Promise<{ storeSlug: string }> };
-
-interface StoreEntity {
-  id: string;
-  ownerId: string;
-}
-
-interface ProductEntity {
-  id: string;
-  title?: string;
-  mainImage?: string | null;
-}
-
-interface ReviewEntity {
-  productId: string;
-  createdAt?: string;
-  rating: number;
-  productTitle?: string;
-}
-
-// ─── GET /api/stores/[storeSlug]/reviews ──────────────────────────────────────
-export async function GET(
-  _request: Request,
-  context: RouteContext,
-): Promise<NextResponse> {
-  try {
-    const { storeSlug } = await context.params;
-
-    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 },
-      );
-    }
-
-    // Fetch up to 20 published products for this seller
-    const productsRepo = db.getRepository<ProductEntity>("products");
-    const productsResult = await productsRepo.findAll({
-      filters: `sellerId==${store.ownerId},status==published`,
-      sort: "itemsSold",
-      order: "desc",
-      perPage: 20,
-    });
-    const products = productsResult.data;
-
-    // Fetch approved reviews for each product in parallel (cap 50 per product)
-    const reviewsRepo = db.getRepository<ReviewEntity>("reviews");
-    const reviewArrays = await Promise.all(
-      products.map((p) =>
-        reviewsRepo
-          .findAll({
-            filters: `productId==${p.id},status==approved`,
-            sort: "createdAt",
-            order: "desc",
-            perPage: 50,
-          })
-          .then((r) => r.data),
-      ),
-    );
-
-    // Flatten, sort by date desc, cap to 10 most recent
-    const allReviews: ReviewEntity[] = reviewArrays
-      .flat()
-      .sort(
-        (a, b) =>
-          new Date(b.createdAt ?? 0).getTime() -
-          new Date(a.createdAt ?? 0).getTime(),
-      )
-      .slice(0, 10);
-
-    // Compute aggregate metrics
-    const ratingDistribution: Record<number, number> = {
-      1: 0,
-      2: 0,
-      3: 0,
-      4: 0,
-      5: 0,
-    };
-    let ratingSum = 0;
-    let totalReviews = 0;
-
-    for (const reviews of reviewArrays) {
-      for (const review of reviews) {
-        totalReviews++;
-        ratingSum += review.rating;
-        ratingDistribution[review.rating] =
-          (ratingDistribution[review.rating] ?? 0) + 1;
-      }
-    }
-
-    const averageRating = totalReviews > 0 ? ratingSum / totalReviews : 0;
-
-    // Enrich reviews with product title + main image
-    const productMap = new Map(products.map((p) => [p.id, p]));
-    const reviewsWithProduct = allReviews.map((review) => ({
-      ...review,
-      productTitle:
-        productMap.get(review.productId)?.title ?? review.productTitle,
-      productMainImage: productMap.get(review.productId)?.mainImage ?? null,
-    }));
-
-    return NextResponse.json({
-      success: true,
-      data: {
-        reviews: reviewsWithProduct,
-        averageRating: Math.round(averageRating * 10) / 10,
-        totalReviews,
-        ratingDistribution,
-      },
-    });
-  } catch (error) {
-    console.error(
-      "[feat-stores] GET /api/stores/[storeSlug]/reviews failed",
-      error,
-    );
-    return NextResponse.json(
-      { success: false, error: "Failed to fetch store reviews" },
-      { status: 500 },
-    );
-  }
-}

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

@@ -1,120 +0,0 @@
-/**
- * feat-stores — single-store route handler (GET /api/stores/[storeSlug])
- *
- * Consuming projects create a 2-line stub:
- *
- * ```ts
- * // app/api/stores/[storeSlug]/route.ts
- * export { GET } from "@mohasinac/feat-stores";   // re-exported as storeSlugGET
- * ```
- *
- * Returns StoreDetail directly (no outer `{ store }` wrapper) so
- * apiClient.get<StoreDetail>('/api/stores/x') resolves correctly.
- */
-
-import { NextResponse } from "next/server.js";
-import { getProviders } from "../../../../contracts";
-import type { StoreDetail } from "../../types/index";
-
-type RouteContext = { params: Promise<{ storeSlug: string }> };
-
-interface StoreEntity {
-  id: string;
-  storeSlug: string;
-  ownerId: string;
-  storeName: string;
-  storeDescription?: string;
-  storeCategory?: string;
-  storeLogoURL?: string;
-  storeBannerURL?: string;
-  status: string;
-  isPublic: boolean;
-  stats?: {
-    totalProducts?: number;
-    itemsSold?: number;
-    totalReviews?: number;
-    averageRating?: number;
-  };
-  totalProducts?: number;
-  itemsSold?: number;
-  totalReviews?: number;
-  averageRating?: number;
-  bio?: string;
-  location?: string;
-  website?: string;
-  socialLinks?: StoreDetail["socialLinks"];
-  returnPolicy?: string;
-  shippingPolicy?: string;
-  isVacationMode?: boolean;
-  vacationMessage?: string;
-  createdAt?: string;
-}
-
-// ─── GET /api/stores/[storeSlug] ─────────────────────────────────────────────
-
-export async function GET(
-  _request: Request,
-  context: RouteContext,
-): Promise<NextResponse> {
-  try {
-    const { storeSlug } = await context.params;
-
-    const { db } = getProviders();
-    if (!db) {
-      return NextResponse.json(
-        { success: false, error: "Database provider not registered" },
-        { status: 503 },
-      );
-    }
-
-    // Look up store by slug — filters for active + public stores only
-    const repo = db.getRepository<StoreEntity>("stores");
-    const result = await repo.findAll({
-      filters: `storeSlug==${storeSlug},status==active,isPublic==true`,
-      perPage: 1,
-    });
-
-    const raw = result.data[0];
-    if (!raw) {
-      return NextResponse.json(
-        { success: false, error: "Store not found" },
-        { status: 404 },
-      );
-    }
-
-    // Map to public-safe StoreDetail shape (strip internal/sensitive fields)
-    const store: StoreDetail = {
-      id: raw.id,
-      storeSlug: raw.storeSlug,
-      ownerId: raw.ownerId,
-      storeName: raw.storeName,
-      storeDescription: raw.storeDescription,
-      storeCategory: raw.storeCategory,
-      storeLogoURL: raw.storeLogoURL,
-      storeBannerURL: raw.storeBannerURL,
-      status: raw.status,
-      isPublic: raw.isPublic,
-      totalProducts: raw.stats?.totalProducts ?? raw.totalProducts ?? undefined,
-      itemsSold: raw.stats?.itemsSold ?? raw.itemsSold ?? undefined,
-      totalReviews: raw.stats?.totalReviews ?? raw.totalReviews ?? undefined,
-      averageRating: raw.stats?.averageRating ?? raw.averageRating,
-      bio: raw.bio,
-      location: raw.location,
-      website: raw.website,
-      socialLinks: raw.socialLinks,
-      returnPolicy: raw.returnPolicy,
-      shippingPolicy: raw.shippingPolicy,
-      isVacationMode: raw.isVacationMode,
-      vacationMessage: raw.vacationMessage,
-      createdAt: raw.createdAt,
-    };
-
-    return NextResponse.json({ success: true, data: store });
-  } catch (error) {
-    console.error("[feat-stores] GET /api/stores/[storeSlug] failed", error);
-    return NextResponse.json(
-      { success: false, error: "Failed to fetch store" },
-      { status: 500 },
-    );
-  }
-}

package/src/features/stores/api/route.ts

@@ -1,128 +0,0 @@
-/**
- * feat-stores — Next.js App Router API handlers (GET /api/stores)
- *
- * Consuming projects can create a 2-line stub:
- *
- * ```ts
- * // app/api/stores/route.ts
- * export { GET } from "@mohasinac/feat-stores";
- * ```
- */
-
-import { NextResponse } from "next/server.js";
-import { getProviders } from "../../../contracts";
-import type { StoreListItem, StoreListResponse } from "../types/index";
-
-type StoreListEntity = StoreListItem & {
-  stats?: {
-    totalProducts?: number;
-    itemsSold?: number;
-    totalReviews?: number;
-    averageRating?: number;
-  };
-};
-
-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_FILTER_FIELDS = new Set([
-  "storeName",
-  "storeCategory",
-  "status",
-  "isPublic",
-]);
-
-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 ────────────────────────────────────────────────────────
-export async function GET(request: Request): Promise<NextResponse> {
-  try {
-    const url = new URL(request.url);
-    const page = numParam(url, "page", 1);
-    const pageSize = numParam(url, "pageSize", 24);
-    const sort = param(url, "sorts") ?? "-createdAt";
-
-    const parts: string[] = ["status==active,isPublic==true"];
-    const q = param(url, "q");
-    if (q) parts.push(`storeName@=*${q}`);
-    const category = param(url, "category");
-    if (category) parts.push(`storeCategory==${category}`);
-    const rawFilters = param(url, "filters");
-    if (rawFilters) {
-      const safe = validateSieveFilters(rawFilters, SAFE_STORE_FILTER_FIELDS);
-      if (safe) parts.push(safe);
-    }
-    const filters = parts.join(",");
-
-    const { db } = getProviders();
-    if (!db) {
-      return NextResponse.json(
-        { success: false, error: "Database provider not registered" },
-        { status: 503 },
-      );
-    }
-
-    const repo = db.getRepository<StoreListEntity>("stores");
-    const result = await repo.findAll({
-      filters,
-      sort,
-      page,
-      perPage: pageSize,
-    });
-
-    // Map to public-safe shape (strip sensitive fields)
-    const items: StoreListItem[] = result.data.map((s) => ({
-      id: s.id,
-      storeSlug: s.storeSlug,
-      ownerId: s.ownerId,
-      storeName: s.storeName,
-      storeDescription: s.storeDescription,
-      storeCategory: s.storeCategory,
-      storeLogoURL: s.storeLogoURL,
-      storeBannerURL: s.storeBannerURL,
-      status: s.status,
-      isPublic: s.isPublic,
-      totalProducts: s.stats?.totalProducts ?? s.totalProducts ?? undefined,
-      itemsSold: s.stats?.itemsSold ?? s.itemsSold ?? undefined,
-      totalReviews: s.stats?.totalReviews ?? s.totalReviews ?? undefined,
-      averageRating: s.stats?.averageRating ?? s.averageRating,
-      createdAt: s.createdAt,
-    }));
-
-    const body: StoreListResponse = {
-      items,
-      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 failed", error);
-    return NextResponse.json(
-      { success: false, error: "Failed to fetch stores" },
-      { status: 500 },
-    );
-  }
-}

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

@@ -1,58 +0,0 @@
-import type { TableColumn, ColumnExtensionOpts } from "../../../contracts";
-import type { StoreListItem } from "../types";
-
-/**
- * Default admin column definitions for a store table.
- *
- * @example
- * const columns = buildStoreColumns<MyStore>({
- *   overrides: { storeName: { render: (s) => <StoreLink store={s} /> } },
- *   extras: [{ key: "tier", header: "Tier", render: (s) => s.tier ?? "basic" }],
- * });
- */
-export const storeAdminColumns: TableColumn<StoreListItem>[] = [
-  { key: "storeName", header: "Store Name", sortable: true },
-  { 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.totalProducts?.toLocaleString() ?? "—",
-  },
-  {
-    key: "itemsSold",
-    header: "Sold",
-    sortable: true,
-    render: (s) => s.itemsSold?.toLocaleString() ?? "—",
-  },
-  {
-    key: "averageRating",
-    header: "Rating",
-    sortable: true,
-    render: (s) => (s.averageRating != null ? s.averageRating.toFixed(1) : "—"),
-  },
-  { key: "createdAt", header: "Created", sortable: true },
-];
-
-/**
- * Build a merged column list from the base store columns.
- */
-export function buildStoreColumns<T extends StoreListItem = StoreListItem>(
-  opts?: ColumnExtensionOpts<T>,
-): TableColumn<T>[] {
-  const base = storeAdminColumns 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/stores/components/StoreAboutView.tsx

@@ -1,134 +0,0 @@
-"use client";
-
-import React from "react";
-import { Div, Heading, Text } from "../../../ui";
-import type { StoreDetail } from "../types";
-
-export interface StoreAboutViewProps {
-  store: StoreDetail;
-  labels?: {
-    aboutTitle?: string;
-    locationLabel?: string;
-    websiteLabel?: string;
-    returnPolicyLabel?: string;
-    shippingPolicyLabel?: string;
-    memberSinceLabel?: string;
-    socialLinksLabel?: string;
-    vacationModeLabel?: string;
-  };
-  /** Render-prop for social links */
-  renderSocialLinks?: (links: StoreDetail["socialLinks"]) => React.ReactNode;
-  /** Render-prop for stats (products sold, reviews, rating) */
-  renderStats?: (store: StoreDetail) => React.ReactNode;
-  className?: string;
-}
-
-export function StoreAboutView({
-  store,
-  labels = {},
-  renderSocialLinks,
-  renderStats,
-  className = "",
-}: StoreAboutViewProps) {
-  const joinDate = store.createdAt
-    ? new Date(store.createdAt).toLocaleDateString("en-US", {
-        year: "numeric",
-        month: "long",
-      })
-    : null;
-
-  return (
-    <Div className={`space-y-6 py-6 ${className}`}>
-      {/* Bio */}
-      {store.bio && (
-        <Div>
-          <Heading level={2} className="text-lg font-semibold mb-2">
-            {labels.aboutTitle ?? "About"}
-          </Heading>
-          <Text className="text-neutral-600 whitespace-pre-line">
-            {store.bio}
-          </Text>
-        </Div>
-      )}
-
-      {/* Stats */}
-      {renderStats?.(store)}
-
-      {/* Details list */}
-      <Div className="space-y-3 text-sm">
-        {store.location && (
-          <Div className="flex gap-2">
-            <Text className="font-medium text-neutral-700 min-w-[120px]">
-              {labels.locationLabel ?? "Location"}
-            </Text>
-            <Text className="text-neutral-600">{store.location}</Text>
-          </Div>
-        )}
-        {joinDate && (
-          <Div className="flex gap-2">
-            <Text className="font-medium text-neutral-700 min-w-[120px]">
-              {labels.memberSinceLabel ?? "Member since"}
-            </Text>
-            <Text className="text-neutral-600">{joinDate}</Text>
-          </Div>
-        )}
-        {store.website && (
-          <Div className="flex gap-2">
-            <Text className="font-medium text-neutral-700 min-w-[120px]">
-              {labels.websiteLabel ?? "Website"}
-            </Text>
-            <a
-              href={store.website}
-              target="_blank"
-              rel="noopener noreferrer"
-              className="text-primary hover:underline break-all"
-            >
-              {store.website}
-            </a>
-          </Div>
-        )}
-      </Div>
-
-      {/* Social links */}
-      {store.socialLinks && renderSocialLinks?.(store.socialLinks)}
-
-      {/* Return policy */}
-      {store.returnPolicy && (
-        <Div>
-          <Heading level={3} className="text-base font-semibold mb-2">
-            {labels.returnPolicyLabel ?? "Return Policy"}
-          </Heading>
-          <Text className="text-neutral-600 whitespace-pre-line">
-            {store.returnPolicy}
-          </Text>
-        </Div>
-      )}
-
-      {/* Shipping policy */}
-      {store.shippingPolicy && (
-        <Div>
-          <Heading level={3} className="text-base font-semibold mb-2">
-            {labels.shippingPolicyLabel ?? "Shipping Policy"}
-          </Heading>
-          <Text className="text-neutral-600 whitespace-pre-line">
-            {store.shippingPolicy}
-          </Text>
-        </Div>
-      )}
-
-      {/* Vacation mode notice */}
-      {store.isVacationMode && (
-        <Div className="bg-yellow-50 border border-yellow-200 rounded-lg p-4">
-          <Text className="text-yellow-800 font-medium">
-            {labels.vacationModeLabel ?? "This store is on vacation mode"}
-          </Text>
-          {store.vacationMessage && (
-            <Text className="text-yellow-700 mt-1">
-              {store.vacationMessage}
-            </Text>
-          )}
-        </Div>
-      )}
-    </Div>
-  );
-}

package/src/features/stores/components/StoreAuctionsView.tsx

@@ -1,46 +0,0 @@
-"use client";
-
-import React from "react";
-import { Div, Heading } from "../../../ui";
-import type { StoreAuctionItem } from "../types";
-
-export interface StoreAuctionsViewProps {
-  storeSlug: string;
-  labels?: {
-    title?: string;
-    emptyTitle?: string;
-    emptyDescription?: string;
-  };
-  renderAuctions: (
-    items: StoreAuctionItem[],
-    isLoading: boolean,
-  ) => React.ReactNode;
-  renderPagination?: (total: number) => React.ReactNode;
-  items?: StoreAuctionItem[];
-  total?: number;
-  isLoading?: boolean;
-  className?: string;
-}
-
-export function StoreAuctionsView({
-  labels = {},
-  renderAuctions,
-  renderPagination,
-  items = [],
-  total = 0,
-  isLoading = false,
-  className = "",
-}: StoreAuctionsViewProps) {
-  return (
-    <Div className={`py-4 ${className}`}>
-      {labels.title && (
-        <Heading level={2} className="text-xl font-semibold mb-4">
-          {labels.title}
-        </Heading>
-      )}
-
-      {renderAuctions(items, isLoading)}
-      {renderPagination?.(total)}
-    </Div>
-  );
-}