tapflow 0.0.1 → 0.1.0-alpha.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tapflow contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,186 @@
+<div align="center">
+  <img src="docs/public/logo-hero.svg" height="72" alt="tapflow" />
+
+  <h3>Self-hosted iOS & Android simulator streaming for QA teams</h3>
+
+  <p>
+    Run simulators in the browser — no Appetize, no BrowserStack, no monthly fees.<br />
+    App data never leaves your network.
+  </p>
+
+  <p>
+    <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="MIT License" /></a>
+    <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen" alt="Node.js ≥ 20" /></a>
+    <img src="https://img.shields.io/badge/platform-macOS-lightgrey" alt="macOS Agent" />
+    <a href="https://github.com/jo-duchan/tapflow/blob/main/CONTRIBUTING.md"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs welcome" /></a>
+  </p>
+</div>
+
+---
+
+## Demo
+
+<div align="center">
+  <a href="https://github.com/user-attachments/assets/01914ed2-f35c-4230-ae01-166ffe6af395" target="_blank" rel="noopener noreferrer">
+    <img src="https://raw.githubusercontent.com/jo-duchan/tapflow/main/docs/public/demo-thumbnail.png" alt="tapflow demo — click to play" width="100%" />
+  </a>
+  <p><em>Click to play</em></p>
+</div>
+
+---
+
+## Why tapflow?
+
+| Solution | Problem |
+|----------|---------|
+| Appetize / BrowserStack | Expensive — app data leaves your network |
+| Physical devices | Cost, loss, management overhead |
+| Xcode / Android Studio | Every QA member needs their own Mac + full toolchain setup |
+| **tapflow** | Use the Mac you already own — data stays on-prem, QA team uses a browser |
+
+## Features
+
+- **Browser-based** — QA team needs no installation. Any modern browser works.
+- **iOS Simulator** — JPEG frame streaming at ~30 fps via SimulatorKit IOSurface. No WebDriverAgent required.
+- **Android Emulator** — H.264 streaming via [scrcpy](https://github.com/Genymobile/scrcpy) at ~30 fps.
+- **Touch, swipe & pinch** — real-time input forwarded to the simulator.
+- **App Center** — upload `.app.zip` (iOS) or `.apk` (Android), manage builds by status (Backlog / In Progress / Done / Rejected).
+- **Session Recordings** — record QA sessions, share with your team. Retained for 72 hours.
+- **Mac Resources** — CPU & RAM monitoring per agent. Spot overloaded hosts before assigning sessions.
+- **Team management** — invite links, roles (Admin / Developer / QA / Viewer), Personal Access Tokens for CI/CD.
+- **Self-hosted** — deploy anywhere. No cloud dependency.
+
+## How it works
+
+```
+Browser (QA team)  ←─ WebSocket ─→  Relay Server  ←─ WebSocket (outbound) ─→  Mac Agent
+                                  (Linux / Mac)                           (iOS · Android)
+```
+
+1. The **Mac Agent** connects *outbound* to the relay — no inbound firewall rules needed.
+2. QA opens the **dashboard** in any browser and sees all available devices.
+3. Touch events are forwarded in real time; the screen streams back to the browser.
+4. The **relay** also serves the dashboard SPA on the same port — no separate web server needed.
+
+## Quick Start
+
+### 1. Install
+
+```sh
+npm install -g tapflow
+# or: yarn global add tapflow  |  pnpm add -g tapflow
+```
+
+### 2. Start relay + agent
+
+```sh
+tapflow start
+# ✓ Relay started on http://localhost:4000
+# ✓ iOS Agent connected (3 simulators available)
+```
+
+This starts both the relay and the agent on the same Mac (local mode).
+
+### 3. Create the first admin account
+
+```sh
+tapflow init
+# ? Admin email: admin@yourteam.com
+# ? Password: ********
+# ✓ Admin account created
+```
+
+### 4. Open the dashboard
+
+Navigate to `http://localhost:4000` and sign in with the account you just created.
+
+> **Having issues?** Run `tapflow doctor` to auto-diagnose Node.js, Xcode, `adb`, and other prerequisites.
+
+## Requirements
+
+| Component | Requirements |
+|-----------|-------------|
+| **Relay server** | Node.js ≥ 20, any OS (Linux/macOS), ~512 MB RAM |
+| **iOS Agent** | macOS, Xcode with iOS Simulator Runtime, Node.js ≥ 20 |
+| **Android Agent** | macOS, Android SDK (`adb` in `$PATH` or `$ANDROID_HOME` set), AVD with `google_apis/arm64-v8a` (android-34), Node.js ≥ 20 |
+| **Browser (QA)** | Any modern browser — Chrome, Firefox, Safari, Edge |
+
+## Self-Hosting
+
+### Local (single Mac)
+
+Relay and agent on the same machine — ideal for a single developer or small team.
+
+```sh
+tapflow start
+```
+
+### Team (separate relay server)
+
+Run the relay on a Linux server or dedicated Mac. Each Mac with simulators runs the agent.
+
+**Relay server:**
+
+```sh
+# Recommended: PM2 for automatic restarts
+npm install -g pm2 tapflow
+JWT_SECRET=$(openssl rand -hex 32) pm2 start tapflow --name relay -- relay start
+pm2 save && pm2 startup
+```
+
+**Each Mac agent:**
+
+```sh
+tapflow agent start --relay wss://your-relay-url
+```
+
+> For nginx / Caddy reverse proxy setup and external access, see [Self-Hosting the Relay](https://jo-duchan.github.io/tapflow/guide/self-hosting).
+
+## CLI Reference
+
+| Command | Description |
+|---------|-------------|
+| `tapflow start` | Start relay + agent together (local mode) |
+| `tapflow relay start` | Start relay only |
+| `tapflow agent start --relay <url>` | Start agent and connect to a relay |
+| `tapflow init` | Create the first admin account |
+| `tapflow doctor` | Diagnose environment (Node, Xcode, adb…) |
+| `tapflow devices` | List available simulators and emulators |
+| `tapflow boot <name\|udid>` | Boot a simulator or emulator |
+| `tapflow status` | Show connected agents, devices, active sessions |
+| `tapflow reset` | Shut down all simulators and emulators |
+| `tapflow logs` | Show recent relay log entries |
+
+Full reference → [CLI docs](https://jo-duchan.github.io/tapflow/reference/cli)
+
+## Documentation
+
+**[jo-duchan.github.io/tapflow](https://jo-duchan.github.io/tapflow)**
+
+- [Introduction](https://jo-duchan.github.io/tapflow/guide/introduction)
+- [Quick Start](https://jo-duchan.github.io/tapflow/guide/getting-started)
+- [Self-Hosting the Relay](https://jo-duchan.github.io/tapflow/guide/self-hosting)
+- [iOS Agent Setup](https://jo-duchan.github.io/tapflow/guide/ios-agent)
+- [Android Agent Setup](https://jo-duchan.github.io/tapflow/guide/android-agent)
+- [Uploading Builds (CI/CD)](https://jo-duchan.github.io/tapflow/guide/upload-builds)
+- [CLI Reference](https://jo-duchan.github.io/tapflow/reference/cli)
+- [Troubleshooting](https://jo-duchan.github.io/tapflow/guide/troubleshooting)
+
+## Development
+
+**Requirements**: Node.js ≥ 20, pnpm ≥ 9
+
+```sh
+git clone https://github.com/jo-duchan/tapflow.git
+cd tapflow
+pnpm install
+pnpm dev
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for branch strategy, commit conventions, and architecture overview.
+
+## License
+
+[MIT](LICENSE) — Copyright © 2025-present tapflow contributors
+
+> tapflow bundles [scrcpy-server](https://github.com/Genymobile/scrcpy) (Apache-2.0) for Android screen streaming. See [NOTICE](NOTICE) for full attribution.

package/bin/tapflow.js

@@ -1 +1,2 @@
-console.log('Tapflow is coming soon.');
+#!/usr/bin/env node
+import '../dist/index.js'

package/dist/commands/agent-start.d.ts

@@ -0,0 +1,7 @@
+export interface AgentStartOptions {
+    device?: string;
+    relay?: string;
+    platform?: 'ios' | 'android' | 'all';
+}
+export declare function cmdAgentStart(opts: AgentStartOptions): Promise<void>;
+//# sourceMappingURL=agent-start.d.ts.map

package/dist/commands/agent-start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-start.d.ts","sourceRoot":"","sources":["../../src/commands/agent-start.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,KAAK,CAAA;CACrC;AAUD,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqE1E"}

package/dist/commands/agent-start.js

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+import { AndroidAgent } from '@tapflowio/android-agent';
+import { banner, createSpinner } from '../lib/print.js';
+import { hasAdb } from '../lib/platform.js';
+import { resolveAndBootIOSDevice } from '../lib/ios-boot.js';
+const DEFAULT_RELAY = 'ws://localhost:4000';
+const relayUrlSchema = z
+    .string()
+    .refine((v) => v.startsWith('ws://') || v.startsWith('wss://'), {
+    message: '--relay must start with ws:// or wss://',
+});
+export async function cmdAgentStart(opts) {
+    const isMac = process.platform === 'darwin';
+    const rawRelay = opts.relay ?? DEFAULT_RELAY;
+    const relayResult = relayUrlSchema.safeParse(rawRelay);
+    if (!relayResult.success) {
+        banner('error', 'INVALID CONFIG', [relayResult.error.issues[0].message]);
+        process.exit(1);
+    }
+    const relayUrl = relayResult.data;
+    const explicit = opts.platform;
+    const runIOS = explicit === 'ios' || explicit === 'all' || (!explicit && isMac);
+    const runAndroid = explicit === 'android' || explicit === 'all' || (!explicit && hasAdb());
+    if (!runIOS && !runAndroid) {
+        banner('error', 'NO PLATFORM AVAILABLE', [
+            'No iOS simulator or Android adb found.',
+            'Run `tapflow doctor` to diagnose.',
+        ]);
+        process.exit(1);
+    }
+    const agents = [];
+    // ── iOS Agent ─────────────────────────────────────────────────────────────
+    if (runIOS) {
+        const iosAgent = await resolveAndBootIOSDevice(opts.device);
+        const iosSpinner = createSpinner('Connecting iOS agent…');
+        iosSpinner.start();
+        try {
+            await iosAgent.connect(relayUrl);
+            iosSpinner.stop(true);
+            agents.push(iosAgent);
+        }
+        catch (e) {
+            iosSpinner.stop(false);
+            banner('error', 'IOS CONNECTION FAILED', [e.message]);
+            process.exit(1);
+        }
+    }
+    // ── Android Agent ─────────────────────────────────────────────────────────
+    if (runAndroid) {
+        const androidAgent = new AndroidAgent({ deviceFilter: opts.device });
+        const androidSpinner = createSpinner('Connecting Android agent…');
+        androidSpinner.start();
+        try {
+            await androidAgent.connect(relayUrl);
+            androidSpinner.stop(true);
+            agents.push(androidAgent);
+        }
+        catch (e) {
+            androidSpinner.stop(false);
+            if (runIOS && agents.length > 0) {
+                console.log(`  ⚠  Android: ${e.message}`);
+            }
+            else {
+                banner('error', 'ANDROID CONNECTION FAILED', [e.message]);
+                process.exit(1);
+            }
+        }
+    }
+    banner('success', 'TAPFLOW AGENT READY', [
+        `Relay  : ${relayUrl}`,
+        'Press Ctrl+C to stop.',
+    ]);
+    process.on('SIGINT', () => {
+        agents.forEach((a) => a.disconnect());
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=agent-start.js.map

package/dist/commands/agent-start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-start.js","sourceRoot":"","sources":["../../src/commands/agent-start.ts"],"names":[],"mappings":"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"}

package/dist/commands/boot.d.ts

@@ -0,0 +1,2 @@
+export declare function cmdBoot(nameOrUdid: string): Promise<void>;
+//# sourceMappingURL=boot.d.ts.map

package/dist/commands/boot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../../src/commands/boot.ts"],"names":[],"mappings":"AAGA,wBAAsB,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+C/D"}

package/dist/commands/boot.js

@@ -0,0 +1,47 @@
+import { execSync, spawn } from 'node:child_process';
+import { banner, createSpinner, step } from '../lib/print.js';
+export async function cmdBoot(nameOrUdid) {
+    // iOS 먼저 탐색
+    if (process.platform === 'darwin') {
+        try {
+            const raw = execSync('xcrun simctl list devices --json', { encoding: 'utf8', stdio: 'pipe' });
+            const data = JSON.parse(raw);
+            const target = Object.values(data.devices).flat().find((d) => d.udid === nameOrUdid || d.name === nameOrUdid);
+            if (target) {
+                if (target.state === 'Booted') {
+                    step(`${target.name} is already booted.`);
+                    return;
+                }
+                const spinner = createSpinner(`Booting iOS Simulator: ${target.name}…`);
+                spinner.start();
+                execSync(`xcrun simctl boot ${target.udid}`, { stdio: 'pipe' });
+                spinner.stop(true);
+                step(`${target.name} booted.`);
+                return;
+            }
+        }
+        catch { /* xcrun unavailable */ }
+    }
+    // Android AVD 탐색
+    try {
+        execSync('which emulator', { stdio: 'pipe' });
+        const avdList = execSync('emulator -list-avds', { encoding: 'utf8', stdio: 'pipe' })
+            .trim().split('\n').map((l) => l.trim()).filter(Boolean);
+        const target = avdList.find((avd) => avd === nameOrUdid);
+        if (target) {
+            // emulator는 실행 후 종료되지 않으므로 detached로 백그라운드 기동
+            const child = spawn('emulator', [`@${target}`], { detached: true, stdio: 'ignore' });
+            child.unref();
+            step(`Android AVD: ${target} is starting in the background.`);
+            step('Run `tapflow devices` to check boot status.');
+            return;
+        }
+    }
+    catch { /* emulator unavailable */ }
+    banner('error', 'DEVICE NOT FOUND', [
+        `"${nameOrUdid}" does not match any simulator or AVD.`,
+        'Run `tapflow devices` to see available devices.',
+    ]);
+    process.exit(1);
+}
+//# sourceMappingURL=boot.js.map

package/dist/commands/boot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot.js","sourceRoot":"","sources":["../../src/commands/boot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAE7D,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,UAAkB;IAC9C,YAAY;IACZ,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,QAAQ,CAAC,kCAAkC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;YAC7F,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAE1B,CAAA;YACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CACpD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,CACtD,CAAA;YACD,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;oBAC9B,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,qBAAqB,CAAC,CAAA;oBACzC,OAAM;gBACR,CAAC;gBACD,MAAM,OAAO,GAAG,aAAa,CAAC,0BAA0B,MAAM,CAAC,IAAI,GAAG,CAAC,CAAA;gBACvE,OAAO,CAAC,KAAK,EAAE,CAAA;gBACf,QAAQ,CAAC,qBAAqB,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;gBAC/D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBAClB,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,UAAU,CAAC,CAAA;gBAC9B,OAAM;YACR,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,uBAAuB,CAAC,CAAC;IACrC,CAAC;IAED,iBAAiB;IACjB,IAAI,CAAC;QACH,QAAQ,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;QAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,qBAAqB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;aACjF,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,UAAU,CAAC,CAAA;QACxD,IAAI,MAAM,EAAE,CAAC;YACX,8CAA8C;YAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;YACpF,KAAK,CAAC,KAAK,EAAE,CAAA;YACb,IAAI,CAAC,gBAAgB,MAAM,iCAAiC,CAAC,CAAA;YAC7D,IAAI,CAAC,6CAA6C,CAAC,CAAA;YACnD,OAAM;QACR,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,0BAA0B,CAAC,CAAC;IAEtC,MAAM,CAAC,OAAO,EAAE,kBAAkB,EAAE;QAClC,IAAI,UAAU,wCAAwC;QACtD,iDAAiD;KAClD,CAAC,CAAA;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC"}

package/dist/commands/devices.d.ts

@@ -0,0 +1,2 @@
+export declare function cmdDevices(): void;
+//# sourceMappingURL=devices.d.ts.map

package/dist/commands/devices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devices.d.ts","sourceRoot":"","sources":["../../src/commands/devices.ts"],"names":[],"mappings":"AASA,wBAAgB,UAAU,IAAI,IAAI,CA+EjC"}

package/dist/commands/devices.js

@@ -0,0 +1,85 @@
+import { execSync } from 'node:child_process';
+import { banner } from '../lib/print.js';
+export function cmdDevices() {
+    const sections = [];
+    // ── iOS ───────────────────────────────────────────────────────────────────
+    try {
+        const raw = execSync('xcrun simctl list devices --json', { encoding: 'utf8', stdio: 'pipe' });
+        const data = JSON.parse(raw);
+        const all = Object.values(data.devices).flat().filter((d) => d.udid);
+        const booted = all.filter((d) => d.state === 'Booted');
+        const available = all.filter((d) => d.state === 'Shutdown');
+        const lines = [];
+        if (booted.length > 0) {
+            lines.push('  Booted:');
+            for (const d of booted)
+                lines.push(`    ● ${d.name}  ${d.udid}`);
+        }
+        if (available.length > 0) {
+            lines.push('  Available:');
+            for (const d of available.slice(0, 20))
+                lines.push(`    ○ ${d.name}  ${d.udid}`);
+            if (available.length > 20)
+                lines.push(`    … and ${available.length - 20} more`);
+        }
+        if (lines.length > 0)
+            sections.push('iOS Simulators:\n' + lines.join('\n'));
+    }
+    catch {
+        // xcrun not available — skip iOS section
+    }
+    // ── Android ───────────────────────────────────────────────────────────────
+    try {
+        execSync('which adb', { stdio: 'pipe' });
+        const runningLines = [];
+        try {
+            const adbOut = execSync('adb devices', { encoding: 'utf8', stdio: 'pipe' });
+            const running = adbOut.trim().split('\n').slice(1).filter((l) => l.startsWith('emulator-'));
+            for (const line of running) {
+                const serial = line.split('\t')[0]?.trim() ?? '';
+                try {
+                    const name = execSync(`adb -s ${serial} emu avd name`, { encoding: 'utf8', stdio: 'pipe' })
+                        .split('\n')[0]?.trim() ?? serial;
+                    runningLines.push(`    ● ${name}  ${serial}`);
+                }
+                catch {
+                    runningLines.push(`    ● ${serial}`);
+                }
+            }
+        }
+        catch { /* adb devices failed */ }
+        const availableLines = [];
+        try {
+            const avdOut = execSync('emulator -list-avds', { encoding: 'utf8', stdio: 'pipe' }).trim();
+            const allAvds = avdOut ? avdOut.split('\n').map((l) => l.trim()).filter(Boolean) : [];
+            const runningNames = runningLines.map((l) => l.split('  ')[0]?.replace('    ● ', '') ?? '');
+            for (const avd of allAvds) {
+                if (!runningNames.includes(avd))
+                    availableLines.push(`    ○ ${avd}`);
+            }
+        }
+        catch { /* emulator not in PATH */ }
+        const lines = [];
+        if (runningLines.length > 0) {
+            lines.push('  Running:');
+            lines.push(...runningLines);
+        }
+        if (availableLines.length > 0) {
+            lines.push('  Available:');
+            lines.push(...availableLines);
+        }
+        if (lines.length > 0)
+            sections.push('Android AVDs:\n' + lines.join('\n'));
+    }
+    catch {
+        // adb not in PATH — skip Android section
+    }
+    if (sections.length === 0) {
+        banner('error', 'NO DEVICES FOUND', ['Run `tapflow doctor` to diagnose your environment.']);
+        return;
+    }
+    console.log();
+    console.log(sections.join('\n\n'));
+    console.log();
+}
+//# sourceMappingURL=devices.js.map

package/dist/commands/devices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devices.js","sourceRoot":"","sources":["../../src/commands/devices.ts"],"names":[],"mappings":"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"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,2 @@
+export declare function cmdDoctor(): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAiBA,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAyB/C"}

package/dist/commands/doctor.js

@@ -0,0 +1,41 @@
+import { runDoctorChecks } from '../lib/doctor.js';
+import { banner, step, GREEN, RED, BOLD, DIM, R } from '../lib/print.js';
+function printChecks(checks) {
+    let hasFailure = false;
+    for (const check of checks) {
+        if (check.ok) {
+            console.log(`  ${GREEN}✓${R}  ${check.label}`);
+        }
+        else {
+            console.log(`  ${RED}✗${R}  ${check.label}`);
+            if (check.detail)
+                console.log(`${DIM}       → ${check.detail}${R}`);
+            hasFailure = true;
+        }
+    }
+    return hasFailure;
+}
+export async function cmdDoctor() {
+    console.log('\ntapflow doctor\n');
+    const result = await runDoctorChecks();
+    let hasFailure = false;
+    hasFailure = printChecks(result.common) || hasFailure;
+    if (result.ios) {
+        console.log(`\n  ${BOLD}iOS${R}`);
+        hasFailure = printChecks(result.ios) || hasFailure;
+    }
+    if (result.android) {
+        console.log(`\n  ${BOLD}Android${R}`);
+        hasFailure = printChecks(result.android) || hasFailure;
+    }
+    console.log();
+    if (hasFailure) {
+        banner('error', 'SOME CHECKS FAILED', ['Fix the issues above before running `tapflow start`.']);
+        process.exit(1);
+    }
+    else {
+        step('All checks passed.');
+        console.log();
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAoB,MAAM,kBAAkB,CAAA;AACpE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,iBAAiB,CAAA;AAExE,SAAS,WAAW,CAAC,MAAqB;IACxC,IAAI,UAAU,GAAG,KAAK,CAAA;IACtB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;QAChD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;YAC5C,IAAI,KAAK,CAAC,MAAM;gBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,YAAY,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAA;YACnE,UAAU,GAAG,IAAI,CAAA;QACnB,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAA;IACjC,MAAM,MAAM,GAAG,MAAM,eAAe,EAAE,CAAA;IACtC,IAAI,UAAU,GAAG,KAAK,CAAA;IAEtB,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,UAAU,CAAA;IAErD,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,MAAM,CAAC,EAAE,CAAC,CAAA;QACjC,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,UAAU,CAAA;IACpD,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,UAAU,CAAC,EAAE,CAAC,CAAA;QACrC,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,UAAU,CAAA;IACxD,CAAC;IAED,OAAO,CAAC,GAAG,EAAE,CAAA;IACb,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,CAAC,OAAO,EAAE,oBAAoB,EAAE,CAAC,sDAAsD,CAAC,CAAC,CAAA;QAC/F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,oBAAoB,CAAC,CAAA;QAC1B,OAAO,CAAC,GAAG,EAAE,CAAA;IACf,CAAC;AACH,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,5 @@
+export interface InitOptions {
+    relay?: string;
+}
+export declare function cmdInit(opts: InitOptions): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgE9D"}

package/dist/commands/init.js

@@ -0,0 +1,64 @@
+import * as readline from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+import { createSpinner, banner, step } from '../lib/print.js';
+export async function cmdInit(opts) {
+    const baseUrl = (opts.relay ?? 'http://localhost:4000').replace(/^wss?:\/\//, 'http://');
+    const rl = readline.createInterface({ input, output });
+    const email = (await rl.question('  ? Admin email: ')).trim();
+    // Node.js has no native password-input API. Suppress echo via readline's internal
+    // _writeToOutput hook — a widely used convention that remains stable across versions.
+    process.stdout.write('  ? Password: ');
+    const rlAny = rl;
+    const origWriteToOutput = rlAny._writeToOutput;
+    if (origWriteToOutput)
+        rlAny._writeToOutput = () => { };
+    const password = (await rl.question('')).trim();
+    if (origWriteToOutput)
+        rlAny._writeToOutput = origWriteToOutput;
+    process.stdout.write('\n');
+    rl.close();
+    if (!email) {
+        banner('error', 'INVALID INPUT', ['Email is required.']);
+        process.exit(1);
+    }
+    if (!password || password.length < 8) {
+        banner('error', 'INVALID INPUT', ['Password must be at least 8 characters.']);
+        process.exit(1);
+    }
+    const spinner = createSpinner('Creating admin account...');
+    spinner.start();
+    let res = null;
+    try {
+        res = await fetch(`${baseUrl}/api/v1/auth/init`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ email, password }),
+        });
+    }
+    catch {
+        spinner.stop(false);
+        banner('error', 'Could not connect to relay', [
+            `Relay not found at ${baseUrl}`,
+            'Run tapflow start first, then tapflow init.',
+        ]);
+        process.exit(1);
+    }
+    if (!res.ok) {
+        spinner.stop(false);
+        const data = await res.json();
+        if (res.status === 403) {
+            banner('error', 'Already initialized', [
+                'An admin account already exists.',
+                'Use Settings → Team in the dashboard to manage users.',
+            ]);
+        }
+        else {
+            banner('error', 'Failed to create admin', [data.error ?? `HTTP ${res.status}`]);
+        }
+        process.exit(1);
+    }
+    spinner.stop(true);
+    banner('success', 'Admin account created', [`Email: ${email}`]);
+    step(`Open ${baseUrl} to sign in`);
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/commands/logs.d.ts

@@ -0,0 +1,5 @@
+export declare function cmdLogs(opts: {
+    relay?: string;
+    lines?: number;
+}): Promise<void>;
+//# sourceMappingURL=logs.d.ts.map

package/dist/commands/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../src/commands/logs.ts"],"names":[],"mappings":"AAEA,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBrF"}

package/dist/commands/logs.js

@@ -0,0 +1,22 @@
+import { DIM, RED, R } from '../lib/print.js';
+export async function cmdLogs(opts) {
+    const base = (opts.relay ?? 'http://localhost:4000').replace(/^ws/, 'http');
+    const lines = opts.lines ?? 100;
+    const url = `${base}/api/v1/logs?lines=${lines}`;
+    const res = await fetch(url).catch(() => null);
+    if (!res || !res.ok) {
+        console.error(`\n  ${RED}✗${R}  Could not reach relay at ${base}\n  Make sure tapflow is running.\n`);
+        process.exit(1);
+    }
+    const entries = await res.json();
+    if (entries.length === 0) {
+        console.log(`\n  ${DIM}No log entries yet.${R}\n`);
+        return;
+    }
+    console.log();
+    for (const line of entries) {
+        console.log(`  ${DIM}${line}${R}`);
+    }
+    console.log();
+}
+//# sourceMappingURL=logs.js.map