@knowcode/doc-builder 1.7.5 → 1.7.6

package/lib/config.js

@@ -30,7 +30,8 @@ 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 - Supabase only (basic auth removed for security)
@@ -78,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'
+  ]
 };
 
 /**
@@ -102,7 +117,8 @@ const notionInspiredPreset = {
     phosphorSize: '1.2em',
     normalizeTitle: true,
     showPdfDownload: true,
-    menuDefaultOpen: true
+    menuDefaultOpen: true,
+    attachments: true
   },
   
   auth: {
@@ -261,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) {

package/lib/core-builder.js

@@ -753,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);
@@ -946,7 +1002,41 @@ async function buildDocumentation(config) {
     }
   }
   
-  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

package/manage-users.sql

@@ -0,0 +1,191 @@
+-- =====================================================
+-- USER MANAGEMENT SQL COMMANDS FOR DOC-BUILDER
+-- =====================================================
+-- Run these in your Supabase SQL Editor
+
+-- =====================================================
+-- 1. VIEW YOUR SITES
+-- =====================================================
+-- See all your documentation sites
+SELECT id, domain, name, created_at 
+FROM docbuilder_sites
+ORDER BY created_at DESC;
+
+-- =====================================================
+-- 2. VIEW EXISTING USERS
+-- =====================================================
+-- See all users in your Supabase project
+SELECT id, email, created_at, last_sign_in_at
+FROM auth.users
+ORDER BY created_at DESC;
+
+-- =====================================================
+-- 3. VIEW WHO HAS ACCESS TO A SPECIFIC SITE
+-- =====================================================
+-- Replace 'your-site-id' with actual site ID
+SELECT 
+    u.email,
+    u.id as user_id,
+    u.created_at as user_since,
+    da.created_at as access_granted,
+    ds.name as site_name,
+    ds.domain
+FROM docbuilder_access da
+JOIN auth.users u ON u.id = da.user_id
+JOIN docbuilder_sites ds ON ds.id = da.site_id
+WHERE da.site_id = 'your-site-id'
+ORDER BY da.created_at DESC;
+
+-- =====================================================
+-- 4. ADD A SINGLE USER TO A SITE
+-- =====================================================
+-- First, create user in Supabase Dashboard (Authentication > Users > Invite)
+-- Then grant access:
+INSERT INTO docbuilder_access (user_id, site_id)
+VALUES (
+    (SELECT id FROM auth.users WHERE email = 'user@example.com'),
+    'your-site-id'
+);
+
+-- =====================================================
+-- 5. ADD MULTIPLE USERS TO A SITE
+-- =====================================================
+-- Add a list of users all at once
+WITH users_to_add AS (
+    SELECT email FROM (VALUES 
+        ('user1@example.com'),
+        ('user2@example.com'),
+        ('user3@example.com'),
+        ('user4@example.com')
+    ) AS t(email)
+)
+INSERT INTO docbuilder_access (user_id, site_id)
+SELECT u.id, 'your-site-id'
+FROM auth.users u
+JOIN users_to_add ua ON u.email = ua.email
+WHERE NOT EXISTS (
+    -- Prevent duplicate entries
+    SELECT 1 FROM docbuilder_access 
+    WHERE user_id = u.id AND site_id = 'your-site-id'
+);
+
+-- =====================================================
+-- 6. GRANT USER ACCESS TO MULTIPLE SITES
+-- =====================================================
+-- Give one user access to several sites
+WITH sites_to_grant AS (
+    SELECT id FROM docbuilder_sites 
+    WHERE domain IN ('site1.com', 'site2.com', 'site3.com')
+)
+INSERT INTO docbuilder_access (user_id, site_id)
+SELECT 
+    (SELECT id FROM auth.users WHERE email = 'user@example.com'),
+    s.id
+FROM sites_to_grant s
+WHERE NOT EXISTS (
+    SELECT 1 FROM docbuilder_access 
+    WHERE user_id = (SELECT id FROM auth.users WHERE email = 'user@example.com')
+    AND site_id = s.id
+);
+
+-- =====================================================
+-- 7. REMOVE USER ACCESS FROM A SITE
+-- =====================================================
+-- Remove specific user from specific site
+DELETE FROM docbuilder_access
+WHERE user_id = (SELECT id FROM auth.users WHERE email = 'user@example.com')
+AND site_id = 'your-site-id';
+
+-- =====================================================
+-- 8. REMOVE USER FROM ALL SITES
+-- =====================================================
+-- Completely remove user's access to all documentation
+DELETE FROM docbuilder_access
+WHERE user_id = (SELECT id FROM auth.users WHERE email = 'user@example.com');
+
+-- =====================================================
+-- 9. BULK REMOVE USERS
+-- =====================================================
+-- Remove multiple users from a site
+WITH users_to_remove AS (
+    SELECT email FROM (VALUES 
+        ('olduser1@example.com'),
+        ('olduser2@example.com')
+    ) AS t(email)
+)
+DELETE FROM docbuilder_access
+WHERE site_id = 'your-site-id'
+AND user_id IN (
+    SELECT u.id FROM auth.users u
+    JOIN users_to_remove ur ON u.email = ur.email
+);
+
+-- =====================================================
+-- 10. VIEW ACCESS SUMMARY
+-- =====================================================
+-- See how many users each site has
+SELECT 
+    ds.name as site_name,
+    ds.domain,
+    ds.id as site_id,
+    COUNT(da.user_id) as user_count,
+    MAX(da.created_at) as last_access_granted
+FROM docbuilder_sites ds
+LEFT JOIN docbuilder_access da ON ds.id = da.site_id
+GROUP BY ds.id, ds.name, ds.domain
+ORDER BY user_count DESC;
+
+-- =====================================================
+-- 11. FIND USERS WITHOUT ACCESS TO ANY SITE
+-- =====================================================
+-- Useful for cleanup
+SELECT u.email, u.created_at, u.last_sign_in_at
+FROM auth.users u
+WHERE NOT EXISTS (
+    SELECT 1 FROM docbuilder_access da 
+    WHERE da.user_id = u.id
+)
+ORDER BY u.created_at DESC;
+
+-- =====================================================
+-- 12. AUDIT LOG - RECENT ACCESS GRANTS
+-- =====================================================
+-- See who was granted access recently
+SELECT 
+    u.email,
+    ds.name as site_name,
+    ds.domain,
+    da.created_at as access_granted
+FROM docbuilder_access da
+JOIN auth.users u ON u.id = da.user_id
+JOIN docbuilder_sites ds ON ds.id = da.site_id
+WHERE da.created_at > NOW() - INTERVAL '30 days'
+ORDER BY da.created_at DESC;
+
+-- =====================================================
+-- 13. COPY ACCESS FROM ONE USER TO ANOTHER
+-- =====================================================
+-- Useful when replacing team members
+INSERT INTO docbuilder_access (user_id, site_id)
+SELECT 
+    (SELECT id FROM auth.users WHERE email = 'newuser@example.com'),
+    da.site_id
+FROM docbuilder_access da
+WHERE da.user_id = (SELECT id FROM auth.users WHERE email = 'olduser@example.com');
+
+-- =====================================================
+-- COMMON SITE IDs FOR REFERENCE
+-- =====================================================
+-- Your test site: 4d8a53bf-dcdd-48c0-98e0-cd1451518735
+-- Add more site IDs here as you create them:
+-- Production site: xxx
+-- Staging site: xxx
+
+-- =====================================================
+-- TIPS
+-- =====================================================
+-- 1. Always check if users exist before granting access
+-- 2. Use the Supabase Dashboard to invite new users first
+-- 3. Run SELECT queries before DELETE to verify
+-- 4. Keep this file updated with your site IDs
+-- 5. Consider creating views for common queries

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowcode/doc-builder",
-  "version": "1.7.5",
+  "version": "1.7.6",
   "description": "Reusable documentation builder for markdown-based sites with Vercel deployment support",
   "main": "index.js",
   "bin": {

package/view-all-users.sql

@@ -0,0 +1,40 @@
+-- =====================================================
+-- VIEW ALL USERS WITH ACCESS
+-- Site: https://wru-bid-analysis.vercel.app/
+-- =====================================================
+
+-- See everyone who has access to the WRU site
+SELECT 
+    u.email,
+    u.created_at as user_created,
+    da.created_at as access_granted,
+    CASE 
+        WHEN u.last_sign_in_at IS NULL THEN '❌ Never logged in'
+        ELSE '✅ Has logged in'
+    END as login_status,
+    u.last_sign_in_at
+FROM docbuilder_access da
+JOIN auth.users u ON u.id = da.user_id
+WHERE da.site_id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735'
+ORDER BY da.created_at DESC;
+
+-- Count total users with access
+SELECT COUNT(*) as total_users_with_access
+FROM docbuilder_access 
+WHERE site_id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';
+
+-- Check which of the 4 users exist in Supabase
+SELECT 
+    email,
+    CASE 
+        WHEN id IS NOT NULL THEN '✅ User exists'
+        ELSE '❌ Not created yet'
+    END as status
+FROM (
+    VALUES 
+        ('lindsay@knowcode.tech'),
+        ('pmorgan@wru.cymru'),
+        ('clive@hyperforma.co.uk'),
+        ('robbie.macintosh@marbledropper.com')
+) AS emails(email)
+LEFT JOIN auth.users u ON u.email = emails.email;

package/wru-auth-config.js

@@ -0,0 +1,17 @@
+// doc-builder.config.js - Configuration with Supabase Authentication
+module.exports = {
+  siteName: 'WRU Bid Analysis Documentation',
+  siteDescription: 'Analysis and documentation for WRU bidding process',
+  
+  // Enable Supabase authentication
+  features: {
+    authentication: 'supabase'  // This turns on auth (set to false for public)
+  },
+  
+  // Supabase configuration
+  auth: {
+    supabaseUrl: 'https://xcihhnfcitjrwbynxmka.supabase.co',
+    supabaseAnonKey: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InhjaWhobmZjaXRqcndieW54bWthIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTM0Mzc2MzcsImV4cCI6MjA2OTAxMzYzN30.zvWp3JFIR8fBIiwuFF5gqOR_Kxb42baZS5fsBz60XOY',
+    siteId: '4d8a53bf-dcdd-48c0-98e0-cd1451518735'
+  }
+};

package/assets/js/auth.js

@@ -1,67 +0,0 @@
-/**
- * Simple Client-Side Authentication for Documentation
- * This runs on every page load to check authentication
- * 
- * IMPORTANT: This is a basic authentication system suitable for
- * protecting documentation from casual access. For production
- * use with sensitive data, implement server-side authentication.
- */
-
-(function() {
-    'use strict';
-    
-    // Skip auth check on login and logout pages
-    const currentPage = window.location.pathname;
-    if (currentPage === '/login.html' || currentPage === '/logout.html' || currentPage.includes('login') || currentPage.includes('logout')) {
-        return;
-    }
-    
-    // Check if user is authenticated
-    function isAuthenticated() {
-        const authToken = getCookie('doc-auth');
-        if (!authToken) return false;
-        
-        try {
-            // Simple token validation - just check if it exists and has expected format
-            // The actual validation happens server-side (or in login page for static sites)
-            const decoded = atob(authToken);
-            return decoded && decoded.includes(':');
-        } catch (error) {
-            return false;
-        }
-    }
-    
-    // Get cookie value
-    function getCookie(name) {
-        const value = `; ${document.cookie}`;
-        const parts = value.split(`; ${name}=`);
-        if (parts.length === 2) return parts.pop().split(';').shift();
-        return null;
-    }
-    
-    // Redirect to login if not authenticated
-    function redirectToLogin() {
-        const currentUrl = window.location.pathname + window.location.search;
-        const loginUrl = '/login.html' + (currentUrl !== '/' ? '?redirect=' + encodeURIComponent(currentUrl) : '');
-        window.location.href = loginUrl;
-    }
-    
-    // Check authentication on page load
-    if (!isAuthenticated()) {
-        redirectToLogin();
-    }
-    
-    // Add logout functionality to logout buttons
-    document.addEventListener('DOMContentLoaded', function() {
-        const logoutLinks = document.querySelectorAll('a[href*="logout"]');
-        logoutLinks.forEach(link => {
-            link.addEventListener('click', function(e) {
-                e.preventDefault();
-                // Clear auth cookie
-                document.cookie = 'doc-auth=; path=/; expires=Thu, 01 Jan 1970 00:00:01 GMT;';
-                window.location.href = '/logout.html';
-            });
-        });
-    });
-    
-})();