@utilia-os/sdk-js 1.0.0 → 1.1.0

package/dist/index.d.mts

@@ -310,6 +310,13 @@ interface TicketMessage {
     attachments: TicketAttachment[];
     createdAt: string;
 }
+/**
+ * Datos del usuario que reporto el ticket
+ */
+interface TicketReporter {
+    name: string;
+    email?: string;
+}
 /**
  * Detalle completo de un ticket
  */
@@ -327,6 +334,10 @@ interface TicketDetail {
     messages: TicketMessage[];
     /** Archivos adjuntos del ticket original */
     attachments: TicketAttachment[];
+    /** Contexto capturado al crear el ticket */
+    context?: TicketContext | null;
+    /** Datos del usuario que reporto el ticket */
+    reporter?: TicketReporter | null;
 }
 /**
  * Respuesta al crear un mensaje
@@ -580,7 +591,19 @@ interface AiSuggestInput {
         description?: string;
         category?: string;
         priority?: string;
+        /** URL actual donde se reporta el problema */
+        currentUrl?: string;
+        /** User agent del navegador */
+        userAgent?: string;
+        /** Version de la aplicacion */
+        appVersion?: string;
     };
+    /** Imagenes adjuntas para analisis con vision (base64, max 5) */
+    images?: Array<{
+        base64: string;
+        filename: string;
+        mimeType: string;
+    }>;
 }
 /**
  * Sugerencias generadas por IA
@@ -609,6 +632,8 @@ interface AiJobStatus {
         transcription?: string;
         /** Sugerencias generadas */
         suggestions?: AiSuggestions;
+        /** ID del evento de analytics para tracking de aceptacion/rechazo */
+        analyticsEventId?: string;
     };
     /** Mensaje de error (si status es 'failed') */
     error?: string;
@@ -616,6 +641,29 @@ interface AiJobStatus {
 /**
  * Opciones para el metodo getSuggestions con polling
  */
+/**
+ * Acciones del usuario sobre sugerencias de IA
+ */
+type AiUserAction = 'ACCEPTED_ALL' | 'ACCEPTED_PARTIAL' | 'REJECTED' | 'MODIFIED' | 'IGNORED';
+/**
+ * Entrada para reportar la accion del usuario sobre sugerencias de IA
+ */
+interface TrackAiActionInput {
+    /** ID del evento de analytics retornado en el resultado de sugerencias */
+    eventId: string;
+    /** Accion tomada por el usuario */
+    userAction: AiUserAction;
+    /** Campos que el usuario acepto */
+    fieldsAccepted?: string[];
+    /** Campos que el usuario modifico */
+    fieldsModified?: string[];
+    /** Campos que el usuario rechazo */
+    fieldsRejected?: string[];
+    /** Tiempo en milisegundos desde que se mostraron las sugerencias hasta la decision */
+    timeToDecisionMs?: number;
+    /** Origen de la accion */
+    source?: 'SDK_EXTERNAL' | 'WIDGET';
+}
 interface GetSuggestionsOptions {
     /** Intervalo de polling en ms (default: 1000) */
     pollInterval?: number;
@@ -720,6 +768,32 @@ declare class AiService {
      * ```
      */
     getSuggestions(data: AiSuggestInput, options?: GetSuggestionsOptions): Promise<AiJobStatus['result']>;
+    /**
+     * Reporta la accion del usuario sobre sugerencias de IA.
+     * Permite trackear si el usuario acepto, rechazo o modifico las sugerencias.
+     *
+     * @param data - Datos de la accion del usuario
+     * @returns Confirmacion de que la accion fue registrada
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.ai.getSuggestions({
+     *   userId: 'user-123',
+     *   text: 'No puedo iniciar sesion',
+     * });
+     *
+     * // El usuario revisa las sugerencias y acepta todas
+     * await sdk.ai.trackAiAction({
+     *   eventId: result?.analyticsEventId!,
+     *   userAction: 'ACCEPTED_ALL',
+     *   fieldsAccepted: ['title', 'description', 'category', 'priority'],
+     *   timeToDecisionMs: 3500,
+     * });
+     * ```
+     */
+    trackAiAction(data: TrackAiActionInput): Promise<{
+        success: boolean;
+    }>;
     /**
      * Helper para esperar un tiempo
      */
@@ -869,4 +943,4 @@ declare class UtiliaSDK {
     constructor(config: UtiliaSDKConfig);
 }
 
-export { type AddMessageInput, type AiJobStatus, type AiSuggestInput, type AiSuggestions, type CreateTicketInput, type CreateTicketUser, type CreatedMessage, type CreatedTicket, ErrorCode, type ExternalUser, type FileQuota, type GetSuggestionsOptions, type IdentifyUserInput, type MessageAuthor, type PaginatedResponse, type PaginationMeta, type RequestConfig, SDK_LIMITS, type TicketAttachment, type TicketCategory, type TicketContext, type TicketDetail, type TicketFilters, type TicketListItem, type TicketMessage, type TicketPriority, type TicketStatus, type UnreadCount, type UploadFileOptions, type UploadedFile, UtiliaSDK, type UtiliaSDKConfig, UtiliaSDKError };
+export { type AddMessageInput, type AiJobStatus, type AiSuggestInput, type AiSuggestions, type AiUserAction, type CreateTicketInput, type CreateTicketUser, type CreatedMessage, type CreatedTicket, ErrorCode, type ExternalUser, type FileQuota, type GetSuggestionsOptions, type IdentifyUserInput, type MessageAuthor, type PaginatedResponse, type PaginationMeta, type RequestConfig, SDK_LIMITS, type TicketAttachment, type TicketCategory, type TicketContext, type TicketDetail, type TicketFilters, type TicketListItem, type TicketMessage, type TicketPriority, type TicketReporter, type TicketStatus, type TrackAiActionInput, type UnreadCount, type UploadFileOptions, type UploadedFile, UtiliaSDK, type UtiliaSDKConfig, UtiliaSDKError };

package/dist/index.d.ts

@@ -310,6 +310,13 @@ interface TicketMessage {
     attachments: TicketAttachment[];
     createdAt: string;
 }
+/**
+ * Datos del usuario que reporto el ticket
+ */
+interface TicketReporter {
+    name: string;
+    email?: string;
+}
 /**
  * Detalle completo de un ticket
  */
@@ -327,6 +334,10 @@ interface TicketDetail {
     messages: TicketMessage[];
     /** Archivos adjuntos del ticket original */
     attachments: TicketAttachment[];
+    /** Contexto capturado al crear el ticket */
+    context?: TicketContext | null;
+    /** Datos del usuario que reporto el ticket */
+    reporter?: TicketReporter | null;
 }
 /**
  * Respuesta al crear un mensaje
@@ -580,7 +591,19 @@ interface AiSuggestInput {
         description?: string;
         category?: string;
         priority?: string;
+        /** URL actual donde se reporta el problema */
+        currentUrl?: string;
+        /** User agent del navegador */
+        userAgent?: string;
+        /** Version de la aplicacion */
+        appVersion?: string;
     };
+    /** Imagenes adjuntas para analisis con vision (base64, max 5) */
+    images?: Array<{
+        base64: string;
+        filename: string;
+        mimeType: string;
+    }>;
 }
 /**
  * Sugerencias generadas por IA
@@ -609,6 +632,8 @@ interface AiJobStatus {
         transcription?: string;
         /** Sugerencias generadas */
         suggestions?: AiSuggestions;
+        /** ID del evento de analytics para tracking de aceptacion/rechazo */
+        analyticsEventId?: string;
     };
     /** Mensaje de error (si status es 'failed') */
     error?: string;
@@ -616,6 +641,29 @@ interface AiJobStatus {
 /**
  * Opciones para el metodo getSuggestions con polling
  */
+/**
+ * Acciones del usuario sobre sugerencias de IA
+ */
+type AiUserAction = 'ACCEPTED_ALL' | 'ACCEPTED_PARTIAL' | 'REJECTED' | 'MODIFIED' | 'IGNORED';
+/**
+ * Entrada para reportar la accion del usuario sobre sugerencias de IA
+ */
+interface TrackAiActionInput {
+    /** ID del evento de analytics retornado en el resultado de sugerencias */
+    eventId: string;
+    /** Accion tomada por el usuario */
+    userAction: AiUserAction;
+    /** Campos que el usuario acepto */
+    fieldsAccepted?: string[];
+    /** Campos que el usuario modifico */
+    fieldsModified?: string[];
+    /** Campos que el usuario rechazo */
+    fieldsRejected?: string[];
+    /** Tiempo en milisegundos desde que se mostraron las sugerencias hasta la decision */
+    timeToDecisionMs?: number;
+    /** Origen de la accion */
+    source?: 'SDK_EXTERNAL' | 'WIDGET';
+}
 interface GetSuggestionsOptions {
     /** Intervalo de polling en ms (default: 1000) */
     pollInterval?: number;
@@ -720,6 +768,32 @@ declare class AiService {
      * ```
      */
     getSuggestions(data: AiSuggestInput, options?: GetSuggestionsOptions): Promise<AiJobStatus['result']>;
+    /**
+     * Reporta la accion del usuario sobre sugerencias de IA.
+     * Permite trackear si el usuario acepto, rechazo o modifico las sugerencias.
+     *
+     * @param data - Datos de la accion del usuario
+     * @returns Confirmacion de que la accion fue registrada
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.ai.getSuggestions({
+     *   userId: 'user-123',
+     *   text: 'No puedo iniciar sesion',
+     * });
+     *
+     * // El usuario revisa las sugerencias y acepta todas
+     * await sdk.ai.trackAiAction({
+     *   eventId: result?.analyticsEventId!,
+     *   userAction: 'ACCEPTED_ALL',
+     *   fieldsAccepted: ['title', 'description', 'category', 'priority'],
+     *   timeToDecisionMs: 3500,
+     * });
+     * ```
+     */
+    trackAiAction(data: TrackAiActionInput): Promise<{
+        success: boolean;
+    }>;
     /**
      * Helper para esperar un tiempo
      */
@@ -869,4 +943,4 @@ declare class UtiliaSDK {
     constructor(config: UtiliaSDKConfig);
 }
 
-export { type AddMessageInput, type AiJobStatus, type AiSuggestInput, type AiSuggestions, type CreateTicketInput, type CreateTicketUser, type CreatedMessage, type CreatedTicket, ErrorCode, type ExternalUser, type FileQuota, type GetSuggestionsOptions, type IdentifyUserInput, type MessageAuthor, type PaginatedResponse, type PaginationMeta, type RequestConfig, SDK_LIMITS, type TicketAttachment, type TicketCategory, type TicketContext, type TicketDetail, type TicketFilters, type TicketListItem, type TicketMessage, type TicketPriority, type TicketStatus, type UnreadCount, type UploadFileOptions, type UploadedFile, UtiliaSDK, type UtiliaSDKConfig, UtiliaSDKError };
+export { type AddMessageInput, type AiJobStatus, type AiSuggestInput, type AiSuggestions, type AiUserAction, type CreateTicketInput, type CreateTicketUser, type CreatedMessage, type CreatedTicket, ErrorCode, type ExternalUser, type FileQuota, type GetSuggestionsOptions, type IdentifyUserInput, type MessageAuthor, type PaginatedResponse, type PaginationMeta, type RequestConfig, SDK_LIMITS, type TicketAttachment, type TicketCategory, type TicketContext, type TicketDetail, type TicketFilters, type TicketListItem, type TicketMessage, type TicketPriority, type TicketReporter, type TicketStatus, type TrackAiActionInput, type UnreadCount, type UploadFileOptions, type UploadedFile, UtiliaSDK, type UtiliaSDKConfig, UtiliaSDKError };

package/dist/index.js

@@ -766,6 +766,32 @@ var AiService = class {
     }
     throw new Error("Timeout: el job excedio el tiempo maximo de espera");
   }
+  /**
+   * Reporta la accion del usuario sobre sugerencias de IA.
+   * Permite trackear si el usuario acepto, rechazo o modifico las sugerencias.
+   *
+   * @param data - Datos de la accion del usuario
+   * @returns Confirmacion de que la accion fue registrada
+   *
+   * @example
+   * ```typescript
+   * const result = await sdk.ai.getSuggestions({
+   *   userId: 'user-123',
+   *   text: 'No puedo iniciar sesion',
+   * });
+   *
+   * // El usuario revisa las sugerencias y acepta todas
+   * await sdk.ai.trackAiAction({
+   *   eventId: result?.analyticsEventId!,
+   *   userAction: 'ACCEPTED_ALL',
+   *   fieldsAccepted: ['title', 'description', 'category', 'priority'],
+   *   timeToDecisionMs: 3500,
+   * });
+   * ```
+   */
+  async trackAiAction(data) {
+    return this.client.post(`${this.basePath}/ai-track-action`, data);
+  }
   /**
    * Helper para esperar un tiempo
    */

package/dist/index.mjs

@@ -727,6 +727,32 @@ var AiService = class {
     }
     throw new Error("Timeout: el job excedio el tiempo maximo de espera");
   }
+  /**
+   * Reporta la accion del usuario sobre sugerencias de IA.
+   * Permite trackear si el usuario acepto, rechazo o modifico las sugerencias.
+   *
+   * @param data - Datos de la accion del usuario
+   * @returns Confirmacion de que la accion fue registrada
+   *
+   * @example
+   * ```typescript
+   * const result = await sdk.ai.getSuggestions({
+   *   userId: 'user-123',
+   *   text: 'No puedo iniciar sesion',
+   * });
+   *
+   * // El usuario revisa las sugerencias y acepta todas
+   * await sdk.ai.trackAiAction({
+   *   eventId: result?.analyticsEventId!,
+   *   userAction: 'ACCEPTED_ALL',
+   *   fieldsAccepted: ['title', 'description', 'category', 'priority'],
+   *   timeToDecisionMs: 3500,
+   * });
+   * ```
+   */
+  async trackAiAction(data) {
+    return this.client.post(`${this.basePath}/ai-track-action`, data);
+  }
   /**
    * Helper para esperar un tiempo
    */

package/package.json

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