@muhammedaksam/easiarr 0.4.2 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@muhammedaksam/easiarr",
-  "version": "0.4.2",
+  "version": "0.5.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",

package/src/api/arr-api.ts

@@ -254,6 +254,40 @@ export class ArrApiClient {
   async deleteRemotePathMapping(id: number): Promise<void> {
     await this.request(`/remotepathmapping/${id}`, { method: "DELETE" })
   }
+
+  // ==========================================
+  // Health Check & Status Methods
+  // ==========================================
+
+  // Get health issues/warnings
+  async getHealth(): Promise<HealthResource[]> {
+    return this.request<HealthResource[]>("/health")
+  }
+
+  // Get disk space information for all monitored paths
+  async getDiskSpace(): Promise<DiskSpaceResource[]> {
+    return this.request<DiskSpaceResource[]>("/diskspace")
+  }
+
+  // Get system status (version, OS, runtime, etc.)
+  async getSystemStatus(): Promise<SystemResource> {
+    return this.request<SystemResource>("/system/status")
+  }
+
+  // Get all items in the download queue
+  async getQueueDetails(includeUnknown = true): Promise<QueueResource[]> {
+    const params = new URLSearchParams()
+    if (includeUnknown) {
+      params.set("includeUnknownMovieItems", "true")
+    }
+    const query = params.toString()
+    return this.request<QueueResource[]>(`/queue/details${query ? `?${query}` : ""}`)
+  }
+
+  // Get queue status summary (counts, errors, warnings)
+  async getQueueStatus(): Promise<QueueStatusResource> {
+    return this.request<QueueStatusResource>("/queue/status")
+  }
 }
 
 // Types for Host Config API
@@ -297,3 +331,125 @@ export interface HostConfig {
   backupRetention: number
   trustCgnatIpAddresses: boolean
 }
+
+// ==========================================
+// Health Check & Status Types
+// ==========================================
+
+// Health check result types
+export type HealthCheckType = "ok" | "notice" | "warning" | "error"
+
+export interface HealthResource {
+  id?: number
+  source: string | null
+  type: HealthCheckType
+  message: string | null
+  wikiUrl: string | null
+}
+
+// Disk space types
+export interface DiskSpaceResource {
+  id?: number
+  path: string | null
+  label: string | null
+  freeSpace: number // int64
+  totalSpace: number // int64
+}
+
+// System status types
+export type RuntimeMode = "console" | "service" | "tray"
+export type DatabaseType = "sqLite" | "postgreSQL"
+
+export interface SystemResource {
+  appName: string | null
+  instanceName: string | null
+  version: string | null
+  buildTime: string | null
+  isDebug: boolean
+  isProduction: boolean
+  isAdmin: boolean
+  isUserInteractive: boolean
+  startupPath: string | null
+  appData: string | null
+  osName: string | null
+  osVersion: string | null
+  isNetCore: boolean
+  isLinux: boolean
+  isOsx: boolean
+  isWindows: boolean
+  isDocker: boolean
+  mode: RuntimeMode
+  branch: string | null
+  databaseType: DatabaseType
+  databaseVersion: string | null
+  authentication: "none" | "basic" | "forms" | "external"
+  migrationVersion: number
+  urlBase: string | null
+  runtimeVersion: string | null
+  runtimeName: string | null
+  startTime: string | null
+}
+
+// Queue types
+export type QueueStatus =
+  | "unknown"
+  | "queued"
+  | "paused"
+  | "downloading"
+  | "completed"
+  | "failed"
+  | "warning"
+  | "delay"
+  | "downloadClientUnavailable"
+  | "fallback"
+
+export type TrackedDownloadStatus = "ok" | "warning" | "error"
+export type TrackedDownloadState =
+  | "downloading"
+  | "importBlocked"
+  | "importPending"
+  | "importing"
+  | "imported"
+  | "failedPending"
+  | "failed"
+  | "ignored"
+
+export interface QueueStatusMessage {
+  title: string | null
+  messages: string[] | null
+}
+
+export interface QueueResource {
+  id?: number
+  movieId?: number | null // Radarr
+  seriesId?: number | null // Sonarr
+  artistId?: number | null // Lidarr
+  authorId?: number | null // Readarr
+  title: string | null
+  size: number
+  sizeleft?: number
+  timeleft?: string | null
+  estimatedCompletionTime: string | null
+  added: string | null
+  status: QueueStatus
+  trackedDownloadStatus: TrackedDownloadStatus
+  trackedDownloadState: TrackedDownloadState
+  statusMessages?: QueueStatusMessage[] | null
+  errorMessage: string | null
+  downloadId: string | null
+  protocol: "unknown" | "usenet" | "torrent"
+  downloadClient: string | null
+  indexer: string | null
+  outputPath: string | null
+}
+
+export interface QueueStatusResource {
+  id?: number
+  totalCount: number
+  count: number
+  unknownCount: number
+  errors: boolean
+  warnings: boolean
+  unknownErrors: boolean
+  unknownWarnings: boolean
+}

package/src/api/prowlarr-api.ts

@@ -14,6 +14,33 @@ export interface IndexerProxy {
   fields: { name: string; value: unknown }[]
 }
 
+export interface ProwlarrIndexerSchema {
+  id?: number
+  name: string
+  implementation: string
+  configContract: string
+  fields: { name: string; value?: unknown }[]
+  tags: number[]
+  enable: boolean
+  privacy: "public" | "private" | "semi-private"
+  protocol: "torrent" | "usenet"
+  priority: number
+  capabilities?: {
+    categories: { id: number; name: string; subCategories?: { id: number; name: string }[] }[]
+  }
+}
+
+export interface ProwlarrIndexer {
+  id?: number
+  name: string
+  fields: { name: string; value?: unknown }[]
+  tags: number[]
+  enable: boolean
+  protocol: string
+  implementation: string
+  configContract: string
+}
+
 export interface SyncProfile {
   id?: number
   name: string
@@ -188,6 +215,28 @@ export class ProwlarrClient {
     await this.request(`/indexerproxy/${id}`, { method: "DELETE" })
   }
 
+  // Indexer Management
+  async getIndexerSchemas(): Promise<ProwlarrIndexerSchema[]> {
+    return this.request<ProwlarrIndexerSchema[]>("/indexer/schema")
+  }
+
+  async getIndexers(): Promise<ProwlarrIndexer[]> {
+    return this.request<ProwlarrIndexer[]>("/indexer")
+  }
+
+  async createIndexer(indexer: ProwlarrIndexerSchema): Promise<ProwlarrIndexer> {
+    // Ensure required fields are set
+    const payload = {
+      ...indexer,
+      id: undefined, // Create new
+      appProfileId: 1, // Default profile
+    }
+    return this.request<ProwlarrIndexer>("/indexer", {
+      method: "POST",
+      body: JSON.stringify(payload),
+    })
+  }
+
   // Sync Profile management (aka App Sync Profile)
   async getSyncProfiles(): Promise<SyncProfile[]> {
     return this.request<SyncProfile[]>("/appsyncprofile")
@@ -258,23 +307,14 @@ export class ProwlarrClient {
     prowlarrUrl: string,
     appUrl: string,
     appApiKey: string,
-    syncLevel: "disabled" | "addOnly" | "fullSync" = "fullSync"
+    syncLevel: "disabled" | "addOnly" | "fullSync" = "fullSync",
+    syncCategories: number[] = []
   ): Promise<Application> {
-    // Default sync categories for each app type
-    // Radarr: Movies (2000, 2010, etc), Sonarr: TV (5000, 5010, etc)
-    // Lidarr: Audio (3000), Readarr: Books (7000, 8010)
-    const syncCategoriesMap: Record<ArrAppType, number[]> = {
-      Radarr: [2000, 2010, 2020, 2030, 2040, 2045, 2050, 2060, 2070, 2080],
-      Sonarr: [5000, 5010, 5020, 5030, 5040, 5045, 5050, 5060, 5070, 5080],
-      Lidarr: [3000, 3010, 3020, 3030, 3040],
-      Readarr: [7000, 7010, 7020, 7030, 8000, 8010, 8020],
-    }
-
     const fields: { name: string; value: unknown }[] = [
       { name: "prowlarrUrl", value: prowlarrUrl },
       { name: "baseUrl", value: appUrl },
       { name: "apiKey", value: appApiKey },
-      { name: "syncCategories", value: syncCategoriesMap[appType] || [] },
+      { name: "syncCategories", value: syncCategories },
     ]
 
     return this.request<Application>("/applications", {
@@ -309,7 +349,8 @@ export class ProwlarrClient {
     port: number,
     apiKey: string,
     prowlarrHost: string,
-    prowlarrPort: number
+    prowlarrPort: number,
+    syncCategories?: number[]
   ): Promise<Application> {
     const prowlarrUrl = `http://${prowlarrHost}:${prowlarrPort}`
     const appUrl = `http://${host}:${port}`
@@ -321,6 +362,398 @@ export class ProwlarrClient {
       return existing
     }
 
-    return this.addApplication(appType, appType, prowlarrUrl, appUrl, apiKey)
+    return this.addApplication(appType, appType, prowlarrUrl, appUrl, apiKey, "fullSync", syncCategories)
   }
 }
+
+export const PROWLARR_CATEGORIES = [
+  {
+    id: 1000,
+    name: "Console",
+    subCategories: [
+      {
+        id: 1010,
+        name: "Console/NDS",
+        subCategories: [],
+      },
+      {
+        id: 1020,
+        name: "Console/PSP",
+        subCategories: [],
+      },
+      {
+        id: 1030,
+        name: "Console/Wii",
+        subCategories: [],
+      },
+      {
+        id: 1040,
+        name: "Console/XBox",
+        subCategories: [],
+      },
+      {
+        id: 1050,
+        name: "Console/XBox 360",
+        subCategories: [],
+      },
+      {
+        id: 1060,
+        name: "Console/Wiiware",
+        subCategories: [],
+      },
+      {
+        id: 1070,
+        name: "Console/XBox 360 DLC",
+        subCategories: [],
+      },
+      {
+        id: 1080,
+        name: "Console/PS3",
+        subCategories: [],
+      },
+      {
+        id: 1090,
+        name: "Console/Other",
+        subCategories: [],
+      },
+      {
+        id: 1110,
+        name: "Console/3DS",
+        subCategories: [],
+      },
+      {
+        id: 1120,
+        name: "Console/PS Vita",
+        subCategories: [],
+      },
+      {
+        id: 1130,
+        name: "Console/WiiU",
+        subCategories: [],
+      },
+      {
+        id: 1140,
+        name: "Console/XBox One",
+        subCategories: [],
+      },
+      {
+        id: 1180,
+        name: "Console/PS4",
+        subCategories: [],
+      },
+    ],
+  },
+  {
+    id: 2000,
+    name: "Movies",
+    subCategories: [
+      {
+        id: 2010,
+        name: "Movies/Foreign",
+        subCategories: [],
+      },
+      {
+        id: 2020,
+        name: "Movies/Other",
+        subCategories: [],
+      },
+      {
+        id: 2030,
+        name: "Movies/SD",
+        subCategories: [],
+      },
+      {
+        id: 2040,
+        name: "Movies/HD",
+        subCategories: [],
+      },
+      {
+        id: 2045,
+        name: "Movies/UHD",
+        subCategories: [],
+      },
+      {
+        id: 2050,
+        name: "Movies/BluRay",
+        subCategories: [],
+      },
+      {
+        id: 2060,
+        name: "Movies/3D",
+        subCategories: [],
+      },
+      {
+        id: 2070,
+        name: "Movies/DVD",
+        subCategories: [],
+      },
+      {
+        id: 2080,
+        name: "Movies/WEB-DL",
+        subCategories: [],
+      },
+      {
+        id: 2090,
+        name: "Movies/x265",
+        subCategories: [],
+      },
+    ],
+  },
+  {
+    id: 3000,
+    name: "Audio",
+    subCategories: [
+      {
+        id: 3010,
+        name: "Audio/MP3",
+        subCategories: [],
+      },
+      {
+        id: 3020,
+        name: "Audio/Video",
+        subCategories: [],
+      },
+      {
+        id: 3030,
+        name: "Audio/Audiobook",
+        subCategories: [],
+      },
+      {
+        id: 3040,
+        name: "Audio/Lossless",
+        subCategories: [],
+      },
+      {
+        id: 3050,
+        name: "Audio/Other",
+        subCategories: [],
+      },
+      {
+        id: 3060,
+        name: "Audio/Foreign",
+        subCategories: [],
+      },
+    ],
+  },
+  {
+    id: 4000,
+    name: "PC",
+    subCategories: [
+      {
+        id: 4010,
+        name: "PC/0day",
+        subCategories: [],
+      },
+      {
+        id: 4020,
+        name: "PC/ISO",
+        subCategories: [],
+      },
+      {
+        id: 4030,
+        name: "PC/Mac",
+        subCategories: [],
+      },
+      {
+        id: 4040,
+        name: "PC/Mobile-Other",
+        subCategories: [],
+      },
+      {
+        id: 4050,
+        name: "PC/Games",
+        subCategories: [],
+      },
+      {
+        id: 4060,
+        name: "PC/Mobile-iOS",
+        subCategories: [],
+      },
+      {
+        id: 4070,
+        name: "PC/Mobile-Android",
+        subCategories: [],
+      },
+    ],
+  },
+  {
+    id: 5000,
+    name: "TV",
+    subCategories: [
+      {
+        id: 5010,
+        name: "TV/WEB-DL",
+        subCategories: [],
+      },
+      {
+        id: 5020,
+        name: "TV/Foreign",
+        subCategories: [],
+      },
+      {
+        id: 5030,
+        name: "TV/SD",
+        subCategories: [],
+      },
+      {
+        id: 5040,
+        name: "TV/HD",
+        subCategories: [],
+      },
+      {
+        id: 5045,
+        name: "TV/UHD",
+        subCategories: [],
+      },
+      {
+        id: 5050,
+        name: "TV/Other",
+        subCategories: [],
+      },
+      {
+        id: 5060,
+        name: "TV/Sport",
+        subCategories: [],
+      },
+      {
+        id: 5070,
+        name: "TV/Anime",
+        subCategories: [],
+      },
+      {
+        id: 5080,
+        name: "TV/Documentary",
+        subCategories: [],
+      },
+      {
+        id: 5090,
+        name: "TV/x265",
+        subCategories: [],
+      },
+    ],
+  },
+  {
+    id: 6000,
+    name: "XXX",
+    subCategories: [
+      {
+        id: 6010,
+        name: "XXX/DVD",
+        subCategories: [],
+      },
+      {
+        id: 6020,
+        name: "XXX/WMV",
+        subCategories: [],
+      },
+      {
+        id: 6030,
+        name: "XXX/XviD",
+        subCategories: [],
+      },
+      {
+        id: 6040,
+        name: "XXX/x264",
+        subCategories: [],
+      },
+      {
+        id: 6045,
+        name: "XXX/UHD",
+        subCategories: [],
+      },
+      {
+        id: 6050,
+        name: "XXX/Pack",
+        subCategories: [],
+      },
+      {
+        id: 6060,
+        name: "XXX/ImageSet",
+        subCategories: [],
+      },
+      {
+        id: 6070,
+        name: "XXX/Other",
+        subCategories: [],
+      },
+      {
+        id: 6080,
+        name: "XXX/SD",
+        subCategories: [],
+      },
+      {
+        id: 6090,
+        name: "XXX/WEB-DL",
+        subCategories: [],
+      },
+    ],
+  },
+  {
+    id: 7000,
+    name: "Books",
+    subCategories: [
+      {
+        id: 7010,
+        name: "Books/Mags",
+        subCategories: [],
+      },
+      {
+        id: 7020,
+        name: "Books/EBook",
+        subCategories: [],
+      },
+      {
+        id: 7030,
+        name: "Books/Comics",
+        subCategories: [],
+      },
+      {
+        id: 7040,
+        name: "Books/Technical",
+        subCategories: [],
+      },
+      {
+        id: 7050,
+        name: "Books/Other",
+        subCategories: [],
+      },
+      {
+        id: 7060,
+        name: "Books/Foreign",
+        subCategories: [],
+      },
+    ],
+  },
+  {
+    id: 8000,
+    name: "Other",
+    subCategories: [
+      {
+        id: 8010,
+        name: "Other/Misc",
+        subCategories: [],
+      },
+      {
+        id: 8020,
+        name: "Other/Hashed",
+        subCategories: [],
+      },
+    ],
+  },
+  {
+    id: 0,
+    name: "Other",
+    subCategories: [
+      {
+        id: 10,
+        name: "Other/Misc",
+        subCategories: [],
+      },
+      {
+        id: 20,
+        name: "Other/Hashed",
+        subCategories: [],
+      },
+    ],
+  },
+]

package/src/apps/registry.ts

@@ -29,6 +29,7 @@ export const APPS: Record<AppId, AppDefinition> = {
       path: "/data/media/movies",
       apiVersion: "v3",
     },
+    prowlarrCategoryIds: [2000, 2010, 2020, 2030, 2040, 2045, 2050, 2060, 2070, 2080, 2090],
   },
 
   sonarr: {
@@ -52,6 +53,7 @@ export const APPS: Record<AppId, AppDefinition> = {
       path: "/data/media/tv",
       apiVersion: "v3",
     },
+    prowlarrCategoryIds: [5000, 5010, 5020, 5030, 5040, 5045, 5050, 5060, 5070, 5080, 5090],
   },
 
   lidarr: {
@@ -73,6 +75,7 @@ export const APPS: Record<AppId, AppDefinition> = {
       path: "/data/media/music",
       apiVersion: "v1",
     },
+    prowlarrCategoryIds: [3000, 3010, 3020, 3030, 3040, 3050, 3060],
   },
 
   readarr: {
@@ -94,6 +97,7 @@ export const APPS: Record<AppId, AppDefinition> = {
       path: "/data/media/books",
       apiVersion: "v1",
     },
+    prowlarrCategoryIds: [7000, 7010, 7020, 7030, 7040, 7050, 7060],
     arch: {
       deprecated: ["arm64", "arm32"],
       warning: "Readarr is deprecated - no ARM64 support (project abandoned by upstream)",
@@ -161,6 +165,7 @@ export const APPS: Record<AppId, AppDefinition> = {
       path: "/data/media/adult",
       apiVersion: "v3",
     },
+    prowlarrCategoryIds: [6000, 6010, 6020, 6030, 6040, 6045, 6050, 6060, 6070, 6080, 6090],
   },
 
   audiobookshelf: {