platform: modularize api/gui, add docs-tests-web foundation, and refresh root config

selective-vpn-api/app/transport_tokens_state_clients.go

@@ -0,0 +1,50 @@
+package app
+
+import (
+	"encoding/json"
+	"os"
+	"path/filepath"
+	"time"
+)
+
+func loadTransportClientsState() transportClientsState {
+	st := transportClientsState{Version: transportStateVersion}
+	data, err := os.ReadFile(transportClientsStatePath)
+	if err != nil {
+		return st
+	}
+	if err := json.Unmarshal(data, &st); err != nil {
+		return transportClientsState{Version: transportStateVersion}
+	}
+	if st.Version == 0 {
+		st.Version = transportStateVersion
+	}
+	if st.Items == nil {
+		st.Items = nil
+	}
+	norm, changed := normalizeTransportClientsState(st, false)
+	if changed {
+		_ = saveTransportClientsState(norm)
+	}
+	return norm
+}
+
+func saveTransportClientsState(st transportClientsState) error {
+	norm, _ := normalizeTransportClientsState(st, false)
+	st = norm
+	st.Version = transportStateVersion
+	st.UpdatedAt = time.Now().UTC().Format(time.RFC3339)
+
+	data, err := json.MarshalIndent(st, "", "  ")
+	if err != nil {
+		return err
+	}
+	if err := os.MkdirAll(filepath.Dir(transportClientsStatePath), 0o755); err != nil {
+		return err
+	}
+	tmp := transportClientsStatePath + ".tmp"
+	if err := os.WriteFile(tmp, data, 0o644); err != nil {
+		return err
+	}
+	return os.Rename(tmp, transportClientsStatePath)
+}