PulseStorage class abstract interface

Defines the contract for persisting PulseEvents on the device.

Storage enables offline event queuing: events captured when the transport is unavailable are stored locally and retried when connectivity is restored.

Note

No implementation is provided in Phase 1. This interface is defined early so that the EventPipeline architecture accommodates persistence without requiring structural refactoring in future phases.

Implementations will be added in Phase 3 (offline queue support).

Implementing custom storage

final class SharedPrefsStorage implements PulseStorage {
  @override
  Future<void> store(PulseEvent event) async { ... }

  @override
  Future<List<PulseEvent>> retrieveAll() async { ... }

  @override
  Future<void> delete(String eventId) async { ... }

  @override
  Future<void> clear() async { ... }
}

See also:

• PulseTransport — for the event delivery abstraction.