first commit

COMMANDS.md

@@ -0,0 +1,491 @@
+# Commands Cheatsheet
+
+Quick reference for common commands when working with TurboTrades backend.
+
+## 📦 Installation & Setup
+
+```bash
+# Install dependencies
+npm install
+
+# Copy environment variables
+cp .env.example .env
+
+# Edit environment variables
+# Windows: notepad .env
+# Mac/Linux: nano .env
+```
+
+## 🚀 Running the Server
+
+```bash
+# Development mode (auto-reload on file changes)
+npm run dev
+
+# Production mode
+npm start
+
+# With Node.js built-in watch mode
+node --watch index.js
+```
+
+## 🗄️ MongoDB Commands
+
+```bash
+# Start MongoDB (Windows)
+mongod
+
+# Start MongoDB (Mac with Homebrew)
+brew services start mongodb-community
+
+# Start MongoDB (Linux systemd)
+sudo systemctl start mongod
+
+# Connect to MongoDB shell
+mongosh
+
+# Show databases
+show dbs
+
+# Use TurboTrades database
+use turbotrades
+
+# Show collections
+show collections
+
+# Find all users
+db.users.find().pretty()
+
+# Count users
+db.users.countDocuments()
+
+# Find user by Steam ID
+db.users.findOne({ steamId: "76561198012345678" })
+
+# Update user balance
+db.users.updateOne(
+  { steamId: "76561198012345678" },
+  { $set: { balance: 100 } }
+)
+
+# Delete all users (be careful!)
+db.users.deleteMany({})
+
+# Create index on steamId
+db.users.createIndex({ steamId: 1 }, { unique: true })
+
+# Show all indexes
+db.users.getIndexes()
+```
+
+## 🔧 NPM Commands
+
+```bash
+# Install new package
+npm install package-name
+
+# Install as dev dependency
+npm install -D package-name
+
+# Uninstall package
+npm uninstall package-name
+
+# Update all packages
+npm update
+
+# Check for outdated packages
+npm outdated
+
+# Audit security vulnerabilities
+npm audit
+
+# Fix vulnerabilities (if possible)
+npm audit fix
+
+# Clean install (delete node_modules and reinstall)
+rm -rf node_modules package-lock.json
+npm install
+```
+
+## 🧪 Testing Commands
+
+```bash
+# Test API health
+curl http://localhost:3000/health
+
+# Test with formatted JSON (requires jq)
+curl http://localhost:3000/health | jq
+
+# Test Steam login (opens browser)
+curl http://localhost:3000/auth/steam
+
+# Test authenticated endpoint (replace TOKEN)
+curl http://localhost:3000/auth/me \
+  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
+
+# Test with cookies
+curl http://localhost:3000/auth/me \
+  -H "Cookie: accessToken=YOUR_TOKEN"
+
+# Test POST request
+curl -X POST http://localhost:3000/auth/logout \
+  -H "Cookie: accessToken=YOUR_TOKEN"
+
+# Test PATCH request
+curl -X PATCH http://localhost:3000/user/trade-url \
+  -H "Content-Type: application/json" \
+  -H "Cookie: accessToken=YOUR_TOKEN" \
+  -d '{"tradeUrl":"https://steamcommunity.com/tradeoffer/new/?partner=123&token=ABC"}'
+```
+
+## 🔌 WebSocket Testing
+
+```bash
+# Install wscat globally
+npm install -g wscat
+
+# Connect to WebSocket
+wscat -c ws://localhost:3000/ws
+
+# Connect with token
+wscat -c "ws://localhost:3000/ws?token=YOUR_ACCESS_TOKEN"
+
+# Send ping (after connecting)
+{"type":"ping"}
+
+# Send custom message
+{"type":"custom","data":{"message":"hello"}}
+
+# Disconnect
+Ctrl+C
+```
+
+## 🐳 Docker Commands (Future)
+
+```bash
+# Build Docker image
+docker build -t turbotrades .
+
+# Run container
+docker run -d -p 3000:3000 --env-file .env turbotrades
+
+# Run with MongoDB
+docker-compose up -d
+
+# Stop containers
+docker-compose down
+
+# View logs
+docker logs turbotrades
+
+# Shell into container
+docker exec -it turbotrades sh
+
+# Remove container
+docker rm -f turbotrades
+
+# Remove image
+docker rmi turbotrades
+```
+
+## 📊 PM2 Process Manager
+
+```bash
+# Install PM2 globally
+npm install -g pm2
+
+# Start application
+pm2 start index.js --name turbotrades
+
+# Start with environment
+pm2 start index.js --name turbotrades --env production
+
+# List processes
+pm2 list
+
+# Monitor processes
+pm2 monit
+
+# View logs
+pm2 logs turbotrades
+
+# View specific log lines
+pm2 logs turbotrades --lines 100
+
+# Restart application
+pm2 restart turbotrades
+
+# Stop application
+pm2 stop turbotrades
+
+# Delete from PM2
+pm2 delete turbotrades
+
+# Save process list
+pm2 save
+
+# Setup auto-start on boot
+pm2 startup
+
+# Update PM2
+npm install -g pm2@latest
+pm2 update
+```
+
+## 🔑 Generate Secrets
+
+```bash
+# Generate random secret (Node.js)
+node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
+
+# Generate multiple secrets
+node -e "for(let i=0;i<3;i++) console.log(require('crypto').randomBytes(32).toString('hex'))"
+
+# Generate base64 secret
+node -e "console.log(require('crypto').randomBytes(32).toString('base64'))"
+
+# On Linux/Mac with OpenSSL
+openssl rand -hex 32
+openssl rand -base64 32
+```
+
+## 🔍 Debugging
+
+```bash
+# Run with Node.js debugger
+node --inspect index.js
+
+# Run with Chrome DevTools
+node --inspect-brk index.js
+# Then open chrome://inspect in Chrome
+
+# View all environment variables
+node -e "console.log(process.env)"
+
+# Check Node.js version
+node --version
+
+# Check npm version
+npm --version
+
+# Check MongoDB version
+mongod --version
+
+# View process on port
+# Windows
+netstat -ano | findstr :3000
+
+# Mac/Linux
+lsof -i :3000
+
+# Kill process on port
+# Windows
+taskkill /PID <PID> /F
+
+# Mac/Linux
+kill -9 <PID>
+```
+
+## 📝 Git Commands
+
+```bash
+# Initialize git (if not already)
+git init
+
+# Check status
+git status
+
+# Add all files
+git add .
+
+# Commit changes
+git commit -m "Your commit message"
+
+# Create new branch
+git checkout -b feature/new-feature
+
+# Switch branches
+git checkout main
+
+# Push to remote
+git push origin main
+
+# Pull latest changes
+git pull origin main
+
+# View commit history
+git log --oneline
+
+# Undo last commit (keep changes)
+git reset --soft HEAD~1
+
+# Stash changes
+git stash
+
+# Apply stashed changes
+git stash pop
+```
+
+## 🧹 Cleanup Commands
+
+```bash
+# Clear npm cache
+npm cache clean --force
+
+# Remove node_modules
+# Windows
+rmdir /s /q node_modules
+
+# Mac/Linux
+rm -rf node_modules
+
+# Clear MongoDB database
+mongosh turbotrades --eval "db.dropDatabase()"
+
+# Clear PM2 logs
+pm2 flush
+
+# Clear all PM2 processes
+pm2 kill
+```
+
+## 📈 Performance & Monitoring
+
+```bash
+# Check memory usage
+node -e "console.log(process.memoryUsage())"
+
+# Monitor CPU and memory (requires htop)
+htop
+
+# Node.js performance profiling
+node --prof index.js
+
+# Generate and view flamegraph
+node --prof index.js
+node --prof-process isolate-*.log > processed.txt
+
+# Check MongoDB performance
+mongosh --eval "db.currentOp()"
+
+# MongoDB stats
+mongosh turbotrades --eval "db.stats()"
+```
+
+## 🌐 Network Commands
+
+```bash
+# Check if port is open
+# Windows
+netstat -an | findstr :3000
+
+# Mac/Linux
+nc -zv localhost 3000
+
+# Test WebSocket connection
+curl -i -N -H "Connection: Upgrade" \
+  -H "Upgrade: websocket" \
+  -H "Sec-WebSocket-Version: 13" \
+  -H "Sec-WebSocket-Key: test" \
+  http://localhost:3000/ws
+
+# Check DNS resolution
+nslookup yourdomain.com
+
+# Trace route
+traceroute yourdomain.com  # Mac/Linux
+tracert yourdomain.com     # Windows
+```
+
+## 🔐 SSL/TLS (Production)
+
+```bash
+# Generate self-signed certificate (development)
+openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -nodes
+
+# Generate Let's Encrypt certificate (production)
+sudo certbot certonly --standalone -d yourdomain.com
+
+# Renew Let's Encrypt certificate
+sudo certbot renew
+
+# Check certificate expiry
+openssl x509 -in cert.pem -text -noout
+```
+
+## 💡 Useful One-Liners
+
+```bash
+# Count lines of code
+find . -name "*.js" -not -path "./node_modules/*" | xargs wc -l
+
+# Find all TODO comments
+grep -r "TODO" --exclude-dir=node_modules .
+
+# Find large files
+find . -type f -size +1M
+
+# Backup database
+mongodump --db turbotrades --out ./backup
+
+# Restore database
+mongorestore --db turbotrades ./backup/turbotrades
+
+# Watch files for changes
+watch -n 1 "ls -lh ."
+
+# Continuous ping test
+ping -c 10 yourdomain.com
+
+# Get public IP
+curl ifconfig.me
+```
+
+## 🎯 Quick Troubleshooting
+
+```bash
+# Server won't start - check if port is in use
+lsof -i :3000  # Mac/Linux
+netstat -ano | findstr :3000  # Windows
+
+# MongoDB won't connect - check if running
+mongosh --eval "db.version()"
+
+# Permission denied - fix with chmod
+chmod +x index.js
+
+# EACCES error - don't use sudo, fix npm permissions
+mkdir ~/.npm-global
+npm config set prefix '~/.npm-global'
+export PATH=~/.npm-global/bin:$PATH
+
+# Module not found - reinstall dependencies
+rm -rf node_modules package-lock.json
+npm install
+
+# Old cached data - clear cache
+npm cache clean --force
+rm -rf node_modules package-lock.json
+npm install
+```
+
+## 📚 Documentation Links
+
+- Fastify: https://www.fastify.io/docs/latest/
+- MongoDB: https://www.mongodb.com/docs/
+- Mongoose: https://mongoosejs.com/docs/
+- Steam API: https://developer.valvesoftware.com/wiki/Steam_Web_API
+- JWT: https://jwt.io/
+- WebSocket: https://developer.mozilla.org/en-US/docs/Web/API/WebSocket
+
+---
+
+**Pro Tip**: Add commonly used commands to shell aliases!
+
+```bash
+# Add to ~/.bashrc or ~/.zshrc
+alias dev="npm run dev"
+alias start-mongo="brew services start mongodb-community"
+alias stop-mongo="brew services stop mongodb-community"
+alias logs="pm2 logs turbotrades"
+```