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

package/dist/panel/index.js

@@ -25515,16 +25515,6 @@ const en = {
 	"viewport.status.aitNavBar": "AIT nav bar",
 	"viewport.status.aitNavBarValue": "{height}px → SafeArea top · {type}",
 	"viewport.orientation.autoSuffix": "{orient} (auto)",
-	"iap.section.products": "Product Catalog ({count})",
-	"iap.empty.products": "(no products)",
-	"iap.btn.addProduct": "+ Add Product",
-	"iap.btn.removeProduct": "Remove",
-	"iap.label.untitledProduct": "(untitled)",
-	"iap.row.sku": "SKU",
-	"iap.row.type": "Type",
-	"iap.row.displayName": "Display Name",
-	"iap.row.displayAmount": "Display Amount",
-	"iap.row.renewalCycle": "Renewal Cycle",
 	"iap.section.simulator": "IAP Simulator",
 	"iap.row.nextResult": "Next Purchase Result",
 	"iap.section.tossPay": "TossPay",
@@ -25580,7 +25570,40 @@ const en = {
 	"notifications.section.title": "requestNotificationAgreement",
 	"notifications.option.newAgreement": "newAgreement (first-time agree)",
 	"notifications.option.alreadyAgreed": "alreadyAgreed (already opted-in)",
-	"notifications.option.agreementRejected": "agreementRejected (user declined)"
+	"notifications.option.agreementRejected": "agreementRejected (user declined)",
+	"launcher.title": "AITC DevTools Launcher",
+	"launcher.description": "Scan the terminal QR code or paste the tunnel URL.",
+	"launcher.installCta": "Install launcher to your phone",
+	"launcher.urlPlaceholder": "https://example.trycloudflare.com",
+	"launcher.openBtn": "Open",
+	"launcher.scanBtn": "Scan QR with camera",
+	"launcher.noCamera": "No camera available — paste the URL instead.",
+	"launcher.cameraError": "Could not access the camera — paste the URL instead.",
+	"launcher.invalidUrlHttps": "Enter a valid https:// URL (the tunnel URL from your terminal).",
+	"launcher.invalidUrl": "Enter a valid http(s):// URL.",
+	"launcher.debugAuthFailed": "Debug connection authentication failed",
+	"launcher.debugAuthFailedHint": "The QR code may have expired. Scan a fresh QR code.",
+	"launcher.debugAuthExpiredHint": "The debug session has expired. Scan a fresh QR from the attach page on your Mac.",
+	"launcher.debugAuthRescanCta": "Scan a new QR",
+	"launcher.diagTitle": "Viewport diagnostics",
+	"launcher.diagYes": "yes",
+	"launcher.diagNo": "no",
+	"launcher.letterboxDetected": "An iOS viewport constraint may clip the bottom {pt}pt — rotating to landscape and back to portrait may resolve it.",
+	"launcher.letterboxClipped": "An iOS viewport bug makes the bottom {pt}pt unusable — rotating to landscape and back to portrait may recover it.",
+	"launcher.diagVerdictLabel": "Verdict reason",
+	"launcher.diagSafeAreaTrace": "top re-measure trace",
+	"launcher.diagVerdict.detected": "✓ letterbox correction",
+	"launcher.diagVerdict.notStandalone": "not standalone",
+	"launcher.diagVerdict.landscape": "landscape",
+	"launcher.diagVerdict.shortfallTooSmall": "shortfall too small",
+	"launcher.diagVerdict.safeAreaTopZero": "top=0 (env() stale?)",
+	"launcher.navbar.defaultTitle": "Mini App",
+	"launcher.navbar.back": "Back",
+	"launcher.navbar.menu": "Menu",
+	"launcher.navbar.close": "Close",
+	"launcher.navbar.menuRescan": "Rescan",
+	"launcher.navbar.menuDiag": "Viewport diagnostics",
+	"launcher.navbar.menuLanguage": "Language"
 };
 //#endregion
 //#region src/i18n/ko.ts
@@ -25670,16 +25693,6 @@ const ko = {
 	"viewport.status.aitNavBar": "AIT nav bar",
 	"viewport.status.aitNavBarValue": "{height}px → SafeArea top · {type}",
 	"viewport.orientation.autoSuffix": "{orient} (auto)",
-	"iap.section.products": "Product Catalog ({count})",
-	"iap.empty.products": "(등록된 상품 없음)",
-	"iap.btn.addProduct": "+ Add Product",
-	"iap.btn.removeProduct": "Remove",
-	"iap.label.untitledProduct": "(제목 없음)",
-	"iap.row.sku": "SKU",
-	"iap.row.type": "Type",
-	"iap.row.displayName": "Display Name",
-	"iap.row.displayAmount": "Display Amount",
-	"iap.row.renewalCycle": "Renewal Cycle",
 	"iap.section.simulator": "IAP Simulator",
 	"iap.row.nextResult": "Next Purchase Result",
 	"iap.section.tossPay": "TossPay",
@@ -25735,7 +25748,40 @@ const ko = {
 	"notifications.section.title": "requestNotificationAgreement",
 	"notifications.option.newAgreement": "newAgreement (최초 동의)",
 	"notifications.option.alreadyAgreed": "alreadyAgreed (이미 동의됨)",
-	"notifications.option.agreementRejected": "agreementRejected (사용자 거절)"
+	"notifications.option.agreementRejected": "agreementRejected (사용자 거절)",
+	"launcher.title": "AITC DevTools Launcher",
+	"launcher.description": "터미널 QR을 스캔하거나 URL을 입력하세요.",
+	"launcher.installCta": "폰에 런처 설치하기",
+	"launcher.urlPlaceholder": "https://example.trycloudflare.com",
+	"launcher.openBtn": "Open",
+	"launcher.scanBtn": "QR 카메라로 스캔",
+	"launcher.noCamera": "카메라를 사용할 수 없습니다 — URL을 직접 붙여넣으세요.",
+	"launcher.cameraError": "카메라에 접근할 수 없습니다 — URL을 직접 붙여넣으세요.",
+	"launcher.invalidUrlHttps": "올바른 https:// URL을 입력하세요 (터미널의 터널 URL).",
+	"launcher.invalidUrl": "올바른 http(s):// URL을 입력하세요.",
+	"launcher.debugAuthFailed": "디버그 연결 인증 실패",
+	"launcher.debugAuthFailedHint": "QR 코드가 만료되었을 수 있어요. 새 QR을 다시 스캔하세요.",
+	"launcher.debugAuthExpiredHint": "디버그 세션이 만료됐어요. Mac의 attach 페이지에서 새 QR을 스캔하세요.",
+	"launcher.debugAuthRescanCta": "새 QR 스캔하기",
+	"launcher.diagTitle": "뷰포트 진단",
+	"launcher.diagYes": "예",
+	"launcher.diagNo": "아니요",
+	"launcher.letterboxDetected": "iOS 뷰포트 제약으로 화면 아래 {pt}pt가 잘릴 수 있습니다 — 기기를 가로로 돌렸다 세로로 복귀하면 해소될 수 있어요.",
+	"launcher.letterboxClipped": "iOS 뷰포트 버그로 화면 아래 {pt}pt를 쓸 수 없습니다 — 기기를 가로로 돌렸다 세로로 돌리면 복구될 수 있어요.",
+	"launcher.diagVerdictLabel": "판정 사유",
+	"launcher.diagSafeAreaTrace": "top 재측정 추이",
+	"launcher.diagVerdict.detected": "✓ letterbox 보정",
+	"launcher.diagVerdict.notStandalone": "홈 화면 앱 아님",
+	"launcher.diagVerdict.landscape": "가로 모드",
+	"launcher.diagVerdict.shortfallTooSmall": "높이 차이 미달",
+	"launcher.diagVerdict.safeAreaTopZero": "top=0 (env() stale?)",
+	"launcher.navbar.defaultTitle": "미니앱",
+	"launcher.navbar.back": "뒤로가기",
+	"launcher.navbar.menu": "메뉴",
+	"launcher.navbar.close": "닫기",
+	"launcher.navbar.menuRescan": "다시 스캔",
+	"launcher.navbar.menuDiag": "뷰포트 진단",
+	"launcher.navbar.menuLanguage": "언어"
 };
 //#endregion
 //#region src/i18n/index.ts
@@ -25830,7 +25876,7 @@ function t(key, vars) {
 *
 * This adds NO second i18n system — it is a thin `useSyncExternalStore` wrapper
 * over the existing `getLocale()` / `setLocale()` / `LOCALE_CHANGE_EVENT` so that
-* React surfaces (panel, fixture) re-render their subtree when the
+* React surfaces (panel, fixture, launcher) re-render their subtree when the
 * locale changes, instead of the vanilla panel's old `disposePanel()` → `mount()`
 * full-remount dance.
 *
@@ -25871,33 +25917,6 @@ function useT() {
 	return t;
 }
 //#endregion
-//#region src/mock/deep-merge.ts
-function isPlainObject(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function mergeValue(base, override) {
-	if (override === void 0) return base;
-	if (Array.isArray(override)) return override;
-	if (isPlainObject(base) && isPlainObject(override)) {
-		const result = { ...base };
-		for (const key of Object.keys(override)) {
-			if (!(key in base)) continue;
-			result[key] = mergeValue(base[key], override[key]);
-		}
-		return result;
-	}
-	return override;
-}
-/**
-* `base`(보통 `DEFAULT_STATE`)에 `override`를 재귀 병합한 새 객체를
-* 반환한다. `base`는 변형하지 않는다(불변). `override`가 `undefined`이면
-* `base`를 그대로 반환한다.
-*/
-function deepMergeState(base, override) {
-	if (override === void 0) return base;
-	return mergeValue(base, override);
-}
-//#endregion
 //#region src/mock/throttle-registry.ts
 /**
 * throttle 레지스트리 (devtools#834).
@@ -25927,10 +25946,6 @@ function resetThrottleRegistry() {
 }
 //#endregion
 //#region src/mock/state.ts
-/**
-* @apps-in-toss/devtools 중앙 상태 관리
-* DevTools Panel과 mock 구현체가 이 상태를 공유한다.
-*/
 /** SDK 호출 로그 ring buffer 상한 */
 const SDK_CALL_LOG_MAX = 200;
 const DEFAULT_STATE = {
@@ -25990,14 +26005,6 @@ const DEFAULT_STATE = {
 			displayAmount: "1,000원",
 			iconUrl: "",
 			description: "게임에서 사용할 수 있는 보석 100개"
-		}, {
-			sku: "mock-sub-monthly",
-			type: "SUBSCRIPTION",
-			displayName: "월간 구독",
-			displayAmount: "4,900원",
-			iconUrl: "",
-			description: "매달 자동으로 갱신되는 구독 상품",
-			renewalCycle: "MONTHLY"
 		}],
 		nextResult: "success",
 		pendingOrders: [],
@@ -26060,22 +26067,6 @@ const DEFAULT_STATE = {
 	},
 	failureModes: { sdkLine: "2.x" }
 };
-/**
-* `initialState` unplugin 옵션(Vite `define`로 주입된 `__AIT_INITIAL_STATE__`)이
-* 있으면 `DEFAULT_STATE`에 재귀 병합한 결과를, 없으면 `DEFAULT_STATE`를 그대로
-* 반환한다. devtools 자체 빌드/테스트에는 이 define이 없으므로
-* `typeof` 가드로 ReferenceError를 막는다(env.d.ts 참고).
-*
-* 모듈 로드 시 한 번만 계산해 생성자·`reset()` 양쪽에서 재사용한다 — `reset()`도
-* 이 병합된 값으로 되돌아가야, 소비자가 선언한 커스텀 카탈로그가 패널의
-* "초기화" 이후에도 사라지지 않는다(초기화는 "SDK 기본값"이 아니라 "이
-* 프로젝트가 선언한 기본값"으로 돌아가는 것이 사용자 기대에 맞다).
-*/
-function resolveDefaultState() {
-	const override = typeof __AIT_INITIAL_STATE__ !== "undefined" ? __AIT_INITIAL_STATE__ : void 0;
-	return override ? deepMergeState(DEFAULT_STATE, override) : DEFAULT_STATE;
-}
-const RESOLVED_DEFAULT_STATE = resolveDefaultState();
 function generateDeviceId() {
 	const stored = localStorage.getItem("__ait_device_id");
 	if (stored) return stored;
@@ -26088,7 +26079,7 @@ var AitStateManager = class {
 	_listeners = /* @__PURE__ */ new Set();
 	_inTransaction = false;
 	constructor() {
-		this._state = structuredClone(RESOLVED_DEFAULT_STATE);
+		this._state = structuredClone(DEFAULT_STATE);
 		try {
 			this._state.deviceId = generateDeviceId();
 		} catch {
@@ -26184,7 +26175,7 @@ var AitStateManager = class {
 	reset() {
 		const deviceId = this._state.deviceId;
 		this._state = {
-			...structuredClone(RESOLVED_DEFAULT_STATE),
+			...structuredClone(DEFAULT_STATE),
 			deviceId
 		};
 		resetThrottleRegistry();
@@ -27848,6 +27839,39 @@ const showFullScreenAd = withIsSupported(observe("showFullScreenAd", "faithful",
 	setTimeout(() => args.onEvent({ type: "dismissed" }), 1500);
 	return () => {};
 }));
+createMockProxy("Ads", {
+	showTossAdOrShoppingAds: withIsSupported(observe("Ads.showTossAdOrShoppingAds", "faithful", (args) => {
+		if (!aitState.state.ads.isLoaded) {
+			args.onError(/* @__PURE__ */ new Error("Ad not loaded"));
+			return () => {};
+		}
+		const { rewardUnitType, rewardAmount } = aitState.state.ads;
+		setTimeout(() => args.onEvent({
+			type: "userEarnedReward",
+			data: {
+				unitType: rewardUnitType,
+				unitAmount: rewardAmount
+			}
+		}), 1e3);
+		setTimeout(() => {
+			args.onEvent({ type: "dismissed" });
+			aitState.patch("ads", { isLoaded: false });
+		}, 1500);
+		return () => {};
+	})),
+	showTossShoppingAds: withIsSupported(observe("Ads.showTossShoppingAds", "faithful", (args) => {
+		const { rewardUnitType, rewardAmount } = aitState.state.ads;
+		setTimeout(() => args.onEvent({
+			type: "userEarnedReward",
+			data: {
+				unitType: rewardUnitType,
+				unitAmount: rewardAmount
+			}
+		}), 1e3);
+		setTimeout(() => args.onEvent({ type: "dismissed" }), 1500);
+		return () => {};
+	}))
+});
 //#endregion
 //#region src/panel/tabs/ads.ts
 function recordEvent(type) {
@@ -28219,55 +28243,6 @@ Object.assign(async function requestTossPayPaysBilling(options) {
 }, { isSupported: () => true });
 //#endregion
 //#region src/panel/tabs/iap.ts
-const PRODUCT_TYPES = [
-	"CONSUMABLE",
-	"NON_CONSUMABLE",
-	"SUBSCRIPTION"
-];
-const RENEWAL_CYCLES = [
-	"WEEKLY",
-	"MONTHLY",
-	"YEARLY"
-];
-function newDefaultProduct() {
-	return {
-		sku: `mock-product-${Date.now()}`,
-		type: "CONSUMABLE",
-		displayName: "새 상품",
-		displayAmount: "0원",
-		iconUrl: "",
-		description: ""
-	};
-}
-/**
-* products[idx]를 partial 병합해 `aitState.patch('iap', { products })`로
-* 반영한다. `aitState.state`를 매번 다시 읽어(호출 시점 최신 스냅샷)
-* 여러 필드를 연속으로 고칠 때도 이전 입력이 유실되지 않게 한다.
-*/
-function updateProduct(index, partial) {
-	const next = [...aitState.state.iap.products];
-	const current = next[index];
-	if (!current) return;
-	next[index] = {
-		...current,
-		...partial
-	};
-	aitState.patch("iap", { products: next });
-}
-function removeProduct(index) {
-	const next = [...aitState.state.iap.products];
-	next.splice(index, 1);
-	aitState.patch("iap", { products: next });
-}
-function renderProductCard(product, index, disabled) {
-	const card = h("div", { className: "ait-product-card" });
-	const removeBtn = h("button", { className: "ait-btn ait-btn-sm ait-btn-danger" }, t("iap.btn.removeProduct"));
-	if (disabled) removeBtn.disabled = true;
-	removeBtn.addEventListener("click", () => removeProduct(index));
-	card.append(h("div", { className: "ait-row" }, h("strong", {}, product.sku || t("iap.label.untitledProduct")), removeBtn), inputRow(t("iap.row.sku"), product.sku, (v) => updateProduct(index, { sku: v }), disabled), selectRow(t("iap.row.type"), PRODUCT_TYPES, product.type, (v) => updateProduct(index, { type: v }), disabled), inputRow(t("iap.row.displayName"), product.displayName, (v) => updateProduct(index, { displayName: v }), disabled), inputRow(t("iap.row.displayAmount"), product.displayAmount, (v) => updateProduct(index, { displayAmount: v }), disabled));
-	if (product.type === "SUBSCRIPTION") card.appendChild(selectRow(t("iap.row.renewalCycle"), RENEWAL_CYCLES, product.renewalCycle ?? "MONTHLY", (v) => updateProduct(index, { renewalCycle: v }), disabled));
-	return card;
-}
 function formatTimestamp(iso) {
 	const d = new Date(iso);
 	if (Number.isNaN(d.getTime())) return iso;
@@ -28290,18 +28265,6 @@ function renderIapTab() {
 		"INTERNAL_ERROR"
 	];
 	if (disabled) container.appendChild(monitoringNotice());
-	const products = s.iap.products;
-	const productsSection = h("div", { className: "ait-section" }, h("div", { className: "ait-section-title" }, t("iap.section.products", { count: products.length })));
-	if (products.length === 0) productsSection.appendChild(h("div", { className: "ait-log-entry" }, t("iap.empty.products")));
-	else products.forEach((product, index) => {
-		productsSection.appendChild(renderProductCard(product, index, disabled));
-	});
-	const addProductBtn = h("button", { className: "ait-btn-secondary" }, t("iap.btn.addProduct"));
-	if (disabled) addProductBtn.disabled = true;
-	addProductBtn.addEventListener("click", () => {
-		aitState.patch("iap", { products: [...aitState.state.iap.products, newDefaultProduct()] });
-	});
-	productsSection.appendChild(h("div", { className: "ait-btn-row" }, addProductBtn));
 	const pendingOrders = s.iap.pendingOrders;
 	const pendingSection = h("div", { className: "ait-section" }, h("div", { className: "ait-section-title" }, t("iap.section.pending", { count: pendingOrders.length })));
 	if (pendingOrders.length === 0) pendingSection.appendChild(h("div", { className: "ait-log-entry" }, t("iap.empty.pending")));
@@ -28317,7 +28280,7 @@ function renderIapTab() {
 	const completedSection = h("div", { className: "ait-section" }, h("div", { className: "ait-section-title" }, t("iap.section.completed", { count: completedOrders.length })));
 	if (completedOrders.length === 0) completedSection.appendChild(h("div", { className: "ait-log-entry" }, t("iap.empty.completed")));
 	else for (const o of completedOrders) completedSection.appendChild(h("div", { className: "ait-log-entry" }, h("span", { className: "ait-log-type" }, o.status), `${o.sku} (${shortOrderId(o.orderId)}) · ${formatTimestamp(o.date)}`));
-	container.append(productsSection, h("div", { className: "ait-section" }, h("div", { className: "ait-section-title" }, t("iap.section.simulator")), selectRow(t("iap.row.nextResult"), results, s.iap.nextResult, (v) => {
+	container.append(h("div", { className: "ait-section" }, h("div", { className: "ait-section-title" }, t("iap.section.simulator")), selectRow(t("iap.row.nextResult"), results, s.iap.nextResult, (v) => {
 		aitState.patch("iap", { nextResult: v });
 	}, disabled)), h("div", { className: "ait-section" }, h("div", { className: "ait-section-title" }, t("iap.section.tossPay")), selectRow(t("iap.row.tossPayResult"), ["success", "fail"], s.payment.nextResult, (v) => {
 		aitState.patch("payment", { nextResult: v });
@@ -29137,17 +29100,6 @@ const PANEL_STYLES = `
     background: #3a3a5a;
   }
 
-  /* IAP 상품 카탈로그 편집 카드 (한 상품 = 카드 1개) */
-  .ait-product-card {
-    border: 1px solid #3a3a5a;
-    border-radius: 6px;
-    padding: 8px;
-    margin-bottom: 8px;
-  }
-  .ait-product-card .ait-row:last-child {
-    margin-bottom: 0;
-  }
-
   /* Prompt notification */
   .ait-prompt-banner {
     background: #2d1b69;
@@ -30601,7 +30553,7 @@ function Panel() {
 								color: "#666",
 								fontWeight: 400
 							},
-							children: ["v", "3.0.5"]
+							children: ["v", "3.1.0-beta.1"]
 						}),
 						/* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", {
 							type: "button",

package/dist/tunnel-BvEf1qGV.js

@@ -0,0 +1,186 @@
+import { existsSync } from "node:fs";
+import { dirname } from "node:path";
+import { mkdir } from "node:fs/promises";
+//#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 { printTunnelBanner, startQuickTunnel };