@muhammedaksam/easiarr 1.4.0 → 1.4.1

package/src/utils/migrations/1765707135_rename_easiarr_status.ts

@@ -1,91 +0,0 @@
-/**
- * Migration: rename easiarr-status to easiarr
- *
- * OLD: { "id": "easiarr-status", "enabled": true }
- * NEW: { "id": "easiarr", "enabled": true }
- */
-
-import { existsSync, readFileSync, writeFileSync } from "node:fs"
-import { homedir } from "node:os"
-import { join } from "node:path"
-
-import { debugLog } from "~/utils/debug"
-
-const CONFIG_FILE = join(homedir(), ".easiarr", "config.json")
-
-export const name = "rename_easiarr_status"
-
-export function up(): boolean {
-  if (!existsSync(CONFIG_FILE)) {
-    debugLog("Migrations", "No config.json file found, skipping migration")
-    return false
-  }
-
-  try {
-    const content = readFileSync(CONFIG_FILE, "utf-8")
-    const config = JSON.parse(content)
-
-    if (!config.apps || !Array.isArray(config.apps)) {
-      debugLog("Migrations", "No apps array in config, skipping migration")
-      return false
-    }
-
-    let changed = false
-
-    for (const app of config.apps) {
-      if (app.id === "easiarr-status") {
-        app.id = "easiarr"
-        changed = true
-        debugLog("Migrations", "Renamed easiarr-status → easiarr")
-      }
-    }
-
-    if (changed) {
-      writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), "utf-8")
-      debugLog("Migrations", "Migration completed: app id 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(CONFIG_FILE)) {
-    return false
-  }
-
-  try {
-    const content = readFileSync(CONFIG_FILE, "utf-8")
-    const config = JSON.parse(content)
-
-    if (!config.apps || !Array.isArray(config.apps)) {
-      return false
-    }
-
-    let changed = false
-
-    for (const app of config.apps) {
-      if (app.id === "easiarr") {
-        app.id = "easiarr-status"
-        changed = true
-        debugLog("Migrations", "Rolled back easiarr → easiarr-status")
-      }
-    }
-
-    if (changed) {
-      writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), "utf-8")
-      debugLog("Migrations", "Rollback completed: app id restored")
-      return true
-    }
-
-    return false
-  } catch (e) {
-    debugLog("Migrations", `Rollback error: ${e}`)
-    return false
-  }
-}

package/src/utils/migrations/1765732722_remove_cloudflare_dns_api_token.ts

@@ -1,45 +0,0 @@
-/**
- * Migration: remove cloudflare dns api token
- * Removes the unused CLOUDFLARE_DNS_API_TOKEN from .env
- */
-
-import { existsSync, readFileSync, writeFileSync } from "node:fs"
-
-import { debugLog } from "~/utils/debug"
-import { getEnvPath } from "~/utils/env"
-
-export const name = "remove_cloudflare_dns_api_token"
-
-export function up(): boolean {
-  debugLog("Migrations", "Running migration: remove_cloudflare_dns_api_token")
-
-  const envPath = getEnvPath()
-  if (!existsSync(envPath)) {
-    debugLog("Migrations", ".env file not found, skipping")
-    return true
-  }
-
-  const content = readFileSync(envPath, "utf-8")
-
-  // Check if CLOUDFLARE_DNS_API_TOKEN exists
-  if (!content.includes("CLOUDFLARE_DNS_API_TOKEN")) {
-    debugLog("Migrations", "CLOUDFLARE_DNS_API_TOKEN not found, skipping")
-    return true
-  }
-
-  // Remove the line containing CLOUDFLARE_DNS_API_TOKEN
-  const lines = content.split("\n")
-  const filtered = lines.filter((line) => !line.startsWith("CLOUDFLARE_DNS_API_TOKEN="))
-  const newContent = filtered.join("\n")
-
-  writeFileSync(envPath, newContent, "utf-8")
-  debugLog("Migrations", "Removed CLOUDFLARE_DNS_API_TOKEN from .env")
-
-  return true
-}
-
-export function down(): boolean {
-  debugLog("Migrations", "Reverting migration: remove_cloudflare_dns_api_token")
-  // No revert needed - the token was unused
-  return true
-}

package/src/utils/migrations/1769515650_migrate_to_xdg.ts

@@ -1,114 +0,0 @@
-/**
- * Migration: migrate to xdg
- *
- * Moves config from ~/.easiarr to $XDG_CONFIG_HOME/easiarr
- */
-
-import {
-  copyFileSync,
-  cpSync,
-  existsSync,
-  lstatSync,
-  mkdirSync,
-  readdirSync,
-  rmSync,
-} from "node:fs"
-import { homedir } from "node:os"
-import { join } from "node:path"
-
-import { debugLog } from "~/utils/debug"
-
-export const name = "migrate_to_xdg"
-
-const OLD_DIR = join(homedir(), ".easiarr")
-
-function getNewDir(): string {
-  const xdgConfigHome = process.env.XDG_CONFIG_HOME || join(homedir(), ".config")
-  return join(xdgConfigHome, "easiarr")
-}
-
-export function up(): boolean {
-  const newDir = getNewDir()
-
-  // Skip if old directory doesn't exist
-  if (!existsSync(OLD_DIR)) {
-    debugLog("Migrations", "No legacy ~/.easiarr directory found, skipping migration")
-    return false
-  }
-
-  // Skip if already at XDG location (same path)
-  if (OLD_DIR === newDir) {
-    debugLog("Migrations", "Old and new paths are identical, skipping")
-    return false
-  }
-
-  // Skip if new directory already has config
-  if (existsSync(join(newDir, "config.json"))) {
-    debugLog("Migrations", "XDG config already exists, skipping migration")
-    return false
-  }
-
-  debugLog("Migrations", `Migrating from ${OLD_DIR} to ${newDir}`)
-
-  try {
-    // Ensure target directory exists
-    if (!existsSync(newDir)) {
-      mkdirSync(newDir, { recursive: true })
-      debugLog("Migrations", `Created directory ${newDir}`)
-    }
-
-    // Get all entries in old directory
-    const entries = readdirSync(OLD_DIR)
-
-    for (const entry of entries) {
-      // Skip migrations file - it will be recreated in new location
-      if (entry === ".migrations.json") continue
-
-      const oldPath = join(OLD_DIR, entry)
-      const newPath = join(newDir, entry)
-
-      // Skip if entry already exists in new location
-      if (existsSync(newPath)) {
-        debugLog("Migrations", `Skipping ${entry}, already exists in new location`)
-        continue
-      }
-
-      try {
-        const stat = lstatSync(oldPath)
-
-        if (stat.isDirectory()) {
-          // Copy directory recursively (e.g., backups/)
-          cpSync(oldPath, newPath, { recursive: true })
-          debugLog("Migrations", `Copied directory ${entry} to XDG location`)
-        } else if (stat.isFile()) {
-          // Copy file
-          copyFileSync(oldPath, newPath)
-          debugLog("Migrations", `Copied ${entry} to XDG location`)
-        }
-      } catch {
-        debugLog("Migrations", `Failed to copy ${entry}`)
-      }
-    }
-
-    // Remove old directory completely
-    try {
-      rmSync(OLD_DIR, { recursive: true, force: true })
-      debugLog("Migrations", `Removed legacy directory ${OLD_DIR}`)
-    } catch {
-      debugLog("Migrations", `Could not remove old directory`)
-    }
-
-    debugLog("Migrations", "XDG migration completed successfully")
-    return true
-  } catch (e) {
-    debugLog("Migrations", `Migration error: ${e}`)
-    return false
-  }
-}
-
-export function down(): boolean {
-  // This migration is not easily reversible
-  // The old config location is deprecated
-  debugLog("Migrations", "XDG migration rollback not supported")
-  return false
-}

package/src/utils/migrations.ts

@@ -1,165 +0,0 @@
-/**
- * Migration Runner
- * Sequelize-style migrations with Unix timestamp naming
- *
- * Migration files: src/utils/migrations/{timestamp}_{name}.ts
- * Each migration exports: name, up()
- */
-
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs"
-import { homedir } from "node:os"
-import { join } from "node:path"
-
-import { debugLog } from "./debug"
-
-/**
- * Get the XDG config directory for easiarr
- */
-function getXdgConfigDir(): string {
-  const xdgConfigHome = process.env.XDG_CONFIG_HOME || join(homedir(), ".config")
-  return join(xdgConfigHome, "easiarr")
-}
-
-const EASIARR_DIR = getXdgConfigDir()
-const MIGRATIONS_FILE = join(EASIARR_DIR, ".migrations.json")
-
-interface MigrationState {
-  applied: string[] // List of applied migration timestamps
-  lastRun: string
-}
-
-interface Migration {
-  timestamp: string
-  name: string
-  up: () => boolean
-  down: () => boolean
-}
-
-/**
- * Ensure the easiarr directory exists
- */
-function ensureEasiarrDir(): void {
-  if (!existsSync(EASIARR_DIR)) {
-    mkdirSync(EASIARR_DIR, { recursive: true })
-  }
-}
-
-/**
- * Get the current migration state
- */
-function getMigrationState(): MigrationState {
-  if (!existsSync(MIGRATIONS_FILE)) {
-    return { applied: [], lastRun: "" }
-  }
-
-  try {
-    const content = readFileSync(MIGRATIONS_FILE, "utf-8")
-    return JSON.parse(content) as MigrationState
-  } catch {
-    return { applied: [], lastRun: "" }
-  }
-}
-
-/**
- * Save the migration state
- */
-function saveMigrationState(state: MigrationState): void {
-  ensureEasiarrDir()
-  state.lastRun = new Date().toISOString()
-  writeFileSync(MIGRATIONS_FILE, JSON.stringify(state, null, 2), "utf-8")
-}
-
-/**
- * Load all migration modules
- */
-async function loadMigrations(): Promise<Migration[]> {
-  const migrations: Migration[] = []
-
-  // Import migrations directly - bundled at build time
-  try {
-    const m1 = await import("./migrations/1765626338_rename_env_variables")
-    migrations.push({
-      timestamp: "1765626338",
-      name: m1.name,
-      up: m1.up,
-      down: m1.down,
-    })
-  } catch (e) {
-    debugLog("Migrations", `Failed to load migration: ${e}`)
-  }
-
-  try {
-    const m1765707135 = await import("./migrations/1765707135_rename_easiarr_status")
-    migrations.push({
-      timestamp: "1765707135",
-      name: m1765707135.name,
-      up: m1765707135.up,
-      down: m1765707135.down,
-    })
-  } catch (e) {
-    debugLog("Migrations", `Failed to load migration: ${e}`)
-  }
-
-  try {
-    const m1765732722 = await import("./migrations/1765732722_remove_cloudflare_dns_api_token")
-    migrations.push({
-      timestamp: "1765732722",
-      name: m1765732722.name,
-      up: m1765732722.up,
-      down: m1765732722.down,
-    })
-  } catch (e) {
-    debugLog("Migrations", `Failed to load migration: ${e}`)
-  }
-
-  try {
-    const m1769515650 = await import("./migrations/1769515650_migrate_to_xdg")
-    migrations.push({
-      timestamp: "1769515650",
-      name: m1769515650.name,
-      up: m1769515650.up,
-      down: m1769515650.down,
-    })
-  } catch (e) {
-    debugLog("Migrations", `Failed to load migration: ${e}`)
-  }
-
-  // Add future migrations here:
-  // const m2 = await import("./migrations/1734xxxxxx_xxx")
-  // migrations.push({ timestamp: "...", name: m2.name, up: m2.up })
-
-  return migrations.sort((a, b) => a.timestamp.localeCompare(b.timestamp))
-}
-
-/**
- * Run all pending migrations
- */
-export async function runMigrations(): Promise<void> {
-  const state = getMigrationState()
-  const migrations = await loadMigrations()
-
-  let hasChanges = false
-
-  for (const migration of migrations) {
-    if (state.applied.includes(migration.timestamp)) {
-      continue
-    }
-
-    debugLog("Migrations", `Running migration ${migration.timestamp}_${migration.name}`)
-
-    try {
-      migration.up()
-      state.applied.push(migration.timestamp)
-      hasChanges = true
-      debugLog("Migrations", `Migration ${migration.timestamp} completed`)
-    } catch (e) {
-      debugLog("Migrations", `Migration ${migration.timestamp} failed: ${e}`)
-    }
-  }
-
-  if (hasChanges) {
-    saveMigrationState(state)
-  } else {
-    debugLog("Migrations", "No pending migrations")
-  }
-}

package/src/utils/password.ts

@@ -1,42 +0,0 @@
-/**
- * Password Utilities
- * Helpers for password validation and transformation
- */
-
-/**
- * Ensures a password meets minimum length requirements by repeating it.
- * If the password is already long enough, returns it unchanged.
- *
- * @param password - The original password
- * @param minLength - Minimum required length
- * @returns Password padded to at least minLength characters
- */
-export function ensureMinPasswordLength(password: string, minLength: number): string {
-  if (!password || password.length === 0) {
-    throw new Error("Password cannot be empty")
-  }
-
-  if (password.length >= minLength) {
-    return password
-  }
-
-  // Repeat the password until it meets minimum length
-  let extendedPassword = password
-  while (extendedPassword.length < minLength) {
-    extendedPassword += password
-  }
-
-  // Return exactly minLength characters
-  return extendedPassword.slice(0, minLength)
-}
-
-/**
- * Validates if a password meets minimum length requirements.
- *
- * @param password - The password to validate
- * @param minLength - Minimum required length
- * @returns true if password meets requirements
- */
-export function isPasswordValid(password: string, minLength: number): boolean {
-  return password !== undefined && password !== null && password.length >= minLength
-}

package/src/utils/paths.ts

@@ -1,33 +0,0 @@
-/**
- * Path Utilities
- * Centralized XDG-compliant path resolution for easiarr config and data directories
- */
-
-import { homedir } from "os"
-import { join } from "path"
-
-export const xdgConfigHome = process.env.XDG_CONFIG_HOME || join(homedir(), ".config")
-
-/**
- * Get the XDG config directory for easiarr
- * Uses $XDG_CONFIG_HOME/easiarr or defaults to ~/.config/easiarr
- */
-export function getConfigDir(): string {
-  return join(xdgConfigHome, "easiarr")
-}
-
-/**
- * Get a path within the config directory
- * @param segments - Path segments to join with config dir
- */
-export function getConfigPath(...segments: string[]): string {
-  return join(getConfigDir(), ...segments)
-}
-
-/**
- * Legacy path for migration purposes only
- * @deprecated Use getConfigDir() instead
- */
-export function getLegacyConfigDir(): string {
-  return join(homedir(), ".easiarr")
-}

package/src/utils/unraid.ts

@@ -1,103 +0,0 @@
-/**
- * Unraid Detection and Compatibility Utilities
- * Provides detection of Unraid environment and path adjustments
- */
-
-import { existsSync } from "node:fs"
-import { homedir } from "node:os"
-import { join } from "node:path"
-
-import { debugLog } from "./debug"
-import { getConfigDir as getXdgConfigDir } from "./paths"
-
-// Unraid-specific paths
-const UNRAID_IDENTIFIERS = [
-  "/boot/config/plugins", // Unraid plugin directory
-  "/etc/unraid-version", // Unraid version file
-  "/var/local/emhttp", // Unraid emhttp directory
-]
-
-const UNRAID_APPDATA_PATH = "/mnt/user/appdata"
-const COMPOSE_MANAGER_PLUGIN_PATH = "/boot/config/plugins/compose.manager"
-
-/**
- * Detect if running on Unraid OS
- * Checks for Unraid-specific filesystem paths
- */
-export function isUnraid(): boolean {
-  for (const path of UNRAID_IDENTIFIERS) {
-    if (existsSync(path)) {
-      debugLog("Unraid", `Detected Unraid OS (found ${path})`)
-      return true
-    }
-  }
-  return false
-}
-
-/**
- * Get the default appdata path for Unraid
- * Returns /mnt/user/appdata/easiarr on Unraid, XDG config dir otherwise
- */
-export function getUnraidAppDataPath(): string {
-  if (isUnraid()) {
-    return join(UNRAID_APPDATA_PATH, "easiarr")
-  }
-  return getXdgConfigDir()
-}
-
-/**
- * Check if Docker Compose Manager plugin is installed
- * This plugin allows managing compose stacks via Unraid's web UI
- */
-export function hasComposeManager(): boolean {
-  return existsSync(COMPOSE_MANAGER_PLUGIN_PATH)
-}
-
-/**
- * Get the recommended Compose Manager project directory
- * Compose Manager expects projects in /boot/config/plugins/compose.manager/projects/
- */
-export function getComposeManagerProjectPath(projectName: string = "easiarr"): string {
-  return join(COMPOSE_MANAGER_PLUGIN_PATH, "projects", projectName)
-}
-
-/**
- * Get platform-appropriate default root directory
- * Adjusts paths for Unraid vs standard Linux/Mac
- */
-export function getDefaultRootDir(): string {
-  if (isUnraid()) {
-    // On Unraid, use /mnt/user/data for media and /mnt/user/appdata for configs
-    return "/mnt/user/data"
-  }
-  // Standard path
-  return join(homedir(), "easiarr")
-}
-
-/**
- * Get platform-appropriate config directory
- */
-export function getConfigDir(): string {
-  if (isUnraid()) {
-    return UNRAID_APPDATA_PATH
-  }
-  return getXdgConfigDir()
-}
-
-/**
- * Get Unraid-specific information for display
- */
-export function getUnraidInfo(): {
-  isUnraid: boolean
-  hasComposeManager: boolean
-  appDataPath: string
-  composeManagerPath: string | null
-} {
-  const onUnraid = isUnraid()
-  return {
-    isUnraid: onUnraid,
-    hasComposeManager: onUnraid ? hasComposeManager() : false,
-    appDataPath: onUnraid ? UNRAID_APPDATA_PATH : getXdgConfigDir(),
-    composeManagerPath: onUnraid && hasComposeManager() ? getComposeManagerProjectPath() : null,
-  }
-}