@mohasinac/appkit 4.42.18 → 4.44.0

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

@@ -0,0 +1,10 @@
+import React from "react";
+import type { StackedViewShellProps } from "../../../ui";
+export interface AdminTaxCodeEditorViewProps extends Omit<StackedViewShellProps, "sections"> {
+    taxCodeId?: string;
+    /** When true, omit the StackedViewShell wrapper (SideDrawer body). */
+    embedded?: boolean;
+    onSaved?: (id: string) => void;
+    onDeleted?: () => void;
+}
+export declare function AdminTaxCodeEditorView({ taxCodeId, embedded, onSaved, onDeleted, ...rest }: AdminTaxCodeEditorViewProps): React.JSX.Element;

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

@@ -0,0 +1,160 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useApiMutation } from "@mohasinac/appkit/client";
+import React from "react";
+import { useQuery } from "@tanstack/react-query";
+import { ConfirmDeleteModal, Div, StackedViewShell, useToast } from "../../../ui";
+import { apiClient } from "../../../http";
+import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
+import { FormErrorSummary, applyZodIssues } from "../../../ui/forms";
+import { FormShellContext, useFormShellState } from "../../../ui/forms/FormShell";
+import { buildSectionsFromSchema, visibleValues } from "../../shell/build-sections";
+import { SectionForm, useSectionFormNav } from "../../shell/SectionForm";
+import { taxCodeFormSchema, GST_RATE_OPTIONS, HSN_CHAPTER_OPTIONS, } from "../../tax-codes/schemas/tax-code-form";
+const __P = { p4: "p-[var(--appkit-space-4)]" };
+const __O = { yAuto: "overflow-y-auto" };
+/**
+ * 🛑 The delete copy says what the server will actually do.
+ *
+ * `DELETE /api/admin/tax-codes/[id]` REFUSES with a 409 while any category
+ * still points here, and names the referrers. Promising an unconditional
+ * delete and then showing a 409 is how a confirmation dialog loses its
+ * meaning — and the honest alternative (deactivate) is the one an admin
+ * usually wants anyway, since an inactive code is already skipped by
+ * `findResolvable` and gone from every picker.
+ */
+const DELETE_CONFIRM_TEXT = "Delete this tax code? This is refused while any category still points at it — " +
+    "set it inactive instead to retire it without breaking those categories.";
+const TOAST = {
+    CREATED: "Tax code created.",
+    UPDATED: "Tax code updated.",
+    DELETED: "Tax code deleted.",
+};
+export function AdminTaxCodeEditorView({ taxCodeId, embedded, onSaved, onDeleted, ...rest }) {
+    const isEdit = Boolean(taxCodeId);
+    const { showToast } = useToast();
+    const [form, setForm] = React.useState({
+        label: "",
+        hsnCode: "",
+        // The default rate is the one 70 of this catalogue's products need.
+        gstRate: "5",
+        chapter: "9503",
+        description: "",
+        notes: "",
+        isActive: true,
+    });
+    const [deleteConfirmOpen, setDeleteConfirmOpen] = React.useState(false);
+    const patch = (partial) => setForm((prev) => Object.assign({}, prev, partial));
+    const codeQuery = useQuery({
+        queryKey: ["admin", "tax-code", taxCodeId],
+        queryFn: async () => {
+            const res = await apiClient.get(ADMIN_ENDPOINTS.TAX_CODE_BY_ID(taxCodeId));
+            return res?.data ?? res;
+        },
+        enabled: isEdit,
+    });
+    React.useEffect(() => {
+        const t = codeQuery.data;
+        if (!t)
+            return;
+        patch({
+            label: t.label ?? "",
+            hsnCode: t.hsnCode ?? "",
+            /*
+             * `?? 5` would be wrong here and the distinction is the whole point of
+             * this field: rate 0 is a DELIBERATE exemption, and `t.gstRate ?? 5`
+             * would silently re-rate an exempt row to 5% the moment an admin opened
+             * it and saved anything. Test for null, not falsiness.
+             */
+            gstRate: t.gstRate == null ? "5" : String(t.gstRate),
+            chapter: t.chapter ?? "",
+            description: t.description ?? "",
+            notes: t.notes ?? "",
+            isActive: t.isActive ?? true,
+        });
+    }, [codeQuery.data]);
+    const saveMutation = useApiMutation({
+        errorMessage: "Failed to save tax code.",
+        mutationFn: async () => {
+            const payload = {
+                label: form.label,
+                hsnCode: form.hsnCode.trim() || undefined,
+                gstRate: Number(form.gstRate),
+                chapter: form.chapter || undefined,
+                description: form.description || undefined,
+                notes: form.notes || undefined,
+                isActive: form.isActive,
+            };
+            /*
+             * PATCH, not PUT — the route is `.strict()` and partial by design, so a
+             * PUT would 404. (`AdminFeatureEditorView` uses PUT because ITS route
+             * declares PUT; copying the verb rather than reading the route is how
+             * that kind of mismatch ships.)
+             */
+            if (isEdit) {
+                return apiClient.patch(ADMIN_ENDPOINTS.TAX_CODE_BY_ID(taxCodeId), payload);
+            }
+            return apiClient.post(ADMIN_ENDPOINTS.TAX_CODES, payload);
+        },
+        onSuccess: (res) => {
+            const id = res?.data?.id ??
+                res?.id ??
+                taxCodeId;
+            showToast(isEdit ? TOAST.UPDATED : TOAST.CREATED, "success");
+            if (onSaved && id)
+                onSaved(String(id));
+        },
+    });
+    const deleteMutation = useApiMutation({
+        errorMessage: "Failed to delete tax code.",
+        mutationFn: () => apiClient.delete(ADMIN_ENDPOINTS.TAX_CODE_BY_ID(taxCodeId)),
+        onSuccess: () => {
+            showToast(TOAST.DELETED, "success");
+            if (onDeleted)
+                onDeleted();
+        },
+    });
+    const isSubmitting = saveMutation.isPending || codeQuery.isLoading;
+    const sections = React.useMemo(() => buildSectionsFromSchema(taxCodeFormSchema, {
+        // `FieldUiMeta` has no `options` key — a select's VALUES are schema and
+        // its option LIST is supplied here. Same split as the bundle editor.
+        options: {
+            gstRate: [...GST_RATE_OPTIONS],
+            chapter: [{ value: "", label: "No chapter" }, ...HSN_CHAPTER_OPTIONS],
+        },
+    }), []);
+    const nav = useSectionFormNav(sections, form, { scope: "admin:tax-code-editor" });
+    const { shellCtx, setFieldError, clearErrors } = useFormShellState(taxCodeFormSchema, {
+        sections: nav.sectionMeta,
+        onGoToSection: nav.goToSection,
+        fieldToSectionIndex: nav.fieldToSectionIndex,
+    });
+    const onSubmit = () => {
+        clearErrors();
+        const draft = visibleValues(taxCodeFormSchema, form);
+        const parsed = taxCodeFormSchema.safeParse({
+            ...draft,
+            hsnCode: form.hsnCode.trim() || undefined,
+            gstRate: Number(form.gstRate),
+            chapter: form.chapter || undefined,
+            description: form.description || undefined,
+            notes: form.notes || undefined,
+        });
+        if (!parsed.success) {
+            applyZodIssues(parsed.error.issues, setFieldError);
+            return;
+        }
+        saveMutation.mutate();
+    };
+    const formSection = (_jsxs(FormShellContext.Provider, { value: shellCtx, children: [_jsx(FormErrorSummary, {}), _jsx(SectionForm, { sections: sections, values: form, onChange: patch, onSubmit: onSubmit, schema: taxCodeFormSchema, openIds: nav.openIds, onOpenChange: nav.setOpenIds, isLoading: isSubmitting, submitLabel: isEdit ? "Save changes" : "Create tax code", destructiveAction: isEdit
+                    ? { label: "Delete", onClick: () => setDeleteConfirmOpen(true) }
+                    : undefined })] }));
+    const deleteModal = deleteConfirmOpen && (_jsx(ConfirmDeleteModal, { isOpen: true, title: "Delete Tax Code", message: DELETE_CONFIRM_TEXT, onConfirm: () => {
+            deleteMutation.mutate();
+            setDeleteConfirmOpen(false);
+        }, onClose: () => setDeleteConfirmOpen(false), isDeleting: deleteMutation.isPending }));
+    if (embedded) {
+        return (_jsxs(Div, { className: `${__O.yAuto} ${__P.p4}`, children: [formSection, deleteModal] }));
+    }
+    return (_jsxs(_Fragment, { children: [_jsx(StackedViewShell, { portal: "admin", ...rest, title: isEdit ? "Edit Tax Code" : "New Tax Code", sections: [formSection] }), deleteModal] }));
+}

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

@@ -0,0 +1,13 @@
+import React from "react";
+import type { ListingLayoutProps } from "../../../ui";
+export type AdminTaxCodesViewProps = ListingLayoutProps;
+/**
+ * `/admin/tax-codes` — the HSN + GST rate catalogue.
+ *
+ * 🛑 No bulk actions, deliberately. The two that would be offered by habit are
+ * both wrong here: a bulk DELETE would hit the referential guard row by row
+ * and report a partial failure an admin cannot act on, and a bulk
+ * activate/deactivate across a mixed selection is a rate change applied to
+ * things nobody looked at. There are ~10 rows; each one is a per-row decision.
+ */
+export declare function AdminTaxCodesView({ children, ...props }: AdminTaxCodesViewProps): React.JSX.Element;

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

@@ -0,0 +1,86 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { sortBy } from "@mohasinac/appkit/client";
+import React from "react";
+import { ListingLayout } from "../../../ui";
+import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
+import { toRecordArray, toRelativeDate, toStringValue, } from "../hooks/useAdminListingData";
+import { DataListingView } from "./DataListingView";
+import { AdminTaxCodeEditorView } from "./AdminTaxCodeEditorView";
+const PAGE_SIZE = 50;
+function mapTaxCodeRow(item, index) {
+    const isActive = typeof item.isActive === "boolean" ? item.isActive : true;
+    const rate = typeof item.gstRate === "number" ? item.gstRate : null;
+    const hsn = toStringValue(item.hsnCode, "");
+    return {
+        id: toStringValue(item.id, `tax-${index}`),
+        primary: toStringValue(item.label, "Untitled tax code"),
+        /*
+         * The RATE leads, because it is the number an admin is checking. `0%` is
+         * rendered explicitly rather than falling back to an em-dash: a blank
+         * would read as "not set", and 0 is a deliberate exemption — the same
+         * `undefined`-vs-`0` distinction the field itself depends on. A rate that
+         * genuinely has no value says so.
+         */
+        secondary: [
+            rate == null ? "rate not set" : `${rate}% GST`,
+            hsn ? `HSN ${hsn}` : "no HSN (exempt)",
+            toStringValue(item.chapter, "") ? `chapter ${item.chapter}` : "",
+        ]
+            .filter(Boolean)
+            .join(" — "),
+        status: isActive ? "Active" : "Inactive",
+        updatedAt: toRelativeDate(item.updatedAt ?? item.createdAt),
+    };
+}
+/**
+ * `/admin/tax-codes` — the HSN + GST rate catalogue.
+ *
+ * 🛑 No bulk actions, deliberately. The two that would be offered by habit are
+ * both wrong here: a bulk DELETE would hit the referential guard row by row
+ * and report a partial failure an admin cannot act on, and a bulk
+ * activate/deactivate across a mixed selection is a rate change applied to
+ * things nobody looked at. There are ~10 rows; each one is a per-row decision.
+ */
+export function AdminTaxCodesView({ children, ...props }) {
+    if (React.Children.count(children) > 0) {
+        return (_jsx(ListingLayout, { portal: "admin", ...props, children: children }));
+    }
+    const config = {
+        portal: "admin",
+        title: "Tax Codes",
+        // No search box: this endpoint does not read `q`, and a box that accepts
+        // typing and changes nothing is worse than no box
+        // (audit-listing-search-capability's rule). ~10 rows do not need one.
+        emptyLabel: "No tax codes yet",
+        filterKeys: [],
+        defaultSort: sortBy("label", "ASC"),
+        pageSize: PAGE_SIZE,
+        queryKey: ["admin", "tax-codes", "listing"],
+        /*
+         * `?all=true` — the admin list MUST show inactive rows, because
+         * deactivating is how a code is retired and reactivating has to be
+         * possible. The route's default is active-only because its other caller is
+         * the category editor's picker, where offering an inactive code would let
+         * an admin point a category at something `findResolvable` then refuses.
+         */
+        endpoint: `${ADMIN_ENDPOINTS.TAX_CODES}?all=true`,
+        sortOptions: [
+            { value: "label", label: "Label A–Z" },
+            { value: sortBy("label", "DESC"), label: "Label Z–A" },
+            { value: "gstRate", label: "Rate, low to high" },
+            { value: sortBy("gstRate", "DESC"), label: "Rate, high to low" },
+            { value: "hsnCode", label: "HSN code" },
+        ],
+        mapRows: (response) => toRecordArray(response.items).map(mapTaxCodeRow),
+        getTotal: (response, mappedRows) => typeof response.total === "number" ? response.total : mappedRows.length,
+        buildFilters: () => undefined,
+        primaryAction: {
+            label: "Add Tax Code",
+            onClick: ({ openCreatePanel }) => openCreatePanel(),
+        },
+        renderEditor: ({ editId, closePanel }) => (_jsx(AdminTaxCodeEditorView, { taxCodeId: editId ?? undefined, onSaved: closePanel, onDeleted: closePanel, embedded: true })),
+        resolveEditorTitle: ({ isCreate }) => isCreate ? "Add Tax Code" : "Edit Tax Code",
+    };
+    return _jsx(DataListingView, { config: config });
+}

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

@@ -6,7 +6,7 @@ import React, { useMemo } from "react";
 import { useQueryClient } from "@tanstack/react-query";
 import { FilterChipGroup, Heading, ListingLayout, RowActionMenu, Span, Text } from "../../../ui";
 import { apiClient } from "../../../http";
-import { useApiMutation } from "../../../client";
+import { useApiMutation } from "../../../client/api/useApiMutation";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
 import { ACTIONS } from "../../../_internal/shared/actions/action-registry";
 import { ADMIN_BULK_ACTIONS, ROW_ACTION_META, ROW_ACTION_ID } from "../../products/constants/action-defs";

package/dist/features/admin/components/analytics/AdminTopProductsTable.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Div, Heading, Row, Text } from "../../../../ui";
 export function AdminTopProductsTable({ products, labels = {}, formatRevenue = (n) => String(n), renderProductLink, className = "", }) {
-    return (_jsxs(Div, { className: `border border-[var(--appkit-color-border-subtle)] sm:p-[1.5rem] ${className}`, rounded: "xl", padding: "md", surface: "default", children: [labels.title && (_jsx(Heading, { level: 3, className: "mb-4", size: "base", weight: "semibold", children: labels.title })), _jsx(Div, { children: products.map((product) => (_jsxs(Row, { className: "border-b last:border-b-0 border-[var(--appkit-color-border-subtle)]", padding: "y-sm", align: "center", justify: "between", children: [_jsxs(Div, { className: "flex-1 min-w-0", children: [_jsx(Text, { className: "truncate", weight: "medium", children: product.title }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "sm", children: [product.orders, " ", labels.orders ?? "orders"] })] }), product.viewCount != null && (_jsx(Div, { className: "text-right ml-4 hidden sm:block", children: _jsxs(Text, { size: "sm", color: "muted", children: [product.viewCount, " ", labels.views ?? "views"] }) })), _jsxs(Div, { className: "text-right ml-4", children: [_jsx(Text, { weight: "semibold", children: formatRevenue(product.revenue) }), renderProductLink?.(product)] })] }, product.productId))) })] }));
+    return (_jsxs(Div, { className: `border border-[var(--appkit-color-border-subtle)] sm:p-[1.5rem] ${className}`, rounded: "xl", padding: "md", surface: "default", children: [labels.title && (_jsx(Heading, { level: 3, className: "mb-4", size: "base", weight: "semibold", children: labels.title })), _jsx(Div, { children: products.map((product) => (_jsxs(Row, { className: "border-b last:border-b-0 border-[var(--appkit-color-border-subtle)]", padding: "y-sm", align: "center", justify: "between", children: [_jsxs(Div, { className: "flex-1 min-w-0", children: [_jsx(Text, { className: "truncate", weight: "medium", children: product.title }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "sm", children: [product.orders, " ", labels.orders ?? "orders"] })] }), _jsxs(Div, { className: "text-right ml-4", children: [_jsx(Text, { weight: "semibold", children: formatRevenue(product.revenue) }), renderProductLink?.(product)] })] }, product.productId))) })] }));
 }

package/dist/features/auctions/components/AuctionBottomActions.js

@@ -6,6 +6,7 @@ import { useCanSeePrices } from "../../../react/hooks/useCanSeePrices";
 import { formatCurrency } from "../../../utils/number.formatter";
 import { ACTION_ID, ACTION_META } from "../../products/constants/action-defs";
 import { useCountdown } from "../../../react";
+import { useIsAuctionEnded } from "../hooks/useIsAuctionEnded";
 import { Modal } from "../../../ui";
 import { isBuyNowAvailable } from "../../../_internal/shared/features/auctions/config";
 import { PlaceBidFormClient, } from "./PlaceBidFormClient";
@@ -38,7 +39,15 @@ function formatCountdownLabel(remaining) {
  * button can report an error or route to `/checkout?lane=auction`.
  */
 export function AuctionBottomActions(props) {
-    const { currentBid, currency, bidCount, isEnded, auctionEndDate, buyNowPrice } = props;
+    const { currentBid, currency, bidCount, isEnded: ssrIsEnded, auctionEndDate, buyNowPrice } = props;
+    /*
+     * Derived client-side — see `useIsAuctionEnded`. This bar is a FIXED, always-
+     * visible row on mobile, so a stale "Place bid" here is the most prominent
+     * wrong affordance on the page. `useCountdown` below already knew the truth
+     * (it returns null past the target) but only fed a label; the bar's actions
+     * were gated on the frozen server boolean.
+     */
+    const isEnded = useIsAuctionEnded(auctionEndDate, ssrIsEnded);
     const [open, setOpen] = useState(false);
     const remaining = useCountdown(auctionEndDate ?? undefined);
     const { canSeePrices } = useCanSeePrices();

package/dist/features/auctions/components/AuctionDetailPageView.js

@@ -22,6 +22,7 @@ import { AuctionDetailView } from "../../products/components/AuctionDetailView";
 import { ProductTabsShell } from "../../products/components/ProductTabsShell";
 import { CustomSectionTabContent } from "../../products/components/CustomSectionTabContent";
 import { AuctionBottomActions } from "./AuctionBottomActions";
+import { AuctionLiveStatusBadge } from "./AuctionLiveStatusBadge";
 import { RelatedProducts } from "../../products/components/RelatedProducts";
 import { ProductGalleryClient } from "../../products/components/ProductGalleryClient";
 import { ProductFeatureBadges } from "../../products/components/ProductFeatureBadges";
@@ -48,7 +49,7 @@ function toDescriptionHtml(raw) {
 }
 function renderAuctionInfoPanel(props) {
     const { productId, title, currentBid, currency, bidCount, isEnded, endDate, buyNowPrice, buyNowAvailable, featured, freeShipping, condition, finalSale, category, categoryName, brand, brandSlug, productFeatures, features, descriptionHtml, safeSeller, storeHref } = props;
-    return (_jsxs(Stack, { gap: "md", children: [_jsxs(Div, { children: [_jsxs(Row, { gap: "xs", wrap: true, className: "mb-2", children: [_jsx(Span, { size: "xs", weight: "semibold", className: CLS_LIVE_BADGE, children: "\uD83C\uDFF7\uFE0F Live Auction" }), isEnded ? (_jsx(Span, { color: "error", surface: "danger-surface", size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", children: "Ended" })) : (_jsx(Span, { color: "success", surface: "success-surface", size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", children: "Active" }))] }), _jsx(Heading, { level: 1, className: "leading-snug", smSize: "2xl", color: "primary", size: "xl", weight: "bold", children: title })] }), _jsxs(Div, { children: [_jsx(Text, { className: "mb-0.5", color: "muted", size: "xs", children: "Current bid" }), _jsx(LiveBidPrice, { productId: productId, currentBid: currentBid, bidCount: bidCount, currency: currency, isEnded: isEnded, priceSize: "2xl", badgeSize: "sm" }), endDate && !isEnded && (_jsxs(Text, { className: "mt-1.5", color: "muted", size: "sm", children: ["Ends in ", _jsx(Span, { weight: "medium", color: "muted", children: _jsx(CountdownDisplay, { targetDate: endDate, format: "auto", expiredLabel: "Ended" }) })] })), endDate && _jsxs(Text, { className: "mt-0.5", color: "faint", size: "xs", children: [isEnded ? "Ended" : "Ends", " ", endDate.toLocaleString()] })] }), buyNowAvailable && buyNowPrice !== null && (_jsxs(Row, { align: "center", gap: "sm", className: "border border-[var(--appkit-color-primary-200)] dark:border-[var(--appkit-color-primary-800)] bg-primary-50 dark:bg-primary-900/20", padding: "inlineSm", rounded: "lg", children: [_jsx(Span, { size: "xs", color: "muted", children: "Buy Now:" }), _jsx(Span, { size: "base", weight: "bold", className: "text-primary-700 dark:text-primary-300", children: _jsx(GatedPrice, { label: "Sign in to see the Buy Now price", children: formatCurrency(buyNowPrice, currency) }) }), _jsx(Span, { size: "xs", color: "faint", children: "\u2014 in \u201CPlace a bid\u201D" })] })), _jsx(ProductFeatureBadges, { featured: featured, freeShipping: freeShipping, condition: condition ?? undefined, finalSale: finalSale, labels: { featured: "Featured", fasterDelivery: "Faster Delivery", ratedSeller: "Rated Seller", condition: "Condition", conditionNew: "New", conditionUsed: "Used", conditionBroken: "For Parts", conditionRefurbished: "Refurbished", returnable: "Returnable", finalSale: "Final Sale", freeShipping: "Free Shipping", codAvailable: "Cash on Delivery", emiAvailable: "EMI Available", wishlistCount: (n) => `${n} wishlisted`, categoryProductCount: (n, cat) => `${n} in ${cat}` } }), (categoryName || category || brand) && (_jsxs(Row, { gap: "sm", wrap: true, children: [category && _jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(category)), className: "inline-flex items-center rounded-full border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] px-[var(--appkit-space-2-5)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-xs)] font-medium text-[var(--appkit-color-text-muted)] transition-colors hover:border-primary-300 hover:bg-primary-surface hover:text-primary-700 dark:hover:border-primary-700/60 dark:hover:text-primary-400", children: categoryName || category }), !category && categoryName && _jsx(Span, { layout: "inline-flex", size: "xs", weight: "medium", border: "subtle", rounded: "full", padding: "pill-sm-tall", surface: "muted", color: "muted", children: categoryName }), brand && brandSlug && _jsx(Link, { href: String(ROUTES.PUBLIC.BRAND_DETAIL(brandSlug)), className: "inline-flex items-center rounded-full border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] px-[var(--appkit-space-2-5)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-xs)] font-medium text-[var(--appkit-color-text-muted)] transition-colors hover:border-primary-300 hover:bg-primary-surface hover:text-primary-700 dark:hover:border-primary-700/60 dark:hover:text-primary-400", children: brand }), brand && !brandSlug && _jsx(Span, { layout: "inline-flex", size: "xs", weight: "medium", border: "subtle", rounded: "full", padding: "pill-sm-tall", surface: "muted", color: "muted", children: brand })] })), 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 item" }), _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: "Listed 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" })] }) }))] }));
+    return (_jsxs(Stack, { gap: "md", children: [_jsxs(Div, { children: [_jsxs(Row, { gap: "xs", wrap: true, className: "mb-2", children: [_jsx(Span, { size: "xs", weight: "semibold", className: CLS_LIVE_BADGE, children: "\uD83C\uDFF7\uFE0F Live Auction" }), _jsx(AuctionLiveStatusBadge, { auctionEndDate: endDate, initialIsEnded: isEnded })] }), _jsx(Heading, { level: 1, className: "leading-snug", smSize: "2xl", color: "primary", size: "xl", weight: "bold", children: title })] }), _jsxs(Div, { children: [_jsx(Text, { className: "mb-0.5", color: "muted", size: "xs", children: "Current bid" }), _jsx(LiveBidPrice, { productId: productId, currentBid: currentBid, bidCount: bidCount, currency: currency, isEnded: isEnded, priceSize: "2xl", badgeSize: "sm" }), endDate && !isEnded && (_jsxs(Text, { className: "mt-1.5", color: "muted", size: "sm", children: ["Ends in ", _jsx(Span, { weight: "medium", color: "muted", children: _jsx(CountdownDisplay, { targetDate: endDate, format: "auto", expiredLabel: "Ended" }) })] })), endDate && _jsxs(Text, { className: "mt-0.5", color: "faint", size: "xs", children: [isEnded ? "Ended" : "Ends", " ", endDate.toLocaleString()] })] }), buyNowAvailable && buyNowPrice !== null && (_jsxs(Row, { align: "center", gap: "sm", className: "border border-[var(--appkit-color-primary-200)] dark:border-[var(--appkit-color-primary-800)] bg-primary-50 dark:bg-primary-900/20", padding: "inlineSm", rounded: "lg", children: [_jsx(Span, { size: "xs", color: "muted", children: "Buy Now:" }), _jsx(Span, { size: "base", weight: "bold", className: "text-primary-700 dark:text-primary-300", children: _jsx(GatedPrice, { label: "Sign in to see the Buy Now price", children: formatCurrency(buyNowPrice, currency) }) }), _jsx(Span, { size: "xs", color: "faint", children: "\u2014 in \u201CPlace a bid\u201D" })] })), _jsx(ProductFeatureBadges, { featured: featured, freeShipping: freeShipping, condition: condition ?? undefined, finalSale: finalSale, labels: { featured: "Featured", fasterDelivery: "Faster Delivery", ratedSeller: "Rated Seller", condition: "Condition", conditionNew: "New", conditionUsed: "Used", conditionBroken: "For Parts", conditionRefurbished: "Refurbished", returnable: "Returnable", finalSale: "Final Sale", freeShipping: "Free Shipping", codAvailable: "Cash on Delivery", emiAvailable: "EMI Available", wishlistCount: (n) => `${n} wishlisted`, categoryProductCount: (n, cat) => `${n} in ${cat}` } }), (categoryName || category || brand) && (_jsxs(Row, { gap: "sm", wrap: true, children: [category && _jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(category)), className: "inline-flex items-center rounded-full border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] px-[var(--appkit-space-2-5)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-xs)] font-medium text-[var(--appkit-color-text-muted)] transition-colors hover:border-primary-300 hover:bg-primary-surface hover:text-primary-700 dark:hover:border-primary-700/60 dark:hover:text-primary-400", children: categoryName || category }), !category && categoryName && _jsx(Span, { layout: "inline-flex", size: "xs", weight: "medium", border: "subtle", rounded: "full", padding: "pill-sm-tall", surface: "muted", color: "muted", children: categoryName }), brand && brandSlug && _jsx(Link, { href: String(ROUTES.PUBLIC.BRAND_DETAIL(brandSlug)), className: "inline-flex items-center rounded-full border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] px-[var(--appkit-space-2-5)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-xs)] font-medium text-[var(--appkit-color-text-muted)] transition-colors hover:border-primary-300 hover:bg-primary-surface hover:text-primary-700 dark:hover:border-primary-700/60 dark:hover:text-primary-400", children: brand }), brand && !brandSlug && _jsx(Span, { layout: "inline-flex", size: "xs", weight: "medium", border: "subtle", rounded: "full", padding: "pill-sm-tall", surface: "muted", color: "muted", children: brand })] })), 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 item" }), _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: "Listed 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" })] }) }))] }));
 }
 /**
  * Store reviews for the auction's seller.

package/dist/features/auctions/components/AuctionLiveStatusBadge.d.ts

@@ -0,0 +1,20 @@
+export interface AuctionLiveStatusBadgeProps {
+    /** The auction's end timestamp — the only thing that decides this. */
+    auctionEndDate: Date | string | null;
+    /** The server's answer, used as the initial value so SSR and hydration agree. */
+    initialIsEnded: boolean;
+}
+/**
+ * Active / Ended, decided on the client.
+ *
+ * The server-rendered version of this badge sat directly above a countdown that
+ * already flipped itself to "Ended" — so a cached auction page could render
+ * `Ends in Ended` beside a green **Active** pill. The countdown was right and the
+ * badge was stale, in the same `<Stack>`.
+ *
+ * Extracted to a client component rather than passing a derived prop down,
+ * because `AuctionDetailPageView` is a Server Component and cannot hold the
+ * timer. Colours follow the status-pair rule (Root Cause #67): a theme-relative
+ * surface with its matching theme-relative ink, never a literal `text-white`.
+ */
+export declare function AuctionLiveStatusBadge({ auctionEndDate, initialIsEnded, }: AuctionLiveStatusBadgeProps): import("react").JSX.Element;

package/dist/features/auctions/components/AuctionLiveStatusBadge.js

@@ -0,0 +1,21 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Span } from "../../../ui";
+import { useIsAuctionEnded } from "../hooks/useIsAuctionEnded";
+/**
+ * Active / Ended, decided on the client.
+ *
+ * The server-rendered version of this badge sat directly above a countdown that
+ * already flipped itself to "Ended" — so a cached auction page could render
+ * `Ends in Ended` beside a green **Active** pill. The countdown was right and the
+ * badge was stale, in the same `<Stack>`.
+ *
+ * Extracted to a client component rather than passing a derived prop down,
+ * because `AuctionDetailPageView` is a Server Component and cannot hold the
+ * timer. Colours follow the status-pair rule (Root Cause #67): a theme-relative
+ * surface with its matching theme-relative ink, never a literal `text-white`.
+ */
+export function AuctionLiveStatusBadge({ auctionEndDate, initialIsEnded, }) {
+    const isEnded = useIsAuctionEnded(auctionEndDate, initialIsEnded);
+    return isEnded ? (_jsx(Span, { color: "error", surface: "danger-surface", size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", children: "Ended" })) : (_jsx(Span, { color: "success", surface: "success-surface", size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", children: "Active" }));
+}

package/dist/features/auctions/components/PlaceBidFormClient.d.ts

@@ -45,7 +45,7 @@ export interface PlaceBidFormClientProps {
     onPlaceBid: (input: PlaceBidInput) => Promise<BidActionEnvelope<unknown>>;
     onBuyNow?: () => Promise<BidActionEnvelope<BuyNowSuccess>>;
 }
-export declare function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, startingBid, tiers, minBidIncrementOverride, currency, isEnded, auctionEndDate, buyNowPrice, bidCount: ssrBidCount, tags, onPlaceBid, onBuyNow, }: PlaceBidFormClientProps): React.JSX.Element;
+export declare function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, startingBid, tiers, minBidIncrementOverride, currency, isEnded: ssrIsEnded, auctionEndDate, buyNowPrice, bidCount: ssrBidCount, tags, onPlaceBid, onBuyNow, }: PlaceBidFormClientProps): React.JSX.Element;
 /**
  * `PlaceBidModalButton` — opens a modal that hosts the same PlaceBidFormClient.
  *

package/dist/features/auctions/components/PlaceBidFormClient.js

@@ -13,6 +13,7 @@ import { FieldInput } from "../../../ui/forms/FieldInput";
 import { applyZodIssues } from "../../../ui/forms/apply-zod-issues";
 import { placeBidSchema } from "../schemas/bid-input";
 import { useLiveAuctionBid } from "../hooks/useLiveAuctionBid";
+import { useIsAuctionEnded } from "../hooks/useIsAuctionEnded";
 import { AUCTION_BUYOUT_WINDOW_MINUTES } from "../../../_internal/shared/checkout/lanes";
 import { BID_PRESET_MULTIPLIERS, isBuyNowAvailable, resolveMinBid, resolveMinBidIncrement, } from "../../../_internal/shared/features/auctions/config";
 import { normalizeError } from "../../../errors/normalize";
@@ -36,7 +37,20 @@ const __P = {
 /** Feature-specific last resort. Authored copy, never derived from an error. */
 const BID_FALLBACK = "Failed to place bid. Please try again.";
 const BUY_NOW_FALLBACK = "Buy Now failed. Please try again.";
-export function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, startingBid, tiers, minBidIncrementOverride, currency, isEnded, auctionEndDate, buyNowPrice, bidCount: ssrBidCount, tags = [], onPlaceBid, onBuyNow, }) {
+export function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, startingBid, tiers, minBidIncrementOverride, currency, isEnded: ssrIsEnded, auctionEndDate, buyNowPrice, bidCount: ssrBidCount, tags = [], onPlaceBid, onBuyNow, }) {
+    /*
+     * 🛑 Derived here, not trusted from the server.
+     *
+     * `isEnded` arrives baked into cached HTML. On a page cached while the auction
+     * was live it says "still open" indefinitely, so every gate below it — the
+     * amount field, the presets, the submit button, Buy Now — stayed enabled on a
+     * closed lot. The server prop is the INITIAL value only; `auctionEndDate` was
+     * already being passed in and used for display, and it is the real answer.
+     *
+     * The bid itself was never at risk: `placeBid` re-reads the product and
+     * rejects on an expired `auctionEndDate`. This fixes the affordance.
+     */
+    const isEnded = useIsAuctionEnded(auctionEndDate, ssrIsEnded);
     const router = useRouter();
     // Declared with the other hooks, never inside the early return below — a
     // conditional hook is a render-order violation, and this component early-
@@ -277,5 +291,9 @@ export function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, start
 export function PlaceBidModalButton(props) {
     const { triggerLabel = "Place a bid", triggerClassName = "", ...formProps } = props;
     const [open, setOpen] = useState(false);
-    return (_jsxs(_Fragment, { children: [_jsx(Button, { variant: "primary", size: "md", className: triggerClassName, disabled: props.isEnded, onClick: () => setOpen(true), children: props.isEnded ? "Auction Ended" : triggerLabel }), _jsx(Modal, { isOpen: open, onClose: () => setOpen(false), size: "md", title: "Place your bid", children: _jsx(PlaceBidFormClient, { ...formProps }) })] }));
+    // Same reason as inside the form: this trigger is THE affordance a buyer sees
+    // on a cached auction page, so it must decide for itself rather than trust a
+    // boolean that was true whenever the HTML happened to be generated.
+    const isEnded = useIsAuctionEnded(props.auctionEndDate, props.isEnded);
+    return (_jsxs(_Fragment, { children: [_jsx(Button, { variant: "primary", size: "md", className: triggerClassName, disabled: isEnded, onClick: () => setOpen(true), children: isEnded ? "Auction Ended" : triggerLabel }), _jsx(Modal, { isOpen: open, onClose: () => setOpen(false), size: "md", title: "Place your bid", children: _jsx(PlaceBidFormClient, { ...formProps }) })] }));
 }

package/dist/features/auctions/hooks/useIsAuctionEnded.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Has this auction ended, decided on the CLIENT from its end timestamp.
+ *
+ * ## Why this exists
+ *
+ * `AuctionDetailPageView` computed `const isEnded = endDate < new Date()` on the
+ * SERVER and froze the answer into eleven places — the status badge, the Buy-Now
+ * chip, the SSE `enabled` flag, the Place-Bid button, the mobile bid card and
+ * the bottom action bar. That is correct only for as long as the rendered HTML
+ * is fresh.
+ *
+ * The page is cached. At `revalidate = 30` the window was small enough to hide
+ * the problem; it is not small enough to be *correct*, and raising the TTL (so
+ * that 95 auction pages stop regenerating up to 2,880 times a day each, which is
+ * what produced 3.1M ISR writes) makes it plainly visible: a page cached while
+ * the auction was live renders a green **Active** badge and an enabled "Place a
+ * bid" button on a lot that closed hours ago.
+ *
+ * The timestamp needed to know better was already being passed down — it was
+ * used for display only.
+ *
+ * ## What this does NOT change
+ *
+ * Server-side enforcement is independent and already correct: `placeBid` and
+ * `buyNowAuction` both re-read the product and reject on `endDate < now`, and
+ * `assertAuctionActive()` is a third copy. A stale page could never actually
+ * place a bid — the defect was always a misleading affordance, never a bad
+ * write. That is what makes this safe to adopt incrementally: every component
+ * converted is an improvement, and an unconverted one is no worse than today.
+ *
+ * ## Behaviour
+ *
+ * - Starts from `initial` (the server's answer) so the first paint is unchanged
+ *   and hydration does not mismatch.
+ * - Re-checks on mount, which is where a cached page corrects itself.
+ * - Schedules ONE timer for the exact moment of expiry rather than ticking every
+ *   second — a bid button does not need per-second resolution, and an interval
+ *   on every auction card would be a needless wakeup. Long waits are clamped to
+ *   the setTimeout 32-bit ceiling and re-armed.
+ */
+export declare function useIsAuctionEnded(auctionEndDate: Date | string | null | undefined, initial?: boolean): boolean;

package/dist/features/auctions/hooks/useIsAuctionEnded.js

@@ -0,0 +1,76 @@
+"use client";
+import { useEffect, useState } from "react";
+/**
+ * Has this auction ended, decided on the CLIENT from its end timestamp.
+ *
+ * ## Why this exists
+ *
+ * `AuctionDetailPageView` computed `const isEnded = endDate < new Date()` on the
+ * SERVER and froze the answer into eleven places — the status badge, the Buy-Now
+ * chip, the SSE `enabled` flag, the Place-Bid button, the mobile bid card and
+ * the bottom action bar. That is correct only for as long as the rendered HTML
+ * is fresh.
+ *
+ * The page is cached. At `revalidate = 30` the window was small enough to hide
+ * the problem; it is not small enough to be *correct*, and raising the TTL (so
+ * that 95 auction pages stop regenerating up to 2,880 times a day each, which is
+ * what produced 3.1M ISR writes) makes it plainly visible: a page cached while
+ * the auction was live renders a green **Active** badge and an enabled "Place a
+ * bid" button on a lot that closed hours ago.
+ *
+ * The timestamp needed to know better was already being passed down — it was
+ * used for display only.
+ *
+ * ## What this does NOT change
+ *
+ * Server-side enforcement is independent and already correct: `placeBid` and
+ * `buyNowAuction` both re-read the product and reject on `endDate < now`, and
+ * `assertAuctionActive()` is a third copy. A stale page could never actually
+ * place a bid — the defect was always a misleading affordance, never a bad
+ * write. That is what makes this safe to adopt incrementally: every component
+ * converted is an improvement, and an unconverted one is no worse than today.
+ *
+ * ## Behaviour
+ *
+ * - Starts from `initial` (the server's answer) so the first paint is unchanged
+ *   and hydration does not mismatch.
+ * - Re-checks on mount, which is where a cached page corrects itself.
+ * - Schedules ONE timer for the exact moment of expiry rather than ticking every
+ *   second — a bid button does not need per-second resolution, and an interval
+ *   on every auction card would be a needless wakeup. Long waits are clamped to
+ *   the setTimeout 32-bit ceiling and re-armed.
+ */
+export function useIsAuctionEnded(auctionEndDate, initial = false) {
+    const endMs = toMs(auctionEndDate);
+    const [ended, setEnded] = useState(initial);
+    useEffect(() => {
+        if (endMs === null) {
+            // No end date — the server's answer is the only one available.
+            setEnded(initial);
+            return;
+        }
+        let timer;
+        const evaluate = () => {
+            const remaining = endMs - Date.now();
+            if (remaining <= 0) {
+                setEnded(true);
+                return;
+            }
+            setEnded(false);
+            // setTimeout overflows past ~24.8 days and fires immediately; re-arm.
+            timer = setTimeout(evaluate, Math.min(remaining, 2147483000));
+        };
+        evaluate();
+        return () => {
+            if (timer)
+                clearTimeout(timer);
+        };
+    }, [endMs, initial]);
+    return ended;
+}
+function toMs(value) {
+    if (!value)
+        return null;
+    const ms = value instanceof Date ? value.getTime() : new Date(value).getTime();
+    return Number.isFinite(ms) ? ms : null;
+}

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

@@ -69,7 +69,6 @@ export interface UserDocument extends BaseDocument {
     storeStatus?: "pending" | "approved" | "rejected";
     isTester?: boolean;
     canTestAdmin?: boolean;
-    isBot?: boolean;
     publicProfile?: {
         isPublic: boolean;
         showEmail: boolean;

package/dist/features/blog/api/route.js

@@ -72,7 +72,22 @@ export async function GET(request) {
             posts: result.items,
             meta,
         };
-        return NextResponse.json({ success: true, data: body });
+        const response = NextResponse.json({ success: true, data: body });
+        /*
+         * The only public listing API that set NO Cache-Control — `/api/products`,
+         * `/api/stores`, `/api/events` and `/api/reviews` all do, and CLAUDE.md
+         * Rule #6.5 requires it of every public GET (20 of 378 routes complied).
+         *
+         * It mattered little while anonymous browsing never reached this route (the
+         * dynamic `/blog` page rendered server-side and seeded the client), but it
+         * is on the critical path the moment a filtered view misses the page cache.
+         * Window matched to its siblings deliberately — a blog post is no more
+         * volatile than a product.
+         *
+         * Errors below stay uncached: a 500 must not be pinned at the edge.
+         */
+        response.headers.set("Cache-Control", "public, max-age=60, s-maxage=120, stale-while-revalidate=60");
+        return response;
     }
     catch (error) {
         void normalizeError(error);

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

@@ -16,9 +16,9 @@ export interface BlogPostDocument extends BaseDocument {
     title: string;
     slug: string;
     excerpt: string;
-    /** Tester sandbox flag — set on the shared admin-seeded test post; swept by testerSandboxCleanup. */
+    /** Test-data flag — set on the shared admin-seeded test post; swept by testDataCleanup. */
     isTestData?: boolean;
-    /** When isTestData, the cutoff after which testerSandboxCleanup deletes this doc. */
+    /** When isTestData, the cutoff after which testDataCleanup deletes this doc. */
     testDataExpiresAt?: Date;
     content: string;
     coverImage?: MediaFieldInput;