react-native-qalink 0.1.0

package/README.md

@@ -0,0 +1,342 @@
+# 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.
+
+---
+
+## ¿Cómo identifica los requests a la API?
+
+La librería usa **dos estrategias de interceptación simultáneas**:
+
+### 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.
+
+```
+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?
+
+Hay tres capas adicionales que se activan automáticamente con `init()`:
+
+### 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:
+
+```
+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.
+
+```
+Error fatal en JS
+       ↓
+QALink captura → envía al dashboard con stack trace completo
+       ↓
+ErrorUtils original → React Native muestra la pantalla roja
+```
+
+### 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.
+
+### Clasificación de errores de runtime
+
+| 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`    |
+
+---
+
+## Instalación
+
+```bash
+npm install react-native-qalink
+# o
+yarn add react-native-qalink
+```
+
+---
+
+## Ejemplos de uso
+
+### Ejemplo 1 — Setup básico con captura de consola
+
+```tsx
+// App.tsx
+import { useEffect } from 'react';
+import { QALink } from 'react-native-qalink';
+import axios from 'axios';
+
+export default function App() {
+  useEffect(() => {
+    QALink.init({
+      serverUrl: 'ws://192.168.1.100:3000',
+      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 />;
+}
+```
+
+---
+
+### Ejemplo 2 — Filtrar logs muy verbosos de librerías
+
+Si usas librerías que loguean mucho (react-query, redux, etc.), puedes filtrarlas
+para que el dashboard no se llene de ruido.
+
+```tsx
+QALink.init({
+  serverUrl: 'ws://192.168.1.100:3000',
+  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]',
+    ],
+  },
+});
+```
+
+---
+
+### Ejemplo 3 — Capturar solo logs relevantes para QA
+
+Si quieres que el QA vea únicamente los logs que tú marcas explícitamente:
+
+```tsx
+QALink.init({
+  serverUrl: 'ws://192.168.1.100:3000',
+  appVersion: '1.2.3',
+  console: {
+    captureLogs: true,
+    captureWarnings: true,
+    captureErrors: true,
+    // Solo capturar logs que contengan estas palabras
+    includePatterns: ['[QA]', '[FLOW]', '[ERROR]'],
+  },
+});
+
+// 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
+
+```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' });
+
+// App.tsx
+await QALink.init({ serverUrl: 'ws://192.168.1.100:3000', appVersion: '1.2.3' });
+
+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"
+  }}
+>
+```
+
+---
+
+### Ejemplo 6 — Breadcrumbs en acciones críticas
+
+Los breadcrumbs + logs de consola juntos dan la línea de tiempo completa al QA:
+
+```tsx
+const handleConfirmarCompra = async () => {
+  QALink.addBreadcrumb('TAP → Confirmar Compra', {
+    cartId: cart.id,
+    items: cart.items.length,
+    total: cart.total,
+  });
+
+  console.log('[QA] Iniciando checkout', { cartId: cart.id });
+
+  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);
+  }
+};
+```
+
+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
+```
+
+---
+
+### 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,
+    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'],
+  });
+
+  QALink.interceptAxios(axios);
+}
+```
+
+---
+
+### Ejemplo 8 — Verificar estado de conexión
+
+```tsx
+function QAStatusBadge() {
+  if (QALink.getStatus() !== 'connected') return null;
+
+  return (
+    <View style={styles.badge}>
+      <Text>🔴 QALink grabando</Text>
+    </View>
+  );
+}
+```
+
+---
+
+## Qué ve el QA en el dashboard
+
+Cada sesión incluye una línea de tiempo unificada con todos los eventos:
+
+| Í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    |
+
+---
+
+## Configuración completa
+
+```ts
+QALink.init({
+  // — Requeridos —
+  serverUrl: 'ws://192.168.1.100:3000',
+  appVersion: '1.0.0',
+
+  // — Red —
+  logNetworkBodies: false,
+  sensitiveHeaders: ['Authorization'],
+  sensitiveUrlPatterns: ['/auth/refresh'],
+
+  // — Runtime de React Native —
+  captureRuntimeErrors: true,  // pantalla roja, yellow box, promises
+
+  // — 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);
+  },
+});
+```
+
+---
+
+## API completa
+
+| 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                         |

package/dist/core/classifier.d.ts

@@ -0,0 +1,9 @@
+import { ErrorSource } from '../types';
+/**
+ * Clasifica el origen del error basado en el status code y contexto.
+ * Esta es la lógica core que le dice al QA quién tiene la culpa.
+ */
+export declare function classifyErrorSource(statusCode?: number, error?: unknown): ErrorSource;
+export declare function getSourceLabel(source: ErrorSource): string;
+export declare function isError(statusCode?: number): boolean;
+//# sourceMappingURL=classifier.d.ts.map

package/dist/core/classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../src/core/classifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,WAAW,CAqBrF;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAS1D;AAED,wBAAgB,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAEpD"}

package/dist/core/classifier.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyErrorSource = classifyErrorSource;
+exports.getSourceLabel = getSourceLabel;
+exports.isError = isError;
+/**
+ * Clasifica el origen del error basado en el status code y contexto.
+ * Esta es la lógica core que le dice al QA quién tiene la culpa.
+ */
+function classifyErrorSource(statusCode, error) {
+    if (!statusCode) {
+        if (error instanceof Error) {
+            const msg = error.message.toLowerCase();
+            if (msg.includes('network') || msg.includes('timeout') || msg.includes('connection')) {
+                return 'NETWORK';
+            }
+        }
+        return 'NETWORK';
+    }
+    if (statusCode >= 200 && statusCode < 300)
+        return 'UNKNOWN';
+    if (statusCode >= 300 && statusCode < 400)
+        return 'BACKEND';
+    if (statusCode === 401 || statusCode === 403)
+        return 'AUTH';
+    if (statusCode === 404)
+        return 'BACKEND';
+    if (statusCode === 422)
+        return 'FRONTEND';
+    if (statusCode === 429)
+        return 'BACKEND';
+    if (statusCode >= 400 && statusCode < 500)
+        return 'FRONTEND';
+    if (statusCode >= 500)
+        return 'BACKEND';
+    return 'UNKNOWN';
+}
+function getSourceLabel(source) {
+    const labels = {
+        BACKEND: '🔴 Error de Backend',
+        FRONTEND: '🟠 Error de Frontend',
+        NETWORK: '🟡 Error de Red/Conectividad',
+        AUTH: '🔐 Error de Autenticación',
+        UNKNOWN: '⚪ Origen desconocido',
+    };
+    return labels[source];
+}
+function isError(statusCode) {
+    return !!statusCode && statusCode >= 400;
+}
+//# sourceMappingURL=classifier.js.map

package/dist/core/classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.js","sourceRoot":"","sources":["../../src/core/classifier.ts"],"names":[],"mappings":";;AAMA,kDAqBC;AAED,wCASC;AAED,0BAEC;AAxCD;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,UAAmB,EAAE,KAAe;IACtE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACxC,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBACrF,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,UAAU,IAAI,GAAG,IAAI,UAAU,GAAG,GAAG;QAAE,OAAO,SAAS,CAAC;IAC5D,IAAI,UAAU,IAAI,GAAG,IAAI,UAAU,GAAG,GAAG;QAAE,OAAO,SAAS,CAAC;IAC5D,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,GAAG;QAAE,OAAO,MAAM,CAAC;IAC5D,IAAI,UAAU,KAAK,GAAG;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,UAAU,KAAK,GAAG;QAAE,OAAO,UAAU,CAAC;IAC1C,IAAI,UAAU,KAAK,GAAG;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,UAAU,IAAI,GAAG,IAAI,UAAU,GAAG,GAAG;QAAE,OAAO,UAAU,CAAC;IAC7D,IAAI,UAAU,IAAI,GAAG;QAAE,OAAO,SAAS,CAAC;IAExC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAgB,cAAc,CAAC,MAAmB;IAChD,MAAM,MAAM,GAAgC;QAC1C,OAAO,EAAE,qBAAqB;QAC9B,QAAQ,EAAE,sBAAsB;QAChC,OAAO,EAAE,8BAA8B;QACvC,IAAI,EAAE,2BAA2B;QACjC,OAAO,EAAE,sBAAsB;KAChC,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC;AAED,SAAgB,OAAO,CAAC,UAAmB;IACzC,OAAO,CAAC,CAAC,UAAU,IAAI,UAAU,IAAI,GAAG,CAAC;AAC3C,CAAC"}

package/dist/core/session.d.ts

@@ -0,0 +1,8 @@
+import { DeviceInfo } from '../types';
+export declare function generateId(): string;
+export declare function getSessionId(): string;
+export declare function resetSession(): string;
+export declare function getDeviceInfo(appVersion: string): Promise<DeviceInfo>;
+export declare function sanitizeHeaders(headers: Record<string, string>, sensitiveHeaders?: string[]): Record<string, string>;
+export declare function sanitizeBody(body: unknown, logBodies: boolean): unknown;
+//# sourceMappingURL=session.d.ts.map

package/dist/core/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAItC,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAKrC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAGrC;AAED,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAsB3E;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,gBAAgB,GAAE,MAAM,EAAO,GAC9B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUxB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAGvE"}

package/dist/core/session.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateId = generateId;
+exports.getSessionId = getSessionId;
+exports.resetSession = resetSession;
+exports.getDeviceInfo = getDeviceInfo;
+exports.sanitizeHeaders = sanitizeHeaders;
+exports.sanitizeBody = sanitizeBody;
+let currentSessionId = null;
+function generateId() {
+    return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+}
+function getSessionId() {
+    if (!currentSessionId) {
+        currentSessionId = generateId();
+    }
+    return currentSessionId;
+}
+function resetSession() {
+    currentSessionId = generateId();
+    return currentSessionId;
+}
+async function getDeviceInfo(appVersion) {
+    var _a, _b, _c, _d;
+    try {
+        const { Platform } = require('react-native');
+        const DeviceInfo = require('react-native-device-info');
+        return {
+            platform: Platform.OS,
+            osVersion: (_b = (_a = Platform.Version) === null || _a === void 0 ? void 0 : _a.toString()) !== null && _b !== void 0 ? _b : 'unknown',
+            appVersion,
+            deviceModel: await DeviceInfo.getModel().catch(() => 'unknown'),
+            buildType: __DEV__ ? 'debug' : 'release',
+        };
+    }
+    catch (_e) {
+        const { Platform } = require('react-native');
+        return {
+            platform: Platform.OS,
+            osVersion: (_d = (_c = Platform.Version) === null || _c === void 0 ? void 0 : _c.toString()) !== null && _d !== void 0 ? _d : 'unknown',
+            appVersion,
+            deviceModel: 'unknown',
+            buildType: __DEV__ ? 'debug' : 'release',
+        };
+    }
+}
+function sanitizeHeaders(headers, sensitiveHeaders = []) {
+    const defaultSensitive = ['authorization', 'x-api-key', 'cookie', 'set-cookie'];
+    const allSensitive = [...defaultSensitive, ...sensitiveHeaders.map(h => h.toLowerCase())];
+    return Object.fromEntries(Object.entries(headers).map(([key, value]) => [
+        key,
+        allSensitive.includes(key.toLowerCase()) ? '[REDACTED]' : value,
+    ]));
+}
+function sanitizeBody(body, logBodies) {
+    if (!logBodies)
+        return '[body omitted - enable logNetworkBodies]';
+    return body;
+}
+//# sourceMappingURL=session.js.map

package/dist/core/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":";;AAIA,gCAEC;AAED,oCAKC;AAED,oCAGC;AAED,sCAsBC;AAED,0CAaC;AAED,oCAGC;AA5DD,IAAI,gBAAgB,GAAkB,IAAI,CAAC;AAE3C,SAAgB,UAAU;IACxB,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACpE,CAAC;AAED,SAAgB,YAAY;IAC1B,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,gBAAgB,GAAG,UAAU,EAAE,CAAC;IAClC,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,SAAgB,YAAY;IAC1B,gBAAgB,GAAG,UAAU,EAAE,CAAC;IAChC,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAEM,KAAK,UAAU,aAAa,CAAC,UAAkB;;IACpD,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;QAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;QAEvD,OAAO;YACL,QAAQ,EAAE,QAAQ,CAAC,EAAuB;YAC1C,SAAS,EAAE,MAAA,MAAA,QAAQ,CAAC,OAAO,0CAAE,QAAQ,EAAE,mCAAI,SAAS;YACpD,UAAU;YACV,WAAW,EAAE,MAAM,UAAU,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;YAC/D,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;SACzC,CAAC;IACJ,CAAC;IAAC,WAAM,CAAC;QACP,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;QAC7C,OAAO;YACL,QAAQ,EAAE,QAAQ,CAAC,EAAuB;YAC1C,SAAS,EAAE,MAAA,MAAA,QAAQ,CAAC,OAAO,0CAAE,QAAQ,EAAE,mCAAI,SAAS;YACpD,UAAU;YACV,WAAW,EAAE,SAAS;YACtB,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;SACzC,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAgB,eAAe,CAC7B,OAA+B,EAC/B,mBAA6B,EAAE;IAE/B,MAAM,gBAAgB,GAAG,CAAC,eAAe,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;IAChF,MAAM,YAAY,GAAG,CAAC,GAAG,gBAAgB,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAE1F,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;QAC5C,GAAG;QACH,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK;KAChE,CAAC,CACH,CAAC;AACJ,CAAC;AAED,SAAgB,YAAY,CAAC,IAAa,EAAE,SAAkB;IAC5D,IAAI,CAAC,SAAS;QAAE,OAAO,0CAA0C,CAAC;IAClE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,58 @@
+import { QALinkConfig } from './types';
+declare class QALinkSDK {
+    private transport;
+    private config;
+    private cleanups;
+    private initialized;
+    private currentScreen;
+    /**
+     * Inicializa el SDK. Llamar al inicio de la app, antes de cualquier request.
+     *
+     * @example
+     * QALink.init({
+     *   serverUrl: 'ws://192.168.1.100:3000',
+     *   appVersion: '1.2.3',
+     *   captureRuntimeErrors: true,
+     *   console: {
+     *     captureLogs: true,
+     *     captureWarnings: true,
+     *     captureErrors: true,
+     *     ignorePatterns: ['[react-query]'],
+     *   },
+     * });
+     */
+    init(config: QALinkConfig): Promise<void>;
+    /**
+     * Registra interceptor para una instancia específica de Axios.
+     *
+     * @example
+     * import axios from 'axios';
+     * QALink.interceptAxios(axios);
+     *
+     * // También con instancias custom:
+     * const api = axios.create({ baseURL: 'https://api.miapp.com' });
+     * QALink.interceptAxios(api);
+     */
+    interceptAxios(axiosInstance: any): void;
+    /**
+     * Registra una acción del usuario (breadcrumb).
+     *
+     * @example
+     * QALink.addBreadcrumb('TAP → Confirmar Compra', { total: 150 });
+     */
+    addBreadcrumb(action: string, data?: Record<string, unknown>): void;
+    /**
+     * Registra la pantalla actual. Llamar en cada cambio de navegación.
+     * Genera automáticamente un breadcrumb de navegación.
+     */
+    setScreen(screenName: string): void;
+    /** Estado actual de la conexión WebSocket */
+    getStatus(): string;
+    /** Limpia todos los interceptores y desconecta. Útil en tests. */
+    destroy(): void;
+    private log;
+}
+export declare const QALink: QALinkSDK;
+export * from './types';
+export { getSourceLabel } from './core/classifier';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAmD,MAAM,SAAS,CAAC;AASxF,cAAM,SAAS;IACb,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAa;IAElC;;;;;;;;;;;;;;;OAeG;IACG,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA0E/C;;;;;;;;;;OAUG;IACH,cAAc,CAAC,aAAa,EAAE,GAAG,GAAG,IAAI;IASxC;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAiBnE;;;OAGG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAMnC,6CAA6C;IAC7C,SAAS,IAAI,MAAM;IAInB,kEAAkE;IAClE,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,GAAG;CAKZ;AAED,eAAO,MAAM,MAAM,WAAkB,CAAC;AAEtC,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}