Offline Secure Session #

Enterprise-grade Dart library for secure session management with AES-256 encryption and offline support.

Libreria Dart nivel empresarial para manejo seguro de sesiones con cifrado AES-256 y soporte offline.

Features / Caracteristicas #

Installation / Instalacion #

dependencies:
  offline_secure_session: ^2.0.0

dart pub get

Quick Start / Inicio Rapido #

import 'package:offline_secure_session/offline_secure_session.dart';

void main() async {
  OfflineSecureSession.init(
    path: '/path/to/storage',
    encryptionKey: 'my_secret_key_32_chars_long_xxx',
    maxQueueSize: 10000,
  );

  await OfflineSecureSession.session.set('eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...');
  final token = await OfflineSecureSession.session.get();

  await OfflineSecureSession.cache.set('user', {'id': 1, 'name': 'John'});
  final user = await OfflineSecureSession.cache.get<Map>('user');

  await OfflineSecureSession.queue.add({'method': 'POST', 'url': '/api/orders', 'body': {'product': 'A1'}});

  final sync = OfflineSecureSession.sync(maxRetries: 5, timeout: Duration(seconds: 2));
  sync.onOnline = () => sync.process((action) async => true);
  sync.startMonitor();
}

Enterprise Features / Funcionalidades Empresariales #

Logger Integration / Integracion de Logger #

OfflineSecureSession.setLogger((level, message, data) {
  print('[$level] $message ${data ?? ''}');
});

Metrics / Metricas #

final metrics = OfflineSecureSession.metrics;
print('Operations: ${metrics['ops']}');
print('Errors: ${metrics['errors']}');
print('Queue size: ${metrics['queue']}');
print('Avg response: ${metrics['avg_ms']}ms');

Custom Sync Configuration / Configuracion de Sync Personalizada #

final sync = OfflineSecureSession.sync(
  host: 'your-api.com',
  maxRetries: 5,
  timeout: Duration(seconds: 2),
);

sync.onSuccess = (action) => print('Synced: $action');
sync.onError = (action, error) => print('Failed: $action - $error');

Real World Example / Ejemplo Real #

E-commerce App #

class OrderService {
  OrderService() {
    OfflineSecureSession.init(
      path: '/data/app',
      encryptionKey: 'your_32_char_encryption_key_here',
    );

    final sync = OfflineSecureSession.sync();
    sync.onOnline = _syncOrders;
    sync.startMonitor();
  }

  Future<void> placeOrder(Map<String, dynamic> order) async {
    await OfflineSecureSession.queue.add({
      'url': 'https://api.mystore.com/orders',
      'body': order,
      'token': await OfflineSecureSession.session.get(),
    });
  }

  Future<void> _syncOrders() async {
    final sync = OfflineSecureSession.sync();
    await sync.process((action) async {
      try {
        final response = await http.post(
          Uri.parse(action['url']),
          headers: {'Authorization': 'Bearer ${action['token']}'},
          body: jsonEncode(action['body']),
        );
        return response.statusCode == 201;
      } catch (_) {
        return false;
      }
    });
  }
}

Login Flow / Flujo de Login #

class AuthService {
  Future<void> login(String email, String password) async {
    final response = await http.post(...);
    final data = jsonDecode(response.body);

    await OfflineSecureSession.session.set(data['token'], exp: Duration(hours: 8));
    await OfflineSecureSession.cache.set('profile', data['user']);
  }

  Future<bool> get isLoggedIn async => await OfflineSecureSession.session.get() != null;

  Future<void> logout() async {
    await OfflineSecureSession.session.clear();
    await OfflineSecureSession.cache.remove('profile');
  }
}

API Reference / Referencia API #

OfflineSecureSession #

SecureSession #

OfflineCache #

OfflineQueue #

OfflineSync #

Architecture / Arquitectura #

OfflineSecureSession.init()
          |
    _Crypto (AES-256 + GZIP)
          |
    _Store (Thread-safe persistence)
          |
    +-----+-----+-----+-----+
    |     |     |     |     |
Session Cache Queue  Sync  Metrics

Security / Seguridad #

• AES-256 encryption with random IV per operation
• SHA-256 key derivation
• GZIP compression before encryption
• Separate encrypted files for session, cache, and queue
• Thread-safe operations with lock mechanism

Compatibility / Compatibilidad #

License / Licencia #

MIT License - see LICENSE