@muhammedaksam/easiarr 1.0.0 → 1.1.0

package/src/api/homarr-api.ts

@@ -0,0 +1,296 @@
+/**
+ * Homarr API Client
+ * Handles Homarr dashboard auto-setup with user and app management
+ * Based on Homarr OpenAPI v1.0.0
+ */
+
+import { debugLog } from "../utils/debug"
+import type { IAutoSetupClient, AutoSetupOptions, AutoSetupResult } from "./auto-setup-types"
+import type { AppConfig } from "../config/schema"
+import { getApp } from "../apps/registry"
+
+interface HomarrApp {
+  id?: string
+  appId?: string
+  name: string
+  description: string | null
+  iconUrl: string
+  href: string | null
+  pingUrl: string | null
+}
+
+interface HomarrUser {
+  id: string
+  name: string | null
+  email: string | null
+}
+
+interface HomarrInfo {
+  version: string
+}
+
+export class HomarrClient implements IAutoSetupClient {
+  private host: string
+  private port: number
+  private apiKey?: string
+
+  constructor(host: string, port: number = 7575, apiKey?: string) {
+    this.host = host
+    this.port = port
+    this.apiKey = apiKey
+  }
+
+  /**
+   * Get base URL for Homarr
+   */
+  private get baseUrl(): string {
+    return `http://${this.host}:${this.port}`
+  }
+
+  /**
+   * Set API key for authenticated requests
+   */
+  setApiKey(apiKey: string): void {
+    this.apiKey = apiKey
+  }
+
+  /**
+   * Common headers for Homarr API requests
+   */
+  private getHeaders(): Record<string, string> {
+    const headers: Record<string, string> = {
+      "Content-Type": "application/json",
+      Accept: "application/json",
+    }
+    if (this.apiKey) {
+      headers["ApiKey"] = this.apiKey
+    }
+    return headers
+  }
+
+  /**
+   * Check if Homarr is reachable
+   */
+  async isHealthy(): Promise<boolean> {
+    try {
+      const response = await fetch(this.baseUrl, {
+        method: "GET",
+      })
+      debugLog("HomarrApi", `Health check: ${response.status}`)
+      return response.ok
+    } catch (error) {
+      debugLog("HomarrApi", `Health check failed: ${error}`)
+      return false
+    }
+  }
+
+  /**
+   * Check if already configured (has users)
+   */
+  async isInitialized(): Promise<boolean> {
+    // Homarr is always "initialized" after first access
+    return true
+  }
+
+  /**
+   * Get Homarr version info
+   */
+  async getInfo(): Promise<HomarrInfo | null> {
+    try {
+      const response = await fetch(`${this.baseUrl}/api/info`, {
+        method: "GET",
+        headers: this.getHeaders(),
+      })
+
+      if (response.ok) {
+        return response.json()
+      }
+    } catch {
+      // API may not be available
+    }
+    return null
+  }
+
+  /**
+   * Get all users
+   */
+  async getUsers(): Promise<HomarrUser[]> {
+    try {
+      const response = await fetch(`${this.baseUrl}/api/users`, {
+        method: "GET",
+        headers: this.getHeaders(),
+      })
+
+      if (response.ok) {
+        return response.json()
+      }
+    } catch {
+      // API may require auth
+    }
+    return []
+  }
+
+  /**
+   * Create a user
+   */
+  async createUser(username: string, password: string, email?: string): Promise<boolean> {
+    debugLog("HomarrApi", `Creating user: ${username}`)
+
+    try {
+      const response = await fetch(`${this.baseUrl}/api/users`, {
+        method: "POST",
+        headers: this.getHeaders(),
+        body: JSON.stringify({
+          username,
+          password,
+          confirmPassword: password,
+          email: email || "",
+          groupIds: [],
+        }),
+      })
+
+      if (response.ok) {
+        debugLog("HomarrApi", `User "${username}" created successfully`)
+        return true
+      }
+
+      const text = await response.text()
+      debugLog("HomarrApi", `Failed to create user: ${response.status} - ${text}`)
+      return false
+    } catch (error) {
+      debugLog("HomarrApi", `Failed to create user: ${error}`)
+      return false
+    }
+  }
+
+  /**
+   * Get all apps
+   */
+  async getApps(): Promise<HomarrApp[]> {
+    try {
+      const response = await fetch(`${this.baseUrl}/api/apps`, {
+        method: "GET",
+        headers: this.getHeaders(),
+      })
+
+      if (response.ok) {
+        return response.json()
+      }
+    } catch {
+      // API may require auth
+    }
+    return []
+  }
+
+  /**
+   * Create an app
+   */
+  async createApp(app: Omit<HomarrApp, "id" | "appId">): Promise<string | null> {
+    debugLog("HomarrApi", `Creating app: ${app.name}`)
+
+    try {
+      const response = await fetch(`${this.baseUrl}/api/apps`, {
+        method: "POST",
+        headers: this.getHeaders(),
+        body: JSON.stringify(app),
+      })
+
+      if (response.ok) {
+        const data = await response.json()
+        debugLog("HomarrApi", `App "${app.name}" created with ID ${data.appId}`)
+        return data.appId
+      }
+
+      const text = await response.text()
+      debugLog("HomarrApi", `Failed to create app: ${response.status} - ${text}`)
+      return null
+    } catch (error) {
+      debugLog("HomarrApi", `Failed to create app: ${error}`)
+      return null
+    }
+  }
+
+  /**
+   * Build app config for an easiarr app
+   */
+  buildAppConfig(appConfig: AppConfig): Omit<HomarrApp, "id" | "appId"> | null {
+    const appDef = getApp(appConfig.id)
+    if (!appDef) return null
+
+    // Skip apps without web UI
+    if (appDef.defaultPort === 0) return null
+
+    const port = appConfig.port || appDef.defaultPort
+
+    return {
+      name: appDef.name,
+      description: appDef.description || null,
+      iconUrl: `https://cdn.jsdelivr.net/gh/walkxcode/dashboard-icons/png/${appConfig.id}.png`,
+      href: `http://${appConfig.id}:${port}`,
+      pingUrl: `http://${appConfig.id}:${port}`,
+    }
+  }
+
+  /**
+   * Run the auto-setup process for Homarr
+   */
+  async setup(options: AutoSetupOptions): Promise<AutoSetupResult> {
+    const { username, password } = options
+
+    try {
+      // Check if reachable
+      const healthy = await this.isHealthy()
+      if (!healthy) {
+        return { success: false, message: "Homarr not reachable" }
+      }
+
+      // Check if users exist
+      const users = await this.getUsers()
+      let userCreated = false
+
+      if (users.length === 0) {
+        // Try to create initial user
+        userCreated = await this.createUser(username, password)
+      }
+
+      return {
+        success: true,
+        message: userCreated ? "User created, ready" : "Ready - add apps via UI or API",
+        data: { userCreated },
+      }
+    } catch (error) {
+      return { success: false, message: `${error}` }
+    }
+  }
+
+  /**
+   * Auto-add apps for enabled easiarr services
+   */
+  async setupEasiarrApps(apps: AppConfig[]): Promise<number> {
+    let addedCount = 0
+
+    // Get existing apps to avoid duplicates
+    const existingApps = await this.getApps()
+    const existingNames = new Set(existingApps.map((a) => a.name))
+
+    for (const appConfig of apps) {
+      if (!appConfig.enabled) continue
+
+      const homarrApp = this.buildAppConfig(appConfig)
+      if (!homarrApp) continue
+
+      // Skip if already exists
+      if (existingNames.has(homarrApp.name)) {
+        debugLog("HomarrApi", `App "${homarrApp.name}" already exists, skipping`)
+        continue
+      }
+
+      const appId = await this.createApp(homarrApp)
+      if (appId) {
+        addedCount++
+      }
+    }
+
+    return addedCount
+  }
+}

package/src/api/jellyfin-api.ts

@@ -4,6 +4,7 @@
  */
 
 import { debugLog } from "../utils/debug"
+import type { IAutoSetupClient, AutoSetupOptions, AutoSetupResult } from "./auto-setup-types"
 
 // ==========================================
 // Startup Wizard Types
@@ -100,7 +101,7 @@ export interface AuthResult {
 // Jellyfin Client
 // ==========================================
 
-export class JellyfinClient {
+export class JellyfinClient implements IAutoSetupClient {
   // ==========================================
   // User Management
   // ==========================================
@@ -410,4 +411,63 @@ export class JellyfinClient {
   async getPublicSystemInfo(): Promise<SystemInfo> {
     return this.request<SystemInfo>("/System/Info/Public")
   }
+
+  /**
+   * Check if already configured (wizard completed)
+   */
+  async isInitialized(): Promise<boolean> {
+    return this.isStartupComplete()
+  }
+
+  /**
+   * Run the auto-setup process for Jellyfin
+   */
+  async setup(options: AutoSetupOptions): Promise<AutoSetupResult> {
+    const { username, password } = options
+
+    try {
+      // Check if reachable
+      const healthy = await this.isHealthy()
+      if (!healthy) {
+        return { success: false, message: "Jellyfin not reachable" }
+      }
+
+      // Check if wizard already completed
+      const initialized = await this.isStartupComplete()
+      if (initialized) {
+        return {
+          success: true,
+          message: "Already configured",
+          data: { alreadyInitialized: true },
+        }
+      }
+
+      // Run the setup wizard
+      await this.runSetupWizard(username, password)
+
+      // Try to authenticate to get access token
+      const authResult = await this.authenticate(username, password)
+
+      // Create API key for Homepage etc.
+      let apiKey: string | undefined
+      try {
+        apiKey = await this.createApiKey("easiarr")
+      } catch {
+        // API key creation may fail if permission issues
+      }
+
+      return {
+        success: true,
+        message: "Setup wizard completed",
+        data: {
+          accessToken: authResult.AccessToken,
+          serverId: authResult.ServerId,
+          apiKey,
+        },
+        envUpdates: apiKey ? { API_KEY_JELLYFIN: apiKey } : undefined,
+      }
+    } catch (error) {
+      return { success: false, message: `${error}` }
+    }
+  }
 }

package/src/api/jellyseerr-api.ts

@@ -9,6 +9,7 @@
  */
 
 import { debugLog } from "../utils/debug"
+import type { IAutoSetupClient, AutoSetupOptions, AutoSetupResult } from "./auto-setup-types"
 
 // ==========================================
 // Enums (from Jellyseerr server/constants/server.ts)
@@ -143,7 +144,7 @@ interface JellyfinLoginRequest {
 // Client
 // ==========================================
 
-export class JellyseerrClient {
+export class JellyseerrClient implements IAutoSetupClient {
   private baseUrl: string
   private cookie?: string
 
@@ -535,4 +536,51 @@ export class JellyseerrClient {
       return null
     }
   }
+
+  /**
+   * Run the auto-setup process for Jellyseerr
+   */
+  async setup(options: AutoSetupOptions): Promise<AutoSetupResult> {
+    const { username, password, env } = options
+
+    try {
+      // Check if reachable
+      const healthy = await this.isHealthy()
+      if (!healthy) {
+        return { success: false, message: "Jellyseerr not reachable" }
+      }
+
+      // Check if already initialized
+      const initialized = await this.isInitialized()
+      if (initialized) {
+        // Get API key from settings
+        const settings = await this.getMainSettings()
+        return {
+          success: true,
+          message: "Already configured",
+          data: { apiKey: settings.apiKey },
+          envUpdates: { API_KEY_JELLYSEERR: settings.apiKey },
+        }
+      }
+
+      // Get Jellyfin connection details from env
+      const jellyfinHost = env["JELLYFIN_HOST"] || "jellyfin"
+      const jellyfinPort = parseInt(env["JELLYFIN_PORT"] || "8096", 10)
+
+      // Run the setup wizard
+      const apiKey = await this.runJellyfinSetup(jellyfinHost, jellyfinPort, username, password)
+
+      // Mark as initialized
+      await this.initialize()
+
+      return {
+        success: true,
+        message: "Jellyseerr configured with Jellyfin",
+        data: { apiKey },
+        envUpdates: { API_KEY_JELLYSEERR: apiKey },
+      }
+    } catch (error) {
+      return { success: false, message: `${error}` }
+    }
+  }
 }