@fastmoss/cli 0.1.0 → 0.1.1

package/README.md

@@ -4,6 +4,14 @@ FastMoss CLI launcher for npm and npx.
 
 This package does not bundle the Go binary itself. On first run it downloads the matching `fastmoss` binary from GitHub Releases, stores it in a local cache directory, and then forwards all CLI arguments to that binary.
 
+During `npm install`, the package tries to predownload the matching binary for the current platform. If the download fails, installation still completes and the wrapper will retry the download on first run.
+
+If your npm configuration blocks lifecycle scripts, allow this package's postinstall script to predownload during install:
+
+```bash
+npm install -g --allow-scripts=@fastmoss/cli @fastmoss/cli
+```
+
 ## Usage
 
 Run without installing:
@@ -49,6 +57,12 @@ You can override the cache directory:
 FASTMOSS_CACHE_DIR=/custom/cache/dir npx @fastmoss/cli
 ```
 
+You can skip the install-time download:
+
+```bash
+FASTMOSS_SKIP_DOWNLOAD=1 npm install -g @fastmoss/cli
+```
+
 ## Download Source
 
 By default the wrapper downloads binaries from the public GitHub release repository configured in `package.json`.

package/bin/postinstall.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+
+const packageJSON = require("../package.json");
+const { installCLI } = require("../lib/runtime");
+
+installCLI({
+  version: packageJSON.version,
+  configuredDownloadBaseURL: packageJSON.fastmoss?.downloadBaseURL,
+}).catch((error) => {
+  process.stderr.write(`fastmoss postinstall warning: ${error.message}\n`);
+  process.stderr.write("The binary will be downloaded on first run.\n");
+});

package/lib/runtime.js

@@ -104,6 +104,8 @@ async function ensureBinary({
   arch = process.arch,
   homeDir = os.homedir(),
   configuredDownloadBaseURL = "",
+  onDownloadStart = () => {},
+  downloadFileFn = downloadFile,
 }) {
   const target = resolvePlatformTarget({ platform, arch });
   const cacheRoot = resolveCacheRoot({ env, homeDir });
@@ -122,7 +124,8 @@ async function ensureBinary({
   });
   const tempPath = `${binaryPath}.download`;
 
-  await downloadFile(downloadURL, tempPath);
+  onDownloadStart(downloadURL);
+  await downloadFileFn(downloadURL, tempPath);
 
   if (platform !== "win32") {
     await fs.promises.chmod(tempPath, 0o755);
@@ -132,6 +135,40 @@ async function ensureBinary({
   return { binaryPath, downloaded: true, downloadURL };
 }
 
+function shouldSkipDownload(env = process.env) {
+  const value = String(env.FASTMOSS_SKIP_DOWNLOAD || "").trim().toLowerCase();
+  return value !== "" && value !== "0" && value !== "false";
+}
+
+async function installCLI({
+  version,
+  env = process.env,
+  platform = process.platform,
+  arch = process.arch,
+  homeDir = os.homedir(),
+  stderr = process.stderr,
+  configuredDownloadBaseURL = "",
+} = {}) {
+  if (shouldSkipDownload(env)) {
+    stderr.write(
+      "Skipping fastmoss binary download because FASTMOSS_SKIP_DOWNLOAD is set.\n",
+    );
+    return { skipped: true };
+  }
+
+  return ensureBinary({
+    version,
+    env,
+    platform,
+    arch,
+    homeDir,
+    configuredDownloadBaseURL,
+    onDownloadStart(downloadURL) {
+      stderr.write(`Downloading fastmoss ${version} from ${downloadURL}\n`);
+    },
+  });
+}
+
 async function fileExists(filePath) {
   try {
     const stat = await fs.promises.stat(filePath);
@@ -239,10 +276,13 @@ async function runCLI({
     arch,
     homeDir,
     configuredDownloadBaseURL,
+    onDownloadStart(downloadURL) {
+      stderr.write(`Downloading fastmoss ${version} from ${downloadURL}\n`);
+    },
   });
 
   if (downloaded) {
-    stderr.write(`Downloading fastmoss ${version} from ${downloadURL}\n`);
+    stderr.write(`Downloaded fastmoss ${version} to ${binaryPath}\n`);
   }
 
   await new Promise((resolve, reject) => {
@@ -266,6 +306,7 @@ module.exports = {
   DEFAULT_DOWNLOAD_BASE_URL,
   buildDownloadURL,
   ensureBinary,
+  installCLI,
   resolveBinaryPath,
   resolveCacheRoot,
   resolveDownloadBaseURL,

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@fastmoss/cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "FastMoss CLI launcher for npm and npx",
   "license": "UNLICENSED",
   "private": false,
   "bin": {
-    "fastmoss": "./bin/fastmoss.js"
+    "fastmoss": "bin/fastmoss.js"
   },
   "files": [
     "bin",
@@ -13,6 +13,7 @@
     "README.md"
   ],
   "scripts": {
+    "postinstall": "node ./bin/postinstall.js",
     "test": "node --test ./test/*.test.js"
   },
   "engines": {