Changelog

All notable changes to the Billoget Development Center will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.1.5] - 2025-01-07​

🔧 Patch Release - Code Editor Theme Improvements​

🎨 UI/UX Improvements​

• Code Editor Theme Support: Fixed code preview component to work properly in both light and dark themes
• Syntax Highlighting: Implemented proper syntax highlighting with distinct colors for different code elements
• Theme-Aware Styling: Added CSS variables for dynamic theme adaptation
• Contrast Improvements: Fixed poor visibility issues in light mode
• Responsive Design: Enhanced code blocks for better mobile experience

🐛 Bug Fixes​

• Light Theme Visibility: Resolved poor text contrast in light mode
• Dark Theme Elements: Fixed white/blank elements appearing in dark mode
• Syntax Colors: Added proper color coding for comments, keywords, strings, and properties
• Border Styling: Improved border contrast for better visual separation

🔧 Technical Improvements​

• CodePreview Component: Created dedicated component with better structure
• CSS Variables: Implemented theme-aware CSS custom properties
• Performance: Optimized rendering with better component organization

[1.1.4] - 2025-01-07​

🔧 Patch Release - Documentation Links Update​

🔗 Documentation Updates​

• Postman Links: Updated all GitHub repository links to point to interactive Postman documentation
• Enhanced Developer Experience: Replaced static file links with interactive API documentation
• Better Accessibility: Direct access to Postman collection with "Run in Postman" functionality
• Simplified Workflow: Developers can now test endpoints directly from documentation

📚 Updated Sections​

• Blog Post: API v1.1.0 release announcement with new Postman links
• Postman Collection Guide: Updated with interactive documentation access
• API Overview: Quick start section with new Postman links
• Getting Started: Updated resources section
• Introduction Page: Support and resources with new links

🌐 New Documentation URL​

All links now point to: https://documenter.getpostman.com/view/46531233/2sB34cp2rJ

[1.1.3] - 2025-01-07​

🔧 Patch Release - API v1.1.0 Changelog Blog Post​

📝 New Content​

• API v1.1.0 Release Blog Post: Comprehensive changelog post announcing all new features
  • Detailed documentation of UBS (Unified Budgeting Standard)
  • Budget approval system overview with examples
  • Enhanced customer fields (DNI, CUIT) documentation
  • Product variants support with code examples
  • Migration guide from v1.0.0 to v1.1.0
  • Use cases and business scenarios
  • Links to updated Postman collection v1.1.0

🏷️ Blog Infrastructure​

• New Author: Added Billoget Development Team author profile
• New Tags: Added API-related tags (api, release, changelog, ubs, budget-approvals)
• Enhanced Navigation: Blog posts now properly categorized and searchable

📚 Documentation Updates​

• Comprehensive Feature Coverage: All v1.1.0 features documented with examples
• Developer-Friendly Format: Code snippets and practical examples
• Migration Assistance: Step-by-step upgrade instructions
• Community Links: Added links to GitHub discussions and support

[1.1.2] - 2025-07-06​

🔧 Patch Release - API Version Update​

📦 Updates​

• API Version Update: Actualizada documentación para reflejar API pública v1.1.0
  • Actualizado README con versión v1.1.0
  • Actualizada documentación de Postman Collection a v1.1.0
  • Corregidas referencias de versión en toda la documentación
  • Enlaces actualizados para apuntar a colección v1.1.0

🔗 Links Updated​

• Postman Collection: Referencias actualizadas a billoget-public-api-1.1.0.postman-collection.json
• Documentation: Todas las guías ahora referencian la versión correcta
• Version Badges: Badges actualizados en README

🐛 Bug Fixes​

• Broken Links: Corregidos enlaces rotos en landing page
  • Actualizado enlace de autenticación a /docs/intro
  • Actualizado enlace de webhooks a /docs/api/webhooks
  • Corregidos enlaces de features para apuntar a páginas existentes

[1.1.1] - 2025-07-06​

🔧 Patch Release - Node.js SDK Documentation​

📦 New Features​

• Node.js SDK Documentation: Añadida documentación completa del SDK oficial de TypeScript
  • Guía de instalación con npm install billoget-sdk
  • Ejemplos de uso para todos los endpoints (Budgets, Customers, Products, Webhooks)
  • Documentación completa de TypeScript con interfaces y tipos
  • Mejores prácticas y patrones de manejo de errores
  • Guías de migración desde REST API directo
  • Troubleshooting y solución de problemas comunes
• Navigation Updates: Añadido enlace al SDK en sidebar y página principal
• Quick Access: Nueva card en página de inicio para acceso rápido al SDK

🔧 Improvements​

• Code Examples: Actualizados ejemplos con sintaxis del SDK oficial
• Documentation Structure: Mejorada organización con sección dedicada al SDK
• User Experience: Mejor flujo de navegación entre documentación de API y SDK
• Cross-References: Enlaces entre documentación de API REST y SDK

🔗 SDK Integration​

• Version Sync: Documentación sincronizada con billoget-sdk v1.0.0
• NPM Links: Referencias directas al paquete en NPM
• GitHub Integration: Enlaces al repositorio oficial del SDK
• Live Examples: Ejemplos ejecutables con el SDK

[1.1.0] - 2025-07-06​

✨ Minor Release​

🆕 New Features​

• [Add new features here]

🔧 Improvements​

• [Add improvements here]

🐛 Bug Fixes​

• [Add bug fixes here]

[1.0.3] - 2025-07-06​

🔧 Patch Release​

🐛 Bug Fixes​

• [Add bug fixes here]

🔧 Improvements​

• [Add minor improvements here]

[1.0.2] - 2025-07-06​

🔧 Patch Release​

🐛 Bug Fixes​

• Fixed authentication endpoint to use correct API path /v1/auth/login
• Fixed authentication response structure to match production API
• Resolved "error de autenticación" issue with successful 201 responses
• Updated logout endpoint to /v1/auth/logout for consistency

🔧 Improvements​

• Updated AuthResponse interface to handle real API structure:
  • access_token instead of nested data.token
  • user.displayName mapped to name for UI consistency
  • user.avatarUrl mapped to avatar for profile display
• Enhanced user data handling with proper localStorage storage
• Improved API service alignment with production endpoints
• Enhanced authentication flow reliability

📊 API Response Structure​

// Real API Response (201 Created)
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "user": {
    "id": 1,
    "email": "user@example.com",
    "displayName": "User Name",
    "avatarUrl": "https://...",
    "businessId": 6,
    "role": "admin",
    "emailVerified": true
  }
}

[1.0.1] - 2024-01-16​

🔌 API Integration Release​

¡Integración completa con endpoints reales de Billoget!

✨ Added​

🔐 Autenticación Real​

• Login con API real - Conecta con /v1/auth/login
• Manejo de tokens JWT para sesiones seguras
• Persistencia de sesión con localStorage
• Logout seguro con limpieza de tokens
• Fallback a modo demo para desarrollo

📊 Dashboard con Datos Reales​

• Estadísticas en vivo desde /api/developer/dashboard/stats
• Métricas actualizadas en tiempo real
• Actividad reciente con datos reales
• Gráficos dinámicos basados en uso real

🔑 Gestión Real de API Keys​

• CRUD completo via /api/developer/api-keys
• Creación de keys con scopes personalizados
• Monitoreo de uso en tiempo real
• Estadísticas detalladas de requests
• Regeneración y revocación de keys

🔗 Integraciones en Vivo​

• Datos reales desde /api/developer/integrations
• Estado de conexiones actualizado
• Historial de sincronizaciones real
• Gestión de configuraciones por integración
• Estadísticas de rendimiento en vivo

📡 Webhooks Funcionales​

• Gestión completa via /api/developer/webhooks
• Pruebas en tiempo real de endpoints
• Estadísticas de entrega actualizadas
• Configuración de eventos dinámica
• Monitoreo de respuestas en vivo

🛠️ Technical Improvements​

🔧 API Service​

• Servicio centralizado (src/services/api.ts)
• Manejo de errores robusto
• Retry logic para requests fallidos
• Rate limiting awareness
• TypeScript interfaces completas

🎯 Endpoints Integrados​

// Autenticación
POST /v1/auth/login
POST /v1/auth/logout

// Dashboard
GET /api/developer/dashboard/stats

// API Keys
GET /api/developer/api-keys
POST /api/developer/api-keys
PUT /api/developer/api-keys/:id
DELETE /api/developer/api-keys/:id

// Integraciones
GET /api/developer/integrations
POST /api/developer/integrations
PUT /api/developer/integrations/:id
DELETE /api/developer/integrations/:id

// Webhooks
GET /api/developer/webhooks
POST /api/developer/webhooks
PUT /api/developer/webhooks/:id
DELETE /api/developer/webhooks/:id
POST /api/developer/webhooks/:id/test

📝 Documentation Updates​

🔄 Version Corrections​

• API version actualizada de v1.4.0 → v1.0.0
• Postman collection links corregidos
• Documentación sincronizada con versión real
• README actualizado con nuevas funcionalidades

🎨 UX Improvements​

🔄 Loading States​

• Spinners en todas las operaciones async
• Feedback visual para acciones del usuario
• Estados de error informativos
• Mensajes de éxito claros

🛡️ Error Handling​

• Manejo graceful de errores de red
• Fallback automático a modo demo
• Mensajes de error user-friendly
• Logging detallado para debugging

🔒 Security Enhancements​

🔐 Authentication​

• JWT tokens seguros
• Refresh logic automático
• Session timeout configurable
• Secure storage de credenciales

🔑 API Security​

• Bearer token authentication
• Request validation completa
• Rate limiting respect
• CORS handling adecuado

🚀 Performance​

⚡ Optimizations​

• Lazy loading de datos
• Caching inteligente
• Debounced requests para búsquedas
• Batch operations donde sea posible

📊 Monitoring​

• Response time tracking
• Error rate monitoring
• Usage analytics integrados
• Performance metrics en dashboard

🎯 Developer Experience​

🔧 Development Mode​

• Hot reload con datos reales
• Mock data fallback automático
• Environment switching fácil
• Debug logging detallado

📚 Enhanced Documentation​

• API examples actualizados
• Integration guides mejoradas
• Troubleshooting expandido
• Best practices documentadas

🐛 Bug Fixes​

🔧 Fixes​

• Memory leaks en componentes
• State management mejorado
• Event listeners cleanup
• CSS responsive issues

🔮 Coming Next (v1.1.0)​

🚀 Planned Features​

• Real-time notifications via WebSocket
• Bulk operations para API keys
• Advanced analytics con gráficos
• Team collaboration features
• Audit logs completos
• Custom integrations builder

[1.0.0] - 2024-01-16​

🎉 Initial Release​

Este es el primer release completo del Billoget Development Center, una plataforma integral para desarrolladores que integran con la API de Billoget.

✨ Added​

📚 Documentación Completa​

• API Reference completa con todos los endpoints públicos
• Getting Started Guide detallada con ejemplos
• Postman Collection Guide con instrucciones paso a paso
• Webhooks Documentation con ejemplos de implementación
• Authentication Guide con mejores prácticas
• Rate Limiting Guide con estrategias de optimización
• Error Handling Guide con códigos y soluciones

🎛️ Developer Dashboard​

• 🔐 Sistema de autenticación con login persistente
• 📊 Dashboard de resumen con métricas clave
• 🔑 Gestión de API Keys completa
  • Crear nuevas API keys con scopes personalizados
  • Monitorear uso en tiempo real
  • Configurar rate limits específicos
  • Ver estadísticas detalladas de requests
  • Revocar o regenerar keys
• 🔗 Gestión de Integraciones
  • Conectar servicios externos (Shopify, CRM, etc.)
  • Monitorear estado de conexiones
  • Ver historial de sincronizaciones
  • Agregar nuevas integraciones
• 📡 Gestión de Webhooks
  • Configurar endpoints de webhooks
  • Probar entrega de webhooks en vivo
  • Lista de eventos disponibles
  • Configuración de seguridad HMAC

🎨 Diseño y UX​

• 🎨 Branding oficial de Billoget con colores corporativos
• 📱 Diseño completamente responsivo (desktop, tablet, mobile)
• ✨ Animaciones y efectos modernos
• 🖼️ Logo oficial integrado en toda la plataforma
• 🌗 Soporte para modo oscuro
• ⚡ Carga rápida y optimizada

📖 Documentación API​

• 📋 Budgets API - Documentación completa con ejemplos
  • List, Get, Create, Update, Delete operations
  • Filtros avanzados y paginación
  • Ejemplos de request/response
  • Códigos de error y soluciones
• 👥 Customers API - Gestión de clientes
• 📦 Products API - Catálogo de productos
• 🔗 Webhooks API - Notificaciones en tiempo real

🛠️ Características Técnicas​

• ⚛️ React + TypeScript para type safety
• 📦 Docusaurus 3.8.1 como framework base
• 🎨 CSS modular con variables de Billoget
• 📱 Mobile-first design approach
• 🔄 Estados de loading realistas
• ❌ Manejo de errores consistente
• 💾 Persistencia de datos con localStorage

📋 Postman Collection​

• 📥 Colección completa v1.0.0 con todos los endpoints
• 🔧 Variables pre-configuradas (base_url, api_key)
• 🧪 Tests automáticos en cada request
• 📊 Monitoreo de rate limits integrado
• 📝 Documentación detallada por endpoint
• 🔍 Ejemplos de troubleshooting

🌐 Multiidioma​

• 🇺🇸 Inglés como idioma principal
• 🇪🇸 Español como idioma secundario
• 🔄 Navegación adaptada por idioma

🔗 Integraciones​

• 📡 GitHub para versionado y colaboración
• 🚀 Deploy automático con CI/CD
• 📊 Analytics de uso de documentación
• 🔍 Búsqueda avanzada en documentación

¿Encontraste un bug o tienes una sugerencia? Reporta un issue o contáctanos en developers@billoget.com