Resolve merge conflicts: merge all Go backend and React frontend changes

web/src/api/assistant.ts

@@ -0,0 +1,65 @@
+import { api } from './client'
+
+export interface AssistantSession {
+  id: string
+  user_id: string
+  title: string
+  created_at: string
+  updated_at: string
+}
+
+export interface AssistantMessage {
+  id: string
+  session_id: string
+  role: 'user' | 'assistant' | 'system'
+  content: string
+  operation_id?: string
+  created_at: string
+}
+
+export interface SessionView {
+  session: AssistantSession
+  messages: AssistantMessage[]
+}
+
+export const assistantAPI = {
+  listSessions: () =>
+    api.get<AssistantSession[]>('/admin/assistant/sessions').then((r) => r.data),
+
+  createSession: (title?: string) =>
+    api
+      .post<AssistantSession>('/admin/assistant/sessions', { title })
+      .then((r) => r.data),
+
+  getSession: (id: string) =>
+    api.get<SessionView>(`/admin/assistant/session/${id}`).then((r) => r.data),
+
+  deleteSession: (id: string) =>
+    api.delete(`/admin/assistant/session/${id}`).then((r) => r.data),
+
+  chat: (sessionID: string, message: string) =>
+    api
+      .post<SessionView>('/admin/assistant/chat', {
+        session_id: sessionID,
+        message,
+      })
+      .then((r) => r.data),
+
+  execute: (sessionID: string, action: Record<string, unknown>) =>
+    api
+      .post<{ op_id: string }>('/admin/assistant/execute', {
+        session_id: sessionID,
+        action,
+      })
+      .then((r) => r.data),
+
+  undo: (opID: string) =>
+    api.post(`/admin/assistant/undo/${opID}`).then((r) => r.data),
+
+  history: () =>
+    api
+      .get<{ items: { op_id: string; session: string; created_at: string; content: string }[] }>(
+        '/admin/assistant/history',
+      )
+      .then((r) => r.data.items),
+}

web/src/api/discover_extra.ts

@@ -0,0 +1,17 @@
+import { api } from './client'
+import type { DiscoverItem, DiscoverSection } from '../types'
+
+// discoverExtraAPI wraps the Vue-style multi-section feed used by the
+// React DiscoverPage rails. Use the existing /discover/trending and
+// /discover/popular helpers for the simple cases.
+export const discoverExtraAPI = {
+  sections: () =>
+    api.get<{ sections: DiscoverSection[] }>('/discover/sections').then((r) => r.data.sections),
+
+  feed: (sectionKeys: string[]) =>
+    api
+      .get<Record<string, DiscoverItem[] | null>>('/discover/feed', {
+        params: { sections: sectionKeys.join(',') },
+      })
+      .then((r) => r.data),
+}

web/src/api/download_clients.ts

@@ -0,0 +1,53 @@
+import { api } from './client'
+
+export type DownloadClientType = 'qbittorrent' | 'aria2' | 'transmission'
+
+export interface DownloadClient {
+  id: string
+  name: string
+  type: DownloadClientType
+  url: string
+  username?: string
+  save_path?: string
+  is_default: boolean
+  enabled: boolean
+  created_at: string
+  updated_at: string
+}
+
+export interface DownloadClientInput {
+  name: string
+  type: DownloadClientType
+  url: string
+  username?: string
+  password?: string
+  save_path?: string
+  is_default: boolean
+  enabled: boolean
+}
+
+export const downloadClientsAPI = {
+  list: () =>
+    api.get<DownloadClient[]>('/admin/download/clients').then((r) => r.data),
+
+  create: (input: DownloadClientInput) =>
+    api.post<DownloadClient>('/admin/download/clients', input).then((r) => r.data),
+
+  update: (id: string, input: DownloadClientInput) =>
+    api
+      .put<DownloadClient>(`/admin/download/clients/${id}`, input)
+      .then((r) => r.data),
+
+  remove: (id: string) =>
+    api.delete(`/admin/download/clients/${id}`).then((r) => r.data),
+
+  test: (id: string) =>
+    api
+      .post<{ ok: boolean; error?: string }>(`/admin/download/clients/${id}/test`)
+      .then((r) => r.data),
+
+  aria2Stats: (clientID: string) =>
+    api
+      .get('/admin/download/aria2/stats', { params: { client_id: clientID } })
+      .then((r) => r.data),
+}

web/src/api/history.ts

@@ -0,0 +1,30 @@
+import { api } from './client'
+import type { HistoryItem, HistoryStats, Media } from '../types'
+
+// historyAPI wraps /watch-history and /history. The two share storage on
+// the backend; we treat /watch-history as the rich admin/dashboard
+// surface and /history as the legacy resume-position write.
+export const historyAPI = {
+  list: (limit = 50) =>
+    api
+      .get<HistoryItem[]>('/watch-history', { params: { limit } })
+      .then((r) => r.data),
+
+  stats: () => api.get<HistoryStats>('/watch-history/stats').then((r) => r.data),
+
+  continueWatching: (limit = 10) =>
+    api
+      .get<{ history: HistoryItem; media: Media }[]>('/watch-history/continue', {
+        params: { limit },
+      })
+      .then((r) => r.data),
+
+  clear: (mediaID?: string) =>
+    api
+      .delete('/watch-history', {
+        params: mediaID ? { media_id: mediaID } : {},
+      })
+      .then((r) => r.data),
+
+  remove: (id: string) => api.delete(`/watch-history/${id}`).then((r) => r.data),
+}

web/src/api/license.ts

@@ -0,0 +1,71 @@
+import { api } from './client'
+
+// LicenseKey + LicenseActivation mirror the Go model structs.
+export interface LicenseKey {
+  id: string
+  key: string
+  customer?: string
+  plan: string
+  max_activations: number
+  issued_at: string
+  expires_at?: string | null
+  revoked: boolean
+  notes?: string
+  created_at: string
+  updated_at: string
+}
+
+export interface LicenseActivation {
+  id: string
+  key_id: string
+  device_id: string
+  device_name?: string
+  ip?: string
+  unbound_at?: string | null
+  heartbeat_at?: string | null
+  created_at: string
+}
+
+export interface GenerateKeyInput {
+  customer?: string
+  plan?: string
+  max_activations?: number
+  expires_at?: string // RFC3339; "" or omit for perpetual
+  notes?: string
+}
+
+export const licenseAPI = {
+  generate: (input: GenerateKeyInput) =>
+    api.post<LicenseKey>('/admin/license/generate', input).then((r) => r.data),
+
+  list: () => api.get<LicenseKey[]>('/admin/license/list').then((r) => r.data),
+
+  listActivations: (keyID: string) =>
+    api
+      .get<LicenseActivation[]>(`/admin/license/${keyID}/activations`)
+      .then((r) => r.data),
+
+  revoke: (keyID: string) =>
+    api.post(`/admin/license/${keyID}/revoke`).then((r) => r.data),
+
+  unbind: (activationID: string) =>
+    api.post(`/admin/license/activation/${activationID}/unbind`).then((r) => r.data),
+
+  // Self-service
+  activate: (key: string, deviceID: string, deviceName?: string) =>
+    api
+      .post<LicenseActivation>('/license/activate', {
+        key,
+        device_id: deviceID,
+        device_name: deviceName,
+      })
+      .then((r) => r.data),
+
+  status: (keyID: string) =>
+    api
+      .get<{ key: LicenseKey; active_activations: number; valid: boolean }>(
+        '/license/status',
+        { params: { key_id: keyID } },
+      )
+      .then((r) => r.data),
+}

web/src/api/media_extra.ts

@@ -0,0 +1,19 @@
+import { api } from './client'
+import type { Media } from '../types'
+
+// Auxiliary media surfaces used by the home page rails and the admin
+// dashboard "library composition" card.
+export const mediaExtraAPI = {
+  recent: (limit = 12) =>
+    api.get<Media[]>('/media/recent', { params: { limit } }).then((r) => r.data),
+
+  stats: () =>
+    api
+      .get<{
+        by_type: { movies: number; tv: number; anime: number; music: number; unscraped: number }
+        total: number
+        total_size: number
+        total_seconds: number
+      }>('/media/stats')
+      .then((r) => r.data),
+}

web/src/api/notify_channels.ts

@@ -0,0 +1,29 @@
+import { api } from './client'
+import type { NotifyChannel } from '../types'
+
+// Payload accepted by create / update. `events` and `enabled` are optional.
+export interface NotifyChannelInput {
+  name: string
+  channel_type: NotifyChannel['channel_type']
+  config: Record<string, string>
+  events?: string[]
+  enabled?: boolean
+}
+
+// notifyChannelsAPI wraps the admin /admin/notify/channels surface.
+export const notifyChannelsAPI = {
+  list: () =>
+    api.get<NotifyChannel[]>('/admin/notify/channels').then((r) => r.data),
+
+  create: (input: NotifyChannelInput) =>
+    api.post<NotifyChannel>('/admin/notify/channels', input).then((r) => r.data),
+
+  update: (id: string, input: NotifyChannelInput) =>
+    api.put<NotifyChannel>(`/admin/notify/channels/${id}`, input).then((r) => r.data),
+
+  remove: (id: string) =>
+    api.delete(`/admin/notify/channels/${id}`).then((r) => r.data),
+
+  test: (id: string) =>
+    api.post<{ message: string }>(`/admin/notify/channels/${id}/test`).then((r) => r.data),
+}

web/src/api/permissions.ts

@@ -0,0 +1,38 @@
+import { api } from './client'
+
+export interface UserPermission {
+  user_id: string
+  can_play_media: boolean
+  can_favorite: boolean
+  can_view_history: boolean
+  can_view_dashboard: boolean
+  can_view_discover: boolean
+  can_manage_downloads: boolean
+  can_manage_subscriptions: boolean
+  can_manage_sites: boolean
+  can_manage_files: boolean
+  can_manage_strm: boolean
+  can_cast: boolean
+  can_use_ai_assistant: boolean
+  can_access_settings: boolean
+  updated_at: string
+}
+
+export const permissionsAPI = {
+  // Caller's effective permissions; admins always get the all-true set.
+  mine: () => api.get<UserPermission>('/auth/permissions').then((r) => r.data),
+
+  // Admin endpoints
+  get: (userID: string) =>
+    api.get<UserPermission>(`/admin/users/${userID}/permissions`).then((r) => r.data),
+
+  save: (userID: string, p: UserPermission) =>
+    api
+      .put<UserPermission>(`/admin/users/${userID}/permissions`, p)
+      .then((r) => r.data),
+
+  reset: (userID: string) =>
+    api
+      .post<UserPermission>(`/admin/users/${userID}/permissions/reset`)
+      .then((r) => r.data),
+}

web/src/api/play_profiles.ts

@@ -0,0 +1,35 @@
+import { api } from './client'
+import type { PlayProfile } from '../types'
+
+// Payload accepted by create / update.
+export interface PlayProfileInput {
+  user_id?: string
+  name: string
+  is_default: boolean
+  content_rating_limit?: string
+  allow_adult: boolean
+  require_pin: boolean
+  pin?: string
+  preferred_subtitle_lang?: string
+  preferred_audio_lang?: string
+  autoplay_next: boolean
+  skip_intro: boolean
+  allowed_library_ids: string[]
+}
+
+// playProfilesAPI wraps /play-profiles. The admin variant adds ?all=true.
+export const playProfilesAPI = {
+  list: (all = false) =>
+    api
+      .get<PlayProfile[]>('/play-profiles', { params: all ? { all: 'true' } : {} })
+      .then((r) => r.data),
+
+  create: (input: PlayProfileInput) =>
+    api.post<PlayProfile>('/play-profiles', input).then((r) => r.data),
+
+  update: (id: string, input: PlayProfileInput) =>
+    api.put<PlayProfile>(`/play-profiles/${id}`, input).then((r) => r.data),
+
+  remove: (id: string) =>
+    api.delete(`/play-profiles/${id}`).then((r) => r.data),
+}

web/src/api/sites.ts

@@ -1,6 +1,59 @@
 import { api } from './client'
 
-// Site management API - matches Go backend /api/sites endpoints
+// ─── TypeScript interfaces ──────────────────────────────────────────────
+
+export interface Site {
+  id: string
+  name: string
+  base_url: string
+  site_type: string
+  auth_type: string
+  cookie?: string
+  api_key?: string
+  auth_header?: string
+  user_agent?: string
+  rss_url?: string
+  timeout: number
+  priority: number
+  use_proxy: boolean
+  enabled: boolean
+  login_status: string
+  downloader?: string
+  created_at: string
+  updated_at: string
+}
+
+export interface SiteSearchResult {
+  site_name: string
+  site_id: string
+  title: string
+  torrent_url: string
+  download_url: string
+  size: number
+  seeders: number
+  leechers: number
+  free: boolean
+}
+
+export interface CreateSiteInput {
+  name: string
+  base_url: string
+  site_type?: string
+  auth_type?: string
+  cookie?: string
+  api_key?: string
+  auth_header?: string
+  user_agent?: string
+  rss_url?: string
+  timeout?: number
+  priority?: number
+  use_proxy?: boolean
+  enabled?: boolean
+  downloader?: string
+}
+
+// ─── API client ─────────────────────────────────────────────────────────
+
 export const sitesAPI = {
   // List all sites
   list: () => api.get('/sites').then((r) => r.data),
@@ -29,4 +82,10 @@ export const sitesAPI = {
 
   // Get supported auth types
   authTypes: () => api.get('/sites/auth-types').then((r) => r.data),
+
+  // Search across all sites
+  search: (keyword: string) =>
+    api
+      .get('/sites/search', { params: { keyword } })
+      .then((r) => r.data),
 }

web/src/api/stats_extra.ts

@@ -0,0 +1,40 @@
+import { api } from './client'
+import type { Hardware, Library, Media } from '../types'
+
+// statsExtraAPI exposes the admin dashboard surfaces beyond /stats.
+export const statsExtraAPI = {
+  overview: () =>
+    api
+      .get<{
+        libraries: number
+        media_count: number
+        users_count: number
+        total_size: number
+        total_seconds: number
+        generated_at: string
+      }>('/stats/overview')
+      .then((r) => r.data),
+
+  trend: (days = 14) =>
+    api
+      .get<{ trend: { day: string; count: number }[]; days: number }>('/stats/trend', {
+        params: { days },
+      })
+      .then((r) => r.data),
+
+  topContent: (limit = 10) =>
+    api
+      .get<{
+        items: { media: Media; play_count: number; last_played: string }[]
+      }>('/stats/top-content', { params: { limit } })
+      .then((r) => r.data),
+
+  libraries: () =>
+    api
+      .get<{
+        libraries: { library: Library; item_count: number; total_size: number }[]
+      }>('/stats/libraries')
+      .then((r) => r.data),
+
+  monitor: () => api.get<Hardware>('/stats/monitor').then((r) => r.data),
+}

web/src/api/storage_config.ts

@@ -0,0 +1,36 @@
+import { api } from './client'
+
+export type StorageType = 'alist' | 's3' | 'webdav'
+
+export interface StorageConfig {
+  id: string
+  type: StorageType
+  config: Record<string, string>
+  enabled: boolean
+  last_error?: string
+  created_at: string
+  updated_at: string
+}
+
+export const storageAPI = {
+  status: () =>
+    api
+      .get<{ items: StorageConfig[] }>('/admin/storage/status')
+      .then((r) => r.data.items),
+
+  get: (type: StorageType) =>
+    api.get<StorageConfig>(`/admin/storage/${type}`).then((r) => r.data),
+
+  save: (type: StorageType, config: Record<string, string>, enabled = true) =>
+    api
+      .put<StorageConfig>(`/admin/storage/${type}`, { type, config, enabled })
+      .then((r) => r.data),
+
+  test: (type: StorageType, config: Record<string, string>) =>
+    api
+      .post<{ ok: boolean; error?: string }>(`/admin/storage/${type}/test`, {
+        type,
+        config,
+      })
+      .then((r) => r.data),
+}

web/src/api/system.ts

@@ -0,0 +1,38 @@
+import { api } from './client'
+
+// systemAPI wraps the read-only /system/* metadata endpoints used by the
+// React shell (footer, admin dashboard, scheduler page).
+export const systemAPI = {
+  info: () =>
+    api
+      .get<{
+        name: string
+        version: string
+        go: string
+        os: string
+        arch: string
+        data_dir: string
+        cache_dir: string
+      }>('/system/info')
+      .then((r) => r.data),
+
+  status: () =>
+    api
+      .get<{
+        uptime_seconds: number
+        goroutines: number
+        cpu_percent?: number
+        memory_used?: number
+        memory_total?: number
+        disk_used?: number
+        disk_total?: number
+      }>('/system/status')
+      .then((r) => r.data),
+
+  scheduler: () =>
+    api
+      .get<{ jobs: { name: string; cron: string; next_run?: string; last_run?: string }[] }>(
+        '/system/scheduler',
+      )
+      .then((r) => r.data),
+}

web/src/api/tools.ts

@@ -0,0 +1,21 @@
+import { api } from './client'
+
+// toolsAPI groups admin-only endpoints that don't fit the other domain
+// modules: organizing media files into the canonical naming layout, and
+// dispatching a test notification through the configured channels.
+export const toolsAPI = {
+  organizeMedia: (mediaID: string) =>
+    api
+      .post<{ path: string }>(`/admin/media/${mediaID}/organize`)
+      .then((r) => r.data),
+
+  organizeLibrary: (libraryID: string) =>
+    api
+      .post<Record<string, unknown>>(`/admin/libraries/${libraryID}/organize`)
+      .then((r) => r.data),
+
+  notifyTest: (title: string, body: string) =>
+    api
+      .post<{ message: string }>('/admin/notify/test', { title, body })
+      .then((r) => r.data),
+}