optimizing the performance of the application and integrated vercel speed insights

Author: ZakirCodeArchitect

app/api/docs/[id]/pages/[pageId]/route.ts

@@ -2,6 +2,9 @@ import { NextRequest, NextResponse } from 'next/server';
 import { updatePage } from '@/lib/db';
 import { getCurrentUser } from '@/lib/users';
 import type { DocumentSection } from '@/lib/docs';
+import { revalidateDocsNavData, revalidatePageCaches } from '@/lib/revalidate-docs-cache';
+
+const debugSave = process.env.DEBUG_API_SAVE === '1';
 
 // Tiptap/ProseMirror JSON node types for type-safe HTML rendering
 interface TiptapMark {
@@ -35,16 +38,17 @@ function renderNodeToHTML(node: TiptapNode): string {
   };
 
   const renderMarks = (text: string, marks: TiptapMark[] = []) => {
-    // DEBUG: Log original text
-    console.log('🟡 [DEBUG renderMarks] Original text:', {
-      text: JSON.stringify(text),
-      textLength: text.length,
-      spaceCount: (text.match(/ /g) || []).length,
-      nbspCount: (text.match(/\u00A0/g) || []).length,
-      hasMultipleSpaces: / {2,}/.test(text),
-      hasNbsp: text.includes('\u00A0')
-    });
-    
+    if (debugSave) {
+      console.log('[DEBUG renderMarks] Original text:', {
+        text: JSON.stringify(text),
+        textLength: text.length,
+        spaceCount: (text.match(/ /g) || []).length,
+        nbspCount: (text.match(/\u00A0/g) || []).length,
+        hasMultipleSpaces: / {2,}/.test(text),
+        hasNbsp: text.includes('\u00A0'),
+      });
+    }
+
     // First escape the text (this will escape & but not \u00A0)
     let result = escapeHTML(text);
 
@@ -56,19 +60,22 @@ function renderNodeToHTML(node: TiptapNode): string {
     // This is a fallback in case non-breaking spaces weren't inserted
     const beforeReplace = result;
     result = result.replace(/ {2,}/g, (match) => {
-      // Convert all spaces in the sequence to  
       const replacement = ' '.repeat(match.length);
-      console.log('🟡 [DEBUG renderMarks] Replacing', match.length, 'spaces with', replacement.length, '  entities');
+      if (debugSave) {
+        console.log('[DEBUG renderMarks] Replacing spaces', match.length, replacement.length);
+      }
       return replacement;
     });
-    
-    // DEBUG: Log after processing
-    if (beforeReplace !== result || text.includes('\u00A0')) {
-      console.log('🟡 [DEBUG renderMarks] After processing:', {
+
+    if (
+      debugSave &&
+      (beforeReplace !== result || text.includes('\u00A0'))
+    ) {
+      console.log('[DEBUG renderMarks] After processing:', {
         original: JSON.stringify(text),
         result: JSON.stringify(result),
         containsNbsp: result.includes(' '),
-        nbspCount: (result.match(/ /g) || []).length
+        nbspCount: (result.match(/ /g) || []).length,
       });
     }
 
@@ -113,14 +120,15 @@ function renderNodeToHTML(node: TiptapNode): string {
 
   switch (node.type) {
     case 'text':
-      // DEBUG: Log ALL text nodes to see what we're working with
-      console.log('🟡 [DEBUG renderNodeToHTML] Text node:', {
-        text: JSON.stringify(node.text),
-        textLength: node.text?.length || 0,
-        spaceCount: node.text ? (node.text.match(/ /g) || []).length : 0,
-        hasMultipleSpaces: node.text ? / {2,}/.test(node.text) : false,
-        multipleSpaceSequences: node.text ? node.text.match(/ {2,}/g) : null
-      });
+      if (debugSave) {
+        console.log('[DEBUG renderNodeToHTML] Text node:', {
+          text: JSON.stringify(node.text),
+          textLength: node.text?.length || 0,
+          spaceCount: node.text ? (node.text.match(/ /g) || []).length : 0,
+          hasMultipleSpaces: node.text ? / {2,}/.test(node.text) : false,
+          multipleSpaceSequences: node.text ? node.text.match(/ {2,}/g) : null,
+        });
+      }
       return renderMarks(node.text || '', node.marks);
 
     case 'paragraph':
@@ -339,14 +347,17 @@ function convertTiptapJSONToSections(tiptapJSON: TiptapJSON, pageId: string) {
       // Add any content (paragraphs, lists, code blocks, etc.) as HTML
       const html = renderNodeToHTML(node);
 
-      // DEBUG: Log HTML output for paragraphs with multiple spaces
-      if (node.type === 'paragraph' && html.includes('  ') || html.includes(' ')) {
+      if (
+        debugSave &&
+        node.type === 'paragraph' &&
+        (html.includes('  ') || html.includes(' '))
+      ) {
         console.log('[DEBUG convertTiptapJSONToSections] Paragraph HTML:', {
           nodeType: node.type,
-          html: html.substring(0, 200), // First 200 chars
+          html: html.substring(0, 200),
           containsMultipleSpaces: / {2,}/.test(html),
           containsNbsp: html.includes(' '),
-          htmlLength: html.length
+          htmlLength: html.length,
         });
       }
 
@@ -513,13 +524,14 @@ export async function PATCH(
     const body = await request.json();
     const { content, projectId } = body;
 
-    // DEBUG: Log what the server receives
-    console.log('🟡 [DEBUG API PATCH] Received save request:', {
-      docId,
-      pageId,
-      projectId,
-      contentPreview: JSON.stringify(content).substring(0, 500)
-    });
+    if (debugSave) {
+      console.log('[DEBUG API PATCH] save request', {
+        docId,
+        pageId,
+        projectId,
+        contentPreview: JSON.stringify(content).substring(0, 500),
+      });
+    }
 
     if (!content) {
       return NextResponse.json(
@@ -528,21 +540,24 @@ export async function PATCH(
       );
     }
 
-    // DEBUG: Log full content structure before conversion
-    console.log('🟡 [DEBUG API PATCH] Full content structure:', JSON.stringify(content, null, 2));
-    
+    if (debugSave) {
+      console.log('[DEBUG API PATCH] full content', JSON.stringify(content, null, 2));
+    }
+
     // Convert Tiptap JSON to sections and extract title
     const { title, sections } = convertTiptapJSONToSections(content, pageId);
 
     // Extract headings for table of contents
     const toc = extractHeadingsForTOC(content);
 
-    // DEBUG: Log sections after conversion
-    console.log('🟡 [DEBUG API PATCH] Converted sections:', JSON.stringify(sections, null, 2));
-    console.log('🟡 [DEBUG API PATCH] Extracted TOC:', JSON.stringify(toc, null, 2));
+    if (debugSave) {
+      console.log('[DEBUG API PATCH] sections', JSON.stringify(sections, null, 2), 'toc', JSON.stringify(toc));
+    }
 
     // Update or create page using updatePage function (it will verify document ownership)
     const page = await updatePage(docId, pageId, title, sections as DocumentSection[], user.id, projectId);
+    revalidatePageCaches(pageId);
+    revalidateDocsNavData();
 
     return NextResponse.json({
       success: true,

app/api/docs/[id]/route.ts

@@ -2,6 +2,7 @@ import { NextRequest, NextResponse } from 'next/server';
 import { revalidatePath } from 'next/cache';
 import { updateDocument, deleteDocument } from '@/lib/db';
 import { getCurrentUser } from '@/lib/users';
+import { revalidateDocsNavData } from '@/lib/revalidate-docs-cache';
 
 export async function PATCH(
   request: NextRequest,
@@ -31,6 +32,7 @@ export async function PATCH(
 
     // Update document (updateDocument will verify ownership)
     const doc = await updateDocument(docId, name, user.id, projectId);
+    revalidateDocsNavData();
 
     const newHref = projectId 
       ? `/docs/projects/${projectId}/${doc.id}`
@@ -71,6 +73,7 @@ export async function DELETE(
 
     // Delete document (deleteDocument will verify ownership)
     await deleteDocument(docId, user.id, projectId);
+    revalidateDocsNavData();
 
     // Revalidate the project page and docs pages to clear cache
     if (projectId) {

app/api/docs/[id]/sections/route.ts

@@ -1,6 +1,7 @@
 import { NextRequest, NextResponse } from 'next/server';
 import { addPageToDocument, prisma } from '@/lib/db';
 import { getCurrentUser } from '@/lib/users';
+import { revalidateDocsNavData } from '@/lib/revalidate-docs-cache';
 
 export async function POST(
   request: NextRequest,
@@ -39,6 +40,7 @@ export async function POST(
       Array.isArray(sectionContent) ? sectionContent : [sectionContent],
       projectId
     );
+    revalidateDocsNavData();
 
     // Get updated document by UUID
     const updatedDoc = await prisma.document.findUnique({

app/api/docs/route.ts

@@ -1,6 +1,7 @@
 import { NextRequest, NextResponse } from 'next/server';
 import { createDocument } from '@/lib/db';
 import { getCurrentUser } from '@/lib/users';
+import { revalidateDocsNavData } from '@/lib/revalidate-docs-cache';
 
 export async function POST(request: NextRequest) {
   try {
@@ -26,6 +27,7 @@ export async function POST(request: NextRequest) {
     // Create new document (createDocument will verify project ownership if projectId is provided)
     if (projectId) {
       const newDoc = await createDocument(name, description, user.id, projectId);
+      revalidateDocsNavData();
 
       // Get the first page slug from the created document
       const firstPage = newDoc.content.pages[0];
@@ -39,6 +41,7 @@ export async function POST(request: NextRequest) {
     } else {
       // Create document in "Your Docs" (createDocument handles unique ID generation)
       const newDoc = await createDocument(name, description, user.id);
+      revalidateDocsNavData();
 
       // Get the first page slug from the created document
       const firstPage = newDoc.content.pages[0];

app/api/documents/[id]/publish/route.ts

@@ -1,6 +1,10 @@
 import { NextRequest, NextResponse } from 'next/server';
 import { getCurrentUser } from '@/lib/users';
 import { prisma } from '@/lib/db';
+import {
+  revalidateDocsNavData,
+  revalidatePublishedNavData,
+} from '@/lib/revalidate-docs-cache';
 import {
   validateDocumentForPublishing,
   generatePublishSlug,
@@ -137,6 +141,8 @@ export async function POST(
         publishSlug,
       },
     });
+    revalidatePublishedNavData();
+    revalidateDocsNavData();
 
     return NextResponse.json({
       success: true,
@@ -195,6 +201,8 @@ export async function DELETE(
     await (prisma.publishedDocument.deleteMany as any)({
       where: { documentId },
     });
+    revalidatePublishedNavData();
+    revalidateDocsNavData();
 
     return NextResponse.json({
       success: true,

app/api/projects/[id]/route.ts

@@ -1,6 +1,7 @@
 import { NextRequest, NextResponse } from 'next/server';
 import { updateProject, deleteProject } from '@/lib/db';
 import { getCurrentUser } from '@/lib/users';
+import { revalidateDocsNavData } from '@/lib/revalidate-docs-cache';
 
 export async function PATCH(
   request: NextRequest,
@@ -30,6 +31,7 @@ export async function PATCH(
 
     // Update project (updateProject will verify ownership)
     const project = await updateProject(projectId, name, user.id);
+    revalidateDocsNavData();
 
     return NextResponse.json({
       success: true,
@@ -63,6 +65,7 @@ export async function DELETE(
 
     // Delete project (deleteProject will verify ownership)
     await deleteProject(projectId, user.id);
+    revalidateDocsNavData();
 
     return NextResponse.json({
       success: true,

app/api/projects/route.ts

@@ -1,6 +1,7 @@
 import { NextRequest, NextResponse } from 'next/server';
 import { createProject } from '@/lib/db';
 import { getCurrentUser } from '@/lib/users';
+import { revalidateDocsNavData } from '@/lib/revalidate-docs-cache';
 
 export async function POST(request: NextRequest) {
   try {
@@ -25,6 +26,7 @@ export async function POST(request: NextRequest) {
 
     // Create new project (createProject handles unique ID generation)
     const newProject = await createProject(name, description, user.id);
+    revalidateDocsNavData();
 
     return NextResponse.json({
       success: true,

app/docs/[[...slug]]/layout.tsx

@@ -5,7 +5,7 @@ import {
   buildSidebarItems,
   type ProcessedYourDoc,
 } from '@/lib/docs';
-import { getAllDocsNavDataCached, getAllPublishedDocsNavCached } from '@/lib/db';
+import { getDocsNavBundleForUser } from '@/lib/db';
 import { getCurrentUser } from '@/lib/users';
 import { DocsLayoutClient } from '@/components/docs/DocsLayoutClient';
 import { redirect } from 'next/navigation';
@@ -21,21 +21,19 @@ export default async function DocsLayout({
     redirect('/sign-in');
   }
 
-  // Use CACHED nav data so we don't run 4–6 DB queries on every navigation
-  const data = await getAllDocsNavDataCached(user.id);
+  // Same bundle as page.tsx — React cache() dedupes so we only hit DB/cache once per request
+  const { data, publishedDocsData } = await getDocsNavBundleForUser(user.id);
   const processedProjects = processProjects(data.projects);
   const processedYourDocs = processYourDocs(data.yourDocs);
 
   let processedPublishedDocs: ProcessedYourDoc[] = [];
   try {
-    const publishedDocsData = await getAllPublishedDocsNavCached();
     const publishSlugsMap = new Map(Object.entries(publishedDocsData.publishSlugs));
     processedPublishedDocs = processPublishedDocs(
       publishedDocsData.documents,
       publishSlugsMap
     );
   } catch (error) {
-    // If published docs can't be fetched (e.g., schema not migrated), just continue without them
     console.error('Error fetching published docs:', error);
     processedPublishedDocs = [];
   }