@mohasinac/appkit 3.5.6 → 3.5.8

package/dist/_internal/client/features/tour/TourProvider.d.ts

@@ -1,11 +1,19 @@
 import React from "react";
+import type { DriveStep } from "driver.js";
+export type TourRole = "buyer" | "seller" | "admin";
 export interface TourContextValue {
-    startTour: () => void;
+    /** Starts the tour for the given role (defaults to "buyer"). */
+    startTour: (role?: TourRole) => void;
 }
 export declare function useTour(): TourContextValue;
+export declare const CUSTOMER_TOUR_STEPS: DriveStep[];
+export declare const SELLER_TOUR_STEPS: DriveStep[];
+export declare const ADMIN_TOUR_STEPS: DriveStep[];
 /**
- * TourProvider — skeleton shell for Patch 1.
- * driver.js steps are wired in Patch 2+; this provider is an identity wrapper.
+ * TourProvider — lazily imports driver.js on first use so it never lands in
+ * the initial bundle. Respects prefers-reduced-motion by disabling driver.js's
+ * highlight animation (the tour itself — step-to-step navigation — still
+ * works; only the animated transition is skipped).
  */
 export declare function TourProvider({ children }: {
     children: React.ReactNode;

package/dist/_internal/client/features/tour/TourProvider.js

@@ -7,13 +7,102 @@ const TourContext = React.createContext({
 export function useTour() {
     return React.useContext(TourContext);
 }
+const step = (element, title, description) => ({
+    element,
+    popover: { title, description },
+    skipMissingElement: true,
+});
+// P-16 — role-specific step sets. Anchors are `data-tour="…"` attributes on
+// TitleBarLayout's icon buttons (present on every page) plus a couple of
+// dashboard-specific anchors. `skipMissingElement: true` on every step means
+// a step whose target isn't on the current page is silently skipped rather
+// than breaking the tour — the same tour can be started from anywhere.
+export const CUSTOMER_TOUR_STEPS = [
+    step('[data-tour="nav-search"]', "Search", "Search by name, brand, or price to find what you're after."),
+    step('[data-tour="nav-wishlist"]', "Wishlist", "Save items here to come back to them later."),
+    step('[data-tour="nav-cart"]', "Cart", "Review your items and check out when you're ready."),
+    step('[data-tour="nav-profile"]', "Your account", "Manage your profile, orders, and messages here."),
+    {
+        popover: {
+            title: "Checkout",
+            description: "At checkout, pay via UPI, cash, EMI, or COD — whatever suits you.",
+        },
+        skipMissingElement: true,
+    },
+    {
+        popover: {
+            title: "Track your orders",
+            description: "Every order's status, tracking, and invoice lives in My Orders.",
+        },
+        skipMissingElement: true,
+    },
+];
+export const SELLER_TOUR_STEPS = [
+    step('[data-tour="store-products"]', "Your listings", "Create and manage your product listings here."),
+    {
+        popover: {
+            title: "Product form",
+            description: "Fill in details, images, and pricing — you can save as a draft anytime.",
+        },
+        skipMissingElement: true,
+    },
+    step('[data-tour="store-orders"]', "Incoming orders", "See and manage orders as buyers place them."),
+    {
+        popover: {
+            title: "Mark as shipped",
+            description: "Open an order to enter the carrier name and tracking number once it ships.",
+        },
+        skipMissingElement: true,
+    },
+    step('[data-tour="nav-profile"]', "Store settings", "Set up your store profile, shipping, and pickup address."),
+    step('[data-tour="store-analytics"]', "Analytics", "Track your sales, revenue, and top products."),
+    step('[data-tour="store-payouts"]', "Payouts", "See what you've earned and your payout history."),
+];
+export const ADMIN_TOUR_STEPS = [
+    step('[data-tour="admin-orders"]', "Marketplace orders", "All orders across every store, in one place."),
+    {
+        popover: {
+            title: "Verify payments",
+            description: "Open an order to confirm manual payments and update its status.",
+        },
+        skipMissingElement: true,
+    },
+    step('[data-tour="admin-products"]', "Moderation", "Approve or reject listings before they go live."),
+    step('[data-tour="admin-users"]', "Users", "Manage buyer and seller accounts."),
+    step('[data-tour="admin-stores"]', "Stores", "Approve new store applications."),
+    step('[data-tour="admin-analytics"]', "Analytics", "Platform-wide GMV, orders, and top products."),
+    step('[data-tour="admin-settings"]', "Site settings", "Configure how the platform behaves."),
+    step('[data-tour="admin-feature-flags"]', "Feature flags", "Turn platform features on or off."),
+];
+const STEP_SETS = {
+    buyer: CUSTOMER_TOUR_STEPS,
+    seller: SELLER_TOUR_STEPS,
+    admin: ADMIN_TOUR_STEPS,
+};
 /**
- * TourProvider — skeleton shell for Patch 1.
- * driver.js steps are wired in Patch 2+; this provider is an identity wrapper.
+ * TourProvider — lazily imports driver.js on first use so it never lands in
+ * the initial bundle. Respects prefers-reduced-motion by disabling driver.js's
+ * highlight animation (the tour itself — step-to-step navigation — still
+ * works; only the animated transition is skipped).
  */
 export function TourProvider({ children }) {
-    const startTour = React.useCallback(() => {
-        // driver.js will be imported and configured here in Patch 2+.
+    const startTour = React.useCallback((role = "buyer") => {
+        if (typeof window === "undefined")
+            return;
+        void (async () => {
+            const [{ driver }] = await Promise.all([
+                import("driver.js"),
+                import("driver.js/dist/driver.css"),
+            ]);
+            const reducedMotion = window.matchMedia?.("(prefers-reduced-motion: reduce)")?.matches ?? false;
+            const config = {
+                showProgress: true,
+                animate: !reducedMotion,
+                allowClose: true,
+                steps: STEP_SETS[role],
+            };
+            driver(config).drive();
+        })();
     }, []);
     return (_jsx(TourContext.Provider, { value: { startTour }, children: children }));
 }

package/dist/_internal/server/features/checkout/actions.js

@@ -11,7 +11,9 @@ import { safeFireAndForget } from "../../../../utils/safe-fire-forget";
 import { ApiError, ValidationError, NotFoundError, ERROR_MESSAGES } from "../../../../errors";
 import { ORDER_FIELDS } from "../../../../constants/field-names";
 import { serverLogger } from "../../../../monitoring";
-import { unitOfWork, siteSettingsRepository, userRepository, storeRepository, couponsRepository, notificationRepository, claimedCouponsRepository, } from "../../../../repositories";
+import { unitOfWork, siteSettingsRepository, userRepository, storeRepository, couponsRepository, notificationRepository, claimedCouponsRepository, addressesRepository, } from "../../../../repositories";
+import { calculateGst } from "../../../shared/fees/calculator";
+import { computePreOrderDepositAmount } from "../../../shared/checkout/order-math";
 import { failedCheckoutRepository } from "../../../../features/checkout/repository/failed-checkout.repository";
 import { sendOrderConfirmationEmail } from "../../../../features/contact/server";
 import { splitCartIntoOrderGroups } from "../../../../features/orders/index";
@@ -153,17 +155,24 @@ function accumulateCouponUsage(accumulator, couponCode, couponId, discountAmount
 }
 async function resolveShippingCost(storeId) {
     if (!storeId)
-        return { shippingFee: 0, storeOwnerId: undefined, storeEmiEnabled: false };
+        return { shippingFee: 0, storeOwnerId: undefined, storeEmiEnabled: false, storeState: undefined };
     const store = await storeRepository.findById(storeId);
     const storeOwnerId = store?.ownerId;
     const storeEmiEnabled = store?.emiEnabled === true;
+    const storeState = await resolveStoreState(storeId);
     if (!storeOwnerId)
-        return { shippingFee: 0, storeOwnerId: undefined, storeEmiEnabled };
+        return { shippingFee: 0, storeOwnerId: undefined, storeEmiEnabled, storeState };
     const sellerUser = await userRepository.findById(storeOwnerId);
     const shippingConfig = sellerUser?.shippingConfig;
     if (!shippingConfig?.isConfigured)
-        return { shippingFee: 0, storeOwnerId, storeEmiEnabled };
-    return { shippingFee: shippingConfig.customShippingPrice ?? 0, storeOwnerId, storeEmiEnabled };
+        return { shippingFee: 0, storeOwnerId, storeEmiEnabled, storeState };
+    return { shippingFee: shippingConfig.customShippingPrice ?? 0, storeOwnerId, storeEmiEnabled, storeState };
+}
+/** P-8 GST — the seller's registered/pickup state, used to determine intra- vs inter-state tax. */
+async function resolveStoreState(storeId) {
+    const addresses = await addressesRepository.listByOwner("store", storeId);
+    const pickup = addresses.find((a) => a.isDefault) ?? addresses[0];
+    return pickup?.state;
 }
 function buildStockUpdatePayload(product, qtyDelta) {
     const lt = (product.listingType ?? "standard");
@@ -238,7 +247,7 @@ function unitPriceFor(item, product) {
  * so the caller can accumulate the checkout-wide `total`.
  */
 async function createOrderForGroup(group, orderType, ctx) {
-    const { paymentMethod, emiTenureMonths, emiSettings, commissions, appliedCoupons, cartSubtotal, couponUsageAccumulator, uid, userName, userEmail, shippingAddress, notes, adminBypass, adminBypassBy, adminBatchId, orderIds, emailsToSend, outOfStockPolicy, droppedItems, } = ctx;
+    const { paymentMethod, emiTenureMonths, emiSettings, commissions, appliedCoupons, cartSubtotal, couponUsageAccumulator, uid, userName, userEmail, shippingAddress, notes, adminBypass, adminBypassBy, adminBatchId, orderIds, emailsToSend, outOfStockPolicy, droppedItems, buyerState, gstSettings, } = ctx;
     const firstItem = group[0].item;
     const firstProduct = group[0].product;
     const groupTotal = group.reduce((sum, { item, product }) => sum + unitPriceFor(item, product) * item.quantity, 0);
@@ -255,6 +264,9 @@ async function createOrderForGroup(group, orderType, ctx) {
             }
             : {};
         const unitPrice = unitPriceFor(item, product);
+        const gstFields = product.gstRate != null
+            ? { gstRate: product.gstRate, ...(product.hsnCode ? { hsnCode: product.hsnCode } : {}) }
+            : {};
         const baseLine = {
             productId: item.productId,
             productTitle: item.productTitle,
@@ -262,15 +274,41 @@ async function createOrderForGroup(group, orderType, ctx) {
             unitPrice,
             totalPrice: unitPrice * item.quantity,
             ...bundleFields,
+            ...gstFields,
         };
         return itemRule.decorateOrderItem(baseLine, product);
     });
     const totalQuantity = group.reduce((sum, { item }) => sum + item.quantity, 0);
-    const { shippingFee, storeOwnerId, storeEmiEnabled } = await resolveShippingCost(firstItem.storeId);
+    const { shippingFee, storeOwnerId, storeEmiEnabled, storeState } = await resolveShippingCost(firstItem.storeId);
+    // P-8 GST — sum per-line-item tax (each product may carry its own gstRate),
+    // then split the group total into a single cgst/sgst/igst breakdown for the
+    // order document. Skipped entirely when GST is off or the buyer's state is
+    // unknown (digital-only carts have no shipping address).
+    let gstBreakdown;
+    if (gstSettings?.enabled && buyerState) {
+        const intraState = !!storeState && storeState === buyerState;
+        let taxableAmount = 0;
+        let gstAmount = 0;
+        for (const { item, product } of group) {
+            const lineTotal = unitPriceFor(item, product) * item.quantity;
+            const rate = product.gstRate ?? 0;
+            if (rate > 0) {
+                taxableAmount += lineTotal;
+                gstAmount += calculateGst(rate, intraState, lineTotal).gstAmount;
+            }
+        }
+        if (taxableAmount > 0) {
+            gstBreakdown = intraState
+                ? { taxableAmount, cgst: Math.round(gstAmount / 2), sgst: gstAmount - Math.round(gstAmount / 2), igst: 0, gstAmount }
+                : { taxableAmount, cgst: 0, sgst: 0, igst: gstAmount, gstAmount };
+        }
+    }
     const isCodLike = paymentMethod === "cod" || paymentMethod === "upi_manual" || paymentMethod === "cash";
-    const depositAmount = isCodLike
-        ? Math.round(groupTotal * (commissions.codDepositPercent / 100) * 100) / 100
-        : undefined;
+    const depositAmount = !isCodLike
+        ? undefined
+        : orderType === "preorder"
+            ? computePreOrderDepositAmount(group, commissions.codDepositPercent)
+            : Math.round(groupTotal * (commissions.codDepositPercent / 100) * 100) / 100;
     const codRemainingAmount = isCodLike
         ? Math.round((groupTotal - (depositAmount ?? 0)) * 100) / 100
         : undefined;
@@ -329,7 +367,7 @@ async function createOrderForGroup(group, orderType, ctx) {
         }
     }
     couponDiscount = Math.min(couponDiscount, groupTotal);
-    const orderTotal = Math.max(0, groupTotal - couponDiscount) + shippingFee + codHandlingFee + (emiSchedule?.surchargeAmount ?? 0);
+    const orderTotal = Math.max(0, groupTotal - couponDiscount) + shippingFee + codHandlingFee + (emiSchedule?.surchargeAmount ?? 0) + (gstBreakdown?.gstAmount ?? 0);
     const imageUrls = [
         ...new Set(group
             .map(({ product }) => product.mainImage)
@@ -370,6 +408,11 @@ async function createOrderForGroup(group, orderType, ctx) {
         depositAmount: adminBypass ? undefined : depositAmount,
         codRemainingAmount: adminBypass ? undefined : codRemainingAmount,
         codHandlingFee: !adminBypass && codHandlingFee > 0 ? codHandlingFee : undefined,
+        taxableAmount: gstBreakdown?.taxableAmount,
+        gstAmount: gstBreakdown?.gstAmount,
+        cgst: gstBreakdown?.cgst || undefined,
+        sgst: gstBreakdown?.sgst || undefined,
+        igst: gstBreakdown?.igst || undefined,
         emiEnabled: !adminBypass && !!emiSchedule ? true : undefined,
         emiTenureMonths: !adminBypass && emiSchedule ? emiTenureMonths : undefined,
         emiTokenAmount: !adminBypass ? emiSchedule?.tokenAmount : undefined,
@@ -666,6 +709,8 @@ export async function createCheckoutOrderAction(input) {
         emailsToSend,
         outOfStockPolicy,
         droppedItems: unavailable,
+        buyerState: resolvedAddress?.state,
+        gstSettings: siteSettings?.gst,
     };
     for (const { items: group, orderType } of orderGroups) {
         total += await createOrderForGroup(group, orderType, groupCtx);
@@ -1018,6 +1063,15 @@ export async function verifyAndPlaceRazorpayOrderAction(input) {
         const platformFee = rawPlatformFee + gstOnFee;
         const orderTotal = Math.max(0, groupTotal - couponDiscount) + shippingFee;
         total += orderTotal;
+        // P-8 GST — deliberately NOT wired into this Razorpay-verify path. The
+        // amount-mismatch check above (expectedPaymentAmountRs) compares against
+        // what the buyer already paid via the Razorpay order created earlier in
+        // the flow; adding product GST here without also adding it to that
+        // upstream pre-payment amount calculation would either fail the mismatch
+        // check or silently under/over-charge. Wiring GST through the full
+        // Razorpay create→verify round-trip is separate follow-up work, tracked
+        // alongside P-13 (Razorpay is disabled by default today, so this order
+        // type doesn't currently carry a GST breakdown).
         // S-SBUNI-RULES 2026-05-13 — order-item decoration via rule registry.
         const orderItems = group.map(({ item, product }) => {
             const lt = (product?.listingType ?? "standard");

package/dist/_internal/server/features/orders/adapters.js

@@ -19,6 +19,9 @@ export function orderDocumentToOrder(doc) {
             ...(item.revealedItemNumber != null
                 ? { revealedItemNumber: item.revealedItemNumber }
                 : {}),
+            ...(item.cancelledQuantity != null
+                ? { cancelledQuantity: item.cancelledQuantity }
+                : {}),
         }))
         : [
             {

package/dist/_internal/shared/actions/action-registry.js

@@ -654,6 +654,18 @@ export const ACTIONS = {
                 confirmKind: "danger",
             },
         },
+        "cancel-order-items": {
+            id: "user.cancel-order-items",
+            label: "Cancel Selected Items",
+            description: "Cancel a subset of items on a pending or confirmed order and continue with the rest.",
+            kind: "danger",
+            confirmation: {
+                title: "Cancel selected items?",
+                body: "The selected items will be cancelled and refunded within 5–7 business days. The rest of your order will continue as normal.",
+                confirmLabel: "Cancel selected items",
+                confirmKind: "danger",
+            },
+        },
         "request-return": {
             id: "user.request-return",
             label: "Request return",
@@ -1090,6 +1102,14 @@ export const ACTIONS = {
             },
         },
         // ── Payout management ──────────────────────────────────────────────────
+        "calculate-payouts": {
+            id: "admin.calculate-payouts",
+            label: "Calculate Payouts",
+            ariaLabel: "Run the weekly payout eligibility calculation",
+            description: "Runs the same weekly sweep as the scheduled job on demand, generating pending payout records for eligible sellers.",
+            kind: "primary",
+            permissions: ["admin"],
+        },
         "grant-payout": {
             id: "admin.grant-payout",
             label: "Approve payout",

package/dist/_internal/shared/checkout/order-math.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Pure checkout line-item math shared between the checkout server actions
+ * and its test suite. No framework or Firestore imports — safe to unit test
+ * directly, unlike `checkout/actions.ts` whose module graph pulls in
+ * `server-only` guards that fail outside a real server-action test harness.
+ */
+import type { CartItemDocument } from "../../../features/cart/schemas/firestore";
+import type { ProductDocument } from "../../../features/products/schemas/firestore";
+export declare function unitPriceFor(item: CartItemDocument, product: ProductDocument | null): number;
+/**
+ * P-6 — pre-order groups charge each product's own `preOrderDepositPercent`
+ * (falling back to the generic COD deposit % when a product doesn't have one
+ * configured), summed per line. A single seller group can mix multiple
+ * pre-order products with different configured deposit percentages, so this
+ * cannot be a single group-level percentage the way the generic COD deposit
+ * calculation is.
+ */
+export declare function computePreOrderDepositAmount(group: Array<{
+    item: CartItemDocument;
+    product: ProductDocument;
+}>, defaultDepositPercent: number): number;

package/dist/_internal/shared/checkout/order-math.js

@@ -0,0 +1,24 @@
+// SB-UNI-5 2026-05-13 — bundle cart-lines use item.price (locked bundle price
+// at add-time); regular lines use product.price (current Firestore). Prevents
+// stale cart-cached prices from being charged on COD/UPI orders.
+export function unitPriceFor(item, product) {
+    return item.bundleCategorySlug && item.bundleProductIds?.length
+        ? item.price
+        : product.price;
+}
+/**
+ * P-6 — pre-order groups charge each product's own `preOrderDepositPercent`
+ * (falling back to the generic COD deposit % when a product doesn't have one
+ * configured), summed per line. A single seller group can mix multiple
+ * pre-order products with different configured deposit percentages, so this
+ * cannot be a single group-level percentage the way the generic COD deposit
+ * calculation is.
+ */
+export function computePreOrderDepositAmount(group, defaultDepositPercent) {
+    const raw = group.reduce((sum, { item, product }) => {
+        const lineTotal = unitPriceFor(item, product) * item.quantity;
+        const pct = product.preOrderDepositPercent ?? defaultDepositPercent;
+        return sum + lineTotal * (pct / 100);
+    }, 0);
+    return Math.round(raw * 100) / 100;
+}

package/dist/_internal/shared/features/orders/config.d.ts

@@ -1,5 +1,5 @@
 export declare const ORDERS_PAGE_SIZE = 20;
-export declare const ORDER_CANCELLABLE_STATUSES: readonly ["pending", "processing"];
+export declare const ORDER_CANCELLABLE_STATUSES: readonly ["pending", "confirmed"];
 export declare const ORDER_RETURN_WINDOW_DAYS = 7;
 export declare const ORDER_AUTO_CONFIRM_DAYS = 14;
 export declare const ORDER_CANCEL_REASON_MAX_LENGTH = 500;

package/dist/_internal/shared/features/orders/config.js

@@ -1,5 +1,5 @@
 export const ORDERS_PAGE_SIZE = 20;
-export const ORDER_CANCELLABLE_STATUSES = ["pending", "processing"];
+export const ORDER_CANCELLABLE_STATUSES = ["pending", "confirmed"];
 export const ORDER_RETURN_WINDOW_DAYS = 7;
 export const ORDER_AUTO_CONFIRM_DAYS = 14;
 export const ORDER_CANCEL_REASON_MAX_LENGTH = 500;

package/dist/_internal/shared/fees/calculator.d.ts

@@ -51,3 +51,16 @@ export interface CodHandlingFeeRates {
 }
 /** COD handling fee charged to the buyer: max(fixed floor, subtotal × percent). */
 export declare function computeCodHandlingFee(subtotal: number, rates: CodHandlingFeeRates): number;
+/**
+ * P-8 GST — buyer-facing product tax, distinct from the platform-commission
+ * GST above. Intra-state orders split the rate evenly between CGST + SGST;
+ * inter-state orders charge the full rate as IGST. All amounts in paise.
+ */
+export interface GstBreakdown {
+    taxableAmount: number;
+    cgst: number;
+    sgst: number;
+    igst: number;
+    gstAmount: number;
+}
+export declare function calculateGst(rate: number, intraState: boolean, taxableAmountInPaise: number): GstBreakdown;

package/dist/_internal/shared/fees/calculator.js

@@ -38,3 +38,11 @@ export function computeCodHandlingFee(subtotal, rates) {
     const percentFee = Math.round(subtotal * (percent / 100));
     return Math.max(minInPaise, percentFee);
 }
+export function calculateGst(rate, intraState, taxableAmountInPaise) {
+    const gstAmount = Math.round(taxableAmountInPaise * (rate / 100));
+    if (intraState) {
+        const half = Math.round(gstAmount / 2);
+        return { taxableAmount: taxableAmountInPaise, cgst: half, sgst: half, igst: 0, gstAmount: half * 2 };
+    }
+    return { taxableAmount: taxableAmountInPaise, cgst: 0, sgst: 0, igst: gstAmount, gstAmount };
+}

package/dist/client.d.ts

@@ -70,6 +70,9 @@ export { FirebaseClientAuthProvider } from "./providers/firebase-client/index";
 export { FirebaseClientRealtimeProvider } from "./providers/firebase-client/index";
 export { EventFormDrawer, EventParticipateView, EventPollWidget } from "./features/events/index";
 export type { EventParticipateViewProps } from "./features/events/index";
+export { useBulkEvent } from "./features/events/index";
+export type { UseBulkEventOptions, UseBulkEventReturn, BulkEventStatus } from "./features/events/index";
+export { RTDB_PATHS } from "./providers/db-firebase/index";
 export { LotterySlotGrid } from "./_internal/client/features/lottery/LotterySlotGrid";
 export { LotteryPullForm } from "./_internal/client/features/lottery/LotteryPullForm";
 export { LotteryListView } from "./_internal/client/features/lottery/LotteryListView";
@@ -157,6 +160,9 @@ export { AdminDashboardView, AdminAnalyticsView, AdminPrizeDrawsView, AdminCarou
 export type { AdminDashboardViewProps, AdminAnalyticsViewProps, AdminAnalyticsViewLabels, AdminPrizeDrawsViewProps, AdminCarouselViewProps, AdminFulfillmentViewProps, AdminListingScaffoldRow, ListingViewConfig } from "./features/admin/index";
 export type { BulkActionItem } from "./ui/components/BulkActionBar";
 export { ADMIN_ENDPOINTS } from "./constants/index";
+export { SELLER_ENDPOINTS } from "./constants/index";
+export { TourProvider, useTour } from "./_internal/client/features/tour/TourProvider";
+export type { TourContextValue, TourRole } from "./_internal/client/features/tour/TourProvider";
 export { apiClient, ApiClientError } from "./http/index";
 export { UserSidebar } from "./features/account/components/UserSidebar";
 export type { UserSidebarProps, UserNavItem, UserNavGroup } from "./features/account/components/UserSidebar";
@@ -296,6 +302,8 @@ export { MEGABYTE, MAX_IMAGE_BYTES, MAX_PDF_BYTES, MAX_VIDEO_BYTES, MAX_LABEL, M
 export type { MediaKind, AllowedImageMime, AllowedVideoMime, AllowedDocMime, AllowedMime, } from "./_internal/shared/media/limits";
 export { ScamAwarenessModal } from "./features/scams/components/ScamAwarenessModal";
 export type { ScamAwarenessModalProps } from "./features/scams/components/ScamAwarenessModal";
+export { SellerTrustBadge } from "./features/scams/components/SellerTrustBadge";
+export type { SellerTrustBadgeProps } from "./features/scams/components/SellerTrustBadge";
 export { ActionPermissionsManager } from "./features/site-settings/components/ActionPermissionsManager";
 export type { ActionPermissionsManagerProps } from "./features/site-settings/components/ActionPermissionsManager";
 export { NavPermissionsManager } from "./features/site-settings/components/NavPermissionsManager";

package/dist/client.js

@@ -120,6 +120,10 @@ export { FirebaseClientRealtimeProvider } from "./providers/firebase-client/inde
 // [CLIENT-ONLY]-Cannot run in SSR mode â€" uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
 // EventFormDrawer - Component for event form drawer.
 export { EventFormDrawer, EventParticipateView, EventPollWidget } from "./features/events/index";
+// useBulkEvent - subscribes to an enqueued async job's RTDB progress channel (Async Job Primitive).
+export { useBulkEvent } from "./features/events/index";
+// RTDB_PATHS - realtime database path constants (e.g. RTDB_PATHS.BULK_EVENTS for useBulkEvent).
+export { RTDB_PATHS } from "./providers/db-firebase/index";
 // Lottery feature — client components (safe for client bundles — no server imports)
 export { LotterySlotGrid } from "./_internal/client/features/lottery/LotterySlotGrid";
 export { LotteryPullForm } from "./_internal/client/features/lottery/LotteryPullForm";
@@ -198,6 +202,9 @@ export { ZodSetup } from "./validation/ZodSetup";
 export { AdminSidebar } from "./features/admin/components/AdminSidebar";
 export { AdminDashboardView, AdminAnalyticsView, AdminPrizeDrawsView, AdminCarouselView, AdminSublistingCategoriesView, AdminFulfillmentView, DataTable, DataListingView, useAdminListingData, toRecordArray, toStringValue, toRelativeDate, toRupees } from "./features/admin/index";
 export { ADMIN_ENDPOINTS } from "./constants/index";
+export { SELLER_ENDPOINTS } from "./constants/index";
+// P-16 — Tour system (driver.js-backed onboarding walkthrough).
+export { TourProvider, useTour } from "./_internal/client/features/tour/TourProvider";
 export { apiClient, ApiClientError } from "./http/index";
 export { UserSidebar } from "./features/account/components/UserSidebar";
 export { CouponsIndexListing } from "./features/promotions/components/CouponsIndexListing";
@@ -301,6 +308,7 @@ export { LISTING_TYPE_REGISTRY, pluginFor, detectListingTypeFromSlug } from "./_
 // Media upload limits — shared by client uploaders + server sign/finalize routes.
 export { MEGABYTE, MAX_IMAGE_BYTES, MAX_PDF_BYTES, MAX_VIDEO_BYTES, MAX_LABEL, MAX_BYTES, ALLOWED_IMAGE_MIMES, ALLOWED_VIDEO_MIMES, ALLOWED_DOC_MIMES, ALLOWED_MIMES, ALLOWED_TYPES_LABEL, MIME_TO_EXT, PDF_MAGIC, VIDEO_CONVERSION_HINTS, classifyMime, isAllowedMime, maxBytesFor, getConversionHint, } from "./_internal/shared/media/limits";
 export { ScamAwarenessModal } from "./features/scams/components/ScamAwarenessModal";
+export { SellerTrustBadge } from "./features/scams/components/SellerTrustBadge";
 // [CLIENT-ONLY] — Admin panel components for action/nav permission management.
 export { ActionPermissionsManager } from "./features/site-settings/components/ActionPermissionsManager";
 export { NavPermissionsManager } from "./features/site-settings/components/NavPermissionsManager";

package/dist/constants/api-endpoints.d.ts

@@ -376,6 +376,9 @@ export declare const SELLER_ENDPOINTS: {
     readonly GOOGLE_REVIEWS_SYNC: "/api/store/google-reviews/sync";
     readonly PRODUCTS_SCAN: (barcode: string) => string;
     readonly ORDERS_FULFILLMENT: "/api/store/fulfillment";
+    readonly BUNDLES: "/api/store/bundles";
+    readonly BUNDLE_BY_ID: (id: string) => string;
+    readonly CONVERSATIONS: "/api/store/conversations";
     readonly ORDERS_ASSIGN: (orderId: string) => string;
     readonly PRODUCT_BY_ID: (id: string) => string;
     readonly PRODUCT_DUPLICATE: (id: string) => string;
@@ -807,6 +810,9 @@ export declare const API_ENDPOINTS: {
         readonly GOOGLE_REVIEWS_SYNC: "/api/store/google-reviews/sync";
         readonly PRODUCTS_SCAN: (barcode: string) => string;
         readonly ORDERS_FULFILLMENT: "/api/store/fulfillment";
+        readonly BUNDLES: "/api/store/bundles";
+        readonly BUNDLE_BY_ID: (id: string) => string;
+        readonly CONVERSATIONS: "/api/store/conversations";
         readonly ORDERS_ASSIGN: (orderId: string) => string;
         readonly PRODUCT_BY_ID: (id: string) => string;
         readonly PRODUCT_DUPLICATE: (id: string) => string;
@@ -1240,6 +1246,9 @@ export declare const API_ROUTES: {
         readonly GOOGLE_REVIEWS_SYNC: "/api/store/google-reviews/sync";
         readonly PRODUCTS_SCAN: (barcode: string) => string;
         readonly ORDERS_FULFILLMENT: "/api/store/fulfillment";
+        readonly BUNDLES: "/api/store/bundles";
+        readonly BUNDLE_BY_ID: (id: string) => string;
+        readonly CONVERSATIONS: "/api/store/conversations";
         readonly ORDERS_ASSIGN: (orderId: string) => string;
         readonly PRODUCT_BY_ID: (id: string) => string;
         readonly PRODUCT_DUPLICATE: (id: string) => string;

package/dist/constants/api-endpoints.js

@@ -491,6 +491,9 @@ export const SELLER_ENDPOINTS = {
     GOOGLE_REVIEWS_SYNC: "/api/store/google-reviews/sync",
     PRODUCTS_SCAN: (barcode) => `/api/store/products/scan?barcode=${encodeURIComponent(barcode)}`,
     ORDERS_FULFILLMENT: "/api/store/fulfillment",
+    BUNDLES: "/api/store/bundles",
+    BUNDLE_BY_ID: (id) => `/api/store/bundles/${id}`,
+    CONVERSATIONS: "/api/store/conversations",
     ORDERS_ASSIGN: (orderId) => `/api/store/orders/${orderId}/assign`,
     PRODUCT_BY_ID: (id) => `/api/store/products/${id}`,
     PRODUCT_DUPLICATE: (id) => `/api/store/products/${id}/duplicate`,

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

@@ -18,5 +18,12 @@ export interface AdminBundleEditorViewProps {
     onSaved?: (id: string) => void;
     /** Called after a successful delete. */
     onDeleted?: () => void;
+    /**
+     * "admin" (default) hits /api/admin/bundles and lets the product picker
+     * search all products. "store" hits /api/store/bundles (server-scoped to
+     * the caller's own store) and restricts the picker to the seller's own
+     * products.
+     */
+    scope?: "admin" | "store";
 }
-export declare function AdminBundleEditorView({ bundleId, onSaved, onDeleted, }: AdminBundleEditorViewProps): React.JSX.Element;
+export declare function AdminBundleEditorView({ bundleId, onSaved, onDeleted, scope, }: AdminBundleEditorViewProps): React.JSX.Element;