@trii/components 3.1.12 → 3.1.13

package/dist/index.d.ts

@@ -572,6 +572,23 @@ declare class PanelErrorBoundary extends Component<PanelErrorBoundaryProps, Pane
     render(): ReactNode;
 }
 
+/**
+ * Contrato de entrada del sidebar (docs/CONTRATO_CHATDETAILSSIDEBAR.md).
+ * El container del host resuelve estos valores desde Redux; el árbol interno
+ * los consume desde acá en lugar de tocar el store del host. Al migrar el
+ * sidebar a @trii/components, este context viaja con él tal cual.
+ */
+interface SidebarApiConfig {
+    /** Raíz de la API (ej: https://agent-api.trii.app/api/v1), sin servicio ni spaceId. */
+    baseUrl: string;
+    spaceId: string;
+}
+/** When supplied, the host owns loading and supplies the entity through props. */
+interface SidebarEntityLoad {
+    status: 'idle' | 'loading' | 'succeeded' | 'rejected';
+    error?: string | null;
+    retry: () => Promise<void> | void;
+}
 /**
  * Integración con un inbox de chat. Es opcional: sin ella el sidebar funciona
  * en "modo ficha" (sin GroupData, sin abrir conversaciones, sin iniciar una
@@ -591,6 +608,53 @@ interface SidebarChatIntegration {
     /** El usuario salió del grupo: el host cierra/limpia la conversación. */
     onGroupLeft: (conversationId: string) => void;
 }
+interface SidebarProps {
+    api: SidebarApiConfig;
+    contactId: string | null;
+    entityType: 'contact' | 'business';
+    /**
+     * false cuando el host no pasó `chat`: los callbacks de abajo son no-ops y la
+     * UI que depende del inbox se deshabilita.
+     */
+    hasChatIntegration: boolean;
+    /**
+     * Ficha ya resuelta por el host, si la tiene: solo siembra el estado inicial
+     * para que no parpadee. Con entityLoad es la entidad controlada; sin él se refetchea.
+     */
+    initialEntity?: IContact | IBusiness | null;
+    entityLoad?: SidebarEntityLoad;
+    /** Conversación seleccionada en el host, si hay (tab conversaciones, GroupData). */
+    conversation: IConversation | null;
+    /** Para el EditContactModal embebido (búsqueda de direcciones). */
+    googleMapsApiKey?: string;
+    /**
+     * Navegación del anfitrión. Sin ella se usa window.location.assign: los
+     * destinos son rutas de otro microfront, no internas del sidebar.
+     */
+    navigate?: (path: string) => void;
+    /** Ticket que se está viendo en el host: el tab Tickets lo lista marcado y sin click. */
+    currentTicketId?: string;
+    /**
+     * Abrir un ticket del contacto. Sin ella el tab Tickets navega a
+     * /a/tickets/detail/{id} con `navigate` (o window.location.assign).
+     */
+    onOpenTicket?: (ticketId: string) => void;
+    /** Abrir/cambiar a una conversación del contacto en el inbox. */
+    onOpenConversation: (conversation: IConversation) => Promise<void> | void;
+    /** Navegar/scrollear a un mensaje en el body del chat. */
+    onNavigateToMessage: (messageId: string) => void;
+    /**
+     * El contacto/empresa cambió (edición, convert, etc.): el host sincroniza su
+     * estado. Es no-op si el host no la pasó.
+     */
+    onEntityUpdated: (entity: IContact | IBusiness) => void;
+    /** La conversación cambió (grupo WA editado): el host sincroniza Redux + Dexie. */
+    onConversationUpdated: (conversation: IConversation) => void;
+    /** El usuario salió del grupo: el host cierra/limpia la conversación. */
+    onGroupLeft: (conversationId: string) => void;
+    /** "Chatear por este canal/dirección": arma el composer del host. */
+    onStartConversation: (target: StartConversationTarget) => void;
+}
 interface StartConversationTarget {
     channelType: ChannelType;
     addressId: string;
@@ -599,6 +663,8 @@ interface StartConversationTarget {
 }
 
 interface ChatDetailsSidebarBaseProps {
+    /** Controlled loading: entity/initialEntity updates are consumed without an automatic fetch. */
+    entityLoad?: SidebarProps['entityLoad'];
     /** Raíz de la API (ej: https://agent-api.trii.app/api/v1), sin servicio ni spaceId. */
     baseUrl: string;
     spaceId: string;

package/dist/types/components/ContactSidebar/ChatDetailsSidebar.d.ts

@@ -1,6 +1,8 @@
-import { SidebarChatIntegration, StartConversationTarget } from './context/SidebarPropsContext';
+import { SidebarChatIntegration, SidebarProps, StartConversationTarget } from './context/SidebarPropsContext';
 import { IContact, IBusiness } from '@trii/types/dist/Contacts';
 interface ChatDetailsSidebarBaseProps {
+    /** Controlled loading: entity/initialEntity updates are consumed without an automatic fetch. */
+    entityLoad?: SidebarProps['entityLoad'];
     /** Raíz de la API (ej: https://agent-api.trii.app/api/v1), sin servicio ni spaceId. */
     baseUrl: string;
     spaceId: string;

package/dist/types/components/ContactSidebar/context/SidebarEntityContext.d.ts

@@ -5,6 +5,7 @@ import { IBusiness, IContact } from '@trii/types/dist/Contacts';
  * (contactInfo, showSkeleton, contactInfoError, onRetryContactInfo); ahora el
  * sidebar la fetchea con el contactId + entityType del contrato. El host puede
  * sembrarla con initialEntity para que no haya parpadeo cuando ya la tiene.
+ * Con entityLoad, el host controla la ficha, su carga y los reintentos.
  */
 export type EntityStatus = 'idle' | 'loading' | 'succeeded' | 'rejected';
 export interface SidebarEntityValue {

package/dist/types/components/ContactSidebar/context/SidebarPropsContext.d.ts

@@ -13,6 +13,12 @@ export interface SidebarApiConfig {
     baseUrl: string;
     spaceId: string;
 }
+/** When supplied, the host owns loading and supplies the entity through props. */
+export interface SidebarEntityLoad {
+    status: 'idle' | 'loading' | 'succeeded' | 'rejected';
+    error?: string | null;
+    retry: () => Promise<void> | void;
+}
 /**
  * Integración con un inbox de chat. Es opcional: sin ella el sidebar funciona
  * en "modo ficha" (sin GroupData, sin abrir conversaciones, sin iniciar una
@@ -43,9 +49,10 @@ export interface SidebarProps {
     hasChatIntegration: boolean;
     /**
      * Ficha ya resuelta por el host, si la tiene: solo siembra el estado inicial
-     * para que no parpadee. El sidebar la fetchea igual (SidebarEntityContext).
+     * para que no parpadee. Con entityLoad es la entidad controlada; sin él se refetchea.
      */
     initialEntity?: IContact | IBusiness | null;
+    entityLoad?: SidebarEntityLoad;
     /** Conversación seleccionada en el host, si hay (tab conversaciones, GroupData). */
     conversation: IConversation | null;
     /** Para el EditContactModal embebido (búsqueda de direcciones). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trii/components",
-  "version": "3.1.12",
+  "version": "3.1.13",
   "description": "Trii components package",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",