valtech-components 4.0.218 → 4.0.220

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

@@ -0,0 +1,37 @@
+import { EnvironmentProviders, InjectionToken } from '@angular/core';
+/**
+ * Configuracion del servicio de Chat.
+ */
+export interface ValtechChatConfig {
+    /** URL base de la API del backend (ej: 'https://api.myvaltech.com'). */
+    apiUrl: string;
+    /** ID de la aplicacion (ej: 'showcase'). */
+    appId: string;
+    /** Prefijo del endpoint de chat (default: '/v2/chat'). */
+    chatPrefix?: string;
+}
+/**
+ * Token de inyeccion para la configuracion del Chat.
+ */
+export declare const VALTECH_CHAT_CONFIG: InjectionToken<ValtechChatConfig>;
+/**
+ * Configuracion por defecto del Chat.
+ */
+export declare const DEFAULT_CHAT_CONFIG: Partial<ValtechChatConfig>;
+/**
+ * Provee el servicio de Chat a la aplicacion Angular.
+ *
+ * @example
+ * // main.ts
+ * import { provideValtechChat } from 'valtech-components';
+ *
+ * bootstrapApplication(AppComponent, {
+ *   providers: [
+ *     provideValtechChat({
+ *       apiUrl: environment.apiUrl,
+ *       appId: 'showcase',
+ *     }),
+ *   ],
+ * });
+ */
+export declare function provideValtechChat(config: ValtechChatConfig): EnvironmentProviders;

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

@@ -0,0 +1,147 @@
+import { Observable } from 'rxjs';
+import { Conversation, ConversationType, CreateConversationRequest, ListConversationsResponse, Message, UpdateConversationRequest } from './types';
+import * as i0 from "@angular/core";
+/**
+ * ConversationService
+ *
+ * Gestiona conversaciones y mensajes del chat.
+ *
+ * Dos capas:
+ *   - HTTP (via backend /v2/chat/*): operaciones de escritura y consulta.
+ *   - Firestore real-time (directa): escucha mensajes y estado de escritura.
+ *
+ * Paths Firestore:
+ *   /apps/{appId}/orgs/{orgId}/conversations/{convId}/messages/{msgId}
+ *   /apps/{appId}/orgs/{orgId}/conversations/{convId}/typing/{userId}
+ *
+ * @example
+ * // Enviar y escuchar mensajes
+ * const svc = inject(ConversationService);
+ *
+ * // Enviar (HTTP)
+ * svc.sendMessage(convId, 'Hola!').subscribe();
+ *
+ * // Escuchar en tiempo real (Firestore)
+ * svc.watchMessages(convId, orgId, appId).subscribe(msgs => this.messages.set(msgs));
+ */
+export declare class ConversationService {
+    private config;
+    private http;
+    private firestoreService;
+    private firestore;
+    constructor();
+    private get baseUrl();
+    /**
+     * Crea una nueva conversacion.
+     */
+    createConversation(req: CreateConversationRequest): Observable<Conversation>;
+    /**
+     * Obtiene o crea una conversacion asociada a una entidad (post, request, etc.).
+     * Usa el patron upsert del backend: si ya existe una conversacion para esa entidad,
+     * la devuelve; si no, la crea.
+     */
+    getOrCreateForEntity(entityType: string, entityId: string, type?: ConversationType): Observable<Conversation>;
+    /**
+     * Lista las conversaciones del usuario autenticado.
+     */
+    listConversations(cursor?: string): Observable<ListConversationsResponse>;
+    /**
+     * Obtiene una conversacion por ID.
+     */
+    getConversation(convId: string): Observable<Conversation>;
+    /**
+     * Actualiza el titulo o estado de una conversacion.
+     */
+    updateConversation(convId: string, req: UpdateConversationRequest): Observable<Conversation>;
+    /**
+     * Abre una conversacion cerrada.
+     */
+    openConversation(convId: string): Observable<void>;
+    /**
+     * Cierra una conversacion.
+     */
+    closeConversation(convId: string): Observable<void>;
+    /**
+     * Agrega un participante a la conversacion.
+     */
+    addParticipant(convId: string, userId: string): Observable<void>;
+    /**
+     * Elimina un participante de la conversacion.
+     */
+    removeParticipant(convId: string, userId: string): Observable<void>;
+    /**
+     * Envia un mensaje a una conversacion.
+     */
+    sendMessage(convId: string, body: string): Observable<Message>;
+    /**
+     * Elimina (marca como eliminado) un mensaje.
+     */
+    deleteMessage(convId: string, msgId: string): Observable<void>;
+    /**
+     * Construye el path base para los datos de una conversacion.
+     * Nota: usamos el path completo con skipPrefix porque el path ya incluye
+     * apps/{appId}/orgs/{orgId} que el FirestoreService prefijaria de nuevo.
+     * En cambio armamos el path como sub-coleccion directamente.
+     */
+    private convMessagesPath;
+    private convTypingPath;
+    /**
+     * Escucha los mensajes de una conversacion en tiempo real.
+     *
+     * @param convId - ID de la conversacion
+     * @param orgId - ID de la organizacion
+     * @param appId - ID de la aplicacion
+     * @param limit - Cantidad maxima de mensajes a cargar (default 50)
+     */
+    watchMessages(convId: string, orgId: string, appId: string, limit?: number): Observable<Message[]>;
+    /**
+     * Escucha los usuarios que estan escribiendo en una conversacion.
+     * Devuelve un array de displayNames.
+     *
+     * @param convId - ID de la conversacion
+     * @param orgId - ID de la organizacion
+     * @param appId - ID de la aplicacion
+     */
+    watchTyping(convId: string, orgId: string, appId: string): Observable<string[]>;
+    /**
+     * Registra que el usuario actual esta escribiendo.
+     * El documento se sobreescribe para actualizar el timestamp.
+     * Debe llamarse con un TTL/cleanup (ver stopTyping).
+     *
+     * @param convId - ID de la conversacion
+     * @param orgId - ID de la organizacion
+     * @param appId - ID de la aplicacion
+     * @param displayName - Nombre visible del usuario
+     */
+    startTyping(convId: string, orgId: string, appId: string, displayName: string): void;
+    /**
+     * Elimina el documento de "escribiendo" del usuario actual.
+     *
+     * @param convId - ID de la conversacion
+     * @param orgId - ID de la organizacion
+     * @param appId - ID de la aplicacion
+     */
+    stopTyping(convId: string, orgId: string, appId: string): void;
+    /**
+     * Marca un mensaje como leido por el usuario actual.
+     * Escribe directamente en Firestore sin pasar por el backend.
+     *
+     * @param convId - ID de la conversacion
+     * @param msgId - ID del ultimo mensaje leido
+     * @param orgId - ID de la organizacion
+     * @param appId - ID de la aplicacion
+     */
+    markRead(convId: string, msgId: string, orgId: string, appId: string): void;
+    /**
+     * Importa ABS_PATH_SENTINEL de forma lazy para evitar dependencias circulares.
+     */
+    private getAbsPathSentinel;
+    /**
+     * Obtiene el userId del usuario actual desde sessionStorage / localStorage
+     * como fallback no-DI para el contexto de escritura de Firestore.
+     * En prod, el AuthService actualiza el userId en el contexto de la app.
+     */
+    private getCurrentUserId;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ConversationService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ConversationService>;
+}

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

@@ -0,0 +1,145 @@
+/**
+ * Chat Service Types
+ *
+ * Tipos compartidos para el sistema de chat en tiempo real.
+ * Firestore paths:
+ *   /apps/{appId}/orgs/{orgId}/conversations/{convId}/messages/{msgId}
+ *   /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;
+}
+/** Documento de conversacion en Firestore. */
+export interface Conversation extends FirestoreDocument {
+    /** 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>;
+}
+/** Tipo de mensaje. */
+export type MessageType = 'text' | 'image' | 'file' | 'system';
+/** Estado de envio del mensaje. */
+export type MessageStatus = 'sending' | 'sent' | 'failed';
+/** Archivo adjunto en un mensaje. */
+export interface MessageAttachment {
+    /** Nombre del archivo. */
+    name: string;
+    /** URL de descarga. */
+    url: string;
+    /** Tipo MIME. */
+    mimeType: string;
+    /** Tamano en bytes. */
+    size?: number;
+}
+/** Reaccion a un mensaje. */
+export interface MessageReaction {
+    /** Token del emoji (ej: 'like', 'heart'). */
+    token: string;
+    /** Cantidad de usuarios que reaccionaron con este emoji. */
+    count: number;
+    /** Si el usuario actual tiene activa esta reaccion. */
+    active: boolean;
+}
+/** Referencia al mensaje al que se responde. */
+export interface MessageReplyTo {
+    /** ID del mensaje original. */
+    msgId: string;
+    /** Nombre del emisor del mensaje original. */
+    senderName: string;
+    /** Texto del mensaje original (preview). */
+    body: string;
+}
+/** Documento de mensaje en Firestore. */
+export interface Message extends FirestoreDocument {
+    /** ID del emisor. */
+    senderId: string;
+    /** Nombre visible del emisor. */
+    senderName: string;
+    /** URL del avatar del emisor (opcional). */
+    senderAvatar?: string;
+    /** Cuerpo del mensaje. */
+    body: string;
+    /** Tipo de mensaje. */
+    type: MessageType;
+    /** Fecha de creacion del mensaje. */
+    createdAt: Date;
+    /** Si el mensaje fue eliminado. */
+    isDeleted?: boolean;
+    /** Si el mensaje fue editado. */
+    isEdited?: boolean;
+    /** Mensaje al que se responde. */
+    replyTo?: MessageReplyTo;
+    /** Archivos adjuntos. */
+    attachments?: MessageAttachment[];
+    /** Reacciones del mensaje. */
+    reactions?: MessageReaction[];
+    /** Estado de envio (para mensajes optimistas del lado del cliente). */
+    status?: MessageStatus;
+}
+/** Documento de "escribiendo" en Firestore. */
+export interface TypingDocument extends FirestoreDocument {
+    /** Nombre visible del usuario que esta escribiendo. */
+    displayName: string;
+    /** Timestamp de la ultima actualizacion. */
+    updatedAt: Date;
+}
+/** Request para crear una conversacion. */
+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;
+}
+/** Request para actualizar una conversacion. */
+export interface UpdateConversationRequest {
+    /** Nuevo titulo (opcional). */
+    title?: string;
+    /** Nuevo estado (opcional). */
+    status?: ConversationStatus;
+}
+/** Response de listado de conversaciones. */
+export interface ListConversationsResponse {
+    /** Lista de conversaciones. */
+    conversations: Conversation[];
+    /** Cursor para paginacion. */
+    nextCursor?: string;
+    /** Si hay mas paginas. */
+    hasMore: boolean;
+}

package/lib/services/entity-feed/entity-feed.service.d.ts

@@ -0,0 +1,71 @@
+import { Observable } from 'rxjs';
+import { EntityFeedItem, EntityFeedItemWithReaction } from './types';
+import * as i0 from "@angular/core";
+/**
+ * EntityFeedService — capa de lectura Firestore para entidades proyectables.
+ *
+ * Soporta cualquier tipo de entidad (posts, articles, adoptions, reels...)
+ * siguiendo el esquema de paths:
+ *   - Entidades: apps/{appId}/orgs/{orgId}/{entityType}s/{entityId}
+ *   - Reacciones del usuario: apps/{appId}/users/{uid}/reactions/{entityType}_{entityId}
+ *
+ * FirestoreService auto-prefija los paths con apps/{appId}/.
+ *
+ * @example
+ * const feed = inject(EntityFeedService);
+ *
+ * // Solo entidades
+ * feed.watchEntities<Post>('org_x', 'post').subscribe(posts => ...);
+ *
+ * // Feed con reaccion del viewer incluida
+ * feed.watchFeed<Post>('org_x', 'post').subscribe(items => {
+ *   items.forEach(item => console.log(item.viewerHasReacted, item.viewerToken));
+ * });
+ */
+export declare class EntityFeedService {
+    private fs;
+    private auth;
+    /**
+     * Suscripcion en tiempo real a entidades publicadas de un tipo dado.
+     *
+     * Coleccion: orgs/{orgId}/{entityType}s
+     * Auto-prefijada a: apps/{appId}/orgs/{orgId}/{entityType}s
+     *
+     * Filtra por status === 'published', ordena por publishedAt desc.
+     *
+     * @param orgId - ID de la organizacion
+     * @param entityType - Tipo de entidad en singular (ej. 'post', 'article')
+     * @param options - Opciones opcionales (limit, default 20)
+     */
+    watchEntities<T extends EntityFeedItem>(orgId: string, entityType: string, options?: {
+        limit?: number;
+    }): Observable<T[]>;
+    /**
+     * Suscripcion en tiempo real a las reacciones del usuario actual para un tipo de entidad.
+     *
+     * Coleccion: users/{uid}/reactions
+     * Auto-prefijada a: apps/{appId}/users/{uid}/reactions
+     *
+     * Retorna un Map<entityId, token> para lookup O(1) al combinar con el feed.
+     * Si no hay usuario autenticado, retorna un Map vacio.
+     *
+     * @param entityType - Tipo de entidad a filtrar (ej. 'post', 'article')
+     */
+    watchMyReactions(entityType: string): Observable<Map<string, string>>;
+    /**
+     * Combina watchEntities + watchMyReactions en un unico stream.
+     *
+     * Cada item del feed incluye viewerToken y viewerHasReacted, listos para
+     * renderizar el estado de reaccion del usuario actual sin logica adicional
+     * en la pagina.
+     *
+     * @param orgId - ID de la organizacion
+     * @param entityType - Tipo de entidad en singular (ej. 'post', 'article')
+     * @param options - Opciones opcionales (limit, default 20)
+     */
+    watchFeed<T extends EntityFeedItem>(orgId: string, entityType: string, options?: {
+        limit?: number;
+    }): Observable<EntityFeedItemWithReaction<T>[]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EntityFeedService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<EntityFeedService>;
+}

package/lib/services/entity-feed/index.d.ts

@@ -0,0 +1,2 @@
+export { EntityFeedService } from './entity-feed.service';
+export type { EntityFeedItem, UserReactionDoc, EntityFeedItemWithReaction } from './types';

package/lib/services/entity-feed/types.d.ts

@@ -0,0 +1,26 @@
+export interface EntityFeedItem {
+    id: string;
+    entityType: string;
+    visibility: 'public' | 'org' | 'private';
+    authorId: string;
+    authorName: string;
+    authorAvatarUrl?: string;
+    title?: string;
+    excerpt?: string;
+    coverImage?: string;
+    publishedAt?: Date;
+    updatedAt?: Date;
+    reactionCounts?: Record<string, number>;
+    commentCount?: number;
+}
+export interface UserReactionDoc {
+    id: string;
+    token: string;
+    entityType: string;
+    entityId: string;
+    createdAt?: Date;
+}
+export type EntityFeedItemWithReaction<T extends EntityFeedItem = EntityFeedItem> = T & {
+    viewerToken: string | null;
+    viewerHasReacted: boolean;
+};

package/package.json

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

package/public-api.d.ts

@@ -413,6 +413,7 @@ export * from './lib/components/molecules/request-form/types';
 export * from './lib/components/molecules/content-reaction/content-reaction.component';
 export * from './lib/components/molecules/content-reaction/types';
 export * from './lib/services/reactions/index';
+export * from './lib/services/entity-feed/index';
 export * from './lib/components/molecules/reaction-bar/reaction-bar.component';
 export * from './lib/components/molecules/reaction-bar/types';
 export * from './lib/services/splash-screen';
@@ -469,3 +470,15 @@ export * from './lib/components/organisms/qr-scanner/qr-scanner.component';
 export * from './lib/components/organisms/qr-scanner/types';
 export * from './lib/components/organisms/html-viewer-modal/html-viewer-modal.component';
 export * from './lib/components/molecules/form-field/form-field.component';
+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 * 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 { 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';
+export { ThreadPanelComponent } from './lib/components/organisms/thread-panel/thread-panel.component';