feat(web): load injected debug ids (#2917)

* add initial impl

* Update

* Update mocks

* Formatting

* Update searching for debug id

* Update

* Update

* Revert main

* Improve readability

* Return unmodifiable

* Update CHANGELOG

* Update web_load_debug_images_integration.dart

* Update

* Improve

* Update naming

* Add additional test

* Update test

* Update debug id impl

* Update

* Update

* Rename

* Fix analyze

* Fix log

* Fix test

* update

* Fix test

* Formatting

Author: buenaflor

CHANGELOG.md

@@ -4,6 +4,9 @@
 
 ### Features
 
+- Flutter Web: add debug ids to events ([#2917](https://github.com/getsentry/sentry-dart/pull/2917))
+  - This allows support for symbolication based on [debug ids](https://docs.sentry.io/platforms/javascript/sourcemaps/troubleshooting_js/debug-ids/)
+  - This only works if you use the Sentry Dart Plugin version `3.0.0` or higher
 - Improved TTID/TTFD API ([#2866](https://github.com/getsentry/sentry-dart/pull/2866))
   - This improves the stability and consistency of TTFD reporting by introducing new APIs
 ```dart

flutter/lib/src/integrations/integrations.dart

@@ -1,7 +1,7 @@
 export 'debug_print_integration.dart';
 export 'flutter_error_integration.dart';
 export 'load_contexts_integration.dart';
-export 'load_native_debug_images_integration.dart';
+export 'load_debug_images_integration.dart';
 export 'load_release_integration.dart';
 export 'native_app_start_integration.dart';
 export 'on_error_integration.dart';

flutter/lib/src/integrations/load_debug_images_integration.dart

@@ -0,0 +1,2 @@
+export 'native_load_debug_images_integration.dart'
+    if (dart.library.js_interop) 'web_load_debug_images_integration.dart';

flutter/lib/src/integrations/load_native_debug_images_integration.dart renamed to flutter/lib/src/integrations/native_load_debug_images_integration.dart

@@ -7,11 +7,16 @@ import 'package:sentry/src/load_dart_debug_images_integration.dart';
 import '../native/sentry_native_binding.dart';
 import '../sentry_flutter_options.dart';
 
+Integration<SentryFlutterOptions> createLoadDebugImagesIntegration(
+    SentryNativeBinding native) {
+  return LoadNativeDebugImagesIntegration(native);
+}
+
 /// Loads the native debug image list from the native SDKs for stack trace symbolication.
 class LoadNativeDebugImagesIntegration
     extends Integration<SentryFlutterOptions> {
   final SentryNativeBinding _native;
-  static const integrationName = 'LoadNativeDebugImagesIntegration';
+  static const integrationName = 'LoadNativeDebugImages';
 
   LoadNativeDebugImagesIntegration(this._native);
 

flutter/lib/src/integrations/web_load_debug_images_integration.dart

@@ -0,0 +1,48 @@
+import 'dart:async';
+
+import 'package:sentry/sentry.dart';
+
+import '../native/sentry_native_binding.dart';
+import '../sentry_flutter_options.dart';
+
+Integration<SentryFlutterOptions> createLoadDebugImagesIntegration(
+    SentryNativeBinding native) {
+  return LoadWebDebugImagesIntegration(native);
+}
+
+/// Loads the debug id injected by Sentry tooling e.g Sentry Dart Plugin
+/// This is necessary for symbolication of minified js stacktraces via debug ids.
+class LoadWebDebugImagesIntegration extends Integration<SentryFlutterOptions> {
+  final SentryNativeBinding _native;
+  static const integrationName = 'LoadWebDebugImages';
+
+  LoadWebDebugImagesIntegration(this._native);
+
+  @override
+  void call(Hub hub, SentryFlutterOptions options) {
+    options.addEventProcessor(
+      _LoadDebugIdEventProcessor(_native),
+    );
+    options.sdk.addIntegration(integrationName);
+  }
+}
+
+class _LoadDebugIdEventProcessor implements EventProcessor {
+  _LoadDebugIdEventProcessor(this._native);
+
+  final SentryNativeBinding _native;
+
+  @override
+  Future<SentryEvent?> apply(SentryEvent event, Hint hint) async {
+    // ignore: invalid_use_of_internal_member
+    final stackTrace = event.stacktrace;
+    if (stackTrace == null) {
+      return event;
+    }
+    final debugImages = await _native.loadDebugImages(stackTrace);
+    if (debugImages != null) {
+      event.debugMeta = DebugMeta(images: debugImages);
+    }
+    return event;
+  }
+}

flutter/lib/src/sentry_flutter.dart

@@ -181,11 +181,11 @@ mixin SentryFlutter {
       // We also need to call this before the native sdk integrations so release is properly propagated.
       integrations.add(LoadReleaseIntegration());
       integrations.add(createSdkIntegration(native));
+      integrations.add(createLoadDebugImagesIntegration(native));
       if (!platform.isWeb) {
         if (native.supportsLoadContexts) {
           integrations.add(LoadContextsIntegration(native));
         }
-        integrations.add(LoadNativeDebugImagesIntegration(native));
         integrations.add(FramesTrackingIntegration(native));
         integrations.add(
           NativeAppStartIntegration(

flutter/lib/src/web/noop_sentry_js_binding.dart

@@ -32,4 +32,9 @@ class NoOpSentryJsBinding implements SentryJsBinding {
 
   @override
   void updateSession({int? errors, String? status}) {}
+
+  @override
+  Map<String, String>? getFilenameToDebugIdMap() {
+    return {};
+  }
 }

flutter/lib/src/web/sentry_js_binding.dart

@@ -11,7 +11,7 @@ abstract class SentryJsBinding {
   Map<dynamic, dynamic>? getSession();
   void updateSession({int? errors, String? status});
   void captureSession();
-
+  Map<String, String>? getFilenameToDebugIdMap();
   @visibleForTesting
   dynamic getJsOptions();
 }

flutter/lib/src/web/sentry_web.dart

@@ -1,6 +1,7 @@
 import 'dart:async';
 import 'dart:typed_data';
 
+import 'package:collection/collection.dart';
 // ignore: implementation_imports
 import 'package:sentry/src/sentry_item_type.dart';
 
@@ -18,8 +19,12 @@ class SentryWeb with SentryNativeSafeInvoker implements SentryNativeBinding {
   final SentryJsBinding _binding;
   final SentryFlutterOptions _options;
 
+  void _log(String message) {
+    _options.log(SentryLevel.info, logger: '$SentryWeb', message);
+  }
+
   void _logNotSupported(String operation) =>
-      options.log(SentryLevel.debug, 'SentryWeb: $operation is not supported');
+      _log('$operation is not supported');
 
   @override
   FutureOr<void> init(Hub hub) {
@@ -178,7 +183,34 @@ class SentryWeb with SentryNativeSafeInvoker implements SentryNativeBinding {
 
   @override
   FutureOr<List<DebugImage>?> loadDebugImages(SentryStackTrace stackTrace) {
-    _logNotSupported('loading debug images');
+    final debugIdMap = _binding.getFilenameToDebugIdMap();
+    if (debugIdMap == null || debugIdMap.isEmpty) {
+      _log('Could not find debug id in js source file.');
+      return null;
+    }
+
+    final frame = stackTrace.frames.firstWhereOrNull((frame) {
+      return debugIdMap.containsKey(frame.absPath) ||
+          debugIdMap.containsKey(frame.fileName);
+    });
+    if (frame == null) {
+      _log('Could not find any frame with a matching debug id.');
+      return null;
+    }
+
+    final codeFile = frame.absPath ?? frame.fileName;
+    final debugId = debugIdMap[codeFile];
+    if (debugId != null) {
+      return [
+        DebugImage(
+          debugId: debugId,
+          type: 'sourcemap',
+          codeFile: codeFile,
+        ),
+      ];
+    }
+
+    _log('Could not match any frame against the debug id map.');
     return null;
   }
 

flutter/lib/src/web/web_sentry_js_binding.dart

@@ -1,7 +1,7 @@
 import 'dart:js_interop';
 import 'dart:js_interop_unsafe';
 
-import 'package:flutter/cupertino.dart';
+import 'package:meta/meta.dart';
 
 import 'sentry_js_binding.dart';
 
@@ -11,6 +11,14 @@ SentryJsBinding createJsBinding() {
 
 class WebSentryJsBinding implements SentryJsBinding {
   SentryJsClient? _client;
+  JSObject? _options;
+  final Map<String, String> _filenameToDebugIds = {};
+  final Set<String> _debugIdsWithFilenames = {};
+
+  int _lastKeysCount = 0;
+
+  @visibleForTesting
+  Map<String, String>? get filenameToDebugIds => _filenameToDebugIds;
 
   @override
   void init(Map<String, dynamic> options) {
@@ -20,6 +28,7 @@ class WebSentryJsBinding implements SentryJsBinding {
     }
     _init(options.jsify());
     _client = SentryJsClient();
+    _options = _client?.getOptions();
   }
 
   @override
@@ -54,10 +63,10 @@ class WebSentryJsBinding implements SentryJsBinding {
 
   @override
   void close() {
-    final sentryProp = _globalThis.getProperty('Sentry'.toJS);
+    final sentryProp = globalThis.getProperty('Sentry'.toJS);
     if (sentryProp != null) {
       _close();
-      _globalThis['Sentry'] = null;
+      globalThis['Sentry'] = null;
     }
   }
 
@@ -93,6 +102,74 @@ class WebSentryJsBinding implements SentryJsBinding {
       return null;
     }
   }
+
+  @override
+  Map<String, String>? getFilenameToDebugIdMap() {
+    final options = _options;
+    if (options == null) {
+      return null;
+    }
+
+    final debugIdMap =
+        globalThis['_sentryDebugIds'].dartify() as Map<dynamic, dynamic>?;
+    if (debugIdMap == null) {
+      return null;
+    }
+
+    if (debugIdMap.keys.length != _lastKeysCount) {
+      _buildFilenameToDebugIdMap(
+        debugIdMap,
+        options,
+      );
+      _lastKeysCount = debugIdMap.keys.length;
+    }
+
+    return Map.unmodifiable(_filenameToDebugIds);
+  }
+
+  void _buildFilenameToDebugIdMap(
+    Map<dynamic, dynamic> debugIdMap,
+    JSObject options,
+  ) {
+    final stackParser = _stackParser(options);
+    if (stackParser == null) {
+      return;
+    }
+
+    for (final debugIdMapEntry in debugIdMap.entries) {
+      final String stackKeyStr = debugIdMapEntry.key.toString();
+      final String debugIdStr = debugIdMapEntry.value.toString();
+
+      final debugIdHasCachedFilename =
+          _debugIdsWithFilenames.contains(debugIdStr);
+
+      if (!debugIdHasCachedFilename) {
+        final parsedStack = stackParser
+            .callAsFunction(options, stackKeyStr.toJS)
+            .dartify() as List<dynamic>?;
+
+        if (parsedStack == null) continue;
+
+        for (final stackFrame in parsedStack) {
+          final stackFrameMap = stackFrame as Map<dynamic, dynamic>;
+          final filename = stackFrameMap['filename']?.toString();
+          if (filename != null) {
+            _filenameToDebugIds[filename] = debugIdStr;
+            _debugIdsWithFilenames.add(debugIdStr);
+            break;
+          }
+        }
+      }
+    }
+  }
+
+  JSFunction? _stackParser(JSObject options) {
+    final parser = options['stackParser'];
+    if (parser != null && parser.isA<JSFunction>()) {
+      return parser as JSFunction;
+    }
+    return null;
+  }
 }
 
 @JS('Sentry.init')
@@ -136,4 +213,5 @@ external JSObject _globalHandlersIntegration();
 external JSObject _dedupeIntegration();
 
 @JS('globalThis')
-external JSObject get _globalThis;
+@internal
+external JSObject get globalThis;