@pnpm/engine.runtime.commands 1000.0.0-0

package/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015-2016 Rico Sta. Cruz and other contributors
+Copyright (c) 2016-2026 Zoltan Kochan and other contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/lib/env/env.d.ts

@@ -0,0 +1,9 @@
+import type { NvmNodeCommandOptions } from './node.js';
+export declare const skipPackageManagerCheck = true;
+export declare function rcOptionsTypes(): Record<string, unknown>;
+export declare function cliOptionsTypes(): Record<string, unknown>;
+export declare const commandNames: string[];
+export declare function help(): string;
+export declare function handler(opts: NvmNodeCommandOptions, params: string[]): Promise<string | {
+    exitCode: number;
+} | void>;

package/lib/env/env.js

@@ -0,0 +1,87 @@
+import { docsUrl } from '@pnpm/cli.utils';
+import { PnpmError } from '@pnpm/error';
+import { renderHelp } from 'render-help';
+import { envList } from './envList.js';
+import { envUse } from './envUse.js';
+export const skipPackageManagerCheck = true;
+export function rcOptionsTypes() {
+    return {};
+}
+export function cliOptionsTypes() {
+    return {
+        global: Boolean,
+        remote: Boolean,
+    };
+}
+export const commandNames = ['env'];
+export function help() {
+    return renderHelp({
+        description: 'Manage Node.js versions.',
+        descriptionLists: [
+            {
+                title: 'Commands',
+                list: [
+                    {
+                        description: 'Installs the specified version of Node.js. The npm CLI bundled with the given Node.js version gets installed as well. This sets this version of Node.js as the current version.',
+                        name: 'use',
+                    },
+                    {
+                        description: 'List remote Node.js versions available to install.',
+                        name: 'list',
+                        shortAlias: 'ls',
+                    },
+                ],
+            },
+            {
+                title: 'Options',
+                list: [
+                    {
+                        description: 'Manages Node.js versions globally',
+                        name: '--global',
+                        shortAlias: '-g',
+                    },
+                ],
+            },
+        ],
+        url: docsUrl('env'),
+        usages: [
+            'pnpm env use --global 18',
+            'pnpm env use --global lts',
+            'pnpm env use --global argon',
+            'pnpm env use --global latest',
+            'pnpm env use --global rc/18',
+            'pnpm env list',
+            'pnpm env list 18',
+            'pnpm env list lts',
+            'pnpm env list argon',
+            'pnpm env list latest',
+            'pnpm env list rc/18',
+        ],
+    });
+}
+export async function handler(opts, params) {
+    if (params.length === 0) {
+        throw new PnpmError('ENV_NO_SUBCOMMAND', 'Please specify the subcommand', {
+            hint: help(),
+        });
+    }
+    if (opts.global && !opts.bin) {
+        throw new PnpmError('CANNOT_MANAGE_NODE', 'Unable to manage Node.js because pnpm was not installed using the standalone installation script', {
+            hint: 'If you want to manage Node.js with pnpm, you need to remove any Node.js that was installed by other tools, then install pnpm using one of the standalone scripts that are provided on the installation page: https://pnpm.io/installation',
+        });
+    }
+    switch (params[0]) {
+        case 'use': {
+            await envUse(opts, params.slice(1));
+            return;
+        }
+        case 'list':
+        case 'ls': {
+            return envList(opts, params.slice(1));
+        }
+        default: {
+            throw new PnpmError('ENV_UNKNOWN_SUBCOMMAND', 'This subcommand is not known');
+        }
+    }
+}
+//# sourceMappingURL=env.js.map

package/lib/env/envList.d.ts

@@ -0,0 +1,2 @@
+import type { NvmNodeCommandOptions } from './node.js';
+export declare function envList(opts: NvmNodeCommandOptions, params: string[]): Promise<string>;

package/lib/env/envList.js

@@ -0,0 +1,14 @@
+import { getNodeMirror, parseNodeSpecifier, resolveNodeVersions } from '@pnpm/engine.runtime.node-resolver';
+import { createFetchFromRegistry } from '@pnpm/network.fetch';
+export async function envList(opts, params) {
+    const nodeVersionList = await listRemoteVersions(opts, params[0]);
+    // Make the newest version located at the end of the output
+    return nodeVersionList.reverse().join('\n');
+}
+async function listRemoteVersions(opts, versionSpec) {
+    const fetch = createFetchFromRegistry(opts);
+    const { releaseChannel, versionSpecifier } = versionSpec ? parseNodeSpecifier(versionSpec) : { releaseChannel: 'release', versionSpecifier: '' };
+    const nodeMirrorBaseUrl = getNodeMirror(opts.rawConfig, releaseChannel);
+    return resolveNodeVersions(fetch, versionSpecifier, nodeMirrorBaseUrl);
+}
+//# sourceMappingURL=envList.js.map

package/lib/env/envUse.d.ts

@@ -0,0 +1,2 @@
+import type { NvmNodeCommandOptions } from './node.js';
+export declare function envUse(opts: NvmNodeCommandOptions, params: string[]): Promise<void>;

package/lib/env/envUse.js

@@ -0,0 +1,22 @@
+import { PnpmError } from '@pnpm/error';
+import { runPnpmCli } from '@pnpm/exec.pnpm-cli-runner';
+import { globalWarn } from '@pnpm/logger';
+export async function envUse(opts, params) {
+    globalWarn('"pnpm env use" is deprecated. Use "pnpm runtime set node <version> -g" instead.');
+    if (!opts.global) {
+        throw new PnpmError('NOT_IMPLEMENTED_YET', '"pnpm env use <version>" can only be used with the "--global" option currently');
+    }
+    const version = params[0]?.trim();
+    if (!version) {
+        throw new PnpmError('MISSING_NODE_VERSION', '"pnpm env use --global <version>" requires a Node.js version to be specified');
+    }
+    const args = ['add', '--global', `node@runtime:${version}`];
+    if (opts.bin)
+        args.push('--global-bin-dir', opts.bin);
+    if (opts.storeDir)
+        args.push('--store-dir', opts.storeDir);
+    if (opts.cacheDir)
+        args.push('--cache-dir', opts.cacheDir);
+    runPnpmCli(args, { cwd: opts.pnpmHomeDir });
+}
+//# sourceMappingURL=envUse.js.map

package/lib/env/index.d.ts

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

package/lib/env/index.js

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

package/lib/env/node.d.ts

@@ -0,0 +1,4 @@
+import type { Config } from '@pnpm/config.reader';
+export type NvmNodeCommandOptions = Pick<Config, 'bin' | 'global' | 'fetchRetries' | 'fetchRetryFactor' | 'fetchRetryMaxtimeout' | 'fetchRetryMintimeout' | 'fetchTimeout' | 'userAgent' | 'ca' | 'cert' | 'httpProxy' | 'httpsProxy' | 'key' | 'localAddress' | 'noProxy' | 'rawConfig' | 'strictSsl' | 'storeDir' | 'pnpmHomeDir'> & Partial<Pick<Config, 'cacheDir' | 'configDir' | 'cliOptions' | 'sslConfigs' | 'registries' | 'rawLocalConfig' | 'lockfileDir' | 'nodeLinker' | 'modulesDir' | 'symlink' | 'frozenLockfile' | 'preferFrozenLockfile' | 'sideEffectsCache' | 'sideEffectsCacheReadonly' | 'supportedArchitectures'>> & {
+    remote?: boolean;
+};

package/lib/env/node.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=node.js.map

package/lib/env/utils.d.ts

@@ -0,0 +1,2 @@
+export declare function getNodeExecPathInBinDir(pnpmHomeDir: string): string;
+export declare function getNodeExecPathInNodeDir(nodeDir: string): string;

package/lib/env/utils.js

@@ -0,0 +1,8 @@
+import path from 'node:path';
+export function getNodeExecPathInBinDir(pnpmHomeDir) {
+    return path.resolve(pnpmHomeDir, process.platform === 'win32' ? 'node.exe' : 'node');
+}
+export function getNodeExecPathInNodeDir(nodeDir) {
+    return path.join(nodeDir, process.platform === 'win32' ? 'node.exe' : 'bin/node');
+}
+//# sourceMappingURL=utils.js.map

package/lib/index.d.ts

@@ -0,0 +1,2 @@
+export { env } from './env/index.js';
+export { runtime } from './runtime/index.js';

package/lib/index.js

@@ -0,0 +1,3 @@
+export { env } from './env/index.js';
+export { runtime } from './runtime/index.js';
+//# sourceMappingURL=index.js.map

package/lib/runtime/index.d.ts

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

package/lib/runtime/index.js

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

package/lib/runtime/runtime.d.ts

@@ -0,0 +1,8 @@
+import type { Config } from '@pnpm/config.reader';
+export type RuntimeCommandOptions = Pick<Config, 'bin' | 'dir' | 'global' | 'pnpmHomeDir'> & Partial<Pick<Config, 'storeDir' | 'cacheDir'>>;
+export declare const skipPackageManagerCheck = true;
+export declare function rcOptionsTypes(): Record<string, unknown>;
+export declare function cliOptionsTypes(): Record<string, unknown>;
+export declare const commandNames: string[];
+export declare function help(): string;
+export declare function handler(opts: RuntimeCommandOptions, params: string[]): Promise<void>;

package/lib/runtime/runtime.js

@@ -0,0 +1,85 @@
+import { docsUrl } from '@pnpm/cli.utils';
+import { PnpmError } from '@pnpm/error';
+import { runPnpmCli } from '@pnpm/exec.pnpm-cli-runner';
+import { renderHelp } from 'render-help';
+export const skipPackageManagerCheck = true;
+export function rcOptionsTypes() {
+    return {};
+}
+export function cliOptionsTypes() {
+    return {
+        global: Boolean,
+    };
+}
+export const commandNames = ['runtime', 'rt'];
+export function help() {
+    return renderHelp({
+        description: 'Manage runtimes.',
+        descriptionLists: [
+            {
+                title: 'Commands',
+                list: [
+                    {
+                        description: 'Installs the specified version of a runtime (e.g. node, deno, bun).',
+                        name: 'set',
+                    },
+                ],
+            },
+            {
+                title: 'Options',
+                list: [
+                    {
+                        description: 'Installs the runtime globally',
+                        name: '--global',
+                        shortAlias: '-g',
+                    },
+                ],
+            },
+        ],
+        url: docsUrl('runtime'),
+        usages: [
+            'pnpm runtime set node 22 -g',
+            'pnpm runtime set node lts -g',
+            'pnpm runtime set node rc/22 -g',
+            'pnpm runtime set deno 2 -g',
+            'pnpm runtime set bun latest -g',
+        ],
+    });
+}
+export async function handler(opts, params) {
+    if (params.length === 0) {
+        throw new PnpmError('RUNTIME_NO_SUBCOMMAND', 'Please specify the subcommand', {
+            hint: help(),
+        });
+    }
+    switch (params[0]) {
+        case 'set': {
+            runtimeSet(opts, params.slice(1));
+            return;
+        }
+        default: {
+            throw new PnpmError('RUNTIME_UNKNOWN_SUBCOMMAND', `Unknown subcommand: ${params[0]}`, {
+                hint: help(),
+            });
+        }
+    }
+}
+function runtimeSet(opts, params) {
+    const runtimeName = params[0]?.trim();
+    if (!runtimeName) {
+        throw new PnpmError('MISSING_RUNTIME_NAME', '"pnpm runtime set <name> <version>" requires a runtime name (e.g. node, deno, bun)');
+    }
+    const versionSpec = params[1]?.trim();
+    const args = ['add', `${runtimeName}@runtime:${versionSpec ?? ''}`];
+    if (opts.global) {
+        args.push('--global');
+        if (opts.bin)
+            args.push('--global-bin-dir', opts.bin);
+    }
+    if (opts.storeDir)
+        args.push('--store-dir', opts.storeDir);
+    if (opts.cacheDir)
+        args.push('--cache-dir', opts.cacheDir);
+    runPnpmCli(args, { cwd: opts.global ? opts.pnpmHomeDir : opts.dir });
+}
+//# sourceMappingURL=runtime.js.map

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@pnpm/engine.runtime.commands",
+  "version": "1000.0.0-0",
+  "description": "pnpm commands for managing runtimes",
+  "keywords": [
+    "pnpm",
+    "pnpm11",
+    "runtime"
+  ],
+  "license": "MIT",
+  "funding": "https://opencollective.com/pnpm",
+  "repository": "https://github.com/pnpm/pnpm/tree/main/engine/runtime/commands",
+  "homepage": "https://github.com/pnpm/pnpm/tree/main/engine/runtime/commands#readme",
+  "bugs": {
+    "url": "https://github.com/pnpm/pnpm/issues"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": "./lib/index.js"
+  },
+  "files": [
+    "lib",
+    "!*.map"
+  ],
+  "dependencies": {
+    "render-help": "^2.0.0",
+    "@pnpm/cli.utils": "1001.2.8",
+    "@pnpm/error": "1000.0.5",
+    "@pnpm/network.fetch": "1000.2.6",
+    "@pnpm/exec.pnpm-cli-runner": "1000.0.1",
+    "@pnpm/config.reader": "1004.4.2",
+    "@pnpm/engine.runtime.node-resolver": "1001.0.5"
+  },
+  "peerDependencies": {
+    "@pnpm/logger": ">=1001.0.0 <1002.0.0"
+  },
+  "devDependencies": {
+    "@jest/globals": "30.0.5",
+    "cross-env": "^10.1.0",
+    "@pnpm/engine.runtime.commands": "1000.0.0-0",
+    "@pnpm/logger": "1001.0.1"
+  },
+  "engines": {
+    "node": ">=22.13"
+  },
+  "jest": {
+    "preset": "@pnpm/jest-config"
+  },
+  "scripts": {
+    "lint": "eslint \"src/**/*.ts\" \"test/**/*.ts\"",
+    "_test": "cross-env NODE_OPTIONS=\"$NODE_OPTIONS --experimental-vm-modules --disable-warning=ExperimentalWarning --disable-warning=DEP0169\" jest",
+    "compile": "tsgo --build && pnpm run lint --fix",
+    "test": "pnpm run compile && pnpm run _test"
+  }
+}