buncargo 1.0.5 → 1.0.8

package/dist/bin.js

@@ -0,0 +1,343 @@
+#!/usr/bin/env bun
+import {
+  runCli
+} from "./index-xcx25j3c.js";
+import {
+  createDevEnvironment
+} from "./index-cft124d3.js";
+import"./index-8gd8fkwx.js";
+import"./index-6qd90dkp.js";
+import"./index-tjqw9vtj.js";
+import"./index-tn0r1rx7.js";
+import"./index-2fr3g85b.js";
+import"./index-6fm7mvwj.js";
+import"./index-08wa79cs.js";
+import {
+  __commonJS
+} from "./index-qnx9j3qa.js";
+
+// package.json
+var require_package = __commonJS((exports, module) => {
+  module.exports = {
+    name: "buncargo",
+    version: "1.0.8",
+    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: [
+      "*.ts",
+      "core/*.ts",
+      "dist",
+      "!*.test.ts",
+      "!core/*.test.ts"
+    ],
+    bin: {
+      "dev-tools": "./dist/bin.js",
+      buncargo: "./dist/bin.js"
+    },
+    exports: {
+      ".": {
+        types: "./dist/index.d.ts",
+        bun: "./index.ts",
+        import: "./dist/index.js",
+        default: "./dist/index.js"
+      },
+      "./types": {
+        types: "./dist/types.d.ts",
+        bun: "./types.ts",
+        import: "./dist/types.js",
+        default: "./dist/types.js"
+      },
+      "./config": {
+        types: "./dist/config.d.ts",
+        bun: "./config.ts",
+        import: "./dist/config.js",
+        default: "./dist/config.js"
+      },
+      "./environment": {
+        types: "./dist/environment.d.ts",
+        bun: "./environment.ts",
+        import: "./dist/environment.js",
+        default: "./dist/environment.js"
+      },
+      "./core/ports": {
+        types: "./dist/core/ports.d.ts",
+        bun: "./core/ports.ts",
+        import: "./dist/core/ports.js",
+        default: "./dist/core/ports.js"
+      },
+      "./core/docker": {
+        types: "./dist/core/docker.d.ts",
+        bun: "./core/docker.ts",
+        import: "./dist/core/docker.js",
+        default: "./dist/core/docker.js"
+      },
+      "./core/network": {
+        types: "./dist/core/network.d.ts",
+        bun: "./core/network.ts",
+        import: "./dist/core/network.js",
+        default: "./dist/core/network.js"
+      },
+      "./core/process": {
+        types: "./dist/core/process.d.ts",
+        bun: "./core/process.ts",
+        import: "./dist/core/process.js",
+        default: "./dist/core/process.js"
+      },
+      "./core/watchdog": {
+        types: "./dist/core/watchdog.d.ts",
+        bun: "./core/watchdog.ts",
+        import: "./dist/core/watchdog.js",
+        default: "./dist/core/watchdog.js"
+      },
+      "./core/utils": {
+        types: "./dist/core/utils.d.ts",
+        bun: "./core/utils.ts",
+        import: "./dist/core/utils.js",
+        default: "./dist/core/utils.js"
+      },
+      "./cli": {
+        types: "./dist/cli.d.ts",
+        bun: "./cli.ts",
+        import: "./dist/cli.js",
+        default: "./dist/cli.js"
+      },
+      "./lint": {
+        types: "./dist/lint.d.ts",
+        bun: "./lint.ts",
+        import: "./dist/lint.js",
+        default: "./dist/lint.js"
+      },
+      "./loader": {
+        types: "./dist/loader.d.ts",
+        bun: "./loader.ts",
+        import: "./dist/loader.js",
+        default: "./dist/loader.js"
+      }
+    },
+    scripts: {
+      build: "bun run build:js && bun run build:types",
+      "build:js": "bun build ./index.ts ./bin.ts ./cli.ts ./config.ts ./environment.ts ./lint.ts ./loader.ts ./prisma.ts ./types.ts ./core/docker.ts ./core/index.ts ./core/network.ts ./core/ports.ts ./core/process.ts ./core/utils.ts ./core/watchdog.ts ./core/watchdog-runner.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: {
+      picocolors: "^1.1.1"
+    }
+  };
+});
+
+// bin.ts
+var CONFIG_FILES = [
+  "dev.config.ts",
+  "dev.config.js",
+  "dev-tools.config.ts",
+  "dev-tools.config.js"
+];
+async function loadEnv() {
+  const cwd = process.cwd();
+  for (const file of CONFIG_FILES) {
+    const path = `${cwd}/${file}`;
+    const exists = await Bun.file(path).exists();
+    if (exists) {
+      try {
+        const mod = await import(path);
+        const config = mod.default;
+        if (!config) {
+          console.error(`❌ Config file "${file}" found but no default export.`);
+          console.error("");
+          console.error("   Export your config as default:");
+          console.error("");
+          console.error("   import { defineDevConfig } from 'buncargo'");
+          console.error("");
+          console.error("   export default defineDevConfig({ ... })");
+          process.exit(1);
+        }
+        if (!config.projectPrefix || !config.services) {
+          console.error(`❌ Config file "${file}" is not a valid dev config.`);
+          console.error("");
+          console.error("   Make sure to use defineDevConfig:");
+          console.error("");
+          console.error("   export default defineDevConfig({");
+          console.error("     projectPrefix: 'myapp',");
+          console.error("     services: { ... }");
+          console.error("   })");
+          process.exit(1);
+        }
+        return createDevEnvironment(config);
+      } catch (error) {
+        console.error(`❌ Failed to load config file "${file}":`);
+        console.error(error);
+        process.exit(1);
+      }
+    }
+  }
+  console.error("❌ No config file found.");
+  console.error("");
+  console.error("   Create a dev.config.ts file in your project root:");
+  console.error("");
+  console.error("   import { defineDevConfig } from 'buncargo'");
+  console.error("");
+  console.error("   export default defineDevConfig({");
+  console.error("     projectPrefix: 'myapp',");
+  console.error("     services: {");
+  console.error('       postgres: { port: 5432, healthCheck: "pg_isready" }');
+  console.error("     }");
+  console.error("   })");
+  console.error("");
+  console.error("   Supported config files:");
+  for (const file of CONFIG_FILES) {
+    console.error(`     - ${file}`);
+  }
+  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));
+}
+function showHelp() {
+  console.log(`
+buncargo - Development environment CLI
+
+USAGE:
+  bunx buncargo <command> [options]
+
+COMMANDS:
+  dev                 Start the development environment
+  prisma <args>       Run Prisma CLI with correct DATABASE_URL
+  env                 Print environment info as JSON
+  help                Show this help message
+  version             Show version
+
+DEV OPTIONS:
+  --up-only           Start containers only (no dev servers)
+  --down              Stop containers
+  --reset             Stop containers and remove volumes
+  --migrate           Run migrations only
+  --seed              Run seeders
+  --lint              Run typecheck (no Docker required)
+
+EXAMPLES:
+  bunx buncargo dev              # Start everything
+  bunx buncargo dev --down       # Stop containers
+  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: { ... }
+  })
+`);
+}
+function showVersion() {
+  const pkg = require_package();
+  console.log(`buncargo v${pkg.version}`);
+}
+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 "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) => {
+  console.error("❌ Fatal error:", error);
+  process.exit(1);
+});

package/dist/cli.js

@@ -0,0 +1,13 @@
+import {
+  getFlagValue,
+  hasFlag,
+  runCli
+} from "./index-xcx25j3c.js";
+import"./index-8gd8fkwx.js";
+import"./index-6qd90dkp.js";
+import"./index-qnx9j3qa.js";
+export {
+  runCli,
+  hasFlag,
+  getFlagValue
+};

package/dist/config.js

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

package/dist/core/docker.js

@@ -0,0 +1,29 @@
+import {
+  MAX_ATTEMPTS,
+  POLL_INTERVAL,
+  areContainersRunning,
+  createBuiltInHealthCheck,
+  isContainerRunning,
+  startContainers,
+  startService,
+  stopContainers,
+  waitForAllServices,
+  waitForService,
+  waitForServiceByType
+} from "../index-2fr3g85b.js";
+import"../index-6fm7mvwj.js";
+import"../index-08wa79cs.js";
+import"../index-qnx9j3qa.js";
+export {
+  waitForServiceByType,
+  waitForService,
+  waitForAllServices,
+  stopContainers,
+  startService,
+  startContainers,
+  isContainerRunning,
+  createBuiltInHealthCheck,
+  areContainersRunning,
+  POLL_INTERVAL,
+  MAX_ATTEMPTS
+};

package/dist/core/index.js

@@ -0,0 +1,105 @@
+import {
+  getHeartbeatFile,
+  getWatchdogPid,
+  getWatchdogPidFile,
+  isWatchdogRunning,
+  readHeartbeat,
+  removeHeartbeatFile,
+  spawnWatchdog,
+  startHeartbeat,
+  stopHeartbeat,
+  stopWatchdog
+} from "../index-8gd8fkwx.js";
+import {
+  buildApps,
+  exec,
+  execAsync,
+  isProcessAlive,
+  spawnDevServer,
+  startDevServers,
+  stopAllProcesses,
+  stopProcess
+} from "../index-6qd90dkp.js";
+import {
+  MAX_ATTEMPTS,
+  POLL_INTERVAL,
+  areContainersRunning,
+  createBuiltInHealthCheck,
+  isContainerRunning,
+  startContainers,
+  startService,
+  stopContainers,
+  waitForAllServices,
+  waitForService,
+  waitForServiceByType
+} from "../index-2fr3g85b.js";
+import {
+  getEnvVar,
+  getLocalIp,
+  isCI,
+  isPortAvailable,
+  logApiUrl,
+  logExpoApiUrl,
+  logFrontendPort,
+  sleep,
+  waitForDevServers,
+  waitForServer
+} from "../index-6fm7mvwj.js";
+import {
+  calculatePortOffset,
+  computePorts,
+  computeUrls,
+  findMonorepoRoot,
+  getProjectName,
+  getWorktreeName,
+  isWorktree
+} from "../index-08wa79cs.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,
+  isWorktree,
+  isWatchdogRunning,
+  isProcessAlive,
+  isPortAvailable,
+  isContainerRunning,
+  isCI,
+  getWorktreeName,
+  getWatchdogPidFile,
+  getWatchdogPid,
+  getProjectName,
+  getLocalIp,
+  getHeartbeatFile,
+  getEnvVar,
+  findMonorepoRoot,
+  execAsync,
+  exec,
+  createBuiltInHealthCheck,
+  computeUrls,
+  computePorts,
+  calculatePortOffset,
+  buildApps,
+  areContainersRunning,
+  POLL_INTERVAL,
+  MAX_ATTEMPTS
+};

package/dist/core/network.js

@@ -0,0 +1,14 @@
+import {
+  getLocalIp,
+  isPortAvailable,
+  waitForDevServers,
+  waitForServer
+} from "../index-6fm7mvwj.js";
+import"../index-08wa79cs.js";
+import"../index-qnx9j3qa.js";
+export {
+  waitForServer,
+  waitForDevServers,
+  isPortAvailable,
+  getLocalIp
+};

package/dist/core/ports.js

@@ -0,0 +1,19 @@
+import {
+  calculatePortOffset,
+  computePorts,
+  computeUrls,
+  findMonorepoRoot,
+  getProjectName,
+  getWorktreeName,
+  isWorktree
+} from "../index-08wa79cs.js";
+import"../index-qnx9j3qa.js";
+export {
+  isWorktree,
+  getWorktreeName,
+  getProjectName,
+  findMonorepoRoot,
+  computeUrls,
+  computePorts,
+  calculatePortOffset
+};

package/dist/core/process.js

@@ -0,0 +1,21 @@
+import {
+  buildApps,
+  exec,
+  execAsync,
+  isProcessAlive,
+  spawnDevServer,
+  startDevServers,
+  stopAllProcesses,
+  stopProcess
+} from "../index-6qd90dkp.js";
+import"../index-qnx9j3qa.js";
+export {
+  stopProcess,
+  stopAllProcesses,
+  startDevServers,
+  spawnDevServer,
+  isProcessAlive,
+  execAsync,
+  exec,
+  buildApps
+};

package/dist/core/utils.js

@@ -0,0 +1,18 @@
+import {
+  getEnvVar,
+  isCI,
+  logApiUrl,
+  logExpoApiUrl,
+  logFrontendPort,
+  sleep
+} from "../index-6fm7mvwj.js";
+import"../index-08wa79cs.js";
+import"../index-qnx9j3qa.js";
+export {
+  sleep,
+  logFrontendPort,
+  logExpoApiUrl,
+  logApiUrl,
+  isCI,
+  getEnvVar
+};

package/dist/core/watchdog-runner.js

@@ -0,0 +1,66 @@
+// 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/core/watchdog.js

@@ -0,0 +1,26 @@
+import {
+  getHeartbeatFile,
+  getWatchdogPid,
+  getWatchdogPidFile,
+  isWatchdogRunning,
+  readHeartbeat,
+  removeHeartbeatFile,
+  spawnWatchdog,
+  startHeartbeat,
+  stopHeartbeat,
+  stopWatchdog
+} from "../index-8gd8fkwx.js";
+import"../index-6qd90dkp.js";
+import"../index-qnx9j3qa.js";
+export {
+  stopWatchdog,
+  stopHeartbeat,
+  startHeartbeat,
+  spawnWatchdog,
+  removeHeartbeatFile,
+  readHeartbeat,
+  isWatchdogRunning,
+  getWatchdogPidFile,
+  getWatchdogPid,
+  getHeartbeatFile
+};

package/dist/environment.js

@@ -0,0 +1,14 @@
+import {
+  createDevEnvironment
+} from "./index-cft124d3.js";
+import"./index-8gd8fkwx.js";
+import"./index-6qd90dkp.js";
+import"./index-tjqw9vtj.js";
+import"./index-tn0r1rx7.js";
+import"./index-2fr3g85b.js";
+import"./index-6fm7mvwj.js";
+import"./index-08wa79cs.js";
+import"./index-qnx9j3qa.js";
+export {
+  createDevEnvironment
+};