@mohasinac/appkit 2.2.0 → 2.3.1

package/dist/features/admin/components/AdminAdsView.js

@@ -0,0 +1,165 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from "react";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { Alert, Button, Input, Select, StackedViewShell, Text } from "../../../ui";
+import { apiClient } from "../../../http";
+import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
+import { DataTable } from "./DataTable";
+export function AdminAdsView({ endpoint = ADMIN_ENDPOINTS.ADS, labels = {}, createHref = "/admin/ads/new", renderEditLink, ...rest }) {
+    const queryClient = useQueryClient();
+    const [page, setPage] = React.useState(1);
+    const [pageSize] = React.useState(20);
+    const [q, setQ] = React.useState("");
+    const [status, setStatus] = React.useState("all");
+    const [provider, setProvider] = React.useState("all");
+    const [placement, setPlacement] = React.useState("all");
+    const [consentRequired, setConsentRequired] = React.useState(false);
+    const [adsenseClientId, setAdsenseClientId] = React.useState("");
+    const [thirdPartyScriptUrl, setThirdPartyScriptUrl] = React.useState("");
+    const [settingsMessage, setSettingsMessage] = React.useState(null);
+    const queryKey = ["admin-ads", endpoint, page, pageSize, q, status, provider, placement];
+    const adsQuery = useQuery({
+        queryKey,
+        queryFn: () => {
+            const sp = new URLSearchParams();
+            sp.set("page", String(page));
+            sp.set("pageSize", String(pageSize));
+            if (q.trim())
+                sp.set("q", q.trim());
+            if (status !== "all")
+                sp.set("status", status);
+            if (provider !== "all")
+                sp.set("provider", provider);
+            if (placement !== "all")
+                sp.set("placement", placement);
+            return apiClient.get(`${endpoint}?${sp.toString()}`);
+        },
+        staleTime: 10000,
+    });
+    const statusMutation = useMutation({
+        mutationFn: async ({ id, nextStatus }) => {
+            await apiClient.patch(ADMIN_ENDPOINTS.AD_BY_ID(id), { status: nextStatus });
+        },
+        onSuccess: async () => {
+            await queryClient.invalidateQueries({ queryKey: ["admin-ads"] });
+        },
+    });
+    React.useEffect(() => {
+        if (!adsQuery.data)
+            return;
+        setConsentRequired(Boolean(adsQuery.data.consentRequired));
+    }, [adsQuery.data]);
+    const settingsMutation = useMutation({
+        mutationFn: async (payload) => {
+            await apiClient.patch(endpoint, payload);
+        },
+        onSuccess: async () => {
+            setSettingsMessage("Ad settings saved.");
+            setAdsenseClientId("");
+            setThirdPartyScriptUrl("");
+            await queryClient.invalidateQueries({ queryKey: ["admin-ads"] });
+        },
+        onError: (error) => {
+            setSettingsMessage(error instanceof Error ? error.message : "Failed to save ad settings");
+        },
+    });
+    const rows = (adsQuery.data?.items ?? []);
+    const columns = React.useMemo(() => [
+        {
+            key: "name",
+            header: "Ad",
+            render: (row) => (_jsxs("div", { "data-section": "adminadsview-div-241", children: [_jsx(Text, { className: "font-medium", children: row.name }), _jsx(Text, { className: "text-xs text-neutral-500 dark:text-zinc-400", children: row.id })] })),
+        },
+        {
+            key: "provider",
+            header: "Provider",
+            render: (row) => _jsx(Text, { className: "text-xs uppercase tracking-wide", children: row.provider }),
+        },
+        {
+            key: "status",
+            header: "Status",
+            render: (row) => (_jsxs("div", { "data-section": "adminadsview-div-242", children: [_jsx(Text, { className: "text-xs uppercase tracking-wide", children: row.status }), row.publishReady === false ? (_jsx(Text, { className: "text-[11px] text-red-600 dark:text-red-300", children: "Publish blocked" })) : null] })),
+        },
+        {
+            key: "placementIds",
+            header: "Placements",
+            render: (row) => (_jsx(Text, { className: "text-xs text-neutral-500 dark:text-zinc-400", children: row.placementIds.join(", ") })),
+        },
+        {
+            key: "actions",
+            header: "Actions",
+            render: (row) => {
+                const nextStatus = row.status === "active" ? "paused" : "active";
+                const cannotPublish = nextStatus === "active" && row.publishReady === false;
+                return (_jsxs("div", { className: "flex items-center gap-2", "data-section": "adminadsview-div-243", children: [renderEditLink ? renderEditLink(row) : (_jsx("a", { className: "inline-flex h-8 items-center rounded-md border border-neutral-200 px-3 text-xs dark:border-slate-700", href: `/admin/ads/${row.id}/edit`, children: "Edit" })), _jsx(Button, { size: "sm", variant: "outline", disabled: statusMutation.isPending || cannotPublish, onClick: () => statusMutation.mutate({ id: row.id, nextStatus }), children: row.status === "active" ? "Pause" : "Publish" })] }));
+            },
+        },
+    ], [renderEditLink, statusMutation]);
+    const placements = adsQuery.data?.placements ?? [];
+    const credentialStatus = adsQuery.data?.providerCredentialStatus;
+    const serverCredentialIssues = credentialStatus?.issues ?? [];
+    const localCredentialIssues = React.useMemo(() => {
+        const issues = [];
+        if (adsenseClientId.trim() && !/^ca-pub-[0-9]{10,20}$/.test(adsenseClientId.trim())) {
+            issues.push("AdSense client id must match format ca-pub-XXXXXXXXXX");
+        }
+        if (thirdPartyScriptUrl.trim()) {
+            try {
+                const parsed = new URL(thirdPartyScriptUrl.trim());
+                if (parsed.protocol !== "https:") {
+                    issues.push("Third-party script URL must be https");
+                }
+            }
+            catch {
+                issues.push("Third-party script URL must be a valid URL");
+            }
+        }
+        return issues;
+    }, [adsenseClientId, thirdPartyScriptUrl]);
+    const hasPendingCredentialInput = adsenseClientId.trim().length > 0 || thirdPartyScriptUrl.trim().length > 0;
+    const saveSettings = () => {
+        setSettingsMessage(null);
+        const payload = {
+            consentRequired,
+            providerCredentials: {
+                adsenseClientId: adsenseClientId.trim() || undefined,
+                thirdPartyScriptUrl: thirdPartyScriptUrl.trim() || undefined,
+            },
+        };
+        settingsMutation.mutate(payload);
+    };
+    return (_jsx(StackedViewShell, { portal: "admin", ...rest, title: labels.title ?? "Ad Inventory", sections: [
+            _jsxs("div", { className: "flex items-center justify-between gap-3", "data-section": "adminadsview-div-244", children: [_jsx(Text, { variant: "secondary", children: "Manage ad inventory, placement mapping, and publishing state." }), _jsx("a", { href: createHref, className: "inline-flex h-9 items-center rounded-md bg-neutral-900 px-3 text-sm font-medium text-white dark:bg-zinc-100 dark:text-zinc-900", children: "New ad" })] }),
+            adsQuery.error ? (_jsx(Alert, { variant: "error", title: "Could not load ads", children: adsQuery.error instanceof Error ? adsQuery.error.message : "Unknown error" })) : null,
+            _jsxs("div", { className: "rounded-lg border border-neutral-200 dark:border-slate-700 p-3 space-y-3", "data-section": "adminadsview-div-245", children: [_jsx(Text, { className: "text-sm font-semibold", children: "Provider and publish settings" }), _jsx(Text, { className: "text-xs text-neutral-500 dark:text-zinc-400", children: "Save provider credentials here before publishing AdSense or third-party inventory." }), serverCredentialIssues.length > 0 ? (_jsx(Alert, { variant: "warning", title: "Provider credentials need attention", children: serverCredentialIssues.join("; ") })) : null, _jsxs("div", { className: "grid grid-cols-1 md:grid-cols-2 gap-3", "data-section": "adminadsview-div-246", children: [_jsx(Input, { label: "AdSense client id", value: adsenseClientId, onChange: (event) => setAdsenseClientId(event.target.value), placeholder: adsQuery.data?.providerCredentialsMasked?.adsenseClientId || "ca-pub-XXXXXXXXXX" }), _jsx(Input, { label: "Third-party script URL", value: thirdPartyScriptUrl, onChange: (event) => setThirdPartyScriptUrl(event.target.value), placeholder: adsQuery.data?.providerCredentialsMasked?.thirdPartyScriptUrl || "https://..." })] }), _jsxs(Text, { className: "text-xs text-neutral-500 dark:text-zinc-400", children: ["Stored credentials: AdSense ", credentialStatus?.hasAdsenseClientId ? "configured" : "missing", " \u00B7 Third-party ", credentialStatus?.hasThirdPartyScriptUrl ? "configured" : "missing"] }), _jsxs("div", { className: "flex items-center justify-between gap-3", "data-section": "adminadsview-div-247", children: [_jsxs("label", { className: "flex items-center gap-2 text-sm", children: [_jsx("input", { type: "checkbox", checked: consentRequired, onChange: (event) => setConsentRequired(event.target.checked) }), "Require consent globally for ad rendering"] }), _jsx(Button, { size: "sm", variant: "outline", disabled: settingsMutation.isPending || localCredentialIssues.length > 0 || (!hasPendingCredentialInput && consentRequired === Boolean(adsQuery.data?.consentRequired)), onClick: saveSettings, children: settingsMutation.isPending ? "Saving..." : "Save settings" })] }), localCredentialIssues.length > 0 ? (_jsx(Alert, { variant: "error", title: "Fix settings before saving", children: localCredentialIssues.join("; ") })) : null, settingsMessage ? (_jsx(Alert, { variant: settingsMessage.toLowerCase().includes("failed") ? "error" : "success", title: "Settings", children: settingsMessage })) : null] }),
+            _jsxs("div", { className: "grid grid-cols-1 md:grid-cols-4 gap-3", "data-section": "adminadsview-div-248", children: [_jsx(Input, { label: "Search", value: q, onChange: (event) => {
+                            setPage(1);
+                            setQ(event.target.value);
+                        }, placeholder: "Search ads" }), _jsx(Select, { label: "Status", value: status, options: [
+                            { label: "All", value: "all" },
+                            { label: "Draft", value: "draft" },
+                            { label: "Active", value: "active" },
+                            { label: "Scheduled", value: "scheduled" },
+                            { label: "Paused", value: "paused" },
+                        ], onChange: (event) => {
+                            setPage(1);
+                            setStatus(event.target.value);
+                        } }), _jsx(Select, { label: "Provider", value: provider, options: [
+                            { label: "All", value: "all" },
+                            { label: "Manual", value: "manual" },
+                            { label: "AdSense", value: "adsense" },
+                            { label: "Third Party", value: "thirdParty" },
+                        ], onChange: (event) => {
+                            setPage(1);
+                            setProvider(event.target.value);
+                        } }), _jsx(Select, { label: "Placement", value: placement, options: [
+                            { label: "All", value: "all" },
+                            ...placements.map((item) => ({ label: item.label, value: item.id })),
+                        ], onChange: (event) => {
+                            setPage(1);
+                            setPlacement(event.target.value);
+                        } })] }),
+            _jsx(DataTable, { columns: columns, rows: rows, isLoading: adsQuery.isLoading, currentPage: adsQuery.data?.page ?? page, totalPages: adsQuery.data?.totalPages ?? 1, onPageChange: setPage, emptyLabel: "No ads found" }),
+        ] }));
+}

package/dist/features/admin/components/AdminAnalyticsView.d.ts

@@ -23,7 +23,8 @@ export interface AdminAnalyticsViewProps {
     renderSummaryCards?: () => React.ReactNode;
     renderCharts?: () => React.ReactNode;
     renderTable?: () => React.ReactNode;
+    endpoint?: string;
     isLoading?: boolean;
     className?: string;
 }
-export declare function AdminAnalyticsView({ data, labels, formatRevenue, renderProductLink, renderHeader, renderDateRange, renderSummaryCards, renderCharts, renderTable, isLoading, className, }: AdminAnalyticsViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function AdminAnalyticsView({ data, labels, formatRevenue, renderProductLink, renderHeader, renderDateRange, renderSummaryCards, renderCharts, renderTable, endpoint, isLoading, className, }: AdminAnalyticsViewProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/admin/components/AdminAnalyticsView.js

@@ -1,13 +1,27 @@
+"use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useQuery } from "@tanstack/react-query";
 import { Div, Heading } from "../../../ui";
+import { Alert } from "../../../ui";
+import { apiClient } from "../../../http";
+import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
 import { AdminStatCard } from "./analytics/AdminStatCard";
 import { AdminRevenueChart, AdminOrdersChart, } from "./analytics/AdminAnalyticsCharts";
 import { AdminTopProductsTable } from "./analytics/AdminTopProductsTable";
-export function AdminAnalyticsView({ data, labels = {}, formatRevenue = (n) => String(n), renderProductLink, renderHeader, renderDateRange, renderSummaryCards, renderCharts, renderTable, isLoading = false, className = "", }) {
-    const summary = data?.summary;
-    const ordersByMonth = data?.ordersByMonth ?? [];
-    const topProducts = data?.topProducts ?? [];
-    return (_jsxs(Div, { className: className, children: [renderHeader ? (renderHeader()) : labels.title ? (_jsx(Heading, { level: 1, className: "text-2xl font-bold mb-6", children: labels.title })) : null, renderDateRange?.(), renderSummaryCards ? (renderSummaryCards()) : summary ? (_jsxs(Div, { className: "grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-4", children: [_jsx(AdminStatCard, { label: labels.totalRevenue ?? "Total Revenue", value: formatRevenue(summary.totalRevenue) }), _jsx(AdminStatCard, { label: labels.totalOrders ?? "Total Orders", value: String(summary.totalOrders) }), _jsx(AdminStatCard, { label: labels.revenueThisMonth ?? "Revenue This Month", value: formatRevenue(summary.revenueThisMonth) }), _jsx(AdminStatCard, { label: labels.ordersThisMonth ?? "Orders This Month", value: String(summary.newOrdersThisMonth) })] })) : null, renderCharts ? (renderCharts()) : ordersByMonth.length > 0 ? (_jsxs(Div, { className: "space-y-6", children: [_jsx(AdminRevenueChart, { data: ordersByMonth, labels: { title: labels.revenueByMonth } }), _jsx(AdminOrdersChart, { data: ordersByMonth, labels: { title: labels.ordersByMonth } })] })) : null, renderTable ? (renderTable()) : topProducts.length > 0 ? (_jsx(AdminTopProductsTable, { products: topProducts, labels: {
+export function AdminAnalyticsView({ data, labels = {}, formatRevenue = (n) => String(n), renderProductLink, renderHeader, renderDateRange, renderSummaryCards, renderCharts, renderTable, endpoint = ADMIN_ENDPOINTS.ANALYTICS, isLoading = false, className = "", }) {
+    const shouldFetch = !data;
+    const query = useQuery({
+        queryKey: ["admin-analytics", endpoint],
+        queryFn: () => apiClient.get(endpoint),
+        enabled: shouldFetch,
+        staleTime: 60000,
+    });
+    const resolvedData = data ?? query.data;
+    const busy = isLoading || query.isLoading;
+    const summary = resolvedData?.summary;
+    const ordersByMonth = resolvedData?.ordersByMonth ?? [];
+    const topProducts = resolvedData?.topProducts ?? [];
+    return (_jsxs(Div, { className: className, children: [renderHeader ? (renderHeader()) : labels.title ? (_jsx(Heading, { level: 1, className: "text-2xl font-bold mb-6", children: labels.title })) : null, query.error ? (_jsx(Alert, { variant: "error", title: "Could not load analytics", children: query.error instanceof Error ? query.error.message : "Unknown error" })) : null, renderDateRange?.(), renderSummaryCards ? (renderSummaryCards()) : busy ? (_jsx(Div, { className: "grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-4", children: Array.from({ length: 4 }).map((_, index) => (_jsx(Div, { className: "h-28 rounded-xl border border-neutral-200 dark:border-neutral-800 bg-white dark:bg-neutral-900 animate-pulse" }, index))) })) : summary ? (_jsxs(Div, { className: "grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-4", children: [_jsx(AdminStatCard, { label: labels.totalRevenue ?? "Total Revenue", value: formatRevenue(summary.totalRevenue) }), _jsx(AdminStatCard, { label: labels.totalOrders ?? "Total Orders", value: String(summary.totalOrders) }), _jsx(AdminStatCard, { label: labels.revenueThisMonth ?? "Revenue This Month", value: formatRevenue(summary.revenueThisMonth) }), _jsx(AdminStatCard, { label: labels.ordersThisMonth ?? "Orders This Month", value: String(summary.newOrdersThisMonth) })] })) : null, renderCharts ? (renderCharts()) : ordersByMonth.length > 0 ? (_jsxs(Div, { className: "space-y-6", children: [_jsx(AdminRevenueChart, { data: ordersByMonth, labels: { title: labels.revenueByMonth } }), _jsx(AdminOrdersChart, { data: ordersByMonth, labels: { title: labels.ordersByMonth } })] })) : null, renderTable ? (renderTable()) : topProducts.length > 0 ? (_jsx(AdminTopProductsTable, { products: topProducts, labels: {
                     title: labels.topProducts,
                     orders: labels.orders,
                     view: labels.view,

package/dist/features/admin/components/AdminBidsView.d.ts

@@ -1,4 +1,4 @@
 import type { ListingViewShellProps } from "../../../ui";
 export interface AdminBidsViewProps extends ListingViewShellProps {
 }
-export declare function AdminBidsView(props: AdminBidsViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function AdminBidsView({ children, ...props }: AdminBidsViewProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/admin/components/AdminBidsView.js

@@ -1,5 +1,29 @@
+"use client";
 import { jsx as _jsx } from "react/jsx-runtime";
+import React from "react";
 import { ListingViewShell } from "../../../ui";
-export function AdminBidsView(props) {
-    return _jsx(ListingViewShell, { portal: "admin", ...props });
+import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
+import { toRecordArray, toRelativeDate, toRupees, toStringValue, useAdminListingData, } from "../hooks/useAdminListingData";
+import { AdminListingScaffold } from "./AdminListingScaffold";
+export function AdminBidsView({ children, ...props }) {
+    const hasChildren = React.Children.count(children) > 0;
+    const { rows, total, isLoading, errorMessage } = useAdminListingData({
+        queryKey: ["admin", "bids", "listing"],
+        endpoint: ADMIN_ENDPOINTS.BIDS,
+        mapRows: (response) => toRecordArray(response.items).map((item, index) => ({
+            id: toStringValue(item.id, `bid-${index}`),
+            primary: [
+                toStringValue(item.productName ?? item.productTitle, "Unknown item"),
+                toRupees(item.amount),
+            ].join(" · "),
+            secondary: toStringValue(item.bidderId ?? item.userId, "Unknown bidder"),
+            status: toStringValue(item.status, "Active"),
+            updatedAt: toRelativeDate(item.bidDate ?? item.updatedAt ?? item.createdAt),
+        })),
+        getTotal: (response, mappedRows) => typeof response.total === "number" ? response.total : mappedRows.length,
+    });
+    if (hasChildren) {
+        return _jsx(ListingViewShell, { portal: "admin", ...props, children: children });
+    }
+    return (_jsx(AdminListingScaffold, { portal: "admin", ...props, title: "Bid Oversight", subtitle: "Review high-value bidding activity, outbid events, and auction integrity from one queue.", actionLabel: "Export bids", searchPlaceholder: "Search bids, products, or bidder IDs", rows: rows, isLoading: isLoading, errorMessage: errorMessage, emptyLabel: "No bids found", resultSummary: `Showing ${rows.length} of ${total} bids` }));
 }

package/dist/features/admin/components/AdminBlogView.d.ts

@@ -1,4 +1,4 @@
 import type { ListingViewShellProps } from "../../../ui";
 export interface AdminBlogViewProps extends ListingViewShellProps {
 }
-export declare function AdminBlogView(props: AdminBlogViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function AdminBlogView({ children, ...props }: AdminBlogViewProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/admin/components/AdminBlogView.js

@@ -1,5 +1,37 @@
+"use client";
 import { jsx as _jsx } from "react/jsx-runtime";
+import React from "react";
 import { ListingViewShell } from "../../../ui";
-export function AdminBlogView(props) {
-    return _jsx(ListingViewShell, { portal: "admin", ...props });
+import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
+import { toRecordArray, toRelativeDate, toStringValue, useAdminListingData, } from "../hooks/useAdminListingData";
+import { AdminListingScaffold } from "./AdminListingScaffold";
+export function AdminBlogView({ children, ...props }) {
+    const hasChildren = React.Children.count(children) > 0;
+    const { rows, total, isLoading, errorMessage } = useAdminListingData({
+        queryKey: ["admin", "blog", "listing"],
+        endpoint: ADMIN_ENDPOINTS.BLOG,
+        mapRows: (response) => toRecordArray(response.posts).map((item, index) => ({
+            id: toStringValue(item.id, `post-${index}`),
+            primary: toStringValue(item.title, "Untitled post"),
+            secondary: [
+                toStringValue(item.authorName, "Unknown author"),
+                toStringValue(item.category, "Uncategorized"),
+            ].join(" · "),
+            status: toStringValue(item.status, "Draft"),
+            updatedAt: toRelativeDate(item.updatedAt ?? item.createdAt),
+        })),
+        getTotal: (response, mappedRows) => {
+            if (typeof response.meta?.filteredTotal === "number") {
+                return response.meta.filteredTotal;
+            }
+            if (typeof response.meta?.total === "number") {
+                return response.meta.total;
+            }
+            return mappedRows.length;
+        },
+    });
+    if (hasChildren) {
+        return _jsx(ListingViewShell, { portal: "admin", ...props, children: children });
+    }
+    return (_jsx(AdminListingScaffold, { portal: "admin", ...props, title: "Blog Publishing", subtitle: "Manage editorial drafts, featured placement, and publish readiness in the shared listing frame.", actionLabel: "New article", searchPlaceholder: "Search articles, authors, or tags", rows: rows, isLoading: isLoading, errorMessage: errorMessage, emptyLabel: "No blog posts found", resultSummary: `Showing ${rows.length} of ${total} posts` }));
 }

package/dist/features/admin/components/AdminCarouselView.d.ts

@@ -1,9 +1,4 @@
-import React from "react";
-import type { SlottedListingViewProps } from "../../../ui";
-export interface AdminCarouselViewProps extends SlottedListingViewProps {
-    /** @deprecated Use `overlays` instead. */
-    renderDrawer?: () => React.ReactNode;
-    /** @deprecated Use `overlays` instead. */
-    renderModal?: () => React.ReactNode;
+import type { ListingViewShellProps } from "../../../ui";
+export interface AdminCarouselViewProps extends ListingViewShellProps {
 }
-export declare function AdminCarouselView({ renderDrawer, renderModal, overlays, ...props }: AdminCarouselViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function AdminCarouselView({ children, ...props }: AdminCarouselViewProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/admin/components/AdminCarouselView.js

@@ -1,5 +1,40 @@
-import { Fragment as _Fragment, jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
-import { SlottedListingView } from "../../../ui";
-export function AdminCarouselView({ renderDrawer, renderModal, overlays, ...props }) {
-    return (_jsx(SlottedListingView, { portal: "admin", ...props, overlays: _jsxs(_Fragment, { children: [overlays, renderDrawer?.(), renderModal?.()] }) }));
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from "react";
+import { ListingViewShell } from "../../../ui";
+import { HOMEPAGE_ENDPOINTS } from "../../../constants/api-endpoints";
+import { toRecordArray, toRelativeDate, toStringValue, useAdminListingData, } from "../hooks/useAdminListingData";
+import { AdminListingScaffold } from "./AdminListingScaffold";
+export function AdminCarouselView({ children, ...props }) {
+    const hasChildren = React.Children.count(children) > 0;
+    const { rows, total, isLoading, errorMessage } = useAdminListingData({
+        queryKey: ["admin", "carousel", "listing"],
+        endpoint: `${HOMEPAGE_ENDPOINTS.CAROUSEL}?includeInactive=true`,
+        mapRows: (response) => {
+            const sourceItems = Array.isArray(response.data)
+                ? response.data
+                : response.items;
+            return toRecordArray(sourceItems).map((item, index) => {
+                const orderValue = typeof item.order === "number" ? String(item.order) : "-";
+                const mediaType = toStringValue(item.media?.type, "image");
+                const linkUrl = toStringValue(item.link?.url, "no-link");
+                return {
+                    id: toStringValue(item.id, `slide-${index}`),
+                    primary: toStringValue(item.title, `Carousel slide ${index + 1}`),
+                    secondary: `Order: ${orderValue} · Media: ${mediaType} · Link: ${linkUrl}`,
+                    status: typeof item.active === "boolean"
+                        ? item.active
+                            ? "Active"
+                            : "Inactive"
+                        : toStringValue(item.status, "Inactive"),
+                    updatedAt: toRelativeDate(item.updatedAt ?? item.createdAt),
+                };
+            });
+        },
+        getTotal: (response, mappedRows) => typeof response.total === "number" ? response.total : mappedRows.length,
+    });
+    if (hasChildren) {
+        return _jsx(ListingViewShell, { portal: "admin", ...props, children: children });
+    }
+    return (_jsx(AdminListingScaffold, { portal: "admin", ...props, title: "Homepage Carousel", subtitle: "Manage hero slide ordering, activation state, and destination links in one listing workflow.", actionLabel: "New slide", searchPlaceholder: "Search slide titles or link URLs", rows: rows, isLoading: isLoading, errorMessage: errorMessage, emptyLabel: "No carousel slides found", resultSummary: `Showing ${rows.length} of ${total} slides` }));
 }

package/dist/features/admin/components/AdminCategoriesView.d.ts

@@ -1,9 +1,4 @@
-import React from "react";
-import type { SlottedListingViewProps } from "../../../ui";
-export interface AdminCategoriesViewProps extends SlottedListingViewProps {
-    /** @deprecated Use `overlays` instead. */
-    renderDrawer?: () => React.ReactNode;
-    /** @deprecated Use `overlays` instead. */
-    renderModal?: () => React.ReactNode;
+import type { ListingViewShellProps } from "../../../ui";
+export interface AdminCategoriesViewProps extends ListingViewShellProps {
 }
-export declare function AdminCategoriesView({ renderDrawer, renderModal, overlays, ...props }: AdminCategoriesViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function AdminCategoriesView({ children, ...props }: AdminCategoriesViewProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/admin/components/AdminCategoriesView.js

@@ -1,5 +1,41 @@
-import { Fragment as _Fragment, jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
-import { SlottedListingView } from "../../../ui";
-export function AdminCategoriesView({ renderDrawer, renderModal, overlays, ...props }) {
-    return (_jsx(SlottedListingView, { portal: "admin", ...props, overlays: _jsxs(_Fragment, { children: [overlays, renderDrawer?.(), renderModal?.()] }) }));
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from "react";
+import { ListingViewShell } from "../../../ui";
+import { CATEGORY_ENDPOINTS } from "../../../constants/api-endpoints";
+import { toRecordArray, toRelativeDate, toStringValue, useAdminListingData, } from "../hooks/useAdminListingData";
+import { AdminListingScaffold } from "./AdminListingScaffold";
+export function AdminCategoriesView({ children, ...props }) {
+    const hasChildren = React.Children.count(children) > 0;
+    const { rows, total, isLoading, errorMessage } = useAdminListingData({
+        queryKey: ["admin", "categories", "listing"],
+        endpoint: `${CATEGORY_ENDPOINTS.LIST}?flat=true`,
+        mapRows: (response) => {
+            const sourceItems = Array.isArray(response.data)
+                ? response.data
+                : response.items;
+            return toRecordArray(sourceItems).map((item, index) => {
+                const tierValue = typeof item.tier === "number" ? String(item.tier) : "-";
+                const slugValue = toStringValue(item.slug, "no-slug");
+                const parentValue = toStringValue(item.parentId, "root");
+                const orderValue = typeof item.order === "number" ? String(item.order) : "-";
+                return {
+                    id: toStringValue(item.id, `category-${index}`),
+                    primary: toStringValue(item.name, "Untitled category"),
+                    secondary: `Slug: ${slugValue} · Tier: ${tierValue} · Parent: ${parentValue} · Order: ${orderValue}`,
+                    status: typeof item.isActive === "boolean"
+                        ? item.isActive
+                            ? "Active"
+                            : "Inactive"
+                        : toStringValue(item.status, "Active"),
+                    updatedAt: toRelativeDate(item.updatedAt ?? item.createdAt),
+                };
+            });
+        },
+        getTotal: (response, mappedRows) => typeof response.total === "number" ? response.total : mappedRows.length,
+    });
+    if (hasChildren) {
+        return _jsx(ListingViewShell, { portal: "admin", ...props, children: children });
+    }
+    return (_jsx(AdminListingScaffold, { portal: "admin", ...props, title: "Category Management", subtitle: "Organize taxonomy hierarchy, slug readiness, and active visibility from the shared listing scaffold.", actionLabel: "New category", searchPlaceholder: "Search categories, slugs, or parent category", rows: rows, isLoading: isLoading, errorMessage: errorMessage, emptyLabel: "No categories found", resultSummary: `Showing ${rows.length} of ${total} categories` }));
 }

package/dist/features/admin/components/AdminCouponsView.d.ts

@@ -1,4 +1,4 @@
 import type { ListingViewShellProps } from "../../../ui";
 export interface AdminCouponsViewProps extends ListingViewShellProps {
 }
-export declare function AdminCouponsView(props: AdminCouponsViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function AdminCouponsView({ children, ...props }: AdminCouponsViewProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/admin/components/AdminCouponsView.js

@@ -1,5 +1,31 @@
+"use client";
 import { jsx as _jsx } from "react/jsx-runtime";
+import React from "react";
 import { ListingViewShell } from "../../../ui";
-export function AdminCouponsView(props) {
-    return _jsx(ListingViewShell, { portal: "admin", ...props });
+import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
+import { toRecordArray, toRelativeDate, toStringValue, useAdminListingData, } from "../hooks/useAdminListingData";
+import { AdminListingScaffold } from "./AdminListingScaffold";
+export function AdminCouponsView({ children, ...props }) {
+    const hasChildren = React.Children.count(children) > 0;
+    const { rows, total, isLoading, errorMessage } = useAdminListingData({
+        queryKey: ["admin", "coupons", "listing"],
+        endpoint: ADMIN_ENDPOINTS.COUPONS,
+        mapRows: (response) => toRecordArray(response.items).map((item, index) => ({
+            id: toStringValue(item.id, `coupon-${index}`),
+            primary: toStringValue(item.code, "Unknown code"),
+            secondary: [
+                toStringValue(item.name, "Untitled campaign"),
+                toStringValue(item.type, "Unknown type"),
+            ].join(" · "),
+            status: toStringValue((item.validity?.isActive
+                ? "Active"
+                : item.status), "Inactive"),
+            updatedAt: toRelativeDate(item.updatedAt ?? item.createdAt),
+        })),
+        getTotal: (response, mappedRows) => typeof response.total === "number" ? response.total : mappedRows.length,
+    });
+    if (hasChildren) {
+        return _jsx(ListingViewShell, { portal: "admin", ...props, children: children });
+    }
+    return (_jsx(AdminListingScaffold, { portal: "admin", ...props, title: "Coupons & Promotions", subtitle: "Monitor campaign status, stacking rules, and expiry windows from a single control table.", actionLabel: "Create coupon", searchPlaceholder: "Search codes, campaigns, or seller scopes", rows: rows, isLoading: isLoading, errorMessage: errorMessage, emptyLabel: "No coupons found", resultSummary: `Showing ${rows.length} of ${total} coupons` }));
 }

package/dist/features/admin/components/AdminDashboardView.d.ts

@@ -5,6 +5,7 @@ export interface AdminDashboardViewProps extends Omit<StackedViewShellProps, "se
     labels?: {
         title?: string;
     };
+    endpoint?: string;
     stats?: DashboardStats;
     isLoading?: boolean;
     renderStats?: (stats: DashboardStats, isLoading: boolean) => React.ReactNode;
@@ -13,4 +14,4 @@ export interface AdminDashboardViewProps extends Omit<StackedViewShellProps, "se
     renderAlerts?: () => React.ReactNode;
     renderCharts?: () => React.ReactNode;
 }
-export declare function AdminDashboardView({ labels, stats, isLoading, renderStats, renderQuickActions, renderRecentActivity, renderAlerts, renderCharts, ...rest }: AdminDashboardViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function AdminDashboardView({ labels, endpoint, stats, isLoading, renderStats, renderQuickActions, renderRecentActivity, renderAlerts, renderCharts, ...rest }: AdminDashboardViewProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/admin/components/AdminDashboardView.js

@@ -1,9 +1,34 @@
+"use client";
 import { jsx as _jsx } from "react/jsx-runtime";
+import { useQuery } from "@tanstack/react-query";
 import { StackedViewShell } from "../../../ui";
-export function AdminDashboardView({ labels = {}, stats = {}, isLoading = false, renderStats, renderQuickActions, renderRecentActivity, renderAlerts, renderCharts, ...rest }) {
-    return (_jsx(StackedViewShell, { portal: "admin", ...rest, title: labels.title, sections: [
+import { Alert } from "../../../ui";
+import { apiClient } from "../../../http";
+import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
+import { DashboardStatsGrid } from "./DashboardStats";
+export function AdminDashboardView({ labels = {}, endpoint = ADMIN_ENDPOINTS.DASHBOARD, stats = {}, isLoading = false, renderStats, renderQuickActions, renderRecentActivity, renderAlerts, renderCharts, ...rest }) {
+    const shouldFetch = Object.keys(stats).length === 0;
+    const query = useQuery({
+        queryKey: ["admin-dashboard", endpoint],
+        queryFn: () => apiClient.get(endpoint),
+        enabled: shouldFetch,
+        staleTime: 60000,
+    });
+    const resolvedStats = shouldFetch
+        ? {
+            totalOrders: query.data?.orders?.total ?? 0,
+            totalUsers: query.data?.users?.total ?? 0,
+            totalProducts: query.data?.products?.total ?? 0,
+            newUsersToday: query.data?.users?.newThisMonth ?? 0,
+        }
+        : stats;
+    const busy = isLoading || query.isLoading;
+    return (_jsx(StackedViewShell, { portal: "admin", ...rest, title: labels.title ?? "Dashboard", sections: [
+            query.error ? (_jsx(Alert, { variant: "error", title: "Could not load dashboard", children: query.error instanceof Error ? query.error.message : "Unknown error" })) : null,
             renderAlerts?.(),
-            renderStats ? renderStats(stats, isLoading) : null,
+            renderStats
+                ? renderStats(resolvedStats, busy)
+                : _jsx(DashboardStatsGrid, { stats: resolvedStats, isLoading: busy }),
             renderQuickActions?.(),
             renderCharts?.(),
             renderRecentActivity?.(),

package/dist/features/admin/components/AdminFaqsView.d.ts

@@ -1,4 +1,4 @@
 import type { ListingViewShellProps } from "../../../ui";
 export interface AdminFaqsViewProps extends ListingViewShellProps {
 }
-export declare function AdminFaqsView(props: AdminFaqsViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function AdminFaqsView({ children, ...props }: AdminFaqsViewProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/admin/components/AdminFaqsView.js

@@ -1,5 +1,26 @@
+"use client";
 import { jsx as _jsx } from "react/jsx-runtime";
+import React from "react";
 import { ListingViewShell } from "../../../ui";
-export function AdminFaqsView(props) {
-    return _jsx(ListingViewShell, { portal: "admin", ...props });
+import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
+import { toRecordArray, toRelativeDate, toStringValue, useAdminListingData, } from "../hooks/useAdminListingData";
+import { AdminListingScaffold } from "./AdminListingScaffold";
+export function AdminFaqsView({ children, ...props }) {
+    const hasChildren = React.Children.count(children) > 0;
+    const { rows, total, isLoading, errorMessage } = useAdminListingData({
+        queryKey: ["admin", "faqs", "listing"],
+        endpoint: ADMIN_ENDPOINTS.FAQS,
+        mapRows: (response) => toRecordArray(response.items).map((item, index) => ({
+            id: toStringValue(item.id, `faq-${index}`),
+            primary: toStringValue(item.question, "Untitled question"),
+            secondary: toStringValue(item.category, "Uncategorized"),
+            status: toStringValue(typeof item.isActive === "boolean" ? (item.isActive ? "Published" : "Draft") : item.status, "Draft"),
+            updatedAt: toRelativeDate(item.updatedAt ?? item.createdAt),
+        })),
+        getTotal: (response, mappedRows) => typeof response.total === "number" ? response.total : mappedRows.length,
+    });
+    if (hasChildren) {
+        return _jsx(ListingViewShell, { portal: "admin", ...props, children: children });
+    }
+    return (_jsx(AdminListingScaffold, { portal: "admin", ...props, title: "FAQ Library", subtitle: "Keep support answers organized by category, visibility, and homepage priority.", actionLabel: "New FAQ", searchPlaceholder: "Search questions, categories, or tokens", rows: rows, isLoading: isLoading, errorMessage: errorMessage, emptyLabel: "No FAQs found", resultSummary: `Showing ${rows.length} of ${total} FAQs` }));
 }

package/dist/features/admin/components/AdminFeatureFlagsView.js

@@ -1,5 +1,50 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { StackedViewShell } from "../../../ui";
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from "react";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { Alert, Button, Form, FormActions, StackedViewShell, Toggle, } from "../../../ui";
+import { useSiteSettings } from "../../../core/hooks/useSiteSettings";
+import { SITE_SETTINGS_ENDPOINTS } from "../../../constants/api-endpoints";
+import { apiClient } from "../../../http";
 export function AdminFeatureFlagsView({ labels = {}, renderFlags, ...rest }) {
-    return (_jsx(StackedViewShell, { portal: "admin", ...rest, title: labels.title, sections: [renderFlags?.()] }));
+    const queryClient = useQueryClient();
+    const { data, isLoading, error } = useSiteSettings();
+    const [flags, setFlags] = React.useState({});
+    const [saveMessage, setSaveMessage] = React.useState(null);
+    React.useEffect(() => {
+        if (!data?.featureFlags)
+            return;
+        setFlags(data.featureFlags);
+    }, [data]);
+    const saveFlags = useMutation({
+        mutationFn: async () => {
+            await apiClient.patch(SITE_SETTINGS_ENDPOINTS.GET, {
+                featureFlags: flags,
+            });
+        },
+        onSuccess: async () => {
+            await queryClient.invalidateQueries({ queryKey: ["site-settings"] });
+            setSaveMessage("Feature flags saved.");
+        },
+        onError: () => {
+            setSaveMessage("Failed to save feature flags.");
+        },
+    });
+    const featureKeys = React.useMemo(() => Object.keys(flags), [flags]);
+    const formatLabel = (value) => value
+        .replace(/([A-Z])/g, " $1")
+        .replace(/^./, (char) => char.toUpperCase());
+    const defaultFlags = () => (_jsxs(Form, { onSubmit: (event) => {
+            event.preventDefault();
+            saveFlags.mutate();
+        }, className: "space-y-4", children: [featureKeys.map((key) => (_jsx(Toggle, { checked: Boolean(flags[key]), onChange: (value) => {
+                    setFlags((prev) => ({ ...prev, [key]: value }));
+                    setSaveMessage(null);
+                }, label: formatLabel(key) }, key))), _jsxs(FormActions, { align: "right", children: [_jsx(Button, { type: "button", variant: "secondary", onClick: () => {
+                            setFlags(data?.featureFlags ?? {});
+                            setSaveMessage(null);
+                        }, disabled: saveFlags.isPending, children: "Reset" }), _jsx(Button, { type: "submit", disabled: saveFlags.isPending || featureKeys.length === 0, children: saveFlags.isPending ? "Saving..." : "Save feature flags" })] }), saveMessage ? (_jsx(Alert, { variant: saveMessage.startsWith("Failed") ? "error" : "success", title: saveMessage.startsWith("Failed") ? "Save failed" : "Saved", children: saveMessage })) : null] }));
+    const loadingAlert = isLoading ? (_jsx(Alert, { variant: "info", title: "Loading settings", children: "Fetching feature flags..." })) : null;
+    const errorAlert = error ? (_jsx(Alert, { variant: "error", title: "Could not load settings", children: error instanceof Error ? error.message : "Unknown error" })) : null;
+    return (_jsx(StackedViewShell, { portal: "admin", ...rest, title: labels.title ?? "Feature Flags", sections: [loadingAlert, errorAlert, renderFlags?.() ?? defaultFlags()] }));
 }