Import packages/plugin/src/relay-preference.ts
This commit is contained in:
parent
a68ae1b9f5
commit
3023d6a115
|
|
@ -0,0 +1,33 @@
|
|||
/**
|
||||
* Relay preference ("force relay"): the data plane skips LAN, internet-direct
|
||||
* (P2P) and TURN probing and goes straight to the encrypted relay.
|
||||
*
|
||||
* Why a runtime switch instead of reading the config every time: the Host
|
||||
* advertises its transport capabilities when it dials the Server, and the
|
||||
* Client walks its attempt list per connection. Both read this process-wide
|
||||
* flag so a toggle applies without rebuilding the plugin, mirroring
|
||||
* {@link ./lite-mode.ts}. Seeded from `config.forceRelay` at startup; the
|
||||
* config keeps working for users who set it statically.
|
||||
*/
|
||||
|
||||
import type { TransportAttempt } from './client-runtime-contract.js'
|
||||
|
||||
let enabled = false
|
||||
|
||||
/** Whether the relay-only preference is currently on. */
|
||||
export function isForceRelayEnabled(): boolean {
|
||||
return enabled
|
||||
}
|
||||
|
||||
/** Flip the relay-only preference for subsequent connections. */
|
||||
export function setForceRelayEnabled(next: boolean): void {
|
||||
enabled = next === true
|
||||
}
|
||||
|
||||
/**
|
||||
* Attempts a Client walks when connecting. A Host without a usable WebRTC
|
||||
* backend can only relay, so both cases collapse to a single attempt.
|
||||
*/
|
||||
export function transportAttempts(forceRelay: boolean, rtcAvailable: boolean): TransportAttempt[] {
|
||||
return forceRelay || !rtcAvailable ? ['relay'] : ['direct', 'turn', 'relay']
|
||||
}
|
||||
Loading…
Reference in New Issue