@salesforce/telemetry 2.0.2 → 3.0.1

package/CHANGELOG.md

@@ -1,7 +1,55 @@
-# Change Log
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+### [3.0.1](https://github.com/forcedotcom/telemetry/compare/v3.0.0...v3.0.1) (2021-11-17)
+
+
+### Bug Fixes
+
+* release 3.0.1 ([050953a](https://github.com/forcedotcom/telemetry/commit/050953a117a4f3c6c5a2100d2a47e80719e64976))
+* replace homedir ([2bcb2ed](https://github.com/forcedotcom/telemetry/commit/2bcb2ede66dc7ef3c14cb40d530fb34530b84147))
+* sanitizing exception strings ([b12c52c](https://github.com/forcedotcom/telemetry/commit/b12c52cad97b736bcb0e5968c8427ae89f0d8397))
+* sinon types match sinon ([4cbefbf](https://github.com/forcedotcom/telemetry/commit/4cbefbf4ded50b4fdd1f451e27aba449c886b481))
+
+## 3.0.0 (2021-07-08)
+
+
+### Features
+
+* publish ([9336302](https://github.com/forcedotcom/telemetry/commit/9336302f15b43bd824ec70fe604e05a6bb2f5ba2))
+
+## [2.0.6](https://github.com/forcedotcom/cli-packages/compare/@salesforce/telemetry@2.0.5...@salesforce/telemetry@2.0.6) (2021-05-11)
+
+**Note:** Version bump only for package @salesforce/telemetry
+
+
+
+
+
+## [2.0.5](https://github.com/forcedotcom/cli-packages/compare/@salesforce/telemetry@2.0.4...@salesforce/telemetry@2.0.5) (2021-01-22)
+
+**Note:** Version bump only for package @salesforce/telemetry
+
+
+
+
+
+## [2.0.4](https://github.com/forcedotcom/cli-packages/compare/@salesforce/telemetry@2.0.3...@salesforce/telemetry@2.0.4) (2020-11-13)
+
+**Note:** Version bump only for package @salesforce/telemetry
+
+
+
+
+
+## [2.0.3](https://github.com/forcedotcom/cli-packages/compare/@salesforce/telemetry@2.0.2...@salesforce/telemetry@2.0.3) (2020-11-11)
+
+**Note:** Version bump only for package @salesforce/telemetry
+
+
+
 
-All notable changes to this project will be documented in this file.
-See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
 ## [2.0.2](https://github.com/forcedotcom/cli-packages/compare/@salesforce/telemetry@2.0.1...@salesforce/telemetry@2.0.2) (2020-03-02)
 

package/lib/appInsights.d.ts

@@ -22,6 +22,12 @@ export interface TelemetryOptions {
     sessionId?: string;
     waitForConnection?: boolean;
 }
+export declare function getPlatformVersion(): string;
+export declare function getCpus(): string;
+export declare function buildPropertiesAndMeasurements(attributes: Attributes): {
+    properties: Properties;
+    measurements: Measurements;
+};
 /**
  * This is a wrapper around appinsights sdk for convenience.
  *
@@ -41,24 +47,28 @@ export declare class AppInsights extends AsyncCreatable<TelemetryOptions> {
     init(): Promise<void>;
     /**
      * Publishes event to app insights dashboard
+     *
      * @param eventName {string} - name of the event you want published. Will be concatenated with this.options.project
      * @param attributes {Attributes} - map of properties to publish alongside the event.
      */
     sendTelemetryEvent(eventName: string, attributes?: Attributes): void;
     /**
      * Publishes exception to app insights dashboard
+     *
      * @param exception {Error} - exception you want published.
      * @param attributes {Attributes} - map of measurements to publish alongside the exception.
      */
     sendTelemetryException(exception: Error, attributes?: Attributes): void;
     /**
      * Publishes diagnostic information to app insights dashboard
+     *
      * @param message {string} - trace message to sen to app insights.
      * @param properties {Properties} - map of properties to publish alongside the event.
      */
     sendTelemetryTrace(traceMessage: string, properties?: Properties): void;
     /**
      * Publishes metric to app insights dashboard
+     *
      * @param name {string} - name of the metric you want published
      * @param value {number} - value of the metric
      * @param properties {Properties} - map of properties to publish alongside the event.
@@ -72,19 +82,15 @@ export declare class AppInsights extends AsyncCreatable<TelemetryOptions> {
     private createAppInsightsClient;
     /**
      * Builds the properties to send with every event
-     * @return {Properties} map of base properites and properties provided when class was created
+     *
+     * @return {Properties} map of base properties and properties provided when class was created
      */
     private buildCommonProperties;
     /**
      * Builds the context tags for appInsightsClient
+     *
      * @return {Properties} map of tags to add to this.appInsightsClient.context.tags
      */
     private buildContextTags;
     private hideGDPRdata;
 }
-export declare function buildPropertiesAndMeasurements(attributes: Attributes): {
-    properties: Properties;
-    measurements: Measurements;
-};
-export declare function getPlatformVersion(): string;
-export declare function getCpus(): string;

package/lib/appInsights.js

@@ -1,13 +1,72 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppInsights = exports.buildPropertiesAndMeasurements = exports.getCpus = exports.getPlatformVersion = void 0;
+/*
+ * Copyright (c) 2021, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+const os = require("os");
 const core_1 = require("@salesforce/core");
 const kit_1 = require("@salesforce/kit");
 const ts_types_1 = require("@salesforce/ts-types");
 const appInsights = require("applicationinsights");
-const os = require("os");
 var applicationinsights_1 = require("applicationinsights");
-exports.TelemetryClient = applicationinsights_1.TelemetryClient;
+Object.defineProperty(exports, "TelemetryClient", { enumerable: true, get: function () { return applicationinsights_1.TelemetryClient; } });
 core_1.Messages.importMessagesDirectory(__dirname);
+function getPlatformVersion() {
+    return (os.release() || '').replace(/^(\d+)(\.\d+)?(\.\d+)?(.*)/, '$1$2$3');
+}
+exports.getPlatformVersion = getPlatformVersion;
+function getCpus() {
+    const cpus = os.cpus();
+    if (cpus && cpus.length > 0) {
+        return `${cpus[0].model}(${cpus.length} x ${cpus[0].speed})`;
+    }
+    else {
+        return '';
+    }
+}
+exports.getCpus = getCpus;
+const homeDir = os.homedir();
+const sanitizeError = (err) => {
+    if (err.name) {
+        err.name = err.name.replace(homeDir, '~');
+    }
+    if (err.message) {
+        err.message = err.message.replace(homeDir, '~');
+    }
+    if (err.stack) {
+        // there might be lots of this one
+        err.stack = err.stack.replace(new RegExp(`\\b${homeDir}\\b`, 'gi'), '~');
+    }
+    return err;
+};
+function getSystemMemory() {
+    return `${(os.totalmem() / (1024 * 1024 * 1024)).toFixed(2)} GB`;
+}
+function isAsimovKey(key) {
+    return !!(key && key.startsWith('AIF-'));
+}
+function buildPropertiesAndMeasurements(attributes) {
+    const properties = {};
+    const measurements = {};
+    Object.keys(attributes).forEach((key) => {
+        const value = attributes[key];
+        if (ts_types_1.isString(value)) {
+            properties[key] = value.replace(homeDir, '~');
+        }
+        else if (ts_types_1.isNumber(value)) {
+            measurements[key] = value;
+        }
+        else if (ts_types_1.isBoolean(value)) {
+            properties[key] = value.toString();
+        }
+    });
+    return { properties, measurements };
+}
+exports.buildPropertiesAndMeasurements = buildPropertiesAndMeasurements;
 /**
  * This is a wrapper around appinsights sdk for convenience.
  *
@@ -35,6 +94,7 @@ class AppInsights extends kit_1.AsyncCreatable {
     }
     /**
      * Publishes event to app insights dashboard
+     *
      * @param eventName {string} - name of the event you want published. Will be concatenated with this.options.project
      * @param attributes {Attributes} - map of properties to publish alongside the event.
      */
@@ -46,16 +106,19 @@ class AppInsights extends kit_1.AsyncCreatable {
     }
     /**
      * Publishes exception to app insights dashboard
+     *
      * @param exception {Error} - exception you want published.
      * @param attributes {Attributes} - map of measurements to publish alongside the exception.
      */
     sendTelemetryException(exception, attributes = {}) {
-        this.logger.debug(`Sending telemetry exception: ${exception.message}`);
+        const cleanException = sanitizeError(exception);
+        this.logger.debug(`Sending telemetry exception: ${cleanException.message}`);
         const { properties, measurements } = buildPropertiesAndMeasurements(attributes);
-        this.appInsightsClient.trackException({ exception, properties, measurements });
+        this.appInsightsClient.trackException({ exception: cleanException, properties, measurements });
     }
     /**
      * Publishes diagnostic information to app insights dashboard
+     *
      * @param message {string} - trace message to sen to app insights.
      * @param properties {Properties} - map of properties to publish alongside the event.
      */
@@ -65,6 +128,7 @@ class AppInsights extends kit_1.AsyncCreatable {
     }
     /**
      * Publishes metric to app insights dashboard
+     *
      * @param name {string} - name of the metric you want published
      * @param value {number} - value of the metric
      * @param properties {Properties} - map of properties to publish alongside the event.
@@ -102,7 +166,8 @@ class AppInsights extends kit_1.AsyncCreatable {
     }
     /**
      * Builds the properties to send with every event
-     * @return {Properties} map of base properites and properties provided when class was created
+     *
+     * @return {Properties} map of base properties and properties provided when class was created
      */
     buildCommonProperties() {
         const baseProperties = {
@@ -110,12 +175,13 @@ class AppInsights extends kit_1.AsyncCreatable {
             'common.os': os.platform(),
             'common.platformversion': getPlatformVersion(),
             'common.systemmemory': getSystemMemory(),
-            'common.usertype': this.env.getString('SFDX_USER_TYPE') || 'normal'
+            'common.usertype': this.env.getString('SFDX_USER_TYPE') || 'normal',
         };
         return Object.assign(baseProperties, this.options.commonProperties);
     }
     /**
      * Builds the context tags for appInsightsClient
+     *
      * @return {Properties} map of tags to add to this.appInsightsClient.context.tags
      */
     buildContextTags() {
@@ -125,52 +191,14 @@ class AppInsights extends kit_1.AsyncCreatable {
     }
     // filters out non-GDPR compliant tags
     hideGDPRdata(tags) {
-        this.gdprSensitiveKeys.forEach(key => {
+        this.gdprSensitiveKeys.forEach((key) => {
             tags[key] = AppInsights.GDPR_HIDDEN;
         });
         return tags;
     }
 }
+exports.AppInsights = AppInsights;
 AppInsights.GDPR_HIDDEN = '<GDPR_HIDDEN>';
 AppInsights.APP_INSIGHTS_SERVER = 'https://dc.services.visualstudio.com';
 AppInsights.ASIMOV_ENDPOINT = 'https://vortex.data.microsoft.com/collect/v1';
-exports.AppInsights = AppInsights;
-function buildPropertiesAndMeasurements(attributes) {
-    const properties = {};
-    const measurements = {};
-    Object.keys(attributes).forEach(key => {
-        const value = attributes[key];
-        if (ts_types_1.isString(value)) {
-            properties[key] = value;
-        }
-        else if (ts_types_1.isNumber(value)) {
-            measurements[key] = value;
-        }
-        else if (ts_types_1.isBoolean(value)) {
-            properties[key] = value.toString();
-        }
-    });
-    return { properties, measurements };
-}
-exports.buildPropertiesAndMeasurements = buildPropertiesAndMeasurements;
-function getPlatformVersion() {
-    return (os.release() || '').replace(/^(\d+)(\.\d+)?(\.\d+)?(.*)/, '$1$2$3');
-}
-exports.getPlatformVersion = getPlatformVersion;
-function getCpus() {
-    const cpus = os.cpus();
-    if (cpus && cpus.length > 0) {
-        return `${cpus[0].model}(${cpus.length} x ${cpus[0].speed})`;
-    }
-    else {
-        return '';
-    }
-}
-exports.getCpus = getCpus;
-function getSystemMemory() {
-    return `${(os.totalmem() / (1024 * 1024 * 1024)).toFixed(2)} GB`;
-}
-function isAsimovKey(key) {
-    return !!(key && key.indexOf('AIF-') === 0);
-}
 //# sourceMappingURL=appInsights.js.map

package/lib/exported.js

@@ -1,9 +1,22 @@
+/*
+ * Copyright (c) 2020, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
 'use strict';
-function __export(m) {
-    for (var p in m) if (!exports.hasOwnProperty(p)) exports[p] = m[p];
-}
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !exports.hasOwnProperty(p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 const telemetryReporter_1 = require("./telemetryReporter");
-__export(require("./telemetryReporter"));
+__exportStar(require("./telemetryReporter"), exports);
 exports.default = telemetryReporter_1.TelemetryReporter;
 //# sourceMappingURL=exported.js.map

package/lib/telemetryReporter.d.ts

@@ -6,17 +6,17 @@ export { TelemetryOptions, Attributes, Properties, TelemetryClient } from './app
  * Reports telemetry events to app insights. We do not send if the config 'disableTelemetry' is set.
  */
 export declare class TelemetryReporter extends AsyncCreatable<TelemetryOptions> {
-    /**
-     * Determine if the telemetry event should be logged.
-     * Setting the disableTelemetry config var to true will disable insights for errors and diagnostics.
-     */
-    static determineSfdxTelemetryEnabled(): Promise<boolean>;
     private static config;
     private options;
     private logger;
     private config;
     private reporter;
     constructor(options: TelemetryOptions);
+    /**
+     * Determine if the telemetry event should be logged.
+     * Setting the disableTelemetry config var to true will disable insights for errors and diagnostics.
+     */
+    static determineSfdxTelemetryEnabled(): Promise<boolean>;
     init(): Promise<void>;
     /**
      * Starts data collection services. This is for long running processes. Short lived
@@ -32,24 +32,28 @@ export declare class TelemetryReporter extends AsyncCreatable<TelemetryOptions>
     testConnection(): Promise<boolean>;
     /**
      * Sends message to child process.
+     *
      * @param eventName {string} - name of the event you want published.
      * @param attributes {Attributes} - map of properties to publish alongside the event.
      */
     sendTelemetryEvent(eventName: string, attributes?: Attributes): void;
     /**
      * Sends exception to child process.
+     *
      * @param exception {Error} - exception you want published.
      * @param measurements {Measurements} - map of measurements to publish alongside the event.
      */
     sendTelemetryException(exception: Error, attributes?: Attributes): void;
     /**
      * Publishes diagnostic information to app insights dashboard
+     *
      * @param message {string} - trace message to sen to app insights.
      * @param properties {Properties} - map of properties to publish alongside the event.
      */
     sendTelemetryTrace(traceMessage: string, properties?: Properties): void;
     /**
      * Publishes metric to app insights dashboard
+     *
      * @param name {string} - name of the metric you want published
      * @param value {number} - value of the metric
      * @param properties {Properties} - map of properties to publish alongside the event.

package/lib/telemetryReporter.js

@@ -1,17 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryReporter = void 0;
+/*
+ * Copyright (c) 2020, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+const os = require("os");
 const core_1 = require("@salesforce/core");
 const kit_1 = require("@salesforce/kit");
 const axios_1 = require("axios");
-const os = require("os");
 const appInsights_1 = require("./appInsights");
 const DISABLE_TELEMETRY = 'disableTelemetry';
 var appInsights_2 = require("./appInsights");
-exports.TelemetryClient = appInsights_2.TelemetryClient;
+Object.defineProperty(exports, "TelemetryClient", { enumerable: true, get: function () { return appInsights_2.TelemetryClient; } });
 /**
  * Reports telemetry events to app insights. We do not send if the config 'disableTelemetry' is set.
  */
 class TelemetryReporter extends kit_1.AsyncCreatable {
+    constructor(options) {
+        super(options);
+        this.options = options;
+    }
     /**
      * Determine if the telemetry event should be logged.
      * Setting the disableTelemetry config var to true will disable insights for errors and diagnostics.
@@ -25,10 +36,6 @@ class TelemetryReporter extends kit_1.AsyncCreatable {
         const isEnabled = !sfdxDisableInsights;
         return isEnabled;
     }
-    constructor(options) {
-        super(options);
-        this.options = options;
-    }
     async init() {
         this.logger = await core_1.Logger.child('TelemetryReporter');
         if (!TelemetryReporter.config) {
@@ -73,7 +80,7 @@ class TelemetryReporter extends kit_1.AsyncCreatable {
                 timeout,
                 cancelToken: cancelRequest.token,
                 // We want any status less than 500 to be resolved (not rejected)
-                validateStatus: (status) => status < 500
+                validateStatus: (status) => status < 500,
             };
             await axios_1.default.get(appInsights_1.AppInsights.APP_INSIGHTS_SERVER, options);
             canConnect = true;
@@ -91,6 +98,7 @@ class TelemetryReporter extends kit_1.AsyncCreatable {
     }
     /**
      * Sends message to child process.
+     *
      * @param eventName {string} - name of the event you want published.
      * @param attributes {Attributes} - map of properties to publish alongside the event.
      */
@@ -101,6 +109,7 @@ class TelemetryReporter extends kit_1.AsyncCreatable {
     }
     /**
      * Sends exception to child process.
+     *
      * @param exception {Error} - exception you want published.
      * @param measurements {Measurements} - map of measurements to publish alongside the event.
      */
@@ -114,6 +123,7 @@ class TelemetryReporter extends kit_1.AsyncCreatable {
     }
     /**
      * Publishes diagnostic information to app insights dashboard
+     *
      * @param message {string} - trace message to sen to app insights.
      * @param properties {Properties} - map of properties to publish alongside the event.
      */
@@ -124,6 +134,7 @@ class TelemetryReporter extends kit_1.AsyncCreatable {
     }
     /**
      * Publishes metric to app insights dashboard
+     *
      * @param name {string} - name of the metric you want published
      * @param value {number} - value of the metric
      * @param properties {Properties} - map of properties to publish alongside the event.

package/package.json

@@ -1,23 +1,24 @@
 {
   "name": "@salesforce/telemetry",
-  "version": "2.0.2",
+  "version": "3.0.1",
   "description": "Library for application insights",
   "main": "lib/exported",
-  "repository": "https://github.com/forcedotcom/cli-packages",
+  "repository": "forcedotcom/telemetry",
   "author": "Salesforce",
   "license": "BSD-3-Clause",
   "scripts": {
-    "build": "yarn sfdx-build",
-    "clean": "yarn sfdx-clean",
-    "clean-all": "yarn sfdx-clean all",
-    "compile": "yarn sfdx-compile",
-    "docs": "yarn sfdx-docs",
-    "format": "yarn sfdx-format",
-    "lint": "yarn sfdx-lint",
+    "build": "sf-build",
+    "clean": "sf-clean",
+    "clean-all": "sf-clean all",
+    "compile": "sf-compile",
+    "docs": "sf-docs",
+    "format": "sf-format",
+    "lint": "sf-lint",
     "lint-fix": "yarn sfdx-lint --fix",
-    "prepack": "yarn sfdx-build",
+    "prepack": "sf-build",
     "prepare": "npm run build",
-    "test": "yarn sfdx-test"
+    "pretest": "sf-compile-test",
+    "test": "sf-test"
   },
   "keywords": [
     "force",
@@ -32,18 +33,37 @@
     "!lib/**/*.map"
   ],
   "dependencies": {
-    "@salesforce/core": "^2.1.6",
+    "@salesforce/core": "^2.15.2",
     "@salesforce/ts-types": "^1.2.1",
     "applicationinsights": "^1.4.0",
-    "axios": "^0.19.2"
+    "axios": "^0.21.1"
   },
   "devDependencies": {
-    "@salesforce/dev-scripts": "^0.3.14",
-    "@salesforce/ts-sinon": "^1.1.0"
+    "@salesforce/dev-config": "^2.0.0",
+    "@salesforce/dev-scripts": "^0.6.2",
+    "@salesforce/prettier-config": "^0.0.1",
+    "@salesforce/ts-sinon": "^1.1.0",
+    "@typescript-eslint/eslint-plugin": "^2.30.0",
+    "@typescript-eslint/parser": "^2.30.0",
+    "chai": "^4.2.0",
+    "eslint": "^6.8.0",
+    "eslint-config-prettier": "^6.11.0",
+    "eslint-config-salesforce": "^0.1.0",
+    "eslint-config-salesforce-license": "^0.1.0",
+    "eslint-config-salesforce-typescript": "^0.1.0",
+    "eslint-plugin-header": "^3.0.0",
+    "eslint-plugin-import": "^2.20.2",
+    "eslint-plugin-jsdoc": "^27.0.3",
+    "eslint-plugin-prettier": "^3.1.3",
+    "mocha": "^7.2.0",
+    "nyc": "^15.1.0",
+    "prettier": "^2.0.5",
+    "sinon": "^9.0.2",
+    "ts-node": "^8.10.2",
+    "typescript": "^3.9.3"
   },
   "types": "lib/exported.d.ts",
   "publishConfig": {
     "access": "public"
-  },
-  "gitHead": "b0f530d31fbbb22a171ff6042a590df9bf283ad1"
+  }
 }