@pnpm/store.path 1000.0.5

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,26 @@
+# @pnpm/store-path
+
+> Resolves the pnpm store path
+
+<!--@shields('npm')-->
+[![npm version](https://img.shields.io/npm/v/@pnpm/store-path.svg)](https://www.npmjs.com/package/@pnpm/store-path)
+<!--/@-->
+
+## Installation
+
+```sh
+<pnpm|yarn|npm> add @pnpm/store-path
+```
+
+## Usage
+
+```ts
+import resolveStorePath from '@pnpm/store-path'
+
+await resolveStorePath('F:\\project', 'pnpm-store')
+//> F:\\pnpm-store\\2
+```
+
+## License
+
+[MIT](./LICENSE)

package/lib/index.d.ts

@@ -0,0 +1,5 @@
+export declare function getStorePath({ pkgRoot, storePath, pnpmHomeDir }: {
+    pkgRoot: string;
+    storePath?: string;
+    pnpmHomeDir: string;
+}): string | Promise<string>;

package/lib/index.js

@@ -0,0 +1,104 @@
+import { promises as fs } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { STORE_VERSION } from '@pnpm/constants';
+import { PnpmError } from '@pnpm/error';
+import { rimraf } from '@zkochan/rimraf';
+import { canLink } from 'can-link';
+import { pathAbsolute } from 'path-absolute';
+import { pathTemp } from 'path-temp';
+import { rootLinkTarget } from 'root-link-target';
+import touch from 'touch';
+export function getStorePath({ pkgRoot, storePath, pnpmHomeDir, }) {
+    if (!storePath) {
+        if (!pnpmHomeDir) {
+            throw new PnpmError('NO_PNPM_HOME_DIR', 'The pnpm home directory is unknown. Cannot calculate the store directory location.');
+        }
+        return storePathRelativeToHome(pkgRoot, 'store', pnpmHomeDir);
+    }
+    if (isHomepath(storePath)) {
+        const homedir = getHomedir();
+        return storePathRelativeToHome(pkgRoot, storePath.substring(2), homedir);
+    }
+    const storeBasePath = pathAbsolute(storePath, pkgRoot);
+    if (storeBasePath.endsWith(`${path.sep}${STORE_VERSION}`)) {
+        return storeBasePath;
+    }
+    return path.join(storeBasePath, STORE_VERSION);
+}
+async function storePathRelativeToHome(pkgRoot, relStore, homedir) {
+    const tempFile = pathTemp(pkgRoot);
+    if (path.parse(pkgRoot).root !== pkgRoot)
+        await fs.mkdir(path.dirname(tempFile), { recursive: true });
+    await touch(tempFile);
+    const storeInHomeDir = path.join(homedir, relStore, STORE_VERSION);
+    if (await canLinkToSubdir(tempFile, homedir)) {
+        await fs.unlink(tempFile);
+        // If the project is on the drive on which the OS home directory
+        // then the store is placed in the home directory
+        return storeInHomeDir;
+    }
+    try {
+        let mountpoint = await rootLinkTarget(tempFile);
+        // Usually, it is disallowed to write files into the drive's root.
+        // So we create an empty directory and try to link there.
+        // The store will be a directory anyway.
+        const mountpointParent = path.join(mountpoint, '..');
+        if (!dirsAreEqual(mountpointParent, mountpoint) && await canLinkToSubdir(tempFile, mountpointParent)) {
+            mountpoint = mountpointParent;
+        }
+        // If linking works only in the project folder
+        // then prefer to place the store inside the homedir
+        if (dirsAreEqual(pkgRoot, mountpoint)) {
+            return storeInHomeDir;
+        }
+        return path.join(mountpoint, '.pnpm-store', STORE_VERSION);
+    }
+    catch {
+        // this is an unlikely situation but if there is no way to find
+        // a linkable place on the disk, create the store in homedir
+        return storeInHomeDir;
+    }
+    finally {
+        await fs.unlink(tempFile);
+    }
+}
+async function canLinkToSubdir(fileToLink, dir) {
+    let result = false;
+    const tmpDir = pathTemp(dir);
+    try {
+        await fs.mkdir(tmpDir, { recursive: true });
+        result = await canLink(fileToLink, pathTemp(tmpDir));
+    }
+    catch {
+        result = false;
+    }
+    finally {
+        await safeRmdir(tmpDir);
+    }
+    return result;
+}
+async function safeRmdir(dir) {
+    try {
+        // We cannot use just fs.rmdir here because can-link
+        // sometimes might not remove the temporary file in time
+        // and fs.rmdir can only remove an empty directory.
+        await rimraf(dir);
+    }
+    catch {
+        // ignore
+    }
+}
+function dirsAreEqual(dir1, dir2) {
+    return path.relative(dir1, dir2) === '.';
+}
+function getHomedir() {
+    const home = os.homedir();
+    if (!home)
+        throw new Error('Could not find the homedir');
+    return home;
+}
+function isHomepath(filepath) {
+    return filepath.startsWith('~/') || filepath.startsWith('~\\');
+}
+//# sourceMappingURL=index.js.map

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@pnpm/store.path",
+  "version": "1000.0.5",
+  "description": "Resolves the pnpm store path",
+  "keywords": [
+    "pnpm",
+    "pnpm11",
+    "store"
+  ],
+  "license": "MIT",
+  "funding": "https://opencollective.com/pnpm",
+  "repository": "https://github.com/pnpm/pnpm/tree/main/store/path",
+  "homepage": "https://github.com/pnpm/pnpm/tree/main/store/path#readme",
+  "bugs": {
+    "url": "https://github.com/pnpm/pnpm/issues"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js"
+  },
+  "files": [
+    "lib",
+    "!*.map"
+  ],
+  "dependencies": {
+    "@zkochan/rimraf": "^4.0.0",
+    "can-link": "^3.0.0",
+    "path-absolute": "^2.0.0",
+    "path-temp": "^3.0.0",
+    "root-link-target": "^4.0.0",
+    "touch": "3.1.0",
+    "@pnpm/error": "1000.0.5",
+    "@pnpm/constants": "1001.3.1"
+  },
+  "devDependencies": {
+    "@jest/globals": "30.0.5",
+    "@types/is-windows": "^1.0.2",
+    "@types/node": "^22.19.11",
+    "@types/touch": "^3.1.5",
+    "is-windows": "^1.0.2",
+    "rimraf": "^6.1.2",
+    "@pnpm/store.path": "1000.0.5"
+  },
+  "engines": {
+    "node": ">=22.13"
+  },
+  "jest": {
+    "preset": "@pnpm/jest-config"
+  },
+  "typings": "lib/index.d.ts",
+  "scripts": {
+    "lint": "eslint \"src/**/*.ts\" \"test/**/*.ts\"",
+    "_test": "cross-env NODE_OPTIONS=\"$NODE_OPTIONS --experimental-vm-modules --disable-warning=ExperimentalWarning --disable-warning=DEP0169\" jest",
+    "test": "pnpm run compile && pnpm run _test",
+    "compile": "tsgo --build && pnpm run lint --fix"
+  }
+}