bloom_observability library

Error observability, crash reporting SDK, breadcrumbs, and telemetry subsystem for Bloom.

Exports breadcrumb logging, hardware/software device fingerprinting, error event models, navigation routing observers, and HTTP telemetry transports.

Example:

import 'package:bloom_framework/bloom_observability.dart';

void main() {
  BloomObservability.init(
    options: BloomObservabilityOptions(
      endpoint: 'https://telemetry.example.com/events',
    ),
  );
  BloomObservability.leaveBreadcrumb('App started');
}

Classes

BloomBreadcrumb
A structured breadcrumb recording a user action, network call, or state mutation.
BloomBreadcrumbRingBuffer
Fixed-capacity ring buffer for storing recent chronological breadcrumbs.
BloomCrashFingerprint
Utilities for calculating deterministic crash grouping fingerprints.
BloomHttpTelemetryTransport
Production HTTP transport that posts JSON telemetry payloads to a remote collector endpoint.
BloomMemoryTelemetryTransport
In-memory transport storing telemetry events in a list (ideal for unit testing and debugging).
BloomObservability
Core Error Observability, Crash Reporting, and Telemetry Engine for Bloom.
BloomObservabilityConfig
Configuration options for Bloom Error Observability and Telemetry SDK.
BloomObservabilityNavigatorObserver
NavigatorObserver that automatically records route transition breadcrumbs.
BloomTelemetryEvent
A complete structured crash / telemetry event payload.
BloomTelemetryTransport
Transport contract for dispatching telemetry and crash events.

Enums

BloomBreadcrumbLevel
Severity level for breadcrumb events.
BloomErrorLevel
Severity level for telemetry and crash events.

Typedefs

BeforeSendCallback = BloomTelemetryEvent? Function(BloomTelemetryEvent event)
Callback signature for intercepting, modifying, or dropping telemetry events before transmission.

Exceptions / Errors

BloomHttpException
Exception thrown when telemetry transmission over HTTP fails.