Provide an opt-out for debug entrypoint resolution (#2349)

Author: firelizzard18

package.nls.json

@@ -76,6 +76,7 @@
   "configuration.terminalOptions": "Default launch options for the JavaScript debug terminal and npm scripts.",
   "configuration.unmapMissingSources": "Configures whether sourcemapped file where the original file can't be read will automatically be unmapped. If this is false (default), a prompt is shown.",
   "configuration.enableNetworkView": "Enables the experimental network view for targets that support it.",
+  "configuration.resolveDebugEntrypoint": "When true (default), js-debug uses source maps to remap a non-`.js` `program` path to its compiled output before launching. Set to false to execute the `program` path exactly as written.",
   "createDiagnostics.label": "Diagnose Breakpoint Problems",
   "customDescriptionGenerator.description": "Customize the textual description the debugger shows for objects (local variables, etc...). Samples:\n      1. this.toString() // will call toString to print all objects\n      2. this.customDescription ? this.customDescription() : defaultValue // Use customDescription method if available, if not return defaultValue\n      3. function (def) { return this.customDescription ? this.customDescription() : def } // Use customDescription method if available, if not return defaultValue\n      ",
   "customPropertiesGenerator.description": "Customize the properties shown for an object in the debugger (local variables, etc...). Samples:\n    1. { ...this, extraProperty: '12345' } // Add an extraProperty 12345 to all objects\n    2. this.customProperties ? this.customProperties() : this // Use customProperties method if available, if not use the properties in this (the default properties)\n    3. function () { return this.customProperties ? this.customProperties() : this } // Use customDescription method if available, if not return the default properties\n\n    Deprecated: This is a temporary implementation of this feature until we have time to implement it in the way described here: https://github.com/microsoft/vscode/issues/102181",

src/build/generate-contributions.ts

@@ -1328,6 +1328,11 @@ const configurationSchema: ConfigurationAttributes<IConfigurationTypes> = {
     default: true,
     description: refString('configuration.enableNetworkView'),
   },
+  [Configuration.ResolveDebugEntrypoint]: {
+    type: 'boolean',
+    default: true,
+    markdownDescription: refString('configuration.resolveDebugEntrypoint'),
+  },
 };
 
 const commands: ReadonlyArray<{

src/common/contributionUtils.ts

@@ -181,6 +181,7 @@ export const enum Configuration {
   DefaultRuntimeExecutables = 'debug.javascript.defaultRuntimeExecutable',
   ResourceRequestOptions = 'debug.javascript.resourceRequestOptions',
   EnableNetworkView = 'debug.javascript.enableNetworkView',
+  ResolveDebugEntrypoint = 'debug.javascript.resolveDebugEntrypoint',
 }
 
 export type DebugByLinkState = 'on' | 'off' | 'always';
@@ -203,6 +204,7 @@ export interface IConfigurationTypes {
   [Configuration.DefaultRuntimeExecutables]: { [K in DebugType]?: string };
   [Configuration.ResourceRequestOptions]: Partial<OptionsOfBufferResponseBody>;
   [Configuration.EnableNetworkView]: boolean;
+  [Configuration.ResolveDebugEntrypoint]: boolean;
 }
 
 export interface IStackFrameContext {

src/targets/node/nodeLauncher.ts

@@ -4,11 +4,12 @@
 
 import { inject, injectable, multiInject } from 'inversify';
 import { extname, resolve } from 'path';
+import * as vscode from 'vscode';
 import { IBreakpointsPredictor } from '../../adapter/breakpointPredictor';
 import { IPortLeaseTracker } from '../../adapter/portLeaseTracker';
 import Cdp from '../../cdp/api';
 import { asArray, iteratorFirst } from '../../common/arrayUtils';
-import { DebugType } from '../../common/contributionUtils';
+import { Configuration, DebugType, readConfig } from '../../common/contributionUtils';
 import { IFsUtils, LocalFsUtils } from '../../common/fsUtils';
 import { ILogger, LogTag } from '../../common/logging';
 import { fixDriveLetterAndSlashes } from '../../common/pathUtils';
@@ -312,6 +313,11 @@ export class NodeLauncher extends NodeLauncherBase<INodeLaunchConfiguration> {
       return targetProgram;
     }
 
+    const resolve = readConfig(vscode.workspace, Configuration.ResolveDebugEntrypoint);
+    if (!resolve) {
+      return targetProgram;
+    }
+
     const mapped = await this.bpPredictor.getPredictionForSource(targetProgram);
     if (!mapped || mapped.size === 0) {
       return targetProgram;