valtech-components 4.0.228 → 4.0.230

package/lib/components/molecules/chat-composer/chat-composer.component.d.ts

@@ -0,0 +1,75 @@
+import { OnDestroy } from '@angular/core';
+import { MessageReplyTo } from '../../../services/chat/types';
+import * as i0 from "@angular/core";
+type PendingKind = 'image' | 'audio' | 'file';
+interface PendingAttachment {
+    id: number;
+    file: File;
+    url?: string;
+    kind: PendingKind;
+}
+/** Evento de envío: texto (caption) + adjuntos staged. files vacío => solo texto. */
+export interface ChatComposerSendEvent {
+    text: string;
+    files: File[];
+}
+/**
+ * val-chat-composer — barra de redacción de chat moderna (signal inputs).
+ *
+ * Pill con: adjuntar (+), textarea auto-grow, y mic/enviar (mic cuando está vacío,
+ * enviar cuando hay texto o adjuntos). Los adjuntos (botón + / pegar imagen) se
+ * acumulan como PREVIEW (miniaturas) y se emiten por `(attach)` recién al ENVIAR
+ * — no se van solos al chat. Audio grabado se emite directo al parar.
+ * No incluye picker de emoji: el teclado del sistema ya lo trae.
+ */
+export declare class ChatComposerComponent implements OnDestroy {
+    private i18n;
+    readonly placeholder: import("@angular/core").InputSignal<string>;
+    readonly disabled: import("@angular/core").InputSignal<boolean>;
+    readonly maxLength: import("@angular/core").InputSignal<number>;
+    readonly replyingTo: import("@angular/core").InputSignal<MessageReplyTo>;
+    readonly showAttach: import("@angular/core").InputSignal<boolean>;
+    readonly showMic: import("@angular/core").InputSignal<boolean>;
+    readonly send: import("@angular/core").OutputEmitterRef<ChatComposerSendEvent>;
+    readonly typing: import("@angular/core").OutputEmitterRef<void>;
+    readonly voice: import("@angular/core").OutputEmitterRef<void>;
+    readonly cancelReply: import("@angular/core").OutputEmitterRef<void>;
+    protected readonly body: import("@angular/core").WritableSignal<string>;
+    protected readonly pending: import("@angular/core").WritableSignal<PendingAttachment[]>;
+    private pendingId;
+    protected readonly recording: import("@angular/core").WritableSignal<boolean>;
+    private readonly recSeconds;
+    private recorder?;
+    private recStream?;
+    private recChunks;
+    private recTimer?;
+    protected readonly recTimeLabel: import("@angular/core").Signal<string>;
+    private lastTypingEmit;
+    constructor();
+    protected readonly canSend: import("@angular/core").Signal<boolean>;
+    protected readonly placeholderText: import("@angular/core").Signal<string>;
+    protected onInput(event: Event): void;
+    protected onKeydown(event: KeyboardEvent): void;
+    protected onSend(): void;
+    protected onFile(event: Event): void;
+    /** Pegar imagen desde el portapapeles (captura de pantalla, copiar imagen). */
+    protected onPaste(event: ClipboardEvent): void;
+    private addPending;
+    protected removePending(id: number): void;
+    /**
+     * Emite typing como máximo 1 vez cada 2s. performance.now es seguro en runtime.
+     */
+    private emitTypingDebounced;
+    /** Selecciona un mimeType de audio soportado por el navegador. */
+    private pickAudioMime;
+    protected startRecording(): Promise<void>;
+    /** Para la grabación y la stagea como adjunto pendiente (con preview de audio). */
+    protected finishRecording(): void;
+    protected cancelRecording(): void;
+    private cleanupRecording;
+    ngOnDestroy(): void;
+    t(key: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ChatComposerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ChatComposerComponent, "val-chat-composer", never, { "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "replyingTo": { "alias": "replyingTo"; "required": false; "isSignal": true; }; "showAttach": { "alias": "showAttach"; "required": false; "isSignal": true; }; "showMic": { "alias": "showMic"; "required": false; "isSignal": true; }; }, { "send": "send"; "typing": "typing"; "voice": "voice"; "cancelReply": "cancelReply"; }, never, never, true, never>;
+}
+export {};

package/lib/components/molecules/conversation-list-item/conversation-list-item.component.d.ts

@@ -0,0 +1,30 @@
+import * as i0 from "@angular/core";
+/**
+ * val-conversation-list-item — fila de lista de conversaciones estilo
+ * Telegram/WhatsApp: avatar (imagen o iniciales), nombre + hora relativa,
+ * preview del último mensaje + badge de no-leídos. Signal inputs, dark-safe.
+ *
+ * @example
+ * <val-conversation-list-item
+ *   [name]="conv.name"
+ *   [lastMessage]="conv.lastMsgPreview"
+ *   [timestamp]="conv.lastMsgAt"
+ *   [unreadCount]="conv.unread"
+ *   (select)="open(conv.convId)" />
+ */
+export declare class ConversationListItemComponent {
+    private i18n;
+    readonly name: import("@angular/core").InputSignal<string>;
+    readonly avatarUrl: import("@angular/core").InputSignal<string>;
+    readonly lastMessage: import("@angular/core").InputSignal<string>;
+    readonly timestamp: import("@angular/core").InputSignal<string | Date>;
+    readonly unreadCount: import("@angular/core").InputSignal<number>;
+    readonly locale: import("@angular/core").InputSignal<string>;
+    readonly select: import("@angular/core").OutputEmitterRef<void>;
+    constructor();
+    protected readonly initials: import("@angular/core").Signal<string>;
+    protected readonly timeLabel: import("@angular/core").Signal<string>;
+    protected emptyText(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ConversationListItemComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ConversationListItemComponent, "val-conversation-list-item", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "avatarUrl": { "alias": "avatarUrl"; "required": false; "isSignal": true; }; "lastMessage": { "alias": "lastMessage"; "required": false; "isSignal": true; }; "timestamp": { "alias": "timestamp"; "required": false; "isSignal": true; }; "unreadCount": { "alias": "unreadCount"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; }, { "select": "select"; }, never, never, true, never>;
+}

package/lib/components/molecules/message-bubble/message-bubble.component.d.ts

@@ -1,40 +1,42 @@
-import { EventEmitter, OnInit } from '@angular/core';
-import { I18nService } from '../../../services/i18n';
-import { MessageBubbleMetadata, MessageReactionClickEvent, MessageReplyClickEvent, MessageDeleteClickEvent, MessageEditClickEvent } from './types';
-import { MessageReaction } from '../../../services/chat/types';
+import { MessageBubbleMetadata } from './types';
 import * as i0 from "@angular/core";
+/** Acción disparada desde una burbuja. Un solo output tipado en vez de 4. */
+export interface MessageBubbleAction {
+    type: 'reply' | 'edit' | 'delete' | 'react';
+    msgId: string;
+    /** Token del emoji, solo para type 'react'. */
+    token?: string;
+}
 /**
- * val-message-bubble
+ * val-message-bubble — burbuja de mensaje presentacional (signal inputs).
  *
- * Burbuja de mensaje para el chat. Alineada a la derecha si isMine, a la izquierda si no.
- * Muestra nombre del emisor, cuerpo, timestamp, estado de envio, reacciones y acciones.
- * Si el mensaje fue eliminado muestra un texto en gris sin acciones.
+ * Sin lógica de negocio: el contenedor (`val-chat-window`) decide agrupación y
+ * pasa flags (showAvatar/showName/tail). Las acciones (responder/editar/borrar/
+ * reaccionar) NO están siempre visibles: se revelan en hover (desktop) o al tocar
+ * la burbuja (móvil), y se emiten por un único `(action)` tipado.
  *
- * @example
- * <val-message-bubble
- *   [props]="msg"
- *   (reactionClick)="onReaction($event)"
- *   (replyClick)="onReply($event)"
- *   (deleteClick)="onDelete($event)"
- * />
+ * Read receipts estilo WhatsApp: sending → reloj, sent → ✓, delivered/read → ✓✓
+ * (read en color), failed → alerta.
  */
-export declare class MessageBubbleComponent implements OnInit {
-    protected i18n: I18nService;
-    props: MessageBubbleMetadata;
-    reactionClick: EventEmitter<MessageReactionClickEvent>;
-    replyClick: EventEmitter<MessageReplyClickEvent>;
-    deleteClick: EventEmitter<MessageDeleteClickEvent>;
-    editClick: EventEmitter<MessageEditClickEvent>;
+export declare class MessageBubbleComponent {
+    private i18n;
+    readonly msg: import("@angular/core").InputSignal<MessageBubbleMetadata>;
+    readonly showAvatar: import("@angular/core").InputSignal<boolean>;
+    readonly showName: import("@angular/core").InputSignal<boolean>;
+    readonly tail: import("@angular/core").InputSignal<boolean>;
+    readonly locale: import("@angular/core").InputSignal<string>;
+    readonly action: import("@angular/core").OutputEmitterRef<MessageBubbleAction>;
+    protected readonly actionsOpen: import("@angular/core").WritableSignal<boolean>;
     constructor();
-    ngOnInit(): void;
-    deletedText(): string;
-    editedLabel(): string;
-    formatTime(date: Date): string;
-    statusIcon(): string;
-    onReactionClick(reaction: MessageReaction): void;
-    onReplyClick(): void;
-    onDeleteClick(): void;
-    onEditClick(): void;
+    protected readonly time: import("@angular/core").Signal<string>;
+    protected readonly initials: import("@angular/core").Signal<string>;
+    protected readonly imageAttachments: import("@angular/core").Signal<import("valtech-components").MessageAttachment[]>;
+    protected readonly audioAttachments: import("@angular/core").Signal<import("valtech-components").MessageAttachment[]>;
+    protected readonly fileAttachments: import("@angular/core").Signal<import("valtech-components").MessageAttachment[]>;
+    protected readonly statusIcon: import("@angular/core").Signal<"time-outline" | "alert-circle" | "checkmark-done" | "checkmark">;
+    protected toggleActions(): void;
+    protected emit(type: MessageBubbleAction['type'], token?: string): void;
+    t(key: string): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<MessageBubbleComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MessageBubbleComponent, "val-message-bubble", never, { "props": { "alias": "props"; "required": false; }; }, { "reactionClick": "reactionClick"; "replyClick": "replyClick"; "deleteClick": "deleteClick"; "editClick": "editClick"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MessageBubbleComponent, "val-message-bubble", never, { "msg": { "alias": "msg"; "required": true; "isSignal": true; }; "showAvatar": { "alias": "showAvatar"; "required": false; "isSignal": true; }; "showName": { "alias": "showName"; "required": false; "isSignal": true; }; "tail": { "alias": "tail"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; }, { "action": "action"; }, never, never, true, never>;
 }

package/lib/components/molecules/typing-indicator/typing-indicator.component.d.ts

@@ -3,17 +3,18 @@ import * as i0 from "@angular/core";
 /**
  * val-typing-indicator
  *
- * Muestra quienes estan escribiendo en el chat con animacion de tres puntos.
- * Se oculta automaticamente si typingUsers esta vacio.
+ * Muestra quienes estan escribiendo con animacion de tres puntos. Se oculta
+ * si `typingUsers` esta vacio. Usa signal input para que `typingText` (computed)
+ * recompute al cambiar la lista.
  *
  * @example
  * <val-typing-indicator [typingUsers]="['Maria', 'Carlos']" />
  */
 export declare class TypingIndicatorComponent {
     protected i18n: I18nService;
-    typingUsers: string[];
+    readonly typingUsers: import("@angular/core").InputSignal<string[]>;
     constructor();
     protected typingText: import("@angular/core").Signal<string>;
     static ɵfac: i0.ɵɵFactoryDeclaration<TypingIndicatorComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<TypingIndicatorComponent, "val-typing-indicator", never, { "typingUsers": { "alias": "typingUsers"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TypingIndicatorComponent, "val-typing-indicator", never, { "typingUsers": { "alias": "typingUsers"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }

package/lib/components/organisms/chat-window/chat-window.component.d.ts

@@ -1,68 +1,64 @@
-import { EventEmitter, OnChanges, OnDestroy, SimpleChanges, AfterViewChecked, AfterViewInit } from '@angular/core';
-import { I18nService } from '../../../services/i18n';
-import { MessageBubbleMetadata, MessageReactionClickEvent } from '../../molecules/message-bubble/types';
+import { MessageReplyTo } from '../../../services/chat/types';
+import { MessageBubbleAction } from '../../molecules/message-bubble/message-bubble.component';
+import { MessageBubbleMetadata } from '../../molecules/message-bubble/types';
+import { ChatComposerSendEvent } from '../../molecules/chat-composer/chat-composer.component';
 import * as i0 from "@angular/core";
-/** Estructura interna para agrupar mensajes por fecha. */
-interface MessageGroup {
-    dateLabel: string;
-    messages: MessageBubbleMetadata[];
-}
+type ChatRow = {
+    kind: 'date';
+    id: string;
+    label: string;
+} | {
+    kind: 'msg';
+    id: string;
+    msg: MessageBubbleMetadata;
+    showName: boolean;
+    showAvatar: boolean;
+    tail: boolean;
+};
 /**
- * val-chat-window
+ * val-chat-window — ventana de chat completa (signal inputs).
  *
- * Ventana de chat completa. Muestra la lista de mensajes agrupados por fecha,
- * el indicador de escritura, el input de mensaje (solo si isOpen) y un banner
- * cuando la conversacion esta cerrada. Auto-scroll al ultimo mensaje cuando
- * llegan mensajes nuevos.
+ * Agrupa mensajes consecutivos del mismo emisor y por día (separadores sticky),
+ * muestra avatar/nombre solo en los bordes del grupo, scroll-to-bottom inteligente
+ * (auto-scroll si estás abajo, pill "mensajes nuevos" si estás leyendo arriba),
+ * composer moderno con contexto de respuesta, y typing indicator.
  *
- * @example
- * <val-chat-window
- *   [convId]="conv.id"
- *   [messages]="messages()"
- *   [currentUserId]="userId"
- *   [isOpen]="conv.status === 'open'"
- *   [typingUsers]="typingUsers()"
- *   (sendMessage)="onSend($event)"
- *   (reactionClick)="onReaction($event)"
- * />
+ * API pública estable (consumida por thread-panel y showcase): inputs convId,
+ * messages, currentUserId, isOpen, typingUsers, isLoading; outputs sendMessage,
+ * loadMore, reactionClick, deleteMessage, replyTo (+ editMessage/attach/voice nuevos).
  */
-export declare class ChatWindowComponent implements OnChanges, AfterViewInit, AfterViewChecked, OnDestroy {
-    protected i18n: I18nService;
-    convId: string;
-    messages: MessageBubbleMetadata[];
-    participants: string[];
-    currentUserId: string;
-    isOpen: boolean;
-    typingUsers: string[];
-    isLoading: boolean;
-    sendMessage: EventEmitter<string>;
-    loadMore: EventEmitter<void>;
-    reactionClick: EventEmitter<{
+export declare class ChatWindowComponent {
+    private i18n;
+    readonly convId: import("@angular/core").InputSignal<string>;
+    readonly messages: import("@angular/core").InputSignal<MessageBubbleMetadata[]>;
+    readonly currentUserId: import("@angular/core").InputSignal<string>;
+    readonly isOpen: import("@angular/core").InputSignal<boolean>;
+    readonly typingUsers: import("@angular/core").InputSignal<string[]>;
+    readonly isLoading: import("@angular/core").InputSignal<boolean>;
+    readonly sendMessage: import("@angular/core").OutputEmitterRef<ChatComposerSendEvent>;
+    readonly loadMore: import("@angular/core").OutputEmitterRef<void>;
+    readonly reactionClick: import("@angular/core").OutputEmitterRef<{
         msgId: string;
         token: string;
     }>;
-    deleteMessage: EventEmitter<string>;
-    replyTo: EventEmitter<string>;
-    private messagesListRef?;
-    private chatWindowElRef?;
-    private prevMessageCount;
-    private shouldScrollToBottom;
-    private vvListener?;
+    readonly deleteMessage: import("@angular/core").OutputEmitterRef<string>;
+    readonly replyTo: import("@angular/core").OutputEmitterRef<string>;
+    readonly editMessage: import("@angular/core").OutputEmitterRef<string>;
+    readonly typing: import("@angular/core").OutputEmitterRef<void>;
+    readonly voice: import("@angular/core").OutputEmitterRef<void>;
+    private readonly msgsEl;
+    protected readonly replyingTo: import("@angular/core").WritableSignal<MessageReplyTo>;
+    protected readonly atBottom: import("@angular/core").WritableSignal<boolean>;
+    protected readonly hasNew: import("@angular/core").WritableSignal<boolean>;
+    protected readonly locale: import("@angular/core").Signal<"es-CL" | "en-US">;
     constructor();
-    ngAfterViewInit(): void;
-    ngOnDestroy(): void;
-    ngOnChanges(changes: SimpleChanges): void;
-    ngAfterViewChecked(): void;
-    private adjustToKeyboard;
-    protected messageGroups: import("@angular/core").Signal<MessageGroup[]>;
-    protected closedText: import("@angular/core").Signal<string>;
-    protected loadingText: import("@angular/core").Signal<string>;
-    protected onReactionClick(event: MessageReactionClickEvent): void;
-    protected onEditClick(_msgId: string): void;
-    protected onTyping(): void;
-    private scrollToBottom;
-    private formatDateLabel;
+    protected readonly rows: import("@angular/core").Signal<ChatRow[]>;
+    protected onScroll(): void;
+    protected scrollToBottom(smooth: boolean): void;
+    protected onSend(event: ChatComposerSendEvent): void;
+    protected onAction(event: MessageBubbleAction): void;
+    t(key: string): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<ChatWindowComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ChatWindowComponent, "val-chat-window", never, { "convId": { "alias": "convId"; "required": false; }; "messages": { "alias": "messages"; "required": false; }; "participants": { "alias": "participants"; "required": false; }; "currentUserId": { "alias": "currentUserId"; "required": false; }; "isOpen": { "alias": "isOpen"; "required": false; }; "typingUsers": { "alias": "typingUsers"; "required": false; }; "isLoading": { "alias": "isLoading"; "required": false; }; }, { "sendMessage": "sendMessage"; "loadMore": "loadMore"; "reactionClick": "reactionClick"; "deleteMessage": "deleteMessage"; "replyTo": "replyTo"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ChatWindowComponent, "val-chat-window", never, { "convId": { "alias": "convId"; "required": false; "isSignal": true; }; "messages": { "alias": "messages"; "required": false; "isSignal": true; }; "currentUserId": { "alias": "currentUserId"; "required": false; "isSignal": true; }; "isOpen": { "alias": "isOpen"; "required": false; "isSignal": true; }; "typingUsers": { "alias": "typingUsers"; "required": false; "isSignal": true; }; "isLoading": { "alias": "isLoading"; "required": false; "isSignal": true; }; }, { "sendMessage": "sendMessage"; "loadMore": "loadMore"; "reactionClick": "reactionClick"; "deleteMessage": "deleteMessage"; "replyTo": "replyTo"; "editMessage": "editMessage"; "typing": "typing"; "voice": "voice"; }, never, never, true, never>;
 }
 export {};

package/lib/components/organisms/thread-panel/thread-panel.component.d.ts

@@ -42,7 +42,10 @@ export declare class ThreadPanelComponent implements OnInit, OnDestroy {
     protected isConvOpen: import("@angular/core").Signal<boolean>;
     protected loadingText: import("@angular/core").Signal<string>;
     protected bubbleMessages: import("@angular/core").Signal<MessageBubbleMetadata[]>;
-    protected onSend(body: string): void;
+    protected onSend(event: {
+        text: string;
+        files: File[];
+    }): void;
     protected onReactionClick(event: {
         msgId: string;
         token: string;

package/lib/services/chat/conversation.service.d.ts

@@ -1,5 +1,5 @@
 import { Observable } from 'rxjs';
-import { Conversation, ConversationType, CreateConversationRequest, ListConversationsResponse, Message, UpdateConversationRequest } from './types';
+import { Conversation, ConversationType, CreateConversationRequest, ListConversationsResponse, Message, MessageAttachment, UpdateConversationRequest } from './types';
 import * as i0 from "@angular/core";
 /**
  * ConversationService
@@ -33,12 +33,17 @@ export declare class ConversationService {
     private get baseUrl();
     /**
      * Crea una nueva conversacion.
+     * El backend responde con un envelope { operationId, conversation } — lo
+     * desenvolvemos para devolver la Conversation directa.
      */
     createConversation(req: CreateConversationRequest): Observable<Conversation>;
     /**
-     * Obtiene o crea una conversacion asociada a una entidad (post, request, etc.).
+     * Obtiene o crea una conversacion asociada a una entidad (post, request, org, etc.).
      * Usa el patron upsert del backend: si ya existe una conversacion para esa entidad,
      * la devuelve; si no, la crea.
+     *
+     * El backend espera { entityRef: { type, id }, type } y responde con un envelope
+     * { operationId, conversation, created }.
      */
     getOrCreateForEntity(entityType: string, entityId: string, type?: ConversationType): Observable<Conversation>;
     /**
@@ -50,7 +55,7 @@ export declare class ConversationService {
      */
     getConversation(convId: string): Observable<Conversation>;
     /**
-     * Actualiza el titulo o estado de una conversacion.
+     * Actualiza el nombre o settings de una conversacion.
      */
     updateConversation(convId: string, req: UpdateConversationRequest): Observable<Conversation>;
     /**
@@ -70,9 +75,11 @@ export declare class ConversationService {
      */
     removeParticipant(convId: string, userId: string): Observable<void>;
     /**
-     * Envia un mensaje a una conversacion.
+     * Envia un mensaje a una conversacion, opcionalmente con adjuntos.
+     * El backend espera `attachments: { url, type, name, size }[]` (key `type` = MIME),
+     * mientras que el front usa `mimeType` — se mapea aqui.
      */
-    sendMessage(convId: string, body: string): Observable<Message>;
+    sendMessage(convId: string, body: string, attachments?: MessageAttachment[]): Observable<Message>;
     /**
      * Elimina (marca como eliminado) un mensaje.
      */

package/lib/services/chat/types.d.ts

@@ -7,50 +7,75 @@
  *   /apps/{appId}/orgs/{orgId}/conversations/{convId}/typing/{userId}
  */
 import { FirestoreDocument } from '../firebase/types';
-/** Tipo de conversacion. */
-export type ConversationType = 'direct' | 'group' | 'entity';
-/** Estado de una conversacion. */
-export type ConversationStatus = 'open' | 'closed';
-/** Participante de una conversacion. */
-export interface ConversationParticipant {
-    /** ID del usuario. */
-    userId: string;
-    /** Nombre visible del usuario. */
-    displayName: string;
-    /** URL del avatar del usuario (opcional). */
-    avatarUrl?: string;
-    /** Fecha en que se unio a la conversacion. */
-    joinedAt: Date;
-    /** Ultimo mensaje leido por este participante. */
-    lastReadMsgId?: string;
+/**
+ * Tipo de conversacion. Debe coincidir con el backend (services/conversation):
+ *   thread = comentarios en entidad · group = canal grupal · dm = 1:1 directo.
+ */
+export type ConversationType = 'thread' | 'group' | 'dm';
+/** Visibilidad de una conversacion (quien puede unirse). */
+export type ConvVisibility = 'org' | 'private' | 'public' | '';
+/** Vinculo de la conversacion con una entidad del dominio. */
+export interface EntityRef {
+    /** Tipo de entidad ('post' | 'request' | 'org' | 'custom', etc.). */
+    type: string;
+    /** ID de la entidad. */
+    id: string;
 }
-/** Documento de conversacion en Firestore. */
-export interface Conversation extends FirestoreDocument {
+/** Configuracion de la conversacion. */
+export interface ConvSettings {
+    /** Si la conversacion esta abierta para enviar mensajes. */
+    isOpen: boolean;
+    /** Quien puede unirse. */
+    visibility: ConvVisibility;
+    /** Si admite participantes anonimos. */
+    allowAnonymous: boolean;
+    /** Si requiere membresia de la org. */
+    requireMembership: boolean;
+    /** Maximo de participantes (0 = sin limite). */
+    maxParticipants: number;
+}
+/**
+ * Documento de conversacion. Refleja el contrato del backend
+ * (services/conversation/types.go) — la fuente de verdad es DynamoDB y el doc se
+ * proyecta a Firestore para las reglas de membresia. Por eso los campos son
+ * `convId`/`name`/`participants: string[]` y NO el shape antiguo.
+ */
+export interface Conversation {
+    /** ID de la conversacion. */
+    convId: string;
     /** Tipo de conversacion. */
     type: ConversationType;
-    /** Estado de la conversacion. */
-    status: ConversationStatus;
-    /** Participantes. */
-    participants: ConversationParticipant[];
-    /** Tipo de entidad asociada (para tipo entity). */
-    entityType?: string;
-    /** ID de la entidad asociada. */
-    entityId?: string;
-    /** Titulo de la conversacion (para grupos). */
-    title?: string;
-    /** ID del ultimo mensaje. */
-    lastMsgId?: string;
-    /** Texto del ultimo mensaje (preview). */
-    lastMsgBody?: string;
-    /** Fecha del ultimo mensaje. */
-    lastMsgAt?: Date;
-    /** Conteo de mensajes no leidos por userId. */
-    unreadCount?: Record<string, number>;
+    /** ID de la app. */
+    appId: string;
+    /** ID de la org. */
+    orgId: string;
+    /** Nombre de la conversacion (para grupos). */
+    name?: string;
+    /** Entidad asociada (para tipo thread). */
+    entityRef?: EntityRef;
+    /** IDs de los participantes. */
+    participants: string[];
+    /** Configuracion. */
+    settings: ConvSettings;
+    /** ID del usuario que la creo. */
+    createdBy: string;
+    /** Fecha de creacion (ISO string). */
+    createdAt: string;
+    /** Fecha de ultima actualizacion (ISO string). */
+    updatedAt: string;
+    /** Fecha del ultimo mensaje (ISO string). */
+    lastMsgAt?: string;
+    /** Preview del ultimo mensaje. */
+    lastMsgPreview?: string;
 }
 /** Tipo de mensaje. */
 export type MessageType = 'text' | 'image' | 'file' | 'system';
-/** Estado de envio del mensaje. */
-export type MessageStatus = 'sending' | 'sent' | 'failed';
+/**
+ * Estado de envio/entrega de un mensaje (para read receipts estilo WhatsApp):
+ *   sending → reloj · sent → ✓ · delivered → ✓✓ gris · read → ✓✓ primary · failed → alerta.
+ * El backend hoy solo emite hasta `sent`; los demas estan soportados para el futuro.
+ */
+export type MessageStatus = 'sending' | 'sent' | 'delivered' | 'read' | 'failed';
 /** Archivo adjunto en un mensaje. */
 export interface MessageAttachment {
     /** Nombre del archivo. */
@@ -118,28 +143,37 @@ export interface TypingDocument extends FirestoreDocument {
 export interface CreateConversationRequest {
     /** Tipo de conversacion. */
     type: ConversationType;
-    /** IDs de los participantes iniciales. */
-    participantIds?: string[];
-    /** Para tipo entity: tipo de la entidad. */
-    entityType?: string;
-    /** Para tipo entity: ID de la entidad. */
-    entityId?: string;
-    /** Titulo (para grupos). */
-    title?: string;
+    /** Nombre (para grupos). */
+    name?: string;
+    /** Entidad asociada (para tipo thread). */
+    entityRef?: EntityRef;
+    /** IDs de los participantes iniciales (ademas del creador). */
+    participants?: string[];
+    /** Configuracion inicial. */
+    settings?: Partial<ConvSettings>;
 }
 /** Request para actualizar una conversacion. */
 export interface UpdateConversationRequest {
-    /** Nuevo titulo (opcional). */
-    title?: string;
-    /** Nuevo estado (opcional). */
-    status?: ConversationStatus;
+    /** Nuevo nombre (opcional). */
+    name?: string;
+    /** Nueva configuracion (opcional). */
+    settings?: Partial<ConvSettings>;
+}
+/** Response que envuelve una sola conversacion (create / get / update / get-or-create). */
+export interface ConversationResponse {
+    /** ID de operacion para tracing. */
+    operationId: string;
+    /** La conversacion. */
+    conversation: Conversation;
+    /** Si fue creada en esta llamada (solo get-or-create). */
+    created?: boolean;
 }
 /** Response de listado de conversaciones. */
 export interface ListConversationsResponse {
+    /** ID de operacion para tracing. */
+    operationId: string;
     /** Lista de conversaciones. */
     conversations: Conversation[];
     /** Cursor para paginacion. */
     nextCursor?: string;
-    /** Si hay mas paginas. */
-    hasMore: boolean;
 }

package/lib/shared/utils/datetime.d.ts

@@ -19,3 +19,22 @@ export type TimeOfDayKey = 'goodMorning' | 'goodAfternoon' | 'goodEvening';
  * const text = i18n.t(key);               // 'Buenos días' | 'Buenas tardes' | 'Buenas noches'
  */
 export declare function getTimeOfDayKey(date?: Date): TimeOfDayKey;
+/** Hora corta local, ej. "14:05". */
+export declare function formatClockTime(value: Date | string | undefined | null, locale?: string): string;
+/**
+ * Etiqueta corta para listas de conversaciones (estilo Telegram/WhatsApp):
+ * hoy → hora ("14:05"), ayer → label `yesterday`, esta semana → día de semana,
+ * más viejo → fecha corta. `labels.today/yesterday` se inyectan ya traducidos.
+ */
+export declare function formatRelativeTime(value: Date | string | undefined | null, locale?: string, labels?: {
+    today?: string;
+    yesterday?: string;
+}): string;
+/**
+ * Etiqueta para separadores de fecha dentro de un chat: "Hoy" / "Ayer" /
+ * fecha larga ("12 de junio de 2026"). `labels.today/yesterday` ya traducidos.
+ */
+export declare function formatDateSeparator(value: Date | string | undefined | null, locale?: string, labels?: {
+    today?: string;
+    yesterday?: string;
+}): string;

package/lib/version.d.ts

@@ -2,4 +2,4 @@
  * Current version of valtech-components.
  * This is automatically updated during the publish process.
  */
-export declare const VERSION = "4.0.228";
+export declare const VERSION = "4.0.230";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valtech-components",
-  "version": "4.0.228",
+  "version": "4.0.230",
   "private": false,
   "bin": {
     "valtech-firebase-config": "./src/lib/services/firebase/scripts/generate-sw-config.js"

package/public-api.d.ts

@@ -474,10 +474,12 @@ export { ConversationService } from './lib/services/chat/conversation.service';
 export { provideValtechChat, VALTECH_CHAT_CONFIG } from './lib/services/chat/config';
 export type { ValtechChatConfig } from './lib/services/chat/config';
 export * from './lib/services/chat/types';
-export { MessageBubbleComponent } from './lib/components/molecules/message-bubble/message-bubble.component';
+export { MessageBubbleComponent, type MessageBubbleAction, } from './lib/components/molecules/message-bubble/message-bubble.component';
 export * from './lib/components/molecules/message-bubble/types';
 export { ChatInputComponent } from './lib/components/molecules/chat-input/chat-input.component';
 export * from './lib/components/molecules/chat-input/types';
+export { ChatComposerComponent, type ChatComposerSendEvent, } from './lib/components/molecules/chat-composer/chat-composer.component';
+export { ConversationListItemComponent } from './lib/components/molecules/conversation-list-item/conversation-list-item.component';
 export { TypingIndicatorComponent } from './lib/components/molecules/typing-indicator/typing-indicator.component';
 export { ChatWindowComponent } from './lib/components/organisms/chat-window/chat-window.component';
 export * from './lib/components/organisms/chat-window/types';