@trii/components 2.0.84 → 2.0.86

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { IContact, IBusiness } 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';
 import React from 'react';
@@ -17,6 +18,7 @@ interface ContactInfoPopupProps {
     avatarImgUrl?: string;
     sx?: SxProps<Theme>;
     navigate: (path: string) => void;
+    contactNameFormat?: Spaces.nameFormat;
 }
 declare const ContactInfoPopup: (props: ContactInfoPopupProps) => react_jsx_runtime.JSX.Element;
 
@@ -31,6 +33,7 @@ interface Props {
     navigate: (path: string) => void;
     googleMapsApiKey?: string;
     onEntityUpdated?: (entity: IContact$1 | IBusiness$1) => void;
+    contactNameFormat?: Spaces.nameFormat;
 }
 declare const EditContactModal: (props: Props) => react_jsx_runtime.JSX.Element;
 

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

@@ -19,7 +19,11 @@ export interface EventsDialogProps {
     language?: 'en' | 'es';
     /** Modo del diálogo: 'create' | 'edit' | 'view' */
     mode?: Mode;
-    /** Tipo de diálogo: 'event' | 'task' */
+    /**
+     * Tipo de diálogo: 'event' | 'task'
+     * Define si el modal trabaja con eventos o tareas.
+     * Cuando se combina con hiddenTabs=true, permite contextos específicos (solo eventos o solo tareas).
+     */
     type?: DialogType;
     /** ID del calendario seleccionado para eventos (usado en modo view/edit) */
     eventCalendarId?: string;
@@ -33,7 +37,12 @@ export interface EventsDialogProps {
     sx?: SxProps<Theme>;
     /** ID del contacto a vincular automáticamente al crear un evento o tarea */
     contactId?: string;
-    /** Tabs a ocultar: 'details', 'reminders', 'tasks' */
+    /**
+     * Oculta las tabs de cambio entre evento/tarea.
+     * Útil cuando la aplicación consumidora separa eventos y tareas en diferentes áreas.
+     * Ejemplo: Una vista de "Mis Eventos" solo debería mostrar eventos (type='event', hiddenTabs=true)
+     *          Una vista de "Mis Tareas" solo debería mostrar tareas (type='task', hiddenTabs=true)
+     */
     hiddenTabs?: boolean;
     /** Callback invocado tras cada operación CRUD exitosa (crear, editar, eliminar) */
     onActionComplete?: (action: 'created' | 'updated' | 'deleted', type: 'event' | 'task', data: any) => void;
@@ -49,7 +58,11 @@ export interface EventsDialogProps {
  * mediante las APIs. Solo requiere las props esenciales: baseUrl, spaceId, open, onClose.
  * Los calendarios, eventos y tareas se cargan automáticamente desde las APIs.
  *
- * @example
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * MODOS DE USO
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * 1. MODO UNIFICADO (eventos y tareas juntos):
  * ```tsx
  * <EventsDialog
  *   open={isOpen}
@@ -61,6 +74,54 @@ export interface EventsDialogProps {
  *   type="event"
  * />
  * ```
+ * En este modo, el usuario puede alternar entre crear eventos o tareas usando las tabs.
+ *
+ * 2. MODO SEPARADO (solo eventos O solo tareas):
+ * ```tsx
+ * // Vista de "Mis Eventos" - solo muestra eventos
+ * <EventsDialog
+ *   open={isEventDialogOpen}
+ *   onClose={handleClose}
+ *   baseUrl="https://api.trii.app/api/v1"
+ *   spaceId={spaceId}
+ *   type="event"
+ *   hiddenTabs={true}  // Oculta las tabs de cambio
+ *   mode="create"
+ * />
+ *
+ * // Vista de "Mis Tareas" - solo muestra tareas
+ * <EventsDialog
+ *   open={isTaskDialogOpen}
+ *   onClose={handleClose}
+ *   baseUrl="https://api.trii.app/api/v1"
+ *   spaceId={spaceId}
+ *   type="task"
+ *   hiddenTabs={true}  // Oculta las tabs de cambio
+ *   mode="create"
+ * />
+ * ```
+ * Este modo es útil cuando la aplicación consumidora separa eventos y tareas
+ * en diferentes secciones de la interfaz.
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * ENDPOINTS UTILIZADOS
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * Ver documentación completa en: src/components/EventsDialog/services/calendarApi.ts
+ *
+ * Eventos:
+ * - POST   /api/v1/calendar/{spaceId}/events
+ * - GET    /api/v1/calendar/{spaceId}/Events?start={start}&end={end}
+ * - GET    /api/v1/calendar/{spaceId}/events/{eventId}
+ * - PUT    /api/v1/calendar/{spaceId}/events/{eventId}
+ * - PUT    /api/v1/calendar/{spaceId}/events/occurrence/{eventId}
+ * - DELETE /api/v1/calendar/{spaceId}/events/{eventId}
+ *
+ * Tareas:
+ * - POST   /api/v1/calendar/{spaceId}/Task
+ * - GET    /api/v1/calendar/{spaceId}/Task/{calendarId}
+ * - GET    /api/v1/calendar/{spaceId}/Task/detail/{taskId}
+ * - PUT    /api/v1/calendar/{spaceId}/Task/{taskId}
+ * - DELETE /api/v1/calendar/{spaceId}/Task/{taskId}
  */
 declare const EventsDialog: React.FC<EventsDialogProps>;
 export default EventsDialog;

package/dist/types/components/EventsDialog/context/CalendarContext.d.ts

@@ -59,10 +59,8 @@ export type CalendarContextType = {
     isLoadingCalendars: boolean;
     isCreatingEvent: boolean;
     isUpdatingEvent: boolean;
-    isDeletingEvent: boolean;
     isCreatingTask: boolean;
     isUpdatingTask: boolean;
-    isDeletingTask: boolean;
     handleSaveUpdatedTask: () => void;
     handleDeleteTask: () => void;
     handleToggleTaskCompleted: () => void;

package/dist/types/components/EventsDialog/hooks/useEvent.d.ts

@@ -22,7 +22,7 @@ export interface SelectedContact {
 export interface UseLinkContact {
     state: {
         search: string;
-        selectedContacts: SelectedContact[];
+        selectedContact: SelectedContact | null;
     };
     action: {
         handleSelectContact: (contact: IContact) => void;
@@ -31,15 +31,6 @@ export interface UseLinkContact {
         resetField: () => void;
     };
 }
-export interface UseShareWithUsers {
-    field: {
-        userIds: string[];
-    };
-    action: {
-        setUserIds: (ids: string[]) => void;
-        resetField: () => void;
-    };
-}
 export interface UseEvent {
     titleField: UseFieldType;
     descriptionField: UseFieldType;
@@ -53,7 +44,6 @@ export interface UseEvent {
     recurrenceRule: string;
     setRecurrenceRule: (rule: string) => void;
     notifications: UseNotificationsType;
-    shareWithUsers: UseShareWithUsers;
     linkContact: UseLinkContact;
     create: () => {
         title: string;
@@ -65,12 +55,8 @@ export interface UseEvent {
         startAt: string;
         endAt: string;
         notifications: any[];
-        sharedWith: string[];
         rule: string;
-        relatedContact: {} | {
-            id: string;
-            name: string;
-        };
+        contactId: string | null;
     };
     resetFields: () => void;
 }

package/dist/types/components/EventsDialog/hooks/useTask.d.ts

@@ -10,10 +10,7 @@ export interface UseTask {
         description: string;
         startAt: string;
         endAt: string;
-        relatedContact: {} | {
-            id: string;
-            name: string;
-        };
+        contactId: string | null;
     };
     resetFields: () => void;
 }

package/dist/types/components/EventsDialog/services/calendarApi.d.ts

@@ -3,17 +3,84 @@ import { ICalendar } from '@trii/types/dist/Calendar/Calendar';
 import { ITask } from '@trii/types/dist/Calendar';
 import { UserTrii } from '@trii/types/dist/Users';
 import type { AddActivityRequestData, UpdatedActivityRequestData, AddTaskRequestData, AddCalendarRequestData } from '../types';
+/**
+ * API Service para operaciones de Calendar, Events y Tasks
+ *
+ * ENDPOINTS UTILIZADOS:
+ *
+ * ═══════════════════════════════════════════════════════════
+ * EVENTOS (Events)
+ * ═══════════════════════════════════════════════════════════
+ * GET    /api/v1/calendar/{spaceId}/Events?start={start}&end={end}
+ *        - Lista eventos en un rango de fechas
+ *
+ * GET    /api/v1/calendar/{spaceId}/events/{eventId}
+ *        - Obtiene un evento específico por ID
+ *
+ * POST   /api/v1/calendar/{spaceId}/events
+ *        - Crea un nuevo evento
+ *
+ * PUT    /api/v1/calendar/{spaceId}/events/{eventId}
+ *        - Actualiza un evento existente
+ *
+ * PUT    /api/v1/calendar/{spaceId}/events/occurrence/{eventId}?occurrence={date}
+ *        - Actualiza una ocurrencia específica de un evento recurrente
+ *
+ * DELETE /api/v1/calendar/{spaceId}/events/{eventId}
+ *        - Elimina un evento
+ *
+ * DELETE /api/v1/calendar/{spaceId}/events/{eventId}?occurrence={date}
+ *        - Elimina una ocurrencia específica de un evento recurrente
+ *
+ * ═══════════════════════════════════════════════════════════
+ * TAREAS (Tasks)
+ * ═══════════════════════════════════════════════════════════
+ * GET    /api/v1/calendar/{spaceId}/Task/{calendarId}
+ *        - Lista todas las tareas de un calendario
+ *
+ * GET    /api/v1/calendar/{spaceId}/Task/detail/{taskId}
+ *        - Obtiene una tarea específica por ID
+ *
+ * POST   /api/v1/calendar/{spaceId}/Task
+ *        - Crea una nueva tarea
+ *
+ * PUT    /api/v1/calendar/{spaceId}/Task/{taskId}
+ *        - Actualiza una tarea existente
+ *
+ * DELETE /api/v1/calendar/{spaceId}/Task/{taskId}
+ *        - Elimina una tarea
+ *
+ * ═══════════════════════════════════════════════════════════
+ * CALENDARIOS (Calendars)
+ * ═══════════════════════════════════════════════════════════
+ * GET    /api/v1/calendar/{spaceId}/Calendar
+ *        - Lista todos los calendarios del espacio
+ *
+ * POST   /api/v1/calendar/{spaceId}/Calendar
+ *        - Crea un nuevo calendario
+ *
+ * PUT    /api/v1/calendar/{spaceId}/Calendar/{calendarId}
+ *        - Actualiza un calendario existente
+ *
+ * ═══════════════════════════════════════════════════════════
+ * USUARIO (User)
+ * ═══════════════════════════════════════════════════════════
+ * GET    /api/v1/settings/{spaceId}/user
+ *        - Obtiene información del usuario actual
+ */
 type ApiContext = {
     baseUrl: string;
     spaceId: string;
 };
 export declare function fetchUserTrii(ctx: ApiContext): Promise<UserTrii>;
 export declare function fetchActivities(ctx: ApiContext, start: string, end: string): Promise<IEvent[]>;
+export declare function fetchEventById(ctx: ApiContext, eventId: string): Promise<IEvent>;
 export declare function addActivity(ctx: ApiContext, data: AddActivityRequestData): Promise<IEvent>;
 export declare function updateActivity(ctx: ApiContext, data: UpdatedActivityRequestData): Promise<IEvent>;
 export declare function deleteActivity(ctx: ApiContext, activityId: string, originalOccurrenceDate?: Date | string): Promise<void>;
 export declare function endActivity(ctx: ApiContext, activityId: string): Promise<IEvent>;
 export declare function fetchTasks(ctx: ApiContext, calendarId: string): Promise<ITask[]>;
+export declare function fetchTaskById(ctx: ApiContext, taskId: string): Promise<ITask>;
 export declare function addTask(ctx: ApiContext, data: AddTaskRequestData): Promise<ITask>;
 export declare function updateTaskApi(ctx: ApiContext, taskId: string, updatedTask: Record<string, unknown>): Promise<ITask>;
 export declare function deleteTaskApi(ctx: ApiContext, taskId: string): Promise<void>;

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

@@ -52,7 +52,6 @@ export interface EventData {
     rule?: string;
     notifications?: Notification[];
     relatedContactId?: string;
-    sharedWith?: string[];
 }
 /**
  * Datos de una tarea
@@ -83,10 +82,7 @@ export type AddActivityRequestData = {
     endAt: Date;
     allDay: boolean;
     notifications: EventNotificationFront[];
-    relatedContact?: {} | {
-        id: string;
-        name: string;
-    };
+    contactId?: string | null;
     title: string;
     details: string;
     location: string;
@@ -94,7 +90,6 @@ export type AddActivityRequestData = {
     eventTypeId: string;
     calendarId: string;
     repeatId: string;
-    sharedWith: string[];
     rule?: string;
     originalOccurrenceDate?: Date | string;
 };
@@ -110,10 +105,7 @@ export type AddTaskRequestData = {
     calendarId: string;
     startAt: string;
     description?: string;
-    relatedContact?: {} | {
-        id: string;
-        name: string;
-    };
+    contactId?: string | null;
 };
 /** Payload para actualizar una tarea */
 export type UpdateTaskRequestData = {

package/package.json

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