@bereasoftware/nexa 1.4.0 → 1.4.1

package/README.en.md

@@ -954,9 +954,11 @@ manager.register(rateLimitPlugin);
 
 ---
 
-## Dev Overlay
-
-Built-in visual development tool for debugging and monitoring HTTP requests in real-time.
+## Dev Overlay
+
+Built-in visual development tool for debugging and monitoring HTTP requests in real-time.
+
+> API status: publicly available and intended for browser development flows. It is not designed for SSR or Node runtimes without a DOM.
 
 ```typescript
 import { createHttpClient, createDevOverlay } from "@bereasoftware/nexa";
@@ -1007,8 +1009,10 @@ createDevOverlay(config?: DevOverlayConfig): { tracker: RequestTracker; ui: DevO
 **Behavior notes:**
 
 - `createDevOverlay()` is a singleton. Multiple calls reuse the same instance.
+- The overlay only mounts UI when a DOM is available. In SSR or Node you can import the module safely, but no panel is rendered.
 - `theme` is typed as `'dark' | 'light'`, but the current UI is primarily designed for dark mode.
 - The retry button uses direct `fetch()` for quick revalidation; it does not automatically replay interceptors or advanced `HttpClient` configuration.
+- `destroyDevOverlay()` clears the singleton instance, removes the panel, and unregisters the global listeners used by the overlay.
 
 **Note:** Advanced request options such as `transformRequest`, `credentials`, `withCredentials`, `debug`, `logger`, `transport`, `nodeOptions`, and `autoFormData` are already typed, but not all of them are fully wired into the main `HttpClient` pipeline in this release.
 
@@ -1034,6 +1038,13 @@ getDevOverlay() // Get current { tracker, ui } or null if not created yet
 destroyDevOverlay() // Destroy the current singleton instance
 ```
 
+**When to use each export:**
+
+- `createDevOverlay()` creates or reuses the overlay and returns the `tracker` you pass into `createHttpClient({ devTracker })`.
+- `getDevOverlay()` lets you inspect the current instance without creating a new one.
+- `destroyDevOverlay()` is useful for full teardown during hot reloads, tests, or manual cleanup.
+- `RequestTracker` can be used on its own if you want request history and metrics without mounting the UI.
+
 **Exposed data shapes:**
 
 ```typescript

package/README.md

@@ -1291,9 +1291,11 @@ manager.register(rateLimitPlugin);
 
 ---
 
-## Dev Overlay
-
-Herramienta visual de desarrollo integrada para depurar y monitorear requests HTTP en tiempo real.
+## Dev Overlay
+
+Herramienta visual de desarrollo integrada para depurar y monitorear requests HTTP en tiempo real.
+
+> Estado de API: disponible públicamente y pensada para flujos de desarrollo en navegador. No está orientada a entornos SSR o Node sin DOM.
 
 ```typescript
 import { createHttpClient, createDevOverlay } from "@bereasoftware/nexa";
@@ -1344,8 +1346,10 @@ createDevOverlay(config?: DevOverlayConfig): { tracker: RequestTracker; ui: DevO
 **Notas de comportamiento:**
 
 - `createDevOverlay()` es singleton. Si lo llamas varias veces, reutiliza la misma instancia.
+- El overlay solo monta UI cuando hay DOM disponible. En SSR o Node puedes importar el módulo sin romper el proceso, pero no se renderiza panel.
 - `theme` está tipado como `'dark' | 'light'`, pero la UI actual está diseñada principalmente para tema oscuro.
 - El botón de retry del panel usa `fetch()` directo para revalidación rápida; no reaplica automáticamente interceptores ni configuración avanzada del `HttpClient`.
+- `destroyDevOverlay()` limpia la instancia singleton, desmonta el panel y remueve listeners globales registrados por el overlay.
 
 **Métodos del UI:**
 
@@ -1369,6 +1373,13 @@ getDevOverlay() // Obtener { tracker, ui } actuales o null si no existen
 destroyDevOverlay() // Destruir la instancia singleton actual
 ```
 
+**Cuándo usar cada export:**
+
+- `createDevOverlay()` crea o reutiliza el overlay y devuelve el `tracker` que debes pasar a `createHttpClient({ devTracker })`.
+- `getDevOverlay()` te permite consultar la instancia actual sin crear una nueva.
+- `destroyDevOverlay()` sirve para cerrar completamente la herramienta en hot reloads, tests o limpieza manual.
+- `RequestTracker` puede usarse por separado si quieres recolectar historial y métricas sin montar la UI.
+
 **Estructuras expuestas:**
 
 ```typescript

package/dist/nexa.es.js

@@ -1,4 +1,4 @@
-/*! Nexa v1.4.0 | (c) 2026 Berea-Soft | MIT License | https://github.com/Berea-Soft/Nexa */
+/*! Nexa v1.4.1 | (c) 2026 Berea-Soft | MIT License | https://github.com/Berea-Soft/Nexa */
 //#region src/types/index.ts
 var e = (e) => ({
 	ok: !0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bereasoftware/nexa",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "type": "module",
   "main": "./dist/nexa.cjs.js",
   "module": "./dist/nexa.es.js",