symbolic-common

Breaking Changes

• SourceBundleWriter::finish now returns the underlying writer. (#1016)
• FormatErrorKind::InvalidBlobFormat is changed from u32 to i32. (#1016)
• EmbeddedSource::get_contents_bounded now replaces EmbeddedSource::get_contents. (#1016)
• Removed the deprecated BreakpadErrorKind::BadSyntax variant. (#1024)

Dependencies

• Bump pdb-addr2line to 0.12.0. This includes a switch from pdb to pdb2. (#1018)

Breaking Changes

• SourceBundleWriter::finish now returns the underlying writer. (#1016)
• FormatErrorKind::InvalidBlobFormat is changed from u32 to i32. (#1016)
• EmbeddedSource::get_contents_bounded now replaces EmbeddedSource::get_contents. (#1016)
• Removed the deprecated BreakpadErrorKind::BadSyntax variant. (#1024)

Dependencies

• Bump pdb-addr2line to 0.12.0. This includes a switch from pdb to pdb2. (#1018)

Fixes

• Handle XML parsing without recursion. (#1003)

Fixes

• Handle XML parsing without recursion. (#1003)

• No documented changes.

• No documented changes.

Fixes

• Add limit on inline nesting depth when parsing Breakpad objects. (#1014)
• Fix potential out of bounds panic on invalid section offsets (#1013)
• Fix a potential panic when locating sections in an elf file. (#1012)

Fixes

• Add limit on inline nesting depth when parsing Breakpad objects. (#1014)
• Fix potential out of bounds panic on invalid section offsets (#1013)
• Fix a potential panic when locating sections in an elf file. (#1012)

Features

• Add limit on chained UNWIND_INFO traversal in CFI generation. (#1007)

Features

• Add limit on chained UNWIND_INFO traversal in CFI generation. (#1007)

Features

• Add recursion limit to vendored msvc-demangler. (#1006)
• Vendor msvc-demangler. (#998)
• WASM: expose il2cppLineMapping(object, provider), which extracts a Unity Il2cpp C++→C# line mapping by parsing source_info markers from an object's referenced C++ source files and returns it as a JSON document (or undefined when no mappings are found). Source file contents are supplied by a (path) => Uint8Array | null provider callback, so it works without filesystem access. symbolic-il2cpp also gains ObjectLineMapping::from_object_with_provider, the filesystem-free counterpart of from_object. (#1005)
• WASM: expose ObjectFile.asPe() to narrow an object to a PeFile, and PeFile.embeddedPpdb() returning the decompressed Portable PDB embedded in a managed Windows PE (a standalone, parseable debug information file), or undefined when there is no embedded PPDB. (#1004)

Fixes

• Fix bugs in the vendored msvc-demangler lib. (#1008)

Dependencies

• Bump the memmap2 floor to 0.9.11 to exclude versions affected by RUSTSEC-2026-0186. (#996)

Features

• Add recursion limit to vendored msvc-demangler. (#1006)
• Vendor msvc-demangler. (#998)
• WASM: expose il2cppLineMapping(object, provider), which extracts a Unity Il2cpp C++→C# line mapping by parsing source_info markers from an object's referenced C++ source files and returns it as a JSON document (or undefined when no mappings are found). Source file contents are supplied by a (path) => Uint8Array | null provider callback, so it works without filesystem access. symbolic-il2cpp also gains ObjectLineMapping::from_object_with_provider, the filesystem-free counterpart of from_object. (#1005)
• WASM: expose ObjectFile.asPe() to narrow an object to a PeFile, and PeFile.embeddedPpdb() returning the decompressed Portable PDB embedded in a managed Windows PE (a standalone, parseable debug information file), or undefined when there is no embedded PPDB. (#1004)

Fixes

• Fix bugs in the vendored msvc-demangler lib. (#1008)

Dependencies

• Bump the memmap2 floor to 0.9.11 to exclude versions affected by RUSTSEC-2026-0186. (#996)

Fixes

• Fix function range to addr/line resolution, this fixes a case where WASM binaries compiled with Emscripten failed to have their source code mappings resolved. (#1002)

Fixes

• Fix function range to addr/line resolution, this fixes a case where WASM binaries compiled with Emscripten failed to have their source code mappings resolved. (#1002)

Features

• symbolic-debuginfo: Add a new option max_decompressed_embedded_source_size to ParseObjectOptions. This option limits the sizes of compressed embedded source files
  when they are returned from methods like source_by_path. (#999)

Features

• symbolic-debuginfo: Add a new option max_decompressed_embedded_source_size to ParseObjectOptions. This option limits the sizes of compressed embedded source files when they are returned from methods like source_by_path. (#999)

Features

• WASM: expose ObjectFile.debugSession() returning a DebugSession with files() (the source files referenced by the object) and sourceByPath(path) (resolving embedded contents or a source link). symbolic-debuginfo also implements AsSelf for ObjectDebugSession so it can be held in a SelfCell. (#997)

Features

• WASM: expose ObjectFile.debugSession() returning a DebugSession with files() (the source files referenced by the object) and sourceByPath(path) (resolving embedded contents or a source link). symbolic-debuginfo also implements AsSelf for ObjectDebugSession so it can be held in a SelfCell. (#997)

Features

• symbolic-debuginfo: add SourceBundleWriter::write_object_with_filter_and_provider, which builds a source bundle from caller-supplied source content instead of relying on the local filesystem. (#988)

Fixes

• Fix issue with overflowing section offsets in 64bit Mach-O files. (#985)

Changes

• Rework WASM API to expose lower level symbolic types. (#992)
• symbolic-debuginfo: use the C zstd library on wasm32 too (via zstd-sys's wasm-shim), replacing the ruzstd decoder added in #989. One zstd implementation for all targets; ruzstd is no longer a dependency. Building for wasm now requires clang. (#990)

Features

• symbolic-debuginfo: add SourceBundleWriter::write_object_with_filter_and_provider, which builds a source bundle from caller-supplied source content instead of relying on the local filesystem. (#988)

Fixes

• Fix issue with overflowing section offsets in 64bit Mach-O files. (#985)

Changes

• Rework WASM API to expose lower level symbolic types. (#992)
• symbolic-debuginfo: use the C zstd library on wasm32 too (via zstd-sys's wasm-shim), replacing the ruzstd decoder added in #989. One zstd implementation for all targets; ruzstd is no longer a dependency. Building for wasm now requires clang. (#990)

Changes

• symbolic-debuginfo: select the C zstd library (native) vs the pure-Rust ruzstd decoder (wasm32) via cfg(target_arch) instead of the elf-zstd/elf-zstd-pure features. features = ["elf"] again includes zstd support on native (the feature split in #986 had silently removed it). ruzstd was bumped to 0.8.3 and now rejects size mismatches instead of truncating. (#989)

Features

• Add WebAssembly bindings (symbolic-wasm crate) published to npm as @sentry/symbolic, for parsing debug information files from JavaScript. (#986)

Changes

• symbolic-debuginfo: the zstd dependency moved out of the elf feature into a new elf-zstd feature (kept in default, so default builds are unchanged). Consumers using default-features = false with elf should add elf-zstd to keep decompressing zstd-compressed ELF debug sections, or elf-zstd-pure for a pure-Rust (wasm-compatible) decoder. (#986)

Features

• Add parsing options for object files. (#984)

Features

• Add support for win arm64 PE unwind codes (#978)

Fixes

• Disable PE import table parser and be more permissive during parsing. (#964)

Features

• Updated libswift demangle to v6.3.1. (#980)

Features

• Extract srcsrv data from PDB for file mapping by @mujajica and @loewenheim. This includes a bump of the SymCache format to version 9. (#943)

Dependencies

• Update several publicly exposed dependencies:
  • gimli: 0.32.3 -> 0.33.0
  • goblin: 0.8.0 -> 0.10.5
  • scroll: 0.12.0 -> 0.13.0 (#976)

Internal Changes 🔧

• (js) Allow magic comments to appear anywhere by @Dav1dde in #974

• Downgrade cpp_demangle version to 0.4.1. Symbolicator is currently dependent on this. (#972)

Improvements

• sourcemapcache: Bump js-source-scopes to 0.7.2. This improves name resolution via https://github.com/getsentry/js-source-scopes/pull/35. (#970)

Improvements

• symcache: Change internal representation to enable old versions to remain parseable. (#947)
• feat: Add Unreal4File::into_bytes. (#967)

Fixes

• Revert "Use goblin permissive PE parse-mode". This change breaks API compatibility and should not have been released in a patch version. (#966)

Improvements

• Enable symbolize and CFI by default in examples/minidump_stackwalk, and replace their corresponding flags --symbolize and --cfi with --no-symbolize and --no-cfi respectively. (#963)

Fixes

• Use goblin permissive PE parse-mode (#960)
• DWARF: Correctly detect languages in LTO-compiled binaries (#961)

Fixes

• symcache: Fixed an unsound implementation of Pod (#958)

Fixes

• minidump: Define default .ra rules for PPC and ARM (#949)

• feat(pdb): Extract the srcsrv integration name for metrics (#944)

• feat(elf): Added support for dynamic symbols when DYNAMIC segment is missing. (#935)
• fix(dwarf): -2 is now an allowed tombstone address in some DWARF sections. For details, see https://github.com/gimli-rs/gimli/pull/791. (#937).

Fixes

• sourcemapcache: Tokens are now considered to only extend to the end of the line (as intended). This means that some lookups that would previously (incorrectly) have returned unminified source positions now return nothing. (#932)

Fixes

• symcache: Fixed a bug in symcache generation for functions without line records. (#930)

Features

• python bindings: Expose SourceMapView.get_source_contents function. (#921)
• Change the MSRV version to 1.82. (#927)
• build: switch to Python3.11 for releases builds. (#929)

Fixes

• sourcemapcache: Don't return unmapped source locations. (#922)

Fixes

• demangle: Fixed a crash/abort when providing bad input to the swift demangler. (#917)

Fixes

• symcache: Fixed a bug introduced in 12.14.0 that resulted in symbols not being inserted. (#915)

Features

• Allow specifying multiple symbol sources in minidump-stackwalk utility. (#903)
• Add a subcommand to extract individual files from a unreal crash report to the unreal_engine_crash utility. (#907)

Fixes

• Do not hallucinate frames when stack walking in minidump-stackwalk utility. (#904)

Improvements

• Add normalization for paths in FileKey. (#908)

Fixes

• Restore support for older Rust versions and clarify MSRV policy. (#902)

Features

• Expose API to apply access pattern hints to a ByteView.(#899).

Fixes

• symcache: Explicitly map "holes" between functions (#897)

Fixes

• Parse debug_str_offs section in Mach-O files (#895)

Improvements

• Check UTF-8 validity memory efficiently (#890)

Fixes

• Fixed GHA-based Windows builds (#891).

Fixes

• Fixed a compilation issue with older GCC compilers. (#886)

Features

• Updated libswift demangle to v6.0.3. (#885)

Fixes

• symcache: Fixed a bug related to to inlinee resolution during symcache conversion. (#883)

Fixes

• js: Prefer "debug_id" for sourcemap debug IDs. (#878).

Fixes

• js: Fixed an error when reading debug IDs from sourcemaps with both "debugId" and "debug_id" keys (#877).

Features

• feat(js): Sourcemap debug IDs can now be read from the "debugId" field in addition to "debug_id" (#870).

Fixes

• Unship "Support for DWARFv5 embedded source code extension (#849)". Unfortunately the check for whether an elf file contains embedded sources is prohibitively expensive in terms of memory. (#870)

Fixes

• symbolic-cfi: Skip invalid FDEs when converting DWARF to Breakpad CFI (#868)

Internal:

• Removed dmsort dependency and replaced uses with stable std sorts. (#869)

• Add callback to symbolic::debuginfo::sourcebundle::SourceBundleWriter which handles files skipped while writing to the source bundle. (#864)

• Skip invalid sources (#861)

Features

• Support for DWARFv5 embedded source code extension (#849)
• Updated wasmparser dependency to 0.214.0 (#849)

• Downgrade and pin zip to fix SourceBundles with >64k files (#846)

Features

• Add support for reading zstd compressed ELF debug section (#843)

Fixes

• sourcebundles: Only valid UTF-8 files can be written into sourcebundles (#816)
• Fix an issue when extracting the name of the debug file from a PE object (#825)

Internal

• Update tokio to latest version (#833)
• Fix infinite recursion caused by indirect self-references when resolving function names (#836)
• Switch to workspace dependencies (#841)

Features

• Make mapping by params initialization optional (#823)

Internal

• Update crate dependencies, in particular gimli to fix performance/OOM problems related to duplicated abbreviations (#822)

Fixes

• Fix empty parameters list issue (#821)

Features

• Add support for parameters param in the remap_frame to allow deobfuscation when line is not available (#820)

Internal

• Emit a MODULE record for PE files (#814)

Features

• Update proguard and add remap_method fn (#818)

Fixes

• sourcebundles: Don't write empty source_links maps (#813)

Fixes

• discover_sourcemaps_location returns source mapping URLs without query parameters or fragments (#809)

Internal

• Updated gimli, goblin, indexmap, and minidump dependencies (#811)
• Cargo.lock is now included in the repository (#811)