@metamask-previews/foundryup 1.0.1-preview-4f4c98e → 1.0.1-preview-eb263b0ee

package/dist/index.cjs

@@ -0,0 +1,163 @@
+#!/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_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const node_process_1 = require("node:process");
+const yaml_1 = require("yaml");
+const extract_js_1 = require("./extract.cjs");
+const options_js_1 = require("./options.cjs");
+const types_js_1 = require("./types.cjs");
+const utils_js_1 = require("./utils.cjs");
+/**
+ * Determines the cache directory based on the .yarnrc.yml configuration.
+ * If global cache is enabled, returns a path in the user's home directory.
+ * Otherwise, returns a local cache path in the current working directory.
+ *
+ * @returns The path to the cache directory
+ */
+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;
+/**
+ * Generates the URL for downloading the Foundry binary archive.
+ *
+ * @param repo - The GitHub repository (e.g., 'foundry-rs/foundry')
+ * @param tag - The release tag (e.g., 'v1.0.0')
+ * @param version - The version string
+ * @param platform - The target platform (e.g., Platform.Linux)
+ * @param arch - The target architecture (e.g., 'amd64')
+ * @returns The URL for the binary archive
+ */
+function getBinaryArchiveUrl(repo, tag, version, platform, arch) {
+    const ext = platform === types_js_1.Platform.Windows ? types_js_1.Extension.Zip : types_js_1.Extension.Tar;
+    return `https://github.com/${repo}/releases/download/${tag}/foundry_${version}_${platform}_${arch}.${ext}`;
+}
+exports.getBinaryArchiveUrl = getBinaryArchiveUrl;
+/**
+ * Checks if binaries are already in the cache. If not, downloads and extracts them.
+ *
+ * @param url - The URL to download the binaries from
+ * @param binaries - The list of binaries to download
+ * @param cachePath - The path to the cache directory
+ * @param platform - The target platform
+ * @param arch - The target architecture
+ * @param checksums - Optional checksums for verification
+ * @returns A promise that resolves to the directory containing the downloaded binaries
+ */
+async function checkAndDownloadBinaries(url, binaries, cachePath, platform, arch, checksums) {
+    let downloadedBinaries;
+    try {
+        (0, utils_js_1.say)(`checking cache`);
+        downloadedBinaries = await (0, promises_1.opendir)(cachePath);
+        (0, utils_js_1.say)(`found binaries in cache`);
+    }
+    catch (e) {
+        (0, utils_js_1.say)(`binaries not in cache`);
+        if (e.code === 'ENOENT') {
+            (0, utils_js_1.say)(`installing from ${url.toString()}`);
+            // directory doesn't exist, download and extract
+            const platformChecksums = (0, utils_js_1.transformChecksums)(checksums, platform, arch);
+            await (0, extract_js_1.extractFrom)(url, binaries, cachePath, platformChecksums);
+            downloadedBinaries = await (0, promises_1.opendir)(cachePath);
+        }
+        else {
+            throw e;
+        }
+    }
+    return downloadedBinaries;
+}
+exports.checkAndDownloadBinaries = checkAndDownloadBinaries;
+/**
+ * Installs the downloaded binaries by creating symlinks or copying files.
+ *
+ * @param downloadedBinaries - The directory containing the downloaded binaries
+ * @param BIN_DIR - The target directory for installation
+ * @param cachePath - The path to the cache directory
+ * @returns A promise that resolves when installation is complete
+ */
+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));
+        // compute the relative path from where the symlink will be created
+        // to the target file, so that it works even if the project is moved
+        // (like in some CI environments)
+        const relativeTarget = (0, node_path_1.relative)((0, node_path_1.dirname)(path), 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_js_1.noop);
+        try {
+            // create new symlink
+            await (0, promises_1.symlink)(relativeTarget, path);
+        }
+        catch (e) {
+            if (!((0, utils_js_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_js_1.say)(`installed - ${(0, utils_js_1.getVersion)(path).toString()}`);
+    }
+}
+exports.installBinaries = installBinaries;
+/**
+ * Downloads and installs Foundry binaries based on command-line arguments.
+ * If the command is 'cache clean', it removes the cache directory.
+ * Otherwise, it downloads and installs the specified binaries.
+ *
+ * @returns A promise that resolves when the operation is complete
+ */
+async function downloadAndInstallFoundryBinaries() {
+    const parsedArgs = (0, options_js_1.parseArgs)();
+    const CACHE_DIR = getCacheDirectory();
+    if (parsedArgs.command === 'cache clean') {
+        await (0, promises_1.rm)(CACHE_DIR, { recursive: true, force: true });
+        (0, utils_js_1.say)('done!');
+        (0, node_process_1.exit)(0);
+    }
+    const { repo, version: { version, tag }, arch, platform, binaries, checksums, } = parsedArgs.options;
+    (0, options_js_1.printBanner)();
+    const bins = binaries.join(', ');
+    (0, utils_js_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_js_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 { createHash } from 'node:crypto';\nimport { readFileSync } from 'node:fs';\nimport type { Dir } from 'node:fs';\nimport {\n  copyFile,\n  mkdir,\n  opendir,\n  rm,\n  symlink,\n  unlink,\n} from 'node:fs/promises';\nimport { homedir } from 'node:os';\nimport { dirname, join, relative } from 'node:path';\nimport { cwd, exit } from 'node:process';\nimport { parse as parseYaml } from 'yaml';\n\nimport { extractFrom } from './extract.js';\nimport { parseArgs, printBanner } from './options.js';\nimport type { Checksums, Architecture, Binary } from './types.js';\nimport { Extension, Platform } from './types.js';\nimport {\n  getVersion,\n  isCodedError,\n  noop,\n  say,\n  transformChecksums,\n} from './utils.js';\n\n/**\n * Determines the cache directory based on the .yarnrc.yml configuration.\n * If global cache is enabled, returns a path in the user's home directory.\n * Otherwise, returns a local cache path in the current working directory.\n *\n * @returns The path to the cache directory\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(\n      'Warning: Error reading .yarnrc.yml, using local cache:',\n      error,\n    );\n  }\n  return enableGlobalCache\n    ? join(homedir(), '.cache', 'metamask')\n    : join(cwd(), '.metamask', 'cache');\n}\n\n/**\n * Generates the URL for downloading the Foundry binary archive.\n *\n * @param repo - The GitHub repository (e.g., 'foundry-rs/foundry')\n * @param tag - The release tag (e.g., 'v1.0.0')\n * @param version - The version string\n * @param platform - The target platform (e.g., Platform.Linux)\n * @param arch - The target architecture (e.g., 'amd64')\n * @returns The URL for the binary archive\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\n/**\n * Checks if binaries are already in the cache. If not, downloads and extracts them.\n *\n * @param url - The URL to download the binaries from\n * @param binaries - The list of binaries to download\n * @param cachePath - The path to the cache directory\n * @param platform - The target platform\n * @param arch - The target architecture\n * @param checksums - Optional checksums for verification\n * @returns A promise that resolves to the directory containing the downloaded binaries\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\n/**\n * Installs the downloaded binaries by creating symlinks or copying files.\n *\n * @param downloadedBinaries - The directory containing the downloaded binaries\n * @param BIN_DIR - The target directory for installation\n * @param cachePath - The path to the cache directory\n * @returns A promise that resolves when installation is complete\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    // compute the relative path from where the symlink will be created\n    // to the target file, so that it works even if the project is moved\n    // (like in some CI environments)\n    const relativeTarget = relative(dirname(path), 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(relativeTarget, 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).toString()}`);\n  }\n}\n\n/**\n * Downloads and installs Foundry binaries based on command-line arguments.\n * If the command is 'cache clean', it removes the cache directory.\n * Otherwise, it downloads and installs the specified binaries.\n *\n * @returns A promise that resolves when the operation is complete\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.ts → index.d.cts}

@@ -1,7 +1,10 @@
 #!/usr/bin/env -S node --require "./node_modules/tsx/dist/preflight.cjs" --import "./node_modules/tsx/dist/loader.mjs"
-import type { Dir } from 'node:fs';
-import type { Checksums, Architecture, Binary } from './types.js';
-import { Platform } from './types.js';
+/// <reference types="node" />
+/// <reference types="node/fs.js" />
+/// <reference types="npm-which/node_modules/@types/node/fs.js" />
+import type { Dir } from "node:fs";
+import type { Checksums, Architecture, Binary } from "./types.cjs";
+import { Platform } from "./types.cjs";
 /**
  * Determines the cache directory based on the .yarnrc.yml configuration.
  * If global cache is enabled, returns a path in the user's home directory.
@@ -50,4 +53,4 @@ export declare function installBinaries(downloadedBinaries: Dir, BIN_DIR: string
  * @returns A promise that resolves when the operation is complete
  */
 export declare function downloadAndInstallFoundryBinaries(): Promise<void>;
-//# sourceMappingURL=index.d.ts.map
+//# 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,KAAK,EAAE,GAAG,EAAE,gBAAgB;AAgBnC,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,oBAAmB;AAClE,OAAO,EAAa,QAAQ,EAAE,oBAAmB;AASjD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAoB1C;AAED;;;;;;;;;GASG;AACH,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;;;;;;;;;;GAUG;AACH,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;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,kBAAkB,EAAE,GAAG,EACvB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAgCf;AAED;;;;;;GAMG;AACH,wBAAsB,iCAAiC,IAAI,OAAO,CAAC,IAAI,CAAC,CAmDvE"}

package/dist/index.d.mts

@@ -0,0 +1,56 @@
+#!/usr/bin/env -S node --require "./node_modules/tsx/dist/preflight.cjs" --import "./node_modules/tsx/dist/loader.mjs"
+/// <reference types="node" />
+/// <reference types="node/fs.js" />
+/// <reference types="npm-which/node_modules/@types/node/fs.js" />
+import type { Dir } from "node:fs";
+import type { Checksums, Architecture, Binary } from "./types.mjs";
+import { Platform } from "./types.mjs";
+/**
+ * Determines the cache directory based on the .yarnrc.yml configuration.
+ * If global cache is enabled, returns a path in the user's home directory.
+ * Otherwise, returns a local cache path in the current working directory.
+ *
+ * @returns The path to the cache directory
+ */
+export declare function getCacheDirectory(): string;
+/**
+ * Generates the URL for downloading the Foundry binary archive.
+ *
+ * @param repo - The GitHub repository (e.g., 'foundry-rs/foundry')
+ * @param tag - The release tag (e.g., 'v1.0.0')
+ * @param version - The version string
+ * @param platform - The target platform (e.g., Platform.Linux)
+ * @param arch - The target architecture (e.g., 'amd64')
+ * @returns The URL for the binary archive
+ */
+export declare function getBinaryArchiveUrl(repo: string, tag: string, version: string, platform: Platform, arch: string): string;
+/**
+ * Checks if binaries are already in the cache. If not, downloads and extracts them.
+ *
+ * @param url - The URL to download the binaries from
+ * @param binaries - The list of binaries to download
+ * @param cachePath - The path to the cache directory
+ * @param platform - The target platform
+ * @param arch - The target architecture
+ * @param checksums - Optional checksums for verification
+ * @returns A promise that resolves to the directory containing the downloaded binaries
+ */
+export declare function checkAndDownloadBinaries(url: URL, binaries: Binary[], cachePath: string, platform: Platform, arch: Architecture, checksums?: Checksums): Promise<Dir>;
+/**
+ * Installs the downloaded binaries by creating symlinks or copying files.
+ *
+ * @param downloadedBinaries - The directory containing the downloaded binaries
+ * @param BIN_DIR - The target directory for installation
+ * @param cachePath - The path to the cache directory
+ * @returns A promise that resolves when installation is complete
+ */
+export declare function installBinaries(downloadedBinaries: Dir, BIN_DIR: string, cachePath: string): Promise<void>;
+/**
+ * Downloads and installs Foundry binaries based on command-line arguments.
+ * If the command is 'cache clean', it removes the cache directory.
+ * Otherwise, it downloads and installs the specified binaries.
+ *
+ * @returns A promise that resolves when the operation is complete
+ */
+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,KAAK,EAAE,GAAG,EAAE,gBAAgB;AAgBnC,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,oBAAmB;AAClE,OAAO,EAAa,QAAQ,EAAE,oBAAmB;AASjD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAoB1C;AAED;;;;;;;;;GASG;AACH,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;;;;;;;;;;GAUG;AACH,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;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,kBAAkB,EAAE,GAAG,EACvB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAgCf;AAED;;;;;;GAMG;AACH,wBAAsB,iCAAiC,IAAI,OAAO,CAAC,IAAI,CAAC,CAmDvE"}

package/dist/{index.js → index.mjs}

@@ -1,15 +1,15 @@
 #!/usr/bin/env -S node --require "./node_modules/tsx/dist/preflight.cjs" --import "./node_modules/tsx/dist/loader.mjs"
-import { createHash } from 'node:crypto';
-import { readFileSync } from 'node:fs';
-import { copyFile, mkdir, opendir, rm, symlink, unlink, } from 'node:fs/promises';
-import { homedir } from 'node:os';
-import { dirname, join, relative } from 'node:path';
-import { cwd, exit } from 'node:process';
-import { parse as parseYaml } from 'yaml';
-import { extractFrom } from './extract.js';
-import { parseArgs, printBanner } from './options.js';
-import { Extension, Platform } from './types.js';
-import { getVersion, isCodedError, noop, say, transformChecksums, } from './utils.js';
+import { createHash } from "node:crypto";
+import { readFileSync } from "node:fs";
+import { copyFile, mkdir, opendir, rm, symlink, unlink } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join, relative } from "node:path";
+import { cwd, exit } from "node:process";
+import { parse as parseYaml } from "yaml";
+import { extractFrom } from "./extract.mjs";
+import { parseArgs, printBanner } from "./options.mjs";
+import { Extension, Platform } from "./types.mjs";
+import { getVersion, isCodedError, noop, say, transformChecksums } from "./utils.mjs";
 /**
  * Determines the cache directory based on the .yarnrc.yml configuration.
  * If global cache is enabled, returns a path in the user's home directory.
@@ -152,4 +152,4 @@ export async function downloadAndInstallFoundryBinaries() {
     await installBinaries(downloadedBinaries, BIN_DIR, cachePath);
     say('done!');
 }
-//# sourceMappingURL=index.js.map
+//# 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 { createHash } from 'node:crypto';\nimport { readFileSync } from 'node:fs';\nimport type { Dir } from 'node:fs';\nimport {\n  copyFile,\n  mkdir,\n  opendir,\n  rm,\n  symlink,\n  unlink,\n} from 'node:fs/promises';\nimport { homedir } from 'node:os';\nimport { dirname, join, relative } from 'node:path';\nimport { cwd, exit } from 'node:process';\nimport { parse as parseYaml } from 'yaml';\n\nimport { extractFrom } from './extract.js';\nimport { parseArgs, printBanner } from './options.js';\nimport type { Checksums, Architecture, Binary } from './types.js';\nimport { Extension, Platform } from './types.js';\nimport {\n  getVersion,\n  isCodedError,\n  noop,\n  say,\n  transformChecksums,\n} from './utils.js';\n\n/**\n * Determines the cache directory based on the .yarnrc.yml configuration.\n * If global cache is enabled, returns a path in the user's home directory.\n * Otherwise, returns a local cache path in the current working directory.\n *\n * @returns The path to the cache directory\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(\n      'Warning: Error reading .yarnrc.yml, using local cache:',\n      error,\n    );\n  }\n  return enableGlobalCache\n    ? join(homedir(), '.cache', 'metamask')\n    : join(cwd(), '.metamask', 'cache');\n}\n\n/**\n * Generates the URL for downloading the Foundry binary archive.\n *\n * @param repo - The GitHub repository (e.g., 'foundry-rs/foundry')\n * @param tag - The release tag (e.g., 'v1.0.0')\n * @param version - The version string\n * @param platform - The target platform (e.g., Platform.Linux)\n * @param arch - The target architecture (e.g., 'amd64')\n * @returns The URL for the binary archive\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\n/**\n * Checks if binaries are already in the cache. If not, downloads and extracts them.\n *\n * @param url - The URL to download the binaries from\n * @param binaries - The list of binaries to download\n * @param cachePath - The path to the cache directory\n * @param platform - The target platform\n * @param arch - The target architecture\n * @param checksums - Optional checksums for verification\n * @returns A promise that resolves to the directory containing the downloaded binaries\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\n/**\n * Installs the downloaded binaries by creating symlinks or copying files.\n *\n * @param downloadedBinaries - The directory containing the downloaded binaries\n * @param BIN_DIR - The target directory for installation\n * @param cachePath - The path to the cache directory\n * @returns A promise that resolves when installation is complete\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    // compute the relative path from where the symlink will be created\n    // to the target file, so that it works even if the project is moved\n    // (like in some CI environments)\n    const relativeTarget = relative(dirname(path), 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(relativeTarget, 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).toString()}`);\n  }\n}\n\n/**\n * Downloads and installs Foundry binaries based on command-line arguments.\n * If the command is 'cache clean', it removes the cache directory.\n * Otherwise, it downloads and installs the specified binaries.\n *\n * @returns A promise that resolves when the operation is complete\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,157 @@
+"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 types_js_1 = require("./types.cjs");
+const utils_js_1 = require("./utils.cjs");
+/**
+ * Type guard to check if a string is a valid version string starting with 'v'.
+ *
+ * @param value - The string to check
+ * @returns True if the string is a valid version string
+ */
+function isVersionString(value) {
+    return /^v\d/u.test(value);
+}
+/**
+ * Prints the Foundry banner to the console.
+ */
+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;
+/**
+ * Parses command line arguments and returns the parsed options.
+ *
+ * @param args - Command line arguments to parse
+ * @returns Parsed command line arguments
+ */
+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_js_1.Binary);
+/**
+ * Returns the command line options configuration.
+ *
+ * @param defaultPlatform - Default platform to use
+ * @param defaultArch - Default architecture to use
+ * @returns Command line options configuration
+ */
+function getOptions(defaultPlatform = (0, node_os_1.platform)(), defaultArch = (0, utils_js_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 (rawVersion.startsWith('nightly')) {
+                    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_js_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_js_1.Platform),
+        },
+    };
+}
+//# sourceMappingURL=options.cjs.map

package/dist/options.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.cjs","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"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","sourcesContent":["import { platform } from 'node:os';\nimport { argv, stdout } from 'node:process';\nimport yargs from 'yargs/yargs';\n\nimport { Architecture, Binary, Platform } from './types.js';\nimport type {\n  Checksums,\n  ParsedOptions,\n  ArchitecturesTuple,\n  BinariesTuple,\n  PlatformsTuple,\n} from './types.js';\nimport { normalizeSystemArchitecture } from './utils.js';\n\n/**\n * Type guard to check if a string is a valid version string starting with 'v'.\n *\n * @param value - The string to check\n * @returns True if the string is a valid version string\n */\nfunction isVersionString(value: string): value is `v${string}` {\n  return /^v\\d/u.test(value);\n}\n\n/**\n * Prints the Foundry banner to the console.\n */\nexport function printBanner() {\n  console.log(`\n.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx\n\n ╔═╗ ╔═╗ ╦ ╦ ╔╗╔ ╔╦╗ ╦═╗ ╦ ╦         Portable and modular toolkit\n ╠╣  ║ ║ ║ ║ ║║║  ║║ ╠╦╝ ╚╦╝    for Ethereum Application Development\n ╚   ╚═╝ ╚═╝ ╝╚╝ ═╩╝ ╩╚═  ╩                 written in Rust.\n\n.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx\n\nRepo       : https://github.com/foundry-rs/\nBook       : https://book.getfoundry.sh/\nChat       : https://t.me/foundry_rs/\nSupport    : https://t.me/foundry_support/\nContribute : https://github.com/orgs/foundry-rs/projects/2/\n\n.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx\n`);\n}\n\n/**\n * Parses command line arguments and returns the parsed options.\n *\n * @param args - Command line arguments to parse\n * @returns Parsed command line arguments\n */\nexport function parseArgs(args: string[] = argv.slice(2)) {\n  const { $0, _, ...parsed } = yargs()\n    // Ensure unrecognized commands/options are reported as errors.\n    .strict()\n    // disable yargs's version, as it doesn't make sense here\n    .version(false)\n    // use the scriptName in `--help` output\n    .scriptName('yarn foundryup')\n    // wrap output at a maximum of 120 characters or `stdout.columns`\n    .wrap(Math.min(120, stdout.columns))\n    .parserConfiguration({\n      'strip-aliased': true,\n      'strip-dashed': true,\n    })\n    // enable ENV parsing, which allows the user to specify foundryup options\n    // via environment variables prefixed with `FOUNDRYUP_`\n    .env('FOUNDRYUP')\n    .command(['$0', 'install'], 'Install foundry binaries', (builder) => {\n      builder.options(getOptions()).pkgConf('foundryup');\n    })\n    .command('cache', '', (builder) => {\n      builder.command('clean', 'Remove the shared cache files').demandCommand();\n    })\n    .parseSync(args);\n\n  const command = _.join(' ');\n  if (command === 'cache clean') {\n    return {\n      command,\n    } as const;\n  }\n\n  // if we get here `command` is always 'install' or '' (yargs checks it)\n  return {\n    command: 'install',\n    options: parsed as ParsedOptions<ReturnType<typeof getOptions>>,\n  } as const;\n}\n\nconst Binaries = Object.values(Binary) as BinariesTuple;\n\n/**\n * Returns the command line options configuration.\n *\n * @param defaultPlatform - Default platform to use\n * @param defaultArch - Default architecture to use\n * @returns Command line options configuration\n */\nfunction getOptions(\n  defaultPlatform = platform(),\n  defaultArch = normalizeSystemArchitecture(),\n) {\n  return {\n    binaries: {\n      alias: 'b',\n      type: 'array' as const,\n      multiple: true,\n      description: 'Specify the binaries to install',\n      default: Binaries,\n      choices: Binaries,\n      coerce: (values: Binary[]): Binary[] => [...new Set(values)], // Remove duplicates\n    },\n    checksums: {\n      alias: 'c',\n      description: 'JSON object containing checksums for the binaries.',\n      coerce: (rawChecksums: string | Checksums): Checksums => {\n        try {\n          return typeof rawChecksums === 'string'\n            ? JSON.parse(rawChecksums)\n            : rawChecksums;\n        } catch {\n          throw new Error('Invalid checksums');\n        }\n      },\n      optional: true,\n    },\n    repo: {\n      alias: 'r',\n      description: 'Specify the repository',\n      default: 'foundry-rs/foundry',\n    },\n    version: {\n      alias: 'v',\n      description:\n        'Specify the version (see: https://github.com/foundry-rs/foundry/tags)',\n      default: 'nightly',\n      coerce: (\n        rawVersion: string,\n      ): { version: 'nightly' | `v${string}`; tag: string } => {\n        if (rawVersion.startsWith('nightly')) {\n          return { version: 'nightly', tag: rawVersion };\n          // we don't validate the version much, we just trust the user\n        } else if (isVersionString(rawVersion)) {\n          return { version: rawVersion, tag: rawVersion };\n        }\n        throw new Error('Invalid version');\n      },\n    },\n    arch: {\n      alias: 'a',\n      description: 'Specify the architecture',\n      // if `defaultArch` is not a supported Architecture yargs will throw an error\n      default: defaultArch,\n      choices: Object.values(Architecture) as ArchitecturesTuple,\n    },\n    platform: {\n      alias: 'p',\n      description: 'Specify the platform',\n      // if `defaultPlatform` is not a supported Platform yargs will throw an error\n      default: defaultPlatform as Platform,\n      choices: Object.values(Platform) as PlatformsTuple,\n    },\n  };\n}\n"]}

package/dist/options.d.cts

@@ -0,0 +1,62 @@
+import { Architecture, Binary, Platform } from "./types.cjs";
+import type { Checksums, ParsedOptions } from "./types.cjs";
+/**
+ * Prints the Foundry banner to the console.
+ */
+export declare function printBanner(): void;
+/**
+ * Parses command line arguments and returns the parsed options.
+ *
+ * @param args - Command line arguments to parse
+ * @returns Parsed command line arguments
+ */
+export declare function parseArgs(args?: string[]): {
+    readonly command: "cache clean";
+    readonly options?: undefined;
+} | {
+    readonly command: "install";
+    readonly options: ParsedOptions<{
+        binaries: {
+            alias: string;
+            type: "array";
+            multiple: boolean;
+            description: string;
+            default: [Binary];
+            choices: [Binary];
+            coerce: (values: Binary[]) => Binary[];
+        };
+        checksums: {
+            alias: string;
+            description: string;
+            coerce: (rawChecksums: string | Checksums) => Checksums;
+            optional: boolean;
+        };
+        repo: {
+            alias: string;
+            description: string;
+            default: string;
+        };
+        version: {
+            alias: string;
+            description: string;
+            default: string;
+            coerce: (rawVersion: string) => {
+                version: `v${string}` | "nightly";
+                tag: string;
+            };
+        };
+        arch: {
+            alias: string;
+            description: string;
+            default: Architecture;
+            choices: [Architecture];
+        };
+        platform: {
+            alias: string;
+            description: string;
+            default: Platform;
+            choices: [Platform];
+        };
+    }>;
+};
+//# sourceMappingURL=options.d.cts.map

package/dist/options.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.cts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAmB;AAC5D,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EAId,oBAAmB;AAapB;;GAEG;AACH,wBAAgB,WAAW,SAkB1B;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,GAAE,MAAM,EAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqCvD"}

package/dist/options.d.mts

@@ -0,0 +1,62 @@
+import { Architecture, Binary, Platform } from "./types.mjs";
+import type { Checksums, ParsedOptions } from "./types.mjs";
+/**
+ * Prints the Foundry banner to the console.
+ */
+export declare function printBanner(): void;
+/**
+ * Parses command line arguments and returns the parsed options.
+ *
+ * @param args - Command line arguments to parse
+ * @returns Parsed command line arguments
+ */
+export declare function parseArgs(args?: string[]): {
+    readonly command: "cache clean";
+    readonly options?: undefined;
+} | {
+    readonly command: "install";
+    readonly options: ParsedOptions<{
+        binaries: {
+            alias: string;
+            type: "array";
+            multiple: boolean;
+            description: string;
+            default: [Binary];
+            choices: [Binary];
+            coerce: (values: Binary[]) => Binary[];
+        };
+        checksums: {
+            alias: string;
+            description: string;
+            coerce: (rawChecksums: string | Checksums) => Checksums;
+            optional: boolean;
+        };
+        repo: {
+            alias: string;
+            description: string;
+            default: string;
+        };
+        version: {
+            alias: string;
+            description: string;
+            default: string;
+            coerce: (rawVersion: string) => {
+                version: `v${string}` | "nightly";
+                tag: string;
+            };
+        };
+        arch: {
+            alias: string;
+            description: string;
+            default: Architecture;
+            choices: [Architecture];
+        };
+        platform: {
+            alias: string;
+            description: string;
+            default: Platform;
+            choices: [Platform];
+        };
+    }>;
+};
+//# sourceMappingURL=options.d.mts.map