Add fallback mechanism for bot API when GitHub App is not configured

[ishaileshpant]

🔧 Fix Bot API Function Invocation Failed Error

Problem

The bot API was failing with "FUNCTION_INVOCATION_FAILED" error because it requires GitHub App configuration (GITHUB_APP_ID, GITHUB_APP_PRIVATE_KEY, GITHUB_APP_INSTALLATION_ID) that is not set up in the environment.

Root Cause

The bot API was designed to use GitHub App authentication, but the GitHub App is not configured in the deployment environment. This caused the serverless function to fail when trying to initialize the GitHub App.

Solution

• ✅ Added fallback mechanism when GitHub App is not configured
• ✅ Uses user token directly to create PR via fork instead of bot API
• ✅ Maintains same API interface and response format
• ✅ Provides graceful degradation for content submission functionality

Technical Changes

// Before - would fail if GitHub App not configured
if (!process.env.GITHUB_APP_ID || !process.env.GITHUB_APP_PRIVATE_KEY || !process.env.GITHUB_APP_INSTALLATION_ID) {
    return res.status(503).json({ error: 'GitHub App not configured' });
}

// After - provides fallback when GitHub App not configured
const isGitHubAppConfigured = process.env.GITHUB_APP_ID && process.env.GITHUB_APP_PRIVATE_KEY && process.env.GITHUB_APP_INSTALLATION_ID;

if (!isGitHubAppConfigured) {
    return await handleFallbackSubmission(req, res, contentData, userToken);
}

Fallback Method

The fallback method:

1. Verifies user authentication using their GitHub token
2. Checks for user fork of the repository
3. Creates branch in the user's fork
4. Creates content payload file in the branch
5. Creates pull request from fork to main repository

Files Changed

• api/github/create-content-pr.js - Added fallback mechanism and handleFallbackSubmission function

Impact

• 🎯 Resolves FUNCTION_INVOCATION_FAILED error
• 🚀 Enables content submission without GitHub App configuration
• 🛡️ Provides graceful degradation for missing configuration
• 🔄 Maintains backward compatibility with existing API

Testing

• Fallback method works when GitHub App is not configured
• Bot API still works when GitHub App is configured
• Same API interface and response format maintained
• No linting errors

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
prepguides-dev	Ready	Preview	Comment	Oct 8, 2025 6:49pm

[ishaileshpant]

/approve

[github-actions]

🚀 Admin-Approved and Auto-Merged!

This PR has been automatically merged to main after admin approval by @ishaileshpant.

✅ **Status**: Merged and deployed
🔗 **Commit**: `5c4fc05a28ca6a013da7824eec3bf8a711d4b83a`
📅 **Merged at**: 2025-10-08T18:53:22.755Z
👤 **Approved by**: Admin/Maintainer/Owner

Thank you for your contribution! 🎉