@utilia-os/sdk-js 1.1.0 → 1.4.0

package/README.md

@@ -2,13 +2,13 @@
 
 SDK JavaScript/TypeScript para integrar aplicaciones externas con UTILIA OS.
 
-## Instalacion
+## Instalación
 
 ```bash
 npm install @utilia-os/sdk-js
 ```
 
-## Configuracion
+## Configuración
 
 ```typescript
 import { UtiliaSDK } from '@utilia-os/sdk-js';
@@ -29,7 +29,7 @@ Antes de crear tickets, identifica al usuario en tu sistema:
 
 ```typescript
 const user = await sdk.users.identify({
-  externalId: 'user-123',           // ID unico en tu sistema (requerido)
+  externalId: 'user-123',           // ID único en tu sistema (requerido)
   email: 'user@example.com',        // opcional
   name: 'Juan Perez',               // opcional
   avatarUrl: 'https://...',         // opcional
@@ -49,10 +49,10 @@ const ticket = await sdk.tickets.create({
     email: 'user@example.com',
     name: 'Juan Perez',
   },
-  title: 'Problema con la facturacion',
+  title: 'Problema con la facturación',
   description: 'No puedo ver mis facturas del mes pasado...',
   category: 'PROBLEMA',  // CONSULTA | PROBLEMA | SUGERENCIA | OTRO
-  priority: 'MEDIA',     // BAJA | MEDIA | ALTA | CRITICA
+  priority: 'MEDIA',     // BAJA | MEDIA | ALTA | CRÍTICA
   context: {             // opcional
     url: window.location.href,
     appVersion: '1.2.3',
@@ -104,7 +104,7 @@ await sdk.tickets.close('ticket-uuid', 'user-123');
 await sdk.tickets.reopen('ticket-uuid', 'user-123');
 ```
 
-### Obtener Mensajes No Leidos
+### Obtener Mensajes No Leídos
 
 ```typescript
 const { count } = await sdk.tickets.getUnreadCount('user-123');
@@ -113,6 +113,50 @@ if (count > 0) {
 }
 ```
 
+### Reportar Error
+
+```typescript
+const result = await sdk.errors.report({
+  message: 'Error al procesar pago',
+  module: 'payment-processor',
+  severity: 'critical',
+  stack: error.stack,
+  endpoint: '/api/payments',
+  method: 'POST',
+  context: {
+    gatewayId: 'stripe',
+    orderId: 'order-456',
+  },
+});
+
+console.log(result.hash);          // Hash único del error
+console.log(result.deduplicated);   // true si el error ya existía
+```
+
+### Listar Errores
+
+```typescript
+const result = await sdk.errors.list({
+  severity: ['critical', 'high'],
+  resolved: false,
+  limit: 20,
+});
+
+console.log(result.errors);
+console.log(result.pagination.total);
+```
+
+### Estadísticas de Errores
+
+```typescript
+const stats = await sdk.errors.stats();
+
+console.log(stats.total);        // Total de errores
+console.log(stats.unresolved);   // Errores sin resolver
+console.log(stats.bySeverity);   // { critical: 5, high: 10, ... }
+console.log(stats.byModule);     // { auth: 3, payments: 7, ... }
+```
+
 ## Manejo de Errores
 
 ```typescript
@@ -124,13 +168,13 @@ try {
   if (error instanceof UtiliaSDKError) {
     switch (error.code) {
       case ErrorCode.UNAUTHORIZED:
-        console.error('API Key invalida');
+        console.error('API Key inválida');
         break;
       case ErrorCode.RATE_LIMITED:
         console.error('Demasiadas peticiones, espera antes de reintentar');
         break;
       case ErrorCode.VALIDATION_ERROR:
-        console.error('Datos invalidos:', error.message);
+        console.error('Datos inválidos:', error.message);
         break;
       case ErrorCode.NOT_FOUND:
         console.error('Recurso no encontrado');
@@ -141,7 +185,7 @@ try {
 
     // Verificar si se puede reintentar
     if (error.isRetryable()) {
-      // Implementar logica de reintento
+      // Implementar lógica de reintento
     }
   }
 }
@@ -153,7 +197,7 @@ El SDK exporta todos los tipos TypeScript necesarios:
 
 ```typescript
 import type {
-  // Configuracion
+  // Configuración
   UtiliaSDKConfig,
 
   // Tickets
@@ -169,6 +213,13 @@ import type {
   IdentifyUserInput,
   ExternalUser,
 
+  // Errores del sistema
+  ReportErrorInput,
+  ReportedError,
+  SystemError,
+  ErrorFilters,
+  ErrorStats,
+
   // Comunes
   TicketStatus,
   TicketCategory,