@erangamadhushan/express-advanced-error-kit 1.0.0

package/README.md

@@ -0,0 +1,48 @@
+# express-advanced-error-kit
+
+Advanced TypeScript-based error handling middleware for Express.js.
+
+## Features
+
+- Async handler wrapper
+- Custom ApiError class
+- Global error middleware
+- 404 not found middleware
+- Production-safe stack hiding
+- ESM + CommonJS support
+- Full TypeScript definitions
+
+---
+
+## Installation
+
+```bash
+npm install express-advanced-error-kit
+```
+
+## Usage
+
+```ts
+import express from "express";
+import {
+  asyncHandler,
+  ApiError,
+  notFoundMiddleware,
+  errorMiddleware
+} from "express-advanced-error-kit";
+
+const app = express();
+
+app.get(
+  "/error",
+  asyncHandler(async () => {
+    throw new ApiError("Something went wrong", 400);
+  })
+);
+
+app.use(notFoundMiddleware);
+app.use(errorMiddleware);
+
+app.listen(5000);
+
+```

package/dist/index.cjs

@@ -0,0 +1,78 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ApiError: () => ApiError,
+  asyncHandler: () => asyncHandler,
+  errorMiddleware: () => errorMiddleware,
+  notFoundMiddleware: () => notFoundMiddleware
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/asyncHandler.ts
+var asyncHandler = (fn) => {
+  return (req, res, next) => {
+    Promise.resolve(fn(req, res, next)).catch(next);
+  };
+};
+
+// src/ApiError.ts
+var ApiError = class extends Error {
+  constructor(statusCode, message, isOperational = true) {
+    super(message);
+    this.statusCode = statusCode;
+    this.isOperational = isOperational;
+    Object.setPrototypeOf(this, new.target.prototype);
+    Error.captureStackTrace(this, this.constructor);
+  }
+};
+
+// src/errorMiddleware.ts
+var errorMiddleware = (err, req, res, next) => {
+  let statusCode = err.statusCode || 500;
+  let message = err.message || "Internal Server Error";
+  if (err instanceof ApiError) {
+    statusCode = err.statusCode || 500;
+    message = err.message || "Internal Server Error";
+  }
+  const isProduction = process.env.NODE_ENV === "production";
+  if (isProduction && statusCode === 500) {
+    message = "Internal Server Error";
+  }
+  res.status(statusCode).json({
+    success: false,
+    statusCode,
+    message,
+    ...isProduction ? {} : { stack: err.stack }
+  });
+};
+
+// src/notFoundMiddleware.ts
+var notFoundMiddleware = (req, res, next) => {
+  next(new ApiError(404, `Route ${req.originalUrl} not found`));
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ApiError,
+  asyncHandler,
+  errorMiddleware,
+  notFoundMiddleware
+});

package/dist/index.d.cts

@@ -0,0 +1,15 @@
+import { Request, Response, NextFunction } from 'express';
+
+declare const asyncHandler: (fn: (req: Request, res: Response, next: NextFunction) => Promise<any>) => (req: Request, res: Response, next: NextFunction) => void;
+
+declare class ApiError extends Error {
+    statusCode: number;
+    isOperational: boolean;
+    constructor(statusCode: number, message: string, isOperational?: boolean);
+}
+
+declare const errorMiddleware: (err: any, req: Request, res: Response, next: NextFunction) => void;
+
+declare const notFoundMiddleware: (req: Request, res: Response, next: NextFunction) => void;
+
+export { ApiError, asyncHandler, errorMiddleware, notFoundMiddleware };

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+import { Request, Response, NextFunction } from 'express';
+
+declare const asyncHandler: (fn: (req: Request, res: Response, next: NextFunction) => Promise<any>) => (req: Request, res: Response, next: NextFunction) => void;
+
+declare class ApiError extends Error {
+    statusCode: number;
+    isOperational: boolean;
+    constructor(statusCode: number, message: string, isOperational?: boolean);
+}
+
+declare const errorMiddleware: (err: any, req: Request, res: Response, next: NextFunction) => void;
+
+declare const notFoundMiddleware: (req: Request, res: Response, next: NextFunction) => void;
+
+export { ApiError, asyncHandler, errorMiddleware, notFoundMiddleware };

package/dist/index.js

@@ -0,0 +1,48 @@
+// src/asyncHandler.ts
+var asyncHandler = (fn) => {
+  return (req, res, next) => {
+    Promise.resolve(fn(req, res, next)).catch(next);
+  };
+};
+
+// src/ApiError.ts
+var ApiError = class extends Error {
+  constructor(statusCode, message, isOperational = true) {
+    super(message);
+    this.statusCode = statusCode;
+    this.isOperational = isOperational;
+    Object.setPrototypeOf(this, new.target.prototype);
+    Error.captureStackTrace(this, this.constructor);
+  }
+};
+
+// src/errorMiddleware.ts
+var errorMiddleware = (err, req, res, next) => {
+  let statusCode = err.statusCode || 500;
+  let message = err.message || "Internal Server Error";
+  if (err instanceof ApiError) {
+    statusCode = err.statusCode || 500;
+    message = err.message || "Internal Server Error";
+  }
+  const isProduction = process.env.NODE_ENV === "production";
+  if (isProduction && statusCode === 500) {
+    message = "Internal Server Error";
+  }
+  res.status(statusCode).json({
+    success: false,
+    statusCode,
+    message,
+    ...isProduction ? {} : { stack: err.stack }
+  });
+};
+
+// src/notFoundMiddleware.ts
+var notFoundMiddleware = (req, res, next) => {
+  next(new ApiError(404, `Route ${req.originalUrl} not found`));
+};
+export {
+  ApiError,
+  asyncHandler,
+  errorMiddleware,
+  notFoundMiddleware
+};

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@erangamadhushan/express-advanced-error-kit",
+  "version": "1.0.0",
+  "description": "Advanced TypeScript error handling middleware for Express applications.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Erangamadhushan/express-advanced-error-kit.git"
+  },
+  "keywords": [
+    "express",
+    "middleware",
+    "error-handler",
+    "typescript"
+  ],
+  "author": "Eranga Madhushan",
+  "license": "MIT",
+  "type": "module",
+  "bugs": {
+    "url": "https://github.com/Erangamadhushan/express-advanced-error-kit/issues"
+  },
+  "homepage": "https://github.com/Erangamadhushan/express-advanced-error-kit#readme",
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  }
+}