buncargo 1.0.29 → 3.0.0

package/dist/cli/bin.js

@@ -0,0 +1,315 @@
+#!/usr/bin/env bun
+import {
+  runCli
+} from "../index-0kxnae3z.js";
+import {
+  loadDevEnv
+} from "../index-4xrxh8yv.js";
+import"../index-ma6tgdb2.js";
+import"../index-d8tyv5se.js";
+import"../index-c0dr6mcv.js";
+import"../index-fb29934k.js";
+import"../index-5t9jxqm0.js";
+import"../index-bnk6nr0g.js";
+import"../index-mam0bcyz.js";
+import"../index-mm412dkp.js";
+import"../index-t0fj6gg1.js";
+import {
+  __commonJS,
+  __require
+} from "../index-qnx9j3qa.js";
+
+// package.json
+var require_package = __commonJS((exports, module) => {
+  module.exports = {
+    name: "buncargo",
+    version: "3.0.0",
+    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/cli/bin.js",
+      buncargo: "./dist/cli/bin.js"
+    },
+    exports: {
+      ".": {
+        types: "./dist/index.d.ts",
+        bun: "./src/index.ts",
+        import: "./dist/index.js",
+        default: "./dist/index.js"
+      },
+      "./types": {
+        types: "./dist/types/index.d.ts",
+        bun: "./src/types/index.ts",
+        import: "./dist/types/index.js",
+        default: "./dist/types/index.js"
+      },
+      "./config": {
+        types: "./dist/config/index.d.ts",
+        bun: "./src/config/index.ts",
+        import: "./dist/config/index.js",
+        default: "./dist/config/index.js"
+      },
+      "./environment": {
+        types: "./dist/environment/index.d.ts",
+        bun: "./src/environment/index.ts",
+        import: "./dist/environment/index.js",
+        default: "./dist/environment/index.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/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/index.d.ts",
+        bun: "./src/cli/index.ts",
+        import: "./dist/cli/index.js",
+        default: "./dist/cli/index.js"
+      },
+      "./typecheck": {
+        types: "./dist/typecheck/index.d.ts",
+        bun: "./src/typecheck/index.ts",
+        import: "./dist/typecheck/index.js",
+        default: "./dist/typecheck/index.js"
+      },
+      "./loader": {
+        types: "./dist/loader/index.d.ts",
+        bun: "./src/loader/index.ts",
+        import: "./dist/loader/index.js",
+        default: "./dist/loader/index.js"
+      },
+      "./docker": {
+        types: "./dist/docker/index.d.ts",
+        bun: "./src/docker/index.ts",
+        import: "./dist/docker/index.js",
+        default: "./dist/docker/index.js"
+      },
+      "./docker-compose": {
+        types: "./dist/docker-compose/index.d.ts",
+        bun: "./src/docker-compose/index.ts",
+        import: "./dist/docker-compose/index.js",
+        default: "./dist/docker-compose/index.js"
+      }
+    },
+    scripts: {
+      build: "bun run build:js && bun run build:types",
+      "build:js": "bun build ./src/index.ts ./src/cli/bin.ts ./src/cli/index.ts ./src/config/index.ts ./src/environment/index.ts ./src/loader/index.ts ./src/typecheck/index.ts ./src/types/index.ts ./src/core/network.ts ./src/core/ports.ts ./src/core/process.ts ./src/core/utils.ts ./src/core/watchdog.ts ./src/docker/index.ts ./src/docker-compose/index.ts --outdir ./dist --root ./src --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 src example",
+      "lint:write": "bun run typecheck && biome check --fix src example && biome format src example",
+      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",
+      untun: "^0.1.3"
+    }
+  };
+});
+
+// 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 --expose     # Public quick tunnel for expose:true targets
+  bunx buncargo dev --expose=api # Public quick tunnel for selected target
+  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("../typecheck/index.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/cli/commands/help.d.ts

@@ -0,0 +1 @@
+export declare function showHelp(): void;

package/dist/cli/commands/runtime.d.ts

@@ -0,0 +1,5 @@
+export declare function loadEnv(): Promise<import("../..").DevEnvironment<Record<string, import("../..").ServiceConfig>, Record<string, import("../..").AppConfig>>>;
+export declare function handleDev(args: string[]): Promise<void>;
+export declare function handlePrisma(args: string[]): Promise<void>;
+export declare function handleEnv(): Promise<void>;
+export declare function handleTypecheck(): Promise<void>;

package/dist/cli/commands/version.d.ts

@@ -0,0 +1 @@
+export declare function showVersion(): void;

package/dist/cli/index.d.ts

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

package/dist/cli/index.js

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

package/dist/cli/run-cli.d.ts

@@ -0,0 +1,22 @@
+import type { AppConfig, CliOptions, DevEnvironment, ServiceConfig } from "../types";
+/**
+ * Run the CLI for a dev environment.
+ * Handles common flags like --down, --reset, --up-only, --migrate, --seed.
+ *
+ * @example
+ * ```typescript
+ * import { dev } from './dev.config'
+ * import { runCli } from 'buncargo'
+ *
+ * await runCli(dev)
+ * ```
+ */
+export declare function runCli<TServices extends Record<string, ServiceConfig>, TApps extends Record<string, AppConfig>>(env: DevEnvironment<TServices, TApps>, options?: CliOptions): Promise<void>;
+/**
+ * Check if a CLI flag is present.
+ */
+export declare function hasFlag(args: string[], flag: string): boolean;
+/**
+ * Get a flag value (e.g., --timeout=10 or --timeout 10).
+ */
+export declare function getFlagValue(args: string[], flag: string): string | undefined;

package/dist/cli.d.ts

@@ -1,22 +1 @@
-import type { AppConfig, CliOptions, DevEnvironment, ServiceConfig } from "./types";
-/**
- * Run the CLI for a dev environment.
- * Handles common flags like --down, --reset, --up-only, --migrate, --seed.
- *
- * @example
- * ```typescript
- * import { dev } from './dev.config'
- * import { runCli } from 'buncargo'
- *
- * await runCli(dev)
- * ```
- */
-export declare function runCli<TServices extends Record<string, ServiceConfig>, TApps extends Record<string, AppConfig>>(env: DevEnvironment<TServices, TApps>, options?: CliOptions): Promise<void>;
-/**
- * Check if a CLI flag is present.
- */
-export declare function hasFlag(args: string[], flag: string): boolean;
-/**
- * Get a flag value (e.g., --timeout=10 or --timeout 10).
- */
-export declare function getFlagValue(args: string[], flag: string): string | undefined;
+export * from "./cli/run-cli";

package/dist/cli.js

@@ -1,13 +1,5 @@
-import {
-  getFlagValue,
-  hasFlag,
-  runCli
-} from "./index-segbnm0h.js";
-import"./index-ggq3yryx.js";
-import"./index-1yvbwj4k.js";
-import"./index-qnx9j3qa.js";
-export {
-  runCli,
-  hasFlag,
-  getFlagValue
-};
+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/config/config.d.ts

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

package/dist/config/define-config.d.ts

@@ -0,0 +1,13 @@
+import type { AppConfig, DevConfig, DevHooks, DevOptions, DockerComposeGenerationOptions, EnvVarsBuilder, MigrationConfig, PrismaConfig, SeedConfig, ServiceConfig } from "../types";
+export declare function defineDevConfig<TServices extends Record<string, ServiceConfig>, TApps extends Record<string, AppConfig> = Record<string, never>>(config: {
+    projectPrefix: string;
+    services: TServices;
+    apps?: TApps;
+    envVars?: EnvVarsBuilder<TServices, TApps>;
+    hooks?: DevHooks<TServices, TApps>;
+    migrations?: MigrationConfig[];
+    seed?: SeedConfig<TServices, TApps>;
+    prisma?: PrismaConfig;
+    options?: DevOptions;
+    docker?: DockerComposeGenerationOptions;
+}): DevConfig<TServices, TApps>;

package/dist/config/index.d.ts

@@ -0,0 +1,3 @@
+export { defineDevConfig } from "./define-config";
+export { definePartialConfig, mergeConfigs } from "./merge-configs";
+export { assertValidConfig, validateConfig } from "./validate-config";

package/dist/config/index.js

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

package/dist/config/merge-configs.d.ts

@@ -0,0 +1,3 @@
+import type { AppConfig, DevConfig, ServiceConfig } from "../types";
+export declare function mergeConfigs<TServices extends Record<string, ServiceConfig>, TApps extends Record<string, AppConfig>>(base: DevConfig<TServices, TApps>, overrides: Partial<DevConfig<TServices, TApps>>): DevConfig<TServices, TApps>;
+export declare function definePartialConfig<TServices extends Record<string, ServiceConfig> = Record<string, ServiceConfig>, TApps extends Record<string, AppConfig> = Record<string, AppConfig>>(config: Partial<DevConfig<TServices, TApps>>): Partial<DevConfig<TServices, TApps>>;

package/dist/config/validate-config.d.ts

@@ -0,0 +1,3 @@
+import type { AppConfig, DevConfig, ServiceConfig } from "../types";
+export declare function validateConfig<TServices extends Record<string, ServiceConfig>, TApps extends Record<string, AppConfig>>(config: DevConfig<TServices, TApps>): string[];
+export declare function assertValidConfig<TServices extends Record<string, ServiceConfig>, TApps extends Record<string, AppConfig>>(config: DevConfig<TServices, TApps>): void;

package/dist/config.d.ts

@@ -1,72 +1 @@
-import type { AppConfig, DevConfig, DevHooks, DevOptions, EnvVarsBuilder, MigrationConfig, PrismaConfig, SeedConfig, ServiceConfig } from "./types";
-/**
- * Define a dev environment configuration with full TypeScript inference.
- *
- * @example
- * ```typescript
- * const config = defineDevConfig({
- *   projectPrefix: 'myapp',
- *   services: {
- *     postgres: { port: 5432, healthCheck: 'pg_isready' },
- *     redis: { port: 6379 },
- *   },
- *   apps: {
- *     api: { port: 3000, devCommand: 'bun run dev', cwd: 'apps/backend' },
- *     web: { port: 5173, devCommand: 'bun run dev', cwd: 'apps/frontend' },
- *   },
- *   envVars: (ports, urls) => ({
- *     DATABASE_URL: urls.postgres,
- *     REDIS_URL: urls.redis,
- *     API_PORT: String(ports.api),
- *   }),
- * })
- * ```
- */
-export declare function defineDevConfig<TServices extends Record<string, ServiceConfig>, TApps extends Record<string, AppConfig> = Record<string, never>>(config: {
-    /** Prefix for Docker project name (e.g., 'myapp' -> 'myapp-main') */
-    projectPrefix: string;
-    /** Docker Compose services to manage */
-    services: TServices;
-    /** Applications to start (optional) */
-    apps?: TApps;
-    /**
-     * Environment variables builder. Define all env vars here.
-     *
-     * @example
-     * ```typescript
-     * envVars: (ports, urls, { localIp }) => ({
-     *   DATABASE_URL: urls.postgres,
-     *   BASE_URL: urls.api,
-     *   VITE_PORT: ports.platform,
-     *   EXPO_API_URL: `http://${localIp}:${ports.api}`
-     * })
-     * ```
-     */
-    envVars?: EnvVarsBuilder<TServices, TApps>;
-    /** Lifecycle hooks (optional) */
-    hooks?: DevHooks<TServices, TApps>;
-    /** Migrations to run after containers are ready (optional). Runs in parallel. */
-    migrations?: MigrationConfig[];
-    /** Seed configuration (optional). Runs after migrations, before servers. */
-    seed?: SeedConfig<TServices, TApps>;
-    /** Prisma configuration (optional). When set, dev.prisma is available. */
-    prisma?: PrismaConfig;
-    /** Additional options (optional) */
-    options?: DevOptions;
-}): DevConfig<TServices, TApps>;
-/**
- * Validate a dev config and return any errors.
- */
-export declare function validateConfig<TServices extends Record<string, ServiceConfig>, TApps extends Record<string, AppConfig>>(config: DevConfig<TServices, TApps>): string[];
-/**
- * Validate config and throw if invalid.
- */
-export declare function assertValidConfig<TServices extends Record<string, ServiceConfig>, TApps extends Record<string, AppConfig>>(config: DevConfig<TServices, TApps>): void;
-/**
- * Merge two configs, with the second taking precedence.
- */
-export declare function mergeConfigs<TServices extends Record<string, ServiceConfig>, TApps extends Record<string, AppConfig>>(base: DevConfig<TServices, TApps>, overrides: Partial<DevConfig<TServices, TApps>>): DevConfig<TServices, TApps>;
-/**
- * Create a partial config that can be merged later.
- */
-export declare function definePartialConfig<TServices extends Record<string, ServiceConfig> = Record<string, ServiceConfig>, TApps extends Record<string, AppConfig> = Record<string, AppConfig>>(config: Partial<DevConfig<TServices, TApps>>): Partial<DevConfig<TServices, TApps>>;
+export * from "./config/index";

package/dist/config.js

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

package/dist/core/docker.d.ts

@@ -1,83 +1 @@
-import type { BuiltInHealthCheck, HealthCheckFn, ServiceConfig } from "../types";
-export declare const POLL_INTERVAL = 250;
-export declare const MAX_ATTEMPTS = 120;
-export declare const DOCKER_NOT_RUNNING_MESSAGE = "Docker is not running. Please start Docker and try again.";
-/**
- * Check if a specific container service is running using docker ps.
- */
-export declare function isContainerRunning(project: string, service: string): Promise<boolean>;
-/**
- * Check if Docker daemon is running and reachable.
- */
-export declare function isDockerRunning(): boolean;
-/**
- * Ensure Docker is running before attempting compose operations.
- */
-export declare function assertDockerRunning(): void;
-/**
- * Check if all expected containers are running.
- */
-export declare function areContainersRunning(project: string, minCount?: number): Promise<boolean>;
-export interface StartContainersOptions {
-    verbose?: boolean;
-    wait?: boolean;
-    composeFile?: string;
-}
-/**
- * Start Docker Compose containers.
- */
-export declare function startContainers(root: string, projectName: string, envVars: Record<string, string>, options?: StartContainersOptions): void;
-export interface StopContainersOptions {
-    verbose?: boolean;
-    removeVolumes?: boolean;
-    composeFile?: string;
-}
-/**
- * Stop Docker Compose containers.
- */
-export declare function stopContainers(root: string, projectName: string, options?: StopContainersOptions): void;
-/**
- * Start a specific service only.
- */
-export declare function startService(root: string, projectName: string, serviceName: string, envVars: Record<string, string>, options?: {
-    verbose?: boolean;
-    composeFile?: string;
-}): void;
-export interface HealthCheckContext {
-    projectName?: string;
-    root?: string;
-}
-/**
- * Create a health check function from a built-in type.
- */
-export declare function createBuiltInHealthCheck(type: BuiltInHealthCheck, serviceName: string, context?: HealthCheckContext): HealthCheckFn;
-/**
- * Wait for a service to be healthy.
- */
-export declare function waitForService(serviceName: string, config: ServiceConfig, port: number, options?: {
-    maxAttempts?: number;
-    pollInterval?: number;
-    projectName?: string;
-    root?: string;
-}): Promise<void>;
-/**
- * Wait for all services to be healthy.
- */
-export declare function waitForAllServices(services: Record<string, ServiceConfig>, ports: Record<string, number>, options?: {
-    maxAttempts?: number;
-    pollInterval?: number;
-    verbose?: boolean;
-    projectName?: string;
-    root?: string;
-}): Promise<void>;
-/**
- * Wait for a service to be healthy using a built-in health check type.
- * Simpler API when you don't have a ServiceConfig object.
- */
-export declare function waitForServiceByType(serviceName: string, healthCheckType: BuiltInHealthCheck, port: number, options?: {
-    maxAttempts?: number;
-    pollInterval?: number;
-    verbose?: boolean;
-    projectName?: string;
-    root?: string;
-}): Promise<void>;
+export * from "../docker/runtime";