streambox_adapters

A set of ready-to-use storage adapters for the streambox_core framework.
Provides pluggable implementations of KeyValueStoreInterface for common Flutter & Dart storage backends.

✨ Features

Drop-in storage adapters for streambox_core
Built-in support for:
- Memory-only store
- SharedPreferences (async)
- SharedPreferences with in-memory caching
- FlutterSecureStorage for encrypted values
Unified KeyValueStoreInterface contract
Easy integration with custom cache strategies

📦 Installation

dependencies:
  streambox_core: ^latest_version
  streambox_adapters: ^latest_version

💄 Why a Separate Package?

The streambox_adapters package was split from streambox_core to:

Keep the core library lightweight and focused on abstractions
Avoid extra dependencies for users who don’t need adapters
Allow faster independent updates to adapters without releasing a new version of streambox_core
Provide a clean modular design, so you only import what you need

🗄️ Available Adapters

MemoryStoreAdapter

Stores values in memory only
Perfect for testing, prototyping, ephemeral caches
Persistence: ❌ (cleared when app restarts)

AsyncSharedPrefsStorageAdapter

Uses the asynchronous SharedPreferencesAsync API
Great for general persistent storage with async access
Persistence: ✅ (shared preferences)

CachedSharedPrefsStorageAdapter

Backed by SharedPreferencesWithCache
Reduces disk I/O via in-memory caching
Persistence: ✅ (cached + disk-backed)

FlutterSecureStorageAdapter

Backed by flutter_secure_storage
Encrypted and secure key-value storage
Ideal for sensitive data (tokens, credentials)
Persistence: ✅ (secure & encrypted)

📘 Example Usage

import 'package:streambox_core/streambox_core.dart';
import 'package:streambox_adapters/streambox_adapters.dart';

final repo = ExampleRepoImpl(
  dataSource: ExampleDataSource(
    api: ExampleApiInterface(dio),
    cacheStrategy: CacheThenRefreshStrategy(
      cache: BaseKeyValueCache(
        store: FlutterSecureStorageAdapter(),
      ),
    ),
  ),
);

If you don’t need persistence:

cacheStrategy: NoOpCacheStrategy(),

🛠 Extensibility

You can implement:

Custom adapters via KeyValueStoreInterface
Your own persistent backends (e.g., Hive, Isar, SQLite)
Specialized storage layers for advanced use cases