Upgrade the Dart/Flutter SDK to v4

src/includes/before-breadcrumb/flutter.mdx

@@ -0,0 +1,9 @@
+```dart
+  import 'package:sentry/sentry.dart';
+
+  Breadcrumb beforeBreadCrumb(Breadcrumb crumb, dynamic hint) {
+    return 'a.spammy.Logger' == crumb.category ? null : crumb;
+  }
+
+  Sentry.init((options) => options.beforeBreadcrumb = beforeBreadCrumb);
+```

src/includes/breadcrumbs-example/flutter.mdx

@@ -0,0 +1,19 @@
+```dart
+  import 'package:sentry/sentry.dart';
+
+  void scope(Scope scope) {
+    final crumb = Breadcrumb(
+      message: 'Authenticated user ${scope.user.email}',
+      category: 'auth',
+      level: SentryLevel.info,
+    );
+
+    scope.addBreadcrumb(crumb);
+  }
+
+  Sentry.configureScope(scope);
+
+  // or
+
+  Sentry.addBreadcrumb(Breadcrumb(message: 'Authenticated user'));
+```

src/includes/capture-error/flutter.mdx

@@ -1,12 +1,19 @@
-In Flutter you can capture any exception object that you caught:
+In Dart you can capture any exception object that you caught:
 
 ```dart
-try {
-  throw null;
-} catch (error, stackTrace) {
-  await sentry.captureException(
-    exception: error,
-    stackTrace: stackTrace,
-  );
-}
+  import 'package:sentry/sentry.dart';
+
+  try {
+    aMethodThatMightFail();
+  } catch (exception, stackTrace) {
+    Sentry.captureException(exception, stackTrace: stackTrace);
+  }
+
+  // or
+
+  try {
+    throw 'Not implemented';
+  } catch (exception, stackTrace) {
+    Sentry.captureException(exception, stackTrace: stackTrace);
+  }
 ```

src/includes/capture-message/flutter.mdx

@@ -1,3 +1,5 @@
 ```dart
-sentry.captureEvent(const Event(message: 'Something went wrong'));
+  import 'package:sentry/sentry.dart';
+
+  Sentry.captureMessage('Something went wrong');
 ```

src/includes/configuration/before-breadcrumb-hint/flutter.mdx

@@ -0,0 +1,9 @@
+```dart
+  import 'package:sentry/sentry.dart';
+
+  Breadcrumb beforeBreadCrumb(Breadcrumb crumb, dynamic hint) {
+    return hint is MyHint ? null : crumb;
+  }
+
+  Sentry.init((options) => options.beforeBreadcrumb = beforeBreadCrumb);
+```

src/includes/configuration/before-send-fingerprint/flutter.mdx

@@ -0,0 +1,12 @@
+```dart
+  import 'package:sentry/sentry.dart';
+
+  SentryEvent beforeSend(SentryEvent event, dynamic hint) {
+    if (event.exception is DatabaseException) {
+      event = event.copyWith(fingerprint: ['database-connection-error']);
+    }
+    return event;
+  }
+
+  Sentry.init((options) => options.beforeSend = beforeSend);
+```

src/includes/configuration/before-send-hint/flutter.mdx

@@ -0,0 +1,11 @@
+A `BiFunction<SentryEvent, Object, SentryEvent>` can be used to mutate, discard (return null), or return a completely new event.
+
+```dart
+  import 'package:sentry/sentry.dart';
+
+  SentryEvent beforeSend(SentryEvent event, dynamic hint) {
+    return hint is MyHint ? null : event;
+  }
+
+  Sentry.init((options) => options.beforeSend = beforeSend);
+```

src/includes/configuration/before-send/flutter.mdx

@@ -0,0 +1,13 @@
+A `BiFunction<SentryEvent, Object, SentryEvent>` can be used to mutate, discard (return null), or return a completely new event.
+
+```dart
+  import 'package:sentry/sentry.dart';
+
+  SentryEvent beforeSend(SentryEvent event, dynamic hint) {
+    // Modify the event here:
+    event = event.copyWith(serverName: null); // Don't send server names.
+    return event;
+  }
+
+  Sentry.init((options) => options.beforeSend = beforeSend);
+```

src/includes/configuration/config-intro/flutter.mdx

@@ -1,11 +1,11 @@
-Options are passed to the `SentryClient()` class:
+Options are passed to the `Sentry.init` method:
 
 ```dart
-final sentry = SentryClient(
-  dsn: '___PUBLIC_DSN___',
-  environmentAttributes: const Event(
-    release: '[email protected]',
-    environment: 'production',
-  )
-);
+  void options(SentryOptions options) {
+    options.dsn = '___PUBLIC_DSN___';
+    options.release = '[email protected]';
+    options.environment = 'staging';
+  }
+
+  Sentry.init(options);
 ```

src/includes/configuration/sample-rate/flutter.mdx

@@ -0,0 +1,6 @@
+```dart
+  import 'package:sentry/sentry.dart';
+
+  // Capture only 25% of events
+  Sentry.init((options) => options.sampleRate = 0.25);
+```

src/includes/configure-scope/flutter.mdx

@@ -0,0 +1,11 @@
+```dart
+  import 'package:sentry/sentry.dart';
+
+  void scope(Scope scope) {
+    scope.setTag('my-tag', 'my value');
+    final user = User(id: '42', email: '[email protected]');
+    scope.user = user;
+  }
+
+  Sentry.configureScope(scope);
+```

src/includes/getting-started-config/flutter.mdx

@@ -0,0 +1,5 @@
+```dart
+  import 'package:sentry/sentry.dart';
+
+  Sentry.init((options) => options.dsn = '___PUBLIC_DSN___');
+```

src/includes/getting-started-install/flutter.mdx

@@ -0,0 +1,4 @@
+```yml {filename:pubspec.yaml}
+dependencies:
+  sentry: ^4.0.0
+```

src/includes/getting-started-verify/flutter.mdx

@@ -0,0 +1,11 @@
+```dart
+// Throw an exception and capture it with the Sentry client:
+try {
+  throw null;
+} catch (error, stackTrace) {
+  Sentry.captureException(
+    exception: error,
+    stackTrace: stackTrace,
+  );
+}
+```

src/includes/sensitive-data/set-tag/flutter.mdx

@@ -0,0 +1,8 @@
+```dart
+  import 'package:sentry/sentry.dart';
+
+  Sentry.configureScope((scope) => scope.setTag(
+        'birthday',
+        checksumOrHash('08/12/1990'),
+      ));
+```

src/includes/sensitive-data/set-user/flutter.mdx

@@ -0,0 +1,8 @@
+```dart
+  import 'package:sentry/sentry.dart';
+
+  Sentry.configureScope((scope) => scope.user = User(
+        id: clientUser.id,
+        username: clientUser.username,
+      ));
+```

src/includes/set-context/flutter.mdx

@@ -1,13 +1,11 @@
 ```dart
-import 'package:sentry/sentry.dart';
+  import 'package:sentry/sentry.dart';
 
-final sentry = SentryClient(
-  environmentAttributes: const Event(
-    extra: {
-      'name': 'Mighty Fighter',
-      'age': 19,
-      'attack_type': 'melee',
-    }
-  )
-);
+  void scope(Scope scope) {
+    scope.setExtra('name', 'Mighty Fighter');
+    scope.setExtra('age', 19);
+    scope.setExtra('attack_type', 'melee');
+  }
+
+  Sentry.configureScope(scope);
 ```

src/includes/set-environment/flutter.mdx

@@ -1,9 +1,5 @@
 ```dart
-import 'package:sentry/sentry.dart';
+  import 'package:sentry/sentry.dart';
 
-final sentry = SentryClient(
-  environmentAttributes: const Event(
-    environment: 'production'
-  )
-);
+  Sentry.init((options) => options.environment = 'staging');
 ```

src/includes/set-extra/flutter.mdx

@@ -1,9 +1,8 @@
 ```dart
-import 'package:sentry/sentry.dart';
+  import 'package:sentry/sentry.dart';
 
-final sentry = SentryClient(
-  environmentAttributes: const Event(
-    extra: { 'character.name': 'Mighty Fighter' }
-  )
-);
+  Sentry.configureScope((scope) => scope.setExtra(
+        'character.name',
+        'Mighty Fighter',
+      ));
 ```

src/includes/set-fingerprint/basic/flutter.mdx

@@ -0,0 +1,12 @@
+```dart
+  import 'package:sentry/sentry.dart';
+
+  SentryEvent beforeSend(SentryEvent event, dynamic hint) {
+    if (event.exception is DatabaseException) {
+      event = event.copyWith(fingerprint: ['database-connection-error']);
+    }
+    return event;
+  }
+
+  Sentry.init((options) => options.beforeSend = beforeSend);
+```

src/includes/set-fingerprint/database-connection/flutter.mdx

@@ -0,0 +1,12 @@
+```dart
+  import 'package:sentry/sentry.dart';
+
+  SentryEvent beforeSend(SentryEvent event, dynamic hint) {
+    if (event.exception is DatabaseException) {
+      event = event.copyWith(fingerprint: ['database-connection-error']);
+    }
+    return event;
+  }
+
+  Sentry.init((options) => options.beforeSend = beforeSend);
+```

src/includes/set-fingerprint/rpc/flutter.mdx

@@ -0,0 +1,24 @@
+```dart
+  import 'package:sentry/sentry.dart';
+
+  class MyRpcException implements Exception {
+    final String function;
+    final int httpStatusCode;
+
+    MyRpcException(this.function, this.httpStatusCode);
+  }
+
+  SentryEvent beforeSend(SentryEvent event, dynamic hint) {
+    if (event.exception is MyRpcException) {
+      final exception = event.exception as MyRpcException;
+      event = event.copyWith(fingerprint: [
+        '{{ default }}',
+        exception.function,
+        exception.httpStatusCode.toString(),
+      ]);
+    }
+    return event;
+  }
+
+  Sentry.init((options) => options.beforeSend = beforeSend);
+```

src/includes/set-fingerprint/static/flutter.mdx

@@ -0,0 +1,5 @@
+```dart
+  import 'package:sentry/sentry.dart';
+
+  Sentry.configureScope((scope) => scope.fingerprint = ['auth-error']);
+```

src/includes/set-level/flutter.mdx

@@ -0,0 +1,5 @@
+```dart
+  import 'package:sentry/sentry.dart';
+
+  Sentry.configureScope((scope) => scope.level = SentryLevel.warning);
+```

src/includes/set-release/flutter.mdx

@@ -1,9 +1,5 @@
 ```dart
-import 'package:sentry/sentry.dart';
+  import 'package:sentry/sentry.dart';
 
-final sentry = SentryClient(
-  environmentAttributes: const Event(
-    release: '[email protected]'
-  )
-);
+  Sentry.init((options) => options.release = '[email protected]');
 ```

src/includes/set-tag/flutter.mdx

@@ -0,0 +1,5 @@
+```dart
+  import 'package:sentry/sentry.dart';
+
+  Sentry.configureScope((scope) => scope.setTag('page.locale', 'pt-BR'));
+```

src/includes/set-user/flutter.mdx

@@ -0,0 +1,5 @@
+```dart
+  import 'package:sentry/sentry.dart';
+
+  Sentry.configureScope((scope) => scope.user = User(email: '[email protected]'));
+```

src/includes/unset-user/flutter.mdx

@@ -0,0 +1,5 @@
+```dart
+  import 'package:sentry/sentry.dart';
+
+  Sentry.configureScope((scope) => scope.user = null);
+```