apiforge-analyzer 1.1.0

package/README.md

@@ -0,0 +1,279 @@
+# APIForge Analyzer
+
+Universal API documentation generator for **Express**, **Next.js**, **Vite**, **React Router**, and **Node.js**.
+
+Supports both **ESM** (`import`) and **CommonJS** (`require`).
+
+## 📦 Installation
+
+```bash
+npm install apiforge-analyzer
+```
+
+## 🚀 Quick Start
+
+### Express (CommonJS)
+
+```javascript
+const express = require('express')
+const { analyze } = require('apiforge-analyzer')
+
+const app = express()
+
+app.get('/api/users', (req, res) => res.json({ users: [] }))
+app.post('/api/users', (req, res) => res.json({ created: true }))
+
+analyze(app, {
+  projectName: 'My API',
+  apiKey: process.env.APIFORGE_KEY,
+  upload: true
+})
+
+app.listen(3000)
+```
+
+### Express (ESM)
+
+```javascript
+import express from 'express'
+import { analyze } from 'apiforge-analyzer'
+
+const app = express()
+
+app.get('/api/users', (req, res) => res.json({ users: [] }))
+
+await analyze(app, {
+  projectName: 'My API',
+  apiKey: process.env.APIFORGE_KEY
+})
+
+app.listen(3000)
+```
+
+### Next.js Pages Router
+
+```javascript
+// pages/api/analyze.ts
+import { analyzeNextPages } from 'apiforge-analyzer'
+
+export default async function handler(req, res) {
+  await analyzeNextPages({
+    projectName: 'My Next.js API',
+    apiKey: process.env.APIFORGE_KEY,
+    upload: true
+  })
+  
+  res.json({ success: true })
+}
+```
+
+### Next.js App Router
+
+```javascript
+// app/api/analyze/route.ts
+import { analyzeNextApp } from 'apiforge-analyzer'
+
+export async function GET() {
+  await analyzeNextApp({
+    projectName: 'My Next.js API',
+    apiKey: process.env.APIFORGE_KEY,
+    upload: true
+  })
+  
+  return Response.json({ success: true })
+}
+```
+
+### Vite
+
+```javascript
+// vite-analyze.js
+import { analyzeVite } from 'apiforge-analyzer'
+
+// Analyzes proxy routes in vite.config.js
+await analyzeVite({
+  projectName: 'My Vite App',
+  apiKey: process.env.APIFORGE_KEY,
+  upload: true
+})
+```
+
+**Example Vite Config:**
+
+```javascript
+// vite.config.js
+export default {
+  server: {
+    proxy: {
+      '/api': 'http://localhost:3000',
+      '/auth': 'http://localhost:3001'
+    }
+  }
+}
+```
+
+### React Router
+
+```javascript
+// analyze-routes.js
+import { analyzeReactRouter } from 'apiforge-analyzer'
+
+// Analyzes routes from src/routes.tsx
+await analyzeReactRouter({
+  projectName: 'My React App',
+  apiKey: process.env.APIFORGE_KEY,
+  upload: true
+})
+```
+
+**Example Routes File:**
+
+```javascript
+// src/routes.tsx
+import { createBrowserRouter } from 'react-router-dom'
+
+export const router = createBrowserRouter([
+  { path: '/', element: <Home /> },
+  { path: '/users/:id', element: <UserDetail /> },
+  { path: '/about', element: <About /> }
+])
+```
+
+## ⚙️ Configuration
+
+### Options
+
+```typescript
+interface AnalyzerOptions {
+  // Required
+  projectName: string          // Name of your project
+
+  // Optional
+  baseUrl?: string            // Base URL of your API
+  apiKey?: string             // APIForge API key
+  apiForgeUrl?: string        // APIForge server URL (default: http://localhost:3000)
+  upload?: boolean            // Upload to APIForge (default: true if apiKey provided)
+  saveJson?: boolean          // Save routes to JSON file
+  jsonPath?: string           // Path for JSON file (default: api-export.json)
+  framework?: string          // Force framework detection
+  nextDir?: string            // Next.js directory or config file path
+  skipInProduction?: boolean  // Skip in production (default: true)
+}
+```
+
+### Environment Variables
+
+```bash
+APIFORGE_KEY=your-api-key
+APIFORGE_URL=http://localhost:3000  # or https://apiforge.dev
+NODE_ENV=development  # Analysis skipped if production
+```
+
+## 📚 Framework Support
+
+| Framework | Status | Import |
+|-----------|--------|--------|
+| Express | ✅ Full | `analyzeExpress` or `analyze` |
+| Next.js Pages | ✅ Full | `analyzeNextPages` |
+| Next.js App Router | ✅ Full | `analyzeNextApp` |
+| Vite | ✅ Full | `analyzeVite` |
+| React Router | ✅ Full | `analyzeReactRouter` |
+
+## 📖 Examples
+
+### Export to JSON Only
+
+```javascript
+import { analyze } from 'apiforge-analyzer'
+
+await analyze(app, {
+  projectName: 'My API',
+  saveJson: true,
+  jsonPath: './docs/api.json',
+  upload: false  // Don't upload
+})
+```
+
+### Auto-Detection
+
+```javascript
+// Framework is auto-detected
+import { analyze } from 'apiforge-analyzer'
+
+await analyze(app, { projectName: 'My API' })
+```
+
+### Custom Config Paths
+
+```javascript
+// Vite with custom config
+await analyzeVite({
+  projectName: 'My App',
+  nextDir: 'vite.config.ts'  // Custom path
+})
+
+// React Router with custom routes file
+await analyzeReactRouter({
+  projectName: 'My App',
+  nextDir: 'src/app/routes.tsx'  // Custom path
+})
+```
+
+### Skip in Production
+
+```javascript
+// Automatically skips if NODE_ENV=production
+await analyze(app, {
+  projectName: 'My API',
+  skipInProduction: true  // Default
+})
+```
+
+## 🔑 Getting an API Key
+
+1. Sign up at [APIForge](https://apiforge.dev)
+2. Go to Dashboard → API Keys
+3. Generate a new key
+4. Set `APIFORGE_KEY=your-key` in `.env`
+
+## 🛠️ Module Support
+
+This package supports both **ESM** and **CommonJS**:
+
+```javascript
+// ESM
+import { analyze } from 'apiforge-analyzer'
+
+// CommonJS
+const { analyze } = require('apiforge-analyzer')
+
+// Default import (CommonJS)
+const apiforge = require('apiforge-analyzer').default
+```
+
+## 📝 What Gets Analyzed
+
+- ✅ Route paths
+- ✅ HTTP methods (GET, POST, PUT, DELETE, etc.)
+- ✅ Path parameters (`:id`, `:userId`)
+- ✅ Middleware names
+- ✅ Route tags/groups
+- ✅ Response codes
+- ✅ Proxy configurations (Vite)
+- ✅ Frontend routes (React Router)
+
+## 🧪 Testing Locally
+
+See [NPM_LINK_TEST.md](NPM_LINK_TEST.md) for detailed testing instructions using `npm link`.
+
+## 🤝 Contributing
+
+Pull requests welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## 📄 License
+
+MIT © APIForge
+
+---
+
+**Made with ❤️ by the APIForge team**

package/dist/cjs/cli.js

@@ -0,0 +1,419 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const prompts_1 = require("@clack/prompts");
+const fs_1 = require("fs");
+const path_1 = require("path");
+// ─── ANSI helpers ─────────────────────────────────────────────────────────────
+const r = '\x1b[0m';
+const b = '\x1b[1m';
+const d = '\x1b[2m';
+const cy = '\x1b[36m';
+const gn = '\x1b[32m';
+const yl = '\x1b[33m';
+const mg = '\x1b[35m';
+const wh = '\x1b[97m';
+const bold = (s) => `${b}${s}${r}`;
+const dim = (s) => `${d}${s}${r}`;
+const cyan = (s) => `${cy}${s}${r}`;
+const green = (s) => `${gn}${s}${r}`;
+const yellow = (s) => `${yl}${s}${r}`;
+const magenta = (s) => `${mg}${s}${r}`;
+const white = (s) => `${wh}${s}${r}`;
+// ─── Brand header ─────────────────────────────────────────────────────────────
+function printHeader() {
+    const lines = [
+        '',
+        `  ${cyan('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')}`,
+        '',
+        `  ${bold(white('⚡  APIForge'))}   ${dim('v1.1.0')}`,
+        `  ${dim('AI-powered API documentation, auto-generated')}`,
+        '',
+        `  ${dim('Your entire API, documented in under 60 seconds.')}`,
+        '',
+        `  ${cyan('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')}`,
+        '',
+    ];
+    console.log(lines.join('\n'));
+}
+// ─── Shared state across tasks ────────────────────────────────────────────────
+let detectedEntry = '';
+let detectedAppVar = 'app';
+let detectedIsESM = false;
+let detectedFramework = 'unknown';
+let injectionPoint = '';
+let wasAlreadySetup = false;
+let linesAdded = 0;
+// ─── Main ─────────────────────────────────────────────────────────────────────
+async function main() {
+    process.stdout.write('\x1Bc'); // clear screen
+    printHeader();
+    (0, prompts_1.intro)(bold(` ${cyan('⚡')} APIForge Setup `));
+    // ── Questions (grouped so cancel is handled once) ──────────────────────────
+    const answers = await (0, prompts_1.group)({
+        projectName: () => (0, prompts_1.text)({
+            message: 'Name your project',
+            placeholder: 'My Awesome API',
+            validate: (v) => (!v.trim() ? 'Project name cannot be empty' : undefined),
+        }),
+        apiKey: () => (0, prompts_1.password)({
+            message: `APIForge API key  ${dim('(get one at apiforge.brainfogagency.com/dashboard)')}`,
+            validate: (v) => {
+                if (!v.trim())
+                    return 'API key is required';
+                if (!v.trim().startsWith('afg_'))
+                    return 'Key must start with afg_';
+            },
+        }),
+        baseUrl: () => (0, prompts_1.text)({
+            message: 'Your server base URL',
+            placeholder: 'https://api.myapp.com',
+            initialValue: 'http://localhost:3000',
+            validate: (v) => (!v.trim() ? 'Base URL is required' : undefined),
+        }),
+        method: () => (0, prompts_1.select)({
+            message: 'Sync method',
+            options: [
+                {
+                    value: 'runtime',
+                    label: `${bold('Runtime')}  ${dim('→')}  auto-syncs on every server start`,
+                    hint: 'recommended',
+                },
+                {
+                    value: 'json',
+                    label: `${bold('Export JSON')}  ${dim('→')}  write api-export.json, import to dashboard`,
+                },
+            ],
+        }),
+    }, {
+        onCancel: () => {
+            (0, prompts_1.cancel)(dim('Setup cancelled. Come back when you\'re ready.'));
+            process.exit(0);
+        },
+    });
+    if ((0, prompts_1.isCancel)(answers))
+        process.exit(0);
+    const { projectName, apiKey, baseUrl, method } = answers;
+    prompts_1.log.info(dim('─────────────────────────────────────────────────'));
+    prompts_1.log.info(`${dim('Project:')}  ${bold(projectName)}`);
+    prompts_1.log.info(`${dim('Mode:')}     ${bold(method === 'runtime' ? 'Runtime sync' : 'Export JSON')}`);
+    prompts_1.log.info(`${dim('Base URL:')} ${cyan(baseUrl)}`);
+    prompts_1.log.info(dim('─────────────────────────────────────────────────'));
+    // ── Need to ask for entry file? Do pre-scan first ─────────────────────────
+    const preDetected = detectEntryFile();
+    let entryFile;
+    if (!preDetected) {
+        prompts_1.log.warn('Could not auto-detect your server entry file.');
+        const custom = await (0, prompts_1.text)({
+            message: 'Path to your server entry file',
+            placeholder: 'src/index.ts',
+            validate: (v) => {
+                if (!v.trim())
+                    return 'Required';
+                if (!(0, fs_1.existsSync)((0, path_1.join)(process.cwd(), v.trim())))
+                    return `Not found: ${v.trim()}`;
+            },
+        });
+        if ((0, prompts_1.isCancel)(custom)) {
+            (0, prompts_1.cancel)('Setup cancelled.');
+            process.exit(0);
+        }
+        entryFile = custom.trim();
+    }
+    else {
+        entryFile = preDetected;
+    }
+    // ── Multi-step animated tasks ──────────────────────────────────────────────
+    await (0, prompts_1.tasks)([
+        {
+            title: `Scanning project`,
+            task: async (msg) => {
+                await sleep(350);
+                detectedEntry = entryFile;
+                msg(`Reading ${detectedEntry}`);
+                await sleep(250);
+                return `${green('✓')} Entry file: ${bold(detectedEntry)}`;
+            },
+        },
+        {
+            title: 'Analysing server file',
+            task: async (msg) => {
+                await sleep(200);
+                const fullPath = (0, path_1.join)(process.cwd(), detectedEntry);
+                const src = (0, fs_1.readFileSync)(fullPath, 'utf-8');
+                detectedIsESM = detectESM(detectedEntry, src);
+                detectedAppVar = detectAppVariable(src) ?? 'app';
+                detectedFramework = detectFramework(src);
+                msg(`Detected ${detectedFramework}`);
+                await sleep(300);
+                const moduleType = detectedIsESM ? 'ESM' : 'CJS';
+                return [
+                    `${green('✓')} Framework: ${bold(detectedFramework)}`,
+                    `   Module:    ${bold(moduleType)}`,
+                    `   App var:   ${bold(detectedAppVar)}`,
+                ].join('\n');
+            },
+        },
+        {
+            title: 'Patching server file',
+            task: async (msg) => {
+                await sleep(300);
+                msg('Generating snippet…');
+                await sleep(200);
+                const result = injectCode(detectedEntry, projectName, apiKey, baseUrl, method);
+                wasAlreadySetup = result.alreadyInjected;
+                injectionPoint = result.injectionPoint ?? 'end of file';
+                linesAdded = result.linesAdded ?? 0;
+                msg(result.alreadyInjected ? 'Already configured' : `Writing to ${detectedEntry}`);
+                await sleep(300);
+                if (result.alreadyInjected) {
+                    return `${yellow('◌')} Already set up — no changes made`;
+                }
+                return [
+                    `${green('✓')} Patched: ${bold(detectedEntry)}  ${dim(`+${linesAdded} lines`)}`,
+                    `   At:      ${dim(injectionPoint)}`,
+                ].join('\n');
+            },
+        },
+        {
+            title: 'Verifying patch',
+            task: async (msg) => {
+                await sleep(200);
+                if (wasAlreadySetup) {
+                    return `${yellow('◌')} Skipped — file was already configured`;
+                }
+                const src = (0, fs_1.readFileSync)((0, path_1.join)(process.cwd(), detectedEntry), 'utf-8');
+                if (!src.includes('apiforge-analyzer')) {
+                    throw new Error('Patch verification failed — please add the snippet manually');
+                }
+                msg('Confirmed apiforge-analyzer in file');
+                await sleep(200);
+                return `${green('✓')} Verified`;
+            },
+        },
+    ]);
+    // ── Summary note ───────────────────────────────────────────────────────────
+    if (wasAlreadySetup) {
+        (0, prompts_1.note)([
+            bold('Already good to go!'),
+            '',
+            dim(`APIForge is already configured in ${bold(detectedEntry)}.`),
+            dim('No changes were made.'),
+        ].join('\n'), 'Status');
+    }
+    else {
+        const snippetPreview = getSnippetPreview(method, detectedAppVar);
+        (0, prompts_1.note)([
+            `  ${dim('File')}     ${bold(detectedEntry)}  ${dim(`+${linesAdded} lines`)}`,
+            `  ${dim('Mode')}     ${bold(method === 'json' ? 'Export JSON' : 'Runtime sync')}`,
+            `  ${dim('App var')}  ${bold(detectedAppVar)}  ${dim('(auto-detected)')}`,
+            `  ${dim('Format')}   ${bold(detectedIsESM ? 'ESM (import)' : 'CJS (require)')}`,
+            '',
+            dim('Injected snippet:'),
+            '',
+            ...snippetPreview.map(line => `  ${cyan('│')} ${dim(line)}`),
+        ].join('\n'), 'Patch summary');
+    }
+    // ── Next steps + outro ─────────────────────────────────────────────────────
+    if (method === 'json') {
+        (0, prompts_1.note)([
+            bold('What to do next:'),
+            '',
+            `  ${dim('1.')} Start your server once:`,
+            `     ${cyan(getStartCommand())}`,
+            '',
+            `  ${dim('2.')} Upload ${bold('api-export.json')} to the dashboard:`,
+            `     ${cyan('https://apiforge.brainfogagency.com/dashboard')}`,
+            '',
+            `  ${dim('3.')} Your AI-enhanced docs appear in seconds.`,
+        ].join('\n'), 'Next steps');
+        (0, prompts_1.outro)(`${green('✓')}  All set — run your server to generate the export.`);
+    }
+    else {
+        (0, prompts_1.note)([
+            bold('What to do next:'),
+            '',
+            `  ${dim('1.')} Start your server as normal:`,
+            `     ${cyan(getStartCommand())}`,
+            '',
+            `  ${dim('2.')} APIForge detects all routes automatically.`,
+            '',
+            `  ${dim('3.')} View your live docs:`,
+            `     ${cyan('https://apiforge.brainfogagency.com/dashboard')}`,
+        ].join('\n'), 'Next steps');
+        (0, prompts_1.outro)(`${green('✓')}  All set — start your server and docs will sync automatically.`);
+    }
+}
+// ─── Entry file detection ─────────────────────────────────────────────────────
+function detectEntryFile() {
+    const cwd = process.cwd();
+    try {
+        const pkg = JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(cwd, 'package.json'), 'utf-8'));
+        if (pkg.main && (0, fs_1.existsSync)((0, path_1.join)(cwd, pkg.main)))
+            return pkg.main;
+        for (const script of ['start', 'dev', 'serve']) {
+            const cmd = pkg.scripts?.[script] ?? '';
+            const m = cmd.match(/(?:node|tsx|ts-node)\s+([^\s&|;]+\.(js|ts|mjs|cjs))/);
+            if (m && (0, fs_1.existsSync)((0, path_1.join)(cwd, m[1])))
+                return m[1];
+        }
+    }
+    catch { }
+    const candidates = [
+        'index.ts', 'server.ts', 'app.ts',
+        'index.js', 'server.js', 'app.js',
+        'src/index.ts', 'src/server.ts', 'src/app.ts',
+        'src/index.js', 'src/server.js', 'src/app.js',
+    ];
+    for (const c of candidates)
+        if ((0, fs_1.existsSync)((0, path_1.join)(cwd, c)))
+            return c;
+    return null;
+}
+// ─── Framework detection from source ─────────────────────────────────────────
+function detectFramework(src) {
+    if (/require\s*\(\s*['"]express['"]\s*\)|from\s+['"]express['"]/.test(src))
+        return 'Express';
+    if (/require\s*\(\s*['"]fastify['"]\s*\)|from\s+['"]fastify['"]/.test(src))
+        return 'Fastify';
+    if (/require\s*\(\s*['"]koa['"]\s*\)|from\s+['"]koa['"]/.test(src))
+        return 'Koa';
+    if (/require\s*\(\s*['"]hapi['"]\s*\)|from\s+['"]@hapi\/hapi['"]/.test(src))
+        return 'Hapi';
+    if (/from\s+['"]next\/server['"]|NextResponse/.test(src))
+        return 'Next.js';
+    if (/createServer|http\.createServer/.test(src))
+        return 'Node HTTP';
+    return 'Node.js';
+}
+function injectCode(filePath, projectName, apiKey, baseUrl, method) {
+    const fullPath = (0, path_1.join)(process.cwd(), filePath);
+    const content = (0, fs_1.readFileSync)(fullPath, 'utf-8');
+    if (content.includes('apiforge-analyzer')) {
+        return { message: 'Already configured', alreadyInjected: true };
+    }
+    const isESM = detectESM(filePath, content);
+    const appVar = detectAppVariable(content) ?? 'app';
+    const snippet = getCodeSnippet(projectName, apiKey, baseUrl, method, appVar, isESM);
+    const listenRe = /\b(?:app|server|httpServer|http)\s*\.listen\s*\(/;
+    const listenMatch = listenRe.exec(content);
+    let newContent;
+    let injectionPoint;
+    if (listenMatch?.index !== undefined) {
+        const lineStart = content.lastIndexOf('\n', listenMatch.index - 1) + 1;
+        newContent = content.slice(0, lineStart) + snippet + '\n' + content.slice(lineStart);
+        injectionPoint = `before ${listenMatch[0].trim()}…`;
+    }
+    else {
+        newContent = content.trimEnd() + '\n\n' + snippet;
+        injectionPoint = 'end of file';
+    }
+    (0, fs_1.writeFileSync)(fullPath, newContent, 'utf-8');
+    const linesAdded = snippet.split('\n').length;
+    return {
+        message: `Patched ${filePath}`,
+        alreadyInjected: false,
+        appVar,
+        injectionPoint,
+        linesAdded,
+    };
+}
+function detectESM(filePath, content) {
+    try {
+        const pkg = JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(process.cwd(), 'package.json'), 'utf-8'));
+        if (pkg.type === 'module')
+            return true;
+    }
+    catch { }
+    if (filePath.endsWith('.mjs'))
+        return true;
+    if (filePath.endsWith('.cjs'))
+        return false;
+    return /^(?:import|export)\s+/m.test(content);
+}
+function detectAppVariable(content) {
+    let m = content.match(/(?:const|let|var)\s+(\w+)\s*=\s*express\s*(?:\.default)?\s*\(/);
+    if (m)
+        return m[1];
+    m = content.match(/(?:const|let|var)\s+(\w+)\s*=\s*(?:fastify|Fastify)\s*\(/);
+    if (m)
+        return m[1];
+    m = content.match(/(?:const|let|var)\s+(\w+)\s*=\s*new\s+Koa\s*\(/);
+    if (m)
+        return m[1];
+    return null;
+}
+// ─── Snippet builder ──────────────────────────────────────────────────────────
+function getCodeSnippet(projectName, apiKey, baseUrl, method, appVar, isESM) {
+    const isJson = method === 'json';
+    const opts = isJson
+        ? [
+            `    apiKey: '${apiKey}',`,
+            `    projectName: '${projectName}',`,
+            `    baseUrl: '${baseUrl}',`,
+            `    saveJson: true,`,
+            `    jsonPath: './api-export.json',`,
+            `    upload: false,`,
+        ].join('\n')
+        : [
+            `    apiKey: '${apiKey}',`,
+            `    projectName: '${projectName}',`,
+            `    baseUrl: '${baseUrl}',`,
+            `    apiForgeUrl: 'https://apiforge.brainfogagency.com',`,
+            `    upload: true,`,
+        ].join('\n');
+    if (isESM) {
+        return [
+            `// APIForge — https://apiforge.brainfogagency.com`,
+            `import('apiforge-analyzer').then(({ default: APIForge }) => {`,
+            `  APIForge.analyze(${appVar}, {`,
+            opts,
+            `  })`,
+            `}).catch(() => {})`,
+            '',
+        ].join('\n');
+    }
+    return [
+        `// APIForge — https://apiforge.brainfogagency.com`,
+        `Promise.resolve().then(() => require('apiforge-analyzer')).then(mod => {`,
+        `  const APIForge = mod.default || mod`,
+        `  APIForge.analyze(${appVar}, {`,
+        opts,
+        `  })`,
+        `}).catch(() => {})`,
+        '',
+    ].join('\n');
+}
+/** First 4 lines of the injected snippet for the summary preview. */
+function getSnippetPreview(method, appVar) {
+    const isJson = method === 'json';
+    return [
+        `// APIForge — https://apiforge.brainfogagency.com`,
+        `import('apiforge-analyzer').then(({ default: APIForge }) => {`,
+        `  APIForge.analyze(${appVar}, {`,
+        `    ${isJson ? 'saveJson: true, upload: false,' : 'upload: true,'}`,
+        `  …`,
+    ];
+}
+/** Best-guess start command from package.json scripts. */
+function getStartCommand() {
+    try {
+        const pkg = JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(process.cwd(), 'package.json'), 'utf-8'));
+        if (pkg.scripts?.start)
+            return 'npm start';
+        if (pkg.scripts?.dev)
+            return 'npm run dev';
+        if (pkg.scripts?.serve)
+            return 'npm run serve';
+    }
+    catch { }
+    return 'node ' + (detectedEntry || 'index.js');
+}
+// ─── Util ─────────────────────────────────────────────────────────────────────
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});