360-mock-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 zahidrahimoon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,155 @@
+# 🚀 Mock API Server
+
+Zero-config dynamic mock REST API server. Perfect for frontend development when backend isn't ready.
+
+## Installation
+
+```bash
+# Global installation (recommended)
+npm install -g 360-mock-server
+
+# Or use npx directly
+npx 360-mock-server start
+```
+
+## Quick Start
+
+```bash
+# Navigate to your project
+cd my-frontend-project
+
+# Initialize (creates mock-data.json)
+360-mock init
+
+# Start server
+360-mock start
+```
+
+Server runs at `http://localhost:3000`
+
+---
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `360-mock start` | Start the server |
+| `360-mock init` | Create mock-data.json |
+| `360-mock list` | Show available resources |
+| `360-mock reset` | Clear all data |
+
+### Options
+
+```bash
+360-mock start --port 4000       # Custom port
+360-mock start --file db.json    # Custom data file
+360-mock --help                  # Show help
+360-mock --version               # Show version
+```
+
+---
+
+## API Usage
+
+### Any endpoint works automatically!
+
+Just POST to any endpoint - it creates the resource:
+
+```bash
+# These all work without configuration:
+POST /users
+POST /products  
+POST /orders
+POST /anything-you-want
+```
+
+### Full CRUD Operations
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/users` | Get all users |
+| GET | `/users/1` | Get user by ID |
+| POST | `/users` | Create user |
+| PUT | `/users/1` | Replace user |
+| PATCH | `/users/1` | Update user |
+| DELETE | `/users/1` | Delete user |
+| DELETE | `/users` | Delete all users |
+
+### Query Parameters
+
+```bash
+GET /users?name=john           # Filter by name
+GET /users?_sort=name          # Sort by field
+GET /users?_order=desc         # Sort order
+GET /users?_limit=10&_page=2   # Pagination
+```
+
+---
+
+## Frontend Examples
+
+### Fetch API
+
+```javascript
+// Create
+const user = await fetch('http://localhost:3000/users', {
+  method: 'POST',
+  headers: { 'Content-Type': 'application/json' },
+  body: JSON.stringify({ name: 'Ali', email: 'ali@test.com' })
+}).then(r => r.json());
+
+// Read all
+const users = await fetch('http://localhost:3000/users').then(r => r.json());
+
+// Read one
+const user = await fetch('http://localhost:3000/users/1').then(r => r.json());
+
+// Update
+await fetch('http://localhost:3000/users/1', {
+  method: 'PATCH',
+  headers: { 'Content-Type': 'application/json' },
+  body: JSON.stringify({ name: 'Ali Updated' })
+});
+
+// Delete
+await fetch('http://localhost:3000/users/1', { method: 'DELETE' });
+```
+
+### Axios
+
+```javascript
+import axios from 'axios';
+const api = axios.create({ baseURL: 'http://localhost:3000' });
+
+// Create
+const { data: user } = await api.post('/users', { name: 'Ali' });
+
+// Read
+const { data: users } = await api.get('/users');
+
+// Update
+await api.patch(`/users/${id}`, { name: 'Updated' });
+
+// Delete
+await api.delete(`/users/${id}`);
+```
+
+---
+
+## Features
+
+- ✅ **Zero config** - Works out of the box
+- ✅ **Any endpoint** - Auto-creates resources
+- ✅ **Full CRUD** - GET, POST, PUT, PATCH, DELETE
+- ✅ **Filtering** - Query parameter support
+- ✅ **Sorting** - `?_sort=field&_order=desc`
+- ✅ **Pagination** - `?_limit=10&_page=1`
+- ✅ **Auto IDs** - Generated automatically
+- ✅ **Timestamps** - createdAt, updatedAt
+- ✅ **CORS enabled** - Works with any frontend
+
+---
+
+## License
+
+MIT © [zahidrahimoon](https://github.com/zahidrahimoon)

package/bin/cli.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+
+const { program } = require("commander");
+const path = require("path");
+const fs = require("fs");
+
+const packageJson = require("../package.json");
+
+program
+  .name("360-mock")
+  .description("🚀 Dynamic Mock REST API Server - Zero Config")
+  .version(packageJson.version);
+
+program
+  .command("start")
+  .description("Start the mock server")
+  .option("-p, --port <port>", "Port number", "3000")
+  .option("-f, --file <filename>", "Data file name", "mock-data.json")
+  .action((options) => {
+    process.env.PORT = options.port;
+    process.env.DATA_FILE = path.join(process.cwd(), options.file);
+    require("../lib/server");
+  });
+
+program
+  .command("init")
+  .description("Initialize mock-data.json in current directory")
+  .option("-f, --file <filename>", "Data file name", "mock-data.json")
+  .action((options) => {
+    const filePath = path.join(process.cwd(), options.file);
+    if (fs.existsSync(filePath)) {
+      console.log(`⚠️  ${options.file} already exists!`);
+      return;
+    }
+    const initialData = {
+      _info: "Add your mock data here. Each key becomes an API endpoint.",
+      users: [],
+      products: []
+    };
+    fs.writeFileSync(filePath, JSON.stringify(initialData, null, 2));
+    console.log(`✅ Created ${options.file}`);
+    console.log(`\n📁 File location: ${filePath}`);
+    console.log(`\n🚀 Run '360-mock start' to start the server`);
+  });
+
+program
+  .command("reset")
+  .description("Reset/clear all mock data")
+  .option("-f, --file <filename>", "Data file name", "mock-data.json")
+  .action((options) => {
+    const filePath = path.join(process.cwd(), options.file);
+    if (!fs.existsSync(filePath)) {
+      console.log(`⚠️  ${options.file} not found!`);
+      return;
+    }
+    fs.writeFileSync(filePath, JSON.stringify({}, null, 2));
+    console.log(`✅ Reset ${options.file} - All data cleared!`);
+  });
+
+program
+  .command("list")
+  .description("List all available resources")
+  .option("-f, --file <filename>", "Data file name", "mock-data.json")
+  .action((options) => {
+    const filePath = path.join(process.cwd(), options.file);
+    if (!fs.existsSync(filePath)) {
+      console.log(`⚠️  ${options.file} not found! Run '360-mock init' first.`);
+      return;
+    }
+    try {
+      const data = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+      const resources = Object.keys(data).filter(k => !k.startsWith("_"));
+      console.log(`\n📦 Available Resources in ${options.file}:\n`);
+      if (resources.length === 0) {
+        console.log("   No resources yet. POST to any endpoint to create one!");
+      } else {
+        resources.forEach(resource => {
+          const count = Array.isArray(data[resource]) ? data[resource].length : 0;
+          console.log(`   /${resource} (${count} items)`);
+        });
+      }
+      console.log("");
+    } catch (err) {
+      console.log(`❌ Error reading ${options.file}`);
+    }
+  });
+
+program.parse();

package/lib/server.js

@@ -0,0 +1,254 @@
+const express = require("express");
+const fs = require("fs");
+const path = require("path");
+const cors = require("cors");
+
+const app = express();
+const PORT = process.env.PORT || 3000;
+const DATA_FILE = process.env.DATA_FILE || path.join(process.cwd(), "mock-data.json");
+
+app.use(cors());
+app.use(express.json());
+
+const readData = () => {
+  try {
+    if (!fs.existsSync(DATA_FILE)) {
+      fs.writeFileSync(DATA_FILE, JSON.stringify({}, null, 2));
+      return {};
+    }
+    const raw = fs.readFileSync(DATA_FILE, "utf-8");
+    return raw ? JSON.parse(raw) : {};
+  } catch (err) {
+    return {};
+  }
+};
+
+const writeData = (data) => {
+  fs.writeFileSync(DATA_FILE, JSON.stringify(data, null, 2));
+};
+
+const getSingularName = (resource) => {
+  if (resource.endsWith("ies")) {
+    return resource.slice(0, -3) + "y";
+  }
+  if (resource.endsWith("s")) {
+    return resource.slice(0, -1);
+  }
+  return resource;
+};
+
+app.use((req, res, next) => {
+  const timestamp = new Date().toLocaleTimeString();
+  console.log(`[${timestamp}] 📥 ${req.method} ${req.url}`);
+  if (req.body && Object.keys(req.body).length > 0) {
+    console.log(`           Body:`, JSON.stringify(req.body));
+  }
+  next();
+});
+
+app.get("/", (req, res) => {
+  const data = readData();
+  const resources = Object.keys(data).filter(k => !k.startsWith("_"));
+  res.json({
+    message: "🚀 Mock API Server Running",
+    dataFile: DATA_FILE,
+    availableResources: resources,
+    endpoints: {
+      "GET /:resource": "Get all items",
+      "GET /:resource/:id": "Get single item",
+      "POST /:resource": "Create new item",
+      "PUT /:resource/:id": "Replace item",
+      "PATCH /:resource/:id": "Update item",
+      "DELETE /:resource/:id": "Delete item"
+    }
+  });
+});
+
+app.get("/:resource", (req, res) => {
+  const { resource } = req.params;
+  const data = readData();
+  if (!data[resource]) {
+    data[resource] = [];
+    writeData(data);
+  }
+  let items = [...data[resource]];
+  const queryParams = req.query;
+  if (Object.keys(queryParams).length > 0) {
+    items = items.filter(item => {
+      return Object.entries(queryParams).every(([key, value]) => {
+        if (key === "_limit" || key === "_page" || key === "_sort" || key === "_order") {
+          return true;
+        }
+        return String(item[key]).toLowerCase().includes(String(value).toLowerCase());
+      });
+    });
+  }
+  if (queryParams._sort) {
+    const sortField = queryParams._sort;
+    const order = queryParams._order === "desc" ? -1 : 1;
+    items.sort((a, b) => {
+      if (a[sortField] < b[sortField]) return -1 * order;
+      if (a[sortField] > b[sortField]) return 1 * order;
+      return 0;
+    });
+  }
+  if (queryParams._limit) {
+    const limit = parseInt(queryParams._limit);
+    const page = parseInt(queryParams._page) || 1;
+    const start = (page - 1) * limit;
+    items = items.slice(start, start + limit);
+  }
+  console.log(`           ✅ Returning ${items.length} ${resource}`);
+  res.json(items);
+});
+
+app.get("/:resource/:id", (req, res) => {
+  const { resource, id } = req.params;
+  const data = readData();
+  if (!data[resource]) {
+    data[resource] = [];
+    writeData(data);
+  }
+  const item = data[resource].find((item) => String(item.id) === String(id));
+  if (!item) {
+    return res.status(404).json({ 
+      error: `${getSingularName(resource)} not found`,
+      id: id
+    });
+  }
+  console.log(`           ✅ Found ${getSingularName(resource)} #${id}`);
+  return res.json(item);
+});
+
+app.post("/:resource", (req, res) => {
+  const { resource } = req.params;
+  const data = readData();
+  if (!data[resource]) {
+    data[resource] = [];
+    console.log(`           📁 Created new resource: ${resource}`);
+  }
+  const newId = req.body.id || Date.now();
+  if (data[resource].some(item => String(item.id) === String(newId))) {
+    return res.status(409).json({
+      error: "Item with this ID already exists",
+      id: newId
+    });
+  }
+  const newItem = {
+    id: newId,
+    ...req.body,
+    createdAt: new Date().toISOString()
+  };
+  data[resource].push(newItem);
+  writeData(data);
+  console.log(`           ✅ Created ${getSingularName(resource)} #${newItem.id}`);
+  res.status(201).json(newItem);
+});
+
+app.put("/:resource/:id", (req, res) => {
+  const { resource, id } = req.params;
+  const data = readData();
+  if (!data[resource]) {
+    return res.status(404).json({ 
+      error: `Resource '${resource}' not found`
+    });
+  }
+  const index = data[resource].findIndex((item) => String(item.id) === String(id));
+  if (index === -1) {
+    return res.status(404).json({ 
+      error: `${getSingularName(resource)} not found`,
+      id: id
+    });
+  }
+  data[resource][index] = {
+    id: data[resource][index].id,
+    ...req.body,
+    updatedAt: new Date().toISOString()
+  };
+  writeData(data);
+  console.log(`           ✅ Replaced ${getSingularName(resource)} #${id}`);
+  res.json(data[resource][index]);
+});
+
+app.patch("/:resource/:id", (req, res) => {
+  const { resource, id } = req.params;
+  const data = readData();
+  if (!data[resource]) {
+    return res.status(404).json({ 
+      error: `Resource '${resource}' not found`
+    });
+  }
+  const index = data[resource].findIndex((item) => String(item.id) === String(id));
+  if (index === -1) {
+    return res.status(404).json({ 
+      error: `${getSingularName(resource)} not found`,
+      id: id
+    });
+  }
+  data[resource][index] = {
+    ...data[resource][index],
+    ...req.body,
+    updatedAt: new Date().toISOString()
+  };
+  writeData(data);
+  console.log(`           ✅ Updated ${getSingularName(resource)} #${id}`);
+  res.json(data[resource][index]);
+});
+
+app.delete("/:resource/:id", (req, res) => {
+  const { resource, id } = req.params;
+  const data = readData();
+  if (!data[resource]) {
+    return res.status(404).json({ 
+      error: `Resource '${resource}' not found`
+    });
+  }
+  const index = data[resource].findIndex((item) => String(item.id) === String(id));
+  if (index === -1) {
+    return res.status(404).json({ 
+      error: `${getSingularName(resource)} not found`,
+      id: id
+    });
+  }
+  const deletedItem = data[resource].splice(index, 1)[0];
+  writeData(data);
+  console.log(`           ✅ Deleted ${getSingularName(resource)} #${id}`);
+  res.json({ 
+    message: `${getSingularName(resource)} deleted`,
+    deleted: deletedItem
+  });
+});
+
+app.delete("/:resource", (req, res) => {
+  const { resource } = req.params;
+  const data = readData();
+  if (!data[resource]) {
+    return res.status(404).json({ 
+      error: `Resource '${resource}' not found`
+    });
+  }
+  const count = data[resource].length;
+  data[resource] = [];
+  writeData(data);
+  console.log(`           ✅ Cleared all ${resource} (${count} items)`);
+  res.json({ 
+    message: `All ${resource} deleted`,
+    deletedCount: count
+  });
+});
+
+app.use((req, res) => {
+  res.status(404).json({ error: "Endpoint not found" });
+});
+
+app.use((err, req, res, next) => {
+  console.error("❌ Error:", err.message);
+  res.status(500).json({ error: "Internal server error" });
+});
+
+app.listen(PORT, () => {
+  console.log(`\n🚀 Mock API Server running on port ${PORT}`);
+  console.log(`📁 Data file: ${DATA_FILE}\n`);
+});
+
+module.exports = app;

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "360-mock-server",
+  "version": "1.0.0",
+  "description": "🚀 Zero-config dynamic mock REST API server for frontend developers",
+  "main": "lib/server.js",
+  "bin": {
+    "360-mock": "./bin/cli.js"
+  },
+  "scripts": {
+    "start": "node lib/server.js",
+    "test": "echo \"No tests yet\""
+  },
+  "keywords": [
+    "mock",
+    "api",
+    "rest",
+    "server",
+    "json",
+    "fake",
+    "backend",
+    "frontend",
+    "development",
+    "testing",
+    "crud"
+  ],
+  "author": "zahidrahimoon",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zahidrahimoon/mock-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/zahidrahimoon/mock-server/issues"
+  },
+  "homepage": "https://github.com/zahidrahimoon/mock-server#readme",
+  "files": [
+    "bin/",
+    "lib/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "dependencies": {
+    "commander": "^11.1.0",
+    "cors": "^2.8.5",
+    "express": "^4.18.2"
+  }
+}