@react-native-windows/telemetry 0.67.0 → 0.68.0-preview.1

package/lib-commonjs/index.d.ts

@@ -3,5 +3,8 @@
  * Licensed under the MIT License.
  * @format
  */
-export { Telemetry, isMSFTInternal, getDiskFreeSpace } from './telemetry';
-export { CodedError, CodedErrorType, CodedErrors } from './CodedError';
+export { Telemetry, TelemetryOptions, CommandStartInfo, CommandEndInfo, } from './telemetry';
+export { CodedError, CodedErrorType, CodedErrors } from './utils/errorUtils';
+export { yargsOptionsToOptions, commanderNameToOptionName, commanderOptionsToOptions, optionsToArgs, OptionSanitizer, YargsOptionsType, CommanderOptionsType, } from './utils/optionUtils';
+export { configToProjectInfo, getProjectFileFromConfig, AppProjectInfo, DependencyProjectInfo, } from './utils/projectUtils';
+export { getVersionOfNpmPackage } from './utils/versionUtils';

package/lib-commonjs/index.js

@@ -5,12 +5,20 @@
  * @format
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CodedErrors = exports.CodedError = exports.getDiskFreeSpace = exports.isMSFTInternal = exports.Telemetry = void 0;
+exports.getVersionOfNpmPackage = exports.getProjectFileFromConfig = exports.configToProjectInfo = exports.optionsToArgs = exports.commanderOptionsToOptions = exports.commanderNameToOptionName = exports.yargsOptionsToOptions = exports.CodedErrors = exports.CodedError = exports.Telemetry = void 0;
 var telemetry_1 = require("./telemetry");
 Object.defineProperty(exports, "Telemetry", { enumerable: true, get: function () { return telemetry_1.Telemetry; } });
-Object.defineProperty(exports, "isMSFTInternal", { enumerable: true, get: function () { return telemetry_1.isMSFTInternal; } });
-Object.defineProperty(exports, "getDiskFreeSpace", { enumerable: true, get: function () { return telemetry_1.getDiskFreeSpace; } });
-var CodedError_1 = require("./CodedError");
-Object.defineProperty(exports, "CodedError", { enumerable: true, get: function () { return CodedError_1.CodedError; } });
-Object.defineProperty(exports, "CodedErrors", { enumerable: true, get: function () { return CodedError_1.CodedErrors; } });
+var errorUtils_1 = require("./utils/errorUtils");
+Object.defineProperty(exports, "CodedError", { enumerable: true, get: function () { return errorUtils_1.CodedError; } });
+Object.defineProperty(exports, "CodedErrors", { enumerable: true, get: function () { return errorUtils_1.CodedErrors; } });
+var optionUtils_1 = require("./utils/optionUtils");
+Object.defineProperty(exports, "yargsOptionsToOptions", { enumerable: true, get: function () { return optionUtils_1.yargsOptionsToOptions; } });
+Object.defineProperty(exports, "commanderNameToOptionName", { enumerable: true, get: function () { return optionUtils_1.commanderNameToOptionName; } });
+Object.defineProperty(exports, "commanderOptionsToOptions", { enumerable: true, get: function () { return optionUtils_1.commanderOptionsToOptions; } });
+Object.defineProperty(exports, "optionsToArgs", { enumerable: true, get: function () { return optionUtils_1.optionsToArgs; } });
+var projectUtils_1 = require("./utils/projectUtils");
+Object.defineProperty(exports, "configToProjectInfo", { enumerable: true, get: function () { return projectUtils_1.configToProjectInfo; } });
+Object.defineProperty(exports, "getProjectFileFromConfig", { enumerable: true, get: function () { return projectUtils_1.getProjectFileFromConfig; } });
+var versionUtils_1 = require("./utils/versionUtils");
+Object.defineProperty(exports, "getVersionOfNpmPackage", { enumerable: true, get: function () { return versionUtils_1.getVersionOfNpmPackage; } });
 //# sourceMappingURL=index.js.map

package/lib-commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,yCAAwE;AAAhE,sGAAA,SAAS,OAAA;AAAE,2GAAA,cAAc,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AACnD,2CAAqE;AAA7D,wGAAA,UAAU,OAAA;AAAkB,yGAAA,WAAW,OAAA","sourcesContent":["/**\n * Copyright (c) Microsoft Corporation.\n * Licensed under the MIT License.\n * @format\n */\n\nexport {Telemetry, isMSFTInternal, getDiskFreeSpace} from './telemetry';\nexport {CodedError, CodedErrorType, CodedErrors} from './CodedError';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,yCAKqB;AAJnB,sGAAA,SAAS,OAAA;AAMX,iDAA2E;AAAnE,wGAAA,UAAU,OAAA;AAAkB,yGAAA,WAAW,OAAA;AAE/C,mDAQ6B;AAP3B,oHAAA,qBAAqB,OAAA;AACrB,wHAAA,yBAAyB,OAAA;AACzB,wHAAA,yBAAyB,OAAA;AACzB,4GAAA,aAAa,OAAA;AAMf,qDAK8B;AAJ5B,mHAAA,mBAAmB,OAAA;AACnB,wHAAA,wBAAwB,OAAA;AAK1B,qDAA4D;AAApD,sHAAA,sBAAsB,OAAA","sourcesContent":["/**\n * Copyright (c) Microsoft Corporation.\n * Licensed under the MIT License.\n * @format\n */\n\nexport {\n  Telemetry,\n  TelemetryOptions,\n  CommandStartInfo,\n  CommandEndInfo,\n} from './telemetry';\n\nexport {CodedError, CodedErrorType, CodedErrors} from './utils/errorUtils';\n\nexport {\n  yargsOptionsToOptions,\n  commanderNameToOptionName,\n  commanderOptionsToOptions,\n  optionsToArgs,\n  OptionSanitizer,\n  YargsOptionsType,\n  CommanderOptionsType,\n} from './utils/optionUtils';\n\nexport {\n  configToProjectInfo,\n  getProjectFileFromConfig,\n  AppProjectInfo,\n  DependencyProjectInfo,\n} from './utils/projectUtils';\n\nexport {getVersionOfNpmPackage} from './utils/versionUtils';\n"]}

package/lib-commonjs/telemetry.d.ts

@@ -4,26 +4,81 @@
  * @format
  */
 import * as appInsights from 'applicationinsights';
-export declare class Telemetry {
-    static client?: appInsights.TelemetryClient | undefined;
-    static disable(): void;
-    static setup(preserveMessages?: boolean): void;
-    static isCI(): boolean;
-    static trackException(e: Error, properties?: Record<string, any>): void;
-    static shouldDisable: boolean;
-    static preserveMessages: boolean;
+import * as errorUtils from './utils/errorUtils';
+import * as projectUtils from './utils/projectUtils';
+export interface TelemetryOptions {
+    setupString: string;
+    preserveErrorMessages: boolean;
+    populateNpmPackageVersions: boolean;
 }
+export interface CommandStartInfo {
+    commandName: string;
+    args: Record<string, any>;
+    options: Record<string, any>;
+    defaultOptions: Record<string, any>;
+}
+export interface CommandEndInfo {
+    resultCode: errorUtils.CodedErrorType;
+}
+interface CommandInfo {
+    startTime?: number;
+    endTime?: number;
+    startInfo?: CommandStartInfo;
+    endInfo?: CommandEndInfo;
+}
+export declare const CommandEventName = "RNWCLI.Command";
+export declare const CodedErrorEventName = "RNWCLI.CodedError";
+export declare const EventNamesWeTrack: string[];
+export declare const NpmPackagesWeTrack: string[];
+export declare const NuGetPackagesWeTrack: string[];
 /**
- * Sanitize any paths that appear between quotes (''), brackets ([]), or double quotes ("").
- * @param msg the string to sanitize
- */
-export declare function sanitizeMessage(msg: string): string;
-export declare function sanitizeFrame(frame: any): void;
-export declare function tryGetErrorCode(msg: string): string | undefined;
-/**
- * Remove PII from exceptions' stack traces and messages
- * @param envelope the telemetry envelope. Provided by AppInsights.
+ * The Telemetry class is responsible for reporting telemetry for RNW CLI.
  */
-export declare function sanitizeEnvelope(envelope: any): boolean;
-export declare function isMSFTInternal(): boolean;
-export declare function getDiskFreeSpace(drivePath: string | null): number;
+export declare class Telemetry {
+    protected static client?: appInsights.TelemetryClient;
+    protected static options: TelemetryOptions;
+    protected static isTest: boolean;
+    protected static commandInfo: CommandInfo;
+    protected static versionsProp: Record<string, string>;
+    protected static projectProp?: projectUtils.AppProjectInfo | projectUtils.DependencyProjectInfo;
+    protected static getDefaultSetupString(): string;
+    protected static reset(): void;
+    static isEnabled(): boolean;
+    static getSessionId(): string;
+    /** Sets up the Telemetry static to be used elsewhere. */
+    static setup(options?: Partial<TelemetryOptions>): Promise<void>;
+    /** Sets up Telemetry.client. */
+    private static setupClient;
+    /** Sets up any base properties that all telemetry events require. */
+    private static setupBaseProperties;
+    /** Sets up any telemetry processors. */
+    private static setupTelemetryProcessors;
+    /**
+     * Performs the processing necessary (mostly PII sanitization) for all events.
+     * @param envelope The ApplicationInsights event envelope.
+     * @param _contextObjects An optional context object.
+     * @returns Whether to kee
+     */
+    private static basicTelemetryProcessor;
+    /**
+     * Performs the processing necessary (mostly PII sanitization) for error events.
+     * @param envelope
+     * @param _contextObjects
+     * @returns
+     */
+    private static errorTelemetryProcessor;
+    /** Tries to update the version of the named package/tool by calling getValue(). */
+    static tryUpdateVersionsProp(name: string, getValue: () => Promise<string | null>, forceRefresh?: boolean): Promise<boolean>;
+    /** Populates the versions property of tools we care to track. */
+    static populateToolsVersions(refresh?: boolean): Promise<void>;
+    /** Populates the versions property of npm packages we care to track. */
+    static populateNpmPackageVersions(refresh?: boolean): Promise<void>;
+    /** Populates the versions property of nuget packages we care to track. */
+    static populateNuGetPackageVersions(projectFile: string, refresh?: boolean): Promise<void>;
+    static setProjectInfo(info: projectUtils.AppProjectInfo | projectUtils.DependencyProjectInfo): void;
+    static startCommand(info: CommandStartInfo): void;
+    static endCommand(info: CommandEndInfo, extraProps?: Record<string, any>): void;
+    private static trackCommandEvent;
+    static trackException(error: Error, extraProps?: Record<string, any>): void;
+}
+export {};

package/lib-commonjs/telemetry.js

@@ -23,202 +23,318 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __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 });
-exports.getDiskFreeSpace = exports.isMSFTInternal = exports.sanitizeEnvelope = exports.tryGetErrorCode = exports.sanitizeFrame = exports.sanitizeMessage = exports.Telemetry = void 0;
-const path_1 = __importDefault(require("path"));
-const crypto_1 = require("crypto");
+exports.Telemetry = exports.NuGetPackagesWeTrack = exports.NpmPackagesWeTrack = exports.EventNamesWeTrack = exports.CodedErrorEventName = exports.CommandEventName = void 0;
 const appInsights = __importStar(require("applicationinsights"));
-const child_process_1 = require("child_process");
-const CodedError_1 = require("./CodedError");
+const basePropUtils = __importStar(require("./utils/basePropUtils"));
+const versionUtils = __importStar(require("./utils/versionUtils"));
+const errorUtils = __importStar(require("./utils/errorUtils"));
+// This is our key with the AI backend
+const RNWSetupString = '795006ca-cf54-40ee-8bc6-03deb91401c3';
+// Environment variable to override the default setup string
+const ENV_SETUP_OVERRIDE = 'RNW_TELEMETRY_SETUP';
+// Environment variable to override the http proxy (such as http://localhost:8888 for Fiddler debugging)
+const ENV_PROXY_OVERRIDE = 'RNW_TELEMETRY_PROXY';
+exports.CommandEventName = 'RNWCLI.Command';
+exports.CodedErrorEventName = 'RNWCLI.CodedError';
+// These are the event names we're tracking
+exports.EventNamesWeTrack = [
+    exports.CommandEventName,
+    exports.CodedErrorEventName,
+];
+// These are NPM packages we care about, in terms of capturing versions used
+// and getting more details about when reporting errors
+exports.NpmPackagesWeTrack = [
+    '@react-native-community/cli',
+    '@react-native-windows/cli',
+    '@react-native-windows/telemetry',
+    'react',
+    'react-native',
+    'react-native-windows',
+    'react-native-windows-init',
+];
+// These are NPM packages we care about, in terms of capturing versions used
+exports.NuGetPackagesWeTrack = [
+    'Microsoft.UI.Xaml',
+    'Microsoft.Windows.CppWinRT',
+    'Microsoft.WinUI',
+];
+/**
+ * The Telemetry class is responsible for reporting telemetry for RNW CLI.
+ */
 class Telemetry {
-    static disable() {
+    static getDefaultSetupString() {
+        var _a;
+        // Enable overriding the default setup string via an environment variable
+        return (_a = process.env[ENV_SETUP_OVERRIDE]) !== null && _a !== void 0 ? _a : RNWSetupString;
+    }
+    static reset() {
+        // Reset client
         if (Telemetry.client) {
-            Telemetry.client.config.disableAppInsights = true;
+            Telemetry.client.flush();
+            Telemetry.client = undefined;
         }
-        Telemetry.shouldDisable = true;
+        // Reset local members
+        Telemetry.options = {
+            setupString: Telemetry.getDefaultSetupString(),
+            preserveErrorMessages: false,
+            populateNpmPackageVersions: true,
+        };
+        Telemetry.commandInfo = {};
+        Telemetry.versionsProp = {};
+        Telemetry.projectProp = undefined;
     }
-    static setup(preserveMessages) {
-        if (Telemetry.isCI()) {
-            this.disable();
-            return;
-        }
+    static isEnabled() {
+        return Telemetry.client !== undefined;
+    }
+    static getSessionId() {
+        return basePropUtils.getSessionId();
+    }
+    /** Sets up the Telemetry static to be used elsewhere. */
+    static async setup(options) {
         if (Telemetry.client) {
+            // Bail since we've already setup
             return;
         }
-        if (!process.env.RNW_CLI_TEST) {
-            appInsights.Configuration.setInternalLogging(false, false);
+        // Bail if we're in CI and not capturing CI
+        if (!this.isTest && basePropUtils.isCI() && !basePropUtils.captureCI()) {
+            return;
         }
-        appInsights.setup('795006ca-cf54-40ee-8bc6-03deb91401c3');
-        Telemetry.client = appInsights.defaultClient;
-        if (Telemetry.shouldDisable) {
-            Telemetry.disable();
+        // Save off options for later
+        Object.assign(Telemetry.options, options);
+        Telemetry.setupClient();
+        await Telemetry.setupBaseProperties();
+        Telemetry.setupTelemetryProcessors();
+    }
+    /** Sets up Telemetry.client. */
+    static setupClient() {
+        appInsights.Configuration.setInternalLogging(Telemetry.isTest, Telemetry.isTest);
+        Telemetry.client = new appInsights.TelemetryClient(Telemetry.options.setupString);
+        // Allow overriding the proxy server via an environment variable
+        const proxyServer = process.env[ENV_PROXY_OVERRIDE];
+        if (proxyServer) {
+            Telemetry.client.config.proxyHttpUrl = proxyServer;
+            Telemetry.client.config.proxyHttpsUrl = proxyServer;
         }
-        Telemetry.preserveMessages = preserveMessages ? true : false;
-        if (process.env.RNW_CLI_TEST) {
-            Telemetry.client.commonProperties.isTest = process.env.RNW_CLI_TEST;
+        Telemetry.client.config.disableAppInsights = Telemetry.isTest;
+        Telemetry.client.channel.setUseDiskRetryCaching(!Telemetry.isTest);
+    }
+    /** Sets up any base properties that all telemetry events require. */
+    static async setupBaseProperties() {
+        Telemetry.client.commonProperties.deviceId =
+            await basePropUtils.deviceId();
+        Telemetry.client.commonProperties.deviceLocale =
+            await basePropUtils.deviceLocale();
+        Telemetry.client.commonProperties.deviceNumCPUs = basePropUtils
+            .deviceNumCPUs()
+            .toString();
+        Telemetry.client.commonProperties.deviceTotalMemory = basePropUtils
+            .deviceTotalMemory()
+            .toString();
+        Telemetry.client.commonProperties.deviceDiskFreeSpace = basePropUtils
+            .deviceDiskFreeSpace()
+            .toString();
+        Telemetry.client.commonProperties.ciCaptured = basePropUtils
+            .captureCI()
+            .toString();
+        Telemetry.client.commonProperties.ciType = basePropUtils.ciType();
+        Telemetry.client.commonProperties.isMsftInternal = basePropUtils
+            .isMsftInternal()
+            .toString();
+        Telemetry.client.config.samplingPercentage = basePropUtils.sampleRate();
+        if (Telemetry.isTest) {
+            Telemetry.client.commonProperties.isTest = true.toString();
         }
-        if (!Telemetry.client.commonProperties.sessionId) {
-            Telemetry.client.commonProperties.sessionId = (0, crypto_1.randomBytes)(16).toString('hex');
-            Telemetry.client.addTelemetryProcessor(sanitizeEnvelope);
+        Telemetry.client.commonProperties.sessionId = Telemetry.getSessionId();
+        await Telemetry.populateToolsVersions();
+        if (Telemetry.options.populateNpmPackageVersions) {
+            await Telemetry.populateNpmPackageVersions();
         }
     }
-    static isCI() {
-        return (process.env.AGENT_NAME !== undefined || // Azure DevOps
-            process.env.CIRCLECI === 'true' || // CircleCI
-            process.env.TRAVIS === 'true' || // Travis
-            process.env.CI === 'true' // other CIs
-        );
+    /** Sets up any telemetry processors. */
+    static setupTelemetryProcessors() {
+        Telemetry.client.addTelemetryProcessor(Telemetry.basicTelemetryProcessor);
+        Telemetry.client.addTelemetryProcessor(Telemetry.errorTelemetryProcessor);
     }
-    static trackException(e, properties) {
+    /**
+     * Performs the processing necessary (mostly PII sanitization) for all events.
+     * @param envelope The ApplicationInsights event envelope.
+     * @param _contextObjects An optional context object.
+     * @returns Whether to kee
+     */
+    static basicTelemetryProcessor(envelope, _contextObjects) {
         var _a;
-        const props = {};
-        if (e instanceof CodedError_1.CodedError) {
-            Object.assign(props, e.data);
+        delete envelope.tags['ai.cloud.roleInstance'];
+        // Filter out "legacy" events from older stable branches
+        const properties = (_a = envelope.data.baseData) === null || _a === void 0 ? void 0 : _a.properties;
+        if ((properties === null || properties === void 0 ? void 0 : properties.eventName) &&
+            exports.EventNamesWeTrack.includes(properties.eventName)) {
+            return true;
         }
-        const syscallExceptionFieldsToCopy = ['errno', 'syscall', 'code'];
-        for (const f of syscallExceptionFieldsToCopy) {
-            if (e[f]) {
-                props[f] = [f];
+        return false;
+    }
+    /**
+     * Performs the processing necessary (mostly PII sanitization) for error events.
+     * @param envelope
+     * @param _contextObjects
+     * @returns
+     */
+    static errorTelemetryProcessor(envelope, _contextObjects) {
+        if (envelope.data.baseType === 'ExceptionData') {
+            const data = envelope.data.baseData;
+            if (data === null || data === void 0 ? void 0 : data.exceptions) {
+                for (const exception of data.exceptions) {
+                    for (const frame of exception.parsedStack) {
+                        errorUtils.sanitizeErrorStackFrame(frame);
+                    }
+                    // CodedError has non-PII information in its 'type' member, plus optionally some more info in its 'data'.
+                    // The message may contain PII information. This can be sanitized, but for now delete it.
+                    // Note that the type of data.exceptions[0] is always going to be ExceptionDetails. It is not the original thrown exception.
+                    // https://github.com/microsoft/ApplicationInsights-node.js/issues/707
+                    if (Telemetry.options.preserveErrorMessages) {
+                        exception.message = errorUtils.sanitizeErrorMessage(exception.message);
+                    }
+                    else {
+                        delete exception.message;
+                    }
+                }
             }
         }
-        Object.assign(props, props, properties);
-        (_a = Telemetry.client) === null || _a === void 0 ? void 0 : _a.trackException({
-            exception: e,
-            properties: props,
-        });
+        return true;
     }
-}
-exports.Telemetry = Telemetry;
-Telemetry.client = undefined;
-Telemetry.shouldDisable = false;
-Telemetry.preserveMessages = false;
-function getAnonymizedPath(filepath) {
-    const projectRoot = process.cwd().toLowerCase();
-    filepath = filepath.replace(/\//g, '\\');
-    const knownPathsVars = ['AppData', 'LocalAppData', 'UserProfile'];
-    if (filepath.toLowerCase().startsWith(projectRoot)) {
-        const ext = path_1.default.extname(filepath);
-        const rest = filepath.slice(projectRoot.length);
-        const nodeModules = '\\node_modules\\';
-        // this is in the project dir but not under node_modules
-        if (rest.toLowerCase().startsWith('\\windows\\')) {
-            return `[windows]\\???${ext}(${filepath.length})`;
-        }
-        else if (rest.toLowerCase().startsWith(nodeModules)) {
-            return 'node_modules' + rest.slice(nodeModules.length - 1);
-        }
-        else {
-            return `[project_dir]\\???${ext}(${filepath.length})`;
-        }
-    }
-    else {
-        for (const knownPath of knownPathsVars) {
-            if (process.env[knownPath] &&
-                filepath.toLowerCase().startsWith(process.env[knownPath].toLowerCase())) {
-                return `[${knownPath}]\\???(${filepath.length})`;
+    /** Tries to update the version of the named package/tool by calling getValue(). */
+    static async tryUpdateVersionsProp(name, getValue, forceRefresh) {
+        if (!Telemetry.client) {
+            return true;
+        }
+        if (forceRefresh === true || !Telemetry.versionsProp[name]) {
+            const value = await getValue();
+            if (value) {
+                Telemetry.versionsProp[name] = value;
+                return true;
             }
         }
+        return false;
     }
-    return '[path]';
-}
-/**
- * Sanitize any paths that appear between quotes (''), brackets ([]), or double quotes ("").
- * @param msg the string to sanitize
- */
-function sanitizeMessage(msg) {
-    const cpuThreadId = /^\d+(:\d+)?>/g;
-    msg = msg.replace(cpuThreadId, '');
-    const parts = msg.split(/['[\]"]/g);
-    const clean = [];
-    const pathRegEx = /([A-Za-z]:|\\)[\\/]([^<>:;,?"*\t\r\n|/\\]+[\\/])+([^<>:;,?"*\t\r\n|]+\/?)/gi;
-    for (const part of parts) {
-        if (pathRegEx.test(part)) {
-            pathRegEx.lastIndex = -1;
-            let matches;
-            let noPath = '';
-            let last = 0;
-            while ((matches = pathRegEx.exec(part))) {
-                noPath +=
-                    part.substr(last, matches.index - last) +
-                        getAnonymizedPath(matches[0]);
-                last = matches.index + matches[0].length;
-            }
-            clean.push(noPath);
+    /** Populates the versions property of tools we care to track. */
+    static async populateToolsVersions(refresh) {
+        await Telemetry.tryUpdateVersionsProp('node', versionUtils.getNodeVersion, refresh);
+        await Telemetry.tryUpdateVersionsProp('npm', versionUtils.getNpmVersion, refresh);
+        await Telemetry.tryUpdateVersionsProp('yarn', versionUtils.getYarnVersion, refresh);
+        await Telemetry.tryUpdateVersionsProp('VisualStudio', versionUtils.getVisualStudioVersion, refresh);
+    }
+    /** Populates the versions property of npm packages we care to track. */
+    static async populateNpmPackageVersions(refresh) {
+        for (const npmPackage of exports.NpmPackagesWeTrack) {
+            await Telemetry.tryUpdateVersionsProp(npmPackage, async () => await versionUtils.getVersionOfNpmPackage(npmPackage), refresh);
         }
-        else if (part !== '') {
-            clean.push(part);
+    }
+    /** Populates the versions property of nuget packages we care to track. */
+    static async populateNuGetPackageVersions(projectFile, refresh) {
+        const nugetVersions = await versionUtils.getVersionsOfNuGetPackages(projectFile, exports.NuGetPackagesWeTrack);
+        for (const nugetPackage of exports.NuGetPackagesWeTrack) {
+            await Telemetry.tryUpdateVersionsProp(nugetPackage, async () => nugetVersions[nugetPackage], refresh);
         }
     }
-    return clean.join(' ').trim();
-}
-exports.sanitizeMessage = sanitizeMessage;
-function sanitizeFrame(frame) {
-    const parens = frame.method.indexOf('(');
-    if (parens !== -1) {
-        // case 1: method === 'methodName (rootOfThePath'
-        frame.method = frame.method.substr(0, parens).trim();
-    }
-    else {
-        // case 2: method === <no_method> or something without '(', fileName is full path
-    }
-    // preserve only the last_directory/filename
-    frame.fileName = path_1.default.join(path_1.default.basename(path_1.default.dirname(frame.fileName)), path_1.default.basename(frame.fileName));
-    frame.assembly = '';
-}
-exports.sanitizeFrame = sanitizeFrame;
-function tryGetErrorCode(msg) {
-    const errorRegEx = /error (\w+\d+):/gi;
-    const m = errorRegEx.exec(msg);
-    return m ? m[1] : undefined;
-}
-exports.tryGetErrorCode = tryGetErrorCode;
-/**
- * Remove PII from exceptions' stack traces and messages
- * @param envelope the telemetry envelope. Provided by AppInsights.
- */
-function sanitizeEnvelope(envelope /*context: any*/) {
-    if (envelope.data.baseType === 'ExceptionData') {
-        const data = envelope.data.baseData;
-        for (const exception of data.exceptions || []) {
-            for (const frame of exception.parsedStack) {
-                sanitizeFrame(frame);
-            }
-            const errorCode = tryGetErrorCode(exception.message);
-            data.properties.errorCode = errorCode;
-            // CodedError has non-PII information in its 'type' member, plus optionally some more info in its 'data'.
-            // The message may contain PII information. This can be sanitized, but for now delete it.
-            // Note that the type of data.exceptions[0] is always going to be ExceptionDetails. It is not the original thrown exception.
-            // https://github.com/microsoft/ApplicationInsights-node.js/issues/707
-            if (Telemetry.preserveMessages) {
-                exception.message = sanitizeMessage(exception.message);
-            }
-            else {
-                delete exception.message;
+    static setProjectInfo(info) {
+        if (!Telemetry.client) {
+            return;
+        }
+        Telemetry.projectProp = info;
+    }
+    static startCommand(info) {
+        if (!Telemetry.client) {
+            return;
+        }
+        if (Telemetry.commandInfo.startInfo) {
+            return;
+        }
+        Telemetry.commandInfo.startTime = Date.now();
+        Telemetry.commandInfo.startInfo = info;
+        // Set common command props
+        Telemetry.client.commonProperties.commandName = info.commandName;
+    }
+    static endCommand(info, extraProps) {
+        if (!Telemetry.client) {
+            return;
+        }
+        if (!Telemetry.commandInfo.startInfo) {
+            return;
+        }
+        Telemetry.commandInfo.endTime = Date.now();
+        Telemetry.commandInfo.endInfo = info;
+        Telemetry.trackCommandEvent(extraProps);
+    }
+    static trackCommandEvent(extraProps) {
+        var _a, _b, _c, _d;
+        const props = {
+            eventName: exports.CommandEventName,
+        };
+        // Set command props
+        props.command = {
+            options: (_a = Telemetry.commandInfo.startInfo) === null || _a === void 0 ? void 0 : _a.options,
+            defaultOptions: (_b = Telemetry.commandInfo.startInfo) === null || _b === void 0 ? void 0 : _b.defaultOptions,
+            args: (_c = Telemetry.commandInfo.startInfo) === null || _c === void 0 ? void 0 : _c.args,
+            durationInSecs: (Telemetry.commandInfo.endTime - Telemetry.commandInfo.startTime) /
+                1000,
+            resultCode: (_d = Telemetry.commandInfo.endInfo) === null || _d === void 0 ? void 0 : _d.resultCode,
+        };
+        // Set remaining common props
+        Object.assign(props, extraProps);
+        props.project = Telemetry.projectProp;
+        props.versions = Telemetry.versionsProp;
+        // Fire event
+        Telemetry.client.trackEvent({ name: props.eventName, properties: props });
+        Telemetry.client.flush();
+    }
+    static trackException(error, extraProps) {
+        var _a, _b, _c;
+        if (!Telemetry.client) {
+            return;
+        }
+        const props = {
+            eventName: exports.CodedErrorEventName,
+        };
+        // Save off CodedError info
+        const codedError = error instanceof errorUtils.CodedError
+            ? error
+            : null;
+        props.codedError = {
+            type: (_a = codedError === null || codedError === void 0 ? void 0 : codedError.type) !== null && _a !== void 0 ? _a : 'Unknown',
+            rawErrorCode: (_b = errorUtils.tryGetErrorCode(error.message)) !== null && _b !== void 0 ? _b : '',
+            data: (_c = codedError === null || codedError === void 0 ? void 0 : codedError.data) !== null && _c !== void 0 ? _c : {},
+        };
+        if (codedError === null || codedError === void 0 ? void 0 : codedError.data) {
+            Object.assign(props.codedError.data, codedError.data);
+        }
+        // Copy miscellaneous system error fields into the codedError.data object
+        const syscallExceptionFieldsToCopy = ['errno', 'syscall', 'code'];
+        for (const f of syscallExceptionFieldsToCopy) {
+            if (error[f]) {
+                props.codedError.data[f] = error[f];
             }
         }
+        // Set remaining common props
+        Object.assign(props, extraProps);
+        props.project = Telemetry.projectProp;
+        props.versions = Telemetry.versionsProp;
+        // Fire event
+        Telemetry.client.trackException({
+            exception: error,
+            properties: props,
+        });
+        Telemetry.client.flush();
     }
-    delete envelope.tags['ai.cloud.roleInstance'];
-    return true;
-}
-exports.sanitizeEnvelope = sanitizeEnvelope;
-function isMSFTInternal() {
-    return (process.env.UserDNSDomain !== undefined &&
-        process.env.UserDNSDomain.toLowerCase().endsWith('.microsoft.com'));
-}
-exports.isMSFTInternal = isMSFTInternal;
-function getDiskFreeSpace(drivePath) {
-    const out = (0, child_process_1.execSync)(`dir /-C ${drivePath}`)
-        .toString()
-        .split('\r\n');
-    const line = out[out.length - 2];
-    const result = line.match(/(\d+) [^\d]+(\d+) /);
-    if (result && result.length > 2) {
-        return Number(result[2]);
-    }
-    return -1;
 }
-exports.getDiskFreeSpace = getDiskFreeSpace;
+exports.Telemetry = Telemetry;
+Telemetry.client = undefined;
+Telemetry.options = {
+    setupString: Telemetry.getDefaultSetupString(),
+    preserveErrorMessages: false,
+    populateNpmPackageVersions: true,
+};
+Telemetry.isTest = basePropUtils.isCliTest();
+Telemetry.commandInfo = {};
+Telemetry.versionsProp = {};
+Telemetry.projectProp = undefined;
 //# sourceMappingURL=telemetry.js.map