Add game clock commands, command completions and Cyrene login tooling

internal/sdkserver/api_game_clock.go

@@ -0,0 +1,48 @@
+package sdkserver
+
+import (
+	"fmt"
+	"gac-hkrpg-go/internal/common"
+	"net/http"
+	"strconv"
+	"strings"
+	"time"
+)
+
+func apiFakeTimeCommand(w http.ResponseWriter, cmd string) {
+	parts := strings.Fields(cmd)
+	usage := "Usage: /faketime [status | off | <Unix seconds> | <RFC3339 date with timezone>]. Time keeps advancing. Reopen the guide after the next heartbeat; relogin if it caches schedules."
+	var now time.Time
+	var err error
+	arg := strings.TrimSpace(strings.TrimPrefix(cmd, parts[0]))
+	switch strings.ToLower(arg) {
+	case "", "status":
+		now, err = common.GameTime()
+	case "off", "reset", "real":
+		now, err = common.SetGameTime(nil)
+	default:
+		var target time.Time
+		if seconds, e := strconv.ParseInt(arg, 10, 64); e == nil {
+			if seconds < 0 || seconds > 253402300799 {
+				err = fmt.Errorf("Unix seconds outside supported calendar range")
+			} else {
+				target = time.Unix(seconds, 0)
+			}
+		} else {
+			target, err = time.Parse(time.RFC3339, arg)
+		}
+		if err == nil {
+			now, err = common.SetGameTime(&target)
+		}
+	}
+	if err != nil {
+		writeJSON(w, map[string]any{"success": false, "output": err.Error() + "\n" + usage})
+		return
+	}
+	state, err := common.ReadGameClock()
+	if err != nil {
+		writeJSON(w, map[string]any{"success": false, "output": err.Error()})
+		return
+	}
+	writeJSON(w, map[string]any{"success": true, "command": cmd, "game_time": now.UTC().Format(time.RFC3339), "unix_seconds": now.Unix(), "offset_ms": state.OffsetMS, "output": fmt.Sprintf("Game time: %s (offset %d ms). %s", now.UTC().Format(time.RFC3339), state.OffsetMS, usage)})
+}