@mohasinac/appkit 4.53.0 → 4.53.1

package/dist/_internal/shared/listing-types/stickers/config.js

@@ -22,6 +22,8 @@ export const config = {
     browseRoute: String(ROUTES.PUBLIC.ART),
     // /art ("Art & Stickers") is in MAIN_NAV_ITEMS and spans art + stickers.
     inGeneralCatalogue: false,
+    // THE case this exists for: a sheet plus its individual cut-out stickers
+    canJoinProductGroup: true,
     iconKey: "stickers",
     hideDefault: "sold",
     // Runs out rather than ending — no time dimension, so the shared

package/dist/_internal/shared/search/match.d.ts

@@ -7,6 +7,17 @@ export interface ResolvedEntity {
     readonly detail: string;
     readonly href: string;
     readonly score: number;
+    /**
+     * The record's raw compact facet string (`"lt:auction|br:takara-tomy"`), or
+     * `""`. Carried on the hit so a facet rail can count what the CURRENT result
+     * set contains without going back to the artifact and re-finding each row.
+     *
+     * 🛑 Raw rather than parsed, on purpose. Parsing is `facetsOf(rec)` and it
+     * allocates an array per record; a rail counts over every hit on every
+     * keystroke, and most queries never render one. The consumer parses the
+     * handful it actually needs.
+     */
+    readonly facets: string;
 }
 export interface ResolveOptions {
     readonly limit?: number;

package/dist/_internal/shared/search/match.js

@@ -57,7 +57,7 @@
 import { normalizeSearchText, parseSearchTxtQuery } from "../../../utils/search-txt.js";
 import { aliasVariantsForName } from "./alias-variants.js";
 import { partAliasTokens } from "./part-aliases.js";
-import { facetsOf, hrefFor, REC_DETAIL, REC_TITLE, REC_TYPE, } from "./index-record.js";
+import { facetsOf, hrefFor, REC_DETAIL, REC_FACETS, REC_TITLE, REC_TYPE, } from "./index-record.js";
 /** Field weights. Title dominates; a detail match is corroboration. */
 const W_TITLE = 3;
 const W_DETAIL = 1;
@@ -198,6 +198,7 @@ export function searchIndex(artifact, prepared, query, opts = {}) {
                 title: p.rec[REC_TITLE],
                 detail: p.rec[REC_DETAIL],
                 href: hrefFor(artifact, p.rec),
+                facets: p.rec[REC_FACETS] ?? "",
                 // An alias hit is a weaker signal than a direct one and must not
                 // outrank it when both are present in a later, wider query.
                 score: aliasPass ? score - S_ALIAS : score,

package/dist/_internal/shared/search/to-groups.d.ts

@@ -0,0 +1,52 @@
+import type { SearchEverythingResult, SearchGroup } from "../../server/features/search/search-everything";
+import type { ResolvedEntity } from "./match";
+import type { SearchIndexArtifact } from "./index-record";
+/** Rows shown per group before "see all". Matches the server tier's PER_GROUP. */
+export declare const LOCAL_PER_GROUP = 6;
+export interface ToGroupsOptions {
+    readonly perGroup?: number;
+    /**
+     * `typeKey` -> human heading. REQUIRED, and the artifact deliberately does
+     * not carry it: a label baked into a shared immutable artifact cannot be
+     * translated, and this app is `[locale]`-routed. The caller resolves it
+     * through the label system at render time.
+     */
+    readonly label: (typeKey: string) => string;
+    /** `typeKey` -> the type's browse page, from the artifact's type table. */
+    readonly moreHref: (typeKey: string) => string;
+}
+/**
+ * Group score-ordered hits by type, preserving the order the types first
+ * appear in.
+ *
+ * 🛑 Group ORDER follows the best hit in each group, not the type table's
+ * `weight`. Weight already biased the scores; applying it again as an
+ * ordering key would double-count it, and a query that matched one FAQ
+ * exactly would still rank a weak product match above it.
+ */
+export declare function toSearchGroups(hits: readonly ResolvedEntity[], opts: ToGroupsOptions): SearchGroup[];
+/** Assemble the full result envelope the page component expects. */
+export declare function toSearchResult(q: string, terms: readonly string[], hits: readonly ResolvedEntity[], opts: ToGroupsOptions): SearchEverythingResult;
+export interface FacetCount {
+    readonly key: string;
+    readonly value: string;
+    readonly count: number;
+}
+/**
+ * Count facet values across a result set.
+ *
+ * ## 🛑 This is the thing the server tier structurally cannot afford
+ *
+ * `BaseRepository.facetCounts` runs ONE aggregation query per facet value,
+ * each needing its own composite index, and on a missing index it logs and
+ * returns `undefined` so the facet "stays visible" with no count. Here it is
+ * a `reduce` over an array already in memory: zero queries, zero indexes, and
+ * a count that cannot silently fail.
+ *
+ * Counts are over the hits the CURRENT query produced, so ticking one facet
+ * and watching the others shrink is truthful rather than an approximation of
+ * the whole catalogue.
+ */
+export declare function countFacets(hits: readonly ResolvedEntity[]): FacetCount[];
+/** Look up a type's `moreHref` from the artifact's own table. */
+export declare function moreHrefResolver(artifact: Pick<SearchIndexArtifact, "types">): (typeKey: string) => string;

package/dist/_internal/shared/search/to-groups.js

@@ -0,0 +1,141 @@
+/*
+ * WHY: Tier 1 and Tier 2 must render through the SAME component, or the page
+ *      grows two layouts that drift.
+ * WHAT: `ResolvedEntity[]` (browser matcher) -> `SearchGroup[]` (the shape
+ *       `SearchResultsPageView` already renders), plus facet counting.
+ *
+ * ## 🛑 Written against the server's types, not beside them
+ *
+ * `SearchGroup` / `SearchHit` / `SearchEverythingResult` are declared in
+ * `_internal/server/features/search/search-everything.ts` and imported here
+ * as TYPES ONLY — erased at runtime, so nothing of the server reaches a
+ * browser bundle. `SearchResultsPageView` already does exactly this, so the
+ * boundary is established rather than invented here.
+ *
+ * Defining a parallel `LocalSearchGroup` would have been the easy call and
+ * the wrong one: two near-identical result shapes is how a page ends up with
+ * two renderers, and then a fix to one of them (Root Cause #59's shape).
+ *
+ * ## 🛑 `truncated` is FALSE here, and that is a real difference
+ *
+ * The server tier reads a bounded window per collection, so a saturated fetch
+ * makes its count a FLOOR and it must render "6+". Tier 1 holds the entire
+ * corpus in memory, so the count is EXACT — there is no window to saturate.
+ * Reporting `truncated: true` because a group was capped for DISPLAY would be
+ * a different claim ("there may be more we could not see") and a false one.
+ * `total` carries the real figure; `hits` is the slice shown.
+ *
+ * @tag domain:search
+ * @tag layer:shared
+ * @tag pattern:none
+ * @tag access:isomorphic
+ * @tag consumers:useSiteSearch,SearchResultsClient
+ * @tag sideEffects:none
+ */
+/** Rows shown per group before "see all". Matches the server tier's PER_GROUP. */
+export const LOCAL_PER_GROUP = 6;
+/**
+ * Group score-ordered hits by type, preserving the order the types first
+ * appear in.
+ *
+ * 🛑 Group ORDER follows the best hit in each group, not the type table's
+ * `weight`. Weight already biased the scores; applying it again as an
+ * ordering key would double-count it, and a query that matched one FAQ
+ * exactly would still rank a weak product match above it.
+ */
+export function toSearchGroups(hits, opts) {
+    const perGroup = opts.perGroup ?? LOCAL_PER_GROUP;
+    const order = [];
+    const byType = new Map();
+    for (const hit of hits) {
+        let bucket = byType.get(hit.typeKey);
+        if (!bucket) {
+            bucket = [];
+            byType.set(hit.typeKey, bucket);
+            order.push(hit.typeKey);
+        }
+        bucket.push(hit);
+    }
+    return order.map((typeKey) => {
+        const bucket = byType.get(typeKey) ?? [];
+        const groupHits = bucket.slice(0, perGroup).map((h) => ({
+            /*
+             * The href IS the identity here. The artifact has no document id — it
+             * carries a slug, and two types can share a destination (a model
+             * composition and its category leaf both render `/categories/{s}`),
+             * which the matcher already dedupes on. Using the same key keeps the
+             * two consistent; inventing `${typeKey}:${slug}` would give the same
+             * row two identities depending on which layer you asked.
+             */
+            id: h.href,
+            title: h.title,
+            href: h.href,
+            detail: h.detail || undefined,
+        }));
+        return {
+            key: typeKey,
+            label: opts.label(typeKey),
+            hits: groupHits,
+            truncated: false, // see the header — the count is exact, not a floor
+            moreHref: opts.moreHref(typeKey),
+        };
+    });
+}
+/** Assemble the full result envelope the page component expects. */
+export function toSearchResult(q, terms, hits, opts) {
+    const groups = toSearchGroups(hits, opts);
+    return {
+        q,
+        terms: [...terms],
+        groups,
+        /*
+         * The TOTAL matched, not the total shown. A page that says "24 results"
+         * and renders 12 because each group capped at 6 is lying in the direction
+         * that matters least; one that says "12" when 24 matched hides half the
+         * corpus from someone deciding whether to refine.
+         */
+        totalHits: hits.length,
+    };
+}
+/**
+ * Count facet values across a result set.
+ *
+ * ## 🛑 This is the thing the server tier structurally cannot afford
+ *
+ * `BaseRepository.facetCounts` runs ONE aggregation query per facet value,
+ * each needing its own composite index, and on a missing index it logs and
+ * returns `undefined` so the facet "stays visible" with no count. Here it is
+ * a `reduce` over an array already in memory: zero queries, zero indexes, and
+ * a count that cannot silently fail.
+ *
+ * Counts are over the hits the CURRENT query produced, so ticking one facet
+ * and watching the others shrink is truthful rather than an approximation of
+ * the whole catalogue.
+ */
+export function countFacets(hits) {
+    const tally = new Map();
+    for (const hit of hits) {
+        if (!hit.facets)
+            continue;
+        for (const pair of hit.facets.split("|")) {
+            // Guard the shape rather than trusting it: a malformed pair is one
+            // record's problem, not a reason to drop the whole rail.
+            if (pair.indexOf(":") > 0)
+                tally.set(pair, (tally.get(pair) ?? 0) + 1);
+        }
+    }
+    const out = [];
+    for (const [pair, count] of tally) {
+        const i = pair.indexOf(":");
+        out.push({ key: pair.slice(0, i), value: pair.slice(i + 1), count });
+    }
+    // Commonest first within a key, then alphabetical — a rail ordered by raw
+    // string would bury the useful refinement below the rare ones.
+    out.sort((a, b) => a.key.localeCompare(b.key) || b.count - a.count || a.value.localeCompare(b.value));
+    return out;
+}
+/** Look up a type's `moreHref` from the artifact's own table. */
+export function moreHrefResolver(artifact) {
+    const map = new Map(artifact.types.map((t) => [t.key, t.moreHref]));
+    return (typeKey) => map.get(typeKey) ?? "/";
+}

package/dist/client.d.ts

@@ -292,9 +292,11 @@ export { StoreSidebar } from "./features/seller/components/SellerSidebar";
 export type { StoreNavItem, StoreNavGroup } from "./features/seller/components/SellerSidebar";
 export { StoreProductsView, StoreAboutView } from "./features/stores/index";
 export type { StoreProductItem, StoreAboutViewProps, StoreDetail } from "./features/stores/index";
-export { SearchView } from "./features/search/index";
-export type { SearchViewProps } from "./features/search/index";
 export { useSearchIndex, ensureSearchIndex } from "./features/search/hooks/useSearchIndex";
+export { useSiteSearch } from "./features/search/hooks/useSiteSearch";
+export { useScopedSearch, mergeSearchTiers } from "./features/search/hooks/useScopedSearch";
+export type { UseScopedSearchResult } from "./features/search/hooks/useScopedSearch";
+export type { UseSiteSearchOptions, UseSiteSearchResult } from "./features/search/hooks/useSiteSearch";
 export type { SearchIndexState, SearchIndexStatus, LoadedSearchIndex, UseSearchIndexOptions, } from "./features/search/hooks/useSearchIndex";
 export { AdSlot } from "./features/homepage/components/AdSlot";
 export { useActiveAd } from "./features/homepage/hooks/useActiveAd";
@@ -456,6 +458,8 @@ export { SellerArtView } from "./features/seller/components/SellerArtView";
 export type { SellerArtViewProps } from "./features/seller/components/SellerArtView";
 export { SellerStickersView } from "./features/seller/components/SellerStickersView";
 export type { SellerStickersViewProps } from "./features/seller/components/SellerStickersView";
+export { SellerSparesView } from "./features/seller/components/SellerSparesView";
+export type { SellerSparesViewProps } from "./features/seller/components/SellerSparesView";
 export { SellerDigitalCodesView } from "./features/seller/components/SellerDigitalCodesView";
 export type { SellerDigitalCodesViewProps } from "./features/seller/components/SellerDigitalCodesView";
 export { SellerLiveView } from "./features/seller/components/SellerLiveView";
@@ -501,6 +505,8 @@ export type { FAQCategory, FAQCategoryItem, FAQSortOption } from "./features/faq
 export { CategoryInlineSelect } from "./features/seller/components/CategoryInlineSelect";
 export { CategoryTemplatePicker, variantForCondition } from "./features/categories/components/CategoryTemplatePicker";
 export type { CategoryTemplatePickerProps, CategoryTemplateApply } from "./features/categories/components/CategoryTemplatePicker";
+export { PriceGuidanceHint } from "./features/categories/components/PriceGuidanceHint";
+export type { PriceGuidanceHintProps } from "./features/categories/components/PriceGuidanceHint";
 export { BrandInlineSelect } from "./features/seller/components/BrandInlineSelect";
 export { API_ENDPOINTS } from "./constants/index";
 export { SELLER_LISTING_TABS, type SellerListingTabId, } from "./features/products/constants/listing-tabs";

package/dist/client.js

@@ -327,7 +327,6 @@ export { updateProfileSchema } from "./features/account/index.js";
 export { MediaImage } from "./features/media/index.js";
 export { StoreSidebar } from "./features/seller/components/SellerSidebar.js";
 export { StoreProductsView, StoreAboutView } from "./features/stores/index.js";
-export { SearchView } from "./features/search/index.js";
 /*
  * The browser-side search index. Exported from its DEFINING module rather
  * than through `features/search/index` (Root Cause #18) — `ensureSearchIndex`
@@ -336,6 +335,8 @@ export { SearchView } from "./features/search/index.js";
  * fetch per page session" guarantee quietly becomes two.
  */
 export { useSearchIndex, ensureSearchIndex } from "./features/search/hooks/useSearchIndex.js";
+export { useSiteSearch } from "./features/search/hooks/useSiteSearch.js";
+export { useScopedSearch, mergeSearchTiers } from "./features/search/hooks/useScopedSearch.js";
 export { AdSlot } from "./features/homepage/components/AdSlot.js";
 export { useActiveAd } from "./features/homepage/hooks/useActiveAd.js";
 export { registerAdSlot, registerAdSlots, unregisterAdSlot, clearAdRegistry, setAdConsentGranted, isAdConsentGranted, isAdSlotRenderable, } from "./features/homepage/ad-registry.js";
@@ -466,6 +467,7 @@ export { SellerBundlesView } from "./features/seller/components/SellerBundlesVie
 export { SellerClassifiedView } from "./features/seller/components/SellerClassifiedView.js";
 export { SellerArtView } from "./features/seller/components/SellerArtView.js";
 export { SellerStickersView } from "./features/seller/components/SellerStickersView.js";
+export { SellerSparesView } from "./features/seller/components/SellerSparesView.js";
 export { SellerDigitalCodesView } from "./features/seller/components/SellerDigitalCodesView.js";
 export { SellerLiveView } from "./features/seller/components/SellerLiveView.js";
 // ── Central schema registry (W1) ──────────────────────────────────────────────
@@ -502,6 +504,7 @@ export { computeCodHandlingFee } from "./_internal/shared/fees/calculator.js"; /
 export { FAQPageContent } from "./features/faq/index.js";
 export { CategoryInlineSelect } from "./features/seller/components/CategoryInlineSelect.js";
 export { CategoryTemplatePicker, variantForCondition } from "./features/categories/components/CategoryTemplatePicker.js";
+export { PriceGuidanceHint } from "./features/categories/components/PriceGuidanceHint.js";
 export { BrandInlineSelect } from "./features/seller/components/BrandInlineSelect.js";
 export { API_ENDPOINTS } from "./constants/index.js";
 // [CLIENT-SAFE] Pure, zero-import constant files — dashboard filter-tab

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

@@ -273,6 +273,15 @@ export declare const CATEGORY_ENDPOINTS: {
      * category change in the form costs zero function invocations on a hit.
      */
     readonly DESCRIPTION_TEMPLATE: (id: string, variant?: string) => string;
+    /**
+     * The inherited `priceGuidance` band, restated on the calling seller's own
+     * tax basis — seller/admin/moderator only. Deliberately a SEPARATE
+     * endpoint from `DESCRIPTION_TEMPLATE`: that one is public and edge-cached
+     * so anyone can fetch it, and `priceGuidance` is withheld from that
+     * response for the same reason a listing's own price is hidden from guests
+     * (CLAUDE.md § "Guest price gating").
+     */
+    readonly PRICE_GUIDANCE: (id: string) => string;
 };
 export declare const TOOL_ENDPOINTS: {
     /**
@@ -286,6 +295,12 @@ export declare const TOOL_ENDPOINTS: {
      * its invocation allowance.
      */
     readonly PRICE_INDEX_SEARCH: (q: string) => string;
+    /**
+     * Tier 1 adoption — the client resolved these ids LOCALLY, from the
+     * public search artifact, at zero Firestore reads. This route's only job
+     * is the multi-get `searchPriceIndex` otherwise pays for every lookup.
+     */
+    readonly PRICE_INDEX_BANDS: (ids: readonly string[]) => string;
 };
 /**
  * The sticker-sheet kiss-cut tracer. Admin-only, every route behind
@@ -377,8 +392,6 @@ export declare const FAQ_ENDPOINTS: {
     readonly VOTE: "/api/faqs/vote";
 };
 export declare const HOMEPAGE_ENDPOINTS: {
-    readonly GET: "/api/homepage";
-    readonly SECTIONS: "/api/homepage-sections";
     readonly CAROUSEL: "/api/carousel";
     readonly NEWSLETTER_SUBSCRIBE: "/api/newsletter/subscribe";
 };
@@ -434,10 +447,9 @@ export declare const REVIEW_ENDPOINTS: {
     readonly FEATURED: "/api/reviews?featured=true";
 };
 export declare const SEARCH_ENDPOINTS: {
-    readonly QUERY: (q: string, extra?: string) => string;
     readonly SUGGESTIONS: "/api/search/suggestions";
-    /** @param params — pre-built querystring (no leading `?`) from a caller-owned URLSearchParams */
-    readonly RAW: (params: string) => string;
+    /** Tier 2 — the viewer's own orders/offers/drafts/addresses. `private, no-store`. */
+    readonly SCOPED: (q: string) => string;
 };
 export declare const SELLER_ENDPOINTS: {
     readonly BECOME: "/api/seller/become";
@@ -816,6 +828,15 @@ export declare const API_ENDPOINTS: {
          * category change in the form costs zero function invocations on a hit.
          */
         readonly DESCRIPTION_TEMPLATE: (id: string, variant?: string) => string;
+        /**
+         * The inherited `priceGuidance` band, restated on the calling seller's own
+         * tax basis — seller/admin/moderator only. Deliberately a SEPARATE
+         * endpoint from `DESCRIPTION_TEMPLATE`: that one is public and edge-cached
+         * so anyone can fetch it, and `priceGuidance` is withheld from that
+         * response for the same reason a listing's own price is hidden from guests
+         * (CLAUDE.md § "Guest price gating").
+         */
+        readonly PRICE_GUIDANCE: (id: string) => string;
     };
     readonly BEFORE_AFTER: {
         readonly LIST: "/api/before-after";
@@ -880,8 +901,6 @@ export declare const API_ENDPOINTS: {
         readonly VOTE: "/api/faqs/vote";
     };
     readonly HOMEPAGE: {
-        readonly GET: "/api/homepage";
-        readonly SECTIONS: "/api/homepage-sections";
         readonly CAROUSEL: "/api/carousel";
         readonly NEWSLETTER_SUBSCRIBE: "/api/newsletter/subscribe";
     };
@@ -934,10 +953,9 @@ export declare const API_ENDPOINTS: {
         readonly FEATURED: "/api/reviews?featured=true";
     };
     readonly SEARCH: {
-        readonly QUERY: (q: string, extra?: string) => string;
         readonly SUGGESTIONS: "/api/search/suggestions";
-        /** @param params — pre-built querystring (no leading `?`) from a caller-owned URLSearchParams */
-        readonly RAW: (params: string) => string;
+        /** Tier 2 — the viewer's own orders/offers/drafts/addresses. `private, no-store`. */
+        readonly SCOPED: (q: string) => string;
     };
     readonly SELLER: {
         readonly BECOME: "/api/seller/become";
@@ -1337,6 +1355,15 @@ export declare const API_ROUTES: {
          * category change in the form costs zero function invocations on a hit.
          */
         readonly DESCRIPTION_TEMPLATE: (id: string, variant?: string) => string;
+        /**
+         * The inherited `priceGuidance` band, restated on the calling seller's own
+         * tax basis — seller/admin/moderator only. Deliberately a SEPARATE
+         * endpoint from `DESCRIPTION_TEMPLATE`: that one is public and edge-cached
+         * so anyone can fetch it, and `priceGuidance` is withheld from that
+         * response for the same reason a listing's own price is hidden from guests
+         * (CLAUDE.md § "Guest price gating").
+         */
+        readonly PRICE_GUIDANCE: (id: string) => string;
     };
     readonly BEFORE_AFTER: {
         readonly LIST: "/api/before-after";
@@ -1401,8 +1428,6 @@ export declare const API_ROUTES: {
         readonly VOTE: "/api/faqs/vote";
     };
     readonly HOMEPAGE: {
-        readonly GET: "/api/homepage";
-        readonly SECTIONS: "/api/homepage-sections";
         readonly CAROUSEL: "/api/carousel";
         readonly NEWSLETTER_SUBSCRIBE: "/api/newsletter/subscribe";
     };
@@ -1455,10 +1480,9 @@ export declare const API_ROUTES: {
         readonly FEATURED: "/api/reviews?featured=true";
     };
     readonly SEARCH: {
-        readonly QUERY: (q: string, extra?: string) => string;
         readonly SUGGESTIONS: "/api/search/suggestions";
-        /** @param params — pre-built querystring (no leading `?`) from a caller-owned URLSearchParams */
-        readonly RAW: (params: string) => string;
+        /** Tier 2 — the viewer's own orders/offers/drafts/addresses. `private, no-store`. */
+        readonly SCOPED: (q: string) => string;
     };
     readonly SELLER: {
         readonly BECOME: "/api/seller/become";

package/dist/constants/api-endpoints.js

@@ -317,6 +317,15 @@ export const CATEGORY_ENDPOINTS = {
      * category change in the form costs zero function invocations on a hit.
      */
     DESCRIPTION_TEMPLATE: (id, variant) => `/api/categories/${id}/description-template${variant ? `?variant=${variant}` : ""}`,
+    /**
+     * The inherited `priceGuidance` band, restated on the calling seller's own
+     * tax basis — seller/admin/moderator only. Deliberately a SEPARATE
+     * endpoint from `DESCRIPTION_TEMPLATE`: that one is public and edge-cached
+     * so anyone can fetch it, and `priceGuidance` is withheld from that
+     * response for the same reason a listing's own price is hidden from guests
+     * (CLAUDE.md § "Guest price gating").
+     */
+    PRICE_GUIDANCE: (id) => `/api/categories/${id}/price-guidance`,
 };
 // ---------------------------------------------------------------------------
 // Tools — public surfaces that answer a question rather than sell something
@@ -333,6 +342,12 @@ export const TOOL_ENDPOINTS = {
      * its invocation allowance.
      */
     PRICE_INDEX_SEARCH: (q) => `/api/tools/price-index?q=${encodeURIComponent(q)}`,
+    /**
+     * Tier 1 adoption — the client resolved these ids LOCALLY, from the
+     * public search artifact, at zero Firestore reads. This route's only job
+     * is the multi-get `searchPriceIndex` otherwise pays for every lookup.
+     */
+    PRICE_INDEX_BANDS: (ids) => `/api/tools/price-index/bands?ids=${ids.map(encodeURIComponent).join(",")}`,
 };
 /**
  * The sticker-sheet kiss-cut tracer. Admin-only, every route behind
@@ -473,8 +488,17 @@ export const FAQ_ENDPOINTS = {
 // Homepage
 // ---------------------------------------------------------------------------
 export const HOMEPAGE_ENDPOINTS = {
-    GET: "/api/homepage",
-    SECTIONS: "/api/homepage-sections",
+    /*
+     * 🛑 `GET` and `SECTIONS` were both removed 2026-10-19 — `/api/homepage` was
+     * NEVER mounted (only a dead hook referenced it), and `/api/homepage-sections`
+     * was a mounted generic-starter-kit stub writing/reading the real
+     * `homepageSections` collection through an incompatible schema. See the
+     * deletion note in `features/homepage/types/index.ts` for the full writeup.
+     * The real, single section API is `/api/admin/sections` (admin CRUD);
+     * public rendering reads `homepageSectionsRepository` directly, server-side,
+     * in `MarketplaceHomepageView` — no public GET endpoint for sections exists
+     * or is needed.
+     */
     CAROUSEL: "/api/carousel",
     NEWSLETTER_SUBSCRIBE: "/api/newsletter/subscribe",
 };
@@ -566,10 +590,9 @@ export const REVIEW_ENDPOINTS = {
 // Search
 // ---------------------------------------------------------------------------
 export const SEARCH_ENDPOINTS = {
-    QUERY: (q, extra) => `/api/search?q=${encodeURIComponent(q)}${extra ? `&${extra}` : ""}`,
     SUGGESTIONS: "/api/search/suggestions",
-    /** @param params — pre-built querystring (no leading `?`) from a caller-owned URLSearchParams */
-    RAW: (params) => `/api/search?${params}`,
+    /** Tier 2 — the viewer's own orders/offers/drafts/addresses. `private, no-store`. */
+    SCOPED: (q) => `/api/search/scoped?q=${encodeURIComponent(q)}`,
 };
 // ---------------------------------------------------------------------------
 // Seller

package/dist/constants/cache-invalidation.js

@@ -20,7 +20,9 @@ export const COLLECTION_CACHE_PATHS = {
     categories: [CATEGORY_ENDPOINTS.LIST],
     products: [PRODUCT_ENDPOINTS.LIST],
     carouselSlides: [HOMEPAGE_ENDPOINTS.CAROUSEL],
-    homepageSections: [HOMEPAGE_ENDPOINTS.SECTIONS],
+    // No public GET endpoint exists for homepageSections (removed 2026-10-19 —
+    // see HOMEPAGE_ENDPOINTS' own comment). Real-time freshness comes from
+    // `revalidatePath("/")`, which /api/admin/sections already calls on write.
     siteSettings: [SITE_SETTINGS_ENDPOINTS.GET],
     faqs: [FAQ_ENDPOINTS.LIST],
     reviews: [REVIEW_ENDPOINTS.LIST],

package/dist/constants/field-names.d.ts

@@ -49,6 +49,9 @@ export declare const PRODUCT_FIELDS: {
     readonly STOCK_QUANTITY: "stockQuantity";
     readonly AVAILABLE_QUANTITY: "availableQuantity";
     readonly IS_SOLD: "isSold";
+    readonly MADE_TO_ORDER: "madeToOrder";
+    readonly PART_GLOSSARY_ID: "partGlossaryId";
+    readonly COLOURWAY: "colourway";
     readonly MAIN_IMAGE: "mainImage";
     readonly IMAGES: "images";
     readonly VIDEO: "video";
@@ -181,6 +184,7 @@ export declare const PRODUCT_FIELDS: {
         readonly LIVE: "live";
         readonly ART: "art";
         readonly STICKERS: "stickers";
+        readonly SPARES: "spares";
     };
 };
 export declare const PRODUCT_STATUS_TRANSITIONS: Record<string, readonly string[]>;
@@ -853,6 +857,8 @@ export declare const HOMEPAGE_SECTION_FIELDS: {
     readonly ORDER: "order";
     readonly ENABLED: "enabled";
     readonly CONFIG: "config";
+    /** Which page the row belongs to. Absent on a row means "homepage". */
+    readonly SURFACE: "surface";
     readonly CREATED_AT: "createdAt";
     readonly UPDATED_AT: "updatedAt";
     readonly TYPE_VALUES: {

package/dist/constants/field-names.js

@@ -58,6 +58,9 @@ export const PRODUCT_FIELDS = {
     STOCK_QUANTITY: "stockQuantity",
     AVAILABLE_QUANTITY: "availableQuantity",
     IS_SOLD: "isSold",
+    MADE_TO_ORDER: "madeToOrder",
+    PART_GLOSSARY_ID: "partGlossaryId",
+    COLOURWAY: "colourway",
     MAIN_IMAGE: "mainImage",
     IMAGES: "images",
     VIDEO: "video",
@@ -201,6 +204,7 @@ export const PRODUCT_FIELDS = {
         LIVE: "live",
         ART: "art",
         STICKERS: "stickers",
+        SPARES: "spares",
     },
 };
 export const PRODUCT_STATUS_TRANSITIONS = {
@@ -1035,6 +1039,8 @@ export const HOMEPAGE_SECTION_FIELDS = {
     ORDER: "order",
     ENABLED: "enabled",
     CONFIG: "config",
+    /** Which page the row belongs to. Absent on a row means "homepage". */
+    SURFACE: "surface",
     CREATED_AT: "createdAt",
     UPDATED_AT: "updatedAt",
     TYPE_VALUES: {

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

@@ -1,6 +1,26 @@
-export type PolicyKey = "privacy" | "terms" | "cookies" | "refund" | "ethics" | "conduct";
+export type PolicyKey = "privacy" | "terms" | "cookies" | "refund" | "ethics" | "conduct" | "cancellation" | "grievance";
 export interface PolicyPageViewProps {
     /** Which policy to render */
     policy: PolicyKey;
+    /**
+     * Rendered after the policy sections and before the related links.
+     *
+     * The slot exists for /grievance, whose officer block (name, designation,
+     * email, phone) comes from `appkit.config.js` → `business.grievance` rather
+     * than from i18n — those values are deployment-specific and some are still
+     * undecided, so they render through `<PendingValue>` as a visible
+     * `[to be confirmed]` marker.
+     *
+     * 🛑 Deliberately a `children` ReactNode and not a render prop: this is an
+     * async Server Component, and a function prop would have to cross the
+     * server/client boundary at the call site to be useful. The caller builds
+     * the node and passes it down, which needs nothing serialisable.
+     *
+     * Note it renders under the i18n sections but is SKIPPED when an admin HTML
+     * override is present — an override replaces the page's body, and silently
+     * appending a block the admin cannot see or edit would make the override a
+     * half-truth.
+     */
+    children?: React.ReactNode;
 }
-export declare function PolicyPageView({ policy, }: PolicyPageViewProps): Promise<import("react").JSX.Element>;
+export declare function PolicyPageView({ policy, children, }: PolicyPageViewProps): Promise<import("react").JSX.Element>;

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

@@ -58,9 +58,21 @@ const POLICY_META = {
         firestoreField: "codeOfConduct",
         relatedLabelKey: "relatedConduct",
     },
+    cancellation: {
+        path: String(ROUTES.PUBLIC.CANCELLATION_POLICY),
+        namespace: "cancellationPolicy",
+        firestoreField: "cancellation",
+        relatedLabelKey: "relatedCancellation",
+    },
+    grievance: {
+        path: String(ROUTES.PUBLIC.GRIEVANCE),
+        namespace: "grievance",
+        firestoreField: "grievance",
+        relatedLabelKey: "relatedGrievance",
+    },
 };
 const POLICY_KEYS = Object.keys(POLICY_META);
-export async function PolicyPageView({ policy, }) {
+export async function PolicyPageView({ policy, children, }) {
     const page = { container: PAGE_CONTAINER };
     const meta = POLICY_META[policy];
     const { getTranslations } = await import("next-intl/server");
@@ -93,5 +105,5 @@ export async function PolicyPageView({ policy, }) {
     }));
     return (_jsxs(Div, { className: "-mx-4 md:-mx-6 lg:-mx-8 -mt-6 sm:-mt-8 lg:-mt-10", children: [_jsx(Section, { color: "inverse", tone: "accent-banner", padding: "banner", children: _jsxs(Div, { className: `${page.container.sm}`, children: [_jsx(Heading, { color: "inverse", level: 1, variant: "none", className: "mb-3", children: t("title") }), _jsx(Text, { color: "inverse", variant: "none", className: "/80", size: "sm", children: t("lastUpdated") })] }) }), _jsxs(Div, { className: `${page.container.sm}`, padding: "content-banner", children: [adminHtml ? (
                     /* Admin-set HTML takes priority */
-                    _jsx(Div, { className: "prose max-w-none", dangerouslySetInnerHTML: { __html: adminHtml } })) : (_jsxs(_Fragment, { children: [t.has("intro") && (_jsx(Text, { variant: "secondary", className: "mb-10 leading-relaxed", size: "base", children: t("intro") })), _jsx(Stack, { gap: "xl", children: sections.map((section, i) => (_jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "mb-3", children: section.heading }), _jsx(Text, { variant: "secondary", className: "leading-relaxed whitespace-pre-line", children: section.body })] }, i))) })] })), relatedLinks.length > 0 && (_jsxs(Div, { className: `mt-14 border-t`, border: "default", padding: "t-xl", children: [_jsx(Heading, { level: 3, className: "mb-3 uppercase tracking-wide", color: "muted", size: "sm", weight: "semibold", children: t("relatedTitle") }), _jsx(Row, { wrap: true, gap: "md", children: relatedLinks.map((l) => (_jsx(TextLink, { href: l.href, variant: "muted", size: "sm", children: l.label }, l.href))) })] }))] })] }));
+                    _jsx(Div, { className: "prose max-w-none", dangerouslySetInnerHTML: { __html: adminHtml } })) : (_jsxs(_Fragment, { children: [t.has("intro") && (_jsx(Text, { variant: "secondary", className: "mb-10 leading-relaxed", size: "base", children: t("intro") })), _jsx(Stack, { gap: "xl", children: sections.map((section, i) => (_jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "mb-3", children: section.heading }), _jsx(Text, { variant: "secondary", className: "leading-relaxed whitespace-pre-line", children: section.body })] }, i))) }), children] })), relatedLinks.length > 0 && (_jsxs(Div, { className: `mt-14 border-t`, border: "default", padding: "t-xl", children: [_jsx(Heading, { level: 3, className: "mb-3 uppercase tracking-wide", color: "muted", size: "sm", weight: "semibold", children: t("relatedTitle") }), _jsx(Row, { wrap: true, gap: "md", children: relatedLinks.map((l) => (_jsx(TextLink, { href: l.href, variant: "muted", size: "sm", children: l.label }, l.href))) })] }))] })] }));
 }

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

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import Link from "next/link.js";
+import { productImageUrls } from "../../products/schemas/firestore.js";
 import { getPublicUserProfile, getProfileStoreProducts, getReviewsAuthoredBy, getReviewsReceivedBy } from "../../auth/actions/profile-actions.js";
 import { storeRepository } from "../../stores/repository/store.repository.js";
 import { safeRead } from "../../../errors/safe-read.js";
@@ -37,7 +38,7 @@ function toProductItem(p) {
         originalPrice: p.originalPrice,
         currency: p.currency,
         mainImage: p.mainImage,
-        images: p.images,
+        images: productImageUrls(p.images),
         status: p.status,
         condition: p.condition,
         listingType: p.listingType,