@pnpm/engine.pm.commands 1100.0.0 → 1101.0.0

package/lib/index.d.ts

@@ -1,3 +1,4 @@
 export { selfUpdate } from './self-updater/index.js';
 export { installPnpm, installPnpmToStore, linkExePlatformBinary } from './self-updater/installPnpm.js';
 export { setup } from './setup/index.js';
+export { withCmd } from './with/index.js';

package/lib/index.js

@@ -1,4 +1,5 @@
 export { selfUpdate } from './self-updater/index.js';
 export { installPnpm, installPnpmToStore, linkExePlatformBinary } from './self-updater/installPnpm.js';
 export { setup } from './setup/index.js';
+export { withCmd } from './with/index.js';
 //# sourceMappingURL=index.js.map

package/lib/self-updater/installPnpm.d.ts

@@ -1,6 +1,6 @@
 import { type GlobalAddOptions } from '@pnpm/global.commands';
 import type { EnvLockfile } from '@pnpm/lockfile.types';
-import type { StoreController } from '@pnpm/store.controller';
+import { type StoreController } from '@pnpm/store.controller';
 import type { Registries } from '@pnpm/types';
 export interface InstallPnpmResult {
     binDir: string;

package/lib/self-updater/installPnpm.js

@@ -8,6 +8,7 @@ import { iterateHashedGraphNodes, iteratePkgMeta, lockfileToDepGraph, } from '@p
 import { installGlobalPackages } from '@pnpm/global.commands';
 import { cleanOrphanedInstallDirs, createGlobalCacheKey, createInstallDir, findGlobalPackage, getHashLink, } from '@pnpm/global.packages';
 import { headlessInstall } from '@pnpm/installing.deps-restorer';
+import { registerProject } from '@pnpm/store.controller';
 import { symlinkDir } from 'symlink-dir';
 // @pnpm/exe has platform-specific binaries, so its GVS hash must
 // include ENGINE_NAME for correct per-platform resolution.
@@ -123,6 +124,11 @@ async function installPnpmToGlobalDir(opts, pkgName, version, wantedLockfile) {
                 virtualStoreDirMaxLength: opts.virtualStoreDirMaxLength,
                 packageManager: opts.packageManager,
             });
+            // headlessInstall does not register the project, so we must do it
+            // explicitly. Without this, `pnpm store prune` would not know about
+            // this install directory and would remove its packages from the
+            // global virtual store.
+            await registerProject(opts.storeDir, installDir);
         }
         else {
             await installFromResolution(installDir, opts, [`${pkgName}@${version}`]);

package/lib/self-updater/selfUpdate.d.ts

@@ -5,5 +5,5 @@ export declare function cliOptionsTypes(): Record<string, unknown>;
 export declare const commandNames: string[];
 export declare const skipPackageManagerCheck = true;
 export declare function help(): string;
-export type SelfUpdateCommandOptions = CreateStoreControllerOptions & Pick<Config, 'globalPkgDir' | 'lockfileDir' | 'managePackageManagerVersions' | 'modulesDir' | 'pnpmHomeDir'> & Pick<ConfigContext, 'rootProjectManifestDir' | 'wantedPackageManager'>;
+export type SelfUpdateCommandOptions = CreateStoreControllerOptions & Pick<Config, 'globalPkgDir' | 'lockfileDir' | 'modulesDir' | 'pnpmHomeDir'> & Pick<ConfigContext, 'rootProjectManifestDir' | 'wantedPackageManager'>;
 export declare function handler(opts: SelfUpdateCommandOptions, params: string[]): Promise<undefined | string>;

package/lib/with/index.d.ts

@@ -0,0 +1,2 @@
+import * as withCmd from './with.js';
+export { withCmd };

package/lib/with/index.js

@@ -0,0 +1,3 @@
+import * as withCmd from './with.js';
+export { withCmd };
+//# sourceMappingURL=index.js.map

package/lib/with/with.d.ts

@@ -0,0 +1,11 @@
+import { type Config, type ConfigContext } from '@pnpm/config.reader';
+import { type CreateStoreControllerOptions } from '@pnpm/store.connection-manager';
+export declare const commandNames: string[];
+export declare const skipPackageManagerCheck = true;
+export declare const rcOptionsTypes: typeof cliOptionsTypes;
+export declare function cliOptionsTypes(): Record<string, unknown>;
+export declare function help(): string;
+export type WithCommandOptions = CreateStoreControllerOptions & Pick<Config, 'dir' | 'lockfileDir' | 'pnpmHomeDir' | 'virtualStoreDirMaxLength'> & Pick<ConfigContext, 'rootProjectManifestDir'>;
+export declare function handler(opts: WithCommandOptions, params: string[]): Promise<{
+    exitCode: number;
+}>;

package/lib/with/with.js

@@ -0,0 +1,101 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { isExecutedByCorepack, packageManager } from '@pnpm/cli.meta';
+import { docsUrl } from '@pnpm/cli.utils';
+import { types as allTypes } from '@pnpm/config.reader';
+import { PnpmError } from '@pnpm/error';
+import { resolvePackageManagerIntegrities } from '@pnpm/installing.env-installer';
+import { prependDirsToPath } from '@pnpm/shell.path';
+import { createStoreController } from '@pnpm/store.connection-manager';
+import crossSpawn from 'cross-spawn';
+import { pick } from 'ramda';
+import { renderHelp } from 'render-help';
+import { installPnpmToStore } from '../self-updater/installPnpm.js';
+export const commandNames = ['with'];
+export const skipPackageManagerCheck = true;
+export const rcOptionsTypes = cliOptionsTypes;
+export function cliOptionsTypes() {
+    return pick([], allTypes);
+}
+export function help() {
+    return renderHelp({
+        description: 'Run pnpm with a specific version (or the currently running one), ignoring the "packageManager" and "devEngines.packageManager" fields of the project manifest.',
+        descriptionLists: [],
+        url: docsUrl('with'),
+        usages: [
+            'pnpm with current <pnpm args>',
+            'pnpm with <version> <pnpm args>',
+            'pnpm with next install',
+            'pnpm with 10 install',
+        ],
+    });
+}
+export async function handler(opts, params) {
+    if (params.length === 0) {
+        throw new PnpmError('MISSING_WITH_SPEC', 'Missing version argument. Usage: pnpm with <version|current> <args...>');
+    }
+    if (isExecutedByCorepack()) {
+        throw new PnpmError('CANT_USE_WITH_IN_COREPACK', 'The "pnpm with" command does not work under corepack');
+    }
+    // `with current` is handled earlier in parseCliArgs.ts, which re-parses it
+    // for in-process execution, so this handler only ever sees version/dist-tag specs.
+    const [spec, ...args] = params;
+    fs.mkdirSync(opts.pnpmHomeDir, { recursive: true });
+    const store = await createStoreController(opts);
+    let binDir;
+    try {
+        // resolvePackageManagerIntegrities resolves ranges/dist-tags via the
+        // registry and writes the resolved exact version to the envLockfile.
+        const envLockfile = await resolvePackageManagerIntegrities(spec, {
+            rootDir: opts.pnpmHomeDir,
+            registries: opts.registries,
+            storeController: store.ctrl,
+            storeDir: store.dir,
+        });
+        const resolvedVersion = envLockfile.importers['.'].packageManagerDependencies?.['pnpm']?.version;
+        if (!resolvedVersion) {
+            throw new PnpmError('CANNOT_RESOLVE_PNPM', `Cannot resolve pnpm version for "${spec}"`);
+        }
+        ;
+        ({ binDir } = await installPnpmToStore(resolvedVersion, {
+            envLockfile,
+            storeController: store.ctrl,
+            storeDir: store.dir,
+            registries: opts.registries,
+            virtualStoreDirMaxLength: opts.virtualStoreDirMaxLength,
+            packageManager: { name: packageManager.name, version: packageManager.version },
+        }));
+    }
+    finally {
+        await store.ctrl.close();
+    }
+    // The child pnpm must skip the packageManager/devEngines check so the requested
+    // version stays active. Two keys are set for backward compatibility:
+    //   - `COREPACK_ROOT` is honored by every pnpm release that supports corepack
+    //     (older versions skip the pm check whenever this is set).
+    //   - `pnpm_config_pm_on_fail=ignore` is the principled override recognized
+    //     by pnpm releases that ship the `pmOnFail` setting.
+    const pnpmEnv = prependDirsToPath([binDir]);
+    const spawnEnv = {
+        ...process.env,
+        [pnpmEnv.name]: pnpmEnv.value,
+        COREPACK_ROOT: process.env.COREPACK_ROOT ?? 'pnpm-with',
+        pnpm_config_pm_on_fail: 'ignore',
+    };
+    const pnpmBinPath = path.join(binDir, 'pnpm');
+    const { status, signal, error } = crossSpawn.sync(pnpmBinPath, args, {
+        stdio: 'inherit',
+        env: spawnEnv,
+    });
+    if (error)
+        throw error;
+    if (signal) {
+        // Best-effort: try to terminate with the same signal the child received.
+        // If the signal is handled or ignored, fall back to a non-zero exit code
+        // so the caller doesn't mistake an interrupted run for a successful one.
+        process.kill(process.pid, signal);
+        return { exitCode: 1 };
+    }
+    return { exitCode: status ?? 0 };
+}
+//# sourceMappingURL=with.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnpm/engine.pm.commands",
-  "version": "1100.0.0",
+  "version": "1101.0.0",
   "description": "pnpm commands for self-updating and setting up pnpm",
   "keywords": [
     "pnpm",
@@ -25,29 +25,31 @@
   ],
   "dependencies": {
     "@pnpm/os.env.path-extender": "^3.0.0",
+    "cross-spawn": "^7.0.6",
     "path-name": "^1.0.0",
     "ramda": "npm:@pnpm/ramda@0.28.1",
     "render-help": "^2.0.0",
     "semver": "^7.7.2",
     "symlink-dir": "^10.0.1",
-    "@pnpm/bins.linker": "1100.0.0",
-    "@pnpm/building.policy": "1100.0.0",
-    "@pnpm/cli.meta": "1100.0.0",
-    "@pnpm/cli.utils": "1100.0.0",
-    "@pnpm/config.reader": "1100.0.0",
-    "@pnpm/deps.graph-hasher": "1100.0.0",
-    "@pnpm/global.commands": "1100.0.0",
+    "@pnpm/building.policy": "1100.0.1",
+    "@pnpm/bins.linker": "1100.0.2",
+    "@pnpm/cli.meta": "1100.0.1",
+    "@pnpm/cli.utils": "1101.0.0",
+    "@pnpm/config.reader": "1101.0.0",
+    "@pnpm/deps.graph-hasher": "1100.0.1",
     "@pnpm/error": "1100.0.0",
-    "@pnpm/installing.client": "1100.0.0",
-    "@pnpm/installing.deps-restorer": "1100.0.0",
-    "@pnpm/installing.env-installer": "1100.0.0",
-    "@pnpm/global.packages": "1100.0.0",
-    "@pnpm/lockfile.types": "1100.0.0",
-    "@pnpm/store.connection-manager": "1100.0.0",
-    "@pnpm/types": "1100.0.0",
-    "@pnpm/store.controller": "1100.0.0",
-    "@pnpm/workspace.project-manifest-reader": "1100.0.0",
-    "@pnpm/resolving.npm-resolver": "1100.0.0"
+    "@pnpm/installing.client": "1100.0.2",
+    "@pnpm/global.commands": "1100.0.2",
+    "@pnpm/global.packages": "1100.0.1",
+    "@pnpm/installing.deps-restorer": "1100.0.2",
+    "@pnpm/installing.env-installer": "1100.1.0",
+    "@pnpm/lockfile.types": "1100.0.1",
+    "@pnpm/shell.path": "1100.0.0",
+    "@pnpm/resolving.npm-resolver": "1100.0.1",
+    "@pnpm/store.connection-manager": "1100.0.2",
+    "@pnpm/store.controller": "1100.0.1",
+    "@pnpm/types": "1101.0.0",
+    "@pnpm/workspace.project-manifest-reader": "1100.0.2"
   },
   "peerDependencies": {
     "@pnpm/logger": ">=1001.0.0 <1002.0.0"
@@ -57,13 +59,12 @@
     "@types/cross-spawn": "^6.0.6",
     "@types/ramda": "0.31.1",
     "@types/semver": "7.7.1",
-    "cross-spawn": "^7.0.6",
-    "@pnpm/logger": "1100.0.0",
-    "@pnpm/engine.pm.commands": "1100.0.0",
-    "@pnpm/prepare": "1100.0.0",
+    "@pnpm/constants": "1100.0.0",
     "@pnpm/error": "1100.0.0",
-    "@pnpm/shell.path": "1100.0.0",
-    "@pnpm/testing.mock-agent": "1100.0.0"
+    "@pnpm/logger": "1100.0.0",
+    "@pnpm/engine.pm.commands": "1101.0.0",
+    "@pnpm/prepare": "1100.0.1",
+    "@pnpm/testing.mock-agent": "1100.0.1"
   },
   "engines": {
     "node": ">=22.13"