use-pounce 0.1.0 → 0.2.0

package/bin/pounce.mjs

@@ -204,7 +204,7 @@ async function ensureTunnelBinary(opts) {
       }
       if (!assetUrl) return { skipped: `no ${wanted} on any tunnel-v* release yet` };
     }
-    process.stdout.write(dim(`  downloading pounce-tunnel (${triple})…\n`));
+    process.stdout.write(dim(`  downloading the remote-access component (${triple})…\n`));
     const res = await fetch(assetUrl, { signal: AbortSignal.timeout(120_000) });
     if (!res.ok) throw new Error(`download -> ${res.status}`);
     const buf = Buffer.from(await res.arrayBuffer());
@@ -300,12 +300,18 @@ async function waitForPhone(port) {
 }
 
 // --- commands -----------------------------------------------------------------
+function printPairing(pairUrl, token, tunnel) {
+  const link = deepLink({ pairUrl, token, tunnel });
+  console.log(
+    `\n  ${bold("Scan with the Pounce app")} ${dim("(Settings → Scan QR)")} ${bold("or your camera:")}\n`,
+  );
+  qrcode.generate(link, { small: true });
+  console.log(`\n  ${dim("or open on the phone:")}\n  ${dim(link)}\n`);
+}
+
 async function cmdUp(opts, { wait }) {
   console.log(`\n${bold("🐾 Pounce")} ${dim(`v${PKG.version}`)} — pair your phone\n`);
 
-  // Tunnel binary first: a bridge spawned after it exists picks it up itself.
-  const tunnelState = await ensureTunnelBinary(opts);
-
   let reused = false;
   let pid = null;
   if (await bridgeAlive(opts.port)) {
@@ -328,28 +334,45 @@ async function cmdUp(opts, { wait }) {
     `  ${dim("bridge")}  ${pairUrl}  ${dim(reused ? "(already running)" : `(started · pid ${pid} · logs: pounce logs)`)}`,
   );
 
-  let tunnel = null;
-  if (tunnelState.skipped) {
+  // ONE code, shown as fast as possible. The remote identity is stable across
+  // restarts, so on any machine that has run before /ui already carries it and
+  // the QR is remote-capable instantly. Only a machine's very first run holds
+  // the QR briefly while remote access is minted — never a second code; if
+  // remote isn't ready in time, the LAN code still upgrades the phone to
+  // remote automatically after it pairs (the app captures /v1/pair on connect).
+  let tunnel = ui.tunnel?.nodeId ? ui.tunnel : null;
+  let remoteNote = null;
+  if (!tunnel && !opts.lan) {
+    console.log(`  ${dim("Setting up remote access… (first run only — takes a few seconds)")}`);
+    const state = await ensureTunnelBinary(opts);
+    if (state.skipped) {
+      remoteNote = `${yellow("!")} Pairs over your Wi-Fi for now ${dim(`(remote access unavailable: ${state.skipped})`)}`;
+    } else {
+      tunnel = (await waitForTunnel(opts.port, token)).tunnel;
+      if (!tunnel) {
+        remoteNote = `${yellow("!")} Pairs over your Wi-Fi for now — remote access is still warming up and will switch on automatically after you pair`;
+      }
+    }
+  }
+  printPairing(pairUrl, token, tunnel);
+
+  if (opts.lan) {
     console.log(
-      `  ${dim("tunnel")}  ${yellow("off")} — ${tunnelState.skipped}; QR pairs on this Wi-Fi only`,
+      `  ${dim("Wi-Fi-only mode (--lan): scan while on the same network as this machine")}`,
     );
-  } else {
-    const r = await waitForTunnel(opts.port, token);
-    tunnel = r.tunnel;
+  } else if (tunnel) {
+    // Confirm the remote link quietly; the code on screen never changes (the
+    // identity is stable) — this only decides which status line to show.
+    const r = await waitForTunnel(opts.port, token, { timeoutMs: 12_000 });
     console.log(
-      tunnel
-        ? `  ${dim("tunnel")}  ${green("ready")} — pairs from any network ${dim(`(iroh ${tunnel.nodeId.slice(0, 8)}…)`)}`
-        : `  ${dim("tunnel")}  ${yellow("off")} — ${r.why}; QR pairs on this Wi-Fi only`,
+      r.tunnel
+        ? `  ${green("✓")} Works from anywhere — Wi-Fi at home, an encrypted tunnel everywhere else`
+        : `  ${yellow("!")} Pairs over your Wi-Fi for now — the remote link is reconnecting in the background`,
     );
+  } else if (remoteNote) {
+    console.log(`  ${remoteNote}`);
   }
 
-  const link = deepLink({ pairUrl, token, tunnel });
-  console.log(
-    `\n  ${bold("Scan with the Pounce app")} ${dim("(Settings → Scan QR)")} ${bold("or your camera:")}\n`,
-  );
-  qrcode.generate(link, { small: true });
-  console.log(`\n  ${dim("or open on the phone:")}\n  ${dim(link)}\n`);
-
   if (!wait) return;
   console.log(
     `  Waiting for your phone… ${dim("(Ctrl-C is safe — the bridge keeps running; `pounce stop` stops it)")}`,

package/dist/launcher.mjs

@@ -4725,7 +4725,7 @@ var server = http.createServer(async (req, res) => {
     return send(res, 200, {
       ...PAIR || {},
       deepLink: pairDeepLink(),
-      tunnel: tunnelInfo(),
+      tunnel: tunnelEligible() ? tunnelInfo() : null,
       token: TOKEN,
       appVersion: APP_VERSION,
       daemonOk: !!(daemon && daemon.pid),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "use-pounce",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Pair your phone with this machine in one command: npx use-pounce starts the Pounce bridge in the background and prints a QR to scan. Works over SSH — pairing rides an iroh p2p tunnel, no port-forwarding.",
   "keywords": [
     "claude-code",