[npm] - Last update badge added

services/npm/npm-base.js

@@ -143,4 +143,25 @@ export default class NpmBase extends BaseJsonService {
 
     return this.constructor._validate(packageData, packageDataSchema)
   }
+
+  async fetch({ registryUrl, scope, packageName, schema }) {
+    registryUrl = registryUrl || this.constructor.defaultRegistryUrl
+    let url
+
+    if (scope === undefined) {
+      url = `${registryUrl}/${packageName}`
+    } else {
+      const scoped = this.constructor.encodeScopedPackage({
+        scope,
+        packageName,
+      })
+      url = `${registryUrl}/${scoped}`
+    }
+
+    return this._requestJson({
+      url,
+      schema,
+      httpErrors: { 404: 'package not found' },
+    })
+  }
 }

services/npm/npm-last-update.service.js

@@ -0,0 +1,97 @@
+import Joi from 'joi'
+import dayjs from 'dayjs'
+import { NotFound, pathParam, queryParam } from '../index.js'
+import { formatDate } from '../text-formatters.js'
+import { age as ageColor } from '../color-formatters.js'
+import NpmBase, { packageNameDescription } from './npm-base.js'
+
+const updateResponseSchema = Joi.object({
+  time: Joi.object({
+    created: Joi.string().required(),
+    modified: Joi.string().required(),
+  })
+    .pattern(Joi.string(), Joi.any())
+    .required(),
+  'dist-tags': Joi.object().pattern(Joi.string(), Joi.any()).required(),
+}).required()
+
+export class NpmLastUpdate extends NpmBase {
+  static category = 'activity'
+
+  static route = this.buildRoute('npm/last-update', { withTag: true })
+
+  static openApi = {
+    '/npm/last-update/{packageName}': {
+      get: {
+        summary: 'NPM Last Update',
+        parameters: [
+          pathParam({
+            name: 'packageName',
+            example: 'verdaccio',
+            packageNameDescription,
+          }),
+          queryParam({
+            name: 'registry_uri',
+            example: 'https://registry.npmjs.com',
+          }),
+        ],
+      },
+    },
+    '/npm/last-update/{packageName}/{tag}': {
+      get: {
+        summary: 'NPM Last Update (with dist tag)',
+        parameters: [
+          pathParam({
+            name: 'packageName',
+            example: 'verdaccio',
+            packageNameDescription,
+          }),
+          pathParam({
+            name: 'tag',
+            example: 'next-8',
+          }),
+          queryParam({
+            name: 'registry_uri',
+            example: 'https://registry.npmjs.com',
+          }),
+        ],
+      },
+    },
+  }
+
+  static defaultBadgeData = { label: 'last updated' }
+
+  static render({ date }) {
+    return {
+      message: formatDate(date),
+      color: ageColor(date),
+    }
+  }
+
+  async handle(namedParams, queryParams) {
+    const { scope, packageName, tag, registryUrl } =
+      this.constructor.unpackParams(namedParams, queryParams)
+
+    const packageData = await this.fetch({
+      registryUrl,
+      scope,
+      packageName,
+      schema: updateResponseSchema,
+    })
+
+    let date
+
+    if (tag && tag in packageData['dist-tags']) {
+      const tagVersion = packageData['dist-tags'][tag]
+      date = dayjs(packageData.time[tagVersion])
+    } else if (tag && !(tag in packageData['dist-tags'])) {
+      throw new NotFound({ prettyMessage: 'tag not found' })
+    } else {
+      date = packageData.time.modified
+        ? dayjs(packageData.time.modified)
+        : dayjs(packageData.time.created)
+    }
+
+    return this.constructor.render({ date })
+  }
+}

services/npm/npm-last-update.tester.js

@@ -0,0 +1,53 @@
+import { isFormattedDate } from '../test-validators.js'
+import { createServiceTester } from '../tester.js'
+
+export const t = await createServiceTester()
+
+t.create('last updated date (valid package)')
+  .get('/verdaccio.json')
+  .expectBadge({
+    label: 'last updated',
+    message: isFormattedDate,
+  })
+
+t.create('last updated date (invalid package)')
+  .get('/not-a-package.json')
+  .expectBadge({
+    label: 'last updated',
+    message: 'package not found',
+  })
+
+t.create('last update from custom repository (valid scenario)')
+  .get('/verdaccio.json?registry_uri=https://registry.npmjs.com')
+  .expectBadge({
+    label: 'last updated',
+    message: isFormattedDate,
+  })
+
+t.create('last update scoped package (valid scenario)')
+  .get('/@npm/types.json')
+  .expectBadge({
+    label: 'last updated',
+    message: isFormattedDate,
+  })
+
+t.create('last update scoped package (invalid scenario)')
+  .get('/@not-a-scoped-package/not-a-valid-package.json')
+  .expectBadge({
+    label: 'last updated',
+    message: 'package not found',
+  })
+
+t.create('last updated date with tag (valid scenario)')
+  .get('/verdaccio/latest.json')
+  .expectBadge({
+    label: 'last updated',
+    message: isFormattedDate,
+  })
+
+t.create('last updated date (invalid tag)')
+  .get('/verdaccio/not-a-valid-tag.json')
+  .expectBadge({
+    label: 'last updated',
+    message: 'tag not found',
+  })