@mohasinac/appkit 4.1.3 → 4.2.0

package/dist/features/admin/schemas/firestore.js

@@ -189,6 +189,13 @@ export const DEFAULT_SITE_SETTINGS_DATA = {
         codDepositPercent: 10,
         codHandlingFeeMin: 200,
         codHandlingFeePercent: 10,
+        whatsappNotifyFeeEnabled: false,
+        whatsappNotifyFee: 10,
+        giftWrapFeeEnabled: false,
+        giftWrapFee: 49,
+        shipmentProtectionFeeEnabled: false,
+        shipmentProtectionFeePercent: 2,
+        shipmentProtectionFeeMin: 30,
         sellerShippingFixed: 0,
         platformShippingPercent: 10,
         platformShippingFixedMin: 0,
@@ -284,61 +291,92 @@ export const DEFAULT_TRUST_BAR_ITEMS = [
     { icon: "??", label: "24/7 Support", visible: true },
     { icon: "?", label: "Authentic Sellers", visible: true },
 ];
+// NOTE: labelKey/descKey hold plain display text (not i18n message keys) —
+// this feature-flag list has no matching next-intl namespace, so the admin
+// UI reads these two fields directly rather than through getTranslations().
 export const FEATURE_FLAG_META = [
     {
         key: "chats",
-        labelKey: "chats",
-        descKey: "chatsDesc",
-        icon: "??",
+        labelKey: "In-app chats",
+        descKey: "Buyer/seller direct messaging.",
+        icon: "\u{1F4AC}",
         category: "platform",
     },
     {
         key: "smsVerification",
-        labelKey: "smsVerification",
-        descKey: "smsVerificationDesc",
-        icon: "??",
+        labelKey: "SMS verification",
+        descKey: "Phone-number OTP verification during signup/checkout.",
+        icon: "\u{1F4F1}",
         category: "platform",
     },
     {
         key: "translations",
-        labelKey: "translations",
-        descKey: "translationsDesc",
-        icon: "??",
+        labelKey: "Translations",
+        descKey: "Locale switcher and translated UI strings.",
+        icon: "\u{1F310}",
         category: "platform",
     },
     {
         key: "auctions",
-        labelKey: "auctions",
-        descKey: "auctionsDesc",
-        icon: "??",
+        labelKey: "Auctions",
+        descKey: "Auction listings and bidding.",
+        icon: "\u{1F528}",
         category: "platform",
     },
     {
         key: "reviews",
-        labelKey: "reviews",
-        descKey: "reviewsDesc",
-        icon: "?",
+        labelKey: "Reviews",
+        descKey: "Product and store reviews.",
+        icon: "⭐",
         category: "platform",
     },
     {
         key: "notifications",
-        labelKey: "notifications",
-        descKey: "notificationsDesc",
-        icon: "??",
+        labelKey: "Notifications",
+        descKey: "In-app notification bell and inbox.",
+        icon: "\u{1F514}",
         category: "platform",
     },
     {
         key: "sellerRegistration",
-        labelKey: "sellerRegistration",
-        descKey: "sellerRegistrationDesc",
-        icon: "??",
+        labelKey: "Seller registration",
+        descKey: "\"Become a seller\" signup flow.",
+        icon: "\u{1F3EA}",
         category: "platform",
     },
     {
         key: "preOrders",
-        labelKey: "preOrders",
-        descKey: "preOrdersDesc",
-        icon: "??",
+        labelKey: "Pre-orders",
+        descKey: "Pre-order listings and deposit checkout.",
+        icon: "\u{1F4E6}",
+        category: "platform",
+    },
+    {
+        key: "wishlists",
+        labelKey: "Wishlists",
+        descKey: "Save-for-later wishlist feature.",
+        icon: "❤️",
+        category: "platform",
+    },
+    {
+        key: "events",
+        labelKey: "Events",
+        descKey: "Sales, raffles, spin-wheel, and lottery events.",
+        icon: "\u{1F389}",
+        category: "platform",
+    },
+    {
+        key: "blog",
+        labelKey: "Blog",
+        descKey: "Blog posts section.",
+        icon: "\u{1F4DD}",
+        category: "platform",
+    },
+    {
+        key: "coupons",
+        labelKey: "Coupons",
+        descKey: "Coupon codes and discounts.",
+        icon: "\u{1F3AB}",
         category: "platform",
     },
 ];

package/dist/features/layout/BackToTop.d.ts

@@ -7,11 +7,15 @@ export interface BackToTopProps {
 /**
  * BackToTop — floating scroll-to-top button.
  * Appears after the page has scrolled past `threshold` pixels. A small
- * dismiss control lets the user hide it for the rest of the browser
- * session (sessionStorage) — on narrow viewports it can sit close enough
- * to the bottom nav / other floating controls to feel like clutter, so it
- * needs the same "get out of my way" escape hatch as StickyToolbar.
- * Re-appears on the next page load.
+ * dismiss control hides it for the current page view only — dismissal is
+ * plain in-memory component state, reset on every route change (via
+ * `usePathname()`) so navigating anywhere brings it back. Deliberately NOT
+ * persisted to storage: an earlier version wrote the dismissal to
+ * `sessionStorage`, and because this component is mounted once inside the
+ * persistent `AppLayoutShell` (it never remounts on client-side navigation),
+ * that meant one click hid the button for the rest of the browser tab
+ * session with no way to bring it back — reported as "the button is gone
+ * forever." See CLAUDE.md Recurrent Root Cause Patterns.
  */
 export declare function BackToTop({ threshold, ariaLabel, className, }: BackToTopProps): import("react").JSX.Element | null;
 /** SkipToMain — visually hidden link that becomes visible on focus for keyboard users. */

package/dist/features/layout/BackToTop.js

@@ -1,46 +1,42 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import Link from "next/link";
+import { usePathname } from "next/navigation";
 import { useEffect, useState } from "react";
 import { ChevronUp, X } from "lucide-react";
 import { Button, Div } from "../../ui";
-import { normalizeError } from "../../errors/normalize";
-const DISMISSED_KEY = "appkit:back-to-top-dismissed";
 /**
  * BackToTop — floating scroll-to-top button.
  * Appears after the page has scrolled past `threshold` pixels. A small
- * dismiss control lets the user hide it for the rest of the browser
- * session (sessionStorage) — on narrow viewports it can sit close enough
- * to the bottom nav / other floating controls to feel like clutter, so it
- * needs the same "get out of my way" escape hatch as StickyToolbar.
- * Re-appears on the next page load.
+ * dismiss control hides it for the current page view only — dismissal is
+ * plain in-memory component state, reset on every route change (via
+ * `usePathname()`) so navigating anywhere brings it back. Deliberately NOT
+ * persisted to storage: an earlier version wrote the dismissal to
+ * `sessionStorage`, and because this component is mounted once inside the
+ * persistent `AppLayoutShell` (it never remounts on client-side navigation),
+ * that meant one click hid the button for the rest of the browser tab
+ * session with no way to bring it back — reported as "the button is gone
+ * forever." See CLAUDE.md Recurrent Root Cause Patterns.
  */
 export function BackToTop({ threshold = 400, ariaLabel = "Back to top", className = "", }) {
+    const pathname = usePathname();
     const [visible, setVisible] = useState(false);
     const [dismissed, setDismissed] = useState(false);
     useEffect(() => {
-        try {
-            setDismissed(window.sessionStorage.getItem(DISMISSED_KEY) === "1");
-        }
-        catch (_err) {
-            void normalizeError(_err);
-            // sessionStorage unavailable — never dismissed for this render.
-        }
         const handleScroll = () => setVisible(window.scrollY > threshold);
         window.addEventListener("scroll", handleScroll, { passive: true });
         return () => window.removeEventListener("scroll", handleScroll);
     }, [threshold]);
+    // Reset dismissal on every route change — the component itself never
+    // unmounts (it lives inside the persistent app shell), so without this
+    // a single dismiss would otherwise hide the button for the whole session.
+    useEffect(() => {
+        setDismissed(false);
+    }, [pathname]);
     if (!visible || dismissed)
         return null;
     const handleDismiss = () => {
         setDismissed(true);
-        try {
-            window.sessionStorage.setItem(DISMISSED_KEY, "1");
-        }
-        catch (_err) {
-            void normalizeError(_err);
-            // sessionStorage unavailable — dismissal still applies for this render.
-        }
     };
     return (_jsxs(Div, { layout: "flex", align: "center", gap: "1", className: `fixed bottom-[calc(var(--keyboard-inset-height,0px)+var(--bottom-nav-height,4rem))] right-4 z-[var(--appkit-z-bottom-nav)] ${className}`, children: [_jsx(Button, { type: "button", variant: "outline", size: "sm", "aria-label": ariaLabel, onClick: () => window.scrollTo({ top: 0, behavior: "smooth" }), className: "flex items-center justify-center w-10 h-10 rounded-full bg-[var(--appkit-color-surface)] border border-[var(--appkit-color-border)] shadow-md text-[var(--appkit-color-text-muted)] hover:bg-[var(--appkit-color-surface)] dark:hover:bg-slate-700 transition-colors", children: _jsx(ChevronUp, { className: "w-5 h-5", "aria-hidden": "true" }) }), _jsx(Button, { type: "button", variant: "outline", size: "sm", "aria-label": "Hide back-to-top button", onClick: handleDismiss, className: "flex items-center justify-center w-6 h-6 rounded-full bg-[var(--appkit-color-surface)] border border-[var(--appkit-color-border)] shadow-md text-[var(--appkit-color-text-faint)] hover:text-[var(--appkit-color-text)] transition-colors", children: _jsx(X, { className: "w-3 h-3", "aria-hidden": "true" }) })] }));
 }

package/dist/features/orders/actions/refund-actions.js

@@ -49,6 +49,7 @@ export async function issuePartialRefund(adminUid, orderId, deductFees, refundNo
             : `Your full refund of ₹${grossRefund} is being processed.`,
         relatedId: orderId,
         relatedType: "order",
+        orderWhatsappAddonPaid: order.whatsappNotifyAddon === true,
     });
     serverLogger.info("Admin partial refund initiated", {
         adminUid,

package/dist/features/orders/schemas/firestore.d.ts

@@ -183,6 +183,20 @@ export interface OrderDocument extends BaseDocument {
     codRemainingAmount?: number;
     /** COD handling fee charged to the buyer: max(codHandlingFeeMin, subtotal × codHandlingFeePercent / 100). Only set when paymentMethod === "cod". */
     codHandlingFee?: number;
+    /** Buyer opted into WhatsApp order-update messages at checkout (unchecked by default). */
+    whatsappNotifyAddon?: boolean;
+    /** Fee charged for the WhatsApp addon, decimal rupees — snapshot of siteSettings.commissions.whatsappNotifyFee at order time. */
+    whatsappNotifyFee?: number;
+    /** Buyer opted into gift wrapping at checkout (unchecked by default). */
+    giftWrapAddon?: boolean;
+    /** Fee charged for gift wrap, decimal rupees — snapshot of siteSettings.commissions.giftWrapFee at order time. */
+    giftWrapFee?: number;
+    /** Optional buyer-written gift message, shown to the seller for fulfilment. Capped length. */
+    giftWrapMessage?: string;
+    /** Buyer opted into shipment protection (loss/damage insurance) at checkout (unchecked by default). */
+    shipmentProtectionAddon?: boolean;
+    /** Fee charged for shipment protection, decimal rupees — snapshot of siteSettings.commissions.shipmentProtectionFeePercent/Min at order time. */
+    shipmentProtectionFee?: number;
     /** Order subtotal before GST — the amount GST is computed on. */
     taxableAmount?: number;
     /** Total GST charged (cgst + sgst, or igst — never both pairs at once). */

package/dist/features/products/constants/action-defs.d.ts

@@ -280,15 +280,40 @@ export declare const DASHBOARD_QUICK_ACTION_ID: {
     readonly ADMIN_ADD_BLOG: "dqa-admin-add-blog";
     readonly ADMIN_ADD_FAQ: "dqa-admin-add-faq";
     readonly ADMIN_SETTINGS: "dqa-admin-settings";
+    readonly ADMIN_STORES: "dqa-admin-stores";
+    readonly ADMIN_ORDERS: "dqa-admin-orders";
+    readonly ADMIN_PAYOUTS: "dqa-admin-payouts";
+    readonly ADMIN_ANALYTICS: "dqa-admin-analytics";
+    readonly ADMIN_EVENTS: "dqa-admin-events";
+    readonly ADMIN_SUPPORT: "dqa-admin-support";
+    readonly ADMIN_MODERATION: "dqa-admin-moderation";
+    readonly ADMIN_INTEGRATION_GUIDES: "dqa-admin-integration-guides";
+    readonly ADMIN_USERS: "dqa-admin-users";
+    readonly ADMIN_CATEGORIES: "dqa-admin-categories";
+    readonly ADMIN_REVIEWS: "dqa-admin-reviews";
+    readonly ADMIN_FAQS: "dqa-admin-faqs";
+    readonly ADMIN_CAROUSEL: "dqa-admin-carousel";
+    readonly ADMIN_SECTIONS: "dqa-admin-sections";
     readonly SELLER_ADD_PRODUCT: "dqa-seller-add-product";
     readonly SELLER_ADD_COUPON: "dqa-seller-add-coupon";
     readonly SELLER_VIEW_ORDERS: "dqa-seller-view-orders";
     readonly SELLER_PAYOUT_REQ: "dqa-seller-payout-request";
     readonly SELLER_SETTINGS: "dqa-seller-settings";
+    readonly SELLER_AUCTIONS: "dqa-seller-auctions";
+    readonly SELLER_SHIPPING: "dqa-seller-shipping";
+    readonly SELLER_MESSAGES: "dqa-seller-messages";
+    readonly SELLER_WHATSAPP: "dqa-seller-whatsapp";
+    readonly SELLER_REVIEWS: "dqa-seller-reviews";
+    readonly SELLER_PRODUCTS: "dqa-seller-products";
+    readonly SELLER_STOREFRONT: "dqa-seller-storefront";
+    readonly SELLER_ANALYTICS: "dqa-seller-analytics";
     readonly USER_VIEW_ORDERS: "dqa-user-view-orders";
     readonly USER_VIEW_WISHLIST: "dqa-user-view-wishlist";
     readonly USER_EDIT_PROFILE: "dqa-user-edit-profile";
     readonly USER_ADD_ADDRESS: "dqa-user-add-address";
+    readonly USER_RECENTLY_VIEWED: "dqa-user-recently-viewed";
+    readonly USER_MY_CATALOGUE: "dqa-user-my-catalogue";
+    readonly USER_MY_COUPONS: "dqa-user-my-coupons";
 };
 export type DashboardQuickActionId = (typeof DASHBOARD_QUICK_ACTION_ID)[keyof typeof DASHBOARD_QUICK_ACTION_ID];
 export interface DashboardQuickActionMeta {
@@ -309,9 +334,9 @@ export interface DashboardQuickActionMeta {
 }
 export declare const DASHBOARD_QUICK_ACTION_META: Record<DashboardQuickActionId, DashboardQuickActionMeta>;
 export declare const DASHBOARD_QUICK_ACTIONS: {
-    readonly admin: readonly ["dqa-admin-add-product", "dqa-admin-add-user", "dqa-admin-add-store", "dqa-admin-add-coupon", "dqa-admin-add-event", "dqa-admin-add-blog", "dqa-admin-settings"];
-    readonly seller: readonly ["dqa-seller-add-product", "dqa-seller-add-coupon", "dqa-seller-view-orders", "dqa-seller-payout-request", "dqa-seller-settings"];
-    readonly user: readonly ["dqa-user-view-orders", "dqa-user-view-wishlist", "dqa-user-edit-profile", "dqa-user-add-address"];
+    readonly admin: readonly ["dqa-admin-add-product", "dqa-admin-add-user", "dqa-admin-add-store", "dqa-admin-add-coupon", "dqa-admin-add-event", "dqa-admin-add-blog", "dqa-admin-users", "dqa-admin-stores", "dqa-admin-orders", "dqa-admin-payouts", "dqa-admin-analytics", "dqa-admin-categories", "dqa-admin-reviews", "dqa-admin-events", "dqa-admin-faqs", "dqa-admin-carousel", "dqa-admin-sections", "dqa-admin-support", "dqa-admin-moderation", "dqa-admin-integration-guides", "dqa-admin-settings"];
+    readonly seller: readonly ["dqa-seller-add-product", "dqa-seller-products", "dqa-seller-view-orders", "dqa-seller-analytics", "dqa-seller-add-coupon", "dqa-seller-auctions", "dqa-seller-payout-request", "dqa-seller-shipping", "dqa-seller-messages", "dqa-seller-whatsapp", "dqa-seller-reviews", "dqa-seller-storefront", "dqa-seller-settings"];
+    readonly user: readonly ["dqa-user-view-orders", "dqa-user-view-wishlist", "dqa-user-edit-profile", "dqa-user-add-address", "dqa-user-recently-viewed", "dqa-user-my-catalogue", "dqa-user-my-coupons"];
 };
 export declare const ADMIN_BULK_ACTIONS: {
     readonly users: readonly ["row-manage", "row-suspend", "row-restore", "row-delete"];

package/dist/features/products/constants/action-defs.js

@@ -351,17 +351,42 @@ export const DASHBOARD_QUICK_ACTION_ID = {
     ADMIN_ADD_BLOG: "dqa-admin-add-blog",
     ADMIN_ADD_FAQ: "dqa-admin-add-faq",
     ADMIN_SETTINGS: "dqa-admin-settings",
+    ADMIN_STORES: "dqa-admin-stores",
+    ADMIN_ORDERS: "dqa-admin-orders",
+    ADMIN_PAYOUTS: "dqa-admin-payouts",
+    ADMIN_ANALYTICS: "dqa-admin-analytics",
+    ADMIN_EVENTS: "dqa-admin-events",
+    ADMIN_SUPPORT: "dqa-admin-support",
+    ADMIN_MODERATION: "dqa-admin-moderation",
+    ADMIN_INTEGRATION_GUIDES: "dqa-admin-integration-guides",
+    ADMIN_USERS: "dqa-admin-users",
+    ADMIN_CATEGORIES: "dqa-admin-categories",
+    ADMIN_REVIEWS: "dqa-admin-reviews",
+    ADMIN_FAQS: "dqa-admin-faqs",
+    ADMIN_CAROUSEL: "dqa-admin-carousel",
+    ADMIN_SECTIONS: "dqa-admin-sections",
     // Seller / Store
     SELLER_ADD_PRODUCT: "dqa-seller-add-product",
     SELLER_ADD_COUPON: "dqa-seller-add-coupon",
     SELLER_VIEW_ORDERS: "dqa-seller-view-orders",
     SELLER_PAYOUT_REQ: "dqa-seller-payout-request",
     SELLER_SETTINGS: "dqa-seller-settings",
+    SELLER_AUCTIONS: "dqa-seller-auctions",
+    SELLER_SHIPPING: "dqa-seller-shipping",
+    SELLER_MESSAGES: "dqa-seller-messages",
+    SELLER_WHATSAPP: "dqa-seller-whatsapp",
+    SELLER_REVIEWS: "dqa-seller-reviews",
+    SELLER_PRODUCTS: "dqa-seller-products",
+    SELLER_STOREFRONT: "dqa-seller-storefront",
+    SELLER_ANALYTICS: "dqa-seller-analytics",
     // User / Buyer
     USER_VIEW_ORDERS: "dqa-user-view-orders",
     USER_VIEW_WISHLIST: "dqa-user-view-wishlist",
     USER_EDIT_PROFILE: "dqa-user-edit-profile",
     USER_ADD_ADDRESS: "dqa-user-add-address",
+    USER_RECENTLY_VIEWED: "dqa-user-recently-viewed",
+    USER_MY_CATALOGUE: "dqa-user-my-catalogue",
+    USER_MY_COUPONS: "dqa-user-my-coupons",
 };
 export const DASHBOARD_QUICK_ACTION_META = {
     [DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_PRODUCT]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_PRODUCT, label: "Add Product", variant: "primary", iconName: "Plus", requiresAuth: true, requiredRole: "admin", requiredPermission: "products.create" },
@@ -372,15 +397,40 @@ export const DASHBOARD_QUICK_ACTION_META = {
     [DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_BLOG]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_BLOG, label: "New Post", variant: "outline", iconName: "FileText", requiresAuth: true, requiredRole: "admin", requiredPermission: "blog.create" },
     [DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_FAQ]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_FAQ, label: "Add FAQ", variant: "outline", iconName: "HelpCircle", requiresAuth: true, requiredRole: "admin", requiredPermission: "faqs.create" },
     [DASHBOARD_QUICK_ACTION_ID.ADMIN_SETTINGS]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_SETTINGS, label: "Settings", variant: "ghost", iconName: "Settings", requiresAuth: true, requiredRole: "admin", requiredPermission: "admin.settings.read" },
+    [DASHBOARD_QUICK_ACTION_ID.ADMIN_STORES]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_STORES, label: "Stores", variant: "outline", iconName: "Store", requiresAuth: true, requiredRole: "admin", requiredPermission: "admin.stores.read" },
+    [DASHBOARD_QUICK_ACTION_ID.ADMIN_ORDERS]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_ORDERS, label: "Orders", variant: "outline", iconName: "ShoppingBag", requiresAuth: true, requiredRole: "admin", requiredPermission: "orders.read" },
+    [DASHBOARD_QUICK_ACTION_ID.ADMIN_PAYOUTS]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_PAYOUTS, label: "Payouts", variant: "outline", iconName: "Banknote", requiresAuth: true, requiredRole: "admin", requiredPermission: "payouts.read" },
+    [DASHBOARD_QUICK_ACTION_ID.ADMIN_ANALYTICS]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_ANALYTICS, label: "Analytics", variant: "outline", iconName: "BarChart", requiresAuth: true, requiredRole: "admin", requiredPermission: "admin.analytics.read" },
+    [DASHBOARD_QUICK_ACTION_ID.ADMIN_EVENTS]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_EVENTS, label: "Events", variant: "outline", iconName: "Calendar", requiresAuth: true, requiredRole: "admin", requiredPermission: "events.read" },
+    [DASHBOARD_QUICK_ACTION_ID.ADMIN_SUPPORT]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_SUPPORT, label: "Support Tickets", variant: "outline", iconName: "LifeBuoy", requiresAuth: true, requiredRole: "admin", requiredPermission: "support.read" },
+    [DASHBOARD_QUICK_ACTION_ID.ADMIN_MODERATION]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_MODERATION, label: "Moderation", variant: "outline", iconName: "ShieldAlert", requiresAuth: true, requiredRole: "admin", requiredPermission: "moderation.read" },
+    [DASHBOARD_QUICK_ACTION_ID.ADMIN_INTEGRATION_GUIDES]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_INTEGRATION_GUIDES, label: "Integration Guides", variant: "ghost", iconName: "BookOpen", requiresAuth: true, requiredRole: "admin", requiredPermission: "admin:site:read" },
+    [DASHBOARD_QUICK_ACTION_ID.ADMIN_USERS]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_USERS, label: "Users", variant: "outline", iconName: "Users", requiresAuth: true, requiredRole: "admin", requiredPermission: "admin.users.read" },
+    [DASHBOARD_QUICK_ACTION_ID.ADMIN_CATEGORIES]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_CATEGORIES, label: "Categories", variant: "outline", iconName: "Tag", requiresAuth: true, requiredRole: "admin", requiredPermission: "categories.read" },
+    [DASHBOARD_QUICK_ACTION_ID.ADMIN_REVIEWS]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_REVIEWS, label: "Reviews", variant: "outline", iconName: "Star", requiresAuth: true, requiredRole: "admin", requiredPermission: "reviews.read" },
+    [DASHBOARD_QUICK_ACTION_ID.ADMIN_FAQS]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_FAQS, label: "FAQs", variant: "outline", iconName: "HelpCircle", requiresAuth: true, requiredRole: "admin", requiredPermission: "faqs.read" },
+    [DASHBOARD_QUICK_ACTION_ID.ADMIN_CAROUSEL]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_CAROUSEL, label: "Carousel", variant: "outline", iconName: "Layout", requiresAuth: true, requiredRole: "admin", requiredPermission: "admin.settings.read" },
+    [DASHBOARD_QUICK_ACTION_ID.ADMIN_SECTIONS]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_SECTIONS, label: "Sections", variant: "outline", iconName: "Layers", requiresAuth: true, requiredRole: "admin", requiredPermission: "admin.settings.read" },
     [DASHBOARD_QUICK_ACTION_ID.SELLER_ADD_PRODUCT]: { id: DASHBOARD_QUICK_ACTION_ID.SELLER_ADD_PRODUCT, label: "List a Product", variant: "primary", iconName: "Plus", requiresAuth: true, requiredRole: "seller", requiredPermission: "products.create" },
     [DASHBOARD_QUICK_ACTION_ID.SELLER_ADD_COUPON]: { id: DASHBOARD_QUICK_ACTION_ID.SELLER_ADD_COUPON, label: "New Coupon", variant: "outline", iconName: "Tag", requiresAuth: true, requiredRole: "seller", requiredPermission: "coupons.create" },
     [DASHBOARD_QUICK_ACTION_ID.SELLER_VIEW_ORDERS]: { id: DASHBOARD_QUICK_ACTION_ID.SELLER_VIEW_ORDERS, label: "Orders", variant: "outline", iconName: "ShoppingBag", requiresAuth: true, requiredRole: "seller" },
     [DASHBOARD_QUICK_ACTION_ID.SELLER_PAYOUT_REQ]: { id: DASHBOARD_QUICK_ACTION_ID.SELLER_PAYOUT_REQ, label: "Request Payout", variant: "outline", iconName: "Banknote", requiresAuth: true, requiredRole: "seller", requiredPermission: "seller.payouts.request" },
     [DASHBOARD_QUICK_ACTION_ID.SELLER_SETTINGS]: { id: DASHBOARD_QUICK_ACTION_ID.SELLER_SETTINGS, label: "Store Settings", variant: "ghost", iconName: "Settings", requiresAuth: true, requiredRole: "seller" },
+    [DASHBOARD_QUICK_ACTION_ID.SELLER_AUCTIONS]: { id: DASHBOARD_QUICK_ACTION_ID.SELLER_AUCTIONS, label: "Auctions", variant: "outline", iconName: "Gavel", requiresAuth: true, requiredRole: "seller" },
+    [DASHBOARD_QUICK_ACTION_ID.SELLER_SHIPPING]: { id: DASHBOARD_QUICK_ACTION_ID.SELLER_SHIPPING, label: "Shipping", variant: "outline", iconName: "Truck", requiresAuth: true, requiredRole: "seller" },
+    [DASHBOARD_QUICK_ACTION_ID.SELLER_MESSAGES]: { id: DASHBOARD_QUICK_ACTION_ID.SELLER_MESSAGES, label: "Messages", variant: "outline", iconName: "MessageCircle", requiresAuth: true, requiredRole: "seller" },
+    [DASHBOARD_QUICK_ACTION_ID.SELLER_WHATSAPP]: { id: DASHBOARD_QUICK_ACTION_ID.SELLER_WHATSAPP, label: "WhatsApp", variant: "outline", iconName: "Phone", requiresAuth: true, requiredRole: "seller" },
+    [DASHBOARD_QUICK_ACTION_ID.SELLER_REVIEWS]: { id: DASHBOARD_QUICK_ACTION_ID.SELLER_REVIEWS, label: "Reviews", variant: "outline", iconName: "Star", requiresAuth: true, requiredRole: "seller" },
+    [DASHBOARD_QUICK_ACTION_ID.SELLER_PRODUCTS]: { id: DASHBOARD_QUICK_ACTION_ID.SELLER_PRODUCTS, label: "My Products", variant: "outline", iconName: "Package", requiresAuth: true, requiredRole: "seller" },
+    [DASHBOARD_QUICK_ACTION_ID.SELLER_STOREFRONT]: { id: DASHBOARD_QUICK_ACTION_ID.SELLER_STOREFRONT, label: "My Storefront", variant: "outline", iconName: "Store", requiresAuth: true, requiredRole: "seller" },
+    [DASHBOARD_QUICK_ACTION_ID.SELLER_ANALYTICS]: { id: DASHBOARD_QUICK_ACTION_ID.SELLER_ANALYTICS, label: "Analytics", variant: "outline", iconName: "BarChart", requiresAuth: true, requiredRole: "seller" },
     [DASHBOARD_QUICK_ACTION_ID.USER_VIEW_ORDERS]: { id: DASHBOARD_QUICK_ACTION_ID.USER_VIEW_ORDERS, label: "My Orders", variant: "outline", iconName: "Package", requiresAuth: true, requiredRole: "user" },
     [DASHBOARD_QUICK_ACTION_ID.USER_VIEW_WISHLIST]: { id: DASHBOARD_QUICK_ACTION_ID.USER_VIEW_WISHLIST, label: "Wishlist", variant: "outline", iconName: "Heart", requiresAuth: true, requiredRole: "user" },
     [DASHBOARD_QUICK_ACTION_ID.USER_EDIT_PROFILE]: { id: DASHBOARD_QUICK_ACTION_ID.USER_EDIT_PROFILE, label: "Edit Profile", variant: "outline", iconName: "User", requiresAuth: true, requiredRole: "user" },
     [DASHBOARD_QUICK_ACTION_ID.USER_ADD_ADDRESS]: { id: DASHBOARD_QUICK_ACTION_ID.USER_ADD_ADDRESS, label: "Add Address", variant: "outline", iconName: "MapPin", requiresAuth: true, requiredRole: "user" },
+    [DASHBOARD_QUICK_ACTION_ID.USER_RECENTLY_VIEWED]: { id: DASHBOARD_QUICK_ACTION_ID.USER_RECENTLY_VIEWED, label: "Recently Viewed", variant: "outline", iconName: "Clock", requiresAuth: true, requiredRole: "user" },
+    [DASHBOARD_QUICK_ACTION_ID.USER_MY_CATALOGUE]: { id: DASHBOARD_QUICK_ACTION_ID.USER_MY_CATALOGUE, label: "My Catalogue", variant: "outline", iconName: "Archive", requiresAuth: true, requiredRole: "user" },
+    [DASHBOARD_QUICK_ACTION_ID.USER_MY_COUPONS]: { id: DASHBOARD_QUICK_ACTION_ID.USER_MY_COUPONS, label: "My Coupons", variant: "outline", iconName: "Ticket", requiresAuth: true, requiredRole: "user" },
 };
 // Quick action groups — ordered left-to-right in the top shortcut bar
 export const DASHBOARD_QUICK_ACTIONS = {
@@ -391,13 +441,35 @@ export const DASHBOARD_QUICK_ACTIONS = {
         DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_COUPON,
         DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_EVENT,
         DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_BLOG,
+        DASHBOARD_QUICK_ACTION_ID.ADMIN_USERS,
+        DASHBOARD_QUICK_ACTION_ID.ADMIN_STORES,
+        DASHBOARD_QUICK_ACTION_ID.ADMIN_ORDERS,
+        DASHBOARD_QUICK_ACTION_ID.ADMIN_PAYOUTS,
+        DASHBOARD_QUICK_ACTION_ID.ADMIN_ANALYTICS,
+        DASHBOARD_QUICK_ACTION_ID.ADMIN_CATEGORIES,
+        DASHBOARD_QUICK_ACTION_ID.ADMIN_REVIEWS,
+        DASHBOARD_QUICK_ACTION_ID.ADMIN_EVENTS,
+        DASHBOARD_QUICK_ACTION_ID.ADMIN_FAQS,
+        DASHBOARD_QUICK_ACTION_ID.ADMIN_CAROUSEL,
+        DASHBOARD_QUICK_ACTION_ID.ADMIN_SECTIONS,
+        DASHBOARD_QUICK_ACTION_ID.ADMIN_SUPPORT,
+        DASHBOARD_QUICK_ACTION_ID.ADMIN_MODERATION,
+        DASHBOARD_QUICK_ACTION_ID.ADMIN_INTEGRATION_GUIDES,
         DASHBOARD_QUICK_ACTION_ID.ADMIN_SETTINGS,
     ],
     seller: [
         DASHBOARD_QUICK_ACTION_ID.SELLER_ADD_PRODUCT,
-        DASHBOARD_QUICK_ACTION_ID.SELLER_ADD_COUPON,
+        DASHBOARD_QUICK_ACTION_ID.SELLER_PRODUCTS,
         DASHBOARD_QUICK_ACTION_ID.SELLER_VIEW_ORDERS,
+        DASHBOARD_QUICK_ACTION_ID.SELLER_ANALYTICS,
+        DASHBOARD_QUICK_ACTION_ID.SELLER_ADD_COUPON,
+        DASHBOARD_QUICK_ACTION_ID.SELLER_AUCTIONS,
         DASHBOARD_QUICK_ACTION_ID.SELLER_PAYOUT_REQ,
+        DASHBOARD_QUICK_ACTION_ID.SELLER_SHIPPING,
+        DASHBOARD_QUICK_ACTION_ID.SELLER_MESSAGES,
+        DASHBOARD_QUICK_ACTION_ID.SELLER_WHATSAPP,
+        DASHBOARD_QUICK_ACTION_ID.SELLER_REVIEWS,
+        DASHBOARD_QUICK_ACTION_ID.SELLER_STOREFRONT,
         DASHBOARD_QUICK_ACTION_ID.SELLER_SETTINGS,
     ],
     user: [
@@ -405,6 +477,9 @@ export const DASHBOARD_QUICK_ACTIONS = {
         DASHBOARD_QUICK_ACTION_ID.USER_VIEW_WISHLIST,
         DASHBOARD_QUICK_ACTION_ID.USER_EDIT_PROFILE,
         DASHBOARD_QUICK_ACTION_ID.USER_ADD_ADDRESS,
+        DASHBOARD_QUICK_ACTION_ID.USER_RECENTLY_VIEWED,
+        DASHBOARD_QUICK_ACTION_ID.USER_MY_CATALOGUE,
+        DASHBOARD_QUICK_ACTION_ID.USER_MY_COUPONS,
     ],
 };
 // Admin bulk actions per listing entity — used in BulkActionsBar on admin tables

package/dist/features/seller/components/SellerOrdersView.js

@@ -151,7 +151,7 @@ function OrderDetailDrawer({ orderId, apiBase, onClose, }) {
     };
     const addr = order?.shippingAddress ?? {};
     const addrLine = [addr.addressLine1, addr.city, addr.state, addr.pincode].filter(Boolean).join(", ");
-    return (_jsxs(SideDrawer, { isOpen: true, title: `Order ${order?.id ?? orderId}`, onClose: onClose, children: [loading && (_jsx(Row, { align: "center", justify: "center", padding: "y-4xl", children: _jsx(Div, { className: "h-6 w-6 animate-spin border-2 border-[var(--appkit-color-primary)] border-t-transparent", rounded: "full" }) })), fetchError && (_jsx(Div, { textSize: "sm", className: "mx-4 mt-4 border border-error/20", color: "error", surface: "danger-surface", padding: "inline", rounded: "lg", children: fetchError })), order && !loading && (_jsxs(Stack, { gap: "none", children: [_jsxs(Stack, { className: `flex-1 ${__O.yAuto}`, gap: "5", padding: "md", children: [_jsxs(Row, { align: "center", justify: "between", children: [_jsx(Badge, { variant: STATUS_BADGE_VARIANT[order.status?.toUpperCase()] ?? "default", children: order.status ?? "Unknown" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-secondary)]", children: toRelativeDate(order.createdAt) })] }), (order.items ?? []).length > 0 && (_jsxs(Div, { children: [_jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-primary)] mb-2", weight: "semibold", children: "Items" }), _jsx(Div, { className: "divide-y divide-[var(--appkit-color-border)] divide-[var(--appkit-color-border)] border border-[var(--appkit-color-border)]", rounded: "lg", children: (order.items ?? []).map((item, i) => (_jsxs(Row, { paddingY: "y-xs-tall", padding: "x-sm", align: "center", justify: "between", gap: "3", children: [_jsxs(Div, { className: "min-w-0", children: [_jsx(Text, { size: "sm", className: "truncate", weight: "medium", children: item.title ?? item.productId ?? "Item" }), _jsxs(Text, { size: "xs", className: "text-[var(--appkit-color-text-secondary)]", children: ["Qty: ", item.quantity ?? 1] })] }), _jsx(Text, { size: "sm", className: "shrink-0", weight: "medium", children: toCurrency(item.price ?? 0) })] }, i))) })] })), _jsxs(Row, { surface: "muted", padding: "inline", align: "center", justify: "between", rounded: "lg", children: [_jsx(Text, { size: "sm", weight: "semibold", children: "Total" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-primary)]", weight: "bold", children: toCurrency(order.totalAmount ?? 0) })] }), addrLine && (_jsxs(Div, { children: [_jsx(Text, { size: "sm", className: "mb-1", weight: "semibold", children: "Shipping address" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-secondary)]", children: [String(addr.fullName ?? ""), addrLine].filter(Boolean).join(" · ") })] })), order.paymentMethod && (_jsxs(Div, { children: [_jsx(Text, { size: "sm", className: "mb-1", weight: "semibold", children: "Payment" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-secondary)]", transform: "capitalize", children: order.paymentMethod })] })), order.emiEnabled && (_jsxs(Div, { className: "border-t border-[var(--appkit-color-border)]", padding: "t-md", children: [_jsxs(Row, { align: "center", justify: "between", className: "mb-2", children: [_jsxs(Text, { size: "sm", weight: "semibold", children: ["EMI plan ", order.emiTenureMonths ? `· ${order.emiTenureMonths} months` : ""] }), _jsx(Badge, { variant: order.emiComplete ? "success" : "warning", children: order.emiComplete ? "Fully paid" : "In progress" })] }), _jsxs(Row, { align: "center", justify: "between", className: "mb-2", children: [_jsx(Text, { size: "xs", color: "muted", children: "Token collected" }), _jsx(Text, { size: "xs", weight: "medium", children: toCurrency(order.emiTokenAmount ?? 0) })] }), _jsxs(Row, { align: "center", justify: "between", className: "mb-3", children: [_jsx(Text, { size: "xs", color: "muted", children: "Remaining balance" }), _jsx(Text, { size: "xs", weight: "medium", children: toCurrency(order.emiRemainingBalance ?? 0) })] }), _jsx(Div, { className: "divide-y divide-[var(--appkit-color-border)] border border-[var(--appkit-color-border)]", rounded: "lg", children: (order.emiInstallments ?? []).map((inst) => (_jsxs(Row, { paddingY: "y-xs-tall", padding: "x-sm", align: "center", justify: "between", gap: "3", children: [_jsxs(Div, { className: "min-w-0", children: [_jsxs(Text, { size: "sm", weight: "medium", children: ["Installment ", inst.index, " \u00B7 ", toCurrency(inst.amount)] }), _jsx(Text, { size: "xs", color: "muted", children: inst.status === "paid" && inst.paidAt
+    return (_jsxs(SideDrawer, { isOpen: true, title: `Order ${order?.id ?? orderId}`, onClose: onClose, children: [loading && (_jsx(Row, { align: "center", justify: "center", padding: "y-4xl", children: _jsx(Div, { className: "h-6 w-6 animate-spin border-2 border-[var(--appkit-color-primary)] border-t-transparent", rounded: "full" }) })), fetchError && (_jsx(Div, { textSize: "sm", className: "mx-4 mt-4 border border-error/20", color: "error", surface: "danger-surface", padding: "inline", rounded: "lg", children: fetchError })), order && !loading && (_jsxs(Stack, { gap: "none", children: [_jsxs(Stack, { className: `flex-1 ${__O.yAuto}`, gap: "5", padding: "md", children: [_jsxs(Row, { align: "center", justify: "between", children: [_jsx(Badge, { variant: STATUS_BADGE_VARIANT[order.status?.toUpperCase()] ?? "default", children: order.status ?? "Unknown" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-secondary)]", children: toRelativeDate(order.createdAt) })] }), (order.items ?? []).length > 0 && (_jsxs(Div, { children: [_jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-primary)] mb-2", weight: "semibold", children: "Items" }), _jsx(Div, { className: "divide-y divide-[var(--appkit-color-border)] divide-[var(--appkit-color-border)] border border-[var(--appkit-color-border)]", rounded: "lg", children: (order.items ?? []).map((item, i) => (_jsxs(Row, { paddingY: "y-xs-tall", padding: "x-sm", align: "center", justify: "between", gap: "3", children: [_jsxs(Div, { className: "min-w-0", children: [_jsx(Text, { size: "sm", className: "truncate", weight: "medium", children: item.title ?? item.productId ?? "Item" }), _jsxs(Text, { size: "xs", className: "text-[var(--appkit-color-text-secondary)]", children: ["Qty: ", item.quantity ?? 1] })] }), _jsx(Text, { size: "sm", className: "shrink-0", weight: "medium", children: toCurrency(item.price ?? 0) })] }, i))) })] })), order.giftWrapAddon && (_jsxs(Div, { className: "border border-[var(--appkit-color-primary-200)] dark:border-[var(--appkit-color-primary-800)]", surface: "subtle", padding: "inline", rounded: "lg", children: [_jsx(Text, { size: "sm", weight: "semibold", children: "\uD83C\uDF81 Gift wrap requested" }), order.giftWrapMessage && (_jsxs(Text, { size: "sm", className: "mt-1 text-[var(--appkit-color-text-secondary)]", children: ["\u201C", order.giftWrapMessage, "\u201D"] }))] })), _jsxs(Row, { surface: "muted", padding: "inline", align: "center", justify: "between", rounded: "lg", children: [_jsx(Text, { size: "sm", weight: "semibold", children: "Total" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-primary)]", weight: "bold", children: toCurrency(order.totalAmount ?? 0) })] }), addrLine && (_jsxs(Div, { children: [_jsx(Text, { size: "sm", className: "mb-1", weight: "semibold", children: "Shipping address" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-secondary)]", children: [String(addr.fullName ?? ""), addrLine].filter(Boolean).join(" · ") })] })), order.paymentMethod && (_jsxs(Div, { children: [_jsx(Text, { size: "sm", className: "mb-1", weight: "semibold", children: "Payment" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-secondary)]", transform: "capitalize", children: order.paymentMethod })] })), order.emiEnabled && (_jsxs(Div, { className: "border-t border-[var(--appkit-color-border)]", padding: "t-md", children: [_jsxs(Row, { align: "center", justify: "between", className: "mb-2", children: [_jsxs(Text, { size: "sm", weight: "semibold", children: ["EMI plan ", order.emiTenureMonths ? `· ${order.emiTenureMonths} months` : ""] }), _jsx(Badge, { variant: order.emiComplete ? "success" : "warning", children: order.emiComplete ? "Fully paid" : "In progress" })] }), _jsxs(Row, { align: "center", justify: "between", className: "mb-2", children: [_jsx(Text, { size: "xs", color: "muted", children: "Token collected" }), _jsx(Text, { size: "xs", weight: "medium", children: toCurrency(order.emiTokenAmount ?? 0) })] }), _jsxs(Row, { align: "center", justify: "between", className: "mb-3", children: [_jsx(Text, { size: "xs", color: "muted", children: "Remaining balance" }), _jsx(Text, { size: "xs", weight: "medium", children: toCurrency(order.emiRemainingBalance ?? 0) })] }), _jsx(Div, { className: "divide-y divide-[var(--appkit-color-border)] border border-[var(--appkit-color-border)]", rounded: "lg", children: (order.emiInstallments ?? []).map((inst) => (_jsxs(Row, { paddingY: "y-xs-tall", padding: "x-sm", align: "center", justify: "between", gap: "3", children: [_jsxs(Div, { className: "min-w-0", children: [_jsxs(Text, { size: "sm", weight: "medium", children: ["Installment ", inst.index, " \u00B7 ", toCurrency(inst.amount)] }), _jsx(Text, { size: "xs", color: "muted", children: inst.status === "paid" && inst.paidAt
                                                                 ? `Paid ${toRelativeDate(inst.paidAt)}`
                                                                 : inst.dueDate
                                                                     ? `Due ${toRelativeDate(inst.dueDate)}`

package/dist/features/whatsapp-bot/helpers/whatsapp.d.ts

@@ -1,4 +1,4 @@
-import type { CheckoutMessageInput, StatusNotificationInput, WebhookVerifyInput, IncomingWebhookPayload, SendWhatsAppInput, StatusMessageInput, WaBusinessSendInput, CatalogSyncInput, CatalogSyncResult, PurchaseAnnouncementInput, PaymentProofReviewMessageInput } from "../types";
+import type { CheckoutMessageInput, StatusNotificationInput, WebhookVerifyInput, IncomingWebhookPayload, SendWhatsAppInput, StatusMessageInput, WaBusinessSendInput, WaBusinessTemplateSendInput, CatalogSyncInput, CatalogSyncResult, PurchaseAnnouncementInput, PaymentProofReviewMessageInput } from "../types";
 export declare function buildCheckoutMessageURL(input: CheckoutMessageInput): string;
 export declare function buildStatusNotificationURL(input: StatusNotificationInput): string;
 export declare function verifyWebhookSignature(input: WebhookVerifyInput): boolean;
@@ -19,6 +19,15 @@ export declare function buildStatusMessage(input: StatusMessageInput, statusMess
  * platform announcements. Returns true on success, false on any failure.
  */
 export declare function sendWhatsAppBusinessMessage(input: WaBusinessSendInput): Promise<boolean>;
+/**
+ * Send a pre-approved Meta message TEMPLATE via WhatsApp Business Cloud API.
+ * Required for business-initiated sends outside the 24h customer-service
+ * window (proactive order/status notifications) — Meta rejects free-form
+ * `sendWhatsAppBusinessMessage` `type: "text"` sends in that case. Returns
+ * true on success, false on any failure (including a missing/unapproved
+ * template — Meta returns a 4xx with an error body, not a network failure).
+ */
+export declare function sendWhatsAppTemplateMessage(input: WaBusinessTemplateSendInput): Promise<boolean>;
 /**
  * Sync a store's products to a Meta Commerce Catalog via items_batch API.
  * Batches at 50 items per call (Meta limit). Returns aggregate results.

package/dist/features/whatsapp-bot/helpers/whatsapp.js

@@ -131,6 +131,53 @@ export async function sendWhatsAppBusinessMessage(input) {
         return false;
     }
 }
+/**
+ * Send a pre-approved Meta message TEMPLATE via WhatsApp Business Cloud API.
+ * Required for business-initiated sends outside the 24h customer-service
+ * window (proactive order/status notifications) — Meta rejects free-form
+ * `sendWhatsAppBusinessMessage` `type: "text"` sends in that case. Returns
+ * true on success, false on any failure (including a missing/unapproved
+ * template — Meta returns a 4xx with an error body, not a network failure).
+ */
+export async function sendWhatsAppTemplateMessage(input) {
+    const { toPhone, phoneNumberId, accessToken, templateName, languageCode, bodyParams } = input;
+    const cleanPhone = toPhone.replace(/\D/g, "");
+    if (!cleanPhone || !phoneNumberId || !accessToken || !templateName)
+        return false;
+    try {
+        const res = await fetch(`${META_GRAPH_BASE}/${phoneNumberId}/messages`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${accessToken}`,
+            },
+            body: JSON.stringify({
+                messaging_product: "whatsapp",
+                to: cleanPhone,
+                type: "template",
+                template: {
+                    name: templateName,
+                    language: { code: languageCode },
+                    ...(bodyParams?.length
+                        ? {
+                            components: [
+                                {
+                                    type: "body",
+                                    parameters: bodyParams.map((text) => ({ type: "text", text })),
+                                },
+                            ],
+                        }
+                        : {}),
+                },
+            }),
+        });
+        return res.ok;
+    }
+    catch (_err) {
+        void normalizeError(_err);
+        return false;
+    }
+}
 /**
  * Sync a store's products to a Meta Commerce Catalog via items_batch API.
  * Batches at 50 items per call (Meta limit). Returns aggregate results.

package/dist/features/whatsapp-bot/types/index.d.ts

@@ -50,6 +50,25 @@ export interface WaBusinessSendInput {
     /** Meta system user access token */
     accessToken: string;
 }
+/**
+ * Input for sending a pre-approved Meta message TEMPLATE. Required for any
+ * business-initiated WhatsApp send outside the 24h customer-service window —
+ * Meta rejects free-form `type: "text"` sends in that case.
+ */
+export interface WaBusinessTemplateSendInput {
+    /** Digits-only phone number with country code, e.g. "919876543210" */
+    toPhone: string;
+    /** Meta Phone Number ID (from Meta for Developers > App > WhatsApp > API Setup) */
+    phoneNumberId: string;
+    /** Meta system user access token */
+    accessToken: string;
+    /** Exact approved template name from Meta WhatsApp Manager (not the display label). */
+    templateName: string;
+    /** BCP-47 language code the template was approved in, e.g. "en" or "en_US". */
+    languageCode: string;
+    /** Positional {{1}}, {{2}}… body parameters, in order. */
+    bodyParams?: string[];
+}
 /** A product mapped to the Meta Commerce API catalog item format. */
 export interface CatalogSyncProduct {
     /** Firestore product ID — used as Meta `retailer_id` */

package/dist/index.d.ts

@@ -549,6 +549,8 @@ export type { PageViewDocument, PageViewEntityType } from "./repositories/index"
 export { reviewRepository } from "./repositories/index";
 export { sessionRepository } from "./repositories/index";
 export { siteSettingsRepository } from "./repositories/index";
+export { analyticsRollupRepository } from "./repositories/index";
+export type { AnalyticsRollupDocument } from "./repositories/index";
 export { ADMIN_CHECKOUT_BYPASS_FLAG_KEY } from "./features/admin/schemas/firestore";
 export { smsCounterRepository } from "./repositories/index";
 export { storeRepository } from "./repositories/index";
@@ -2453,8 +2455,8 @@ export { actionTracker, setActionTrackerSink, resetActionTrackerSink, type Actio
 export { cartRequiresShipping, cartIsDigitalOnly, cartIsChatOnly, } from "./_internal/shared/listing-types/cart-shipping";
 export { ACTIONS, action, act, canPerformAction, actionsForListingType, actionLabel, type ActionDef, type ActionKind, type ActionResource, type ActionTree, type ActionConfirmation, } from "./_internal/shared/actions/action-registry";
 export { buildBulkAction } from "./_internal/shared/actions/bulk-helpers";
-export { computeCheckoutFees, computePayoutDeduction, computeCodHandlingFee, calculateGst, } from "./_internal/shared/fees/calculator";
-export type { FeeCommissionRates, CheckoutFees, PayoutDeduction, CodHandlingFeeRates, GstBreakdown, } from "./_internal/shared/fees/calculator";
+export { computeCheckoutFees, computePayoutDeduction, computeCodHandlingFee, computeWhatsAppNotifyFee, computeGiftWrapFee, computeShipmentProtectionFee, calculateGst, } from "./_internal/shared/fees/calculator";
+export type { FeeCommissionRates, CheckoutFees, PayoutDeduction, CodHandlingFeeRates, WhatsAppNotifyFeeRates, GiftWrapFeeRates, ShipmentProtectionFeeRates, GstBreakdown, } from "./_internal/shared/fees/calculator";
 export { checkEmiEligibility, computeEmiSchedule } from "./_internal/shared/features/emi/schedule";
 export type { EmiSettings, EmiIneligibleReason, EmiEligibility, EmiInstallmentPlan, EmiScheduleResult, } from "./_internal/shared/features/emi/schedule";
 export { isAdminUser, isSellerUser, isModeratorUser, isEmployeeUser, isBuyerUser, isEffectiveAdminUser, } from "./features/auth/role-predicates";

package/dist/index.js

@@ -1070,6 +1070,8 @@ export { sessionRepository } from "./repositories/index";
 // [DB]-Database layer â€" uses firebase-admin or another server-side DB SDK; can only run in a trusted server environment.
 // siteSettingsRepository - Shared export for site settings repository.
 export { siteSettingsRepository } from "./repositories/index";
+// analyticsRollupRepository - reads the pre-computed admin-dashboard revenue rollup.
+export { analyticsRollupRepository } from "./repositories/index";
 // ADMIN_CHECKOUT_BYPASS_FLAG_KEY - field name for the admin checkout bypass flag.
 export { ADMIN_CHECKOUT_BYPASS_FLAG_KEY } from "./features/admin/schemas/firestore";
 // [DB]-Database layer â€" uses firebase-admin or another server-side DB SDK; can only run in a trusted server environment.
@@ -4498,8 +4500,8 @@ export { cartRequiresShipping, cartIsDigitalOnly, cartIsChatOnly, } from "./_int
 // SB-UNI-W-1 2026-05-13 â€" CTA action registry shell.
 export { ACTIONS, action, act, canPerformAction, actionsForListingType, actionLabel, } from "./_internal/shared/actions/action-registry";
 export { buildBulkAction } from "./_internal/shared/actions/bulk-helpers";
-// Shared fee calculator — platform/gateway/GST/COD handling fee math (pure, client-safe).
-export { computeCheckoutFees, computePayoutDeduction, computeCodHandlingFee, calculateGst, } from "./_internal/shared/fees/calculator";
+// Shared fee calculator — platform/gateway/GST/COD handling/WhatsApp-addon fee math (pure, client-safe).
+export { computeCheckoutFees, computePayoutDeduction, computeCodHandlingFee, computeWhatsAppNotifyFee, computeGiftWrapFee, computeShipmentProtectionFee, calculateGst, } from "./_internal/shared/fees/calculator";
 // EMI eligibility + schedule computation (pure, client-safe — used for checkout quotes).
 export { checkEmiEligibility, computeEmiSchedule } from "./_internal/shared/features/emi/schedule";
 // User-role predicates â€" SB-UNI-E 2026-05-13.