@muhammedaksam/easiarr 1.4.0 → 1.4.1

package/src/utils/arch.ts

@@ -1,78 +0,0 @@
-/**
- * Architecture Detection Utility
- * Detects system architecture and checks app compatibility
- */
-
-import type { AppDefinition, Architecture } from "~/config/schema"
-
-/**
- * Get the current system architecture
- */
-export function getSystemArch(): Architecture {
-  const arch = process.arch
-  switch (arch) {
-    case "x64":
-    case "ia32":
-      return "x64"
-    case "arm64":
-      return "arm64"
-    case "arm":
-      return "arm32"
-    default:
-      return "x64" // Default to x64 for unknown
-  }
-}
-
-/**
- * Check if an app is compatible with the given architecture
- * Returns true if compatible (no issues), false if deprecated/broken
- */
-export function isAppCompatible(app: AppDefinition, arch?: Architecture): boolean {
-  const systemArch = arch ?? getSystemArch()
-
-  if (!app.arch) {
-    return true // No arch restrictions = supports all
-  }
-
-  // Check if explicitly deprecated
-  if (app.arch.deprecated?.includes(systemArch)) {
-    return false
-  }
-
-  // If supported list exists, check if current arch is in it
-  if (app.arch.supported && !app.arch.supported.includes(systemArch)) {
-    return false
-  }
-
-  return true
-}
-
-/**
- * Get warning message for an app on the current architecture
- * Returns null if no warning
- */
-export function getArchWarning(app: AppDefinition, arch?: Architecture): string | null {
-  const systemArch = arch ?? getSystemArch()
-
-  if (!app.arch) {
-    return null
-  }
-
-  if (app.arch.deprecated?.includes(systemArch)) {
-    return app.arch.warning || `${app.name} has deprecated support for ${systemArch}`
-  }
-
-  if (app.arch.supported && !app.arch.supported.includes(systemArch)) {
-    return `${app.name} does not support ${systemArch} architecture`
-  }
-
-  return null
-}
-
-/**
- * Check if app is deprecated (but might still work)
- */
-export function isAppDeprecated(app: AppDefinition, arch?: Architecture): boolean {
-  const systemArch = arch ?? getSystemArch()
-  return app.arch?.deprecated?.includes(systemArch) ?? false
-}

package/src/utils/browser.ts

@@ -1,27 +0,0 @@
-/**
- * Browser Utilities
- * Open URLs in the default browser
- */
-
-import { platform } from "node:os"
-
-import { $ } from "bun"
-
-/**
- * Open a URL in the default browser
- */
-export async function openUrl(url: string): Promise<void> {
-  const os = platform()
-
-  try {
-    if (os === "linux") {
-      await $`xdg-open ${url}`.quiet()
-    } else if (os === "darwin") {
-      await $`open ${url}`.quiet()
-    } else if (os === "win32") {
-      await $`cmd /c start ${url}`.quiet()
-    }
-  } catch {
-    // Silently fail if browser can't be opened
-  }
-}

package/src/utils/categories.ts

@@ -1,61 +0,0 @@
-/**
- * Download Category Utilities
- * Shared category mappings for *arr apps and download clients
- */
-
-import type { AppId } from "~/config/schema"
-
-// Category info for each *arr app
-export interface CategoryInfo {
-  name: string
-  savePath: string
-  fieldName: string // Field name used in *arr download client config
-}
-
-// Master mapping of app IDs to their download categories
-const CATEGORY_MAP: Partial<Record<AppId, CategoryInfo>> = {
-  radarr: { name: "movies", savePath: "/data/torrents/movies", fieldName: "movieCategory" },
-  sonarr: { name: "tv", savePath: "/data/torrents/tv", fieldName: "tvCategory" },
-  lidarr: { name: "music", savePath: "/data/torrents/music", fieldName: "musicCategory" },
-  readarr: { name: "books", savePath: "/data/torrents/books", fieldName: "bookCategory" },
-  whisparr: { name: "adult", savePath: "/data/torrents/adult", fieldName: "tvCategory" },
-  mylar3: { name: "comics", savePath: "/data/torrents/comics", fieldName: "category" },
-}
-
-/**
- * Get category name for an app (e.g., "movies" for radarr)
- */
-export function getCategoryForApp(appId: AppId): string {
-  return CATEGORY_MAP[appId]?.name ?? "default"
-}
-
-/**
- * Get the field name used in *arr download client config for category
- * (e.g., "movieCategory" for radarr, "tvCategory" for sonarr)
- */
-export function getCategoryFieldName(appId: AppId): string {
-  return CATEGORY_MAP[appId]?.fieldName ?? "category"
-}
-
-/**
- * Get the save path for an app's downloads (e.g., "/data/torrents/movies" for radarr)
- */
-export function getCategorySavePath(appId: AppId): string {
-  return CATEGORY_MAP[appId]?.savePath ?? "/data/torrents"
-}
-
-/**
- * Get full category info for an app
- */
-export function getCategoryInfo(appId: AppId): CategoryInfo | undefined {
-  return CATEGORY_MAP[appId]
-}
-
-/**
- * Get all category infos for a list of enabled app IDs
- */
-export function getCategoriesForApps(appIds: AppId[]): CategoryInfo[] {
-  return appIds
-    .map((id) => CATEGORY_MAP[id])
-    .filter((info): info is CategoryInfo => info !== undefined)
-}

package/src/utils/debug.ts

@@ -1,84 +0,0 @@
-/**
- * Debug logging utility for easiarr
- *
- * Enable debug logging via:
- * - CLI flag: easiarr --debug or -d
- * - Environment variable: EASIARR_DEBUG=1 bun dev
- */
-
-import { appendFileSync, writeFileSync } from "node:fs"
-
-import { getConfigPath } from "./paths"
-
-// 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 XDG config dir like other config files
-const logFile = getConfigPath("debug.log")
-
-/**
- * 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
-  }
-}
-
-/**
- * Sanitize sensitive fields from log messages
- * Redacts passwords, tokens, API keys, secrets, and credentials
- */
-export function sanitizeMessage(message: string): string {
-  // Match common sensitive field names in JSON format
-  // Covers: passwords, tokens, API keys, secrets, credentials, auth data
-  return message.replace(
-    /"(password|passwordConfirmation|Password|Pw|passwd|pass|apiKey|api_key|ApiKey|API_KEY|token|accessToken|access_token|refreshToken|refresh_token|bearerToken|jwtToken|jwt|secret|secretKey|secret_key|privateKey|private_key|credential|auth|authorization|authToken|client_secret|clientSecret|WIREGUARD_PRIVATE_KEY|TUNNEL_TOKEN|USERNAME_VPN|PASSWORD_VPN)":\s*"[^"]*"/gi,
-    '"$1":"[REDACTED]"'
-  )
-}
-
-/**
- * Log a debug message to debug.log file if debug mode is enabled
- * Automatically sanitizes sensitive data (passwords, tokens, etc.)
- */
-export function debugLog(category: string, message: string): void {
-  if (!DEBUG_ENABLED) return
-
-  const timestamp = new Date().toISOString()
-  const sanitizedMessage = sanitizeMessage(message)
-  const line = `[${timestamp}] [${category}] ${sanitizedMessage}\n`
-  try {
-    appendFileSync(logFile, line)
-  } catch {
-    // 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}`)
-  }
-}

package/src/utils/env.ts

@@ -1,138 +0,0 @@
-/**
- * Environment File Utilities
- * Shared functions for reading/writing .env files
- */
-
-import { existsSync, readFileSync, writeFileSync } from "node:fs"
-import { readFile, writeFile } from "node:fs/promises"
-import { networkInterfaces } from "node:os"
-
-import { getComposePath } from "~/config/manager"
-
-/**
- * Get the local IP address of the Docker host
- * Returns the first non-internal IPv4 address found
- */
-export function getLocalIp(): string {
-  const nets = networkInterfaces()
-
-  for (const name of Object.keys(nets)) {
-    const interfaces = nets[name]
-    if (!interfaces) continue
-
-    for (const net of interfaces) {
-      // Skip internal (loopback) and non-IPv4 addresses
-      if (net.family === "IPv4" && !net.internal) {
-        return net.address
-      }
-    }
-  }
-
-  return "localhost"
-}
-
-/**
- * Get the path to the .env file
- */
-export function getEnvPath(): string {
-  return getComposePath().replace("docker-compose.yml", ".env")
-}
-
-/**
- * Parse an .env file into a key-value object
- * Preserves existing values and handles multi-part values (e.g., with = in them)
- */
-export function parseEnvFile(content: string): Record<string, string> {
-  const env: Record<string, string> = {}
-
-  for (const line of content.split("\n")) {
-    const trimmed = line.trim()
-    if (!trimmed || trimmed.startsWith("#")) continue
-
-    const [key, ...val] = trimmed.split("=")
-    if (key && val.length > 0) {
-      env[key.trim()] = val.join("=").trim()
-    }
-  }
-
-  return env
-}
-
-/**
- * Serialize an env object to .env file format
- */
-export function serializeEnv(env: Record<string, string>): string {
-  return Object.entries(env)
-    .map(([k, v]) => `${k}=${v}`)
-    .join("\n")
-}
-
-/**
- * Read the .env file and return parsed key-value object
- * Returns empty object if file doesn't exist
- */
-export function readEnvSync(): Record<string, string> {
-  const envPath = getEnvPath()
-  if (!existsSync(envPath)) return {}
-
-  try {
-    const content = readFileSync(envPath, "utf-8")
-    return parseEnvFile(content)
-  } catch {
-    return {}
-  }
-}
-
-/**
- * Write to .env file synchronously, merging with existing values
- * Preserves existing keys not in the updates object
- */
-export function writeEnvSync(updates: Record<string, string>): void {
-  const envPath = getEnvPath()
-  const current = readEnvSync()
-
-  // Merge updates into current
-  const merged = { ...current, ...updates }
-
-  // Write back
-  const content = serializeEnv(merged)
-  writeFileSync(envPath, content, "utf-8")
-}
-
-/**
- * Read the .env file asynchronously
- */
-export async function readEnv(): Promise<Record<string, string>> {
-  const envPath = getEnvPath()
-  if (!existsSync(envPath)) return {}
-
-  try {
-    const content = await readFile(envPath, "utf-8")
-    return parseEnvFile(content)
-  } catch {
-    return {}
-  }
-}
-
-/**
- * Write to .env file, merging with existing values
- * Preserves existing keys not in the updates object
- */
-export async function updateEnv(updates: Record<string, string>): Promise<void> {
-  const envPath = getEnvPath()
-  const current = await readEnv()
-
-  // Merge updates into current
-  const merged = { ...current, ...updates }
-
-  // Write back
-  const content = serializeEnv(merged)
-  await writeFile(envPath, content, "utf-8")
-}
-
-/**
- * Get a specific value from .env
- */
-export function getEnvValue(key: string): string | undefined {
-  return readEnvSync()[key]
-}

package/src/utils/index.ts

@@ -1,8 +0,0 @@
-export * from "./env"
-export * from "./debug"
-export * from "./browser"
-export * from "./categories"
-export * from "./unraid"
-export * from "./update-checker"
-export * from "./url-utils"
-export * from "./password"

package/src/utils/logs.ts

@@ -1,119 +0,0 @@
-/**
- * Log File Management Utilities
- * Handles saving and managing container logs to XDG config dir
- */
-
-import { mkdir, readdir, stat, writeFile } from "node:fs/promises"
-import { join } from "node:path"
-
-import { debugLog } from "./debug"
-import { getConfigPath } from "./paths"
-
-const LOGS_DIR = getConfigPath("logs")
-
-/**
- * Get the logs directory path for a specific app
- */
-export function getLogPath(appId: string): string {
-  return join(LOGS_DIR, appId)
-}
-
-/**
- * Ensure the logs directory exists for an app
- */
-async function ensureLogDir(appId: string): Promise<string> {
-  const logDir = getLogPath(appId)
-  await mkdir(logDir, { recursive: true })
-  return logDir
-}
-
-/**
- * Generate a timestamped log filename
- */
-function generateLogFilename(): string {
-  const now = new Date()
-  const timestamp = now.toISOString().replace(/[:.]/g, "-").replace("T", "_").slice(0, 19)
-  return `${timestamp}.log`
-}
-
-/**
- * Save container logs to a file
- * @returns The path to the saved log file
- */
-export async function saveLog(appId: string, content: string): Promise<string> {
-  const logDir = await ensureLogDir(appId)
-  const filename = generateLogFilename()
-  const filepath = join(logDir, filename)
-
-  await writeFile(filepath, content, "utf-8")
-  debugLog("Logs", `Saved log for ${appId} to ${filepath}`)
-
-  return filepath
-}
-
-/**
- * List saved logs for an app
- * @returns Array of log file info sorted by date (newest first)
- */
-export async function listSavedLogs(
-  appId: string
-): Promise<Array<{ filename: string; path: string; date: Date; size: number }>> {
-  const logDir = getLogPath(appId)
-
-  try {
-    const files = await readdir(logDir)
-    const logFiles = files.filter((f) => f.endsWith(".log"))
-
-    const fileInfos = await Promise.all(
-      logFiles.map(async (filename) => {
-        const path = join(logDir, filename)
-        const stats = await stat(path)
-        return {
-          filename,
-          path,
-          date: stats.mtime,
-          size: stats.size,
-        }
-      })
-    )
-
-    // Sort by date, newest first
-    return fileInfos.sort((a, b) => b.date.getTime() - a.date.getTime())
-  } catch {
-    // Directory doesn't exist yet
-    return []
-  }
-}
-
-/**
- * Get the base logs directory path
- */
-export function getLogsBaseDir(): string {
-  return LOGS_DIR
-}
-
-/**
- * Format bytes to human-readable size
- */
-export function formatBytes(bytes: number): string {
-  if (bytes < 1024) return `${bytes} B`
-  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`
-  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`
-}
-
-/**
- * Format relative time (e.g., "2 hours ago")
- */
-export function formatRelativeTime(date: Date): string {
-  const now = new Date()
-  const diffMs = now.getTime() - date.getTime()
-  const diffSecs = Math.floor(diffMs / 1000)
-  const diffMins = Math.floor(diffSecs / 60)
-  const diffHours = Math.floor(diffMins / 60)
-  const diffDays = Math.floor(diffHours / 24)
-
-  if (diffDays > 0) return `${diffDays}d ago`
-  if (diffHours > 0) return `${diffHours}h ago`
-  if (diffMins > 0) return `${diffMins}m ago`
-  return "just now"
-}

package/src/utils/migrations/1765626338_rename_env_variables.ts

@@ -1,102 +0,0 @@
-/**
- * Migration: Rename env variables to new format
- *
- * OLD: GLOBAL_PASSWORD, QBITTORRENT_USER, etc.
- * NEW: PASSWORD_GLOBAL, USERNAME_QBITTORRENT, etc.
- */
-
-import { existsSync, readFileSync, writeFileSync } from "node:fs"
-import { homedir } from "node:os"
-import { join } from "node:path"
-
-import { debugLog } from "~/utils/debug"
-import { parseEnvFile, serializeEnv } from "~/utils/env"
-
-const ENV_FILE = join(homedir(), ".easiarr", ".env")
-
-export const name = "rename-env-variables"
-
-const renames: [string, string][] = [
-  // Global credentials
-  ["GLOBAL_PASSWORD", "PASSWORD_GLOBAL"],
-  ["GLOBAL_USERNAME", "USERNAME_GLOBAL"],
-  // qBittorrent
-  ["QBITTORRENT_PASSWORD", "PASSWORD_QBITTORRENT"],
-  ["QBITTORRENT_USER", "USERNAME_QBITTORRENT"],
-  ["QBITTORRENT_PASS", "PASSWORD_QBITTORRENT"], // Legacy alias
-  // Portainer
-  ["PORTAINER_PASSWORD", "PASSWORD_PORTAINER"],
-  // PostgreSQL
-  ["POSTGRESQL_USERNAME", "USERNAME_POSTGRESQL"],
-  ["POSTGRESQL_PASSWORD", "PASSWORD_POSTGRESQL"],
-  // VPN
-  ["VPN_USERNAME", "USERNAME_VPN"],
-  ["VPN_PASSWORD", "PASSWORD_VPN"],
-]
-
-export function up(): boolean {
-  if (!existsSync(ENV_FILE)) {
-    debugLog("Migrations", "No .env file found, skipping migration")
-    return false
-  }
-
-  try {
-    const content = readFileSync(ENV_FILE, "utf-8")
-    const env = parseEnvFile(content)
-    let changed = false
-
-    for (const [oldKey, newKey] of renames) {
-      if (env[oldKey] !== undefined && env[newKey] === undefined) {
-        env[newKey] = env[oldKey]
-        delete env[oldKey]
-        changed = true
-        debugLog("Migrations", `Renamed ${oldKey} → ${newKey}`)
-      }
-    }
-
-    if (changed) {
-      writeFileSync(ENV_FILE, serializeEnv(env), "utf-8")
-      debugLog("Migrations", "Migration completed: env variables renamed")
-      return true
-    }
-
-    debugLog("Migrations", "No changes needed")
-    return false
-  } catch (e) {
-    debugLog("Migrations", `Migration error: ${e}`)
-    return false
-  }
-}
-
-export function down(): boolean {
-  if (!existsSync(ENV_FILE)) {
-    return false
-  }
-
-  try {
-    const content = readFileSync(ENV_FILE, "utf-8")
-    const env = parseEnvFile(content)
-    let changed = false
-
-    for (const [oldKey, newKey] of renames) {
-      // Reverse operation: restore oldKey from newKey
-      if (env[newKey] !== undefined && env[oldKey] === undefined) {
-        env[oldKey] = env[newKey]
-        delete env[newKey]
-        changed = true
-        debugLog("Migrations", `Rolled back ${newKey} → ${oldKey}`)
-      }
-    }
-
-    if (changed) {
-      writeFileSync(ENV_FILE, serializeEnv(env), "utf-8")
-      debugLog("Migrations", "Rollback completed: env variables restored")
-      return true
-    }
-
-    return false
-  } catch (e) {
-    debugLog("Migrations", `Rollback error: ${e}`)
-    return false
-  }
-}