@mohasinac/appkit 4.11.3 → 4.12.0

package/dist/features/products/components/PrizeDrawsListingView.js

@@ -1,33 +1,13 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
-import { productRepository } from "../../../repositories";
 import { Container, Main, Heading, Section, Text } from "../../../ui";
 import { AdSlot } from "../../homepage/components/AdSlot";
-import { parseListingSearchParams } from "../../../utils/listing-params";
+import { PRODUCT_FIELDS } from "../../../constants/field-names";
+import { sortBy } from "../../../constants/sort";
+import { listPublicProducts, parsePublicProductParams, defaultTogglesForListingTypes, } from "../../../_internal/server/features/products/list-public";
 import { PrizeDrawsIndexListing } from "./PrizeDrawsIndexListing";
-const DEFAULT_PAGE = 1;
+const LISTING_TYPES = ["prize-draw"];
 const DEFAULT_PAGE_SIZE = 24;
-const DEFAULT_SORT = "-createdAt";
-function sp(params, key) {
-    const v = params[key];
-    return Array.isArray(v) ? v[0] ?? "" : v ?? "";
-}
-function buildPrizeDrawFilters(params) {
-    const parts = ["status==published", "listingType==prize-draw"];
-    const minPrice = sp(params, "minPrice");
-    const maxPrice = sp(params, "maxPrice");
-    if (minPrice)
-        parts.push(sieveFilter("pricePerEntry", SIEVE_OP.GTE, minPrice));
-    if (maxPrice)
-        parts.push(sieveFilter("pricePerEntry", SIEVE_OP.LTE, maxPrice));
-    const store = sp(params, "storeId");
-    if (store)
-        parts.push(sieveFilter("storeId", SIEVE_OP.EQ, store));
-    const status = sp(params, "prizeRevealStatus");
-    if (status)
-        parts.push(sieveFilter("prizeRevealStatus", SIEVE_OP.EQ, status));
-    return parts.join(",");
-}
+const DEFAULT_SORT = sortBy(PRODUCT_FIELDS.CREATED_AT);
 /**
  * Public listing page (SB4-F). Server-fetches published prize-draw products,
  * hydrates the client `PrizeDrawsIndexListing` which renders the filter
@@ -38,13 +18,18 @@ function buildPrizeDrawFilters(params) {
  * already gone (matches `PrizeDrawCollage`'s `hideWonState` prop).
  */
 export async function PrizeDrawsListingView({ searchParams = {}, }) {
-    const std = parseListingSearchParams(searchParams);
-    const sort = std.sorts ?? DEFAULT_SORT;
-    const page = std.page ?? DEFAULT_PAGE;
-    const pageSize = std.pageSize ?? DEFAULT_PAGE_SIZE;
-    const filters = buildPrizeDrawFilters(searchParams);
-    const result = await productRepository
-        .list({ filters, sorts: sort, page, pageSize })
-        .catch(() => null);
+    // Routed through the shared query (2026-08-21). The hand-rolled builder this
+    // replaces had its own Root Cause #30 divergence: it applied the price range
+    // to `pricePerEntry`, while the client's refetch sends minPrice/maxPrice,
+    // which the shared query applies to `price`. Both fields carry the same
+    // value today, so the split was invisible — until one of them drifted.
+    // `price` wins because it is also what PRIZE_DRAW_SORT_OPTIONS sorts by for
+    // "Entry: Low to High".
+    const result = await listPublicProducts(parsePublicProductParams(searchParams, {
+        listingTypes: LISTING_TYPES,
+        pageSize: DEFAULT_PAGE_SIZE,
+        sorts: DEFAULT_SORT,
+        ...defaultTogglesForListingTypes(LISTING_TYPES),
+    }));
     return (_jsx(Main, { children: _jsx(Section, { padding: "y-2xl", children: _jsxs(Container, { size: "xl", children: [_jsx(Heading, { level: 1, className: "mb-2", color: "primary", size: "3xl", weight: "semibold", children: "Prize Draws" }), _jsx(Text, { className: "mb-6 text-[var(--appkit-color-text-muted)]", size: "sm", children: "Fair-RNG draws for sealed Pok\u00E9mon, Hot Wheels Super Treasure Hunts, Gundam kits and more. Every winner picked by crypto.randomInt \u2014 proof on GitHub." }), _jsx(AdSlot, { id: "listing-sidebar-top", className: "mb-6" }), _jsx(PrizeDrawsIndexListing, { initialData: result ?? undefined }), _jsx(AdSlot, { id: "listing-sidebar-bottom", className: "mt-8" })] }) }) }));
 }

package/dist/features/products/components/ProductsIndexListing.js

@@ -12,7 +12,7 @@ import { ACTION_ID, ACTION_META, COMPARE_MAX_ITEMS } from "../constants/action-d
 import { CompareOverlay } from "./CompareOverlay";
 import { ROUTES } from "../../../next";
 import { pluginFor } from "../../../_internal/shared/listing-types/_registry";
-import { ProductGrid, ProductFilters, PRODUCT_PUBLIC_SORT_OPTIONS } from ".";
+import { ProductGrid, ProductFilters } from ".";
 import { useGuestCart } from "../../cart/hooks/useGuestCart";
 import { getGuestCartItems } from "../../cart/utils/guest-cart";
 import { useGuestWishlist } from "../../wishlist/hooks/useGuestWishlist";
@@ -28,6 +28,9 @@ import { sortBy } from "../../../constants/sort";
 import { PRODUCT_FIELDS } from "../../../constants/field-names";
 import { useBottomActions } from "../../layout";
 import { GENERIC_PRODUCT_LISTING_TYPES, PRODUCT_TYPE_FILTER_TABS } from "../constants/listing-tabs";
+import { parseSelectedListingTypes } from "../utils/listing-type";
+import { commonSortOptionsFor, hideDefaultsFor } from "../../../_internal/shared/listing-types/_registry";
+import { TextLink } from "../../../ui";
 const __P = {
     p3: "p-[var(--appkit-space-3)]",
 };
@@ -46,7 +49,40 @@ export function ProductsIndexListing({ initialData, listingTypes = GENERIC_PRODU
     const [compareIds, setCompareIds] = useState([]);
     const showSold = table.get(TABLE_KEYS.SHOW_SOLD) === "true";
     const [view, setView] = useState(table.get(TABLE_KEYS.VIEW) || VIEW_MODE.GRID);
-    const productType = table.get(TABLE_KEYS.LISTING_TYPE) || "All";
+    // ── Type filter (multi-select) ───────────────────────────────────────────
+    // The URL value is a pipe-joined set; empty means "every type this page
+    // spans". Unknown tokens are dropped rather than passed through to a
+    // Firestore `==` that could never match (Root Cause #33).
+    const typeParam = table.get(TABLE_KEYS.LISTING_TYPE);
+    const selectedTypes = parseSelectedListingTypes(typeParam).filter((t) => listingTypes.includes(t));
+    const effectiveTypes = (selectedTypes.length > 0 ? selectedTypes : listingTypes);
+    // Sorts valid across every selected type. Pick Auctions alone and you get
+    // "Ending Soon"; pick Auctions + Products and you get only what both
+    // support, because a sort on `auctionEndDate` would order the products
+    // arbitrarily (and needs an index nobody declares for that shape).
+    const sortOptions = commonSortOptionsFor(effectiveTypes, "public");
+    const sortValue = table.get(TABLE_KEYS.SORT) || DEFAULT_SORT;
+    // Guard against a sort carried over from a previous selection that the new
+    // one can't satisfy — that combination throws FAILED_PRECONDITION in
+    // Firestore and surfaces as a bare empty page (Root Cause #2).
+    const effectiveSort = sortOptions.some((o) => o.value === sortValue)
+        ? sortValue
+        : DEFAULT_SORT;
+    // Which "Show X" toggles are meaningful for the current selection. A mixed
+    // set can need both (products sell out, auctions end).
+    const hideDefaults = hideDefaultsFor(effectiveTypes);
+    const showsSoldToggle = hideDefaults.includes("sold");
+    const showsEndedToggle = hideDefaults.includes("ended") || hideDefaults.includes("closed");
+    const showEnded = table.get(TABLE_KEYS.SHOW_ENDED) === "true";
+    // "Full <type> filters →" — a single selected type with a dedicated browse
+    // page gets a link to it, since that page carries facets this generic one
+    // can't (bid range, delivery-date window, reveal status).
+    const dedicatedPage = selectedTypes.length === 1 && pluginFor(selectedTypes[0]).browseRoute
+        ? {
+            href: pluginFor(selectedTypes[0]).browseRoute,
+            label: `Full ${pluginFor(selectedTypes[0]).pluralLabel} filters →`,
+        }
+        : null;
     const { pendingTable, filterActiveCount, onFilterApply, onFilterClear, onResetAll, onFilterReset } = usePendingTable(table, FILTER_KEYS);
     const openFilters = useCallback(() => {
         onFilterReset();
@@ -57,11 +93,19 @@ export function ProductsIndexListing({ initialData, listingTypes = GENERIC_PRODU
         setFilterOpen(false);
     }, [onFilterApply]);
     const resetAll = useCallback(() => {
-        onResetAll({ [TABLE_KEYS.QUERY]: "", [TABLE_KEYS.SORT]: "", [TABLE_KEYS.SHOW_SOLD]: "" });
+        onResetAll({
+            [TABLE_KEYS.QUERY]: "",
+            [TABLE_KEYS.SORT]: "",
+            [TABLE_KEYS.SHOW_SOLD]: "",
+            [TABLE_KEYS.SHOW_ENDED]: "",
+            [TABLE_KEYS.LISTING_TYPE]: "",
+        });
         setSearchInput("");
     }, [onResetAll]);
     const hasActiveState = !!table.get(TABLE_KEYS.QUERY) ||
         table.get(TABLE_KEYS.SHOW_SOLD) === "true" ||
+        table.get(TABLE_KEYS.SHOW_ENDED) === "true" ||
+        !!typeParam ||
         table.get(TABLE_KEYS.SORT) !== DEFAULT_SORT ||
         filterActiveCount > 0;
     const localCart = useGuestCart();
@@ -81,13 +125,27 @@ export function ProductsIndexListing({ initialData, listingTypes = GENERIC_PRODU
         brand: table.get(TABLE_KEYS.BRAND) || undefined,
         storeId: table.get(TABLE_KEYS.STORE_ID) || undefined,
         freeShipping: table.get(TABLE_KEYS.FREE_SHIPPING) === "true" ? true : undefined,
-        sort: table.get(TABLE_KEYS.SORT) || DEFAULT_SORT,
+        // These three are in FILTER_KEYS (so they count toward the filter badge)
+        // but were never put on the wire — the drawer sections were inert.
+        tags: table.get(TABLE_KEYS.TAGS) || undefined,
+        sublistingCategory: table.get(TABLE_KEYS.SUBLISTING_CATEGORY) || undefined,
+        features: table.get(TABLE_KEYS.FEATURES) || undefined,
+        sort: effectiveSort,
         page: table.getNumber(TABLE_KEYS.PAGE, 1),
         perPage: table.getNumber(TABLE_KEYS.PAGE_SIZE, 24),
-        listingType: productType === "All" ? listingTypes.join("|") : productType,
-        // Hide sold-out items by default. Uses stockQuantity>0 (always-present field)
-        // instead of status=="published" because sellers don't actively transition status.
-        inStock: showSold ? undefined : true,
+        // Pipe-joined OR-group — sievejs parses it as a same-field OR and the
+        // Firebase adapter upgrades it to a `.where(…, "in", …)` query.
+        listingType: effectiveTypes.join("|"),
+        // Hide sold-out items by default, but only when a sold-out-able type is in
+        // play — an auction has no meaningful stock, so applying it to an
+        // auctions-only view would hide every live auction.
+        inStock: showsSoldToggle && !showSold ? true : undefined,
+        // Same shape for time-boxed types. `dateFrom` only takes effect when
+        // exactly one type is selected (there is no single end-date field shared
+        // across types), which `dateFieldFor` already enforces server-side.
+        dateFrom: showsEndedToggle && !showEnded && selectedTypes.length === 1
+            ? new Date().toISOString()
+            : undefined,
     };
     const { products, totalPages, page, isLoading } = useProducts(params, { initialData });
     const selection = useBulkSelection({ items: products, keyExtractor: (p) => p.id });
@@ -200,14 +258,32 @@ export function ProductsIndexListing({ initialData, listingTypes = GENERIC_PRODU
                     },
                 },
             ] } } : {});
-    return (_jsxs(Div, { className: "min-h-screen", children: [_jsx(ListingToolbar, { filterCount: filterActiveCount, onFiltersClick: openFilters, searchValue: searchInput, searchPlaceholder: searchPlaceholder, onSearchChange: setSearchInput, onSearchCommit: commitSearch, onSearchKeyDown: handleSearchKeyDown, sortValue: table.get(TABLE_KEYS.SORT) || DEFAULT_SORT, sortOptions: PRODUCT_PUBLIC_SORT_OPTIONS, onSortChange: (v) => { table.set(TABLE_KEYS.SORT, v); }, view: view, onViewChange: handleViewToggle, onResetAll: resetAll, hasActiveState: hasActiveState, bulkMode: selection.isSelecting, bulkSelectedCount: selection.selectedCount, bulkTotalCount: products.length, onBulkSelectAll: selection.toggleAll, onBulkClear: selection.clearSelection, toggles: [
-                    { label: "Show sold", active: showSold, onChange: (next) => table.set(TABLE_KEYS.SHOW_SOLD, next ? "true" : "") },
+    return (_jsxs(Div, { className: "min-h-screen", children: [_jsx(ListingToolbar, { filterCount: filterActiveCount, onFiltersClick: openFilters, searchValue: searchInput, searchPlaceholder: searchPlaceholder, onSearchChange: setSearchInput, onSearchCommit: commitSearch, onSearchKeyDown: handleSearchKeyDown, sortValue: effectiveSort, sortOptions: sortOptions, onSortChange: (v) => { table.set(TABLE_KEYS.SORT, v); }, view: view, onViewChange: handleViewToggle, onResetAll: resetAll, hasActiveState: hasActiveState, bulkMode: selection.isSelecting, bulkSelectedCount: selection.selectedCount, bulkTotalCount: products.length, onBulkSelectAll: selection.toggleAll, onBulkClear: selection.clearSelection, toggles: [
+                    // Each toggle appears only when it means something for the selected
+                    // types — "Show ended" against a Products-only view would be noise,
+                    // and "Show sold" against an Auctions-only view is meaningless.
+                    ...(showsSoldToggle
+                        ? [{ label: "Show sold", active: showSold, onChange: (next) => table.set(TABLE_KEYS.SHOW_SOLD, next ? "true" : "") }]
+                        : []),
+                    ...(showsEndedToggle
+                        ? [{ label: "Show ended", active: showEnded, onChange: (next) => table.set(TABLE_KEYS.SHOW_ENDED, next ? "true" : "") }]
+                        : []),
                     // Inline quick-filter: the highest-frequency drawer-only facet promoted
                     // to the sticky toolbar so it doesn't require open-drawer → check → Apply
                     // → close for every toggle. The full facet set (category/price/brand/…)
                     // remains in <FilterDrawer> below.
                     { label: "Free shipping", active: table.get(TABLE_KEYS.FREE_SHIPPING) === "true", onChange: (next) => table.set(TABLE_KEYS.FREE_SHIPPING, next ? "true" : "") },
-                ] }), _jsx(Div, { padding: "y-sm", children: _jsx(FilterChipGroup, { label: "Type", tabs: typeTabs, value: productType, onChange: (v) => table.set(TABLE_KEYS.LISTING_TYPE, v === "All" ? "" : v) }) }), _jsx(BulkActionBar, { selectedCount: selection.selectedCount, onClearSelection: selection.clearSelection, actions: [
+                ] }), _jsx(Div, { padding: "y-sm", children: _jsxs(Row, { justify: "between", align: "center", wrap: true, gap: "sm", children: [_jsx(FilterChipGroup, { multiple: true, label: "Type", tabs: typeTabs, value: selectedTypes.join("|"), onChange: (next) => {
+                                // Clear `sort` alongside the type change: a sort valid for the
+                                // old selection (say -auctionEndDate) can be invalid for the new
+                                // one, and useUrlTable's single router.replace means we must set
+                                // both in ONE call — a follow-up setPage/set would read stale
+                                // searchParams and overwrite this update (Root Cause #13).
+                                table.setMany({
+                                    [TABLE_KEYS.LISTING_TYPE]: next,
+                                    [TABLE_KEYS.SORT]: "",
+                                });
+                            } }), dedicatedPage && (_jsx(TextLink, { href: dedicatedPage.href, size: "sm", weight: "medium", children: dedicatedPage.label }))] }) }), _jsx(BulkActionBar, { selectedCount: selection.selectedCount, onClearSelection: selection.clearSelection, actions: [
                     {
                         id: ACTION_ID.ADD_TO_CART,
                         label: ACTION_META[ACTION_ID.ADD_TO_CART].label,

package/dist/features/products/components/ProductsIndexPageView.js

@@ -4,19 +4,31 @@ import { Container, Div, Heading, Main, Section, Text, TextLink } from "../../..
 import { AdSlot } from "../../homepage/components/AdSlot";
 import { ProductsIndexListing } from "./ProductsIndexListing";
 import { PRODUCT_FIELDS } from "../../../constants/field-names";
+import { TABLE_KEYS } from "../../../constants/table-keys";
 import { sortBy } from "../../../constants/sort";
 import { GENERIC_PRODUCT_LISTING_TYPES } from "../constants/listing-tabs";
-import { listPublicProducts, parsePublicProductParams, } from "../../../_internal/server/features/products/list-public";
+import { listPublicProducts, parsePublicProductParams, defaultTogglesForListingTypes, } from "../../../_internal/server/features/products/list-public";
+import { parseSelectedListingTypes } from "../utils/listing-type";
 const DEFAULT_PAGE_SIZE = 24;
 const DEFAULT_SORT = sortBy(PRODUCT_FIELDS.CREATED_AT);
 export async function ProductsIndexPageView({ searchParams = {} }) {
+    // The "Show sold" / "Show ended" defaults depend on WHICH types are in play,
+    // and this page now spans all nine. Both sides derive them from the same
+    // helper — a hardcoded `hideSoldByDefault: true` here would disagree with
+    // the client the moment the user ticks Auctions, and `staleTime: Infinity`
+    // would freeze that disagreement (Root Cause #30).
+    const raw = searchParams[TABLE_KEYS.LISTING_TYPE];
+    const selectedTypes = parseSelectedListingTypes(Array.isArray(raw) ? raw[0] : raw);
+    const effectiveTypes = selectedTypes.length > 0 ? selectedTypes : GENERIC_PRODUCT_LISTING_TYPES;
+    const { hideSoldByDefault, hideEndedByDefault } = defaultTogglesForListingTypes(effectiveTypes);
     // See ArtStickersListView — one shared filter implementation with
     // /api/products, so SSR and the client refetch agree by construction.
     const products = await listPublicProducts(parsePublicProductParams(searchParams, {
         listingTypes: GENERIC_PRODUCT_LISTING_TYPES,
         pageSize: DEFAULT_PAGE_SIZE,
         sorts: DEFAULT_SORT,
-        hideSoldByDefault: true,
+        hideSoldByDefault,
+        hideEndedByDefault,
     }));
     return (_jsxs(Main, { children: [_jsx(Section, { border: "bottom-subtle", paddingY: "b-md", padding: "t-xl", children: _jsxs(Container, { size: "xl", children: [_jsx(Heading, { level: 1, size: "3xl", weight: "bold", color: "primary", children: "Products" }), _jsx(Text, { className: "mt-1", color: "muted", size: "sm", children: "Discover amazing products and deals" }), _jsx(Div, { className: "mt-3", children: _jsx(TextLink, { variant: "bare", href: String(ROUTES.PUBLIC.AUCTIONS), rounded: "full", paddingX: "sm", paddingY: "2xs", size: "xs", weight: "medium", layout: "inline-flex", align: "center", gap: "sm", className: "border border-primary/30 bg-primary/10 text-primary-700 dark:text-primary-400 hover:bg-primary/15 transition-colors", children: "\uD83C\uDFF7\uFE0F Looking for unique deals? Browse Auctions \u2192" }) })] }) }), _jsxs(Container, { size: "xl", padding: "x-md", children: [_jsx(AdSlot, { id: "listing-sidebar-top", className: "mb-4 mt-4" }), _jsx(ProductsIndexListing, { initialData: products }), _jsx(AdSlot, { id: "listing-sidebar-bottom", className: "mt-8" })] })] }));
 }

package/dist/features/products/config/listing-type-listing-config.d.ts

@@ -0,0 +1,31 @@
+import type { JsonArray } from "../../../schemas/types";
+import type { ListingType } from "../types";
+import type { ListingViewConfig } from "../../admin/components/DataListingView";
+export interface ListingTypeListingRow {
+    id: string;
+    primary: string;
+    secondary: string;
+    status: string;
+    updatedAt: string;
+    image?: string;
+}
+interface ListingTypeListingResponse {
+    items?: JsonArray;
+    total?: number;
+}
+export interface BuildListingTypeListingOptions {
+    /** Override the page heading; defaults to the type's registered plural label. */
+    title?: string;
+    searchPlaceholder?: string;
+    emptyLabel?: string;
+}
+/**
+ * Admin browse config for one listing type.
+ *
+ * `status` is a real filter here (unlike the five hand-written copies, which
+ * offered none) because an admin's main reason to open a per-type list is to
+ * find the drafts and in-review items — exactly the rows a status filter
+ * surfaces.
+ */
+export declare function buildListingTypeListingConfig(type: ListingType, opts?: BuildListingTypeListingOptions): ListingViewConfig<ListingTypeListingResponse, ListingTypeListingRow>;
+export {};

package/dist/features/products/config/listing-type-listing-config.js

@@ -0,0 +1,74 @@
+/*
+ * WHY: Five admin views (Art, Stickers, Classified, Digital Codes, Live Items)
+ *      were five copies of ONE config that differed only by listing type,
+ *      title and placeholder text. Five copies is well past the Duplication
+ *      Framework's Rule of Three, and it showed: every one carried
+ *      `filterKeys: []` (no filter drawer at all despite filterable data) and
+ *      its own hand-written three-option sort array, so a fix to any of it had
+ *      to be applied five times and never was.
+ *
+ * WHAT: `buildListingTypeListingConfig(type, opts)` — one config, driven by
+ *       the listing-type plugin registry. Title, sort set and per-type facet
+ *       keys all come from `pluginFor(type)`, so a new listing type gets a
+ *       working admin browse page with no new file.
+ *
+ * EXPORTS: ListingTypeListingRow, BuildListingTypeListingOptions,
+ *          buildListingTypeListingConfig
+ *
+ * @tag domain:products
+ * @tag layer:config
+ * @tag pattern:factory
+ * @tag access:client
+ * @tag consumers:AdminArtView,AdminStickersView,AdminClassifiedView,AdminDigitalCodesView,AdminLiveView
+ * @tag sideEffects:none
+ */
+import { SIEVE_OP, sieveAnd, sieveFilter } from "../../../utils/sieve-builder";
+import { sortBy } from "../../../constants/sort";
+import { PRODUCT_FIELDS } from "../../../constants/field-names";
+import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
+import { ROUTES } from "../../../next/routing/route-map";
+import { pluginFor } from "../../../_internal/shared/listing-types/_registry";
+import { toRecordArray, toRelativeDate, toCurrency, toStringValue, } from "../../admin/hooks/useAdminListingData";
+/**
+ * Admin browse config for one listing type.
+ *
+ * `status` is a real filter here (unlike the five hand-written copies, which
+ * offered none) because an admin's main reason to open a per-type list is to
+ * find the drafts and in-review items — exactly the rows a status filter
+ * surfaces.
+ */
+export function buildListingTypeListingConfig(type, opts = {}) {
+    const plugin = pluginFor(type);
+    const label = opts.title ?? plugin.pluralLabel;
+    return {
+        portal: "admin",
+        title: label,
+        searchPlaceholder: opts.searchPlaceholder ?? `Search ${label.toLowerCase()} by name or seller`,
+        emptyLabel: opts.emptyLabel ?? `No ${label.toLowerCase()} listings`,
+        filterKeys: ["status"],
+        defaultSort: sortBy(PRODUCT_FIELDS.CREATED_AT),
+        // Keyed on the canonical type so two types can never share a cache entry.
+        queryKey: ["admin", "listing-type", type],
+        endpoint: ADMIN_ENDPOINTS.PRODUCTS,
+        // The type's own sort set, not a copy-pasted three-option array.
+        sortOptions: [...plugin.sortOptions],
+        mapRows: (response) => toRecordArray(response.items).map((item, index) => ({
+            id: toStringValue(item.id, `${type}-${index}`),
+            primary: toStringValue(item.title ?? item.productTitle, "Untitled listing"),
+            secondary: [
+                toStringValue(item.sellerName, "Unknown seller"),
+                toCurrency(item.price),
+            ].join(" · "),
+            status: toStringValue(item.status, "draft"),
+            updatedAt: toRelativeDate(item.updatedAt ?? item.createdAt),
+            image: toStringValue(item.mainImage, "") || undefined,
+        })),
+        getTotal: (response, mappedRows) => typeof response.total === "number" ? response.total : mappedRows.length,
+        buildFilters: (state) => sieveAnd(sieveFilter(PRODUCT_FIELDS.LISTING_TYPE, SIEVE_OP.EQ, type), state.status && state.status !== "All"
+            ? sieveFilter(PRODUCT_FIELDS.STATUS, SIEVE_OP.EQ, state.status)
+            : "") || undefined,
+        // These are products filtered by listingType — reuse the real admin
+        // product editor rather than leaving rows non-navigable.
+        rowHrefTemplate: String(ROUTES.ADMIN.PRODUCTS_EDIT("{id}")),
+    };
+}

package/dist/features/products/hooks/useProducts.js

@@ -52,6 +52,20 @@ export function useProducts(params = {}, opts) {
         sp.set("brand", params.brand);
     if (params.freeShipping !== undefined)
         sp.set("freeShipping", String(params.freeShipping));
+    // Pipe-joined multi-select facets. Omitted here until 2026-08-21, so the
+    // Tags / Sublisting Type / Features drawer sections were inert.
+    if (params.tags)
+        sp.set("tags", params.tags);
+    if (params.sublistingCategory)
+        sp.set("sublistingCategory", params.sublistingCategory);
+    if (params.features)
+        sp.set("features", params.features);
+    // Per-type facets travel under their own TABLE_KEY names, which is what
+    // parsePublicProductParams reads them back from.
+    for (const [key, value] of Object.entries(params.typeFacets ?? {})) {
+        if (value)
+            sp.set(key, value);
+    }
     const qs = sp.toString();
     const query = useQuery({
         queryKey: ["products", qs],

package/dist/features/products/types/index.d.ts

@@ -202,4 +202,19 @@ export interface ProductListParams {
     brand?: string;
     /** Shipping / free shipping */
     freeShipping?: boolean;
+    /**
+     * Pipe-joined multi-select facets. All three were rendered by
+     * `<ProductFilters>` and counted toward the active-filter badge, but no
+     * caller ever put them on the wire — ticking one inflated the badge and
+     * changed nothing (fixed 2026-08-21).
+     */
+    tags?: string;
+    sublistingCategory?: string;
+    features?: string;
+    /**
+     * Per-listing-type facets keyed by TABLE_KEY (classified city/negotiable,
+     * digital-code deliveryMethod, live species/sex/jurisdiction). The server
+     * resolves each to its nested Firestore path and ignores unknown keys.
+     */
+    typeFacets?: Record<string, string>;
 }

package/dist/features/seller/components/SellerOrdersView.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { OrderAddonBadges } from "../../orders/components/OrderAddonBadges";
 import { normalizeError } from "../../../errors/normalize";
 import { Row, SIEVE_OP, sieveFilter } from "@mohasinac/appkit/client";
 import { sortBy } from "@mohasinac/appkit/client";
@@ -167,7 +168,7 @@ export function SellerOrderDetailPanel({ orderId, apiBase, onClose, }) {
     };
     const addr = order?.shippingAddress ?? {};
     const addrLine = [addr.addressLine1, addr.city, addr.state, addr.pincode].filter(Boolean).join(", ");
-    return (_jsxs(_Fragment, { children: [loading && (_jsx(Row, { align: "center", justify: "center", padding: "y-4xl", children: _jsx(Div, { className: "h-6 w-6 animate-spin border-2 border-[var(--appkit-color-primary)] border-t-transparent", rounded: "full" }) })), fetchError && (_jsx(Div, { textSize: "sm", className: "mx-4 mt-4 border border-error/20", color: "error", surface: "danger-surface", padding: "inline", rounded: "lg", children: fetchError })), order && !loading && (_jsxs(Stack, { gap: "none", children: [_jsxs(Stack, { className: `flex-1 ${__O.yAuto}`, gap: "5", padding: "md", children: [_jsxs(Row, { align: "center", justify: "between", children: [_jsx(Badge, { variant: STATUS_BADGE_VARIANT[order.status?.toUpperCase()] ?? "default", children: order.status ?? "Unknown" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-secondary)]", children: toRelativeDate(order.createdAt) })] }), (order.items ?? []).length > 0 && (_jsxs(Div, { children: [_jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-primary)] mb-2", weight: "semibold", children: "Items" }), _jsx(Div, { className: "divide-y divide-[var(--appkit-color-border)] divide-[var(--appkit-color-border)] border border-[var(--appkit-color-border)]", rounded: "lg", children: (order.items ?? []).map((item, i) => (_jsxs(Row, { paddingY: "y-xs-tall", padding: "x-sm", align: "center", justify: "between", gap: "3", children: [_jsxs(Row, { align: "center", gap: "sm", className: "min-w-0", children: [_jsx(Div, { className: "h-10 w-10 shrink-0", rounded: "md", overflow: "hidden", children: _jsx(MediaImage, { src: item.image, alt: item.title ?? "Order item", size: "thumbnail" }) }), _jsxs(Div, { className: "min-w-0", children: [_jsx(Text, { size: "sm", className: "truncate", weight: "medium", children: item.title ?? item.productId ?? "Item" }), _jsxs(Text, { size: "xs", className: "text-[var(--appkit-color-text-secondary)]", children: ["Qty: ", item.quantity ?? 1] })] })] }), _jsx(Text, { size: "sm", className: "shrink-0", weight: "medium", children: toCurrency(item.price ?? 0) })] }, i))) })] })), order.giftWrapAddon && (_jsxs(Div, { className: "border border-[var(--appkit-color-primary-200)] dark:border-[var(--appkit-color-primary-800)]", surface: "subtle", padding: "inline", rounded: "lg", children: [_jsx(Text, { size: "sm", weight: "semibold", children: "\uD83C\uDF81 Gift wrap requested" }), order.giftWrapMessage && (_jsxs(Text, { size: "sm", className: "mt-1 text-[var(--appkit-color-text-secondary)]", children: ["\u201C", order.giftWrapMessage, "\u201D"] }))] })), _jsxs(Row, { surface: "muted", padding: "inline", align: "center", justify: "between", rounded: "lg", children: [_jsx(Text, { size: "sm", weight: "semibold", children: "Total" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-primary)]", weight: "bold", children: toCurrency(order.totalAmount ?? 0) })] }), addrLine && (_jsxs(Div, { children: [_jsx(Text, { size: "sm", className: "mb-1", weight: "semibold", children: "Shipping address" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-secondary)]", children: [String(addr.fullName ?? ""), addrLine].filter(Boolean).join(" · ") })] })), order.paymentMethod && (_jsxs(Div, { children: [_jsxs(Row, { align: "center", justify: "between", className: "mb-1", gap: "3", children: [_jsx(Text, { size: "sm", weight: "semibold", children: "Payment" }), isManualPaymentMethod(order.paymentMethod) && (_jsx(Badge, { variant: sellerPaymentBadge(order).variant, children: sellerPaymentBadge(order).label }))] }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-secondary)]", transform: "capitalize", children: order.paymentMethod }), isManualPaymentMethod(order.paymentMethod) && order.paymentTransactionId && (_jsxs(Text, { size: "xs", color: "muted", className: "mt-1", children: ["UTR: ", order.paymentTransactionId] }))] })), order.emiEnabled && (_jsxs(Div, { className: "border-t border-[var(--appkit-color-border)]", padding: "t-md", children: [_jsxs(Row, { align: "center", justify: "between", className: "mb-2", children: [_jsxs(Text, { size: "sm", weight: "semibold", children: ["EMI plan ", order.emiTenureMonths ? `· ${order.emiTenureMonths} months` : ""] }), _jsx(Badge, { variant: order.emiComplete ? "success" : "warning", children: order.emiComplete ? "Fully paid" : "In progress" })] }), _jsxs(Row, { align: "center", justify: "between", className: "mb-2", children: [_jsx(Text, { size: "xs", color: "muted", children: "Token collected" }), _jsx(Text, { size: "xs", weight: "medium", children: toCurrency(order.emiTokenAmount ?? 0) })] }), _jsxs(Row, { align: "center", justify: "between", className: "mb-3", children: [_jsx(Text, { size: "xs", color: "muted", children: "Remaining balance" }), _jsx(Text, { size: "xs", weight: "medium", children: toCurrency(order.emiRemainingBalance ?? 0) })] }), _jsx(Div, { className: "divide-y divide-[var(--appkit-color-border)] border border-[var(--appkit-color-border)]", rounded: "lg", children: (order.emiInstallments ?? []).map((inst) => (_jsxs(Row, { paddingY: "y-xs-tall", padding: "x-sm", align: "center", justify: "between", gap: "3", children: [_jsxs(Div, { className: "min-w-0", children: [_jsxs(Text, { size: "sm", weight: "medium", children: ["Installment ", inst.index, " \u00B7 ", toCurrency(inst.amount)] }), _jsx(Text, { size: "xs", color: "muted", children: inst.status === "paid" && inst.paidAt
+    return (_jsxs(_Fragment, { children: [loading && (_jsx(Row, { align: "center", justify: "center", padding: "y-4xl", children: _jsx(Div, { className: "h-6 w-6 animate-spin border-2 border-[var(--appkit-color-primary)] border-t-transparent", rounded: "full" }) })), fetchError && (_jsx(Div, { textSize: "sm", className: "mx-4 mt-4 border border-error/20", color: "error", surface: "danger-surface", padding: "inline", rounded: "lg", children: fetchError })), order && !loading && (_jsxs(Stack, { gap: "none", children: [_jsxs(Stack, { className: `flex-1 ${__O.yAuto}`, gap: "5", padding: "md", children: [_jsxs(Row, { align: "center", justify: "between", children: [_jsx(Badge, { variant: STATUS_BADGE_VARIANT[order.status?.toUpperCase()] ?? "default", children: order.status ?? "Unknown" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-secondary)]", children: toRelativeDate(order.createdAt) })] }), (order.items ?? []).length > 0 && (_jsxs(Div, { children: [_jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-primary)] mb-2", weight: "semibold", children: "Items" }), _jsx(Div, { className: "divide-y divide-[var(--appkit-color-border)] divide-[var(--appkit-color-border)] border border-[var(--appkit-color-border)]", rounded: "lg", children: (order.items ?? []).map((item, i) => (_jsxs(Row, { paddingY: "y-xs-tall", padding: "x-sm", align: "center", justify: "between", gap: "3", children: [_jsxs(Row, { align: "center", gap: "sm", className: "min-w-0", children: [_jsx(Div, { className: "h-10 w-10 shrink-0", rounded: "md", overflow: "hidden", children: _jsx(MediaImage, { src: item.image, alt: item.title ?? "Order item", size: "thumbnail" }) }), _jsxs(Div, { className: "min-w-0", children: [_jsx(Text, { size: "sm", className: "truncate", weight: "medium", children: item.title ?? item.productId ?? "Item" }), _jsxs(Text, { size: "xs", className: "text-[var(--appkit-color-text-secondary)]", children: ["Qty: ", item.quantity ?? 1] })] })] }), _jsx(Text, { size: "sm", className: "shrink-0", weight: "medium", children: toCurrency(item.price ?? 0) })] }, i))) })] })), _jsx(OrderAddonBadges, { order: order, variant: "detail" }), order.giftWrapAddon && (_jsxs(Div, { className: "border border-[var(--appkit-color-primary-200)] dark:border-[var(--appkit-color-primary-800)]", surface: "subtle", padding: "inline", rounded: "lg", children: [_jsx(Text, { size: "sm", weight: "semibold", children: "\uD83C\uDF81 Gift wrap requested" }), order.giftWrapMessage && (_jsxs(Text, { size: "sm", className: "mt-1 text-[var(--appkit-color-text-secondary)]", children: ["\u201C", order.giftWrapMessage, "\u201D"] }))] })), _jsxs(Row, { surface: "muted", padding: "inline", align: "center", justify: "between", rounded: "lg", children: [_jsx(Text, { size: "sm", weight: "semibold", children: "Total" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-primary)]", weight: "bold", children: toCurrency(order.totalAmount ?? 0) })] }), addrLine && (_jsxs(Div, { children: [_jsx(Text, { size: "sm", className: "mb-1", weight: "semibold", children: "Shipping address" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-secondary)]", children: [String(addr.fullName ?? ""), addrLine].filter(Boolean).join(" · ") })] })), order.paymentMethod && (_jsxs(Div, { children: [_jsxs(Row, { align: "center", justify: "between", className: "mb-1", gap: "3", children: [_jsx(Text, { size: "sm", weight: "semibold", children: "Payment" }), isManualPaymentMethod(order.paymentMethod) && (_jsx(Badge, { variant: sellerPaymentBadge(order).variant, children: sellerPaymentBadge(order).label }))] }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-secondary)]", transform: "capitalize", children: order.paymentMethod }), isManualPaymentMethod(order.paymentMethod) && order.paymentTransactionId && (_jsxs(Text, { size: "xs", color: "muted", className: "mt-1", children: ["UTR: ", order.paymentTransactionId] }))] })), order.emiEnabled && (_jsxs(Div, { className: "border-t border-[var(--appkit-color-border)]", padding: "t-md", children: [_jsxs(Row, { align: "center", justify: "between", className: "mb-2", children: [_jsxs(Text, { size: "sm", weight: "semibold", children: ["EMI plan ", order.emiTenureMonths ? `· ${order.emiTenureMonths} months` : ""] }), _jsx(Badge, { variant: order.emiComplete ? "success" : "warning", children: order.emiComplete ? "Fully paid" : "In progress" })] }), _jsxs(Row, { align: "center", justify: "between", className: "mb-2", children: [_jsx(Text, { size: "xs", color: "muted", children: "Token collected" }), _jsx(Text, { size: "xs", weight: "medium", children: toCurrency(order.emiTokenAmount ?? 0) })] }), _jsxs(Row, { align: "center", justify: "between", className: "mb-3", children: [_jsx(Text, { size: "xs", color: "muted", children: "Remaining balance" }), _jsx(Text, { size: "xs", weight: "medium", children: toCurrency(order.emiRemainingBalance ?? 0) })] }), _jsx(Div, { className: "divide-y divide-[var(--appkit-color-border)] border border-[var(--appkit-color-border)]", rounded: "lg", children: (order.emiInstallments ?? []).map((inst) => (_jsxs(Row, { paddingY: "y-xs-tall", padding: "x-sm", align: "center", justify: "between", gap: "3", children: [_jsxs(Div, { className: "min-w-0", children: [_jsxs(Text, { size: "sm", weight: "medium", children: ["Installment ", inst.index, " \u00B7 ", toCurrency(inst.amount)] }), _jsx(Text, { size: "xs", color: "muted", children: inst.status === "paid" && inst.paidAt
                                                                 ? `Paid ${toRelativeDate(inst.paidAt)}`
                                                                 : inst.dueDate
                                                                     ? `Due ${toRelativeDate(inst.dueDate)}`

package/dist/features/stores/components/StoreArtStickersPageView.d.ts

@@ -0,0 +1,21 @@
+import React from "react";
+type SearchParams = Record<string, string | string[]>;
+export interface StoreArtStickersPageViewProps {
+    storeSlug: string;
+    searchParams?: SearchParams;
+}
+/**
+ * A store's combined Art & Stickers tab.
+ *
+ * This page did not exist until 2026-08-21: `STORE_PAGE_TABS` had an
+ * "Art & Stickers" entry with a real count query behind it, but its href
+ * pointed at `STORE_PRODUCTS` — a page that filters `listingType == standard`.
+ * So the tab advertised a non-zero count and then rendered none of those items,
+ * with no error. Same shape as the category/brand tabs that rendered blank
+ * panels (see `audit-tab-body-coverage.mjs`), one level up.
+ *
+ * Mirrors the public `/art` page in spanning both types at once, since neither
+ * has enough inventory to justify a tab of its own.
+ */
+export declare function StoreArtStickersPageView({ storeSlug, searchParams, }: StoreArtStickersPageViewProps): Promise<React.JSX.Element | null>;
+export {};

package/dist/features/stores/components/StoreArtStickersPageView.js

@@ -0,0 +1,30 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { PRODUCT_FIELDS } from "../../../constants/field-names";
+import { sortBy } from "../../../constants/sort";
+import { listStoreProducts } from "../../../_internal/server/features/products/list-public";
+import { ART_STICKERS_LISTING_TYPES } from "../../products/constants/listing-tabs";
+import { getStoreBySlug } from "./StoreDetailLayoutView";
+import { StoreProductsListing } from "./StoreProductsListing";
+const DEFAULT_PAGE_SIZE = 24;
+const DEFAULT_SORT = sortBy(PRODUCT_FIELDS.CREATED_AT);
+/**
+ * A store's combined Art & Stickers tab.
+ *
+ * This page did not exist until 2026-08-21: `STORE_PAGE_TABS` had an
+ * "Art & Stickers" entry with a real count query behind it, but its href
+ * pointed at `STORE_PRODUCTS` — a page that filters `listingType == standard`.
+ * So the tab advertised a non-zero count and then rendered none of those items,
+ * with no error. Same shape as the category/brand tabs that rendered blank
+ * panels (see `audit-tab-body-coverage.mjs`), one level up.
+ *
+ * Mirrors the public `/art` page in spanning both types at once, since neither
+ * has enough inventory to justify a tab of its own.
+ */
+export async function StoreArtStickersPageView({ storeSlug, searchParams, }) {
+    const store = await getStoreBySlug(storeSlug);
+    const storeId = store?.id;
+    if (typeof storeId !== "string" || !storeId)
+        return null;
+    const result = await listStoreProducts(storeId, ART_STICKERS_LISTING_TYPES, searchParams ?? {}, { pageSize: DEFAULT_PAGE_SIZE, sorts: DEFAULT_SORT });
+    return (_jsx(StoreProductsListing, { storeId: storeId, listingTypes: ART_STICKERS_LISTING_TYPES, initialData: result ?? undefined }));
+}

package/dist/features/stores/components/StoreAuctionsPageView.d.ts

@@ -1,5 +1,8 @@
 import React from "react";
+type SearchParams = Record<string, string | string[]>;
 export interface StoreAuctionsPageViewProps {
     storeSlug: string;
+    searchParams?: SearchParams;
 }
-export declare function StoreAuctionsPageView({ storeSlug }: StoreAuctionsPageViewProps): Promise<React.JSX.Element | null>;
+export declare function StoreAuctionsPageView({ storeSlug, searchParams }: StoreAuctionsPageViewProps): Promise<React.JSX.Element | null>;
+export {};

package/dist/features/stores/components/StoreAuctionsPageView.js

@@ -1,24 +1,24 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { sieveFilter, sieveAnd, SIEVE_OP } from "@mohasinac/appkit";
-import { sortBy } from "@mohasinac/appkit";
-import { productRepository } from "../../../repositories";
+import { PRODUCT_FIELDS } from "../../../constants/field-names";
+import { sortBy } from "../../../constants/sort";
+import { listStoreProducts } from "../../../_internal/server/features/products/list-public";
 import { getStoreBySlug } from "./StoreDetailLayoutView";
 import { StoreAuctionsListing } from "./StoreAuctionsListing";
-export async function StoreAuctionsPageView({ storeSlug }) {
+const LISTING_TYPES = ["auction"];
+const DEFAULT_PAGE_SIZE = 24;
+const DEFAULT_SORT = sortBy(PRODUCT_FIELDS.AUCTION_END_DATE, "ASC");
+export async function StoreAuctionsPageView({ storeSlug, searchParams }) {
     const store = await getStoreBySlug(storeSlug);
     const storeId = store?.id;
-    const result = storeId
-        ? await productRepository
-            .list({
-            filters: sieveAnd(sieveFilter("storeId", SIEVE_OP.EQ, storeId), sieveFilter("status", SIEVE_OP.EQ, "published"), sieveFilter("listingType", SIEVE_OP.EQ, "auction")),
-            sorts: sortBy("auctionEndDate", "ASC"),
-            page: 1,
-            pageSize: 24,
-        })
-            .catch(() => null)
-        : null;
-    if (!storeId) {
+    if (typeof storeId !== "string" || !storeId)
         return null;
-    }
-    return (_jsx(StoreAuctionsListing, { storeId: storeId, initialData: result ?? undefined }));
+    // Shared query — see listStoreProducts. This view used to call
+    // productRepository.list() with an inline filter string and swallow every
+    // failure via a bare .catch(() => null), so a missing index rendered as an
+    // empty store tab with nothing logged (Root Cause #30's family).
+    const result = await listStoreProducts(storeId, LISTING_TYPES, searchParams ?? {}, {
+        pageSize: DEFAULT_PAGE_SIZE,
+        sorts: DEFAULT_SORT,
+    });
+    return _jsx(StoreAuctionsListing, { storeId: storeId, initialData: result ?? undefined });
 }

package/dist/features/stores/components/StoreClassifiedsListing.js

@@ -37,6 +37,13 @@ export function StoreClassifiedsListing({ storeId, initialData }) {
         perPage: table.getNumber("pageSize", 24),
         storeId: storeId || undefined,
         listingType: "classified",
+        // Per-type facets — declared in FILTER_KEYS (so they counted toward the
+        // filter badge) and rendered in the drawer, but never sent until 2026-08-21.
+        typeFacets: {
+            [TABLE_KEYS.CITY]: table.get(TABLE_KEYS.CITY),
+            [TABLE_KEYS.NEGOTIABLE]: table.get(TABLE_KEYS.NEGOTIABLE),
+            [TABLE_KEYS.ACCEPTS_SHIPPING]: table.get(TABLE_KEYS.ACCEPTS_SHIPPING),
+        },
     };
     const { products, totalPages, page, isLoading } = useProducts(params, { initialData });
     const gridClass = "grid grid-cols-2 sm:grid-cols-3 lg:grid-cols-4 gap-[var(--appkit-space-4)]";

package/dist/features/stores/components/StoreClassifiedsPageView.d.ts

@@ -1,5 +1,8 @@
 import React from "react";
+type SearchParams = Record<string, string | string[]>;
 export interface StoreClassifiedsPageViewProps {
     storeSlug: string;
+    searchParams?: SearchParams;
 }
-export declare function StoreClassifiedsPageView({ storeSlug }: StoreClassifiedsPageViewProps): Promise<React.JSX.Element | null>;
+export declare function StoreClassifiedsPageView({ storeSlug, searchParams }: StoreClassifiedsPageViewProps): Promise<React.JSX.Element | null>;
+export {};