refactor(api): move debug functionality to utils module

Relocate debugplus integration from main mod file to utils.lua
for better organization and add section headers for clarity.

Author: S1M0N38

balatrobot.lua

@@ -13,24 +13,10 @@ BALATRO_BOT_CONFIG = {
   -- max_fps = nil,
 }
 
--- Load debug
-local success, dpAPI = pcall(require, "debugplus-api")
-
 -- Load minimal required files
 assert(SMODS.load_file("src/lua/utils.lua"))()
 assert(SMODS.load_file("src/lua/api.lua"))()
 
-if success and dpAPI.isVersionCompatible(1) then
-  local debugplus = dpAPI.registerID("balatrobot")
-  debugplus.addCommand({
-    name = "env",
-    shortDesc = "Get game state",
-    desc = "Get the current game state, useful for debugging",
-    exec = function(args, _, _)
-      debugplus.logger.log('{"name": "' .. args[1] .. '", "G": ' .. utils.table_to_json(G.GAME, 2) .. "}")
-    end,
-  })
-end
 
 -- Initialize API
 API.init()

src/lua/utils.lua

@@ -2,6 +2,10 @@
 utils = {}
 local json = require("json")
 
+-- ==========================================================================
+-- Game State Extraction
+-- ==========================================================================
+
 ---Extracts the current game state including game info, hand, and jokers
 ---@return GameStateResponse The complete game state
 function utils.get_game_state()
@@ -65,6 +69,10 @@ function utils.get_game_state()
   }
 end
 
+-- ==========================================================================
+-- Debugging Utilities
+-- ==========================================================================
+
 ---Converts a Lua table to JSON string with depth limiting to prevent infinite recursion
 ---@param obj any The object to convert to JSON
 ---@param depth? number Maximum depth to traverse (default: 3)
@@ -103,4 +111,19 @@ function utils.table_to_json(obj, depth)
   return json.encode(sanitized)
 end
 
+-- Load debug
+local success, dpAPI = pcall(require, "debugplus-api")
+
+if success and dpAPI.isVersionCompatible(1) then
+  local debugplus = dpAPI.registerID("balatrobot")
+  debugplus.addCommand({
+    name = "env",
+    shortDesc = "Get game state",
+    desc = "Get the current game state, useful for debugging",
+    exec = function(args, _, _)
+      debugplus.logger.log('{"name": "' .. args[1] .. '", "G": ' .. utils.table_to_json(G.GAME, 2) .. "}")
+    end,
+  })
+end
+
 return utils