@muhammedaksam/easiarr 1.3.5 → 1.4.0

package/README.md

@@ -10,7 +10,7 @@
 
 > ⚠️ **Work In Progress** - This project is in early experimental development. Features may be incomplete, unstable, or change without notice.
 
-TUI tool for generating docker-compose files for the \*arr media ecosystem with 49 apps, TRaSH Guides best practices, VPN routing, and Traefik/Caddy reverse proxy support.
+TUI tool for generating docker-compose files for the \*arr media ecosystem with 52 apps, TRaSH Guides best practices, VPN routing, and Traefik/Caddy reverse proxy support.
 
 A terminal-based wizard that helps you set up Radarr, Sonarr, Prowlarr, and other \*arr applications with Docker Compose, following best practices from [TRaSH Guides](https://trash-guides.info/).
 
@@ -23,7 +23,7 @@ A terminal-based wizard that helps you set up Radarr, Sonarr, Prowlarr, and othe
 - 🎮 **Container Control** - Start, stop, and restart containers directly from the TUI
 - 📋 **Container Logs Viewer** - View and save Docker container logs from the TUI
 - ⚙️ **App Management** - Add or remove apps from your stack with ease
-- 💾 **Persistent Configuration** - Settings saved to `~/.easiarr/config.json`
+- 💾 **Persistent Configuration** - Settings saved to `$XDG_CONFIG_HOME/easiarr/config.json`
 - 🔀 **Reverse Proxy** - Traefik or Caddy support with automatic SSL
 - 🖥️ **Unraid Support** - Automatic OS detection and compatibility
 
@@ -56,7 +56,7 @@ bun run start
 - [Bun](https://bun.sh/) >= 1.0
 - [Docker](https://www.docker.com/) with Docker Compose v2
 
-## Supported Applications (49 apps across 10 categories)
+## Supported Applications (52 apps across 10 categories)
 
 ### Media Management (Servarr)
 
@@ -79,6 +79,8 @@ bun run start
 
 - **qBittorrent** - BitTorrent client
 - **SABnzbd** - Usenet downloader
+- **Slskd** - Soulseek client for music sharing
+- **Soularr** - Lidarr integration for Soulseek
 
 ### Media Servers
 
@@ -103,6 +105,7 @@ bun run start
 - **Portainer** - Docker container management UI
 - **Huntarr** - Missing content manager for \*arr apps
 - **Unpackerr** - Archive extraction for \*arr apps
+- **Maintainerr** - Automated media cleanup manager
 - **Recyclarr** - TRaSH Guides profile sync (CLI-based)
 - **Profilarr** - TRaSH Guides profile sync (Web UI)
 - **FileBot** - Media file renaming and automator
@@ -160,10 +163,10 @@ The wizard will automatically:
 
 ## Configuration
 
-easiarr stores its configuration in `~/.easiarr/`:
+easiarr stores its configuration in `$XDG_CONFIG_HOME/easiarr/`:
 
 ```bash
-~/.easiarr/
+$XDG_CONFIG_HOME/easiarr/
 ├── config.json          # Your easiarr configuration
 ├── docker-compose.yml   # Generated Docker Compose file
 └── backups/             # Configuration backups

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@muhammedaksam/easiarr",
-  "version": "1.3.5",
+  "version": "1.4.0",
   "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",
@@ -51,23 +51,25 @@
     "start": "bun run src/index.ts"
   },
   "devDependencies": {
-    "@eslint/js": "^9.39.2",
+    "@eslint/js": "^10.0.1",
+    "@ianvs/prettier-plugin-sort-imports": "^4.7.1",
     "@types/bcrypt": "^6.0.0",
     "@types/bun": "latest",
     "@types/jest": "^30.0.0",
-    "@types/node": "^25.0.10",
-    "eslint": "^9.39.2",
+    "@types/node": "^25.2.3",
+    "eslint": "^10.0.0",
+    "eslint-plugin-import": "^2.32.0",
     "jest": "^30.2.0",
     "jiti": "^2.6.1",
     "prettier": "^3.8.1",
     "ts-jest": "^29.4.6",
-    "typescript-eslint": "^8.54.0"
+    "typescript-eslint": "^8.55.0"
   },
   "peerDependencies": {
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@opentui/core": "^0.1.75",
+    "@opentui/core": "^0.1.79",
     "bcrypt": "^6.0.0",
     "socket.io-client": "^4.8.3",
     "yaml": "^2.8.2"

package/src/api/arr-api.ts

@@ -3,7 +3,11 @@
  * Interacts with Radarr, Sonarr, Lidarr, Readarr, Whisparr APIs
  */
 
-import { debugLog } from "../utils/debug"
+import type { NamingConfig } from "./naming-config"
+import type { AppId } from "~/config/schema"
+import { getCategoryFieldName, getCategoryForApp } from "~/utils/categories"
+import { debugLog } from "~/utils/debug"
+import { TRASH_NAMING_CONFIG } from "./naming-config"
 
 // Types for Root Folder API
 export interface RootFolder {
@@ -44,10 +48,6 @@ export interface RemotePathMapping {
   localPath: string
 }
 
-import type { AppId } from "../config/schema"
-import { getCategoryForApp, getCategoryFieldName } from "../utils/categories"
-import { TRASH_NAMING_CONFIG, type NamingConfig } from "./naming-config"
-
 // qBittorrent download client config
 export function createQBittorrentConfig(
   host: string,
@@ -82,7 +82,12 @@ export function createQBittorrentConfig(
 }
 
 // SABnzbd download client config
-export function createSABnzbdConfig(host: string, port: number, apiKey: string, appId?: AppId): DownloadClientConfig {
+export function createSABnzbdConfig(
+  host: string,
+  port: number,
+  apiKey: string,
+  appId?: AppId
+): DownloadClientConfig {
   const category = appId ? getCategoryForApp(appId) : "default"
   const categoryField = appId ? getCategoryFieldName(appId) : "category"
 
@@ -214,7 +219,11 @@ export class ArrApiClient {
     return this.request<HostConfig>("/config/host")
   }
 
-  async updateHostConfig(username: string, password: string, override = false): Promise<HostConfig | null> {
+  async updateHostConfig(
+    username: string,
+    password: string,
+    override = false
+  ): Promise<HostConfig | null> {
     // First get current config to preserve all other settings
     const currentConfig = await this.getHostConfig()
 
@@ -293,11 +302,15 @@ export class ArrApiClient {
       // 3. Update configuration
       await this.updateNamingConfig(newConfig)
     } catch (e) {
-      throw new Error(`Failed to configure naming: ${e}`)
+      throw new Error(`Failed to configure naming: ${e}`, { cause: e })
     }
   }
 
-  async addRemotePathMapping(host: string, remotePath: string, localPath: string): Promise<RemotePathMapping> {
+  async addRemotePathMapping(
+    host: string,
+    remotePath: string,
+    localPath: string
+  ): Promise<RemotePathMapping> {
     return this.request<RemotePathMapping>("/remotepathmapping", {
       method: "POST",
       body: JSON.stringify({ host, remotePath, localPath }),

package/src/api/auto-setup-types.ts

@@ -3,7 +3,7 @@
  * Interfaces for auto-setup capability metadata and clients
  */
 
-import type { AppId } from "../config/schema"
+import type { AppId } from "~/config/schema"
 
 /**
  * Describes an app's auto-setup capability

package/src/api/base-api.ts

@@ -0,0 +1,216 @@
+/**
+ * Base API Client
+ * Abstract class providing shared fetch, logging, and error handling for all API clients.
+ */
+
+import { debugLog } from "~/utils/debug"
+
+export interface ApiResponse<T> {
+  success: boolean
+  data?: T
+  error?: string
+  status?: number
+}
+
+export abstract class BaseApiClient {
+  protected host: string
+  protected port: number
+  protected abstract readonly logPrefix: string
+
+  constructor(host: string, port: number) {
+    this.host = host
+    this.port = port
+  }
+
+  /**
+   * Base URL for the API (override in subclass if protocol differs)
+   */
+  protected get baseUrl(): string {
+    return `http://${this.host}:${this.port}`
+  }
+
+  /**
+   * Build API URL for a given endpoint
+   */
+  protected buildUrl(endpoint: string, basePath: string = ""): string {
+    return `${this.baseUrl}${basePath}${endpoint}`
+  }
+
+  /**
+   * Generic GET request with logging and error handling
+   */
+  protected async get<T>(
+    endpoint: string,
+    options: { basePath?: string; headers?: Record<string, string> } = {}
+  ): Promise<ApiResponse<T>> {
+    const url = this.buildUrl(endpoint, options.basePath)
+    try {
+      debugLog(this.logPrefix, `GET ${endpoint}`)
+      const response = await fetch(url, {
+        method: "GET",
+        headers: options.headers,
+      })
+      if (!response.ok) {
+        debugLog(this.logPrefix, `GET ${endpoint} failed: ${response.status}`)
+        return { success: false, status: response.status }
+      }
+      const data = (await response.json()) as T
+      return { success: true, data }
+    } catch (error) {
+      debugLog(this.logPrefix, `GET ${endpoint} error: ${error}`)
+      return { success: false, error: String(error) }
+    }
+  }
+
+  /**
+   * Generic GET request returning plain text
+   */
+  protected async getText(
+    endpoint: string,
+    options: { basePath?: string; headers?: Record<string, string> } = {}
+  ): Promise<ApiResponse<string>> {
+    const url = this.buildUrl(endpoint, options.basePath)
+    try {
+      debugLog(this.logPrefix, `GET (text) ${endpoint}`)
+      const response = await fetch(url, {
+        method: "GET",
+        headers: options.headers,
+      })
+      if (!response.ok) {
+        debugLog(this.logPrefix, `GET ${endpoint} failed: ${response.status}`)
+        return { success: false, status: response.status }
+      }
+      const data = await response.text()
+      return { success: true, data }
+    } catch (error) {
+      debugLog(this.logPrefix, `GET ${endpoint} error: ${error}`)
+      return { success: false, error: String(error) }
+    }
+  }
+
+  /**
+   * Generic POST request with logging and error handling
+   */
+  protected async post<T, B = unknown>(
+    endpoint: string,
+    body?: B,
+    options: { basePath?: string; headers?: Record<string, string> } = {}
+  ): Promise<ApiResponse<T>> {
+    const url = this.buildUrl(endpoint, options.basePath)
+    try {
+      debugLog(this.logPrefix, `POST ${endpoint}`)
+      const response = await fetch(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          ...options.headers,
+        },
+        body: body ? JSON.stringify(body) : undefined,
+      })
+      if (!response.ok) {
+        debugLog(this.logPrefix, `POST ${endpoint} failed: ${response.status}`)
+        return { success: false, status: response.status }
+      }
+      // Handle empty responses
+      const text = await response.text()
+      if (!text) {
+        return { success: true }
+      }
+      try {
+        const data = JSON.parse(text) as T
+        return { success: true, data }
+      } catch {
+        // Response was not JSON
+        return { success: true }
+      }
+    } catch (error) {
+      debugLog(this.logPrefix, `POST ${endpoint} error: ${error}`)
+      return { success: false, error: String(error) }
+    }
+  }
+
+  /**
+   * Generic PUT request with logging and error handling
+   */
+  protected async put<T, B = unknown>(
+    endpoint: string,
+    body?: B,
+    options: { basePath?: string; headers?: Record<string, string> } = {}
+  ): Promise<ApiResponse<T>> {
+    const url = this.buildUrl(endpoint, options.basePath)
+    try {
+      debugLog(this.logPrefix, `PUT ${endpoint}`)
+      const response = await fetch(url, {
+        method: "PUT",
+        headers: {
+          "Content-Type": "application/json",
+          ...options.headers,
+        },
+        body: body ? JSON.stringify(body) : undefined,
+      })
+      if (!response.ok) {
+        debugLog(this.logPrefix, `PUT ${endpoint} failed: ${response.status}`)
+        return { success: false, status: response.status }
+      }
+      const text = await response.text()
+      if (!text) {
+        return { success: true }
+      }
+      try {
+        const data = JSON.parse(text) as T
+        return { success: true, data }
+      } catch {
+        return { success: true }
+      }
+    } catch (error) {
+      debugLog(this.logPrefix, `PUT ${endpoint} error: ${error}`)
+      return { success: false, error: String(error) }
+    }
+  }
+
+  /**
+   * Generic DELETE request with logging and error handling
+   */
+  protected async delete<T>(
+    endpoint: string,
+    options: { basePath?: string; headers?: Record<string, string> } = {}
+  ): Promise<ApiResponse<T>> {
+    const url = this.buildUrl(endpoint, options.basePath)
+    try {
+      debugLog(this.logPrefix, `DELETE ${endpoint}`)
+      const response = await fetch(url, {
+        method: "DELETE",
+        headers: options.headers,
+      })
+      if (!response.ok) {
+        debugLog(this.logPrefix, `DELETE ${endpoint} failed: ${response.status}`)
+        return { success: false, status: response.status }
+      }
+      const text = await response.text()
+      if (!text) {
+        return { success: true }
+      }
+      try {
+        const data = JSON.parse(text) as T
+        return { success: true, data }
+      } catch {
+        return { success: true }
+      }
+    } catch (error) {
+      debugLog(this.logPrefix, `DELETE ${endpoint} error: ${error}`)
+      return { success: false, error: String(error) }
+    }
+  }
+
+  /**
+   * Simple health check - override in subclass for custom logic
+   */
+  async isHealthy(): Promise<boolean> {
+    try {
+      const response = await fetch(this.baseUrl, { method: "HEAD" })
+      return response.ok
+    } catch {
+      return false
+    }
+  }
+}