@brainfish-ai/devdoc 0.1.29 → 0.1.31

package/renderer/components/docs/navigation/sidebar.tsx

@@ -150,10 +150,10 @@ export function DocsSidebar({
   
   return (
     <>
-      {/* Mobile overlay backdrop */}
+      {/* Mobile overlay backdrop - z-[55] to cover header (z-50) but below sidebar (z-60) */}
       {isMobile && isOpen && (
         <div 
-          className="fixed inset-0 bg-black/50 z-40 lg:hidden"
+          className="fixed inset-0 bg-black/50 z-[55] lg:hidden"
           onClick={onClose}
         />
       )}
@@ -162,9 +162,9 @@ export function DocsSidebar({
         className={cn(
           "flex flex-col border-r bg-sidebar border-sidebar-border overflow-hidden",
           // Desktop: always visible, fixed width
-          "lg:relative lg:w-72 lg:h-full",
-          // Mobile: drawer behavior
-          "fixed inset-y-0 left-0 z-50 w-[280px] h-full",
+          "lg:relative lg:w-72 lg:h-full lg:z-auto",
+          // Mobile: drawer behavior - z-[60] to appear above header (z-50)
+          "fixed inset-y-0 left-0 z-[60] w-[280px] h-full",
           "transform transition-transform duration-300 ease-in-out",
           "lg:transform-none lg:translate-x-0",
           isMobile && !isOpen && "-translate-x-full",

package/renderer/components/docs-header.tsx

@@ -25,6 +25,7 @@ interface DocsLogo {
   height?: number
   light?: string
   dark?: string
+  href?: string  // Where logo links to (defaults to "/")
 }
 
 // Header config from docs.json
@@ -133,7 +134,10 @@ export function DocsHeader({
             </Button>
           )}
           
-          <Link href="/" className="docs-header-logo flex items-center gap-2 sm:gap-3">
+          <Link 
+            href={docsLogo?.href || "/"} 
+            className="docs-header-logo flex items-center gap-2 sm:gap-3 min-h-[44px] min-w-[44px] touch-manipulation"
+          >
             {hasLightDarkLogos ? (
               <>
                 {/* Light mode logo */}
@@ -142,7 +146,7 @@ export function DocsHeader({
                   alt={logo.alt}
                   width={logo.width}
                   height={logo.height}
-                  className="w-auto dark:hidden"
+                  className="w-auto dark:hidden pointer-events-none"
                   style={{ height: logo.height }}
                   priority
                 />
@@ -152,7 +156,7 @@ export function DocsHeader({
                   alt={logo.alt}
                   width={logo.width}
                   height={logo.height}
-                  className="w-auto hidden dark:block"
+                  className="w-auto hidden dark:block pointer-events-none"
                   style={{ height: logo.height }}
                   priority
                 />
@@ -163,7 +167,7 @@ export function DocsHeader({
                 alt={logo.alt}
                 width={logo.width}
                 height={logo.height}
-                className="w-auto dark:invert"
+                className="w-auto dark:invert pointer-events-none"
                 style={{ height: logo.height }}
                 priority
               />
@@ -171,7 +175,7 @@ export function DocsHeader({
             {docsName && (
               <>
                 <div className="hidden sm:block h-5 w-px bg-border" />
-                <span className="docs-header-title hidden sm:inline text-sm font-medium text-muted-foreground">
+                <span className="docs-header-title hidden sm:inline text-sm font-medium text-muted-foreground pointer-events-none">
                   {docsName}
                 </span>
               </>

package/renderer/components/docs-viewer/sidebar/right-sidebar.tsx

@@ -107,10 +107,10 @@ export function RightSidebar({
 
   return (
     <>
-      {/* Mobile overlay backdrop */}
+      {/* Mobile overlay backdrop - z-[55] to cover header (z-50) but below panel (z-60) */}
       {isMobile && isRightSidebarOpen && (
         <div 
-          className="docs-agent-overlay fixed inset-0 bg-black/50 z-40 lg:hidden"
+          className="docs-agent-overlay fixed inset-0 bg-black/50 z-[55] lg:hidden"
           onClick={closeRightSidebar}
         />
       )}
@@ -119,9 +119,9 @@ export function RightSidebar({
         className={cn(
           "docs-agent-panel border-l border-border bg-background flex flex-col overflow-hidden",
           // Desktop: always visible, fixed width
-          "lg:relative lg:w-96 lg:h-full",
-          // Mobile: drawer behavior from right
-          "fixed inset-y-0 right-0 z-50 w-[320px] sm:w-[360px] h-full",
+          "lg:relative lg:w-96 lg:h-full lg:z-auto",
+          // Mobile: drawer behavior from right - z-[60] to appear above header (z-50)
+          "fixed inset-y-0 right-0 z-[60] w-[320px] sm:w-[360px] h-full",
           "transform transition-transform duration-300 ease-in-out",
           "lg:transform-none lg:translate-x-0",
           isMobile && !isRightSidebarOpen && "translate-x-full",

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

@@ -0,0 +1,260 @@
+import { z } from 'zod'
+
+/**
+ * Domain Configuration Schema (domain.json)
+ * 
+ * Configuration for custom domains on DevDoc projects.
+ * Each project can have ONE custom domain for free.
+ */
+
+// ============================================================================
+// Domain Validation Helpers
+// ============================================================================
+
+/**
+ * Valid domain pattern - allows subdomains like docs.example.com
+ * Does NOT allow:
+ * - IP addresses
+ * - Ports
+ * - Paths
+ * - Protocol prefixes
+ */
+const domainRegex = /^(?!-)[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*\.[a-zA-Z]{2,}$/
+
+/**
+ * Reserved domains that cannot be used as custom domains
+ */
+const RESERVED_DOMAINS = [
+  'devdoc.sh',
+  'devdoc.io',
+  'devdoc.com',
+  'localhost',
+]
+
+// ============================================================================
+// SEO Schema
+// ============================================================================
+
+const domainSeoSchema = z.object({
+  /**
+   * Canonical URL for SEO - tells search engines this is the primary URL
+   * Should match your custom domain with https://
+   */
+  canonical: z.string().url().optional(),
+})
+
+// ============================================================================
+// Settings Schema
+// ============================================================================
+
+const domainSettingsSchema = z.object({
+  /**
+   * Force HTTPS redirects (recommended, default: true)
+   */
+  forceHttps: z.boolean().default(true),
+  
+  /**
+   * WWW redirect preference
+   * - "www": Redirect non-www to www (example.com → www.example.com)
+   * - "non-www": Redirect www to non-www (www.example.com → example.com)
+   * - "none": No redirect, accept both
+   */
+  wwwRedirect: z.enum(['www', 'non-www', 'none']).default('none'),
+})
+
+// ============================================================================
+// Main Domain Configuration Schema
+// ============================================================================
+
+export const domainConfigSchema = z.object({
+  /**
+   * JSON Schema reference (optional)
+   */
+  $schema: z.string().optional(),
+  
+  /**
+   * The custom domain for this project
+   * Example: "docs.example.com" or "developer.mycompany.io"
+   * 
+   * Rules:
+   * - Must be a valid domain name
+   * - Cannot be a DevDoc domain (*.devdoc.sh)
+   * - One custom domain per project (free)
+   */
+  customDomain: z.string()
+    .min(4, 'Domain must be at least 4 characters')
+    .max(253, 'Domain must be 253 characters or less')
+    .regex(domainRegex, 'Invalid domain format. Example: docs.example.com')
+    .refine(
+      (domain) => !RESERVED_DOMAINS.some(reserved => 
+        domain === reserved || domain.endsWith(`.${reserved}`)
+      ),
+      'Cannot use a reserved DevDoc domain'
+    ),
+  
+  /**
+   * SEO configuration for the custom domain
+   */
+  seo: domainSeoSchema.optional(),
+  
+  /**
+   * Domain behavior settings
+   */
+  settings: domainSettingsSchema.optional(),
+})
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export type DomainConfig = z.infer<typeof domainConfigSchema>
+export type DomainSeoConfig = z.infer<typeof domainSeoSchema>
+export type DomainSettings = z.infer<typeof domainSettingsSchema>
+
+// ============================================================================
+// Domain Status Types (for API/storage)
+// ============================================================================
+
+/**
+ * Status of a custom domain in the system
+ */
+export type DomainStatus = 
+  | 'pending'           // Domain added, awaiting DNS configuration
+  | 'dns_verified'      // DNS records verified, awaiting SSL
+  | 'ssl_provisioning'  // SSL certificate being provisioned
+  | 'active'            // Domain is live and working
+  | 'error'             // Configuration error
+
+/**
+ * Custom domain entry stored in the registry
+ */
+export interface CustomDomainEntry {
+  /** The custom domain (e.g., "docs.example.com") */
+  customDomain: string
+  
+  /** The project slug this domain points to */
+  projectSlug: string
+  
+  /** Current status of the domain */
+  status: DomainStatus
+  
+  /** Vercel domain ID (from Vercel API) */
+  vercelDomainId?: string
+  
+  /** TXT record value for domain ownership verification */
+  verificationToken?: string
+  
+  /** When the domain was added */
+  createdAt: string
+  
+  /** When DNS was verified */
+  verifiedAt?: string
+  
+  /** Last time status was checked */
+  lastCheckedAt?: string
+  
+  /** Error message if status is "error" */
+  errorMessage?: string
+  
+  /** Domain settings from domain.json */
+  settings?: DomainSettings
+}
+
+// ============================================================================
+// Validation Functions
+// ============================================================================
+
+/**
+ * Parse and validate domain configuration
+ */
+export function parseDomainConfig(data: unknown): DomainConfig {
+  const result = domainConfigSchema.safeParse(data)
+  
+  if (!result.success) {
+    const issues = result.error.issues || []
+    const errors = issues.map((e) => 
+      `${e.path.map(String).join('.')}: ${e.message}`
+    ).join('\n')
+    throw new Error(`Invalid domain.json configuration:\n${errors}`)
+  }
+  
+  return result.data
+}
+
+/**
+ * Safe parse that returns null on failure
+ */
+export function safeParseDomainConfig(data: unknown): DomainConfig | null {
+  const result = domainConfigSchema.safeParse(data)
+  return result.success ? result.data : null
+}
+
+/**
+ * Validate a domain string format
+ */
+export function isValidDomain(domain: string): { valid: boolean; error?: string } {
+  if (!domain) {
+    return { valid: false, error: 'Domain is required' }
+  }
+  
+  if (domain.length < 4) {
+    return { valid: false, error: 'Domain must be at least 4 characters' }
+  }
+  
+  if (domain.length > 253) {
+    return { valid: false, error: 'Domain must be 253 characters or less' }
+  }
+  
+  if (!domainRegex.test(domain)) {
+    return { valid: false, error: 'Invalid domain format. Example: docs.example.com' }
+  }
+  
+  // Check reserved domains
+  if (RESERVED_DOMAINS.some(reserved => 
+    domain === reserved || domain.endsWith(`.${reserved}`)
+  )) {
+    return { valid: false, error: 'Cannot use a reserved DevDoc domain' }
+  }
+  
+  return { valid: true }
+}
+
+/**
+ * Normalize a domain (lowercase, trim, remove protocol/path)
+ */
+export function normalizeDomain(domain: string): string {
+  let normalized = domain.toLowerCase().trim()
+  
+  // Remove protocol if present
+  normalized = normalized.replace(/^https?:\/\//, '')
+  
+  // Remove path if present
+  normalized = normalized.split('/')[0]
+  
+  // Remove port if present
+  normalized = normalized.split(':')[0]
+  
+  return normalized
+}
+
+/**
+ * Get DNS instructions for a custom domain
+ */
+export function getDnsInstructions(customDomain: string): {
+  cname: { name: string; value: string }
+  txt: { name: string; value: string }
+} {
+  const parts = customDomain.split('.')
+  const subdomain = parts.length > 2 ? parts[0] : '@'
+  
+  return {
+    cname: {
+      name: subdomain === '@' ? customDomain : subdomain,
+      value: 'cname.devdoc-dns.com',
+    },
+    txt: {
+      name: `_devdoc-verify.${customDomain}`,
+      value: '', // Will be filled with actual verification token
+    },
+  }
+}

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

@@ -17,6 +17,20 @@ export {
   type ApiConfig,
 } from './schema'
 
+export {
+  domainConfigSchema,
+  parseDomainConfig,
+  safeParseDomainConfig,
+  isValidDomain,
+  normalizeDomain,
+  getDnsInstructions,
+  type DomainConfig,
+  type DomainSeoConfig,
+  type DomainSettings,
+  type DomainStatus,
+  type CustomDomainEntry,
+} from './domain-schema'
+
 export {
   loadDocsConfig,
   safeLoadDocsConfig,

package/renderer/lib/storage/blob.ts

@@ -415,15 +415,59 @@ function getApiKeyBlobPath(slug: string): string {
 }
 
 // =============================================================================
-// Domain Registry - O(1) lookups for subdomains and API keys
+// Domain Registry - O(1) lookups for subdomains, API keys, and custom domains
 // =============================================================================
 
+/**
+ * Status of a custom domain in the system
+ */
+export type CustomDomainStatus = 
+  | 'pending'           // Domain added, awaiting DNS configuration
+  | 'dns_verified'      // DNS records verified, awaiting SSL
+  | 'ssl_provisioning'  // SSL certificate being provisioned
+  | 'active'            // Domain is live and working
+  | 'error'             // Configuration error
+
+/**
+ * Custom domain entry stored in the registry
+ */
+export interface CustomDomainEntry {
+  /** The custom domain (e.g., "docs.example.com") */
+  customDomain: string
+  
+  /** The project slug this domain points to */
+  projectSlug: string
+  
+  /** Current status of the domain */
+  status: CustomDomainStatus
+  
+  /** Vercel domain ID (from Vercel API) */
+  vercelDomainId?: string
+  
+  /** TXT record value for domain ownership verification */
+  verificationToken?: string
+  
+  /** When the domain was added */
+  createdAt: string
+  
+  /** When DNS was verified */
+  verifiedAt?: string
+  
+  /** Last time status was checked */
+  lastCheckedAt?: string
+  
+  /** Error message if status is "error" */
+  errorMessage?: string
+}
+
 /**
  * Registry structure - single file for all domains/projects
  */
 export interface DomainRegistry {
-  domains: Record<string, DomainEntry>  // subdomain -> entry
-  apiKeys: Record<string, string>        // apiKey -> subdomain (for O(1) key validation)
+  domains: Record<string, DomainEntry>           // subdomain -> entry
+  customDomains: Record<string, CustomDomainEntry>  // customDomain -> entry (NEW)
+  projectToCustomDomain: Record<string, string>  // projectSlug -> customDomain (reverse lookup)
+  apiKeys: Record<string, string>                // apiKey -> subdomain (for O(1) key validation)
   updatedAt: string
 }
 
@@ -477,7 +521,13 @@ async function getRegistry(): Promise<DomainRegistry> {
   }
   
   // Return empty registry if not found
-  return { domains: {}, apiKeys: {}, updatedAt: new Date().toISOString() }
+  return { 
+    domains: {}, 
+    customDomains: {},
+    projectToCustomDomain: {},
+    apiKeys: {}, 
+    updatedAt: new Date().toISOString() 
+  }
 }
 
 /**
@@ -555,6 +605,194 @@ export async function getDomainEntry(subdomain: string): Promise<DomainEntry | n
   return registry.domains[subdomain] || null
 }
 
+// =============================================================================
+// Custom Domain Management - One custom domain per project (free)
+// =============================================================================
+
+/**
+ * Generate a verification token for domain ownership
+ */
+export function generateVerificationToken(): string {
+  const chars = 'abcdefghijklmnopqrstuvwxyz0123456789'
+  let token = 'devdoc-verify='
+  for (let i = 0; i < 24; i++) {
+    token += chars.charAt(Math.floor(Math.random() * chars.length))
+  }
+  return token
+}
+
+/**
+ * Check if a custom domain is already registered (O(1) lookup)
+ */
+export async function isCustomDomainRegistered(customDomain: string): Promise<boolean> {
+  const registry = await getRegistry()
+  return customDomain in (registry.customDomains || {})
+}
+
+/**
+ * Check if a project already has a custom domain (O(1) lookup)
+ */
+export async function getProjectCustomDomain(projectSlug: string): Promise<CustomDomainEntry | null> {
+  const registry = await getRegistry()
+  const customDomain = registry.projectToCustomDomain?.[projectSlug]
+  if (!customDomain) return null
+  return registry.customDomains?.[customDomain] || null
+}
+
+/**
+ * Get custom domain entry by domain name (O(1) lookup)
+ */
+export async function getCustomDomainEntry(customDomain: string): Promise<CustomDomainEntry | null> {
+  const registry = await getRegistry()
+  return registry.customDomains?.[customDomain] || null
+}
+
+/**
+ * Look up project slug from custom domain (O(1) lookup)
+ * Used by middleware for routing
+ */
+export async function lookupCustomDomain(customDomain: string): Promise<CustomDomainEntry | null> {
+  const registry = await getRegistry()
+  const entry = registry.customDomains?.[customDomain]
+  
+  // Only return if domain is active
+  if (entry && entry.status === 'active') {
+    return entry
+  }
+  
+  return null
+}
+
+/**
+ * Add a custom domain to a project
+ * Returns error if project already has a custom domain (limit: 1 per project)
+ */
+export async function addCustomDomain(
+  projectSlug: string,
+  customDomain: string
+): Promise<{ success: boolean; entry?: CustomDomainEntry; error?: string }> {
+  const registry = await getRegistry()
+  
+  // Initialize custom domain maps if they don't exist
+  if (!registry.customDomains) {
+    registry.customDomains = {}
+  }
+  if (!registry.projectToCustomDomain) {
+    registry.projectToCustomDomain = {}
+  }
+  
+  // Check if project already has a custom domain (limit: 1 per project)
+  const existingDomain = registry.projectToCustomDomain[projectSlug]
+  if (existingDomain) {
+    return {
+      success: false,
+      error: `Project already has a custom domain: ${existingDomain}. Remove it first before adding a new one.`,
+    }
+  }
+  
+  // Check if this domain is already registered to another project
+  if (registry.customDomains[customDomain]) {
+    return {
+      success: false,
+      error: `Domain ${customDomain} is already registered to another project.`,
+    }
+  }
+  
+  // Verify the project exists
+  const projectExists = await getDomainEntry(projectSlug)
+  if (!projectExists) {
+    return {
+      success: false,
+      error: `Project ${projectSlug} not found. Deploy your project first.`,
+    }
+  }
+  
+  const now = new Date().toISOString()
+  const verificationToken = generateVerificationToken()
+  
+  const entry: CustomDomainEntry = {
+    customDomain,
+    projectSlug,
+    status: 'pending',
+    verificationToken,
+    createdAt: now,
+  }
+  
+  // Add to both lookups
+  registry.customDomains[customDomain] = entry
+  registry.projectToCustomDomain[projectSlug] = customDomain
+  
+  await saveRegistry(registry)
+  
+  return { success: true, entry }
+}
+
+/**
+ * Update custom domain status
+ */
+export async function updateCustomDomainStatus(
+  customDomain: string,
+  status: CustomDomainStatus,
+  additionalFields?: Partial<CustomDomainEntry>
+): Promise<boolean> {
+  const registry = await getRegistry()
+  
+  if (!registry.customDomains?.[customDomain]) {
+    return false
+  }
+  
+  registry.customDomains[customDomain] = {
+    ...registry.customDomains[customDomain],
+    status,
+    lastCheckedAt: new Date().toISOString(),
+    ...additionalFields,
+  }
+  
+  // Set verifiedAt when transitioning to dns_verified
+  if (status === 'dns_verified' && !registry.customDomains[customDomain].verifiedAt) {
+    registry.customDomains[customDomain].verifiedAt = new Date().toISOString()
+  }
+  
+  await saveRegistry(registry)
+  return true
+}
+
+/**
+ * Remove a custom domain from a project
+ */
+export async function removeCustomDomain(
+  customDomain: string,
+  projectSlug: string
+): Promise<{ success: boolean; error?: string }> {
+  const registry = await getRegistry()
+  
+  // Check if domain exists and belongs to this project
+  const entry = registry.customDomains?.[customDomain]
+  if (!entry) {
+    return { success: false, error: `Domain ${customDomain} not found.` }
+  }
+  
+  if (entry.projectSlug !== projectSlug) {
+    return { success: false, error: `Domain ${customDomain} does not belong to this project.` }
+  }
+  
+  // Remove from both lookups
+  delete registry.customDomains[customDomain]
+  delete registry.projectToCustomDomain[projectSlug]
+  
+  await saveRegistry(registry)
+  
+  return { success: true }
+}
+
+/**
+ * List all custom domains (for admin purposes)
+ */
+export async function listCustomDomains(): Promise<CustomDomainEntry[]> {
+  const registry = await getRegistry()
+  return Object.values(registry.customDomains || {})
+}
+
 /**
  * Generate a secure API key
  */

package/renderer/public/file.svg

@@ -1 +0,0 @@
-<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

package/renderer/public/globe.svg

@@ -1 +0,0 @@
-<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>