react-native-qalink 0.4.0 → 0.5.0

package/README.md

@@ -1,351 +1,483 @@
 # react-native-qalink 🔍
 
-SDK de captura de errores en tiempo real para React Native. Se instala en la app y transmite al servidor QALink cada request de red, error JS, log de consola y error del runtime — permitiendo al equipo de QA ver en tiempo real si un bug es del **frontend** o del **backend**, sin necesidad de Android Studio ni logs técnicos.
+SDK de captura de errores en tiempo real para React Native. Captura errores, logs, eventos custom, requests HTTP y screenshots — permitiendo al equipo de QA ver en tiempo real qué está pasando en la app, sin necesidad de Android Studio ni logs técnicos.
+
+La conexión WebSocket apunta siempre a **wss://ws.airbites.org**.
 
 ---
 
-## ¿Cómo identifica los requests a la API?
+## 📦 Instalación
 
-La librería usa **dos estrategias de interceptación simultáneas**:
+```bash
+npm install react-native-qalink
+# o
+yarn add react-native-qalink
+```
 
-### 1. Monkey-patch de `fetch` global
-Al llamar `QALink.init()`, la librería reemplaza el `fetch` nativo del entorno JavaScript por su propia versión instrumentada. Cualquier llamada a `fetch(...)` en toda la app pasa primero por QALink, que registra el request y la respuesta antes de devolver el control al código original.
+### Dependencia opcional para capturas de pantalla:
 
+```bash
+npm install react-native-view-shot
+cd ios && pod install
 ```
-Tu código          →   fetch('/api/users')
-                            ↓
-QALink intercepta  →   registra método, URL, tiempo de inicio
-                            ↓
-Ejecuta fetch real →   espera respuesta del servidor
-                            ↓
-QALink registra    →   status code, body, duración, clasificación
-                            ↓
-Devuelve al código →   response (sin modificarla)
-```
-
-### 2. Interceptores de Axios
-Axios expone un sistema oficial de interceptores (`.interceptors.request` y `.interceptors.response`). QALink se engancha en ambos para capturar cada request antes de que salga y cada respuesta antes de que llegue al código de la app. Funciona con la instancia global y con instancias personalizadas.
 
 ---
 
-## ¿Cómo captura los logs de Metro y el runtime de React Native?
+## 🚀 Inicio rápido
 
-Hay tres capas adicionales que se activan automáticamente con `init()`:
+```typescript
+import QALink from 'react-native-qalink';
 
-### 3. Monkey-patch de `console`
-QALink reemplaza `console.log`, `console.warn` y `console.error` con versiones instrumentadas. **Metro sigue mostrando todo normalmente** (se llama al original primero), pero cada mensaje se envía también al dashboard. Los mensajes se clasifican automáticamente:
+// 1. Inicializar el SDK
+QALink.init({
+  apiKey: 'qlk_your_api_key_here',
+  appVersion: '1.0.0',
+  environment: 'dev',
+  debug: true,
+});
 
+// 2. Configurar contexto de usuario
+QALink.setUserContext({
+  userId: '12345',
+  email: 'user@example.com',
+  plan: 'premium'
+});
+
+// 3. Configurar contexto custom
+QALink.setCustomContext({
+  experimentVariant: 'new_checkout_flow',
+  featureFlags: { darkMode: true }
+});
+
+// 4. Usar los nuevos métodos de logging
+QALink.debug('User opened settings');
+QALink.info('Payment initiated', { amount: 99.99 });
+QALink.warn('Slow API response', { duration: 3500 });
+QALink.error('Payment failed', { code: 'CARD_DECLINED' });
+QALink.critical('App about to crash');
+
+// 5. Eventos custom
+QALink.logEvent('checkout_completed', {
+  items: 3,
+  totalAmount: 299.99,
+  paymentMethod: 'credit_card'
+});
+
+// 6. Captura de pantalla (requiere react-native-view-shot)
+await QALink.captureScreen('before_payment');
 ```
-console.log('Productos cargados', data)      →  🔵 user_log
-console.warn('componentWillMount deprecated') →  🟡 rn_warning
-console.error('Invariant Violation: ...')     →  🔴 rn_error
-console.error('Unable to resolve module')     →  🔴 rn_error (Metro)
-```
 
-### 4. `ErrorUtils.setGlobalHandler` — Pantalla roja (Red Screen)
-React Native expone `ErrorUtils` para capturar errores **antes** de que la app crashee y muestre la pantalla roja. QALink se registra ahí para enviar el error al dashboard con todo el stack trace, y luego llama al handler original para que RN siga comportándose normalmente.
+---
+
+## 🔧 Configuración HTTP avanzada
 
+El SDK captura automáticamente todas las peticiones HTTP (fetch y axios). Puedes configurar qué capturar:
+
+```typescript
+QALink.init({
+  apiKey: 'qlk_xxx',
+  appVersion: '1.0.0',
+  httpConfig: {
+    // Captura requests y responses
+    captureRequests: true,
+    captureResponses: true,
+    
+    // Filtrar por URL
+    includeUrls: ['/api/payment', '/api/checkout'],
+    excludeUrls: ['/api/analytics', '/health'],
+    
+    // Filtrar por método HTTP
+    methods: ['POST', 'PUT', 'DELETE'], // ignorar GETs
+    
+    // Sanitización de datos sensibles
+    sanitizeHeaders: ['Authorization', 'X-API-Key'],
+    sanitizeRequestBody: ['password', 'creditCard', 'cvv'],
+    sanitizeResponseBody: ['token', 'secret'],
+    
+    // Capturar solo errores HTTP (4xx, 5xx)
+    captureOnlyErrors: true,
+    minStatusCode: 400,
+    
+    // Límite de tamaño de body
+    maxBodySize: 5000, // bytes
+    
+    // Performance monitoring
+    captureTimings: true,
+    slowRequestThreshold: 2000, // marcar requests > 2s como lentos
+  }
+});
 ```
-Error fatal en JS
-       ↓
-QALink captura → envía al dashboard con stack trace completo
-       ↓
-ErrorUtils original → React Native muestra la pantalla roja
+
+### Actualizar configuración HTTP en runtime:
+
+```typescript
+QALink.configureHTTP({
+  captureOnlyErrors: true,
+  slowRequestThreshold: 1000
+});
 ```
 
-### 5. LogBox — Cajas amarillas (Yellow Box)
-En React Native ≥ 0.64, los warnings se manejan internamente via `LogBox`. QALink se engancha al método interno `__warn` de LogBox para capturar cada warning antes de que aparezca en pantalla.
+---
+
+## 📝 API de Logging
+
+Todos los métodos de logging hacen **console.log nativo** (visible en Metro) **Y** envían al servidor QALink:
+
+```typescript
+// Acepta múltiples argumentos como console.log
+QALink.debug('User action', { screen: 'Settings' }, 'Extra data');
+
+QALink.info('API call started', {
+  endpoint: '/api/users',
+  method: 'GET'
+});
+
+QALink.warn('Memory warning', { 
+  available: '50MB',
+  threshold: '100MB' 
+});
+
+QALink.error('Validation failed', {
+  field: 'email',
+  reason: 'Invalid format'
+});
 
-### Clasificación de errores de runtime
+QALink.critical('Unrecoverable error', {
+  code: 'FATAL_001',
+  message: 'Cannot connect to database'
+});
+```
 
-| Tipo                     | Categoría       | Ejemplo                                      |
-|--------------------------|----------------|----------------------------------------------|
-| Error fatal              | `red_screen`   | `Invariant Violation`, `undefined is not...` |
-| Warning de RN            | `yellow_box`   | `componentWillMount is deprecated`           |
-| Módulo nativo            | `native_module`| `NativeModule X is null`                     |
-| Bridge JS↔Native         | `bridge`       | `RCTBridge error`                            |
-| Promise sin .catch()     | `unknown`      | `Unhandled Promise Rejection`                |
-| Error de Metro/bundler   | `rn_error`     | `Unable to resolve module`, `SyntaxError`    |
+**Niveles de log:**
+- `debug` → desarrollo y debugging
+- `info` → información general
+- `warn` → advertencias y problemas no críticos
+- `error` → errores recuperables
+- `critical` → errores fatales que pueden causar crash
 
 ---
 
-## Instalación
+## 🎯 Eventos Custom
 
-```bash
-npm install react-native-qalink
-# o
-yarn add react-native-qalink
+Registra eventos de negocio importantes:
+
+```typescript
+// Evento simple
+QALink.logEvent('user_login');
+
+// Evento con datos
+QALink.logEvent('purchase_completed', {
+  productId: 'SKU-123',
+  price: 29.99,
+  currency: 'USD',
+  quantity: 2
+});
+
+QALink.logEvent('feature_used', {
+  featureName: 'dark_mode',
+  enabled: true,
+  timestamp: Date.now()
+});
 ```
 
+**Los eventos incluyen automáticamente:**
+- User context (userId, email, etc.)
+- Custom context (feature flags, experiments)
+- Screen actual
+- Session ID
+- Device ID
+- Timestamp
+
 ---
 
-## Ejemplos de uso
+## 👤 Context API
 
-### Ejemplo 1 — Setup básico con captura de consola
+### User Context
+Información del usuario que se adjunta a **todos** los eventos:
 
-```tsx
-// App.tsx
-import { useEffect } from 'react';
-import { QALink } from 'react-native-qalink';
-import axios from 'axios';
+```typescript
+QALink.setUserContext({
+  userId: '12345',
+  email: 'john@example.com',
+  username: 'john_doe',
+  plan: 'premium',
+  region: 'LATAM'
+});
 
-export default function App() {
-  useEffect(() => {
-    QALink.init({
-      serverUrl: 'wss://qalink-server-production.up.railway.app',
-      apiKey: 'qlk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
-      appVersion: '1.2.3',
-      captureRuntimeErrors: true,   // pantalla roja, yellow box
-      console: {
-        captureLogs: true,           // console.log
-        captureWarnings: true,       // console.warn
-        captureErrors: true,         // console.error + errores de Metro
-      },
-      debug: __DEV__,
-    });
-
-    QALink.interceptAxios(axios);
-  }, []);
-
-  return <RootNavigator />;
-}
+// Actualizar parcialmente
+QALink.setUserContext({ plan: 'enterprise' });
+
+// Limpiar
+QALink.clearContext();
+```
+
+### Custom Context
+Datos custom que se adjuntan a todos los eventos:
+
+```typescript
+QALink.setCustomContext({
+  experimentVariant: 'new_ui_v2',
+  featureFlags: {
+    darkMode: true,
+    newCheckout: false
+  },
+  build: 'staging-142'
+});
 ```
 
 ---
 
-### Ejemplo 2 — Filtrar logs muy verbosos de librerías
+## 📸 Captura de Pantalla
+
+**Requisito:** `react-native-view-shot`
+
+```typescript
+// Capturar pantalla completa
+await QALink.captureScreen('before_payment');
+await QALink.captureScreen('error_state');
 
-Si usas librerías que loguean mucho (react-query, redux, etc.), puedes filtrarlas
-para que el dashboard no se llene de ruido.
+// Capturar componente específico
+import { useRef } from 'react';
 
-```tsx
+const MyComponent = () => {
+  const viewRef = useRef(null);
+  
+  const handleCapture = async () => {
+    await QALink.captureRef(viewRef, 'form_error');
+  };
+  
+  return (
+    <View ref={viewRef}>
+      {/* contenido */}
+    </View>
+  );
+};
+```
+
+**Configuración:**
+
+```typescript
 QALink.init({
-  serverUrl: 'wss://qalink-server-production.up.railway.app',
-  apiKey: 'qlk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
-  appVersion: '1.2.3',
-  console: {
-    captureLogs: true,
-    captureWarnings: true,
-    captureErrors: true,
-    // Ignorar logs de estas librerías
-    ignorePatterns: [
-      '[react-query]',
-      '[redux]',
-      'Reanimated',
-      'Gesture Handler',
-      '[MMKV]',
-    ],
-  },
+  apiKey: 'qlk_xxx',
+  appVersion: '1.0.0',
+  enableScreenCapture: true, // ← activar
+});
+```
+
+---
+
+## 🔌 Interceptores HTTP
+
+### Fetch (automático)
+El SDK intercepta **todos** los `fetch()` automáticamente. No necesitas hacer nada.
+
+### Axios
+Si usas Axios, puedes interceptar instancias específicas:
+
+```typescript
+import axios from 'axios';
+import QALink from 'react-native-qalink';
+
+const apiClient = axios.create({
+  baseURL: 'https://api.example.com'
 });
+
+// Interceptar esta instancia de Axios
+QALink.interceptAxios(apiClient);
 ```
 
 ---
 
-### Ejemplo 3 — Capturar solo logs relevantes para QA
+## 🛠️ Configuración completa
 
-Si quieres que el QA vea únicamente los logs que tú marcas explícitamente:
+```typescript
+import QALink from 'react-native-qalink';
 
-```tsx
 QALink.init({
-  serverUrl: 'ws://192.168.1.100:3000',
-  apiKey: 'qlk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
+  // ── Requerido ──────────────────────────────────
+  apiKey: 'qlk_your_64_char_hex_key',
   appVersion: '1.2.3',
+
+  // ── Básico ─────────────────────────────────────
+  enabled: true,              // habilitar/deshabilitar SDK
+  environment: 'dev',         // 'dev' | 'prod'
+  debug: true,                // logs de debug en consola
+
+  // ── HTTP Interceptors ──────────────────────────
+  httpConfig: {
+    captureRequests: true,
+    captureResponses: true,
+    includeUrls: ['/api/'],
+    excludeUrls: ['/health', '/metrics'],
+    methods: ['POST', 'PUT', 'DELETE'],
+    sanitizeHeaders: ['Authorization'],
+    sanitizeRequestBody: ['password', 'token', 'creditCard'],
+    sanitizeResponseBody: ['secret', 'apiKey'],
+    captureOnlyErrors: false,
+    minStatusCode: 200,
+    maxBodySize: 5000,
+    captureTimings: true,
+    slowRequestThreshold: 2000,
+  },
+
+  // ── Legacy Network (compatibilidad) ────────────
+  logNetworkBodies: false,
+  sensitiveHeaders: ['Authorization'],
+  sensitiveUrlPatterns: ['/auth/', '/login'],
+  sensitiveBodyFields: ['password', 'token'],
+
+  // ── Console ─────────────────────────────────────
   console: {
     captureLogs: true,
     captureWarnings: true,
     captureErrors: true,
-    // Solo capturar logs que contengan estas palabras
-    includePatterns: ['[QA]', '[FLOW]', '[ERROR]'],
+    ignorePatterns: ['Ignore this'],
+    includePatterns: [],
   },
-});
-
-// En tu código, prefija los logs importantes:
-console.log('[QA] Usuario llegó al checkout', { userId, cartTotal });
-console.log('[FLOW] Pago procesado', { orderId });
-console.error('[ERROR] Falló validación', { campo, valor });
-```
-
----
 
-### Ejemplo 4 — App con múltiples instancias de Axios
+  // ── Errors ──────────────────────────────────────
+  captureRuntimeErrors: true,  // red screen / yellow box
+  captureMetroErrors: true,    // bundler errors
 
-```tsx
-// services/api.ts
-export const apiPrincipal = axios.create({ baseURL: 'https://api.miapp.com/v1' });
-export const apiPagos = axios.create({ baseURL: 'https://pagos.miapp.com' });
+  // ── Screen Capture ──────────────────────────────
+  enableScreenCapture: true,   // requiere react-native-view-shot
 
-// App.tsx
-await QALink.init({
-  serverUrl: 'ws://192.168.1.100:3000',
-  apiKey: 'qlk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
-  appVersion: '1.2.3',
+  // ── Callbacks ───────────────────────────────────
+  onEvent: (event) => {
+    console.log('Event sent:', event.type);
+  }
 });
-
-QALink.interceptAxios(apiPrincipal);
-QALink.interceptAxios(apiPagos);
-// fetch nativo ya se intercepta automáticamente con init()
 ```
 
 ---
 
-### Ejemplo 5 — Integración con React Navigation
-
-```tsx
-<NavigationContainer
-  ref={navigationRef}
-  onStateChange={() => {
-    const routeName = navigationRef.current?.getCurrentRoute()?.name ?? '';
-    QALink.setScreen(routeName);
-    // Genera automáticamente: breadcrumb "NAVIGATE → CheckoutScreen"
-  }}
->
-```
+## 📊 Tipos de eventos capturados
+
+El SDK captura automáticamente:
+
+| Tipo | Descripción |
+|------|-------------|
+| `session_start` | Inicio de sesión |
+| `http_request` | Request HTTP (fetch/axios) |
+| `user_log` | Logs con debug/info/warn/error/critical |
+| `custom_event` | Eventos custom con logEvent() |
+| `console_log` | console.log |
+| `console_warn` | console.warn |
+| `console_error` | console.error |
+| `runtime_error` | Red screen / Yellow box |
+| `metro_error` | Errores de Metro Bundler |
+| `js_error` | Errores de JavaScript |
+| `breadcrumb` | Navegación y acciones |
+| `screen_capture` | Screenshots |
 
 ---
 
-### Ejemplo 6 — Breadcrumbs en acciones críticas
+## 🔐 Compatibilidad con fetch-blob
 
-Los breadcrumbs + logs de consola juntos dan la línea de tiempo completa al QA:
+El interceptor de fetch es **100% compatible** con `fetch-blob`:
 
-```tsx
-const handleConfirmarCompra = async () => {
-  QALink.addBreadcrumb('TAP → Confirmar Compra', {
-    cartId: cart.id,
-    items: cart.items.length,
-    total: cart.total,
-  });
+```typescript
+import { fetch, Blob } from 'react-native-fetch-blob';
 
-  console.log('[QA] Iniciando checkout', { cartId: cart.id });
+// QALink detecta automáticamente Blobs y no intenta serializarlos
+const blob = new Blob([...], { type: 'image/jpeg' });
 
-  try {
-    const result = await apiPagos.post('/checkout', { cartId: cart.id });
-    console.log('[QA] Checkout exitoso', { orderId: result.data.orderId });
-  } catch (error) {
-    // QALink ya capturó el error de red automáticamente
-    // console.error aquí también se envía al dashboard
-    console.error('[QA] Checkout falló', error);
-  }
-};
-```
+await fetch('https://api.example.com/upload', {
+  method: 'POST',
+  body: blob
+});
 
-El QA verá en el dashboard esta línea de tiempo completa:
-```
-14:33:40  NAVIGATE → CheckoutScreen
-14:33:55  TAP → Confirmar Compra  { cartId: "abc", items: 3, total: 150 }
-14:33:55  🔵 [QA] Iniciando checkout { cartId: "abc" }
-14:33:55  ❌ POST /checkout → 500   🔴 ERROR DE BACKEND
-14:33:55  🔴 [QA] Checkout falló    Error: Internal Server Error
+// En el dashboard verás:
+// body: { _type: 'Blob', size: 12345, type: 'image/jpeg' }
 ```
 
 ---
 
-### Ejemplo 7 — Configuración para build de QA (sin exponer en producción)
-
-```tsx
-// config/qalink.ts
-import Config from 'react-native-config';
-
-export async function initQALink() {
-  if (Config.QALINK_ENABLED !== 'true') return;
-
-  await QALink.init({
-    serverUrl: Config.QALINK_SERVER,
-    apiKey: Config.QALINK_API_KEY,
-    appVersion: Config.VERSION_NAME ?? '0.0.0',
-    logNetworkBodies: true,
-    captureRuntimeErrors: true,
-    console: {
-      captureLogs: true,
-      captureWarnings: true,
-      captureErrors: true,
-      ignorePatterns: ['[react-query]'],
-    },
-    sensitiveHeaders: ['Authorization'],
-    sensitiveUrlPatterns: ['/auth/refresh'],
-  });
+## 🎯 Casos de uso
+
+### 1. Tracking de flujo de checkout
+```typescript
+QALink.setUserContext({ userId: user.id, email: user.email });
+
+QALink.logEvent('checkout_started', { cartTotal: 299.99 });
+QALink.info('Loading payment methods');
 
-  QALink.interceptAxios(axios);
+// ... usuario selecciona método de pago ...
+QALink.logEvent('payment_method_selected', { method: 'credit_card' });
+
+try {
+  const response = await processPayment();
+  QALink.logEvent('payment_success', { 
+    orderId: response.orderId,
+    amount: 299.99 
+  });
+} catch (error) {
+  QALink.error('Payment failed', { 
+    reason: error.message,
+    code: error.code 
+  });
+  await QALink.captureScreen('payment_error');
 }
 ```
 
----
+### 2. Debugging de API lenta
+```typescript
+QALink.configureHTTP({
+  captureTimings: true,
+  slowRequestThreshold: 1500, // 1.5s
+});
 
-### Ejemplo 8 — Verificar estado de conexión
+// Los requests > 1.5s aparecerán marcados en el dashboard
+```
 
-```tsx
-function QAStatusBadge() {
-  if (QALink.getStatus() !== 'connected') return null;
+### 3. Tracking de experimentos A/B
+```typescript
+const variant = getExperimentVariant('new_ui');
 
-  return (
-    <View style={styles.badge}>
-      <Text>🔴 QALink grabando</Text>
-    </View>
-  );
-}
+QALink.setCustomContext({
+  experiment: 'new_ui',
+  variant: variant, // 'A' or 'B'
+});
+
+QALink.logEvent('experiment_viewed', { 
+  experiment: 'new_ui',
+  variant 
+});
 ```
 
 ---
 
-## Qué ve el QA en el dashboard
+## 🚨 Troubleshooting
 
-Cada sesión incluye una línea de tiempo unificada con todos los eventos:
+### Los logs no aparecen en el dashboard
+- Verifica que `apiKey` sea correcto (formato: `qlk_<64 hex>`)
+- Verifica que `enabled: true`
+- Revisa la consola: `QALink.getStatus()` debe ser `'connected'`
 
-| Ícono | Tipo              | Fuente              |
-|-------|-------------------|---------------------|
-| ✅    | Request exitoso   | fetch / axios       |
-| ❌    | Error de red      | fetch / axios       |
-| 🔴    | Error fatal (RN)  | ErrorUtils / LogBox |
-| 🟡    | Warning (RN)      | LogBox / console    |
-| 🔵    | Log de consola    | console.log         |
-| 📍    | Breadcrumb        | QALink.addBreadcrumb|
-| 📱    | Pantalla          | QALink.setScreen    |
+### Screen capture no funciona
+- Instala: `npm install react-native-view-shot`
+- Habilita: `enableScreenCapture: true` en config
+- iOS: `cd ios && pod install`
+
+### Axios no se intercepta
+- Llama `QALink.interceptAxios(axiosInstance)` **después** de `QALink.init()`
 
 ---
 
-## Configuración completa
+## 📖 Recursos
 
-```ts
-QALink.init({
-  // — Requeridos —
-  serverUrl: 'ws://192.168.1.100:3000',
-  apiKey: 'qlk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
-  appVersion: '1.0.0',
+- **Dashboard:** https://qalink.airbites.org
+- **Documentación completa:** (próximamente)
+- **GitHub:** (próximamente)
 
-  // — Red —
-  logNetworkBodies: false,
-  sensitiveHeaders: ['Authorization'],
-  sensitiveUrlPatterns: ['/auth/refresh'],
+---
 
-  // — Runtime de React Native —
-  captureRuntimeErrors: true,  // pantalla roja, yellow box, promises
+## 📄 Licencia
 
-  // — Consola y Metro —
-  console: {
-    captureLogs: true,
-    captureWarnings: true,
-    captureErrors: true,
-    ignorePatterns: ['[redux]'],    // patrones a ignorar
-    includePatterns: [],            // si se define, solo captura estos
-  },
-
-  // — General —
-  enabled: true,
-  debug: false,
-  onEvent: (event) => {
-    console.log(event.type, event);
-  },
-});
-```
+MIT
 
 ---
 
-## API completa
+## 🤝 Contribuir
 
-| Método                          | Descripción                                               |
-|---------------------------------|-----------------------------------------------------------|
-| `QALink.init(config)`           | Inicializa el SDK, intercepta fetch, consola y runtime    |
-| `QALink.interceptAxios(instance)`| Registra una instancia de axios                          |
-| `QALink.setScreen(name)`        | Registra la pantalla actual (genera breadcrumb)           |
-| `QALink.addBreadcrumb(action, data?)` | Registra una acción del usuario                     |
-| `QALink.getStatus()`            | Estado de la conexión WS                                  |
-| `QALink.destroy()`              | Limpia interceptores y desconecta                         |
+Pull requests son bienvenidos. Para cambios mayores, abre primero un issue.