@teamscale/javascript-instrumenter 1.0.0-beta.6 → 1.0.4

package/dist/src/instrumenter/FileSystem.js

@@ -1,134 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isExistingFile = isExistingFile;
-exports.isExistingDirectory = isExistingDirectory;
-exports.ensureExistingDirectory = ensureExistingDirectory;
-exports.findSubFolders = findSubFolders;
-exports.isDirectoryEmpty = isDirectoryEmpty;
-exports.expandToFileSet = expandToFileSet;
-exports.sourceMapFromMapFile = sourceMapFromMapFile;
-exports.replaceNonFilesystemCharacters = replaceNonFilesystemCharacters;
-const commons_1 = require("@cqse/commons");
-const fs = __importStar(require("fs"));
-const mkdirp = __importStar(require("mkdirp"));
-const path_1 = __importDefault(require("path"));
-const glob_1 = require("glob");
-/**
- * Does the given `path` point to an existing file?
- */
-function isExistingFile(path) {
-    return fs.existsSync(path) && fs.lstatSync(path).isFile();
-}
-/**
- * Does the given `path` point to an existing directory?
- */
-function isExistingDirectory(path) {
-    return fs.existsSync(path) && fs.lstatSync(path).isDirectory();
-}
-/**
- * Ensure that the given directory `path` exists.
- */
-function ensureExistingDirectory(path) {
-    if (!fs.existsSync(path)) {
-        mkdirp.sync(path);
-    }
-    if (!fs.lstatSync(path).isDirectory()) {
-        throw new commons_1.InvalidConfigurationException(`The specified path '${path}' does not point to an existing directory!`);
-    }
-}
-/**
- * Given a root folder find a folder with a given name.
- */
-function findSubFolders(startFromFolder, folderName) {
-    const matches = [];
-    const entries = fs.readdirSync(startFromFolder, { withFileTypes: true });
-    for (const entry of entries) {
-        const fullPath = path_1.default.join(startFromFolder, entry.name);
-        if (entry.name === folderName && entry.isDirectory()) {
-            matches.push(fullPath);
-        }
-        if (entry.isDirectory()) {
-            const nestedMatches = findSubFolders(fullPath, folderName);
-            matches.push(...nestedMatches);
-        }
-    }
-    return matches;
-}
-/**
- * Is the given directory empty?
- */
-function isDirectoryEmpty(path) {
-    return !isExistingDirectory(path) || fs.readdirSync(path).length > 0;
-}
-/**
- * Expand a given Glob pattern to a list of files.
- *
- * @param toExpand - The Glob pattern.
- */
-function expandToFileSet(toExpand) {
-    let globPattern = toExpand;
-    if (fs.existsSync(toExpand)) {
-        const stat = fs.lstatSync(toExpand, {});
-        if (stat.isFile()) {
-            return [toExpand];
-        }
-        if (stat.isDirectory()) {
-            globPattern = `${toExpand}${path_1.default.sep}**`;
-        }
-    }
-    return glob_1.glob.sync(globPattern, { nodir: true });
-}
-/**
- * Read a source map from a source map file.
- *
- * @param mapFilePath
- */
-function sourceMapFromMapFile(mapFilePath) {
-    const content = fs.readFileSync(mapFilePath, 'utf8');
-    return JSON.parse(content);
-}
-/**
- * Ensure that the given name works as a file or folder name.
- */
-function replaceNonFilesystemCharacters(name) {
-    // Replace undesired characters by underscore chars.
-    const result = name.replace(/[^a-zA-Z0-9_\-.\\/]/g, '_');
-    // Remove repeated underscores (_) from `result.
-    return result.replace(/_+/g, '_');
-}

package/dist/src/instrumenter/Instrumenter.d.ts

@@ -1,92 +0,0 @@
-import { FileExcludePattern, InstrumentationTask, OriginSourcePattern, SourceMapReference, TaskElement, TaskResult } from './Task';
-import { RawSourceMap, SourceMapConsumer } from 'source-map';
-import Logger from 'bunyan';
-import { CollectorSpecifier, CoverageBucketSpecifier } from '@src/vaccine/types';
-export declare const IS_INSTRUMENTED_TOKEN = "$IS_JS_PROFILER_INSTRUMENTED=true";
-/**
- * An instrumenter that can conduct a {@code InstrumentationTask}.
- */
-export interface IInstrumenter {
-    /**
-     * Perform the given instrumentation task.
-     *
-     * @param task - The instrumentation task to conduct.
-     */
-    instrument(task: InstrumentationTask): Promise<TaskResult>;
-}
-/**
- * An instrumenter based on the IstanbulJs instrumentation and coverage framework.
- */
-export declare class IstanbulInstrumenter implements IInstrumenter {
-    /**
-     * The vaccine to inject. The vaccine is a JavaScript
-     * file with the code to forward the coverage information
-     * produced by the Istanbul instrumentation.
-     */
-    private readonly vaccineSource;
-    /**
-     * The logger instance to log to.
-     */
-    private logger;
-    constructor(vaccineFilePath: string, logger: Logger, collector: CollectorSpecifier, targetBucket: CoverageBucketSpecifier);
-    /**
-     * {@inheritDoc #IInstrumenter.instrument}
-     */
-    instrument(task: InstrumentationTask): Promise<TaskResult>;
-    /**
-     * Perform the instrumentation for one given task element (file to instrument).
-     *
-     * @param collector - The collector to send the coverage information to.
-     * @param taskElement - The task element to perform the instrumentation for.
-     * @param excludeBundles - A exclude pattern to restrict which bundles should be instrumented
-     * @param sourcePattern - A pattern to restrict the instrumentation to only a fraction of the task element.
-     * @param dumpOriginsFile - A file path where all origins from the source map should be dumped in json format, or undefined if no origins should be dumped
-     */
-    instrumentOne(taskElement: TaskElement, excludeBundles: FileExcludePattern, sourcePattern: OriginSourcePattern, dumpOriginsFile: string | undefined): Promise<TaskResult>;
-    private instrumentBundle;
-    private writeBundleFile;
-    /**
-     * Loads the vaccine from the vaccine file and adjusts some template parameters.
-     *
-     * @param filePath - The path to the vaccine file.
-     * @param collector - The collector to send coverage information to.
-     * @param targetBucket - The bucket within the collector to put the coverage into.
-     */
-    private loadVaccine;
-    /**
-     * @returns whether the given file is supported for instrumentation.
-     */
-    private isFileTypeSupported;
-    /**
-     * Determine the list of configurations to try conducting the
-     * given task element.
-     */
-    private configurationAlternativesFor;
-    /** Deletes the file if it exists, such that it is now ready to be appended. */
-    private clearFile;
-    /** Write the contents of the given object into the given file, if provided. */
-    private dumpToJson;
-}
-/**
- * Extract the sourcemap from the given source code.
- *
- * @param instrumentedSource - The source code.
- * @param instrumentedSourceFileName - The file name to assume for the file name.
- */
-export declare function loadSourceMap(instrumentedSource: string, instrumentedSourceFileName: string): Promise<SourceMapConsumer | undefined>;
-/**
- * Given a source code file, load the corresponding sourcemap.
- *
- * @param inputSource - The source code that might contain sourcemap comments.
- * @param taskFile - The name of the file the `inputSource` is from.
- * @param externalSourceMapFile - An external source map file to consider.
- */
-export declare function loadInputSourceMap(inputSource: string, taskFile: string, externalSourceMapFile?: SourceMapReference): RawSourceMap | undefined;
-/**
- * Extract a sourcemap for a given code comment.
- *
- * @param sourcecode - The source code that is scanned for source map comments.
- * @param sourceFilePath - The file name the code was loaded from.
- */
-export declare function sourceMapFromCodeComment(sourcecode: string, sourceFilePath: string): RawSourceMap | undefined;
-//# sourceMappingURL=Instrumenter.d.ts.map

package/dist/src/instrumenter/Instrumenter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Instrumenter.d.ts","sourceRoot":"","sources":["../../../src/instrumenter/Instrumenter.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,kBAAkB,EAElB,mBAAmB,EACnB,mBAAmB,EAEnB,kBAAkB,EAElB,WAAW,EACX,UAAU,EACV,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAM7D,OAAO,MAAM,MAAM,QAAQ,CAAC;AAO5B,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAEjF,eAAO,MAAM,qBAAqB,sCAAsC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC3D;AA0BD;;GAEG;AACH,qBAAa,oBAAqB,YAAW,aAAa;IACzD;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IAEvC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAS;gBAEX,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,YAAY,EAAE,uBAAuB;IAUzH;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IA2BhE;;;;;;;;OAQG;IACG,aAAa,CAClB,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,kBAAkB,EAClC,aAAa,EAAE,mBAAmB,EAClC,eAAe,EAAE,MAAM,GAAG,SAAS,GACjC,OAAO,CAAC,UAAU,CAAC;YAsER,gBAAgB;IA8C9B,OAAO,CAAC,eAAe;IA0BvB;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAQnB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAiBpC,+EAA+E;IAC/E,OAAO,CAAC,SAAS;IAUjB,+EAA+E;IAC/E,OAAO,CAAC,UAAU;CAYlB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAClC,kBAAkB,EAAE,MAAM,EAC1B,0BAA0B,EAAE,MAAM,GAChC,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAUxC;AAsBD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CACjC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,qBAAqB,CAAC,EAAE,kBAAkB,GACxC,YAAY,GAAG,SAAS,CAU1B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAwC7G"}

package/dist/src/instrumenter/Instrumenter.js

@@ -1,376 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.IstanbulInstrumenter = exports.IS_INSTRUMENTED_TOKEN = void 0;
-exports.loadSourceMap = loadSourceMap;
-exports.loadInputSourceMap = loadInputSourceMap;
-exports.sourceMapFromCodeComment = sourceMapFromCodeComment;
-const Task_1 = require("./Task");
-const commons_1 = require("@cqse/commons");
-const source_map_1 = require("source-map");
-const istanbul = __importStar(require("@teamscale/lib-instrument"));
-const fs = __importStar(require("fs"));
-const mkdirp = __importStar(require("mkdirp"));
-const path = __importStar(require("path"));
-const convertSourceMap = __importStar(require("convert-source-map"));
-const async_1 = __importDefault(require("async"));
-const WebToolkit_1 = require("./WebToolkit");
-const FileSystem_1 = require("./FileSystem");
-exports.IS_INSTRUMENTED_TOKEN = '$IS_JS_PROFILER_INSTRUMENTED=true';
-function readBundle(bundleContent, taskElement) {
-    const baseNameMatch = path.basename(taskElement.fromFile).match('^([a-zA-Z0-9]*).cache.js');
-    const directories = path.dirname(taskElement.fromFile).split(path.sep);
-    if (baseNameMatch && directories.length > 1) {
-        const fragmentId = (0, WebToolkit_1.determineGwtFileUid)(taskElement.fromFile);
-        const functionCall = bundleContent.match('^([^(]+)\\((.*)\\);*\\s*$');
-        if (fragmentId && functionCall && functionCall.length === 3) {
-            const callInfos = (0, WebToolkit_1.extractGwtCallInfos)(bundleContent);
-            if (callInfos) {
-                return {
-                    type: 'gwt',
-                    content: bundleContent,
-                    fragmentId,
-                    functionName: callInfos.functionName,
-                    codeAsArrayArgument: callInfos.codeAsArrayArgument,
-                    codeArguments: callInfos.codeArguments
-                };
-            }
-        }
-    }
-    return { type: 'javascript', content: bundleContent, codeArguments: [bundleContent] };
-}
-/**
- * An instrumenter based on the IstanbulJs instrumentation and coverage framework.
- */
-class IstanbulInstrumenter {
-    constructor(vaccineFilePath, logger, collector, targetBucket) {
-        commons_1.Contract.require(fs.existsSync(vaccineFilePath), `The vaccine file to inject "${vaccineFilePath}" must exist!\nCWD:${process.cwd()}`);
-        this.vaccineSource = this.loadVaccine(commons_1.Contract.requireNonEmpty(vaccineFilePath), collector, targetBucket);
-        this.logger = logger;
-    }
-    /**
-     * {@inheritDoc #IInstrumenter.instrument}
-     */
-    async instrument(task) {
-        this.clearFile(task.dumpOriginsFile);
-        this.clearFile(task.dumpMatchedOriginsFile);
-        // We limit the number of instrumentations in parallel to one to
-        // not overuse memory (NodeJS has only limited mem to use).
-        const result = await async_1.default
-            .mapLimit(task.elements, 1, async (taskElement) => {
-            return await this.instrumentOne(taskElement, task.excludeFilesPattern, task.originSourcePattern, task.dumpOriginsFile);
-        })
-            .then(results => {
-            return results.reduce((prev, curr) => {
-                return prev.withIncrement(curr);
-            }, Task_1.TaskResult.neutral(task));
-        });
-        // Write the matching statistics to a JSON
-        this.dumpToJson(task.dumpMatchedOriginsFile, task.originSourcePattern.retrieveMatchingFiles());
-        return result;
-    }
-    /**
-     * Perform the instrumentation for one given task element (file to instrument).
-     *
-     * @param collector - The collector to send the coverage information to.
-     * @param taskElement - The task element to perform the instrumentation for.
-     * @param excludeBundles - A exclude pattern to restrict which bundles should be instrumented
-     * @param sourcePattern - A pattern to restrict the instrumentation to only a fraction of the task element.
-     * @param dumpOriginsFile - A file path where all origins from the source map should be dumped in json format, or undefined if no origins should be dumped
-     */
-    async instrumentOne(taskElement, excludeBundles, sourcePattern, dumpOriginsFile) {
-        // Not all file types are supported by the instrumenter
-        if (!this.isFileTypeSupported(taskElement.fromFile)) {
-            if (!taskElement.isInPlace()) {
-                copyToFile(taskElement.toFile, taskElement.fromFile);
-            }
-            return new Task_1.TaskResult(0, 0, 0, 0, 1, 0, 0);
-        }
-        // Read the (supported) file
-        const bundleContent = fs.readFileSync(taskElement.fromFile, 'utf8');
-        const inputBundle = readBundle(bundleContent, taskElement);
-        // We skip files that we have already instrumented
-        if (inputBundle.content.substring(0, Math.min(inputBundle.content.length, 100)).includes(exports.IS_INSTRUMENTED_TOKEN)) {
-            if (!taskElement.isInPlace()) {
-                writeToFile(taskElement.toFile, inputBundle.content);
-            }
-            return new Task_1.TaskResult(0, 0, 0, 1, 0, 0, 0);
-        }
-        // We might want to skip the instrumentation of the file
-        if (excludeBundles.isExcluded(taskElement.fromFile)) {
-            if (!taskElement.isInPlace()) {
-                copyToFile(taskElement.toFile, taskElement.fromFile);
-            }
-            return new Task_1.TaskResult(0, 1, 0, 0, 0, 0, 0);
-        }
-        // Report progress
-        this.logger.info(`Instrumenting "${path.basename(taskElement.fromFile)}"`);
-        // Load the bundles source maps
-        const inputSourceMaps = loadInputSourceMaps(taskElement.fromFile, inputBundle, taskElement.externalSourceMapFile);
-        if (inputSourceMaps.length === 0) {
-            return Task_1.TaskResult.warning(`Failed loading input source map for ${taskElement.fromFile}.`);
-        }
-        // We try to perform the instrumentation with different
-        // alternative configurations of the instrumenter.
-        const configurationAlternatives = this.configurationAlternativesFor(taskElement);
-        for (let i = 0; i < configurationAlternatives.length; i++) {
-            const configurationAlternative = configurationAlternatives[i];
-            try {
-                return await this.instrumentBundle(taskElement, inputBundle, inputSourceMaps, configurationAlternative, dumpOriginsFile, sourcePattern);
-            }
-            catch (e) {
-                // If also the last configuration alternative failed,
-                // we emit a corresponding warning or signal an error.
-                if (i === configurationAlternatives.length - 1) {
-                    writeToFile(taskElement.toFile, inputBundle.content);
-                    return Task_1.TaskResult.error(e);
-                }
-            }
-        }
-        return new Task_1.TaskResult(0, 0, 0, 0, 0, 1, 0);
-    }
-    async instrumentBundle(taskElement, inputBundle, inputSourceMaps, configurationAlternative, dumpOriginsFile, sourcePattern) {
-        var _a;
-        // Based on the source maps of the file to instrument, we can now
-        // decide if we should NOT write an instrumented version of it
-        // and use the original code instead and write it to the target path.
-        //
-        for (const inputSourceMap of inputSourceMaps.filter(map => map)) {
-            const originSourceFiles = (_a = inputSourceMap === null || inputSourceMap === void 0 ? void 0 : inputSourceMap.sources) !== null && _a !== void 0 ? _a : [];
-            if (dumpOriginsFile) {
-                this.dumpToJson(dumpOriginsFile, originSourceFiles);
-            }
-        }
-        // The main instrumentation (adding coverage statements) is performed now:
-        const instrumenter = istanbul.createInstrumenter(configurationAlternative);
-        const instrumentedSources = [];
-        for (let i = 0; i < inputBundle.codeArguments.length; i++) {
-            const shouldInstrument = (node, originLocation) => {
-                if (!originLocation.filename) {
-                    return false;
-                }
-                return sourcePattern.isIncluded(originLocation.filename);
-            };
-            const instrumented = await instrumenter.instrument(inputBundle.codeArguments[i], taskElement.fromFile, inputSourceMaps[i], shouldInstrument);
-            instrumentedSources.push(instrumented);
-        }
-        this.writeBundleFile(taskElement.toFile, inputBundle, instrumentedSources);
-        return new Task_1.TaskResult(1, 0, 0, 0, 0, 0, 0);
-    }
-    writeBundleFile(toFile, inputBundle, instrumentedSources) {
-        if (inputBundle.type === 'gwt') {
-            commons_1.Contract.require(instrumentedSources.length === 1, 'Assuming only one code fragment to be passed as argument.');
-            const processedCodeString = JSON.stringify(`${this.vaccineSource} ${instrumentedSources[0]}`);
-            if (inputBundle.codeAsArrayArgument) {
-                writeToFile(toFile, `${exports.IS_INSTRUMENTED_TOKEN} ${inputBundle.functionName}([${processedCodeString}]);`);
-            }
-            else {
-                writeToFile(toFile, `${exports.IS_INSTRUMENTED_TOKEN} ${inputBundle.functionName}(${processedCodeString});`);
-            }
-        }
-        else {
-            commons_1.Contract.require(instrumentedSources.length === 1, 'Assuming only one code fragment to be passed as argument for JavaScript bundles.');
-            writeToFile(toFile, instrumentedSources[0]);
-        }
-    }
-    /**
-     * Loads the vaccine from the vaccine file and adjusts some template parameters.
-     *
-     * @param filePath - The path to the vaccine file.
-     * @param collector - The collector to send coverage information to.
-     * @param targetBucket - The bucket within the collector to put the coverage into.
-     */
-    loadVaccine(filePath, collector, targetBucket) {
-        // We first replace parameters in the file with the
-        // actual values, for example, the collector to send the coverage information to.
-        return fs.readFileSync(filePath, 'utf8')
-            .replace(/\$COLLECTOR_SPECIFIER/g, JSON.stringify(collector))
-            .replace(/\$BUCKET_SPECIFIER/g, Buffer.from(JSON.stringify(targetBucket)).toString('base64'));
-    }
-    /**
-     * @returns whether the given file is supported for instrumentation.
-     */
-    isFileTypeSupported(fileName) {
-        if (fileName.endsWith('.devmode.js') || fileName.endsWith('.nocache.js')) {
-            // GWT dev mode files.
-            return false;
-        }
-        const ext = path.extname(fileName).toLowerCase();
-        return ext === '.js' || ext === '.mjs';
-    }
-    /**
-     * Determine the list of configurations to try conducting the
-     * given task element.
-     */
-    configurationAlternativesFor(taskElement) {
-        this.logger.trace(`Determining configuration alternatives for ${taskElement.fromFile}`);
-        const baseConfig = {
-            isInstrumentedToken: exports.IS_INSTRUMENTED_TOKEN,
-            produceSourceMap: 'none',
-            codeToPrepend: this.vaccineSource,
-            preserveComments: false, // Will remove commends including old source maps that are provided inline as comments
-            compact: false // Would lead to `code generator has deoptimised the styling of` errors otherwise
-        };
-        return [
-            { ...baseConfig, ...{ esModules: true } },
-            { ...baseConfig, ...{ esModules: false } }
-        ];
-    }
-    /** Deletes the file if it exists, such that it is now ready to be appended. */
-    clearFile(filePath) {
-        if (filePath && fs.existsSync(filePath)) {
-            try {
-                fs.unlinkSync(filePath);
-            }
-            catch (err) {
-                this.logger.warn(`Could not clear file ${filePath}:` + err);
-            }
-        }
-    }
-    /** Write the contents of the given object into the given file, if provided. */
-    dumpToJson(targetFilePath, toDump) {
-        if (!targetFilePath) {
-            return;
-        }
-        const jsonContent = JSON.stringify(toDump, null, 2);
-        fs.writeFile(targetFilePath, jsonContent + '\n', { flag: 'a' }, error => {
-            if (error) {
-                this.logger.warn(`Could not dump JSON to file ${targetFilePath}:` + error.message);
-            }
-        });
-    }
-}
-exports.IstanbulInstrumenter = IstanbulInstrumenter;
-/**
- * Extract the sourcemap from the given source code.
- *
- * @param instrumentedSource - The source code.
- * @param instrumentedSourceFileName - The file name to assume for the file name.
- */
-async function loadSourceMap(instrumentedSource, instrumentedSourceFileName) {
-    const instrumentedSourceMap = loadInputSourceMap(instrumentedSource, instrumentedSourceFileName, undefined);
-    if (instrumentedSourceMap) {
-        return await new source_map_1.SourceMapConsumer(instrumentedSourceMap);
-    }
-    return undefined;
-}
-function loadInputSourceMaps(taskFile, bundleFile, externalSourceMapFile) {
-    if ((0, WebToolkit_1.isGwtBundle)(bundleFile)) {
-        return (0, WebToolkit_1.loadInputSourceMapsGwt)(taskFile, bundleFile);
-    }
-    else {
-        return loadInputSourceMapsStandard(taskFile, bundleFile, externalSourceMapFile);
-    }
-}
-function loadInputSourceMapsStandard(taskFile, bundleFile, externalSourceMapFile) {
-    return bundleFile.codeArguments.map(code => loadInputSourceMap(code, taskFile, externalSourceMapFile));
-}
-/**
- * Given a source code file, load the corresponding sourcemap.
- *
- * @param inputSource - The source code that might contain sourcemap comments.
- * @param taskFile - The name of the file the `inputSource` is from.
- * @param externalSourceMapFile - An external source map file to consider.
- */
-function loadInputSourceMap(inputSource, taskFile, externalSourceMapFile) {
-    if (externalSourceMapFile) {
-        const sourceMapOrigin = externalSourceMapFile;
-        if (!(sourceMapOrigin instanceof Task_1.SourceMapFileReference)) {
-            throw new commons_1.IllegalArgumentException('Type of source map not yet supported!');
-        }
-        return (0, FileSystem_1.sourceMapFromMapFile)(sourceMapOrigin.sourceMapFilePath);
-    }
-    else {
-        return sourceMapFromCodeComment(inputSource, taskFile);
-    }
-}
-/**
- * Extract a sourcemap for a given code comment.
- *
- * @param sourcecode - The source code that is scanned for source map comments.
- * @param sourceFilePath - The file name the code was loaded from.
- */
-function sourceMapFromCodeComment(sourcecode, sourceFilePath) {
-    // Either `//# sourceMappingURL=vendor.5d7ba975.js.map`
-    // or `//# sourceMappingURL=data:application/json;base64,eyJ2ZXJ ...`
-    //
-    // "It is reasonable for tools to also accept “//@” but “//#” is preferred."
-    const re = /\/\/[#@]\s(source(?:Mapping)?URL)=\s*(\S+)/g;
-    let failedLoading = 0;
-    let result;
-    let matched;
-    do {
-        matched = re.exec(sourcecode);
-        if (matched) {
-            const sourceMapComment = matched[0];
-            try {
-                if (sourceMapComment.slice(0, 50).indexOf('data:application/json') > 0) {
-                    result = convertSourceMap.fromComment(sourceMapComment).toObject();
-                }
-                else {
-                    result = convertSourceMap
-                        .fromMapFileComment(sourceMapComment, function (filename) {
-                        return fs.readFileSync(path.resolve(path.dirname(sourceFilePath), filename), 'utf-8');
-                    })
-                        .toObject();
-                }
-            }
-            catch (e) {
-                // One JS file can refer to several source map files in its comments.
-                failedLoading++;
-            }
-        }
-    } while (matched);
-    if (result) {
-        return result;
-    }
-    if (failedLoading > 0) {
-        throw new commons_1.IllegalArgumentException('None of the referenced source map files loaded!');
-    }
-    else {
-        return undefined;
-    }
-}
-function writeToFile(filePath, fileContent) {
-    mkdirp.sync(path.dirname(filePath));
-    fs.writeFileSync(filePath, fileContent);
-}
-function copyToFile(targetFilePath, sourceFilePath) {
-    mkdirp.sync(path.dirname(targetFilePath));
-    fs.copyFileSync(sourceFilePath, targetFilePath);
-}

package/dist/src/instrumenter/InstrumenterConfig.d.ts

@@ -1,37 +0,0 @@
-import { ConfigurationParameters } from '@cqse/commons';
-import { LogLevelString } from 'bunyan';
-/**
- * The options the Instrumenter is configured with.
- * For more details on these options:
- * @see #buildInstrumenterConfigurationParameters
- */
-export type InstrumenterOptions = {
-    version?: boolean;
-    help?: boolean;
-    input?: string[];
-    inPlace?: boolean;
-    to?: string;
-    logLevel?: LogLevelString;
-    configId?: string;
-    appName?: string;
-    commit?: string;
-    sourceMap?: string;
-    collector: string;
-    relativeCollector?: string;
-    includeOrigin?: string[];
-    excludeOrigin?: string[];
-    excludeBundle?: string[];
-    dumpOriginsTo?: string;
-    dumpOriginMatchesTo?: string;
-    collectorConfigFile?: string;
-    collectorConfigFileContent?: string;
-    collectorOption?: string[];
-    collectorOptionsList?: boolean;
-    coverageTargetFromCollector?: boolean;
-};
-/**
- * Builds and returns a configuration parameters object for the JavaScript instrumenter.
- * This function defines all supported command-line arguments and their descriptions.
- */
-export declare function buildInstrumenterConfigurationParameters(): ConfigurationParameters;
-//# sourceMappingURL=InstrumenterConfig.d.ts.map

package/dist/src/instrumenter/InstrumenterConfig.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"InstrumenterConfig.d.ts","sourceRoot":"","sources":["../../../src/instrumenter/InstrumenterConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,uBAAuB,EAGvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAGxC;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACtC,CAAC;AAsBF;;;GAGG;AACH,wBAAgB,wCAAwC,IAAI,uBAAuB,CA+IlF"}