@teamscale/javascript-instrumenter 0.1.0-beta.8 → 1.0.0-beta.4

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

@@ -0,0 +1,36 @@
+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;
+};
+/**
+ * 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

@@ -0,0 +1 @@
+{"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;CAC/B,CAAC;AAsBF;;;GAGG;AACH,wBAAgB,wCAAwC,IAAI,uBAAuB,CA0HlF"}

package/dist/src/instrumenter/InstrumenterConfig.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildInstrumenterConfigurationParameters = buildInstrumenterConfigurationParameters;
+const commons_1 = require("@cqse/commons");
+const commons_2 = require("@cqse/commons");
+const CONFIG_GROUP_INPUT = {
+    order: 1,
+    title: 'Instrumenter Input and Output'
+};
+const CONFIG_GROUP_TARGET_PARAMS = {
+    order: 2,
+    title: 'Coverage Target Parameters'
+};
+const CONFIG_GROUP_COVERAGE_SUBJECT = {
+    order: 3,
+    title: 'Coverage Subject'
+};
+const CONFIG_GROUP_DEBUGGING = {
+    order: 4,
+    title: 'Troubleshooting'
+};
+/**
+ * Builds and returns a configuration parameters object for the JavaScript instrumenter.
+ * This function defines all supported command-line arguments and their descriptions.
+ */
+function buildInstrumenterConfigurationParameters() {
+    const parameters = new commons_1.ConfigurationParameters();
+    function addParameter(shortParameter, longParameter, type, options) {
+        parameters.addParameter(shortParameter, longParameter, type, options);
+    }
+    addParameter('-i', '--input', 'string[]', {
+        help: 'The input file(s) or folder(s) to instrument.',
+        group: CONFIG_GROUP_INPUT
+    });
+    addParameter('-l', '--in-place', 'bool', {
+        help: 'If set, the original files to instrument are replaced by their instrumented counterparts.',
+        group: CONFIG_GROUP_INPUT
+    });
+    addParameter('-o', '--to', 'string', {
+        help: 'Path (directory or file name) to write the instrumented version to.',
+        group: CONFIG_GROUP_INPUT
+    });
+    addParameter('-r', '--commit', 'string', {
+        help: 'The commit (<branch name>:<UNIX timestamp in milliseconds>) or revision (Git hash) of the code to report coverage for.',
+        group: CONFIG_GROUP_TARGET_PARAMS
+    });
+    addParameter('-c', '--collector', 'string', {
+        help: 'The collector (`host:port` or `wss://host:port/` or `ws://host:port/`) to send coverage information to.',
+        default: 'ws://localhost:54678',
+        group: CONFIG_GROUP_TARGET_PARAMS
+    });
+    addParameter('-a', '--app-name', 'string', {
+        help: 'The name of the application to report coverage for. Will be used to make the automatically generated application ID more readable.',
+        group: CONFIG_GROUP_TARGET_PARAMS
+    });
+    addParameter('-f', '--config-id', 'string', {
+        help: 'The ID of the profiler configuration to use; this configuration is refetched from Teamscale once a minute.',
+        group: CONFIG_GROUP_TARGET_PARAMS
+    });
+    addParameter('-t', '--collector-config-file', 'string', {
+        help: 'Provide a configuration file that specifies or overwrites the configuration of the Coverage Collector.',
+        group: CONFIG_GROUP_TARGET_PARAMS
+    });
+    addParameter(undefined, '--collector-option', 'string[]', {
+        help: 'Sets a given collector configuration option. Provided as key=value pairs.',
+        group: CONFIG_GROUP_TARGET_PARAMS
+    });
+    addParameter(undefined, '--collector-options-list', 'bool', {
+        help: 'Lists the options that can be set for the collector, via a --collector-config-file or via --collector-option.',
+        group: CONFIG_GROUP_TARGET_PARAMS
+    });
+    addParameter(undefined, '--source-map', 'string', {
+        help: 'External location of source-map files to consider.',
+        group: CONFIG_GROUP_COVERAGE_SUBJECT
+    });
+    addParameter(undefined, '--relative-collector', 'string', {
+        help: 'Pattern used to determine the collector URL from the application hostname.'
+            + ' Useful for Kubernetes deployments where the collector URL is not known at instrumentation time.'
+            + ' Example: `replace-in-host:app collector,scheme:wss`.'
+            + ' This causes the first occurrence of `app` in the application hostname to be replaced with `collector`'
+            + ' and the URL scheme changed to wss.'
+            + ' Available operations:'
+            + ' `replace-in-host:SEARCH REPLACE` replaces the literal term SEARCH once in the hostname with REPLACE.'
+            + ' `port:NUMBER` changes the port to NUMBER.'
+            + ' `port:keep` keeps the port of the application (instead of using the chosen scheme\'s default port).'
+            + ' `scheme:SCHEME` changes the URL scheme to one of ws, wss, http or https.'
+            + ' `path:PATH` uses the URL path PATH (instead of no path).',
+        group: CONFIG_GROUP_TARGET_PARAMS
+    });
+    addParameter('-x', '--exclude-origin', 'string[]', {
+        help: 'Glob pattern(s) of files in the source origin to not produce coverage for. Multiple patterns can be separated by comma.',
+        group: CONFIG_GROUP_INPUT
+    });
+    addParameter('-k', '--include-origin', 'string[]', {
+        help: 'Glob pattern(s) of files in the source origin to produce coverage for. Multiple patterns can be separated by comma.',
+        group: CONFIG_GROUP_INPUT
+    });
+    addParameter('-e', '--exclude-bundle', 'string[]', {
+        help: 'Glob pattern(s) of input (bundle) files to keep unchanged (to not instrument).',
+        group: CONFIG_GROUP_INPUT
+    });
+    addParameter('-p', '--dump-origins-to', 'string', {
+        help: 'Path specifying where to dump source origins file names, based on the source maps, as a JSON file.',
+        group: CONFIG_GROUP_DEBUGGING
+    });
+    addParameter('-m', '--dump-origin-matches-to', 'string', {
+        help: 'Path specifying where to dump a JSON with the names of the files that have matched the origin include/exclude patterns.',
+        group: CONFIG_GROUP_DEBUGGING
+    });
+    addParameter(undefined, '--log-level', 'string', {
+        help: 'Log level', default: 'info', group: CONFIG_GROUP_DEBUGGING
+    });
+    parameters.addArgumentCheck(options => {
+        if (!Array.isArray(options.input) || options.input.length === 0) {
+            return 'The --input parameter must be provided with the list of files or folders to instrument.';
+        }
+    });
+    parameters.addRequiredArgumentFor('commit');
+    parameters.addArgumentCheck(options => {
+        if (!(0, commons_2.isValidCommitInfo)(options.commit)) {
+            return 'The given commit must be of the form <branch>:<UNIX timestamp in milliseconds> or a Git hash.';
+        }
+    });
+    parameters.addArgumentCheck(options => {
+        if (!options.collector && !options.relativeCollector) {
+            return 'Either a collector URL or a relative collector URL must be specified.';
+        }
+    });
+    parameters.addArgumentCheck(options => {
+        if (!options.configId && !options.collectorConfigFile && !(Array.isArray(options.collectorOption) && options.collectorOption.length > 0)) {
+            return 'Either a configuration ID (--config-id), a collector configuration file (--collector-config-file) or explicit collector options (--collector-option) must be specified.';
+        }
+    });
+    parameters.addArgumentCheck(options => {
+        if (options.logLevel !== undefined) {
+            const validLevels = ["trace", "debug", "info", "warn", "error", "fatal"];
+            if (!validLevels.includes(options.logLevel)) {
+                return "Please provide a valid value for --log-level. One of: " + validLevels.join(", ");
+            }
+        }
+    });
+    return parameters;
+}

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

@@ -1,5 +1,5 @@
 import { Optional } from 'typescript-optional';
-import { CollectorSpecifier } from '../vaccine/types';
+import { CollectorSpecifier, CoverageBucketSpecifier } from '../vaccine/types';
 /**
  * An abstract source map type.
  */
@@ -137,6 +137,10 @@ export declare class InstrumentationTask {
      * The collector to send coverage information to.
      */
     readonly collector: CollectorSpecifier;
+    /**
+     * The target bucket within the collector the coverage is supposed to be sent to.
+     */
+    readonly targetBucket: CoverageBucketSpecifier;
     /**
      * The files to instrument along with a specification of the target.
      */
@@ -159,7 +163,7 @@ export declare class InstrumentationTask {
      * File to write the matched files to.
      */
     readonly dumpMatchedOriginsFile: string | undefined;
-    constructor(collector: CollectorSpecifier, elements: TaskElement[], excludeFilesPattern: FileExcludePattern, originSourcePattern: OriginSourcePattern, dumpOriginsFile: string | undefined, dumpMatchedOriginsFile: string | undefined);
+    constructor(collector: CollectorSpecifier, targetBucket: CoverageBucketSpecifier, elements: TaskElement[], excludeFilesPattern: FileExcludePattern, originSourcePattern: OriginSourcePattern, dumpOriginsFile: string | undefined, dumpMatchedOriginsFile: string | undefined);
     /**
      * @returns the elements of the task.
      */

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

@@ -1 +1 @@
-{"version":3,"file":"Task.d.ts","sourceRoot":"","sources":["../../../src/instrumenter/Task.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Task.d.ts","sourceRoot":"","sources":["../../../src/instrumenter/Task.ts"],"names":[],"mappings":"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"}

package/dist/src/instrumenter/Task.js

@@ -3,7 +3,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SourceMapFileReference = exports.TaskResult = exports.InstrumentationTask = exports.FileExcludePattern = exports.OriginSourcePattern = exports.createCollectorSpecifier = exports.TaskElement = exports.SourceMapReference = void 0;
+exports.SourceMapFileReference = exports.TaskResult = exports.InstrumentationTask = exports.FileExcludePattern = exports.OriginSourcePattern = exports.TaskElement = exports.SourceMapReference = void 0;
+exports.createCollectorSpecifier = createCollectorSpecifier;
 const typescript_optional_1 = require("typescript-optional");
 const commons_1 = require("@cqse/commons");
 const micromatch_1 = __importDefault(require("micromatch"));
@@ -47,7 +48,6 @@ function createCollectorSpecifier(commandLineUrl, relativePattern) {
     }
     return parseCommandLineUrl(commandLineUrl);
 }
-exports.createCollectorSpecifier = createCollectorSpecifier;
 /**
  * Parses, validates and normalizes the given URL that the user provided on the command-line.
  */
@@ -223,8 +223,9 @@ function removePrefix(prefix, removeFrom) {
  * The actual instrumentation task.
  */
 class InstrumentationTask {
-    constructor(collector, elements, excludeFilesPattern, originSourcePattern, dumpOriginsFile, dumpMatchedOriginsFile) {
+    constructor(collector, targetBucket, elements, excludeFilesPattern, originSourcePattern, dumpOriginsFile, dumpMatchedOriginsFile) {
         this.collector = commons_1.Contract.requireDefined(collector);
+        this.targetBucket = commons_1.Contract.requireDefined(targetBucket);
         this.excludeFilesPattern = commons_1.Contract.requireDefined(excludeFilesPattern);
         this.originSourcePattern = commons_1.Contract.requireDefined(originSourcePattern);
         this._elements = commons_1.Contract.requireDefined(elements).slice();

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

@@ -1,19 +1,5 @@
 import { InstrumentationTask, SourceMapReference } from './Task';
-/** The parameters the instrumenter can be configured by */
-export type ConfigurationParameters = {
-    inputs?: string[];
-    in_place?: boolean;
-    debug?: boolean;
-    to?: string;
-    source_map?: string;
-    collector: string;
-    relative_collector?: string;
-    include_origin?: string[];
-    exclude_origin?: string[];
-    exclude_bundle?: string[];
-    dump_origins_to?: string;
-    dump_origin_matches_to?: string;
-};
+import { InstrumenterOptions } from './InstrumenterConfig';
 /**
  * A builder for an instrumentation task.
  */
@@ -37,9 +23,19 @@ export declare class TaskBuilder {
      * `undefined` if this information should not be dumped.
      */
     private dumpMatchedOriginsFile;
+    /**
+     * The bucket within the collector the coverage is supposed to be sent to.
+     */
+    private targetBucket;
+    /**
+     * The automatically generated unique app id to use.
+     */
+    private appId;
     constructor();
     /** Set the collector specification based on the command-line arguments. */
     setCollectorFromCommandLine(commandLineUrl: string, relativePattern?: string): this;
+    /** Set the coverage bucket to be used within the collector. */
+    setCollectorTargetBucket(configId: string | undefined, commit: string, configOptions?: string, appName?: string): this;
     /** Set the origin include pattern. If multiple patterns are present, concatenates them via the OR operator.  */
     setOriginSourceIncludePatterns(patterns: string[] | undefined): this;
     /** Set the origin exclude pattern(s). If multiple patterns are present, concatenates them via the OR operator. */
@@ -53,7 +49,7 @@ export declare class TaskBuilder {
      *
      * @param config - The configuration based on that the task is built.
      */
-    addFromConfig(config: ConfigurationParameters): this;
+    addFromConfig(config: InstrumenterOptions): this;
     /**
      * Adds instrumentation tasks based on a given pattern `inputs` describing the set of
      * input files and produces the output files in the specified output folder `target.

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

@@ -1 +1 @@
-{"version":3,"file":"TaskBuilder.d.ts","sourceRoot":"","sources":["../../../src/instrumenter/TaskBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,mBAAmB,EAGnB,kBAAkB,EAGlB,MAAM,QAAQ,CAAC;AAOhB,2DAA2D;AAC3D,MAAM,MAAM,uBAAuB,GAAG;IACrC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAElB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAkBF;;GAEG;AACH,qBAAa,WAAW;IACvB,gDAAgD;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IAEzC,6CAA6C;IAC7C,OAAO,CAAC,SAAS,CAA4B;IAE7C,+BAA+B;IAC/B,OAAO,CAAC,2BAA2B,CAAuB;IAE1D,8BAA8B;IAC9B,OAAO,CAAC,2BAA2B,CAAuB;IAE1D,8BAA8B;IAC9B,OAAO,CAAC,yBAAyB,CAAuB;IAExD;;qDAEiD;IACjD,OAAO,CAAC,eAAe,CAAqB;IAE5C;;;OAGG;IACH,OAAO,CAAC,sBAAsB,CAAqB;;IAOnD,2EAA2E;IAC3E,2BAA2B,CAAC,cAAc,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI;IAMnF,gHAAgH;IAChH,8BAA8B,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI;IAKpE,kHAAkH;IAClH,8BAA8B,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI;IAKpE,qHAAqH;IACrH,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI;IAK9D,yBAAyB;IACzB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAKlG;;;;OAIG;IACH,aAAa,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI;IAqCpD;;;;;;;OAOG;IACH,OAAO,CAAC,4CAA4C;IAgCpD;;;;;;OAMG;IACH,OAAO,CAAC,0BAA0B;IASlC;;OAEG;IACI,KAAK,IAAI,mBAAmB;CAUnC"}
+{"version":3,"file":"TaskBuilder.d.ts","sourceRoot":"","sources":["../../../src/instrumenter/TaskBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,mBAAmB,EAGnB,kBAAkB,EAGlB,MAAM,QAAQ,CAAC;AAYhB,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAoB3D;;GAEG;AACH,qBAAa,WAAW;IACvB,gDAAgD;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IAEzC,6CAA6C;IAC7C,OAAO,CAAC,SAAS,CAA4B;IAE7C,+BAA+B;IAC/B,OAAO,CAAC,2BAA2B,CAAuB;IAE1D,8BAA8B;IAC9B,OAAO,CAAC,2BAA2B,CAAuB;IAE1D,8BAA8B;IAC9B,OAAO,CAAC,yBAAyB,CAAuB;IAExD;;qDAEiD;IACjD,OAAO,CAAC,eAAe,CAAqB;IAE5C;;;OAGG;IACH,OAAO,CAAC,sBAAsB,CAAqB;IAEnD;;OAEG;IACH,OAAO,CAAC,YAAY,CAAiC;IAErD;;OAEG;IACH,OAAO,CAAC,KAAK,CAAS;;IAStB,2EAA2E;IAC3E,2BAA2B,CAAC,cAAc,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI;IAMnF,+DAA+D;IAC/D,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EACtF,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAO9B,gHAAgH;IAChH,8BAA8B,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI;IAKpE,kHAAkH;IAClH,8BAA8B,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI;IAKpE,qHAAqH;IACrH,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI;IAK9D,yBAAyB;IACzB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAKlG;;;;OAIG;IACH,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAuChD;;;;;;;OAOG;IACH,OAAO,CAAC,4CAA4C;IAgCpD;;;;;;OAMG;IACH,OAAO,CAAC,0BAA0B;IASlC;;OAEG;IACI,KAAK,IAAI,mBAAmB;CAWnC"}

package/dist/src/instrumenter/TaskBuilder.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+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;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TaskBuilder = void 0;
 const Task_1 = require("./Task");
@@ -29,6 +39,7 @@ const commons_1 = require("@cqse/commons");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const FileSystem_1 = require("./FileSystem");
+const uuid_1 = require("uuid");
 /**
  * Load a source map object from the given file (path).
  * Exception if the specified file does not exist.
@@ -49,8 +60,10 @@ function loadSourceMap(sourceMapPath) {
  */
 class TaskBuilder {
     constructor() {
+        this.appId = (0, uuid_1.v4)();
         this.elements = [];
         this.collector = null;
+        this.targetBucket = null;
     }
     /** Set the collector specification based on the command-line arguments. */
     setCollectorFromCommandLine(commandLineUrl, relativePattern) {
@@ -58,6 +71,13 @@ class TaskBuilder {
         this.collector = (0, Task_1.createCollectorSpecifier)(commandLineUrl, relativePattern);
         return this;
     }
+    /** Set the coverage bucket to be used within the collector. */
+    setCollectorTargetBucket(configId, commit, configOptions, appName) {
+        commons_1.Contract.requireNonEmpty(commit, "The commit must not be empty");
+        this.appId = generateAppId(appName);
+        this.targetBucket = { appId: this.appId, configId, commit, configOptions };
+        return this;
+    }
     /** Set the origin include pattern. If multiple patterns are present, concatenates them via the OR operator.  */
     setOriginSourceIncludePatterns(patterns) {
         this.originSourceIncludePatterns = patterns;
@@ -84,20 +104,21 @@ class TaskBuilder {
      * @param config - The configuration based on that the task is built.
      */
     addFromConfig(config) {
-        var _a, _b;
-        const inputs = ((_a = config.inputs) !== null && _a !== void 0 ? _a : []);
-        const inPlace = (_b = config.in_place) !== null && _b !== void 0 ? _b : true;
+        var _a, _b, _c;
+        const inputs = ((_a = config.input) !== null && _a !== void 0 ? _a : []);
+        const inPlace = (_b = config.inPlace) !== null && _b !== void 0 ? _b : false;
         const target = config.to;
-        const sourceMap = config.source_map;
-        this.dumpOriginsFile = config.dump_origins_to;
-        this.dumpMatchedOriginsFile = config.dump_origin_matches_to;
-        this.setCollectorFromCommandLine(config.collector, config.relative_collector);
-        this.setOriginSourceIncludePatterns(config.include_origin);
-        this.setOriginSourceExcludePatterns(config.exclude_origin);
-        this.setBundleExcludePatterns(config.exclude_bundle);
+        const sourceMap = config.sourceMap;
+        this.dumpOriginsFile = config.dumpOriginsTo;
+        this.dumpMatchedOriginsFile = config.dumpOriginMatchesTo;
+        this.setCollectorFromCommandLine(config.collector, config.relativeCollector);
+        this.setOriginSourceIncludePatterns(config.includeOrigin);
+        this.setOriginSourceExcludePatterns(config.excludeOrigin);
+        this.setBundleExcludePatterns(config.excludeBundle);
+        this.setCollectorTargetBucket(config.configId, (_c = config.commit) !== null && _c !== void 0 ? _c : 'HEAD', config.collectorConfigFileContent, config.appName);
         // Handle an explicitly specified source map
         const sourceMapInfo = loadSourceMap(sourceMap);
-        // If an in place instrumentation is needed
+        // If an in-place instrumentation is needed,
         // the task has to be built differently and different invariants
         // have to be satisfied by the passed configuration.
         if (inPlace) {
@@ -171,10 +192,21 @@ class TaskBuilder {
      * Build the instrumentation task.
      */
     build() {
-        return new Task_1.InstrumentationTask(commons_1.Contract.requireDefined(this.collector), this.elements, new Task_1.FileExcludePattern(this.bundleFileExcludePatterns), new Task_1.OriginSourcePattern(this.originSourceIncludePatterns, this.originSourceExcludePatterns), this.dumpOriginsFile, this.dumpMatchedOriginsFile);
+        return new Task_1.InstrumentationTask(commons_1.Contract.requireDefined(this.collector), commons_1.Contract.requireDefined(this.targetBucket), this.elements, new Task_1.FileExcludePattern(this.bundleFileExcludePatterns), new Task_1.OriginSourcePattern(this.originSourceIncludePatterns, this.originSourceExcludePatterns), this.dumpOriginsFile, this.dumpMatchedOriginsFile);
     }
 }
 exports.TaskBuilder = TaskBuilder;
+/**
+ * Generates an application ID, if an `appName` is given, with a user-friendly prefix.
+ */
+function generateAppId(appName) {
+    const result = (0, uuid_1.v4)();
+    if (appName) {
+        const appPrefix = (0, FileSystem_1.replaceNonFilesystemCharacters)(appName).toLowerCase();
+        return `${appPrefix}-${result.substring(0, 10)}`;
+    }
+    return result;
+}
 /**
  * Does the given string look like a RegExp or Glob pattern?
  */

package/dist/src/instrumenter/WebToolkit.js

@@ -3,7 +3,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isGwtBundle = exports.determineGwtFileUid = exports.loadInputSourceMapsGwt = exports.extractGwtCallInfos = exports.determineSymbolMapsDir = void 0;
+exports.determineSymbolMapsDir = determineSymbolMapsDir;
+exports.extractGwtCallInfos = extractGwtCallInfos;
+exports.loadInputSourceMapsGwt = loadInputSourceMapsGwt;
+exports.determineGwtFileUid = determineGwtFileUid;
+exports.isGwtBundle = isGwtBundle;
 const path_1 = __importDefault(require("path"));
 const FileSystem_1 = require("./FileSystem");
 const types_1 = require("@babel/types");
@@ -36,7 +40,6 @@ function determineSymbolMapsDir(taskFile) {
     }
     return symbolMapDirs;
 }
-exports.determineSymbolMapsDir = determineSymbolMapsDir;
 function expressionToString(expression) {
     if ((0, types_1.isMemberExpression)(expression) && (0, types_1.isExpression)(expression.property)) {
         return `${expressionToString(expression.object)}.${expressionToString(expression.property)}`;
@@ -92,7 +95,6 @@ function extractGwtCallInfos(bundleContent) {
     }
     return null;
 }
-exports.extractGwtCallInfos = extractGwtCallInfos;
 /**
  * Load the source map for the given GWT bundle.
  */
@@ -125,7 +127,6 @@ function loadInputSourceMapsGwt(taskFile, bundleFile) {
         return undefined;
     });
 }
-exports.loadInputSourceMapsGwt = loadInputSourceMapsGwt;
 /**
  * Determine the ID of the given GWT bundle file.
  */
@@ -137,11 +138,9 @@ function determineGwtFileUid(filename) {
     }
     return uidMatches[1];
 }
-exports.determineGwtFileUid = determineGwtFileUid;
 /**
  * Is the given bundle a GWT bundle?
  */
 function isGwtBundle(bundle) {
     return bundle.type === 'gwt';
 }
-exports.isGwtBundle = isGwtBundle;

package/dist/src/main.js

@@ -1,7 +1,42 @@
 #!/usr/bin/env node
 "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;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 const App_1 = require("./App");
+const commons_1 = require("@cqse/commons");
+const process = __importStar(require("node:process"));
 // Run the instrumenter and print the results to the console.
 App_1.App.run()
     .then(result => {
@@ -25,7 +60,14 @@ App_1.App.run()
     }
 })
     .catch(reason => {
-    console.log('Failed: ', reason);
+    if (reason instanceof commons_1.InvalidConfigurationException) {
+        // Do not print the stack trace for invalid configuration parameters from the user.
+        console.error(`Failed: ${reason.message}`);
+    }
+    else {
+        console.error('Failed: ', reason);
+    }
+    process.exit(1);
 })
     .finally(() => {
     console.log('Bye bye.');

package/dist/src/vaccine/types.d.ts

@@ -3,7 +3,7 @@
  */
 export interface CollectorSpecifierUrl {
     /** Type of collector specifier. */
-    type: "url";
+    type: 'url';
     /** The URL under which the collector can be reached at runtime. */
     url: string;
 }
@@ -19,11 +19,11 @@ export interface SearchReplace {
  */
 export interface CollectorSpecifierRelative {
     /** Type of collector specifier. */
-    type: "relative";
+    type: 'relative';
     /** Literal replacement string. */
     hostReplace?: SearchReplace;
     /** Optional port. If no port is given, uses the protocol's default port. */
-    port?: number | "keep";
+    port?: number | 'keep';
     /** Optional URL scheme to use. If no scheme is given, uses ws. */
     scheme?: string;
     /** Optional path. If no path is given, uses only the hostname. */
@@ -44,6 +44,22 @@ export interface LocationMessage {
     /** Port of the profiled document, e.g. "1234" */
     port: string;
 }
-/** Enumerates all types of messages to the worker. */
-export type WorkerMessage = LocationMessage;
+/** Details about the bucket the coverage is added to. */
+export type CoverageBucketSpecifier = {
+    /** A unique identifier of the instrumented application. */
+    appId: string;
+    /**
+     * The ID of the profiler configuration to use. No config ID might be given
+     * if the coverage shall be collected while Teamscale is not available.
+     */
+    configId?: string;
+    /**
+     * Concrete collector configuration options to pass. ATTENTION: These are generally
+     * unencrypted and shall not contain sensitive information or the execution
+     * environment must ensure that they cannot be leaked.
+     */
+    configOptions?: string;
+    /** The project commit or revision to contribute coverage for. */
+    commit: string;
+};
 //# sourceMappingURL=types.d.ts.map

package/dist/src/vaccine/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/vaccine/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,mCAAmC;IACnC,IAAI,EAAE,KAAK,CAAC;IACZ,mEAAmE;IACnE,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC7B,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAC1C,mCAAmC;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,kCAAkC;IAClC,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,qBAAqB,GAAG,0BAA0B,CAAA;AAEnF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,oBAAoB;IACpB,IAAI,EAAE,UAAU,CAAC;IACjB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;CACb;AAED,sDAAsD;AACtD,MAAM,MAAM,aAAa,GAAG,eAAe,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/vaccine/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,mCAAmC;IACnC,IAAI,EAAE,KAAK,CAAC;IACZ,mEAAmE;IACnE,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC7B,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAC1C,mCAAmC;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,kCAAkC;IAClC,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,qBAAqB,GAAG,0BAA0B,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,oBAAoB;IACpB,IAAI,EAAE,UAAU,CAAC;IACjB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;CACb;AAED,yDAAyD;AACzD,MAAM,MAAM,uBAAuB,GAAG;IACrC,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;CAEf,CAAA"}

package/dist/vaccine.js

@@ -1 +1 @@
-"use strict";(()=>{function u(e){let n=new Blob([e],{type:"text/javascript"}),t=URL.createObjectURL(n),a=new Worker(t);return URL.revokeObjectURL(t),a}function d(){return u('var i=class{constructor(){this.cachedMessages=[]}connect(e){this.url=e,this.socket=this.createSocket()}createSocket(){let e=new WebSocket(this.url);return e.onopen=()=>this.onopen(),e.onclose=()=>this.onclose(),e}onclose(){this.socket=this.createSocket()}onopen(){console.log("Connection to Coverage Collector established."),this.cachedMessages.forEach(e=>this.socket.send(e)),this.cachedMessages=[]}send(e){this.socket!==null&&this.socket.readyState===WebSocket.OPEN?this.socket.send(e):(this.cachedMessages.push(e),this.cachedMessages.length%500===0&&console.log(`More than ${this.cachedMessages.length} messages are queued to be sent.`))}};var a=class{constructor(e,o){this.milliseconds=e;this.onCountedToZero=o;this.timerHandle=null}restartCountdown(){this.stopCountdown(),this.timerHandle=self.setTimeout(()=>{this.stopCountdown(),this.onCountedToZero()},this.milliseconds)}stopCountdown(){this.timerHandle!==null&&(self.clearTimeout(this.timerHandle),this.timerHandle=null)}};var C=20,f=1e3,v="c",c=class{constructor(e){this.socket=e,this.cachedCoveredRanges=new Map,this.numberOfCachedPositions=0,this.flushCountdown=new a(f,()=>this.flush())}addLines(e,o){let t=this.cachedCoveredRanges.get(e);t||(t=new Set,this.cachedCoveredRanges.set(e,t)),o.forEach(n=>t.add(n)),this.numberOfCachedPositions+=1,this.flushCountdown.restartCountdown(),this.numberOfCachedPositions>=C&&this.flush()}arrayToLineCov(e){let o=[];for(let t of e)o.push(`${t}`);return o.join(";")}flush(){if(this.numberOfCachedPositions===0)return;this.flushCountdown.stopCountdown();let e=[];this.cachedCoveredRanges.forEach((o,t)=>{e.push(`@${t}`),e.push(this.arrayToLineCov(o))}),this.socket.send(`${v} ${e.join(";")}`),this.cachedCoveredRanges.clear(),this.numberOfCachedPositions=0}};var l=class s{static resolve(e,o,t){switch(e.type){case"url":return e.url;case"relative":return s.resolveRelative(o,t,e)}}static resolveRelative(e,o,t){var u;let n=e;t.hostReplace&&(n=e.replace(t.hostReplace.search,t.hostReplace.replace));let m=(u=t.scheme)!=null?u:"ws",r;t.port===void 0?r="":t.port==="keep"?r=`:${o}`:r=`:${t.port}`;let h="";t.path&&(h=`/${t.path}`);let d=`${m}://${n}${r}${h}`;return console.debug(`Resolved collector URL ${d} from ${e}:${o}`),d}};console.log("Starting coverage forwarding worker.");var g=new i,p=new c(g);onmessage=s=>{if(Array.isArray(s.data)){let[e,o]=s.data;p.addLines(e,o)}else if(s.data==="unload")p.flush();else if(s.data.type==="location"){let e=s.data,o=l.resolve($COLLECTOR_SPECIFIER,e.hostname,e.port);g.connect(`${o}/socket`)}else console.error(`No handler for message: ${s.data}`)};\n')}function c(){return f()}function f(){return window}function g(e,n){let t=c()[e];return t||(t=n,c()[e]=t),t}function p(e,n){let t=new Map;function a(i){let o=t.get(i);return o||(o={lines:new Set},t.set(i,o),o)}function s(i,o,w=o){let h=a(i).lines;for(let l=o;l<=w;l++)h.add(l);h.size>255&&r()}function r(){n(t),t.clear()}return setInterval(()=>r(),e),{putLineCoverage:s,flush:r}}var v=g("__TS_AGENT",{});function m(){return v._$BcWorker}function b(e){return v._$BcWorker=e,e}var C=p(250,e=>{for(let n of e.entries())m().postMessage([n[0],Array.from(n[1].lines)])});c()._$l=C.putLineCoverage;if(!m()){let e=b(new d),n={type:"location",hostname:document.location.hostname,port:document.location.port};e.postMessage(n),function(){let a=()=>{C.flush(),e.postMessage("unload")},s=function(i,o){o&&o.addEventListener(i,a,{capture:!0})},r=f();s("blur",r),s("unload",r),s("visibilitychange",r),s("beforeunload",r)}()}})();
+"use strict";(()=>{function u(e){let n=new Blob([e],{type:"text/javascript"}),t=URL.createObjectURL(n),a=new Worker(t);return URL.revokeObjectURL(t),a}function h(){return u('var r=class{constructor(){this.socket=null,this.url="",this.messageOnConnect="",this.cachedMessages=[],this.reconnectTimer=null}connect(e,s){this.url=e,this.messageOnConnect=s,this.socket=this.createSocket(),this.startReconnectTimer()}createSocket(){let e=new WebSocket(this.url);return e.onopen=()=>this.onopen(),e.onclose=()=>this.onclose(),e}startReconnectTimer(){this.reconnectTimer!==null&&clearInterval(this.reconnectTimer),this.reconnectTimer=setInterval(()=>{this.checkConnectionAndReconnect()},1e4)}checkConnectionAndReconnect(){var e;(this.socket===null||this.socket.readyState!==WebSocket.OPEN)&&((e=this.socket)==null||e.close(),console.log("Connection lost, attempting to reconnect..."),this.socket=this.createSocket())}onclose(){this.socket=this.createSocket()}onopen(){console.log("Connection to Coverage Collector established."),this.socket.send(this.messageOnConnect),this.cachedMessages.forEach(e=>this.socket.send(e)),this.cachedMessages=[]}send(e){if(this.socket!==null&&this.socket.readyState===WebSocket.OPEN)try{this.socket.send(e)}catch(s){console.error("Sending failed. Message will be re-sent when connection is available again.",s),this.addMessageToCache(e)}else this.addMessageToCache(e)}addMessageToCache(e){this.cachedMessages.push(e),this.cachedMessages.length%500===0&&console.log(`More than ${this.cachedMessages.length} messages are queued to be sent.`)}disconnect(){this.reconnectTimer!==null&&(clearInterval(this.reconnectTimer),this.reconnectTimer=null),this.socket!==null&&(this.socket.close(),this.socket=null)}};var c=class{constructor(e,s){this.milliseconds=e;this.onCountedToZero=s;this.timerHandle=null}restartCountdown(){this.stopCountdown(),this.timerHandle=self.setTimeout(()=>{this.stopCountdown(),this.onCountedToZero()},this.milliseconds)}stopCountdown(){this.timerHandle!==null&&(self.clearTimeout(this.timerHandle),this.timerHandle=null)}};var v=20,f=1e3,S="c",g="b",a=class{constructor(e){this.socket=e,this.cachedCoveredRanges=new Map,this.numberOfCachedPositions=0,this.flushCountdown=new c(f,()=>this.flush())}addLines(e,s){let t=this.cachedCoveredRanges.get(e);t||(t=new Set,this.cachedCoveredRanges.set(e,t)),s.forEach(n=>t.add(n)),this.numberOfCachedPositions+=1,this.flushCountdown.restartCountdown(),this.numberOfCachedPositions>=v&&this.flush()}arrayToLineCov(e){let s=[];for(let t of e)s.push(`${t}`);return s.join(";")}flush(){if(this.numberOfCachedPositions===0)return;this.flushCountdown.stopCountdown();let e=[];this.cachedCoveredRanges.forEach((s,t)=>{e.push(`@${t}`),e.push(this.arrayToLineCov(s))}),this.socket.send(`${S} ${e.join(";")}`),this.cachedCoveredRanges.clear(),this.numberOfCachedPositions=0}};var l=class o{static resolve(e,s,t){switch(e.type){case"url":return e.url;case"relative":return o.resolveRelative(s,t,e)}}static resolveRelative(e,s,t){var u;let n=e;t.hostReplace&&(n=e.replace(t.hostReplace.search,t.hostReplace.replace));let C=(u=t.scheme)!=null?u:"ws",i;t.port===void 0?i="":t.port==="keep"?i=`:${s}`:i=`:${t.port}`;let h="";t.path&&(h=`/${t.path}`);let d=`${C}://${n}${i}${h}`;return console.debug(`Resolved collector URL ${d} from ${e}:${s}`),d}};console.log("Starting coverage forwarding worker.");var p=new r,m=new a(p);onmessage=o=>{if(Array.isArray(o.data)){let[e,s]=o.data;m.addLines(e,s)}else if(o.data==="unload")m.flush();else if(o.data.type==="location"){let e=o.data,s=l.resolve($COLLECTOR_SPECIFIER,e.hostname,e.port),t=`${g} $BUCKET_SPECIFIER`;p.connect(`${s}/socket`,t)}else console.error(`No handler for message: ${o.data}`)};\n')}function c(){return d()}function d(){return window}function g(e,n){let t=c()[e];return t||(t=n,c()[e]=t),t}function p(e,n){let t=new Map;function a(i){let o=t.get(i);return o||(o={lines:new Set},t.set(i,o),o)}function r(i,o,k=o){let f=a(i).lines;for(let l=o;l<=k;l++)f.add(l);f.size>255&&s()}function s(){n(t),t.clear()}return setInterval(()=>s(),e),{putLineCoverage:r,flush:s}}var v=g("__TS_AGENT",{});function m(){return v._$BcWorker}function b(e){return v._$BcWorker=e,e}var C=p(250,e=>{for(let n of e.entries())m().postMessage([n[0],Array.from(n[1].lines)])});c()._$l=C.putLineCoverage;if(!m()){let e=b(new h),n={type:"location",hostname:document.location.hostname,port:document.location.port};e.postMessage(n),function(){let a=()=>{C.flush(),e.postMessage("unload")},r=function(i,o){o&&o.addEventListener(i,a,{capture:!0})},s=d();r("blur",s),r("unload",s),r("visibilitychange",s),r("beforeunload",s)}()}})();