# What changed in @opentunnel/client

> 17 changes in @opentunnel/client 0.6 from its official release notes, upgrade guides and advisories: 1 breaking, 12 new APIs and options. Each one cited. Sources checked 2026-10-28. HTML: https://unstale.sh/npm/@opentunnel/client/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @opentunnel/client 0.6

### Breaking changes

- The CLI and Rust client tunnel the bridge through HTTP or HTTPS proxies using CONNECT; SOCKS proxies now stop the tunnel with an error instead of being bypassed. (0.6.1) — [release notes](https://github.com/anomalyco/opentunnel/blob/de890fb77c8c5df6185504e7647d818ead517749/packages/client/CHANGELOG.md#061)

### New APIs and options

- A proxy option on create and OpenTunnelClient.layer sets the proxy for both API calls and the bridge, regardless of the environment. (0.6.1) — [release notes](https://github.com/anomalyco/opentunnel/blob/de890fb77c8c5df6185504e7647d818ead517749/packages/client/CHANGELOG.md#061)
- A new checking-certificate stage is reported by ensure progress updates. (0.6.0) — [release notes](https://github.com/anomalyco/opentunnel/blob/de890fb77c8c5df6185504e7647d818ead517749/packages/client/CHANGELOG.md#060)
- The new onEvent option lets callers observe route-conflict events before connect resolves. (0.6.0) — [release notes](https://github.com/anomalyco/opentunnel/blob/de890fb77c8c5df6185504e7647d818ead517749/packages/client/CHANGELOG.md#060)
- connection.urls maps each route to its public URL. (0.6.0) — [release notes](https://github.com/anomalyco/opentunnel/blob/de890fb77c8c5df6185504e7647d818ead517749/packages/client/CHANGELOG.md#060)
- ensure({ onProgress }) reports progress, beginning with the checking-certificate stage. (0.6.0) — [release notes](https://github.com/anomalyco/opentunnel/blob/de890fb77c8c5df6185504e7647d818ead517749/packages/client/CHANGELOG.md#060)
- isValidRouteName is now exported. (0.6.0) — [release notes](https://github.com/anomalyco/opentunnel/blob/de890fb77c8c5df6185504e7647d818ead517749/packages/client/CHANGELOG.md#060)
- The protocol package now exports Names.LABEL_PATTERN. (0.6.0) — [release notes](https://github.com/anomalyco/opentunnel/blob/de890fb77c8c5df6185504e7647d818ead517749/packages/client/CHANGELOG.md#060)
- The protocol package now exports Names.publicHostname. (0.6.0) — [release notes](https://github.com/anomalyco/opentunnel/blob/de890fb77c8c5df6185504e7647d818ead517749/packages/client/CHANGELOG.md#060)
- publicUrl is now exported. (0.6.0) — [release notes](https://github.com/anomalyco/opentunnel/blob/de890fb77c8c5df6185504e7647d818ead517749/packages/client/CHANGELOG.md#060)
- ROOT_ROUTE is now exported. (0.6.0) — [release notes](https://github.com/anomalyco/opentunnel/blob/de890fb77c8c5df6185504e7647d818ead517749/packages/client/CHANGELOG.md#060)
- A new event reports each route conflict; it can be observed before connect resolves using the onEvent option. (0.6.0) — [release notes](https://github.com/anomalyco/opentunnel/blob/de890fb77c8c5df6185504e7647d818ead517749/packages/client/CHANGELOG.md#060)
- ROUTE_LABEL_PATTERN is now exported. (0.6.0) — [release notes](https://github.com/anomalyco/opentunnel/blob/de890fb77c8c5df6185504e7647d818ead517749/packages/client/CHANGELOG.md#060)

### Behavior and default changes

- The bridge WebSocket now follows the API proxy settings: HTTPS_PROXY for wss://, HTTP_PROXY for ws://, then ALL_PROXY, except for hosts in NO_PROXY. (0.6.1) — [release notes](https://github.com/anomalyco/opentunnel/blob/de890fb77c8c5df6185504e7647d818ead517749/packages/client/CHANGELOG.md#061)
- Setting onRouteConflict to "fail" makes connect reject with code "route_conflict" instead of retrying. (0.6.0) — [release notes](https://github.com/anomalyco/opentunnel/blob/de890fb77c8c5df6185504e7647d818ead517749/packages/client/CHANGELOG.md#060)
- connect({ signal }) cancels an attach in progress, including certificate work it started, and rejects with the signal's reason. (0.6.0) — [release notes](https://github.com/anomalyco/opentunnel/blob/de890fb77c8c5df6185504e7647d818ead517749/packages/client/CHANGELOG.md#060)

### Fixes and other changes

- Fatal attach errors now carry their code on OpenTunnelClientError.code. (0.6.0) — [release notes](https://github.com/anomalyco/opentunnel/blob/de890fb77c8c5df6185504e7647d818ead517749/packages/client/CHANGELOG.md#060)