@mohasinac/appkit 2.7.27 → 2.7.31

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>;

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

@@ -1,32 +1,19 @@
-/**
- * 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 { notificationRepository } from "../repository/notification.repository";
-/**
- * Mark a single notification as read.
- */
+import { siteSettingsRepository } from "../repository/site-settings.repository";
+import { userRepository } from "../../auth/repository/user.repository";
+import { createResendProvider } from "../../../providers/email-resend/provider";
+import { sendWhatsAppBusinessMessage } from "../../whatsapp-bot/helpers/whatsapp";
+import { serverLogger } from "../../../monitoring";
+import { DEFAULT_NOTIFICATION_CHANNELS, meetsMinPriority, } from "../schemas/firestore";
 export async function markNotificationRead(id) {
     await notificationRepository.markAsRead(id);
 }
-/**
- * Mark all notifications as read for a given user.
- * Returns the number of notifications updated.
- */
 export async function markAllNotificationsRead(userId) {
     return notificationRepository.markAllAsRead(userId);
 }
-/**
- * Delete a single notification by id.
- */
 export async function deleteNotification(id) {
     await notificationRepository.delete(id);
 }
-/**
- * List notifications for a user with unread count.
- */
 export async function listNotifications(userId, limit = 20) {
     const [notifications, unreadCount] = await Promise.all([
         notificationRepository.findByUser(userId, limit),
@@ -34,9 +21,122 @@ export async function listNotifications(userId, limit = 20) {
     ]);
     return { notifications, unreadCount };
 }
-/**
- * Get the unread notification count for a user.
- */
 export async function getUnreadNotificationCount(userId) {
     return notificationRepository.getUnreadCount(userId);
 }
+/**
+ * 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 async function sendNotification(input) {
+    const { userEmail, userPhone, emailHtml, ...notifInput } = input;
+    // Always write the in-app notification first.
+    const notification = await notificationRepository.create(notifInput);
+    // Load channel config + credentials (one Firestore read).
+    let settings;
+    try {
+        settings = await siteSettingsRepository.getSingleton();
+    }
+    catch (err) {
+        serverLogger.warn("sendNotification: could not load siteSettings — skipping external channels", { err });
+        return { notification, email: "skipped", whatsapp: "skipped" };
+    }
+    const channels = settings.notificationChannels ?? DEFAULT_NOTIFICATION_CHANNELS;
+    const creds = settings.credentials ?? {};
+    const { type, priority, title, message } = notifInput;
+    // Load user notification preferences (best-effort — if missing, all channels allowed).
+    let userChannelPrefs = {};
+    let userTypePrefs = {};
+    try {
+        const userDoc = await userRepository.findById(input.userId);
+        userChannelPrefs = userDoc?.notificationPreferences?.channels ?? {};
+        userTypePrefs = userDoc?.notificationPreferences?.types ?? {};
+    }
+    catch {
+        // non-fatal: fall through with empty prefs (all enabled)
+    }
+    // Map NotificationType to a NotificationTypePrefs key.
+    const typeToPrefsKey = {
+        order_placed: "orderUpdates", order_confirmed: "orderUpdates",
+        order_shipped: "orderUpdates", order_delivered: "orderUpdates",
+        order_cancelled: "orderUpdates",
+        bid_placed: "bids", bid_outbid: "bids", bid_won: "bids", bid_lost: "bids",
+        review_approved: "reviews", review_replied: "reviews",
+        promotion: "promotions",
+        system: "system", welcome: "system",
+        offer_received: "offers", offer_responded: "offers",
+        offer_expired: "offers", offer_counter_accepted: "offers",
+        refund_initiated: "orderUpdates",
+        product_available: "system",
+    };
+    const typeKey = typeToPrefsKey[type];
+    // If the user has explicitly disabled this notification type, skip all external channels.
+    if (typeKey && userTypePrefs[typeKey] === false) {
+        return { notification, email: "skipped", whatsapp: "skipped" };
+    }
+    // Email channel — admin enabled AND user hasn't opted out
+    let emailStatus = "skipped";
+    if (channels.email.enabled &&
+        userChannelPrefs.email !== false &&
+        userEmail &&
+        meetsMinPriority(priority, channels.email.minPriority) &&
+        (!channels.email.types?.length || channels.email.types.includes(type))) {
+        const apiKey = creds.resendApiKey?.trim() ?? "";
+        const fromEmail = settings.emailSettings?.fromEmail ?? "noreply@letitrip.in";
+        const fromName = settings.emailSettings?.fromName ?? "LetItRip";
+        if (apiKey && !apiKey.includes("PLACEHOLDER")) {
+            try {
+                const emailProvider = createResendProvider({ apiKey, fromEmail, fromName });
+                await emailProvider.send({
+                    to: userEmail,
+                    subject: title,
+                    html: emailHtml ?? `<p>${message}</p>`,
+                    text: message,
+                });
+                emailStatus = "sent";
+            }
+            catch (err) {
+                serverLogger.error("sendNotification: email dispatch failed", { userId: input.userId, err });
+                emailStatus = "failed";
+            }
+        }
+    }
+    // WhatsApp channel — admin enabled AND user hasn't opted out
+    let whatsappStatus = "skipped";
+    if (channels.whatsapp.enabled &&
+        userChannelPrefs.whatsapp !== false &&
+        userPhone &&
+        meetsMinPriority(priority, channels.whatsapp.minPriority) &&
+        (!channels.whatsapp.types?.length || channels.whatsapp.types.includes(type))) {
+        const phoneNumberId = creds.whatsappPhoneNumberId?.trim() ?? "";
+        const accessToken = creds.whatsappCloudApiToken?.trim() ?? "";
+        if (phoneNumberId && accessToken) {
+            try {
+                const ok = await sendWhatsAppBusinessMessage({
+                    toPhone: userPhone,
+                    message: `*${title}*\n${message}`,
+                    phoneNumberId,
+                    accessToken,
+                });
+                whatsappStatus = ok ? "sent" : "failed";
+            }
+            catch (err) {
+                serverLogger.error("sendNotification: WhatsApp dispatch failed", { userId: input.userId, err });
+                whatsappStatus = "failed";
+            }
+        }
+    }
+    serverLogger.info("sendNotification: dispatched", {
+        userId: input.userId,
+        type,
+        email: emailStatus,
+        whatsapp: whatsappStatus,
+    });
+    return { notification, email: emailStatus, whatsapp: whatsappStatus };
+}

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

@@ -5,6 +5,27 @@ import { useMutation, useQuery } from "@tanstack/react-query";
 import { Alert, Button, Form, FormActions, Input, Select, StackedViewShell, Text, Toggle, useToast, } from "../../../ui";
 import { apiClient } from "../../../http";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
+function validateThirdPartyUrl(url, issues) {
+    if (!url.trim()) {
+        issues.push("Third-party ads require a third-party URL");
+        return;
+    }
+    try {
+        const parsed = new URL(url.trim());
+        if (parsed.protocol !== "https:") {
+            issues.push("Third-party ad URL must be https");
+        }
+    }
+    catch {
+        issues.push("Third-party ad URL must be a valid URL");
+    }
+}
+function renderAdScheduleSection({ startAt, setStartAt, endAt, setEndAt }) {
+    return (_jsxs("div", { className: "grid grid-cols-1 md:grid-cols-2 gap-3", "data-section": "adminadeditorview-div-238", children: [_jsx(Input, { label: "Start at (ISO)", value: startAt, onChange: (event) => setStartAt(event.target.value), placeholder: "2026-05-01T00:00:00.000Z" }), _jsx(Input, { label: "End at (ISO)", value: endAt, onChange: (event) => setEndAt(event.target.value), placeholder: "2026-05-30T23:59:59.000Z" })] }));
+}
+function renderAdCreativeSection({ title, setTitle, body, setBody, imageUrl, setImageUrl, ctaLabel, setCtaLabel, ctaHref, setCtaHref, adsenseSlot, setAdsenseSlot, thirdPartyUrl, setThirdPartyUrl, provider, }) {
+    return (_jsxs("div", { className: "grid grid-cols-1 md:grid-cols-2 gap-3", "data-section": "adminadeditorview-div-239", children: [_jsx(Input, { label: "Creative title", value: title, onChange: (e) => setTitle(e.target.value), placeholder: "Catch the mega sale" }), _jsx(Input, { label: "Creative body", value: body, onChange: (e) => setBody(e.target.value), placeholder: "Up to 40% off this weekend" }), _jsx(Input, { label: "Image URL", value: imageUrl, onChange: (e) => setImageUrl(e.target.value), placeholder: "https://..." }), _jsx(Input, { label: "CTA label", value: ctaLabel, onChange: (e) => setCtaLabel(e.target.value), placeholder: "Shop now" }), _jsx(Input, { label: "CTA URL", value: ctaHref, onChange: (e) => setCtaHref(e.target.value), placeholder: "/promotions/deals" }), provider === "adsense" ? (_jsx(Input, { label: "AdSense slot", value: adsenseSlot, onChange: (e) => setAdsenseSlot(e.target.value), placeholder: "1234567890" })) : null, provider === "thirdParty" ? (_jsx(Input, { label: "Third-party URL", value: thirdPartyUrl, onChange: (e) => setThirdPartyUrl(e.target.value), placeholder: "https://adnetwork.example/slot" })) : null] }));
+}
 export function AdminAdEditorView({ adId, endpointBase = ADMIN_ENDPOINTS.ADS, labels = {}, onSaved, ...rest }) {
     const [name, setName] = React.useState("");
     const [provider, setProvider] = React.useState("manual");
@@ -157,20 +178,7 @@ export function AdminAdEditorView({ adId, endpointBase = ADMIN_ENDPOINTS.ADS, la
             }
         }
         if (provider === "thirdParty") {
-            if (!thirdPartyUrl.trim()) {
-                issues.push("Third-party ads require a third-party URL");
-            }
-            else {
-                try {
-                    const parsed = new URL(thirdPartyUrl.trim());
-                    if (parsed.protocol !== "https:") {
-                        issues.push("Third-party ad URL must be https");
-                    }
-                }
-                catch {
-                    issues.push("Third-party ad URL must be a valid URL");
-                }
-            }
+            validateThirdPartyUrl(thirdPartyUrl, issues);
             if (!providerCredentialStatus?.hasThirdPartyScriptUrl) {
                 issues.push("Third-party provider script URL is missing in ad settings");
             }
@@ -200,6 +208,12 @@ export function AdminAdEditorView({ adId, endpointBase = ADMIN_ENDPOINTS.ADS, la
             ? prev.filter((id) => id !== placementId)
             : [...prev, placementId]);
     };
+    const scheduleSection = renderAdScheduleSection({ startAt, setStartAt, endAt, setEndAt });
+    const creativeSection = renderAdCreativeSection({
+        title, setTitle, body, setBody, imageUrl, setImageUrl,
+        ctaLabel, setCtaLabel, ctaHref, setCtaHref,
+        adsenseSlot, setAdsenseSlot, thirdPartyUrl, setThirdPartyUrl, provider,
+    });
     return (_jsx(StackedViewShell, { portal: "admin", ...rest, title: labels.title ?? (adId ? "Edit Ad" : "Create Ad"), sections: [
             metaQuery.error ? (_jsx(Alert, { variant: "error", title: "Could not load ad metadata", children: metaQuery.error instanceof Error ? metaQuery.error.message : "Unknown error" })) : null,
             adQuery.error ? (_jsx(Alert, { variant: "error", title: "Could not load ad", children: adQuery.error instanceof Error ? adQuery.error.message : "Unknown error" })) : null,
@@ -219,6 +233,6 @@ export function AdminAdEditorView({ adId, endpointBase = ADMIN_ENDPOINTS.ADS, la
                                     { label: "Active", value: "active" },
                                     { label: "Scheduled", value: "scheduled" },
                                     { label: "Paused", value: "paused" },
-                                ], onChange: (event) => setStatus(event.target.value) }), _jsx(Input, { label: "Priority", type: "number", value: String(priority), onChange: (event) => setPriority(Number(event.target.value || 0)) })] }), _jsx(Toggle, { checked: requiresConsent, onChange: setRequiresConsent, label: "Require user ad-consent for this ad" }), _jsxs("div", { className: "space-y-2", "data-section": "adminadeditorview-div-236", children: [_jsx(Text, { className: "text-sm font-medium", children: "Placements" }), _jsx("div", { className: "grid grid-cols-1 md:grid-cols-2 gap-2", "data-section": "adminadeditorview-div-237", children: placements.map((placement) => (_jsxs("label", { className: "flex items-center gap-2 rounded-md border border-neutral-200 dark:border-slate-700 px-3 py-2", children: [_jsx("input", { type: "checkbox", checked: selectedPlacements.includes(placement.id), onChange: () => togglePlacement(placement.id) }), _jsx("span", { className: "text-sm", children: placement.label })] }, placement.id))) })] }), _jsxs("div", { className: "grid grid-cols-1 md:grid-cols-2 gap-3", "data-section": "adminadeditorview-div-238", children: [_jsx(Input, { label: "Start at (ISO)", value: startAt, onChange: (event) => setStartAt(event.target.value), placeholder: "2026-05-01T00:00:00.000Z" }), _jsx(Input, { label: "End at (ISO)", value: endAt, onChange: (event) => setEndAt(event.target.value), placeholder: "2026-05-30T23:59:59.000Z" })] }), _jsxs("div", { className: "grid grid-cols-1 md:grid-cols-2 gap-3", "data-section": "adminadeditorview-div-239", children: [_jsx(Input, { label: "Creative title", value: title, onChange: (event) => setTitle(event.target.value), placeholder: "Catch the mega sale" }), _jsx(Input, { label: "Creative body", value: body, onChange: (event) => setBody(event.target.value), placeholder: "Up to 40% off this weekend" }), _jsx(Input, { label: "Image URL", value: imageUrl, onChange: (event) => setImageUrl(event.target.value), placeholder: "https://..." }), _jsx(Input, { label: "CTA label", value: ctaLabel, onChange: (event) => setCtaLabel(event.target.value), placeholder: "Shop now" }), _jsx(Input, { label: "CTA URL", value: ctaHref, onChange: (event) => setCtaHref(event.target.value), placeholder: "/promotions/deals" }), provider === "adsense" ? (_jsx(Input, { label: "AdSense slot", value: adsenseSlot, onChange: (event) => setAdsenseSlot(event.target.value), placeholder: "1234567890" })) : null, provider === "thirdParty" ? (_jsx(Input, { label: "Third-party URL", value: thirdPartyUrl, onChange: (event) => setThirdPartyUrl(event.target.value), placeholder: "https://adnetwork.example/slot" })) : null] }), _jsxs("div", { className: "rounded-lg border border-neutral-200 dark:border-slate-700 p-3", "data-section": "adminadeditorview-div-240", children: [_jsx(Text, { className: "text-sm font-medium mb-1", children: "Preview" }), _jsx(Text, { className: "text-xs text-neutral-500 dark:text-zinc-400", children: title || name || "Untitled ad" }), body ? _jsx(Text, { className: "text-sm mt-1", children: body }) : null, ctaLabel ? _jsxs(Text, { className: "text-xs mt-1", children: ["CTA: ", ctaLabel, " (", ctaHref || "#", ")"] }) : null] }), publishHardeningRequired && publishIssues.length > 0 ? (_jsx(Alert, { variant: "warning", title: "Publish readiness issues", children: publishIssues.join("; ") })) : null, _jsx(FormActions, { align: "right", children: _jsx(Button, { type: "submit", disabled: saveMutation.isPending || blockedByPublishValidation || !name.trim() || selectedPlacements.length === 0, children: saveMutation.isPending ? "Saving..." : status === "active" ? "Publish ad" : adId ? "Save changes" : "Create ad" }) })] }),
+                                ], onChange: (event) => setStatus(event.target.value) }), _jsx(Input, { label: "Priority", type: "number", value: String(priority), onChange: (event) => setPriority(Number(event.target.value || 0)) })] }), _jsx(Toggle, { checked: requiresConsent, onChange: setRequiresConsent, label: "Require user ad-consent for this ad" }), _jsxs("div", { className: "space-y-2", "data-section": "adminadeditorview-div-236", children: [_jsx(Text, { className: "text-sm font-medium", children: "Placements" }), _jsx("div", { className: "grid grid-cols-1 md:grid-cols-2 gap-2", "data-section": "adminadeditorview-div-237", children: placements.map((placement) => (_jsxs("label", { className: "flex items-center gap-2 rounded-md border border-neutral-200 dark:border-slate-700 px-3 py-2", children: [_jsx("input", { type: "checkbox", checked: selectedPlacements.includes(placement.id), onChange: () => togglePlacement(placement.id) }), _jsx("span", { className: "text-sm", children: placement.label })] }, placement.id))) })] }), scheduleSection, creativeSection, _jsxs("div", { className: "rounded-lg border border-neutral-200 dark:border-slate-700 p-3", "data-section": "adminadeditorview-div-240", children: [_jsx(Text, { className: "text-sm font-medium mb-1", children: "Preview" }), _jsx(Text, { className: "text-xs text-neutral-500 dark:text-zinc-400", children: title || name || "Untitled ad" }), body ? _jsx(Text, { className: "text-sm mt-1", children: body }) : null, ctaLabel ? _jsxs(Text, { className: "text-xs mt-1", children: ["CTA: ", ctaLabel, " (", ctaHref || "#", ")"] }) : null] }), publishHardeningRequired && publishIssues.length > 0 ? (_jsx(Alert, { variant: "warning", title: "Publish readiness issues", children: publishIssues.join("; ") })) : null, _jsx(FormActions, { align: "right", children: _jsx(Button, { type: "submit", disabled: saveMutation.isPending || blockedByPublishValidation || !name.trim() || selectedPlacements.length === 0, children: saveMutation.isPending ? "Saving..." : status === "active" ? "Publish ad" : adId ? "Save changes" : "Create ad" }) })] }),
         ] }));
 }

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

@@ -0,0 +1,7 @@
+import type { StackedViewShellProps } from "../../../ui";
+export interface AdminAddressEditorViewProps extends Omit<StackedViewShellProps, "sections"> {
+    addressId?: string;
+    onSaved?: (id: string) => void;
+    onDeleted?: () => void;
+}
+export declare function AdminAddressEditorView({ addressId, onSaved, onDeleted, ...rest }: AdminAddressEditorViewProps): import("react/jsx-runtime").JSX.Element;