@mohasinac/appkit 4.46.0 → 4.48.0

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

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

@@ -23,9 +23,11 @@ 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 _rawPreordersSeedData = [
     {
         id: "preorder-beyblade-x-bx-08-wave",
+        isLot: true,
         storeId: "store-beyblade-arena",
         brandSlug: "brand-takara-tomy",
         title: "Beyblade X BX-08 Booster — Next Wave",
@@ -70,15 +72,15 @@ const _rawPreordersSeedData = [
         id: "preorder-beyblade-x-bx-09-glide-ring",
         storeId: "store-beyblade-arena",
         brandSlug: "brand-takara-tomy",
-        title: "Beyblade X BX-09 Glide Ring Booster — Coming Soon",
+        title: "Beyblade X UnicornSting 5-60GP — Coming Soon",
         slug: "preorder-beyblade-x-bx-09-glide-ring",
-        description: "Announced but not yet in production — lock in your spot for the BX-09 Glide Ring wave before it goes into manufacturing.",
+        description: "Announced but not yet in production — lock in your spot for the UnicornSting 5-60GP wave before it goes into manufacturing.",
         price: 849,
         currency: "INR",
         condition: PRODUCT_FIELDS.CONDITION_VALUES.NEW,
         status: PRODUCT_FIELDS.STATUS_VALUES.PUBLISHED,
         listingType: "pre-order",
-        categorySlugs: ["category-x-basic", "category-x-tops", "category-beyblade-x", "category-spinning-tops"],
+        categorySlugs: ["category-unicornsting-5-60gp", "category-x-basic", "category-x-tops", "category-beyblade-x", "category-spinning-tops"],
         categoryNames: ["Basic Line", "Beyblade X Tops", "Beyblade X", "Spinning Tops"],
         brand: "Takara-Tomy",
         images: [
@@ -114,7 +116,7 @@ const _rawPreordersSeedData = [
         condition: PRODUCT_FIELDS.CONDITION_VALUES.NEW,
         status: PRODUCT_FIELDS.STATUS_VALUES.PUBLISHED,
         listingType: "pre-order",
-        categorySlugs: ["category-burst-superking", "category-burst-tops", "category-beyblade-burst", "category-spinning-tops"],
+        categorySlugs: ["category-union-achilles-cn-xt-retsu", "category-burst-superking", "category-burst-tops", "category-beyblade-burst", "category-spinning-tops"],
         categoryNames: ["Superking", "Burst Tops", "Beyblade Burst", "Spinning Tops"],
         brand: "Beyblade",
         images: [
@@ -143,6 +145,7 @@ const _rawPreordersSeedData = [
     },
     {
         id: "preorder-beyblade-x-bx-11-sold-out",
+        isLot: true,
         storeId: "store-beyblade-arena",
         brandSlug: "brand-takara-tomy",
         title: "Beyblade X BX-11 Limited Wave (Sold Out)",
@@ -184,15 +187,15 @@ const _rawPreordersSeedData = [
         id: "preorder-beyblade-burst-b-215-hells-scythe",
         storeId: "store-beyblade-arena",
         brandSlug: "brand-beyblade",
-        title: "Beyblade Burst B-215 Hells Scythe — Deposit Locked",
+        title: "Beyblade Burst Dark Deathscyther Force Jaggy — Deposit Locked",
         slug: "preorder-beyblade-burst-b-215-hells-scythe",
-        description: "Hells Scythe Giga Reboost, a full-payment pre-order — no cancellation once reserved, guaranteeing your slot in a strictly limited case allocation.",
+        description: "Dark Deathscyther Force Jaggy, a full-payment pre-order — no cancellation once reserved, guaranteeing your slot in a strictly limited case allocation.",
         price: 1299,
         currency: "INR",
         condition: PRODUCT_FIELDS.CONDITION_VALUES.NEW,
         status: PRODUCT_FIELDS.STATUS_VALUES.PUBLISHED,
         listingType: "pre-order",
-        categorySlugs: ["category-burst-classic", "category-burst-tops", "category-beyblade-burst", "category-spinning-tops"],
+        categorySlugs: ["category-dark-deathscyther-force-jaggy", "category-burst-god", "category-burst-tops", "category-beyblade-burst", "category-spinning-tops"],
         categoryNames: ["Burst Classic", "Burst Tops", "Beyblade Burst", "Spinning Tops"],
         brand: "Beyblade",
         images: [
@@ -224,6 +227,7 @@ const _rawPreordersSeedData = [
         storeId: "store-beyblade-arena",
         brandSlug: "brand-beyblade",
         title: "Beyblade Original Remaster Set — Announced",
+        isLot: true,
         slug: "preorder-beyblade-original-remaster",
         description: "A 25th-anniversary remaster of the original 1999 lineup, freshly announced. Production hasn't started — early reservations lock in launch pricing.",
         price: 1899,
@@ -265,7 +269,7 @@ const _rawPreordersSeedData = [
         id: "preorder-beyblade-x-bx-12-closed",
         storeId: "store-beyblade-arena",
         brandSlug: "brand-takara-tomy",
-        title: "Beyblade X BX-12 Wave — Allocation Closed",
+        title: "Beyblade X TyrannoBeat 4-70Q — Allocation Closed",
         slug: "preorder-beyblade-x-bx-12-closed",
         description: "Every slot in this wave is spoken for and the units are ready to ship to existing pre-orderers.",
         price: 1299,
@@ -273,7 +277,7 @@ const _rawPreordersSeedData = [
         condition: PRODUCT_FIELDS.CONDITION_VALUES.NEW,
         status: PRODUCT_FIELDS.STATUS_VALUES.PUBLISHED,
         listingType: "pre-order",
-        categorySlugs: ["category-x-basic", "category-x-tops", "category-beyblade-x", "category-spinning-tops"],
+        categorySlugs: ["category-tyrannobeat-4-70q", "category-x-basic", "category-x-tops", "category-beyblade-x", "category-spinning-tops"],
         categoryNames: ["Basic Line", "Beyblade X Tops", "Beyblade X", "Spinning Tops"],
         brand: "Takara-Tomy",
         images: [
@@ -297,15 +301,26 @@ const _rawPreordersSeedData = [
         updatedAt: new Date("2026-08-24"),
     },
 ];
-export const productsPreordersSeedData = _rawPreordersSeedData.map((p) => withFinalSale({
+export const productsPreordersSeedData = _rawPreordersSeedData.map((p) => withDerivedCategoryNames(withFinalSale({
     tags: [],
     stockQuantity: p.availableQuantity ?? 1,
     mainImage: p.images?.[0] ?? "",
     ...p,
     listingType: "pre-order",
+    /*
+     * 🛑 `searchTxt` reads p.categoryNames — the RAW record's, deliberately.
+     *
+     * The derivation wraps the OUTSIDE of this call, so at this point the names
+     * are still whatever the record hand-wrote. That is correct rather than a
+     * sequencing bug: the search index should carry the names a buyer might
+     * type, and a stale-but-real generation name ("Metal Masters") is still a
+     * term worth matching. Swapping to the derived chain would silently narrow
+     * the index. The DISPLAY chain is the one that must be exact, and that is
+     * what the wrapper fixes.
+     */
     searchTxt: buildSearchTxt([
         p.title, p.description, p.brand, p.brandSlug,
         p.categoryNames, p.tags, p.features, p.condition,
         p.specifications?.map((s) => `${s.name} ${s.value}`),
     ]),
-}));
+})));

package/dist/seed/products-prize-draws-seed-data.js

@@ -23,9 +23,11 @@ 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 _rawproductsPrizeDrawsSeedData = [
     {
         id: "prizedraw-beyblade-mystery-box",
+        isLot: true,
         slug: "prizedraw-beyblade-mystery-box",
         title: "Beyblade Mystery Box — Prize Draw",
         description: "Buy an entry for ₹99 and reveal your prize instantly — win anything from a rare limited-edition Beyblade down to a spare launcher grip. 4 prizes available, revealed on a first-come basis.",
@@ -90,6 +92,7 @@ const _rawproductsPrizeDrawsSeedData = [
     },
     {
         id: "prizedraw-beyblade-scheduled-demo",
+        isLot: true,
         slug: "prizedraw-beyblade-scheduled-demo",
         title: "Beyblade Champion's Draw — Prize Draw",
         description: "Two entries, two prizes — the winners are revealed automatically the moment the draw closes (3 days) or sells out, whichever comes first.",
@@ -148,6 +151,7 @@ const _rawproductsPrizeDrawsSeedData = [
     // --- Partially sold: prizeCurrentEntries > 0, main seed never exercised this before ---
     {
         id: "prizedraw-beyblade-x-legendary-vault",
+        isLot: true,
         slug: "prizedraw-beyblade-x-legendary-vault",
         title: "Beyblade X Legendary Vault — Prize Draw",
         description: "6 entries, 6 prizes ranging from a legendary chase top to spare parts — over half the draw is already sold, don't miss the remaining slots.",
@@ -207,6 +211,7 @@ const _rawproductsPrizeDrawsSeedData = [
     // --- Closed + revealed: real winners, isWon:true — permanent-catalog example (previously only in tester sandbox) ---
     {
         id: "prizedraw-beyblade-metal-closed-revealed",
+        isLot: true,
         slug: "prizedraw-beyblade-metal-closed-revealed",
         title: "Metal Fight Mystery Draw — Ended (Revealed)",
         description: "This draw has closed and every prize has been revealed to its winner. Browse the results below.",
@@ -260,6 +265,7 @@ const _rawproductsPrizeDrawsSeedData = [
     // --- Nearly sold out, scheduled reveal ---
     {
         id: "prizedraw-beyblade-burst-collectors-draw",
+        isLot: true,
         slug: "prizedraw-beyblade-burst-collectors-draw",
         title: "Beyblade Burst Collector's Draw — Almost Sold Out",
         description: "Only 1 entry left — 4 of 5 slots are already claimed for this Burst-generation collector's draw. Winners revealed the moment the draw closes.",
@@ -379,6 +385,7 @@ const _rawproductsPrizeDrawsSeedData = [
         // isSold true, so it is caught by the shared base check and would still
         // look correct even if the type-specific rule were deleted.
         id: "prizedraw-beyblade-x-vault-closed-pending-reveal",
+        isLot: true,
         slug: "prizedraw-beyblade-x-vault-closed-pending-reveal",
         title: "Beyblade X Vault Draw — Closed Early",
         description: "The seller closed this draw before every slot sold. Remaining entries were refunded; no further entries are accepted.",
@@ -426,4 +433,4 @@ const _rawproductsPrizeDrawsSeedData = [
  * 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 productsPrizeDrawsSeedData = _rawproductsPrizeDrawsSeedData.map(withProductSearchTxt).map(withFinalSale);
+export const productsPrizeDrawsSeedData = _rawproductsPrizeDrawsSeedData.map(withProductSearchTxt).map(withFinalSale).map(withDerivedCategoryNames);

package/dist/seed/products-standard-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";
 /*
  * Real Beyblade attributes per fixture — Root Cause #6 (standard was the
  * "richest" seed file by fixture count but never exercised customFields/
@@ -186,7 +187,7 @@ const _rawProductsStandardSeedData = [
         barcodeId: "LIR-BEY-ORIG-001",
         title: "Beyblade Original — Dranzer S",
         description: "Plastic Generation era Dranzer S with launcher and ripcord. A classic from the original 1999-2003 Beyblade series.",
-        categorySlugs: ["category-original-hms", "category-original-tops", "category-beyblade-original", "category-spinning-tops"],
+        categorySlugs: ["category-dranzer-s", "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",
@@ -232,7 +233,7 @@ const _rawProductsStandardSeedData = [
         barcodeId: "LIR-BEY-ORIG-002",
         title: "Beyblade Original — Driger V",
         description: "Vintage Driger V attack-type top from the original series, complete with launcher grip.",
-        categorySlugs: ["category-original-plastic-gen", "category-original-tops", "category-beyblade-original", "category-spinning-tops"],
+        categorySlugs: ["category-driger-v", "category-original-tops", "category-beyblade-original", "category-spinning-tops"],
         categoryNames: ["Plastic Generation", "Original Tops", "Beyblade Original", "Spinning Tops"],
         brandSlug: "brand-beyblade",
         brand: "Beyblade",
@@ -264,7 +265,7 @@ const _rawProductsStandardSeedData = [
         barcodeId: "LIR-BEY-META-001",
         title: "Metal Fight Beyblade BB-28 Storm Pegasus",
         description: "Storm Pegasus 105RF from the Metal Fusion era — one of the most iconic Metal Fight tops.",
-        categorySlugs: ["category-metal-masters", "category-metal-tops", "category-beyblade-metal", "category-spinning-tops"],
+        categorySlugs: ["category-storm-pegasus-105rf", "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",
@@ -296,7 +297,7 @@ const _rawProductsStandardSeedData = [
         barcodeId: "LIR-BEY-META-002",
         title: "Metal Fight Beyblade BB-43 Flame Sagittario",
         description: "Flame Sagittario C145S, a balance-type top from the Metal Masters generation.",
-        categorySlugs: ["category-metal-fury-4d", "category-metal-tops", "category-beyblade-metal", "category-spinning-tops"],
+        categorySlugs: ["category-flame-sagittario-c145s", "category-metal-fusion", "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",
@@ -326,9 +327,9 @@ const _rawProductsStandardSeedData = [
         id: "product-beyblade-burst-valkyrie",
         slug: "product-beyblade-burst-valkyrie",
         barcodeId: "LIR-BEY-BURS-001",
-        title: "Beyblade Burst B-01 Valkyrie",
-        description: "Starter set Valkyrie Wing Accel with launcher and grip — the top that launched the Burst generation.",
-        categorySlugs: ["category-burst-superking", "category-burst-tops", "category-beyblade-burst", "category-spinning-tops"],
+        title: "Beyblade Burst B-34 Victory Valkyrie Boost Variable",
+        description: "Starter set Victory Valkyrie Boost Variable with launcher and grip — an early Burst-generation Valkyrie.",
+        categorySlugs: ["category-victory-valkyrie-boost-variable", "category-burst-classic", "category-burst-tops", "category-beyblade-burst", "category-spinning-tops"],
         categoryNames: ["Superking", "Burst Tops", "Beyblade Burst", "Spinning Tops"],
         brandSlug: "brand-beyblade",
         brand: "Beyblade",
@@ -358,9 +359,9 @@ const _rawProductsStandardSeedData = [
         id: "product-beyblade-burst-regalia-genesis",
         slug: "product-beyblade-burst-regalia-genesis",
         barcodeId: "LIR-BEY-BURS-002",
-        title: "Beyblade Burst B-59 Regalia Genesis",
-        description: "Regalia Genesis.Zt with switch launcher — Burst Rise generation attack-type top.",
-        categorySlugs: ["category-burst-classic", "category-burst-tops", "category-beyblade-burst", "category-spinning-tops"],
+        title: "Beyblade Burst Xeno Xcalibur Magnet Loop",
+        description: "Xeno Xcalibur Magnet Loop with switch launcher — a Burst Classic attack-type top.",
+        categorySlugs: ["category-xeno-xcalibur-magnet-loop", "category-burst-classic", "category-burst-tops", "category-beyblade-burst", "category-spinning-tops"],
         categoryNames: ["Burst Classic", "Burst Tops", "Beyblade Burst", "Spinning Tops"],
         brandSlug: "brand-beyblade",
         brand: "Beyblade",
@@ -392,7 +393,7 @@ const _rawProductsStandardSeedData = [
         barcodeId: "LIR-BEY-X-001",
         title: "Beyblade X BX-01 Wizard Arrow",
         description: "Wizard Arrow 4-60F, a starter top from the Beyblade X Xtreme Gear generation.",
-        categorySlugs: ["category-x-basic", "category-x-tops", "category-beyblade-x", "category-spinning-tops"],
+        categorySlugs: ["category-wizardarrow-4-80b", "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",
@@ -422,9 +423,9 @@ const _rawProductsStandardSeedData = [
         id: "product-beyblade-x-knife-shinobi",
         slug: "product-beyblade-x-knife-shinobi",
         barcodeId: "LIR-BEY-X-002",
-        title: "Beyblade X BX-05 Knife Shinobi",
-        description: "Knife Shinobi 3-60GF, a balance-type top with tournament-grade stamina parts.",
-        categorySlugs: ["category-x-basic", "category-x-tops", "category-beyblade-x", "category-spinning-tops"],
+        title: "Beyblade X CrimsonGaruda 4-70TP",
+        description: "CrimsonGaruda 4-70TP, a balance-type top with tournament-grade stamina parts.",
+        categorySlugs: ["category-crimsongaruda-4-70tp", "category-x-basic", "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",
@@ -456,7 +457,7 @@ const _rawProductsStandardSeedData = [
         barcodeId: "LIR-BEY-VID-001",
         title: "Beyblade Original — Dragoon F (Video Demo)",
         description: "Dragoon F attack-type top from the original series. Listed with an unboxing/spin video for gallery testing.",
-        categorySlugs: ["category-original-hms", "category-original-tops", "category-beyblade-original", "category-spinning-tops"],
+        categorySlugs: ["category-dragoon-f", "category-original-tops", "category-beyblade-original", "category-spinning-tops"],
         categoryNames: ["Heavy Metal System", "Original Tops", "Beyblade Original", "Spinning Tops"],
         brandSlug: "brand-beyblade",
         brand: "Beyblade",
@@ -489,7 +490,7 @@ const _rawProductsStandardSeedData = [
         barcodeId: "LIR-BEY-VID-002",
         title: "Beyblade X BX-02 Dran Sword (Video Demo)",
         description: "Dran Sword 3-60F attack-type top from the Beyblade X Xtreme Gear generation. Listed with a battle-test video for gallery testing.",
-        categorySlugs: ["category-x-basic", "category-x-tops", "category-beyblade-x", "category-spinning-tops"],
+        categorySlugs: ["category-dransword-3-60f", "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",
@@ -530,7 +531,7 @@ const _rawProductsStandardSeedData = [
         barcodeId: "LIR-BEY-VID-003",
         title: "Metal Fight Beyblade BB-118 Dark Bull (Video Demo, YouTube)",
         description: "Dark Bull H145SD, a defense-type top from the Metal Masters generation. Listed with a YouTube battle video to exercise the gallery's YouTube-embed video source.",
-        categorySlugs: ["category-metal-fusion", "category-metal-tops", "category-beyblade-metal", "category-spinning-tops"],
+        categorySlugs: ["category-dark-bull-h145sd", "category-metal-fusion", "category-metal-tops", "category-beyblade-metal", "category-spinning-tops"],
         categoryNames: ["Metal Fusion", "Metal Fight Tops", "Beyblade Metal Fight", "Spinning Tops"],
         brandSlug: "brand-takara-tomy",
         brand: "Takara-Tomy",
@@ -572,7 +573,7 @@ const _rawProductsStandardSeedData = [
         barcodeId: "LIR-BEY-VID-004",
         title: "Beyblade Burst B-97 Spryzen S2 (Video Demo, Wikimedia)",
         description: "Spryzen S2 stamina-type top from the God Layer generation. Listed with a Wikimedia-hosted spin video to exercise a second raw-external-host video source.",
-        categorySlugs: ["category-burst-cho-z", "category-burst-tops", "category-beyblade-burst", "category-spinning-tops"],
+        categorySlugs: ["category-spryzen-s2-0q", "category-burst-classic", "category-burst-tops", "category-beyblade-burst", "category-spinning-tops"],
         categoryNames: ["Cho-Z", "Burst Tops", "Beyblade Burst", "Spinning Tops"],
         brandSlug: "brand-beyblade",
         brand: "Beyblade",
@@ -606,11 +607,11 @@ const _rawProductsStandardSeedData = [
         // predicate ever runs, so it would prove nothing.
         id: "product-beyblade-x-dran-buster-sold-out",
         slug: "product-beyblade-x-dran-buster-sold-out",
-        title: "Beyblade X BX-34 Dran Buster (Sold Out)",
-        description: "The BX-34 Dran Buster attack type — this batch is fully sold. Watch for the next restock.",
+        title: "Beyblade X DranDagger 4-60R (Sold Out)",
+        description: "The DranDagger 4-60R attack type — this batch is fully sold. Watch for the next restock.",
         price: 1499,
         currency: "INR",
-        categorySlugs: ["category-x-basic", "category-x-tops", "category-beyblade-x", "category-spinning-tops"],
+        categorySlugs: ["category-drandagger-4-60r", "category-x-basic", "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",
@@ -633,11 +634,11 @@ const _rawProductsStandardSeedData = [
     {
         id: "product-beyblade-burst-valtryek-v3-sold-out",
         slug: "product-beyblade-burst-valtryek-v3-sold-out",
-        title: "Beyblade Burst Valtryek V3 (Sold Out)",
-        description: "Valtryek V3, the balance-type staple. This run sold through — no units remaining.",
+        title: "Beyblade Burst God Valkyrie 6Vortex Reboot (Sold Out)",
+        description: "God Valkyrie 6Vortex Reboot, the balance-type staple. This run sold through — no units remaining.",
         price: 899,
         currency: "INR",
-        categorySlugs: ["category-burst-superking", "category-burst-tops", "category-beyblade-burst", "category-spinning-tops"],
+        categorySlugs: ["category-god-valkyrie-6vortex-reboot", "category-burst-god", "category-burst-tops", "category-beyblade-burst", "category-spinning-tops"],
         categoryNames: ["Superking", "Burst Tops", "Beyblade Burst", "Spinning Tops"],
         brandSlug: "brand-beyblade",
         brand: "Beyblade",
@@ -715,4 +716,4 @@ export const productsStandardSeedData = [
         ...(p.id ? SPEC_OVERRIDES[p.id] : undefined),
         listingType: PRODUCT_FIELDS.LISTING_TYPE_VALUES.STANDARD,
     })),
-].map(withFinalSale);
+].map(withFinalSale).map(withDerivedCategoryNames);

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

@@ -20,10 +20,11 @@ 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 _rawProductsStickersSeedData = [
     {
-        id: "stickers-beyblade-original-classic-sheet",
-        slug: "stickers-beyblade-original-classic-sheet",
+        id: "sticker-beyblade-original-classic-sheet",
+        slug: "sticker-beyblade-original-classic-sheet",
         title: "Beyblade Original Classic — Sticker Sheet",
         description: "A 5x5 cm sticker sheet featuring Dranzer, Driger, Draciel, and Dragoon in classic original-series art style.",
         categorySlugs: ["category-original-plastic-gen", "category-original-tops", "category-beyblade-original", "category-spinning-tops"],
@@ -61,8 +62,8 @@ const _rawProductsStickersSeedData = [
         ]),
     },
     {
-        id: "stickers-beyblade-x-holographic-pack",
-        slug: "stickers-beyblade-x-holographic-pack",
+        id: "sticker-beyblade-x-holographic-pack",
+        slug: "sticker-beyblade-x-holographic-pack",
         title: "Beyblade X Holographic Sticker Pack",
         description: "A holographic-finish sticker pack featuring the current Beyblade X lineup — catches the light with a rainbow shimmer.",
         categorySlugs: ["category-x-basic", "category-x-tops", "category-beyblade-x", "category-spinning-tops"],
@@ -103,8 +104,8 @@ const _rawProductsStickersSeedData = [
         ]),
     },
     {
-        id: "stickers-beyblade-burst-diecut-set",
-        slug: "stickers-beyblade-burst-diecut-set",
+        id: "sticker-beyblade-burst-diecut-set",
+        slug: "sticker-beyblade-burst-diecut-set",
         title: "Beyblade Burst Die-Cut Sticker Set (6-Pack)",
         description: "Individually die-cut vinyl stickers of 6 fan-favorite Burst tops — no background, clean edges, weatherproof.",
         categorySlugs: ["category-burst-classic", "category-burst-tops", "category-beyblade-burst", "category-spinning-tops"],
@@ -142,8 +143,8 @@ const _rawProductsStickersSeedData = [
         ]),
     },
     {
-        id: "stickers-beyblade-metal-retro-sheet",
-        slug: "stickers-beyblade-metal-retro-sheet",
+        id: "sticker-beyblade-metal-retro-sheet",
+        slug: "sticker-beyblade-metal-retro-sheet",
         title: "Metal Fight Retro Sticker Sheet — Limited /500",
         description: "A limited-edition retro-styled sticker sheet celebrating Metal Fight favorites, numbered out of 500.",
         categorySlugs: ["category-metal-masters", "category-metal-tops", "category-beyblade-metal", "category-spinning-tops"],
@@ -181,8 +182,8 @@ const _rawProductsStickersSeedData = [
         ]),
     },
     {
-        id: "stickers-beyblade-x-glow-in-dark",
-        slug: "stickers-beyblade-x-glow-in-dark",
+        id: "sticker-beyblade-x-glow-in-dark",
+        slug: "sticker-beyblade-x-glow-in-dark",
         title: "Beyblade X Glow-in-the-Dark Sticker Pack",
         description: "Charge these stickers under light and watch the Beyblade X logos glow in the dark. Great for stadium cases and water bottles.",
         categorySlugs: ["category-x-basic", "category-x-tops", "category-beyblade-x", "category-spinning-tops"],
@@ -271,4 +272,4 @@ const _rawProductsStickersSeedData = [
  * 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 productsStickersSeedData = _rawProductsStickersSeedData.map(withFinalSale);
+export const productsStickersSeedData = _rawProductsStickersSeedData.map(withFinalSale).map(withDerivedCategoryNames);

package/dist/server.d.ts

@@ -3,6 +3,8 @@ export { searchEverything } from "./_internal/server/features/search/search-ever
 export type { SearchHit, SearchGroup, SearchSource, SearchEverythingResult, } from "./_internal/server/features/search/search-everything";
 export { SEARCH_SOURCES } from "./_internal/server/features/search/search-sources";
 export { getPartByKey, getModelsUsingPart, getCompositionById, getPartsForComposition, getCompositionsForCategory, listPartsBySlot, } from "./_internal/server/features/parts/data";
+export { renderCityOg, type CityOgData } from "./_internal/server/features/products/og";
+export { listBuildableModels, BUILDABLE_HOLDINGS_LIMIT, BUILDABLE_CANDIDATE_LIMIT, type BuildableModel, type BuildableResult, type BuildableSlot, } from "./_internal/server/features/parts/buildable";
 export { renderPartOg, renderPartClassificationOg, } from "./_internal/server/features/parts/og";
 export { assembleFromComponents, partOutToComponents, planAssembly, assertAssemblyInput, MAX_ASSEMBLY_COMPONENTS, } from "./_internal/server/features/parts/assembly";
 export type { AssemblyComponent, AssembleInput, PartOutInput, AssemblyResult, AssemblyPlan, StockWrite, } from "./_internal/server/features/parts/assembly";
@@ -567,6 +569,12 @@ export { buildDigitalCodeMetadata, type DigitalCodeMetadataOptions } from "./_in
 export { renderDigitalCodeOg, renderDigitalCodeOgImage, renderDigitalCodeOgFromDoc, type DigitalCodeOgData } from "./_internal/server/features/digital-code/og";
 export { addPoolEntries, listPoolEntries, deletePoolEntry, recountPool, assertCanUploadContentKind, DIGITAL_CONTENT_PREFIX, type AddPoolEntryInput, } from "./_internal/server/features/digital-code/pool";
 export { signDigitalContentUpload, finalizeDigitalContentUpload, contentKindForMime, type SignedDigitalContent, type FinalizedDigitalContent, } from "./_internal/server/features/digital-code/upload";
+/**
+ * D9 — chat. The one writer path for conversations and messages; every
+ * mutation runs through the Admin SDK here, never a client Firestore write
+ * (`firestore.rules` is `allow read, write: if false` on every document).
+ */
+export { createOrOpenConversation, openConversationWithSeller, listConversationsForUser, listMessagesForConversation, sendMessage, markConversationRead, blockConversationParticipant, softDeleteOwnMessage, mintChatEventToken, getUnreadConversationCount, deleteAllMessages as deleteAllConversationMessages, listAllAttachmentUrls as listConversationAttachmentUrls, stripPii as stripChatPii, type SendMessageInput, } from "./_internal/server/features/messages/actions";
 export { resolveCodeAssetForOrder, codeAssetHeaders, CODE_DOWNLOAD_STATUSES, type CodeAssetResolution, } from "./_internal/server/features/digital-code/download";
 export { getLiveItemForDetail } from "./_internal/server/features/live/data";
 export { toClientLiveItem, type LiveItemClientShape } from "./_internal/server/features/live/adapters";

package/dist/server.js

@@ -10,6 +10,15 @@ export { SEARCH_SOURCES } from "./_internal/server/features/search/search-source
 // D12 — part + composition reads. Every one is by document id or ONE
 // indexed equality; none needs a composite index.
 export { getPartByKey, getModelsUsingPart, getCompositionById, getPartsForComposition, getCompositionsForCategory, listPartsBySlot, } from "./_internal/server/features/parts/data.js";
+/*
+ * D13's last item — "which models can I build from the parts I hold".
+ * Exported because its only caller is a consumer route; the matcher it is built
+ * on (`matchSlotToHoldings`) stays internal, since a caller reaching for the
+ * matcher directly would be re-deriving the rollup's (part, colourway) rule.
+ */
+/* D5 — the city OG card. No money on it, by rule (Root Cause #93). */
+export { renderCityOg } from "./_internal/server/features/products/og.js";
+export { listBuildableModels, BUILDABLE_HOLDINGS_LIMIT, BUILDABLE_CANDIDATE_LIMIT, } from "./_internal/server/features/parts/buildable.js";
 export { renderPartOg, renderPartClassificationOg, } from "./_internal/server/features/parts/og.js";
 // D13 — assembly and part-out. Both run in a real transaction that RE-READS.
 export { assembleFromComponents, partOutToComponents, planAssembly, assertAssemblyInput, MAX_ASSEMBLY_COMPONENTS, } from "./_internal/server/features/parts/assembly.js";
@@ -1468,6 +1477,12 @@ export { renderDigitalCodeOg, renderDigitalCodeOgImage, renderDigitalCodeOgFromD
  */
 export { addPoolEntries, listPoolEntries, deletePoolEntry, recountPool, assertCanUploadContentKind, DIGITAL_CONTENT_PREFIX, } from "./_internal/server/features/digital-code/pool.js";
 export { signDigitalContentUpload, finalizeDigitalContentUpload, contentKindForMime, } from "./_internal/server/features/digital-code/upload.js";
+/**
+ * D9 — chat. The one writer path for conversations and messages; every
+ * mutation runs through the Admin SDK here, never a client Firestore write
+ * (`firestore.rules` is `allow read, write: if false` on every document).
+ */
+export { createOrOpenConversation, openConversationWithSeller, listConversationsForUser, listMessagesForConversation, sendMessage, markConversationRead, blockConversationParticipant, softDeleteOwnMessage, mintChatEventToken, getUnreadConversationCount, deleteAllMessages as deleteAllConversationMessages, listAllAttachmentUrls as listConversationAttachmentUrls, stripPii as stripChatPii, } from "./_internal/server/features/messages/actions.js";
 export { resolveCodeAssetForOrder, codeAssetHeaders, CODE_DOWNLOAD_STATUSES, } from "./_internal/server/features/digital-code/download.js";
 // ── Live-item listing — data + adapters + metadata + OG ──────────────────────
 export { getLiveItemForDetail } from "./_internal/server/features/live/data.js";