@mohasinac/appkit 4.53.1 → 4.54.0

package/dist/seed/carousel-slides-seed-data.js

@@ -33,7 +33,6 @@
  * @tag consumers:seed/index.ts,seed/runner.ts
  * @tag sideEffects:none
  */
-import { seedPhoto } from "./_helpers/media.js";
 import { ROUTES } from "../next/routing/route-map.js";
 const NOW = new Date();
 const daysAgo = (n) => new Date(NOW.getTime() - n * 86400000);
@@ -41,6 +40,44 @@ const daysAgo = (n) => new Date(NOW.getTime() - n * 86400000);
 // under a full welcome hero, so a viewport-height slide would push the whole
 // page below the fold.
 const SLIDE_SETTINGS = { autoplayDelayMs: 6000, height: "medium" };
+/**
+ * 🛑 Real imagery, from `mediaAssets` rows that already exist.
+ *
+ * Every background and card on this carousel used to be `seedPhoto(...)`, which
+ * since 2026-10-09 returns one of SIX flat solid-colour SVG tiles from
+ * `public/images/seed-tiles/` — so the homepage hero was five grey rectangles,
+ * and the width/height arguments passed beside them were accepted and ignored.
+ * Meanwhile 559 wiki-sourced `mediaAssets` rows were sitting in Storage wired
+ * to leaf categories and to nothing on the homepage.
+ *
+ * These are `/media/<shortId>` paths, which resolve through
+ * `mediaAssets/{slug}` → `storagePath` and stream from OUR bucket behind a
+ * 30-day immutable cache — one invocation per image per edge per month.
+ *
+ * 🛑 Never `seedExtMedia()` and never a third-party host here: persisting a
+ * remote URL through `/api/media/ext` adds an upstream fetch plus a sharp
+ * watermark pass to EVERY render, which is Root Cause #104 — ~900K proxy
+ * responses and 52.52 GB of origin transfer against a 10 GB allowance, and a
+ * suspended project.
+ *
+ * 🛑 These are publisher product shots on white, not action photography. They
+ * are a floor, not a ceiling — see the shot list in the plan for what should
+ * eventually replace them. Each one still carries a `dimOverlay` because the
+ * overlay copy is fixed-inverse ink and needs a guaranteed-dark backdrop
+ * (Root Cause #67).
+ */
+const MEDIA = {
+    franchise: "/media/franchise-beyblade-image",
+    genOriginal: "/media/category-beyblade-original-image",
+    genMetal: "/media/category-beyblade-metal-image",
+    genBurst: "/media/category-beyblade-burst-image",
+    genX: "/media/category-beyblade-x-image",
+    dranzer: "/media/category-dranzer-f-image",
+    dragoon: "/media/category-dragoon-f-image",
+    aeroPegasus: "/media/category-aeropegasus-3-70a-image",
+    spryzen: "/media/category-spryzen-requiem-s3-image",
+    lDrago: "/media/category-l-drago-destructor-f-s-image",
+};
 const _rawSlides = [
     {
         id: "slide-hero-homepage",
@@ -49,7 +86,7 @@ const _rawSlides = [
         active: true,
         background: {
             type: "image",
-            url: seedPhoto("carousel-hero-homepage-20260101", 1600, 700),
+            url: MEDIA.franchise,
             dimOverlay: { enabled: true, opacity: 0.55 },
         },
         // The ONE cards slide — and therefore the one slide with no `overlay`.
@@ -60,7 +97,7 @@ const _rawSlides = [
                 id: "card-hero-shop-now",
                 zone: 1,
                 mobileZone: 2,
-                background: { type: "image", url: seedPhoto("carousel-card-shop-now", 600, 600), dimOverlay: { enabled: true, opacity: 0.45 } },
+                background: { type: "image", url: MEDIA.dranzer, dimOverlay: { enabled: true, opacity: 0.45 } },
                 content: {
                     eyebrow: "Buy now",
                     title: "Ready to ship",
@@ -73,7 +110,7 @@ const _rawSlides = [
                 id: "card-hero-bid",
                 zone: 2,
                 mobileZone: 2,
-                background: { type: "image", url: seedPhoto("carousel-card-bid", 600, 600), dimOverlay: { enabled: true, opacity: 0.45 } },
+                background: { type: "image", url: MEDIA.lDrago, dimOverlay: { enabled: true, opacity: 0.45 } },
                 content: {
                     eyebrow: "Bid",
                     title: "Live auctions",
@@ -86,7 +123,7 @@ const _rawSlides = [
                 id: "card-hero-reserve",
                 zone: 3,
                 mobileZone: 2,
-                background: { type: "image", url: seedPhoto("carousel-card-reserve", 600, 600), dimOverlay: { enabled: true, opacity: 0.45 } },
+                background: { type: "image", url: MEDIA.aeroPegasus, dimOverlay: { enabled: true, opacity: 0.45 } },
                 content: {
                     eyebrow: "Reserve",
                     title: "Pre-orders",
@@ -113,7 +150,7 @@ const _rawSlides = [
             // (rejects non-image content-type with 400). MediaVideo watermarks
             // video client-side instead, so the raw external URL is correct here.
             url: "/demo-media/sample-video.mp4",
-            thumbnail: seedPhoto("carousel-auctions-live-20260101", 1600, 700),
+            thumbnail: MEDIA.genMetal,
             dimOverlay: { enabled: true, opacity: 0.5 },
         },
         overlay: {
@@ -142,7 +179,7 @@ const _rawSlides = [
         active: true,
         background: {
             type: "image",
-            url: seedPhoto("carousel-complete-collection-20260101", 1600, 700),
+            url: MEDIA.genBurst,
             dimOverlay: { enabled: true, opacity: 0.5 },
         },
         overlay: {
@@ -171,7 +208,7 @@ const _rawSlides = [
         active: true,
         background: {
             type: "image",
-            url: seedPhoto("carousel-preorders-open-20260101", 1600, 700),
+            url: MEDIA.genX,
             dimOverlay: { enabled: true, opacity: 0.5 },
         },
         overlay: {
@@ -238,7 +275,7 @@ const _rawSlides = [
         active: true,
         background: {
             type: "image",
-            url: seedPhoto("carousel-authenticated-originals-20260101", 1600, 700),
+            url: MEDIA.genOriginal,
             dimOverlay: { enabled: true, opacity: 0.55 },
         },
         overlay: {
@@ -305,7 +342,7 @@ const _rawSlides = [
         active: false,
         background: {
             type: "image",
-            url: seedPhoto("carousel-tournament-promo-20260101", 1600, 700),
+            url: MEDIA.spryzen,
             dimOverlay: { enabled: true, opacity: 0.5 },
         },
         overlay: {

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

@@ -57,8 +57,8 @@ import { withCategorySearchTxt } from "./_helpers/search-txt-wrappers.js";
 import { CATEGORY_FOREST } from "./_helpers/category-forest.js";
 import { BRAND_ROW_COUNT, buildBrandRows } from "./_helpers/brand-rows.js";
 import { FRANCHISE_ROW_COUNT, buildFranchiseRows } from "./_helpers/franchise-rows.js";
-import { MODEL_LEAF_COUNT } from "./_helpers/category-models.js";
-import { PART_LEAF_COUNT } from "./_helpers/category-parts.js";
+import { MODEL_LEAF_COUNT, MODEL_LEAVES } from "./_helpers/category-models.js";
+import { PART_LEAF_COUNT, PART_LEAVES } 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, GENERATED_CATEGORY_HASBRO_IMAGES, } from "./_helpers/category-images-generated.js";
@@ -743,11 +743,53 @@ if (allIds.length !== allCategoryRows.length) {
 const tier4Rows = rawCategories.filter((c) => c.tier === 4).length;
 const expectedTier4 = MODEL_LEAF_COUNT + PART_LEAF_COUNT;
 if (tier4Rows !== expectedTier4) {
+    /*
+     * 🛑 NAME THE DROPPED LEAVES. A count told us 2,626 of 2,711 arrived and
+     * nothing more, which is unactionable: the ids are all distinct and every
+     * parent key exists in the forest, so the difference is in WHICH parent each
+     * leaf hangs off and at what depth — and that is only visible per leaf.
+     *
+     * The expensive version of this was a session spent inferring the cause from
+     * indentation in the forest literal. The cheap version is the set
+     * difference, grouped by the parent that owns each missing leaf, which also
+     * says the tier it actually landed at. One run names the fix.
+     */
+    const reached = new Set(rawCategories.filter((c) => c.tier === 4).map((c) => String(c.id)));
+    const tierOf = new Map(rawCategories.map((c) => [String(c.id), c.tier]));
+    const declared = [];
+    for (const [parent, leaves] of Object.entries(MODEL_LEAVES)) {
+        for (const leaf of leaves)
+            declared.push({ id: leaf.id, parent });
+    }
+    for (const [parent, leaves] of Object.entries(PART_LEAVES)) {
+        for (const leaf of leaves)
+            declared.push({ id: leaf.id, parent });
+    }
+    const missing = declared.filter((d) => !reached.has(d.id));
+    const byParent = new Map();
+    for (const m of missing) {
+        if (!byParent.has(m.parent)) {
+            byParent.set(m.parent, { n: 0, landedAt: new Set(), sample: [] });
+        }
+        const g = byParent.get(m.parent);
+        g.n += 1;
+        g.landedAt.add(tierOf.has(m.id) ? `tier ${tierOf.get(m.id)}` : "absent");
+        if (g.sample.length < 3)
+            g.sample.push(m.id);
+    }
+    const detail = [...byParent.entries()]
+        .sort((a, b) => b[1].n - a[1].n)
+        .map(([parent, g]) => `    ${parent}: ${g.n} leaf/leaves landed at ${[...g.landedAt].join("+")} ` +
+        `(e.g. ${g.sample.join(", ")})`)
+        .join("\n");
     throw new Error(`category seed: ${tier4Rows} tier-4 leaves reached the tree but the generated ` +
-        `maps declare ${expectedTier4} (${MODEL_LEAF_COUNT} models + ${PART_LEAF_COUNT} parts). ` +
-        `A parent id in the forest no longer matches a key in MODEL_LEAVES or PART_LEAVES — ` +
-        `re-run node scripts/gen-category-models.mjs and node scripts/gen-category-parts.mjs ` +
-        `and check the parent ids.`);
+        `maps declare ${expectedTier4} (${MODEL_LEAF_COUNT} models + ${PART_LEAF_COUNT} parts).\n` +
+        `  ${missing.length} declared leaf/leaves did not arrive as tier 4, by parent:\n` +
+        `${detail}\n` +
+        `  A parent at the wrong DEPTH puts its leaves at the wrong tier (a leaf is ` +
+        `always parentDepth+1); a parent id the forest renamed makes them absent ` +
+        `entirely. Fix the forest, then re-run node scripts/gen-category-models.mjs ` +
+        `and node scripts/gen-category-parts.mjs.`);
 }
 if (brandRows.length !== BRAND_ROW_COUNT) {
     throw new Error(`category seed: ${brandRows.length} brand rows built, expected ${BRAND_ROW_COUNT}`);

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

@@ -1023,14 +1023,14 @@ const faqSeedRecords = [
     {
         id: "faq-notification-preferences",
         question: "How do I manage my notifications?",
-        answer: html(`<p>Go to Account → Settings → Notification Preferences. You can toggle each notification type (order updates, auction alerts, price drops, community events) per channel — in-app, email, and WhatsApp. High-priority notifications (order shipped, auction won) are always sent in-app and cannot be fully disabled.</p>`),
+        answer: html(`<p>Go to Account → Settings → Notification Preferences. You can toggle each notification type (order updates, auction alerts, price drops, community events) per channel — in-app and email. High-priority notifications (order shipped, auction won) are always sent in-app and cannot be fully disabled.</p>`),
         category: "account_security",
         showOnHomepage: false,
         showInFooter: false,
         isPinned: false,
         order: 51,
         priority: 5,
-        tags: ["notifications", "settings", "preferences", "whatsapp", "email"],
+        tags: ["notifications", "settings", "preferences", "email"],
         relatedFAQs: [],
         stats: makeStats(700, 35),
         seo: { slug: "faq-notification-preferences", metaTitle: "Notification Preferences", metaDescription: "Manage your notification preferences on LetItRip." },