@mohasinac/appkit 4.0.2 → 4.1.0

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

@@ -1,8 +1,9 @@
 /*
  * WHY: Seeds the initial tester QA checklist catalog — DB-backed, admin-manageable (mirrors faq-seed-data.ts).
- * WHAT: ~55 default test cases across 6 groups (Account & Auth, Buying, Selling, Content & Discovery,
+ * 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.
+ *       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.
  *
  * EXPORTS:
  *   testerChecklistSeedData — Array of Partial<TesterChecklistItemDocument> for seed runner
@@ -14,7 +15,7 @@
  * @tag consumers:seed/index.ts,seed/runner.ts
  * @tag sideEffects:none
  */
-function group(groupKey, groupLabel, pages) {
+function group(groupKey, groupLabel, pages, opts) {
     const items = [];
     pages.forEach((page, pageIdx) => {
         page.cases.forEach((c, caseIdx) => {
@@ -27,8 +28,9 @@ function group(groupKey, groupLabel, pages) {
                 label: c.label,
                 description: c.description,
                 href: c.href,
-                order: pageIdx * 10 + caseIdx,
+                order: (opts?.orderOffset ?? 0) + pageIdx * 10 + caseIdx,
                 isActive: true,
+                adminOnly: opts?.adminOnly ?? false,
             });
         });
     });
@@ -42,6 +44,8 @@ export const testerChecklistSeedData = [
             cases: [
                 { key: "email-signup", label: "Sign up with email works", href: "/register" },
                 { key: "google-oauth", label: "Sign up / log in with Google works", href: "/login" },
+                { key: "google-link-existing", label: "Linking Google sign-in to an existing email/password account works" },
+                { key: "google-popup-blocked-fallback", label: "If the Google sign-in popup is blocked, the fallback (RTDB signal + postMessage) still completes sign-in" },
                 { key: "login", label: "Log in with email + password works", href: "/login" },
                 { key: "logout", label: "Log out works and clears the session" },
                 { key: "email-verify", label: "Email verification link works" },
@@ -58,6 +62,17 @@ export const testerChecklistSeedData = [
                 { key: "public-profile-toggle", label: "Public profile visibility toggle works" },
             ],
         },
+        {
+            pageKey: "testing-program",
+            pageLabel: "Tester Hub",
+            cases: [
+                { key: "tester-hub-loads", label: "Tester Hub loads the full checklist grouped by section", href: "/user/tester" },
+                { key: "tester-hub-search", label: "Tester Hub search finds test cases by typing part of the title or the route (e.g. \"/store/payouts\")", href: "/user/tester" },
+                { key: "tester-hub-answer-saves", label: "Answering Yes/No and adding a comment on a test case saves without reloading" },
+                { key: "admin-tester-access", label: "Signed-in admin accounts can open the Tester Hub and see the same checklist as testers", href: "/user/tester" },
+                { key: "admin-testing-section", label: "Admin dashboard's Testing section shows both the Tester Checklist and Tester Feedback (results) links", href: "/admin/tester-feedback" },
+            ],
+        },
     ]),
     ...group("buying", "Buying", [
         {
@@ -79,6 +94,11 @@ export const testerChecklistSeedData = [
                 { key: "preorder-detail", label: "Pre-order detail page shows expected ship date correctly" },
                 { key: "image-gallery", label: "Product image gallery / zoom works" },
                 { key: "video-playback", label: "Product video (YouTube embed) plays correctly" },
+                { key: "prizedraw-buy-reveal", label: "Buying a prize-draw entry, then the reveal, correctly shows win/lose and auto-refunds non-winners" },
+                { key: "bundle-purchase", label: "Purchasing a bundle/grouped-listing works and shows all included items in the order" },
+                { key: "classified-contact-flow", label: "A classified listing shows a contact-seller flow with deliberately no checkout/buy button" },
+                { key: "digitalcode-delivery", label: "Purchasing a digital-code listing delivers the code to the buyer post-purchase" },
+                { key: "live-item-detail", label: "A live-item listing's detail page shows the livestream link correctly" },
             ],
         },
         {
@@ -139,6 +159,22 @@ export const testerChecklistSeedData = [
             cases: [
                 { key: "start-conversation", label: "Starting a conversation with a seller works" },
                 { key: "receive-reply", label: "Receiving and reading a seller's reply works" },
+                { key: "message-realtime-update", label: "A new message appears in the recipient's thread without a manual page refresh (realtime ping-channel)", href: "/user/messages" },
+                { key: "messages-list-thread", label: "The messages list and individual thread view both load correctly", href: "/user/messages" },
+            ],
+        },
+        {
+            pageKey: "user-dashboard-extras",
+            pageLabel: "User Dashboard — Addresses, Catalogue, Settings, My Orders-by-Type",
+            cases: [
+                { key: "addresses-crud", label: "Adding, editing, and listing delivery addresses works", href: "/user/addresses" },
+                { key: "catalogue-crud", label: "Adding, editing, and deleting a personal catalogue item works", href: "/user/catalogue" },
+                { key: "settings-page", label: "The user settings page loads and saves correctly", href: "/user/settings" },
+                { key: "my-prize-draws", label: "\"My Prize Draw Entries\" shows accurate entries and outcomes", href: "/user/prize-draws" },
+                { key: "my-digital-codes", label: "\"My Digital Codes\" shows purchased codes correctly", href: "/user/digital-codes" },
+                { key: "my-offers", label: "\"My Offers\" list shows accurate offer history", href: "/user/offers" },
+                { key: "my-returns", label: "Requesting and viewing a return works", href: "/user/returns" },
+                { key: "my-reviews", label: "\"My Reviews\" shows reviews the user has left", href: "/user/reviews" },
             ],
         },
     ]),
@@ -182,6 +218,70 @@ export const testerChecklistSeedData = [
             cases: [
                 { key: "view-analytics", label: "Seller analytics dashboard shows accurate sales data", href: "/store/analytics" },
                 { key: "view-payouts", label: "Seller payouts list shows accurate payout history", href: "/store/payouts" },
+                { key: "payouts-checkbox-select", label: "Selecting payouts with the row checkboxes shows a working bulk action bar (Export Selected)", href: "/store/payouts" },
+                { key: "payouts-detail-panel", label: "Opening \"View Details\" on a payout shows a side panel with status progress, transaction ID, and expected payout date" },
+                { key: "payouts-reminder-toggle", label: "Toggling the payout reminder flag in the detail panel saves correctly" },
+            ],
+        },
+        {
+            pageKey: "seller-shipping-payouts-setup",
+            pageLabel: "Seller Shipping & Payout Setup",
+            cases: [
+                { key: "shipping-page", label: "Store shipping settings page saves correctly", href: "/store/shipping" },
+                { key: "shipping-configs-crud", label: "Creating, editing, and listing shipping configs works", href: "/store/shipping-configs" },
+                { key: "payout-methods-crud", label: "Adding, editing, and listing payout methods works", href: "/store/payout-methods" },
+                { key: "payout-settings-page", label: "Payout settings page saves correctly", href: "/store/payout-settings" },
+            ],
+        },
+        {
+            pageKey: "seller-listing-types",
+            pageLabel: "Seller — All Listing Types (Coupons, Bundles, Classifieds, Digital Codes, Live, Prize Draws, Art, Stickers)",
+            cases: [
+                { key: "seller-coupons-crud", label: "Seller can create, edit, and list their own coupons", href: "/store/coupons" },
+                { key: "seller-bundles-crud", label: "Seller can create, edit, and list bundles/grouped listings", href: "/store/bundles" },
+                { key: "seller-classified-crud", label: "Seller can create, edit, and list classified listings", href: "/store/classified" },
+                { key: "seller-digitalcodes-crud", label: "Seller can create, edit, and list digital-code listings", href: "/store/digital-codes" },
+                { key: "seller-live-crud", label: "Seller can create, edit, and list live-item listings", href: "/store/live" },
+                { key: "seller-prizedraws-crud", label: "Seller can create, edit, and list prize-draw listings, and view entries", href: "/store/prize-draws" },
+                { key: "seller-art-stickers-crud", label: "Seller can create, edit, and list art and sticker listings", href: "/store/art" },
+            ],
+        },
+        {
+            pageKey: "seller-catalog-org",
+            pageLabel: "Seller Categories, Sublisting Categories & Listing Templates",
+            cases: [
+                { key: "seller-categories-crud", label: "Seller can create and edit their own categories", href: "/store/categories" },
+                { key: "seller-sublisting-categories-crud", label: "Seller can create and edit sublisting categories", href: "/store/sublisting-categories" },
+                { key: "seller-listing-templates-crud", label: "Seller can create, edit, and reuse listing templates when creating a new product", href: "/store/listing-templates" },
+            ],
+        },
+        {
+            pageKey: "seller-ops-comms",
+            pageLabel: "Seller Addresses, Messages, Fulfillment & Print",
+            cases: [
+                { key: "seller-addresses-crud", label: "Seller can add and edit store addresses", href: "/store/addresses" },
+                { key: "seller-messages", label: "Seller messages list and thread view both work", href: "/store/messages" },
+                { key: "seller-fulfillment-queue", label: "Seller fulfillment queue shows accurate pending items", href: "/store/fulfillment" },
+                { key: "seller-print-center", label: "Seller print-center generates labels/invoices correctly", href: "/store/print-center" },
+                { key: "seller-inventory-print", label: "Seller inventory print view works", href: "/store/inventory/print" },
+            ],
+        },
+        {
+            pageKey: "seller-marketing-extras",
+            pageLabel: "Seller Offers, Features, Google Reviews & WhatsApp Catalog",
+            cases: [
+                { key: "seller-offers-list", label: "Seller offers list shows accurate buyer offers", href: "/store/offers" },
+                { key: "seller-features-crud", label: "Seller can create and edit product features", href: "/store/features" },
+                { key: "seller-google-reviews-sync", label: "Google Reviews sync pulls in real reviews correctly", href: "/store/google-reviews" },
+                { key: "seller-whatsapp-catalog", label: "WhatsApp catalog import/push works", href: "/store/whatsapp" },
+                { key: "seller-reviews-response", label: "Seller can view and respond to product reviews", href: "/store/reviews" },
+            ],
+        },
+        {
+            pageKey: "seller-guide",
+            pageLabel: "Seller Guide Pages",
+            cases: [
+                { key: "seller-guide-pages", label: "The 5 seller guide pages (overview, capabilities, finance, listings, orders, settings) all load correctly", href: "/store/guide" },
             ],
         },
     ]),
@@ -199,8 +299,11 @@ export const testerChecklistSeedData = [
             pageLabel: "Events, Raffles & Spin Wheel",
             cases: [
                 { key: "view-event", label: "Viewing an event detail page works", href: "/user/events" },
-                { key: "raffle-entry", label: "Entering a raffle event works" },
-                { key: "spin-wheel", label: "Spinning the spin-wheel event works and shows the prize" },
+                { key: "raffle-entry", label: "Entering an open_raffle event works" },
+                { key: "raffle-entry-top-n-scorers", label: "Entering a top_n_scorers raffle event works and the leaderboard reflects entries" },
+                { key: "raffle-entry-top-n-participants", label: "Entering a top_n_participants raffle event works" },
+                { key: "spin-wheel", label: "Spinning the spin-wheel event works and shows the prize immediately (realtime)" },
+                { key: "spin-wheel-window-blocked", label: "A second spin attempt within the same spinWindow is blocked with a clear message" },
             ],
         },
         {
@@ -209,6 +312,10 @@ export const testerChecklistSeedData = [
             cases: [
                 { key: "view-claimed-coupons", label: "Claimed coupons list shows accurate coupons", href: "/user/coupons" },
                 { key: "coupon-discount-applied", label: "Coupon discount is correctly reflected in the order total" },
+                { key: "coupon-expired-rejected", label: "Applying an expired coupon at checkout shows a specific expiry rejection message, not a generic error" },
+                { key: "coupon-below-min-purchase", label: "Applying a coupon below its minPurchase threshold is rejected with a clear message" },
+                { key: "coupon-not-combinable", label: "A seller-scoped coupon that isn't combinable with another seller's coupon is rejected when both are applied" },
+                { key: "coupon-per-user-limit", label: "Re-applying a coupon after hitting its perUserLimit is rejected" },
             ],
         },
         {
@@ -217,6 +324,18 @@ export const testerChecklistSeedData = [
             cases: [
                 { key: "receive-notification", label: "In-app notifications appear for order/bid/message events", href: "/user/notifications" },
                 { key: "mark-read", label: "Marking a notification as read works" },
+                { key: "notification-channel-prefs", label: "Per-channel notification preferences (in-app / email / WhatsApp) save and are respected" },
+                { key: "notification-type-sample", label: "A sample of notification types (order status change, bid outbid, message received, payout) each trigger correctly end-to-end" },
+                { key: "notification-tab-filters", label: "Notification tab filters correctly narrow the list", href: "/user/notifications" },
+            ],
+        },
+        {
+            pageKey: "faq-help",
+            pageLabel: "FAQ & Help",
+            cases: [
+                { key: "faq-bottom-borders", label: "FAQ question rows show a clear bottom-border divider on the homepage and the FAQs page", href: "/faqs" },
+                { key: "faq-mobile-count", label: "Homepage FAQ section shows a good number of questions on mobile, not just 1-2", href: "/" },
+                { key: "tabs-mobile-dropdown", label: "Tabs on category/brand/product/event detail pages collapse into a colored dropdown on mobile once there are more than 5 tabs" },
             ],
         },
     ]),
@@ -251,5 +370,39 @@ export const testerChecklistSeedData = [
                 { key: "error-states", label: "Error states (404, form validation) look correct" },
             ],
         },
+        {
+            pageKey: "dashboard-layout",
+            pageLabel: "Dashboards — Collapsible Sections & Mobile Tables",
+            cases: [
+                { key: "collapsible-admin", label: "Admin dashboard sections expand/collapse and remember their state on reload", href: "/admin/dashboard" },
+                { key: "collapsible-store", label: "Store dashboard sections expand/collapse and remember their state on reload", href: "/store" },
+                { key: "collapsible-user", label: "User profile dashboard sections expand/collapse and remember their state on reload", href: "/user/profile" },
+                { key: "mobile-table-cards", label: "Admin/seller listing tables show full-row cards by default on mobile, with a working switch back to table view" },
+                { key: "view-mode-persist", label: "Switching the dashboard table/card view mode is remembered on your next visit (filters/search/sort are not)" },
+            ],
+        },
+        {
+            pageKey: "footer-theme",
+            pageLabel: "Footer & Dark Mode",
+            cases: [
+                { key: "footer-dark-mode", label: "Footer background and all link/text colors switch correctly between light and dark mode", href: "/" },
+            ],
+        },
+        {
+            pageKey: "homepage-carousels",
+            pageLabel: "Homepage Carousels",
+            cases: [
+                { key: "carousel-loops", label: "Homepage carousels (Shop by Category, Top Brands, Featured Products, Live Auctions, Reserve Before It Ships, Verified Stores, Tournaments & Events, Collector Reviews) loop back to the first item after reaching the last instead of getting stuck at the end", href: "/" },
+                { key: "carousel-no-flicker", label: "Homepage carousel auto-scroll does not flash/flicker when looping back to the first item" },
+                { key: "carousel-pause-on-interaction", label: "Homepage carousel auto-scroll pauses while hovering, touching, keyboard-focusing (Tab + arrow keys), or scrolling it, and resumes afterward" },
+                { key: "carousel-arrows-work", label: "Homepage carousel prev/next arrow buttons work and wrap around at both ends" },
+                { key: "hero-banner-loops", label: "Hero banner at the top of the homepage rotates through all slides and loops back to the first without getting stuck" },
+                { key: "sections-showcase-render", label: "Categories showcase and brands strip sections render real seeded data" },
+                { key: "sections-promo-render", label: "Deals/promotions, newsletter signup, and spotlight sections render correctly" },
+                { key: "sections-live-reserve-render", label: "Live auctions and \"Reserve Before It Ships\" (pre-orders) sections show real listings" },
+                { key: "sections-social-proof-render", label: "Verified stores, tournaments & events, and collector reviews sections render correctly" },
+                { key: "sections-social-feed-hidden", label: "The social-feed section type is correctly hidden on the homepage since it's disabled in Site Settings" },
+            ],
+        },
     ]),
 ];

package/dist/index.d.ts

@@ -2448,7 +2448,7 @@ export { computeCheckoutFees, computePayoutDeduction, computeCodHandlingFee, cal
 export type { FeeCommissionRates, CheckoutFees, PayoutDeduction, CodHandlingFeeRates, GstBreakdown, } from "./_internal/shared/fees/calculator";
 export { checkEmiEligibility, computeEmiSchedule } from "./_internal/shared/features/emi/schedule";
 export type { EmiSettings, EmiIneligibleReason, EmiEligibility, EmiInstallmentPlan, EmiScheduleResult, } from "./_internal/shared/features/emi/schedule";
-export { isAdminUser, isSellerUser, isModeratorUser, isEmployeeUser, isBuyerUser, } from "./features/auth/role-predicates";
+export { isAdminUser, isSellerUser, isModeratorUser, isEmployeeUser, isBuyerUser, isEffectiveAdminUser, } from "./features/auth/role-predicates";
 export { sanitizeProductForPublic, sanitizeProductsForPublic } from "./features/products/index";
 export { productAdminColumns } from "./features/products/index";
 export { productImageSchema } from "./features/products/index";

package/dist/index.js

@@ -4494,7 +4494,7 @@ export { computeCheckoutFees, computePayoutDeduction, computeCodHandlingFee, cal
 // EMI eligibility + schedule computation (pure, client-safe — used for checkout quotes).
 export { checkEmiEligibility, computeEmiSchedule } from "./_internal/shared/features/emi/schedule";
 // User-role predicates â€" SB-UNI-E 2026-05-13.
-export { isAdminUser, isSellerUser, isModeratorUser, isEmployeeUser, isBuyerUser, } from "./features/auth/role-predicates";
+export { isAdminUser, isSellerUser, isModeratorUser, isEmployeeUser, isBuyerUser, isEffectiveAdminUser, } from "./features/auth/role-predicates";
 // [SERVER-ONLY]-Safe in browser but intended for server routes.
 // sanitizeProductForPublic - Strip sellerId/sellerName/sellerEmail/ownerId before returning a product in a public response.
 export { sanitizeProductForPublic, sanitizeProductsForPublic } from "./features/products/index";

package/dist/next/api/routeHandler.js

@@ -30,9 +30,10 @@ import { normalizeError } from "../../errors/normalize";
  */
 import { NextResponse } from "next/server.js";
 import { getProviders } from "../../contracts";
-import { isAdminUser } from "../../features/auth/role-predicates";
+import { isEffectiveAdminUser } from "../../features/auth/role-predicates";
 import { mapToHttpError, HTTP_ERROR_CODES } from "../../errors/error-mapping";
 import { serverErrorsRepository } from "../../features/server-errors/repository/server-errors.repository";
+import { userRepository } from "../../repositories";
 import { SCHEMAS } from "../../schemas/registry";
 function buildPublicCacheControl(policy) {
     const maxAge = policy?.maxAge ?? 30;
@@ -138,6 +139,20 @@ function errorJson(status, code, message, requestId, issues) {
         headers: { "X-Request-Id": requestId, "Cache-Control": "no-store" },
     });
 }
+/**
+ * A tester explicitly flagged for admin testing (isTester && canTestAdmin) gets the
+ * same access as "admin" on routes that allow it. isTester/canTestAdmin never appear
+ * in the session-cookie JWT claims (only `role` does), so this requires one live
+ * Firestore read — paid only on the role-mismatch rejection path, never on the common
+ * case (matching role, or a real admin whose JWT role already says "admin").
+ */
+async function isTesterEligibleForAdminRoute(user, effectiveRoles) {
+    if (!user || !effectiveRoles.includes("admin"))
+        return false;
+    const profile = await userRepository.findById(user.uid);
+    return Boolean(profile?.isTester &&
+        profile?.canTestAdmin);
+}
 export function createRouteHandler(options) {
     if (options.bodyOptional && options.bodyRequired) {
         throw new Error("createRouteHandler: bodyOptional and bodyRequired are mutually exclusive");
@@ -175,11 +190,18 @@ export function createRouteHandler(options) {
                     : [];
             if (effectiveRoles.length > 0) {
                 if (!user || !effectiveRoles.includes(user.role ?? "")) {
-                    return errorJson(403, HTTP_ERROR_CODES.FORBIDDEN, "Insufficient permissions", requestId);
+                    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);
+                    }
                 }
             }
             // -- Permission check (employee fine-grained) --------------------------
-            if (options.permission && user && !isAdminUser(user)) {
+            if (options.permission && user && !isEffectiveAdminUser(user)) {
                 const { rbac } = getProviders();
                 if (!rbac) {
                     return errorJson(503, HTTP_ERROR_CODES.UNAVAILABLE, "RBAC provider not configured", requestId);

package/dist/react/contexts/SessionContext.d.ts

@@ -31,6 +31,8 @@ export interface SessionUser {
     storeId?: string;
     /** Tester program flag — orthogonal to `role`. Unlocks the Tester Hub nav item/page. */
     isTester?: boolean;
+    /** Orthogonal to isTester — unlocks admin-only checklist items and real /admin/** RBAC access. */
+    canTestAdmin?: boolean;
     publicProfile?: FirestoreDocument;
     stats?: FirestoreDocument;
     metadata?: FirestoreDocument;

package/dist/react/contexts/SessionContext.js

@@ -64,6 +64,7 @@ function buildSessionUser(authUser, serverData) {
         phoneVerified: serverData.phoneVerified,
         storeId: serverData.storeId,
         isTester: serverData.isTester,
+        canTestAdmin: serverData.canTestAdmin,
         avatarMetadata: serverData.avatarMetadata?.url
             ? {
                 url: serverData.avatarMetadata.url,
@@ -134,6 +135,7 @@ export function SessionProvider({ children, initialUser, endpoints: endpointOver
                 phoneVerified: data.phoneVerified,
                 storeId: data.storeId,
                 isTester: data.isTester,
+                canTestAdmin: data.canTestAdmin,
                 avatarMetadata: data.avatarMetadata?.url
                     ? {
                         url: data.avatarMetadata.url,