@mohasinac/appkit 4.52.5 → 4.53.1

package/dist/seed/homepage-sections-seed-data.js

@@ -1,12 +1,39 @@
 /*
  * WHY: Seeds the homepage layout — which sections render, in what order, with what copy.
- * WHAT: 22 sections (21 enabled + 1 deliberately disabled), ordered 1..21 contiguously.
+ * WHAT: 24 sections (23 enabled + 1 deliberately disabled), ordered 1..24 contiguously.
+ * `google-reviews` is a REGISTERED type with no document — see the note
+ * beside the deliberate budget-tile omission below for why. Three more joined
+ * it 2026-10-19 (`how-it-works`/`testimonials`/`promo-grid`, promoted out of
+ * the orphan-component set into real `SectionType`s + `SECTION_REGISTRY`
+ * entries) — deliberately left unseeded too: each is now available in the
+ * admin section builder's create picker, so an admin can add one when there is
+ * real copy to put in it, rather than this file inventing placeholder "How It
+ * Works" steps or testimonials nobody actually said.
+ *
+ * 🛑 That count and range are ASSERTED, not described — `order` must stay unique
+ * and contiguous. Until 2026-10-19 this header read "22 sections … 1..21" while
+ * the file held 23 documents numbered 1..22, and `section-systems-matrix` and
+ * `section-featured-products` BOTH claimed `order: 5`. `MarketplaceHomepageView`
+ * tie-breaks on `updatedAt` (identical for both) and then `id.localeCompare`, so
+ * the live running order of the homepage was decided alphabetically — a silent
+ * accident, not a layout decision. The 24th document (`collection-cards`,
+ * added the same day) closed the other half of that finding: a registered
+ * section type with a renderer and zero seeded rows is the same class of gap,
+ * just silent rather than colliding.
  *
  * ORDER follows current marketplace-homepage research rather than the previous
- * arbitrary arrangement: hero → trust → orient (categories) → shop (products,
- * auctions, pre-orders, bundles) → supply (stores) → social proof (reviews) →
- * engage (events, raffles, prize draws) → editorial (blog) → convert (seller
- * banner, newsletter) → reassure (stats, security, community, FAQ, brands).
+ * arbitrary arrangement: hero → trust → orient (categories, systems matrix) →
+ * shop (products, auctions, pre-orders, bundles) → supply (stores) → social
+ * proof (reviews) → engage (events, raffles, prize draws) → editorial (blog) →
+ * convert (seller banner, newsletter) → reassure (stats, security, community,
+ * FAQ, brands).
+ *
+ * The systems matrix sits at 5, between the generation tiles and the first
+ * product rail, because that is where the measured leader puts it: on
+ * worldhobbyshop "Browse Beyblade Systems & Series" (25 text links) follows
+ * "Shop Beyblades by Generation" (6 image tiles) and precedes the one product
+ * rail — taxonomy routing before merchandising. See
+ * docs/research/competitor-crawl-2026-10/layout.md.
  *
  * Baymard's finding drives the top: a static hero outperforms a carousel, and
  * the one documented carousel win came from demoting it BELOW a static hero.
@@ -130,7 +157,14 @@ export const homepageSectionsSeedData = [
         enabled: true,
         config: {
             title: "Shop by Category",
-            maxCategories: 8,
+            /*
+             * 6, from the `categories-generation-tiles` SECTION_TEMPLATE — and 6 is a
+             * measured number, not a round one: worldhobbyshop's "Shop Beyblades by
+             * Generation" is exactly six tiles (Beyblade X, Burst, Metal, Plastic
+             * Generation, Launchers & Grips, Stadiums & Arenas), 3 columns at 1280 and
+             * 1 at 390. See docs/research/competitor-crawl-2026-10/layout.md.
+             */
+            maxCategories: 6,
             viewMoreLabel: "All categories →",
             autoScroll: false,
             scrollInterval: 5000,
@@ -145,12 +179,25 @@ export const homepageSectionsSeedData = [
     {
         id: "section-featured-products",
         type: "products",
-        order: 5,
+        order: 6,
         enabled: true,
         config: {
             title: "Featured Products",
             subtitle: "Hand-picked listings from verified sellers.",
-            maxItems: 12,
+            /*
+             * 8, from the `products-recently-added` SECTION_TEMPLATE, which took it
+             * from worldhobbyshop's one product rail — measured 2026-10-19 at exactly
+             * 8 cards, 4 columns (docs/research/competitor-crawl-2026-10/layout.md).
+             * The SEO leader ships the fewest products on its homepage; its advantage
+             * is taxonomy routing, not merchandising volume.
+             *
+             * Safe against the `<= 12` rule above: SSR still supplies 12 via
+             * getFeatured*(12) and this renders 8 of them, so it can never under-fill.
+             * The 4-row over-fetch is deliberate — `getFeaturedProducts(12)` is shared
+             * with the auctions and pre-orders rails, so narrowing it to match would
+             * couple three sections' counts to one fetch.
+             */
+            maxItems: 8,
             viewMoreLabel: "View all products →",
             rows: 1,
             autoScroll: false,
@@ -163,7 +210,7 @@ export const homepageSectionsSeedData = [
     {
         id: "section-live-auctions",
         type: "auctions",
-        order: 6,
+        order: 7,
         enabled: true,
         config: {
             title: "Live Auctions",
@@ -181,7 +228,7 @@ export const homepageSectionsSeedData = [
     {
         id: "section-pre-orders",
         type: "pre-orders",
-        order: 7,
+        order: 8,
         enabled: true,
         config: {
             title: "Reserve Before It Ships",
@@ -199,7 +246,7 @@ export const homepageSectionsSeedData = [
     {
         id: "section-featured-bundles",
         type: "featured-bundles",
-        order: 8,
+        order: 9,
         enabled: true,
         config: {
             title: "Curated Bundles",
@@ -215,7 +262,7 @@ export const homepageSectionsSeedData = [
     {
         id: "section-featured-stores",
         type: "stores",
-        order: 9,
+        order: 10,
         enabled: true,
         config: {
             title: "Featured Stores",
@@ -233,7 +280,7 @@ export const homepageSectionsSeedData = [
     {
         id: "section-collector-reviews",
         type: "reviews",
-        order: 10,
+        order: 11,
         enabled: true,
         config: {
             title: "What Buyers Say",
@@ -252,7 +299,7 @@ export const homepageSectionsSeedData = [
     {
         id: "section-upcoming-events",
         type: "events",
-        order: 11,
+        order: 12,
         enabled: true,
         config: {
             title: "Events & Offers",
@@ -269,7 +316,7 @@ export const homepageSectionsSeedData = [
     {
         id: "section-event-raffles",
         type: "event-raffles",
-        order: 12,
+        order: 13,
         enabled: true,
         config: {
             title: "Raffles & Spin Wheels",
@@ -285,7 +332,7 @@ export const homepageSectionsSeedData = [
     {
         id: "section-prize-draws",
         type: "prize-draws",
-        order: 13,
+        order: 14,
         enabled: true,
         config: {
             title: "Prize Draws",
@@ -304,11 +351,14 @@ export const homepageSectionsSeedData = [
     {
         id: "section-collector-blog",
         type: "blog-articles",
-        order: 14,
+        order: 15,
         enabled: true,
         config: {
             title: "From Our Blog",
-            maxArticles: 6,
+            // 4, from the `blog-four-excerpts` SECTION_TEMPLATE (beybladeartshop ships
+            // four article excerpts). Safe against the SSR fetch, which supplies 6 via
+            // getFeaturedBlogPosts(6) — this renders 4 of them.
+            maxArticles: 4,
             viewMoreLabel: "View all posts →",
             showReadTime: true,
             showAuthor: true,
@@ -324,7 +374,7 @@ export const homepageSectionsSeedData = [
     {
         id: "section-beyblade-banner",
         type: "banner",
-        order: 15,
+        order: 16,
         enabled: true,
         config: {
             height: "md",
@@ -348,7 +398,7 @@ export const homepageSectionsSeedData = [
     {
         id: "section-newsletter",
         type: "newsletter",
-        order: 16,
+        order: 17,
         enabled: true,
         config: {
             title: "Get new listings first",
@@ -366,7 +416,7 @@ export const homepageSectionsSeedData = [
     {
         id: "section-platform-stats",
         type: "stats",
-        order: 17,
+        order: 18,
         enabled: true,
         config: {
             title: "By the numbers",
@@ -383,7 +433,7 @@ export const homepageSectionsSeedData = [
     {
         id: "section-platform-features",
         type: "features",
-        order: 18,
+        order: 19,
         enabled: true,
         config: {
             title: "Security You Can Trust",
@@ -419,7 +469,7 @@ export const homepageSectionsSeedData = [
     {
         id: "section-whatsapp-community",
         type: "whatsapp-community",
-        order: 19,
+        order: 20,
         enabled: true,
         config: {
             title: "Join the community",
@@ -440,7 +490,7 @@ export const homepageSectionsSeedData = [
     {
         id: "section-homepage-faq",
         type: "faq",
-        order: 20,
+        order: 21,
         enabled: true,
         config: {
             title: "Frequently Asked Questions",
@@ -509,7 +559,7 @@ export const homepageSectionsSeedData = [
     {
         id: "section-top-brands",
         type: "brands",
-        order: 21,
+        order: 22,
         enabled: true,
         config: {
             title: "Top Brands",
@@ -530,7 +580,7 @@ export const homepageSectionsSeedData = [
     {
         id: "section-social-feed-instagram",
         type: "social-feed",
-        order: 22,
+        order: 23,
         enabled: false,
         config: {
             title: "Follow along",
@@ -660,6 +710,61 @@ export const homepageSectionsSeedData = [
         createdAt: daysAgo(1),
         updatedAt: daysAgo(1),
     },
+    /*
+     * `collection-cards` had a renderer and a builder with zero seeded rows — a
+     * type nobody ever saw, structurally identical to 22 missing-order or
+     * mis-ordered sections elsewhere in this file: a gap only a human reading
+     * the schema would ever notice.
+     *
+     * 🛑 Deliberately scoped to `categories` / `brands` / `stores` — the three
+     * axes that are PERMANENT regardless of product count. Even if every one of
+     * the 1,237 generated catalogue products were deleted, these three entry
+     * types would still resolve to real, populated rows: 1,185 categories, 28
+     * brand rows, 5 stores, all seeded independently of the product catalogue.
+     * A `"products"` or `"auctions"` entry here would be the opposite — a card
+     * that goes empty the moment the catalogue does, on a section whose entire
+     * point is to always have something to show.
+     */
+    {
+        id: "section-top-collections",
+        type: "collection-cards",
+        order: 24,
+        enabled: true,
+        config: {
+            title: "Explore the Marketplace",
+            subtitle: "Three ways into the catalogue that never go empty.",
+            layout: "grid",
+            itemsPerRow: 3,
+            showCollectionTabs: false,
+            collections: [
+                { type: "categories", label: "Shop by Generation", limit: 6 },
+                { type: "brands", label: "Shop by Brand", limit: 8 },
+                { type: "stores", label: "Verified Sellers", limit: 5 },
+            ],
+            cta: { label: "View all categories →", href: String(ROUTES.PUBLIC.CATEGORIES), variant: "text" },
+        },
+        createdAt: daysAgo(1),
+        updatedAt: daysAgo(1),
+    },
+    /*
+     * 🛑 `google-reviews` stays DELIBERATELY UNSEEDED — not an oversight, the
+     * same decision already made for `googleMapsApiKey`/`googlePlaceId` in
+     * `site-settings-seed-data.ts`: those are seeded `""` on purpose, because
+     * their consumers (`GoogleReviewsSectionConfig.placeId` is this section's
+     * only REQUIRED field) read them directly and would treat a placeholder as
+     * a usable credential, producing a failed, possibly BILLED Google Places
+     * API call instead of skipping cleanly.
+     *
+     * Reviews pulled from this section are real third-party content keyed to a
+     * real Google Business Profile this project does not have. Fabricating a
+     * `placeId` would either hit Google's API with an invalid key (cost, for a
+     * call that can never succeed) or — worse — a VALID placeId for a real,
+     * unrelated business, rendering someone else's reviews as this store's own.
+     * Neither is a seed-data problem to paper over; it is a real business
+     * prerequisite (a Google Business Profile must exist) that has not happened
+     * yet. The type stays in `SectionType` and `SECTION_REGISTRY` — it is a real
+     * feature with zero fabricated data, not a bug.
+     */
     /*
      * 🛑 TCI's five BUDGET TILES ("Under ₹499 / ₹799 / ₹999 / ₹1499") are
      * DELIBERATELY NOT SEEDED, and this is a decision rather than an omission.

package/dist/seed/index.d.ts

@@ -19,8 +19,6 @@ export type { SeedCategoryDocument } from "./factories/category.factory";
 export { makeCategory } from "./factories/category.factory";
 export type { SeedCarouselSlideDocument } from "./factories/carousel.factory";
 export { makeCarouselSlide } from "./factories/carousel.factory";
-export type { SeedHomepageSectionDocument, HomepageSectionType, } from "./factories/homepage-section.factory";
-export { makeHomepageSection } from "./factories/homepage-section.factory";
 export type { SeedAddressDocument } from "./factories/address.factory";
 export { makeAddress, makeFullAddress, ADDRESS_FIXTURES, } from "./factories/address.factory";
 export type { SeedCartDocument, SeedCartItemDocument, } from "./factories/cart.factory";
@@ -37,7 +35,6 @@ export type { SeedPayoutDocument, PayoutStatus, } from "./factories/payout.facto
 export { makePayout, makeFullPayout, PAYOUT_FIXTURES, } from "./factories/payout.factory";
 export { DEFAULT_CATEGORIES } from "./defaults/categories";
 export { DEFAULT_FAQS } from "./defaults/faqs";
-export { DEFAULT_HOMEPAGE_SECTIONS } from "./defaults/homepage-sections";
 export { usersSeedData } from "./users-seed-data";
 export { sessionsSeedData, SESSION_COLLECTION } from "./sessions-seed-data";
 export { addressesSeedData } from "./addresses-seed-data";
@@ -45,6 +42,7 @@ export { storesSeedData } from "./stores-seed-data";
 export { storeAddressesSeedData } from "./store-addresses-seed-data";
 export { categoriesSeedData, categoriesP1SeedData } from "./categories-seed-data";
 export { productsStandardSeedData } from "./products-standard-seed-data";
+export { productsBeybladeXSeedData } from "./products-beyblade-x-seed-data";
 export { productsAuctionsSeedData } from "./products-auctions-seed-data";
 export { productsPreordersSeedData } from "./products-preorders-seed-data";
 export { productsPrizeDrawsSeedData } from "./products-prize-draws-seed-data";
@@ -53,6 +51,7 @@ export { productsDigitalCodesSeedData } from "./products-digital-codes-seed-data
 export { productsLiveItemsSeedData } from "./products-live-items-seed-data";
 export { productsArtSeedData } from "./products-art-seed-data";
 export { productsStickersSeedData } from "./products-stickers-seed-data";
+export { productsSparesSeedData } from "./products-spares-seed-data";
 export { ordersSeedData } from "./orders-seed-data";
 export { reviewsSeedData } from "./reviews-seed-data";
 export { cartsSeedData } from "./cart-seed-data";
@@ -84,6 +83,7 @@ export { scammersSeedData } from "./scammers-seed-data";
 export { supportTicketsSeedData } from "./support-tickets-seed-data";
 export { testerChecklistSeedData, testerResponsesSeedData, } from "../features/tester/seed-data";
 export { productFeaturesSeedData } from "./product-features-seed-data";
+export { authenticityKnowledgeSeedData, AUTHENTICITY_KNOWLEDGE_COLLECTION, AUTHENTICITY_KNOWLEDGE_COUNT, } from "./authenticity-knowledge-seed-data";
 export { taxCodesSeedData } from "./tax-codes-seed-data";
 export { offersSeedData } from "./offers-seed-data";
 export { payoutMethodsSeedData, shippingConfigsSeedData, analyticsCardsSeedData, analyticsAlertsSeedData, storeCategoriesSeedData, listingTemplatesSeedData, moderationQueueSeedData, reportsSeedData, itemRequestsSeedData, storeWhatsAppConfigSeedData, storeGoogleConfigSeedData, } from "./store-extensions-seed-data";

package/dist/seed/index.js

@@ -14,7 +14,6 @@ export { makeBlogPost } from "./factories/blog-post.factory.js";
 export { makeFaq } from "./factories/faq.factory.js";
 export { makeCategory } from "./factories/category.factory.js";
 export { makeCarouselSlide } from "./factories/carousel.factory.js";
-export { makeHomepageSection } from "./factories/homepage-section.factory.js";
 export { makeAddress, makeFullAddress, ADDRESS_FIXTURES, } from "./factories/address.factory.js";
 export { makeCart, makeCartItem, makeFullCart, CART_FIXTURES, } from "./factories/cart.factory.js";
 export { makeBid, makeWinningBid, BID_FIXTURES } from "./factories/bid.factory.js";
@@ -25,7 +24,6 @@ export { makePayout, makeFullPayout, PAYOUT_FIXTURES, } from "./factories/payout
 // Defaults
 export { DEFAULT_CATEGORIES } from "./defaults/categories.js";
 export { DEFAULT_FAQS } from "./defaults/faqs.js";
-export { DEFAULT_HOMEPAGE_SECTIONS } from "./defaults/homepage-sections.js";
 // Migrated seed datasets from consumer repositories
 // SB-UNI-C — brandsSeedData merged into categoriesSeedData with categoryType:"brand".
 export { usersSeedData } from "./users-seed-data.js";
@@ -35,6 +33,7 @@ export { storesSeedData } from "./stores-seed-data.js";
 export { storeAddressesSeedData } from "./store-addresses-seed-data.js";
 export { categoriesSeedData, categoriesP1SeedData } from "./categories-seed-data.js";
 export { productsStandardSeedData } from "./products-standard-seed-data.js";
+export { productsBeybladeXSeedData } from "./products-beyblade-x-seed-data.js";
 /*
  * 🛑 `productsCatalogueSeedData` DELETED (I6, 2026-10-13) — 968 generated
  * listings, one per tier-4 leaf. "I do not need products ... rest is either
@@ -53,6 +52,7 @@ export { productsDigitalCodesSeedData } from "./products-digital-codes-seed-data
 export { productsLiveItemsSeedData } from "./products-live-items-seed-data.js";
 export { productsArtSeedData } from "./products-art-seed-data.js";
 export { productsStickersSeedData } from "./products-stickers-seed-data.js";
+export { productsSparesSeedData } from "./products-spares-seed-data.js";
 export { ordersSeedData } from "./orders-seed-data.js";
 export { reviewsSeedData } from "./reviews-seed-data.js";
 export { cartsSeedData } from "./cart-seed-data.js";
@@ -91,6 +91,7 @@ export { testerChecklistSeedData,
 // continues, which is exactly what happened on the first attempt here.
 testerResponsesSeedData, } from "../features/tester/seed-data/index.js";
 export { productFeaturesSeedData } from "./product-features-seed-data.js";
+export { authenticityKnowledgeSeedData, AUTHENTICITY_KNOWLEDGE_COLLECTION, AUTHENTICITY_KNOWLEDGE_COUNT, } from "./authenticity-knowledge-seed-data.js";
 export { taxCodesSeedData } from "./tax-codes-seed-data.js";
 export { offersSeedData } from "./offers-seed-data.js";
 // S-STORE Extensions (Tier S-STORE) — 11 new collections

package/dist/seed/lottery-entries-seed-data.d.ts

@@ -1,2 +1,2 @@
-import type { LotteryEntryDocument } from "../features/lottery/schemas/firestore";
-export declare const lotteryEntriesSeedData: LotteryEntryDocument[];
+import type { LotteryEntryPlain } from "../features/lottery/schemas/firestore";
+export declare const lotteryEntriesSeedData: LotteryEntryPlain[];

package/dist/seed/manifest.js

@@ -19,6 +19,7 @@ import { productsDigitalCodesSeedData } from "./products-digital-codes-seed-data
 import { productsLiveItemsSeedData } from "./products-live-items-seed-data.js";
 import { productsArtSeedData } from "./products-art-seed-data.js";
 import { productsStickersSeedData } from "./products-stickers-seed-data.js";
+import { productsSparesSeedData } from "./products-spares-seed-data.js";
 import { ordersSeedData } from "./orders-seed-data.js";
 import { reviewsSeedData } from "./reviews-seed-data.js";
 import { bidsSeedData } from "./bids-seed-data.js";
@@ -68,6 +69,7 @@ function pick(items, nameKey = "name") {
 // "bundle" is a categoryType, not a ListingType — falls through to "bundle" below.
 const LISTING_TYPE_TO_MANIFEST_TAG = {
     standard: "standard",
+    spares: "spares",
     auction: "auction",
     "pre-order": "preorder",
     "prize-draw": "prize-draw",
@@ -97,6 +99,7 @@ export const SEED_MANIFEST = {
         ...asArr(productsLiveItemsSeedData),
         ...asArr(productsArtSeedData),
         ...asArr(productsStickersSeedData),
+        ...asArr(productsSparesSeedData),
     ].map((p) => ({
         ...p,
         type: p.listingType === "bundle"

package/dist/seed/media-assets-seed-data.d.ts

@@ -19,4 +19,4 @@
  */
 import type { MediaAssetDocument } from "../features/media/repository/media-assets.repository";
 export declare const mediaAssetsSeedData: Partial<MediaAssetDocument>[];
-export declare const MEDIA_ASSET_SEED_COUNT = 504;
+export declare const MEDIA_ASSET_SEED_COUNT = 559;