@mohasinac/appkit 4.1.0 → 4.1.1

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

@@ -0,0 +1,2 @@
+import type { BidDocument } from "../../auctions/schemas/firestore";
+export declare const bidsTesterSeedData: Partial<BidDocument>[];

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

@@ -0,0 +1,37 @@
+/*
+ * WHY: Shared tester sandbox — one winning bid on the already-ended auction-tester-sandbox-won
+ *      (kept separate from the still-biddable auction-tester-sandbox-1 so testers can still
+ *      place a live bid on the latter) so testers (and the paired orders-tester-seed-data.ts
+ *      auction-win order) can exercise the "winning an auction creates a payable order" flow.
+ *      Auto-expires in 7 days, cascading with the parent auction product.
+ * WHAT: Exports bidsTesterSeedData — 1 Partial<BidDocument> for the seed runner.
+ *
+ * EXPORTS:
+ *   bidsTesterSeedData — Array of 1 Partial<BidDocument> for the seed runner
+ *
+ * @tag domain:auctions,bids,tester
+ * @tag layer:seed
+ * @tag pattern:none
+ * @tag access:server-only
+ * @tag consumers:seed/index.ts,seed-cli.mjs
+ * @tag sideEffects:none
+ */
+const NOW = new Date();
+const daysAgo = (n) => new Date(NOW.getTime() - n * 86400000);
+export const bidsTesterSeedData = [
+    {
+        id: "bid-tester-sandbox-won-tester-qa",
+        productId: "auction-tester-sandbox-won",
+        productTitle: "Test Auction — Already Won",
+        userId: "user-tester-qa",
+        userName: "QA Tester",
+        userEmail: "tester@letitrip.in",
+        bidAmount: 15000,
+        currency: "INR",
+        status: "won",
+        isWinning: true,
+        bidDate: daysAgo(1),
+        createdAt: daysAgo(1),
+        updatedAt: daysAgo(1),
+    },
+];

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

@@ -0,0 +1,2 @@
+import type { CouponDocument } from "../../promotions/schemas";
+export declare const couponsTesterSeedData: Partial<CouponDocument>[];

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

@@ -0,0 +1,76 @@
+/*
+ * WHY: Shared tester sandbox — 3 disposable test coupons so testers can exercise
+ *      coupon apply/reject edge cases end to end: a perUserLimit:1 admin coupon (to
+ *      verify the second-use rejection), an already-expired admin coupon (to verify
+ *      the expiry rejection), and a seller-scope coupon on store-tester-sandbox.
+ *      NOTE: CouponDocument does not currently carry isTestData/testDataExpiresAt
+ *      (unlike categories/stores/products/blogPosts/events) — testerSandboxCleanup
+ *      does not cascade-delete these. They're small, static, and harmless to leave;
+ *      extending the cleanup script to cover coupons is a follow-up, not blocking.
+ * WHAT: Exports couponsTesterSeedData — 3 Partial<CouponDocument> for the seed runner.
+ *
+ * EXPORTS:
+ *   couponsTesterSeedData — Array of 3 Partial<CouponDocument> for the seed runner
+ *
+ * @tag domain:coupons,tester
+ * @tag layer:seed
+ * @tag pattern:none
+ * @tag access:server-only
+ * @tag consumers:seed/index.ts,seed-cli.mjs
+ * @tag sideEffects:none
+ */
+import { COUPON_FIELDS } from "../../../constants/field-names";
+const NOW = new Date();
+const daysAgo = (n) => new Date(NOW.getTime() - n * 86400000);
+const daysAhead = (n) => new Date(NOW.getTime() + n * 86400000);
+export const couponsTesterSeedData = [
+    {
+        id: "coupon-tester-sandbox-limited",
+        code: "TESTERLIMITED",
+        name: "Tester Sandbox — One Use Per Tester",
+        description: "Disposable test coupon: 10% off, capped at one use per tester. Use it twice to verify the second attempt is rejected.",
+        type: COUPON_FIELDS.TYPE_VALUES.PERCENTAGE,
+        scope: COUPON_FIELDS.SCOPE_VALUES.ADMIN,
+        discount: { value: 10, maxDiscount: 100, minPurchase: 100 },
+        usage: { totalLimit: undefined, perUserLimit: 1, currentUsage: 0 },
+        validity: { startDate: daysAgo(1), endDate: daysAhead(7), isActive: true },
+        restrictions: { firstTimeUserOnly: false, combineWithSellerCoupons: true },
+        createdBy: "user-admin-letitrip",
+        createdAt: daysAgo(1),
+        updatedAt: daysAgo(1),
+        stats: { totalUses: 0, totalRevenue: 0, totalDiscount: 0 },
+    },
+    {
+        id: "coupon-tester-sandbox-expired",
+        code: "TESTEREXPIRED",
+        name: "Tester Sandbox — Already Expired",
+        description: "Disposable test coupon that already expired — applying it at checkout should show a specific expiry rejection.",
+        type: COUPON_FIELDS.TYPE_VALUES.FIXED,
+        scope: COUPON_FIELDS.SCOPE_VALUES.ADMIN,
+        discount: { value: 50, maxDiscount: 50, minPurchase: 100 },
+        usage: { totalLimit: undefined, perUserLimit: 5, currentUsage: 0 },
+        validity: { startDate: daysAgo(30), endDate: daysAgo(1), isActive: true },
+        restrictions: { firstTimeUserOnly: false, combineWithSellerCoupons: true },
+        createdBy: "user-admin-letitrip",
+        createdAt: daysAgo(30),
+        updatedAt: daysAgo(30),
+        stats: { totalUses: 0, totalRevenue: 0, totalDiscount: 0 },
+    },
+    {
+        id: "coupon-tester-sandbox-seller",
+        code: "TESTERSTORE",
+        name: "Tester Sandbox Store — 5% Off",
+        description: "Disposable seller-scope test coupon on the tester sandbox store.",
+        type: COUPON_FIELDS.TYPE_VALUES.PERCENTAGE,
+        scope: COUPON_FIELDS.SCOPE_VALUES.SELLER,
+        storeId: "store-tester-sandbox",
+        discount: { value: 5, maxDiscount: 50, minPurchase: 0 },
+        usage: { totalLimit: undefined, perUserLimit: 3, currentUsage: 0 },
+        validity: { startDate: daysAgo(1), endDate: daysAhead(7), isActive: true },
+        restrictions: { firstTimeUserOnly: false, combineWithSellerCoupons: true },
+        createdBy: "user-admin-letitrip",
+        createdAt: daysAgo(1),
+        updatedAt: daysAgo(1),
+        stats: { totalUses: 0, totalRevenue: 0, totalDiscount: 0 },
+    },
+];

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

@@ -17,6 +17,8 @@
 import { EVENT_FIELDS } from "../../../constants/field-names";
 import { seedExtMedia } from "../../../seed/_helpers/media";
 import { testDataExpiresAt } from "./tester-ttl";
+const TEST_EVENT_COVER_ALT = "Test event cover";
+const TEST_RAFFLE_PRIZE = "Test prize — not a real reward";
 export const eventsTesterSeedData = [
     {
         id: "event-tester-sandbox-spin",
@@ -27,11 +29,11 @@ export const eventsTesterSeedData = [
         status: EVENT_FIELDS.STATUS_VALUES.ACTIVE,
         startsAt: new Date(),
         endsAt: new Date(Date.now() + 7 * 24 * 60 * 60 * 1000),
-        coverImage: { type: "image", url: seedExtMedia("https://picsum.photos/seed/event-cover-tester-sandbox-spin-20260101/1200/600"), alt: "Test event cover" },
+        coverImage: { type: "image", url: seedExtMedia("https://picsum.photos/seed/event-cover-tester-sandbox-spin-20260101/1200/600"), alt: TEST_EVENT_COVER_ALT },
         tags: ["test"],
         hasRaffle: true,
         raffleType: "open_raffle",
-        rafflePrize: "Test prize — not a real reward",
+        rafflePrize: TEST_RAFFLE_PRIZE,
         raffleEntryCount: 0,
         spinPrizes: [
             { id: "spin-tester-win", label: "You Win!", weight: 50, isActive: true },
@@ -47,4 +49,50 @@ export const eventsTesterSeedData = [
         createdAt: new Date(),
         updatedAt: new Date(),
     },
+    {
+        id: "event-tester-sandbox-top-scorers",
+        slug: "tester-sandbox-top-scorers",
+        type: EVENT_FIELDS.TYPE_VALUES.RAFFLE,
+        title: "Tester Sandbox — Top Scorers Raffle",
+        description: "Disposable test event for the tester QA program. Verify top_n_scorers raffle entry and the leaderboard.",
+        status: EVENT_FIELDS.STATUS_VALUES.ACTIVE,
+        startsAt: new Date(),
+        endsAt: new Date(Date.now() + 7 * 24 * 60 * 60 * 1000),
+        coverImage: { type: "image", url: seedExtMedia("https://picsum.photos/seed/event-cover-tester-sandbox-top-scorers-20260101/1200/600"), alt: TEST_EVENT_COVER_ALT },
+        tags: ["test"],
+        hasRaffle: true,
+        raffleType: "top_n_scorers",
+        raffleTopN: 3,
+        rafflePrize: TEST_RAFFLE_PRIZE,
+        raffleEntryCount: 0,
+        stats: { totalEntries: 0, approvedEntries: 0, flaggedEntries: 0 },
+        createdBy: "user-admin-letitrip",
+        isTestData: true,
+        testDataExpiresAt: testDataExpiresAt(),
+        createdAt: new Date(),
+        updatedAt: new Date(),
+    },
+    {
+        id: "event-tester-sandbox-top-participants",
+        slug: "tester-sandbox-top-participants",
+        type: EVENT_FIELDS.TYPE_VALUES.RAFFLE,
+        title: "Tester Sandbox — Top Participants Raffle",
+        description: "Disposable test event for the tester QA program. Verify top_n_participants raffle entry.",
+        status: EVENT_FIELDS.STATUS_VALUES.ACTIVE,
+        startsAt: new Date(),
+        endsAt: new Date(Date.now() + 7 * 24 * 60 * 60 * 1000),
+        coverImage: { type: "image", url: seedExtMedia("https://picsum.photos/seed/event-cover-tester-sandbox-top-participants-20260101/1200/600"), alt: TEST_EVENT_COVER_ALT },
+        tags: ["test"],
+        hasRaffle: true,
+        raffleType: "top_n_participants",
+        raffleTopN: 5,
+        rafflePrize: TEST_RAFFLE_PRIZE,
+        raffleEntryCount: 0,
+        stats: { totalEntries: 0, approvedEntries: 0, flaggedEntries: 0 },
+        createdBy: "user-admin-letitrip",
+        isTestData: true,
+        testDataExpiresAt: testDataExpiresAt(),
+        createdAt: new Date(),
+        updatedAt: new Date(),
+    },
 ];

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

@@ -4,3 +4,6 @@ export { categoriesTesterSeedData } from "./categories-tester-seed-data";
 export { productsTesterSeedData } from "./products-tester-seed-data";
 export { blogTesterSeedData } from "./blog-tester-seed-data";
 export { eventsTesterSeedData } from "./events-tester-seed-data";
+export { couponsTesterSeedData } from "./coupons-tester-seed-data";
+export { bidsTesterSeedData } from "./bids-tester-seed-data";
+export { ordersTesterSeedData } from "./orders-tester-seed-data";

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

@@ -4,3 +4,6 @@ export { categoriesTesterSeedData } from "./categories-tester-seed-data";
 export { productsTesterSeedData } from "./products-tester-seed-data";
 export { blogTesterSeedData } from "./blog-tester-seed-data";
 export { eventsTesterSeedData } from "./events-tester-seed-data";
+export { couponsTesterSeedData } from "./coupons-tester-seed-data";
+export { bidsTesterSeedData } from "./bids-tester-seed-data";
+export { ordersTesterSeedData } from "./orders-tester-seed-data";

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

@@ -0,0 +1,2 @@
+import type { OrderDocument } from "../../orders/schemas/firestore";
+export declare const ordersTesterSeedData: Partial<OrderDocument>[];

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

@@ -0,0 +1,265 @@
+/*
+ * WHY: Shared tester sandbox — one order per OrderStatus value (9 statuses) plus one
+ *      each for the non-standard order types (auction win, bundle, prize-draw win,
+ *      prize-draw loss/auto-refund) so testers can see every order-management state
+ *      without manually driving each one through the full checkout/shipping/return
+ *      flow first. Buyer is the dedicated user-tester-qa persona. Auto-expires in 7
+ *      days via testerSandboxCleanup (orders aren't cascade-deleted — see note below).
+ * WHAT: Exports ordersTesterSeedData — 13 Partial<OrderDocument> for the seed runner.
+ *
+ * NOTE: OrderDocument does not currently carry isTestData/testDataExpiresAt (unlike
+ *       categories/stores/products/blogPosts/events) — testerSandboxCleanup does not
+ *       cascade-delete these order documents when the parent product/store expires.
+ *       They're small and harmless to leave; extending the cleanup script to cover
+ *       orders is a follow-up, not blocking.
+ *
+ * EXPORTS:
+ *   ordersTesterSeedData — Array of 13 Partial<OrderDocument> for the seed runner
+ *
+ * @tag domain:orders,tester
+ * @tag layer:seed
+ * @tag pattern:none
+ * @tag access:server-only
+ * @tag consumers:seed/index.ts,seed-cli.mjs
+ * @tag sideEffects:none
+ */
+const NOW = new Date();
+const daysAgo = (n) => new Date(NOW.getTime() - n * 86400000);
+const BUYER_ID = "user-tester-qa";
+const BUYER_NAME = "QA Tester";
+const BUYER_EMAIL = "tester@letitrip.in";
+const STORE_ID = "store-tester-sandbox";
+const STORE_NAME = "Tester Sandbox Store";
+const STANDARD_PRODUCT_ID = "product-tester-standard-1";
+const STANDARD_PRODUCT_TITLE = "Test Gadget — Standard Listing #1";
+const PRIZEDRAW_PRODUCT_ID = "prizedraw-tester-sandbox-1";
+const PRIZEDRAW_PRODUCT_TITLE = "Test Prize Draw — Reveal Me!";
+function standardOrder({ key, status, paymentStatus, extra }) {
+    return {
+        id: `order-tester-sandbox-standard-${key}`,
+        productId: STANDARD_PRODUCT_ID,
+        productTitle: STANDARD_PRODUCT_TITLE,
+        userId: BUYER_ID,
+        userName: BUYER_NAME,
+        userEmail: BUYER_EMAIL,
+        storeId: STORE_ID,
+        storeName: STORE_NAME,
+        items: [
+            { productId: STANDARD_PRODUCT_ID, productTitle: STANDARD_PRODUCT_TITLE, listingType: "standard", quantity: 1, unitPrice: 199, totalPrice: 199 },
+        ],
+        orderType: "standard",
+        quantity: 1,
+        unitPrice: 199,
+        totalPrice: 199,
+        currency: "INR",
+        status,
+        paymentStatus,
+        paymentMethod: "upi_manual",
+        shippingAddress: "addr-tester-qa-home",
+        orderDate: daysAgo(3),
+        createdAt: daysAgo(3),
+        updatedAt: daysAgo(1),
+        ...extra,
+    };
+}
+export const ordersTesterSeedData = [
+    // ── One order per OrderStatus value (9) ──────────────────────────────────────
+    standardOrder({ key: "pending", status: "pending", paymentStatus: "pending" }),
+    standardOrder({ key: "confirmed", status: "confirmed", paymentStatus: "paid" }),
+    standardOrder({ key: "processing", status: "processing", paymentStatus: "paid" }),
+    standardOrder({
+        key: "shipped",
+        status: "shipped",
+        paymentStatus: "paid",
+        extra: { trackingNumber: "TEST-TRACK-001", shippingCarrier: "Test Carrier", shippingDate: daysAgo(1) },
+    }),
+    standardOrder({
+        key: "delivered",
+        status: "delivered",
+        paymentStatus: "paid",
+        extra: { trackingNumber: "TEST-TRACK-002", shippingCarrier: "Test Carrier", shippingDate: daysAgo(2), deliveryDate: daysAgo(1) },
+    }),
+    standardOrder({
+        key: "cancelled",
+        status: "cancelled",
+        paymentStatus: "refunded",
+        extra: { cancellationDate: daysAgo(1), cancellationReason: "Disposable test cancellation — buyer changed their mind." },
+    }),
+    standardOrder({
+        key: "refunded",
+        status: "refunded",
+        paymentStatus: "refunded",
+        extra: { refundAmount: 199, refundStatus: "completed", refundNote: "Disposable test refund." },
+    }),
+    standardOrder({
+        key: "return-requested",
+        status: "return_requested",
+        paymentStatus: "paid",
+        extra: { trackingNumber: "TEST-TRACK-003", shippingDate: daysAgo(3), deliveryDate: daysAgo(2) },
+    }),
+    standardOrder({
+        key: "returned",
+        status: "returned",
+        paymentStatus: "refunded",
+        extra: {
+            trackingNumber: "TEST-TRACK-004",
+            shippingDate: daysAgo(5),
+            deliveryDate: daysAgo(4),
+            refundAmount: 199,
+            refundStatus: "completed",
+        },
+    }),
+    // ── Auction win — order created from the already-ended auction-tester-sandbox-won ──
+    {
+        id: "order-tester-sandbox-auction-win",
+        productId: "auction-tester-sandbox-won",
+        productTitle: "Test Auction — Already Won",
+        userId: BUYER_ID,
+        userName: BUYER_NAME,
+        userEmail: BUYER_EMAIL,
+        storeId: STORE_ID,
+        storeName: STORE_NAME,
+        items: [
+            { productId: "auction-tester-sandbox-won", productTitle: "Test Auction — Already Won", listingType: "auction", quantity: 1, unitPrice: 15000, totalPrice: 15000 },
+        ],
+        orderType: "auction",
+        quantity: 1,
+        unitPrice: 15000,
+        totalPrice: 15000,
+        currency: "INR",
+        status: "delivered",
+        paymentStatus: "paid",
+        paymentMethod: "upi_manual",
+        shippingAddress: "addr-tester-qa-home",
+        trackingNumber: "TEST-TRACK-AUCTION-001",
+        shippingCarrier: "Test Carrier",
+        shippingDate: daysAgo(1),
+        deliveryDate: NOW,
+        orderDate: daysAgo(1),
+        createdAt: daysAgo(1),
+        updatedAt: NOW,
+    },
+    // ── Bundle purchase — group-tester-sandbox-bundle expands into its two children ──
+    {
+        id: "order-tester-sandbox-bundle",
+        productId: "group-tester-sandbox-bundle",
+        productTitle: "Test Bundle — Standard #1 + Standard #2",
+        userId: BUYER_ID,
+        userName: BUYER_NAME,
+        userEmail: BUYER_EMAIL,
+        storeId: STORE_ID,
+        storeName: STORE_NAME,
+        items: [
+            {
+                productId: "product-tester-standard-1",
+                productTitle: "Test Gadget — Standard Listing #1",
+                listingType: "standard",
+                quantity: 1,
+                unitPrice: 199,
+                totalPrice: 199,
+                bundleCategorySlug: "group-tester-sandbox-bundle",
+                bundleProductIds: ["product-tester-standard-1", "product-tester-standard-2"],
+            },
+            {
+                productId: "product-tester-standard-2",
+                productTitle: "Test Collectible — Standard Listing #2",
+                listingType: "standard",
+                quantity: 1,
+                unitPrice: 149,
+                totalPrice: 149,
+                bundleCategorySlug: "group-tester-sandbox-bundle",
+                bundleProductIds: ["product-tester-standard-1", "product-tester-standard-2"],
+            },
+        ],
+        orderType: "standard",
+        bundleId: "group-tester-sandbox-bundle",
+        isNonRefundable: true,
+        quantity: 2,
+        unitPrice: 164,
+        totalPrice: 329,
+        currency: "INR",
+        status: "processing",
+        paymentStatus: "paid",
+        paymentMethod: "upi_manual",
+        shippingAddress: "addr-tester-qa-home",
+        orderDate: daysAgo(1),
+        createdAt: daysAgo(1),
+        updatedAt: daysAgo(1),
+    },
+    // ── Prize draw — winning entry (auto reveal isn't required for this seed to be
+    //    useful; it just represents the post-reveal state a real reveal would produce) ──
+    {
+        id: "order-tester-sandbox-prizedraw-win",
+        productId: PRIZEDRAW_PRODUCT_ID,
+        productTitle: PRIZEDRAW_PRODUCT_TITLE,
+        userId: BUYER_ID,
+        userName: BUYER_NAME,
+        userEmail: BUYER_EMAIL,
+        storeId: STORE_ID,
+        storeName: STORE_NAME,
+        items: [
+            {
+                productId: PRIZEDRAW_PRODUCT_ID,
+                productTitle: PRIZEDRAW_PRODUCT_TITLE,
+                listingType: "prize-draw",
+                quantity: 1,
+                unitPrice: 50,
+                totalPrice: 50,
+                prizeRevealStatus: "revealed",
+                revealedItemNumber: 1,
+            },
+        ],
+        orderType: "prize-draw",
+        prizeDrawProductId: PRIZEDRAW_PRODUCT_ID,
+        prizeWon: { itemNumber: 1, title: "Test Prize — Grand", images: [], wonAt: daysAgo(1) },
+        prizeRevealDeadline: new Date(Date.now() + 7 * 24 * 60 * 60 * 1000),
+        isNonRefundable: true,
+        quantity: 1,
+        unitPrice: 50,
+        totalPrice: 50,
+        currency: "INR",
+        status: "delivered",
+        paymentStatus: "paid",
+        paymentMethod: "upi_manual",
+        orderDate: daysAgo(1),
+        createdAt: daysAgo(1),
+        updatedAt: daysAgo(1),
+    },
+    // ── Prize draw — non-winning entry, auto-refunded ────────────────────────────
+    {
+        id: "order-tester-sandbox-prizedraw-lose",
+        productId: PRIZEDRAW_PRODUCT_ID,
+        productTitle: PRIZEDRAW_PRODUCT_TITLE,
+        userId: "user-admin-letitrip",
+        userName: "LetItRip Admin",
+        userEmail: "admin@letitrip.in",
+        storeId: STORE_ID,
+        storeName: STORE_NAME,
+        items: [
+            {
+                productId: PRIZEDRAW_PRODUCT_ID,
+                productTitle: PRIZEDRAW_PRODUCT_TITLE,
+                listingType: "prize-draw",
+                quantity: 1,
+                unitPrice: 50,
+                totalPrice: 50,
+                prizeRevealStatus: "closed",
+            },
+        ],
+        orderType: "prize-draw",
+        prizeDrawProductId: PRIZEDRAW_PRODUCT_ID,
+        quantity: 1,
+        unitPrice: 50,
+        totalPrice: 50,
+        currency: "INR",
+        status: "refunded",
+        paymentStatus: "refunded",
+        paymentMethod: "upi_manual",
+        refundAmount: 50,
+        refundStatus: "completed",
+        refundNote: "Disposable test — non-winning prize-draw entry auto-refunded after reveal.",
+        orderDate: daysAgo(1),
+        createdAt: daysAgo(1),
+        updatedAt: NOW,
+    },
+];