@ait-co/devtools 0.1.116 → 0.1.117

package/dist/{cli-BLBo0lkP.js → cli-CvUNQKqw.js}

@@ -1723,9 +1723,57 @@ async function renderAndMaybeWait(deps, prep, waitForAttach, callTimeoutMs, conn
 		...totpResult() ? { totp: totpResult() } : {}
 	}, null, 2)}\n\n${qr}`);
 }
+/**
+* Builds a self-contained IIFE DOM expression that renders a dismissible
+* "Debugger Connected" badge on the bottom-left of the phone screen.
+*
+* **Pure function** — returns a JS expression string; does NOT inject it.
+* Injection is performed by {@link injectDebugIndicator} in `cell.ts`.
+*
+* The expression, when evaluated on the page, does the following:
+*   1. Early-returns if `#__ait_debug_indicator` already exists (idempotent —
+*      prevents duplicate badges on re-injection after page reload).
+*   2. Appends a fixed-position `<div id="__ait_debug_indicator">` at the
+*      bottom-left, accounting for safe-area insets.
+*   3. Attaches a `{ once: true }` `pointerdown` listener that removes the
+*      badge on first touch — one-tap dismiss.
+*
+* The expression intentionally contains NO relay URLs, wss addresses, TOTP
+* codes, or any other secrets. It is pure DOM UI text only.
+*
+* SECRET-HANDLING: this expression contains no secrets, relay URLs, wss
+* addresses, or TOTP codes whatsoever — DOM label text only.
+*
+* @param opts.label - Badge text (default: `'Debugger Connected'`).
+* @returns A JS expression string suitable for `Runtime.evaluate`.
+*/
+function buildIndicatorExpression(opts) {
+	const label = opts?.label ?? "Debugger Connected";
+	return `(() => {if (document.getElementById('__ait_debug_indicator')) return;const el = document.createElement('div');el.id = '__ait_debug_indicator';el.style.cssText = ['position:fixed','left:max(12px,calc(env(safe-area-inset-left,0px) + 8px))','bottom:max(12px,calc(env(safe-area-inset-bottom,0px) + 8px))','z-index:2147483647','background:#e5484d','color:#fff','font:bold 11px/1 system-ui,sans-serif','padding:5px 9px','border-radius:6px','pointer-events:auto','user-select:none',].join(';');el.textContent = ${JSON.stringify(label)};el.addEventListener('pointerdown', () => el.remove(), { once: true });document.body.appendChild(el);})()`;
+}
 //#endregion
 //#region src/test-runner/cell.ts
 /**
+* Cell injection utility for the `devtools-test` CLI (issue #684 §4.1).
+*
+* Injects arbitrary globals into the page via `Runtime.evaluate` BEFORE the
+* first test bundle is injected. The injected values are session-global — one
+* call covers all files in the run.
+*
+* The primary use-case is injecting `__AIT_CELL__` (sdkLine/platform) so
+* sdk-example's `aitCapture.ts` picks up the correct test-axis values instead
+* of falling back to `'2.x'`/`'mock'`.
+*
+* devtools does NOT know the shape of `__AIT_CELL__` — it only provides the
+* general injection mechanism. The caller (CLI or MCP auto-attach path) is
+* responsible for constructing the cell object.
+*
+* SECRET-HANDLING: cell values (sdkLine/platform) are not secrets and may be
+* logged at the caller's discretion. This module does NOT log them itself.
+*
+* Node-only. react-free. CdpConnection only.
+*/
+/**
 * Injects each key of `globals` into `globalThis` in the page via a single
 * `Runtime.evaluate` call. Must be called BEFORE the first `bundleTestFile`
 * inject — the cell is session-global and applies to all subsequent files.
@@ -1746,6 +1794,43 @@ async function injectGlobals(conn, globals) {
 		throw new Error(`injectGlobals: Runtime.evaluate threw: ${msg}`);
 	}
 }
+/**
+* Injects the "Debugger Connected" on-phone indicator via `Runtime.evaluate`.
+*
+* Uses the same CDP mechanism as {@link injectGlobals} — a single
+* `Runtime.evaluate` round-trip with the expression built by
+* {@link buildIndicatorExpression}. The indicator is a dismissible red badge
+* rendered at the bottom-left of the page (position:fixed, safe-area-aware).
+*
+* **Isolation**: unlike {@link injectGlobals}, this function NEVER throws to
+* its caller. Injection failure (e.g. page detached during inject, CSS not
+* supported) is swallowed and logged as `console.debug` — the badge is
+* informational UI and must never block attach success or test execution.
+* This is the same fire-and-forget spirit as the eruda mount in
+* `src/in-app/attach.ts`.
+*
+* Call this ONLY on the manual debug paths (start_attach MCP, devtools-test
+* CLI). Do NOT call on the `run_tests` auto-attach path — the red badge
+* would contaminate screenshots, measure_safe_area probes, and DOM snapshots
+* taken during automated measurement runs.
+*
+* SECRET-HANDLING: the injected expression contains no secrets, relay URLs,
+* wss addresses, or TOTP codes — it is pure DOM UI text built by
+* {@link buildIndicatorExpression}.
+*
+* @param conn - The live CDP connection (relay-attached page).
+* @param opts - Optional overrides forwarded to {@link buildIndicatorExpression}.
+*/
+async function injectDebugIndicator(conn, opts) {
+	try {
+		await conn.send("Runtime.evaluate", {
+			expression: buildIndicatorExpression(opts),
+			returnByValue: true
+		});
+	} catch (err) {
+		console.debug("[@ait-co/devtools] debug indicator inject skipped:", err);
+	}
+}
 //#endregion
 //#region src/test-runner/discover.ts
 /**
@@ -2404,7 +2489,7 @@ async function main(argv = process.argv.slice(2)) {
 	process.stderr.write(`devtools-test: found ${files.length} test file(s)\n`);
 	const { loadRelaySecretReadOnly } = await import("./relay-secret-store-CmqchhR5.js");
 	await loadRelaySecretReadOnly({ projectRoot });
-	const { bootRelayFamily, buildRelayVerifyAuth } = await import("./debug-server-DcAKrbnq.js");
+	const { bootRelayFamily, buildRelayVerifyAuth } = await import("./debug-server-BvrESnaV.js");
 	let family;
 	try {
 		family = await bootRelayFamily({ verifyAuth: buildRelayVerifyAuth() });
@@ -2440,6 +2525,7 @@ async function main(argv = process.argv.slice(2)) {
 			return;
 		}
 		for (const chunk of waitResult.content) if (chunk.type === "text") process.stdout.write(`${chunk.text}\n`);
+		await injectDebugIndicator(family.connection);
 		if (hasCell) {
 			const cell = {};
 			if (cellSdkLine !== void 0) cell.sdkLine = cellSdkLine;
@@ -2463,4 +2549,4 @@ if (import.meta.url === new URL(process.argv[1], "file://").href) main().catch((
 //#endregion
 export { START_ATTACH_SEGMENT_MS as a, generateAttachToken as c, startQuickTunnel as d, startTunnelHealthProbe as f, START_ATTACH_REMINT_THRESHOLD_MS as i, makeTunnelStatus as l, logInfo as m, runWithConnection as n, extractDeploymentId as o, logError as p, RELAY_SANDBOX_STALE_PAGE_MS as r, isSandboxPageFresh as s, main as t, printAttachBanner as u };
 
-//# sourceMappingURL=cli-BLBo0lkP.js.map
+//# sourceMappingURL=cli-CvUNQKqw.js.map