nexus-backend 1.0.0

package/README.md

@@ -0,0 +1,288 @@
+# Nexus Backend
+
+A lightweight backend utility library for [Express.js](https://expressjs.com/) providing structured error classes, standardised API response helpers, and a plug-and-play error handling middleware.
+
+---
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [API Reference](#api-reference)
+  - [Response Helpers](#response-helpers)
+  - [Error Classes](#error-classes)
+  - [Error Middleware](#error-middleware)
+- [Response Shape](#response-shape)
+- [TypeScript](#typescript)
+- [License](#license)
+
+---
+
+## Installation
+
+```bash
+npm install nexus-backend
+```
+
+Express is a peer dependency — make sure it is installed in your project:
+
+```bash
+npm install express
+```
+
+---
+
+## Quick Start
+
+```ts
+import express from "express";
+import {
+  successResponse,
+  errorMiddleware,
+  NotFoundError,
+  ValidationError,
+} from "nexusjs";
+
+const app = express();
+app.use(express.json());
+
+// Example route
+app.get("/users/:id", async (req, res, next) => {
+  try {
+    const user = await getUserById(req.params.id);
+
+    if (!user) {
+      throw new NotFoundError("User not found");
+    }
+
+    res.json(successResponse(user, "User fetched successfully"));
+  } catch (err) {
+    next(err);
+  }
+});
+
+// Register error middleware last
+app.use(errorMiddleware);
+
+app.listen(3000);
+```
+
+---
+
+## API Reference
+
+### Response Helpers
+
+#### `successResponse(data, message?)`
+
+Returns a structured success payload. Pass the result directly to `res.json()`.
+
+```ts
+successResponse<T>(data: T, message?: string): SuccessResponse<T>
+```
+
+**Example**
+
+```ts
+res.status(200).json(
+  successResponse({ id: 1, name: "Alice" }, "User fetched successfully")
+);
+```
+
+```json
+{
+  "success": true,
+  "message": "User fetched successfully",
+  "data": { "id": 1, "name": "Alice" }
+}
+```
+
+---
+
+#### `errorResponse(message, errors?, stack?)`
+
+Returns a structured error payload. You will rarely call this directly — `errorMiddleware` calls it internally. Useful if you need to construct an error response manually.
+
+```ts
+errorResponse(message: string, errors?: any, stack?: string): ErrorResponse
+```
+
+**Example**
+
+```ts
+res.status(400).json(
+  errorResponse("Validation failed", { field: "email", issue: "Required" })
+);
+```
+
+```json
+{
+  "success": false,
+  "message": "Validation failed",
+  "errors": { "field": "email", "issue": "Required" }
+}
+```
+
+---
+
+### Error Classes
+
+All error classes extend the base `ApiError` class, which itself extends the native `Error`. Throw any of these inside a route and let `errorMiddleware` handle the rest.
+
+#### `ApiError`
+
+The base error class. Use this when none of the specific subclasses fit your use case.
+
+```ts
+new ApiError(message: string, statusCode?: number, errors?: any, isOperational?: boolean)
+```
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `message` | `string` | — | Human-readable error message |
+| `statusCode` | `number` | `500` | HTTP status code |
+| `errors` | `any` | `undefined` | Additional error details or field errors |
+| `isOperational` | `boolean` | `true` | Marks the error as an expected operational error |
+
+---
+
+#### `BadRequestError`
+
+**Status:** `400 Bad Request`
+
+Use when the client sends a malformed or invalid request.
+
+```ts
+throw new BadRequestError("Invalid request body");
+```
+
+---
+
+#### `UnauthorizedError`
+
+**Status:** `401 Unauthorized`
+
+Use when authentication is missing or invalid.
+
+```ts
+throw new UnauthorizedError("Invalid token");
+```
+
+---
+
+#### `ForbiddenError`
+
+**Status:** `403 Forbidden`
+
+Use when an authenticated user lacks permission to access a resource.
+
+```ts
+throw new ForbiddenError("You do not have access to this resource");
+```
+
+---
+
+#### `NotFoundError`
+
+**Status:** `404 Not Found`
+
+Use when a requested resource does not exist.
+
+```ts
+throw new NotFoundError("Post not found");
+```
+
+---
+
+#### `ValidationError`
+
+**Status:** `422 Unprocessable Entity`
+
+Use when request data fails validation. Pass field-level errors via the `errors` argument.
+
+```ts
+throw new ValidationError("Validation failed", [
+  { field: "email", message: "Must be a valid email address" },
+  { field: "password", message: "Must be at least 8 characters" },
+]);
+```
+
+---
+
+### Error Middleware
+
+#### `errorMiddleware`
+
+An Express-compatible error handling middleware. It catches any error passed to `next(err)`, determines the appropriate HTTP status code and message, and sends a structured `ErrorResponse`.
+
+Register it **after all routes** and other middleware.
+
+```ts
+import { errorMiddleware } from "nexusjs";
+
+app.use(errorMiddleware);
+```
+
+**Behaviour**
+
+- If the error is an instance of `ApiError` (or any subclass), the middleware uses the error's own `statusCode` and `message`.
+- For all other unhandled errors, it falls back to `500 Internal Server Error`.
+- When `NODE_ENV` is set to `"development"`, the response includes a `stack` field with the full stack trace to aid debugging. The `stack` field is omitted in production.
+
+**Development response example**
+
+```json
+{
+  "success": false,
+  "message": "User not found",
+  "errors": null,
+  "stack": "NotFoundError: User not found\n    at ..."
+}
+```
+
+---
+
+## Response Shape
+
+All responses follow a consistent structure.
+
+#### Success
+
+```ts
+interface SuccessResponse<T> {
+  success: true;
+  message?: string;
+  data: T;
+}
+```
+
+#### Error
+
+```ts
+interface ErrorResponse {
+  success: false;
+  message: string;
+  errors?: any;
+  stack?: string; // only present in development
+}
+```
+
+---
+
+## TypeScript
+
+nexusjs is written in TypeScript and ships with type declarations out of the box. No `@types` package is needed.
+
+`SuccessResponse` and `ErrorResponse` are exported and can be used to type your own response wrappers or API clients:
+
+```ts
+import type { SuccessResponse, ErrorResponse } from "nexusjs";
+
+type ApiResult<T> = SuccessResponse<T> | ErrorResponse;
+```
+
+---
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,48 @@
+import { Request, Response, NextFunction } from 'express';
+
+interface SuccessResponse<T = any> {
+    success: true;
+    message?: string;
+    data: T;
+}
+interface ErrorResponse {
+    success: false;
+    message: string;
+    errors?: any;
+    stack?: string;
+}
+
+declare const successResponse: <T>(data: T, message?: string) => SuccessResponse<T>;
+
+declare const errorResponse: (message: string, errors?: any, stack?: string) => ErrorResponse;
+
+declare class ApiError extends Error {
+    statusCode: number;
+    isOperational: boolean;
+    errors?: any;
+    constructor(message: string, statusCode?: number, errors?: any, isOperational?: boolean);
+}
+
+declare class BadRequestError extends ApiError {
+    constructor(message?: string, errors?: any);
+}
+
+declare class UnauthorizedError extends ApiError {
+    constructor(message?: string, errors?: any);
+}
+
+declare class ForbiddenError extends ApiError {
+    constructor(message?: string, errors?: any);
+}
+
+declare class NotFoundError extends ApiError {
+    constructor(message?: string, errors?: any);
+}
+
+declare class ValidationError extends ApiError {
+    constructor(message?: string, errors?: any);
+}
+
+declare const errorHandler: (err: any, req: Request, res: Response, next: NextFunction) => Response<any, Record<string, any>>;
+
+export { ApiError, BadRequestError, type ErrorResponse, ForbiddenError, NotFoundError, type SuccessResponse, UnauthorizedError, ValidationError, errorHandler as errorMiddleware, errorResponse, successResponse };

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+import { Request, Response, NextFunction } from 'express';
+
+interface SuccessResponse<T = any> {
+    success: true;
+    message?: string;
+    data: T;
+}
+interface ErrorResponse {
+    success: false;
+    message: string;
+    errors?: any;
+    stack?: string;
+}
+
+declare const successResponse: <T>(data: T, message?: string) => SuccessResponse<T>;
+
+declare const errorResponse: (message: string, errors?: any, stack?: string) => ErrorResponse;
+
+declare class ApiError extends Error {
+    statusCode: number;
+    isOperational: boolean;
+    errors?: any;
+    constructor(message: string, statusCode?: number, errors?: any, isOperational?: boolean);
+}
+
+declare class BadRequestError extends ApiError {
+    constructor(message?: string, errors?: any);
+}
+
+declare class UnauthorizedError extends ApiError {
+    constructor(message?: string, errors?: any);
+}
+
+declare class ForbiddenError extends ApiError {
+    constructor(message?: string, errors?: any);
+}
+
+declare class NotFoundError extends ApiError {
+    constructor(message?: string, errors?: any);
+}
+
+declare class ValidationError extends ApiError {
+    constructor(message?: string, errors?: any);
+}
+
+declare const errorHandler: (err: any, req: Request, res: Response, next: NextFunction) => Response<any, Record<string, any>>;
+
+export { ApiError, BadRequestError, type ErrorResponse, ForbiddenError, NotFoundError, type SuccessResponse, UnauthorizedError, ValidationError, errorHandler as errorMiddleware, errorResponse, successResponse };

package/dist/index.js

@@ -0,0 +1,132 @@
+"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,
+  BadRequestError: () => BadRequestError,
+  ForbiddenError: () => ForbiddenError,
+  NotFoundError: () => NotFoundError,
+  UnauthorizedError: () => UnauthorizedError,
+  ValidationError: () => ValidationError,
+  errorMiddleware: () => errorHandler_default,
+  errorResponse: () => errorResponse,
+  successResponse: () => successResponse
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/responses/successResponse.ts
+var successResponse = (data, message) => ({
+  success: true,
+  data,
+  message
+});
+
+// src/responses/errorResponse.ts
+var errorResponse = (message, errors, stack) => ({
+  success: false,
+  message,
+  errors,
+  stack
+});
+
+// src/errors/ApiError.ts
+var ApiError = class extends Error {
+  constructor(message, statusCode = 500, errors, isOperational = true) {
+    super(message);
+    this.statusCode = statusCode;
+    this.errors = errors;
+    this.isOperational = isOperational;
+    Error.captureStackTrace(this, this.constructor);
+  }
+};
+
+// src/errors/BadRequestError.ts
+var BadRequestError = class extends ApiError {
+  constructor(message = "Bad Request", errors) {
+    super(message, 400, errors);
+  }
+};
+
+// src/errors/UnauthorisedError.ts
+var UnauthorizedError = class extends ApiError {
+  constructor(message = "Unauthorized", errors) {
+    super(message, 401, errors);
+  }
+};
+
+// src/errors/ForbiddenError.ts
+var ForbiddenError = class extends ApiError {
+  constructor(message = "Forbidden", errors) {
+    super(message, 403, errors);
+  }
+};
+
+// src/errors/NotFoundError.ts
+var NotFoundError = class extends ApiError {
+  constructor(message = "Resource Not Found", errors) {
+    super(message, 404, errors);
+  }
+};
+
+// src/errors/ValidationError.ts
+var ValidationError = class extends ApiError {
+  constructor(message = "Validation Failed", errors) {
+    super(message, 422, errors);
+  }
+};
+
+// src/handlers/errorHandler.ts
+var errorHandler = (err, req, res, next) => {
+  console.error("Error:", err);
+  let statusCode = 500;
+  let message = "Internal Server Error";
+  let errors = void 0;
+  let stack = void 0;
+  if (err instanceof ApiError) {
+    statusCode = err.statusCode;
+    message = err.message;
+    errors = err.errors;
+  }
+  if (process.env.NODE_ENV === "development") {
+    stack = err.stack;
+  }
+  return res.status(statusCode).json(
+    errorResponse(
+      message,
+      errors,
+      stack
+    )
+  );
+};
+var errorHandler_default = errorHandler;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ApiError,
+  BadRequestError,
+  ForbiddenError,
+  NotFoundError,
+  UnauthorizedError,
+  ValidationError,
+  errorMiddleware,
+  errorResponse,
+  successResponse
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/responses/successResponse.ts","../src/responses/errorResponse.ts","../src/errors/ApiError.ts","../src/errors/BadRequestError.ts","../src/errors/UnauthorisedError.ts","../src/errors/ForbiddenError.ts","../src/errors/NotFoundError.ts","../src/errors/ValidationError.ts","../src/handlers/errorHandler.ts"],"sourcesContent":["export { successResponse } from \"./responses/successResponse\";\r\nexport { errorResponse } from \"./responses/errorResponse\";\r\n\r\nexport { default as ApiError } from \"./errors/ApiError\";\r\nexport { default as BadRequestError } from \"./errors/BadRequestError\";\r\nexport { default as UnauthorizedError } from \"./errors/UnauthorisedError\";\r\nexport { default as ForbiddenError } from \"./errors/ForbiddenError\";\r\nexport { default as NotFoundError } from \"./errors/NotFoundError\";\r\nexport { default as ValidationError } from \"./errors/ValidationError\";\r\n\r\nexport { default as errorMiddleware } from \"./handlers/errorHandler\";\r\n\r\nexport type {\r\n  SuccessResponse,\r\n  ErrorResponse,\r\n} from \"./types/response.types\";","import { SuccessResponse } from \"../types/response.types\";\r\n\r\nexport const successResponse = <T>(\r\n  data: T,\r\n  message?: string\r\n): SuccessResponse<T> => ({\r\n  success: true,\r\n  data,\r\n  message,\r\n});","import { ErrorResponse } from \"../types/response.types\";\r\n\r\nexport const errorResponse = (\r\n  message: string,\r\n  errors?: any,\r\n  stack?: string\r\n): ErrorResponse => ({\r\n  success: false,\r\n  message,\r\n  errors,\r\n  stack,\r\n});","export default class ApiError extends Error {\r\n  statusCode: number;\r\n  isOperational: boolean;\r\n  errors?: any;\r\n\r\n  constructor(\r\n    message: string,\r\n    statusCode = 500,\r\n    errors?: any,\r\n    isOperational = true\r\n  ) {\r\n    super(message);\r\n\r\n    this.statusCode = statusCode;\r\n    this.errors = errors;\r\n    this.isOperational = isOperational;\r\n\r\n    Error.captureStackTrace(this, this.constructor);\r\n  }\r\n}","import ApiError from \"./ApiError\";\r\n\r\nexport default class BadRequestError extends ApiError {\r\n  constructor(message = \"Bad Request\", errors?: any) {\r\n    super(message, 400, errors);\r\n  }\r\n}","import ApiError from \"./ApiError\";\r\n\r\nexport default class UnauthorizedError extends ApiError {\r\n  constructor(message = \"Unauthorized\", errors?: any) {\r\n    super(message, 401, errors);\r\n  }\r\n}","import ApiError from \"./ApiError\";\r\n\r\nexport default class ForbiddenError extends ApiError {\r\n  constructor(message = \"Forbidden\", errors?: any) {\r\n    super(message, 403, errors);\r\n  }\r\n}","import ApiError from \"./ApiError\";\r\n\r\nexport default class NotFoundError extends ApiError {\r\n  constructor(message = \"Resource Not Found\", errors?: any) {\r\n    super(message, 404, errors);\r\n  }\r\n}","import ApiError from \"./ApiError\";\r\n\r\nexport default class ValidationError extends ApiError {\r\n  constructor(message = \"Validation Failed\", errors?: any) {\r\n    super(message, 422, errors);\r\n  }\r\n}","import { Request, Response, NextFunction } from \"express\";\r\n\r\nimport ApiError from \"../errors/ApiError\";\r\nimport { errorResponse } from \"../responses/errorResponse\";\r\n\r\nconst errorHandler = (\r\n  err: any,\r\n  req: Request,\r\n  res: Response,\r\n  next: NextFunction\r\n) => {\r\n\r\n  console.error(\"Error:\", err);\r\n\r\n  let statusCode = 500;\r\n  let message = \"Internal Server Error\";\r\n  let errors = undefined;\r\n  let stack = undefined;\r\n\r\n  // Custom application errors\r\n  if (err instanceof ApiError) {\r\n    statusCode = err.statusCode;\r\n    message = err.message;\r\n    errors = err.errors;\r\n  }\r\n\r\n  // Development stack trace\r\n  if (process.env.NODE_ENV === \"development\") {\r\n    stack = err.stack;\r\n  }\r\n\r\n  return res.status(statusCode).json(\r\n    errorResponse(\r\n      message,\r\n      errors,\r\n      stack\r\n    )\r\n  );\r\n};\r\n\r\nexport default errorHandler;"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEO,IAAM,kBAAkB,CAC7B,MACA,aACwB;AAAA,EACxB,SAAS;AAAA,EACT;AAAA,EACA;AACF;;;ACPO,IAAM,gBAAgB,CAC3B,SACA,QACA,WACmB;AAAA,EACnB,SAAS;AAAA,EACT;AAAA,EACA;AAAA,EACA;AACF;;;ACXA,IAAqB,WAArB,cAAsC,MAAM;AAAA,EAK1C,YACE,SACA,aAAa,KACb,QACA,gBAAgB,MAChB;AACA,UAAM,OAAO;AAEb,SAAK,aAAa;AAClB,SAAK,SAAS;AACd,SAAK,gBAAgB;AAErB,UAAM,kBAAkB,MAAM,KAAK,WAAW;AAAA,EAChD;AACF;;;ACjBA,IAAqB,kBAArB,cAA6C,SAAS;AAAA,EACpD,YAAY,UAAU,eAAe,QAAc;AACjD,UAAM,SAAS,KAAK,MAAM;AAAA,EAC5B;AACF;;;ACJA,IAAqB,oBAArB,cAA+C,SAAS;AAAA,EACtD,YAAY,UAAU,gBAAgB,QAAc;AAClD,UAAM,SAAS,KAAK,MAAM;AAAA,EAC5B;AACF;;;ACJA,IAAqB,iBAArB,cAA4C,SAAS;AAAA,EACnD,YAAY,UAAU,aAAa,QAAc;AAC/C,UAAM,SAAS,KAAK,MAAM;AAAA,EAC5B;AACF;;;ACJA,IAAqB,gBAArB,cAA2C,SAAS;AAAA,EAClD,YAAY,UAAU,sBAAsB,QAAc;AACxD,UAAM,SAAS,KAAK,MAAM;AAAA,EAC5B;AACF;;;ACJA,IAAqB,kBAArB,cAA6C,SAAS;AAAA,EACpD,YAAY,UAAU,qBAAqB,QAAc;AACvD,UAAM,SAAS,KAAK,MAAM;AAAA,EAC5B;AACF;;;ACDA,IAAM,eAAe,CACnB,KACA,KACA,KACA,SACG;AAEH,UAAQ,MAAM,UAAU,GAAG;AAE3B,MAAI,aAAa;AACjB,MAAI,UAAU;AACd,MAAI,SAAS;AACb,MAAI,QAAQ;AAGZ,MAAI,eAAe,UAAU;AAC3B,iBAAa,IAAI;AACjB,cAAU,IAAI;AACd,aAAS,IAAI;AAAA,EACf;AAGA,MAAI,QAAQ,IAAI,aAAa,eAAe;AAC1C,YAAQ,IAAI;AAAA,EACd;AAEA,SAAO,IAAI,OAAO,UAAU,EAAE;AAAA,IAC5B;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAO,uBAAQ;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,97 @@
+// src/responses/successResponse.ts
+var successResponse = (data, message) => ({
+  success: true,
+  data,
+  message
+});
+
+// src/responses/errorResponse.ts
+var errorResponse = (message, errors, stack) => ({
+  success: false,
+  message,
+  errors,
+  stack
+});
+
+// src/errors/ApiError.ts
+var ApiError = class extends Error {
+  constructor(message, statusCode = 500, errors, isOperational = true) {
+    super(message);
+    this.statusCode = statusCode;
+    this.errors = errors;
+    this.isOperational = isOperational;
+    Error.captureStackTrace(this, this.constructor);
+  }
+};
+
+// src/errors/BadRequestError.ts
+var BadRequestError = class extends ApiError {
+  constructor(message = "Bad Request", errors) {
+    super(message, 400, errors);
+  }
+};
+
+// src/errors/UnauthorisedError.ts
+var UnauthorizedError = class extends ApiError {
+  constructor(message = "Unauthorized", errors) {
+    super(message, 401, errors);
+  }
+};
+
+// src/errors/ForbiddenError.ts
+var ForbiddenError = class extends ApiError {
+  constructor(message = "Forbidden", errors) {
+    super(message, 403, errors);
+  }
+};
+
+// src/errors/NotFoundError.ts
+var NotFoundError = class extends ApiError {
+  constructor(message = "Resource Not Found", errors) {
+    super(message, 404, errors);
+  }
+};
+
+// src/errors/ValidationError.ts
+var ValidationError = class extends ApiError {
+  constructor(message = "Validation Failed", errors) {
+    super(message, 422, errors);
+  }
+};
+
+// src/handlers/errorHandler.ts
+var errorHandler = (err, req, res, next) => {
+  console.error("Error:", err);
+  let statusCode = 500;
+  let message = "Internal Server Error";
+  let errors = void 0;
+  let stack = void 0;
+  if (err instanceof ApiError) {
+    statusCode = err.statusCode;
+    message = err.message;
+    errors = err.errors;
+  }
+  if (process.env.NODE_ENV === "development") {
+    stack = err.stack;
+  }
+  return res.status(statusCode).json(
+    errorResponse(
+      message,
+      errors,
+      stack
+    )
+  );
+};
+var errorHandler_default = errorHandler;
+export {
+  ApiError,
+  BadRequestError,
+  ForbiddenError,
+  NotFoundError,
+  UnauthorizedError,
+  ValidationError,
+  errorHandler_default as errorMiddleware,
+  errorResponse,
+  successResponse
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/responses/successResponse.ts","../src/responses/errorResponse.ts","../src/errors/ApiError.ts","../src/errors/BadRequestError.ts","../src/errors/UnauthorisedError.ts","../src/errors/ForbiddenError.ts","../src/errors/NotFoundError.ts","../src/errors/ValidationError.ts","../src/handlers/errorHandler.ts"],"sourcesContent":["import { SuccessResponse } from \"../types/response.types\";\r\n\r\nexport const successResponse = <T>(\r\n  data: T,\r\n  message?: string\r\n): SuccessResponse<T> => ({\r\n  success: true,\r\n  data,\r\n  message,\r\n});","import { ErrorResponse } from \"../types/response.types\";\r\n\r\nexport const errorResponse = (\r\n  message: string,\r\n  errors?: any,\r\n  stack?: string\r\n): ErrorResponse => ({\r\n  success: false,\r\n  message,\r\n  errors,\r\n  stack,\r\n});","export default class ApiError extends Error {\r\n  statusCode: number;\r\n  isOperational: boolean;\r\n  errors?: any;\r\n\r\n  constructor(\r\n    message: string,\r\n    statusCode = 500,\r\n    errors?: any,\r\n    isOperational = true\r\n  ) {\r\n    super(message);\r\n\r\n    this.statusCode = statusCode;\r\n    this.errors = errors;\r\n    this.isOperational = isOperational;\r\n\r\n    Error.captureStackTrace(this, this.constructor);\r\n  }\r\n}","import ApiError from \"./ApiError\";\r\n\r\nexport default class BadRequestError extends ApiError {\r\n  constructor(message = \"Bad Request\", errors?: any) {\r\n    super(message, 400, errors);\r\n  }\r\n}","import ApiError from \"./ApiError\";\r\n\r\nexport default class UnauthorizedError extends ApiError {\r\n  constructor(message = \"Unauthorized\", errors?: any) {\r\n    super(message, 401, errors);\r\n  }\r\n}","import ApiError from \"./ApiError\";\r\n\r\nexport default class ForbiddenError extends ApiError {\r\n  constructor(message = \"Forbidden\", errors?: any) {\r\n    super(message, 403, errors);\r\n  }\r\n}","import ApiError from \"./ApiError\";\r\n\r\nexport default class NotFoundError extends ApiError {\r\n  constructor(message = \"Resource Not Found\", errors?: any) {\r\n    super(message, 404, errors);\r\n  }\r\n}","import ApiError from \"./ApiError\";\r\n\r\nexport default class ValidationError extends ApiError {\r\n  constructor(message = \"Validation Failed\", errors?: any) {\r\n    super(message, 422, errors);\r\n  }\r\n}","import { Request, Response, NextFunction } from \"express\";\r\n\r\nimport ApiError from \"../errors/ApiError\";\r\nimport { errorResponse } from \"../responses/errorResponse\";\r\n\r\nconst errorHandler = (\r\n  err: any,\r\n  req: Request,\r\n  res: Response,\r\n  next: NextFunction\r\n) => {\r\n\r\n  console.error(\"Error:\", err);\r\n\r\n  let statusCode = 500;\r\n  let message = \"Internal Server Error\";\r\n  let errors = undefined;\r\n  let stack = undefined;\r\n\r\n  // Custom application errors\r\n  if (err instanceof ApiError) {\r\n    statusCode = err.statusCode;\r\n    message = err.message;\r\n    errors = err.errors;\r\n  }\r\n\r\n  // Development stack trace\r\n  if (process.env.NODE_ENV === \"development\") {\r\n    stack = err.stack;\r\n  }\r\n\r\n  return res.status(statusCode).json(\r\n    errorResponse(\r\n      message,\r\n      errors,\r\n      stack\r\n    )\r\n  );\r\n};\r\n\r\nexport default errorHandler;"],"mappings":";AAEO,IAAM,kBAAkB,CAC7B,MACA,aACwB;AAAA,EACxB,SAAS;AAAA,EACT;AAAA,EACA;AACF;;;ACPO,IAAM,gBAAgB,CAC3B,SACA,QACA,WACmB;AAAA,EACnB,SAAS;AAAA,EACT;AAAA,EACA;AAAA,EACA;AACF;;;ACXA,IAAqB,WAArB,cAAsC,MAAM;AAAA,EAK1C,YACE,SACA,aAAa,KACb,QACA,gBAAgB,MAChB;AACA,UAAM,OAAO;AAEb,SAAK,aAAa;AAClB,SAAK,SAAS;AACd,SAAK,gBAAgB;AAErB,UAAM,kBAAkB,MAAM,KAAK,WAAW;AAAA,EAChD;AACF;;;ACjBA,IAAqB,kBAArB,cAA6C,SAAS;AAAA,EACpD,YAAY,UAAU,eAAe,QAAc;AACjD,UAAM,SAAS,KAAK,MAAM;AAAA,EAC5B;AACF;;;ACJA,IAAqB,oBAArB,cAA+C,SAAS;AAAA,EACtD,YAAY,UAAU,gBAAgB,QAAc;AAClD,UAAM,SAAS,KAAK,MAAM;AAAA,EAC5B;AACF;;;ACJA,IAAqB,iBAArB,cAA4C,SAAS;AAAA,EACnD,YAAY,UAAU,aAAa,QAAc;AAC/C,UAAM,SAAS,KAAK,MAAM;AAAA,EAC5B;AACF;;;ACJA,IAAqB,gBAArB,cAA2C,SAAS;AAAA,EAClD,YAAY,UAAU,sBAAsB,QAAc;AACxD,UAAM,SAAS,KAAK,MAAM;AAAA,EAC5B;AACF;;;ACJA,IAAqB,kBAArB,cAA6C,SAAS;AAAA,EACpD,YAAY,UAAU,qBAAqB,QAAc;AACvD,UAAM,SAAS,KAAK,MAAM;AAAA,EAC5B;AACF;;;ACDA,IAAM,eAAe,CACnB,KACA,KACA,KACA,SACG;AAEH,UAAQ,MAAM,UAAU,GAAG;AAE3B,MAAI,aAAa;AACjB,MAAI,UAAU;AACd,MAAI,SAAS;AACb,MAAI,QAAQ;AAGZ,MAAI,eAAe,UAAU;AAC3B,iBAAa,IAAI;AACjB,cAAU,IAAI;AACd,aAAS,IAAI;AAAA,EACf;AAGA,MAAI,QAAQ,IAAI,aAAa,eAAe;AAC1C,YAAQ,IAAI;AAAA,EACd;AAEA,SAAO,IAAI,OAAO,UAAU,EAAE;AAAA,IAC5B;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAO,uBAAQ;","names":[]}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "nexus-backend",
+  "version": "1.0.0",
+  "description": "Backend utility library for Express.js",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup"
+  },
+  "peerDependencies": {
+    "express": "^5.0.6"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "tsup": "^8.5.1",
+    "typescript": "^5.8.3"
+  }
+}