🗝️ user_session_manager #

A clean, lightweight, and testable Dart package for securely managing user session data across app restarts using SharedPreferences or flutter_secure_storage.

Designed with SOLID principles and clean architecture, it supports both primitive types (like String, int) and custom objects using JSON serialization.

This is just functionality that I wrote for my own app. I felt like that the functionality should have been provided by an existing package, but there was none.

✨ Features #

Choose between secure or plain storage (with encrypt: true)
Persist any data type (primitives or complex models)
Blazing fast access to session state
Fully testable with in-memory mock repository
Easy to integrate into any Dart or Flutter app
No DB dependency required for login state

📦 Installation #

Add this to your pubspec.yaml:

dependencies:
  (coming soon)

Then run:

flutter pub get

✨ Will be available on pub.dev soon!

🚀 Getting Started #

Primitive Example (int - userId) #

final session = await UserSessionManager.create<int>(encrypt: false);

await session.login(42);                      // Save user ID
final userId = await session.getUser();       // 42
final isLoggedIn = await session.isLoggedIn(); // true

await session.logout();

Custom Object Example #

class User {
  final int id;
  final String name;

  User(this.id, this.name);

  Map<String, dynamic> toJson() => {'id': id, 'name': name};
  factory User.fromJson(Map<String, dynamic> json) =>
      User(json['id'], json['name']);

  factory User.fromJson(Map<String, dynamic> json) => User(
    json['id'],
    json['name'],
  );
 }

final session = await UserSessionManager.create<User>(
  encrypt: true,
  toJson: (u) => u.toJson(),
  fromJson: (json) => User.fromJson(json),
);

await session.login(User(1, 'Alice'));
final user = await session.getUser(); // User instance

🧪 Testing with In-Memory Storage #

For testing without platform dependencies:

final repo = InMemorySessionRepository<User>();
final service = UserSessionService.forTesting(repo);
final session = UserSessionManager.forTesting(service);

API #