@elefunc/send 0.1.5 → 0.1.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elefunc/send",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Browser-compatible file transfer CLI and TUI powered by Bun, WebRTC, and Rezi.",
   "license": "MIT",
   "type": "module",

package/src/core/protocol.ts

@@ -1,4 +1,4 @@
-import type { RTCIceCandidateInit, RTCSessionDescriptionInit } from "werift"
+import type { RTCIceCandidateInit, RTCIceServer, RTCSessionDescriptionInit } from "werift"
 
 export const SIGNAL_WS_URL = "wss://sig.efn.kr/ws"
 export const BASE_ICE_SERVERS = [
@@ -59,6 +59,7 @@ export interface SignalEnvelope {
   from: string
   to: string
   at: string
+  instanceId?: string
 }
 
 export interface HelloSignal extends SignalEnvelope {
@@ -68,6 +69,7 @@ export interface HelloSignal extends SignalEnvelope {
   profile?: PeerProfile
   rtcEpoch?: number
   reply?: boolean
+  recovery?: boolean
 }
 
 export interface NameSignal extends SignalEnvelope {
@@ -105,6 +107,11 @@ export interface CandidateSignal extends SignalEnvelope {
   candidate: RTCIceCandidateInit
 }
 
+export interface TurnShareSignal extends SignalEnvelope {
+  kind: "turn-share"
+  iceServers: RTCIceServer[]
+}
+
 export type SignalMessage =
   | HelloSignal
   | NameSignal
@@ -112,6 +119,7 @@ export type SignalMessage =
   | ByeSignal
   | DescriptionSignal
   | CandidateSignal
+  | TurnShareSignal
 
 export interface DataEnvelope {
   room: string
@@ -200,6 +208,7 @@ export const cleanText = (value: unknown, max = 72) => `${value ?? ""}`.trim().r
 export const cleanRoom = (value: unknown) => cleanText(value).toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 48) || uid(8)
 export const cleanName = (value: unknown) => cleanText(value, 24).toLowerCase().replace(/[^a-z0-9]+/g, "").slice(0, 24) || fallbackName
 export const cleanLocalId = (value: unknown) => cleanText(value, 24).toLowerCase().replace(/[^a-z0-9]+/g, "").slice(0, 24) || uid(8)
+export const cleanInstanceId = (value: unknown) => cleanText(value, 24).toLowerCase().replace(/[^a-z0-9]+/g, "").slice(0, 24)
 export const signalEpoch = (value: unknown) => Number.isSafeInteger(value) && Number(value) > 0 ? Number(value) : 0
 
 export const buildCliProfile = (): PeerProfile => ({

package/src/core/session.ts

@@ -11,6 +11,7 @@ import {
   SIGNAL_WS_URL,
   buildCliProfile,
   cleanText,
+  cleanInstanceId,
   cleanLocalId,
   cleanName,
   cleanRoom,
@@ -39,6 +40,7 @@ interface PeerState {
   name: string
   presence: Presence
   selected: boolean
+  remoteInstanceId: string
   polite: boolean
   pc: RTCPeerConnection | null
   dc: RTCDataChannel | null
@@ -258,6 +260,16 @@ export const turnUsageState = (
   return "idle"
 }
 
+export class SessionAbortedError extends Error {
+  constructor(message = "session aborted") {
+    super(message)
+    this.name = "SessionAbortedError"
+  }
+}
+
+export const isSessionAbortedError = (error: unknown): error is SessionAbortedError =>
+  error instanceof SessionAbortedError || error instanceof Error && error.name === "SessionAbortedError"
+
 const timeoutSignal = (ms: number, base?: AbortSignal | null) => {
   const timeout = typeof AbortSignal !== "undefined" && typeof AbortSignal.timeout === "function" ? AbortSignal.timeout(ms) : undefined
   if (!base) return timeout
@@ -317,7 +329,30 @@ const sameConnectivity = (left: PeerConnectivitySnapshot, right: PeerConnectivit
   && left.remoteCandidateType === right.remoteCandidateType
   && left.pathLabel === right.pathLabel
 
-const turnServers = (urls: string[], username?: string, credential?: string): RTCIceServer[] => [...new Set(urls.filter(Boolean))].map(urls => ({ urls, ...(username ? { username } : {}), ...(credential ? { credential } : {}) }))
+const turnServerUrls = (server?: RTCIceServer | null) => (Array.isArray(server?.urls) ? server.urls : [server?.urls]).map(url => `${url ?? ""}`.trim()).filter(url => /^turns?:/i.test(url))
+const normalizeTurnServer = (server?: RTCIceServer | null): RTCIceServer | null => {
+  const urls = [...new Set(turnServerUrls(server))]
+  if (!urls.length) return null
+  const username = `${server?.username ?? ""}`.trim()
+  const credential = `${server?.credential ?? ""}`.trim()
+  return {
+    urls: urls[0],
+    ...(username ? { username } : {}),
+    ...(credential ? { credential } : {}),
+  }
+}
+const turnServerKey = (server?: RTCIceServer | null) => {
+  const normalized = normalizeTurnServer(server)
+  return normalized ? JSON.stringify({
+    urls: turnServerUrls(normalized).sort(),
+    username: `${normalized.username ?? ""}`,
+    credential: `${normalized.credential ?? ""}`,
+  }) : ""
+}
+const turnServers = (urls: string[], username?: string, credential?: string): RTCIceServer[] =>
+  [...new Set(urls.map(url => `${url ?? ""}`.trim()).filter(url => /^turns?:/i.test(url)))]
+    .map(url => normalizeTurnServer({ urls: url, ...(username ? { username } : {}), ...(credential ? { credential } : {}) }))
+    .filter((server): server is RTCIceServer => !!server)
 
 const messageString = async (value: unknown) => {
   if (typeof value === "string") return value
@@ -328,6 +363,7 @@ const messageString = async (value: unknown) => {
 }
 
 export class SendSession {
+  readonly instanceId: string
   readonly localId: string
   profile = sanitizeProfile(buildCliProfile())
   readonly saveDir: string
@@ -340,7 +376,8 @@ export class SendSession {
   private autoAcceptIncoming: boolean
   private autoSaveIncoming: boolean
   private readonly reconnectSocket: boolean
-  private readonly iceServers: RTCIceServer[]
+  private iceServers: RTCIceServer[]
+  private extraTurnServers: RTCIceServer[]
   private readonly peerSelectionMemory: Map<string, boolean>
   private readonly peers = new Map<string, PeerState>()
   private readonly transfers = new Map<string, TransferState>()
@@ -353,10 +390,12 @@ export class SendSession {
   private socketToken = 0
   private reconnectTimer: ReturnType<typeof setTimeout> | null = null
   private peerStatsTimer: ReturnType<typeof setInterval> | null = null
+  private readonly pendingRtcCloses = new Set<Promise<void>>()
   private lifecycleAbortController: AbortController | null = null
   private stopped = false
 
   constructor(config: SessionConfig) {
+    this.instanceId = cleanInstanceId(uid(10)) || uid(10)
     this.localId = cleanLocalId(config.localId)
     this.room = cleanRoom(config.room)
     this.name = cleanName(config.name ?? fallbackName)
@@ -365,9 +404,9 @@ export class SendSession {
     this.autoAcceptIncoming = !!config.autoAcceptIncoming
     this.autoSaveIncoming = !!config.autoSaveIncoming
     this.reconnectSocket = config.reconnectSocket ?? true
-    const extraTurn = turnServers(config.turnUrls ?? [], config.turnUsername, config.turnCredential)
-    this.iceServers = [...BASE_ICE_SERVERS, ...extraTurn]
-    this.turnAvailable = extraTurn.length > 0
+    this.extraTurnServers = turnServers(config.turnUrls ?? [], config.turnUsername, config.turnCredential)
+    this.iceServers = [...BASE_ICE_SERVERS, ...this.extraTurnServers]
+    this.turnAvailable = this.extraTurnServers.length > 0
   }
 
   subscribe(listener: () => void) {
@@ -409,7 +448,7 @@ export class SendSession {
     void this.loadLocalProfile()
     void this.probePulse()
     this.connectSocket()
-    await this.waitFor(() => this.socketState === "open", timeoutMs)
+    await this.waitFor(() => this.socketState === "open", timeoutMs, this.lifecycleAbortController?.signal)
   }
 
   async close() {
@@ -426,6 +465,7 @@ export class SendSession {
     if (socket) try { socket.close(1000, "normal") } catch {}
     for (const peer of this.peers.values()) this.destroyPeer(peer, "session-close")
     this.notify()
+    if (this.pendingRtcCloses.size) await Promise.allSettled([...this.pendingRtcCloses])
   }
 
   activePeers() {
@@ -440,6 +480,40 @@ export class SendSession {
     return this.readyPeers().filter(peer => peer.selected)
   }
 
+  canShareTurn() {
+    return this.extraTurnServers.length > 0
+  }
+
+  shareTurnWithPeer(peerId: string) {
+    const peer = this.peers.get(peerId)
+    if (!peer || peer.presence !== "active" || !this.extraTurnServers.length) return false
+    const sent = this.sendSignal({ kind: "turn-share", to: peer.id, iceServers: this.sharedTurnServers() })
+    if (sent) this.pushLog("turn:share-sent", { peer: peer.id, scope: "peer" }, "info")
+    return sent
+  }
+
+  shareTurnWithPeers(peerIds: string[]) {
+    if (!this.extraTurnServers.length) return 0
+    const iceServers = this.sharedTurnServers()
+    const sentPeers: string[] = []
+    for (const peerId of new Set(peerIds.filter(Boolean))) {
+      const peer = this.peers.get(peerId)
+      if (!peer || peer.presence !== "active") continue
+      if (!this.sendSignal({ kind: "turn-share", to: peer.id, iceServers })) continue
+      sentPeers.push(peer.id)
+    }
+    if (sentPeers.length) this.pushLog("turn:share-sent", { peers: sentPeers.length, scope: "filtered", peerIds: sentPeers }, "info")
+    return sentPeers.length
+  }
+
+  shareTurnWithAllPeers() {
+    const count = this.activePeers().length
+    if (!count || !this.extraTurnServers.length) return 0
+    const sent = this.sendSignal({ kind: "turn-share", to: "*", iceServers: this.sharedTurnServers() })
+    if (sent) this.pushLog("turn:share-sent", { peers: count, scope: "all" }, "info")
+    return sent ? count : 0
+  }
+
   setPeerSelected(peerId: string, selected: boolean) {
     const peer = this.peers.get(peerId)
     if (!peer) return false
@@ -458,6 +532,32 @@ export class SendSession {
     return peer ? this.setPeerSelected(peerId, !peer.selected) : false
   }
 
+  private sharedTurnServers() {
+    return this.extraTurnServers.map(server => normalizeTurnServer(server)).filter((server): server is RTCIceServer => !!server)
+  }
+
+  private refreshIceServers() {
+    this.turnAvailable = this.extraTurnServers.length > 0
+    this.iceServers = [...BASE_ICE_SERVERS, ...this.extraTurnServers]
+  }
+
+  private mergeTurnServers(iceServers: RTCIceServer[] = []) {
+    const known = new Set(this.extraTurnServers.map(turnServerKey).filter(Boolean))
+    const added: RTCIceServer[] = []
+    for (const server of iceServers) {
+      const normalized = normalizeTurnServer(server)
+      if (!normalized) continue
+      const key = turnServerKey(normalized)
+      if (!key || known.has(key)) continue
+      known.add(key)
+      added.push(normalized)
+    }
+    if (!added.length) return 0
+    this.extraTurnServers = [...this.extraTurnServers, ...added]
+    this.refreshIceServers()
+    return added.length
+  }
+
   clearLogs() {
     this.logs.length = 0
     this.notify()
@@ -653,19 +753,31 @@ export class SendSession {
     return this.transfers.get(transferId)
   }
 
-  async waitFor(predicate: () => boolean, timeoutMs: number) {
+  async waitFor(predicate: () => boolean, timeoutMs: number, signal?: AbortSignal | null) {
     if (predicate()) return
+    if (signal?.aborted) throw new SessionAbortedError()
     await new Promise<void>((resolveWait, rejectWait) => {
-      const timeout = setTimeout(() => {
+      let unsubscribe = () => {}
+      const cleanup = () => {
+        clearTimeout(timeout)
+        signal?.removeEventListener("abort", onAbort)
         unsubscribe()
+      }
+      const onAbort = () => {
+        cleanup()
+        rejectWait(new SessionAbortedError())
+      }
+      const timeout = setTimeout(() => {
+        cleanup()
         rejectWait(new Error(`timed out after ${timeoutMs}ms`))
       }, timeoutMs)
-      const unsubscribe = this.subscribe(() => {
+      unsubscribe = this.subscribe(() => {
         if (!predicate()) return
-        clearTimeout(timeout)
-        unsubscribe()
+        cleanup()
         resolveWait()
       })
+      signal?.addEventListener("abort", onAbort, { once: true })
+      if (signal?.aborted) onAbort()
     })
   }
 
@@ -933,7 +1045,7 @@ export class SendSession {
 
   private sendSignal(payload: { kind: string; to?: string; [key: string]: unknown }) {
     if (!this.socket || this.socket.readyState !== WebSocket.OPEN) return false
-    const message = { room: this.room, from: this.localId, to: "*", at: stamp(), ...payload }
+    const message = { room: this.room, from: this.localId, to: "*", at: stamp(), instanceId: this.instanceId, ...payload }
     this.socket.send(JSON.stringify(message))
     this.pushLog("signal:out", message)
     return true
@@ -967,12 +1079,13 @@ export class SendSession {
     return previous !== next
   }
 
-  private buildPeer(remoteId: string) {
+  private buildPeer(remoteId: string, remoteInstanceId = "") {
     const peer: PeerState = {
       id: remoteId,
       name: fallbackName,
       presence: "active",
       selected: this.peerSelected(remoteId),
+      remoteInstanceId: cleanInstanceId(remoteInstanceId),
       polite: this.localId > remoteId,
       pc: null,
       dc: null,
@@ -996,16 +1109,42 @@ export class SendSession {
     return peer
   }
 
-  private syncPeerPresence(remoteId: string, name?: string, profile?: PeerProfile, turnAvailable?: boolean) {
-    const peer = this.peers.get(remoteId) ?? this.buildPeer(remoteId)
+  private resetPeerInstance(peer: PeerState, remoteInstanceId: string) {
+    peer.remoteInstanceId = remoteInstanceId
+    peer.remoteEpoch = 0
+    peer.selected = this.peerSelected(peer.id)
+    peer.presence = "active"
+    peer.terminalReason = ""
+    peer.lastError = ""
+    peer.turnAvailable = false
+    peer.connectivity = emptyConnectivitySnapshot()
+    this.failPeerTransfers(peer, "peer-restarted")
+    this.closePeerRTC(peer)
+    this.pushLog("peer:instance-replaced", { peer: peer.id, instanceId: remoteInstanceId })
+  }
+
+  private acceptPeerInstance(peer: PeerState, remoteInstanceId: unknown, kind: string) {
+    const nextInstanceId = cleanInstanceId(remoteInstanceId)
+    if (!nextInstanceId) return true
+    if (!peer.remoteInstanceId) {
+      peer.remoteInstanceId = nextInstanceId
+      return true
+    }
+    if (peer.remoteInstanceId === nextInstanceId) return true
+    if (kind !== "hello") return false
+    this.resetPeerInstance(peer, nextInstanceId)
+    return true
+  }
+
+  private syncPeerPresence(peer: PeerState, name?: string, profile?: PeerProfile, turnAvailable?: boolean) {
     const wasTerminal = peer.presence === "terminal"
     peer.lastSeenAt = Date.now()
     peer.presence = "active"
     peer.terminalReason = ""
-    if (wasTerminal) peer.selected = this.peerSelected(remoteId)
+    if (wasTerminal) peer.selected = this.peerSelected(peer.id)
     if (name != null) {
       peer.name = cleanName(name)
-      for (const transfer of this.transfers.values()) if (transfer.peerId === remoteId) transfer.peerName = peer.name
+      for (const transfer of this.transfers.values()) if (transfer.peerId === peer.id) transfer.peerName = peer.name
     }
     if (typeof turnAvailable === "boolean") peer.turnAvailable = turnAvailable
     if (profile) peer.profile = sanitizeProfile(profile)
@@ -1013,14 +1152,21 @@ export class SendSession {
     return peer
   }
 
-  private syncPeerSignal(peer: PeerState, kind: string, remoteEpoch = 0) {
+  private syncPeerSignal(peer: PeerState, kind: string, remoteEpoch = 0, recovery = false) {
     const epoch = signalEpoch(remoteEpoch)
     if (epoch && epoch < peer.remoteEpoch) return null
     if (epoch) peer.remoteEpoch = epoch
-    if (kind !== "bye" && (!peer.pc || peer.pc.connectionState === "closed" || peer.dc?.readyState === "closed")) this.ensurePeerConnection(peer, `signal:${kind}`)
+    if (kind !== "bye" && (recovery || !peer.pc || peer.pc.connectionState === "closed" || peer.dc?.readyState === "closed")) this.ensurePeerConnection(peer, `signal:${kind}`)
     return peer
   }
 
+  private restartPeerConnection(peer: PeerState, reason: string, announceRecovery = false) {
+    this.ensurePeerConnection(peer, reason)
+    if (announceRecovery) this.sendPeerHello(peer, { recovery: true })
+    this.emit({ type: "peer", peer: this.peerSnapshot(peer) })
+    this.notify()
+  }
+
   private ensurePeerConnection(peer: PeerState, reason: string) {
     const epoch = this.nextRtcEpoch()
     peer.rtcEpoch = epoch
@@ -1110,13 +1256,34 @@ export class SendSession {
     channel.onmessage = ({ data }) => void this.onDataMessage(peer, data)
   }
 
+  private trackRtcClose(closeTask: Promise<void> | null | undefined) {
+    if (!closeTask) return
+    const task = closeTask.catch(() => {}).finally(() => {
+      this.pendingRtcCloses.delete(task)
+    })
+    this.pendingRtcCloses.add(task)
+  }
+
   private closePeerRTC(peer: PeerState) {
     const dc = peer.dc
     const pc = peer.pc
     peer.dc = null
     peer.pc = null
+    if (dc) {
+      ;(dc as any).onopen = null
+      ;(dc as any).onclose = null
+      ;(dc as any).onerror = null
+      ;(dc as any).onmessage = null
+    }
+    if (pc) {
+      ;(pc as any).onicecandidate = null
+      ;(pc as any).ondatachannel = null
+      ;(pc as any).onnegotiationneeded = null
+      ;(pc as any).onconnectionstatechange = null
+      ;(pc as any).oniceconnectionstatechange = null
+    }
     try { dc?.close() } catch {}
-    void pc?.close().catch(() => {})
+    this.trackRtcClose(pc ? Promise.resolve().then(() => pc.close()) : null)
   }
 
   private failPeerTransfers(peer: PeerState, reason: string) {
@@ -1136,29 +1303,45 @@ export class SendSession {
     const message = JSON.parse(raw) as SignalMessage
     if (message.room !== this.room || message.from === this.localId || (message.to && message.to !== "*" && message.to !== this.localId)) return
     this.pushLog("signal:in", message)
+    const peer = this.peers.get(message.from) ?? (message.kind === "bye" ? null : this.buildPeer(message.from, message.instanceId))
+    if (peer && !this.acceptPeerInstance(peer, message.instanceId, message.kind)) return
 
     if (message.kind === "hello") {
-      const peer = this.syncPeerSignal(this.syncPeerPresence(message.from, message.name, message.profile, message.turnAvailable), "hello", message.rtcEpoch)
-      if (peer && !message.reply) this.sendPeerHello(peer, { reply: true })
+      if (!peer) return
+      const synced = this.syncPeerSignal(this.syncPeerPresence(peer, message.name, message.profile, message.turnAvailable), "hello", message.rtcEpoch, !!message.recovery)
+      if (synced && !message.reply) this.sendPeerHello(synced, { reply: true })
       this.notify()
       return
     }
     if (message.kind === "name") {
-      this.syncPeerPresence(message.from, message.name)
+      if (!peer) return
+      this.syncPeerPresence(peer, message.name)
       this.notify()
       return
     }
     if (message.kind === "profile") {
-      this.syncPeerSignal(this.syncPeerPresence(message.from, message.name, message.profile, message.turnAvailable), "profile", message.rtcEpoch)
+      if (!peer) return
+      this.syncPeerSignal(this.syncPeerPresence(peer, message.name, message.profile, message.turnAvailable), "profile", message.rtcEpoch)
       this.notify()
       return
     }
     if (message.kind === "bye") {
-      const peer = this.peers.get(message.from)
       if (peer) this.destroyPeer(peer, "peer-left")
       this.notify()
       return
     }
+    if (message.kind === "turn-share") {
+      if (!peer) return
+      this.syncPeerPresence(peer)
+      const added = this.mergeTurnServers(message.iceServers)
+      if (added) {
+        this.pushLog("turn:share-applied", { peer: peer.id, added }, "info")
+        this.broadcastProfile()
+        this.restartPeerConnection(peer, "turn-share", true)
+      }
+      this.notify()
+      return
+    }
     if (message.kind === "description") {
       await this.onDescriptionSignal(message)
       return
@@ -1170,7 +1353,9 @@ export class SendSession {
   }
 
   private async onDescriptionSignal(message: DescriptionSignal) {
-    const peer = this.syncPeerSignal(this.syncPeerPresence(message.from, message.name, message.profile, message.turnAvailable), "description", message.rtcEpoch)
+    const existing = this.peers.get(message.from) ?? this.buildPeer(message.from, message.instanceId)
+    if (!this.acceptPeerInstance(existing, message.instanceId, message.kind)) return
+    const peer = this.syncPeerSignal(this.syncPeerPresence(existing, message.name, message.profile, message.turnAvailable), "description", message.rtcEpoch)
     if (!peer?.pc) return
     const offerCollision = message.description.type === "offer" && !peer.makingOffer && peer.pc.signalingState !== "stable"
     if (!peer.polite && offerCollision) return
@@ -1190,7 +1375,9 @@ export class SendSession {
   }
 
   private async onCandidateSignal(message: CandidateSignal) {
-    const peer = this.syncPeerSignal(this.syncPeerPresence(message.from, message.name, message.profile, message.turnAvailable), "candidate", message.rtcEpoch)
+    const existing = this.peers.get(message.from) ?? this.buildPeer(message.from, message.instanceId)
+    if (!this.acceptPeerInstance(existing, message.instanceId, message.kind)) return
+    const peer = this.syncPeerSignal(this.syncPeerPresence(existing, message.name, message.profile, message.turnAvailable), "candidate", message.rtcEpoch)
     if (!peer?.pc) return
     try {
       await peer.pc.addIceCandidate(message.candidate as RTCIceCandidateInit)

package/src/tui/app.ts

@@ -1,7 +1,7 @@
 import { rgb, ui, type BadgeVariant, type VNode } from "@rezi-ui/core"
 import { createNodeApp } from "@rezi-ui/node"
 import { inspectLocalFile } from "../core/files"
-import { SendSession, type PeerSnapshot, type SessionConfig, type SessionSnapshot, type TransferSnapshot } from "../core/session"
+import { isSessionAbortedError, SendSession, type PeerSnapshot, type SessionConfig, type SessionSnapshot, type TransferSnapshot } from "../core/session"
 import { cleanLocalId, cleanName, cleanRoom, displayPeerName, fallbackName, formatBytes, type LogEntry, peerDefaultsToken, type PeerProfile, uid } from "../core/protocol"
 import { FILE_SEARCH_VISIBLE_ROWS, type FileSearchEvent, type FileSearchMatch, type FileSearchRequest } from "./file-search-protocol"
 import { deriveFileSearchScope, formatFileSearchDisplayPath, normalizeSearchQuery, offsetFileSearchMatchIndices } from "./file-search"
@@ -45,6 +45,7 @@ export interface TuiState {
   sessionSeed: SessionSeed
   peerSelectionByRoom: Map<string, Map<string, boolean>>
   snapshot: SessionSnapshot
+  peerSearch: string
   focusedId: string | null
   roomInput: string
   nameInput: string
@@ -72,10 +73,13 @@ export interface TuiActions {
   jumpToNewSelf: TuiAction
   commitName: TuiAction
   setNameInput: (value: string) => void
+  setPeerSearch: (value: string) => void
   toggleSelectReadyPeers: TuiAction
   clearPeerSelection: TuiAction
   toggleHideTerminalPeers: TuiAction
   togglePeer: (peerId: string) => void
+  shareTurnWithPeer: (peerId: string) => void
+  shareTurnWithAllPeers: TuiAction
   toggleAutoOffer: TuiAction
   toggleAutoAccept: TuiAction
   toggleAutoSave: TuiAction
@@ -95,9 +99,12 @@ export interface TuiActions {
 
 const ROOM_INPUT_ID = "room-input"
 const NAME_INPUT_ID = "name-input"
+const PEER_SEARCH_INPUT_ID = "peer-search-input"
 const DRAFT_INPUT_ID = "draft-input"
 const TRANSPARENT_BORDER_STYLE = { fg: rgb(7, 10, 12) } as const
 const METRIC_BORDER_STYLE = { fg: rgb(20, 25, 32) } as const
+const PRIMARY_TEXT_STYLE = { fg: rgb(255, 255, 255) } as const
+const HEADING_TEXT_STYLE = { fg: rgb(255, 255, 255), bold: true } as const
 const DEFAULT_WEB_URL = "https://send.rt.ht/"
 const TRANSFER_DIRECTION_ARROW = {
   out: { glyph: "↗", style: { fg: rgb(170, 217, 76), bold: true } },
@@ -147,10 +154,13 @@ export const createNoopTuiActions = (): TuiActions => ({
   jumpToNewSelf: noop,
   commitName: noop,
   setNameInput: noop,
+  setPeerSearch: noop,
   toggleSelectReadyPeers: noop,
   clearPeerSelection: noop,
   toggleHideTerminalPeers: noop,
   togglePeer: noop,
+  shareTurnWithPeer: noop,
+  shareTurnWithAllPeers: noop,
   toggleAutoOffer: noop,
   toggleAutoAccept: noop,
   toggleAutoSave: noop,
@@ -200,6 +210,16 @@ const transferStatusKind = (status: TransferSnapshot["status"]) => ({
   error: "offline",
 }[status] || "unknown") as "online" | "offline" | "away" | "busy" | "unknown"
 const visiblePeers = (peers: PeerSnapshot[], hideTerminalPeers: boolean) => hideTerminalPeers ? peers.filter(peer => peer.presence === "active") : peers
+const peerSearchNeedle = (value: string) => `${value ?? ""}`.trim().toLowerCase()
+const peerMatchesSearch = (peer: PeerSnapshot, search: string) => !search || peer.displayName.toLowerCase().includes(search)
+export const renderedPeers = (peers: PeerSnapshot[], hideTerminalPeers: boolean, search: string) => {
+  const needle = peerSearchNeedle(search)
+  return visiblePeers(peers, hideTerminalPeers)
+    .filter(peer => peerMatchesSearch(peer, needle))
+    .sort((left, right) => left.id.localeCompare(right.id))
+}
+export const renderedReadySelectedPeers = (peers: PeerSnapshot[], hideTerminalPeers: boolean, search: string) =>
+  renderedPeers(peers, hideTerminalPeers, search).filter(peer => peer.selected && peer.ready)
 const transferProgress = (transfer: TransferSnapshot) => Math.max(0, Math.min(1, transfer.progress / 100))
 const isPendingOffer = (transfer: TransferSnapshot) => transfer.direction === "out" && (transfer.status === "queued" || transfer.status === "offered")
 const statusVariant = (status: TransferSnapshot["status"]): BadgeVariant => ({
@@ -473,6 +493,7 @@ export const createInitialTuiState = (initialConfig: SessionConfig, showEvents =
     sessionSeed,
     peerSelectionByRoom,
     snapshot: session.snapshot(),
+    peerSearch: "",
     focusedId: null,
     roomInput: sessionSeed.room,
     nameInput: visibleNameInput(sessionSeed.name),
@@ -519,6 +540,32 @@ const ghostButton = (id: string, label: string, onPress?: TuiAction, options: {
   dsVariant: "ghost",
 })
 
+const TEXT_BUTTON_FOCUS_CONFIG = { indicator: "none", showHint: false } as const
+
+const textButton = (id: string, label: string, onPress?: TuiAction, options: { focusable?: boolean; accessibleLabel?: string } = {}) => ui.button({
+  id,
+  label,
+  ...(onPress === undefined ? {} : { onPress }),
+  ...(options.focusable === undefined ? {} : { focusable: options.focusable }),
+  ...(options.accessibleLabel === undefined ? {} : { accessibleLabel: options.accessibleLabel }),
+  px: 0,
+  dsVariant: "ghost",
+  style: PRIMARY_TEXT_STYLE,
+  focusConfig: TEXT_BUTTON_FOCUS_CONFIG,
+})
+
+const headingTextButton = (id: string, label: string, onPress?: TuiAction, options: { focusable?: boolean; accessibleLabel?: string } = {}) => ui.button({
+  id,
+  label,
+  ...(onPress === undefined ? {} : { onPress }),
+  ...(options.focusable === undefined ? {} : { focusable: options.focusable }),
+  ...(options.accessibleLabel === undefined ? {} : { accessibleLabel: options.accessibleLabel }),
+  px: 0,
+  dsVariant: "ghost",
+  style: HEADING_TEXT_STYLE,
+  focusConfig: TEXT_BUTTON_FOCUS_CONFIG,
+})
+
 const denseSection = (options: DenseSectionOptions, children: readonly DenseSectionChild[]) => ui.box({
   ...(options.id === undefined ? {} : { id: options.id }),
   ...(options.key === undefined ? {} : { key: options.key }),
@@ -620,7 +667,7 @@ const renderSelfCard = (state: TuiState, actions: TuiActions) => denseSection({
   ]),
 ])
 
-const renderPeerRow = (peer: PeerSnapshot, actions: TuiActions) => denseSection({
+const renderPeerRow = (peer: PeerSnapshot, turnShareEnabled: boolean, actions: TuiActions) => denseSection({
   id: `peer-row-${peer.id}`,
   key: peer.id,
 }, [
@@ -639,9 +686,9 @@ const renderPeerRow = (peer: PeerSnapshot, actions: TuiActions) => denseSection(
         }),
       ]),
       ui.box({ id: `peer-name-slot-${peer.id}`, flex: 1, minWidth: 0, border: "none" }, [
-        ui.text(peer.displayName, {
-          id: `peer-name-text-${peer.id}`,
-          textOverflow: "ellipsis",
+        textButton(`peer-share-turn-${peer.id}`, peer.displayName, turnShareEnabled && peer.presence === "active" ? () => actions.shareTurnWithPeer(peer.id) : undefined, {
+          focusable: turnShareEnabled && peer.presence === "active",
+          accessibleLabel: `share TURN with ${peer.displayName}`,
         }),
       ]),
       ui.row({ id: `peer-status-cluster-${peer.id}`, gap: 1, items: "center" }, [
@@ -668,12 +715,19 @@ const renderPeerRow = (peer: PeerSnapshot, actions: TuiActions) => denseSection(
 ])
 
 const renderPeersCard = (state: TuiState, actions: TuiActions) => {
-  const peers = visiblePeers(state.snapshot.peers, state.hideTerminalPeers)
-  const activeCount = state.snapshot.peers.filter(peer => peer.presence === "active").length
-  const selectedCount = state.snapshot.peers.filter(peer => peer.selectable && peer.selected).length
+  const peers = renderedPeers(state.snapshot.peers, state.hideTerminalPeers, state.peerSearch)
+  const activeCount = peers.filter(peer => peer.presence === "active").length
+  const selectedCount = peers.filter(peer => peer.selectable && peer.selected).length
+  const canShareTurn = state.session.canShareTurn()
   return denseSection({
     id: "peers-card",
-    title: `Peers ${selectedCount}/${activeCount}`,
+    titleNode: ui.row({ id: "peers-title-row", gap: 1, items: "center" }, [
+      headingTextButton("share-turn-all-peers", "Peers", canShareTurn && !!activeCount ? actions.shareTurnWithAllPeers : undefined, {
+        focusable: canShareTurn && !!activeCount,
+        accessibleLabel: "share TURN with matching active peers",
+      }),
+      ui.text(`${selectedCount}/${peers.length}`, { id: "peers-count-text", variant: "heading" }),
+    ]),
     flex: 1,
     actions: [
       actionButton("select-ready-peers", "All", actions.toggleSelectReadyPeers),
@@ -681,10 +735,16 @@ const renderPeersCard = (state: TuiState, actions: TuiActions) => {
       toggleButton("toggle-clean-peers", "Clean", state.hideTerminalPeers, actions.toggleHideTerminalPeers),
     ],
   }, [
+    ui.input({
+      id: PEER_SEARCH_INPUT_ID,
+      value: state.peerSearch,
+      placeholder: "filter",
+      onInput: value => actions.setPeerSearch(value),
+    }),
     ui.box({ id: "peers-list", flex: 1, minHeight: 0, overflow: "scroll", border: "none" }, [
       peers.length
-        ? ui.column({ gap: 0 }, peers.map(peer => renderPeerRow(peer, actions)))
-        : ui.empty(`Waiting for peers in ${state.snapshot.room}...`),
+        ? ui.column({ gap: 0 }, peers.map(peer => renderPeerRow(peer, canShareTurn, actions)))
+        : ui.empty(state.snapshot.peers.length ? "No peers match current filters." : `Waiting for peers in ${state.snapshot.room}...`),
     ]),
   ])
 }
@@ -729,6 +789,7 @@ const renderFilePreviewRow = (match: FileSearchMatch, index: number, selected: b
     offsetFileSearchMatchIndices(displayPrefix, match.indices),
     { id: `file-preview-path-${index}`, flex: 1 },
   ),
+  match.kind === "file" && typeof match.size === "number" ? ui.text(formatBytes(match.size), { style: { dim: true } }) : null,
   match.kind === "directory" ? tightTag("dir", { variant: "info", bare: true }) : null,
 ])
 
@@ -1025,7 +1086,11 @@ export const startTui = async (initialConfig: SessionConfig, showEvents = false)
   const requestStop = () => {
     if (stopping) return
     stopping = true
-    void app.stop()
+    try {
+      process.kill(process.pid, "SIGINT")
+    } catch {
+      void app.stop()
+    }
   }
 
   const resetFilePreview = (overrides: Partial<FilePreviewState> = {}): FilePreviewState => ({
@@ -1190,11 +1255,12 @@ export const startTui = async (initialConfig: SessionConfig, showEvents = false)
 
   const maybeOfferDrafts = () => {
     if (!state.autoOfferOutgoing || !state.drafts.length || state.offeringDrafts) return
-    if (!state.snapshot.peers.some(peer => peer.presence === "active" && peer.ready && peer.selected)) return
+    const targetPeerIds = renderedReadySelectedPeers(state.snapshot.peers, state.hideTerminalPeers, state.peerSearch).map(peer => peer.id)
+    if (!targetPeerIds.length) return
     const session = state.session
     const pendingDrafts = [...state.drafts]
     commit(current => ({ ...current, offeringDrafts: true }))
-    void session.offerToSelectedPeers(pendingDrafts.map(draft => draft.path)).then(
+    void session.queueFiles(pendingDrafts.map(draft => draft.path), targetPeerIds).then(
       ids => {
         if (state.session !== session) return
         const offeredIds = new Set(pendingDrafts.map(draft => draft.id))
@@ -1219,7 +1285,7 @@ export const startTui = async (initialConfig: SessionConfig, showEvents = false)
     })
     commit(current => current.session === session ? { ...current, snapshot: session.snapshot() } : current)
     void session.connect().catch(error => {
-      if (state.session !== session) return
+      if (state.session !== session || stopping || cleanedUp || isSessionAbortedError(error)) return
       commit(current => withNotice(current, { text: `${error}`, variant: "error" }))
     })
   }
@@ -1234,6 +1300,7 @@ export const startTui = async (initialConfig: SessionConfig, showEvents = false)
       sessionSeed: nextSeed,
       peerSelectionByRoom: current.peerSelectionByRoom,
       snapshot: nextSession.snapshot(),
+      peerSearch: "",
       roomInput: nextSeed.room,
       nameInput: visibleNameInput(nextSeed.name),
       draftInput: "",
@@ -1307,22 +1374,51 @@ export const startTui = async (initialConfig: SessionConfig, showEvents = false)
     jumpToNewSelf: () => replaceSession({ ...state.sessionSeed, localId: cleanLocalId(uid(8)) }, "Started a fresh self ID.", { reseedBootFocus: true }),
     commitName,
     setNameInput: value => commit(current => ({ ...current, nameInput: value })),
+    setPeerSearch: value => commit(current => ({ ...current, peerSearch: value })),
     toggleSelectReadyPeers: () => {
+      const peers = renderedPeers(state.snapshot.peers, state.hideTerminalPeers, state.peerSearch)
       let changed = 0
-      for (const peer of state.snapshot.peers) if (state.session.setPeerSelected(peer.id, peer.presence === "active" && peer.ready)) changed += 1
-      commit(current => withNotice(current, { text: changed ? "Selected ready peers." : "No ready peers to select.", variant: changed ? "success" : "info" }))
+      for (const peer of peers) if (state.session.setPeerSelected(peer.id, peer.presence === "active" && peer.ready)) changed += 1
+      commit(current => withNotice(current, { text: changed ? "Selected matching ready peers." : "No matching ready peers to select.", variant: changed ? "success" : "info" }))
       maybeOfferDrafts()
     },
     clearPeerSelection: () => {
+      const peers = renderedPeers(state.snapshot.peers, state.hideTerminalPeers, state.peerSearch)
       let changed = 0
-      for (const peer of state.snapshot.peers) if (state.session.setPeerSelected(peer.id, false)) changed += 1
-      commit(current => withNotice(current, { text: changed ? `Cleared ${plural(changed, "peer selection")}.` : "No peer selections to clear.", variant: changed ? "warning" : "info" }))
+      for (const peer of peers) if (state.session.setPeerSelected(peer.id, false)) changed += 1
+      commit(current => withNotice(current, { text: changed ? `Cleared ${plural(changed, "matching peer selection")}.` : "No matching peer selections to clear.", variant: changed ? "warning" : "info" }))
     },
     toggleHideTerminalPeers: () => commit(current => withNotice({ ...current, hideTerminalPeers: !current.hideTerminalPeers }, { text: current.hideTerminalPeers ? "Terminal peers shown." : "Terminal peers hidden.", variant: "info" })),
     togglePeer: peerId => {
       state.session.togglePeerSelection(peerId)
       maybeOfferDrafts()
     },
+    shareTurnWithPeer: peerId => {
+      const peer = state.snapshot.peers.find(item => item.id === peerId)
+      const sent = state.session.shareTurnWithPeer(peerId)
+      commit(current => withNotice(current, {
+        text: !state.session.canShareTurn()
+          ? "TURN is not configured."
+          : sent
+            ? `Shared TURN with ${peer?.displayName ?? peerId}.`
+            : `Unable to share TURN with ${peer?.displayName ?? peerId}.`,
+        variant: !state.session.canShareTurn() ? "info" : sent ? "success" : "warning",
+      }))
+    },
+    shareTurnWithAllPeers: () => {
+      const targetPeerIds = renderedPeers(state.snapshot.peers, state.hideTerminalPeers, state.peerSearch)
+        .filter(peer => peer.presence === "active")
+        .map(peer => peer.id)
+      const shared = state.session.shareTurnWithPeers(targetPeerIds)
+      commit(current => withNotice(current, {
+        text: !state.session.canShareTurn()
+          ? "TURN is not configured."
+          : shared
+            ? `Shared TURN with ${plural(shared, "matching peer")}.`
+            : "No matching active peers to share TURN with.",
+        variant: !state.session.canShareTurn() ? "info" : shared ? "success" : "info",
+      }))
+    },
     toggleAutoOffer: () => {
       commit(current => withNotice({ ...current, autoOfferOutgoing: !current.autoOfferOutgoing }, { text: !state.autoOfferOutgoing ? "Auto-offer on." : "Auto-offer off.", variant: !state.autoOfferOutgoing ? "success" : "warning" }))
       maybeOfferDrafts()
@@ -1500,17 +1596,14 @@ export const startTui = async (initialConfig: SessionConfig, showEvents = false)
     await state.session.close()
   }
 
-  const onSignal = () => requestStop()
-  process.once("SIGINT", onSignal)
-  process.once("SIGTERM", onSignal)
-
   try {
     bindSession(state.session)
     await app.run()
   } finally {
-    process.off("SIGINT", onSignal)
-    process.off("SIGTERM", onSignal)
-    await stop()
-    app.dispose()
+    try {
+      await stop()
+    } finally {
+      app.dispose()
+    }
   }
 }

package/src/tui/file-search-protocol.ts

@@ -3,6 +3,7 @@ export interface FileSearchMatch {
   absolutePath: string
   fileName: string
   kind: "file" | "directory"
+  size?: number
   score: number
   indices: number[]
 }

package/src/tui/file-search.ts

@@ -8,6 +8,7 @@ export interface IndexedEntry {
   relativePath: string
   fileName: string
   kind: "file" | "directory"
+  size?: number
 }
 
 export interface FileSearchScope {
@@ -187,6 +188,7 @@ const browseEntries = (entries: readonly IndexedEntry[], resultLimit: number) =>
     absolutePath: entry.absolutePath,
     fileName: entry.fileName,
     kind: entry.kind,
+    size: entry.size,
     score: 0,
     indices: [],
   } satisfies FileSearchMatch))
@@ -203,6 +205,7 @@ export const searchEntries = (entries: readonly IndexedEntry[], query: string, r
       absolutePath: entry.absolutePath,
       fileName: entry.fileName,
       kind: entry.kind,
+      size: entry.size,
       score: match.score,
       indices: match.indices,
     })
@@ -272,6 +275,7 @@ export const crawlWorkspaceEntries = async (workspaceRoot: string, onEntry: (ent
             relativePath: normalizeRelativePath(relative(root, absolutePath)),
             fileName: child.name,
             kind: "file",
+            size: info.size,
           })
         }
       } catch {