@imj_media/tareas 1.6.2 → 1.6.4

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

@@ -1,3 +1,4 @@
+import { IAllUsersOBPResponse } from '../infraestructure/interfaces/users-obp-response';
 type TeamWork = {
     id: number;
     nombre: string;
@@ -6,6 +7,16 @@ type TeamWork = {
 type TRequirement = {
     id: number;
     texto_corto: string;
+    /** Tarea previa obligatoria (`id_t_requerida` en listado / detalle acotado). */
+    estatus?: number | null;
+    responsable?: {
+        id?: number;
+        nombre?: string | null;
+    } | null;
+    equipo?: {
+        id?: number;
+        nombre?: string | null;
+    } | null;
 };
 type ImageType = {
     formats: {
@@ -29,6 +40,12 @@ type Responsible = {
     nombre: string;
     imagen: ImageType;
 };
+/** Usuario de auditoría en listado kanban (`created_by` / `updated_by`). */
+export type TaskUserAudit = {
+    id: number;
+    nombre: string;
+    email?: string;
+};
 type CommentItem = {
     id: number;
     comentario: string;
@@ -45,8 +62,10 @@ type CommentProps = {
     comment: CommentItem;
 };
 type CommentsProps = {
-    data: any;
-    currentUser: any;
+    data?: {
+        comentarios?: CommentItem[];
+    } | null;
+    currentUser: (CommentItem['autor'] | IAllUsersOBPResponse) | null;
     taskId: number;
     onNewComment: (addCommentF: boolean) => void;
 };
@@ -75,11 +94,16 @@ type DetailsTaskData = {
     ids_t_dependientes: TRequirement[];
     atraso: IAtrasoReason | null;
     categoria: ICategory | null;
+    /** Quién creó / actualizó cuando el API envía `created_by` / `updated_by` en el listado. */
+    createdBy?: TaskUserAudit | null;
+    updatedBy?: TaskUserAudit | null;
 };
 type DetailsTaskProps = {
     isOpen: boolean;
     taskId: number;
     setIsOpen: (isOpen: boolean) => void;
+    /** Si viene del listado kanban acotado, se evita la primera petición a `/api/detalleTarea/:id`. */
+    initialFromList?: DetailsTaskData | null;
 };
 type TabDetailsTaskItem = {
     id: number;
@@ -89,7 +113,7 @@ type TabDetailsTaskItem = {
 type TabDetailsTaskProps = {
     items: TabDetailsTaskItem[];
 };
-export type { DetailsTaskData, DetailsTaskProps, TabDetailsTaskProps, TabDetailsTaskItem, CommentsProps, CommentItem, CommentProps };
+export type { DetailsTaskData, DetailsTaskProps, TabDetailsTaskProps, TabDetailsTaskItem, CommentsProps, CommentItem, CommentProps, };
 export type ICategory = {
     id: number;
     nombre: string;

package/dist/src/utils/buildKanbanListadoColumnFilters.d.ts

@@ -0,0 +1,19 @@
+import { KanbanListadoFiltersToSend } from '../hooks/kanbanListadoColumnTasks.types';
+type KanbanListadoStatus = 'por_hacer' | 'trabajando' | 'completadas';
+type LayoutFilters = Record<string, unknown> & {
+    owner?: {
+        config?: string;
+        user?: number;
+        role?: string;
+    };
+};
+/**
+ * Filtros listos para POST `listado-kanban-general` (una columna del tablero general).
+ */
+export declare function buildKanbanListadoColumnFilters(filters: LayoutFilters, user: {
+    id: number;
+    role: string;
+}, status: KanbanListadoStatus): KanbanListadoFiltersToSend;
+/** No disparar columnas hasta que el layout aplicó defaults (`owner.config`). */
+export declare function isKanbanListadoFiltersReady(filters: LayoutFilters): boolean;
+export {};

package/dist/src/utils/filters.functions.d.ts

@@ -6,7 +6,7 @@ import { TFilters } from '../context/filtersLayout.context';
 export declare const withoutProjectFilter: (filters: Record<string, unknown>) => {
     [x: string]: unknown;
 };
-export declare const addEstructureToFilters: (filters: TFilters) => any;
+export declare const addEstructureToFilters: (filters: TFilters) => Record<string, unknown>;
 export declare const formatQueryFilters: <T>({ search, filters }: {
     search: string;
     filters: T;

package/dist/src/utils/flattenEquipoMiembros.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Listado kanban OBP: `equipo.miembros` es un árbol; `userOBP` (imagen) va en `idUser.userOBP`.
+ * Compatibilidad: si en un payload viejo `userOBP` solo existía en la raíz del nodo miembro, se usa ahí.
+ */
+type ObpThumbCore = {
+    imagen?: {
+        formats?: {
+            thumbnail?: {
+                url?: string | null;
+            };
+        };
+    };
+    role?: {
+        id: number;
+        name: string;
+    };
+};
+type ObpThumb = ObpThumbCore | null | undefined;
+export type EquipoMiembroNode = {
+    idUser?: {
+        id: number;
+        nombre: string;
+        userOBP?: ObpThumb;
+    } | null;
+    userOBP?: ObpThumb;
+    miembros?: EquipoMiembroNode[];
+};
+export type EquipoMiembroVisit = {
+    idUser: NonNullable<EquipoMiembroNode['idUser']>;
+    node: EquipoMiembroNode;
+};
+export declare function forEachEquipoMiembroIdUser(miembros: EquipoMiembroNode[] | null | undefined, visit: (payload: EquipoMiembroVisit) => void): void;
+export declare function thumbnailUrlFromEquipoMiembroVisit({ idUser, node }: EquipoMiembroVisit): string | undefined;
+export declare function roleFromEquipoMiembroVisit({ idUser, node }: EquipoMiembroVisit): {
+    id: number;
+    name: string;
+};
+export {};

package/dist/src/utils/formats.d.ts

@@ -1,26 +1,12 @@
 import { IUsers } from '../infraestructure/interfaces/users';
 export declare const getMonthName: (month: number) => string;
-export declare const formatDate: (date: Date) => string;
-export declare const AddOBPUrl: (user: IUsers, url: string) => {
-    image: string;
-    id: number;
-    name: string;
-    nombre?: string;
-    tasksUser?: {
-        email: string;
-        id: number;
-        nombre: string;
-    };
-    role: {
-        id: number;
-        name: string;
-    };
-};
+export declare const formatDate: (date: Date | string | null | undefined) => string;
+export declare const AddOBPUrl: (user: IUsers, url: string) => IUsers;
 export declare const extractRequiredTaskResponsible: (idTRequerida?: {
     responsable?: {
-        nombre: string;
+        nombre?: string | null;
     } | null;
     equipo?: {
-        nombre: string;
+        nombre?: string | null;
     } | null;
 } | null) => string | null;

package/dist/src/utils/inputs.functions.d.ts

@@ -1,4 +1,4 @@
-export declare function debounce(callback: (...args: any[]) => void, delay?: number, options?: {
+export declare function debounce<T extends unknown[]>(callback: (...args: T) => void, delay?: number, options?: {
     leading: boolean;
     trailing: boolean;
-}): (...args: any[]) => void;
+}): (...args: T) => void;

package/dist/src/utils/kanbanFilterFieldsEqual.d.ts

@@ -0,0 +1,3 @@
+import { IFieldFilter } from '../context/filtersLayout.context';
+/** Evita `defineFields` / efectos en cadena si las opciones del panel no cambiaron. */
+export declare function areKanbanFilterFieldsEqual(prev: IFieldFilter[] | undefined, next: IFieldFilter[]): boolean;

package/dist/src/utils/kanbanOwnerFilterPermissions.d.ts

@@ -0,0 +1,7 @@
+import { TConfigs } from '../core/actions/get_tasks_response.action';
+export declare const KANBAN_TODAS_TAREAS_ROLE_ALLOWLIST: readonly ["Project Manager", "Administrador"];
+export declare function canUseKanbanTodasTareasFilter(role: string | undefined | null): boolean;
+/**
+ * Evita enviar `config: 'todas'` al listado si el rol no está autorizado (p. ej. manipulación del payload).
+ */
+export declare function resolveOwnerConfigForKanbanListado(config: string | undefined | null, role: string | undefined | null): TConfigs;

package/dist/src/utils/kanbanTasksQueries.d.ts

@@ -20,9 +20,14 @@ export declare const KANBAN_CAMPAIGN_TASKS_QUERY_ROOT: "tasksProject";
  */
 export declare function invalidateKanbanListadoTasksQueries(queryClient: QueryClient): Promise<void>;
 /**
- * Botón “refrescar” del layout en tablero listado: invalida y refetch explícito de las tres columnas.
+ * Botón “refrescar” del layout en tablero listado: reinicia cada infinite query (solo página 1).
+ * No combinar `invalidateQueries` + `refetchQueries`: duplica POST y, con páginas en caché, refetch N veces por columna.
  */
 export declare function invalidateAndRefetchKanbanListadoTasks(queryClient: QueryClient): Promise<void>;
+/**
+ * Botón “refrescar” del layout en tablero campaña: un solo refetch de `tasksProject` activo.
+ */
+export declare function invalidateAndRefetchKanbanCampaignTasks(queryClient: QueryClient): Promise<void>;
 /**
  * Tras un bulk-update en el tablero **campaña**: obsoleta la query de proyecto (cualquier filtro/proyecto activo).
  */

package/dist/src/utils/mapListItemToDetailsTaskData.d.ts

@@ -0,0 +1,6 @@
+import { DetailsTaskData } from '../types';
+/**
+ * Construye un `DetailsTaskData` desde la fila del listado kanban (normalizada).
+ * Permite abrir el panel sin `GET /api/detalleTarea` cuando el listado ya trae los campos.
+ */
+export declare function mapListItemToDetailsTaskData(task: Record<string, unknown>): DetailsTaskData;

package/dist/src/utils/tanstack.functions.d.ts

@@ -1,9 +1,25 @@
+import { GetTasksKanbanPage } from '../core/actions/get_tasks_response.action';
 /**
  * Tamaño de página del infinite query de las columnas del Kanban **listado** (`useToDoTasks`, etc.).
  * `fetchAllKanbanListadoTaskIds` y `fetchNextPage` deben usar el mismo valor para no cortar mal el bucle.
  */
 export declare const KANBAN_LISTADO_INFINITE_PAGE_SIZE = 30;
-export declare const fetchNextPage: (key: any) => void;
+/**
+ * Siguiente página del infinite query del kanban listado.
+ * Evita pedir páginas de más (respuestas vacías / solo meta) y que un refresh refetch todas las páginas en caché sin necesidad.
+ */
+export declare function getKanbanListadoNextPageParam(lastPage: GetTasksKanbanPage | undefined, allPages: GetTasksKanbanPage[]): number | undefined;
+/** Subconjunto de infinite query usado por `fetchNextPage` (Kanban listado). */
+type KanbanInfiniteFetchKey = {
+    hasNextPage?: boolean;
+    fetchNextPage?: () => void;
+    data?: {
+        pages: Array<{
+            tasks?: unknown[];
+        } | unknown[] | undefined>;
+    };
+};
+export declare const fetchNextPage: (key: KanbanInfiniteFetchKey | null | undefined) => void;
 export declare const getPaginationEstructure: (page: number) => {
     pagination: {
         page: number;
@@ -11,3 +27,4 @@ export declare const getPaginationEstructure: (page: number) => {
         withCount: boolean;
     };
 };
+export {};