devdad-express-utils 1.7.2 → 1.8.0

package/README.md

@@ -54,19 +54,19 @@ throw new AppError("Validation failed", 400, ["Email is required"]);
 
 ### Response Formatting
 
-Standardize API responses with consistent JSON structure and intelligent auto-sending.
+Standardize API responses with consistent JSON structure and callback-based chaining.
 
 ```typescript
-import { sendSuccess, sendError, send } from "devdad-express-utils";
+import { sendSuccess, sendError } from "devdad-express-utils";
 
-// Basic success response (auto-sends - no send() needed)
+// Basic success response
 sendSuccess(res, { id: 1, name: "John" }, "User fetched", 200);
 
-// Chain native Express methods (use send() when done chaining)
-sendSuccess(res, { id: 1, name: "John" }, "User fetched", 200)
-  .cookie("session", "abc123")
-  .setHeader("X-Custom", "value");
-send(res); // Send when ready
+// Chain methods using callbacks
+sendSuccess(res, { id: 1, name: "John" }, "User fetched", 200, [
+  (res) => res.cookie("session", "abc123"),
+  (res) => res.setHeader("X-Custom", "value")
+]);
 
 // Error response (sends immediately)
 sendError(res, "User not found", 404);
@@ -257,18 +257,18 @@ errorHandler(err: any, req: Request, res: Response, next: NextFunction) => void
 
 ### sendSuccess
 
-Prepares a standardized success response and returns response object for chaining.
+Sends a standardized success response with optional callbacks for chaining response methods.
 
 ```typescript
-sendSuccess(res: Response, data: any, message?: string, statusCode?: number) => Response
+sendSuccess(res: Response, data: any, message?: string, statusCode?: number, callbacks?: Array<(res: Response) => Response>) => Response
 ```
 
 **Features:**
 - Includes `success: true` field by default
-- **Auto-sends** when no chaining detected (no `send()` needed)
-- Returns Express response object for native method chaining
-- Use `send()` when chaining methods (explicit control)
-- No magic - intelligent and predictable
+- Supports chaining via callbacks array
+- Executes callbacks before sending response
+- No timing issues - predictable order
+- Clean and explicit approach
 
 ### sendError
 
@@ -283,23 +283,7 @@ sendError(res: Response, message: string, statusCode?: number, data?: any) => vo
 - Sends response immediately (no chaining needed for errors)
 - Supports optional error data
 
-### send
 
-Sends the prepared success response from `sendSuccess`. Only needed when chaining methods.
-
-```typescript
-send(res: Response) => void
-```
-
-**Features:**
-- Sends the response prepared by `sendSuccess`
-- **Only needed when chaining** (.cookie(), .header(), etc.)
-- Basic usage: sendSuccess() auto-sends, no send() needed
-- Explicit control over when response is sent
-
-**When to Use:**
-- ❌ Basic: `sendSuccess(res, data)` → NO send() needed
-- ✅ Chaining: `sendSuccess(res, data).cookie(...)` → send() needed
 
 ### connectDB
 

package/dist/index.d.ts

@@ -2,5 +2,5 @@ export { AppError } from "./AppError.js";
 export { catchAsync } from "./catchAsync.js";
 export { errorHandler } from "./errorHandler.js";
 export { logger } from "./logger.js";
-export { sendSuccess, sendError, send } from "./responseFormatter.js";
+export { sendSuccess, sendError } from "./responseFormatter.js";
 export { default as connectDB, getDBStatus, DatabaseConnection, } from "./DatabaseConnection.js";

package/dist/index.js

@@ -2,5 +2,5 @@ export { AppError } from "./AppError.js";
 export { catchAsync } from "./catchAsync.js";
 export { errorHandler } from "./errorHandler.js";
 export { logger } from "./logger.js";
-export { sendSuccess, sendError, send } from "./responseFormatter.js";
+export { sendSuccess, sendError } from "./responseFormatter.js";
 export { default as connectDB, getDBStatus, DatabaseConnection, } from "./DatabaseConnection.js";

package/dist/responseFormatter.d.ts

@@ -33,23 +33,7 @@ import { Response } from "express";
  *   .cookie("refreshToken", refreshToken, HTTP_OPTIONS);
  * send(res); // Send when ready
  */
-export declare const sendSuccess: (res: Response, data: any, message?: string, statusCode?: number) => Response;
-/**
- * Sends the prepared success response.
- * Use this only when chaining methods (.cookie(), .header(), etc.).
- * For basic usage, sendSuccess() auto-sends and you don't need this.
- *
- * @param {Response} res - Express response object.
- * @returns {void}
- *
- * @example
- * // Only needed when chaining methods
- * sendSuccess(res, data, "Success", 200)
- *   .cookie("session", "abc123")
- *   .header("X-Custom", "value");
- * send(res); // Send when ready
- */
-export declare const send: (res: Response) => void;
+export declare const sendSuccess: (res: Response, data: any, message?: string, statusCode?: number, callbacks?: ((res: Response) => Response)[]) => Response;
 /**
  * Sends an error response immediately.
  *

package/dist/responseFormatter.js

@@ -32,42 +32,25 @@
  *   .cookie("refreshToken", refreshToken, HTTP_OPTIONS);
  * send(res); // Send when ready
  */
-export const sendSuccess = (res, data, message = "Success", statusCode = 200) => {
+export const sendSuccess = (res, data, message = "Success", statusCode = 200, callbacks) => {
     const response = {
         status: "success",
         success: true,
         message,
         data,
     };
-    // Set status and store response for later sending
     res.status(statusCode);
-    res._responseData = response;
-    // Auto-send unless chaining is detected (using setImmediate to check)
-    setImmediate(() => {
-        if (!res._responseSent && res._responseData) {
-            res._responseSent = true;
-            res.json(res._responseData);
+    // Execute callbacks for chaining if provided
+    if (callbacks && callbacks.length > 0) {
+        let currentRes = res;
+        for (const callback of callbacks) {
+            if (typeof callback === 'function') {
+                currentRes = callback(currentRes);
+            }
         }
-    });
-    return res;
-};
-/**
- * Sends the prepared success response.
- * Use this only when chaining methods (.cookie(), .header(), etc.).
- * For basic usage, sendSuccess() auto-sends and you don't need this.
- *
- * @param {Response} res - Express response object.
- * @returns {void}
- *
- * @example
- * // Only needed when chaining methods
- * sendSuccess(res, data, "Success", 200)
- *   .cookie("session", "abc123")
- *   .header("X-Custom", "value");
- * send(res); // Send when ready
- */
-export const send = (res) => {
-    res.json(res._responseData);
+    }
+    // Send response
+    return res.json(response);
 };
 /**
  * Sends an error response immediately.

package/package.json

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