buncargo 1.0.26 → 3.0.0

package/dist/src/bin.js

@@ -0,0 +1,309 @@
+#!/usr/bin/env bun
+import { runCli } from "../index-5gmws6ah.js";
+import { loadDevEnv } from "../index-yedqxm1z.js";
+import "../index-38xnzpa6.js";
+import "../index-vbpb89jy.js";
+import "../index-w8zxnjka.js";
+import "../index-mam0bcyz.js";
+import "../index-mm412dkp.js";
+import "../index-045jksh5.js";
+import "../index-6c1w1xk5.js";
+import "../index-tjbx2r2t.js";
+import "../index-4gp0az1g.js";
+import "../index-xkvd0nsd.js";
+import { __commonJS, __require } from "../index-qnx9j3qa.js";
+
+// package.json
+var require_package = __commonJS((exports, module) => {
+	module.exports = {
+		name: "buncargo",
+		version: "1.0.31",
+		description:
+			"A Bun-powered development environment CLI for managing Docker Compose services, dev servers, and environment variables",
+		type: "module",
+		module: "./dist/index.js",
+		main: "./dist/index.js",
+		types: "./dist/index.d.ts",
+		license: "MIT",
+		repository: {
+			type: "git",
+			url: "git+https://github.com/HansKristoffer/buncargo.git",
+		},
+		author: "Kristoffer Hansen",
+		keywords: [
+			"bun",
+			"dev-tools",
+			"docker",
+			"docker-compose",
+			"development",
+			"cli",
+			"monorepo",
+			"dev-server",
+			"environment",
+		],
+		engines: {
+			bun: ">=1.0.0",
+		},
+		files: ["src/**/*.ts", "dist", "!src/**/*.test.ts"],
+		bin: {
+			"dev-tools": "./dist/bin.js",
+			buncargo: "./dist/bin.js",
+		},
+		exports: {
+			".": {
+				types: "./dist/index.d.ts",
+				bun: "./src/index.ts",
+				import: "./dist/index.js",
+				default: "./dist/index.js",
+			},
+			"./types": {
+				types: "./dist/types.d.ts",
+				bun: "./src/types.ts",
+				import: "./dist/types.js",
+				default: "./dist/types.js",
+			},
+			"./config": {
+				types: "./dist/config.d.ts",
+				bun: "./src/config.ts",
+				import: "./dist/config.js",
+				default: "./dist/config.js",
+			},
+			"./environment": {
+				types: "./dist/environment.d.ts",
+				bun: "./src/environment.ts",
+				import: "./dist/environment.js",
+				default: "./dist/environment.js",
+			},
+			"./core/ports": {
+				types: "./dist/core/ports.d.ts",
+				bun: "./src/core/ports.ts",
+				import: "./dist/core/ports.js",
+				default: "./dist/core/ports.js",
+			},
+			"./core/docker": {
+				types: "./dist/core/docker.d.ts",
+				bun: "./src/core/docker.ts",
+				import: "./dist/core/docker.js",
+				default: "./dist/core/docker.js",
+			},
+			"./core/network": {
+				types: "./dist/core/network.d.ts",
+				bun: "./src/core/network.ts",
+				import: "./dist/core/network.js",
+				default: "./dist/core/network.js",
+			},
+			"./core/process": {
+				types: "./dist/core/process.d.ts",
+				bun: "./src/core/process.ts",
+				import: "./dist/core/process.js",
+				default: "./dist/core/process.js",
+			},
+			"./core/watchdog": {
+				types: "./dist/core/watchdog.d.ts",
+				bun: "./src/core/watchdog.ts",
+				import: "./dist/core/watchdog.js",
+				default: "./dist/core/watchdog.js",
+			},
+			"./core/utils": {
+				types: "./dist/core/utils.d.ts",
+				bun: "./src/core/utils.ts",
+				import: "./dist/core/utils.js",
+				default: "./dist/core/utils.js",
+			},
+			"./cli": {
+				types: "./dist/cli.d.ts",
+				bun: "./src/cli.ts",
+				import: "./dist/cli.js",
+				default: "./dist/cli.js",
+			},
+			"./lint": {
+				types: "./dist/lint.d.ts",
+				bun: "./src/lint.ts",
+				import: "./dist/lint.js",
+				default: "./dist/lint.js",
+			},
+			"./loader": {
+				types: "./dist/loader.d.ts",
+				bun: "./src/loader.ts",
+				import: "./dist/loader.js",
+				default: "./dist/loader.js",
+			},
+		},
+		scripts: {
+			build: "bun run build:js && bun run build:types",
+			"build:js":
+				"bun build ./src/index.ts ./src/bin.ts ./src/cli.ts ./src/config.ts ./src/environment.ts ./src/lint.ts ./src/loader.ts ./src/prisma.ts ./src/types.ts ./src/core/docker.ts ./src/core/index.ts ./src/core/network.ts ./src/core/ports.ts ./src/core/process.ts ./src/core/utils.ts ./src/core/watchdog.ts ./src/core/watchdog-runner.ts ./src/docker/runtime.ts ./src/docker-compose/index.ts ./src/docker-compose/services/index.ts --outdir ./dist --target node --packages external --splitting",
+			"build:types": "tsc -p tsconfig.build.json",
+			prepublishOnly: "bun run build",
+			"publish:patch": "npm version patch && npm publish",
+			"publish:minor": "npm version minor && npm publish",
+			"publish:major": "npm version major && npm publish",
+			lint: "bun run typecheck && biome check",
+			"lint:write": "bun run typecheck && biome check --fix && biome format",
+			typecheck: "tsgo --incremental",
+		},
+		devDependencies: {
+			"@types/bun": "1.3.2",
+			"@biomejs/biome": "2.3.4",
+			"@typescript/native-preview": "7.0.0-dev.20260127.1",
+			typescript: "^5.7.0",
+		},
+		dependencies: {
+			"fast-glob": "^3.3.3",
+			picocolors: "^1.1.1",
+		},
+	};
+});
+
+// src/cli/commands/help.ts
+function showHelp() {
+	console.log(`
+buncargo - Development environment CLI
+
+USAGE:
+  bunx buncargo <command> [options]
+
+COMMANDS:
+  dev                 Start the development environment
+  typecheck           Run TypeScript typecheck across workspaces
+  prisma <args>       Run Prisma CLI with correct DATABASE_URL
+  env                 Print environment info as JSON
+  help                Show this help message
+  version             Show version
+
+EXAMPLES:
+  bunx buncargo dev              # Start everything
+  bunx buncargo dev --help       # Show dev command options
+  bunx buncargo dev --down       # Stop containers
+  bunx buncargo typecheck        # Run typecheck
+  bunx buncargo prisma studio    # Open Prisma Studio
+  bunx buncargo env              # Get ports/urls as JSON
+
+CONFIG:
+  Create a dev.config.ts with a default export:
+
+  import { defineDevConfig } from 'buncargo'
+
+  export default defineDevConfig({
+    projectPrefix: 'myapp',
+    services: { ... },
+    apps: { ... }
+  })
+
+Run "bunx buncargo dev --help" for dev command options.
+`);
+}
+
+// src/cli/commands/runtime.ts
+async function loadEnv() {
+	try {
+		return await loadDevEnv();
+	} catch (error) {
+		console.error(`❌ ${error instanceof Error ? error.message : error}`);
+		process.exit(1);
+	}
+}
+async function handleDev(args) {
+	const env = await loadEnv();
+	await runCli(env, { args });
+}
+async function handlePrisma(args) {
+	const env = await loadEnv();
+	if (!env.prisma) {
+		console.error("❌ Prisma is not configured in your dev config.");
+		console.error("");
+		console.error("   Add prisma to your config:");
+		console.error("");
+		console.error("   export default defineDevConfig({");
+		console.error("     ...");
+		console.error("     prisma: {");
+		console.error("       cwd: 'packages/prisma'");
+		console.error("     }");
+		console.error("   })");
+		process.exit(1);
+	}
+	const running = await env.isRunning();
+	if (!running) {
+		console.log("\uD83D\uDC33 Starting database container...");
+		await env.start({ startServers: false, wait: true });
+	}
+	const exitCode = await env.prisma.run(args);
+	process.exit(exitCode);
+}
+async function handleEnv() {
+	const env = await loadEnv();
+	console.log(
+		JSON.stringify(
+			{
+				projectName: env.projectName,
+				ports: env.ports,
+				urls: env.urls,
+				portOffset: env.portOffset,
+				isWorktree: env.isWorktree,
+				localIp: env.localIp,
+				root: env.root,
+			},
+			null,
+			2,
+		),
+	);
+}
+async function handleTypecheck() {
+	const env = await loadEnv();
+	const { runWorkspaceTypecheck } = await import("../index-5rfqps4b.js");
+	const result = await runWorkspaceTypecheck({
+		root: env.root,
+		verbose: true,
+	});
+	process.exit(result.success ? 0 : 1);
+}
+
+// src/cli/commands/version.ts
+function showVersion() {
+	const pkg = require_package();
+	console.log(`buncargo v${pkg.version}`);
+}
+
+// src/cli/bin.ts
+async function main() {
+	const args = process.argv.slice(2);
+	const command = args[0];
+	const commandArgs = args.slice(1);
+	if (
+		!command ||
+		command === "help" ||
+		command === "--help" ||
+		command === "-h"
+	) {
+		showHelp();
+		process.exit(0);
+	}
+	if (command === "version" || command === "--version" || command === "-v") {
+		showVersion();
+		process.exit(0);
+	}
+	switch (command) {
+		case "dev":
+			await handleDev(commandArgs);
+			break;
+		case "typecheck":
+			await handleTypecheck();
+			break;
+		case "prisma":
+			await handlePrisma(commandArgs);
+			break;
+		case "env":
+			await handleEnv();
+			break;
+		default:
+			console.error(`❌ Unknown command: ${command}`);
+			console.error("");
+			console.error('   Run "bunx buncargo help" for available commands.');
+			process.exit(1);
+	}
+}
+main().catch((error) => {
+	const message = error instanceof Error ? error.message : String(error);
+	console.error(`❌ ${message}`);
+	process.exit(1);
+});

package/dist/src/cli.js

@@ -0,0 +1,5 @@
+import { getFlagValue, hasFlag, runCli } from "../index-5gmws6ah.js";
+import "../index-mam0bcyz.js";
+import "../index-mm412dkp.js";
+import "../index-qnx9j3qa.js";
+export { runCli, hasFlag, getFlagValue };

package/dist/src/config.js

@@ -0,0 +1,15 @@
+import {
+	assertValidConfig,
+	defineDevConfig,
+	definePartialConfig,
+	mergeConfigs,
+	validateConfig,
+} from "../index-045jksh5.js";
+import "../index-qnx9j3qa.js";
+export {
+	validateConfig,
+	mergeConfigs,
+	definePartialConfig,
+	defineDevConfig,
+	assertValidConfig,
+};

package/dist/src/core/docker.js

@@ -0,0 +1,38 @@
+import "../../index-n8v18aeb.js";
+import {
+	areContainersRunning,
+	assertDockerRunning,
+	createBuiltInHealthCheck,
+	DOCKER_NOT_RUNNING_MESSAGE,
+	getComposeArg,
+	isContainerRunning,
+	isDockerRunning,
+	MAX_ATTEMPTS,
+	POLL_INTERVAL,
+	startContainers,
+	startService,
+	stopContainers,
+	waitForAllServices,
+	waitForService,
+	waitForServiceByType,
+} from "../../index-tjbx2r2t.js";
+import "../../index-4gp0az1g.js";
+import "../../index-xkvd0nsd.js";
+import "../../index-qnx9j3qa.js";
+export {
+	waitForServiceByType,
+	waitForService,
+	waitForAllServices,
+	stopContainers,
+	startService,
+	startContainers,
+	isDockerRunning,
+	isContainerRunning,
+	getComposeArg,
+	createBuiltInHealthCheck,
+	assertDockerRunning,
+	areContainersRunning,
+	POLL_INTERVAL,
+	MAX_ATTEMPTS,
+	DOCKER_NOT_RUNNING_MESSAGE,
+};

package/dist/src/core/index.js

@@ -0,0 +1,130 @@
+import "../../index-n8v18aeb.js";
+import {
+	getEnvVar,
+	getLocalIp,
+	isCI,
+	isPortAvailable,
+	logApiUrl,
+	logExpoApiUrl,
+	logFrontendPort,
+	sleep,
+	waitForDevServers,
+	waitForServer,
+} from "../../index-4gp0az1g.js";
+import {
+	getHeartbeatFile,
+	getWatchdogComposeArg,
+	getWatchdogPid,
+	getWatchdogPidFile,
+	isWatchdogRunning,
+	readHeartbeat,
+	removeHeartbeatFile,
+	spawnWatchdog,
+	startHeartbeat,
+	stopHeartbeat,
+	stopWatchdog,
+} from "../../index-mam0bcyz.js";
+import {
+	buildApps,
+	exec,
+	execAsync,
+	getProcessOnPort,
+	isPortInUse,
+	isProcessAlive,
+	killProcessesOnAppPorts,
+	killProcessOnPort,
+	killProcessOnPortAndWait,
+	spawnDevServer,
+	startDevServers,
+	stopAllProcesses,
+	stopProcess,
+} from "../../index-mm412dkp.js";
+import {
+	areContainersRunning,
+	assertDockerRunning,
+	createBuiltInHealthCheck,
+	DOCKER_NOT_RUNNING_MESSAGE,
+	getComposeArg,
+	isContainerRunning,
+	isDockerRunning,
+	MAX_ATTEMPTS,
+	POLL_INTERVAL,
+	startContainers,
+	startService,
+	stopContainers,
+	waitForAllServices,
+	waitForService,
+	waitForServiceByType,
+} from "../../index-tjbx2r2t.js";
+import {
+	calculatePortOffset,
+	computeDevIdentity,
+	computePorts,
+	computeUrls,
+	findMonorepoRoot,
+	getProjectName,
+	getWorktreeName,
+	getWorktreeProjectSuffix,
+	isWorktree,
+} from "../../index-xkvd0nsd.js";
+import "../../index-qnx9j3qa.js";
+export {
+	waitForServiceByType,
+	waitForService,
+	waitForServer,
+	waitForDevServers,
+	waitForAllServices,
+	stopWatchdog,
+	stopProcess,
+	stopHeartbeat,
+	stopContainers,
+	stopAllProcesses,
+	startService,
+	startHeartbeat,
+	startDevServers,
+	startContainers,
+	spawnWatchdog,
+	spawnDevServer,
+	sleep,
+	removeHeartbeatFile,
+	readHeartbeat,
+	logFrontendPort,
+	logExpoApiUrl,
+	logApiUrl,
+	killProcessesOnAppPorts,
+	killProcessOnPortAndWait,
+	killProcessOnPort,
+	isWorktree,
+	isWatchdogRunning,
+	isProcessAlive,
+	isPortInUse,
+	isPortAvailable,
+	isDockerRunning,
+	isContainerRunning,
+	isCI,
+	getWorktreeProjectSuffix,
+	getWorktreeName,
+	getWatchdogPidFile,
+	getWatchdogPid,
+	getWatchdogComposeArg,
+	getProjectName,
+	getProcessOnPort,
+	getLocalIp,
+	getHeartbeatFile,
+	getEnvVar,
+	getComposeArg,
+	findMonorepoRoot,
+	execAsync,
+	exec,
+	createBuiltInHealthCheck,
+	computeUrls,
+	computePorts,
+	computeDevIdentity,
+	calculatePortOffset,
+	buildApps,
+	assertDockerRunning,
+	areContainersRunning,
+	POLL_INTERVAL,
+	MAX_ATTEMPTS,
+	DOCKER_NOT_RUNNING_MESSAGE,
+};

package/dist/src/core/network.js

@@ -0,0 +1,9 @@
+import {
+	getLocalIp,
+	isPortAvailable,
+	waitForDevServers,
+	waitForServer,
+} from "../../index-4gp0az1g.js";
+import "../../index-xkvd0nsd.js";
+import "../../index-qnx9j3qa.js";
+export { waitForServer, waitForDevServers, isPortAvailable, getLocalIp };

package/dist/src/core/ports.js

@@ -0,0 +1,23 @@
+import {
+	calculatePortOffset,
+	computeDevIdentity,
+	computePorts,
+	computeUrls,
+	findMonorepoRoot,
+	getProjectName,
+	getWorktreeName,
+	getWorktreeProjectSuffix,
+	isWorktree,
+} from "../../index-xkvd0nsd.js";
+import "../../index-qnx9j3qa.js";
+export {
+	isWorktree,
+	getWorktreeProjectSuffix,
+	getWorktreeName,
+	getProjectName,
+	findMonorepoRoot,
+	computeUrls,
+	computePorts,
+	computeDevIdentity,
+	calculatePortOffset,
+};

package/dist/src/core/process.js

@@ -0,0 +1,31 @@
+import {
+	buildApps,
+	exec,
+	execAsync,
+	getProcessOnPort,
+	isPortInUse,
+	isProcessAlive,
+	killProcessesOnAppPorts,
+	killProcessOnPort,
+	killProcessOnPortAndWait,
+	spawnDevServer,
+	startDevServers,
+	stopAllProcesses,
+	stopProcess,
+} from "../../index-mm412dkp.js";
+import "../../index-qnx9j3qa.js";
+export {
+	stopProcess,
+	stopAllProcesses,
+	startDevServers,
+	spawnDevServer,
+	killProcessesOnAppPorts,
+	killProcessOnPortAndWait,
+	killProcessOnPort,
+	isProcessAlive,
+	isPortInUse,
+	getProcessOnPort,
+	execAsync,
+	exec,
+	buildApps,
+};

package/dist/src/core/utils.js

@@ -0,0 +1,11 @@
+import {
+	getEnvVar,
+	isCI,
+	logApiUrl,
+	logExpoApiUrl,
+	logFrontendPort,
+	sleep,
+} from "../../index-4gp0az1g.js";
+import "../../index-xkvd0nsd.js";
+import "../../index-qnx9j3qa.js";
+export { sleep, logFrontendPort, logExpoApiUrl, logApiUrl, isCI, getEnvVar };

package/dist/src/core/watchdog-runner.js

@@ -0,0 +1,69 @@
+// src/core/watchdog-runner.ts
+import { execSync } from "node:child_process";
+import { existsSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+
+var PROJECT_NAME = process.env.WATCHDOG_PROJECT_NAME ?? "";
+var HEARTBEAT_FILE = process.env.WATCHDOG_HEARTBEAT_FILE ?? "";
+var PID_FILE = process.env.WATCHDOG_PID_FILE ?? "";
+var IDLE_TIMEOUT = parseInt(process.env.WATCHDOG_TIMEOUT_MS ?? "600000", 10);
+var COMPOSE_ARG = process.env.WATCHDOG_COMPOSE_ARG ?? "";
+var CHECK_INTERVAL = 60000;
+if (!PROJECT_NAME || !HEARTBEAT_FILE || !PID_FILE) {
+	console.error("[watchdog] Missing required environment variables");
+	process.exit(1);
+}
+var heartbeatFile = HEARTBEAT_FILE;
+var pidFile = PID_FILE;
+writeFileSync(pidFile, process.pid.toString());
+function cleanup() {
+	try {
+		unlinkSync(pidFile);
+	} catch {}
+	try {
+		unlinkSync(heartbeatFile);
+	} catch {}
+}
+process.on("SIGTERM", () => {
+	cleanup();
+	process.exit(0);
+});
+process.on("SIGINT", () => {
+	cleanup();
+	process.exit(0);
+});
+console.log(`[watchdog] Started for ${PROJECT_NAME} (PID: ${process.pid})`);
+console.log(`[watchdog] Idle timeout: ${IDLE_TIMEOUT / 60000} minutes`);
+async function watchdog() {
+	while (true) {
+		await new Promise((r) => setTimeout(r, CHECK_INTERVAL));
+		if (!existsSync(heartbeatFile)) {
+			continue;
+		}
+		let lastBeat;
+		try {
+			const content = readFileSync(heartbeatFile, "utf-8");
+			lastBeat = parseInt(content, 10);
+		} catch {
+			continue;
+		}
+		if (Number.isNaN(lastBeat)) {
+			continue;
+		}
+		const elapsed = Date.now() - lastBeat;
+		if (elapsed > IDLE_TIMEOUT) {
+			console.log(
+				`[watchdog] No heartbeat for ${Math.ceil(elapsed / 60000)} minutes, shutting down...`,
+			);
+			try {
+				execSync(`docker compose ${COMPOSE_ARG} down`.trim(), {
+					env: { ...process.env, COMPOSE_PROJECT_NAME: PROJECT_NAME },
+					stdio: "ignore",
+				});
+			} catch {}
+			console.log("[watchdog] Containers stopped");
+			cleanup();
+			process.exit(0);
+		}
+	}
+}
+watchdog();

package/dist/src/core/watchdog.js

@@ -0,0 +1,28 @@
+import {
+	getHeartbeatFile,
+	getWatchdogComposeArg,
+	getWatchdogPid,
+	getWatchdogPidFile,
+	isWatchdogRunning,
+	readHeartbeat,
+	removeHeartbeatFile,
+	spawnWatchdog,
+	startHeartbeat,
+	stopHeartbeat,
+	stopWatchdog,
+} from "../../index-mam0bcyz.js";
+import "../../index-mm412dkp.js";
+import "../../index-qnx9j3qa.js";
+export {
+	stopWatchdog,
+	stopHeartbeat,
+	startHeartbeat,
+	spawnWatchdog,
+	removeHeartbeatFile,
+	readHeartbeat,
+	isWatchdogRunning,
+	getWatchdogPidFile,
+	getWatchdogPid,
+	getWatchdogComposeArg,
+	getHeartbeatFile,
+};