@elefunc/send 0.1.19 → 0.1.20

package/README.md

@@ -35,12 +35,12 @@ In the TUI, the room row includes a `📋` invite link that opens the equivalent
 `--self` accepts three forms:
 
 - `name`
-- `name-ID`
-- `-ID` using the attached CLI form `--self=-ab12cd34`
+- `name-id`
+- `-id` using the attached CLI form `--self=-ab12cd34`
 
 `SEND_SELF` supports the same raw values, including `SEND_SELF=-ab12cd34`.
 
-The ID suffix must be exactly 8 lowercase alphanumeric characters.
+The `id` suffix must be exactly 8 lowercase alphanumeric characters.
 
 ## Examples
 

package/package.json

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

package/src/core/invite.ts

@@ -0,0 +1,148 @@
+import { resolve } from "node:path"
+import { cleanRoom } from "./protocol"
+
+export const DEFAULT_WEB_URL = "https://rtme.sh/"
+export const COPY_SERVICE_URL = "https://copy.rt.ht/"
+
+export type ShareUrlOptions = {
+  room: string
+  clean?: boolean
+  accept?: boolean
+  offer?: boolean
+  save?: boolean
+  overwrite?: boolean
+}
+
+export type ShareCliCommandOptions = ShareUrlOptions & {
+  self?: string
+  events?: boolean
+  saveDir?: string
+  defaultSaveDir?: string
+  turnUrls?: readonly (string | null | undefined)[]
+  turnUsername?: string
+  turnCredential?: string
+}
+
+export type JoinOutputKind = "offer" | "accept"
+
+const hashBool = (value: boolean) => value ? "1" : "0"
+const safeShellArgPattern = /^[A-Za-z0-9._/:?=&,+@%-]+$/
+
+const normalizeShareUrlOptions = (options: ShareUrlOptions) => ({
+  room: cleanRoom(options.room),
+  clean: options.clean ?? true,
+  accept: options.accept ?? true,
+  offer: options.offer ?? true,
+  save: options.save ?? true,
+  overwrite: options.overwrite ?? false,
+})
+
+const shellQuote = (value: string) => safeShellArgPattern.test(value) ? value : `'${value.replaceAll("'", `'\"'\"'`)}'`
+
+export const appendCliFlag = (args: string[], flag: string, value?: string | null) => {
+  const text = `${value ?? ""}`.trim()
+  if (!text) return
+  args.push(flag, shellQuote(text))
+}
+
+export const appendToggleCliFlags = (args: string[], options: ShareUrlOptions) => {
+  const normalized = normalizeShareUrlOptions(options)
+  if (!normalized.clean) appendCliFlag(args, "--clean", "0")
+  if (!normalized.accept) appendCliFlag(args, "--accept", "0")
+  if (!normalized.offer) appendCliFlag(args, "--offer", "0")
+  if (!normalized.save) appendCliFlag(args, "--save", "0")
+  if (normalized.overwrite) args.push("--overwrite")
+}
+
+const buildHashParams = (options: ShareUrlOptions, omitDefaults = false) => {
+  const normalized = normalizeShareUrlOptions(options)
+  const params = new URLSearchParams({ room: normalized.room })
+  if (!omitDefaults || !normalized.clean) params.set("clean", hashBool(normalized.clean))
+  if (!omitDefaults || !normalized.accept) params.set("accept", hashBool(normalized.accept))
+  if (!omitDefaults || !normalized.offer) params.set("offer", hashBool(normalized.offer))
+  if (!omitDefaults || !normalized.save) params.set("save", hashBool(normalized.save))
+  if (!omitDefaults || normalized.overwrite) params.set("overwrite", hashBool(normalized.overwrite))
+  return params
+}
+
+export const resolveWebUrlBase = (value = process.env.SEND_WEB_URL) => {
+  const candidate = `${value ?? ""}`.trim() || DEFAULT_WEB_URL
+  try {
+    return new URL(candidate).toString()
+  } catch {
+    return DEFAULT_WEB_URL
+  }
+}
+
+export const renderWebUrl = (options: ShareUrlOptions, baseUrl = DEFAULT_WEB_URL, omitDefaults = true) => {
+  const url = new URL(baseUrl)
+  url.hash = buildHashParams(options, omitDefaults).toString()
+  return url.toString()
+}
+
+export const schemeLessUrlText = (text: string) => text.replace(/^[a-z]+:\/\//, "")
+
+export const webInviteUrl = (options: ShareUrlOptions, baseUrl = resolveWebUrlBase()) => renderWebUrl(options, baseUrl)
+
+export const inviteWebLabel = (options: ShareUrlOptions, baseUrl = resolveWebUrlBase()) => schemeLessUrlText(webInviteUrl(options, baseUrl))
+
+export const inviteCliPackageName = (baseUrl = resolveWebUrlBase()) => new URL(resolveWebUrlBase(baseUrl)).hostname
+
+export const inviteCliCommand = (options: ShareUrlOptions) => {
+  const normalized = normalizeShareUrlOptions(options)
+  const args: string[] = []
+  appendCliFlag(args, "--room", normalized.room)
+  appendToggleCliFlags(args, normalized)
+  return args.join(" ")
+}
+
+export const inviteCliText = (options: ShareUrlOptions, baseUrl = resolveWebUrlBase()) => `bunx ${inviteCliPackageName(baseUrl)} ${inviteCliCommand(options)}`
+
+export const inviteCopyUrl = (text: string) => `${COPY_SERVICE_URL}#${new URLSearchParams({ text })}`
+
+export const shareTurnCliArgs = (options: Pick<ShareCliCommandOptions, "turnUrls" | "turnUsername" | "turnCredential">) => {
+  const turnUrls = [...new Set((options.turnUrls ?? []).map(url => `${url ?? ""}`.trim()).filter(Boolean))]
+  if (!turnUrls.length) return []
+  const args: string[] = []
+  for (const turnUrl of turnUrls) appendCliFlag(args, "--turn-url", turnUrl)
+  appendCliFlag(args, "--turn-username", options.turnUsername)
+  appendCliFlag(args, "--turn-credential", options.turnCredential)
+  return args
+}
+
+export const renderCliCommand = (
+  options: ShareCliCommandOptions,
+  { includeSelf = false, includePrefix = false, packageName }: { includeSelf?: boolean; includePrefix?: boolean; packageName?: string } = {},
+) => {
+  const normalized = normalizeShareUrlOptions(options)
+  const args = includePrefix ? ["bunx", packageName || inviteCliPackageName(DEFAULT_WEB_URL)] : []
+  appendCliFlag(args, "--room", normalized.room)
+  if (includeSelf) appendCliFlag(args, "--self", options.self)
+  appendToggleCliFlags(args, normalized)
+  if (options.events) args.push("--events")
+  if (options.saveDir && (!options.defaultSaveDir || resolve(options.saveDir) !== options.defaultSaveDir)) appendCliFlag(args, "--save-dir", options.saveDir)
+  args.push(...shareTurnCliArgs(options))
+  return args.join(" ")
+}
+
+const joinCliLabel = (kind: JoinOutputKind) => kind === "offer" ? "CLI (receive and save):" : "CLI (append file paths at the end):"
+
+const joinCliCommand = (kind: JoinOutputKind, room: string, baseUrl = resolveWebUrlBase()) => {
+  const prefix = `bunx ${inviteCliPackageName(baseUrl)}`
+  const roomArgs = inviteCliCommand({ room })
+  return kind === "offer" ? `${prefix} accept ${roomArgs}` : `${prefix} offer ${roomArgs}`
+}
+
+export const joinOutputLines = (kind: JoinOutputKind, room: string, baseUrl = resolveWebUrlBase()) => [
+  "Join with:",
+  "",
+  "Web (open in browser):",
+  webInviteUrl({ room }, baseUrl),
+  "",
+  joinCliLabel(kind),
+  joinCliCommand(kind, room, baseUrl),
+  "",
+  "TUI (interactive terminal UI):",
+  inviteCliText({ room }, baseUrl),
+  "",
+]

package/src/core/targeting.ts

@@ -1,4 +1,4 @@
-import { cleanName, displayPeerName } from "./protocol"
+import { cleanText, displayPeerName } from "./protocol"
 
 export interface TargetPeer {
   id: string
@@ -16,23 +16,29 @@ export interface ResolveTargetsResult {
 const BROADCAST_SELECTOR = "."
 
 const uniquePeers = (peers: TargetPeer[]) => [...new Map(peers.map(peer => [peer.id, peer])).values()]
-
-const matchesSelector = (peer: TargetPeer, selector: string) => selector === peer.id || selector === displayPeerName(peer.name, peer.id) || selector === cleanName(peer.name)
+const normalizeName = (value: unknown) => cleanText(value, 24).toLowerCase().replace(/[^a-z0-9]+/g, "").slice(0, 24)
+const parseSelector = (selector: string) => {
+  const hyphen = selector.lastIndexOf("-")
+  return hyphen < 0
+    ? { raw: selector, kind: "name" as const, value: normalizeName(selector) }
+    : { raw: selector, kind: "id" as const, value: selector.slice(hyphen + 1) }
+}
+const matchesSelector = (peer: TargetPeer, selector: ReturnType<typeof parseSelector>) =>
+  selector.kind === "name" ? normalizeName(peer.name) === selector.value : peer.id === selector.value
 
 export const resolvePeerTargets = (peers: TargetPeer[], selectors: string[]): ResolveTargetsResult => {
   const active = peers.filter(peer => peer.presence === "active")
-  const ready = active.filter(peer => peer.ready)
   const requested = [...new Set(selectors.filter(Boolean))]
   const normalized = requested.length ? requested : [BROADCAST_SELECTOR]
   if (normalized.includes(BROADCAST_SELECTOR)) {
     if (normalized.length > 1) return { ok: false, peers: [], error: "broadcast selector `.` cannot be combined with specific peers" }
+    const ready = active.filter(peer => peer.ready)
     return ready.length ? { ok: true, peers: ready } : { ok: false, peers: [], error: "no ready peers" }
   }
-  const matches = uniquePeers(active.filter(peer => normalized.some(selector => matchesSelector(peer, selector))))
-  if (matches.length !== normalized.length) {
-    const missing = normalized.filter(selector => !matches.some(peer => matchesSelector(peer, selector)))
-    return { ok: false, peers: [], error: `no matching peer for ${missing.join(", ")}` }
-  }
+  const parsed = normalized.map(parseSelector)
+  const missing = parsed.filter(selector => !active.some(peer => matchesSelector(peer, selector))).map(selector => selector.raw)
+  if (missing.length) return { ok: false, peers: [], error: `no matching peer for ${missing.join(", ")}` }
+  const matches = uniquePeers(active.flatMap(peer => parsed.some(selector => matchesSelector(peer, selector)) ? [peer] : []))
   const notReady = matches.filter(peer => !peer.ready)
   if (notReady.length) return { ok: false, peers: [], error: `peer not ready: ${notReady.map(peer => displayPeerName(peer.name, peer.id)).join(", ")}` }
   return { ok: true, peers: matches }

package/src/index.ts

@@ -1,6 +1,7 @@
 #!/usr/bin/env bun
 import { resolve } from "node:path"
 import { cac, type CAC } from "cac"
+import { joinOutputLines, type JoinOutputKind } from "./core/invite"
 import { cleanRoom, displayPeerName } from "./core/protocol"
 import type { SendSession, SessionConfig, SessionEvent } from "./core/session"
 import { resolvePeerTargets } from "./core/targeting"
@@ -55,8 +56,8 @@ const parseBinaryOptions = <K extends BinaryOptionKey>(options: Record<string, u
 
 const SELF_ID_LENGTH = 8
 const SELF_ID_PATTERN = new RegExp(`^[a-z0-9]{${SELF_ID_LENGTH}}$`)
-const SELF_HELP_TEXT = "self identity: name, name-ID, or -ID (use --self=-ID)"
-const INVALID_SELF_ID_MESSAGE = `--self ID suffix must be exactly ${SELF_ID_LENGTH} lowercase alphanumeric characters`
+const SELF_HELP_TEXT = "self identity: `name`, `name-id`, or `-id`"
+const INVALID_SELF_ID_MESSAGE = `--self id suffix must be exactly ${SELF_ID_LENGTH} lowercase alphanumeric characters`
 type CliCommand = ReturnType<CAC["command"]>
 const ROOM_SELF_OPTIONS = [
   ["--room <room>", "room id; omit to create a random room"],
@@ -78,6 +79,14 @@ const TUI_TOGGLE_OPTIONS = [
 export const ACCEPT_SESSION_DEFAULTS = { autoAcceptIncoming: true, autoSaveIncoming: true } as const
 const addOptions = (command: CliCommand, definitions: readonly (readonly [string, string])[]) =>
   definitions.reduce((next, [flag, description]) => next.option(flag, description), command)
+const withTrailingHelpLine = <T extends { outputHelp: () => void }>(target: T) => {
+  const outputHelp = target.outputHelp.bind(target)
+  target.outputHelp = () => {
+    outputHelp()
+    console.info("")
+  }
+  return target
+}
 
 const requireSelfId = (value: string) => {
   if (!SELF_ID_PATTERN.test(value)) throw new ExitError(INVALID_SELF_ID_MESSAGE, 1)
@@ -116,6 +125,16 @@ export const roomAnnouncement = (room: string, self: string, json = false) =>
 
 const printRoomAnnouncement = (room: string, self: string, json = false) => console.log(roomAnnouncement(room, self, json))
 
+export const commandAnnouncement = (kind: JoinOutputKind, room: string, self: string, json = false) =>
+  json ? roomAnnouncement(room, self, true) : [roomAnnouncement(room, self), "", ...joinOutputLines(kind, room)].join("\n")
+
+const printCommandAnnouncement = (kind: JoinOutputKind, room: string, self: string, json = false) => console.log(commandAnnouncement(kind, room, self, json))
+export const readyStatusLine = (room: string, json = false) => json ? "" : `ready in ${room}`
+const printReadyStatus = (room: string, json = false) => {
+  const line = readyStatusLine(room, json)
+  if (line) console.log(line)
+}
+
 const printEvent = (event: SessionEvent) => console.log(JSON.stringify(event))
 
 const attachReporter = (session: SendSession, json = false) => {
@@ -222,9 +241,10 @@ const offerCommand = async (files: string[], options: Record<string, unknown>) =
   const { SendSession } = await loadSessionRuntime()
   const session = new SendSession(sessionConfigFrom(options, {}))
   handleSignals(session)
-  printRoomAnnouncement(session.room, displayPeerName(session.name, session.localId), !!options.json)
+  printCommandAnnouncement("offer", session.room, displayPeerName(session.name, session.localId), !!options.json)
   const detachReporter = attachReporter(session, !!options.json)
   await session.connect()
+  printReadyStatus(session.room, !!options.json)
   const targets = await waitForTargets(session, selectors, timeoutMs)
   const transferIds = await session.queueFiles(files, targets.map(peer => peer.id))
   const results = await waitForFinalTransfers(session, transferIds)
@@ -238,10 +258,10 @@ const acceptCommand = async (options: Record<string, unknown>) => {
   const { SendSession } = await loadSessionRuntime()
   const session = new SendSession(sessionConfigFrom(options, ACCEPT_SESSION_DEFAULTS))
   handleSignals(session)
-  printRoomAnnouncement(session.room, displayPeerName(session.name, session.localId), !!options.json)
+  printCommandAnnouncement("accept", session.room, displayPeerName(session.name, session.localId), !!options.json)
   const detachReporter = attachReporter(session, !!options.json)
   await session.connect()
-  if (!options.json) console.log(`listening in ${session.room}`)
+  printReadyStatus(session.room, !!options.json)
   if (options.once) {
     for (;;) {
       const saved = session.snapshot().transfers.find(transfer => transfer.direction === "in" && transfer.savedAt > 0)
@@ -280,73 +300,96 @@ const defaultCliHandlers: CliHandlers = {
   tui: tuiCommand,
 }
 
+const fileNamePart = (value: string) => value.replace(/^.*[\\/]/, "") || value
+const HELP_NAME_COLOR = "\x1b[38;5;214m"
+const HELP_NAME_RESET = "\x1b[0m"
+const colorCliHelpName = (value: string) => `${HELP_NAME_COLOR}${value}${HELP_NAME_RESET}`
+const cliHelpPlainName = () => process.env.SEND_NAME?.trim() || fileNamePart(Bun.main)
+const cliHelpDisplayName = () => {
+  const name = cliHelpPlainName()
+  if (!process.stdout.isTTY) return name
+  return process.env.SEND_NAME_COLORED?.trim() || colorCliHelpName(name)
+}
+
 export const createCli = (handlers: CliHandlers = defaultCliHandlers) => {
-  const cli = cac("send")
+  const name = cliHelpDisplayName()
+  const cli = cac(name)
   cli.usage("[command] [options]")
 
-  addOptions(cli.command("peers", "list discovered peers"), [
+  withTrailingHelpLine(addOptions(cli.command("peers", "list discovered peers"), [
     ...ROOM_SELF_OPTIONS,
     ["--wait <ms>", "discovery wait in milliseconds"],
     ["--json", "print a json snapshot"],
     SAVE_DIR_OPTION,
     ...TURN_OPTIONS,
-  ]).action(handlers.peers)
+  ])).action(handlers.peers)
 
-  addOptions(cli.command("offer [...files]", "offer files to browser-compatible peers"), [
+  withTrailingHelpLine(addOptions(cli.command("offer [...files]", "offer files to browser-compatible peers"), [
     ...ROOM_SELF_OPTIONS,
-    ["--to <peer>", "target peer id or name-suffix, or `.` for all ready peers; default: `.`"],
+    ["--to <peer>", "target `name`, `name-id`, or `-id`; `.` targets all ready peers by default"],
     ["--wait-peer <ms>", "wait for eligible peers in milliseconds; omit to wait indefinitely"],
     ["--json", "emit ndjson events"],
     SAVE_DIR_OPTION,
     ...TURN_OPTIONS,
-  ]).action(handlers.offer)
+  ])).action(handlers.offer)
 
-  addOptions(cli.command("accept", "receive and save files"), [
+  withTrailingHelpLine(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,
-  ]).action(handlers.accept)
+  ])).action(handlers.accept)
 
-  addOptions(cli.command("tui", "launch the interactive terminal UI"), [
+  withTrailingHelpLine(addOptions(cli.command("tui", "launch the interactive terminal UI"), [
     ...ROOM_SELF_OPTIONS,
     ...TUI_TOGGLE_OPTIONS,
     ["--events", "show the event log pane"],
     SAVE_DIR_OPTION,
     OVERWRITE_OPTION,
     ...TURN_OPTIONS,
-  ]).action(handlers.tui)
+  ])).action(handlers.tui)
 
   cli.help(sections => {
     const usage = sections.find(section => section.title === "Usage:")
-    if (usage) usage.body = "  $ send [command] [options]"
+    if (usage) usage.body = `  $ ${name} [command] [options]`
     const moreInfoIndex = sections.findIndex(section => section.title?.startsWith("For more info"))
     const defaultSection = {
       title: "Default",
-      body: "  send with no command launches the terminal UI (same as `send tui`).",
+      body: `  ${name} with no command launches the terminal UI (same as \`${name} tui\`).`,
     }
     if (moreInfoIndex < 0) sections.push(defaultSection)
     else sections.splice(moreInfoIndex, 0, defaultSection)
   })
+  withTrailingHelpLine(cli.globalCommand)
 
   return cli
 }
 
-const explicitCommand = (cli: CAC, argv: string[]) => {
-  const command = argv[2]
-  if (!command || command.startsWith("-")) return undefined
-  if (cli.commands.some(entry => entry.isMatched(command))) return command
-  throw new ExitError(`Unknown command \`${command}\``, 1)
+const argvPrefix = (argv: string[]) => [argv[0] ?? process.argv[0] ?? "bun", argv[1] ?? process.argv[1] ?? cliHelpPlainName()]
+const printSubcommandHelp = (argv: string[], handlers: CliHandlers, subcommand: string) =>
+  void createCli(handlers).parse([...argvPrefix(argv), subcommand, "--help"], { run: false })
+
+const explicitCommand = (argv: string[], handlers: CliHandlers) => {
+  const cli = createCli(handlers)
+  cli.showHelpOnExit = false
+  cli.parse(argv, { run: false })
+  if (cli.matchedCommandName) return cli.matchedCommandName
+  if (cli.args[0]) throw new ExitError(`Unknown command \`${cli.args[0]}\``, 1)
+  return undefined
 }
 
 export const runCli = async (argv = process.argv, handlers: CliHandlers = defaultCliHandlers) => {
   const cli = createCli(handlers)
-  const command = explicitCommand(cli, argv)
+  const command = explicitCommand(argv, handlers)
   const parsed = cli.parse(argv, { run: false }) as { options: Record<string, unknown> }
   const helpRequested = !!parsed.options.help || !!parsed.options.h
-  if (!command && !helpRequested) {
+  if (!command) {
+    if (helpRequested) {
+      printSubcommandHelp(argv, handlers, "tui")
+      return
+    }
     await handlers.tui(parsed.options)
     return
   }

package/src/tui/app.ts

@@ -2,6 +2,19 @@ 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 {
+  DEFAULT_WEB_URL,
+  inviteCliCommand as formatInviteCliCommand,
+  inviteCliPackageName as formatInviteCliPackageName,
+  inviteCliText as formatInviteCliText,
+  inviteCopyUrl as formatInviteCopyUrl,
+  inviteWebLabel as formatInviteWebLabel,
+  renderCliCommand as renderSharedCliCommand,
+  renderWebUrl,
+  resolveWebUrlBase as resolveSharedWebUrlBase,
+  schemeLessUrlText,
+  webInviteUrl as formatWebInviteUrl,
+} from "../core/invite"
 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"
@@ -87,6 +100,7 @@ export interface TuiActions {
   closeInviteDropdown: TuiAction
   copyWebInvite: TuiAction
   copyCliInvite: TuiAction
+  copyLogs: TuiAction
   jumpToRandomRoom: TuiAction
   commitRoom: TuiAction
   setRoomInput: (value: string) => void
@@ -129,7 +143,6 @@ 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 MUTED_TEXT_STYLE = { fg: rgb(159, 166, 178) } as const
-const DEFAULT_WEB_URL = "https://rtme.sh/"
 const DEFAULT_SAVE_DIR = resolve(process.cwd())
 const ABOUT_ELEFUNC_URL = "https://rtme.sh/send"
 const ABOUT_TITLE = "About Send"
@@ -141,7 +154,6 @@ const ABOUT_BULLETS = [
   "• 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 } },
   in: { glyph: "↙", style: { fg: rgb(240, 113, 120), bold: true } },
@@ -160,8 +172,6 @@ export const isEditableFocusId = (focusedId: string | null) =>
   focusedId === ROOM_INPUT_ID || focusedId === NAME_INPUT_ID || focusedId === PEER_SEARCH_INPUT_ID || focusedId === DRAFT_INPUT_ID
 export const shouldSwallowQQuit = (focusedId: string | null) => !isEditableFocusId(focusedId)
 
-const hashBool = (value: boolean) => value ? "1" : "0"
-const safeShellArgPattern = /^[A-Za-z0-9._/:?=&,+@%-]+$/
 const TUI_QUIT_SIGNALS = ["SIGINT", "SIGTERM", "SIGHUP"] as const
 type TuiQuitSignal = (typeof TUI_QUIT_SIGNALS)[number]
 type ProcessSignalLike = {
@@ -177,63 +187,30 @@ type BunSpawn = (cmd: string[], options: {
 type BunLike = { spawn?: BunSpawn }
 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) => {
-  const text = `${value ?? ""}`.trim()
-  if (!text) return
-  args.push(flag, shellQuote(text))
-}
-const SHARE_TOGGLE_FLAGS = [
-  ["clean", "hideTerminalPeers", "--clean"],
-  ["accept", "autoAcceptIncoming", "--accept"],
-  ["offer", "autoOfferOutgoing", "--offer"],
-  ["save", "autoSaveIncoming", "--save"],
-] 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) => {
-  const turnUrls = [...new Set((sessionSeed.turnUrls ?? []).map(url => `${url ?? ""}`.trim()).filter(Boolean))]
-  if (!turnUrls.length) return []
-  const args: string[] = []
-  for (const turnUrl of turnUrls) appendCliFlag(args, "--turn-url", turnUrl)
-  appendCliFlag(args, "--turn-username", sessionSeed.turnUsername)
-  appendCliFlag(args, "--turn-credential", sessionSeed.turnCredential)
-  return args
-}
-
-export const resolveWebUrlBase = (value = process.env.SEND_WEB_URL) => {
-  const candidate = `${value ?? ""}`.trim() || DEFAULT_WEB_URL
-  try {
-    return new URL(candidate).toString()
-  } catch {
-    return DEFAULT_WEB_URL
-  }
-}
-
-const renderWebUrl = (state: ShareUrlState, baseUrl = DEFAULT_WEB_URL, omitDefaults = true) => {
-  const url = new URL(baseUrl)
-  url.hash = buildHashParams(state, omitDefaults).toString()
-  return url.toString()
-}
-const schemeLessUrlText = (text: string) => text.replace(/^[a-z]+:\/\//, "")
-export const inviteWebLabel = (state: ShareUrlState, baseUrl = resolveWebUrlBase()) => schemeLessUrlText(webInviteUrl(state, baseUrl))
-export const inviteCliPackageName = (baseUrl = resolveWebUrlBase()) => new URL(resolveWebUrlBase(baseUrl)).hostname
-export const inviteCliCommand = (state: ShareUrlState) => {
-  const args: string[] = []
-  appendCliFlag(args, "--room", state.snapshot.room)
-  appendToggleCliFlags(args, state)
-  return args.join(" ")
-}
-export const inviteCliText = (state: ShareUrlState, baseUrl = resolveWebUrlBase()) => `bunx ${inviteCliPackageName(baseUrl)} ${inviteCliCommand(state)}`
-export const inviteCopyUrl = (text: string) => `${COPY_SERVICE_URL}#${new URLSearchParams({ text })}`
+const shareUrlOptions = (state: ShareUrlState) => ({
+  room: cleanRoom(state.snapshot.room),
+  clean: state.hideTerminalPeers,
+  accept: state.autoAcceptIncoming,
+  offer: state.autoOfferOutgoing,
+  save: state.autoSaveIncoming,
+  overwrite: state.overwriteIncoming,
+})
+const shareCliOptions = (state: ShareCliState) => ({
+  ...shareUrlOptions(state),
+  self: displayPeerName(state.snapshot.name, state.snapshot.localId),
+  events: state.eventsExpanded,
+  saveDir: state.snapshot.saveDir,
+  defaultSaveDir: DEFAULT_SAVE_DIR,
+  turnUrls: state.sessionSeed.turnUrls,
+  turnUsername: state.sessionSeed.turnUsername,
+  turnCredential: state.sessionSeed.turnCredential,
+})
+export const resolveWebUrlBase = (value = process.env.SEND_WEB_URL) => resolveSharedWebUrlBase(value)
+export const inviteWebLabel = (state: ShareUrlState, baseUrl = resolveWebUrlBase()) => formatInviteWebLabel(shareUrlOptions(state), baseUrl)
+export const inviteCliPackageName = (baseUrl = resolveWebUrlBase()) => formatInviteCliPackageName(baseUrl)
+export const inviteCliCommand = (state: ShareUrlState) => formatInviteCliCommand(shareUrlOptions(state))
+export const inviteCliText = (state: ShareUrlState, baseUrl = resolveWebUrlBase()) => formatInviteCliText(shareUrlOptions(state), baseUrl)
+export const inviteCopyUrl = (text: string) => formatInviteCopyUrl(text)
 export const buildOsc52ClipboardSequence = (text: string) => text ? `\u001b]52;c;${Buffer.from(text).toString("base64")}\u0007` : ""
 export const externalOpenCommand = (url: string, platform = process.platform) =>
   platform === "darwin" ? ["open", url]
@@ -244,30 +221,17 @@ const getBackendRawWriter = (backend: unknown): BackendRawWrite | null => {
   return typeof marker === "function" ? marker as BackendRawWrite : null
 }
 const getBunRuntime = () => (globalThis as typeof globalThis & { Bun?: BunLike }).Bun ?? null
-const renderCliCommand = (state: ShareCliState, { includeSelf = false, includePrefix = false } = {}) => {
-  const args = includePrefix ? ["bunx", "rtme.sh"] : []
-  appendCliFlag(args, "--room", state.snapshot.room)
-  if (includeSelf) appendCliFlag(args, "--self", displayPeerName(state.snapshot.name, state.snapshot.localId))
-  appendToggleCliFlags(args, state)
-  if (state.eventsExpanded) args.push("--events")
-  if (resolve(state.snapshot.saveDir) !== DEFAULT_SAVE_DIR) appendCliFlag(args, "--save-dir", state.snapshot.saveDir)
-  args.push(...shareTurnCliArgs(state.sessionSeed))
-  return args.join(" ")
-}
-
-export const webInviteUrl = (state: ShareUrlState, baseUrl = resolveWebUrlBase()) => {
-  return renderWebUrl(state, baseUrl)
-}
+export const webInviteUrl = (state: ShareUrlState, baseUrl = resolveWebUrlBase()) => formatWebInviteUrl(shareUrlOptions(state), baseUrl)
 
-export const aboutWebUrl = (state: ShareUrlState, baseUrl = DEFAULT_WEB_URL) => renderWebUrl(state, baseUrl)
+export const aboutWebUrl = (state: ShareUrlState, baseUrl = DEFAULT_WEB_URL) => renderWebUrl(shareUrlOptions(state), baseUrl)
 
-export const aboutWebLabel = (state: ShareUrlState, baseUrl = DEFAULT_WEB_URL) => aboutWebUrl(state, baseUrl).replace(/^https:\/\//, "")
+export const aboutWebLabel = (state: ShareUrlState, baseUrl = DEFAULT_WEB_URL) => schemeLessUrlText(aboutWebUrl(state, baseUrl))
 
-export const aboutCliCommand = (state: ShareCliState) => renderCliCommand(state)
+export const aboutCliCommand = (state: ShareCliState) => renderSharedCliCommand(shareCliOptions(state))
 
-export const resumeWebUrl = (state: ShareUrlState, baseUrl = DEFAULT_WEB_URL) => renderWebUrl(state, baseUrl)
+export const resumeWebUrl = (state: ShareUrlState, baseUrl = DEFAULT_WEB_URL) => renderWebUrl(shareUrlOptions(state), baseUrl)
 
-export const resumeCliCommand = (state: ShareCliState) => renderCliCommand(state, { includeSelf: true, includePrefix: true })
+export const resumeCliCommand = (state: ShareCliState) => renderSharedCliCommand(shareCliOptions(state), { includeSelf: true, includePrefix: true, packageName: "rtme.sh" })
 
 export const resumeOutputLines = (state: ShareCliState) => [
   "Rejoin with:",
@@ -312,6 +276,7 @@ export const createNoopTuiActions = (): TuiActions => ({
   closeInviteDropdown: noop,
   copyWebInvite: noop,
   copyCliInvite: noop,
+  copyLogs: noop,
   jumpToRandomRoom: noop,
   commitRoom: noop,
   setRoomInput: noop,
@@ -347,6 +312,15 @@ const shortText = (value: unknown, max = 88) => {
   const text = typeof value === "string" ? value : JSON.stringify(value)
   return text.length <= max ? text : `${text.slice(0, Math.max(0, max - 1))}…`
 }
+const formatLogPayloadText = (payload: unknown) => {
+  if (typeof payload === "string") return payload
+  try {
+    return JSON.stringify(payload, null, 2) ?? `${payload}`
+  } catch {
+    return `${payload}`
+  }
+}
+export const formatLogsForCopy = (logs: readonly LogEntry[]) => logs.map(log => `${timeFormat.format(log.at)} ${log.kind}\n${formatLogPayloadText(log.payload)}`).join("\n\n")
 const toggleIntent = (active: boolean) => active ? "success" : "secondary"
 const statusKind = (socketState: SessionSnapshot["socketState"]) => socketState === "open" ? "online" : socketState === "connecting" ? "busy" : socketState === "error" ? "offline" : "away"
 const peerConnectionStatusKind = (status: string) => ({
@@ -1276,8 +1250,8 @@ const renderEventsCard = (state: TuiState, actions: TuiActions) => denseSection(
   id: "events-card",
   title: "Events",
   actions: [
+    actionButton("copy-events", "Copy", actions.copyLogs, "secondary", !state.snapshot.logs.length),
     actionButton("clear-events", "Clear", actions.clearLogs, "warning", !state.snapshot.logs.length),
-    actionButton("hide-events", "Hide", actions.toggleEvents),
   ],
 }, [
   ui.box({ maxHeight: 24, overflow: "scroll" }, [
@@ -1394,23 +1368,30 @@ export const startTui = async (initialConfig: SessionConfig, launchOptions: TuiL
       return false
     }
   }
-  const copyInvitePayload = async (payload: string, label: "WEB" | "CLI") => {
-    const closeDropdown = (notice: Notice) => commit(current => withNotice({ ...current, inviteDropdownOpen: false }, notice))
+  const copyTextPayload = async (payload: string, notices: { copied: string; opened: string; failed: string }, finish = (notice: Notice) => commit(current => withNotice(current, notice))) => {
     const rawWrite = getBackendRawWriter(app.backend)
     if (rawWrite && await ensureOsc52Support()) {
       const sequence = buildOsc52ClipboardSequence(payload)
       if (sequence) {
         try {
           rawWrite(sequence)
-          closeDropdown({ text: `Copied ${label} invite.`, variant: "success" })
+          finish({ text: notices.copied, variant: "success" })
           return
         } catch {}
       }
     }
     const opened = openExternalUrl(inviteCopyUrl(payload))
-    closeDropdown(opened
-      ? { text: `Opened ${label} copy link.`, variant: "info" }
-      : { text: `Unable to copy ${label} invite.`, variant: "error" })
+    finish(opened
+      ? { text: notices.opened, variant: "info" }
+      : { text: notices.failed, variant: "error" })
+  }
+  const copyInvitePayload = async (payload: string, label: "WEB" | "CLI") => {
+    const closeDropdown = (notice: Notice) => commit(current => withNotice({ ...current, inviteDropdownOpen: false }, notice))
+    await copyTextPayload(payload, {
+      copied: `Copied ${label} invite.`,
+      opened: `Opened ${label} copy link.`,
+      failed: `Unable to copy ${label} invite.`,
+    }, closeDropdown)
   }
 
   const flushUpdate = () => {
@@ -1761,6 +1742,15 @@ export const startTui = async (initialConfig: SessionConfig, launchOptions: TuiL
     closeInviteDropdown: () => commit(current => current.inviteDropdownOpen ? { ...current, inviteDropdownOpen: false } : current),
     copyWebInvite: () => { void copyInvitePayload(webInviteUrl(state), "WEB") },
     copyCliInvite: () => { void copyInvitePayload(inviteCliText(state), "CLI") },
+    copyLogs: () => {
+      const payload = formatLogsForCopy(state.snapshot.logs)
+      if (!payload) return
+      void copyTextPayload(payload, {
+        copied: "Copied events.",
+        opened: "Opened event copy link.",
+        failed: "Unable to copy events.",
+      })
+    },
     jumpToRandomRoom: () => replaceSession({ ...state.sessionSeed, room: uid(8) }, "Joined a new room."),
     commitRoom,
     setRoomInput: value => commit(current => ({ ...current, roomInput: value })),

package/src/types/bun-runtime.d.ts

@@ -1,5 +1,6 @@
 declare const Bun: {
   file(path: string): Blob & { type: string }
+  main: string
   write(path: string, data: string | Blob | ArrayBuffer | ArrayBufferView): Promise<number>
   sleep(ms: number): Promise<void>
 }