Fix get purchases route to return amount paid (#413)

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

* **New Features**
* Ticket entries now display refunded and fulfilled status information.
  * Merch purchases now include total paid amount in purchase details.

* **Tests**
* Updated test cases to validate new ticket and merch purchase response
fields.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Author: devksingh4

src/api/routes/tickets.ts

@@ -55,23 +55,38 @@ const purchaseSchema = z.object({
 
 type PurchaseData = z.infer<typeof purchaseSchema>;
 
-const ticketEntryZod = z.object({
-  valid: z.boolean(),
-  type: z.enum(["merch", "ticket"]),
-  ticketId: z.string().min(1),
-  purchaserData: purchaseSchema,
-  totalPaid: z.optional(z.number()),
-});
-
-const ticketInfoEntryZod = ticketEntryZod
-  .extend({
-    refunded: z.boolean(),
-    fulfilled: z.boolean(),
+const ticketEntryZod = z
+  .object({
+    valid: z.boolean().meta({
+      description:
+        "Determines whether or not this ticket is still valid to be fulfilled.",
+    }),
+    type: z.enum(["merch", "ticket"]),
+    ticketId: z.string().min(1).meta({
+      description: "A string uniquely identifying the purchase.",
+    }),
+    purchaserData: purchaseSchema,
+    totalPaid: z.optional(z.number()).meta({
+      description:
+        "The total amount paid by the customer, in cents, net of refunds.",
+    }),
   })
   .meta({
     description: "An entry describing one merch or tickets transaction.",
+    id: "StoreTicketEntryV1",
   });
 
+const ticketInfoEntryZod = ticketEntryZod.extend({
+  refunded: z.boolean().meta({
+    description:
+      "Determines whether or not this purchase has been fully refunded to the customer.",
+  }),
+  fulfilled: z.boolean().meta({
+    description:
+      "Determines whether or not this purchase's services/items has already been provided to the customer.",
+  }),
+});
+
 export type TicketInfoEntry = z.infer<typeof ticketInfoEntryZod>;
 
 const baseItemMetadata = z.object({
@@ -273,6 +288,7 @@ const ticketsPlugin: FastifyPluginAsync = async (fastify, _options) => {
                 quantity: unmarshalled.quantity,
                 size: unmarshalled.size,
               },
+              totalPaid: unmarshalled.total_paid,
             });
           }
           break;

tests/unit/mockMerchPurchases.testdata.ts

@@ -96,6 +96,9 @@ const fulfilledMerchItem2 = {
   size: {
     S: "XS",
   },
+  total_paid: {
+    N: 500,
+  },
 };
 
 const dynamoTableData = [

tests/unit/tickets.test.ts

@@ -503,6 +503,61 @@ describe("Test getting all issued tickets", async () => {
     const responseDataJson = response.body;
     expect(response.statusCode).toEqual(200);
     expect(responseDataJson.tickets).toHaveLength(4);
+    expect(responseDataJson.tickets).toEqual([
+      {
+        fulfilled: true,
+        purchaserData: {
+          email: "testing0@illinois.edu",
+          productId: "2024_fa_barcrawl",
+          quantity: 1,
+          size: "M",
+        },
+        refunded: false,
+        ticketId: "pi_3Q5GewDiGOXU9RuS16txRR5D",
+        type: "merch",
+        valid: true,
+      },
+      {
+        fulfilled: false,
+        purchaserData: {
+          email: "testing1@illinois.edu",
+          productId: "2024_fa_barcrawl",
+          quantity: 3,
+          size: "L",
+        },
+        refunded: false,
+        ticketId: "pi_8J4NrYdA3S7cW8Ty92FnGJ6L",
+        type: "merch",
+        valid: true,
+      },
+      {
+        fulfilled: false,
+        purchaserData: {
+          email: "testing2@illinois.edu",
+          productId: "2024_fa_barcrawl",
+          quantity: 3,
+          size: "L",
+        },
+        refunded: true,
+        ticketId: "pi_6T9QvUwR2IOj4CyF35DsXK7P",
+        type: "merch",
+        valid: true,
+      },
+      {
+        fulfilled: true,
+        purchaserData: {
+          email: "testing2@illinois.edu",
+          productId: "2024_fa_barcrawl",
+          quantity: 1,
+          size: "XS",
+        },
+        refunded: false,
+        ticketId: "pi_5L8SwOdN9PXu6RyV83FgQK1C",
+        totalPaid: 500,
+        type: "merch",
+        valid: true,
+      },
+    ]);
   });
   test("Sad path: fail on type 'ticket'", async () => {
     ddbMock.on(QueryCommand).rejects();
@@ -562,6 +617,7 @@ describe("Test getting user purchases", () => {
             quantity: 2,
             refunded: false,
             size: "L",
+            total_paid: 500,
           }),
         ],
       });
@@ -603,6 +659,7 @@ describe("Test getting user purchases", () => {
       },
       refunded: false,
       fulfilled: true,
+      totalPaid: 500,
     });
   });