froggy-docs 1.0.9 → 1.1.0

package/bin/froggy_docs.dart

@@ -14,6 +14,12 @@ void main(List<String> arguments) async {
     help: 'Port for server',
     defaultsTo: '8080',
   );
+  parser.addOption(
+    'proxy',
+    abbr: 'x',
+    help: 'Proxy API requests to this URL (e.g., http://localhost:3000)',
+    defaultsTo: '',
+  );
 
   try {
     final results = parser.parse(arguments);
@@ -24,10 +30,14 @@ void main(List<String> arguments) async {
       watcher.startWatching(Directory.current.path);
     } else if (results.command?.name == 'serve') {
       final port = int.parse(results['port'] as String);
+      final proxyUrl = results['proxy'] as String;
       print('🐸 Starting FroggyDocs server with live reload...');
+      if (proxyUrl.isNotEmpty) {
+        print('🔄 Proxy enabled: API requests will be forwarded to $proxyUrl');
+      }
 
       // Start server and watcher
-      await startServer(port: port);
+      await startServer(port: port, proxyUrl: proxyUrl);
       final watcher = WatcherEngine();
       watcher.startWatching(Directory.current.path);
     }

package/lib/src/web_server.dart

@@ -5,10 +5,15 @@ import 'package:shelf/shelf.dart';
 import 'package:shelf/shelf_io.dart' as shelf_io;
 import 'package:shelf_router/shelf_router.dart';
 import 'package:path/path.dart' as p;
+import 'package:http/http.dart' as http;
 
 const defaultPort = 8080;
 
-Future<void> startServer({int port = defaultPort}) async {
+String _proxyUrl = '';
+
+Future<void> startServer({int port = defaultPort, String proxyUrl = ''}) async {
+  _proxyUrl = proxyUrl;
+  
   final handler = const Pipeline()
       .addMiddleware(logRequests())
       .addHandler(_router.call);
@@ -137,8 +142,51 @@ Router get _router {
   // ═════════════════════════════════════════════════════════════
   // End of Demo/Mock API
   // In production: Remove lines 66-124 or connect to your real API
-  // The "Try It Out" button will call your actual API endpoints
-  // ═════════════════════════════════════════════════════════════
+// The "Try It Out" button will call your actual API endpoints
+  // ═══════════════════════════════════════════════════════════════
+
+  // Proxy API requests to backend server
+  router.all('/api/<path.*>', (Request request, String path) async {
+    if (_proxyUrl.isEmpty) {
+      return Response.notFound('{"error": "Proxy not configured. Use --proxy http://localhost:3000"');
+    }
+
+    try {
+      final targetUrl = '$_proxyUrl/api/$path';
+      final method = request.method;
+      final headers = <String, String>{};
+      
+      request.headers.forEach((key, value) {
+        if (key.toLowerCase() != 'host') {
+          headers[key] = value;
+        }
+      });
+
+      String? body;
+      if (method != 'GET' && method != 'HEAD') {
+        body = await request.readAsString();
+      }
+
+      final proxyResponse = await http.Request(method, Uri.parse(targetUrl))
+          .send();
+
+      final responseBody = await proxyResponse.stream.bytesToString();
+      
+      return Response(
+        proxyResponse.statusCode,
+        body: responseBody,
+        headers: {
+          'Content-Type': proxyResponse.headers['content-type'] ?? 'application/json',
+          ..._corsHeaders,
+        },
+      );
+    } catch (e) {
+      return Response.internalServerError(
+        body: '{"error": "Proxy error: $e"}',
+        headers: {'Content-Type': 'application/json'},
+      );
+    }
+  });
 
   router.get('/<path|[^/]+>', (Request request, String path) async {
     var file = File(p.join(deployDir, path));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "froggy-docs",
-  "version": "1.0.9",
+  "version": "1.1.0",
   "description": "Auto-generate API documentation from code annotations. Works with any programming language.",
   "author": "Kaung Mrat Thu <kaungmyatthuu.dev@gmail.com>",
   "homepage": "https://github.com/Kaung-Myat/froggydocs",

package/pubspec.yaml

@@ -19,6 +19,7 @@ dependencies:
   watcher: ^1.2.1
   shelf: ^1.4.2
   shelf_router: ^1.1.4
+  http: ^1.4.0
 
 dev_dependencies:
   lints: ^6.0.0