Feature/christenjacob/donationsflow

backend/package.json

@@ -23,8 +23,7 @@
     "http-errors": "^2.0.0",
     "module-alias": "^2.2.3",
     "mongodb": "^6.3.0",
-    "mongoose": "^8.0.3",
-    "nodemailer": "^6.9.11"
+    "mongoose": "^8.0.3"
   },
   "devDependencies": {
     "@types/cors": "^2.8.17",
@@ -36,6 +35,7 @@
     "eslint-config-prettier": "^9.1.0",
     "eslint-plugin-import": "^2.29.1",
     "husky": "^8.0.3",
+    "nodemailer": "^6.9.13",
     "nodemon": "^3.0.2",
     "prettier": "^3.1.1",
     "ts-node-dev": "^2.0.0",

backend/src/app.ts

@@ -14,6 +14,7 @@ import volunteerDetailsRoutes from "./routes/volunteerDetails";
 import testimonialRoutes from "src/routes/testimonial";
 import newsletterRoutes from "src/routes/newsletter"; // Import newsletter routes
 import emailRoutes from "src/routes/emails";
+import paypalRoutes from "src/routes/paypal";
 
 const app = express();
 
@@ -40,6 +41,7 @@ app.use("/api/volunteerDetails", volunteerDetailsRoutes);
 app.use("/api/testimonial", testimonialRoutes);
 app.use("/api/newsletter", newsletterRoutes);
 app.use("/api/emails", emailRoutes);
+app.use("/api/orders", paypalRoutes); // Donation Order routes
 
 /**
  * Error handler; all errors thrown by server are handled here.

backend/src/controllers/emails.ts

@@ -35,6 +35,10 @@ export const createEmail: RequestHandler = async (req, res, next) => {
     const specialStr = specialUpdates ? "Yes" : "No";
     EMAIL_SUBJECT = `Newsletter Form: Subscription by ${firstName} ${lastName}`;
     EMAIL_BODY = `First Name: ${firstName} \nLast Name: ${lastName}\nEmail: ${email}\nReceive Quarterly Updates: ${quarterlyStr}\nReceive Special Events Updates: ${specialStr}`;
+  } else if (req.body.type === "donation") {
+    const { firstName, lastName, email, phone, comment } = req.body;
+    EMAIL_SUBJECT = `Physical Donation Form: Donation from ${firstName} ${lastName}`;
+    EMAIL_BODY = `First Name: ${firstName}\nLast Name: ${lastName}\nEmail: ${email}\nPhone Number: ${phone}\nDonation Comment:\n${comment}`;
   }
 
   try {

backend/src/controllers/paypal.ts

@@ -0,0 +1,22 @@
+import { RequestHandler } from "express";
+import { captureOrder, createOrder } from "src/services/paypal";
+
+export const createOrderHandler: RequestHandler = async (req, res, next) => {
+  try {
+    const { cart } = req.body;
+    const { jsonResponse, httpStatusCode } = await createOrder(cart);
+    res.status(httpStatusCode).json(jsonResponse);
+  } catch (error) {
+    next(error);
+  }
+};
+
+export const captureOrderHandler: RequestHandler = async (req, res, next) => {
+  try {
+    const { orderId } = req.params;
+    const { jsonResponse, httpStatusCode } = await captureOrder(orderId);
+    res.status(httpStatusCode).json(jsonResponse);
+  } catch (error) {
+    next(error);
+  }
+};

backend/src/routes/paypal.ts

@@ -0,0 +1,9 @@
+import express from "express";
+import { captureOrderHandler, createOrderHandler } from "src/controllers/paypal";
+
+const router = express.Router();
+
+router.post("/", createOrderHandler);
+router.post("/:orderId/capture", captureOrderHandler);
+
+export default router;

backend/src/services/emails.ts

@@ -10,7 +10,9 @@ const sendContactEmail = async (subject: string, message: string) => {
   const EMAIL_SUBJECT = `${subject}`;
   const EMAIL_BODY = `${message}`;
   const transporter = nodemailer.createTransport({
-    service: "gmail",
+    service: "Gmail",
+    host: "smtp.gmail.com",
+    secure: true,
     auth: {
       user: env.EMAIL_USER,
       pass: env.EMAIL_APP_PASSWORD,

backend/src/services/paypal.ts

@@ -0,0 +1,125 @@
+const PAYPAL_CLIENT_ID = process.env.PAYPAL_CLIENT_ID;
+const PAYPAL_CLIENT_SECRET = process.env.PAYPAL_CLIENT_SECRET;
+
+const base = "https://api-m.sandbox.paypal.com";
+
+/**
+ * Types the CartItem and Cart objects which gets used in a createOrder request
+ */
+type CartItem = {
+  id: string;
+  amount: string; // string dollar amout, eg "5.00"
+  quantity: string;
+};
+
+type Cart = CartItem[];
+
+/**
+ * Generate an OAuth 2.0 token to authenticate with PayPal REST APIs
+ * @see https://developer.paypal.com/api/rest/authentication/
+ */
+const generateAccessToken = async () => {
+  try {
+    if (!PAYPAL_CLIENT_ID || !PAYPAL_CLIENT_SECRET) {
+      throw new Error("MISSING_PAYPAL_API_CREDENTIALS");
+    }
+    const auth = Buffer.from(PAYPAL_CLIENT_ID + ":" + PAYPAL_CLIENT_SECRET).toString("base64");
+    const response = await fetch(`${base}/v1/oauth2/token`, {
+      method: "POST",
+      body: "grant_type=client_credentials",
+      headers: {
+        Authorization: `Basic ${auth}`,
+      },
+    });
+
+    const data = await response.json();
+    return data.access_token;
+  } catch (error) {
+    console.error("Failed to generate PayPal Access Token: ", error);
+  }
+};
+
+async function handleResponse(response: Response) {
+  try {
+    const jsonResponse = await response.json();
+    return {
+      jsonResponse,
+      httpStatusCode: response.status,
+    };
+  } catch (error) {
+    const errorMessage = await response.text();
+    throw new Error(errorMessage);
+  }
+}
+
+export async function createOrder(cart: Cart) {
+  const accessToken = await generateAccessToken();
+  const url = `${base}/v2/checkout/orders`;
+  console.log("shopping cart info", cart);
+
+  const payload = {
+    intent: "CAPTURE",
+    purchase_units: [
+      {
+        items: [
+          {
+            name: "Donation to 4FLOT",
+            description: "Deserunt aliquip enim Lorem.",
+            quantity: "1",
+            unit_amount: {
+              currency_code: "USD",
+              value: cart[0].amount,
+            },
+            category: "DONATION",
+          },
+        ],
+        amount: {
+          currency_code: "USD",
+          value: cart[0].amount,
+          breakdown: {
+            item_total: {
+              currency_code: "USD",
+              value: cart[0].amount,
+            },
+          },
+        },
+      },
+    ],
+  };
+
+  const response = await fetch(url, {
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${accessToken}`,
+      // Uncomment one of these to force an error for negative testing (in sandbox mode only). Documentation:
+      // https://developer.paypal.com/tools/sandbox/negative-testing/request-headers/
+      // "PayPal-Mock-Response": '{"mock_application_codes": "MISSING_REQUIRED_PARAMETER"}'
+      // "PayPal-Mock-Response": '{"mock_application_codes": "PERMISSION_DENIED"}'
+      // "PayPal-Mock-Response": '{"mock_application_codes": "INTERNAL_SERVER_ERROR"}'
+    },
+    method: "POST",
+    body: JSON.stringify(payload),
+  });
+
+  return handleResponse(response);
+}
+
+export async function captureOrder(orderID: string) {
+  const accessToken = await generateAccessToken();
+  const url = `${base}/v2/checkout/orders/${orderID}/capture`;
+
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${accessToken}`,
+      // Uncomment one of these to force an error for negative testing (in sandbox mode only). Documentation:
+      // https://developer.paypal.com/tools/sandbox/negative-testing/request-headers/
+      // "PayPal-Mock-Response": '{"mock_application_codes": "INSTRUMENT_DECLINED"}'
+      // "PayPal-Mock-Response": '{"mock_application_codes": "TRANSACTION_REFUSED"}'
+      // "PayPal-Mock-Response": '{"mock_application_codes": "INTERNAL_SERVER_ERROR"}'
+    },
+  });
+
+  return handleResponse(response);
+}

frontend/package.json

@@ -21,6 +21,7 @@
     "@mui/x-data-grid": "^7.1.1",
     "envalid": "^8.0.0",
     "firebase": "^10.11.0",
+    "@paypal/react-paypal-js": "^8.2.0",
     "html2canvas": "^1.4.1",
     "html2pdf.js": "^0.9.3",
     "jspdf": "^2.5.1",

frontend/src/api/email.ts

@@ -29,8 +29,21 @@ export type CreateNewsletterEmailRequest = {
   specialUpdates: boolean;
 };
 
+export type CreateDonationEmailRequest = {
+  type: string;
+  firstName: string;
+  lastName: string;
+  email: string;
+  phone: string;
+  comment: string;
+};
+
 export async function sendEmail(
-  email: CreateContactEmailRequest | CreateVolunteerEmailRequest | CreateNewsletterEmailRequest,
+  email:
+    | CreateContactEmailRequest
+    | CreateVolunteerEmailRequest
+    | CreateNewsletterEmailRequest
+    | CreateDonationEmailRequest,
 ) {
   try {
     await post("/api/emails", email);