@mohasinac/appkit 4.47.0 → 4.48.1

package/dist/constants/api-endpoints.js

@@ -381,6 +381,35 @@ export const AD_ENDPOINTS = {
     ACTIVE_BY_SLOT: (slotId) => `/api/ads?slot=${encodeURIComponent(slotId)}`,
 };
 // ---------------------------------------------------------------------------
+// Messages — D9 chat
+// ---------------------------------------------------------------------------
+export const MESSAGE_ENDPOINTS = {
+    LIST: (opts) => {
+        const params = new URLSearchParams();
+        if (opts?.limit !== undefined)
+            params.set("limit", String(opts.limit));
+        if (opts?.cursor)
+            params.set("cursor", opts.cursor);
+        const qs = params.toString();
+        return `/api/messages${qs ? `?${qs}` : ""}`;
+    },
+    OPEN: "/api/messages",
+    OPEN_WITH_SELLER: "/api/messages/with-seller",
+    THREAD: (conversationId, opts) => {
+        const params = new URLSearchParams();
+        if (opts?.limit !== undefined)
+            params.set("limit", String(opts.limit));
+        if (opts?.cursor)
+            params.set("cursor", opts.cursor);
+        const qs = params.toString();
+        return `/api/messages/${conversationId}${qs ? `?${qs}` : ""}`;
+    },
+    READ: (conversationId) => `/api/messages/${conversationId}/read`,
+    BLOCK: (conversationId) => `/api/messages/${conversationId}/block`,
+    TOKEN: (conversationId) => `/api/messages/${conversationId}/token`,
+    UNREAD_COUNT: "/api/messages/unread-count",
+};
+// ---------------------------------------------------------------------------
 // Events
 // ---------------------------------------------------------------------------
 export const EVENT_ENDPOINTS = {
@@ -680,6 +709,7 @@ export const API_ENDPOINTS = {
     CORPORATE: CORPORATE_ENDPOINTS,
     CONTACT: CONTACT_ENDPOINTS,
     ADS: AD_ENDPOINTS,
+    MESSAGES: MESSAGE_ENDPOINTS,
     EVENTS: EVENT_ENDPOINTS,
     LOTTERY: LOTTERY_ENDPOINTS,
     FAQS: FAQ_ENDPOINTS,

package/dist/constants/notification-types.d.ts

@@ -29,7 +29,7 @@ import type { NotificationType } from "../features/admin/schemas/firestore";
 export { NOTIFICATION_TYPE_VALUES };
 export type { NotificationType };
 /** Alias kept for the two existing importers. */
-export declare const NOTIFICATION_TYPES: readonly ["order_placed", "order_confirmed", "order_shipped", "order_delivered", "order_cancelled", "bid_placed", "bid_outbid", "bid_won", "bid_lost", "auction_ended", "review_approved", "review_replied", "product_available", "promotion", "system", "welcome", "account_action", "support_ticket_update", "scam_report_update", "offer_received", "offer_responded", "offer_expired", "offer_counter_accepted", "refund_initiated", "prize_won", "prize_reveal_expired", "emi_installment_due_soon", "emi_installment_overdue", "payment_review", "catalogue_images_stale"];
+export declare const NOTIFICATION_TYPES: readonly ["order_placed", "order_confirmed", "order_shipped", "order_delivered", "order_cancelled", "bid_placed", "bid_outbid", "bid_won", "bid_lost", "auction_ended", "review_approved", "review_replied", "product_available", "promotion", "system", "welcome", "account_action", "support_ticket_update", "scam_report_update", "offer_received", "offer_responded", "offer_expired", "offer_counter_accepted", "refund_initiated", "prize_won", "prize_reveal_expired", "emi_installment_due_soon", "emi_installment_overdue", "payment_review", "catalogue_images_stale", "message_received"];
 /**
  * `order_shipped` → `Order shipped`.
  *

package/dist/features/about/components/GstExplainerView.d.ts

@@ -0,0 +1,28 @@
+export interface GstExplainerViewProps {
+}
+/**
+ * D6b — how GST works on LetItRip, for buyers and for sellers.
+ *
+ * ## 🛑 Why this page is a differentiator rather than table stakes
+ *
+ * The round-2 crawl checked seventeen Indian collectibles sites. Exactly ONE
+ * (`otakuisland.in`) states tax-inclusive pricing to the buyer in words — *"All
+ * prices include GST and there are no hidden charges."* The other sixteen say
+ * nothing at all, which means a buyer cannot tell whether the number on the card
+ * is what they will pay. Saying it plainly, with the rate bands and who bears
+ * what, is the cheapest trust signal available here.
+ *
+ * ## 🛑 What this page deliberately does NOT claim
+ *
+ * It does not say "your invoice carries GST today". Charging GST requires a
+ * registered GSTIN on `siteSettings.gst`, and `validateGstEnablement` runs a
+ * real checksum and refuses an invented one — so until that is entered, orders
+ * compute tax at 0 and the Tax row does not render. A page asserting otherwise
+ * would be a false statement about a compliance matter, which is the one place
+ * this codebase cannot afford confident prose. Everything below is written as
+ * "when GST applies", which is true either way.
+ *
+ * Every figure traces to the model written down in the plan's C0b/C0c and to
+ * `taxCodes` — nothing here is an invented rate.
+ */
+export declare function GstExplainerView({}?: GstExplainerViewProps): Promise<import("react").JSX.Element>;

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

@@ -0,0 +1,59 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ROUTES } from "../../../constants/index.js";
+import { PAGE_CONTAINER } from "../../../_internal/shared/styles/page.js";
+import { THEMED_BG_PRIMARY, THEMED_BG_SECONDARY } from "../../../_internal/shared/styles/themed.js";
+import { Alert, Caption, Div, Heading, Row, Section, Stack, Table, Tbody, Td, Text, TextLink, Th, Thead, Tr, } from "../../../ui/index.js";
+const __P = {
+    p5: "p-[var(--appkit-space-5)]",
+};
+const __O = {
+    xAuto: "overflow-x-auto",
+};
+/**
+ * D6b — how GST works on LetItRip, for buyers and for sellers.
+ *
+ * ## 🛑 Why this page is a differentiator rather than table stakes
+ *
+ * The round-2 crawl checked seventeen Indian collectibles sites. Exactly ONE
+ * (`otakuisland.in`) states tax-inclusive pricing to the buyer in words — *"All
+ * prices include GST and there are no hidden charges."* The other sixteen say
+ * nothing at all, which means a buyer cannot tell whether the number on the card
+ * is what they will pay. Saying it plainly, with the rate bands and who bears
+ * what, is the cheapest trust signal available here.
+ *
+ * ## 🛑 What this page deliberately does NOT claim
+ *
+ * It does not say "your invoice carries GST today". Charging GST requires a
+ * registered GSTIN on `siteSettings.gst`, and `validateGstEnablement` runs a
+ * real checksum and refuses an invented one — so until that is entered, orders
+ * compute tax at 0 and the Tax row does not render. A page asserting otherwise
+ * would be a false statement about a compliance matter, which is the one place
+ * this codebase cannot afford confident prose. Everything below is written as
+ * "when GST applies", which is true either way.
+ *
+ * Every figure traces to the model written down in the plan's C0b/C0c and to
+ * `taxCodes` — nothing here is an invented rate.
+ */
+export async function GstExplainerView({} = {}) {
+    const page = { container: PAGE_CONTAINER };
+    const themed = { bgPrimary: THEMED_BG_PRIMARY, bgSecondary: THEMED_BG_SECONDARY };
+    const { getTranslations } = await import("next-intl/server");
+    const t = await getTranslations("gstGuide");
+    /*
+     * The rate bands, which are a property of the HSN code a category carries —
+     * not of the seller and not of the buyer's state. Stated as bands rather than
+     * as one number because the catalogue genuinely spans three.
+     */
+    const RATE_ROWS = [
+        { band: t("band1Label"), rate: "0%", examples: t("band1Examples"), hsn: "—" },
+        { band: t("band2Label"), rate: "5%", examples: t("band2Examples"), hsn: "9503 0020" },
+        { band: t("band3Label"), rate: "18%", examples: t("band3Examples"), hsn: "9503 0010" },
+    ];
+    const WHO_PAYS = [
+        { line: t("whoPays1Item"), who: t("whoPays1Who"), note: t("whoPays1Note") },
+        { line: t("whoPays2Item"), who: t("whoPays2Who"), note: t("whoPays2Note") },
+        { line: t("whoPays3Item"), who: t("whoPays3Who"), note: t("whoPays3Note") },
+        { line: t("whoPays4Item"), who: t("whoPays4Who"), note: t("whoPays4Note") },
+    ];
+    return (_jsxs(Div, { children: [_jsx(Section, { className: themed.bgPrimary, padding: "y-2xl", children: _jsxs(Div, { className: page.container.lg, children: [_jsx(Heading, { level: 1, size: "3xl", mdSize: "4xl", weight: "bold", className: "mb-3", children: t("title") }), _jsx(Text, { size: "lg", color: "muted", className: "max-w-3xl", children: t("intro") })] }) }), _jsx(Section, { padding: "y-xl", children: _jsxs(Div, { className: page.container.lg, children: [_jsxs(Alert, { variant: "info", className: "mb-8", children: [_jsx(Text, { weight: "semibold", children: t("inclusiveTitle") }), _jsx(Text, { size: "sm", children: t("inclusiveText") })] }), _jsx(Heading, { level: 2, size: "xl", weight: "semibold", className: "mb-4", children: t("ratesTitle") }), _jsx(Text, { color: "muted", className: "mb-4 max-w-3xl", children: t("ratesIntro") }), _jsx(Div, { className: __O.xAuto, children: _jsxs(Table, { size: "sm", children: [_jsx(Thead, { children: _jsxs(Tr, { border: "default", children: [_jsx(Th, { children: t("colBand") }), _jsx(Th, { children: t("colRate") }), _jsx(Th, { children: t("colExamples") }), _jsx(Th, { children: t("colHsn") })] }) }), _jsx(Tbody, { children: RATE_ROWS.map((r) => (_jsxs(Tr, { border: "subtle", children: [_jsx(Td, { padding: "sm", children: r.band }), _jsx(Td, { padding: "sm", children: _jsx(Text, { weight: "semibold", children: r.rate }) }), _jsx(Td, { padding: "sm", color: "muted", children: r.examples }), _jsx(Td, { padding: "sm", color: "muted", children: r.hsn })] }, r.band))) })] }) }), _jsx(Caption, { className: "mt-2", children: t("ratesCaption") })] }) }), _jsx(Section, { className: themed.bgSecondary, padding: "y-xl", children: _jsxs(Div, { className: page.container.lg, children: [_jsx(Heading, { level: 2, size: "xl", weight: "semibold", className: "mb-4", children: t("whoPaysTitle") }), _jsx(Div, { className: __O.xAuto, children: _jsxs(Table, { size: "sm", children: [_jsx(Thead, { children: _jsxs(Tr, { border: "default", children: [_jsx(Th, { children: t("colLine") }), _jsx(Th, { children: t("colWho") }), _jsx(Th, { children: t("colNote") })] }) }), _jsx(Tbody, { children: WHO_PAYS.map((r) => (_jsxs(Tr, { border: "subtle", children: [_jsx(Td, { padding: "sm", children: r.line }), _jsx(Td, { padding: "sm", children: _jsx(Text, { weight: "semibold", children: r.who }) }), _jsx(Td, { padding: "sm", color: "muted", children: r.note })] }, r.line))) })] }) })] }) }), _jsx(Section, { padding: "y-xl", children: _jsxs(Div, { className: page.container.lg, children: [_jsxs(Stack, { gap: "lg", children: [_jsxs(Div, { className: __P.p5, surface: "card", rounded: "xl", border: "subtle", children: [_jsx(Heading, { level: 3, size: "lg", weight: "semibold", className: "mb-2", children: t("splitTitle") }), _jsx(Text, { color: "muted", children: t("splitText") })] }), _jsxs(Div, { className: __P.p5, surface: "card", rounded: "xl", border: "subtle", children: [_jsx(Heading, { level: 3, size: "lg", weight: "semibold", className: "mb-2", children: t("invoiceTitle") }), _jsx(Text, { color: "muted", children: t("invoiceText") })] }), _jsxs(Div, { className: __P.p5, surface: "card", rounded: "xl", border: "subtle", children: [_jsx(Heading, { level: 3, size: "lg", weight: "semibold", className: "mb-2", children: t("sellerTitle") }), _jsx(Text, { color: "muted", children: t("sellerText") })] })] }), _jsxs(Row, { gap: "md", wrap: true, className: "mt-8", children: [_jsx(TextLink, { href: String(ROUTES.PUBLIC.FEES), children: t("linkFees") }), _jsx(TextLink, { href: String(ROUTES.PUBLIC.HOW_PAYOUTS_WORK), children: t("linkPayouts") }), _jsx(TextLink, { href: String(ROUTES.PUBLIC.FAQS), children: t("linkFaqs") })] })] }) })] }));
+}

package/dist/features/about/components/GuidesHubView.d.ts

@@ -0,0 +1,28 @@
+/**
+ * D6 — the content hub: every explainer this site owns, in one place.
+ *
+ * ## 🛑 Why an index page is worth its own route here
+ *
+ * There are **fourteen** explainers (`/how-auctions-work` … `/fees`, `/gst`,
+ * `/spot-a-fake`, the two seller guides) and the only way to reach most of them
+ * is the footer. A footer link is reachable but it is not a *destination*: it
+ * cannot rank, it cannot be linked to from a blog post as "our guides", and it
+ * gives a crawler no page that establishes the topical cluster these fourteen
+ * form. worldhobbyshop's measured SEO edge is category bodies plus internal
+ * linking depth, and this is the cheapest internal-linking structure available
+ * — one page that links fourteen, each of which links back.
+ *
+ * ## 🛑 The list is hand-curated and that is deliberate
+ *
+ * It would be tidier to derive it from `FOOTER_LINK_GROUPS`, and wrong: that
+ * array mixes browse surfaces, legal pages and dashboards with the explainers,
+ * so deriving would need a filter which is itself a second hand-maintained
+ * list — one keyed on nothing. A guide either belongs in a learning index or it
+ * does not, and that is an editorial judgement, not a derivation.
+ *
+ * Every href is a `ROUTES` constant, so `audit-nav-page-wiring` fails the build
+ * if any of them stops resolving to a real page.
+ */
+export interface GuidesHubViewProps {
+}
+export declare function GuidesHubView({}?: GuidesHubViewProps): Promise<import("react").JSX.Element>;

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

@@ -0,0 +1,58 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ROUTES } from "../../../constants/index.js";
+import { PAGE_CONTAINER } from "../../../_internal/shared/styles/page.js";
+import { THEMED_BG_PRIMARY } from "../../../_internal/shared/styles/themed.js";
+import { Div, Grid, Heading, Section, Text, TextLink } from "../../../ui/index.js";
+const __P = {
+    p5: "p-[var(--appkit-space-5)]",
+};
+export async function GuidesHubView({} = {}) {
+    const page = { container: PAGE_CONTAINER };
+    const { getTranslations } = await import("next-intl/server");
+    const t = await getTranslations("guidesHub");
+    const GROUPS = [
+        {
+            heading: t("groupBuyingTitle"),
+            blurb: t("groupBuyingBlurb"),
+            items: [
+                { href: String(ROUTES.PUBLIC.HOW_AUCTIONS_WORK), label: t("howAuctions"), text: t("howAuctionsText") },
+                { href: String(ROUTES.PUBLIC.HOW_OFFERS_WORK), label: t("howOffers"), text: t("howOffersText") },
+                { href: String(ROUTES.PUBLIC.HOW_PRE_ORDERS_WORK), label: t("howPreOrders"), text: t("howPreOrdersText") },
+                { href: String(ROUTES.PUBLIC.HOW_CHECKOUT_WORKS), label: t("howCheckout"), text: t("howCheckoutText") },
+                { href: String(ROUTES.PUBLIC.HOW_EMI_WORKS), label: t("howEmi"), text: t("howEmiText") },
+                { href: String(ROUTES.PUBLIC.HOW_ORDERS_WORK), label: t("howOrders"), text: t("howOrdersText") },
+            ],
+        },
+        {
+            heading: t("groupMoneyTitle"),
+            blurb: t("groupMoneyBlurb"),
+            items: [
+                { href: String(ROUTES.PUBLIC.FEES), label: t("fees"), text: t("feesText") },
+                { href: String(ROUTES.PUBLIC.GST), label: t("gst"), text: t("gstText") },
+                { href: String(ROUTES.PUBLIC.HOW_PAYOUTS_WORK), label: t("howPayouts"), text: t("howPayoutsText") },
+                { href: String(ROUTES.PUBLIC.SHIPPING_POLICY), label: t("shipping"), text: t("shippingText") },
+                { href: String(ROUTES.PUBLIC.REFUND_POLICY), label: t("refunds"), text: t("refundsText") },
+            ],
+        },
+        {
+            heading: t("groupTrustTitle"),
+            blurb: t("groupTrustBlurb"),
+            items: [
+                { href: String(ROUTES.PUBLIC.SPOT_A_FAKE), label: t("spotAFake"), text: t("spotAFakeText") },
+                { href: String(ROUTES.PUBLIC.SCAMS), label: t("scams"), text: t("scamsText") },
+                { href: String(ROUTES.PUBLIC.HOW_REVIEWS_WORK), label: t("howReviews"), text: t("howReviewsText") },
+                { href: String(ROUTES.PUBLIC.SECURITY), label: t("security"), text: t("securityText") },
+            ],
+        },
+        {
+            heading: t("groupSellingTitle"),
+            blurb: t("groupSellingBlurb"),
+            items: [
+                { href: String(ROUTES.PUBLIC.SELLER_GUIDE), label: t("sellerGuide"), text: t("sellerGuideText") },
+                { href: String(ROUTES.PUBLIC.SELLER_GUIDE_BUNDLES), label: t("bundleGuide"), text: t("bundleGuideText") },
+                { href: String(ROUTES.PUBLIC.SELLER_GUIDE_PRIZE_DRAWS), label: t("prizeDrawGuide"), text: t("prizeDrawGuideText") },
+            ],
+        },
+    ];
+    return (_jsxs(Div, { children: [_jsx(Section, { className: THEMED_BG_PRIMARY, padding: "y-2xl", children: _jsxs(Div, { className: page.container.lg, children: [_jsx(Heading, { level: 1, size: "3xl", mdSize: "4xl", weight: "bold", className: "mb-3", children: t("title") }), _jsx(Text, { size: "lg", color: "muted", className: "max-w-3xl", children: t("intro") })] }) }), GROUPS.map((g) => (_jsx(Section, { padding: "y-xl", children: _jsxs(Div, { className: page.container.lg, children: [_jsx(Heading, { level: 2, size: "xl", weight: "semibold", className: "mb-1", children: g.heading }), _jsx(Text, { color: "muted", className: "mb-4", children: g.blurb }), _jsx(Grid, { cols: "cards", gap: "md", children: g.items.map((i) => (_jsxs(Div, { className: __P.p5, surface: "card", rounded: "xl", border: "subtle", children: [_jsx(TextLink, { href: i.href, weight: "semibold", children: i.label }), _jsx(Text, { size: "sm", color: "muted", className: "mt-1", children: i.text })] }, i.href))) })] }) }, g.heading)))] }));
+}

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

@@ -30,6 +30,11 @@ function toProductItem(p) {
         slug: p.slug,
         description: p.description,
         price: p.price,
+        /* The strike-through "was" price. The SHARED `toProductItem` already
+         * carried it and this local copy did not, so a discounted listing lost
+         * its saving on a public profile — the exact drift the comment below
+         * warns about, demonstrated once. */
+        originalPrice: p.originalPrice,
         currency: p.currency,
         mainImage: p.mainImage,
         images: p.images,

package/dist/features/about/components/SpotAFakeView.d.ts

@@ -0,0 +1,29 @@
+export interface SpotAFakeViewProps {
+}
+/**
+ * D6 — the spot-a-fake guide.
+ *
+ * ## 🛑 The framing is the finding, and it is not the obvious one
+ *
+ * The crawl's counterfeit intelligence (plan section 3.7) measured something
+ * counter-intuitive: the largest seller of copies in this market makes **ZERO
+ * authenticity claims**. It sells itself as an "aftermarket brand" at a
+ * fraction of the real price and leaves the inference to the buyer. So a guide
+ * written as "here is how they pretend to be real" would be describing a
+ * deception that is not happening, and would teach the wrong signals.
+ *
+ * What actually distinguishes them is silence plus price, then code, then
+ * weight — which is why this page is ordered that way and why the authenticity
+ * section explains that **"unknown" is a legitimate answer**. A guide that
+ * treated every non-original as a fraud would push honest second-hand sellers
+ * into overclaiming, which makes the catalogue less truthful, not more.
+ *
+ * ## 🛑 Every signal here is one the SITE can back up
+ *
+ * The price band comes from the realised-price index, the printed codes come
+ * from the canonical corpus, and the part weights come from the part glossary —
+ * 963 slots carrying their weight as fitted. A guide that said "check the
+ * weight" without somewhere to check it against would be advice shaped like
+ * help, so each signal links to the surface that answers it.
+ */
+export declare function SpotAFakeView({}?: SpotAFakeViewProps): Promise<import("react").JSX.Element>;

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

@@ -0,0 +1,49 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ROUTES } from "../../../constants/index.js";
+import { PAGE_CONTAINER } from "../../../_internal/shared/styles/page.js";
+import { THEMED_BG_PRIMARY, THEMED_BG_SECONDARY } from "../../../_internal/shared/styles/themed.js";
+import { Alert, Div, Heading, Row, Section, Stack, Text, TextLink, } from "../../../ui/index.js";
+const __P = {
+    p5: "p-[var(--appkit-space-5)]",
+};
+/**
+ * D6 — the spot-a-fake guide.
+ *
+ * ## 🛑 The framing is the finding, and it is not the obvious one
+ *
+ * The crawl's counterfeit intelligence (plan section 3.7) measured something
+ * counter-intuitive: the largest seller of copies in this market makes **ZERO
+ * authenticity claims**. It sells itself as an "aftermarket brand" at a
+ * fraction of the real price and leaves the inference to the buyer. So a guide
+ * written as "here is how they pretend to be real" would be describing a
+ * deception that is not happening, and would teach the wrong signals.
+ *
+ * What actually distinguishes them is silence plus price, then code, then
+ * weight — which is why this page is ordered that way and why the authenticity
+ * section explains that **"unknown" is a legitimate answer**. A guide that
+ * treated every non-original as a fraud would push honest second-hand sellers
+ * into overclaiming, which makes the catalogue less truthful, not more.
+ *
+ * ## 🛑 Every signal here is one the SITE can back up
+ *
+ * The price band comes from the realised-price index, the printed codes come
+ * from the canonical corpus, and the part weights come from the part glossary —
+ * 963 slots carrying their weight as fitted. A guide that said "check the
+ * weight" without somewhere to check it against would be advice shaped like
+ * help, so each signal links to the surface that answers it.
+ */
+export async function SpotAFakeView({} = {}) {
+    const page = { container: PAGE_CONTAINER };
+    const themed = { bgPrimary: THEMED_BG_PRIMARY, bgSecondary: THEMED_BG_SECONDARY };
+    const { getTranslations } = await import("next-intl/server");
+    const t = await getTranslations("spotAFake");
+    const SIGNALS = [
+        { n: 1, title: t("signal1Title"), text: t("signal1Text"), href: String(ROUTES.PUBLIC.TOOL_PRICE_INDEX) },
+        { n: 2, title: t("signal2Title"), text: t("signal2Text"), href: null },
+        { n: 3, title: t("signal3Title"), text: t("signal3Text"), href: String(ROUTES.PUBLIC.PARTS) },
+        { n: 4, title: t("signal4Title"), text: t("signal4Text"), href: null },
+        { n: 5, title: t("signal5Title"), text: t("signal5Text"), href: null },
+        { n: 6, title: t("signal6Title"), text: t("signal6Text"), href: null },
+    ];
+    return (_jsxs(Div, { children: [_jsx(Section, { className: themed.bgPrimary, padding: "y-2xl", children: _jsxs(Div, { className: page.container.lg, children: [_jsx(Heading, { level: 1, size: "3xl", mdSize: "4xl", weight: "bold", className: "mb-3", children: t("title") }), _jsx(Text, { size: "lg", color: "muted", className: "max-w-3xl", children: t("intro") })] }) }), _jsx(Section, { padding: "y-xl", children: _jsxs(Div, { className: page.container.lg, children: [_jsxs(Alert, { variant: "warning", className: "mb-8", children: [_jsx(Text, { weight: "semibold", children: t("whyTitle") }), _jsx(Text, { size: "sm", children: t("whyText") })] }), _jsx(Heading, { level: 2, size: "xl", weight: "semibold", className: "mb-4", children: t("signalsTitle") }), _jsx(Stack, { gap: "md", children: SIGNALS.map((s) => (_jsxs(Div, { className: __P.p5, surface: "card", rounded: "xl", border: "subtle", children: [_jsx(Heading, { level: 3, size: "lg", weight: "semibold", className: "mb-1", children: `${s.n}. ${s.title}` }), _jsx(Text, { color: "muted", children: s.text }), s.href && (_jsx(Div, { padding: "t-xs", children: _jsx(TextLink, { href: s.href, size: "sm", children: s.n === 1 ? t("linkTools") : t("linkParts") }) }))] }, s.n))) })] }) }), _jsx(Section, { className: themed.bgSecondary, padding: "y-xl", children: _jsx(Div, { className: page.container.lg, children: _jsxs(Stack, { gap: "lg", children: [_jsxs(Div, { className: __P.p5, surface: "card", rounded: "xl", border: "subtle", children: [_jsx(Heading, { level: 3, size: "lg", weight: "semibold", className: "mb-2", children: t("authenticityTitle") }), _jsx(Text, { color: "muted", children: t("authenticityText") })] }), _jsxs(Div, { className: __P.p5, surface: "card", rounded: "xl", border: "subtle", children: [_jsx(Heading, { level: 3, size: "lg", weight: "semibold", className: "mb-2", children: t("reportTitle") }), _jsx(Text, { color: "muted", children: t("reportText") }), _jsxs(Row, { gap: "md", wrap: true, className: "mt-3", children: [_jsx(TextLink, { href: String(ROUTES.PUBLIC.REPORT_ENTITY), children: t("linkReport") }), _jsx(TextLink, { href: String(ROUTES.PUBLIC.SCAMS), children: t("linkScams") })] })] })] }) }) })] }));
+}

package/dist/features/admin/actions/notification-actions.js

@@ -246,6 +246,10 @@ export async function sendNotification(input) {
          */
         support_ticket_update: "system",
         scam_report_update: "system",
+        // D9 — same reasoning: a tenth key would have no stored value on any
+        // existing user, and a chat message is a reply to a thread the user is
+        // already a participant in, not something to silence independently.
+        message_received: "system",
     };
     const typeKey = typeToPrefsKey[type];
     // If the user has explicitly disabled this notification type, skip all external channels.

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

@@ -4,7 +4,7 @@
  */
 import type { AboutContentDocument } from "../../about/schemas/firestore";
 export declare const ADMIN_CHECKOUT_BYPASS_FLAG_KEY: "adminCheckoutBypass";
-export declare const NOTIFICATION_TYPE_VALUES: readonly ["order_placed", "order_confirmed", "order_shipped", "order_delivered", "order_cancelled", "bid_placed", "bid_outbid", "bid_won", "bid_lost", "auction_ended", "review_approved", "review_replied", "product_available", "promotion", "system", "welcome", "account_action", "support_ticket_update", "scam_report_update", "offer_received", "offer_responded", "offer_expired", "offer_counter_accepted", "refund_initiated", "prize_won", "prize_reveal_expired", "emi_installment_due_soon", "emi_installment_overdue", "payment_review", "catalogue_images_stale"];
+export declare const NOTIFICATION_TYPE_VALUES: readonly ["order_placed", "order_confirmed", "order_shipped", "order_delivered", "order_cancelled", "bid_placed", "bid_outbid", "bid_won", "bid_lost", "auction_ended", "review_approved", "review_replied", "product_available", "promotion", "system", "welcome", "account_action", "support_ticket_update", "scam_report_update", "offer_received", "offer_responded", "offer_expired", "offer_counter_accepted", "refund_initiated", "prize_won", "prize_reveal_expired", "emi_installment_due_soon", "emi_installment_overdue", "payment_review", "catalogue_images_stale", "message_received"];
 export type NotificationType = (typeof NOTIFICATION_TYPE_VALUES)[number];
 /**
  * What a notification points AT. Drives the shared `actionUrl` resolver, so a
@@ -14,7 +14,7 @@ export type NotificationType = (typeof NOTIFICATION_TYPE_VALUES)[number];
  * Runtime array for the same reason as the type union above — and
  * `catalogueItem` was being sent with an `as never` cast rather than added.
  */
-export declare const NOTIFICATION_RELATED_TYPE_VALUES: readonly ["order", "product", "bid", "review", "blog", "user", "offer", "support_ticket", "scammer", "catalogueItem", "payout", "store"];
+export declare const NOTIFICATION_RELATED_TYPE_VALUES: readonly ["order", "product", "bid", "review", "blog", "user", "offer", "support_ticket", "scammer", "catalogueItem", "payout", "store", "conversation"];
 export type NotificationRelatedType = (typeof NOTIFICATION_RELATED_TYPE_VALUES)[number];
 import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 export type NotificationPriority = "low" | "normal" | "high";
@@ -77,7 +77,7 @@ export type NotificationUpdateInput = Partial<Pick<NotificationDocument, "isRead
 export declare const notificationQueryHelpers: {
     readonly byUser: (userId: string) => readonly ["userId", "==", string];
     readonly unread: (userId: string) => readonly [readonly ["userId", "==", string], readonly ["isRead", "==", false]];
-    readonly byType: (type: NotificationType) => readonly ["type", "==", "welcome" | "promotion" | "order_placed" | "order_confirmed" | "order_shipped" | "order_delivered" | "order_cancelled" | "bid_placed" | "bid_outbid" | "bid_won" | "bid_lost" | "auction_ended" | "review_approved" | "review_replied" | "product_available" | "system" | "account_action" | "support_ticket_update" | "scam_report_update" | "offer_received" | "offer_responded" | "offer_expired" | "offer_counter_accepted" | "refund_initiated" | "prize_won" | "prize_reveal_expired" | "emi_installment_due_soon" | "emi_installment_overdue" | "payment_review" | "catalogue_images_stale"];
+    readonly byType: (type: NotificationType) => readonly ["type", "==", "welcome" | "promotion" | "order_placed" | "order_confirmed" | "order_shipped" | "order_delivered" | "order_cancelled" | "bid_placed" | "bid_outbid" | "bid_won" | "bid_lost" | "auction_ended" | "review_approved" | "review_replied" | "product_available" | "system" | "account_action" | "support_ticket_update" | "scam_report_update" | "offer_received" | "offer_responded" | "offer_expired" | "offer_counter_accepted" | "refund_initiated" | "prize_won" | "prize_reveal_expired" | "emi_installment_due_soon" | "emi_installment_overdue" | "payment_review" | "catalogue_images_stale" | "message_received"];
 };
 export interface TrustBarItem {
     icon: string;
@@ -515,6 +515,16 @@ export interface SiteSettingsDocument extends BaseDocument {
             sms: number;
         };
     };
+    /**
+     * D9 — chat. Off by default, and `undefined` reads as OFF (never a
+     * default-true `??`) — a real setting with a real cost: every conversation
+     * is a Firestore subcollection plus an RTDB ping channel, and the feature
+     * was deleted once already for shipping broken and earning low usage it
+     * never had a chance to prove.
+     */
+    chat?: {
+        enabled: boolean;
+    };
     emailSettings: {
         fromName: string;
         fromEmail: string;

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

@@ -84,6 +84,12 @@ export const NOTIFICATION_TYPE_VALUES = [
     // it stayed off this union: the cast silenced the one signal that would
     // have said so, and with it every other field's type-check on that call.
     "catalogue_images_stale",
+    /**
+     * D9 — a new chat message. Bell-only — `EMAIL_ELIGIBLE_TYPES` is `false`,
+     * following `support_ticket_update`'s recorded reasoning: the conversation
+     * lives in the UI, not the inbox.
+     */
+    "message_received",
 ];
 /**
  * What a notification points AT. Drives the shared `actionUrl` resolver, so a
@@ -106,6 +112,8 @@ export const NOTIFICATION_RELATED_TYPE_VALUES = [
     "catalogueItem",
     "payout",
     "store",
+    // D9 — the chat thread the message belongs to.
+    "conversation",
 ];
 export const NOTIFICATIONS_COLLECTION = "notifications";
 export const NOTIFICATIONS_INDEXED_FIELDS = [

package/dist/features/blog/repository/blog.repository.js

@@ -5,7 +5,7 @@ import { BLOG_POST_FIELDS, BLOG_POSTS_COLLECTION, } from "../schemas/index.js";
 import { createBlogPostId } from "../schemas/index.js";
 import { increment } from "../../../contracts/field-ops.js";
 import { buildBlogSearchTxt } from "../../../utils/search-txt-builders.js";
-import { planSearchTxt, refineSearchTxt, emptySearchResult, } from "../../../utils/search-txt-query.js";
+import { planSearchTxt, beginSearchWindow, emptySearchResult, } from "../../../utils/search-txt-query.js";
 class BlogRepository extends BaseRepository {
     constructor() {
         super(BLOG_POSTS_COLLECTION);
@@ -172,12 +172,19 @@ class BlogRepository extends BaseRepository {
         if (plan.head) {
             baseQuery = baseQuery.where(BLOG_POST_FIELDS.SEARCH_TXT, "array-contains", plan.head);
         }
-        const result = await this.sieveQuery(model, BlogRepository.SIEVE_FIELDS, {
+        /*
+         * One bounded window, one raised `maxPageSize`, one page slice — see
+         * `beginSearchWindow`. Hand-writing the three is how the other ten
+         * repositories each ended up with two of them, which reads as a working
+         * multi-word search and silently cannot reach page 2.
+         */
+        const win = beginSearchWindow(model, plan);
+        const result = await this.sieveQuery(win.model, BlogRepository.SIEVE_FIELDS, {
             baseQuery,
             defaultPageSize: 12,
-            maxPageSize: 50,
+            maxPageSize: win.maxPageSize(50),
         });
-        return refineSearchTxt(result, plan.rest);
+        return win.finish(result);
     }
     /** Derived on every write path via `applyWriteHooks`. */
     buildSearchTxtFor(data) {
@@ -191,12 +198,19 @@ class BlogRepository extends BaseRepository {
         if (plan.head) {
             baseQuery = baseQuery.where(BLOG_POST_FIELDS.SEARCH_TXT, "array-contains", plan.head);
         }
-        const result = await this.sieveQuery(model, BlogRepository.SIEVE_FIELDS, {
+        /*
+         * One bounded window, one raised `maxPageSize`, one page slice — see
+         * `beginSearchWindow`. Hand-writing the three is how the other ten
+         * repositories each ended up with two of them, which reads as a working
+         * multi-word search and silently cannot reach page 2.
+         */
+        const win = beginSearchWindow(model, plan);
+        const result = await this.sieveQuery(win.model, BlogRepository.SIEVE_FIELDS, {
             baseQuery,
             defaultPageSize: 50,
-            maxPageSize: 200,
+            maxPageSize: win.maxPageSize(200),
         });
-        return refineSearchTxt(result, plan.rest);
+        return win.finish(result);
     }
 }
 BlogRepository.SIEVE_FIELDS = {

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

@@ -18,11 +18,50 @@ import { mediaUrlSchema } from "../../../validation/schemas.js";
 import { getProviders } from "../../../contracts/index.js";
 import { createRouteHandler } from "../../../next/api/routeHandler.js";
 import { toCategoryListItem } from "../../../_internal/server/features/categories/adapters.js";
+import { categoriesRepository } from "../repository/categories.repository.js";
 import { isListingCategory } from "../constants/listing-categories.js";
 import { planSearchTxt } from "../../../utils/search-txt-query.js";
 import { matchesAllSearchTerms } from "../../../utils/search-txt.js";
 import { normalizeError } from "../../../errors/normalize.js";
 const CACHE_CONTROL_PUBLIC = "public, max-age=3600, s-maxage=3600, stale-while-revalidate=86400";
+/**
+ * Overlay the LIVE rolled-up count onto a projected page of categories.
+ *
+ * 🛑 Why this route and not the grid component: `/categories` renders entirely
+ * client-side from this endpoint (its page.tsx does no Firestore read at all,
+ * deliberately, so the route can stay static), so this is the only server-side
+ * place the numbers it shows pass through. `metrics.totalProductCount` is
+ * written by the nightly reconciler ALONE, so every multi-category surface was
+ * up to a day behind the category's own page, which counts live.
+ *
+ * 🛑 An id with no counts document keeps its `metrics` value. It does NOT
+ * become 0 — a category whose counter has never been written would otherwise
+ * render a confident zero, which is the regression Root Cause #72 names and
+ * would make this change worse than leaving it stale.
+ *
+ * Bounded by construction: the caller has already paginated, and
+ * `getLiveCategoryCounts` hard-caps the batch at 200 ids in ONE `getAll`.
+ */
+async function withLiveTotals(items) {
+    if (items.length === 0)
+        return items;
+    const live = await categoriesRepository.liveTotalsFor(items.map((i) => i.id));
+    if (live.size === 0)
+        return items;
+    return items.map((item) => {
+        const total = live.get(item.id);
+        /*
+         * `metrics` is optional on `CategoryItem`, and an item without it is left
+         * exactly as it is rather than gaining a half-built one — a metrics object
+         * carrying only `totalProductCount` would read as "0 products, N in
+         * total", which is a worse answer than the absent object the renderer
+         * already handles.
+         */
+        if (total === undefined || !item.metrics)
+            return item;
+        return { ...item, metrics: { ...item.metrics, totalProductCount: total } };
+    });
+}
 function buildTreeFromFlat(items, rootId) {
     const byId = new Map(items.map((i) => [i.id, i]));
     // Roots: tier === 0 or no parentIds
@@ -251,6 +290,7 @@ export async function GET(request) {
                     .sort((a, b) => (a.order ?? 0) - (b.order ?? 0))
                     .map(toCategoryListItem);
             }
+            items = await withLiveTotals(items);
             const totalPages = total === 0 ? 0 : Math.max(1, Math.ceil(total / perPage));
             /*
              * Shape switches on `?page=`, deliberately, and only there.
@@ -287,7 +327,7 @@ export async function GET(request) {
         // Project BEFORE nesting — `CategoryTreeNode extends CategoryItem`, so the
         // children carry the public shape too rather than being raw documents
         // reachable one level down.
-        const allItems = allResult.data.map(toCategoryListItem);
+        const allItems = await withLiveTotals(allResult.data.map(toCategoryListItem));
         if (tree === "true" || !flat) {
             const treeNodes = buildTreeFromFlat(allItems, rootId);
             const res = NextResponse.json({ success: true, data: treeNodes });

package/dist/features/categories/components/BreadcrumbTrail.d.ts

@@ -1,11 +1,24 @@
 import React from "react";
 import type { CategoryItem } from "../types";
+import { type BreadcrumbCrumb } from "../utils/breadcrumb-chain";
 export interface BreadcrumbTrailProps {
     /**
-     * The current (leaf) category whose ancestry should be shown as breadcrumbs.
-     * Uses `category.ancestors` if present, otherwise only the category itself.
+     * The chain to render, root-first, with the final crumb carrying no `url`.
+     *
+     * 🛑 PREFER THIS over `category`. It is the same array the page hands to
+     * `breadcrumbJsonLd`, which is what makes the visible trail, the markup and
+     * `categoryNames` agree by construction rather than by discipline — D4b's
+     * rule. Before this prop existed the category page and the product page each
+     * hand-rolled their own `<Nav>`, and the product one rendered three crumbs
+     * (`Home / Products / Category`) while its JSON-LD carried all eight.
+     */
+    crumbs?: readonly BreadcrumbCrumb[];
+    /**
+     * Legacy input: a category whose `ancestors` array becomes the chain.
+     * Kept because it is the published prop shape; `crumbs` wins when both are
+     * passed.
      */
-    category: CategoryItem;
+    category?: CategoryItem;
     /**
      * Label for the implicit root item prepended to the trail.
      * Default: "All Categories"
@@ -31,10 +44,10 @@ export interface BreadcrumbTrailProps {
     /**
      * I5b — collapse the middle of a long trail behind a dropdown.
      *
-     * 🛑 Needed independently of multi-assignment: a tier-4 part leaf is SEVEN
-     * crumbs (`All Categories > Spinning Tops > Beyblade Metal > Metal Parts >
-     * Performance Tips > Rubber Flat`) and 390px cannot hold it. D4b measured
-     * that depth and never addressed how it wraps.
+     * 🛑 Needed independently of multi-assignment: a tier-4 part leaf is EIGHT
+     * crumbs (`Home > Categories > Spinning Tops > Beyblade Metal > Metal Parts >
+     * Performance Tips > Rubber Flat > <title>`) and 390px cannot hold it. D4b
+     * measured that depth and never addressed how it wraps.
      *
      * Defaults ON, because the only trails long enough to collapse are the ones
      * that already overflow.
@@ -51,21 +64,30 @@ export interface BreadcrumbTrailProps {
         ids?: readonly string[] | null;
         names?: readonly string[] | null;
     };
+    /**
+     * `"on-media"` when the trail sits over a cover photo — the category hero
+     * does. Forwarded to the `Breadcrumb` primitive, which owns the ink.
+     */
+    tone?: "default" | "on-media";
 }
 /**
- * BreadcrumbTrail — a category-aware breadcrumb component.
+ * BreadcrumbTrail — one row of crumbs, with the middle and the alternates
+ * collapsed behind real `<details>` dropdowns.
+ *
+ * 🛑 BOTH DROPDOWNS CONTAIN REAL `<a>` ELEMENTS IN THE SERVER-RENDERED DOM.
+ * `<details>`/`<summary>` is native, needs no JavaScript, works on a keyboard,
+ * and — the reason it was chosen over a hover menu — a crawler parsing the HTML
+ * sees every link whether or not anything ever opens it. Links injected on
+ * open would trade the SEO this exists for against tidiness, which is the
+ * opposite of *"better for both crawler and users"*.
  *
- * Renders the full ancestor chain for a category using the `ancestors` array
- * stored on `CategoryItem`. Falls back gracefully when `ancestors` is absent
- * (shows only the root + current category).
+ * 🛑 Collapsing is PRESENTATION ONLY. The JSON-LD is emitted by the page from
+ * the full chain and must stay that way: a crawler never receives a truncated
+ * hierarchy because a phone could not show it.
  *
  * @example
  * ```tsx
- * <BreadcrumbTrail
- * category={category}
- * rootHref="/categories"
- * basePath="/categories"
- * />
+ * <BreadcrumbTrail crumbs={withTrailHead(categoryCrumbs(category), HEAD)} />
  * ```
  */
-export declare function BreadcrumbTrail({ category, rootLabel, rootHref, basePath, showCurrent, className, collapse, alternates, }: BreadcrumbTrailProps): React.JSX.Element;
+export declare function BreadcrumbTrail({ crumbs, category, rootLabel, rootHref, basePath, showCurrent, className, collapse, alternates, tone, }: BreadcrumbTrailProps): React.JSX.Element | null;