@mohasinac/appkit 4.58.0 → 4.60.0

package/dist/features/protection-claims/schemas/firestore.d.ts

@@ -0,0 +1,168 @@
+/**
+ * `protectionClaims` — a buyer's claim against protection cover they paid for.
+ *
+ * ## Why this collection is the point of Phase 6
+ *
+ * We charge **2% (min ₹30)** shipment protection and **3% (min ₹49)** sale
+ * protection. Both platform flags are seeded `true` and sellers can self-enable
+ * in payout settings, so the fee is collectable today. And every piece needed to
+ * honour it existed with **zero callers**: `protectionAvailability()`,
+ * `adjudicateClaim()`, `returnDestination()`, `RETURN_CUSTODY_STATES`,
+ * `SALE_PROTECTION_MAX_VALUE`, `PROTECTION_CLAIM_WINDOW_HOURS`, and the
+ * `returnCustody` / `returnPostedAt` / `returnReceivedAt` / `returnInspection`
+ * fields on the order (D11).
+ *
+ * So the money moved and the promise did not. A FAQ said *"we pursue the
+ * courier and refund you"* and *"refunded no questions asked"* with nothing
+ * behind either sentence. This collection is what gives those pieces their
+ * first writer.
+ *
+ * ## 🛑 The claim WINDOW is not stored here
+ *
+ * It is the `claim-shipping` / `claim-sale` obligations (Phase 5b), derived from
+ * `deliveryDate` through `PROTECTION_CLAIM_WINDOW_HOURS` — 48h for shipping,
+ * 168h for sale. Storing a deadline on the claim would be a second copy that
+ * drifts from the policy (Root Cause #42), and the obligation already closes
+ * the window and earns the premium.
+ */
+import type { BaseDocument } from "../../../_internal/shared/types/base-document";
+import type { StatusChangeEntry } from "../../../_internal/shared/history/types";
+import type { ClaimFinding, ProtectionKind } from "../../../_internal/shared/features/shipping/protections";
+export declare const PROTECTION_CLAIMS_COLLECTION = "protectionClaims";
+/**
+ * Lifecycle.
+ *
+ * | state | meaning |
+ * |---|---|
+ * | `open` | the buyer filed it; nobody has looked |
+ * | `awaiting-return` | the buyer must post the item back (sale cover only) |
+ * | `inspecting` | it arrived and is being opened |
+ * | `upheld` | `adjudicateClaim` said refund the buyer |
+ * | `rejected` | the buyer is not refunded — only reachable on UNPROTECTED cover |
+ * | `withdrawn` | the buyer withdrew it |
+ * | `expired` | the claim window closed with no action |
+ */
+export type ProtectionClaimStatus = "open" | "awaiting-return" | "inspecting" | "upheld" | "rejected" | "withdrawn" | "expired";
+/**
+ * Why the buyer says the cover applies.
+ *
+ * 🛑 Deliberately NOT the same vocabulary as `ClaimFinding`. The buyer's
+ * REASON is what they assert; the `finding` is what a human concluded on
+ * opening the parcel, and conflating them would let a buyer's own words decide
+ * who pays. `adjudicateClaim(protectedSale, finding)` takes the finding.
+ */
+export type ProtectionClaimReason = "not-delivered" | "damaged-in-transit" | "not-as-described" | "counterfeit" | "missing-parts" | "other";
+export interface ProtectionClaimDocument extends BaseDocument {
+    /** Which cover is being claimed against. */
+    kind: ProtectionKind;
+    orderId: string;
+    /** Denormalised so the admin queue needs no join to show who and where. */
+    storeId: string;
+    buyerId: string;
+    /** Absent means the whole order — the same convention refunds use. */
+    itemIds?: string[];
+    status: ProtectionClaimStatus;
+    reason: ProtectionClaimReason;
+    /** The buyer's own account, in their words. */
+    detail: string;
+    /** Photos. Media slugs, never raw Storage URLs. */
+    evidenceUrls?: string[];
+    /**
+     * Decimal rupees. What the buyer paid for the claimed items, which is the
+     * ceiling on the refund.
+     *
+     * 🛑 Snapshotted at filing, not re-derived at adjudication. A seller cannot
+     * reprice an item after a claim is filed, and `SALE_PROTECTION_MAX_VALUE`
+     * (₹25,000) is tested against the amount actually paid.
+     */
+    claimedAmount: number;
+    /**
+     * The human finding, which is what decides WHO PAYS — never whether a
+     * protected buyer is refunded.
+     *
+     * 🛑 `returnInspection.finding` on the order says the same thing, and that is
+     * intentional rather than duplication: the order's copy is the custody
+     * record for the parcel, this one is the claim's own audit trail, and a claim
+     * can be adjudicated without a return at all (a never-delivered parcel has
+     * nothing to inspect).
+     */
+    finding?: ClaimFinding;
+    /** The outcome `adjudicateClaim` produced, recorded verbatim. */
+    outcome?: {
+        refundBuyer: boolean;
+        costBorneBy: "seller" | "platform" | "buyer";
+        raisesReport: boolean;
+    };
+    adjudicatedBy?: string;
+    adjudicatedAt?: Date;
+    /** The refund this claim produced, so the two are joinable. */
+    refundId?: string;
+    statusHistory?: StatusChangeEntry[];
+    statusHistoryTruncated?: number;
+    isTestData?: boolean;
+}
+export declare const PROTECTION_CLAIM_FIELDS: {
+    readonly ID: "id";
+    readonly KIND: "kind";
+    readonly ORDER_ID: "orderId";
+    readonly STORE_ID: "storeId";
+    readonly BUYER_ID: "buyerId";
+    readonly STATUS: "status";
+    readonly REASON: "reason";
+    readonly CLAIMED_AMOUNT: "claimedAmount";
+    readonly FINDING: "finding";
+    readonly ADJUDICATED_AT: "adjudicatedAt";
+    readonly REFUND_ID: "refundId";
+    readonly CREATED_AT: "createdAt";
+};
+/** Statuses where the claim is still somebody's work. */
+export declare const PROTECTION_CLAIM_ACTIVE_STATUSES: readonly ProtectionClaimStatus[];
+export declare const PROTECTION_CLAIM_DETAIL_MIN = 20;
+export declare const PROTECTION_CLAIM_DETAIL_MAX = 2000;
+/**
+ * 🛑 ONE OPEN CLAIM PER (ORDER, KIND), and the id enforces it.
+ *
+ * Deterministic, so `.create()` refuses a second claim on the same cover for
+ * the same order. Without that a buyer could file five sale-protection claims
+ * on one order and — because a protected claim is refunded unconditionally —
+ * each one would be a separate refund against the same goods.
+ *
+ * Keyed on (order, kind) rather than on (order, kind, item) deliberately: a
+ * claim names its `itemIds`, so a buyer with a genuine second problem amends
+ * the open claim rather than opening a parallel one. Two concurrent claims on
+ * one order is an operational mess with no upside.
+ */
+export declare function createProtectionClaimId(orderId: string, kind: ProtectionKind): string;
+export declare const ALL_PROTECTION_CLAIM_STATUSES: ProtectionClaimStatus[];
+export declare const ALL_PROTECTION_CLAIM_REASONS: ProtectionClaimReason[];
+/**
+ * Which cover a reason can be claimed under.
+ *
+ * 🛑 `not-delivered` and `damaged-in-transit` are TRANSIT failures — shipment
+ * cover. Everything else is about the item itself — sale cover. Letting a buyer
+ * pick the cover themselves would let them claim a non-delivery against the
+ * 7-day sale window after the 48-hour transit window had closed, which is the
+ * window rule defeated by a dropdown.
+ */
+/**
+ * Buyer-facing labels for the six claim reasons.
+ *
+ * Lives beside the enum rather than in the claim form, matching
+ * `RETURN_REASON_LABEL` and for the same stated reason: these strings appear in
+ * the buyer's form, the admin queue and the notification body, and three copies
+ * of them would drift. It is also the half of `PROTECTION_COPY` the plan
+ * records as missing — `protections.ts` owns the RULES and says its own
+ * `ProtectionUnavailableReason` "is rendered to the buyer, so it is copy",
+ * while every buyer string sat inline in `StoreAddonsPicker`.
+ *
+ * `Record<ProtectionClaimReason, string>`, so a seventh reason is a COMPILE
+ * error here rather than a radio option rendering `undefined`.
+ *
+ * 🛑 Phrased as what HAPPENED, never as what the buyer wants. The reason
+ * decides the cover kind through `REASON_TO_KIND`, so it is a statement of
+ * fact that a window is measured against — not a request. "It never arrived"
+ * is a transit failure; "I changed my mind" is not a claim at all and is
+ * deliberately absent from the union.
+ */
+export declare const PROTECTION_CLAIM_REASON_LABEL: Record<ProtectionClaimReason, string>;
+export declare const REASON_TO_KIND: Record<ProtectionClaimReason, ProtectionKind>;

package/dist/features/protection-claims/schemas/firestore.js

@@ -0,0 +1,130 @@
+/**
+ * `protectionClaims` — a buyer's claim against protection cover they paid for.
+ *
+ * ## Why this collection is the point of Phase 6
+ *
+ * We charge **2% (min ₹30)** shipment protection and **3% (min ₹49)** sale
+ * protection. Both platform flags are seeded `true` and sellers can self-enable
+ * in payout settings, so the fee is collectable today. And every piece needed to
+ * honour it existed with **zero callers**: `protectionAvailability()`,
+ * `adjudicateClaim()`, `returnDestination()`, `RETURN_CUSTODY_STATES`,
+ * `SALE_PROTECTION_MAX_VALUE`, `PROTECTION_CLAIM_WINDOW_HOURS`, and the
+ * `returnCustody` / `returnPostedAt` / `returnReceivedAt` / `returnInspection`
+ * fields on the order (D11).
+ *
+ * So the money moved and the promise did not. A FAQ said *"we pursue the
+ * courier and refund you"* and *"refunded no questions asked"* with nothing
+ * behind either sentence. This collection is what gives those pieces their
+ * first writer.
+ *
+ * ## 🛑 The claim WINDOW is not stored here
+ *
+ * It is the `claim-shipping` / `claim-sale` obligations (Phase 5b), derived from
+ * `deliveryDate` through `PROTECTION_CLAIM_WINDOW_HOURS` — 48h for shipping,
+ * 168h for sale. Storing a deadline on the claim would be a second copy that
+ * drifts from the policy (Root Cause #42), and the obligation already closes
+ * the window and earns the premium.
+ */
+export const PROTECTION_CLAIMS_COLLECTION = "protectionClaims";
+export const PROTECTION_CLAIM_FIELDS = {
+    ID: "id",
+    KIND: "kind",
+    ORDER_ID: "orderId",
+    STORE_ID: "storeId",
+    BUYER_ID: "buyerId",
+    STATUS: "status",
+    REASON: "reason",
+    CLAIMED_AMOUNT: "claimedAmount",
+    FINDING: "finding",
+    ADJUDICATED_AT: "adjudicatedAt",
+    REFUND_ID: "refundId",
+    CREATED_AT: "createdAt",
+};
+/** Statuses where the claim is still somebody's work. */
+export const PROTECTION_CLAIM_ACTIVE_STATUSES = [
+    "open",
+    "awaiting-return",
+    "inspecting",
+];
+export const PROTECTION_CLAIM_DETAIL_MIN = 20;
+export const PROTECTION_CLAIM_DETAIL_MAX = 2000;
+/**
+ * 🛑 ONE OPEN CLAIM PER (ORDER, KIND), and the id enforces it.
+ *
+ * Deterministic, so `.create()` refuses a second claim on the same cover for
+ * the same order. Without that a buyer could file five sale-protection claims
+ * on one order and — because a protected claim is refunded unconditionally —
+ * each one would be a separate refund against the same goods.
+ *
+ * Keyed on (order, kind) rather than on (order, kind, item) deliberately: a
+ * claim names its `itemIds`, so a buyer with a genuine second problem amends
+ * the open claim rather than opening a parallel one. Two concurrent claims on
+ * one order is an operational mess with no upside.
+ */
+export function createProtectionClaimId(orderId, kind) {
+    return `${orderId}__${kind}`.replace(/[^A-Za-z0-9_.:-]/g, "_").slice(0, 1500);
+}
+const PROTECTION_CLAIM_STATUS_MAP = {
+    open: true,
+    "awaiting-return": true,
+    inspecting: true,
+    upheld: true,
+    rejected: true,
+    withdrawn: true,
+    expired: true,
+};
+export const ALL_PROTECTION_CLAIM_STATUSES = Object.keys(PROTECTION_CLAIM_STATUS_MAP);
+const PROTECTION_CLAIM_REASON_MAP = {
+    "not-delivered": true,
+    "damaged-in-transit": true,
+    "not-as-described": true,
+    counterfeit: true,
+    "missing-parts": true,
+    other: true,
+};
+export const ALL_PROTECTION_CLAIM_REASONS = Object.keys(PROTECTION_CLAIM_REASON_MAP);
+/**
+ * Which cover a reason can be claimed under.
+ *
+ * 🛑 `not-delivered` and `damaged-in-transit` are TRANSIT failures — shipment
+ * cover. Everything else is about the item itself — sale cover. Letting a buyer
+ * pick the cover themselves would let them claim a non-delivery against the
+ * 7-day sale window after the 48-hour transit window had closed, which is the
+ * window rule defeated by a dropdown.
+ */
+/**
+ * Buyer-facing labels for the six claim reasons.
+ *
+ * Lives beside the enum rather than in the claim form, matching
+ * `RETURN_REASON_LABEL` and for the same stated reason: these strings appear in
+ * the buyer's form, the admin queue and the notification body, and three copies
+ * of them would drift. It is also the half of `PROTECTION_COPY` the plan
+ * records as missing — `protections.ts` owns the RULES and says its own
+ * `ProtectionUnavailableReason` "is rendered to the buyer, so it is copy",
+ * while every buyer string sat inline in `StoreAddonsPicker`.
+ *
+ * `Record<ProtectionClaimReason, string>`, so a seventh reason is a COMPILE
+ * error here rather than a radio option rendering `undefined`.
+ *
+ * 🛑 Phrased as what HAPPENED, never as what the buyer wants. The reason
+ * decides the cover kind through `REASON_TO_KIND`, so it is a statement of
+ * fact that a window is measured against — not a request. "It never arrived"
+ * is a transit failure; "I changed my mind" is not a claim at all and is
+ * deliberately absent from the union.
+ */
+export const PROTECTION_CLAIM_REASON_LABEL = {
+    "not-delivered": "It never arrived",
+    "damaged-in-transit": "It arrived damaged",
+    "not-as-described": "It is not what the listing described",
+    counterfeit: "It is counterfeit or not authentic",
+    "missing-parts": "Parts are missing",
+    other: "Something else is wrong with the item",
+};
+export const REASON_TO_KIND = {
+    "not-delivered": "shipping",
+    "damaged-in-transit": "shipping",
+    "not-as-described": "sale",
+    counterfeit: "sale",
+    "missing-parts": "sale",
+    other: "sale",
+};

package/dist/features/reviews/actions/review-actions.js

@@ -50,8 +50,9 @@ export async function createReview(userId, input) {
                 duration: 0,
             }
             : undefined,
-        verified: false,
-        status: "pending",
+        /* `verified` and `status` are set by `createReview` itself and are
+           omitted from `ReviewCreateInput` — passing them here duplicated the
+           repository default and was the reason the input type demanded them. */
     });
 }
 export async function updateReview(userId, reviewId, input) {

package/dist/features/reviews/components/ReviewModal.js

@@ -24,5 +24,5 @@ export function ViewReviewModal({ review, isOpen, onClose, }) {
             day: "numeric",
         })
         : "";
-    return (_jsx(Modal, { isOpen: isOpen, onClose: onClose, title: "Review Details", children: _jsxs(Stack, { gap: "md", children: [_jsxs(Row, { gap: "3", children: [review.userAvatar ? (_jsx(Div, { className: "relative h-10 w-10 flex-shrink-0", rounded: "full", overflow: "hidden", children: _jsx(MediaImage, { src: review.userAvatar, alt: displayName, size: "avatar" }) })) : (_jsx(Row, { textWeight: "medium", textSize: "sm", className: "h-10 w-10 flex-shrink-0 bg-neutral-200 text-[var(--appkit-color-text-muted)]", align: "center", justify: "center", rounded: "full", children: displayName.charAt(0).toUpperCase() })), _jsxs(Div, { children: [_jsxs(Row, { gap: "sm", children: [_jsx(Text, { color: "inverse", className: "text-[var(--appkit-color-text)] dark:", weight: "medium", children: displayName }), review.verified && (_jsx(Text, { className: THEMED_TEXT_SUCCESS, size: "xs", children: "\u2713 Verified purchase" }))] }), _jsxs(Row, { className: "mt-0.5", gap: "sm", children: [_jsx(StarRating, { value: review.rating, size: "sm", readOnly: true }), date && (_jsx(Text, { size: "xs", color: "faint", children: date }))] })] })] }), review.title && (_jsx(Heading, { color: "inverse", level: 4, className: "text-[var(--appkit-color-text)] dark:", weight: "semibold", children: review.title })), review.comment && (_jsx(RichText, { html: normalizeRichTextHtml(review.comment), 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)] text-[var(--appkit-color-text-muted)]" })), review.images && review.images.length > 0 && (_jsx(Row, { wrap: true, gap: "sm", children: review.images.map((img, i) => (_jsx(Button, { variant: "ghost", type: "button", "aria-label": `View image ${i + 1}`, onClick: () => setLightboxIdx(i), rounded: "lg", paddingX: "none", paddingY: "none", className: `h-20 w-20 overflow-hidden transition hover:opacity-80 flex-shrink-0 ${lightboxIdx === i ? "ring-2 ring-primary-500" : " border-[var(--appkit-color-border)]"}`, children: _jsx(MediaImage, { src: img, alt: `Review thumbnail ${i + 1}`, size: "thumbnail" }) }, i))) })), (review.helpfulCount ?? 0) > 0 && (_jsxs(Text, { size: "xs", color: "faint", children: [review.helpfulCount, " people found this helpful"] })), _jsx(Row, { justify: "end", padding: "t-xs", children: _jsx(Button, { variant: "ghost", onClick: onClose, children: "Close" }) })] }) }));
+    return (_jsx(Modal, { isOpen: isOpen, onClose: onClose, title: "Review Details", children: _jsxs(Stack, { gap: "md", children: [_jsxs(Row, { gap: "3", children: [review.userAvatar ? (_jsx(Div, { className: "relative h-10 w-10 flex-shrink-0", rounded: "full", overflow: "hidden", children: _jsx(MediaImage, { src: review.userAvatar, alt: displayName, size: "avatar" }) })) : (_jsx(Row, { textWeight: "medium", textSize: "sm", className: "h-10 w-10 flex-shrink-0 bg-neutral-200 text-[var(--appkit-color-text-muted)]", align: "center", justify: "center", rounded: "full", children: displayName.charAt(0).toUpperCase() })), _jsxs(Div, { children: [_jsxs(Row, { gap: "sm", children: [_jsx(Text, { color: "inverse", className: "text-[var(--appkit-color-text)] dark:", weight: "medium", children: displayName }), review.verified && (_jsx(Text, { className: THEMED_TEXT_SUCCESS, size: "xs", children: "\u2713 Verified purchase" }))] }), _jsxs(Row, { className: "mt-0.5", gap: "sm", children: [_jsx(StarRating, { value: review.rating, size: "sm", readOnly: true }), date && (_jsx(Text, { size: "xs", color: "faint", children: date }))] })] })] }), review.title && (_jsx(Heading, { color: "inverse", level: 4, className: "text-[var(--appkit-color-text)] dark:", weight: "semibold", children: review.title })), review.comment && (_jsx(RichText, { html: normalizeRichTextHtml(review.comment), 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)]" })), review.images && review.images.length > 0 && (_jsx(Row, { wrap: true, gap: "sm", children: review.images.map((img, i) => (_jsx(Button, { variant: "ghost", type: "button", "aria-label": `View image ${i + 1}`, onClick: () => setLightboxIdx(i), rounded: "lg", paddingX: "none", paddingY: "none", className: `h-20 w-20 overflow-hidden transition hover:opacity-80 flex-shrink-0 ${lightboxIdx === i ? "ring-2 ring-primary-500" : " border-[var(--appkit-color-border)]"}`, children: _jsx(MediaImage, { src: img, alt: `Review thumbnail ${i + 1}`, size: "thumbnail" }) }, i))) })), (review.helpfulCount ?? 0) > 0 && (_jsxs(Text, { size: "xs", color: "faint", children: [review.helpfulCount, " people found this helpful"] })), _jsx(Row, { justify: "end", padding: "t-xs", children: _jsx(Button, { variant: "ghost", onClick: onClose, children: "Close" }) })] }) }));
 }

package/dist/features/reviews/components/ReviewsList.js

@@ -29,7 +29,7 @@ export function ReviewCard({ review, context = "general", className = "" }) {
     const showProductLink = context !== "listing" && !!productHref;
     const showProfileLink = !!profileHref;
     const hasFooter = showStoreLink || showProductLink || showProfileLink;
-    return (_jsxs(Stack, { padding: "5", shadow: "hover-md", className: `group h-full border border-neutral-200 transition ${className}`, rounded: "xl", surface: "default", children: [_jsxs(Link, { href: reviewHref, className: "flex flex-col flex-1 min-h-0", children: [_jsxs(Row, { align: "start", gap: "3", children: [review.userAvatar ? (_jsx(Div, { className: "relative h-9 w-9 flex-shrink-0", rounded: "full", overflow: "hidden", children: _jsx(MediaImage, { src: review.userAvatar, alt: displayName, size: "avatar" }) })) : (_jsx(Row, { textWeight: "medium", textSize: "sm", className: "h-9 w-9 flex-shrink-0 bg-neutral-200 text-[var(--appkit-color-text-muted)]", align: "center", justify: "center", rounded: "full", children: initials })), _jsxs(Div, { className: "flex-1 min-w-0", children: [_jsxs(Row, { wrap: true, gap: "sm", children: [_jsx(Span, { color: "inverse", weight: "medium", className: "text-[var(--appkit-color-text)] dark:", children: displayName }), review.verified && (_jsx(Span, { color: "success", surface: "success-surface", size: "xs", weight: "medium", rounded: "full", padding: "pill-xs", children: "Verified" })), date && (_jsx(Span, { size: "xs", color: "muted", children: date }))] }), _jsx(Div, { className: "mt-1", children: _jsx(StarRating, { value: review.rating, size: "sm", readOnly: true }) })] })] }), review.title && (_jsx(Heading, { color: "inverse", level: 4, className: "mt-3 text-[var(--appkit-color-text)] dark:", weight: "semibold", children: review.title })), review.comment && (_jsx(RichText, { html: normalizeRichTextHtml(review.comment), proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "mt-2 text-[length:var(--appkit-text-sm)] leading-relaxed text-[var(--appkit-color-text-muted)] text-[var(--appkit-color-text-muted)]" })), review.images && review.images.length > 0 && (_jsx(Row, { wrap: true, gap: "sm", className: "mt-3", children: review.images.map((img, i) => (_jsx(Div, { className: "relative h-16 w-16 flex-shrink-0 border border-neutral-100", rounded: "lg", overflow: "hidden", children: _jsx(MediaImage, { src: img, alt: `Review image ${i + 1}`, size: "thumbnail" }) }, i))) })), (review.helpfulCount ?? 0) > 0 && (_jsxs(Text, { className: "mt-3", color: "faint", size: "xs", children: [review.helpfulCount, " found this helpful"] }))] }), hasFooter && (_jsxs(Stack, { gap: "xs", className: "mt-3 border-t border-neutral-100", padding: "t-sm", children: [showStoreLink && (_jsxs(Link, { href: String(ROUTES.PUBLIC.STORE_DETAIL(review.storeSlug)), className: "flex items-center gap-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] font-medium text-primary hover:underline", children: [_jsx(Span, { "aria-hidden": "true", children: "\uD83C\uDFEA" }), _jsx(Span, { truncate: true, children: review.storeName })] })), showProductLink && (_jsxs(Link, { href: productHref, className: "flex items-center gap-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] font-medium text-[var(--appkit-color-text-muted)] hover:text-[var(--appkit-color-text)]", children: [_jsx(Span, { "aria-hidden": "true", children: "\uD83D\uDCE6" }), _jsx(Span, { truncate: true, children: review.productTitle ?? "View Product" }), _jsx(Span, { "aria-hidden": "true", className: "ml-auto text-primary group-hover:translate-x-0.5 transition-transform", children: "\u2192" })] })), showProfileLink && (_jsxs(Link, { href: profileHref, className: "flex items-center gap-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] font-medium text-[var(--appkit-color-text-muted)] hover:text-[var(--appkit-color-text)]", children: [_jsx(Span, { "aria-hidden": "true", children: "\uD83D\uDC64" }), _jsx(Span, { truncate: true, children: displayName })] }))] }))] }));
+    return (_jsxs(Stack, { padding: "5", shadow: "hover-md", className: `group h-full border border-neutral-200 transition ${className}`, rounded: "xl", surface: "default", children: [_jsxs(Link, { href: reviewHref, className: "flex flex-col flex-1 min-h-0", children: [_jsxs(Row, { align: "start", gap: "3", children: [review.userAvatar ? (_jsx(Div, { className: "relative h-9 w-9 flex-shrink-0", rounded: "full", overflow: "hidden", children: _jsx(MediaImage, { src: review.userAvatar, alt: displayName, size: "avatar" }) })) : (_jsx(Row, { textWeight: "medium", textSize: "sm", className: "h-9 w-9 flex-shrink-0 bg-neutral-200 text-[var(--appkit-color-text-muted)]", align: "center", justify: "center", rounded: "full", children: initials })), _jsxs(Div, { className: "flex-1 min-w-0", children: [_jsxs(Row, { wrap: true, gap: "sm", children: [_jsx(Span, { color: "inverse", weight: "medium", className: "text-[var(--appkit-color-text)] dark:", children: displayName }), review.verified && (_jsx(Span, { color: "success", surface: "success-surface", size: "xs", weight: "medium", rounded: "full", padding: "pill-xs", children: "Verified" })), date && (_jsx(Span, { size: "xs", color: "muted", children: date }))] }), _jsx(Div, { className: "mt-1", children: _jsx(StarRating, { value: review.rating, size: "sm", readOnly: true }) })] })] }), review.title && (_jsx(Heading, { color: "inverse", level: 4, className: "mt-3 text-[var(--appkit-color-text)] dark:", weight: "semibold", children: review.title })), review.comment && (_jsx(RichText, { html: normalizeRichTextHtml(review.comment), proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "mt-2 text-[length:var(--appkit-text-sm)] leading-relaxed text-[var(--appkit-color-text-muted)]" })), review.images && review.images.length > 0 && (_jsx(Row, { wrap: true, gap: "sm", className: "mt-3", children: review.images.map((img, i) => (_jsx(Div, { className: "relative h-16 w-16 flex-shrink-0 border border-neutral-100", rounded: "lg", overflow: "hidden", children: _jsx(MediaImage, { src: img, alt: `Review image ${i + 1}`, size: "thumbnail" }) }, i))) })), (review.helpfulCount ?? 0) > 0 && (_jsxs(Text, { className: "mt-3", color: "faint", size: "xs", children: [review.helpfulCount, " found this helpful"] }))] }), hasFooter && (_jsxs(Stack, { gap: "xs", className: "mt-3 border-t border-neutral-100", padding: "t-sm", children: [showStoreLink && (_jsxs(Link, { href: String(ROUTES.PUBLIC.STORE_DETAIL(review.storeSlug)), className: "flex items-center gap-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] font-medium text-primary hover:underline", children: [_jsx(Span, { "aria-hidden": "true", children: "\uD83C\uDFEA" }), _jsx(Span, { truncate: true, children: review.storeName })] })), showProductLink && (_jsxs(Link, { href: productHref, className: "flex items-center gap-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] font-medium text-[var(--appkit-color-text-muted)] hover:text-[var(--appkit-color-text)]", children: [_jsx(Span, { "aria-hidden": "true", children: "\uD83D\uDCE6" }), _jsx(Span, { truncate: true, children: review.productTitle ?? "View Product" }), _jsx(Span, { "aria-hidden": "true", className: "ml-auto text-primary group-hover:translate-x-0.5 transition-transform", children: "\u2192" })] })), showProfileLink && (_jsxs(Link, { href: profileHref, className: "flex items-center gap-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] font-medium text-[var(--appkit-color-text-muted)] hover:text-[var(--appkit-color-text)]", children: [_jsx(Span, { "aria-hidden": "true", children: "\uD83D\uDC64" }), _jsx(Span, { truncate: true, children: displayName })] }))] }))] }));
 }
 export function ReviewsList({ reviews, context = "general", isLoading, totalPages = 1, currentPage = 1, onPageChange, emptyLabel = "No reviews yet", }) {
     if (isLoading) {

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

@@ -42,6 +42,25 @@ export interface ReviewDocument extends BaseDocument {
     userSlug?: string;
     userName: Encrypted<string>;
     userAvatar?: string;
+    /**
+     * The order whose line this review rates.
+     *
+     * 🛑 Optional, because every review written before this field existed has
+     * none — and any query over it must therefore treat a missing `orderId` as
+     * "unknown", never as "not from an order". A default-exclusive filter would
+     * hide every pre-existing review and manufacture a backfill nobody budgeted
+     * for (the same rule `serverErrors.entityType` carries).
+     */
+    orderId?: string;
+    /**
+     * The specific order LINE, when the order carries `items[]`.
+     *
+     * Needed because one order can contain the same `productId` twice — a
+     * grouped line and a standalone purchase of the same bey — and Zomato-style
+     * rating is per LINE, not per product. Without it, rating one of the two
+     * lines would mark both as rated.
+     */
+    orderItemId?: string;
     rating: number;
     title: string;
     comment: string;
@@ -78,7 +97,7 @@ export declare const REVIEW_INDEXED_FIELDS: readonly ["searchTxt", "productId",
 export declare const DEFAULT_REVIEW_DATA: Partial<ReviewDocument>;
 export declare const REVIEW_PUBLIC_FIELDS: readonly ["id", "productId", "userName", "userAvatar", "rating", "title", "comment", "helpfulCount", "verified", "images", "createdAt"];
 export declare const REVIEW_UPDATABLE_FIELDS: readonly ["rating", "title", "comment", "images"];
-export type ReviewCreateInput = Omit<ReviewPlain, "id" | "createdAt" | "updatedAt" | "helpfulCount" | "reportCount" | "moderatorId" | "moderatorNote" | "approvedAt" | "rejectedAt">;
+export type ReviewCreateInput = Omit<ReviewPlain, "id" | "createdAt" | "updatedAt" | "status" | "verified" | "helpfulCount" | "reportCount" | "moderatorId" | "moderatorNote" | "approvedAt" | "rejectedAt">;
 export type ReviewUpdateInput = Partial<Pick<ReviewDocument, (typeof REVIEW_UPDATABLE_FIELDS)[number]>>;
 export type ReviewModerationInput = {
     status: ReviewStatus;

package/dist/features/scams/constants/scam-types.d.ts

@@ -29,6 +29,8 @@ export declare const SCAM_CATEGORIES: ScamCategoryDefinition[];
 export declare const SCAM_TYPES: ScamTypeDefinition[];
 /** Get a scam type definition by its ID. */
 export declare function getScamType(id: ScamType): ScamTypeDefinition | undefined;
+/** Is `value` one of the 27 documented scam-type ids? */
+export declare function isScamType(value: string): value is ScamType;
 /** Get all scam types in a given category. */
 export declare function getScamTypesByCategory(category: ScamCategory): ScamTypeDefinition[];
 /** Get the category definition for a given scam type ID. */

package/dist/features/scams/constants/scam-types.js

@@ -427,6 +427,24 @@ export const SCAM_TYPES = [
 export function getScamType(id) {
     return SCAM_TYPES.find((t) => t.id === id);
 }
+/**
+ * The set of real ids, for narrowing an arbitrary string.
+ *
+ * `getScamType` already takes a `ScamType`, so it cannot be used to VALIDATE
+ * one — which is why the scam-report form had nothing to check against and
+ * `POST /api/scams/reports` accepted `z.string().min(1)`. A free-text value
+ * stores fine (the repository's `create` does no enum check), and then the
+ * registry's type chips and `SCAM_TYPE_LABELS` can never match it: the profile
+ * renders no type at all and the report is unfilterable.
+ *
+ * Derived from `SCAM_TYPES` rather than restating the union, so documenting a
+ * 28th pattern needs one edit and cannot drift from what the form offers.
+ */
+const SCAM_TYPE_ID_SET = new Set(SCAM_TYPES.map((t) => t.id));
+/** Is `value` one of the 27 documented scam-type ids? */
+export function isScamType(value) {
+    return SCAM_TYPE_ID_SET.has(value);
+}
 /** Get all scam types in a given category. */
 export function getScamTypesByCategory(category) {
     return SCAM_TYPES.filter((t) => t.category === category);

package/dist/features/scams/schemas/report-form.d.ts

@@ -4,7 +4,7 @@ export declare const scamReportFormSchema: z.ZodEffects<z.ZodObject<{
     phones: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     upiIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     emails: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    scamType: z.ZodString;
+    scamType: z.ZodEffects<z.ZodString, import("../constants/scam-types").ScamType, string>;
     scamPlatform: z.ZodString;
     amountLost: z.ZodOptional<z.ZodNumber>;
     itemInvolved: z.ZodOptional<z.ZodString>;
@@ -14,7 +14,7 @@ export declare const scamReportFormSchema: z.ZodEffects<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     displayName: string;
     description: string;
-    scamType: string;
+    scamType: import("../constants/scam-types").ScamType;
     scamPlatform: string;
     agreed: true;
     reportedByAnon?: boolean | undefined;
@@ -38,7 +38,7 @@ export declare const scamReportFormSchema: z.ZodEffects<z.ZodObject<{
 }>, {
     displayName: string;
     description: string;
-    scamType: string;
+    scamType: import("../constants/scam-types").ScamType;
     scamPlatform: string;
     agreed: true;
     reportedByAnon?: boolean | undefined;

package/dist/features/scams/schemas/report-form.js

@@ -33,6 +33,7 @@
  */
 import { z } from "zod";
 import { annotate } from "../../shell/field-ui-meta.js";
+import { isScamType } from "../constants/scam-types.js";
 const UPI_VPA_RE = /^[\w.\-_]{2,256}@[a-zA-Z]{2,64}$/;
 const PHONE_RE = /^(\+?91[-\s]?)?[6-9]\d{9}$/;
 export const scamReportFormSchema = z
@@ -42,8 +43,32 @@ export const scamReportFormSchema = z
     phones: annotate(z.array(z.string().trim().regex(PHONE_RE, "Enter a 10-digit Indian mobile number.")).max(10).optional(), { section: "who", order: 2, row: "full", kind: "list" }),
     upiIds: annotate(z.array(z.string().trim().regex(UPI_VPA_RE, "Enter a valid UPI ID, e.g. name@bank.")).max(10).optional(), { section: "who", order: 3, row: "full", kind: "list" }),
     emails: annotate(z.array(z.string().trim().toLowerCase().email("Enter a valid email address.")).max(10).optional(), { section: "who", order: 4, row: "full", kind: "list" }),
-    scamType: annotate(z.string().trim().min(1, "Choose what kind of scam this was."), {
+    /*
+     * 🛑 `kind: "select"` IS LOAD-BEARING, not decoration.
+     *
+     * `buildSectionsFromSchema` reads `opts.options[name]` only inside its
+     * `case "select"` branch. With no `kind` the generator inferred `"text"`
+     * from the `ZodString` — so the page's 27-entry `SCAM_TYPE_OPTIONS` list
+     * was passed in and ignored, and the field rendered as a FREE-TEXT input.
+     * There was no way to choose a scam type at all.
+     *
+     * Verified by running the shipped resolver against this schema:
+     *   scamType     | kind: text    ← before
+     *   scamPlatform | kind: select  ← its sibling, which was annotated
+     *
+     * The sibling being correct is why this read as a styling quirk rather
+     * than a dead control.
+     *
+     * The refine is the other half. `min(1)` accepted any non-empty string,
+     * matching the route, and nothing downstream validates: the repository's
+     * `create` has no enum check, so a typed value stored and then matched no
+     * chip in the registry and no key in `SCAM_TYPE_LABELS`. A select cannot
+     * produce a bad value, but a direct POST can — see the mirror of this on
+     * `POST /api/scams/reports`.
+     */
+    scamType: annotate(z.string().trim().refine(isScamType, { message: "Choose what kind of scam this was." }), {
         section: "what", sectionLabel: "What happened", sectionRequired: true, quick: true, order: 1, row: "pair",
+        kind: "select",
     }),
     /*
      * Required, matching `POST /api/scams/reports` (`z.string().min(1)`).

package/dist/features/search/components/Search.js

@@ -28,7 +28,7 @@ const DEFAULT_TYPE_ICONS = {
     product: "📦",
 };
 const DEFAULT_TYPE_BADGES = {
-    page: "bg-[var(--appkit-color-surface)] text-[var(--appkit-color-text-muted)] bg-[var(--appkit-color-surface-elevated)] text-[var(--appkit-color-text-muted)]",
+    page: "bg-[var(--appkit-color-surface-elevated)] text-[var(--appkit-color-text-muted)]",
     category: "bg-info-surface text-info dark:bg-info-surface dark:text-info",
     blog: "bg-fuchsia-100 text-fuchsia-600 dark:bg-fuchsia-900/40 dark:text-fuchsia-300",
     event: "bg-warning-surface text-warning dark:bg-warning-surface dark:text-warning",
@@ -36,7 +36,7 @@ const DEFAULT_TYPE_BADGES = {
 };
 function SuggestionItem({ suggestion, itemIndex, activeIndex, onSelect, onHover, typeIcons, typeBadges, }) {
     const isActive = activeIndex === itemIndex;
-    return (_jsx(Li, { children: _jsxs(Button, { type: "button", variant: "ghost", onClick: () => onSelect(suggestion), onMouseEnter: () => onHover(itemIndex), className: `w-full flex items-center gap-[var(--appkit-space-3)] px-[var(--appkit-space-4)] py-[var(--appkit-space-3)] text-left transition-colors border-b border-[var(--appkit-color-border)] last:border-b-0 ${isActive ? "bg-[var(--appkit-color-surface)] bg-[var(--appkit-color-surface-elevated)]" : CLS_HOVER_ROW}`, children: [_jsx(Span, { size: "sm", children: typeIcons[suggestion.type] }), _jsxs(Div, { className: "flex-1 min-w-0", children: [_jsx(Text, { size: "sm", className: CLS_TRUNCATE, children: suggestion.title }), suggestion.subtitle && (_jsx(Text, { variant: "secondary", size: "xs", className: "truncate", children: suggestion.subtitle }))] }), _jsx(Span, { size: "xs", className: `${typeBadges[suggestion.type]}`, rounded: "full", padding: "pill-xs", children: suggestion.type })] }) }));
+    return (_jsx(Li, { children: _jsxs(Button, { type: "button", variant: "ghost", onClick: () => onSelect(suggestion), onMouseEnter: () => onHover(itemIndex), className: `w-full flex items-center gap-[var(--appkit-space-3)] px-[var(--appkit-space-4)] py-[var(--appkit-space-3)] text-left transition-colors border-b border-[var(--appkit-color-border)] last:border-b-0 ${isActive ? "bg-[var(--appkit-color-surface-elevated)]" : CLS_HOVER_ROW}`, children: [_jsx(Span, { size: "sm", children: typeIcons[suggestion.type] }), _jsxs(Div, { className: "flex-1 min-w-0", children: [_jsx(Text, { size: "sm", className: CLS_TRUNCATE, children: suggestion.title }), suggestion.subtitle && (_jsx(Text, { variant: "secondary", size: "xs", className: "truncate", children: suggestion.subtitle }))] }), _jsx(Span, { size: "xs", className: `${typeBadges[suggestion.type]}`, rounded: "full", padding: "pill-xs", children: suggestion.type })] }) }));
 }
 export function Search({ isOpen, onClose, onSearch, onOpen, value, onChange, placeholder, deferred = true, debounceMs = 300, onClear, className, router, quickLinks = [], labels, suggestionTypeIcons, suggestionTypeBadges, resourceTypes, defaultResourceType = "products", storageKey = "letitrip_search_type", searchIndexEnabled, }) {
     const isInlineMode = value !== undefined;
@@ -211,7 +211,7 @@ export function Search({ isOpen, onClose, onSearch, onOpen, value, onChange, pla
             return (_jsx(Li, { children: _jsxs(Button, { type: "button", variant: "ghost", onClick: () => {
                         setIsInlineOpen(false);
                         router.push(link.href);
-                    }, onMouseEnter: () => setActiveIndex(index), className: `w-full flex items-center gap-[var(--appkit-space-3)] px-[var(--appkit-space-4)] py-[var(--appkit-space-2-5)] text-left transition-colors border-b border-[var(--appkit-color-border)] ${isActive ? "bg-[var(--appkit-color-surface)] bg-[var(--appkit-color-surface-elevated)]" : CLS_HOVER_ROW}`, children: [_jsx(Icon, { className: CLS_ICON_ROW }), _jsx(Text, { size: "sm", className: CLS_TRUNCATE, children: link.label })] }) }, `inline-link-${link.href}`));
+                    }, onMouseEnter: () => setActiveIndex(index), className: `w-full flex items-center gap-[var(--appkit-space-3)] px-[var(--appkit-space-4)] py-[var(--appkit-space-2-5)] text-left transition-colors border-b border-[var(--appkit-color-border)] ${isActive ? "bg-[var(--appkit-color-surface-elevated)]" : CLS_HOVER_ROW}`, children: [_jsx(Icon, { className: CLS_ICON_ROW }), _jsx(Text, { size: "sm", className: CLS_TRUNCATE, children: link.label })] }) }, `inline-link-${link.href}`));
         };
         const handleInlineKeyDown = (event) => {
             if (event.key === "ArrowDown") {
@@ -257,15 +257,15 @@ export function Search({ isOpen, onClose, onSearch, onOpen, value, onChange, pla
                                 if (inlineBlurRef.current)
                                     clearTimeout(inlineBlurRef.current);
                                 inlineBlurRef.current = setTimeout(() => setIsInlineOpen(false), 120);
-                            }, placeholder: placeholder ?? labels.placeholder, className: "w-full rounded-lg border bg-[var(--appkit-color-surface)] pl-9 text-zinc-900 placeholder:text-zinc-400 focus:border-primary focus:ring-2 focus:ring-primary/20 border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] dark:text-white dark:placeholder:text-slate-500" }), query && (_jsx(Button, { rounded: "full", textColor: "faint", type: "button", variant: "ghost", onClick: handleClear, className: "absolute right-3 p-[0.125rem] hover:text-[var(--appkit-color-text-muted)] dark:hover:text-[var(--appkit-color-text)] transition-colors", "aria-label": labels.clearAriaLabel, children: _jsx("svg", { className: "w-4 h-4 shrink-0", "aria-hidden": "true", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M6 18L18 6M6 6l12 12" }) }) }))] }), resourceTypes && resourceTypes.length > 0 && (_jsx(Select, { options: resourceTypes, value: selectedType, onValueChange: handleTypeChange, "aria-label": labels.resourceTypeLabel ?? "Search in", wrapperClassName: "flex-shrink-0 max-w-[92px] sm:max-w-[150px]" })), deferred && (_jsx(Button, { rounded: "lg", paddingX: "sm", paddingY: "sm", type: "button", variant: "primary", onClick: handleDeferredSubmit, "aria-label": labels.ariaLabel, className: "flex-shrink-0", children: _jsx("svg", { className: "w-4 h-4 shrink-0", "aria-hidden": "true", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: SVG_PATH_SEARCH }) }) })), isInlineOpen && (filteredQuickLinks.length > 0 || query) && (_jsxs(Div, { rounded: "xl", border: "default", shadow: "lg", className: "absolute top-full left-0 right-0 mt-2 overflow-hidden bg-[var(--appkit-color-surface)] [z-index:var(--appkit-z-dropdown)]", onMouseDown: (event) => event.preventDefault(), children: [filteredQuickLinks.length > 0 && (_jsx(Ul, { children: filteredQuickLinks.map((link, index) => renderInlineQuickLink(link, index)) })), query && suggestionsLoading && (_jsx(Div, { padding: "inline", children: _jsx(Text, { variant: "secondary", size: "sm", children: labels.searching }) })), query &&
+                            }, placeholder: placeholder ?? labels.placeholder, className: "w-full rounded-lg border pl-9 text-zinc-900 placeholder:text-zinc-400 focus:border-primary focus:ring-2 focus:ring-primary/20 border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] dark:text-white dark:placeholder:text-slate-500" }), query && (_jsx(Button, { rounded: "full", textColor: "faint", type: "button", variant: "ghost", onClick: handleClear, className: "absolute right-3 p-[0.125rem] hover:text-[var(--appkit-color-text-muted)] dark:hover:text-[var(--appkit-color-text)] transition-colors", "aria-label": labels.clearAriaLabel, children: _jsx("svg", { className: "w-4 h-4 shrink-0", "aria-hidden": "true", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M6 18L18 6M6 6l12 12" }) }) }))] }), resourceTypes && resourceTypes.length > 0 && (_jsx(Select, { options: resourceTypes, value: selectedType, onValueChange: handleTypeChange, "aria-label": labels.resourceTypeLabel ?? "Search in", wrapperClassName: "flex-shrink-0 max-w-[92px] sm:max-w-[150px]" })), deferred && (_jsx(Button, { rounded: "lg", paddingX: "sm", paddingY: "sm", type: "button", variant: "primary", onClick: handleDeferredSubmit, "aria-label": labels.ariaLabel, className: "flex-shrink-0", children: _jsx("svg", { className: "w-4 h-4 shrink-0", "aria-hidden": "true", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: SVG_PATH_SEARCH }) }) })), isInlineOpen && (filteredQuickLinks.length > 0 || query) && (_jsxs(Div, { rounded: "xl", border: "default", shadow: "lg", className: "absolute top-full left-0 right-0 mt-2 overflow-hidden bg-[var(--appkit-color-surface)] [z-index:var(--appkit-z-dropdown)]", onMouseDown: (event) => event.preventDefault(), children: [filteredQuickLinks.length > 0 && (_jsx(Ul, { children: filteredQuickLinks.map((link, index) => renderInlineQuickLink(link, index)) })), query && suggestionsLoading && (_jsx(Div, { padding: "inline", children: _jsx(Text, { variant: "secondary", size: "sm", children: labels.searching }) })), query &&
                             suggestions.slice(0, 5).map((suggestion, suggestionIndex) => {
                                 const itemIndex = inlineQuickLinkItems.length + suggestionIndex;
                                 const isActive = activeIndex === itemIndex;
-                                return (_jsxs(Button, { type: "button", variant: "ghost", onClick: () => handleSuggestionClick(suggestion), onMouseEnter: () => setActiveIndex(itemIndex), className: `w-full flex items-center gap-[var(--appkit-space-3)] px-[var(--appkit-space-4)] py-[var(--appkit-space-2-5)] text-left transition-colors border-b border-[var(--appkit-color-border)] ${isActive ? "bg-[var(--appkit-color-surface)] bg-[var(--appkit-color-surface-elevated)]" : CLS_HOVER_ROW}`, children: [_jsx(Span, { size: "sm", children: typeIcons[suggestion.type] }), _jsxs(Div, { className: "flex-1 min-w-0", children: [_jsx(Text, { size: "sm", className: CLS_TRUNCATE, children: suggestion.title }), suggestion.subtitle && (_jsx(Text, { variant: "secondary", size: "xs", className: "truncate", children: suggestion.subtitle }))] })] }, `inline-suggestion-${suggestion.objectID}`));
+                                return (_jsxs(Button, { type: "button", variant: "ghost", onClick: () => handleSuggestionClick(suggestion), onMouseEnter: () => setActiveIndex(itemIndex), className: `w-full flex items-center gap-[var(--appkit-space-3)] px-[var(--appkit-space-4)] py-[var(--appkit-space-2-5)] text-left transition-colors border-b border-[var(--appkit-color-border)] ${isActive ? "bg-[var(--appkit-color-surface-elevated)]" : CLS_HOVER_ROW}`, children: [_jsx(Span, { size: "sm", children: typeIcons[suggestion.type] }), _jsxs(Div, { className: "flex-1 min-w-0", children: [_jsx(Text, { size: "sm", className: CLS_TRUNCATE, children: suggestion.title }), suggestion.subtitle && (_jsx(Text, { variant: "secondary", size: "xs", className: "truncate", children: suggestion.subtitle }))] })] }, `inline-suggestion-${suggestion.objectID}`));
                             }), query.trim() && (_jsxs(Button, { type: "button", variant: "ghost", onClick: () => {
                                 handleDeferredSubmit();
                                 setIsInlineOpen(false);
-                            }, onMouseEnter: () => setActiveIndex(inlineItems.length - 1), className: `w-full flex items-center gap-[var(--appkit-space-2)] px-[var(--appkit-space-4)] py-[var(--appkit-space-3)] text-left transition-colors ${activeIndex === inlineItems.length - 1 ? "bg-[var(--appkit-color-surface)] bg-[var(--appkit-color-surface-elevated)]" : CLS_HOVER_ROW}`, children: [_jsx("svg", { className: CLS_ICON_ROW, fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: SVG_PATH_SEARCH }) }), _jsx(Text, { size: "sm", className: CLS_TRUNCATE, children: labels.browseProducts(query) })] }))] }))] }));
+                            }, onMouseEnter: () => setActiveIndex(inlineItems.length - 1), className: `w-full flex items-center gap-[var(--appkit-space-2)] px-[var(--appkit-space-4)] py-[var(--appkit-space-3)] text-left transition-colors ${activeIndex === inlineItems.length - 1 ? "bg-[var(--appkit-color-surface-elevated)]" : CLS_HOVER_ROW}`, children: [_jsx("svg", { className: CLS_ICON_ROW, fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: SVG_PATH_SEARCH }) }), _jsx(Text, { size: "sm", className: CLS_TRUNCATE, children: labels.browseProducts(query) })] }))] }))] }));
     }
     const overlayQuery = query.toLowerCase();
     const filteredSiteLinks = query
@@ -336,13 +336,13 @@ export function Search({ isOpen, onClose, onSearch, onOpen, value, onChange, pla
     return (_jsx(Div, { border: "bottom-subtle", className: "animate-[fadeIn_150ms_ease-out]", surface: "default", shadow: "md", children: _jsxs(Div, { className: "container mx-auto md:py-[1rem] relative", padding: "inline", children: [_jsxs(Row, { gap: "sm", className: "md:gap-[0.75rem]", children: [_jsx(Div, { className: "flex-1 relative min-w-0", children: _jsx(Input, { ref: inputRef, bare: true, type: "search", placeholder: placeholder ?? labels.placeholder, value: query, onFocus: () => setSearchIntent(true), onChange: (event) => {
                                     setSearchIntent(true);
                                     setQuery(event.target.value);
-                                }, onKeyDown: handleOverlayKeyDown, className: "w-full rounded-lg border bg-[var(--appkit-color-surface)] text-zinc-900 placeholder:text-zinc-400 focus:border-primary focus:ring-2 focus:ring-primary/20 border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] dark:text-white dark:placeholder:text-slate-500" }) }), resourceTypes && resourceTypes.length > 0 && (_jsx(Select, { options: resourceTypes, value: selectedType, onValueChange: handleTypeChange, "aria-label": labels.resourceTypeLabel ?? "Search in", wrapperClassName: "flex-shrink-0 max-w-[92px] sm:max-w-[150px]" })), _jsxs(Button, { gap: "md", onClick: handleOverlaySearch, variant: "primary", size: "md", className: "hidden sm:", children: [_jsx("svg", { className: "w-5 h-5 shrink-0", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: SVG_PATH_SEARCH }) }), labels.title] }), _jsx(Button, { rounded: "xl", variant: "ghost", onClick: () => onClose?.(), className: "p-[var(--appkit-space-2-5)] md:p-[var(--appkit-space-3)] transition-colors text-[var(--appkit-color-text-muted)] hover:bg-surface-hover hover:text-[var(--appkit-color-text)] flex-shrink-0", "aria-label": labels.closeAriaLabel, children: _jsx("svg", { className: "w-6 h-6 md:w-7 md:h-7 shrink-0", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M6 18L18 6M6 6l12 12" }) }) })] }), (filteredSiteLinks.length > 0 || query) && (_jsxs(Stack, { className: "absolute top-full left-0 right-0 z-50 pt-[0.5rem] pb-[1rem]", padding: "x-md", gap: "sm", children: [filteredSiteLinks.length > 0 && !suggestionsLoading && (_jsxs(Div, { className: `${__O.hidden}`, rounded: "xl", shadow: "lg", surface: "default", border: "default", children: [_jsx(Div, { border: "default", className: "border-b", paddingY: "y-xs", paddingX: "x-md", children: _jsx(Text, { variant: "secondary", size: "xs", className: "uppercase tracking-wider", weight: "semibold", children: labels.quickLinks }) }), _jsx(Ul, { children: filteredSiteLinks.map((link) => {
+                                }, onKeyDown: handleOverlayKeyDown, className: "w-full rounded-lg border text-zinc-900 placeholder:text-zinc-400 focus:border-primary focus:ring-2 focus:ring-primary/20 border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] dark:text-white dark:placeholder:text-slate-500" }) }), resourceTypes && resourceTypes.length > 0 && (_jsx(Select, { options: resourceTypes, value: selectedType, onValueChange: handleTypeChange, "aria-label": labels.resourceTypeLabel ?? "Search in", wrapperClassName: "flex-shrink-0 max-w-[92px] sm:max-w-[150px]" })), _jsxs(Button, { gap: "md", onClick: handleOverlaySearch, variant: "primary", size: "md", className: "hidden sm:", children: [_jsx("svg", { className: "w-5 h-5 shrink-0", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: SVG_PATH_SEARCH }) }), labels.title] }), _jsx(Button, { rounded: "xl", variant: "ghost", onClick: () => onClose?.(), className: "p-[var(--appkit-space-2-5)] md:p-[var(--appkit-space-3)] transition-colors text-[var(--appkit-color-text-muted)] hover:bg-surface-hover hover:text-[var(--appkit-color-text)] flex-shrink-0", "aria-label": labels.closeAriaLabel, children: _jsx("svg", { className: "w-6 h-6 md:w-7 md:h-7 shrink-0", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M6 18L18 6M6 6l12 12" }) }) })] }), (filteredSiteLinks.length > 0 || query) && (_jsxs(Stack, { className: "absolute top-full left-0 right-0 z-50 pt-[0.5rem] pb-[1rem]", padding: "x-md", gap: "sm", children: [filteredSiteLinks.length > 0 && !suggestionsLoading && (_jsxs(Div, { className: `${__O.hidden}`, rounded: "xl", shadow: "lg", surface: "default", border: "default", children: [_jsx(Div, { border: "default", className: "border-b", paddingY: "y-xs", paddingX: "x-md", children: _jsx(Text, { variant: "secondary", size: "xs", className: "uppercase tracking-wider", weight: "semibold", children: labels.quickLinks }) }), _jsx(Ul, { children: filteredSiteLinks.map((link) => {
                                         const Icon = link.icon;
                                         const itemIndex = quickLinkItems.findIndex((item) => item.link.href === link.href);
                                         const isActive = activeIndex === itemIndex;
                                         return (_jsx(Li, { children: _jsxs(Button, { type: "button", variant: "ghost", onClick: () => {
                                                     onClose?.();
                                                     router.push(link.href);
-                                                }, onMouseEnter: () => setActiveIndex(itemIndex), className: `w-full flex items-center gap-[var(--appkit-space-3)] px-[var(--appkit-space-4)] py-[var(--appkit-space-2-5)] text-left transition-colors border-b border-[var(--appkit-color-border)] last:border-b-0 ${isActive ? "bg-[var(--appkit-color-surface)] bg-[var(--appkit-color-surface-elevated)]" : CLS_HOVER_ROW}`, children: [_jsx(Icon, { className: CLS_ICON_ROW }), _jsx(Text, { size: "sm", weight: "medium", children: link.label })] }) }, link.href));
-                                    }) })] })), query && (_jsxs(Div, { className: `${__O.hidden}`, rounded: "xl", shadow: "lg", surface: "default", border: "default", children: [suggestionsLoading ? (_jsx(Div, { padding: "inline", children: _jsx(Text, { variant: "secondary", size: "sm", children: labels.searching }) })) : suggestions.length > 0 ? (_jsx(Ul, { children: suggestions.map((suggestion, suggestionIndex) => (_jsx(SuggestionItem, { suggestion: suggestion, itemIndex: getOverlaySuggestionIndex(suggestionIndex), activeIndex: activeIndex, onSelect: handleSuggestionClick, onHover: setActiveIndex, typeIcons: typeIcons, typeBadges: typeBadges }, suggestion.objectID))) })) : null, _jsxs(Button, { type: "button", variant: "ghost", onClick: handleOverlaySearch, onMouseEnter: () => setActiveIndex(overlayItems.length - 1), className: `w-full flex items-center gap-[var(--appkit-space-2)] px-[var(--appkit-space-4)] py-[var(--appkit-space-3)] text-left transition-colors ${activeIndex === overlayItems.length - 1 ? "bg-[var(--appkit-color-surface)] bg-[var(--appkit-color-surface-elevated)]" : CLS_HOVER_ROW}${suggestions.length > 0 ? " border-t border-[var(--appkit-color-border)]" : ""}`, children: [_jsx("svg", { className: CLS_ICON_ROW, fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: SVG_PATH_SEARCH }) }), _jsx(Text, { size: "sm", weight: "medium", children: labels.browseProducts(query) })] })] }))] }))] }) }));
+                                                }, onMouseEnter: () => setActiveIndex(itemIndex), className: `w-full flex items-center gap-[var(--appkit-space-3)] px-[var(--appkit-space-4)] py-[var(--appkit-space-2-5)] text-left transition-colors border-b border-[var(--appkit-color-border)] last:border-b-0 ${isActive ? "bg-[var(--appkit-color-surface-elevated)]" : CLS_HOVER_ROW}`, children: [_jsx(Icon, { className: CLS_ICON_ROW }), _jsx(Text, { size: "sm", weight: "medium", children: link.label })] }) }, link.href));
+                                    }) })] })), query && (_jsxs(Div, { className: `${__O.hidden}`, rounded: "xl", shadow: "lg", surface: "default", border: "default", children: [suggestionsLoading ? (_jsx(Div, { padding: "inline", children: _jsx(Text, { variant: "secondary", size: "sm", children: labels.searching }) })) : suggestions.length > 0 ? (_jsx(Ul, { children: suggestions.map((suggestion, suggestionIndex) => (_jsx(SuggestionItem, { suggestion: suggestion, itemIndex: getOverlaySuggestionIndex(suggestionIndex), activeIndex: activeIndex, onSelect: handleSuggestionClick, onHover: setActiveIndex, typeIcons: typeIcons, typeBadges: typeBadges }, suggestion.objectID))) })) : null, _jsxs(Button, { type: "button", variant: "ghost", onClick: handleOverlaySearch, onMouseEnter: () => setActiveIndex(overlayItems.length - 1), className: `w-full flex items-center gap-[var(--appkit-space-2)] px-[var(--appkit-space-4)] py-[var(--appkit-space-3)] text-left transition-colors ${activeIndex === overlayItems.length - 1 ? "bg-[var(--appkit-color-surface-elevated)]" : CLS_HOVER_ROW}${suggestions.length > 0 ? " border-t border-[var(--appkit-color-border)]" : ""}`, children: [_jsx("svg", { className: CLS_ICON_ROW, fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: SVG_PATH_SEARCH }) }), _jsx(Text, { size: "sm", weight: "medium", children: labels.browseProducts(query) })] })] }))] }))] }) }));
 }

package/dist/features/search/components/SearchResultsClient.js

@@ -84,9 +84,24 @@ export function SearchResultsClient({ q, initialResult, indexEnabled, isSignedIn
             setSelectedFacets([]);
     }, [usingLocal, selectedFacets.length]);
     const waiting = local.status === "loading" && q.trim().length > 0;
-    return (_jsx(SearchResultsPageView, { result: waiting ? { ...result, groups: [], totalHits: 0 } : result, footnote: usingLocal && local.builtAt
-            ? `Catalogue index updated ${new Date(local.builtAt).toLocaleString()}.`
-            : undefined, renderAboveGroups: () => (_jsxs(_Fragment, { children: [waiting && _jsx(Text, { color: "muted", children: "Searching\u2026" }), usingLocal && (_jsx(SearchFacetRail, { facets: local.facets, selected: selectedFacets, onToggle: toggleFacet })), scoped.status === "failed" && (
+    return (_jsx(SearchResultsPageView, { result: waiting ? { ...result, groups: [], totalHits: 0 } : result, 
+        /*
+         * 🛑 NO FOOTNOTE. This read "Catalogue index updated 19/10/2026,
+         * 16:21:48." underneath a shopper's search results.
+         *
+         * It is an implementation detail of how the client-side index is built,
+         * phrased in our vocabulary, and a shopper can do nothing with it. Worse
+         * than useless: a visible timestamp implies the results might be STALE,
+         * on the one surface where a shopper needs to trust that what they see
+         * is what we have.
+         *
+         * The two messages below are kept, and the contrast is the point —
+         * "couldn't search your account" and the index-failure line both tell
+         * the user something that changes what they should believe about the
+         * results in front of them. A build timestamp on a SUCCESSFUL search
+         * does not.
+         */
+        renderAboveGroups: () => (_jsxs(_Fragment, { children: [waiting && _jsx(Text, { color: "muted", children: "Searching\u2026" }), usingLocal && (_jsx(SearchFacetRail, { facets: local.facets, selected: selectedFacets, onToggle: toggleFacet })), scoped.status === "failed" && (
                 /*
                  * Said out loud, for the same reason as the line below it. A
                  * seller whose draft is missing because the scoped fetch failed