@studious-lms/server 1.0.4 → 1.0.7

package/dist/utils/prismaErrorHandler.js

@@ -0,0 +1,234 @@
+import { PrismaClientKnownRequestError, PrismaClientUnknownRequestError, PrismaClientValidationError } from '@prisma/client/runtime/library';
+export function handlePrismaError(error) {
+    // PrismaClientKnownRequestError - Database constraint violations, etc.
+    if (error instanceof PrismaClientKnownRequestError) {
+        return handleKnownRequestError(error);
+    }
+    // PrismaClientValidationError - Invalid data format, missing required fields, etc.
+    if (error instanceof PrismaClientValidationError) {
+        return handleValidationError(error);
+    }
+    // PrismaClientUnknownRequestError - Unknown database errors
+    if (error instanceof PrismaClientUnknownRequestError) {
+        return handleUnknownRequestError(error);
+    }
+    // Generic error fallback
+    if (error instanceof Error) {
+        return {
+            message: error.message,
+            details: error.stack
+        };
+    }
+    return {
+        message: 'An unknown database error occurred',
+        details: String(error)
+    };
+}
+function handleKnownRequestError(error) {
+    const { code, meta, message } = error;
+    switch (code) {
+        case 'P2002':
+            const target = Array.isArray(meta?.target) ? meta.target.join(', ') : meta?.target || 'field';
+            return {
+                message: `A record with this ${target} already exists`,
+                code,
+                meta,
+                details: `Unique constraint violation on ${target}`
+            };
+        case 'P2003':
+            const fieldName = meta?.field_name || 'related field';
+            return {
+                message: `Cannot delete this record because it's referenced by other records`,
+                code,
+                meta,
+                details: `Foreign key constraint violation on ${fieldName}`
+            };
+        case 'P2025':
+            return {
+                message: 'The record you are trying to update or delete does not exist',
+                code,
+                meta,
+                details: 'Record not found in database'
+            };
+        case 'P2014':
+            return {
+                message: 'The change you are trying to make would violate the required relationship',
+                code,
+                meta,
+                details: 'Required relation violation'
+            };
+        case 'P2011':
+            return {
+                message: 'A required field is missing or empty',
+                code,
+                meta,
+                details: 'Null constraint violation'
+            };
+        case 'P2012':
+            return {
+                message: 'The data you provided is not in the correct format',
+                code,
+                meta,
+                details: 'Data validation error'
+            };
+        case 'P2013':
+            return {
+                message: 'The data you provided is too long for this field',
+                code,
+                meta,
+                details: 'String length constraint violation'
+            };
+        case 'P2015':
+            return {
+                message: 'The record you are looking for could not be found',
+                code,
+                meta,
+                details: 'Record not found'
+            };
+        case 'P2016':
+            return {
+                message: 'The query you are trying to execute is not valid',
+                code,
+                meta,
+                details: 'Query interpretation error'
+            };
+        case 'P2017':
+            return {
+                message: 'The relationship between records is not properly connected',
+                code,
+                meta,
+                details: 'Relation connection error'
+            };
+        case 'P2018':
+            return {
+                message: 'The connected record you are looking for does not exist',
+                code,
+                meta,
+                details: 'Connected record not found'
+            };
+        case 'P2019':
+            return {
+                message: 'The input you provided is not valid',
+                code,
+                meta,
+                details: 'Input error'
+            };
+        case 'P2020':
+            return {
+                message: 'The value you provided is outside the allowed range',
+                code,
+                meta,
+                details: 'Value out of range'
+            };
+        case 'P2021':
+            return {
+                message: 'The table you are trying to access does not exist',
+                code,
+                meta,
+                details: 'Table does not exist'
+            };
+        case 'P2022':
+            return {
+                message: 'The column you are trying to access does not exist',
+                code,
+                meta,
+                details: 'Column does not exist'
+            };
+        case 'P2023':
+            return {
+                message: 'The column data is not valid',
+                code,
+                meta,
+                details: 'Column data validation error'
+            };
+        case 'P2024':
+            return {
+                message: 'The database connection pool is exhausted',
+                code,
+                meta,
+                details: 'Connection pool timeout'
+            };
+        case 'P2026':
+            return {
+                message: 'The current database provider does not support this feature',
+                code,
+                meta,
+                details: 'Feature not supported by database provider'
+            };
+        case 'P2027':
+            return {
+                message: 'Multiple errors occurred during the database operation',
+                code,
+                meta,
+                details: 'Multiple errors in query execution'
+            };
+        default:
+            return {
+                message: 'A database constraint was violated',
+                code,
+                meta,
+                details: message
+            };
+    }
+}
+function handleValidationError(error) {
+    return {
+        message: 'The data you provided is not valid',
+        details: error.message,
+        meta: {
+            type: 'validation_error',
+            originalMessage: error.message
+        }
+    };
+}
+function handleUnknownRequestError(error) {
+    return {
+        message: 'An unexpected database error occurred',
+        details: error.message,
+        meta: {
+            type: 'unknown_request_error',
+            originalMessage: error.message
+        }
+    };
+}
+// Helper function to get user-friendly field names
+export function getFieldDisplayName(fieldName) {
+    const fieldMap = {
+        'username': 'username',
+        'email': 'email address',
+        'password': 'password',
+        'name': 'name',
+        'title': 'title',
+        'content': 'content',
+        'description': 'description',
+        'subject': 'subject',
+        'section': 'section',
+        'color': 'color',
+        'location': 'location',
+        'startTime': 'start time',
+        'endTime': 'end time',
+        'dueDate': 'due date',
+        'maxGrade': 'maximum grade',
+        'grade': 'grade',
+        'feedback': 'feedback',
+        'remarks': 'remarks',
+        'syllabus': 'syllabus',
+        'path': 'file path',
+        'size': 'file size',
+        'type': 'file type',
+        'uploadedAt': 'upload date',
+        'verified': 'verification status',
+        'profileId': 'profile',
+        'schoolId': 'school',
+        'classId': 'class',
+        'assignmentId': 'assignment',
+        'submissionId': 'submission',
+        'userId': 'user',
+        'eventId': 'event',
+        'sessionId': 'session',
+        'thumbnailId': 'thumbnail',
+        'annotationId': 'annotation',
+        'logoId': 'logo'
+    };
+    return fieldMap[fieldName] || fieldName;
+}

package/dist/utils/prismaWrapper.d.ts

@@ -0,0 +1,14 @@
+export declare function withPrismaErrorHandling<T>(operation: () => Promise<T>, context?: string): Promise<T>;
+export declare const prismaWrapper: {
+    findUnique: <T>(operation: () => Promise<T | null>, context?: string) => Promise<T | null>;
+    findFirst: <T>(operation: () => Promise<T | null>, context?: string) => Promise<T | null>;
+    findMany: <T>(operation: () => Promise<T[]>, context?: string) => Promise<T[]>;
+    create: <T>(operation: () => Promise<T>, context?: string) => Promise<T>;
+    update: <T>(operation: () => Promise<T>, context?: string) => Promise<T>;
+    delete: <T>(operation: () => Promise<T>, context?: string) => Promise<T>;
+    deleteMany: <T>(operation: () => Promise<T>, context?: string) => Promise<T>;
+    upsert: <T>(operation: () => Promise<T>, context?: string) => Promise<T>;
+    count: <T>(operation: () => Promise<T>, context?: string) => Promise<T>;
+    aggregate: <T>(operation: () => Promise<T>, context?: string) => Promise<T>;
+};
+//# sourceMappingURL=prismaWrapper.d.ts.map

package/dist/utils/prismaWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prismaWrapper.d.ts","sourceRoot":"","sources":["../../src/utils/prismaWrapper.ts"],"names":[],"mappings":"AAGA,wBAAsB,uBAAuB,CAAC,CAAC,EAC7C,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,GAAE,MAA6B,GACrC,OAAO,CAAC,CAAC,CAAC,CAsBZ;AAgCD,eAAO,MAAM,aAAa;iBACX,CAAC,aAAa,MAAM,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,YAAY,MAAM;gBAGxD,CAAC,aAAa,MAAM,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,YAAY,MAAM;eAGxD,CAAC,aAAa,MAAM,OAAO,CAAC,CAAC,EAAE,CAAC,YAAY,MAAM;aAGpD,CAAC,aAAa,MAAM,OAAO,CAAC,CAAC,CAAC,YAAY,MAAM;aAGhD,CAAC,aAAa,MAAM,OAAO,CAAC,CAAC,CAAC,YAAY,MAAM;aAGhD,CAAC,aAAa,MAAM,OAAO,CAAC,CAAC,CAAC,YAAY,MAAM;iBAG5C,CAAC,aAAa,MAAM,OAAO,CAAC,CAAC,CAAC,YAAY,MAAM;aAGpD,CAAC,aAAa,MAAM,OAAO,CAAC,CAAC,CAAC,YAAY,MAAM;YAGjD,CAAC,aAAa,MAAM,OAAO,CAAC,CAAC,CAAC,YAAY,MAAM;gBAG5C,CAAC,aAAa,MAAM,OAAO,CAAC,CAAC,CAAC,YAAY,MAAM;CAE7D,CAAC"}

package/dist/utils/prismaWrapper.js

@@ -0,0 +1,64 @@
+import { TRPCError } from '@trpc/server';
+import { handlePrismaError } from './prismaErrorHandler';
+export async function withPrismaErrorHandling(operation, context = 'database operation') {
+    try {
+        return await operation();
+    }
+    catch (error) {
+        const prismaErrorInfo = handlePrismaError(error);
+        // Log the detailed error for debugging
+        console.error(`Prisma error in ${context}:`, {
+            userMessage: prismaErrorInfo.message,
+            details: prismaErrorInfo.details,
+            code: prismaErrorInfo.code,
+            meta: prismaErrorInfo.meta,
+            originalError: error
+        });
+        // Throw a tRPC error with the user-friendly message
+        throw new TRPCError({
+            code: getTRPCCode(prismaErrorInfo.code),
+            message: prismaErrorInfo.message,
+            cause: error
+        });
+    }
+}
+function getTRPCCode(prismaCode) {
+    if (!prismaCode)
+        return 'INTERNAL_SERVER_ERROR';
+    // Map Prisma error codes to tRPC error codes
+    const codeMap = {
+        'P2002': 'CONFLICT', // Unique constraint violation
+        'P2003': 'BAD_REQUEST', // Foreign key constraint violation
+        'P2025': 'NOT_FOUND', // Record not found
+        'P2014': 'BAD_REQUEST', // Required relation violation
+        'P2011': 'BAD_REQUEST', // Null constraint violation
+        'P2012': 'BAD_REQUEST', // Data validation error
+        'P2013': 'BAD_REQUEST', // String length constraint violation
+        'P2015': 'NOT_FOUND', // Record not found
+        'P2016': 'BAD_REQUEST', // Query interpretation error
+        'P2017': 'BAD_REQUEST', // Relation connection error
+        'P2018': 'NOT_FOUND', // Connected record not found
+        'P2019': 'BAD_REQUEST', // Input error
+        'P2020': 'BAD_REQUEST', // Value out of range
+        'P2021': 'INTERNAL_SERVER_ERROR', // Table does not exist
+        'P2022': 'INTERNAL_SERVER_ERROR', // Column does not exist
+        'P2023': 'BAD_REQUEST', // Column data validation error
+        'P2024': 'INTERNAL_SERVER_ERROR', // Connection pool timeout
+        'P2026': 'INTERNAL_SERVER_ERROR', // Feature not supported
+        'P2027': 'INTERNAL_SERVER_ERROR', // Multiple errors
+    };
+    return codeMap[prismaCode] || 'INTERNAL_SERVER_ERROR';
+}
+// Convenience functions for common operations
+export const prismaWrapper = {
+    findUnique: (operation, context) => withPrismaErrorHandling(operation, context),
+    findFirst: (operation, context) => withPrismaErrorHandling(operation, context),
+    findMany: (operation, context) => withPrismaErrorHandling(operation, context),
+    create: (operation, context) => withPrismaErrorHandling(operation, context),
+    update: (operation, context) => withPrismaErrorHandling(operation, context),
+    delete: (operation, context) => withPrismaErrorHandling(operation, context),
+    deleteMany: (operation, context) => withPrismaErrorHandling(operation, context),
+    upsert: (operation, context) => withPrismaErrorHandling(operation, context),
+    count: (operation, context) => withPrismaErrorHandling(operation, context),
+    aggregate: (operation, context) => withPrismaErrorHandling(operation, context),
+};

package/package.json

@@ -1,15 +1,24 @@
 {
   "name": "@studious-lms/server",
-  "version": "1.0.4",
+  "version": "1.0.7",
   "description": "Backend server for Studious application",
   "main": "dist/exportType.js",
   "types": "dist/exportType.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/exportType.d.ts",
+      "default": "./dist/exportType.js"
+    }
+  },
   "scripts": {
-    "dev": "ts-node-dev -r tsconfig-paths/register --respawn --transpile-only src/index.ts",
+    "dev": "ts-node-dev --respawn --transpile-only --loader ts-node/esm src/index.ts",
     "build": "tsc",
     "start": "node dist/index.js",
     "generate": "npx prisma generate",
-    "prepublishOnly": "npm run generate && npm run build"
+    "prepublishOnly": "npm run generate && npm run build",
+    "test": "vitest",
+    "seed": "ts-node src/seedDatabase.ts"
   },
   "dependencies": {
     "@google-cloud/storage": "^7.16.0",
@@ -23,6 +32,7 @@
     "nodemailer": "^7.0.4",
     "prisma": "^6.7.0",
     "sharp": "^0.34.2",
+    "socket.io": "^4.8.1",
     "superjson": "^2.2.2",
     "uuid": "^11.1.0",
     "zod": "^3.22.4"
@@ -32,10 +42,13 @@
     "@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",
+    "supertest": "^7.1.4",
     "ts-node": "^10.9.2",
     "ts-node-dev": "^2.0.0",
     "tsconfig-paths": "^4.2.0",
-    "typescript": "^5.3.3"
+    "typescript": "^5.3.3",
+    "vitest": "^3.2.4"
   }
 }