betuko_offline_sync

🐛 Corrección: ApiClient reintentaba requests cuando no hay internet

Síntoma: Al estar sin conexión, el ApiClient hacía hasta 3 intentos con esperas de 2 s y 4 s (total ≥ 6 s por request) para errores como Failed host lookup o Network is unreachable. Esto generaba futures pendientes que saturaban el canal de plataforma de Flutter y podían causar ANR en Android.

Causa raíz: La lógica de retry en _executeWithRetry() trataba todos los errores de red por igual. failed host lookup no es un error transitorio — indica que no hay internet y reintentar es inútil.

Solución: Se añade detección de isNoInternet (errores DNS y red no disponible). Cuando se detecta este tipo de error, el ciclo de retry aborta de inmediato igual que si se hubieran agotado los intentos.

🐛 Corrección: ConnectivityService se inicializaba dos veces en paralelo

Síntoma: Al arrancar la app, los logs mostraban 🔌 [Connectivity] Inicializando servicio global... dos veces, seguido de dos emisiones 📡 Emitiendo cambio: true. Esto podía provocar que el AutoSync intentara un sync extra justo después de que el sync de cold_start terminara.

Causa raíz: Race condition en initializeGlobal(). El guard if (_globalIsInitialized) return se comprueba antes de cualquier await, pero _globalIsInitialized = true se escribe después de varios awaits. Dos llamadas en paralelo pasaban el guard simultáneamente (ambas veían _globalIsInitialized = false) y ambas completaban la inicialización.

Solución: Se introdujo un Completer<void>? _globalInitCompleter estático. La primera llamada crea el Completer y procede. Cualquier llamada posterior que llegue mientras la inicialización está en curso espera el mismo Future en lugar de correr en paralelo. Resultado: la init corre exactamente una vez, se emite exactamente un evento online=true al arrancar y el AutoSync no dispara un sync innecesario.

🐛 Corrección: managers sin endpoint se reintentaban inútilmente

Síntoma: Al llamar syncAll(retryFailed: true), managers sin endpoint configurado (auth, user_profile, etc.) aparecían como fallos reales y se reintentaban 2 veces con backoff (≈ 27 s perdidos por sync manual), apareciendo además en el panel de catálogos fallidos de la UI.

Causa raíz 1 — SyncService.sync(): cuando endpoint == null, el método salía con return sin cambiar el status (SyncStatus.idle) ni guardar el error. Al leerlo en syncAll(), status != SyncStatus.success → se interpretaba como fallo de red.

Causa raíz 2 — bloque retry en syncAll(): el filtro de managers a reintentar no excluía los que tenían error benigno "sin endpoint".

Solución:

• SyncService.sync() ahora llama _updateStatus(SyncStatus.error) y guarda _lastSyncError = SyncService.noEndpointErrorMessage cuando endpoint == null.
• SyncService.noEndpointErrorMessage es una constante pública ('Sin endpoint configurado') para que los consumidores puedan filtrar por ella.
• OnlineOfflineManager.syncAll() filtra del retry cualquier manager cuyo SyncResult.error == SyncService.noEndpointErrorMessage.

Impacto: cero cambios en la API pública; managers sin endpoint siguen reportando SyncResult(success: false, error: 'Sin endpoint configurado') — el mismo valor que ya filtraba la app con _isBenignNoEndpointSyncMessage.

📖 Documentación

• README actualizado con todas las nuevas funciones de v3.4.0: syncAll() con parámetros opcionales, SyncResult.itemCount, SyncRunRecord y historial de sync.
• Versión de instalación actualizada a ^3.4.0.

✨ Sync confiable: resultado real por catálogo + auditoría + retry

Esta versión corrige el problema raíz por el que syncAll() siempre reportaba éxito aunque un catálogo hubiera fallado, y agrega historial de sync consultable.

🐛 Corrección: syncAll() reportaba éxito aunque fallara

Problema: SyncService.sync() capturaba cualquier error internamente sin relanzarlo, por lo que syncAll() siempre construía SyncResult(success: true) sin importar lo que ocurriera en la red.

Solución: SyncService ahora guarda el error y el conteo de registros internamente. syncAll() lee el estado real después de llamar a sync() y construye SyncResult con success real.

✨ Nuevos getters en SyncService

String? get lastSyncError    // null si el último sync fue exitoso
int get lastDownloadCount    // registros descargados en el último sync OK

✨ SyncResult con conteo de registros

Nuevo campo opcional itemCount — backward-compatible, código existente no se afecta:

class SyncResult {
  final bool success;
  final String? error;
  final int? itemCount; // ← NUEVO: registros descargados del servidor
}

✨ syncAll() con retry y progreso opcionales

Tres nuevos parámetros opcionales con defaults — llamadas sin parámetros funcionan exactamente igual:

await OnlineOfflineManager.syncAll(
  retryFailed: true,       // reintenta managers fallidos (default: false)
  retryAttempts: 2,        // intentos extra con backoff 3s/6s (default: 2)
  trigger: 'manual',       // etiqueta para auditoría (default: 'auto')
  onProgress: (box, ok, count) {
    print('$box: ${ok ? "✓ $count registros" : "✗ error"}');
  },
);

Nota: ApiClient ya tenía retry HTTP interno (3 intentos, backoff 2s/4s/6s). Este retry es de nivel superior — reintenta el manager completo si falló tras los reintentos HTTP.

✨ CacheManager: historial de sync runs

Nueva clase SyncRunRecord y cuatro nuevos métodos. El historial se guarda en el box _cache_metadata ya existente (sin box adicional) y se limita a 50 registros:

// Nuevo modelo
class SyncRunRecord {
  final String boxName;
  final DateTime startedAt;
  final DateTime finishedAt;
  final bool success;
  final int itemCount;
  final String? error;
  final String trigger; // 'manual' | 'auto' | 'reconnect'
  int get durationMs;
}

// Nuevos métodos
await CacheManager.saveSyncRun(record);
await CacheManager.getLastSyncRun('concepts');   // → SyncRunRecord?
await CacheManager.getRecentSyncRuns(limit: 50); // → List<SyncRunRecord>
await CacheManager.clearOldSyncRuns(keepLast: 50);

syncAll() llama saveSyncRun() automáticamente al terminar cada manager — no requiere ningún cambio en el código de la app.

✅ Backward compatibility total

• sync() no lanza excepciones (mismo comportamiento que antes)
• syncAll() sin parámetros: idéntico al anterior
• SyncResult.success y SyncResult.error: mismos tipos
• CacheManager.getLastSyncTime() / updateLastSyncTime(): intactos
• Ninguna app existente necesita cambios

🐛 Corrección de Bug Crítico

Prevención de Doble POST al Reconectar

Se corrigió un problema donde al volver de offline a online, a veces se ejecutaban múltiples sincronizaciones simultáneas causando doble POST de los mismos datos.

Cambios implementados:

1. Protección en syncAll(): Se agregó un flag _isSyncingAll para prevenir múltiples ejecuciones simultáneas de syncAll(). Ahora si se llama desde diferentes lugares al mismo tiempo (reconexión automática, WorkManager, llamada manual), solo se ejecuta una vez.

2. Protección en _handleReconnection(): Ya existía un flag _isHandlingReconnection, pero ahora está mejor documentado y garantiza que solo una reconexión se procese a la vez.

3. WorkManager con ExistingWorkPolicy.replace: Se aseguró que syncWhenConnected() use un nombre fijo y reemplace tareas existentes en lugar de crear múltiples tareas duplicadas.

Resultado: Ahora hay protección en 3 niveles para evitar ejecuciones simultáneas y garantizar que cada dato se sincronice solo una vez.

✨ Nuevas Características

Control de Upload (POST) por Manager

Ahora puedes controlar qué managers hacen POST (subida) y cuáles solo hacen GET (descarga):

// Manager con POST habilitado (sube y descarga)
final asistencias = OnlineOfflineManager(
  boxName: 'asistencias',
  endpoint: 'processes/payroll/daily-capture',
  uploadEnabled: true, // ✅ Permite POST
);

// Manager solo lectura (solo descarga, no sube)
final catalogos = OnlineOfflineManager(
  boxName: 'catalogos',
  endpoint: 'catalogs/items',
  uploadEnabled: false, // ❌ Solo GET
);

Valor por defecto: uploadEnabled: false (solo GET por defecto)

Mejoras en Background Sync

• Inicialización automática de ConnectivityService en background
• Mejor manejo de errores: Los errores de POST ya no se silencian, se propagan correctamente
• Logs mejorados: Uso de developer.log() para que aparezcan en logcat incluso con la app cerrada
• Detección automática: Si el boxName contiene "asistencia" o "attendance", se habilita uploadEnabled: true automáticamente en background

Mejoras en Manejo de Errores

• Los errores de POST ahora se propagan correctamente en lugar de silenciarse
• Logs detallados para cada registro que se intenta enviar
• Contadores de éxitos/fallos en sincronización
• Mejor información de errores en los resultados

📚 Documentación

• Nuevo archivo WORKMANAGER_SETUP.md con guía completa de configuración
• Documentación detallada de permisos Android requeridos
• Guía de troubleshooting para problemas comunes
• Ejemplos completos de uso

🔧 Cambios Técnicos

• OnlineOfflineManager ahora acepta parámetro uploadEnabled (default: false)
• SyncService respeta uploadEnabled y omite upload si es false
• BackgroundSyncService guarda y restaura uploadEnabled en SharedPreferences
• Mejora en logs de ApiClient usando developer.log() para background

🐛 Corrección de Bug

Verificación de conexión más robusta

• Se agregaron múltiples endpoints de verificación para redes que bloquean Google/Cloudflare
• Ahora usa la API del usuario como primer endpoint de verificación
• Timeouts más largos para conexiones lentas

Endpoints de verificación (en orden):

1. API del usuario (baseUrl configurado)
2. Google connectivity check (gstatic)
3. Google generate_204
4. Apple captive portal
5. Cloudflare 1.1.1.1
6. Google DNS

🐛 Corrección de Bug

Sincronización más confiable al reconectar

Se corrigió un problema donde la sincronización al reconectar fallaba porque connectivity_plus detectaba la conexión antes de que estuviera realmente disponible.

✨ Mejoras

Verificación de conexión real

• Nuevo método ConnectivityService.hasRealConnection() que hace un ping HTTP real para verificar conectividad
• Se usa Google's generate_204 endpoint con fallback a Cloudflare

Delay configurable antes de sincronizar

• Nuevo parámetro reconnectDelaySeconds en GlobalConfig.init() (default: 3 segundos)
• Permite que la conexión se estabilice antes de intentar sincronizar

Verificación opcional de conexión real

• Nuevo parámetro verifyRealConnection en GlobalConfig.init() (default: true)
• Si la verificación falla, reintenta una vez más antes de cancelar

📖 Uso

// Configuración por defecto (recomendada)
await GlobalConfig.init(
  baseUrl: 'https://api.com',
  token: 'tu-token',
);

// Personalizar el comportamiento de reconexión
await GlobalConfig.init(
  baseUrl: 'https://api.com',
  token: 'tu-token',
  reconnectDelaySeconds: 5,     // Esperar 5 segundos (default: 3)
  verifyRealConnection: true,   // Verificar conexión real (default: true)
);

📝 Logs mejorados

Ahora se muestra información clara sobre el proceso de reconexión:

🔄 Auto-sync: conexión detectada, esperando 3s para estabilizar...
🔍 Verificando conexión real...
✅ Conexión real verificada
🔄 Auto-sync: conexión recuperada, sincronizando...

✨ Nueva Característica Principal

🌙 Background Sync con WorkManager (Android)

Ahora puedes sincronizar datos incluso cuando la app está completamente cerrada usando WorkManager.

Características:

• Sincronización Periódica: Cada 15 minutos (mínimo permitido por Android)
• Sincronización al Reconectar: Se ejecuta automáticamente cuando hay conexión disponible
• Persistencia de Configuración: La configuración se guarda en SharedPreferences para el background isolate
• Fácil Integración: Solo requiere llamar a BackgroundSyncService.initialize()

Uso Básico:

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // Configurar con background sync habilitado
  await GlobalConfig.init(
    baseUrl: 'https://api.com',
    token: 'tu-token',
    enableBackgroundSync: true,
  );
  
  // Inicializar WorkManager
  await BackgroundSyncService.initialize();
  
  // Crear y registrar managers
  final reportes = OnlineOfflineManager(
    boxName: 'reportes',
    endpoint: '/api/reportes',
  );
  await BackgroundSyncService.registerManager(reportes);
  
  // Iniciar sync periódico
  await BackgroundSyncService.startPeriodicSync();
  
  runApp(MyApp());
}

🆕 Nuevas Clases y Métodos

BackgroundSyncService

GlobalConfig Actualizado

• init() ahora es async y acepta enableBackgroundSync
• Nuevo método initSync() para inicialización síncrona
• Nuevo método saveForBackgroundSync()
• Nuevo método loadFromPrefs()
• updateToken() ahora es async y actualiza SharedPreferences

📦 Nuevas Dependencias

• workmanager: ^0.9.0+3 - Para tareas en background
• shared_preferences: ^2.2.2 - Para persistir configuración

📝 Configuración Android Requerida

Agregar en android/app/src/main/AndroidManifest.xml:

<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>

⚠️ Limitaciones

• Solo Android: iOS tiene restricciones más estrictas para background tasks
• Intervalo mínimo: 15 minutos (limitación de Android WorkManager)
• Batería: Android puede demorar la ejecución para optimizar batería

📚 Documentación

• README.md actualizado con sección completa de Background Sync
• Ejemplos de configuración y uso
• Notas sobre logout y limpieza

✨ Nuevas Características

Sincronización Automática

• Sincronización Periódica: Se ejecuta automáticamente cada 10 minutos cuando hay conexión a internet
• Sincronización al Reconectar: Se ejecuta automáticamente cuando se detecta que la conexión a internet se ha restaurado (de offline a online)
• Sin Configuración Necesaria: Funciona automáticamente una vez que se crea el primer OnlineOfflineManager
• Intervalo Configurable: El intervalo de sincronización se puede ajustar en GlobalConfig.syncMinutes (por defecto 10 minutos)

Detalles Técnicos

• Timer periódico que ejecuta syncAll() cada 10 minutos cuando hay internet
• Listener de conectividad que detecta cambios de estado de red
• Sincronización automática al detectar reconexión (transición de offline a online)
• Limpieza automática de recursos cuando no hay managers activos

📝 Documentación

• Documentación actualizada en README.md y README_SUPER_SIMPLE.md con información sobre sincronización automática
• Ejemplos de uso de la sincronización automática agregados

🔧 Cambios Internos

• GlobalConfig.syncMinutes cambiado de 5 a 10 minutos por defecto
• Agregado sistema de auto-sync con timer y listener de conectividad en OnlineOfflineManager
• Método disposeAutoSync() agregado para limpieza de recursos

🚀 MAJOR RELEASE - API Simplificada

Esta versión es una reescritura completa enfocada en simplicidad extrema.

⚠️ BREAKING CHANGES

GlobalConfig Simplificado

// ANTES (muchos parámetros)
GlobalConfig.init(
  baseUrl: 'https://api.com',
  token: 'tu-token',
  syncMinutes: 5,
  useIncrementalSync: true,
  pageSize: 25,
  lastModifiedField: 'updated_at',
  syncOnReconnect: true,
  maxLocalRecords: 1000,
  maxDaysToKeep: 7,
  maxPagesPerSync: 10,
  syncTimeoutMinutes: 30,
);

// DESPUÉS (solo 2 parámetros)
GlobalConfig.init(
  baseUrl: 'https://api.com',
  token: 'tu-token',
);

API del Manager Simplificada

// ANTES
final datos = await manager.getAll();  // Sincronizaba automáticamente (lento)
await manager.sync();
await manager.forceSync();
await manager.syncNow();
await manager.getSync();
await manager.getLocal();

// DESPUÉS
final datos = await manager.get();     // Siempre local (instantáneo)
await OnlineOfflineManager.syncAll();  // Un solo método para sincronizar

✨ Nueva API Super Simple

Métodos de Instancia

Métodos Estáticos

✨ Nuevas Características

Ver Estado de Sincronización

// Obtener todo junto
final data = await manager.getFullData();
print('Total: ${data.total}');
print('Sincronizados: ${data.syncedCount}');
print('Pendientes: ${data.pendingCount}');

// Acceder a los datos
for (final item in data.synced) { ... }
for (final item in data.pending) { ... }

Debug Info

await OnlineOfflineManager.debugInfo();
// Imprime info detallada de todos los managers y boxes

Estado Global

final estados = await OnlineOfflineManager.getAllSyncInfo();
for (final entry in estados.entries) {
  print('${entry.key}: ${entry.value.synced}/${entry.value.total}');
}

🗑️ Eliminado

• SyncConfig - Ya no se necesita
• getAll() - Reemplazado por get()
• getSync() / getLocal() - Reemplazados por getSynced() / getPending()
• sync(), forceSync(), syncNow() - Reemplazados por syncAll()
• syncAllManagers() - Reemplazado por syncAll()
• Sincronización automática en get() - Ahora es manual con syncAll()
• Parámetros de configuración avanzados en GlobalConfig

📝 Filosofía de la Nueva Versión

1. get() siempre es instantáneo - Lee datos locales sin esperar
2. El usuario decide cuándo sincronizar - Llamando a syncAll()
3. Configuración mínima - Solo baseUrl y token
4. Una forma de hacer las cosas - Sin métodos redundantes

Nuevas características:

• Sincronización ultra-inteligente con verificación previa
• Prevención y limpieza automática de duplicados
• Optimizaciones de rendimiento con límites de seguridad
• Sincronización manual vs automática diferenciada

Mejoras técnicas:

• Métodos separados para sincronización manual y automática
• Configuraciones avanzadas: maxPagesPerSync, syncTimeoutMinutes
• Logs detallados con estadísticas de procesamiento
• Detección de páginas vacías para evitar descargas innecesarias

Correcciones:

• Sincronización manual ahora siempre sincroniza
• Prevención automática de duplicados
• Mapeo correcto entre IDs y claves de almacenamiento
• Comportamiento consistente en todos los métodos manuales

Nuevos métodos:

• cleanDuplicates() para limpieza manual de duplicados
• Configuraciones recomendadas por tipo de aplicación
• Logs informativos para mejor debugging

Beneficios:

• UI más limpia sin registros duplicados
• Sincronización más rápida y eficiente
• Mejor experiencia de usuario
• Configuración flexible para diferentes tipos de apps

• Sincronización inteligente optimizada con caché
• Nuevas configuraciones: SyncConfig.frequent, occasional, rare, manual
• Nuevos métodos: getAllFast(), getAllWithSync(), forceSync()
• Timer automático de sincronización
• Logs optimizados (solo errores críticos)
• Documentación completa de optimización
• CacheManager inteligente con timestamps persistentes
• Hasta 20x más rápido para datos en caché

🚀 MAJOR RELEASE - Smart API Response Detection & Enhanced Data Access

Esta versión introduce detección automática de respuestas anidadas y nuevos métodos de acceso a datos para una experiencia de desarrollo aún mejor.

✨ Nuevas Características Principales

🌐 Detección Automática de Respuestas Anidadas

• Detección Inteligente: Reconoce automáticamente respuestas con formato {data: [...], total: N}
• Extracción Automática: Extrae el array data sin configuración adicional
• Compatibilidad Universal: Funciona con respuestas simples y anidadas
• Logs Informativos: Muestra metadatos útiles como total y page

// ✨ AHORA FUNCIONA AUTOMÁTICAMENTE
// Respuesta del servidor: {data: [...], total: 100}
// getFromServer() retorna directamente: [...]
final datos = await manager.getFromServer();

🚀 Nuevos Métodos de Acceso a Datos

getFromServer() - Datos Frescos del Servidor

// Obtiene datos directamente del servidor (requiere internet)
final datosFrescos = await manager.getFromServer();

getAllWithSync() - Sincronización Inteligente

// Sincroniza primero, luego retorna datos actualizados
final datosActualizados = await manager.getAllWithSync();

📊 Procesamiento Mejorado de APIs

• Múltiples Formatos: Soporte para APIs REST estándar
• Respuestas Anidadas: {data: [...], total: N, page: 1}
• Respuestas Simples: [{...}, {...}]
• Objetos Únicos: {id: 1, name: "..."}

🔧 Mejoras Técnicas

ApiClient Mejorado

• Extracción Automática: Método _extractNestedData() para respuestas anidadas
• Mejor Logging: Información detallada sobre el procesamiento
• Manejo de Errores: Gestión robusta de diferentes formatos de respuesta

SyncService Expandido

• Nuevo Método: getDirectFromServer() para acceso directo al servidor
• Mejor Procesamiento: Manejo inteligente de tipos de datos
• Error Handling: Mensajes de error más descriptivos

📚 Documentación Completa Renovada

README Completamente Reescrito

• Guía Paso a Paso: Desde instalación hasta uso avanzado
• Ejemplos Reales: Casos de uso del mundo real
• Mejores Prácticas: Cuándo usar cada método
• API Reference: Documentación completa de todos los métodos

Nuevas Guías

• Guía de Uso: ¿Cuándo usar getAll() vs getFromServer() vs getAllWithSync()?
• Ejemplos Completos: Lista de tareas, sistema de comentarios
• Testing Guide: Cómo testear tu aplicación
• Manejo de Errores: Estrategias robustas de error handling

🎯 Nuevas Mejores Prácticas

Estrategia de Carga de Datos

// 🚀 Carga rápida inicial + sincronización background
Future<void> _cargarDatos() async {
  // 1. Cargar datos locales primero (rápido)
  final datosLocales = await manager.getAll();
  setState(() { datos = datosLocales; });
  
  // 2. Sincronizar en background
  if (manager.isOnline) {
    final datosActualizados = await manager.getAllWithSync();
    setState(() { datos = datosActualizados; });
  }
}

Pull to Refresh Optimizado

// 🔄 Refresh inteligente con datos frescos
Future<void> _onRefresh() async {
  try {
    final datosFrescos = await manager.getFromServer();
    setState(() { datos = datosFrescos; });
  } catch (e) {
    // Mantener datos actuales en caso de error
    _mostrarError('Error actualizando datos');
  }
}

🐛 Correcciones Importantes

Procesamiento de Respuestas

• ✅ Respuestas Anidadas: Ahora se procesan correctamente
• ✅ Múltiples Formatos: Soporte universal para diferentes APIs
• ✅ Error Handling: Mejor manejo de respuestas malformadas

Sincronización

• ✅ Sync Automático: Mejorada la confiabilidad
• ✅ Conectividad: Mejor detección de estado de red
• ✅ Data Consistency: Consistencia mejorada entre local y servidor

🔄 Breaking Changes (Mínimos)

ApiClient

• GET Requests: Ahora extraen automáticamente datos anidados
• Backward Compatible: El 99% del código existente sigue funcionando
• Migration Path: Actualización transparente en la mayoría de casos

⚡ Performance

Optimizaciones

• Carga Más Rápida: getAll() optimizado para UI
• Network Efficiency: Mejor uso de requests de red
• Memory Usage: Gestión de memoria mejorada

🧪 Testing Actualizado

Nuevos Tests

• Response Processing: Tests para detección de respuestas anidadas
• New Methods: Cobertura completa de getFromServer() y getAllWithSync()
• Error Scenarios: Tests robustos de manejo de errores

🎉 Ejemplos de Uso

Sistema de Tareas Completo

class TaskManager {
  static final manager = OnlineOfflineManager(
    boxName: 'tasks',
    endpoint: 'tasks',
  );
  
  // Cargar tareas con sincronización inteligente
  static Future<List<Task>> getTasks() async {
    final data = await manager.getAllWithSync();
    return data.map((item) => Task.fromMap(item)).toList();
  }
  
  // Refrescar desde servidor
  static Future<List<Task>> refreshTasks() async {
    final data = await manager.getFromServer();
    return data.map((item) => Task.fromMap(item)).toList();
  }
}

📈 Beneficios de la v2.0.0

Para Desarrolladores

• Menos Código: Detección automática reduce boilerplate
• Más Flexible: Múltiples estrategias de acceso a datos
• Mejor DX: Documentación completa y ejemplos reales

Para Usuarios Finales

• UI Más Rápida: Carga inicial optimizada
• Mejor Offline: Sincronización más inteligente
• Datos Frescos: Acceso fácil a datos actualizados del servidor

� Corrección Crítica

• ConnectivityService: Corregido para funcionar correctamente en dispositivos reales
• Detección de Test: Mejorada la detección de entornos de test vs dispositivos reales
• Conectividad Real: Ahora detecta correctamente la conectividad en emuladores y dispositivos físicos

🔧 Mejoras y Correcciones

• ConnectivityService: Mejorado para funcionar en entornos de test
• Tests: Todos los 36 tests pasan exitosamente
• Documentación: README actualizado y más directo
• Inicialización Automática: Hive se inicializa automáticamente
• Compatibilidad: Mejor compatibilidad con diferentes entornos

🚀 Primera Versión Pública

• Nombre del paquete: betuko_offline_sync - Librería Flutter offline-first
• LICENSE: Archivo de licencia MIT agregado
• Validación completa: Todos los errores de pub.dev resueltos
• Documentación: README completo con ejemplos prácticos
• Tests: 36 tests pasando exitosamente
• Arquitectura simplificada: Fácil de usar y mantener

✨ Agregado

• OnlineOfflineManager: Gestor principal simplificado
• LocalStorageService: Almacenamiento local automático con Hive
• ConnectivityService: Detección de conectividad en tiempo real
• SyncService: Sincronización automática bidireccional
• ApiClient: Cliente HTTP integrado para comunicación con servidor
• GlobalConfig: Configuración global de baseUrl y token
• Streams Reactivos: UI que se actualiza automáticamente