@mohasinac/appkit 4.55.0 → 4.56.0

package/dist/features/media/MediaImage.d.ts

@@ -24,7 +24,24 @@ export interface MediaImageProps {
      * one slide the visitor can actually see.
      */
     fetchPriority?: "high" | "low" | "auto";
-    /** CSS object-fit applied to the underlying img element. Defaults to `'cover'`. */
+    /**
+     * CSS object-fit applied to the underlying img element. Defaults to
+     * `'contain'`.
+     *
+     * 🛑 THE DEFAULT CHANGED on 2026-10-20, from `'cover'`. `cover` fills the
+     * box by cropping whatever does not fit, which is right for a photograph
+     * that continues past its frame and wrong for this catalogue: most of its
+     * imagery is a product shot centred on white, where the crop takes the
+     * product and leaves the background. `contain` fits the whole subject
+     * inside the shape and letterboxes the remainder against the tile's own
+     * surface colour.
+     *
+     * Pass `'cover'` explicitly where a FILLED box is the component's contract
+     * rather than a preference — a full-bleed backdrop with text over it, or a
+     * circular avatar. Three call sites do: `MediaAvatar`, and the slide and
+     * card backgrounds in `HeroCarousel`. A letterboxed backdrop there would put
+     * the dim overlay and the headline on bare surface.
+     */
     objectFit?: "cover" | "contain";
     /**
      * Emoji or text to show when `src` is undefined.

package/dist/features/media/MediaImage.js

@@ -67,7 +67,7 @@ function resolveSrcSet(input) {
         .filter(Boolean)
         .join(", ");
 }
-export function MediaImage({ src, alt, size = "card", priority = false, loading, fetchPriority, objectFit = "cover", fallback, className, rounded, shadow, style, sources, onError, }) {
+export function MediaImage({ src, alt, size = "card", priority = false, loading, fetchPriority, objectFit = "contain", fallback, className, rounded, shadow, style, sources, onError, }) {
     const [hasError, setHasError] = useState(false);
     const [isLoaded, setIsLoaded] = useState(false);
     const [retryCount, setRetryCount] = useState(0);

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

@@ -8,6 +8,7 @@ import type { ListingType } from "../../products/types";
 import type { StatusChangeEntry } from "../../../_internal/shared/history/index";
 import type { ReturnReason } from "../../../_internal/shared/features/orders/return-reasons";
 import type { ReturnCustodyState } from "../../../_internal/shared/features/returns/custody";
+import type { ActualShipmentCost, SelectedShippingQuote, ShippingReconciliation } from "../../../_internal/shared/shipping/quote";
 import type { Encrypted, Plaintext } from "../../../security/encrypted";
 export interface OrderSourceStandard {
     path: "standard";
@@ -550,6 +551,43 @@ export interface OrderDocument extends BaseDocument {
     shippingMethod?: ShippingMethod;
     shippingCarrier?: string;
     trackingUrl?: string;
+    /**
+     * The courier the BUYER picked at checkout, and what they were charged for
+     * it, frozen at order creation.
+     *
+     * 🛑 Stored, never recomputed. Carrier rates move hourly, so re-quoting at
+     * reconciliation time would compare the seller's real spend against a price
+     * nobody was ever charged, and the buyer's refund would depend on when a job
+     * happened to run. Same reasoning as `sourceContext`.
+     *
+     * `chargedRate` is the ₹50-rounded figure and is the ONLY one that is
+     * billed; `rawRate` is kept for the audit trail and is never rendered.
+     * Absent on orders placed before the picker shipped, and on any order whose
+     * seller ships manually — so every reader must treat absence as "no quote
+     * was taken", never as zero.
+     */
+    selectedShippingQuote?: SelectedShippingQuote;
+    /**
+     * What the seller actually spent on postage, recorded at dispatch.
+     *
+     * Written by the seller's ship action. Its presence is what makes an order
+     * eligible for reconciliation; its absence means the parcel has not been
+     * dispatched or the seller has not told us what it cost.
+     */
+    actualShipmentCost?: ActualShipmentCost;
+    /**
+     * The outcome of comparing the two above — computed ONCE, when the seller
+     * dispatches, and then left alone.
+     *
+     * 🛑 Its presence is the idempotency key for the points credit. Crediting is
+     * an append to a ledger, so a job that ran twice would pay the buyer twice
+     * and nothing downstream could tell the difference between that and two
+     * genuine savings. Every writer must check this field is unset before
+     * writing a `shipping_saving` entry.
+     */
+    shippingReconciliation?: ShippingReconciliation & {
+        reconciledAt: Date;
+    };
     /**
      * The carrier's label PDF, once a shipment has been booked.
      *

package/dist/features/points/repository/points.repository.d.ts

@@ -0,0 +1,81 @@
+import { type PointsEntryKind, type PointsLedgerEntry } from "../schemas/firestore";
+/**
+ * The points ledger: append-only entries, and a balance that is their sum.
+ *
+ * ## 🛑 Every mutation is a TRANSACTION over the ledger and the mirror
+ *
+ * `users/{uid}.pointsBalance` is a denormalised mirror of the ledger, kept so
+ * a page can show a balance in one read instead of scanning an unbounded
+ * collection. Root Cause #42 is explicit about what happens to a mirror the
+ * moment one write path forgets it, and this mirror guards MONEY-SHAPED value:
+ * drift here either hands a buyer points nobody credited, or swallows points
+ * they earned.
+ *
+ * So the entry and the mirror move together or not at all, and the mirror is
+ * incremented from the value read INSIDE the transaction rather than from a
+ * figure the caller passed in — two concurrent credits that each read "53" and
+ * each wrote "106" would lose one of them.
+ *
+ * `redeem()` additionally re-checks the balance inside the transaction. A
+ * caller that validated the balance a moment earlier is working from a read
+ * that may already be stale, and the failure mode is a negative balance — the
+ * one state this ledger must never reach.
+ */
+export declare class PointsRepository {
+    /**
+     * Current balance, from the mirror.
+     *
+     * 🛑 Falls back to summing the ledger when the mirror is absent, rather than
+     * returning 0. An unseeded or pre-feature user document has no
+     * `pointsBalance`, and answering "0" for someone with real credits would
+     * silently deny them money they are owed. Absence means "not computed yet",
+     * never "nothing".
+     */
+    getBalance(userId: string): Promise<number>;
+    /**
+     * The authoritative balance, computed from the entries themselves.
+     *
+     * Unbounded by nature, so it is NOT the read path — it exists to repair the
+     * mirror and to let a reconciliation job prove the two agree.
+     */
+    sumLedger(userId: string): Promise<number>;
+    /**
+     * Append an entry and move the mirror, atomically.
+     *
+     * Returns the new balance so a caller can report it without a second read.
+     */
+    append(input: {
+        userId: string;
+        kind: PointsEntryKind;
+        amount: number;
+        description: string;
+        orderId?: string;
+        adminReason?: string;
+        actorUid?: string;
+    }): Promise<{
+        entryId: string;
+        balance: number;
+    }>;
+    /**
+     * Spend points against an order.
+     *
+     * 🛑 `points` is given POSITIVE and stored NEGATIVE. The caller is saying
+     * "spend 53", and making them pass `-53` is an invitation to pass `53` by
+     * mistake and credit somebody instead of charging them.
+     *
+     * Re-reads the balance inside the transaction and refuses rather than going
+     * negative — see the class header.
+     */
+    redeem(input: {
+        userId: string;
+        points: number;
+        orderId: string;
+        description: string;
+    }): Promise<{
+        entryId: string;
+        balance: number;
+    }>;
+    /** Most recent entries first, for the buyer's own points page. */
+    listForUser(userId: string, limit?: number): Promise<PointsLedgerEntry[]>;
+}
+export declare const pointsRepository: PointsRepository;

package/dist/features/points/repository/points.repository.js

@@ -0,0 +1,155 @@
+import { getAdminDb } from "../../../providers/db-firebase/index.js";
+import { POINTS_LEDGER_COLLECTION, isPointsEntryWellFormed, } from "../schemas/firestore.js";
+import { USER_COLLECTION } from "../../auth/schemas/firestore.js";
+/**
+ * The points ledger: append-only entries, and a balance that is their sum.
+ *
+ * ## 🛑 Every mutation is a TRANSACTION over the ledger and the mirror
+ *
+ * `users/{uid}.pointsBalance` is a denormalised mirror of the ledger, kept so
+ * a page can show a balance in one read instead of scanning an unbounded
+ * collection. Root Cause #42 is explicit about what happens to a mirror the
+ * moment one write path forgets it, and this mirror guards MONEY-SHAPED value:
+ * drift here either hands a buyer points nobody credited, or swallows points
+ * they earned.
+ *
+ * So the entry and the mirror move together or not at all, and the mirror is
+ * incremented from the value read INSIDE the transaction rather than from a
+ * figure the caller passed in — two concurrent credits that each read "53" and
+ * each wrote "106" would lose one of them.
+ *
+ * `redeem()` additionally re-checks the balance inside the transaction. A
+ * caller that validated the balance a moment earlier is working from a read
+ * that may already be stale, and the failure mode is a negative balance — the
+ * one state this ledger must never reach.
+ */
+export class PointsRepository {
+    /**
+     * Current balance, from the mirror.
+     *
+     * 🛑 Falls back to summing the ledger when the mirror is absent, rather than
+     * returning 0. An unseeded or pre-feature user document has no
+     * `pointsBalance`, and answering "0" for someone with real credits would
+     * silently deny them money they are owed. Absence means "not computed yet",
+     * never "nothing".
+     */
+    async getBalance(userId) {
+        const db = getAdminDb();
+        const snap = await db.collection(USER_COLLECTION).doc(userId).get();
+        const mirrored = snap.data()?.pointsBalance;
+        if (typeof mirrored === "number")
+            return mirrored;
+        return this.sumLedger(userId);
+    }
+    /**
+     * The authoritative balance, computed from the entries themselves.
+     *
+     * Unbounded by nature, so it is NOT the read path — it exists to repair the
+     * mirror and to let a reconciliation job prove the two agree.
+     */
+    async sumLedger(userId) {
+        const db = getAdminDb();
+        const rows = await db
+            .collection(POINTS_LEDGER_COLLECTION)
+            .where("userId", "==", userId)
+            .select("amount")
+            .get();
+        const total = rows.docs.reduce((sum, d) => sum + (Number(d.data().amount) || 0), 0);
+        return Math.round(total * 100) / 100;
+    }
+    /**
+     * Append an entry and move the mirror, atomically.
+     *
+     * Returns the new balance so a caller can report it without a second read.
+     */
+    async append(input) {
+        if (!isPointsEntryWellFormed(input)) {
+            /*
+             * 🛑 Throws rather than writing a row it knows is malformed. A ledger
+             * whose invariant is only enforced by its callers is a ledger whose
+             * invariant is not enforced — and a zero-amount or wrong-signed entry is
+             * invisible in a balance while being wrong in an audit.
+             */
+            throw new Error(`Malformed points entry: kind=${input.kind} amount=${input.amount}`);
+        }
+        const db = getAdminDb();
+        const entryRef = db.collection(POINTS_LEDGER_COLLECTION).doc();
+        const userRef = db.collection(USER_COLLECTION).doc(input.userId);
+        const balance = await db.runTransaction(async (tx) => {
+            const userSnap = await tx.get(userRef);
+            const current = typeof userSnap.data()?.pointsBalance === "number"
+                ? userSnap.data().pointsBalance
+                : 0;
+            const next = Math.round((current + input.amount) * 100) / 100;
+            const entry = {
+                id: entryRef.id,
+                userId: input.userId,
+                kind: input.kind,
+                amount: input.amount,
+                description: input.description,
+                ...(input.orderId ? { orderId: input.orderId } : {}),
+                ...(input.adminReason ? { adminReason: input.adminReason } : {}),
+                ...(input.actorUid ? { actorUid: input.actorUid } : {}),
+                createdAt: new Date(),
+                updatedAt: new Date(),
+            };
+            tx.set(entryRef, entry);
+            tx.set(userRef, { pointsBalance: next }, { merge: true });
+            return next;
+        });
+        return { entryId: entryRef.id, balance };
+    }
+    /**
+     * Spend points against an order.
+     *
+     * 🛑 `points` is given POSITIVE and stored NEGATIVE. The caller is saying
+     * "spend 53", and making them pass `-53` is an invitation to pass `53` by
+     * mistake and credit somebody instead of charging them.
+     *
+     * Re-reads the balance inside the transaction and refuses rather than going
+     * negative — see the class header.
+     */
+    async redeem(input) {
+        if (!Number.isFinite(input.points) || input.points <= 0) {
+            throw new Error(`Redemption must be positive, got ${input.points}`);
+        }
+        const db = getAdminDb();
+        const entryRef = db.collection(POINTS_LEDGER_COLLECTION).doc();
+        const userRef = db.collection(USER_COLLECTION).doc(input.userId);
+        const balance = await db.runTransaction(async (tx) => {
+            const userSnap = await tx.get(userRef);
+            const current = typeof userSnap.data()?.pointsBalance === "number"
+                ? userSnap.data().pointsBalance
+                : 0;
+            if (current < input.points) {
+                throw new Error("INSUFFICIENT_POINTS");
+            }
+            const next = Math.round((current - input.points) * 100) / 100;
+            tx.set(entryRef, {
+                id: entryRef.id,
+                userId: input.userId,
+                kind: "redemption",
+                amount: -input.points,
+                orderId: input.orderId,
+                description: input.description,
+                createdAt: new Date(),
+                updatedAt: new Date(),
+            });
+            tx.set(userRef, { pointsBalance: next }, { merge: true });
+            return next;
+        });
+        return { entryId: entryRef.id, balance };
+    }
+    /** Most recent entries first, for the buyer's own points page. */
+    async listForUser(userId, limit = 50) {
+        const db = getAdminDb();
+        const rows = await db
+            .collection(POINTS_LEDGER_COLLECTION)
+            .where("userId", "==", userId)
+            .orderBy("createdAt", "desc")
+            .limit(limit)
+            .get();
+        return rows.docs.map((d) => d.data());
+    }
+}
+export const pointsRepository = new PointsRepository();

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

@@ -0,0 +1,102 @@
+/**
+ * Buyer points — 1 point = ₹1, spendable only against a future order.
+ *
+ * ## 🛑 This is NOT a wallet, and the distinction is legal, not stylistic
+ *
+ * A wallet holds the customer's money: it can be withdrawn, it is a liability
+ * payable in cash, and in India storing redeemable value on behalf of a
+ * customer is PPI territory with RBI authorisation attached. Points here are a
+ * DISCOUNT ENTITLEMENT — they arise from shipping we charged and did not
+ * spend, they can only ever reduce the price of a later order on this site,
+ * and they are never payable out.
+ *
+ * Consequences that must survive every future change:
+ *
+ *   - no withdrawal path, ever
+ *   - no transfer between users
+ *   - never refunded as cash when an order is cancelled; points SPENT on a
+ *     cancelled order are returned as points
+ *   - they do not earn interest and are not a balance the user "owns"
+ *
+ * ## Why a ledger and not a counter
+ *
+ * A single `points: number` on the user document cannot answer "where did this
+ * come from", cannot be reconciled against the orders that generated it, and
+ * loses the audit trail the moment two writes race. Root Cause #102 is the
+ * same shape one domain over: a counter that could not express what it was
+ * counting silently drifted, and nothing errored because a wrong number is
+ * just a number.
+ *
+ * So: append-only entries, and the balance is their sum. `pointsBalance` on the
+ * user document is a derived MIRROR for cheap reads — and per Root Cause #42
+ * the reader must be able to fall back to summing the ledger, because a mirror
+ * that only one write path maintains will drift.
+ */
+import type { BaseDocument } from "../../../_internal/shared/types/base-document";
+/**
+ * Why points moved.
+ *
+ * 🛑 A closed union with its values enumerated, so a new source is a compile
+ * error at every exhaustive read rather than an unlabelled row. The admin
+ * answer to "why do I have 53 points" is this field.
+ */
+export declare const POINTS_ENTRY_KIND_VALUES: readonly ["shipping_saving", "redemption", "redemption_reversal", "admin_adjustment"];
+export type PointsEntryKind = (typeof POINTS_ENTRY_KIND_VALUES)[number];
+export interface PointsLedgerEntry extends BaseDocument {
+    /** Auth UID of the buyer. The ledger is keyed on the person, not the order. */
+    userId: string;
+    kind: PointsEntryKind;
+    /**
+     * Signed, in points (= rupees). Positive credits, negative spends.
+     *
+     * 🛑 Signed here even though `ShippingReconciliation` deliberately splits its
+     * two directions into separate non-negative fields. That split exists so a
+     * CALLER cannot misread which way the money went; a ledger is the one place
+     * the sign IS the meaning, and summing a column is how a balance is defined.
+     */
+    amount: number;
+    /** The order that caused this entry, when there is one. */
+    orderId?: string;
+    /**
+     * Human-readable, shown to the buyer on their points page.
+     *
+     * Written at creation rather than derived at render: the explanation names
+     * couriers and amounts that are true of that moment, and re-deriving it later
+     * from an order that has since been edited would describe something that
+     * never happened.
+     */
+    description: string;
+    /** Required for `admin_adjustment`. Never shown to the buyer. */
+    adminReason?: string;
+    /** Who made an `admin_adjustment`. */
+    actorUid?: string;
+}
+/**
+ * The ledger's own invariant, stated once so every writer can be checked
+ * against it.
+ *
+ * A `redemption` must be negative and every other kind must be positive —
+ * except `admin_adjustment`, which is the one kind that may go either way and
+ * is therefore the one kind that demands a reason.
+ */
+export declare function isPointsEntryWellFormed(entry: Pick<PointsLedgerEntry, "kind" | "amount" | "adminReason">): boolean;
+export declare const POINTS_LEDGER_COLLECTION = "pointsLedger";
+/**
+ * 🛑 Points cannot pay for the whole order, and this is the cap that enforces
+ * it.
+ *
+ * At 100% a buyer could place a zero-value order, which breaks the payment
+ * gateway path (a ₹0 Razorpay order is not a thing), makes COD meaningless,
+ * and turns a discount entitlement into something that behaves exactly like
+ * stored value — the one property this feature must not have. A ceiling keeps
+ * every order a real transaction.
+ */
+export declare const POINTS_MAX_REDEMPTION_PERCENT = 50;
+/**
+ * How many points may be spent on an order of this value.
+ *
+ * Floors to whole points: a fractional point is not something a user can be
+ * shown or reason about, and rounding UP would spend a point that was never
+ * credited.
+ */
+export declare function maxRedeemablePoints(orderTotal: number, balance: number): number;

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

@@ -0,0 +1,99 @@
+/**
+ * Buyer points — 1 point = ₹1, spendable only against a future order.
+ *
+ * ## 🛑 This is NOT a wallet, and the distinction is legal, not stylistic
+ *
+ * A wallet holds the customer's money: it can be withdrawn, it is a liability
+ * payable in cash, and in India storing redeemable value on behalf of a
+ * customer is PPI territory with RBI authorisation attached. Points here are a
+ * DISCOUNT ENTITLEMENT — they arise from shipping we charged and did not
+ * spend, they can only ever reduce the price of a later order on this site,
+ * and they are never payable out.
+ *
+ * Consequences that must survive every future change:
+ *
+ *   - no withdrawal path, ever
+ *   - no transfer between users
+ *   - never refunded as cash when an order is cancelled; points SPENT on a
+ *     cancelled order are returned as points
+ *   - they do not earn interest and are not a balance the user "owns"
+ *
+ * ## Why a ledger and not a counter
+ *
+ * A single `points: number` on the user document cannot answer "where did this
+ * come from", cannot be reconciled against the orders that generated it, and
+ * loses the audit trail the moment two writes race. Root Cause #102 is the
+ * same shape one domain over: a counter that could not express what it was
+ * counting silently drifted, and nothing errored because a wrong number is
+ * just a number.
+ *
+ * So: append-only entries, and the balance is their sum. `pointsBalance` on the
+ * user document is a derived MIRROR for cheap reads — and per Root Cause #42
+ * the reader must be able to fall back to summing the ledger, because a mirror
+ * that only one write path maintains will drift.
+ */
+/**
+ * Why points moved.
+ *
+ * 🛑 A closed union with its values enumerated, so a new source is a compile
+ * error at every exhaustive read rather than an unlabelled row. The admin
+ * answer to "why do I have 53 points" is this field.
+ */
+export const POINTS_ENTRY_KIND_VALUES = [
+    /** Shipping charged minus shipping actually spent, credited after dispatch. */
+    "shipping_saving",
+    /** Spent against an order's total at checkout. Always negative. */
+    "redemption",
+    /** A redemption returned because the order it paid for was cancelled. */
+    "redemption_reversal",
+    /** Manual adjustment by an admin, with a mandatory reason. */
+    "admin_adjustment",
+];
+/**
+ * The ledger's own invariant, stated once so every writer can be checked
+ * against it.
+ *
+ * A `redemption` must be negative and every other kind must be positive —
+ * except `admin_adjustment`, which is the one kind that may go either way and
+ * is therefore the one kind that demands a reason.
+ */
+export function isPointsEntryWellFormed(entry) {
+    if (!Number.isFinite(entry.amount) || entry.amount === 0)
+        return false;
+    switch (entry.kind) {
+        case "redemption":
+            return entry.amount < 0;
+        case "shipping_saving":
+        case "redemption_reversal":
+            return entry.amount > 0;
+        case "admin_adjustment":
+            return Boolean(entry.adminReason && entry.adminReason.trim().length >= 10);
+    }
+}
+export const POINTS_LEDGER_COLLECTION = "pointsLedger";
+/**
+ * 🛑 Points cannot pay for the whole order, and this is the cap that enforces
+ * it.
+ *
+ * At 100% a buyer could place a zero-value order, which breaks the payment
+ * gateway path (a ₹0 Razorpay order is not a thing), makes COD meaningless,
+ * and turns a discount entitlement into something that behaves exactly like
+ * stored value — the one property this feature must not have. A ceiling keeps
+ * every order a real transaction.
+ */
+export const POINTS_MAX_REDEMPTION_PERCENT = 50;
+/**
+ * How many points may be spent on an order of this value.
+ *
+ * Floors to whole points: a fractional point is not something a user can be
+ * shown or reason about, and rounding UP would spend a point that was never
+ * credited.
+ */
+export function maxRedeemablePoints(orderTotal, balance) {
+    if (!Number.isFinite(orderTotal) || orderTotal <= 0)
+        return 0;
+    if (!Number.isFinite(balance) || balance <= 0)
+        return 0;
+    const cap = Math.floor((orderTotal * POINTS_MAX_REDEMPTION_PERCENT) / 100);
+    return Math.max(0, Math.min(Math.floor(balance), cap));
+}

package/dist/features/pre-orders/components/PreOrderDetailPageView.js

@@ -37,6 +37,7 @@ import { computeRelatedItems } from "../../../_internal/server/features/products
 import { GroupedListingsCarousel } from "../../grouped/components/GroupedListingsCarousel.js";
 import { getGroupsWithItemsForProduct } from "../../../_internal/server/features/grouped/data.js";
 import { OwnerQuickActions } from "../../admin/components/OwnerQuickActions.js";
+import { PurchaseReviewAffordance } from "../../reviews/components/PurchaseReviewAffordance.js";
 function toDescriptionHtml(raw) {
     if (!raw)
         return "";
@@ -167,5 +168,5 @@ export async function PreOrderDetailPageView({ id, initialPreOrder, onReserveNow
                             ? () => (_jsx(SublistingCarouselSection, { sublistingCategoryId: sublistingCategoryId, currentListingId: String(product.id) }))
                             : undefined, renderGroupSection: groupId
                             ? () => (_jsx(ShowGroupSection, { groupId: groupId, currentSlug: String(p.slug ?? product.id), isParent: isGroupParent, groupTitle: groupTitle }))
-                            : undefined, renderTabs: () => (_jsx(ProductTabsShell, { descriptionContent: descriptionHtml ? (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm sm:prose max-w-none dark:prose-invert", className: "text-[var(--appkit-color-text-muted)]" })) : undefined, specsContent: specs.length > 0 ? (_jsx(SpecTable, { rows: specs })) : undefined, customTabs: toCustomSectionTabs(p.customSections) })), renderBuyBar: () => (_jsx(PreOrderBuyBarPanel, { reserveTarget: reserveTarget, reservedCount: reservedCount, progressPct: progressPct, productId: String(product.id), price: price, currency: currency, depositAmount: depositAmount, depositPercent: depositPercent, isCancellable: isCancellable, tags: tags, onReserveNow: onReserveNow })), renderRelated: () => (_jsxs(Stack, { gap: "xl", children: [_jsx(GroupedListingsCarousel, { groups: groups }), _jsx(RelatedItemsSection, { relatedItems: relatedItems, relatedByBrand: relatedByBrand, relatedByTags: relatedByTags, relatedByStore: relatedByStore, categoryLabel: categoryName || category || undefined, brandLabel: brand || undefined, storeLabel: storeName || undefined })] })) }), _jsx(PreOrderBottomActions, { price: price, currency: currency })] })] }));
+                            : undefined, renderTabs: () => (_jsx(ProductTabsShell, { descriptionContent: descriptionHtml ? (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm sm:prose max-w-none dark:prose-invert", className: "text-[var(--appkit-color-text-muted)]" })) : undefined, specsContent: specs.length > 0 ? (_jsx(SpecTable, { rows: specs })) : undefined, customTabs: toCustomSectionTabs(p.customSections) })), renderBuyBar: () => (_jsx(PreOrderBuyBarPanel, { reserveTarget: reserveTarget, reservedCount: reservedCount, progressPct: progressPct, productId: String(product.id), price: price, currency: currency, depositAmount: depositAmount, depositPercent: depositPercent, isCancellable: isCancellable, tags: tags, onReserveNow: onReserveNow })), renderRelated: () => (_jsxs(Stack, { gap: "xl", children: [_jsx(PurchaseReviewAffordance, { productId: String(product.id), storeId: product.storeId ? String(product.storeId) : undefined }), _jsx(GroupedListingsCarousel, { groups: groups }), _jsx(RelatedItemsSection, { relatedItems: relatedItems, relatedByBrand: relatedByBrand, relatedByTags: relatedByTags, relatedByStore: relatedByStore, categoryLabel: categoryName || category || undefined, brandLabel: brand || undefined, storeLabel: storeName || undefined })] })) }), _jsx(PreOrderBottomActions, { price: price, currency: currency })] })] }));
 }

package/dist/features/products/components/PrizeDrawDetailPageView.js

@@ -23,6 +23,7 @@ import { RelatedItemsSection } from "./RelatedItemsSection.js";
 import { computeRelatedItems } from "../../../_internal/server/features/products/data.js";
 import { GroupedListingsCarousel } from "../../grouped/components/GroupedListingsCarousel.js";
 import { getGroupsWithItemsForProduct } from "../../../_internal/server/features/grouped/data.js";
+import { PurchaseReviewAffordance } from "../../reviews/components/PurchaseReviewAffordance.js";
 function toDescriptionHtml(raw) {
     if (!raw)
         return "";
@@ -132,5 +133,5 @@ export async function PrizeDrawDetailPageView({ id, initialPrizeDraw, currentUse
                     price: pricePerEntry,
                     storeId: typeof p.storeId === "string" ? p.storeId : undefined,
                     storeName: storeName ?? undefined,
-                } }), _jsxs(Container, { size: "xl", padding: "y-lg", children: [_jsxs(Row, { className: "mb-4", align: "center", justify: "between", gap: "sm", wrap: true, children: [_jsxs("nav", { "aria-label": "Breadcrumb", className: "flex items-center gap-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] text-[var(--appkit-color-text-muted)] flex-wrap", children: [_jsx(Link, { href: String(ROUTES.HOME), className: "hover:text-primary-600 dark:hover:text-primary-400 transition-colors", children: "Home" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.PRIZE_DRAWS), className: "hover:text-primary-600 dark:hover:text-primary-400 transition-colors", children: "Prize Draws" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Span, { className: "truncate max-w-[200px]", color: "muted", children: title })] }), _jsx(ShareButton, { title: title })] }), _jsx(PreOrderDetailView, { renderGallery: () => (_jsx(PrizeDrawCollage, { items: items, hideWonState: true })), renderInfo: () => (_jsxs(Stack, { gap: "md", children: [_jsx(OwnerQuickActions, { resource: "PRODUCT", placement: "detail", recordLabel: String(product.title ?? product.id), storeId: product.storeId ? String(product.storeId) : undefined, editHref: String(ROUTES.STORE.PRODUCTS_EDIT(String(product.id))) }), _jsxs(Div, { children: [_jsxs(Row, { gap: "xs", wrap: true, className: "mb-2", children: [_jsx(Span, { size: "xs", weight: "semibold", className: CLS_PRIZE_BADGE, children: "Prize Draw" }), _jsx(Span, { size: "xs", weight: "semibold", className: `inline-block ${statusClass(revealStatus)}`, padding: "pill-sm", rounded: "full", children: statusLabel(revealStatus) }), maxPerUser !== null && (_jsxs(Span, { size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", surface: "subtle", color: "muted", children: ["Limit: ", maxPerUser, " entries per customer"] })), maxPerUser !== null && userEntriesUsed !== null && (_jsxs(Span, { size: "xs", weight: "semibold", className: CLS_PRIZE_BADGE, children: ["You have used ", userEntriesUsed, "/", maxPerUser] }))] }), _jsx(Heading, { level: 1, className: "leading-snug", smSize: "2xl", color: "primary", size: "xl", weight: "bold", children: title })] }), _jsx(Div, { className: `${__P.p4}`, border: "subtle", rounded: "xl", surface: "muted", children: _jsxs(Stack, { gap: "sm", children: [_jsxs(Row, { justify: "between", align: "center", children: [_jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "sm", children: "Entries" }), _jsxs(Text, { size: "sm", weight: "semibold", children: [current, " / ", max, " (", remaining, " left)"] })] }), revealStart && (_jsxs(Row, { justify: "between", align: "center", children: [_jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "sm", children: "Reveal window opens" }), _jsx(Text, { size: "sm", weight: "medium", children: revealStart.toLocaleString() })] })), revealEnd && (_jsxs(Row, { justify: "between", align: "center", children: [_jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "sm", children: "Reveal window closes" }), _jsx(Text, { size: "sm", weight: "medium", children: revealEnd.toLocaleString() })] }))] }) }), descriptionHtml && (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "text-[length:var(--appkit-text-sm)] leading-relaxed text-[var(--appkit-color-text-muted)] line-clamp-4" })), safeSeller && (_jsx(Div, { className: `${__P.p3}`, border: "subtle", rounded: "xl", surface: "muted", children: _jsxs(Row, { justify: "between", align: "center", children: [_jsxs(Div, { children: [_jsx(Text, { className: "text-[10px] tracking-wide mb-0.5", color: "faint", transform: "uppercase", children: "Sold by" }), _jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: safeSeller })] }), storeHref && (_jsx(Link, { href: storeHref, className: "shrink-0 rounded-lg bg-primary/10 dark:bg-primary/20 px-[var(--appkit-space-3)] py-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] font-semibold text-primary-700 dark:text-primary-300 hover:bg-primary/20 dark:hover:bg-primary/30 transition-colors", children: "Visit Store \u2192" }))] }) }))] })), renderTabs: () => (_jsx(ProductTabsShell, { descriptionContent: descriptionHtml ? (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm sm:prose max-w-none dark:prose-invert", className: "text-[var(--appkit-color-text-muted)]" })) : undefined })), renderBuyBar: () => (_jsx(Div, { padding: "5", id: "prize-draw-buy-bar", border: "subtle", surface: "muted", rounded: "xl", children: _jsx(PrizeDrawEntryActions, { productId: String(product.id), productSlug: slug, title: title, pricePerEntry: pricePerEntry, currency: currency, remainingEntries: remaining, revealStatus: revealStatus, prizeGithubFileUrl: githubUrl }) })), renderRelated: () => (_jsxs(Stack, { gap: "xl", children: [_jsx(GroupedListingsCarousel, { groups: groups }), _jsx(RelatedItemsSection, { relatedItems: relatedItems, relatedByBrand: relatedByBrand, relatedByTags: relatedByTags, relatedByStore: relatedByStore, categoryLabel: categoryName, brandLabel: brand, storeLabel: storeName ?? undefined })] })) }), _jsx(PrizeDrawBottomActions, { pricePerEntry: pricePerEntry, currency: currency, closed: revealStatus === "closed" || remaining === 0 })] })] }));
+                } }), _jsxs(Container, { size: "xl", padding: "y-lg", children: [_jsxs(Row, { className: "mb-4", align: "center", justify: "between", gap: "sm", wrap: true, children: [_jsxs("nav", { "aria-label": "Breadcrumb", className: "flex items-center gap-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] text-[var(--appkit-color-text-muted)] flex-wrap", children: [_jsx(Link, { href: String(ROUTES.HOME), className: "hover:text-primary-600 dark:hover:text-primary-400 transition-colors", children: "Home" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.PRIZE_DRAWS), className: "hover:text-primary-600 dark:hover:text-primary-400 transition-colors", children: "Prize Draws" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Span, { className: "truncate max-w-[200px]", color: "muted", children: title })] }), _jsx(ShareButton, { title: title })] }), _jsx(PreOrderDetailView, { renderGallery: () => (_jsx(PrizeDrawCollage, { items: items, hideWonState: true })), renderInfo: () => (_jsxs(Stack, { gap: "md", children: [_jsx(OwnerQuickActions, { resource: "PRODUCT", placement: "detail", recordLabel: String(product.title ?? product.id), storeId: product.storeId ? String(product.storeId) : undefined, editHref: String(ROUTES.STORE.PRODUCTS_EDIT(String(product.id))) }), _jsxs(Div, { children: [_jsxs(Row, { gap: "xs", wrap: true, className: "mb-2", children: [_jsx(Span, { size: "xs", weight: "semibold", className: CLS_PRIZE_BADGE, children: "Prize Draw" }), _jsx(Span, { size: "xs", weight: "semibold", className: `inline-block ${statusClass(revealStatus)}`, padding: "pill-sm", rounded: "full", children: statusLabel(revealStatus) }), maxPerUser !== null && (_jsxs(Span, { size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", surface: "subtle", color: "muted", children: ["Limit: ", maxPerUser, " entries per customer"] })), maxPerUser !== null && userEntriesUsed !== null && (_jsxs(Span, { size: "xs", weight: "semibold", className: CLS_PRIZE_BADGE, children: ["You have used ", userEntriesUsed, "/", maxPerUser] }))] }), _jsx(Heading, { level: 1, className: "leading-snug", smSize: "2xl", color: "primary", size: "xl", weight: "bold", children: title })] }), _jsx(Div, { className: `${__P.p4}`, border: "subtle", rounded: "xl", surface: "muted", children: _jsxs(Stack, { gap: "sm", children: [_jsxs(Row, { justify: "between", align: "center", children: [_jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "sm", children: "Entries" }), _jsxs(Text, { size: "sm", weight: "semibold", children: [current, " / ", max, " (", remaining, " left)"] })] }), revealStart && (_jsxs(Row, { justify: "between", align: "center", children: [_jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "sm", children: "Reveal window opens" }), _jsx(Text, { size: "sm", weight: "medium", children: revealStart.toLocaleString() })] })), revealEnd && (_jsxs(Row, { justify: "between", align: "center", children: [_jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "sm", children: "Reveal window closes" }), _jsx(Text, { size: "sm", weight: "medium", children: revealEnd.toLocaleString() })] }))] }) }), descriptionHtml && (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "text-[length:var(--appkit-text-sm)] leading-relaxed text-[var(--appkit-color-text-muted)] line-clamp-4" })), safeSeller && (_jsx(Div, { className: `${__P.p3}`, border: "subtle", rounded: "xl", surface: "muted", children: _jsxs(Row, { justify: "between", align: "center", children: [_jsxs(Div, { children: [_jsx(Text, { className: "text-[10px] tracking-wide mb-0.5", color: "faint", transform: "uppercase", children: "Sold by" }), _jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: safeSeller })] }), storeHref && (_jsx(Link, { href: storeHref, className: "shrink-0 rounded-lg bg-primary/10 dark:bg-primary/20 px-[var(--appkit-space-3)] py-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] font-semibold text-primary-700 dark:text-primary-300 hover:bg-primary/20 dark:hover:bg-primary/30 transition-colors", children: "Visit Store \u2192" }))] }) }))] })), renderTabs: () => (_jsx(ProductTabsShell, { descriptionContent: descriptionHtml ? (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm sm:prose max-w-none dark:prose-invert", className: "text-[var(--appkit-color-text-muted)]" })) : undefined })), renderBuyBar: () => (_jsx(Div, { padding: "5", id: "prize-draw-buy-bar", border: "subtle", surface: "muted", rounded: "xl", children: _jsx(PrizeDrawEntryActions, { productId: String(product.id), productSlug: slug, title: title, pricePerEntry: pricePerEntry, currency: currency, remainingEntries: remaining, revealStatus: revealStatus, prizeGithubFileUrl: githubUrl }) })), renderRelated: () => (_jsxs(Stack, { gap: "xl", children: [_jsx(PurchaseReviewAffordance, { productId: String(product.id), storeId: product.storeId ? String(product.storeId) : undefined }), _jsx(GroupedListingsCarousel, { groups: groups }), _jsx(RelatedItemsSection, { relatedItems: relatedItems, relatedByBrand: relatedByBrand, relatedByTags: relatedByTags, relatedByStore: relatedByStore, categoryLabel: categoryName, brandLabel: brand, storeLabel: storeName ?? undefined })] })) }), _jsx(PrizeDrawBottomActions, { pricePerEntry: pricePerEntry, currency: currency, closed: revealStatus === "closed" || remaining === 0 })] })] }));
 }

package/dist/features/products/components/ProductDetailPageView.js

@@ -390,7 +390,9 @@ export async function ProductDetailPageView({ slug, initialProduct, renderOfferA
                                         categoryProductCount: (n, cat) => `${n} in ${cat}`,
                                     } }), productFeatures && features.length > 0 && (_jsx(FeatureBadgeList, { productFeatureIds: features, features: productFeatures })), !productFeatures && features.length > 0 && (_jsxs(Div, { border: "subtle", surface: "muted", padding: "inline", rounded: "xl", children: [_jsx(Text, { className: "mb-2 tracking-wide", color: "muted", size: "xs", weight: "semibold", transform: "uppercase", children: "About this product" }), _jsx(Ul, { spacing: "comfortable", size: "sm", color: "primary", children: features.map((f, i) => (_jsxs(Li, { layout: "flex-start", gap: "2", children: [_jsx(Span, { className: "mt-0.5 flex-shrink-0 text-primary-500", children: "\u2022" }), f] }, i))) })] })), descriptionHtml && (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "text-[length:var(--appkit-text-sm)] leading-relaxed text-[var(--appkit-color-text-muted)] line-clamp-4" })), safeSeller && (_jsx(Div, { className: `${__P.p3}`, border: "subtle", rounded: "xl", surface: "muted", children: _jsxs(Row, { justify: "between", align: "center", children: [_jsxs(Div, { children: [_jsx(Text, { className: "text-[10px] tracking-wide mb-0.5", color: "faint", transform: "uppercase", children: "Sold by" }), _jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: safeSeller }), typeof p.storeRating === "number" && p.storeRating > 0 && (_jsx(Row, { gap: "xs", align: "center", className: "mt-0.5", children: _jsxs(Text, { size: "xs", color: "muted", children: [_jsx(Span, { className: "text-warning", "aria-hidden": "true", children: "\u2605" }), " ", p.storeRating.toFixed(1), typeof p.storeReviewCount === "number" &&
                                                                     p.storeReviewCount > 0 &&
-                                                                    ` · ${p.storeReviewCount} reviews`] }) }))] }), _jsxs(Row, { gap: "xs", align: "center", className: "shrink-0", children: [storeId && _jsx(MessageSellerButton, { storeId: storeId, productId: product.id }), storeHref && (_jsx(Link, { href: storeHref, className: "rounded-lg bg-primary/10 dark:bg-primary/20 px-[var(--appkit-space-3)] py-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] font-semibold text-primary-700 dark:text-primary-300 hover:bg-primary/20 dark:hover:bg-primary/30 transition-colors", children: "Visit Store \u2192" }))] })] }) }))] })), renderActions: () => (_jsxs(Stack, { className: `${__P.p5}`, border: "subtle", gap: "md", rounded: "xl", surface: "muted", children: [price !== null && (_jsxs(Div, { children: [_jsx(PriceDisplay, { amount: price, originalAmount: originalPrice ?? undefined, currency: currency, variant: "detail" }), _jsx(MarketPriceAnchor, { band: priceBand?.byListingType?.[normalizeListingType(p)] ?? null, windowDays: priceBand?.windowDays ?? null, currency: currency, price: price }), inStock && effectiveStock !== null && effectiveStock <= 3 && (_jsxs(Text, { className: "mt-1 text-warning", size: "xs", children: ["Only ", effectiveStock, " left \u2014 order soon!"] })), inStock && effectiveStock !== null && effectiveStock > 3 && effectiveStock <= 10 && (_jsxs(Text, { className: "mt-1", color: "muted", size: "xs", children: [effectiveStock, " in stock"] })), madeToOrder && (_jsx(Text, { className: "mt-1", color: "muted", size: "xs", children: "Made to order \u2014 printed when you order, so it never runs out." })), partHref && (_jsxs(Text, { className: "mt-1", color: "muted", size: "xs", children: [partSlotLabel ?? "Part", ".", " ", _jsx(Link, { href: partHref, className: "text-primary-600 hover:underline", children: "See what else fits \u2192" }), fitsModels.length > 0 && (_jsxs(_Fragment, { children: [" ", "Fits:", " ", fitsModels.slice(0, 6).map((m, i) => (_jsxs(Text, { as: "span", children: [i > 0 ? ", " : "", m.categoryId ? (_jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(m.categoryId)), className: "text-primary-600 hover:underline", children: m.name })) : (m.name)] }, m.id)))] }))] }))] })), _jsxs(Stack, { gap: "sm", ...ctaAnchorProps(), children: [renderPrimaryActions ? (renderPrimaryActions({
+                                                                    ` · ${p.storeReviewCount} reviews`] }) }))] }), _jsxs(Row, { gap: "xs", align: "center", className: "shrink-0", children: [storeId && _jsx(MessageSellerButton, { storeId: storeId, productId: product.id }), storeHref && (_jsx(Link, { href: storeHref, className: "rounded-lg bg-primary/10 dark:bg-primary/20 px-[var(--appkit-space-3)] py-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] font-semibold text-primary-700 dark:text-primary-300 hover:bg-primary/20 dark:hover:bg-primary/30 transition-colors", children: "Visit Store \u2192" }))] })] }) }))] })), renderActions: () => (_jsxs(Stack, { className: `${__P.p5}`, border: "subtle", gap: "md", rounded: "xl", surface: "muted", children: [price !== null && (_jsxs(Div, { children: [_jsx(PriceDisplay, { amount: price, originalAmount: originalPrice ?? undefined, currency: currency, variant: "detail" }), siteSettings?.gst?.enabled === true &&
+                                            typeof p.gstRate === "number" &&
+                                            p.gstRate > 0 && (_jsxs(Text, { size: "xs", color: "muted", children: ["Incl. ", p.gstRate, "% GST"] })), _jsx(MarketPriceAnchor, { band: priceBand?.byListingType?.[normalizeListingType(p)] ?? null, windowDays: priceBand?.windowDays ?? null, currency: currency, price: price }), inStock && effectiveStock !== null && effectiveStock <= 3 && (_jsxs(Text, { className: "mt-1 text-warning", size: "xs", children: ["Only ", effectiveStock, " left \u2014 order soon!"] })), inStock && effectiveStock !== null && effectiveStock > 3 && effectiveStock <= 10 && (_jsxs(Text, { className: "mt-1", color: "muted", size: "xs", children: [effectiveStock, " in stock"] })), madeToOrder && (_jsx(Text, { className: "mt-1", color: "muted", size: "xs", children: "Made to order \u2014 printed when you order, so it never runs out." })), partHref && (_jsxs(Text, { className: "mt-1", color: "muted", size: "xs", children: [partSlotLabel ?? "Part", ".", " ", _jsx(Link, { href: partHref, className: "text-primary-600 hover:underline", children: "See what else fits \u2192" }), fitsModels.length > 0 && (_jsxs(_Fragment, { children: [" ", "Fits:", " ", fitsModels.slice(0, 6).map((m, i) => (_jsxs(Text, { as: "span", children: [i > 0 ? ", " : "", m.categoryId ? (_jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(m.categoryId)), className: "text-primary-600 hover:underline", children: m.name })) : (m.name)] }, m.id)))] }))] }))] })), _jsxs(Stack, { gap: "sm", ...ctaAnchorProps(), children: [renderPrimaryActions ? (renderPrimaryActions({
                                             productId: product.id,
                                             productSlug: product.slug ?? slug,
                                             productTitle: product.title,

package/dist/features/seller/actions/seller-actions.d.ts

@@ -83,6 +83,23 @@ export interface CustomShipOrderInput {
     shippingCarrier: string;
     trackingNumber: string;
     trackingUrl: string;
+    /**
+     * What this parcel actually cost the seller to post, in decimal rupees.
+     *
+     * 🛑 OPTIONAL, and that is the whole design. Making it required would break
+     * every existing dispatch and would force a number out of sellers who ship
+     * manually and have no quote to be measured against. Supplying it is what
+     * opts the order into reconciliation: the buyer gets points back when the
+     * seller spent less than was charged, and the seller absorbs the overage
+     * when they spent more.
+     *
+     * Absence therefore means "not reconciled", never "cost nothing" — the same
+     * distinction `resolveShippingCost.shippingUnavailable` exists to preserve,
+     * where a silent zero "would ship every parcel free at our expense".
+     */
+    actualShippingCost?: number;
+    /** The courier actually used, when it differs from the one the buyer picked. */
+    actualCourierName?: string;
 }
 export interface MarkEmiInstallmentPaidInput {
     /** 1-based installment number, matches EmiInstallment.index. */