first commit

internal/config/config.go

@@ -0,0 +1,44 @@
+package config
+
+import (
+	"log"
+	"os"
+	"time"
+
+	"github.com/ilyakaznacheev/cleanenv"
+)
+
+type ConfigConf struct {
+	Mode       string `yaml:"mode" env-default:"dev"`
+	ComDir     string `yaml:"com_dir" env-default:"./com/"`
+	HTTPServer `yaml:"http_server"`
+}
+
+type HTTPServer struct {
+	Address     string        `yaml:"address" env-default:"0.0.0.0:8080"`
+	Timeout     time.Duration `yaml:"timeout" env-default:"5s"`
+	IdleTimeout time.Duration `yaml:"idle_timeout" env-default:"60s"`
+}
+
+type ConfigEnv struct {
+	ConfigPath string `env:"CONFIG_PATH" env-default:"./config/config.yaml"`
+}
+
+func MustLoadConfig() *ConfigConf {
+	var configEnv ConfigEnv
+	if err := cleanenv.ReadEnv(&configEnv); err != nil {
+		log.Fatalf("Failed to read environment variables: %v", err)
+		os.Exit(1)
+	}
+	if _, err := os.Stat(configEnv.ConfigPath); os.IsNotExist(err) {
+		log.Fatalf("Config file does not exist: %s", configEnv.ConfigPath)
+		os.Exit(2)
+	}
+	var config ConfigConf
+	if err := cleanenv.ReadConfig(configEnv.ConfigPath, &config); err != nil {
+		log.Fatalf("Failed to read config file: %v", err)
+		os.Exit(3)
+	}
+	log.Printf("Configuration loaded successfully from %s", configEnv.ConfigPath)
+	return &config
+}

internal/logs/logger.go

@@ -0,0 +1,25 @@
+package logs
+
+import (
+	"log/slog"
+	"os"
+)
+
+const (
+	envDev  = "dev"
+	envProd = "prod"
+)
+
+func SetupLogger(env string) *slog.Logger {
+	var log *slog.Logger
+	switch env {
+	case envDev:
+		log = slog.New(slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{Level: slog.LevelDebug}))
+	case envProd:
+		log = slog.New(slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{Level: slog.LevelInfo}))
+	default:
+		log = slog.New(slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{Level: slog.LevelDebug}))
+	}
+
+	return log
+}

internal/server/v1/go.mod

@@ -0,0 +1,14 @@
+module server_v1
+
+go 1.24.4
+
+require (
+	github.com/go-chi/chi/v5 v5.2.2
+	github.com/yuin/gopher-lua v1.1.1
+)
+
+require (
+	github.com/gorilla/websocket v1.5.3 // indirect
+	gopkg.in/yaml.v3 v3.0.1 // indirect
+	olympos.io/encoding/edn v0.0.0-20201019073823-d3554ca0b0a3 // indirect
+)

internal/server/v1/go.sum

@@ -0,0 +1,13 @@
+github.com/go-chi/chi v1.5.5 h1:vOB/HbEMt9QqBqErz07QehcOKHaWFtuj87tTDVz2qXE=
+github.com/go-chi/chi v1.5.5/go.mod h1:C9JqLr3tIYjDOZpzn+BCuxY8z8vmca43EeMgyZt7irw=
+github.com/go-chi/chi/v5 v5.2.2 h1:CMwsvRVTbXVytCk1Wd72Zy1LAsAh9GxMmSNWLHCG618=
+github.com/go-chi/chi/v5 v5.2.2/go.mod h1:L2yAIGWB3H+phAw1NxKwWM+7eUH/lU8pOMm5hHcoops=
+github.com/gorilla/websocket v1.5.3 h1:saDtZ6Pbx/0u+bgYQ3q96pZgCzfhKXGPqt7kZ72aNNg=
+github.com/gorilla/websocket v1.5.3/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE=
+github.com/yuin/gopher-lua v1.1.1 h1:kYKnWBjvbNP4XLT3+bPEwAXJx262OhaHDWDVOPjL46M=
+github.com/yuin/gopher-lua v1.1.1/go.mod h1:GBR0iDaNXjAgGg9zfCvksxSRnQx76gclCIb7kdAd1Pw=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
+olympos.io/encoding/edn v0.0.0-20201019073823-d3554ca0b0a3 h1:slmdOY3vp8a7KQbHkL+FLbvbkgMqmXojpFUO/jENuqQ=
+olympos.io/encoding/edn v0.0.0-20201019073823-d3554ca0b0a3/go.mod h1:oVgVk4OWVDi43qWBEyGhXgYxt7+ED4iYNpTngSLX2Iw=

internal/server/v1/handle_com.go

@@ -0,0 +1,92 @@
+package server_v1
+
+import (
+	"encoding/json"
+	"log/slog"
+	"net/http"
+	"os"
+	"path/filepath"
+
+	"github.com/go-chi/chi/v5"
+	lua "github.com/yuin/gopher-lua"
+)
+
+func (h *HandlerV1) _handle() {
+	uuid16 := newUUID()
+	_log.Info("Received request", slog.String("version", "v1"), slog.String("connection-uuid", uuid16), slog.String("remote", h.r.RemoteAddr), slog.String("method", h.r.Method), slog.String("url", h.r.URL.String()))
+
+	cmd := chi.URLParam(h.r, "cmd")
+	if !allowedCmd.MatchString(string([]rune(cmd)[0])) {
+		writeJSONError(h.w, http.StatusBadRequest, "invalid command")
+		_log.Error("HTTP request error", slog.String("connection-uuid", uuid16), slog.String("error", "invalid command"), slog.String("cmd", cmd), slog.Int("status", http.StatusBadRequest))
+		return
+	}
+	if !listAllowedCmd.MatchString(cmd) {
+		writeJSONError(h.w, http.StatusBadRequest, "invalid command")
+		_log.Error("HTTP request error", slog.String("connection-uuid", uuid16), slog.String("error", "invalid command"), slog.String("cmd", cmd), slog.Int("status", http.StatusBadRequest))
+		return
+	}
+	scriptPath := filepath.Join(cfg.ComDir, cmd+".lua")
+	if _, err := os.Stat(scriptPath); err != nil {
+		writeJSONError(h.w, http.StatusNotFound, "command not found")
+		_log.Error("HTTP request error", slog.String("connection-uuid", uuid16), slog.String("error", "command not found"), slog.String("cmd", cmd), slog.Int("status", http.StatusNotFound))
+		return
+	}
+
+	L := lua.NewState()
+	defer L.Close()
+
+	L.OpenLibs() // loads base, io, os, string, math, table, debug, package, coroutine, channel… :contentReference[oaicite:0]{index=0}
+
+	qt := h.r.URL.Query()
+	tbl := L.NewTable()
+	for k, v := range qt {
+		if len(v) > 0 {
+			L.SetField(tbl, k, lua.LString(v[0]))
+		}
+	}
+	L.SetGlobal("Params", tbl)
+	L.SetGlobal("Result", L.NewTable())
+
+	L.DoString(`
+		print = function() end
+		io.write = function(...) end
+		io.stdout = function() return nil end
+		io.stderr = function() return nil end
+		io.read = function(...) return nil end
+	`)
+
+	if err := L.DoFile(scriptPath); err != nil {
+		writeJSONError(h.w, http.StatusInternalServerError, "lua error: "+err.Error())
+		_log.Error("Failed to execute lua script", slog.String("connection-uuid", uuid16), slog.String("error", err.Error()))
+		return
+	}
+
+	out := make(map[string]any)
+	if rt := L.GetGlobal("Result"); rt.Type() == lua.LTTable {
+		rt.(*lua.LTable).ForEach(func(k, v lua.LValue) {
+			switch v.Type() {
+			case lua.LTString:
+				out[k.String()] = v.String()
+			case lua.LTNumber:
+				out[k.String()] = float64(v.(lua.LNumber))
+			case lua.LTBool:
+				out[k.String()] = bool(v.(lua.LBool))
+			default:
+				out[k.String()] = v.String()
+			}
+		})
+	}
+
+	w.Header().Set("Content-Type", "application/json")
+	json.NewEncoder(h.w).Encode(out)
+	switch out["status"] {
+	case "error":
+		_log.Info("Command executed with error", slog.String("connection-uuid", uuid16), slog.String("cmd", cmd), slog.Any("result", out))
+	case "ok":
+		_log.Info("Command executed successfully", slog.String("connection-uuid", uuid16), slog.String("cmd", cmd), slog.Any("result", out))
+	default:
+		_log.Info("Command executed and returned an unknown status", slog.String("connection-uuid", uuid16), slog.String("cmd", cmd), slog.Any("result", out))
+	}
+	_log.Info("Session completed", slog.String("connection-uuid", uuid16), slog.String("remote", h.r.RemoteAddr), slog.String("method", h.r.Method), slog.String("url", h.r.URL.String()))
+}

internal/server/v1/handle_list.go

@@ -0,0 +1,54 @@
+package server_v1
+
+import (
+	"encoding/json"
+	"log/slog"
+	"net/http"
+	"os"
+	"path/filepath"
+	_ "github.com/go-chi/chi/v5"
+)
+
+func (h *HandlerV1) _handleList() {
+	uuid16 := newUUID()
+	_log.Info("Received request", slog.String("version", "v1"), slog.String("connection-uuid", uuid16), slog.String("remote", r.RemoteAddr), slog.String("method", r.Method), slog.String("url", r.URL.String()))
+	type ComMeta struct {
+		Description string
+	}
+	var (
+		files    []os.DirEntry
+		err      error
+		com      ComMeta
+		commands = make(map[string]ComMeta)
+	)
+
+	if files, err = os.ReadDir(cfg.ComDir); err != nil {
+		writeJSONError(w, http.StatusInternalServerError, "failed to read commands directory: "+err.Error())
+		_log.Error("Failed to read commands directory", slog.String("error", err.Error()))
+		return
+	}
+	for _, file := range files {
+		if file.IsDir() || filepath.Ext(file.Name()) != ".lua" {
+			continue
+		}
+		cmdName := file.Name()[:len(file.Name())-4] // remove .lua extension
+		if !allowedCmd.MatchString(string([]rune(cmdName)[0])) {
+			continue
+		}
+		if !listAllowedCmd.MatchString(cmdName) {
+			continue
+		}
+		if com.Description, err = extractDescriptionStatic(filepath.Join(cfg.ComDir, file.Name())); err != nil {
+			writeJSONError(w, http.StatusInternalServerError, "failed to read command: "+err.Error())
+			log.Error("Failed to read command", slog.String("error", err.Error()))
+			return
+		}
+		if com.Description == "" {
+			com.Description = "description missing"
+		}
+		commands[cmdName] = ComMeta{Description: com.Description}
+	}
+	json.NewEncoder(w).Encode(commands)
+	_log.Info("Command executed successfully", slog.String("connection-uuid", uuid16))
+	_log.Info("Session completed", slog.String("connection-uuid", uuid16), slog.String("remote", r.RemoteAddr), slog.String("method", r.Method), slog.String("url", r.URL.String()))
+}

internal/server/v1/server.go

@@ -0,0 +1,73 @@
+package server_v1
+
+import (
+	"encoding/json"
+	"log/slog"
+	"net/http"
+	"os"
+	"regexp"
+
+	"GoSally-mvp/internal/config"
+)
+
+type ServerV1Contract interface {
+	Handle(w http.ResponseWriter, r *http.Request)
+	HandleList(w http.ResponseWriter, r *http.Request)
+
+	_handle()
+	_handleList()
+}
+
+type HandlerV1 struct {
+	w http.ResponseWriter
+	r *http.Request
+
+	_log slog.Logger
+
+	cfg *config.ConfigConf
+
+	allowedCmd *regexp.Regexp
+	listAllowedCmd *regexp.Regexp
+}
+
+func (h *HandlerV1) Handle(w http.ResponseWriter, r *http.Request) {
+	h.w = w
+	h.r = r
+	h._handle()
+}
+
+func (h *HandlerV1) HandleList(w http.ResponseWriter, r *http.Request) {
+	h.w = w
+	h.r = r
+	h._handleList()
+}
+
+func errNotFound(w http.ResponseWriter, r *http.Request) {
+	writeJSONError(w, http.StatusBadRequest, "invalid request")
+	_log.Error("HTTP request error", slog.String("remote", r.RemoteAddr), slog.String("method", r.Method), slog.String("url", r.URL.String()), slog.Int("status", http.StatusBadRequest))
+}
+
+func writeJSONError(w http.ResponseWriter, status int, msg string) {
+	w.Header().Set("Content-Type", "application/json")
+	w.WriteHeader(status)
+	resp := map[string]interface{}{
+		"status": "error",
+		"error":  msg,
+		"code":   status,
+	}
+	json.NewEncoder(w).Encode(resp)
+}
+
+func extractDescriptionStatic(path string) (string, error) {
+	data, err := os.ReadFile(path)
+	if err != nil {
+		return "", err
+	}
+
+	re := regexp.MustCompile(`---\s*#description\s*=\s*"([^"]+)"`)
+	m := re.FindStringSubmatch(string(data))
+	if len(m) <= 0 {
+		return "", nil
+	}
+	return m[1], nil
+}