feat: implement contact and newsletter subscription forms with validation and API integration

Author: princepspolycap

src/app/(about)/about/page.js

@@ -6,7 +6,7 @@ import siteMetadata from "@/src/utils/siteMetaData"
 export const metadata = {
   title: "About Princeps Polycap",
   description:
-    "Origin story, mission, and ecosystem map for Princeps Polycap—the systems architect building Poly186.",
+    "Origin story, mission, and ecosystem map for Princeps Polycap, the systems architect building Poly186.",
 }
 
 export default function About() {
@@ -106,7 +106,7 @@ export default function About() {
         <p>
           Working overnight shifts on the Medtronic factory floor in Minnesota,
           I watched brilliant people spend entire careers on repetitive tasks
-          that could be automated. That experience sparked Poly—a business OS
+          that could be automated. That experience sparked Poly, a business OS
           powered by AI digital workers so organizations can redeploy humans to
           creative, strategic work.
         </p>
@@ -145,7 +145,7 @@ export default function About() {
 
         <h2>Building in public</h2>
         <p>
-          This site is the canonical log of how everything unfolds—the wins, the
+          This site is the canonical log of how everything unfolds: the wins, the
           prototypes that fail, the meta-commentary on using AI to build AI. If
           you&apos;re building something audacious, I hope this candid record
           gives you both tactical insight and moral permission to keep going.

src/app/(about)/contact/page.js

@@ -4,7 +4,7 @@ import siteMetadata from "@/src/utils/siteMetaData"
 
 export const metadata = {
   title: "Contact Princeps Polycap",
-  description: `Reach out to collaborate on Poly, SESAP, or Automating Basic Needs—or email ${siteMetadata.email}.`,
+  description: `Reach out to collaborate on Poly, SESAP, or Automating Basic Needs. Email ${siteMetadata.email} or schedule a call.`,
 }
 
 export default function Contact() {

src/app/api/contact/route.js

@@ -0,0 +1,68 @@
+import { NextResponse } from 'next/server';
+import connectDB from '@/src/lib/mongodb';
+import Contact from '@/src/models/Contact';
+
+export async function POST(request) {
+  try {
+    await connectDB();
+
+    const body = await request.json();
+    const { name, email, phone, projectDetails } = body;
+
+    if (!name || !email || !projectDetails) {
+      return NextResponse.json(
+        { error: 'Name, email, and project details are required' },
+        { status: 400 }
+      );
+    }
+
+    const ipAddress = request.headers.get('x-forwarded-for') || 
+                     request.headers.get('x-real-ip') || 
+                     'unknown';
+    const userAgent = request.headers.get('user-agent') || 'unknown';
+
+    const contact = await Contact.create({
+      name,
+      email,
+      phone: phone || '',
+      projectDetails,
+      ipAddress,
+      userAgent,
+      source: 'website-contact-form',
+      status: 'new'
+    });
+
+    console.log(`New contact submission from ${email}`);
+
+    return NextResponse.json(
+      { 
+        success: true, 
+        message: 'Your message has been received. I\'ll get back to you soon!',
+        contactId: contact._id 
+      },
+      { status: 201 }
+    );
+
+  } catch (error) {
+    console.error('Contact form submission error:', error);
+
+    if (error.name === 'ValidationError') {
+      return NextResponse.json(
+        { error: 'Invalid data provided', details: error.message },
+        { status: 400 }
+      );
+    }
+
+    return NextResponse.json(
+      { error: 'Failed to submit contact form. Please try again later.' },
+      { status: 500 }
+    );
+  }
+}
+
+export async function GET() {
+  return NextResponse.json(
+    { message: 'Contact API endpoint. Use POST to submit contact form.' },
+    { status: 200 }
+  );
+}

src/app/api/newsletter/route.js

@@ -0,0 +1,110 @@
+import { NextResponse } from 'next/server';
+import connectDB from '@/src/lib/mongodb';
+import Newsletter from '@/src/models/Newsletter';
+
+export async function POST(request) {
+  try {
+    await connectDB();
+
+    const body = await request.json();
+    const { email, source = 'website-footer' } = body;
+
+    if (!email) {
+      return NextResponse.json(
+        { error: 'Email is required' },
+        { status: 400 }
+      );
+    }
+
+    const emailRegex = /^\S+@\S+\.\S+$/;
+    if (!emailRegex.test(email)) {
+      return NextResponse.json(
+        { error: 'Please provide a valid email address' },
+        { status: 400 }
+      );
+    }
+
+    const ipAddress = request.headers.get('x-forwarded-for') || 
+                     request.headers.get('x-real-ip') || 
+                     'unknown';
+    const userAgent = request.headers.get('user-agent') || 'unknown';
+
+    const existingSubscriber = await Newsletter.findOne({ email: email.toLowerCase() });
+
+    if (existingSubscriber) {
+      if (existingSubscriber.subscribed) {
+        return NextResponse.json(
+          { 
+            success: true, 
+            message: 'You\'re already subscribed to the field notes!',
+            alreadySubscribed: true
+          },
+          { status: 200 }
+        );
+      } else {
+        existingSubscriber.subscribed = true;
+        existingSubscriber.unsubscribedAt = null;
+        existingSubscriber.source = source;
+        await existingSubscriber.save();
+
+        return NextResponse.json(
+          { 
+            success: true, 
+            message: 'Welcome back! Your subscription has been reactivated.',
+            resubscribed: true
+          },
+          { status: 200 }
+        );
+      }
+    }
+
+    const subscriber = await Newsletter.create({
+      email: email.toLowerCase(),
+      source,
+      ipAddress,
+      userAgent,
+      subscribed: true,
+      verified: false
+    });
+
+    console.log(`New newsletter subscriber: ${email}`);
+
+    return NextResponse.json(
+      { 
+        success: true, 
+        message: 'Subscribed! Watch for field notes from the Poly186 build.',
+        subscriberId: subscriber._id 
+      },
+      { status: 201 }
+    );
+
+  } catch (error) {
+    console.error('Newsletter subscription error:', error);
+
+    if (error.name === 'ValidationError') {
+      return NextResponse.json(
+        { error: 'Invalid email address', details: error.message },
+        { status: 400 }
+      );
+    }
+
+    if (error.code === 11000) {
+      return NextResponse.json(
+        { error: 'This email is already subscribed' },
+        { status: 409 }
+      );
+    }
+
+    return NextResponse.json(
+      { error: 'Failed to subscribe. Please try again later.' },
+      { status: 500 }
+    );
+  }
+}
+
+export async function GET() {
+  return NextResponse.json(
+    { message: 'Newsletter API endpoint. Use POST to subscribe.' },
+    { status: 200 }
+  );
+}

src/components/About/AboutCoverSection.js

@@ -18,7 +18,7 @@ const AboutCoverSection = () => {
             From factory floor shifts to Poly186
             </h2>
             <p className='font-medium mt-4 text-base leading-relaxed'>
-            Princeps Polycap is a self-taught Kenyan programmer documenting the real-time build-out of Poly—the AI operating system that funds Poly186, SESAP, Automating Basic Needs, and the Terraforming Sahara moonshot. Every experiment, success, and failure gets shared openly so other founders can see how post-scarcity infrastructure is made.
+            Princeps Polycap is a self-taught Kenyan programmer documenting the real-time build-out of Poly, the AI operating system that funds Poly186, SESAP, Automating Basic Needs, and the Terraforming Sahara moonshot. Every experiment, success, and failure gets shared openly so other founders can see how post-scarcity infrastructure is made.
             </p>
         </div>
     </section>