buncargo 1.0.29 → 3.2.0

package/dist/lint.d.ts

@@ -1,46 +1 @@
-/**
- * Options for running workspace typechecks.
- */
-export interface WorkspaceTypecheckOptions {
-    /** Root directory to search from (defaults to cwd) */
-    root?: string;
-    /** Glob patterns for workspaces to check (defaults to apps/*, packages/*, modules) */
-    patterns?: string[];
-    /** Maximum concurrent typecheck processes (defaults to 1) */
-    concurrency?: number;
-    /** Print output to console (defaults to true) */
-    verbose?: boolean;
-}
-/**
- * Result of a single workspace typecheck.
- */
-export interface WorkspaceTypecheckResult {
-    workspace: string;
-    duration: number;
-    success: boolean;
-    fileCount: number;
-    errorOutput?: string;
-}
-/**
- * Overall result of running typechecks across all workspaces.
- */
-export interface TypecheckResult {
-    success: boolean;
-    totalDuration: number;
-    totalFiles: number;
-    workspaceCount: number;
-    results: WorkspaceTypecheckResult[];
-}
-/**
- * Run TypeScript typechecks across all workspaces that have a `typecheck` script.
- *
- * @example
- * ```typescript
- * const result = await runWorkspaceTypecheck({ verbose: true })
- * if (!result.success) {
- *   console.error('Typecheck failed')
- *   process.exit(1)
- * }
- * ```
- */
-export declare function runWorkspaceTypecheck(options?: WorkspaceTypecheckOptions): Promise<TypecheckResult>;
+export * from "./typecheck";

package/dist/lint.js

@@ -1,7 +1,3 @@
-import {
-  runWorkspaceTypecheck
-} from "./index-d9efy0n4.js";
-import"./index-qnx9j3qa.js";
-export {
-  runWorkspaceTypecheck
-};
+import { runWorkspaceTypecheck } from "./index-h70tce00.js";
+import "./index-qnx9j3qa.js";
+export { runWorkspaceTypecheck };

package/dist/loader/cache.d.ts

@@ -0,0 +1,4 @@
+import type { AppConfig, DevEnvironment, ServiceConfig } from "../types";
+export declare function setCachedDevEnv(env: DevEnvironment<Record<string, ServiceConfig>, Record<string, AppConfig>>): void;
+export declare function getCachedDevEnv(): DevEnvironment<Record<string, ServiceConfig>, Record<string, AppConfig>> | null;
+export declare function clearDevEnvCache(): void;

package/dist/loader/find-config-file.d.ts

@@ -0,0 +1,2 @@
+export declare const CONFIG_FILES: string[];
+export declare function findConfigFile(startDir: string): string | null;

package/dist/loader/index.d.ts

@@ -0,0 +1,5 @@
+import type { AppConfig, DevEnvironment, ServiceConfig } from "../types";
+export { clearDevEnvCache } from "./cache";
+export { CONFIG_FILES, findConfigFile } from "./find-config-file";
+export { loadDevEnv } from "./load-dev-env";
+export declare function getDevEnv(): DevEnvironment<Record<string, ServiceConfig>, Record<string, AppConfig>>;

package/dist/loader/index.js

@@ -0,0 +1,24 @@
+import {
+  CONFIG_FILES,
+  clearDevEnvCache,
+  findConfigFile,
+  getDevEnv,
+  loadDevEnv
+} from "../index-byeqyjrz.js";
+import"../index-7v19es2e.js";
+import"../index-d8tyv5se.js";
+import"../index-c0dr6mcv.js";
+import"../index-fb29934k.js";
+import"../index-5t9jxqm0.js";
+import"../index-x54nbgs7.js";
+import"../index-mam0bcyz.js";
+import"../index-mm412dkp.js";
+import"../index-t0fj6gg1.js";
+import"../index-qnx9j3qa.js";
+export {
+  loadDevEnv,
+  getDevEnv,
+  findConfigFile,
+  clearDevEnvCache,
+  CONFIG_FILES
+};

package/dist/loader/load-dev-env.d.ts

@@ -0,0 +1,5 @@
+import type { AppConfig, DevEnvironment, ServiceConfig } from "../types";
+export declare function loadDevEnv(options?: {
+    cwd?: string;
+    reload?: boolean;
+}): Promise<DevEnvironment<Record<string, ServiceConfig>, Record<string, AppConfig>>>;

package/dist/loader/loader.d.ts

@@ -0,0 +1 @@
+export * from "./index";

package/dist/loader.d.ts

@@ -1,45 +1 @@
-import type { AppConfig, DevEnvironment, ServiceConfig } from "./types";
-export declare const CONFIG_FILES: string[];
-/**
- * Find a config file by traversing up from the starting directory.
- * Returns the full path to the config file, or null if not found.
- */
-export declare function findConfigFile(startDir: string): string | null;
-/**
- * Load the dev environment from the config file.
- * Caches the result for subsequent calls.
- *
- * @example
- * ```typescript
- * import { loadDevEnv } from 'buncargo'
- *
- * const env = await loadDevEnv()
- * console.log(env.ports.postgres)  // 5432 (or offset port)
- * console.log(env.urls.api)        // http://localhost:3000
- * ```
- */
-export declare function loadDevEnv(options?: {
-    /** Directory to search for config file. Defaults to process.cwd() */
-    cwd?: string;
-    /** Skip cache and reload config */
-    reload?: boolean;
-}): Promise<DevEnvironment<Record<string, ServiceConfig>, Record<string, AppConfig>>>;
-/**
- * Get the cached dev environment synchronously.
- * Throws if loadDevEnv() hasn't been called yet.
- *
- * @example
- * ```typescript
- * // First load async
- * await loadDevEnv()
- *
- * // Then use sync getter anywhere
- * import { getDevEnv } from 'buncargo'
- * const env = getDevEnv()
- * ```
- */
-export declare function getDevEnv(): DevEnvironment<Record<string, ServiceConfig>, Record<string, AppConfig>>;
-/**
- * Clear the cached environment.
- */
-export declare function clearDevEnvCache(): void;
+export * from "./loader/index";

package/dist/loader.js

@@ -1,23 +1,25 @@
 import {
-  CONFIG_FILES,
-  clearDevEnvCache,
-  findConfigFile,
-  getDevEnv,
-  loadDevEnv
-} from "./index-1mdrf7nz.js";
-import"./index-wk2na3t9.js";
-import"./index-ggq3yryx.js";
-import"./index-1yvbwj4k.js";
-import"./index-tjqw9vtj.js";
-import"./index-qfphr2fd.js";
-import"./index-zfjzzjkf.js";
-import"./index-8xj2p5n5.js";
-import"./index-731rzzfp.js";
-import"./index-qnx9j3qa.js";
+	CONFIG_FILES,
+	clearDevEnvCache,
+	findConfigFile,
+	getDevEnv,
+	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 "./index-qnx9j3qa.js";
 export {
-  loadDevEnv,
-  getDevEnv,
-  findConfigFile,
-  clearDevEnvCache,
-  CONFIG_FILES
+	loadDevEnv,
+	getDevEnv,
+	findConfigFile,
+	clearDevEnvCache,
+	CONFIG_FILES,
 };

package/dist/prisma/index.d.ts

@@ -0,0 +1 @@
+export * from "./prisma";

package/dist/prisma/prisma.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Prisma integration for dev-tools-v2.
+ *
+ * When `prisma` is configured in defineDevConfig, `dev.prisma` becomes available
+ * with methods to run prisma commands against the Docker development database.
+ *
+ * @example
+ * ```typescript
+ * // In dev.config.ts
+ * const config = defineDevConfig({
+ *   projectPrefix: 'myapp',
+ *   services: { postgres: { port: 5432, healthCheck: 'pg_isready' } },
+ *   prisma: { cwd: 'packages/prisma' }  // Enable prisma integration
+ * })
+ *
+ * // Usage
+ * await dev.prisma.run(['migrate', 'dev'])
+ * await dev.prisma.ensureDatabase()
+ * const url = dev.prisma.getDatabaseUrl()
+ * ```
+ *
+ * @internal This module is used internally by createDevEnvironment.
+ */
+import type { AppConfig, DevEnvironment, PrismaConfig, PrismaRunner, ServiceConfig } from "../types";
+/**
+ * Create a Prisma runner from config (used internally by createDevEnvironment).
+ * @internal
+ */
+export declare function createPrismaRunner<TServices extends Record<string, ServiceConfig>, TApps extends Record<string, AppConfig>>(env: DevEnvironment<TServices, TApps>, config: PrismaConfig): PrismaRunner;

package/dist/prisma.d.ts

@@ -1,29 +1 @@
-/**
- * Prisma integration for dev-tools-v2.
- *
- * When `prisma` is configured in defineDevConfig, `dev.prisma` becomes available
- * with methods to run prisma commands against the Docker development database.
- *
- * @example
- * ```typescript
- * // In dev.config.ts
- * const config = defineDevConfig({
- *   projectPrefix: 'myapp',
- *   services: { postgres: { port: 5432, healthCheck: 'pg_isready' } },
- *   prisma: { cwd: 'packages/prisma' }  // Enable prisma integration
- * })
- *
- * // Usage
- * await dev.prisma.run(['migrate', 'dev'])
- * await dev.prisma.ensureDatabase()
- * const url = dev.prisma.getDatabaseUrl()
- * ```
- *
- * @internal This module is used internally by createDevEnvironment.
- */
-import type { AppConfig, DevEnvironment, PrismaConfig, PrismaRunner, ServiceConfig } from "./types";
-/**
- * Create a Prisma runner from config (used internally by createDevEnvironment).
- * @internal
- */
-export declare function createPrismaRunner<TServices extends Record<string, ServiceConfig>, TApps extends Record<string, AppConfig>>(env: DevEnvironment<TServices, TApps>, config: PrismaConfig): PrismaRunner;
+export * from "./prisma/index";

package/dist/prisma.js

@@ -1,10 +1,6 @@
-import {
-  createPrismaRunner
-} from "./index-qfphr2fd.js";
-import"./index-zfjzzjkf.js";
-import"./index-8xj2p5n5.js";
-import"./index-731rzzfp.js";
-import"./index-qnx9j3qa.js";
-export {
-  createPrismaRunner
-};
+import { createPrismaRunner } from "./index-6c1w1xk5.js";
+import "./index-tjbx2r2t.js";
+import "./index-4gp0az1g.js";
+import "./index-xkvd0nsd.js";
+import "./index-qnx9j3qa.js";
+export { createPrismaRunner };

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,
+};