@cappitolian/http-local-server 0.0.8 → 0.0.9

package/android/src/main/java/com/cappitolian/plugins/httplocalserver/HttpLocalServer.java

@@ -25,167 +25,365 @@
 package com.cappitolian.plugins.httplocalservice;
 
 import android.content.Context;
+import android.net.wifi.WifiInfo;
 import android.net.wifi.WifiManager;
 import android.text.format.Formatter;
+import android.util.Log;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+
 import com.getcapacitor.JSObject;
 import com.getcapacitor.Plugin;
 import com.getcapacitor.PluginCall;
-import fi.iki.elonen.NanoHTTPD;
+
+import org.json.JSONException;
+import org.json.JSONObject;
+
 import java.io.IOException;
-import java.util.UUID;
-import java.util.concurrent.*;
 import java.util.HashMap;
 import java.util.Map;
+import java.util.UUID;
+import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.ConcurrentHashMap;
+import java.util.concurrent.TimeUnit;
+import java.util.concurrent.TimeoutException;
+
+import fi.iki.elonen.NanoHTTPD;
 
+/**
+ * Local HTTP server implementation for Android using NanoHTTPD.
+ * Handles incoming HTTP requests and communicates with JavaScript layer.
+ */
 public class HttpLocalServer {
+    
+    // MARK: - Constants
+    private static final String TAG = "HttpLocalServer";
+    private static final int DEFAULT_PORT = 8080;
+    private static final int DEFAULT_TIMEOUT_SECONDS = 5;
+    private static final String FALLBACK_IP = "127.0.0.1";
+    
+    // MARK: - Properties
     private LocalNanoServer server;
-    private String localIp;
-    private int port = 8080;
-    private Plugin plugin;
-
-    // Map to wait for responses from JS (key: requestId)
+    private final Plugin plugin;
+    private final int port;
+    private final int timeoutSeconds;
+    
     private static final ConcurrentHashMap<String, CompletableFuture<String>> pendingResponses = new ConcurrentHashMap<>();
-
-    public HttpLocalServer(Plugin plugin) {
+    
+    // MARK: - Constructor
+    public HttpLocalServer(@NonNull Plugin plugin) {
+        this(plugin, DEFAULT_PORT, DEFAULT_TIMEOUT_SECONDS);
+    }
+    
+    public HttpLocalServer(@NonNull Plugin plugin, int port, int timeoutSeconds) {
         this.plugin = plugin;
+        this.port = port;
+        this.timeoutSeconds = timeoutSeconds;
     }
-
-    public void connect(PluginCall call) {
-        if (server == null) {
-            localIp = getLocalIpAddress(plugin.getContext());
-            server = new LocalNanoServer(localIp, port, plugin);
-            try {
-                server.start();
-                JSObject ret = new JSObject();
-                ret.put("ip", localIp);
-                ret.put("port", port);
-                call.resolve(ret);
-            } catch (Exception e) {
-                call.reject("Failed to start server: " + e.getMessage());
-            }
-        } else {
+    
+    // MARK: - Public Methods
+    public void connect(@NonNull PluginCall call) {
+        if (server != null && server.isAlive()) {
             call.reject("Server is already running");
+            return;
+        }
+        
+        try {
+            String localIp = getLocalIpAddress(plugin.getContext());
+            server = new LocalNanoServer(localIp, port, plugin, timeoutSeconds);
+            server.start();
+            
+            JSObject response = new JSObject();
+            response.put("ip", localIp);
+            response.put("port", port);
+            call.resolve(response);
+            
+            Log.i(TAG, "Server started at " + localIp + ":" + port);
+        } catch (IOException e) {
+            Log.e(TAG, "Failed to start server", e);
+            call.reject("Failed to start server: " + e.getMessage());
         }
     }
-
-    public void disconnect(PluginCall call) {
+    
+    public void disconnect(@Nullable PluginCall call) {
         if (server != null) {
             server.stop();
             server = null;
+            
+            // Clear all pending responses
+            pendingResponses.clear();
+            
+            Log.i(TAG, "Server stopped");
+        }
+        
+        if (call != null) {
+            call.resolve();
         }
-        call.resolve();
     }
-
-    // Called by plugin when JS responds
-    public static void handleJsResponse(String requestId, String body) {
+    
+    // MARK: - Static Methods
+    /**
+     * Called by plugin when JavaScript responds to a request
+     */
+    public static void handleJsResponse(@NonNull String requestId, @NonNull String body) {
         CompletableFuture<String> future = pendingResponses.remove(requestId);
-        if (future != null) {
+        if (future != null && !future.isDone()) {
             future.complete(body);
+            Log.d(TAG, "Response received for request: " + requestId);
+        } else {
+            Log.w(TAG, "No pending request found for ID: " + requestId);
         }
     }
-
-    // Helper to get local WiFi IP Address
-    private String getLocalIpAddress(Context context) {
-        WifiManager wm = (WifiManager) context.getApplicationContext().getSystemService(Context.WIFI_SERVICE);
-        if (wm != null && wm.getConnectionInfo() != null) {
-            return Formatter.formatIpAddress(wm.getConnectionInfo().getIpAddress());
+    
+    // MARK: - Private Methods
+    /**
+     * Get the local WiFi IP address
+     */
+    @NonNull
+    private String getLocalIpAddress(@NonNull Context context) {
+        try {
+            WifiManager wifiManager = (WifiManager) context.getApplicationContext()
+                    .getSystemService(Context.WIFI_SERVICE);
+            
+            if (wifiManager == null) {
+                Log.w(TAG, "WifiManager is null, using fallback IP");
+                return FALLBACK_IP;
+            }
+            
+            WifiInfo wifiInfo = wifiManager.getConnectionInfo();
+            if (wifiInfo == null) {
+                Log.w(TAG, "WifiInfo is null, using fallback IP");
+                return FALLBACK_IP;
+            }
+            
+            int ipAddress = wifiInfo.getIpAddress();
+            if (ipAddress == 0) {
+                Log.w(TAG, "IP address is 0, using fallback IP");
+                return FALLBACK_IP;
+            }
+            
+            return Formatter.formatIpAddress(ipAddress);
+        } catch (Exception e) {
+            Log.e(TAG, "Error getting IP address", e);
+            return FALLBACK_IP;
         }
-        return "127.0.0.1"; // fallback
     }
-
+    
+    // MARK: - Inner Class: LocalNanoServer
+    /**
+     * NanoHTTPD server implementation that handles HTTP requests
+     */
     private static class LocalNanoServer extends NanoHTTPD {
-        private Plugin plugin;
-
-        public LocalNanoServer(String hostname, int port, Plugin plugin) {
+        
+        private final Plugin plugin;
+        private final int timeoutSeconds;
+        
+        public LocalNanoServer(@NonNull String hostname, int port, @NonNull Plugin plugin, int timeoutSeconds) {
             super(hostname, port);
             this.plugin = plugin;
+            this.timeoutSeconds = timeoutSeconds;
         }
-
+        
         @Override
-        public Response serve(IHTTPSession session) {
-            String path = session.getUri();
+        public Response serve(@NonNull IHTTPSession session) {
             String method = session.getMethod().name();
-
-            // Read body if needed
-            String body = "";
-            if (session.getMethod() == Method.POST || session.getMethod() == Method.PUT) {
-                try {
-                    // Crear un mapa para almacenar los datos parseados
-                    HashMap<String, String> files = new HashMap<>();
-                    session.parseBody(files);
-                    
-                    // El body viene en el mapa con la clave "postData"
-                    body = files.get("postData");
-                    
-                    // Si postData es null, intentar obtener de los parámetros (para form-data)
-                    if (body == null || body.isEmpty()) {
-                        // Para application/x-www-form-urlencoded
-                        body = session.getQueryParameterString();
-                    }
-                    
-                    // Log para debug
-                    System.out.println("Body received: " + body);
-                    
-                } catch (Exception e) {
-                    System.err.println("Error parsing body: " + e.getMessage());
-                    e.printStackTrace();
+            String path = session.getUri();
+            
+            // Handle CORS preflight
+            if (Method.OPTIONS.equals(session.getMethod())) {
+                return createCorsResponse();
+            }
+            
+            try {
+                // Extract request data
+                String body = extractBody(session);
+                Map<String, String> headers = session.getHeaders();
+                Map<String, String> params = session.getParms();
+                
+                // Process request
+                String responseBody = processRequest(method, path, body, headers, params);
+                
+                return createJsonResponse(responseBody, Response.Status.OK);
+            } catch (Exception e) {
+                Log.e(TAG, "Error processing request", e);
+                return createErrorResponse("Internal server error: " + e.getMessage(), 
+                        Response.Status.INTERNAL_ERROR);
+            }
+        }
+        
+        /**
+         * Extract body from POST/PUT/PATCH requests
+         */
+        @Nullable
+        private String extractBody(@NonNull IHTTPSession session) {
+            Method method = session.getMethod();
+            
+            if (method != Method.POST && method != Method.PUT && method != Method.PATCH) {
+                return null;
+            }
+            
+            try {
+                HashMap<String, String> files = new HashMap<>();
+                session.parseBody(files);
+                
+                // Body comes in the map with key "postData"
+                String body = files.get("postData");
+                
+                // Fallback to query parameters for form-data
+                if (body == null || body.isEmpty()) {
+                    body = session.getQueryParameterString();
                 }
+                
+                Log.d(TAG, "Body received (" + body.length() + " bytes): " + 
+                        (body != null ? body.substring(0, Math.min(body.length(), 100)) : "null"));
+                
+                return body;
+            } catch (IOException | ResponseException e) {
+                Log.e(TAG, "Error parsing body", e);
+                return null;
             }
-
-            // Generate a unique requestId
+        }
+        
+        /**
+         * Process the request and wait for JavaScript response
+         */
+        @NonNull
+        private String processRequest(@NonNull String method, @NonNull String path, 
+                                      @Nullable String body, @NonNull Map<String, String> headers,
+                                      @NonNull Map<String, String> params) {
+            
             String requestId = UUID.randomUUID().toString();
-
-            // Prepare data for JS
-            JSObject req = new JSObject();
-            req.put("requestId", requestId);
-            req.put("method", method);
-            req.put("path", path);
-            req.put("body", body);
-            req.put("headers", getHeadersAsJson(session)); // Opcional: para debug
-
-            // Future to wait for JS response
+            
+            // Build request data for JavaScript
+            JSObject requestData = new JSObject();
+            requestData.put("requestId", requestId);
+            requestData.put("method", method);
+            requestData.put("path", path);
+            
+            if (body != null && !body.isEmpty()) {
+                requestData.put("body", body);
+            }
+            
+            if (!headers.isEmpty()) {
+                requestData.put("headers", mapToJson(headers));
+            }
+            
+            if (!params.isEmpty()) {
+                requestData.put("query", mapToJson(params));
+            }
+            
+            // Create future for response
             CompletableFuture<String> future = new CompletableFuture<>();
             pendingResponses.put(requestId, future);
-
-            // Send event to JS
-            if (plugin instanceof com.cappitolian.plugins.httplocalservice.HttpLocalServerPlugin) {
-                ((com.cappitolian.plugins.httplocalservice.HttpLocalServerPlugin) plugin).fireOnRequest(req);
+            
+            // Notify plugin
+            if (plugin instanceof HttpLocalServerPlugin) {
+                ((HttpLocalServerPlugin) plugin).fireOnRequest(requestData);
+            } else {
+                Log.e(TAG, "Plugin is not instance of HttpLocalServerPlugin");
             }
-
-            String jsResponse = null;
+            
+            // Wait for JavaScript response
             try {
-                // Wait up to 55 seconds for JS response
-                jsResponse = future.get(55, TimeUnit.SECONDS);
+                String response = future.get(timeoutSeconds, TimeUnit.SECONDS);
+                Log.d(TAG, "Response received for request: " + requestId);
+                return response;
             } catch (TimeoutException e) {
-                jsResponse = "{\"error\": \"Timeout waiting for JS response\"}";
+                Log.w(TAG, "Timeout waiting for response: " + requestId);
+                return createTimeoutError(requestId);
             } catch (Exception e) {
-                jsResponse = "{\"error\": \"Error waiting for JS response\"}";
+                Log.e(TAG, "Error waiting for response: " + requestId, e);
+                return createGenericError("Error waiting for response");
             } finally {
                 pendingResponses.remove(requestId);
             }
-
-            Response response = newFixedLengthResponse(Response.Status.OK, "application/json", jsResponse);
+        }
+        
+        /**
+         * Convert Map to JSObject
+         */
+        @NonNull
+        private JSObject mapToJson(@NonNull Map<String, String> map) {
+            JSObject json = new JSObject();
+            for (Map.Entry<String, String> entry : map.entrySet()) {
+                json.put(entry.getKey(), entry.getValue());
+            }
+            return json;
+        }
+        
+        /**
+         * Create JSON response with CORS headers
+         */
+        @NonNull
+        private Response createJsonResponse(@NonNull String body, @NonNull Response.Status status) {
+            Response response = newFixedLengthResponse(status, "application/json", body);
             addCorsHeaders(response);
             return response;
         }
-
-        // Método auxiliar para obtener headers como JSObject
-        private JSObject getHeadersAsJson(IHTTPSession session) {
-            JSObject headers = new JSObject();
+        
+        /**
+         * Create CORS preflight response
+         */
+        @NonNull
+        private Response createCorsResponse() {
+            Response response = newFixedLengthResponse(Response.Status.NO_CONTENT, 
+                    "text/plain", "");
+            addCorsHeaders(response);
+            return response;
+        }
+        
+        /**
+         * Create error response
+         */
+        @NonNull
+        private Response createErrorResponse(@NonNull String message, @NonNull Response.Status status) {
             try {
-                for (Map.Entry<String, String> entry : session.getHeaders().entrySet()) {
-                    headers.put(entry.getKey(), entry.getValue());
-                }
-            } catch (Exception e) {
-                // ignore
+                JSONObject error = new JSONObject();
+                error.put("error", message);
+                return createJsonResponse(error.toString(), status);
+            } catch (JSONException e) {
+                return newFixedLengthResponse(status, "text/plain", message);
             }
-            return headers;
         }
-
-        private void addCorsHeaders(Response response) {
+        
+        /**
+         * Create timeout error JSON
+         */
+        @NonNull
+        private String createTimeoutError(@NonNull String requestId) {
+            try {
+                JSONObject error = new JSONObject();
+                error.put("error", "Request timeout");
+                error.put("requestId", requestId);
+                return error.toString();
+            } catch (JSONException e) {
+                return "{\"error\":\"Request timeout\"}";
+            }
+        }
+        
+        /**
+         * Create generic error JSON
+         */
+        @NonNull
+        private String createGenericError(@NonNull String message) {
+            try {
+                JSONObject error = new JSONObject();
+                error.put("error", message);
+                return error.toString();
+            } catch (JSONException e) {
+                return "{\"error\":\"" + message + "\"}";
+            }
+        }
+        
+        /**
+         * Add CORS headers to response
+         */
+        private void addCorsHeaders(@NonNull Response response) {
             response.addHeader("Access-Control-Allow-Origin", "*");
-            response.addHeader("Access-Control-Allow-Methods", "GET,POST,OPTIONS");
-            response.addHeader("Access-Control-Allow-Headers", "origin, content-type, accept, authorization");
+            response.addHeader("Access-Control-Allow-Methods", "GET, POST, PUT, PATCH, DELETE, OPTIONS");
+            response.addHeader("Access-Control-Allow-Headers", "Origin, Content-Type, Accept, Authorization");
+            response.addHeader("Access-Control-Allow-Credentials", "true");
             response.addHeader("Access-Control-Max-Age", "3600");
         }
     }

package/android/src/main/java/com/cappitolian/plugins/httplocalserver/HttpLocalServerPlugin.java

@@ -46,16 +46,34 @@
 
 package com.cappitolian.plugins.httplocalservice;
 
-import com.getcapacitor.*;
+import android.util.Log;
+
+import androidx.annotation.NonNull;
+
+import com.getcapacitor.JSObject;
+import com.getcapacitor.Plugin;
+import com.getcapacitor.PluginCall;
+import com.getcapacitor.PluginMethod;
 import com.getcapacitor.annotation.CapacitorPlugin;
-import org.json.JSONException;
-import org.json.JSONObject;
 
 @CapacitorPlugin(name = "HttpLocalServer")
 public class HttpLocalServerPlugin extends Plugin {
-
+    
+    private static final String TAG = "HttpLocalServerPlugin";
     private HttpLocalServer localServer;
 
+    @Override
+    public void load() {
+        super.load();
+        // Inicializar el servidor con configuración por defecto
+        localServer = new HttpLocalServer(this);
+        
+        // O con configuración personalizada:
+        // localServer = new HttpLocalServer(this, 8080, 5); // puerto y timeout
+        
+        Log.d(TAG, "Plugin loaded");
+    }
+
     @PluginMethod
     public void connect(PluginCall call) {
         if (localServer == null) {
@@ -64,11 +82,6 @@ public class HttpLocalServerPlugin extends Plugin {
         localServer.connect(call);
     }
 
-    // Add this method:
-    public void fireOnRequest(JSObject req) {
-        notifyListeners("onRequest", req, true);
-    }
-
     @PluginMethod
     public void disconnect(PluginCall call) {
         if (localServer != null) {
@@ -82,11 +95,34 @@ public class HttpLocalServerPlugin extends Plugin {
     public void sendResponse(PluginCall call) {
         String requestId = call.getString("requestId");
         String body = call.getString("body");
-        if (requestId == null || body == null) {
-            call.reject("Missing requestId or body");
+        
+        if (requestId == null || requestId.isEmpty()) {
+            call.reject("Missing requestId");
             return;
         }
+        
+        if (body == null || body.isEmpty()) {
+            call.reject("Missing body");
+            return;
+        }
+        
         HttpLocalServer.handleJsResponse(requestId, body);
         call.resolve();
     }
+
+    /**
+     * Called by HttpLocalServer to notify JavaScript of incoming requests
+     */
+    public void fireOnRequest(@NonNull JSObject data) {
+        notifyListeners("onRequest", data);
+    }
+    
+    @Override
+    protected void handleOnDestroy() {
+        if (localServer != null) {
+            localServer.disconnect(null);
+            localServer = null;
+        }
+        super.handleOnDestroy();
+    }
 }

package/dist/docs.json

@@ -2,7 +2,7 @@
   "api": {
     "name": "HttpLocalServerPlugin",
     "slug": "httplocalserverplugin",
-    "docs": "",
+    "docs": "Plugin para manejar un servidor HTTP local en dispositivos nativos",
     "tags": [],
     "methods": [
       {
@@ -10,7 +10,16 @@
         "signature": "() => Promise<HttpConnectResult>",
         "parameters": [],
         "returns": "Promise<HttpConnectResult>",
-        "tags": [],
+        "tags": [
+          {
+            "name": "returns",
+            "text": "Promesa con la IP y puerto del servidor"
+          },
+          {
+            "name": "throws",
+            "text": "Error si el servidor no puede iniciarse"
+          }
+        ],
         "docs": "Inicia el servidor local en el dispositivo nativo.\nDevuelve la IP y el puerto asignado.",
         "complexTypes": [
           "HttpConnectResult"
@@ -22,25 +31,45 @@
         "signature": "() => Promise<void>",
         "parameters": [],
         "returns": "Promise<void>",
-        "tags": [],
-        "docs": "Detiene el servidor local.",
+        "tags": [
+          {
+            "name": "returns",
+            "text": "Promesa que se resuelve cuando el servidor se detiene"
+          }
+        ],
+        "docs": "Detiene el servidor local y limpia todos los recursos.",
         "complexTypes": [],
         "slug": "disconnect"
       },
       {
         "name": "sendResponse",
-        "signature": "(options: { requestId: string; body: string; }) => Promise<void>",
+        "signature": "(options: HttpSendResponseOptions) => Promise<void>",
         "parameters": [
           {
             "name": "options",
-            "docs": "",
-            "type": "{ requestId: string; body: string; }"
+            "docs": "- Objeto con requestId y body de la respuesta",
+            "type": "HttpSendResponseOptions"
           }
         ],
         "returns": "Promise<void>",
-        "tags": [],
+        "tags": [
+          {
+            "name": "param",
+            "text": "options - Objeto con requestId y body de la respuesta"
+          },
+          {
+            "name": "returns",
+            "text": "Promesa que se resuelve cuando la respuesta se envía"
+          },
+          {
+            "name": "throws",
+            "text": "Error si faltan requestId o body"
+          }
+        ],
         "docs": "Envía la respuesta de vuelta al cliente que hizo la petición.\nEl requestId debe coincidir con el recibido en 'onRequest'.",
-        "complexTypes": [],
+        "complexTypes": [
+          "HttpSendResponseOptions"
+        ],
         "slug": "sendresponse"
       },
       {
@@ -49,17 +78,30 @@
         "parameters": [
           {
             "name": "eventName",
-            "docs": "",
+            "docs": "- Debe ser 'onRequest'",
             "type": "'onRequest'"
           },
           {
             "name": "listenerFunc",
-            "docs": "",
+            "docs": "- Callback que recibe los datos de la petición",
             "type": "(data: HttpRequestData) => void"
           }
         ],
         "returns": "Promise<PluginListenerHandle>",
-        "tags": [],
+        "tags": [
+          {
+            "name": "param",
+            "text": "eventName - Debe ser 'onRequest'"
+          },
+          {
+            "name": "param",
+            "text": "listenerFunc - Callback que recibe los datos de la petición"
+          },
+          {
+            "name": "returns",
+            "text": "Handle para remover el listener"
+          }
+        ],
         "docs": "Escucha las peticiones HTTP entrantes.",
         "complexTypes": [
           "PluginListenerHandle",
@@ -72,7 +114,12 @@
         "signature": "() => Promise<void>",
         "parameters": [],
         "returns": "Promise<void>",
-        "tags": [],
+        "tags": [
+          {
+            "name": "returns",
+            "text": "Promesa que se resuelve cuando se eliminan los listeners"
+          }
+        ],
         "docs": "Elimina todos los listeners registrados.",
         "complexTypes": [],
         "slug": "removealllisteners"
@@ -84,7 +131,7 @@
     {
       "name": "HttpConnectResult",
       "slug": "httpconnectresult",
-      "docs": "",
+      "docs": "Resultado de la conexión del servidor",
       "tags": [],
       "methods": [],
       "properties": [
@@ -104,6 +151,29 @@
         }
       ]
     },
+    {
+      "name": "HttpSendResponseOptions",
+      "slug": "httpsendresponseoptions",
+      "docs": "Opciones para enviar una respuesta",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "requestId",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "body",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string"
+        }
+      ]
+    },
     {
       "name": "PluginListenerHandle",
       "slug": "pluginlistenerhandle",
@@ -123,7 +193,7 @@
     {
       "name": "HttpRequestData",
       "slug": "httprequestdata",
-      "docs": "",
+      "docs": "Datos de una petición HTTP entrante",
       "tags": [],
       "methods": [],
       "properties": [
@@ -153,19 +223,45 @@
           "tags": [],
           "docs": "",
           "complexTypes": [],
-          "type": "string"
+          "type": "string | undefined"
         },
         {
           "name": "headers",
           "tags": [],
           "docs": "",
-          "complexTypes": [],
-          "type": "any"
+          "complexTypes": [
+            "Record"
+          ],
+          "type": "Record<string, string>"
+        },
+        {
+          "name": "query",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [
+            "Record"
+          ],
+          "type": "Record<string, string>"
         }
       ]
     }
   ],
   "enums": [],
-  "typeAliases": [],
+  "typeAliases": [
+    {
+      "name": "Record",
+      "slug": "record",
+      "docs": "Construct a type with a set of properties K of type T",
+      "types": [
+        {
+          "text": "{\r\n    [P in K]: T;\r\n}",
+          "complexTypes": [
+            "K",
+            "T"
+          ]
+        }
+      ]
+    }
+  ],
   "pluginConfigs": []
 }

package/dist/esm/definitions.d.ts

@@ -1,39 +1,68 @@
 import type { PluginListenerHandle } from '@capacitor/core';
+/**
+ * Resultado de la conexión del servidor
+ */
 export interface HttpConnectResult {
     ip: string;
     port: number;
 }
+/**
+ * Datos de una petición HTTP entrante
+ */
 export interface HttpRequestData {
     requestId: string;
     method: string;
     path: string;
+    body?: string;
+    headers?: Record<string, string>;
+    query?: Record<string, string>;
+}
+/**
+ * Opciones para enviar una respuesta
+ */
+export interface HttpSendResponseOptions {
+    requestId: string;
     body: string;
-    headers?: any;
 }
+/**
+ * Plugin para manejar un servidor HTTP local en dispositivos nativos
+ */
 export interface HttpLocalServerPlugin {
     /**
      * Inicia el servidor local en el dispositivo nativo.
      * Devuelve la IP y el puerto asignado.
+     *
+     * @returns Promesa con la IP y puerto del servidor
+     * @throws Error si el servidor no puede iniciarse
      */
     connect(): Promise<HttpConnectResult>;
     /**
-     * Detiene el servidor local.
+     * Detiene el servidor local y limpia todos los recursos.
+     *
+     * @returns Promesa que se resuelve cuando el servidor se detiene
      */
     disconnect(): Promise<void>;
     /**
      * Envía la respuesta de vuelta al cliente que hizo la petición.
      * El requestId debe coincidir con el recibido en 'onRequest'.
+     *
+     * @param options - Objeto con requestId y body de la respuesta
+     * @returns Promesa que se resuelve cuando la respuesta se envía
+     * @throws Error si faltan requestId o body
      */
-    sendResponse(options: {
-        requestId: string;
-        body: string;
-    }): Promise<void>;
+    sendResponse(options: HttpSendResponseOptions): Promise<void>;
     /**
      * Escucha las peticiones HTTP entrantes.
+     *
+     * @param eventName - Debe ser 'onRequest'
+     * @param listenerFunc - Callback que recibe los datos de la petición
+     * @returns Handle para remover el listener
      */
     addListener(eventName: 'onRequest', listenerFunc: (data: HttpRequestData) => void): Promise<PluginListenerHandle>;
     /**
      * Elimina todos los listeners registrados.
+     *
+     * @returns Promesa que se resuelve cuando se eliminan los listeners
      */
     removeAllListeners(): Promise<void>;
 }

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\nexport interface HttpConnectResult {\n  ip: string;\n  port: number;\n}\n\nexport interface HttpRequestData {\n  requestId: string;\n  method: string;\n  path: string;\n  body: string;\n  headers?: any;\n}\n\nexport interface HttpLocalServerPlugin {\n  /**\n   * Inicia el servidor local en el dispositivo nativo.\n   * Devuelve la IP y el puerto asignado.\n   */\n  connect(): Promise<HttpConnectResult>;\n\n  /**\n   * Detiene el servidor local.\n   */\n  disconnect(): Promise<void>;\n\n  /**\n   * Envía la respuesta de vuelta al cliente que hizo la petición.\n   * El requestId debe coincidir con el recibido en 'onRequest'.\n   */\n  sendResponse(options: { requestId: string; body: string }): Promise<void>;\n\n  /**\n   * Escucha las peticiones HTTP entrantes.\n   */\n  addListener(\n    eventName: 'onRequest',\n    listenerFunc: (data: HttpRequestData) => void\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Elimina todos los listeners registrados.\n   */\n  removeAllListeners(): Promise<void>;\n}"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\n/**\n * Resultado de la conexión del servidor\n */\nexport interface HttpConnectResult {\n  ip: string;\n  port: number;\n}\n\n/**\n * Datos de una petición HTTP entrante\n */\nexport interface HttpRequestData {\n  requestId: string;\n  method: string;\n  path: string;\n  body?: string; // Ahora es opcional (GET/DELETE no tienen body)\n  headers?: Record<string, string>; // Mejor tipado que 'any'\n  query?: Record<string, string>; // Agregado: query parameters\n}\n\n/**\n * Opciones para enviar una respuesta\n */\nexport interface HttpSendResponseOptions {\n  requestId: string;\n  body: string;\n}\n\n/**\n * Plugin para manejar un servidor HTTP local en dispositivos nativos\n */\nexport interface HttpLocalServerPlugin {\n  /**\n   * Inicia el servidor local en el dispositivo nativo.\n   * Devuelve la IP y el puerto asignado.\n   * \n   * @returns Promesa con la IP y puerto del servidor\n   * @throws Error si el servidor no puede iniciarse\n   */\n  connect(): Promise<HttpConnectResult>;\n\n  /**\n   * Detiene el servidor local y limpia todos los recursos.\n   * \n   * @returns Promesa que se resuelve cuando el servidor se detiene\n   */\n  disconnect(): Promise<void>;\n\n  /**\n   * Envía la respuesta de vuelta al cliente que hizo la petición.\n   * El requestId debe coincidir con el recibido en 'onRequest'.\n   * \n   * @param options - Objeto con requestId y body de la respuesta\n   * @returns Promesa que se resuelve cuando la respuesta se envía\n   * @throws Error si faltan requestId o body\n   */\n  sendResponse(options: HttpSendResponseOptions): Promise<void>;\n\n  /**\n   * Escucha las peticiones HTTP entrantes.\n   * \n   * @param eventName - Debe ser 'onRequest'\n   * @param listenerFunc - Callback que recibe los datos de la petición\n   * @returns Handle para remover el listener\n   */\n  addListener(\n    eventName: 'onRequest',\n    listenerFunc: (data: HttpRequestData) => void\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Elimina todos los listeners registrados.\n   * \n   * @returns Promesa que se resuelve cuando se eliminan los listeners\n   */\n  removeAllListeners(): Promise<void>;\n}"]}

package/dist/esm/index.d.ts

@@ -1,8 +1,29 @@
 import type { HttpLocalServerPlugin } from './definitions';
 /**
- * Registramos el plugin.
- * El nombre 'HttpLocalServer' debe coincidir con el @CapacitorPlugin en Java
- * y el @objc(HttpLocalServerPlugin) en Swift.
+ * Plugin de servidor HTTP local para Android e iOS.
+ *
+ * Permite crear un servidor HTTP en el dispositivo que puede recibir
+ * peticiones desde otros dispositivos en la misma red.
+ *
+ * @example
+ * ```typescript
+ * import { HttpLocalServer } from '@cappitolian/http-local-server';
+ *
+ * // Iniciar servidor
+ * const { ip, port } = await HttpLocalServer.connect();
+ * console.log(`Servidor en http://${ip}:${port}`);
+ *
+ * // Escuchar peticiones
+ * await HttpLocalServer.addListener('onRequest', async (data) => {
+ *   console.log('Petición recibida:', data);
+ *
+ *   // Procesar y responder
+ *   await HttpLocalServer.sendResponse({
+ *     requestId: data.requestId,
+ *     body: JSON.stringify({ success: true })
+ *   });
+ * });
+ * ```
  */
 declare const HttpLocalServer: HttpLocalServerPlugin;
 export * from './definitions';

package/dist/esm/index.js

@@ -1,16 +1,34 @@
 import { registerPlugin } from '@capacitor/core';
 /**
- * Registramos el plugin.
- * El nombre 'HttpLocalServer' debe coincidir con el @CapacitorPlugin en Java
- * y el @objc(HttpLocalServerPlugin) en Swift.
+ * Plugin de servidor HTTP local para Android e iOS.
+ *
+ * Permite crear un servidor HTTP en el dispositivo que puede recibir
+ * peticiones desde otros dispositivos en la misma red.
+ *
+ * @example
+ * ```typescript
+ * import { HttpLocalServer } from '@cappitolian/http-local-server';
+ *
+ * // Iniciar servidor
+ * const { ip, port } = await HttpLocalServer.connect();
+ * console.log(`Servidor en http://${ip}:${port}`);
+ *
+ * // Escuchar peticiones
+ * await HttpLocalServer.addListener('onRequest', async (data) => {
+ *   console.log('Petición recibida:', data);
+ *
+ *   // Procesar y responder
+ *   await HttpLocalServer.sendResponse({
+ *     requestId: data.requestId,
+ *     body: JSON.stringify({ success: true })
+ *   });
+ * });
+ * ```
  */
 const HttpLocalServer = registerPlugin('HttpLocalServer', {
     web: () => import('./web').then(m => new m.HttpLocalServerWeb()),
 });
-// Exportamos las interfaces para que el usuario pueda tipar sus variables
 export * from './definitions';
-// Exportamos el objeto del plugin
 export { HttpLocalServer };
-// Exportación por defecto opcional para mayor compatibilidad
 export default HttpLocalServer;
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD;;;;GAIG;AACH,MAAM,eAAe,GAAG,cAAc,CAAwB,iBAAiB,EAAE;IAC/E,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,kBAAkB,EAAE,CAAC;CACjE,CAAC,CAAC;AAEH,0EAA0E;AAC1E,cAAc,eAAe,CAAC;AAE9B,kCAAkC;AAClC,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,6DAA6D;AAC7D,eAAe,eAAe,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\nimport type { HttpLocalServerPlugin } from './definitions';\n\n/**\n * Registramos el plugin. \n * El nombre 'HttpLocalServer' debe coincidir con el @CapacitorPlugin en Java \n * y el @objc(HttpLocalServerPlugin) en Swift.\n */\nconst HttpLocalServer = registerPlugin<HttpLocalServerPlugin>('HttpLocalServer', {\n  web: () => import('./web').then(m => new m.HttpLocalServerWeb()),\n});\n\n// Exportamos las interfaces para que el usuario pueda tipar sus variables\nexport * from './definitions';\n\n// Exportamos el objeto del plugin\nexport { HttpLocalServer };\n\n// Exportación por defecto opcional para mayor compatibilidad\nexport default HttpLocalServer;"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,eAAe,GAAG,cAAc,CAAwB,iBAAiB,EAAE;IAC/E,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,kBAAkB,EAAE,CAAC;CACjE,CAAC,CAAC;AAEH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,CAAC;AAC3B,eAAe,eAAe,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\nimport type { HttpLocalServerPlugin } from './definitions';\n\n/**\n * Plugin de servidor HTTP local para Android e iOS.\n * \n * Permite crear un servidor HTTP en el dispositivo que puede recibir\n * peticiones desde otros dispositivos en la misma red.\n * \n * @example\n * ```typescript\n * import { HttpLocalServer } from '@cappitolian/http-local-server';\n * \n * // Iniciar servidor\n * const { ip, port } = await HttpLocalServer.connect();\n * console.log(`Servidor en http://${ip}:${port}`);\n * \n * // Escuchar peticiones\n * await HttpLocalServer.addListener('onRequest', async (data) => {\n *   console.log('Petición recibida:', data);\n *   \n *   // Procesar y responder\n *   await HttpLocalServer.sendResponse({\n *     requestId: data.requestId,\n *     body: JSON.stringify({ success: true })\n *   });\n * });\n * ```\n */\nconst HttpLocalServer = registerPlugin<HttpLocalServerPlugin>('HttpLocalServer', {\n  web: () => import('./web').then(m => new m.HttpLocalServerWeb()),\n});\n\nexport * from './definitions';\nexport { HttpLocalServer };\nexport default HttpLocalServer;"]}

package/dist/esm/web.d.ts

@@ -1,10 +1,12 @@
 import { WebPlugin } from '@capacitor/core';
-import type { HttpLocalServerPlugin, HttpConnectResult } from './definitions';
+import type { HttpLocalServerPlugin, HttpConnectResult, HttpSendResponseOptions } from './definitions';
+/**
+ * Implementación web del plugin HttpLocalServer.
+ * Proporciona funcionalidad mock para desarrollo en navegador.
+ */
 export declare class HttpLocalServerWeb extends WebPlugin implements HttpLocalServerPlugin {
+    private isRunning;
     connect(): Promise<HttpConnectResult>;
     disconnect(): Promise<void>;
-    sendResponse(options: {
-        requestId: string;
-        body: string;
-    }): Promise<void>;
+    sendResponse(options: HttpSendResponseOptions): Promise<void>;
 }

package/dist/esm/web.js

@@ -1,15 +1,47 @@
 import { WebPlugin } from '@capacitor/core';
+/**
+ * Implementación web del plugin HttpLocalServer.
+ * Proporciona funcionalidad mock para desarrollo en navegador.
+ */
 export class HttpLocalServerWeb extends WebPlugin {
+    constructor() {
+        super(...arguments);
+        this.isRunning = false;
+    }
     async connect() {
-        console.warn('HttpLocalServer: El servidor nativo no se puede iniciar en el navegador.');
-        // Devolvemos un valor por defecto para no romper la ejecución en web
-        return { ip: '127.0.0.1', port: 8080 };
+        if (this.isRunning) {
+            console.warn('HttpLocalServer: El servidor ya está ejecutándose (Mock).');
+            return { ip: '127.0.0.1', port: 8080 };
+        }
+        console.warn('HttpLocalServer: El servidor nativo no está disponible en navegador. ' +
+            'Retornando valores mock para desarrollo.');
+        this.isRunning = true;
+        return {
+            ip: '127.0.0.1',
+            port: 8080
+        };
     }
     async disconnect() {
+        if (!this.isRunning) {
+            console.log('HttpLocalServer: El servidor ya está detenido (Mock).');
+            return;
+        }
         console.log('HttpLocalServer: Servidor detenido (Mock).');
+        this.isRunning = false;
     }
     async sendResponse(options) {
-        console.log('HttpLocalServer: Respuesta mock enviada al requestId:', options.requestId);
+        if (!this.isRunning) {
+            console.warn('HttpLocalServer: El servidor no está ejecutándose (Mock).');
+            return;
+        }
+        const { requestId, body } = options;
+        if (!requestId) {
+            throw new Error('Missing requestId');
+        }
+        if (!body) {
+            throw new Error('Missing body');
+        }
+        console.log(`HttpLocalServer: Respuesta mock enviada para requestId: ${requestId}`, '\nBody:', body.substring(0, 100) + (body.length > 100 ? '...' : ''));
     }
 }
 //# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,MAAM,OAAO,kBAAmB,SAAQ,SAAS;IAC/C,KAAK,CAAC,OAAO;QACX,OAAO,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;QACzF,qEAAqE;QACrE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAA4C;QAC7D,OAAO,CAAC,GAAG,CAAC,uDAAuD,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1F,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\nimport type { HttpLocalServerPlugin, HttpConnectResult } from './definitions';\n\nexport class HttpLocalServerWeb extends WebPlugin implements HttpLocalServerPlugin {\n  async connect(): Promise<HttpConnectResult> {\n    console.warn('HttpLocalServer: El servidor nativo no se puede iniciar en el navegador.');\n    // Devolvemos un valor por defecto para no romper la ejecución en web\n    return { ip: '127.0.0.1', port: 8080 };\n  }\n\n  async disconnect(): Promise<void> {\n    console.log('HttpLocalServer: Servidor detenido (Mock).');\n  }\n\n  async sendResponse(options: { requestId: string; body: string }): Promise<void> {\n    console.log('HttpLocalServer: Respuesta mock enviada al requestId:', options.requestId);\n  }\n}"]}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAO5C;;;GAGG;AACH,MAAM,OAAO,kBAAmB,SAAQ,SAAS;IAAjD;;QAEU,cAAS,GAAG,KAAK,CAAC;IAoD5B,CAAC;IAlDC,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;YAC1E,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACzC,CAAC;QAED,OAAO,CAAC,IAAI,CACV,uEAAuE;YACvE,0CAA0C,CAC3C,CAAC;QAEF,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAEtB,OAAO;YACL,EAAE,EAAE,WAAW;YACf,IAAI,EAAE,IAAI;SACX,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;QAC1D,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAgC;QACjD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;YAC1E,OAAO;QACT,CAAC;QAED,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;QAEpC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,CAAC,GAAG,CACT,2DAA2D,SAAS,EAAE,EACtE,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CACrE,CAAC;IACJ,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\nimport type {\n  HttpLocalServerPlugin,\n  HttpConnectResult,\n  HttpSendResponseOptions\n} from './definitions';\n\n/**\n * Implementación web del plugin HttpLocalServer.\n * Proporciona funcionalidad mock para desarrollo en navegador.\n */\nexport class HttpLocalServerWeb extends WebPlugin implements HttpLocalServerPlugin {\n\n  private isRunning = false;\n\n  async connect(): Promise<HttpConnectResult> {\n    if (this.isRunning) {\n      console.warn('HttpLocalServer: El servidor ya está ejecutándose (Mock).');\n      return { ip: '127.0.0.1', port: 8080 };\n    }\n\n    console.warn(\n      'HttpLocalServer: El servidor nativo no está disponible en navegador. ' +\n      'Retornando valores mock para desarrollo.'\n    );\n\n    this.isRunning = true;\n\n    return {\n      ip: '127.0.0.1',\n      port: 8080\n    };\n  }\n\n  async disconnect(): Promise<void> {\n    if (!this.isRunning) {\n      console.log('HttpLocalServer: El servidor ya está detenido (Mock).');\n      return;\n    }\n\n    console.log('HttpLocalServer: Servidor detenido (Mock).');\n    this.isRunning = false;\n  }\n\n  async sendResponse(options: HttpSendResponseOptions): Promise<void> {\n    if (!this.isRunning) {\n      console.warn('HttpLocalServer: El servidor no está ejecutándose (Mock).');\n      return;\n    }\n\n    const { requestId, body } = options;\n\n    if (!requestId) {\n      throw new Error('Missing requestId');\n    }\n\n    if (!body) {\n      throw new Error('Missing body');\n    }\n\n    console.log(\n      `HttpLocalServer: Respuesta mock enviada para requestId: ${requestId}`,\n      '\\nBody:', body.substring(0, 100) + (body.length > 100 ? '...' : '')\n    );\n  }\n}"]}

package/dist/plugin.cjs.js

@@ -5,25 +5,78 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var core = require('@capacitor/core');
 
 /**
- * Registramos el plugin.
- * El nombre 'HttpLocalServer' debe coincidir con el @CapacitorPlugin en Java
- * y el @objc(HttpLocalServerPlugin) en Swift.
+ * Plugin de servidor HTTP local para Android e iOS.
+ *
+ * Permite crear un servidor HTTP en el dispositivo que puede recibir
+ * peticiones desde otros dispositivos en la misma red.
+ *
+ * @example
+ * ```typescript
+ * import { HttpLocalServer } from '@cappitolian/http-local-server';
+ *
+ * // Iniciar servidor
+ * const { ip, port } = await HttpLocalServer.connect();
+ * console.log(`Servidor en http://${ip}:${port}`);
+ *
+ * // Escuchar peticiones
+ * await HttpLocalServer.addListener('onRequest', async (data) => {
+ *   console.log('Petición recibida:', data);
+ *
+ *   // Procesar y responder
+ *   await HttpLocalServer.sendResponse({
+ *     requestId: data.requestId,
+ *     body: JSON.stringify({ success: true })
+ *   });
+ * });
+ * ```
  */
 const HttpLocalServer = core.registerPlugin('HttpLocalServer', {
     web: () => Promise.resolve().then(function () { return web; }).then(m => new m.HttpLocalServerWeb()),
 });
 
+/**
+ * Implementación web del plugin HttpLocalServer.
+ * Proporciona funcionalidad mock para desarrollo en navegador.
+ */
 class HttpLocalServerWeb extends core.WebPlugin {
+    constructor() {
+        super(...arguments);
+        this.isRunning = false;
+    }
     async connect() {
-        console.warn('HttpLocalServer: El servidor nativo no se puede iniciar en el navegador.');
-        // Devolvemos un valor por defecto para no romper la ejecución en web
-        return { ip: '127.0.0.1', port: 8080 };
+        if (this.isRunning) {
+            console.warn('HttpLocalServer: El servidor ya está ejecutándose (Mock).');
+            return { ip: '127.0.0.1', port: 8080 };
+        }
+        console.warn('HttpLocalServer: El servidor nativo no está disponible en navegador. ' +
+            'Retornando valores mock para desarrollo.');
+        this.isRunning = true;
+        return {
+            ip: '127.0.0.1',
+            port: 8080
+        };
     }
     async disconnect() {
+        if (!this.isRunning) {
+            console.log('HttpLocalServer: El servidor ya está detenido (Mock).');
+            return;
+        }
         console.log('HttpLocalServer: Servidor detenido (Mock).');
+        this.isRunning = false;
     }
     async sendResponse(options) {
-        console.log('HttpLocalServer: Respuesta mock enviada al requestId:', options.requestId);
+        if (!this.isRunning) {
+            console.warn('HttpLocalServer: El servidor no está ejecutándose (Mock).');
+            return;
+        }
+        const { requestId, body } = options;
+        if (!requestId) {
+            throw new Error('Missing requestId');
+        }
+        if (!body) {
+            throw new Error('Missing body');
+        }
+        console.log(`HttpLocalServer: Respuesta mock enviada para requestId: ${requestId}`, '\nBody:', body.substring(0, 100) + (body.length > 100 ? '...' : ''));
     }
 }
 

package/dist/plugin.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\n/**\n * Registramos el plugin.\n * El nombre 'HttpLocalServer' debe coincidir con el @CapacitorPlugin en Java\n * y el @objc(HttpLocalServerPlugin) en Swift.\n */\nconst HttpLocalServer = registerPlugin('HttpLocalServer', {\n    web: () => import('./web').then(m => new m.HttpLocalServerWeb()),\n});\n// Exportamos las interfaces para que el usuario pueda tipar sus variables\nexport * from './definitions';\n// Exportamos el objeto del plugin\nexport { HttpLocalServer };\n// Exportación por defecto opcional para mayor compatibilidad\nexport default HttpLocalServer;\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class HttpLocalServerWeb extends WebPlugin {\n    async connect() {\n        console.warn('HttpLocalServer: El servidor nativo no se puede iniciar en el navegador.');\n        // Devolvemos un valor por defecto para no romper la ejecución en web\n        return { ip: '127.0.0.1', port: 8080 };\n    }\n    async disconnect() {\n        console.log('HttpLocalServer: Servidor detenido (Mock).');\n    }\n    async sendResponse(options) {\n        console.log('HttpLocalServer: Respuesta mock enviada al requestId:', options.requestId);\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;;;AACA;AACA;AACA;AACA;AACA;AACK,MAAC,eAAe,GAAGA,mBAAc,CAAC,iBAAiB,EAAE;AAC1D,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,kBAAkB,EAAE,CAAC;AACpE,CAAC;;ACPM,MAAM,kBAAkB,SAASC,cAAS,CAAC;AAClD,IAAI,MAAM,OAAO,GAAG;AACpB,QAAQ,OAAO,CAAC,IAAI,CAAC,0EAA0E,CAAC;AAChG;AACA,QAAQ,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE;AAC9C,IAAI;AACJ,IAAI,MAAM,UAAU,GAAG;AACvB,QAAQ,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC;AACjE,IAAI;AACJ,IAAI,MAAM,YAAY,CAAC,OAAO,EAAE;AAChC,QAAQ,OAAO,CAAC,GAAG,CAAC,uDAAuD,EAAE,OAAO,CAAC,SAAS,CAAC;AAC/F,IAAI;AACJ;;;;;;;;;;"}
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\n/**\n * Plugin de servidor HTTP local para Android e iOS.\n *\n * Permite crear un servidor HTTP en el dispositivo que puede recibir\n * peticiones desde otros dispositivos en la misma red.\n *\n * @example\n * ```typescript\n * import { HttpLocalServer } from '@cappitolian/http-local-server';\n *\n * // Iniciar servidor\n * const { ip, port } = await HttpLocalServer.connect();\n * console.log(`Servidor en http://${ip}:${port}`);\n *\n * // Escuchar peticiones\n * await HttpLocalServer.addListener('onRequest', async (data) => {\n *   console.log('Petición recibida:', data);\n *\n *   // Procesar y responder\n *   await HttpLocalServer.sendResponse({\n *     requestId: data.requestId,\n *     body: JSON.stringify({ success: true })\n *   });\n * });\n * ```\n */\nconst HttpLocalServer = registerPlugin('HttpLocalServer', {\n    web: () => import('./web').then(m => new m.HttpLocalServerWeb()),\n});\nexport * from './definitions';\nexport { HttpLocalServer };\nexport default HttpLocalServer;\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\n/**\n * Implementación web del plugin HttpLocalServer.\n * Proporciona funcionalidad mock para desarrollo en navegador.\n */\nexport class HttpLocalServerWeb extends WebPlugin {\n    constructor() {\n        super(...arguments);\n        this.isRunning = false;\n    }\n    async connect() {\n        if (this.isRunning) {\n            console.warn('HttpLocalServer: El servidor ya está ejecutándose (Mock).');\n            return { ip: '127.0.0.1', port: 8080 };\n        }\n        console.warn('HttpLocalServer: El servidor nativo no está disponible en navegador. ' +\n            'Retornando valores mock para desarrollo.');\n        this.isRunning = true;\n        return {\n            ip: '127.0.0.1',\n            port: 8080\n        };\n    }\n    async disconnect() {\n        if (!this.isRunning) {\n            console.log('HttpLocalServer: El servidor ya está detenido (Mock).');\n            return;\n        }\n        console.log('HttpLocalServer: Servidor detenido (Mock).');\n        this.isRunning = false;\n    }\n    async sendResponse(options) {\n        if (!this.isRunning) {\n            console.warn('HttpLocalServer: El servidor no está ejecutándose (Mock).');\n            return;\n        }\n        const { requestId, body } = options;\n        if (!requestId) {\n            throw new Error('Missing requestId');\n        }\n        if (!body) {\n            throw new Error('Missing body');\n        }\n        console.log(`HttpLocalServer: Respuesta mock enviada para requestId: ${requestId}`, '\\nBody:', body.substring(0, 100) + (body.length > 100 ? '...' : ''));\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;;;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACK,MAAC,eAAe,GAAGA,mBAAc,CAAC,iBAAiB,EAAE;AAC1D,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,kBAAkB,EAAE,CAAC;AACpE,CAAC;;AC5BD;AACA;AACA;AACA;AACO,MAAM,kBAAkB,SAASC,cAAS,CAAC;AAClD,IAAI,WAAW,GAAG;AAClB,QAAQ,KAAK,CAAC,GAAG,SAAS,CAAC;AAC3B,QAAQ,IAAI,CAAC,SAAS,GAAG,KAAK;AAC9B,IAAI;AACJ,IAAI,MAAM,OAAO,GAAG;AACpB,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE;AAC5B,YAAY,OAAO,CAAC,IAAI,CAAC,2DAA2D,CAAC;AACrF,YAAY,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE;AAClD,QAAQ;AACR,QAAQ,OAAO,CAAC,IAAI,CAAC,uEAAuE;AAC5F,YAAY,0CAA0C,CAAC;AACvD,QAAQ,IAAI,CAAC,SAAS,GAAG,IAAI;AAC7B,QAAQ,OAAO;AACf,YAAY,EAAE,EAAE,WAAW;AAC3B,YAAY,IAAI,EAAE;AAClB,SAAS;AACT,IAAI;AACJ,IAAI,MAAM,UAAU,GAAG;AACvB,QAAQ,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;AAC7B,YAAY,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC;AAChF,YAAY;AACZ,QAAQ;AACR,QAAQ,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC;AACjE,QAAQ,IAAI,CAAC,SAAS,GAAG,KAAK;AAC9B,IAAI;AACJ,IAAI,MAAM,YAAY,CAAC,OAAO,EAAE;AAChC,QAAQ,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;AAC7B,YAAY,OAAO,CAAC,IAAI,CAAC,2DAA2D,CAAC;AACrF,YAAY;AACZ,QAAQ;AACR,QAAQ,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO;AAC3C,QAAQ,IAAI,CAAC,SAAS,EAAE;AACxB,YAAY,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC;AAChD,QAAQ;AACR,QAAQ,IAAI,CAAC,IAAI,EAAE;AACnB,YAAY,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC;AAC3C,QAAQ;AACR,QAAQ,OAAO,CAAC,GAAG,CAAC,CAAC,wDAAwD,EAAE,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC;AACjK,IAAI;AACJ;;;;;;;;;;"}

package/dist/plugin.js

@@ -2,25 +2,78 @@ var capacitorHttpLocalServer = (function (exports, core) {
     'use strict';
 
     /**
-     * Registramos el plugin.
-     * El nombre 'HttpLocalServer' debe coincidir con el @CapacitorPlugin en Java
-     * y el @objc(HttpLocalServerPlugin) en Swift.
+     * Plugin de servidor HTTP local para Android e iOS.
+     *
+     * Permite crear un servidor HTTP en el dispositivo que puede recibir
+     * peticiones desde otros dispositivos en la misma red.
+     *
+     * @example
+     * ```typescript
+     * import { HttpLocalServer } from '@cappitolian/http-local-server';
+     *
+     * // Iniciar servidor
+     * const { ip, port } = await HttpLocalServer.connect();
+     * console.log(`Servidor en http://${ip}:${port}`);
+     *
+     * // Escuchar peticiones
+     * await HttpLocalServer.addListener('onRequest', async (data) => {
+     *   console.log('Petición recibida:', data);
+     *
+     *   // Procesar y responder
+     *   await HttpLocalServer.sendResponse({
+     *     requestId: data.requestId,
+     *     body: JSON.stringify({ success: true })
+     *   });
+     * });
+     * ```
      */
     const HttpLocalServer = core.registerPlugin('HttpLocalServer', {
         web: () => Promise.resolve().then(function () { return web; }).then(m => new m.HttpLocalServerWeb()),
     });
 
+    /**
+     * Implementación web del plugin HttpLocalServer.
+     * Proporciona funcionalidad mock para desarrollo en navegador.
+     */
     class HttpLocalServerWeb extends core.WebPlugin {
+        constructor() {
+            super(...arguments);
+            this.isRunning = false;
+        }
         async connect() {
-            console.warn('HttpLocalServer: El servidor nativo no se puede iniciar en el navegador.');
-            // Devolvemos un valor por defecto para no romper la ejecución en web
-            return { ip: '127.0.0.1', port: 8080 };
+            if (this.isRunning) {
+                console.warn('HttpLocalServer: El servidor ya está ejecutándose (Mock).');
+                return { ip: '127.0.0.1', port: 8080 };
+            }
+            console.warn('HttpLocalServer: El servidor nativo no está disponible en navegador. ' +
+                'Retornando valores mock para desarrollo.');
+            this.isRunning = true;
+            return {
+                ip: '127.0.0.1',
+                port: 8080
+            };
         }
         async disconnect() {
+            if (!this.isRunning) {
+                console.log('HttpLocalServer: El servidor ya está detenido (Mock).');
+                return;
+            }
             console.log('HttpLocalServer: Servidor detenido (Mock).');
+            this.isRunning = false;
         }
         async sendResponse(options) {
-            console.log('HttpLocalServer: Respuesta mock enviada al requestId:', options.requestId);
+            if (!this.isRunning) {
+                console.warn('HttpLocalServer: El servidor no está ejecutándose (Mock).');
+                return;
+            }
+            const { requestId, body } = options;
+            if (!requestId) {
+                throw new Error('Missing requestId');
+            }
+            if (!body) {
+                throw new Error('Missing body');
+            }
+            console.log(`HttpLocalServer: Respuesta mock enviada para requestId: ${requestId}`, '\nBody:', body.substring(0, 100) + (body.length > 100 ? '...' : ''));
         }
     }
 

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\n/**\n * Registramos el plugin.\n * El nombre 'HttpLocalServer' debe coincidir con el @CapacitorPlugin en Java\n * y el @objc(HttpLocalServerPlugin) en Swift.\n */\nconst HttpLocalServer = registerPlugin('HttpLocalServer', {\n    web: () => import('./web').then(m => new m.HttpLocalServerWeb()),\n});\n// Exportamos las interfaces para que el usuario pueda tipar sus variables\nexport * from './definitions';\n// Exportamos el objeto del plugin\nexport { HttpLocalServer };\n// Exportación por defecto opcional para mayor compatibilidad\nexport default HttpLocalServer;\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class HttpLocalServerWeb extends WebPlugin {\n    async connect() {\n        console.warn('HttpLocalServer: El servidor nativo no se puede iniciar en el navegador.');\n        // Devolvemos un valor por defecto para no romper la ejecución en web\n        return { ip: '127.0.0.1', port: 8080 };\n    }\n    async disconnect() {\n        console.log('HttpLocalServer: Servidor detenido (Mock).');\n    }\n    async sendResponse(options) {\n        console.log('HttpLocalServer: Respuesta mock enviada al requestId:', options.requestId);\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;IACA;IACA;IACA;IACA;IACA;AACK,UAAC,eAAe,GAAGA,mBAAc,CAAC,iBAAiB,EAAE;IAC1D,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,kBAAkB,EAAE,CAAC;IACpE,CAAC;;ICPM,MAAM,kBAAkB,SAASC,cAAS,CAAC;IAClD,IAAI,MAAM,OAAO,GAAG;IACpB,QAAQ,OAAO,CAAC,IAAI,CAAC,0EAA0E,CAAC;IAChG;IACA,QAAQ,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE;IAC9C,IAAI;IACJ,IAAI,MAAM,UAAU,GAAG;IACvB,QAAQ,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC;IACjE,IAAI;IACJ,IAAI,MAAM,YAAY,CAAC,OAAO,EAAE;IAChC,QAAQ,OAAO,CAAC,GAAG,CAAC,uDAAuD,EAAE,OAAO,CAAC,SAAS,CAAC;IAC/F,IAAI;IACJ;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\n/**\n * Plugin de servidor HTTP local para Android e iOS.\n *\n * Permite crear un servidor HTTP en el dispositivo que puede recibir\n * peticiones desde otros dispositivos en la misma red.\n *\n * @example\n * ```typescript\n * import { HttpLocalServer } from '@cappitolian/http-local-server';\n *\n * // Iniciar servidor\n * const { ip, port } = await HttpLocalServer.connect();\n * console.log(`Servidor en http://${ip}:${port}`);\n *\n * // Escuchar peticiones\n * await HttpLocalServer.addListener('onRequest', async (data) => {\n *   console.log('Petición recibida:', data);\n *\n *   // Procesar y responder\n *   await HttpLocalServer.sendResponse({\n *     requestId: data.requestId,\n *     body: JSON.stringify({ success: true })\n *   });\n * });\n * ```\n */\nconst HttpLocalServer = registerPlugin('HttpLocalServer', {\n    web: () => import('./web').then(m => new m.HttpLocalServerWeb()),\n});\nexport * from './definitions';\nexport { HttpLocalServer };\nexport default HttpLocalServer;\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\n/**\n * Implementación web del plugin HttpLocalServer.\n * Proporciona funcionalidad mock para desarrollo en navegador.\n */\nexport class HttpLocalServerWeb extends WebPlugin {\n    constructor() {\n        super(...arguments);\n        this.isRunning = false;\n    }\n    async connect() {\n        if (this.isRunning) {\n            console.warn('HttpLocalServer: El servidor ya está ejecutándose (Mock).');\n            return { ip: '127.0.0.1', port: 8080 };\n        }\n        console.warn('HttpLocalServer: El servidor nativo no está disponible en navegador. ' +\n            'Retornando valores mock para desarrollo.');\n        this.isRunning = true;\n        return {\n            ip: '127.0.0.1',\n            port: 8080\n        };\n    }\n    async disconnect() {\n        if (!this.isRunning) {\n            console.log('HttpLocalServer: El servidor ya está detenido (Mock).');\n            return;\n        }\n        console.log('HttpLocalServer: Servidor detenido (Mock).');\n        this.isRunning = false;\n    }\n    async sendResponse(options) {\n        if (!this.isRunning) {\n            console.warn('HttpLocalServer: El servidor no está ejecutándose (Mock).');\n            return;\n        }\n        const { requestId, body } = options;\n        if (!requestId) {\n            throw new Error('Missing requestId');\n        }\n        if (!body) {\n            throw new Error('Missing body');\n        }\n        console.log(`HttpLocalServer: Respuesta mock enviada para requestId: ${requestId}`, '\\nBody:', body.substring(0, 100) + (body.length > 100 ? '...' : ''));\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;AACK,UAAC,eAAe,GAAGA,mBAAc,CAAC,iBAAiB,EAAE;IAC1D,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,kBAAkB,EAAE,CAAC;IACpE,CAAC;;IC5BD;IACA;IACA;IACA;IACO,MAAM,kBAAkB,SAASC,cAAS,CAAC;IAClD,IAAI,WAAW,GAAG;IAClB,QAAQ,KAAK,CAAC,GAAG,SAAS,CAAC;IAC3B,QAAQ,IAAI,CAAC,SAAS,GAAG,KAAK;IAC9B,IAAI;IACJ,IAAI,MAAM,OAAO,GAAG;IACpB,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE;IAC5B,YAAY,OAAO,CAAC,IAAI,CAAC,2DAA2D,CAAC;IACrF,YAAY,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE;IAClD,QAAQ;IACR,QAAQ,OAAO,CAAC,IAAI,CAAC,uEAAuE;IAC5F,YAAY,0CAA0C,CAAC;IACvD,QAAQ,IAAI,CAAC,SAAS,GAAG,IAAI;IAC7B,QAAQ,OAAO;IACf,YAAY,EAAE,EAAE,WAAW;IAC3B,YAAY,IAAI,EAAE;IAClB,SAAS;IACT,IAAI;IACJ,IAAI,MAAM,UAAU,GAAG;IACvB,QAAQ,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;IAC7B,YAAY,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC;IAChF,YAAY;IACZ,QAAQ;IACR,QAAQ,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC;IACjE,QAAQ,IAAI,CAAC,SAAS,GAAG,KAAK;IAC9B,IAAI;IACJ,IAAI,MAAM,YAAY,CAAC,OAAO,EAAE;IAChC,QAAQ,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;IAC7B,YAAY,OAAO,CAAC,IAAI,CAAC,2DAA2D,CAAC;IACrF,YAAY;IACZ,QAAQ;IACR,QAAQ,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO;IAC3C,QAAQ,IAAI,CAAC,SAAS,EAAE;IACxB,YAAY,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC;IAChD,QAAQ;IACR,QAAQ,IAAI,CAAC,IAAI,EAAE;IACnB,YAAY,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC;IAC3C,QAAQ;IACR,QAAQ,OAAO,CAAC,GAAG,CAAC,CAAC,wDAAwD,EAAE,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC;IACjK,IAAI;IACJ;;;;;;;;;;;;;;;;;;"}

package/ios/Sources/HttpLocalServerPlugin/HttpLocalServer.swift

@@ -27,6 +27,7 @@ public protocol HttpLocalServerDelegate: AnyObject {
 
 // MARK: - HttpLocalServer
 @objc public class HttpLocalServer: NSObject {
+    
     // MARK: - Properties
     private var webServer: GCDWebServer?
     private weak var delegate: HttpLocalServerDelegate?
@@ -194,7 +195,8 @@ public protocol HttpLocalServerDelegate: AnyObject {
             "path": path
         ]
         
-        if let body = body {
+        // Solo agregar si existen (consistente con TypeScript y Android)
+        if let body = body, !body.isEmpty {
             requestData["body"] = body
         }
         

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cappitolian/http-local-server",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "description": "Runs a local HTTP server on your device, accessible over LAN. Supports connect, disconnect, GET, and POST methods with IP and port discovery.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",