feat: add delete functionality for purchases in API and update OpenAPI documentation

Author: aeltorio

client/package.json

@@ -7,7 +7,7 @@
     "dev": "vite",
     "dev:env": "set -a && source ../.env && set +a && vite",
     "build": "npm run openapi && tsc && vite build",
-    "build:env": "set -a && source ../.env && set +a && vite build",
+    "build:env": "set -a && source ../.env && set +a && npm run openapi &&  vite build",
     "lint": "eslint ./src/**/**/*.{ts,tsx} --fix",
     "wrangler": "cd cloudflare-fake-secured-api && npm run dev:env",
     "preview": "vite preview",

client/public/openapi.json

@@ -243,6 +243,49 @@
         }
       }
     },
+    "/api/purchase/{purchaseId}": {
+      "delete": {
+        "summary": "Delete a purchase by ID",
+        "description": "Deletes a purchase record. Requires write permission.",
+        "tags": [
+          "Purchases"
+        ],
+        "parameters": [
+          {
+            "name": "purchaseId",
+            "in": "path",
+            "required": true,
+            "description": "Purchase ID",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Purchase successfully deleted",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "success": {
+                      "type": "boolean"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Purchase not found or unauthorized request"
+          }
+        }
+      }
+    },
     "/api/purchase": {
       "post": {
         "summary": "Add a new purchase",
@@ -288,7 +331,7 @@
     "/api/purchase/{id}": {
       "get": {
         "summary": "Get purchase by ID",
-        "description": "Returns information about a specific purchase. Requires read permission.",
+        "description": "Returns information about a specific purchase own by a tester. Requires read permission.",
         "tags": [
           "Purchases"
         ],

cloudflare-worker/src/routes/index.ts

@@ -537,33 +537,32 @@ const purchaseRoutes = (router: Router, env: Env) => {
 	 * @openapi
 	 * /api/purchase/{purchaseId}:
 	 *   delete:
-	 *    summary: Delete a purchase by ID
-	 *    description: Deletes a purchase record by ID. Requires write permission.
-	 *    tags:
+	 *     summary: Delete a purchase by ID
+	 *     description: Deletes a purchase record. Requires write permission.
+	 *     tags:
 	 *       - Purchases
-	 *    parameters:
-	 * 	     - name: purchaseId
-	 * 	       in: path
-	 * 	       required: true
-	 * 	       description: Purchase ID
-	 * 	       schema:
-	 * 	         type: string
-	 *   responses:
+	 *     parameters:
+	 *       - name: purchaseId
+	 *         in: path
+	 *         required: true
+	 *         description: Purchase ID
+	 *         schema:
+	 *           type: string
+	 *     responses:
 	 *       200:
-	 *         description: Successfully retrieved purchase info
+	 *         description: Purchase successfully deleted
 	 *         content:
 	 *           application/json:
 	 *             schema:
 	 *               type: object
 	 *               properties:
 	 *                 success:
 	 *                   type: boolean
-	 *                 data:
-	 *                   $ref: '#/components/schemas/Purchase'
+	 *                 message:
+	 *                   type: string
 	 *       404:
-	 *         description: Purchase not found
+	 *         description: Purchase not found or unauthorized request
 	 */
-
 	router.delete(
 		"/api/purchase/:purchaseId",
 		async (request) => {