@studious-lms/server 1.2.45 → 1.2.46

package/dist/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sources":["utils/logger.ts"],"sourceRoot":"/","sourcesContent":["export enum LogLevel {\n  INFO = 'info',\n  WARN = 'warn',\n  ERROR = 'error',\n  DEBUG = 'debug'\n}\n\ntype LogMode = 'silent' | 'minimal' | 'normal' | 'verbose';\n\ninterface LogMessage {\n  level: LogLevel;\n  message: string;\n  timestamp: string;\n  context?: Record<string, any>;\n}\n\n// ANSI color codes\nconst colors = {\n  reset: '\\x1b[0m',\n  bright: '\\x1b[1m',\n  dim: '\\x1b[2m',\n  red: '\\x1b[31m',\n  green: '\\x1b[32m',\n  yellow: '\\x1b[33m',\n  blue: '\\x1b[34m',\n  magenta: '\\x1b[35m',\n  cyan: '\\x1b[36m',\n  white: '\\x1b[37m',\n  gray: '\\x1b[90m',\n  // Background colors\n  bgRed: '\\x1b[41m',\n  bgGreen: '\\x1b[42m',\n  bgYellow: '\\x1b[43m',\n  bgBlue: '\\x1b[44m',\n  bgMagenta: '\\x1b[45m',\n  bgCyan: '\\x1b[46m',\n  bgWhite: '\\x1b[47m',\n  bgGray: '\\x1b[100m',\n  // Bright background colors\n  bgBrightRed: '\\x1b[101m',\n  bgBrightGreen: '\\x1b[102m',\n  bgBrightYellow: '\\x1b[103m',\n  bgBrightBlue: '\\x1b[104m',\n  bgBrightMagenta: '\\x1b[105m',\n  bgBrightCyan: '\\x1b[106m',\n  bgBrightWhite: '\\x1b[107m'\n};\n\nclass Logger {\n  private static instance: Logger;\n  private isDevelopment: boolean;\n  private mode: LogMode;\n  private levelColors: Record<LogLevel, string>;\n  private levelBgColors: Record<LogLevel, string>;\n  private levelEmojis: Record<LogLevel, string>;\n\n  private constructor() {\n\n    // this.isDevelopment = process.env.NODE_ENV === 'development';\n    this.isDevelopment = true;\n\n    this.mode = (process.env.LOG_MODE as LogMode) || 'normal';\n    \n\n    this.levelColors = {\n      [LogLevel.INFO]: colors.blue,\n      [LogLevel.WARN]: colors.yellow,\n      [LogLevel.ERROR]: colors.red,\n      [LogLevel.DEBUG]: colors.magenta\n    };\n\n    this.levelBgColors = {\n      [LogLevel.INFO]: colors.bgBlue,\n      [LogLevel.WARN]: colors.bgYellow,\n      [LogLevel.ERROR]: colors.bgRed,\n      [LogLevel.DEBUG]: colors.bgMagenta\n    };\n\n    this.levelEmojis = {\n      [LogLevel.INFO]: 'ℹ️',\n      [LogLevel.WARN]: '⚠️',\n      [LogLevel.ERROR]: '❌',\n      [LogLevel.DEBUG]: '🔍'\n    };\n  }\n\n  public static getInstance(): Logger {\n    if (!Logger.instance) {\n      Logger.instance = new Logger();\n    }\n    return Logger.instance;\n  }\n\n  public setMode(mode: LogMode) {\n    this.mode = mode;\n  }\n\n  private shouldLog(level: LogLevel): boolean {\n    const silent = [\n      LogLevel.ERROR,\n    ];\n\n    const minimal = [\n      LogLevel.ERROR,\n      LogLevel.WARN,\n    ];\n\n    const normal = [\n      LogLevel.ERROR,\n      LogLevel.WARN,\n      LogLevel.INFO,\n    ];\n\n    if (this.mode === 'silent') return silent.includes(level);\n    if (this.mode === 'minimal') return minimal.includes(level);\n    if (this.mode === 'normal') return normal.includes(level);\n    return true; // verbose mode\n  }\n\n  private formatMessage(logMessage: LogMessage): string {\n    const { level, message, timestamp, context } = logMessage;\n    const color = this.levelColors[level];\n    const bgColor = this.levelBgColors[level];\n    const emoji = this.levelEmojis[level];\n    \n    const timestampStr = colors.gray + `[${timestamp}]` + colors.reset;\n    // Use background color for level badge like Vitest\n    const levelStr = colors.white + bgColor + ` ${level.toUpperCase()} ` + colors.reset;\n    const emojiStr = emoji + ' ';\n    const messageStr = colors.bright + message + colors.reset;\n    \n    const contextStr = context \n      ? '\\n' + colors.dim + 'Context: ' + JSON.stringify(context, null, 2) + colors.reset\n      : '';\n\n    return `${timestampStr} ${levelStr} ${emojiStr}${messageStr}${contextStr}`;\n  }\n\n  private log(level: LogLevel, message: string, context?: Record<string, any>) {\n    if (!this.shouldLog(level)) \n      return;    \n\n    if (level == LogLevel.WARN || level == LogLevel.ERROR) {\n      if (level == LogLevel.ERROR) {\n        // alert me\n      }\n      // store in database\n    }\n    \n    const logMessage: LogMessage = {\n      level,\n      message,\n      timestamp: new Date().toISOString(),\n      context\n    };\n\n    const formattedMessage = this.formatMessage(logMessage);\n\n    switch (level) {\n      case LogLevel.ERROR:\n        console.error(formattedMessage);\n        break;\n      case LogLevel.WARN:\n        console.warn(formattedMessage);\n        break;\n      case LogLevel.DEBUG:\n        if (this.isDevelopment) {\n          console.debug(formattedMessage);\n        }\n        break;\n      default:\n        console.log(formattedMessage);\n    }\n  }\n\n  public info(message: string, context?: Record<string, any>) {\n    this.log(LogLevel.INFO, message, context);\n  }\n\n  public warn(message: string, context?: Record<string, any>) {\n    this.log(LogLevel.WARN, message, context);\n  }\n\n  public error(message: string, context?: Record<string, any>) {\n    this.log(LogLevel.ERROR, message, context);\n  }\n\n  public debug(message: string, context?: Record<string, any>) {\n    this.log(LogLevel.DEBUG, message, context);\n  }\n}\n\nexport const logger = Logger.getInstance(); "],"names":[],"mappings":"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","debug_id":"efbd088e-b76f-5ea3-8654-16c301d16dcd"}
+{"version":3,"file":"logger.js","sources":["utils/logger.ts"],"sourceRoot":"/","sourcesContent":["\nexport enum LogLevel {\n  INFO = 'info',\n  WARN = 'warn',\n  ERROR = 'error',\n  DEBUG = 'debug'\n}\n\ntype LogMode = 'silent' | 'minimal' | 'normal' | 'verbose';\n\ninterface LogMessage {\n  level: LogLevel;\n  message: string;\n  timestamp: string;\n  context?: Record<string, any>;\n}\n\n// ANSI color codes\nconst colors = {\n  reset: '\\x1b[0m',\n  bright: '\\x1b[1m',\n  dim: '\\x1b[2m',\n  red: '\\x1b[31m',\n  green: '\\x1b[32m',\n  yellow: '\\x1b[33m',\n  blue: '\\x1b[34m',\n  magenta: '\\x1b[35m',\n  cyan: '\\x1b[36m',\n  white: '\\x1b[37m',\n  gray: '\\x1b[90m',\n  // Background colors\n  bgRed: '\\x1b[41m',\n  bgGreen: '\\x1b[42m',\n  bgYellow: '\\x1b[43m',\n  bgBlue: '\\x1b[44m',\n  bgMagenta: '\\x1b[45m',\n  bgCyan: '\\x1b[46m',\n  bgWhite: '\\x1b[47m',\n  bgGray: '\\x1b[100m',\n  // Bright background colors\n  bgBrightRed: '\\x1b[101m',\n  bgBrightGreen: '\\x1b[102m',\n  bgBrightYellow: '\\x1b[103m',\n  bgBrightBlue: '\\x1b[104m',\n  bgBrightMagenta: '\\x1b[105m',\n  bgBrightCyan: '\\x1b[106m',\n  bgBrightWhite: '\\x1b[107m'\n};\n\nclass Logger {\n  private static instance: Logger;\n  private isDevelopment: boolean;\n  private mode: LogMode;\n  private levelColors: Record<LogLevel, string>;\n  private levelBgColors: Record<LogLevel, string>;\n  private levelEmojis: Record<LogLevel, string>;\n\n  private constructor() {\n\n    // this.isDevelopment = process.env.NODE_ENV === 'development';\n    this.isDevelopment = true;\n\n    this.mode = (process.env.NODE_ENV === 'test' ? 'silent' : ((process.env.LOG_MODE as LogMode) || 'normal'));\n    \n\n    this.levelColors = {\n      [LogLevel.INFO]: colors.blue,\n      [LogLevel.WARN]: colors.yellow,\n      [LogLevel.ERROR]: colors.red,\n      [LogLevel.DEBUG]: colors.magenta\n    };\n\n    this.levelBgColors = {\n      [LogLevel.INFO]: colors.bgBlue,\n      [LogLevel.WARN]: colors.bgYellow,\n      [LogLevel.ERROR]: colors.bgRed,\n      [LogLevel.DEBUG]: colors.bgMagenta\n    };\n\n    this.levelEmojis = {\n      [LogLevel.INFO]: 'ℹ️',\n      [LogLevel.WARN]: '⚠️',\n      [LogLevel.ERROR]: '❌',\n      [LogLevel.DEBUG]: '🔍'\n    };\n  }\n\n  public static getInstance(): Logger {\n    if (!Logger.instance) {\n      Logger.instance = new Logger();\n    }\n    return Logger.instance;\n  }\n\n  public setMode(mode: LogMode) {\n    this.mode = mode;\n  }\n\n  private shouldLog(level: LogLevel): boolean {\n    const silent = [\n      LogLevel.ERROR,\n    ];\n\n    const minimal = [\n      LogLevel.ERROR,\n      LogLevel.WARN,\n    ];\n\n    const normal = [\n      LogLevel.ERROR,\n      LogLevel.WARN,\n      LogLevel.INFO,\n    ];\n\n    if (this.mode === 'silent') return silent.includes(level);\n    if (this.mode === 'minimal') return minimal.includes(level);\n    if (this.mode === 'normal') return normal.includes(level);\n    return true; // verbose mode\n  }\n\n  private formatMessage(logMessage: LogMessage): string {\n    const { level, message, timestamp, context } = logMessage;\n    const color = this.levelColors[level];\n    const bgColor = this.levelBgColors[level];\n    const emoji = this.levelEmojis[level];\n    \n    const timestampStr = colors.gray + `[${timestamp}]` + colors.reset;\n    // Use background color for level badge like Vitest\n    const levelStr = colors.white + bgColor + ` ${level.toUpperCase()} ` + colors.reset;\n    const emojiStr = emoji + ' ';\n    const messageStr = colors.bright + message + colors.reset;\n    \n    const contextStr = context \n      ? '\\n' + colors.dim + 'Context: ' + JSON.stringify(context, null, 2) + colors.reset\n      : '';\n\n    return `${timestampStr} ${levelStr} ${emojiStr}${messageStr}${contextStr}`;\n  }\n\n  private log(level: LogLevel, message: string, context?: Record<string, any>) {\n    if (!this.shouldLog(level)) \n      return;    \n\n    if (level == LogLevel.WARN || level == LogLevel.ERROR) {\n      if (level == LogLevel.ERROR) {\n        // alert me\n      }\n      // store in database\n    }\n    \n    const logMessage: LogMessage = {\n      level,\n      message,\n      timestamp: new Date().toISOString(),\n      context\n    };\n\n    const formattedMessage = this.formatMessage(logMessage);\n\n    switch (level) {\n      case LogLevel.ERROR:\n        console.error(formattedMessage);\n        break;\n      case LogLevel.WARN:\n        console.warn(formattedMessage);\n        break;\n      case LogLevel.DEBUG:\n        if (this.isDevelopment) {\n          console.debug(formattedMessage);\n        }\n        break;\n      default:\n        console.log(formattedMessage);\n    }\n  }\n\n  public info(message: string, context?: Record<string, any>) {\n    this.log(LogLevel.INFO, message, context);\n  }\n\n  public warn(message: string, context?: Record<string, any>) {\n    this.log(LogLevel.WARN, message, context);\n  }\n\n  public error(message: string, context?: Record<string, any>) {\n    this.log(LogLevel.ERROR, message, context);\n  }\n\n  public debug(message: string, context?: Record<string, any>) {\n    this.log(LogLevel.DEBUG, message, context);\n  }\n}\n\nexport const logger = Logger.getInstance(); "],"names":[],"mappings":"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","debug_id":"3ad19480-6fd4-5009-abf4-d8f8caeb9a0e"}

package/docker-compose.yml

@@ -0,0 +1,14 @@
+services:
+  dev-db:
+    image: postgres
+    environment:
+      POSTGRES_PASSWORD: password
+    ports:
+      - "5433:5432"
+
+  test-db:
+    image: postgres
+    environment:
+      POSTGRES_PASSWORD: password
+    ports:
+      - "5434:5432"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@studious-lms/server",
-  "version": "1.2.45",
+  "version": "1.2.46",
   "description": "Backend server for Studious application",
   "main": "dist/exportType.js",
   "types": "dist/exportType.d.ts",
@@ -17,8 +17,12 @@
     "start": "node dist/index.js",
     "generate": "npx prisma generate",
     "prepublishOnly": "npm run generate && npm run build",
-    "test": "vitest",
-    "seed": "tsx src/seedDatabase.ts",
+    "test:pre": "NODE_ENV=test tsx scripts/test-pre-push.ts",
+    "test": "npm run test:pre && NODE_ENV=test vitest",
+    "test:run": "NODE_ENV=test vitest run",
+    "test:watch": "NODE_ENV=test vitest watch",
+    "test:coverage": "NODE_ENV=test vitest run --coverage",
+    "db:seed": "tsx src/seedDatabase.ts",
     "sentry:sourcemaps": "sentry-cli sourcemaps inject --org studious-fp --project server ./dist && sentry-cli sourcemaps upload --org studious-fp --project server ./dist"
   },
   "dependencies": {
@@ -28,11 +32,15 @@
     "@sentry/cli": "^2.58.2",
     "@sentry/node": "^10.26.0",
     "@trpc/server": "^11.4.3",
+    "@unkey/ratelimit": "^2.1.3",
     "bcryptjs": "^3.0.2",
+    "compression": "^1.8.1",
     "cors": "^2.8.5",
     "date-fns": "^4.1.0",
     "dotenv": "^16.5.0",
     "express": "^4.18.3",
+    "express-rate-limit": "^8.2.1",
+    "helmet": "^8.1.0",
     "nodemailer": "^7.0.4",
     "openai": "^5.23.0",
     "pdf-lib": "^1.17.1",
@@ -41,17 +49,18 @@
     "sharp": "^0.34.2",
     "socket.io": "^4.8.1",
     "superjson": "^2.2.2",
-    "trpc-panel": "^1.3.4",
     "uuid": "^11.1.0",
     "zod": "^3.22.4"
   },
   "devDependencies": {
+    "@types/compression": "^1.8.1",
     "@types/cors": "^2.8.17",
     "@types/express": "^4.17.21",
     "@types/node": "^20.11.24",
     "@types/nodemailer": "^6.4.17",
     "@types/supertest": "^6.0.3",
     "@types/uuid": "^10.0.0",
+    "@vitest/coverage-v8": "^3.2.4",
     "supertest": "^7.1.4",
     "trpc-ui": "^1.0.15",
     "ts-node": "^10.9.2",

package/prisma/schema.prisma

@@ -9,6 +9,11 @@ generator client {
   // output   = "../generated/prisma"
 }
 
+// @todo: add type safety to json fields.
+// generator json {
+//   provider = "prisma-json-types-generator"
+// }
+
 datasource db {
   provider = "postgresql"
   url      = env("DATABASE_URL")
@@ -42,6 +47,15 @@ enum UploadStatus {
   CANCELLED
 }
 
+enum GenerationStatus {
+  NOT_STARTED
+  PENDING
+  GENERATING
+  COMPLETED
+  FAILED
+  CANCELLED
+}
+
 enum WorksheetQuestionType {
   MULTIPLE_CHOICE
   TRUE_FALSE
@@ -305,6 +319,7 @@ model Comment {
   announcementId String?
   parentComment Comment? @relation("CommentReplies", fields: [parentCommentId], references: [id], onDelete: Cascade)
   parentCommentId String?
+  status GenerationStatus?
   replies       Comment[] @relation("CommentReplies")
   reactions     Reaction[]
   createdAt     DateTime @default(now())
@@ -345,7 +360,6 @@ model Submission {
   annotations File[]  @relation("SubmissionAnnotations")
   worksheetResponses StudentWorksheetResponse[]
   extendedResponse String?
-  
   gradeReceived Int?
 
   rubricState String?
@@ -354,6 +368,18 @@ model Submission {
   submittedAt DateTime?
   submitted   Boolean? @default(false)
   returned    Boolean? @default(false)
+  newtonTutors NewtonChat[]
+}
+
+model NewtonChat {
+  id String @id @default(uuid())
+  submissionId String
+  submission Submission @relation(fields: [submissionId], references: [id], onDelete: Cascade)
+  conversationId String @unique
+  conversation Conversation @relation(fields: [conversationId], references: [id], onDelete: Cascade)
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  title String @default("Session with Newton Tutor")
 }
 
 model Section {
@@ -441,6 +467,7 @@ model Conversation {
   members ConversationMember[]
   messages Message[]
   labChat LabChat?
+  newtonChat NewtonChat?
 }
 
 model LabChat {
@@ -451,8 +478,7 @@ model LabChat {
   conversationId String @unique
   createdById String // Teacher who created the lab
   createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-  
+  updatedAt DateTime @updatedAt  
   class Class @relation("ClassLabChats", fields: [classId], references: [id], onDelete: Cascade)
   conversation Conversation @relation(fields: [conversationId], references: [id], onDelete: Cascade)
   createdBy User @relation("CreatedLabChats", fields: [createdById], references: [id], onDelete: NoAction)
@@ -479,7 +505,7 @@ model Message {
   senderId String
   conversationId String
   createdAt DateTime @default(now())
-  
+  status GenerationStatus? @default(NOT_STARTED)
   sender User @relation("SentMessages", fields: [senderId], references: [id], onDelete: Cascade)
   conversation Conversation @relation(fields: [conversationId], references: [id], onDelete: Cascade)
   mentions Mention[]
@@ -557,6 +583,7 @@ model StudentQuestionProgress {
   updatedAt DateTime? @updatedAt
   studentWorksheetResponseId String?
   studentWorksheetResponse StudentWorksheetResponse? @relation(fields: [studentWorksheetResponseId], references: [id], onDelete: Cascade)
+  status GenerationStatus? @default(NOT_STARTED)
   
   @@index([studentId, questionId])
 }
@@ -582,7 +609,7 @@ model SchoolDevelopementProgram {
   submittedAt DateTime? @default(now())
   reviewedAt DateTime?
 
-  status String @default("PENDING") // PENDING, APPROVED, REJECTED, REFERRED
+  status String @default("NOT_STARTED") // NOT_STARTED, PENDING, APPROVED, REJECTED, REFERRED
 
   supportingDocumentation File[] @relation("SchoolDevelopementProgramSupportingDocumentation")
 }

package/scripts/test-pre-push.ts

@@ -0,0 +1,14 @@
+import { execSync } from 'child_process';
+import { logger } from '../src/utils/logger';
+import dotenv from 'dotenv';
+import { resolve } from 'path';
+
+dotenv.config({ path: resolve(process.cwd(), '.env.test') });
+
+logger.info("Syncing Prisma schema to test database...");
+
+execSync("npx prisma db push --force-reset --skip-generate", {
+  stdio: 'inherit',
+});
+
+logger.info("Test database is ready!");

package/src/index.ts

@@ -11,58 +11,57 @@ import { logger } from './utils/logger.js';
 import { setupSocketHandlers } from './socket/handlers.js';
 import { bucket } from './lib/googleCloudStorage.js';
 import { prisma } from './lib/prisma.js';
+
+import { authLimiter, generalLimiter, helmetConfig, uploadLimiter } from './middleware/security.js';
+
 import * as Sentry from "@sentry/node";
+import { env } from './lib/config/env.js';
+import compression from 'compression';
+import { v4 as uuidv4 } from 'uuid';
 
-import { renderTrpcPanel } from "trpc-panel";
 
 import "./instrument.js";
-
-dotenv.config();
+import { openAIClient } from './utils/inference.js';
 
 const app = express();
 
+app.use(helmetConfig);
+app.use(compression());
+
+app.use((req, res, next) => {
+  const requestId = uuidv4();
+  res.setHeader('X-Request-ID', requestId);
+  next();
+});
+
+app.use(generalLimiter);
+
+const allowedOrigins = env.NODE_ENV === 'production'
+? [
+    'https://www.studious.sh',
+    'https://studious.sh',
+    env.NEXT_PUBLIC_APP_URL,
+    'http://localhost:3000',
+
+  ].filter(Boolean)
+: [
+    'http://localhost:3000',
+    'http://localhost:3001',
+    'http://127.0.0.1:3000',
+    'http://127.0.0.1:3001',
+
+    env.NEXT_PUBLIC_APP_URL || 'http://localhost:3000'
+  ];
+
 // CORS middleware
 app.use(cors({
-  origin: [
-    'http://localhost:3000',  // Frontend development server
-    'http://localhost:3001',  // Server port
-    'http://127.0.0.1:3000',  // Alternative localhost
-    'http://127.0.0.1:3001',  // Alternative localhost
-    'https://www.studious.sh',  // Production frontend
-    'https://studious.sh',     // Production frontend (without www)
-    process.env.NEXT_PUBLIC_APP_URL || 'http://localhost:3000'
-  ],
+  origin: allowedOrigins,
   credentials: true,
   methods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS'],
   allowedHeaders: ['Content-Type', 'Authorization', 'X-Requested-With', 'x-user'],
   optionsSuccessStatus: 200
 }));
 
-// Handle preflight OPTIONS requests
-app.options('*', (req, res) => {
-  const allowedOrigins = [
-    'http://localhost:3000',
-    'http://localhost:3001', 
-    'http://127.0.0.1:3000',
-    'http://127.0.0.1:3001',
-    'https://www.studious.sh',  // Production frontend
-    'https://studious.sh',     // Production frontend (without www)
-    process.env.NEXT_PUBLIC_APP_URL || 'http://localhost:3000'
-  ];
-  
-  const origin = req.headers.origin;
-  if (origin && allowedOrigins.includes(origin)) {
-    res.header('Access-Control-Allow-Origin', origin);
-  } else {
-    res.header('Access-Control-Allow-Origin', 'http://localhost:3000');
-  }
-  
-  res.header('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, OPTIONS');
-  res.header('Access-Control-Allow-Headers', 'Content-Type, Authorization, X-Requested-With, x-user');
-  res.header('Access-Control-Allow-Credentials', 'true');
-  res.sendStatus(200);
-});
-
 // CORS debugging middleware
 app.use((req, res, next) => {
   if (req.method === 'OPTIONS' || req.path.includes('trpc')) {
@@ -92,7 +91,7 @@ app.use((req, res, next) => {
 });
 
 app.use("/panel", async (_, res) => {
-  if (process.env.NODE_ENV !== "development") {
+  if (env.NODE_ENV !== "development") {
     return res.status(404).send("Not Found");
   }
 
@@ -115,12 +114,25 @@ app.use("/panel", async (_, res) => {
 // Create HTTP server
 const httpServer = createServer(app);
 
-app.get('/health', (req, res) => {
-  res.status(200).json({ message: 'OK' });
-});
+app.get('/health', async (req, res) => {
 
-app.get('/test-sentry', (req, res) => {
-  throw new Error('Test error');
+  try {
+    // Check database connectivity
+    await prisma.$queryRaw`SELECT 1`;
+    
+    res.status(200).json({ 
+      status: 'OK',
+      timestamp: new Date().toISOString(),
+      uptime: process.uptime(),
+      database: 'connected'
+    });
+  } catch (error) {
+    res.status(503).json({ 
+      status: 'ERROR',
+      database: 'disconnected',
+      error: error instanceof Error ? error.message : 'Unknown error'
+    });
+  }
 });
 
 // Setup Socket.IO
@@ -133,7 +145,7 @@ const io = new Server(httpServer, {
       'http://127.0.0.1:3001',  // Alternative localhost
       'https://www.studious.sh',  // Production frontend
       'https://studious.sh',     // Production frontend (without www)
-      process.env.NEXT_PUBLIC_APP_URL || 'http://localhost:3000'
+      env.NEXT_PUBLIC_APP_URL || 'http://localhost:3000'
     ],
     methods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS'],
     credentials: true,
@@ -356,12 +368,15 @@ app.get('/api/files/:fileId', async (req, res) => {
   }
 });
 
+app.use('/trpc/auth.login', authLimiter);
+app.use('/trpc/auth.register', authLimiter);
+
 // File upload endpoint for secure file uploads (supports both POST and PUT)
-app.post('/api/upload/:filePath', async (req, res) => {
+app.post('/api/upload/:filePath', uploadLimiter, async (req, res) => {
   handleFileUpload(req, res);
 });
 
-app.put('/api/upload/:filePath', async (req, res) => {
+app.put('/api/upload/:filePath', uploadLimiter, async (req, res) => {
   handleFileUpload(req, res);
 });
 
@@ -378,7 +393,7 @@ function handleFileUpload(req: any, res: any) {
       'http://127.0.0.1:3001',
       'https://www.studious.sh',  // Production frontend
       'https://studious.sh',     // Production frontend (without www)
-      process.env.NEXT_PUBLIC_APP_URL || 'http://localhost:3000'
+      env.NEXT_PUBLIC_APP_URL || 'http://localhost:3000'
     ];
     
     if (origin && allowedOrigins.includes(origin)) {
@@ -453,7 +468,7 @@ Sentry.setupExpressErrorHandler(app);
 // });
 
 
-const PORT = process.env.PORT || 3001;
+const PORT = env.PORT || 3001;
 
 httpServer.listen(PORT, () => {
   logger.info(`Server running on port ${PORT}`, { 
@@ -464,10 +479,10 @@ httpServer.listen(PORT, () => {
 
 // log all env variables
 logger.info('Configurations', {
-  NODE_ENV: process.env.NODE_ENV,
-  PORT: process.env.PORT,
-  NEXT_PUBLIC_APP_URL: process.env.NEXT_PUBLIC_APP_URL,
-  LOG_MODE: process.env.LOG_MODE,
+  NODE_ENV: env.NODE_ENV,
+  PORT: env.PORT,
+  NEXT_PUBLIC_APP_URL: env.NEXT_PUBLIC_APP_URL,
+  LOG_MODE: env.LOG_MODE,
 });
 
 // Log CORS configuration
@@ -477,6 +492,35 @@ logger.info('CORS Configuration', {
     'http://localhost:3001', 
     'http://127.0.0.1:3000',
     'http://127.0.0.1:3001',
-    process.env.NEXT_PUBLIC_APP_URL || 'http://localhost:3000'
+    env.NEXT_PUBLIC_APP_URL || 'http://localhost:3000'
   ]
-});
+});
+
+const gracefulShutdown = (signal: string) => {
+  logger.info(`Received ${signal}, shutting down gracefully`);
+  
+  httpServer.close(() => {
+    logger.info('HTTP server closed');
+    
+    io.close(() => {
+      logger.info('Socket.IO server closed');
+      
+      prisma.$disconnect().then(() => {
+        logger.info('Database connections closed');
+        process.exit(0);
+      }).catch((err) => {
+        logger.error('Error disconnecting from database', { error: err });
+        process.exit(1);
+      });
+    });
+  });
+  
+  // Force shutdown after 10 seconds
+  setTimeout(() => {
+    logger.error('Forced shutdown after timeout');
+    process.exit(1);
+  }, 10000);
+};
+
+process.on('SIGTERM', () => gracefulShutdown('SIGTERM'));
+process.on('SIGINT', () => gracefulShutdown('SIGINT'));

package/src/instrument.ts

@@ -1,8 +1,15 @@
 import * as Sentry from "@sentry/node";
+import { env } from "./lib/config/env.js";
 
-Sentry.init({
-  dsn: "https://5440f33877e8e19d7644624f5d3d2f10@o4510401976860672.ingest.de.sentry.io/4510402093514832",
-  // Setting this option to true will send default PII data to Sentry.
-  // For example, automatic IP address collection on events
-  sendDefaultPii: true,
-});
+// Only initialize Sentry in non-test environments
+if (env.NODE_ENV !== 'test') {
+  Sentry.init({
+    dsn: env.SENTRY_DSN,
+    environment: env.NODE_ENV || 'development',
+    // Setting this option to true will send default PII data to Sentry.
+    // For example, automatic IP address collection on events
+    sendDefaultPii: true,
+    // @todo: disable in test environment
+    enabled: true, // Explicitly disable in test environment
+  });
+}

package/src/lib/config/env.ts

@@ -0,0 +1,126 @@
+import { z } from 'zod';
+import dotenv from 'dotenv';
+import { resolve } from 'path';
+import { logger } from '../../utils/logger.js';
+
+// Determine which env file to load based on NODE_ENV
+const nodeEnv = process.env.NODE_ENV || 'development';
+const envFileMap: Record<string, string> = {
+  test: '.env.test',
+  development: '.env.development',
+  production: '.env.production',
+};
+
+// Load the appropriate env file
+const envFile = envFileMap[nodeEnv] || '.env';
+const envPath = resolve(process.cwd(), envFile);
+
+// Load environment variables from the correct file
+// First load .env (base), then override with environment-specific file
+dotenv.config(); // Load .env first (base config)
+dotenv.config({ path: envPath, override: true }); // Override with env-specific
+
+const isTest = nodeEnv === 'test';
+const isProduction = nodeEnv === 'production';
+
+// Base schema with required vars for all environments
+const baseSchema = z.object({
+  NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),
+  PORT: z.string().transform(Number).default('3001'),
+  DATABASE_URL: z.string().url('DATABASE_URL must be a valid URL'),
+});
+
+// Production/development schema with all required vars
+const fullSchema = baseSchema.extend({
+  NEXT_PUBLIC_APP_URL: z.string().url().default('http://localhost:3000'),
+  BACKEND_URL: z.string().url().default('http://localhost:3001'),
+  SENTRY_DSN: z.string().url().optional(),
+  EMAIL_HOST: z.string().min(1, 'EMAIL_HOST is required'),
+  EMAIL_USER: z.string().email('EMAIL_USER must be a valid email'),
+  EMAIL_PASS: z.string().min(1, 'EMAIL_PASS is required'),
+  EMAIL_DRY_RUN: z.string().optional().default('false'),
+  GOOGLE_CLOUD_PROJECT_ID: z.string().min(1, 'GOOGLE_CLOUD_PROJECT_ID is required'),
+  GOOGLE_CLOUD_CLIENT_EMAIL: z.string().email('GOOGLE_CLOUD_CLIENT_EMAIL must be a valid email'),
+  GOOGLE_CLOUD_PRIVATE_KEY: z.string().min(1, 'GOOGLE_CLOUD_PRIVATE_KEY is required'),
+  GOOGLE_CLOUD_BUCKET_NAME: z.string().min(1, 'GOOGLE_CLOUD_BUCKET_NAME is required'),
+  PUSHER_APP_ID: z.string().min(1, 'PUSHER_APP_ID is required'),
+  PUSHER_KEY: z.string().min(1, 'PUSHER_KEY is required'),
+  PUSHER_SECRET: z.string().min(1, 'PUSHER_SECRET is required'),
+  PUSHER_CLUSTER: z.string().min(1, 'PUSHER_CLUSTER is required'),
+  INFERENCE_API_KEY: z.string().optional(),
+  INFERENCE_API_BASE_URL: z.string().url().optional(),
+  OPENAI_API_KEY: z.string().optional(),
+  LOG_MODE: z.enum(['normal', 'verbose', 'quiet']).default('normal'),
+});
+
+// Test schema - only require what's needed for tests
+const testSchema = baseSchema.extend({
+  NEXT_PUBLIC_APP_URL: z.string().url().optional().default('http://localhost:3000'),
+  BACKEND_URL: z.string().url().optional().default('http://localhost:3001'),
+  SENTRY_DSN: z.string().url().optional(),
+  EMAIL_HOST: z.string().optional().default('smtp.test.com'),
+  EMAIL_USER: z.string().email().optional().default('test@test.com'),
+  EMAIL_PASS: z.string().optional().default('test'),
+  EMAIL_DRY_RUN: z.string().optional().default('false'),
+  GOOGLE_CLOUD_PROJECT_ID: z.string().optional().default('test-project'),
+  GOOGLE_CLOUD_CLIENT_EMAIL: z.string().email().optional().default('test@test.iam.gserviceaccount.com'),
+  GOOGLE_CLOUD_PRIVATE_KEY: z.string().optional().default('test-key'),
+  GOOGLE_CLOUD_BUCKET_NAME: z.string().optional().default('test-bucket'),
+  PUSHER_APP_ID: z.string().optional().default('test-app-id'),
+  PUSHER_KEY: z.string().optional().default('test-key'),
+  PUSHER_SECRET: z.string().optional().default('test-secret'),
+  PUSHER_CLUSTER: z.string().optional().default('us2'),
+  INFERENCE_API_KEY: z.string().optional(),
+  OPENAI_API_KEY: z.string().optional(),
+  INFERENCE_API_BASE_URL: z.string().url().optional(),
+  LOG_MODE: z.enum(['normal', 'verbose', 'quiet']).default('quiet'),
+});
+
+// Use test schema in test mode, full schema otherwise
+const envSchema = isTest ? testSchema : fullSchema;
+
+// Validate environment variables
+function validateEnv() {
+  try {
+    const parsed = envSchema.parse(process.env);
+    
+    // Only exit on validation failure in production
+    if (isProduction && !parsed.DATABASE_URL) {
+      logger.error('DATABASE_URL is required in production');
+      process.exit(1);
+    }
+    
+    return parsed;
+  } catch (error) {
+    if (error instanceof z.ZodError) {
+      const missingVars = error.errors.map(err => ({
+        path: err.path.join('.'),
+        message: err.message,
+      }));
+      
+      logger.error('Environment variable validation failed', {
+        envFile,
+        missingVars,
+      });
+      
+      // Only exit in production - in test/dev, log warning but continue
+      if (isProduction) {
+        logger.error(`Please check your ${envFile} file and ensure all required variables are set.`);
+        process.exit(1);
+      } else {
+        logger.warn('Continuing with defaults - some features may not work correctly', {
+          envFile,
+        });
+        // Return parsed with defaults for non-production
+        return envSchema.parse({ ...process.env });
+      }
+    }
+    throw error;
+  }
+}
+
+// Export validated environment variables
+export const env = validateEnv();
+
+// Type-safe environment access
+export type Env = z.infer<typeof envSchema>;

package/src/lib/fileUpload.ts

@@ -4,6 +4,7 @@ import { getSignedUrl, objectExists } from "./googleCloudStorage.js";
 import { generateMediaThumbnail } from "./thumbnailGenerator.js";
 import { prisma } from "./prisma.js";
 import { logger } from "../utils/logger.js";
+import { env } from "./config/env.js";
 
 export interface FileData {
   name: string;
@@ -136,7 +137,7 @@ export async function createDirectUploadFile(
     const uploadSessionId = uuidv4();
     
     // Generate backend proxy upload URL (not direct GCS)
-    const baseUrl = process.env.BACKEND_URL || 'http://localhost:3001';
+    const baseUrl = env.BACKEND_URL || 'http://localhost:3001';
     const uploadUrl = `${baseUrl}/api/upload/${encodeURIComponent(filePath)}`;
     const uploadExpiresAt = new Date(Date.now() + 15 * 60 * 1000); // 15 minutes from now
     
@@ -231,7 +232,7 @@ export async function confirmDirectUpload(
     // If uploadSuccess is true, verify the object actually exists in GCS
     if (uploadSuccess) {
       try {
-        const exists = await objectExists(process.env.GOOGLE_CLOUD_BUCKET_NAME!, fileRecord.path);
+        const exists = await objectExists(env.GOOGLE_CLOUD_BUCKET_NAME!, fileRecord.path);
         if (!exists) {
           actualUploadSuccess = false;
           actualErrorMessage = 'File upload reported as successful but object not found in Google Cloud Storage';

package/src/lib/googleCloudStorage.ts

@@ -1,17 +1,17 @@
-import dotenv from 'dotenv';
-dotenv.config();
+
 import { Storage } from '@google-cloud/storage';
 import { TRPCError } from '@trpc/server';
+import { env } from './config/env.js';
 
 const storage = new Storage({
-  projectId: process.env.GOOGLE_CLOUD_PROJECT_ID,
+  projectId: env.GOOGLE_CLOUD_PROJECT_ID,
   credentials: {
-    client_email: process.env.GOOGLE_CLOUD_CLIENT_EMAIL,
-    private_key: process.env.GOOGLE_CLOUD_PRIVATE_KEY?.replace(/\\n/g, '\n'),
+    client_email: env.GOOGLE_CLOUD_CLIENT_EMAIL,
+    private_key: env.GOOGLE_CLOUD_PRIVATE_KEY?.replace(/\\n/g, '\n'),
   },
 });
 
-export const bucket = storage.bucket(process.env.GOOGLE_CLOUD_BUCKET_NAME!);
+export const bucket = storage.bucket(env.GOOGLE_CLOUD_BUCKET_NAME!);
 
 // Short expiration time for signed URLs (5 minutes)
 const SIGNED_URL_EXPIRATION = 5 * 60 * 1000;