@mohasinac/appkit 4.44.0 → 4.46.0

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

@@ -1,6 +1,6 @@
-import { normalizeError } from "../../../../errors/normalize";
-import { buildOrderSourceContext } from "./source-context";
-import { roundRupees } from "../../../../utils/number.formatter";
+import { normalizeError } from "../../../../errors/normalize.js";
+import { buildOrderSourceContext } from "./source-context.js";
+import { roundRupees } from "../../../../utils/number.formatter.js";
 /**
  * Checkout server actions (appkit).
  *
@@ -9,40 +9,42 @@ import { roundRupees } from "../../../../utils/number.formatter";
  * directly. The consumer is responsible for auth/rate-limit/Next-specific
  * concerns; the action only does transactional order placement.
  */
-import { ApiError, ValidationError, NotFoundError, ERROR_MESSAGES } from "../../../../errors";
-import { ORDER_FIELDS } from "../../../../constants/field-names";
-import { serverLogger } from "../../../../monitoring";
-import { unitOfWork, adminNotificationsRepository, siteSettingsRepository, userRepository, storeRepository, couponsRepository, claimedCouponsRepository, addressesRepository, productRepository, } from "../../../../repositories";
-import { isIntraStateSupply } from "../../../shared/fees/calculator";
-import { computePreOrderDepositAmount, lineTotalFor, sumGroupGst, unitPriceFor, } 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";
-import { resolveCouponCategorySlugs } from "../../../../features/promotions/actions/coupon-actions";
-import { assertCheckoutLane, assertLockedLinesStillValid, finalizeLockedLines, } from "./locked-lines";
-import { activeLane, defaultCheckoutItems, laneOf, } from "../../../shared/checkout/lanes";
-import { computeCodHandlingFee, computeWhatsAppNotifyFee, computeGiftWrapFee, computeShipmentProtectionFee, computeCheckoutFees, allocateCheckoutFees, } from "../../../shared/fees/calculator";
-import { getAdminDb, getAdminRealtimeDb, RTDB_PATHS, } from "../../../../providers/db-firebase";
-import { PRODUCT_COLLECTION, PRODUCT_CODES_SUBCOLLECTION } from "../../../../features/products/schemas/firestore";
-import { CART_COLLECTION } from "../../../../features/cart/schemas/index";
+import { ApiError, ValidationError, NotFoundError, ERROR_MESSAGES } from "../../../../errors/index.js";
+import { ORDER_FIELDS } from "../../../../constants/field-names.js";
+import { serverLogger } from "../../../../monitoring/index.js";
+import { unitOfWork, adminNotificationsRepository, siteSettingsRepository, userRepository, storeRepository, couponsRepository, claimedCouponsRepository, addressesRepository, productRepository, } from "../../../../repositories/index.js";
+import { isIntraStateSupply } from "../../../shared/fees/calculator.js";
+import { computePreOrderDepositAmount, lineTotalFor, sumGroupGst, unitPriceFor, } from "../../../shared/checkout/order-math.js";
+import { failedCheckoutRepository } from "../../../../features/checkout/repository/failed-checkout.repository.js";
+import { sendOrderConfirmationEmail } from "../../../../features/contact/server.js";
+import { splitCartIntoOrderGroups } from "../../../../features/orders/index.js";
+import { DEFAULT_STORE_SHIPPING_POLICY, quoteShipping, toStoreShippingPolicy, } from "../../../shared/features/shipping/mode.js";
+import { computeProtectionFees } from "../../../shared/features/shipping/protections.js";
+import { resolveCouponCategorySlugs } from "../../../../features/promotions/actions/coupon-actions.js";
+import { assertCheckoutLane, assertLockedLinesStillValid, finalizeLockedLines, } from "./locked-lines.js";
+import { activeLane, defaultCheckoutItems, laneOf, } from "../../../shared/checkout/lanes.js";
+import { computeCodHandlingFee, computeWhatsAppNotifyFee, computeGiftWrapFee, computeShipmentProtectionFee, computeSaleProtectionFee, computeCheckoutFees, allocateCheckoutFees, } from "../../../shared/fees/calculator.js";
+import { getAdminDb, getAdminRealtimeDb, RTDB_PATHS, } from "../../../../providers/db-firebase/index.js";
+import { PRODUCT_COLLECTION, PRODUCT_CODES_SUBCOLLECTION } from "../../../../features/products/schemas/firestore.js";
+import { CART_COLLECTION } from "../../../../features/cart/schemas/index.js";
 // S-SBUNI-RULES 2026-05-13 — bundle cart-line stock fan-out helpers.
-import { getCartItemMemberIds, getExpandedDecrements, bucketCartItemsByStock, isMultiMemberLine, } from "./bundle-expansion";
-import { expandCartLineToOrderRows } from "./expand-order-items";
-import { OrderStatusValues, PaymentStatusValues, PaymentMethodValues, OutOfStockPolicyValues, } from "../../../../features/orders/schemas/index";
-import { getDefaultCurrency } from "../../../../core/index";
-import { getProviders } from "../../../../contracts";
-import { paiseToRupees } from "../../../../core/money";
-import { CHECKOUT_DEFAULT_COMMISSIONS, CHECKOUT_DEFAULT_EMI_SETTINGS } from "../../../shared/features/checkout/config";
-import { checkEmiEligibility, computeEmiSchedule } from "../../../shared/features/emi/schedule";
-import { formatShippingAddress } from "./data";
-import { enforceMaxPerUserForCart } from "./prize-bundle-gates";
-import { getListingRule, runSyncPreflight, } from "../../../shared/checkout/rules";
-import { cartIsDigitalOnly } from "../../../shared/listing-types/cart-shipping";
-import { processRefundAction } from "../refunds/actions";
-import { sendNotification } from "../../../../features/admin/actions/notification-actions";
-import { resolveDisplayedUpiId } from "./upi-resolution";
-import { PAYMENT_WINDOW_MS } from "../../../../features/orders/constants/payment-window";
-import { isCheckoutValueOtpVerified } from "../../../../features/checkout/actions/checkout-value-otp-actions";
+import { getCartItemMemberIds, getExpandedDecrements, bucketCartItemsByStock, isMultiMemberLine, } from "./bundle-expansion.js";
+import { expandCartLineToOrderRows } from "./expand-order-items.js";
+import { OrderStatusValues, PaymentStatusValues, PaymentMethodValues, OutOfStockPolicyValues, } from "../../../../features/orders/schemas/index.js";
+import { getDefaultCurrency } from "../../../../core/index.js";
+import { getProviders } from "../../../../contracts/index.js";
+import { paiseToRupees } from "../../../../core/money.js";
+import { CHECKOUT_DEFAULT_COMMISSIONS, CHECKOUT_DEFAULT_EMI_SETTINGS } from "../../../shared/features/checkout/config.js";
+import { checkEmiEligibility, computeEmiSchedule } from "../../../shared/features/emi/schedule.js";
+import { formatShippingAddress } from "./data.js";
+import { enforceMaxPerUserForCart } from "./prize-bundle-gates.js";
+import { getListingRule, runSyncPreflight, } from "../../../shared/checkout/rules/index.js";
+import { cartIsDigitalOnly } from "../../../shared/listing-types/cart-shipping.js";
+import { processRefundAction } from "../refunds/actions.js";
+import { sendNotification } from "../../../../features/admin/actions/notification-actions.js";
+import { resolveDisplayedUpiId } from "./upi-resolution.js";
+import { PAYMENT_WINDOW_MS } from "../../../../features/orders/constants/payment-window.js";
+import { isCheckoutValueOtpVerified } from "../../../../features/checkout/actions/checkout-value-otp-actions.js";
 const AUDIT_LOG_FAIL_MSG = "checkout: audit log failed (non-critical)";
 /**
  * SB-UNI-N — Atomically claim the next available digital code for a confirmed
@@ -87,14 +89,14 @@ async function claimDigitalCodeForOrder(db, productId, orderId, userId, opts) {
          * Deliberately awaited but non-fatal inside: a failed recount must not undo
          * a claim the buyer has already paid for.
          */
-        const { recountPool } = await import("../digital-code/pool");
+        const { recountPool } = await import("../digital-code/pool.js");
         await recountPool(productId).catch((e) => serverLogger.error("claimDigitalCode: recount failed", {
             error: normalizeError(e).message,
             productId,
         }));
     }
     if (claimed && opts?.userEmail) {
-        const { sendDigitalCodeClaimedEmail } = await import("../../../../features/contact/server");
+        const { sendDigitalCodeClaimedEmail } = await import("../../../../features/contact/server.js");
         sendDigitalCodeClaimedEmail({
             to: opts.userEmail,
             userName: opts.userName ?? "there",
@@ -182,19 +184,87 @@ function accumulateCouponUsage(accumulator, couponCode, couponId, discountAmount
  * a single source of truth instead of a third re-implementation.
  */
 export async function resolveShippingCost(storeId) {
-    if (!storeId)
-        return { shippingFee: 0, storeOwnerId: undefined, storeEmiEnabled: false, storeState: undefined };
+    if (!storeId) {
+        return {
+            shippingFee: 0,
+            storeOwnerId: undefined,
+            storeEmiEnabled: false,
+            storeState: undefined,
+            shippingPolicy: DEFAULT_STORE_SHIPPING_POLICY,
+            shippingUnavailable: false,
+            storeProtections: { shipping: false, sale: false },
+        };
+    }
     const store = await storeRepository.findById(storeId);
     const storeOwnerId = store?.ownerId;
     const storeEmiEnabled = store?.emiEnabled === true;
     const storeState = await resolveStoreState(storeId);
+    /*
+     * ── C5b: the store's shipping MODE, not a flat number ──────────────────
+     *
+     * This read `sellerUser.shippingConfig.customShippingPrice ?? 0` — one flat
+     * rupee figure off the store OWNER's user document, with no weight,
+     * destination, pincode or courier in it. Meanwhile `ShippingConfigDocument`
+     * (zones, per-kg rates, free-above, express surcharge, full CRUD, seed data)
+     * was read by NO money path at all, so there were two shipping-config
+     * systems and the authoritative one was the flat number by accident.
+     *
+     * 🛑 The policy lives on the STORE, because shipping is charged per store
+     * and `splitCartIntoOrderGroups` groups on `storeId` — a user who owns two
+     * stores would otherwise price both the same, which is Root Cause #65's
+     * granularity mismatch.
+     *
+     * 🛑 The LEGACY flat number is still honoured as a `flat` mode when a store
+     * has no policy of its own. Not for compatibility's sake — for correctness:
+     * a seller who set ₹100 on the old surface and has not seen the new one must
+     * keep charging ₹100, not silently drop to free. Migration is a seller
+     * visiting their settings, not a reseed.
+     */
+    const policy = store?.shippingPricing
+        ? toStoreShippingPolicy(store.shippingPricing)
+        : await legacyFlatPolicy(storeOwnerId);
+    /*
+     * 🛑 `goodsValue: 0` and no carrier rate here, deliberately.
+     *
+     * This function resolves the POLICY; it does not know the cart. A caller
+     * that needs the charged amount calls `quoteShipping` with the group's goods
+     * value and, for `estimate` mode, a rate — and `shippingFee` below stays the
+     * non-carrier answer so every existing caller behaves exactly as before
+     * until it is converted. An `estimate`-mode store therefore reports
+     * `shippingUnavailable`, which is the signal to go and get a rate rather
+     * than a zero that would ship for free at our expense.
+     */
+    const quote = quoteShipping({ policy, goodsValue: 0, carrierRate: null });
+    return {
+        shippingFee: quote.kind === "charge" ? quote.amount : 0,
+        storeOwnerId: storeOwnerId ?? undefined,
+        storeEmiEnabled,
+        storeState,
+        shippingPolicy: policy,
+        shippingUnavailable: quote.kind === "unavailable",
+        storeProtections: {
+            shipping: store?.supportsShippingProtection === true,
+            sale: store?.supportsSaleProtection === true,
+        },
+    };
+}
+/**
+ * The pre-C5b flat number, read as a `flat` mode.
+ *
+ * One extra read, and only for a store that has never saved a policy — so it
+ * disappears as sellers touch their settings rather than needing a migration.
+ */
+async function legacyFlatPolicy(storeOwnerId) {
     if (!storeOwnerId)
-        return { shippingFee: 0, storeOwnerId: undefined, storeEmiEnabled, storeState };
+        return DEFAULT_STORE_SHIPPING_POLICY;
     const sellerUser = await userRepository.findById(storeOwnerId);
-    const shippingConfig = sellerUser?.shippingConfig;
-    if (!shippingConfig?.isConfigured)
-        return { shippingFee: 0, storeOwnerId, storeEmiEnabled, storeState };
-    return { shippingFee: shippingConfig.customShippingPrice ?? 0, storeOwnerId, storeEmiEnabled, storeState };
+    const legacy = sellerUser?.shippingConfig;
+    if (!legacy?.isConfigured)
+        return DEFAULT_STORE_SHIPPING_POLICY;
+    const amount = legacy.customShippingPrice ?? 0;
+    if (!(amount > 0))
+        return DEFAULT_STORE_SHIPPING_POLICY;
+    return { mode: { kind: "flat", amount } };
 }
 /** P-8 GST — the seller's registered/pickup state, used to determine intra- vs inter-state tax. */
 async function resolveStoreState(storeId) {
@@ -392,7 +462,7 @@ async function createOrderForGroup(group, orderType, ctx) {
     const firstItem = group[0].item;
     const firstProduct = group[0].product;
     // Add-ons are this store's choice, not the cart's — see OrderGroupContext.
-    const { whatsappNotifyAddon = false, giftWrapAddon = false, giftWrapMessage, shipmentProtectionAddon = false, } = storeAddons?.[firstItem.storeId] ?? {};
+    const { whatsappNotifyAddon = false, giftWrapAddon = false, giftWrapMessage, shipmentProtectionAddon = false, saleProtectionAddon = false, } = storeAddons?.[firstItem.storeId] ?? {};
     const { platformFee = 0, gstOnFee: platformFeeGst = 0 } = platformFeeByStore.get(firstItem.storeId) ?? {};
     const groupTotal = group.reduce((sum, { item, product }) => sum + lineTotalFor(item, product), 0);
     // S-SBUNI-RULES 2026-05-13 — order-item decoration via rule registry.
@@ -405,7 +475,7 @@ async function createOrderForGroup(group, orderType, ctx) {
         return expandCartLineToOrderRows(item, product, ctx.productById).map((baseLine) => itemRule.decorateOrderItem(baseLine, product));
     });
     const totalQuantity = group.reduce((sum, { item }) => sum + item.quantity, 0);
-    const { shippingFee, storeOwnerId, storeEmiEnabled, storeState } = await resolveShippingCost(firstItem.storeId);
+    const { shippingFee, storeOwnerId, storeEmiEnabled, storeState, storeProtections } = 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
@@ -467,7 +537,33 @@ async function createOrderForGroup(group, orderType, ctx) {
     const codHandlingFee = paymentMethod === "cod" ? computeCodHandlingFee(groupTotal, commissions) : 0;
     const whatsappNotifyFee = computeWhatsAppNotifyFee(whatsappNotifyAddon, commissions);
     const giftWrapFee = computeGiftWrapFee(giftWrapAddon, commissions);
-    const shipmentProtectionFee = computeShipmentProtectionFee(groupTotal, shipmentProtectionAddon, commissions);
+    /*
+     * ── C5e: all three protection tiers, enforced SERVER-SIDE ────────────────
+     *
+     * 🛑 The picker filtering the checkbox is not enough. `storeAddons` is a
+     * field on the cart document, so a hand-crafted `PUT /api/cart/addons` can
+     * tick a protection the seller declined — and billing for cover we will not
+     * honour is worse than any of the defects C5e exists to close. So the fee is
+     * gated here too, on the same three tiers the picker renders.
+     *
+     * The `finalSale` test reads the ORDER ITEMS we are about to write, i.e. the
+     * snapshot, never the live product — `OrderDocumentItem.finalSale` exists
+     * precisely so a seller cannot flip the switch after the sale.
+     */
+    const groupHasFinalSale = orderItems.some((line) => line.finalSale === true);
+    const { shippingProtectionFee: shipmentProtectionFee, saleProtectionFee } = computeProtectionFees({
+        subtotal: groupTotal,
+        selected: { shipping: shipmentProtectionAddon, sale: saleProtectionAddon },
+        tiers: {
+            platformShipping: commissions.shipmentProtectionFeeEnabled === true,
+            platformSale: commissions.saleProtectionFeeEnabled === true,
+            sellerShipping: storeProtections.shipping,
+            sellerSale: storeProtections.sale,
+            finalSale: groupHasFinalSale,
+        },
+        shippingFee: (s, sel) => computeShipmentProtectionFee(s, sel, commissions),
+        saleFee: (s, sel) => computeSaleProtectionFee(s, sel, commissions),
+    });
     const groupCouponCodes = new Set();
     const groupLines = group.map(({ item }) => ({ itemId: item.itemId, lineTotal: item.price * item.quantity }));
     const { couponDiscount, appliedDiscounts } = computeGroupCouponDiscount(appliedCoupons, groupLines, groupTotal, cartSubtotal, firstItem.storeId);
@@ -492,7 +588,7 @@ async function createOrderForGroup(group, orderType, ctx) {
      * OUR service fee to the seller, charged to the buyer on top of the fee —
      * not tax on the goods.
      */
-    Math.max(0, groupTotal - couponDiscount) + shippingFee + codHandlingFee + whatsappNotifyFee + giftWrapFee + shipmentProtectionFee + platformFee + platformFeeGst + (emiSchedule?.surchargeAmount ?? 0);
+    Math.max(0, groupTotal - couponDiscount) + shippingFee + codHandlingFee + whatsappNotifyFee + giftWrapFee + shipmentProtectionFee + saleProtectionFee + platformFee + platformFeeGst + (emiSchedule?.surchargeAmount ?? 0);
     const imageUrls = [
         ...new Set(group
             .map(({ product }) => product.mainImage)
@@ -568,6 +664,8 @@ async function createOrderForGroup(group, orderType, ctx) {
         giftWrapMessage: !adminBypass && giftWrapFee > 0 ? giftWrapMessage?.slice(0, 500) : undefined,
         shipmentProtectionAddon: !adminBypass && shipmentProtectionFee > 0 ? true : undefined,
         shipmentProtectionFee: !adminBypass && shipmentProtectionFee > 0 ? shipmentProtectionFee : undefined,
+        saleProtectionAddon: !adminBypass && saleProtectionFee > 0 ? true : undefined,
+        saleProtectionFee: !adminBypass && saleProtectionFee > 0 ? saleProtectionFee : undefined,
         taxableAmount: gstBreakdown?.taxableAmount,
         /* Exempt goods are a reportable nil-rated supply, kept OUT of
          * `taxableAmount` so the taxed base stays the base the tax was charged on,
@@ -950,6 +1048,7 @@ const EMPTY_PRICING_PREVIEW = {
     whatsappNotifyFee: 0,
     giftWrapFee: 0,
     shipmentProtectionFee: 0,
+    saleProtectionFee: 0,
     gstAmount: 0,
     couponDiscount: 0,
     platformFee: 0,
@@ -1020,7 +1119,7 @@ export async function previewCheckoutPricing(input) {
     for (const { items: group } of orderGroups) {
         const firstItem = group[0].item;
         const groupTotal = group.reduce((sum, { item, product }) => sum + lineTotalFor(item, product), 0);
-        const { shippingFee: groupShippingFee, storeState } = await resolveShippingCost(firstItem.storeId);
+        const { shippingFee: groupShippingFee, storeState, storeProtections } = await resolveShippingCost(firstItem.storeId);
         // Add-ons are per store, read off the cart document — the same entry
         // createOrderForGroup will read when the order is actually placed.
         const addons = cart.storeAddons?.[firstItem.storeId] ?? {};
@@ -1030,7 +1129,34 @@ export async function previewCheckoutPricing(input) {
         const groupCodHandlingFee = paymentMethod === "cod" ? computeCodHandlingFee(groupTotal, commissions) : 0;
         const groupWhatsappFee = computeWhatsAppNotifyFee(addons.whatsappNotifyAddon ?? false, commissions);
         const groupGiftWrapFee = computeGiftWrapFee(addons.giftWrapAddon ?? false, commissions);
-        const groupShipmentProtectionFee = computeShipmentProtectionFee(groupTotal, addons.shipmentProtectionAddon ?? false, commissions);
+        /*
+         * C5e — the same three tiers `createOrderForGroup` enforces, so the figure
+         * SHOWN and the figure CHARGED cannot differ over an add-on the seller
+         * declined.
+         *
+         * 🛑 `finalSale` is read off the LIVE product here, not a snapshot, and
+         * that is correct rather than an oversight: at preview time no order exists
+         * to have snapshotted it. The snapshot matters at the other two moments —
+         * order creation (so the written row is authoritative) and claim time (so a
+         * seller cannot flip the switch after the sale).
+         */
+        const groupHasFinalSale = group.some(({ product }) => product?.finalSale === true);
+        const { shippingProtectionFee: groupShipmentProtectionFee, saleProtectionFee: groupSaleProtectionFee, } = computeProtectionFees({
+            subtotal: groupTotal,
+            selected: {
+                shipping: addons.shipmentProtectionAddon ?? false,
+                sale: addons.saleProtectionAddon ?? false,
+            },
+            tiers: {
+                platformShipping: commissions.shipmentProtectionFeeEnabled === true,
+                platformSale: commissions.saleProtectionFeeEnabled === true,
+                sellerShipping: storeProtections.shipping,
+                sellerSale: storeProtections.sale,
+                finalSale: groupHasFinalSale,
+            },
+            shippingFee: (s, sel) => computeShipmentProtectionFee(s, sel, commissions),
+            saleFee: (s, sel) => computeSaleProtectionFee(s, sel, commissions),
+        });
         let groupGstAmount = 0;
         if (siteSettings?.gst?.enabled && resolvedAddress?.state) {
             /*
@@ -1057,6 +1183,7 @@ export async function previewCheckoutPricing(input) {
             whatsappNotifyFee: groupWhatsappFee,
             giftWrapFee: groupGiftWrapFee,
             shipmentProtectionFee: groupShipmentProtectionFee,
+            saleProtectionFee: groupSaleProtectionFee,
             /*
              * INFORMATIONAL — the tax already INSIDE these prices, so checkout can
              * render "incl. GST ₹47.57". 🛑 Deliberately NOT added to `total` below:
@@ -1073,7 +1200,11 @@ export async function previewCheckoutPricing(input) {
                 groupCodHandlingFee +
                 groupWhatsappFee +
                 groupGiftWrapFee +
-                groupShipmentProtectionFee,
+                groupShipmentProtectionFee +
+                groupSaleProtectionFee,
+            supportsShippingProtection: storeProtections.shipping,
+            supportsSaleProtection: storeProtections.sale,
+            hasFinalSaleItem: groupHasFinalSale,
         });
     }
     const sum = (pick) => stores.reduce((acc, s) => acc + pick(s), 0);
@@ -1082,6 +1213,7 @@ export async function previewCheckoutPricing(input) {
     const whatsappNotifyFeeTotal = sum((s) => s.whatsappNotifyFee);
     const giftWrapFeeTotal = sum((s) => s.giftWrapFee);
     const shipmentProtectionFeeTotal = sum((s) => s.shipmentProtectionFee);
+    const saleProtectionFeeTotal = sum((s) => s.saleProtectionFee);
     const gstAmount = sum((s) => s.gstAmount);
     const couponDiscount = sum((s) => s.couponDiscount);
     // One capped commission for the whole checkout, on every payment method —
@@ -1093,6 +1225,7 @@ export async function previewCheckoutPricing(input) {
         whatsappNotifyFeeTotal +
         giftWrapFeeTotal +
         shipmentProtectionFeeTotal +
+        saleProtectionFeeTotal +
         platformFee +
         gstOnFee +
         gstAmount;
@@ -1103,6 +1236,7 @@ export async function previewCheckoutPricing(input) {
         whatsappNotifyFee: whatsappNotifyFeeTotal,
         giftWrapFee: giftWrapFeeTotal,
         shipmentProtectionFee: shipmentProtectionFeeTotal,
+        saleProtectionFee: saleProtectionFeeTotal,
         gstAmount,
         couponDiscount,
         platformFee,

package/dist/_internal/server/features/checkout/bundle-expansion.js

@@ -20,12 +20,12 @@
  * checkout — the Firestore transaction guarantees the second checkout sees
  * the first's decrement before re-running its own validation.
  */
-import { ProductStatusValues } from "../../../../features/products/schemas/firestore";
-import { getCartLineMembers } from "../../../shared/checkout/line-members";
+import { ProductStatusValues } from "../../../../features/products/schemas/firestore.js";
+import { getCartLineMembers } from "../../../shared/checkout/line-members.js";
 // Re-exported here so the many existing importers of this module keep working;
 // the definitions live in shared/ because `rules/_registry.ts` and
 // `order-math.ts` need them too and cannot import from server/.
-export { getCartLineMembers, getCartItemMemberIds, isMultiMemberLine, } from "../../../shared/checkout/line-members";
+export { getCartLineMembers, getCartItemMemberIds, isMultiMemberLine, } from "../../../shared/checkout/line-members.js";
 /** Build the unique-product-id + per-product decrement map for a cart. */
 export function getExpandedDecrements(cartItems) {
     const decrements = new Map();

package/dist/_internal/server/features/checkout/expand-order-items.js

@@ -17,8 +17,8 @@
  * The buyer's receipt is unaffected: `groupOrderItemsByLine` collapses these
  * rows back under one header, which it was already written to do.
  */
-import { lineTotalFor, allocateAcrossMembers } from "../../../shared/checkout/order-math";
-import { isFinalSale } from "../../../../features/products/constants/final-sale";
+import { lineTotalFor, allocateAcrossMembers } from "../../../shared/checkout/order-math.js";
+import { isFinalSale } from "../../../../features/products/constants/final-sale.js";
 /**
  * Expand one cart line into the order rows it should produce.
  *
@@ -72,7 +72,21 @@ export function expandCartLineToOrderRows(item, representative, productById) {
                 ...(representative.categorySlugs?.[0]
                     ? { categorySlug: representative.categorySlugs[0] }
                     : {}),
+                /*
+                 * I8 — the category and brand DISPLAY NAMES, beside the slug.
+                 *
+                 * `categoryNames[0]` is the default leaf's name, parallel to
+                 * `categorySlugs[0]`. Snapshotted for the reason the slug alone is not
+                 * enough: a slug survives a rename, but a receipt has to show a NAME, and
+                 * re-resolving it at render time would let a renamed category change what
+                 * a past invoice says.
+                 */
+                ...(representative.categoryNames?.[0]
+                    ? { categoryName: representative.categoryNames[0] }
+                    : {}),
+                ...(representative.brand ? { brand: representative.brand } : {}),
                 ...(representative.listingType ? { listingType: representative.listingType } : {}),
+                ...(representative.condition ? { condition: representative.condition } : {}),
                 // Legacy collapsed bundle rows (no groupMembers) keep their old shape so
                 // orders already in flight and their UI stay untouched.
                 ...(item.bundleCategorySlug && item.bundleProductIds
@@ -121,7 +135,14 @@ export function expandCartLineToOrderRows(item, representative, productById) {
              * been deleted, which is the whole reason that snapshot exists.
              */
             ...(product?.categorySlugs?.[0] ? { categorySlug: product.categorySlugs[0] } : {}),
+            // I8 - the same snapshot per member. `product` may be gone by order time,
+            // which is exactly why the member snapshot exists, so both are guarded.
+            ...(product?.categoryNames?.[0] ? { categoryName: product.categoryNames[0] } : {}),
+            ...(product?.brand ? { brand: product.brand } : {}),
             ...(product?.listingType ? { listingType: product.listingType } : {}),
+            // Per MEMBER — a bundle can mix a sealed item with a loose one, and a
+            // blended condition would describe neither.
+            ...(product?.condition ? { condition: product.condition } : {}),
             ...(gstRate != null ? { gstRate, ...(hsnCode ? { hsnCode } : {}) } : {}),
         };
     });

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

@@ -1,3 +1,3 @@
-export { createCheckoutOrderAction, attachPaymentAction, verifyAndPlacePhonePeOrderAction, previewCheckoutPricing, resolveShippingCost, } from "./actions";
-export { formatShippingAddress, } from "./data";
-export { CHECKOUT_DEFAULT_COMMISSIONS, CHECKOUT_PAYMENT_METHODS, } from "../../../shared/features/checkout/config";
+export { createCheckoutOrderAction, attachPaymentAction, verifyAndPlacePhonePeOrderAction, previewCheckoutPricing, resolveShippingCost, } from "./actions.js";
+export { formatShippingAddress, } from "./data.js";
+export { CHECKOUT_DEFAULT_COMMISSIONS, CHECKOUT_PAYMENT_METHODS, } from "../../../shared/features/checkout/config.js";

package/dist/_internal/server/features/checkout/locked-lines.js

@@ -21,20 +21,20 @@
  * @tag consumers:checkout/actions.ts
  * @tag sideEffects:firestore-write
  */
-import { offerRepository } from "../../../../features/seller/repository/offer.repository";
-import { cartRepository } from "../../../../features/cart/repository/cart.repository";
-import { bidRepository } from "../../../../repositories";
-import { OfferStatusValues } from "../../../../features/seller/schemas";
-import { BID_COLLECTION } from "../../../../features/auctions/schemas/firestore";
-import { PRODUCT_COLLECTION } from "../../../../features/products/schemas/firestore";
-import { ValidationError } from "../../../../errors";
-import { BID_ERROR_CODES } from "../../../../errors/error-codes";
-import { ERROR_MESSAGES } from "../../../../errors";
-import { getAdminDb } from "../../../../providers/db-firebase";
-import { serverLogger } from "../../../../monitoring/server-logger";
-import { normalizeError } from "../../../../errors/normalize";
-import { resolveDate } from "../../../../utils/date.formatter";
-import { activeLane, laneOf, laneBlockReason } from "../../../shared/checkout/lanes";
+import { offerRepository } from "../../../../features/seller/repository/offer.repository.js";
+import { cartRepository } from "../../../../features/cart/repository/cart.repository.js";
+import { bidRepository } from "../../../../repositories/index.js";
+import { OfferStatusValues } from "../../../../features/seller/schemas/index.js";
+import { BID_COLLECTION } from "../../../../features/auctions/schemas/firestore.js";
+import { PRODUCT_COLLECTION } from "../../../../features/products/schemas/firestore.js";
+import { ValidationError } from "../../../../errors/index.js";
+import { BID_ERROR_CODES } from "../../../../errors/error-codes.js";
+import { ERROR_MESSAGES } from "../../../../errors/index.js";
+import { getAdminDb } from "../../../../providers/db-firebase/index.js";
+import { serverLogger } from "../../../../monitoring/server-logger.js";
+import { normalizeError } from "../../../../errors/normalize.js";
+import { resolveDate } from "../../../../utils/date.formatter.js";
+import { activeLane, laneOf, laneBlockReason } from "../../../shared/checkout/lanes.js";
 /**
  * Refuse a checkout that isn't the cart's active lane.
  *

package/dist/_internal/server/features/checkout/prize-bundle-gates.js

@@ -8,8 +8,8 @@
  * fully automatic, there's nothing left for a buyer to "claim" before a
  * deadline.
  */
-import { ValidationError } from "../../../../errors";
-import { orderRepository } from "../../../../repositories";
+import { ValidationError } from "../../../../errors/index.js";
+import { orderRepository } from "../../../../repositories/index.js";
 /**
  * Pre-transaction read: for every cart item whose product has `maxPerUser`
  * set, count the user's existing active orders and reject the checkout if

package/dist/_internal/server/features/checkout/source-context.js

@@ -48,10 +48,10 @@
  * @tag consumers:checkout/actions.ts
  * @tag sideEffects:firestore-read
  */
-import { bidRepository } from "../../../../features/auctions/repository/bid.repository";
-import { offerRepository } from "../../../../features/seller/repository/offer.repository";
-import { normalizeError } from "../../../../errors/normalize";
-import { serverLogger } from "../../../../monitoring";
+import { bidRepository } from "../../../../features/auctions/repository/bid.repository.js";
+import { offerRepository } from "../../../../features/seller/repository/offer.repository.js";
+import { normalizeError } from "../../../../errors/normalize.js";
+import { serverLogger } from "../../../../monitoring/index.js";
 /** Bids that count toward "against N bidders" — a buyout is excluded. */
 function competitiveBids(bids) {
     return bids.filter((b) => !b.isBuyout).sort((a, b) => b.bidAmount - a.bidAmount);

package/dist/_internal/server/features/checkout/stock-restore.js

@@ -1,7 +1,7 @@
-import { ORDER_COLLECTION } from "../../../../features/orders/schemas/firestore";
-import { PRODUCT_COLLECTION } from "../../../../features/products/schemas/firestore";
-import { getListingRule } from "../../../shared/checkout/rules";
-import { getOrderItemMemberRefs } from "../../../shared/checkout/line-members";
+import { ORDER_COLLECTION } from "../../../../features/orders/schemas/firestore.js";
+import { PRODUCT_COLLECTION } from "../../../../features/products/schemas/firestore.js";
+import { getListingRule } from "../../../shared/checkout/rules/index.js";
+import { getOrderItemMemberRefs } from "../../../shared/checkout/line-members.js";
 /**
  * Per-product quantity to restore for one order — the inverse of
  * `getExpandedDecrements` (bundle-expansion.ts), but reads from

package/dist/_internal/server/features/checkout/upi-resolution.js

@@ -1,5 +1,5 @@
-import { storeRepository, userRepository } from "../../../../repositories";
-import { isSellerUser } from "../../../../features/auth/role-predicates";
+import { storeRepository, userRepository } from "../../../../repositories/index.js";
+import { isSellerUser } from "../../../../features/auth/role-predicates.js";
 /**
  * Resolves the UPI VPA to show a buyer paying manually for an order — the
  * seller's own `payoutDetails.upiId` for a seller-owned store (falling back

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

@@ -1,4 +1,4 @@
-import { mapBaseListingFields } from "../shared/listing-adapters";
+import { mapBaseListingFields } from "../shared/listing-adapters.js";
 /** Maps a raw `ProductDocument` to the client-safe classified shape. */
 export function toClientClassified(doc) {
     return {

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

@@ -1,2 +1,2 @@
-import { makeGetListingForDetail } from "../shared/listing-data-factory";
+import { makeGetListingForDetail } from "../shared/listing-data-factory.js";
 export const getClassifiedForDetail = makeGetListingForDetail("classified");

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

@@ -1,4 +1,4 @@
-export * from "./data";
-export * from "./adapters";
-export * from "./metadata";
-export * from "./og";
+export * from "./data.js";
+export * from "./adapters.js";
+export * from "./metadata.js";
+export * from "./og.js";

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

@@ -1,5 +1,5 @@
-import { renderOgLayout } from "../seo/og-layout";
-import { resolveOgImageUrl } from "../seo/og";
+import { renderOgLayout } from "../seo/og-layout.js";
+import { resolveOgImageUrl } from "../seo/og.js";
 export function renderClassifiedOg(doc, opts) {
     const meta = doc?.classified;
     const location = meta?.meetupArea

package/dist/_internal/server/features/digital-code/adapters.js

@@ -1,4 +1,4 @@
-import { mapBaseListingFields } from "../shared/listing-adapters";
+import { mapBaseListingFields } from "../shared/listing-adapters.js";
 /** Maps a raw `ProductDocument` to the client-safe digital-code shape. Strips codesAvailable/codePoolSize (operational counters). */
 export function toClientDigitalCode(doc) {
     const dc = doc.digitalCode ?? null;

package/dist/_internal/server/features/digital-code/data.js

@@ -1,2 +1,2 @@
-import { makeGetListingForDetail } from "../shared/listing-data-factory";
+import { makeGetListingForDetail } from "../shared/listing-data-factory.js";
 export const getDigitalCodeForDetail = makeGetListingForDetail("digital-code");

package/dist/_internal/server/features/digital-code/download.js

@@ -25,11 +25,11 @@
  * `GET /api/user/orders/[id]/invoice`, the one existing precedent in this
  * codebase for a gated download.
  */
-import { getAdminDb } from "../../../../providers/db-firebase/admin";
-import { getAdminStorage } from "../../../../providers/db-firebase";
-import { normalizeError } from "../../../../errors/normalize";
-import { ORDER_FIELDS } from "../../../../constants/field-names";
-import { PRODUCT_COLLECTION, PRODUCT_CODES_SUBCOLLECTION, } from "../../../../features/products/schemas/firestore";
+import { getAdminDb } from "../../../../providers/db-firebase/admin.js";
+import { getAdminStorage } from "../../../../providers/db-firebase/index.js";
+import { normalizeError } from "../../../../errors/normalize.js";
+import { ORDER_FIELDS } from "../../../../constants/field-names.js";
+import { PRODUCT_COLLECTION, PRODUCT_CODES_SUBCOLLECTION, } from "../../../../features/products/schemas/firestore.js";
 /** Order statuses at which delivered content may be downloaded. */
 export const CODE_DOWNLOAD_STATUSES = new Set([
     "confirmed",

package/dist/_internal/server/features/digital-code/index.js

@@ -1,4 +1,4 @@
-export * from "./data";
-export * from "./adapters";
-export * from "./metadata";
-export * from "./og";
+export * from "./data.js";
+export * from "./adapters.js";
+export * from "./metadata.js";
+export * from "./og.js";

package/dist/_internal/server/features/digital-code/og.js

@@ -1,5 +1,5 @@
-import { renderOgLayout } from "../seo/og-layout";
-import { resolveOgImageUrl } from "../seo/og";
+import { renderOgLayout } from "../seo/og-layout.js";
+import { resolveOgImageUrl } from "../seo/og.js";
 export function renderDigitalCodeOg(doc, opts) {
     const deliveryMethod = doc?.digitalCode?.codeDeliveryMethod === "auto-claim"
         ? "Instant delivery"