@goscribe/server 1.0.9 → 1.0.10

package/DATABASE_SETUP.md

@@ -0,0 +1,165 @@
+# 🗄️ Database Setup Guide
+
+## 📋 Overview
+This guide covers the database configuration for the Scribe server, including Prisma setup, environment variables, and troubleshooting common connection issues.
+
+---
+
+## 🔧 Environment Variables Required
+
+### Core Database Configuration
+```bash
+# Pooled connection (for runtime queries)
+DATABASE_URL="postgresql://<db_user>:<db_password>@aws-1-ap-southeast-1.pooler.supabase.com:5432/postgres?sslmode=require"
+
+# Direct connection (for migrations and schema operations)
+DIRECT_URL="postgresql://<db_user>:<db_password>@db.<project-ref>.supabase.co:5432/postgres?sslmode=require"
+```
+
+### 🔍 Where to Find These Values
+1. Go to your Supabase project dashboard
+2. Navigate to **Settings** → **Database**
+3. Copy the connection strings from:
+   - **Connection pooling** → `DATABASE_URL`
+   - **Direct connection** → `DIRECT_URL`
+
+---
+
+## 🚀 Quick Setup Steps
+
+### 1. Set Environment Variables
+```bash
+# Option A: Export for current session
+export DATABASE_URL="your_pooled_connection_string"
+export DIRECT_URL="your_direct_connection_string"
+
+# Option B: Add to .env file
+echo "DATABASE_URL=your_pooled_connection_string" >> .env
+echo "DIRECT_URL=your_direct_connection_string" >> .env
+```
+
+### 2. Generate Prisma Client
+```bash
+npm run build
+```
+
+### 3. Run Migrations (if needed)
+```bash
+npx prisma migrate deploy
+```
+
+### 4. Seed Database (optional)
+```bash
+npm run seed
+```
+
+---
+
+## 🏗️ Database Schema Overview
+
+### Core Models
+- **User** - Authentication and user management
+- **Workspace** - Project containers with folders
+- **Channel** - Chat channels within workspaces
+- **Chat** - Individual chat messages
+- **Artifact** - AI-generated content (study guides, flashcards, etc.)
+- **FileAsset** - User uploads and attachments
+
+### Key Relationships
+```
+User → Workspaces → Channels → Chats
+User → Artifacts → Versions/Questions/Flashcards
+Workspace → FileAssets
+```
+
+---
+
+## 🐛 Troubleshooting
+
+### ❌ "Tenant or user not found" Error
+
+**Cause:** Incorrect database credentials or connection string format
+
+**Solutions:**
+1. **Verify credentials** in Supabase dashboard
+2. **Check connection string format:**
+   ```bash
+   # ✅ Correct format
+   postgresql://user:password@host:port/database?sslmode=require
+   
+   # ❌ Common mistakes
+   postgresql://user:password@host:port/database  # Missing sslmode
+   postgresql://user:password@host:port          # Missing database name
+   ```
+
+3. **Ensure proper URL encoding** for special characters in passwords
+4. **Use direct connection** for migrations (not pooled)
+
+### ❌ Migration Failures
+
+**Cause:** Using pooled connection for schema operations
+
+**Solution:** Always use `DIRECT_URL` for migrations
+```bash
+# ✅ Correct
+DIRECT_URL="postgresql://user:pass@db.project.supabase.co:5432/postgres?sslmode=require"
+
+# ❌ Wrong
+DIRECT_URL="postgresql://user:pass@aws-1-ap-southeast-1.pooler.supabase.com:5432/postgres?sslmode=require"
+```
+
+### ❌ Connection Timeouts
+
+**Solutions:**
+1. Check Supabase project status
+2. Verify network connectivity
+3. Ensure SSL mode is set to `require`
+4. Check if IP is whitelisted (if using IP restrictions)
+
+---
+
+## 📊 Database Operations
+
+### Available Scripts
+```bash
+# Development
+npm run dev          # Start development server
+
+# Database
+npm run build        # Generate Prisma client + build
+npm run seed         # Populate with sample data
+npx prisma studio    # Open database browser
+npx prisma migrate dev    # Create and apply migrations
+npx prisma migrate deploy # Apply existing migrations
+```
+
+### Sample Data
+The seed script creates:
+- Demo user (`demo@example.com`)
+- Sample workspace with artifacts
+- Worksheet with mixed question types
+- Flashcard set
+- Study guide with versions
+
+---
+
+## 🔐 Security Notes
+
+- **Never commit** `.env` files to version control
+- **Use environment-specific** connection strings
+- **Enable SSL** (`sslmode=require`) for all connections
+- **Rotate credentials** regularly
+- **Use connection pooling** for production workloads
+
+---
+
+## 📚 Additional Resources
+
+- [Prisma Documentation](https://www.prisma.io/docs)
+- [Supabase Database Guide](https://supabase.com/docs/guides/database)
+- [PostgreSQL Connection Strings](https://www.postgresql.org/docs/current/libpq-connect.html)
+
+---
+
+*Last updated: $(date)*
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goscribe/server",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/lib/ai-session.ts

@@ -1,8 +1,8 @@
 import { TRPCError } from '@trpc/server';
 
 // External AI service configuration
-const AI_SERVICE_URL = 'https://hwln4560erf7pr-61016.proxy.runpod.net/upload';
-const AI_RESPONSE_URL = 'https://hwln4560erf7pr-61016.proxy.runpod.net/last_response';
+const AI_SERVICE_URL = 'https://7gzvf7uib04yp9-61016.proxy.runpod.net/upload';
+const AI_RESPONSE_URL = 'https://7gzvf7uib04yp9-61016.proxy.runpod.net/last_response';
 
 export interface AISession {
   id: string;
@@ -18,12 +18,13 @@ export class AISessionService {
   private sessions = new Map<string, AISession>();
 
   // Initialize a new AI session
-  async initSession(workspaceId: string): Promise<AISession> {
+  async initSession(workspaceId: string, user: string): Promise<AISession> {
     const sessionId = `${workspaceId}`;
     
     const formData = new FormData();
     formData.append('command', 'init_session');
-    formData.append('id', sessionId);
+    formData.append('session', sessionId);
+    formData.append('user', user);
 
     // Retry logic for AI service
     const maxRetries = 3;

package/src/routers/flashcards.ts

@@ -170,7 +170,7 @@ export const flashcards = router({
       The user has also left you this prompt: ${input.prompt}
       `
       // Init AI session and seed with prompt as instruction
-      const session = await aiSessionService.initSession(input.workspaceId);
+      const session = await aiSessionService.initSession(input.workspaceId, ctx.session.user.id);
       await aiSessionService.setInstruction(session.id, partialPrompt);
 
       await aiSessionService.startLLMSession(session.id);

package/src/routers/worksheets.ts

@@ -402,7 +402,7 @@ export const worksheets = router({
 
       await PusherService.emitTaskComplete(input.workspaceId, 'worksheet_load_start', { source: 'prompt' });
 
-      const session = await aiSessionService.initSession(input.workspaceId);
+      const session = await aiSessionService.initSession(input.workspaceId, ctx.session.user.id);
       await aiSessionService.setInstruction(session.id, `Create a worksheet with ${input.numQuestions} questions at ${input.difficulty} difficulty from this prompt. Return JSON.\n\nPrompt:\n${input.prompt}`);
       await aiSessionService.startLLMSession(session.id);
 

package/src/routers/workspace.ts

@@ -376,7 +376,7 @@ export const workspace = router({
 
       // Initialize AI session
       console.log('🤖 Initializing AI session...');
-      const session = await aiSessionService.initSession(input.workspaceId);
+      const session = await aiSessionService.initSession(input.workspaceId, ctx.session.user.id);
       console.log('✅ AI session initialized', { sessionId: session.id });
       
       const fileObj = new File([fileBuffer], input.file.filename, { type: input.file.contentType });