exorcist/index.js

'use strict';

var convert = require('convert-source-map')
  , path = require('path')
  , fs = require('fs')
  , through = require('through2');

function separate(src, file, root, url) {
  var inlined = convert.fromSource(src);

  if (!inlined) return null;

  var json = inlined
    .setProperty('sourceRoot', root || '')
    .toJSON(2);

  url = url || path.basename(file);

  var newSrc = convert.removeComments(src);
  var comment = '//# sourceMappingURL=' + url;

  return { json: json, src: newSrc + '\n' + comment }
}

var go = module.exports = 

/**
 * Transforms the incoming stream of code by removing the inlined source map and writing it to an external map file.
 * Additionally it adds a source map url that points to the extracted map file.
 * 
 * @name exorcist
 * @function
 * @param {String} file full path to the map file to which to write the extracted source map
 * @param {String=} url  allows overriding the url at which the map file is found (default: name of map file)
 * @param {String=} root allows adjusting the source maps `sourceRoot` field (default: '')
 * @return {TransformStream} transform stream into which to pipe the code containing the source map
 */
function exorcist(file, url, root) {
  var src = '';

  function ondata(d, _, cb) { src += d; cb(); }
  function onend(cb) {
    var self = this;
    var separated = separate(src, file, root, url);
    if (!separated) {
      self.emit(
          'missing-map'
        ,   'The code that you piped into exorcist contains no source map!\n'
          + 'Therefore it was piped through as is and no external map file generated.'
      );
      self.push(src);
      return cb(); 
    }
    self.push(separated.src);
    fs.writeFile(file, separated.json, 'utf8', cb)
  }

  return through(ondata, onend);
}