pulse_dio #

Dio interceptor for the Pulse Developer Intelligence SDK.

Automatically captures HTTP request and response metrics from package:dio and forwards them to the Pulse event pipeline — without touching your existing Dio configuration.

Features #

• ✅ Captures HTTP method, URL, status code, duration, and sizes
• ✅ Integrates with PulseNetworkConfig — honour URL redaction, header/body capture settings
• ✅ Safe failure mode — interceptor errors never affect your Dio requests
• ✅ Works alongside existing Dio interceptors
• ✅ Zero overhead when Pulse is disabled

Installation #

dependencies:
  pulse_dev_flutter: ^0.1.0   # or pulse_dev for pure Dart
  pulse_dio: ^0.1.0
  dio: ^5.4.0

Usage #

Flutter (with pulse_dev_flutter) #

import 'package:dio/dio.dart';
import 'package:pulse_dev_flutter/pulse_dev_flutter.dart';
import 'package:pulse_dio/pulse_dio.dart';

// After Pulse.initialize(...)

final dio = Dio();

if (Pulse.network != null) {
  dio.interceptors.add(
    PulseDioInterceptor(observer: Pulse.network!),
  );
}

Pure Dart (with pulse_dev) #

import 'package:dio/dio.dart';
import 'package:pulse_dev/pulse_dev.dart';
import 'package:pulse_dio/pulse_dio.dart';

final config = PulseConfig(
  dsn: 'https://key@ingest.example.com/1',
  network: PulseNetworkConfig(enabled: true),
);
final pipeline = EventPipeline.fromConfig(config);
final observer = PulseNetworkObserver(pipeline: pipeline, config: config.network!);

final dio = Dio()
  ..interceptors.add(PulseDioInterceptor(observer: observer));

Network Configuration #

Control what is captured via PulseNetworkConfig:

PulseConfig(
  // ...
  network: PulseNetworkConfig(
    enabled: true,
    captureHeaders: false,           // never capture request/response headers
    captureBody: false,              // never capture request/response body
    sampleRate: 1.0,                 // capture 100% of requests
    redactQueryParameters: const {   // redact these query param values
      'token',
      'api_key',
      'secret',
    },
  ),
)

What is captured #

Related Packages #

Contributing #

See CONTRIBUTING.md.

License #

MIT — see LICENSE.