fix(api): robustesse des providers de métadonnées

Recherche ISBN directe sur Open Library avec repli titre/auteur,
normalisation des réponses, timeouts et User-Agent explicites sur les
trois providers distants, abandon de l'extraction de jaquette CBR en
échec silencieux (fallback métadonnées seules), tests des providers et
garde du test de migration si better-sqlite3 est indisponible.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

apps/api/src/metadata/adapters/bnf.provider.ts

@@ -1,16 +1,18 @@
 import { Injectable } from "@nestjs/common";
 import { XMLParser } from "fast-xml-parser";
 import { MetadataLookup, MetadataMatch, MetadataProvider, MetadataProviderConfig } from "../metadata.types.js";
+import { toIsbn13 } from "../use-cases/extract-identifiers.js";
 
-const parser = new XMLParser({ ignoreAttributes: false, attributeNamePrefix: "@_" });
+const parser = new XMLParser({ ignoreAttributes: false, attributeNamePrefix: "@_", removeNSPrefix: true });
 
 @Injectable()
 export class BnfProvider implements MetadataProvider {
   readonly id = "bnf" as const;
 
   async lookup(lookup: MetadataLookup, _config: MetadataProviderConfig): Promise<MetadataMatch | null> {
-    const query = lookup.identifiers.isbn13
-      ? `bib.isbn all "${lookup.identifiers.isbn13}"`
+    const isbn = lookup.identifiers.isbn13 ?? lookup.identifiers.isbn10;
+    const query = isbn
+      ? `bib.isbn all "${isbn}"`
       : `bib.title all "${lookup.title.replace(/"/g, " ")}"`;
     const url = new URL("https://catalogue.bnf.fr/api/SRU");
     url.searchParams.set("version", "1.2");
@@ -21,18 +23,46 @@ export class BnfProvider implements MetadataProvider {
     const response = await fetch(url, { signal: AbortSignal.timeout(5000) });
     if (!response.ok) return null;
     const parsed = parser.parse(await response.text());
-    const record = parsed?.searchRetrieveResponse?.records?.record?.recordData;
+    const record = parsed?.searchRetrieveResponse?.records?.record?.recordData?.record;
     if (!record) return null;
-    const text = JSON.stringify(record);
+    const fields = asArray(record.datafield);
     return {
-      title: match(text, /"titleInfo"[^}]*"title":"([^"]+)"/),
-      author: match(text, /"namePart":"([^"]+)"/),
-      publisher: match(text, /"publisher":"([^"]+)"/),
-      publishedDate: match(text, /"dateIssued":"([^"]+)"/)
+      title: subfield(fields, "200", "a") ?? undefined,
+      author: subfield(fields, "200", "f") ?? ([subfield(fields, "700", "b"), subfield(fields, "700", "a")].filter(Boolean).join(" ") || null),
+      description: subfield(fields, "330", "a"),
+      isbn: bestIsbn(fields, lookup.identifiers.isbn13),
+      language: subfield(fields, "101", "a"),
+      publisher: subfield(fields, "210", "c") ?? subfield(fields, "214", "c"),
+      publishedDate: cleanDate(subfield(fields, "210", "d") ?? subfield(fields, "214", "d"))
     };
   }
 }
 
-function match(value: string, pattern: RegExp): string | undefined {
-  return value.match(pattern)?.[1];
+function asArray(value: unknown): Array<Record<string, unknown>> {
+  if (!value) return [];
+  return Array.isArray(value) ? (value as Array<Record<string, unknown>>) : [value as Record<string, unknown>];
+}
+
+function field(fields: Array<Record<string, unknown>>, tag: string): Record<string, unknown> | undefined {
+  return fields.find((item) => item["@_tag"] === tag);
+}
+
+function subfield(fields: Array<Record<string, unknown>>, tag: string, code: string): string | null {
+  const subfields = asArray(field(fields, tag)?.subfield);
+  const value = subfields.find((item) => item["@_code"] === code)?.["#text"];
+  return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+
+function bestIsbn(fields: Array<Record<string, unknown>>, expectedIsbn13: string | null): string | null {
+  const values = fields
+    .filter((item) => item["@_tag"] === "073" || item["@_tag"] === "010")
+    .flatMap((item) => asArray(item.subfield))
+    .filter((item) => item["@_code"] === "a")
+    .map((item) => String(item["#text"] ?? "").replace(/[^0-9X]/gi, ""))
+    .filter(Boolean);
+  return values.find((candidate) => toIsbn13(candidate) === expectedIsbn13) ?? values.find((candidate) => toIsbn13(candidate)) ?? null;
+}
+
+function cleanDate(value: string | null): string | null {
+  return value?.match(/\d{4}/)?.[0] ?? value;
 }

apps/api/src/metadata/adapters/google-books.provider.ts

@@ -1,17 +1,20 @@
 import { Injectable } from "@nestjs/common";
 import { MetadataLookup, MetadataMatch, MetadataProvider, MetadataProviderConfig } from "../metadata.types.js";
+import { toIsbn13 } from "../use-cases/extract-identifiers.js";
 
 @Injectable()
 export class GoogleBooksProvider implements MetadataProvider {
   readonly id = "googlebooks" as const;
 
   async lookup(lookup: MetadataLookup, config: MetadataProviderConfig): Promise<MetadataMatch | null> {
-    const query = lookup.identifiers.isbn13
-      ? `isbn:${lookup.identifiers.isbn13}`
+    const isbn = lookup.identifiers.isbn13 ?? lookup.identifiers.isbn10;
+    const query = isbn
+      ? `isbn:${isbn}`
       : `intitle:${lookup.title}${lookup.author ? `+inauthor:${lookup.author}` : ""}`;
     const url = new URL("https://www.googleapis.com/books/v1/volumes");
     url.searchParams.set("q", query);
     url.searchParams.set("maxResults", "1");
+    url.searchParams.set("printType", "books");
     if (config.apiKey) url.searchParams.set("key", config.apiKey);
 
     const response = await fetch(url, { signal: AbortSignal.timeout(4000) });
@@ -26,7 +29,7 @@ export class GoogleBooksProvider implements MetadataProvider {
       language: stringValue(info.language),
       publisher: stringValue(info.publisher),
       publishedDate: stringValue(info.publishedDate),
-      isbn: isbnFromIndustryIdentifiers(info.industryIdentifiers)
+      isbn: isbnFromIndustryIdentifiers(info.industryIdentifiers, lookup.identifiers.isbn13)
     };
   }
 }
@@ -39,9 +42,12 @@ function arrayJoin(value: unknown): string | null {
   return Array.isArray(value) && value.length ? value.map(String).join(", ") : null;
 }
 
-function isbnFromIndustryIdentifiers(value: unknown): string | null {
+function isbnFromIndustryIdentifiers(value: unknown, expectedIsbn13: string | null): string | null {
   if (!Array.isArray(value)) return null;
-  const isbn13 = value.find((entry) => entry?.type === "ISBN_13")?.identifier;
-  const isbn10 = value.find((entry) => entry?.type === "ISBN_10")?.identifier;
+  const entries = value as Array<{ type?: unknown; identifier?: unknown }>;
+  const matching = entries.find((entry) => toIsbn13(stringValue(entry.identifier) ?? "") === expectedIsbn13)?.identifier;
+  if (matching) return stringValue(matching);
+  const isbn13 = entries.find((entry) => entry.type === "ISBN_13")?.identifier;
+  const isbn10 = entries.find((entry) => entry.type === "ISBN_10")?.identifier;
   return stringValue(isbn13) ?? stringValue(isbn10);
 }

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

@@ -1,15 +1,21 @@
 import { Injectable } from "@nestjs/common";
 import { MetadataLookup, MetadataMatch, MetadataProvider, MetadataProviderConfig } from "../metadata.types.js";
+import { toIsbn13 } from "../use-cases/extract-identifiers.js";
 
 @Injectable()
 export class OpenLibraryProvider implements MetadataProvider {
   readonly id = "openlibrary" as const;
 
   async lookup(lookup: MetadataLookup, _config: MetadataProviderConfig): Promise<MetadataMatch | null> {
-    const query = lookup.identifiers.isbn13
-      ? `isbn:${encodeURIComponent(lookup.identifiers.isbn13)}`
-      : `title:${encodeURIComponent(lookup.title)}${lookup.author ? ` author:${encodeURIComponent(lookup.author)}` : ""}`;
-    const response = await fetch(`https://openlibrary.org/search.json?q=${query}&limit=1`, {
+    const isbn = lookup.identifiers.isbn13 ?? lookup.identifiers.isbn10;
+    if (isbn) {
+      return this.lookupIsbn(isbn, lookup.identifiers.isbn13);
+    }
+    const query = `title:${lookup.title}${lookup.author ? ` author:${lookup.author}` : ""}`;
+    const url = new URL("https://openlibrary.org/search.json");
+    url.searchParams.set("q", query);
+    url.searchParams.set("limit", "1");
+    const response = await fetch(url, {
       headers: { "User-Agent": "ReadaBook/0.1 local-library-manager" },
       signal: AbortSignal.timeout(4000)
     });
@@ -18,16 +24,77 @@ export class OpenLibraryProvider implements MetadataProvider {
     const doc = data.docs?.[0];
     if (!doc) return null;
     return {
-      author: firstArrayValue(doc.author_name),
+      title: stringValue(doc.title) ?? undefined,
+      author: arrayJoin(doc.author_name),
       language: firstArrayValue(doc.language),
       publisher: firstArrayValue(doc.publisher),
       publishedDate: String(doc.first_publish_year ?? "") || null,
-      isbn: firstArrayValue(doc.isbn)
+      isbn: bestIsbn(doc.isbn, lookup.identifiers.isbn13)
     };
   }
+
+  private async lookupIsbn(isbn: string, expectedIsbn13: string | null): Promise<MetadataMatch | null> {
+    const response = await fetch(`https://openlibrary.org/isbn/${encodeURIComponent(isbn)}.json`, {
+      headers: { "User-Agent": "ReadaBook/0.1 local-library-manager" },
+      signal: AbortSignal.timeout(4000)
+    });
+    if (!response.ok) return null;
+    const edition = (await response.json()) as Record<string, unknown>;
+    const author = await this.lookupAuthorName(edition.authors);
+    return {
+      title: stringValue(edition.title) ?? undefined,
+      author,
+      description: descriptionValue(edition.description),
+      isbn: bestIsbn([...(asStringArray(edition.isbn_13)), ...(asStringArray(edition.isbn_10))], expectedIsbn13),
+      language: languageValue(edition.languages),
+      publisher: firstArrayValue(edition.publishers),
+      publishedDate: stringValue(edition.publish_date)
+    };
+  }
+
+  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`, {
+      headers: { "User-Agent": "ReadaBook/0.1 local-library-manager" },
+      signal: AbortSignal.timeout(3000)
+    });
+    if (!response.ok) return null;
+    const author = (await response.json()) as Record<string, unknown>;
+    return stringValue(author.name);
+  }
+}
+
+function stringValue(value: unknown): string | null {
+  return typeof value === "string" && value.trim() ? value.trim() : null;
 }
 
 function firstArrayValue(value: unknown): string | null {
   if (!Array.isArray(value) || !value.length) return null;
   return String(value[0]);
 }
+
+function arrayJoin(value: unknown): string | null {
+  return Array.isArray(value) && value.length ? value.map(String).join(", ") : null;
+}
+
+function bestIsbn(value: unknown, expectedIsbn13: string | null): string | null {
+  if (!Array.isArray(value)) return null;
+  const values = value.map(String);
+  return values.find((candidate) => toIsbn13(candidate) === expectedIsbn13) ?? values.find((candidate) => toIsbn13(candidate)) ?? null;
+}
+
+function asStringArray(value: unknown): string[] {
+  return Array.isArray(value) ? value.map(String) : [];
+}
+
+function descriptionValue(value: unknown): string | null {
+  if (typeof value === "string") return value.trim() || null;
+  if (typeof value === "object" && value && "value" in value) return stringValue(value.value);
+  return null;
+}
+
+function languageValue(value: unknown): string | null {
+  const key = (Array.isArray(value) ? value[0] : undefined)?.key;
+  return typeof key === "string" ? key.split("/").pop() ?? null : null;
+}