@erangamadhushan/express-advanced-error-kit 1.3.0 → 1.4.1

package/README.md

@@ -3,30 +3,32 @@
 Advanced TypeScript-based error handling middleware for Express.js.
 
 ![npm version](https://img.shields.io/npm/v/@erangamadhushan/express-advanced-error-kit)
-![npm downloads](https://img.shields.io/npm/dm/@erangamadhusha/express-advanced-error-kit)
-
-![CI](https://github.com/Erangamadhushan/express-advanced-error-kit/actions/workflows/ci.yml/badge.svg)
+![npm downloads](https://img.shields.io/npm/dm/@erangamadhushan/express-advanced-error-kit)
 
+---
 
-## Features
+## ✨ Features
 
 - Async handler wrapper
-- Custom ApiError class
+- Custom `ApiError` class
 - Global error middleware
-- 404 not found middleware
-- Production-safe stack hiding
+- 404 Not Found middleware
+- Logger integration (Pino, Winston, custom)
+- MongoDB duplicate key smart parsing
+- Zod validation error formatting
+- Production-safe stack handling
 - ESM + CommonJS support
-- Full TypeScript definitions
+- Full TypeScript support
 
 ---
 
-## Installation
+## 📦 Installation
 
 ```bash
 npm install @erangamadhushan/express-advanced-error-kit
 ```
 
-## Usage
+# 🚀 Quick Start
 
 ```ts
 import express from "express";
@@ -34,46 +36,116 @@ import {
   asyncHandler,
   ApiError,
   notFoundMiddleware,
-  errorMiddleware
+  errorMiddleware,
 } from "@erangamadhushan/express-advanced-error-kit";
 
 const app = express();
+app.use(express.json());
 
 app.get(
   "/error",
   asyncHandler(async () => {
     throw new ApiError("Something went wrong", 400);
-  })
+  }),
 );
 
 app.use(notFoundMiddleware);
-app.use(errorMiddleware);
+app.use(errorMiddleware());
 
 app.listen(5000);
+```
+
+# 🧠 Smart MongoDB Error Handling
+
+## Duplicate key errors are automatically formatted:
+
+```ts
+// Mongo duplicate key error
+{
+  code: 11000,
+  keyValue: { email: "test@example.com" }
+}
+```
 
+Response:
+
+```json
+{
+  "success": false,
+  "message": "email already exists"
+}
+```
+
+# 🧾 Zod Validation Formatting
+
+If using Zod:
+
+```ts
+throw new ZodError([...]);
 ```
 
-# Features
+Response:
+
+```json
+{
+  "success": false,
+  "message": "email: Invalid email"
+}
+```
 
-## Logger Integration (Production-Ready)
+# 🪵 Logger Integration
 
-### Usage Example
+Use any logger:
 
 ```ts
 import pino from "pino";
+
 const logger = pino();
 
 app.use(
   errorMiddleware({
     logger: logger.error.bind(logger),
-    showStack: true
-  })
+    showStack: false,
+  }),
 );
 ```
 
-### Now it supports:
+# 📚 Middleware Order (Important)
+
+```js
+app.use(routes);
+........
+........
+app.use(notFoundMiddleware);
+app.use(errorMiddleware());
+```
+
+# 🧩 Creating Custom Errors
+
+```ts
+throw new ApiError(404, "User not found");
+```
+
+Also You can extend it:
+```ts
+class ValidationError extends ApiError {
+  constructor(message: string) {
+    super(400, message);
+  }
+}
+```
+
+# ⚙️ Configuration Options
+```ts
+errorMiddleware({
+  logger?: (error: any) => void;
+  showStack?: boolean;
+});
+```
+
+# 🛡 Production Behavior
+
+- Stack traces hidden automatically in production
+- Clean JSON response format
+- Centralized error control
 
-- console
-- winston
-- pino
-- custom logger

package/dist/index.cjs

@@ -69,11 +69,23 @@ var errorMiddleware = (options = {}) => (err, req, res, next) => {
     }
     return null;
   };
+  const handleZodError = (err2) => {
+    if ((err2 == null ? void 0 : err2.name) === "ZodError") {
+      const message2 = err2.errors.map((e) => `${e.path.join(".")}: ${e.message}`).join(", ");
+      return new ApiError(400, message2);
+    }
+    return null;
+  };
   const mongoError = handleMongoError(err);
   if (mongoError) {
     statusCode = mongoError.statusCode;
     message = mongoError.message;
   }
+  const zodError = handleZodError(err);
+  if (zodError) {
+    statusCode = zodError.statusCode;
+    message = zodError.message;
+  }
   res.status(statusCode).json({
     success: false,
     statusCode,

package/dist/index.js

@@ -40,11 +40,23 @@ var errorMiddleware = (options = {}) => (err, req, res, next) => {
     }
     return null;
   };
+  const handleZodError = (err2) => {
+    if ((err2 == null ? void 0 : err2.name) === "ZodError") {
+      const message2 = err2.errors.map((e) => `${e.path.join(".")}: ${e.message}`).join(", ");
+      return new ApiError(400, message2);
+    }
+    return null;
+  };
   const mongoError = handleMongoError(err);
   if (mongoError) {
     statusCode = mongoError.statusCode;
     message = mongoError.message;
   }
+  const zodError = handleZodError(err);
+  if (zodError) {
+    statusCode = zodError.statusCode;
+    message = zodError.message;
+  }
   res.status(statusCode).json({
     success: false,
     statusCode,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@erangamadhushan/express-advanced-error-kit",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "description": "Advanced TypeScript error handling middleware for Express applications.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -29,6 +29,9 @@
     "url": "https://github.com/Erangamadhushan/express-advanced-error-kit/issues"
   },
   "homepage": "https://github.com/Erangamadhushan/express-advanced-error-kit#readme",
+  "peerDependencies": {
+    "zod": "^4.3.6"
+  },
   "devDependencies": {
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
@@ -44,6 +47,10 @@
     "supertest": "^7.2.2",
     "ts-jest": "^29.4.6",
     "tsup": "^8.5.1",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "zod": "^4.3.6"
+  },
+  "dependencies": {
+    "zod": "^4.3.6"
   }
 }