@infosel-sdk/widgets 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,167 @@
+# Changelog
+
+Todos los cambios notables en este proyecto serán documentados en este archivo.
+
+El formato está basado en [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+y este proyecto adhiere al [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.1] - 2025-01-XX
+
+### Fixed
+
+- 🐛 **createWidget response ahora incluye chartConfiguration**: Se agregaron los campos `chartConfiguration { id, globalConfiguration }` a la respuesta de la mutación `createWidget` para que la respuesta incluya la configuración del gráfico cuando se crea un widget de tipo CHART. Esto asegura que el widget creado retorne todos sus datos completos incluyendo la configuración del gráfico.
+
+## [1.0.0] - 2025-01-06
+
+### Added
+
+- 🎉 **Lanzamiento inicial del SDK de Widgets** - Primer release del paquete independiente `@infosel-sdk/widgets` dedicado exclusivamente a la gestión de widgets, workspaces e instrumentos financieros.
+
+- 📦 **Migración completa desde @infosel-sdk/markets** - Se migraron 19 casos de uso, todas las entidades relacionadas, repositorios, datasources, mappers y tests desde el paquete markets para crear una arquitectura limpia y enfocada.
+
+#### Casos de Uso de Widgets (5 métodos)
+
+- 🎨 **createWidget(request: CreateWidgetRequest)**: Crea nuevos widgets con configuraciones personalizadas. Soporta 15 tipos de widgets incluyendo CHART, DYNAMIC_TABLE, NEWS_LIST, TICKER_TAPE, FINANCIAL_STATEMENTS, MARKET_TOTAL, BROKERAGE_TRADES y más. Valida que se proporcione exactamente un target (userId XOR workspaceId). Permite configurar instrumentos, layout (x, y, draggable, resizable), size (width, height, min/max constraints), y configuraciones específicas por tipo como newsConfiguration, chartConfiguration, dynamicTableConfiguration.
+
+- 🔄 **duplicateWidget(request: DuplicateWidgetRequest)**: Duplica widgets existentes incluyendo todas sus configuraciones, instrumentos asociados y propiedades. Permite especificar un nuevo workspaceId destino y nombre opcional.
+
+- 🔧 **updateWidgetInstruments(request: UpdateWidgetInstrumentsRequest)**: Actualiza los instrumentos asociados a un widget mediante un array de keys. Retorna la lista actualizada de instrumentos con sus propiedades (instrumentKey, symbol).
+
+- 📊 **updateWidgetChart(request: UpdateWidgetChartRequest)**: Actualiza la configuración de gráficos en widgets tipo CHART. Permite modificar chartConfiguration con id y globalConfiguration (JSON stringificado).
+
+- 🗑️ **deleteWidget(widgetId: string)**: Elimina widgets del sistema. Retorna el ID del widget eliminado como confirmación.
+
+#### Casos de Uso de Workspaces (9 métodos)
+
+- 🏢 **createWorkspace(request: CreateWorkspaceRequest)**: Crea nuevos espacios de trabajo con validación de parámetros. Soporta creación por userId o projectId (mutuamente excluyentes). Requiere name, opcionalmente description, userId o projectId.
+
+- 🔄 **duplicateWorkspace(request: DuplicateWorkspaceRequest)**: Duplica workspaces existentes incluyendo todos sus widgets asociados y configuraciones. Permite especificar un nuevo name para el workspace duplicado.
+
+- 🔧 **updateWorkspace(request: UpdateWorkspaceRequest)**: Actualiza información de workspaces (name, description). Requiere id del workspace y campos a actualizar.
+
+- 🗑️ **deleteWorkspace(request: DeleteWorkspaceRequest)**: Elimina workspaces del sistema. Requiere id del workspace. Retorna el ID eliminado como confirmación.
+
+- 📋 **getWorkspace(request: GetWorkspaceRequest)**: Obtiene un workspace individual con todos sus widgets asociados, instrumentos y configuraciones. Retorna WorkspaceWidgets con estructura completa.
+
+- 📚 **getWorkspaces(request: GetWorkspacesRequest)**: Obtiene lista de workspaces de un proyecto con filtros opcionales. Requiere projectId. Retorna WorkspacesContainer con estructura organizada por workspace.
+
+- 👤 **getWorkspacesByUser(request: GetWorkspacesByUserRequest)**: Obtiene workspaces asociados a un usuario específico. Requiere userId. Retorna WorkspacesContainer.
+
+- 🏗️ **getWorkspacesByProjectId(request: GetWorkspacesRequest)**: Obtiene workspaces asociados a un proyecto por ID. Requiere projectId. Retorna WorkspacesContainer.
+
+- 👥 **getUserWorkspaces(request: GetUserWorkspacesRequest)**: Obtiene workspaces de un usuario por connectionId y projectId. Retorna UserWorkspaces con información del usuario, workspaces y widgets asociados.
+
+#### Casos de Uso de Instruments (4 métodos)
+
+- ➕ **createInstrument(request: CreateInstrumentRequest)**: Crea nuevos instrumentos asociados a widgets. Valida que symbol y uniqueKey sean requeridos y no vacíos. Requiere widgetId válido. Retorna Instrument con instrumentKey formateado como `{uniqueKey}/{symbol}`.
+
+- 🗑️ **deleteInstrument(instrumentId: string)**: Elimina instrumentos de widgets. Retorna el ID del instrumento eliminado como confirmación.
+
+- 📊 **getInstruments(request: GetInstrumentsRequest)**: Obtiene instrumentos asociados a widgets de un workspace. Requiere workspaceId. Retorna InstrumentsResponse con total, fields (InstrumentFieldsContainer) organizados por workspace.
+
+- 📦 **getProjectWidgets(request: GetProjectWidgetsRequest)**: Obtiene todos los widgets de un proyecto con sus instrumentos asociados. Requiere projectId. Retorna ProjectWidgetsContainer con estructura organizada por workspace.
+
+- 👤 **getUserWidgets(request: GetUserWidgetsRequest)**: Obtiene todos los widgets de un usuario. Requiere id del usuario. Retorna UserWidgets con lista completa de widgets del usuario.
+
+#### Arquitectura y Estructura
+
+- 🏗️ **Capa de Dominio Completa**: 19 casos de uso implementados (18 migrados + 1 adicional). Interfaces `WidgetsRepository` con 18 métodos y `WidgetsDatasource` con 18 métodos correspondientes. 31 entidades de dominio incluyendo Widget, Workspace, Instrument y todas sus request/response entities. Módulo DI `WidgetsModule` interface para inyección de dependencias con getter para repository.
+
+- 📡 **Capa de Datos Completa**: `WidgetsDatasourceImpl` con implementación GraphQL completa usando GraphQlClient para todas las operaciones (mutations y queries). `WidgetsRepositoryImpl` que delega todas las llamadas al datasource. `WidgetsMapper` con 8 métodos de mapeo: mapWorkspaces, mapWidgets, mapWidget, mapWidgetsContainer, mapInstrumentsContainer, mapInstruments, mapTableColumns. 20+ modelos de datos para todas las configuraciones de widgets incluyendo WidgetModel, WorkspaceModel, InstrumentModel y configuraciones específicas.
+
+- 🔌 **Módulo de Inicialización**: `InfoselWidgetsModule` con configuración simplificada que solo requiere `widgetsUrl` (no necesita marketsUrl ni securitiesUrl). Inicializa GraphQlClient con widgetsUrl para cada ambiente. `InfoselWidgets` component como punto de entrada principal con método estático `init({ sdkManager })`. Soporte para 3 ambientes: qa (https://api-qa.infosel.com/widgets/graphql), preprod (https://api-pre.infosel.com/widgets/graphql), prod (https://api.infosel.com/widgets/graphql). Inicialización lazy de casos de uso (se crean bajo demanda) para optimización de memoria y rendimiento.
+
+#### Entidades de Dominio (31 entidades)
+
+- **Widget**: Entidad principal con id, name, type (15 tipos soportados), layout (WidgetLayoutConfig con x, y, draggable, resizable), size (WidgetSizeConfig con width, height, min/max constraints), tickerConfiguration, tableColumns (WidgetTableColumn[]), instruments (Instrument[]), y configuraciones específicas por tipo.
+
+- **Workspace**: Entidad con id, name, description, y relaciones con widgets.
+
+- **Instrument**: Entidad con instrumentKey (formato `{uniqueKey}/{symbol}`) y symbol.
+
+- **Request Entities (9)**: CreateWidgetRequest, CreateWorkspaceRequest, CreateInstrumentRequest, UpdateWidgetChartRequest, UpdateWidgetInstrumentsRequest, UpdateWorkspaceRequest, DuplicateWidgetRequest, DuplicateWorkspaceRequest, DeleteWorkspaceRequest.
+
+- **Response Entities (6)**: WorkspaceWidgets (workspace con widgets), WorkspacesContainer (objeto con workspaces por ID), UserWorkspaces (usuario con workspaces y widgets), UserWidgets (usuario con lista de widgets), ProjectWidgetsContainer (proyecto con workspaces y widgets), InstrumentsResponse (total y fields organizados).
+
+#### Configuraciones de Widgets (9 tipos)
+
+- 📐 **WidgetLayoutConfig**: x, y (coordenadas), draggable, resizable (booleanos).
+
+- 📏 **WidgetSizeConfig**: width, height, minWidth, minHeight, maxWidth, maxHeight, x, y, draggable, resizable.
+
+- 🎨 **WidgetDynamicTableConfiguration**: period, instrumentLimit, field, condition, marketTypeId, valueTypeIds[], exchangeId, scope, hasActivity, isFiltered, operatingCompany, isYields.
+
+- 📊 **WidgetChartConfiguration**: id, globalConfiguration (JSON string).
+
+- 📈 **WidgetMarketTotalConfiguration**: id, scope.
+
+- 🏢 **WidgetBrokerageTradesConfiguration**: id, scope, broker, symbol, concertationType, limit, offset, operationType, order.
+
+- 🏢 **WidgetBrokerageConcentrationConfiguration**: id, scope.
+
+- 🏢 **WidgetBrokerageParticipationConfiguration**: id, broker, instrumentType, crosses, purchases, sales, totals, symbol.
+
+- 📦 **WidgetTradedPackagesConfiguration**: id, scope.
+
+- 🔍 **WidgetDecreedRightsSearcherConfiguration**: id, scope, endDate, issuer, limit, offset, startDate, type.
+
+- 📋 **WidgetIndicesComponentsConfiguration**: id, scope, component, sector, type.
+
+- 📰 **NewsConfiguration**: period, listType, limit, offset, sourcesId, newsTypeId.
+
+### Changed
+
+- 🔄 **Separación de responsabilidades**: Funcionalidades de widgets completamente separadas de @infosel-sdk/markets. Markets ahora se enfoca exclusivamente en búsqueda de instrumentos (searchInstruments), obtención de campos (getInstrumentFields, getInstrumentMultipleFields) y detalles financieros (getInstrumentDetailProfile, getInstrumentDetailFinancialReasons, etc.). Widgets se enfoca exclusivamente en gestión de widgets, workspaces e instruments. Esta separación mejora la mantenibilidad, reduce acoplamiento y permite evolución independiente de cada paquete.
+
+- ⚙️ **Configuración simplificada**: El módulo ahora solo requiere `widgetsUrl` para GraphQL (eliminado marketsUrl y securitiesUrl). Configuración más simple y enfocada que reduce complejidad y errores de configuración. URLs predefinidas para cada ambiente (qa, preprod, prod) eliminando necesidad de configuración manual.
+
+### Technical Details
+
+- **GraphQL Client**: Todas las 18 operaciones utilizan GraphQL exclusivamente a través de widgetsUrl. Mutations para create/update/delete operations. Queries para get operations. Sin dependencia de HTTP client para operaciones de widgets.
+
+- **Arquitectura Clean**: Separación clara entre capas: Domain (use cases, entities, repositories interfaces), Data (datasource implementations, repository implementations, mappers, models). Dependency Inversion: domain no depende de data layer.
+
+- **Type Safety**: TypeScript completo con interfaces estrictas, tipos union para WidgetType, tipos opcionales marcados explícitamente, validación de tipos en tiempo de compilación.
+
+- **Dependency Injection**: Sistema modular con interfaces WidgetsModule y WidgetsComponent. Inicialización lazy de casos de uso (se crean solo cuando se usan). Facilita testing con mocks.
+
+- **Lazy Loading**: Casos de uso se inicializan bajo demanda (lazy initialization) para optimización de memoria. Cada método verifica si el caso de uso existe, si no lo crea y lo cachea.
+
+### Developer Experience
+
+- 📖 **Documentación completa**: README.md con 900+ líneas incluyendo ejemplos de uso, API reference completa, ejemplos prácticos (Dashboard completo, Gestor de Widgets, Gestor de Workspaces), guía de instalación y configuración.
+
+- 🧪 **Tests comprehensivos**: 13 test suites con 66 tests pasando. Cobertura completa de casos de uso (19 archivos .spec.ts), entidades (2 archivos), repositorios y datasources. Mocks y factories para facilitar testing.
+
+- 🔍 **TypeScript**: Tipado completo con interfaces exportadas, tipos estrictos, IntelliSense completo en IDEs. Mejora experiencia de desarrollo con autocompletado y detección temprana de errores.
+
+- 📦 **NPM Package**: Configuración correcta de package.json con exports, dependencies (@infosel-sdk/core ^0.0.5, dayjs), scripts de test y build. Listo para publicación en NPM registry.
+
+### Migration Notes
+
+- ⚠️ **Breaking Change desde @infosel-sdk/markets**: Si estás usando funcionalidades de widgets, workspaces o instruments desde @infosel-sdk/markets v0.x, deberás migrar a @infosel-sdk/widgets v1.0.0. Los métodos relacionados con widgets han sido removidos de markets.
+
+- 🔄 **Compatibilidad de API**: Las entidades y métodos mantienen la misma estructura y nombres para facilitar la migración. Los request/response objects tienen la misma estructura. Solo cambia el import: `import InfoselWidgets from '@infosel-sdk/widgets'` en lugar de `import InfoselMarkets from '@infosel-sdk/markets'`.
+
+- 📚 **Guía de Migración**: Consulta el README.md para ejemplos detallados de migración. El patrón de inicialización es idéntico: `InfoselWidgets.init({ sdkManager })`. Los métodos tienen los mismos nombres y parámetros.
+
+---
+
+## Tipos de Cambios
+
+- **Added**: Nuevas funcionalidades
+- **Changed**: Cambios en funcionalidades existentes
+- **Deprecated**: Funcionalidades que serán removidas
+- **Removed**: Funcionalidades removidas
+- **Fixed**: Correcciones de bugs
+- **Security**: Mejoras de seguridad
+- **Developer Experience**: Mejoras en el proceso de desarrollo y publicación
+
+## Convenciones
+
+- Usar emojis para categorizar cambios
+- Mantener formato consistente
+- Incluir fechas de lanzamiento
+- Documentar breaking changes claramente
+- Agrupar cambios por tipo
+- Especificar compatibilidad con @infosel-sdk/core