Deleting some unused API methods, storing interactions properly to the Task Backend, Adding explanatory comments, using a task queue in the client side

website/pages/api/hello.js

@@ -1,5 +0,0 @@
-// Next.js API route support: https://nextjs.org/docs/api-routes/introduction
-
-export default function handler(req, res) {
-  res.status(200).json({ name: "John Doe" });
-}

website/pages/api/new_task.js

@@ -2,16 +2,25 @@ import { unstable_getServerSession } from "next-auth/next";
 import { authOptions } from "./auth/[...nextauth]";
 
 /**
- * Returns a list of prompts from the Labeler Backend.
+ * Returns a new task created from the Task Backend.  We do a few things here:
+ *
+ * 1) Get the task from the backend and register the requesting user.
+ * 2) Store the task in our local database.
+ * 3) Send and Ack to the Task Backend with our local id for the task.
+ * 4) Return everything to the client.
  */
 export default async (req, res) => {
   const session = await unstable_getServerSession(req, res, authOptions);
 
+  // Return nothing if the user isn't registered.
   if (!session) {
     res.status(401).end();
     return;
   }
 
+  // Fetch the new task.
+  //
+  // This needs to be refactored into an easier to use library.
   const taskRes = await fetch(`${process.env.FASTAPI_URL}/api/v1/tasks/`, {
     method: "POST",
     headers: {
@@ -29,6 +38,7 @@ export default async (req, res) => {
   });
   const task = await taskRes.json();
 
+  // Store the task and link it to the user..
   const registeredTask = await prisma.registeredTask.create({
     data: {
       task,
@@ -40,6 +50,7 @@ export default async (req, res) => {
     },
   });
 
+  // Update the backend with our Task ID
   const ackRes = await fetch(
     `${process.env.FASTAPI_URL}/api/v1/tasks/${task.id}/ack`,
     {
@@ -55,5 +66,6 @@ export default async (req, res) => {
   );
   const ack = await ackRes.json();
 
+  // Send the results to the client.
   res.status(200).json(registeredTask);
 };

website/pages/api/prompts.js

@@ -1,28 +0,0 @@
-import { unstable_getServerSession } from "next-auth/next";
-import { authOptions } from "./auth/[...nextauth]";
-
-/**
- * Returns a list of prompts from the Labeler Backend.
- */
-export default async (req, res) => {
-  const session = await unstable_getServerSession(req, res, authOptions);
-
-  if (!session) {
-    res.status(401).end();
-    return;
-  }
-  try {
-    const promptRes = await fetch(`${process.env.FASTAPI_URL}/api/v1/prompts`, {
-      headers: {
-        "X-API-Key": process.env.FASTAPI_KEY,
-      },
-    });
-    const prompts = await promptRes.json();
-
-    res.status(200).json(prompts);
-  } catch (error) {
-    console.error(error);
-    res.status(500);
-  }
-  res.end();
-};

website/pages/api/update_task.js

@@ -2,18 +2,28 @@ import { unstable_getServerSession } from "next-auth/next";
 import { authOptions } from "./auth/[...nextauth]";
 
 /**
- * Returns a list of prompts from the Labeler Backend.
+ * Stores the task interaction with the Task Backend and then returns the next task generated.
+ *
+ * This implicity does a few things:
+ * 1) Stores the answer with the Task Backend.
+ * 2) Records the new task in our local database.
+ * 3) (TODO) Acks the new task with our local task ID to the Task Backend.
+ * 4) Returns the newly created task to the client.
  */
 export default async (req, res) => {
   const session = await unstable_getServerSession(req, res, authOptions);
 
+  // Return nothing if the user isn't registered.
   if (!session) {
     res.status(401).end();
     return;
   }
 
+  // Parse out the local task ID and the interaction contents.
   const { id, content } = await JSON.parse(req.body);
 
+  // Log the interaction locally to create our user_post_id needed by the Task
+  // Backend.
   const interaction = await prisma.taskInteraction.create({
     data: {
       content,
@@ -25,6 +35,8 @@ export default async (req, res) => {
     },
   });
 
+  // Send the interaction to the Task Backend.  This automatically fetches the
+  // next task in the sequence (or the done task).
   const interactionRes = await fetch(
     `${process.env.FASTAPI_URL}/api/v1/tasks/interaction`,
     {
@@ -46,9 +58,23 @@ export default async (req, res) => {
       }),
     }
   );
-  console.log(interactionRes.status);
   const newTask = await interactionRes.json();
-  console.log(newTask);
 
-  res.status(200).json(newTask);
+  // Stores the new task with our database.
+  const newRegisteredTask = await prisma.registeredTask.create({
+    data: {
+      task: newTask,
+      user: {
+        connect: {
+          id: session.user.id,
+        },
+      },
+    },
+  });
+
+  // TODO: Ack the task with the Task Backend using the newly created local
+  // task ID.
+
+  // Send the next task in the sequence to the client.
+  res.status(200).json(newRegisteredTask);
 };