@react-native-windows/telemetry 0.67.1 → 0.68.0

package/lib-commonjs/utils/optionUtils.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ * @format
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.optionsToArgs = exports.argsContainsOption = exports.commanderOptionsToOptions = exports.yargsOptionsToOptions = exports.commanderNameToOptionName = void 0;
+const lodash_1 = require("lodash");
+/**
+ * Converts a raw Commander arg name ('--no-bad-dog') into an options property name ('badDog').
+ * @param name The raw Commander arg name.
+ * @returns The options name.
+ */
+function commanderNameToOptionName(name) {
+    if (name.startsWith('--')) {
+        name = name.slice('--'.length);
+    }
+    if (name.startsWith('no-')) {
+        name = name.slice('no-'.length);
+    }
+    if (name.endsWith(' [string]')) {
+        name = name.slice(0, name.length - ' [string]'.length);
+    }
+    if (name.endsWith(' [number]')) {
+        name = name.slice(0, name.length - ' [number]'.length);
+    }
+    return (0, lodash_1.camelCase)(name);
+}
+exports.commanderNameToOptionName = commanderNameToOptionName;
+/**
+ * Converts a yargs-parsed options object into an options object suitable for telemetry.
+ * @param options The options object as parsed by yargs.
+ * @param sanitizer Function to sanitize the option values for telemetry.
+ * @returns An options object suitable for telemetry.
+ */
+function yargsOptionsToOptions(options, sanitizer) {
+    const result = {};
+    for (const key of Object.keys(options)) {
+        if (!(key in Object.prototype) &&
+            key !== '$0' &&
+            key !== '_' &&
+            key.includes('-') !== (0, lodash_1.camelCase)(key) in options) {
+            result[key] = sanitizer ? sanitizer(key, options[key]) : options[key];
+        }
+    }
+    return result;
+}
+exports.yargsOptionsToOptions = yargsOptionsToOptions;
+/**
+ * Converts a Commander-parsed options object into an options object suitable for telemetry.
+ * @param options The options object as parsed by Commander.
+ * @param sanitizer Function to sanitize the option values for telemetry.
+ * @returns An options object suitable for telemetry.
+ */
+function commanderOptionsToOptions(options, sanitizer) {
+    const result = {};
+    for (const key of Object.keys(options)) {
+        if (!(key in Object.prototype)) {
+            result[key] = sanitizer ? sanitizer(key, options[key]) : options[key];
+        }
+    }
+    return result;
+}
+exports.commanderOptionsToOptions = commanderOptionsToOptions;
+/**
+ * Checks whether the given command-line args contains the given option key.
+ * @param key The option key to look for.
+ * @param argv The raw command-line args.
+ * @returns Whether the given command-line args contains the given option key.
+ */
+function argsContainsOption(key, argv) {
+    const kebabKey = (0, lodash_1.kebabCase)(key);
+    return (argv.includes(`--${key}`) ||
+        argv.includes(`--no-${key}`) ||
+        argv.includes(`--${kebabKey}`) ||
+        argv.includes(`--no-${kebabKey}`));
+}
+exports.argsContainsOption = argsContainsOption;
+/**
+ * Filters down a given set of options to only include those that were present in the command-line args.
+ * @param options The full set of options.
+ * @param argv The raw command-line args.
+ * @returns The filtered set of options.
+ */
+function optionsToArgs(options, argv) {
+    const result = {};
+    for (const key of Object.keys(options)) {
+        if (!(key in Object.prototype) && argsContainsOption(key, argv)) {
+            result[key] = options[key];
+        }
+    }
+    return result;
+}
+exports.optionsToArgs = optionsToArgs;
+//# sourceMappingURL=optionUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"optionUtils.js","sourceRoot":"","sources":["../../src/utils/optionUtils.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, kebabCase} from 'lodash';\n\nexport type OptionSanitizer = (key: string, value: any) => any;\n\nexport type YargsOptionsType = Record<string, any>;\n\nexport interface CommanderOptionsType extends Record<string, any> {\n  logging?: boolean;\n  telemetry?: boolean;\n}\n\n/**\n * Converts a raw Commander arg name ('--no-bad-dog') into an options property name ('badDog').\n * @param name The raw Commander arg name.\n * @returns The options name.\n */\nexport function commanderNameToOptionName(name: string): string {\n  if (name.startsWith('--')) {\n    name = name.slice('--'.length);\n  }\n  if (name.startsWith('no-')) {\n    name = name.slice('no-'.length);\n  }\n  if (name.endsWith(' [string]')) {\n    name = name.slice(0, name.length - ' [string]'.length);\n  }\n  if (name.endsWith(' [number]')) {\n    name = name.slice(0, name.length - ' [number]'.length);\n  }\n  return camelCase(name);\n}\n\n/**\n * Converts a yargs-parsed options object into an options object suitable for telemetry.\n * @param options The options object as parsed by yargs.\n * @param sanitizer Function to sanitize the option values for telemetry.\n * @returns An options object suitable for telemetry.\n */\nexport function yargsOptionsToOptions(\n  options: YargsOptionsType,\n  sanitizer?: OptionSanitizer,\n): Record<string, any> {\n  const result: Record<string, any> = {};\n  for (const key of Object.keys(options)) {\n    if (\n      !(key in Object.prototype) &&\n      key !== '$0' &&\n      key !== '_' &&\n      key.includes('-') !== camelCase(key) in options\n    ) {\n      result[key] = sanitizer ? sanitizer(key, options[key]) : options[key];\n    }\n  }\n  return result;\n}\n\n/**\n * Converts a Commander-parsed options object into an options object suitable for telemetry.\n * @param options The options object as parsed by Commander.\n * @param sanitizer Function to sanitize the option values for telemetry.\n * @returns An options object suitable for telemetry.\n */\nexport function commanderOptionsToOptions(\n  options: CommanderOptionsType,\n  sanitizer?: OptionSanitizer,\n): Record<string, any> {\n  const result: Record<string, any> = {};\n  for (const key of Object.keys(options)) {\n    if (!(key in Object.prototype)) {\n      result[key] = sanitizer ? sanitizer(key, options[key]) : options[key];\n    }\n  }\n  return result;\n}\n\n/**\n * Checks whether the given command-line args contains the given option key.\n * @param key The option key to look for.\n * @param argv The raw command-line args.\n * @returns Whether the given command-line args contains the given option key.\n */\nexport function argsContainsOption(key: string, argv: string[]): boolean {\n  const kebabKey = kebabCase(key);\n  return (\n    argv.includes(`--${key}`) ||\n    argv.includes(`--no-${key}`) ||\n    argv.includes(`--${kebabKey}`) ||\n    argv.includes(`--no-${kebabKey}`)\n  );\n}\n\n/**\n * Filters down a given set of options to only include those that were present in the command-line args.\n * @param options The full set of options.\n * @param argv The raw command-line args.\n * @returns The filtered set of options.\n */\nexport function optionsToArgs(\n  options: Record<string, any>,\n  argv: string[],\n): Record<string, any> {\n  const result: Record<string, any> = {};\n  for (const key of Object.keys(options)) {\n    if (!(key in Object.prototype) && argsContainsOption(key, argv)) {\n      result[key] = options[key];\n    }\n  }\n  return result;\n}\n"]}

package/lib-commonjs/utils/projectUtils.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ * @format
+ */
+interface ProjectInfo {
+    id: string | null;
+    platforms: Array<string>;
+    rnwLang: 'cpp' | 'cs' | 'cpp+cs' | null;
+}
+export interface DependencyProjectInfo extends ProjectInfo {
+}
+export interface AppProjectInfo extends ProjectInfo {
+    usesTS: boolean;
+    usesRNConfig: boolean;
+    jsEngine: string;
+    rnwSource: string;
+    dependencies: Array<DependencyProjectInfo>;
+}
+/**
+ * Gets a unique, telemetry-safe project ID based on the project name.
+ * @param projectName The project name.
+ * @returns The telemetry-safe project ID.
+ */
+export declare function getProjectId(projectName: string): string;
+/**
+ * Gets whether the project at the given path has a react-native.config.js file.
+ * @param projectRoot The project root path to look in.
+ * @returns Whether the project at the given path has a react-native.config.js file.
+ */
+export declare function usesReactNativeConfig(projectRoot: string): Promise<boolean>;
+/**
+ * Gets whether the project at the given path is using TypeScript.
+ * @param projectRoot The project root path to look in.
+ * @returns Whether the project at the given path is using TypeScript.
+ */
+export declare function usesTypeScript(projectRoot: string): Promise<boolean>;
+/**
+ * Calculate the project telemetry info from a react-native CLI config.
+ * @param config Config passed from react-native CLI.
+ * @returns The calculated project info.
+ */
+export declare function configToProjectInfo(config: Record<string, any>): Promise<AppProjectInfo | DependencyProjectInfo | null>;
+/**
+ * Gets the full path to the app's native project file from a react-native CLI config.
+ * @param config Config passed from react-native CLI.
+ * @returns The full path to the app's native project file
+ */
+export declare function getProjectFileFromConfig(config: Record<string, any>): string | null;
+export {};

package/lib-commonjs/utils/projectUtils.js

@@ -0,0 +1,187 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation.
+ * 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.getProjectFileFromConfig = exports.configToProjectInfo = exports.usesTypeScript = exports.usesReactNativeConfig = exports.getProjectId = void 0;
+const crypto_1 = require("crypto");
+const fs_1 = __importDefault(require("@react-native-windows/fs"));
+const path_1 = __importDefault(require("path"));
+/**
+ * Gets a unique, telemetry-safe project ID based on the project name.
+ * @param projectName The project name.
+ * @returns The telemetry-safe project ID.
+ */
+function getProjectId(projectName) {
+    const hash = (0, crypto_1.createHash)('sha256');
+    hash.update(projectName);
+    return hash.digest('hex');
+}
+exports.getProjectId = getProjectId;
+/**
+ * Checks that a given file exits in the path specified.
+ * @param fileName The file to check for.
+ * @param projectRoot The root path to look in.
+ * @returns Whether the file exists.
+ */
+async function fileExists(fileName, projectRoot) {
+    try {
+        const reactNativeConfigPath = path_1.default.resolve(projectRoot, fileName);
+        const stats = await fs_1.default.stat(reactNativeConfigPath);
+        return stats.isFile();
+    }
+    catch (_a) { }
+    return false;
+}
+/**
+ * Gets whether the project at the given path has a react-native.config.js file.
+ * @param projectRoot The project root path to look in.
+ * @returns Whether the project at the given path has a react-native.config.js file.
+ */
+async function usesReactNativeConfig(projectRoot) {
+    return fileExists('./react-native.config.js', projectRoot);
+}
+exports.usesReactNativeConfig = usesReactNativeConfig;
+/**
+ * Gets whether the project at the given path is using TypeScript.
+ * @param projectRoot The project root path to look in.
+ * @returns Whether the project at the given path is using TypeScript.
+ */
+async function usesTypeScript(projectRoot) {
+    return fileExists('./tsconfig.json', projectRoot);
+}
+exports.usesTypeScript = usesTypeScript;
+/**
+ * Get the list of keys in the object for which the value is defined.
+ * @param obj The object to search.
+ * @returns The list of keys.
+ */
+function getDefinedKeys(obj) {
+    return Object.keys(obj).filter((value) => obj[value] !== undefined && obj[value] !== null && value);
+}
+/**
+ * Given a react-native CLI config, determine the language of the RNW dependency if possible.
+ * @param config Dependency config passed from react-native CLI.
+ * @returns The language of the RNW dependency.
+ */
+function getDependencyRnwLang(config) {
+    if (config) {
+        let cppCount = 0;
+        let csCount = 0;
+        for (const project of config.projects) {
+            switch (project.projectLang) {
+                case 'cpp':
+                    cppCount++;
+                    break;
+                case 'cs':
+                    csCount++;
+                    break;
+            }
+        }
+        if (cppCount > 0 && csCount > 0) {
+            return 'cpp+cs';
+        }
+        else if (cppCount > 0) {
+            return 'cpp';
+        }
+        else if (csCount > 0) {
+            return 'cs';
+        }
+    }
+    return null;
+}
+/**
+ * Returns true if the item is a boolean with a value of true or a string with a value of 'true'.
+ * @param item The item to parse.
+ * @returns The boolean value.
+ */
+function parseBoolean(item) {
+    if (typeof item === 'boolean') {
+        return item;
+    }
+    else if (typeof item === 'string') {
+        return item.toLowerCase() === 'true';
+    }
+    return false;
+}
+/**
+ * Calculate the project telemetry info from a react-native CLI config.
+ * @param config Config passed from react-native CLI.
+ * @returns The calculated project info.
+ */
+async function configToProjectInfo(config) {
+    var _a, _b, _c;
+    try {
+        const id = getProjectId(require(path_1.default.join(config.root, 'package.json')).name);
+        const platforms = getDefinedKeys(config.project);
+        if ('windows' in config.project && config.project.windows !== null) {
+            const rnwLang = (_a = config.project.windows.project) === null || _a === void 0 ? void 0 : _a.projectLang;
+            const usesTS = await usesTypeScript(config.project.windows.folder);
+            const usesRNConfig = await usesReactNativeConfig(config.project.windows.folder);
+            const jsEngine = parseBoolean((_b = config.project.windows.experimentalFeatures) === null || _b === void 0 ? void 0 : _b.UseHermes)
+                ? 'Hermes'
+                : 'Chakra';
+            const rnwSource = parseBoolean((_c = config.project.windows.experimentalFeatures) === null || _c === void 0 ? void 0 : _c.UseExperimentalNuget)
+                ? 'NuGet'
+                : 'Source';
+            const dependencies = [];
+            for (const dependencyName in config.dependencies) {
+                if (!Object.prototype.hasOwnProperty(dependencyName)) {
+                    const dependencyId = getProjectId(dependencyName);
+                    const dependencyPlatforms = getDefinedKeys(config.dependencies[dependencyName].platforms);
+                    if (dependencyPlatforms.length > 0) {
+                        const dependencyRnwLang = getDependencyRnwLang(config.dependencies[dependencyName].platforms.windows);
+                        const dependencyInfo = {
+                            id: dependencyId,
+                            platforms: dependencyPlatforms,
+                            rnwLang: dependencyRnwLang,
+                        };
+                        dependencies.push(dependencyInfo);
+                    }
+                }
+            }
+            const appInfo = {
+                id,
+                platforms,
+                rnwLang,
+                usesTS,
+                usesRNConfig,
+                jsEngine,
+                rnwSource,
+                dependencies,
+            };
+            return appInfo;
+        }
+        // Probably just a dependency project, return minimal info
+        const dependencyInfo = {
+            id,
+            platforms,
+            rnwLang: null,
+        };
+        return dependencyInfo;
+    }
+    catch (_d) { }
+    return null;
+}
+exports.configToProjectInfo = configToProjectInfo;
+/**
+ * Gets the full path to the app's native project file from a react-native CLI config.
+ * @param config Config passed from react-native CLI.
+ * @returns The full path to the app's native project file
+ */
+function getProjectFileFromConfig(config) {
+    try {
+        if ('windows' in config.project && config.project.windows !== null) {
+            return path_1.default.join(config.project.windows.folder, config.project.windows.sourceDir, config.project.windows.project.projectFile);
+        }
+    }
+    catch (_a) { }
+    return null;
+}
+exports.getProjectFileFromConfig = getProjectFileFromConfig;
+//# sourceMappingURL=projectUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projectUtils.js","sourceRoot":"","sources":["../../src/utils/projectUtils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Copyright (c) Microsoft Corporation.\n * Licensed under the MIT License.\n * @format\n */\n\nimport {createHash} from 'crypto';\nimport fs from '@react-native-windows/fs';\nimport path from 'path';\n\ninterface ProjectInfo {\n  id: string | null;\n  platforms: Array<string>;\n  rnwLang: 'cpp' | 'cs' | 'cpp+cs' | null;\n}\n\nexport interface DependencyProjectInfo extends ProjectInfo {}\n\nexport interface AppProjectInfo extends ProjectInfo {\n  usesTS: boolean;\n  usesRNConfig: boolean;\n  jsEngine: string;\n  rnwSource: string;\n  dependencies: Array<DependencyProjectInfo>;\n}\n\n/**\n * Gets a unique, telemetry-safe project ID based on the project name.\n * @param projectName The project name.\n * @returns The telemetry-safe project ID.\n */\nexport function getProjectId(projectName: string): string {\n  const hash = createHash('sha256');\n  hash.update(projectName);\n  return hash.digest('hex');\n}\n\n/**\n * Checks that a given file exits in the path specified.\n * @param fileName The file to check for.\n * @param projectRoot The root path to look in.\n * @returns Whether the file exists.\n */\nasync function fileExists(\n  fileName: string,\n  projectRoot: string,\n): Promise<boolean> {\n  try {\n    const reactNativeConfigPath = path.resolve(projectRoot, fileName);\n    const stats = await fs.stat(reactNativeConfigPath);\n    return stats.isFile();\n  } catch {}\n  return false;\n}\n\n/**\n * Gets whether the project at the given path has a react-native.config.js file.\n * @param projectRoot The project root path to look in.\n * @returns Whether the project at the given path has a react-native.config.js file.\n */\nexport async function usesReactNativeConfig(\n  projectRoot: string,\n): Promise<boolean> {\n  return fileExists('./react-native.config.js', projectRoot);\n}\n\n/**\n * Gets whether the project at the given path is using TypeScript.\n * @param projectRoot The project root path to look in.\n * @returns Whether the project at the given path is using TypeScript.\n */\nexport async function usesTypeScript(projectRoot: string): Promise<boolean> {\n  return fileExists('./tsconfig.json', projectRoot);\n}\n\n/**\n * Get the list of keys in the object for which the value is defined.\n * @param obj The object to search.\n * @returns The list of keys.\n */\nfunction getDefinedKeys(obj: Record<string, any>): string[] {\n  return Object.keys(obj).filter(\n    (value) => obj[value] !== undefined && obj[value] !== null && value,\n  );\n}\n\n/**\n * Given a react-native CLI config, determine the language of the RNW dependency if possible.\n * @param config Dependency config passed from react-native CLI.\n * @returns The language of the RNW dependency.\n */\nfunction getDependencyRnwLang(\n  config: Record<string, any> | null | undefined,\n): 'cpp' | 'cs' | 'cpp+cs' | null {\n  if (config) {\n    let cppCount = 0;\n    let csCount = 0;\n    for (const project of config.projects) {\n      switch (project.projectLang) {\n        case 'cpp':\n          cppCount++;\n          break;\n        case 'cs':\n          csCount++;\n          break;\n      }\n    }\n    if (cppCount > 0 && csCount > 0) {\n      return 'cpp+cs';\n    } else if (cppCount > 0) {\n      return 'cpp';\n    } else if (csCount > 0) {\n      return 'cs';\n    }\n  }\n  return null;\n}\n\n/**\n * Returns true if the item is a boolean with a value of true or a string with a value of 'true'.\n * @param item The item to parse.\n * @returns The boolean value.\n */\nfunction parseBoolean(item: any): boolean {\n  if (typeof item === 'boolean') {\n    return item;\n  } else if (typeof item === 'string') {\n    return item.toLowerCase() === 'true';\n  }\n  return false;\n}\n\n/**\n * Calculate the project telemetry info from a react-native CLI config.\n * @param config Config passed from react-native CLI.\n * @returns The calculated project info.\n */\nexport async function configToProjectInfo(\n  config: Record<string, any>,\n): Promise<AppProjectInfo | DependencyProjectInfo | null> {\n  try {\n    const id: string = getProjectId(\n      require(path.join(config.root, 'package.json')).name,\n    );\n    const platforms = getDefinedKeys(config.project);\n\n    if ('windows' in config.project && config.project.windows !== null) {\n      const rnwLang = config.project.windows.project?.projectLang;\n      const usesTS = await usesTypeScript(config.project.windows.folder);\n      const usesRNConfig = await usesReactNativeConfig(\n        config.project.windows.folder,\n      );\n      const jsEngine = parseBoolean(\n        config.project.windows.experimentalFeatures?.UseHermes,\n      )\n        ? 'Hermes'\n        : 'Chakra';\n      const rnwSource = parseBoolean(\n        config.project.windows.experimentalFeatures?.UseExperimentalNuget,\n      )\n        ? 'NuGet'\n        : 'Source';\n\n      const dependencies: DependencyProjectInfo[] = [];\n      for (const dependencyName in config.dependencies) {\n        if (!Object.prototype.hasOwnProperty(dependencyName)) {\n          const dependencyId = getProjectId(dependencyName);\n          const dependencyPlatforms = getDefinedKeys(\n            config.dependencies[dependencyName].platforms,\n          );\n\n          if (dependencyPlatforms.length > 0) {\n            const dependencyRnwLang = getDependencyRnwLang(\n              config.dependencies[dependencyName].platforms.windows,\n            );\n            const dependencyInfo: DependencyProjectInfo = {\n              id: dependencyId,\n              platforms: dependencyPlatforms,\n              rnwLang: dependencyRnwLang,\n            };\n            dependencies.push(dependencyInfo);\n          }\n        }\n      }\n\n      const appInfo: AppProjectInfo = {\n        id,\n        platforms,\n        rnwLang,\n        usesTS,\n        usesRNConfig,\n        jsEngine,\n        rnwSource,\n        dependencies,\n      };\n\n      return appInfo;\n    }\n\n    // Probably just a dependency project, return minimal info\n    const dependencyInfo: DependencyProjectInfo = {\n      id,\n      platforms,\n      rnwLang: null,\n    };\n    return dependencyInfo;\n  } catch {}\n  return null;\n}\n\n/**\n * Gets the full path to the app's native project file from a react-native CLI config.\n * @param config Config passed from react-native CLI.\n * @returns The full path to the app's native project file\n */\nexport function getProjectFileFromConfig(\n  config: Record<string, any>,\n): string | null {\n  try {\n    if ('windows' in config.project && config.project.windows !== null) {\n      return path.join(\n        config.project.windows.folder,\n        config.project.windows.sourceDir,\n        config.project.windows.project.projectFile,\n      );\n    }\n  } catch {}\n  return null;\n}\n"]}

package/lib-commonjs/utils/sanitizeUtils.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ * @format
+ */
+/**
+ * Gets an anonymized version of the given path, suitable for Telemetry.
+ * @param filepath The path to anonymize.
+ * @param projectRoot Optional root path for the project. Defaults to process.cwd().
+ * @returns The anonymized path.
+ */
+export declare function getAnonymizedPath(filepath: string, projectRoot?: string): string;

package/lib-commonjs/utils/sanitizeUtils.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation.
+ * 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.getAnonymizedPath = void 0;
+const path_1 = __importDefault(require("path"));
+const telemetry_1 = require("../telemetry");
+const nodeModules = '\\node_modules\\';
+const windows = '\\windows\\';
+const knownEnvironmentVariablePaths = [
+    'AppData',
+    'LocalAppData',
+    'UserProfile',
+];
+/**
+ * Gets an anonymized version of the given path, suitable for Telemetry.
+ * @param filepath The path to anonymize.
+ * @param projectRoot Optional root path for the project. Defaults to process.cwd().
+ * @returns The anonymized path.
+ */
+function getAnonymizedPath(filepath, projectRoot) {
+    projectRoot = (projectRoot !== null && projectRoot !== void 0 ? projectRoot : process.cwd())
+        .replace(/\//g, '\\')
+        .toLowerCase();
+    projectRoot = projectRoot.endsWith('\\')
+        ? projectRoot.slice(0, -1)
+        : projectRoot;
+    filepath = filepath.replace(/\//g, '\\');
+    const ext = path_1.default.extname(filepath);
+    // Check if we're under node_modules
+    const nodeModulesIndex = filepath.toLowerCase().lastIndexOf(nodeModules);
+    if (nodeModulesIndex >= 0) {
+        // We are under node_modules
+        // Check if it's an npm package we're tracking
+        for (const trackedNpmPackage of telemetry_1.NpmPackagesWeTrack) {
+            const startIndex = filepath
+                .toLowerCase()
+                .lastIndexOf(nodeModules + trackedNpmPackage.replace(/\//g, '\\') + '\\');
+            if (startIndex >= 0) {
+                // We are under node_modules within an npm package we're tracking, anonymize by removing root
+                return ('[node_modules]\\' + filepath.slice(startIndex + nodeModules.length));
+            }
+        }
+        // It's an npm package we're not tracking, anonymize with [node_modules]
+        return `[node_modules]\\???${ext}(${filepath.slice(nodeModulesIndex).length - nodeModules.length})`;
+    }
+    // Check if we're under the projectRoot
+    if (filepath.toLowerCase().startsWith(projectRoot)) {
+        // We are under the projectRoot
+        const rest = filepath.slice(projectRoot.length);
+        if (rest.toLowerCase().startsWith(windows)) {
+            // We are under the windows path, anonymize with [windows]
+            return `[windows]\\???${ext}(${rest.length - windows.length - 1})`;
+        }
+        else {
+            // We are just within the projectRoot, anonymize with [project_dir]
+            if (rest === '' || rest === '\\') {
+                return '[project_dir]';
+            }
+            else {
+                return `[project_dir]\\???${ext}(${rest.length - (rest.startsWith('\\') ? 1 : 0)})`;
+            }
+        }
+    }
+    // Check if we're under a known environmental variable path
+    for (const knownPath of knownEnvironmentVariablePaths) {
+        if (process.env[knownPath] &&
+            filepath.toLowerCase().startsWith(process.env[knownPath].toLowerCase())) {
+            return `[${knownPath}]\\???(${filepath.length - process.env[knownPath].length})`;
+        }
+    }
+    // We are somewhere else, anonymize with [path]
+    return '[path]';
+}
+exports.getAnonymizedPath = getAnonymizedPath;
+//# sourceMappingURL=sanitizeUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizeUtils.js","sourceRoot":"","sources":["../../src/utils/sanitizeUtils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Copyright (c) Microsoft Corporation.\n * Licensed under the MIT License.\n * @format\n */\n\nimport path from 'path';\n\nimport {NpmPackagesWeTrack} from '../telemetry';\n\nconst nodeModules = '\\\\node_modules\\\\';\nconst windows = '\\\\windows\\\\';\n\nconst knownEnvironmentVariablePaths = [\n  'AppData',\n  'LocalAppData',\n  'UserProfile',\n];\n\n/**\n * Gets an anonymized version of the given path, suitable for Telemetry.\n * @param filepath The path to anonymize.\n * @param projectRoot Optional root path for the project. Defaults to process.cwd().\n * @returns The anonymized path.\n */\nexport function getAnonymizedPath(\n  filepath: string,\n  projectRoot?: string,\n): string {\n  projectRoot = (projectRoot ?? process.cwd())\n    .replace(/\\//g, '\\\\')\n    .toLowerCase();\n  projectRoot = projectRoot.endsWith('\\\\')\n    ? projectRoot.slice(0, -1)\n    : projectRoot;\n  filepath = filepath.replace(/\\//g, '\\\\');\n\n  const ext = path.extname(filepath);\n\n  // Check if we're under node_modules\n  const nodeModulesIndex = filepath.toLowerCase().lastIndexOf(nodeModules);\n  if (nodeModulesIndex >= 0) {\n    // We are under node_modules\n\n    // Check if it's an npm package we're tracking\n    for (const trackedNpmPackage of NpmPackagesWeTrack) {\n      const startIndex = filepath\n        .toLowerCase()\n        .lastIndexOf(\n          nodeModules + trackedNpmPackage.replace(/\\//g, '\\\\') + '\\\\',\n        );\n      if (startIndex >= 0) {\n        // We are under node_modules within an npm package we're tracking, anonymize by removing root\n        return (\n          '[node_modules]\\\\' + filepath.slice(startIndex + nodeModules.length)\n        );\n      }\n    }\n\n    // It's an npm package we're not tracking, anonymize with [node_modules]\n    return `[node_modules]\\\\???${ext}(${\n      filepath.slice(nodeModulesIndex).length - nodeModules.length\n    })`;\n  }\n\n  // Check if we're under the projectRoot\n  if (filepath.toLowerCase().startsWith(projectRoot)) {\n    // We are under the projectRoot\n    const rest = filepath.slice(projectRoot.length);\n    if (rest.toLowerCase().startsWith(windows)) {\n      // We are under the windows path, anonymize with [windows]\n      return `[windows]\\\\???${ext}(${rest.length - windows.length - 1})`;\n    } else {\n      // We are just within the projectRoot, anonymize with [project_dir]\n      if (rest === '' || rest === '\\\\') {\n        return '[project_dir]';\n      } else {\n        return `[project_dir]\\\\???${ext}(${\n          rest.length - (rest.startsWith('\\\\') ? 1 : 0)\n        })`;\n      }\n    }\n  }\n\n  // Check if we're under a known environmental variable path\n  for (const knownPath of knownEnvironmentVariablePaths) {\n    if (\n      process.env[knownPath] &&\n      filepath.toLowerCase().startsWith(process.env[knownPath]!.toLowerCase())\n    ) {\n      return `[${knownPath}]\\\\???(${\n        filepath.length - process.env[knownPath]!.length\n      })`;\n    }\n  }\n\n  // We are somewhere else, anonymize with [path]\n  return '[path]';\n}\n"]}

package/lib-commonjs/utils/versionUtils.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ * @format
+ */
+/**
+ * Gets the version of node being used.
+ * @returns The version of node being used.
+ */
+export declare function getNodeVersion(): Promise<string | null>;
+/**
+ * Gets the version of npm installed, if available.
+ * @returns The version of npm installed, if available.
+ */
+export declare function getNpmVersion(): Promise<string | null>;
+/**
+ * Gets the version of yarn installed, if available.
+ * @returns The version of yarn installed, if available.
+ */
+export declare function getYarnVersion(): Promise<string | null>;
+/**
+ * Gets the latest version of Visual Studio installed, if available.
+ * @returns The latest version of Visual Studio installed, if available.
+ */
+export declare function getVisualStudioVersion(): Promise<string | null>;
+/**
+ * Gets the version installed of the specified npm package.
+ * @param pkgName The npm package name.
+ * @returns The version installed, if available.
+ */
+export declare function getVersionOfNpmPackage(pkgName: string): Promise<string | null>;
+/**
+ * Gets the versions of the specified NuGet packages referenced in a project file.
+ * @param projectFile Path to the native project file.
+ * @param nugetPackages The NuGet package names to look for.
+ * @returns The mapping of NuGet package names and their versions.
+ */
+export declare function getVersionsOfNuGetPackages(projectFile: string, nugetPackages: string[]): Promise<Record<string, string>>;