@mohasinac/appkit 2.3.1 → 2.3.2

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

@@ -7,9 +7,21 @@ import { toRecordArray, toRelativeDate, toStringValue, useAdminListingData, } fr
 import { AdminListingScaffold } from "./AdminListingScaffold";
 export function AdminCategoriesView({ children, ...props }) {
     const hasChildren = React.Children.count(children) > 0;
+    const [q, setQ] = React.useState("");
+    const [activeFilter, setActiveFilter] = React.useState("");
+    const [featuredFilter, setFeaturedFilter] = React.useState("");
+    const filterParts = [];
+    if (activeFilter && activeFilter !== "All") {
+        filterParts.push(activeFilter === "Active" ? "isActive==true" : "isActive==false");
+    }
+    if (featuredFilter && featuredFilter !== "All")
+        filterParts.push("isFeatured==true");
+    const filters = filterParts.join(",") || undefined;
     const { rows, total, isLoading, errorMessage } = useAdminListingData({
-        queryKey: ["admin", "categories", "listing"],
+        queryKey: ["admin", "categories", "listing", q, filters ?? ""],
         endpoint: `${CATEGORY_ENDPOINTS.LIST}?flat=true`,
+        filters,
+        q,
         mapRows: (response) => {
             const sourceItems = Array.isArray(response.data)
                 ? response.data
@@ -37,5 +49,18 @@ export function AdminCategoriesView({ children, ...props }) {
     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` }));
+    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", onSearch: setQ, searchValue: q, rows: rows, isLoading: isLoading, errorMessage: errorMessage, emptyLabel: "No categories found", resultSummary: `Showing ${rows.length} of ${total} categories`, filterGroups: [
+            {
+                title: "Active",
+                options: ["All", "Active", "Inactive"],
+                active: activeFilter || "All",
+                onSelect: (opt) => setActiveFilter(opt === "All" ? "" : opt),
+            },
+            {
+                title: "Featured",
+                options: ["All", "Featured Only"],
+                active: featuredFilter || "All",
+                onSelect: (opt) => setFeaturedFilter(opt === "All" ? "" : opt),
+            },
+        ] }));
 }

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

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

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

@@ -0,0 +1,50 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from "react";
+import { ListingViewShell } from "../../../ui";
+import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
+import { toRecordArray, toRelativeDate, toStringValue, useAdminListingData, } from "../hooks/useAdminListingData";
+import { AdminListingScaffold } from "./AdminListingScaffold";
+export function AdminContactView({ children, ...props }) {
+    const hasChildren = React.Children.count(children) > 0;
+    const [q, setQ] = React.useState("");
+    const [statusFilter, setStatusFilter] = React.useState("");
+    const filterParts = [];
+    if (statusFilter && statusFilter !== "All")
+        filterParts.push(`status==${statusFilter}`);
+    const filters = filterParts.join(",") || undefined;
+    const { rows, total, isLoading, errorMessage } = useAdminListingData({
+        queryKey: ["admin", "contact", "listing", q, filters ?? ""],
+        endpoint: ADMIN_ENDPOINTS.CONTACT_SUBMISSIONS,
+        filters,
+        q,
+        mapRows: (response) => toRecordArray(response.submissions).map((item, index) => ({
+            id: toStringValue(item.id, `msg-${index}`),
+            primary: toStringValue(item.subject, "No subject"),
+            secondary: [
+                toStringValue(item.name, "Unknown"),
+                toStringValue(item.email, ""),
+            ].filter(Boolean).join(" · ") || "—",
+            status: toStringValue(item.status, "new"),
+            updatedAt: toRelativeDate(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: "Contact Submissions", subtitle: "Review inbound contact form messages from users and visitors. Filter by status and search by subject or sender.", searchPlaceholder: "Search by subject, name, or email", onSearch: setQ, searchValue: q, rows: rows, isLoading: isLoading, errorMessage: errorMessage, emptyLabel: "No contact submissions found", resultSummary: `Showing ${rows.length} of ${total} submissions`, filterGroups: [
+            {
+                title: "Status",
+                options: ["All", "new", "read", "resolved"],
+                active: statusFilter || "All",
+                onSelect: (opt) => setStatusFilter(opt === "All" ? "" : opt),
+            },
+        ] }));
+}

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

@@ -7,9 +7,19 @@ import { toRecordArray, toRelativeDate, toStringValue, useAdminListingData, } fr
 import { AdminListingScaffold } from "./AdminListingScaffold";
 export function AdminFaqsView({ children, ...props }) {
     const hasChildren = React.Children.count(children) > 0;
+    const [q, setQ] = React.useState("");
+    const [activeFilter, setActiveFilter] = React.useState("");
+    const filterParts = [];
+    if (activeFilter === "Active")
+        filterParts.push("isActive==true");
+    else if (activeFilter === "Inactive")
+        filterParts.push("isActive==false");
+    const filters = filterParts.join(",") || undefined;
     const { rows, total, isLoading, errorMessage } = useAdminListingData({
-        queryKey: ["admin", "faqs", "listing"],
+        queryKey: ["admin", "faqs", "listing", q, filters ?? ""],
         endpoint: ADMIN_ENDPOINTS.FAQS,
+        filters,
+        q,
         mapRows: (response) => toRecordArray(response.items).map((item, index) => ({
             id: toStringValue(item.id, `faq-${index}`),
             primary: toStringValue(item.question, "Untitled question"),
@@ -22,5 +32,12 @@ export function AdminFaqsView({ children, ...props }) {
     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` }));
+    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", onSearch: setQ, searchValue: q, rows: rows, isLoading: isLoading, errorMessage: errorMessage, emptyLabel: "No FAQs found", resultSummary: `Showing ${rows.length} of ${total} FAQs`, filterGroups: [
+            {
+                title: "Status",
+                options: ["All", "Active", "Inactive"],
+                active: activeFilter || "All",
+                onSelect: (opt) => setActiveFilter(opt === "All" ? "" : opt),
+            },
+        ] }));
 }

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

@@ -1,4 +1,5 @@
 import { type ListingViewShellProps } from "../../../ui";
+import type { AdminTableColumn } from "../types";
 export interface AdminListingScaffoldRow {
     id: string;
     primary: string;
@@ -9,7 +10,10 @@ export interface AdminListingScaffoldRow {
 interface AdminListingScaffoldProps extends ListingViewShellProps {
     title: string;
     subtitle: string;
-    actionLabel: string;
+    actionLabel?: string;
+    actionHref?: string;
+    columns?: AdminTableColumn<AdminListingScaffoldRow>[];
+    getRowHref?: (row: AdminListingScaffoldRow) => string;
     searchPlaceholder: string;
     rows: AdminListingScaffoldRow[];
     isLoading?: boolean;
@@ -18,9 +22,14 @@ interface AdminListingScaffoldProps extends ListingViewShellProps {
     filterGroups?: ReadonlyArray<{
         title: string;
         options: ReadonlyArray<string>;
+        active?: string;
+        onSelect?: (option: string) => void;
     }>;
     activeFilters?: string[];
     resultSummary?: string;
+    onSearch?: (query: string) => void;
+    searchValue?: string;
+    onClearFilters?: () => void;
 }
-export declare function AdminListingScaffold({ title, subtitle, actionLabel, searchPlaceholder, rows, isLoading, errorMessage, emptyLabel, filterGroups, activeFilters, resultSummary, children, headerSlot, filterContent, activeFiltersSlot, resultCountSlot, searchSlot, sortSlot, actionsSlot, ...props }: AdminListingScaffoldProps): import("react/jsx-runtime").JSX.Element;
+export declare function AdminListingScaffold({ title, subtitle, actionLabel, actionHref, columns, getRowHref, searchPlaceholder, rows, isLoading, errorMessage, emptyLabel, filterGroups, activeFilters, resultSummary, onSearch, searchValue, onClearFilters, children, headerSlot, filterContent, activeFiltersSlot, resultCountSlot, searchSlot, sortSlot, actionsSlot, ...props }: AdminListingScaffoldProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,3 +1,4 @@
+"use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import React from "react";
 import { Button, Div, Input, ListingViewShell, Span, Text, } from "../../../ui";
@@ -38,7 +39,7 @@ function buildColumns() {
     ];
 }
 function renderFilterContent(groups = DEFAULT_FILTER_GROUPS) {
-    return (_jsx(Div, { className: "space-y-5", children: groups.map((group) => (_jsxs(Div, { className: "space-y-2", children: [_jsx(Text, { className: "text-xs font-semibold uppercase tracking-[0.18em] text-zinc-500 dark:text-zinc-400", children: group.title }), _jsx(Div, { className: "flex flex-wrap gap-2", children: group.options.map((option, index) => (_jsx(Button, { type: "button", variant: "outline", size: "sm", className: "rounded-full", children: option }, `${group.title}-${option}`))) })] }, group.title))) }));
+    return (_jsx(Div, { className: "space-y-5", children: groups.map((group) => (_jsxs(Div, { className: "space-y-2", children: [_jsx(Text, { className: "text-xs font-semibold uppercase tracking-[0.18em] text-zinc-500 dark:text-zinc-400", children: group.title }), _jsx(Div, { className: "flex flex-wrap gap-2", children: group.options.map((option) => (_jsx(Button, { type: "button", variant: group.active === option ? "primary" : "outline", size: "sm", className: "rounded-full", onClick: () => group.onSelect?.(option), children: option }, `${group.title}-${option}`))) })] }, group.title))) }));
 }
 function renderActiveFilters(activeFilters) {
     if (!activeFilters || activeFilters.length === 0) {
@@ -46,12 +47,22 @@ function renderActiveFilters(activeFilters) {
     }
     return (_jsx(Div, { className: "mb-4 flex flex-wrap gap-2", children: activeFilters.map((filter) => (_jsx(Span, { className: "inline-flex rounded-full border border-zinc-200 bg-white px-3 py-1 text-xs font-medium text-zinc-600 dark:border-slate-700 dark:bg-slate-900 dark:text-zinc-300", children: filter }, filter))) }));
 }
-export function AdminListingScaffold({ title, subtitle, actionLabel, searchPlaceholder, rows, isLoading, errorMessage, emptyLabel, filterGroups, activeFilters, resultSummary, children, headerSlot, filterContent, activeFiltersSlot, resultCountSlot, searchSlot, sortSlot, actionsSlot, ...props }) {
+export function AdminListingScaffold({ title, subtitle, actionLabel, actionHref, columns, getRowHref, searchPlaceholder, rows, isLoading, errorMessage, emptyLabel, filterGroups, activeFilters, resultSummary, onSearch, searchValue, onClearFilters, children, headerSlot, filterContent, activeFiltersSlot, resultCountSlot, searchSlot, sortSlot, actionsSlot, ...props }) {
+    const [localSearch, setLocalSearch] = React.useState(searchValue ?? "");
     const hasChildren = React.Children.count(children) > 0;
     return (_jsx(ListingViewShell, { ...props, portal: "admin", headerSlot: headerSlot ?? (_jsx(AdminPageHeader, { title: title, subtitle: subtitle, actionLabel: actionLabel, onAction: () => undefined, themeConfig: {
                 gradient: "rounded-3xl border border-zinc-200 bg-gradient-to-r from-white to-zinc-50 dark:border-slate-800 dark:from-slate-950 dark:to-slate-900",
                 titleClass: "text-3xl font-bold text-zinc-950 dark:text-zinc-50",
                 subtitleClass: "text-sm text-zinc-600 dark:text-zinc-300",
                 spacingClass: "space-y-1.5",
-            } })), filterContent: filterContent ?? renderFilterContent(filterGroups), activeFiltersSlot: activeFiltersSlot ?? renderActiveFilters(activeFilters), resultCountSlot: resultCountSlot ?? (_jsx(Text, { className: "text-sm text-zinc-600 dark:text-zinc-300", children: resultSummary ?? `Showing ${rows.length} items` })), searchSlot: searchSlot ?? (_jsx(Input, { readOnly: true, value: "", placeholder: searchPlaceholder, "aria-label": searchPlaceholder, className: "min-w-[240px]" })), sortSlot: sortSlot ?? (_jsx(Button, { type: "button", variant: "outline", size: "sm", children: "Newest first" })), actionsSlot: actionsSlot ?? (_jsx(Button, { type: "button", variant: "primary", size: "sm", children: actionLabel })), filterActiveCount: activeFilters?.length ?? 0, filterPendingCount: 0, errorSlot: errorMessage ? (_jsx(Div, { className: "rounded-xl border border-red-200 bg-red-50 px-4 py-3 text-sm text-red-700 dark:border-red-900/60 dark:bg-red-950/40 dark:text-red-200", children: errorMessage })) : undefined, children: hasChildren ? (children) : (_jsx(DataTable, { columns: buildColumns(), rows: rows, isLoading: isLoading, emptyLabel: emptyLabel })) }));
+            } })), filterContent: filterContent ?? renderFilterContent(filterGroups), activeFiltersSlot: activeFiltersSlot ?? renderActiveFilters(activeFilters), resultCountSlot: resultCountSlot ?? (_jsx(Text, { className: "text-sm text-zinc-600 dark:text-zinc-300", children: resultSummary ?? `Showing ${rows.length} items` })), searchSlot: searchSlot ?? (_jsx(Input, { value: localSearch, placeholder: searchPlaceholder, "aria-label": searchPlaceholder, className: "min-w-[240px]", onChange: (e) => {
+                setLocalSearch(e.target.value);
+            }, onKeyDown: (e) => {
+                if (e.key === "Enter") {
+                    onSearch?.(localSearch);
+                }
+            } })), sortSlot: sortSlot ?? (_jsx(Button, { type: "button", variant: "outline", size: "sm", children: "Newest first" })), actionsSlot: actionsSlot ??
+            (actionLabel ? (actionHref ? (_jsx(Button, { type: "button", variant: "primary", size: "sm", onClick: () => {
+                    window.location.href = actionHref;
+                }, children: actionLabel })) : (_jsx(Button, { type: "button", variant: "primary", size: "sm", children: actionLabel }))) : undefined), filterActiveCount: activeFilters?.length ?? 0, filterPendingCount: 0, errorSlot: errorMessage ? (_jsx(Div, { className: "rounded-xl border border-red-200 bg-red-50 px-4 py-3 text-sm text-red-700 dark:border-red-900/60 dark:bg-red-950/40 dark:text-red-200", children: errorMessage })) : undefined, children: hasChildren ? (children) : (_jsx(DataTable, { columns: columns ?? buildColumns(), rows: rows, isLoading: isLoading, emptyLabel: emptyLabel, getRowHref: getRowHref })) }));
 }

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

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

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

@@ -0,0 +1,50 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from "react";
+import { ListingViewShell } from "../../../ui";
+import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
+import { toRecordArray, toRelativeDate, toStringValue, useAdminListingData, } from "../hooks/useAdminListingData";
+import { AdminListingScaffold } from "./AdminListingScaffold";
+export function AdminNewsletterView({ children, ...props }) {
+    const hasChildren = React.Children.count(children) > 0;
+    const [q, setQ] = React.useState("");
+    const [statusFilter, setStatusFilter] = React.useState("");
+    const filterParts = [];
+    if (statusFilter && statusFilter !== "All")
+        filterParts.push(`status==${statusFilter}`);
+    const filters = filterParts.join(",") || undefined;
+    const { rows, total, isLoading, errorMessage } = useAdminListingData({
+        queryKey: ["admin", "newsletter", "listing", q, filters ?? ""],
+        endpoint: ADMIN_ENDPOINTS.NEWSLETTER,
+        filters,
+        q,
+        mapRows: (response) => toRecordArray(response.subscribers).map((item, index) => ({
+            id: toStringValue(item.id, `sub-${index}`),
+            primary: toStringValue(item.email, "Unknown email"),
+            secondary: [
+                toStringValue(item.source, ""),
+                item.ipAddress ? "IP logged" : "",
+            ].filter(Boolean).join(" · ") || "—",
+            status: toStringValue(item.status, "unknown"),
+            updatedAt: toRelativeDate(item.subscribedAt ?? 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: "Newsletter Subscribers", subtitle: "View and manage email subscribers. Filter by status, search by email, and track subscription sources.", searchPlaceholder: "Search by email or source", onSearch: setQ, searchValue: q, rows: rows, isLoading: isLoading, errorMessage: errorMessage, emptyLabel: "No subscribers found", resultSummary: `Showing ${rows.length} of ${total} subscribers`, filterGroups: [
+            {
+                title: "Status",
+                options: ["All", "active", "unsubscribed"],
+                active: statusFilter || "All",
+                onSelect: (opt) => setStatusFilter(opt === "All" ? "" : opt),
+            },
+        ] }));
+}

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

@@ -7,9 +7,24 @@ import { toRecordArray, toRelativeDate, toStringValue, useAdminListingData, } fr
 import { AdminListingScaffold } from "./AdminListingScaffold";
 export function AdminProductsView({ children, ...props }) {
     const hasChildren = React.Children.count(children) > 0;
+    const [q, setQ] = React.useState("");
+    const [statusFilter, setStatusFilter] = React.useState("");
+    const [typeFilter, setTypeFilter] = React.useState("");
+    const filterParts = [];
+    if (statusFilter && statusFilter !== "All")
+        filterParts.push(`status==${statusFilter}`);
+    if (typeFilter && typeFilter !== "All") {
+        if (typeFilter === "Auctions")
+            filterParts.push("isAuction==true");
+        else if (typeFilter === "Pre-orders")
+            filterParts.push("isPreOrder==true");
+    }
+    const filters = filterParts.join(",") || undefined;
     const { rows, total, isLoading, errorMessage } = useAdminListingData({
-        queryKey: ["admin", "products", "listing"],
+        queryKey: ["admin", "products", "listing", q, filters ?? ""],
         endpoint: ADMIN_ENDPOINTS.PRODUCTS,
+        filters,
+        q,
         mapRows: (response) => toRecordArray(response.items).map((item, index) => ({
             id: toStringValue(item.id, `product-${index}`),
             primary: toStringValue(item.title ?? item.name, "Untitled product"),
@@ -25,5 +40,18 @@ export function AdminProductsView({ children, ...props }) {
     if (hasChildren) {
         return _jsx(ListingViewShell, { portal: "admin", ...props, children: children });
     }
-    return (_jsx(AdminListingScaffold, { portal: "admin", ...props, title: "Product Management", subtitle: "Review catalogue health, publishing state, and merchandising issues from one queue.", actionLabel: "New product", searchPlaceholder: "Search products, SKUs, or seller names", rows: rows, isLoading: isLoading, errorMessage: errorMessage, emptyLabel: "No products found", resultSummary: `Showing ${rows.length} of ${total} products` }));
+    return (_jsx(AdminListingScaffold, { portal: "admin", ...props, title: "Product Management", subtitle: "Review catalogue health, publishing state, and merchandising issues from one queue.", actionLabel: "New product", searchPlaceholder: "Search products, SKUs, or seller names", onSearch: setQ, searchValue: q, rows: rows, isLoading: isLoading, errorMessage: errorMessage, emptyLabel: "No products found", resultSummary: `Showing ${rows.length} of ${total} products`, filterGroups: [
+            {
+                title: "Status",
+                options: ["All", "published", "draft", "archived"],
+                active: statusFilter || "All",
+                onSelect: (opt) => setStatusFilter(opt === "All" ? "" : opt),
+            },
+            {
+                title: "Type",
+                options: ["All", "Products", "Auctions", "Pre-orders"],
+                active: typeFilter || "All",
+                onSelect: (opt) => setTypeFilter(opt === "All" ? "" : opt),
+            },
+        ] }));
 }

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

@@ -8,9 +8,20 @@ import { AdminListingScaffold } from "./AdminListingScaffold";
 export function AdminReviewsView({ renderDetailView, children, ...props }) {
     const hasChildren = React.Children.count(children) > 0;
     const hasDetailView = Boolean(renderDetailView);
+    const [q, setQ] = React.useState("");
+    const [statusFilter, setStatusFilter] = React.useState("");
+    const [ratingFilter, setRatingFilter] = React.useState("");
+    const filterParts = [];
+    if (statusFilter && statusFilter !== "All")
+        filterParts.push(`status==${statusFilter}`);
+    if (ratingFilter && ratingFilter !== "All")
+        filterParts.push(`rating==${ratingFilter}`);
+    const filters = filterParts.join(",") || undefined;
     const { rows, total, isLoading, errorMessage } = useAdminListingData({
-        queryKey: ["admin", "reviews", "listing"],
+        queryKey: ["admin", "reviews", "listing", q, filters ?? ""],
         endpoint: ADMIN_ENDPOINTS.REVIEWS,
+        filters,
+        q,
         mapRows: (response) => toRecordArray(response.items).map((item, index) => ({
             id: toStringValue(item.id, `review-${index}`),
             primary: `${toStringValue(item.rating, "-")} star · ${toStringValue(item.productTitle ?? item.productName, "Unknown product")}`,
@@ -23,5 +34,18 @@ export function AdminReviewsView({ renderDetailView, children, ...props }) {
     if (hasChildren || hasDetailView) {
         return _jsx(ListingViewShell, { portal: "admin", ...props, detailView: renderDetailView?.(), children: children });
     }
-    return (_jsx(AdminListingScaffold, { portal: "admin", ...props, title: "Review Moderation", subtitle: "Moderate customer feedback, seller responses, and featured review placement from one queue.", actionLabel: "Review policies", searchPlaceholder: "Search reviews, products, or seller names", rows: rows, isLoading: isLoading, errorMessage: errorMessage, emptyLabel: "No reviews found", resultSummary: `Showing ${rows.length} of ${total} reviews` }));
+    return (_jsx(AdminListingScaffold, { portal: "admin", ...props, title: "Review Moderation", subtitle: "Moderate customer feedback, seller responses, and featured review placement from one queue.", actionLabel: "Review policies", searchPlaceholder: "Search reviews, products, or seller names", onSearch: setQ, searchValue: q, rows: rows, isLoading: isLoading, errorMessage: errorMessage, emptyLabel: "No reviews found", resultSummary: `Showing ${rows.length} of ${total} reviews`, filterGroups: [
+            {
+                title: "Status",
+                options: ["All", "approved", "pending", "rejected"],
+                active: statusFilter || "All",
+                onSelect: (opt) => setStatusFilter(opt === "All" ? "" : opt),
+            },
+            {
+                title: "Rating",
+                options: ["All", "5", "4", "3", "2", "1"],
+                active: ratingFilter || "All",
+                onSelect: (opt) => setRatingFilter(opt === "All" ? "" : opt),
+            },
+        ] }));
 }

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

@@ -7,9 +7,17 @@ import { toRecordArray, toRelativeDate, toStringValue, useAdminListingData, } fr
 import { AdminListingScaffold } from "./AdminListingScaffold";
 export function AdminStoresView({ children, ...props }) {
     const hasChildren = React.Children.count(children) > 0;
+    const [q, setQ] = React.useState("");
+    const [statusFilter, setStatusFilter] = React.useState("");
+    const filterParts = [];
+    if (statusFilter && statusFilter !== "All")
+        filterParts.push(`status==${statusFilter}`);
+    const filters = filterParts.join(",") || undefined;
     const { rows, total, isLoading, errorMessage } = useAdminListingData({
-        queryKey: ["admin", "stores", "listing"],
+        queryKey: ["admin", "stores", "listing", q, filters ?? ""],
         endpoint: ADMIN_ENDPOINTS.STORES,
+        filters,
+        q,
         mapRows: (response) => toRecordArray(response.items).map((item, index) => ({
             id: toStringValue(item.id, `store-${index}`),
             primary: toStringValue(item.storeName, "Unnamed store"),
@@ -25,5 +33,12 @@ export function AdminStoresView({ children, ...props }) {
     if (hasChildren) {
         return _jsx(ListingViewShell, { portal: "admin", ...props, children: children });
     }
-    return (_jsx(AdminListingScaffold, { portal: "admin", ...props, title: "Store Directory", subtitle: "Review seller storefront health, verification, and merchandising quality from the shared listing shell.", actionLabel: "Approve store", searchPlaceholder: "Search stores, slugs, or owner names", rows: rows, isLoading: isLoading, errorMessage: errorMessage, emptyLabel: "No stores found", resultSummary: `Showing ${rows.length} of ${total} stores` }));
+    return (_jsx(AdminListingScaffold, { portal: "admin", ...props, title: "Store Directory", subtitle: "Review seller storefront health, verification, and merchandising quality from the shared listing shell.", actionLabel: "Approve store", searchPlaceholder: "Search stores, slugs, or owner names", onSearch: setQ, searchValue: q, rows: rows, isLoading: isLoading, errorMessage: errorMessage, emptyLabel: "No stores found", resultSummary: `Showing ${rows.length} of ${total} stores`, filterGroups: [
+            {
+                title: "Status",
+                options: ["All", "active", "pending", "suspended", "rejected"],
+                active: statusFilter || "All",
+                onSelect: (opt) => setStatusFilter(opt === "All" ? "" : opt),
+            },
+        ] }));
 }

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

@@ -7,9 +7,21 @@ import { toRecordArray, toRelativeDate, toStringValue, useAdminListingData, } fr
 import { AdminListingScaffold } from "./AdminListingScaffold";
 export function AdminUsersView({ children, ...props }) {
     const hasChildren = React.Children.count(children) > 0;
+    const [q, setQ] = React.useState("");
+    const [statusFilter, setStatusFilter] = React.useState("");
+    const [roleFilter, setRoleFilter] = React.useState("");
+    const filterParts = [];
+    if (statusFilter && statusFilter !== "All") {
+        filterParts.push(statusFilter === "Active" ? "disabled==false" : "disabled==true");
+    }
+    if (roleFilter && roleFilter !== "All")
+        filterParts.push(`role==${roleFilter}`);
+    const filters = filterParts.join(",") || undefined;
     const { rows, total, isLoading, errorMessage } = useAdminListingData({
-        queryKey: ["admin", "users", "listing"],
+        queryKey: ["admin", "users", "listing", q, filters ?? ""],
         endpoint: ADMIN_ENDPOINTS.USERS,
+        filters,
+        q,
         mapRows: (response) => toRecordArray(response.users).map((item, index) => ({
             id: toStringValue(item.id ?? item.uid, `user-${index}`),
             primary: toStringValue(item.displayName, "Unnamed user"),
@@ -37,5 +49,18 @@ export function AdminUsersView({ children, ...props }) {
     if (hasChildren) {
         return _jsx(ListingViewShell, { portal: "admin", ...props, children: children });
     }
-    return (_jsx(AdminListingScaffold, { portal: "admin", ...props, title: "User Management", subtitle: "Audit onboarding, verification, and role changes without leaving the admin listing shell.", actionLabel: "Invite user", searchPlaceholder: "Search users, email, or seller handles", rows: rows, isLoading: isLoading, errorMessage: errorMessage, emptyLabel: "No users found", resultSummary: `Showing ${rows.length} of ${total} users` }));
+    return (_jsx(AdminListingScaffold, { portal: "admin", ...props, title: "User Management", subtitle: "Audit onboarding, verification, and role changes without leaving the admin listing shell.", actionLabel: "Invite user", searchPlaceholder: "Search users, email, or seller handles", onSearch: setQ, searchValue: q, rows: rows, isLoading: isLoading, errorMessage: errorMessage, emptyLabel: "No users found", resultSummary: `Showing ${rows.length} of ${total} users`, filterGroups: [
+            {
+                title: "Status",
+                options: ["All", "Active", "Disabled"],
+                active: statusFilter || "All",
+                onSelect: (opt) => setStatusFilter(opt === "All" ? "" : opt),
+            },
+            {
+                title: "Role",
+                options: ["All", "admin", "seller", "buyer", "moderator"],
+                active: roleFilter || "All",
+                onSelect: (opt) => setRoleFilter(opt === "All" ? "" : opt),
+            },
+        ] }));
 }

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

@@ -5,6 +5,7 @@ interface DataTableProps<T extends {
     columns: AdminTableColumn<T>[];
     rows: T[];
     isLoading?: boolean;
+    getRowHref?: (row: T) => string;
     sortKey?: string;
     sortDir?: "asc" | "desc";
     onSort?: (key: string) => void;
@@ -15,5 +16,5 @@ interface DataTableProps<T extends {
 }
 export declare function DataTable<T extends {
     id: string;
-}>({ columns, rows, isLoading, sortKey, sortDir, onSort, totalPages, currentPage, onPageChange, emptyLabel, }: DataTableProps<T>): import("react/jsx-runtime").JSX.Element;
+}>({ columns, rows, isLoading, sortKey, sortDir, onSort, totalPages, currentPage, onPageChange, emptyLabel, getRowHref, }: DataTableProps<T>): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,7 +1,21 @@
+"use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Button, Div, Span } from "../../../ui";
-export function DataTable({ columns, rows, isLoading, sortKey, sortDir, onSort, totalPages = 1, currentPage = 1, onPageChange, emptyLabel = "No records found", }) {
-    return (_jsxs(Div, { className: "overflow-hidden rounded-xl border border-neutral-200 dark:border-slate-700 bg-white dark:bg-slate-900", children: [_jsx(Div, { className: "overflow-x-auto", children: _jsxs("table", { className: "w-full text-sm", children: [_jsx("thead", { children: _jsx("tr", { className: "border-b border-neutral-200 dark:border-slate-700 bg-neutral-50 dark:bg-slate-800", children: columns.map((col) => (_jsxs("th", { scope: "col", onClick: col.sortable && onSort ? () => onSort(col.key) : undefined, className: `px-4 py-3 text-left font-semibold text-neutral-900 dark:text-zinc-100 ${col.sortable && onSort ? "cursor-pointer select-none hover:text-primary" : ""} ${col.className ?? ""}`, children: [col.header, col.sortable && sortKey === col.key && (_jsx(Span, { className: "ml-1", children: sortDir === "asc" ? "↑" : "↓" }))] }, col.key))) }) }), _jsx("tbody", { children: isLoading ? (Array.from({ length: 5 }).map((_, i) => (_jsx("tr", { className: "border-b border-neutral-100 dark:border-slate-700", children: columns.map((col) => (_jsx("td", { className: "px-4 py-3", children: _jsx(Div, { className: "h-4 w-full animate-pulse rounded bg-neutral-200 dark:bg-slate-700" }) }, col.key))) }, i)))) : rows.length === 0 ? (_jsx("tr", { children: _jsx("td", { colSpan: columns.length, className: "px-4 py-12 text-center text-neutral-500 dark:text-zinc-400", children: emptyLabel }) })) : (rows.map((row) => (_jsx("tr", { className: "border-b border-neutral-100 dark:border-slate-700 hover:bg-neutral-50 dark:hover:bg-slate-800", children: columns.map((col) => (_jsx("td", { className: `px-4 py-3 text-neutral-700 dark:text-zinc-300 ${col.className ?? ""}`, children: col.render
-                                        ? col.render(row)
-                                        : String(row[col.key] ?? "") }, col.key))) }, row.id)))) })] }) }), totalPages > 1 && onPageChange && (_jsx(Div, { className: "flex items-center justify-end gap-2 border-t border-neutral-200 dark:border-slate-700 px-4 py-3", children: Array.from({ length: totalPages }, (_, i) => i + 1).map((p) => (_jsx(Button, { onClick: () => onPageChange(p), variant: p === currentPage ? "primary" : "ghost", size: "sm", className: `h-8 w-8 rounded text-xs font-medium transition ${p === currentPage ? "bg-neutral-900 text-white" : "text-neutral-600 dark:text-zinc-300 hover:bg-neutral-100 dark:hover:bg-slate-800"}`, children: p }, p))) }))] }));
+export function DataTable({ columns, rows, isLoading, sortKey, sortDir, onSort, totalPages = 1, currentPage = 1, onPageChange, emptyLabel = "No records found", getRowHref, }) {
+    return (_jsxs(Div, { className: "overflow-hidden rounded-xl border border-neutral-200 dark:border-slate-700 bg-white dark:bg-slate-900", children: [_jsx(Div, { className: "overflow-x-auto", children: _jsxs("table", { className: "w-full text-sm", children: [_jsx("thead", { children: _jsx("tr", { className: "border-b border-neutral-200 dark:border-slate-700 bg-neutral-50 dark:bg-slate-800", children: columns.map((col) => (_jsxs("th", { scope: "col", onClick: col.sortable && onSort ? () => onSort(col.key) : undefined, className: `px-4 py-3 text-left font-semibold text-neutral-900 dark:text-zinc-100 ${col.sortable && onSort ? "cursor-pointer select-none hover:text-primary" : ""} ${col.className ?? ""}`, children: [col.header, col.sortable && sortKey === col.key && (_jsx(Span, { className: "ml-1", children: sortDir === "asc" ? "↑" : "↓" }))] }, col.key))) }) }), _jsx("tbody", { children: isLoading ? (Array.from({ length: 5 }).map((_, i) => (_jsx("tr", { className: "border-b border-neutral-100 dark:border-slate-700", children: columns.map((col) => (_jsx("td", { className: "px-4 py-3", children: _jsx(Div, { className: "h-4 w-full animate-pulse rounded bg-neutral-200 dark:bg-slate-700" }) }, col.key))) }, i)))) : rows.length === 0 ? (_jsx("tr", { children: _jsx("td", { colSpan: columns.length, className: "px-4 py-12 text-center text-neutral-500 dark:text-zinc-400", children: emptyLabel }) })) : (rows.map((row) => {
+                                const rowHref = getRowHref?.(row);
+                                return (_jsx("tr", { onClick: rowHref
+                                        ? () => {
+                                            window.location.href = rowHref;
+                                        }
+                                        : undefined, onKeyDown: rowHref
+                                        ? (event) => {
+                                            if (event.key === "Enter" || event.key === " ") {
+                                                window.location.href = rowHref;
+                                            }
+                                        }
+                                        : undefined, role: rowHref ? "link" : undefined, tabIndex: rowHref ? 0 : undefined, className: `border-b border-neutral-100 dark:border-slate-700 hover:bg-neutral-50 dark:hover:bg-slate-800 ${rowHref ? "cursor-pointer" : ""}`, children: columns.map((col) => (_jsx("td", { className: `px-4 py-3 text-neutral-700 dark:text-zinc-300 ${col.className ?? ""}`, children: col.render
+                                            ? col.render(row)
+                                            : String(row[col.key] ?? "") }, col.key))) }, row.id));
+                            })) })] }) }), totalPages > 1 && onPageChange && (_jsx(Div, { className: "flex items-center justify-end gap-2 border-t border-neutral-200 dark:border-slate-700 px-4 py-3", children: Array.from({ length: totalPages }, (_, i) => i + 1).map((p) => (_jsx(Button, { onClick: () => onPageChange(p), variant: p === currentPage ? "primary" : "ghost", size: "sm", className: `h-8 w-8 rounded text-xs font-medium transition ${p === currentPage ? "bg-neutral-900 text-white" : "text-neutral-600 dark:text-zinc-300 hover:bg-neutral-100 dark:hover:bg-slate-800"}`, children: p }, p))) }))] }));
 }

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

@@ -1,4 +1,6 @@
 export { DataTable } from "./DataTable";
+export { AdminListingScaffold } from "./AdminListingScaffold";
+export type { AdminListingScaffoldRow } from "./AdminListingScaffold";
 export { DashboardStatsGrid } from "./DashboardStats";
 export { AdminUsersView } from "./AdminUsersView";
 export type { AdminUsersViewProps } from "./AdminUsersView";
@@ -58,6 +60,10 @@ export { AdminTopProductsTable } from "./analytics/AdminTopProductsTable";
 export type { AdminTopProductsTableProps, AdminTopProductsTableLabels, } from "./analytics/AdminTopProductsTable";
 export { AdminFeatureFlagsView } from "./AdminFeatureFlagsView";
 export type { AdminFeatureFlagsViewProps } from "./AdminFeatureFlagsView";
+export { AdminNewsletterView } from "./AdminNewsletterView";
+export type { AdminNewsletterViewProps } from "./AdminNewsletterView";
+export { AdminContactView } from "./AdminContactView";
+export type { AdminContactViewProps } from "./AdminContactView";
 export { AdminSidebar } from "./AdminSidebar";
 export type { AdminSidebarProps } from "./AdminSidebar";
 export { AdminTopBar } from "./AdminTopBar";

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

@@ -1,4 +1,5 @@
 export { DataTable } from "./DataTable";
+export { AdminListingScaffold } from "./AdminListingScaffold";
 export { DashboardStatsGrid } from "./DashboardStats";
 export { AdminUsersView } from "./AdminUsersView";
 export { AdminProductsView } from "./AdminProductsView";
@@ -29,6 +30,8 @@ export { DrawerFormFooter } from "./DrawerFormFooter";
 export { AdminRevenueChart, AdminOrdersChart, } from "./analytics/AdminAnalyticsCharts";
 export { AdminTopProductsTable } from "./analytics/AdminTopProductsTable";
 export { AdminFeatureFlagsView } from "./AdminFeatureFlagsView";
+export { AdminNewsletterView } from "./AdminNewsletterView";
+export { AdminContactView } from "./AdminContactView";
 export { AdminSidebar } from "./AdminSidebar";
 export { AdminTopBar } from "./AdminTopBar";
 export { DemoSeedView } from "./DemoSeedView";

package/dist/features/admin/hooks/useAdminListingData.d.ts

@@ -7,6 +7,8 @@ interface UseAdminListingDataOptions<TResponse, TRow extends {
     page?: number;
     pageSize?: number;
     sorts?: string;
+    filters?: string;
+    q?: string;
     mapRows: (response: TResponse) => TRow[];
     getTotal?: (response: TResponse, rows: TRow[]) => number;
 }
@@ -20,7 +22,7 @@ export interface UseAdminListingDataResult<TRow extends {
 }
 export declare function useAdminListingData<TResponse, TRow extends {
     id: string;
-}>({ queryKey, endpoint, page, pageSize, sorts, mapRows, getTotal, }: UseAdminListingDataOptions<TResponse, TRow>): UseAdminListingDataResult<TRow>;
+}>({ queryKey, endpoint, page, pageSize, sorts, filters, q, mapRows, getTotal, }: UseAdminListingDataOptions<TResponse, TRow>): UseAdminListingDataResult<TRow>;
 export declare function toRecordArray(value: unknown): UnknownRecord[];
 export declare function toStringValue(value: unknown, fallback?: string): string;
 export declare function toRupees(value: unknown): string;

package/dist/features/admin/hooks/useAdminListingData.js

@@ -6,14 +6,19 @@ function withQueryParams(endpoint, params) {
     const query = new URLSearchParams(params).toString();
     return `${endpoint}${hasQuery ? "&" : "?"}${query}`;
 }
-export function useAdminListingData({ queryKey, endpoint, page = 1, pageSize = 25, sorts = "-createdAt", mapRows, getTotal, }) {
+export function useAdminListingData({ queryKey, endpoint, page = 1, pageSize = 25, sorts = "-createdAt", filters, q, mapRows, getTotal, }) {
+    const params = {
+        page: String(page),
+        pageSize: String(pageSize),
+        sorts,
+    };
+    if (filters)
+        params.filters = filters;
+    if (q)
+        params.q = q;
     const query = useQuery({
-        queryKey: [...queryKey, page, pageSize, sorts],
-        queryFn: () => apiClient.get(withQueryParams(endpoint, {
-            page: String(page),
-            pageSize: String(pageSize),
-            sorts,
-        })),
+        queryKey: [...queryKey, page, pageSize, sorts, filters ?? "", q ?? ""],
+        queryFn: () => apiClient.get(withQueryParams(endpoint, params)),
         staleTime: 60000,
     });
     const rows = query.data ? mapRows(query.data) : [];

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

@@ -6,6 +6,9 @@
 export * from "./actions";
 export { notificationRepository } from "./repository/notification.repository";
 export { chatRepository } from "./repository/chat.repository";
+export { contactSubmissionsRepository } from "../../core/contact-submissions.repository";
+export type { ContactSubmissionDocument, ContactSubmissionCreateInput } from "../../core/contact-submissions.repository";
+export { newsletterRepository } from "../../core/newsletter.repository";
 export type { ChatRoomDocument, ChatRoomCreateInput, } from "./repository/chat.repository";
 export { siteSettingsRepository } from "./repository/site-settings.repository";
 export { GET as adminProductsGET } from "./api/products/route";

package/dist/features/admin/server.js

@@ -6,6 +6,8 @@
 export * from "./actions";
 export { notificationRepository } from "./repository/notification.repository";
 export { chatRepository } from "./repository/chat.repository";
+export { contactSubmissionsRepository } from "../../core/contact-submissions.repository";
+export { newsletterRepository } from "../../core/newsletter.repository";
 export { siteSettingsRepository } from "./repository/site-settings.repository";
 export { GET as adminProductsGET } from "./api/products/route";
 export { GET as adminCouponsGET } from "./api/coupons/route";