@pnpm/global.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/README.md

@@ -0,0 +1,151 @@
+# @pnpm/global.commands
+
+Command handlers for pnpm's global package management (`pnpm add -g`, `pnpm remove -g`, `pnpm update -g`, `pnpm list -g`).
+
+## Architecture: Isolated Global Packages
+
+Unlike npm, where all global packages share a single `node_modules/` directory, pnpm installs each global package (or group of packages installed together) into its own **isolated installation directory**. This prevents global packages from interfering with each other through peer dependency conflicts, hoisting changes, or version resolution shifts.
+
+### Directory layout
+
+All global package data lives under `{pnpmHomeDir}/global/v11/` (the "global package directory", referred to as `globalPkgDir` in the code). The layout is:
+
+```
+{pnpmHomeDir}/global/v11/
+  {hash-1}          -> symlink to {pid}-{timestamp-1}/   (hash symlink)
+  {pid}-{timestamp-1}/                                    (install dir)
+    package.json
+    node_modules/
+      .pnpm/
+      {pkg-a}/
+      {pkg-b}/
+    pnpm-lock.yaml
+  {hash-2}          -> symlink to {pid}-{timestamp-2}/
+  {pid}-{timestamp-2}/
+    package.json
+    node_modules/
+      .pnpm/
+      {pkg-c}/
+    pnpm-lock.yaml
+```
+
+Each install group has two entries:
+
+1. **Install directory** (`{pid}-{timestamp}`): A regular directory containing a complete pnpm project with its own `package.json`, `node_modules/`, and lockfile. Named with the process ID and timestamp at creation time to avoid collisions.
+
+2. **Hash symlink** (`{hash}`): A symbolic link named with a deterministic hash of the package aliases and registries. Points to the install directory. This serves as the lookup key for finding where a set of packages is installed.
+
+The hash is computed from the sorted list of package aliases and sorted registry URLs, making it deterministic for a given set of packages.
+
+### How each command works
+
+#### `pnpm add -g <pkg> [pkg2 ...]`
+
+Handled by `handleGlobalAdd()`:
+
+1. Clean up orphaned install directories (those not referenced by any hash symlink).
+2. Create a new install directory `{pid}-{timestamp}`.
+3. Run `installGlobalPackages()` to install the requested packages into this directory using `@pnpm/core`'s `mutateModulesInSingleProject()`.
+4. Read the resolved aliases from the resulting `package.json` (this is more reliable than parsing aliases from CLI params, which may be tarballs, git URLs, etc.).
+5. Check for bin name conflicts with existing global packages via `checkGlobalBinConflicts()`.
+6. Remove any existing global installations of the same aliases.
+7. Create a hash symlink pointing to the new install directory.
+8. Link bins from the installed packages into the global bin directory.
+
+#### `pnpm remove -g <pkg> [pkg2 ...]`
+
+Handled by `handleGlobalRemove()`:
+
+1. Look up each requested package alias to find its install group (via `findGlobalPackage()`).
+2. For each affected group: remove all bin shims, delete the hash symlink, and delete the install directory.
+
+#### `pnpm update -g [pkg ...]`
+
+Handled by `handleGlobalUpdate()`:
+
+1. Scan all existing global packages.
+2. Filter to groups containing the requested packages (or all groups if no args).
+3. For each group:
+   - Create a new install directory.
+   - Re-install the same packages (at `--latest` versions if the `--latest` flag is set, or within existing ranges otherwise).
+   - Check for bin conflicts, remove old bins, swap the hash symlink to point to the new directory, clean up the old directory, and link new bins.
+
+#### `pnpm list -g [pattern ...]`
+
+Handled by `listGlobalPackages()`:
+
+1. Scan all global packages.
+2. Read package details (alias, version) from each install group's `node_modules/`.
+3. Filter by glob patterns if provided (via `@pnpm/matcher`).
+4. Sort and display.
+
+### `installGlobalPackages()` — the core install function
+
+This is a focused ~30-line function that replaces the 450-line `installDeps()` from `plugin-commands-installation`. Global installs don't need workspace logic, recursive installs, update matching, rebuild orchestration, or any of the other complexity in `installDeps()`. The function does exactly:
+
+1. Create a store controller.
+2. Read (or create) a manifest for the install directory.
+3. Call `mutateModulesInSingleProject()` with `mutation: 'installSome'`.
+4. Write the updated manifest.
+
+### Bin conflict detection
+
+`checkGlobalBinConflicts()` prevents a common footgun: installing a global package whose binaries would shadow binaries from a different globally-installed package. Before any bin linking happens, it:
+
+1. Collects bin names from the packages about to be installed.
+2. Checks if any of those bin names already exist in the global bin directory.
+3. If they do, verifies whether they belong to a package being replaced (ok) or to a different package (error).
+
+### Orphan cleanup
+
+`cleanOrphanedInstallDirs()` (from `@pnpm/global.packages`) runs at the start of `add` and `update` to remove install directories that are no longer referenced by any hash symlink. This handles cases where a previous install was interrupted or crashed. A 5-minute safety window prevents cleaning up directories from concurrent installs that haven't created their hash symlink yet.
+
+## Package structure
+
+```
+global/
+  commands/           @pnpm/global.commands (this package)
+    src/
+      globalAdd.ts          handleGlobalAdd()
+      globalRemove.ts       handleGlobalRemove()
+      globalUpdate.ts       handleGlobalUpdate()
+      listGlobalPackages.ts listGlobalPackages()
+      installGlobalPackages.ts  core install function
+      checkGlobalBinConflicts.ts  bin conflict detection
+      readInstalledPackages.ts    shared helper
+      index.ts
+  packages/           @pnpm/global.packages
+    src/
+      scanGlobalPackages.ts   directory scanning, package lookup
+      globalPackageDir.ts     install dir / hash link management
+      cacheKey.ts             deterministic hash computation
+      index.ts
+```
+
+`@pnpm/global.packages` provides the low-level utilities for reading and managing the directory structure. `@pnpm/global.commands` provides the high-level command handlers that orchestrate installs, removals, updates, and listing.
+
+## Integration points
+
+The CLI command handlers in `plugin-commands-installation` and `plugin-commands-listing` delegate to this package with a simple early return:
+
+```typescript
+// In add.ts handler:
+if (opts.global) {
+  return handleGlobalAdd(opts, params)
+}
+
+// In remove.ts handler:
+if (opts.global) {
+  return handleGlobalRemove(opts, params)
+}
+
+// In update/index.ts handler:
+if (opts.global) {
+  return handleGlobalUpdate(opts, params)
+}
+
+// In list.ts handler:
+if (opts.global && opts.globalPkgDir) {
+  return listGlobalPackages(opts.globalPkgDir, params)
+}
+```

package/lib/checkGlobalBinConflicts.d.ts

@@ -0,0 +1,11 @@
+import { type GlobalPackageInfo } from '@pnpm/global.packages';
+import { type DependencyManifest } from '@pnpm/types';
+export declare function checkGlobalBinConflicts(opts: {
+    globalDir: string;
+    globalBinDir: string;
+    newPkgs: Array<{
+        manifest: DependencyManifest;
+        location: string;
+    }>;
+    shouldSkip: (pkg: GlobalPackageInfo) => boolean;
+}): Promise<void>;

package/lib/checkGlobalBinConflicts.js

@@ -0,0 +1,44 @@
+import fs from 'fs';
+import path from 'path';
+import { scanGlobalPackages, } from '@pnpm/global.packages';
+import { PnpmError } from '@pnpm/error';
+import { getBinsFromPackageManifest } from '@pnpm/package-bins';
+import { safeReadPackageJsonFromDir } from '@pnpm/read-package-json';
+export async function checkGlobalBinConflicts(opts) {
+    const newBinNames = new Set();
+    await Promise.all(opts.newPkgs.map(async (pkg) => {
+        const bins = await getBinsFromPackageManifest(pkg.manifest, pkg.location);
+        for (const bin of bins) {
+            newBinNames.add(bin.name);
+        }
+    }));
+    if (newBinNames.size === 0)
+        return;
+    // Quick check: only investigate if a bin with the same name already exists
+    const conflicting = [...newBinNames].filter((name) => fs.existsSync(path.join(opts.globalBinDir, name)));
+    if (conflicting.length === 0)
+        return;
+    // Some bins already exist — find out if they belong to packages being replaced
+    // (in which case it's fine) or to other packages (conflict).
+    const existingPackages = scanGlobalPackages(opts.globalDir);
+    for (const existingPkg of existingPackages) {
+        if (opts.shouldSkip(existingPkg))
+            continue;
+        const modulesDir = path.join(existingPkg.installDir, 'node_modules');
+        for (const alias of Object.keys(existingPkg.dependencies)) {
+            const depDir = path.join(modulesDir, alias);
+            const manifest = await safeReadPackageJsonFromDir(depDir); // eslint-disable-line no-await-in-loop
+            if (!manifest)
+                continue;
+            const bins = await getBinsFromPackageManifest(manifest, depDir); // eslint-disable-line no-await-in-loop
+            for (const bin of bins) {
+                if (conflicting.includes(bin.name)) {
+                    throw new PnpmError('GLOBAL_BIN_CONFLICT', `Cannot install: binary "${bin.name}" would conflict with package "${alias}" that is already installed globally`, {
+                        hint: `Remove the conflicting package first: pnpm remove -g ${alias}`,
+                    });
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=checkGlobalBinConflicts.js.map

package/lib/checkGlobalBinConflicts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkGlobalBinConflicts.js","sourceRoot":"","sources":["../src/checkGlobalBinConflicts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAA;AACnB,OAAO,IAAI,MAAM,MAAM,CAAA;AACvB,OAAO,EACL,kBAAkB,GAEnB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAA;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAA;AAGpE,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAE,IAK9C,EAAiB;IAChB,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAA;IACrC,MAAM,OAAO,CAAC,GAAG,CACf,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,MAAM,0BAA0B,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAA;QACzE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC3B,CAAC;IAAA,CACF,CAAC,CACH,CAAA;IACD,IAAI,WAAW,CAAC,IAAI,KAAK,CAAC;QAAE,OAAM;IAElC,2EAA2E;IAC3E,MAAM,WAAW,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC,MAAM,CACzC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAC5D,CAAA;IACD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAEpC,iFAA+E;IAC/E,6DAA6D;IAC7D,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAC3D,KAAK,MAAM,WAAW,IAAI,gBAAgB,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;YAAE,SAAQ;QAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,cAAc,CAAC,CAAA;QACpE,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,EAAE,CAAC;YAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;YAC3C,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC,MAAM,CAAC,CAAA,CAAC,uCAAuC;YACjG,IAAI,CAAC,QAAQ;gBAAE,SAAQ;YACvB,MAAM,IAAI,GAAG,MAAM,0BAA0B,CAAC,QAA8B,EAAE,MAAM,CAAC,CAAA,CAAC,uCAAuC;YAC7H,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,IAAI,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnC,MAAM,IAAI,SAAS,CACjB,qBAAqB,EACrB,2BAA2B,GAAG,CAAC,IAAI,kCAAkC,KAAK,sCAAsC,EAChH;wBACE,IAAI,EAAE,wDAAwD,KAAK,EAAE;qBACtE,CACF,CAAA;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;AAAA,CACF"}

package/lib/globalAdd.d.ts

@@ -0,0 +1,21 @@
+import { type CreateStoreControllerOptions } from '@pnpm/store-connection-manager';
+export type GlobalAddOptions = CreateStoreControllerOptions & {
+    bin?: string;
+    globalPkgDir?: string;
+    registries: Record<string, string>;
+    allowBuild?: string[];
+    allowBuilds?: Record<string, string | boolean>;
+    saveExact?: boolean;
+    savePrefix?: string;
+    supportedArchitectures?: {
+        libc?: string[];
+    };
+    rootProjectManifest?: {
+        pnpm?: {
+            supportedArchitectures?: {
+                libc?: string[];
+            };
+        };
+    };
+};
+export declare function handleGlobalAdd(opts: GlobalAddOptions, params: string[]): Promise<void>;

package/lib/globalAdd.js

@@ -0,0 +1,128 @@
+import fs from 'fs';
+import path from 'path';
+import { cleanOrphanedInstallDirs, createGlobalCacheKey, createInstallDir, findGlobalPackage, getHashLink, getInstalledBinNames, } from '@pnpm/global.packages';
+import { linkBinsOfPackages } from '@pnpm/link-bins';
+import { removeBin } from '@pnpm/remove-bins';
+import { readPackageJsonFromDirRawSync } from '@pnpm/read-package-json';
+import isSubdir from 'is-subdir';
+import symlinkDir from 'symlink-dir';
+import { approveBuilds } from '@pnpm/exec.build-commands';
+import { installGlobalPackages } from './installGlobalPackages.js';
+import { checkGlobalBinConflicts } from './checkGlobalBinConflicts.js';
+import { readInstalledPackages } from './readInstalledPackages.js';
+export async function handleGlobalAdd(opts, params) {
+    const globalDir = opts.globalPkgDir;
+    const globalBinDir = opts.bin;
+    cleanOrphanedInstallDirs(globalDir);
+    // Install into a new directory first, then read the resolved aliases
+    // from the resulting package.json. This is more reliable than parsing
+    // aliases from CLI params (which may be tarballs, git URLs, etc.).
+    const installDir = createInstallDir(globalDir);
+    // Convert allowBuild array to allowBuilds Record (same conversion as add.handler)
+    let allowBuilds = opts.allowBuilds ?? {};
+    if (opts.allowBuild?.length) {
+        allowBuilds = { ...allowBuilds };
+        for (const pkg of opts.allowBuild) {
+            allowBuilds[pkg] = true;
+        }
+    }
+    const include = {
+        dependencies: true,
+        devDependencies: false,
+        optionalDependencies: true,
+    };
+    const fetchFullMetadata = (opts.supportedArchitectures?.libc ?? opts.rootProjectManifest?.pnpm?.supportedArchitectures?.libc) && true;
+    const makeInstallOpts = (dir, builds) => ({
+        ...opts,
+        global: false,
+        bin: path.join(dir, 'node_modules/.bin'),
+        dir,
+        lockfileDir: dir,
+        rootProjectManifestDir: dir,
+        rootProjectManifest: undefined,
+        saveProd: true,
+        saveDev: false,
+        saveOptional: false,
+        savePeer: false,
+        workspaceDir: undefined,
+        sharedWorkspaceLockfile: false,
+        lockfileOnly: false,
+        fetchFullMetadata,
+        include,
+        includeDirect: include,
+        allowBuilds: builds,
+    });
+    const ignoredBuilds = await installGlobalPackages(makeInstallOpts(installDir, allowBuilds), params);
+    // If any packages had their builds skipped, prompt the user to approve them
+    // (reuses the same interactive flow as `pnpm approve-builds`)
+    if (ignoredBuilds?.size && process.stdin.isTTY) {
+        await approveBuilds.handler({
+            ...opts,
+            modulesDir: path.join(installDir, 'node_modules'),
+            dir: installDir,
+            lockfileDir: installDir,
+            rootProjectManifest: undefined,
+            rootProjectManifestDir: installDir,
+            workspaceDir: opts.globalPkgDir,
+            global: false,
+            pending: false,
+            allowBuilds,
+        });
+    }
+    // Read resolved aliases from the installed package.json
+    const pkgJson = readPackageJsonFromDirRawSync(installDir);
+    const aliases = Object.keys(pkgJson.dependencies ?? {});
+    // Check for bin name conflicts with other global packages
+    // (must happen before removeExistingGlobalInstalls so we don't lose existing packages on failure)
+    const pkgs = await readInstalledPackages(installDir);
+    try {
+        await checkGlobalBinConflicts({
+            globalDir,
+            globalBinDir,
+            newPkgs: pkgs,
+            shouldSkip: (pkg) => aliases.some((alias) => alias in pkg.dependencies),
+        });
+    }
+    catch (err) {
+        await fs.promises.rm(installDir, { recursive: true, force: true });
+        throw err;
+    }
+    // Remove any existing global installations of these aliases
+    await removeExistingGlobalInstalls(globalDir, globalBinDir, aliases);
+    // Compute cache key and create hash symlink pointing to install dir
+    const cacheHash = createGlobalCacheKey({
+        aliases,
+        registries: opts.registries,
+    });
+    const hashLink = getHashLink(globalDir, cacheHash);
+    await symlinkDir(installDir, hashLink, { overwrite: true });
+    // Link bins from installed packages into global bin dir
+    await linkBinsOfPackages(pkgs, globalBinDir);
+}
+async function removeExistingGlobalInstalls(globalDir, globalBinDir, aliases) {
+    // Collect unique groups to remove (dedup by hash)
+    const groupsToRemove = new Map();
+    for (const alias of aliases) {
+        const existing = findGlobalPackage(globalDir, alias);
+        if (existing && !groupsToRemove.has(existing.hash)) {
+            groupsToRemove.set(existing.hash, getInstalledBinNames(existing));
+        }
+    }
+    // Remove all groups in parallel
+    await Promise.all([...groupsToRemove.entries()].map(async ([hash, binNamesPromise]) => {
+        const binNames = await binNamesPromise;
+        await Promise.all(binNames.map((binName) => removeBin(path.join(globalBinDir, binName))));
+        // Remove both the hash symlink and the install dir it points to
+        const hashLink = getHashLink(globalDir, hash);
+        let installDir = null;
+        try {
+            installDir = fs.realpathSync(hashLink);
+        }
+        catch { }
+        await fs.promises.rm(hashLink, { force: true });
+        if (installDir && isSubdir(globalDir, installDir)) {
+            await fs.promises.rm(installDir, { recursive: true, force: true });
+        }
+    }));
+}
+//# sourceMappingURL=globalAdd.js.map

package/lib/globalAdd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalAdd.js","sourceRoot":"","sources":["../src/globalAdd.ts"],"names":[],"mappings":"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"}

package/lib/globalRemove.d.ts

@@ -0,0 +1,4 @@
+export declare function handleGlobalRemove(opts: {
+    globalPkgDir?: string;
+    bin?: string;
+}, params: string[]): Promise<void>;

package/lib/globalRemove.js

@@ -0,0 +1,29 @@
+import fs from 'fs';
+import path from 'path';
+import { PnpmError } from '@pnpm/error';
+import { findGlobalPackage, getHashLink, getInstalledBinNames, } from '@pnpm/global.packages';
+import { removeBin } from '@pnpm/remove-bins';
+import isSubdir from 'is-subdir';
+export async function handleGlobalRemove(opts, params) {
+    const globalDir = opts.globalPkgDir;
+    const globalBinDir = opts.bin;
+    // Find all groups that contain the packages to remove (dedup by hash)
+    const groupsToRemove = new Map();
+    for (const param of params) {
+        const pkg = findGlobalPackage(globalDir, param);
+        if (!pkg) {
+            throw new PnpmError('GLOBAL_PKG_NOT_FOUND', `Cannot remove '${param}': not found in global packages`);
+        }
+        groupsToRemove.set(pkg.hash, pkg);
+    }
+    // Remove bins, hash symlinks, and install dirs for all affected groups in parallel
+    await Promise.all([...groupsToRemove.entries()].map(async ([hash, pkg]) => {
+        const binNames = await getInstalledBinNames(pkg);
+        await Promise.all(binNames.map((binName) => removeBin(path.join(globalBinDir, binName))));
+        await fs.promises.rm(getHashLink(globalDir, hash), { force: true });
+        if (isSubdir(globalDir, pkg.installDir)) {
+            await fs.promises.rm(pkg.installDir, { recursive: true, force: true });
+        }
+    }));
+}
+//# sourceMappingURL=globalRemove.js.map

package/lib/globalRemove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalRemove.js","sourceRoot":"","sources":["../src/globalRemove.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAA;AACnB,OAAO,IAAI,MAAM,MAAM,CAAA;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,oBAAoB,GAErB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7C,OAAO,QAAQ,MAAM,WAAW,CAAA;AAEhC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAGC,EACD,MAAgB,EACD;IACf,MAAM,SAAS,GAAG,IAAI,CAAC,YAAa,CAAA;IACpC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAI,CAAA;IAE9B,sEAAsE;IACtE,MAAM,cAAc,GAAG,IAAI,GAAG,EAA6B,CAAA;IAC3D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;QAC/C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,SAAS,CAAC,sBAAsB,EAAE,kBAAkB,KAAK,iCAAiC,CAAC,CAAA;QACvG,CAAC;QACD,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IACnC,CAAC;IAED,mFAAmF;IACnF,MAAM,OAAO,CAAC,GAAG,CACf,CAAC,GAAG,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;QACvD,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,GAAG,CAAC,CAAA;QAChD,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;QACzF,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QACnE,IAAI,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACxC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QACxE,CAAC;IAAA,CACF,CAAC,CACH,CAAA;AAAA,CACF"}

package/lib/globalUpdate.d.ts

@@ -0,0 +1,20 @@
+import { type CreateStoreControllerOptions } from '@pnpm/store-connection-manager';
+export type GlobalUpdateOptions = CreateStoreControllerOptions & {
+    bin?: string;
+    globalPkgDir?: string;
+    latest?: boolean;
+    allowBuilds?: Record<string, string | boolean>;
+    saveExact?: boolean;
+    savePrefix?: string;
+    supportedArchitectures?: {
+        libc?: string[];
+    };
+    rootProjectManifest?: {
+        pnpm?: {
+            supportedArchitectures?: {
+                libc?: string[];
+            };
+        };
+    };
+};
+export declare function handleGlobalUpdate(opts: GlobalUpdateOptions, params: string[]): Promise<string | undefined>;

package/lib/globalUpdate.js

@@ -0,0 +1,112 @@
+import fs from 'fs';
+import path from 'path';
+import { cleanOrphanedInstallDirs, createInstallDir, getHashLink, getInstalledBinNames, scanGlobalPackages, } from '@pnpm/global.packages';
+import { linkBinsOfPackages } from '@pnpm/link-bins';
+import { removeBin } from '@pnpm/remove-bins';
+import isSubdir from 'is-subdir';
+import symlinkDir from 'symlink-dir';
+import { approveBuilds } from '@pnpm/exec.build-commands';
+import { installGlobalPackages } from './installGlobalPackages.js';
+import { checkGlobalBinConflicts } from './checkGlobalBinConflicts.js';
+import { readInstalledPackages } from './readInstalledPackages.js';
+export async function handleGlobalUpdate(opts, params) {
+    const globalDir = opts.globalPkgDir;
+    const globalBinDir = opts.bin;
+    cleanOrphanedInstallDirs(globalDir);
+    const allPackages = scanGlobalPackages(globalDir);
+    if (allPackages.length === 0) {
+        return 'No global packages found';
+    }
+    // If specific packages are requested, filter to only groups containing them
+    let packagesToUpdate;
+    if (params.length > 0) {
+        packagesToUpdate = allPackages.filter((pkg) => params.some((p) => p in pkg.dependencies));
+        if (packagesToUpdate.length === 0) {
+            return 'No matching global packages found';
+        }
+    }
+    else {
+        packagesToUpdate = allPackages;
+    }
+    // Update each package group sequentially to avoid overwhelming the system
+    for (const pkg of packagesToUpdate) {
+        await updateGlobalPackageGroup(opts, globalDir, globalBinDir, pkg); // eslint-disable-line no-await-in-loop
+    }
+    return undefined;
+}
+async function updateGlobalPackageGroup(opts, globalDir, globalBinDir, pkg) {
+    const installDir = createInstallDir(globalDir);
+    // When --latest, just pass alias names to get the latest version.
+    // Otherwise, pass alias@spec to update within the existing range.
+    const depSpecs = Object.entries(pkg.dependencies).map(([alias, spec]) => opts.latest ? alias : `${alias}@${spec}`);
+    const include = {
+        dependencies: true,
+        devDependencies: false,
+        optionalDependencies: true,
+    };
+    const fetchFullMetadata = (opts.supportedArchitectures?.libc ?? opts.rootProjectManifest?.pnpm?.supportedArchitectures?.libc) && true;
+    const allowBuilds = opts.allowBuilds ?? {};
+    const ignoredBuilds = await installGlobalPackages({
+        ...opts,
+        global: false,
+        bin: path.join(installDir, 'node_modules/.bin'),
+        dir: installDir,
+        lockfileDir: installDir,
+        rootProjectManifestDir: installDir,
+        rootProjectManifest: undefined,
+        saveProd: true,
+        saveDev: false,
+        saveOptional: false,
+        savePeer: false,
+        workspaceDir: undefined,
+        sharedWorkspaceLockfile: false,
+        lockfileOnly: false,
+        fetchFullMetadata,
+        include,
+        includeDirect: include,
+        allowBuilds,
+    }, depSpecs);
+    // If any packages had their builds skipped, prompt the user to approve them
+    // (reuses the same interactive flow as `pnpm approve-builds`)
+    if (ignoredBuilds?.size && process.stdin.isTTY) {
+        await approveBuilds.handler({
+            ...opts,
+            modulesDir: path.join(installDir, 'node_modules'),
+            dir: installDir,
+            lockfileDir: installDir,
+            rootProjectManifest: undefined,
+            rootProjectManifestDir: installDir,
+            workspaceDir: opts.globalPkgDir,
+            global: false,
+            pending: false,
+            allowBuilds,
+        });
+    }
+    // Check for bin name conflicts with other global packages
+    const pkgs = await readInstalledPackages(installDir);
+    try {
+        await checkGlobalBinConflicts({
+            globalDir,
+            globalBinDir,
+            newPkgs: pkgs,
+            shouldSkip: (existingPkg) => existingPkg.hash === pkg.hash,
+        });
+    }
+    catch (err) {
+        await fs.promises.rm(installDir, { recursive: true, force: true });
+        throw err;
+    }
+    // Remove stale bins from old installation before swapping
+    const oldBinNames = await getInstalledBinNames(pkg);
+    await Promise.all(oldBinNames.map((binName) => removeBin(path.join(globalBinDir, binName))));
+    // Swap hash symlink to new install dir, then clean up old one
+    const hashLink = getHashLink(globalDir, pkg.hash);
+    const oldInstallDir = pkg.installDir;
+    await symlinkDir(installDir, hashLink, { overwrite: true });
+    if (isSubdir(globalDir, oldInstallDir)) {
+        await fs.promises.rm(oldInstallDir, { recursive: true, force: true });
+    }
+    // Link bins from new installation
+    await linkBinsOfPackages(pkgs, globalBinDir);
+}
+//# sourceMappingURL=globalUpdate.js.map

package/lib/globalUpdate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalUpdate.js","sourceRoot":"","sources":["../src/globalUpdate.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -0,0 +1,6 @@
+export { handleGlobalAdd, type GlobalAddOptions } from './globalAdd.js';
+export { handleGlobalRemove } from './globalRemove.js';
+export { handleGlobalUpdate, type GlobalUpdateOptions } from './globalUpdate.js';
+export { checkGlobalBinConflicts } from './checkGlobalBinConflicts.js';
+export { listGlobalPackages } from './listGlobalPackages.js';
+export { installGlobalPackages, type InstallGlobalPackagesOptions } from './installGlobalPackages.js';

package/lib/index.js

@@ -0,0 +1,7 @@
+export { handleGlobalAdd } from './globalAdd.js';
+export { handleGlobalRemove } from './globalRemove.js';
+export { handleGlobalUpdate } from './globalUpdate.js';
+export { checkGlobalBinConflicts } from './checkGlobalBinConflicts.js';
+export { listGlobalPackages } from './listGlobalPackages.js';
+export { installGlobalPackages } from './installGlobalPackages.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAyB,MAAM,gBAAgB,CAAA;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAA4B,MAAM,mBAAmB,CAAA;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAE,qBAAqB,EAAqC,MAAM,4BAA4B,CAAA"}

package/lib/installGlobalPackages.d.ts

@@ -0,0 +1,24 @@
+import { type CreateStoreControllerOptions } from '@pnpm/store-connection-manager';
+import { type IgnoredBuilds, type IncludedDependencies } from '@pnpm/types';
+export interface InstallGlobalPackagesOptions extends CreateStoreControllerOptions {
+    bin: string;
+    dir: string;
+    global?: boolean;
+    lockfileDir: string;
+    lockfileOnly?: boolean;
+    allowBuilds?: Record<string, string | boolean>;
+    include: IncludedDependencies;
+    includeDirect?: IncludedDependencies;
+    fetchFullMetadata?: boolean;
+    rootProjectManifest?: unknown;
+    rootProjectManifestDir?: string;
+    saveDev?: boolean;
+    saveExact?: boolean;
+    saveOptional?: boolean;
+    savePeer?: boolean;
+    savePrefix?: string;
+    saveProd?: boolean;
+    sharedWorkspaceLockfile?: boolean;
+    workspaceDir?: string;
+}
+export declare function installGlobalPackages(opts: InstallGlobalPackagesOptions, params: string[]): Promise<IgnoredBuilds | undefined>;

package/lib/installGlobalPackages.js

@@ -0,0 +1,34 @@
+import { tryReadProjectManifest } from '@pnpm/cli-utils';
+import { getOptionsFromRootManifest } from '@pnpm/config';
+import { mutateModulesInSingleProject } from '@pnpm/core';
+import { createStoreController } from '@pnpm/store-connection-manager';
+export async function installGlobalPackages(opts, params) {
+    const store = await createStoreController(opts);
+    let { manifest, writeProjectManifest } = await tryReadProjectManifest(opts.dir, opts);
+    if (manifest == null) {
+        manifest = {};
+    }
+    const rootManifestOpts = getOptionsFromRootManifest(opts.dir, manifest);
+    const installOpts = {
+        ...opts,
+        ...rootManifestOpts,
+        allowBuilds: { ...rootManifestOpts.allowBuilds, ...opts.allowBuilds },
+        storeController: store.ctrl,
+        storeDir: store.dir,
+    };
+    const pinnedVersion = opts.saveExact ? 'patch' : (opts.savePrefix === '~' ? 'minor' : 'major');
+    const { updatedProject, ignoredBuilds } = await mutateModulesInSingleProject({
+        allowNew: true,
+        binsDir: opts.bin,
+        dependencySelectors: params,
+        manifest,
+        mutation: 'installSome',
+        peer: false,
+        pinnedVersion,
+        rootDir: opts.dir,
+        targetDependenciesField: 'dependencies',
+    }, installOpts);
+    await writeProjectManifest(updatedProject.manifest);
+    return ignoredBuilds;
+}
+//# sourceMappingURL=installGlobalPackages.js.map

package/lib/installGlobalPackages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installGlobalPackages.js","sourceRoot":"","sources":["../src/installGlobalPackages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAA;AACzD,OAAO,EAAE,qBAAqB,EAAqC,MAAM,gCAAgC,CAAA;AAyBzG,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,IAAkC,EAClC,MAAgB,EACoB;IACpC,MAAM,KAAK,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAA;IAC/C,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IACrF,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QACrB,QAAQ,GAAG,EAAE,CAAA;IACf,CAAC;IACD,MAAM,gBAAgB,GAAG,0BAA0B,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;IACvE,MAAM,WAAW,GAAG;QAClB,GAAG,IAAI;QACP,GAAG,gBAAgB;QACnB,WAAW,EAAE,EAAE,GAAG,gBAAgB,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE;QACrE,eAAe,EAAE,KAAK,CAAC,IAAI;QAC3B,QAAQ,EAAE,KAAK,CAAC,GAAG;KACpB,CAAA;IACD,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IAC9F,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,GAAG,MAAM,4BAA4B,CAC1E;QACE,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,IAAI,CAAC,GAAG;QACjB,mBAAmB,EAAE,MAAM;QAC3B,QAAQ;QACR,QAAQ,EAAE,aAAsB;QAChC,IAAI,EAAE,KAAK;QACX,aAAa;QACb,OAAO,EAAE,IAAI,CAAC,GAAqB;QACnC,uBAAuB,EAAE,cAAuB;KACjD,EACD,WAAW,CACZ,CAAA;IACD,MAAM,oBAAoB,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAA;IACnD,OAAO,aAAa,CAAA;AAAA,CACrB"}

package/lib/listGlobalPackages.d.ts

@@ -0,0 +1 @@
+export declare function listGlobalPackages(globalPkgDir: string, params: string[]): Promise<string>;

package/lib/listGlobalPackages.js

@@ -0,0 +1,22 @@
+import { scanGlobalPackages, getGlobalPackageDetails, } from '@pnpm/global.packages';
+import { createMatcher } from '@pnpm/matcher';
+import { lexCompare } from '@pnpm/util.lex-comparator';
+export async function listGlobalPackages(globalPkgDir, params) {
+    const packages = scanGlobalPackages(globalPkgDir);
+    const allDetails = await Promise.all(packages.map((pkg) => getGlobalPackageDetails(pkg)));
+    const matches = params.length > 0 ? createMatcher(params) : () => true;
+    const lines = [];
+    for (const installed of allDetails.flat()) {
+        if (!matches(installed.alias))
+            continue;
+        lines.push(`${installed.alias}@${installed.version}`);
+    }
+    if (lines.length === 0) {
+        return params.length > 0
+            ? 'No matching global packages found'
+            : 'No global packages found';
+    }
+    lines.sort(lexCompare);
+    return lines.join('\n');
+}
+//# sourceMappingURL=listGlobalPackages.js.map

package/lib/listGlobalPackages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listGlobalPackages.js","sourceRoot":"","sources":["../src/listGlobalPackages.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAEtD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAE,YAAoB,EAAE,MAAgB,EAAmB;IACjG,MAAM,QAAQ,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAA;IACjD,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACzF,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAA;IACtE,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1C,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC;YAAE,SAAQ;QACvC,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC,CAAA;IACvD,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC;YACtB,CAAC,CAAC,mCAAmC;YACrC,CAAC,CAAC,0BAA0B,CAAA;IAChC,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACtB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAAA,CACxB"}

package/lib/readInstalledPackages.d.ts

@@ -0,0 +1,5 @@
+import { type DependencyManifest } from '@pnpm/types';
+export declare function readInstalledPackages(installDir: string): Promise<Array<{
+    manifest: DependencyManifest;
+    location: string;
+}>>;

package/lib/readInstalledPackages.js

@@ -0,0 +1,12 @@
+import path from 'path';
+import { readPackageJsonFromDir, readPackageJsonFromDirRawSync } from '@pnpm/read-package-json';
+export async function readInstalledPackages(installDir) {
+    const pkgJson = readPackageJsonFromDirRawSync(installDir);
+    const depNames = Object.keys(pkgJson.dependencies ?? {});
+    const manifests = await Promise.all(depNames.map((depName) => readPackageJsonFromDir(path.join(installDir, 'node_modules', depName))));
+    return depNames.map((depName, i) => ({
+        manifest: manifests[i],
+        location: path.join(installDir, 'node_modules', depName),
+    }));
+}
+//# sourceMappingURL=readInstalledPackages.js.map

package/lib/readInstalledPackages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readInstalledPackages.js","sourceRoot":"","sources":["../src/readInstalledPackages.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAA;AACvB,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAA;AAG/F,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAE,UAAkB,EAAsE;IACnI,MAAM,OAAO,GAAG,6BAA6B,CAAC,UAAU,CAAC,CAAA;IACzD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAA;IACxD,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC,CAClG,CAAA;IACD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACnC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAuB;QAC5C,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,CAAC;KACzD,CAAC,CAAC,CAAA;AAAA,CACJ"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@pnpm/global.commands",
+  "version": "1000.0.0-0",
+  "description": "Global package command handlers for pnpm",
+  "keywords": [
+    "pnpm",
+    "pnpm11",
+    "global"
+  ],
+  "license": "MIT",
+  "funding": "https://opencollective.com/pnpm",
+  "repository": "https://github.com/pnpm/pnpm/tree/main/global/commands",
+  "homepage": "https://github.com/pnpm/pnpm/tree/main/global/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": {
+    "@pnpm/util.lex-comparator": "^3.0.2",
+    "is-subdir": "^1.2.0",
+    "symlink-dir": "^7.0.0",
+    "@pnpm/cli-utils": "1001.2.8",
+    "@pnpm/core": "1012.0.1",
+    "@pnpm/error": "1000.0.5",
+    "@pnpm/exec.build-commands": "1001.0.33",
+    "@pnpm/global.packages": "1000.0.0-0",
+    "@pnpm/config": "1004.4.2",
+    "@pnpm/matcher": "1000.1.0",
+    "@pnpm/package-bins": "1000.0.11",
+    "@pnpm/read-package-json": "1000.1.2",
+    "@pnpm/remove-bins": "1000.0.15",
+    "@pnpm/store-connection-manager": "1002.2.4",
+    "@pnpm/types": "1000.9.0",
+    "@pnpm/link-bins": "1000.2.6"
+  },
+  "devDependencies": {
+    "@pnpm/global.commands": "1000.0.0-0"
+  },
+  "engines": {
+    "node": ">=22.13"
+  },
+  "jest": {
+    "preset": "@pnpm/jest-config"
+  },
+  "scripts": {
+    "lint": "eslint \"src/**/*.ts\"",
+    "compile": "tsgo --build && pnpm run lint --fix",
+    "test": "pnpm run compile"
+  }
+}