@valentine-efagene/qshelter-common 2.0.149 → 2.0.150

package/dist/src/middleware/error-handler.d.ts

@@ -1,6 +1,6 @@
 import { Request, Response, NextFunction } from 'express';
 /**
  * Global error handler middleware for Express applications.
- * Handles ZodError, AppError, and generic errors with appropriate responses.
+ * Handles ZodError, AppError, Prisma errors, and generic errors with appropriate responses.
  */
 export declare function errorHandler(err: Error, req: Request, res: Response, next: NextFunction): Response<any, Record<string, any>>;

package/dist/src/middleware/error-handler.js

@@ -1,10 +1,83 @@
 import { ZodError } from 'zod';
 import { AppError } from '../utils/errors';
+/**
+ * Extract a user-friendly field name from Prisma's target array.
+ * Handles composite unique constraints like `tenantId_cacNumber`.
+ */
+function extractFieldName(target) {
+    // Filter out common fields that are not user-facing
+    const userFacingFields = target.filter((f) => !['tenantId', 'id', 'createdAt', 'updatedAt'].includes(f));
+    if (userFacingFields.length === 0) {
+        // Fallback: use the last target field and make it readable
+        const lastField = target[target.length - 1];
+        return lastField.replace(/([A-Z])/g, ' $1').trim().toLowerCase();
+    }
+    // Convert camelCase to readable format
+    return userFacingFields
+        .map((f) => f.replace(/([A-Z])/g, ' $1').trim().toLowerCase())
+        .join(', ');
+}
+/**
+ * Handle Prisma-specific errors with user-friendly messages.
+ */
+function handlePrismaError(err) {
+    // Check if this is a Prisma error (has code property)
+    if (!err.code || typeof err.code !== 'string' || !err.code.startsWith('P')) {
+        return null;
+    }
+    switch (err.code) {
+        case 'P2002': {
+            // Unique constraint violation
+            const target = err.meta?.target;
+            const modelName = err.meta?.modelName;
+            if (target && target.length > 0) {
+                const fieldName = extractFieldName(target);
+                const entity = modelName || 'Record';
+                return {
+                    statusCode: 409,
+                    message: `A ${entity.toLowerCase()} with this ${fieldName} already exists`,
+                };
+            }
+            return {
+                statusCode: 409,
+                message: 'A record with these values already exists',
+            };
+        }
+        case 'P2003': {
+            // Foreign key constraint violation
+            const field = err.meta?.field_name;
+            return {
+                statusCode: 400,
+                message: field
+                    ? `Referenced ${field.replace(/([A-Z])/g, ' $1').trim().toLowerCase()} does not exist`
+                    : 'Referenced record does not exist',
+            };
+        }
+        case 'P2025': {
+            // Record not found for update/delete
+            return {
+                statusCode: 404,
+                message: 'Record not found',
+            };
+        }
+        case 'P2014': {
+            // Required relation violation
+            return {
+                statusCode: 400,
+                message: 'This operation would violate a required relation',
+            };
+        }
+        default:
+            // Unknown Prisma error - log it but return generic message
+            return null;
+    }
+}
 /**
  * Global error handler middleware for Express applications.
- * Handles ZodError, AppError, and generic errors with appropriate responses.
+ * Handles ZodError, AppError, Prisma errors, and generic errors with appropriate responses.
  */
 export function errorHandler(err, req, res, next) {
+    // Handle Zod validation errors
     if (err instanceof ZodError) {
         return res.status(400).json({
             success: false,
@@ -13,6 +86,7 @@ export function errorHandler(err, req, res, next) {
             details: err.issues,
         });
     }
+    // Handle custom application errors
     if (err instanceof AppError) {
         return res.status(err.statusCode).json({
             success: false,
@@ -20,6 +94,16 @@ export function errorHandler(err, req, res, next) {
             error: err.message,
         });
     }
+    // Handle Prisma errors
+    const prismaError = handlePrismaError(err);
+    if (prismaError) {
+        return res.status(prismaError.statusCode).json({
+            success: false,
+            message: prismaError.message,
+            error: prismaError.message,
+        });
+    }
+    // Unhandled error - log and return generic message
     console.error('Unhandled error:', err);
     return res.status(500).json({
         success: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valentine-efagene/qshelter-common",
-  "version": "2.0.149",
+  "version": "2.0.150",
   "description": "Shared database schemas and utilities for QShelter services",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",