@knowcode/doc-builder 1.9.29 → 1.9.31

package/setup-database-v2.sql

@@ -1,53 +0,0 @@
--- Doc-builder Supabase Database Setup V2
--- Simplified schema using domains instead of site IDs
--- Run this in your Supabase SQL Editor
-
--- Drop old tables if migrating
--- DROP TABLE IF EXISTS docbuilder_access;
--- DROP TABLE IF EXISTS docbuilder_sites;
-
--- Single table for user access control
-CREATE TABLE docbuilder_access (
-    user_id UUID REFERENCES auth.users(id) ON DELETE CASCADE,
-    domain TEXT NOT NULL,
-    created_at TIMESTAMPTZ DEFAULT NOW(),
-    PRIMARY KEY (user_id, domain)
-);
-
--- Create index for faster lookups
-CREATE INDEX idx_docbuilder_access_domain ON docbuilder_access(domain);
-
--- Enable Row Level Security
-ALTER TABLE docbuilder_access ENABLE ROW LEVEL SECURITY;
-
--- RLS Policy: Users can only see their own access
-CREATE POLICY "Users see own access" ON docbuilder_access
-    FOR SELECT USING (user_id = auth.uid());
-
--- Example: Grant access to a user for a specific domain
--- INSERT INTO docbuilder_access (user_id, domain) 
--- VALUES ('user-uuid-here', 'doc-builder-delta.vercel.app');
-
--- Example: Grant access to multiple users for a domain
--- INSERT INTO docbuilder_access (user_id, domain) VALUES 
---   ('user-1-uuid', 'mydocs.vercel.app'),
---   ('user-2-uuid', 'mydocs.vercel.app'),
---   ('user-3-uuid', 'mydocs.vercel.app');
-
--- Example: Grant a user access to multiple domains
--- INSERT INTO docbuilder_access (user_id, domain) VALUES 
---   ('user-uuid', 'docs.example.com'),
---   ('user-uuid', 'internal-docs.example.com'),
---   ('user-uuid', 'api-docs.example.com');
-
--- View all access for a domain (admin use)
--- SELECT u.email, da.created_at
--- FROM docbuilder_access da
--- JOIN auth.users u ON da.user_id = u.id
--- WHERE da.domain = 'mydocs.vercel.app';
-
--- Migration from old schema (if needed)
--- INSERT INTO docbuilder_access (user_id, domain)
--- SELECT da.user_id, ds.domain
--- FROM old_docbuilder_access da
--- JOIN docbuilder_sites ds ON da.site_id = ds.id;

package/setup-database.sql

@@ -1,41 +0,0 @@
--- Doc-builder Supabase Database Setup
--- Run this in your Supabase SQL Editor
-
--- Table 1: Documentation sites
-CREATE TABLE docbuilder_sites (
-    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-    domain TEXT UNIQUE NOT NULL,
-    name TEXT NOT NULL,
-    created_at TIMESTAMPTZ DEFAULT NOW()
-);
-
--- Table 2: User access mapping
-CREATE TABLE docbuilder_access (
-    user_id UUID REFERENCES auth.users(id) ON DELETE CASCADE,
-    site_id UUID REFERENCES docbuilder_sites(id) ON DELETE CASCADE,
-    created_at TIMESTAMPTZ DEFAULT NOW(),
-    PRIMARY KEY (user_id, site_id)
-);
-
--- Enable Row Level Security
-ALTER TABLE docbuilder_sites ENABLE ROW LEVEL SECURITY;
-ALTER TABLE docbuilder_access ENABLE ROW LEVEL SECURITY;
-
--- RLS Policy: Users can only see sites they have access to
-CREATE POLICY "Users see accessible sites" ON docbuilder_sites
-    FOR SELECT USING (
-        EXISTS (
-            SELECT 1 FROM docbuilder_access
-            WHERE site_id = docbuilder_sites.id
-            AND user_id = auth.uid()
-        )
-    );
-
--- RLS Policy: Users can see their own access
-CREATE POLICY "Users see own access" ON docbuilder_access
-    FOR SELECT USING (user_id = auth.uid());
-
--- Insert a test site for localhost development
-INSERT INTO docbuilder_sites (domain, name) 
-VALUES ('localhost:3000', 'Test Documentation Site')
-RETURNING id, domain, name;

package/test-auth-config.js

@@ -1,17 +0,0 @@
-module.exports = {
-  siteName: 'Test Documentation',
-  siteDescription: 'Testing Supabase authentication integration',
-  
-  features: {
-    authentication: 'supabase',
-    darkMode: true,
-    mermaid: true,
-    changelog: false  // Disable for simpler testing
-  },
-  
-  auth: {
-    supabaseUrl: 'https://xcihhnfcitjrwbynxmka.supabase.co',
-    supabaseAnonKey: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InhjaWhobmZjaXRqcndieW54bWthIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTM0Mzc2MzcsImV4cCI6MjA2OTAxMzYzN30.zvWp3JFIR8fBIiwuFF5gqOR_Kxb42baZS5fsBz60XOY',
-    siteId: '4d8a53bf-dcdd-48c0-98e0-cd1451518735'
-  }
-};

package/test-cache-bust.sh

@@ -1,43 +0,0 @@
-#!/bin/bash
-
-echo "🧹 Cache Busting Test for doc-builder"
-echo "===================================="
-
-# Step 1: Clean everything
-echo "1. Removing old build artifacts..."
-rm -rf html/
-rm -rf node_modules/
-rm -rf .cache/
-
-# Step 2: Clear npm cache
-echo "2. Clearing npm cache..."
-npm cache clean --force
-
-# Step 3: Install latest version
-echo "3. Installing latest doc-builder..."
-npm install @knowcode/doc-builder@latest
-
-# Step 4: Show version
-echo "4. Installed version:"
-npm list @knowcode/doc-builder
-
-# Step 5: Build fresh
-echo "5. Building documentation..."
-npx @knowcode/doc-builder build
-
-# Step 6: Check CSS content
-echo "6. Checking if CSS has latest changes..."
-echo "   Looking for 'margin: 0; /* Left aligned'..."
-grep -n "margin: 0; /\* Left aligned" html/css/notion-style.css || echo "NOT FOUND!"
-
-echo "   Looking for 'position: fixed; /* Use fixed'..."
-grep -n "position: fixed; /\* Use fixed" html/css/notion-style.css || echo "NOT FOUND!"
-
-echo ""
-echo "✅ If you see the CSS changes above, the package is working correctly!"
-echo "🚨 If not found, there's a build issue we need to investigate."
-echo ""
-echo "Next steps:"
-echo "1. Deploy with: vercel --prod --force"
-echo "2. Open in incognito/private browsing"
-echo "3. Hard refresh: Cmd+Shift+R (Mac) or Ctrl+Shift+R (Windows)"

package/test-docs/README.md

@@ -1,39 +0,0 @@
-# 🔐 Test Documentation with Supabase Auth
-
-Welcome to the test documentation site! If you can see this page, it means:
-
-## ✅ Authentication is Working!
-
-- You successfully logged in with Supabase
-- Your user account has access to this documentation site
-- The JWT token is valid and verified
-- Row Level Security is properly configured
-
-## 🧪 Test Features
-
-### Secure Access
-This page is protected by enterprise-grade Supabase authentication. Only authorized users can view this content.
-
-### Modern Technology Stack
-- **Frontend**: Generated static HTML with auth checking
-- **Backend**: Supabase authentication and database
-- **Security**: JWT tokens, bcrypt password hashing, RLS policies
-
-### What This Proves
-1. **Database Setup**: Tables were created correctly
-2. **Authentication Flow**: Login → JWT → Access check → Content
-3. **Integration**: doc-builder + Supabase working together
-4. **Security**: Only authenticated users with proper access can see this
-
-## 🎯 Next Steps
-
-Once this test works, we can:
-- Deploy to Vercel with production settings
-- Add more users and documentation sites  
-- Set up your real documentation content
-- Configure custom domains and advanced features
-
----
-
-**Generated by**: @knowcode/doc-builder with Supabase authentication  
-**Test Date**: July 25, 2025

package/test-html/404.html

@@ -1,115 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Page Not Found - Redirecting...</title>
-    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet">
-    <style>
-        body {
-            font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
-            margin: 0;
-            padding: 0;
-            display: flex;
-            align-items: center;
-            justify-content: center;
-            min-height: 100vh;
-            background-color: #f7f7f5;
-            color: #37352f;
-        }
-        .container {
-            text-align: center;
-            padding: 2rem;
-            max-width: 600px;
-        }
-        h1 {
-            font-size: 3rem;
-            margin: 0 0 1rem 0;
-            color: #37352f;
-        }
-        p {
-            font-size: 1.125rem;
-            line-height: 1.6;
-            color: #6b6b6b;
-            margin: 0 0 2rem 0;
-        }
-        a {
-            color: #0366d6;
-            text-decoration: none;
-        }
-        a:hover {
-            text-decoration: underline;
-        }
-        .emoji {
-            font-size: 4rem;
-            margin-bottom: 1rem;
-        }
-        .loading {
-            display: none;
-            color: #0366d6;
-            margin-top: 1rem;
-        }
-        .redirect-message {
-            display: none;
-            background-color: #e8f4fd;
-            border: 1px solid #c3e0f7;
-            padding: 1rem;
-            border-radius: 8px;
-            margin-top: 1rem;
-        }
-    </style>
-</head>
-<body>
-    <div class="container">
-        <div class="emoji">🔍</div>
-        <h1>404</h1>
-        <p id="message">The page you're looking for doesn't exist.</p>
-        <div id="redirect-message" class="redirect-message">
-            Redirecting to the correct page...
-        </div>
-        <p id="loading" class="loading">Redirecting...</p>
-        <p>
-            <a href="/" id="home-link">Go to Home</a>
-        </p>
-    </div>
-
-    <script>
-        // Check if the URL ends with .md
-        const pathname = window.location.pathname;
-        
-        if (pathname.endsWith('.md')) {
-            // Convert .md to .html
-            const htmlPath = pathname.replace(/\.md$/, '.html');
-            
-            // Show redirect message
-            document.getElementById('message').textContent = 'Found a markdown link. Redirecting to the HTML version...';
-            document.getElementById('redirect-message').style.display = 'block';
-            document.getElementById('loading').style.display = 'block';
-            
-            // Redirect after a brief delay to show the message
-            setTimeout(() => {
-                window.location.replace(htmlPath);
-            }, 500);
-        } else {
-            // For true 404s, show the standard message
-            document.getElementById('message').textContent = "The page you're looking for doesn't exist.";
-            
-            // Also check if we can suggest a similar page
-            // Remove common suffixes and try to find a match
-            const basePath = pathname
-                .replace(/\.(html|htm|php|asp|aspx)$/, '')
-                .replace(/\/$/, '');
-            
-            if (basePath && basePath !== pathname) {
-                document.getElementById('message').innerHTML = 
-                    `The page you're looking for doesn't exist.<br>
-                     <small>Did you mean <a href="${basePath}.html">${basePath}.html</a>?</small>`;
-            }
-        }
-        
-        // Update home link to use the correct base URL
-        const baseUrl = window.location.origin;
-        document.getElementById('home-link').href = baseUrl;
-    </script>
-</body>
-</html>

package/test-html/README.html

@@ -1,172 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <meta name="description" content="Welcome to the test documentation site! If you can see this page, it means:">
-    <title>🔐 Test Documentation with Supabase Auth - Test Documentation</title>
-    
-
-    
-    <!-- Fonts -->
-    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
-    
-    <!-- Icons -->
-    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css">
-    
-    
-    <!-- Mermaid -->
-    <script src="https://cdn.jsdelivr.net/npm/mermaid@10.6.1/dist/mermaid.min.js"></script>
-    
-    <!-- Styles -->
-    <link rel="stylesheet" href="/css/notion-style.css">
-    
-    
-    <!-- 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 -->
-    <link rel="icon" href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text y=%22.9em%22 font-size=%2290%22>✨</text></svg>">
-    
-    
-</head>
-<body>
-    <!-- Header -->
-    <header class="header">
-        <div class="header-content">
-            <a href="/index.html" class="logo">Test Documentation</a>
-            
-            <div class="header-actions">
-                <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.7.4">Last updated: Jul 25, 2025, 12:27 PM UTC</span>
-                </div>
-                
-                
-                <a href="../logout.html" class="logout-btn" title="Logout">
-                    <i class="fas fa-sign-out-alt"></i>
-                </a>
-                
-                
-                <button id="theme-toggle" class="theme-toggle" aria-label="Toggle theme">
-                    <i class="fas fa-moon"></i>
-                </button>
-                
-                <button id="menu-toggle" class="menu-toggle" aria-label="Toggle menu">
-                    <i class="fas fa-bars"></i>
-                </button>
-            </div>
-        </div>
-    </header>
-    
-    <!-- Preview Banner -->
-    <div id="preview-banner" class="preview-banner">
-        <div class="banner-content">
-            <i class="fas fa-exclamation-triangle banner-icon"></i>
-            <span class="banner-text">This documentation is a preview version - some content may be incomplete</span>
-            <button id="dismiss-banner" class="banner-dismiss" aria-label="Dismiss banner">
-                <i class="fas fa-times"></i>
-            </button>
-        </div>
-    </div>
-    
-    <!-- Breadcrumbs -->
-    <nav class="breadcrumbs" id="breadcrumbs">
-        <!-- Breadcrumbs will be generated by JavaScript -->
-    </nav>
-    
-    <!-- Main Content -->
-    <div class="main-wrapper">
-        <!-- Sidebar -->
-        <aside class="sidebar">
-            <div class="sidebar-header">
-                <div class="filter-box">
-                    <input type="text" placeholder="Filter items..." class="filter-input" id="nav-filter">
-                    <i class="fas fa-search filter-icon"></i>
-                </div>
-            </div>
-            <nav class="navigation">
-                
-      <div class="nav-section" data-level="0">
-        <a class="nav-title expanded" href="/README.html"  >
-          <i class="fas fa-home"></i> Documentation
-        </a>
-        <div class="nav-content" >
-        <a href="/README.html" class="nav-item active" data-tooltip="🔐 Test Documentation with Supabase Auth."><i class="fas fa-file-alt"></i> Overview</a></div></div>
-            </nav>
-            <div class="resize-handle"></div>
-        </aside>
-        
-        <!-- Content Area -->
-        <main class="content">
-            <div class="content-inner">
-                <h1><i class="ph ph-lock-key" aria-label="secure"></i> Test Documentation with Supabase Auth</h1>
-<p>Welcome to the test documentation site! If you can see this page, it means:</p>
-<h2><i class="ph ph-check-circle" aria-label="checked"></i> Authentication is Working!</h2>
-<ul>
-<li>You successfully logged in with Supabase</li>
-<li>Your user account has access to this documentation site</li>
-<li>The JWT token is valid and verified</li>
-<li>Row Level Security is properly configured</li>
-</ul>
-<h2>🧪 Test Features</h2>
-<h3>Secure Access</h3>
-<p>This page is protected by enterprise-grade Supabase authentication. Only authorized users can view this content.</p>
-<h3>Modern Technology Stack</h3>
-<ul>
-<li><strong>Frontend</strong>: Generated static HTML with auth checking</li>
-<li><strong>Backend</strong>: Supabase authentication and database</li>
-<li><strong>Security</strong>: JWT tokens, bcrypt password hashing, RLS policies</li>
-</ul>
-<h3>What This Proves</h3>
-<ol>
-<li><strong>Database Setup</strong>: Tables were created correctly</li>
-<li><strong>Authentication Flow</strong>: Login → JWT → Access check → Content</li>
-<li><strong>Integration</strong>: doc-builder + Supabase working together</li>
-<li><strong>Security</strong>: Only authenticated users with proper access can see this</li>
-</ol>
-<h2><i class="ph ph-target" aria-label="goal"></i> Next Steps</h2>
-<p>Once this test works, we can:</p>
-<ul>
-<li>Deploy to Vercel with production settings</li>
-<li>Add more users and documentation sites  </li>
-<li>Set up your real documentation content</li>
-<li>Configure custom domains and advanced features</li>
-</ul>
-<hr>
-<p><strong>Generated by</strong>: @knowcode/doc-builder with Supabase authentication<br><strong>Test Date</strong>: July 25, 2025</p>
-
-            </div>
-        </main>
-    </div>
-    
-    <!-- Scripts -->
-    <script>
-    // Pass configuration to frontend
-    window.docBuilderConfig = {
-      features: {
-        showPdfDownload: true,
-        menuDefaultOpen: true
-      }
-    };
-    </script>
-    <script src="/js/main.js"></script>
-    <script src="https://unpkg.com/@supabase/supabase-js@2"></script>
-    <script src="/js/auth.js"></script>
-</body>
-</html>

package/test-html/auth.js

@@ -1,97 +0,0 @@
-
-/**
- * Supabase Authentication for Documentation Site
- * Generated by @knowcode/doc-builder
- */
-
-(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;
-    }
-    
-    // Initialize Supabase client
-    const { createClient } = supabase;
-    const supabaseClient = createClient('https://xcihhnfcitjrwbynxmka.supabase.co', 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InhjaWhobmZjaXRqcndieW54bWthIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTM0Mzc2MzcsImV4cCI6MjA2OTAxMzYzN30.zvWp3JFIR8fBIiwuFF5gqOR_Kxb42baZS5fsBz60XOY', {
-        auth: {
-            persistSession: true,
-            autoRefreshToken: true,
-            detectSessionInUrl: true
-        }
-    });
-    
-    // Check authentication and site access
-    async function checkAuth() {
-        try {
-            // Get current user session
-            const { data: { user }, error: userError } = await supabaseClient.auth.getUser();
-            
-            if (userError || !user) {
-                redirectToLogin();
-                return;
-            }
-            
-            // Check if user has access to this site
-            const { data: access, error: accessError } = await supabaseClient
-                .from('docbuilder_access')
-                .select('*')
-                .eq('user_id', user.id)
-                .eq('site_id', '4d8a53bf-dcdd-48c0-98e0-cd1451518735')
-                .single();
-            
-            if (accessError || !access) {
-                showAccessDenied();
-                return;
-            }
-            
-            // User is authenticated and has access
-            console.log('User authenticated and authorized');
-            document.body.classList.add('authenticated');
-            
-        } catch (error) {
-            console.error('Auth check failed:', error);
-            redirectToLogin();
-        }
-    }
-    
-    // Redirect to login page
-    function redirectToLogin() {
-        const currentUrl = window.location.pathname + window.location.search;
-        const loginUrl = '/login.html' + (currentUrl !== '/' ? '?redirect=' + encodeURIComponent(currentUrl) : '');
-        window.location.href = loginUrl;
-    }
-    
-    // Show access denied message
-    function showAccessDenied() {
-        document.body.classList.add('authenticated'); // Show the body
-        document.body.innerHTML = `
-            <div style="display: flex; justify-content: center; align-items: center; height: 100vh; font-family: Inter, sans-serif;">
-                <div style="text-align: center; max-width: 400px;">
-                    <h1 style="color: #ef4444; margin-bottom: 1rem;">Access Denied</h1>
-                    <p style="color: #6b7280; margin-bottom: 2rem;">You don't have permission to view this documentation site.</p>
-                    <a href="/login.html" style="background: #3b82f6; color: white; padding: 0.75rem 1.5rem; border-radius: 0.5rem; text-decoration: none;">Try Different Account</a>
-                </div>
-            </div>
-        `;
-    }
-    
-    // Add logout functionality
-    document.addEventListener('DOMContentLoaded', function() {
-        const logoutLinks = document.querySelectorAll('a[href*="logout"]');
-        logoutLinks.forEach(link => {
-            link.addEventListener('click', async function(e) {
-                e.preventDefault();
-                await supabaseClient.auth.signOut();
-                window.location.href = '/logout.html';
-            });
-        });
-    });
-    
-    // Run auth check
-    checkAuth();
-    
-})();