🔄 Database Auto-Migration:
- Add automatic schema update in user preferences API
- Ensures ocr_settings column exists when first accessed
- Uses ADD COLUMN IF NOT EXISTS for safe migration
- Handles case where column might already exist
- No need for separate migration endpoint
This ensures the settings page will work immediately after deployment
without requiring manual database updates.
🔧 Vercel Function Limit Fix:
- Remove unnecessary API functions to get under 12 function limit
- Delete api/simple.js (test function)
- Delete api/migrate.ts (old migration)
- Delete api/admin/promote-user.js (one-time function)
- Delete api/admin/update-preferences-schema.js (migration)
- Delete api/v1/ directory (old API versions)
- Now at 8 functions (well under 12 limit)
🚨 ESLint Warning Fixes:
- Fix unnecessary escape characters in regex patterns
- Replace [:\-] with [:−] in aiOcr.ts regex patterns
✅ Build should now succeed on Vercel Hobby plan
🏗️ User Settings System:
- Create comprehensive Settings page with tabbed interface
- Move OCR configuration from modal to dedicated settings tab
- Add API endpoints for user preferences (GET/PUT)
- Store settings in database user_preferences table with ocr_settings column
- Add Settings link to navbar user dropdown
⚙️ Settings Features:
- General tab: default view, items per page, theme, animations
- AI OCR tab: service selection, API keys, confidence threshold
- Privacy tab: public collections/decks defaults
- Real-time API key testing for OpenAI and Ollama
- Persistent storage in database instead of localStorage
🔄 Integration:
- Remove old OCRSettings modal from Scanner page
- Add Settings route to App.tsx routing
- Update navbar with Settings link in user dropdown
- Prepare for AI OCR service to read from user preferences
Next: Update AI OCR service to use saved user preferences instead of localStorage
🔧 Build Fixes:
- Update Node.js version from 18.x to 22.x (required by Vercel)
- Remove debug endpoints to get under 12 function limit for Hobby plan
- Downgrade React from 19.x to 18.x for better compatibility
- Update react-router-dom to v6.28.0 (compatible with Node 22)
- Update TypeScript to v5.7.3
- Update React types to match React version
Functions count: 12/12 (at limit for Hobby plan)
Core API endpoints:
✅ auth/login.js, auth/register.js
✅ collections/index.js, collections/add-card.js
✅ cards/find-or-create.js
✅ admin/users.js, admin/promote-user.js
✅ setup-auth.js, simple.js
✅ Legacy: migrate.ts, v1/cards/[id].ts, v1/cards/index.ts
🔧 Local Development Debugging:
- Add api/test-db-local.js for database connection testing
- Helps diagnose local environment issues
- Tests table existence and user data
Note: Local Vercel dev having database connection issues
Consider testing on production environment instead
🔧 Convert TypeScript to JavaScript:
- Replace api/admin/users.ts with api/admin/users.js
- Use req, res pattern instead of NextRequest/NextResponse
- Fix req.headers.get() -> req.headers.authorization
- Use url.parse() for query parameters
- Support GET (list users), PUT (update), DELETE (deactivate)
- Proper admin authentication and error handling
Resolves: req.headers.get is not a function error
🔧 Fix:
- Use req.body directly instead of req.text() + JSON.parse()
- Match pattern used in working auth endpoints
- Should resolve NOT_FOUND and parsing issues
🔧 Admin Management:
- Add api/admin/promote-user.js endpoint
- Allows promoting users to admin role by username or userId
- Checks for existing admin status
- Returns updated user info with roles
- Handles database errors gracefully
Usage: POST /api/admin/promote-user with { username: 'testuser' }
🔧 Build Fix:
- Remove .ts versions of API files that conflict with .js versions
- Keep only working JavaScript API endpoints:
- api/auth/login.js
- api/auth/register.js
- api/setup-auth.js
- api/simple.js
- api/debug.js
This resolves the Vercel build error about conflicting file paths.
�� Debug Information:
- New /api/debug endpoint with detailed environment info
- Check for DATABASE_URL and JWT_SECRET presence
- Show environment variable keys related to database
- Force fresh deployment with new endpoint name
This will help identify if environment variables are properly configured in Vercel.
🔧 API Format Fix:
- Convert register.ts to register.js using req/res pattern
- Convert login.ts to login.js using req/res pattern
- Convert setup-auth.ts to setup-auth.js using req/res pattern
- Use CommonJS require() instead of ES6 imports
- Use traditional Vercel function signature that works
✅ Working Format:
- export default async function handler(req, res)
- req.body for request data (auto-parsed by Vercel)
- res.status().json() for responses
- CommonJS modules with require()
This should resolve all timeout issues and make authentication work properly.
🔧 API Route Format:
- Add /api/simple.js using standard Vercel function format
- Add /api/hello.ts using proper Next.js API route format
- Install Next.js and types for proper API route support
🧪 Testing Multiple Formats:
- JavaScript endpoint: /api/simple.js
- TypeScript endpoint: /api/hello.ts
- Both use traditional req/res pattern instead of NextRequest/NextResponse
This should help identify the correct API format for Vercel functions.
🔧 Configuration Changes:
- Remove specific runtime version from vercel.json
- Remove buildCommand that might be causing conflicts
- Let Vercel use default Node.js runtime settings
🧪 Simple Test Endpoint:
- Add /api/simple with minimal dependencies
- Use traditional Vercel function signature (req, res)
- No imports or complex operations to isolate the issue
This should help identify if the problem is with our function configuration, imports, or Vercel setup.
🔧 Improvements:
- Add /api/health endpoint for basic API functionality testing
- Improve /api/test-db with timeout handling and better error reporting
- Add environment variable checks before database operations
- Add connection timeouts to prevent function timeouts
- Better error handling and logging
🧪 Testing Endpoints:
- /api/health - Simple API health check (no DB required)
- /api/test-db - Database connectivity test with timeout protection
These changes should help identify whether the issue is with API routing, environment variables, or database connectivity.
🔧 Debugging Improvements:
- Optimize setup-auth endpoint to avoid timeouts
- Add table existence checks before operations
- Simplify permission system for faster setup
- Add environment variable validation
- Create test-db endpoint for connection debugging
🚀 Performance Optimizations:
- Break down large SQL queries into smaller chunks
- Add early returns for already-setup scenarios
- Reduce permission complexity during initial setup
- Better error messages for troubleshooting
🧪 New Debug Endpoints:
- /api/test-db - Test database connectivity
- /api/setup-auth - Optimized schema setup
These changes should resolve timeout issues and provide better debugging information for authentication problems.
🐛 Bug Fix:
- Replace req.json() with req.text() + JSON.parse() for Vercel compatibility
- Add proper error handling for malformed JSON requests
- Fix authentication endpoints (login/register) body parsing
- Fix admin users endpoint body parsing
🔧 Technical Details:
- Vercel functions don't support req.json() method directly
- Use req.text() to get raw body content then parse manually
- Add try/catch blocks for JSON parsing errors
- Maintain same API interface and error responses
✅ Endpoints Fixed:
- /api/auth/register - User registration
- /api/auth/login - User authentication
- /api/admin/users - Admin user management
This resolves the 'req.json is not a function' error in production.
✨ Features Added:
- User registration and login with JWT authentication
- Role-based access control (user/admin)
- Comprehensive admin panel with user management
- Password hashing with bcrypt
- Session management and token storage
- Protected routes and public routes
- Modern login/register forms with validation
🗄️ Database Schema:
- Users table with profile information
- Roles and permissions system
- User-role junction tables
- Session management tables
- Database triggers and indexes
🎨 UI/UX Improvements:
- Updated navigation with user menu
- Admin badge and access controls
- Responsive authentication forms
- Loading states and error handling
- Role-based UI elements
🔧 API Endpoints:
- /api/auth/login - User authentication
- /api/auth/register - User registration
- /api/admin/users - User management (admin only)
- /api/setup-auth - Database schema setup
🚀 Admin Panel Features:
- User listing with search and pagination
- Role assignment (user/admin)
- User activation/deactivation
- System dashboard with stats
- Card management placeholder
- Real-time user management
- Change JSON import to use require() to avoid module loading issues
- Add api/tsconfig.json with CommonJS module configuration
- Update Vercel Node.js runtime to @vercel/node@3.2.0
- Add buildCommand to vercel.json for proper compilation
- Fix 'Cannot use import statement outside a module' error
- Switch from @neondatabase/serverless to standard 'pg' client for Node.js 18 support
- Update Node.js version to 18.x as required by Vercel
- Replace Neon template literals with standard parameterized queries
- Add proper connection pooling and SSL configuration for production
- All API endpoints updated: /api/v1/cards/, /api/v1/cards/[id], /api/migrate
- Build tested and working successfully
- Update Node.js version from 18.x to 22.x for Neon compatibility
- Fix TypeScript errors by properly typing error objects as Error
- Resolve engine compatibility issues with @neondatabase/serverless and react-router
- Add proper error type casting in all API endpoints
- Fix FUNCTION_INVOCATION_FAILED crashes
- Add /api/migrate endpoint to populate Neon database with existing JSON data
- Update /api/v1/cards/ to query Neon database instead of JSON file
- Update /api/v1/cards/[id] to fetch single cards from Neon
- Add proper error handling and development debugging
- Maintain backward compatibility with existing API interface
- Ready to migrate card data to PostgreSQL
