@react-native-windows/cli 0.0.0-canary.99 → 0.0.1-0

package/lib-commonjs/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/utils/telemetryHelpers.js

@@ -0,0 +1,121 @@
+"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");
+const commandWithProgress_1 = require("./commandWithProgress");
+/**
+ * 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) {
+    const verbose = options.logging === true;
+    if (!options.telemetry) {
+        if (verbose) {
+            (0, commandWithProgress_1.newInfo)('Telemetry is disabled');
+        }
+        return;
+    }
+    if (verbose) {
+        (0, commandWithProgress_1.newInfo)(`Running ${(0, telemetry_1.nodeArchitecture)()} node on a ${(0, telemetry_1.deviceArchitecture)()} machine`);
+    }
+    if ((0, telemetry_1.deviceArchitecture)() !== (0, telemetry_1.nodeArchitecture)()) {
+        (0, commandWithProgress_1.newWarn)('This version of node was built for a different architecture than this machine and may cause unintended behavior');
+    }
+    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) {
+    if (!telemetry_1.Telemetry.isEnabled()) {
+        // Bail early so don't waste time here
+        return;
+    }
+    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/utils/telemetryHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetryHelpers.js","sourceRoot":"","sources":["../../src/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  deviceArchitecture,\n  nodeArchitecture,\n} from '@react-native-windows/telemetry';\n\nimport {newInfo, newWarn} from './commandWithProgress';\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  const verbose = options.logging === true;\n\n  if (!options.telemetry) {\n    if (verbose) {\n      newInfo('Telemetry is disabled');\n    }\n    return;\n  }\n\n  if (verbose) {\n    newInfo(\n      `Running ${nodeArchitecture()} node on a ${deviceArchitecture()} machine`,\n    );\n  }\n\n  if (deviceArchitecture() !== nodeArchitecture()) {\n    newWarn(\n      'This version of node was built for a different architecture than this machine and may cause unintended behavior',\n    );\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  if (!Telemetry.isEnabled()) {\n    // Bail early so don't waste time here\n    return;\n  }\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 → utils}/version.d.ts

@@ -1,19 +1,19 @@
-/**
- * Copyright (c) Microsoft Corporation.
- * Licensed under the MIT License.
- * @format
- */
-export default class Version {
-    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;
-    gte(other: Version): boolean;
-    toString(): string;
-    static compare(x: Version, y: Version): number;
-    static fromString(str: string): Version;
-    static tryParse(str: string): Version | null;
-}
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ * @format
+ */
+export default class Version {
+    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;
+    gte(other: Version): boolean;
+    toString(): string;
+    static compare(x: Version, y: Version): number;
+    static fromString(str: string): Version;
+    static tryParse(str: string): Version | null;
+}

package/lib-commonjs/{runWindows/utils → utils}/version.js

@@ -1,110 +1,110 @@
-"use strict";
-/**
- * Copyright (c) Microsoft Corporation.
- * Licensed under the MIT License.
- * @format
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-const VERSION_EXPRESSION = /^\d{1,8}(\.\d{1,8}){0,3}$/;
-class Version {
-    constructor(major, minor = 0, build = 0, qfe = 0) {
-        this.major = major;
-        this.minor = minor;
-        this.build = build;
-        this.qfe = qfe;
-    }
-    eq(other) {
-        if (other.constructor !== Version) {
-            throw new TypeError('other must be a Version instance');
-        }
-        return (this.major === other.major &&
-            this.minor === other.minor &&
-            this.build === other.build &&
-            this.qfe === other.qfe);
-    }
-    gt(other) {
-        if (other.constructor !== Version) {
-            throw new TypeError('other must be a Version instance');
-        }
-        if (this.major > other.major) {
-            return true;
-        }
-        if (this.major < other.major) {
-            return false;
-        }
-        if (this.minor > other.minor) {
-            return true;
-        }
-        if (this.minor < other.minor) {
-            return false;
-        }
-        if (this.build > other.build) {
-            return true;
-        }
-        if (this.build < other.build) {
-            return false;
-        }
-        if (this.qfe > other.qfe) {
-            return true;
-        }
-        if (this.qfe < other.qfe) {
-            return false;
-        }
-        return false;
-    }
-    gte(other) {
-        if (other.constructor !== Version) {
-            throw new TypeError('other must be a Version instance');
-        }
-        if (this.major > other.major) {
-            return true;
-        }
-        if (this.major < other.major) {
-            return false;
-        }
-        if (this.minor > other.minor) {
-            return true;
-        }
-        if (this.minor < other.minor) {
-            return false;
-        }
-        if (this.build > other.build) {
-            return true;
-        }
-        if (this.build < other.build) {
-            return false;
-        }
-        if (this.qfe > other.qfe) {
-            return true;
-        }
-        if (this.qfe < other.qfe) {
-            return false;
-        }
-        return true;
-    }
-    toString() {
-        return `${this.major}.${this.minor}.${this.build}.${this.qfe}`;
-    }
-    static compare(x, y) {
-        if (x.constructor !== Version || y.constructor !== Version) {
-            throw new TypeError('Only can compare Version objects');
-        }
-        return x.gt(y) ? 1 : x.eq(y) ? 0 : -1;
-    }
-    static fromString(str) {
-        const version = Version.tryParse(str);
-        if (!version) {
-            throw new TypeError('Cannot construct a version from "' + str + '".');
-        }
-        return version;
-    }
-    static tryParse(str) {
-        if (VERSION_EXPRESSION.test(str)) {
-            const versionArray = str.split('.').map(x => parseInt(x, 10));
-            return new Version(versionArray[0], versionArray[1], versionArray[2], versionArray[3]);
-        }
-        return null;
-    }
-}
-exports.default = Version;
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ * @format
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const VERSION_EXPRESSION = /^\d{1,8}(\.\d{1,8}){0,3}$/;
+class Version {
+    constructor(major, minor = 0, build = 0, qfe = 0) {
+        this.major = major;
+        this.minor = minor;
+        this.build = build;
+        this.qfe = qfe;
+    }
+    eq(other) {
+        if (other.constructor !== Version) {
+            throw new TypeError('other must be a Version instance');
+        }
+        return (this.major === other.major &&
+            this.minor === other.minor &&
+            this.build === other.build &&
+            this.qfe === other.qfe);
+    }
+    gt(other) {
+        if (other.constructor !== Version) {
+            throw new TypeError('other must be a Version instance');
+        }
+        if (this.major > other.major) {
+            return true;
+        }
+        if (this.major < other.major) {
+            return false;
+        }
+        if (this.minor > other.minor) {
+            return true;
+        }
+        if (this.minor < other.minor) {
+            return false;
+        }
+        if (this.build > other.build) {
+            return true;
+        }
+        if (this.build < other.build) {
+            return false;
+        }
+        if (this.qfe > other.qfe) {
+            return true;
+        }
+        if (this.qfe < other.qfe) {
+            return false;
+        }
+        return false;
+    }
+    gte(other) {
+        if (other.constructor !== Version) {
+            throw new TypeError('other must be a Version instance');
+        }
+        if (this.major > other.major) {
+            return true;
+        }
+        if (this.major < other.major) {
+            return false;
+        }
+        if (this.minor > other.minor) {
+            return true;
+        }
+        if (this.minor < other.minor) {
+            return false;
+        }
+        if (this.build > other.build) {
+            return true;
+        }
+        if (this.build < other.build) {
+            return false;
+        }
+        if (this.qfe > other.qfe) {
+            return true;
+        }
+        if (this.qfe < other.qfe) {
+            return false;
+        }
+        return true;
+    }
+    toString() {
+        return `${this.major}.${this.minor}.${this.build}.${this.qfe}`;
+    }
+    static compare(x, y) {
+        if (x.constructor !== Version || y.constructor !== Version) {
+            throw new TypeError('Only can compare Version objects');
+        }
+        return x.gt(y) ? 1 : x.eq(y) ? 0 : -1;
+    }
+    static fromString(str) {
+        const version = Version.tryParse(str);
+        if (!version) {
+            throw new TypeError('Cannot construct a version from "' + str + '".');
+        }
+        return version;
+    }
+    static tryParse(str) {
+        if (VERSION_EXPRESSION.test(str)) {
+            const versionArray = str.split('.').map(x => parseInt(x, 10));
+            return new Version(versionArray[0], versionArray[1], versionArray[2], versionArray[3]);
+        }
+        return null;
+    }
+}
+exports.default = Version;
 //# sourceMappingURL=version.js.map

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

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

@@ -1,34 +1,34 @@
-/**
- * Copyright (c) Microsoft Corporation.
- * Licensed under the MIT License.
- * @format
- */
-/**
- * A subset of the per-instance properties returned by vswhere
- */
-interface VisualStudioInstallation {
-    instanceId: string;
-    installationPath: string;
-    installationVersion: string;
-    prerelease: string;
-}
-/**
- * Enumerate the installed versions of Visual Studio
- */
-export declare function enumerateVsInstalls(opts: {
-    requires?: string[];
-    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[];
-    minVersion?: string;
-    verbose?: boolean;
-    prerelease?: boolean;
-}): VisualStudioInstallation | null;
-export {};
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ * @format
+ */
+/**
+ * A subset of the per-instance properties returned by vswhere
+ */
+interface VisualStudioInstallation {
+    instanceId: string;
+    installationPath: string;
+    installationVersion: string;
+    prerelease: string;
+}
+/**
+ * Enumerate the installed versions of Visual Studio
+ */
+export declare function enumerateVsInstalls(opts: {
+    requires?: string[];
+    minVersion?: 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[];
+    minVersion?: string;
+    verbose?: boolean;
+    prerelease?: boolean;
+}): VisualStudioInstallation | null;
+export {};