@mohasinac/appkit 4.1.0 → 4.1.1

package/dist/features/tester/seed-data/products-tester-seed-data.js

@@ -21,6 +21,10 @@ import { seedExtMedia } from "../../../seed/_helpers/media";
 import { testDataExpiresAt } from "./tester-ttl";
 const TESTER_STORE_ID = "store-tester-sandbox";
 const TESTER_STORE_NAME = "Tester Sandbox Store";
+const GADGETS_CATEGORY_SLUGS = ["category-tester-gadgets", "category-tester-sandbox"];
+const GADGETS_CATEGORY_NAMES = ["Test Gadgets", "Tester Sandbox"];
+const COLLECTIBLES_CATEGORY_SLUGS = ["category-tester-collectibles", "category-tester-sandbox"];
+const COLLECTIBLES_CATEGORY_NAMES = ["Test Collectibles", "Tester Sandbox"];
 function withTokens(p) {
     return {
         tags: [],
@@ -39,8 +43,8 @@ export const productsTesterSeedData = [
         slug: "product-tester-standard-1",
         title: "Test Gadget — Standard Listing #1",
         description: "Disposable test product for the tester QA program. Buy it, review it, wishlist it — it auto-expires in 7 days.",
-        categorySlugs: ["category-tester-gadgets", "category-tester-sandbox"],
-        categoryNames: ["Test Gadgets", "Tester Sandbox"],
+        categorySlugs: GADGETS_CATEGORY_SLUGS,
+        categoryNames: GADGETS_CATEGORY_NAMES,
         brandSlug: "brand-tester-sandbox",
         brand: "TestBrand",
         price: 199,
@@ -65,8 +69,8 @@ export const productsTesterSeedData = [
         slug: "product-tester-standard-2",
         title: "Test Collectible — Standard Listing #2",
         description: "Second disposable test product, referenced by the test bundle. Auto-expires in 7 days.",
-        categorySlugs: ["category-tester-collectibles", "category-tester-sandbox"],
-        categoryNames: ["Test Collectibles", "Tester Sandbox"],
+        categorySlugs: COLLECTIBLES_CATEGORY_SLUGS,
+        categoryNames: COLLECTIBLES_CATEGORY_NAMES,
         brandSlug: "brand-tester-sandbox",
         brand: "TestBrand",
         price: 149,
@@ -91,8 +95,8 @@ export const productsTesterSeedData = [
         slug: "auction-tester-sandbox-1",
         title: "Test Auction — Bid Me!",
         description: "Disposable test auction for the tester QA program. Place a bid — it auto-expires in 7 days, cascading to any bids.",
-        categorySlugs: ["category-tester-collectibles", "category-tester-sandbox"],
-        categoryNames: ["Test Collectibles", "Tester Sandbox"],
+        categorySlugs: COLLECTIBLES_CATEGORY_SLUGS,
+        categoryNames: COLLECTIBLES_CATEGORY_NAMES,
         brandSlug: "brand-tester-sandbox",
         brand: "TestBrand",
         startingBid: 15000,
@@ -117,13 +121,45 @@ export const productsTesterSeedData = [
         createdAt: new Date(),
         updatedAt: new Date(),
     }),
+    withTokens({
+        id: "auction-tester-sandbox-won",
+        slug: "auction-tester-sandbox-won",
+        title: "Test Auction — Already Won",
+        description: "Disposable test auction, already ended and won, paired with a \"won auction\" test order. Auto-expires in 7 days, cascading to its bid.",
+        categorySlugs: COLLECTIBLES_CATEGORY_SLUGS,
+        categoryNames: COLLECTIBLES_CATEGORY_NAMES,
+        brandSlug: "brand-tester-sandbox",
+        brand: "TestBrand",
+        startingBid: 8000,
+        currentBid: 15000,
+        currency: "INR",
+        price: 150,
+        stockQuantity: 1,
+        availableQuantity: 0,
+        auctionEndDate: new Date(Date.now() - 1 * 24 * 60 * 60 * 1000),
+        bidCount: 1,
+        bidsHaveStarted: true,
+        leadingBidderId: "user-tester-qa",
+        isSold: true,
+        mainImage: seedExtMedia("https://picsum.photos/seed/auction-image-tester-sandbox-won-20260101/900/900"),
+        images: [seedExtMedia("https://picsum.photos/seed/auction-image-tester-sandbox-won-20260101/900/900")],
+        status: PRODUCT_FIELDS.STATUS_VALUES.PUBLISHED,
+        condition: PRODUCT_FIELDS.CONDITION_VALUES.NEW,
+        listingType: "auction",
+        customFields: [],
+        customSections: [],
+        isPromoted: false,
+        isOnSale: false,
+        createdAt: new Date(),
+        updatedAt: new Date(),
+    }),
     withTokens({
         id: "preorder-tester-sandbox-1",
         slug: "preorder-tester-sandbox-1",
         title: "Test Pre-order — Reserve Me!",
         description: "Disposable test pre-order for the tester QA program. Auto-expires in 7 days.",
-        categorySlugs: ["category-tester-gadgets", "category-tester-sandbox"],
-        categoryNames: ["Test Gadgets", "Tester Sandbox"],
+        categorySlugs: GADGETS_CATEGORY_SLUGS,
+        categoryNames: GADGETS_CATEGORY_NAMES,
         brandSlug: "brand-tester-sandbox",
         brand: "TestBrand",
         price: 299,
@@ -148,4 +184,173 @@ export const productsTesterSeedData = [
         createdAt: new Date(),
         updatedAt: new Date(),
     }),
+    withTokens({
+        id: "prizedraw-tester-sandbox-1",
+        slug: "prizedraw-tester-sandbox-1",
+        title: "Test Prize Draw — Reveal Me!",
+        description: "Disposable test prize-draw for the tester QA program. Buy an entry, then reveal — auto-expires in 7 days.",
+        categorySlugs: COLLECTIBLES_CATEGORY_SLUGS,
+        categoryNames: COLLECTIBLES_CATEGORY_NAMES,
+        brandSlug: "brand-tester-sandbox",
+        brand: "TestBrand",
+        price: 50,
+        currency: "INR",
+        condition: PRODUCT_FIELDS.CONDITION_VALUES.NEW,
+        status: PRODUCT_FIELDS.STATUS_VALUES.PUBLISHED,
+        listingType: "prize-draw",
+        images: [seedExtMedia("https://picsum.photos/seed/prizedraw-image-tester-sandbox-1-20260101/900/900")],
+        mainImage: seedExtMedia("https://picsum.photos/seed/prizedraw-image-tester-sandbox-1-20260101/900/900"),
+        isSold: false,
+        stockQuantity: 3,
+        availableQuantity: 3,
+        customFields: [],
+        customSections: [],
+        isPromoted: false,
+        isOnSale: false,
+        prizeDrawMode: "reveal",
+        pricePerEntry: 50,
+        prizeMaxEntries: 3,
+        prizeCurrentEntries: 0,
+        prizeRevealWindowStart: new Date(),
+        prizeRevealWindowEnd: new Date(Date.now() + 7 * 24 * 60 * 60 * 1000),
+        prizeRevealStatus: "open",
+        prizeRevealDeadlineDays: 7,
+        prizeDrawItems: [
+            { itemNumber: 1, title: "Test Prize — Grand", description: "Disposable test grand prize.", images: [seedExtMedia("https://picsum.photos/seed/prizedraw-item-1-20260101/600/600")], condition: "new", estimatedValue: 500, isWon: false },
+            { itemNumber: 2, title: "Test Prize — Runner-up", description: "Disposable test runner-up prize.", images: [seedExtMedia("https://picsum.photos/seed/prizedraw-item-2-20260101/600/600")], condition: "new", estimatedValue: 150, isWon: false },
+            { itemNumber: 3, title: "Test Prize — Consolation", description: "Disposable test consolation prize.", images: [seedExtMedia("https://picsum.photos/seed/prizedraw-item-3-20260101/600/600")], condition: "new", estimatedValue: 20, isWon: false },
+        ],
+        createdAt: new Date(),
+        updatedAt: new Date(),
+    }),
+    withTokens({
+        id: "classified-tester-sandbox-1",
+        slug: "classified-tester-sandbox-1",
+        title: "Test Classified — Contact Me!",
+        description: "Disposable test classified listing for the tester QA program. No checkout — contact the seller. Auto-expires in 7 days.",
+        categorySlugs: COLLECTIBLES_CATEGORY_SLUGS,
+        categoryNames: COLLECTIBLES_CATEGORY_NAMES,
+        brandSlug: "brand-tester-sandbox",
+        brand: "TestBrand",
+        price: 250,
+        currency: "INR",
+        condition: PRODUCT_FIELDS.CONDITION_VALUES.GOOD,
+        status: PRODUCT_FIELDS.STATUS_VALUES.PUBLISHED,
+        listingType: "classified",
+        images: [seedExtMedia("https://picsum.photos/seed/classified-image-tester-sandbox-1-20260101/900/900")],
+        mainImage: seedExtMedia("https://picsum.photos/seed/classified-image-tester-sandbox-1-20260101/900/900"),
+        isSold: false,
+        stockQuantity: 1,
+        availableQuantity: 1,
+        customFields: [],
+        customSections: [],
+        isPromoted: false,
+        isOnSale: false,
+        classified: {
+            meetupArea: { city: "Bengaluru", locality: "Test Locality", pincode: "560001" },
+            contactMethod: "both",
+            acceptsShipping: false,
+            negotiable: true,
+        },
+        createdAt: new Date(),
+        updatedAt: new Date(),
+    }),
+    withTokens({
+        id: "digitalcode-tester-sandbox-1",
+        slug: "digitalcode-tester-sandbox-1",
+        title: "Test Digital Code — Auto-Claim!",
+        description: "Disposable test digital-code listing for the tester QA program. Auto-expires in 7 days.",
+        categorySlugs: GADGETS_CATEGORY_SLUGS,
+        categoryNames: GADGETS_CATEGORY_NAMES,
+        brandSlug: "brand-tester-sandbox",
+        brand: "TestBrand",
+        price: 99,
+        currency: "INR",
+        condition: PRODUCT_FIELDS.CONDITION_VALUES.NEW,
+        status: PRODUCT_FIELDS.STATUS_VALUES.PUBLISHED,
+        listingType: "digital-code",
+        images: [seedExtMedia("https://picsum.photos/seed/digitalcode-image-tester-sandbox-1-20260101/900/900")],
+        mainImage: seedExtMedia("https://picsum.photos/seed/digitalcode-image-tester-sandbox-1-20260101/900/900"),
+        isSold: false,
+        stockQuantity: 10,
+        availableQuantity: 10,
+        customFields: [],
+        customSections: [],
+        isPromoted: false,
+        isOnSale: false,
+        digitalCode: {
+            codeDeliveryMethod: "auto-claim",
+            codePoolSize: 10,
+            codesAvailable: 10,
+            redemptionInstructions: "Disposable test code — redeem at test-redeem.example for tester QA purposes only.",
+        },
+        createdAt: new Date(),
+        updatedAt: new Date(),
+    }),
+    withTokens({
+        id: "live-tester-sandbox-1",
+        slug: "live-tester-sandbox-1",
+        title: "Test Live Item — Watch Me!",
+        description: "Disposable test live-item listing for the tester QA program. Auto-expires in 7 days.",
+        categorySlugs: COLLECTIBLES_CATEGORY_SLUGS,
+        categoryNames: COLLECTIBLES_CATEGORY_NAMES,
+        brandSlug: "brand-tester-sandbox",
+        brand: "TestBrand",
+        price: 1500,
+        currency: "INR",
+        condition: PRODUCT_FIELDS.CONDITION_VALUES.NEW,
+        status: PRODUCT_FIELDS.STATUS_VALUES.PUBLISHED,
+        listingType: "live",
+        images: [seedExtMedia("https://picsum.photos/seed/live-image-tester-sandbox-1-20260101/900/900")],
+        mainImage: seedExtMedia("https://picsum.photos/seed/live-image-tester-sandbox-1-20260101/900/900"),
+        video: { url: "https://www.youtube.com/watch?v=dQw4w9WgXcQ" },
+        isSold: false,
+        stockQuantity: 1,
+        availableQuantity: 1,
+        customFields: [],
+        customSections: [],
+        isPromoted: false,
+        isOnSale: false,
+        liveItem: {
+            species: "Test Species",
+            ageMonths: 6,
+            sex: "n/a",
+            careInfo: "Disposable test care info for the tester QA program.",
+            transport: { method: "courier", handlingFee: 100, insuranceIncluded: true },
+            jurisdictionAllowed: ["IN-KA", "IN-MH"],
+            vendorVerified: true,
+        },
+        createdAt: new Date(),
+        updatedAt: new Date(),
+    }),
+    withTokens({
+        id: "group-tester-sandbox-bundle",
+        slug: "group-tester-sandbox-bundle",
+        title: "Test Bundle — Standard #1 + Standard #2",
+        description: "Disposable test bundle bundling the two tester-sandbox standard products. Auto-expires in 7 days.",
+        categorySlugs: GADGETS_CATEGORY_SLUGS,
+        categoryNames: GADGETS_CATEGORY_NAMES,
+        brandSlug: "brand-tester-sandbox",
+        brand: "TestBrand",
+        price: 329,
+        currency: "INR",
+        condition: PRODUCT_FIELDS.CONDITION_VALUES.NEW,
+        status: PRODUCT_FIELDS.STATUS_VALUES.PUBLISHED,
+        listingType: "standard",
+        images: [seedExtMedia("https://picsum.photos/seed/product-image-tester-standard-1-20260101/900/900")],
+        mainImage: seedExtMedia("https://picsum.photos/seed/product-image-tester-standard-1-20260101/900/900"),
+        isSold: false,
+        stockQuantity: 5,
+        availableQuantity: 5,
+        customFields: [],
+        customSections: [],
+        isPromoted: false,
+        isOnSale: false,
+        isGroupParent: true,
+        groupId: "group-tester-sandbox-bundle",
+        groupTitle: "Tester Sandbox Bundle",
+        groupChildSlugs: ["product-tester-standard-1", "product-tester-standard-2"],
+        createdAt: new Date(),
+        updatedAt: new Date(),
+    }),
 ];

package/dist/features/tester/seed-data/tester-checklist-seed-data.js

@@ -1,9 +1,11 @@
 /*
  * WHY: Seeds the initial tester QA checklist catalog — DB-backed, admin-manageable (mirrors faq-seed-data.ts).
- * WHAT: ~65 default test cases across 6 groups (Account & Auth, Buying, Selling, Content & Discovery,
- *       Community & Support, Design & UX). Admins add/edit further cases via /admin/tester-checklist —
- *       this array is a starting point, not the source of truth. Every case is searchable by title or
- *       route in the Tester Hub (/user/tester), which any isTester account OR admin can open.
+ * WHAT: Default test cases across 8 groups (Account & Auth, Buying, Selling, Content & Discovery,
+ *       Community & Support, Design & UX, Public & Marketing Pages, Admin (Testing)). Admins add/edit
+ *       further cases via /admin/tester-checklist — this array is a starting point, not the source of
+ *       truth. Every case is searchable by title or route in the Tester Hub (/user/tester), which any
+ *       isTester account OR admin can open. Items in the "admin" group carry adminOnly:true — only
+ *       visible to a tester with canTestAdmin (or a real admin); see `group()`'s `opts.adminOnly`.
  *
  * EXPORTS:
  *   testerChecklistSeedData — Array of Partial<TesterChecklistItemDocument> for seed runner
@@ -106,14 +108,29 @@ export const testerChecklistSeedData = [
             pageLabel: "Buying & Checkout",
             cases: [
                 { key: "add-to-cart", label: "Add to cart works from the product page" },
+                { key: "add-to-cart-out-of-stock", label: "Add to cart is disabled/blocked once a listing's stock reaches zero" },
+                { key: "add-to-cart-max-quantity", label: "Increasing quantity in the cart is capped at the listing's available stock, with a clear message" },
                 { key: "checkout-flow", label: "Checkout flow completes without errors", href: "/cart" },
+                { key: "checkout-order-review", label: "The order-review step before payment shows correct items, quantities, addresses, and totals" },
+                { key: "checkout-multi-seller-split", label: "A cart with items from multiple sellers correctly splits into separate orders at checkout" },
                 { key: "shipping-address", label: "Selecting/adding a shipping address works" },
+                { key: "shipping-address-inline-add", label: "Adding a new address inline during checkout (without leaving the flow) works and the new address is selectable immediately" },
+                { key: "shipping-address-edit", label: "Editing an existing shipping address from checkout works" },
+                { key: "shipping-method-selection", label: "Selecting a shipping method/provider at checkout recalculates the shipping fee correctly" },
+                { key: "gst-breakdown-display", label: "When GST is enabled in Site Settings, checkout shows the correct CGST/SGST or IGST breakdown based on buyer vs seller state" },
                 { key: "checkout-otp-highvalue", label: "Carts ≥ the OTP threshold prompt for email verification before placing the order (except COD)" },
+                { key: "payment-method-selection", label: "Choosing between COD, UPI/manual, and Razorpay (when enabled) at checkout works" },
                 { key: "payment-window-countdown", label: "Manual-payment orders show a 15-minute countdown timer on the payment page" },
                 { key: "payment-proof-upload", label: "Uploading manual payment proof (screenshot, UTR, mark-as-paid + agreement checkboxes) works" },
+                { key: "payment-proof-reupload", label: "Requesting a proof re-upload extends the buyer's payment window and the buyer can successfully re-submit" },
                 { key: "payment-window-expiry", label: "An order whose 15-minute payment window expires with no proof auto-cancels and the item returns to stock" },
+                { key: "emi-checkout-flow", label: "Choosing EMI at checkout (when enabled) shows the correct tenure options, token amount, and surcharge, and creates the installment schedule" },
+                { key: "out-of-stock-policy-cancel", label: "With the \"cancel whole order\" out-of-stock policy, checkout correctly rejects the entire batch if any item goes out of stock mid-checkout" },
+                { key: "out-of-stock-policy-skip", label: "With the \"skip unavailable items\" policy, checkout proceeds with only the still-available items" },
                 { key: "order-confirmation", label: "Order confirmation page/email shows correct order details" },
                 { key: "payment-auto-approve-dispute", label: "An auto-approved order (2h, no admin review) shows the badge, and \"Raise a dispute\" submits successfully" },
+                { key: "checkout-mobile-responsive", label: "The full checkout flow (cart → address → payment → confirmation) is usable and correctly laid out on a mobile viewport" },
+                { key: "checkout-back-navigation", label: "Using the browser back button mid-checkout does not lose cart state or double-submit the order" },
             ],
         },
         {
@@ -130,9 +147,21 @@ export const testerChecklistSeedData = [
             pageKey: "wishlist-history",
             pageLabel: "Wishlist & History",
             cases: [
-                { key: "add-wishlist", label: "Adding a product to the wishlist works", href: "/user/wishlist" },
+                { key: "add-wishlist-pdp", label: "Adding a product to the wishlist from the product detail page works", href: "/user/wishlist" },
+                { key: "add-wishlist-card", label: "Adding a product to the wishlist from a listing card (checkbox/long-press) works on both listing and search pages" },
                 { key: "remove-wishlist", label: "Removing a product from the wishlist works" },
-                { key: "view-history", label: "Recently viewed history shows accurate items", href: "/user/history" },
+                { key: "wishlist-persists-guest-to-login", label: "Wishlist items added as a guest are preserved after logging in" },
+                { key: "wishlist-idempotent-readd", label: "Re-adding a product already on the wishlist is a no-op and doesn't create a duplicate entry" },
+                { key: "wishlist-cap-enforced", label: "Adding a 21st item to the wishlist is blocked with a clear \"wishlist full\" message (20-item cap)" },
+                { key: "wishlist-across-listing-types", label: "Auctions and pre-orders (not just standard products) can be added to and viewed correctly in the wishlist" },
+                { key: "wishlist-price-drop-accuracy", label: "A wishlist item's displayed price matches the product's current price, not a stale snapshot" },
+                { key: "wishlist-sold-out-item", label: "A wishlist item whose product later sells out or is removed still displays gracefully (no crash) with an appropriate indicator" },
+                { key: "wishlist-empty-state", label: "The empty-wishlist state renders correctly with no items", href: "/user/wishlist" },
+                { key: "wishlist-add-to-cart-from-list", label: "Adding a wishlist item directly to the cart from the wishlist page works" },
+                { key: "view-history", label: "Recently viewed history shows accurate items in most-recent-first order", href: "/user/history" },
+                { key: "history-revisit-reorders", label: "Re-visiting a product already in history removes the old entry and moves it to the front, rather than duplicating it" },
+                { key: "history-fifo-cap", label: "History silently evicts the oldest entry once more than 50 items have been viewed (no error shown to the user)" },
+                { key: "history-guest-merge-on-login", label: "Guest browsing history (localStorage) merges correctly with the account's history after login, deduplicated by product" },
             ],
         },
         {
@@ -141,7 +170,12 @@ export const testerChecklistSeedData = [
             cases: [
                 { key: "update-qty", label: "Updating item quantity in cart recalculates the total" },
                 { key: "apply-coupon", label: "Applying a coupon code at checkout works" },
+                { key: "remove-coupon", label: "Removing an already-applied coupon from the cart recalculates the total back down" },
                 { key: "remove-item", label: "Removing an item from the cart works" },
+                { key: "cart-empty-state", label: "The empty-cart state renders correctly with a clear call to action" },
+                { key: "cart-persists-across-session", label: "Cart contents persist across a page reload and across login/logout for the same account" },
+                { key: "cart-guest-to-login-merge", label: "A guest cart's items merge correctly into the account's cart after logging in" },
+                { key: "cart-price-revalidated", label: "If a product's price changes after it was added to the cart, checkout uses the current price and shows the buyer the updated total" },
             ],
         },
         {
@@ -177,6 +211,20 @@ export const testerChecklistSeedData = [
                 { key: "my-reviews", label: "\"My Reviews\" shows reviews the user has left", href: "/user/reviews" },
             ],
         },
+        {
+            pageKey: "user-dashboard-navigation",
+            pageLabel: "User Dashboard Navigation",
+            cases: [
+                { key: "sidebar-all-links-work", label: "Every item in the user dashboard sidebar navigates to its page without a 404 or broken layout", href: "/user" },
+                { key: "sidebar-active-highlight", label: "The sidebar correctly highlights the currently active section as you navigate between pages" },
+                { key: "sidebar-mobile-collapse", label: "The user dashboard sidebar collapses into a mobile-friendly menu/bottom bar on small screens" },
+                { key: "deep-link-direct-load", label: "Directly loading a deep user dashboard URL (e.g. /user/orders/view/[id]) works without first visiting the dashboard home" },
+                { key: "become-seller-crossnav", label: "\"Become a Seller\" (buyer) vs \"Go to my Store\" (seller) shows the correct one based on account state and navigates correctly" },
+                { key: "browser-back-forward", label: "Browser back/forward buttons move correctly between dashboard sub-pages without breaking the layout" },
+                { key: "logged-out-redirect", label: "Opening a user dashboard URL while logged out redirects to login, then returns to the originally requested page after signing in" },
+                { key: "breadcrumbs-accurate", label: "Breadcrumbs (where present) on nested user dashboard pages accurately reflect the current location" },
+            ],
+        },
     ]),
     ...group("selling", "Selling", [
         {
@@ -284,6 +332,20 @@ export const testerChecklistSeedData = [
                 { key: "seller-guide-pages", label: "The 5 seller guide pages (overview, capabilities, finance, listings, orders, settings) all load correctly", href: "/store/guide" },
             ],
         },
+        {
+            pageKey: "store-dashboard-navigation",
+            pageLabel: "Store Dashboard Navigation",
+            cases: [
+                { key: "store-sidebar-all-links-work", label: "Every item in the store/seller dashboard sidebar navigates to its page without a 404 or broken layout", href: "/store" },
+                { key: "store-sidebar-active-highlight", label: "The store sidebar correctly highlights the currently active section as you navigate between pages" },
+                { key: "store-sidebar-mobile-collapse", label: "The store dashboard sidebar collapses into a mobile-friendly menu/bottom bar on small screens" },
+                { key: "store-deep-link-direct-load", label: "Directly loading a deep store dashboard URL (e.g. /store/products/[id]/edit) works without first visiting the dashboard home" },
+                { key: "store-user-crossnav", label: "The store dashboard's cross-nav link back to the buyer dashboard works and lands on the correct page" },
+                { key: "store-browser-back-forward", label: "Browser back/forward buttons move correctly between store dashboard sub-pages without breaking the layout" },
+                { key: "store-logged-out-redirect", label: "Opening a store dashboard URL while logged out (or as a non-seller) redirects appropriately instead of erroring" },
+                { key: "store-nav-listing-type-groups", label: "The seller nav correctly groups/labels each listing-type management area (standard, auctions, pre-orders, prize draws, bundles, classifieds, digital codes, live, art, stickers)" },
+            ],
+        },
     ]),
     ...group("content-discovery", "Content & Discovery", [
         {
@@ -405,4 +467,212 @@ export const testerChecklistSeedData = [
             ],
         },
     ]),
+    ...group("public-pages", "Public & Marketing Pages", [
+        {
+            pageKey: "core-listing-pages",
+            pageLabel: "Homepage & Core Listing Pages",
+            cases: [
+                { key: "homepage-loads", label: "The homepage loads without errors on both desktop and mobile", href: "/" },
+                { key: "products-listing-page", label: "The products listing page loads and paginates correctly", href: "/products" },
+                { key: "auctions-listing-page", label: "The auctions listing page loads correctly", href: "/auctions" },
+                { key: "preorders-listing-page", label: "The pre-orders listing page loads correctly", href: "/pre-orders" },
+                { key: "bundles-listing-page", label: "The bundles listing page loads correctly", href: "/bundles" },
+                { key: "categories-index", label: "The categories index page loads correctly", href: "/categories" },
+                { key: "brands-index-detail", label: "The brands index and an individual brand detail page load correctly" },
+            ],
+        },
+        {
+            pageKey: "stores-sellers-directories",
+            pageLabel: "Store & Seller Directories",
+            cases: [
+                { key: "store-directory", label: "The store directory page loads correctly", href: "/stores" },
+                { key: "store-detail-tabs", label: "A store detail page's auctions/bundles/coupons/pre-orders/prize-draws/reviews tabs all load correctly" },
+                { key: "sellers-directory", label: "The sellers directory page loads correctly", href: "/sellers" },
+                { key: "seller-detail-page", label: "An individual seller's public detail page loads correctly" },
+                { key: "scams-registry", label: "The scams registry page and an individual scam detail page load correctly", href: "/scams" },
+            ],
+        },
+        {
+            pageKey: "help-how-it-works",
+            pageLabel: "Help & How-It-Works Pages",
+            cases: [
+                { key: "contact-page", label: "The contact page loads and the form submits correctly", href: "/contact" },
+                { key: "help-page", label: "The help page loads correctly", href: "/help" },
+                { key: "how-it-works-pages", label: "All 7 how-it-works pages (auctions, checkout, offers, orders, payouts, pre-orders, reviews) load correctly" },
+                { key: "fees-page", label: "The fees page loads correctly", href: "/fees" },
+            ],
+        },
+        {
+            pageKey: "legal-policy-pages",
+            pageLabel: "Legal & Policy Pages",
+            cases: [
+                { key: "shipping-refund-policy", label: "Shipping-policy and refund-policy pages load correctly" },
+                { key: "privacy-cookies-security", label: "Privacy, cookies, and security pages load correctly" },
+            ],
+        },
+        {
+            pageKey: "auth-error-pages",
+            pageLabel: "Remaining Auth & Error Pages",
+            cases: [
+                { key: "register-page", label: "The register page loads and account creation works", href: "/register" },
+                { key: "forgot-reset-password-pages", label: "Forgot-password and reset-password pages both work" },
+                { key: "verify-email-page", label: "The verify-email page correctly confirms a pending verification" },
+                { key: "oauth-loading-redirect", label: "The OAuth-loading redirect page transitions correctly after a Google sign-in" },
+                { key: "checkout-success-page", label: "The checkout-success page shows correct order details after payment", href: "/checkout/success" },
+                { key: "unauthorized-404-pages", label: "Unauthorized and 404 error pages render correctly instead of crashing" },
+            ],
+        },
+    ]),
+    ...group("admin", "Admin (Testing)", [
+        {
+            pageKey: "catalog-listings",
+            pageLabel: "Catalog & Listings",
+            cases: [
+                { key: "brands-crud", label: "Admin can create, edit, and list brands", href: "/admin/brands" },
+                { key: "categories-crud", label: "Admin can create, edit, and list categories", href: "/admin/categories" },
+                { key: "products-crud", label: "Admin can create, edit, and list products", href: "/admin/products" },
+                { key: "sublisting-categories-crud", label: "Admin can create, edit, and list sublisting categories", href: "/admin/sublisting-categories" },
+                { key: "carousel-crud", label: "Admin can create, edit, and reorder carousel slides", href: "/admin/carousel" },
+                { key: "sections-crud", label: "Admin can create, edit, and reorder homepage sections", href: "/admin/sections" },
+                { key: "art-stickers-crud", label: "Admin can create, edit, and list art and sticker listings" },
+                { key: "deals-featured-crud", label: "Admin can create, edit, and list deals and featured listings" },
+            ],
+        },
+        {
+            pageKey: "coupons",
+            pageLabel: "Coupons",
+            cases: [
+                { key: "coupon-create-percentage", label: "Admin can create a percentage-type coupon", href: "/admin/coupons/new" },
+                { key: "coupon-create-fixed-freeship-bxgy", label: "Admin can create fixed, free_shipping, and buy_x_get_y coupon types" },
+                { key: "coupon-per-user-limit-enforced", label: "A coupon's perUserLimit is correctly enforced at checkout after being set by admin" },
+                { key: "coupon-min-max-discount", label: "Admin-set minPurchase and maxDiscount are correctly enforced at checkout" },
+                { key: "coupon-scope-admin-vs-seller", label: "Admin-scope and seller-scope coupons both apply correctly, respecting scope rules" },
+                { key: "coupon-expire-reject", label: "Expiring a coupon from the admin editor causes checkout to reject it immediately" },
+            ],
+        },
+        {
+            pageKey: "events-raffles-spin",
+            pageLabel: "Events, Raffles & Spin Wheel",
+            cases: [
+                { key: "raffle-create-open", label: "Admin can create an open_raffle event", href: "/admin/events/new" },
+                { key: "raffle-create-top-n-scorers", label: "Admin can create a top_n_scorers raffle event" },
+                { key: "raffle-create-top-n-participants", label: "Admin can create a top_n_participants raffle event" },
+                { key: "raffle-draw-winner", label: "Drawing a raffle winner correctly populates raffleWinnerUserId and raffleTriggeredAt" },
+                { key: "spin-wheel-create", label: "Admin can create a spin_wheel event with weighted prizes" },
+                { key: "spin-wheel-limits-enforced", label: "spinMaxPerUser and spinWindowStart/End are correctly enforced once configured by admin" },
+                { key: "event-entries-admin-view", label: "Admin event-entries list shows accurate entries", href: "/admin/event-entries" },
+            ],
+        },
+        {
+            pageKey: "prize-draws-lotteries",
+            pageLabel: "Prize Draws / Lotteries",
+            cases: [
+                { key: "prizedraw-create", label: "Admin can create a prize-draw listing", href: "/admin/prize-draws" },
+                { key: "prizedraw-reveal-winner", label: "Admin can reveal a prize-draw winner via the crypto.randomInt reveal flow" },
+                { key: "prizedraw-auto-refund", label: "Non-winning entries are auto-refunded correctly after a reveal" },
+                { key: "prizedraw-lock-on-reveal", label: "Lock-on-reveal correctly blocks further entries after the draw" },
+                { key: "prizedraw-entries-view", label: "Admin can view prize-draw / lottery entries", href: "/admin/lotteries" },
+            ],
+        },
+        {
+            pageKey: "bundles",
+            pageLabel: "Bundles / Grouped Listings",
+            cases: [
+                { key: "bundle-create", label: "Admin can create a bundle from existing products", href: "/admin/bundles" },
+                { key: "bundle-stock-sync", label: "Bundle stock correctly syncs when a component product's stock changes" },
+                { key: "bundle-edit-delete", label: "Admin can edit and delete a bundle" },
+            ],
+        },
+        {
+            pageKey: "classifieds-digitalcodes-live",
+            pageLabel: "Classifieds, Digital Codes & Live Listings",
+            cases: [
+                { key: "classified-create-moderate", label: "Admin can create and moderate classified listings", href: "/admin/classified" },
+                { key: "digitalcode-create-moderate", label: "Admin can create and moderate digital-code listings", href: "/admin/digital-codes" },
+                { key: "live-create-moderate", label: "Admin can create and moderate live-item listings", href: "/admin/live" },
+            ],
+        },
+        {
+            pageKey: "blog-faqs",
+            pageLabel: "Blog & FAQs",
+            cases: [
+                { key: "blog-create-edit-publish", label: "Admin can create, edit, and publish a blog post", href: "/admin/blog" },
+                { key: "faq-create-edit-category", label: "Admin can create and edit an FAQ, including category assignment", href: "/admin/faqs" },
+            ],
+        },
+        {
+            pageKey: "orders-fulfillment",
+            pageLabel: "Orders & Fulfillment",
+            cases: [
+                { key: "orders-status-change", label: "Admin orders list shows accurate orders and status changes save correctly", href: "/admin/orders" },
+                { key: "bids-admin-view", label: "Admin bids view shows accurate bid data", href: "/admin/bids" },
+                { key: "return-requests-triage", label: "Admin can triage return requests", href: "/admin/return-requests" },
+                { key: "fulfillment-queue-admin", label: "Admin fulfillment queue shows accurate pending items", href: "/admin/fulfillment" },
+                { key: "shipments-crud", label: "Admin can create/edit shipments, including lots/items and projections", href: "/admin/shipments" },
+                { key: "print-center-admin", label: "Admin print-center generates labels/invoices correctly", href: "/admin/print-center" },
+                { key: "payouts-export-admin", label: "Admin can export payouts", href: "/admin/payouts" },
+                { key: "bulk-action-realtime-progress", label: "A bulk admin action (e.g. bulk order status update) shows live progress via the bulk_events realtime channel and resolves without polling" },
+            ],
+        },
+        {
+            pageKey: "users-trust",
+            pageLabel: "Users & Trust",
+            cases: [
+                { key: "users-role-change", label: "Admin can change a user's role and toggle isTester/canTestAdmin", href: "/admin/users" },
+                { key: "roles-crud", label: "Admin can create and edit custom roles", href: "/admin/roles" },
+                { key: "sessions-revoke", label: "Admin can revoke a user's active sessions", href: "/admin/sessions" },
+                { key: "scammers-registry-admin", label: "Admin can manage the scammer registry", href: "/admin/scammers" },
+                { key: "banned-addresses-admin", label: "Admin can manage banned addresses", href: "/admin/banned-addresses" },
+                { key: "address-clusters-admin", label: "Admin can view address clusters", href: "/admin/address-clusters" },
+                { key: "moderation-queue-admin", label: "Admin moderation queue works correctly", href: "/admin/moderation" },
+                { key: "support-tickets-triage-admin", label: "Admin can triage support tickets", href: "/admin/support-tickets" },
+                { key: "item-requests-admin", label: "Admin can manage item requests", href: "/admin/item-requests" },
+                { key: "reports-admin", label: "Admin reports queue works correctly", href: "/admin/reports" },
+                { key: "payment-methods-clusters-admin", label: "Admin can manage payment methods and payment-method clusters", href: "/admin/payment-methods" },
+                { key: "catalogue-approvals-admin", label: "Admin can approve/reject personal catalogue submissions", href: "/admin/catalogue-approvals" },
+            ],
+        },
+        {
+            pageKey: "content-marketing",
+            pageLabel: "Content & Marketing",
+            cases: [
+                { key: "ads-crud-preview", label: "Admin can create, edit, and preview ads", href: "/admin/ads" },
+                { key: "newsletter-export-admin", label: "Admin can export the newsletter subscriber list", href: "/admin/newsletter" },
+                { key: "contact-submissions-admin", label: "Admin can view contact form submissions", href: "/admin/contact" },
+                { key: "media-library-admin", label: "Admin media library works correctly", href: "/admin/media" },
+                { key: "navigation-editor-admin", label: "Admin can edit site navigation", href: "/admin/navigation" },
+                { key: "settings-navigation-actions", label: "Admin settings/navigation and settings/actions pages save correctly" },
+                { key: "features-feature-flags-admin", label: "Admin can manage product features and feature flags" },
+            ],
+        },
+        {
+            pageKey: "site-system",
+            pageLabel: "Site & System",
+            cases: [
+                { key: "site-settings-admin", label: "Admin site settings page saves correctly", href: "/admin/site" },
+                { key: "admin-dashboard-widgets", label: "Admin dashboard widgets show accurate data", href: "/admin/dashboard" },
+                { key: "analytics-admin", label: "Admin analytics dashboard shows accurate data", href: "/admin/analytics" },
+                { key: "maintenance-pages-admin", label: "The maintenance pages (analysis, client-errors, cloud-logs, function-errors, payment-rollbacks, server-errors + detail) all load correctly", href: "/admin/maintenance" },
+                { key: "copilot-admin", label: "Admin copilot page works correctly", href: "/admin/copilot" },
+                { key: "team-admin", label: "Admin team page works correctly", href: "/admin/team" },
+                { key: "guide-pages-admin", label: "The 8 admin guide pages all load correctly", href: "/admin/guide" },
+                { key: "tester-checklist-crud-admin", label: "Admin can create, edit, and toggle adminOnly on tester checklist items", href: "/admin/tester-checklist" },
+                { key: "tester-feedback-report-export", label: "Admin tester-feedback report shows Yes/No analytics grouped correctly and the Download Report export works", href: "/admin/tester-feedback" },
+            ],
+        },
+        {
+            pageKey: "buyer-data-admin",
+            pageLabel: "Buyer-Data Admin Views",
+            cases: [
+                { key: "carts-admin-view", label: "Admin carts view shows accurate data", href: "/admin/carts" },
+                { key: "wishlists-admin-view", label: "Admin wishlists view shows accurate data", href: "/admin/wishlists" },
+                { key: "history-admin-view", label: "Admin history view shows accurate data", href: "/admin/history" },
+                { key: "notifications-admin-view", label: "Admin notifications and admin-notifications views show accurate data" },
+                { key: "reviews-admin-view", label: "Admin reviews view shows accurate data", href: "/admin/reviews" },
+                { key: "store-addresses-admin", label: "Admin store-addresses view shows accurate data", href: "/admin/store-addresses" },
+                { key: "addresses-crud-admin", label: "Admin can create and edit addresses", href: "/admin/addresses" },
+                { key: "stores-admin-view", label: "Admin stores view shows accurate data", href: "/admin/stores" },
+            ],
+        },
+    ], { adminOnly: true }),
 ];

package/dist/next/api/routeHandler.js

@@ -188,17 +188,13 @@ export function createRouteHandler(options) {
                 : options.permission
                     ? ["admin", "employee"]
                     : [];
-            if (effectiveRoles.length > 0) {
-                if (!user || !effectiveRoles.includes(user.role ?? "")) {
-                    const testerEligible = await isTesterEligibleForAdminRoute(user, effectiveRoles);
-                    if (testerEligible && user) {
-                        user.isTester = true;
-                        user.canTestAdmin = true;
-                    }
-                    else {
-                        return errorJson(403, HTTP_ERROR_CODES.FORBIDDEN, "Insufficient permissions", requestId);
-                    }
+            if (effectiveRoles.length > 0 && (!user || !effectiveRoles.includes(user.role ?? ""))) {
+                const testerEligible = await isTesterEligibleForAdminRoute(user, effectiveRoles);
+                if (!testerEligible || !user) {
+                    return errorJson(403, HTTP_ERROR_CODES.FORBIDDEN, "Insufficient permissions", requestId);
                 }
+                user.isTester = true;
+                user.canTestAdmin = true;
             }
             // -- Permission check (employee fine-grained) --------------------------
             if (options.permission && user && !isEffectiveAdminUser(user)) {