@knowcode/doc-builder 1.9.29 → 1.9.31

package/RELEASE-NOTES-1.7.5.md

@@ -1,64 +0,0 @@
-# Release Notes - v1.7.5
-
-## 🎉 Major Change: Authentication is Now Optional by Default!
-
-Starting with v1.7.5, @knowcode/doc-builder defaults to creating **public documentation sites** without authentication. This aligns with the most common use case and makes it even easier to get started.
-
-### What's New
-
-#### 🔓 No Authentication by Default
-- Documentation sites are now public by default
-- No configuration needed for public docs
-- Authentication must be explicitly enabled when needed
-
-#### 🚀 New CLI Flags
-- `--no-auth` flag for both build and deploy commands
-- Override any authentication settings in your config
-- Perfect for quick public deployments
-
-### Examples
-
-```bash
-# Deploy public documentation (default behavior)
-npx @knowcode/doc-builder deploy
-
-# Force public deployment even if config has auth
-npx @knowcode/doc-builder deploy --no-auth
-
-# Enable authentication in config
-# doc-builder.config.js
-module.exports = {
-  features: {
-    authentication: 'supabase'  // Explicitly enable
-  }
-};
-```
-
-### Migration Guide
-
-#### If you want PUBLIC documentation:
-No changes needed! Your sites are now public by default.
-
-#### If you want PRIVATE documentation:
-Add this to your config:
-```javascript
-features: {
-  authentication: 'supabase'
-}
-```
-
-### Why This Change?
-
-- Most documentation should be publicly accessible
-- Reduces friction for new users
-- Makes the tool more intuitive
-- Authentication becomes an intentional choice
-
-### Full Changelog
-
-- **Changed**: Authentication disabled by default in all configurations
-- **Added**: `--no-auth` flags for build and deploy commands
-- **Improved**: Simplified configuration prompts
-- **Docs**: Added public site deployment guide
-
-This is a breaking change, but one that makes the tool simpler and more aligned with common use cases.

package/add-user-clive.sql

@@ -1,35 +0,0 @@
--- =====================================================
--- ADD SINGLE USER: clive@hyperforma.co.uk
--- Site: https://wru-bid-analysis.vercel.app/
--- =====================================================
-
--- STEP 1: Check if clive@hyperforma.co.uk exists
-SELECT email, id, created_at, last_sign_in_at
-FROM auth.users 
-WHERE email = 'clive@hyperforma.co.uk';
-
--- If NO RESULTS above, create the user:
--- 1. Go to: https://supabase.com/dashboard/project/xcihhnfcitjrwbynxmka/auth/users
--- 2. Click "Invite user"
--- 3. Enter: clive@hyperforma.co.uk
--- 4. Click "Send invitation"
-
--- STEP 2: After user is created, grant access
-INSERT INTO docbuilder_access (user_id, site_id)
-VALUES (
-    (SELECT id FROM auth.users WHERE email = 'clive@hyperforma.co.uk'),
-    '4d8a53bf-dcdd-48c0-98e0-cd1451518735'
-)
-ON CONFLICT (user_id, site_id) DO NOTHING;
-
--- STEP 3: Verify access was granted
-SELECT 
-    u.email,
-    u.id as user_id,
-    da.created_at as access_granted,
-    ds.domain as site_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 u.email = 'clive@hyperforma.co.uk'
-AND da.site_id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';

package/add-user-lindsay-fixed.sql

@@ -1,85 +0,0 @@
--- =====================================================
--- ADD SINGLE USER: lindsay@knowcode.tech
--- Site: https://wru-bid-analysis.vercel.app/
--- =====================================================
-
--- STEP 1: Update domain (only run once - you've already done this)
--- UPDATE docbuilder_sites 
--- SET domain = 'wru-bid-analysis.vercel.app',
---     name = 'WRU Bid Analysis Documentation'
--- WHERE id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';
-
--- =====================================================
--- STEP 2: CHECK IF USER EXISTS (RUN THIS FIRST!)
--- =====================================================
-SELECT email, id, created_at 
-FROM auth.users 
-WHERE email = 'lindsay@knowcode.tech';
-
--- ⚠️ IF THE ABOVE QUERY RETURNS NO ROWS, YOU MUST CREATE THE USER FIRST!
-
--- =====================================================
--- STEP 3: CREATE USER IN SUPABASE (if not exists)
--- =====================================================
--- Go to: https://supabase.com/dashboard/project/xcihhnfcitjrwbynxmka/auth/users
--- 1. Click the "Invite user" button
--- 2. Enter email: lindsay@knowcode.tech
--- 3. Click "Send invitation"
--- 4. User will receive email to set password
--- 5. WAIT for user to appear in the auth.users table before continuing!
-
--- =====================================================
--- STEP 4: VERIFY USER NOW EXISTS
--- =====================================================
--- Run this again to get the user ID:
-SELECT email, id 
-FROM auth.users 
-WHERE email = 'lindsay@knowcode.tech';
-
--- Copy the ID from above (it will look like: 123e4567-e89b-12d3-a456-426614174000)
-
--- =====================================================
--- STEP 5: GRANT ACCESS (only after user exists!)
--- =====================================================
--- Option A: If Step 4 returned a user, run this:
-INSERT INTO docbuilder_access (user_id, site_id)
-SELECT 
-    u.id,
-    '4d8a53bf-dcdd-48c0-98e0-cd1451518735'
-FROM auth.users u
-WHERE u.email = 'lindsay@knowcode.tech'
-AND EXISTS (
-    SELECT 1 FROM auth.users WHERE email = 'lindsay@knowcode.tech'
-);
-
--- Option B: If you have the user ID from Step 4, use it directly:
--- INSERT INTO docbuilder_access (user_id, site_id)
--- VALUES (
---     'paste-user-id-here',
---     '4d8a53bf-dcdd-48c0-98e0-cd1451518735'
--- );
-
--- =====================================================
--- STEP 6: VERIFY ACCESS WAS GRANTED
--- =====================================================
-SELECT 
-    u.email,
-    u.id as user_id,
-    da.created_at as access_granted
-FROM docbuilder_access da
-JOIN auth.users u ON u.id = da.user_id
-WHERE u.email = 'lindsay@knowcode.tech';
-
--- =====================================================
--- TROUBLESHOOTING
--- =====================================================
--- If you still get errors, check:
--- 1. Does the user exist? 
-SELECT COUNT(*) as user_exists FROM auth.users WHERE email = 'lindsay@knowcode.tech';
-
--- 2. Do they already have access?
-SELECT COUNT(*) as has_access 
-FROM docbuilder_access da
-JOIN auth.users u ON u.id = da.user_id
-WHERE u.email = 'lindsay@knowcode.tech' 
-AND da.site_id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';

package/add-user-lindsay.sql

@@ -1,68 +0,0 @@
--- =====================================================
--- ADD SINGLE USER: lindsay@knowcode.tech
--- Site: https://wru-bid-analysis.vercel.app/
--- =====================================================
-
--- STEP 1: Update domain (only run once)
-UPDATE docbuilder_sites 
-SET domain = 'wru-bid-analysis.vercel.app',
-    name = 'WRU Bid Analysis Documentation'
-WHERE id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';
-
--- Verify domain is correct
-SELECT id, domain, name FROM docbuilder_sites 
-WHERE id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';
-
--- =====================================================
--- STEP 2: Check if lindsay@knowcode.tech exists
--- =====================================================
-SELECT email, id, created_at, last_sign_in_at
-FROM auth.users 
-WHERE email = 'lindsay@knowcode.tech';
-
--- If NO RESULTS above, create the user:
--- 1. Go to: https://supabase.com/dashboard/project/xcihhnfcitjrwbynxmka/auth/users
--- 2. Click "Invite user"
--- 3. Enter: lindsay@knowcode.tech
--- 4. Click "Send invitation"
-
--- =====================================================
--- STEP 3: After user is created, grant access
--- =====================================================
--- Run this AFTER the user exists in Supabase
-INSERT INTO docbuilder_access (user_id, site_id)
-VALUES (
-    (SELECT id FROM auth.users WHERE email = 'lindsay@knowcode.tech'),
-    '4d8a53bf-dcdd-48c0-98e0-cd1451518735'
-)
-ON CONFLICT (user_id, site_id) DO NOTHING;
-
--- =====================================================
--- STEP 4: Verify access was granted
--- =====================================================
-SELECT 
-    u.email,
-    u.id as user_id,
-    da.created_at as access_granted,
-    ds.domain as site_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 u.email = 'lindsay@knowcode.tech'
-AND da.site_id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';
-
--- Should show:
--- email: lindsay@knowcode.tech
--- access_granted: (timestamp)
--- site_domain: wru-bid-analysis.vercel.app
-
--- =====================================================
--- TROUBLESHOOTING
--- =====================================================
--- If access wasn't granted, check for errors:
-SELECT id, email FROM auth.users WHERE email = 'lindsay@knowcode.tech';
-
--- If user can't log in after getting access:
--- 1. Clear browser cache
--- 2. Check they're using correct URL: https://wru-bid-analysis.vercel.app/
--- 3. Verify they set their password from invite email

package/add-user-pmorgan.sql

@@ -1,35 +0,0 @@
--- =====================================================
--- ADD SINGLE USER: pmorgan@wru.cymru
--- Site: https://wru-bid-analysis.vercel.app/
--- =====================================================
-
--- STEP 1: Check if pmorgan@wru.cymru exists
-SELECT email, id, created_at, last_sign_in_at
-FROM auth.users 
-WHERE email = 'pmorgan@wru.cymru';
-
--- If NO RESULTS above, create the user:
--- 1. Go to: https://supabase.com/dashboard/project/xcihhnfcitjrwbynxmka/auth/users
--- 2. Click "Invite user"
--- 3. Enter: pmorgan@wru.cymru
--- 4. Click "Send invitation"
-
--- STEP 2: After user is created, grant access
-INSERT INTO docbuilder_access (user_id, site_id)
-VALUES (
-    (SELECT id FROM auth.users WHERE email = 'pmorgan@wru.cymru'),
-    '4d8a53bf-dcdd-48c0-98e0-cd1451518735'
-)
-ON CONFLICT (user_id, site_id) DO NOTHING;
-
--- STEP 3: Verify access was granted
-SELECT 
-    u.email,
-    u.id as user_id,
-    da.created_at as access_granted,
-    ds.domain as site_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 u.email = 'pmorgan@wru.cymru'
-AND da.site_id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';

package/add-user-robbie.sql

@@ -1,35 +0,0 @@
--- =====================================================
--- ADD SINGLE USER: robbie.macintosh@marbledropper.com
--- Site: https://wru-bid-analysis.vercel.app/
--- =====================================================
-
--- STEP 1: Check if robbie.macintosh@marbledropper.com exists
-SELECT email, id, created_at, last_sign_in_at
-FROM auth.users 
-WHERE email = 'robbie.macintosh@marbledropper.com';
-
--- If NO RESULTS above, create the user:
--- 1. Go to: https://supabase.com/dashboard/project/xcihhnfcitjrwbynxmka/auth/users
--- 2. Click "Invite user"
--- 3. Enter: robbie.macintosh@marbledropper.com
--- 4. Click "Send invitation"
-
--- STEP 2: After user is created, grant access
-INSERT INTO docbuilder_access (user_id, site_id)
-VALUES (
-    (SELECT id FROM auth.users WHERE email = 'robbie.macintosh@marbledropper.com'),
-    '4d8a53bf-dcdd-48c0-98e0-cd1451518735'
-)
-ON CONFLICT (user_id, site_id) DO NOTHING;
-
--- STEP 3: Verify access was granted
-SELECT 
-    u.email,
-    u.id as user_id,
-    da.created_at as access_granted,
-    ds.domain as site_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 u.email = 'robbie.macintosh@marbledropper.com'
-AND da.site_id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';

package/add-wru-users.sql

@@ -1,105 +0,0 @@
--- =====================================================
--- ADD USERS TO WRU BID ANALYSIS DOCUMENTATION
--- Site: https://wru-bid-analysis.vercel.app/
--- Date: 2025-07-25
--- =====================================================
-
--- STEP 1: Update the domain to match your Vercel deployment
-UPDATE docbuilder_sites 
-SET domain = 'wru-bid-analysis.vercel.app',
-    name = 'WRU Bid Analysis Documentation'
-WHERE id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';
-
--- Verify the domain update
-SELECT id, domain, name FROM docbuilder_sites 
-WHERE id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';
-
--- =====================================================
--- STEP 2: CHECK IF USERS EXIST
--- =====================================================
--- Run this first to see which users already exist
-SELECT email, id, created_at 
-FROM auth.users 
-WHERE email IN (
-    'pmorgan@wru.cymru',
-    'clive@hyperforma.co.uk',
-    'robbie.macintosh@marbledropper.com',
-    'lindsay@knowcode.tech'
-);
-
--- =====================================================
--- IMPORTANT: CREATE MISSING USERS FIRST!
--- =====================================================
--- For any users that don't exist above:
--- 1. Go to Supabase Dashboard: https://supabase.com/dashboard/project/xcihhnfcitjrwbynxmka
--- 2. Navigate to Authentication → Users
--- 3. Click "Invite user" 
--- 4. Enter each missing email address
--- 5. They'll receive an email to set their password
-
--- =====================================================
--- STEP 3: GRANT ACCESS TO ALL USERS
--- =====================================================
--- Run this after all users have been created
-WITH users_to_add AS (
-    SELECT email FROM (VALUES 
-        ('pmorgan@wru.cymru'),
-        ('clive@hyperforma.co.uk'),
-        ('robbie.macintosh@marbledropper.com'),
-        ('lindsay@knowcode.tech')
-    ) AS t(email)
-)
-INSERT INTO docbuilder_access (user_id, site_id)
-SELECT u.id, '4d8a53bf-dcdd-48c0-98e0-cd1451518735'
-FROM auth.users u
-JOIN users_to_add ua ON u.email = ua.email
-WHERE NOT EXISTS (
-    -- This prevents duplicate entries if someone already has access
-    SELECT 1 FROM docbuilder_access 
-    WHERE user_id = u.id AND site_id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735'
-);
-
--- =====================================================
--- STEP 4: VERIFY ACCESS WAS GRANTED
--- =====================================================
--- Check who now has access to the 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
-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;
-
--- =====================================================
--- TROUBLESHOOTING
--- =====================================================
-
--- If someone can't log in, check if they exist:
-SELECT * FROM auth.users WHERE email = 'user@example.com';
-
--- If someone still can't access after login, verify their access:
-SELECT * FROM docbuilder_access 
-WHERE user_id = (SELECT id FROM auth.users WHERE email = 'user@example.com')
-AND site_id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';
-
--- To remove a user's access:
--- DELETE FROM docbuilder_access
--- WHERE user_id = (SELECT id FROM auth.users WHERE email = 'user@example.com')
--- AND site_id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';
-
--- =====================================================
--- USERS BEING ADDED:
--- =====================================================
--- 1. pmorgan@wru.cymru
--- 2. clive@hyperforma.co.uk
--- 3. robbie.macintosh@marbledropper.com
--- 4. lindsay@knowcode.tech
---
--- Site URL: https://wru-bid-analysis.vercel.app/
--- Site ID: 4d8a53bf-dcdd-48c0-98e0-cd1451518735

package/debug-login.sql

@@ -1,30 +0,0 @@
--- Debug Login Issues
--- Run these queries in Supabase SQL Editor to diagnose login problems
-
--- 1. Check if your user exists
-SELECT id, email, created_at, last_sign_in_at 
-FROM auth.users 
-WHERE email = 'YOUR_EMAIL_HERE';  -- Replace with your email
-
--- 2. Check what domains you have access to
-SELECT da.domain, da.created_at as access_granted
-FROM docbuilder_access da
-JOIN auth.users u ON da.user_id = u.id
-WHERE u.email = 'YOUR_EMAIL_HERE';  -- Replace with your email
-
--- 3. Check all users and their domains (admin view)
-SELECT u.email, da.domain, da.created_at
-FROM docbuilder_access da
-JOIN auth.users u ON da.user_id = u.id
-ORDER BY u.email, da.domain;
-
--- 4. If you need to grant yourself access to a domain
--- First get your user ID from query #1, then:
-INSERT INTO docbuilder_access (user_id, domain)
-VALUES ('YOUR_USER_ID', 'YOUR_DOMAIN_HERE');
--- Example domains: 'localhost:3000', 'doc-builder-delta.vercel.app', etc.
-
--- 5. Common domains to check/add:
--- For local development: 'localhost:3000' or 'localhost:8080'
--- For Vercel preview: 'your-app-name.vercel.app'
--- For production: 'docs.yourcompany.com'

package/doc-builder.config.js

@@ -1,126 +0,0 @@
-module.exports = {
-  "configVersion": "1.9.28",
-  "docsDir": "docs",
-  "outputDir": "html",
-  "siteName": "@knowcode/doc-builder",
-  "siteDescription": "Beautiful documentation with the least effort possible",
-  "favicon": "✨",
-  "features": {
-    "authentication": false,
-    "changelog": true,
-    "mermaid": true,
-    "mermaidEnhanced": true,
-    "tooltips": true,
-    "search": false,
-    "darkMode": true,
-    "phosphorIcons": true,
-    "phosphorWeight": "regular",
-    "phosphorSize": "1.2em",
-    "normalizeTitle": true,
-    "showPdfDownload": true,
-    "menuDefaultOpen": false,
-    "attachments": true,
-    "dynamicNavIcons": true,
-    "subtleColors": true,
-    "privateDirectoryAuth": false,
-    "banner": false,
-    "staticOutput": true
-  },
-  "staticOutputDir": "html-static",
-  "auth": {
-    "supabaseUrl": "https://xcihhnfcitjrwbynxmka.supabase.co",
-    "supabaseAnonKey": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InhjaWhobmZjaXRqcndieW54bWthIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTM0Mzc2MzcsImV4cCI6MjA2OTAxMzYzN30.zvWp3JFIR8fBIiwuFF5gqOR_Kxb42baZS5fsBz60XOY"
-  },
-  "changelog": {
-    "daysBack": 14,
-    "enabled": true
-  },
-  "banner": {
-    "enabled": false,
-    "text": "This documentation is a preview version - some content may be incomplete",
-    "icon": "fas fa-exclamation-triangle",
-    "type": "warning",
-    "dismissible": true
-  },
-  "folderOrder": [],
-  "folderDescriptions": {},
-  "folderIcons": {},
-  "deployment": {
-    "platform": "vercel",
-    "outputDirectory": "html"
-  },
-  "seo": {
-    "enabled": true,
-    "siteUrl": "https://doc-builder-delta.vercel.app",
-    "author": "Lindsay Smith",
-    "twitterHandle": "@planbbackups",
-    "language": "en-US",
-    "keywords": [
-      "documentation",
-      "markdown",
-      "static site generator",
-      "vercel",
-      "notion-style"
-    ],
-    "titleTemplate": "{pageTitle} | {siteName}",
-    "autoKeywords": true,
-    "keywordLimit": 7,
-    "descriptionFallback": "smart",
-    "organization": {
-      "name": "Knowcode Ltd",
-      "url": "https://knowcode.tech",
-      "logo": ""
-    },
-    "ogImage": "/og-default.png",
-    "generateSitemap": true,
-    "generateRobotsTxt": true,
-    "customMetaTags": [
-      {
-        "name": "google-site-verification",
-        "content": "FtzcDTf5BQ9K5EfnGazQkgU2U4FiN3ITzM7gHwqUAqQ"
-      },
-      {
-        "name": "msvalidate.01",
-        "content": "B2D8C4C12C530D47AA962B24CAA09630"
-      }
-    ]
-  },
-  "attachmentTypes": [
-    ".pdf",
-    ".doc",
-    ".docx",
-    ".xls",
-    ".xlsx",
-    ".csv",
-    ".ppt",
-    ".pptx",
-    ".txt",
-    ".rtf",
-    ".html",
-    ".htm",
-    ".zip",
-    ".tar",
-    ".gz",
-    ".7z",
-    ".rar",
-    ".png",
-    ".jpg",
-    ".jpeg",
-    ".gif",
-    ".svg",
-    ".webp",
-    ".ico",
-    ".bmp",
-    ".json",
-    ".xml",
-    ".yaml",
-    ".yml",
-    ".toml",
-    ".mp4",
-    ".mp3",
-    ".wav",
-    ".avi",
-    ".mov"
-  ],
-  "productionUrl": "https://doc-builder-delta.vercel.app"
-};

package/doc-builder.config.js.backup.1753793768283

@@ -1,47 +0,0 @@
-module.exports = {
-  "configVersion": "1.9.6",
-  "siteName": "@knowcode/doc-builder",
-  "siteDescription": "Beautiful documentation with the least effort possible",
-  "docsDir": "docs",
-  "outputDir": "html",
-  "productionUrl": "https://doc-builder-delta.vercel.app",
-  "features": {
-    "authentication": false,
-    "changelog": true,
-    "mermaid": true,
-    "darkMode": true,
-    "phosphorIcons": true,
-    "menuDefaultOpen": false
-  },
-  "seo": {
-    "enabled": true,
-    "siteUrl": "https://doc-builder-delta.vercel.app",
-    "author": "Lindsay Smith",
-    "twitterHandle": "@planbbackups",
-    "language": "en-US",
-    "keywords": [
-      "documentation",
-      "markdown",
-      "static site generator",
-      "vercel",
-      "notion-style"
-    ],
-    "generateSitemap": true,
-    "generateRobotsTxt": true,
-    "ogImage": "/og-default.png",
-    "organization": {
-      "name": "Knowcode Ltd",
-      "url": "https://knowcode.tech"
-    },
-    "customMetaTags": [
-      {
-        "name": "google-site-verification",
-        "content": "FtzcDTf5BQ9K5EfnGazQkgU2U4FiN3ITzM7gHwqUAqQ"
-      },
-      {
-        "name": "msvalidate.01",
-        "content": "B2D8C4C12C530D47AA962B24CAA09630"
-      }
-    ]
-  }
-};