@mohasinac/appkit 2.3.2 → 2.4.1

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

@@ -16,5 +16,5 @@ export function WhatsAppCommunitySection({ title, descriptionHtml, memberCount,
         if (groupLink)
             window.open(groupLink, "_blank");
     };
-    return (_jsx(Section, { className: `p-8 ${themed.bgSecondary} ${className}`, children: _jsx("div", { className: "w-full max-w-7xl mx-auto", "data-section": "whatsappcommunitysection-div-391", children: _jsxs("div", { className: "bg-gradient-to-br from-green-700 to-green-800 dark:from-emerald-800 dark:to-emerald-900 rounded-2xl p-8 text-white overflow-hidden relative", "data-section": "whatsappcommunitysection-div-392", children: [_jsx("div", { className: "absolute inset-0 opacity-10", "aria-hidden": true, "data-section": "whatsappcommunitysection-div-393", children: _jsxs("svg", { width: "100%", height: "100%", xmlns: "http://www.w3.org/2000/svg", children: [_jsx("defs", { children: _jsx("pattern", { id: "wa-dots", x: "0", y: "0", width: "40", height: "40", patternUnits: "userSpaceOnUse", children: _jsx("circle", { cx: "20", cy: "20", r: "2", fill: "white" }) }) }), _jsx("rect", { width: "100%", height: "100%", fill: "url(#wa-dots)" })] }) }), _jsxs("div", { className: "relative z-10 text-center", "data-section": "whatsappcommunitysection-div-394", children: [_jsx("div", { className: `inline-flex items-center justify-center w-20 h-20 rounded-full bg-white/20 backdrop-blur-sm mb-6 mx-auto`, "data-section": "whatsappcommunitysection-div-395", children: _jsx(MessageCircle, { className: "w-10 h-10 text-white" }) }), _jsx(Heading, { level: 2, className: "mb-3 text-white", children: title }), descriptionHtml && (_jsx(RichText, { html: descriptionHtml, className: "text-lg md:text-xl mb-2 opacity-90 prose-invert prose-sm" })), memberCount && (_jsxs("div", { className: `${flex.center} gap-3 mb-4`, "data-section": "whatsappcommunitysection-div-396", children: [_jsx("div", { className: "flex -space-x-2", "data-section": "whatsappcommunitysection-div-397", children: ["A", "R", "S", "M", "P"].map((initial, i) => (_jsx("div", { className: `w-8 h-8 rounded-full border-2 border-white bg-green-700 ${flex.center} text-white text-xs font-bold`, "data-section": "whatsappcommunitysection-div-398", children: initial }, i))) }), _jsxs(Text, { variant: "none", className: "text-white font-bold", children: [_jsx(Span, { className: "text-xl font-extrabold", children: memberCount.toLocaleString(getDefaultLocale()) }), " ", memberCountLabel] })] })), testimonial && (_jsxs(Text, { size: "sm", variant: "none", className: "italic text-white/90 max-w-sm mx-auto mb-6", children: ["\u201C", testimonial, "\u201D"] })), benefits.length > 0 && (_jsx(Grid, { className: "grid-cols-1 sm:grid-cols-2 lg:grid-cols-4 xl:grid-cols-4 2xl:grid-cols-4 max-w-2xl mx-auto my-8", children: benefits.slice(0, 4).map((benefit, index) => (_jsxs("div", { className: "flex items-start gap-3 text-left bg-white/10 backdrop-blur-sm p-4 rounded-lg", "data-section": "whatsappcommunitysection-div-399", children: [_jsx("svg", { className: "w-6 h-6 mt-0.5 flex-shrink-0", fill: "currentColor", viewBox: "0 0 20 20", children: _jsx("path", { fillRule: "evenodd", d: "M10 18a8 8 0 100-16 8 8 0 000 16zm3.707-9.293a1 1 0 00-1.414-1.414L9 10.586 7.707 9.293a1 1 0 00-1.414 1.414l2 2a1 1 0 001.414 0l4-4z", clipRule: "evenodd" }) }), _jsx(Span, { className: "text-sm md:text-base", children: benefit })] }, index))) })), groupLink && (_jsxs("div", { className: "relative inline-block", "data-section": "whatsappcommunitysection-div-400", children: [_jsx("div", { className: "absolute inset-0 rounded-full bg-lime-400/30 animate-pulse blur-md scale-110", "aria-hidden": true }), _jsxs(Button, { variant: "primary", size: "lg", "aria-label": buttonText, onClick: handleJoin, className: "relative !bg-white !text-green-700 hover:!bg-zinc-100 shadow-xl hover:shadow-2xl", children: [_jsx("svg", { className: "w-6 h-6 mr-2", fill: "currentColor", viewBox: "0 0 24 24", children: _jsx("path", { d: "M17.472 14.382c-.297-.149-1.758-.867-2.03-.967-.273-.099-.471-.148-.67.15-.197.297-.767.966-.94 1.164-.173.199-.347.223-.644.075-.297-.15-1.255-.463-2.39-1.475-.883-.788-1.48-1.761-1.653-2.059-.173-.297-.018-.458.13-.606.134-.133.298-.347.446-.52.149-.174.198-.298.298-.497.099-.198.05-.371-.025-.52-.075-.149-.669-1.612-.916-2.207-.242-.579-.487-.5-.669-.51-.173-.008-.371-.01-.57-.01-.198 0-.52.074-.792.372-.272.297-1.04 1.016-1.04 2.479 0 1.462 1.065 2.875 1.213 3.074.149.198 2.096 3.2 5.077 4.487.709.306 1.262.489 1.694.625.712.227 1.36.195 1.871.118.571-.085 1.758-.719 2.006-1.413.248-.694.248-1.289.173-1.413-.074-.124-.272-.198-.57-.347m-5.421 7.403h-.004a9.87 9.87 0 01-5.031-1.378l-.361-.214-3.741.982.998-3.648-.235-.374a9.86 9.86 0 01-1.51-5.26c.001-5.45 4.436-9.884 9.888-9.884 2.64 0 5.122 1.03 6.988 2.898a9.825 9.825 0 012.893 6.994c-.003 5.45-4.437 9.884-9.885 9.884m8.413-18.297A11.815 11.815 0 0012.05 0C5.495 0 .16 5.335.157 11.892c0 2.096.547 4.142 1.588 5.945L.057 24l6.305-1.654a11.882 11.882 0 005.683 1.448h.005c6.554 0 11.89-5.335 11.893-11.893a11.821 11.821 0 00-3.48-8.413z" }) }), buttonText] })] }))] })] }) }) }));
+    return (_jsx(Section, { className: `p-8 ${themed.bgSecondary} ${className}`, children: _jsx("div", { className: "w-full max-w-7xl mx-auto", "data-section": "whatsappcommunitysection-div-391", children: _jsxs("div", { className: "bg-gradient-to-br from-green-700 to-green-800 dark:from-emerald-800 dark:to-emerald-900 rounded-2xl p-8 text-white overflow-hidden relative", "data-section": "whatsappcommunitysection-div-392", children: [_jsx("div", { className: "absolute inset-0 opacity-10", "aria-hidden": true, "data-section": "whatsappcommunitysection-div-393", children: _jsxs("svg", { width: "100%", height: "100%", xmlns: "http://www.w3.org/2000/svg", children: [_jsx("defs", { children: _jsx("pattern", { id: "wa-dots", x: "0", y: "0", width: "40", height: "40", patternUnits: "userSpaceOnUse", children: _jsx("circle", { cx: "20", cy: "20", r: "2", fill: "white" }) }) }), _jsx("rect", { width: "100%", height: "100%", fill: "url(#wa-dots)" })] }) }), _jsxs("div", { className: "relative z-10 text-center", "data-section": "whatsappcommunitysection-div-394", children: [_jsx("div", { className: `inline-flex items-center justify-center w-20 h-20 rounded-full bg-white/20 backdrop-blur-sm mb-6 mx-auto`, "data-section": "whatsappcommunitysection-div-395", children: _jsx(MessageCircle, { className: "w-10 h-10 text-white" }) }), _jsx(Heading, { level: 2, className: "mb-3 text-white", children: title }), descriptionHtml && (_jsx(RichText, { html: descriptionHtml, proseClass: "prose max-w-none prose-invert prose-sm", className: "text-lg md:text-xl mb-2 opacity-90" })), memberCount && (_jsxs("div", { className: `${flex.center} gap-3 mb-4`, "data-section": "whatsappcommunitysection-div-396", children: [_jsx("div", { className: "flex -space-x-2", "data-section": "whatsappcommunitysection-div-397", children: ["A", "R", "S", "M", "P"].map((initial, i) => (_jsx("div", { className: `w-8 h-8 rounded-full border-2 border-white bg-green-700 ${flex.center} text-white text-xs font-bold`, "data-section": "whatsappcommunitysection-div-398", children: initial }, i))) }), _jsxs(Text, { variant: "none", className: "text-white font-bold", children: [_jsx(Span, { className: "text-xl font-extrabold", children: memberCount.toLocaleString(getDefaultLocale()) }), " ", memberCountLabel] })] })), testimonial && (_jsxs(Text, { size: "sm", variant: "none", className: "italic text-white/90 max-w-sm mx-auto mb-6", children: ["\u201C", testimonial, "\u201D"] })), benefits.length > 0 && (_jsx(Grid, { className: "grid-cols-1 sm:grid-cols-2 lg:grid-cols-4 xl:grid-cols-4 2xl:grid-cols-4 max-w-2xl mx-auto my-8", children: benefits.slice(0, 4).map((benefit, index) => (_jsxs("div", { className: "flex items-start gap-3 text-left bg-white/10 backdrop-blur-sm p-4 rounded-lg", "data-section": "whatsappcommunitysection-div-399", children: [_jsx("svg", { className: "w-6 h-6 mt-0.5 flex-shrink-0", fill: "currentColor", viewBox: "0 0 20 20", children: _jsx("path", { fillRule: "evenodd", d: "M10 18a8 8 0 100-16 8 8 0 000 16zm3.707-9.293a1 1 0 00-1.414-1.414L9 10.586 7.707 9.293a1 1 0 00-1.414 1.414l2 2a1 1 0 001.414 0l4-4z", clipRule: "evenodd" }) }), _jsx(Span, { className: "text-sm md:text-base", children: benefit })] }, index))) })), groupLink && (_jsxs("div", { className: "relative inline-block", "data-section": "whatsappcommunitysection-div-400", children: [_jsx("div", { className: "absolute inset-0 rounded-full bg-lime-400/30 animate-pulse blur-md scale-110", "aria-hidden": true }), _jsxs(Button, { variant: "primary", size: "lg", "aria-label": buttonText, onClick: handleJoin, className: "relative !bg-white !text-green-700 hover:!bg-zinc-100 shadow-xl hover:shadow-2xl", children: [_jsx("svg", { className: "w-6 h-6 mr-2", fill: "currentColor", viewBox: "0 0 24 24", children: _jsx("path", { d: "M17.472 14.382c-.297-.149-1.758-.867-2.03-.967-.273-.099-.471-.148-.67.15-.197.297-.767.966-.94 1.164-.173.199-.347.223-.644.075-.297-.15-1.255-.463-2.39-1.475-.883-.788-1.48-1.761-1.653-2.059-.173-.297-.018-.458.13-.606.134-.133.298-.347.446-.52.149-.174.198-.298.298-.497.099-.198.05-.371-.025-.52-.075-.149-.669-1.612-.916-2.207-.242-.579-.487-.5-.669-.51-.173-.008-.371-.01-.57-.01-.198 0-.52.074-.792.372-.272.297-1.04 1.016-1.04 2.479 0 1.462 1.065 2.875 1.213 3.074.149.198 2.096 3.2 5.077 4.487.709.306 1.262.489 1.694.625.712.227 1.36.195 1.871.118.571-.085 1.758-.719 2.006-1.413.248-.694.248-1.289.173-1.413-.074-.124-.272-.198-.57-.347m-5.421 7.403h-.004a9.87 9.87 0 01-5.031-1.378l-.361-.214-3.741.982.998-3.648-.235-.374a9.86 9.86 0 01-1.51-5.26c.001-5.45 4.436-9.884 9.888-9.884 2.64 0 5.122 1.03 6.988 2.898a9.825 9.825 0 012.893 6.994c-.003 5.45-4.437 9.884-9.885 9.884m8.413-18.297A11.815 11.815 0 0012.05 0C5.495 0 .16 5.335.157 11.892c0 2.096.547 4.142 1.588 5.945L.057 24l6.305-1.654a11.882 11.882 0 005.683 1.448h.005c6.554 0 11.89-5.335 11.893-11.893a11.821 11.821 0 00-3.48-8.413z" }) }), buttonText] })] }))] })] }) }) }));
 }

package/dist/features/homepage/hooks/useActiveAd.d.ts

@@ -0,0 +1,23 @@
+import type { AdSlotId } from "../ad-registry";
+export type ActiveAdCreative = {
+    title?: string;
+    body?: string;
+    imageUrl?: string;
+    ctaLabel?: string;
+    ctaHref?: string;
+    adsenseSlot?: string;
+    thirdPartyUrl?: string;
+};
+export type ActiveAdRecord = {
+    id: string;
+    name: string;
+    provider: "manual" | "adsense" | "thirdParty";
+    requiresConsent?: boolean;
+    creative: ActiveAdCreative;
+};
+type State = {
+    loading: boolean;
+    ad: ActiveAdRecord | null;
+};
+export declare function useActiveAd(slotId: AdSlotId): State;
+export {};

package/dist/features/homepage/hooks/useActiveAd.js

@@ -0,0 +1,20 @@
+"use client";
+import { useEffect, useState } from "react";
+export function useActiveAd(slotId) {
+    const [state, setState] = useState({ loading: true, ad: null });
+    useEffect(() => {
+        let cancelled = false;
+        fetch(`/api/ads?slot=${encodeURIComponent(slotId)}`)
+            .then((r) => r.json())
+            .then((json) => {
+            if (!cancelled)
+                setState({ loading: false, ad: json?.data ?? null });
+        })
+            .catch(() => {
+            if (!cancelled)
+                setState({ loading: false, ad: null });
+        });
+        return () => { cancelled = true; };
+    }, [slotId]);
+    return state;
+}

package/dist/features/homepage/hooks/useBlogArticles.d.ts

@@ -9,4 +9,5 @@ export interface BlogListResult {
 }
 export declare function useBlogArticles(options?: {
     endpoint?: string;
+    initialPosts?: BlogListResult["posts"];
 }): import("@tanstack/react-query").UseQueryResult<BlogListResult, Error>;

package/dist/features/homepage/hooks/useBlogArticles.js

@@ -5,6 +5,16 @@ const MIN_BLOG_COUNT = 4;
 export function useBlogArticles(options) {
     return useQuery({
         queryKey: ["blog", "featured"],
+        initialData: options?.initialPosts?.length
+            ? {
+                posts: options.initialPosts,
+                meta: {
+                    total: options.initialPosts.length,
+                    page: 1,
+                    pageSize: options.initialPosts.length,
+                },
+            }
+            : undefined,
         queryFn: async () => {
             const featuredEndpoint = options?.endpoint ?? BLOG_ENDPOINTS.FEATURED(MIN_BLOG_COUNT);
             const featuredResult = await apiClient.get(featuredEndpoint);

package/dist/features/homepage/hooks/useFeaturedAuctions.d.ts

@@ -1,2 +1,5 @@
 import type { ProductItem } from "@mohasinac/appkit/features/products";
-export declare function useFeaturedAuctions(): import("@tanstack/react-query").UseQueryResult<ProductItem[], Error>;
+export declare function useFeaturedAuctions(options?: {
+    filterByBrand?: string;
+    initialData?: ProductItem[];
+}): import("@tanstack/react-query").UseQueryResult<ProductItem[], Error>;

package/dist/features/homepage/hooks/useFeaturedAuctions.js

@@ -2,16 +2,20 @@ import { useQuery } from "@tanstack/react-query";
 import { apiClient } from "../../../http";
 import { PRODUCT_ENDPOINTS } from "../../../constants/api-endpoints";
 const MIN_COUNT = 12;
-export function useFeaturedAuctions() {
+export function useFeaturedAuctions(options) {
+    const brandFilter = options?.filterByBrand
+        ? `%2Cbrand%3D%3D${encodeURIComponent(options.filterByBrand)}`
+        : "";
     return useQuery({
-        queryKey: ["auctions", "featured"],
+        queryKey: ["auctions", "featured", options?.filterByBrand ?? "all"],
+        initialData: options?.initialData,
         queryFn: async () => {
-            const promotedRes = await apiClient.get(`${PRODUCT_ENDPOINTS.LIST}?filters=isAuction%3D%3Dtrue%2Cstatus%3D%3Dpublished%2CisPromoted%3D%3Dtrue&pageSize=18`);
+            const promotedRes = await apiClient.get(`${PRODUCT_ENDPOINTS.LIST}?filters=isAuction%3D%3Dtrue%2Cstatus%3D%3Dpublished%2CisPromoted%3D%3Dtrue${brandFilter}&pageSize=18`);
             const promoted = promotedRes?.items ?? [];
             if (promoted.length >= MIN_COUNT)
                 return promoted;
             const remaining = MIN_COUNT - promoted.length;
-            const latestRes = await apiClient.get(`${PRODUCT_ENDPOINTS.LIST}?filters=isAuction%3D%3Dtrue%2Cstatus%3D%3Dpublished&sorts=-createdAt&pageSize=${remaining + promoted.length}`);
+            const latestRes = await apiClient.get(`${PRODUCT_ENDPOINTS.LIST}?filters=isAuction%3D%3Dtrue%2Cstatus%3D%3Dpublished${brandFilter}&sorts=-createdAt&pageSize=${remaining + promoted.length}`);
             const latest = latestRes?.items ?? [];
             const existingIds = new Set(promoted.map((a) => a.id));
             const filler = latest

package/dist/features/homepage/hooks/useFeaturedPreOrders.d.ts

@@ -1,2 +1,5 @@
 import type { ProductItem } from "@mohasinac/appkit/features/products";
-export declare function useFeaturedPreOrders(): import("@tanstack/react-query").UseQueryResult<ProductItem[], Error>;
+export declare function useFeaturedPreOrders(options?: {
+    filterByBrand?: string;
+    initialData?: ProductItem[];
+}): import("@tanstack/react-query").UseQueryResult<ProductItem[], Error>;

package/dist/features/homepage/hooks/useFeaturedPreOrders.js

@@ -2,16 +2,20 @@ import { useQuery } from "@tanstack/react-query";
 import { apiClient } from "../../../http";
 import { PRODUCT_ENDPOINTS } from "../../../constants/api-endpoints";
 const MIN_COUNT = 12;
-export function useFeaturedPreOrders() {
+export function useFeaturedPreOrders(options) {
+    const brandFilter = options?.filterByBrand
+        ? `%2Cbrand%3D%3D${encodeURIComponent(options.filterByBrand)}`
+        : "";
     return useQuery({
-        queryKey: ["pre-orders", "featured"],
+        queryKey: ["pre-orders", "featured", options?.filterByBrand ?? "all"],
+        initialData: options?.initialData,
         queryFn: async () => {
-            const featuredRes = await apiClient.get(`${PRODUCT_ENDPOINTS.LIST}?filters=isPreOrder%3D%3Dtrue%2Cstatus%3D%3Dpublished&sorts=preOrderDeliveryDate&pageSize=6`);
+            const featuredRes = await apiClient.get(`${PRODUCT_ENDPOINTS.LIST}?filters=isPreOrder%3D%3Dtrue%2Cstatus%3D%3Dpublished${brandFilter}&sorts=preOrderDeliveryDate&pageSize=6`);
             const featured = featuredRes?.items ?? [];
             if (featured.length >= MIN_COUNT)
                 return featured;
             const remaining = MIN_COUNT - featured.length;
-            const latestRes = await apiClient.get(`${PRODUCT_ENDPOINTS.LIST}?filters=isPreOrder%3D%3Dtrue%2Cstatus%3D%3Dpublished&sorts=-createdAt&pageSize=${remaining + featured.length}`);
+            const latestRes = await apiClient.get(`${PRODUCT_ENDPOINTS.LIST}?filters=isPreOrder%3D%3Dtrue%2Cstatus%3D%3Dpublished${brandFilter}&sorts=-createdAt&pageSize=${remaining + featured.length}`);
             const latest = latestRes?.items ?? [];
             const existingIds = new Set(featured.map((p) => p.id));
             const filler = latest

package/dist/features/homepage/hooks/useFeaturedProducts.d.ts

@@ -1,4 +1,5 @@
 import type { ProductListResponse } from "../../products/types";
 export declare function useFeaturedProducts(options?: {
     initialData?: ProductListResponse;
+    filterByBrand?: string;
 }): import("@tanstack/react-query").UseQueryResult<ProductListResponse, Error>;

package/dist/features/homepage/hooks/useFeaturedProducts.js

@@ -3,15 +3,18 @@ import { apiClient } from "../../../http";
 import { PRODUCT_ENDPOINTS } from "../../../constants/api-endpoints";
 const MIN_COUNT = 12;
 export function useFeaturedProducts(options) {
+    const brandFilter = options?.filterByBrand
+        ? `%2Cbrand%3D%3D${encodeURIComponent(options.filterByBrand)}`
+        : "";
     return useQuery({
-        queryKey: ["products", "featured"],
+        queryKey: ["products", "featured", options?.filterByBrand ?? "all"],
         queryFn: async () => {
-            const promotedRes = await apiClient.get(`${PRODUCT_ENDPOINTS.LIST}?filters=isPromoted%3D%3Dtrue%2Cstatus%3D%3Dpublished&pageSize=18`);
+            const promotedRes = await apiClient.get(`${PRODUCT_ENDPOINTS.LIST}?filters=isPromoted%3D%3Dtrue%2Cstatus%3D%3Dpublished${brandFilter}&pageSize=18`);
             const promoted = promotedRes?.items ?? [];
             if (promoted.length >= MIN_COUNT)
                 return promotedRes;
             const remaining = MIN_COUNT - promoted.length;
-            const latestRes = await apiClient.get(`${PRODUCT_ENDPOINTS.LIST}?filters=status%3D%3Dpublished&sorts=-createdAt&pageSize=${remaining + promoted.length}`);
+            const latestRes = await apiClient.get(`${PRODUCT_ENDPOINTS.LIST}?filters=status%3D%3Dpublished${brandFilter}&sorts=-createdAt&pageSize=${remaining + promoted.length}`);
             const latest = latestRes?.items ?? [];
             const existingIds = new Set(promoted.map((p) => p.id));
             const filler = latest

package/dist/features/homepage/hooks/useFeaturedStores.d.ts

@@ -1,2 +1,4 @@
 import type { StoreListItem } from "../../stores/types";
-export declare function useFeaturedStores(limit?: number): import("@tanstack/react-query").UseQueryResult<StoreListItem[], Error>;
+export declare function useFeaturedStores(limit?: number, options?: {
+    initialData?: StoreListItem[];
+}): import("@tanstack/react-query").UseQueryResult<StoreListItem[], Error>;

package/dist/features/homepage/hooks/useFeaturedStores.js

@@ -1,9 +1,10 @@
 import { useQuery } from "@tanstack/react-query";
 import { apiClient } from "../../../http";
 import { STORE_ENDPOINTS } from "../../../constants/api-endpoints";
-export function useFeaturedStores(limit = 8) {
+export function useFeaturedStores(limit = 8, options) {
     return useQuery({
         queryKey: ["stores", "featured", String(limit)],
+        initialData: options?.initialData,
         queryFn: async () => {
             const res = await apiClient.get(`${STORE_ENDPOINTS.LIST}?pageSize=${limit}&sort=-averageRating`);
             return res?.items ?? [];

package/dist/features/homepage/hooks/useHomepageEvents.d.ts

@@ -3,4 +3,6 @@ export interface HomepageEventsListResponse {
     items: EventItem[];
     total: number;
 }
-export declare function useHomepageEvents(limit?: number): import("@tanstack/react-query").UseQueryResult<EventItem[], Error>;
+export declare function useHomepageEvents(limit?: number, options?: {
+    initialData?: EventItem[];
+}): import("@tanstack/react-query").UseQueryResult<EventItem[], Error>;

package/dist/features/homepage/hooks/useHomepageEvents.js

@@ -1,9 +1,10 @@
 import { useQuery } from "@tanstack/react-query";
 import { apiClient } from "../../../http";
 import { EVENT_ENDPOINTS } from "../../../constants/api-endpoints";
-export function useHomepageEvents(limit = 6) {
+export function useHomepageEvents(limit = 6, options) {
     return useQuery({
         queryKey: ["events", "homepage", String(limit)],
+        initialData: options?.initialData,
         queryFn: async () => {
             const res = await apiClient.get(`${EVENT_ENDPOINTS.LIST}?filters=status%3D%3Dactive&pageSize=${limit}`);
             return res?.items ?? [];

package/dist/features/homepage/hooks/useTopBrands.d.ts

@@ -1,2 +1,4 @@
 import type { CategoryItem } from "../../categories/types";
-export declare function useTopBrands(limit?: number): import("@tanstack/react-query").UseQueryResult<CategoryItem[], Error>;
+export declare function useTopBrands(limit?: number, options?: {
+    initialData?: CategoryItem[];
+}): import("@tanstack/react-query").UseQueryResult<CategoryItem[], Error>;

package/dist/features/homepage/hooks/useTopBrands.js

@@ -1,9 +1,10 @@
 import { useQuery } from "@tanstack/react-query";
 import { apiClient } from "../../../http";
 import { CATEGORY_ENDPOINTS } from "../../../constants/api-endpoints";
-export function useTopBrands(limit = 12) {
+export function useTopBrands(limit = 12, options) {
     return useQuery({
         queryKey: ["categories", "brands", String(limit)],
+        initialData: options?.initialData,
         queryFn: () => apiClient.get(CATEGORY_ENDPOINTS.BRANDS(limit)),
         staleTime: Infinity,
         gcTime: Infinity,

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

@@ -10,6 +10,8 @@ export * from "./hooks/useTopBrands";
 export * from "./hooks/useBlogArticles";
 export * from "./hooks/useHomepageReviews";
 export * from "./hooks/useNewsletter";
+export { useActiveAd } from "./hooks/useActiveAd";
+export type { ActiveAdRecord, ActiveAdCreative } from "./hooks/useActiveAd";
 export * from "./hooks/useFeaturedStores";
 export * from "./hooks/useHomepageEvents";
 export * from "./components";

package/dist/features/homepage/index.js

@@ -10,6 +10,7 @@ export * from "./hooks/useTopBrands";
 export * from "./hooks/useBlogArticles";
 export * from "./hooks/useHomepageReviews";
 export * from "./hooks/useNewsletter";
+export { useActiveAd } from "./hooks/useActiveAd";
 export * from "./hooks/useFeaturedStores";
 export * from "./hooks/useHomepageEvents";
 export * from "./components";

package/dist/features/homepage/lib/google-reviews-fetcher.d.ts

@@ -0,0 +1,14 @@
+export interface GoogleReview {
+    authorName: string;
+    authorPhotoUrl: string;
+    rating: number;
+    text: string;
+    time: number;
+    profileUrl: string;
+}
+export interface GoogleReviewsResult {
+    reviews: GoogleReview[];
+    aggregateRating: number;
+    totalRatings: number;
+}
+export declare function fetchGoogleReviews(placeId: string, apiKey: string, maxReviews?: number, minRating?: number): Promise<GoogleReviewsResult>;

package/dist/features/homepage/lib/google-reviews-fetcher.js

@@ -0,0 +1,27 @@
+export async function fetchGoogleReviews(placeId, apiKey, maxReviews = 5, minRating = 0) {
+    const url = new URL("https://maps.googleapis.com/maps/api/place/details/json");
+    url.searchParams.set("place_id", placeId);
+    url.searchParams.set("fields", "reviews,rating,user_ratings_total");
+    url.searchParams.set("key", apiKey);
+    const res = await fetch(url.toString(), { next: { revalidate: 3600 } });
+    if (!res.ok)
+        throw new Error(`Google Places API error: ${res.status}`);
+    const json = (await res.json());
+    const raw = Array.isArray(json.result?.reviews) ? json.result.reviews : [];
+    const reviews = raw
+        .filter((r) => (r.rating ?? 0) >= minRating)
+        .slice(0, maxReviews)
+        .map((r) => ({
+        authorName: r.author_name ?? "Anonymous",
+        authorPhotoUrl: r.profile_photo_url ?? "",
+        rating: r.rating ?? 0,
+        text: r.text ?? "",
+        time: r.time ?? 0,
+        profileUrl: r.author_url ?? "",
+    }));
+    return {
+        reviews,
+        aggregateRating: json.result?.rating ?? 0,
+        totalRatings: json.result?.user_ratings_total ?? 0,
+    };
+}

package/dist/features/homepage/lib/live-stats.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Live platform stats for the homepage stats section.
+ *
+ * Called server-side only inside MarketplaceHomepageView. Failures in any
+ * individual metric are silently swallowed — the section falls back to the
+ * static `value` from the Firestore section config.
+ */
+import type { LiveStatMetric } from "../schemas/firestore";
+export type LiveStatsMap = Partial<Record<LiveStatMetric, string>>;
+/**
+ * Fetch live stats for the requested metrics only.
+ * Pass the exact metric keys needed so unused Firestore queries are skipped.
+ */
+export declare function fetchLiveStats(metrics: LiveStatMetric[]): Promise<LiveStatsMap>;

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

@@ -0,0 +1,62 @@
+/**
+ * Live platform stats for the homepage stats section.
+ *
+ * Called server-side only inside MarketplaceHomepageView. Failures in any
+ * individual metric are silently swallowed — the section falls back to the
+ * static `value` from the Firestore section config.
+ */
+import { productRepository, storeRepository, userRepository, reviewRepository, orderRepository, } from "../../../repositories";
+/**
+ * Fetch live stats for the requested metrics only.
+ * Pass the exact metric keys needed so unused Firestore queries are skipped.
+ */
+export async function fetchLiveStats(metrics) {
+    if (metrics.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); })
+            .catch(() => { }));
+    }
+    if (needed.has("verified_sellers")) {
+        tasks.push(storeRepository
+            .count()
+            .then((n) => { result.verified_sellers = String(n); })
+            .catch(() => { }));
+    }
+    if (needed.has("total_buyers")) {
+        tasks.push(userRepository
+            .countByRole("user")
+            .then((n) => { result.total_buyers = String(n); })
+            .catch(() => { }));
+    }
+    if (needed.has("total_orders")) {
+        tasks.push(orderRepository
+            .count()
+            .then((n) => { result.total_orders = String(n); })
+            .catch(() => { }));
+    }
+    if (needed.has("total_reviews") || needed.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 (needed.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) + "★";
+            }
+        })
+            .catch(() => { }));
+    }
+    await Promise.all(tasks);
+    return result;
+}

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

@@ -0,0 +1,11 @@
+/** Static default content used when Firestore section config has no override. */
+export declare const DEFAULT_TRUST_FEATURES: {
+    iconName: string;
+    title: string;
+    description: string;
+}[];
+export declare const DEFAULT_SECURITY_ITEMS: {
+    key: string;
+    title: string;
+    description: string;
+}[];

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

@@ -0,0 +1,45 @@
+/** Static default content used when Firestore section config has no override. */
+export const DEFAULT_TRUST_FEATURES = [
+    {
+        iconName: "secure-payments",
+        title: "Secure Payments",
+        description: "Protected payments with transparent order tracking.",
+    },
+    {
+        iconName: "fast-delivery",
+        title: "Fast Delivery",
+        description: "Fast shipping with reliable nationwide logistics partners.",
+    },
+    {
+        iconName: "easy-returns",
+        title: "Easy Returns",
+        description: "Hassle-free returns within the policy window.",
+    },
+    {
+        iconName: "support",
+        title: "24/7 Support",
+        description: "Real help from our team across pre and post purchase.",
+    },
+];
+export const DEFAULT_SECURITY_ITEMS = [
+    {
+        key: "encryption",
+        title: "End-to-End Encryption",
+        description: "All sensitive data is encrypted in transit and at rest.",
+    },
+    {
+        key: "tls",
+        title: "TLS 1.3 in Transit",
+        description: "Every API call and page load is secured with modern TLS.",
+    },
+    {
+        key: "rbac",
+        title: "Role-Based Access",
+        description: "Strict role boundaries keep buyer, seller, and admin data separate.",
+    },
+    {
+        key: "min-priv",
+        title: "Minimum-Privilege Tokens",
+        description: "Short-lived, scoped tokens minimise exposure on every request.",
+    },
+];

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

@@ -0,0 +1,5 @@
+/** Shared string helpers for homepage section rendering. */
+/** Strip leading emoji/symbols that admins sometimes prefix onto DB titles. */
+export declare function cleanTitle(raw: string | undefined): string | undefined;
+/** Parse a ProseMirror/Tiptap JSON welcome description to plain text, or return as-is. */
+export declare function parseWelcomeDescription(description: string | undefined): string;

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

@@ -0,0 +1,25 @@
+/** Shared string helpers for homepage section rendering. */
+/** Strip leading emoji/symbols that admins sometimes prefix onto DB titles. */
+export function cleanTitle(raw) {
+    if (!raw)
+        return raw;
+    const cleaned = raw.replace(/^[^\p{L}\p{N}]+/u, "").trim();
+    return cleaned || raw;
+}
+/** Parse a ProseMirror/Tiptap JSON welcome description to plain text, or return as-is. */
+export function parseWelcomeDescription(description) {
+    if (!description)
+        return "";
+    try {
+        const parsed = JSON.parse(description);
+        const extracted = parsed.content
+            ?.flatMap((node) => node.content ?? [])
+            .map((leaf) => leaf.text ?? "")
+            .join(" ")
+            .trim();
+        return extracted || description;
+    }
+    catch {
+        return description;
+    }
+}

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

@@ -0,0 +1,33 @@
+import React from "react";
+import { type LiveStatsMap } from "./live-stats";
+import { AnnouncementBar } from "../components/AnnouncementBar";
+import type { CarouselSlide } from "../types/index";
+import type { HomepageSectionDocument } from "../schemas";
+import type { ProductItem } from "../../products/types";
+import type { StoreListItem } from "../../stores/types";
+import type { CategoryItem } from "../../categories/types";
+import type { BlogPost } from "../../blog/types";
+import type { EventItem } from "../../events/types";
+export interface SectionData {
+    products?: ProductItem[];
+    auctions?: ProductItem[];
+    preOrders?: ProductItem[];
+    stores?: StoreListItem[];
+    categories?: CategoryItem[];
+    brands?: CategoryItem[];
+    blog?: BlogPost[];
+    events?: EventItem[];
+}
+export interface MarketplaceHomepageViewAdSlots {
+    afterHero?: React.ReactNode;
+    afterFeaturedProducts?: React.ReactNode;
+    afterReviews?: React.ReactNode;
+    afterFAQ?: React.ReactNode;
+}
+export type FaqItem = {
+    id: string;
+    question: string;
+    answer: 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 };