@knowcode/doc-builder 1.8.1 → 1.8.3

package/html/private/next-steps-walkthrough.html

@@ -98,8 +98,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-26T10:20:52.434Z",
-  "dateModified": "2025-07-26T10:20:52.434Z",
+  "datePublished": "2025-07-26T11:11:45.920Z",
+  "dateModified": "2025-07-26T11:11:45.920Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/private/next-steps-walkthrough.html"
@@ -138,7 +138,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.8.0">Last updated: Jul 26, 2025, 10:20 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.8.2">Last updated: Jul 26, 2025, 11:11 AM UTC</span>
                 </div>
                 
                 
@@ -223,7 +223,8 @@
         <a href="/private/supabase-auth-implementation-plan.html" class="nav-item" data-tooltip="Supabase Auth Implementation Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Implementation Plan</a>
         <a href="/private/supabase-auth-integration-plan.html" class="nav-item" data-tooltip="Supabase Authentication Integration Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Integration Plan</a>
         <a href="/private/supabase-auth-setup-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder supports enterprise-grade authentication through Supabase."><i class="fas fa-file-alt"></i> Supabase Auth Setup Guide</a>
-        <a href="/private/test-private-doc.html" class="nav-item" data-tooltip="Test Private Document."><i class="fas fa-file-alt"></i> Test Private Doc</a></div></div>
+        <a href="/private/test-private-doc.html" class="nav-item" data-tooltip="Test Private Document."><i class="fas fa-file-alt"></i> Test Private Doc</a>
+        <a href="/private/user-management-tooling.html" class="nav-item" data-tooltip="The user management system is a set of tools designed to manage user access to Supabase-authenticated documentation sites built with."><i class="fas fa-file-alt"></i> User Management Tooling</a></div></div>
       <div class="nav-section" data-level="2">
         <a class="nav-title collapsible" href="/private/launch/README.html" data-target="nav-private-launch-2" >
           <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Launch
@@ -267,37 +268,21 @@ npm install
 <li><strong>Go to SQL Editor</strong> in Supabase dashboard</li>
 <li><strong>Run this SQL</strong> to create the required tables:</li>
 </ol>
-<pre><code class="language-sql">-- 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
+<pre><code class="language-sql">-- Single table for user access control (simplified!)
 CREATE TABLE docbuilder_access (
     user_id UUID REFERENCES auth.users(id) ON DELETE CASCADE,
-    site_id UUID REFERENCES docbuilder_sites(id) ON DELETE CASCADE,
+    domain TEXT NOT NULL,
     created_at TIMESTAMPTZ DEFAULT NOW(),
-    PRIMARY KEY (user_id, site_id)
+    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_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 &quot;Users see accessible sites&quot; 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
+-- RLS Policy: Users can only see their own access
 CREATE POLICY &quot;Users see own access&quot; ON docbuilder_access
     FOR SELECT USING (user_id = auth.uid());
 </code></pre>
@@ -324,9 +309,8 @@ module.exports = {
   },
   
   auth: {
-    supabaseUrl: &#39;YOUR_SUPABASE_URL_HERE&#39;,
-    supabaseAnonKey: &#39;YOUR_ANON_KEY_HERE&#39;,
-    siteId: &#39;&#39;  // Will be filled in next step
+    supabaseUrl: &#39;YOUR_SUPABASE_URL_HERE&#39;,  // Optional - has defaults
+    supabaseAnonKey: &#39;YOUR_ANON_KEY_HERE&#39;    // Optional - has defaults
   }
 };
 EOF
@@ -342,18 +326,8 @@ EOF
 </code></pre>
 <p>This should prompt you for Supabase credentials and create/update the config.</p>
 <ol start="2">
-<li><strong>Add a test site to database</strong>:</li>
+<li><strong>No site registration needed!</strong> The new system uses domains automatically.</li>
 </ol>
-<pre><code class="language-sql">-- Run in Supabase SQL Editor
-INSERT INTO docbuilder_sites (domain, name) 
-VALUES (&#39;localhost:3000&#39;, &#39;Test Site&#39;)
-RETURNING id;
-</code></pre>
-<ol start="3">
-<li><strong>Copy the returned site ID</strong> and update your <code>test-config.js</code>:</li>
-</ol>
-<pre><code class="language-javascript">siteId: &#39;the-uuid-returned-from-above&#39;
-</code></pre>
 <h3>Step 7: Create Test Documentation</h3>
 <ol>
 <li><strong>Create test docs folder</strong>:</li>
@@ -421,9 +395,9 @@ If you can see this page, authentication is working!&quot; &gt; test-docs/README
 </ol>
 <h3>Step 11: Grant Access to Test User</h3>
 <pre><code class="language-sql">-- Run in Supabase SQL Editor
--- Replace with actual user ID and site ID
-INSERT INTO docbuilder_access (user_id, site_id)
-VALUES (&#39;USER_ID_FROM_STEP_10&#39;, &#39;SITE_ID_FROM_STEP_6&#39;);
+-- Replace with actual user ID from step 10
+INSERT INTO docbuilder_access (user_id, domain)
+VALUES (&#39;USER_ID_FROM_STEP_10&#39;, &#39;localhost:3001&#39;);
 </code></pre>
 <h3>Step 12: Test Complete Flow</h3>
 <ol>

package/html/private/supabase-auth-implementation-completed.html

@@ -98,8 +98,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-26T10:20:52.436Z",
-  "dateModified": "2025-07-26T10:20:52.436Z",
+  "datePublished": "2025-07-26T11:11:45.921Z",
+  "dateModified": "2025-07-26T11:11:45.921Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/private/supabase-auth-implementation-completed.html"
@@ -138,7 +138,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.8.0">Last updated: Jul 26, 2025, 10:20 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.8.2">Last updated: Jul 26, 2025, 11:11 AM UTC</span>
                 </div>
                 
                 
@@ -223,7 +223,8 @@
         <a href="/private/supabase-auth-implementation-plan.html" class="nav-item" data-tooltip="Supabase Auth Implementation Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Implementation Plan</a>
         <a href="/private/supabase-auth-integration-plan.html" class="nav-item" data-tooltip="Supabase Authentication Integration Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Integration Plan</a>
         <a href="/private/supabase-auth-setup-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder supports enterprise-grade authentication through Supabase."><i class="fas fa-file-alt"></i> Supabase Auth Setup Guide</a>
-        <a href="/private/test-private-doc.html" class="nav-item" data-tooltip="Test Private Document."><i class="fas fa-file-alt"></i> Test Private Doc</a></div></div>
+        <a href="/private/test-private-doc.html" class="nav-item" data-tooltip="Test Private Document."><i class="fas fa-file-alt"></i> Test Private Doc</a>
+        <a href="/private/user-management-tooling.html" class="nav-item" data-tooltip="The user management system is a set of tools designed to manage user access to Supabase-authenticated documentation sites built with."><i class="fas fa-file-alt"></i> User Management Tooling</a></div></div>
       <div class="nav-section" data-level="2">
         <a class="nav-title collapsible" href="/private/launch/README.html" data-target="nav-private-launch-2" >
           <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Launch
@@ -293,9 +294,9 @@
     authentication: &#39;supabase&#39;  // Must explicitly enable
   },
   auth: {
-    supabaseUrl: &#39;https://xxx.supabase.co&#39;,
-    supabaseAnonKey: &#39;your-anon-key&#39;,
-    siteId: &#39;your-site-id&#39;
+    supabaseUrl: &#39;https://xxx.supabase.co&#39;,  // Optional - has defaults
+    supabaseAnonKey: &#39;your-anon-key&#39;         // Optional - has defaults
+    // No siteId needed - uses domain automatically!
   }
 };
 </code></pre>

package/html/private/supabase-auth-implementation-plan.html

@@ -98,8 +98,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-26T10:20:52.438Z",
-  "dateModified": "2025-07-26T10:20:52.438Z",
+  "datePublished": "2025-07-26T11:11:45.924Z",
+  "dateModified": "2025-07-26T11:11:45.924Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/private/supabase-auth-implementation-plan.html"
@@ -138,7 +138,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.8.0">Last updated: Jul 26, 2025, 10:20 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.8.2">Last updated: Jul 26, 2025, 11:11 AM UTC</span>
                 </div>
                 
                 
@@ -223,7 +223,8 @@
         <a href="/private/supabase-auth-implementation-plan.html" class="nav-item active" data-tooltip="Supabase Auth Implementation Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Implementation Plan</a>
         <a href="/private/supabase-auth-integration-plan.html" class="nav-item" data-tooltip="Supabase Authentication Integration Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Integration Plan</a>
         <a href="/private/supabase-auth-setup-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder supports enterprise-grade authentication through Supabase."><i class="fas fa-file-alt"></i> Supabase Auth Setup Guide</a>
-        <a href="/private/test-private-doc.html" class="nav-item" data-tooltip="Test Private Document."><i class="fas fa-file-alt"></i> Test Private Doc</a></div></div>
+        <a href="/private/test-private-doc.html" class="nav-item" data-tooltip="Test Private Document."><i class="fas fa-file-alt"></i> Test Private Doc</a>
+        <a href="/private/user-management-tooling.html" class="nav-item" data-tooltip="The user management system is a set of tools designed to manage user access to Supabase-authenticated documentation sites built with."><i class="fas fa-file-alt"></i> User Management Tooling</a></div></div>
       <div class="nav-section" data-level="2">
         <a class="nav-title collapsible" href="/private/launch/README.html" data-target="nav-private-launch-2" >
           <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Launch
@@ -277,43 +278,26 @@
     
     subgraph "Supabase"
         AuthUsers[auth.users]
-        DocSites[docbuilder_sites]
-        DocAccess[docbuilder_access]
+        DocAccess[docbuilder_access with domain]
         AuthUsers -.-> DocAccess
-        DocAccess -.-> DocSites
     end</div>
     </div>
 <h2>Database Schema</h2>
-<pre><code class="language-sql">-- 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
+<pre><code class="language-sql">-- Single table for user access control (simplified!)
 CREATE TABLE docbuilder_access (
     user_id UUID REFERENCES auth.users(id) ON DELETE CASCADE,
-    site_id UUID REFERENCES docbuilder_sites(id) ON DELETE CASCADE,
+    domain TEXT NOT NULL,
     created_at TIMESTAMPTZ DEFAULT NOW(),
-    PRIMARY KEY (user_id, site_id)
+    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_sites ENABLE ROW LEVEL SECURITY;
 ALTER TABLE docbuilder_access ENABLE ROW LEVEL SECURITY;
 
--- RLS Policies
-CREATE POLICY &quot;Users see accessible sites&quot; 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 only see their own access
 CREATE POLICY &quot;Users see own access&quot; ON docbuilder_access
     FOR SELECT USING (user_id = auth.uid());
 </code></pre>
@@ -328,10 +312,10 @@ CREATE POLICY &quot;Users see own access&quot; ON docbuilder_access
 <p><strong>File</strong>: <code>lib/config.js</code></p>
 <pre><code class="language-javascript">// Updated auth configuration - REMOVE basic auth fields
 auth: {
-  // Only Supabase fields remain
+  // Only Supabase fields remain (domain-based, no siteId!)
   supabaseUrl: &#39;&#39;,
-  supabaseAnonKey: &#39;&#39;,
-  siteId: &#39;&#39;
+  supabaseAnonKey: &#39;&#39;
+  // Domain is detected automatically from window.location.host
 }
 </code></pre>
 <h4>1.2 Create Supabase Auth Module</h4>

package/html/private/supabase-auth-integration-plan.html

@@ -98,8 +98,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-26T10:20:52.440Z",
-  "dateModified": "2025-07-26T10:20:52.440Z",
+  "datePublished": "2025-07-26T11:11:45.927Z",
+  "dateModified": "2025-07-26T11:11:45.927Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/private/supabase-auth-integration-plan.html"
@@ -138,7 +138,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.8.0">Last updated: Jul 26, 2025, 10:20 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.8.2">Last updated: Jul 26, 2025, 11:11 AM UTC</span>
                 </div>
                 
                 
@@ -223,7 +223,8 @@
         <a href="/private/supabase-auth-implementation-plan.html" class="nav-item" data-tooltip="Supabase Auth Implementation Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Implementation Plan</a>
         <a href="/private/supabase-auth-integration-plan.html" class="nav-item active" data-tooltip="Supabase Authentication Integration Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Integration Plan</a>
         <a href="/private/supabase-auth-setup-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder supports enterprise-grade authentication through Supabase."><i class="fas fa-file-alt"></i> Supabase Auth Setup Guide</a>
-        <a href="/private/test-private-doc.html" class="nav-item" data-tooltip="Test Private Document."><i class="fas fa-file-alt"></i> Test Private Doc</a></div></div>
+        <a href="/private/test-private-doc.html" class="nav-item" data-tooltip="Test Private Document."><i class="fas fa-file-alt"></i> Test Private Doc</a>
+        <a href="/private/user-management-tooling.html" class="nav-item" data-tooltip="The user management system is a set of tools designed to manage user access to Supabase-authenticated documentation sites built with."><i class="fas fa-file-alt"></i> User Management Tooling</a></div></div>
       <div class="nav-section" data-level="2">
         <a class="nav-title collapsible" href="/private/launch/README.html" data-target="nav-private-launch-2" >
           <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Launch
@@ -286,77 +287,40 @@
     style RLS fill:#f87171</div>
     </div>
 <h2>Database Schema</h2>
-<h3>Core Tables</h3>
-<pre><code class="language-sql">-- Organizations table
-CREATE TABLE organizations (
-    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-    name TEXT NOT NULL,
-    slug TEXT UNIQUE NOT NULL,
-    created_at TIMESTAMPTZ DEFAULT NOW(),
-    settings JSONB DEFAULT &#39;{}&#39;::jsonb
-);
-
--- Documentation sites table
-CREATE TABLE doc_sites (
-    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-    org_id UUID REFERENCES organizations(id),
-    name TEXT NOT NULL,
-    domain TEXT UNIQUE NOT NULL,
-    config JSONB DEFAULT &#39;{}&#39;::jsonb,
+<h3>Simplified Domain-Based Design</h3>
+<pre><code class="language-sql">-- 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(),
-    is_active BOOLEAN DEFAULT true
+    PRIMARY KEY (user_id, domain)
 );
 
--- User access table (many-to-many)
-CREATE TABLE user_site_access (
-    user_id UUID REFERENCES auth.users(id),
-    site_id UUID REFERENCES doc_sites(id),
-    role TEXT NOT NULL DEFAULT &#39;viewer&#39;,
-    granted_at TIMESTAMPTZ DEFAULT NOW(),
-    granted_by UUID REFERENCES auth.users(id),
-    expires_at TIMESTAMPTZ,
-    PRIMARY KEY (user_id, site_id)
-);
+-- Create index for faster lookups
+CREATE INDEX idx_docbuilder_access_domain ON docbuilder_access(domain);
 
--- Access logs for audit trail
+-- Optional: Access logs for audit trail
 CREATE TABLE access_logs (
     id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
     user_id UUID REFERENCES auth.users(id),
-    site_id UUID REFERENCES doc_sites(id),
+    domain TEXT NOT NULL,
     action TEXT NOT NULL,
     metadata JSONB DEFAULT &#39;{}&#39;::jsonb,
     ip_address INET,
     user_agent TEXT,
     created_at TIMESTAMPTZ DEFAULT NOW()
 );
-
--- Invitation links
-CREATE TABLE invitations (
-    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-    site_id UUID REFERENCES doc_sites(id),
-    email TEXT NOT NULL,
-    role TEXT NOT NULL DEFAULT &#39;viewer&#39;,
-    token TEXT UNIQUE NOT NULL,
-    created_by UUID REFERENCES auth.users(id),
-    created_at TIMESTAMPTZ DEFAULT NOW(),
-    expires_at TIMESTAMPTZ NOT NULL,
-    claimed_at TIMESTAMPTZ,
-    claimed_by UUID REFERENCES auth.users(id)
-);
 </code></pre>
 <h3>Row Level Security Policies</h3>
-<pre><code class="language-sql">-- Users can only see sites they have access to
-CREATE POLICY &quot;Users can view accessible sites&quot; ON doc_sites
-    FOR SELECT USING (
-        EXISTS (
-            SELECT 1 FROM user_site_access
-            WHERE site_id = doc_sites.id
-            AND user_id = auth.uid()
-            AND (expires_at IS NULL OR expires_at &gt; NOW())
-        )
-    );
+<pre><code class="language-sql">-- Enable RLS on tables
+ALTER TABLE docbuilder_access ENABLE ROW LEVEL SECURITY;
+ALTER TABLE access_logs ENABLE ROW LEVEL SECURITY;
 
--- Access logs are append-only
+-- Users can only see their own access records
+CREATE POLICY &quot;Users see own access&quot; ON docbuilder_access
+    FOR SELECT USING (user_id = auth.uid());
+
+-- Access logs are append-only by authenticated users
 CREATE POLICY &quot;Insert access logs&quot; ON access_logs
     FOR INSERT WITH CHECK (user_id = auth.uid());
 
@@ -415,18 +379,20 @@ class SupabaseAuthManager {
         }
       }
     );
-    this.siteId = config.siteId;
   }
 
   async checkAccess() {
     const { data: { user } } = await this.supabase.auth.getUser();
     if (!user) return false;
 
+    // Use current domain for access check
+    const domain = window.location.host;
+    
     const { data, error } = await this.supabase
-      .from(&#39;user_site_access&#39;)
-      .select(&#39;role, expires_at&#39;)
+      .from(&#39;docbuilder_access&#39;)
+      .select(&#39;created_at&#39;)
       .eq(&#39;user_id&#39;, user.id)
-      .eq(&#39;site_id&#39;, this.siteId)
+      .eq(&#39;domain&#39;, domain)
       .single();
 
     if (error || !data) return false;
@@ -469,7 +435,7 @@ class SupabaseAuthManager {
 
   async logAccess(action, metadata = {}) {
     await this.supabase.from(&#39;access_logs&#39;).insert({
-      site_id: this.siteId,
+      domain: window.location.host,
       action,
       metadata,
       ip_address: await this.getClientIP(),
@@ -485,8 +451,8 @@ async function buildWithSupabaseAuth(config) {
     // Inject Supabase configuration
     const supabaseConfig = {
       supabaseUrl: config.auth.supabaseUrl,
-      supabaseAnonKey: config.auth.supabaseAnonKey,
-      siteId: config.auth.siteId
+      supabaseAnonKey: config.auth.supabaseAnonKey
+      // Domain is detected automatically from window.location.host
     };
 
     // Create enhanced auth.js with Supabase integration
@@ -520,8 +486,8 @@ async function buildWithSupabaseAuth(config) {
   auth: {
     // Supabase configuration
     supabaseUrl: process.env.SUPABASE_URL,
-    supabaseAnonKey: process.env.SUPABASE_ANON_KEY,
-    siteId: process.env.DOC_SITE_ID,
+    supabaseAnonKey: process.env.SUPABASE_ANON_KEY
+    // Domain-based authentication - no siteId needed
     
     // Optional: Custom login page styling
     loginTheme: {