@mohasinac/appkit 4.52.5 → 4.53.1

package/dist/seed/bids-seed-data.d.ts

@@ -1,2 +1,2 @@
-import type { BidDocument } from "../features/auctions/schemas/firestore";
-export declare const bidsSeedData: BidDocument[];
+import type { BidPlain } from "../features/auctions/schemas/firestore";
+export declare const bidsSeedData: BidPlain[];

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

@@ -23,6 +23,7 @@
  * @tag consumers:seed/index.ts,seed/runner.ts
  * @tag sideEffects:none
  */
+import { buildBidSearchTxt } from "../utils/search-txt-builders.js";
 const NOW = new Date();
 const daysAgo = (n) => new Date(NOW.getTime() - n * 86400000);
 const BIDDER_EMAILS = {
@@ -36,7 +37,7 @@ const BIDDER_NAMES = {
     "user-ananya-collector": "Mock User 9",
 };
 /*
- * Typed on the document, not `FirestoreDocument`. Once `BidDocument` gained
+ * Typed on the PLAIN shape, not `FirestoreDocument`. Once `BidDocument` gained
  * `statusHistory?: StatusChangeEntry[]`, `Partial<BidDocument>` stopped being
  * assignable to `FirestoreDocument` — an array of objects does not satisfy
  * that index signature. The right fix is to narrow the parameter to what the
@@ -51,6 +52,26 @@ function withBidDefaults(b) {
         currency: "INR",
         isWinning: b.status === "active" || b.status === "won",
         updatedAt: (b.createdAt ?? NOW),
+        /*
+         * 🛑 DERIVED here, from the same builder the repository's write hook uses —
+         * never a hand-written token list.
+         *
+         * A seeded row without this is invisible to search forever:
+         * `array-contains` cannot match a field the document does not have, and it
+         * raises nothing (Root Cause #101's shape). Deriving it from
+         * `buildBidSearchTxt` is also what keeps the seed and every runtime write
+         * agreeing on the normalisation — two token lists built two ways is the
+         * mirror-drift trap (Root Cause #42).
+         *
+         * Applied INSIDE `withBidDefaults` on purpose, after `productTitle` is
+         * defaulted above: a derivation placed before it would index the empty
+         * string for every row that relies on the fallback.
+         */
+        searchTxt: buildBidSearchTxt({
+            productTitle: b.productTitle ??
+                (b.productId ?? "").replace(/^auction-/, "").replace(/-/g, " "),
+            userName: b.userName,
+        }),
     };
 }
 /**
@@ -154,7 +175,7 @@ const _rawBidsSeedData = [
     // auction-beyblade-burst-spriggan-requiem-bought-out — a BUYOUT ended it.
     //
     // Three competitive bids that lost, then the buyout that won. A buyout is a
-    // real BidDocument (`isBuyout: true`) — it is not a bid-free purchase, which
+    // real BidPlain (`isBuyout: true`) — it is not a bid-free purchase, which
     // is why the order's `sourceContext.bidCount` is 3 rather than 0: the buyout
     // itself is excluded from the "against N bidders" figure, the three it beat
     // are not. `standingBidAtBuyout` is read from these bids and NOT from

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

@@ -51,7 +51,7 @@
  * @tag sideEffects:none
  */
 import { CATEGORY_FIELDS } from "../constants/field-names.js";
-import { seedPhoto } from "./_helpers/media.js";
+import { seedPhoto, isSeedPlaceholderImage } from "./_helpers/media.js";
 import { buildCategoryTree } from "./_helpers/category-tree.js";
 import { withCategorySearchTxt } from "./_helpers/search-txt-wrappers.js";
 import { CATEGORY_FOREST } from "./_helpers/category-forest.js";
@@ -61,8 +61,9 @@ 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 { GENERATED_CATEGORY_IMAGES, GENERATED_CATEGORY_IMAGE_COUNT, } from "./_helpers/category-images-generated.js";
+import { GENERATED_CATEGORY_IMAGES, GENERATED_CATEGORY_IMAGE_COUNT, GENERATED_CATEGORY_HASBRO_IMAGES, } from "./_helpers/category-images-generated.js";
 import { productsStandardSeedData } from "./products-standard-seed-data.js";
+import { productsBeybladeXSeedData } from "./products-beyblade-x-seed-data.js";
 const NOW = new Date();
 const daysAgo = (n) => new Date(NOW.getTime() - n * 86400000);
 const emptyMetrics = {
@@ -228,19 +229,36 @@ const franchiseRows = buildFranchiseRows({
  * Deriving from the members' own chains means the union cannot disagree with
  * them, and a member whose chain moves updates every bundle holding it.
  */
-const PRODUCT_CHAINS = new Map(productsStandardSeedData.map((p) => [String(p.id), (p.categorySlugs ?? [])]));
+/*
+ * Both real-product arrays, not just the standard one.
+ *
+ * `productsBeybladeXSeedData` was added 2026-10-19 as a separate file (real,
+ * wiki-verified Beyblade X listings under store-letitrip-official). A bundle
+ * may legitimately hold one of those, and resolving only the standard array
+ * would make `bundleCategorySlugsFor` throw "not in productsStandardSeedData"
+ * for a product that genuinely exists — which is exactly what happened when
+ * the two fictional X fixtures this file's bundles used to reference were
+ * removed in favour of real ones.
+ */
+const PRODUCT_CHAINS = new Map([...productsStandardSeedData, ...productsBeybladeXSeedData].map((p) => [
+    String(p.id),
+    (p.categorySlugs ?? []),
+]));
 function bundleCategorySlugsFor(productIds) {
     const out = [];
     for (const id of productIds) {
         const chain = PRODUCT_CHAINS.get(id);
         /*
-         * A member missing from the standard seed is a BUG, not something to shrug
-         * past: the bundle would silently lose that member's categories and the
-         * Bundles tab would under-report. All eight current members are standard
-         * products; if that changes, widen the map rather than softening this.
+         * A member missing from the real-product seeds is a BUG, not something to
+         * shrug past: the bundle would silently lose that member's categories and
+         * the Bundles tab would under-report. The map was widened (rather than
+         * this check softened) on 2026-10-19 to cover
+         * `productsBeybladeXSeedData` as well — if another real-product file is
+         * added, widen it again.
          */
-        if (!chain)
-            throw new Error(`bundle member ${id} is not in productsStandardSeedData`);
+        if (!chain) {
+            throw new Error(`bundle member ${id} is in neither productsStandardSeedData nor productsBeybladeXSeedData`);
+        }
         for (const c of chain)
             if (!out.includes(c))
                 out.push(c);
@@ -268,8 +286,11 @@ function withBundleMosaic(row) {
     // half-built.
     if (ids.length === 0 || !row.display)
         return row;
+    // Both real-product arrays, for the same reason as PRODUCT_CHAINS above —
+    // otherwise a bundle holding a Beyblade X member silently loses that tile.
     const images = ids
-        .map((id) => productsStandardSeedData.find((p) => p.id === id)?.mainImage)
+        .map((id) => [...productsStandardSeedData, ...productsBeybladeXSeedData].find((p) => p.id === id)
+        ?.mainImage)
         .filter((src) => typeof src === "string" && src.length > 0);
     if (images.length === 0)
         return row;
@@ -387,18 +408,21 @@ const bundleRows = [
         id: "bundle-x-series-starter",
         name: "X-Series Starter Set",
         slug: "bundle-x-series-starter",
-        description: "Wizard Arrow and Knife Shinobi — the newest X-series tops for new battlers.",
+        description: "WizardArrow and KnightShield Ver.2.0 — the re-tuned Stamina and Defense tops from the BX-53 set, paired with a Burst-era Valkyrie.",
         categoryType: "bundle",
         bundleKind: "special",
         brandSlug: "brand-takara-tomy",
         bundlePrice: 2499,
         bundleQueryRule: {
             type: "static",
-            productIds: ["product-beyblade-x-wizard-arrow", "product-beyblade-x-knife-shinobi", "product-beyblade-burst-valkyrie"],
+            productIds: ["product-beyblade-x-bx-53-wizardarrow-v2", "product-beyblade-x-bx-53-knightshield-v2", "product-beyblade-burst-valkyrie"],
         },
-        bundleProductIds: ["product-beyblade-x-wizard-arrow", "product-beyblade-x-knife-shinobi", "product-beyblade-burst-valkyrie"],
-        bundleCategorySlugs: bundleCategorySlugsFor(["product-beyblade-x-wizard-arrow", "product-beyblade-x-knife-shinobi", "product-beyblade-burst-valkyrie"]),
-        bundleOriginalTotal: 2847, // 899 + 949 + 999
+        bundleProductIds: ["product-beyblade-x-bx-53-wizardarrow-v2", "product-beyblade-x-bx-53-knightshield-v2", "product-beyblade-burst-valkyrie"],
+        bundleCategorySlugs: bundleCategorySlugsFor(["product-beyblade-x-bx-53-wizardarrow-v2", "product-beyblade-x-bx-53-knightshield-v2", "product-beyblade-burst-valkyrie"]),
+        // 1500 + 1500 + 999. Recomputed 2026-10-19 when the two fictional X
+        // fixtures (899 + 949) were replaced by the real BX-53 component
+        // listings — a stale total here drives a wrong discount-% badge.
+        bundleOriginalTotal: 3999,
         bundleStockStatus: "in_stock",
         display: { coverImage: seedPhoto("bundle-x-series-starter-20260101", 1200, 900), showInFooter: false },
         isActive: true,
@@ -436,17 +460,20 @@ const bundleRows = [
                 "product-beyblade-original-driger-v",
                 "product-beyblade-metal-storm-pegasus",
                 "product-beyblade-burst-valkyrie",
-                "product-beyblade-x-wizard-arrow",
+                "product-beyblade-x-bx-53-wizardarrow-v2",
             ],
         },
         bundleProductIds: [
             "product-beyblade-original-driger-v",
             "product-beyblade-metal-storm-pegasus",
             "product-beyblade-burst-valkyrie",
-            "product-beyblade-x-wizard-arrow",
+            "product-beyblade-x-bx-53-wizardarrow-v2",
         ],
-        bundleCategorySlugs: bundleCategorySlugsFor(["product-beyblade-original-driger-v", "product-beyblade-metal-storm-pegasus", "product-beyblade-burst-valkyrie", "product-beyblade-x-wizard-arrow"]),
-        bundleOriginalTotal: 4996, // 1799 + 1299 + 999 + 899
+        bundleCategorySlugs: bundleCategorySlugsFor(["product-beyblade-original-driger-v", "product-beyblade-metal-storm-pegasus", "product-beyblade-burst-valkyrie", "product-beyblade-x-bx-53-wizardarrow-v2"]),
+        // 1799 + 1299 + 999 + 1500. Recomputed 2026-10-19 — the X member changed
+        // from the fictional "wizard-arrow" (899) to the real BX-53 WizardArrow
+        // 4-80B Ver.2.0 (1500).
+        bundleOriginalTotal: 5597,
         bundleStockStatus: "in_stock",
         display: { coverImage: seedPhoto("bundle-every-generation-starter-pack-20260101", 1200, 900), showInFooter: false },
         isActive: true,
@@ -530,13 +557,51 @@ function withGeneratedContent(row) {
  */
 function withGeneratedCoverImage(row) {
     const existing = row.display?.coverImage;
-    if (typeof existing === "string" && existing.trim().length > 0)
+    /*
+     * 🛑 A seed PLACEHOLDER tile does not count as hand-authored.
+     *
+     * The rule is still "a hand-authored cover wins", but a `seedPhoto(...)`
+     * tile was never authored — it is what the seed emits when it has nothing
+     * better. Treating it as a decision is what made the placeholder BLOCK every
+     * fetched wordmark: a logo could be downloaded, uploaded to Storage, mapped,
+     * and the card would still show a grey tile, with nothing anywhere
+     * reporting why.
+     *
+     * So the precedence is: real authored path > generated image > placeholder
+     * tile. That lets every branch row keep an honest tile in source — which is
+     * what it falls back to when no image exists, and is much better than the
+     * empty grey box a brand row would otherwise render, since brand rows carry
+     * no `color` and no `icon` either.
+     */
+    if (typeof existing === "string" && existing.trim().length > 0 && !isSeedPlaceholderImage(existing)) {
         return row;
+    }
     const generated = row.id ? GENERATED_CATEGORY_IMAGES[row.id] : undefined;
     if (!generated)
         return row;
     return { ...row, display: { ...(row.display ?? {}), coverImage: generated } };
 }
+/**
+ * Attach the REGIONAL-VARIANT logo to a row that names a Hasbro equivalent.
+ *
+ * 🛑 Gated on `hasbroName`, not merely on the map having an entry. The image is
+ * rendered beside the "Also known as" line, so without the name there is
+ * nothing to label it and a bare second logo reads as a duplicate of the
+ * cover. The name is the fact; the image only illustrates it.
+ *
+ * Same hand-authored-wins rule as the cover, for the same reason: the admin
+ * editor can set `hasbroCoverImage` on a row the generator knows nothing
+ * about, and a reseed must not take that away.
+ */
+function withGeneratedHasbroCover(row) {
+    if (!row.hasbroName)
+        return row;
+    const existing = row.hasbroCoverImage;
+    if (typeof existing === "string" && existing.trim().length > 0)
+        return row;
+    const generated = row.id ? GENERATED_CATEGORY_HASBRO_IMAGES[row.id] : undefined;
+    return generated ? { ...row, hasbroCoverImage: generated } : row;
+}
 const allCategoryRows = [
     ...rawCategories.map((c) => ({ ancestors: [], ...c, createdByType: "admin" })),
     ...sublistingRows.map((s) => ({ ancestors: [], ...s, createdByType: "admin" })),
@@ -546,6 +611,7 @@ const allCategoryRows = [
 ]
     .map(withGeneratedContent)
     .map(withGeneratedCoverImage)
+    .map(withGeneratedHasbroCover)
     .map(withCategorySearchTxt);
 /*
  * ── Assertions, at MODULE LOAD, so a silent drop is loud ─────────────────────
@@ -626,6 +692,44 @@ if (generatedImagesApplied < Math.floor(GENERATED_CATEGORY_IMAGE_COUNT * 0.9)) {
         `scripts/fetch-taxonomy-images.mjs against the current forest. Nothing would error ` +
         `at load time: the category grids would just go back to blank cards.`);
 }
+/*
+ * The regional-variant logos. This catches ORPHANED logos, and deliberately
+ * only those.
+ *
+ * 🛑 The two directions are NOT symmetric, which a first draft of this comment
+ * got wrong until a negative control was actually run against it:
+ *
+ *   - **A map entry whose row does not name a Hasbro wave is an ERROR.**
+ *     `withGeneratedHasbroCover` gates on `hasbroName`, so that image can
+ *     never render — it was fetched, uploaded to Storage and mapped, and is
+ *     now a stored object nothing will ever serve. Silent waste. Throw.
+ *
+ *   - **A named wave with no logo is FINE.** The "Also known as" block renders
+ *     the name and omits the image (`CategoryDetailPageView` makes the picture
+ *     conditional), which is a correct, intentional-looking page. Setting a
+ *     name we can evidence while having no logo we can source is exactly the
+ *     honest-gap rule the rest of this work follows, so failing the seed for
+ *     it would punish the right behaviour.
+ *
+ * Hence `covered !== keys` and NOT `covered !== named`. Exact equality rather
+ * than a 90% floor because there are five, hand-set against five confirmed
+ * pairings: "most of them" is not a meaningful tolerance at that size.
+ */
+const hasbroNamed = allCategoryRows.filter((c) => typeof c.hasbroName === "string" && c.hasbroName);
+const hasbroCovered = hasbroNamed.filter((c) => typeof c.id === "string" && GENERATED_CATEGORY_HASBRO_IMAGES[c.id] === c.hasbroCoverImage);
+const hasbroMapKeys = Object.keys(GENERATED_CATEGORY_HASBRO_IMAGES);
+if (hasbroCovered.length !== hasbroMapKeys.length) {
+    const namedIds = new Set(hasbroNamed.map((c) => c.id));
+    const orphanLogos = hasbroMapKeys.filter((k) => !namedIds.has(k));
+    throw new Error(`category seed: ${hasbroCovered.length} of ${hasbroMapKeys.length} regional-variant logos ` +
+        `reached a row that names one. ` +
+        (orphanLogos.length > 0
+            ? `These have a logo but no hasbroName: ${orphanLogos.join(", ")}. `
+            : "") +
+        `Either set hasbroName in category-forest.ts, or drop the entry from the manifest and ` +
+        `re-run scripts/fetch-category-images.mjs. Nothing would error at load time — the ` +
+        `"Also known as" block would just render without its logo.`);
+}
 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/events-seed-data.d.ts

@@ -1,5 +1,5 @@
-import type { EventDocument, EventEntryDocument } from "../features/events/schemas";
-export declare const eventEntriesSeedData: EventEntryDocument[];
+import type { EventDocument, EventEntryPlain } from "../features/events/schemas";
+export declare const eventEntriesSeedData: EventEntryPlain[];
 /**
  * Tokens derived here, not per record — see _helpers/search-txt-wrappers.ts for
  * why the wrapper form is what makes omission impossible.

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

@@ -361,6 +361,11 @@ const _raweventsSeedData = [
     },
 ];
 // ── Event Entries ────────────────────────────────────────────────────────────
+/*
+ * 🛑 `EventEntryPlain`: these fixtures hold REAL plaintext and `seed-cli`
+ * encrypts the PII fields on write. The document type now declares them
+ * `Encrypted<string>`, so the document type would be a false claim.
+ */
 export const eventEntriesSeedData = [
     // Rehan entered the poll
     {

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

@@ -659,7 +659,7 @@ const faqSeedRecords = [
     {
         id: "faq-how-to-verify-authenticity",
         question: "How can I verify if a collectible is authentic?",
-        answer: html(`<p>Look for these trust signals on LetItRip: <strong>Verified Seller</strong> badge (store has passed manual review), <strong>Graded</strong> badge (PSA/BGS/CGC certified with certificate number), <strong>Sealed</strong> badge (factory-sealed product). For ungraded items, check the seller's photo quality and description detail. If in doubt, message the seller before purchasing.</p>`),
+        answer: html(`<p>Look for these trust signals on LetItRip: <strong>Verified Seller</strong> badge (store has passed manual review), <strong>Graded</strong> badge (PSA/BGS/CGC certified with certificate number), <strong>Sealed</strong> badge (factory-sealed product). For ungraded items, check the seller's photo quality and description detail. If in doubt, message the seller before purchasing.</p><p>For <strong>Beyblades specifically</strong>, the <a href="/tools/authenticity">authenticity checker</a> takes a model name, a box code or the brand on the packaging and tells you which checks apply to that generation — and the <a href="/spot-a-fake">spot-a-fake guide</a> walks the same signals by hand, with no account needed.</p>`),
         category: "product_information",
         showOnHomepage: true,
         showInFooter: false,
@@ -667,7 +667,7 @@ const faqSeedRecords = [
         order: 32,
         priority: 8,
         tags: ["authentication", "verification", "trust"],
-        relatedFAQs: ["faq-counterfeit-guarantee", "faq-psa-vs-bgs-vs-cgc"],
+        relatedFAQs: ["faq-counterfeit-guarantee", "faq-psa-vs-bgs-vs-cgc", "faq-check-if-my-beyblade-is-original"],
         stats: makeStats(3800, 190),
         seo: { slug: "faq-how-to-verify-authenticity", metaTitle: "Verify Collectible Authenticity", metaDescription: "How to verify if a collectible is authentic on LetItRip." },
         isActive: true,
@@ -1464,10 +1464,79 @@ const faqSeedRecords = [
         createdAt: daysAgo(30),
         updatedAt: daysAgo(2),
     },
+    {
+        id: "faq-check-if-my-beyblade-is-original",
+        question: "How do I check whether my Beyblade is original?",
+        answer: html("<p>Start with the <a href=\"/tools/authenticity\">authenticity checker</a>. Give it a model name, the code printed on the box, or the brand on the packaging, and it tells you which checks apply to that generation, what the recorded box codes say, and what is still unsettled. The reference half of that page — the generation table, the box-code explanation, the checks that apply regardless — is free and needs no account; only the per-item lookup asks you to sign in.</p><p>🛑 <strong>It grades, it does not rule.</strong> The strongest thing it will say is that something matches a batch collectors record as a reduced-quality run — a statement about a production batch, never an accusation against your seller. Authenticity is settled by physical checks, and the tool lists the conclusive ones first for your generation: a fully die-cast performance tip on a Metal Fight bey, Phillips screws where tri-wing belong on Burst, a Gear Chip missing the <em>Beyblade X</em> logo, or moulded Takara copyright text absent from a plastic-generation part.</p><p>The longer buying guide is at <a href=\"/spot-a-fake\">how to spot a fake</a>. If the problem is a specific seller rather than a specific item, the <a href=\"/scams\">scam registry</a> takes reports.</p>"),
+        category: "product_information",
+        showOnHomepage: true,
+        showInFooter: false,
+        isPinned: false,
+        order: 208,
+        priority: 10,
+        tags: ["authenticity", "fake", "original", "beyblade", "checker", "takara tomy"],
+        relatedFAQs: ["faq-beyblade-box-code-meaning", "faq-what-is-a-reproduction", "faq-is-funskool-beyblade-fake"],
+        stats: makeStats(0, 0),
+        seo: {
+            slug: "faq-check-if-my-beyblade-is-original",
+            metaTitle: "How do I check whether my Beyblade is original?",
+            metaDescription: "Use the authenticity checker: a model name, a box code or the brand on the packaging, and it shows which checks apply to that generation and what is still unsettled.",
+        },
+        isActive: true,
+        createdBy: "user-admin-letitrip",
+        createdAt: daysAgo(1),
+        updatedAt: daysAgo(1),
+    },
+    {
+        id: "faq-beyblade-box-code-meaning",
+        question: "What does the code on the bottom of the box mean?",
+        answer: html("<p>Two different things are both called “the code”, and they answer different questions.</p><p>A <strong>product code</strong> — <code>BB-105</code>, <code>B-174</code>, <code>BX-34</code>, <code>MA-09</code> — identifies the release, and its letter prefix identifies the generation. Read the whole letter group before the digits: <code>BB-</code> is Metal Fight while <code>B-</code> is Burst, so they are easy to confuse. 🛑 <strong>A product code existing proves nothing about authenticity.</strong> One counterfeit catalogue we measured carried more than 900 genuine Takara Tomy codes across 1,277 unlicensed products. What carries information is whether the code and the model name <em>agree</em> — which is what the <a href=\"/tools/authenticity\">authenticity checker</a> compares.</p><p>A <strong>date code</strong> is a letter followed by four digits, like <code>A0813</code>, and it is a production stamp. Collectors have compiled which of these appear on boxes known to be genuine and which belong to reduced-quality batches, and the checker holds both lists for the Metal Fight era. 🛑 <strong>How it decodes is disputed.</strong> One reading takes the letter as the month and the next two digits as the day (8 January 2013); another takes the letter as the factory and the digits as the week of the year. Takara Tomy has published neither, so treat any date as indicative. No decoding has been established at all for Burst or Beyblade X boxes.</p><p>A code that is in neither list means <em>not recorded</em>, not <em>fake</em> — the lists were compiled from boxes collectors personally held, and new genuine codes still surface.</p>"),
+        category: "product_information",
+        showOnHomepage: false,
+        showInFooter: false,
+        isPinned: false,
+        order: 209,
+        priority: 9,
+        tags: ["box code", "date code", "product code", "authenticity", "takara tomy", "midfake"],
+        relatedFAQs: ["faq-check-if-my-beyblade-is-original", "faq-what-is-a-reproduction"],
+        stats: makeStats(0, 0),
+        seo: {
+            slug: "faq-beyblade-box-code-meaning",
+            metaTitle: "What does the code on the bottom of a Beyblade box mean?",
+            metaDescription: "Product codes identify the release and the generation; date codes are production stamps with two disputed readings. Neither proves a bey is genuine on its own.",
+        },
+        isActive: true,
+        createdBy: "user-admin-letitrip",
+        createdAt: daysAgo(1),
+        updatedAt: daysAgo(1),
+    },
+    {
+        id: "faq-is-funskool-beyblade-fake",
+        question: "Is a Funskool Beyblade fake? What about Sonokong?",
+        answer: html("<p><strong>No. Both are legitimate.</strong> Funskool is a licensed Indian importer and Sonokong is the licensed South Korean producer — their names on a box are a <em>positive</em> signal, not a warning. The same goes for the other regional importers: Mani (Hong Kong), Funbox (Taiwan), Sheng Tai (Singapore), NewBoy (Middle East), Bankee (Philippines) and PT Emway (Indonesia). An importer’s holographic sticker or certificate inside the packaging is a sign of a properly imported product.</p><p>🛑 A guide that tells you anything other than “Takara Tomy” or “Hasbro” is a fake is simply wrong, and that mistake is costly in India specifically, where Funskool product is common.</p><p>What <em>should</em> worry you is a box whose most prominent branding is a name nobody licenses — or no manufacturer name at all. Sellers of unlicensed tops here rarely claim to be originals; they sell under their own brand as “aftermarket”, “custom” or “upgraded”. That framing is not a grey area. You can check a brand name against the known lists in the <a href=\"/tools/authenticity\">authenticity checker</a>.</p>"),
+        category: "product_information",
+        showOnHomepage: false,
+        showInFooter: false,
+        isPinned: false,
+        order: 211,
+        priority: 8,
+        tags: ["funskool", "sonokong", "importer", "authenticity", "india", "licensed"],
+        relatedFAQs: ["faq-check-if-my-beyblade-is-original", "faq-what-is-a-reproduction"],
+        stats: makeStats(0, 0),
+        seo: {
+            slug: "faq-is-funskool-beyblade-fake",
+            metaTitle: "Is a Funskool Beyblade fake?",
+            metaDescription: "No — Funskool is a licensed Indian importer and Sonokong the licensed Korean producer. Both marques are a positive signal, not a warning.",
+        },
+        isActive: true,
+        createdBy: "user-admin-letitrip",
+        createdAt: daysAgo(1),
+        updatedAt: daysAgo(1),
+    },
     {
         id: "faq-what-is-a-reproduction",
         question: "What is a \"reproduction\" or \"midfake\"? Is it a fake?",
-        answer: html("<p>A <strong>reproduction</strong> — the community calls them midfakes — is an unbranded 1st-copy of an original design, mostly Chinese-made, carrying no manufacturer's marque. Quality is often genuinely good, and some tournament formats permit certain reproduction parts.</p><p>It is <strong>not</strong> the same as a cheap counterfeit. A counterfeit is poor-quality and can contain lead or cadmium in its metal parts, which is a safety matter — we do not allow those listed at all. A reproduction is a legitimate thing to sell <em>when it is labelled</em>, and every listing on LetItRip states its authenticity as Original, Reproduction, or Unverified.</p><p>🛑 If a seller calls something \"aftermarket\", \"custom\" or \"upgraded\" without naming a manufacturer, they are describing a reproduction. Ask.</p>"),
+        answer: html("<p><strong>“Midfake” is used two ways</strong>, and the difference matters. In the Metal Fight community it means a specific thing: a <em>Takara Tomy</em> batch of reduced quality, built on Takara Tomy blueprints in Taiwan, with different alloys and TT-style box codes — so it may well carry the real marque. Collectors identify those batches by the code on the bottom of the box. Used more loosely — and this is the commoner sense in India — it means any 1st-copy of an original design, mostly Chinese-made, carrying no manufacturer's marque at all. Quality is often genuinely good, and some tournament formats permit certain reproduction parts.</p><p>🛑 There is <strong>no official Takara Tomy statement</strong> acknowledging the reduced-quality batches, so everything known about them comes from collectors comparing boxes.</p><p>It is <strong>not</strong> the same as a cheap counterfeit. A counterfeit is poor-quality and can contain lead or cadmium in its metal parts, which is a safety matter — we do not allow those listed at all. A reproduction is a legitimate thing to sell <em>when it is labelled</em>, and every listing on LetItRip states its authenticity as Original, Reproduction, or Unverified.</p><p>🛑 If a seller calls something \"aftermarket\", \"custom\" or \"upgraded\" without naming a manufacturer, they are describing a reproduction. Ask.</p>"),
         category: "product_information",
         showOnHomepage: true,
         showInFooter: false,
@@ -1475,12 +1544,12 @@ const faqSeedRecords = [
         order: 210,
         priority: 10,
         tags: ["reproduction", "midfake", "authenticity", "fake", "aftermarket"],
-        relatedFAQs: [],
+        relatedFAQs: ["faq-check-if-my-beyblade-is-original", "faq-beyblade-box-code-meaning", "faq-counterfeit-guarantee"],
         stats: makeStats(670, 50),
         seo: {
             slug: "faq-what-is-a-reproduction",
             metaTitle: "What is a \"reproduction\" or \"midfake\"? Is it a fake?",
-            metaDescription: "A reproduction — the community calls them midfakes — is an unbranded 1st-copy of an original design, mostly Chinese-made, carrying no manufacturer's marque",
+            metaDescription: "“Midfake” means two different things — a reduced-quality Takara Tomy batch, or any unbranded 1st-copy. Both differ from a counterfeit.",
         },
         isActive: true,
         createdBy: "user-admin-letitrip",
@@ -1763,6 +1832,107 @@ const faqSeedRecords = [
         createdAt: daysAgo(30),
         updatedAt: daysAgo(2),
     },
+    // ── STICKER SHEETS (3) ──────────────────────────────────────────────────────
+    //
+    // 🛑 FILED UNDER `product_information`, NOT A NEW `stickers` CATEGORY.
+    // The plan called for one, on the premise that the seeded set was
+    // Shipping/Returns/Payments/Auctions/Pre-orders — that list came from a stale
+    // paragraph in CLAUDE.md. The real union already carries `product_information`
+    // (FAQ_CATEGORY_LABELS), which is exactly what these are. Adding a tenth
+    // category for three entries would mean extending a compile-checked union,
+    // the admin option list and every chip derived from it, to say something an
+    // existing value already says.
+    //
+    // 🛑 THREE, NOT SIX. The plan drafted six questions and said plainly that the
+    // answers to half of them need product facts nobody has yet. Those three are
+    // listed below as questions ONLY, and are deliberately NOT seeded — `faqs` is
+    // a public, indexed collection with its own seo.slug, so a placeholder answer
+    // there is a confident lie on a page Google will read.
+    //
+    //   · "What size are the stickers?"           needs: real sheet + part dimensions
+    //   · "Are they weatherproof / dishwasher-safe?" needs: material + laminate spec
+    //   · "Can I buy a single sticker rather than a whole sheet?"
+    //       needs: the per-part listings from Part Two. Today the honest answer is
+    //       "no", and seeding that now would have to be rewritten the week the
+    //       grouped parent+parts listings ship.
+    //
+    // The three below need no product facts — they explain what a kiss cut IS,
+    // which is true of every kiss-cut sticker ever made.
+    {
+        id: "faq-what-is-a-kiss-cut-sticker",
+        question: "What is a kiss-cut sticker?",
+        answer: html(`<p>A <strong>kiss cut</strong> goes through the sticker's vinyl but <em>not</em> through the paper backing behind it. The sheet stays in one piece, and each sticker peels off individually when you want it.</p><p>A <strong>die cut</strong> goes all the way through both layers, so every sticker is already a separate loose piece.</p><p>Kiss-cut sheets are what vintage Beyblade stickers were originally made as: one sheet, many stickers, each outlined along its own shape.</p>`),
+        category: "product_information",
+        showOnHomepage: false,
+        showInFooter: false,
+        isPinned: false,
+        order: 1,
+        priority: 5,
+        tags: ["stickers", "kiss-cut", "die-cut", "sheets"],
+        relatedFAQs: ["faq-sticker-white-border", "faq-how-to-apply-a-sticker"],
+        useSiteSettings: true,
+        variables: {},
+        stats: makeStats(0, 0),
+        seo: {
+            slug: "faq-what-is-a-kiss-cut-sticker",
+            metaTitle: "What is a kiss-cut sticker? | LetItRip",
+            metaDescription: "A kiss cut goes through the vinyl but not the backing, so the sheet stays whole and each sticker peels off on its own.",
+        },
+        isActive: true,
+        createdBy: "user-admin-letitrip",
+        createdAt: daysAgo(1),
+        updatedAt: daysAgo(1),
+    },
+    {
+        id: "faq-sticker-white-border",
+        question: "Why do some stickers have a white border around them?",
+        answer: html(`<p>That border is part of the cut, not a printing mistake. A cutter cannot follow fine detail perfectly, so the cut line is placed slightly <em>outside</em> the artwork — the small margin that leaves is what stops a sliver of artwork being shaved off if the blade drifts by a fraction of a millimetre.</p><p>Where the original sticker was designed with a border, we keep it. Where it was cut tight to the art, we cut tight to the art.</p>`),
+        category: "product_information",
+        showOnHomepage: false,
+        showInFooter: false,
+        isPinned: false,
+        order: 2,
+        priority: 4,
+        tags: ["stickers", "border", "cutting", "bleed"],
+        relatedFAQs: ["faq-what-is-a-kiss-cut-sticker"],
+        useSiteSettings: true,
+        variables: {},
+        stats: makeStats(0, 0),
+        seo: {
+            slug: "faq-sticker-white-border",
+            metaTitle: "Why do stickers have a white border? | LetItRip",
+            metaDescription: "The margin around a sticker is part of the cut — it stops the blade shaving artwork if it drifts a fraction of a millimetre.",
+        },
+        isActive: true,
+        createdBy: "user-admin-letitrip",
+        createdAt: daysAgo(1),
+        updatedAt: daysAgo(1),
+    },
+    {
+        id: "faq-how-to-apply-a-sticker",
+        question: "How do I apply a sticker so it does not lift at the edges?",
+        answer: html(`<p>Clean the surface first and let it dry completely — most lifting is a dusty or slightly greasy surface rather than the adhesive.</p><p>Peel the sticker from one corner rather than lifting it flat, lay that edge down first, then press across the sticker in one direction so the air pushes out ahead of your finger instead of being trapped under it.</p><p>Press firmly for a few seconds once it is down, and leave it a day before getting it wet.</p>`),
+        category: "product_information",
+        showOnHomepage: false,
+        showInFooter: false,
+        isPinned: false,
+        order: 3,
+        priority: 3,
+        tags: ["stickers", "application", "how-to"],
+        relatedFAQs: ["faq-what-is-a-kiss-cut-sticker"],
+        useSiteSettings: true,
+        variables: {},
+        stats: makeStats(0, 0),
+        seo: {
+            slug: "faq-how-to-apply-a-sticker",
+            metaTitle: "How to apply a sticker without lifting edges | LetItRip",
+            metaDescription: "Clean the surface, lay one edge first, and press across in one direction so air pushes out ahead of your finger.",
+        },
+        isActive: true,
+        createdBy: "user-admin-letitrip",
+        createdAt: daysAgo(1),
+        updatedAt: daysAgo(1),
+    },
 ];
 /**
  * Derive `searchTxt` for every record from its own content.

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

@@ -96,6 +96,22 @@ export const groupedListingsSeedData = [
         createdBy: "user-admin-letitrip",
         createdAt: daysAgo(15),
         updatedAt: daysAgo(3),
+        /*
+         * Part Two E — the one seeded fixture exercising self-assembled-selection
+         * rules end to end (`GroupMemberPicker` ↔ `checkGroupRules` ↔
+         * `deriveLinePrice`'s discount), without requiring the sticker tracer's
+         * multi-step admin flow to produce one first.
+         *
+         * 🛑 Deliberately NOT `minActiveMembers` (above) — that is visibility ("hide
+         * the whole group below 2 ACTIVE members"). `groupMinMembers` constrains
+         * what ONE BUYER'S SELECTION may contain, and the two can legitimately
+         * disagree: this group stays visible at 2 active members while requiring a
+         * buyer to pick at least 2 of the 4.
+         */
+        groupMinMembers: 2,
+        groupMaxMembers: 3,
+        groupMaxUnitsPerMember: 2,
+        groupDiscountPercent: 10,
     },
     // --- Coverage for every other listing type — previously only standard products had a
     //     group, so the public GroupedListingsCarousel (Phase 3) had nothing to render on