nexus-backend 1.0.0 → 1.0.2

package/README.md

@@ -1,288 +1,349 @@
-# 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
+# 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 express mongoose cors helmet morgan cookie-parser
+```
+
+Express, mongoose, cors, helmet, morgan, and cookie-parser are peer dependencies — make sure they are installed in your project:
+
+```bash
+npm install nexus-backend
+```
+
+---
+
+## Quick Start
+
+```ts
+// src/config/mongoConfig.ts
+import { type MongoConfig } from "nexus-backend";
+
+const dbConfig: MongoConfig = {
+  subDomain: requiredEnv(process.env.DB_HOST, "DB_HOST"),
+  userName: requiredEnv(process.env.DB_USERNAME, "DB_USERNAME"),
+  password: requiredEnv(process.env.DB_PASSWORD, "DB_PASSWORD"),
+  cluster: requiredEnv(process.env.DB_CLUSTER, "DB_CLUSTER"),
+  dbName: requiredEnv(process.env.DB_NAME, "DB_NAME"),
+};
+export default dbConfig;
+```
+
+```ts
+// src/server.ts
+import express, { type Application, Request, Response } from "express";
+import http from "http";
+import {
+  successResponse,
+  errorMiddleware,
+  NotFoundError,
+  ValidationError,
+} from "nexus-backend";
+import cors from "cors";
+import helmet from "helmet";
+import morgan from "morgan";
+import cookieParser from "cookie-parser";
+import { Server } from "socket.io";
+
+const app: Application = express();
+
+if (process.env.NODE_ENV !== "production") {
+  app.use(morgan("dev"));
+}
+app.set("trust proxy", 1);
+app.use(helmet());
+app.use(
+  cors({
+    origin: process.env.FRONTEND_URL,
+    credentials: true,
+  }),
+);
+
+app.use(express.json({ limit: "500mb" })); // Adjust the limit as needed
+app.use(express.urlencoded({ extended: true, limit: "500mb" })); // For parsing application/x-www-form-urlencoded
+app.use(cookieParser());
+
+// Example route
+app.get("/users/:id", async (req: Request, res: Response) => {
+  const user = await getUserById(req.params.id);
+
+  if (!user) {
+    throw new NotFoundError("User not found");
+  }
+
+  res.json(successResponse(user, "User fetched successfully"));
+});
+
+// Register error middleware last
+app.use(errorMiddleware);
+const server = http.createServer(app);
+export const io = new Server(server, {
+  cors: {
+    origin: process.env.FRONTEND_URL,
+    credentials: true,
+  },
+});
+
+export default server;
+```
+
+```ts
+// src/index.ts
+import "dotenv/config";
+import { connectMongoDb } from "nexus-backend";
+import dns from "dns";
+import dbConfig from "./config/mongoConfig";
+import server from "./server";
+const PORT = process.env.PORT || 5000;
+async () => {
+  dns.setServers(["1.1.1.1", "1.0.0.1"]);
+  const dbConnected = await connectMongoDb(dbConfig);
+  if (!dbConnected) {
+    console.error("Database connection failed. Exiting...");
+    process.exit(1);
+  }
+  server.listen(PORT, () => {
+    console.log(`Server running on ${PORT}`);
+  });
+};
+```
+
+## 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

@@ -16,6 +16,18 @@ declare const successResponse: <T>(data: T, message?: string) => SuccessResponse
 
 declare const errorResponse: (message: string, errors?: any, stack?: string) => ErrorResponse;
 
+declare const requiredEnv: (value: string | undefined, key: string) => string;
+
+interface MongoConfig {
+    subDomain: string;
+    userName: string;
+    password: string;
+    cluster: string;
+    dbName: string;
+}
+
+declare const connectMongoDb: (config: MongoConfig) => Promise<boolean>;
+
 declare class ApiError extends Error {
     statusCode: number;
     isOperational: boolean;
@@ -43,6 +55,9 @@ 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>>;
+declare const errorHandler: [
+    (req: Request, res: Response, next: NextFunction) => void,
+    (err: any, req: Request, res: Response, next: NextFunction) => void
+];
 
-export { ApiError, BadRequestError, type ErrorResponse, ForbiddenError, NotFoundError, type SuccessResponse, UnauthorizedError, ValidationError, errorHandler as errorMiddleware, errorResponse, successResponse };
+export { ApiError, BadRequestError, type ErrorResponse, ForbiddenError, type MongoConfig, NotFoundError, type SuccessResponse, UnauthorizedError, ValidationError, connectMongoDb, errorHandler as errorMiddleware, errorResponse, requiredEnv, successResponse };

package/dist/index.d.ts

@@ -16,6 +16,18 @@ declare const successResponse: <T>(data: T, message?: string) => SuccessResponse
 
 declare const errorResponse: (message: string, errors?: any, stack?: string) => ErrorResponse;
 
+declare const requiredEnv: (value: string | undefined, key: string) => string;
+
+interface MongoConfig {
+    subDomain: string;
+    userName: string;
+    password: string;
+    cluster: string;
+    dbName: string;
+}
+
+declare const connectMongoDb: (config: MongoConfig) => Promise<boolean>;
+
 declare class ApiError extends Error {
     statusCode: number;
     isOperational: boolean;
@@ -43,6 +55,9 @@ 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>>;
+declare const errorHandler: [
+    (req: Request, res: Response, next: NextFunction) => void,
+    (err: any, req: Request, res: Response, next: NextFunction) => void
+];
 
-export { ApiError, BadRequestError, type ErrorResponse, ForbiddenError, NotFoundError, type SuccessResponse, UnauthorizedError, ValidationError, errorHandler as errorMiddleware, errorResponse, successResponse };
+export { ApiError, BadRequestError, type ErrorResponse, ForbiddenError, type MongoConfig, NotFoundError, type SuccessResponse, UnauthorizedError, ValidationError, connectMongoDb, errorHandler as errorMiddleware, errorResponse, requiredEnv, successResponse };

package/dist/index.js

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -26,8 +36,10 @@ __export(index_exports, {
   NotFoundError: () => NotFoundError,
   UnauthorizedError: () => UnauthorizedError,
   ValidationError: () => ValidationError,
+  connectMongoDb: () => connectMongoDb,
   errorMiddleware: () => errorHandler_default,
   errorResponse: () => errorResponse,
+  requiredEnv: () => requiredEnv,
   successResponse: () => successResponse
 });
 module.exports = __toCommonJS(index_exports);
@@ -47,6 +59,39 @@ var errorResponse = (message, errors, stack) => ({
   stack
 });
 
+// src/utils/envManager.ts
+var requiredEnv = (value, key) => {
+  if (!value) {
+    throw new Error(`Missing required environment variable: ${key}`);
+  }
+  return value;
+};
+
+// src/config/mongoConfig.ts
+var import_mongoose = __toESM(require("mongoose"));
+var connectMongoDb = async (config) => {
+  const { subDomain, userName, password, cluster, dbName } = config;
+  const srvURL = `mongodb+srv://${userName}:${password}@${cluster.toLowerCase()}.${subDomain}.mongodb.net/${dbName}?retryWrites=true&w=majority&appName=${cluster.toLowerCase()}`;
+  const fallbackURL = `mongodb://${userName}:${password}@ac-hkntio7-shard-00-00.${subDomain}.mongodb.net:27017,ac-hkntio7-shard-00-01.${subDomain}.mongodb.net:27017,ac-hkntio7-shard-00-02.${subDomain}.mongodb.net:27017/${dbName}?ssl=true&replicaSet=atlas-cji6jk-shard-0&authSource=admin&appName=${cluster}`;
+  try {
+    console.log("Trying primary +srv connection...");
+    await import_mongoose.default.connect(srvURL);
+    console.log("Connected to MongoDB Atlas via +srv URL");
+    return true;
+  } catch (err) {
+    console.warn("+srv connection failed:", err.message);
+    console.log("Trying fallback standard connection...");
+    try {
+      await import_mongoose.default.connect(fallbackURL);
+      console.log("Connected to MongoDB Atlas via fallback URL");
+      return true;
+    } catch (fallbackErr) {
+      console.error("Fallback connection failed:", fallbackErr.message);
+      return false;
+    }
+  }
+};
+
 // src/errors/ApiError.ts
 var ApiError = class extends Error {
   constructor(message, statusCode = 500, errors, isOperational = true) {
@@ -94,7 +139,10 @@ var ValidationError = class extends ApiError {
 };
 
 // src/handlers/errorHandler.ts
-var errorHandler = (err, req, res, next) => {
+var routeNotFoundHandler = (req, _, next) => {
+  next(new ApiError(`Route ${req.originalUrl} not found`, 404));
+};
+var globalErrorHandler = (err, req, res, next) => {
   console.error("Error:", err);
   let statusCode = 500;
   let message = "Internal Server Error";
@@ -108,14 +156,9 @@ var errorHandler = (err, req, res, next) => {
   if (process.env.NODE_ENV === "development") {
     stack = err.stack;
   }
-  return res.status(statusCode).json(
-    errorResponse(
-      message,
-      errors,
-      stack
-    )
-  );
+  return res.status(statusCode).json(errorResponse(message, errors, stack));
 };
+var errorHandler = [routeNotFoundHandler, globalErrorHandler];
 var errorHandler_default = errorHandler;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -125,8 +168,10 @@ var errorHandler_default = errorHandler;
   NotFoundError,
   UnauthorizedError,
   ValidationError,
+  connectMongoDb,
   errorMiddleware,
   errorResponse,
+  requiredEnv,
   successResponse
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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":[]}
+{"version":3,"sources":["../src/index.ts","../src/responses/successResponse.ts","../src/responses/errorResponse.ts","../src/utils/envManager.ts","../src/config/mongoConfig.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\";\nexport { errorResponse } from \"./responses/errorResponse\";\nexport { requiredEnv } from \"./utils/envManager\";\nexport { connectMongoDb } from \"./config/mongoConfig\";\nexport { default as ApiError } from \"./errors/ApiError\";\nexport { default as BadRequestError } from \"./errors/BadRequestError\";\nexport { default as UnauthorizedError } from \"./errors/UnauthorisedError\";\nexport { default as ForbiddenError } from \"./errors/ForbiddenError\";\nexport { default as NotFoundError } from \"./errors/NotFoundError\";\nexport { default as ValidationError } from \"./errors/ValidationError\";\nexport { default as errorMiddleware } from \"./handlers/errorHandler\";\n\nexport type { SuccessResponse, ErrorResponse } from \"./types/response.types\";\nexport { type MongoConfig } from \"./types/mongoConfig.types\";","import { SuccessResponse } from \"../types/response.types\";\n\nexport const successResponse = <T>(\n  data: T,\n  message?: string\n): SuccessResponse<T> => ({\n  success: true,\n  data,\n  message,\n});","import { ErrorResponse } from \"../types/response.types\";\n\nexport const errorResponse = (\n  message: string,\n  errors?: any,\n  stack?: string\n): ErrorResponse => ({\n  success: false,\n  message,\n  errors,\n  stack,\n});","export const requiredEnv = (value: string | undefined, key: string): string => {\n  if (!value) {\n    throw new Error(`Missing required environment variable: ${key}`);\n  }\n  return value;\n};","import mongoose from \"mongoose\";\n\nimport type { MongoConfig } from \"../types/mongoConfig.types\";\n\nexport const connectMongoDb = async (config: MongoConfig) => {\n  const { subDomain, userName, password, cluster, dbName } = config;\n  // Primary +srv URL\n  const srvURL = `mongodb+srv://${userName}:${password}@${cluster.toLowerCase()}.${subDomain}.mongodb.net/${dbName}?retryWrites=true&w=majority&appName=${cluster.toLowerCase()}`;\n  // Fallback standard mongodb:// URL (you need to adjust hostnames from Atlas)\n  const fallbackURL = `mongodb://${userName}:${password}@ac-hkntio7-shard-00-00.${subDomain}.mongodb.net:27017,ac-hkntio7-shard-00-01.${subDomain}.mongodb.net:27017,ac-hkntio7-shard-00-02.${subDomain}.mongodb.net:27017/${dbName}?ssl=true&replicaSet=atlas-cji6jk-shard-0&authSource=admin&appName=${cluster}`;\n  try {\n    console.log(\"Trying primary +srv connection...\");\n    await mongoose.connect(srvURL);\n    console.log(\"Connected to MongoDB Atlas via +srv URL\");\n    return true;\n  } catch (err: any) {\n    console.warn(\"+srv connection failed:\", err.message);\n    console.log(\"Trying fallback standard connection...\");\n    try {\n      await mongoose.connect(fallbackURL);\n      console.log(\"Connected to MongoDB Atlas via fallback URL\");\n      return true;\n    } catch (fallbackErr: any) {\n      console.error(\"Fallback connection failed:\", fallbackErr.message);\n      return false;\n    }\n  }\n};","export default class ApiError extends Error {\n  statusCode: number;\n  isOperational: boolean;\n  errors?: any;\n\n  constructor(\n    message: string,\n    statusCode = 500,\n    errors?: any,\n    isOperational = true\n  ) {\n    super(message);\n\n    this.statusCode = statusCode;\n    this.errors = errors;\n    this.isOperational = isOperational;\n\n    Error.captureStackTrace(this, this.constructor);\n  }\n}","import ApiError from \"./ApiError\";\n\nexport default class BadRequestError extends ApiError {\n  constructor(message = \"Bad Request\", errors?: any) {\n    super(message, 400, errors);\n  }\n}","import ApiError from \"./ApiError\";\n\nexport default class UnauthorizedError extends ApiError {\n  constructor(message = \"Unauthorized\", errors?: any) {\n    super(message, 401, errors);\n  }\n}","import ApiError from \"./ApiError\";\n\nexport default class ForbiddenError extends ApiError {\n  constructor(message = \"Forbidden\", errors?: any) {\n    super(message, 403, errors);\n  }\n}","import ApiError from \"./ApiError\";\n\nexport default class NotFoundError extends ApiError {\n  constructor(message = \"Resource Not Found\", errors?: any) {\n    super(message, 404, errors);\n  }\n}","import ApiError from \"./ApiError\";\n\nexport default class ValidationError extends ApiError {\n  constructor(message = \"Validation Failed\", errors?: any) {\n    super(message, 422, errors);\n  }\n}","// errorHandler.ts\nimport { Request, Response, NextFunction } from \"express\";\nimport ApiError from \"../errors/ApiError\";\nimport { errorResponse } from \"../responses/errorResponse\";\n\nconst routeNotFoundHandler = (req: Request, _: Response, next: NextFunction) => {\n  next(new ApiError(`Route ${req.originalUrl} not found`, 404));\n};\n\nconst globalErrorHandler = (err: any, req: Request, res: Response, next: NextFunction) => {\n  console.error(\"Error:\", err);\n  let statusCode = 500;\n  let message = \"Internal Server Error\";\n  let errors = undefined;\n  let stack = undefined;\n\n  if (err instanceof ApiError) {\n    statusCode = err.statusCode;\n    message = err.message;\n    errors = err.errors;\n  }\n\n  if (process.env.NODE_ENV === \"development\") {\n    stack = err.stack;\n  }\n\n  return res.status(statusCode).json(errorResponse(message, errors, stack));\n};\n\n// Export as a tuple with explicit types so spread works correctly\nconst errorHandler: [\n  (req: Request, res: Response, next: NextFunction) => void,\n  (err: any, req: Request, res: Response, next: NextFunction) => void\n] = [routeNotFoundHandler, globalErrorHandler];\n\nexport default errorHandler;"],"mappings":"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","names":["mongoose"]}

package/dist/index.mjs

@@ -13,6 +13,39 @@ var errorResponse = (message, errors, stack) => ({
   stack
 });
 
+// src/utils/envManager.ts
+var requiredEnv = (value, key) => {
+  if (!value) {
+    throw new Error(`Missing required environment variable: ${key}`);
+  }
+  return value;
+};
+
+// src/config/mongoConfig.ts
+import mongoose from "mongoose";
+var connectMongoDb = async (config) => {
+  const { subDomain, userName, password, cluster, dbName } = config;
+  const srvURL = `mongodb+srv://${userName}:${password}@${cluster.toLowerCase()}.${subDomain}.mongodb.net/${dbName}?retryWrites=true&w=majority&appName=${cluster.toLowerCase()}`;
+  const fallbackURL = `mongodb://${userName}:${password}@ac-hkntio7-shard-00-00.${subDomain}.mongodb.net:27017,ac-hkntio7-shard-00-01.${subDomain}.mongodb.net:27017,ac-hkntio7-shard-00-02.${subDomain}.mongodb.net:27017/${dbName}?ssl=true&replicaSet=atlas-cji6jk-shard-0&authSource=admin&appName=${cluster}`;
+  try {
+    console.log("Trying primary +srv connection...");
+    await mongoose.connect(srvURL);
+    console.log("Connected to MongoDB Atlas via +srv URL");
+    return true;
+  } catch (err) {
+    console.warn("+srv connection failed:", err.message);
+    console.log("Trying fallback standard connection...");
+    try {
+      await mongoose.connect(fallbackURL);
+      console.log("Connected to MongoDB Atlas via fallback URL");
+      return true;
+    } catch (fallbackErr) {
+      console.error("Fallback connection failed:", fallbackErr.message);
+      return false;
+    }
+  }
+};
+
 // src/errors/ApiError.ts
 var ApiError = class extends Error {
   constructor(message, statusCode = 500, errors, isOperational = true) {
@@ -60,7 +93,10 @@ var ValidationError = class extends ApiError {
 };
 
 // src/handlers/errorHandler.ts
-var errorHandler = (err, req, res, next) => {
+var routeNotFoundHandler = (req, _, next) => {
+  next(new ApiError(`Route ${req.originalUrl} not found`, 404));
+};
+var globalErrorHandler = (err, req, res, next) => {
   console.error("Error:", err);
   let statusCode = 500;
   let message = "Internal Server Error";
@@ -74,14 +110,9 @@ var errorHandler = (err, req, res, next) => {
   if (process.env.NODE_ENV === "development") {
     stack = err.stack;
   }
-  return res.status(statusCode).json(
-    errorResponse(
-      message,
-      errors,
-      stack
-    )
-  );
+  return res.status(statusCode).json(errorResponse(message, errors, stack));
 };
+var errorHandler = [routeNotFoundHandler, globalErrorHandler];
 var errorHandler_default = errorHandler;
 export {
   ApiError,
@@ -90,8 +121,10 @@ export {
   NotFoundError,
   UnauthorizedError,
   ValidationError,
+  connectMongoDb,
   errorHandler_default as errorMiddleware,
   errorResponse,
+  requiredEnv,
   successResponse
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +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":[]}
+{"version":3,"sources":["../src/responses/successResponse.ts","../src/responses/errorResponse.ts","../src/utils/envManager.ts","../src/config/mongoConfig.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\";\n\nexport const successResponse = <T>(\n  data: T,\n  message?: string\n): SuccessResponse<T> => ({\n  success: true,\n  data,\n  message,\n});","import { ErrorResponse } from \"../types/response.types\";\n\nexport const errorResponse = (\n  message: string,\n  errors?: any,\n  stack?: string\n): ErrorResponse => ({\n  success: false,\n  message,\n  errors,\n  stack,\n});","export const requiredEnv = (value: string | undefined, key: string): string => {\n  if (!value) {\n    throw new Error(`Missing required environment variable: ${key}`);\n  }\n  return value;\n};","import mongoose from \"mongoose\";\n\nimport type { MongoConfig } from \"../types/mongoConfig.types\";\n\nexport const connectMongoDb = async (config: MongoConfig) => {\n  const { subDomain, userName, password, cluster, dbName } = config;\n  // Primary +srv URL\n  const srvURL = `mongodb+srv://${userName}:${password}@${cluster.toLowerCase()}.${subDomain}.mongodb.net/${dbName}?retryWrites=true&w=majority&appName=${cluster.toLowerCase()}`;\n  // Fallback standard mongodb:// URL (you need to adjust hostnames from Atlas)\n  const fallbackURL = `mongodb://${userName}:${password}@ac-hkntio7-shard-00-00.${subDomain}.mongodb.net:27017,ac-hkntio7-shard-00-01.${subDomain}.mongodb.net:27017,ac-hkntio7-shard-00-02.${subDomain}.mongodb.net:27017/${dbName}?ssl=true&replicaSet=atlas-cji6jk-shard-0&authSource=admin&appName=${cluster}`;\n  try {\n    console.log(\"Trying primary +srv connection...\");\n    await mongoose.connect(srvURL);\n    console.log(\"Connected to MongoDB Atlas via +srv URL\");\n    return true;\n  } catch (err: any) {\n    console.warn(\"+srv connection failed:\", err.message);\n    console.log(\"Trying fallback standard connection...\");\n    try {\n      await mongoose.connect(fallbackURL);\n      console.log(\"Connected to MongoDB Atlas via fallback URL\");\n      return true;\n    } catch (fallbackErr: any) {\n      console.error(\"Fallback connection failed:\", fallbackErr.message);\n      return false;\n    }\n  }\n};","export default class ApiError extends Error {\n  statusCode: number;\n  isOperational: boolean;\n  errors?: any;\n\n  constructor(\n    message: string,\n    statusCode = 500,\n    errors?: any,\n    isOperational = true\n  ) {\n    super(message);\n\n    this.statusCode = statusCode;\n    this.errors = errors;\n    this.isOperational = isOperational;\n\n    Error.captureStackTrace(this, this.constructor);\n  }\n}","import ApiError from \"./ApiError\";\n\nexport default class BadRequestError extends ApiError {\n  constructor(message = \"Bad Request\", errors?: any) {\n    super(message, 400, errors);\n  }\n}","import ApiError from \"./ApiError\";\n\nexport default class UnauthorizedError extends ApiError {\n  constructor(message = \"Unauthorized\", errors?: any) {\n    super(message, 401, errors);\n  }\n}","import ApiError from \"./ApiError\";\n\nexport default class ForbiddenError extends ApiError {\n  constructor(message = \"Forbidden\", errors?: any) {\n    super(message, 403, errors);\n  }\n}","import ApiError from \"./ApiError\";\n\nexport default class NotFoundError extends ApiError {\n  constructor(message = \"Resource Not Found\", errors?: any) {\n    super(message, 404, errors);\n  }\n}","import ApiError from \"./ApiError\";\n\nexport default class ValidationError extends ApiError {\n  constructor(message = \"Validation Failed\", errors?: any) {\n    super(message, 422, errors);\n  }\n}","// errorHandler.ts\nimport { Request, Response, NextFunction } from \"express\";\nimport ApiError from \"../errors/ApiError\";\nimport { errorResponse } from \"../responses/errorResponse\";\n\nconst routeNotFoundHandler = (req: Request, _: Response, next: NextFunction) => {\n  next(new ApiError(`Route ${req.originalUrl} not found`, 404));\n};\n\nconst globalErrorHandler = (err: any, req: Request, res: Response, next: NextFunction) => {\n  console.error(\"Error:\", err);\n  let statusCode = 500;\n  let message = \"Internal Server Error\";\n  let errors = undefined;\n  let stack = undefined;\n\n  if (err instanceof ApiError) {\n    statusCode = err.statusCode;\n    message = err.message;\n    errors = err.errors;\n  }\n\n  if (process.env.NODE_ENV === \"development\") {\n    stack = err.stack;\n  }\n\n  return res.status(statusCode).json(errorResponse(message, errors, stack));\n};\n\n// Export as a tuple with explicit types so spread works correctly\nconst errorHandler: [\n  (req: Request, res: Response, next: NextFunction) => void,\n  (err: any, req: Request, res: Response, next: NextFunction) => void\n] = [routeNotFoundHandler, globalErrorHandler];\n\nexport default errorHandler;"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-backend",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Backend utility library for Express.js",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -12,11 +12,20 @@
     "build": "tsup"
   },
   "peerDependencies": {
-    "express": "^5.0.6"
+    "cookie-parser": "^1.4.7",
+    "cors": "^2.8.6",
+    "dotenv": "^17.4.2",
+    "express": "^5.0.6",
+    "helmet": "^8.1.0",
+    "mongoose": "^9.6.2",
+    "morgan": "^1.10.1",
+    "socket.io": "^4.8.3"
   },
   "devDependencies": {
+    "@types/cookie-parser": "^1.4.10",
+    "@types/cors": "^2.8.19",
     "@types/express": "^5.0.6",
     "tsup": "^8.5.1",
     "typescript": "^5.8.3"
   }
-}
+}