Skip to content

MIGRATION.md

Latest commit

 

History

History
28 lines (19 loc) · 1.17 KB

MIGRATION.md

File metadata and controls

28 lines (19 loc) · 1.17 KB

Migration Guide

source-map-links is an independent alternative or migration helper for projects moving away from source-map-resolve. It is not affiliated with the original package maintainers or project.

First Command

npm install source-map-links

Migration Target

  • Source package: source-map-resolve
  • Replacement package: source-map-links
  • Source signal: npm deprecation notice points to upstream deprecation guidance
  • Migration direction: Source map comment discovery, data URL parsing, URL resolution, and source content helpers.

Compatibility Posture

  • Preserved: sourceMappingURL discovery, source map resolution, source URL resolution, and sync/async pipeline support.
  • Improved: Data URL parsing, XSSI prefix stripping, typed source-map objects, and explicit read callbacks.
  • Intentional difference: File system and network loading are caller-provided to keep the package dependency-free.

Review Checklist

  • Replace the old dependency at one migration boundary first.
  • Run the package or application test suite after the swap.
  • Keep attribution accurate: this package is independent and is not an official successor to source-map-resolve.