@mohasinac/appkit 4.62.1 → 4.63.0

package/dist/features/seller/actions/offer-actions.js

@@ -7,6 +7,9 @@
 import { serverLogger } from "../../../monitoring/index.js";
 import { offerRepository } from "../repository/offer.repository.js";
 import { productRepository } from "../../products/repository/products.repository.js";
+import { categoriesRepository } from "../../categories/repository/categories.repository.js";
+import { resolveParcel } from "../../../_internal/shared/features/shipping/parcel.js";
+import { checkDestinations, assertAllServiceable, } from "../../../_internal/server/features/shipping/book-split.js";
 import { ProductStatusValues } from "../../products/schemas/index.js";
 import { sendNotification } from "../../admin/actions/notification-actions.js";
 import { userRepository } from "../../auth/repository/user.repository.js";
@@ -184,6 +187,59 @@ export async function respondToOffer(userId, input) {
         throw new ValidationError(ERROR_MESSAGES.OFFER.EXPIRED);
     let updated;
     if (action === "accept") {
+        /*
+         * ── S5a: a coordinated offer must be SHIPPABLE before it is binding ──
+         *
+         * Accepting locks a price and starts the buyer's checkout deadline, so it
+         * is the last moment at which "the courier cannot reach one of these
+         * addresses" costs nobody anything. After it, the coordinator has paid
+         * and the only remedies left are a refund and an apology.
+         *
+         * 🛑 Deliberately NOT at booking time, which is the obvious place and the
+         * wrong one: by then the money is taken, and a four-destination order
+         * that fails on the fourth has three parcels the carrier already accepted
+         * and no rollback. `assertAllServiceable` still guards the booking path —
+         * this is the check that keeps it from ever being reached in that state.
+         *
+         * 🛑 Costs NOTHING on an ordinary offer. `coordination` is absent on
+         * every non-coordinated one, so this whole block is skipped — a check
+         * that charges every seller for a feature most never use is how Rule #6's
+         * round-trip budget gets spent by accident.
+         *
+         * 🛑 The weight comes from `resolveParcel`, NOT from a literal. That
+         * module's whole argument is that an item weight systematically
+         * under-estimates a packed box (a bey is ~30 g loose and ~300 g boxed),
+         * and a hard-coded `1` here would be a fourth, worse tier beside the
+         * three it defines. The shipment tier is deliberately absent — nothing is
+         * packed yet at accept time, which is exactly the case tier two and three
+         * exist for.
+         *
+         * 🛑 **No resolvable weight SKIPS the check** rather than guessing one.
+         * The carrier is being asked "can you reach this pincode with a parcel of
+         * this size", so an invented weight asks a question about a parcel that
+         * does not exist and may refuse a destination that is perfectly
+         * reachable. Not checking is honest; the booking path still has
+         * `assertAllServiceable`, and a listing with no weight at any tier has a
+         * data problem this is not the place to report.
+         */
+        const members = offer.coordination?.members ?? [];
+        if (members.length > 0) {
+            const offerProduct = await productRepository.findById(offer.productId);
+            /*
+             * 🛑 `categorySlugs[0]` is the LEAF, and `findById` is the right lookup
+             * for it. Products carry the full ancestor chain `[leaf, …, root]` and
+             * categories are pure slugs (`id === slug`), so this is one get rather
+             * than the `where("slug","==")` query `findBySlugAndType` would run —
+             * and the leaf is the tier whose packed default is actually about this
+             * kind of item. A root's default would be the average of the catalogue.
+             */
+            const leafSlug = offerProduct?.categorySlugs?.[0];
+            const leaf = leafSlug ? await categoriesRepository.findById(leafSlug) : null;
+            const parcel = resolveParcel(null, offerProduct, leaf?.productDefaults ?? null);
+            if (parcel) {
+                assertAllServiceable(await checkDestinations(members, parcel.weightG / 1000));
+            }
+        }
         updated = await offerRepository.accept(offerId, offer.offerAmount, sellerNote, new Date(Date.now() + OFFER_CHECKOUT_WINDOW_MS));
     }
     else if (action === "decline") {

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

@@ -181,7 +181,7 @@ export declare function listSellerPayouts(userId: string, params?: {
     page?: number;
     pageSize?: number;
 }): Promise<{
-    items: import("../../payments").PayoutDocument[];
+    items: import("../../payments").StorePayoutDocument[];
     total: number;
     page: number;
     pageSize: number;

package/dist/features/seller/actions/seller-actions.js

@@ -299,6 +299,8 @@ export async function requestPayout(userId, userName, userEmail, input) {
     if (earnings.netAmount <= 0 || earnings.eligibleOrders.length === 0)
         throw new ValidationError("No eligible earnings available for payout.");
     const payout = await payoutRepository.createPayout({
+        /* A seller requesting their own earnings — a liability settlement. */
+        payeeType: "store",
         storeId: userId,
         sellerName: userName,
         sellerEmail: userEmail,
@@ -391,6 +393,8 @@ export async function bulkSellerOrder(userId, userRole, userDisplayName, userEma
     // The store-funded points, both ends — see the preview path above.
     ordersPointsBorneByStore(eligible));
     const payoutDoc = await payoutRepository.createPayout({
+        /* A seller requesting their own earnings — a liability settlement. */
+        payeeType: "store",
         storeId: userId,
         sellerName: userDisplayName,
         sellerEmail: userEmail,

package/dist/features/seller/components/DispatchForm.d.ts

@@ -0,0 +1,11 @@
+import React from "react";
+export declare function DispatchForm({ orderId, 
+/** Already dispatched? Then there is nothing to book and nothing to record. */
+trackingNumber, 
+/** Set by `bookShipment`; a booked parcel must not be re-booked. */
+platformBooked, onDispatched, }: {
+    orderId: string;
+    trackingNumber?: string;
+    platformBooked?: boolean;
+    onDispatched: () => void;
+}): React.JSX.Element;

package/dist/features/seller/components/DispatchForm.js

@@ -0,0 +1,190 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/*
+ * WHY: Bug 0e — a seller could not express "book this through us". The write
+ *      shape said `method: z.literal("custom")`, so there was no option to
+ *      offer; `platformBookedShipment`, which `order-math.ts` gates shipping
+ *      reimbursement on, had ZERO writers.
+ *
+ *      The schema now carries a discriminated union and the server does the
+ *      booking. This is the control that reaches it.
+ *
+ * WHAT: One dispatch panel with two branches — post it yourself, or book a
+ *       pickup on the platform's carrier account.
+ *
+ * EXPORTS: DispatchForm
+ *
+ * @tag domain:seller,orders,shipping
+ * @tag layer:component
+ * @tag pattern:form
+ * @tag access:client
+ * @tag consumers:SellerOrderDetailPanel
+ * @tag sideEffects:network
+ */
+import React, { useState } from "react";
+import { ACTIONS } from "../../../_internal/shared/actions/action-registry.js";
+import { SELLER_ENDPOINTS } from "../../../constants/api-endpoints.js";
+import { apiClient, ApiClientError } from "../../../http/index.js";
+import { useApiMutation } from "../../../client/api/useApiMutation.js";
+import { useQuery } from "@tanstack/react-query";
+import { normalizeError } from "../../../errors/normalize.js";
+import { toUserMessage } from "../../../errors/error-display-map.js";
+import { Button } from "../../../ui/components/Button.js";
+import { Div } from "../../../ui/components/Div.js";
+import { Row } from "../../../ui/components/Layout.js";
+import { Stack } from "../../../ui/components/Layout.js";
+import { Text } from "../../../ui/components/Typography.js";
+import { Form } from "../../../ui/components/Form.js";
+import { FieldInput } from "../../../ui/forms/FieldInput.js";
+import { FieldSelect } from "../../../ui/forms/FieldSelect.js";
+import { shipOrderSchema } from "../schemas/order-forms.js";
+import { applyZodIssues, rootLevelMessages } from "../../../ui/forms/apply-zod-issues.js";
+/**
+ * Box presets, in centimetres and kilograms.
+ *
+ * 🛑 A PRESET rather than four number inputs, and that is the whole UX
+ * argument: a seller packing a Beyblade does not know the parcel's
+ * dimensions, and a carrier rejects a wrong one with an opaque error at
+ * pickup time rather than at booking time. Four free fields produce four
+ * chances to guess. "Custom" exists for the genuinely odd parcel.
+ */
+const BOX_PRESETS = [
+    { id: "small", label: "Small — single top (0.3 kg)", weight: 0.3, length: 20, width: 15, height: 10 },
+    { id: "medium", label: "Medium — a few items (1 kg)", weight: 1, length: 30, width: 25, height: 15 },
+    { id: "large", label: "Large — stadium or bundle (3 kg)", weight: 3, length: 45, width: 35, height: 25 },
+];
+export function DispatchForm({ orderId, 
+/** Already dispatched? Then there is nothing to book and nothing to record. */
+trackingNumber, 
+/** Set by `bookShipment`; a booked parcel must not be re-booked. */
+platformBooked, onDispatched, }) {
+    const [method, setMethod] = useState("custom");
+    const [carrier, setCarrier] = useState("");
+    const [tracking, setTracking] = useState("");
+    const [trackingUrl, setTrackingUrl] = useState("");
+    const [pickupId, setPickupId] = useState("");
+    const [boxId, setBoxId] = useState(BOX_PRESETS[1].id);
+    const [error, setError] = useState(null);
+    /*
+     * 🛑 Fetched ONLY when the platform branch is open. The custom branch is
+     * the common case and needs no address at all, so loading this on mount
+     * would be a request on every order panel open for a field most sellers
+     * never reach (Rule #6).
+     */
+    /*
+     * 🛑 `toUserMessage(code)` on failure, never the server's own `error`
+     * string — an unmapped code would print server internals into the panel,
+     * which is literally how a Node `MODULE_NOT_FOUND` with a require stack
+     * reached a buyer-facing modal (Root Cause #86). `ApiClientError` carries
+     * the stable code, so the mapping survives the move off raw `fetch`.
+     */
+    /*
+     * 🛑 A REF, because `setFieldError` comes from `<Form>`'s render-prop and
+     * therefore does not exist in component scope where the mutation is
+     * declared. The mutation needs a STABLE sink — passing the render-prop
+     * helper directly is impossible, and re-creating the mutation per render to
+     * close over it would reset its pending state mid-request.
+     *
+     * It is assigned inside the render-prop below, so by the time any submit
+     * can fire it is populated. The `?.` is not defensive decoration: the first
+     * render completes before `<Form>` calls its child.
+     */
+    const fieldErrorSink = React.useRef(null);
+    const shipMutation = useApiMutation({
+        /*
+         * 🛑 Passed so the server's own per-field `issues` land on the fields
+         * they name. The route parses the same `shipOrderSchema` this form does,
+         * so a rejection it produces that the client parse did not is real news
+         * — a carrier the courier does not recognise, a pickup address that
+         * stopped being serviceable — and collapsing that into one generic
+         * sentence hides which input to fix.
+         */
+        setFieldError: (field, message) => fieldErrorSink.current?.(field, message),
+        mutationFn: (payload) => apiClient.post(SELLER_ENDPOINTS.ORDER_SHIP(orderId), payload),
+        onSuccess: () => onDispatched(),
+        onError: (err) => {
+            void normalizeError(err);
+            setError(toUserMessage(err instanceof ApiClientError ? err.code : undefined));
+        },
+    });
+    /*
+     * 🛑 `enabled` is what keeps this request off the common path. The custom
+     * branch needs no address at all, so loading pickups on mount would fire a
+     * request on every order panel a seller opens for a field most of them
+     * never reach (Rule #6). `useQuery` also dedupes and caches it, which the
+     * hand-rolled effect could not — it refetched on every branch toggle.
+     */
+    const pickupsQuery = useQuery({
+        queryKey: ["store", "addresses", "pickup"],
+        enabled: method === "platform",
+        queryFn: () => apiClient.get(SELLER_ENDPOINTS.STORE_ADDRESSES),
+    });
+    const pickups = Array.isArray(pickupsQuery.data?.items)
+        ? pickupsQuery.data.items
+        : [];
+    /*
+     * 🛑 A FAILED request and an empty list must not render the same. An empty
+     * dropdown reads as "this store has no pickup addresses" — a fact about the
+     * store — when it may be a network error, and the two need different
+     * actions from the seller.
+     */
+    const pickupsFailed = pickupsQuery.isError;
+    React.useEffect(() => {
+        if (pickups.length === 1 && !pickupId)
+            setPickupId(pickups[0].id);
+    }, [pickups, pickupId]);
+    if (trackingNumber) {
+        return (_jsxs(Stack, { gap: "sm", children: [_jsx(Text, { size: "sm", weight: "medium", children: "Dispatched" }), _jsx(Text, { size: "xs", color: "muted", children: platformBooked
+                        ? `Booked through LetItRip · ${trackingNumber}`
+                        : `Posted by you · ${trackingNumber}` })] }));
+    }
+    const submit = async (
+    /* The `<Form>` render-prop's own signature — `applyZodIssues` clears a
+     * field by passing `null`, so a `string`-only sink is not assignable. */
+    setFieldError, clearErrors) => {
+        clearErrors();
+        setError(null);
+        const box = BOX_PRESETS.find((b) => b.id === boxId) ?? BOX_PRESETS[1];
+        const payload = method === "platform"
+            ? {
+                method: "platform",
+                pickupAddressId: pickupId,
+                dimensions: {
+                    weight: box.weight,
+                    length: box.length,
+                    width: box.width,
+                    height: box.height,
+                },
+            }
+            : {
+                method: "custom",
+                shippingCarrier: carrier.trim(),
+                trackingNumber: tracking.trim(),
+                trackingUrl: trackingUrl.trim(),
+            };
+        /*
+         * Parsed against the SAME schema the route and the action use, so the
+         * branch's required fields are stated once. `applyZodIssues` can only
+         * attach path-bearing issues, so root-level refinements are surfaced
+         * separately or a refused save shows nothing at all.
+         */
+        const parsed = shipOrderSchema.safeParse(payload);
+        if (!parsed.success) {
+            applyZodIssues(parsed.error.issues, setFieldError);
+            const root = rootLevelMessages(parsed.error.issues);
+            if (root.length > 0)
+                setError(root.join(" "));
+            return;
+        }
+        shipMutation.mutate(parsed.data);
+    };
+    return (_jsxs(Stack, { gap: "3", children: [_jsx(Text, { size: "sm", weight: "medium", children: "Dispatch" }), _jsxs(Row, { gap: "sm", children: [_jsx(Button, { size: "sm", variant: method === "custom" ? "primary" : "outline", "aria-pressed": method === "custom", onClick: () => setMethod("custom"), children: "I posted it" }), _jsx(Button, { size: "sm", variant: method === "platform" ? "primary" : "outline", "aria-pressed": method === "platform", onClick: () => setMethod("platform"), children: "Book through LetItRip" })] }), _jsx(Form, { onSubmit: (e) => e.preventDefault(), children: ({ setFieldError, clearErrors }) => {
+                    fieldErrorSink.current = setFieldError;
+                    return (_jsxs(Stack, { gap: "3", children: [method === "custom" ? (_jsxs(_Fragment, { children: [_jsx(FieldInput, { name: "shippingCarrier", label: "Carrier", required: true, value: carrier, onChange: setCarrier }), _jsx(FieldInput, { name: "trackingNumber", label: "Tracking number", required: true, value: tracking, onChange: setTracking }), _jsx(FieldInput, { name: "trackingUrl", label: "Tracking URL", required: true, type: "url", value: trackingUrl, onChange: setTrackingUrl })] })) : (_jsxs(_Fragment, { children: [pickupsFailed ? (_jsx(Text, { size: "xs", color: "error", role: "alert", children: "Could not load your pickup addresses. Reopen this panel to try again." })) : pickups.length === 0 ? (_jsx(Text, { size: "xs", color: "muted", children: "Loading your pickup addresses\u2026" })) : (_jsx(FieldSelect, { name: "pickupAddressId", label: "Collect from", required: true, value: pickupId, onChange: setPickupId, options: pickups.map((p) => ({
+                                            value: p.id,
+                                            label: [p.label, p.city, p.postalCode].filter(Boolean).join(" · ") || p.id,
+                                        })) })), _jsx(FieldSelect, { name: "box", label: "Parcel size", required: true, value: boxId, onChange: setBoxId, options: BOX_PRESETS.map((b) => ({ value: b.id, label: b.label })) }), _jsx(Text, { size: "xs", color: "muted", children: "The courier is booked on the platform's account and the tracking id comes back from them \u2014 you do not enter one." })] })), error && (_jsx(Div, { textSize: "xs", className: "border border-error/20", color: "error", surface: "danger-surface", padding: "inlineSm", rounded: "lg", role: "alert", children: error })), _jsx(Button, { type: "submit", action: method === "platform"
+                                    ? ACTIONS.STORE["dispatch-platform"]
+                                    : ACTIONS.STORE["dispatch-custom"], isLoading: shipMutation.isPending, onClick: () => void submit(setFieldError, clearErrors) })] }));
+                } })] }));
+}

package/dist/features/seller/components/SellerOrdersView.js

@@ -5,6 +5,7 @@ import { OrderAddonBadges } from "../../orders/components/OrderAddonBadges.js";
 import { OrderProvenanceCard } from "../../orders/components/OrderProvenanceCard.js";
 import { groupOrderItemsByLine } from "../../orders/utils/bundle-grouping.js";
 import { normalizeError } from "../../../errors/normalize.js";
+import { formatCurrency } from "../../../utils/number.formatter.js";
 // The defining module, not a barrel (Root Cause #18). Maps a server error CODE
 // to user-facing copy; it can never return server text, which is the point.
 import { toUserMessage } from "../../../errors/error-display-map.js";
@@ -27,6 +28,7 @@ import { SectionForm, useSectionFormNav, buildSectionsFromSchema, visibleValues,
 import { useFormShellState, FormShellContext } from "../../../ui/forms/index.js";
 import { applyZodIssues } from "../../../ui/forms/apply-zod-issues.js";
 import { FormErrorSummary } from "../../../ui/forms/FormErrorSummary.js";
+import { DispatchForm } from "./DispatchForm.js";
 import { PhysicalLocationModal } from "./PhysicalLocationModal.js";
 import { ROUTES } from "../../../constants/index.js";
 import { toRecordArray, toCurrency, toStringValue } from "../hooks/useSellerListingData.js";
@@ -37,6 +39,13 @@ import { MediaImage } from "../../media/MediaImage.js";
 const __O = {
     yAuto: "overflow-y-auto",
 };
+/*
+ * The hairline that separates each panel section inside the order drawer.
+ * Named because the drawer gained its fourth section with D55's balance
+ * collector, and four copies of one border declaration is four places a
+ * future token rename has to find.
+ */
+const SECTION_DIVIDER = "border-t border-[var(--appkit-color-border)]";
 const DEFAULT_SORT = "-createdAt";
 const SORT_OPTIONS = [
     { value: sortBy("createdAt", "DESC"), label: "Newest" },
@@ -96,6 +105,69 @@ const EMI_INSTALLMENT_BADGE_VARIANT = {
     pending: "warning",
     overdue: "danger",
 };
+/**
+ * D55 — the seller's half of the pre-order balance.
+ *
+ * ## 🛑 Opening is an EVENT, and the control has to say so
+ *
+ * The balance has existed on the order since checkout. What the seller is
+ * declaring here is that the GOODS HAVE ARRIVED — a pre-order's premise is
+ * that the item does not exist yet, so asking for the balance before then is
+ * asking a buyer to fund inventory. The button's label and its blurb both
+ * name that, rather than saying "request payment", which would read as a
+ * nudge the seller could send at any time.
+ *
+ * ## Why no Cancel and no confirm dialog
+ *
+ * Opening takes money NOWHERE and reverses by simply not chasing it — the
+ * worst case is a buyer told a week early. A confirmation step on a
+ * non-destructive, idempotent action is the dialog people learn to click
+ * through, which is what makes the ones on real deletions worthless.
+ *
+ * ## The states are the seller's, not the buyer's
+ *
+ * Once opened the seller cannot act again, so every later state is read-only
+ * here: "with the buyer", "proof submitted, we are checking it", "paid". The
+ * verification is staff-only and deliberately NOT offered — a seller
+ * approving payment to themselves is not a review.
+ */
+function SellerBalanceBlock({ orderId, apiBase, balance, balanceDue, currency, onOpened, }) {
+    const [opening, setOpening] = React.useState(false);
+    const [error, setError] = React.useState(null);
+    if (balance) {
+        const label = balance.status === "paid"
+            ? "Balance paid"
+            : balance.status === "submitted"
+                ? "Balance proof under review"
+                : balance.status === "rejected"
+                    ? "Balance proof rejected — the buyer has been asked to resend"
+                    : "Balance open — awaiting the buyer";
+        return (_jsxs(Div, { children: [_jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: "Pre-order balance" }), _jsxs(Text, { className: "mt-1", color: "muted", size: "xs", children: [formatCurrency(balance.amount, currency), " \u2014 ", label, balance.transactionId ? ` · Ref ${balance.transactionId}` : ""] })] }));
+    }
+    const handleOpen = async () => {
+        setOpening(true);
+        setError(null);
+        try {
+            const res = await fetch(`${apiBase}/${orderId}/open-balance`, {
+                method: "POST",
+                credentials: "include",
+            });
+            if (!res.ok) {
+                setError("Could not open the balance. Try again, or contact support if it persists.");
+                return;
+            }
+            onOpened();
+        }
+        catch (err) {
+            void normalizeError(err);
+            setError("Could not reach the server. Check your connection and try again.");
+        }
+        finally {
+            setOpening(false);
+        }
+    };
+    return (_jsxs(Div, { children: [_jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: "Pre-order balance" }), _jsxs(Text, { className: "mt-1", color: "muted", size: "xs", children: [formatCurrency(balanceDue, currency), " is still owed on this order. Open it once the stock is physically with you \u2014 the buyer is notified and gets a week to pay, and the parcel ships when it clears."] }), _jsx(Row, { className: "mt-2", gap: "3", children: _jsx(Button, { variant: "primary", size: "sm", disabled: opening, onClick: handleOpen, children: opening ? "Opening…" : "Stock has arrived — open balance" }) }), error && (_jsx(Div, { textSize: "xs", className: "mt-2 border border-error/20", color: "error", surface: "danger-surface", padding: "inlineSm", rounded: "lg", children: error }))] }));
+}
 /**
  * Fetches + renders one order's full detail content (items, address,
  * payment, EMI, status/tracking update form). Shared by the seller orders
@@ -299,11 +371,31 @@ export function SellerOrderDetailPanel({ orderId, apiBase, onClose, }) {
     const addrLine = typeof rawAddr === "string" && rawAddr.trim()
         ? rawAddr.trim()
         : [addr.addressLine1, addr.city, addr.state, addr.pincode].filter(Boolean).join(", ");
-    return (_jsxs(_Fragment, { children: [loading && (_jsx(Row, { align: "center", justify: "center", padding: "y-4xl", children: _jsx(Div, { className: "h-6 w-6 animate-spin border-2 border-[var(--appkit-color-primary)] border-t-transparent", rounded: "full" }) })), fetchError && (_jsx(Div, { textSize: "sm", className: "mx-4 mt-4 border border-error/20", color: "error", surface: "danger-surface", padding: "inline", rounded: "lg", children: fetchError })), order && !loading && (_jsx(Stack, { gap: "none", children: _jsxs(Stack, { className: `flex-1 ${__O.yAuto}`, gap: "5", padding: "md", children: [_jsxs(Row, { align: "center", justify: "between", children: [_jsx(Badge, { variant: STATUS_BADGE_VARIANT[order.status ?? ""] ?? "default", children: order.status ?? "Unknown" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-muted)]", children: toRelativeDate(order.createdAt) })] }), _jsx(OrderProvenanceCard, { sourceContext: order.sourceContext, currency: order.currency }), (order.items ?? []).length > 0 && (_jsxs(Div, { children: [_jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text)] mb-2", weight: "semibold", children: "Items" }), _jsx(Div, { className: "divide-y divide-[var(--appkit-color-border)] divide-[var(--appkit-color-border)] border border-[var(--appkit-color-border)]", rounded: "lg", children: groupOrderItemsByLine(order.items ?? []).map((group, gi) => group.kind === "single" ? (sellerOrderItemRow(group.item, `s-${group.index}`)) : (_jsxs(Div, { children: [_jsxs(Row, { paddingY: "y-xs", padding: "x-sm", align: "center", gap: "sm", surface: "muted", children: [_jsx(Text, { size: "xs", weight: "semibold", children: group.groupTitle ?? "Grouped purchase" }), _jsx(Text, { size: "xs", className: "text-[var(--appkit-color-text-muted)]", children: `${group.memberCount} ${group.memberCount === 1 ? "item" : "items"} · one line` })] }), _jsx(Div, { className: "pl-4", children: group.items.map(({ item, index }) => sellerOrderItemRow(item, `m-${index}`)) })] }, `g-${gi}`))) })] })), _jsx(OrderAddonBadges, { order: order, variant: "detail" }), order.giftWrapAddon && (_jsxs(Div, { className: "border border-[var(--appkit-color-primary-200)] dark:border-[var(--appkit-color-primary-800)]", surface: "subtle", padding: "inline", rounded: "lg", children: [_jsx(Text, { size: "sm", weight: "semibold", children: "\uD83C\uDF81 Gift wrap requested" }), order.giftWrapMessage && (_jsxs(Text, { size: "sm", className: "mt-1 text-[var(--appkit-color-text-muted)]", children: ["\u201C", order.giftWrapMessage, "\u201D"] }))] })), _jsxs(Row, { surface: "muted", padding: "inline", align: "center", justify: "between", rounded: "lg", children: [_jsx(Text, { size: "sm", weight: "semibold", children: "Total" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-primary)]", weight: "bold", children: toCurrency(order.totalAmount ?? order.totalPrice ?? 0) })] }), addrLine && (_jsxs(Div, { children: [_jsx(Text, { size: "sm", className: "mb-1", weight: "semibold", children: "Shipping address" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-muted)]", children: [String(addr.fullName ?? ""), addrLine].filter(Boolean).join(" · ") })] })), order.paymentMethod && (_jsxs(Div, { children: [_jsxs(Row, { align: "center", justify: "between", className: "mb-1", gap: "3", children: [_jsx(Text, { size: "sm", weight: "semibold", children: "Payment" }), isManualPaymentMethod(order.paymentMethod) && (_jsx(Badge, { variant: sellerPaymentBadge(order).variant, children: sellerPaymentBadge(order).label }))] }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-muted)]", transform: "capitalize", children: order.paymentMethod }), isManualPaymentMethod(order.paymentMethod) && order.paymentTransactionId && (_jsxs(Text, { size: "xs", color: "muted", className: "mt-1", children: ["UTR: ", order.paymentTransactionId] }))] })), order.emiEnabled && (_jsxs(Div, { className: "border-t border-[var(--appkit-color-border)]", padding: "t-md", children: [_jsxs(Row, { align: "center", justify: "between", className: "mb-2", children: [_jsxs(Text, { size: "sm", weight: "semibold", children: ["EMI plan ", order.emiTenureMonths ? `· ${order.emiTenureMonths} months` : ""] }), _jsx(Badge, { variant: order.emiComplete ? "success" : "warning", children: order.emiComplete ? "Fully paid" : "In progress" })] }), _jsxs(Row, { align: "center", justify: "between", className: "mb-2", children: [_jsx(Text, { size: "xs", color: "muted", children: "Token collected" }), _jsx(Text, { size: "xs", weight: "medium", children: toCurrency(order.emiTokenAmount ?? 0) })] }), _jsxs(Row, { align: "center", justify: "between", className: "mb-3", children: [_jsx(Text, { size: "xs", color: "muted", children: "Remaining balance" }), _jsx(Text, { size: "xs", weight: "medium", children: toCurrency(order.emiRemainingBalance ?? 0) })] }), _jsx(Div, { className: "divide-y divide-[var(--appkit-color-border)] border border-[var(--appkit-color-border)]", rounded: "lg", children: (order.emiInstallments ?? []).map((inst) => (_jsxs(Row, { paddingY: "y-xs-tall", padding: "x-sm", align: "center", justify: "between", gap: "3", children: [_jsxs(Div, { className: "min-w-0", children: [_jsxs(Text, { size: "sm", weight: "medium", children: ["Installment ", inst.index, " \u00B7 ", toCurrency(inst.amount)] }), _jsx(Text, { size: "xs", color: "muted", children: inst.status === "paid" && inst.paidAt
+    return (_jsxs(_Fragment, { children: [loading && (_jsx(Row, { align: "center", justify: "center", padding: "y-4xl", children: _jsx(Div, { className: "h-6 w-6 animate-spin border-2 border-[var(--appkit-color-primary)] border-t-transparent", rounded: "full" }) })), fetchError && (_jsx(Div, { textSize: "sm", className: "mx-4 mt-4 border border-error/20", color: "error", surface: "danger-surface", padding: "inline", rounded: "lg", children: fetchError })), order && !loading && (_jsx(Stack, { gap: "none", children: _jsxs(Stack, { className: `flex-1 ${__O.yAuto}`, gap: "5", padding: "md", children: [_jsxs(Row, { align: "center", justify: "between", children: [_jsx(Badge, { variant: STATUS_BADGE_VARIANT[order.status ?? ""] ?? "default", children: order.status ?? "Unknown" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-muted)]", children: toRelativeDate(order.createdAt) })] }), _jsx(OrderProvenanceCard, { sourceContext: order.sourceContext, currency: order.currency }), (order.items ?? []).length > 0 && (_jsxs(Div, { children: [_jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text)] mb-2", weight: "semibold", children: "Items" }), _jsx(Div, { className: "divide-y divide-[var(--appkit-color-border)] divide-[var(--appkit-color-border)] border border-[var(--appkit-color-border)]", rounded: "lg", children: groupOrderItemsByLine(order.items ?? []).map((group, gi) => group.kind === "single" ? (sellerOrderItemRow(group.item, `s-${group.index}`)) : (_jsxs(Div, { children: [_jsxs(Row, { paddingY: "y-xs", padding: "x-sm", align: "center", gap: "sm", surface: "muted", children: [_jsx(Text, { size: "xs", weight: "semibold", children: group.groupTitle ?? "Grouped purchase" }), _jsx(Text, { size: "xs", className: "text-[var(--appkit-color-text-muted)]", children: `${group.memberCount} ${group.memberCount === 1 ? "item" : "items"} · one line` })] }), _jsx(Div, { paddingX: "l-md", children: group.items.map(({ item, index }) => sellerOrderItemRow(item, `m-${index}`)) })] }, `g-${gi}`))) })] })), _jsx(OrderAddonBadges, { order: order, variant: "detail" }), order.giftWrapAddon && (_jsxs(Div, { className: "border border-[var(--appkit-color-primary-200)] dark:border-[var(--appkit-color-primary-800)]", surface: "subtle", padding: "inline", rounded: "lg", children: [_jsx(Text, { size: "sm", weight: "semibold", children: "\uD83C\uDF81 Gift wrap requested" }), order.giftWrapMessage && (_jsxs(Text, { size: "sm", className: "mt-1 text-[var(--appkit-color-text-muted)]", children: ["\u201C", order.giftWrapMessage, "\u201D"] }))] })), _jsxs(Row, { surface: "muted", padding: "inline", align: "center", justify: "between", rounded: "lg", children: [_jsx(Text, { size: "sm", weight: "semibold", children: "Total" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-primary)]", weight: "bold", children: toCurrency(order.totalAmount ?? order.totalPrice ?? 0) })] }), addrLine && (_jsxs(Div, { children: [_jsx(Text, { size: "sm", className: "mb-1", weight: "semibold", children: "Shipping address" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-muted)]", children: [String(addr.fullName ?? ""), addrLine].filter(Boolean).join(" · ") })] })), order.paymentMethod && (_jsxs(Div, { children: [_jsxs(Row, { align: "center", justify: "between", className: "mb-1", gap: "3", children: [_jsx(Text, { size: "sm", weight: "semibold", children: "Payment" }), isManualPaymentMethod(order.paymentMethod) && (_jsx(Badge, { variant: sellerPaymentBadge(order).variant, children: sellerPaymentBadge(order).label }))] }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-muted)]", transform: "capitalize", children: order.paymentMethod }), isManualPaymentMethod(order.paymentMethod) && order.paymentTransactionId && (_jsxs(Text, { size: "xs", color: "muted", className: "mt-1", children: ["UTR: ", order.paymentTransactionId] }))] })), order.emiEnabled && (_jsxs(Div, { className: SECTION_DIVIDER, padding: "t-md", children: [_jsxs(Row, { align: "center", justify: "between", className: "mb-2", children: [_jsxs(Text, { size: "sm", weight: "semibold", children: ["EMI plan ", order.emiTenureMonths ? `· ${order.emiTenureMonths} months` : ""] }), _jsx(Badge, { variant: order.emiComplete ? "success" : "warning", children: order.emiComplete ? "Fully paid" : "In progress" })] }), _jsxs(Row, { align: "center", justify: "between", className: "mb-2", children: [_jsx(Text, { size: "xs", color: "muted", children: "Token collected" }), _jsx(Text, { size: "xs", weight: "medium", children: toCurrency(order.emiTokenAmount ?? 0) })] }), _jsxs(Row, { align: "center", justify: "between", className: "mb-3", children: [_jsx(Text, { size: "xs", color: "muted", children: "Remaining balance" }), _jsx(Text, { size: "xs", weight: "medium", children: toCurrency(order.emiRemainingBalance ?? 0) })] }), _jsx(Div, { className: "divide-y divide-[var(--appkit-color-border)] border border-[var(--appkit-color-border)]", rounded: "lg", children: (order.emiInstallments ?? []).map((inst) => (_jsxs(Row, { paddingY: "y-xs-tall", padding: "x-sm", align: "center", justify: "between", gap: "3", children: [_jsxs(Div, { className: "min-w-0", children: [_jsxs(Text, { size: "sm", weight: "medium", children: ["Installment ", inst.index, " \u00B7 ", toCurrency(inst.amount)] }), _jsx(Text, { size: "xs", color: "muted", children: inst.status === "paid" && inst.paidAt
                                                             ? `Paid ${toRelativeDate(inst.paidAt)}`
                                                             : inst.dueDate
                                                                 ? `Due ${toRelativeDate(inst.dueDate)}`
-                                                                : "" })] }), _jsxs(Row, { align: "center", gap: "sm", className: "shrink-0", children: [_jsx(Badge, { variant: EMI_INSTALLMENT_BADGE_VARIANT[inst.status] ?? "default", children: inst.status }), inst.status !== "paid" && (_jsx(Button, { action: ACTIONS.STORE["mark-installment-paid"], size: "sm", variant: "outline", isLoading: markingPaidIndex === inst.index, disabled: markingPaidIndex !== null, onClick: () => handleMarkInstallmentPaid(inst.index), children: "Mark paid" }))] })] }, inst.index))) }), emiError && (_jsx(Div, { textSize: "xs", className: "mt-2 border border-error/20", color: "error", surface: "danger-surface", padding: "inlineSm", rounded: "lg", children: emiError }))] })), _jsxs(Stack, { className: "border-t border-[var(--appkit-color-border)]", padding: "t-md", gap: "3", children: [_jsxs(FormShellContext.Provider, { value: form.shellCtx, children: [_jsx(FormErrorSummary, {}), _jsx(SectionForm, { sections: sections, values: draft, onChange: (partial) => setDraft((d) => ({ ...d, ...partial })), onSubmit: () => {
+                                                                : "" })] }), _jsxs(Row, { align: "center", gap: "sm", className: "shrink-0", children: [_jsx(Badge, { variant: EMI_INSTALLMENT_BADGE_VARIANT[inst.status] ?? "default", children: inst.status }), inst.status !== "paid" && (_jsx(Button, { action: ACTIONS.STORE["mark-installment-paid"], size: "sm", variant: "outline", isLoading: markingPaidIndex === inst.index, disabled: markingPaidIndex !== null, onClick: () => handleMarkInstallmentPaid(inst.index), children: "Mark paid" }))] })] }, inst.index))) }), emiError && (_jsx(Div, { textSize: "xs", className: "mt-2 border border-error/20", color: "error", surface: "danger-surface", padding: "inlineSm", rounded: "lg", children: emiError }))] })), order.sourceContext?.path === "pre-order" &&
+                            order.sourceContext.balanceDue > 0 && (_jsx(Stack, { className: SECTION_DIVIDER, padding: "t-md", gap: "3", children: _jsx(SellerBalanceBlock, { orderId: orderId, apiBase: apiBase, balance: order.balance, balanceDue: order.sourceContext.balanceDue, currency: order.currency, onOpened: () => {
+                                    showToast("Balance opened — the buyer has been notified", "success");
+                                    void fetch(`${apiBase}/${orderId}`)
+                                        .then((r) => r.json())
+                                        .then((json) => setOrder((json?.data ?? json)))
+                                        .catch((err) => void normalizeError(err));
+                                } }) })), _jsx(Stack, { className: SECTION_DIVIDER, padding: "t-md", gap: "3", children: _jsx(DispatchForm, { orderId: orderId, trackingNumber: order.trackingNumber, platformBooked: order.platformBookedShipment, onDispatched: () => {
+                                    showToast("Dispatch recorded", "success");
+                                    /*
+                                     * Re-read rather than patching local state: the platform
+                                     * branch's tracking id is produced by the CARRIER, so there
+                                     * is no value here to optimistically write. On that branch
+                                     * the job is still running, so this first re-read correctly
+                                     * shows no tracking number yet.
+                                     */
+                                    void fetch(`${apiBase}/${orderId}`)
+                                        .then((r) => r.json())
+                                        .then((json) => setOrder((json?.data ?? json)))
+                                        .catch((err) => void normalizeError(err));
+                                } }) }), _jsxs(Stack, { className: SECTION_DIVIDER, padding: "t-md", gap: "3", children: [_jsxs(FormShellContext.Provider, { value: form.shellCtx, children: [_jsx(FormErrorSummary, {}), _jsx(SectionForm, { sections: sections, values: draft, onChange: (partial) => setDraft((d) => ({ ...d, ...partial })), onSubmit: () => {
                                                 // SectionForm scrolls to the first erroring section and then
                                                 // submits regardless, so the guard lives here.
                                                 form.clearErrors();

package/dist/features/seller/components/index.d.ts

@@ -5,6 +5,7 @@ export { SellerListingTypeView, SELLER_LISTING_TYPE_SPECS } from "./SellerListin
 export type { SellerListingTypeViewProps, SellerListingTypeSpec, SellerListingTypeKey, SellerListingRow } from "./SellerListingTypeView";
 export type { SellerProductsViewProps } from "./SellerProductsView";
 export { PrintCenterView } from "./PrintCenterView";
+export { DispatchForm } from "./DispatchForm";
 export { SellerOrdersView, SellerOrderDetailPanel } from "./SellerOrdersView";
 export type { SellerOrdersViewProps } from "./SellerOrdersView";
 export { SellerOffersView } from "./SellerOffersView";

package/dist/features/seller/components/index.js

@@ -2,6 +2,7 @@ export { SellerDashboardView } from "./SellerDashboardView.js";
 export { SellerProductsView } from "./SellerProductsView.js";
 export { SellerListingTypeView, SELLER_LISTING_TYPE_SPECS } from "./SellerListingTypeView.js";
 export { PrintCenterView } from "./PrintCenterView.js";
+export { DispatchForm } from "./DispatchForm.js";
 export { SellerOrdersView, SellerOrderDetailPanel } from "./SellerOrdersView.js";
 export { SellerOffersView } from "./SellerOffersView.js";
 export { SellerCouponsView } from "./SellerCouponsView.js";

package/dist/features/seller/repository/offer.repository.js

@@ -247,9 +247,10 @@ class OfferRepository extends BaseRepository {
             trigger: ctx?.trigger ?? "offerRepository.updateStatus",
             reason: ctx?.reason,
             note: ctx?.note,
-            // buyerName/buyerEmail live on this document. `encryptPiiFields` is a
-            // flat top-level loop and never descends into arrays, so without this
-            // they would persist in PLAINTEXT inside statusHistory.
+            // buyerName/buyerEmail live on this document. `encryptPiiFields` covers
+            // only NAMED paths, and nothing declares them under
+            // `statusHistory[].changes` — so without this scrub they persist in
+            // PLAINTEXT inside the history.
             piiFields: OFFER_PII_FIELDS,
             historyField: OFFER_FIELDS.STATUS_HISTORY,
             truncatedField: OFFER_FIELDS.STATUS_HISTORY_TRUNCATED,

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

@@ -5,6 +5,7 @@ import { type GenerateOfferIdInput } from "../../../utils/id-generators";
 import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 import type { StatusChangeEntry } from "../../../_internal/shared/history/index";
 import type { Encrypted, Plaintext } from "../../../security/encrypted";
+import type { OfferCoordination } from "../../../_internal/shared/features/offers/coordination";
 export type OfferStatus = "pending" | "accepted" | "declined" | "countered" | "expired" | "withdrawn" | "paid";
 /** Runtime-accessible offer status values — use instead of bare string literals. */
 export declare const OfferStatusValues: {
@@ -50,6 +51,25 @@ export interface OfferDocument extends BaseDocument {
     acceptedAt?: Date;
     checkoutDeadline?: Date;
     respondedAt?: Date;
+    /**
+     * Present when this offer is a COORDINATED purchase — several people
+     * chipping in on one listing.
+     *
+     * 🛑 A field on the offer, not a new document and not a new lifecycle.
+     * Acceptance produces an ordinary `offer-accepted` order; `unitPriceFor`
+     * already honours `lockedPrice`, so tax, payout base, refund ceiling and
+     * the invoice all follow with no new money term. See
+     * `_internal/shared/features/offers/coordination.ts` for the full list of
+     * things this deliberately does NOT add.
+     *
+     * 🛑 No member NAME is stored in here. `encryptPiiFields` CAN reach into an
+     * array (`coordination.members[].name`) — the claim that it cannot was
+     * wrong — but it covers only what is NAMED, and the near-miss `"name"`
+     * reads as covering it while storing plaintext. Members are uids; names
+     * resolve at render time, which removes the field rather than classifying
+     * it. See `coordination.ts`.
+     */
+    coordination?: OfferCoordination;
     /** Set by `markPaid` once the buyer's order exists — makes "paid" auditable. */
     paidOrderId?: string;
     paidAt?: Date;
@@ -93,8 +113,9 @@ export interface OfferDocument extends BaseDocument {
 /**
  * Fields whose changes are recorded in an offer's `statusHistory`.
  *
- * Excludes `buyerName`/`buyerEmail` (PII — `encryptPiiFields` never descends
- * into arrays, so they would persist in plaintext inside the history),
+ * Excludes `buyerName`/`buyerEmail` (PII — nothing declares them under
+ * `statusHistory[].changes`, and `encryptPiiFields` covers only NAMED paths,
+ * so they would persist in plaintext inside the history),
  * `buyerNote`/`sellerNote` (they ride in the entry's `note`), and
  * `updatedAt`/`respondedAt` (noise that would burn the FIFO cap).
  */

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

@@ -15,8 +15,9 @@ export const OfferStatusValues = {
 /**
  * Fields whose changes are recorded in an offer's `statusHistory`.
  *
- * Excludes `buyerName`/`buyerEmail` (PII — `encryptPiiFields` never descends
- * into arrays, so they would persist in plaintext inside the history),
+ * Excludes `buyerName`/`buyerEmail` (PII — nothing declares them under
+ * `statusHistory[].changes`, and `encryptPiiFields` covers only NAMED paths,
+ * so they would persist in plaintext inside the history),
  * `buyerNote`/`sellerNote` (they ride in the entry's `note`), and
  * `updatedAt`/`respondedAt` (noise that would burn the FIFO cap).
  */

package/dist/features/seller/schemas/index.d.ts

@@ -72,13 +72,13 @@ export declare const sellerStoreSchema: z.ZodObject<{
         totalReviews: z.ZodNumber;
         averageRating: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        itemsSold: number;
         totalProducts: number;
+        itemsSold: number;
         totalReviews: number;
         averageRating?: number | undefined;
     }, {
-        itemsSold: number;
         totalProducts: number;
+        itemsSold: number;
         totalReviews: number;
         averageRating?: number | undefined;
     }>>;
@@ -96,8 +96,8 @@ export declare const sellerStoreSchema: z.ZodObject<{
     location?: string | undefined;
     returnPolicy?: string | undefined;
     stats?: {
-        itemsSold: number;
         totalProducts: number;
+        itemsSold: number;
         totalReviews: number;
         averageRating?: number | undefined;
     } | undefined;
@@ -128,8 +128,8 @@ export declare const sellerStoreSchema: z.ZodObject<{
     location?: string | undefined;
     returnPolicy?: string | undefined;
     stats?: {
-        itemsSold: number;
         totalProducts: number;
+        itemsSold: number;
         totalReviews: number;
         averageRating?: number | undefined;
     } | undefined;