Files
flimmer/tests/fixtures/jellyfin.ts
T
Florian Wilde dd2b7dd48b
CI / pruefen (pull_request) Canceled after 0s
Jellyfin anbinden: Bestand und Sichtungen uebernehmen
Zugeordnet wird ueber die TMDB-Kennung, die Jellyfin zu jedem Item
mitliefert — dieselbe Kennung, auf der Flimmers Katalog ohnehin aufbaut. Eine
unscharfe Suche ueber Titel und Jahr ist damit nicht noetig: die Zuordnung ist
eindeutig oder sie findet nicht statt. Was Jellyfin ohne Kennung fuehrt,
landet im Bericht statt falsch zugeordnet zu werden.

Angemeldet wird mit Benutzername und Passwort, nicht mit einem API-Schluessel.
Mit einem Schluessel liefert Jellyfin den Bestand ohne UserData, also ohne
Gesehen-Status — und zwar ohne Fehlermeldung. Der Verbindungstest prueft
deshalb ausdruecklich nach und sagt es, statt den Abgleich stumm ins Leere
laufen zu lassen. Das Zugangstoken liegt mit AES-256-GCM verschluesselt in der
Datenbank; abgeleitet aus AUTH_SECRET.

Der Abgleich ist eine Einbahnstrasse: er ergaenzt, was auf dem Server liegt
oder dort gelaufen ist, und loescht nie etwas, das in Flimmer steht. Fehlende
Titel werden nur aufgenommen, wenn das Haekchen gesetzt ist — im taeglichen
Lauf also nie.

Entdoppelt wird zweifach: Episoden ueber (userId, episodeId, run), Filme
ausdruecklich per Nachschlagen. Bei Filmen ist episodeId null, und Postgres
behandelt NULL im eindeutigen Index als jeweils verschieden — der Index greift
dort nicht.

Watch.source haelt fest, was von wo kam. Ohne diese Angabe liesse sich spaeter
nicht mehr sagen, welche Sichtung aus Jellyfin stammt.

Umgesetzt sind Stufe 1 und 2. Stufe 3 (Zurueckschreiben) kommt in der
Abnahmeliste nicht vor und braeuchte eine Versionsweiche, die sich ohne echten
Server nicht verlaesslich pruefen laesst; das Feld writeBack ist angelegt, die
Logik dahinter bleibt leer.

Elf Tests gegen nachgebildete Antworten. Zusaetzlich der ganze Klickweg gegen
einen echten HTTP-Server im Produktionsbau: verbinden, pruefen, abgleichen,
zweiter Lauf ohne Dubletten, und der Warnfall ohne UserData.

Refs #1
2026-09-02 09:24:38 +02:00

162 lines
4.9 KiB
TypeScript

import { SERIES_ID, MOVIE_ID, MOVIE_2_ID } from "./tmdb";
/**
* Nachgebildete Jellyfin-Antworten.
*
* Damit lässt sich der ganze Abgleich prüfen, ohne einen Jellyfin-Server zu
* brauchen. Der Aufbau entspricht dem, was Jellyfin tatsächlich liefert —
* gekürzt auf die Felder, die Flimmer liest.
*
* Absichtlich enthalten: ein Item **ohne** TMDB-Kennung und eines mit einer
* Kennung, die nicht im Katalog steht. Beides muss im Bericht landen, statt
* den Lauf zu stören.
*/
export const JELLYFIN_URL = "http://jellyfin.test:8096";
export const JELLYFIN_USER_ID = "jf-user-0001";
export const JELLYFIN_TOKEN = "jf-token-abcdef";
export const SERIES_ITEM_ID = "jf-series-1";
export const items = {
/** Film, gesehen — mit Termin. */
filmGesehen: {
Id: "jf-movie-1",
Name: "Die Stille zwischen den Bildern",
Type: "Movie",
ProviderIds: { Tmdb: String(MOVIE_ID) },
ProductionYear: 2024,
UserData: { Played: true, PlayCount: 3, LastPlayedDate: "2026-07-14T20:15:00.0000000Z" },
},
/** Film, vorhanden aber nicht gesehen. */
filmUngesehen: {
Id: "jf-movie-2",
Name: "Die Stille zwischen den Bildern II",
Type: "Movie",
ProviderIds: { Tmdb: String(MOVIE_2_ID) },
ProductionYear: 2026,
UserData: { Played: false, PlayCount: 0, LastPlayedDate: null },
},
/** Episode, gesehen — die TMDB-Kennung hängt an der Serie darüber. */
episodeGesehen: {
Id: "jf-episode-1",
Name: "Erste Nacht",
Type: "Episode",
SeriesId: SERIES_ITEM_ID,
SeriesName: "Nordlicht",
ParentIndexNumber: 1,
IndexNumber: 1,
ProviderIds: {},
UserData: { Played: true, PlayCount: 1, LastPlayedDate: "2026-08-01T21:00:00.0000000Z" },
},
/** Episode, ungesehen. */
episodeUngesehen: {
Id: "jf-episode-2",
Name: "Zweite Nacht",
Type: "Episode",
SeriesId: SERIES_ITEM_ID,
SeriesName: "Nordlicht",
ParentIndexNumber: 1,
IndexNumber: 2,
ProviderIds: {},
UserData: { Played: false, PlayCount: 0, LastPlayedDate: null },
},
/** Ohne TMDB-Kennung — landet im Bericht. */
ohneKennung: {
Id: "jf-movie-3",
Name: "Urlaubsvideo 2019",
Type: "Movie",
ProviderIds: {},
UserData: { Played: true, PlayCount: 1, LastPlayedDate: "2026-01-01T12:00:00.0000000Z" },
},
/** Kennung vorhanden, aber nicht im Katalog — landet ebenfalls im Bericht. */
fremd: {
Id: "jf-movie-4",
Name: "Ein fremder Film",
Type: "Movie",
ProviderIds: { Tmdb: "424242" },
UserData: { Played: false, PlayCount: 0, LastPlayedDate: null },
},
} as const;
export const seriesItem = {
Id: SERIES_ITEM_ID,
Name: "Nordlicht",
Type: "Series",
ProviderIds: { Tmdb: String(SERIES_ID) },
};
export const ALLE_ITEMS = Object.values(items);
type StubOptions = {
/** Ohne UserData — so verhält sich Jellyfin bei Anmeldung per API-Key. */
ohneUserData?: boolean;
/** Anmeldung ablehnen. */
abweisen?: boolean;
};
/**
* Hängt sich in `fetch` und beantwortet die Jellyfin-Endpunkte.
*
* Gibt die aufgerufenen Pfade zurück — damit lässt sich prüfen, dass ein
* zweiter Lauf nicht mehr Arbeit macht als nötig.
*/
export function installJellyfinStub(options: StubOptions = {}) {
const original = globalThis.fetch;
const calls: string[] = [];
globalThis.fetch = (async (input: string | URL | Request, init?: RequestInit) => {
const url = new URL(typeof input === "string" ? input : input.toString());
calls.push(url.pathname);
const json = (body: unknown) =>
new Response(JSON.stringify(body), {
status: 200,
headers: { "content-type": "application/json" },
});
if (url.pathname === "/Users/AuthenticateByName") {
if (options.abweisen) return new Response("", { status: 401 });
return json({
AccessToken: JELLYFIN_TOKEN,
User: { Id: JELLYFIN_USER_ID, Name: "florian" },
});
}
if (url.pathname === "/System/Info") {
return json({ ServerName: "Heimserver", Version: "10.10.3" });
}
if (url.pathname === "/Items") {
const ids = url.searchParams.get("Ids");
if (ids) {
// Abfrage der Serien-Kopfdaten.
const gesucht = new Set(ids.split(","));
return json({ Items: gesucht.has(SERIES_ITEM_ID) ? [seriesItem] : [] });
}
const startIndex = Number(url.searchParams.get("StartIndex") ?? "0");
const limit = Number(url.searchParams.get("Limit") ?? "500");
const alle = ALLE_ITEMS.map((item) =>
options.ohneUserData ? { ...item, UserData: undefined } : item,
);
return json({
Items: alle.slice(startIndex, startIndex + limit),
TotalRecordCount: alle.length,
});
}
return new Response(JSON.stringify({ error: `Kein Fixture für ${url.pathname}` }), {
status: 404,
headers: { "content-type": "application/json" },
});
}) as typeof fetch;
return {
calls,
restore() {
globalThis.fetch = original;
},
};
}