unplugin-cloudflare-tunnel 0.0.0-alpha-1 → 0.0.1

package/dist/api.d.ts

@@ -1 +1,50 @@
-export { };
+import * as z from "zod/mini";
+
+//#region src/api.d.ts
+declare const CloudflareErrorSchema: z.ZodMiniObject<{
+  code: z.ZodMiniNumber<number>;
+  message: z.ZodMiniString<string>;
+}, z.core.$strip>;
+declare const CloudflareApiResponseSchema: z.ZodMiniObject<{
+  success: z.ZodMiniBoolean<boolean>;
+  errors: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniObject<{
+    code: z.ZodMiniNumber<number>;
+    message: z.ZodMiniString<string>;
+  }, z.core.$strip>>>;
+  messages: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+  result: z.ZodMiniUnknown;
+}, z.core.$strip>;
+declare const AccountSchema: z.ZodMiniObject<{
+  id: z.ZodMiniString<string>;
+  name: z.ZodMiniString<string>;
+}, z.core.$strip>;
+declare const ZoneSchema: z.ZodMiniObject<{
+  id: z.ZodMiniString<string>;
+  name: z.ZodMiniString<string>;
+}, z.core.$strip>;
+declare const TunnelSchema: z.ZodMiniObject<{
+  id: z.ZodMiniString<string>;
+  name: z.ZodMiniString<string>;
+  account_tag: z.ZodMiniString<string>;
+  created_at: z.ZodMiniString<string>;
+  connections: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniUnknown>>;
+}, z.core.$strip>;
+declare const DNSRecordSchema: z.ZodMiniObject<{
+  id: z.ZodMiniString<string>;
+  type: z.ZodMiniString<string>;
+  name: z.ZodMiniString<string>;
+  content: z.ZodMiniString<string>;
+  proxied: z.ZodMiniBoolean<boolean>;
+  comment: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
+}, z.core.$strip>;
+declare function normalizeAddress(address: string | {
+  address?: string;
+  port?: number;
+} | null | undefined): {
+  host: string;
+  port?: number;
+};
+declare function ensureCloudflaredBinary(binPath: string): Promise<void>;
+declare function getLocalTarget(host: string, port: number): string;
+//#endregion
+export { AccountSchema, CloudflareApiResponseSchema, CloudflareErrorSchema, DNSRecordSchema, TunnelSchema, ZoneSchema, ensureCloudflaredBinary, getLocalTarget, normalizeAddress };

package/dist/api.js

@@ -1 +1,59 @@
-export {  };
+import * as z from "zod/mini";
+import NodeFS from "node:fs/promises";
+import { install } from "cloudflared";
+
+//#region src/api.ts
+const CloudflareErrorSchema = z.object({
+	code: z.number(),
+	message: z.string()
+});
+const CloudflareApiResponseSchema = z.object({
+	success: z.boolean(),
+	errors: z.optional(z.array(CloudflareErrorSchema)),
+	messages: z.optional(z.array(z.string())),
+	result: z.unknown()
+});
+const AccountSchema = z.object({
+	id: z.string(),
+	name: z.string()
+});
+const ZoneSchema = z.object({
+	id: z.string(),
+	name: z.string()
+});
+const TunnelSchema = z.object({
+	id: z.string(),
+	name: z.string(),
+	account_tag: z.string(),
+	created_at: z.string(),
+	connections: z.optional(z.array(z.unknown()))
+});
+const DNSRecordSchema = z.object({
+	id: z.string(),
+	type: z.string(),
+	name: z.string(),
+	content: z.string(),
+	proxied: z.boolean(),
+	comment: z.nullish(z.string())
+});
+function normalizeAddress(address) {
+	if (address && typeof address === "object") return {
+		host: "address" in address && address.address ? address.address : "localhost",
+		port: "port" in address && typeof address.port === "number" ? address.port : void 0
+	};
+	return { host: "localhost" };
+}
+async function ensureCloudflaredBinary(binPath) {
+	try {
+		await NodeFS.access(binPath);
+	} catch {
+		console.log("[unplugin-cloudflare-tunnel] Installing cloudflared binary...");
+		await install(binPath);
+	}
+}
+function getLocalTarget(host, port) {
+	return `http://${host.includes(":") ? `[${host}]` : host}:${port}`;
+}
+
+//#endregion
+export { AccountSchema, CloudflareApiResponseSchema, CloudflareErrorSchema, DNSRecordSchema, TunnelSchema, ZoneSchema, ensureCloudflaredBinary, getLocalTarget, normalizeAddress };

package/dist/esbuild.d.ts

@@ -1,4 +1,4 @@
-import { r as CloudflareTunnel } from "./index-BjNI6nQt.js";
+import { r as CloudflareTunnel } from "./index-BK_mUExr.js";
 
 //#region src/esbuild.d.ts
 

package/dist/esbuild.js

@@ -1,4 +1,4 @@
-import { t as CloudflareTunnel } from "./src-BC4MyCER.js";
+import { t as CloudflareTunnel } from "./src-CVRdCQUT.js";
 
 //#region src/esbuild.ts
 /**

package/dist/farm.d.ts

@@ -1,4 +1,4 @@
-import { r as CloudflareTunnel } from "./index-BjNI6nQt.js";
+import { r as CloudflareTunnel } from "./index-BK_mUExr.js";
 
 //#region src/farm.d.ts
 

package/dist/farm.js

@@ -1,4 +1,4 @@
-import { t as CloudflareTunnel } from "./src-BC4MyCER.js";
+import { t as CloudflareTunnel } from "./src-CVRdCQUT.js";
 
 //#region src/farm.ts
 /**

package/dist/{index-BjNI6nQt.d.ts → index-BK_mUExr.d.ts}

@@ -1,40 +1,40 @@
-import { z } from "zod";
 import { UnpluginInstance } from "unplugin";
+import * as z from "zod/mini";
 
 //#region src/index.d.ts
 
-declare const CloudflareApiResponseSchema: z.ZodType<{
-  success: boolean;
-  errors?: Array<{
-    code: number;
-    message: string;
-  }>;
-  messages?: Array<string>;
-  result: unknown;
-}>;
-declare const AccountSchema: z.ZodType<{
-  id: string;
-  name: string;
-}>;
-declare const ZoneSchema: z.ZodType<{
-  id: string;
-  name: string;
-}>;
-declare const TunnelSchema: z.ZodType<{
-  id: string;
-  name: string;
-  account_tag: string;
-  created_at: string;
-  connections?: Array<unknown>;
-}>;
-declare const DNSRecordSchema: z.ZodType<{
-  id: string;
-  type: string;
-  name: string;
-  content: string;
-  proxied: boolean;
-  comment?: string | null;
-}>;
+declare const CloudflareApiResponseSchema: z.ZodMiniObject<{
+  success: z.ZodMiniBoolean<boolean>;
+  errors: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniObject<{
+    code: z.ZodMiniNumber<number>;
+    message: z.ZodMiniString<string>;
+  }, z.core.$strip>>>;
+  messages: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+  result: z.ZodMiniUnknown;
+}, z.core.$strip>;
+declare const AccountSchema: z.ZodMiniObject<{
+  id: z.ZodMiniString<string>;
+  name: z.ZodMiniString<string>;
+}, z.core.$strip>;
+declare const ZoneSchema: z.ZodMiniObject<{
+  id: z.ZodMiniString<string>;
+  name: z.ZodMiniString<string>;
+}, z.core.$strip>;
+declare const TunnelSchema: z.ZodMiniObject<{
+  id: z.ZodMiniString<string>;
+  name: z.ZodMiniString<string>;
+  account_tag: z.ZodMiniString<string>;
+  created_at: z.ZodMiniString<string>;
+  connections: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniUnknown>>;
+}, z.core.$strip>;
+declare const DNSRecordSchema: z.ZodMiniObject<{
+  id: z.ZodMiniString<string>;
+  type: z.ZodMiniString<string>;
+  name: z.ZodMiniString<string>;
+  content: z.ZodMiniString<string>;
+  proxied: z.ZodMiniBoolean<boolean>;
+  comment: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
+}, z.core.$strip>;
 type CloudflareApiResponse<T = unknown> = z.infer<typeof CloudflareApiResponseSchema> & {
   result: T;
 };

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { a as DNSRecord, i as CloudflareTunnelOptions, n as CloudflareApiResponse, o as Tunnel, r as CloudflareTunnel, s as Zone, t as Account } from "./index-BjNI6nQt.js";
+import { a as DNSRecord, i as CloudflareTunnelOptions, n as CloudflareApiResponse, o as Tunnel, r as CloudflareTunnel, s as Zone, t as Account } from "./index-BK_mUExr.js";
 export { Account, CloudflareApiResponse, CloudflareTunnel, CloudflareTunnel as default, CloudflareTunnelOptions, DNSRecord, Tunnel, Zone };

package/dist/index.js

@@ -1,3 +1,3 @@
-import { n as src_default, t as CloudflareTunnel } from "./src-BC4MyCER.js";
+import { n as src_default, t as CloudflareTunnel } from "./src-CVRdCQUT.js";
 
 export { CloudflareTunnel, src_default as default };

package/dist/rolldown.d.ts

@@ -1,4 +1,4 @@
-import { r as CloudflareTunnel } from "./index-BjNI6nQt.js";
+import { r as CloudflareTunnel } from "./index-BK_mUExr.js";
 
 //#region src/rolldown.d.ts
 

package/dist/rolldown.js

@@ -1,4 +1,4 @@
-import { t as CloudflareTunnel } from "./src-BC4MyCER.js";
+import { t as CloudflareTunnel } from "./src-CVRdCQUT.js";
 
 //#region src/rolldown.ts
 /**

package/dist/rollup.d.ts

@@ -1,4 +1,4 @@
-import { r as CloudflareTunnel } from "./index-BjNI6nQt.js";
+import { r as CloudflareTunnel } from "./index-BK_mUExr.js";
 
 //#region src/rollup.d.ts
 

package/dist/rollup.js

@@ -1,4 +1,4 @@
-import { t as CloudflareTunnel } from "./src-BC4MyCER.js";
+import { t as CloudflareTunnel } from "./src-CVRdCQUT.js";
 
 //#region src/rollup.ts
 /**

package/dist/rspack.d.ts

@@ -1,4 +1,4 @@
-import { r as CloudflareTunnel } from "./index-BjNI6nQt.js";
+import { r as CloudflareTunnel } from "./index-BK_mUExr.js";
 
 //#region src/rspack.d.ts
 

package/dist/rspack.js

@@ -1,4 +1,4 @@
-import { t as CloudflareTunnel } from "./src-BC4MyCER.js";
+import { t as CloudflareTunnel } from "./src-CVRdCQUT.js";
 
 //#region src/rspack.ts
 /**

package/dist/{src-BC4MyCER.js → src-CVRdCQUT.js}

@@ -1,19 +1,53 @@
-import { bin, install } from "cloudflared";
-import fs from "node:fs/promises";
-import { exec, spawn } from "node:child_process";
-import { z } from "zod";
 import { createUnplugin } from "unplugin";
+import * as z from "zod/mini";
+import NodeFS from "node:fs/promises";
+import { bin, install } from "cloudflared";
+import * as NodeChildProcess from "node:child_process";
 
 //#region src/index.ts
+const PLUGIN_NAME = "unplugin-cloudflare-tunnel";
 const INFO_LOG_REGEX = /^.*Z INF .*/;
+const LOG_LEVEL_RANK = {
+	debug: 10,
+	info: 20,
+	warn: 30,
+	error: 40,
+	fatal: 50
+};
+function shouldLog(threshold, level) {
+	return LOG_LEVEL_RANK[level] >= LOG_LEVEL_RANK[threshold];
+}
+function supportsColor() {
+	if (!process.stdout.isTTY) return false;
+	if (process.env.NO_COLOR !== void 0) return false;
+	if (process.env.TERM === "dumb") return false;
+	if (process.env.FORCE_COLOR === "0") return false;
+	return true;
+}
+const ANSI = {
+	reset: "\x1B[0m",
+	dim: "\x1B[2m",
+	bold: "\x1B[1m",
+	blue: "\x1B[34m",
+	yellow: "\x1B[33m"
+};
+const ANSI_ESCAPE = String.fromCharCode(27);
+const ANSI_STYLE_SEQUENCE_REGEX = new RegExp(`${ANSI_ESCAPE}\\[[0-9;]*m`, "g");
+function stripAnsi(text) {
+	return text.replace(ANSI_STYLE_SEQUENCE_REGEX, "");
+}
+function colorize(text, ansi) {
+	if (!supportsColor()) return text;
+	return `${ansi}${text}${ANSI.reset}`;
+}
 const CloudflareErrorSchema = z.object({
 	code: z.number(),
 	message: z.string()
 });
 const CloudflareApiResponseSchema = z.object({
 	success: z.boolean(),
-	errors: z.array(CloudflareErrorSchema).optional(),
-	messages: z.array(z.string()).optional(),
+	errors: z.optional(z.array(CloudflareErrorSchema)),
+	messages: z.optional(z.array(z.string())),
 	result: z.unknown()
 });
 const AccountSchema = z.object({
@@ -29,7 +63,7 @@ const TunnelSchema = z.object({
 	name: z.string(),
 	account_tag: z.string(),
 	created_at: z.string(),
-	connections: z.array(z.unknown()).optional()
+	connections: z.optional(z.array(z.unknown()))
 });
 const DNSRecordSchema = z.object({
 	id: z.string(),
@@ -37,14 +71,14 @@ const DNSRecordSchema = z.object({
 	name: z.string(),
 	content: z.string(),
 	proxied: z.boolean(),
-	comment: z.string().nullish()
+	comment: z.nullish(z.string())
 });
 const unpluginFactory = (options = {}) => {
 	const { enabled = true } = options;
 	if (enabled === false) {
 		const VIRTUAL_MODULE_ID_STUB = "virtual:unplugin-cloudflare-tunnel";
 		return {
-			name: "unplugin-cloudflare-tunnel",
+			name: PLUGIN_NAME,
 			enforce: "pre",
 			resolveId(id) {
 				if (id === VIRTUAL_MODULE_ID_STUB) return "\0" + VIRTUAL_MODULE_ID_STUB;
@@ -95,8 +129,79 @@ const unpluginFactory = (options = {}) => {
 		cleanupConfig = namedOptions.cleanup || {};
 	}
 	const { port: userProvidedPort, logFile, logLevel, debug = false } = options;
-	const debugLog = (...args) => {
-		if (debug) console.log("[cloudflare-tunnel:debug]", ...args);
+	const effectivePluginLogLevel = logLevel ?? (debug ? "debug" : "info");
+	const pluginLog = {
+		debug: (...args) => {
+			if (debug || effectivePluginLogLevel === "debug") console.log("[cloudflare-tunnel:debug]", ...args);
+		},
+		info: (message) => {
+			if (shouldLog(effectivePluginLogLevel, "info")) console.log(`[unplugin-cloudflare-tunnel] ${message}`);
+		},
+		warn: (message) => {
+			if (shouldLog(effectivePluginLogLevel, "warn")) console.warn(`[unplugin-cloudflare-tunnel] ${message}`);
+		},
+		error: (message) => {
+			if (shouldLog(effectivePluginLogLevel, "error")) console.error(`[unplugin-cloudflare-tunnel] ${message}`);
+		}
+	};
+	const debugLog = pluginLog.debug;
+	const makeLocalDisplay = (localTarget) => {
+		if (!localTarget) return localTarget;
+		return localTarget.replace("http://[::1]:", "http://localhost:").replace("http://127.0.0.1:", "http://localhost:");
+	};
+	const announceConnecting = () => {
+		if (globalState.__tunnelConnectingAnnounced) return;
+		globalState.__tunnelConnectingAnnounced = true;
+		const message = isQuickMode ? "cf tunnel connecting…" : hostname ? `cf tunnel connecting… (${hostname})` : "cf tunnel connecting…";
+		console.log("");
+		console.log(colorize(message, ANSI.bold));
+	};
+	const announceTunnel = (params) => {
+		if (!params.url) return;
+		if (globalState.__lastAnnouncedTunnelKey === params.key) return;
+		globalState.__lastAnnouncedTunnelKey = params.key;
+		const cols = process.stdout.columns ?? 80;
+		const maxWidth = Math.max(10, cols - 2);
+		const headerText = "unplugin-cloudflare-tunnel";
+		const header = (() => {
+			return `${colorize("[", ANSI.yellow)}${headerText}${colorize("]", ANSI.yellow)}`;
+		})();
+		const urlLine = colorize(params.url, ANSI.blue + ANSI.bold);
+		const localLine = params.localTarget ? makeLocalDisplay(params.localTarget) : "";
+		const headerPlainLen = stripAnsi(header).length;
+		const contentPlainLen = Math.max(stripAnsi(urlLine).length, localLine.length, 10, 5);
+		const width = Math.min(90, maxWidth, Math.max(44, headerPlainLen, contentPlainLen + 4));
+		const rule = "─".repeat(width);
+		const center = (text) => {
+			const plainLen = stripAnsi(text).length;
+			const pad = Math.max(0, Math.floor((width - plainLen) / 2));
+			return `${" ".repeat(pad)}${text}`;
+		};
+		if (cols < 70) {
+			const out$1 = [];
+			out$1.push("");
+			out$1.push(`${header} ${colorize("Tunnel URL", ANSI.bold)} ${urlLine}`);
+			if (localLine) out$1.push(`${header} ${colorize("Local", ANSI.dim + ANSI.bold)} ${localLine}`);
+			out$1.push("");
+			console.log(out$1.join("\n"));
+			return;
+		}
+		const out = [];
+		out.push("");
+		out.push(center(header));
+		out.push(rule);
+		out.push(center(colorize("Tunnel URL", ANSI.bold)));
+		out.push(center(urlLine));
+		out.push(center(urlLine));
+		out.push(center(urlLine));
+		if (localLine) {
+			out.push("");
+			out.push(center(colorize("Local", ANSI.dim + ANSI.bold)));
+			out.push(center(localLine));
+		}
+		out.push(rule);
+		out.push("");
+		console.log(out.join("\n"));
 	};
 	if (!isQuickMode && (!hostname || typeof hostname !== "string")) throw new Error("[unplugin-cloudflare-tunnel] hostname is required and must be a valid string in named tunnel mode");
 	let tunnelUrl = hostname ? `https://${hostname}` : "";
@@ -252,7 +357,7 @@ const unpluginFactory = (options = {}) => {
 		if (logFile) cloudflaredArgs.push("--logfile", logFile);
 		cloudflaredArgs.push("--url", localTarget);
 		debugLog("Spawning quick tunnel:", bin, cloudflaredArgs);
-		const child$1 = spawn(bin, cloudflaredArgs, {
+		const child$1 = NodeChildProcess.spawn(bin, cloudflaredArgs, {
 			stdio: [
 				"ignore",
 				"pipe",
@@ -262,7 +367,7 @@ const unpluginFactory = (options = {}) => {
 			windowsHide: true,
 			shell: process.platform === "win32"
 		});
-		console.log(`[unplugin-cloudflare-tunnel] Quick tunnel process spawned with PID: ${child$1.pid}`);
+		debugLog(`[unplugin-cloudflare-tunnel] Quick tunnel process spawned with PID: ${child$1.pid}`);
 		return new Promise((resolve, reject) => {
 			let urlFound = false;
 			const timeout = setTimeout(() => {
@@ -310,17 +415,17 @@ const unpluginFactory = (options = {}) => {
 		globalState.shuttingDown = true;
 		globalState.tunnelUrl = void 0;
 		try {
-			console.log(`[unplugin-cloudflare-tunnel] 🛑 Terminating cloudflared process (PID: ${child.pid}) with ${signal}...`);
-			if (!child.kill(signal) && process.platform === "win32") exec(`taskkill /pid ${child.pid} /T /F`, () => {});
+			debugLog(`[unplugin-cloudflare-tunnel] Terminating cloudflared process (PID: ${child.pid}) with ${signal}...`);
+			if (!child.kill(signal) && process.platform === "win32") NodeChildProcess.exec(`taskkill /pid ${child.pid} /T /F`, () => {});
 			if (signal === "SIGTERM") setTimeout(() => {
 				if (child && !child.killed) {
-					console.log("[unplugin-cloudflare-tunnel] 🛑 Force killing cloudflared process...");
-					if (process.platform === "win32") exec(`taskkill /pid ${child.pid} /T /F`, () => {});
+					debugLog("[unplugin-cloudflare-tunnel] Force killing cloudflared process...");
+					if (process.platform === "win32") NodeChildProcess.exec(`taskkill /pid ${child.pid} /T /F`, () => {});
 					else child.kill("SIGKILL");
 				}
 			}, 2e3);
 		} catch (error) {
-			console.log(`[unplugin-cloudflare-tunnel] Note: Error killing cloudflared: ${error}`);
+			debugLog(`[unplugin-cloudflare-tunnel] Note: Error killing cloudflared: ${error}`);
 		}
 	};
 	let exitHandlersRegistered = globalState.exitHandlersRegistered ?? false;
@@ -359,9 +464,27 @@ const unpluginFactory = (options = {}) => {
 		const generateDnsComment = () => {
 			return `unplugin-cloudflare-tunnel:${tunnelName}`;
 		};
+		const registerListeningHandler = (handler) => {
+			const httpServer = server.httpServer;
+			if (!httpServer) return;
+			const invokeHandler = () => {
+				try {
+					const maybePromise = handler();
+					if (maybePromise && typeof maybePromise.then === "function") maybePromise.catch((error) => {
+						console.error(`[unplugin-cloudflare-tunnel] ❌ Dev server listening hook failed: ${error.message}`);
+					});
+				} catch (error) {
+					console.error(`[unplugin-cloudflare-tunnel] ❌ Dev server listening hook failed: ${error.message}`);
+				}
+			};
+			httpServer.on("listening", invokeHandler);
+			if (httpServer.listening) invokeHandler();
+		};
 		try {
 			const { host: serverHost, port: detectedPort } = normalizeAddress(server.httpServer?.address());
-			const port = userProvidedPort || detectedPort || server.config.server.port || 5173;
+			const configPortValue = server.config?.server?.port;
+			const resolvedConfigPort = typeof configPortValue === "string" ? Number.parseInt(configPortValue, 10) : configPortValue;
+			const port = userProvidedPort || detectedPort || (typeof resolvedConfigPort === "number" && !Number.isNaN(resolvedConfigPort) ? resolvedConfigPort : void 0) || 5173;
 			const newConfigHash = JSON.stringify({
 				isQuickMode,
 				hostname,
@@ -372,13 +495,13 @@ const unpluginFactory = (options = {}) => {
 			});
 			if (globalState.child && !globalState.child.killed && globalState.configHash === newConfigHash) {
 				tunnelUrl = await globalState.tunnelUrl ?? "";
-				console.log("[unplugin-cloudflare-tunnel] Config unchanged – re-using existing tunnel");
+				debugLog("[unplugin-cloudflare-tunnel] Config unchanged – re-using existing tunnel");
 				globalState.shuttingDown = false;
 				registerExitHandler();
 				return;
 			}
 			if (globalState.child && !globalState.child.killed) {
-				console.log("[unplugin-cloudflare-tunnel] Config changed – terminating previous tunnel...");
+				debugLog("[unplugin-cloudflare-tunnel] Config changed – terminating previous tunnel...");
 				try {
 					globalState.child.kill("SIGTERM");
 				} catch (_) {}
@@ -387,7 +510,7 @@ const unpluginFactory = (options = {}) => {
 			delete globalState.configHash;
 			globalState.shuttingDown = false;
 			if (isQuickMode) {
-				console.log("[unplugin-cloudflare-tunnel] Starting quick tunnel mode...");
+				debugLog("[unplugin-cloudflare-tunnel] Starting quick tunnel mode...");
 				debugLog("Quick tunnel mode - no API token or hostname required");
 				await ensureCloudflaredBinary(bin);
 				const localTarget$1 = getLocalTarget(serverHost, port);
@@ -399,20 +522,33 @@ const unpluginFactory = (options = {}) => {
 					globalState.child = child;
 					globalState.configHash = newConfigHash;
 					registerExitHandler();
-					console.log(`🌐  Quick tunnel ready at: ${url}`);
-					server.httpServer?.on("listening", async () => {
+					registerListeningHandler(() => {
+						const { host: actualServerHost, port: actualPort } = normalizeAddress(server.httpServer?.address());
+						const actualLocalTarget = getLocalTarget(actualServerHost, actualPort ?? port);
+						announceTunnel({
+							key: `quick:${url}:${actualPort ?? port}`,
+							url,
+							localTarget: actualLocalTarget
+						});
+					});
+					registerListeningHandler(async () => {
 						try {
 							const { host: actualServerHost, port: actualPort } = normalizeAddress(server.httpServer?.address());
 							if (actualPort !== port) {
-								console.log(`[unplugin-cloudflare-tunnel] ⚠️  Port conflict detected - server is using port ${actualPort} instead of ${port}`);
-								console.log(`[unplugin-cloudflare-tunnel] 🔄 Quick tunnel needs to be restarted for new port...`);
+								pluginLog.warn(`Port conflict detected - server is using port ${actualPort} instead of ${port}`);
+								pluginLog.info("Restarting quick tunnel for the new port...");
 								killCloudflared("SIGTERM");
 								await new Promise((resolve) => setTimeout(resolve, 1e3));
-								const { child: newChild, url: newUrl } = await spawnQuickTunnel(getLocalTarget(actualServerHost, actualPort ?? port));
+								const newLocalTarget = getLocalTarget(actualServerHost, actualPort ?? port);
+								const { child: newChild, url: newUrl } = await spawnQuickTunnel(newLocalTarget);
 								tunnelUrl = newUrl;
 								child = newChild;
 								globalState.child = child;
-								console.log(`🌐  Quick tunnel updated for port ${actualPort}: ${newUrl}`);
+								announceTunnel({
+									key: `quick:${newUrl}:${actualPort ?? port}`,
+									url: newUrl,
+									localTarget: newLocalTarget
+								});
 								globalState.configHash = JSON.stringify({
 									isQuickMode,
 									hostname,
@@ -435,10 +571,10 @@ const unpluginFactory = (options = {}) => {
 					throw error;
 				}
 			}
-			console.log("[unplugin-cloudflare-tunnel] Starting named tunnel mode...");
+			debugLog("[unplugin-cloudflare-tunnel] Starting named tunnel mode...");
 			const apiToken = providedApiToken || process.env.CLOUDFLARE_API_KEY;
 			if (!apiToken) throw new Error("[unplugin-cloudflare-tunnel] API token is required. Provide it via 'apiToken' option or set the CLOUDFLARE_API_KEY environment variable. Get your token at: https://dash.cloudflare.com/profile/api-tokens");
-			console.log(`[unplugin-cloudflare-tunnel] Using port ${port}${userProvidedPort === port ? " (user-provided)" : " (from bundler config)"}`);
+			debugLog(`[unplugin-cloudflare-tunnel] Using port ${port}${userProvidedPort === port ? " (user-provided)" : " (from bundler config)"}`);
 			await ensureCloudflaredBinary(bin);
 			const accounts = await cf(apiToken, "GET", "/accounts", void 0, z.array(AccountSchema));
 			const accountId = forcedAccount || accounts[0]?.id;
@@ -462,7 +598,7 @@ const unpluginFactory = (options = {}) => {
 			const { autoCleanup = true } = cleanupConfig;
 			let tunnel = (await cf(apiToken, "GET", `/accounts/${accountId}/cfd_tunnel?name=${tunnelName}`, void 0, z.array(TunnelSchema)))[0];
 			if (!tunnel) {
-				console.log(`[unplugin-cloudflare-tunnel] Creating tunnel '${tunnelName}'...`);
+				pluginLog.info(`Creating tunnel '${tunnelName}'...`);
 				tunnel = await cf(apiToken, "POST", `/accounts/${accountId}/cfd_tunnel`, {
 					name: tunnelName,
 					config_src: "cloudflare"
@@ -470,13 +606,13 @@ const unpluginFactory = (options = {}) => {
 			}
 			const tunnelId = tunnel.id;
 			if (autoCleanup) {
-				console.log(`[unplugin-cloudflare-tunnel] 🧹 Running resource cleanup for tunnel '${tunnelName}'...`);
+				debugLog(`[unplugin-cloudflare-tunnel] Running resource cleanup for tunnel '${tunnelName}'...`);
 				const dnsCleanup = await cleanupMismatchedDnsRecords(apiToken, zoneId, generateDnsComment(), hostname, tunnelId);
-				if (dnsCleanup.found.length > 0) console.log(`[unplugin-cloudflare-tunnel] 📊 DNS cleanup: ${dnsCleanup.found.length} mismatched, ${dnsCleanup.deleted.length} deleted`);
+				if (dnsCleanup.found.length > 0) pluginLog.warn(`DNS cleanup: ${dnsCleanup.found.length} mismatched, ${dnsCleanup.deleted.length} deleted`);
 				const mismatchedSslCerts = await findMismatchedSslCertificates(apiToken, zoneId, tunnelName, hostname);
 				if (mismatchedSslCerts.length > 0) {
 					for (const cert of mismatchedSslCerts) await cf(apiToken, "DELETE", `/zones/${zoneId}/ssl/certificate_packs/${cert.id}`);
-					console.log(`[unplugin-cloudflare-tunnel] 📊 SSL cleanup: ${mismatchedSslCerts.length} deleted`);
+					pluginLog.warn(`SSL cleanup: ${mismatchedSslCerts.length} deleted`);
 				}
 			} else debugLog("← Cleanup skipped", cleanupConfig);
 			const localTarget = getLocalTarget(serverHost, port);
@@ -549,7 +685,7 @@ const unpluginFactory = (options = {}) => {
 						debugLog("← Total TLS", totalTls);
 						const existingHostnameCert = certContainingHost(hostname);
 						if (totalTls.status !== "on" && !existingHostnameCert) {
-							console.log(`[unplugin-cloudflare-tunnel] Requesting edge certificate for ${hostname}...`);
+							pluginLog.info(`Requesting edge certificate for ${hostname}...`);
 							const tagHostname = generateSslTagHostname();
 							const certificateHosts = [hostname, tagHostname];
 							debugLog(`Adding tag hostname to certificate: ${tagHostname}`);
@@ -574,7 +710,7 @@ const unpluginFactory = (options = {}) => {
 			if (logFile) cloudflaredArgs.push("--logfile", logFile);
 			debugLog("Spawning cloudflared", bin, cloudflaredArgs);
 			cloudflaredArgs.push("run", "--token", token);
-			child = spawn(bin, cloudflaredArgs, {
+			child = NodeChildProcess.spawn(bin, cloudflaredArgs, {
 				stdio: [
 					"ignore",
 					"pipe",
@@ -584,18 +720,37 @@ const unpluginFactory = (options = {}) => {
 				windowsHide: true,
 				shell: process.platform === "win32"
 			});
-			console.log(`[unplugin-cloudflare-tunnel] Process spawned with PID: ${child.pid}`);
+			debugLog(`[unplugin-cloudflare-tunnel] Process spawned with PID: ${child.pid}`);
 			globalState.child = child;
 			globalState.configHash = newConfigHash;
 			registerExitHandler();
 			let tunnelReady = false;
+			const logCloudflaredLines = (kind, text) => {
+				if (globalState.shuttingDown && !debug) return;
+				const isVerbose = effectiveLogLevel === "debug" || effectiveLogLevel === "info";
+				const lines = text.split("\n").map((l) => l.trim()).filter(Boolean);
+				if (isVerbose) {
+					for (const line of lines) {
+						const prefix = kind === "stdout" ? "[cloudflared stdout]" : "[cloudflared stderr]";
+						if (kind === "stdout") console.log(`${prefix} ${line}`);
+						else console.error(`${prefix} ${line}`);
+					}
+					return;
+				}
+				for (const line of lines) {
+					if (INFO_LOG_REGEX.test(line)) continue;
+					const prefix = kind === "stdout" ? "[cloudflared stdout]" : "[cloudflared stderr]";
+					if (kind === "stdout") console.log(`${prefix} ${line}`);
+					else console.error(`${prefix} ${line}`);
+				}
+			};
 			child.stdout?.on("data", (data) => {
 				const output = data.toString();
-				if (!globalState.shuttingDown || debug) console.log(`[cloudflared stdout] ${output.trim()}`);
+				logCloudflaredLines("stdout", output);
 				if (output.includes("Connection") && output.includes("registered")) {
 					if (!tunnelReady) {
 						tunnelReady = true;
-						console.log(`🌐  Cloudflare tunnel started for https://${hostname}`);
+						pluginLog.info(`Tunnel connected for https://${hostname}`);
 					}
 				}
 			});
@@ -605,10 +760,7 @@ const unpluginFactory = (options = {}) => {
 					if (logLevel === "debug") console.log(`[cloudflared debug] ${error}`);
 					return;
 				}
-				if (!globalState.shuttingDown || debug) console.error(`[cloudflared stderr] ${error}`);
-				if (error.toLowerCase().includes("error") || error.toLowerCase().includes("failed") || error.toLowerCase().includes("fatal")) {
-					if (!globalState.shuttingDown || debug) console.error(`[unplugin-cloudflare-tunnel] ⚠️  ${error}`);
-				}
+				logCloudflaredLines("stderr", error);
 			});
 			child.on("error", (error) => {
 				console.error(`[unplugin-cloudflare-tunnel] ❌ Failed to start tunnel process: ${error.message}`);
@@ -620,25 +772,31 @@ const unpluginFactory = (options = {}) => {
 					if (signal) console.error(`[unplugin-cloudflare-tunnel] Process terminated by signal: ${signal}`);
 				} else if (code === 0) console.log(`[unplugin-cloudflare-tunnel] ✅ Tunnel process exited cleanly`);
 			});
-			setTimeout(() => {
-				if (!tunnelReady) console.log(`🌐  Cloudflare tunnel starting for https://${hostname}`);
-			}, 3e3);
+			registerListeningHandler(() => {
+				const { host: actualServerHost, port: actualPort } = normalizeAddress(server.httpServer?.address());
+				const actualLocalTarget = getLocalTarget(actualServerHost, actualPort ?? port);
+				announceTunnel({
+					key: `named:${hostname}:${actualPort ?? port}`,
+					url: `https://${hostname}`,
+					localTarget: actualLocalTarget
+				});
+			});
 			server.httpServer?.once("close", () => {
 				killCloudflared("SIGTERM");
 			});
-			server.httpServer?.on("listening", async () => {
+			registerListeningHandler(async () => {
 				try {
 					const { host: actualServerHost, port: actualPort } = normalizeAddress(server.httpServer?.address());
 					if (actualPort !== port) {
-						console.log(`[unplugin-cloudflare-tunnel] ⚠️  Port conflict detected - server is using port ${actualPort} instead of ${port}`);
-						console.log(`[unplugin-cloudflare-tunnel] 🔄 Updating tunnel configuration...`);
+						pluginLog.warn(`Port conflict detected - server is using port ${actualPort} instead of ${port}`);
+						pluginLog.info("Updating tunnel configuration...");
 						const newLocalTarget = getLocalTarget(actualServerHost, actualPort ?? port);
 						debugLog("← Updating local target to", newLocalTarget);
 						await cf(apiToken, "PUT", `/accounts/${accountId}/cfd_tunnel/${tunnelId}/configurations`, { config: { ingress: [{
 							hostname,
 							service: newLocalTarget
 						}, { service: "http_status:404" }] } });
-						console.log(`[unplugin-cloudflare-tunnel] ✅ Tunnel configuration updated to use port ${actualPort}`);
+						pluginLog.info(`Tunnel configuration updated to use port ${actualPort}`);
 						globalState.configHash = JSON.stringify({
 							hostname,
 							port: actualPort,
@@ -652,27 +810,121 @@ const unpluginFactory = (options = {}) => {
 				}
 			});
 		} catch (error) {
-			console.error(`[unplugin-cloudflare-tunnel] ❌ Setup failed: ${error.message}`);
-			if (error.message.includes("API token")) {
-				console.error(`[unplugin-cloudflare-tunnel] 💡 Check your API token at: https://dash.cloudflare.com/profile/api-tokens`);
-				console.error(`[unplugin-cloudflare-tunnel] 💡 Required permissions: Zone:Zone:Read, Zone:DNS:Edit, Account:Cloudflare Tunnel:Edit`);
-			} else if (error.message.includes("Zone") && error.message.includes("not found")) console.error(`[unplugin-cloudflare-tunnel] 💡 Make sure '${hostname}' domain is added to your Cloudflare account`);
-			else if (error.message.includes("cloudflared")) console.error(`[unplugin-cloudflare-tunnel] 💡 Try deleting node_modules and reinstalling to get a fresh cloudflared binary`);
+			if (error instanceof Error) {
+				console.error(`[unplugin-cloudflare-tunnel] ❌ Setup failed: ${error.message}`);
+				if (error.message.includes("API token")) {
+					console.error(`[unplugin-cloudflare-tunnel] 💡 Check your API token at: https://dash.cloudflare.com/profile/api-tokens`);
+					console.error(`[unplugin-cloudflare-tunnel] 💡 Required permissions: Zone:Zone:Read, Zone:DNS:Edit, Account:Cloudflare Tunnel:Edit`);
+				} else if (error.message.includes("Zone") && error.message.includes("not found")) console.error(`[unplugin-cloudflare-tunnel] 💡 Make sure '${hostname}' domain is added to your Cloudflare account`);
+				else if (error.message.includes("cloudflared")) console.error(`[unplugin-cloudflare-tunnel] 💡 Try deleting node_modules and reinstalling to get a fresh cloudflared binary`);
+			}
 			throw error;
 		}
 	};
+	const ensureWebpackAllowedHosts = (devServerOptions, bundler) => {
+		if (!devServerOptions) return;
+		const hostToAllow = isQuickMode ? ".trycloudflare.com" : hostname;
+		if (!hostToAllow) return;
+		const label = bundler === "webpack" ? "Webpack" : "Rspack";
+		const normalizeArray = (values) => {
+			const unique = Array.from(new Set(values.filter(Boolean)));
+			devServerOptions.allowedHosts = unique;
+			return unique;
+		};
+		let modified = false;
+		const current = devServerOptions.allowedHosts;
+		if (current === "all") return;
+		if (typeof current === "undefined" || current === "auto") {
+			normalizeArray(["localhost", hostToAllow]);
+			modified = true;
+		} else if (typeof current === "string") {
+			if (current !== hostToAllow) {
+				normalizeArray([current, hostToAllow]);
+				modified = true;
+			}
+		} else if (Array.isArray(current)) {
+			if (!current.includes(hostToAllow)) {
+				current.push(hostToAllow);
+				modified = true;
+			}
+		}
+		if (modified) debugLog(`[unplugin-cloudflare-tunnel] Configured ${label} devServer.allowedHosts to include ${hostToAllow}`);
+	};
+	const setupWebpackLikeDevServerIntegration = (compiler, bundler) => {
+		if ((compiler?.options?.mode ?? process.env.NODE_ENV) === "production") return;
+		const optionsContainer = compiler.options;
+		if (!optionsContainer.devServer) optionsContainer.devServer = {};
+		const devServerOptions = optionsContainer.devServer;
+		ensureWebpackAllowedHosts(devServerOptions, bundler);
+		let lastHttpServer;
+		let missingServerWarned = false;
+		const runConfiguration = (devServerInstance) => {
+			if (!devServerInstance) {
+				if (!missingServerWarned) {
+					console.warn(`[unplugin-cloudflare-tunnel] ${bundler} dev server instance unavailable; skipping tunnel setup`);
+					missingServerWarned = true;
+				}
+				return;
+			}
+			const httpServer = [
+				devServerInstance.server,
+				devServerInstance.httpServer,
+				devServerInstance.listeningApp,
+				devServerInstance.server?.server
+			].find((candidate) => candidate);
+			if (!httpServer) {
+				if (!missingServerWarned) {
+					console.warn(`[unplugin-cloudflare-tunnel] Unable to locate HTTP server from ${bundler} dev server; tunnel will not start`);
+					missingServerWarned = true;
+				}
+				return;
+			}
+			if (lastHttpServer === httpServer) return;
+			lastHttpServer = httpServer;
+			httpServer.once("close", () => {
+				if (lastHttpServer === httpServer) lastHttpServer = void 0;
+			});
+			const configuredPromise = configureServer({
+				httpServer,
+				config: { server: { port: devServerInstance.options?.port ?? devServerOptions?.port } }
+			});
+			globalState.tunnelUrl = configuredPromise.then(() => tunnelUrl).catch(() => "");
+			configuredPromise.catch(() => {});
+		};
+		const scheduleConfiguration = (devServerInstance) => {
+			const httpServer = devServerInstance?.server || devServerInstance?.httpServer || devServerInstance?.listeningApp;
+			if (httpServer && typeof httpServer.once === "function") if (httpServer.listening) runConfiguration(devServerInstance);
+			else httpServer.once("listening", () => runConfiguration(devServerInstance));
+			else runConfiguration(devServerInstance);
+		};
+		const originalSetupMiddlewares = devServerOptions.setupMiddlewares;
+		devServerOptions.setupMiddlewares = function(middlewares, devServer) {
+			scheduleConfiguration(devServer);
+			if (typeof originalSetupMiddlewares === "function") return originalSetupMiddlewares.call(this, middlewares, devServer);
+			return middlewares;
+		};
+		const originalOnListening = devServerOptions.onListening;
+		devServerOptions.onListening = function(devServer) {
+			scheduleConfiguration(devServer);
+			if (typeof originalOnListening === "function") return originalOnListening.call(this, devServer);
+		};
+	};
 	return {
-		name: "unplugin-cloudflare-tunnel",
+		name: PLUGIN_NAME,
 		enforce: "pre",
-		resolveId(id) {
-			if (id === VIRTUAL_MODULE_ID) return "\0" + VIRTUAL_MODULE_ID;
+		resolveId: (id) => {
+			if (id === VIRTUAL_MODULE_ID) {
+				debugLog("resolveId called for", id);
+				return "\0" + VIRTUAL_MODULE_ID;
+			}
 		},
-		async load(id) {
+		load: async (id) => {
 			const url = await globalState.tunnelUrl;
 			if (id === "\0" + VIRTUAL_MODULE_ID) return `export function getTunnelUrl() { return ${JSON.stringify(url || "")}; }`;
 		},
 		vite: {
-			config(config) {
+			config: (config) => {
+				announceConnecting();
 				if (!config.server) config.server = {};
 				if (isQuickMode) {
 					config.server.allowedHosts = [".trycloudflare.com"];
@@ -680,15 +932,15 @@ const unpluginFactory = (options = {}) => {
 				}
 				if (!config.server.allowedHosts) {
 					config.server.allowedHosts = [hostname];
-					console.log(`[unplugin-cloudflare-tunnel] Configured Vite to allow requests from ${hostname}`);
+					debugLog(`[unplugin-cloudflare-tunnel] Configured Vite to allow requests from ${hostname}`);
 				} else if (Array.isArray(config.server.allowedHosts)) {
 					if (!config.server.allowedHosts.includes(hostname)) {
 						config.server.allowedHosts.push(hostname);
-						console.log(`[unplugin-cloudflare-tunnel] Added ${hostname} to allowed hosts`);
+						debugLog(`[unplugin-cloudflare-tunnel] Added ${hostname} to allowed hosts`);
 					}
 				}
 			},
-			configureServer(server) {
+			configureServer: (server) => {
 				const configuredPromise = configureServer(server);
 				globalState.tunnelUrl = configuredPromise.then(() => tunnelUrl).catch(() => "");
 				return async () => {
@@ -696,6 +948,12 @@ const unpluginFactory = (options = {}) => {
 				};
 			}
 		},
+		rspack: (compiler) => {
+			setupWebpackLikeDevServerIntegration(compiler, "rspack");
+		},
+		webpack: (compiler) => {
+			setupWebpackLikeDevServerIntegration(compiler, "webpack");
+		},
 		closeBundle() {
 			killCloudflared("SIGTERM");
 			delete globalState.child;
@@ -713,7 +971,7 @@ function normalizeAddress(address) {
 }
 async function ensureCloudflaredBinary(binPath) {
 	try {
-		await fs.access(binPath);
+		await NodeFS.access(binPath);
 	} catch {
 		console.log("[unplugin-cloudflare-tunnel] Installing cloudflared binary...");
 		await install(binPath);

package/dist/vite.d.ts

@@ -1,4 +1,4 @@
-import { r as CloudflareTunnel } from "./index-BjNI6nQt.js";
+import { r as CloudflareTunnel } from "./index-BK_mUExr.js";
 
 //#region src/vite.d.ts
 

package/dist/vite.js

@@ -1,4 +1,4 @@
-import { t as CloudflareTunnel } from "./src-BC4MyCER.js";
+import { t as CloudflareTunnel } from "./src-CVRdCQUT.js";
 
 //#region src/vite.ts
 /**

package/dist/webpack.d.ts

@@ -1,4 +1,4 @@
-import { r as CloudflareTunnel } from "./index-BjNI6nQt.js";
+import { r as CloudflareTunnel } from "./index-BK_mUExr.js";
 
 //#region src/webpack.d.ts
 

package/dist/webpack.js

@@ -1,4 +1,4 @@
-import { t as CloudflareTunnel } from "./src-BC4MyCER.js";
+import { t as CloudflareTunnel } from "./src-CVRdCQUT.js";
 
 //#region src/webpack.ts
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "unplugin-cloudflare-tunnel",
-  "version": "0.0.0-alpha-1",
-  "packageManager": "bun@1.3.1",
+  "version": "0.0.1",
+  "packageManager": "bun@1.3.5",
   "description": "A plugin that automatically creates and manages Cloudflare tunnels for local development",
   "type": "module",
   "imports": {
@@ -51,28 +51,27 @@
   "dependencies": {
     "cloudflared": "^0.7.1",
     "unplugin": "^2.3.10",
-    "unplugin-utils": "^0.3.1",
-    "zod": "^4.1.12"
+    "zod": "^4.2.1"
   },
   "devDependencies": {
     "@arethetypeswrong/core": "^0.18.2",
-    "@biomejs/biome": "^2.3.2",
-    "@changesets/changelog-github": "^0.5.1",
-    "@changesets/cli": "^2.29.7",
+    "@biomejs/biome": "^2.3.10",
+    "@changesets/changelog-github": "^0.5.2",
+    "@changesets/cli": "^2.29.8",
     "@rspack/core": "^1.5.7",
-    "@sxzz/test-utils": "^0.5.12",
+    "@sxzz/test-utils": "^0.5.15",
     "@total-typescript/ts-reset": "^0.6.1",
-    "@types/bun": "^1.3.1",
-    "@types/node": "^24.9.1",
-    "execa": "^9.6.0",
-    "publint": "^0.3.15",
+    "@types/bun": "^1.3.5",
+    "@types/node": "^25.0.3",
+    "execa": "^9.6.1",
+    "publint": "^0.3.16",
     "rollup": "^4.52.3",
-    "tsdown": "^0.15.10",
-    "tsx": "^4.20.6",
+    "tsdown": "^0.15.12",
+    "tsx": "^4.21.0",
     "typescript": "^5.9.3",
-    "unplugin-unused": "^0.5.4",
+    "unplugin-unused": "^0.5.6",
     "vite": "^7.1.12",
-    "vitest": "^4.0.3",
+    "vitest": "^4.0.16",
     "webpack-dev-server": "^5.2.2"
   },
   "peerDependencies": {
@@ -111,7 +110,7 @@
     }
   },
   "engines": {
-    "node": ">=20.19.0"
+    "node": ">=20.0"
   },
   "keywords": [
     "unplugin",
@@ -126,6 +125,7 @@
   ],
   "license": "MIT",
   "repository": "o-az/unplugin-cloudflare-tunnel",
+  "readme": "https://github.com/o-az/unplugin-cloudflare-tunnel/blob/main/.github/README.md",
   "author": "Omar A <gh@omar.mov>",
   "publishConfig": {
     "access": "public"