@mohasinac/appkit 4.9.4 → 4.10.0

package/dist/_internal/client/features/layout/DashboardLayoutClient.js

@@ -33,6 +33,7 @@ import { DASHBOARD_DESKTOP_MEDIA_QUERY } from "../../../shared/features/layout/c
 import { filterNavItems } from "./filterNavItems";
 import { useSiteSettings } from "../../../../core/hooks/useSiteSettings";
 import { useTheme } from "../../theme";
+import { useHandMode } from "../../hand-mode";
 import { BackgroundRenderer, Div, Nav, Span } from "../../../../ui";
 import { useToast } from "../../../../ui/components/Toast";
 import { useVisualViewportInset } from "../../../../react/hooks/useVisualViewportInset";
@@ -149,7 +150,10 @@ function DashboardBottomNav({ items, activeHref }) {
             return (_jsxs(Link, { href: item.href, className: `flex flex-1 flex-col items-center justify-center gap-[var(--appkit-space-0-5)] py-[var(--appkit-space-2)] ${isActive ? "text-[var(--appkit-color-primary)]" : "text-[var(--appkit-color-text-muted)]"}`, "aria-current": isActive ? "page" : undefined, children: [item.icon && _jsx(Span, { size: "base", children: item.icon }), _jsx(Span, { size: "xs", className: "max-w-full truncate", children: item.label })] }, item.href));
         }) }));
 }
-const DEFAULT_CONTENT_PADDING = "px-[var(--appkit-space-5)] py-[var(--appkit-space-8)] lg:pl-14 lg:pr-6 xl:pl-16 xl:pr-10";
+// Asymmetric padding clears the persistent sidebar rail — right-heavy by
+// default (rail docks left), left-heavy in left-hand mode (rail docks right).
+const DEFAULT_CONTENT_PADDING_RIGHT = "px-[var(--appkit-space-5)] py-[var(--appkit-space-8)] lg:pl-14 lg:pr-6 xl:pl-16 xl:pr-10";
+const DEFAULT_CONTENT_PADDING_LEFT = "px-[var(--appkit-space-5)] py-[var(--appkit-space-8)] lg:pr-14 lg:pl-6 xl:pr-16 xl:pl-10";
 const DEFAULT_CONTENT_MAX_WIDTH = "max-w-screen-2xl";
 export function DashboardLayoutClient({ variant, groups, permissions, activeHref: explicitActiveHref, responsive: _responsive, crossNav, className, contentPadding, contentSurface, contentMaxWidth, lightBackground, darkBackground, children, }) {
     const pathname = usePathname();
@@ -178,6 +182,7 @@ export function DashboardLayoutClient({ variant, groups, permissions, activeHref
     const { data: settings } = useSiteSettings();
     const navConfig = settings?.navConfig;
     const { theme } = useTheme();
+    const { hand } = useHandMode();
     // Explicit props win; otherwise fall back to the same siteSettings.background
     // the public shell reads, so admin/store/user dashboards match it by default.
     const resolvedLightBackground = lightBackground ?? settings?.background?.light;
@@ -193,7 +198,7 @@ export function DashboardLayoutClient({ variant, groups, permissions, activeHref
     return (_jsxs(_Fragment, { children: [hasBackground && (_jsx(BackgroundRenderer, { mode: theme === "dark" ? "dark" : "light", lightMode: resolvedLightBackground ?? { type: "color", value: "" }, darkMode: resolvedDarkBackground ?? { type: "color", value: "" } })), variant === "admin" && (_jsx(AdminSidebar, { variant: "sidebar", desktopOpen: desktopOpen, mobileOpen: mobileOpen, activePath: activeHref, groups: adminGroups, onCloseMobile: close, onToggle: toggle, className: className, renderFooter: renderCrossNavFooter })), variant === "store" && (_jsx(StoreSidebar, { variant: "sidebar", desktopOpen: desktopOpen, mobileOpen: mobileOpen, activeHref: activeHref, items: [], groups: filteredGroups, onCloseMobile: close, onToggle: toggle, className: className, renderFooter: renderCrossNavFooter })), variant === "user" && (_jsx(UserSidebar, { variant: "sidebar", desktopOpen: desktopOpen, mobileOpen: mobileOpen, items: filteredGroups.flatMap((g) => g.items), groups: filteredGroups, onCloseMobile: close, onToggle: toggle, className: className, renderFooter: renderCrossNavFooter })), _jsx(Div, { className: [
                     "w-full flex-1 flex flex-col min-h-[calc(100dvh-var(--header-height,3.5rem))]",
                     "pb-[var(--appkit-space-16)] lg:pb-[0]", // clears the fixed mobile bottom-nav
-                    contentPadding ?? DEFAULT_CONTENT_PADDING,
+                    contentPadding ?? (hand === "left" ? DEFAULT_CONTENT_PADDING_LEFT : DEFAULT_CONTENT_PADDING_RIGHT),
                     contentSurface,
                 ].filter(Boolean).join(" "), children: _jsx(Div, { className: ["w-full flex-1 mx-auto", contentMaxWidth ?? DEFAULT_CONTENT_MAX_WIDTH].filter(Boolean).join(" "), children: children }) }), _jsx(DashboardBottomNav, { items: filteredGroups.flatMap((g) => g.items), activeHref: activeHref })] }));
 }

package/dist/_internal/client/features/layout/SidebarCollapseToggle.d.ts

@@ -15,5 +15,9 @@ export interface SidebarCollapseToggleProps {
     /** aria-label override; defaults to "Collapse sidebar" / "Expand sidebar". */
     expandedLabel?: string;
     collapsedLabel?: string;
+    /** Which edge the parent sidebar panel is docked to. Defaults to "right"
+     * (the handle protrudes to the panel's outer/right edge). "left" mirrors
+     * the rounded corner and chevron direction for left-hand mode. */
+    edge?: "left" | "right";
 }
-export declare function SidebarCollapseToggle({ expanded, onToggle, expandedLabel, collapsedLabel, }: SidebarCollapseToggleProps): React.JSX.Element;
+export declare function SidebarCollapseToggle({ expanded, onToggle, expandedLabel, collapsedLabel, edge, }: SidebarCollapseToggleProps): React.JSX.Element;

package/dist/_internal/client/features/layout/SidebarCollapseToggle.js

@@ -7,6 +7,12 @@ const HANDLE_STYLE = {
 const CHEVRON_STYLE = {
     color: "var(--appkit-color-text-on-primary)",
 };
-export function SidebarCollapseToggle({ expanded, onToggle, expandedLabel = "Collapse sidebar", collapsedLabel = "Expand sidebar", }) {
-    return (_jsx(IconButton, { type: "button", onClick: onToggle, "aria-label": expanded ? expandedLabel : collapsedLabel, "aria-expanded": expanded, variant: "ghost", style: HANDLE_STYLE, className: "w-9 shrink-0 rounded-r-[1.25rem] shadow-lg transition-all duration-200 hover:shadow-xl hover:brightness-110 active:scale-[0.96]", icon: _jsx("svg", { className: `w-4 h-4 drop-shadow-sm transition-transform duration-300 ${expanded ? "" : "rotate-180"}`, style: CHEVRON_STYLE, fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2.5, d: "M15 19l-7-7 7-7" }) }) }));
+export function SidebarCollapseToggle({ expanded, onToggle, expandedLabel = "Collapse sidebar", collapsedLabel = "Expand sidebar", edge = "right", }) {
+    // The panel's free (open) edge is opposite its dock side: a left-docked
+    // panel (edge="left") protrudes its handle to the right, and vice versa.
+    const roundedClass = edge === "left" ? "rounded-r-[1.25rem]" : "rounded-l-[1.25rem]";
+    // Chevron rotation direction mirrors along with the dock side so it keeps
+    // pointing "into" the collapsed panel regardless of which edge it's on.
+    const chevronRotated = edge === "left" ? !expanded : expanded;
+    return (_jsx(IconButton, { type: "button", onClick: onToggle, "aria-label": expanded ? expandedLabel : collapsedLabel, "aria-expanded": expanded, variant: "ghost", style: HANDLE_STYLE, className: `w-9 shrink-0 ${roundedClass} shadow-lg transition-all duration-200 hover:shadow-xl hover:brightness-110 active:scale-[0.96]`, icon: _jsx("svg", { className: `w-4 h-4 drop-shadow-sm transition-transform duration-300 ${chevronRotated ? "rotate-180" : ""}`, style: CHEVRON_STYLE, fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2.5, d: "M15 19l-7-7 7-7" }) }) }));
 }

package/dist/_internal/client/features/layout/sidebarPositionClasses.d.ts

@@ -0,0 +1,20 @@
+import type { HandMode } from "../../hand-mode";
+/** Classes for the desktop persistent sidebar rail (Admin/Seller/User
+ * `variant="sidebar"`) — flips which edge it docks to, its border side, and
+ * its collapsed-state translate direction, based on the hand-mode
+ * preference. Kept as a single shared helper so the flip logic isn't
+ * hand-forked identically across all three sidebar files. */
+export interface SidebarRailClasses {
+    edgeClass: string;
+    borderClass: string;
+    collapsedTranslateClass: string;
+}
+export declare function getSidebarRailClasses(hand: HandMode): SidebarRailClasses;
+/** Classes for the mobile overlay drawer variant (Admin/Seller/User
+ * `variant="overlay"` → `DrawerPanel`) — same edge/border flip, no
+ * translate state since the panel is conditionally mounted, not animated. */
+export interface SidebarOverlayClasses {
+    edgeClass: string;
+    borderClass: string;
+}
+export declare function getSidebarOverlayClasses(hand: HandMode): SidebarOverlayClasses;

package/dist/_internal/client/features/layout/sidebarPositionClasses.js

@@ -0,0 +1,20 @@
+export function getSidebarRailClasses(hand) {
+    if (hand === "left") {
+        return {
+            edgeClass: "left-0",
+            borderClass: "border-r",
+            collapsedTranslateClass: "-translate-x-[calc(100%-1.25rem)]",
+        };
+    }
+    return {
+        edgeClass: "right-0",
+        borderClass: "border-l",
+        collapsedTranslateClass: "translate-x-[calc(100%-1.25rem)]",
+    };
+}
+export function getSidebarOverlayClasses(hand) {
+    if (hand === "left") {
+        return { edgeClass: "left-0", borderClass: "border-r" };
+    }
+    return { edgeClass: "right-0", borderClass: "border-l" };
+}

package/dist/_internal/client/hand-mode/HandModeProvider.d.ts

@@ -0,0 +1,21 @@
+import { type ReactNode } from "react";
+export type HandMode = "left" | "right";
+export interface HandModeContextValue {
+    /** Which side CTA panels/drawers/sidebars dock to and where close buttons sit. */
+    hand: HandMode;
+    /** Persist a new hand-mode preference and re-render the flipped layout. */
+    setHand: (next: HandMode) => void;
+    /** Flip preference between right ↔ left. */
+    toggleHand: () => void;
+}
+export interface HandModeProviderProps {
+    /**
+     * Seed value from the signed-in user's server-persisted preference
+     * (`user.uiPreferences.handMode`), used only when no value is already
+     * cached in localStorage on this device.
+     */
+    initialHand?: HandMode;
+    children: ReactNode;
+}
+export declare function HandModeProvider({ initialHand, children }: HandModeProviderProps): import("react").JSX.Element;
+export declare function useHandMode(): HandModeContextValue;

package/dist/_internal/client/hand-mode/HandModeProvider.js

@@ -0,0 +1,81 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { normalizeError } from "../../../errors/normalize";
+import { createContext, useCallback, useContext, useEffect, useMemo, useState, } from "react";
+// Brand-neutral localStorage namespace, matching the `appkit:theme-mode` /
+// `appkit:theme-id` convention. audit-ssr-in-appkit blocks hardcoded brand
+// strings inside `_internal/`.
+const HAND_STORAGE_KEY = "appkit:hand-mode";
+// Default (non-null) context value — unlike `ThemeContext` (which throws
+// outside its provider because it's only ever consumed at the app-shell
+// level), `useHandMode()` is called from base UI primitives (SideDrawer,
+// Modal, Drawer, BackToTop, ...) that ship as part of the public design
+// system and must degrade gracefully to the "right" default for any
+// consumer that hasn't mounted `<HandModeProvider>`.
+const DEFAULT_CONTEXT_VALUE = {
+    hand: "right",
+    setHand: () => { },
+    toggleHand: () => { },
+};
+const HandModeContext = createContext(DEFAULT_CONTEXT_VALUE);
+function readHandPreference() {
+    if (typeof window === "undefined")
+        return "right";
+    try {
+        const stored = window.localStorage.getItem(HAND_STORAGE_KEY);
+        if (stored === "left" || stored === "right")
+            return stored;
+    }
+    catch (_err) {
+        void normalizeError(_err); /* localStorage unavailable in privacy/iframe context */
+    }
+    return "right";
+}
+/** Apply the hand-mode preference to `<html>` via a `data-hand` attribute.
+ * Deliberately NOT `dir="rtl"/"ltr"` — that would trigger the browser's
+ * bidi text-direction and native-control-mirroring behavior repo-wide, which
+ * is not what this "reachability" preference means. `data-hand` is a plain
+ * presentational attribute, same category as `data-theme`. */
+function applyHand(hand) {
+    if (typeof document === "undefined")
+        return;
+    document.documentElement.setAttribute("data-hand", hand);
+}
+export function HandModeProvider({ initialHand, children }) {
+    const [hand, setHandState] = useState(() => {
+        if (typeof window === "undefined")
+            return initialHand ?? "right";
+        const stored = readHandPreference();
+        // readHandPreference() falls back to "right" when nothing is cached —
+        // in that case, prefer the server-seeded value over the hardcoded default.
+        try {
+            if (window.localStorage.getItem(HAND_STORAGE_KEY) === null) {
+                return initialHand ?? stored;
+            }
+        }
+        catch (_err) {
+            void normalizeError(_err);
+        }
+        return stored;
+    });
+    useEffect(() => {
+        applyHand(hand);
+    }, [hand]);
+    const setHand = useCallback((next) => {
+        setHandState(next);
+        try {
+            window.localStorage.setItem(HAND_STORAGE_KEY, next);
+        }
+        catch (_err) {
+            void normalizeError(_err); /* localStorage unavailable; preference applies for this session */
+        }
+    }, []);
+    const toggleHand = useCallback(() => {
+        setHand(hand === "left" ? "right" : "left");
+    }, [hand, setHand]);
+    const value = useMemo(() => ({ hand, setHand, toggleHand }), [hand, setHand, toggleHand]);
+    return _jsx(HandModeContext.Provider, { value: value, children: children });
+}
+export function useHandMode() {
+    return useContext(HandModeContext);
+}

package/dist/_internal/client/hand-mode/index.d.ts

@@ -0,0 +1,2 @@
+export { HandModeProvider, useHandMode } from "./HandModeProvider";
+export type { HandMode, HandModeContextValue, HandModeProviderProps, } from "./HandModeProvider";

package/dist/_internal/client/hand-mode/index.js

@@ -0,0 +1 @@
+export { HandModeProvider, useHandMode } from "./HandModeProvider";

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

@@ -1,6 +1,6 @@
 "use server";
 import { wrapAction } from "@mohasinac/appkit/server";
-import { bidRepository, productRepository, userRepository } from "../../../../repositories";
+import { bidRepository, productRepository, userRepository, siteSettingsRepository } from "../../../../repositories";
 import { requireRoleUser } from "../../../../providers/auth-firebase/helpers";
 import { placeBidSchema } from "../../../shared/features/auctions/schema";
 import { assertAuctionActive, assertBidAmount, assertNotAuctionOwner, shouldAutoExtend, computeExtendedEndDate, } from "./service";
@@ -14,7 +14,8 @@ export async function placeBidAction(input) {
         const { auctionId, amount } = parsed.data;
         const product = await assertAuctionActive(auctionId);
         assertNotAuctionOwner(product, user.uid);
-        assertBidAmount(product, amount);
+        const settings = await siteSettingsRepository.getSingleton();
+        assertBidAmount(product, amount, settings.auctionConfig?.bidIncrementTiers ?? []);
         const profile = await userRepository.findById(user.uid).catch(() => null);
         const userName = profile?.displayName ?? user.name ?? "Anonymous";
         // Mark all current bids for this auction as outbid, then set new winning bid

package/dist/_internal/server/features/auctions/service.d.ts

@@ -1,10 +1,11 @@
+import { type BidIncrementTier } from "../../../shared/features/auctions/config";
 import type { ProductDocument } from "../../../shared/features/products/types";
 /** Assert an auction exists, is published, and is still active. Returns the product. */
 export declare function assertAuctionActive(auctionId: string): Promise<ProductDocument>;
-/** Compute the minimum valid bid given the current state. */
-export declare function computeMinBid(product: ProductDocument): number;
+/** Compute the minimum valid bid given the current state and the admin's tier table. */
+export declare function computeMinBid(product: ProductDocument, tiers: BidIncrementTier[]): number;
 /** Assert a bid amount is valid against the current auction state. */
-export declare function assertBidAmount(product: ProductDocument, amount: number): void;
+export declare function assertBidAmount(product: ProductDocument, amount: number, tiers: BidIncrementTier[]): void;
 /** Assert the bidder is not the auction owner. */
 export declare function assertNotAuctionOwner(product: ProductDocument, bidderId: string): void;
 /** Return true if the bid was placed within the sniping window and the auction should auto-extend. */

package/dist/_internal/server/features/auctions/service.js

@@ -1,7 +1,7 @@
 import { productRepository } from "../../../../repositories";
 import { isAuctionListing } from "../../../../features/products/utils/listing-type";
 import { AuctionNotFoundError, AuctionEndedError, BidTooLowError, BidOnOwnAuctionError, } from "../../../shared/features/auctions/errors";
-import { AUCTION_MIN_BID_INCREMENT, AUCTION_SNIPING_WINDOW_SECONDS, AUCTION_DEFAULT_EXTENSION_MINUTES, } from "../../../shared/features/auctions/config";
+import { AUCTION_SNIPING_WINDOW_SECONDS, AUCTION_DEFAULT_EXTENSION_MINUTES, resolveMinBidIncrement, } from "../../../shared/features/auctions/config";
 /** Assert an auction exists, is published, and is still active. Returns the product. */
 export async function assertAuctionActive(auctionId) {
     const product = await productRepository.findByIdOrSlug(auctionId).catch(() => null);
@@ -16,15 +16,15 @@ export async function assertAuctionActive(auctionId) {
         throw new AuctionEndedError(auctionId);
     return product;
 }
-/** Compute the minimum valid bid given the current state. */
-export function computeMinBid(product) {
+/** Compute the minimum valid bid given the current state and the admin's tier table. */
+export function computeMinBid(product, tiers) {
     const current = product.currentBid ?? product.startingBid ?? 0;
-    const increment = product.minBidIncrement ?? AUCTION_MIN_BID_INCREMENT;
+    const increment = resolveMinBidIncrement(current, tiers, product.minBidIncrement);
     return current + increment;
 }
 /** Assert a bid amount is valid against the current auction state. */
-export function assertBidAmount(product, amount) {
-    const minBid = computeMinBid(product);
+export function assertBidAmount(product, amount, tiers) {
+    const minBid = computeMinBid(product, tiers);
     if (amount < minBid)
         throw new BidTooLowError(minBid);
 }

package/dist/_internal/server/features/bundles/data.d.ts

@@ -45,3 +45,12 @@ export declare function resolveBundleOriginalTotal(productIds: string[]): Promis
  * `limit` (default 8) and filtered to `isActive: true` server-side.
  */
 export declare const listFeaturedBundles: (limit?: number, _opts?: BundleDataOptions) => Promise<CategoryDocument[]>;
+/**
+ * "Related Bundles" for the bundle detail page — every other active bundle,
+ * excluding the current one. Bundles are a CategoryDocument, not a
+ * ProductDocument, so this mirrors BrandDetailPageView's "Related Brands"
+ * pattern (all active siblings of the same categoryType) rather than the
+ * product-based 4-signal computeRelatedItems() used elsewhere — bundle
+ * detail pages had no related section at all before this.
+ */
+export declare const getRelatedBundles: (bundle: Pick<CategoryDocument, "id">, limit?: number) => Promise<CategoryDocument[]>;

package/dist/_internal/server/features/bundles/data.js

@@ -79,3 +79,17 @@ export const listFeaturedBundles = cache(async (limit = 8, _opts) => {
         .catch(() => []);
     return all;
 });
+/**
+ * "Related Bundles" for the bundle detail page — every other active bundle,
+ * excluding the current one. Bundles are a CategoryDocument, not a
+ * ProductDocument, so this mirrors BrandDetailPageView's "Related Brands"
+ * pattern (all active siblings of the same categoryType) rather than the
+ * product-based 4-signal computeRelatedItems() used elsewhere — bundle
+ * detail pages had no related section at all before this.
+ */
+export const getRelatedBundles = cache(async (bundle, limit = 8) => {
+    const all = await categoriesRepository
+        .listByType("bundle", { activeOnly: true, limit: limit + 1 })
+        .catch(() => []);
+    return all.filter((b) => b.id !== bundle.id).slice(0, limit);
+});

package/dist/_internal/server/features/bundles/index.d.ts

@@ -1,4 +1,4 @@
-export { getBundleForDetail, listBundleMembers, listFeaturedBundles, resolveBundleMemberIds, resolveBundleOriginalTotal, type BundleDataOptions, } from "./data";
+export { getBundleForDetail, listBundleMembers, listFeaturedBundles, getRelatedBundles, resolveBundleMemberIds, resolveBundleOriginalTotal, type BundleDataOptions, } from "./data";
 export { buildBundleMetadata, type BundleMetadataOptions } from "./metadata";
 export { renderBundleOg, renderBundleOgImage, type BundleOgData, } from "./og";
 export { addBundleToCartAction } from "./actions";

package/dist/_internal/server/features/bundles/index.js

@@ -1,4 +1,4 @@
-export { getBundleForDetail, listBundleMembers, listFeaturedBundles, resolveBundleMemberIds, resolveBundleOriginalTotal, } from "./data";
+export { getBundleForDetail, listBundleMembers, listFeaturedBundles, getRelatedBundles, resolveBundleMemberIds, resolveBundleOriginalTotal, } from "./data";
 export { buildBundleMetadata } from "./metadata";
 // S-SBUNI-4 2026-05-13 — bundle OG renderer.
 export { renderBundleOg, renderBundleOgImage, } from "./og";

package/dist/_internal/server/features/catalogue/og.d.ts

@@ -0,0 +1,20 @@
+import type { ReactElement } from "react";
+export interface CatalogueItemOgData {
+    title: string;
+    ownerName?: string | null;
+    priceLabel?: string | null;
+    imageUrl?: string | null;
+}
+interface CatalogueItemDocLike {
+    title?: string | null;
+    price?: number | null;
+    mainImage?: string | null;
+    images?: (string | null | undefined)[] | null;
+}
+export declare function renderCatalogueItemOg(doc: CatalogueItemDocLike | null | undefined, opts: {
+    siteName: string;
+    baseUrl?: string;
+    ownerName?: string | null;
+}): ReactElement;
+export declare function renderCatalogueItemOgImage(data: CatalogueItemOgData, siteName: string): ReactElement;
+export {};

package/dist/_internal/server/features/catalogue/og.js

@@ -0,0 +1,27 @@
+import { renderOgLayout } from "../seo/og-layout";
+import { resolveOgImageUrl } from "../seo/og";
+export function renderCatalogueItemOg(doc, opts) {
+    const priceLabel = doc?.price != null && doc.price > 0
+        ? new Intl.NumberFormat("en-IN", {
+            style: "currency",
+            currency: "INR",
+            maximumFractionDigits: 0,
+        }).format(doc.price)
+        : null;
+    return renderCatalogueItemOgImage({
+        title: doc?.title ?? "Catalogue Item",
+        ownerName: opts.ownerName,
+        priceLabel,
+        imageUrl: resolveOgImageUrl(doc?.mainImage || doc?.images?.[0] || null, opts.baseUrl),
+    }, opts.siteName);
+}
+export function renderCatalogueItemOgImage(data, siteName) {
+    return renderOgLayout({
+        title: data.title,
+        subtitle: data.ownerName ? `Owned by ${data.ownerName}` : undefined,
+        imageUrl: data.imageUrl,
+        siteName: `${siteName} · Catalogue`,
+        accentSlot: data.priceLabel,
+        theme: { accentColor: "#a78bfa" },
+    });
+}

package/dist/_internal/server/features/checkout/actions.d.ts

@@ -32,6 +32,18 @@ export interface CreateCheckoutOrderInput {
     /** Buyer opted into shipment protection at checkout. Defaults false (unchecked). Only actually charged/honored when siteSettings.commissions.shipmentProtectionFeeEnabled is also true. */
     shipmentProtectionAddon?: boolean;
 }
+/**
+ * Exported so `/api/payment/create-order` (pre-charge amount) and the
+ * read-only `previewCheckoutPricing` (Order Summary display) can compute the
+ * exact same per-seller shipping fee that order creation charges/records —
+ * a single source of truth instead of a third re-implementation.
+ */
+export declare function resolveShippingCost(storeId: string | undefined): Promise<{
+    shippingFee: number;
+    storeOwnerId: string | undefined;
+    storeEmiEnabled: boolean;
+    storeState: string | undefined;
+}>;
 /**
  * Place order(s) from the user's cart in a single Firestore transaction.
  *
@@ -39,6 +51,37 @@ export interface CreateCheckoutOrderInput {
  * auth + rate-limiting before calling this and supply the resolved user fields.
  */
 export declare function createCheckoutOrderAction(input: CreateCheckoutOrderInput): Promise<CheckoutOrderResult>;
+export interface CheckoutPricingPreviewInput {
+    userId: string;
+    /** Omitted for digital-only carts — GST can't be computed without a buyer state. */
+    addressId?: string;
+    paymentMethod: CheckoutPaymentMethod;
+    excludedProductIds?: string[];
+    whatsappNotifyAddon?: boolean;
+    giftWrapAddon?: boolean;
+    shipmentProtectionAddon?: boolean;
+}
+export interface CheckoutPricingPreview {
+    subtotal: number;
+    shippingFee: number;
+    codHandlingFee: number;
+    whatsappNotifyFee: number;
+    giftWrapFee: number;
+    shipmentProtectionFee: number;
+    gstAmount: number;
+    couponDiscount: number;
+    total: number;
+}
+/**
+ * Read-only "what will I actually be charged" preview for the checkout
+ * Order Summary. Reuses the exact same building blocks
+ * createCheckoutOrderAction / verifyAndPlaceRazorpayOrderAction use when an
+ * order is actually placed — resolveShippingCost, the compute*Fee helpers,
+ * computeGroupCouponDiscount, and the GST calc — so the number shown to the
+ * buyer can never diverge from what gets charged/recorded. Never decrements
+ * stock, creates an order, or writes coupon usage.
+ */
+export declare function previewCheckoutPricing(input: CheckoutPricingPreviewInput): Promise<CheckoutPricingPreview>;
 /**
  * Mark an order as paid after a payment provider verifies the transaction.
  * Consumers call this from /api/payment/verify or a payment webhook.