feat: add min-release-age

This is a new config that is a way to populate the "before" config using a relative date integer.

Credit:
 @kaezone - #8802
 @PR3C14D0 - #8825

Author: wraithgar

tap-snapshots/test/lib/docs.js.test.cjs

@@ -290,7 +290,7 @@ If the requested version is a \`dist-tag\` and the given tag does not pass the
 will be used. For example, \`foo@latest\` might install \`foo@1.2\` even though
 \`latest\` is \`2.0\`.
 
-
+This config cannot be used with: \`min-release-age\`
 
 #### \`bin-links\`
 
@@ -1121,6 +1121,21 @@ Any "%s" in the message will be replaced with the version number.
 
 
 
+#### \`min-release-age\`
+
+* Default: null
+* Type: null or Number
+
+If set, npm will build the npm tree such that only versions that were
+available more than the given number of days ago will be installed. If there
+are no versions available for the current set of dependencies, the command
+will error.
+
+This flag is a complement to \`before\`, which accepts an exact date instead
+of a relative number of days.
+
+This config cannot be used with: \`before\`
+
 #### \`name\`
 
 * Default: null
@@ -2318,6 +2333,7 @@ Array [
   "name",
   "maxsockets",
   "message",
+  "min-release-age",
   "node-gyp",
   "node-options",
   "noproxy",
@@ -2474,6 +2490,7 @@ Array [
   "name",
   "maxsockets",
   "message",
+  "min-release-age",
   "node-gyp",
   "noproxy",
   "offline",
@@ -2587,7 +2604,7 @@ Object {
   "audit": true,
   "auditLevel": null,
   "authType": "web",
-  "before": null,
+  "before": 2026-02-06T17:42:04.569Z,
   "binLinks": true,
   "browser": null,
   "bypass-2fa": false,
@@ -3475,8 +3492,8 @@ Options:
 [--include <prod|dev|optional|peer> [--include <prod|dev|optional|peer> ...]]
 [--strict-peer-deps] [--prefer-dedupe] [--no-package-lock] [--package-lock-only]
 [--foreground-scripts] [--ignore-scripts] [--allow-git <all|none|root>]
-[--no-audit] [--before <date>] [--no-bin-links] [--no-fund] [--dry-run]
-[--cpu <cpu>] [--os <os>] [--libc <libc>]
+[--no-audit] [--before <date>|--min-release-age <days>] [--no-bin-links]
+[--no-fund] [--dry-run] [--cpu <cpu>] [--os <os>] [--libc <libc>]
 [-w|--workspace <workspace-name> [-w|--workspace <workspace-name> ...]]
 [--workspaces] [--include-workspace-root] [--install-links]
 
@@ -3507,6 +3524,7 @@ aliases: add, i, in, ins, inst, insta, instal, isnt, isnta, isntal, isntall
 #### \`allow-git\`
 #### \`audit\`
 #### \`before\`
+#### \`min-release-age\`
 #### \`bin-links\`
 #### \`fund\`
 #### \`dry-run\`
@@ -3578,8 +3596,8 @@ Options:
 [--include <prod|dev|optional|peer> [--include <prod|dev|optional|peer> ...]]
 [--strict-peer-deps] [--prefer-dedupe] [--no-package-lock] [--package-lock-only]
 [--foreground-scripts] [--ignore-scripts] [--allow-git <all|none|root>]
-[--no-audit] [--before <date>] [--no-bin-links] [--no-fund] [--dry-run]
-[--cpu <cpu>] [--os <os>] [--libc <libc>]
+[--no-audit] [--before <date>|--min-release-age <days>] [--no-bin-links]
+[--no-fund] [--dry-run] [--cpu <cpu>] [--os <os>] [--libc <libc>]
 [-w|--workspace <workspace-name> [-w|--workspace <workspace-name> ...]]
 [--workspaces] [--include-workspace-root] [--install-links]
 
@@ -3610,6 +3628,7 @@ alias: it
 #### \`allow-git\`
 #### \`audit\`
 #### \`before\`
+#### \`min-release-age\`
 #### \`bin-links\`
 #### \`fund\`
 #### \`dry-run\`
@@ -3858,7 +3877,7 @@ npm outdated [<package-spec> ...]
 Options:
 [-a|--all] [--json] [-l|--long] [-p|--parseable] [-g|--global]
 [-w|--workspace <workspace-name> [-w|--workspace <workspace-name> ...]]
-[--before <date>]
+[--before <date>|--min-release-age <days>]
 
 Run "npm help outdated" for more info
 
@@ -3873,6 +3892,7 @@ npm outdated [<package-spec> ...]
 #### \`global\`
 #### \`workspace\`
 #### \`before\`
+#### \`min-release-age\`
 `
 
 exports[`test/lib/docs.js TAP usage owner > must match snapshot 1`] = `
@@ -4634,8 +4654,8 @@ Options:
 [--omit <dev|optional|peer> [--omit <dev|optional|peer> ...]]
 [--include <prod|dev|optional|peer> [--include <prod|dev|optional|peer> ...]]
 [--strict-peer-deps] [--no-package-lock] [--foreground-scripts]
-[--ignore-scripts] [--no-audit] [--before <date>] [--no-bin-links] [--no-fund]
-[--dry-run]
+[--ignore-scripts] [--no-audit] [--before <date>|--min-release-age <days>]
+[--no-bin-links] [--no-fund] [--dry-run]
 [-w|--workspace <workspace-name> [-w|--workspace <workspace-name> ...]]
 [--workspaces] [--include-workspace-root] [--install-links]
 
@@ -4662,6 +4682,7 @@ aliases: up, upgrade, udpate
 #### \`ignore-scripts\`
 #### \`audit\`
 #### \`before\`
+#### \`min-release-age\`
 #### \`bin-links\`
 #### \`fund\`
 #### \`dry-run\`

workspaces/config/lib/definitions/definitions.js

@@ -246,6 +246,7 @@ const definitions = {
     default: null,
     hint: '<date>',
     type: [null, Date],
+    exclusive: ['min-release-age'],
     description: `
       If passed to \`npm install\`, will rebuild the npm tree such that only
       versions that were available **on or before** the given date are
@@ -1347,6 +1348,26 @@ const definitions = {
     `,
     flatten,
   }),
+  'min-release-age': new Definition('min-release-age', {
+    default: null,
+    hint: '<days>',
+    type: [null, Number],
+    exclusive: ['before'],
+    description: `
+       If set, npm will build the npm tree such that only versions that were
+       available more than the given number of days ago will be installed.  If
+       there are no versions available for the current set of dependencies, the
+       command will error.
+
+       This flag is a complement to \`before\`, which accepts an exact date
+       instead of a relative number of days.
+    `,
+    flatten: (key, obj, flatOptions) => {
+      flatOptions.before = new Date(Date.now() + (86400000 * obj['min-release-age']))
+      obj.before = flatOptions.before
+      delete obj['min-release-age']
+    }
+  }),
   'node-gyp': new Definition('node-gyp', {
     default: (() => {
       try {

workspaces/config/tap-snapshots/test/type-description.js.test.cjs

@@ -340,6 +340,10 @@ Object {
   "message": Array [
     Function String(),
   ],
+  "min-release-age": Array [
+    null,
+    "numeric value",
+  ],
   "name": Array [
     null,
     Function String(),