@metamask-previews/foundryup 0.0.0-preview-c1fef6e5 → 1.0.0-preview-d2bf8ff

package/dist/index.cjs

@@ -2,17 +2,24 @@
 "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_crypto_1 = require("node:crypto");
 const node_fs_1 = require("node:fs");
 const promises_1 = require("node:fs/promises");
-const node_crypto_1 = require("node:crypto");
+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 utils_1 = require("./utils.cjs");
 const extract_1 = require("./extract.cjs");
 const options_1 = require("./options.cjs");
 const types_1 = require("./types.cjs");
+const utils_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 {
@@ -33,11 +40,32 @@ function getCacheDirectory() {
         : (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_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;
+/**
+ * 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 {
@@ -61,6 +89,14 @@ async function checkAndDownloadBinaries(url, binaries, cachePath, platform, arch
     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()) {
@@ -85,10 +121,17 @@ async function installBinaries(downloadedBinaries, BIN_DIR, cachePath) {
             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)}`);
+        (0, utils_1.say)(`installed - ${(0, utils_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_1.parseArgs)();
     const CACHE_DIR = getCacheDirectory();

package/dist/index.cjs.map

@@ -1 +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"]}
+{"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 { join, relative } from 'node:path';\nimport { cwd, exit } from 'node:process';\nimport { parse as parseYaml } from 'yaml';\n\nimport { extractFrom } from './extract';\nimport { parseArgs, printBanner } from './options';\nimport type { Checksums, Architecture, Binary } from './types';\nimport { Extension, Platform } from './types';\nimport {\n  getVersion,\n  isCodedError,\n  noop,\n  say,\n  transformChecksums,\n} from './utils';\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    // 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).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.cts

@@ -1,11 +1,54 @@
 #!/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";
+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.
+ * 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.cts.map

package/dist/index.d.cts.map

@@ -1 +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"}
+{"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,oBAAgB;AAC/D,OAAO,EAAa,QAAQ,EAAE,oBAAgB;AAS9C;;;;;;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,CA2Bf;AAED;;;;;;GAMG;AACH,wBAAsB,iCAAiC,IAAI,OAAO,CAAC,IAAI,CAAC,CAmDvE"}

package/dist/index.d.mts

@@ -1,11 +1,54 @@
 #!/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";
+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

@@ -1 +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"}
+{"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,oBAAgB;AAC/D,OAAO,EAAa,QAAQ,EAAE,oBAAgB;AAS9C;;;;;;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,CA2Bf;AAED;;;;;;GAMG;AACH,wBAAsB,iCAAiC,IAAI,OAAO,CAAC,IAAI,CAAC,CAmDvE"}

package/dist/index.mjs

@@ -1,16 +1,22 @@
 #!/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 { readFileSync } from "node:fs";
+import { copyFile, mkdir, opendir, rm, symlink, unlink } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, relative } from "node:path";
 import { cwd, exit } from "node:process";
-import $yaml from "yaml";
-const { parse: parseYaml } = $yaml;
-import { getVersion, isCodedError, noop, say, transformChecksums } from "./utils.mjs";
+import { parse as parseYaml } from "yaml";
 import { extractFrom } from "./extract.mjs";
 import { parseArgs, printBanner } from "./options.mjs";
-import { Architecture, Binary, Extension, Platform } from "./types.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.
+ * Otherwise, returns a local cache path in the current working directory.
+ *
+ * @returns The path to the cache directory
+ */
 export function getCacheDirectory() {
     let enableGlobalCache = false;
     try {
@@ -30,10 +36,31 @@ export function getCacheDirectory() {
         ? join(homedir(), '.cache', 'metamask')
         : join(cwd(), '.metamask', 'cache');
 }
+/**
+ * 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 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}`;
 }
+/**
+ * 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 async function checkAndDownloadBinaries(url, binaries, cachePath, platform, arch, checksums) {
     let downloadedBinaries;
     try {
@@ -56,6 +83,14 @@ export async function checkAndDownloadBinaries(url, binaries, cachePath, platfor
     }
     return downloadedBinaries;
 }
+/**
+ * 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 async function installBinaries(downloadedBinaries, BIN_DIR, cachePath) {
     for await (const file of downloadedBinaries) {
         if (!file.isFile()) {
@@ -80,9 +115,16 @@ export async function installBinaries(downloadedBinaries, BIN_DIR, cachePath) {
             await copyFile(target, path);
         }
         // check that it works by logging the version
-        say(`installed - ${getVersion(path)}`);
+        say(`installed - ${getVersion(path).toString()}`);
     }
 }
+/**
+ * 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 async function downloadAndInstallFoundryBinaries() {
     const parsedArgs = parseArgs();
     const CACHE_DIR = getCacheDirectory();

package/dist/index.mjs.map

@@ -1 +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"]}
+{"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 { join, relative } from 'node:path';\nimport { cwd, exit } from 'node:process';\nimport { parse as parseYaml } from 'yaml';\n\nimport { extractFrom } from './extract';\nimport { parseArgs, printBanner } from './options';\nimport type { Checksums, Architecture, Binary } from './types';\nimport { Extension, Platform } from './types';\nimport {\n  getVersion,\n  isCodedError,\n  noop,\n  say,\n  transformChecksums,\n} from './utils';\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    // 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).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

@@ -7,11 +7,20 @@ 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");
+const utils_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
@@ -32,6 +41,12 @@ Contribute : https://github.com/orgs/foundry-rs/projects/2/
 `);
 }
 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.
@@ -70,6 +85,13 @@ function parseArgs(args = node_process_1.argv.slice(2)) {
 }
 exports.parseArgs = parseArgs;
 const Binaries = Object.values(types_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_1.normalizeSystemArchitecture)()) {
     return {
         binaries: {
@@ -106,7 +128,7 @@ function getOptions(defaultPlatform = (0, node_os_1.platform)(), defaultArch = (
             description: 'Specify the version (see: https://github.com/foundry-rs/foundry/tags)',
             default: 'nightly',
             coerce: (rawVersion) => {
-                if (/^nightly/u.test(rawVersion)) {
+                if (rawVersion.startsWith('nightly')) {
                     return { version: 'nightly', tag: rawVersion };
                     // we don't validate the version much, we just trust the user
                 }

package/dist/options.cjs.map

@@ -1 +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';\nimport { normalizeSystemArchitecture } from './utils';\nimport {\n  type Checksums,\n  type ParsedOptions,\n  type ArchitecturesTuple,\n  type BinariesTuple,\n  type PlatformsTuple,\n  Architecture,\n  Binary,\n  Platform,\n} from './types';\n\nfunction isVersionString(value: string): value is `v${string}` {\n  return /^v\\d/u.test(value);\n}\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\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\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 (/^nightly/u.test(rawVersion)) {\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 as Architecture,\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"]}
+{"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 {\n  type Checksums,\n  type ParsedOptions,\n  type ArchitecturesTuple,\n  type BinariesTuple,\n  type PlatformsTuple,\n  Architecture,\n  Binary,\n  Platform,\n} from './types';\nimport { normalizeSystemArchitecture } from './utils';\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 as Architecture,\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

@@ -1,5 +1,14 @@
 import { type Checksums, type ParsedOptions, Architecture, Binary, Platform } 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;

package/dist/options.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"options.d.cts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,SAAS,EACd,KAAK,aAAa,EAIlB,YAAY,EACZ,MAAM,EACN,QAAQ,EACT,oBAAgB;AAMjB,wBAAgB,WAAW,SAkB1B;AAED,wBAAgB,SAAS,CAAC,IAAI,GAAE,MAAM,EAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqCvD"}
+{"version":3,"file":"options.d.cts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,SAAS,EACd,KAAK,aAAa,EAIlB,YAAY,EACZ,MAAM,EACN,QAAQ,EACT,oBAAgB;AAajB;;GAEG;AACH,wBAAgB,WAAW,SAkB1B;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,GAAE,MAAM,EAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqCvD"}

package/dist/options.d.mts

@@ -1,5 +1,14 @@
 import { type Checksums, type ParsedOptions, Architecture, Binary, Platform } 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;

package/dist/options.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"options.d.mts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,SAAS,EACd,KAAK,aAAa,EAIlB,YAAY,EACZ,MAAM,EACN,QAAQ,EACT,oBAAgB;AAMjB,wBAAgB,WAAW,SAkB1B;AAED,wBAAgB,SAAS,CAAC,IAAI,GAAE,MAAM,EAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqCvD"}
+{"version":3,"file":"options.d.mts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,SAAS,EACd,KAAK,aAAa,EAIlB,YAAY,EACZ,MAAM,EACN,QAAQ,EACT,oBAAgB;AAajB;;GAEG;AACH,wBAAgB,WAAW,SAkB1B;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,GAAE,MAAM,EAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqCvD"}

package/dist/options.mjs

@@ -1,11 +1,20 @@
 import { platform } from "node:os";
 import { argv, stdout } from "node:process";
 import yargs from "yargs/yargs";
-import { normalizeSystemArchitecture } from "./utils.mjs";
 import { Architecture, Binary, Platform } from "./types.mjs";
+import { normalizeSystemArchitecture } from "./utils.mjs";
+/**
+ * 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.
+ */
 export function printBanner() {
     console.log(`
 .xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx.xOx
@@ -25,6 +34,12 @@ 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
 `);
 }
+/**
+ * Parses command line arguments and returns the parsed options.
+ *
+ * @param args - Command line arguments to parse
+ * @returns Parsed command line arguments
+ */
 export function parseArgs(args = argv.slice(2)) {
     const { $0, _, ...parsed } = yargs()
         // Ensure unrecognized commands/options are reported as errors.
@@ -62,6 +77,13 @@ export function parseArgs(args = argv.slice(2)) {
     };
 }
 const Binaries = Object.values(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 = platform(), defaultArch = normalizeSystemArchitecture()) {
     return {
         binaries: {
@@ -98,7 +120,7 @@ function getOptions(defaultPlatform = platform(), defaultArch = normalizeSystemA
             description: 'Specify the version (see: https://github.com/foundry-rs/foundry/tags)',
             default: 'nightly',
             coerce: (rawVersion) => {
-                if (/^nightly/u.test(rawVersion)) {
+                if (rawVersion.startsWith('nightly')) {
                     return { version: 'nightly', tag: rawVersion };
                     // we don't validate the version much, we just trust the user
                 }