devdad-express-utils 1.4.0 → 1.5.0

package/README.md

@@ -60,27 +60,15 @@ Standardize API responses with consistent JSON structure.
 import { sendSuccess, sendError, sendPaginated } from "devdad-express-utils";
 
 // Success response
-sendSuccess(res, { id: 1, name: 'John' }, 'User fetched', 200);
+sendSuccess(res, { id: 1, name: "John" }, "User fetched", 200);
 
-// Error response
-sendError(res, 'User not found', 404);
-
-
-```
-
-### Authentication Middleware
+// Chain additional response methods
+sendSuccess(res, { id: 1, name: "John" })
+  .cookie("session", "abc123")
+  .setHeader("X-Custom", "value");
 
-JWT-based authentication wrapper.
-
-```typescript
-import { requireAuth } from "devdad-express-utils";
-
-const authMiddleware = requireAuth({ secret: process.env.JWT_SECRET });
-
-app.get('/profile', authMiddleware, (req, res) => {
-  // req.user contains decoded JWT
-  res.json(req.user);
-});
+// Error response
+sendError(res, "User not found", 404);
 ```
 
 ### Database Connection
@@ -122,6 +110,7 @@ logger.debug("Processing request", { requestId: "abc-123" });
 #### Log Files
 
 In development, logs are written to:
+
 - `error.log`: Error level and above
 - `combined.log`: All log levels
 
@@ -208,10 +197,10 @@ errorHandler(err: any, req: Request, res: Response, next: NextFunction) => void
 
 ### sendSuccess
 
-Sends a standardized success response.
+Sends a standardized success response. Returns the Response object for method chaining.
 
 ```typescript
-sendSuccess(res: Response, data: any, message?: string, statusCode?: number) => void
+sendSuccess(res: Response, data: any, message?: string, statusCode?: number) => Response
 ```
 
 ### sendError
@@ -222,16 +211,6 @@ Sends a standardized error response.
 sendError(res: Response, message: string, statusCode?: number, data?: any) => void
 ```
 
-
-
-### requireAuth
-
-Middleware for JWT authentication.
-
-```typescript
-requireAuth(options: { secret: string, algorithms?: Algorithm[] }) => (req, res, next) => void
-```
-
 ### connectDB
 
 Connects to MongoDB with retry logic and automatic reconnection.
@@ -253,7 +232,7 @@ getDBStatus() => { isConnected: boolean; readyState: number; host: string; name:
 Winston logger instance with JSON formatting, timestamps, and error stack traces.
 
 ```typescript
-logger: winston.Logger
+logger: winston.Logger;
 ```
 
 ## Development

package/dist/responseFormatter.d.ts

@@ -5,8 +5,9 @@ import { Response } from "express";
  * @param {any} data - Response data.
  * @param {string} [message='Success'] - Response message.
  * @param {number} [statusCode=200] - HTTP status code.
+ * @returns {Response} The Express response object for chaining.
  */
-export declare const sendSuccess: (res: Response, data: any, message?: string, statusCode?: number) => void;
+export declare const sendSuccess: (res: Response, data: any, message?: string, statusCode?: number) => Response;
 /**
  * Sends an error response.
  * @param {Response} res - Express response object.

package/dist/responseFormatter.js

@@ -4,6 +4,7 @@
  * @param {any} data - Response data.
  * @param {string} [message='Success'] - Response message.
  * @param {number} [statusCode=200] - HTTP status code.
+ * @returns {Response} The Express response object for chaining.
  */
 export const sendSuccess = (res, data, message = "Success", statusCode = 200) => {
     const response = {
@@ -11,7 +12,7 @@ export const sendSuccess = (res, data, message = "Success", statusCode = 200) =>
         message,
         data,
     };
-    res.status(statusCode).json(response);
+    return res.status(statusCode).json(response);
 };
 /**
  * Sends an error response.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devdad-express-utils",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Reusable Express.js utilities for error handling, async wrapping, and more",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",