@elefunc/send 0.1.18 → 0.1.19

package/package.json

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

package/src/core/files.ts

@@ -1,4 +1,4 @@
-import { access, mkdir, open, rm, stat, type FileHandle } from "node:fs/promises"
+import { access, mkdir, open, rename, rm, stat, type FileHandle } from "node:fs/promises"
 import { basename, extname, join, resolve } from "node:path"
 import { resolveUserPath } from "./paths"
 
@@ -101,8 +101,23 @@ export const uniqueOutputPath = async (directory: string, fileName: string, rese
   }
 }
 
-export const saveIncomingFile = async (directory: string, fileName: string, data: Buffer) => {
-  const path = await uniqueOutputPath(directory, fileName)
+export const incomingOutputPath = async (directory: string, fileName: string, overwrite = false, reservedPaths: ReadonlySet<string> = new Set()) => {
+  await mkdir(directory, { recursive: true })
+  return overwrite ? join(directory, fileName) : uniqueOutputPath(directory, fileName, reservedPaths)
+}
+
+export const replaceOutputPath = async (sourcePath: string, destinationPath: string) => {
+  try {
+    await rename(sourcePath, destinationPath)
+  } catch (error) {
+    if (!await pathExists(destinationPath)) throw error
+    await removePath(destinationPath)
+    await rename(sourcePath, destinationPath)
+  }
+}
+
+export const saveIncomingFile = async (directory: string, fileName: string, data: Buffer, overwrite = false) => {
+  const path = await incomingOutputPath(directory, fileName, overwrite)
   await Bun.write(path, data)
   return path
 }

package/src/core/session.ts

@@ -2,7 +2,7 @@ import { open, rename, type FileHandle } from "node:fs/promises"
 import { resolve } from "node:path"
 import type { RTCDataChannel, RTCIceCandidateInit, RTCIceServer } from "werift"
 import { RTCPeerConnection } from "werift"
-import { closeLocalFile, loadLocalFiles, pathExists, readFileChunk, removePath, saveIncomingFile, uniqueOutputPath, writeFileChunk, type LocalFile } from "./files"
+import { closeLocalFile, incomingOutputPath, loadLocalFiles, pathExists, readFileChunk, removePath, replaceOutputPath, saveIncomingFile, uniqueOutputPath, writeFileChunk, type LocalFile } from "./files"
 import {
   BASE_ICE_SERVERS,
   BUFFER_HIGH,
@@ -176,6 +176,7 @@ export interface SessionConfig {
   peerSelectionMemory?: Map<string, boolean>
   autoAcceptIncoming?: boolean
   autoSaveIncoming?: boolean
+  overwriteIncoming?: boolean
   turnUrls?: string[]
   turnUsername?: string
   turnCredential?: string
@@ -184,6 +185,8 @@ export interface SessionConfig {
 
 const LOG_LIMIT = 200
 const STATS_POLL_MS = 1000
+export const PULSE_PROBE_INTERVAL_MS = 15_000
+export const PULSE_STALE_MS = 45_000
 const PROFILE_URL = "https://ip.rt.ht/"
 export interface PeerConnectivitySnapshot {
   rttMs: number
@@ -194,9 +197,12 @@ export interface PeerConnectivitySnapshot {
 
 export type TurnState = "none" | "idle" | "used"
 export type PulseState = "idle" | "checking" | "open" | "error"
+export type SettledPulseState = "idle" | "open" | "error"
+export type SignalMetricState = "idle" | "connecting" | "checking" | "open" | "degraded" | "closed" | "error"
 
 export interface PulseSnapshot {
   state: PulseState
+  lastSettledState: SettledPulseState
   at: number
   ms: number
   error: string
@@ -206,7 +212,27 @@ const progressOf = (transfer: TransferState) => transfer.size ? Math.max(0, Math
 const isFinal = (transfer: TransferState) => FINAL_STATUSES.has(transfer.status as never)
 export const candidateTypeLabel = (type: string) => ({ host: "Direct", srflx: "NAT", prflx: "NAT", relay: "TURN" }[type] || "—")
 const emptyConnectivitySnapshot = (): PeerConnectivitySnapshot => ({ rttMs: Number.NaN, localCandidateType: "", remoteCandidateType: "", pathLabel: "—" })
-const emptyPulseSnapshot = (): PulseSnapshot => ({ state: "idle", at: 0, ms: 0, error: "" })
+const settledPulseState = (pulse?: Pick<PulseSnapshot, "state" | "lastSettledState"> | null): SettledPulseState =>
+  pulse?.lastSettledState === "open" || pulse?.lastSettledState === "error" || pulse?.lastSettledState === "idle"
+    ? pulse.lastSettledState
+    : pulse?.state === "open"
+      ? "open"
+      : pulse?.state === "error"
+        ? "error"
+        : "idle"
+const pulseIsFresh = (pulse: Pick<PulseSnapshot, "at" | "lastSettledState" | "state">, now = Date.now()) =>
+  settledPulseState(pulse) === "open" && Number.isFinite(pulse.at) && pulse.at > 0 && now - pulse.at <= PULSE_STALE_MS
+export const signalMetricState = (socketState: SocketState, pulse: PulseSnapshot, now = Date.now()): SignalMetricState => {
+  if (socketState === "error") return "error"
+  if (socketState === "closed") return "closed"
+  if (socketState === "connecting") return "connecting"
+  if (socketState === "idle") return "idle"
+  const lastSettled = settledPulseState(pulse)
+  if (lastSettled === "idle") return "checking"
+  if (lastSettled === "error") return "degraded"
+  return pulseIsFresh(pulse, now) ? "open" : "degraded"
+}
+const emptyPulseSnapshot = (): PulseSnapshot => ({ state: "idle", lastSettledState: "idle", at: 0, ms: 0, error: "" })
 
 export const sanitizeProfile = (profile?: PeerProfile): PeerProfile => ({
   geo: {
@@ -389,6 +415,7 @@ export class SendSession {
 
   private autoAcceptIncoming: boolean
   private autoSaveIncoming: boolean
+  private readonly overwriteIncoming: boolean
   private readonly reconnectSocket: boolean
   private iceServers: RTCIceServer[]
   private extraTurnServers: RTCIceServer[]
@@ -405,6 +432,7 @@ export class SendSession {
   private socketToken = 0
   private reconnectTimer: ReturnType<typeof setTimeout> | null = null
   private peerStatsTimer: ReturnType<typeof setInterval> | null = null
+  private pulseTimer: ReturnType<typeof setInterval> | null = null
   private readonly pendingRtcCloses = new Set<Promise<void>>()
   private lifecycleAbortController: AbortController | null = null
   private stopped = false
@@ -418,6 +446,7 @@ export class SendSession {
     this.peerSelectionMemory = config.peerSelectionMemory ?? new Map()
     this.autoAcceptIncoming = !!config.autoAcceptIncoming
     this.autoSaveIncoming = !!config.autoSaveIncoming
+    this.overwriteIncoming = !!config.overwriteIncoming
     this.reconnectSocket = config.reconnectSocket ?? true
     this.extraTurnServers = turnServers(config.turnUrls ?? [], config.turnUsername, config.turnCredential)
     this.iceServers = [...BASE_ICE_SERVERS, ...this.extraTurnServers]
@@ -460,6 +489,7 @@ export class SendSession {
     this.lifecycleAbortController?.abort()
     this.lifecycleAbortController = typeof AbortController === "function" ? new AbortController() : null
     this.startPeerStatsPolling()
+    this.startPulsePolling()
     void this.loadLocalProfile()
     void this.probePulse()
     this.connectSocket()
@@ -469,6 +499,7 @@ export class SendSession {
   async close() {
     this.stopped = true
     this.stopPeerStatsPolling()
+    this.stopPulsePolling()
     if (this.reconnectTimer) clearTimeout(this.reconnectTimer)
     this.reconnectTimer = null
     this.lifecycleAbortController?.abort()
@@ -763,7 +794,7 @@ export class SendSession {
     if (transfer.savedPath) return transfer.savedPath
     if (!transfer.data && transfer.buffers?.length) transfer.data = Buffer.concat(transfer.buffers)
     if (!transfer.data) return null
-    transfer.savedPath = await saveIncomingFile(this.saveDir, transfer.name, transfer.data)
+    transfer.savedPath = await saveIncomingFile(this.saveDir, transfer.name, transfer.data, this.overwriteIncoming)
     transfer.savedAt ||= Date.now()
     this.emitTransferSaved(transfer)
     this.notify()
@@ -788,8 +819,8 @@ export class SendSession {
   }
 
   private async createIncomingDiskState(fileName: string): Promise<IncomingDiskState> {
-    const finalPath = await uniqueOutputPath(this.saveDir, fileName || "download", this.reservedSavePaths)
-    this.reservedSavePaths.add(finalPath)
+    const finalPath = await incomingOutputPath(this.saveDir, fileName || "download", this.overwriteIncoming, this.reservedSavePaths)
+    if (!this.overwriteIncoming) this.reservedSavePaths.add(finalPath)
     for (let attempt = 0; ; attempt += 1) {
       const tempPath = `${finalPath}.part.${uid(6)}${attempt ? `.${attempt}` : ""}`
       try {
@@ -805,7 +836,7 @@ export class SendSession {
         }
       } catch (error) {
         if ((error as NodeJS.ErrnoException | undefined)?.code === "EEXIST") continue
-        this.reservedSavePaths.delete(finalPath)
+        if (!this.overwriteIncoming) this.reservedSavePaths.delete(finalPath)
         throw error
       }
     }
@@ -875,12 +906,13 @@ export class SendSession {
         disk.closed = true
         await disk.handle.close()
       }
-      if (await pathExists(finalPath)) {
+      if (!this.overwriteIncoming && await pathExists(finalPath)) {
         this.reservedSavePaths.delete(finalPath)
         finalPath = await uniqueOutputPath(this.saveDir, transfer.name || "download", this.reservedSavePaths)
         this.reservedSavePaths.add(finalPath)
       }
-      await rename(disk.tempPath, finalPath)
+      if (this.overwriteIncoming) await replaceOutputPath(disk.tempPath, finalPath)
+      else await rename(disk.tempPath, finalPath)
       transfer.savedPath = finalPath
       transfer.savedAt ||= Date.now()
       return finalPath
@@ -952,6 +984,17 @@ export class SendSession {
     this.peerStatsTimer = null
   }
 
+  private startPulsePolling() {
+    if (this.pulseTimer) return
+    this.pulseTimer = setInterval(() => void this.probePulse(), PULSE_PROBE_INTERVAL_MS)
+  }
+
+  private stopPulsePolling() {
+    if (!this.pulseTimer) return
+    clearInterval(this.pulseTimer)
+    this.pulseTimer = null
+  }
+
   private async refreshPeerStats() {
     if (this.stopped) return
     let dirty = false
@@ -1156,10 +1199,10 @@ export class SendSession {
       const response = await fetch(SIGNAL_PULSE_URL, { cache: "no-store", signal: timeoutSignal(3500, this.lifecycleAbortController?.signal) })
       if (!response.ok) throw new Error(`pulse ${response.status}`)
       if (this.stopped) return
-      this.pulse = { state: "open", at: Date.now(), ms: performance.now() - startedAt, error: "" }
+      this.pulse = { state: "open", lastSettledState: "open", at: Date.now(), ms: performance.now() - startedAt, error: "" }
     } catch (error) {
       if (this.stopped) return
-      this.pulse = { state: "error", at: Date.now(), ms: 0, error: `${error}` }
+      this.pulse = { state: "error", lastSettledState: "error", at: Date.now(), ms: 0, error: `${error}` }
       this.pushLog("pulse:error", { error: `${error}` }, "error")
     }
     if (this.stopped) return

package/src/index.ts

@@ -67,6 +67,7 @@ const TURN_OPTIONS = [
   ["--turn-username <value>", "custom TURN username"],
   ["--turn-credential <value>", "custom TURN credential"],
 ] as const
+const OVERWRITE_OPTION = ["--overwrite", "overwrite same-name saved files instead of creating copies"] as const
 const SAVE_DIR_OPTION = ["--save-dir <dir>", "save directory"] as const
 const TUI_TOGGLE_OPTIONS = [
   ["--clean <0|1>", "show only active peers when 1; show terminal peers too when 0"],
@@ -103,6 +104,7 @@ export const sessionConfigFrom = (options: Record<string, unknown>, defaults: {
     saveDir: resolve(`${options.saveDir ?? process.env.SEND_SAVE_DIR ?? "."}`),
     autoAcceptIncoming: accept ?? defaults.autoAcceptIncoming ?? false,
     autoSaveIncoming: save ?? defaults.autoSaveIncoming ?? false,
+    overwriteIncoming: !!options.overwrite,
     turnUrls: splitList(options.turnUrl ?? process.env.SEND_TURN_URL),
     turnUsername: `${options.turnUsername ?? process.env.SEND_TURN_USERNAME ?? ""}`.trim() || undefined,
     turnCredential: `${options.turnCredential ?? process.env.SEND_TURN_CREDENTIAL ?? ""}`.trim() || undefined,
@@ -302,6 +304,7 @@ export const createCli = (handlers: CliHandlers = defaultCliHandlers) => {
   addOptions(cli.command("accept", "receive and save files"), [
     ...ROOM_SELF_OPTIONS,
     SAVE_DIR_OPTION,
+    OVERWRITE_OPTION,
     ["--once", "exit after the first saved incoming transfer"],
     ["--json", "emit ndjson events"],
     ...TURN_OPTIONS,
@@ -312,6 +315,7 @@ export const createCli = (handlers: CliHandlers = defaultCliHandlers) => {
     ...TUI_TOGGLE_OPTIONS,
     ["--events", "show the event log pane"],
     SAVE_DIR_OPTION,
+    OVERWRITE_OPTION,
     ...TURN_OPTIONS,
   ]).action(handlers.tui)
 

package/src/tui/app.ts

@@ -2,7 +2,7 @@ import { resolve } from "node:path"
 import { BACKEND_RAW_WRITE_MARKER, rgb, ui, type BackendRawWrite, type BadgeVariant, type TextStyle, type UiEvent, type VNode } from "@rezi-ui/core"
 import { createNodeApp } from "@rezi-ui/node"
 import { inspectLocalFile } from "../core/files"
-import { isSessionAbortedError, SendSession, type PeerSnapshot, type SessionConfig, type SessionSnapshot, type TransferSnapshot } from "../core/session"
+import { isSessionAbortedError, SendSession, signalMetricState, 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"
@@ -72,6 +72,7 @@ export interface TuiState {
   autoOfferOutgoing: boolean
   autoAcceptIncoming: boolean
   autoSaveIncoming: boolean
+  overwriteIncoming: boolean
   hideTerminalPeers: boolean
   eventsExpanded: boolean
   offeringDrafts: boolean
@@ -133,8 +134,13 @@ const DEFAULT_SAVE_DIR = resolve(process.cwd())
 const ABOUT_ELEFUNC_URL = "https://rtme.sh/send"
 const ABOUT_TITLE = "About Send"
 const ABOUT_INTRO = "Peer-to-Peer Transfers – Web & CLI"
-const ABOUT_SUMMARY = "Join the same room, see who is there, and offer files directly to selected peers."
-const ABOUT_RUNTIME = "Send uses lightweight signaling to discover peers and negotiate WebRTC. Files move over WebRTC data channels, using direct paths when possible and TURN relay when needed."
+const ABOUT_BULLETS = [
+  "• Join a room, see who is there, and filter or select exactly which peers to target before offering files.",
+  "• File data does not travel through the signaling service; Send uses lightweight signaling to discover peers and negotiate WebRTC, then transfers directly peer-to-peer when possible, with TURN relay when needed.",
+  "• Incoming transfers can be auto-accepted and auto-saved, and same-name files can either stay as numbered copies or overwrite the original when that mode is enabled.",
+  "• The CLI streams incoming saves straight to disk in the current save directory, with overwrite available through the CLI flag.",
+  "• Other features include copyable web and CLI invites, rendered-peer filtering and selection, TURN sharing, and live connection insight like signaling state, RTT, data state, and path labels.",
+] as const
 const COPY_SERVICE_URL = "https://copy.rt.ht/"
 const TRANSFER_DIRECTION_ARROW = {
   out: { glyph: "↗", style: { fg: rgb(170, 217, 76), bold: true } },
@@ -169,7 +175,7 @@ type BunSpawn = (cmd: string[], options: {
   stderr?: "pipe" | "inherit" | "ignore"
 }) => { unref?: () => void }
 type BunLike = { spawn?: BunSpawn }
-type ShareUrlState = Pick<TuiState, "snapshot" | "hideTerminalPeers" | "autoAcceptIncoming" | "autoOfferOutgoing" | "autoSaveIncoming">
+type ShareUrlState = Pick<TuiState, "snapshot" | "hideTerminalPeers" | "autoAcceptIncoming" | "autoOfferOutgoing" | "autoSaveIncoming" | "overwriteIncoming">
 type ShareCliState = ShareUrlState & Pick<TuiState, "sessionSeed" | "eventsExpanded">
 const shellQuote = (value: string) => safeShellArgPattern.test(value) ? value : `'${value.replaceAll("'", `'\"'\"'`)}'`
 const appendCliFlag = (args: string[], flag: string, value?: string | null) => {
@@ -185,10 +191,12 @@ const SHARE_TOGGLE_FLAGS = [
 ] as const satisfies readonly (readonly [string, keyof ShareUrlState, string])[]
 const appendToggleCliFlags = (args: string[], state: ShareUrlState) => {
   for (const [, stateKey, flag] of SHARE_TOGGLE_FLAGS) if (!state[stateKey]) appendCliFlag(args, flag, "0")
+  if (state.overwriteIncoming) args.push("--overwrite")
 }
 const buildHashParams = (state: ShareUrlState, omitDefaults = false) => {
   const params = new URLSearchParams({ room: cleanRoom(state.snapshot.room) })
   for (const [key, stateKey] of SHARE_TOGGLE_FLAGS) if (!omitDefaults || !state[stateKey]) params.set(key, hashBool(state[stateKey]))
+  if (!omitDefaults || state.overwriteIncoming) params.set("overwrite", hashBool(state.overwriteIncoming))
   return params
 }
 const shareTurnCliArgs = (sessionSeed: SessionSeed) => {
@@ -393,7 +401,7 @@ const statusVariant = (status: TransferSnapshot["status"]): BadgeVariant => ({
   cancelling: "warning",
   "awaiting-done": "info",
 }[status] || "default") as BadgeVariant
-const statusToneVariant = (value: string): BadgeVariant => ({
+export const statusToneVariant = (value: string): BadgeVariant => ({
   open: "success",
   connected: "success",
   complete: "success",
@@ -411,6 +419,7 @@ const statusToneVariant = (value: string): BadgeVariant => ({
   pending: "warning",
   cancelling: "warning",
   checking: "warning",
+  degraded: "warning",
   disconnected: "warning",
   left: "warning",
   rejected: "warning",
@@ -730,6 +739,7 @@ export const createInitialTuiState = (initialConfig: SessionConfig, showEvents =
   const sessionSeed = normalizeSessionSeed(initialConfig)
   const autoAcceptIncoming = initialConfig.autoAcceptIncoming ?? true
   const autoSaveIncoming = initialConfig.autoSaveIncoming ?? true
+  const overwriteIncoming = !!initialConfig.overwriteIncoming
   const peerSelectionByRoom = new Map<string, Map<string, boolean>>()
   const session = makeSession(sessionSeed, autoAcceptIncoming, autoSaveIncoming, roomPeerSelectionMemory(peerSelectionByRoom, sessionSeed.room))
   const focusState = deriveBootFocusState(sessionSeed.name)
@@ -753,6 +763,7 @@ export const createInitialTuiState = (initialConfig: SessionConfig, showEvents =
     autoOfferOutgoing: launchOptions.offer ?? true,
     autoAcceptIncoming,
     autoSaveIncoming,
+    overwriteIncoming,
     hideTerminalPeers: launchOptions.clean ?? true,
     eventsExpanded: showEvents,
     offeringDrafts: false,
@@ -854,8 +865,7 @@ const renderAboutModal = (_state: TuiState, actions: TuiActions) => {
   title: ABOUT_TITLE,
   content: ui.column({ gap: 1 }, [
     ui.text(ABOUT_INTRO, { id: "about-intro", variant: "heading", wrap: true }),
-    ui.text(ABOUT_SUMMARY, { id: "about-summary", wrap: true }),
-    ui.text(ABOUT_RUNTIME, { id: "about-runtime", wrap: true }),
+    ...ABOUT_BULLETS.map((line, index) => ui.text(line, { id: `about-bullet-${index + 1}`, wrap: true })),
   ]),
   actions: [
     ui.link({
@@ -957,8 +967,7 @@ const renderSelfCard = (state: TuiState, actions: TuiActions) => denseSection({
     ui.text(`-${state.snapshot.localId}`),
   ]),
   ui.row({ gap: 0, wrap: true }, [
-    renderSelfMetric("Signaling", state.snapshot.socketState),
-    renderSelfMetric("Pulse", state.snapshot.pulse.state),
+    renderSelfMetric("Signaling", signalMetricState(state.snapshot.socketState, state.snapshot.pulse)),
     renderSelfMetric("TURN", state.snapshot.turnState),
   ]),
   ui.column({ gap: 0 }, [
@@ -1000,10 +1009,10 @@ const renderPeerRow = (peer: PeerSnapshot, turnShareEnabled: boolean, actions: T
     ]),
     ui.row({ gap: 0 }, [
       renderPeerMetric("RTT", formatPeerRtt(peer.rttMs)),
-      renderPeerMetric("Data", peer.dataState, true),
+      renderPeerMetric("TURN", peer.turnState, true),
     ]),
     ui.row({ gap: 0 }, [
-      renderPeerMetric("TURN", peer.turnState, true),
+      renderPeerMetric("Data", peer.dataState, true),
       renderPeerMetric("Path", peer.pathLabel || "—"),
     ]),
     ui.column({ gap: 0 }, [
@@ -1141,7 +1150,7 @@ const transferActionButtons = (transfer: TransferSnapshot, actions: TuiActions):
   return []
 }
 
-const renderTransferFact = (label: string, value: string) => ui.box({ minWidth: 12 }, [
+const renderTransferFact = (label: string, value: string) => ui.box({ minWidth: 12, border: "single", borderStyle: METRIC_BORDER_STYLE }, [
   ui.column({ gap: 0 }, [
     ui.text(label, { variant: "caption" }),
     ui.text(value),
@@ -1676,6 +1685,7 @@ export const startTui = async (initialConfig: SessionConfig, launchOptions: TuiL
       filePreview: resetFilePreview(),
       drafts: [],
       offeringDrafts: false,
+      overwriteIncoming: !!nextSeed.overwriteIncoming,
       ...(options.reseedBootFocus
         ? deriveBootFocusState(nextSeed.name, current.focusRequestEpoch + 1)
         : {