buncargo 3.0.0 → 3.2.3

package/src/environment/logging.ts

@@ -14,6 +14,21 @@ function formatDimLabel(label: string, value: string): string {
 	return `  ${pc.dim("•")}  ${pc.dim(label.padEnd(10))} ${pc.dim(value)}`;
 }
 
+function tunnelFor(
+	tunnels:
+		| Array<{
+				kind: "service" | "app";
+				name: string;
+				publicUrl: string;
+				localUrl: string;
+		  }>
+		| undefined,
+	name: string,
+	kind: "service" | "app",
+) {
+	return tunnels?.find((t) => t.name === name && t.kind === kind);
+}
+
 export function logEnvironmentInfo(input: {
 	label: string;
 	projectName: string;
@@ -24,6 +39,12 @@ export function logEnvironmentInfo(input: {
 	worktree: boolean;
 	portOffset: number;
 	projectSuffix?: string;
+	tunnels?: Array<{
+		kind: "service" | "app";
+		name: string;
+		publicUrl: string;
+		localUrl: string;
+	}>;
 }): void {
 	const {
 		label,
@@ -35,6 +56,7 @@ export function logEnvironmentInfo(input: {
 		worktree,
 		portOffset,
 		projectSuffix,
+		tunnels,
 	} = input;
 	const serviceNames = Object.keys(services);
 	const appNames = Object.keys(apps);
@@ -50,6 +72,12 @@ export function logEnvironmentInfo(input: {
 			const port = ports[name];
 			const url = `localhost:${port}`;
 			console.log(formatLabel(`${name}:`, formatUrl(`http://${url}`)));
+			const t = tunnelFor(tunnels, name, "service");
+			if (t) {
+				console.log(
+					`       ${pc.dim("Public:")}  ${formatUrl(t.publicUrl)} ${pc.dim("(tunnel)")}`,
+				);
+			}
 		}
 	}
 
@@ -64,6 +92,12 @@ export function logEnvironmentInfo(input: {
 			console.log(`  ${pc.green("➜")}  ${pc.bold(pc.cyan(name))}`);
 			console.log(`       ${pc.dim("Local:")}   ${formatUrl(localUrl)}`);
 			console.log(`       ${pc.dim("Network:")} ${formatUrl(networkUrl)}`);
+			const t = tunnelFor(tunnels, name, "app");
+			if (t) {
+				console.log(
+					`       ${pc.dim("Public:")}  ${formatUrl(t.publicUrl)} ${pc.dim("(tunnel)")}`,
+				);
+			}
 		}
 	}
 
@@ -79,23 +113,3 @@ export function logEnvironmentInfo(input: {
 	console.log(formatDimLabel("Local IP:", localIp));
 	console.log("");
 }
-
-export function logPublicUrls(
-	tunnels: Array<{
-		kind: "service" | "app";
-		name: string;
-		publicUrl: string;
-		localUrl: string;
-	}>,
-): void {
-	if (tunnels.length === 0) return;
-
-	console.log("");
-	console.log(`  ${pc.dim("─── Public URLs (Quick Tunnel) ───")}`);
-	for (const tunnel of tunnels) {
-		const label = `${tunnel.name} (${tunnel.kind})`;
-		console.log(formatLabel(`${label}:`, formatUrl(tunnel.publicUrl), "🌐"));
-		console.log(formatDimLabel("Local target:", tunnel.localUrl));
-	}
-	console.log("");
-}

package/src/environment/only-apps.ts

@@ -0,0 +1,34 @@
+import type { AppConfig } from "../types";
+
+/**
+ * Ensures every name in `onlyApps` exists as a key in `apps`.
+ */
+export function assertOnlyAppNames(
+	appKeys: string[],
+	onlyApps: string[] | undefined,
+): void {
+	if (onlyApps === undefined) return;
+	const unknown = onlyApps.filter((n) => !appKeys.includes(n));
+	if (unknown.length > 0) {
+		throw new Error(`Unknown app name(s) in onlyApps: ${unknown.join(", ")}`);
+	}
+}
+
+/**
+ * Returns a subset of `apps` when `onlyApps` is set; otherwise the full map.
+ * When `onlyApps` is `[]`, returns `{}`.
+ */
+export function pickApps<TApps extends Record<string, AppConfig>>(
+	apps: TApps,
+	onlyApps: string[] | undefined,
+): Record<string, AppConfig> {
+	if (onlyApps === undefined) return apps;
+	const out: Record<string, AppConfig> = {};
+	for (const name of onlyApps) {
+		const config = apps[name];
+		if (config !== undefined) {
+			out[name] = config;
+		}
+	}
+	return out;
+}

package/src/index.ts

@@ -65,9 +65,12 @@ export type {
 	HookContext,
 	// Migrations & Seed
 	MigrationConfig,
+	OpenPublicTunnelsOptions,
+	OpenPublicTunnelsResult,
 	// Prisma
 	PrismaConfig,
 	PrismaRunner,
+	PublicTunnelHandle,
 	SeedCheckContext,
 	SeedCheckHelpers,
 	SeedConfig,

package/src/types/all-types.ts

@@ -499,6 +499,10 @@ export interface StartOptions {
 	suffix?: string;
 	/** Skip automatic seeding (useful when CLI handles seeding separately). Default: false */
 	skipSeed?: boolean;
+	/** Skip the initial `logInfo` banner (CLI uses this with `--expose`, then logs once with tunnel URLs). Default: false */
+	skipEnvironmentLog?: boolean;
+	/** If set, start and wait for only these app names (must exist in `apps`). */
+	onlyApps?: string[];
 }
 
 /**
@@ -522,6 +526,40 @@ export interface DevServerPids {
 	[appName: string]: number;
 }
 
+/** Tunnel rows passed to `logInfo` for public URL lines (matches `PublicTunnel` without `close`) */
+export interface DevEnvironmentTunnelLog {
+	kind: "service" | "app";
+	name: string;
+	localUrl: string;
+	publicUrl: string;
+}
+
+/** Active tunnel with teardown — same shape as core `PublicTunnel`. */
+export type PublicTunnelHandle = DevEnvironmentTunnelLog & {
+	close: () => Promise<void>;
+};
+
+/** Options for {@link DevEnvironment.openPublicTunnels}. */
+export interface OpenPublicTunnelsOptions {
+	/** Subset of expose targets by name; omit for all `expose: true` services/apps. */
+	names?: string[];
+	/**
+	 * Wait for these apps' HTTP health endpoints before opening tunnels.
+	 * Servers must already be listening on their ports.
+	 */
+	waitForHealthy?: string[];
+}
+
+/** Result of {@link DevEnvironment.openPublicTunnels}. */
+export interface OpenPublicTunnelsResult<
+	TServices extends Record<string, ServiceConfig>,
+	TApps extends Record<string, AppConfig>,
+> {
+	publicUrls: ComputedPublicUrls<TServices, TApps>;
+	tunnels: PublicTunnelHandle[];
+	close: () => Promise<void>;
+}
+
 /**
  * The main dev environment interface returned by createDevEnvironment().
  */
@@ -577,6 +615,8 @@ export interface DevEnvironment<
 	startServers(options?: {
 		productionBuild?: boolean;
 		verbose?: boolean;
+		/** If set, start and wait for only these app names (must exist in `apps`). */
+		onlyApps?: string[];
 	}): Promise<DevServerPids>;
 	/** Stop a process by PID */
 	stopProcess(pid: number): void;
@@ -584,13 +624,18 @@ export interface DevEnvironment<
 	waitForServers(options?: {
 		timeout?: number;
 		productionBuild?: boolean;
+		/** If set, wait only for these app names (must exist in `apps`). */
+		onlyApps?: string[];
 	}): Promise<void>;
 
 	// ─────────────────────────────────────────────────────────────────────────
 	// Utilities
 	// ─────────────────────────────────────────────────────────────────────────
 
-	/** Build environment variables for shell commands */
+	/**
+	 * Build environment variables for shell commands.
+	 * Call **after** {@link setPublicUrls} or {@link openPublicTunnels} so `envVars` and `*_PUBLIC_URL` reflect tunnel URLs.
+	 */
 	buildEnvVars(production?: boolean): Record<string, string>;
 	/** Set public tunnel URLs used by envVars and *_PUBLIC_URL injection */
 	setPublicUrls(urls: ComputedPublicUrls<TServices, TApps>): void;
@@ -605,8 +650,16 @@ export interface DevEnvironment<
 	): Promise<{ exitCode: number; stdout: string; stderr: string }>;
 	/** Wait for an HTTP server to respond */
 	waitForServer(url: string, timeout?: number): Promise<void>;
-	/** Log environment info to console */
-	logInfo(label?: string): void;
+	/** Log environment info to console; pass `tunnels` to show public URLs next to services/apps */
+	logInfo(label?: string, tunnels?: DevEnvironmentTunnelLog[]): void;
+
+	/**
+	 * Resolve expose targets, start public quick tunnels, and apply {@link setPublicUrls}.
+	 * Call {@link buildEnvVars} after this resolves when spawning processes that need `EXPO_PUBLIC_*` / `*_PUBLIC_URL`.
+	 */
+	openPublicTunnels(
+		options?: OpenPublicTunnelsOptions,
+	): Promise<OpenPublicTunnelsResult<TServices, TApps>>;
 
 	// ─────────────────────────────────────────────────────────────────────────
 	// Vibe Kanban Integration