feat: currentVersionAgeInDays, newVersionAgeInDays (#31818)

Author: rarkins

docs/usage/configuration-options.md

@@ -2869,6 +2869,7 @@ Here are some example `matchJsonata` strings for inspiration:
 $exists(deprecationMessage)
 $exists(vulnerabilityFixVersion)
 manager = 'dockerfile' and depType = 'final'
+updateType = 'major' and newVersionAgeInDays < 7
 ```
 
 `matchJsonata` accepts an array of strings, and will return `true` if any of those JSONata expressions evaluate to `true`.

lib/config/types.ts

@@ -548,6 +548,7 @@ export interface PackageRuleInputConfig extends Record<string, unknown> {
   packageRules?: (PackageRule & PackageRuleInputConfig)[];
   releaseTimestamp?: string | null;
   repository?: string;
+  currentVersionAgeInDays?: number;
   currentVersionTimestamp?: string;
   enabled?: boolean;
   skipReason?: SkipReason;

lib/modules/manager/types.ts

@@ -99,6 +99,7 @@ export interface LookupUpdate {
   checksumUrl?: string;
   downloadUrl?: string;
   releaseTimestamp?: any;
+  newVersionAgeInDays?: number;
   registryUrl?: string;
 }
 

lib/util/date.spec.ts

@@ -22,6 +22,11 @@ describe('util/date', () => {
       const t = t0.minus({ days: 42 });
       expect(getElapsedDays(t.toISO()!)).toBe(42);
     });
+
+    it('rounds down', () => {
+      const t = t0.minus({ days: 42, hours: 12 });
+      expect(getElapsedDays(t.toISO()!)).toBe(42);
+    });
   });
 
   describe('getElapsedMinutes', () => {

lib/util/date.ts

@@ -1,12 +1,13 @@
 import { DateTime } from 'luxon';
 
 const ONE_MINUTE_MS = 60 * 1000;
-const ONE_DAY_MS = 24 * 60 * ONE_MINUTE_MS;
 
 export function getElapsedDays(timestamp: string): number {
-  return Math.floor(
-    (new Date().getTime() - new Date(timestamp).getTime()) / ONE_DAY_MS,
-  );
+  const currentVersionTimestampDate = DateTime.fromISO(timestamp);
+  const now = DateTime.now();
+  const diffInDays = now.diff(currentVersionTimestampDate, 'days').as('days');
+  const ageInDays = Math.floor(diffInDays);
+  return ageInDays;
 }
 
 export function getElapsedMinutes(date: Date): number {

lib/util/template/index.ts

@@ -156,6 +156,7 @@ export const allowedFields = {
   currentValue: 'The extracted current value of the dependency being updated',
   currentVersion:
     'The version that would be currently installed. For example, if currentValue is ^3.0.0 then currentVersion might be 3.1.0.',
+  currentVersionAgeInDays: 'The age of the current version in days',
   currentVersionTimestamp: 'The timestamp of the current version',
   currentDigest: 'The extracted current digest of the dependency being updated',
   currentDigestShort:
@@ -203,6 +204,7 @@ export const allowedFields = {
   newValue:
     'The new value in the upgrade. Can be a range or version e.g. "^3.0.0" or "3.1.0"',
   newVersion: 'The new version in the upgrade, e.g. "3.1.0"',
+  newVersionAgeInDays: 'The age of the new version in days',
   packageFile: 'The filename that the dependency was found in',
   packageFileDir:
     'The directory with full path where the packageFile was found',

lib/workers/repository/process/lookup/generate.ts

@@ -4,6 +4,7 @@ import type { Release } from '../../../../modules/datasource';
 import type { LookupUpdate } from '../../../../modules/manager/types';
 import type { VersioningApi } from '../../../../modules/versioning';
 import type { RangeStrategy } from '../../../../types';
+import { getElapsedDays } from '../../../../util/date';
 import { getMergeConfidenceLevel } from '../../../../util/merge-confidence';
 import type { LookupUpdateConfig } from './types';
 import { getUpdateType } from './update-type';
@@ -37,8 +38,9 @@ export async function generateUpdate(
     update.newDigest = release.newDigest;
   }
   // istanbul ignore if
-  if (release.releaseTimestamp !== undefined) {
+  if (release.releaseTimestamp) {
     update.releaseTimestamp = release.releaseTimestamp;
+    update.newVersionAgeInDays = getElapsedDays(release.releaseTimestamp);
   }
   // istanbul ignore if
   if (release.registryUrl !== undefined) {