@mohasinac/appkit 4.14.0 → 4.15.0

package/dist/schemas/registry.js

@@ -96,8 +96,56 @@ const api = {
 // `audit-form-schema` already enforces presence at FormShell sites; this
 // registry centralizes the schemas for cross-route reuse.
 // ---------------------------------------------------------------------------
+/**
+ * Entity id -> the form schema that validates it.
+ *
+ * Populated one entity per slice from W4 on. Deliberately NOT pre-declared
+ * with placeholder keys: an empty bucket is honest, and a bucket full of
+ * `undefined` reads as "migrated" to everyone who comes after — this codebase
+ * already documents eight abandoned migrations that started exactly that way.
+ *
+ * `roundtrip-diff` reads this. An entity registered here is checked, on every
+ * run, against real documents for silent field loss; an entity absent from it
+ * has no such protection, which is the whole reason to register early.
+ */
+import { blogDraftSchema } from "../features/blog/schemas/blog-form";
+import { eventDraftSchema } from "../features/events/schemas/event-form";
+import { productFeatureFormSchema } from "../features/products/schemas/product-features.validators";
+import { storeCategoryFormSchema } from "../features/store-extensions/schemas/store-category-form";
+import { listingTemplateFormSchema } from "../features/store-extensions/schemas/listing-template-form";
+import { payoutMethodFormSchema } from "../features/store-extensions/schemas/payout-method-form";
+import { shippingConfigFormSchema } from "../features/store-extensions/schemas/shipping-config-form";
+import { groupedListingFormSchema } from "../features/grouped/schemas/grouped-listing-form";
+import { sellerCouponFormSchema } from "../features/seller/schemas/coupon-form";
+import { customRoleFormSchema } from "../features/store-extensions/schemas/custom-role-form";
+import { moderationReviewFormSchema } from "../features/store-extensions/schemas/moderation-review-form";
+import { reportReviewFormSchema } from "../features/store-extensions/schemas/report-review-form";
+import { reportCreateSchema } from "../features/store-extensions/schemas/report-create-form";
+import { itemRequestCreateSchema } from "../features/store-extensions/schemas/item-request-create-form";
+import { analyticsAlertCreateSchema, analyticsCardCreateSchema, } from "../features/store-extensions/schemas/analytics-forms";
+import { storeGoogleConfigUpdateSchema } from "../features/store-extensions/schemas/google-config-form";
+import { adminNotificationCreateSchema } from "../features/store-extensions/schemas/admin-notification-form";
+import { homepageSectionCreateSchema } from "../features/homepage/schemas/index";
 const forms = {
-// Populated in W5 as section builders + admin forms are tightened.
+    blog: blogDraftSchema,
+    event: eventDraftSchema,
+    productFeature: productFeatureFormSchema,
+    storeCategory: storeCategoryFormSchema,
+    listingTemplate: listingTemplateFormSchema,
+    payoutMethod: payoutMethodFormSchema,
+    shippingConfig: shippingConfigFormSchema,
+    groupedListing: groupedListingFormSchema,
+    sellerCoupon: sellerCouponFormSchema,
+    customRole: customRoleFormSchema,
+    moderationReview: moderationReviewFormSchema,
+    reportReview: reportReviewFormSchema,
+    reportCreate: reportCreateSchema,
+    itemRequest: itemRequestCreateSchema,
+    analyticsAlert: analyticsAlertCreateSchema,
+    analyticsCard: analyticsCardCreateSchema,
+    storeGoogleConfig: storeGoogleConfigUpdateSchema,
+    adminNotification: adminNotificationCreateSchema,
+    homepageSection: homepageSectionCreateSchema,
 };
 // ---------------------------------------------------------------------------
 // Sieve filter-grammar schemas — populated by W6. Each collection registers
@@ -161,6 +209,21 @@ export function lookupApiSchema(key) {
     }
     return entry;
 }
+/**
+ * The form schema for an entity.
+ *
+ * Throws rather than returning undefined: a caller asking for a schema it
+ * expects to exist should fail loudly at the call site, not silently skip
+ * validation and strip every field on the next save.
+ */
+export function lookupFormSchema(entity) {
+    const entry = SCHEMAS.forms[entity];
+    if (!entry) {
+        throw new Error(`[schemas] No form schema registered for "${String(entity)}". ` +
+            `Register it in SCHEMAS.forms as part of that entity's slice.`);
+    }
+    return entry;
+}
 export function lookupFirestoreSchema(collection) {
     const entry = SCHEMAS.firestore[collection];
     if (!entry) {

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

@@ -143,5 +143,35 @@ const _rawBidsSeedData = [
         currentBid: 1450,
         bidderIds: ["user-ananya-collector", "user-rohit-collector", "user-meera-bey"],
     }),
+    // auction-beyblade-burst-spriggan-requiem-bought-out — a BUYOUT ended it.
+    //
+    // Three competitive bids that lost, then the buyout that won. A buyout is a
+    // real BidDocument (`isBuyout: true`) — it is not a bid-free purchase, which
+    // is why the order's `sourceContext.bidCount` is 3 rather than 0: the buyout
+    // itself is excluded from the "against N bidders" figure, the three it beat
+    // are not. `standingBidAtBuyout` is read from these bids and NOT from
+    // `product.currentBid`, because a pending buyout never writes that mirror.
+    ...buildLadder({
+        productId: "auction-beyblade-burst-spriggan-requiem-bought-out",
+        productTitle: "Beyblade Burst B-128 Spriggan Requiem (Ended — Bought Out)",
+        startingBid: 2499,
+        currentBid: 3100,
+        bidderIds: ["user-meera-bey", "user-ananya-collector", "user-rohit-collector"],
+        closed: true,
+    }).map((b) => ({ ...b, status: "lost", isWinning: false })),
+    {
+        id: "bid-beyblade-burst-spriggan-requiem-seto-kaiba-20260820-buyout",
+        productId: "auction-beyblade-burst-spriggan-requiem-bought-out",
+        productTitle: "Beyblade Burst B-128 Spriggan Requiem (Ended — Bought Out)",
+        userId: "user-seto-kaiba",
+        userName: "Mock User 2",
+        bidAmount: 4999,
+        status: "won",
+        isWinning: true,
+        isBuyout: true,
+        bidDate: daysAgo(4),
+        createdAt: daysAgo(4),
+        orderId: "order-1-20260820-buyout",
+    },
 ];
 export const bidsSeedData = _rawBidsSeedData.map(withBidDefaults);

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

@@ -1,6 +1,29 @@
 /*
- * WHY: Seeds offers for the Beyblade marketplace — 8 offers across all statuses.
- * WHAT: pending (2), accepted (1), declined (1), countered (1), expired (1), withdrawn (1), paid (1).
+ * WHY: Seeds offers for the Beyblade marketplace — every status, plus a real
+ *      multi-round negotiation. Before W2 a counter-offer created an unlinked
+ *      document, so no fixture could demonstrate a chain and the timeline had
+ *      nothing to render.
+ * WHAT: 10 offers. pending (2), accepted (1), declined (1), countered (1),
+ *       expired (1), withdrawn (3 — one a genuine walk-away, two superseded
+ *       rounds of the Metal Storm Pegasus chain), paid (1).
+ *
+ * ## The Metal Storm Pegasus chain
+ *
+ * Three linked documents ending at the pre-existing `…-countered` id, so the
+ * final round keeps the id every other fixture and checklist case already
+ * refers to and `appkit-seed delete` still cleans the whole chain up:
+ *
+ *   …-r1 (withdrawn, superseded by r2) → …-r2 (withdrawn, superseded by the
+ *   countered offer) → …-countered (round 3, live)
+ *
+ * Two withdrawn plus one live keeps `hasActiveOffer` consistent, and three
+ * rounds makes the 3-offer chain cap demonstrable.
+ *
+ * ## One fixture deliberately has NO statusHistory
+ *
+ * `offer-kaiba-x-wizard-arrow-expired` is left history-less on purpose — see
+ * the comment at that fixture. It is the only way the timeline's legacy branch
+ * is testable, and it is the exact shape of every offer written before W2.
  *
  * EXPORTS:
  *   offersSeedData — Array of Partial<OfferDocument> for seed runner
@@ -16,6 +39,23 @@ import { OfferStatusValues } from "../features/seller/schemas/firestore";
 const NOW = new Date();
 const daysAgo = (n) => new Date(NOW.getTime() - n * 86400000);
 const daysFromNow = (n) => new Date(NOW.getTime() + n * 86400000);
+/**
+ * One history entry, in the same delta shape `withHistory()` produces at
+ * runtime — so a seeded timeline and a real one render identically.
+ *
+ * `actorUid` is the only identity a history entry may ever carry. Never a name
+ * or an email: `encryptPiiFields` is a flat top-level loop that does not
+ * descend into arrays, so a PII value placed inside `statusHistory` would be
+ * written to Firestore in plaintext and never decrypted on the way back out.
+ */
+function entry(at, actorRole, trigger, changes, extra = {}) {
+    return { at, actorRole, trigger, changes, ...extra };
+}
+const BUYER_YUGI = "user-yugi-muto";
+const BUYER_KAIBA = "user-seto-kaiba";
+const BUYER_ADMIN = "user-admin-letitrip";
+const STORE = "store-beyblade-arena";
+const PEGASUS_CHAIN_ROOT = "offer-yugi-metal-storm-pegasus-r1";
 export const offersSeedData = [
     // ── 1. PENDING — Rehan → Beyblade Arena — Burst Valkyrie ────────────────
     {
@@ -35,6 +75,12 @@ export const offersSeedData = [
         expiresAt: daysFromNow(3),
         createdAt: daysAgo(0),
         updatedAt: daysAgo(0),
+        statusHistory: [
+            entry(daysAgo(0), "buyer", "makeOffer", {
+                status: { from: null, to: "pending" },
+                offerAmount: { from: null, to: 780 },
+            }, { actorUid: BUYER_YUGI, note: "Would you accept ₹780 for the Burst Valkyrie?" }),
+        ],
     },
     // ── 2. COUNTERED — Rehan → Beyblade Arena — Metal Storm Pegasus ─────────
     {
@@ -57,6 +103,107 @@ export const offersSeedData = [
         respondedAt: daysAgo(1),
         createdAt: daysAgo(3),
         updatedAt: daysAgo(1),
+        // Round 3 — the live end of the chain. Keeping the original id here (rather
+        // than appending an `…-r3`) means every existing reference and checklist
+        // href still resolves, and `appkit-seed delete` still removes the lot.
+        previousOfferId: "offer-yugi-metal-storm-pegasus-r2",
+        chainRootOfferId: PEGASUS_CHAIN_ROOT,
+        counterRound: 3,
+        statusHistory: [
+            entry(daysAgo(3), "buyer", "counterOfferByBuyer", {
+                status: { from: null, to: "pending" },
+                offerAmount: { from: 900, to: 1000 },
+                previousOfferId: { from: null, to: "offer-yugi-metal-storm-pegasus-r2" },
+            }, { actorUid: BUYER_YUGI, note: "₹1,000 — will you take it?" }),
+            entry(daysAgo(1), "seller", "respondToOffer:counter", {
+                status: { from: "pending", to: "countered" },
+                counterAmount: { from: null, to: 1150 },
+            }, { actorUid: STORE, note: "Best I can do is ₹1,150." }),
+        ],
+    },
+    // ── 2a. Metal Storm Pegasus — ROUND 1 (superseded, not a walk-away) ─────
+    {
+        id: PEGASUS_CHAIN_ROOT,
+        productId: "product-beyblade-metal-storm-pegasus",
+        productTitle: "Beyblade Metal Storm Pegasus",
+        storeId: STORE,
+        storeName: "Beyblade Arena",
+        buyerUid: BUYER_YUGI,
+        buyerName: "Mock User 3",
+        buyerEmail: "rehan.sheikh@gmail.com",
+        listedPrice: 1299,
+        offerAmount: 800,
+        counterAmount: 1200,
+        currency: "INR",
+        // `withdrawn` PLUS `supersededByOfferId` is what makes the timeline render
+        // this round neutral ("Superseded") instead of negative ("Withdrawn").
+        // `superseded` is a render key, deliberately never an eighth OfferStatus —
+        // an eighth value would add a filter chip matching zero stored rows.
+        status: OfferStatusValues.WITHDRAWN,
+        buyerNote: "Starting at ₹800 for the Storm Pegasus.",
+        sellerNote: "₹1,200 and it's yours.",
+        expiresAt: daysAgo(6),
+        respondedAt: daysAgo(7),
+        createdAt: daysAgo(9),
+        updatedAt: daysAgo(7),
+        supersededByOfferId: "offer-yugi-metal-storm-pegasus-r2",
+        chainRootOfferId: PEGASUS_CHAIN_ROOT,
+        counterRound: 1,
+        statusHistory: [
+            entry(daysAgo(9), "buyer", "makeOffer", {
+                status: { from: null, to: "pending" },
+                offerAmount: { from: null, to: 800 },
+            }, { actorUid: BUYER_YUGI, note: "Starting at ₹800 for the Storm Pegasus." }),
+            entry(daysAgo(8), "seller", "respondToOffer:counter", {
+                status: { from: "pending", to: "countered" },
+                counterAmount: { from: null, to: 1200 },
+            }, { actorUid: STORE, note: "₹1,200 and it's yours." }),
+            entry(daysAgo(7), "buyer", "counterOfferByBuyer:supersede", {
+                status: { from: "countered", to: "withdrawn" },
+                supersededByOfferId: { from: null, to: "offer-yugi-metal-storm-pegasus-r2" },
+            }, { actorUid: BUYER_YUGI, reason: "Superseded by the buyer's counter" }),
+        ],
+    },
+    // ── 2b. Metal Storm Pegasus — ROUND 2 (superseded) ──────────────────
+    {
+        id: "offer-yugi-metal-storm-pegasus-r2",
+        productId: "product-beyblade-metal-storm-pegasus",
+        productTitle: "Beyblade Metal Storm Pegasus",
+        storeId: STORE,
+        storeName: "Beyblade Arena",
+        buyerUid: BUYER_YUGI,
+        buyerName: "Mock User 3",
+        buyerEmail: "rehan.sheikh@gmail.com",
+        listedPrice: 1299,
+        offerAmount: 900,
+        counterAmount: 1175,
+        currency: "INR",
+        status: OfferStatusValues.WITHDRAWN,
+        buyerNote: "Can you meet me at ₹900?",
+        sellerNote: "₹1,175 is as low as I can go.",
+        expiresAt: daysAgo(3),
+        respondedAt: daysAgo(3),
+        createdAt: daysAgo(7),
+        updatedAt: daysAgo(3),
+        previousOfferId: PEGASUS_CHAIN_ROOT,
+        supersededByOfferId: "offer-yugi-metal-storm-pegasus-countered",
+        chainRootOfferId: PEGASUS_CHAIN_ROOT,
+        counterRound: 2,
+        statusHistory: [
+            entry(daysAgo(7), "buyer", "counterOfferByBuyer", {
+                status: { from: null, to: "pending" },
+                offerAmount: { from: 800, to: 900 },
+                previousOfferId: { from: null, to: PEGASUS_CHAIN_ROOT },
+            }, { actorUid: BUYER_YUGI, note: "Can you meet me at ₹900?" }),
+            entry(daysAgo(4), "seller", "respondToOffer:counter", {
+                status: { from: "pending", to: "countered" },
+                counterAmount: { from: null, to: 1175 },
+            }, { actorUid: STORE, note: "₹1,175 is as low as I can go." }),
+            entry(daysAgo(3), "buyer", "counterOfferByBuyer:supersede", {
+                status: { from: "countered", to: "withdrawn" },
+                supersededByOfferId: { from: null, to: "offer-yugi-metal-storm-pegasus-countered" },
+            }, { actorUid: BUYER_YUGI, reason: "Superseded by the buyer's counter" }),
+        ],
     },
     // ── 3. PAID — Admin → Beyblade Arena — X Knife Shinobi (order placed) ───
     {
@@ -81,6 +228,19 @@ export const offersSeedData = [
         respondedAt: daysAgo(12),
         createdAt: daysAgo(14),
         updatedAt: daysAgo(11),
+        statusHistory: [
+            entry(daysAgo(14), "buyer", "makeOffer", {
+                status: { from: null, to: "pending" },
+                offerAmount: { from: null, to: 800 },
+            }, { actorUid: BUYER_ADMIN, note: "Would you accept ₹800 for the X Knife Shinobi?" }),
+            entry(daysAgo(12), "seller", "respondToOffer:accept", {
+                status: { from: "pending", to: "accepted" },
+                lockedPrice: { from: null, to: 800 },
+            }, { actorUid: STORE, note: "Accepted. Thank you!" }),
+            entry(daysAgo(11), "system", "finalizeLockedLines", {
+                status: { from: "accepted", to: "paid" },
+            }),
+        ],
     },
     // ── 4. DECLINED — Rehan → Beyblade Arena — Burst Regalia Genesis ────────
     {
@@ -96,12 +256,23 @@ export const offersSeedData = [
         offerAmount: 1050,
         currency: "INR",
         status: OfferStatusValues.DECLINED,
-        buyerNote: "Offering ₹2,500 — slightly above my budget.",
-        sellerNote: "Sorry, we cannot go below ₹3,200 for this piece.",
+        // Both notes quoted prices from the pre-Beyblade catalogue this seed was
+        // narrowed away from, so a ₹1,050 offer read as "offering ₹2,500".
+        buyerNote: "Offering ₹1,050 — slightly above my budget.",
+        sellerNote: "Sorry, we cannot go below ₹1,300 for this piece.",
         expiresAt: daysAgo(5),
         respondedAt: daysAgo(8),
         createdAt: daysAgo(10),
         updatedAt: daysAgo(8),
+        statusHistory: [
+            entry(daysAgo(10), "buyer", "makeOffer", {
+                status: { from: null, to: "pending" },
+                offerAmount: { from: null, to: 1050 },
+            }, { actorUid: BUYER_YUGI, note: "Offering ₹1,050 — slightly above my budget." }),
+            entry(daysAgo(8), "seller", "respondToOffer:decline", {
+                status: { from: "pending", to: "declined" },
+            }, { actorUid: STORE, note: "Sorry, we cannot go below ₹1,300 for this piece." }),
+        ],
     },
     // ── 5. EXPIRED — Vivaan → Beyblade Arena — X Wizard Arrow ───────────────
     {
@@ -117,10 +288,16 @@ export const offersSeedData = [
         offerAmount: 700,
         currency: "INR",
         status: OfferStatusValues.EXPIRED,
-        buyerNote: "₹1,300 — let me know.",
+        buyerNote: "₹700 — let me know.",
         expiresAt: daysAgo(2),
         createdAt: daysAgo(9),
         updatedAt: daysAgo(2),
+        // NO `statusHistory`, deliberately. This is the ONLY fixture exercising the
+        // timeline's legacy branch, and it is exactly the shape of every offer
+        // written before W2. Its "Expired" step renders with an em-dash and no
+        // date — `expireMany` never wrote a timestamp, `updatedAt` means "last
+        // write of any kind", and `expiresAt` is a deadline rather than an event,
+        // so any date shown here would be fabricated. Do not "complete" this one.
     },
     // ── 6. WITHDRAWN — Admin → Beyblade Arena — Original Driger V ───────────
     {
@@ -136,10 +313,21 @@ export const offersSeedData = [
         offerAmount: 1450,
         currency: "INR",
         status: OfferStatusValues.WITHDRAWN,
-        buyerNote: "Offering ₹1,600 for the Driger V.",
+        buyerNote: "Offering ₹1,450 for the Driger V.",
         expiresAt: daysAgo(3),
         createdAt: daysAgo(7),
         updatedAt: daysAgo(5),
+        // No `supersededByOfferId` — a genuine walk-away, so this renders as
+        // "Withdrawn" (negative). Contrast with the two Pegasus rounds above.
+        statusHistory: [
+            entry(daysAgo(7), "buyer", "makeOffer", {
+                status: { from: null, to: "pending" },
+                offerAmount: { from: null, to: 1450 },
+            }, { actorUid: BUYER_ADMIN, note: "Offering ₹1,450 for the Driger V." }),
+            entry(daysAgo(5), "buyer", "withdrawOffer", {
+                status: { from: "pending", to: "withdrawn" },
+            }, { actorUid: BUYER_ADMIN }),
+        ],
     },
     // ── 7. ACCEPTED — Vivaan → Beyblade Arena — Original Dranzer S (pending payment) ──
     {
@@ -167,6 +355,17 @@ export const offersSeedData = [
         respondedAt: daysAgo(0),
         createdAt: daysAgo(1),
         updatedAt: daysAgo(0),
+        statusHistory: [
+            entry(daysAgo(1), "buyer", "makeOffer", {
+                status: { from: null, to: "pending" },
+                offerAmount: { from: null, to: 1250 },
+            }, { actorUid: BUYER_KAIBA, note: "₹1,250 final offer on the sealed Dranzer S." }),
+            entry(daysAgo(0), "seller", "respondToOffer:accept", {
+                status: { from: "pending", to: "accepted" },
+                lockedPrice: { from: null, to: 1250 },
+                checkoutDeadline: { from: null, to: daysFromNow(2) },
+            }, { actorUid: STORE, note: "Accepted! Please complete payment within 24 hours." }),
+        ],
     },
     // ── 8. PENDING — Admin → Beyblade Arena — Metal Lightning L-Drago ───────
     {
@@ -182,9 +381,15 @@ export const offersSeedData = [
         offerAmount: 950,
         currency: "INR",
         status: OfferStatusValues.PENDING,
-        buyerNote: "Interested in this piece. Would you accept ₹4,700?",
+        buyerNote: "Interested in this piece. Would you accept ₹950?",
         expiresAt: daysFromNow(3),
         createdAt: daysAgo(1),
         updatedAt: daysAgo(1),
+        statusHistory: [
+            entry(daysAgo(1), "buyer", "makeOffer", {
+                status: { from: null, to: "pending" },
+                offerAmount: { from: null, to: 950 },
+            }, { actorUid: BUYER_ADMIN, note: "Interested in this piece. Would you accept ₹950?" }),
+        ],
     },
 ];