@react-native-windows/cli 0.0.0-canary.11 → 0.0.0-canary.113

package/lib-commonjs/runWindows/utils/msbuildtools.js

@@ -4,50 +4,83 @@
  * Licensed under the MIT License.
  * @format
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (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 (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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 const os_1 = require("os");
-const fs = require("fs");
-const path = require("path");
-const child_process = require("child_process");
-const chalk = require("chalk");
-const os = require("os");
-const shell = require("shelljs");
-const version_1 = require("./version");
-const checkRequirements = require("./checkRequirements");
+const fs_1 = __importDefault(require("@react-native-windows/fs"));
+const path_1 = __importDefault(require("path"));
+const child_process_1 = __importDefault(require("child_process"));
+const chalk_1 = __importDefault(require("chalk"));
+const os_2 = __importDefault(require("os"));
+const shelljs_1 = __importDefault(require("shelljs"));
+const version_1 = __importDefault(require("./version"));
+const checkRequirements = __importStar(require("./checkRequirements"));
 const commandWithProgress_1 = require("./commandWithProgress");
-const child_process_1 = require("child_process");
+const child_process_2 = require("child_process");
 const vsInstalls_1 = require("./vsInstalls");
+const telemetry_1 = require("@react-native-windows/telemetry");
 class MSBuildTools {
     /**
      * @param version is something like 16.0 for 2019
-     * @param msbuildPath  Path to MSBuild.exe (x86)
+     * @param installationPath  Path to installation root
      * @param installationVersion is the full version e.g. 16.3.29411.108
      */
-    constructor(version, msbuildPath, installationVersion) {
+    constructor(version, installationPath, installationVersion) {
         this.version = version;
-        this.msbuildPath = msbuildPath;
+        this.installationPath = installationPath;
         this.installationVersion = installationVersion;
     }
+    /**
+     * @returns directory where x86 msbuild can be found
+     */
+    msbuildPath() {
+        return path_1.default.join(this.installationPath, 'MSBuild/Current/Bin');
+    }
     cleanProject(slnFile) {
-        const cmd = `"${path.join(this.msbuildPath, 'msbuild.exe')}" "${slnFile}" /t:Clean`;
-        const results = child_process
-            .execSync(cmd)
-            .toString()
-            .split(os_1.EOL);
-        results.forEach(result => console.log(chalk.white(result)));
+        const cmd = `"${path_1.default.join(this.msbuildPath(), 'msbuild.exe')}" "${slnFile}" /t:Clean`;
+        const results = child_process_1.default.execSync(cmd).toString().split(os_1.EOL);
+        results.forEach((result) => console.log(chalk_1.default.white(result)));
+    }
+    async restorePackageConfigs(slnFile) {
+        const text = 'Restoring NuGet packages ';
+        const spinner = (0, commandWithProgress_1.newSpinner)(text);
+        await (0, commandWithProgress_1.commandWithProgress)(spinner, text, path_1.default.join(this.msbuildPath(), 'msbuild.exe'), [
+            slnFile,
+            '/t:Restore',
+            '/p:RestoreProjectStyle=PackagesConfig',
+            '/p:RestorePackagesConfig=true',
+        ], true, 'MSBuildError');
     }
     async buildProject(slnFile, buildType, buildArch, msBuildProps, verbose, target, buildLogDirectory, singleproc) {
-        commandWithProgress_1.newSuccess(`Found Solution: ${slnFile}`);
-        commandWithProgress_1.newInfo(`Build configuration: ${buildType}`);
-        commandWithProgress_1.newInfo(`Build platform: ${buildArch}`);
-        if (target) {
-            commandWithProgress_1.newInfo(`Build target: ${target}`);
-        }
+        (0, commandWithProgress_1.newSuccess)(`Found Solution: ${slnFile}`);
+        (0, commandWithProgress_1.newInfo)(`Build configuration: ${buildType}`);
+        (0, commandWithProgress_1.newInfo)(`Build platform: ${buildArch}`);
         const verbosityOption = verbose ? 'normal' : 'minimal';
-        const logPrefix = path.join(buildLogDirectory || os.tmpdir(), `msbuild_${process.pid}${target ? '_' + target : ''}`);
+        const logPrefix = path_1.default.join(buildLogDirectory || os_2.default.tmpdir(), `msbuild_${process.pid}_${target}`);
         const errorLog = logPrefix + '.err';
         const warnLog = logPrefix + '.wrn';
-        const localBinLog = target ? `:${target}.binlog` : '';
+        const localBinLog = target === 'build' ? '' : ':deploy.binlog';
         const binlog = buildLogDirectory ? `:${logPrefix}.binlog` : localBinLog;
         const args = [
             `/clp:NoSummary;NoItemAndPropertyList;Verbosity=${verbosityOption}`,
@@ -62,73 +95,79 @@ class MSBuildTools {
         // Building projects in parallel increases compiler memory usage and
         // doesn't lead to dramatic performance gains (See #4739). Only enable
         // parallel builds on machines with >16GB of memory to avoid OOM errors
-        const highMemory = os_1.totalmem() > 16 * 1024 * 1024 * 1024;
+        const highMemory = (0, os_1.totalmem)() > 16 * 1024 * 1024 * 1024;
         const enableParallelBuilds = singleproc === false || highMemory;
         if (enableParallelBuilds) {
             args.push('/maxCpuCount');
         }
-        if (target) {
-            args.push(`/t:${target}`);
+        if (target === 'build') {
+            args.push('/restore', '/p:RestorePackagesConfig=true');
         }
-        if (msBuildProps) {
-            Object.keys(msBuildProps).forEach(function (key) {
-                args.push(`/p:${key}=${msBuildProps[key]}`);
-            });
+        else {
+            args.push(`/t:Deploy`);
         }
+        Object.keys(msBuildProps).forEach((key) => {
+            args.push(`/p:${key}=${msBuildProps[key]}`);
+        });
         try {
             checkRequirements.isWinSdkPresent('10.0');
         }
         catch (e) {
-            commandWithProgress_1.newError(e.message);
+            (0, commandWithProgress_1.newError)(e.message);
             throw e;
         }
         if (verbose) {
             console.log(`Running MSBuild with args ${args.join(' ')}`);
         }
-        const progressName = 'Building Solution';
-        const spinner = commandWithProgress_1.newSpinner(progressName);
+        const progressName = target === 'deploy' ? 'Deploying Solution' : 'Building Solution';
+        const spinner = (0, commandWithProgress_1.newSpinner)(progressName);
         try {
-            await commandWithProgress_1.commandWithProgress(spinner, progressName, path.join(this.msbuildPath, 'msbuild.exe'), [slnFile].concat(args), verbose);
+            await (0, commandWithProgress_1.commandWithProgress)(spinner, progressName, path_1.default.join(this.msbuildPath(), 'msbuild.exe'), [slnFile].concat(args), verbose, 'MSBuildError');
         }
         catch (e) {
             let error = e;
             if (!e) {
-                const firstMessage = (await fs.promises.readFile(errorLog))
+                const firstMessage = (await fs_1.default.readFile(errorLog))
                     .toString()
                     .split(os_1.EOL)[0];
-                error = new Error(firstMessage);
+                error = new telemetry_1.CodedError('MSBuildError', firstMessage);
                 error.logfile = errorLog;
             }
             throw error;
         }
         // If we have no errors, delete the error log when we're done
-        if ((await fs.promises.stat(errorLog)).size === 0) {
-            await fs.promises.unlink(errorLog);
+        if ((await fs_1.default.stat(errorLog)).size === 0) {
+            await fs_1.default.unlink(errorLog);
         }
     }
-    static findAvailableVersion(buildArch, verbose) {
+    static findAvailableVersion(buildArch, verbose, prerelease) {
         // https://aka.ms/vs/workloads
         const requires = [
             'Microsoft.Component.MSBuild',
             getVCToolsByArch(buildArch),
         ];
-        const version = process.env.VisualStudioVersion || '16.0';
-        const vsInstallation = vsInstalls_1.findLatestVsInstall({ requires, version, verbose });
+        const minVersion = process.env.VisualStudioVersion || '16.7';
+        const vsInstallation = (0, vsInstalls_1.findLatestVsInstall)({
+            requires,
+            minVersion,
+            verbose,
+            prerelease,
+        });
         if (!vsInstallation) {
             if (process.env.VisualStudioVersion != null) {
-                throw new Error(`MSBuild tools not found for version ${process.env.VisualStudioVersion} (from environment). Make sure all required components have been installed`);
+                throw new telemetry_1.CodedError('NoMSBuild', `MSBuild tools not found for version ${process.env.VisualStudioVersion} (from environment). Make sure all required components have been installed`, { VisualStudioVersionFromEnv: process.env.VisualStudioVersion });
             }
             else {
-                throw new Error('MSBuild tools not found. Make sure all required components have been installed');
+                throw new telemetry_1.CodedError('NoMSBuild', `Could not find MSBuild with VCTools for Visual Studio ${minVersion} or later. Make sure all required components have been installed`, { minVersion: minVersion });
             }
         }
-        const toolsPath = path.join(vsInstallation.installationPath, 'MSBuild/Current/Bin');
-        if (fs.existsSync(toolsPath)) {
-            commandWithProgress_1.newSuccess(`Found MSBuild v${version} at ${toolsPath} (${vsInstallation.installationVersion})`);
-            return new MSBuildTools(version, toolsPath, vsInstallation.installationVersion);
+        const toolsPath = path_1.default.join(vsInstallation.installationPath, 'MSBuild/Current/Bin');
+        if (fs_1.default.existsSync(toolsPath)) {
+            (0, commandWithProgress_1.newSuccess)(`Found compatible MSBuild at ${toolsPath} (${vsInstallation.installationVersion})`);
+            return new MSBuildTools(minVersion, vsInstallation.installationPath, vsInstallation.installationVersion);
         }
         else {
-            throw new Error(`MSBuild path '${toolsPath} does not exist'`);
+            throw new telemetry_1.CodedError('NoMSBuild', `MSBuild path '${toolsPath} does not exist'`);
         }
     }
     static getAllAvailableUAPVersions() {
@@ -138,23 +177,23 @@ class MSBuildTools {
         if (!programFilesFolder) {
             return results;
         }
-        let uapFolderPath = path.join(programFilesFolder, 'Windows Kits', '10', 'Platforms', 'UAP');
-        if (!shell.test('-e', uapFolderPath)) {
+        let uapFolderPath = path_1.default.join(programFilesFolder, 'Windows Kits', '10', 'Platforms', 'UAP');
+        if (!shelljs_1.default.test('-e', uapFolderPath)) {
             // Check other installation folder from reg
             const sdkFolder = getSDK10InstallationFolder();
             if (sdkFolder) {
-                uapFolderPath = path.join(sdkFolder, 'Platforms', 'UAP');
+                uapFolderPath = path_1.default.join(sdkFolder, 'Platforms', 'UAP');
             }
         }
         // No UAP SDK exists on this machine
-        if (!shell.test('-e', uapFolderPath)) {
+        if (!shelljs_1.default.test('-e', uapFolderPath)) {
             return results;
         }
-        shell
+        shelljs_1.default
             .ls(uapFolderPath)
-            .filter(uapDir => shell.test('-d', path.join(uapFolderPath, uapDir)))
+            .filter((uapDir) => shelljs_1.default.test('-d', path_1.default.join(uapFolderPath, uapDir)))
             .map(version_1.default.tryParse)
-            .forEach(version => version && results.push(version));
+            .forEach((version) => version && results.push(version));
         return results;
     }
 }
@@ -164,8 +203,6 @@ function getVCToolsByArch(buildArch) {
         case 'x86':
         case 'x64':
             return 'Microsoft.VisualStudio.Component.VC.Tools.x86.x64';
-        case 'ARM':
-            return 'Microsoft.VisualStudio.Component.VC.Tools.ARM';
         case 'ARM64':
             return 'Microsoft.VisualStudio.Component.VC.Tools.ARM64';
     }
@@ -175,7 +212,7 @@ function getSDK10InstallationFolder() {
     const execString = 'reg query "HKLM\\SOFTWARE\\Microsoft\\Microsoft SDKs\\Windows\\v10.0" /s /v InstallationFolder /reg:32';
     let output;
     try {
-        output = child_process_1.execSync(execString).toString();
+        output = (0, child_process_2.execSync)(execString).toString();
     }
     catch (e) {
         return folder;

package/lib-commonjs/runWindows/utils/msbuildtools.js.map

@@ -1 +1 @@
-{"version":3,"file":"msbuildtools.js","sourceRoot":"","sources":["../../../src/runWindows/utils/msbuildtools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"msbuildtools.js","sourceRoot":"","sources":["../../../src/runWindows/utils/msbuildtools.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Copyright (c) Microsoft Corporation.\n * Licensed under the MIT License.\n * @format\n */\n\nimport {totalmem, EOL} from 'os';\nimport fs from '@react-native-windows/fs';\nimport path from 'path';\nimport child_process from 'child_process';\nimport chalk from 'chalk';\nimport os from 'os';\nimport shell from 'shelljs';\nimport Version from './version';\nimport * as checkRequirements from './checkRequirements';\nimport {\n  commandWithProgress,\n  newInfo,\n  newSpinner,\n  newSuccess,\n  newError,\n} from './commandWithProgress';\nimport {execSync} from 'child_process';\nimport {BuildArch, BuildConfig} from '../runWindowsOptions';\nimport {findLatestVsInstall} from './vsInstalls';\nimport {CodedError} from '@react-native-windows/telemetry';\n\nexport default class MSBuildTools {\n  /**\n   * @param version is something like 16.0 for 2019\n   * @param installationPath  Path to installation root\n   * @param installationVersion is the full version e.g. 16.3.29411.108\n   */\n  constructor(\n    public readonly version: string,\n    public readonly installationPath: string,\n    public readonly installationVersion: string,\n  ) {}\n\n  /**\n   * @returns directory where x86 msbuild can be found\n   */\n  msbuildPath() {\n    return path.join(this.installationPath, 'MSBuild/Current/Bin');\n  }\n\n  cleanProject(slnFile: string) {\n    const cmd = `\"${path.join(\n      this.msbuildPath(),\n      'msbuild.exe',\n    )}\" \"${slnFile}\" /t:Clean`;\n    const results = child_process.execSync(cmd).toString().split(EOL);\n    results.forEach((result) => console.log(chalk.white(result)));\n  }\n\n  async restorePackageConfigs(slnFile: any) {\n    const text = 'Restoring NuGet packages ';\n    const spinner = newSpinner(text);\n    await commandWithProgress(\n      spinner,\n      text,\n      path.join(this.msbuildPath(), 'msbuild.exe'),\n      [\n        slnFile,\n        '/t:Restore',\n        '/p:RestoreProjectStyle=PackagesConfig',\n        '/p:RestorePackagesConfig=true',\n      ],\n      true,\n      'MSBuildError',\n    );\n  }\n\n  async buildProject(\n    slnFile: string,\n    buildType: BuildConfig,\n    buildArch: BuildArch,\n    msBuildProps: Record<string, string>,\n    verbose: boolean,\n    target: 'build' | 'deploy',\n    buildLogDirectory: string | undefined,\n    singleproc?: boolean,\n  ) {\n    newSuccess(`Found Solution: ${slnFile}`);\n    newInfo(`Build configuration: ${buildType}`);\n    newInfo(`Build platform: ${buildArch}`);\n\n    const verbosityOption = verbose ? 'normal' : 'minimal';\n    const logPrefix = path.join(\n      buildLogDirectory || os.tmpdir(),\n      `msbuild_${process.pid}_${target}`,\n    );\n\n    const errorLog = logPrefix + '.err';\n    const warnLog = logPrefix + '.wrn';\n\n    const localBinLog = target === 'build' ? '' : ':deploy.binlog';\n    const binlog = buildLogDirectory ? `:${logPrefix}.binlog` : localBinLog;\n\n    const args = [\n      `/clp:NoSummary;NoItemAndPropertyList;Verbosity=${verbosityOption}`,\n      '/nologo',\n      `/p:Configuration=${buildType}`,\n      `/p:Platform=${buildArch}`,\n      '/p:AppxBundle=Never',\n      `/bl${binlog}`,\n      `/flp1:errorsonly;logfile=${errorLog}`,\n      `/flp2:warningsonly;logfile=${warnLog}`,\n    ];\n\n    // Building projects in parallel increases compiler memory usage and\n    // doesn't lead to dramatic performance gains (See #4739). Only enable\n    // parallel builds on machines with >16GB of memory to avoid OOM errors\n    const highMemory = totalmem() > 16 * 1024 * 1024 * 1024;\n    const enableParallelBuilds = singleproc === false || highMemory;\n\n    if (enableParallelBuilds) {\n      args.push('/maxCpuCount');\n    }\n\n    if (target === 'build') {\n      args.push('/restore', '/p:RestorePackagesConfig=true');\n    } else {\n      args.push(`/t:Deploy`);\n    }\n\n    Object.keys(msBuildProps).forEach((key) => {\n      args.push(`/p:${key}=${msBuildProps[key]}`);\n    });\n\n    try {\n      checkRequirements.isWinSdkPresent('10.0');\n    } catch (e) {\n      newError((e as Error).message);\n      throw e;\n    }\n\n    if (verbose) {\n      console.log(`Running MSBuild with args ${args.join(' ')}`);\n    }\n\n    const progressName =\n      target === 'deploy' ? 'Deploying Solution' : 'Building Solution';\n    const spinner = newSpinner(progressName);\n    try {\n      await commandWithProgress(\n        spinner,\n        progressName,\n        path.join(this.msbuildPath(), 'msbuild.exe'),\n        [slnFile].concat(args),\n        verbose,\n        'MSBuildError',\n      );\n    } catch (e) {\n      let error = e;\n      if (!e) {\n        const firstMessage = (await fs.readFile(errorLog))\n          .toString()\n          .split(EOL)[0];\n        error = new CodedError('MSBuildError', firstMessage);\n        (error as any).logfile = errorLog;\n      }\n      throw error;\n    }\n    // If we have no errors, delete the error log when we're done\n    if ((await fs.stat(errorLog)).size === 0) {\n      await fs.unlink(errorLog);\n    }\n  }\n\n  static findAvailableVersion(\n    buildArch: BuildArch,\n    verbose: boolean,\n    prerelease?: boolean,\n  ): MSBuildTools {\n    // https://aka.ms/vs/workloads\n    const requires = [\n      'Microsoft.Component.MSBuild',\n      getVCToolsByArch(buildArch),\n    ];\n    const minVersion = process.env.VisualStudioVersion || '16.7';\n    const vsInstallation = findLatestVsInstall({\n      requires,\n      minVersion,\n      verbose,\n      prerelease,\n    });\n\n    if (!vsInstallation) {\n      if (process.env.VisualStudioVersion != null) {\n        throw new CodedError(\n          'NoMSBuild',\n          `MSBuild tools not found for version ${process.env.VisualStudioVersion} (from environment). Make sure all required components have been installed`,\n          {VisualStudioVersionFromEnv: process.env.VisualStudioVersion},\n        );\n      } else {\n        throw new CodedError(\n          'NoMSBuild',\n          `Could not find MSBuild with VCTools for Visual Studio ${minVersion} or later. Make sure all required components have been installed`,\n          {minVersion: minVersion},\n        );\n      }\n    }\n\n    const toolsPath = path.join(\n      vsInstallation.installationPath,\n      'MSBuild/Current/Bin',\n    );\n\n    if (fs.existsSync(toolsPath)) {\n      newSuccess(\n        `Found compatible MSBuild at ${toolsPath} (${vsInstallation.installationVersion})`,\n      );\n      return new MSBuildTools(\n        minVersion,\n        vsInstallation.installationPath,\n        vsInstallation.installationVersion,\n      );\n    } else {\n      throw new CodedError(\n        'NoMSBuild',\n        `MSBuild path '${toolsPath} does not exist'`,\n      );\n    }\n  }\n\n  static getAllAvailableUAPVersions(): Version[] {\n    const results: Version[] = [];\n\n    const programFilesFolder =\n      process.env['ProgramFiles(x86)'] || process.env.ProgramFiles;\n    // No Program Files folder found, so we won't be able to find UAP SDK\n    if (!programFilesFolder) {\n      return results;\n    }\n\n    let uapFolderPath = path.join(\n      programFilesFolder,\n      'Windows Kits',\n      '10',\n      'Platforms',\n      'UAP',\n    );\n\n    if (!shell.test('-e', uapFolderPath)) {\n      // Check other installation folder from reg\n      const sdkFolder = getSDK10InstallationFolder();\n      if (sdkFolder) {\n        uapFolderPath = path.join(sdkFolder, 'Platforms', 'UAP');\n      }\n    }\n\n    // No UAP SDK exists on this machine\n    if (!shell.test('-e', uapFolderPath)) {\n      return results;\n    }\n\n    shell\n      .ls(uapFolderPath)\n      .filter((uapDir) => shell.test('-d', path.join(uapFolderPath, uapDir)))\n      .map(Version.tryParse)\n      .forEach((version) => version && results.push(version));\n\n    return results;\n  }\n}\n\nfunction getVCToolsByArch(buildArch: BuildArch): string {\n  switch (buildArch) {\n    case 'x86':\n    case 'x64':\n      return 'Microsoft.VisualStudio.Component.VC.Tools.x86.x64';\n    case 'ARM64':\n      return 'Microsoft.VisualStudio.Component.VC.Tools.ARM64';\n  }\n}\n\nfunction getSDK10InstallationFolder(): string {\n  const folder = '';\n\n  const execString =\n    'reg query \"HKLM\\\\SOFTWARE\\\\Microsoft\\\\Microsoft SDKs\\\\Windows\\\\v10.0\" /s /v InstallationFolder /reg:32';\n  let output;\n  try {\n    output = execSync(execString).toString();\n  } catch (e) {\n    return folder;\n  }\n\n  const re =\n    /\\\\Microsoft SDKs\\\\Windows\\\\v10.0\\s*InstallationFolder\\s+REG_SZ\\s+(.*)/gim;\n  const match = re.exec(output);\n  if (match) {\n    return match[1];\n  }\n\n  return folder;\n}\n"]}

package/lib-commonjs/runWindows/utils/telemetryHelpers.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ * @format
+ */
+import { Config, CommandOption } from '@react-native-community/cli-types';
+import { CommanderOptionsType, OptionSanitizer } from '@react-native-windows/telemetry';
+/**
+ * Calculates a the default values of a given react-native CLI command's options.
+ * @param config Config passed from react-native CLI.
+ * @param commandOptions The options definition for the command.
+ * @returns The default options for the command.
+ */
+export declare function getDefaultOptions(config: Config, commandOptions: CommandOption[]): CommanderOptionsType;
+/**
+ * Sets up and starts the telemetry gathering for the CLI command.
+ * @param commandName The name of the CLI command.
+ * @param config Config passed from react-native CLI.
+ * @param options Options passed from react-native CLI.
+ * @param defaultOptions Default options for the command.
+ * @param optionSanitizer Function to sanitize the option values for telemetry.
+ */
+export declare function startTelemetrySession(commandName: string, config: Config, options: CommanderOptionsType, defaultOptions: CommanderOptionsType, optionSanitizer: OptionSanitizer): Promise<void>;
+/**
+ * Ends the gathering of telemetry for the CLI command.
+ * @param error The error (if any) thrown during the command.
+ * @param getExtraProps Function to get any extra command-specific telemetry properties.
+ */
+export declare function endTelemetrySession(error?: Error, getExtraProps?: () => Promise<Record<string, any>>): Promise<void>;

package/lib-commonjs/runWindows/utils/telemetryHelpers.js

@@ -0,0 +1,109 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ * @format
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.endTelemetrySession = exports.startTelemetrySession = exports.getDefaultOptions = void 0;
+const lodash_1 = require("lodash");
+const telemetry_1 = require("@react-native-windows/telemetry");
+/**
+ * Calculates a the default values of a given react-native CLI command's options.
+ * @param config Config passed from react-native CLI.
+ * @param commandOptions The options definition for the command.
+ * @returns The default options for the command.
+ */
+function getDefaultOptions(config, commandOptions) {
+    const result = {
+        logging: false,
+    };
+    for (const option of commandOptions) {
+        let key = option.name.startsWith('--')
+            ? option.name.slice('--'.length)
+            : option.name;
+        key = key.trim();
+        let value = option.default;
+        if (value !== undefined && value.name) {
+            value = value(config);
+        }
+        if (key.endsWith(' [string]')) {
+            // Option is a string
+            key = key.slice(0, -' [string]'.length);
+            // Option is a number
+        }
+        else if (key.endsWith(' [number]')) {
+            key = key.slice(0, -' [number]'.length);
+        }
+        else {
+            // Option is a boolean
+            // Note: Commander ignores the default property for booleans
+            if (key.startsWith('no-')) {
+                key = key.slice('no-'.length);
+                // Commander always defaults to true for flags that start with --no
+                value = true;
+            }
+            else {
+                // Commander always defaults to undefined for flags
+                value = undefined;
+            }
+        }
+        key = (0, lodash_1.camelCase)(key);
+        result[key] = value;
+    }
+    return result;
+}
+exports.getDefaultOptions = getDefaultOptions;
+/**
+ * Sets up and starts the telemetry gathering for the CLI command.
+ * @param commandName The name of the CLI command.
+ * @param config Config passed from react-native CLI.
+ * @param options Options passed from react-native CLI.
+ * @param defaultOptions Default options for the command.
+ * @param optionSanitizer Function to sanitize the option values for telemetry.
+ */
+async function startTelemetrySession(commandName, config, options, defaultOptions, optionSanitizer) {
+    if (!options.telemetry) {
+        if (options.logging) {
+            console.log('Telemetry is disabled');
+        }
+        return;
+    }
+    await telemetry_1.Telemetry.setup();
+    const sanitizedOptions = (0, telemetry_1.commanderOptionsToOptions)(options, optionSanitizer);
+    const sanitizedDefaultOptions = (0, telemetry_1.commanderOptionsToOptions)(defaultOptions, optionSanitizer);
+    const sanitizedArgs = (0, telemetry_1.optionsToArgs)(sanitizedOptions, process.argv);
+    const startInfo = {
+        commandName,
+        args: sanitizedArgs,
+        options: sanitizedOptions,
+        defaultOptions: sanitizedDefaultOptions,
+    };
+    telemetry_1.Telemetry.startCommand(startInfo);
+    const projectInfo = await (0, telemetry_1.configToProjectInfo)(config);
+    if (projectInfo) {
+        telemetry_1.Telemetry.setProjectInfo(projectInfo);
+    }
+    const projectFile = (0, telemetry_1.getProjectFileFromConfig)(config);
+    if (projectFile) {
+        await telemetry_1.Telemetry.populateNuGetPackageVersions(projectFile);
+    }
+}
+exports.startTelemetrySession = startTelemetrySession;
+/**
+ * Ends the gathering of telemetry for the CLI command.
+ * @param error The error (if any) thrown during the command.
+ * @param getExtraProps Function to get any extra command-specific telemetry properties.
+ */
+async function endTelemetrySession(error, getExtraProps) {
+    const endInfo = {
+        resultCode: 'Success',
+    };
+    if (error) {
+        endInfo.resultCode =
+            error instanceof telemetry_1.CodedError ? error.type : 'Unknown';
+    }
+    telemetry_1.Telemetry.endCommand(endInfo, getExtraProps ? await getExtraProps() : undefined);
+}
+exports.endTelemetrySession = endTelemetrySession;
+//# sourceMappingURL=telemetryHelpers.js.map

package/lib-commonjs/runWindows/utils/telemetryHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetryHelpers.js","sourceRoot":"","sources":["../../../src/runWindows/utils/telemetryHelpers.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Copyright (c) Microsoft Corporation.\n * Licensed under the MIT License.\n * @format\n */\n\nimport {camelCase} from 'lodash';\n\nimport {\n  Config,\n  CommandOption,\n  OptionValue,\n} from '@react-native-community/cli-types';\n\nimport {\n  Telemetry,\n  CodedError,\n  CommandStartInfo,\n  CommandEndInfo,\n  CommanderOptionsType,\n  commanderOptionsToOptions,\n  optionsToArgs,\n  OptionSanitizer,\n  configToProjectInfo,\n  getProjectFileFromConfig,\n} from '@react-native-windows/telemetry';\n\n/**\n * Calculates a the default values of a given react-native CLI command's options.\n * @param config Config passed from react-native CLI.\n * @param commandOptions The options definition for the command.\n * @returns The default options for the command.\n */\nexport function getDefaultOptions(\n  config: Config,\n  commandOptions: CommandOption[],\n): CommanderOptionsType {\n  const result: CommanderOptionsType = {\n    logging: false,\n  };\n  for (const option of commandOptions) {\n    let key = option.name.startsWith('--')\n      ? option.name.slice('--'.length)\n      : option.name;\n    key = key.trim();\n\n    let value = option.default;\n    if (value !== undefined && (value as (ctx: Config) => OptionValue).name) {\n      value = (value as (ctx: Config) => OptionValue)(config);\n    }\n\n    if (key.endsWith(' [string]')) {\n      // Option is a string\n      key = key.slice(0, -' [string]'.length);\n      // Option is a number\n    } else if (key.endsWith(' [number]')) {\n      key = key.slice(0, -' [number]'.length);\n    } else {\n      // Option is a boolean\n      // Note: Commander ignores the default property for booleans\n      if (key.startsWith('no-')) {\n        key = key.slice('no-'.length);\n        // Commander always defaults to true for flags that start with --no\n        value = true;\n      } else {\n        // Commander always defaults to undefined for flags\n        value = undefined;\n      }\n    }\n\n    key = camelCase(key);\n    result[key] = value;\n  }\n  return result;\n}\n\n/**\n * Sets up and starts the telemetry gathering for the CLI command.\n * @param commandName The name of the CLI command.\n * @param config Config passed from react-native CLI.\n * @param options Options passed from react-native CLI.\n * @param defaultOptions Default options for the command.\n * @param optionSanitizer Function to sanitize the option values for telemetry.\n */\nexport async function startTelemetrySession(\n  commandName: string,\n  config: Config,\n  options: CommanderOptionsType,\n  defaultOptions: CommanderOptionsType,\n  optionSanitizer: OptionSanitizer,\n) {\n  if (!options.telemetry) {\n    if (options.logging) {\n      console.log('Telemetry is disabled');\n    }\n    return;\n  }\n\n  await Telemetry.setup();\n\n  const sanitizedOptions = commanderOptionsToOptions(options, optionSanitizer);\n  const sanitizedDefaultOptions = commanderOptionsToOptions(\n    defaultOptions,\n    optionSanitizer,\n  );\n  const sanitizedArgs = optionsToArgs(sanitizedOptions, process.argv);\n\n  const startInfo: CommandStartInfo = {\n    commandName,\n    args: sanitizedArgs,\n    options: sanitizedOptions,\n    defaultOptions: sanitizedDefaultOptions,\n  };\n\n  Telemetry.startCommand(startInfo);\n\n  const projectInfo = await configToProjectInfo(config);\n  if (projectInfo) {\n    Telemetry.setProjectInfo(projectInfo);\n  }\n\n  const projectFile = getProjectFileFromConfig(config);\n  if (projectFile) {\n    await Telemetry.populateNuGetPackageVersions(projectFile);\n  }\n}\n\n/**\n * Ends the gathering of telemetry for the CLI command.\n * @param error The error (if any) thrown during the command.\n * @param getExtraProps Function to get any extra command-specific telemetry properties.\n */\nexport async function endTelemetrySession(\n  error?: Error,\n  getExtraProps?: () => Promise<Record<string, any>>,\n) {\n  const endInfo: CommandEndInfo = {\n    resultCode: 'Success',\n  };\n\n  if (error) {\n    endInfo.resultCode =\n      error instanceof CodedError ? (error as CodedError).type : 'Unknown';\n  }\n\n  Telemetry.endCommand(\n    endInfo,\n    getExtraProps ? await getExtraProps() : undefined,\n  );\n}\n"]}

package/lib-commonjs/runWindows/utils/version.d.ts

@@ -4,10 +4,10 @@
  * @format
  */
 export default class Version {
-    private major;
-    private minor;
-    private build;
-    private qfe;
+    private readonly major;
+    private readonly minor;
+    private readonly build;
+    private readonly qfe;
     constructor(major: number, minor?: number, build?: number, qfe?: number);
     eq(other: Version): boolean;
     gt(other: Version): boolean;

package/lib-commonjs/runWindows/utils/version.js

@@ -100,7 +100,7 @@ class Version {
     }
     static tryParse(str) {
         if (VERSION_EXPRESSION.test(str)) {
-            const versionArray = str.split('.').map(x => parseInt(x, 10));
+            const versionArray = str.split('.').map((x) => parseInt(x, 10));
             return new Version(versionArray[0], versionArray[1], versionArray[2], versionArray[3]);
         }
         return null;

package/lib-commonjs/runWindows/utils/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/runWindows/utils/version.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/runWindows/utils/version.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAEH,MAAM,kBAAkB,GAAG,2BAA2B,CAAC;AAEvD,MAAqB,OAAO;IAC1B,YACmB,KAAa,EACb,QAAgB,CAAC,EACjB,QAAgB,CAAC,EACjB,MAAc,CAAC;QAHf,UAAK,GAAL,KAAK,CAAQ;QACb,UAAK,GAAL,KAAK,CAAY;QACjB,UAAK,GAAL,KAAK,CAAY;QACjB,QAAG,GAAH,GAAG,CAAY;IAC/B,CAAC;IAEJ,EAAE,CAAC,KAAc;QACf,IAAI,KAAK,CAAC,WAAW,KAAK,OAAO,EAAE;YACjC,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC,CAAC;SACzD;QAED,OAAO,CACL,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;YAC1B,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;YAC1B,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;YAC1B,IAAI,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,CACvB,CAAC;IACJ,CAAC;IAED,EAAE,CAAC,KAAc;QACf,IAAI,KAAK,CAAC,WAAW,KAAK,OAAO,EAAE;YACjC,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC,CAAC;SACzD;QAED,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE;YAC5B,OAAO,IAAI,CAAC;SACb;QACD,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE;YAC5B,OAAO,KAAK,CAAC;SACd;QACD,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE;YAC5B,OAAO,IAAI,CAAC;SACb;QACD,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE;YAC5B,OAAO,KAAK,CAAC;SACd;QACD,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE;YAC5B,OAAO,IAAI,CAAC;SACb;QACD,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE;YAC5B,OAAO,KAAK,CAAC;SACd;QACD,IAAI,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE;YACxB,OAAO,IAAI,CAAC;SACb;QACD,IAAI,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE;YACxB,OAAO,KAAK,CAAC;SACd;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,GAAG,CAAC,KAAc;QAChB,IAAI,KAAK,CAAC,WAAW,KAAK,OAAO,EAAE;YACjC,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC,CAAC;SACzD;QAED,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE;YAC5B,OAAO,IAAI,CAAC;SACb;QACD,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE;YAC5B,OAAO,KAAK,CAAC;SACd;QACD,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE;YAC5B,OAAO,IAAI,CAAC;SACb;QACD,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE;YAC5B,OAAO,KAAK,CAAC;SACd;QACD,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE;YAC5B,OAAO,IAAI,CAAC;SACb;QACD,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE;YAC5B,OAAO,KAAK,CAAC;SACd;QACD,IAAI,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE;YACxB,OAAO,IAAI,CAAC;SACb;QACD,IAAI,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE;YACxB,OAAO,KAAK,CAAC;SACd;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ;QACN,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IACjE,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,CAAU,EAAE,CAAU;QACnC,IAAI,CAAC,CAAC,WAAW,KAAK,OAAO,IAAI,CAAC,CAAC,WAAW,KAAK,OAAO,EAAE;YAC1D,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC,CAAC;SACzD;QAED,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,GAAW;QAC3B,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,OAAO,EAAE;YACZ,MAAM,IAAI,SAAS,CAAC,mCAAmC,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC;SACvE;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,GAAW;QACzB,IAAI,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YAChC,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YAChE,OAAO,IAAI,OAAO,CAChB,YAAY,CAAC,CAAC,CAAC,EACf,YAAY,CAAC,CAAC,CAAC,EACf,YAAY,CAAC,CAAC,CAAC,EACf,YAAY,CAAC,CAAC,CAAC,CAChB,CAAC;SACH;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAvHD,0BAuHC","sourcesContent":["/**\n * Copyright (c) Microsoft Corporation.\n * Licensed under the MIT License.\n * @format\n */\n\nconst VERSION_EXPRESSION = /^\\d{1,8}(\\.\\d{1,8}){0,3}$/;\n\nexport default class Version {\n  constructor(\n    private readonly major: number,\n    private readonly minor: number = 0,\n    private readonly build: number = 0,\n    private readonly qfe: number = 0,\n  ) {}\n\n  eq(other: Version): boolean {\n    if (other.constructor !== Version) {\n      throw new TypeError('other must be a Version instance');\n    }\n\n    return (\n      this.major === other.major &&\n      this.minor === other.minor &&\n      this.build === other.build &&\n      this.qfe === other.qfe\n    );\n  }\n\n  gt(other: Version): boolean {\n    if (other.constructor !== Version) {\n      throw new TypeError('other must be a Version instance');\n    }\n\n    if (this.major > other.major) {\n      return true;\n    }\n    if (this.major < other.major) {\n      return false;\n    }\n    if (this.minor > other.minor) {\n      return true;\n    }\n    if (this.minor < other.minor) {\n      return false;\n    }\n    if (this.build > other.build) {\n      return true;\n    }\n    if (this.build < other.build) {\n      return false;\n    }\n    if (this.qfe > other.qfe) {\n      return true;\n    }\n    if (this.qfe < other.qfe) {\n      return false;\n    }\n\n    return false;\n  }\n\n  gte(other: Version): boolean {\n    if (other.constructor !== Version) {\n      throw new TypeError('other must be a Version instance');\n    }\n\n    if (this.major > other.major) {\n      return true;\n    }\n    if (this.major < other.major) {\n      return false;\n    }\n    if (this.minor > other.minor) {\n      return true;\n    }\n    if (this.minor < other.minor) {\n      return false;\n    }\n    if (this.build > other.build) {\n      return true;\n    }\n    if (this.build < other.build) {\n      return false;\n    }\n    if (this.qfe > other.qfe) {\n      return true;\n    }\n    if (this.qfe < other.qfe) {\n      return false;\n    }\n\n    return true;\n  }\n\n  toString(): string {\n    return `${this.major}.${this.minor}.${this.build}.${this.qfe}`;\n  }\n\n  static compare(x: Version, y: Version): number {\n    if (x.constructor !== Version || y.constructor !== Version) {\n      throw new TypeError('Only can compare Version objects');\n    }\n\n    return x.gt(y) ? 1 : x.eq(y) ? 0 : -1;\n  }\n\n  static fromString(str: string): Version {\n    const version = Version.tryParse(str);\n    if (!version) {\n      throw new TypeError('Cannot construct a version from \"' + str + '\".');\n    }\n    return version;\n  }\n\n  static tryParse(str: string): Version | null {\n    if (VERSION_EXPRESSION.test(str)) {\n      const versionArray = str.split('.').map((x) => parseInt(x, 10));\n      return new Version(\n        versionArray[0],\n        versionArray[1],\n        versionArray[2],\n        versionArray[3],\n      );\n    }\n    return null;\n  }\n}\n"]}

package/lib-commonjs/runWindows/utils/vsInstalls.d.ts

@@ -10,6 +10,7 @@ interface VisualStudioInstallation {
     instanceId: string;
     installationPath: string;
     installationVersion: string;
+    prerelease: string;
 }
 /**
  * Enumerate the installed versions of Visual Studio
@@ -19,13 +20,15 @@ export declare function enumerateVsInstalls(opts: {
     version?: string;
     verbose?: boolean;
     latest?: boolean;
+    prerelease?: boolean;
 }): VisualStudioInstallation[];
 /**
  * Find the latest available VS installation that matches the given constraints
  */
 export declare function findLatestVsInstall(opts: {
     requires?: string[];
-    version?: string;
+    minVersion?: string;
     verbose?: boolean;
+    prerelease?: boolean;
 }): VisualStudioInstallation | null;
 export {};

package/lib-commonjs/runWindows/utils/vsInstalls.js

@@ -4,11 +4,15 @@
  * Licensed under the MIT License.
  * @format
  */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.findLatestVsInstall = exports.enumerateVsInstalls = void 0;
+const telemetry_1 = require("@react-native-windows/telemetry");
 const child_process_1 = require("child_process");
-const fs = require("fs");
-const path = require("path");
+const fs_1 = __importDefault(require("@react-native-windows/fs"));
+const path_1 = __importDefault(require("path"));
 /**
  * Helper to run vswhere in JSON mode
  *
@@ -17,14 +21,19 @@ const path = require("path");
  */
 function vsWhere(args, verbose) {
     // This path is maintained and VS has promised to keep it valid.
-    const vsWherePath = path.join(process.env['ProgramFiles(x86)'] || process.env.ProgramFiles, '/Microsoft Visual Studio/Installer/vswhere.exe');
+    const vsWherePath = path_1.default.join(process.env['ProgramFiles(x86)'] || process.env.ProgramFiles, '/Microsoft Visual Studio/Installer/vswhere.exe');
     if (verbose) {
         console.log('Looking for vswhere at: ' + vsWherePath);
     }
-    if (!fs.existsSync(vsWherePath)) {
-        throw new Error(`Unable to find vswhere at ${vsWherePath}`);
+    if (!fs_1.default.existsSync(vsWherePath)) {
+        throw new telemetry_1.CodedError('NoVSWhere', `Unable to find vswhere at ${vsWherePath}`);
     }
-    return JSON.parse(child_process_1.execSync(`"${vsWherePath}" ${args.join(' ')} -format json -utf8`).toString('utf8'));
+    const cmdline = `"${vsWherePath}" ${args.join(' ')} -format json -utf8`;
+    const json = JSON.parse((0, child_process_1.execSync)(cmdline).toString('utf8'));
+    for (const entry of json) {
+        entry.prerelease = entry.catalog.productMilestoneIsPreRelease;
+    }
+    return json;
 }
 /**
  * Enumerate the installed versions of Visual Studio
@@ -40,6 +49,9 @@ function enumerateVsInstalls(opts) {
     if (opts.latest) {
         args.push('-latest');
     }
+    if (opts.prerelease) {
+        args.push('-prerelease');
+    }
     return vsWhere(args, opts.verbose);
 }
 exports.enumerateVsInstalls = enumerateVsInstalls;
@@ -47,7 +59,10 @@ exports.enumerateVsInstalls = enumerateVsInstalls;
  * Find the latest available VS installation that matches the given constraints
  */
 function findLatestVsInstall(opts) {
-    const installs = enumerateVsInstalls(Object.assign(Object.assign({}, opts), { latest: true }));
+    let installs = enumerateVsInstalls({ ...opts, latest: true });
+    if (opts.prerelease && installs.length > 0) {
+        installs = installs.filter((x) => x.prerelease === 'True');
+    }
     if (installs.length > 0) {
         return installs[0];
     }

package/lib-commonjs/runWindows/utils/vsInstalls.js.map

@@ -1 +1 @@
-{"version":3,"file":"vsInstalls.js","sourceRoot":"","sources":["../../../src/runWindows/utils/vsInstalls.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,iDAAuC;AACvC,yBAAyB;AACzB,6BAA6B;AAW7B;;;;;GAKG;AACH,SAAS,OAAO,CAAC,IAAc,EAAE,OAAiB;IAChD,gEAAgE;IAChE,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAC3B,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,YAAa,EAC7D,gDAAgD,CACjD,CAAC;IAEF,IAAI,OAAO,EAAE;QACX,OAAO,CAAC,GAAG,CAAC,0BAA0B,GAAG,WAAW,CAAC,CAAC;KACvD;IAED,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE;QAC/B,MAAM,IAAI,KAAK,CAAC,6BAA6B,WAAW,EAAE,CAAC,CAAC;KAC7D;IAED,OAAO,IAAI,CAAC,KAAK,CACf,wBAAQ,CAAC,IAAI,WAAW,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,QAAQ,CACxE,MAAM,CACP,CACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,IAKnC;IACC,MAAM,IAAI,GAAa,EAAE,CAAC;IAE1B,IAAI,IAAI,CAAC,OAAO,EAAE;QAChB,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;KACrE;IAED,IAAI,IAAI,CAAC,QAAQ,EAAE;QACjB,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;KACnD;IAED,IAAI,IAAI,CAAC,MAAM,EAAE;QACf,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;KACtB;IAED,OAAO,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC;AArBD,kDAqBC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,IAInC;IACC,MAAM,QAAQ,GAAG,mBAAmB,iCAAK,IAAI,KAAE,MAAM,EAAE,IAAI,IAAE,CAAC;IAC9D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE;QACvB,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;KACpB;SAAM;QACL,OAAO,IAAI,CAAC;KACb;AACH,CAAC;AAXD,kDAWC"}
+{"version":3,"file":"vsInstalls.js","sourceRoot":"","sources":["../../../src/runWindows/utils/vsInstalls.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;AAEH,+DAA2D;AAC3D,iDAAuC;AACvC,kEAA0C;AAC1C,gDAAwB;AAYxB;;;;;GAKG;AACH,SAAS,OAAO,CAAC,IAAc,EAAE,OAAiB;IAChD,gEAAgE;IAChE,MAAM,WAAW,GAAG,cAAI,CAAC,IAAI,CAC3B,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,YAAa,EAC7D,gDAAgD,CACjD,CAAC;IAEF,IAAI,OAAO,EAAE;QACX,OAAO,CAAC,GAAG,CAAC,0BAA0B,GAAG,WAAW,CAAC,CAAC;KACvD;IAED,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE;QAC/B,MAAM,IAAI,sBAAU,CAClB,WAAW,EACX,6BAA6B,WAAW,EAAE,CAC3C,CAAC;KACH;IAED,MAAM,OAAO,GAAG,IAAI,WAAW,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,qBAAqB,CAAC;IACxE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,wBAAQ,EAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAE5D,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE;QACxB,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,4BAA4B,CAAC;KAC/D;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,IAMnC;IACC,MAAM,IAAI,GAAa,EAAE,CAAC;IAE1B,IAAI,IAAI,CAAC,OAAO,EAAE;QAChB,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;KACrE;IAED,IAAI,IAAI,CAAC,QAAQ,EAAE;QACjB,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;KACnD;IAED,IAAI,IAAI,CAAC,MAAM,EAAE;QACf,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;KACtB;IAED,IAAI,IAAI,CAAC,UAAU,EAAE;QACnB,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;KAC1B;IAED,OAAO,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC;AA1BD,kDA0BC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,IAKnC;IACC,IAAI,QAAQ,GAAG,mBAAmB,CAAC,EAAC,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,EAAC,CAAC,CAAC;IAE5D,IAAI,IAAI,CAAC,UAAU,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE;QAC1C,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC;KAC5D;IAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE;QACvB,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;KACpB;SAAM;QACL,OAAO,IAAI,CAAC;KACb;AACH,CAAC;AAjBD,kDAiBC","sourcesContent":["/**\n * Copyright (c) Microsoft Corporation.\n * Licensed under the MIT License.\n * @format\n */\n\nimport {CodedError} from '@react-native-windows/telemetry';\nimport {execSync} from 'child_process';\nimport fs from '@react-native-windows/fs';\nimport path from 'path';\n\n/**\n * A subset of the per-instance properties returned by vswhere\n */\ninterface VisualStudioInstallation {\n  instanceId: string;\n  installationPath: string;\n  installationVersion: string;\n  prerelease: string;\n}\n\n/**\n * Helper to run vswhere in JSON mode\n *\n * @param args Arguments to pass to vsWhere\n * @param verbose enable verbose logging\n */\nfunction vsWhere(args: string[], verbose?: boolean): any[] {\n  // This path is maintained and VS has promised to keep it valid.\n  const vsWherePath = path.join(\n    process.env['ProgramFiles(x86)'] || process.env.ProgramFiles!,\n    '/Microsoft Visual Studio/Installer/vswhere.exe',\n  );\n\n  if (verbose) {\n    console.log('Looking for vswhere at: ' + vsWherePath);\n  }\n\n  if (!fs.existsSync(vsWherePath)) {\n    throw new CodedError(\n      'NoVSWhere',\n      `Unable to find vswhere at ${vsWherePath}`,\n    );\n  }\n\n  const cmdline = `\"${vsWherePath}\" ${args.join(' ')} -format json -utf8`;\n  const json = JSON.parse(execSync(cmdline).toString('utf8'));\n\n  for (const entry of json) {\n    entry.prerelease = entry.catalog.productMilestoneIsPreRelease;\n  }\n\n  return json;\n}\n\n/**\n * Enumerate the installed versions of Visual Studio\n */\nexport function enumerateVsInstalls(opts: {\n  requires?: string[];\n  version?: string;\n  verbose?: boolean;\n  latest?: boolean;\n  prerelease?: boolean;\n}): VisualStudioInstallation[] {\n  const args: string[] = [];\n\n  if (opts.version) {\n    args.push(`-version [${opts.version},${Number(opts.version) + 1})`);\n  }\n\n  if (opts.requires) {\n    args.push(`-requires ${opts.requires.join(' ')}`);\n  }\n\n  if (opts.latest) {\n    args.push('-latest');\n  }\n\n  if (opts.prerelease) {\n    args.push('-prerelease');\n  }\n\n  return vsWhere(args, opts.verbose);\n}\n\n/**\n * Find the latest available VS installation that matches the given constraints\n */\nexport function findLatestVsInstall(opts: {\n  requires?: string[];\n  minVersion?: string;\n  verbose?: boolean;\n  prerelease?: boolean;\n}): VisualStudioInstallation | null {\n  let installs = enumerateVsInstalls({...opts, latest: true});\n\n  if (opts.prerelease && installs.length > 0) {\n    installs = installs.filter((x) => x.prerelease === 'True');\n  }\n\n  if (installs.length > 0) {\n    return installs[0];\n  } else {\n    return null;\n  }\n}\n"]}