@mohasinac/appkit 4.63.5 → 4.64.1

package/dist/_internal/shared/features/seller-standing/config.js

@@ -0,0 +1,153 @@
+/**
+ * Seller standing — the ONE definition of what earns the Trusted Seller tier.
+ *
+ * ## Why this is a single pure module
+ *
+ * Four surfaces must agree about the criteria: the monthly rollup job that
+ * grants and revokes, the seller's in-dashboard progress panel, the public
+ * `/seller-guide` criteria table, and the admin trust guide. Four hand-written
+ * copies of "25 delivered orders in 90 days" is Root Cause #73/#75's shape —
+ * the copy that gets fixed is never the copy the reader believes. So the
+ * thresholds, the predicate AND the display rows all come from here.
+ *
+ * 🛑 It had a fifth copy before this existed, and it was prose:
+ * `AdminStoresGuideView` told admins the verified badge was "awarded when the
+ * store has a consistent track record (>=20 delivered orders, >=4.0 rating, 3+
+ * months active)" — numbers no code has ever read, attached to a field nothing
+ * computes. That sentence is what the whole feature was remembered as being.
+ *
+ * ## Pure, and that is load-bearing
+ *
+ * No Firestore, no clock, no `Date.now()`. The job passes in metrics it has
+ * already measured and the UI passes in metrics it has already loaded, so the
+ * same input always produces the same verdict and the panel can never disagree
+ * with the grant.
+ */
+// ---------------------------------------------------------------------------
+// Criteria
+// ---------------------------------------------------------------------------
+/**
+ * 🛑 A `Record<Criterion, true>`, not a string array.
+ *
+ * Adding a criterion then becomes a COMPILE error at every site that must
+ * display or evaluate it — the thresholds, the labels, the verdict's `met`
+ * map. An array lets a new criterion be evaluated while silently rendering
+ * nowhere, which is how ten hand-maintained enumerations of one union drifted
+ * in Root Cause #61.
+ */
+const SELLER_STANDING_CRITERION_MAP = {
+    deliveredOrders: true,
+    distinctBuyers: true,
+    distinctAddresses: true,
+    ratedOrders: true,
+    averageRating: true,
+};
+export const SELLER_STANDING_CRITERIA = Object.keys(SELLER_STANDING_CRITERION_MAP);
+export const SELLER_TIER = {
+    SELLER: "seller",
+    TRUSTED: "trusted",
+};
+/**
+ * The shipped defaults.
+ *
+ * 🛑 Every count is measured INSIDE `windowDays`, not lifetime. That is the
+ * strict reading and it was chosen deliberately: the tier grants early payout,
+ * so it has to describe a seller who is shipping reliably *now*, not one who
+ * did two years ago. The consequence worth knowing up front is that on a
+ * freshly seeded catalogue **nobody qualifies**, and that is the correct
+ * result rather than a broken job.
+ *
+ * Admin-overridable via `siteSettings.sellerStanding` so the bar can be tuned
+ * once real volume exists, without a deploy.
+ */
+export const SELLER_STANDING_DEFAULTS = {
+    windowDays: 90,
+    minDeliveredOrders: 25,
+    minDistinctBuyers: 25,
+    minDistinctAddresses: 25,
+    minRatedOrders: 25,
+    minAverageRating: 4,
+};
+/**
+ * Does this seller currently meet the bar?
+ *
+ * 🛑 ALL criteria must hold. There is no scoring and no partial credit: the
+ * reward is being paid before delivery, so "mostly reliable" is not a state
+ * this can grant on.
+ */
+export function evaluateSellerStanding(metrics, thresholds = SELLER_STANDING_DEFAULTS) {
+    const met = {
+        deliveredOrders: metrics.deliveredOrders >= thresholds.minDeliveredOrders,
+        distinctBuyers: metrics.distinctBuyers >= thresholds.minDistinctBuyers,
+        distinctAddresses: metrics.distinctAddresses >= thresholds.minDistinctAddresses,
+        ratedOrders: metrics.ratedOrders >= thresholds.minRatedOrders,
+        averageRating: metrics.averageRating >= thresholds.minAverageRating,
+    };
+    const unmetCount = SELLER_STANDING_CRITERIA.filter((c) => !met[c]).length;
+    return {
+        tier: unmetCount === 0 ? SELLER_TIER.TRUSTED : SELLER_TIER.SELLER,
+        met,
+        unmetCount,
+    };
+}
+// ---------------------------------------------------------------------------
+// Display — so the panel, the public guide and the admin guide agree
+// ---------------------------------------------------------------------------
+export const SELLER_STANDING_CRITERION_LABELS = {
+    deliveredOrders: "Delivered orders",
+    distinctBuyers: "Different buyers",
+    distinctAddresses: "Different delivery addresses",
+    ratedOrders: "Rated orders",
+    averageRating: "Average rating",
+};
+/**
+ * Why each criterion exists, in the seller's words. Rendered on the guide
+ * pages — a bar with no stated reason reads as arbitrary, and two of these
+ * exist specifically to make the tier hard to manufacture.
+ */
+export const SELLER_STANDING_CRITERION_WHY = {
+    deliveredOrders: "Enough completed sales to show a pattern, not a one-off.",
+    distinctBuyers: "Sales to real, different customers.",
+    distinctAddresses: "Orders going to different places, not the same one repeatedly.",
+    ratedOrders: "Enough ratings for the average below to mean something.",
+    averageRating: "Buyers are consistently happy with what arrives.",
+};
+function targetFor(criterion, t) {
+    switch (criterion) {
+        case "deliveredOrders":
+            return t.minDeliveredOrders;
+        case "distinctBuyers":
+            return t.minDistinctBuyers;
+        case "distinctAddresses":
+            return t.minDistinctAddresses;
+        case "ratedOrders":
+            return t.minRatedOrders;
+        case "averageRating":
+            return t.minAverageRating;
+    }
+}
+/**
+ * One row per criterion, for rendering.
+ *
+ * `metrics` may be null — a store whose standing has never been computed shows
+ * every target with no figure beside it, which is honest. 🛑 It must NOT show
+ * zeros: a confident "0 of 25" on a store that simply has not been measured
+ * yet is the same lie as a counter that has never been written reading as 0
+ * (Root Cause #72).
+ */
+export function sellerStandingRows(metrics, thresholds = SELLER_STANDING_DEFAULTS) {
+    const verdict = metrics ? evaluateSellerStanding(metrics, thresholds) : null;
+    return SELLER_STANDING_CRITERIA.map((criterion) => ({
+        criterion,
+        label: SELLER_STANDING_CRITERION_LABELS[criterion],
+        why: SELLER_STANDING_CRITERION_WHY[criterion],
+        kind: criterion === "averageRating" ? "rating" : "count",
+        actual: metrics ? metrics[criterion] : null,
+        target: targetFor(criterion, thresholds),
+        met: verdict ? verdict.met[criterion] : false,
+    }));
+}
+/** `4` → `"4.0"`, `25` → `"25"`. Keeps rating and count formatting in one place. */
+export function formatSellerStandingValue(value, kind) {
+    return kind === "rating" ? value.toFixed(1) : String(value);
+}

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

@@ -438,6 +438,14 @@ export declare const EVENT_ENDPOINTS: {
     readonly ENTRIES: (id: string) => string;
     readonly LEADERBOARD: (id: string, limit?: number) => string;
     readonly SPIN: (id: string) => string;
+    /**
+     * Likes. POST toggles the viewer's; GET pages the "liked by" list.
+     *
+     * `id` may be a slug — public event URLs link by slug — and the route
+     * resolves it to the canonical document id before keying anything.
+     */
+    readonly LIKES: (id: string) => string;
+    readonly LIKERS: (id: string, offset: number) => string;
     readonly LOTTERY_PULL: (id: string) => string;
     readonly LOTTERY_ENTRIES: (id: string) => string;
 };
@@ -1011,6 +1019,14 @@ export declare const API_ENDPOINTS: {
         readonly ENTRIES: (id: string) => string;
         readonly LEADERBOARD: (id: string, limit?: number) => string;
         readonly SPIN: (id: string) => string;
+        /**
+         * Likes. POST toggles the viewer's; GET pages the "liked by" list.
+         *
+         * `id` may be a slug — public event URLs link by slug — and the route
+         * resolves it to the canonical document id before keying anything.
+         */
+        readonly LIKES: (id: string) => string;
+        readonly LIKERS: (id: string, offset: number) => string;
         readonly LOTTERY_PULL: (id: string) => string;
         readonly LOTTERY_ENTRIES: (id: string) => string;
     };
@@ -1602,6 +1618,14 @@ export declare const API_ROUTES: {
         readonly ENTRIES: (id: string) => string;
         readonly LEADERBOARD: (id: string, limit?: number) => string;
         readonly SPIN: (id: string) => string;
+        /**
+         * Likes. POST toggles the viewer's; GET pages the "liked by" list.
+         *
+         * `id` may be a slug — public event URLs link by slug — and the route
+         * resolves it to the canonical document id before keying anything.
+         */
+        readonly LIKES: (id: string) => string;
+        readonly LIKERS: (id: string, offset: number) => string;
         readonly LOTTERY_PULL: (id: string) => string;
         readonly LOTTERY_ENTRIES: (id: string) => string;
     };

package/dist/constants/api-endpoints.js

@@ -541,6 +541,14 @@ export const EVENT_ENDPOINTS = {
     LEADERBOARD: (id, limit) => `/api/events/${id}/leaderboard${limit !== undefined ? `?limit=${limit}` : ""}`,
     // SB9-E user spin assignment
     SPIN: (id) => `/api/events/${id}/spin`,
+    /**
+     * Likes. POST toggles the viewer's; GET pages the "liked by" list.
+     *
+     * `id` may be a slug — public event URLs link by slug — and the route
+     * resolves it to the canonical document id before keying anything.
+     */
+    LIKES: (id) => `/api/events/${id}/likes`,
+    LIKERS: (id, offset) => `/api/events/${id}/likes?offset=${offset}`,
     // Lottery: user self-pull (draw happens immediately on submit)
     LOTTERY_PULL: (id) => `/api/events/${id}/lottery-pull`,
     LOTTERY_ENTRIES: (id) => `/api/events/${id}/lottery-entries`,

package/dist/features/about/components/HelpPageView.js

@@ -5,7 +5,7 @@ import { ProseHero } from "./ProseHero.js";
 import { FLEX_ROW } from "../../../_internal/shared/styles/themed.js";
 import { Alert, Div, Heading, Row, Section, Stack, Text } from "../../../ui/index.js";
 import { TextLink } from "../../../ui/index.js";
-import { BookOpen, MessageCircle, ShoppingBag, Gavel, PackageCheck, UserCheck, Store, ChevronRight, } from "lucide-react";
+import { BookOpen, MessageCircle, ShoppingBag, Gavel, PackageCheck, UserCheck, Store, ShieldCheck, ChevronRight, } from "lucide-react";
 const __P = {
     p6: "p-[var(--appkit-space-6)]",
     p8: "p-[var(--appkit-space-8)]",
@@ -48,6 +48,14 @@ export async function HelpPageView({} = {}) {
             color: "bg-violet-50 border-violet-200 dark:bg-violet-900/20 dark:border-violet-700",
             iconColor: "text-violet-600 dark:text-violet-400",
         },
+        {
+            icon: ShieldCheck,
+            title: t("topicSellerBadges"),
+            desc: t("topicSellerBadgesDesc"),
+            href: String(ROUTES.PUBLIC.HELP_SELLER_BADGES),
+            color: "bg-teal-50 border-teal-200 dark:bg-teal-900/20 dark:border-teal-700",
+            iconColor: "text-teal-600 dark:text-teal-400",
+        },
         {
             icon: BookOpen,
             title: t("topicFAQs"),

package/dist/features/account/components/BecomeSellerView.d.ts

@@ -4,13 +4,25 @@ export interface BecomeSellerViewLabels {
     applyButton?: string;
     alreadySeller?: string;
 }
+/**
+ * 🛑 `create-store` is a real state, not a variant of `already-seller`.
+ *
+ * Applying and owning a storefront are two different things, and the gap
+ * between them was invisible: a user who applied became `role: "seller"` with
+ * no store, and this shell's `already-seller` slot told them to "head over to
+ * your Store Dashboard" — a dashboard with no store behind it. There was no
+ * step anywhere in the product that created one. This state is that step.
+ */
+export type BecomeSellerState = "guide" | "success" | "create-store" | "already-seller";
 export interface BecomeSellerViewProps {
     labels?: BecomeSellerViewLabels;
     renderGuide?: () => React.ReactNode;
     renderSuccess?: () => React.ReactNode;
+    /** Seller with no store yet — renders the store-creation form. */
+    renderCreateStore?: () => React.ReactNode;
     renderAlreadySeller?: () => React.ReactNode;
-    /** Which state to render. Shell exposes all three slots; consumer controls which is active. */
-    state?: "guide" | "success" | "already-seller";
+    /** Which state to render. Shell exposes all four slots; consumer controls which is active. */
+    state?: BecomeSellerState;
     className?: string;
 }
-export declare function BecomeSellerView({ labels, renderGuide, renderSuccess, renderAlreadySeller, state, className, }: BecomeSellerViewProps): React.JSX.Element;
+export declare function BecomeSellerView({ labels, renderGuide, renderSuccess, renderCreateStore, renderAlreadySeller, state, className, }: BecomeSellerViewProps): React.JSX.Element;

package/dist/features/account/components/BecomeSellerView.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Div, Heading } from "../../../ui/index.js";
-export function BecomeSellerView({ labels = {}, renderGuide, renderSuccess, renderAlreadySeller, state = "guide", className = "", }) {
-    return (_jsxs(Div, { className: className, children: [labels.title && state === "guide" && (_jsx(Heading, { level: 1, className: "mb-6", size: "2xl", weight: "bold", children: labels.title })), state === "guide" && renderGuide?.(), state === "success" && renderSuccess?.(), state === "already-seller" && renderAlreadySeller?.()] }));
+export function BecomeSellerView({ labels = {}, renderGuide, renderSuccess, renderCreateStore, renderAlreadySeller, state = "guide", className = "", }) {
+    return (_jsxs(Div, { className: className, children: [labels.title && state === "guide" && (_jsx(Heading, { level: 1, className: "mb-6", size: "2xl", weight: "bold", children: labels.title })), state === "guide" && renderGuide?.(), state === "success" && renderSuccess?.(), state === "create-store" && renderCreateStore?.(), state === "already-seller" && renderAlreadySeller?.()] }));
 }

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

@@ -7,6 +7,17 @@ export interface AdminStoreEditorViewProps {
     currentStatus?: string;
     currentIsVerified?: boolean;
     currentIsFeatured?: boolean;
+    /**
+     * 🛑 Both REQUIRED for the controls to show the stored value, and both are
+     * the Root Cause #38 trap: `AdminStoresView` seeds this editor from a LIST
+     * row, so a field the list serializer omits arrives `undefined`, the control
+     * defaults to off, and the save handler sends that wrong default back —
+     * silently un-trusting a trusted store while the admin was editing
+     * something else. The list route emits `trustedSeller` already; `sellerTier`
+     * had to be added to it in the same change.
+     */
+    currentSellerTier?: "seller" | "trusted";
+    currentTrustedSeller?: boolean;
     currentCapabilities?: string[];
     /**
      * 🛑 Required for the note to DISPLAY. Without it `adminNotes` was hardcoded
@@ -19,4 +30,4 @@ export interface AdminStoreEditorViewProps {
      */
     currentAdminNotes?: string;
 }
-export declare function AdminStoreEditorView({ open, onClose, storeId, storeName, currentStatus, currentIsVerified, currentIsFeatured, currentCapabilities, currentAdminNotes, }: AdminStoreEditorViewProps): React.JSX.Element;
+export declare function AdminStoreEditorView({ open, onClose, storeId, storeName, currentStatus, currentIsVerified, currentIsFeatured, currentSellerTier, currentTrustedSeller, currentCapabilities, currentAdminNotes, }: AdminStoreEditorViewProps): React.JSX.Element;

package/dist/features/admin/components/AdminStoreEditorView.js

@@ -111,13 +111,15 @@ function CapabilityPicker({ selected, onToggle, }) {
     return (_jsxs(Stack, { gap: "sm", children: [_jsxs(Span, { size: "sm", weight: "medium", color: "muted", children: ["Capabilities", _jsxs(Span, { size: "xs", weight: "normal", className: "ml-2", color: "muted", children: ["(", selected.size, " active)"] })] }), _jsx(Div, { className: "divide-y divide-[var(--appkit-color-border)]", rounded: "xl", border: "default", children: CAPABILITY_GROUPS.map((group) => (_jsxs(Details, { className: "group", children: [_jsxs(Summary, { paddingX: "x-sm", paddingY: "y-xs", weight: "semibold", color: "muted", layout: "flex", align: "center", justify: "between", className: "uppercase tracking-wide hover:bg-[var(--appkit-color-bg)] transition-colors", children: [_jsx(Span, { size: "xs", children: group.label }), _jsxs(Span, { size: "xs", weight: "normal", className: "normal-case", color: "faint", children: [group.caps.filter((c) => selected.has(c.key)).length, "/", group.caps.length] })] }), _jsx(Div, { layout: "grid", paddingY: "y-xs-tall", className: "grid-cols-2 gap-x-2 gap-y-1.5", surface: "muted", padding: "x-sm", children: group.caps.map((cap) => (_jsx(Checkbox, { label: cap.label, checked: selected.has(cap.key), onChange: () => onToggle(cap.key), wrapperClassName: "flex items-center gap-[var(--appkit-space-2)] cursor-pointer text-[length:var(--appkit-text-xs)] text-[var(--appkit-color-text-muted)]" }, cap.key))) })] }, group.label))) })] }));
 }
 // --- Component ---------------------------------------------------------------
-export function AdminStoreEditorView({ open, onClose, storeId, storeName, currentStatus, currentIsVerified, currentIsFeatured, currentCapabilities, currentAdminNotes, }) {
+export function AdminStoreEditorView({ open, onClose, storeId, storeName, currentStatus, currentIsVerified, currentIsFeatured, currentSellerTier, currentTrustedSeller, currentCapabilities, currentAdminNotes, }) {
     const queryClient = useQueryClient();
     const { showToast } = useToast();
     const [values, setValues] = React.useState(() => ({
         storeStatus: currentStatus ?? "pending",
         isVerified: currentIsVerified ?? false,
         isFeatured: currentIsFeatured ?? false,
+        sellerTier: currentSellerTier ?? "seller",
+        trustedSeller: currentTrustedSeller ?? false,
         suspensionReason: "",
         capabilities: currentCapabilities ?? DEFAULT_CAPABILITIES,
         adminNotes: currentAdminNotes ?? "",
@@ -132,11 +134,22 @@ export function AdminStoreEditorView({ open, onClose, storeId, storeName, curren
             storeStatus: currentStatus ?? "pending",
             isVerified: currentIsVerified ?? false,
             isFeatured: currentIsFeatured ?? false,
+            sellerTier: currentSellerTier ?? "seller",
+            trustedSeller: currentTrustedSeller ?? false,
             suspensionReason: "",
             capabilities: currentCapabilities ?? DEFAULT_CAPABILITIES,
             adminNotes: currentAdminNotes ?? "",
         });
-    }, [open, currentStatus, currentIsVerified, currentIsFeatured, currentCapabilities, currentAdminNotes]);
+    }, [
+        open,
+        currentStatus,
+        currentIsVerified,
+        currentIsFeatured,
+        currentSellerTier,
+        currentTrustedSeller,
+        currentCapabilities,
+        currentAdminNotes,
+    ]);
     const saveMutation = useApiMutation({
         errorMessage: "Failed to update store.",
         mutationFn: async () => {
@@ -158,6 +171,21 @@ export function AdminStoreEditorView({ open, onClose, storeId, storeName, curren
                 adminNotes: parsed.adminNotes ?? "",
                 isFeatured: parsed.isFeatured,
                 isVerified: parsed.isVerified,
+                /*
+                 * 🛑 `sellerTier` is sent ONLY when the admin actually moved it away
+                 * from the stored value, because the route treats any `sellerTier` in
+                 * the body as a deliberate override and PINS it against the monthly
+                 * recompute. Sending it unconditionally would lock every store an
+                 * admin ever opened and saved — quietly freezing the automatic tier
+                 * for the whole catalogue, one unrelated edit at a time.
+                 *
+                 * `trustedSeller` has no such side effect and is sent every time, so
+                 * it can also be cleared.
+                 */
+                ...(parsed.sellerTier !== undefined && parsed.sellerTier !== (currentSellerTier ?? "seller")
+                    ? { sellerTier: parsed.sellerTier }
+                    : {}),
+                trustedSeller: parsed.trustedSeller ?? false,
                 suspensionReason: parsed.suspensionReason || undefined,
                 capabilities: parsed.capabilities ?? [],
             });

package/dist/features/admin/components/AdminStoresGuideView.js

@@ -6,7 +6,7 @@ export function AdminStoresGuideView() {
     return (_jsxs(Stack, { className: "max-w-3xl mx-auto", padding: "b-2xl", gap: "xl", children: [_jsxs(Section, { children: [_jsxs(Row, { className: "mb-2", align: "center", gap: "3", children: [_jsx(Row, { className: "flex-shrink-0 w-10 h-10 [background:linear-gradient(135deg,var(--appkit-color-primary-700)_0%,var(--appkit-color-cobalt)_100%)]", align: "center", justify: "center", rounded: "xl", children: _jsx(Store, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Admin Guide" })] }), _jsx(Heading, { level: 1, className: "text-[var(--appkit-color-text)] mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: "Stores & Sellers" }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", children: "Store lifecycle, identity architecture, capabilities, and suspension on LetItRip." })] }), [
                 {
                     Icon: Store, title: "Store Lifecycle",
-                    content: (_jsxs(Ul, { className: GC.listMuted, children: [_jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Creation" }), ": Seller registers \u2192 completes onboarding wizard \u2192 admin reviews \u2192 store goes ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "active" }), "."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Status values" }), ": ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "active" }), " (visible and selling), ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "suspended" }), " (hidden, not selling), ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "pending_review" }), " (awaiting admin approval)."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "isVerified badge" }), ": Awarded when the store has a consistent track record (\u226520 delivered orders, \u22654.0 rating, 3+ months active). Click the toggle in AdminStoreEditorView after reviewing the store's history."] })] })),
+                    content: (_jsxs(Ul, { className: GC.listMuted, children: [_jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Creation" }), ": Seller registers \u2192 completes onboarding wizard \u2192 admin reviews \u2192 store goes ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "active" }), "."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Status values" }), ": ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "pending" }), " (awaiting approval, not public), ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "active" }), " (visible and selling), ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "suspended" }), " (hidden, not selling), ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "rejected" }), " (application refused). Only ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "active" }), " sets ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "isPublic" }), ", and leaving it clears any earned tier immediately."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "isVerified badge" }), ": An IDENTITY check, not a performance one \u2014 grant it after reviewing the seller's submitted ID. There is no order-count or rating threshold, and it does not expire. Toggle it in AdminStoreEditorView."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "sellerTier" }), ": The EARNED tier, computed by ", _jsx(Code, { size: "xs", children: "sellerStandingRollup" }), " on the last day of each month. Setting it by hand pins it (", _jsx(Code, { size: "xs", children: "tierLockedByAdmin" }), ") so the job stops moving it \u2014 and it carries early payout with it. See the Trust guide."] })] })),
                 },
                 {
                     Icon: GitBranch, title: "Store Identity Architecture",

package/dist/features/admin/components/AdminStoresView.js

@@ -37,6 +37,34 @@ export function AdminStoresView({ children, ...props }) {
             void queryClient.invalidateQueries({ queryKey: ["admin", "stores", "listing"] });
         },
     });
+    /*
+     * 🛑 Approve/reject — the step that had no affordance anywhere.
+     *
+     * A store is born `pending` + `isPublic: false`, and this view offered only
+     * verify and suspend, so a real applicant's store could never be published.
+     * Both mutations go through the same STORE PATCH the rest of this view uses,
+     * which dispatches to `storeRepository.setStatus` and is therefore the only
+     * path that keeps `status` and `isPublic` in step. Do not reach for
+     * `adminUpdateStoreStatus`: it writes the user-level `storeStatus` mirror
+     * and never touches the store, so it would report success and publish
+     * nothing.
+     */
+    const approveStore = useApiMutation({
+        errorMessage: "Failed to approve store.",
+        mutationFn: (storeId) => apiClient.patch(ADMIN_ENDPOINTS.STORE_BY_ID(storeId), { storeStatus: "active" }),
+        onSuccess: () => {
+            toast.showToast("Store approved — it is now public.", "success");
+            void queryClient.invalidateQueries({ queryKey: ["admin", "stores", "listing"] });
+        },
+    });
+    const rejectStore = useApiMutation({
+        errorMessage: "Failed to reject store.",
+        mutationFn: (storeId) => apiClient.patch(ADMIN_ENDPOINTS.STORE_BY_ID(storeId), { storeStatus: "rejected" }),
+        onSuccess: () => {
+            toast.showToast("Store application rejected.", "success");
+            void queryClient.invalidateQueries({ queryKey: ["admin", "stores", "listing"] });
+        },
+    });
     if (React.Children.count(children) > 0) {
         return (_jsx(ListingLayout, { portal: "admin", ...props, children: children }));
     }
@@ -108,7 +136,10 @@ export function AdminStoresView({ children, ...props }) {
             },
         })),
         renderRowActions: (row) => {
-            const isSuspended = row.status?.toLowerCase() === "suspended";
+            const status = row.status?.toLowerCase();
+            const isSuspended = status === "suspended";
+            const isPending = status === "pending";
+            const isActive = status === "active";
             const isVerified = Boolean(row._raw?.isVerified);
             return (_jsx(RowActionMenu, { actions: [
                     {
@@ -119,6 +150,24 @@ export function AdminStoresView({ children, ...props }) {
                         label: "Open full page",
                         onClick: () => router.push(String(ROUTES.ADMIN.STORE_DETAIL(row.id))),
                     },
+                    /*
+                     * Approve is offered for anything not already active — that
+                     * deliberately includes `rejected` and `suspended`, which is how a
+                     * decision gets reversed without hunting for a second control.
+                     * Reject is offered only while `pending`: rejecting a store that
+                     * has been live and has orders is a suspension, not a rejection,
+                     * and conflating them would lose that distinction in the audit log.
+                     */
+                    {
+                        label: ACTIONS.ADMIN["approve-store"].label,
+                        onClick: () => approveStore.mutate(row.id),
+                        disabled: isActive || approveStore.isPending,
+                    },
+                    {
+                        label: ACTIONS.ADMIN["reject-store"].label,
+                        onClick: () => rejectStore.mutate(row.id),
+                        disabled: !isPending || rejectStore.isPending,
+                    },
                     {
                         label: ACTIONS.ADMIN["verify-store"].label,
                         onClick: () => verifyStore.mutate(row.id),
@@ -133,7 +182,15 @@ export function AdminStoresView({ children, ...props }) {
         },
         renderFilterPanel: ({ pendingFilters, setPendingFilters }) => (_jsx(FilterChipGroup, { label: "Status", tabs: ADMIN_STORE_STATUS_TABS, value: pendingFilters.status ?? "", onChange: (id) => setPendingFilters((p) => ({ ...p, status: id })) })),
     };
-    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), _jsx(AdminStoreEditorView, { open: Boolean(editorRow), onClose: () => setEditorRow(null), storeId: editorRow?.id, storeName: editorRow?.primary, currentStatus: editorRow?.status?.toLowerCase(), currentIsVerified: Boolean(editorRow?._raw?.isVerified), currentIsFeatured: Boolean(editorRow?._raw?.isFeatured), currentCapabilities: Array.isArray(editorRow?._raw?.capabilities)
+    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), _jsx(AdminStoreEditorView, { open: Boolean(editorRow), onClose: () => setEditorRow(null), storeId: editorRow?.id, storeName: editorRow?.primary, currentStatus: editorRow?.status?.toLowerCase(), currentIsVerified: Boolean(editorRow?._raw?.isVerified), currentIsFeatured: Boolean(editorRow?._raw?.isFeatured), 
+                /*
+                 * Both now travel from the list route's serializer through to the
+                 * editor. `trustedSeller` was ALREADY emitted by the route and simply
+                 * never passed down — the API accepted the field, nothing could send
+                 * it, and the control did not exist. Root Cause #38's shape at the
+                 * prop, which is where it hides best.
+                 */
+                currentSellerTier: editorRow?._raw?.sellerTier === "trusted" ? "trusted" : "seller", currentTrustedSeller: Boolean(editorRow?._raw?.trustedSeller), currentCapabilities: Array.isArray(editorRow?._raw?.capabilities)
                     ? editorRow._raw.capabilities
                     : undefined, 
                 /*

package/dist/features/admin/components/AdminTrustGuideView.js

@@ -3,8 +3,18 @@ import { Shield, Ban, AlertTriangle, Headphones, Flag, ClipboardList } from "luc
 import { Alert, Code, Div, Heading, Li, Row, Section, Span, Stack, Table, Tbody, Td, Text, Th, Thead, Tr, Ul } from "../../../ui/index.js";
 import { GC } from "../../_guide-cls.js";
 const STILL_ALLOWED = "✓ Still allowed";
+/** Named because it is used on three rows in the seller-trust table. */
+const ROW_BORDER = "border-b border-[var(--appkit-color-border)]";
 export function AdminTrustGuideView() {
     return (_jsxs(Stack, { className: "max-w-3xl mx-auto", padding: "b-2xl", gap: "xl", children: [_jsxs(Section, { children: [_jsxs(Row, { className: "mb-2", align: "center", gap: "3", children: [_jsx(Row, { className: "flex-shrink-0 w-10 h-10 [background:linear-gradient(135deg,var(--appkit-color-primary-700)_0%,var(--appkit-color-cobalt)_100%)]", align: "center", justify: "center", rounded: "xl", children: _jsx(Shield, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Admin Guide" })] }), _jsx(Heading, { level: 1, className: "text-[var(--appkit-color-text)] mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: "Trust & Safety" }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", children: "Bans, scam registry, support tickets, moderation, and reports on LetItRip." })] }), [
+                {
+                    Icon: Shield, title: "Seller trust: three fields, two of them visible",
+                    content: (_jsxs(_Fragment, { children: [_jsx(Div, { overflow: "x-auto", children: _jsxs(Table, { size: "sm", children: [_jsx(Thead, { children: _jsx(Tr, { className: ROW_BORDER, children: ["Field", "Public?", "What it means", "Who sets it"].map((h) => (_jsx(Th, { align: "left", paddingSide: "pr-md", className: "text-[var(--appkit-color-text)]", padding: "xs-tall", weight: "semibold", children: h }, h))) }) }), _jsx(Tbody, { size: "sm", color: "muted", children: [
+                                                ["isVerified", "Yes — badge", "We checked WHO they are (ID review). No volume threshold; does not expire.", "Admin, by hand"],
+                                                ["sellerTier", "Yes — badge", "EARNED from the last 90 days of trading. Recomputed monthly.", "sellerStandingRollup, or an admin override that pins it"],
+                                                ["trustedSeller", "NO — never", "We pay this store at SHIPPING, not at delivery. A risk transfer.", "The tier carries it; an admin can also set it alone"],
+                                            ].map((row) => (_jsx(Tr, { className: ROW_BORDER, children: row.map((cell, i) => (_jsx(Td, { paddingSide: "pr-md", padding: "xs-tall", children: i === 0 ? _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: cell }) : cell }, i))) }, row[0]))) })] }) }), _jsxs(Alert, { variant: "warning", title: "trustedSeller moves money", children: ["It means the platform pays before the parcel lands, so we carry a lost parcel and a non-delivery dispute with the money already gone. It is never shown to buyers \u2014 a store does not get to display that we trust it. Every change writes a ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "STORE_TRUST_CHANGE" }), " ", "audit row naming who accepted the risk, including when the monthly job is the one that decided."] }), _jsxs(Ul, { spacing: "tight", indent: "lg", children: [_jsxs(Li, { className: GC.listDiscMuted, children: [_jsx(Span, { weight: "bold", children: "Setting sellerTier by hand PINS it." }), " It writes", " ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "tierLockedByAdmin" }), ", and the monthly job then skips that store entirely \u2014 it still refreshes their figures, it just stops moving the tier. Without the pin an override would silently revert at the next month-end."] }), _jsxs(Li, { className: GC.listDiscMuted, children: [_jsx(Span, { weight: "bold", children: "Suspending a store revokes trust immediately" }), ", not at month end. Monthly caching would otherwise keep paying a suspended store early for up to 31 days. Re-activating does NOT re-grant it; the next month-end decides."] }), _jsxs(Li, { className: GC.listDiscMuted, children: [_jsx(Span, { weight: "bold", children: "The criteria live in one place" }), " \u2014", " ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "SELLER_STANDING_DEFAULTS" }), ", admin-tunable under Site Settings. The seller's dashboard panel, the public seller guide and the buyer-facing badge page all render from it, so they cannot state different numbers from the job that grants it."] }), _jsxs(Li, { className: GC.listDiscMuted, children: [_jsx(Span, { weight: "bold", children: "Self-bought and test orders do not count" }), ", and both a distinct-buyer and a distinct-address floor must be cleared \u2014 the tier releases money early, so buying from yourself 25 times is the attack it has to survive."] })] })] })),
+                },
                 {
                     Icon: Ban, title: "Soft Ban vs Hard Ban",
                     content: (_jsxs(_Fragment, { children: [_jsx(Div, { overflow: "x-auto", children: _jsxs(Table, { size: "sm", children: [_jsx(Thead, { children: _jsx(Tr, { className: "border-b border-[var(--appkit-color-border)]", children: ["", "Soft Ban", "Hard Ban"].map((h) => (_jsx(Th, { align: "left", paddingSide: "pr-md", className: "text-[var(--appkit-color-text)]", padding: "xs-tall", weight: "semibold", children: h }, h))) }) }), _jsx(Tbody, { size: "sm", color: "muted", children: [

package/dist/features/admin/schemas/admin-editor-forms.d.ts

@@ -11,6 +11,8 @@ export declare const adminStoreUpdateSchema: z.ZodEffects<z.ZodObject<{
     storeStatus: z.ZodEnum<[StoreStatus, ...StoreStatus[]]>;
     isVerified: z.ZodOptional<z.ZodBoolean>;
     isFeatured: z.ZodOptional<z.ZodBoolean>;
+    sellerTier: z.ZodOptional<z.ZodEnum<["seller", "trusted"]>>;
+    trustedSeller: z.ZodOptional<z.ZodBoolean>;
     suspensionReason: z.ZodOptional<z.ZodString>;
     capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<[string, ...string[]]>, "many">>;
     adminNotes: z.ZodOptional<z.ZodString>;
@@ -21,6 +23,8 @@ export declare const adminStoreUpdateSchema: z.ZodEffects<z.ZodObject<{
     adminNotes?: string | undefined;
     suspensionReason?: string | undefined;
     capabilities?: string[] | undefined;
+    sellerTier?: "seller" | "trusted" | undefined;
+    trustedSeller?: boolean | undefined;
 }, {
     storeStatus: StoreStatus;
     isVerified?: boolean | undefined;
@@ -28,6 +32,8 @@ export declare const adminStoreUpdateSchema: z.ZodEffects<z.ZodObject<{
     adminNotes?: string | undefined;
     suspensionReason?: string | undefined;
     capabilities?: string[] | undefined;
+    sellerTier?: "seller" | "trusted" | undefined;
+    trustedSeller?: boolean | undefined;
 }>, {
     storeStatus: StoreStatus;
     isVerified?: boolean | undefined;
@@ -35,6 +41,8 @@ export declare const adminStoreUpdateSchema: z.ZodEffects<z.ZodObject<{
     adminNotes?: string | undefined;
     suspensionReason?: string | undefined;
     capabilities?: string[] | undefined;
+    sellerTier?: "seller" | "trusted" | undefined;
+    trustedSeller?: boolean | undefined;
 }, {
     storeStatus: StoreStatus;
     isVerified?: boolean | undefined;
@@ -42,6 +50,8 @@ export declare const adminStoreUpdateSchema: z.ZodEffects<z.ZodObject<{
     adminNotes?: string | undefined;
     suspensionReason?: string | undefined;
     capabilities?: string[] | undefined;
+    sellerTier?: "seller" | "trusted" | undefined;
+    trustedSeller?: boolean | undefined;
 }>;
 export type AdminStoreUpdateValues = z.infer<typeof adminStoreUpdateSchema>;
 /**

package/dist/features/admin/schemas/admin-editor-forms.js

@@ -75,6 +75,40 @@ export const adminStoreUpdateSchema = z
     isFeatured: annotate(z.boolean().optional(), {
         section: "standing", order: 3, row: "quarter",
     }),
+    /*
+     * The EARNED tier, overridable by hand.
+     *
+     * 🛑 Setting it here PINS it — the monthly `sellerStandingRollup` skips a
+     * store whose `standing.tierLockedByAdmin` is true. Without the pin an
+     * override would silently revert at the next month-end, which is worse
+     * than no override: an admin grants a tier, sees it work, and finds it
+     * undone weeks later with nothing saying why.
+     *
+     * 🛑 It carries EARLY PAYOUT with it (see `trustedSeller` below) — the
+     * owner's decision is that reaching the tier grants pay-at-shipping. This
+     * control therefore moves money, which is why the help text says so.
+     */
+    sellerTier: annotate(z.enum(["seller", "trusted"]).optional(), {
+        section: "standing", order: 5, row: "pair", kind: "select",
+        help: "Normally earned automatically at each month-end. Setting it here pins it and also switches payouts to start at shipping.",
+    }),
+    /*
+     * 🛑 This field has existed and been accepted by the API since it was
+     * added, with NO control anywhere in the admin UI — so the only way to set
+     * it was a hand-written PATCH. A flag that moves money and cannot be
+     * operated is worse than one that does not exist, because the code reads
+     * as though an admin is in control of it.
+     *
+     * Separate from `sellerTier` on purpose: the tier is the public, earned
+     * thing, and this is the private risk posture. An admin occasionally needs
+     * one without the other — early payout for a high-volume store that has
+     * not met the rating bar, or a badge for the platform's own store without
+     * changing its payout timing.
+     */
+    trustedSeller: annotate(z.boolean().optional(), {
+        section: "standing", order: 6, row: "quarter",
+        help: "Pay this store when it ships, not when the parcel is delivered. The platform carries a lost parcel with the money already gone. Never shown to buyers.",
+    }),
     /*
      * `when` mirrors the superRefine below, which is what stops the two from
      * disagreeing. The page used to keep this textarea live at all times and

package/dist/features/blog/components/BlogIndexPageView.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { blogRepository } from "../../../repositories/index.js";
-import { Container, Heading, Main, Section } from "../../../ui/index.js";
+import { Container, Main, Section, PageHeroHeading } from "../../../ui/index.js";
 import { AdSlot } from "../../homepage/components/AdSlot.js";
 import { BlogIndexListing } from "./BlogIndexListing.js";
 import { BLOG_DEFAULT_PUBLIC_SORT } from "../schemas/firestore.js";
@@ -41,5 +41,5 @@ export async function BlogIndexPageView({ searchParams = {} }) {
             },
         }
         : undefined;
-    return (_jsx(Main, { children: _jsx(Section, { padding: "y-2xl", children: _jsxs(Container, { size: "xl", children: [_jsx(Heading, { level: 1, className: "mb-8", color: "primary", size: "3xl", weight: "semibold", children: "Blog" }), _jsx(AdSlot, { id: "listing-sidebar-top", className: "mb-6" }), _jsx(BlogIndexListing, { initialData: initialData }), _jsx(AdSlot, { id: "listing-sidebar-bottom", className: "mt-8" })] }) }) }));
+    return (_jsx(Main, { children: _jsx(Section, { padding: "y-2xl", children: _jsxs(Container, { size: "xl", children: [_jsx(PageHeroHeading, { className: "mb-8", pill: "From the shop floor", title: "Blog", description: "Buying guides, release notes and what we have learned importing and grading Beyblades.", meta: initialData?.meta?.total ? `${initialData.meta.total} articles` : undefined }), _jsx(AdSlot, { id: "listing-sidebar-top", className: "mb-6" }), _jsx(BlogIndexListing, { initialData: initialData }), _jsx(AdSlot, { id: "listing-sidebar-bottom", className: "mt-8" })] }) }) }));
 }