@elefunc/send 0.1.1 → 0.1.2

package/README.md

@@ -15,16 +15,21 @@ bun add -g @elefunc/send
 ## Usage
 
 ```bash
+send
 send peers
 send offer ./file.txt
 send accept
 send tui --events
 ```
 
+When no subcommand is provided, `send` launches the TUI by default.
+
 ## Rooms
 
 `--room` is optional on all commands. If you omit it, `send` creates a random room and prints or shows it.
 
+In the TUI, the room row includes a `📋` invite link that opens the equivalent web app URL for the current committed room and toggle state. Set `SEND_WEB_URL` to change its base URL; it defaults to `https://send.rt.ht/`.
+
 ## Self Identity
 
 `--self` accepts three forms:

package/package.json

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

package/src/index.ts

@@ -197,8 +197,23 @@ const tuiCommand = async (options: Record<string, unknown>) => {
   await startTui(initialConfig, !!options.events)
 }
 
-export const createCli = () => {
+type CliHandlers = {
+  peers: typeof peersCommand
+  offer: typeof offerCommand
+  accept: typeof acceptCommand
+  tui: typeof tuiCommand
+}
+
+const defaultCliHandlers: CliHandlers = {
+  peers: peersCommand,
+  offer: offerCommand,
+  accept: acceptCommand,
+  tui: tuiCommand,
+}
+
+export const createCli = (handlers: CliHandlers = defaultCliHandlers) => {
   const cli = cac("send")
+  cli.usage("[command] [options]")
 
   cli
     .command("peers", "list discovered peers")
@@ -210,7 +225,7 @@ export const createCli = () => {
     .option("--turn-url <url>", "custom TURN url, repeat or comma-separate")
     .option("--turn-username <value>", "custom TURN username")
     .option("--turn-credential <value>", "custom TURN credential")
-    .action(peersCommand)
+    .action(handlers.peers)
 
   cli
     .command("offer [...files]", "offer files to browser-compatible peers")
@@ -223,7 +238,7 @@ export const createCli = () => {
     .option("--turn-url <url>", "custom TURN url, repeat or comma-separate")
     .option("--turn-username <value>", "custom TURN username")
     .option("--turn-credential <value>", "custom TURN credential")
-    .action(offerCommand)
+    .action(handlers.offer)
 
   cli
     .command("accept", "receive and save files")
@@ -235,7 +250,7 @@ export const createCli = () => {
     .option("--turn-url <url>", "custom TURN url, repeat or comma-separate")
     .option("--turn-username <value>", "custom TURN username")
     .option("--turn-credential <value>", "custom TURN credential")
-    .action(acceptCommand)
+    .action(handlers.accept)
 
   cli
     .command("tui", "launch the interactive terminal UI")
@@ -246,24 +261,39 @@ export const createCli = () => {
     .option("--turn-url <url>", "custom TURN url, repeat or comma-separate")
     .option("--turn-username <value>", "custom TURN username")
     .option("--turn-credential <value>", "custom TURN credential")
-    .action(tuiCommand)
+    .action(handlers.tui)
 
-  cli.help()
+  cli.help(sections => {
+    const usage = sections.find(section => section.title === "Usage:")
+    if (usage) usage.body = "  $ send [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`).",
+    }
+    if (moreInfoIndex < 0) sections.push(defaultSection)
+    else sections.splice(moreInfoIndex, 0, defaultSection)
+  })
 
   return cli
 }
 
-const ensureKnownCommand = (cli: CAC, argv: string[]) => {
+const explicitCommand = (cli: CAC, argv: string[]) => {
   const command = argv[2]
-  if (!command || command.startsWith("-")) return
-  if (cli.commands.some(entry => entry.isMatched(command))) return
+  if (!command || command.startsWith("-")) return undefined
+  if (cli.commands.some(entry => entry.isMatched(command))) return command
   throw new ExitError(`Unknown command \`${command}\``, 1)
 }
 
-export const runCli = async (argv = process.argv) => {
-  const cli = createCli()
-  ensureKnownCommand(cli, argv)
-  cli.parse(argv, { run: false })
+export const runCli = async (argv = process.argv, handlers: CliHandlers = defaultCliHandlers) => {
+  const cli = createCli(handlers)
+  const command = explicitCommand(cli, argv)
+  const parsed = cli.parse(argv, { run: false }) as { options: Record<string, unknown> }
+  const helpRequested = !!parsed.options.help || !!parsed.options.h
+  if (!command && !helpRequested) {
+    await handlers.tui(parsed.options)
+    return
+  }
   await cli.runMatchedCommand()
 }
 

package/src/tui/app.ts

@@ -97,6 +97,7 @@ const NAME_INPUT_ID = "name-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 DEFAULT_WEB_URL = "https://send.rt.ht/"
 
 const countFormat = new Intl.NumberFormat(undefined, { maximumFractionDigits: 0 })
 const percentFormat = new Intl.NumberFormat(undefined, { maximumFractionDigits: 0 })
@@ -107,6 +108,32 @@ export const visiblePanes = (showEvents: boolean): VisiblePane[] => showEvents ?
 
 const noop = () => {}
 
+const hashBool = (value: boolean) => value ? "1" : "0"
+
+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 webInviteUrl = (
+  state: Pick<TuiState, "snapshot" | "hideTerminalPeers" | "autoAcceptIncoming" | "autoOfferOutgoing" | "autoSaveIncoming">,
+  baseUrl = resolveWebUrlBase(),
+) => {
+  const url = new URL(baseUrl)
+  url.hash = new URLSearchParams({
+    room: cleanRoom(state.snapshot.room),
+    clean: hashBool(state.hideTerminalPeers),
+    accept: hashBool(state.autoAcceptIncoming),
+    offer: hashBool(state.autoOfferOutgoing),
+    save: hashBool(state.autoSaveIncoming),
+  }).toString()
+  return url.toString()
+}
+
 export const createNoopTuiActions = (): TuiActions => ({
   toggleEvents: noop,
   jumpToRandomRoom: noop,
@@ -505,6 +532,14 @@ const renderRoomCard = (state: TuiState, actions: TuiActions) => denseSection({
         onBlur: actions.commitRoom,
       }),
     ]),
+    ui.row({ id: "room-invite-slot", width: 6, justify: "center", items: "center" }, [
+      ui.link({
+        id: "room-invite-link",
+        label: "📋",
+        accessibleLabel: "Open invite link",
+        url: webInviteUrl(state),
+      }),
+    ]),
   ]),
 ])