Rename replay → initChannelState

Rename the query parameter, function, and all related comments
from 'replay' to 'initChannelState' to better reflect the
semantics: the server initializes channel state for the
reconnecting client rather than replaying past events.

internal/handlers/api.go

@@ -444,10 +444,11 @@ func (hdlr *Handlers) enqueueNumeric(
 }
 
 // HandleState returns the current session's info and
-// 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.
+// 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.
 func (hdlr *Handlers) HandleState() http.HandlerFunc {
 	return func(
 		writer http.ResponseWriter,
@@ -475,8 +476,8 @@ func (hdlr *Handlers) HandleState() http.HandlerFunc {
 			return
 		}
 
-		if request.URL.Query().Get("replay") == "1" {
-			hdlr.replayChannelState(
+		if request.URL.Query().Get("initChannelState") == "1" {
+			hdlr.initChannelState(
 				request, clientID, sessionID, nick,
 			)
 		}
@@ -489,12 +490,12 @@ func (hdlr *Handlers) HandleState() http.HandlerFunc {
 	}
 }
 
-// replayChannelState enqueues synthetic JOIN messages and
+// initChannelState 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) replayChannelState(
+func (hdlr *Handlers) initChannelState(
 	request *http.Request,
 	clientID, sessionID int64,
 	nick string,
@@ -516,7 +517,7 @@ func (hdlr *Handlers) replayChannelState(
 			)
 		if insErr != nil {
 			hdlr.log.Error(
-				"replay: insert JOIN",
+				"initChannelState: insert JOIN",
 				"error", insErr,
 			)