Merge pull request #4 from Emlembow/claude/issue-3-20250610_170119

fix: Enhanced error handling for 503 API service unavailable errors

Author: Emlembow

app/api/chat/route.ts

@@ -29,8 +29,28 @@ export async function POST(request: NextRequest) {
       })
     }
 
-    // Get system prompt
-    const systemPrompt = await buildSystemPrompt()
+    // Get system prompt with enhanced error handling
+    let systemPrompt: string
+    try {
+      console.log('Attempting to build system prompt...')
+      systemPrompt = await buildSystemPrompt()
+      console.log('System prompt built successfully')
+    } catch (error) {
+      console.error('Failed to build system prompt:', error)
+      return new NextResponse(
+        JSON.stringify({
+          error: "Service temporarily unavailable",
+          details: `Failed to build system prompt: ${error instanceof Error ? error.message : 'Unknown error'}`,
+          debug: process.env.NODE_ENV === 'development' ? {
+            stack: error instanceof Error ? error.stack : 'No stack trace available'
+          } : undefined
+        }),
+        {
+          status: 503,
+          headers: { "Content-Type": "application/json" },
+        },
+      )
+    }
 
     // Initialize OpenAI client
     const openai = new OpenAI({
@@ -79,13 +99,23 @@ export async function POST(request: NextRequest) {
 
   } catch (error) {
     console.error("Error processing chat request:", error)
+    
+    // Determine if this is a system prompt error or other error
+    const isSystemPromptError = error instanceof Error && error.message.includes('system prompt')
+    const statusCode = isSystemPromptError ? 503 : 500
+    
     return new NextResponse(
       JSON.stringify({
-        error: "Service temporarily unavailable",
+        error: isSystemPromptError ? "Service temporarily unavailable" : "Internal server error",
         details: error instanceof Error ? error.message : "Unknown error",
+        errorType: isSystemPromptError ? "system_prompt_error" : "general_error",
+        debug: process.env.NODE_ENV === 'development' ? {
+          stack: error instanceof Error ? error.stack : 'No stack trace available',
+          timestamp: new Date().toISOString()
+        } : undefined
       }),
       {
-        status: 503,
+        status: statusCode,
         headers: { "Content-Type": "application/json" },
       },
     )

lib/content.ts

@@ -57,14 +57,30 @@ export type Education = {
 // Helper function to read directory contents
 const readDirectory = (dir: string) => {
   const directory = path.join(process.cwd(), dir)
-  return fs.readdirSync(directory)
+  try {
+    console.log(`Reading directory: ${directory}`)
+    const files = fs.readdirSync(directory)
+    console.log(`Successfully read directory ${dir} with ${files.length} files`)
+    return files
+  } catch (error) {
+    console.error(`Failed to read directory ${dir}:`, error)
+    throw new Error(`Cannot read directory ${dir}: ${error instanceof Error ? error.message : 'Unknown error'}`)
+  }
 }
 
 // Helper function to read and parse markdown file
 const readMarkdownFile = (filePath: string) => {
   const fullPath = path.join(process.cwd(), filePath)
-  const fileContents = fs.readFileSync(fullPath, "utf8")
-  return matter(fileContents)
+  try {
+    console.log(`Reading markdown file: ${fullPath}`)
+    const fileContents = fs.readFileSync(fullPath, "utf8")
+    const parsed = matter(fileContents)
+    console.log(`Successfully parsed markdown file: ${filePath}`)
+    return parsed
+  } catch (error) {
+    console.error(`Failed to read markdown file ${filePath}:`, error)
+    throw new Error(`Cannot read file ${filePath}: ${error instanceof Error ? error.message : 'Unknown error'}`)
+  }
 }
 
 // Get profile information

lib/system-prompt.ts

@@ -121,29 +121,51 @@ const buildSystemPromptFromTemplate = async (templateContent: string, data: {
 // System prompt builder function
 export const buildSystemPrompt = cache(async (): Promise<string> => {
   try {
+    console.log('Starting system prompt build process...')
+    
     // Read the main template file
     const templatePath = path.join(process.cwd(), 'content/system-prompt.md')
-    const templateContent = fs.readFileSync(templatePath, 'utf8')
+    console.log(`Reading main template from: ${templatePath}`)
+    
+    let templateContent: string
+    try {
+      templateContent = fs.readFileSync(templatePath, 'utf8')
+      console.log(`Successfully read main template (${templateContent.length} characters)`)
+    } catch (error) {
+      console.error(`Failed to read main template file: ${error}`)
+      throw new Error(`Failed to read system prompt template: ${error instanceof Error ? error.message : 'Unknown error'}`)
+    }
 
     // Read the additional system prompt file if it exists
     const additionalTemplatePath = path.join(process.cwd(), 'content/system-prompt-extended.md')
     let additionalContent = ''
+    console.log(`Checking for extended template at: ${additionalTemplatePath}`)
     try {
       additionalContent = fs.readFileSync(additionalTemplatePath, 'utf8')
+      console.log(`Successfully read extended template (${additionalContent.length} characters)`)
     } catch (error) {
       console.log('No extended system prompt file found, continuing with base content only')
     }
 
-    // Fetch all content
-    const [profile, about, education, experiences, references, blogPosts, projects] = await Promise.all([
-      getProfileInfo(),
-      getAboutContent(),
-      getEducation(),
-      getExperiences(),
-      getReferences(),
-      getBlogPosts(),
-      getProjects(),
-    ])
+    // Fetch all content with individual error handling
+    console.log('Fetching all content sources...')
+    let profile, about, education, experiences, references, blogPosts, projects
+    
+    try {
+      [profile, about, education, experiences, references, blogPosts, projects] = await Promise.all([
+        getProfileInfo(),
+        getAboutContent(),
+        getEducation(),
+        getExperiences(),
+        getReferences(),
+        getBlogPosts(),
+        getProjects(),
+      ])
+      console.log('Successfully fetched all content sources')
+    } catch (error) {
+      console.error(`Failed to fetch content sources: ${error}`)
+      throw new Error(`Failed to load content: ${error instanceof Error ? error.message : 'Unknown error'}`)
+    }
 
     // Format work experience
     const workExperience = experiences.map((exp, index) => `
@@ -256,18 +278,35 @@ ${post.content.replace(/<[^>]*>/g, '').slice(0, 500).trim()}...
     }
 
     // Build the main system prompt
-    const mainPrompt = await buildSystemPromptFromTemplate(templateContent, templateData)
+    console.log('Building main system prompt from template...')
+    let mainPrompt: string
+    try {
+      mainPrompt = await buildSystemPromptFromTemplate(templateContent, templateData)
+      console.log(`Successfully built main prompt (${mainPrompt.length} characters)`)
+    } catch (error) {
+      console.error(`Failed to build main prompt from template: ${error}`)
+      throw new Error(`Template processing failed: ${error instanceof Error ? error.message : 'Unknown error'}`)
+    }
 
     // Build and append extended content if available
     let finalPrompt = mainPrompt
     if (additionalContent) {
-      const extendedPrompt = await buildSystemPromptFromTemplate(additionalContent, templateData)
-      finalPrompt = `${mainPrompt}\n\n## EXTENDED CONTEXT\n${extendedPrompt}`
+      console.log('Processing extended template content...')
+      try {
+        const extendedPrompt = await buildSystemPromptFromTemplate(additionalContent, templateData)
+        finalPrompt = `${mainPrompt}\n\n## EXTENDED CONTEXT\n${extendedPrompt}`
+        console.log(`Successfully built extended prompt (${finalPrompt.length} total characters)`)
+      } catch (error) {
+        console.error(`Failed to process extended template: ${error}`)
+        console.log('Continuing with main prompt only')
+      }
     }
 
+    console.log('System prompt build completed successfully')
     return finalPrompt
   } catch (error) {
     console.error('Error building system prompt:', error)
-    throw new Error('Failed to build system prompt')
+    const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred'
+    throw new Error(`Failed to build system prompt: ${errorMessage}`)
   }
 })