@pnpm/fetching.binary-fetcher 1000.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-2025 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,13 @@
+# @pnpm/fetching.binary-fetcher
+
+> A fetcher for binary archives
+
+## Installation
+
+```
+pnpm add @pnpm/fetching.binary-fetcher
+```
+
+## License
+
+MIT

package/lib/index.d.ts

@@ -0,0 +1,24 @@
+import { type FetchFromRegistry } from '@pnpm/fetching-types';
+import { type BinaryFetcher, type FetchFunction } from '@pnpm/fetcher-base';
+export declare function createBinaryFetcher(ctx: {
+    fetch: FetchFromRegistry;
+    fetchFromRemoteTarball: FetchFunction;
+    rawConfig: Record<string, string>;
+    offline?: boolean;
+}): {
+    binary: BinaryFetcher;
+};
+export interface AssetInfo {
+    url: string;
+    integrity: string;
+    basename: string;
+}
+/**
+ * Downloads and unpacks a zip file containing a binary asset.
+ *
+ * @param fetchFromRegistry - Function to fetch resources from registry
+ * @param assetInfo - Information about the binary asset
+ * @param targetDir - Directory where the binary asset should be installed
+ * @throws {PnpmError} When integrity verification fails or extraction fails
+ */
+export declare function downloadAndUnpackZip(fetchFromRegistry: FetchFromRegistry, assetInfo: AssetInfo, targetDir: string): Promise<void>;

package/lib/index.js

@@ -0,0 +1,122 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBinaryFetcher = createBinaryFetcher;
+exports.downloadAndUnpackZip = downloadAndUnpackZip;
+const path_1 = __importDefault(require("path"));
+const promises_1 = __importDefault(require("fs/promises"));
+const error_1 = require("@pnpm/error");
+const worker_1 = require("@pnpm/worker");
+const adm_zip_1 = __importDefault(require("adm-zip"));
+const rename_overwrite_1 = __importDefault(require("rename-overwrite"));
+const tempy_1 = __importDefault(require("tempy"));
+const ssri_1 = __importDefault(require("ssri"));
+function createBinaryFetcher(ctx) {
+    const fetchBinary = async (cafs, resolution, opts) => {
+        if (ctx.offline) {
+            throw new error_1.PnpmError('CANNOT_DOWNLOAD_BINARY_OFFLINE', `Cannot download binary "${resolution.url}" because offline mode is enabled.`);
+        }
+        const version = opts.pkg.version;
+        const manifest = {
+            name: opts.pkg.name,
+            version,
+            bin: resolution.bin,
+        };
+        if (resolution.archive === 'tarball') {
+            return {
+                ...await ctx.fetchFromRemoteTarball(cafs, {
+                    tarball: resolution.url,
+                    integrity: resolution.integrity,
+                }, opts),
+                manifest,
+            };
+        }
+        if (resolution.archive === 'zip') {
+            const tempLocation = await cafs.tempDir();
+            await downloadAndUnpackZip(ctx.fetch, {
+                url: resolution.url,
+                integrity: resolution.integrity,
+                basename: resolution.prefix ?? '',
+            }, tempLocation);
+            return {
+                ...await (0, worker_1.addFilesFromDir)({
+                    storeDir: cafs.storeDir,
+                    dir: tempLocation,
+                    filesIndexFile: opts.filesIndexFile,
+                    readManifest: false,
+                }),
+                manifest,
+            };
+        }
+        throw new error_1.PnpmError('NOT_SUPPORTED_ARCHIVE', `The binary fetcher doesn't support archive type ${resolution.archive}`);
+    };
+    return {
+        binary: fetchBinary,
+    };
+}
+/**
+ * Downloads and unpacks a zip file containing a binary asset.
+ *
+ * @param fetchFromRegistry - Function to fetch resources from registry
+ * @param assetInfo - Information about the binary asset
+ * @param targetDir - Directory where the binary asset should be installed
+ * @throws {PnpmError} When integrity verification fails or extraction fails
+ */
+async function downloadAndUnpackZip(fetchFromRegistry, assetInfo, targetDir) {
+    const tmp = path_1.default.join(tempy_1.default.directory(), 'pnpm.zip');
+    try {
+        await downloadWithIntegrityCheck(fetchFromRegistry, assetInfo, tmp);
+        await extractZipToTarget(tmp, assetInfo.basename, targetDir);
+    }
+    finally {
+        // Clean up temporary file
+        try {
+            await promises_1.default.unlink(tmp);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    }
+}
+/**
+ * Downloads a file with integrity verification.
+ */
+async function downloadWithIntegrityCheck(fetchFromRegistry, { url, integrity }, tmpPath) {
+    const response = await fetchFromRegistry(url);
+    // Collect all chunks from the response
+    const chunks = [];
+    for await (const chunk of response.body) {
+        chunks.push(chunk);
+    }
+    const data = Buffer.concat(chunks);
+    try {
+        // Verify integrity if provided
+        ssri_1.default.checkData(data, integrity, { error: true });
+    }
+    catch (err) {
+        if (!(err instanceof Error) || !('expected' in err) || !('found' in err)) {
+            throw err;
+        }
+        throw new error_1.PnpmError('TARBALL_INTEGRITY', `Got unexpected checksum for "${url}". Wanted "${err.expected}". Got "${err.found}".`);
+    }
+    // Write the verified data to file
+    await promises_1.default.writeFile(tmpPath, data);
+}
+/**
+ * Extracts a zip file to the target directory.
+ *
+ * @param zipPath - Path to the zip file
+ * @param basename - Base name of the file (without extension)
+ * @param targetDir - Directory where contents should be extracted
+ * @throws {PnpmError} When extraction fails
+ */
+async function extractZipToTarget(zipPath, basename, targetDir) {
+    const zip = new adm_zip_1.default(zipPath);
+    const nodeDir = basename === '' ? targetDir : path_1.default.dirname(targetDir);
+    const extractedDir = path_1.default.join(nodeDir, basename);
+    zip.extractAllTo(nodeDir, true);
+    await (0, rename_overwrite_1.default)(extractedDir, targetDir);
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@pnpm/fetching.binary-fetcher",
+  "version": "1000.0.0",
+  "description": "A fetcher for binary archives",
+  "keywords": [
+    "pnpm",
+    "pnpm10"
+  ],
+  "license": "MIT",
+  "funding": "https://opencollective.com/pnpm",
+  "repository": "https://github.com/pnpm/pnpm/blob/main/fetching/binary-fetcher",
+  "homepage": "https://github.com/pnpm/pnpm/blob/main/fetching/binary-fetcher#readme",
+  "bugs": {
+    "url": "https://github.com/pnpm/pnpm/issues"
+  },
+  "type": "commonjs",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": "./lib/index.js"
+  },
+  "files": [
+    "lib",
+    "!*.map"
+  ],
+  "dependencies": {
+    "adm-zip": "^0.5.16",
+    "rename-overwrite": "^6.0.2",
+    "ssri": "10.0.5",
+    "tempy": "^1.0.1",
+    "@pnpm/error": "1000.0.4",
+    "@pnpm/fetching-types": "1000.2.0",
+    "@pnpm/worker": "1000.1.11",
+    "@pnpm/fetcher-base": "1001.0.0"
+  },
+  "devDependencies": {
+    "@types/adm-zip": "^0.5.7",
+    "@types/ssri": "^7.1.5",
+    "@pnpm/fetching.binary-fetcher": "1000.0.0"
+  },
+  "engines": {
+    "node": ">=18.12"
+  },
+  "jest": {
+    "preset": "@pnpm/jest-config"
+  },
+  "scripts": {
+    "lint": "eslint \"src/**/*.ts\"",
+    "test": "pnpm run compile",
+    "compile": "tsc --build && pnpm run lint --fix"
+  }
+}