AwesomeREA.org

Tool

shuji

Command-line tool that writes the original JavaScript and CSS sources embedded in source maps back out as files. It reads .map files, or JavaScript and CSS files whose sourceMappingURL holds an inline Base64 or URL-encoded map or points to a map in the same folder, and can walk directories with a regular-expression filter. Output is flattened to file names by default, or keeps the map's folder structure with --preserve.

Requirements and limitations

  • npm release at review: shuji 0.8.0, published 2023-12-04, which requires Node.js 14.15.0+; the repository publishes tags but no GitHub releases. The reviewed main commit is 139 commits ahead and unreleased: it raises the minimum to Node.js 24.12.0, which the README already states, moves linting to Oxlint and, since 2026-10-11, rejects output paths that would escape the output directory.
  • Install the CLI globally with npm and run it on a file or directory with -o for the output directory; the default filter only picks .map files, so -M is needed to scan .js or .css files for inline maps. Maps are read from local files only: a referenced map must sit relative to the code file, and remote maps are not fetched.
  • Only sources whose content is embedded in the map's sourcesContent are written; entries that list a path without content are skipped, so maps built without included sources yield nothing for them. Existing files are never overwritten, so flattened sources with the same file name are skipped unless --preserve is used.
  • MIT. Recovered files remain the original authors' code under their own terms, so analyze only source maps you may inspect. No source maps were processed for this entry.

About this entry

Type
Tool
Category
Website analysis tools
Relationship
Foundation tool
Targets
Website

Sources reviewed

The description was reviewed against primary sources. This does not establish runtime testing, security auditing or verified compatibility.

Primary sources

  1. README.md GitHub · paazmaya/shuji · Revision a97c6df
  2. package.json GitHub · paazmaya/shuji · Revision a97c6df
  3. CHANGELOG.md GitHub · paazmaya/shuji · Revision a97c6df
  4. lib/find-map.js GitHub · paazmaya/shuji · Revision a97c6df
  5. lib/read-sources.js GitHub · paazmaya/shuji · Revision a97c6df
  6. lib/write-sources.js GitHub · paazmaya/shuji · Revision a97c6df
  7. LICENSE GitHub · paazmaya/shuji · Revision a97c6df
  8. https://www.npmjs.com/package/shuji/v/0.8.0