@infosel-sdk/markets 1.2.4 → 2.0.0

package/CHANGELOG.md

@@ -5,6 +5,241 @@ 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).
 
+## [2.0.0] - 2025-01-06
+
+### Removed
+
+- 🗑️ **Migración de funcionalidades a @infosel-sdk/widgets**: Todas las funcionalidades relacionadas con widgets, workspaces e instruments han sido migradas al nuevo paquete @infosel-sdk/widgets para mejorar la separación de responsabilidades y mantenibilidad del código.
+
+#### Casos de Uso Eliminados (19 casos de uso)
+
+- 🎨 **createWidget**: Eliminado - Migrado a @infosel-sdk/widgets
+- 🔄 **duplicateWidget**: Eliminado - Migrado a @infosel-sdk/widgets
+- 🔧 **updateWidgetInstruments**: Eliminado - Migrado a @infosel-sdk/widgets
+- 📊 **updateWidgetChart**: Eliminado - Migrado a @infosel-sdk/widgets
+- 🗑️ **deleteWidget**: Eliminado - Migrado a @infosel-sdk/widgets
+- 🏢 **createWorkspace**: Eliminado - Migrado a @infosel-sdk/widgets
+- 🔄 **duplicateWorkspace**: Eliminado - Migrado a @infosel-sdk/widgets
+- 🔧 **updateWorkspace**: Eliminado - Migrado a @infosel-sdk/widgets
+- 🗑️ **deleteWorkspace**: Eliminado - Migrado a @infosel-sdk/widgets
+- 📋 **getWorkspace**: Eliminado - Migrado a @infosel-sdk/widgets
+- 📚 **getWorkspaces**: Eliminado - Migrado a @infosel-sdk/widgets
+- 👤 **getWorkspacesByUser**: Eliminado - Migrado a @infosel-sdk/widgets
+- 🏗️ **getWorkspacesByProjectId**: Eliminado - Migrado a @infosel-sdk/widgets
+- 👥 **getUserWorkspaces**: Eliminado - Migrado a @infosel-sdk/widgets
+- 👤 **getUserWidgets**: Eliminado - Migrado a @infosel-sdk/widgets
+- 📦 **getProjectWidgets**: Eliminado - Migrado a @infosel-sdk/widgets
+- ➕ **createInstrument**: Eliminado - Migrado a @infosel-sdk/widgets
+- 🗑️ **deleteInstrument**: Eliminado - Migrado a @infosel-sdk/widgets
+- 📊 **getInstruments**: Eliminado - Migrado a @infosel-sdk/widgets
+
+#### Métodos de Repository Eliminados
+
+- **MarketsRepository**: Removidos 18 métodos relacionados con widgets, workspaces e instruments:
+  - `createWidget()`, `duplicateWidget()`, `updateWidgetInstruments()`, `updateWidgetChart()`, `deleteWidget()`
+  - `createWorkspace()`, `updateWorkspace()`, `deleteWorkspace()`, `duplicateWorkspace()`
+  - `getWorkspace()`, `getWorkspaces()`, `getWorkspacesByUser()`, `getWorkspacesByProjectId()`, `getUserWorkspaces()`
+  - `getUserWidgets()`, `getProjectWidgets()`
+  - `createInstrument()`, `deleteInstrument()`, `getInstruments()`
+
+#### Métodos de Datasource Eliminados
+
+- **MarketsDatasource**: Removidos 18 métodos correspondientes a los del repository. Todas las implementaciones GraphQL relacionadas con widgets han sido eliminadas de `MarketsDatasourceImpl`.
+
+#### Métodos de Mapper Eliminados
+
+- **MarketsMapper**: Removidos 7 métodos de mapeo relacionados con widgets y workspaces:
+
+  - `mapWorkspaces()`: Mapeo de arrays de workspaces
+  - `mapWidgets()`: Mapeo de arrays de widgets
+  - `mapWidget()`: Mapeo individual de widgets con todas sus configuraciones
+  - `mapWidgetsContainer()`: Mapeo de contenedores de widgets organizados por workspace
+  - `mapInstrumentsContainer()`: Mapeo de contenedores de instrumentos organizados por widget
+  - `mapInstruments()`: Mapeo de arrays de instrumentos
+  - `mapTableColumns()`: Mapeo de columnas de tablas de widgets
+
+- **Métodos mantenidos en MarketsMapper**: Solo se mantienen `parseInstrumentFields()` y `mapInstrumentFields()` que son específicos para funcionalidades de markets.
+
+#### Entidades Eliminadas (24 entidades)
+
+- **Widgets**: `widget.ts`, `create_widget_request.ts`, `duplicate_widget_request.ts`, `update_widget_chart_request.ts`, `update_widget_instruments_reques.ts`
+- **Workspaces**: `workspace.ts`, `create_workspace_request.ts`, `update_workspace_request.ts`, `duplicate_workspace_request.ts`, `delete_workspace_request.ts`, `get_workspace_request.ts`, `get_workspaces_request.ts`, `get_workspaces_by_user_request.ts`, `get_user_workspaces_request.ts`
+- **Instruments**: `instrument.ts`, `create_instrument_request.ts`, `get_instruments_request.ts`
+- **Containers y Responses**: `workspaces_container.ts`, `project_widgets_container.ts`, `instruments_response.ts`, `user_widgets.ts`, `user_workspaces.ts`, `workspace_widgets.ts`
+- **Configuraciones**: `widget_layout_config.ts`, `news_configuration.ts`, `chart_configuration.ts`
+
+#### Configuración Eliminada
+
+- ⚙️ **widgetsUrl removido de InfoselMarketsModule**: El módulo ya no requiere ni acepta `widgetsUrl` en su configuración. Solo mantiene `marketsUrl` y `securitiesUrl` para operaciones HTTP.
+
+- 🔌 **GraphQlClient removido de MarketsDatasourceImpl**: `MarketsDatasourceImpl` ya no requiere `GraphQlClient` ya que todas las operaciones de widgets que usaban GraphQL han sido migradas. Ahora solo utiliza `HttpClient` para operaciones REST.
+
+- 📦 **WidgetModel removido de exports**: El modelo `WidgetModel` ya no se exporta desde el paquete markets.
+
+#### Tests Eliminados
+
+- 🧪 **Tests de casos de uso**: Eliminados 19 archivos de test correspondientes a los casos de uso migrados
+- 🧪 **Tests de mapper**: Eliminados tests de `mapWorkspaces`, `mapWidgets`, `mapWidget`, `mapWidgetsContainer`, `mapInstrumentsContainer`, `mapInstruments`, `mapTableColumns`
+- 🧪 **Tests de datasource**: Eliminados tests de todos los métodos GraphQL relacionados con widgets, workspaces e instruments
+- 🧪 **Tests de repository**: Eliminados tests de métodos relacionados con widgets, workspaces e instruments
+- 🧪 **Mocks actualizados**: Removidos métodos mock relacionados con funcionalidades migradas
+
+### Changed
+
+- 🔄 **Separación de responsabilidades**: Markets ahora se enfoca exclusivamente en funcionalidades de búsqueda y detalles de instrumentos financieros. El paquete ha sido simplificado para mantener solo:
+
+  - Búsqueda de instrumentos (`searchInstruments`)
+  - Obtención de campos de instrumentos (`getInstrumentFields`, `getInstrumentMultipleFields`)
+  - Detalles financieros de instrumentos (`getInstrumentDetailProfile`, `getInstrumentDetailFinancialReasons`, `getInstrumentDetailFinancialAnnual`, `getInstrumentDetailFinancialQuartely`, `getInstrumentReportFinancialReasons`)
+  - Datos de gráficos (`getChartData`)
+
+- ⚙️ **Configuración simplificada**: `InfoselMarketsModule` ahora solo requiere `marketsUrl` y `securitiesUrl` (eliminado `widgetsUrl`). La configuración es más simple y enfocada en operaciones HTTP REST.
+
+- 🏗️ **Arquitectura simplificada**: `MarketsDatasourceImpl` ahora solo utiliza `HttpClient` (eliminada dependencia de `GraphQlClient`). Todas las operaciones son peticiones HTTP REST a endpoints de markets y securities.
+
+- 📦 **Exports simplificados**: El archivo `index.ts` ya no exporta entidades, modelos o tipos relacionados con widgets. Solo exporta funcionalidades de markets.
+
+- 🧪 **Tests actualizados**: Todos los tests restantes han sido actualizados para reflejar la nueva estructura. Tests de `getInstrumentFields` y `searchInstruments` corregidos para usar `createMockMarketsRepository` en lugar de `createMockInstrumentRepository`.
+
+### Technical Details
+
+- **HTTP Client exclusivo**: Todas las operaciones ahora utilizan `HttpClient` para peticiones REST. No hay dependencia de GraphQL en el paquete markets.
+
+- **Endpoints mantenidos**:
+
+  - GET `/instruments/last` - Para obtener campos de instrumentos
+  - GET `/instruments` - Para búsqueda de instrumentos
+  - GET `/instruments/detail/profile` - Para perfil de instrumentos
+  - GET `/instruments/detail/financial/reasons` - Para razones financieras
+  - GET `/instruments/detail/financial/annual` - Para datos financieros anuales
+  - GET `/instruments/detail/financial/quarterly` - Para datos financieros trimestrales
+  - GET `/instruments/report/financial/reasons` - Para reportes financieros
+
+- **Arquitectura Clean mantenida**: Separación clara entre capas de dominio y datos. Dependency Inversion preservado.
+
+- **Type Safety**: TypeScript completo mantenido. Todas las interfaces y tipos actualizados para reflejar la nueva estructura.
+
+### Breaking Changes
+
+- ⚠️ **Funcionalidades de widgets removidas**: Si estás usando funcionalidades de widgets, workspaces o instruments desde @infosel-sdk/markets v1.x, deberás migrar a @infosel-sdk/widgets v1.0.0. Los métodos relacionados han sido completamente removidos y no están disponibles en esta versión.
+
+- ⚠️ **Configuración de módulo**: `InfoselMarketsModule` ya no acepta `widgetsUrl` en su constructor. Si estás pasando `widgetsUrl` en la configuración, deberás removerlo.
+
+- ⚠️ **Exports removidos**: Las siguientes entidades ya no están disponibles en el paquete:
+
+  - `Widget`, `Workspace`, `Instrument` (entidades principales)
+  - Todas las request entities de widgets/workspaces/instruments
+  - Todas las response entities de widgets/workspaces/instruments
+  - `WidgetModel`, `WorkspaceModel`, `InstrumentModel`
+  - `WorkspacesContainer`, `ProjectWidgetsContainer`, `InstrumentsResponse`
+
+- ⚠️ **MarketsMapper simplificado**: El mapper ahora solo expone `parseInstrumentFields()` y `mapInstrumentFields()`. Todos los métodos relacionados con widgets han sido removidos.
+
+### Migration Guide
+
+- 📚 **Migración a @infosel-sdk/widgets**: Para usar funcionalidades de widgets, workspaces o instruments, instala y usa el nuevo paquete:
+
+  ```typescript
+  // Antes (v1.x)
+  import InfoselMarkets from '@infosel-sdk/markets';
+  const marketsSDK = InfoselMarkets.init({ sdkManager });
+  await marketsSDK.createWidget({ ... });
+
+  // Después (v2.0.0)
+  import InfoselWidgets from '@infosel-sdk/widgets';
+  const widgetsSDK = InfoselWidgets.init({ sdkManager });
+  await widgetsSDK.createWidget({ ... });
+  ```
+
+- 🔄 **Configuración actualizada**: Remover `widgetsUrl` de la configuración de `InfoselMarketsModule`:
+
+  ```typescript
+  // Antes (v1.x)
+  const marketsModule = new InfoselMarketsModule({
+    marketsUrl: '...',
+    securitiesUrl: '...',
+    widgetsUrl: '...', // ❌ Ya no es necesario
+  });
+
+  // Después (v2.0.0)
+  const marketsModule = new InfoselMarketsModule({
+    marketsUrl: '...',
+    securitiesUrl: '...',
+  });
+  ```
+
+- 📦 **Imports actualizados**: Si estás importando entidades de widgets desde markets, actualiza los imports:
+
+  ```typescript
+  // Antes (v1.x)
+  import { Widget, Workspace } from '@infosel-sdk/markets';
+
+  // Después (v2.0.0)
+  import { Widget, Workspace } from '@infosel-sdk/widgets';
+  ```
+
+### Developer Experience
+
+- ✅ **Tests validados**: Todos los tests de markets pasan correctamente (14 test suites, 103 tests). La funcionalidad restante está completamente validada.
+
+- 📖 **Documentación actualizada**: README actualizado para reflejar solo las funcionalidades de markets (búsqueda y detalles de instrumentos).
+
+- 🔍 **TypeScript**: Tipado completo mantenido. Errores de compilación resueltos para reflejar la nueva estructura.
+
+### Compatibility
+
+- ✅ **@infosel-sdk/core**: Compatible con versión ^0.0.5 o superior
+- ✅ **Funcionalidades de markets**: Todas las funcionalidades de búsqueda y detalles de instrumentos mantienen la misma API
+- ⚠️ **Funcionalidades de widgets**: Requieren migración a @infosel-sdk/widgets v1.0.0
+
+## [1.2.6] - 2025-11-27
+
+### Added
+
+- 🆕 Agregar nuevos campos en last
+  - `tipoRendimiento`,
+  - `tipoIndice`,
+- 🆕 **Nueva entidad GetLastRequest**: Entidad de dominio para solicitudes de datos de instrumentos
+  - `instrumentKey: string` - Clave única del instrumento (requerido)
+  - `useCache?: boolean` - Indica si se debe usar caché en la petición (opcional)
+- 🔍 **Nuevo método getInstrumentMultipleFields**: Funcionalidad para obtener múltiples campos de instrumentos en una sola petición
+  - Implementado en `MarketsDatasource.getInstrumentMultipleFields()` con petición GET a `/instruments/last`
+  - Implementado en `MarketsRepository.getInstrumentMultipleFields()` para acceso desde la capa de repositorio
+  - Nuevo use case `GetInstrumentMultipleFieldsUseCase` para encapsular la lógica de negocio
+  - Retorna `Promise<InstrumentFields[]>` - Array de objetos InstrumentFields con todos los instrumentos encontrados
+  - Soporta parámetros `instrumentKey` y `useCache` opcionales mediante `GetLastRequest`
+
+### Changed
+
+- 🔄 **Actualización de getInstrumentFields**: Ahora utiliza la entidad `GetLastRequest` en lugar de un string simple
+  - `MarketsDatasource.getInstrumentFields()` ahora acepta `GetLastRequest` como parámetro
+  - Soporte para parámetro opcional `useCache` en la petición
+  - Mantiene compatibilidad con la misma lógica de mapeo y validación
+
+### Technical Details
+
+- **Endpoint utilizado**: GET `/instruments/last` con parámetros query `instrumentKey` y `useCache`
+- **Mapeo de datos**: Utiliza `MarketsMapper.mapInstrumentFields()` para convertir modelos a entidades de dominio
+- **Filtrado de parámetros**: Elimina automáticamente parámetros `undefined` antes de enviar la petición HTTP
+
+## [1.2.5] - 2025-11-11
+
+### Added
+
+- 🆕 Agregar nuevos campos en last
+  - `estado`
+  - `sector`
+  - `tendencia`
+  - `muestra`,
+  - `tipoRendimiento`,
+  - `tipoIndice`,
+- 🆕 **Campo descripcionMercado en InstrumentFields**: El modelo, entidad de dominio y mapper ahora exponen la descripción del mercado asociada al instrumento.
+- 🧪 **Cobertura de pruebas actualizada**: Fixtures y expectativas se actualizaron para validar el nuevo campo en datasources, mappers y casos de uso.
+
+### Changed
+
+- ⚙️ **Mapeo de InstrumentFields**: El mapper asigna valores por defecto seguros para `descripcionMercado`, garantizando compatibilidad con datos incompletos.
+
 ## [1.2.4] - 2025-10-08
 
 ### Added