buncargo 3.2.4 → 3.2.5

package/dist/index-znaek8z2.js

@@ -0,0 +1,72 @@
+import {
+  createDevEnvironment
+} from "./index-ymdvr5sn.js";
+
+// src/loader/cache.ts
+var cachedEnv = null;
+function setCachedDevEnv(env) {
+  cachedEnv = env;
+}
+function getCachedDevEnv() {
+  return cachedEnv;
+}
+function clearDevEnvCache() {
+  cachedEnv = null;
+}
+// src/loader/find-config-file.ts
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+var CONFIG_FILES = [
+  "dev.config.ts",
+  "dev.config.js",
+  "dev-tools.config.ts",
+  "dev-tools.config.js"
+];
+function findConfigFile(startDir) {
+  let currentDir = startDir;
+  while (true) {
+    for (const file of CONFIG_FILES) {
+      const configPath = join(currentDir, file);
+      if (existsSync(configPath)) {
+        return configPath;
+      }
+    }
+    const parentDir = dirname(currentDir);
+    if (parentDir === currentDir) {
+      return null;
+    }
+    currentDir = parentDir;
+  }
+}
+// src/loader/load-dev-env.ts
+async function loadDevEnv(options) {
+  if (!options?.reload) {
+    const cached = getCachedDevEnv();
+    if (cached)
+      return cached;
+  }
+  const cwd = options?.cwd ?? process.cwd();
+  const configPath = findConfigFile(cwd);
+  if (configPath) {
+    const mod = await import(configPath);
+    const config = mod.default;
+    if (!config?.projectPrefix || !config?.services) {
+      throw new Error(`Invalid config in "${configPath}". Use defineDevConfig() and export as default.`);
+    }
+    const env = createDevEnvironment(config);
+    setCachedDevEnv(env);
+    return env;
+  }
+  throw new Error("No config file found. Create dev.config.ts with: export default defineDevConfig({ ... })");
+}
+
+// src/loader/index.ts
+function getDevEnv() {
+  const env = getCachedDevEnv();
+  if (!env) {
+    throw new Error("Dev environment not loaded. Call loadDevEnv() first.");
+  }
+  return env;
+}
+
+export { clearDevEnvCache, CONFIG_FILES, findConfigFile, loadDevEnv, getDevEnv };

package/dist/index.js

@@ -3,15 +3,15 @@ import {
   getFlagValue,
   hasFlag,
   runCli
-} from "./index-emcawhxm.js";
+} from "./index-c28x1pjb.js";
 import {
   clearDevEnvCache,
   getDevEnv,
   loadDevEnv
-} from "./index-1fset27q.js";
+} from "./index-znaek8z2.js";
 import {
   createDevEnvironment
-} from "./index-tyk17rfn.js";
+} from "./index-ymdvr5sn.js";
 import {
   DOCKER_NOT_RUNNING_MESSAGE,
   MAX_ATTEMPTS,
@@ -33,7 +33,7 @@ import {
   resolveExposeTargets,
   startPublicTunnels,
   stopPublicTunnels
-} from "./index-vr4ygtyj.js";
+} from "./index-bgcx898h.js";
 import {
   getHeartbeatFile,
   getWatchdogPidFile,

package/dist/loader/index.js

@@ -4,11 +4,11 @@ import {
   findConfigFile,
   getDevEnv,
   loadDevEnv
-} from "../index-1fset27q.js";
-import"../index-tyk17rfn.js";
+} from "../index-znaek8z2.js";
+import"../index-ymdvr5sn.js";
 import"../index-twwcjn9p.js";
 import"../index-5t9jxqm0.js";
-import"../index-vr4ygtyj.js";
+import"../index-bgcx898h.js";
 import"../index-mam0bcyz.js";
 import"../index-mm412dkp.js";
 import"../index-fkgqg6w2.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "buncargo",
-  "version": "3.2.4",
+  "version": "3.2.5",
   "description": "A Bun-powered development environment CLI for managing Docker Compose services, dev servers, and environment variables",
   "type": "module",
   "module": "./dist/index.js",

package/src/core/quick-tunnel/cloudflared-process.ts

@@ -3,7 +3,7 @@
  * Derived from unjs/untun (MIT), originally forked from node-cloudflared.
  */
 import { type ChildProcess, spawn } from "node:child_process";
-import { cloudflaredBinPath } from "./constants";
+import { resolvedCloudflaredBinPath } from "./constants";
 
 /** Primary: ASCII box line from cloudflared (`|  https://…  |`). */
 const urlRegexPipe = /\|\s+(https?:\/\/\S+)/;
@@ -13,6 +13,16 @@ const urlRegexTryCloudflare =
 
 const MAX_CAPTURED_LOG = 24_000;
 
+/** Default 30s; set `BUNCARGO_QUICK_TUNNEL_TIMEOUT_MS=0` to disable. */
+export function resolveQuickTunnelUrlTimeoutMs(): number {
+	const raw = process.env.BUNCARGO_QUICK_TUNNEL_TIMEOUT_MS;
+	if (raw === undefined || raw === "") {
+		return 30_000;
+	}
+	const n = Number.parseInt(raw, 10);
+	return Number.isFinite(n) && n >= 0 ? n : 30_000;
+}
+
 export function parseQuickTunnelUrlFromOutput(log: string): string | null {
 	const pipe = log.match(urlRegexPipe);
 	if (pipe?.[1]) {
@@ -43,7 +53,8 @@ export function startCloudflaredTunnel(
 		args.push("--url", "localhost:8080");
 	}
 
-	const child = spawn(cloudflaredBinPath, args, {
+	const binPath = resolvedCloudflaredBinPath();
+	const child = spawn(binPath, args, {
 		stdio: ["ignore", "pipe", "pipe"],
 	});
 
@@ -55,19 +66,46 @@ export function startCloudflaredTunnel(
 	let settled = false;
 	let urlResolver!: (value: string | PromiseLike<string>) => void;
 	let urlRejector!: (reason: unknown) => void;
+	let timeoutId: ReturnType<typeof setTimeout> | undefined;
+
+	const clearUrlTimeout = () => {
+		if (timeoutId !== undefined) {
+			clearTimeout(timeoutId);
+			timeoutId = undefined;
+		}
+	};
+
 	const url = new Promise<string>((resolve, reject) => {
 		urlResolver = (v) => {
 			if (!settled) {
 				settled = true;
+				clearUrlTimeout();
 				resolve(v);
 			}
 		};
 		urlRejector = (e) => {
 			if (!settled) {
 				settled = true;
+				clearUrlTimeout();
 				reject(e);
 			}
 		};
+
+		const timeoutMs = resolveQuickTunnelUrlTimeoutMs();
+		if (timeoutMs > 0) {
+			timeoutId = setTimeout(() => {
+				try {
+					child.kill("SIGINT");
+				} catch {
+					/* ignore */
+				}
+				urlRejector(
+					new Error(
+						`quick tunnel URL timed out after ${timeoutMs}ms (no public URL from cloudflared)`,
+					),
+				);
+			}, timeoutMs);
+		}
 	});
 
 	const log: { buf: string } = { buf: "" };

package/src/core/quick-tunnel/constants.ts

@@ -3,11 +3,12 @@
  * Derived from unjs/untun (MIT), originally forked from node-cloudflared.
  */
 
+import { existsSync } from "node:fs";
 import { tmpdir } from "node:os";
 import path from "node:path";
 
 export const CLOUDFLARED_VERSION =
-	process.env.CLOUDFLARED_VERSION || "2023.10.0";
+	process.env.CLOUDFLARED_VERSION || "2026.3.0";
 
 export const RELEASE_BASE =
 	"https://github.com/cloudflare/cloudflared/releases/";
@@ -21,6 +22,18 @@ export const cloudflaredBinPath = path.join(
 		: `cloudflared.${CLOUDFLARED_VERSION}`,
 );
 
+/** Spawn/install target: optional `BUNCARGO_CLOUDFLARED_PATH` overrides the bundled cache path. */
+export function resolvedCloudflaredBinPath(): string {
+	const override = process.env.BUNCARGO_CLOUDFLARED_PATH?.trim();
+	if (override) {
+		if (!existsSync(override)) {
+			throw new Error(`BUNCARGO_CLOUDFLARED_PATH does not exist: ${override}`);
+		}
+		return path.resolve(override);
+	}
+	return cloudflaredBinPath;
+}
+
 export const cloudflaredNotice = `
 🔥 Your installation of cloudflared software constitutes a symbol of your signature
  indicating that you accept the terms of the Cloudflare License, Terms and Privacy Policy.

package/src/core/quick-tunnel/index.ts

@@ -3,39 +3,74 @@
  * License / download flow adapted from unjs/untun (MIT).
  */
 import { existsSync } from "node:fs";
-import { createInterface } from "node:readline";
 import { sleep } from "../utils";
 import { startCloudflaredTunnel } from "./cloudflared-process";
-import { cloudflaredBinPath, cloudflaredNotice } from "./constants";
+import {
+	cloudflaredBinPath,
+	cloudflaredNotice,
+	resolvedCloudflaredBinPath,
+} from "./constants";
 import { installCloudflared } from "./install";
 
-const MAX_QUICK_TUNNEL_ATTEMPTS = 5;
+function resolveMaxQuickTunnelAttempts(): number {
+	const raw = process.env.BUNCARGO_QUICK_TUNNEL_MAX_ATTEMPTS;
+	if (raw === undefined || raw === "") {
+		return 5;
+	}
+	const n = Number.parseInt(raw, 10);
+	return Number.isFinite(n) && n >= 1 ? n : 5;
+}
+
+function resolveQuickTunnelRetryBaseMs(): number {
+	const raw = process.env.BUNCARGO_QUICK_TUNNEL_RETRY_BASE_MS;
+	if (raw === undefined || raw === "") {
+		return 2000;
+	}
+	const n = Number.parseInt(raw, 10);
+	return Number.isFinite(n) && n >= 0 ? n : 2000;
+}
+
+function usesBundledCloudflaredCache(): boolean {
+	return !process.env.BUNCARGO_CLOUDFLARED_PATH?.trim();
+}
 
-function isQuickTunnelRateLimitedError(message: string): boolean {
+/** True when trycloudflare.com is overloaded / rate-limited or returns non-JSON (cloudflared then errors on unmarshal). */
+export function isRetryableQuickTunnelError(message: string): boolean {
 	return (
 		message.includes("429") ||
 		message.includes("Too Many Requests") ||
-		message.includes('status_code="429')
+		message.includes('status_code="429') ||
+		// Plain-text "error" or HTML error pages — see cloudflare/cloudflared#972
+		message.includes("failed to unmarshal quick Tunnel") ||
+		message.includes("failed to unmarshall quick Tunnel") ||
+		message.includes("Error unmarshaling QuickTunnel") ||
+		message.includes("invalid character '<'") ||
+		message.includes("quick tunnel URL timed out")
 	);
 }
 
 async function startCloudflaredTunnelWithRetry(
 	cfArgs: Record<string, string | number | null>,
 ): Promise<ReturnType<typeof startCloudflaredTunnel>> {
-	for (let attempt = 1; attempt <= MAX_QUICK_TUNNEL_ATTEMPTS; attempt++) {
+	const maxAttempts = resolveMaxQuickTunnelAttempts();
+	const baseMs = resolveQuickTunnelRetryBaseMs();
+
+	for (let attempt = 1; attempt <= maxAttempts; attempt++) {
 		const tunnel = startCloudflaredTunnel(cfArgs);
 		try {
 			await tunnel.url;
 			return tunnel;
 		} catch (e) {
+			try {
+				tunnel.stop();
+			} catch {
+				/* ignore */
+			}
 			const msg = String(e);
-			if (
-				attempt < MAX_QUICK_TUNNEL_ATTEMPTS &&
-				isQuickTunnelRateLimitedError(msg)
-			) {
-				const delayMs = 2000 * attempt;
+			if (attempt < maxAttempts && isRetryableQuickTunnelError(msg)) {
+				const delayMs = baseMs * attempt;
 				console.log(
-					`Cloudflare quick tunnel rate-limited (${attempt}/${MAX_QUICK_TUNNEL_ATTEMPTS}), retrying in ${delayMs}ms…`,
+					`Cloudflare quick tunnel temporarily unavailable (${attempt}/${maxAttempts}), retrying in ${delayMs}ms…`,
 				);
 				await sleep(delayMs);
 				continue;
@@ -52,7 +87,6 @@ export interface QuickTunnelOptions {
 	hostname?: string;
 	protocol?: "http" | "https";
 	verifyTLS?: boolean;
-	acceptCloudflareNotice?: boolean;
 }
 
 export interface QuickTunnel {
@@ -67,52 +101,22 @@ function resolvedLocalUrl(opts: QuickTunnelOptions): string {
 	);
 }
 
-function envAcceptsCloudflareNotice(): boolean {
-	const v = process.env.BUNCARGO_ACCEPT_CLOUDFLARE_NOTICE;
-	const u = process.env.UNTUN_ACCEPT_CLOUDFLARE_NOTICE;
-	return v === "1" || v === "true" || u === "1" || u === "true";
-}
-
-async function promptInstallCloudflared(): Promise<boolean> {
-	if (!process.stdin.isTTY || !process.stdout.isTTY) {
-		return false;
-	}
-	return new Promise((resolve) => {
-		const rl = createInterface({
-			input: process.stdin,
-			output: process.stdout,
-		});
-		rl.question(
-			"Do you agree with the above terms and wish to install the binary from GitHub? (y/N) ",
-			(answer) => {
-				rl.close();
-				resolve(/^y(es)?$/i.test(answer.trim()));
-			},
-		);
-	});
-}
-
 /**
  * Start a Cloudflare quick tunnel to a local HTTP(S) URL.
- * Returns undefined if the user declines the cloudflared install (when binary is missing).
+ * If the cloudflared binary is missing, prints the license notice and installs it from GitHub.
  */
 export async function startQuickTunnel(
 	opts: QuickTunnelOptions,
-): Promise<QuickTunnel | undefined> {
+): Promise<QuickTunnel> {
 	const url = resolvedLocalUrl(opts);
 
 	console.log(`Starting cloudflared tunnel to ${url}`);
 
-	if (!existsSync(cloudflaredBinPath)) {
+	// Resolve path first (throws if BUNCARGO_CLOUDFLARED_PATH is invalid).
+	resolvedCloudflaredBinPath();
+
+	if (usesBundledCloudflaredCache() && !existsSync(cloudflaredBinPath)) {
 		console.log(cloudflaredNotice);
-		const canInstall =
-			opts.acceptCloudflareNotice ||
-			envAcceptsCloudflareNotice() ||
-			(await promptInstallCloudflared());
-		if (!canInstall) {
-			console.error("Skipping tunnel setup.");
-			return;
-		}
 		await installCloudflared();
 	}
 

package/src/core/quick-tunnel/install.ts

@@ -20,7 +20,7 @@ const LINUX_URL: Partial<Record<NodeJS.Architecture, string>> = {
 };
 
 const MACOS_URL: Partial<Record<NodeJS.Architecture, string>> = {
-	arm64: "cloudflared-darwin-amd64.tgz",
+	arm64: "cloudflared-darwin-arm64.tgz",
 	x64: "cloudflared-darwin-amd64.tgz",
 };
 

package/src/core/tunnel.ts

@@ -150,7 +150,7 @@ export async function startPublicTunnels(
 			})) as TunnelBackendResult | undefined;
 			if (tunnel === undefined) {
 				throw new Error(
-					`Tunnel for "${target.name}" could not be started (cloudflared missing or install declined)`,
+					`Tunnel for "${target.name}" could not be started (tunnel backend returned no instance)`,
 				);
 			}
 			const publicUrl = await resolvePublicUrl(tunnel);