@atlaskit/dependency-version-analytics 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @atlaskit/dependency-version-analytics
 
+## 1.1.0
+
+### Minor Changes
+
+- [`dd9a70fcafc`](https://bitbucket.org/atlassian/atlassian-frontend/commits/dd9a70fcafc) - Add npm dist-tags (latest, next, rc, hotfix) to analytics
+
 ## 1.0.0
 
 ### Major Changes

package/README.md

@@ -59,7 +59,8 @@ This command will be used to record when atlaskit publish new versions of their
 This will run the 'dev' mode of the tool and compile typescript on the fly. Any changes made to the source will instantly reflect in the product repo.
 
 1. Run `yarn link` inside the package
-2. Run `yarn link add '@atlaskit/dependency-version-analytics'` inside the product repo of your choosing
+2. `cd` to the root of the `alassian-frontend` repo then run `yarn build @atlaskit/dependency-version-analytics`
+2. Run `yarn link '@atlaskit/dependency-version-analytics'` inside the product repo of your choosing or in the [`atlaskit-version-analytics`](https://bitbucket.org/atlassian/atlaskit-version-analytics/src/master/) repo to test your changes
 
 Make dev changes + save.
 

package/dist/cjs/commands/populate-historic-data/package.js

@@ -11,7 +11,9 @@ var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/sli
 var _semver = _interopRequireDefault(require("semver"));
 var _getPackageVersionHistory = _interopRequireDefault(require("../../util/get-package-version-history"));
 var _analytics = require("../../util/analytics");
-var createAnalyticsEvents = function createAnalyticsEvents(packageName, packageVersionHistory, since) {
+var createAnalyticsEvents = function createAnalyticsEvents(packageName, packageVersionHistoryAndTags, since) {
+  var packageVersionHistory = packageVersionHistoryAndTags['time'];
+  var tags = packageVersionHistoryAndTags['dist-tags'];
   var sortedPackageVersionHistory = Object.entries(packageVersionHistory).filter(function (_ref) {
     var _ref2 = (0, _slicedToArray2.default)(_ref, 1),
       version = _ref2[0];
@@ -28,7 +30,8 @@ var createAnalyticsEvents = function createAnalyticsEvents(packageName, packageV
     }
     var previousVersion = sortedPackageVersionHistory[i - 1] && sortedPackageVersionHistory[i - 1][0];
     return (0, _analytics.createUpgradeEvent)(packageName, version, previousVersion, time, {
-      historical: true
+      historical: true,
+      tags: tags
     });
   }).filter(function (e) {
     return e != null;

package/dist/cjs/commands/populate-historic-data/product.js

@@ -18,6 +18,7 @@ var statlas = _interopRequireWildcard(require("../../util/statlas"));
 var _generateCsv = require("./util/generate-csv");
 var _assert = require("../../util/assert");
 var _dependencyStore = require("./lib/dependency-store");
+var _getPackageVersionHistory = _interopRequireDefault(require("../../util/get-package-version-history"));
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
 var getUpgradeEventsFromPkgChange = function getUpgradeEventsFromPkgChange(oldDeps, newDeps, _ref) {
@@ -66,35 +67,35 @@ var getUpgradeEventsFromPkgChange = function getUpgradeEventsFromPkgChange(oldDe
   return [].concat((0, _toConsumableArray2.default)(addOrUpgradeEvents), (0, _toConsumableArray2.default)(removeEvents));
 };
 var getEventsFromHistory = /*#__PURE__*/function () {
-  var _ref9 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(packageChangesLog, prevRunHash, _ref8) {
-    var cwd, allPackageChanges, allUpgradeEvents, dependencyStore, dependencies, i, item, newDependencies, packageChange, upgradeEvents;
-    return _regenerator.default.wrap(function _callee$(_context) {
+  var _ref9 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(packageChangesLog, prevRunHash, _ref8) {
+    var cwd, allPackageChanges, allUpgradeEvents, dependencyStore, dependencies, i, item, newDependencies, packageChange, upgradeEvents, _allUpgradeEvents;
+    return _regenerator.default.wrap(function _callee2$(_context2) {
       while (1) {
-        switch (_context.prev = _context.next) {
+        switch (_context2.prev = _context2.next) {
           case 0:
             cwd = _ref8.cwd;
             allPackageChanges = [];
             allUpgradeEvents = [];
             (0, _assert.assert)(packageChangesLog.all.length > 0, '');
             dependencyStore = new _dependencyStore.DependencyStore(cwd);
-            _context.next = 7;
+            _context2.next = 7;
             return dependencyStore.initialise(prevRunHash);
           case 7:
-            dependencies = _context.sent;
+            dependencies = _context2.sent;
             i = 0;
           case 9:
             if (!(i < packageChangesLog.all.length)) {
-              _context.next = 21;
+              _context2.next = 21;
               break;
             }
             item = packageChangesLog.all[i];
             if (allPackageChanges.length > 0) {
               dependencies = allPackageChanges[allPackageChanges.length - 1].akDeps;
             }
-            _context.next = 14;
+            _context2.next = 14;
             return dependencyStore.update(item);
           case 14:
-            newDependencies = _context.sent;
+            newDependencies = _context2.sent;
             packageChange = {
               date: new Date(item.date).toISOString(),
               akDeps: newDependencies
@@ -104,143 +105,179 @@ var getEventsFromHistory = /*#__PURE__*/function () {
               commitHash: item.hash
             });
             if (upgradeEvents.length > 0) {
-              allUpgradeEvents.push.apply(allUpgradeEvents, (0, _toConsumableArray2.default)(upgradeEvents));
+              (_allUpgradeEvents = allUpgradeEvents).push.apply(_allUpgradeEvents, (0, _toConsumableArray2.default)(upgradeEvents));
               allPackageChanges.push(packageChange);
             }
           case 18:
             i++;
-            _context.next = 9;
+            _context2.next = 9;
             break;
           case 21:
-            return _context.abrupt("return", {
+            _context2.next = 23;
+            return Promise.all(allUpgradeEvents.map( /*#__PURE__*/function () {
+              var _ref10 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(upgradeEvent) {
+                var _distTags$hotfix, _distTags$latest, _distTags$next;
+                var getPackageTags, distTags;
+                return _regenerator.default.wrap(function _callee$(_context) {
+                  while (1) {
+                    switch (_context.prev = _context.next) {
+                      case 0:
+                        _context.next = 2;
+                        return (0, _getPackageVersionHistory.default)(upgradeEvent.dependencyName);
+                      case 2:
+                        getPackageTags = _context.sent;
+                        distTags = getPackageTags['dist-tags'];
+                        Object.keys(distTags).forEach(function (key) {
+                          if (key.startsWith('rc')) {
+                            upgradeEvent.rcTag = distTags[key];
+                          }
+                        });
+                        upgradeEvent.hotfixTag = (_distTags$hotfix = distTags['hotfix']) !== null && _distTags$hotfix !== void 0 ? _distTags$hotfix : null;
+                        upgradeEvent.latestTag = (_distTags$latest = distTags['latest']) !== null && _distTags$latest !== void 0 ? _distTags$latest : null;
+                        upgradeEvent.nextTag = (_distTags$next = distTags['next']) !== null && _distTags$next !== void 0 ? _distTags$next : null;
+                        return _context.abrupt("return", upgradeEvent);
+                      case 9:
+                      case "end":
+                        return _context.stop();
+                    }
+                  }
+                }, _callee);
+              }));
+              return function (_x4) {
+                return _ref10.apply(this, arguments);
+              };
+            }()));
+          case 23:
+            allUpgradeEvents = _context2.sent;
+            return _context2.abrupt("return", {
               allPackageChanges: allPackageChanges,
               allUpgradeEvents: allUpgradeEvents
             });
-          case 22:
+          case 25:
           case "end":
-            return _context.stop();
+            return _context2.stop();
         }
       }
-    }, _callee);
+    }, _callee2);
   }));
   return function getEventsFromHistory(_x, _x2, _x3) {
     return _ref9.apply(this, arguments);
   };
 }();
-function getSinceRef(_x4) {
+function getSinceRef(_x5) {
   return _getSinceRef.apply(this, arguments);
 }
 function _getSinceRef() {
-  _getSinceRef = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(flags) {
+  _getSinceRef = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee3(flags) {
     var meta, tag, tagExists;
-    return _regenerator.default.wrap(function _callee2$(_context2) {
+    return _regenerator.default.wrap(function _callee3$(_context3) {
       while (1) {
-        switch (_context2.prev = _context2.next) {
+        switch (_context3.prev = _context3.next) {
           case 0:
             if (!flags.statlas) {
-              _context2.next = 9;
+              _context3.next = 9;
               break;
             }
-            _context2.next = 3;
+            _context3.next = 3;
             return statlas.getMeta(flags.product);
           case 3:
-            meta = _context2.sent;
+            meta = _context3.sent;
             if (!(!meta || !meta.lastRunHash)) {
-              _context2.next = 6;
+              _context3.next = 6;
               break;
             }
             throw new Error(_chalk.default.red("Missing or invalid metadata file for ".concat(flags.product, ". Must use --reset for populating from start of history")));
           case 6:
-            return _context2.abrupt("return", meta.lastRunHash);
+            return _context3.abrupt("return", meta.lastRunHash);
           case 9:
             tag = flags.tag || _constants.DEFAULT_TAG;
-            _context2.next = 12;
+            _context3.next = 12;
             return (0, _git.refetchTag)(tag);
           case 12:
-            _context2.next = 14;
+            _context3.next = 14;
             return (0, _git.doesTagExist)(tag);
           case 14:
-            tagExists = _context2.sent;
+            tagExists = _context3.sent;
             if (tagExists) {
-              _context2.next = 17;
+              _context3.next = 17;
               break;
             }
             throw new Error(_chalk.default.red("Tag '".concat(tag, "' does not exist. Must use --reset for populating from start of history.")));
           case 17:
-            return _context2.abrupt("return", tag);
+            return _context3.abrupt("return", tag);
           case 18:
           case "end":
-            return _context2.stop();
+            return _context3.stop();
         }
       }
-    }, _callee2);
+    }, _callee3);
   }));
   return _getSinceRef.apply(this, arguments);
 }
-function populateProduct(_x5) {
+function populateProduct(_x6) {
   return _populateProduct.apply(this, arguments);
 }
 function _populateProduct() {
-  _populateProduct = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee3(flags) {
+  _populateProduct = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee4(flags) {
     var cwd, sinceRef, log, _yield$getEventsFromH, allPackageChanges, allUpgradeEvents, csv, currentCommit;
-    return _regenerator.default.wrap(function _callee3$(_context3) {
+    return _regenerator.default.wrap(function _callee4$(_context4) {
       while (1) {
-        switch (_context3.prev = _context3.next) {
+        switch (_context4.prev = _context4.next) {
           case 0:
             cwd = flags.cwd || process.cwd();
             if (!flags.reset) {
-              _context3.next = 5;
+              _context4.next = 5;
               break;
             }
-            _context3.t0 = undefined;
-            _context3.next = 8;
+            _context4.t0 = undefined;
+            _context4.next = 8;
             break;
           case 5:
-            _context3.next = 7;
+            _context4.next = 7;
             return getSinceRef(flags);
           case 7:
-            _context3.t0 = _context3.sent;
+            _context4.t0 = _context4.sent;
           case 8:
-            sinceRef = _context3.t0;
-            _context3.next = 11;
+            sinceRef = _context4.t0;
+            _context4.next = 11;
             return (0, _git.getChangesSince)(sinceRef);
           case 11:
-            log = _context3.sent;
+            log = _context4.sent;
             if (!(log.all.length === 0)) {
-              _context3.next = 15;
+              _context4.next = 15;
               break;
             }
             console.log("No package.json changes found since '".concat(sinceRef, "'."));
-            return _context3.abrupt("return");
+            return _context4.abrupt("return");
           case 15:
-            _context3.next = 17;
+            _context4.next = 17;
             return getEventsFromHistory(log, sinceRef, {
               cwd: cwd
             });
           case 17:
-            _yield$getEventsFromH = _context3.sent;
+            _yield$getEventsFromH = _context4.sent;
             allPackageChanges = _yield$getEventsFromH.allPackageChanges;
             allUpgradeEvents = _yield$getEventsFromH.allUpgradeEvents;
             if (!flags.csv) {
-              _context3.next = 24;
+              _context4.next = 24;
               break;
             }
             csv = (0, _generateCsv.generateCSV)(allPackageChanges);
             console.log(csv);
-            return _context3.abrupt("return");
+            return _context4.abrupt("return");
           case 24:
             if (!flags.dryRun) {
-              _context3.next = 27;
+              _context4.next = 27;
               break;
             }
             console.log(JSON.stringify(allUpgradeEvents));
-            return _context3.abrupt("return");
+            return _context4.abrupt("return");
           case 27:
             if (!(allUpgradeEvents.length > 0)) {
-              _context3.next = 32;
+              _context4.next = 32;
               break;
             }
-            _context3.next = 30;
+            _context4.next = 30;
             return (0, _analytics.sendAnalytics)(allUpgradeEvents, {
               dev: flags.dev,
               limit: flags.limit,
@@ -248,37 +285,37 @@ function _populateProduct() {
               skipPrompt: !flags.interactive
             });
           case 30:
-            _context3.next = 33;
+            _context4.next = 33;
             break;
           case 32:
             console.log("Found no AK dependency changes since last run from ref \"".concat(sinceRef, "\"'"));
           case 33:
             if (!flags.statlas) {
-              _context3.next = 42;
+              _context4.next = 42;
               break;
             }
-            _context3.next = 36;
+            _context4.next = 36;
             return (0, _git.getHash)('HEAD');
           case 36:
-            currentCommit = _context3.sent;
-            _context3.next = 39;
+            currentCommit = _context4.sent;
+            _context4.next = 39;
             return statlas.uploadMeta(flags.product, currentCommit);
           case 39:
             console.log('Finished');
-            _context3.next = 46;
+            _context4.next = 46;
             break;
           case 42:
             console.log('Updating tag to current commit...');
-            _context3.next = 45;
+            _context4.next = 45;
             return (0, _git.tagCommit)(_constants.DEFAULT_TAG);
           case 45:
             console.log("Finished. Run 'git push origin tag ".concat(sinceRef, "'."));
           case 46:
           case "end":
-            return _context3.stop();
+            return _context4.stop();
         }
       }
-    }, _callee3);
+    }, _callee4);
   }));
   return _populateProduct.apply(this, arguments);
 }

package/dist/cjs/util/analytics.js

@@ -50,6 +50,7 @@ function getUpgradeSubType(version, previousVersion) {
   return upgradeSubType;
 }
 function createUpgradeEvent(name, version, previousVersion, date) {
+  var _optionalArgs$tags, _ref, _tags$next, _tags$hotfix, _ref2;
   var optionalArgs = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : {};
   if (Number.isNaN(Date.parse(date))) {
     throw new Error("Invalid date: '".concat(date, "'"));
@@ -62,6 +63,14 @@ function createUpgradeEvent(name, version, previousVersion, date) {
   var upgradeSubType = getUpgradeSubType(version, previousVersion);
   var eventVersion = upgradeType !== 'remove' ? version : previousVersion;
   var parsedVersion = _semver.default.coerce(eventVersion);
+  var rcKey = null;
+  var tags = (_optionalArgs$tags = optionalArgs === null || optionalArgs === void 0 ? void 0 : optionalArgs.tags) !== null && _optionalArgs$tags !== void 0 ? _optionalArgs$tags : {};
+  Object.keys(tags).forEach(function (key) {
+    if (key.startsWith('rc')) {
+      rcKey = key;
+      return;
+    }
+  });
   return _objectSpread({
     cliVersion: _version.version,
     dependencyName: name,
@@ -71,20 +80,24 @@ function createUpgradeEvent(name, version, previousVersion, date) {
     patch: parsedVersion ? "".concat(parsedVersion.patch) : null,
     date: new Date(date).toISOString(),
     upgradeType: upgradeType,
-    upgradeSubType: upgradeSubType
+    upgradeSubType: upgradeSubType,
+    latestTag: (_ref = tags && tags['latest']) !== null && _ref !== void 0 ? _ref : null,
+    nextTag: (_tags$next = tags['next']) !== null && _tags$next !== void 0 ? _tags$next : null,
+    hotfixTag: (_tags$hotfix = tags['hotfix']) !== null && _tags$hotfix !== void 0 ? _tags$hotfix : null,
+    rcTag: (_ref2 = rcKey && tags[rcKey]) !== null && _ref2 !== void 0 ? _ref2 : null
   }, optionalArgs);
 }
 function sendAnalytics(_x, _x2) {
   return _sendAnalytics.apply(this, arguments);
 }
 function _sendAnalytics() {
-  _sendAnalytics = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(analyticsEvents, _ref) {
+  _sendAnalytics = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(analyticsEvents, _ref3) {
     var dev, limit, product, skipPrompt, analyticsEnv, eventsToSend, client, answers, promises;
     return _regenerator.default.wrap(function _callee$(_context) {
       while (1) {
         switch (_context.prev = _context.next) {
           case 0:
-            dev = _ref.dev, limit = _ref.limit, product = _ref.product, skipPrompt = _ref.skipPrompt;
+            dev = _ref3.dev, limit = _ref3.limit, product = _ref3.product, skipPrompt = _ref3.skipPrompt;
             analyticsEnv = dev ? 'dev' : 'prod';
             eventsToSend = limit != null ? analyticsEvents.slice(0, limit) : analyticsEvents;
             client = (0, _analyticsNodeClient.analyticsClient)({

package/dist/cjs/util/get-package-version-history.js

@@ -3,11 +3,11 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.default = getPackageVersionHistory;
+exports.default = getPackageVersionHistoryAndTags;
 var _child_process = require("child_process");
-function getPackageVersionHistory(packageName) {
+function getPackageVersionHistoryAndTags(packageName) {
   return new Promise(function (resolve, reject) {
-    (0, _child_process.exec)("yarn info ".concat(packageName, " --json time"), function (error, stdout, stderr) {
+    (0, _child_process.exec)("yarn info ".concat(packageName, " --json"), function (error, stdout, stderr) {
       if (error) {
         reject(error);
       }
@@ -16,7 +16,11 @@ function getPackageVersionHistory(packageName) {
       }
       var json;
       try {
-        json = JSON.parse(stdout).data;
+        var parseData = JSON.parse(stdout).data;
+        json = {
+          time: parseData['time'],
+          'dist-tags': parseData['dist-tags']
+        };
       } catch (e) {
         reject("Error parsing json output: ".concat(e));
       }

package/dist/cjs/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/dependency-version-analytics",
-	"version": "1.0.0",
+	"version": "1.1.0",
 	"sideEffects": false
 }

package/dist/es2019/commands/populate-historic-data/package.js

@@ -1,7 +1,9 @@
 import semver from 'semver';
-import getPackageVersionHistory from '../../util/get-package-version-history';
+import getPackageVersionHistoryAndTags from '../../util/get-package-version-history';
 import { createUpgradeEvent, sendAnalytics } from '../../util/analytics';
-const createAnalyticsEvents = (packageName, packageVersionHistory, since) => {
+const createAnalyticsEvents = (packageName, packageVersionHistoryAndTags, since) => {
+  const packageVersionHistory = packageVersionHistoryAndTags['time'];
+  const tags = packageVersionHistoryAndTags['dist-tags'];
   const sortedPackageVersionHistory = Object.entries(packageVersionHistory).filter(([version]) => semver.valid(version)).sort((a, b) => Number(new Date(a[1])) - Number(new Date(b[1])));
   const upgradeEvents = sortedPackageVersionHistory.map(([version, time], i) => {
     if (since && Number(new Date(time)) <= Number(new Date(since))) {
@@ -9,7 +11,8 @@ const createAnalyticsEvents = (packageName, packageVersionHistory, since) => {
     }
     const previousVersion = sortedPackageVersionHistory[i - 1] && sortedPackageVersionHistory[i - 1][0];
     return createUpgradeEvent(packageName, version, previousVersion, time, {
-      historical: true
+      historical: true,
+      tags
     });
   }).filter(e => e != null);
   return upgradeEvents;
@@ -18,7 +21,7 @@ export default async function populatePackage(flags) {
   if (!flags.pkg.startsWith('@atlaskit/')) {
     throw new Error(`Package must start with '@atlaskit/'`);
   }
-  const packageVersionHistory = await getPackageVersionHistory(flags.pkg);
+  const packageVersionHistory = await getPackageVersionHistoryAndTags(flags.pkg);
   if (flags.since && Number.isNaN(Number(new Date(flags.since)))) {
     throw new Error(`'since' flag is an invalid date`);
   }

package/dist/es2019/commands/populate-historic-data/product.js

@@ -6,6 +6,7 @@ import * as statlas from '../../util/statlas';
 import { generateCSV } from './util/generate-csv';
 import { assert } from '../../util/assert';
 import { DependencyStore } from './lib/dependency-store';
+import getPackageVersionHistoryAndTags from '../../util/get-package-version-history';
 const getUpgradeEventsFromPkgChange = (oldDeps, newDeps, {
   date,
   commitHash
@@ -44,7 +45,7 @@ const getEventsFromHistory = async (packageChangesLog, prevRunHash, {
   cwd
 }) => {
   const allPackageChanges = [];
-  const allUpgradeEvents = [];
+  let allUpgradeEvents = [];
   assert(packageChangesLog.all.length > 0, '');
   let dependencyStore = new DependencyStore(cwd);
   let dependencies = await dependencyStore.initialise(prevRunHash);
@@ -67,6 +68,21 @@ const getEventsFromHistory = async (packageChangesLog, prevRunHash, {
       allPackageChanges.push(packageChange);
     }
   }
+  // add dist-tags to upgrade event
+  allUpgradeEvents = await Promise.all(allUpgradeEvents.map(async upgradeEvent => {
+    var _distTags$hotfix, _distTags$latest, _distTags$next;
+    const getPackageTags = await getPackageVersionHistoryAndTags(upgradeEvent.dependencyName);
+    const distTags = getPackageTags['dist-tags'];
+    Object.keys(distTags).forEach(key => {
+      if (key.startsWith('rc')) {
+        upgradeEvent.rcTag = distTags[key];
+      }
+    });
+    upgradeEvent.hotfixTag = (_distTags$hotfix = distTags['hotfix']) !== null && _distTags$hotfix !== void 0 ? _distTags$hotfix : null;
+    upgradeEvent.latestTag = (_distTags$latest = distTags['latest']) !== null && _distTags$latest !== void 0 ? _distTags$latest : null;
+    upgradeEvent.nextTag = (_distTags$next = distTags['next']) !== null && _distTags$next !== void 0 ? _distTags$next : null;
+    return upgradeEvent;
+  }));
   return {
     allPackageChanges,
     allUpgradeEvents

package/dist/es2019/util/analytics.js

@@ -39,6 +39,7 @@ function getUpgradeSubType(version, previousVersion) {
   return upgradeSubType;
 }
 export function createUpgradeEvent(name, version, previousVersion, date, optionalArgs = {}) {
+  var _optionalArgs$tags, _ref, _tags$next, _tags$hotfix, _ref2;
   if (Number.isNaN(Date.parse(date))) {
     throw new Error(`Invalid date: '${date}'`);
   }
@@ -50,6 +51,14 @@ export function createUpgradeEvent(name, version, previousVersion, date, optiona
   const upgradeSubType = getUpgradeSubType(version, previousVersion);
   const eventVersion = upgradeType !== 'remove' ? version : previousVersion;
   const parsedVersion = semver.coerce(eventVersion);
+  let rcKey = null;
+  const tags = (_optionalArgs$tags = optionalArgs === null || optionalArgs === void 0 ? void 0 : optionalArgs.tags) !== null && _optionalArgs$tags !== void 0 ? _optionalArgs$tags : {};
+  Object.keys(tags).forEach(key => {
+    if (key.startsWith('rc')) {
+      rcKey = key;
+      return;
+    }
+  });
   return {
     cliVersion: packageVersion,
     dependencyName: name,
@@ -60,6 +69,10 @@ export function createUpgradeEvent(name, version, previousVersion, date, optiona
     date: new Date(date).toISOString(),
     upgradeType,
     upgradeSubType,
+    latestTag: (_ref = tags && tags['latest']) !== null && _ref !== void 0 ? _ref : null,
+    nextTag: (_tags$next = tags['next']) !== null && _tags$next !== void 0 ? _tags$next : null,
+    hotfixTag: (_tags$hotfix = tags['hotfix']) !== null && _tags$hotfix !== void 0 ? _tags$hotfix : null,
+    rcTag: (_ref2 = rcKey && tags[rcKey]) !== null && _ref2 !== void 0 ? _ref2 : null,
     ...optionalArgs
   };
 }

package/dist/es2019/util/get-package-version-history.js

@@ -1,7 +1,7 @@
 import { exec } from 'child_process';
-export default function getPackageVersionHistory(packageName) {
+export default function getPackageVersionHistoryAndTags(packageName) {
   return new Promise((resolve, reject) => {
-    exec(`yarn info ${packageName} --json time`, (error, stdout, stderr) => {
+    exec(`yarn info ${packageName} --json`, (error, stdout, stderr) => {
       if (error) {
         reject(error);
       }
@@ -10,7 +10,11 @@ export default function getPackageVersionHistory(packageName) {
       }
       let json;
       try {
-        json = JSON.parse(stdout).data;
+        const parseData = JSON.parse(stdout).data;
+        json = {
+          time: parseData['time'],
+          'dist-tags': parseData['dist-tags']
+        };
       } catch (e) {
         reject(`Error parsing json output: ${e}`);
       }

package/dist/es2019/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/dependency-version-analytics",
-	"version": "1.0.0",
+	"version": "1.1.0",
 	"sideEffects": false
 }

package/dist/esm/commands/populate-historic-data/package.js

@@ -2,9 +2,11 @@ import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
 import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import _regeneratorRuntime from "@babel/runtime/regenerator";
 import semver from 'semver';
-import getPackageVersionHistory from '../../util/get-package-version-history';
+import getPackageVersionHistoryAndTags from '../../util/get-package-version-history';
 import { createUpgradeEvent, sendAnalytics } from '../../util/analytics';
-var createAnalyticsEvents = function createAnalyticsEvents(packageName, packageVersionHistory, since) {
+var createAnalyticsEvents = function createAnalyticsEvents(packageName, packageVersionHistoryAndTags, since) {
+  var packageVersionHistory = packageVersionHistoryAndTags['time'];
+  var tags = packageVersionHistoryAndTags['dist-tags'];
   var sortedPackageVersionHistory = Object.entries(packageVersionHistory).filter(function (_ref) {
     var _ref2 = _slicedToArray(_ref, 1),
       version = _ref2[0];
@@ -21,7 +23,8 @@ var createAnalyticsEvents = function createAnalyticsEvents(packageName, packageV
     }
     var previousVersion = sortedPackageVersionHistory[i - 1] && sortedPackageVersionHistory[i - 1][0];
     return createUpgradeEvent(packageName, version, previousVersion, time, {
-      historical: true
+      historical: true,
+      tags: tags
     });
   }).filter(function (e) {
     return e != null;
@@ -45,7 +48,7 @@ function _populatePackage() {
             throw new Error("Package must start with '@atlaskit/'");
           case 2:
             _context.next = 4;
-            return getPackageVersionHistory(flags.pkg);
+            return getPackageVersionHistoryAndTags(flags.pkg);
           case 4:
             packageVersionHistory = _context.sent;
             if (!(flags.since && Number.isNaN(Number(new Date(flags.since))))) {

package/dist/esm/commands/populate-historic-data/product.js

@@ -10,6 +10,7 @@ import * as statlas from '../../util/statlas';
 import { generateCSV } from './util/generate-csv';
 import { assert } from '../../util/assert';
 import { DependencyStore } from './lib/dependency-store';
+import getPackageVersionHistoryAndTags from '../../util/get-package-version-history';
 var getUpgradeEventsFromPkgChange = function getUpgradeEventsFromPkgChange(oldDeps, newDeps, _ref) {
   var date = _ref.date,
     commitHash = _ref.commitHash;
@@ -56,35 +57,35 @@ var getUpgradeEventsFromPkgChange = function getUpgradeEventsFromPkgChange(oldDe
   return [].concat(_toConsumableArray(addOrUpgradeEvents), _toConsumableArray(removeEvents));
 };
 var getEventsFromHistory = /*#__PURE__*/function () {
-  var _ref9 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(packageChangesLog, prevRunHash, _ref8) {
-    var cwd, allPackageChanges, allUpgradeEvents, dependencyStore, dependencies, i, item, newDependencies, packageChange, upgradeEvents;
-    return _regeneratorRuntime.wrap(function _callee$(_context) {
+  var _ref9 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee2(packageChangesLog, prevRunHash, _ref8) {
+    var cwd, allPackageChanges, allUpgradeEvents, dependencyStore, dependencies, i, item, newDependencies, packageChange, upgradeEvents, _allUpgradeEvents;
+    return _regeneratorRuntime.wrap(function _callee2$(_context2) {
       while (1) {
-        switch (_context.prev = _context.next) {
+        switch (_context2.prev = _context2.next) {
           case 0:
             cwd = _ref8.cwd;
             allPackageChanges = [];
             allUpgradeEvents = [];
             assert(packageChangesLog.all.length > 0, '');
             dependencyStore = new DependencyStore(cwd);
-            _context.next = 7;
+            _context2.next = 7;
             return dependencyStore.initialise(prevRunHash);
           case 7:
-            dependencies = _context.sent;
+            dependencies = _context2.sent;
             i = 0;
           case 9:
             if (!(i < packageChangesLog.all.length)) {
-              _context.next = 21;
+              _context2.next = 21;
               break;
             }
             item = packageChangesLog.all[i];
             if (allPackageChanges.length > 0) {
               dependencies = allPackageChanges[allPackageChanges.length - 1].akDeps;
             }
-            _context.next = 14;
+            _context2.next = 14;
             return dependencyStore.update(item);
           case 14:
-            newDependencies = _context.sent;
+            newDependencies = _context2.sent;
             packageChange = {
               date: new Date(item.date).toISOString(),
               akDeps: newDependencies
@@ -94,143 +95,179 @@ var getEventsFromHistory = /*#__PURE__*/function () {
               commitHash: item.hash
             });
             if (upgradeEvents.length > 0) {
-              allUpgradeEvents.push.apply(allUpgradeEvents, _toConsumableArray(upgradeEvents));
+              (_allUpgradeEvents = allUpgradeEvents).push.apply(_allUpgradeEvents, _toConsumableArray(upgradeEvents));
               allPackageChanges.push(packageChange);
             }
           case 18:
             i++;
-            _context.next = 9;
+            _context2.next = 9;
             break;
           case 21:
-            return _context.abrupt("return", {
+            _context2.next = 23;
+            return Promise.all(allUpgradeEvents.map( /*#__PURE__*/function () {
+              var _ref10 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(upgradeEvent) {
+                var _distTags$hotfix, _distTags$latest, _distTags$next;
+                var getPackageTags, distTags;
+                return _regeneratorRuntime.wrap(function _callee$(_context) {
+                  while (1) {
+                    switch (_context.prev = _context.next) {
+                      case 0:
+                        _context.next = 2;
+                        return getPackageVersionHistoryAndTags(upgradeEvent.dependencyName);
+                      case 2:
+                        getPackageTags = _context.sent;
+                        distTags = getPackageTags['dist-tags'];
+                        Object.keys(distTags).forEach(function (key) {
+                          if (key.startsWith('rc')) {
+                            upgradeEvent.rcTag = distTags[key];
+                          }
+                        });
+                        upgradeEvent.hotfixTag = (_distTags$hotfix = distTags['hotfix']) !== null && _distTags$hotfix !== void 0 ? _distTags$hotfix : null;
+                        upgradeEvent.latestTag = (_distTags$latest = distTags['latest']) !== null && _distTags$latest !== void 0 ? _distTags$latest : null;
+                        upgradeEvent.nextTag = (_distTags$next = distTags['next']) !== null && _distTags$next !== void 0 ? _distTags$next : null;
+                        return _context.abrupt("return", upgradeEvent);
+                      case 9:
+                      case "end":
+                        return _context.stop();
+                    }
+                  }
+                }, _callee);
+              }));
+              return function (_x4) {
+                return _ref10.apply(this, arguments);
+              };
+            }()));
+          case 23:
+            allUpgradeEvents = _context2.sent;
+            return _context2.abrupt("return", {
               allPackageChanges: allPackageChanges,
               allUpgradeEvents: allUpgradeEvents
             });
-          case 22:
+          case 25:
           case "end":
-            return _context.stop();
+            return _context2.stop();
         }
       }
-    }, _callee);
+    }, _callee2);
   }));
   return function getEventsFromHistory(_x, _x2, _x3) {
     return _ref9.apply(this, arguments);
   };
 }();
-function getSinceRef(_x4) {
+function getSinceRef(_x5) {
   return _getSinceRef.apply(this, arguments);
 }
 function _getSinceRef() {
-  _getSinceRef = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee2(flags) {
+  _getSinceRef = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee3(flags) {
     var meta, tag, tagExists;
-    return _regeneratorRuntime.wrap(function _callee2$(_context2) {
+    return _regeneratorRuntime.wrap(function _callee3$(_context3) {
       while (1) {
-        switch (_context2.prev = _context2.next) {
+        switch (_context3.prev = _context3.next) {
           case 0:
             if (!flags.statlas) {
-              _context2.next = 9;
+              _context3.next = 9;
               break;
             }
-            _context2.next = 3;
+            _context3.next = 3;
             return statlas.getMeta(flags.product);
           case 3:
-            meta = _context2.sent;
+            meta = _context3.sent;
             if (!(!meta || !meta.lastRunHash)) {
-              _context2.next = 6;
+              _context3.next = 6;
               break;
             }
             throw new Error(chalk.red("Missing or invalid metadata file for ".concat(flags.product, ". Must use --reset for populating from start of history")));
           case 6:
-            return _context2.abrupt("return", meta.lastRunHash);
+            return _context3.abrupt("return", meta.lastRunHash);
           case 9:
             tag = flags.tag || DEFAULT_TAG;
-            _context2.next = 12;
+            _context3.next = 12;
             return refetchTag(tag);
           case 12:
-            _context2.next = 14;
+            _context3.next = 14;
             return doesTagExist(tag);
           case 14:
-            tagExists = _context2.sent;
+            tagExists = _context3.sent;
             if (tagExists) {
-              _context2.next = 17;
+              _context3.next = 17;
               break;
             }
             throw new Error(chalk.red("Tag '".concat(tag, "' does not exist. Must use --reset for populating from start of history.")));
           case 17:
-            return _context2.abrupt("return", tag);
+            return _context3.abrupt("return", tag);
           case 18:
           case "end":
-            return _context2.stop();
+            return _context3.stop();
         }
       }
-    }, _callee2);
+    }, _callee3);
   }));
   return _getSinceRef.apply(this, arguments);
 }
-export default function populateProduct(_x5) {
+export default function populateProduct(_x6) {
   return _populateProduct.apply(this, arguments);
 }
 function _populateProduct() {
-  _populateProduct = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee3(flags) {
+  _populateProduct = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee4(flags) {
     var cwd, sinceRef, log, _yield$getEventsFromH, allPackageChanges, allUpgradeEvents, csv, currentCommit;
-    return _regeneratorRuntime.wrap(function _callee3$(_context3) {
+    return _regeneratorRuntime.wrap(function _callee4$(_context4) {
       while (1) {
-        switch (_context3.prev = _context3.next) {
+        switch (_context4.prev = _context4.next) {
           case 0:
             cwd = flags.cwd || process.cwd();
             if (!flags.reset) {
-              _context3.next = 5;
+              _context4.next = 5;
               break;
             }
-            _context3.t0 = undefined;
-            _context3.next = 8;
+            _context4.t0 = undefined;
+            _context4.next = 8;
             break;
           case 5:
-            _context3.next = 7;
+            _context4.next = 7;
             return getSinceRef(flags);
           case 7:
-            _context3.t0 = _context3.sent;
+            _context4.t0 = _context4.sent;
           case 8:
-            sinceRef = _context3.t0;
-            _context3.next = 11;
+            sinceRef = _context4.t0;
+            _context4.next = 11;
             return getChangesSince(sinceRef);
           case 11:
-            log = _context3.sent;
+            log = _context4.sent;
             if (!(log.all.length === 0)) {
-              _context3.next = 15;
+              _context4.next = 15;
               break;
             }
             console.log("No package.json changes found since '".concat(sinceRef, "'."));
-            return _context3.abrupt("return");
+            return _context4.abrupt("return");
           case 15:
-            _context3.next = 17;
+            _context4.next = 17;
             return getEventsFromHistory(log, sinceRef, {
               cwd: cwd
             });
           case 17:
-            _yield$getEventsFromH = _context3.sent;
+            _yield$getEventsFromH = _context4.sent;
             allPackageChanges = _yield$getEventsFromH.allPackageChanges;
             allUpgradeEvents = _yield$getEventsFromH.allUpgradeEvents;
             if (!flags.csv) {
-              _context3.next = 24;
+              _context4.next = 24;
               break;
             }
             csv = generateCSV(allPackageChanges);
             console.log(csv);
-            return _context3.abrupt("return");
+            return _context4.abrupt("return");
           case 24:
             if (!flags.dryRun) {
-              _context3.next = 27;
+              _context4.next = 27;
               break;
             }
             console.log(JSON.stringify(allUpgradeEvents));
-            return _context3.abrupt("return");
+            return _context4.abrupt("return");
           case 27:
             if (!(allUpgradeEvents.length > 0)) {
-              _context3.next = 32;
+              _context4.next = 32;
               break;
             }
-            _context3.next = 30;
+            _context4.next = 30;
             return sendAnalytics(allUpgradeEvents, {
               dev: flags.dev,
               limit: flags.limit,
@@ -238,37 +275,37 @@ function _populateProduct() {
               skipPrompt: !flags.interactive
             });
           case 30:
-            _context3.next = 33;
+            _context4.next = 33;
             break;
           case 32:
             console.log("Found no AK dependency changes since last run from ref \"".concat(sinceRef, "\"'"));
           case 33:
             if (!flags.statlas) {
-              _context3.next = 42;
+              _context4.next = 42;
               break;
             }
-            _context3.next = 36;
+            _context4.next = 36;
             return getHash('HEAD');
           case 36:
-            currentCommit = _context3.sent;
-            _context3.next = 39;
+            currentCommit = _context4.sent;
+            _context4.next = 39;
             return statlas.uploadMeta(flags.product, currentCommit);
           case 39:
             console.log('Finished');
-            _context3.next = 46;
+            _context4.next = 46;
             break;
           case 42:
             console.log('Updating tag to current commit...');
-            _context3.next = 45;
+            _context4.next = 45;
             return tagCommit(DEFAULT_TAG);
           case 45:
             console.log("Finished. Run 'git push origin tag ".concat(sinceRef, "'."));
           case 46:
           case "end":
-            return _context3.stop();
+            return _context4.stop();
         }
       }
-    }, _callee3);
+    }, _callee4);
   }));
   return _populateProduct.apply(this, arguments);
 }

package/dist/esm/util/analytics.js

@@ -44,6 +44,7 @@ function getUpgradeSubType(version, previousVersion) {
   return upgradeSubType;
 }
 export function createUpgradeEvent(name, version, previousVersion, date) {
+  var _optionalArgs$tags, _ref, _tags$next, _tags$hotfix, _ref2;
   var optionalArgs = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : {};
   if (Number.isNaN(Date.parse(date))) {
     throw new Error("Invalid date: '".concat(date, "'"));
@@ -56,6 +57,14 @@ export function createUpgradeEvent(name, version, previousVersion, date) {
   var upgradeSubType = getUpgradeSubType(version, previousVersion);
   var eventVersion = upgradeType !== 'remove' ? version : previousVersion;
   var parsedVersion = semver.coerce(eventVersion);
+  var rcKey = null;
+  var tags = (_optionalArgs$tags = optionalArgs === null || optionalArgs === void 0 ? void 0 : optionalArgs.tags) !== null && _optionalArgs$tags !== void 0 ? _optionalArgs$tags : {};
+  Object.keys(tags).forEach(function (key) {
+    if (key.startsWith('rc')) {
+      rcKey = key;
+      return;
+    }
+  });
   return _objectSpread({
     cliVersion: packageVersion,
     dependencyName: name,
@@ -65,20 +74,24 @@ export function createUpgradeEvent(name, version, previousVersion, date) {
     patch: parsedVersion ? "".concat(parsedVersion.patch) : null,
     date: new Date(date).toISOString(),
     upgradeType: upgradeType,
-    upgradeSubType: upgradeSubType
+    upgradeSubType: upgradeSubType,
+    latestTag: (_ref = tags && tags['latest']) !== null && _ref !== void 0 ? _ref : null,
+    nextTag: (_tags$next = tags['next']) !== null && _tags$next !== void 0 ? _tags$next : null,
+    hotfixTag: (_tags$hotfix = tags['hotfix']) !== null && _tags$hotfix !== void 0 ? _tags$hotfix : null,
+    rcTag: (_ref2 = rcKey && tags[rcKey]) !== null && _ref2 !== void 0 ? _ref2 : null
   }, optionalArgs);
 }
 export function sendAnalytics(_x, _x2) {
   return _sendAnalytics.apply(this, arguments);
 }
 function _sendAnalytics() {
-  _sendAnalytics = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(analyticsEvents, _ref) {
+  _sendAnalytics = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(analyticsEvents, _ref3) {
     var dev, limit, product, skipPrompt, analyticsEnv, eventsToSend, client, answers, promises;
     return _regeneratorRuntime.wrap(function _callee$(_context) {
       while (1) {
         switch (_context.prev = _context.next) {
           case 0:
-            dev = _ref.dev, limit = _ref.limit, product = _ref.product, skipPrompt = _ref.skipPrompt;
+            dev = _ref3.dev, limit = _ref3.limit, product = _ref3.product, skipPrompt = _ref3.skipPrompt;
             analyticsEnv = dev ? 'dev' : 'prod';
             eventsToSend = limit != null ? analyticsEvents.slice(0, limit) : analyticsEvents;
             client = analyticsClient({

package/dist/esm/util/get-package-version-history.js

@@ -1,7 +1,7 @@
 import { exec } from 'child_process';
-export default function getPackageVersionHistory(packageName) {
+export default function getPackageVersionHistoryAndTags(packageName) {
   return new Promise(function (resolve, reject) {
-    exec("yarn info ".concat(packageName, " --json time"), function (error, stdout, stderr) {
+    exec("yarn info ".concat(packageName, " --json"), function (error, stdout, stderr) {
       if (error) {
         reject(error);
       }
@@ -10,7 +10,11 @@ export default function getPackageVersionHistory(packageName) {
       }
       var json;
       try {
-        json = JSON.parse(stdout).data;
+        var parseData = JSON.parse(stdout).data;
+        json = {
+          time: parseData['time'],
+          'dist-tags': parseData['dist-tags']
+        };
       } catch (e) {
         reject("Error parsing json output: ".concat(e));
       }

package/dist/esm/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/dependency-version-analytics",
-	"version": "1.0.0",
+	"version": "1.1.0",
 	"sideEffects": false
 }

package/dist/types/types.d.ts

@@ -12,7 +12,14 @@ export declare type UpgradeEvent = {
     upgradeType: UpgradeType;
     upgradeSubType: UpgradeSubType;
     cliVersion: string;
+    latestTag: string | null;
+    nextTag: string | null;
+    hotfixTag: string | null;
+    rcTag: string | null;
     dependencyType?: DependencyType;
     historical?: boolean;
     commitHash?: string;
 };
+export declare type DistTagsType = {
+    [tag: string]: string;
+};

package/dist/types/util/analytics.d.ts

@@ -1,8 +1,9 @@
-import { UpgradeEvent, DependencyType } from '../types';
+import { UpgradeEvent, DependencyType, DistTagsType } from '../types';
 export declare function createUpgradeEvent(name: string, version: string | undefined, previousVersion: string | undefined, date: string, optionalArgs?: {
     commitHash?: string;
     dependencyType?: DependencyType;
     historical?: boolean;
+    tags?: DistTagsType;
 }): UpgradeEvent | null;
 export declare function sendAnalytics(analyticsEvents: UpgradeEvent[], { dev, limit, product, skipPrompt, }: {
     dev?: boolean;

package/dist/types/util/get-package-version-history.d.ts

@@ -1,4 +1,8 @@
-export declare type PackageVersionHistory = {
-    [version: string]: string;
+import { DistTagsType } from '../types';
+export declare type PackageVersionHistoryAndTagsType = {
+    time: {
+        [version: string]: string;
+    };
+    'dist-tags': DistTagsType;
 };
-export default function getPackageVersionHistory(packageName: string): Promise<PackageVersionHistory>;
+export default function getPackageVersionHistoryAndTags(packageName: string): Promise<PackageVersionHistoryAndTagsType>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlaskit/dependency-version-analytics",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Tool to pull atlaskit version history from a repo",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"

package/report.api.md

@@ -83,6 +83,10 @@ export type UpgradeEvent = {
   upgradeType: UpgradeType;
   upgradeSubType: UpgradeSubType;
   cliVersion: string;
+  latestTag: null | string;
+  nextTag: null | string;
+  hotfixTag: null | string;
+  rcTag: null | string;
   dependencyType?: DependencyType;
   historical?: boolean;
   commitHash?: string;

package/tmp/api-report-tmp.d.ts

@@ -58,6 +58,10 @@ export type UpgradeEvent = {
     upgradeType: UpgradeType;
     upgradeSubType: UpgradeSubType;
     cliVersion: string;
+    latestTag: null | string;
+    nextTag: null | string;
+    hotfixTag: null | string;
+    rcTag: null | string;
     dependencyType?: DependencyType;
     historical?: boolean;
     commitHash?: string;