@muhammedaksam/easiarr 0.3.1 → 0.3.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@muhammedaksam/easiarr",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "TUI tool for generating docker-compose files for the *arr media ecosystem with 41 apps, TRaSH Guides best practices, VPN routing, and Traefik reverse proxy support",
   "module": "src/index.ts",
   "type": "module",
@@ -35,6 +35,7 @@
   ],
   "scripts": {
     "dev": "bun run --watch src/index.ts",
+    "dev:debug": "bun run dev --debug",
     "build": "bun build src/index.ts --outdir dist --target bun",
     "typecheck": "bun x tsc --noEmit",
     "lint": "eslint src/",

package/src/api/arr-api.ts

@@ -3,6 +3,8 @@
  * Interacts with Radarr, Sonarr, Lidarr, Readarr, Whisparr APIs
  */
 
+import { debugLog } from "../utils/debug"
+
 // Types for Root Folder API
 export interface RootFolder {
   id?: number
@@ -124,16 +126,24 @@ export class ArrApiClient {
       ...options.headers,
     }
 
+    debugLog("ArrAPI", `${options.method || "GET"} ${url}`)
+    if (options.body) {
+      debugLog("ArrAPI", `Request Body: ${options.body}`)
+    }
+
     const response = await fetch(url, { ...options, headers })
+    const text = await response.text()
+
+    debugLog("ArrAPI", `Response ${response.status} from ${endpoint}`)
+    if (text && text.length < 2000) {
+      debugLog("ArrAPI", `Response Body: ${text}`)
+    }
 
     if (!response.ok) {
-      throw new Error(`API request failed: ${response.status} ${response.statusText}`)
+      throw new Error(`API request failed: ${response.status} ${response.statusText} - ${text}`)
     }
 
-    // Handle empty responses (DELETE returns empty body)
-    const text = await response.text()
     if (!text) return {} as T
-
     return JSON.parse(text) as T
   }
 

package/src/api/prowlarr-api.ts

@@ -3,6 +3,8 @@
  * Manages Indexer Proxies, Sync Profiles, and FlareSolverr integration
  */
 
+import { debugLog } from "../utils/debug"
+
 export interface IndexerProxy {
   id?: number
   name: string
@@ -55,13 +57,23 @@ export class ProwlarrClient {
       ...((options.headers as Record<string, string>) || {}),
     }
 
+    debugLog("Prowlarr", `${options.method || "GET"} ${url}`)
+    if (options.body) {
+      debugLog("Prowlarr", `Request Body: ${options.body}`)
+    }
+
     const response = await fetch(url, { ...options, headers })
+    const text = await response.text()
+
+    debugLog("Prowlarr", `Response ${response.status} from ${endpoint}`)
+    if (text && text.length < 2000) {
+      debugLog("Prowlarr", `Response Body: ${text}`)
+    }
 
     if (!response.ok) {
-      throw new Error(`Prowlarr API request failed: ${response.status} ${response.statusText}`)
+      throw new Error(`Prowlarr API request failed: ${response.status} ${response.statusText} - ${text}`)
     }
 
-    const text = await response.text()
     if (!text) return {} as T
     return JSON.parse(text) as T
   }

package/src/index.ts

@@ -2,12 +2,21 @@
 /**
  * Easiarr Entry Point
  * TUI tool for generating docker-compose files for the *arr ecosystem
+ *
+ * Usage:
+ *   easiarr           - Start the TUI
+ *   easiarr --debug   - Start with debug logging enabled
+ *   easiarr -d        - Same as --debug
  */
 
 import { createCliRenderer } from "@opentui/core"
 import { App } from "./ui/App"
+import { initDebug } from "./utils/debug"
 
 async function main() {
+  // Initialize debug logging if enabled
+  initDebug()
+
   const renderer = await createCliRenderer({
     consoleOptions: {
       startInDebugMode: false,

package/src/utils/debug.ts

@@ -1,18 +1,38 @@
 /**
  * Debug logging utility for Easiarr
  *
- * Only logs when EASIARR_DEBUG environment variable is set.
- * Usage: EASIARR_DEBUG=1 bun run dev
+ * Enable debug logging via:
+ * - CLI flag: easiarr --debug
+ * - Environment variable: EASIARR_DEBUG=1 bun run dev
  */
 
-import { appendFileSync } from "fs"
+import { appendFileSync, writeFileSync } from "fs"
 import { join } from "path"
 
-const DEBUG_ENABLED = process.env.EASIARR_DEBUG === "1" || process.env.EASIARR_DEBUG === "true"
-const logFile = join(import.meta.dir, "..", "..", "debug.log")
+// Check CLI args for --debug flag
+const hasDebugFlag = process.argv.includes("--debug") || process.argv.includes("-d")
+const hasEnvDebug = process.env.EASIARR_DEBUG === "1" || process.env.EASIARR_DEBUG === "true"
+
+export const DEBUG_ENABLED = hasDebugFlag || hasEnvDebug
+
+// Save debug log to ~/.easiarr/ like other config files
+const easiarrDir = join(process.env.HOME || "~", ".easiarr")
+const logFile = join(easiarrDir, "debug.log")
 
 /**
- * Log a debug message to debug.log file if EASIARR_DEBUG is enabled
+ * Initialize debug mode - clears old log file
+ */
+export function initDebug(): void {
+  if (!DEBUG_ENABLED) return
+  try {
+    writeFileSync(logFile, `=== Easiarr Debug Log - ${new Date().toISOString()} ===\n`)
+  } catch {
+    // Ignore
+  }
+}
+
+/**
+ * Log a debug message to debug.log file if debug mode is enabled
  */
 export function debugLog(category: string, message: string): void {
   if (!DEBUG_ENABLED) return
@@ -25,3 +45,25 @@ export function debugLog(category: string, message: string): void {
     // Ignore logging errors
   }
 }
+
+/**
+ * Log API request details for debugging
+ */
+export function debugRequest(method: string, url: string, body?: unknown): void {
+  if (!DEBUG_ENABLED) return
+  debugLog("API", `${method} ${url}`)
+  if (body) {
+    debugLog("API", `Body: ${JSON.stringify(body, null, 2)}`)
+  }
+}
+
+/**
+ * Log API response details for debugging
+ */
+export function debugResponse(status: number, url: string, body?: string): void {
+  if (!DEBUG_ENABLED) return
+  debugLog("API", `Response ${status} from ${url}`)
+  if (body && body.length < 2000) {
+    debugLog("API", `Response Body: ${body}`)
+  }
+}