blomios/ReadaBook
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(api,web): providers ComicVine + MangaDex et pilotage de l'enrichissement

Browse Source 
- Adaptateurs comic-vine et mangadex avec helper de fetch partagé,
  timeouts et fallback durcis sur les providers existants
- Scoring des correspondances amélioré, normalisation de la date de
  publication, chaîne de résolution des providers étendue
- Scanner : statuts par livre (scan/enrichissement) et page admin
  d'automatisation alignée

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Git Agent
2026-08-24 09:11:18 +02:00
parent 93bb40a8cd
commit d79f502dd2
25 changed files with 2812 additions and 231 deletions
Download Patch File Download Diff File Expand all files Collapse all files

52
apps/api/src/metadata/adapters/open-library.provider.ts
View File

@ -1,6 +1,8 @@
import { Injectable } from "@nestjs/common";
import { MetadataLookup, MetadataMatch, MetadataProvider, MetadataProviderConfig, MetadataSearchQuery } from "../metadata.types.js";
import { toIsbn13 } from "../use-cases/extract-identifiers.js";
import { normalizePublishedDate } from "../use-cases/normalize-published-date.js";
import { providerFetch, providerHttpError } from "./provider-fetch.js";
@Injectable()
export class OpenLibraryProvider implements MetadataProvider {
@ -24,11 +26,11 @@ export class OpenLibraryProvider implements MetadataProvider {
if (query.author) url.searchParams.set("author", query.author);
if (query.year) url.searchParams.set("first_publish_year", query.year);
url.searchParams.set("limit", "5");
const response = await fetch(url, {
const response = await providerFetch(this.id, url, {
headers: { "User-Agent": "ReadaBook/0.1 local-library-manager" },
signal: AbortSignal.timeout(4000)
timeoutMs: 4000
});
if (!response.ok) return [];
if (!response.ok) throw await providerHttpError(this.id, response, `OpenLibrary HTTP ${response.status}`);
const data = (await response.json()) as { docs?: Array<Record<string, unknown>> };
return (data.docs ?? []).map((doc) => ({
title: stringValue(doc.title) ?? undefined,
@ -36,28 +38,31 @@ export class OpenLibraryProvider implements MetadataProvider {
author: arrayJoin(doc.author_name),
language: firstArrayValue(doc.language),
publisher: firstArrayValue(doc.publisher),
publishedDate: String(doc.first_publish_year ?? "") || null,
isbn: bestIsbn(doc.isbn, query.isbn ? toIsbn13(query.isbn) : null)
publishedDate: normalizePublishedDate(String(doc.first_publish_year ?? "") || null),
isbn: bestIsbn(doc.isbn, query.isbn ? toIsbn13(query.isbn) : null),
coverUrl: openLibraryCoverUrl(doc.cover_i, firstArrayValue(doc.edition_key) ?? stringValue(doc.cover_edition_key))
}));
}
private async lookupEdition(sourceId: string, expectedIsbn13: string | null): Promise<MetadataMatch | null> {
const editionKey = sourceId.replace(/^\/?books\//, "");
if (!editionKey) return null;
const response = await fetch(`https://openlibrary.org/books/${encodeURIComponent(editionKey)}.json`, {
const response = await providerFetch(this.id, `https://openlibrary.org/books/${encodeURIComponent(editionKey)}.json`, {
headers: { "User-Agent": "ReadaBook/0.1 local-library-manager" },
signal: AbortSignal.timeout(4000)
timeoutMs: 4000
});
if (!response.ok) return null;
if (response.status === 404) return null;
if (!response.ok) throw await providerHttpError(this.id, response, `OpenLibrary HTTP ${response.status}`);
return this.editionToMatch((await response.json()) as Record<string, unknown>, expectedIsbn13);
}
private async lookupIsbn(isbn: string, expectedIsbn13: string | null): Promise<MetadataMatch | null> {
const response = await fetch(`https://openlibrary.org/isbn/${encodeURIComponent(isbn)}.json`, {
const response = await providerFetch(this.id, `https://openlibrary.org/isbn/${encodeURIComponent(isbn)}.json`, {
headers: { "User-Agent": "ReadaBook/0.1 local-library-manager" },
signal: AbortSignal.timeout(4000)
timeoutMs: 4000
});
if (!response.ok) return null;
if (response.status === 404) return null;
if (!response.ok) throw await providerHttpError(this.id, response, `OpenLibrary HTTP ${response.status}`);
return this.editionToMatch((await response.json()) as Record<string, unknown>, expectedIsbn13);
}
@ -70,18 +75,20 @@ export class OpenLibraryProvider implements MetadataProvider {
isbn: bestIsbn([...(asStringArray(edition.isbn_13)), ...(asStringArray(edition.isbn_10))], expectedIsbn13),
language: languageValue(edition.languages),
publisher: firstArrayValue(edition.publishers),
publishedDate: stringValue(edition.publish_date)
publishedDate: normalizePublishedDate(stringValue(edition.publish_date)),
coverUrl: editionCoverUrl(edition)
};
}
private async lookupAuthorName(value: unknown): Promise<string | null> {
const key = (Array.isArray(value) ? value[0] : undefined)?.key;
if (typeof key !== "string") return null;
const response = await fetch(`https://openlibrary.org${key}.json`, {
const response = await providerFetch(this.id, `https://openlibrary.org${key}.json`, {
headers: { "User-Agent": "ReadaBook/0.1 local-library-manager" },
signal: AbortSignal.timeout(3000)
timeoutMs: 3000
});
if (!response.ok) return null;
if (response.status === 404) return null;
if (!response.ok) throw await providerHttpError(this.id, response, `OpenLibrary HTTP ${response.status}`);
const author = (await response.json()) as Record<string, unknown>;
return stringValue(author.name);
}
@ -124,3 +131,18 @@ function languageValue(value: unknown): string | null {
const key = (Array.isArray(value) ? value[0] : undefined)?.key;
return typeof key === "string" ? key.split("/").pop() ?? null : null;
}
function openLibraryCoverUrl(coverId: unknown, editionKey: string | null): string | null {
if (typeof coverId === "number" || typeof coverId === "string") {
return `https://covers.openlibrary.org/b/id/${encodeURIComponent(String(coverId))}-L.jpg`;
}
if (editionKey) {
return `https://covers.openlibrary.org/b/olid/${encodeURIComponent(editionKey)}-L.jpg`;
}
return null;
}
function editionCoverUrl(edition: Record<string, unknown>): string | null {
const covers = Array.isArray(edition.covers) ? edition.covers : [];
return openLibraryCoverUrl(covers[0], stringValue(edition.key)?.split("/").pop() ?? null);
}