@apps-in-toss/devtools 3.1.0-beta.1 → 3.1.0

package/dist/unplugin/tunnel.cjs

@@ -1,191 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-let node_fs = require("node:fs");
-let node_fs_promises = require("node:fs/promises");
-let node_path = require("node:path");
-//#region src/unplugin/tunnel.ts
-/**
-* Cloudflare quick-tunnel helper for the devtools unplugin.
-*
-* Loaded lazily (`await import('./tunnel.js')`) only when the `tunnel` option is
-* on, so `cloudflared` / `qrcode-terminal` are never pulled in for the common
-* case. This is the one place in `@apps-in-toss/devtools` that depends on Node-only
-* APIs (`child_process` via the `cloudflared` wrapper) — keep it thin and out of
-* jsdom unit tests; the spawn path is verified by hand / e2e (same spirit as the
-* "web 모드는 e2e" rule in CLAUDE.md). The pure helpers below
-* (`parseTrycloudflareUrl`, `printTunnelBanner`) are unit-tested.
-*/
-/** Matches the public URL cloudflared prints for an unauthenticated quick tunnel. */
-const TRYCLOUDFLARE_RE = /https:\/\/[a-z0-9-]+\.trycloudflare\.com/i;
-/**
-* Extract the `https://<sub>.trycloudflare.com` URL from a line of cloudflared
-* output, or `null` if the line doesn't contain one. Pulled out as a pure
-* function so it can be unit-tested without spawning anything.
-*/
-function parseTrycloudflareUrl(line) {
-	const m = line.match(TRYCLOUDFLARE_RE);
-	return m ? m[0] : null;
-}
-const LAUNCHER_URL = "https://devtools.aitc.dev/launcher/";
-/**
-* Build the deep-link URL that QR codes encode: when the launcher PWA is
-* already on the phone's home screen, scanning this opens it directly into the
-* live view for `tunnelUrl` (the launcher consumes `?url=` and clears it).
-* Plain-text raw URL is no longer enough — the launcher gates its setup UI to
-* the installed PWA, so a raw tunnel URL opened in a normal browser tab would
-* land on a "please install" screen.
-*
-* When `opts.name` is given (non-blank), it is added as `&name=` so the launcher
-* partner bar shows the app name instead of the generic default (#498).
-*
-* When `opts.webViewType` is `'game'`, `&navBarType=game` is appended so the
-* launcher enters game nav chrome (floating capsule, no full bar) automatically
-* on scan. `'partner'` is the launcher's implicit default and is not added to
-* keep the URL clean (#584).
-*
-* When `opts.navBarTransparent` is `true`, `&navBarTransparent=1` is appended
-* so the launcher partner bar renders with a transparent background (#587).
-*
-* When `opts.navBarTheme` is `'light'` or `'dark'`, `&navBarTheme=<v>` is
-* appended so the launcher partner bar uses the matching foreground colour (#587).
-*/
-function buildLauncherDeepLink(tunnelUrl, optsParam) {
-	const opts = optsParam ?? {};
-	let url = `${LAUNCHER_URL}?url=${encodeURIComponent(tunnelUrl)}`;
-	if (opts.name !== void 0 && opts.name.trim() !== "") url += `&name=${encodeURIComponent(opts.name.trim())}`;
-	if (opts.webViewType === "game") url += "&navBarType=game";
-	if (opts.navBarTransparent === true) url += "&navBarTransparent=1";
-	if (opts.navBarTheme === "light" || opts.navBarTheme === "dark") url += `&navBarTheme=${opts.navBarTheme}`;
-	return url;
-}
-/**
-* Print the terminal banner announcing the live tunnel: the public URL, an ASCII
-* QR encoding a launcher deep-link, and a one-line note that quick tunnels are
-* ephemeral, unauthenticated and not for production. Pure w.r.t. side effects
-* other than the injected `log` sink and `qrcode-terminal` — unit-tested.
-*/
-async function printTunnelBanner(url, opts = {}) {
-	const log = opts.log ?? ((m) => console.log(m));
-	const deepLink = buildLauncherDeepLink(url, {
-		name: opts.name,
-		webViewType: opts.webViewType,
-		navBarTransparent: opts.navBarTransparent,
-		navBarTheme: opts.navBarTheme
-	});
-	log([
-		"",
-		"  ┌─ @apps-in-toss/devtools · live tunnel ────────────────────────────",
-		`  │  ${url}`,
-		"  │",
-		`  │  Install the launcher PWA once:  ${LAUNCHER_URL}`,
-		"  │  Then scan the QR below — it opens the launcher directly",
-		"  │  into this tunnel URL (no manual paste needed).",
-		"  │  Quick tunnels are unauthenticated, change every run, and are",
-		"  │  not for production use.",
-		"  └──────────────────────────────────────────────────────────────",
-		""
-	].join("\n"));
-	if (opts.qr !== false) {
-		const qrcode = (await import("qrcode-terminal")).default;
-		await new Promise((resolve) => {
-			qrcode.generate(deepLink, { small: true }, (out) => {
-				log(out);
-				resolve();
-			});
-		});
-	}
-}
-/**
-* Sanitize cloudflared stderr output for error diagnostics (#421).
-*
-* Masks `*.trycloudflare.com` hostnames and full `https://` / `wss://` URLs
-* that carry those hostnames so tunnel host values never appear in error
-* messages. Diagnostic content (error codes, reasons, JSON blobs) is preserved.
-*
-* SECRET-HANDLING: tunnel host is SECRET-class per harness policy — only
-* placeholder text is emitted.
-*/
-function sanitizeCloudflaredOutput(line) {
-	let s = line.replace(/(?:https?|wss?):\/\/[a-z0-9-]+\.trycloudflare\.com(?:\/[^\s]*)*/gi, (m) => m.replace(/[a-z0-9-]+\.trycloudflare\.com/i, "<HOST>.trycloudflare.com"));
-	s = s.replace(/[a-z0-9-]+\.trycloudflare\.com/gi, "<HOST>.trycloudflare.com");
-	return s;
-}
-const URL_TIMEOUT_MS = 2e4;
-/**
-* Start an unauthenticated Cloudflare quick tunnel to `http://localhost:<port>`
-* and resolve once the public URL is known. Downloads the `cloudflared` binary
-* on first use if it is not already installed. Rejects with a friendly error if
-* no URL appears within {@link URL_TIMEOUT_MS}.
-*/
-async function startQuickTunnel(port) {
-	const { bin, install, Tunnel } = await import("cloudflared");
-	if (!(0, node_fs.existsSync)(bin)) {
-		await (0, node_fs_promises.mkdir)((0, node_path.dirname)(bin), { recursive: true });
-		await install(bin);
-	}
-	const tunnel = Tunnel.quick(`http://localhost:${port}`);
-	let stopped = false;
-	const stop = () => {
-		if (stopped) return;
-		stopped = true;
-		try {
-			tunnel.stop();
-		} catch {}
-	};
-	return new Promise((resolve, reject) => {
-		const stderrLines = [];
-		/**
-		* Format the last `n` sanitized stderr lines as a diagnostic appendix.
-		* Returns an empty string when no lines have been collected.
-		*/
-		const stderrTail = (n = 15) => {
-			if (stderrLines.length === 0) return "";
-			const tail = stderrLines.slice(-n).map(sanitizeCloudflaredOutput).join("");
-			return `\ncloudflared 출력 (마지막 ${Math.min(n, stderrLines.length)}줄):\n${tail}`;
-		};
-		const timer = setTimeout(() => {
-			cleanup();
-			stop();
-			reject(/* @__PURE__ */ new Error(`[@apps-in-toss/devtools] cloudflared did not report a tunnel URL within ${URL_TIMEOUT_MS / 1e3}s. Check your network connection, or run \`cloudflared tunnel --url http://localhost:${port}\` manually.${stderrTail()}`));
-		}, URL_TIMEOUT_MS);
-		const onUrl = (line) => {
-			const found = parseTrycloudflareUrl(line);
-			if (!found) return;
-			clearTimeout(timer);
-			cleanup();
-			resolve({
-				url: found,
-				stop
-			});
-		};
-		const pushStderr = (line) => {
-			stderrLines.push(line);
-		};
-		const cleanup = () => {
-			tunnel.off("stdout", onUrl);
-			tunnel.off("stderr", onUrl);
-			tunnel.off("stderr", pushStderr);
-		};
-		tunnel.once("url", onUrl);
-		tunnel.on("stdout", onUrl);
-		tunnel.on("stderr", onUrl);
-		tunnel.on("stderr", pushStderr);
-		tunnel.once("error", (err) => {
-			clearTimeout(timer);
-			cleanup();
-			stop();
-			reject(err);
-		});
-		tunnel.once("exit", (code) => {
-			if (stopped) return;
-			clearTimeout(timer);
-			cleanup();
-			reject(/* @__PURE__ */ new Error(`[@apps-in-toss/devtools] cloudflared exited (code ${code ?? "null"}) before reporting a tunnel URL.${stderrTail()}`));
-		});
-	});
-}
-//#endregion
-exports.buildLauncherDeepLink = buildLauncherDeepLink;
-exports.parseTrycloudflareUrl = parseTrycloudflareUrl;
-exports.printTunnelBanner = printTunnelBanner;
-exports.sanitizeCloudflaredOutput = sanitizeCloudflaredOutput;
-exports.startQuickTunnel = startQuickTunnel;

package/dist/unplugin/tunnel.d.cts

@@ -1,140 +0,0 @@
-//#region src/unplugin/tunnel.d.ts
-/**
- * Cloudflare quick-tunnel helper for the devtools unplugin.
- *
- * Loaded lazily (`await import('./tunnel.js')`) only when the `tunnel` option is
- * on, so `cloudflared` / `qrcode-terminal` are never pulled in for the common
- * case. This is the one place in `@apps-in-toss/devtools` that depends on Node-only
- * APIs (`child_process` via the `cloudflared` wrapper) — keep it thin and out of
- * jsdom unit tests; the spawn path is verified by hand / e2e (same spirit as the
- * "web 모드는 e2e" rule in CLAUDE.md). The pure helpers below
- * (`parseTrycloudflareUrl`, `printTunnelBanner`) are unit-tested.
- */
-/**
- * Extract the `https://<sub>.trycloudflare.com` URL from a line of cloudflared
- * output, or `null` if the line doesn't contain one. Pulled out as a pure
- * function so it can be unit-tested without spawning anything.
- */
-declare function parseTrycloudflareUrl(line: string): string | null;
-interface PrintTunnelBannerOptions {
-  /** Print an ASCII QR encoding the tunnel URL (default: true). */
-  qr?: boolean;
-  /** Sink for the banner text (default: `console.log`). Injected for testing. */
-  log?: (msg: string) => void;
-  /**
-   * Human-readable app name to embed as `name=` in the launcher deep-link (#498).
-   * When provided (non-blank), the launcher partner bar shows this name instead of
-   * the generic default.
-   */
-  name?: string;
-  /**
-   * The miniapp's webViewType. When `'game'`, the deep-link carries `&navBarType=game`
-   * so the launcher enters game nav chrome automatically on scan (#584).
-   * `'partner'` (the default) is the launcher's implicit default — not added to
-   * keep the URL clean.
-   */
-  webViewType?: "partner" | "game";
-  /**
-   * Whether the miniapp's navigationBar has `transparentBackground: true`
-   * (granite.config `navigationBar.transparentBackground`, SDK 2.8.0, #587).
-   * When `true`, the deep-link carries `&navBarTransparent=1` so the launcher
-   * partner bar renders with a transparent background (content shows through).
-   * `false` / omitted → not added (URL clean, back-compat).
-   */
-  navBarTransparent?: boolean;
-  /**
-   * The miniapp's navigationBar theme (`granite.config `navigationBar.theme`,
-   * SDK 2.8.0, #587). When `'light'` or `'dark'`, the deep-link carries
-   * `&navBarTheme=<v>` so the launcher partner bar uses the matching foreground
-   * colour. Omitted / other values → not added (URL clean, back-compat).
-   */
-  navBarTheme?: "light" | "dark";
-}
-/**
- * Options for {@link buildLauncherDeepLink}.
- */
-interface BuildLauncherDeepLinkOptions {
-  /**
-   * Human-readable app name shown in the partner nav bar (`name=` param, #498).
-   * Blank / whitespace-only values are not added.
-   */
-  name?: string;
-  /**
-   * The miniapp's webViewType. When `'game'`, adds `&navBarType=game` to the
-   * deep-link so the launcher enters game nav chrome automatically on scan (#584).
-   * `'partner'` (the launcher's implicit default) is not added to keep the URL
-   * clean.
-   */
-  webViewType?: "partner" | "game";
-  /**
-   * Whether the miniapp's navigationBar has `transparentBackground: true`
-   * (granite.config `navigationBar.transparentBackground`, SDK 2.8.0, #587).
-   * When `true`, adds `&navBarTransparent=1` to the deep-link so the launcher
-   * partner bar renders with a transparent background. Omitted when `false` /
-   * undefined to keep the URL clean (back-compat).
-   */
-  navBarTransparent?: boolean;
-  /**
-   * The miniapp's navigationBar theme (granite.config `navigationBar.theme`,
-   * SDK 2.8.0, #587). When `'light'` or `'dark'`, adds `&navBarTheme=<v>` to
-   * the deep-link so the launcher partner bar uses the matching foreground colour.
-   * Omitted when undefined / other values to keep the URL clean (back-compat).
-   */
-  navBarTheme?: "light" | "dark";
-}
-/**
- * Build the deep-link URL that QR codes encode: when the launcher PWA is
- * already on the phone's home screen, scanning this opens it directly into the
- * live view for `tunnelUrl` (the launcher consumes `?url=` and clears it).
- * Plain-text raw URL is no longer enough — the launcher gates its setup UI to
- * the installed PWA, so a raw tunnel URL opened in a normal browser tab would
- * land on a "please install" screen.
- *
- * When `opts.name` is given (non-blank), it is added as `&name=` so the launcher
- * partner bar shows the app name instead of the generic default (#498).
- *
- * When `opts.webViewType` is `'game'`, `&navBarType=game` is appended so the
- * launcher enters game nav chrome (floating capsule, no full bar) automatically
- * on scan. `'partner'` is the launcher's implicit default and is not added to
- * keep the URL clean (#584).
- *
- * When `opts.navBarTransparent` is `true`, `&navBarTransparent=1` is appended
- * so the launcher partner bar renders with a transparent background (#587).
- *
- * When `opts.navBarTheme` is `'light'` or `'dark'`, `&navBarTheme=<v>` is
- * appended so the launcher partner bar uses the matching foreground colour (#587).
- */
-declare function buildLauncherDeepLink(tunnelUrl: string, optsParam?: BuildLauncherDeepLinkOptions): string;
-/**
- * Print the terminal banner announcing the live tunnel: the public URL, an ASCII
- * QR encoding a launcher deep-link, and a one-line note that quick tunnels are
- * ephemeral, unauthenticated and not for production. Pure w.r.t. side effects
- * other than the injected `log` sink and `qrcode-terminal` — unit-tested.
- */
-declare function printTunnelBanner(url: string, opts?: PrintTunnelBannerOptions): Promise<void>;
-interface QuickTunnel {
-  /** The public `https://*.trycloudflare.com` URL. */
-  url: string;
-  /** Stop the underlying `cloudflared` process. Idempotent. */
-  stop: () => void;
-}
-/**
- * Sanitize cloudflared stderr output for error diagnostics (#421).
- *
- * Masks `*.trycloudflare.com` hostnames and full `https://` / `wss://` URLs
- * that carry those hostnames so tunnel host values never appear in error
- * messages. Diagnostic content (error codes, reasons, JSON blobs) is preserved.
- *
- * SECRET-HANDLING: tunnel host is SECRET-class per harness policy — only
- * placeholder text is emitted.
- */
-declare function sanitizeCloudflaredOutput(line: string): string;
-/**
- * Start an unauthenticated Cloudflare quick tunnel to `http://localhost:<port>`
- * and resolve once the public URL is known. Downloads the `cloudflared` binary
- * on first use if it is not already installed. Rejects with a friendly error if
- * no URL appears within {@link URL_TIMEOUT_MS}.
- */
-declare function startQuickTunnel(port: number): Promise<QuickTunnel>;
-//#endregion
-export { BuildLauncherDeepLinkOptions, PrintTunnelBannerOptions, QuickTunnel, buildLauncherDeepLink, parseTrycloudflareUrl, printTunnelBanner, sanitizeCloudflaredOutput, startQuickTunnel };

package/dist/unplugin/tunnel.d.ts

@@ -1,140 +0,0 @@
-//#region src/unplugin/tunnel.d.ts
-/**
- * Cloudflare quick-tunnel helper for the devtools unplugin.
- *
- * Loaded lazily (`await import('./tunnel.js')`) only when the `tunnel` option is
- * on, so `cloudflared` / `qrcode-terminal` are never pulled in for the common
- * case. This is the one place in `@apps-in-toss/devtools` that depends on Node-only
- * APIs (`child_process` via the `cloudflared` wrapper) — keep it thin and out of
- * jsdom unit tests; the spawn path is verified by hand / e2e (same spirit as the
- * "web 모드는 e2e" rule in CLAUDE.md). The pure helpers below
- * (`parseTrycloudflareUrl`, `printTunnelBanner`) are unit-tested.
- */
-/**
- * Extract the `https://<sub>.trycloudflare.com` URL from a line of cloudflared
- * output, or `null` if the line doesn't contain one. Pulled out as a pure
- * function so it can be unit-tested without spawning anything.
- */
-declare function parseTrycloudflareUrl(line: string): string | null;
-interface PrintTunnelBannerOptions {
-  /** Print an ASCII QR encoding the tunnel URL (default: true). */
-  qr?: boolean;
-  /** Sink for the banner text (default: `console.log`). Injected for testing. */
-  log?: (msg: string) => void;
-  /**
-   * Human-readable app name to embed as `name=` in the launcher deep-link (#498).
-   * When provided (non-blank), the launcher partner bar shows this name instead of
-   * the generic default.
-   */
-  name?: string;
-  /**
-   * The miniapp's webViewType. When `'game'`, the deep-link carries `&navBarType=game`
-   * so the launcher enters game nav chrome automatically on scan (#584).
-   * `'partner'` (the default) is the launcher's implicit default — not added to
-   * keep the URL clean.
-   */
-  webViewType?: "partner" | "game";
-  /**
-   * Whether the miniapp's navigationBar has `transparentBackground: true`
-   * (granite.config `navigationBar.transparentBackground`, SDK 2.8.0, #587).
-   * When `true`, the deep-link carries `&navBarTransparent=1` so the launcher
-   * partner bar renders with a transparent background (content shows through).
-   * `false` / omitted → not added (URL clean, back-compat).
-   */
-  navBarTransparent?: boolean;
-  /**
-   * The miniapp's navigationBar theme (`granite.config `navigationBar.theme`,
-   * SDK 2.8.0, #587). When `'light'` or `'dark'`, the deep-link carries
-   * `&navBarTheme=<v>` so the launcher partner bar uses the matching foreground
-   * colour. Omitted / other values → not added (URL clean, back-compat).
-   */
-  navBarTheme?: "light" | "dark";
-}
-/**
- * Options for {@link buildLauncherDeepLink}.
- */
-interface BuildLauncherDeepLinkOptions {
-  /**
-   * Human-readable app name shown in the partner nav bar (`name=` param, #498).
-   * Blank / whitespace-only values are not added.
-   */
-  name?: string;
-  /**
-   * The miniapp's webViewType. When `'game'`, adds `&navBarType=game` to the
-   * deep-link so the launcher enters game nav chrome automatically on scan (#584).
-   * `'partner'` (the launcher's implicit default) is not added to keep the URL
-   * clean.
-   */
-  webViewType?: "partner" | "game";
-  /**
-   * Whether the miniapp's navigationBar has `transparentBackground: true`
-   * (granite.config `navigationBar.transparentBackground`, SDK 2.8.0, #587).
-   * When `true`, adds `&navBarTransparent=1` to the deep-link so the launcher
-   * partner bar renders with a transparent background. Omitted when `false` /
-   * undefined to keep the URL clean (back-compat).
-   */
-  navBarTransparent?: boolean;
-  /**
-   * The miniapp's navigationBar theme (granite.config `navigationBar.theme`,
-   * SDK 2.8.0, #587). When `'light'` or `'dark'`, adds `&navBarTheme=<v>` to
-   * the deep-link so the launcher partner bar uses the matching foreground colour.
-   * Omitted when undefined / other values to keep the URL clean (back-compat).
-   */
-  navBarTheme?: "light" | "dark";
-}
-/**
- * Build the deep-link URL that QR codes encode: when the launcher PWA is
- * already on the phone's home screen, scanning this opens it directly into the
- * live view for `tunnelUrl` (the launcher consumes `?url=` and clears it).
- * Plain-text raw URL is no longer enough — the launcher gates its setup UI to
- * the installed PWA, so a raw tunnel URL opened in a normal browser tab would
- * land on a "please install" screen.
- *
- * When `opts.name` is given (non-blank), it is added as `&name=` so the launcher
- * partner bar shows the app name instead of the generic default (#498).
- *
- * When `opts.webViewType` is `'game'`, `&navBarType=game` is appended so the
- * launcher enters game nav chrome (floating capsule, no full bar) automatically
- * on scan. `'partner'` is the launcher's implicit default and is not added to
- * keep the URL clean (#584).
- *
- * When `opts.navBarTransparent` is `true`, `&navBarTransparent=1` is appended
- * so the launcher partner bar renders with a transparent background (#587).
- *
- * When `opts.navBarTheme` is `'light'` or `'dark'`, `&navBarTheme=<v>` is
- * appended so the launcher partner bar uses the matching foreground colour (#587).
- */
-declare function buildLauncherDeepLink(tunnelUrl: string, optsParam?: BuildLauncherDeepLinkOptions): string;
-/**
- * Print the terminal banner announcing the live tunnel: the public URL, an ASCII
- * QR encoding a launcher deep-link, and a one-line note that quick tunnels are
- * ephemeral, unauthenticated and not for production. Pure w.r.t. side effects
- * other than the injected `log` sink and `qrcode-terminal` — unit-tested.
- */
-declare function printTunnelBanner(url: string, opts?: PrintTunnelBannerOptions): Promise<void>;
-interface QuickTunnel {
-  /** The public `https://*.trycloudflare.com` URL. */
-  url: string;
-  /** Stop the underlying `cloudflared` process. Idempotent. */
-  stop: () => void;
-}
-/**
- * Sanitize cloudflared stderr output for error diagnostics (#421).
- *
- * Masks `*.trycloudflare.com` hostnames and full `https://` / `wss://` URLs
- * that carry those hostnames so tunnel host values never appear in error
- * messages. Diagnostic content (error codes, reasons, JSON blobs) is preserved.
- *
- * SECRET-HANDLING: tunnel host is SECRET-class per harness policy — only
- * placeholder text is emitted.
- */
-declare function sanitizeCloudflaredOutput(line: string): string;
-/**
- * Start an unauthenticated Cloudflare quick tunnel to `http://localhost:<port>`
- * and resolve once the public URL is known. Downloads the `cloudflared` binary
- * on first use if it is not already installed. Rejects with a friendly error if
- * no URL appears within {@link URL_TIMEOUT_MS}.
- */
-declare function startQuickTunnel(port: number): Promise<QuickTunnel>;
-//#endregion
-export { BuildLauncherDeepLinkOptions, PrintTunnelBannerOptions, QuickTunnel, buildLauncherDeepLink, parseTrycloudflareUrl, printTunnelBanner, sanitizeCloudflaredOutput, startQuickTunnel };

package/dist/unplugin/tunnel.js

@@ -1,186 +0,0 @@
-import { existsSync } from "node:fs";
-import { mkdir } from "node:fs/promises";
-import { dirname } from "node:path";
-//#region src/unplugin/tunnel.ts
-/**
-* Cloudflare quick-tunnel helper for the devtools unplugin.
-*
-* Loaded lazily (`await import('./tunnel.js')`) only when the `tunnel` option is
-* on, so `cloudflared` / `qrcode-terminal` are never pulled in for the common
-* case. This is the one place in `@apps-in-toss/devtools` that depends on Node-only
-* APIs (`child_process` via the `cloudflared` wrapper) — keep it thin and out of
-* jsdom unit tests; the spawn path is verified by hand / e2e (same spirit as the
-* "web 모드는 e2e" rule in CLAUDE.md). The pure helpers below
-* (`parseTrycloudflareUrl`, `printTunnelBanner`) are unit-tested.
-*/
-/** Matches the public URL cloudflared prints for an unauthenticated quick tunnel. */
-const TRYCLOUDFLARE_RE = /https:\/\/[a-z0-9-]+\.trycloudflare\.com/i;
-/**
-* Extract the `https://<sub>.trycloudflare.com` URL from a line of cloudflared
-* output, or `null` if the line doesn't contain one. Pulled out as a pure
-* function so it can be unit-tested without spawning anything.
-*/
-function parseTrycloudflareUrl(line) {
-	const m = line.match(TRYCLOUDFLARE_RE);
-	return m ? m[0] : null;
-}
-const LAUNCHER_URL = "https://devtools.aitc.dev/launcher/";
-/**
-* Build the deep-link URL that QR codes encode: when the launcher PWA is
-* already on the phone's home screen, scanning this opens it directly into the
-* live view for `tunnelUrl` (the launcher consumes `?url=` and clears it).
-* Plain-text raw URL is no longer enough — the launcher gates its setup UI to
-* the installed PWA, so a raw tunnel URL opened in a normal browser tab would
-* land on a "please install" screen.
-*
-* When `opts.name` is given (non-blank), it is added as `&name=` so the launcher
-* partner bar shows the app name instead of the generic default (#498).
-*
-* When `opts.webViewType` is `'game'`, `&navBarType=game` is appended so the
-* launcher enters game nav chrome (floating capsule, no full bar) automatically
-* on scan. `'partner'` is the launcher's implicit default and is not added to
-* keep the URL clean (#584).
-*
-* When `opts.navBarTransparent` is `true`, `&navBarTransparent=1` is appended
-* so the launcher partner bar renders with a transparent background (#587).
-*
-* When `opts.navBarTheme` is `'light'` or `'dark'`, `&navBarTheme=<v>` is
-* appended so the launcher partner bar uses the matching foreground colour (#587).
-*/
-function buildLauncherDeepLink(tunnelUrl, optsParam) {
-	const opts = optsParam ?? {};
-	let url = `${LAUNCHER_URL}?url=${encodeURIComponent(tunnelUrl)}`;
-	if (opts.name !== void 0 && opts.name.trim() !== "") url += `&name=${encodeURIComponent(opts.name.trim())}`;
-	if (opts.webViewType === "game") url += "&navBarType=game";
-	if (opts.navBarTransparent === true) url += "&navBarTransparent=1";
-	if (opts.navBarTheme === "light" || opts.navBarTheme === "dark") url += `&navBarTheme=${opts.navBarTheme}`;
-	return url;
-}
-/**
-* Print the terminal banner announcing the live tunnel: the public URL, an ASCII
-* QR encoding a launcher deep-link, and a one-line note that quick tunnels are
-* ephemeral, unauthenticated and not for production. Pure w.r.t. side effects
-* other than the injected `log` sink and `qrcode-terminal` — unit-tested.
-*/
-async function printTunnelBanner(url, opts = {}) {
-	const log = opts.log ?? ((m) => console.log(m));
-	const deepLink = buildLauncherDeepLink(url, {
-		name: opts.name,
-		webViewType: opts.webViewType,
-		navBarTransparent: opts.navBarTransparent,
-		navBarTheme: opts.navBarTheme
-	});
-	log([
-		"",
-		"  ┌─ @apps-in-toss/devtools · live tunnel ────────────────────────────",
-		`  │  ${url}`,
-		"  │",
-		`  │  Install the launcher PWA once:  ${LAUNCHER_URL}`,
-		"  │  Then scan the QR below — it opens the launcher directly",
-		"  │  into this tunnel URL (no manual paste needed).",
-		"  │  Quick tunnels are unauthenticated, change every run, and are",
-		"  │  not for production use.",
-		"  └──────────────────────────────────────────────────────────────",
-		""
-	].join("\n"));
-	if (opts.qr !== false) {
-		const qrcode = (await import("qrcode-terminal")).default;
-		await new Promise((resolve) => {
-			qrcode.generate(deepLink, { small: true }, (out) => {
-				log(out);
-				resolve();
-			});
-		});
-	}
-}
-/**
-* Sanitize cloudflared stderr output for error diagnostics (#421).
-*
-* Masks `*.trycloudflare.com` hostnames and full `https://` / `wss://` URLs
-* that carry those hostnames so tunnel host values never appear in error
-* messages. Diagnostic content (error codes, reasons, JSON blobs) is preserved.
-*
-* SECRET-HANDLING: tunnel host is SECRET-class per harness policy — only
-* placeholder text is emitted.
-*/
-function sanitizeCloudflaredOutput(line) {
-	let s = line.replace(/(?:https?|wss?):\/\/[a-z0-9-]+\.trycloudflare\.com(?:\/[^\s]*)*/gi, (m) => m.replace(/[a-z0-9-]+\.trycloudflare\.com/i, "<HOST>.trycloudflare.com"));
-	s = s.replace(/[a-z0-9-]+\.trycloudflare\.com/gi, "<HOST>.trycloudflare.com");
-	return s;
-}
-const URL_TIMEOUT_MS = 2e4;
-/**
-* Start an unauthenticated Cloudflare quick tunnel to `http://localhost:<port>`
-* and resolve once the public URL is known. Downloads the `cloudflared` binary
-* on first use if it is not already installed. Rejects with a friendly error if
-* no URL appears within {@link URL_TIMEOUT_MS}.
-*/
-async function startQuickTunnel(port) {
-	const { bin, install, Tunnel } = await import("cloudflared");
-	if (!existsSync(bin)) {
-		await mkdir(dirname(bin), { recursive: true });
-		await install(bin);
-	}
-	const tunnel = Tunnel.quick(`http://localhost:${port}`);
-	let stopped = false;
-	const stop = () => {
-		if (stopped) return;
-		stopped = true;
-		try {
-			tunnel.stop();
-		} catch {}
-	};
-	return new Promise((resolve, reject) => {
-		const stderrLines = [];
-		/**
-		* Format the last `n` sanitized stderr lines as a diagnostic appendix.
-		* Returns an empty string when no lines have been collected.
-		*/
-		const stderrTail = (n = 15) => {
-			if (stderrLines.length === 0) return "";
-			const tail = stderrLines.slice(-n).map(sanitizeCloudflaredOutput).join("");
-			return `\ncloudflared 출력 (마지막 ${Math.min(n, stderrLines.length)}줄):\n${tail}`;
-		};
-		const timer = setTimeout(() => {
-			cleanup();
-			stop();
-			reject(/* @__PURE__ */ new Error(`[@apps-in-toss/devtools] cloudflared did not report a tunnel URL within ${URL_TIMEOUT_MS / 1e3}s. Check your network connection, or run \`cloudflared tunnel --url http://localhost:${port}\` manually.${stderrTail()}`));
-		}, URL_TIMEOUT_MS);
-		const onUrl = (line) => {
-			const found = parseTrycloudflareUrl(line);
-			if (!found) return;
-			clearTimeout(timer);
-			cleanup();
-			resolve({
-				url: found,
-				stop
-			});
-		};
-		const pushStderr = (line) => {
-			stderrLines.push(line);
-		};
-		const cleanup = () => {
-			tunnel.off("stdout", onUrl);
-			tunnel.off("stderr", onUrl);
-			tunnel.off("stderr", pushStderr);
-		};
-		tunnel.once("url", onUrl);
-		tunnel.on("stdout", onUrl);
-		tunnel.on("stderr", onUrl);
-		tunnel.on("stderr", pushStderr);
-		tunnel.once("error", (err) => {
-			clearTimeout(timer);
-			cleanup();
-			stop();
-			reject(err);
-		});
-		tunnel.once("exit", (code) => {
-			if (stopped) return;
-			clearTimeout(timer);
-			cleanup();
-			reject(/* @__PURE__ */ new Error(`[@apps-in-toss/devtools] cloudflared exited (code ${code ?? "null"}) before reporting a tunnel URL.${stderrTail()}`));
-		});
-	});
-}
-//#endregion
-export { buildLauncherDeepLink, parseTrycloudflareUrl, printTunnelBanner, sanitizeCloudflaredOutput, startQuickTunnel };