@brainfish-ai/devdoc 0.1.49 → 0.1.50

package/renderer/lib/vercel/domains.js

@@ -0,0 +1,275 @@
+/**
+ * Vercel Domains API Client
+ * 
+ * Functions for managing custom domains via Vercel's REST API.
+ * Handles domain addition, verification, and removal.
+ * 
+ * @see https://vercel.com/docs/rest-api/reference/endpoints/projects/add-a-domain-to-a-project
+ */ // =============================================================================
+// Types
+// =============================================================================
+// =============================================================================
+// Configuration
+// =============================================================================
+function getVercelConfig() {
+    // Support both VERCEL_API_TOKEN and VERCEL_TOKEN (used by Vercel CLI)
+    const token = process.env.VERCEL_API_TOKEN || process.env.VERCEL_TOKEN;
+    const projectId = process.env.VERCEL_PROJECT_ID;
+    const teamId = process.env.VERCEL_TEAM_ID;
+    if (!token || !projectId) {
+        return null;
+    }
+    return {
+        token,
+        projectId,
+        teamId
+    };
+}
+/**
+ * Check if Vercel integration is available
+ */ export function isVercelIntegrationEnabled() {
+    return getVercelConfig() !== null;
+}
+// =============================================================================
+// API Functions
+// =============================================================================
+/**
+ * Add a domain to the Vercel project
+ * 
+ * @param domainName - The domain to add (e.g., "docs.example.com")
+ * @returns Result with domain details and verification instructions
+ */ export async function addDomainToProject(domainName) {
+    const config = getVercelConfig();
+    if (!config) {
+        return {
+            success: false,
+            error: 'Vercel integration not configured. Set VERCEL_API_TOKEN and VERCEL_PROJECT_ID.'
+        };
+    }
+    const { token, projectId, teamId } = config;
+    try {
+        const url = new URL(`https://api.vercel.com/v10/projects/${projectId}/domains`);
+        if (teamId) {
+            url.searchParams.set('teamId', teamId);
+        }
+        const response = await fetch(url.toString(), {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${token}`,
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({
+                name: domainName
+            })
+        });
+        const data = await response.json();
+        if (!response.ok) {
+            const errorData = data;
+            console.error('[Vercel Domains] Error adding domain:', errorData);
+            return {
+                success: false,
+                error: `Failed to add domain to Vercel: ${errorData.error?.message || 'Unknown error'}`,
+                vercelError: errorData.error?.code
+            };
+        }
+        const domainData = data;
+        console.log('[Vercel Domains] Domain added:', domainData.name, 'verified:', domainData.verified);
+        return {
+            success: true,
+            domain: domainData
+        };
+    } catch (error) {
+        console.error('[Vercel Domains] Network error adding domain:', error);
+        return {
+            success: false,
+            error: `Network error: ${error instanceof Error ? error.message : String(error)}`
+        };
+    }
+}
+/**
+ * Verify a domain's DNS configuration with Vercel
+ * 
+ * @param domainName - The domain to verify
+ * @returns Result indicating if domain is now verified
+ */ export async function verifyDomain(domainName) {
+    const config = getVercelConfig();
+    if (!config) {
+        return {
+            success: false,
+            verified: false,
+            error: 'Vercel integration not configured. Set VERCEL_API_TOKEN and VERCEL_PROJECT_ID.'
+        };
+    }
+    const { token, projectId, teamId } = config;
+    try {
+        const url = new URL(`https://api.vercel.com/v10/projects/${projectId}/domains/${domainName}/verify`);
+        if (teamId) {
+            url.searchParams.set('teamId', teamId);
+        }
+        const response = await fetch(url.toString(), {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${token}`
+            }
+        });
+        const data = await response.json();
+        if (!response.ok) {
+            const errorData = data;
+            console.error('[Vercel Domains] Error verifying domain:', errorData);
+            return {
+                success: false,
+                verified: false,
+                error: `Verification failed: ${errorData.error?.message || 'Unknown error'}`
+            };
+        }
+        const domainData = data;
+        console.log('[Vercel Domains] Domain verification result:', domainData.name, 'verified:', domainData.verified);
+        return {
+            success: true,
+            verified: domainData.verified,
+            domain: domainData
+        };
+    } catch (error) {
+        console.error('[Vercel Domains] Network error verifying domain:', error);
+        return {
+            success: false,
+            verified: false,
+            error: `Network error: ${error instanceof Error ? error.message : String(error)}`
+        };
+    }
+}
+/**
+ * Remove a domain from the Vercel project
+ * 
+ * @param domainName - The domain to remove
+ * @returns Result indicating success or failure
+ */ export async function removeDomain(domainName) {
+    const config = getVercelConfig();
+    if (!config) {
+        return {
+            success: false,
+            error: 'Vercel integration not configured. Set VERCEL_API_TOKEN and VERCEL_PROJECT_ID.'
+        };
+    }
+    const { token, projectId, teamId } = config;
+    try {
+        const url = new URL(`https://api.vercel.com/v10/projects/${projectId}/domains/${domainName}`);
+        if (teamId) {
+            url.searchParams.set('teamId', teamId);
+        }
+        const response = await fetch(url.toString(), {
+            method: 'DELETE',
+            headers: {
+                'Authorization': `Bearer ${token}`
+            }
+        });
+        if (!response.ok) {
+            const errorData = await response.json();
+            console.error('[Vercel Domains] Error removing domain:', errorData);
+            return {
+                success: false,
+                error: `Failed to remove domain from Vercel: ${errorData.error?.message || 'Unknown error'}`
+            };
+        }
+        console.log('[Vercel Domains] Domain removed:', domainName);
+        return {
+            success: true
+        };
+    } catch (error) {
+        console.error('[Vercel Domains] Network error removing domain:', error);
+        return {
+            success: false,
+            error: `Network error: ${error instanceof Error ? error.message : String(error)}`
+        };
+    }
+}
+/**
+ * Get domain configuration and status from Vercel
+ * 
+ * @param domainName - The domain to check
+ * @returns Domain details including verification status
+ */ export async function getDomainConfig(domainName) {
+    const config = getVercelConfig();
+    if (!config) {
+        return {
+            success: false,
+            error: 'Vercel integration not configured. Set VERCEL_API_TOKEN and VERCEL_PROJECT_ID.'
+        };
+    }
+    const { token, projectId, teamId } = config;
+    try {
+        const url = new URL(`https://api.vercel.com/v10/projects/${projectId}/domains/${domainName}`);
+        if (teamId) {
+            url.searchParams.set('teamId', teamId);
+        }
+        const response = await fetch(url.toString(), {
+            method: 'GET',
+            headers: {
+                'Authorization': `Bearer ${token}`
+            }
+        });
+        if (!response.ok) {
+            const errorData = await response.json();
+            console.error('[Vercel Domains] Error getting domain config:', errorData);
+            return {
+                success: false,
+                error: `Failed to get domain config: ${errorData.error?.message || 'Unknown error'}`
+            };
+        }
+        const domainData = await response.json();
+        return {
+            success: true,
+            domain: domainData
+        };
+    } catch (error) {
+        console.error('[Vercel Domains] Network error getting domain config:', error);
+        return {
+            success: false,
+            error: `Network error: ${error instanceof Error ? error.message : String(error)}`
+        };
+    }
+}
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Format Vercel's verification instructions for display
+ * 
+ * @param verification - Vercel's verification array
+ * @returns Formatted DNS instructions
+ */ export function formatVerificationInstructions(verification) {
+    const records = verification.map((v)=>({
+            type: v.type,
+            name: v.domain,
+            value: v.value
+        }));
+    const instructions = [
+        'Add the following DNS record(s) to your domain provider:',
+        ''
+    ];
+    verification.forEach((v, i)=>{
+        instructions.push(`${i + 1}. ${v.type} Record:`);
+        instructions.push(`   Name: ${v.domain}`);
+        instructions.push(`   Value: ${v.value}`);
+        if (v.reason) {
+            instructions.push(`   Note: ${v.reason}`);
+        }
+        instructions.push('');
+    });
+    instructions.push('After adding DNS records, run "devdoc domain verify" to verify.');
+    return {
+        records,
+        instructions
+    };
+}
+/**
+ * Check if a domain needs CNAME or A record based on whether it's apex or subdomain
+ * Vercel typically requires:
+ * - Subdomains: CNAME to cname.vercel-dns.com
+ * - Apex domains: A record to Vercel's IP or ALIAS/ANAME if supported
+ */ export function getDomainType(domainName) {
+    const parts = domainName.split('.');
+    // If it's just domain.tld (2 parts), it's an apex domain
+    // If it has more parts (like docs.domain.tld), it's a subdomain
+    return parts.length <= 2 ? 'apex' : 'subdomain';
+}