@jonathanleelx/meddle 0.0.1

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "@jonathanleelx/meddle",
+  "version": "0.0.1",
+  "description": "A simple development proxy server with custom routing rules, mock responses, HTTPS interception, and a plugin system",
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "prebuild": "rm -rf dist",
+    "prepack": "npm run build:web && npm run build",
+    "prepublishOnly": "npm run build && npm run test",
+    "start": "npm run build && node index.js",
+    "start:plugin:off": "MEDDLE_PLUGIN_MODE=off npm start",
+    "start:plugin:shadow": "MEDDLE_PLUGIN_MODE=shadow npm start",
+    "start:plugin:on": "MEDDLE_PLUGIN_MODE=on npm start",
+    "smoke:refactor": "node scripts/refactor-smoke.js",
+    "drill:rollout": "node scripts/plugin-rollout-drill.js",
+    "test": "vitest run",
+    "test:identity": "pnpm run build && node scripts/application-identity-smoke.js",
+    "test:e2e": "npm run build:web && npm run build && node tests/e2e/interactions.e2e.cjs",
+    "test:e2e:rule-drag": "npm run build:web && npm run build && node tests/e2e/rule-drag.e2e.cjs",
+    "test:watch": "vitest",
+    "test:refactor": "npm run build && node -c index.js && npm test",
+    "bench:logs": "node scripts/log-performance-benchmark.js",
+    "start:open": "npm run build && node index.js --open",
+    "doctor": "node bin/doctor.js",
+    "mcp": "node mcp-server.js",
+    "build:web": "cd web && pnpm run build",
+    "dev:web": "cd web && pnpm run dev",
+    "setup:web": "cd web && pnpm install"
+  },
+  "bin": {
+    "meddle": "bin/index"
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    "web/dist/",
+    "index.js",
+    "mcp-server.js",
+    "plugins/",
+    "LICENSE",
+    "CONFIG_STRUCTURE.md",
+    "README.md"
+  ],
+  "keywords": [
+    "proxy",
+    "dev-proxy",
+    "mock",
+    "https-proxy",
+    "debug",
+    "development",
+    "plugin"
+  ],
+  "author": "JonathanLee-LX",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JonathanLee-LX/meddle.git"
+  },
+  "homepage": "https://github.com/JonathanLee-LX/meddle#readme",
+  "bugs": {
+    "url": "https://github.com/JonathanLee-LX/meddle/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "chalk": "^4.1.2",
+    "chokidar": "^3.6.0",
+    "debug": "^4.4.3",
+    "esbuild": "^0.27.7",
+    "express": "^5.2.1",
+    "inquirer": "^8.2.7",
+    "node-easy-cert": "^1.3.3",
+    "portfinder": "^1.0.38",
+    "puppeteer-core": "^24.43.1",
+    "ws": "^8.21.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/debug": "^4.1.13",
+    "@types/express": "^5.0.6",
+    "@types/node": "^18.19.130",
+    "@types/ws": "^8.18.1",
+    "@vitest/coverage-v8": "^4.1.9",
+    "nodemon": "^2.0.22",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.9"
+  }
+}

package/plugins/builtin/index.ts

@@ -0,0 +1,25 @@
+import { Plugin, BuiltinPluginsOptions } from '../../core/types';
+
+export function createBuiltinPlugins(options: BuiltinPluginsOptions): Plugin[] {
+    const plugins: Plugin[] = [];
+    
+    if (options.enableMock) {
+        plugins.push(options.createMockPlugin({
+            findMatch: options.findMockMatch!,
+        }));
+    }
+    
+    if (options.enableRouter) {
+        plugins.push(options.createRouterPlugin({
+            getRuleMap: options.getRuleMap!,
+            getExcludeMap: options.getExcludeMap,
+            getRouteRules: options.getRouteRules,
+        }));
+    }
+    
+    if (options.enableLogger && options.loggerPlugin) {
+        plugins.push(options.loggerPlugin);
+    }
+    
+    return plugins;
+}

package/plugins/builtin/logger-plugin.ts

@@ -0,0 +1,126 @@
+import { Plugin, LoggerPluginOptions, HookContext, ResponseContext, ErrorContext, LoggerEntry, LoggerSummary } from '../../core/types';
+
+type StatusBucket = '2xx' | '3xx' | '4xx' | '5xx' | 'other';
+
+interface LoggerPlugin extends Plugin {
+    getRecentEntries(): LoggerEntry[];
+    getSummary(): LoggerSummary;
+}
+
+export function createBuiltinLoggerPlugin(options: LoggerPluginOptions = {}): LoggerPlugin {
+    const maxEntries = typeof options.maxEntries === 'number' ? options.maxEntries : 1000;
+    const entries: LoggerEntry[] = [];
+    const counters = {
+        totalResponses: 0,
+        totalErrors: 0,
+        byMethod: Object.create(null) as Record<string, number>,
+        byStatusBucket: {
+            '2xx': 0,
+            '3xx': 0,
+            '4xx': 0,
+            '5xx': 0,
+            other: 0,
+        },
+        duration: {
+            min: null as number | null,
+            max: null as number | null,
+            sum: 0,
+        },
+    };
+
+    return {
+        manifest: {
+            id: 'builtin.logger',
+            name: 'Builtin Logger Plugin',
+            version: '1.0.0',
+            apiVersion: '1.x',
+            type: 'builtin',
+            permissions: ['proxy:read', 'storage:write'],
+            hooks: ['onRequestStart', 'onAfterResponse', 'onError'],
+            priority: 90,
+        },
+        async setup() {},
+        onRequestStart(ctx: HookContext): void {
+            ctx.meta._pluginRequestStartAt = Date.now();
+        },
+        onAfterResponse(ctx: ResponseContext): void {
+            const startAt = (ctx.meta._pluginRequestStartAt as number) || Date.now();
+            const duration = Date.now() - startAt;
+            const statusCode = ctx.response.statusCode;
+            const method = String(ctx.request.method || 'UNKNOWN').toUpperCase();
+
+            // 获取路由匹配信息
+            const matchedRule = ctx.meta.matchedRule;
+            const matchedTarget = ctx.meta.matchedTarget;
+            const mockRuleId = ctx.meta.mockRuleId;
+            const mockRuleName = ctx.meta.mockRuleName;
+            const routerMatched = ctx.meta.routerMatched;
+
+            // 判断命中类型
+            let hitType: 'route' | 'mock' | 'direct' = 'direct';
+            if (mockRuleId) {
+                hitType = 'mock';
+            } else if (routerMatched) {
+                hitType = 'route';
+            }
+
+            entries.push({
+                type: 'response',
+                method,
+                url: ctx.request.url,
+                statusCode,
+                duration,
+                ts: Date.now(),
+                matchedRule,
+                matchedTarget,
+                mockRuleId,
+                mockRuleName,
+                hitType,
+            });
+            
+            counters.totalResponses += 1;
+            counters.byMethod[method] = (counters.byMethod[method] || 0) + 1;
+            const bucket = statusToBucket(statusCode);
+            counters.byStatusBucket[bucket] += 1;
+            counters.duration.sum += duration;
+            counters.duration.min = counters.duration.min == null ? duration : Math.min(counters.duration.min, duration);
+            counters.duration.max = counters.duration.max == null ? duration : Math.max(counters.duration.max, duration);
+            
+            if (entries.length > maxEntries) entries.shift();
+        },
+        onError(ctx: ErrorContext): void {
+            entries.push({
+                type: 'error',
+                phase: ctx.phase,
+                message: ctx.error ? ctx.error.message : 'unknown',
+                ts: Date.now(),
+            });
+            counters.totalErrors += 1;
+            if (entries.length > maxEntries) entries.shift();
+        },
+        getRecentEntries(): LoggerEntry[] {
+            return entries.slice();
+        },
+        getSummary(): LoggerSummary {
+            return {
+                totalResponses: counters.totalResponses,
+                totalErrors: counters.totalErrors,
+                byMethod: { ...counters.byMethod },
+                byStatusBucket: { ...counters.byStatusBucket },
+                avgDuration: counters.totalResponses > 0
+                    ? Number((counters.duration.sum / counters.totalResponses).toFixed(2))
+                    : 0,
+                minDuration: counters.duration.min,
+                maxDuration: counters.duration.max,
+            };
+        },
+    };
+}
+
+function statusToBucket(statusCode: number): StatusBucket {
+    if (statusCode >= 200 && statusCode < 300) return '2xx';
+    if (statusCode >= 300 && statusCode < 400) return '3xx';
+    if (statusCode >= 400 && statusCode < 500) return '4xx';
+    if (statusCode >= 500 && statusCode < 600) return '5xx';
+    return 'other';
+}

package/plugins/builtin/mock-plugin.ts

@@ -0,0 +1,112 @@
+import { Plugin, MockPluginOptions, HookContext } from '../../core/types';
+
+/**
+ * 检测响应体的 Content-Type
+ */
+function detectContentType(body: string): string {
+    if (!body || typeof body !== 'string') {
+        return 'text/plain; charset=utf-8';
+    }
+
+    const trimmed = body.trim();
+    
+    // 检测 JSON
+    if ((trimmed.startsWith('{') && trimmed.endsWith('}')) || 
+        (trimmed.startsWith('[') && trimmed.endsWith(']'))) {
+        try {
+            JSON.parse(trimmed);
+            return 'application/json; charset=utf-8';
+        } catch {
+            // 继续检测其他类型
+        }
+    }
+    
+    // 检测 HTML
+    if (trimmed.startsWith('<!DOCTYPE') || 
+        trimmed.startsWith('<html') ||
+        /<[a-z][\s\S]*>/i.test(trimmed)) {
+        return 'text/html; charset=utf-8';
+    }
+    
+    // 检测 XML
+    if (trimmed.startsWith('<?xml')) {
+        return 'application/xml; charset=utf-8';
+    }
+    
+    // 检测 CSS
+    if (/[a-z-]+\s*\{[\s\S]*\}/i.test(trimmed) || 
+        /@(media|keyframes|import|font-face)/i.test(trimmed)) {
+        return 'text/css; charset=utf-8';
+    }
+    
+    // 检测 JavaScript
+    if (/(function|const|let|var|class|import|export|=>)/i.test(trimmed)) {
+        return 'application/javascript; charset=utf-8';
+    }
+    
+    // 默认为纯文本
+    return 'text/plain; charset=utf-8';
+}
+
+export function createBuiltinMockPlugin(options: MockPluginOptions): Plugin {
+    const findMatch = options.findMatch;
+    
+    return {
+        manifest: {
+            id: 'builtin.mock',
+            name: 'Builtin Mock Plugin',
+            version: '1.0.0',
+            apiVersion: '1.x',
+            type: 'builtin',
+            permissions: ['proxy:read', 'response:shortcircuit'],
+            hooks: ['onBeforeProxy'],
+            priority: 20,
+        },
+        async setup() {},
+        async onBeforeProxy(ctx: HookContext): Promise<void> {
+            if (!ctx || !ctx.request) return;
+            
+            const rule = findMatch(ctx.request.url || '', ctx.request.method);
+            if (!rule) return;
+            if (rule.bodyType && rule.bodyType !== 'inline') return;
+
+            const delay = Number(rule.delay || 0);
+            if (delay > 0) {
+                await new Promise((resolve) => setTimeout(resolve, delay));
+            }
+
+            ctx.meta.mockRuleId = rule.id;
+            ctx.meta.mockRuleName = rule.name || '';
+            
+            // 检测或使用自定义的 Content-Type
+            const ruleHeaders = rule.headers || {};
+            const hasContentType = Object.keys(ruleHeaders).some(
+                key => key.toLowerCase() === 'content-type'
+            );
+            const contentType = hasContentType 
+                ? undefined  // 保留 rule.headers 中的 Content-Type
+                : detectContentType(rule.body || '');
+            
+            const responseHeaders: Record<string, string> = {
+                'X-Mock-Rule': encodeURIComponent(rule.name || String(rule.id || '')),
+                'Access-Control-Allow-Origin': '*',
+                'Access-Control-Allow-Methods': '*',
+                'Access-Control-Allow-Headers': '*',
+            };
+            
+            // 如果没有自定义 Content-Type，则使用检测到的类型
+            if (contentType) {
+                responseHeaders['Content-Type'] = contentType;
+            }
+            
+            // 合并自定义响应头（会覆盖默认的 Content-Type）
+            Object.assign(responseHeaders, ruleHeaders);
+            
+            ctx.respond({
+                statusCode: rule.statusCode || 200,
+                headers: responseHeaders,
+                body: rule.body || '',
+            });
+        },
+    };
+}

package/plugins/builtin/router-plugin.ts

@@ -0,0 +1,35 @@
+import { Plugin, RouterPluginOptions, HookContext } from '../../core/types';
+import { findMatchedRouteRule } from '../../helpers';
+
+export function createBuiltinRouterPlugin(options: RouterPluginOptions): Plugin {
+    const getRouteRules = options.getRouteRules;
+
+    return {
+        manifest: {
+            id: 'builtin.router',
+            name: 'Builtin Router Plugin',
+            version: '1.0.0',
+            apiVersion: '1.x',
+            type: 'builtin',
+            permissions: ['proxy:read', 'proxy:write'],
+            hooks: ['onBeforeProxy'],
+            priority: 30,
+        },
+        async setup() {},
+        onBeforeProxy(ctx: HookContext): void {
+            const sourceUrl = ctx.request && ctx.request.url;
+            if (!sourceUrl) return;
+
+            const routeRules = getRouteRules?.();
+            if (!routeRules?.length) return;
+
+            const matched = findMatchedRouteRule(sourceUrl, routeRules);
+            if (matched) {
+                ctx.setTarget(matched.resolvedUrl);
+                ctx.meta.routerMatched = true;
+                ctx.meta.matchedRule = matched.entry.pattern;
+                ctx.meta.matchedTarget = matched.resolvedUrl;
+            }
+        },
+    };
+}

package/web/README.md

@@ -0,0 +1,111 @@
+# React + TypeScript + Vite
+
+This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+
+Currently, two official plugins are available:
+
+- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Babel](https://babeljs.io/) (or [oxc](https://oxc.rs) when used in [rolldown-vite](https://vite.dev/guide/rolldown)) for Fast Refresh
+- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
+
+## React Compiler
+
+The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
+
+## Expanding the ESLint configuration
+
+If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:
+
+```js
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+
+      // Remove tseslint.configs.recommended and replace with this
+      tseslint.configs.recommendedTypeChecked,
+      // Alternatively, use this for stricter rules
+      tseslint.configs.strictTypeChecked,
+      // Optionally, add this for stylistic rules
+      tseslint.configs.stylisticTypeChecked,
+
+      // Other configs...
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```
+
+You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:
+
+```js
+// eslint.config.js
+import reactX from 'eslint-plugin-react-x'
+import reactDom from 'eslint-plugin-react-dom'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+      // Enable lint rules for React
+      reactX.configs['recommended-typescript'],
+      // Enable lint rules for React DOM
+      reactDom.configs.recommended,
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```
+
+## 环境变量配置
+
+本项目支持通过环境变量自定义Mock功能的语法高亮和验证性能参数。
+
+### 快速开始
+
+1. 复制环境变量示例文件：
+   ```bash
+   cp .env.example .env
+   ```
+
+2. 根据需要编辑 `.env` 文件中的配置项
+
+3. 重新构建项目：
+   ```bash
+   pnpm run build
+   ```
+
+### 可配置参数
+
+- `VITE_MAX_HIGHLIGHT_SIZE` - 最大高亮文件大小（字节，默认: 2097152 / 2MB）
+- `VITE_MAX_HIGHLIGHT_LINES` - 最大高亮行数（默认: 10000）
+- `VITE_MAX_JSON_MATCHES` - JSON最大匹配数（默认: 50000）
+- `VITE_MAX_HTML_MATCHES` - HTML最大匹配数（默认: 30000）
+- `VITE_MAX_JS_MATCHES` - JavaScript最大匹配数（默认: 30000）
+- `VITE_ENABLE_RULE_GRAPH_VIEW` - 是否开启规则页的“图表视图”（默认: `false`）
+
+### 详细文档
+
+查看 [ENV_CONFIG.md](./ENV_CONFIG.md) 了解详细的配置说明和性能调优建议。
+
+### 验证配置
+
+运行以下命令检查当前配置：
+```bash
+node test-env-config.cjs
+```

package/web/dist/assets/ai-config-store-DQXVJVn_.js

@@ -0,0 +1 @@
+var e=`meddle-ai-config`,t={enabled:!1,provider:`openai`,apiKey:``,baseUrl:``,model:``},n={openai:`https://api.openai.com/v1/chat/completions`,anthropic:`https://api.anthropic.com/v1/messages`},r={openai:`gpt-4o-mini`,anthropic:`claude-3-5-sonnet-20241022`};function i(){try{let t=localStorage.getItem(e);if(t){let e=JSON.parse(t);return e.baseUrl||=n[e.provider],e.model||=r[e.provider],e.models||=[],e}}catch(e){console.error(`读取AI配置失败:`,e)}return a()||{...t,models:[]}}function a(){return null}function o(t){try{localStorage.setItem(e,JSON.stringify(t))}catch(e){throw console.error(`保存AI配置失败:`,e),Error(`保存配置失败`)}}function s(){try{localStorage.removeItem(e)}catch(e){console.error(`重置AI配置失败:`,e)}}function c(e){return e.enabled&&!!e.apiKey&&!!e.baseUrl&&!!e.model}function l(e){return{baseUrl:n[e],model:r[e]}}function u(e){if(!e.models||e.models.length===0)return null;if(e.activeModelId){let t=e.models.find(t=>t.id===e.activeModelId);if(t)return t}return e.models[0]}function d(e,t){let n={...t,id:Date.now().toString()},r=[...e.models||[],n];return{...e,models:r,activeModelId:e.activeModelId||n.id}}function f(e,t){let n=(e.models||[]).filter(e=>e.id!==t),r=e.activeModelId;return e.activeModelId===t&&n.length>0&&(r=n[0].id),{...e,models:n,activeModelId:r}}function p(e,t){return{...e,activeModelId:t}}export{l as a,o as c,u as i,p as l,f as n,c as o,i as r,s,d as t};

package/web/dist/assets/alert-COF-DIAE.js

@@ -0,0 +1 @@
+import{a as e,c as t,f as n,n as r,u as i}from"./button-BTToMaBW.js";n(i(),1);var a=e(),o=t(`relative w-full rounded-lg border px-4 py-3 text-sm grid gap-1`,{variants:{variant:{default:`bg-background text-foreground`,destructive:`border-destructive/50 text-destructive dark:border-destructive [&>svg]:text-destructive`}},defaultVariants:{variant:`default`}});function s({className:e,variant:t,...n}){return(0,a.jsx)(`div`,{role:`alert`,className:r(o({variant:t}),e),...n})}function c({className:e,...t}){return(0,a.jsx)(`h5`,{className:r(`mb-1 font-medium leading-none tracking-tight`,e),...t})}function l({className:e,...t}){return(0,a.jsx)(`div`,{className:r(`text-sm [&_p]:leading-relaxed`,e),...t})}export{l as n,c as r,s as t};

package/web/dist/assets/arrow-right-B4Mrlj2-.js

@@ -0,0 +1 @@
+import{l as e}from"./button-BTToMaBW.js";var t=e(`arrow-right`,[[`path`,{d:`M5 12h14`,key:`1ays0h`}],[`path`,{d:`m12 5 7 7-7 7`,key:`xquz4c`}]]);export{t};