@mohasinac/appkit 4.47.0 → 4.48.0

package/dist/seed/_helpers/category-names.js

@@ -0,0 +1,118 @@
+import { CATEGORY_FOREST } from "./category-forest.js";
+let nameById = null;
+/** id -> its ancestors, NEAREST FIRST (parent, grandparent, …, root). */
+let ancestorsById = null;
+function build() {
+    const n = new Map();
+    const a = new Map();
+    const walk = (nodes, trail) => {
+        for (const node of nodes ?? []) {
+            if (typeof node.id === "string") {
+                n.set(node.id, node.name);
+                a.set(node.id, [...trail]);
+                walk(node.children, [node.id, ...trail]);
+            }
+            else {
+                // A node with no id contributes no ancestry, but its children still do.
+                walk(node.children, trail);
+            }
+        }
+    };
+    walk(CATEGORY_FOREST, []);
+    nameById = n;
+    ancestorsById = a;
+}
+function names() {
+    if (!nameById)
+        build();
+    return nameById;
+}
+function ancestors() {
+    if (!ancestorsById)
+        build();
+    return ancestorsById;
+}
+export function deriveCategoryNames(slugs) {
+    if (!Array.isArray(slugs) || slugs.length === 0)
+        return undefined;
+    const byId = names();
+    return slugs.map((id) => byId.get(id) ?? id);
+}
+/**
+ * Derive the full ancestor closure from the head of an existing chain.
+ *
+ * ## 🛑 The drift this ends — measured, 6 of 1,039 live products
+ *
+ * `categorySlugs` is the ancestor closure and it was hand-written per record
+ * too, so a chain could SKIP A TIER and nothing noticed:
+ *
+ *     product-beyblade-original-driger-v
+ *       got      driger-v > original-tops > beyblade-original > spinning-tops
+ *       expected driger-v > original-magnacore > original-tops > …
+ *
+ * The category page matches `array-contains-any [its own id]` against this
+ * array (CLAUDE.md: "a category page matches on its own id alone"), so a
+ * missing intermediate means the product is **absent from that node's page**
+ * while appearing correctly on every other node in its chain. Six products were
+ * invisible on their own system sub-line.
+ *
+ * `countersReconcile`'s rollup invariant cannot see this: it computes the counts
+ * FROM these closures, so a skipped tier is simply a tier with a lower count,
+ * and `own + Σ(children.total) === total` still holds exactly. The only way to
+ * find it is to re-derive the chain and compare.
+ *
+ * ## 🛑 A SECOND ASSIGNMENT IS LEFT ALONE, NOT COLLAPSED
+ *
+ * This derives from `slugs[0]` — the head, which is what `readAssignments`
+ * treats as the assignment. A product filed under two roots would carry two
+ * concatenated closures, and deriving from the head alone would silently DELETE
+ * the second one, turning a drift-fix into data loss.
+ *
+ * So the rule is: overwrite only when the existing array is a SUBSET of the
+ * derived closure. That is precisely the drift case (ids missing from the
+ * middle). An id outside the derived closure means either a second assignment
+ * or something this helper cannot safely interpret, and both must survive to be
+ * reported rather than be quietly rewritten.
+ *
+ * Measured when this was written: 0 of 71 seeded products carry `categoryIds`
+ * and 0 carry a multi-root closure — so the subset rule fires on all six real
+ * cases and guards a case that does not exist yet.
+ */
+export function deriveCategoryClosure(slugs) {
+    if (!Array.isArray(slugs) || slugs.length === 0)
+        return undefined;
+    const head = slugs[0];
+    const chain = ancestors().get(head);
+    // An unknown head keeps its hand-written chain: inventing one from a node the
+    // forest does not have would be worse than leaving a visibly wrong value for
+    // the dangling-id sweep to find.
+    if (!chain)
+        return undefined;
+    const derived = [head, ...chain];
+    const outside = slugs.filter((s) => !derived.includes(s));
+    if (outside.length > 0)
+        return undefined;
+    return derived;
+}
+/**
+ * Pipeline step: replace whatever `categorySlugs` and `categoryNames` a record
+ * carries with the derivation. Deliberately an OVERWRITE rather than a
+ * fill-if-absent — a hand-written value that disagrees IS the defect, so
+ * preferring it would preserve every one of them.
+ *
+ * Order matters: the closure is derived first, then the names from the derived
+ * closure. Deriving names from the stale chain and then fixing the chain would
+ * leave the two mirrors disagreeing again, one tier apart.
+ */
+export function withDerivedCategoryNames(p) {
+    const closure = deriveCategoryClosure(p.categorySlugs);
+    const slugs = closure ?? p.categorySlugs;
+    const names = deriveCategoryNames(slugs);
+    if (!closure && !names)
+        return p;
+    return {
+        ...p,
+        ...(closure ? { categorySlugs: closure } : {}),
+        ...(names ? { categoryNames: names } : {}),
+    };
+}

package/dist/seed/_helpers/character-features.d.ts

@@ -7,4 +7,4 @@ export interface CharacterSeed {
     beyCount: number;
 }
 export declare const CHARACTER_SEEDS: CharacterSeed[];
-export declare const CHARACTER_SEED_COUNT = 93;
+export declare const CHARACTER_SEED_COUNT = 94;

package/dist/seed/_helpers/character-features.js

@@ -22,11 +22,11 @@
  */
 export const CHARACTER_SEEDS = [
     { slug: "blader-tyson-granger", name: "Tyson Granger", beyCount: 9 },
-    { slug: "blader-kai-hiwatari", name: "Kai Hiwatari", beyCount: 7 },
+    { slug: "blader-kai-hiwatari", name: "Kai Hiwatari", beyCount: 8 },
+    { slug: "blader-shu-kurenai", name: "Shu Kurenai", beyCount: 7 },
     { slug: "blader-daichi-sumeragi", name: "Daichi Sumeragi", beyCount: 6 },
     { slug: "blader-max-tate", name: "Max Tate", beyCount: 6 },
     { slug: "blader-ray-kon", name: "Ray Kon", beyCount: 6 },
-    { slug: "blader-shu-kurenai", name: "Shu Kurenai", beyCount: 6 },
     { slug: "blader-gingka-hagane", name: "Gingka Hagane", beyCount: 5 },
     { slug: "blader-lui-shirosagi", name: "Lui Shirosagi", beyCount: 5 },
     { slug: "blader-tala", name: "Tala", beyCount: 5 },
@@ -56,6 +56,7 @@ export const CHARACTER_SEEDS = [
     { slug: "blader-michael-summers", name: "Michael Summers", beyCount: 2 },
     { slug: "blader-miguel", name: "Miguel", beyCount: 2 },
     { slug: "blader-ozuma", name: "Ozuma", beyCount: 2 },
+    { slug: "blader-rago", name: "Rago", beyCount: 2 },
     { slug: "blader-robin-kazami", name: "Robin Kazami", beyCount: 2 },
     { slug: "blader-tsubasa-otori", name: "Tsubasa Otori", beyCount: 2 },
     { slug: "blader-wakiya-murasaki", name: "Wakiya Murasaki", beyCount: 2 },
@@ -75,6 +76,7 @@ export const CHARACTER_SEEDS = [
     { slug: "blader-dan-sodo-and-reiki-sodo", name: "Dan Sodo and Reiki Sodo", beyCount: 1 },
     { slug: "blader-doji", name: "Doji", beyCount: 1 },
     { slug: "blader-faust", name: "Faust", beyCount: 1 },
+    { slug: "blader-fubuki-sumiye", name: "Fubuki Sumiye", beyCount: 1 },
     { slug: "blader-garland-siebald", name: "Garland Siebald", beyCount: 1 },
     { slug: "blader-gary", name: "Gary", beyCount: 1 },
     { slug: "blader-ginro", name: "Ginro", beyCount: 1 },
@@ -98,7 +100,6 @@ export const CHARACTER_SEEDS = [
     { slug: "blader-nine-kurosu", name: "Nine Kurosu", beyCount: 1 },
     { slug: "blader-omega-shiroboshi", name: "Omega Shiroboshi", beyCount: 1 },
     { slug: "blader-phi", name: "Phi", beyCount: 1 },
-    { slug: "blader-rago", name: "Rago", beyCount: 1 },
     { slug: "blader-reiji-mizuchi", name: "Reiji Mizuchi", beyCount: 1 },
     { slug: "blader-reiyu-kuwabara", name: "Reiyu Kuwabara", beyCount: 1 },
     { slug: "blader-rex-jura", name: "Rex Jura", beyCount: 1 },
@@ -115,4 +116,4 @@ export const CHARACTER_SEEDS = [
     { slug: "blader-yuni-naniwa", name: "Yuni Naniwa", beyCount: 1 },
     { slug: "blader-zyro-kurogane", name: "Zyro Kurogane", beyCount: 1 },
 ];
-export const CHARACTER_SEED_COUNT = 93;
+export const CHARACTER_SEED_COUNT = 94;

package/dist/seed/_helpers/final-sale-fixtures.js

@@ -36,7 +36,7 @@ export const RETURNABLE_FIXTURE_IDS = new Set([
     // art
     "art-valkyrie-holographic-print",
     // stickers
-    "stickers-beyblade-x-holographic-pack",
+    "sticker-beyblade-x-holographic-pack",
 ]);
 /**
  * Set `finalSale: false` on the opted-out fixtures and leave it ABSENT on

package/dist/seed/categories-seed-data.js

@@ -59,6 +59,7 @@ import { BRAND_ROW_COUNT, buildBrandRows } from "./_helpers/brand-rows.js";
 import { MODEL_LEAF_COUNT } from "./_helpers/category-models.js";
 import { PART_LEAF_COUNT } from "./_helpers/category-parts.js";
 import { MARKET_BAND_LEAF_IDS } from "./_helpers/category-content.js";
+import { GENERATED_CATEGORY_CONTENT, GENERATED_CATEGORY_CONTENT_COUNT, } from "./_helpers/category-content-generated.js";
 import { productsStandardSeedData } from "./products-standard-seed-data.js";
 const NOW = new Date();
 const daysAgo = (n) => new Date(NOW.getTime() - n * 86400000);
@@ -442,12 +443,42 @@ const bundleRows = [
  * name/slug/description only and silently drop the lineage search — typing
  * "burst" would stop reaching a tier-4 model under Beyblade Burst.
  */
+/**
+ * I7 — attach the GENERATED body to any row that has one and does not already
+ * carry a hand-authored one.
+ *
+ * 🛑 The generator ran and its 745 bodies were imported by NOBODY. The corpus
+ * sat in the repo as 128 KB of dead weight: not seeded, so not in Firestore,
+ * so unreadable by the page that renders it. The generator being written is
+ * not the same as its output being wired, and the second half is invisible —
+ * a category page with no body renders perfectly well, it just ranks on
+ * nothing.
+ *
+ * 🛑 A HAND-AUTHORED body always wins. The four generation roots and several
+ * tier-1 nodes carry prose written against the crawl research; the generator
+ * composes from facts and is deliberately the weaker writer at those tiers
+ * (its own header says the part leaves are its strongest tier). Overwriting
+ * authored copy with composed copy would be a silent downgrade of the exact
+ * pages this is for.
+ *
+ * 🛑 And nothing is INVENTED here: a row absent from the map keeps no body at
+ * all, because `GENERATED_CATEGORY_CONTENT` omits a node it has nothing
+ * factual to say about rather than emitting an empty one.
+ */
+function withGeneratedContent(row) {
+    if (typeof row.contentBody === "string" && row.contentBody.trim().length > 0)
+        return row;
+    const generated = row.id ? GENERATED_CATEGORY_CONTENT[row.id] : undefined;
+    return generated ? { ...row, contentBody: generated } : row;
+}
 const allCategoryRows = [
     ...rawCategories.map((c) => ({ ancestors: [], ...c, createdByType: "admin" })),
     ...sublistingRows.map((s) => ({ ancestors: [], ...s, createdByType: "admin" })),
     ...brandRows.map((b) => ({ ancestors: [], ...b, createdByType: "admin" })),
     ...bundleRows.map((b) => ({ ancestors: [], ...b })),
-].map(withCategorySearchTxt);
+]
+    .map(withGeneratedContent)
+    .map(withCategorySearchTxt);
 /*
  * ── Assertions, at MODULE LOAD, so a silent drop is loud ─────────────────────
  *
@@ -487,6 +518,29 @@ const allCategoryRows = [
  * Counting rows is not counting documents, and this is the one check that can
  * tell the difference BEFORE anything is written.
  */
+/*
+ * 🛑 THE GENERATED BODIES ACTUALLY LANDED ON ROWS.
+ *
+ * I7's corpus is a `Record<id, html>` keyed on category ids, and a key that no
+ * longer matches a row is invisible everywhere: the map still exports 745
+ * entries, the seed still loads 1,173 rows, `appkit-seed status` still reports
+ * in sync, and every one of those category pages renders without a body. That
+ * is the same failure shape as the 20 ids that overwrote each other below —
+ * counting the SOURCE is not counting what reached a row.
+ *
+ * Tolerance rather than exact equality, for one real reason: a hand-authored
+ * body legitimately wins over a generated one, so the number of rows carrying
+ * a GENERATED body is `COUNT` minus however many nodes have been written by
+ * hand since. A floor of 90% catches a key-space break (which drops it to ~0)
+ * without failing on authored prose being added.
+ */
+const generatedApplied = allCategoryRows.filter((c) => typeof c.id === "string" && GENERATED_CATEGORY_CONTENT[c.id] === c.contentBody).length;
+if (generatedApplied < Math.floor(GENERATED_CATEGORY_CONTENT_COUNT * 0.9)) {
+    throw new Error(`category seed: only ${generatedApplied} of ${GENERATED_CATEGORY_CONTENT_COUNT} generated ` +
+        `content bodies matched a row id. The corpus is keyed on category ids, so this means ` +
+        `the key space has drifted — re-run scripts/gen-category-content.mjs against the ` +
+        `current forest. Nothing would error at load time: the pages would simply have no body.`);
+}
 const allIds = allCategoryRows.map((c) => c.id).filter((x) => typeof x === "string");
 const duplicateIds = [...new Set(allIds.filter((id, i) => allIds.indexOf(id) !== i))];
 if (duplicateIds.length > 0) {

package/dist/seed/grouped-listings-seed-data.js

@@ -226,8 +226,8 @@ export const groupedListingsSeedData = [
         productIds: [
             "art-dranzer-phoenix-poster",
             "art-valkyrie-holographic-print",
-            "stickers-beyblade-original-classic-sheet",
-            "stickers-beyblade-x-holographic-pack",
+            "sticker-beyblade-original-classic-sheet",
+            "sticker-beyblade-x-holographic-pack",
         ],
         coverImage: seedPhoto("group-beyblade-fan-art-and-stickers-20260819", 1200, 900),
         groupTheme: "related",

package/dist/seed/products-art-seed-data.js

@@ -21,6 +21,7 @@ import { PRODUCT_FIELDS } from "../constants/field-names.js";
 import { buildSearchTxt } from "../utils/search-txt.js";
 import { seedPhoto } from "./_helpers/media.js";
 import { withFinalSale } from "./_helpers/final-sale-fixtures.js";
+import { withDerivedCategoryNames } from "./_helpers/category-names.js";
 const _rawProductsArtSeedData = [
     {
         id: "art-dranzer-phoenix-poster",
@@ -296,4 +297,4 @@ const _rawProductsArtSeedData = [
  * so the final-sale opt-outs are applied the same way everywhere rather than
  * being hand-written into two records that reviewers would have to find.
  */
-export const productsArtSeedData = _rawProductsArtSeedData.map(withFinalSale);
+export const productsArtSeedData = _rawProductsArtSeedData.map(withFinalSale).map(withDerivedCategoryNames);

package/dist/seed/products-auctions-seed-data.js

@@ -26,6 +26,7 @@ import { PRODUCT_FIELDS } from "../constants/field-names.js";
 import { buildSearchTxt } from "../utils/search-txt.js";
 import { seedPhoto } from "./_helpers/media.js";
 import { withFinalSale } from "./_helpers/final-sale-fixtures.js";
+import { withDerivedCategoryNames } from "./_helpers/category-names.js";
 function withTokens(p) {
     return {
         tags: [],
@@ -53,7 +54,7 @@ const _rawProductsAuctionsSeedData = [
         slug: "auction-beyblade-original-dragoon-storm",
         title: "Beyblade Original — Dragoon Storm (Rare Sealed)",
         description: "Sealed, unopened Dragoon Storm from the original 1999-2003 series. A grail piece for original-generation collectors.",
-        categorySlugs: ["category-original-plastic-gen", "category-original-tops", "category-beyblade-original", "category-spinning-tops"],
+        categorySlugs: ["category-dragoon-storm", "category-original-tops", "category-beyblade-original", "category-spinning-tops"],
         categoryNames: ["Plastic Generation", "Original Tops", "Beyblade Original", "Spinning Tops"],
         brandSlug: "brand-beyblade",
         brand: "Beyblade",
@@ -97,7 +98,7 @@ const _rawProductsAuctionsSeedData = [
         slug: "auction-beyblade-metal-lightning-l-drago",
         title: "Metal Fight Beyblade BB-99 Lightning L-Drago",
         description: "Lightning L-Drago 100HF/S, a highly sought-after Metal Fury era top in excellent condition.",
-        categorySlugs: ["category-metal-masters", "category-metal-tops", "category-beyblade-metal", "category-spinning-tops"],
+        categorySlugs: ["category-lightning-l-drago-100hf", "category-metal-fusion", "category-metal-tops", "category-beyblade-metal", "category-spinning-tops"],
         categoryNames: ["Metal Masters", "Metal Fight Tops", "Beyblade Metal Fight", "Spinning Tops"],
         brandSlug: "brand-takara-tomy",
         brand: "Takara-Tomy",
@@ -138,7 +139,7 @@ const _rawProductsAuctionsSeedData = [
         slug: "auction-beyblade-x-shark-edge",
         title: "Beyblade X BX-04 Shark Edge (Buy It Now Available)",
         description: "Shark Edge 3-60GF straight from a fresh case pull. Grab it at the Buy It Now price before the clock runs, or start the bidding.",
-        categorySlugs: ["category-x-basic", "category-x-tops", "category-beyblade-x", "category-spinning-tops"],
+        categorySlugs: ["category-sharkedge-3-60lf", "category-x-tops", "category-beyblade-x", "category-spinning-tops"],
         categoryNames: ["Basic Line", "Beyblade X Tops", "Beyblade X", "Spinning Tops"],
         brandSlug: "brand-takara-tomy",
         brand: "Takara-Tomy",
@@ -179,7 +180,7 @@ const _rawProductsAuctionsSeedData = [
         slug: "auction-beyblade-burst-xcalius-passed-bin",
         title: "Beyblade Burst Xcalius X2 (bidding passed Buy It Now)",
         description: "Xcalius X2 attack type. The Buy It Now price has already been overtaken by live bidding, so only bidding remains.",
-        categorySlugs: ["category-burst-cho-z", "category-burst-tops", "category-beyblade-burst", "category-spinning-tops"],
+        categorySlugs: ["category-xcalius-x2-1iron", "category-burst-classic", "category-burst-tops", "category-beyblade-burst", "category-spinning-tops"],
         categoryNames: ["Cho-Z", "Burst Tops", "Beyblade Burst", "Spinning Tops"],
         brandSlug: "brand-takara-tomy",
         brand: "Takara-Tomy",
@@ -215,7 +216,13 @@ const _rawProductsAuctionsSeedData = [
         slug: "auction-beyblade-original-seaborg",
         title: "Beyblade Original — Seaborg 2000 (Reserve Auction)",
         description: "Rare Seaborg 2000 defense-type top from the original series. Reserve price set by the seller — current bids haven't met it yet.",
-        categorySlugs: ["category-original-hms", "category-original-tops", "category-beyblade-original", "category-spinning-tops"],
+        /*
+         * Was filed at `category-original-hms` — the Heavy Metal System line, a
+         * DIFFERENT generation from the one its own copy names ("from the original
+         * series"). Seaborg 2000 is the Spin Gear System release the canonical
+         * corpus carries as "Seaborg 2", which is its leaf.
+         */
+        categorySlugs: ["category-seaborg-2", "category-original-spin-gear", "category-original-tops", "category-beyblade-original", "category-spinning-tops"],
         categoryNames: ["Heavy Metal System", "Original Tops", "Beyblade Original", "Spinning Tops"],
         brandSlug: "brand-beyblade",
         brand: "Beyblade",
@@ -252,7 +259,7 @@ const _rawProductsAuctionsSeedData = [
         slug: "auction-beyblade-metal-diablo-nemesis",
         title: "Metal Fight Beyblade BB-122 Diablo Nemesis (Ended — Sold)",
         description: "Diablo Nemesis XF, the final boss top of Metal Fight Beyblade Zero-G. Auction closed with a winning bidder.",
-        categorySlugs: ["category-metal-fury-4d", "category-metal-tops", "category-beyblade-metal", "category-spinning-tops"],
+        categorySlugs: ["category-diablo-nemesis-x-d", "category-metal-fury-4d", "category-metal-tops", "category-beyblade-metal", "category-spinning-tops"],
         categoryNames: ["Metal Fury (4D)", "Metal Fight Tops", "Beyblade Metal Fight", "Spinning Tops"],
         brandSlug: "brand-takara-tomy",
         brand: "Takara-Tomy",
@@ -294,7 +301,7 @@ const _rawProductsAuctionsSeedData = [
         slug: "auction-beyblade-burst-spriggan-requiem-bought-out",
         title: "Beyblade Burst B-128 Spriggan Requiem (Ended — Bought Out)",
         description: "Spriggan Requiem, the dual-spin legend of Burst Super Z. Bidding had reached ₹3,100 when a buyer took the ₹4,999 Buy Now price and ended the auction early.",
-        categorySlugs: ["category-burst-tops", "category-beyblade-burst", "category-spinning-tops"],
+        categorySlugs: ["category-spriggan-requiem-0-zeta", "category-burst-cho-z", "category-burst-tops", "category-beyblade-burst", "category-spinning-tops"],
         categoryNames: ["Burst Tops", "Beyblade Burst", "Spinning Tops"],
         brandSlug: "brand-takara-tomy",
         brand: "Takara-Tomy",
@@ -331,7 +338,7 @@ const _rawProductsAuctionsSeedData = [
         slug: "auction-beyblade-burst-cho-z-achilles",
         title: "Beyblade Burst B-100 Cho-Z Achilles",
         description: "Cho-Z Achilles.Ow.Zn', a Super Zeta stamina-type top from the Cho-Z generation, in excellent spinning condition.",
-        categorySlugs: ["category-burst-superking", "category-burst-tops", "category-beyblade-burst", "category-spinning-tops"],
+        categorySlugs: ["category-cho-z-achilles-00-dimension", "category-burst-cho-z", "category-burst-tops", "category-beyblade-burst", "category-spinning-tops"],
         categoryNames: ["Superking", "Burst Tops", "Beyblade Burst", "Spinning Tops"],
         brandSlug: "brand-beyblade",
         brand: "Beyblade",
@@ -365,9 +372,9 @@ const _rawProductsAuctionsSeedData = [
     {
         id: "auction-beyblade-x-wizard-fafnir",
         slug: "auction-beyblade-x-wizard-fafnir",
-        title: "Beyblade X BX-06 Wizard Fafnir (Long-Running Auction)",
-        description: "Wizard Fafnir 4-60F, one week left on the clock — a rare Beyblade X chase top with active bidding.",
-        categorySlugs: ["category-x-basic", "category-x-tops", "category-beyblade-x", "category-spinning-tops"],
+        title: "Beyblade X UX-03 WizardRod 5-70DB (Long-Running Auction)",
+        description: "WizardRod 5-70DB from the Unique Line, one week left on the clock — a rare Beyblade X chase top with active bidding.",
+        categorySlugs: ["category-wizardrod-5-70db", "category-x-unique-ux", "category-x-tops", "category-beyblade-x", "category-spinning-tops"],
         categoryNames: ["Basic Line", "Beyblade X Tops", "Beyblade X", "Spinning Tops"],
         brandSlug: "brand-takara-tomy",
         brand: "Takara-Tomy",
@@ -398,15 +405,24 @@ const _rawProductsAuctionsSeedData = [
         updatedAt: new Date("2026-08-19"),
     },
 ];
-// `.map(withTokens)` is applied to the WHOLE array at the end, not just to the
-// spread above. It used to wrap only the spread, so the ended-unsold fixture
-// appended after it shipped with no searchTxt — the one row that proves the
-// auction availability branch works, invisible to search.
+// 🛑 EVERY wrapper is applied to the WHOLE array at the end, never to the
+// spread. It used to wrap only the spread, so the ended-unsold fixture appended
+// after it shipped with no searchTxt — the one row that proves the auction
+// availability branch works, invisible to search.
+//
+// `listingType` was the SAME BUG, one field over, and survived that fix: it
+// stayed inside the spread while `withTokens` was lifted out, so the appended
+// fixture reached Firestore with no `listingType` at all. Measured 2026-10-14 —
+// 9 of the 10 seeded auctions carried it and this one did not. A missing
+// `listingType` is invisible to inspection (`normalizeListingType` defaults it
+// to "standard" in memory) and fatal to every query, because a Firestore
+// equality cannot match an absent field: `where("listingType","==","auction")`
+// skipped it, so the fixture never appeared on /auctions and the "Ended" tab it
+// exists to prove had nothing to show. Root Cause #101.
+//
+// Anything added to this pipeline goes AFTER the `]`, applied to all rows.
 export const productsAuctionsSeedData = [
-    ..._rawProductsAuctionsSeedData.map((a) => ({
-        ...a,
-        listingType: PRODUCT_FIELDS.LISTING_TYPE_VALUES.AUCTION,
-    })),
+    ..._rawProductsAuctionsSeedData,
     {
         // Ended with NO winner — reserve never met, zero bids.
         //
@@ -417,9 +433,9 @@ export const productsAuctionsSeedData = [
         // the base check and exercises nothing type-specific.
         id: "auction-beyblade-burst-lord-spryzen-ended-unsold",
         slug: "auction-beyblade-burst-lord-spryzen-ended-unsold",
-        title: "Beyblade Burst B-174 Lord Spryzen (Ended — Reserve Not Met)",
+        title: "Beyblade Burst Storm Spriggan Knuckle Unite (Ended — Reserve Not Met)",
         description: "Auction closed without meeting its reserve, so no winner was declared. Relisting soon.",
-        categorySlugs: ["category-burst-classic", "category-burst-tops", "category-beyblade-burst", "category-spinning-tops"],
+        categorySlugs: ["category-storm-spriggan-knuckle-unite", "category-burst-classic", "category-burst-tops", "category-beyblade-burst", "category-spinning-tops"],
         categoryNames: ["Burst Classic", "Burst Tops", "Beyblade Burst", "Spinning Tops"],
         brandSlug: "brand-takara-tomy",
         brand: "Takara-Tomy",
@@ -443,4 +459,8 @@ export const productsAuctionsSeedData = [
         createdAt: new Date("2026-08-10"),
         updatedAt: new Date("2026-08-24"),
     },
-].map(withTokens).map(withFinalSale);
+]
+    .map((a) => ({ ...a, listingType: PRODUCT_FIELDS.LISTING_TYPE_VALUES.AUCTION }))
+    .map(withTokens)
+    .map(withFinalSale)
+    .map(withDerivedCategoryNames);

package/dist/seed/products-classifieds-seed-data.js

@@ -29,11 +29,13 @@ import { PRODUCT_FIELDS } from "../constants/field-names.js";
 import { buildSearchTxt } from "../utils/search-txt.js";
 import { seedPhoto } from "./_helpers/media.js";
 import { withFinalSale } from "./_helpers/final-sale-fixtures.js";
+import { withDerivedCategoryNames } from "./_helpers/category-names.js";
 const _rawproductsClassifiedsSeedData = [
     {
         id: "classified-beyblade-stadium-set",
         slug: "classified-beyblade-stadium-set",
         title: "Used Beyblade Burst Stadium Set — Local Pickup Only",
+        isLot: true,
         description: "Well-loved Beyblade stadium with 6 tops and 2 launchers, sold as-is. Meet up locally — price is negotiable.",
         /*
          * 🛑 Re-filed in B5. A stadium is GENERATION-SPECIFIC — a BX-10 Xtreme
@@ -45,7 +47,16 @@ const _rawproductsClassifiedsSeedData = [
          * a specific generation while the title stays silent makes the data
          * disagree with itself, and the title is the half a buyer reads.
          */
-        categorySlugs: ["category-burst-standard-stadiums", "category-burst-stadiums", "category-beyblade-burst", "category-spinning-tops"],
+        /*
+         * 🛑 A LOT FILES AT A NON-LEAF, which is the other half of the leaf rule
+         * and the only offender of its kind in the catalogue. This set was filed
+         * at `category-burst-standard-stadiums` — a LEAF, i.e. one specific
+         * stadium model — while being `isLot: true`. Filing a mixed used set under
+         * a single model's leaf is a false claim about what is in the box, which
+         * is exactly what the lot half of the rule refuses. Its parent is the
+         * correct home.
+         */
+        categorySlugs: ["category-burst-stadiums", "category-beyblade-burst", "category-spinning-tops"],
         categoryNames: ["Standard BeyStadiums", "Burst Stadiums", "Beyblade Burst", "Spinning Tops"],
         brandSlug: "brand-beyblade",
         brand: "Beyblade",
@@ -96,6 +107,8 @@ const _rawproductsClassifiedsSeedData = [
         id: "classified-beyblade-burst-collection-bengaluru",
         slug: "classified-beyblade-burst-collection-bengaluru",
         title: "Beyblade Burst Collection (12 Tops) — Bengaluru",
+        isLot: true,
+        lotSize: 12,
         description: "Downsizing my Burst collection — 12 tops in good condition, fixed price, will also ship nationwide if you'd rather not meet up.",
         categorySlugs: ["category-burst-cho-z", "category-burst-tops", "category-beyblade-burst", "category-spinning-tops"],
         categoryNames: ["Cho-Z", "Burst Tops", "Beyblade Burst", "Spinning Tops"],
@@ -142,6 +155,7 @@ const _rawproductsClassifiedsSeedData = [
         id: "classified-beyblade-x-starter-pune",
         slug: "classified-beyblade-x-starter-pune",
         title: "Beyblade X Starter Pack — Pune, Phone Contact Only",
+        isLot: true,
         description: "Barely used Beyblade X starter pack, selling because I upgraded to a full set. Call or WhatsApp only, no chat.",
         categorySlugs: ["category-x-basic", "category-x-tops", "category-beyblade-x", "category-spinning-tops"],
         categoryNames: ["Basic Line", "Beyblade X Tops", "Beyblade X", "Spinning Tops"],
@@ -191,6 +205,8 @@ const _rawproductsClassifiedsSeedData = [
         id: "classified-beyblade-metal-vintage-delhi",
         slug: "classified-beyblade-metal-vintage-delhi",
         title: "Vintage Metal Fight Lot (5 Tops) — Delhi NCR",
+        isLot: true,
+        lotSize: 5,
         description: "A well-preserved 5-top Metal Fight lot from a long-time collector. Firm price, ships anywhere in India.",
         categorySlugs: ["category-metal-fusion", "category-metal-tops", "category-beyblade-metal", "category-spinning-tops"],
         categoryNames: ["Metal Fusion", "Metal Fight Tops", "Beyblade Metal Fight", "Spinning Tops"],
@@ -290,6 +306,7 @@ const _rawproductsClassifiedsSeedData = [
         id: "classified-beyblade-x-tournament-kit-hyderabad",
         slug: "classified-beyblade-x-tournament-kit-hyderabad",
         title: "Tournament-Ready Beyblade X Kit — Hyderabad",
+        isLot: true,
         description: "Complete tournament-legal kit including 3 tops, stadium, and a scorecard pad from our last local meetup event.",
         categorySlugs: ["category-x-basic", "category-x-tops", "category-beyblade-x", "category-spinning-tops"],
         categoryNames: ["Basic Line", "Beyblade X Tops", "Beyblade X", "Spinning Tops"],
@@ -342,6 +359,7 @@ const _rawproductsClassifiedsSeedData = [
         id: "classified-beyblade-burst-parts-mumbai",
         slug: "classified-beyblade-burst-parts-mumbai",
         title: "Spare Burst Parts Bundle — Mumbai, Ships Too",
+        isLot: true,
         description: "Assorted spare Burst layers, discs, and drivers cleared out from my parts box. Happy to meet locally or ship.",
         categorySlugs: ["category-burst-superking", "category-burst-tops", "category-beyblade-burst", "category-spinning-tops"],
         categoryNames: ["Superking", "Burst Tops", "Beyblade Burst", "Spinning Tops"],
@@ -394,7 +412,7 @@ const _rawproductsClassifiedsSeedData = [
         slug: "classified-beyblade-metal-galaxy-pegasus-sold-mumbai",
         title: "Galaxy Pegasus W105R2F — Sold (Mumbai)",
         description: "Vintage Metal Fight Galaxy Pegasus, sold to a local collector. Listing kept up for reference.",
-        categorySlugs: ["category-metal-masters", "category-metal-tops", "category-beyblade-metal", "category-spinning-tops"],
+        categorySlugs: ["category-galaxy-pegasus-w105r2f", "category-metal-fusion", "category-metal-tops", "category-beyblade-metal", "category-spinning-tops"],
         categoryNames: ["Metal Masters", "Metal Fight Tops", "Beyblade Metal Fight", "Spinning Tops"],
         brandSlug: "brand-beyblade",
         brand: "Beyblade",
@@ -432,4 +450,4 @@ const _rawproductsClassifiedsSeedData = [
  * the bottom of the array cannot ship without it — which is exactly how the
  * sold/depleted fixture in this file ended up unsearchable.
  */
-export const productsClassifiedsSeedData = _rawproductsClassifiedsSeedData.map(withProductSearchTxt).map(withFinalSale);
+export const productsClassifiedsSeedData = _rawproductsClassifiedsSeedData.map(withProductSearchTxt).map(withFinalSale).map(withDerivedCategoryNames);

package/dist/seed/products-digital-codes-seed-data.js

@@ -22,6 +22,7 @@ import { PRODUCT_FIELDS } from "../constants/field-names.js";
 import { buildSearchTxt } from "../utils/search-txt.js";
 import { seedPhoto } from "./_helpers/media.js";
 import { withFinalSale } from "./_helpers/final-sale-fixtures.js";
+import { withDerivedCategoryNames } from "./_helpers/category-names.js";
 const _rawproductsDigitalCodesSeedData = [
     {
         id: "digitalcode-beyblade-x-app-starter-pack",
@@ -400,4 +401,4 @@ const _rawproductsDigitalCodesSeedData = [
  * the bottom of the array cannot ship without it — which is exactly how the
  * sold/depleted fixture in this file ended up unsearchable.
  */
-export const productsDigitalCodesSeedData = _rawproductsDigitalCodesSeedData.map(withProductSearchTxt).map(withFinalSale);
+export const productsDigitalCodesSeedData = _rawproductsDigitalCodesSeedData.map(withProductSearchTxt).map(withFinalSale).map(withDerivedCategoryNames);

package/dist/seed/products-live-items-seed-data.js

@@ -35,6 +35,7 @@ import { PRODUCT_FIELDS } from "../constants/field-names.js";
 import { buildSearchTxt } from "../utils/search-txt.js";
 import { seedPhoto } from "./_helpers/media.js";
 import { withFinalSale } from "./_helpers/final-sale-fixtures.js";
+import { withDerivedCategoryNames } from "./_helpers/category-names.js";
 const _rawproductsLiveItemsSeedData = [
     {
         id: "live-golden-retriever-puppy",
@@ -273,4 +274,4 @@ const _rawproductsLiveItemsSeedData = [
  * the bottom of the array cannot ship without it — which is exactly how the
  * sold/depleted fixture in this file ended up unsearchable.
  */
-export const productsLiveItemsSeedData = _rawproductsLiveItemsSeedData.map(withProductSearchTxt).map(withFinalSale);
+export const productsLiveItemsSeedData = _rawproductsLiveItemsSeedData.map(withProductSearchTxt).map(withFinalSale).map(withDerivedCategoryNames);