@utilia-os/sdk-js 1.4.0 → 1.5.0

package/README.md

@@ -113,6 +113,28 @@ if (count > 0) {
 }
 ```
 
+### Actualizaciones en Tiempo Real (SSE)
+
+Recibe notificaciones cuando un agente responde, cambia el estado, resuelve o cierra un ticket:
+
+```typescript
+const stream = sdk.tickets.streamUpdates('user-123', {
+  onTicketUpdated: (event) => {
+    console.log(`Ticket ${event.ticketKey} actualizado: ${event.type}`);
+    // event.type: 'comment-added' | 'status-changed'
+    // Refrescar la UI del ticket
+  },
+  onError: (error) => {
+    console.error('Error en conexion SSE:', error);
+  },
+});
+
+// Para cerrar la conexion cuando ya no se necesite:
+stream.close();
+```
+
+> **Nota:** En Node.js se requiere un polyfill como `eventsource` (`npm install eventsource`).
+
 ### Reportar Error
 
 ```typescript

package/dist/index.d.mts

@@ -688,6 +688,40 @@ declare class TicketsService {
      * ```
      */
     addMessage(ticketId: string, userId: string, data: AddMessageInput): Promise<CreatedMessage>;
+    /**
+     * Suscribirse a actualizaciones de tickets en tiempo real via SSE.
+     * Recibe eventos cuando un agente responde, cambia el estado, resuelve o cierra un ticket.
+     *
+     * Requiere un entorno con EventSource nativo (navegador) o un polyfill como 'eventsource'.
+     *
+     * @param userId - ID externo del usuario (opcional, filtra eventos por usuario)
+     * @param options - Callbacks para eventos y errores
+     * @returns Objeto con metodo close() para cerrar la conexion
+     *
+     * @example
+     * ```typescript
+     * const stream = sdk.tickets.streamUpdates('user-123', {
+     *   onTicketUpdated: (event) => {
+     *     console.log(`Ticket ${event.ticketKey} actualizado: ${event.type}`);
+     *     // Refrescar la UI del ticket
+     *   },
+     * });
+     *
+     * // Para cerrar la conexion:
+     * stream.close();
+     * ```
+     */
+    streamUpdates(userId?: string, options?: {
+        onTicketUpdated?: (event: {
+            ticketId: string;
+            ticketKey: string;
+            type: string;
+            externalUserId?: string;
+        }) => void;
+        onError?: (error: Error) => void;
+    }): {
+        close: () => void;
+    };
     /**
      * Cerrar un ticket
      * Solo el usuario que creo el ticket puede cerrarlo

package/dist/index.d.ts

@@ -688,6 +688,40 @@ declare class TicketsService {
      * ```
      */
     addMessage(ticketId: string, userId: string, data: AddMessageInput): Promise<CreatedMessage>;
+    /**
+     * Suscribirse a actualizaciones de tickets en tiempo real via SSE.
+     * Recibe eventos cuando un agente responde, cambia el estado, resuelve o cierra un ticket.
+     *
+     * Requiere un entorno con EventSource nativo (navegador) o un polyfill como 'eventsource'.
+     *
+     * @param userId - ID externo del usuario (opcional, filtra eventos por usuario)
+     * @param options - Callbacks para eventos y errores
+     * @returns Objeto con metodo close() para cerrar la conexion
+     *
+     * @example
+     * ```typescript
+     * const stream = sdk.tickets.streamUpdates('user-123', {
+     *   onTicketUpdated: (event) => {
+     *     console.log(`Ticket ${event.ticketKey} actualizado: ${event.type}`);
+     *     // Refrescar la UI del ticket
+     *   },
+     * });
+     *
+     * // Para cerrar la conexion:
+     * stream.close();
+     * ```
+     */
+    streamUpdates(userId?: string, options?: {
+        onTicketUpdated?: (event: {
+            ticketId: string;
+            ticketKey: string;
+            type: string;
+            externalUserId?: string;
+        }) => void;
+        onError?: (error: Error) => void;
+    }): {
+        close: () => void;
+    };
     /**
      * Cerrar un ticket
      * Solo el usuario que creo el ticket puede cerrarlo

package/dist/index.js

@@ -635,6 +635,54 @@ var TicketsService = class {
       { params: { userId } }
     );
   }
+  /**
+   * Suscribirse a actualizaciones de tickets en tiempo real via SSE.
+   * Recibe eventos cuando un agente responde, cambia el estado, resuelve o cierra un ticket.
+   *
+   * Requiere un entorno con EventSource nativo (navegador) o un polyfill como 'eventsource'.
+   *
+   * @param userId - ID externo del usuario (opcional, filtra eventos por usuario)
+   * @param options - Callbacks para eventos y errores
+   * @returns Objeto con metodo close() para cerrar la conexion
+   *
+   * @example
+   * ```typescript
+   * const stream = sdk.tickets.streamUpdates('user-123', {
+   *   onTicketUpdated: (event) => {
+   *     console.log(`Ticket ${event.ticketKey} actualizado: ${event.type}`);
+   *     // Refrescar la UI del ticket
+   *   },
+   * });
+   *
+   * // Para cerrar la conexion:
+   * stream.close();
+   * ```
+   */
+  streamUpdates(userId, options) {
+    if (typeof EventSource === "undefined") {
+      throw new Error(
+        'EventSource no esta disponible en este entorno. Para Node.js, instala un polyfill como "eventsource" y asignalo a globalThis.EventSource.'
+      );
+    }
+    const queryParams = userId ? `?userId=${encodeURIComponent(userId)}` : "";
+    const sseUrl = this.client.buildSseUrl(`${this.basePath}/events${queryParams}`);
+    const eventSource = new EventSource(sseUrl);
+    eventSource.onmessage = (event) => {
+      try {
+        const data = JSON.parse(event.data);
+        if (data.event === "ticket-updated" && options?.onTicketUpdated) {
+          options.onTicketUpdated(data);
+        }
+      } catch {
+      }
+    };
+    eventSource.onerror = () => {
+      options?.onError?.(new Error("Error en la conexion SSE"));
+    };
+    return {
+      close: () => eventSource.close()
+    };
+  }
   /**
    * Cerrar un ticket
    * Solo el usuario que creo el ticket puede cerrarlo

package/dist/index.mjs

@@ -596,6 +596,54 @@ var TicketsService = class {
       { params: { userId } }
     );
   }
+  /**
+   * Suscribirse a actualizaciones de tickets en tiempo real via SSE.
+   * Recibe eventos cuando un agente responde, cambia el estado, resuelve o cierra un ticket.
+   *
+   * Requiere un entorno con EventSource nativo (navegador) o un polyfill como 'eventsource'.
+   *
+   * @param userId - ID externo del usuario (opcional, filtra eventos por usuario)
+   * @param options - Callbacks para eventos y errores
+   * @returns Objeto con metodo close() para cerrar la conexion
+   *
+   * @example
+   * ```typescript
+   * const stream = sdk.tickets.streamUpdates('user-123', {
+   *   onTicketUpdated: (event) => {
+   *     console.log(`Ticket ${event.ticketKey} actualizado: ${event.type}`);
+   *     // Refrescar la UI del ticket
+   *   },
+   * });
+   *
+   * // Para cerrar la conexion:
+   * stream.close();
+   * ```
+   */
+  streamUpdates(userId, options) {
+    if (typeof EventSource === "undefined") {
+      throw new Error(
+        'EventSource no esta disponible en este entorno. Para Node.js, instala un polyfill como "eventsource" y asignalo a globalThis.EventSource.'
+      );
+    }
+    const queryParams = userId ? `?userId=${encodeURIComponent(userId)}` : "";
+    const sseUrl = this.client.buildSseUrl(`${this.basePath}/events${queryParams}`);
+    const eventSource = new EventSource(sseUrl);
+    eventSource.onmessage = (event) => {
+      try {
+        const data = JSON.parse(event.data);
+        if (data.event === "ticket-updated" && options?.onTicketUpdated) {
+          options.onTicketUpdated(data);
+        }
+      } catch {
+      }
+    };
+    eventSource.onerror = () => {
+      options?.onError?.(new Error("Error en la conexion SSE"));
+    };
+    return {
+      close: () => eventSource.close()
+    };
+  }
   /**
    * Cerrar un ticket
    * Solo el usuario que creo el ticket puede cerrarlo

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utilia-os/sdk-js",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "SDK JavaScript/TypeScript para UTILIA OS External Integrations",
   "main": "dist/index.js",
   "module": "dist/index.mjs",