pulse_http #

package:http wrapper for the Pulse Developer Intelligence SDK.

PulseHttpClient is a drop-in BaseClient wrapper that automatically captures HTTP request and response metrics and forwards them to the Pulse event pipeline.

Features #

• ✅ Drop-in replacement for any http.Client
• ✅ Captures HTTP method, URL, status code, duration, and sizes
• ✅ Integrates with PulseNetworkConfig — honour URL redaction, header/body capture settings
• ✅ Safe failure mode — capture errors never affect your HTTP requests
• ✅ Properly delegates close() to the underlying client
• ✅ Zero overhead when Pulse is disabled

Installation #

dependencies:
  pulse_dev_flutter: ^0.1.0   # or pulse_dev for pure Dart
  pulse_http: ^0.1.0
  http: ^1.2.0

Usage #

Flutter (with pulse_dev_flutter) #

import 'package:http/http.dart' as http;
import 'package:pulse_dev_flutter/pulse_dev_flutter.dart';
import 'package:pulse_http/pulse_http.dart';

// After Pulse.initialize(...)

// Replace your existing http.Client with a monitored wrapper
final client = Pulse.network != null
    ? PulseHttpClient(http.Client(), observer: Pulse.network!)
    : http.Client();

// Use exactly like a normal http.Client
final response = await client.get(Uri.parse('https://api.example.com/users'));

Pure Dart (with pulse_dev) #

import 'package:http/http.dart' as http;
import 'package:pulse_dev/pulse_dev.dart';
import 'package:pulse_http/pulse_http.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 client = PulseHttpClient(http.Client(), observer: observer);

// Use exactly like a normal http.Client
final response = await client.get(Uri.parse('https://api.example.com/data'));

With a custom base client #

// Works with any BaseClient implementation
final client = PulseHttpClient(
  RetryClient(http.Client()),   // existing retry wrapper
  observer: Pulse.network!,
);

Network Configuration #

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.