froggy-docs 1.1.3 → 1.1.4

package/frontend/lib/app.dart

@@ -112,7 +112,8 @@ class _AppState extends State<App> {
       }
 
       final headers = <String, String>{};
-      if (!hasFiles) headers['Content-Type'] = 'application/json';
+      final isGetOrHead = method.toUpperCase() == 'GET' || method.toUpperCase() == 'HEAD';
+      if (!hasFiles && !isGetOrHead) headers['Content-Type'] = 'application/json';
       if (_authHeader.isNotEmpty) headers['Authorization'] = _authHeader;
       for (final hp in headerParams) {
         final name = hp['name'] as String;
@@ -148,19 +149,19 @@ class _AppState extends State<App> {
 
         final streamed = await req.send();
         resp = await http.Response.fromStream(streamed);
+      } else if (isGetOrHead) {
+        resp = await http.get(uri, headers: headers);
       } else {
         final req = http.Request(method.toUpperCase(), uri);
         req.headers.addAll(headers);
 
-        if (method.toUpperCase() != 'GET' && method.toUpperCase() != 'HEAD') {
-          final savedValues = _bodyValues[key] ?? {};
-          final bodyData = <String, dynamic>{};
-          for (final entry in (bodyProps ?? {}).entries) {
-            final val = savedValues[entry.key] ?? '';
-            if (val.isNotEmpty) bodyData[entry.key] = val;
-          }
-          req.body = jsonEncode(bodyData);
+        final savedValues = _bodyValues[key] ?? {};
+        final bodyData = <String, dynamic>{};
+        for (final entry in (bodyProps ?? {}).entries) {
+          final val = savedValues[entry.key] ?? '';
+          if (val.isNotEmpty) bodyData[entry.key] = val;
         }
+        req.body = jsonEncode(bodyData);
 
         final client = http.Client();
         try {

package/frontend/web/froggy_docs.json

@@ -136,64 +136,13 @@
           "200": {
             "description": "Successful response"
           }
-        },
-        "parameters": [
-          {
-            "name": "page",
-            "in": "query",
-            "description": "Page number",
-            "schema": {
-              "type": "int",
-              "default": 1
-            }
-          },
-          {
-            "name": "limit",
-            "in": "query",
-            "description": "Items per page",
-            "schema": {
-              "type": "int",
-              "default": 10
-            }
-          },
-          {
-            "name": "search",
-            "in": "query",
-            "description": "Search term",
-            "schema": {
-              "type": "string"
-            }
-          }
-        ]
+        }
       },
       "post": {
         "summary": "Create user",
         "responses": {
-          "201": {
-            "description": "User created",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object"
-                },
-                "example": {
-                  "id": 1
-                }
-              }
-            }
-          },
-          "400": {
-            "description": "Bad request",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object"
-                },
-                "example": {
-                  "error": "Invalid input"
-                }
-              }
-            }
+          "200": {
+            "description": "Successful response"
           }
         }
       }
@@ -234,27 +183,6 @@
           "200": {
             "description": "Successful response"
           }
-        },
-        "requestBody": {
-          "content": {
-            "multipart/form-data": {
-              "schema": {
-                "type": "object",
-                "properties": {
-                  "avatar": {
-                    "type": "string",
-                    "format": "binary",
-                    "description": "User profile picture"
-                  },
-                  "document": {
-                    "type": "string",
-                    "format": "binary",
-                    "description": "Optional PDF attachment"
-                  }
-                }
-              }
-            }
-          }
         }
       }
     },
@@ -268,7 +196,7 @@
         },
         "requestBody": {
           "content": {
-            "multipart/form-data": {
+            "application/json": {
               "schema": {
                 "type": "object",
                 "properties": {
@@ -279,11 +207,6 @@
                   "bio": {
                     "type": "string",
                     "description": "User biography"
-                  },
-                  "avatar": {
-                    "type": "string",
-                    "format": "binary",
-                    "description": "Profile picture"
                   }
                 }
               }
@@ -299,25 +222,7 @@
           "200": {
             "description": "Successful response"
           }
-        },
-        "parameters": [
-          {
-            "name": "X-Request-ID",
-            "in": "header",
-            "description": "Optional trace ID",
-            "schema": {
-              "type": "string"
-            }
-          },
-          {
-            "name": "X-Api-Version",
-            "in": "header",
-            "description": "API version",
-            "schema": {
-              "type": "string"
-            }
-          }
-        ]
+        }
       }
     },
     "/api/items": {

package/lib/src/parser_engine.dart

@@ -326,6 +326,20 @@ class ParserEngine {
             },
           });
         }
+        final pathParamMatches = RegExp(r'\{(\w+)\}').allMatches(path);
+        for (final match in pathParamMatches) {
+          final paramName = match.group(1)!;
+          if (!parameters.any((p) => p['name'] == paramName && p['in'] == 'path')) {
+            parameters.insert(0, {
+              "name": paramName,
+              "in": "path",
+              "required": true,
+              "description": '',
+              "schema": {"type": "string"},
+            });
+          }
+        }
+
         if (parameters.isNotEmpty) {
           endpointData['parameters'] = parameters;
         }
@@ -466,7 +480,10 @@ class ParserEngine {
         flushEndpoint();
         if (parts.length >= 3) {
           currentMethod = parts[1].toUpperCase();
-          currentPath = parts[2];
+          currentPath = parts[2].replaceAllMapped(
+            RegExp(r':(\w+)'),
+            (m) => '{${m.group(1)}}',
+          );
         } else {
           _errors.add('@api requires method and path at line $lineNumber');
         }

package/package.json

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