fix: execute integrations on hub creation

CHANGELOG.md

@@ -35,6 +35,7 @@
 - Ref: execute before send callback
 - Feat: add lastEventId to the Sentry static API
 - Feat: addBreadcrumb on Static API
+- Fix: Integrations are executed on Hub creation
 
 # `package:sentry` changelog
 

dart/lib/src/hub.dart

@@ -1,6 +1,8 @@
 import 'dart:async';
 import 'dart:collection';
 
+import 'package:sentry/src/hub_adapter.dart';
+
 import 'client.dart';
 import 'noop_client.dart';
 import 'protocol.dart';
@@ -31,6 +33,11 @@ class Hub {
   Hub._(SentryOptions options) : _options = options {
     _stack.add(_StackItem(_getClient(_options), Scope(_options)));
     _isEnabled = true;
+
+    // execute integrations
+    options.integrations.forEach((integration) {
+      integration(HubAdapter(), _options);
+    });
   }
 
   static void _validateOptions(SentryOptions options) {

dart/lib/src/hub_adapter.dart

@@ -0,0 +1,73 @@
+import 'package:sentry/src/protocol/sentry_level.dart';
+import 'package:sentry/src/protocol/sentry_id.dart';
+import 'package:sentry/src/protocol/sentry_event.dart';
+import 'package:sentry/src/protocol/breadcrumb.dart';
+import 'package:sentry/src/client.dart';
+import 'package:sentry/src/sentry.dart';
+import 'hub.dart';
+
+/// Hub adapter to make Integrations testable
+class HubAdapter implements Hub {
+  HubAdapter._();
+
+  static final HubAdapter _instance = HubAdapter._();
+
+  factory HubAdapter() {
+    return _instance;
+  }
+
+  @override
+  void addBreadcrumb(Breadcrumb crumb, {dynamic hint}) =>
+      Sentry.addBreadcrumb(crumb, hint: hint);
+
+  @override
+  void bindClient(SentryClient client) => Sentry.bindClient(client);
+
+  @override
+  Future<SentryId> captureEvent(SentryEvent event, {dynamic hint}) =>
+      Sentry.captureEvent(event, hint: hint);
+
+  @override
+  Future<SentryId> captureException(
+    dynamic throwable, {
+    dynamic stackTrace,
+    dynamic hint,
+  }) =>
+      Sentry.captureException(
+        throwable,
+        stackTrace: stackTrace,
+        hint: hint,
+      );
+
+  @override
+  Future<SentryId> captureMessage(
+    String message, {
+    SentryLevel level = SentryLevel.info,
+    String template,
+    List params,
+    dynamic hint,
+  }) =>
+      Sentry.captureMessage(
+        message,
+        level: level,
+        template: template,
+        params: params,
+        hint: hint,
+      );
+
+  @override
+  Hub clone() => Sentry.clone();
+
+  @override
+  void close() => Sentry.close();
+
+  @override
+  void configureScope(ScopeCallback callback) =>
+      Sentry.configureScope(callback);
+
+  @override
+  bool get isEnabled => Sentry.isEnabled;
+
+  @override
+  SentryId get lastEventId => Sentry.lastEventId;
+}

dart/lib/src/sentry.dart

@@ -51,38 +51,35 @@ class Sentry {
   static Future<SentryId> captureEvent(
     SentryEvent event, {
     dynamic hint,
-  }) async {
-    return currentHub.captureEvent(event, hint: hint);
-  }
+  }) async =>
+      currentHub.captureEvent(event, hint: hint);
 
   /// Reports the [exception] and optionally its [stackTrace] to Sentry.io.
   static Future<SentryId> captureException(
-    dynamic error, {
+    dynamic throwable, {
     dynamic stackTrace,
     dynamic hint,
-  }) async {
-    return currentHub.captureException(
-      error,
-      stackTrace: stackTrace,
-      hint: hint,
-    );
-  }
+  }) async =>
+      currentHub.captureException(
+        throwable,
+        stackTrace: stackTrace,
+        hint: hint,
+      );
 
-  Future<SentryId> captureMessage(
+  static Future<SentryId> captureMessage(
     String message, {
     SentryLevel level,
     String template,
     List<dynamic> params,
     dynamic hint,
-  }) async {
-    return currentHub.captureMessage(
-      message,
-      level: level,
-      template: template,
-      params: params,
-      hint: hint,
-    );
-  }
+  }) async =>
+      currentHub.captureMessage(
+        message,
+        level: level,
+        template: template,
+        params: params,
+        hint: hint,
+      );
 
   /// Close the client SDK
   static void close() {
@@ -98,20 +95,32 @@ class Sentry {
   static SentryId get lastEventId => currentHub.lastEventId;
 
   /// Adds a breacrumb to the current Scope
-  static void addBreadcrumb(Breadcrumb crumb, {dynamic hint}) {
-    currentHub.addBreadcrumb(crumb, hint: hint);
-  }
+  static void addBreadcrumb(Breadcrumb crumb, {dynamic hint}) =>
+      currentHub.addBreadcrumb(crumb, hint: hint);
+
+  /// Configures the scope through the callback.
+  static void configureScope(ScopeCallback callback) =>
+      currentHub.configureScope(callback);
+
+  /// Clones the current Hub
+  static Hub clone() => currentHub.clone();
+
+  /// Binds a different client to the current hub
+  static void bindClient(SentryClient client) => currentHub.bindClient(client);
 
   static bool _setDefaultConfiguration(SentryOptions options) {
+    // if DSN is null, let's crash the App.
     if (options.dsn == null) {
       throw ArgumentError.notNull(
           'DSN is required. Use empty string to disable SDK.');
     }
+    // if the DSN is empty, let's disable the SDK
     if (options.dsn.isEmpty) {
       close();
       return false;
     }
 
+    // if logger os NoOp, let's set a logger that prints on the console
     if (options.debug && options.logger == noOpLogger) {
       options.logger = dartLogger;
     }

dart/test/hub_test.dart

@@ -95,6 +95,14 @@ void main() {
       final returnedId = await hub.captureEvent(event);
       expect(eventId.toString(), returnedId.toString());
     });
+
+    test('should install integrations', () {
+      options.addIntegration(integration);
+      final hub = Hub(options);
+      client = MockSentryClient();
+      hub.bindClient(client);
+      // TODO: assert that integration(hub, options) has been invoked
+    });
   });
 
   group('Hub scope', () {
@@ -183,3 +191,5 @@ void main() {
     // could we set [hub.stack] as @visibleForTesting ?
   });
 }
+
+void integration(Hub hub, SentryOptions options) {}