Transports and routing

getActiveTransports(): Promise<TransportType[]>

enableTransport(type: TransportType, config?: InternetTransportConfig | WifiDirectTransportConfig | NostrTransportConfig | ReticulumTransportConfig): Promise<void>

disableTransport(type: TransportType): Promise<void>

isBluetoothEnabled(): Promise<boolean>

requestEnableBluetooth(): Promise<boolean>

getTopology(): Promise<NetworkTopology>

setBatteryLevel(level: number): Promise<void>

setBatteryState(level: number, isCharging: boolean): Promise<void>

getBatteryLevel(): Promise<number | null>

getIsCharging(): Promise<boolean>

setRelayPriority(priority: RelayPriority | "low" | "medium" | "high"): Promise<void>

getRelayPriority(): Promise<RelayPriority>

updateRelayConfig(config: RelayConfig): Promise<void>

getRelayConfig(): Promise<Required<RelayConfig>>

isRelay(): Promise<boolean>

getBLePeerCount(): Promise<number>

getBleDiagnostics(): Promise<BleDiagnostics>

getTransportMetrics(transportType: TransportType): Promise<TransportMetrics | null>

forceTransport(transportType: TransportType): Promise<void>

releaseTransportLock(): Promise<void>

updateDorsConfig(config: { preferOnline?: boolean; switchHysteresis?: number; switchCooldownSecs?: number; bleToWifiRetryThreshold?: number; minSuccessRateBeforeEscalation?: number; minBleSamplesBeforeSuccessRateEscalation?: number; rssiSwitchThreshold?: number; congestionQueueThreshold?: number; stabilityWindowSecs?: number; poorSignalDurationSecs?: number; ttlEscalationThreshold?: number; congestionDurationSecs?: number; ttlEscalationHoldSecs?: number; historyWindowSize?: number; queueRecoveryRatio?: number; lowBatteryThreshold?: number; relayMinBatteryLevel?: number; relayOptimalConnectionCount?: number; }): Promise<void>

getDorsConfig(): Promise<{
    preferOnline: boolean;
    switchHysteresis: number;
    switchCooldownSecs: number;
    bleToWifiRetryThreshold: number;
    minSuccessRateBeforeEscalation: number;
    minBleSamplesBeforeSuccessRateEscalation: number;
    rssiSwitchThreshold: number;
    congestionQueueThreshold: number;
    stabilityWindowSecs: number;
    poorSignalDurationSecs: number;
    ttlEscalationThreshold: number;
    congestionDurationSecs: number;
    ttlEscalationHoldSecs: number;
    historyWindowSize: number;
    queueRecoveryRatio: number;
    lowBatteryThreshold: number;
    relayMinBatteryLevel: number;
    relayOptimalConnectionCount: number;
  }>

updateAckConfig(config: AckConfig): Promise<void>

updateRetryConfig(config: RetryConfig): Promise<void>

updateDedupConfig(config: DedupConfig): Promise<void>

getDedupStats(): Promise<DedupStats>

getMeshRelayStats(): Promise<MeshRelayStats>

getMeshRelayTunables(): Promise<MeshRelayTunables>

getPendingAckCount(): Promise<number>

getRetryQueueSize(): Promise<number>

shouldEscalateToWifi(): Promise<boolean>

wifiDirectStatusChanged(isConnected: boolean): Promise<void>

wifiDirectMessageReceived(senderId: string, data: number[]): Promise<void>

wifiDirectGetNextMessage(): Promise<{
    recipientId: string;
    data: number[];
  } | null>

wifiDirectPeerConnected(peerId: string): Promise<void>

wifiDirectPeerDisconnected(peerId: string): Promise<void>

internetStatusChanged(isConnected: boolean): Promise<void>

internetMessageReceived(senderId: string, data: number[]): Promise<void>

internetGetNextMessage(): Promise<{
    messageId: string;
    recipientId: string;
    data: number[];
  } | null>

internetConfirmSent(messageId: string): Promise<void>

internetSendFailed(messageId: string): Promise<void>

sendRawServerCommand(json: string): Promise<boolean>

isInternetReady(): Promise<boolean>

if (await sdk.isInternetSuperseded()) {
  // Surface "connected elsewhere" and let the user decide.
  await sdk.enableTransport('internet', { serverAddress });  // clears the latch
}

isInternetSuperseded(): Promise<boolean>

forceInternetReconnect(): Promise<boolean>

export type TransportType = 'ble' | 'internet' | 'wifiDirect' | 'reticulum' | 'nostr';

export interface NetworkTopology {
  timestamp: number;
  local_user_id: string;
  nodes: NetworkNode[];
  links: NetworkLink[];
  stats: NetworkStats;
}

export interface NetworkNode {
  user_id: string;
  role: NodeRole;
  connection_count: number;
  battery_level?: number;
  last_seen: number;
  transports: TransportType[];
}

export enum NodeRole {
  Normal = 'normal',
  Relay = 'relay',
}

export interface NetworkLink {
  from: string;
  to: string;
  quality: number;
  transport: TransportType;
  rssi?: number;
}

export interface NetworkStats {
  total_nodes: number;
  relay_nodes: number;
  total_connections: number;
  avg_link_quality: number;
  network_diameter?: number;
}

export interface BleDiagnostics {
  fragmentFallbacks: number;
  recipientNotAmongPeers: number;
  undersizedMtuReports: number;
}

export interface TransportMetrics {
  packetsSent: number;
  packetsReceived: number;
  bytesSent: number;
  bytesReceived: number;
  errorRate: number;
  avgLatencyMs: number;
  rssi?: number;
  bandwidthBps?: number;
  congestion?: number;
  queueDepth?: number;
  batteryLevel?: number;
  isCharging?: boolean;
  relayConnectionCount?: number;
  isActiveRelay?: boolean;
  deliveryRatio?: number;
  dropRate?: number;
  averageHopCount?: number;
  energyCost?: number;
}

export interface DedupStats {
  totalTracked: number;
  recentTracked: number;
  capacityUsedPercent: number;
  mode: string;
}

export interface MeshRelayStats {
  forwarded: number;
  transmissions: number;
  queued: number;
  awaitingTransmission: number;
  duplicatesSuppressed: number;
  coveredByANeighbor: number;
  peerRateLimited: number;
  refusedQueueFull: number;
  rateDeferred: number;
  abandonedOverdue: number;
  hopLimitReached: number;
  reachClamped: number;
  droppedForCapacity: number;
}

export interface MeshRelayTunables {
  maxTtl: number;
  denseMaxTtl: number;
  denseDegree: number;
  fanout: number;
  jitterMinMs: number;
  jitterMaxMs: number;
  ratePerSec: number;
  burst: number;
  peerRatePerSec: number;
  peerBurst: number;
  queueCapacity: number;
  biasMinScale: number;
  biasMaxHandicapMs: number;
  activityWindowMs: number;
  activityMinForwards: number;
  activityIdleWindows: number;
}