add npm cache npx command and fix stale-version reuse in npx

[owlstronaut]

#7838

• deps: @npmcli/[email protected]
• feat: add context to npx cache package.json
• feat(cache): add npx commands
• fix: update npx cache if possible when spec is a range
• added tests for new npx functionality

References

[wraithgar]

We are going to be rebase/merging this so I have renamed this PR to NOT be a conventional message, that way our linter will warn us about commits that don't pass conventional commit linting.

[owlstronaut]

@wraithgar I'm going to need help getting to this codepath in the unit tests, haven't been able to pull the right strings

[wraithgar]

we need a version of the package that is in the npx cache that is older than the latest version as specified by the requested range.

So: [email protected] in the cache, npx pkg@1 is requested, [email protected] exists. It should prompt/update to 1.0.1

[owlstronaut]

@wraithgar Hmm. Do I have my setup wrong?

What I'm seeing is that this is called first in the exec (missingFromTree not called with npx)

I'm trying to use

  const { fixtures, package } = createPkg({
    localVersion: '1.0.0',
    versions: ['1.0.0', '1.0.1'],
    name: '@npmcli/create-index',
  })
  ...
  await exec({
    args: ['@npmcli/create-index@^1.0.0'],
  })

But the exec first calls the misingFromTree function without isNpxTree

  const { manifest, node } = await missingFromTree({ spec, tree: localTree, flatOptions })
  if (manifest) {
    // Package does not exist in the local tree
    needInstall.push({ spec, manifest })
    ...
  }

which means this is satisfied (the first run doesn't have isNpxTree set and the semver tecnically satisfies, so no manifest returned)

 if (!isNpxTree && semver.satisfies(node.package.version, spec.rawSpec)) {
   return { node }
 }

So the exec command can never get in to the branch that calls missingFromTree with the isNpxTree: true because the needInstall never gets the push.

if (needInstall.length > 0) {
  ...
  await Promise.all(needInstall.map(async ({ spec }) => {
  const { manifest } = await missingFromTree({
    spec,
    tree: npxTree,
    flatOptions,
    isNpxTree: true,
  })
  ...
}