stdout-chat 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to `stdout-chat` (the CLI). Dates are release dates.
 
+## [0.4.1] — 2026-09-20
+
+### What's New
+
+- Your own line shows up once. Hitting Enter used to leave `> hi` on screen and then the feed printed `in  dmitrii  hi` right under it — two copies of everything you said, while the app showed one. Now the typed line is wiped the moment you submit and the feed's copy (with its id, ready for `/r`) is the only one. If the post fails (`slow down · retry in 2s`, revoked key), the line comes back dim above the error so you can see what did not go out — ↑ still recalls it.
+
+### Technical
+
+- `lib/ui.js`: `eraseSubmitted(line)` — cursor up + clear for every row the echoed `> line` took (`ceil((prompt + line) / columns)`), then column 0. Must run synchronously from `onLine`, before any await: readline has just written the newline, so the row above the cursor is exactly the echo; the next `print`/`prompt(true)` re-draws the prompt as usual.
+- `lib/session.js`: `echoesViaStream(line)` — true for plain text and `/r|/reply <id> text`, false for commands, `/r` usage and unknown slashes (the server's 422 keeps its `> /dance` context). `post(text, reply, { unsent })`: on failure prints `> <unsent>` via `info` (dim) before the error; `handleInput` passes the raw line for posts and replies only.
+- `bin/stdout-chat.js`: `onLine` calls `ui.eraseSubmitted(line)` when `echoesViaStream(line)`, then `handleInput`.
+- Tests: 96 → 99 (erase sequences for one row and a wrapped line; `echoesViaStream` table; failed post restores the line, a failed command does not).
+
 ## [0.4.0] — 2026-09-20
 
 ### What's New

package/bin/stdout-chat.js

@@ -5,7 +5,7 @@ import process from 'node:process';
 import { createApi, DEFAULT_API, errorMessage } from '../lib/api.js';
 import { loadConfig } from '../lib/config.js';
 import { createUI } from '../lib/ui.js';
-import { Session, SLASH_HINT } from '../lib/session.js';
+import { Session, SLASH_HINT, echoesViaStream } from '../lib/session.js';
 import { complete } from '../lib/complete.js';
 import { renderError, renderInfo } from '../lib/render.js';
 import { createNotifier } from '../lib/notify.js';
@@ -178,6 +178,9 @@ async function main() {
   if (mode === 'interactive') {
     ui.start({
       onLine: async (line) => {
+        // Synchronous, before any await: the row above the cursor is still
+        // the echoed input. Its rendering arrives over the stream instead.
+        if (echoesViaStream(line)) ui.eraseSubmitted(line);
         try {
           await session.handleInput(line);
         } catch (err) {

package/lib/session.js

@@ -12,6 +12,19 @@ import { NOTIFY_LEVELS } from './notify.js';
 export const HINT_NO_KEY = 'type /key sc_… to post · get it in the app: /key';
 // Printed once above the prompt when a line starts with `/` (see lib/ui.js).
 export const SLASH_HINT = 'commands · /help · /r <id> text · /dm <nick|sid> · /top · /who · /key · /notify · /clear · /quit';
+
+/**
+ * True for input whose rendering comes back over the stream (a post, or a
+ * `/r <id> text` reply): the typed line is erased on submit so the feed shows
+ * the message once. Commands (`/top`, `/key …`, unknown slashes the server
+ * answers with 422) keep their `> /cmd` line as context.
+ */
+export function echoesViaStream(raw) {
+  const line = String(raw == null ? '' : raw).trim();
+  if (!line) return false;
+  if (line[0] !== '/') return true;
+  return /^\/(r|reply)\s+\S+\s+\S/.test(line);
+}
 export const HELP_TEXT = [
   '/help              this list',
   '/r <id> text       reply to a line (ids are the dim column on the left)',
@@ -293,7 +306,7 @@ export class Session {
   async handleInput(raw) {
     const line = String(raw == null ? '' : raw).trim();
     if (!line) return;
-    if (line[0] !== '/') { await this.post(line); return; }
+    if (line[0] !== '/') { await this.post(line, null, { unsent: line }); return; }
     const cmd = line.split(/\s+/, 1)[0].toLowerCase();
     const rest = line.slice(cmd.length).trim();
     switch (cmd) {
@@ -324,7 +337,7 @@ export class Session {
       case '/r': case '/reply': {
         const m = rest.match(/^(\S+)\s+([\s\S]+)$/);
         if (!m) { this.info('usage: /r <id> text'); return; }
-        await this.post(m[2].trim(), m[1]);
+        await this.post(m[2].trim(), m[1], { unsent: line });
         return;
       }
       default:
@@ -332,12 +345,19 @@ export class Session {
     }
   }
 
-  async post(text, reply = null) {
+  /**
+   * `unsent` is the raw input line to put back (dim, with its prompt) when the
+   * post fails: the UI erased the typed line on submit for lines that echo via
+   * the stream (see `echoesViaStream`), so an error alone would leave "slow
+   * down · retry in 2s" with nothing above it to retry.
+   */
+  async post(text, reply = null, { unsent = null } = {}) {
     if (!this.key) { this.info(HINT_NO_KEY); return false; }
     try {
       await this.api.post({ text, reply }, this.key); // echo arrives via SSE, not from the response
       return true;
     } catch (err) {
+      if (unsent) this.info(`> ${unsent}`);
       this.error(errorMessage(err));
       return false;
     }

package/lib/ui.js

@@ -67,6 +67,25 @@ export function createUI({ input = process.stdin, output = process.stdout, promp
     if (rl) rl.prompt(true);
   }
 
+  /**
+   * Erase the line the user just submitted (readline has already echoed
+   * `> text` and moved to a fresh row). Call it synchronously from `onLine`,
+   * before anything else prints — the row above the cursor is then exactly
+   * that echo. A long input that wrapped takes several rows; all of them go.
+   * Used for lines whose real rendering comes back over the stream, so the
+   * feed shows a message once, not "> hi" and then "in  dmitrii  hi".
+   */
+  function eraseSubmitted(line) {
+    if (!rl) return;
+    const cols = Math.max(1, output.columns || 80);
+    const rows = Math.max(1, Math.ceil((prompt.length + String(line == null ? '' : line).length) / cols));
+    for (let i = 0; i < rows; i++) {
+      readline.moveCursor(output, 0, -1);
+      readline.clearLine(output, 0);
+    }
+    readline.cursorTo(output, 0);
+  }
+
   /** Remove entries matching `pred` from the in-memory input history (e.g. `/key sc_…`). */
   function scrubHistory(pred) {
     if (rl && Array.isArray(rl.history)) rl.history = rl.history.filter((h) => !pred(h));
@@ -77,6 +96,7 @@ export function createUI({ input = process.stdin, output = process.stdout, promp
     start,
     close,
     clear,
+    eraseSubmitted,
     scrubHistory,
     get interactive() { return rl !== null; },
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stdout-chat",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "#void from your terminal — read, tail and post to stdout.chat's public room. Zero dependencies.",
   "type": "module",
   "bin": {