@brainfish-ai/devdoc 0.1.49 → 0.1.50

package/renderer/app/api/domains/add/route.js

@@ -1,12 +1,18 @@
 import { NextResponse } from 'next/server';
-import { validateApiKey, addCustomDomain, isCustomDomainRegistered } from '@/lib/storage/blob';
-import { isValidDomain, normalizeDomain, getDnsInstructions } from '@/lib/docs/config';
+import { validateApiKey, addCustomDomain, isCustomDomainRegistered, updateCustomDomainStatus } from '@/lib/storage/blob';
+import { isValidDomain, normalizeDomain } from '@/lib/docs/config';
+import { addDomainToProject, isVercelIntegrationEnabled, formatVerificationInstructions, getDomainType } from '@/lib/vercel/domains';
 /**
  * POST /api/domains/add
  * 
  * Add a custom domain to a project.
  * Each project can have ONE custom domain (free).
  * 
+ * When Vercel integration is enabled (VERCEL_API_TOKEN + VERCEL_PROJECT_ID):
+ * - Domain is added to Vercel project
+ * - Real DNS verification instructions from Vercel are returned
+ * - SSL is provisioned automatically by Vercel after verification
+ * 
  * Headers:
  *   Authorization: Bearer <api_key>
  * 
@@ -18,10 +24,9 @@ import { isValidDomain, normalizeDomain, getDnsInstructions } from '@/lib/docs/c
  *     success: true,
  *     domain: "docs.example.com",
  *     status: "pending",
- *     verification: {
- *       cname: { name: "docs", value: "cname.devdoc-dns.com" },
- *       txt: { name: "_devdoc-verify.docs.example.com", value: "devdoc-verify=xxx" }
- *     }
+ *     verification: [
+ *       { type: "TXT", domain: "_vercel.docs.example.com", value: "vc-domain-verify=..." }
+ *     ]
  *   }
  */ export async function POST(request) {
     try {
@@ -63,7 +68,7 @@ import { isValidDomain, normalizeDomain, getDnsInstructions } from '@/lib/docs/c
                 status: 400
             });
         }
-        // Check if domain is already registered
+        // Check if domain is already registered in our registry
         const isRegistered = await isCustomDomainRegistered(customDomain);
         if (isRegistered) {
             return NextResponse.json({
@@ -72,42 +77,115 @@ import { isValidDomain, normalizeDomain, getDnsInstructions } from '@/lib/docs/c
                 status: 409
             });
         }
-        // Add the custom domain
-        const result = await addCustomDomain(projectSlug, customDomain);
-        if (!result.success) {
+        // Check if Vercel integration is enabled
+        if (isVercelIntegrationEnabled()) {
+            // Add domain to Vercel project
+            const vercelResult = await addDomainToProject(customDomain);
+            if (!vercelResult.success) {
+                return NextResponse.json({
+                    error: vercelResult.error,
+                    vercelError: vercelResult.vercelError
+                }, {
+                    status: 400
+                });
+            }
+            const vercelDomain = vercelResult.domain;
+            // Add to our internal registry with Vercel data
+            const result = await addCustomDomain(projectSlug, customDomain);
+            if (!result.success) {
+                // Rollback: Try to remove from Vercel if we couldn't add to registry
+                console.error('[Domains API] Failed to add to registry, domain added to Vercel:', customDomain);
+                return NextResponse.json({
+                    error: result.error
+                }, {
+                    status: 400
+                });
+            }
+            // Update with Vercel domain ID
+            await updateCustomDomainStatus(customDomain, vercelDomain.verified ? 'active' : 'pending', {
+                vercelDomainId: vercelDomain.projectId
+            });
+            // If Vercel already verified the domain (e.g., previously configured DNS)
+            if (vercelDomain.verified) {
+                return NextResponse.json({
+                    success: true,
+                    domain: customDomain,
+                    projectSlug,
+                    status: 'active',
+                    verified: true,
+                    message: 'Domain is already verified and active!'
+                });
+            }
+            // Format Vercel's verification instructions
+            const verification = vercelDomain.verification || [];
+            const { records, instructions } = formatVerificationInstructions(verification);
+            // Add CNAME instruction for subdomains (Vercel may not always include it)
+            const domainType = getDomainType(customDomain);
+            const parts = customDomain.split('.');
+            const subdomain = parts.length > 2 ? parts[0] : '@';
+            const cnameInstruction = domainType === 'subdomain' ? `\nAlso add a CNAME record:\n   Name: ${subdomain}\n   Value: cname.vercel-dns.com` : `\nFor apex domains, add an A record:\n   Name: @\n   Value: 76.76.21.21`;
             return NextResponse.json({
-                error: result.error
-            }, {
-                status: 400
+                success: true,
+                domain: customDomain,
+                projectSlug,
+                status: 'pending',
+                verified: false,
+                verification: records,
+                instructions: [
+                    ...instructions,
+                    cnameInstruction
+                ],
+                vercelVerification: verification
+            });
+        } else {
+            // Fallback: No Vercel integration, use legacy behavior
+            console.warn('[Domains API] Vercel integration not configured, using legacy mode');
+            const result = await addCustomDomain(projectSlug, customDomain);
+            if (!result.success) {
+                return NextResponse.json({
+                    error: result.error
+                }, {
+                    status: 400
+                });
+            }
+            // Legacy hardcoded DNS instructions
+            const parts = customDomain.split('.');
+            const subdomain = parts.length > 2 ? parts[0] : '@';
+            return NextResponse.json({
+                success: true,
+                domain: customDomain,
+                projectSlug,
+                status: result.entry.status,
+                verified: false,
+                verification: [
+                    {
+                        type: 'CNAME',
+                        name: subdomain,
+                        value: 'cname.vercel-dns.com'
+                    },
+                    {
+                        type: 'TXT',
+                        name: `_devdoc-verify.${customDomain}`,
+                        value: result.entry.verificationToken || ''
+                    }
+                ],
+                instructions: [
+                    'Add the following DNS records to your domain:',
+                    '',
+                    '1. CNAME Record:',
+                    `   Name: ${subdomain}`,
+                    '   Value: cname.vercel-dns.com',
+                    '',
+                    '2. TXT Record (for verification):',
+                    `   Name: _devdoc-verify.${customDomain}`,
+                    `   Value: ${result.entry.verificationToken || ''}`,
+                    '',
+                    'After adding DNS records, run "devdoc domain verify" to verify.',
+                    '',
+                    'Note: Vercel integration not configured. Set VERCEL_API_TOKEN and VERCEL_PROJECT_ID for automatic SSL.'
+                ]
             });
         }
-        // Get DNS instructions
-        const dnsInstructions = getDnsInstructions(customDomain);
-        // Add verification token to TXT record
-        dnsInstructions.txt.value = result.entry.verificationToken || '';
-        return NextResponse.json({
-            success: true,
-            domain: customDomain,
-            projectSlug,
-            status: result.entry.status,
-            verification: {
-                cname: dnsInstructions.cname,
-                txt: dnsInstructions.txt
-            },
-            instructions: [
-                'Add the following DNS records to your domain:',
-                '',
-                `1. CNAME Record:`,
-                `   Name: ${dnsInstructions.cname.name}`,
-                `   Value: ${dnsInstructions.cname.value}`,
-                '',
-                `2. TXT Record (for verification):`,
-                `   Name: ${dnsInstructions.txt.name}`,
-                `   Value: ${dnsInstructions.txt.value}`,
-                '',
-                'After adding DNS records, run "devdoc domain verify" to verify.'
-            ]
-        });
     } catch (error) {
         console.error('[Domains API] Error adding domain:', error);
         const message = error instanceof Error ? error.message : String(error);

package/renderer/app/api/domains/remove/route.js

@@ -1,11 +1,16 @@
 import { NextResponse } from 'next/server';
 import { validateApiKey, getProjectCustomDomain, removeCustomDomain } from '@/lib/storage/blob';
 import { normalizeDomain } from '@/lib/docs/config';
+import { removeDomain as vercelRemoveDomain, isVercelIntegrationEnabled } from '@/lib/vercel/domains';
 /**
  * DELETE /api/domains/remove
  * 
  * Remove a custom domain from a project.
  * 
+ * When Vercel integration is enabled:
+ * - Removes domain from Vercel project
+ * - Removes from internal registry
+ * 
  * Headers:
  *   Authorization: Bearer <api_key>
  * 
@@ -52,7 +57,17 @@ import { normalizeDomain } from '@/lib/docs/config';
             }
             customDomain = projectDomain.customDomain;
         }
-        // Remove the domain
+        // Remove from Vercel if integration is enabled
+        if (isVercelIntegrationEnabled()) {
+            const vercelResult = await vercelRemoveDomain(customDomain);
+            if (!vercelResult.success) {
+                // Log warning but continue - domain might not exist in Vercel
+                console.warn('[Domains API] Failed to remove from Vercel:', vercelResult.error);
+            } else {
+                console.log('[Domains API] Domain removed from Vercel:', customDomain);
+            }
+        }
+        // Remove from internal registry
         const result = await removeCustomDomain(customDomain, projectSlug);
         if (!result.success) {
             return NextResponse.json({
@@ -61,8 +76,6 @@ import { normalizeDomain } from '@/lib/docs/config';
                 status: 400
             });
         }
-        // TODO: In production, also remove from Vercel via API
-        // await vercelApi.removeDomain(customDomain)
         return NextResponse.json({
             success: true,
             message: `Domain ${customDomain} removed successfully`,

package/renderer/app/api/domains/verify/route.js

@@ -1,6 +1,7 @@
 import { NextResponse } from 'next/server';
 import { validateApiKey, getProjectCustomDomain, getCustomDomainEntry, updateCustomDomainStatus } from '@/lib/storage/blob';
 import { normalizeDomain } from '@/lib/docs/config';
+import { verifyDomain as vercelVerifyDomain, getDomainConfig, isVercelIntegrationEnabled, formatVerificationInstructions } from '@/lib/vercel/domains';
 import dns from 'dns';
 import { promisify } from 'util';
 const resolveCname = promisify(dns.resolveCname);
@@ -9,7 +10,13 @@ const resolveTxt = promisify(dns.resolveTxt);
  * POST /api/domains/verify
  * 
  * Verify DNS configuration for a custom domain.
- * Checks CNAME and TXT records, then triggers SSL provisioning.
+ * 
+ * When Vercel integration is enabled:
+ * - Calls Vercel's verify endpoint directly
+ * - Vercel handles DNS verification and SSL provisioning
+ * 
+ * Legacy mode (no Vercel integration):
+ * - Checks CNAME and TXT records manually
  * 
  * Headers:
  *   Authorization: Bearer <api_key>
@@ -21,11 +28,9 @@ const resolveTxt = promisify(dns.resolveTxt);
  *   {
  *     success: true,
  *     domain: "docs.example.com",
- *     status: "dns_verified",
- *     checks: {
- *       cname: { found: true, value: "cname.devdoc-dns.com" },
- *       txt: { found: true, verified: true }
- *     }
+ *     status: "active",
+ *     verified: true,
+ *     message: "Domain verified! SSL will be provisioned automatically."
  *   }
  */ export async function POST(request) {
     try {
@@ -62,7 +67,7 @@ const resolveTxt = promisify(dns.resolveTxt);
             }
             customDomain = projectDomain.customDomain;
         }
-        // Get domain entry
+        // Get domain entry from our registry
         const domainEntry = await getCustomDomainEntry(customDomain);
         if (!domainEntry) {
             return NextResponse.json({
@@ -79,12 +84,74 @@ const resolveTxt = promisify(dns.resolveTxt);
                 status: 403
             });
         }
-        // Check DNS records
+        // Use Vercel integration if available
+        if (isVercelIntegrationEnabled()) {
+            // Call Vercel's verify endpoint
+            const verifyResult = await vercelVerifyDomain(customDomain);
+            if (!verifyResult.success) {
+                // Get current domain config to show what's needed
+                const configResult = await getDomainConfig(customDomain);
+                const verification = configResult.domain?.verification || [];
+                let instructions = [];
+                if (verification.length > 0) {
+                    const formatted = formatVerificationInstructions(verification);
+                    instructions = formatted.instructions;
+                }
+                return NextResponse.json({
+                    success: false,
+                    domain: customDomain,
+                    projectSlug,
+                    status: domainEntry.status,
+                    verified: false,
+                    message: verifyResult.error || 'DNS verification failed. Please check your DNS records.',
+                    verification: verification.map((v)=>({
+                            type: v.type,
+                            name: v.domain,
+                            value: v.value
+                        })),
+                    instructions
+                });
+            }
+            // Domain verified successfully
+            if (verifyResult.verified) {
+                // Update our registry to mark as active
+                await updateCustomDomainStatus(customDomain, 'active');
+                return NextResponse.json({
+                    success: true,
+                    domain: customDomain,
+                    projectSlug,
+                    status: 'active',
+                    verified: true,
+                    message: 'Domain verified! SSL certificate will be provisioned automatically by Vercel.'
+                });
+            } else {
+                // Vercel didn't verify yet, return what's needed
+                const verification = verifyResult.domain?.verification || [];
+                const { instructions } = formatVerificationInstructions(verification);
+                return NextResponse.json({
+                    success: false,
+                    domain: customDomain,
+                    projectSlug,
+                    status: 'pending',
+                    verified: false,
+                    message: 'DNS records not yet propagated. This can take up to 48 hours.',
+                    verification: verification.map((v)=>({
+                            type: v.type,
+                            name: v.domain,
+                            value: v.value
+                        })),
+                    instructions
+                });
+            }
+        }
+        // Legacy verification (no Vercel integration)
+        console.warn('[Domains API] Vercel integration not configured, using legacy DNS verification');
+        // Check DNS records manually
         const checks = {
             cname: {
                 found: false,
                 value: null,
-                expected: 'cname.devdoc-dns.com'
+                expected: 'cname.vercel-dns.com'
             },
             txt: {
                 found: false,
@@ -116,18 +183,15 @@ const resolveTxt = promisify(dns.resolveTxt);
         // TXT not found or DNS error
         }
         // Determine overall status
-        const cnameValid = checks.cname.found && checks.cname.value?.toLowerCase().includes('devdoc');
+        const cnameValid = checks.cname.found && checks.cname.value?.toLowerCase().includes('vercel');
         const txtValid = checks.txt.found && checks.txt.verified;
         let newStatus = domainEntry.status;
         let message = '';
         if (cnameValid && txtValid) {
-            // DNS is verified, update status
-            newStatus = 'dns_verified';
-            message = 'DNS verified! SSL certificate will be provisioned automatically (1-24 hours).';
-            await updateCustomDomainStatus(customDomain, 'dns_verified');
-        // In production, this would trigger Vercel API to add domain
-        // For now, we simulate SSL provisioning by updating status
-        // TODO: Integrate with Vercel Domains API
+            // DNS is verified
+            newStatus = 'active';
+            message = 'DNS verified! Domain is now active.';
+            await updateCustomDomainStatus(customDomain, 'active');
         } else if (cnameValid && !txtValid) {
             message = 'CNAME record found, but TXT verification record is missing or incorrect.';
         } else if (!cnameValid && txtValid) {
@@ -140,6 +204,7 @@ const resolveTxt = promisify(dns.resolveTxt);
             domain: customDomain,
             projectSlug,
             status: newStatus,
+            verified: cnameValid && txtValid,
             message,
             checks: {
                 cname: {

package/renderer/app/api/schema/route.js

@@ -6,10 +6,6 @@ import { getProjectContent } from '@/lib/storage/blob';
 const STARTER_PATH = process.env.STARTER_PATH || 'devdoc-docs';
 // Get the docs directory - respects STARTER_PATH for local development
 function getDocsDir() {
-    const projectSlug = process.env.BRAINFISH_PROJECT_SLUG;
-    if (projectSlug) {
-        return join(process.cwd(), '.devdoc', projectSlug);
-    }
     // Use STARTER_PATH (can be absolute or relative)
     if (isAbsolute(STARTER_PATH)) {
         return STARTER_PATH;
@@ -43,22 +39,27 @@ export async function GET(request) {
         });
     }
     try {
-        // Try blob storage first (for deployed projects)
-        const projectSlug = process.env.BRAINFISH_PROJECT_SLUG;
+        // Get project slug from middleware header (multi-tenant) or env var (single-tenant)
+        const projectSlug = request.headers.get('x-devdoc-project') || process.env.BRAINFISH_PROJECT_SLUG;
+        // Try blob storage first (for deployed/multi-tenant projects)
         if (projectSlug) {
             const projectContent = await getProjectContent(projectSlug);
-            if (projectContent?.files) {
-                const file = projectContent.files.find((f)=>f.path === path || f.path === `/${path}`);
-                if (file?.content) {
-                    return new NextResponse(file.content, {
+            // Check dedicated graphqlSchemas map first (like OpenAPI specs)
+            if (projectContent?.graphqlSchemas) {
+                const schemaContent = projectContent.graphqlSchemas[path] || projectContent.graphqlSchemas[path.replace(/^\//, '')] // Try without leading slash
+                ;
+                if (schemaContent) {
+                    return new NextResponse(schemaContent, {
                         headers: {
                             'Content-Type': 'text/plain'
                         }
                     });
                 }
+                // Log for debugging - schema not found
+                console.log('[Schema API] Schema not found in graphqlSchemas:', path, 'Available:', Object.keys(projectContent.graphqlSchemas));
             }
         }
-        // Try local filesystem
+        // Try local filesystem (for local development)
         const docsDir = getDocsDir();
         const fullPath = join(docsDir, path);
         if (!existsSync(fullPath)) {

package/renderer/components/docs-header.js

@@ -7,9 +7,8 @@ import { ThemeToggle } from "@/components/theme-toggle";
 import { useMobile } from "@/lib/api-docs/mobile-context";
 import { Button } from "@/components/ui/button";
 import { cn } from "@/lib/utils";
-// Default logo fallback
-const DEFAULT_LOGO = {
-    url: 'https://cdn.prod.website-files.com/639181964f4fe88697a20a0a/67af64a5ba42bb659b8560c9_Logo%20(3).svg',
+// Default logo dimensions (no default URL - show name only if no logo configured)
+const DEFAULT_LOGO_DIMENSIONS = {
     alt: 'Logo',
     width: 80,
     height: 24
@@ -19,13 +18,14 @@ export function DocsHeader({ navigationTabs = [], activeTab, onTabChange, docsNa
     // Use config values with defaults
     // Support both single URL and separate light/dark logos
     const hasLightDarkLogos = docsLogo?.light && docsLogo?.dark;
+    const hasAnyLogo = docsLogo?.url || hasLightDarkLogos;
     const logo = {
-        url: docsLogo?.url || DEFAULT_LOGO.url,
+        url: docsLogo?.url,
         light: docsLogo?.light,
         dark: docsLogo?.dark,
-        alt: docsLogo?.alt || DEFAULT_LOGO.alt,
-        width: docsLogo?.width || DEFAULT_LOGO.width,
-        height: docsLogo?.height || DEFAULT_LOGO.height
+        alt: docsLogo?.alt || DEFAULT_LOGO_DIMENSIONS.alt,
+        width: docsLogo?.width || DEFAULT_LOGO_DIMENSIONS.width,
+        height: docsLogo?.height || DEFAULT_LOGO_DIMENSIONS.height
     };
     const showSearch = docsHeader?.showSearch !== false // Default true
     ;
@@ -87,7 +87,7 @@ export function DocsHeader({ navigationTabs = [], activeTab, onTabChange, docsNa
                                                 priority: true
                                             })
                                         ]
-                                    }) : /*#__PURE__*/ _jsx(Image, {
+                                    }) : logo.url ? /*#__PURE__*/ _jsx(Image, {
                                         src: logo.url,
                                         alt: logo.alt,
                                         width: logo.width,
@@ -97,14 +97,14 @@ export function DocsHeader({ navigationTabs = [], activeTab, onTabChange, docsNa
                                             height: logo.height
                                         },
                                         priority: true
-                                    }),
+                                    }) : null,
                                     docsName && /*#__PURE__*/ _jsxs(_Fragment, {
                                         children: [
-                                            /*#__PURE__*/ _jsx("div", {
+                                            hasAnyLogo && /*#__PURE__*/ _jsx("div", {
                                                 className: "hidden sm:block h-5 w-px bg-border"
                                             }),
                                             /*#__PURE__*/ _jsx("span", {
-                                                className: "docs-header-title hidden sm:inline text-sm font-medium text-muted-foreground pointer-events-none",
+                                                className: cn("docs-header-title text-sm font-medium pointer-events-none", hasAnyLogo ? "hidden sm:inline text-muted-foreground" : "text-foreground font-semibold"),
                                                 children: docsName
                                             })
                                         ]

package/renderer/lib/docs/config/domain-schema.js

@@ -145,13 +145,26 @@ export const domainConfigSchema = z.object({
 }
 /**
  * Get DNS instructions for a custom domain
+ * 
+ * NOTE: When Vercel integration is enabled (VERCEL_API_TOKEN + VERCEL_PROJECT_ID),
+ * the actual DNS instructions come from Vercel's API response.
+ * This function is used as a fallback for legacy/local development mode.
+ * 
+ * For Vercel-hosted projects:
+ * - Subdomains: CNAME to cname.vercel-dns.com
+ * - Apex domains: A record to 76.76.21.21
+ * 
+ * @param customDomain - The custom domain (e.g., "docs.example.com")
+ * @returns DNS instructions for CNAME and TXT records
  */ export function getDnsInstructions(customDomain) {
     const parts = customDomain.split('.');
     const subdomain = parts.length > 2 ? parts[0] : '@';
+    const isApexDomain = parts.length <= 2;
     return {
         cname: {
             name: subdomain === '@' ? customDomain : subdomain,
-            value: 'cname.devdoc-dns.com'
+            // Use Vercel's actual DNS target
+            value: isApexDomain ? '76.76.21.21' : 'cname.vercel-dns.com'
         },
         txt: {
             name: `_devdoc-verify.${customDomain}`,
@@ -159,3 +172,12 @@ export const domainConfigSchema = z.object({
         }
     };
 }
+/**
+ * Get human-readable DNS type based on domain
+ * 
+ * @param customDomain - The custom domain
+ * @returns 'A' for apex domains, 'CNAME' for subdomains
+ */ export function getDnsRecordType(customDomain) {
+    const parts = customDomain.split('.');
+    return parts.length <= 2 ? 'A' : 'CNAME';
+}

package/renderer/lib/docs/config/index.js

@@ -1,6 +1,6 @@
 /**
  * Configuration Module Exports
  */ export { docsConfigSchema, parseDocsConfig, safeParseDocsConfig, getDefaultDocsConfig } from './schema';
-export { domainConfigSchema, parseDomainConfig, safeParseDomainConfig, isValidDomain, normalizeDomain, getDnsInstructions } from './domain-schema';
+export { domainConfigSchema, parseDomainConfig, safeParseDomainConfig, isValidDomain, normalizeDomain, getDnsInstructions, getDnsRecordType } from './domain-schema';
 export { loadDocsConfig, safeLoadDocsConfig, clearConfigCache, hasDocsConfig, getContentDir, resolvePagePath, loadPageContent, listMdxFiles } from './loader';
 export { isDevMode, isProductionMode, shouldShowItem } from './environment';

package/renderer/lib/storage/blob.js

@@ -30,7 +30,7 @@ function _getFileBlobPath(slug, filePath) {
 }
 /**
  * Store project content in Vercel Blob (or local filesystem in dev)
- */ export async function storeProjectContent(slug, name, docsJson, files, themeJson, openApiSpecs) {
+ */ export async function storeProjectContent(slug, name, docsJson, files, themeJson, openApiSpecs, graphqlSchemas) {
     const now = new Date().toISOString();
     const content = {
         slug,
@@ -41,6 +41,7 @@ function _getFileBlobPath(slug, filePath) {
                 k,
                 JSON.stringify(v)
             ])) : undefined,
+        graphqlSchemas,
         files,
         createdAt: now,
         updatedAt: now
@@ -92,7 +93,7 @@ function _getFileBlobPath(slug, filePath) {
 }
 /**
  * Update existing project content
- */ export async function updateProjectContent(slug, docsJson, files, themeJson, openApiSpecs) {
+ */ export async function updateProjectContent(slug, docsJson, files, themeJson, openApiSpecs, graphqlSchemas) {
     // Get existing content to preserve createdAt
     const existing = await getProjectContent(slug);
     const now = new Date().toISOString();
@@ -105,6 +106,7 @@ function _getFileBlobPath(slug, filePath) {
                 k,
                 JSON.stringify(v)
             ])) : undefined,
+        graphqlSchemas,
         files,
         createdAt: existing?.createdAt || now,
         updatedAt: now