@mohasinac/appkit 4.46.0 → 4.48.0

package/dist/seed/_helpers/category-models.d.ts

@@ -2,4 +2,4 @@ import type { CategoryTreeNode } from "./category-tree";
 /** Named-model leaves, keyed by the tier-3 line they belong to. */
 export declare const MODEL_LEAVES: Record<string, CategoryTreeNode[]>;
 /** Total named-model leaves — asserted by the seed so a silent drop is loud. */
-export declare const MODEL_LEAF_COUNT = 216;
+export declare const MODEL_LEAF_COUNT = 220;

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

@@ -142,6 +142,12 @@ export const MODEL_LEAVES = {
             description: "Luinor L2 — an Attack-type, left-spin Burst Classic release, product code E1056. Release note: Lost Lúinor L2 Nine Spiral. Complete tops, loose parts, sticker sheets and pre-owned examples of this model are listed here.",
             extra: { aliases: ["E1056", "Lost Lúinor L2", "Lost Longinus"], productDefaults: { defaultFeatures: ["feature-blader-lui-shirosagi", "feature-type-attack", "feature-left-spin"] } },
         },
+        {
+            id: "category-spryzen-s2-0q",
+            name: "Spryzen S2 0Q",
+            description: "Spryzen S2 0Q — a Balance-type, dual-spin Burst Classic release, product code E1048, released by Hasbro. Complete tops, loose parts, sticker sheets and pre-owned examples of this model are listed here.",
+            extra: { aliases: ["E1048", "Spryzen S2 0Q Layer: Spryzen S2", "Disc: 0", "Driver: Q — later evolves to Spryzen Requiem S3 0Cross"], productDefaults: { defaultFeatures: ["feature-blader-shu-kurenai", "feature-type-balance", "feature-dual-spin"] } },
+        },
         {
             id: "category-storm-spriggan-7glaive",
             name: "Storm Spriggan 7Glaive",
@@ -228,6 +234,12 @@ export const MODEL_LEAVES = {
             description: "Vanish Fafnir Tapered Kick-3 — a Stamina-type, left-spin Dynamite Battle release, product code B-180-class, released by Takara Tomy, ~2021. Complete tops, loose parts, sticker sheets and pre-owned examples of this model are listed here.",
             extra: { aliases: ["B-180-class"], productDefaults: { defaultFeatures: ["feature-blader-fumiya-kindo", "feature-type-stamina", "feature-left-spin"] } },
         },
+        {
+            id: "category-wizard-fafnir-ratchet-rise",
+            name: "Wizard Fafnir Ratchet Rise",
+            description: "Wizard Fafnir Ratchet Rise — a Stamina-type, left-spin Dynamite Battle release, product code B-139, released by Takara Tomy, S3-S4 transitional. Complete tops, loose parts, sticker sheets and pre-owned examples of this model are listed here.",
+            extra: { aliases: ["B-139"], productDefaults: { defaultFeatures: ["feature-blader-fubuki-sumiye", "feature-type-stamina", "feature-left-spin"] } },
+        },
     ],
     "category-burst-god": [
         {
@@ -386,6 +398,12 @@ export const MODEL_LEAVES = {
             description: "Cosmic Pegasis F:D — an Attack-type, right-spin Metal Fury (4D) release, product code BB-128, released by Takara Tomy. Complete tops, loose parts, sticker sheets and pre-owned examples of this model are listed here.",
             extra: { aliases: ["BB-128"], productDefaults: { defaultFeatures: ["feature-blader-gingka-hagane", "feature-type-attack", "feature-right-spin"] } },
         },
+        {
+            id: "category-diablo-nemesis-x-d",
+            name: "Diablo Nemesis X:D",
+            description: "Diablo Nemesis X:D — a Balance-type, right-spin Metal Fury (4D) release, product code BB-122. Complete tops, loose parts, sticker sheets and pre-owned examples of this model are listed here.",
+            extra: { aliases: ["BB-122"], productDefaults: { defaultFeatures: ["feature-blader-rago", "feature-type-balance", "feature-right-spin"] } },
+        },
         {
             id: "category-fang-leone-130w2d",
             name: "Fang Leone 130W2D",
@@ -1146,6 +1164,12 @@ export const MODEL_LEAVES = {
             description: "Dranzer F — a Balance-type, right-spin Spin Gear System release, product code A-27, released by Takara Tomy. Complete tops, loose parts, sticker sheets and pre-owned examples of this model are listed here.",
             extra: { aliases: ["A-27", "Dranzer Flame"], productDefaults: { defaultFeatures: ["feature-blader-kai-hiwatari", "feature-type-balance", "feature-right-spin"] } },
         },
+        {
+            id: "category-dranzer-s",
+            name: "Dranzer S",
+            description: "Dranzer S — a Balance-type, right-spin Spin Gear System release, product code A-2, released by Takara. Complete tops, loose parts, sticker sheets and pre-owned examples of this model are listed here.",
+            extra: { aliases: ["A-2", "Dranzer Spiral"], productDefaults: { defaultFeatures: ["feature-blader-kai-hiwatari", "feature-type-balance", "feature-right-spin"] } },
+        },
         {
             id: "category-driger-f",
             name: "Driger F",
@@ -1361,4 +1385,4 @@ export const MODEL_LEAVES = {
     ],
 };
 /** Total named-model leaves — asserted by the seed so a silent drop is loud. */
-export const MODEL_LEAF_COUNT = 216;
+export const MODEL_LEAF_COUNT = 220;

package/dist/seed/_helpers/category-names.d.ts

@@ -0,0 +1,54 @@
+import type { ProductDocument } from "../../features/products/schemas";
+export declare function deriveCategoryNames(slugs: readonly string[] | undefined): string[] | undefined;
+/**
+ * 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 declare function deriveCategoryClosure(slugs: readonly string[] | undefined): string[] | undefined;
+/**
+ * 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 declare function withDerivedCategoryNames(p: Partial<ProductDocument>): Partial<ProductDocument>;

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);