@mg21st/dev-assist 1.0.0

package/ui/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "dev-assist-ui",
+  "private": true,
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "axios": "^1.6.2",
+    "lucide-react": "^0.294.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "react-router-dom": "^6.20.1",
+    "socket.io-client": "^4.6.1",
+    "prismjs": "^1.29.0"
+  },
+  "devDependencies": {
+    "@types/prismjs": "^1.26.3",
+    "@types/react": "^18.2.41",
+    "@types/react-dom": "^18.2.17",
+    "@vitejs/plugin-react": "^4.2.1",
+    "autoprefixer": "^10.4.16",
+    "postcss": "^8.4.32",
+    "tailwindcss": "^3.3.6",
+    "typescript": "^5.3.2",
+    "vite": "^5.0.6"
+  }
+}

package/ui/postcss.config.js

@@ -0,0 +1,6 @@
+export default {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+};

package/ui/src/App.tsx

@@ -0,0 +1,36 @@
+import React, { useState, useEffect } from 'react';
+import { Layout } from './components/Layout';
+import { Dashboard } from './components/Dashboard';
+import { TestsTab } from './components/TestsTab';
+import { ApiDocsTab } from './components/ApiDocsTab';
+import { ApiTestingTab } from './components/ApiTestingTab';
+
+export type TabId = 'dashboard' | 'tests' | 'docs' | 'testing';
+
+export default function App() {
+  const [activeTab, setActiveTab] = useState<TabId>('dashboard');
+  const [darkMode, setDarkMode] = useState(() => {
+    return localStorage.getItem('darkMode') === 'true';
+  });
+
+  useEffect(() => {
+    document.documentElement.classList.toggle('dark', darkMode);
+    localStorage.setItem('darkMode', String(darkMode));
+  }, [darkMode]);
+
+  const renderTab = () => {
+    switch (activeTab) {
+      case 'dashboard': return <Dashboard />;
+      case 'tests': return <TestsTab />;
+      case 'docs': return <ApiDocsTab />;
+      case 'testing': return <ApiTestingTab />;
+      default: return <Dashboard />;
+    }
+  };
+
+  return (
+    <Layout activeTab={activeTab} onTabChange={setActiveTab} darkMode={darkMode} onToggleDark={() => setDarkMode(d => !d)}>
+      {renderTab()}
+    </Layout>
+  );
+}

package/ui/src/components/ApiDocsTab.tsx

@@ -0,0 +1,184 @@
+import React, { useCallback, useEffect, useState } from 'react';
+import axios from 'axios';
+import { BookOpen, ChevronDown, ChevronUp, RefreshCw, Loader, Tag } from 'lucide-react';
+
+interface PathParam {
+  name: string;
+  type: string;
+  required: boolean;
+}
+
+interface ApiEndpoint {
+  method: string;
+  path: string;
+  params: PathParam[];
+  queryParams: PathParam[];
+  description?: string;
+  exampleRequest?: Record<string, unknown>;
+  exampleResponse?: Record<string, unknown>;
+}
+
+interface ApiDoc {
+  title: string;
+  version: string;
+  baseUrl: string;
+  endpoints: ApiEndpoint[];
+  generatedAt: string;
+}
+
+const methodColors: Record<string, string> = {
+  GET: 'bg-blue-100 text-blue-700 dark:bg-blue-900/40 dark:text-blue-300',
+  POST: 'bg-green-100 text-green-700 dark:bg-green-900/40 dark:text-green-300',
+  PUT: 'bg-yellow-100 text-yellow-700 dark:bg-yellow-900/40 dark:text-yellow-300',
+  DELETE: 'bg-red-100 text-red-700 dark:bg-red-900/40 dark:text-red-300',
+  PATCH: 'bg-purple-100 text-purple-700 dark:bg-purple-900/40 dark:text-purple-300',
+};
+
+function EndpointCard({ endpoint }: { endpoint: ApiEndpoint }) {
+  const [expanded, setExpanded] = useState(false);
+
+  return (
+    <div className="bg-white dark:bg-gray-800 rounded-xl border border-gray-200 dark:border-gray-700 overflow-hidden">
+      <button
+        onClick={() => setExpanded(!expanded)}
+        className="w-full flex items-center gap-3 p-4 text-left hover:bg-gray-50 dark:hover:bg-gray-700/50 transition-colors"
+      >
+        <span className={`px-2.5 py-0.5 rounded text-xs font-bold font-mono ${methodColors[endpoint.method] || 'bg-gray-100 text-gray-700'}`}>
+          {endpoint.method}
+        </span>
+        <code className="flex-1 text-sm font-mono">{endpoint.path}</code>
+        {expanded ? <ChevronUp size={16} className="text-gray-400" /> : <ChevronDown size={16} className="text-gray-400" />}
+      </button>
+
+      {expanded && (
+        <div className="border-t border-gray-200 dark:border-gray-700 p-4 space-y-4">
+          {endpoint.description && (
+            <p className="text-sm text-gray-600 dark:text-gray-400">{endpoint.description}</p>
+          )}
+
+          {endpoint.params.length > 0 && (
+            <div>
+              <h4 className="text-xs font-semibold text-gray-500 dark:text-gray-400 uppercase tracking-wide mb-2">Path Parameters</h4>
+              <div className="space-y-1">
+                {endpoint.params.map(p => (
+                  <div key={p.name} className="flex items-center gap-2 text-sm">
+                    <Tag size={12} className="text-gray-400" />
+                    <code className="font-mono text-sky-600 dark:text-sky-400">{p.name}</code>
+                    <span className="text-gray-400 text-xs">{p.type}</span>
+                    {p.required && <span className="text-red-500 text-xs">required</span>}
+                  </div>
+                ))}
+              </div>
+            </div>
+          )}
+
+          {endpoint.exampleResponse && Object.keys(endpoint.exampleResponse).length > 0 && (
+            <div>
+              <h4 className="text-xs font-semibold text-gray-500 dark:text-gray-400 uppercase tracking-wide mb-2">Example Response</h4>
+              <pre className="bg-gray-50 dark:bg-gray-900 rounded-lg p-3 text-xs font-mono overflow-auto text-gray-800 dark:text-gray-200 scrollbar-thin">
+                {JSON.stringify(endpoint.exampleResponse, null, 2)}
+              </pre>
+            </div>
+          )}
+        </div>
+      )}
+    </div>
+  );
+}
+
+export function ApiDocsTab() {
+  const [docs, setDocs] = useState<ApiDoc | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [generating, setGenerating] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  const fetchDocs = useCallback(async () => {
+    try {
+      setLoading(true);
+      const { data } = await axios.get<ApiDoc>('/api/docs');
+      setDocs(data);
+    } catch {
+      setError('Failed to fetch API docs');
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  const generateDocs = async () => {
+    try {
+      setGenerating(true);
+      setError(null);
+      await axios.post('/api/generate/docs', {});
+      await fetchDocs();
+    } catch {
+      setError('Failed to generate API docs');
+    } finally {
+      setGenerating(false);
+    }
+  };
+
+  useEffect(() => { fetchDocs(); }, [fetchDocs]);
+
+  return (
+    <div className="space-y-4">
+      <div className="flex items-center justify-between">
+        <div>
+          <h1 className="text-2xl font-bold">API Documentation</h1>
+          <p className="text-gray-500 dark:text-gray-400 text-sm mt-1">
+            {docs?.endpoints.length || 0} endpoints discovered
+          </p>
+        </div>
+        <div className="flex gap-2">
+          <button
+            onClick={fetchDocs}
+            className="flex items-center gap-2 px-3 py-2 border border-gray-300 dark:border-gray-600 rounded-lg hover:bg-gray-50 dark:hover:bg-gray-700 transition-colors text-sm"
+          >
+            <RefreshCw size={14} />
+            Refresh
+          </button>
+          <button
+            onClick={generateDocs}
+            disabled={generating}
+            className="flex items-center gap-2 px-4 py-2 bg-sky-500 text-white rounded-lg hover:bg-sky-600 disabled:opacity-50 transition-colors text-sm font-medium"
+          >
+            {generating ? <Loader size={14} className="animate-spin" /> : <BookOpen size={14} />}
+            {generating ? 'Generating...' : 'Generate Docs'}
+          </button>
+        </div>
+      </div>
+
+      {error && (
+        <div className="p-3 bg-red-50 dark:bg-red-900/20 border border-red-200 dark:border-red-800 rounded-lg text-red-700 dark:text-red-400 text-sm">
+          {error}
+        </div>
+      )}
+
+      {loading ? (
+        <div className="flex items-center justify-center h-64">
+          <Loader className="animate-spin text-sky-500" size={32} />
+        </div>
+      ) : !docs || docs.endpoints.length === 0 ? (
+        <div className="flex flex-col items-center justify-center h-64 text-gray-500 dark:text-gray-400">
+          <BookOpen size={48} className="mb-4 opacity-30" />
+          <p className="text-lg font-medium">No API endpoints found</p>
+          <p className="text-sm mt-1">Click "Generate Docs" to scan for Express routes</p>
+        </div>
+      ) : (
+        <div className="space-y-3">
+          {docs && (
+            <div className="bg-white dark:bg-gray-800 rounded-xl p-4 border border-gray-200 dark:border-gray-700 text-sm">
+              <span className="font-medium">{docs.title}</span>
+              <span className="mx-2 text-gray-400">•</span>
+              <span className="text-gray-500">v{docs.version}</span>
+              <span className="mx-2 text-gray-400">•</span>
+              <code className="text-sky-600 dark:text-sky-400">{docs.baseUrl}</code>
+            </div>
+          )}
+          {docs?.endpoints.map((endpoint, i) => (
+            <EndpointCard key={i} endpoint={endpoint} />
+          ))}
+        </div>
+      )}
+    </div>
+  );
+}

package/ui/src/components/ApiTestingTab.tsx

@@ -0,0 +1,363 @@
+import React, { useRef, useState } from 'react';
+import axios from 'axios';
+import { Send, Plus, Trash2, Clock, Save, History, ChevronDown, X } from 'lucide-react';
+
+interface Header {
+  key: string;
+  value: string;
+}
+
+interface SavedRequest {
+  id: string;
+  name: string;
+  method: string;
+  url: string;
+  headers: Header[];
+  body: string;
+}
+
+interface ApiResponse {
+  status: number;
+  statusText: string;
+  headers: Record<string, string>;
+  data: unknown;
+  responseTime: number;
+}
+
+const HTTP_METHODS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS'];
+
+const methodColors: Record<string, string> = {
+  GET: 'text-blue-500',
+  POST: 'text-green-500',
+  PUT: 'text-yellow-500',
+  PATCH: 'text-purple-500',
+  DELETE: 'text-red-500',
+  HEAD: 'text-gray-500',
+  OPTIONS: 'text-gray-500',
+};
+
+function SaveRequestModal({ onSave, onCancel }: { onSave: (name: string) => void; onCancel: () => void }) {
+  const [name, setName] = useState('');
+  const inputRef = useRef<HTMLInputElement>(null);
+
+  React.useEffect(() => { inputRef.current?.focus(); }, []);
+
+  const handleSubmit = (e: React.FormEvent) => {
+    e.preventDefault();
+    if (name.trim()) onSave(name.trim());
+  };
+
+  return (
+    <div className="fixed inset-0 z-50 flex items-center justify-center bg-black/40" onClick={onCancel}>
+      <div
+        className="bg-white dark:bg-gray-800 rounded-xl shadow-xl p-5 w-80 border border-gray-200 dark:border-gray-700"
+        onClick={e => e.stopPropagation()}
+      >
+        <div className="flex items-center justify-between mb-4">
+          <h3 className="font-semibold">Save Request</h3>
+          <button onClick={onCancel} className="text-gray-400 hover:text-gray-600"><X size={16} /></button>
+        </div>
+        <form onSubmit={handleSubmit} className="space-y-3">
+          <input
+            ref={inputRef}
+            type="text"
+            value={name}
+            onChange={e => setName(e.target.value)}
+            placeholder="Request name"
+            className="w-full px-3 py-2 rounded-lg border border-gray-300 dark:border-gray-600 bg-white dark:bg-gray-700 text-sm focus:outline-none focus:ring-2 focus:ring-sky-500"
+          />
+          <div className="flex justify-end gap-2">
+            <button type="button" onClick={onCancel} className="px-3 py-1.5 text-sm border border-gray-300 dark:border-gray-600 rounded-lg hover:bg-gray-50 dark:hover:bg-gray-700">Cancel</button>
+            <button type="submit" disabled={!name.trim()} className="px-3 py-1.5 text-sm bg-sky-500 text-white rounded-lg hover:bg-sky-600 disabled:opacity-50">Save</button>
+          </div>
+        </form>
+      </div>
+    </div>
+  );
+}
+
+export function ApiTestingTab() {
+  const [method, setMethod] = useState('GET');
+  const [url, setUrl] = useState('');
+  const [headers, setHeaders] = useState<Header[]>([{ key: 'Content-Type', value: 'application/json' }]);
+  const [body, setBody] = useState('');
+  const [response, setResponse] = useState<ApiResponse | null>(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const [showSaveModal, setShowSaveModal] = useState(false);
+  const [savedRequests, setSavedRequests] = useState<SavedRequest[]>(() => {
+    try {
+      return JSON.parse(localStorage.getItem('dev-assist-requests') || '[]');
+    } catch { return []; }
+  });
+  const [showHistory, setShowHistory] = useState(true);
+  const [activeBodyTab, setActiveBodyTab] = useState<'body' | 'headers'>('headers');
+
+  const sendRequest = async () => {
+    if (!url.trim()) {
+      setError('Please enter a URL');
+      return;
+    }
+
+    setLoading(true);
+    setError(null);
+    setResponse(null);
+
+    try {
+      const headerMap: Record<string, string> = {};
+      headers.filter(h => h.key && h.value).forEach(h => { headerMap[h.key] = h.value; });
+
+      let parsedBody: unknown = undefined;
+      if (body.trim() && ['POST', 'PUT', 'PATCH'].includes(method)) {
+        try {
+          parsedBody = JSON.parse(body);
+        } catch {
+          parsedBody = body;
+        }
+      }
+
+      const { data } = await axios.post<ApiResponse>('/api/proxy', {
+        url,
+        method,
+        headers: headerMap,
+        body: parsedBody,
+      });
+
+      setResponse(data);
+    } catch (err) {
+      setError('Request failed: ' + (err instanceof Error ? err.message : String(err)));
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  const saveRequest = (name: string) => {
+    const request: SavedRequest = {
+      id: Date.now().toString(),
+      name,
+      method,
+      url,
+      headers,
+      body,
+    };
+    const updated = [...savedRequests, request];
+    setSavedRequests(updated);
+    localStorage.setItem('dev-assist-requests', JSON.stringify(updated));
+  };
+
+  const loadRequest = (req: SavedRequest) => {
+    setMethod(req.method);
+    setUrl(req.url);
+    setHeaders(req.headers);
+    setBody(req.body);
+  };
+
+  const deleteRequest = (id: string) => {
+    const updated = savedRequests.filter(r => r.id !== id);
+    setSavedRequests(updated);
+    localStorage.setItem('dev-assist-requests', JSON.stringify(updated));
+  };
+
+  const addHeader = () => setHeaders([...headers, { key: '', value: '' }]);
+  const updateHeader = (i: number, field: 'key' | 'value', val: string) => {
+    const updated = [...headers];
+    updated[i][field] = val;
+    setHeaders(updated);
+  };
+  const removeHeader = (i: number) => setHeaders(headers.filter((_, idx) => idx !== i));
+
+  const getStatusColor = (status: number) => {
+    if (status >= 200 && status < 300) return 'text-green-500';
+    if (status >= 300 && status < 400) return 'text-yellow-500';
+    if (status >= 400 && status < 500) return 'text-red-500';
+    return 'text-red-600';
+  };
+
+  return (
+    <div className="flex gap-4 h-[calc(100vh-120px)]">
+      {showSaveModal && (
+        <SaveRequestModal
+          onSave={(name) => { saveRequest(name); setShowSaveModal(false); }}
+          onCancel={() => setShowSaveModal(false)}
+        />
+      )}
+      <div className={`${showHistory ? 'w-56' : 'w-10'} flex-shrink-0 bg-white dark:bg-gray-800 rounded-xl border border-gray-200 dark:border-gray-700 flex flex-col transition-all`}>
+        <button
+          onClick={() => setShowHistory(!showHistory)}
+          className="flex items-center gap-2 p-3 border-b border-gray-200 dark:border-gray-700 text-sm font-medium hover:bg-gray-50 dark:hover:bg-gray-700 transition-colors"
+        >
+          <History size={14} />
+          {showHistory && <span>Saved</span>}
+        </button>
+        {showHistory && (
+          <div className="flex-1 overflow-auto divide-y divide-gray-100 dark:divide-gray-700">
+            {savedRequests.length === 0 ? (
+              <p className="p-3 text-xs text-gray-400 text-center">No saved requests</p>
+            ) : (
+              savedRequests.map(req => (
+                <div key={req.id} className="group flex items-center gap-1 p-2 hover:bg-gray-50 dark:hover:bg-gray-700">
+                  <button
+                    onClick={() => loadRequest(req)}
+                    className="flex-1 text-left"
+                  >
+                    <span className={`text-xs font-mono font-bold ${methodColors[req.method] || 'text-gray-500'}`}>{req.method}</span>
+                    <p className="text-xs text-gray-600 dark:text-gray-300 truncate">{req.name}</p>
+                  </button>
+                  <button
+                    onClick={() => deleteRequest(req.id)}
+                    className="opacity-0 group-hover:opacity-100 text-red-400 hover:text-red-600"
+                  >
+                    <Trash2 size={12} />
+                  </button>
+                </div>
+              ))
+            )}
+          </div>
+        )}
+      </div>
+
+      <div className="flex-1 flex flex-col gap-3 min-w-0">
+        <div className="bg-white dark:bg-gray-800 rounded-xl border border-gray-200 dark:border-gray-700 p-4 space-y-3">
+          <h2 className="font-semibold text-sm text-gray-500 dark:text-gray-400 uppercase tracking-wide">Request</h2>
+          
+          <div className="flex gap-2">
+            <div className="relative">
+              <select
+                value={method}
+                onChange={e => setMethod(e.target.value)}
+                className={`appearance-none pl-3 pr-7 py-2 rounded-lg border border-gray-300 dark:border-gray-600 bg-white dark:bg-gray-700 text-sm font-bold font-mono ${methodColors[method] || ''} focus:outline-none focus:ring-2 focus:ring-sky-500`}
+              >
+                {HTTP_METHODS.map(m => (
+                  <option key={m} value={m}>{m}</option>
+                ))}
+              </select>
+              <ChevronDown size={12} className="absolute right-2 top-1/2 -translate-y-1/2 pointer-events-none text-gray-400" />
+            </div>
+            <input
+              type="text"
+              value={url}
+              onChange={e => setUrl(e.target.value)}
+              onKeyDown={e => e.key === 'Enter' && sendRequest()}
+              placeholder="https://api.example.com/endpoint"
+              className="flex-1 px-3 py-2 rounded-lg border border-gray-300 dark:border-gray-600 bg-white dark:bg-gray-700 text-sm focus:outline-none focus:ring-2 focus:ring-sky-500"
+            />
+            <button
+              onClick={sendRequest}
+              disabled={loading}
+              className="flex items-center gap-2 px-4 py-2 bg-sky-500 text-white rounded-lg hover:bg-sky-600 disabled:opacity-50 transition-colors text-sm font-medium"
+            >
+              {loading ? (
+                <Clock size={14} className="animate-spin" />
+              ) : (
+                <Send size={14} />
+              )}
+              Send
+            </button>
+            <button
+              onClick={() => setShowSaveModal(true)}
+              className="flex items-center gap-1.5 px-3 py-2 border border-gray-300 dark:border-gray-600 rounded-lg hover:bg-gray-50 dark:hover:bg-gray-700 text-sm"
+              title="Save request"
+            >
+              <Save size={14} />
+            </button>
+          </div>
+
+          <div className="flex border-b border-gray-200 dark:border-gray-700 text-sm">
+            {(['headers', 'body'] as const).map(tab => (
+              <button
+                key={tab}
+                onClick={() => setActiveBodyTab(tab)}
+                className={`px-4 py-2 font-medium capitalize transition-colors ${
+                  activeBodyTab === tab
+                    ? 'border-b-2 border-sky-500 text-sky-600 dark:text-sky-400'
+                    : 'text-gray-500 hover:text-gray-700 dark:text-gray-400'
+                }`}
+              >
+                {tab} {tab === 'headers' && `(${headers.filter(h => h.key).length})`}
+              </button>
+            ))}
+          </div>
+
+          {activeBodyTab === 'headers' ? (
+            <div className="space-y-2">
+              {headers.map((header, i) => (
+                <div key={i} className="flex gap-2">
+                  <input
+                    value={header.key}
+                    onChange={e => updateHeader(i, 'key', e.target.value)}
+                    placeholder="Header name"
+                    className="flex-1 px-3 py-1.5 text-sm rounded border border-gray-300 dark:border-gray-600 bg-white dark:bg-gray-700 focus:outline-none focus:ring-1 focus:ring-sky-500"
+                  />
+                  <input
+                    value={header.value}
+                    onChange={e => updateHeader(i, 'value', e.target.value)}
+                    placeholder="Value"
+                    className="flex-1 px-3 py-1.5 text-sm rounded border border-gray-300 dark:border-gray-600 bg-white dark:bg-gray-700 focus:outline-none focus:ring-1 focus:ring-sky-500"
+                  />
+                  <button onClick={() => removeHeader(i)} className="text-red-400 hover:text-red-600">
+                    <Trash2 size={14} />
+                  </button>
+                </div>
+              ))}
+              <button
+                onClick={addHeader}
+                className="flex items-center gap-1 text-sm text-sky-500 hover:text-sky-600"
+              >
+                <Plus size={14} /> Add Header
+              </button>
+            </div>
+          ) : (
+            <textarea
+              value={body}
+              onChange={e => setBody(e.target.value)}
+              placeholder='{"key": "value"}'
+              rows={5}
+              className="w-full px-3 py-2 text-sm font-mono rounded border border-gray-300 dark:border-gray-600 bg-white dark:bg-gray-700 focus:outline-none focus:ring-2 focus:ring-sky-500 resize-y"
+            />
+          )}
+        </div>
+
+        <div className="flex-1 bg-white dark:bg-gray-800 rounded-xl border border-gray-200 dark:border-gray-700 flex flex-col overflow-hidden">
+          <div className="p-3 border-b border-gray-200 dark:border-gray-700 flex items-center gap-3">
+            <h2 className="font-semibold text-sm text-gray-500 dark:text-gray-400 uppercase tracking-wide">Response</h2>
+            {response && (
+              <>
+                <span className={`text-sm font-bold ${getStatusColor(response.status)}`}>
+                  {response.status} {response.statusText}
+                </span>
+                <span className="text-xs text-gray-400 flex items-center gap-1">
+                  <Clock size={11} />{response.responseTime}ms
+                </span>
+              </>
+            )}
+          </div>
+
+          {error && (
+            <div className="p-3 m-3 bg-red-50 dark:bg-red-900/20 border border-red-200 dark:border-red-800 rounded text-red-700 dark:text-red-400 text-sm">
+              {error}
+            </div>
+          )}
+
+          {response ? (
+            <pre className="flex-1 overflow-auto p-4 text-xs font-mono text-gray-800 dark:text-gray-200 scrollbar-thin">
+              {typeof response.data === 'object'
+                ? JSON.stringify(response.data, null, 2)
+                : String(response.data)}
+            </pre>
+          ) : (
+            <div className="flex-1 flex items-center justify-center text-gray-400 text-sm">
+              {loading ? (
+                <div className="flex items-center gap-2">
+                  <Clock className="animate-spin" size={20} />
+                  Sending request...
+                </div>
+              ) : (
+                'Send a request to see the response'
+              )}
+            </div>
+          )}
+        </div>
+      </div>
+    </div>
+  );
+}