Merge pull request #122 from Masutayunikon/release-please--branches--main

chore(main): release 3.17.1

CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [3.17.1](https://github.com/Masutayunikon/FanKarr/compare/v3.17.0...v3.17.1) (2026-05-24)
+
+
+### Bug Fixes
+
+* **api:** la recherche ne retourne plus les series sans torrents ([7b18631](https://github.com/Masutayunikon/FanKarr/commit/7b1863180f28cfaaccff69cb949fa6116a2c8cc6))
+* **client:** alldebrid utilise maintenant les routes 4.1 ([7b18631](https://github.com/Masutayunikon/FanKarr/commit/7b1863180f28cfaaccff69cb949fa6116a2c8cc6))
+* **readme:** update ([edec048](https://github.com/Masutayunikon/FanKarr/commit/edec048e30e1a5a528f1b2888f3db1708eeb15f9))
+* **readme:** update ([bf9b18e](https://github.com/Masutayunikon/FanKarr/commit/bf9b18ec0002e84b040738f7229ed4570f5dcd32))
+
 ## [3.17.0](https://github.com/Masutayunikon/FanKarr/compare/v3.16.0...v3.17.0) (2026-05-23)
 
 

README.md

@@ -50,22 +50,37 @@ Inspiré de Radarr/Sonarr — interface dédiée aux éditions Kai & Yabai
 - **Dropdown intelligent** sur chaque bouton quand plusieurs sources sont disponibles (qualités différentes, packs différents)
 - **"Tout télécharger"** unifié — sélectionne automatiquement les épisodes non couverts par l'intégrale choisie et complète avec les packs individuels
 - **Progression par fichier** — barre de téléchargement au niveau de l'épisode, même pour les fichiers dans un pack intégrale
+- **RSS Sync** — surveillance automatique des nouvelles sorties toutes les 6 heures pour les séries abonnées, téléchargement sans intervention
 
 ### 🗂️ Organisation
 - **Import automatique** des fichiers terminés vers votre médiathèque, déclenché dès la fin d'un téléchargement ou toutes les 5 minutes en arrière-plan
 - **Scan de médiathèque** — détecte les fichiers déjà présents sur le disque et les référence sans les déplacer
 - **Mode hardlink** (recommandé), **déplacement** ou **copie** — le hardlink préserve le seeding du client torrent
 - **Désimport automatique** optionnel quand un fichier est supprimé du disque
+- **Suppression du dossier série** automatique lors d'un désimport complet avec suppression des fichiers
+
+### 📋 Demandes
+- **Système de demandes** — les utilisateurs peuvent demander des séries, saisons ou épisodes spécifiques depuis l'interface ou le plugin Jellyfin
+- **Workflow admin** — approbation / refus avec message / marquage disponible depuis la page dédiée
+- **Auto-téléchargement** configurable par utilisateur — les demandes sont approuvées et lancées automatiquement pour les utilisateurs autorisés
+- **Suppression en masse** pour les admins (bouton "Tout supprimer")
+- **Nettoyage automatique** — les demandes marquées "disponible" sont supprimées lors du désimport de la série concernée
 
 ### 🏷️ Métadonnées & Affichage
 - **Badges de langue** VOSTFR et MULTI avec drapeaux sur chaque épisode (détectés automatiquement)
 - **Support NFO** — nommage compatible avec les plugins Jellyfin/Plex utilisant les fichiers `.nfo`
 - **Intégration Plex** — connexion à votre serveur Plex pour déclencher le scan médiathèque après import
 
+### 👥 Utilisateurs & Jellyfin
+- **Multi-utilisateurs** avec rôles (`admin` / `user`) et système d'invitations
+- **SSO Jellyfin** — les utilisateurs se connectent avec leur compte Jellyfin, aucun mot de passe FanKarr requis
+- **Synchronisation Jellyfin** — création automatique des comptes FanKarr pour les utilisateurs Jellyfin, toutes les heures en arrière-plan ou manuellement depuis les paramètres
+- **Token API personnel** — chaque utilisateur dispose d'un token pour accéder à l'API publique
+
 ### ⚙️ Système
 - **Logs centralisés** — filtre par niveau et source, rotation automatique, clear depuis l'UI
 - **Authentification** par mot de passe avec session JWT
-- **Multi-client torrent** — architecture extensible (qBittorrent supporté)
+- **Multi-client torrent** — qBittorrent, Transmission, Synology Download Station, µTorrent, rTorrent, Real-Debrid, AllDebrid
 - **Compatible Docker / Runtipi / Binaire autonome**
 
 ---
@@ -222,6 +237,117 @@ Le **scan médiathèque** permet de référencer des fichiers déjà présents s
 
 ---
 
+## Plugin Jellyfin — FanKarr Search
+
+Un plugin Jellyfin est disponible pour intégrer la recherche FanKarr directement dans l'interface de votre serveur. Vos utilisateurs peuvent parcourir le catalogue et demander des séries sans quitter Jellyfin.
+
+👉 **[jellyfin-plugin-fankarr-search](https://github.com/Masutayunikon/jellyfin-plugin-fankarr-search)**
+
+Le plugin nécessite **[Jellyfin JavaScript Injector](https://github.com/n00bcodr/Jellyfin-JavaScript-Injector)** — consultez le README du plugin pour les instructions d'installation.
+
+### Synchronisation des utilisateurs
+
+FanKarr peut créer automatiquement un compte pour chaque utilisateur Jellyfin actif. La synchronisation se fait :
+- **Automatiquement** toutes les heures en arrière-plan (si Jellyfin est configuré)
+- **Manuellement** depuis **Paramètres → Jellyfin → Synchroniser**
+
+Les comptes créés n'ont pas de mot de passe FanKarr — l'authentification se fait uniquement via SSO Jellyfin.
+
+---
+
+## API Publique
+
+FanKarr expose une API publique `v1` utilisée par le plugin Jellyfin et toute intégration tierce.
+
+**Auth** : `Authorization: Bearer <token>` (token visible dans **Profil → Token API**)
+
+| Méthode | Endpoint | Description |
+|---------|----------|-------------|
+| `POST` | `/api/v1/auth/jellyfin` | Échange un token Jellyfin contre un token FanKarr |
+| `GET` | `/api/v1/auth/me` | Informations de l'utilisateur connecté |
+| `GET` | `/api/v1/series/search?q=` | Recherche dans le catalogue (titre, note, année, description, demande en cours) |
+| `GET` | `/api/v1/series/:id` | Détail d'une série — saisons et épisodes (proxy FanKai) |
+| `POST` | `/api/v1/requests` | Créer ou mettre à jour une demande |
+| `GET` | `/api/v1/requests` | Demandes de l'utilisateur authentifié |
+
+### SSO Jellyfin
+
+```http
+POST /api/v1/auth/jellyfin
+Content-Type: application/json
+
+{ "jellyfinUserId": "...", "jellyfinToken": "..." }
+```
+
+Retourne `{ token, username, role }`. Le `token` est ensuite utilisé comme Bearer pour tous les autres appels.
+
+### Recherche
+
+```http
+GET /api/v1/series/search?q=dragon+ball
+Authorization: Bearer <token>
+```
+
+```json
+[
+  {
+    "id": 42,
+    "title": "Dragon Ball Z Kai",
+    "original_title": "DRAGON BALL Z KAI",
+    "image": "https://...",
+    "year": 2009,
+    "rating": 8.5,
+    "description": "Suite de Dragon Ball...",
+    "request": {
+      "id": "uuid",
+      "status": "pending",
+      "seasons": [1, 2],
+      "episodes": []
+    }
+  }
+]
+```
+
+Le champ `request` est `null` si aucune demande active n'existe pour cette série.
+
+### Détail série (saisons & épisodes)
+
+```http
+GET /api/v1/series/42
+Authorization: Bearer <token>
+```
+
+```json
+{
+  "id": 42,
+  "title": "Dragon Ball Z Kai",
+  "seasons": [
+    {
+      "season_number": 1,
+      "episodes": [
+        { "id": 101, "episode_number": 1, "title": "...", "image": "https://..." }
+      ]
+    }
+  ]
+}
+```
+
+### Créer une demande
+
+```http
+POST /api/v1/requests
+Authorization: Bearer <token>
+Content-Type: application/json
+
+{ "serieId": 42, "serieName": "Dragon Ball Z Kai", "seasons": [1, 2] }
+```
+
+- `seasons` : numéros de saison (`season_number`). Tableau vide = toutes les saisons.
+- `episodes` : IDs d'épisodes (`episode.id`). Prend le dessus sur `seasons` si renseigné.
+- Si une demande active existe déjà, les saisons/épisodes sont **fusionnés**.
+
+---
+
 ## Runtipi
 
 FanKarr est disponible dans l'appstore personnalisé. Pour l'installer :
@@ -248,6 +374,7 @@ FanKarr est disponible dans l'appstore personnalisé. Pour l'installer :
 ## Liens
 
 - [fankai.fr](https://fankai.fr) — Le projet Fankai
+- [Plugin Jellyfin FanKarr Search](https://github.com/Masutayunikon/jellyfin-plugin-fankarr-search) — Recherche et demandes FanKarr dans Jellyfin
 - [Plugin Jellyfin Fankai](https://github.com/Nackophilz/fankai_jellyfin) — Reconnaissance des métadonnées dans Jellyfin
 - [fankarr-scraper](https://github.com/masutayunikon/fankarr-scraper) — Pipeline de collecte des torrents
-- [runtipi-appstore](https://github.com/Masutayunikon/runtipi-appstore) — Appstore Runtipi personnel
+- [runtipi-appstore](https://github.com/Masutayunikon/runtipi-appstore) — Appstore Runtipi personnel

server/routes/public-api.ts

@@ -97,6 +97,7 @@ router.get('/v1/series/search', requireApiToken, async (req, res) => {
         }
 
         const results = all
+            .filter(s => availableSet.has(s.id))
             .filter(s => !q || s.title?.toLowerCase().includes(q) || s.original_title?.toLowerCase().includes(q))
             .slice(0, 50)
             .map(s => ({
@@ -104,7 +105,6 @@ router.get('/v1/series/search', requireApiToken, async (req, res) => {
                 title         : s.title,
                 original_title: s.original_title ?? null,
                 image         : s.poster_image ?? null,
-                available     : availableSet.has(s.id),
                 year          : s.year ?? null,
                 rating        : s.rating?.value ?? null,
                 description   : s.plot ?? null,

server/torrent-clients/alldebrid.ts

@@ -1,12 +1,13 @@
 import type { TorrentClientDriver, TorrentInfo, TorrentFileProgress, DownloadOptions } from './index.js'
 import { logger } from '../logger.js'
 
-const AD_BASE  = 'https://api.alldebrid.com/v4'
-const AD_AGENT = 'FanKarr'
+const AD_BASE    = 'https://api.alldebrid.com/v4.1'
+const AD_BASE_V4 = 'https://api.alldebrid.com/v4'
+const AD_AGENT   = 'FanKarr'
 
-function adUrl(config: Record<string, string | number>, path: string): string {
+function adUrl(config: Record<string, string | number>, path: string, base = AD_BASE): string {
     const sep = path.includes('?') ? '&' : '?'
-    return `${AD_BASE}${path}${sep}agent=${AD_AGENT}&apikey=${config.apiKey}`
+    return `${base}${path}${sep}agent=${AD_AGENT}&apikey=${config.apiKey}`
 }
 
 async function adFetch(
@@ -14,8 +15,9 @@ async function adFetch(
     method: 'GET' | 'POST' | 'DELETE',
     path  : string,
     body ?: URLSearchParams | FormData,
+    base  = AD_BASE,
 ): Promise<any> {
-    const res = await fetch(adUrl(config, path), { method, body })
+    const res = await fetch(adUrl(config, path, base), { method, body })
     if (!res.ok) {
         const text = await res.text().catch(() => '')
         throw new Error(`AllDebrid HTTP ${res.status} : ${text}`)
@@ -101,21 +103,6 @@ const adDriver: TorrentClientDriver = {
             logger.warn('alldebrid', `Sélection de fichier (index ${options.file_index}) non supportée par AllDebrid — pack complet téléchargé`)
 
         const isMagnet = url.startsWith('magnet:')
-        const hash = (options?.infohash?.toLowerCase() ?? null)
-            || url.match(/xt=urn:btih:([a-fA-F0-9]{40,})/i)?.[1]?.toLowerCase()
-            || null
-
-        if (hash) {
-            try {
-                const data     = await adFetch(config, 'GET', '/magnet/status')
-                const magnets: any[] = data.magnets ?? []
-                const existing = magnets.find((m: any) => m.hash?.toLowerCase() === hash)
-                if (existing) {
-                    logger.info('alldebrid', `Torrent ${hash.slice(0, 8)}… déjà présent sur AllDebrid`)
-                    return
-                }
-            } catch {}
-        }
 
         if (isMagnet) {
             const body = new URLSearchParams()
@@ -149,6 +136,10 @@ const adDriver: TorrentClientDriver = {
                 : (statusCode === 4 ? 100 : 0)
             const save_path  = localBase ? `${localBase}/${m.filename ?? m.id}` : ''
 
+            const eta = (typeof m.completionDate === 'number' && m.completionDate > 0)
+                ? Math.max(0, m.completionDate - Math.floor(Date.now() / 1000))
+                : -1
+
             return {
                 hash      : String(m.hash ?? m.id ?? '').toLowerCase(),
                 name      : String(m.filename ?? m.id ?? ''),
@@ -156,11 +147,11 @@ const adDriver: TorrentClientDriver = {
                 progress,
                 size,
                 downloaded,
-                uploaded  : 0,
+                uploaded  : typeof m.uploaded      === 'number' ? m.uploaded      : 0,
                 ratio     : 0,
-                speed     : typeof m.speed === 'number' ? m.speed : 0,
-                upspeed   : 0,
-                eta       : typeof m.eta   === 'number' ? m.eta   : -1,
+                speed     : typeof m.downloadSpeed === 'number' ? m.downloadSpeed : 0,
+                upspeed   : typeof m.uploadSpeed   === 'number' ? m.uploadSpeed   : 0,
+                eta,
                 save_path,
                 category  : '',
             }
@@ -182,17 +173,19 @@ const adDriver: TorrentClientDriver = {
         const target   = magnets.find((m: any) => String(m.hash ?? m.id ?? '').toLowerCase() === hash.toLowerCase())
         if (!target) return []
 
-        const detail = await adFetch(config, 'GET', `/magnet/status?id=${target.id}`)
-        const magnet = Array.isArray(detail.magnets) ? detail.magnets[0] : detail
-
-        const statusCode = typeof magnet.statusCode === 'number' ? magnet.statusCode : 0
-        const size       = typeof magnet.size       === 'number' ? magnet.size       : 0
-        const downloaded = typeof magnet.downloaded === 'number' ? magnet.downloaded : 0
+        const statusCode      = typeof target.statusCode === 'number' ? target.statusCode : 0
+        const size            = typeof target.size       === 'number' ? target.size       : 0
+        const downloaded      = typeof target.downloaded === 'number' ? target.downloaded : 0
         const overallProgress = size > 0 ? downloaded / size : (statusCode === 4 ? 1 : 0)
 
-        if (!Array.isArray(magnet.files)) return []
+        const body = new URLSearchParams()
+        body.append('id[]', String(target.id))
+        const filesData   = await adFetch(config, 'POST', '/magnet/files', body, AD_BASE_V4)
+        const magnetEntry = (filesData.magnets ?? [])[0]
 
-        return flattenFiles(magnet.files).map(f => ({ ...f, progress: overallProgress }))
+        if (!Array.isArray(magnetEntry?.files)) return []
+
+        return flattenFiles(magnetEntry.files).map(f => ({ ...f, progress: overallProgress }))
     },
 }
 

version.txt

@@ -1 +1 @@
-3.17.0
+3.17.1