@mohasinac/appkit 2.4.11 → 2.5.1

package/dist/features/homepage/lib/live-stats.js

@@ -5,58 +5,89 @@
  * individual metric are silently swallowed — the section falls back to the
  * static `value` from the Firestore section config.
  */
+import { ALLOWED_LIVE_COLLECTIONS } from "../schemas/firestore";
 import { productRepository, storeRepository, userRepository, reviewRepository, orderRepository, } from "../../../repositories";
+import { getAdminDb, getFirestoreCount } from "../../../providers/db-firebase";
 /**
- * Fetch live stats for the requested metrics only.
- * Pass the exact metric keys needed so unused Firestore queries are skipped.
+ * Fetch live stats for all requested metrics.
+ * Preset metrics are deduped so each Firestore query runs at most once.
+ * Collection-query metrics run their own queries; unknown collections are
+ * blocked by the ALLOWED_LIVE_COLLECTIONS allowlist.
+ * Returns raw count strings — suffix is applied by the caller (section-renderer).
  */
-export async function fetchLiveStats(metrics) {
-    if (metrics.length === 0)
+export async function fetchLiveStats(requests) {
+    if (requests.length === 0)
         return {};
-    const needed = new Set(metrics);
     const result = {};
     const tasks = [];
-    if (needed.has("total_listings")) {
-        tasks.push(productRepository
-            .count()
-            .then((n) => { result.total_listings = String(n); })
+    // --- Preset metrics (deduped) ------------------------------------------------
+    const presetRequests = requests.filter((r) => (r.source === "live" || r.source === "live-preset") && r.preset !== undefined);
+    const resolvedPresets = {};
+    const neededPresets = new Set(presetRequests.map((r) => r.preset));
+    if (neededPresets.has("total_listings")) {
+        tasks.push(productRepository.count()
+            .then((n) => { resolvedPresets.total_listings = String(n); })
             .catch(() => { }));
     }
-    if (needed.has("verified_sellers")) {
-        tasks.push(storeRepository
-            .count()
-            .then((n) => { result.verified_sellers = String(n); })
+    if (neededPresets.has("verified_sellers")) {
+        tasks.push(storeRepository.count()
+            .then((n) => { resolvedPresets.verified_sellers = String(n); })
             .catch(() => { }));
     }
-    if (needed.has("total_buyers")) {
-        tasks.push(userRepository
-            .countByRole("user")
-            .then((n) => { result.total_buyers = String(n); })
+    if (neededPresets.has("total_buyers")) {
+        tasks.push(userRepository.countByRole("user")
+            .then((n) => { resolvedPresets.total_buyers = String(n); })
             .catch(() => { }));
     }
-    if (needed.has("total_orders")) {
-        tasks.push(orderRepository
-            .count()
-            .then((n) => { result.total_orders = String(n); })
+    if (neededPresets.has("total_orders")) {
+        tasks.push(orderRepository.count()
+            .then((n) => { resolvedPresets.total_orders = String(n); })
             .catch(() => { }));
     }
-    if (needed.has("total_reviews") || needed.has("platform_rating")) {
-        tasks.push(reviewRepository
-            .findAll()
+    if (neededPresets.has("total_reviews") || neededPresets.has("platform_rating")) {
+        tasks.push(reviewRepository.findAll()
             .then((res) => {
             const all = Array.isArray(res) ? res : (res?.data ?? []);
-            // Filter to approved reviews only for rating calculation
             const approved = all.filter((r) => !r.status || r.status === "approved");
-            if (needed.has("total_reviews")) {
-                result.total_reviews = String(approved.length);
+            if (neededPresets.has("total_reviews")) {
+                resolvedPresets.total_reviews = String(approved.length);
             }
-            if (needed.has("platform_rating") && approved.length > 0) {
+            if (neededPresets.has("platform_rating") && approved.length > 0) {
                 const avg = approved.reduce((sum, r) => sum + (r.rating ?? 0), 0) / approved.length;
-                result.platform_rating = avg.toFixed(1) + "★";
+                resolvedPresets.platform_rating = avg.toFixed(1) + "★";
             }
         })
             .catch(() => { }));
     }
+    // --- Collection-query metrics ------------------------------------------------
+    const queryRequests = requests.filter((r) => r.source === "live-collection" && r.collectionQuery !== undefined);
+    for (const req of queryRequests) {
+        const { key, collectionQuery } = req;
+        const { collection, filterField, filterValue } = collectionQuery;
+        if (!ALLOWED_LIVE_COLLECTIONS.includes(collection)) {
+            continue; // silently skip non-allowlisted collections
+        }
+        tasks.push((async () => {
+            try {
+                const db = getAdminDb();
+                let ref = db.collection(collection);
+                const query = filterField !== undefined && filterValue !== undefined
+                    ? ref.where(filterField, "==", filterValue)
+                    : ref;
+                const count = await getFirestoreCount(query);
+                result[key] = String(count);
+            }
+            catch {
+                // silently fall back to static value
+            }
+        })());
+    }
     await Promise.all(tasks);
+    // Map resolved preset values back to each requesting stat's key
+    for (const req of presetRequests) {
+        const value = resolvedPresets[req.preset];
+        if (value !== undefined)
+            result[req.key] = value;
+    }
     return result;
 }

package/dist/features/homepage/lib/section-renderer.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-import { type LiveStatsMap } from "./live-stats";
+import type { LiveStatsMap } from "./live-stats";
 import { AnnouncementBar } from "../components/AnnouncementBar";
 import type { CarouselSlide } from "../types/index";
 import type { HomepageSectionDocument } from "../schemas";
@@ -28,6 +28,7 @@ export type FaqItem = {
     id: string;
     question: string;
     answer: string;
+    category: string;
 };
 export declare function renderSection(section: HomepageSectionDocument, adSlots: MarketplaceHomepageViewAdSlots | undefined, newsletterFormSlot: React.ReactNode, faqItems: FaqItem[], slides: CarouselSlide[], liveStats: LiveStatsMap, sectionData?: SectionData): React.ReactNode;
 export { AnnouncementBar };

package/dist/features/homepage/lib/section-renderer.js

@@ -25,6 +25,10 @@ import { BrandsSection } from "../components/BrandsSection";
 import { SocialFeedSection } from "../components/SocialFeedSection";
 import { CustomCardsSection } from "../components/CustomCardsSection";
 import { GoogleReviewsSection } from "../components/GoogleReviewsSection";
+import { FeaturedBundlesSection } from "../../bundles/components/FeaturedBundlesSection";
+import { PrizeDrawsSection } from "../../products/components/PrizeDrawsSection";
+import { EventRafflesSection } from "../../events/components/EventRafflesSection";
+import { CollectionCardsSection } from "../components/CollectionCardsSection";
 const AD_SLOT_MAP = {
     carousel: "afterHero",
     products: "afterFeaturedProducts",
@@ -47,7 +51,7 @@ function renderSectionElement(section, newsletterFormSlot, faqItems, slides, liv
         }
         case "categories": {
             const cfg = config;
-            return (_jsx(ShopByCategorySection, { title: cleanTitle(cfg?.title) || "Shop by Category", viewMoreHref: ROUTES.PUBLIC.CATEGORIES, viewMoreLabel: "All categories \u2192", initialItems: sectionData.categories }));
+            return (_jsx(ShopByCategorySection, { title: cleanTitle(cfg?.title) || "Shop by Category", viewMoreHref: ROUTES.PUBLIC.CATEGORIES, viewMoreLabel: "All categories \u2192", initialItems: sectionData.categories, cta: cfg?.cta, filters: cfg?.filters }));
         }
         case "stats": {
             const cfg = config;
@@ -58,9 +62,10 @@ function renderSectionElement(section, newsletterFormSlot, faqItems, slides, liv
                     typeof item?.value === "string" &&
                     item.value.trim().length > 0)
                     .map((item, index) => {
-                    const liveRaw = item.source === "live" && item.metric
-                        ? liveStats[item.metric]
-                        : undefined;
+                    const isLive = item.source === "live" ||
+                        item.source === "live-preset" ||
+                        item.source === "live-collection";
+                    const liveRaw = isLive ? liveStats[item.key] : undefined;
                     const displayValue = liveRaw !== undefined ? liveRaw + (item.suffix ?? "") : item.value;
                     return {
                         key: typeof item?.key === "string" && item.key.trim().length > 0
@@ -77,7 +82,7 @@ function renderSectionElement(section, newsletterFormSlot, faqItems, slides, liv
         }
         case "products": {
             const cfg = config;
-            return (_jsx(FeaturedProductsSection, { title: cleanTitle(cfg?.title) || "Featured Products", viewMoreHref: ROUTES.PUBLIC.PRODUCTS, viewMoreLabel: "View all products \u2192", filterByBrand: cfg?.filterByBrand, initialItems: sectionData.products }));
+            return (_jsx(FeaturedProductsSection, { title: cleanTitle(cfg?.title) || "Featured Products", viewMoreHref: ROUTES.PUBLIC.PRODUCTS, viewMoreLabel: "View all products \u2192", filterByBrand: cfg?.filterByBrand, initialItems: sectionData.products, rows: cfg?.rows, maxItems: cfg?.maxItems, pagination: cfg?.pagination }));
         }
         case "auctions": {
             const cfg = config;
@@ -113,14 +118,31 @@ function renderSectionElement(section, newsletterFormSlot, faqItems, slides, liv
         }
         case "whatsapp-community": {
             const cfg = config;
-            return (_jsx(WhatsAppCommunitySection, { title: cleanTitle(cfg?.title) || "Join Our WhatsApp Community", descriptionHtml: cfg?.description ||
-                    "5,000+ members. Get deal alerts, auction updates, and exclusive drops before anyone else.", memberCount: cfg?.memberCount || 5000, groupLink: cfg?.groupLink || "https://chat.whatsapp.com/" }));
+            return (_jsx(WhatsAppCommunitySection, { title: cleanTitle(cfg?.title) || "Join Our WhatsApp Community", descriptionHtml: cfg?.description || "5,000+ members. Get deal alerts, auction updates, and exclusive drops before anyone else.", memberCount: cfg?.memberCount || 5000, groupLink: cfg?.groupLink || "https://chat.whatsapp.com/", benefits: cfg?.benefits ?? [], testimonial: cfg?.testimonial, buttonText: cfg?.buttonText }));
         }
         case "faq": {
             const cfg = config;
             if (!cfg?.showOnHomepage || faqItems.length === 0)
                 return null;
-            return (_jsx(FAQSection, { title: cleanTitle(cfg?.title) || "Frequently Asked Questions", tabs: [], activeTab: "", items: faqItems, viewMoreHref: ROUTES.PUBLIC.FAQS, viewMoreLabel: "View all FAQs \u2192" }));
+            // Build tabs from configured visibleTabs (or all categories in config)
+            const tabCategories = (cfg?.visibleTabs?.length ? cfg.visibleTabs : cfg?.categories) ?? [];
+            const FAQ_CATEGORY_LABELS = {
+                general: "General",
+                orders_payment: "Orders & Payment",
+                shipping_delivery: "Shipping",
+                returns_refunds: "Returns & Refunds",
+                product_information: "Products",
+                account_security: "Account",
+                technical_support: "Support",
+            };
+            const tabs = tabCategories.map((cat) => ({
+                value: cat,
+                label: FAQ_CATEGORY_LABELS[cat] ?? cat,
+            }));
+            const slicedItems = cfg?.displayCount ? faqItems.slice(0, cfg.displayCount) : faqItems;
+            const totalFaqs = faqItems.length;
+            const hasMore = totalFaqs > slicedItems.length;
+            return (_jsx(FAQSection, { title: cleanTitle(cfg?.title) || "Frequently Asked Questions", subtitle: cfg?.subtitle, tabs: tabs, showCategoryTabs: cfg?.showCategoryTabs ?? false, allowMultipleOpen: cfg?.allowMultipleOpen ?? false, defaultOpenCount: cfg?.defaultOpenCount ?? 0, items: slicedItems, viewMoreHref: cfg?.linkToFullPage ? ROUTES.PUBLIC.FAQS : undefined, viewMoreLabel: "View all FAQs \u2192", hasMore: hasMore, moreCount: totalFaqs - slicedItems.length }));
         }
         case "blog-articles": {
             const cfg = config;
@@ -132,13 +154,14 @@ function renderSectionElement(section, newsletterFormSlot, faqItems, slides, liv
         }
         case "brands": {
             const cfg = config;
-            return (_jsx(BrandsSection, { title: cleanTitle(cfg?.title) || "Top Brands", subtitle: cfg?.subtitle, limit: cfg?.maxBrands || 12, viewMoreHref: ROUTES.PUBLIC.CATEGORIES, viewMoreLabel: "All brands \u2192", initialItems: sectionData.brands }));
+            return (_jsx(BrandsSection, { title: cleanTitle(cfg?.title) || "Top Brands", subtitle: cfg?.subtitle, limit: cfg?.maxBrands || 12, viewMoreHref: ROUTES.PUBLIC.CATEGORIES, viewMoreLabel: "All brands \u2192", initialItems: sectionData.brands, cta: cfg?.cta, filters: cfg?.filters }));
         }
         case "social-feed": {
             const cfg = config;
-            if (!cfg?.platform || !cfg?.handle)
+            const hasStaticPosts = Array.isArray(cfg?.posts) && cfg.posts.length > 0;
+            if (!cfg?.platform || (!cfg?.handle && !hasStaticPosts))
                 return null;
-            return (_jsx(SocialFeedSection, { title: cleanTitle(cfg.title) || "", subtitle: cfg.subtitle, platform: cfg.platform, handle: cfg.handle, postType: cfg.postType || "all", count: cfg.count || 9, layout: cfg.layout || "grid", showCaption: cfg.showCaption ?? true, showStats: cfg.showStats ?? true }));
+            return (_jsx(SocialFeedSection, { title: cleanTitle(cfg.title) || "", subtitle: cfg.subtitle, platform: cfg.platform, handle: cfg.handle ?? "", postType: cfg.postType || "all", count: cfg.count || 9, layout: cfg.layout || "grid", showCaption: cfg.showCaption ?? true, showStats: cfg.showStats ?? true, posts: cfg.posts }));
         }
         case "custom-cards": {
             const cfg = config;
@@ -150,6 +173,22 @@ function renderSectionElement(section, newsletterFormSlot, faqItems, slides, liv
             const cfg = config;
             return (_jsx(GoogleReviewsSection, { placeId: cfg?.placeId ?? "", maxReviews: cfg?.maxReviews ?? 6, minRating: cfg?.minRating ?? 0, layout: cfg?.layout ?? "grid", showRating: cfg?.showRating ?? true, showDate: cfg?.showDate ?? true, linkToGoogleMaps: cfg?.linkToGoogleMaps ?? true, googleMapsUrl: cfg?.googleMapsUrl }));
         }
+        case "featured-bundles": {
+            const cfg = config;
+            return _jsx(FeaturedBundlesSection, { config: cfg ?? {} });
+        }
+        case "prize-draws": {
+            const cfg = config;
+            return _jsx(PrizeDrawsSection, { config: cfg ?? {} });
+        }
+        case "event-raffles": {
+            const cfg = config;
+            return _jsx(EventRafflesSection, { config: cfg ?? {} });
+        }
+        case "collection-cards": {
+            const cfg = config;
+            return (_jsx(CollectionCardsSection, { config: cfg ?? { collections: [] } }));
+        }
         default:
             return null;
     }

package/dist/features/homepage/repository/carousels.repository.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Named Carousels Repository (EX2)
+ *
+ * Manages CarouselDocument records — each named carousel holds an ordered list
+ * of up to MAX_SLIDES_PER_CAROUSEL slide IDs. The default hero carousel
+ * continues to operate without a CarouselDocument (carouselId = null).
+ */
+import { BaseRepository } from "../../../providers/db-firebase";
+import { CarouselDocument, CarouselUpdateInput } from "../schemas";
+export declare class CarouselsRepository extends BaseRepository<CarouselDocument> {
+    constructor();
+    /** All named carousels, ordered by name. */
+    listCarousels(): Promise<CarouselDocument[]>;
+    /** Create a new named carousel with zero slides. */
+    createCarousel(name: string, createdBy: string): Promise<CarouselDocument>;
+    /** Update name or status. */
+    updateCarousel(id: string, patch: CarouselUpdateInput): Promise<void>;
+    /**
+     * Add a slide ID to a carousel. Throws TooManySlidesError if already at max.
+     * Appends to the end of slideIds.
+     */
+    addSlide(carouselId: string, slideId: string): Promise<void>;
+    /** Remove a slide ID from a carousel. */
+    removeSlide(carouselId: string, slideId: string): Promise<void>;
+    /**
+     * Replace the full slideIds order. Length must not exceed MAX_SLIDES_PER_CAROUSEL.
+     */
+    reorderSlides(carouselId: string, orderedSlideIds: string[]): Promise<void>;
+    /**
+     * Fetch a carousel together with the full slide documents for its slideIds.
+     * Slides are returned in slideIds order.
+     */
+    getCarouselWithSlides(carouselId: string): Promise<{
+        carousel: CarouselDocument;
+        slides: import("../schemas").CarouselSlideDocument[];
+    } | null>;
+}
+export declare const carouselsRepository: CarouselsRepository;

package/dist/features/homepage/repository/carousels.repository.js

@@ -0,0 +1,142 @@
+/**
+ * Named Carousels Repository (EX2)
+ *
+ * Manages CarouselDocument records — each named carousel holds an ordered list
+ * of up to MAX_SLIDES_PER_CAROUSEL slide IDs. The default hero carousel
+ * continues to operate without a CarouselDocument (carouselId = null).
+ */
+import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { CAROUSELS_COLLECTION, MAX_SLIDES_PER_CAROUSEL, TooManySlidesError, } from "../schemas";
+import { DatabaseError } from "../../../errors";
+import { getAdminDb } from "../../../providers/db-firebase";
+export class CarouselsRepository extends BaseRepository {
+    constructor() {
+        super(CAROUSELS_COLLECTION);
+    }
+    /** All named carousels, ordered by name. */
+    async listCarousels() {
+        try {
+            const db = getAdminDb();
+            const snap = await db
+                .collection(CAROUSELS_COLLECTION)
+                .orderBy("name")
+                .get();
+            return snap.docs.map((d) => ({ id: d.id, ...d.data() }));
+        }
+        catch (err) {
+            throw new DatabaseError("Failed to list carousels", err);
+        }
+    }
+    /** Create a new named carousel with zero slides. */
+    async createCarousel(name, createdBy) {
+        const input = {
+            name,
+            status: "draft",
+            slideIds: [],
+            createdBy,
+        };
+        return this.create(input);
+    }
+    /** Update name or status. */
+    async updateCarousel(id, patch) {
+        try {
+            const db = getAdminDb();
+            await db
+                .collection(CAROUSELS_COLLECTION)
+                .doc(id)
+                .update(prepareForFirestore(patch));
+        }
+        catch (err) {
+            throw new DatabaseError("Failed to update carousel", err);
+        }
+    }
+    /**
+     * Add a slide ID to a carousel. Throws TooManySlidesError if already at max.
+     * Appends to the end of slideIds.
+     */
+    async addSlide(carouselId, slideId) {
+        try {
+            const db = getAdminDb();
+            const ref = db.collection(CAROUSELS_COLLECTION).doc(carouselId);
+            await db.runTransaction(async (tx) => {
+                const snap = await tx.get(ref);
+                if (!snap.exists)
+                    throw new DatabaseError("Carousel not found");
+                const data = snap.data();
+                if ((data.slideIds ?? []).length >= MAX_SLIDES_PER_CAROUSEL) {
+                    throw new TooManySlidesError();
+                }
+                const updatedIds = [...(data.slideIds ?? []), slideId];
+                tx.update(ref, prepareForFirestore({ slideIds: updatedIds }));
+            });
+        }
+        catch (err) {
+            if (err instanceof TooManySlidesError)
+                throw err;
+            throw new DatabaseError("Failed to add slide to carousel", err);
+        }
+    }
+    /** Remove a slide ID from a carousel. */
+    async removeSlide(carouselId, slideId) {
+        try {
+            const db = getAdminDb();
+            const ref = db.collection(CAROUSELS_COLLECTION).doc(carouselId);
+            await db.runTransaction(async (tx) => {
+                const snap = await tx.get(ref);
+                if (!snap.exists)
+                    throw new DatabaseError("Carousel not found");
+                const data = snap.data();
+                const updatedIds = (data.slideIds ?? []).filter((id) => id !== slideId);
+                tx.update(ref, prepareForFirestore({ slideIds: updatedIds }));
+            });
+        }
+        catch (err) {
+            throw new DatabaseError("Failed to remove slide from carousel", err);
+        }
+    }
+    /**
+     * Replace the full slideIds order. Length must not exceed MAX_SLIDES_PER_CAROUSEL.
+     */
+    async reorderSlides(carouselId, orderedSlideIds) {
+        if (orderedSlideIds.length > MAX_SLIDES_PER_CAROUSEL) {
+            throw new TooManySlidesError();
+        }
+        try {
+            const db = getAdminDb();
+            await db
+                .collection(CAROUSELS_COLLECTION)
+                .doc(carouselId)
+                .update(prepareForFirestore({ slideIds: orderedSlideIds }));
+        }
+        catch (err) {
+            throw new DatabaseError("Failed to reorder slides", err);
+        }
+    }
+    /**
+     * Fetch a carousel together with the full slide documents for its slideIds.
+     * Slides are returned in slideIds order.
+     */
+    async getCarouselWithSlides(carouselId) {
+        try {
+            const db = getAdminDb();
+            const carouselSnap = await db.collection(CAROUSELS_COLLECTION).doc(carouselId).get();
+            if (!carouselSnap.exists)
+                return null;
+            const carousel = { id: carouselSnap.id, ...carouselSnap.data() };
+            if (!carousel.slideIds?.length)
+                return { carousel, slides: [] };
+            const slideSnaps = await Promise.all(carousel.slideIds.map((sid) => db.collection("carouselSlides").doc(sid).get()));
+            const slides = slideSnaps
+                .filter((s) => s.exists)
+                .map((s) => ({
+                id: s.id,
+                ...s.data(),
+            }));
+            return { carousel, slides };
+        }
+        catch (err) {
+            throw new DatabaseError("Failed to get carousel with slides", err);
+        }
+    }
+}
+export const carouselsRepository = new CarouselsRepository();