json-api-mocker 1.0.3 → 1.2.0

package/CONFIG.ch.md

@@ -0,0 +1,305 @@
+# JSON API Mocker 配置指南
+
+本文档将帮助你理解和编写 `data.json` 配置文件。
+
+## 配置文件结构
+
+```json
+{
+  "server": {
+    "port": 8080,
+    "baseProxy": "/api"
+  },
+  "routes": []
+}
+```
+
+## 配置项详解
+
+### 1. 服务器配置 (server)
+
+| 字段 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| port | number | 否 | 8080 | 服务器端口号 |
+| baseProxy | string | 否 | "/api" | API 的基础路径 |
+
+### 2. 路由配置 (routes)
+
+routes 是一个数组，每个元素都是一个路由配置对象：
+
+```json
+{
+  "path": "/users",
+  "methods": {
+    "get": {},
+    "post": {},
+    "put": {},
+    "delete": {}
+  }
+}
+```
+
+#### 2.1 路由基础配置
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| path | string | 是 | 路由路径，支持参数如 `/users/:id` |
+| methods | object | 是 | HTTP 方法配置对象 |
+
+#### 2.2 方法配置 (methods)
+
+每个 HTTP 方法可以包含以下配置：
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| type | string | 否 | 响应类型："array" 或 "object" |
+| response | any | 否 | 静态响应数据 |
+| mock | object | 否 | Mock.js 配置 |
+| pagination | object | 否 | 分页配置 |
+| requestSchema | object | 否 | 请求体验证模式 |
+
+### 3. Mock 数据配置 (mock)
+
+```json
+{
+  "mock": {
+    "enabled": true,
+    "total": 100,
+    "template": {
+      "id|+1": 1,
+      "name": "@cname",
+      "email": "@email"
+    }
+  }
+}
+```
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| enabled | boolean | 是 | 是否启用 mock 数据 |
+| total | number | 是 | 生成数据的总条数 |
+| template | object | 是 | Mock.js 的数据模板 |
+
+### 4. 分页配置 (pagination)
+
+```json
+{
+  "pagination": {
+    "enabled": true,
+    "pageSize": 10
+  }
+}
+```
+
+| 字段 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| enabled | boolean | 否 | false | 是否启用分页 |
+| pageSize | number | 否 | 10 | 每页数据条数 |
+
+### 5. 请求验证配置 (requestSchema)
+
+```json
+{
+  "requestSchema": {
+    "name": "string",
+    "age": "number",
+    "email": "string"
+  }
+}
+```
+
+## Mock.js 模板使用说明
+
+### 常用模板示例
+
+- `@cname` - 生成中文姓名
+- `@name` - 生成英文姓名
+- `@email` - 生成邮箱地址
+- `@datetime` - 生成日期时间
+- `@image` - 生成图片链接
+- `@city` - 生成城市名
+- `@id` - 生成随机 ID
+- `@guid` - 生成 GUID
+- `@ctitle` - 生成中文标题
+- `@cparagraph` - 生成中文段落
+- `|+1` - 自增数字
+
+## 完整配置示例
+
+### 1. 用户管理接口
+
+```json
+{
+  "server": {
+    "port": 8080,
+    "baseProxy": "/api"
+  },
+  "routes": [
+    {
+      "path": "/users",
+      "methods": {
+        "get": {
+          "type": "array",
+          "mock": {
+            "enabled": true,
+            "total": 100,
+            "template": {
+              "id|+1": 1,
+              "name": "@cname",
+              "age|18-60": 1,
+              "email": "@email",
+              "address": "@city(true)"
+            }
+          },
+          "pagination": {
+            "enabled": true,
+            "pageSize": 10
+          }
+        },
+        "post": {
+          "requestSchema": {
+            "name": "string",
+            "age": "number",
+            "email": "string"
+          },
+          "response": {
+            "success": true,
+            "message": "创建成功"
+          }
+        }
+      }
+    }
+  ]
+}
+```
+
+### 2. 文章管理接口（带嵌套数据）
+
+```json
+{
+  "path": "/articles",
+  "methods": {
+    "get": {
+      "type": "array",
+      "mock": {
+        "enabled": true,
+        "total": 50,
+        "template": {
+          "id|+1": 1,
+          "title": "@ctitle",
+          "content": "@cparagraph",
+          "author": {
+            "id|+1": 100,
+            "name": "@cname",
+            "avatar": "@image('100x100')"
+          },
+          "comments|0-10": [{
+            "id|+1": 1,
+            "content": "@csentence",
+            "user": "@cname",
+            "createTime": "@datetime"
+          }]
+        }
+      }
+    }
+  }
+}
+```
+
+## 使用技巧
+
+### 1. 动态路由参数
+```json
+{
+  "path": "/users/:id/posts",
+  "methods": {
+    "get": {
+      "type": "array",
+      "mock": {
+        "enabled": true,
+        "total": 10,
+        "template": {
+          "id|+1": 1,
+          "title": "@ctitle",
+          "content": "@cparagraph"
+        }
+      }
+    }
+  }
+}
+```
+
+### 2. 分页查询
+```bash
+# 获取第二页，每页10条数据
+curl http://localhost:8080/api/users?page=2&pageSize=10
+```
+
+### 3. 数据范围生成
+```json
+{
+  "template": {
+    "age|18-60": 1,        // 生成18-60之间的数字
+    "score|1-100.1": 1,    // 生成1-100之间的浮点数，保留1位小数
+    "items|1-5": ["item"]  // 生成1-5个重复项
+  }
+}
+```
+
+## 注意事项
+
+1. **路径参数**
+   - 动态路由参数使用 `:参数名` 格式
+   - 例如：`/users/:id/posts/:postId`
+
+2. **Mock 数据**
+   - `enabled` 为 `true` 时才会生成 mock 数据
+   - `template` 中可以使用所有 Mock.js 支持的语法
+
+3. **分页**
+   - 启用分页后，可通过 `?page=1&pageSize=10` 访问分页数据
+   - 响应头会包含 `X-Total-Count` 表示总数据量
+
+4. **数据持久化**
+   - POST、PUT、DELETE 操作会自动保存到 data.json 文件
+   - 重启服务器后数据仍然保留
+
+## 最佳实践
+
+1. **合理使用 Mock 数据**
+   ```json
+   {
+     "mock": {
+       "enabled": true,
+       "total": 100,
+       "template": {
+         // 使用自增ID避免重复
+         "id|+1": 1,
+         // 使用合适的数据类型
+         "age|18-60": 1
+       }
+     }
+   }
+   ```
+
+2. **适当的分页配置**
+   ```json
+   {
+     "pagination": {
+       "enabled": true,
+       "pageSize": 10  // 根据数据量设置合适的页大小
+     }
+   }
+   ```
+
+3. **请求验证**
+   ```json
+   {
+     "requestSchema": {
+       // 确保必要的字段都有类型验证
+       "name": "string",
+       "age": "number",
+       "email": "string"
+     }
+   }
+   ``` 

package/CONFIG.md

@@ -0,0 +1,271 @@
+# JSON API Mocker Configuration Guide
+
+A comprehensive guide to help you understand and write the `data.json` configuration file.
+
+## Configuration Structure
+
+```json
+{
+  "server": {
+    "port": 8080,
+    "baseProxy": "/api"
+  },
+  "routes": []
+}
+```
+
+## Configuration Details
+
+### 1. Server Configuration (server)
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| port | number | No | 8080 | Server port number |
+| baseProxy | string | No | "/api" | Base path for all APIs |
+
+### 2. Routes Configuration (routes)
+
+Routes is an array where each element is a route configuration object:
+
+```json
+{
+  "path": "/users",
+  "methods": {
+    "get": {},
+    "post": {},
+    "put": {},
+    "delete": {}
+  }
+}
+```
+
+#### 2.1 Route Basic Configuration
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| path | string | Yes | Route path, supports parameters like `/users/:id` |
+| methods | object | Yes | HTTP methods configuration object |
+
+#### 2.2 Method Configuration (methods)
+
+Each HTTP method can include the following configurations:
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| type | string | No | Response type: "array" or "object" |
+| response | any | No | Static response data |
+| mock | object | No | Mock.js configuration |
+| pagination | object | No | Pagination configuration |
+| requestSchema | object | No | Request body validation schema |
+
+### 3. Mock Data Configuration (mock)
+
+```json
+{
+  "mock": {
+    "enabled": true,
+    "total": 100,
+    "template": {
+      "id|+1": 1,
+      "name": "@name",
+      "email": "@email"
+    }
+  }
+}
+```
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| enabled | boolean | Yes | Enable/disable mock data |
+| total | number | Yes | Total number of records to generate |
+| template | object | Yes | Mock.js data template |
+
+### 4. Pagination Configuration (pagination)
+
+```json
+{
+  "pagination": {
+    "enabled": true,
+    "pageSize": 10
+  }
+}
+```
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| enabled | boolean | No | false | Enable/disable pagination |
+| pageSize | number | No | 10 | Number of items per page |
+
+### 5. Request Validation Configuration (requestSchema)
+
+```json
+{
+  "requestSchema": {
+    "name": "string",
+    "age": "number",
+    "email": "string"
+  }
+}
+```
+
+## Complete Configuration Examples
+
+### 1. Basic User CRUD API
+
+```json
+{
+  "server": {
+    "port": 8080,
+    "baseProxy": "/api"
+  },
+  "routes": [
+    {
+      "path": "/users",
+      "methods": {
+        "get": {
+          "type": "array",
+          "mock": {
+            "enabled": true,
+            "total": 100,
+            "template": {
+              "id|+1": 1,
+              "name": "@name",
+              "age|18-60": 1,
+              "email": "@email",
+              "address": "@city"
+            }
+          },
+          "pagination": {
+            "enabled": true,
+            "pageSize": 10
+          }
+        },
+        "post": {
+          "requestSchema": {
+            "name": "string",
+            "age": "number",
+            "email": "string"
+          },
+          "response": {
+            "success": true,
+            "message": "Created successfully"
+          }
+        }
+      }
+    }
+  ]
+}
+```
+
+### 2. Articles API with Nested Data
+
+```json
+{
+  "path": "/articles",
+  "methods": {
+    "get": {
+      "type": "array",
+      "mock": {
+        "enabled": true,
+        "total": 50,
+        "template": {
+          "id|+1": 1,
+          "title": "@title",
+          "content": "@paragraph",
+          "author": {
+            "id|+1": 100,
+            "name": "@name",
+            "avatar": "@image('100x100')"
+          },
+          "comments|0-10": [{
+            "id|+1": 1,
+            "content": "@sentence",
+            "user": "@name",
+            "createTime": "@datetime"
+          }]
+        }
+      }
+    }
+  }
+}
+```
+
+### 3. Dynamic Route Parameters Example
+
+```json
+{
+  "path": "/users/:id/posts",
+  "methods": {
+    "get": {
+      "type": "array",
+      "mock": {
+        "enabled": true,
+        "total": 10,
+        "template": {
+          "id|+1": 1,
+          "title": "@title",
+          "content": "@paragraph"
+        }
+      }
+    }
+  }
+}
+```
+
+## Important Notes
+
+1. **Route Parameters**
+   - Dynamic route parameters use `:paramName` format
+   - Example: `/users/:id/posts/:postId`
+
+2. **Mock Data**
+   - Mock data generation only works when `enabled` is `true`
+   - `template` supports all Mock.js syntax
+
+3. **Pagination**
+   - When enabled, use `?page=1&pageSize=10` to access paginated data
+   - Response headers include `X-Total-Count` for total count
+
+4. **Data Persistence**
+   - POST, PUT, DELETE operations automatically save to data.json
+   - Data persists after server restart
+
+## Best Practices
+
+1. **Effective Use of Mock Data**
+   ```json
+   {
+     "mock": {
+       "enabled": true,
+       "total": 100,
+       "template": {
+         // Use auto-increment for IDs
+         "id|+1": 1,
+         // Use appropriate data types
+         "age|18-60": 1
+       }
+     }
+   }
+   ```
+
+2. **Proper Pagination Settings**
+   ```json
+   {
+     "pagination": {
+       "enabled": true,
+       "pageSize": 10  // Set appropriate page size based on data volume
+     }
+   }
+   ```
+
+3. **Request Validation**
+   ```json
+   {
+     "requestSchema": {
+       // Ensure all required fields have type validation
+       "name": "string",
+       "age": "number",
+       "email": "string"
+     }
+   }
+   ``` 

package/README.ch.md

@@ -3,11 +3,12 @@
 一个轻量级且灵活的 Mock 服务器，通过 JSON 配置快速创建 RESTful API。
 
 <p align="center">
-  <img src="https://img.shields.io/npm/v/json-mock-server" alt="npm 版本" />
-  <img src="https://img.shields.io/npm/l/json-mock-server" alt="许可证" />
-  <img src="https://img.shields.io/npm/dt/json-mock-server" alt="下载量" />
+  <img src="https://img.shields.io/npm/v/json-api-mocker" alt="npm version" />
+  <img src="https://img.shields.io/npm/l/json-api-mocker" alt="license" />
+  <img src="https://img.shields.io/npm/dt/json-api-mocker" alt="downloads" />
 </p>
 
+
 ## ✨ 特性
 
 - 🚀 通过 JSON 配置快速搭建
@@ -15,6 +16,7 @@
 - 📝 自动数据持久化
 - 🔍 内置分页支持
 - 🛠 可自定义响应结构
+- 💡 集成 Mock.js 实现强大的数据模拟
 - 💡 TypeScript 支持
 
 ## 📦 安装
@@ -152,6 +154,105 @@ Mock 服务器已启动：
 }
 ```
 
+### Mock.js 集成
+
+你可以使用 Mock.js 模板来生成动态数据：
+
+```json
+{
+  "path": "/users",
+  "methods": {
+    "get": {
+      "type": "array",
+      "mock": {
+        "enabled": true,
+        "total": 200,
+        "template": {
+          "id|+1": 1,
+          "name": "@cname",
+          "email": "@email",
+          "age|18-60": 1,
+          "address": "@city(true)",
+          "avatar": "@image('200x200')",
+          "createTime": "@datetime"
+        }
+      },
+      "pagination": {
+        "enabled": true,
+        "pageSize": 10
+      }
+    }
+  }
+}
+```
+
+#### 可用的 Mock.js 模板
+
+- `@cname` - 生成中文姓名
+- `@name` - 生成英文姓名
+- `@email` - 生成邮箱地址
+- `@datetime` - 生成日期时间
+- `@image` - 生成图片链接
+- `@city` - 生成城市名
+- `@id` - 生成随机 ID
+- `@guid` - 生成 GUID
+- `@title` - 生成标题
+- `@paragraph` - 生成段落
+- `|+1` - 自增数字
+
+更多 Mock.js 模板请访问 [Mock.js 文档](http://mockjs.com/examples.html)
+
+#### Mock.js 使用示例
+
+1. 生成用户列表：
+```json
+{
+  "mock": {
+    "enabled": true,
+    "total": 100,
+    "template": {
+      "id|+1": 1,
+      "name": "@cname",
+      "email": "@email"
+    }
+  }
+}
+```
+
+2. 生成文章列表：
+```json
+{
+  "mock": {
+    "enabled": true,
+    "total": 50,
+    "template": {
+      "id|+1": 1,
+      "title": "@ctitle",
+      "content": "@cparagraph",
+      "author": "@cname",
+      "publishDate": "@datetime"
+    }
+  }
+}
+```
+
+3. 生成商品列表：
+```json
+{
+  "mock": {
+    "enabled": true,
+    "total": 30,
+    "template": {
+      "id|+1": 1,
+      "name": "@ctitle(3, 5)",
+      "price|100-1000.2": 1,
+      "category": "@pick(['电子产品', '图书', '服装'])",
+      "image": "@image('200x200', '#50B347', '#FFF', 'Mock.js')"
+    }
+  }
+}
+```
+
 ## 🎯 API 示例
 
 ### 基本的 CRUD 操作

package/README.md

@@ -15,6 +15,7 @@ A lightweight and flexible mock server that uses JSON configuration to quickly c
 - 📝 Automatic data persistence
 - 🔍 Built-in pagination support
 - 🛠 Customizable response schemas
+- 💡 Integration with Mock.js for powerful data mocking
 - 💡 TypeScript support
 
 ## 📦 Installation
@@ -152,6 +153,104 @@ Each route can support multiple HTTP methods:
 }
 ```
 
+### Mock.js Integration
+
+You can use Mock.js templates to generate dynamic data:
+
+```json
+{
+  "path": "/users",
+  "methods": {
+    "get": {
+      "type": "array",
+      "mock": {
+        "enabled": true,
+        "total": 200,
+        "template": {
+          "id|+1": 1,
+          "name": "@name",
+          "email": "@email",
+          "age|18-60": 1,
+          "address": "@city(true)",
+          "avatar": "@image('200x200')",
+          "createTime": "@datetime"
+        }
+      },
+      "pagination": {
+        "enabled": true,
+        "pageSize": 10
+      }
+    }
+  }
+}
+```
+
+#### Available Mock.js Templates
+
+- `@name` - Generate random name
+- `@email` - Generate random email
+- `@datetime` - Generate random datetime
+- `@image` - Generate random image URL
+- `@city` - Generate random city name
+- `@id` - Generate random ID
+- `@guid` - Generate GUID
+- `@title` - Generate random title
+- `@paragraph` - Generate random paragraph
+- `|+1` - Auto increment number
+
+For more Mock.js templates, visit [Mock.js Documentation](http://mockjs.com/examples.html)
+
+#### Examples with Mock.js
+
+1. Generate user list with random data:
+```json
+{
+  "mock": {
+    "enabled": true,
+    "total": 100,
+    "template": {
+      "id|+1": 1,
+      "name": "@name",
+      "email": "@email"
+    }
+  }
+}
+```
+
+2. Generate article list with random content:
+```json
+{
+  "mock": {
+    "enabled": true,
+    "total": 50,
+    "template": {
+      "id|+1": 1,
+      "title": "@title",
+      "content": "@paragraph",
+      "author": "@name",
+      "publishDate": "@datetime"
+    }
+  }
+}
+```
+
+3. Generate product list with random prices:
+```json
+{
+  "mock": {
+    "enabled": true,
+    "total": 30,
+    "template": {
+      "id|+1": 1,
+      "name": "@title(3, 5)",
+      "price|100-1000.2": 1,
+      "category": "@pick(['Electronics', 'Books', 'Clothing'])",
+      "image": "@image('200x200', '#50B347', '#FFF', 'Mock.js')"
+    }
+  }
+}
+```
+
 ## 🎯 API Examples
 
 ### Basic CRUD Operations

package/dist/server.d.ts

@@ -5,14 +5,9 @@ export declare class MockServer {
     private configPath;
     constructor(config: Config, configPath?: string);
     private setupMiddleware;
+    private generateMockData;
+    private handleRequest;
     private setupRoutes;
-    private saveConfig;
-    private findUserById;
-    private getNextUserId;
     private createRoute;
-    private handleRequest;
-    private handlePostRequest;
-    private handlePutRequest;
-    private handleDeleteRequest;
     start(): void;
 }

package/dist/server.js

@@ -4,15 +4,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MockServer = void 0;
+const mockjs_1 = __importDefault(require("mockjs"));
 const express_1 = __importDefault(require("express"));
 const cors_1 = __importDefault(require("cors"));
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
 class MockServer {
     constructor(config, configPath = 'data.json') {
         this.app = (0, express_1.default)();
         this.config = config;
-        this.configPath = path_1.default.resolve(process.cwd(), configPath);
+        this.configPath = configPath;
         this.setupMiddleware();
         this.setupRoutes();
     }
@@ -20,6 +19,43 @@ class MockServer {
         this.app.use((0, cors_1.default)());
         this.app.use(express_1.default.json());
     }
+    generateMockData(config) {
+        try {
+            if (config.mock?.enabled && config.mock.template) {
+                const { total, template } = config.mock;
+                return mockjs_1.default.mock({
+                    [`data|${total}`]: [template]
+                }).data;
+            }
+            return config.response;
+        }
+        catch (error) {
+            console.error('生成 Mock 数据时出错:', error);
+            return config.response;
+        }
+    }
+    handleRequest(config) {
+        return (req, res) => {
+            try {
+                console.log(`收到请求: ${req.method} ${req.url}`);
+                let responseData = this.generateMockData(config);
+                if (config.pagination?.enabled && Array.isArray(responseData)) {
+                    const page = parseInt(req.query.page) || 1;
+                    const pageSize = parseInt(req.query.pageSize) || config.pagination.pageSize;
+                    const startIndex = (page - 1) * pageSize;
+                    const endIndex = startIndex + pageSize;
+                    const paginatedData = responseData.slice(startIndex, endIndex);
+                    res.header('X-Total-Count', responseData.length.toString());
+                    responseData = paginatedData;
+                }
+                res.json(responseData);
+            }
+            catch (error) {
+                console.error('处理请求时出错:', error);
+                res.status(500).json({ error: '服务器内部错误' });
+            }
+        };
+    }
     setupRoutes() {
         this.config.routes.forEach((route) => {
             Object.entries(route.methods).forEach(([method, methodConfig]) => {
@@ -27,28 +63,6 @@ class MockServer {
             });
         });
     }
-    saveConfig() {
-        fs_1.default.writeFileSync(this.configPath, JSON.stringify(this.config, null, 2), 'utf-8');
-    }
-    findUserById(id) {
-        const usersRoute = this.config.routes.find(route => route.path === '/users');
-        if (!usersRoute)
-            return null;
-        const getMethod = usersRoute.methods.get;
-        if (!getMethod || !Array.isArray(getMethod.response))
-            return null;
-        return getMethod.response.find(user => user.id === id);
-    }
-    getNextUserId() {
-        const usersRoute = this.config.routes.find(route => route.path === '/users');
-        if (!usersRoute)
-            return 1;
-        const getMethod = usersRoute.methods.get;
-        if (!getMethod || !Array.isArray(getMethod.response))
-            return 1;
-        const maxId = Math.max(...getMethod.response.map(user => user.id));
-        return maxId + 1;
-    }
     createRoute(path, method, config) {
         const fullPath = `${this.config.server.baseProxy}${path}`;
         console.log(`创建路由: ${method.toUpperCase()} ${fullPath}`);
@@ -57,87 +71,16 @@ class MockServer {
                 this.app.get(fullPath, this.handleRequest(config));
                 break;
             case 'post':
-                this.app.post(fullPath, this.handlePostRequest(config));
+                this.app.post(fullPath, this.handleRequest(config));
                 break;
             case 'put':
-                this.app.put(`${fullPath}/:id`, this.handlePutRequest(config));
+                this.app.put(`${fullPath}/:id`, this.handleRequest(config));
                 break;
             case 'delete':
-                this.app.delete(`${fullPath}/:id`, this.handleDeleteRequest(config));
+                this.app.delete(`${fullPath}/:id`, this.handleRequest(config));
                 break;
         }
     }
-    handleRequest(config) {
-        return (req, res) => {
-            console.log(`收到请求: ${req.method} ${req.url}`);
-            if (config.pagination?.enabled && config.type === 'array') {
-                const page = parseInt(req.query.page) || 1;
-                const pageSize = parseInt(req.query.pageSize) || config.pagination.pageSize;
-                const startIndex = (page - 1) * pageSize;
-                const endIndex = startIndex + pageSize;
-                const data = config.response.slice(startIndex, endIndex);
-                res.header('X-Total-Count', config.pagination.totalCount.toString());
-                res.json(data);
-            }
-            else {
-                res.json(config.response);
-            }
-        };
-    }
-    handlePostRequest(config) {
-        return (req, res) => {
-            console.log(`收到创建请求: ${req.url}`, req.body);
-            const usersRoute = this.config.routes.find(route => route.path === '/users');
-            if (!usersRoute) {
-                return res.status(404).json({ error: '路由未找到' });
-            }
-            const getMethod = usersRoute.methods.get;
-            if (!getMethod || !Array.isArray(getMethod.response)) {
-                return res.status(500).json({ error: '数据格式错误' });
-            }
-            const newUser = {
-                id: this.getNextUserId(),
-                ...req.body
-            };
-            getMethod.response.push(newUser);
-            this.saveConfig();
-            res.status(201).json(newUser);
-        };
-    }
-    handlePutRequest(config) {
-        return (req, res) => {
-            const userId = parseInt(req.params.id);
-            console.log(`收到更新请求: ${req.url}`, req.body);
-            const user = this.findUserById(userId);
-            if (!user) {
-                return res.status(404).json({ error: '用户未找到' });
-            }
-            Object.assign(user, req.body);
-            this.saveConfig();
-            res.json(user);
-        };
-    }
-    handleDeleteRequest(config) {
-        return (req, res) => {
-            const userId = parseInt(req.params.id);
-            console.log(`收到删除请求: ${req.url}`);
-            const usersRoute = this.config.routes.find(route => route.path === '/users');
-            if (!usersRoute) {
-                return res.status(404).json({ error: '路由未找到' });
-            }
-            const getMethod = usersRoute.methods.get;
-            if (!getMethod || !Array.isArray(getMethod.response)) {
-                return res.status(500).json({ error: '数据格式错误' });
-            }
-            const userIndex = getMethod.response.findIndex(user => user.id === userId);
-            if (userIndex === -1) {
-                return res.status(404).json({ error: '用户未找到' });
-            }
-            getMethod.response.splice(userIndex, 1);
-            this.saveConfig();
-            res.json({ success: true, message: '删除成功' });
-        };
-    }
     start() {
         this.app.listen(this.config.server.port, () => {
             console.log(`Mock 服务器已启动:`);

package/dist/types.d.ts

@@ -7,12 +7,17 @@ export interface PaginationConfig {
     pageSize: number;
     totalCount: number;
 }
+export interface MockConfig {
+    enabled: boolean;
+    total: number;
+    template: Record<string, any>;
+}
 export interface MethodConfig {
     type?: 'array' | 'object';
+    response?: any;
+    mock?: MockConfig;
     pagination?: PaginationConfig;
-    response: any;
     requestSchema?: Record<string, string>;
-    params?: string[];
 }
 export interface RouteConfig {
     path: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "json-api-mocker",
-  "version": "1.0.3",
+  "version": "1.2.0",
   "description": "一个基于 JSON 配置的 Mock 服务器",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -10,7 +10,9 @@
   "files": [
     "dist",
     "README.md",
-    "README.ch.md"
+    "README.ch.md",
+    "CONFIG.md",
+    "CONFIG.ch.md"
   ],
   "scripts": {
     "dev": "nodemon",
@@ -41,12 +43,14 @@
   "homepage": "https://github.com/Selteve/json-api-mocker#readme",
   "dependencies": {
     "cors": "^2.8.5",
-    "express": "^4.17.1"
+    "express": "^4.17.1",
+    "mockjs": "^1.1.0"
   },
   "devDependencies": {
     "@types/cors": "^2.8.13",
     "@types/express": "^4.17.13",
     "@types/jest": "^27.5.2",
+    "@types/mockjs": "^1.0.10",
     "@types/node": "^16.18.0",
     "jest": "^27.5.1",
     "nodemon": "^2.0.22",