insforge 0.3.3 → 1.3.0

package/docs/deprecated/insforge-db-sdk.md

@@ -1,140 +1,140 @@
-# InsForge Database SDK
-
-## Setup
-```javascript
-import { createClient } from '@insforge/sdk';
-const client = createClient({ baseUrl: 'http://localhost:7130' });
-```
-
-## Query Builder
-
-### from(table)
-```javascript
-client.database.from('posts')  // Returns QueryBuilder
-```
-
-## Operations
-
-### select
-```javascript
-.select()              // All columns
-.select('id, title')   // Specific columns
-.select('*, user:user_id(name, email)')  // Foreign key expansion
-```
-
-### insert
-```javascript
-.insert({ title: 'Hello' }).select()     // Single record with data returned
-.insert([{...}, {...}]).select()         // Multiple records with data returned
-// Note: Always sends array to API
-// Without .select(), returns null data
-```
-
-### update
-```javascript
-.update({ title: 'Updated' }).eq('id', '123').select()
-// Must chain with filter and .select() to return data
-```
-
-### delete
-```javascript
-.delete().eq('id', '123').select()
-// Must chain with filter and .select() to return data
-```
-
-### upsert
-```javascript
-.upsert({ id: '123', title: 'New or Update' }).select()
-// Updates if exists, inserts if not
-// Use .select() to return data
-```
-
-## Filters
-
-```javascript
-.eq('col', value)      // column = value
-.neq('col', value)     // column != value
-.gt('col', value)      // column > value
-.gte('col', value)     // column >= value
-.lt('col', value)      // column < value
-.lte('col', value)     // column <= value
-.like('col', '%pat%')  // LIKE pattern
-.ilike('col', '%pat%') // ILIKE pattern
-.is('col', null)       // IS NULL
-.in('col', [1,2,3])    // IN array
-
-.or('status.eq.active,status.eq.pending')  // OR condition
-.and('price.gte.100,price.lte.500')        // Explicit AND
-.not('deleted', 'is.true')                 // NOT condition
-```
-
-### OR Examples
-```javascript
-// Simple OR
-.or('status.eq.active,status.eq.pending')
-// WHERE status = 'active' OR status = 'pending'
-
-// OR with other filters (implicit AND)
-.eq('user_id', '123')
-.or('status.eq.draft,status.eq.published')
-// WHERE user_id = '123' AND (status = 'draft' OR status = 'published')
-
-// Complex OR with NOT
-.or('age.lt.18,age.gt.65,not.is_active.is.true')
-// WHERE age < 18 OR age > 65 OR NOT is_active
-```
-
-## Modifiers
-
-```javascript
-.order('col')                        // ASC
-.order('col', { ascending: false })  // DESC
-.limit(10)
-.offset(20)
-.range(0, 9)                         // Headers: Range: 0-9
-.single()                            // Return object not array
-.count('exact')                      // Include total count
-```
-
-## Execute
-
-```javascript
-// Methods are thenable
-const { data, error } = await client.database
-  .from('posts')
-  .select()
-  .eq('user_id', '123')
-  .limit(10);
-
-// data: array or null
-// error: { message, statusCode, code } or null
-```
-
-## Foreign Key Expansion
-
-```javascript
-// PostgREST syntax
-.select('*, user:user_id(name, email)')
-
-// Response:
-{
-  id: '123',
-  title: 'Post',
-  user_id: '456',
-  user: { name: 'John', email: 'john@example.com' }
-}
-```
-
-## Users Table
-
-```javascript
-// Profile data (not auth)
-await client.database.from('users').select().eq('id', userId).single()
-await client.database.from('users').update({ nickname, avatar_url }).eq('id', userId).select()
-```
-
-## Notes
-- Uses PostgREST under the hood
-- POST requires array format `[{...}]`
-- All methods return QueryBuilder for chaining
+# InsForge Database SDK
+
+## Setup
+```javascript
+import { createClient } from '@insforge/sdk';
+const client = createClient({ baseUrl: 'http://localhost:7130' });
+```
+
+## Query Builder
+
+### from(table)
+```javascript
+client.database.from('posts')  // Returns QueryBuilder
+```
+
+## Operations
+
+### select
+```javascript
+.select()              // All columns
+.select('id, title')   // Specific columns
+.select('*, user:user_id(name, email)')  // Foreign key expansion
+```
+
+### insert
+```javascript
+.insert({ title: 'Hello' }).select()     // Single record with data returned
+.insert([{...}, {...}]).select()         // Multiple records with data returned
+// Note: Always sends array to API
+// Without .select(), returns null data
+```
+
+### update
+```javascript
+.update({ title: 'Updated' }).eq('id', '123').select()
+// Must chain with filter and .select() to return data
+```
+
+### delete
+```javascript
+.delete().eq('id', '123').select()
+// Must chain with filter and .select() to return data
+```
+
+### upsert
+```javascript
+.upsert({ id: '123', title: 'New or Update' }).select()
+// Updates if exists, inserts if not
+// Use .select() to return data
+```
+
+## Filters
+
+```javascript
+.eq('col', value)      // column = value
+.neq('col', value)     // column != value
+.gt('col', value)      // column > value
+.gte('col', value)     // column >= value
+.lt('col', value)      // column < value
+.lte('col', value)     // column <= value
+.like('col', '%pat%')  // LIKE pattern
+.ilike('col', '%pat%') // ILIKE pattern
+.is('col', null)       // IS NULL
+.in('col', [1,2,3])    // IN array
+
+.or('status.eq.active,status.eq.pending')  // OR condition
+.and('price.gte.100,price.lte.500')        // Explicit AND
+.not('deleted', 'is.true')                 // NOT condition
+```
+
+### OR Examples
+```javascript
+// Simple OR
+.or('status.eq.active,status.eq.pending')
+// WHERE status = 'active' OR status = 'pending'
+
+// OR with other filters (implicit AND)
+.eq('user_id', '123')
+.or('status.eq.draft,status.eq.published')
+// WHERE user_id = '123' AND (status = 'draft' OR status = 'published')
+
+// Complex OR with NOT
+.or('age.lt.18,age.gt.65,not.is_active.is.true')
+// WHERE age < 18 OR age > 65 OR NOT is_active
+```
+
+## Modifiers
+
+```javascript
+.order('col')                        // ASC
+.order('col', { ascending: false })  // DESC
+.limit(10)
+.offset(20)
+.range(0, 9)                         // Headers: Range: 0-9
+.single()                            // Return object not array
+.count('exact')                      // Include total count
+```
+
+## Execute
+
+```javascript
+// Methods are thenable
+const { data, error } = await client.database
+  .from('posts')
+  .select()
+  .eq('user_id', '123')
+  .limit(10);
+
+// data: array or null
+// error: { message, statusCode, code } or null
+```
+
+## Foreign Key Expansion
+
+```javascript
+// PostgREST syntax
+.select('*, user:user_id(name, email)')
+
+// Response:
+{
+  id: '123',
+  title: 'Post',
+  user_id: '456',
+  user: { name: 'John', email: 'john@example.com' }
+}
+```
+
+## Users Table
+
+```javascript
+// Profile data (not auth)
+await client.database.from('users').select().eq('id', userId).single()
+await client.database.from('users').update({ nickname, avatar_url }).eq('id', userId).select()
+```
+
+## Notes
+- Uses PostgREST under the hood
+- POST requires array format `[{...}]`
+- All methods return QueryBuilder for chaining
 - Execute returns `{ data, error }`

package/docs/deprecated/insforge-debug-sdk.md

@@ -1,157 +1,157 @@
-# InsForge Debug SDK
-
-## Common SDK Errors
-
-### Auth Errors
-```javascript
-// Token not stored
-{ code: 'MISSING_AUTHORIZATION_HEADER' }
-// Fix: User needs to login
-
-// Token expired
-{ code: 'INVALID_TOKEN' }
-// Fix: client.auth.signInWithPassword()
-
-// Invalid credentials
-{ code: 'INVALID_CREDENTIALS' }
-// Fix: Check email/password
-```
-
-### Database Errors
-```javascript
-// Table doesn't exist
-{ statusCode: 404, message: 'Table not found' }
-// Fix: Use MCP tool to create table
-
-// Missing required field
-{ code: '23502', message: 'null value in column "user_id"' }
-// Fix: Include all required fields
-
-// Foreign key violation
-{ code: '23503', message: 'violates foreign key constraint' }
-// Fix: Referenced record must exist
-
-// Permission denied
-{ code: '42501', message: 'permission denied for table' }
-// Fix: User must be authenticated
-```
-
-## Debug Techniques
-
-### 1. Check Authentication
-```javascript
-const { data, error } = await client.auth.getCurrentUser();
-if (error) {
-  console.log('Not authenticated:', error.message);
-  // Need to login first
-}
-```
-
-### 2. Verify Token Storage
-```javascript
-const { data } = await client.auth.getCurrentSession();
-console.log('Stored token:', data?.session?.accessToken ? 'Present' : 'Missing');
-```
-
-### 3. Test Database Connection
-```javascript
-// Simple query to test connection
-const { error } = await client.database.from('users').select().limit(1);
-if (error) {
-  console.log('Database issue:', error);
-}
-```
-
-### 4. Enable Network Inspection
-```javascript
-// Browser: Open DevTools > Network tab
-// Check request headers for Authorization: Bearer token
-// Check response for error details
-```
-
-### 5. Test With Raw HTTP
-```javascript
-// When SDK fails, test endpoint directly
-const response = await fetch('http://localhost:7130/api/database/records/posts', {
-  headers: {
-    'Authorization': 'Bearer ' + token
-  }
-});
-const data = await response.json();
-console.log('Raw response:', data);
-```
-
-## Common Issues
-
-### Empty Response
-```javascript
-// INSERT/UPDATE/DELETE return empty without Prefer header
-// SDK handles this automatically, but check if using raw API
-```
-
-### Array Format
-```javascript
-// POST requires array
-// ❌ Wrong: { title: 'Test' }
-// ✅ Right: [{ title: 'Test' }]
-// SDK handles this automatically
-```
-
-### Token Not Persisting
-```javascript
-// Check storage adapter
-const client = createClient({
-  baseUrl: 'http://localhost:7130',
-});
-```
-
-### CORS Issues
-```javascript
-// Backend allows all origins by default
-// If modified, check backend CORS settings
-```
-
-## Test Utilities
-
-### Full Test Suite
-```javascript
-async function testSDK() {
-  const email = `test-${Date.now()}@example.com`;
-  
-  // Test auth
-  console.log('Testing auth...');
-  const { error: signUpError } = await client.auth.signUp({ email, password: 'test123' });
-  if (signUpError) return console.error('SignUp failed:', signUpError);
-  
-  // Test current user
-  const { data: user, error: userError } = await client.auth.getCurrentUser();
-  if (userError) return console.error('GetUser failed:', userError);
-  console.log('✅ Auth working, user:', user.user.id);
-  
-  // Test database
-  console.log('Testing database...');
-  const { data: posts, error: dbError } = await client.database.from('posts').select().limit(1);
-  if (dbError) return console.error('Database failed:', dbError);
-  console.log('✅ Database working, posts:', posts.length);
-  
-  // Test insert
-  const { error: insertError } = await client.database
-    .from('posts')
-    .insert({ title: 'Test', user_id: user.user.id })
-    .select();
-  if (insertError) return console.error('Insert failed:', insertError);
-  console.log('✅ Insert working');
-}
-
-testSDK().catch(console.error);
-```
-
-## Backend Verification
-
-```javascript
-// Check backend is running
-fetch('http://localhost:7130/api/health')
-  .then(r => r.json())
-  .then(d => console.log('Backend:', d))
-  .catch(e => console.error('Backend not running'));
+# InsForge Debug SDK
+
+## Common SDK Errors
+
+### Auth Errors
+```javascript
+// Token not stored
+{ code: 'MISSING_AUTHORIZATION_HEADER' }
+// Fix: User needs to login
+
+// Token expired
+{ code: 'INVALID_TOKEN' }
+// Fix: client.auth.signInWithPassword()
+
+// Invalid credentials
+{ code: 'INVALID_CREDENTIALS' }
+// Fix: Check email/password
+```
+
+### Database Errors
+```javascript
+// Table doesn't exist
+{ statusCode: 404, message: 'Table not found' }
+// Fix: Use MCP tool to create table
+
+// Missing required field
+{ code: '23502', message: 'null value in column "user_id"' }
+// Fix: Include all required fields
+
+// Foreign key violation
+{ code: '23503', message: 'violates foreign key constraint' }
+// Fix: Referenced record must exist
+
+// Permission denied
+{ code: '42501', message: 'permission denied for table' }
+// Fix: User must be authenticated
+```
+
+## Debug Techniques
+
+### 1. Check Authentication
+```javascript
+const { data, error } = await client.auth.getCurrentUser();
+if (error) {
+  console.log('Not authenticated:', error.message);
+  // Need to login first
+}
+```
+
+### 2. Verify Token Storage
+```javascript
+const { data } = await client.auth.getCurrentSession();
+console.log('Stored token:', data?.session?.accessToken ? 'Present' : 'Missing');
+```
+
+### 3. Test Database Connection
+```javascript
+// Simple query to test connection
+const { error } = await client.database.from('users').select().limit(1);
+if (error) {
+  console.log('Database issue:', error);
+}
+```
+
+### 4. Enable Network Inspection
+```javascript
+// Browser: Open DevTools > Network tab
+// Check request headers for Authorization: Bearer token
+// Check response for error details
+```
+
+### 5. Test With Raw HTTP
+```javascript
+// When SDK fails, test endpoint directly
+const response = await fetch('http://localhost:7130/api/database/records/posts', {
+  headers: {
+    'Authorization': 'Bearer ' + token
+  }
+});
+const data = await response.json();
+console.log('Raw response:', data);
+```
+
+## Common Issues
+
+### Empty Response
+```javascript
+// INSERT/UPDATE/DELETE return empty without Prefer header
+// SDK handles this automatically, but check if using raw API
+```
+
+### Array Format
+```javascript
+// POST requires array
+// ❌ Wrong: { title: 'Test' }
+// ✅ Right: [{ title: 'Test' }]
+// SDK handles this automatically
+```
+
+### Token Not Persisting
+```javascript
+// Check storage adapter
+const client = createClient({
+  baseUrl: 'http://localhost:7130',
+});
+```
+
+### CORS Issues
+```javascript
+// Backend allows all origins by default
+// If modified, check backend CORS settings
+```
+
+## Test Utilities
+
+### Full Test Suite
+```javascript
+async function testSDK() {
+  const email = `test-${Date.now()}@example.com`;
+  
+  // Test auth
+  console.log('Testing auth...');
+  const { error: signUpError } = await client.auth.signUp({ email, password: 'test123' });
+  if (signUpError) return console.error('SignUp failed:', signUpError);
+  
+  // Test current user
+  const { data: user, error: userError } = await client.auth.getCurrentUser();
+  if (userError) return console.error('GetUser failed:', userError);
+  console.log('✅ Auth working, user:', user.user.id);
+  
+  // Test database
+  console.log('Testing database...');
+  const { data: posts, error: dbError } = await client.database.from('posts').select().limit(1);
+  if (dbError) return console.error('Database failed:', dbError);
+  console.log('✅ Database working, posts:', posts.length);
+  
+  // Test insert
+  const { error: insertError } = await client.database
+    .from('posts')
+    .insert({ title: 'Test', user_id: user.user.id })
+    .select();
+  if (insertError) return console.error('Insert failed:', insertError);
+  console.log('✅ Insert working');
+}
+
+testSDK().catch(console.error);
+```
+
+## Backend Verification
+
+```javascript
+// Check backend is running
+fetch('http://localhost:7130/api/health')
+  .then(r => r.json())
+  .then(d => console.log('Backend:', d))
+  .catch(e => console.error('Backend not running'));
 ```