Changed #

• 🔧 Configuración de API - Refactorización completa para eliminar depender de variables de entorno internas (.env).
• 🌐 Parámetro apiUrl - Nuevo parámetro requerido en initialize() para especificar la URL de la API.
• 🧹 Limpieza - Eliminado parámetro useSandbox y la clase interna EnvConfig.

Changed #

• 🔧 Configuración de API - Agregado soporte para cambiar entre entorno sandbox y producción mediante el parámetro useSandbox en TraderPalSDK.initialize()
• 🌐 Gestión de URLs - Mejorada la gestión dinámica de URLs de API basada en variables de entorno (API_URL para producción, API_URL_DEBUG para sandbox)
• 🔄 Reinicialización de Cliente API - El ApiClient ahora se reinicializa automáticamente cuando cambia la URL base
• 📝 Documentación de Variables de Entorno - Documentación completa de todas las variables de entorno necesarias (PARTNER_EMAIL, PARTNER_PASSWORD, PARTNER_API_KEY, TRADERPAL_FOOTPRINT_TOKEN, TRADERPAL_TOKEN)
• 📚 Documentación de Obtención de Tokens - Agregadas guías completas para obtener tokens usando la clase Connect o manualmente
• 🔐 Documentación de Footprint SDK - Agregada documentación completa sobre cómo integrar Footprint SDK para el proceso de onboarding

Fixed #

• ✅ Selección de Entorno - Corregido el problema donde el SDK no respetaba el parámetro useSandbox correctamente
• 🐛 Inicialización de Cliente - Asegurado que el cliente API siempre use la URL correcta antes de cada petición HTTP
• 📖 Clarificación de MODE - Aclarado que la variable MODE solo es necesaria para la clase Connect del ejemplo, no para el SDK principal que usa useSandbox

Removed #

• 🧹 Logs de Depuración - Eliminados logs excesivos de depuración, manteniendo solo los esenciales

Documentation #

• 📝 Actualizado README con información completa sobre el parámetro useSandbox
• 📖 Agregada documentación sobre variables de entorno y su uso
• 📚 Agregada guía completa de obtención de tokens (Opción 1: Connect, Opción 2: Manual)
• 🔐 Agregada documentación de integración con Footprint SDK para onboarding
• 📋 Actualizado env.example con comentarios explicativos sobre cada variable
• 🔍 Aclarada la diferencia entre MODE (solo para Connect) y useSandbox (para SDK principal)

Changed #

• 🔧 Configuración de API - Agregado soporte para cambiar entre entorno sandbox y producción mediante el parámetro useSandbox en TraderPalSDK.initialize()
• 🌐 Gestión de URLs - Mejorada la gestión dinámica de URLs de API basada en variables de entorno (API_URL para producción, API_URL_DEBUG para sandbox)
• 🔄 Reinicialización de Cliente API - El ApiClient ahora se reinicializa automáticamente cuando cambia la URL base

Fixed #

• ✅ Selección de Entorno - Corregido el problema donde el SDK no respetaba el parámetro useSandbox correctamente
• 🐛 Inicialización de Cliente - Asegurado que el cliente API siempre use la URL correcta antes de cada petición HTTP

Removed #

• 🧹 Logs de Depuración - Eliminados logs excesivos de depuración, manteniendo solo los esenciales

Documentation #

• 📝 Actualizado README con información sobre el parámetro useSandbox

Changed #

• 🔧 Compatibilidad de Versiones - Ajustadas dependencias para compatibilidad con Flutter 3.27.1 (Dart 3.6.0)
  • google_fonts: ^6.3.2 → ^6.2.0
  • flutter_svg: ^2.2.1 → ^2.1.0
  • syncfusion_flutter_charts: ^31.1.25 → ^29.1.38
• 📦 Configuración de SDK - Actualizado environment para soportar Flutter >=3.24.0 y Dart >=3.4.0 <4.0.0
• 🛠️ Proyecto Example - Configurado para usar Flutter 3.27.1 específicamente con FVM

Fixed #

• ✅ Compatibilidad con Cliente - SDK ahora es completamente compatible con Flutter 3.27.1 y preparado para Flutter 3.35+

Documentation #

• 📝 Actualizado README con información de versiones probadas y requisitos de plataforma
• 📖 Agregadas instrucciones de uso de FVM en el README del ejemplo

Added #

• 🚀 Beta Release - First beta release of TraderPal Connect SDK for early testing and feedback
• ⚠️ Beta Notice - This is a beta version. Some features may be incomplete or subject to change

Features #

• TraderPalSDK.initialize() - Main SDK initialization method
• Responsive Design - Beautiful UI that works on all screen sizes
• Error Recovery - Retry mechanisms and support contact options

Security #

• 🔒 Triple Protection - Token validation, JWT verification, and enabled field check
• 🛡️ Secure API Calls - All requests include authentication headers
• 🔑 Token-based Access - No hardcoded credentials, all access via JWT tokens

Dependencies #

• dio: ^5.4.0 - HTTP client for API calls
• flutter_dotenv: ^5.1.0 - Environment variable management
• flutter_svg: ^2.2.1 - SVG icon support
• google_fonts: ^6.3.2 - Typography support

Example Usage #

// Initialize the SDK
TraderPalSDK.initialize(
  token: "your_jwt_token_here",
  context: context,
  onComplete: () => print("SDK initialized"),
  onCancel: () => print("User cancelled"),
  onError: (error) => print("Error: $error"),
);

Breaking Changes #

• None (beta release)

Migration Guide #

• None (beta release)

Beta Features #

• 🔄 Mock API Integration - Currently uses mock data for testing
• 🧪 Testing Environment - Designed for early feedback and testing
• 📝 API Integration Pending - Real API endpoints will be integrated in stable release