360-mock-server 1.2.2 → 1.2.4

package/README.md

@@ -41,7 +41,7 @@ That’s it! 🎉
 The mock server will start at:
 
 ```
-http://localhost:6000
+http://localhost:5050
 ```
 
 
@@ -83,7 +83,7 @@ Once the server starts, you can interact with it directly from the terminal:
 **Base URL**
 
 ```
-http://localhost:6000
+http://localhost:5050
 ```
 
 ### Example Endpoints
@@ -158,7 +158,7 @@ GET /faker/fields
 <summary><strong>Fetch API</strong></summary>
 
 ```javascript
-const API = 'http://localhost:6000';
+const API = 'http://localhost:5050';
 
 // CREATE
 await fetch(`${API}/users`, {
@@ -189,7 +189,7 @@ await fetch(`${API}/users/123`, { method: 'DELETE' });
 ```javascript
 import axios from 'axios';
 
-const API = 'http://localhost:6000';
+const API = 'http://localhost:5050';
 
 // CREATE
 await axios.post(`${API}/users`, {
@@ -216,7 +216,7 @@ await axios.delete(`${API}/users/123`);
 
 | Option   | Description    | Default          |
 | -------- | -------------- | ---------------- |
-| `--port` | Server port    | `6000`           |
+| `--port` | Server port    | `5050`           |
 | `--file` | Data file name | `mock-data.json` |
 
 ### Examples

package/bin/cli.js

@@ -9,7 +9,7 @@ const readline = require("readline");
 const packageJson = require("../package.json");
 
 // Helper function for making HTTP requests
-function makeRequest(method, endpoint, data, port = "6000") {
+function makeRequest(method, endpoint, data, port = "5050") {
   return new Promise((resolve) => {
     const upperMethod = method.toUpperCase();
     const urlPath = endpoint.startsWith("/") ? endpoint : "/" + endpoint;
@@ -166,7 +166,7 @@ program
 program
   .command("run", { isDefault: true })
   .description("Start server + interactive mode (recommended)")
-  .option("-p, --port <port>", "Port number", "6000")
+  .option("-p, --port <port>", "Port number", "5050")
   .option("-f, --file <filename>", "Data file name", "mock-data.json")
   .action((options) => {
     const dataFile = path.join(process.cwd(), options.file);
@@ -192,7 +192,7 @@ program
 program
   .command("start")
   .description("Start the mock server only (no interactive mode)")
-  .option("-p, --port <port>", "Port number", "6000")
+  .option("-p, --port <port>", "Port number", "5050")
   .option("-f, --file <filename>", "Data file name", "mock-data.json")
   .action((options) => {
     const dataFile = path.join(process.cwd(), options.file);
@@ -266,7 +266,7 @@ program
 program
   .command("req <method> <endpoint> [data]")
   .description("Make single API request")
-  .option("-p, --port <port>", "Server port", "6000")
+  .option("-p, --port <port>", "Server port", "5050")
   .action(async (method, endpoint, data, options) => {
     await makeRequest(method, endpoint, data, options.port);
   });

package/lib/server.js

@@ -5,7 +5,7 @@ const cors = require("cors");
 const { faker } = require("@faker-js/faker");
 
 const app = express();
-const PORT = process.env.PORT || 6000;
+const PORT = process.env.PORT || 5050;
 const DATA_FILE = process.env.DATA_FILE || path.join(process.cwd(), "mock-data.json");
 
 app.use(cors());
@@ -154,7 +154,31 @@ app.get("/", (req, res) => {
       "PUT /:resource/:id": "Replace item",
       "PATCH /:resource/:id": "Update item",
       "DELETE /:resource/:id": "Delete item",
+      "DELETE /:resource": "Delete all items in resource",
       "GET /faker/fields": "List available faker fields"
+    },
+    pagination: {
+      description: "Use query parameters for pagination",
+      parameters: {
+        "_limit": "Number of items per page (e.g., ?_limit=10)",
+        "_page": "Page number (default: 1, e.g., ?_page=2)",
+        "_sort": "Sort by field (e.g., ?_sort=name)",
+        "_order": "Sort order: 'asc' or 'desc' (e.g., ?_order=desc)"
+      },
+      example: "GET /users?_limit=10&_page=2&_sort=name&_order=asc",
+      response: {
+        data: "Array of items",
+        pagination: {
+          page: "Current page number",
+          limit: "Items per page",
+          totalItems: "Total number of items",
+          totalPages: "Total number of pages",
+          hasNextPage: "Boolean - if next page exists",
+          hasPrevPage: "Boolean - if previous page exists",
+          nextPage: "Next page number or null",
+          prevPage: "Previous page number or null"
+        }
+      }
     }
   });
 });
@@ -168,6 +192,8 @@ app.get("/:resource", (req, res) => {
   }
   let items = [...data[resource]];
   const queryParams = req.query;
+  
+  // Apply filters (exclude pagination and sorting params)
   if (Object.keys(queryParams).length > 0) {
     items = items.filter(item => {
       return Object.entries(queryParams).every(([key, value]) => {
@@ -178,6 +204,11 @@ app.get("/:resource", (req, res) => {
       });
     });
   }
+  
+  // Store total count after filtering but before pagination
+  const totalItems = items.length;
+  
+  // Apply sorting
   if (queryParams._sort) {
     const sortField = queryParams._sort;
     const order = queryParams._order === "desc" ? -1 : 1;
@@ -187,12 +218,36 @@ app.get("/:resource", (req, res) => {
       return 0;
     });
   }
-  if (queryParams._limit) {
-    const limit = parseInt(queryParams._limit);
-    const page = parseInt(queryParams._page) || 1;
+  
+  // Apply pagination
+  const limit = parseInt(queryParams._limit) || null;
+  const page = parseInt(queryParams._page) || 1;
+  
+  if (limit) {
     const start = (page - 1) * limit;
-    items = items.slice(start, start + limit);
+    const end = start + limit;
+    const paginatedItems = items.slice(start, end);
+    const totalPages = Math.ceil(totalItems / limit);
+    
+    console.log(`           ✅ Returning page ${page}/${totalPages} (${paginatedItems.length} items)`);
+    
+    // Return paginated response with metadata
+    return res.json({
+      data: paginatedItems,
+      pagination: {
+        page: page,
+        limit: limit,
+        totalItems: totalItems,
+        totalPages: totalPages,
+        hasNextPage: page < totalPages,
+        hasPrevPage: page > 1,
+        nextPage: page < totalPages ? page + 1 : null,
+        prevPage: page > 1 ? page - 1 : null
+      }
+    });
   }
+  
+  // No pagination - return all items
   console.log(`           ✅ Returning ${items.length} ${resource}`);
   res.json(items);
 });
@@ -378,8 +433,8 @@ app.use((err, req, res, next) => {
   res.status(500).json({ error: "Internal server error" });
 });
 
-app.listen(PORT, () => {
-  console.log(`\n🚀 Mock API Server running on port ${PORT}`);
+app.listen(PORT, '0.0.0.0', () => {
+  console.log(`\n🚀 Mock API Server running on http://0.0.0.0:${PORT}`);
   console.log(`📁 Data file: ${DATA_FILE}\n`);
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "360-mock-server",
-  "version": "1.2.2",
+  "version": "1.2.4",
   "description": "🚀 Zero-config dynamic mock REST API server with Faker.js auto-generation for frontend developers",
   "main": "lib/server.js",
   "bin": {