@mohasinac/appkit 4.10.0 → 4.11.0

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

@@ -5,7 +5,7 @@ import React from "react";
 import { useQuery } from "@tanstack/react-query";
 import { z } from "zod";
 import { Button, ConfirmDeleteModal, Div, Form, Input, Row, Stack, StackedViewShell, Text, Toggle, useToast, } from "../../../ui";
-import { FieldInput, FieldTextarea } from "../../../ui/forms";
+import { FieldInput, FieldTextarea, FormErrorSummary } from "../../../ui/forms";
 import { apiClient } from "../../../http";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
 import { ACTIONS } from "../../../_internal/shared/actions/action-registry";
@@ -119,7 +119,7 @@ export function AdminTesterChecklistItemEditorView({ itemId, onSaved, onDeleted,
     });
     const isSubmitting = saveMutation.isPending || itemQuery.isLoading;
     const canSave = Boolean(groupLabel.trim()) && Boolean(pageLabel.trim()) && Boolean(label.trim());
-    const formSection = (_jsxs(_Fragment, { children: [_jsx(Form, { schema: checklistItemFormSchema, onSubmit: (e) => e.preventDefault(), spacing: "md", children: ({ setFieldError, clearErrors }) => (_jsxs(_Fragment, { children: [_jsxs(Div, { layout: "grid", gap: "4", className: "grid-cols-2", children: [_jsx(FieldInput, { name: "groupLabel", label: "Group", value: groupLabel, onChange: handleGroupLabelChange, required: true, placeholder: "e.g. Buying", hint: "Top-level accordion section on the Tester Hub." }), _jsx(Input, { label: "Group key", value: groupKey, onChange: (e) => setGroupKey(e.target.value), placeholder: "buying", helperText: "Auto-generated from the group name." })] }), _jsxs(Div, { layout: "grid", gap: "4", className: "grid-cols-2", children: [_jsx(FieldInput, { name: "pageLabel", label: "Page", value: pageLabel, onChange: handlePageLabelChange, required: true, placeholder: "e.g. Checkout", hint: "Sub-accordion within the group." }), _jsx(Input, { label: "Page key", value: pageKey, onChange: (e) => setPageKey(e.target.value), placeholder: "checkout", helperText: "Auto-generated from the page name." })] }), _jsx(FieldInput, { name: "label", label: "Test case (Yes/No question)", value: label, onChange: setLabel, required: true, placeholder: "e.g. Coupon discount is correctly reflected in the order total" }), _jsx(FieldTextarea, { name: "description", label: "Description (optional)", value: description, onChange: setDescription, placeholder: "Extra context for the tester." }), _jsx(FieldInput, { name: "href", label: "Deep link (optional)", value: href, onChange: setHref, placeholder: "/cart", hint: "Jumps the tester straight to the feature being tested." }), _jsxs(Div, { layout: "grid", gap: "4", className: "grid-cols-2", children: [_jsx(Input, { label: "Display order", value: String(order), onChange: (e) => setOrder(parseInt(e.target.value, 10) || 0), type: "number", min: 0, helperText: "Lower = shown first within the page." }), _jsx(Input, { label: "Phase", value: String(phase), onChange: (e) => setPhase(Math.max(1, parseInt(e.target.value, 10) || 1)), type: "number", min: 1, helperText: "Test batch this case belongs to \u2014 testers work through one phase at a time." })] }), _jsxs(Stack, { className: `${__P.p4}`, gap: "3", rounded: "lg", border: "default", children: [_jsx(Text, { size: "sm", weight: "medium", color: "muted", children: "Visibility" }), _jsx(Toggle, { label: "Active (visible to testers)", checked: isActive, onChange: setIsActive }), _jsx(Toggle, { label: "Admin-only (requires canTestAdmin)", checked: adminOnly, onChange: setAdminOnly })] }), _jsxs(Row, { gap: "3", padding: "t-xs", children: [_jsx(Button, { type: "submit", isLoading: isSubmitting, disabled: !canSave || isSubmitting, onClick: () => {
+    const formSection = (_jsxs(_Fragment, { children: [_jsx(Form, { schema: checklistItemFormSchema, onSubmit: (e) => e.preventDefault(), spacing: "md", children: ({ setFieldError, clearErrors }) => (_jsxs(_Fragment, { children: [_jsxs(Div, { layout: "grid", gap: "4", className: "grid-cols-2", children: [_jsx(FieldInput, { name: "groupLabel", label: "Group", value: groupLabel, onChange: handleGroupLabelChange, required: true, placeholder: "e.g. Buying", hint: "Top-level accordion section on the Tester Hub." }), _jsx(Input, { label: "Group key", value: groupKey, onChange: (e) => setGroupKey(e.target.value), placeholder: "buying", helperText: "Auto-generated from the group name." })] }), _jsxs(Div, { layout: "grid", gap: "4", className: "grid-cols-2", children: [_jsx(FieldInput, { name: "pageLabel", label: "Page", value: pageLabel, onChange: handlePageLabelChange, required: true, placeholder: "e.g. Checkout", hint: "Sub-accordion within the group." }), _jsx(Input, { label: "Page key", value: pageKey, onChange: (e) => setPageKey(e.target.value), placeholder: "checkout", helperText: "Auto-generated from the page name." })] }), _jsx(FieldInput, { name: "label", label: "Test case (Yes/No question)", value: label, onChange: setLabel, required: true, placeholder: "e.g. Coupon discount is correctly reflected in the order total" }), _jsx(FieldTextarea, { name: "description", label: "Description (optional)", value: description, onChange: setDescription, placeholder: "Extra context for the tester." }), _jsx(FieldInput, { name: "href", label: "Deep link (optional)", value: href, onChange: setHref, placeholder: "/cart", hint: "Jumps the tester straight to the feature being tested." }), _jsxs(Div, { layout: "grid", gap: "4", className: "grid-cols-2", children: [_jsx(Input, { label: "Display order", value: String(order), onChange: (e) => setOrder(parseInt(e.target.value, 10) || 0), type: "number", min: 0, helperText: "Lower = shown first within the page." }), _jsx(Input, { label: "Phase", value: String(phase), onChange: (e) => setPhase(Math.max(1, parseInt(e.target.value, 10) || 1)), type: "number", min: 1, helperText: "Test batch this case belongs to \u2014 testers work through one phase at a time." })] }), _jsxs(Stack, { className: `${__P.p4}`, gap: "3", rounded: "lg", border: "default", children: [_jsx(Text, { size: "sm", weight: "medium", color: "muted", children: "Visibility" }), _jsx(Toggle, { label: "Active (visible to testers)", checked: isActive, onChange: setIsActive }), _jsx(Toggle, { label: "Admin-only (requires canTestAdmin)", checked: adminOnly, onChange: setAdminOnly })] }), _jsx(FormErrorSummary, {}), _jsxs(Row, { gap: "3", padding: "t-xs", children: [_jsx(Button, { type: "submit", isLoading: isSubmitting, disabled: !canSave || isSubmitting, onClick: () => {
                                         clearErrors();
                                         if (!label.trim()) {
                                             setFieldError("label", "Test case label is required");

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

@@ -11,8 +11,8 @@ export interface AdminUserEditorViewProps {
     onClose: () => void;
     userId?: string;
     displayName?: string;
+    photoURL?: string | null;
     currentRole?: string;
-    currentIsDisabled?: boolean;
     currentEmailVerified?: boolean;
     /** Tester program flag — orthogonal to role. Grants access to the Tester Hub and auto-approves the user's store. */
     currentIsTester?: boolean;
@@ -37,5 +37,5 @@ export interface AdminUserEditorViewProps {
         linkedin?: string;
     };
 }
-export declare function AdminUserEditorView({ open, onClose, userId, displayName, currentRole, currentIsDisabled: _currentIsDisabled, currentEmailVerified, currentIsTester, currentCanTestAdmin, ownedStoreId, ownedStoreName, currentSoftBans, currentIsHardBanned, currentHardBanReason, currentPhoneNumber, currentBio, currentLocation, currentWebsite, currentSocialLinks, }: AdminUserEditorViewProps): React.JSX.Element;
+export declare function AdminUserEditorView({ open, onClose, userId, displayName, photoURL, currentRole, currentEmailVerified, currentIsTester, currentCanTestAdmin, ownedStoreId, ownedStoreName, currentSoftBans, currentIsHardBanned, currentHardBanReason, currentPhoneNumber, currentBio, currentLocation, currentWebsite, currentSocialLinks, }: AdminUserEditorViewProps): React.JSX.Element;
 export {};

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

@@ -3,7 +3,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { Code, useApiMutation } from "@mohasinac/appkit/client";
 import React from "react";
 import { useQueryClient } from "@tanstack/react-query";
-import { Button, ConfirmDeleteModal, Div, Form, FormActions, Heading, Input, Row, Select, SideDrawer, Span, Stack, StackedViewShell, Text, Textarea, Toggle, useToast } from "../../../ui";
+import { Avatar, Button, ConfirmDeleteModal, Div, Form, FormActions, Heading, Input, Row, Select, SideDrawer, Span, Stack, StackedViewShell, Text, Textarea, Toggle, useToast } from "../../../ui";
 import { apiClient } from "../../../http";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
 const ROLE_OPTIONS = [
@@ -41,7 +41,7 @@ function SoftBanPanel({ userId, softBans, showAddSoftBan, setShowAddSoftBan, sof
     return (_jsxs(Div, { surface: "muted", padding: "sm", rounded: "lg", border: "default", children: [_jsxs(Row, { justify: "between", gap: "sm", className: "mb-2", children: [_jsxs(Span, { size: "sm", weight: "medium", color: "muted", children: ["Soft bans", softBans.length > 0 ? ` (${softBans.length})` : ""] }), !showAddSoftBan && (_jsx(Button, { type: "button", variant: "secondary", size: "sm", disabled: !userId, onClick: () => setShowAddSoftBan(true), children: "Add soft ban" }))] }), softBans.length > 0 && (_jsx(Stack, { as: "ul", gap: "xs", className: "mb-3", children: softBans.map((ban) => (_jsxs(Row, { as: "li", align: "start", justify: "between", gap: "xs", surface: "default", padding: "inlineSm", rounded: "md", border: "default", children: [_jsxs(Stack, { gap: "none", className: "min-w-0 flex-1", children: [_jsx(Span, { size: "xs", weight: "semibold", children: formatBanAction(ban.action) }), _jsx(Span, { size: "xs", color: "muted", children: ban.reason }), _jsx(Span, { size: "xs", color: "muted", children: formatExpiry(ban.expiresAt) })] }), _jsx(Button, { type: "button", variant: "secondary", size: "sm", isLoading: liftPending, disabled: liftPending, onClick: () => onLiftSoftBan(ban.action), children: "Lift" })] }, ban.action))) })), showAddSoftBan && (_jsxs(Stack, { gap: "xs", children: [_jsx(Select, { label: "Action to restrict", options: BANNED_ACTION_OPTIONS, value: softBanAction, onValueChange: setSoftBanAction }), _jsx(Textarea, { label: "Reason (required)", value: softBanReason, onChange: (e) => setSoftBanReason(e.target.value), rows: 2, placeholder: "e.g. Suspicious bid activity\u2026" }), _jsx(Input, { label: "Expires at (optional \u2014 leave blank for permanent)", type: "datetime-local", value: softBanExpiry, onChange: (e) => setSoftBanExpiry(e.target.value) }), _jsxs(Row, { gap: "xs", children: [_jsx(Button, { type: "button", variant: "primary", size: "sm", isLoading: softBanPending, disabled: !softBanReason.trim() || softBanPending, onClick: () => onAddSoftBan({ action: softBanAction, reason: softBanReason.trim(), ...(softBanExpiry ? { expiresAt: new Date(softBanExpiry).toISOString() } : {}) }), children: "Apply soft ban" }), _jsx(Button, { type: "button", variant: "secondary", size: "sm", onClick: () => { setShowAddSoftBan(false); setSoftBanReason(""); setSoftBanExpiry(""); }, children: "Cancel" })] })] })), softBans.length === 0 && !showAddSoftBan && (_jsx(Text, { size: "xs", color: "muted", children: "No active soft bans." }))] }));
 }
 // --- Component ---------------------------------------------------------------
-export function AdminUserEditorView({ open, onClose, userId, displayName, currentRole, currentIsDisabled: _currentIsDisabled, currentEmailVerified, currentIsTester, currentCanTestAdmin, ownedStoreId, ownedStoreName, currentSoftBans, currentIsHardBanned, currentHardBanReason, currentPhoneNumber, currentBio, currentLocation, currentWebsite, currentSocialLinks, }) {
+export function AdminUserEditorView({ open, onClose, userId, displayName, photoURL, currentRole, currentEmailVerified, currentIsTester, currentCanTestAdmin, ownedStoreId, ownedStoreName, currentSoftBans, currentIsHardBanned, currentHardBanReason, currentPhoneNumber, currentBio, currentLocation, currentWebsite, currentSocialLinks, }) {
     const queryClient = useQueryClient();
     const { showToast } = useToast();
     // --- General fields -------------------------------------------------------
@@ -224,6 +224,7 @@ export function AdminUserEditorView({ open, onClose, userId, displayName, curren
     });
     const isHardBanned = currentIsHardBanned ?? false;
     const softBans = currentSoftBans ?? [];
+    const renderAvatarHeader = () => userId ? (_jsxs(Row, { gap: "sm", align: "center", children: [_jsx(Avatar, { src: photoURL ?? null, name: displayName ?? userId, size: "md" }), _jsx(Text, { size: "sm", weight: "semibold", children: displayName ?? userId })] })) : null;
     const renderInfoCard = () => userId ? (_jsx(Div, { textSize: "xs", surface: "muted", rounded: "lg", border: "default", padding: "inlineSm", children: _jsxs(Stack, { color: "primary", gap: "xs", children: [_jsxs(Text, { size: "xs", children: [_jsx(Span, { weight: "semibold", children: "Owner ID (Firebase UID):" }), " ", _jsx(Code, { className: "select-all font-mono", children: userId })] }), ownedStoreId && (_jsxs(Text, { size: "xs", children: [_jsx(Span, { weight: "semibold", children: "Owns store:" }), " ", _jsx(Code, { className: "select-all font-mono", children: ownedStoreId }), ownedStoreName ? ` — ${ownedStoreName}` : ""] }))] }) })) : null;
     const renderRoleSection = () => (_jsx(Select, { label: "Role", options: ROLE_OPTIONS, value: role, onValueChange: setRole }));
     const renderEmailVerifiedSection = () => (_jsx(Toggle, { label: "Email verified", checked: emailVerified, onChange: setEmailVerified }));
@@ -240,6 +241,7 @@ export function AdminUserEditorView({ open, onClose, userId, displayName, curren
                         e.preventDefault();
                         saveMutation.mutate();
                     }, padding: "md", children: _jsx(StackedViewShell, { portal: "admin", className: "space-y-4", sections: [
+                            renderAvatarHeader,
                             renderInfoCard,
                             renderRoleSection,
                             renderEmailVerifiedSection,

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

@@ -215,7 +215,7 @@ export function AdminUsersView({ children, ...props }) {
         },
         renderFilterPanel: ({ pendingFilters, setPendingFilters }) => (_jsxs(_Fragment, { children: [_jsx(FilterChipGroup, { label: "Status", tabs: ADMIN_USER_STATUS_TABS, value: pendingFilters.status ?? "", onChange: (id) => setPendingFilters((p) => ({ ...p, status: id })) }), _jsx(FilterChipGroup, { label: "Role", tabs: ADMIN_USER_ROLE_TABS, value: pendingFilters.role ?? "", onChange: (id) => setPendingFilters((p) => ({ ...p, role: id })) })] })),
     };
-    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), _jsx(AdminUserEditorView, { open: drawerOpen, onClose: () => setDrawerOpen(false), userId: selectedRow?.id, displayName: selectedRow?.primary, currentRole: toStringValue(selectedRow?._raw?.role, "user"), currentEmailVerified: Boolean(selectedRow?._raw?.emailVerified), currentIsTester: Boolean(selectedRow?._raw?.isTester), currentCanTestAdmin: Boolean(selectedRow?._raw?.canTestAdmin), ownedStoreId: toStringValue(selectedRow?._raw?.storeId, "") || undefined, ownedStoreName: toStringValue(selectedRow?._raw?.storeName, "") || undefined, currentIsHardBanned: Boolean((selectedRow?._raw?.isDisabled ?? selectedRow?._raw?.disabled) &&
+    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), _jsx(AdminUserEditorView, { open: drawerOpen, onClose: () => setDrawerOpen(false), userId: selectedRow?.id, displayName: selectedRow?.primary, photoURL: toStringValue(selectedRow?._raw?.photoURL, "") || undefined, currentRole: toStringValue(selectedRow?._raw?.role, "user"), currentEmailVerified: Boolean(selectedRow?._raw?.emailVerified), currentIsTester: Boolean(selectedRow?._raw?.isTester), currentCanTestAdmin: Boolean(selectedRow?._raw?.canTestAdmin), ownedStoreId: toStringValue(selectedRow?._raw?.storeId, "") || undefined, ownedStoreName: toStringValue(selectedRow?._raw?.storeName, "") || undefined, currentIsHardBanned: Boolean((selectedRow?._raw?.isDisabled ?? selectedRow?._raw?.disabled) &&
                     selectedRow?._raw?.hardBanReason), currentHardBanReason: toStringValue(selectedRow?._raw?.hardBanReason, "") || undefined, currentSoftBans: Array.isArray(selectedRow?._raw?.softBans)
                     ? selectedRow._raw.softBans.map((b) => ({
                         action: toStringValue(b.action, ""),

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

@@ -2,8 +2,10 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { sortBy } from "@mohasinac/appkit/client";
 import React from "react";
+import { useRouter } from "next/navigation";
 import { ListingLayout } from "../../../ui";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
+import { ROUTES } from "../../../next/routing/route-map";
 import { toRecordArray, toRelativeDate, toStringValue, } from "../hooks/useAdminListingData";
 import { DataListingView } from "./DataListingView";
 const ADMIN_WISHLISTS_CONFIG = {
@@ -29,14 +31,25 @@ const ADMIN_WISHLISTS_CONFIG = {
             secondary: `${itemCount} item${itemCount === 1 ? "" : "s"} of ${limit}`,
             status: isFull ? "Full" : itemCount >= limit - 2 ? "Near cap" : "OK",
             updatedAt: toRelativeDate(item.updatedAt),
+            userId: toStringValue(item.userId, ""),
         };
     }),
     getTotal: (response, mappedRows) => typeof response.total === "number" ? response.total : mappedRows.length,
     buildFilters: () => undefined,
 };
 export function AdminWishlistsView({ children, ...props }) {
+    const router = useRouter();
     if (React.Children.count(children) > 0) {
         return (_jsx(ListingLayout, { portal: "admin", ...props, children: children }));
     }
-    return _jsx(DataListingView, { config: ADMIN_WISHLISTS_CONFIG });
+    // The list API (`wishlistRepository.findAllSummaries()`) deliberately
+    // returns only {userId, itemCount, isFull, updatedAt} — never the items
+    // themselves, since pulling every user's ≤20 items into one payload is
+    // exactly the unbounded-response shape Rule #6 forbids. So the row already
+    // shows its whole record, and the genuinely useful destination is the
+    // owning user's admin page, which renders their real detail.
+    return (_jsx(DataListingView, { config: {
+            ...ADMIN_WISHLISTS_CONFIG,
+            onRowClick: (row) => row.userId && router.push(String(ROUTES.ADMIN.USER_DETAIL(row.userId))),
+        } }));
 }

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

@@ -74,8 +74,8 @@ export interface ListingSelectionContext<TRow extends {
 export interface ListingViewConfig<TResponse, TRow extends {
     id: string;
 }> extends AdminListingConfig<TResponse, TRow> {
-    /** Portal context — currently admin/seller share the same chrome. */
-    portal: "admin" | "seller";
+    /** Portal context — admin/seller/user all share the same chrome. */
+    portal: "admin" | "seller" | "user";
     title: string;
     subtitle?: string;
     searchPlaceholder: string;

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

@@ -0,0 +1,19 @@
+import type { JsonValue } from "../../../schemas/types";
+export interface AuditLogEntryDetail {
+    id: string;
+    actorUid: string;
+    actorName?: string;
+    action: string;
+    targetType: string;
+    targetId: string;
+    targetLabel?: string;
+    reason?: string;
+    metadata?: Record<string, JsonValue>;
+    createdAt?: string;
+}
+export interface ViewAuditLogEntryModalProps {
+    entry: AuditLogEntryDetail | null;
+    isOpen: boolean;
+    onClose: () => void;
+}
+export declare function ViewAuditLogEntryModal({ entry, isOpen, onClose }: ViewAuditLogEntryModalProps): import("react").JSX.Element | null;

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

@@ -0,0 +1,22 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * ViewAuditLogEntryModal — full audit-log entry details in a Modal overlay.
+ * Mirrors ViewReviewModal's shape (appkit/src/features/reviews/components/ReviewModal.tsx).
+ */
+import { Badge, Code, Div, Modal, Row, Stack, Text } from "../../../ui";
+const ACTION_LABELS = {
+    user_hard_ban: "User hard-banned",
+    user_soft_ban: "User soft-banned",
+    user_unban: "User unbanned",
+    checkout_bypass: "Admin checkout bypass",
+    coupon_update: "Coupon updated",
+    payout_mark_paid: "Payout marked paid",
+    store_status_change: "Store status changed",
+    user_role_change: "User role changed",
+};
+export function ViewAuditLogEntryModal({ entry, isOpen, onClose }) {
+    if (!entry)
+        return null;
+    return (_jsx(Modal, { isOpen: isOpen, onClose: onClose, title: "Audit Log Entry", children: _jsxs(Stack, { gap: "md", children: [_jsxs(Row, { justify: "between", align: "center", children: [_jsx(Badge, { variant: "default", children: ACTION_LABELS[entry.action] ?? entry.action }), entry.createdAt && (_jsx(Text, { size: "xs", color: "muted", children: new Date(entry.createdAt).toLocaleString() }))] }), _jsxs(Stack, { gap: "xs", children: [_jsxs(Row, { justify: "between", children: [_jsx(Text, { size: "sm", color: "muted", children: "Actor" }), _jsx(Text, { size: "sm", weight: "medium", children: entry.actorName ?? entry.actorUid })] }), _jsxs(Row, { justify: "between", children: [_jsx(Text, { size: "sm", color: "muted", children: "Target" }), _jsxs(Text, { size: "sm", weight: "medium", children: [entry.targetType, ": ", entry.targetLabel ?? entry.targetId] })] })] }), entry.reason && (_jsxs(Div, { rounded: "lg", padding: "sm", surface: "muted", border: "default", children: [_jsx(Text, { size: "xs", weight: "semibold", color: "muted", children: "Reason" }), _jsx(Text, { size: "sm", children: entry.reason })] })), entry.metadata && Object.keys(entry.metadata).length > 0 && (_jsxs(Div, { rounded: "lg", padding: "sm", surface: "muted", border: "default", children: [_jsx(Text, { size: "xs", weight: "semibold", color: "muted", className: "mb-1", children: "Metadata" }), _jsx(Code, { size: "xs", className: "block whitespace-pre-wrap font-mono", children: JSON.stringify(entry.metadata, null, 2) })] }))] }) }));
+}

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

@@ -0,0 +1,21 @@
+export interface NotificationEntryDetail {
+    id: string;
+    userId: string;
+    type: string;
+    priority?: string;
+    title: string;
+    message: string;
+    imageUrl?: string;
+    actionUrl?: string;
+    actionLabel?: string;
+    isRead: boolean;
+    relatedId?: string;
+    relatedType?: string;
+    createdAt?: string;
+}
+export interface ViewNotificationModalProps {
+    notification: NotificationEntryDetail | null;
+    isOpen: boolean;
+    onClose: () => void;
+}
+export declare function ViewNotificationModal({ notification, isOpen, onClose }: ViewNotificationModalProps): import("react").JSX.Element | null;

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

@@ -0,0 +1,15 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * ViewNotificationModal — full notification details in a Modal overlay.
+ * Mirrors ViewReviewModal's shape (appkit/src/features/reviews/components/ReviewModal.tsx).
+ * AdminNotificationsView was previously list-only — no way to see a
+ * notification's full body/payload/link, only Resend/Delete row actions.
+ */
+import { Anchor, Badge, Div, Modal, Row, Stack, Text } from "../../../ui";
+import { MediaImage } from "../../media/MediaImage";
+export function ViewNotificationModal({ notification, isOpen, onClose }) {
+    if (!notification)
+        return null;
+    return (_jsx(Modal, { isOpen: isOpen, onClose: onClose, title: "Notification Details", children: _jsxs(Stack, { gap: "md", children: [_jsxs(Row, { justify: "between", align: "center", children: [_jsxs(Row, { gap: "sm", align: "center", children: [_jsx(Badge, { variant: "default", children: notification.type }), _jsx(Badge, { variant: notification.isRead ? "default" : "info", children: notification.isRead ? "Read" : "Unread" })] }), notification.createdAt && (_jsx(Text, { size: "xs", color: "muted", children: new Date(notification.createdAt).toLocaleString() }))] }), _jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "lg", weight: "semibold", children: notification.title }), _jsx(Text, { size: "sm", color: "muted", children: notification.message })] }), notification.imageUrl && (_jsx(Div, { className: "h-32 w-full", rounded: "lg", overflow: "hidden", children: _jsx(MediaImage, { src: notification.imageUrl, alt: notification.title, size: "card" }) })), _jsxs(Stack, { gap: "xs", children: [_jsxs(Row, { justify: "between", children: [_jsx(Text, { size: "sm", color: "muted", children: "Recipient" }), _jsx(Text, { size: "sm", weight: "medium", children: notification.userId })] }), notification.relatedType && (_jsxs(Row, { justify: "between", children: [_jsx(Text, { size: "sm", color: "muted", children: "Related to" }), _jsxs(Text, { size: "sm", weight: "medium", children: [notification.relatedType, ": ", notification.relatedId] })] }))] }), notification.actionUrl && (_jsx(Row, { justify: "end", children: _jsxs(Anchor, { href: notification.actionUrl, tone: "brand", weight: "semibold", size: "sm", children: [notification.actionLabel ?? "Open link", " \u2192"] }) }))] }) }));
+}

package/dist/features/admin/components/analytics/AdminPageViewsReportView.d.ts

@@ -1,8 +1,5 @@
-export interface AdminPageViewsReportViewProps {
-    startDate: string;
-    endDate: string;
-}
 /** Admin analytics tab — page views for the requested date range, grouped by
- * entity (product/store/category/homepage/auction/review/user-profile) and
- * by raw URL. Backed by the day-bucketed pageViews collection. */
-export declare function AdminPageViewsReportView({ startDate, endDate }: AdminPageViewsReportViewProps): import("react").JSX.Element;
+ * entity (see PAGE_VIEW_ENTITY_TYPES for the full list), searchable by
+ * entity/URL, filterable by entity type, sortable by view count, and
+ * paginated. Backed by the day-bucketed pageViews collection. */
+export declare function AdminPageViewsReportView(): import("react").JSX.Element;

package/dist/features/admin/components/analytics/AdminPageViewsReportView.js

@@ -1,41 +1,61 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useQuery } from "@tanstack/react-query";
-import { Alert, Div, Stack, Text } from "../../../../ui";
-import { DataTable } from "../DataTable";
-import { apiClient } from "../../../../http";
+import { useState } from "react";
+import { SIEVE_OP, sieveFilter, sortBy } from "@mohasinac/appkit/client";
+import { Label, Input, PaginatedSelect } from "../../../../ui";
+import { DataListingView } from "../DataListingView";
 import { ADMIN_ENDPOINTS } from "../../../../constants/api-endpoints";
+import { PAGE_VIEW_ENTITY_TYPES } from "../../../analytics/types";
+const ENTITY_TYPE_OPTIONS = PAGE_VIEW_ENTITY_TYPES.map((t) => ({ value: t, label: t }));
+function today() {
+    // eslint-disable-next-line lir/no-raw-date
+    return new Date().toISOString().slice(0, 10);
+}
+function daysAgo(n) {
+    // eslint-disable-next-line lir/no-raw-date
+    const d = new Date();
+    d.setDate(d.getDate() - n);
+    return d.toISOString().slice(0, 10);
+}
+const COLUMNS = [
+    { key: "entityType", header: "Type" },
+    { key: "entityId", header: "Entity" },
+    { key: "url", header: "URL" },
+    { key: "count", header: "Views", sortable: true },
+];
 /** Admin analytics tab — page views for the requested date range, grouped by
- * entity (product/store/category/homepage/auction/review/user-profile) and
- * by raw URL. Backed by the day-bucketed pageViews collection. */
-export function AdminPageViewsReportView({ startDate, endDate }) {
-    const endpoint = `${ADMIN_ENDPOINTS.ANALYTICS_PAGE_VIEWS}?startDate=${startDate}&endDate=${endDate}`;
-    const query = useQuery({
-        queryKey: ["admin-page-views", endpoint],
-        queryFn: () => apiClient.get(endpoint),
-        staleTime: 60000,
-    });
-    if (query.error) {
-        return (_jsx(Alert, { variant: "error", title: "Could not load page views", children: query.error instanceof Error ? query.error.message : "Unknown error" }));
-    }
-    const data = query.data;
-    return (_jsxs(Stack, { gap: "lg", children: [_jsx(Text, { size: "sm", color: "muted", children: data ? `${data.total.toLocaleString()} total views, ${startDate} – ${endDate}` : "Loading…" }), _jsxs(Div, { children: [_jsx(Text, { size: "sm", weight: "semibold", className: "mb-2", children: "By entity" }), _jsx(DataTable, { columns: [
-                            { key: "entityType", header: "Type" },
-                            { key: "entityId", header: "Entity" },
-                            { key: "url", header: "URL" },
-                            { key: "count", header: "Views" },
-                        ], rows: (data?.byEntity ?? []).map((row) => ({
-                            id: `${row.entityType}:${row.entityId}`,
-                            entityType: row.entityType,
-                            entityId: row.entityId,
-                            url: row.url,
-                            count: row.count.toLocaleString(),
-                        })), isLoading: query.isLoading, emptyLabel: "No page views recorded for this range." })] }), _jsxs(Div, { children: [_jsx(Text, { size: "sm", weight: "semibold", className: "mb-2", children: "By URL" }), _jsx(DataTable, { columns: [
-                            { key: "url", header: "URL" },
-                            { key: "count", header: "Views" },
-                        ], rows: (data?.byUrl ?? []).map((row) => ({
-                            id: row.url,
-                            url: row.url,
-                            count: row.count.toLocaleString(),
-                        })), isLoading: query.isLoading, emptyLabel: "No page views recorded for this range." })] })] }));
+ * entity (see PAGE_VIEW_ENTITY_TYPES for the full list), searchable by
+ * entity/URL, filterable by entity type, sortable by view count, and
+ * paginated. Backed by the day-bucketed pageViews collection. */
+export function AdminPageViewsReportView() {
+    const [startDate, setStartDate] = useState(daysAgo(30));
+    const [endDate, setEndDate] = useState(today());
+    const config = {
+        portal: "admin",
+        title: "Page Views",
+        searchPlaceholder: "Search by entity or URL",
+        emptyLabel: "No page views recorded for this range.",
+        filterKeys: ["entityType"],
+        defaultSort: sortBy("count", "DESC"),
+        queryKey: ["admin", "analytics", "pageviews", "listing", startDate, endDate],
+        endpoint: `${ADMIN_ENDPOINTS.ANALYTICS_PAGE_VIEWS}?startDate=${startDate}&endDate=${endDate}`,
+        sortOptions: [
+            { value: sortBy("count", "DESC"), label: "Most views" },
+            { value: sortBy("count", "ASC"), label: "Fewest views" },
+        ],
+        columns: COLUMNS,
+        mapRows: (response) => response.items.map((item) => ({
+            id: `${item.entityType}:${item.entityId}`,
+            entityType: item.entityType,
+            entityId: item.entityId,
+            url: item.url,
+            count: item.count,
+        })),
+        getTotal: (response) => response.total,
+        buildFilters: (state) => state.entityType ? sieveFilter("entityType", SIEVE_OP.EQ, state.entityType) : undefined,
+        renderFilterPanel: ({ pendingFilters, setPendingFilters }) => (_jsx(PaginatedSelect, { value: pendingFilters.entityType || undefined, onChange: (v) => setPendingFilters((p) => ({ ...p, entityType: v ?? "" })), options: ENTITY_TYPE_OPTIONS })),
+        rowHrefTemplate: (row) => row.url,
+        renderAboveContent: () => (_jsxs(Label, { layout: "flex", gap: "md", color: "muted", size: "sm", className: "px-[var(--appkit-space-3)] pb-[var(--appkit-space-2)]", children: [_jsx(Input, { type: "date", value: startDate, max: endDate, onChange: (e) => setStartDate(e.target.value), className: "rounded-lg border px-[var(--appkit-space-2-5)] py-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-sm)] border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface-elevated)] text-[var(--appkit-color-text)]" }), "to", _jsx(Input, { type: "date", value: endDate, min: startDate, max: today(), onChange: (e) => setEndDate(e.target.value), className: "rounded-lg border px-[var(--appkit-space-2-5)] py-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-sm)] border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface-elevated)] text-[var(--appkit-color-text)]" })] })),
+    };
+    return _jsx(DataListingView, { config: config });
 }

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

@@ -97,6 +97,14 @@ export { AdminHistoryView } from "./AdminHistoryView";
 export type { AdminHistoryViewProps } from "./AdminHistoryView";
 export { AdminPayoutsView } from "./AdminPayoutsView";
 export type { AdminPayoutsViewProps } from "./AdminPayoutsView";
+export { AdminPayoutMarkPaidModal } from "./AdminPayoutMarkPaidModal";
+export type { AdminPayoutMarkPaidModalProps } from "./AdminPayoutMarkPaidModal";
+export { AdminAuditLogView } from "./AdminAuditLogView";
+export type { AdminAuditLogViewProps } from "./AdminAuditLogView";
+export { ViewAuditLogEntryModal } from "./ViewAuditLogEntryModal";
+export type { AuditLogEntryDetail, ViewAuditLogEntryModalProps } from "./ViewAuditLogEntryModal";
+export { ViewNotificationModal } from "./ViewNotificationModal";
+export type { NotificationEntryDetail, ViewNotificationModalProps } from "./ViewNotificationModal";
 export { AdminReviewsView } from "./AdminReviewsView";
 export type { AdminReviewsViewProps } from "./AdminReviewsView";
 export { AdminSectionsView } from "./AdminSectionsView";
@@ -134,7 +142,6 @@ export type { AdminRevenueChartProps, AdminOrdersChartProps, } from "./analytics
 export { AdminTopProductsTable } from "./analytics/AdminTopProductsTable";
 export type { AdminTopProductsTableProps, AdminTopProductsTableLabels, } from "./analytics/AdminTopProductsTable";
 export { AdminPageViewsReportView } from "./analytics/AdminPageViewsReportView";
-export type { AdminPageViewsReportViewProps } from "./analytics/AdminPageViewsReportView";
 export { AdminFeatureFlagsView } from "./AdminFeatureFlagsView";
 export type { AdminFeatureFlagsViewProps } from "./AdminFeatureFlagsView";
 export { AdminNewsletterView } from "./AdminNewsletterView";

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

@@ -53,6 +53,10 @@ export { AdminCartsView } from "./AdminCartsView";
 export { AdminWishlistsView } from "./AdminWishlistsView";
 export { AdminHistoryView } from "./AdminHistoryView";
 export { AdminPayoutsView } from "./AdminPayoutsView";
+export { AdminPayoutMarkPaidModal } from "./AdminPayoutMarkPaidModal";
+export { AdminAuditLogView } from "./AdminAuditLogView";
+export { ViewAuditLogEntryModal } from "./ViewAuditLogEntryModal";
+export { ViewNotificationModal } from "./ViewNotificationModal";
 export { AdminReviewsView } from "./AdminReviewsView";
 export { AdminSectionsView } from "./AdminSectionsView";
 export { AdminSessionsManager } from "./AdminSessionsManager";

package/dist/features/admin/constants/filter-tabs.d.ts

@@ -148,6 +148,36 @@ export declare const ADMIN_PAYOUT_STATUS_TABS: readonly [{
     readonly id: "failed";
     readonly label: "Failed";
 }];
+/** Admin > Audit Log — action-type filter chip set. IDs match
+ *  `AdminAuditActionValues` (`appkit/src/features/audit-log/schemas/firestore.ts`) exactly. */
+export declare const ADMIN_AUDIT_LOG_ACTION_TABS: readonly [{
+    readonly id: "All";
+    readonly label: "All";
+}, {
+    readonly id: "user_hard_ban";
+    readonly label: "Hard ban";
+}, {
+    readonly id: "user_soft_ban";
+    readonly label: "Soft ban";
+}, {
+    readonly id: "user_unban";
+    readonly label: "Unban";
+}, {
+    readonly id: "checkout_bypass";
+    readonly label: "Checkout bypass";
+}, {
+    readonly id: "coupon_update";
+    readonly label: "Coupon update";
+}, {
+    readonly id: "payout_mark_paid";
+    readonly label: "Payout paid";
+}, {
+    readonly id: "store_status_change";
+    readonly label: "Store status";
+}, {
+    readonly id: "user_role_change";
+    readonly label: "Role change";
+}];
 /** Admin > Orders — order-state filter chip set. Lowercase IDs match
  *  `OrderStatusValues` and the actual Firestore document `status` field. */
 export declare const ADMIN_ORDER_STATUS_TABS: readonly [{
@@ -175,6 +205,25 @@ export declare const ADMIN_ORDER_STATUS_TABS: readonly [{
     readonly id: "return_requested";
     readonly label: "Return Requested";
 }];
+/**
+ * Admin > Orders — manual-payment (cash / UPI / EMI) review queue.
+ *
+ * Deliberately NOT a `status` chip set: these two states are *derived* from
+ * `paymentProofUrl` + `paymentReviewOutcome`, both of which are absent-by-
+ * default fields that no Firestore equality filter can select on. The IDs are
+ * `PaymentReviewQueueMode` values and are sent as the `paymentReview` query
+ * param (not a Sieve filter) — see `orderRepository.listPaymentReviewQueue`.
+ */
+export declare const ADMIN_ORDER_PAYMENT_REVIEW_TABS: readonly [{
+    readonly id: "All";
+    readonly label: "All";
+}, {
+    readonly id: "awaiting_proof";
+    readonly label: "Awaiting payment";
+}, {
+    readonly id: "awaiting_verification";
+    readonly label: "Awaiting verification";
+}];
 /** Admin > Reviews — moderation state filter chip set. */
 export declare const ADMIN_REVIEW_STATUS_TABS: readonly [{
     readonly id: "All";

package/dist/features/admin/constants/filter-tabs.js

@@ -74,6 +74,19 @@ export const ADMIN_PAYOUT_STATUS_TABS = [
     { id: "paid", label: "Paid" },
     { id: "failed", label: "Failed" },
 ];
+/** Admin > Audit Log — action-type filter chip set. IDs match
+ *  `AdminAuditActionValues` (`appkit/src/features/audit-log/schemas/firestore.ts`) exactly. */
+export const ADMIN_AUDIT_LOG_ACTION_TABS = [
+    ALL_TAB,
+    { id: "user_hard_ban", label: "Hard ban" },
+    { id: "user_soft_ban", label: "Soft ban" },
+    { id: "user_unban", label: "Unban" },
+    { id: "checkout_bypass", label: "Checkout bypass" },
+    { id: "coupon_update", label: "Coupon update" },
+    { id: "payout_mark_paid", label: "Payout paid" },
+    { id: "store_status_change", label: "Store status" },
+    { id: "user_role_change", label: "Role change" },
+];
 /** Admin > Orders — order-state filter chip set. Lowercase IDs match
  *  `OrderStatusValues` and the actual Firestore document `status` field. */
 export const ADMIN_ORDER_STATUS_TABS = [
@@ -86,6 +99,20 @@ export const ADMIN_ORDER_STATUS_TABS = [
     { id: "refunded", label: "Refunded" },
     { id: "return_requested", label: "Return Requested" },
 ];
+/**
+ * Admin > Orders — manual-payment (cash / UPI / EMI) review queue.
+ *
+ * Deliberately NOT a `status` chip set: these two states are *derived* from
+ * `paymentProofUrl` + `paymentReviewOutcome`, both of which are absent-by-
+ * default fields that no Firestore equality filter can select on. The IDs are
+ * `PaymentReviewQueueMode` values and are sent as the `paymentReview` query
+ * param (not a Sieve filter) — see `orderRepository.listPaymentReviewQueue`.
+ */
+export const ADMIN_ORDER_PAYMENT_REVIEW_TABS = [
+    ALL_TAB,
+    { id: "awaiting_proof", label: "Awaiting payment" },
+    { id: "awaiting_verification", label: "Awaiting verification" },
+];
 /** Admin > Reviews — moderation state filter chip set. */
 export const ADMIN_REVIEW_STATUS_TABS = [
     ALL_TAB,

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

@@ -9,6 +9,12 @@ export interface AdminListingConfig<TResponse, TRow extends {
     mapRows: (response: TResponse) => TRow[];
     getTotal?: (response: TResponse, rows: TRow[]) => number;
     buildFilters: (filterState: Record<string, string>) => string | undefined;
+    /**
+     * Extra query params derived from the same filter state, for endpoints whose
+     * filter can't be expressed as a Sieve string. Use `buildFilters` for
+     * anything Sieve *can* express — this is the escape hatch, not the default.
+     */
+    buildExtraParams?: (filterState: Record<string, string>) => Record<string, string | undefined> | undefined;
     initialView?: "grid" | "list" | "table";
     /** Values used for filterKeys absent from the URL — lets a view default to
      * a non-"All" filter state (e.g. hide inactive rows) on first load, while

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

@@ -6,7 +6,7 @@ import { usePanelUrlSync } from "../../../react/hooks/use-panel-url-sync";
 import { useDataViewMode } from "../../account/hooks/useDataViewMode";
 import { useAdminListingData } from "./useAdminListingData";
 export function useAdminListing(config) {
-    const { filterKeys, defaultSort, pageSize: defaultPageSize = 25, queryKey, endpoint, mapRows, getTotal, buildFilters, filterDefaults = {}, } = config;
+    const { filterKeys, defaultSort, pageSize: defaultPageSize = 25, queryKey, endpoint, mapRows, getTotal, buildFilters, buildExtraParams, filterDefaults = {}, } = config;
     // Persisted, viewport-aware view-mode: below 768px defaults to "list"
     // (AdminViewCards' one-full-width-card-per-row layout) unless the caller
     // explicitly pins hideTableView (grid-only views like coupons); the user's
@@ -52,6 +52,7 @@ export function useAdminListing(config) {
     const hasActiveState = !!table.get("q") || table.get("sort") !== defaultSort || activeFilterCount > 0;
     const currentFilterState = Object.fromEntries(filterKeys.map((k) => [k, table.get(k)]));
     const filters = buildFilters(currentFilterState);
+    const extraParams = buildExtraParams?.(currentFilterState);
     const { rows, total, isLoading, errorMessage, refetch } = useAdminListingData({
         queryKey,
         endpoint,
@@ -60,6 +61,7 @@ export function useAdminListing(config) {
         sorts: table.get("sort") || defaultSort,
         filters,
         q: table.get("q") || undefined,
+        extraParams,
         mapRows,
         getTotal,
     });

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

@@ -15,6 +15,14 @@ interface UseAdminListingDataOptions<TResponse, TRow extends {
     sorts?: string;
     filters?: string;
     q?: string;
+    /**
+     * Extra query-string params appended verbatim, for listing endpoints whose
+     * filter isn't expressible as a Sieve string (e.g. the admin orders
+     * payment-review queue, which keys off the *absence* of a field). Keys with
+     * an `undefined` value are dropped. Participates in the react-query key, so
+     * changing one refetches rather than serving another mode's cached page.
+     */
+    extraParams?: Record<string, string | undefined>;
     mapRows: (response: TResponse) => TRow[];
     getTotal?: (response: TResponse, rows: TRow[]) => number;
 }
@@ -29,7 +37,7 @@ export interface UseAdminListingDataResult<TRow extends {
 }
 export declare function useAdminListingData<TResponse, TRow extends {
     id: string;
-}>({ queryKey, endpoint, page, pageSize, sorts, filters, q, mapRows, getTotal, }: UseAdminListingDataOptions<TResponse, TRow>): UseAdminListingDataResult<TRow>;
+}>({ queryKey, endpoint, page, pageSize, sorts, filters, q, extraParams, mapRows, getTotal, }: UseAdminListingDataOptions<TResponse, TRow>): UseAdminListingDataResult<TRow>;
 export declare function toRecordArray(value: unknown): ListingItemRecord[];
 export declare function toStringValue(value: unknown, fallback?: string): string;
 export declare function toCurrency(value: unknown): string;

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

@@ -7,7 +7,7 @@ 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", filters, q, mapRows, getTotal, }) {
+export function useAdminListingData({ queryKey, endpoint, page = 1, pageSize = 25, sorts = "-createdAt", filters, q, extraParams, mapRows, getTotal, }) {
     const params = {
         page: String(page),
         pageSize: String(pageSize),
@@ -17,8 +17,15 @@ export function useAdminListingData({ queryKey, endpoint, page = 1, pageSize = 2
         params.filters = filters;
     if (q)
         params.q = q;
+    const extraEntries = Object.entries(extraParams ?? {})
+        .filter((entry) => entry[1] !== undefined && entry[1] !== "")
+        .sort(([a], [b]) => a.localeCompare(b));
+    for (const [key, value] of extraEntries)
+        params[key] = value;
     const query = useQuery({
-        queryKey: [...queryKey, page, pageSize, sorts, filters ?? "", q ?? ""],
+        // extraEntries is sorted so an identical param set always produces an
+        // identical key regardless of object insertion order.
+        queryKey: [...queryKey, page, pageSize, sorts, filters ?? "", q ?? "", extraEntries],
         queryFn: () => apiClient.get(withQueryParams(endpoint, params)),
         staleTime: 60000,
     });

package/dist/features/admin/repository/site-settings.repository.d.ts

@@ -103,6 +103,11 @@ export declare class SiteSettingsRepository extends BaseRepository<SiteSettingsD
         fromName: string;
         fromEmail: string;
         replyTo: string;
+        dailyDigest?: {
+            enabled: boolean;
+            recipients: string[];
+            ccRecipients: string[];
+        };
     }>;
     /**
      * Check if site settings exist