Merge branch 'main' into fix/spa-reconnect-channel-tabs

When a client reconnects to an existing session (e.g. browser tab
closed and reopened), the server now enqueues synthetic JOIN messages
plus TOPIC/NAMES numerics for every channel the session belongs to.
These are delivered only to the reconnecting client, not broadcast
to other users.

Server changes:
- Add replayChannelState() to handlers that enqueues per-channel
  JOIN + join-numerics (332/353/366) to a specific client.
- HandleState accepts ?replay=1 query parameter to trigger replay.
- HandleLogin (password auth) also replays channel state for the
  new client since it creates a fresh client for an existing session.

SPA changes:
- On resume, call /state?replay=1 instead of /state so the server
  enqueues channel state into the message queue.
- processMessage now creates channel tabs when receiving a JOIN
  where msg.from matches the current nick (handles both live joins
  and replayed joins on reconnect).
- onLogin no longer re-sends JOIN commands for saved channels on
  resume — the server handles it via the replay mechanism, avoiding
  spurious JOIN broadcasts to other channel members.

Closes #60

README.md

@@ -1036,7 +1036,7 @@ Return the current user's session state.
 
 | Parameter | Type   | Default | Description |
 |-----------|--------|---------|-------------|
-| `initChannelState` | string | (none)  | When set to `1`, enqueues synthetic JOIN + TOPIC + NAMES messages for every channel the session belongs to into the calling client's queue. Used by the SPA on reconnect to restore channel tabs without re-sending JOIN commands. |
+| `replay`  | string | (none)  | When set to `1`, enqueues synthetic JOIN + TOPIC + NAMES messages for every channel the session belongs to into the calling client's queue. Used by the SPA on reconnect to restore channel tabs without re-sending JOIN commands. |
 
 **Response:** `200 OK`
 ```json
@@ -1070,9 +1070,9 @@ curl -s http://localhost:8080/api/v1/state \
   -H "Authorization: Bearer $TOKEN" | jq .
 ```
 
-**Reconnect with channel state init:**
+**Reconnect with channel replay:**
 ```bash
-curl -s "http://localhost:8080/api/v1/state?initChannelState=1" \
+curl -s "http://localhost:8080/api/v1/state?replay=1" \
   -H "Authorization: Bearer $TOKEN" | jq .
 ```
 

internal/handlers/api.go

@@ -444,11 +444,10 @@ func (hdlr *Handlers) enqueueNumeric(
 }
 
 // HandleState returns the current session's info and
-// channels.  When called with ?initChannelState=1, it also
-// enqueues synthetic JOIN + TOPIC + NAMES messages for every
-// channel the session belongs to so that a reconnecting
-// client can rebuild its channel tabs from the message
-// stream.
+// channels.  When called with ?replay=1, it also enqueues
+// synthetic JOIN + TOPIC + NAMES messages for every channel
+// the session belongs to so that a reconnecting client can
+// rebuild its channel tabs from the message stream.
 func (hdlr *Handlers) HandleState() http.HandlerFunc {
 	return func(
 		writer http.ResponseWriter,
@@ -476,8 +475,8 @@ func (hdlr *Handlers) HandleState() http.HandlerFunc {
 			return
 		}
 
-		if request.URL.Query().Get("initChannelState") == "1" {
-			hdlr.initChannelState(
+		if request.URL.Query().Get("replay") == "1" {
+			hdlr.replayChannelState(
 				request, clientID, sessionID, nick,
 			)
 		}
@@ -490,12 +489,12 @@ func (hdlr *Handlers) HandleState() http.HandlerFunc {
 	}
 }
 
-// initChannelState enqueues synthetic JOIN messages and
+// replayChannelState enqueues synthetic JOIN messages and
 // join-numerics (TOPIC, NAMES) for every channel the
 // session belongs to.  Messages are enqueued only to the
 // specified client so other clients/sessions are not
 // affected.
-func (hdlr *Handlers) initChannelState(
+func (hdlr *Handlers) replayChannelState(
 	request *http.Request,
 	clientID, sessionID int64,
 	nick string,
@@ -517,7 +516,7 @@ func (hdlr *Handlers) initChannelState(
 			)
 		if insErr != nil {
 			hdlr.log.Error(
-				"initChannelState: insert JOIN",
+				"replay: insert JOIN",
 				"error", insErr,
 			)
 

internal/handlers/auth.go

@@ -182,9 +182,9 @@ func (hdlr *Handlers) handleLogin(
 		request, clientID, sessionID, payload.Nick,
 	)
 
-	// Init channel state so the new client knows which
+	// Replay channel state so the new client knows which
 	// channels the session already belongs to.
-	hdlr.initChannelState(
+	hdlr.replayChannelState(
 		request, clientID, sessionID, payload.Nick,
 	)
 

web/src/app.jsx

@@ -70,7 +70,7 @@ function LoginScreen({ onLogin }) {
       .catch(() => {});
     const saved = localStorage.getItem("neoirc_token");
     if (saved) {
-      api("/state?initChannelState=1")
+      api("/state?replay=1")
         .then((u) => onLogin(u.nick, true))
         .catch(() => localStorage.removeItem("neoirc_token"));
     }
@@ -335,7 +335,7 @@ function App() {
           if (msg.to) addMessage(msg.to, { ...base, text, system: true });
           if (msg.to && msg.to.startsWith("#")) {
             // Create a tab when the current user joins a channel
-            // (including initial JOINs on reconnect).
+            // (including replayed JOINs on reconnect).
             if (msg.from === nickRef.current) {
               setTabs((prev) => {
                 if (
@@ -656,8 +656,8 @@ function App() {
       if (isResumed) {
         // Request MOTD on resumed sessions (new sessions
         // get it automatically from the server during
-        // creation).  Channel state is initialised by the
-        // server via the message queue (?initChannelState=1), so we
+        // creation).  Channel state is replayed by the
+        // server via the message queue (?replay=1), so we
         // do not need to re-JOIN channels here.
         try {
           await api("/messages", {