@metamask-previews/foundryup 0.0.0-preview-c1fef6e5

package/dist/extract.mjs

@@ -0,0 +1,180 @@
+import { ok } from "node:assert/strict";
+import { createHash } from "node:crypto";
+import { createWriteStream } from "node:fs";
+import { rename, mkdir, rm } from "node:fs/promises";
+import { Agent as HttpAgent } from "node:http";
+import { Agent as HttpsAgent } from "node:https";
+import { join, basename, extname, relative } from "node:path";
+import { pipeline } from "node:stream/promises";
+import { Minipass } from "minipass";
+import { extract as extractTar } from "tar";
+import { Open } from "unzipper";
+import { say } from "./utils.mjs";
+import { startDownload } from "./download.mjs";
+import { Extension, Binary } from "./types.mjs";
+/**
+ * Extracts the binaries from the given URL and writes them to the destination.
+ *
+ * @param url - The URL of the archive to extract the binaries from
+ * @param binaries - The list of binaries to extract
+ * @param dir - The destination directory
+ * @param checksums - The checksums to verify the binaries against
+ * @returns The list of binaries extracted
+ */
+export async function extractFrom(url, binaries, dir, checksums) {
+    const extract = url.pathname.toLowerCase().endsWith(Extension.Tar)
+        ? extractFromTar
+        : extractFromZip;
+    // write all files to a temporary directory first, then rename to the final
+    // destination to avoid accidental partial extraction. We don't use
+    // `os.tmpdir` for this because `rename` will fail if the directories are on
+    // different file systems.
+    const tempDir = `${dir}.downloading`;
+    const rmOpts = { recursive: true, maxRetries: 3, force: true };
+    try {
+        // clean up any previous in-progress downloads
+        await rm(tempDir, rmOpts);
+        // make the temporary directory to extract the binaries to
+        await mkdir(tempDir, { recursive: true });
+        const downloads = await extract(url, binaries, tempDir, checksums?.algorithm);
+        ok(downloads.length === binaries.length, 'Failed to extract all binaries');
+        const paths = [];
+        for (const { path, binary, checksum } of downloads) {
+            if (checksums) {
+                say(`verifying checksum for ${binary}`);
+                const expected = checksums.binaries[binary];
+                if (checksum === expected) {
+                    say(`checksum verified for ${binary}`);
+                }
+                else {
+                    throw new Error(`checksum mismatch for ${binary}, expected ${expected}, got ${checksum}`);
+                }
+            }
+            // add the *final* path to the list of binaries
+            paths.push(join(dir, relative(tempDir, path)));
+        }
+        // this directory shouldn't exist, but if two simultaneous `yarn foundryup`
+        // processes are running, it might. Last process wins, so we remove other
+        // `dir`s just in case.
+        await rm(dir, rmOpts);
+        // everything has been extracted; move the files to their final destination
+        await rename(tempDir, dir);
+        // return the list of extracted binaries
+        return paths;
+    }
+    catch (error) {
+        // if things fail for any reason try to clean up a bit. it is very important
+        // to not leave `dir` behind, as its existence is a signal that the binaries
+        // are installed.
+        const rmErrors = (await Promise.allSettled([rm(tempDir, rmOpts), rm(dir, rmOpts)]))
+            .filter((r) => r.status === 'rejected')
+            .map((r) => r.reason);
+        // if we failed to clean up, create an aggregate error message
+        if (rmErrors.length) {
+            throw new AggregateError([error, ...rmErrors], 'This is a bug; you should report it.');
+        }
+        throw error;
+    }
+}
+/**
+ * Extracts the binaries from a tar archive.
+ *
+ * @param url - The URL of the archive to extract the binaries from
+ * @param binaries - The list of binaries to extract
+ * @param dir - The destination directory
+ * @param checksumAlgorithm - The checksum algorithm to use
+ * @returns The list of binaries extracted
+ */
+async function extractFromTar(url, binaries, dir, checksumAlgorithm) {
+    const downloads = [];
+    await pipeline(startDownload(url), extractTar({
+        cwd: dir,
+        transform: (entry) => {
+            const absolutePath = entry.absolute;
+            if (!absolutePath) {
+                throw new Error('Missing absolute path for entry');
+            }
+            if (checksumAlgorithm) {
+                const hash = createHash(checksumAlgorithm);
+                const passThrough = new Minipass({ async: true });
+                passThrough.pipe(hash);
+                passThrough.on('end', () => {
+                    downloads.push({
+                        path: absolutePath,
+                        binary: entry.path,
+                        checksum: hash.digest('hex'),
+                    });
+                });
+                return passThrough;
+            }
+            // When no checksum is needed, record the entry and return undefined
+            // to use the original stream without transformation
+            downloads.push({
+                path: absolutePath,
+                binary: entry.path,
+            });
+            return undefined;
+        },
+    }, binaries));
+    return downloads;
+}
+/**
+ * Extracts the binaries from a zip archive.
+ *
+ * @param url - The URL of the archive to extract the binaries from
+ * @param binaries - The list of binaries to extract
+ * @param dir - The destination directory
+ * @param checksumAlgorithm - The checksum algorithm to use
+ * @returns The list of binaries extracted
+ */
+async function extractFromZip(url, binaries, dir, checksumAlgorithm) {
+    const agent = new (url.protocol === 'http:' ? HttpAgent : HttpsAgent)({
+        keepAlive: true,
+    });
+    const source = {
+        async size() {
+            const download = startDownload(url, { agent, method: 'HEAD' });
+            const response = await download.response();
+            const contentLength = response.headers['content-length'];
+            return contentLength ? parseInt(contentLength, 10) : 0;
+        },
+        stream(offset, bytes) {
+            const options = {
+                agent,
+                headers: {
+                    range: `bytes=${offset}-${bytes ? offset + bytes : ''}`,
+                },
+            };
+            return startDownload(url, options);
+        },
+    };
+    const { files } = await Open.custom(source, {});
+    const filtered = files.filter(({ path }) => binaries.includes(basename(path, extname(path))));
+    return await Promise.all(filtered.map(async ({ path, stream }) => {
+        const dest = join(dir, path);
+        const entry = stream();
+        const destStream = createWriteStream(dest);
+        const binary = basename(path, extname(path));
+        if (checksumAlgorithm) {
+            const hash = createHash(checksumAlgorithm);
+            const hashStream = async function* (entryStream) {
+                for await (const chunk of entryStream) {
+                    hash.update(chunk);
+                    yield chunk;
+                }
+            };
+            await pipeline(entry, hashStream, destStream);
+            return {
+                path: dest,
+                binary,
+                checksum: hash.digest('hex'),
+            };
+        }
+        await pipeline(entry, destStream);
+        return {
+            path: dest,
+            binary,
+        };
+    }));
+}
+//# sourceMappingURL=extract.mjs.map

package/dist/extract.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.mjs","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":"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","sourcesContent":["import { ok } from 'node:assert/strict';\nimport { createHash } from 'node:crypto';\nimport { createWriteStream } from 'node:fs';\nimport { rename, mkdir, rm } from 'node:fs/promises';\nimport { Agent as HttpAgent } from 'node:http';\nimport { Agent as HttpsAgent } from 'node:https';\nimport { join, basename, extname, relative } from 'node:path';\nimport { pipeline } from 'node:stream/promises';\nimport { Minipass } from 'minipass';\nimport { extract as extractTar } from 'tar';\nimport { Open, type Source, type Entry } from 'unzipper';\nimport { say } from './utils';\nimport { startDownload } from './download';\nimport { Extension, Binary } from './types';\n\n/**\n * Extracts the binaries from the given URL and writes them to the destination.\n *\n * @param url - The URL of the archive to extract the binaries from\n * @param binaries - The list of binaries to extract\n * @param dir - The destination directory\n * @param checksums - The checksums to verify the binaries against\n * @returns The list of binaries extracted\n */\n\nexport async function extractFrom(\n  url: URL,\n  binaries: Binary[],\n  dir: string,\n  checksums: { algorithm: string; binaries: Record<Binary, string> } | null,\n) {\n  const extract = url.pathname.toLowerCase().endsWith(Extension.Tar)\n    ? extractFromTar\n    : extractFromZip;\n  // write all files to a temporary directory first, then rename to the final\n  // destination to avoid accidental partial extraction. We don't use\n  // `os.tmpdir` for this because `rename` will fail if the directories are on\n  // different file systems.\n  const tempDir = `${dir}.downloading`;\n  const rmOpts = { recursive: true, maxRetries: 3, force: true };\n  try {\n    // clean up any previous in-progress downloads\n    await rm(tempDir, rmOpts);\n    // make the temporary directory to extract the binaries to\n    await mkdir(tempDir, { recursive: true });\n    const downloads = await extract(\n      url,\n      binaries,\n      tempDir,\n      checksums?.algorithm,\n    );\n    ok(downloads.length === binaries.length, 'Failed to extract all binaries');\n\n    const paths: string[] = [];\n    for (const { path, binary, checksum } of downloads) {\n      if (checksums) {\n        say(`verifying checksum for ${binary}`);\n        const expected = checksums.binaries[binary];\n        if (checksum === expected) {\n          say(`checksum verified for ${binary}`);\n        } else {\n          throw new Error(\n            `checksum mismatch for ${binary}, expected ${expected}, got ${checksum}`,\n          );\n        }\n      }\n      // add the *final* path to the list of binaries\n      paths.push(join(dir, relative(tempDir, path)));\n    }\n\n    // this directory shouldn't exist, but if two simultaneous `yarn foundryup`\n    // processes are running, it might. Last process wins, so we remove other\n    // `dir`s just in case.\n    await rm(dir, rmOpts);\n    // everything has been extracted; move the files to their final destination\n    await rename(tempDir, dir);\n    // return the list of extracted binaries\n    return paths;\n  } catch (error) {\n    // if things fail for any reason try to clean up a bit. it is very important\n    // to not leave `dir` behind, as its existence is a signal that the binaries\n    // are installed.\n    const rmErrors = (\n      await Promise.allSettled([rm(tempDir, rmOpts), rm(dir, rmOpts)])\n    )\n      .filter((r) => r.status === 'rejected')\n      .map((r) => (r as PromiseRejectedResult).reason);\n\n    // if we failed to clean up, create an aggregate error message\n    if (rmErrors.length) {\n      throw new AggregateError(\n        [error, ...rmErrors],\n        'This is a bug; you should report it.',\n      );\n    }\n    throw error;\n  }\n}\n/**\n * Extracts the binaries from a tar archive.\n *\n * @param url - The URL of the archive to extract the binaries from\n * @param binaries - The list of binaries to extract\n * @param dir - The destination directory\n * @param checksumAlgorithm - The checksum algorithm to use\n * @returns The list of binaries extracted\n */\n\nasync function extractFromTar(\n  url: URL,\n  binaries: Binary[],\n  dir: string,\n  checksumAlgorithm?: string,\n) {\n  const downloads: {\n    path: string;\n    binary: Binary;\n    checksum?: string;\n  }[] = [];\n  await pipeline(\n    startDownload(url),\n    extractTar(\n      {\n        cwd: dir,\n        transform: (entry) => {\n          const absolutePath = entry.absolute;\n          if (!absolutePath) {\n            throw new Error('Missing absolute path for entry');\n          }\n\n          if (checksumAlgorithm) {\n            const hash = createHash(checksumAlgorithm);\n            const passThrough = new Minipass({ async: true });\n            passThrough.pipe(hash);\n            passThrough.on('end', () => {\n              downloads.push({\n                path: absolutePath,\n                binary: entry.path as Binary,\n                checksum: hash.digest('hex'),\n              });\n            });\n            return passThrough;\n          }\n\n          // When no checksum is needed, record the entry and return undefined\n          // to use the original stream without transformation\n          downloads.push({\n            path: absolutePath,\n            binary: entry.path as Binary,\n          });\n          return undefined;\n        },\n      },\n      binaries,\n    ),\n  );\n  return downloads;\n}\n/**\n * Extracts the binaries from a zip archive.\n *\n * @param url - The URL of the archive to extract the binaries from\n * @param binaries - The list of binaries to extract\n * @param dir - The destination directory\n * @param checksumAlgorithm - The checksum algorithm to use\n * @returns The list of binaries extracted\n */\n\nasync function extractFromZip(\n  url: URL,\n  binaries: Binary[],\n  dir: string,\n  checksumAlgorithm?: string,\n) {\n  const agent = new (url.protocol === 'http:' ? HttpAgent : HttpsAgent)({\n    keepAlive: true,\n  });\n  const source: Source = {\n    async size() {\n      const download = startDownload(url, { agent, method: 'HEAD' });\n      const response = await download.response();\n      const contentLength = response.headers['content-length'];\n      return contentLength ? parseInt(contentLength, 10) : 0;\n    },\n    stream(offset: number, bytes: number) {\n      const options = {\n        agent,\n        headers: {\n          range: `bytes=${offset}-${bytes ? offset + bytes : ''}`,\n        },\n      };\n      return startDownload(url, options);\n    },\n  };\n\n  const { files } = await Open.custom(source, {});\n  const filtered = files.filter(({ path }) =>\n    binaries.includes(basename(path, extname(path)) as Binary),\n  );\n  return await Promise.all(\n    filtered.map(async ({ path, stream }) => {\n      const dest = join(dir, path);\n      const entry = stream();\n      const destStream = createWriteStream(dest);\n      const binary = basename(path, extname(path)) as Binary;\n      if (checksumAlgorithm) {\n        const hash = createHash(checksumAlgorithm);\n        const hashStream = async function* (entryStream: Entry) {\n          for await (const chunk of entryStream) {\n            hash.update(chunk);\n            yield chunk;\n          }\n        };\n        await pipeline(entry, hashStream, destStream);\n        return {\n          path: dest,\n          binary,\n          checksum: hash.digest('hex'),\n        };\n      }\n      await pipeline(entry, destStream);\n      return {\n        path: dest,\n        binary,\n      };\n    }),\n  );\n}\n"]}

package/dist/index.cjs

@@ -0,0 +1,116 @@
+#!/usr/bin/env -S node --require "./node_modules/tsx/dist/preflight.cjs" --import "./node_modules/tsx/dist/loader.mjs"
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadAndInstallFoundryBinaries = exports.installBinaries = exports.checkAndDownloadBinaries = exports.getBinaryArchiveUrl = exports.getCacheDirectory = void 0;
+const node_path_1 = require("node:path");
+const node_os_1 = require("node:os");
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_crypto_1 = require("node:crypto");
+const node_process_1 = require("node:process");
+const yaml_1 = require("yaml");
+const utils_1 = require("./utils.cjs");
+const extract_1 = require("./extract.cjs");
+const options_1 = require("./options.cjs");
+const types_1 = require("./types.cjs");
+function getCacheDirectory() {
+    let enableGlobalCache = false;
+    try {
+        const configFileContent = (0, node_fs_1.readFileSync)('.yarnrc.yml', 'utf8');
+        const parsedConfig = (0, yaml_1.parse)(configFileContent);
+        enableGlobalCache = parsedConfig?.enableGlobalCache ?? false;
+    }
+    catch (error) {
+        // If file doesn't exist or can't be read, default to local cache
+        if (error.code === 'ENOENT') {
+            return (0, node_path_1.join)((0, node_process_1.cwd)(), '.metamask', 'cache');
+        }
+        // For other errors, log but continue with default
+        console.warn('Warning: Error reading .yarnrc.yml, using local cache:', error);
+    }
+    return enableGlobalCache
+        ? (0, node_path_1.join)((0, node_os_1.homedir)(), '.cache', 'metamask')
+        : (0, node_path_1.join)((0, node_process_1.cwd)(), '.metamask', 'cache');
+}
+exports.getCacheDirectory = getCacheDirectory;
+function getBinaryArchiveUrl(repo, tag, version, platform, arch) {
+    const ext = platform === types_1.Platform.Windows ? types_1.Extension.Zip : types_1.Extension.Tar;
+    return `https://github.com/${repo}/releases/download/${tag}/foundry_${version}_${platform}_${arch}.${ext}`;
+}
+exports.getBinaryArchiveUrl = getBinaryArchiveUrl;
+async function checkAndDownloadBinaries(url, binaries, cachePath, platform, arch, checksums) {
+    let downloadedBinaries;
+    try {
+        (0, utils_1.say)(`checking cache`);
+        downloadedBinaries = await (0, promises_1.opendir)(cachePath);
+        (0, utils_1.say)(`found binaries in cache`);
+    }
+    catch (e) {
+        (0, utils_1.say)(`binaries not in cache`);
+        if (e.code === 'ENOENT') {
+            (0, utils_1.say)(`installing from ${url.toString()}`);
+            // directory doesn't exist, download and extract
+            const platformChecksums = (0, utils_1.transformChecksums)(checksums, platform, arch);
+            await (0, extract_1.extractFrom)(url, binaries, cachePath, platformChecksums);
+            downloadedBinaries = await (0, promises_1.opendir)(cachePath);
+        }
+        else {
+            throw e;
+        }
+    }
+    return downloadedBinaries;
+}
+exports.checkAndDownloadBinaries = checkAndDownloadBinaries;
+async function installBinaries(downloadedBinaries, BIN_DIR, cachePath) {
+    for await (const file of downloadedBinaries) {
+        if (!file.isFile()) {
+            continue;
+        }
+        const target = (0, node_path_1.join)(file.parentPath, file.name);
+        const path = (0, node_path_1.join)(BIN_DIR, (0, node_path_1.relative)(cachePath, target));
+        // create the BIN_DIR paths if they don't exists already
+        await (0, promises_1.mkdir)(BIN_DIR, { recursive: true });
+        // clean up any existing files or symlinks
+        await (0, promises_1.unlink)(path).catch(utils_1.noop);
+        try {
+            // create new symlink
+            await (0, promises_1.symlink)(target, path);
+        }
+        catch (e) {
+            if (!((0, utils_1.isCodedError)(e) && ['EPERM', 'EXDEV'].includes(e.code))) {
+                throw e;
+            }
+            // symlinking can fail if it's a cross-device/filesystem link, or for
+            // permissions reasons, so we'll just copy the file instead
+            await (0, promises_1.copyFile)(target, path);
+        }
+        // check that it works by logging the version
+        (0, utils_1.say)(`installed - ${(0, utils_1.getVersion)(path)}`);
+    }
+}
+exports.installBinaries = installBinaries;
+async function downloadAndInstallFoundryBinaries() {
+    const parsedArgs = (0, options_1.parseArgs)();
+    const CACHE_DIR = getCacheDirectory();
+    if (parsedArgs.command === 'cache clean') {
+        await (0, promises_1.rm)(CACHE_DIR, { recursive: true, force: true });
+        (0, utils_1.say)('done!');
+        (0, node_process_1.exit)(0);
+    }
+    const { repo, version: { version, tag }, arch, platform, binaries, checksums, } = parsedArgs.options;
+    (0, options_1.printBanner)();
+    const bins = binaries.join(', ');
+    (0, utils_1.say)(`fetching ${bins} ${version} for ${platform} ${arch}`);
+    const BIN_ARCHIVE_URL = getBinaryArchiveUrl(repo, tag, version, platform, arch);
+    const BIN_DIR = (0, node_path_1.join)((0, node_process_1.cwd)(), 'node_modules', '.bin');
+    const url = new URL(BIN_ARCHIVE_URL);
+    const cacheKey = (0, node_crypto_1.createHash)('sha256')
+        .update(`${BIN_ARCHIVE_URL}-${bins}`)
+        .digest('hex');
+    const cachePath = (0, node_path_1.join)(CACHE_DIR, cacheKey);
+    const downloadedBinaries = await checkAndDownloadBinaries(url, binaries, cachePath, platform, arch, checksums);
+    await installBinaries(downloadedBinaries, BIN_DIR, cachePath);
+    (0, utils_1.say)('done!');
+}
+exports.downloadAndInstallFoundryBinaries = downloadAndInstallFoundryBinaries;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env -S node --require \"./node_modules/tsx/dist/preflight.cjs\" --import \"./node_modules/tsx/dist/loader.mjs\"\n\nimport { join, relative } from 'node:path';\nimport { homedir } from 'node:os';\nimport { Dir, readFileSync } from 'node:fs';\nimport { copyFile, mkdir, opendir, rm, symlink, unlink } from 'node:fs/promises';\nimport { createHash } from 'node:crypto';\nimport { cwd, exit } from 'node:process';\nimport { parse as parseYaml } from 'yaml';\nimport {\n  getVersion,\n  isCodedError,\n  noop,\n  say,\n  transformChecksums,\n} from './utils';\nimport { extractFrom } from './extract';\nimport { parseArgs, printBanner } from './options';\nimport type { Checksums } from './types';\nimport { Architecture, Binary, Extension, Platform } from './types';\n\nexport function getCacheDirectory(): string {\n  let enableGlobalCache = false;\n  try {\n    const configFileContent = readFileSync('.yarnrc.yml', 'utf8');\n    const parsedConfig = parseYaml(configFileContent);\n    enableGlobalCache = parsedConfig?.enableGlobalCache ?? false;\n  } catch (error) {\n    // If file doesn't exist or can't be read, default to local cache\n    if ((error as NodeJS.ErrnoException).code === 'ENOENT') {\n      return join(cwd(), '.metamask', 'cache');\n    }\n    // For other errors, log but continue with default\n    console.warn('Warning: Error reading .yarnrc.yml, using local cache:', error);\n  }\n  return enableGlobalCache\n    ? join(homedir(), '.cache', 'metamask')\n    : join(cwd(), '.metamask', 'cache');\n}\n\nexport function getBinaryArchiveUrl(\n  repo: string,\n  tag: string,\n  version: string,\n  platform: Platform,\n  arch: string,\n): string {\n  const ext = platform === Platform.Windows ? Extension.Zip : Extension.Tar;\n  return `https://github.com/${repo}/releases/download/${tag}/foundry_${version}_${platform}_${arch}.${ext}`;\n}\n\nexport async function checkAndDownloadBinaries(\n  url: URL,\n  binaries: Binary[],\n  cachePath: string,\n  platform: Platform,\n  arch: Architecture,\n  checksums?: Checksums,\n): Promise<Dir> {\n  let downloadedBinaries: Dir;\n  try {\n    say(`checking cache`);\n    downloadedBinaries = await opendir(cachePath);\n    say(`found binaries in cache`);\n  } catch (e: unknown) {\n    say(`binaries not in cache`);\n    if ((e as NodeJS.ErrnoException).code === 'ENOENT') {\n      say(`installing from ${url.toString()}`);\n      // directory doesn't exist, download and extract\n      const platformChecksums = transformChecksums(checksums, platform, arch);\n      await extractFrom(url, binaries, cachePath, platformChecksums);\n      downloadedBinaries = await opendir(cachePath);\n    } else {\n      throw e;\n    }\n  }\n  return downloadedBinaries;\n}\n\nexport async function installBinaries(\n  downloadedBinaries: Dir,\n  BIN_DIR: string,\n  cachePath: string,\n): Promise<void> {\n  for await (const file of downloadedBinaries) {\n    if (!file.isFile()) {\n      continue;\n    }\n    const target = join(file.parentPath, file.name);\n    const path = join(BIN_DIR, relative(cachePath, target));\n\n    // create the BIN_DIR paths if they don't exists already\n    await mkdir(BIN_DIR, { recursive: true });\n\n    // clean up any existing files or symlinks\n    await unlink(path).catch(noop);\n    try {\n      // create new symlink\n      await symlink(target, path);\n    } catch (e) {\n      if (!(isCodedError(e) && ['EPERM', 'EXDEV'].includes(e.code))) {\n        throw e;\n      }\n      // symlinking can fail if it's a cross-device/filesystem link, or for\n      // permissions reasons, so we'll just copy the file instead\n      await copyFile(target, path);\n    }\n    // check that it works by logging the version\n    say(`installed - ${getVersion(path)}`);\n  }\n}\n\nexport async function downloadAndInstallFoundryBinaries(): Promise<void> {\n  const parsedArgs = parseArgs();\n\n  const CACHE_DIR = getCacheDirectory();\n\n  if (parsedArgs.command === 'cache clean') {\n    await rm(CACHE_DIR, { recursive: true, force: true });\n    say('done!');\n    exit(0);\n  }\n\n  const {\n    repo,\n    version: { version, tag },\n    arch,\n    platform,\n    binaries,\n    checksums,\n  } = parsedArgs.options;\n\n  printBanner();\n  const bins = binaries.join(', ');\n  say(`fetching ${bins} ${version} for ${platform} ${arch}`);\n\n  const BIN_ARCHIVE_URL = getBinaryArchiveUrl(\n    repo,\n    tag,\n    version,\n    platform,\n    arch,\n  );\n  const BIN_DIR = join(cwd(), 'node_modules', '.bin');\n\n  const url = new URL(BIN_ARCHIVE_URL);\n  const cacheKey = createHash('sha256')\n    .update(`${BIN_ARCHIVE_URL}-${bins}`)\n    .digest('hex');\n  const cachePath = join(CACHE_DIR, cacheKey);\n\n  const downloadedBinaries = await checkAndDownloadBinaries(\n    url,\n    binaries,\n    cachePath,\n    platform,\n    arch,\n    checksums,\n  );\n\n  await installBinaries(downloadedBinaries, BIN_DIR, cachePath);\n\n  say('done!');\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,11 @@
+#!/usr/bin/env -S node --require "./node_modules/tsx/dist/preflight.cjs" --import "./node_modules/tsx/dist/loader.mjs"
+/// <reference types="node" />
+import { Dir } from "node:fs";
+import type { Checksums } from "./types.cjs";
+import { Architecture, Binary, Platform } from "./types.cjs";
+export declare function getCacheDirectory(): string;
+export declare function getBinaryArchiveUrl(repo: string, tag: string, version: string, platform: Platform, arch: string): string;
+export declare function checkAndDownloadBinaries(url: URL, binaries: Binary[], cachePath: string, platform: Platform, arch: Architecture, checksums?: Checksums): Promise<Dir>;
+export declare function installBinaries(downloadedBinaries: Dir, BIN_DIR: string, cachePath: string): Promise<void>;
+export declare function downloadAndInstallFoundryBinaries(): Promise<void>;
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAIA,OAAO,EAAE,GAAG,EAAgB,gBAAgB;AAc5C,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAgB;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAa,QAAQ,EAAE,oBAAgB;AAEpE,wBAAgB,iBAAiB,IAAI,MAAM,CAiB1C;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,GACX,MAAM,CAGR;AAED,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,MAAM,EAAE,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,YAAY,EAClB,SAAS,CAAC,EAAE,SAAS,GACpB,OAAO,CAAC,GAAG,CAAC,CAmBd;AAED,wBAAsB,eAAe,CACnC,kBAAkB,EAAE,GAAG,EACvB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED,wBAAsB,iCAAiC,IAAI,OAAO,CAAC,IAAI,CAAC,CAmDvE"}

package/dist/index.d.mts

@@ -0,0 +1,11 @@
+#!/usr/bin/env -S node --require "./node_modules/tsx/dist/preflight.cjs" --import "./node_modules/tsx/dist/loader.mjs"
+/// <reference types="node" />
+import { Dir } from "node:fs";
+import type { Checksums } from "./types.mjs";
+import { Architecture, Binary, Platform } from "./types.mjs";
+export declare function getCacheDirectory(): string;
+export declare function getBinaryArchiveUrl(repo: string, tag: string, version: string, platform: Platform, arch: string): string;
+export declare function checkAndDownloadBinaries(url: URL, binaries: Binary[], cachePath: string, platform: Platform, arch: Architecture, checksums?: Checksums): Promise<Dir>;
+export declare function installBinaries(downloadedBinaries: Dir, BIN_DIR: string, cachePath: string): Promise<void>;
+export declare function downloadAndInstallFoundryBinaries(): Promise<void>;
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAIA,OAAO,EAAE,GAAG,EAAgB,gBAAgB;AAc5C,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAgB;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAa,QAAQ,EAAE,oBAAgB;AAEpE,wBAAgB,iBAAiB,IAAI,MAAM,CAiB1C;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,GACX,MAAM,CAGR;AAED,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,MAAM,EAAE,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,YAAY,EAClB,SAAS,CAAC,EAAE,SAAS,GACpB,OAAO,CAAC,GAAG,CAAC,CAmBd;AAED,wBAAsB,eAAe,CACnC,kBAAkB,EAAE,GAAG,EACvB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED,wBAAsB,iCAAiC,IAAI,OAAO,CAAC,IAAI,CAAC,CAmDvE"}

package/dist/index.mjs

@@ -0,0 +1,109 @@
+#!/usr/bin/env -S node --require "./node_modules/tsx/dist/preflight.cjs" --import "./node_modules/tsx/dist/loader.mjs"
+import { join, relative } from "node:path";
+import { homedir } from "node:os";
+import { Dir, readFileSync } from "node:fs";
+import { copyFile, mkdir, opendir, rm, symlink, unlink } from "node:fs/promises";
+import { createHash } from "node:crypto";
+import { cwd, exit } from "node:process";
+import $yaml from "yaml";
+const { parse: parseYaml } = $yaml;
+import { getVersion, isCodedError, noop, say, transformChecksums } from "./utils.mjs";
+import { extractFrom } from "./extract.mjs";
+import { parseArgs, printBanner } from "./options.mjs";
+import { Architecture, Binary, Extension, Platform } from "./types.mjs";
+export function getCacheDirectory() {
+    let enableGlobalCache = false;
+    try {
+        const configFileContent = readFileSync('.yarnrc.yml', 'utf8');
+        const parsedConfig = parseYaml(configFileContent);
+        enableGlobalCache = parsedConfig?.enableGlobalCache ?? false;
+    }
+    catch (error) {
+        // If file doesn't exist or can't be read, default to local cache
+        if (error.code === 'ENOENT') {
+            return join(cwd(), '.metamask', 'cache');
+        }
+        // For other errors, log but continue with default
+        console.warn('Warning: Error reading .yarnrc.yml, using local cache:', error);
+    }
+    return enableGlobalCache
+        ? join(homedir(), '.cache', 'metamask')
+        : join(cwd(), '.metamask', 'cache');
+}
+export function getBinaryArchiveUrl(repo, tag, version, platform, arch) {
+    const ext = platform === Platform.Windows ? Extension.Zip : Extension.Tar;
+    return `https://github.com/${repo}/releases/download/${tag}/foundry_${version}_${platform}_${arch}.${ext}`;
+}
+export async function checkAndDownloadBinaries(url, binaries, cachePath, platform, arch, checksums) {
+    let downloadedBinaries;
+    try {
+        say(`checking cache`);
+        downloadedBinaries = await opendir(cachePath);
+        say(`found binaries in cache`);
+    }
+    catch (e) {
+        say(`binaries not in cache`);
+        if (e.code === 'ENOENT') {
+            say(`installing from ${url.toString()}`);
+            // directory doesn't exist, download and extract
+            const platformChecksums = transformChecksums(checksums, platform, arch);
+            await extractFrom(url, binaries, cachePath, platformChecksums);
+            downloadedBinaries = await opendir(cachePath);
+        }
+        else {
+            throw e;
+        }
+    }
+    return downloadedBinaries;
+}
+export async function installBinaries(downloadedBinaries, BIN_DIR, cachePath) {
+    for await (const file of downloadedBinaries) {
+        if (!file.isFile()) {
+            continue;
+        }
+        const target = join(file.parentPath, file.name);
+        const path = join(BIN_DIR, relative(cachePath, target));
+        // create the BIN_DIR paths if they don't exists already
+        await mkdir(BIN_DIR, { recursive: true });
+        // clean up any existing files or symlinks
+        await unlink(path).catch(noop);
+        try {
+            // create new symlink
+            await symlink(target, path);
+        }
+        catch (e) {
+            if (!(isCodedError(e) && ['EPERM', 'EXDEV'].includes(e.code))) {
+                throw e;
+            }
+            // symlinking can fail if it's a cross-device/filesystem link, or for
+            // permissions reasons, so we'll just copy the file instead
+            await copyFile(target, path);
+        }
+        // check that it works by logging the version
+        say(`installed - ${getVersion(path)}`);
+    }
+}
+export async function downloadAndInstallFoundryBinaries() {
+    const parsedArgs = parseArgs();
+    const CACHE_DIR = getCacheDirectory();
+    if (parsedArgs.command === 'cache clean') {
+        await rm(CACHE_DIR, { recursive: true, force: true });
+        say('done!');
+        exit(0);
+    }
+    const { repo, version: { version, tag }, arch, platform, binaries, checksums, } = parsedArgs.options;
+    printBanner();
+    const bins = binaries.join(', ');
+    say(`fetching ${bins} ${version} for ${platform} ${arch}`);
+    const BIN_ARCHIVE_URL = getBinaryArchiveUrl(repo, tag, version, platform, arch);
+    const BIN_DIR = join(cwd(), 'node_modules', '.bin');
+    const url = new URL(BIN_ARCHIVE_URL);
+    const cacheKey = createHash('sha256')
+        .update(`${BIN_ARCHIVE_URL}-${bins}`)
+        .digest('hex');
+    const cachePath = join(CACHE_DIR, cacheKey);
+    const downloadedBinaries = await checkAndDownloadBinaries(url, binaries, cachePath, platform, arch, checksums);
+    await installBinaries(downloadedBinaries, BIN_DIR, cachePath);
+    say('done!');
+}
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env -S node --require \"./node_modules/tsx/dist/preflight.cjs\" --import \"./node_modules/tsx/dist/loader.mjs\"\n\nimport { join, relative } from 'node:path';\nimport { homedir } from 'node:os';\nimport { Dir, readFileSync } from 'node:fs';\nimport { copyFile, mkdir, opendir, rm, symlink, unlink } from 'node:fs/promises';\nimport { createHash } from 'node:crypto';\nimport { cwd, exit } from 'node:process';\nimport { parse as parseYaml } from 'yaml';\nimport {\n  getVersion,\n  isCodedError,\n  noop,\n  say,\n  transformChecksums,\n} from './utils';\nimport { extractFrom } from './extract';\nimport { parseArgs, printBanner } from './options';\nimport type { Checksums } from './types';\nimport { Architecture, Binary, Extension, Platform } from './types';\n\nexport function getCacheDirectory(): string {\n  let enableGlobalCache = false;\n  try {\n    const configFileContent = readFileSync('.yarnrc.yml', 'utf8');\n    const parsedConfig = parseYaml(configFileContent);\n    enableGlobalCache = parsedConfig?.enableGlobalCache ?? false;\n  } catch (error) {\n    // If file doesn't exist or can't be read, default to local cache\n    if ((error as NodeJS.ErrnoException).code === 'ENOENT') {\n      return join(cwd(), '.metamask', 'cache');\n    }\n    // For other errors, log but continue with default\n    console.warn('Warning: Error reading .yarnrc.yml, using local cache:', error);\n  }\n  return enableGlobalCache\n    ? join(homedir(), '.cache', 'metamask')\n    : join(cwd(), '.metamask', 'cache');\n}\n\nexport function getBinaryArchiveUrl(\n  repo: string,\n  tag: string,\n  version: string,\n  platform: Platform,\n  arch: string,\n): string {\n  const ext = platform === Platform.Windows ? Extension.Zip : Extension.Tar;\n  return `https://github.com/${repo}/releases/download/${tag}/foundry_${version}_${platform}_${arch}.${ext}`;\n}\n\nexport async function checkAndDownloadBinaries(\n  url: URL,\n  binaries: Binary[],\n  cachePath: string,\n  platform: Platform,\n  arch: Architecture,\n  checksums?: Checksums,\n): Promise<Dir> {\n  let downloadedBinaries: Dir;\n  try {\n    say(`checking cache`);\n    downloadedBinaries = await opendir(cachePath);\n    say(`found binaries in cache`);\n  } catch (e: unknown) {\n    say(`binaries not in cache`);\n    if ((e as NodeJS.ErrnoException).code === 'ENOENT') {\n      say(`installing from ${url.toString()}`);\n      // directory doesn't exist, download and extract\n      const platformChecksums = transformChecksums(checksums, platform, arch);\n      await extractFrom(url, binaries, cachePath, platformChecksums);\n      downloadedBinaries = await opendir(cachePath);\n    } else {\n      throw e;\n    }\n  }\n  return downloadedBinaries;\n}\n\nexport async function installBinaries(\n  downloadedBinaries: Dir,\n  BIN_DIR: string,\n  cachePath: string,\n): Promise<void> {\n  for await (const file of downloadedBinaries) {\n    if (!file.isFile()) {\n      continue;\n    }\n    const target = join(file.parentPath, file.name);\n    const path = join(BIN_DIR, relative(cachePath, target));\n\n    // create the BIN_DIR paths if they don't exists already\n    await mkdir(BIN_DIR, { recursive: true });\n\n    // clean up any existing files or symlinks\n    await unlink(path).catch(noop);\n    try {\n      // create new symlink\n      await symlink(target, path);\n    } catch (e) {\n      if (!(isCodedError(e) && ['EPERM', 'EXDEV'].includes(e.code))) {\n        throw e;\n      }\n      // symlinking can fail if it's a cross-device/filesystem link, or for\n      // permissions reasons, so we'll just copy the file instead\n      await copyFile(target, path);\n    }\n    // check that it works by logging the version\n    say(`installed - ${getVersion(path)}`);\n  }\n}\n\nexport async function downloadAndInstallFoundryBinaries(): Promise<void> {\n  const parsedArgs = parseArgs();\n\n  const CACHE_DIR = getCacheDirectory();\n\n  if (parsedArgs.command === 'cache clean') {\n    await rm(CACHE_DIR, { recursive: true, force: true });\n    say('done!');\n    exit(0);\n  }\n\n  const {\n    repo,\n    version: { version, tag },\n    arch,\n    platform,\n    binaries,\n    checksums,\n  } = parsedArgs.options;\n\n  printBanner();\n  const bins = binaries.join(', ');\n  say(`fetching ${bins} ${version} for ${platform} ${arch}`);\n\n  const BIN_ARCHIVE_URL = getBinaryArchiveUrl(\n    repo,\n    tag,\n    version,\n    platform,\n    arch,\n  );\n  const BIN_DIR = join(cwd(), 'node_modules', '.bin');\n\n  const url = new URL(BIN_ARCHIVE_URL);\n  const cacheKey = createHash('sha256')\n    .update(`${BIN_ARCHIVE_URL}-${bins}`)\n    .digest('hex');\n  const cachePath = join(CACHE_DIR, cacheKey);\n\n  const downloadedBinaries = await checkAndDownloadBinaries(\n    url,\n    binaries,\n    cachePath,\n    platform,\n    arch,\n    checksums,\n  );\n\n  await installBinaries(downloadedBinaries, BIN_DIR, cachePath);\n\n  say('done!');\n}\n"]}

package/dist/options.cjs

@@ -0,0 +1,135 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseArgs = exports.printBanner = void 0;
+const node_os_1 = require("node:os");
+const node_process_1 = require("node:process");
+const yargs_1 = __importDefault(require("yargs/yargs"));
+const utils_1 = require("./utils.cjs");
+const types_1 = require("./types.cjs");
+function isVersionString(value) {
+    return /^v\d/u.test(value);
+}
+function printBanner() {
+    console.log(`
+.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx
+
+ ╔═╗ ╔═╗ ╦ ╦ ╔╗╔ ╔╦╗ ╦═╗ ╦ ╦         Portable and modular toolkit
+ ╠╣  ║ ║ ║ ║ ║║║  ║║ ╠╦╝ ╚╦╝    for Ethereum Application Development
+ ╚   ╚═╝ ╚═╝ ╝╚╝ ═╩╝ ╩╚═  ╩                 written in Rust.
+
+.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx
+
+Repo       : https://github.com/foundry-rs/
+Book       : https://book.getfoundry.sh/
+Chat       : https://t.me/foundry_rs/
+Support    : https://t.me/foundry_support/
+Contribute : https://github.com/orgs/foundry-rs/projects/2/
+
+.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx
+`);
+}
+exports.printBanner = printBanner;
+function parseArgs(args = node_process_1.argv.slice(2)) {
+    const { $0, _, ...parsed } = (0, yargs_1.default)()
+        // Ensure unrecognized commands/options are reported as errors.
+        .strict()
+        // disable yargs's version, as it doesn't make sense here
+        .version(false)
+        // use the scriptName in `--help` output
+        .scriptName('yarn foundryup')
+        // wrap output at a maximum of 120 characters or `stdout.columns`
+        .wrap(Math.min(120, node_process_1.stdout.columns))
+        .parserConfiguration({
+        'strip-aliased': true,
+        'strip-dashed': true,
+    })
+        // enable ENV parsing, which allows the user to specify foundryup options
+        // via environment variables prefixed with `FOUNDRYUP_`
+        .env('FOUNDRYUP')
+        .command(['$0', 'install'], 'Install foundry binaries', (builder) => {
+        builder.options(getOptions()).pkgConf('foundryup');
+    })
+        .command('cache', '', (builder) => {
+        builder.command('clean', 'Remove the shared cache files').demandCommand();
+    })
+        .parseSync(args);
+    const command = _.join(' ');
+    if (command === 'cache clean') {
+        return {
+            command,
+        };
+    }
+    // if we get here `command` is always 'install' or '' (yargs checks it)
+    return {
+        command: 'install',
+        options: parsed,
+    };
+}
+exports.parseArgs = parseArgs;
+const Binaries = Object.values(types_1.Binary);
+function getOptions(defaultPlatform = (0, node_os_1.platform)(), defaultArch = (0, utils_1.normalizeSystemArchitecture)()) {
+    return {
+        binaries: {
+            alias: 'b',
+            type: 'array',
+            multiple: true,
+            description: 'Specify the binaries to install',
+            default: Binaries,
+            choices: Binaries,
+            coerce: (values) => [...new Set(values)], // Remove duplicates
+        },
+        checksums: {
+            alias: 'c',
+            description: 'JSON object containing checksums for the binaries.',
+            coerce: (rawChecksums) => {
+                try {
+                    return typeof rawChecksums === 'string'
+                        ? JSON.parse(rawChecksums)
+                        : rawChecksums;
+                }
+                catch {
+                    throw new Error('Invalid checksums');
+                }
+            },
+            optional: true,
+        },
+        repo: {
+            alias: 'r',
+            description: 'Specify the repository',
+            default: 'foundry-rs/foundry',
+        },
+        version: {
+            alias: 'v',
+            description: 'Specify the version (see: https://github.com/foundry-rs/foundry/tags)',
+            default: 'nightly',
+            coerce: (rawVersion) => {
+                if (/^nightly/u.test(rawVersion)) {
+                    return { version: 'nightly', tag: rawVersion };
+                    // we don't validate the version much, we just trust the user
+                }
+                else if (isVersionString(rawVersion)) {
+                    return { version: rawVersion, tag: rawVersion };
+                }
+                throw new Error('Invalid version');
+            },
+        },
+        arch: {
+            alias: 'a',
+            description: 'Specify the architecture',
+            // if `defaultArch` is not a supported Architecture yargs will throw an error
+            default: defaultArch,
+            choices: Object.values(types_1.Architecture),
+        },
+        platform: {
+            alias: 'p',
+            description: 'Specify the platform',
+            // if `defaultPlatform` is not a supported Platform yargs will throw an error
+            default: defaultPlatform,
+            choices: Object.values(types_1.Platform),
+        },
+    };
+}
+//# sourceMappingURL=options.cjs.map