electrobun 2.0.1-beta.2 → 2.0.1-beta.22

package/README.md

@@ -1,9 +1,9 @@
 # Electrobun npm bootstrap
 
-The `electrobun` npm package is a small compatibility entry point for npm,
-pnpm, Yarn, and Bun users. It contains no Electrobun runtime or SDK. The
-`electrobun` command installs Hutch into `~/.dash` when necessary and delegates
-all commands to `hutch electrobun`.
+The `electrobun` npm package is a small Hutch entry point for npm, pnpm, Yarn,
+and Bun users. It contains no Electrobun runtime or SDK. The `electrobun`
+command installs Hutch into `~/.hutch` (override with `HUTCH_HOME`) when
+necessary and delegates all commands to `hutch electrobun`.
 
 Create a project from the current stable template catalog:
 
@@ -20,14 +20,16 @@ npx electrobun init --beta
 The npm bootstrap ships under the same release version as Electrobun, but it
 does not contain or select the runtime by itself. An application's exact
 Electrobun version is selected in `hutch.config.ts`; Hutch downloads the
-matching runtime and SDK into the shared `~/.dash` store and projects the SDKs
-into the project's `.hutch/devkit` sysroot. Installing a beta bootstrap still
-uses stable templates unless `init` receives `--beta`.
+matching runtime and SDK into the shared `~/.hutch/releases/electrobun` store
+and projects the SDKs into the project's `.hutch/devkit` sysroot. Installing a
+beta bootstrap still uses stable templates unless `init` receives `--beta`.
 
 `DASH_RELEASE_OFFLINE=1` prevents this bootstrap from downloading a missing
-Hutch installation. An already installed Hutch is still invoked, and the flag
-continues to prevent network access for Dash-managed releases and artifacts.
-It does not put npm or another project package manager into offline mode.
+Hutch installation. An already installed Hutch is still invoked, but
+`electrobun init` requires network access for the current template catalog and
+selected template. Builds can run without network access only when every exact
+release and managed toolchain they require is already installed. The flag does
+not put npm or another project package manager into offline mode.
 
 You can install Hutch directly from <https://hutch.blackboard.sh> and run the
 same commands without npm:

package/bin/electrobun.cjs

@@ -11,7 +11,9 @@ const installerBaseUrl = "https://hutch.blackboard.sh/hutch";
 const maxInstallerBytes = 1024 * 1024;
 const maxInstallerRedirects = 5;
 
-function normalizeChannel(value) {
+// Hutch owns a separate release-channel contract: its stable executable is
+// still published under Hutch's "production" channel.
+function normalizeHutchChannel(value) {
 	if (value === "stable") return "production";
 	if (value === "production" || value === "canary") return value;
 	return null;
@@ -19,7 +21,7 @@ function normalizeChannel(value) {
 
 function hutchChannel(environment) {
 	for (const key of ["ELECTROBUN_HUTCH_CHANNEL", "HUTCH_ACTIVE_CHANNEL"]) {
-		const selected = normalizeChannel(environment[key]);
+		const selected = normalizeHutchChannel(environment[key]);
 		if (selected) return selected;
 	}
 	return "production";
@@ -39,11 +41,16 @@ function hutchBinaryPath(channel, environment, platform, userHome) {
 		return environment.ELECTROBUN_HUTCH_BINARY;
 	}
 
-	const dashHome = environment.DASH_HOME || path.join(userHome, ".dash");
-	const command = channel === "canary" ? "hutch-canary" : "hutch";
 	const pathApi = platform === "win32" ? path.win32 : path.posix;
+	// HUTCH_HOME is Hutch's own home; DASH_HOME stays honored as a deprecated
+	// fallback for Dash Desktop and older setups.
+	const hutchHome =
+		environment.HUTCH_HOME ||
+		environment.DASH_HOME ||
+		pathApi.join(userHome, ".hutch");
+	const command = channel === "canary" ? "hutch-canary" : "hutch";
 	return pathApi.join(
-		dashHome,
+		hutchHome,
 		"bin",
 		`${command}${platform === "win32" ? ".exe" : ""}`,
 	);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "electrobun",
-	"version": "2.0.1-beta.2",
+	"version": "2.0.1-beta.22",
 	"description": "The lightweight npm bootstrap for Electrobun and Hutch.",
 	"license": "MIT",
 	"author": "Blackboard Technologies Inc.",