@trii/components 3.1.12 → 3.1.14

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="react" />
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { IContact, IBusiness, IContactAddress, IIntegrationButton } from '@trii/types/dist/Contacts';
+import { IContact, IBusiness, IContactAddress, IIntegrationButton, IContactField, Property } from '@trii/types/dist/Contacts';
 import { Spaces } from '@trii/types';
 import { SxProps, Theme } from '@mui/material';
 import { IContact as IContact$1, IBusiness as IBusiness$1 } from '@trii/types/dist/Contacts/contacts';
@@ -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;
@@ -710,6 +776,31 @@ declare const DEFAULT_LIGHT_ICON_COLOR = "#334155";
 declare const DEFAULT_DARK_ICON_COLOR = "#e2e8f0";
 declare function resolveButtonIconColor(colors: ButtonIconColors, mode: "light" | "dark"): string | undefined;
 
+interface HighlightedContactFieldsProps {
+    fields: IContactField[];
+    properties: Property[];
+    user?: {
+        dateFormat?: string;
+        timeFormat?: string;
+    } | null;
+    title?: string;
+}
+/** Shared read-only highlights for contact/company records and conversation sidebars. */
+declare function HighlightedContactFields({ fields, properties, user, title, }: HighlightedContactFieldsProps): react_jsx_runtime.JSX.Element;
+
+interface ContactMessageMediaProps {
+    baseUrl: string;
+    spaceId: string;
+    /** Contact ID, not a business ID. Choose a linked contact for business histories. */
+    contactId: string;
+    resolveMediaUrl: (url: string) => Promise<string>;
+    language?: string;
+    dateFormat?: string;
+    timeFormat?: string;
+    height?: number | string;
+}
+declare function ContactMessageMedia(props: ContactMessageMediaProps): react_jsx_runtime.JSX.Element;
+
 declare const i18nInstance: i18next.i18n;
 
 /**
@@ -887,4 +978,4 @@ declare const darkBlue: Theme;
 /** @deprecated Use darkTheme. */
 declare const darkBlack: Theme;
 
-export { AsyncContent, type AsyncContentProps, type AsyncData, type AsyncState, type AsyncStatus, BUTTON_ICONS, BUTTON_ICON_CATEGORIES, type ButtonIconCategory, type ButtonIconColors, type ButtonIconDefinition, type Calendar, type Contact, ContactInfoPopup, ChatDetailsSidebar as ContactSidebar, type ChatDetailsSidebarProps as ContactSidebarProps, DEFAULT_BUTTON_ICON, DEFAULT_DARK_ICON_COLOR, DEFAULT_LIGHT_ICON_COLOR, EditContactModal, type EditContactModalProps, type EditContactMode, EmptyState, type EmptyStateProps, ErrorState, type ErrorStateProps, type EventData, EventsDialog, type EventsDialogProps, IntegrationButtonIcon, type IntegrationButtonIconProps, type IsEmptyFn, type ItemType, type LegacyThemeName, type ModalMode, MuiComponentsConfig, type MuiComponentsConfigOptions, type Notification, PanelErrorBoundary, type PanelErrorBoundaryProps, type ResolvedTheme, type SidebarChatIntegration, type StartConversationTarget, THEME_PREFERENCES, type TaskData, type ThemeName, type ThemePreference, type ThemeRootState, type ThemeState, type UseAsyncDataResult, asyncIdle, asyncRequestFailed, asyncRequestStarted, asyncRequestSucceeded, darkBlack, darkBlue, darkTheme, defaultIsEmpty, deriveAsyncState, findButtonIcon, getErrorMessage, i18nInstance as i18n, isStale, isValidThemeName, lightAmber, lightBlue, lightBlueIndigo, lightBrown, lightGray, lightGreen, lightLime, lightOrange, lightPink, lightPurple, lightRed, lightTeal, lightTheme, lightYellow, normalizeIconSearch, normalizeThemePreference, observeThemePreference, resolveButtonIconColor, resolveThemePreference, selectDarkTheme, selectTheme, selectThemePreference, selectThemeToggleStatus, selectedDarkTheme, selectedTheme, systemThemeChanged, _default as themeReducer, toggleModeTheme, toggleTheme, updateTheme, useAsyncData };
+export { AsyncContent, type AsyncContentProps, type AsyncData, type AsyncState, type AsyncStatus, BUTTON_ICONS, BUTTON_ICON_CATEGORIES, type ButtonIconCategory, type ButtonIconColors, type ButtonIconDefinition, type Calendar, type Contact, ContactInfoPopup, ContactMessageMedia, type ContactMessageMediaProps, ChatDetailsSidebar as ContactSidebar, type ChatDetailsSidebarProps as ContactSidebarProps, DEFAULT_BUTTON_ICON, DEFAULT_DARK_ICON_COLOR, DEFAULT_LIGHT_ICON_COLOR, EditContactModal, type EditContactModalProps, type EditContactMode, EmptyState, type EmptyStateProps, ErrorState, type ErrorStateProps, type EventData, EventsDialog, type EventsDialogProps, HighlightedContactFields, type HighlightedContactFieldsProps, IntegrationButtonIcon, type IntegrationButtonIconProps, type IsEmptyFn, type ItemType, type LegacyThemeName, type ModalMode, MuiComponentsConfig, type MuiComponentsConfigOptions, type Notification, PanelErrorBoundary, type PanelErrorBoundaryProps, type ResolvedTheme, type SidebarChatIntegration, type StartConversationTarget, THEME_PREFERENCES, type TaskData, type ThemeName, type ThemePreference, type ThemeRootState, type ThemeState, type UseAsyncDataResult, asyncIdle, asyncRequestFailed, asyncRequestStarted, asyncRequestSucceeded, darkBlack, darkBlue, darkTheme, defaultIsEmpty, deriveAsyncState, findButtonIcon, getErrorMessage, i18nInstance as i18n, isStale, isValidThemeName, lightAmber, lightBlue, lightBlueIndigo, lightBrown, lightGray, lightGreen, lightLime, lightOrange, lightPink, lightPurple, lightRed, lightTeal, lightTheme, lightYellow, normalizeIconSearch, normalizeThemePreference, observeThemePreference, resolveButtonIconColor, resolveThemePreference, selectDarkTheme, selectTheme, selectThemePreference, selectThemeToggleStatus, selectedDarkTheme, selectedTheme, systemThemeChanged, _default as themeReducer, toggleModeTheme, toggleTheme, updateTheme, useAsyncData };

package/dist/types/components/ContactMessageMedia/index.d.ts

@@ -0,0 +1,12 @@
+export interface ContactMessageMediaProps {
+    baseUrl: string;
+    spaceId: string;
+    /** Contact ID, not a business ID. Choose a linked contact for business histories. */
+    contactId: string;
+    resolveMediaUrl: (url: string) => Promise<string>;
+    language?: string;
+    dateFormat?: string;
+    timeFormat?: string;
+    height?: number | string;
+}
+export default function ContactMessageMedia(props: ContactMessageMediaProps): import("react/jsx-runtime").JSX.Element;

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/components/PanelView/components/ContactData/components/Properties/Properties.d.ts

@@ -1,7 +1,14 @@
-import { Property } from '@trii/types/dist/Contacts';
+import { Property, IContactField } from '@trii/types/dist/Contacts';
 interface Props {
     properties: Property[];
     compact?: boolean;
 }
 declare const Properties: ({ properties, compact }: Props) => import("react/jsx-runtime").JSX.Element;
+export declare function PropertyValues({ properties, compact, fields: customContactFields, user, }: Props & {
+    fields: IContactField[];
+    user?: {
+        dateFormat?: string;
+        timeFormat?: string;
+    } | null;
+}): import("react/jsx-runtime").JSX.Element;
 export default Properties;

package/dist/types/components/ContactSidebar/components/PanelView/components/ContactMedia/ContactMedia.d.ts

@@ -1,4 +1,9 @@
 import React from 'react';
+import type { MediaResource } from '../../../../context/SidebarDataContext';
+export declare function MediaPanel({ media, expanded }: {
+    media: MediaResource;
+    expanded?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
 declare const ContactMedia: React.ForwardRefExoticComponent<{
     contactId: string;
     defaultExpanded?: boolean;

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

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+export interface MediaEnvironment {
+    resolveMediaUrl: (url: string) => Promise<string>;
+    currentUser?: {
+        dateFormat?: string;
+        timeFormat?: string;
+    } | null;
+}
+export declare const MediaEnvironmentContext: import("react").Context<MediaEnvironment>;
+export declare function useMediaEnvironment(): MediaEnvironment;

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/SidebarIdentityContext.d.ts

@@ -36,5 +36,6 @@ export declare const SidebarIdentityProvider: ({ children, }: {
     children: ReactNode;
 }) => import("react/jsx-runtime").JSX.Element;
 export declare function useSidebarIdentity(): SidebarIdentityValue;
+export declare function useOptionalSidebarIdentity(): SidebarIdentityValue;
 /** Solo para tests: descarta la identidad cacheada entre casos. */
 export declare function __resetIdentityCache(): void;

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/dist/types/components/ContactSidebar/hooks/useContactMedia.d.ts

@@ -0,0 +1,3 @@
+import type { MediaResource } from '../context/SidebarDataContext';
+import type { SidebarApiConfig } from '../context/SidebarPropsContext';
+export default function useContactMedia(api: SidebarApiConfig, contactId: string | null): MediaResource;

package/dist/types/components/EditContactModal/shared/EntityCustomFieldLabel/EntityCustomFieldLabel.d.ts

@@ -13,6 +13,7 @@ type Props = {
     baseUrl?: string;
     spaceId?: string;
     onEntityUpdated?: (entity: unknown) => void;
+    onEditingChange?: (editing: boolean) => void;
 };
-declare const EntityCustomFieldLabel: ({ property, entity, entityType, entityId, customContactFields, userTrii, baseUrl, spaceId, onEntityUpdated, }: Props) => import("react/jsx-runtime").JSX.Element;
+declare const EntityCustomFieldLabel: ({ property, entity, entityType, entityId, customContactFields, userTrii, baseUrl, spaceId, onEntityUpdated, onEditingChange, }: Props) => import("react/jsx-runtime").JSX.Element;
 export default EntityCustomFieldLabel;

package/dist/types/components/HighlightedContactFields.d.ts

@@ -0,0 +1,12 @@
+import type { IContactField, Property } from '@trii/types/dist/Contacts';
+export interface HighlightedContactFieldsProps {
+    fields: IContactField[];
+    properties: Property[];
+    user?: {
+        dateFormat?: string;
+        timeFormat?: string;
+    } | null;
+    title?: string;
+}
+/** Shared read-only highlights for contact/company records and conversation sidebars. */
+export default function HighlightedContactFields({ fields, properties, user, title, }: HighlightedContactFieldsProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/index.d.ts

@@ -15,3 +15,7 @@ export type { PanelErrorBoundaryProps } from './PanelErrorBoundary';
 export { default as ContactSidebar } from './ContactSidebar';
 export type { ContactSidebarProps, SidebarChatIntegration, StartConversationTarget, } from './ContactSidebar';
 export * from './IntegrationButtonIcon';
+export { default as HighlightedContactFields } from './HighlightedContactFields';
+export type { HighlightedContactFieldsProps } from './HighlightedContactFields';
+export { default as ContactMessageMedia } from './ContactMessageMedia';
+export type { ContactMessageMediaProps } from './ContactMessageMedia';

package/package.json

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