froggy-docs 1.1.1 → 1.1.4

package/lib/src/watcher_engine.dart

@@ -1,10 +1,24 @@
 import 'dart:io';
+import 'dart:async';
 import 'package:watcher/watcher.dart';
 import 'package:path/path.dart' as p;
 import 'parser_engine.dart';
 
 class WatcherEngine {
-  final ParserEngine _parser = ParserEngine();
+  final ParserEngine _parser;
+  Timer? _debounceTimer;
+  final Duration _debounceDuration;
+  final String? _ignorePattern;
+
+  WatcherEngine({
+    String outputPath = 'frontend/web/froggy_docs.json',
+    String ignorePattern = '',
+    Duration debounceDuration = const Duration(milliseconds: 300),
+  })  : _parser = ParserEngine(),
+        _debounceDuration = debounceDuration,
+        _ignorePattern = ignorePattern.isEmpty ? null : ignorePattern {
+    _parser.setOutputPath(outputPath);
+  }
 
   void startWatching(String directoryPath) {
     print('🚀 Initializing FroggyDocs scan...');
@@ -28,31 +42,49 @@ class WatcherEngine {
         }
       });
     } catch (e) {
-      print('⚠️ Warning during initial scan: $e');
+      print('⚠️  Warning during initial scan: $e');
     }
     print('✅ Initial scan complete.\n');
   }
 
   bool _shouldIgnore(String path) {
     final normalizedPath = path.replaceAll('\\', '/');
-    return normalizedPath.contains('/.dart_tool/') ||
+    if (normalizedPath.contains('/.dart_tool/') ||
         normalizedPath.contains('/frontend/') ||
         normalizedPath.contains('/node_modules/') ||
         normalizedPath.contains('/.git/') ||
         normalizedPath.endsWith('.json') ||
-        normalizedPath.endsWith('.md');
+        normalizedPath.endsWith('.md')) {
+      return true;
+    }
+
+    if (_ignorePattern != null) {
+      final regexPattern = _ignorePattern
+          .replaceAll('.', r'\.')
+          .replaceAll('*', '.*')
+          .replaceAll('?', '.');
+      if (RegExp(regexPattern).hasMatch(normalizedPath)) {
+        return true;
+      }
+    }
+
+    return false;
   }
 
   void _handleFileChange(WatchEvent event) {
-    switch (event.type) {
-      case ChangeType.ADD:
-      case ChangeType.MODIFY:
-        _parser.parseFile(event.path);
-        break;
-      case ChangeType.REMOVE:
-        print('🗑️ Removing documentation for: ${p.basename(event.path)}');
-        _parser.removeFile(event.path);
-        break;
-    }
+    _debounceTimer?.cancel();
+
+    _debounceTimer = Timer(_debounceDuration, () {
+      switch (event.type) {
+        case ChangeType.ADD:
+        case ChangeType.MODIFY:
+          _parser.parseFile(event.path);
+          break;
+        case ChangeType.REMOVE:
+          print('🗑️  Removing documentation for: ${p.basename(event.path)}');
+          _parser.removeFile(event.path);
+          break;
+      }
+    });
   }
 }

package/lib/src/web_server.dart

@@ -1,6 +1,7 @@
 import 'dart:io';
 import 'dart:async';
 import 'dart:convert';
+import 'dart:typed_data';
 import 'package:shelf/shelf.dart';
 import 'package:shelf/shelf_io.dart' as shelf_io;
 import 'package:shelf_router/shelf_router.dart';
@@ -47,14 +48,14 @@ Router get _router {
 
   router.get('/froggy_docs.json', (Request request) async {
     var file = File(p.join(userWebDir, 'froggy_docs.json'));
-    if (await file.existsSync()) {
+    if (file.existsSync()) {
       return Response.ok(
         file.openRead(),
         headers: {'Content-Type': 'application/json'},
       );
     }
     file = File(p.join(webDir, 'froggy_docs.json'));
-    if (await file.existsSync()) {
+    if (file.existsSync()) {
       return Response.ok(
         file.openRead(),
         headers: {'Content-Type': 'application/json'},
@@ -65,7 +66,7 @@ Router get _router {
 
   router.get('/', (Request request) async {
     final indexFile = File(p.join(webDir, 'index.html'));
-    if (await indexFile.existsSync()) {
+    if (indexFile.existsSync()) {
       return Response.ok(
         indexFile.openRead(),
         headers: {'Content-Type': 'text/html'},
@@ -74,11 +75,6 @@ Router get _router {
     return Response.notFound('index.html not found');
   });
 
-  // ═════════════════════════════════════════════════════════════
-  // Demo/Mock API Endpoints
-  // These are included for testing "Try It Out" functionality
-  // Remove these routes in production - your real API will handle requests
-  // ═════════════════════════════════════════════════════════════
   router.post('/api/simple', (Request request) async {
     final body = await request.readAsString();
     return Response.ok(
@@ -110,6 +106,27 @@ Router get _router {
     );
   });
 
+  router.post('/api/upload', (Request request) async {
+    final contentType = request.headers['content-type'] ?? '';
+    if (contentType.contains('multipart/form-data')) {
+      return Response.ok(
+        jsonEncode({
+          'status': 'success',
+          'message': 'File upload received (multipart/form-data)',
+        }),
+        headers: {'Content-Type': 'application/json'},
+      );
+    }
+    final body = await request.readAsString();
+    return Response.ok(
+      jsonEncode({
+        'status': 'success',
+        'received': body.isNotEmpty ? jsonDecode(body) : {},
+      }),
+      headers: {'Content-Type': 'application/json'},
+    );
+  });
+
   router.get(
     '/api/simple',
     (Request request) => Response.ok(
@@ -139,13 +156,6 @@ 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
-  // ═══════════════════════════════════════════════════════════════
-
-  // 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"');
@@ -154,12 +164,21 @@ Router get _router {
     try {
       final targetUrl = '$_proxyUrl/api/$path';
       final method = request.method;
+      final contentType = request.headers['content-type'] ?? '';
 
       final client = http.Client();
       http.Request req;
 
       if (method == 'GET' || method == 'HEAD') {
         req = http.Request(method, Uri.parse(targetUrl));
+      } else if (contentType.contains('multipart/form-data')) {
+        // Read as bytes to preserve binary file data.
+        final chunks = <int>[];
+        await for (final chunk in request.read()) {
+          chunks.addAll(chunk);
+        }
+        req = http.Request(method, Uri.parse(targetUrl));
+        req.bodyBytes = Uint8List.fromList(chunks);
       } else {
         final body = await request.readAsString();
         req = http.Request(method, Uri.parse(targetUrl));
@@ -174,6 +193,10 @@ Router get _router {
         }
       });
 
+      if (contentType.contains('multipart/form-data')) {
+        req.headers['content-type'] = contentType;
+      }
+
       final streamedResponse = await client.send(req);
       final responseBody = await streamedResponse.stream.bytesToString();
       
@@ -195,14 +218,14 @@ Router get _router {
 
   router.get('/<path|[^/]+>', (Request request, String path) async {
     var file = File(p.join(deployDir, path));
-    if (await file.existsSync()) {
+    if (file.existsSync()) {
       return Response.ok(
         file.openRead(),
         headers: {'Content-Type': _getContentType(path)},
       );
     }
     file = File(p.join(webDir, path));
-    if (await file.existsSync()) {
+    if (file.existsSync()) {
       return Response.ok(
         file.openRead(),
         headers: {'Content-Type': _getContentType(path)},

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "froggy-docs",
-  "version": "1.1.1",
+  "version": "1.1.4",
   "description": "Auto-generate API documentation from code annotations. Works with any programming language.",
-  "author": "Kaung Mrat Thu <kaungmyatthuu.dev@gmail.com>",
+  "author": "Kaung Mrat Thu <kaungmratthu.dev@gmail.com>",
   "homepage": "https://github.com/Kaung-Myat/froggydocs",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Kaung-Myat/froggydocs.git"
+    "url": "git+https://github.com/Kaung-Myat/froggydocs.git"
   },
   "license": "MIT",
   "keywords": [
@@ -19,7 +19,7 @@
     "developer-tools"
   ],
   "bin": {
-    "froggy-docs": "./bin/froggy-docs"
+    "froggy-docs": "package.js"
   },
   "scripts": {},
   "engines": {