npm - @knowcode/doc-builder - Versions diffs - 1.9.30 → 1.10.0 - Mend

@knowcode/doc-builder 1.9.30 → 1.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (198) hide show

package/lib/core-builder.js +164 -174
package/lib/emoji-mapper.js +27 -12
package/package.json +12 -2
package/.claude/settings.local.json +0 -56
package/CACHE-BUSTING-GUIDE.md +0 -82
package/CLAUDE.md +0 -86
package/CONTRIBUTING.md +0 -148
package/GITHUB_SETUP.md +0 -203
package/RELEASE-NOTES-1.7.5.md +0 -64
package/Screenshot 2025-07-22 at 19.51.21.png +0 -0
package/Screenshot 2025-07-26 at 17.06.49.png +0 -0
package/add-user-clive.sql +0 -35
package/add-user-lindsay-fixed.sql +0 -85
package/add-user-lindsay.sql +0 -68
package/add-user-pmorgan.sql +0 -35
package/add-user-robbie.sql +0 -35
package/add-wru-users.sql +0 -105
package/debug-login.sql +0 -30
package/doc-builder.config.js +0 -126
package/doc-builder.config.js.backup.1753793768283 +0 -47
package/doc-builder.config.js.backup.1753803964423 +0 -114
package/doc-builder.config.js.backup.1753945707032 +0 -115
package/doc-builder.config.js.backup.1754059241330 +0 -115
package/doc-builder.config.js.backup.1754119567787 +0 -123
package/doc-builder.config.js.backup.1754120048862 +0 -124
package/doc-builder.config.js.backup.1754120529913 +0 -124
package/doc-builder.config.js.backup.1754218469785 +0 -124
package/doc-builder.config.js.backup.1754384764054 +0 -124
package/doc-builder.config.js.backup.1754567425847 +0 -124
package/doc-builder.config.js.backup.1754568137859 +0 -126
package/doc-builder.config.js.backup.1754569388252 +0 -126
package/doc-builder.config.js.backup.1754576694123 +0 -126
package/doc-builder.config.js.backup.1755031374829 +0 -126
package/doc-builder.config.js.backup.1755034500990 +0 -126
package/doc-builder.config.js.backup.1755034809236 +0 -126
package/grant-access.sql +0 -15
package/html/11.png +0 -0
package/html/404.html +0 -115
package/html/README.html +0 -522
package/html/Screenshot 2025-08-12 at 21.35.07.png +0 -0
package/html/about-doc-builder.html +0 -491
package/html/auth.js +0 -157
package/html/claude-workflow-guide.html +0 -525
package/html/css/notion-style.css +0 -2502
package/html/documentation-index.html +0 -471
package/html/guides/authentication-default-change.html +0 -370
package/html/guides/authentication-guide.html +0 -509
package/html/guides/cache-control-anti-pattern.html +0 -361
package/html/guides/claude-workflow-guide.html +0 -1074
package/html/guides/configuration-guide.html +0 -472
package/html/guides/document-standards.html +0 -518
package/html/guides/documentation-standards.html +0 -694
package/html/guides/html-embedding-guide.html +0 -461
package/html/guides/image-modal-guide.html +0 -515
package/html/guides/next-steps-walkthrough.html +0 -638
package/html/guides/phosphor-icons-guide.html +0 -584
package/html/guides/private-directory-authentication-troubleshooting.html +0 -555
package/html/guides/private-directory-authentication.html +0 -541
package/html/guides/public-site-deployment.html +0 -431
package/html/guides/search-engine-verification-guide.html +0 -542
package/html/guides/seo-guide.html +0 -661
package/html/guides/seo-optimization-guide.html +0 -887
package/html/guides/supabase-auth-implementation-plan.html +0 -543
package/html/guides/supabase-auth-integration-plan.html +0 -671
package/html/guides/supabase-auth-setup-guide.html +0 -498
package/html/guides/supabase-authentication-complete-guide.html +0 -866
package/html/guides/troubleshooting-guide.html +0 -633
package/html/guides/vercel-deployment-auth-setup.html +0 -337
package/html/guides/windows-setup-guide.html +0 -859
package/html/image-modal-test.html +0 -318
package/html/index.html +0 -522
package/html/js/auth.js +0 -157
package/html/js/main.js +0 -1754
package/html/launch/README.html +0 -297
package/html/launch/bubble-plugin-specification.html +0 -933
package/html/launch/go-to-market-strategy.html +0 -663
package/html/launch/launch-announcements.html +0 -593
package/html/login.html +0 -102
package/html/logout.html +0 -18
package/html/private/cache-control-anti-pattern.html +0 -429
package/html/private/launch/README.html +0 -371
package/html/private/launch/auth-cleanup-summary.html +0 -361
package/html/private/launch/bubble-plugin-specification.html +0 -1007
package/html/private/launch/go-to-market-strategy.html +0 -737
package/html/private/launch/launch-announcements.html +0 -667
package/html/private/launch/vercel-deployment-auth-setup.html +0 -417
package/html/private/next-steps-walkthrough.html +0 -679
package/html/private/supabase-auth-implementation-completed.html +0 -454
package/html/private/supabase-auth-implementation-plan.html +0 -594
package/html/private/supabase-auth-integration-plan.html +0 -704
package/html/private/supabase-auth-setup-guide.html +0 -555
package/html/private/test-private-doc.html +0 -302
package/html/private/user-management-tooling.html +0 -601
package/html/prompts/Screenshot 2025-08-02 at 08.49.55.png +0 -0
package/html/prompts/beautiful-documentation-design.html +0 -784
package/html/prompts/markdown-document-standards.html +0 -422
package/html/prompts/project-rename-strategy-sasha-publish.html +0 -530
package/html/robots.txt +0 -9
package/html/sitemap.xml +0 -357
package/html/test-questions/how-does-it-work%3F.html +0 -294
package/html/test-questions/step-1%3A%20getting-started.html +0 -289
package/html/test-questions/what-is-the-purpose.html +0 -293
package/html/test-status.html +0 -281
package/html/vercel-cli-setup-guide.html +0 -495
package/html/vercel-first-time-setup-guide.html +0 -454
package/html/vercel.json +0 -29
package/html-static/11.png +0 -0
package/html-static/404.html +0 -115
package/html-static/README.html +0 -609
package/html-static/Screenshot 2025-08-12 at 21.35.07.png +0 -0
package/html-static/about-doc-builder.html +0 -578
package/html-static/css/notion-style.css +0 -2502
package/html-static/documentation-index.html +0 -558
package/html-static/guides/authentication-default-change.html +0 -457
package/html-static/guides/authentication-guide.html +0 -596
package/html-static/guides/claude-workflow-guide.html +0 -1161
package/html-static/guides/configuration-guide.html +0 -559
package/html-static/guides/documentation-standards.html +0 -781
package/html-static/guides/html-embedding-guide.html +0 -548
package/html-static/guides/image-modal-guide.html +0 -602
package/html-static/guides/phosphor-icons-guide.html +0 -671
package/html-static/guides/private-directory-authentication-troubleshooting.html +0 -642
package/html-static/guides/private-directory-authentication.html +0 -628
package/html-static/guides/public-site-deployment.html +0 -518
package/html-static/guides/search-engine-verification-guide.html +0 -629
package/html-static/guides/seo-guide.html +0 -748
package/html-static/guides/seo-optimization-guide.html +0 -974
package/html-static/guides/supabase-authentication-complete-guide.html +0 -953
package/html-static/guides/troubleshooting-guide.html +0 -720
package/html-static/guides/windows-setup-guide.html +0 -946
package/html-static/image-modal-test.html +0 -405
package/html-static/index.html +0 -609
package/html-static/js/main.js +0 -1754
package/html-static/prompts/Screenshot 2025-08-02 at 08.49.55.png +0 -0
package/html-static/prompts/beautiful-documentation-design.html +0 -871
package/html-static/prompts/markdown-document-standards.html +0 -509
package/html-static/prompts/project-rename-strategy-sasha-publish.html +0 -617
package/html-static/robots.txt +0 -5
package/html-static/sitemap.xml +0 -195
package/html-static/test-questions/how-does-it-work%3F.html +0 -381
package/html-static/test-questions/step-1%3A%20getting-started.html +0 -376
package/html-static/test-questions/what-is-the-purpose.html +0 -380
package/html-static/vercel-cli-setup-guide.html +0 -582
package/html-static/vercel-first-time-setup-guide.html +0 -541
package/manage-users.sql +0 -191
package/migrate-to-domain-auth.sql +0 -47
package/package/CACHE-BUSTING-GUIDE.md +0 -82
package/package/CHANGELOG.md +0 -902
package/package/README.md +0 -248
package/package/assets/css/notion-style.css +0 -2211
package/package/assets/js/auth.js +0 -67
package/package/assets/js/main.js +0 -1565
package/package/cli.js +0 -764
package/package/index.js +0 -38
package/package/knowcode-doc-builder-1.3.15.tgz +0 -0
package/package/lib/builder.js +0 -32
package/package/lib/config.js +0 -278
package/package/lib/core-builder.js +0 -957
package/package/lib/deploy.js +0 -497
package/package/lib/dev-server.js +0 -96
package/package/package.json +0 -34
package/package/scripts/npx-runner.js +0 -27
package/package/scripts/setup.js +0 -56
package/package/test-cache-bust.sh +0 -43
package/public-config.js +0 -22
package/public-html/404.html +0 -115
package/public-html/README.html +0 -149
package/public-html/css/notion-style.css +0 -2036
package/public-html/index.html +0 -149
package/public-html/js/auth.js +0 -67
package/public-html/js/main.js +0 -1485
package/quick-test-commands.md +0 -40
package/recordings/Screenshot 2025-07-24 at 18.22.01.png +0 -0
package/recordings/mh-ls-22jul.txt +0 -2305
package/screenshot.png +0 -0
package/scripts/Screenshot 2025-07-23 at 15.39.41.png +0 -0
package/setup-database-v2.sql +0 -53
package/setup-database.sql +0 -41
package/test-auth-config.js +0 -17
package/test-cache-bust.sh +0 -43
package/test-docs/README.md +0 -39
package/test-html/404.html +0 -115
package/test-html/README.html +0 -172
package/test-html/auth.js +0 -97
package/test-html/css/notion-style.css +0 -2036
package/test-html/index.html +0 -172
package/test-html/js/auth.js +0 -97
package/test-html/js/main.js +0 -1485
package/test-html/login.html +0 -102
package/test-html/logout.html +0 -18
package/update-domain.sql +0 -9
package/user-access-view.sql +0 -49
package/user-management/README.md +0 -301
package/user-management/add-users.sh +0 -776
package/user-management/create-user.js +0 -65
package/user-management/users.txt +0 -15
package/view-all-users.sql +0 -40
package/wru-auth-config.js +0 -17

package/test-html/login.html DELETED Viewed

@@ -1,102 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Login - Test Documentation</title>
-    <link rel="stylesheet" href="css/notion-style.css">
-    <script src="https://unpkg.com/@supabase/supabase-js@2"></script>
-</head>
-<body class="auth-page">
-    <div class="auth-container">
-        <div class="auth-box">
-            <h1>Login to Test Documentation</h1>
-            <form id="login-form">
-                <div class="form-group">
-                    <label for="email">Email</label>
-                    <input type="email" id="email" name="email" 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 class="auth-links">
-                <a href="#" id="forgot-password">Forgot Password?</a>
-            </div>
-        </div>
-    </div>
-    <script>
-        // Initialize Supabase
-        const { createClient } = supabase;
-        const supabaseClient = createClient('https://xcihhnfcitjrwbynxmka.supabase.co', 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InhjaWhobmZjaXRqcndieW54bWthIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTM0Mzc2MzcsImV4cCI6MjA2OTAxMzYzN30.zvWp3JFIR8fBIiwuFF5gqOR_Kxb42baZS5fsBz60XOY');
-        // Handle login form
-        document.getElementById('login-form').addEventListener('submit', async function(e) {
-            e.preventDefault();
-            const email = document.getElementById('email').value;
-            const password = document.getElementById('password').value;
-            const errorDiv = document.getElementById('error-message');
-            try {
-                // Sign in with Supabase
-                const { data, error } = await supabaseClient.auth.signInWithPassword({
-                    email: email,
-                    password: password
-                });
-                if (error) throw error;
-                // Check if user has access to this site
-                const { data: access, error: accessError } = await supabaseClient
-                    .from('docbuilder_access')
-                    .select('*')
-                    .eq('user_id', data.user.id)
-                    .eq('site_id', '4d8a53bf-dcdd-48c0-98e0-cd1451518735')
-                    .single();
-                if (accessError || !access) {
-                    await supabaseClient.auth.signOut();
-                    throw new Error('You do not have access to this documentation site');
-                }
-                // Redirect to requested page
-                const params = new URLSearchParams(window.location.search);
-                const redirect = params.get('redirect') || '/';
-                window.location.href = redirect;
-            } catch (error) {
-                errorDiv.textContent = error.message;
-                errorDiv.style.display = 'block';
-            }
-        });
-        // Handle forgot password
-        document.getElementById('forgot-password').addEventListener('click', async function(e) {
-            e.preventDefault();
-            const email = document.getElementById('email').value;
-            if (!email) {
-                alert('Please enter your email address first');
-                return;
-            }
-            try {
-                const { error } = await supabaseClient.auth.resetPasswordForEmail(email, {
-                    redirectTo: window.location.origin + '/login.html'
-                });
-                if (error) throw error;
-                alert('Password reset email sent! Check your inbox.');
-            } catch (error) {
-                alert('Error sending reset email: ' + error.message);
-            }
-        });
-    </script>
-</body>
-</html>

package/test-html/logout.html DELETED Viewed

@@ -1,18 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Logged Out - Test Documentation</title>
-    <link rel="stylesheet" href="css/notion-style.css">
-</head>
-<body class="auth-page">
-    <div class="auth-container">
-        <div class="auth-box">
-            <h1>You have been logged out</h1>
-            <p>Thank you for using Test Documentation.</p>
-            <a href="login.html" class="auth-button">Login Again</a>
-        </div>
-    </div>
-</body>
-</html>

package/update-domain.sql DELETED Viewed

@@ -1,9 +0,0 @@
--- Update domain for Vercel deployment
-UPDATE docbuilder_sites
-SET domain = 'doc-builder-2znroyb5z-lindsay-1340s-projects.vercel.app'
-WHERE id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';
--- Verify the update
-SELECT id, domain, name
-FROM docbuilder_sites
-WHERE id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';

package/user-access-view.sql DELETED Viewed

@@ -1,49 +0,0 @@
--- Create a view to easily see user access with email addresses
--- This makes it much easier to manage user access
--- Drop the view if it exists (to recreate with latest schema)
-DROP VIEW IF EXISTS user_access_view;
--- Create the view joining docbuilder_access with auth.users
-CREATE VIEW user_access_view AS
-SELECT
-    u.email,
-    da.domain,
-    da.created_at as access_granted,
-    u.created_at as user_created,
-    u.last_sign_in_at,
-    u.id as user_id
-FROM
-    docbuilder_access da
-    JOIN auth.users u ON da.user_id = u.id
-ORDER BY
-    da.domain,
-    u.email;
--- Grant permissions to authenticated users to view their own records
-GRANT SELECT ON user_access_view TO authenticated;
--- Example queries using the view:
--- 1. See all users for a specific domain
--- SELECT * FROM user_access_view WHERE domain = 'docs.example.com';
--- 2. See all domains a user has access to
--- SELECT * FROM user_access_view WHERE email = 'user@example.com';
--- 3. Count users per domain
--- SELECT domain, COUNT(*) as user_count
--- FROM user_access_view
--- GROUP BY domain
--- ORDER BY user_count DESC;
--- 4. Find users who haven't logged in recently
--- SELECT email, domain, last_sign_in_at
--- FROM user_access_view
--- WHERE last_sign_in_at < NOW() - INTERVAL '30 days'
--- OR last_sign_in_at IS NULL;
--- 5. Export all access for documentation
--- SELECT email, domain, access_granted
--- FROM user_access_view
--- ORDER BY domain, email;

package/user-management/README.md DELETED Viewed

@@ -1,301 +0,0 @@
-# Doc-Builder User Management System
-A comprehensive user management solution for Supabase-authenticated documentation sites using the Supabase CLI.
-## 🚀 Quick Start
-```bash
-# Initial setup
-./add-users.sh setup
-# Add a user
-./add-users.sh add wru-bid-analysis.vercel.app user@email.com
-# List all users for a site
-./add-users.sh list wru-bid-analysis.vercel.app
-```
-## 📋 Prerequisites
-1. **Install Supabase CLI**:
-   ```bash
-   npm install -g supabase
-   ```
-2. **Login to Supabase**:
-   ```bash
-   supabase login
-   ```
-3. **Link your project** (or use the setup command):
-   ```bash
-   ./add-users.sh setup
-   ```
-## 🔧 Installation
-The user management system is self-contained in this folder:
-```
-user-management/
-├── add-users.sh     # Main script
-├── users.txt        # Example bulk user file
-├── README.md        # This documentation
-└── .env.example     # Environment variables template
-```
-## 📖 Commands
-### Setup
-Initialize and link your Supabase project:
-```bash
-./add-users.sh setup
-```
-This will:
-- Check if Supabase CLI is installed
-- Verify you're logged in
-- Link your project (prompts for project ID)
-- Test the database connection
-- Save configuration for future use
-### Add User
-Create a user and grant them access to a specific site:
-```bash
-./add-users.sh add <site-url> <email>
-# Example
-./add-users.sh add docs.example.com john@company.com
-```
-This will:
-- Create the user account if it doesn't exist
-- Send them a password reset email
-- Grant access to the specified site
-- Show confirmation of access granted
-### Bulk Add Users
-Add multiple users from a file:
-```bash
-./add-users.sh bulk <site-url> <file>
-# Example
-./add-users.sh bulk docs.example.com users.txt
-```
-File format (users.txt):
-```
-# Comments start with #
-# One email per line
-john@example.com
-jane@example.com
-admin@company.com
-```
-### List Users
-Show all users with access to a site:
-```bash
-./add-users.sh list <site-url>
-# Example
-./add-users.sh list wru-bid-analysis.vercel.app
-```
-Output includes:
-- Email address
-- When user was created
-- When access was granted
-- Last login time
-- Total user count
-### Check User
-Check a user's status across all sites:
-```bash
-./add-users.sh check <email>
-# Example
-./add-users.sh check user@example.com
-```
-Shows:
-- If user exists
-- All sites they have access to
-- Last login information
-### Remove Access
-Remove a user's access to a specific site:
-```bash
-./add-users.sh remove <site-url> <email>
-# Example
-./add-users.sh remove docs.example.com user@example.com
-```
-Note: This only removes access, it doesn't delete the user account.
-### List Sites
-Show all documentation sites in the system:
-```bash
-./add-users.sh sites
-```
-Shows:
-- Site ID
-- Domain
-- Site name
-- Creation date
-- Number of users
-### Delete User
-Permanently delete a user (removes from ALL sites):
-```bash
-./add-users.sh delete-user <email>
-# Example
-./add-users.sh delete-user user@example.com
-```
-⚠️ **Warning**: This is permanent and cannot be undone!
-## ⚠️ Important Limitations
-1. **User Creation**: The Supabase CLI doesn't support direct user creation. The script offers two workarounds:
-   - **Manual Creation** (Recommended): Opens the Supabase dashboard where you can invite users
-   - **Programmatic Creation** (Advanced): If you provide your service_role key, the script can create users using the Admin API
-2. **SQL Execution**: Older versions of Supabase CLI (< 2.7) don't support `db execute`. The script will:
-   - Try to use `psql` if you have `DATABASE_URL` set
-   - Fall back to showing SQL for manual execution in the dashboard
-   - Consider updating: `npm update -g supabase`
-## 🔐 Security Notes
-1. **User Creation**: When users are created, they receive a password reset email to set their own password
-2. **Access Control**: Users only see sites they have explicit access to
-3. **Audit Trail**: All access grants are timestamped in the database
-4. **No Passwords**: The system never handles or stores passwords directly
-5. **Service Role Key**: If using programmatic creation, your service_role key is never stored
-## 🛠️ Troubleshooting
-### "Supabase CLI not found"
-Install the Supabase CLI:
-```bash
-npm install -g supabase
-```
-### "Not logged in to Supabase"
-Login to your Supabase account:
-```bash
-supabase login
-```
-### "Project not linked"
-Run the setup command:
-```bash
-./add-users.sh setup
-```
-### "Site not found"
-With the new domain-based system, sites no longer need to be registered. Just use the domain directly when granting access.
-### "User already exists"
-This is fine - the script will continue and grant access to the site.
-### "Access already granted"
-The user already has access to this site. No action needed.
-## 📊 Database Schema
-The system uses a single table with domain-based access:
-### docbuilder_access
-- `user_id` (UUID) - References auth.users
-- `domain` (TEXT) - Site domain (e.g., docs.example.com)
-- `created_at` (TIMESTAMP)
-- Primary key on (user_id, domain)
-## 🎯 Common Workflows
-### Setting up a new documentation site
-No site registration needed! Just add users with domain access:
-```bash
-./add-users.sh add my-docs.vercel.app user1@example.com
-./add-users.sh add my-docs.vercel.app user2@example.com
-```
-### Onboarding multiple team members
-1. Create a users.txt file with all email addresses
-2. Run bulk add:
-   ```bash
-   ./add-users.sh bulk my-docs.vercel.app users.txt
-   ```
-### Auditing access
-Check who has access to a site:
-```bash
-./add-users.sh list my-docs.vercel.app
-```
-Check what sites a user can access:
-```bash
-./add-users.sh check user@example.com
-```
-### Offboarding a user
-Remove from specific site:
-```bash
-./add-users.sh remove my-docs.vercel.app former-employee@example.com
-```
-Or remove completely:
-```bash
-./add-users.sh delete-user former-employee@example.com
-```
-## 🔧 Configuration
-The script stores its configuration in `.supabase-config` after setup. You can also set environment variables:
-- `SUPABASE_PROJECT_ID` - Your project ID
-- `SUPABASE_DB_URL` - Database connection URL (optional)
-## 📝 Notes
-- Site URLs should be entered without `https://` prefix
-- Users receive password reset emails when created
-- The script uses the Supabase CLI for all operations
-- All actions are logged with colored output for clarity
-- Destructive operations require confirmation
-## 🆘 Support
-- GitHub: https://github.com/wapdat/doc-builder
-- Documentation: https://doc-builder-delta.vercel.app
-- Supabase Dashboard: https://supabase.com/dashboard