@knowcode/doc-builder 1.7.4 → 1.7.6

package/lib/config.js

@@ -19,7 +19,7 @@ const defaultConfig = {
   
   // Features
   features: {
-    authentication: false,
+    authentication: false,  // false (no auth) or 'supabase' (secure auth)
     changelog: true,
     mermaid: true,
     tooltips: true,
@@ -30,13 +30,15 @@ const defaultConfig = {
     phosphorSize: '1.2em',     // Relative to text size
     normalizeTitle: true,      // Auto-normalize all-caps titles to title case
     showPdfDownload: true,     // Show PDF download icon in header
-    menuDefaultOpen: true      // Menu/sidebar open by default
+    menuDefaultOpen: true,     // Menu/sidebar open by default
+    attachments: true          // Copy attachments (Excel, PDF, etc.) to output
   },
   
-  // Authentication (if enabled)
+  // Authentication - Supabase only (basic auth removed for security)
   auth: {
-    username: 'admin',
-    password: 'password'
+    supabaseUrl: '',
+    supabaseAnonKey: '',
+    siteId: ''
   },
   
   // Changelog settings
@@ -77,7 +79,21 @@ const defaultConfig = {
     generateSitemap: true,
     generateRobotsTxt: true,
     customMetaTags: []
-  }
+  },
+  
+  // Attachment file types to copy
+  attachmentTypes: [
+    // Documents
+    '.pdf', '.doc', '.docx', '.xls', '.xlsx', '.csv', '.ppt', '.pptx', '.txt', '.rtf',
+    // Archives
+    '.zip', '.tar', '.gz', '.7z', '.rar',
+    // Images
+    '.png', '.jpg', '.jpeg', '.gif', '.svg', '.webp', '.ico', '.bmp',
+    // Data files
+    '.json', '.xml', '.yaml', '.yml', '.toml',
+    // Other
+    '.mp4', '.mp3', '.wav', '.avi', '.mov'
+  ]
 };
 
 /**
@@ -90,7 +106,7 @@ const notionInspiredPreset = {
   siteDescription: 'Transforming complex sales through intelligent automation',
   
   features: {
-    authentication: true,
+    authentication: false,  // Default to no auth - can be enabled with 'supabase'
     changelog: true,
     mermaid: true,
     tooltips: true,
@@ -101,12 +117,14 @@ const notionInspiredPreset = {
     phosphorSize: '1.2em',
     normalizeTitle: true,
     showPdfDownload: true,
-    menuDefaultOpen: true
+    menuDefaultOpen: true,
+    attachments: true
   },
   
   auth: {
-    username: 'admin',
-    password: 'docs2025'
+    supabaseUrl: process.env.SUPABASE_URL || '',
+    supabaseAnonKey: process.env.SUPABASE_ANON_KEY || '',
+    siteId: process.env.DOC_SITE_ID || ''
   },
   
   changelog: {
@@ -259,6 +277,9 @@ async function loadConfig(configPath, options = {}) {
   if (options.menuClosed === true) {
     config.features.menuDefaultOpen = false;
   }
+  if (options.attachments === false) {
+    config.features.attachments = false;
+  }
   
   // Legacy mode - auto-detect structure
   if (options.legacy) {
@@ -307,32 +328,15 @@ async function createDefaultConfig() {
     {
       type: 'confirm',
       name: 'authentication',
-      message: 'Enable authentication?',
+      message: 'Enable Supabase authentication?',
       initial: false
-    },
-    {
-      type: prev => prev ? 'text' : null,
-      name: 'authUsername',
-      message: 'Authentication username:',
-      initial: 'admin'
-    },
-    {
-      type: prev => prev ? 'password' : null,
-      name: 'authPassword',
-      message: 'Authentication password:',
-      initial: 'password'
     }
   ]);
   
   const config = { ...defaultConfig };
   config.siteName = answers.siteName;
   config.siteDescription = answers.siteDescription;
-  config.features.authentication = answers.authentication;
-  
-  if (answers.authentication) {
-    config.auth.username = answers.authUsername;
-    config.auth.password = answers.authPassword;
-  }
+  config.features.authentication = answers.authentication ? 'supabase' : false;
   
   return config;
 }

package/lib/core-builder.js

@@ -3,6 +3,7 @@ const path = require('path');
 const marked = require('marked');
 const chalk = require('chalk');
 const matter = require('gray-matter');
+const SupabaseAuth = require('./supabase-auth');
 const { 
   generateMetaTags, 
   generateJSONLD, 
@@ -344,6 +345,26 @@ ${seoTags}
     <!-- Styles -->
     <link rel="stylesheet" href="/css/notion-style.css">
     
+    ${config.features?.authentication === 'supabase' ? `
+    <!-- Hide content until auth check -->
+    <style>
+      body { 
+        visibility: hidden; 
+        opacity: 0; 
+        transition: opacity 0.3s ease;
+      }
+      body.authenticated { 
+        visibility: visible; 
+        opacity: 1; 
+      }
+      /* Show login/logout pages immediately */
+      body.auth-page {
+        visibility: visible;
+        opacity: 1;
+      }
+    </style>
+    ` : ''}
+    
     <!-- Favicon -->
     ${generateFaviconTag(config.favicon || '✨')}
     
@@ -367,7 +388,7 @@ ${seoTags}
                     })} UTC</span>
                 </div>
                 
-                ${config.features?.authentication ? `
+                ${config.features?.authentication === 'supabase' ? `
                 <a href="${relativePath}logout.html" class="logout-btn" title="Logout">
                     <i class="fas fa-sign-out-alt"></i>
                 </a>
@@ -435,7 +456,8 @@ ${seoTags}
     };
     </script>
     <script src="/js/main.js"></script>
-    ${config.features?.authentication ? `<script src="/js/auth.js"></script>` : ''}
+    ${config.features?.authentication === 'supabase' ? `<script src="https://unpkg.com/@supabase/supabase-js@2"></script>
+    <script src="/js/auth.js"></script>` : ''}
 </body>
 </html>`;
 }
@@ -731,6 +753,62 @@ async function getAllMarkdownFiles(dir, baseDir = dir) {
   return files;
 }
 
+// Get all attachment files
+async function getAllAttachmentFiles(dir, baseDir = dir, attachmentTypes) {
+  const files = [];
+  const items = await fs.readdir(dir);
+  
+  for (const item of items) {
+    const fullPath = path.join(dir, item);
+    const stat = await fs.stat(fullPath);
+    
+    if (stat.isDirectory() && !item.startsWith('.')) {
+      // Recursively scan subdirectories
+      const subFiles = await getAllAttachmentFiles(fullPath, baseDir, attachmentTypes);
+      files.push(...subFiles);
+    } else {
+      // Check if file is an attachment type
+      const ext = path.extname(item).toLowerCase();
+      if (attachmentTypes.includes(ext) && !item.startsWith('.')) {
+        const relativePath = path.relative(baseDir, fullPath);
+        files.push({
+          path: fullPath,
+          relativePath,
+          size: stat.size
+        });
+      }
+    }
+  }
+  
+  return files;
+}
+
+// Copy attachment files to output directory
+async function copyAttachmentFiles(attachmentFiles, docsDir, outputDir) {
+  let totalSize = 0;
+  let copiedCount = 0;
+  
+  for (const file of attachmentFiles) {
+    try {
+      const outputPath = path.join(outputDir, file.relativePath);
+      const outputDirPath = path.dirname(outputPath);
+      
+      // Create directory if it doesn't exist
+      await fs.ensureDir(outputDirPath);
+      
+      // Copy the file
+      await fs.copy(file.path, outputPath, { overwrite: true });
+      
+      totalSize += file.size;
+      copiedCount++;
+    } catch (error) {
+      console.warn(chalk.yellow(`Warning: Could not copy ${file.relativePath}: ${error.message}`));
+    }
+  }
+  
+  return { copiedCount, totalSize };
+}
+
 // Main build function
 async function buildDocumentation(config) {
   const docsDir = path.join(process.cwd(), config.docsDir);
@@ -778,21 +856,12 @@ async function buildDocumentation(config) {
   if (fs.existsSync(jsSource)) {
     await fs.copy(jsSource, path.join(outputDir, 'js'), { overwrite: true });
     
-    // Copy auth.js to root if authentication is enabled
-    if (config.features?.authentication) {
-      const authSource = path.join(jsSource, 'auth.js');
-      const authDest = path.join(outputDir, 'auth.js');
-      if (fs.existsSync(authSource)) {
-        await fs.copy(authSource, authDest, { overwrite: true });
-      }
+    // Generate Supabase auth script if authentication is enabled
+    if (config.features?.authentication === 'supabase') {
+      await generateSupabaseAuthFiles(outputDir, config);
     }
   }
   
-  // Create auth pages if needed
-  if (config.features?.authentication) {
-    await createAuthPages(outputDir, config);
-  }
-  
   // Copy 404.html for handling .md redirects
   const notFoundSource = path.join(assetsDir, '404.html');
   if (fs.existsSync(notFoundSource)) {
@@ -928,12 +997,46 @@ async function buildDocumentation(config) {
     // Generate robots.txt if enabled
     if (config.seo.generateRobotsTxt) {
       await generateRobotsTxt(config.seo.siteUrl, outputDir, {
-        hasAuthentication: config.features?.authentication
+        hasAuthentication: config.features?.authentication === 'supabase'
       });
     }
   }
   
-  console.log(chalk.green('✅ Documentation build complete!'));
+  // Copy attachment files if feature is enabled
+  if (config.features?.attachments !== false) {
+    console.log(chalk.blue('\n📎 Processing attachments...'));
+    
+    const attachmentTypes = config.attachmentTypes || [
+      '.pdf', '.doc', '.docx', '.xls', '.xlsx', '.csv', '.ppt', '.pptx', '.txt', '.rtf',
+      '.zip', '.tar', '.gz', '.7z', '.rar',
+      '.png', '.jpg', '.jpeg', '.gif', '.svg', '.webp', '.ico', '.bmp',
+      '.json', '.xml', '.yaml', '.yml', '.toml',
+      '.mp4', '.mp3', '.wav', '.avi', '.mov'
+    ];
+    
+    try {
+      const attachmentFiles = await getAllAttachmentFiles(docsDir, docsDir, attachmentTypes);
+      
+      if (attachmentFiles.length > 0) {
+        const { copiedCount, totalSize } = await copyAttachmentFiles(attachmentFiles, docsDir, outputDir);
+        
+        // Format file size
+        const formatSize = (bytes) => {
+          if (bytes < 1024) return bytes + ' B';
+          if (bytes < 1024 * 1024) return (bytes / 1024).toFixed(1) + ' KB';
+          return (bytes / (1024 * 1024)).toFixed(1) + ' MB';
+        };
+        
+        console.log(chalk.green(`✅ Copied ${copiedCount} attachments (${formatSize(totalSize)} total)`));
+      } else {
+        console.log(chalk.gray('  No attachments found to copy'));
+      }
+    } catch (error) {
+      console.warn(chalk.yellow(`Warning: Error processing attachments: ${error.message}`));
+    }
+  }
+  
+  console.log(chalk.green('\n✅ Documentation build complete!'));
 }
 
 // Create placeholder README.md if missing
@@ -1047,82 +1150,33 @@ For help with @knowcode/doc-builder:
   }
 }
 
-// Create login/logout pages
-async function createAuthPages(outputDir, config) {
-  // Login page
-  const loginHTML = `<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Login - ${config.siteName}</title>
-    <link rel="stylesheet" href="css/notion-style.css">
-</head>
-<body>
-    <div class="auth-container">
-        <div class="auth-box">
-            <h1>Login to ${config.siteName}</h1>
-            <form id="login-form">
-                <div class="form-group">
-                    <label for="username">Username</label>
-                    <input type="text" id="username" name="username" required>
-                </div>
-                <div class="form-group">
-                    <label for="password">Password</label>
-                    <input type="password" id="password" name="password" required>
-                </div>
-                <button type="submit" class="auth-button">Login</button>
-            </form>
-            <div id="error-message" class="error-message"></div>
-        </div>
-    </div>
-    <script>
-        document.getElementById('login-form').addEventListener('submit', function(e) {
-            e.preventDefault();
-            const username = document.getElementById('username').value;
-            const password = document.getElementById('password').value;
-            
-            // Validate credentials
-            if (username === '${config.auth.username}' && password === '${config.auth.password}') {
-                // Set auth cookie
-                const token = btoa(username + ':' + password);
-                document.cookie = 'doc-auth=' + token + '; path=/';
-                
-                // Redirect
-                const params = new URLSearchParams(window.location.search);
-                const redirect = params.get('redirect') || '/';
-                window.location.href = redirect;
-            } else {
-                document.getElementById('error-message').textContent = 'Invalid username or password';
-            }
-        });
-    </script>
-</body>
-</html>`;
+// Generate all Supabase authentication files
+async function generateSupabaseAuthFiles(outputDir, config) {
+  // Validate Supabase configuration
+  const validationErrors = SupabaseAuth.validateConfig(config);
+  if (validationErrors.length > 0) {
+    throw new Error(`Supabase authentication configuration errors:\n${validationErrors.join('\n')}`);
+  }
 
-  await fs.writeFile(path.join(outputDir, 'login.html'), loginHTML);
+  // Create Supabase auth instance
+  const supabaseAuth = new SupabaseAuth(config.auth);
 
-  // Logout page
-  const logoutHTML = `<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Logged Out - ${config.siteName}</title>
-    <link rel="stylesheet" href="css/notion-style.css">
-</head>
-<body>
-    <div class="auth-container">
-        <div class="auth-box">
-            <h1>You have been logged out</h1>
-            <p>Thank you for using ${config.siteName}.</p>
-            <a href="login.html" class="auth-button">Login Again</a>
-        </div>
-    </div>
-</body>
-</html>`;
+  // Generate auth script and save to js/auth.js
+  const authScript = supabaseAuth.generateAuthScript();
+  await fs.writeFile(path.join(outputDir, 'js', 'auth.js'), authScript);
+
+  // Also copy to root for backward compatibility
+  await fs.writeFile(path.join(outputDir, 'auth.js'), authScript);
 
+  // Generate and write login page
+  const loginHTML = supabaseAuth.generateLoginPage(config);
+  await fs.writeFile(path.join(outputDir, 'login.html'), loginHTML);
+
+  // Generate and write logout page
+  const logoutHTML = supabaseAuth.generateLogoutPage(config);
   await fs.writeFile(path.join(outputDir, 'logout.html'), logoutHTML);
+
+  console.log(chalk.green('✓ Generated Supabase authentication files'));
 }
 
 // Create default index page when no documentation exists