# `DalaDev.Tunnel`
[🔗](https://github.com/manhvu/dala_dev/blob/main/lib/mob_dev/tunnel.ex#L1)

Manages port tunnels for Android and physical iOS devices.

## Android (adb)
  - `adb reverse tcp:4369 tcp:4369` — Android BEAM registers in Mac's EPMD
  - `adb forward tcp:<dist> tcp:9100` — Mac reaches device's dist port

## Physical iOS (direct networking — USB preferred, WiFi/LAN fallback)
  - dala_beam.m finds the device's own IP via getifaddrs() and starts the BEAM
    as dala_qa_ios@<device-ip>
  - The in-process EPMD binds 0.0.0.0:4369 so Mac can query it at <device-ip>:4369
  - The dist port is directly reachable

## iOS Simulator
  - Shares Mac network stack — no tunnels needed

# `result`

```elixir
@type result() :: {:ok, DalaDev.Device.t()} | {:error, String.t()}
```

# `teardown_result`

```elixir
@type teardown_result() :: :ok
```

# `dist_port`

```elixir
@spec dist_port(non_neg_integer()) :: non_neg_integer()
```

Returns the dist port for a given device index (same formula used in setup/2).

# `setup`

```elixir
@spec setup(DalaDev.Device.t(), non_neg_integer()) ::
  {:ok, DalaDev.Device.t()} | {:error, String.t()}
```

Assigns a dist port and sets up tunnels for a device.
Returns {:ok, %Device{}} with dist_port and host_ip filled in, or {:error, reason}.

# `teardown`

```elixir
@spec teardown(DalaDev.Device.t()) :: :ok
```

Tears down tunnels for a device.

---

*Consult [api-reference.md](api-reference.md) for complete listing*