npq 3.1.0 → 3.2.1

package/lib/marshalls/author.marshall.js

@@ -2,7 +2,6 @@
 
 const BaseMarshall = require('./baseMarshall')
 const validator = require('validator')
-const Warning = require('../helpers/warning')
 const { marshallCategories } = require('./constants')
 
 const MARSHALL_NAME = 'author'
@@ -11,39 +10,71 @@ class Marshall extends BaseMarshall {
   constructor(options) {
     super(options)
     this.name = MARSHALL_NAME
-    this.categoryId = marshallCategories.PackageHealth.id
+    this.categoryId = marshallCategories.SupplyChainSecurity.id
   }
 
   title() {
     return 'Identifying package author...'
   }
 
-  validate(pkg) {
-    return this.packageRepoUtils.getPackageInfo(pkg.packageName).then((data) => {
-      const lastVersionData =
-        data.versions && data['dist-tags'] && data.versions[data['dist-tags'].latest]
-
-      const hasAuthorEmail =
-        (lastVersionData &&
-          lastVersionData.author &&
-          lastVersionData.author.email &&
-          validator.isEmail(lastVersionData.author.email)) ||
-        (data.versions &&
-          lastVersionData &&
-          lastVersionData.authors &&
-          lastVersionData.authors.filter &&
-          lastVersionData.authors.filter(
-            (author) => author.email && validator.isEmail(author.email).length
-          ))
-
-      if (!hasAuthorEmail) {
-        throw new Warning(
-          'the package description has no e-mail associated with author(s). Proceed with care.'
-        )
+  /**
+   * What do we check?
+   * 1. Who is the user who published the package? in the pakument's `_npmUser` field
+   * 2. Is this the first time we see this user publishing a package?
+   *   If so, halt and report.
+   * 3. Start from first version to latest version and check if they published
+   *   the package before.
+   *   If they did, and the difference between this published version date and
+   *   first is more than 30 days then halt and report.
+   * @param {*} pkg
+   * @returns
+   */
+  async validate(pkg) {
+    // @TODO move some of these utility functions about first package vesion
+    // published, date diff, etc into the package repo utils
+    const pakument = await this.packageRepoUtils.getPackageInfo(pkg.packageName)
+
+    // @TODO fix to work for both explicit versions (1.0.0) and also
+    // for dis-tags (latest)
+    const npmUser = pakument.versions[pkg.packageVersion]._npmUser
+    if (!npmUser || !npmUser.email) {
+      throw new Error('could not determine publishing user for this package version')
+    }
+
+    if (!validator.isEmail(npmUser.email)) {
+      throw new Error('the publishing user has no valid email address')
+    }
+
+    let firstVersionForUser = null
+    const versionPublishedDateString = pakument.time[pkg.packageVersion]
+    for (const [version, versionMetadata] of Object.entries(pakument.versions)) {
+      if (versionMetadata._npmUser && versionMetadata._npmUser.email === npmUser.email) {
+        firstVersionForUser = versionMetadata
+        break
       }
+    }
+
+    if (!firstVersionForUser || firstVersionForUser.version === pkg.packageVersion) {
+      throw new Error(
+        `The user ${npmUser.name} <${npmUser.email}> published this package for the first time only ${dateDiffInDays} days ago. Proceed with care.`
+      )
+    }
+
+    const firstPublishedDateString = pakument.time[firstVersionForUser.version]
+
+    const dateDiffInMs = new Date(versionPublishedDateString) - new Date(firstPublishedDateString)
+    let dateDiffInDays = 0
+    if (dateDiffInMs > 0) {
+      dateDiffInDays = Math.round(dateDiffInMs / (1000 * 60 * 60 * 24))
+    }
+
+    if (dateDiffInDays <= 30) {
+      throw new Error(
+        `The user ${npmUser.name} <${npmUser.email}> published this package for the first time only ${dateDiffInDays} days ago. Proceed with care.`
+      )
+    }
 
-      return data
-    })
+    return versionPublishedDateString
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "npq",
-  "version": "3.1.0",
+  "version": "3.2.1",
   "description": "marshall your npm/npm package installs with high quality and class 🎖",
   "bin": {
     "npq": "./bin/npq.js",