@mohasinac/appkit 2.7.27 → 2.7.30

package/dist/features/account/components/NotificationBell.js

@@ -60,22 +60,33 @@ export function NotificationBell({ limit = 10, viewAllHref, labels, icons, rende
         markAllRead,
         refetch,
     ]);
+    const handleMarkReadAndClose = useCallback((notification) => {
+        if (!notification.isRead)
+            void handleMarkRead(notification.id);
+        setIsOpen(false);
+    }, [handleMarkRead, setIsOpen]);
     const renderActionLink = renderLink ??
         ((props) => (_jsx(TextLink, { href: props.href, onClick: props.onClick, className: props.className, children: props.children })));
-    return (_jsxs("div", { className: "relative", ref: dropdownRef, "data-section": "notificationbell-div-227", children: [_jsxs(Button, { onClick: handleToggle, className: `${hideOnMobile ? "hidden md:flex" : "flex"} p-2.5 md:p-3 rounded-xl transition-colors relative text-zinc-600 hover:bg-zinc-100 hover:text-zinc-900 dark:text-zinc-300 dark:hover:bg-slate-800 dark:hover:text-white ${buttonClassName}`, "aria-label": labels.title, "aria-expanded": isOpen, children: [_jsx("svg", { className: "w-6 h-6 md:w-7 md:h-7", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M15 17h5l-1.405-1.405A2.032 2.032 0 0118 14.158V11a6.002 6.002 0 00-4-5.659V5a2 2 0 10-4 0v.341C7.67 6.165 6 8.388 6 11v3.159c0 .538-.214 1.055-.595 1.436L4 17h5m6 0v1a3 3 0 11-6 0v-1m6 0H9" }) }), unreadCount > 0 && (_jsx(Span, { className: "absolute -top-1 -right-1 bg-red-500 text-white text-xs min-w-[20px] h-5 px-1.5 flex items-center justify-center rounded-full font-semibold shadow-md", children: unreadCount > 99 ? "99+" : unreadCount }))] }), isOpen && (_jsxs("div", { className: `absolute right-0 top-full mt-2 w-80 sm:w-96 rounded-xl shadow-2xl border border-zinc-200 bg-white dark:border-slate-800 dark:bg-slate-950 z-50 overflow-hidden ${dropdownClassName}`, "data-section": "notificationbell-div-228", children: [_jsxs(Row, { justify: "between", gap: "none", className: "px-4 py-3 border-b border-zinc-200 dark:border-slate-800", children: [_jsxs(Heading, { level: 3, className: "font-semibold text-zinc-900 dark:text-white", children: [labels.title, unreadCount > 0 && (_jsxs(Span, { className: "ml-2 text-xs bg-red-100 text-red-700 dark:bg-red-900/30 dark:text-red-400 px-2 py-0.5 rounded-full font-medium", children: [unreadCount, " ", labels.unread] }))] }), unreadCount > 0 && (_jsx(Button, { onClick: handleMarkAllRead, disabled: isMarkingAll, className: "text-xs text-primary hover:underline font-medium disabled:opacity-50", children: isMarkingAll ? labels.loading : labels.markAllRead }))] }), _jsx("div", { className: "max-h-96 overflow-y-auto", "data-section": "notificationbell-div-229", children: isLoading ? (_jsx("div", { className: "flex items-center justify-center py-10", "data-section": "notificationbell-div-230", children: _jsx(Spinner, { size: "md" }) })) : notifications.length === 0 ? (_jsxs("div", { className: "flex flex-col items-center justify-center py-10 px-4 text-center", "data-section": "notificationbell-div-231", children: [_jsx("svg", { className: "w-12 h-12 text-zinc-300 dark:text-zinc-600 mb-3", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 1.5, d: "M15 17h5l-1.405-1.405A2.032 2.032 0 0118 14.158V11a6.002 6.002 0 00-4-5.659V5a2 2 0 10-4 0v.341C7.67 6.165 6 8.388 6 11v3.159c0 .538-.214 1.055-.595 1.436L4 17h5m6 0v1a3 3 0 11-6 0v-1m6 0H9" }) }), _jsx(Text, { className: "font-medium text-zinc-900 dark:text-white", children: labels.empty }), _jsx(Text, { size: "sm", className: "mt-1 text-zinc-500 dark:text-zinc-400", children: labels.emptyDesc })] })) : (_jsx(Ul, { children: notifications.map((notification) => (_jsxs(Li, { className: `group flex items-start gap-3 px-4 py-3 border-b border-zinc-200 dark:border-slate-800 last:border-0 transition-colors hover:bg-zinc-50 dark:hover:bg-slate-900 ${!notification.isRead ? "bg-primary/5 dark:bg-primary/10" : ""}`, children: [_jsx(Span, { className: "text-xl flex-shrink-0 mt-0.5", children: notificationIcons[notification.type] ?? "🔔" }), _jsxs("div", { className: "flex-1 min-w-0", "data-section": "notificationbell-div-232", children: [_jsxs("div", { className: `flex items-start justify-between ${THEME_CONSTANTS.spacing.gap.xs}`, "data-section": "notificationbell-div-233", children: [_jsxs(Text, { size: "sm", className: "font-medium text-zinc-900 dark:text-white leading-tight", children: [notification.title, !notification.isRead && (_jsx(Span, { className: "ml-1.5 inline-block w-2 h-2 rounded-full bg-primary flex-shrink-0 align-middle" }))] }), _jsx(Span, { className: "text-xs text-zinc-500 dark:text-zinc-400 flex-shrink-0", children: formatRelativeTime(notification.createdAt) })] }), _jsx(Text, { size: "sm", className: `text-zinc-600 dark:text-zinc-300 mt-0.5 ${THEME_CONSTANTS.utilities.textClamp2}`, children: notification.message }), _jsxs(Row, { gap: "3", className: "mt-1.5", children: [notification.actionUrl &&
-                                                        renderActionLink({
-                                                            href: notification.actionUrl,
-                                                            onClick: () => {
-                                                                if (!notification.isRead)
-                                                                    void handleMarkRead(notification.id);
-                                                                setIsOpen(false);
-                                                            },
-                                                            className: "text-xs text-primary hover:underline font-medium",
-                                                            children: notification.actionLabel ?? labels.viewAction,
-                                                        }), !notification.isRead && (_jsx(Button, { variant: "ghost", onClick: () => void handleMarkRead(notification.id), className: "text-xs text-zinc-500 dark:text-zinc-400 hover:text-zinc-700 dark:hover:text-zinc-200 hover:underline p-0 h-auto", children: labels.markRead }))] })] })] }, notification.id))) })) }), viewAllHref && (_jsx("div", { className: "px-4 py-3 border-t border-zinc-200 dark:border-slate-800 text-center", "data-section": "notificationbell-div-234", children: renderActionLink({
-                            href: viewAllHref,
-                            onClick: () => setIsOpen(false),
-                            className: "text-sm text-primary hover:underline font-medium",
-                            children: labels.viewAll,
-                        }) }))] }))] }));
+    return (_jsxs("div", { className: "relative", ref: dropdownRef, "data-section": "notificationbell-div-227", children: [renderBellButton({ hideOnMobile, buttonClassName, labels, unreadCount, handleToggle, isOpen }), isOpen && renderNotificationDropdown({
+                dropdownClassName, labels, unreadCount, isMarkingAll, handleMarkAllRead,
+                isLoading, notifications: notifications, notificationIcons,
+                handleMarkRead, handleMarkReadAndClose, renderActionLink, viewAllHref,
+                setIsOpen,
+            })] }));
+}
+function renderBellButton(props) {
+    const { hideOnMobile, buttonClassName, labels, unreadCount, handleToggle, isOpen } = props;
+    return (_jsxs(Button, { onClick: handleToggle, className: `${hideOnMobile ? "hidden md:flex" : "flex"} p-2.5 md:p-3 rounded-xl transition-colors relative text-zinc-600 hover:bg-zinc-100 hover:text-zinc-900 dark:text-zinc-300 dark:hover:bg-slate-800 dark:hover:text-white ${buttonClassName}`, "aria-label": labels.title, "aria-expanded": isOpen, children: [_jsx("svg", { className: "w-6 h-6 md:w-7 md:h-7", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M15 17h5l-1.405-1.405A2.032 2.032 0 0118 14.158V11a6.002 6.002 0 00-4-5.659V5a2 2 0 10-4 0v.341C7.67 6.165 6 8.388 6 11v3.159c0 .538-.214 1.055-.595 1.436L4 17h5m6 0v1a3 3 0 11-6 0v-1m6 0H9" }) }), unreadCount > 0 && (_jsx(Span, { className: "absolute -top-1 -right-1 bg-red-500 text-white text-xs min-w-[20px] h-5 px-1.5 flex items-center justify-center rounded-full font-semibold shadow-md", children: unreadCount > 99 ? "99+" : unreadCount }))] }));
+}
+function renderNotificationDropdown(props) {
+    const { dropdownClassName, labels, unreadCount, isMarkingAll, handleMarkAllRead, isLoading, notifications, notificationIcons, handleMarkRead, handleMarkReadAndClose, renderActionLink, viewAllHref, setIsOpen } = props;
+    return (_jsxs("div", { className: `absolute right-0 top-full mt-2 w-80 sm:w-96 rounded-xl shadow-2xl border border-zinc-200 bg-white dark:border-slate-800 dark:bg-slate-950 z-50 overflow-hidden ${dropdownClassName}`, "data-section": "notificationbell-div-228", children: [_jsxs(Row, { justify: "between", gap: "none", className: "px-4 py-3 border-b border-zinc-200 dark:border-slate-800", children: [_jsxs(Heading, { level: 3, className: "font-semibold text-zinc-900 dark:text-white", children: [labels.title, unreadCount > 0 && _jsxs(Span, { className: "ml-2 text-xs bg-red-100 text-red-700 dark:bg-red-900/30 dark:text-red-400 px-2 py-0.5 rounded-full font-medium", children: [unreadCount, " ", labels.unread] })] }), unreadCount > 0 && (_jsx(Button, { onClick: handleMarkAllRead, disabled: isMarkingAll, className: "text-xs text-primary hover:underline font-medium disabled:opacity-50", children: isMarkingAll ? labels.loading : labels.markAllRead }))] }), _jsx("div", { className: "max-h-96 overflow-y-auto", "data-section": "notificationbell-div-229", children: renderNotificationListContent({ isLoading, notifications, notificationIcons, labels, handleMarkRead, handleMarkReadAndClose, renderActionLink }) }), viewAllHref && (_jsx("div", { className: "px-4 py-3 border-t border-zinc-200 dark:border-slate-800 text-center", "data-section": "notificationbell-div-234", children: renderActionLink({ href: viewAllHref, onClick: () => setIsOpen(false), className: "text-sm text-primary hover:underline font-medium", children: labels.viewAll }) }))] }));
+}
+function renderNotificationListContent(props) {
+    const { isLoading, notifications, notificationIcons, labels, handleMarkRead, handleMarkReadAndClose, renderActionLink } = props;
+    if (isLoading)
+        return _jsx("div", { className: "flex items-center justify-center py-10", "data-section": "notificationbell-div-230", children: _jsx(Spinner, { size: "md" }) });
+    if (notifications.length === 0)
+        return (_jsxs("div", { className: "flex flex-col items-center justify-center py-10 px-4 text-center", "data-section": "notificationbell-div-231", children: [_jsx("svg", { className: "w-12 h-12 text-zinc-300 dark:text-zinc-600 mb-3", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 1.5, d: "M15 17h5l-1.405-1.405A2.032 2.032 0 0118 14.158V11a6.002 6.002 0 00-4-5.659V5a2 2 0 10-4 0v.341C7.67 6.165 6 8.388 6 11v3.159c0 .538-.214 1.055-.595 1.436L4 17h5m6 0v1a3 3 0 11-6 0v-1m6 0H9" }) }), _jsx(Text, { className: "font-medium text-zinc-900 dark:text-white", children: labels.empty }), _jsx(Text, { size: "sm", className: "mt-1 text-zinc-500 dark:text-zinc-400", children: labels.emptyDesc })] }));
+    return (_jsx(Ul, { children: notifications.map((notification) => (_jsxs(Li, { className: `group flex items-start gap-3 px-4 py-3 border-b border-zinc-200 dark:border-slate-800 last:border-0 transition-colors hover:bg-zinc-50 dark:hover:bg-slate-900 ${!notification.isRead ? "bg-primary/5 dark:bg-primary/10" : ""}`, children: [_jsx(Span, { className: "text-xl flex-shrink-0 mt-0.5", children: notificationIcons[notification.type] ?? "🔔" }), _jsxs("div", { className: "flex-1 min-w-0", "data-section": "notificationbell-div-232", children: [_jsxs("div", { className: `flex items-start justify-between ${THEME_CONSTANTS.spacing.gap.xs}`, "data-section": "notificationbell-div-233", children: [_jsxs(Text, { size: "sm", className: "font-medium text-zinc-900 dark:text-white leading-tight", children: [notification.title, !notification.isRead && _jsx(Span, { className: "ml-1.5 inline-block w-2 h-2 rounded-full bg-primary flex-shrink-0 align-middle" })] }), _jsx(Span, { className: "text-xs text-zinc-500 dark:text-zinc-400 flex-shrink-0", children: formatRelativeTime(notification.createdAt) })] }), _jsx(Text, { size: "sm", className: `text-zinc-600 dark:text-zinc-300 mt-0.5 ${THEME_CONSTANTS.utilities.textClamp2}`, children: notification.message }), _jsxs(Row, { gap: "3", className: "mt-1.5", children: [notification.actionUrl && renderActionLink({ href: notification.actionUrl, onClick: () => { void handleMarkReadAndClose(notification); }, className: "text-xs text-primary hover:underline font-medium", children: notification.actionLabel ?? labels.viewAction }), !notification.isRead && _jsx(Button, { variant: "ghost", onClick: () => void handleMarkRead(notification.id), className: "text-xs text-zinc-500 dark:text-zinc-400 hover:text-zinc-700 dark:hover:text-zinc-200 hover:underline p-0 h-auto", children: labels.markRead })] })] })] }, notification.id))) }));
 }

package/dist/features/account/components/NotificationPreferencesPanel.d.ts

@@ -0,0 +1,9 @@
+import type { NotificationPreferences } from "../types";
+export interface NotificationPreferencesPanelProps {
+    /** Fetch URL — defaults to /api/user/notification-preferences */
+    fetchUrl?: string;
+    /** Save URL — defaults to /api/user/notification-preferences */
+    saveUrl?: string;
+    onSave?: (prefs: NotificationPreferences) => void;
+}
+export declare function NotificationPreferencesPanel({ fetchUrl, saveUrl, onSave, }: NotificationPreferencesPanelProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/account/components/NotificationPreferencesPanel.js

@@ -0,0 +1,91 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useEffect, useCallback } from "react";
+import { Stack, Row, Text, Button, Div } from "../../../ui";
+import { useSiteSettings } from "../../../core/hooks/useSiteSettings";
+// ─── type-row config ────────────────────────────────────────────────────────
+const TYPE_ROWS = [
+    { key: "orderUpdates", label: "Order updates", description: "Placed, shipped, delivered, cancelled, refunded" },
+    { key: "bids", label: "Auction bids", description: "Outbid alerts and auction win/loss" },
+    { key: "offers", label: "Offers", description: "New offers received, counter-offers, responses" },
+    { key: "reviews", label: "Reviews", description: "Review approved, seller reply" },
+    { key: "messages", label: "Messages", description: "New buyer-seller chat messages" },
+    { key: "promotions", label: "Promotions", description: "Coupons, sales and platform events" },
+    { key: "system", label: "System & welcome", description: "Account alerts and platform announcements" },
+];
+// ─── Toggle row ─────────────────────────────────────────────────────────────
+function ToggleRow({ label, description, checked, onChange, disabled, }) {
+    return (_jsxs(Row, { align: "center", justify: "between", gap: "md", className: "py-3 border-b last:border-0 border-[var(--appkit-color-border)]", children: [_jsxs(Div, { className: "min-w-0", children: [_jsx(Text, { className: "text-sm font-medium text-[var(--appkit-color-text)]", children: label }), _jsx(Text, { variant: "secondary", className: "text-xs mt-0.5", children: description })] }), _jsx("button", { type: "button", role: "switch", "aria-checked": checked, "aria-label": label, disabled: disabled, onClick: () => onChange(!checked), className: [
+                    "relative inline-flex h-5 w-9 shrink-0 cursor-pointer rounded-full border-2 border-transparent",
+                    "transition-colors duration-200 ease-in-out focus-visible:outline-none focus-visible:ring-2",
+                    "focus-visible:ring-[var(--appkit-color-primary)] focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50",
+                    checked ? "bg-[var(--appkit-color-primary)]" : "bg-[var(--appkit-color-border-strong,#a1a1aa)]",
+                ].join(" "), children: _jsx("span", { className: [
+                        "pointer-events-none inline-block h-4 w-4 transform rounded-full bg-white shadow-lg",
+                        "ring-0 transition duration-200 ease-in-out",
+                        checked ? "translate-x-4" : "translate-x-0",
+                    ].join(" ") }) })] }));
+}
+// ─── Section card ───────────────────────────────────────────────────────────
+function SectionCard({ title, children }) {
+    return (_jsxs(Div, { className: "rounded-xl border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] overflow-hidden", children: [_jsx(Div, { className: "px-4 py-3 border-b border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface-alt,var(--appkit-color-surface))]", children: _jsx(Text, { className: "text-xs font-semibold uppercase tracking-widest text-[var(--appkit-color-text-muted)]", children: title }) }), _jsx(Div, { className: "px-4", children: children })] }));
+}
+export function NotificationPreferencesPanel({ fetchUrl = "/api/user/notification-preferences", saveUrl = "/api/user/notification-preferences", onSave, }) {
+    const { data: settings } = useSiteSettings();
+    const adminChannels = settings?.notificationChannels;
+    const [channels, setChannels] = useState({ email: true, whatsapp: true, sms: true });
+    const [types, setTypes] = useState({
+        orderUpdates: true, bids: true, promotions: true,
+        system: true, reviews: true, messages: true, offers: true,
+    });
+    const [loading, setLoading] = useState(true);
+    const [saving, setSaving] = useState(false);
+    const [saved, setSaved] = useState(false);
+    useEffect(() => {
+        fetch(fetchUrl, { credentials: "include" })
+            .then((r) => r.json())
+            .then((json) => {
+            const prefs = json.data?.notificationPreferences;
+            if (prefs?.channels)
+                setChannels((prev) => ({ ...prev, ...prefs.channels }));
+            if (prefs?.types)
+                setTypes((prev) => ({ ...prev, ...prefs.types }));
+        })
+            .catch(() => { })
+            .finally(() => setLoading(false));
+    }, [fetchUrl]);
+    const setChannel = useCallback((key, val) => {
+        setChannels((prev) => ({ ...prev, [key]: val }));
+        setSaved(false);
+    }, []);
+    const setType = useCallback((key, val) => {
+        setTypes((prev) => ({ ...prev, [key]: val }));
+        setSaved(false);
+    }, []);
+    const handleSave = useCallback(async () => {
+        setSaving(true);
+        try {
+            const prefs = { channels, types };
+            await fetch(saveUrl, {
+                method: "PUT",
+                credentials: "include",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(prefs),
+            });
+            setSaved(true);
+            onSave?.(prefs);
+        }
+        finally {
+            setSaving(false);
+        }
+    }, [channels, types, saveUrl, onSave]);
+    if (loading) {
+        return (_jsx(Div, { className: "py-8 text-center", children: _jsx(Text, { variant: "secondary", className: "text-sm", children: "Loading preferences\u2026" }) }));
+    }
+    // Which channels are admin-enabled (only show those toggles to the user)
+    const emailAdminEnabled = adminChannels?.email?.enabled ?? false;
+    const whatsappAdminEnabled = adminChannels?.whatsapp?.enabled ?? false;
+    const smsAdminEnabled = adminChannels?.sms?.enabled ?? false;
+    const anyChannelEnabled = emailAdminEnabled || whatsappAdminEnabled || smsAdminEnabled;
+    return (_jsxs(Stack, { gap: "lg", children: [_jsx(SectionCard, { title: "In-app notifications", children: _jsxs(Row, { align: "center", justify: "between", gap: "md", className: "py-3", children: [_jsxs(Div, { children: [_jsx(Text, { className: "text-sm font-medium text-[var(--appkit-color-text)]", children: "In-app notifications" }), _jsx(Text, { variant: "secondary", className: "text-xs mt-0.5", children: "Always on \u2014 displayed in the notification bell and inbox" })] }), _jsx(Div, { className: "h-5 w-9 rounded-full bg-[var(--appkit-color-primary)] flex items-center justify-end px-0.5", "aria-label": "Always on", children: _jsx("span", { className: "h-4 w-4 rounded-full bg-white shadow" }) })] }) }), anyChannelEnabled && (_jsxs(SectionCard, { title: "Notification channels", children: [emailAdminEnabled && (_jsx(ToggleRow, { label: "Email", description: "Receive notifications by email", checked: channels.email !== false, onChange: (v) => setChannel("email", v) })), whatsappAdminEnabled && (_jsx(ToggleRow, { label: "WhatsApp", description: "Receive notifications on WhatsApp", checked: channels.whatsapp !== false, onChange: (v) => setChannel("whatsapp", v) })), smsAdminEnabled && (_jsx(ToggleRow, { label: "SMS", description: "Receive SMS text notifications", checked: channels.sms !== false, onChange: (v) => setChannel("sms", v) }))] })), _jsx(SectionCard, { title: "Notification types", children: TYPE_ROWS.map((row) => (_jsx(ToggleRow, { label: row.label, description: row.description, checked: types[row.key] !== false, onChange: (v) => setType(row.key, v) }, row.key))) }), _jsxs(Row, { justify: "end", gap: "sm", children: [saved && (_jsx(Text, { className: "text-sm text-[var(--appkit-color-success,#16a34a)] self-center", children: "Preferences saved \u2713" })), _jsx(Button, { onClick: handleSave, isLoading: saving, size: "sm", children: "Save preferences" })] })] }));
+}

package/dist/features/account/components/UserSidebar.js

@@ -6,6 +6,9 @@ import Link from "next/link";
 import { usePathname } from "next/navigation";
 import { Li, Nav, Span, Ul } from "../../../ui";
 import { BottomSheet } from "../../layout/BottomSheet";
+function isNavItemActive(item, activeHref) {
+    return activeHref === item.href || activeHref.startsWith(item.href + "/");
+}
 function NavLink({ item, isActive, onClick }) {
     return (_jsxs(Link, { href: item.href, onClick: onClick, className: `flex items-center gap-2.5 rounded-lg px-3 py-2 text-[0.8125rem] font-medium leading-tight transition-colors ${isActive
             ? "bg-primary-50 dark:bg-primary-900/25 text-primary-700 dark:text-primary-300"
@@ -35,10 +38,7 @@ function DrawerContent({ groups, items, activeHref, onItemClick, }) {
             const hasActive = group.items.some((i) => activeHref === i.href || activeHref.startsWith(i.href + "/"));
             return (_jsxs("div", { className: "mb-0.5", children: [_jsxs("button", { type: "button", onClick: () => toggle(group.title), className: `flex w-full items-center justify-between px-4 py-2 text-[0.6875rem] font-semibold uppercase tracking-widest transition-colors ${hasActive && !isOpen
                             ? "text-primary-600 dark:text-primary-400"
-                            : "text-zinc-400 dark:text-zinc-500 hover:text-zinc-600 dark:hover:text-zinc-300"}`, children: [_jsx("span", { children: group.title }), _jsx("svg", { className: `w-3 h-3 transition-transform duration-150 ${isOpen ? "rotate-180" : ""}`, fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2.5, d: "M19 9l-7 7-7-7" }) })] }), isOpen && (_jsx(Ul, { className: "space-y-0.5 px-3 pb-1", children: group.items.map((item) => {
-                            const isActive = activeHref === item.href || activeHref.startsWith(item.href + "/");
-                            return (_jsx(Li, { children: _jsx(NavLink, { item: item, isActive: isActive, onClick: onItemClick }) }, item.href));
-                        }) }))] }, group.title));
+                            : "text-zinc-400 dark:text-zinc-500 hover:text-zinc-600 dark:hover:text-zinc-300"}`, children: [_jsx("span", { children: group.title }), _jsx("svg", { className: `w-3 h-3 transition-transform duration-150 ${isOpen ? "rotate-180" : ""}`, fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2.5, d: "M19 9l-7 7-7-7" }) })] }), isOpen && (_jsx(Ul, { className: "space-y-0.5 px-3 pb-1", children: group.items.map((item) => (_jsx(Li, { children: _jsx(NavLink, { item: item, isActive: isNavItemActive(item, activeHref), onClick: onItemClick }) }, item.href))) }))] }, group.title));
         }) }));
 }
 function DrawerPanel({ title, onClose, children, }) {

package/dist/features/account/components/UserSupportView.js

@@ -6,6 +6,7 @@ import { Button, Div, FormActions, Select, SideDrawer, Text, useToast, } from ".
 import { apiClient } from "../../../http";
 import { SUPPORT_ENDPOINTS } from "../../../constants/api-endpoints";
 // --- Constants ---------------------------------------------------------------
+const CLS_INPUT = "w-full rounded-lg border border-zinc-300 dark:border-zinc-700 bg-white dark:bg-zinc-800 px-3 py-2 text-sm text-zinc-900 dark:text-zinc-100 placeholder-zinc-400 focus:outline-none focus:ring-2 focus:ring-primary-500";
 const CATEGORY_OPTIONS = [
     { label: "Order Issue", value: "order_issue" },
     { label: "Billing / Payment", value: "billing_payment" },
@@ -81,10 +82,19 @@ export function UserSupportView(_props) {
             showToast(err?.message ?? "Failed to send reply.", "error");
         },
     });
-    return (_jsxs(_Fragment, { children: [_jsxs(Div, { className: "mx-auto max-w-2xl px-4 py-6", children: [_jsxs(Div, { className: "mb-4 flex items-center justify-between", children: [_jsx(Text, { className: "text-xl font-semibold text-zinc-900 dark:text-zinc-100", children: "Support Tickets" }), _jsx(Button, { type: "button", variant: "primary", size: "sm", onClick: () => setNewTicketOpen(true), children: "New ticket" })] }), isLoading && (_jsx(Div, { className: "space-y-3", children: [1, 2, 3].map((i) => (_jsx("div", { className: "h-16 animate-pulse rounded-lg bg-zinc-100 dark:bg-zinc-800" }, i))) })), error && (_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: "Failed to load support tickets." })), !isLoading && tickets.length === 0 && (_jsx(Div, { className: "rounded-xl border border-zinc-200 bg-zinc-50 px-6 py-10 text-center dark:border-zinc-700 dark:bg-zinc-900/40", children: _jsx(Text, { className: "text-sm text-zinc-500 dark:text-zinc-400", children: "You haven't opened any support tickets yet." }) })), _jsx("ul", { className: "space-y-3", children: tickets.map((ticket) => (_jsx("li", { children: _jsx("button", { type: "button", className: "w-full rounded-xl border border-zinc-200 bg-white p-4 text-left shadow-sm hover:border-primary-300 transition-colors dark:border-zinc-700 dark:bg-zinc-900", onClick: () => {
-                                    setSelectedTicket(ticket);
-                                    setDetailOpen(true);
-                                }, children: _jsxs("div", { className: "flex items-start justify-between gap-2", children: [_jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("p", { className: "font-medium text-zinc-900 dark:text-zinc-100 truncate", children: ticket.subject }), _jsxs("p", { className: "text-xs text-zinc-500 dark:text-zinc-400", children: [ticket.category.replace(/_/g, " "), ticket.orderId ? ` · Order: ${ticket.orderId}` : ""] })] }), _jsx("span", { className: `shrink-0 inline-flex rounded-full px-2.5 py-0.5 text-xs font-medium ${STATUS_BADGE[ticket.status] ?? STATUS_BADGE.open}`, children: ticket.status.replace(/_/g, " ") })] }) }) }, ticket.id))) })] }), _jsx(SideDrawer, { isOpen: newTicketOpen, onClose: () => setNewTicketOpen(false), title: "Open a support ticket", children: _jsxs(Div, { className: "flex flex-col gap-4 p-4", children: [_jsx(Select, { label: "Category", options: CATEGORY_OPTIONS, value: newCategory, onValueChange: setNewCategory }), _jsxs(Div, { className: "flex flex-col gap-1", children: [_jsx("label", { className: "text-sm font-medium text-zinc-700 dark:text-zinc-300", children: "Subject" }), _jsx("input", { type: "text", value: newSubject, onChange: (e) => setNewSubject(e.target.value), placeholder: "Brief description of the issue", className: "w-full rounded-lg border border-zinc-300 dark:border-zinc-700 bg-white dark:bg-zinc-800 px-3 py-2 text-sm text-zinc-900 dark:text-zinc-100 placeholder-zinc-400 focus:outline-none focus:ring-2 focus:ring-primary-500" })] }), newCategory === "order_issue" && (_jsxs(Div, { className: "flex flex-col gap-1", children: [_jsx("label", { className: "text-sm font-medium text-zinc-700 dark:text-zinc-300", children: "Order ID" }), _jsx("input", { type: "text", value: newOrderId, onChange: (e) => setNewOrderId(e.target.value), placeholder: "e.g. order-3-20260508-a1b2c3", className: "w-full rounded-lg border border-zinc-300 dark:border-zinc-700 bg-white dark:bg-zinc-800 px-3 py-2 text-sm text-zinc-900 dark:text-zinc-100 placeholder-zinc-400 focus:outline-none focus:ring-2 focus:ring-primary-500" })] })), _jsxs(Div, { className: "flex flex-col gap-1", children: [_jsx("label", { className: "text-sm font-medium text-zinc-700 dark:text-zinc-300", children: "Description" }), _jsx("textarea", { value: newDescription, onChange: (e) => setNewDescription(e.target.value), rows: 4, placeholder: "Describe the issue in detail\u2026", className: "w-full rounded-lg border border-zinc-300 dark:border-zinc-700 bg-white dark:bg-zinc-800 px-3 py-2 text-sm text-zinc-900 dark:text-zinc-100 placeholder-zinc-400 focus:outline-none focus:ring-2 focus:ring-primary-500" })] }), _jsxs(FormActions, { align: "right", children: [_jsx(Button, { type: "button", variant: "secondary", onClick: () => setNewTicketOpen(false), children: "Cancel" }), _jsx(Button, { type: "button", isLoading: createMutation.isPending, disabled: !newSubject.trim() || !newDescription.trim() || createMutation.isPending, onClick: () => createMutation.mutate(), children: "Submit ticket" })] })] }) }), _jsx(SideDrawer, { isOpen: detailOpen, onClose: () => setDetailOpen(false), title: selectedTicket?.subject ?? "Ticket", children: selectedTicket && (_jsxs(Div, { className: "flex flex-col gap-4 p-4", children: [_jsxs(Div, { className: "flex flex-wrap gap-2", children: [_jsx("span", { className: `inline-flex rounded-full px-2.5 py-1 text-xs font-medium ${STATUS_BADGE[selectedTicket.status] ?? STATUS_BADGE.open}`, children: selectedTicket.status.replace(/_/g, " ") }), _jsx("span", { className: "rounded-full bg-zinc-100 px-2.5 py-1 text-xs text-zinc-600 dark:bg-zinc-800 dark:text-zinc-300", children: selectedTicket.category.replace(/_/g, " ") }), selectedTicket.orderId && (_jsxs("span", { className: "rounded-full bg-zinc-100 px-2.5 py-1 text-xs text-zinc-600 dark:bg-zinc-800 dark:text-zinc-300", children: ["Order: ", selectedTicket.orderId] }))] }), selectedTicket.description && (_jsxs(Div, { className: "rounded-lg border border-zinc-200 bg-zinc-50 p-3 dark:border-zinc-700 dark:bg-zinc-900/40", children: [_jsx(Text, { className: "mb-1 text-xs font-semibold text-zinc-500 uppercase tracking-wide", children: "Your description" }), _jsx(Text, { className: "whitespace-pre-wrap text-sm text-zinc-700 dark:text-zinc-200", children: selectedTicket.description })] })), (selectedTicket.messages ?? []).length > 0 && (_jsxs(Div, { className: "space-y-2", children: [_jsx(Text, { className: "text-xs font-semibold text-zinc-500 uppercase tracking-wide", children: "Messages" }), _jsx("div", { className: "space-y-2 max-h-72 overflow-y-auto", children: (selectedTicket.messages ?? []).map((msg, i) => (_jsxs("div", { className: `rounded-lg p-3 text-sm ${msg.authorRole === "user"
-                                            ? "bg-zinc-50 border border-zinc-200 dark:bg-zinc-900/40 dark:border-zinc-700"
-                                            : "bg-blue-50 border border-blue-200 dark:bg-blue-900/20 dark:border-blue-800"}`, children: [_jsxs("div", { className: "mb-1 flex items-center gap-2 text-xs text-zinc-400 dark:text-zinc-500", children: [_jsx("span", { className: "font-medium text-zinc-600 dark:text-zinc-300", children: ROLE_LABEL[msg.authorRole ?? "user"] ?? msg.authorRole }), msg.createdAt && (_jsx("span", { children: new Date(msg.createdAt).toLocaleString() }))] }), _jsx("p", { className: "whitespace-pre-wrap text-zinc-700 dark:text-zinc-200", children: msg.body })] }, msg.id ?? i))) })] })), selectedTicket.status !== "closed" && selectedTicket.status !== "resolved" && (_jsxs(Div, { className: "flex flex-col gap-1", children: [_jsx("label", { className: "text-sm font-medium text-zinc-700 dark:text-zinc-300", children: "Reply" }), _jsx("textarea", { value: replyBody, onChange: (e) => setReplyBody(e.target.value), rows: 3, placeholder: "Add a message to your ticket\u2026", className: "w-full rounded-lg border border-zinc-300 dark:border-zinc-700 bg-white dark:bg-zinc-800 px-3 py-2 text-sm text-zinc-900 dark:text-zinc-100 placeholder-zinc-400 focus:outline-none focus:ring-2 focus:ring-primary-500" }), _jsx(Button, { type: "button", variant: "primary", size: "sm", isLoading: replyMutation.isPending, disabled: !replyBody.trim() || replyMutation.isPending, onClick: () => replyMutation.mutate(), children: "Send reply" })] }))] })) })] }));
+    return (_jsxs(_Fragment, { children: [_jsxs(Div, { className: "mx-auto max-w-2xl px-4 py-6", children: [_jsxs(Div, { className: "mb-4 flex items-center justify-between", children: [_jsx(Text, { className: "text-xl font-semibold text-zinc-900 dark:text-zinc-100", children: "Support Tickets" }), _jsx(Button, { type: "button", variant: "primary", size: "sm", onClick: () => setNewTicketOpen(true), children: "New ticket" })] }), renderTicketListArea({ isLoading, error, tickets, setSelectedTicket, setDetailOpen })] }), renderNewTicketDrawer({ newTicketOpen, setNewTicketOpen, newCategory, setNewCategory, newSubject, setNewSubject, newOrderId, setNewOrderId, newDescription, setNewDescription, createMutation }), renderTicketDetailDrawer({ detailOpen, setDetailOpen, selectedTicket, replyBody, setReplyBody, replyMutation })] }));
+}
+function renderTicketListArea(props) {
+    const { isLoading, error, tickets, setSelectedTicket, setDetailOpen } = props;
+    return (_jsxs(_Fragment, { children: [isLoading && (_jsx(Div, { className: "space-y-3", children: [1, 2, 3].map((i) => _jsx("div", { className: "h-16 animate-pulse rounded-lg bg-zinc-100 dark:bg-zinc-800" }, i)) })), error && (_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: "Failed to load support tickets." })), !isLoading && tickets.length === 0 && (_jsx(Div, { className: "rounded-xl border border-zinc-200 bg-zinc-50 px-6 py-10 text-center dark:border-zinc-700 dark:bg-zinc-900/40", children: _jsx(Text, { className: "text-sm text-zinc-500 dark:text-zinc-400", children: "You haven't opened any support tickets yet." }) })), _jsx("ul", { className: "space-y-3", children: tickets.map((ticket) => (_jsx("li", { children: _jsx("button", { type: "button", className: "w-full rounded-xl border border-zinc-200 bg-white p-4 text-left shadow-sm hover:border-primary-300 transition-colors dark:border-zinc-700 dark:bg-zinc-900", onClick: () => { setSelectedTicket(ticket); setDetailOpen(true); }, children: _jsxs("div", { className: "flex items-start justify-between gap-2", children: [_jsxs("div", { className: "min-w-0 flex-1", children: [_jsx(Text, { className: "font-medium text-zinc-900 dark:text-zinc-100 truncate", children: ticket.subject }), _jsxs(Text, { className: "text-xs text-zinc-500 dark:text-zinc-400", children: [ticket.category.replace(/_/g, " "), ticket.orderId ? ` · Order: ${ticket.orderId}` : ""] })] }), _jsx("span", { className: `shrink-0 inline-flex rounded-full px-2.5 py-0.5 text-xs font-medium ${STATUS_BADGE[ticket.status] ?? STATUS_BADGE.open}`, children: ticket.status.replace(/_/g, " ") })] }) }) }, ticket.id))) })] }));
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function renderNewTicketDrawer(props) {
+    const { newTicketOpen, setNewTicketOpen, newCategory, setNewCategory, newSubject, setNewSubject, newOrderId, setNewOrderId, newDescription, setNewDescription, createMutation } = props;
+    return (_jsx(SideDrawer, { isOpen: newTicketOpen, onClose: () => setNewTicketOpen(false), title: "Open a support ticket", children: _jsxs(Div, { className: "flex flex-col gap-4 p-4", children: [_jsx(Select, { label: "Category", options: CATEGORY_OPTIONS, value: newCategory, onValueChange: setNewCategory }), _jsxs(Div, { className: "flex flex-col gap-1", children: [_jsx("label", { className: "text-sm font-medium text-zinc-700 dark:text-zinc-300", children: "Subject" }), _jsx("input", { type: "text", value: newSubject, onChange: (e) => setNewSubject(e.target.value), placeholder: "Brief description of the issue", className: CLS_INPUT })] }), newCategory === "order_issue" && (_jsxs(Div, { className: "flex flex-col gap-1", children: [_jsx("label", { className: "text-sm font-medium text-zinc-700 dark:text-zinc-300", children: "Order ID" }), _jsx("input", { type: "text", value: newOrderId, onChange: (e) => setNewOrderId(e.target.value), placeholder: "e.g. order-3-20260508-a1b2c3", className: CLS_INPUT })] })), _jsxs(Div, { className: "flex flex-col gap-1", children: [_jsx("label", { className: "text-sm font-medium text-zinc-700 dark:text-zinc-300", children: "Description" }), _jsx("textarea", { value: newDescription, onChange: (e) => setNewDescription(e.target.value), rows: 4, placeholder: "Describe the issue in detail\u2026", className: CLS_INPUT })] }), _jsxs(FormActions, { align: "right", children: [_jsx(Button, { type: "button", variant: "secondary", onClick: () => setNewTicketOpen(false), children: "Cancel" }), _jsx(Button, { type: "button", isLoading: createMutation.isPending, disabled: !newSubject.trim() || !newDescription.trim() || createMutation.isPending, onClick: () => createMutation.mutate(), children: "Submit ticket" })] })] }) }));
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function renderTicketDetailDrawer(props) {
+    const { detailOpen, setDetailOpen, selectedTicket, replyBody, setReplyBody, replyMutation } = props;
+    return (_jsx(SideDrawer, { isOpen: detailOpen, onClose: () => setDetailOpen(false), title: selectedTicket?.subject ?? "Ticket", children: selectedTicket && (_jsxs(Div, { className: "flex flex-col gap-4 p-4", children: [_jsxs(Div, { className: "flex flex-wrap gap-2", children: [_jsx("span", { className: `inline-flex rounded-full px-2.5 py-1 text-xs font-medium ${STATUS_BADGE[selectedTicket.status] ?? STATUS_BADGE.open}`, children: selectedTicket.status.replace(/_/g, " ") }), _jsx("span", { className: "rounded-full bg-zinc-100 px-2.5 py-1 text-xs text-zinc-600 dark:bg-zinc-800 dark:text-zinc-300", children: selectedTicket.category.replace(/_/g, " ") }), selectedTicket.orderId && _jsxs("span", { className: "rounded-full bg-zinc-100 px-2.5 py-1 text-xs text-zinc-600 dark:bg-zinc-800 dark:text-zinc-300", children: ["Order: ", selectedTicket.orderId] })] }), selectedTicket.description && (_jsxs(Div, { className: "rounded-lg border border-zinc-200 bg-zinc-50 p-3 dark:border-zinc-700 dark:bg-zinc-900/40", children: [_jsx(Text, { className: "mb-1 text-xs font-semibold text-zinc-500 uppercase tracking-wide", children: "Your description" }), _jsx(Text, { className: "whitespace-pre-wrap text-sm text-zinc-700 dark:text-zinc-200", children: selectedTicket.description })] })), (selectedTicket.messages ?? []).length > 0 && (_jsxs(Div, { className: "space-y-2", children: [_jsx(Text, { className: "text-xs font-semibold text-zinc-500 uppercase tracking-wide", children: "Messages" }), _jsx("div", { className: "space-y-2 max-h-72 overflow-y-auto", children: (selectedTicket.messages ?? []).map((msg, i) => (_jsxs("div", { className: `rounded-lg p-3 text-sm ${msg.authorRole === "user" ? "bg-zinc-50 border border-zinc-200 dark:bg-zinc-900/40 dark:border-zinc-700" : "bg-blue-50 border border-blue-200 dark:bg-blue-900/20 dark:border-blue-800"}`, children: [_jsxs("div", { className: "mb-1 flex items-center gap-2 text-xs text-zinc-400 dark:text-zinc-500", children: [_jsx("span", { className: "font-medium text-zinc-600 dark:text-zinc-300", children: ROLE_LABEL[msg.authorRole ?? "user"] ?? msg.authorRole }), msg.createdAt && _jsx("span", { children: new Date(msg.createdAt).toLocaleString() })] }), _jsx(Text, { className: "whitespace-pre-wrap text-zinc-700 dark:text-zinc-200", children: msg.body })] }, msg.id ?? i))) })] })), selectedTicket.status !== "closed" && selectedTicket.status !== "resolved" && (_jsxs(Div, { className: "flex flex-col gap-1", children: [_jsx("label", { className: "text-sm font-medium text-zinc-700 dark:text-zinc-300", children: "Reply" }), _jsx("textarea", { value: replyBody, onChange: (e) => setReplyBody(e.target.value), rows: 3, placeholder: "Add a message to your ticket\u2026", className: CLS_INPUT }), _jsx(Button, { type: "button", variant: "primary", size: "sm", isLoading: replyMutation.isPending, disabled: !replyBody.trim() || replyMutation.isPending, onClick: () => replyMutation.mutate(), children: "Send reply" })] }))] })) }));
 }

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

@@ -40,3 +40,5 @@ export { UserReturnsView } from "./UserReturnsView";
 export type { UserReturnsViewProps, UserReturnsViewLabels, } from "./UserReturnsView";
 export { UserSupportView } from "./UserSupportView";
 export type { UserSupportViewProps } from "./UserSupportView";
+export { NotificationPreferencesPanel } from "./NotificationPreferencesPanel";
+export type { NotificationPreferencesPanelProps } from "./NotificationPreferencesPanel";

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

@@ -19,3 +19,4 @@ export { BecomeSellerView } from "./BecomeSellerView";
 export { UserOrderTrackView } from "./UserOrderTrackView";
 export { UserReturnsView } from "./UserReturnsView";
 export { UserSupportView } from "./UserSupportView";
+export { NotificationPreferencesPanel } from "./NotificationPreferencesPanel";

package/dist/features/account/schemas/index.d.ts

@@ -132,6 +132,7 @@ export declare const userProfileSchema: z.ZodObject<{
     updatedAt?: string | undefined;
     displayName?: string | undefined;
     email?: string | undefined;
+    phone?: string | undefined;
     addresses?: {
         country: string;
         id: string;
@@ -145,8 +146,6 @@ export declare const userProfileSchema: z.ZodObject<{
         line2?: string | undefined;
     }[] | undefined;
     photoURL?: string | undefined;
-    phone?: string | undefined;
-    bio?: string | undefined;
     notificationPreferences?: {
         push?: boolean | undefined;
         promotions?: boolean | undefined;
@@ -154,12 +153,14 @@ export declare const userProfileSchema: z.ZodObject<{
         orderUpdates?: boolean | undefined;
         sms?: boolean | undefined;
     } | undefined;
+    bio?: string | undefined;
 }, {
     id: string;
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     displayName?: string | undefined;
     email?: string | undefined;
+    phone?: string | undefined;
     addresses?: {
         country: string;
         id: string;
@@ -173,8 +174,6 @@ export declare const userProfileSchema: z.ZodObject<{
         line2?: string | undefined;
     }[] | undefined;
     photoURL?: string | undefined;
-    phone?: string | undefined;
-    bio?: string | undefined;
     notificationPreferences?: {
         push?: boolean | undefined;
         promotions?: boolean | undefined;
@@ -182,6 +181,7 @@ export declare const userProfileSchema: z.ZodObject<{
         orderUpdates?: boolean | undefined;
         sms?: boolean | undefined;
     } | undefined;
+    bio?: string | undefined;
 }>;
 export declare const updateProfileSchema: z.ZodObject<{
     displayName: z.ZodOptional<z.ZodString>;

package/dist/features/account/types/index.d.ts

@@ -57,11 +57,45 @@ export interface UserAddress {
     isDefault?: boolean;
     phone?: string;
 }
+/**
+ * Per-channel on/off toggles at the user level.
+ * Channels are only surfaced in the UI when the admin has enabled them in
+ * siteSettings.notificationChannels — this is enforced on the server side.
+ */
+export interface NotificationChannelPrefs {
+    /** Disable all email notifications for this user (default: true = enabled). */
+    email?: boolean;
+    /** Disable all WhatsApp notifications for this user. */
+    whatsapp?: boolean;
+    /** Disable all SMS notifications for this user. */
+    sms?: boolean;
+}
+/**
+ * Per notification-type on/off controls.  `true` = enabled (default when absent).
+ */
+export interface NotificationTypePrefs {
+    orderUpdates?: boolean;
+    bids?: boolean;
+    promotions?: boolean;
+    system?: boolean;
+    reviews?: boolean;
+    messages?: boolean;
+    offers?: boolean;
+}
 export interface NotificationPreferences {
+    /** Per-channel global toggles (user can silence a whole channel). */
+    channels?: NotificationChannelPrefs;
+    /** Per notification-type toggles (user can silence specific event classes). */
+    types?: NotificationTypePrefs;
+    /** @deprecated Use types.orderUpdates */
     orderUpdates?: boolean;
+    /** @deprecated Use types.promotions */
     promotions?: boolean;
+    /** @deprecated Use channels.sms */
     newsletter?: boolean;
+    /** @deprecated Use channels.sms */
     sms?: boolean;
+    /** Push notifications reserved for future use. */
     push?: boolean;
 }
 export interface UserProfile {

package/dist/features/admin/actions/admin-actions.js

@@ -12,6 +12,7 @@ import { userRepository } from "../../auth/repository/user.repository";
 import { productRepository } from "../../products/repository/products.repository";
 import { NotFoundError, ValidationError } from "../../../errors";
 import { getProviders } from "../../../contracts";
+const ERR_UID_REQUIRED = "uid is required";
 export async function revokeSession(adminId, sessionId) {
     if (!sessionId?.trim()) {
         throw new ValidationError("sessionId is required");
@@ -83,7 +84,7 @@ export async function adminUpdatePayout(adminId, id, input) {
 }
 export async function adminUpdateUser(adminId, uid, input) {
     if (!uid?.trim()) {
-        throw new ValidationError("uid is required");
+        throw new ValidationError(ERR_UID_REQUIRED);
     }
     const existing = await userRepository.findById(uid);
     if (!existing) {
@@ -109,7 +110,7 @@ export async function adminUpdateUser(adminId, uid, input) {
 }
 export async function adminDeleteUser(adminId, uid) {
     if (!uid?.trim()) {
-        throw new ValidationError("uid is required");
+        throw new ValidationError(ERR_UID_REQUIRED);
     }
     if (uid === adminId) {
         throw new ValidationError("Cannot delete your own account");
@@ -127,7 +128,7 @@ export async function adminDeleteUser(adminId, uid) {
 export async function adminUpdateStoreStatus(adminId, input) {
     const { uid, action } = input;
     if (!uid?.trim()) {
-        throw new ValidationError("uid is required");
+        throw new ValidationError(ERR_UID_REQUIRED);
     }
     const user = await userRepository.findById(uid);
     if (!user) {

package/dist/features/admin/actions/notification-actions.d.ts

@@ -1,31 +1,33 @@
-/**
- * Notification Domain Actions (appkit)
- *
- * Pure business functions — auth, rate-limiting, and Next.js specifics
- * are handled by the calling server action in the consumer.
- */
-import type { NotificationDocument } from "../schemas";
-/**
- * Mark a single notification as read.
- */
+import type { NotificationDocument, NotificationCreateInput } from "../schemas";
 export declare function markNotificationRead(id: string): Promise<void>;
-/**
- * Mark all notifications as read for a given user.
- * Returns the number of notifications updated.
- */
 export declare function markAllNotificationsRead(userId: string): Promise<number>;
-/**
- * Delete a single notification by id.
- */
 export declare function deleteNotification(id: string): Promise<void>;
-/**
- * List notifications for a user with unread count.
- */
 export declare function listNotifications(userId: string, limit?: number): Promise<{
     notifications: NotificationDocument[];
     unreadCount: number;
 }>;
+export declare function getUnreadNotificationCount(userId: string): Promise<number>;
+export interface SendNotificationInput extends NotificationCreateInput {
+    /** User's email — used by the email channel when enabled. */
+    userEmail?: string;
+    /** User's phone with country code, digits only — used by WhatsApp channel. */
+    userPhone?: string;
+    /** Pre-rendered email HTML — falls back to a plain-text <p> when absent. */
+    emailHtml?: string;
+}
+export interface SendNotificationResult {
+    notification: NotificationDocument;
+    email: "sent" | "skipped" | "failed";
+    whatsapp: "sent" | "skipped" | "failed";
+}
 /**
- * Get the unread notification count for a user.
+ * Create an in-app notification and fan out to enabled external channels.
+ *
+ * In-app is always written.  Email / WhatsApp are sent only when:
+ *   1. The channel is enabled in siteSettings.notificationChannels
+ *   2. Notification priority meets the channel's minPriority threshold
+ *   3. The optional `types` filter includes this notification type (or is absent)
+ *   4. The contact field (userEmail / userPhone) is supplied by the caller
+ *   5. The required credentials are set in siteSettings.credentials
  */
-export declare function getUnreadNotificationCount(userId: string): Promise<number>;
+export declare function sendNotification(input: SendNotificationInput): Promise<SendNotificationResult>;