graphify-sf 0.3.6 → 0.3.8

package/install.js

@@ -1,8 +1,39 @@
 "use strict";
 
+// postinstall hook.
+//
+// The graphify-sf npm package is a thin wrapper that fetches a prebuilt binary
+// from the project's GitHub Releases. In locked-down corporate networks the
+// download can be blocked by a proxy or firewall. A failed download here MUST
+// NOT abort `npm install` for the whole dependency tree — graphify-sf is an
+// optional second engine for its consumers, so a missing binary should degrade
+// gracefully (the binary is fetched lazily on first run, and there are offline
+// remediation paths).
+//
+// Therefore: never exit non-zero from postinstall. Print a clear, actionable
+// warning and exit 0. The actual binary resolution happens later via
+// download.ensureBinary() at first invocation.
+
 const { download } = require("./lib/download");
 
-download().catch((err) => {
-  process.stderr.write(`graphify-sf postinstall failed: ${err.message}\n`);
-  process.exit(1);
-});
+download()
+  .then(() => {
+    process.exit(0);
+  })
+  .catch((err) => {
+    process.stderr.write(
+      `\ngraphify-sf: could not pre-fetch the CLI binary during install.\n` +
+        `  Reason: ${err.message}\n` +
+        `\n` +
+        `  This is non-fatal — installation will continue. The binary will be\n` +
+        `  fetched automatically the first time you run graphify-sf, provided\n` +
+        `  network access is available then.\n` +
+        `\n` +
+        `  If your network blocks GitHub Releases, use one of these instead:\n` +
+        `    • Install the Python package directly:  pipx install graphify-sf\n` +
+        `    • Point at an existing binary:           export GRAPHIFY_BIN=/path/to/graphify-sf\n` +
+        `\n`
+    );
+    // Non-fatal: do not break the consumer's `npm install`.
+    process.exit(0);
+  });

package/lib/download.js

@@ -120,12 +120,34 @@ async function download() {
   process.stdout.write(`graphify-sf: installed to ${dest}\n`);
 }
 
+// Resolve a user-supplied binary path from the GRAPHIFY_BIN environment
+// variable. This is the highest-priority resolution and is the documented
+// escape hatch for locked-down networks where the GitHub download is blocked.
+// Returns the path if it points at an existing file, otherwise null.
+function envBinary() {
+  const p = process.env.GRAPHIFY_BIN;
+  if (p && fs.existsSync(p)) {
+    return p;
+  }
+  return null;
+}
+
 async function ensureBinary() {
+  // 1. Explicit override always wins.
+  const fromEnv = envBinary();
+  if (fromEnv) {
+    return fromEnv;
+  }
+
+  // 2. Already-downloaded binary in the package's bin/ dir.
   const dest = binaryPath();
-  if (!fs.existsSync(dest)) {
-    await download();
+  if (fs.existsSync(dest)) {
+    return dest;
   }
+
+  // 3. Lazily download on first use.
+  await download();
   return dest;
 }
 
-module.exports = { assetName, binaryPath, binDir, download, ensureBinary };
+module.exports = { assetName, binaryPath, binDir, download, ensureBinary, envBinary };

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "graphify-sf",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "description": "Turn any Salesforce SFDX project into a queryable knowledge graph — no Python required.",
   "bin": {
     "graphify-sf": "bin/graphify-sf.js"
   },
   "main": "index.js",
   "scripts": {
-    "postinstall": "node install.js"
+    "postinstall": "node install.js",
+    "test": "node --test"
   },
   "files": [
     "bin/",