integrate description generation to donor offer creation + bug fixes

package.json

@@ -17,7 +17,6 @@
     "email:dev": "email dev --dir ./src/email --port 4000"
   },
   "dependencies": {
-    "openai": "^4.63.0",
     "@azure/storage-blob": "^12.27.0",
     "@headlessui/react": "^2.2.1",
     "@phosphor-icons/react": "^2.1.7",
@@ -31,6 +30,7 @@
     "highs": "^1.8.0",
     "next": "15.0.4",
     "next-auth": "^5.0.0-beta.25",
+    "openai": "^4.104.0",
     "papaparse": "^5.5.2",
     "promisify": "^0.0.3",
     "react-hot-toast": "^2.4.1",

prisma/migrations/20251021023559_add_general_item_description/migration.sql

@@ -0,0 +1,2 @@
+-- AlterTable
+ALTER TABLE "GeneralItem" ADD COLUMN     "description" TEXT;

prisma/schema.prisma

@@ -133,6 +133,8 @@ model GeneralItem {
 
   initialQuantity Int
   requestQuantity Int?
+
+  description String?
 
   requests GeneralItemRequest[]
   items    LineItem[]

src/app/api/donorOffers/route.ts

@@ -11,6 +11,7 @@ import {
 } from "@/util/errors";
 import FileService from "@/services/fileService";
 import { tableParamsSchema } from "@/schema/tableParams";
+import { DescriptionService } from "@/services/descriptionService";
 
 export async function POST(req: NextRequest) {
   try {
@@ -24,16 +25,29 @@ export async function POST(req: NextRequest) {
         "You are not allowed to create donor offers"
       );
     }
-
+    const params = req.nextUrl.searchParams;
     const formData = await req.formData();
     const file = formData.get("file") as File | null;
-    const preview = formData.get("preview") === "true";
+    const preview = params.get("preview") === "true";
 
     if (!file) {
       throw new ArgumentError("File is required");
     }
 
     const parsedFileData = await FileService.parseDonorOfferFile(file);
+    const itemDescriptionInput = parsedFileData.data.map((item) => ({
+      title: item["title"] as string,
+      type: item["type"] as string,
+      unitType: item["unitType"] as string,
+    }));
+
+    const descriptions =
+      await DescriptionService.getOrGenerateDescriptions(itemDescriptionInput);
+
+    parsedFileData.data.forEach((item, index) => {
+      item.description = descriptions[index];
+    });
+
     const result = await DonorOfferService.createDonorOffer(
       formData,
       parsedFileData,

src/app/donorOffers/create/page.tsx

@@ -47,8 +47,9 @@ export default function CreateDonorOfferPage() {
     handleFileChange,
     resetUpload: resetFileUpload,
   } = useFileUpload<{ donorOfferItems: DonorOfferItem[] }>({
-    previewEndpoint: "/api/donorOffers/create?preview=true",
+    previewEndpoint: "/api/donorOffers?preview=true",
     onSuccess: (result) => {
+      console.log(result);
       setData(result.donorOfferItems);
     },
     validateBeforeUpload: () => {
@@ -93,7 +94,7 @@ export default function CreateDonorOfferPage() {
 
   const resetUpload = () => {
     resetFileUpload();
-    
+
     setPreview(false);
     setIsSuccess(false);
     setIsError(false);
@@ -119,7 +120,7 @@ export default function CreateDonorOfferPage() {
     });
 
     try {
-      await apiClient.post("/api/donorOffers/create", {
+      await apiClient.post("/api/donorOffers", {
         body: formData,
       });
       setIsSuccess(true);
@@ -264,7 +265,9 @@ export default function CreateDonorOfferPage() {
         <DonorOfferErrorModal
           setErrorOpen={setIsError}
           resetUpload={resetUpload}
-          errors={["An error occurred while creating the donor offer. Please try again."]}
+          errors={[
+            "An error occurred while creating the donor offer. Please try again.",
+          ]}
         />
       )}
     </div>

src/components/DonorOffers/PreviewTable.tsx

@@ -18,6 +18,7 @@ export type DonorOfferItem = {
   hfhShippingNumber?: string;
   visible?: boolean;
   notes?: string;
+  description?: string;
 };
 
 interface PreviewTableProps {
@@ -46,6 +47,7 @@ export const PreviewTable = ({ data, final }: PreviewTableProps) => (
           "Visibility",
           "Comment",
         ]),
+        "Description",
       ]}
       rows={data.map((item) => ({
         cells: [
@@ -68,6 +70,7 @@ export const PreviewTable = ({ data, final }: PreviewTableProps) => (
             item.visible ? "Visible" : "Hidden",
             item.notes,
           ]),
+          item.description,
         ],
       }))}
     />

src/screens/DonorOffersScreens/AdminDynamicDonorOfferScreen.tsx

@@ -46,6 +46,7 @@ type GeneralItemWithRequests = {
   quantityPerUnit: number;
   initialQuantity: number;
   requestQuantity: number | null;
+  description?: string;
   requests: {
     id: number;
     quantity: number;
@@ -120,6 +121,11 @@ export default function AdminDynamicDonorOfferScreen() {
         header: "Quantity",
         cell: (i) => i.initialQuantity,
       },
+      {
+        id: "description",
+        header: "Description",
+        cell: (i) => i.description || "N/A",
+      },
       {
         id: "requestSummary",
         header: "Request Summary",
@@ -132,7 +138,9 @@ export default function AdminDynamicDonorOfferScreen() {
           );
           return (
             <div className="flex items-center gap-2">
-              <span className="text-gray-600">{isOpen ? <CgChevronUp /> : <CgChevronDown />}</span>
+              <span className="text-gray-600">
+                {isOpen ? <CgChevronUp /> : <CgChevronDown />}
+              </span>
               <button className="px-2 py-1 border-black border rounded text-sm">
                 Total <span className="font-semibold">{totalQty}</span>
               </button>
@@ -232,7 +240,6 @@ export default function AdminDynamicDonorOfferScreen() {
 
       // Handle streaming chunk
       if ("itemIndex" in chunk && "requests" in chunk) {
-
         const currentItem = currentItems[chunk.itemIndex];
         if (currentItem) {
           updateItemRequests(currentItem.id, chunk.requests);
@@ -250,11 +257,11 @@ export default function AdminDynamicDonorOfferScreen() {
         body: JSON.stringify({ donorOfferId: parseInt(String(donorOfferId)) }),
         parseChunk: (rawChunk: string) => {
           buffer += rawChunk;
-          
+
           const parts = buffer.split("\n\n");
-          
+
           buffer = parts.pop() || "";
-          
+
           for (const part of parts) {
             if (part.trim().startsWith("data: ")) {
               const data = part.substring(part.indexOf("data: ") + 6).trim();
@@ -268,7 +275,7 @@ export default function AdminDynamicDonorOfferScreen() {
               }
             }
           }
-          
+
           return pendingMessages.shift() || ({ test: "" } as StreamChunk);
         },
         onChunk: (chunk) => {
@@ -359,51 +366,56 @@ export default function AdminDynamicDonorOfferScreen() {
     }
   }, [apiClient, currentItems]);
 
-  const handleRequestUpdated = useCallback((itemId?: number, updatedRequests?: PartnerRequestChipData[]) => {
-    if (isLLMMode && itemId && updatedRequests) {
-      // In LLM mode, update the specific item without reloading
-      tableRef.current?.updateItemById(itemId, (currentItem) => {
-        return {
-          ...currentItem,
-          requests: currentItem.requests.map((req) => {
-            const updatedReq = updatedRequests.find((r) => r.id === req.id);
-            if (updatedReq) {
+  const handleRequestUpdated = useCallback(
+    (itemId?: number, updatedRequests?: PartnerRequestChipData[]) => {
+      if (isLLMMode && itemId && updatedRequests) {
+        // In LLM mode, update the specific item without reloading
+        tableRef.current?.updateItemById(itemId, (currentItem) => {
+          return {
+            ...currentItem,
+            requests: currentItem.requests.map((req) => {
+              const updatedReq = updatedRequests.find((r) => r.id === req.id);
+              if (updatedReq) {
+                return {
+                  ...req,
+                  finalQuantity: updatedReq.finalQuantity,
+                };
+              }
+              return req;
+            }),
+          };
+        });
+
+        // Also update currentItems state
+        setCurrentItems((prevItems) =>
+          prevItems.map((item) => {
+            if (item.id === itemId) {
               return {
-                ...req,
-                finalQuantity: updatedReq.finalQuantity,
+                ...item,
+                requests: item.requests.map((req) => {
+                  const updatedReq = updatedRequests.find(
+                    (r) => r.id === req.id
+                  );
+                  if (updatedReq) {
+                    return {
+                      ...req,
+                      finalQuantity: updatedReq.finalQuantity,
+                    };
+                  }
+                  return req;
+                }),
               };
             }
-            return req;
-          }),
-        };
-      });
-
-      // Also update currentItems state
-      setCurrentItems((prevItems) =>
-        prevItems.map((item) => {
-          if (item.id === itemId) {
-            return {
-              ...item,
-              requests: item.requests.map((req) => {
-                const updatedReq = updatedRequests.find((r) => r.id === req.id);
-                if (updatedReq) {
-                  return {
-                    ...req,
-                    finalQuantity: updatedReq.finalQuantity,
-                  };
-                }
-                return req;
-              }),
-            };
-          }
-          return item;
-        })
-      );
-    } else {
-      // Not in LLM mode, reload the table
-      tableRef.current?.reload();
-    }
-  }, [isLLMMode]);
+            return item;
+          })
+        );
+      } else {
+        // Not in LLM mode, reload the table
+        tableRef.current?.reload();
+      }
+    },
+    [isLLMMode]
+  );
 
   const rowBody = useCallback(
     (item: GeneralItemWithRequests) => {