@mohasinac/appkit 4.1.1 → 4.2.0

package/dist/features/tester/seed-data/tester-checklist-seed-data.js

@@ -17,6 +17,7 @@
  * @tag consumers:seed/index.ts,seed/runner.ts
  * @tag sideEffects:none
  */
+import { assignDefaultPhases } from "../utils/phases";
 function group(groupKey, groupLabel, pages, opts) {
     const items = [];
     pages.forEach((page, pageIdx) => {
@@ -38,17 +39,23 @@ function group(groupKey, groupLabel, pages, opts) {
     });
     return items;
 }
-export const testerChecklistSeedData = [
+/**
+ * Array order below IS the intended catalog order (groups concatenated via
+ * spread, in authoring order) — `assignDefaultPhases` walks it directly
+ * rather than sorting by `order`, since `order` restarts at 0 within each
+ * group and is not globally unique across groups.
+ */
+const rawTesterChecklistItems = [
     ...group("account-auth", "Account & Auth", [
         {
             pageKey: "signup-login",
             pageLabel: "Signup & Login",
             cases: [
-                { key: "email-signup", label: "Sign up with email works", href: "/register" },
-                { key: "google-oauth", label: "Sign up / log in with Google works", href: "/login" },
+                { key: "email-signup", label: "Sign up with email works", href: "/auth/register" },
+                { key: "google-oauth", label: "Sign up / log in with Google works", href: "/auth/login" },
                 { key: "google-link-existing", label: "Linking Google sign-in to an existing email/password account works" },
                 { key: "google-popup-blocked-fallback", label: "If the Google sign-in popup is blocked, the fallback (RTDB signal + postMessage) still completes sign-in" },
-                { key: "login", label: "Log in with email + password works", href: "/login" },
+                { key: "login", label: "Log in with email + password works", href: "/auth/login" },
                 { key: "logout", label: "Log out works and clears the session" },
                 { key: "email-verify", label: "Email verification link works" },
                 { key: "password-reset", label: "Forgot-password / reset-password flow works" },
@@ -110,7 +117,7 @@ export const testerChecklistSeedData = [
                 { key: "add-to-cart", label: "Add to cart works from the product page" },
                 { key: "add-to-cart-out-of-stock", label: "Add to cart is disabled/blocked once a listing's stock reaches zero" },
                 { key: "add-to-cart-max-quantity", label: "Increasing quantity in the cart is capped at the listing's available stock, with a clear message" },
-                { key: "checkout-flow", label: "Checkout flow completes without errors", href: "/cart" },
+                { key: "checkout-flow", label: "Checkout flow completes without errors", href: "/checkout" },
                 { key: "checkout-order-review", label: "The order-review step before payment shows correct items, quantities, addresses, and totals" },
                 { key: "checkout-multi-seller-split", label: "A cart with items from multiple sellers correctly splits into separate orders at checkout" },
                 { key: "shipping-address", label: "Selecting/adding a shipping address works" },
@@ -147,7 +154,7 @@ export const testerChecklistSeedData = [
             pageKey: "wishlist-history",
             pageLabel: "Wishlist & History",
             cases: [
-                { key: "add-wishlist-pdp", label: "Adding a product to the wishlist from the product detail page works", href: "/user/wishlist" },
+                { key: "add-wishlist-pdp", label: "Adding a product to the wishlist from the product detail page works", href: "/wishlist" },
                 { key: "add-wishlist-card", label: "Adding a product to the wishlist from a listing card (checkbox/long-press) works on both listing and search pages" },
                 { key: "remove-wishlist", label: "Removing a product from the wishlist works" },
                 { key: "wishlist-persists-guest-to-login", label: "Wishlist items added as a guest are preserved after logging in" },
@@ -156,7 +163,7 @@ export const testerChecklistSeedData = [
                 { key: "wishlist-across-listing-types", label: "Auctions and pre-orders (not just standard products) can be added to and viewed correctly in the wishlist" },
                 { key: "wishlist-price-drop-accuracy", label: "A wishlist item's displayed price matches the product's current price, not a stale snapshot" },
                 { key: "wishlist-sold-out-item", label: "A wishlist item whose product later sells out or is removed still displays gracefully (no crash) with an appropriate indicator" },
-                { key: "wishlist-empty-state", label: "The empty-wishlist state renders correctly with no items", href: "/user/wishlist" },
+                { key: "wishlist-empty-state", label: "The empty-wishlist state renders correctly with no items", href: "/wishlist" },
                 { key: "wishlist-add-to-cart-from-list", label: "Adding a wishlist item directly to the cart from the wishlist page works" },
                 { key: "view-history", label: "Recently viewed history shows accurate items in most-recent-first order", href: "/user/history" },
                 { key: "history-revisit-reorders", label: "Re-visiting a product already in history removes the old entry and moves it to the front, rather than duplicating it" },
@@ -311,7 +318,7 @@ export const testerChecklistSeedData = [
                 { key: "seller-messages", label: "Seller messages list and thread view both work", href: "/store/messages" },
                 { key: "seller-fulfillment-queue", label: "Seller fulfillment queue shows accurate pending items", href: "/store/fulfillment" },
                 { key: "seller-print-center", label: "Seller print-center generates labels/invoices correctly", href: "/store/print-center" },
-                { key: "seller-inventory-print", label: "Seller inventory print view works", href: "/store/inventory/print" },
+                { key: "seller-inventory-print", label: "Seller inventory print view works", href: "/store/print-center" },
             ],
         },
         {
@@ -514,7 +521,7 @@ export const testerChecklistSeedData = [
             pageKey: "auth-error-pages",
             pageLabel: "Remaining Auth & Error Pages",
             cases: [
-                { key: "register-page", label: "The register page loads and account creation works", href: "/register" },
+                { key: "register-page", label: "The register page loads and account creation works", href: "/auth/register" },
                 { key: "forgot-reset-password-pages", label: "Forgot-password and reset-password pages both work" },
                 { key: "verify-email-page", label: "The verify-email page correctly confirms a pending verification" },
                 { key: "oauth-loading-redirect", label: "The OAuth-loading redirect page transitions correctly after a Google sign-in" },
@@ -676,3 +683,8 @@ export const testerChecklistSeedData = [
         },
     ], { adminOnly: true }),
 ];
+const defaultPhases = assignDefaultPhases(rawTesterChecklistItems);
+export const testerChecklistSeedData = rawTesterChecklistItems.map((item, index) => ({
+    ...item,
+    phase: defaultPhases[index],
+}));

package/dist/features/tester/utils/phases.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Computes default `phase` numbers for the tester checklist catalog.
+ *
+ * `phase` is a real, stored, admin-editable field on `TesterChecklistItemDocument`
+ * (see schemas/firestore.ts) — not something recomputed on every read. This
+ * module only supplies the INITIAL assignment: given the catalog in its
+ * existing groupKey/pageKey/order sequence, bucket whole pages together into
+ * phases of roughly `targetPhaseSize` items each (never splitting a single
+ * page's items across two phases), so a tester works through ~10-50 cases
+ * per session instead of the full catalog at once.
+ *
+ * Used once at seed-authoring time (tester-checklist-seed-data.ts) and by
+ * the one-off Firestore backfill for already-seeded items that predate the
+ * `phase` field. After that, every read path (TesterHubView, admin results
+ * views, the markdown report) just groups by the stored `item.phase` value —
+ * no chunking logic at read time.
+ */
+export interface TesterPhaseAssignable {
+    groupKey: string;
+    pageKey: string;
+}
+/** Target item count per phase — real phase sizes vary a little around this
+ * since a page's items are never split across two phases. */
+export declare const DEFAULT_TESTER_PHASE_SIZE = 25;
+/**
+ * Returns a same-length array of 1-based phase numbers, one per input item,
+ * computed by greedily packing whole pages (consecutive runs of the same
+ * groupKey+pageKey) into phases of ~`targetPhaseSize` items. `items` MUST
+ * already be in catalog order (e.g. sorted by the `order` field).
+ */
+export declare function assignDefaultPhases<T extends TesterPhaseAssignable>(itemsInCatalogOrder: T[], targetPhaseSize?: number): number[];

package/dist/features/tester/utils/phases.js

@@ -0,0 +1,46 @@
+/**
+ * Computes default `phase` numbers for the tester checklist catalog.
+ *
+ * `phase` is a real, stored, admin-editable field on `TesterChecklistItemDocument`
+ * (see schemas/firestore.ts) — not something recomputed on every read. This
+ * module only supplies the INITIAL assignment: given the catalog in its
+ * existing groupKey/pageKey/order sequence, bucket whole pages together into
+ * phases of roughly `targetPhaseSize` items each (never splitting a single
+ * page's items across two phases), so a tester works through ~10-50 cases
+ * per session instead of the full catalog at once.
+ *
+ * Used once at seed-authoring time (tester-checklist-seed-data.ts) and by
+ * the one-off Firestore backfill for already-seeded items that predate the
+ * `phase` field. After that, every read path (TesterHubView, admin results
+ * views, the markdown report) just groups by the stored `item.phase` value —
+ * no chunking logic at read time.
+ */
+/** Target item count per phase — real phase sizes vary a little around this
+ * since a page's items are never split across two phases. */
+export const DEFAULT_TESTER_PHASE_SIZE = 25;
+/**
+ * Returns a same-length array of 1-based phase numbers, one per input item,
+ * computed by greedily packing whole pages (consecutive runs of the same
+ * groupKey+pageKey) into phases of ~`targetPhaseSize` items. `items` MUST
+ * already be in catalog order (e.g. sorted by the `order` field).
+ */
+export function assignDefaultPhases(itemsInCatalogOrder, targetPhaseSize = DEFAULT_TESTER_PHASE_SIZE) {
+    const phaseNumbers = new Array(itemsInCatalogOrder.length);
+    let currentPhase = 1;
+    let currentPhaseCount = 0;
+    let lastPageKey = null;
+    for (let i = 0; i < itemsInCatalogOrder.length; i++) {
+        const item = itemsInCatalogOrder[i];
+        const pageId = `${item.groupKey}␟${item.pageKey}`;
+        const isNewPage = pageId !== lastPageKey;
+        // Only allow a phase boundary between pages, never mid-page.
+        if (isNewPage && currentPhaseCount >= targetPhaseSize) {
+            currentPhase += 1;
+            currentPhaseCount = 0;
+        }
+        phaseNumbers[i] = currentPhase;
+        currentPhaseCount += 1;
+        lastPageKey = pageId;
+    }
+    return phaseNumbers;
+}

package/dist/features/whatsapp-bot/components/SellerWhatsAppSettingsView.js

@@ -166,7 +166,7 @@ export function SellerWhatsAppSettingsView({ hasCapability }) {
                             buyerName: "Ravi K.",
                             firstItemName: "Charizard PSA 9",
                             additionalItemCount: 2,
-                            totalAmount: 450000,
+                            totalAmount: 4500,
                             orderId: "order-3-20260510-a1b2c3",
                         }) })] }), _jsxs(Section, { className: CLS_SECTION_CARD, children: [_jsx(Heading, { level: 2, className: "mb-2", color: "primary", size: "sm", weight: "semibold", children: "Catalog Preview" }), _jsx(Text, { className: "mb-4", color: "muted", size: "xs", children: "This is how your products appear in the WhatsApp Catalog when a buyer taps \"View Catalog\" in the chat. Only published standard products are included." }), _jsxs(Div, { className: `${__O.hidden} bg-[var(--appkit-color-whatsapp-bg)] bg-[var(--appkit-color-surface-elevated)] ${__P.p3}`, rounded: "xl", border: "default", children: [_jsxs(Row, { gap: "sm", align: "center", className: "mb-3", children: [_jsx(Row, { className: "w-8 h-8 bg-[var(--appkit-color-whatsapp)]", align: "center", justify: "center", rounded: "full", children: _jsx(Text, { color: "inverse", size: "xs", weight: "bold", children: "W" }) }), _jsxs(Div, { children: [_jsx(Text, { size: "xs", weight: "semibold", color: "primary", children: cfg?.connected ? "Your Store" : "Store Name" }), _jsx(Text, { className: "text-[10px]", color: "muted", children: "WhatsApp Business" })] })] }), _jsx(Div, { layout: "grid", gap: "2", className: "grid-cols-2", children: SAMPLE_CATALOG_ITEMS.map((item) => (_jsxs(Div, { surface: "card", className: `${__O.hidden}`, children: [_jsx(Row, { className: "aspect-square", surface: "subtle", align: "center", justify: "center", children: _jsx(Text, { size: "2xl", children: item.emoji }) }), _jsxs(Div, { padding: "xs", children: [_jsx(Text, { className: "line-clamp-2 leading-tight", color: "primary", size: "xs", weight: "medium", children: item.name }), _jsx(Text, { className: "text-[var(--appkit-color-whatsapp)] mt-0.5", size: "xs", weight: "semibold", children: item.price })] })] }, item.id))) }), _jsx(Div, { className: "mt-3 text-center", children: _jsx(Text, { className: "text-[10px]", color: "muted", children: cfg?.lastSyncCount
                                         ? `${cfg.lastSyncCount} products synced to catalog`

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` */
@@ -85,7 +104,7 @@ export interface PurchaseAnnouncementInput {
     firstItemName: string;
     /** 0 if only one item in the order */
     additionalItemCount: number;
-    /** Total order amount in paise */
+    /** Total order amount in decimal rupees */
     totalAmount: number;
     orderId: string;
 }

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

@@ -26,6 +26,9 @@ export interface WishlistProductData {
     isFeatured?: boolean;
     /** Canonical listing-kind discriminator (SB1-G Phase 4). */
     listingType?: ListingType;
+    /** Already present on the wire — GET /api/user/wishlist spreads the full
+     *  ProductDocument into `product`, this was just untyped. */
+    isSold?: boolean;
 }
 /** WishlistItem enriched with inline product details returned by the wishlist GET endpoint. */
 export interface EnrichedWishlistItem extends WishlistItem {

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";
@@ -913,6 +915,8 @@ export type { AboutHowItem } from "./features/about/index";
 export type { AboutMilestone } from "./features/about/index";
 export type { AboutValueItem } from "./features/about/index";
 export type { AboutViewProps } from "./features/about/index";
+export type { AboutTeamMember } from "./features/about/index";
+export type { AboutContentDocument } from "./features/about/index";
 export type { FAQPageViewProps } from "./features/about/index";
 export type { FeesViewProps } from "./features/about/index";
 export type { HelpPageViewProps } from "./features/about/index";
@@ -1149,6 +1153,10 @@ export { AdminNotificationsView } from "./features/admin/index";
 export { AdminCartsView } from "./features/admin/index";
 export { AdminWishlistsView } from "./features/admin/index";
 export { AdminHistoryView } from "./features/admin/index";
+export { AdminGroupedListingsView } from "./features/admin/index";
+export type { AdminGroupedListingsViewProps } from "./features/admin/index";
+export { AdminCarouselGroupEditorView } from "./features/admin/index";
+export type { AdminCarouselGroupEditorViewProps } from "./features/admin/index";
 export { AdminContactEditorView } from "./features/admin/index";
 export type { AdminContactEditorViewProps } from "./features/admin/index";
 export { AdminReturnRequestsView } from "./features/admin/index";
@@ -1180,6 +1188,10 @@ export { DEFAULT_TRUST_BAR_ITEMS } from "./features/admin/index";
 export { DashboardStatsGrid } from "./features/admin/index";
 export { AdminTeamView } from "./features/admin/index";
 export { AdminEmployeeEditorView } from "./features/admin/index";
+export { PERMISSION_GROUPS } from "./features/auth/permissions/constants";
+export { PERMISSION_DOMAINS } from "./features/auth/permissions/constants";
+export { getPermissionsForDomain } from "./features/auth/permissions/constants";
+export { formatPermLabel } from "./features/auth/permissions/constants";
 export { AdminSupportTicketsView } from "./features/admin/index";
 export { AdminSupportTicketDetailView } from "./features/admin/index";
 export { DrawerFormFooter } from "./features/admin/index";
@@ -2206,7 +2218,6 @@ export type { MediaUploadResult } from "./features/media/index";
 export type { MediaVideoProps } from "./features/media/index";
 export type { VideoThumbnailSelectorProps } from "./features/media/index";
 export type { VideoTrimModalProps } from "./features/media/index";
-export { extractStoragePathFromUrl } from "./features/media/server";
 export { finalizeStagedMediaArray } from "./features/media/server";
 export { finalizeStagedMediaField } from "./features/media/server";
 export { finalizeStagedMediaObject } from "./features/media/server";
@@ -2444,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";
@@ -3088,7 +3099,7 @@ export { SUCCESS_MESSAGES } from "./values/index";
 export { splitCartIntoOrderGroups } from "./features/orders/index";
 export { groupOrderItemsByBundle, type BundleOrderGroup, type OrderItemForBundleGrouping, } from "./features/orders/index";
 export { buildSieveFilters } from "./utils/filter.helper";
-export { formatFileSize } from "./utils/number.formatter";
+export { formatCurrency, formatFileSize } from "./utils/number.formatter";
 export { formatMonthYear } from "./utils/date.formatter";
 export { generateMediaFilename } from "./utils/id-generators";
 export { deriveContextTypeFromFilename } from "./utils/id-generators";
@@ -3217,8 +3228,6 @@ export { MarketplaceBundleCard } from "./features/products/index";
 export type { MarketplaceBundleCardProps, MarketplaceBundleCardData, MarketplaceBundleCardLabels, } from "./features/products/index";
 export { SellerStoreCategoriesView } from "./features/seller/components/SellerStoreCategoriesView";
 export type { SellerStoreCategoriesViewProps } from "./features/seller/components/SellerStoreCategoriesView";
-export { SellerTemplatesView } from "./features/seller/components/SellerTemplatesView";
-export type { SellerTemplatesViewProps } from "./features/seller/components/SellerTemplatesView";
 export { SellerPayoutMethodsView } from "./features/seller/components/SellerPayoutMethodsView";
 export type { SellerPayoutMethodsViewProps } from "./features/seller/components/SellerPayoutMethodsView";
 export { SellerShippingConfigsView } from "./features/seller/components/SellerShippingConfigsView";

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.
@@ -1790,10 +1792,10 @@ export { createRazorpayRefund } from "./providers/payment-razorpay/index";
 // fetchRazorpayOrder - Shared export for fetch razorpay order.
 export { fetchRazorpayOrder } from "./providers/payment-razorpay/index";
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// paiseToRupees - Shared export for paise to rupees.
+// paiseToRupees - Shared export for paise to rupees. // audit-money-units-ok: names the boundary conversion function itself
 export { paiseToRupees } from "./providers/payment-razorpay/index";
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// rupeesToPaise - Shared export for rupees to paise.
+// rupeesToPaise - Shared export for rupees to paise. // audit-money-units-ok: names the boundary conversion function itself
 export { rupeesToPaise } from "./providers/payment-razorpay/index";
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
 // verifyPaymentSignature - Shared export for verify payment signature.
@@ -2219,6 +2221,10 @@ export { AdminCartsView } from "./features/admin/index";
 export { AdminWishlistsView } from "./features/admin/index";
 // AdminHistoryView - Admin read-only history insights listing (S44 follow-up).
 export { AdminHistoryView } from "./features/admin/index";
+// AdminGroupedListingsView - Admin cross-store grouped-listings moderation view (W1-29).
+export { AdminGroupedListingsView } from "./features/admin/index";
+// AdminCarouselGroupEditorView - Create form for named carousel groups (EX2 nav-wiring fix).
+export { AdminCarouselGroupEditorView } from "./features/admin/index";
 // AdminContactEditorView - Admin contact submission detail SideDrawer (B7/VA15).
 export { AdminContactEditorView } from "./features/admin/index";
 // AdminReturnRequestsView - Admin return requests queue filtered to RETURN_REQUESTED (LL16).
@@ -2279,6 +2285,14 @@ export { DashboardStatsGrid } from "./features/admin/index";
 export { AdminTeamView } from "./features/admin/index";
 // AdminEmployeeEditorView - Invite/edit employee permissions SideDrawer.
 export { AdminEmployeeEditorView } from "./features/admin/index";
+// PERMISSION_GROUPS - Preset employee-group -> Permission[] bundles (S-ADMIN-7).
+export { PERMISSION_GROUPS } from "./features/auth/permissions/constants";
+// PERMISSION_DOMAINS - Domain label/prefix groupings for the permissions catalog page.
+export { PERMISSION_DOMAINS } from "./features/auth/permissions/constants";
+// getPermissionsForDomain - Every distinct permission across PERMISSION_GROUPS matching a domain prefix.
+export { getPermissionsForDomain } from "./features/auth/permissions/constants";
+// formatPermLabel - "admin:orders:read" -> "Read" display formatting.
+export { formatPermLabel } from "./features/auth/permissions/constants";
 // AdminSupportTicketsView - Admin support ticket list view.
 export { AdminSupportTicketsView } from "./features/admin/index";
 // AdminSupportTicketDetailView - Admin support ticket detail/reply SideDrawer.
@@ -4066,9 +4080,6 @@ export { useMediaTrim } from "./features/media/index";
 export { useMediaUpload } from "./features/media/index";
 // ./features/media/server
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// extractStoragePathFromUrl - Shared export for extract storage path from url.
-export { extractStoragePathFromUrl } from "./features/media/server";
-// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
 // finalizeStagedMediaArray - Shared export for finalize staged media array.
 export { finalizeStagedMediaArray } from "./features/media/server";
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
@@ -4489,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.
@@ -5517,7 +5528,7 @@ export { splitCartIntoOrderGroups } from "./features/orders/index";
 export { groupOrderItemsByBundle, } from "./features/orders/index";
 // -- Missing utils
 export { buildSieveFilters } from "./utils/filter.helper";
-export { formatFileSize } from "./utils/number.formatter";
+export { formatCurrency, formatFileSize } from "./utils/number.formatter";
 export { formatMonthYear } from "./utils/date.formatter";
 export { generateMediaFilename } from "./utils/id-generators"; // generateProductImageFilename already exported from "./utils/id-generators";
 export { deriveContextTypeFromFilename } from "./utils/id-generators";
@@ -5646,7 +5657,6 @@ export { getLiveItemForDetail } from "./_internal/server/features/live/data";
 export { MarketplaceBundleCard } from "./features/products/index";
 // ── Wave 4 Seller management views ───────────────────────────────────────────
 export { SellerStoreCategoriesView } from "./features/seller/components/SellerStoreCategoriesView";
-export { SellerTemplatesView } from "./features/seller/components/SellerTemplatesView";
 export { SellerPayoutMethodsView } from "./features/seller/components/SellerPayoutMethodsView";
 export { SellerShippingConfigsView } from "./features/seller/components/SellerShippingConfigsView";
 export { SellerGoogleReviewsView } from "./features/seller/components/SellerGoogleReviewsView";

package/dist/next/components/NotFoundView.js

@@ -18,8 +18,9 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  */
 import { Heading, Text } from "../../ui/components/Typography";
 import { TextLink } from "../../ui/components/TextLink";
+import { SiteMark } from "../../ui/components/SiteMark";
 import { DEFAULT_ROUTE_MAP } from "../routing/route-map";
 import { Stack } from "@mohasinac/appkit";
 export function NotFoundView({ heading = "404 — Page not found", description = "The page you are looking for does not exist.", homeLabel = "Go home", homeHref = DEFAULT_ROUTE_MAP.HOME, }) {
-    return (_jsxs(Stack, { justify: "center", className: "min-h-[60vh] text-center", padding: "x-xl", align: "center", children: [_jsx(Heading, { level: 1, variant: "primary", size: "7xl", className: "mb-2", weight: "bold", children: "404" }), _jsx(Heading, { level: 2, className: "mb-3", children: heading }), _jsx(Text, { variant: "secondary", className: "mb-8", children: description }), _jsx(TextLink, { href: homeHref, children: homeLabel })] }));
+    return (_jsxs(Stack, { justify: "center", className: "min-h-[60vh] text-center", padding: "x-xl", align: "center", children: [_jsx(SiteMark, { size: "xl" }), _jsx(Heading, { level: 1, variant: "primary", size: "7xl", className: "mb-2", weight: "bold", children: "404" }), _jsx(Heading, { level: 2, className: "mb-3", children: heading }), _jsx(Text, { variant: "secondary", className: "mb-8", children: description }), _jsx(TextLink, { href: homeHref, children: homeLabel })] }));
 }

package/dist/next/routing/route-map.d.ts

@@ -116,6 +116,7 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly CLOSE: "/auth/close";
     };
     readonly USER: {
+        readonly DASHBOARD: "/user";
         readonly PROFILE: "/user/profile";
         readonly SETTINGS: "/user/settings";
         readonly ORDERS: "/user/orders";
@@ -170,9 +171,6 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly COUPONS: "/store/coupons";
         readonly COUPONS_NEW: "/store/coupons/new";
         readonly COUPONS_EDIT: (id: string) => string;
-        readonly TEMPLATES: "/store/templates";
-        readonly TEMPLATES_NEW: "/store/templates/new";
-        readonly TEMPLATES_EDIT: (id: string) => string;
         readonly ANALYTICS: "/store/analytics";
         readonly PAYOUTS: "/store/payouts";
         readonly STOREFRONT: "/store/storefront";
@@ -214,7 +212,6 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly STICKERS_NEW: "/store/stickers/new";
         readonly STICKERS_EDIT: (id: string) => string;
         readonly PRINT_CENTER: "/store/print-center";
-        readonly INVENTORY_PRINT: "/store/inventory/print";
         readonly FULFILLMENT: "/store/fulfillment";
         readonly PAYOUT_METHODS: "/store/payout-methods";
         readonly PAYOUT_METHODS_NEW: "/store/payout-methods/new";
@@ -251,6 +248,7 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly CATALOGUE_APPROVALS: "/admin/catalogue-approvals";
         readonly USERS: "/admin/users";
         readonly SITE: "/admin/site";
+        readonly INTEGRATION_GUIDES: "/admin/integration-guides";
         readonly CAROUSEL: "/admin/carousel";
         readonly CAROUSEL_NEW: "/admin/carousel/new";
         readonly CAROUSEL_EDIT: (id: string) => string;
@@ -338,6 +336,7 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly SETTINGS_ACTIONS: "/admin/settings/actions";
         readonly SETTINGS_NAVIGATION: "/admin/settings/navigation";
         readonly PRINT_CENTER: "/admin/print-center";
+        readonly MAINTENANCE: "/admin/maintenance";
         readonly FULFILLMENT: "/admin/fulfillment";
         readonly MODERATION: "/admin/moderation";
         readonly MODERATION_DETAIL: (id: string) => string;
@@ -477,6 +476,7 @@ export declare const ROUTES: {
         readonly CLOSE: "/auth/close";
     };
     readonly USER: {
+        readonly DASHBOARD: "/user";
         readonly PROFILE: "/user/profile";
         readonly SETTINGS: "/user/settings";
         readonly ORDERS: "/user/orders";
@@ -531,9 +531,6 @@ export declare const ROUTES: {
         readonly COUPONS: "/store/coupons";
         readonly COUPONS_NEW: "/store/coupons/new";
         readonly COUPONS_EDIT: (id: string) => string;
-        readonly TEMPLATES: "/store/templates";
-        readonly TEMPLATES_NEW: "/store/templates/new";
-        readonly TEMPLATES_EDIT: (id: string) => string;
         readonly ANALYTICS: "/store/analytics";
         readonly PAYOUTS: "/store/payouts";
         readonly STOREFRONT: "/store/storefront";
@@ -575,7 +572,6 @@ export declare const ROUTES: {
         readonly STICKERS_NEW: "/store/stickers/new";
         readonly STICKERS_EDIT: (id: string) => string;
         readonly PRINT_CENTER: "/store/print-center";
-        readonly INVENTORY_PRINT: "/store/inventory/print";
         readonly FULFILLMENT: "/store/fulfillment";
         readonly PAYOUT_METHODS: "/store/payout-methods";
         readonly PAYOUT_METHODS_NEW: "/store/payout-methods/new";
@@ -612,6 +608,7 @@ export declare const ROUTES: {
         readonly CATALOGUE_APPROVALS: "/admin/catalogue-approvals";
         readonly USERS: "/admin/users";
         readonly SITE: "/admin/site";
+        readonly INTEGRATION_GUIDES: "/admin/integration-guides";
         readonly CAROUSEL: "/admin/carousel";
         readonly CAROUSEL_NEW: "/admin/carousel/new";
         readonly CAROUSEL_EDIT: (id: string) => string;
@@ -699,6 +696,7 @@ export declare const ROUTES: {
         readonly SETTINGS_ACTIONS: "/admin/settings/actions";
         readonly SETTINGS_NAVIGATION: "/admin/settings/navigation";
         readonly PRINT_CENTER: "/admin/print-center";
+        readonly MAINTENANCE: "/admin/maintenance";
         readonly FULFILLMENT: "/admin/fulfillment";
         readonly MODERATION: "/admin/moderation";
         readonly MODERATION_DETAIL: (id: string) => string;
@@ -749,9 +747,6 @@ export declare const SELLER_ROUTES: {
     readonly COUPONS: "/store/coupons";
     readonly COUPONS_NEW: "/store/coupons/new";
     readonly COUPONS_EDIT: (id: string) => string;
-    readonly TEMPLATES: "/store/templates";
-    readonly TEMPLATES_NEW: "/store/templates/new";
-    readonly TEMPLATES_EDIT: (id: string) => string;
     readonly ANALYTICS: "/store/analytics";
     readonly PAYOUTS: "/store/payouts";
     readonly STOREFRONT: "/store/storefront";
@@ -793,7 +788,6 @@ export declare const SELLER_ROUTES: {
     readonly STICKERS_NEW: "/store/stickers/new";
     readonly STICKERS_EDIT: (id: string) => string;
     readonly PRINT_CENTER: "/store/print-center";
-    readonly INVENTORY_PRINT: "/store/inventory/print";
     readonly FULFILLMENT: "/store/fulfillment";
     readonly PAYOUT_METHODS: "/store/payout-methods";
     readonly PAYOUT_METHODS_NEW: "/store/payout-methods/new";

package/dist/next/routing/route-map.js

@@ -110,6 +110,7 @@ export const DEFAULT_ROUTE_MAP = {
         CLOSE: "/auth/close",
     },
     USER: {
+        DASHBOARD: "/user",
         PROFILE: "/user/profile",
         SETTINGS: "/user/settings",
         ORDERS: "/user/orders",
@@ -164,9 +165,6 @@ export const DEFAULT_ROUTE_MAP = {
         COUPONS: "/store/coupons",
         COUPONS_NEW: "/store/coupons/new",
         COUPONS_EDIT: (id) => `/store/coupons/${id}/edit`,
-        TEMPLATES: "/store/templates",
-        TEMPLATES_NEW: "/store/templates/new",
-        TEMPLATES_EDIT: (id) => `/store/templates/${id}/edit`,
         ANALYTICS: "/store/analytics",
         PAYOUTS: "/store/payouts",
         STOREFRONT: "/store/storefront",
@@ -211,7 +209,6 @@ export const DEFAULT_ROUTE_MAP = {
         STICKERS_NEW: "/store/stickers/new",
         STICKERS_EDIT: (id) => `/store/stickers/${id}/edit`,
         PRINT_CENTER: "/store/print-center",
-        INVENTORY_PRINT: "/store/inventory/print",
         FULFILLMENT: "/store/fulfillment",
         // S-STORE Tier — new extension routes
         PAYOUT_METHODS: "/store/payout-methods",
@@ -250,6 +247,7 @@ export const DEFAULT_ROUTE_MAP = {
         CATALOGUE_APPROVALS: "/admin/catalogue-approvals",
         USERS: "/admin/users",
         SITE: "/admin/site",
+        INTEGRATION_GUIDES: "/admin/integration-guides",
         CAROUSEL: "/admin/carousel",
         CAROUSEL_NEW: "/admin/carousel/new",
         CAROUSEL_EDIT: (id) => `/admin/carousel/${id}/edit`,
@@ -340,6 +338,7 @@ export const DEFAULT_ROUTE_MAP = {
         SETTINGS_ACTIONS: "/admin/settings/actions",
         SETTINGS_NAVIGATION: "/admin/settings/navigation",
         PRINT_CENTER: "/admin/print-center",
+        MAINTENANCE: "/admin/maintenance",
         FULFILLMENT: "/admin/fulfillment",
         // S-STORE Tier — admin moderation + reports + item requests
         MODERATION: "/admin/moderation",