@mohasinac/appkit 2.4.11 → 2.5.0

package/dist/features/history/hooks/useHistoryMergeOnLogin.js

@@ -0,0 +1,41 @@
+"use client";
+/**
+ * useHistoryMergeOnLogin — merge guest localStorage history into Firestore
+ * the moment a user transitions from null → uid.
+ */
+import { useEffect, useRef } from "react";
+import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints";
+import { clearGuestHistory, getGuestHistory } from "../utils/guest-history";
+export function useHistoryMergeOnLogin(userId) {
+    const prevRef = useRef(undefined);
+    const mergedRef = useRef(false);
+    useEffect(() => {
+        const prev = prevRef.current;
+        prevRef.current = userId;
+        if (!userId || prev === userId)
+            return;
+        if (mergedRef.current)
+            return;
+        mergedRef.current = true;
+        const items = getGuestHistory();
+        if (items.length === 0)
+            return;
+        fetch(ACCOUNT_ENDPOINTS.HISTORY_MERGE, {
+            method: "POST",
+            credentials: "include",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ items }),
+        })
+            .then((r) => {
+            if (r.ok)
+                clearGuestHistory();
+        })
+            .catch(() => {
+            // best-effort — guest history stays in localStorage to retry next session
+        });
+    }, [userId]);
+    useEffect(() => {
+        if (!userId)
+            mergedRef.current = false;
+    }, [userId]);
+}

package/dist/features/history/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./hooks/useHistory";
+export * from "./hooks/useHistoryMergeOnLogin";
+export * from "./utils/guest-history";
+export { HistoryTracker } from "./components/HistoryTracker";
+export type { UserHistoryItem, HistoryProductType, HistoryItemSnapshot, } from "./repository/user-history.repository";

package/dist/features/history/index.js

@@ -0,0 +1,4 @@
+export * from "./hooks/useHistory";
+export * from "./hooks/useHistoryMergeOnLogin";
+export * from "./utils/guest-history";
+export { HistoryTracker } from "./components/HistoryTracker";

package/dist/features/history/repository/user-history.repository.d.ts

@@ -0,0 +1,59 @@
+/**
+ * UserHistoryRepository — one document per user at top-level `history/history-{userSlug}`.
+ *
+ * Doc shape: { userId: string, items: UserHistoryItem[], updatedAt: Date }
+ * - id === slug === `history-{userSlug}` (LetItRip id-equals-slug convention)
+ * - userSlug === user.uid (per users-seed-data.ts: id === uid === slug)
+ * - items ordered newest-first (position 0 = most recent)
+ * - soft cap HISTORY_MAX (50); silent FIFO evict on overflow (no error)
+ * - re-visit semantics: removes existing entry for productId and unshifts new at position 0
+ * - all mutations run inside a Firestore transaction (concurrent-write safe)
+ */
+export type HistoryProductType = "product" | "auction" | "preorder";
+export interface HistoryItemSnapshot {
+    title?: string;
+    thumb?: string;
+    price?: number;
+    storeId?: string;
+    storeName?: string;
+}
+export interface UserHistoryItem {
+    productId: string;
+    productType: HistoryProductType;
+    viewedAt: Date;
+    productSnapshot?: HistoryItemSnapshot;
+}
+export interface HistoryDocument {
+    userId: string;
+    items: UserHistoryItem[];
+    updatedAt: Date;
+}
+export declare class UserHistoryRepository {
+    private docRef;
+    getHistory(userSlug: string): Promise<UserHistoryItem[]>;
+    countByUser(userSlug: string): Promise<number>;
+    /**
+     * Track a visit: remove any existing entry for this productId, unshift the new
+     * entry at position 0, then FIFO-trim the tail down to HISTORY_MAX. Silent — no
+     * error if the array overflows.
+     */
+    track(userSlug: string, item: Omit<UserHistoryItem, "viewedAt"> & {
+        viewedAt?: Date;
+    }): Promise<number>;
+    /**
+     * Bulk-merge guest history into the user's doc. Each input item dedupes by
+     * productId (newer viewedAt wins), then FIFO-trim to HISTORY_MAX. Used on login.
+     */
+    merge(userSlug: string, incoming: Array<Omit<UserHistoryItem, "viewedAt"> & {
+        viewedAt?: Date;
+    }>): Promise<number>;
+    removeOne(userSlug: string, productId: string): Promise<void>;
+    clearForUser(userSlug: string): Promise<void>;
+    /** Admin: returns one row per user. */
+    findAllSummaries(): Promise<{
+        userId: string;
+        itemCount: number;
+        updatedAt: Date;
+    }[]>;
+}
+export declare const historyRepository: UserHistoryRepository;

package/dist/features/history/repository/user-history.repository.js

@@ -0,0 +1,203 @@
+/**
+ * UserHistoryRepository — one document per user at top-level `history/history-{userSlug}`.
+ *
+ * Doc shape: { userId: string, items: UserHistoryItem[], updatedAt: Date }
+ * - id === slug === `history-{userSlug}` (LetItRip id-equals-slug convention)
+ * - userSlug === user.uid (per users-seed-data.ts: id === uid === slug)
+ * - items ordered newest-first (position 0 = most recent)
+ * - soft cap HISTORY_MAX (50); silent FIFO evict on overflow (no error)
+ * - re-visit semantics: removes existing entry for productId and unshifts new at position 0
+ * - all mutations run inside a Firestore transaction (concurrent-write safe)
+ */
+import { getAdminDb } from "../../../providers/db-firebase";
+import { serverLogger } from "../../../monitoring";
+import { HISTORY_COLLECTION, HISTORY_DOC_ID, HISTORY_MAX, } from "../../../constants/limits";
+function toDate(raw) {
+    if (raw instanceof Date)
+        return raw;
+    if (raw && typeof raw.toDate === "function") {
+        return raw.toDate();
+    }
+    if (typeof raw === "string" || typeof raw === "number")
+        return new Date(raw);
+    return new Date();
+}
+function normaliseItems(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    return raw
+        .filter((r) => !!r && typeof r === "object")
+        .map((r) => ({
+        productId: String(r.productId ?? ""),
+        productType: r.productType ?? "product",
+        viewedAt: toDate(r.viewedAt),
+        productSnapshot: (r.productSnapshot ?? undefined),
+    }))
+        .filter((i) => i.productId);
+}
+export class UserHistoryRepository {
+    docRef(userSlug) {
+        return getAdminDb()
+            .collection(HISTORY_COLLECTION)
+            .doc(HISTORY_DOC_ID(userSlug));
+    }
+    async getHistory(userSlug) {
+        try {
+            const snap = await this.docRef(userSlug).get();
+            if (!snap.exists)
+                return [];
+            return normaliseItems(snap.data()?.items);
+        }
+        catch (error) {
+            serverLogger.error("UserHistoryRepository.getHistory error", {
+                userSlug,
+                error,
+            });
+            throw error;
+        }
+    }
+    async countByUser(userSlug) {
+        const snap = await this.docRef(userSlug).get();
+        if (!snap.exists)
+            return 0;
+        const items = snap.data()?.items;
+        return Array.isArray(items) ? items.length : 0;
+    }
+    /**
+     * Track a visit: remove any existing entry for this productId, unshift the new
+     * entry at position 0, then FIFO-trim the tail down to HISTORY_MAX. Silent — no
+     * error if the array overflows.
+     */
+    async track(userSlug, item) {
+        const db = getAdminDb();
+        const ref = this.docRef(userSlug);
+        try {
+            return await db.runTransaction(async (tx) => {
+                const snap = await tx.get(ref);
+                const items = snap.exists
+                    ? normaliseItems(snap.data()?.items)
+                    : [];
+                const filtered = items.filter((i) => i.productId !== item.productId);
+                const newItem = {
+                    productId: item.productId,
+                    productType: item.productType,
+                    viewedAt: item.viewedAt ?? new Date(),
+                    productSnapshot: item.productSnapshot,
+                };
+                const next = [newItem, ...filtered].slice(0, HISTORY_MAX);
+                tx.set(ref, {
+                    userId: userSlug,
+                    items: next,
+                    updatedAt: new Date(),
+                });
+                return next.length;
+            });
+        }
+        catch (error) {
+            serverLogger.error("UserHistoryRepository.track error", {
+                userSlug,
+                productId: item.productId,
+                error,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Bulk-merge guest history into the user's doc. Each input item dedupes by
+     * productId (newer viewedAt wins), then FIFO-trim to HISTORY_MAX. Used on login.
+     */
+    async merge(userSlug, incoming) {
+        const db = getAdminDb();
+        const ref = this.docRef(userSlug);
+        return db.runTransaction(async (tx) => {
+            const snap = await tx.get(ref);
+            const existing = snap.exists
+                ? normaliseItems(snap.data()?.items)
+                : [];
+            const merged = new Map();
+            // Existing first
+            for (const it of existing)
+                merged.set(it.productId, it);
+            // Incoming overwrites if newer viewedAt
+            for (const it of incoming) {
+                const newOne = {
+                    productId: it.productId,
+                    productType: it.productType,
+                    viewedAt: it.viewedAt ?? new Date(),
+                    productSnapshot: it.productSnapshot,
+                };
+                const prev = merged.get(newOne.productId);
+                if (!prev || newOne.viewedAt > prev.viewedAt) {
+                    merged.set(newOne.productId, newOne);
+                }
+            }
+            const next = Array.from(merged.values())
+                .sort((a, b) => b.viewedAt.getTime() - a.viewedAt.getTime())
+                .slice(0, HISTORY_MAX);
+            tx.set(ref, {
+                userId: userSlug,
+                items: next,
+                updatedAt: new Date(),
+            });
+            return next.length;
+        });
+    }
+    async removeOne(userSlug, productId) {
+        const db = getAdminDb();
+        const ref = this.docRef(userSlug);
+        try {
+            await db.runTransaction(async (tx) => {
+                const snap = await tx.get(ref);
+                if (!snap.exists)
+                    return;
+                const items = normaliseItems(snap.data()?.items);
+                const next = items.filter((i) => i.productId !== productId);
+                if (next.length === items.length)
+                    return;
+                tx.set(ref, {
+                    userId: userSlug,
+                    items: next,
+                    updatedAt: new Date(),
+                });
+            });
+        }
+        catch (error) {
+            serverLogger.error("UserHistoryRepository.removeOne error", {
+                userSlug,
+                productId,
+                error,
+            });
+            throw error;
+        }
+    }
+    async clearForUser(userSlug) {
+        try {
+            await this.docRef(userSlug).set({
+                userId: userSlug,
+                items: [],
+                updatedAt: new Date(),
+            });
+        }
+        catch (error) {
+            serverLogger.error("UserHistoryRepository.clearForUser error", {
+                userSlug,
+                error,
+            });
+            throw error;
+        }
+    }
+    /** Admin: returns one row per user. */
+    async findAllSummaries() {
+        const snap = await getAdminDb().collection(HISTORY_COLLECTION).get();
+        return snap.docs.map((doc) => {
+            const data = doc.data();
+            const items = Array.isArray(data?.items) ? data.items : [];
+            return {
+                userId: String(data?.userId ?? doc.id.replace(/^history-/, "")),
+                itemCount: items.length,
+                updatedAt: toDate(data?.updatedAt),
+            };
+        });
+    }
+}
+export const historyRepository = new UserHistoryRepository();

package/dist/features/history/server.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @mohasinac/appkit/features/history/server
+ * Server-only entry point for history repository + actions.
+ */
+export * from "./actions";
+export { UserHistoryRepository, historyRepository, type UserHistoryItem, type HistoryDocument, type HistoryItemSnapshot, type HistoryProductType, } from "./repository/user-history.repository";

package/dist/features/history/server.js

@@ -0,0 +1,6 @@
+/**
+ * @mohasinac/appkit/features/history/server
+ * Server-only entry point for history repository + actions.
+ */
+export * from "./actions";
+export { UserHistoryRepository, historyRepository, } from "./repository/user-history.repository";

package/dist/features/history/utils/guest-history.d.ts

@@ -0,0 +1,24 @@
+export type GuestHistoryType = "product" | "auction" | "preorder";
+export interface GuestHistoryItem {
+    productId: string;
+    productType: GuestHistoryType;
+    viewedAt: string;
+    productSnapshot?: {
+        title?: string;
+        thumb?: string;
+        price?: number;
+        storeId?: string;
+        storeName?: string;
+    };
+}
+interface Storage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+export declare function getGuestHistory(storage?: Storage | null, key?: string): GuestHistoryItem[];
+export declare function trackGuestHistory(productId: string, productType: GuestHistoryType, snapshot?: GuestHistoryItem["productSnapshot"], storage?: Storage | null, key?: string): GuestHistoryItem[];
+export declare function removeGuestHistoryItem(productId: string, storage?: Storage | null, key?: string): GuestHistoryItem[];
+export declare function clearGuestHistory(storage?: Storage | null, key?: string): void;
+export declare function getGuestHistoryCount(storage?: Storage | null, key?: string): number;
+export {};

package/dist/features/history/utils/guest-history.js

@@ -0,0 +1,66 @@
+/**
+ * Guest history — localStorage mirror of the user history doc.
+ *
+ * Same shape as UserHistoryItem (minus userId). 50-item FIFO cap.
+ * Re-visit semantics mirror server: remove existing entry for productId,
+ * unshift new entry at position 0, then slice to HISTORY_MAX.
+ */
+import { HISTORY_MAX } from "../../../constants/limits";
+const DEFAULT_GUEST_HISTORY_KEY = process.env.NEXT_PUBLIC_APP_ID
+    ? `${process.env.NEXT_PUBLIC_APP_ID}_guest_history`
+    : "guest_history";
+function getDefaultStorage() {
+    if (typeof window === "undefined")
+        return null;
+    return window.localStorage;
+}
+function read(storage, key) {
+    if (!storage)
+        return [];
+    try {
+        const raw = storage.getItem(key);
+        if (!raw)
+            return [];
+        const parsed = JSON.parse(raw);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+function write(storage, key, items) {
+    if (!storage)
+        return;
+    storage.setItem(key, JSON.stringify(items));
+}
+export function getGuestHistory(storage = getDefaultStorage(), key = DEFAULT_GUEST_HISTORY_KEY) {
+    return read(storage, key);
+}
+export function trackGuestHistory(productId, productType, snapshot, storage = getDefaultStorage(), key = DEFAULT_GUEST_HISTORY_KEY) {
+    const items = read(storage, key);
+    const filtered = items.filter((i) => i.productId !== productId);
+    const next = [
+        {
+            productId,
+            productType,
+            viewedAt: new Date().toISOString(),
+            productSnapshot: snapshot,
+        },
+        ...filtered,
+    ].slice(0, HISTORY_MAX);
+    write(storage, key, next);
+    return next;
+}
+export function removeGuestHistoryItem(productId, storage = getDefaultStorage(), key = DEFAULT_GUEST_HISTORY_KEY) {
+    const next = read(storage, key).filter((i) => i.productId !== productId);
+    write(storage, key, next);
+    return next;
+}
+export function clearGuestHistory(storage = getDefaultStorage(), key = DEFAULT_GUEST_HISTORY_KEY) {
+    if (!storage)
+        return;
+    storage.removeItem(key);
+}
+export function getGuestHistoryCount(storage = getDefaultStorage(), key = DEFAULT_GUEST_HISTORY_KEY) {
+    return read(storage, key).length;
+}

package/dist/features/homepage/actions/homepage-section-actions.d.ts

@@ -7,14 +7,14 @@ export declare const createSectionSchema: z.ZodObject<{
     order: z.ZodDefault<z.ZodNumber>;
     config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
+    enabled: boolean;
     type: string;
     order: number;
-    enabled: boolean;
     config?: Record<string, unknown> | undefined;
 }, {
     type: string;
-    order?: number | undefined;
     enabled?: boolean | undefined;
+    order?: number | undefined;
     config?: Record<string, unknown> | undefined;
 }>;
 export declare const updateSectionSchema: z.ZodObject<{
@@ -22,12 +22,12 @@ export declare const updateSectionSchema: z.ZodObject<{
     enabled: z.ZodOptional<z.ZodBoolean>;
     config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
-    order?: number | undefined;
     enabled?: boolean | undefined;
+    order?: number | undefined;
     config?: Record<string, unknown> | undefined;
 }, {
-    order?: number | undefined;
     enabled?: boolean | undefined;
+    order?: number | undefined;
     config?: Record<string, unknown> | undefined;
 }>;
 export type CreateHomepageSectionInput = z.infer<typeof createSectionSchema>;

package/dist/features/homepage/components/BrandsSection.d.ts

@@ -1,4 +1,5 @@
 import type { CategoryItem } from "../../categories/types";
+import type { SectionCTA } from "../schemas/firestore";
 export interface BrandsSectionProps {
     title?: string;
     subtitle?: string;
@@ -7,5 +8,10 @@ export interface BrandsSectionProps {
     viewMoreLabel?: string;
     className?: string;
     initialItems?: CategoryItem[];
+    cta?: SectionCTA;
+    filters?: {
+        featuredOnly?: boolean;
+        byCountry?: string;
+    };
 }
-export declare function BrandsSection({ title, subtitle, limit, viewMoreHref, viewMoreLabel, className, initialItems, }: BrandsSectionProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function BrandsSection({ title, subtitle, limit, viewMoreHref, viewMoreLabel, className, initialItems, cta, filters, }: BrandsSectionProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/features/homepage/components/BrandsSection.js

@@ -1,21 +1,43 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
 import Image from "next/image";
 import Link from "next/link";
 import { THEME_CONSTANTS } from "../../../tokens";
 import { Heading, HorizontalScroller, Section, Text } from "../../../ui";
 import { ROUTES } from "../../../next";
 import { useTopBrands } from "../hooks/useTopBrands";
+const CTA_CLASSES = {
+    filled: "rounded-lg bg-[var(--appkit-color-primary)] px-5 py-2 text-sm font-semibold text-white hover:opacity-90",
+    outline: "rounded-lg border border-[var(--appkit-color-primary)] px-5 py-2 text-sm font-semibold text-[var(--appkit-color-primary)] hover:bg-[var(--appkit-color-primary)]/10",
+    text: "text-sm font-medium text-[var(--appkit-color-primary)] hover:underline",
+};
+function BrandFilterChip({ label, active, onClick, }) {
+    return (_jsx("button", { type: "button", onClick: onClick, className: [
+            "whitespace-nowrap rounded-full border px-3 py-1 text-xs font-medium transition-colors",
+            active
+                ? "border-[var(--appkit-color-primary)] bg-[var(--appkit-color-primary)] text-white"
+                : "border-zinc-300 bg-white text-zinc-600 hover:border-[var(--appkit-color-primary)] dark:border-slate-600 dark:bg-slate-800 dark:text-zinc-300",
+        ].join(" "), children: label }));
+}
 function BrandLogo({ brand }) {
     const iconSrc = brand.display?.icon;
     const coverImage = brand.display?.coverImage;
     const initial = brand.name[0]?.toUpperCase() ?? "?";
     return (_jsxs(Link, { href: ROUTES.PUBLIC.CATEGORY_DETAIL(brand.slug), className: "flex h-24 w-28 flex-col items-center justify-center gap-2 rounded-xl border border-zinc-200 bg-white p-3 shadow-sm transition-all hover:border-primary-300 hover:shadow-md dark:border-slate-700 dark:bg-slate-900", children: [iconSrc || coverImage ? (_jsx(Image, { src: iconSrc ?? coverImage, alt: brand.name, width: 40, height: 40, className: "h-10 w-10 rounded object-contain" })) : (_jsx("div", { className: "flex h-10 w-10 items-center justify-center rounded-lg bg-primary-100 text-sm font-bold text-primary-700 dark:bg-primary-900 dark:text-primary-300", children: initial })), _jsx(Text, { className: "w-full truncate text-center text-xs font-medium text-zinc-700 dark:text-zinc-300", children: brand.name })] }));
 }
-export function BrandsSection({ title = "Top Brands", subtitle, limit = 12, viewMoreHref, viewMoreLabel = "All brands →", className = "", initialItems, }) {
+export function BrandsSection({ title = "Top Brands", subtitle, limit = 12, viewMoreHref, viewMoreLabel = "All brands →", className = "", initialItems, cta, filters, }) {
     const { themed } = THEME_CONSTANTS;
-    const { data: brands = [], isLoading } = useTopBrands(limit, { initialData: initialItems });
-    if (!isLoading && brands.length === 0)
+    const { data: allBrands = [], isLoading } = useTopBrands(limit, { initialData: initialItems });
+    const [activeFilter, setActiveFilter] = useState("all");
+    // Available filter chips: "All" + "Featured" when featuredOnly filter is configured
+    const showFeaturedChip = filters?.featuredOnly !== undefined;
+    const brands = allBrands.filter((brand) => {
+        if (activeFilter === "featured" && !brand.isFeatured)
+            return false;
+        return true;
+    });
+    if (!isLoading && allBrands.length === 0)
         return null;
-    return (_jsx(Section, { className: `py-12 px-4 ${themed.bgSecondary} ${className}`, children: _jsxs("div", { className: "mx-auto max-w-7xl", children: [_jsxs("div", { className: "mb-6 flex items-center justify-between", children: [_jsxs("div", { children: [_jsx(Heading, { level: 2, className: `text-2xl font-bold md:text-3xl ${themed.textPrimary}`, children: title }), subtitle && (_jsx(Text, { variant: "secondary", className: "mt-1 text-sm", children: subtitle }))] }), viewMoreHref && (_jsx(Link, { href: viewMoreHref, className: "text-sm font-medium text-primary hover:underline", children: viewMoreLabel }))] }), isLoading ? (_jsx("div", { className: "flex gap-3 overflow-hidden", children: Array.from({ length: 8 }).map((_, i) => (_jsx("div", { className: "h-24 w-28 flex-none animate-pulse rounded-xl bg-zinc-200 dark:bg-slate-700" }, i))) })) : (_jsx(HorizontalScroller, { items: brands, renderItem: (brand) => _jsx(BrandLogo, { brand: brand }), keyExtractor: (brand) => brand.id, gap: 12, showArrows: true, showScrollbar: false }))] }) }));
+    return (_jsx(Section, { className: `py-12 px-4 ${themed.bgSecondary} ${className}`, children: _jsxs("div", { className: "mx-auto max-w-7xl", children: [_jsxs("div", { className: "mb-6 flex items-center justify-between", children: [_jsxs("div", { children: [_jsx(Heading, { level: 2, className: `text-2xl font-bold md:text-3xl ${themed.textPrimary}`, children: title }), subtitle && (_jsx(Text, { variant: "secondary", className: "mt-1 text-sm", children: subtitle }))] }), !cta && viewMoreHref && (_jsx(Link, { href: viewMoreHref, className: "text-sm font-medium text-[var(--appkit-color-primary)] hover:underline", children: viewMoreLabel }))] }), showFeaturedChip && !isLoading && (_jsxs("div", { className: "mb-4 flex flex-wrap gap-2", children: [_jsx(BrandFilterChip, { label: "All", active: activeFilter === "all", onClick: () => setActiveFilter("all") }), _jsx(BrandFilterChip, { label: "Featured", active: activeFilter === "featured", onClick: () => setActiveFilter(activeFilter === "featured" ? "all" : "featured") })] })), isLoading ? (_jsx("div", { className: "flex gap-3 overflow-hidden", children: Array.from({ length: 8 }).map((_, i) => (_jsx("div", { className: "h-24 w-28 flex-none animate-pulse rounded-xl bg-zinc-200 dark:bg-slate-700" }, i))) })) : (_jsx(HorizontalScroller, { items: brands, renderItem: (brand) => _jsx(BrandLogo, { brand: brand }), keyExtractor: (brand) => brand.id, gap: 12, showArrows: true, showScrollbar: false })), cta && !isLoading && (_jsx("div", { className: "mt-6 text-center", children: _jsx(Link, { href: cta.href, className: CTA_CLASSES[cta.variant], children: cta.label }) }))] }) }));
 }

package/dist/features/homepage/components/CollectionCardsSection.d.ts

@@ -0,0 +1,13 @@
+import type { CollectionCardsSectionConfig } from "../schemas/firestore";
+export interface CollectionCardsSectionProps {
+    config: CollectionCardsSectionConfig;
+}
+/**
+ * Renders a single homepage strip that mixes multiple resource types (products,
+ * stores, blog, etc.) — driven entirely from config.
+ *
+ * Each entry's data fetch wires into the existing per-resource repositories.
+ * Until the data wiring lands the section renders the configured collection
+ * tabs + a placeholder, exercising the schema/admin plumbing end-to-end.
+ */
+export declare function CollectionCardsSection({ config, }: CollectionCardsSectionProps): Promise<import("react/jsx-runtime").JSX.Element | null>;

package/dist/features/homepage/components/CollectionCardsSection.js

@@ -0,0 +1,41 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import Link from "next/link";
+import { Container, Heading, Row, Section, Stack, Text, } from "../../../ui";
+const DEFAULT_ITEMS_PER_ROW = 4;
+const DEFAULT_MAX_ITEMS = 12;
+function entryLabel(entry) {
+    if (entry.label)
+        return entry.label;
+    switch (entry.type) {
+        case "products": return "Products";
+        case "auctions": return "Auctions";
+        case "pre-orders": return "Pre-orders";
+        case "stores": return "Stores";
+        case "events": return "Events";
+        case "blog-posts": return "Blog";
+        case "reviews": return "Reviews";
+        case "brands": return "Brands";
+        case "categories": return "Categories";
+    }
+}
+/**
+ * Renders a single homepage strip that mixes multiple resource types (products,
+ * stores, blog, etc.) — driven entirely from config.
+ *
+ * Each entry's data fetch wires into the existing per-resource repositories.
+ * Until the data wiring lands the section renders the configured collection
+ * tabs + a placeholder, exercising the schema/admin plumbing end-to-end.
+ */
+export async function CollectionCardsSection({ config, }) {
+    const title = config.title ?? "Featured Collections";
+    const subtitle = config.subtitle;
+    const collections = Array.isArray(config.collections) ? config.collections : [];
+    const itemsPerRow = config.itemsPerRow ?? DEFAULT_ITEMS_PER_ROW;
+    const maxItems = config.maxItems ?? DEFAULT_MAX_ITEMS;
+    const showTabs = config.showCollectionTabs ?? false;
+    const cta = config.cta;
+    if (collections.length === 0) {
+        return null;
+    }
+    return (_jsx(Section, { className: "py-10", children: _jsx(Container, { size: "xl", children: _jsxs(Stack, { gap: "md", children: [_jsxs(Stack, { gap: "xs", children: [_jsx(Heading, { level: 2, className: "text-2xl font-semibold text-zinc-900 dark:text-zinc-50", children: title }), subtitle ? (_jsx(Text, { className: "text-sm text-zinc-500 dark:text-zinc-400", children: subtitle })) : null] }), showTabs ? (_jsx(Row, { gap: "sm", className: "flex-wrap", children: collections.slice(0, 3).map((entry, idx) => (_jsx(Text, { className: "rounded-full border border-zinc-300 px-3 py-1 text-xs font-medium text-zinc-700 dark:border-slate-600 dark:text-zinc-300", children: entryLabel(entry) }, `${entry.type}-${idx}`))) })) : null, _jsxs(Stack, { align: "center", gap: "sm", className: "rounded-2xl border border-dashed border-zinc-300 px-6 py-12 text-center dark:border-slate-700", children: [_jsxs(Text, { className: "text-sm text-zinc-500 dark:text-zinc-400", children: ["Mixed collection rendering (", collections.length, "/3 collection", collections.length === 1 ? "" : "s", ", up to ", maxItems, " items,", " ", itemsPerRow, " per row) \u2014 data wiring lands with the bundle/raffle work."] }), cta ? (_jsxs(Link, { href: cta.href, className: "text-sm font-medium text-primary hover:underline", children: [cta.label, " \u2192"] })) : null] })] }) }) }));
+}

package/dist/features/homepage/components/FAQSection.d.ts

@@ -2,24 +2,34 @@ import React from "react";
 export interface FAQTab {
     value: string;
     label: string;
-    icon?: string;
 }
 export interface FAQItem {
     id: string;
     question: string;
+    /** HTML or plain-text answer. */
     answer: string;
+    category?: string;
 }
 export interface FAQSectionProps {
     title: string;
     subtitle?: string;
-    tabs: FAQTab[];
-    activeTab: string;
     items: FAQItem[];
+    /** Explicit tab list. When omitted and showCategoryTabs=true, tabs are derived from items. */
+    tabs?: FAQTab[];
+    /** Show a category tab bar so visitors can filter by topic. */
+    showCategoryTabs?: boolean;
+    /** Allow multiple accordion panels open simultaneously. Default: false (single-open). */
+    allowMultipleOpen?: boolean;
+    /** Number of items to expand on first render. 0 = all closed. */
+    defaultOpenCount?: number;
     viewMoreHref?: string;
     viewMoreLabel?: string;
     hasMore?: boolean;
     moreCount?: number;
+    /** @deprecated Tabs are now derived internally or from the tabs prop */
+    activeTab?: string;
+    /** @deprecated Use showCategoryTabs + tabs props instead */
     renderTabs?: () => React.ReactNode;
     className?: string;
 }
-export declare function FAQSection({ title, subtitle, items, viewMoreHref, viewMoreLabel, hasMore, moreCount, renderTabs, className, }: FAQSectionProps): import("react/jsx-runtime").JSX.Element;
+export declare function FAQSection({ title, subtitle, items, tabs: tabsProp, showCategoryTabs, allowMultipleOpen, defaultOpenCount, viewMoreHref, viewMoreLabel, hasMore, moreCount, className, }: FAQSectionProps): import("react/jsx-runtime").JSX.Element;