@mohasinac/appkit 4.33.1 → 4.34.1

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

@@ -5,12 +5,16 @@
  *      pre-ordering against real code paths — including navigating every entry of the store
  *      detail page's listing-type dropdown (see StoreNavTabs). Auto-expires after 7 days
  *      (testerSandboxCleanup cascades into any bids on the auction).
- * WHAT: Exports productsTesterSeedData — 2 standard + 4 auction (3 staggered 1h/2h/3h "still
- *       open" cycling fixtures + 1 already-ended "won" fixture) + 1 pre-order + 1 prize-draw +
+ * WHAT: Exports productsTesterSeedData — 2 standard + 4 auction (3 staggered "still open"
+ *       cycling fixtures + 1 already-ended "won" fixture) + 1 pre-order + 1 prize-draw +
  *       1 classified + 1 digital-code + 1 live + 1 art + 1 stickers product + 1 product-group
  *       ("Set") parent (product-tester-standard-1/2 are its children, linked via groupId).
- *       The 3 staggered auction ids/end-dates are recomputed on every seed run (including the
- *       testerSandboxRefresh job, every 4h) so testers can watch one actually end mid-session.
+ *
+ *       Every auction end date is recomputed on each seed run from tester-window.ts, as a
+ *       FRACTION of the testing window rather than a fixed duration. At the default
+ *       180-minute window the staggered three land on the historical 1h/2h/3h; a shorter
+ *       TESTER_WINDOW_MINUTES pulls all of them in together, which is what lets a run
+ *       actually watch an auction cross its end time.
  *
  * EXPORTS:
  *   productsTesterSeedData — Array of Partial<ProductDocument> for the seed runner
@@ -26,6 +30,7 @@ import { PRODUCT_FIELDS } from "../../../constants/field-names";
 import { buildSearchTxt } from "../../../utils/search-txt";
 import { seedPhoto } from "../../../seed/_helpers/media";
 import { testDataExpiresAt } from "./tester-ttl";
+import { windowOffset } from "./tester-window";
 const TESTER_STORE_ID = "store-tester-sandbox";
 const TESTER_STORE_NAME = "Tester Sandbox Store";
 const TESTER_GROUP_TITLE = "Tester Sandbox Bundle";
@@ -45,44 +50,56 @@ function withTokens(p) {
         searchTxt: buildSearchTxt([p.title, p.description, p.brand, p.brandSlug, p.categoryNames, p.tags]),
     };
 }
-// Staggered, incrementing-id auction fixtures so testers can watch a live
-// auction actually cross its end time within a single sandbox refresh cycle
-// (testerSandboxRefresh re-imports this module every 4 hours, recomputing
-// these Date.now()-relative offsets fresh each time) instead of the old
-// single fixture that always sat 5 days out. A loop (not hand-typed ids)
-// avoids id collisions if the stagger list is ever extended.
-const AUCTION_CYCLE_STAGGER_HOURS = [1, 2, 3];
-const stagedAuctions = AUCTION_CYCLE_STAGGER_HOURS.map((hours, i) => withTokens({
-    id: `auction-tester-sandbox-cycle-${i + 1}`,
-    slug: `auction-tester-sandbox-cycle-${i + 1}`,
-    title: `Test Auction — Ends in ~${hours}h`,
-    description: `Disposable test auction for the tester QA program, staggered to end roughly ${hours} hour(s) after the last sandbox refresh so testers can watch the end-of-auction flow live. Place a bid — it auto-expires in 7 days, cascading to any bids.`,
-    categorySlugs: COLLECTIBLES_CATEGORY_SLUGS,
-    categoryNames: COLLECTIBLES_CATEGORY_NAMES,
-    brandSlug: "brand-tester-sandbox",
-    brand: "TestBrand",
-    startingBid: 15000,
-    currentBid: 15000,
-    currency: "INR",
-    price: 150,
-    stockQuantity: 1,
-    availableQuantity: 1,
-    auctionEndDate: new Date(Date.now() + hours * 60 * 60 * 1000),
-    bidCount: 0,
-    bidsHaveStarted: false,
-    isSold: false,
-    mainImage: seedPhoto(`auction-image-tester-sandbox-cycle-${i + 1}-20260101`, 900, 900),
-    images: [seedPhoto(`auction-image-tester-sandbox-cycle-${i + 1}-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(),
-}));
+// Staggered, incrementing-id auction fixtures so a tester can watch a live auction
+// actually cross its end time inside one session, instead of the old single fixture
+// that always sat 5 days out. A loop (not hand-typed ids) avoids id collisions if
+// the stagger list is ever extended.
+//
+// Expressed as FRACTIONS of the testing window rather than fixed hours: with the
+// default 180-minute window these resolve to the same 1h/2h/3h this fixture has
+// always used, and an automated run shortens all three together by setting
+// TESTER_WINDOW_MINUTES. Hard-coded hours cannot be shortened, which is what made
+// "watch an auction end" untestable in any run shorter than three hours.
+const AUCTION_CYCLE_STAGGER_FRACTIONS = [1 / 3, 2 / 3, 1];
+/** Deliberately past the end of the run — "plenty of clock left" fixtures must NOT expire mid-test. */
+const OUTLASTS_RUN = 2;
+/** ~1/9 of the window: 20 minutes at the default 180, 10 at a 90-minute run. Scales with the window instead of pinning 20 minutes that a short run can never reach. */
+const EXPIRES_MID_RUN = 1 / 9;
+const stagedAuctions = AUCTION_CYCLE_STAGGER_FRACTIONS.map((fraction, i) => {
+    const endsAt = windowOffset(fraction);
+    const endsInMinutes = Math.max(1, Math.round((endsAt.getTime() - Date.now()) / 60000));
+    return withTokens({
+        id: `auction-tester-sandbox-cycle-${i + 1}`,
+        slug: `auction-tester-sandbox-cycle-${i + 1}`,
+        title: `Test Auction — Ends in ~${endsInMinutes}m`,
+        description: `Disposable test auction for the tester QA program, staggered to end roughly ${endsInMinutes} minute(s) after seeding so testers can watch the end-of-auction flow live. Place a bid — it auto-expires in 7 days, cascading to any bids.`,
+        categorySlugs: COLLECTIBLES_CATEGORY_SLUGS,
+        categoryNames: COLLECTIBLES_CATEGORY_NAMES,
+        brandSlug: "brand-tester-sandbox",
+        brand: "TestBrand",
+        startingBid: 15000,
+        currentBid: 15000,
+        currency: "INR",
+        price: 150,
+        stockQuantity: 1,
+        availableQuantity: 1,
+        auctionEndDate: endsAt,
+        bidCount: 0,
+        bidsHaveStarted: false,
+        isSold: false,
+        mainImage: seedPhoto(`auction-image-tester-sandbox-cycle-${i + 1}-20260101`, 900, 900),
+        images: [seedPhoto(`auction-image-tester-sandbox-cycle-${i + 1}-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(),
+    });
+});
 /**
  * Buy-Now (buyout) fixtures. Four states, because the 2026-08-24 rework made
  * buyout availability depend on `buyNowPrice > currentBid` rather than on
@@ -90,7 +107,7 @@ const stagedAuctions = AUCTION_CYCLE_STAGGER_HOURS.map((hours, i) => withTokens(
  * three of them were previously unreachable as test data.
  *
  * Every date is Date.now()-relative at module import, per CLAUDE.md's tester
- * fixture standard, so the 4-hour testerSandboxRefresh re-arms them.
+ * fixture standard, so each seed run re-arms them; durations come from tester-window.ts.
  */
 const buyoutAuctions = [
     {
@@ -101,7 +118,7 @@ const buyoutAuctions = [
         buyNowPrice: 12000,
         bidCount: 0,
         bidsHaveStarted: false,
-        endsInHours: 6,
+        endsAtFraction: OUTLASTS_RUN,
     },
     {
         key: "buyout-contested",
@@ -111,7 +128,7 @@ const buyoutAuctions = [
         buyNowPrice: 12000,
         bidCount: 2,
         bidsHaveStarted: true,
-        endsInHours: 6,
+        endsAtFraction: OUTLASTS_RUN,
     },
     {
         key: "buyout-passed",
@@ -121,7 +138,7 @@ const buyoutAuctions = [
         buyNowPrice: 9000,
         bidCount: 5,
         bidsHaveStarted: true,
-        endsInHours: 6,
+        endsAtFraction: OUTLASTS_RUN,
     },
     {
         key: "buyout-expiring",
@@ -131,7 +148,7 @@ const buyoutAuctions = [
         buyNowPrice: 5000,
         bidCount: 1,
         bidsHaveStarted: true,
-        endsInMinutes: 20,
+        endsAtFraction: EXPIRES_MID_RUN,
     },
 ].map((f) => withTokens({
     id: `auction-tester-sandbox-${f.key}`,
@@ -149,8 +166,7 @@ const buyoutAuctions = [
     price: f.currentBid,
     stockQuantity: 1,
     availableQuantity: 1,
-    auctionEndDate: new Date(Date.now() +
-        (f.endsInMinutes ? f.endsInMinutes * 60 * 1000 : (f.endsInHours ?? 6) * 60 * 60 * 1000)),
+    auctionEndDate: windowOffset(f.endsAtFraction),
     bidCount: f.bidCount,
     bidsHaveStarted: f.bidsHaveStarted,
     isSold: false,

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

@@ -1927,6 +1927,48 @@ const rawTesterChecklistItems = [
                 },
             ],
         },
+        {
+            pageKey: "return-request",
+            pageLabel: "Requesting a return \u2014 and what final sale actually blocks",
+            href: "/user/orders",
+            cases: [
+                {
+                    key: "return-cta-only-when-returnable",
+                    label: "The \"Request Return\" button appears only on a DELIVERED order inside the 7-day window",
+                    description: "Added 2026-09-04. BEFORE there was no buyer-facing return flow at all: the action existed, the CTA was registered in ACTIONS.USER, and nothing anywhere rendered it. AFTER: open a delivered order's detail page and the button is there beside Track Shipment. Open a pending or shipped one and it is not. Open a delivered order older than 7 days and the page explains the window has closed rather than offering a form that would be refused.",
+                },
+                {
+                    key: "return-not-received-accepted-on-final-sale",
+                    label: "\"It never arrived\" is accepted on a FINAL SALE order",
+                    description: "This is the whole rule. Final sale refuses a change of mind; it can never refuse a claim that the buyer did not get what they paid for. On a final-sale order, choose \"It never arrived\", tick the three acknowledgements, submit \u2014 it must go through and the order must move to Return Requested.",
+                },
+                {
+                    key: "return-change-of-mind-refused-by-name",
+                    label: "On a final-sale order the change-of-mind reasons are NOT OFFERED, and the panel says why",
+                    description: "Open the return form for a final-sale order. A warning panel names the situation, and the reason picker lists only the five fault reasons \u2014 never-arrived, not-as-described, damaged, wrong item, counterfeit. \"I changed my mind\" must not be selectable. On a returnable order all ten reasons appear. A generic \"request refused\" with no explanation is the failure this replaced.",
+                },
+                {
+                    key: "return-reason-is-persisted",
+                    label: "The reason the buyer picked is actually STORED and visible to staff",
+                    description: "BEFORE: `requestReturnAction` parsed a free-text reason and then threw it away before writing \u2014 an order reached Return Requested with nothing recorded about why, and the seller had nothing to act on. AFTER: submit a return, then open the same order in /admin/return-requests and confirm the coded reason and any note are there.",
+                },
+                {
+                    key: "return-partial-gates-selected-lines-only",
+                    label: "On a mixed order, a final-sale line does not block a return of the returnable line",
+                    description: "Final sale is snapshotted PER LINE at purchase, not per order. On an order containing one final-sale item and one returnable item, a change-of-mind return scoped to the returnable line must be accepted; the same reason scoped to the final-sale line must not.",
+                },
+                {
+                    key: "return-prize-draw-still-refused-entirely",
+                    label: "A prize-draw order is still refused for EVERY reason \u2014 a different, earlier gate",
+                    description: "`isNonRefundable` is a property of the listing TYPE and admits no exception, including a seller-fault one. Open a prize-draw order's refund surface: it must refuse outright and say so, without offering a reason picker at all. Confusing this with final sale in either direction is the failure.",
+                },
+                {
+                    key: "return-terms-snapshotted-at-purchase",
+                    label: "Changing a listing's return terms does NOT change an order already placed",
+                    description: "Buy a returnable listing. Then, as the seller, switch that listing to final sale. Go back to the order and request a change-of-mind return \u2014 it must still be ACCEPTED, because the buyer agreed to the terms shown at checkout. The order carries its own copy; a seller must not be able to withdraw a right after the sale.",
+                },
+            ],
+        },
     ]),
     ...group("selling", "Selling", [
         {
@@ -2162,6 +2204,30 @@ const rawTesterChecklistItems = [
                     description: "BEFORE: an invalid field produced a banner listing the problem with no way to reach it, and on the site-settings page the summary was mounted outside every form context and so displayed NOTHING at all. AFTER: submit a form with a bad value (a negative refund on an order, a non-https third-party ad URL, an AdSense id that is not ca-pub-…) and the summary must list it, tag it with its section, collapse open that section when clicked, and show a count badge on the section header.",
                     href: "/admin/ads",
                 },
+                {
+                    key: "required-section-has-no-dead-chevron",
+                    label: "A REQUIRED section renders as a plain heading \u2014 no chevron, nothing to click",
+                    description: "Fixed 2026-09-04. BEFORE: SectionDef documented a required section as rendering \"without a collapse control so it can't be hidden\", but CollapsibleSection had no way to say that, so SectionForm passed a no-op handler and the header still drew a full button with a rotating chevron. Clicking it did nothing, on ~73 required sections across the app \u2014 which reads as a broken form. AFTER: on any sectionised form (admin product, admin user, store product), the first section's header has no chevron and no hover state, while every optional section below it still expands and collapses normally.",
+                    href: "/admin/products/new",
+                },
+                {
+                    key: "open-section-does-not-clip-dropdowns",
+                    label: "A dropdown opened inside an expanded section is not clipped at the panel edge",
+                    description: "BEFORE: the collapse animation kept `overflow: hidden` in its SETTLED open state, not just during the transition, so anything escaping the panel box was cut off. AFTER: expand a section containing a select or picker near its bottom edge, open it, and the list must render in full rather than being sliced by the section border.",
+                    href: "/admin/products/new",
+                },
+                {
+                    key: "error-jump-lands-on-the-field",
+                    label: "Jumping to an error scrolls to the section AND lands focus on the offending field",
+                    description: "BEFORE: the scroll fired one animation frame after expanding, while the panel was still ~0px tall inside overflow:hidden \u2014 so focus landed against a box that was about to grow and the field could end up off-screen. AFTER: submit a form with an error inside a COLLAPSED section. It expands, scrolls, and the invalid input is both visible and focused once the animation finishes.",
+                    href: "/admin/products/new",
+                },
+                {
+                    key: "long-form-typing-is-smooth",
+                    label: "Typing in a long form does not stutter",
+                    description: "BEFORE: the section list was rebuilt on every keystroke, which re-fired the validation effect on top of the validation the keystroke already triggered \u2014 two full-tree schema parses per character on a 40-field listing form. AFTER: type a long description into the seller product form. It should keep up. This is a feel test, not a pass/fail assertion; report it if it lags.",
+                    href: "/store/products/new",
+                },
                 {
                     key: "form-mobile-action-bar",
                     label: "Save and Cancel appear in the pinned mobile bar, once",
@@ -2410,6 +2476,122 @@ const rawTesterChecklistItems = [
                 },
             ],
         },
+        {
+            pageKey: "final-sale-authoring",
+            pageLabel: "Final sale \u2014 the seller switch",
+            href: "/store/products/new",
+            cases: [
+                {
+                    key: "final-sale-defaults-on",
+                    label: "A brand-new listing is FINAL SALE by default \u2014 the Returns section shows \"Accept change-of-mind returns\" switched OFF",
+                    description: "Added 2026-09-04. Open the Returns section on a new listing of any type. The toggle is off and the panel explains that not-received / damaged / wrong-item / not-as-described / counterfeit claims are still accepted. Absent means final sale, so a listing saved without ever opening this section is also final sale \u2014 which is the point.",
+                    href: "/store/products/new",
+                },
+                {
+                    key: "final-sale-opt-out-survives-reload",
+                    label: "Turning returns ON, saving, and RELOADING shows it still on",
+                    description: "This is the case that matters, and a reload is the only way to see it. `productBaseSchema` is a plain z.object() with no .passthrough(), so it strips every key it does not name \u2014 a field missing from it saves with a success toast and is gone. BEFORE such a field existed at all. AFTER: toggle Accept returns ON, Save, reload the edit page, and the toggle must still be ON. If it reverts to off, `finalSale` is being stripped on write.",
+                    href: "/store/products",
+                },
+                {
+                    key: "return-policy-authorable-by-seller",
+                    label: "A seller can write their own Return policy text \u2014 for the first time",
+                    description: "BEFORE: `returnPolicy` existed on the document and the ONLY editor for it was the admin product form, so a seller could never state their own terms. AFTER: the Returns section on the seller form has a Return policy textarea. Type into it, save, reload, and confirm it persists and appears on the public listing under Delivery & Returns.",
+                    href: "/store/products",
+                },
+                {
+                    key: "final-sale-admin-override",
+                    label: "An admin can flip the same switch on any listing, and it is the SAME field",
+                    description: "Open a listing in the admin product editor. The \"Accept change-of-mind returns\" toggle sits directly above the Return policy box and reflects whatever the seller chose. Change it, save, then reopen the SELLER edit form for that listing \u2014 it must show the admin's value. Two independent flags would be the failure.",
+                    href: "/admin/products",
+                },
+                {
+                    key: "final-sale-badges-render",
+                    label: "A final-sale listing shows the pill on its card AND the line on its detail page",
+                    description: "Seed data opts one listing per type OUT of final sale, so both states are visible. On /products, a final-sale listing carries a dark \"Final Sale\" pill; the opted-out one does not. On the detail page, the Delivery & Returns block always renders a returns line \u2014 even when the seller wrote no shipping or policy text at all, which previously hid the block entirely and with it the most consequential term of the sale.",
+                    href: "/products",
+                },
+            ],
+        },
+        {
+            pageKey: "media-limits",
+            pageLabel: "Media \u2014 ten images and one video, on every listing type",
+            href: "/store/products/new",
+            cases: [
+                {
+                    key: "media-gallery-accepts-images-and-video",
+                    label: "The gallery takes BOTH images and a video, and shows a live per-type count",
+                    description: "Changed 2026-09-04. BEFORE the single-media control on the listing form was video-only (`kind=\"video\"`), so the one \"add media\" affordance a seller saw refused photos. AFTER: the gallery accepts image files and a video file in the same control, and a counter under it reads \"N/10 images \u00b7 N/1 video\" as you add them.",
+                    href: "/store/products/new",
+                },
+                {
+                    key: "media-tenth-image-uploads",
+                    label: "The 10th gallery image uploads \u2014 the 5th used to fail with a 400",
+                    description: "BEFORE: the gallery was capped at 5 and sent its Nth image as index N+1, while the server's signed-URL guard rejected any index above 5 \u2014 so the LAST slot of every product form returned a 400 that read as a random upload failure. AFTER: add ten images one at a time. All ten must succeed, including the tenth.",
+                    href: "/store/products/new",
+                },
+                {
+                    key: "media-eleventh-image-refused-client-side",
+                    label: "The 11th image is refused by the FORM with a clear message, not by the server",
+                    description: "Try to add an 11th image. The control must refuse it before uploading, naming the limit (\"You can upload up to 10 images.\"). A server-side 400 arriving after the bytes have gone up is the wrong behaviour \u2014 the user has already waited.",
+                    href: "/store/products/new",
+                },
+                {
+                    key: "media-second-video-refused-first-kept",
+                    label: "A second video is refused and the FIRST one is kept",
+                    description: "With one video already in the gallery, try to add another. The message must say only one video is allowed and tell you to remove the current one \u2014 and crucially the existing video must still be there afterwards. Silently replacing it would lose work.",
+                    href: "/store/products/new",
+                },
+                {
+                    key: "media-caps-flat-across-types",
+                    label: "The same 10 + 1 applies to an auction and a pre-order \u2014 there is no per-type table",
+                    description: "Repeat the ten-image check on /store/auctions/new and /store/pre-orders/new. Both must allow ten. BEFORE the server carried separate AUCTION_IMAGE_MAX and PREORDER_IMAGE_MAX constants, both 5, disagreeing with everything else.",
+                    href: "/store/auctions/new",
+                },
+                {
+                    key: "media-live-listing-still-requires-video",
+                    label: "A live listing STILL refuses to publish without a video",
+                    description: "Unchanged behaviour, re-verified because the surrounding control changed. Create a live listing with photos but no video and press Publish. It must be refused, and the Video field must be marked required. That is a requiredness rule, not a count rule, and the media-limit work must not have removed it.",
+                    href: "/store/live/new",
+                },
+            ],
+        },
+        {
+            pageKey: "listing-type-fields-roundtrip",
+            pageLabel: "Per-type fields survive a save \u2014 all nine listing types",
+            href: "/store/products",
+            cases: [
+                {
+                    key: "roundtrip-classified-meetup",
+                    label: "A classified's meetup city, locality and pincode come back after a save",
+                    description: "Fixed 2026-09-04, and this was live data loss. BEFORE: the form held `classifiedCity` while the write schema expected `classified.meetupArea.city`, nothing translated between them, and the schema strips unnamed keys \u2014 so the seller pressed Publish, got a success, and the listing saved with none of the fields that made it a classified. AFTER: fill in the meetup details, save, reopen the edit form, and every value must be there.",
+                    href: "/store/classified/new",
+                },
+                {
+                    key: "roundtrip-live-species-jurisdictions",
+                    label: "A live listing's species, transport method and permitted jurisdictions survive",
+                    description: "Same bug, and the most serious instance of it: `jurisdictionAllowed` is the field that prevents shipping a live animal somewhere that forbids it, and it was being dropped. Create a live listing with species, age, sex, care info, transport method, handling fee and at least one jurisdiction. Save, reopen, confirm all of it returned.",
+                    href: "/store/live/new",
+                },
+                {
+                    key: "roundtrip-digital-code-delivery",
+                    label: "A digital code's delivery method, pool size and redemption instructions survive",
+                    href: "/store/digital-codes/new",
+                },
+                {
+                    key: "roundtrip-print-meta",
+                    label: "An art print's size, material, finish and edition size survive \u2014 and so do a sticker sheet's",
+                    description: "Art and stickers share one `printMeta` block, so check both: create one of each with all four fields filled, save, reopen.",
+                    href: "/store/art/new",
+                },
+                {
+                    key: "roundtrip-edit-form-opens-populated",
+                    label: "Opening the edit form for an EXISTING listing shows its per-type fields already filled",
+                    description: "The inverse half of the same bug. BEFORE: the edit pages hand-built their initial values and listed none of the per-type keys, so the form opened blank for them even when the document held real data \u2014 which read as \"my data was deleted\". AFTER: open the edit page for any seeded classified, live, digital-code, art or sticker listing and its per-type fields are populated on arrival.",
+                    href: "/store/classified",
+                },
+            ],
+        },
     ]),
     ...group("content-discovery", "Content & Discovery", [
         {

package/dist/features/tester/seed-data/tester-window.d.ts

@@ -0,0 +1,25 @@
+/** Reproduces the historical 1h/2h/3h auction stagger when nothing overrides it. */
+export declare const DEFAULT_TESTER_WINDOW_MINUTES = 180;
+/** Below this nothing is observable — a page load alone can outlast it. */
+export declare const MIN_TESTER_WINDOW_MINUTES = 5;
+/** The sandbox TTL is 7 days; a window longer than that outlives its own fixtures. */
+export declare const MAX_TESTER_WINDOW_MINUTES: number;
+/**
+ * Length of the testing window, in minutes.
+ *
+ * Read at call time rather than captured at module scope so a caller that sets the
+ * env var before importing a seed file still wins. Anything unparseable, non-finite
+ * or out of range falls back to the default rather than throwing: a malformed env
+ * var must not be able to brick `appkit-seed load`.
+ */
+export declare function windowMinutes(): number;
+/**
+ * A point `fraction` of the way through the window, measured from now.
+ *
+ * `windowOffset(0)` is now, `windowOffset(1)` is the window's end. Fractions above 1
+ * are allowed and mean "after this run" — that is how a fixture says "still open when
+ * testing finishes" without hard-coding a duration.
+ */
+export declare function windowOffset(fraction: number): Date;
+/** The mirror of windowOffset, into the past — for fixtures that must already be closed. */
+export declare function windowAgo(fraction: number): Date;

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

@@ -0,0 +1,66 @@
+/*
+ * WHY: Every time-bound tester fixture — auction end dates, coupon validity, event
+ *      start/end, prize-draw reveal windows, offer expiry, lottery draw windows —
+ *      must open and close INSIDE one testing session. Hand-written offsets like
+ *      `Date.now() + 2 * 60 * 60 * 1000` cannot do that: they bake in a duration
+ *      nobody can shorten, so a case reading "watch the auction actually end" is
+ *      untestable without sitting there for two hours.
+ *
+ *      This file is the one knob. Fixtures express WHEN as a fraction of the run
+ *      window; the window's real length comes from TESTER_WINDOW_MINUTES.
+ *
+ * WHAT: windowMinutes() / windowOffset(fraction) / windowAgo(fraction).
+ *
+ * 🛑 The default is 180 minutes ON PURPOSE — it reproduces the pre-existing 1h/2h/3h
+ *    auction stagger exactly (fractions 1/3, 2/3, 1), so an ordinary `appkit-seed load`
+ *    behaves as it always has. Only the automated runner shortens it. Changing this
+ *    default silently re-times every fixture for human testers too.
+ *
+ * @tag domain:tester
+ * @tag layer:seed
+ * @tag pattern:none
+ * @tag access:server-only
+ * @tag consumers:seed-data/*-tester-seed-data.ts
+ * @tag sideEffects:none
+ */
+/** Reproduces the historical 1h/2h/3h auction stagger when nothing overrides it. */
+export const DEFAULT_TESTER_WINDOW_MINUTES = 180;
+/** Below this nothing is observable — a page load alone can outlast it. */
+export const MIN_TESTER_WINDOW_MINUTES = 5;
+/** The sandbox TTL is 7 days; a window longer than that outlives its own fixtures. */
+export const MAX_TESTER_WINDOW_MINUTES = 7 * 24 * 60;
+/**
+ * Length of the testing window, in minutes.
+ *
+ * Read at call time rather than captured at module scope so a caller that sets the
+ * env var before importing a seed file still wins. Anything unparseable, non-finite
+ * or out of range falls back to the default rather than throwing: a malformed env
+ * var must not be able to brick `appkit-seed load`.
+ */
+export function windowMinutes() {
+    const raw = process.env.TESTER_WINDOW_MINUTES;
+    if (!raw)
+        return DEFAULT_TESTER_WINDOW_MINUTES;
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed))
+        return DEFAULT_TESTER_WINDOW_MINUTES;
+    if (parsed < MIN_TESTER_WINDOW_MINUTES)
+        return MIN_TESTER_WINDOW_MINUTES;
+    if (parsed > MAX_TESTER_WINDOW_MINUTES)
+        return MAX_TESTER_WINDOW_MINUTES;
+    return parsed;
+}
+/**
+ * A point `fraction` of the way through the window, measured from now.
+ *
+ * `windowOffset(0)` is now, `windowOffset(1)` is the window's end. Fractions above 1
+ * are allowed and mean "after this run" — that is how a fixture says "still open when
+ * testing finishes" without hard-coding a duration.
+ */
+export function windowOffset(fraction) {
+    return new Date(Date.now() + fraction * windowMinutes() * 60000);
+}
+/** The mirror of windowOffset, into the past — for fixtures that must already be closed. */
+export function windowAgo(fraction) {
+    return windowOffset(-fraction);
+}

package/dist/index.d.ts

@@ -1095,7 +1095,6 @@ export { AdminReviewsView } from "./features/admin/index";
 export { AdminSectionsView } from "./features/admin/index";
 export { AdminSessionsManager } from "./features/admin/index";
 export { AdminSidebar } from "./features/admin/index";
-export { AdminSiteView } from "./features/admin/index";
 export { AdminSublistingCategoriesView } from "./features/admin/index";
 export { AdminSublistingCategoryEditorView } from "./features/admin/index";
 export type { AdminSublistingCategoryEditorViewProps } from "./features/admin/index";
@@ -1198,7 +1197,6 @@ export type { AdminReviewsViewProps } from "./features/admin/index";
 export type { AdminSectionsViewProps } from "./features/admin/index";
 export type { AdminSessionsManagerProps } from "./features/admin/index";
 export type { AdminSidebarProps } from "./features/admin/index";
-export type { AdminSiteViewProps } from "./features/admin/index";
 export type { AdminSiteSettingsViewProps } from "./features/admin/index";
 export type { AdminStatCardProps } from "./features/admin/index";
 export type { AdminStoresViewProps } from "./features/admin/index";
@@ -2175,6 +2173,7 @@ export { RefundHistoryTable } from "./features/orders/index";
 export type { RefundHistoryTableProps } from "./features/orders/index";
 export { RefundRequestView } from "./features/orders/index";
 export type { RefundRequestViewProps } from "./features/orders/index";
+export type { RefundRequestSubmission } from "./features/orders/components/RefundRequestView";
 export { PaymentGatewayValues } from "./features/orders/index";
 export { PaymentMethodValues } from "./features/orders/index";
 export { OutOfStockPolicyValues } from "./features/orders/index";
@@ -2386,6 +2385,7 @@ export { getProductFilterKeys } from "./features/products/index";
 export { getProductSortOptions } from "./features/products/index";
 export { getProductTableColumns } from "./features/products/index";
 export { normalizeListingType, isAuctionListing, isPreOrderListing, isStandardListing, isPrizeDrawListing, isClassifiedListing, isDigitalCodeListing, isLiveListing, isArtListing, isStickersListing, } from "./features/products/index";
+export { isFinalSale, acceptsChangeOfMindReturns, } from "./features/products/constants/final-sale";
 export { isListingTypeEnabled, isCategoryTypeEnabled, enabledListingTypes, enabledCategoryTypes, ALL_LISTING_TYPES, } from "./_internal/shared/listing-types/feature-flags";
 export { actionTracker, setActionTrackerSink, resetActionTrackerSink, type ActionEvent, type ActionTrackerSink, } from "./_internal/shared/listing-types/action-tracker";
 export { cartRequiresShipping, cartIsDigitalOnly, cartIsChatOnly, } from "./_internal/shared/listing-types/cart-shipping";
@@ -3072,6 +3072,8 @@ export type { BundleQueryRule } from "./features/categories/schemas/firestore";
 export { BUNDLE_MIN_ITEMS, BUNDLE_MAX_ITEMS, BUNDLE_MAX_PER_USER_DEFAULT, BUNDLES_PAGE_SIZE, BUNDLES_FEATURED_LIMIT, } from "./_internal/shared/features/categories/bundle-config";
 export { BUNDLE_COPY, BUNDLE_STOCK_VARIANT, } from "./_internal/shared/features/categories/bundle-copy";
 export { REFUND_COPY } from "./_internal/shared/features/orders/refund-copy";
+export { RETURN_REASON, FINAL_SALE_EXEMPT_REASONS, RETURN_REASON_LABEL, RETURN_REASON_GROUP_LABEL, isFinalSaleExempt, isReturnReason, selectableReturnReasons, } from "./_internal/shared/features/orders/return-reasons";
+export type { ReturnReason } from "./_internal/shared/features/orders/return-reasons";
 export { bundleCreateSchema, bundleUpdateSchema, bundleQueryRuleSchema, bundleDisplaySchema, type BundleCreateBody, type BundleUpdateBody, } from "./_internal/shared/features/categories/bundle-schemas";
 export type { GroupedListingDocument, GroupTheme, GroupVisibility } from "./features/grouped/schemas/firestore";
 export { navItemFormSchema, navItemCreateSchema, navItemUpdateSchema, type NavItemFormValues, } from "./features/admin/schemas/nav-item-form";
@@ -3144,7 +3146,7 @@ export { LISTING_TYPE_REGISTRY, pluginFor, detectListingTypeFromSlug } from "./_
 export type { ListingTypePlugin } from "./_internal/shared/listing-types/_registry";
 export { getListingRule, getCategoryRule, pickOrderType, getSplitKey, runSyncPreflight, CHECKOUT_RULES, CATEGORY_CHECKOUT_RULES, CHECKOUT_MAX_ORDERS_PER_TX, PRIZE_DRAW_MAX_REVEALS_PER_ORDER, BUNDLE_MAX_QTY_PER_TX, STANDARD_MAX_QTY_PER_LINE, } from "./_internal/shared/checkout/rules";
 export type { ListingCheckoutRule, CategoryCheckoutRule, CartItemProductPair, OrderItemInput, RefundPolicy, } from "./_internal/shared/checkout/rules";
-export { MEGABYTE, MAX_IMAGE_BYTES, MAX_PDF_BYTES, MAX_VIDEO_BYTES, MAX_LABEL, MAX_BYTES, ALLOWED_IMAGE_MIMES, ALLOWED_VIDEO_MIMES, ALLOWED_DOC_MIMES, ALLOWED_MIMES, ALLOWED_TYPES_LABEL, MIME_TO_EXT, PDF_MAGIC, VIDEO_CONVERSION_HINTS, classifyMime, isAllowedMime, maxBytesFor, getConversionHint, } from "./_internal/shared/media/limits";
+export { MEGABYTE, MAX_IMAGE_BYTES, MAX_PDF_BYTES, MAX_VIDEO_BYTES, MAX_LABEL, MAX_BYTES, ALLOWED_IMAGE_MIMES, ALLOWED_VIDEO_MIMES, ALLOWED_DOC_MIMES, ALLOWED_MIMES, ALLOWED_TYPES_LABEL, MIME_TO_EXT, PDF_MAGIC, VIDEO_CONVERSION_HINTS, classifyMime, isAllowedMime, maxBytesFor, getConversionHint, PRODUCT_MAX_IMAGES, PRODUCT_MAX_VIDEOS, PRODUCT_IMAGE_INDEX_MAX, } from "./_internal/shared/media/limits";
 export type { MediaKind, AllowedImageMime, AllowedVideoMime, AllowedDocMime, AllowedMime, } from "./_internal/shared/media/limits";
 export { PRODUCT_FIELDS, PRODUCT_STATUS_TRANSITIONS, ORDER_FIELDS, REVIEW_FIELDS, BID_FIELDS, AD_FIELDS, AD_TRACKED_FIELDS, BLOG_FIELDS, BRAND_FIELDS, WISHLIST_FIELDS, HISTORY_FIELDS, COUPON_USAGE_FIELDS, CAROUSEL_FIELDS, FAQ_FIELDS, HOMEPAGE_SECTION_FIELDS, SITE_SETTINGS_FIELDS, COMMON_FIELDS, OAUTH_STATE_VALUES, SCHEMA_DEFAULTS, } from "./constants/field-names";
 export { SORT_DIR, sortBy } from "./constants/sort";
@@ -3226,3 +3228,4 @@ export { ROLES_TABS, isRolesTabId, ADMIN_SETTINGS_TABS, isAdminSettingsTabId, }
 export type { AdminPageTab, RolesTabId, AdminSettingsTabId, } from "./features/admin/constants/admin-page-tabs";
 export { validateActionIndexEntry, normaliseRoute, } from "./features/search/action-index/validate-entry";
 export type { ActionIndexValidationContext, ActionIndexValidationIssue, } from "./features/search/action-index/validate-entry";
+export { draftToProductInput, productToDraft, } from "./features/seller/utils/product-draft-mapping";

package/dist/index.js

@@ -2126,8 +2126,6 @@ export { AdminSessionsManager } from "./features/admin/index";
 // AdminSidebar - Shared export for admin sidebar.
 export { AdminSidebar } from "./features/admin/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
-// AdminSiteView - Component for admin site view.
-export { AdminSiteView } from "./features/admin/index";
 // AdminSublistingCategoriesView - Admin list view for sublisting categories (SC1).
 export { AdminSublistingCategoriesView } from "./features/admin/index";
 // AdminSublistingCategoryEditorView - Admin create/edit form for sublisting categories (SC1).
@@ -4367,6 +4365,9 @@ export { getProductTableColumns } from "./features/products/index";
 // normalizeListingType + predicate helpers â€" canonical SB1-G accessors.
 // SB-UNI-F 2026-05-13 â€" Phase 2 predicates added (classified/digital-code/live).
 export { normalizeListingType, isAuctionListing, isPreOrderListing, isStandardListing, isPrizeDrawListing, isClassifiedListing, isDigitalCodeListing, isLiveListing, isArtListing, isStickersListing, } from "./features/products/index";
+// Final sale — ABSENT MEANS TRUE, so these are the only legal reads of the
+// `finalSale` field. See the module docstring for why `!p.finalSale` is wrong.
+export { isFinalSale, acceptsChangeOfMindReturns, } from "./features/products/constants/final-sale";
 // SB-UNI-X4 2026-05-13 â€" per-type feature-flag helpers.
 export { isListingTypeEnabled, isCategoryTypeEnabled, enabledListingTypes, enabledCategoryTypes, ALL_LISTING_TYPES, } from "./_internal/shared/listing-types/feature-flags";
 // SB-UNI-X5 2026-05-13 â€" action telemetry sink.
@@ -5454,6 +5455,10 @@ export { BUNDLE_MIN_ITEMS, BUNDLE_MAX_ITEMS, BUNDLE_MAX_PER_USER_DEFAULT, BUNDLE
 export { BUNDLE_COPY, BUNDLE_STOCK_VARIANT, } from "./_internal/shared/features/categories/bundle-copy";
 // S-SBUNI-RULES 2026-05-13 â€" shared copy for refund / shipping / sibling-payment UI.
 export { REFUND_COPY } from "./_internal/shared/features/orders/refund-copy";
+// Return / refund reasons — the closed enum the final-sale gate branches on.
+// See the module docstring for why the exempt set is "seller or carrier fault"
+// rather than "serious reasons".
+export { RETURN_REASON, FINAL_SALE_EXEMPT_REASONS, RETURN_REASON_LABEL, RETURN_REASON_GROUP_LABEL, isFinalSaleExempt, isReturnReason, selectableReturnReasons, } from "./_internal/shared/features/orders/return-reasons";
 // S-SBUNI-4 follow-up â€" shared admin bundle zod schemas.
 export { bundleCreateSchema, bundleUpdateSchema, bundleQueryRuleSchema, bundleDisplaySchema, } from "./_internal/shared/features/categories/bundle-schemas";
 export { navItemFormSchema, navItemCreateSchema, navItemUpdateSchema, } from "./features/admin/schemas/nav-item-form";
@@ -5520,7 +5525,7 @@ export { LISTING_TYPE_REGISTRY, pluginFor, detectListingTypeFromSlug } from "./_
 // Checkout rule registry â€" pure TS, safe in both client and server bundles.
 export { getListingRule, getCategoryRule, pickOrderType, getSplitKey, runSyncPreflight, CHECKOUT_RULES, CATEGORY_CHECKOUT_RULES, CHECKOUT_MAX_ORDERS_PER_TX, PRIZE_DRAW_MAX_REVEALS_PER_ORDER, BUNDLE_MAX_QTY_PER_TX, STANDARD_MAX_QTY_PER_LINE, } from "./_internal/shared/checkout/rules";
 // Media upload limits â€" pure constants, safe in both client and server bundles.
-export { MEGABYTE, MAX_IMAGE_BYTES, MAX_PDF_BYTES, MAX_VIDEO_BYTES, MAX_LABEL, MAX_BYTES, ALLOWED_IMAGE_MIMES, ALLOWED_VIDEO_MIMES, ALLOWED_DOC_MIMES, ALLOWED_MIMES, ALLOWED_TYPES_LABEL, MIME_TO_EXT, PDF_MAGIC, VIDEO_CONVERSION_HINTS, classifyMime, isAllowedMime, maxBytesFor, getConversionHint, } from "./_internal/shared/media/limits";
+export { MEGABYTE, MAX_IMAGE_BYTES, MAX_PDF_BYTES, MAX_VIDEO_BYTES, MAX_LABEL, MAX_BYTES, ALLOWED_IMAGE_MIMES, ALLOWED_VIDEO_MIMES, ALLOWED_DOC_MIMES, ALLOWED_MIMES, ALLOWED_TYPES_LABEL, MIME_TO_EXT, PDF_MAGIC, VIDEO_CONVERSION_HINTS, classifyMime, isAllowedMime, maxBytesFor, getConversionHint, PRODUCT_MAX_IMAGES, PRODUCT_MAX_VIDEOS, PRODUCT_IMAGE_INDEX_MAX, } from "./_internal/shared/media/limits";
 // ── Field name constants — canonical source of truth for all Firestore field names ──
 // NOTE: STORE_FIELDS, CATEGORY_FIELDS, EVENT_FIELDS, EVENT_ENTRY_FIELDS, PAYOUT_FIELDS,
 // COUPON_FIELDS, CART_FIELDS, USER_FIELDS, ADDRESS_FIELDS, NOTIFICATION_FIELDS,
@@ -5629,3 +5634,7 @@ export { SITE_SETTINGS_TABS, SITE_SETTINGS_TAB_IDS, isSiteSettingsTabId, } from
 export { PAYOUTS_TABS, isPayoutsTabId, SHIPPING_TABS, isShippingTabId, FULFILLMENT_TABS, isFulfillmentTabId, STOREFRONT_TABS, isStorefrontTabId, } from "./features/seller/constants/store-tabs";
 export { ROLES_TABS, isRolesTabId, ADMIN_SETTINGS_TABS, isAdminSettingsTabId, } from "./features/admin/constants/admin-page-tabs";
 export { validateActionIndexEntry, normaliseRoute, } from "./features/search/action-index/validate-entry";
+// Seller listing form draft <-> product write payload. The flat form keys and
+// the nested document blocks are different shapes, and nothing translated
+// between them — see the module docstring.
+export { draftToProductInput, productToDraft, } from "./features/seller/utils/product-draft-mapping";

package/dist/next/routing/route-map.d.ts

@@ -146,6 +146,7 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly ORDER_DETAIL: (id: string) => string;
         readonly ORDER_CANCEL: (id: string) => string;
         readonly ORDER_TRACK: (id: string) => string;
+        readonly ORDER_RETURN: (id: string) => string;
         readonly ORDER_INVOICE: (id: string) => string;
         readonly ORDER_PAYMENT: (id: string) => string;
         readonly NOTIFICATIONS: "/user/notifications";
@@ -549,6 +550,7 @@ export declare const ROUTES: {
         readonly ORDER_DETAIL: (id: string) => string;
         readonly ORDER_CANCEL: (id: string) => string;
         readonly ORDER_TRACK: (id: string) => string;
+        readonly ORDER_RETURN: (id: string) => string;
         readonly ORDER_INVOICE: (id: string) => string;
         readonly ORDER_PAYMENT: (id: string) => string;
         readonly NOTIFICATIONS: "/user/notifications";

package/dist/next/routing/route-map.js

@@ -150,6 +150,7 @@ export const DEFAULT_ROUTE_MAP = {
         ORDER_DETAIL: (id) => `/user/orders/view/${id}`,
         ORDER_CANCEL: (id) => `/user/orders/${id}/cancel`,
         ORDER_TRACK: (id) => `/user/orders/${id}/track`,
+        ORDER_RETURN: (id) => `/user/orders/${id}/return`,
         ORDER_INVOICE: (id) => `/user/orders/${id}/invoice`,
         ORDER_PAYMENT: (id) => `/user/orders/${id}/payment`,
         NOTIFICATIONS: "/user/notifications",