buncargo 3.0.0 → 3.2.3

package/dist/cli/bin.js

@@ -1,16 +1,16 @@
 #!/usr/bin/env bun
 import {
   runCli
-} from "../index-0kxnae3z.js";
+} from "../index-n5g93an7.js";
 import {
   loadDevEnv
-} from "../index-4xrxh8yv.js";
-import"../index-ma6tgdb2.js";
+} from "../index-bycj26kj.js";
+import"../index-n6z0qw70.js";
 import"../index-d8tyv5se.js";
 import"../index-c0dr6mcv.js";
 import"../index-fb29934k.js";
 import"../index-5t9jxqm0.js";
-import"../index-bnk6nr0g.js";
+import"../index-mf4vjhm3.js";
 import"../index-mam0bcyz.js";
 import"../index-mm412dkp.js";
 import"../index-t0fj6gg1.js";
@@ -23,7 +23,7 @@ import {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "buncargo",
-    version: "3.0.0",
+    version: "3.2.3",
     description: "A Bun-powered development environment CLI for managing Docker Compose services, dev servers, and environment variables",
     type: "module",
     module: "./dist/index.js",
@@ -154,7 +154,10 @@ var require_package = __commonJS((exports, module) => {
       "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"
+      typecheck: "tsgo --incremental",
+      test: "bun test",
+      "test:integration-cloudflared": "bun test src/core/quick-tunnel/quick-tunnel.test.ts",
+      "test:integration-cloudflared-e2e": "BUNCARGO_TEST_CLOUDFLARED_E2E=1 bun test src/core/quick-tunnel/quick-tunnel.test.ts"
     },
     devDependencies: {
       "@types/bun": "1.3.2",
@@ -164,8 +167,7 @@ var require_package = __commonJS((exports, module) => {
     },
     dependencies: {
       "fast-glob": "^3.3.3",
-      picocolors: "^1.1.1",
-      untun: "^0.1.3"
+      picocolors: "^1.1.1"
     }
   };
 });

package/dist/cli/index.js

@@ -2,8 +2,8 @@ import {
   getFlagValue,
   hasFlag,
   runCli
-} from "../index-0kxnae3z.js";
-import"../index-bnk6nr0g.js";
+} from "../index-n5g93an7.js";
+import"../index-mf4vjhm3.js";
 import"../index-mam0bcyz.js";
 import"../index-mm412dkp.js";
 import"../index-qnx9j3qa.js";

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

@@ -1,3 +1,4 @@
+import { resolveExposeTargets, startPublicTunnels, stopPublicTunnels } from "../core/tunnel";
 import type { AppConfig, CliOptions, DevEnvironment, ServiceConfig } from "../types";
 /**
  * Run the CLI for a dev environment.
@@ -11,9 +12,16 @@ import type { AppConfig, CliOptions, DevEnvironment, ServiceConfig } from "../ty
  * 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>;
+export declare function runCli<TServices extends Record<string, ServiceConfig>, TApps extends Record<string, AppConfig>>(env: DevEnvironment<TServices, TApps>, options?: CliOptions & {
+    /** Substitute tunnel helpers (used by CLI integration tests). */
+    cliTestTunnel?: {
+        resolveExposeTargets: typeof resolveExposeTargets;
+        startPublicTunnels: typeof startPublicTunnels;
+        stopPublicTunnels: typeof stopPublicTunnels;
+    };
+}): Promise<void>;
 /**
- * Check if a CLI flag is present.
+ * Check if a CLI flag is present (including `--flag=value` form).
  */
 export declare function hasFlag(args: string[], flag: string): boolean;
 /**

package/dist/core/quick-tunnel/cloudflared-process.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Spawn cloudflared and parse the quick-tunnel public URL from output.
+ * Derived from unjs/untun (MIT), originally forked from node-cloudflared.
+ */
+import { type ChildProcess } from "node:child_process";
+export declare function startCloudflaredTunnel(options: Record<string, string | number | null>): {
+    url: Promise<string>;
+    child: ChildProcess;
+    stop: () => boolean;
+};

package/dist/core/quick-tunnel/constants.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Paths and release metadata for the cloudflared binary.
+ * Derived from unjs/untun (MIT), originally forked from node-cloudflared.
+ */
+export declare const CLOUDFLARED_VERSION: string;
+export declare const RELEASE_BASE = "https://github.com/cloudflare/cloudflared/releases/";
+/** Directory for buncargo-managed cloudflared (avoid clashing with untun's node-untun). */
+export declare const cloudflaredBinPath: string;
+export declare const cloudflaredNotice = "\n\uD83D\uDD25 Your installation of cloudflared software constitutes a symbol of your signature\n indicating that you accept the terms of the Cloudflare License, Terms and Privacy Policy.\n\n\u276F License: `https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/license/`\n\u276F Terms: `https://www.cloudflare.com/terms/`\n\u276F Privacy Policy: `https://www.cloudflare.com/privacypolicy/`\n";

package/dist/core/quick-tunnel/index.d.ts

@@ -0,0 +1,17 @@
+export interface QuickTunnelOptions {
+    url?: string;
+    port?: number | string;
+    hostname?: string;
+    protocol?: "http" | "https";
+    verifyTLS?: boolean;
+    acceptCloudflareNotice?: boolean;
+}
+export interface QuickTunnel {
+    getURL: () => Promise<string>;
+    close: () => Promise<void>;
+}
+/**
+ * Start a Cloudflare quick tunnel to a local HTTP(S) URL.
+ * Returns undefined if the user declines the cloudflared install (when binary is missing).
+ */
+export declare function startQuickTunnel(opts: QuickTunnelOptions): Promise<QuickTunnel | undefined>;

package/dist/core/quick-tunnel/install.d.ts

@@ -0,0 +1 @@
+export declare function installCloudflared(to?: string, version?: string): Promise<string>;

package/dist/core/tunnel.d.ts

@@ -11,7 +11,8 @@ export interface PublicTunnel {
     publicUrl: string;
     close: () => Promise<void>;
 }
-interface UntunTunnelLike {
+interface TunnelBackendResult {
+    getURL?: () => Promise<string>;
     url?: string;
     publicUrl?: string;
     tunnelUrl?: string;
@@ -27,7 +28,7 @@ export declare function resolveExposeTargets<TServices extends Record<string, Se
 export declare function startPublicTunnels(targets: PublicExposeTarget[], options?: {
     start?: (input: {
         url: string;
-    }) => Promise<UntunTunnelLike>;
+    }) => Promise<TunnelBackendResult | undefined>;
 }): Promise<PublicTunnel[]>;
 export declare function stopPublicTunnels(tunnels: PublicTunnel[]): Promise<void>;
 export {};

package/dist/environment/index.js

@@ -1,11 +1,11 @@
 import {
   createDevEnvironment
-} from "../index-ma6tgdb2.js";
+} from "../index-n6z0qw70.js";
 import"../index-d8tyv5se.js";
 import"../index-c0dr6mcv.js";
 import"../index-fb29934k.js";
 import"../index-5t9jxqm0.js";
-import"../index-bnk6nr0g.js";
+import"../index-mf4vjhm3.js";
 import"../index-mam0bcyz.js";
 import"../index-mm412dkp.js";
 import"../index-t0fj6gg1.js";

package/dist/environment/logging.d.ts

@@ -8,10 +8,10 @@ export declare function logEnvironmentInfo(input: {
     worktree: boolean;
     portOffset: number;
     projectSuffix?: string;
+    tunnels?: Array<{
+        kind: "service" | "app";
+        name: string;
+        publicUrl: string;
+        localUrl: string;
+    }>;
 }): void;
-export declare function logPublicUrls(tunnels: Array<{
-    kind: "service" | "app";
-    name: string;
-    publicUrl: string;
-    localUrl: string;
-}>): void;

package/dist/environment/only-apps.d.ts

@@ -0,0 +1,10 @@
+import type { AppConfig } from "../types";
+/**
+ * Ensures every name in `onlyApps` exists as a key in `apps`.
+ */
+export declare function assertOnlyAppNames(appKeys: string[], onlyApps: string[] | undefined): void;
+/**
+ * Returns a subset of `apps` when `onlyApps` is set; otherwise the full map.
+ * When `onlyApps` is `[]`, returns `{}`.
+ */
+export declare function pickApps<TApps extends Record<string, AppConfig>>(apps: TApps, onlyApps: string[] | undefined): Record<string, AppConfig>;