mcp-databnf 1.1.0 → 2.0.0

package/dist/bnf/client.js

@@ -1,5 +1,8 @@
+// src/config.ts
+import process from "process";
+
 // src/version.ts
-var PKG_VERSION = "1.1.0";
+var PKG_VERSION = "2.0.0";
 var REPO_URL = "https://github.com/smeet666/mcp-databnf";
 
 // src/config.ts
@@ -12,7 +15,9 @@ var DEFAULT_USER_AGENT = `mcp-databnf/${PKG_VERSION} (+${REPO_URL})`;
 function createLogger(level) {
   const rank = LOG_LEVELS.indexOf(level);
   const write = (at, message) => {
-    if (rank === 0 || LOG_LEVELS.indexOf(at) > rank) return;
+    if (rank === 0 || LOG_LEVELS.indexOf(at) > rank) {
+      return;
+    }
     process.stderr.write(`[mcp-databnf] ${at}: ${message}
 `);
   };
@@ -27,9 +32,11 @@ function createLogger(level) {
 }
 function readInteger(env, name, fallback, min, max) {
   const raw = env[name];
-  if (raw === void 0 || raw.trim() === "") return fallback;
+  if (raw === void 0 || raw.trim() === "") {
+    return fallback;
+  }
   const value = Number(raw);
-  if (!Number.isFinite(value) || !Number.isInteger(value)) {
+  if (!(Number.isFinite(value) && Number.isInteger(value))) {
     process.stderr.write(
       `[mcp-databnf] error: ${name}="${raw}" is not a whole number; using ${fallback}.
 `
@@ -80,7 +87,7 @@ var BnfError = class extends Error {
   code;
   details;
   constructor(code, message, details = {}) {
-    super(message);
+    super(message, details.cause === void 0 ? void 0 : { cause: details.cause });
     this.name = "BnfError";
     this.code = code;
     this.details = details;
@@ -110,7 +117,9 @@ var Cache = class {
   entries = /* @__PURE__ */ new Map();
   get(key) {
     const entry = this.entries.get(key);
-    if (!entry) return void 0;
+    if (!entry) {
+      return void 0;
+    }
     if (entry.expiresAt <= Date.now()) {
       this.entries.delete(key);
       return void 0;
@@ -120,12 +129,16 @@ var Cache = class {
     return { value: entry.value, retrievedAt: entry.retrievedAt };
   }
   set(key, value, retrievedAt) {
-    if (this.ttlMs <= 0) return;
+    if (this.ttlMs <= 0) {
+      return;
+    }
     this.entries.delete(key);
     this.entries.set(key, { value, expiresAt: Date.now() + this.ttlMs, retrievedAt });
     while (this.entries.size > this.maxEntries) {
       const oldest = this.entries.keys().next();
-      if (oldest.done) break;
+      if (oldest.done) {
+        break;
+      }
       this.entries.delete(oldest.value);
     }
   }
@@ -135,6 +148,9 @@ var Cache = class {
 };
 
 // src/bnf/endpoint.ts
+var TRAILING_DOT = /\.$/;
+var FRAGMENT = /#.*$/;
+var HTTP_SCHEME = /^http:/;
 var SPARQL_ENDPOINT = "https://data.bnf.fr/sparql";
 var ALLOWED_HOST = "data.bnf.fr";
 var GALLICA_HOST = "gallica.bnf.fr";
@@ -142,22 +158,23 @@ function assertRequestable(url) {
   let parsed;
   try {
     parsed = new URL(url);
-  } catch {
-    throw refusal(`mcp-databnf refuses to request "${url}": it is not an address.`);
+  } catch (cause) {
+    throw refusal(`mcp-databnf refuses to request "${url}": it is not an address.`, cause);
   }
-  const host = parsed.hostname.toLowerCase().replace(/\.$/, "");
+  const host = parsed.hostname.toLowerCase().replace(TRAILING_DOT, "");
   if (host !== ALLOWED_HOST) {
     throw refusal(
       `mcp-databnf requests ${ALLOWED_HOST} and nothing else; "${host}" was refused. Gallica in particular is described from the catalogue and never read.`
     );
   }
 }
-var refusal = (message) => new BnfError("network_error", message, {
-  hint: "This server reads the BnF catalogue at data.bnf.fr. It holds no licence to read the digitised contents, so it does not follow an address that leaves that host."
+var refusal = (message, cause) => new BnfError("network_error", message, {
+  hint: "This server reads the BnF catalogue at data.bnf.fr. It holds no licence to read the digitised contents, so it does not follow an address that leaves that host.",
+  cause
 });
 function isGallicaAddress(address) {
   try {
-    const host = new URL(address).hostname.toLowerCase().replace(/\.$/, "");
+    const host = new URL(address).hostname.toLowerCase().replace(TRAILING_DOT, "");
     return host === GALLICA_HOST || host.endsWith(`.${GALLICA_HOST}`);
   } catch {
     return false;
@@ -184,21 +201,28 @@ var PREFIXES = {
   rdafrbr: "http://rdvocab.info/uri/schema/FRBRentitiesRDA/"
 };
 var PREFIX_BLOCK = Object.entries(PREFIXES).map(([name, iri]) => `PREFIX ${name}: <${iri}>`).join("\n");
-var publicPageFor = (entityIri) => entityIri.replace(/#.*$/, "").replace(/^http:/, "https:");
+var publicPageFor = (entityIri) => entityIri.replace(FRAGMENT, "").replace(HTTP_SCHEME, "https:");
 
 // src/bnf/http.ts
+var VIRTUOSO_ERROR = /^Virtuoso\s+(\w+)\s+Error\s+([\s\S]*)$/;
 var RETRYABLE = /* @__PURE__ */ new Set([408, 425, 429, 500, 502, 503, 504]);
 var PUSH_BACK = /* @__PURE__ */ new Set([429, 503]);
 var LONGEST_WAIT_MS = 3e4;
 var RETRIES_AFTER_SILENCE = 1;
 var MAX_REDIRECTS = 2;
 function parseRetryAfter(value, now = Date.now()) {
-  if (!value) return null;
+  if (!value) {
+    return null;
+  }
   const trimmed = value.trim();
   const seconds = Number(trimmed);
-  if (Number.isFinite(seconds) && seconds >= 0) return Math.round(seconds * 1e3);
+  if (Number.isFinite(seconds) && seconds >= 0) {
+    return Math.round(seconds * 1e3);
+  }
   const at = Date.parse(trimmed);
-  if (Number.isNaN(at)) return null;
+  if (Number.isNaN(at)) {
+    return null;
+  }
   return Math.max(0, at - now);
 }
 function backoffMs(attempt) {
@@ -206,8 +230,10 @@ function backoffMs(attempt) {
   return base + Math.floor(Math.random() * 500);
 }
 function readEngineError(body) {
-  const match = /^Virtuoso\s+(\w+)\s+Error\s+([\s\S]*)$/.exec(body.trim());
-  if (!match) return null;
+  const match = VIRTUOSO_ERROR.exec(body.trim());
+  if (!match) {
+    return null;
+  }
   const state = match[1] ?? "";
   const text2 = (match[2] ?? "").split("\n")[0]?.trim() ?? "";
   return { kind: state === "37000" ? "compile" : "runtime", text: text2 };
@@ -249,6 +275,78 @@ async function postOnce(options, signal) {
     url: SPARQL_ENDPOINT
   });
 }
+function readRefusal(response, attempt, maxRetries) {
+  const pushBack = RETRYABLE.has(response.status);
+  if (PUSH_BACK.has(response.status)) {
+    const asked = parseRetryAfter(response.headers.get("retry-after"));
+    if (asked !== null && asked > LONGEST_WAIT_MS) {
+      return {
+        kind: "refused",
+        pushBack,
+        error: rateLimited(
+          `data.bnf.fr asked this client to wait ${Math.round(asked / 1e3)} seconds (HTTP ${response.status}).`,
+          { url: SPARQL_ENDPOINT, status: response.status }
+        )
+      };
+    }
+    if (attempt >= maxRetries) {
+      return {
+        kind: "refused",
+        pushBack,
+        error: rateLimited(
+          `data.bnf.fr asked this client to slow down (HTTP ${response.status}).`,
+          {
+            url: SPARQL_ENDPOINT,
+            status: response.status
+          }
+        )
+      };
+    }
+    return { kind: "again", pushBack, waitMs: asked ?? backoffMs(attempt) };
+  }
+  if (RETRYABLE.has(response.status) && attempt < maxRetries) {
+    return { kind: "again", pushBack, waitMs: backoffMs(attempt) };
+  }
+  if (response.status === 400 || response.status === 422) {
+    const engine = readEngineError(response.body);
+    return {
+      kind: "refused",
+      pushBack,
+      error: invalidInput(
+        `data.bnf.fr would not run this query${engine?.text ? `: ${engine.text}` : "."}`,
+        "Try fewer or plainer words. If this keeps happening with ordinary input, please report it."
+      )
+    };
+  }
+  return {
+    kind: "refused",
+    pushBack,
+    error: networkError(`data.bnf.fr answered HTTP ${response.status}.`, {
+      url: SPARQL_ENDPOINT,
+      status: response.status
+    })
+  };
+}
+function readFailure(error, attempts) {
+  const { attempt, maxRetries, timeoutMs } = attempts;
+  if (error instanceof Error && error.name === "BnfError") {
+    throw error;
+  }
+  if (error instanceof Error && error.name === "AbortError") {
+    if (attempt >= Math.min(maxRetries, RETRIES_AFTER_SILENCE)) {
+      throw timeout(
+        `No answer from data.bnf.fr within ${timeoutMs}ms. A query spanning the whole catalogue can take longer than the service will spend on it.`,
+        { url: SPARQL_ENDPOINT }
+      );
+    }
+    return error;
+  }
+  const failure = error instanceof Error ? error : new Error(String(error));
+  if (attempt >= maxRetries) {
+    throw networkError(`Could not reach data.bnf.fr: ${failure.message}`, { url: SPARQL_ENDPOINT });
+  }
+  return failure;
+}
 async function runQuery(options) {
   const { timeoutMs, maxRetries, limiter, logger } = options;
   let lastError = null;
@@ -256,7 +354,8 @@ async function runQuery(options) {
   for (let attempt = 0; attempt <= maxRetries; attempt += 1) {
     if (askedWaitMs > 0) {
       logger.debug(`waiting ${askedWaitMs}ms, as asked`);
-      await new Promise((resolve) => setTimeout(resolve, askedWaitMs));
+      const asked = askedWaitMs;
+      await new Promise((resolve) => setTimeout(resolve, asked));
       askedWaitMs = 0;
     }
     await limiter.beforeRequest();
@@ -276,66 +375,19 @@ async function runQuery(options) {
         limiter.succeeded();
         return parsed;
       }
-      if (RETRYABLE.has(response.status)) limiter.pushBack();
-      if (PUSH_BACK.has(response.status)) {
-        const asked = parseRetryAfter(response.headers.get("retry-after"));
-        if (asked !== null && asked > LONGEST_WAIT_MS) {
-          throw rateLimited(
-            `data.bnf.fr asked this client to wait ${Math.round(asked / 1e3)} seconds (HTTP ${response.status}).`,
-            { url: SPARQL_ENDPOINT, status: response.status }
-          );
-        }
-        if (attempt >= maxRetries) {
-          throw rateLimited(
-            `data.bnf.fr asked this client to slow down (HTTP ${response.status}).`,
-            {
-              url: SPARQL_ENDPOINT,
-              status: response.status
-            }
-          );
-        }
-        askedWaitMs = asked ?? backoffMs(attempt);
-        lastError = new Error(`HTTP ${response.status}`);
-        continue;
-      }
-      if (RETRYABLE.has(response.status) && attempt < maxRetries) {
-        lastError = new Error(`HTTP ${response.status}`);
-        askedWaitMs = backoffMs(attempt);
-        continue;
+      const verdict = readRefusal(response, attempt, maxRetries);
+      if (verdict.pushBack) {
+        limiter.pushBack();
       }
-      if (response.status === 400 || response.status === 422) {
-        const engine = readEngineError(response.body);
-        throw invalidInput(
-          `data.bnf.fr would not run this query${engine?.text ? `: ${engine.text}` : "."}`,
-          "Try fewer or plainer words. If this keeps happening with ordinary input, please report it."
-        );
+      if (verdict.kind === "refused") {
+        throw verdict.error;
       }
-      throw networkError(`data.bnf.fr answered HTTP ${response.status}.`, {
-        url: SPARQL_ENDPOINT,
-        status: response.status
-      });
+      askedWaitMs = verdict.waitMs;
+      lastError = new Error(`HTTP ${response.status}`);
     } catch (error) {
       clearTimeout(deadline);
-      if (error instanceof Error && error.name === "BnfError") throw error;
-      if (error instanceof Error && error.name === "AbortError") {
-        lastError = error;
-        if (attempt >= Math.min(maxRetries, RETRIES_AFTER_SILENCE)) {
-          throw timeout(
-            `No answer from data.bnf.fr within ${timeoutMs}ms. A query spanning the whole catalogue can take longer than the service will spend on it.`,
-            { url: SPARQL_ENDPOINT }
-          );
-        }
-        askedWaitMs = backoffMs(attempt);
-        continue;
-      }
-      lastError = error instanceof Error ? error : new Error(String(error));
-      if (attempt >= maxRetries) {
-        throw networkError(`Could not reach data.bnf.fr: ${lastError.message}`, {
-          url: SPARQL_ENDPOINT
-        });
-      }
+      lastError = readFailure(error, { attempt, maxRetries, timeoutMs });
       askedWaitMs = backoffMs(attempt);
-      continue;
     } finally {
       clearTimeout(deadline);
     }
@@ -369,9 +421,10 @@ function parseResults(body) {
   let payload;
   try {
     payload = JSON.parse(body);
-  } catch {
+  } catch (cause) {
     throw parseFailure("data.bnf.fr answered with something that is not JSON.", {
-      url: SPARQL_ENDPOINT
+      url: SPARQL_ENDPOINT,
+      cause
     });
   }
   if (typeof payload !== "object" || payload === null || !("results" in payload) || typeof payload.results !== "object" || !Array.isArray(payload.results?.bindings)) {
@@ -383,6 +436,8 @@ function parseResults(body) {
 }
 
 // src/bnf/sparql.ts
+var LEADING_JOINERS = /^['-]+/u;
+var TRAILING_JOINERS = /['-]+$/u;
 function escapeLiteral(value) {
   return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t").replace(/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/gu, "");
 }
@@ -391,49 +446,20 @@ var INVISIBLE = /[\u0000-\u0008\u000e-\u001f\u007f-\u009f\u00ad\u061c\u180e\u200
 function withoutInvisibles(input) {
   return input.replace(INVISIBLE, "");
 }
-function invisibleCharacters(input) {
-  const found = [];
-  for (const character of input.match(INVISIBLE) ?? []) {
-    if (!found.includes(character)) found.push(character);
-  }
-  return found;
-}
-function charactersSetAside(input) {
-  const found = [];
-  for (const character of withoutInvisibles(input).normalize("NFC")) {
-    if (/[\p{L}\p{N}'\-\s]/u.test(character) || /[‘’ʼ]/u.test(character)) continue;
-    if (!found.includes(character)) found.push(character);
-  }
-  return found;
-}
-function readSearchText(input) {
-  const words = toSearchWords(input);
-  return {
-    words,
-    terms: toIndexTerms(words),
-    invisible: invisibleCharacters(input),
-    setAside: charactersSetAside(input)
-  };
-}
 function toSearchWords(input) {
   const cleaned = withoutInvisibles(input).normalize("NFC").replace(/[‘’ʼ]/gu, "'").replace(/[^\p{L}\p{N}'-]+/gu, " ");
   const words = [];
   for (const raw of cleaned.split(" ")) {
-    const word = raw.replace(/^['-]+/u, "").replace(/['-]+$/u, "");
-    if (word === "") continue;
+    const word = raw.replace(LEADING_JOINERS, "").replace(TRAILING_JOINERS, "");
+    if (word === "") {
+      continue;
+    }
     words.push(word.length > 60 ? word.slice(0, 60) : word);
-    if (words.length >= 12) break;
-  }
-  return words;
-}
-function toIndexTerms(words) {
-  const terms = [];
-  for (const word of words) {
-    for (const piece of word.split(/['-]+/u)) {
-      if (piece !== "" && !terms.includes(piece)) terms.push(piece);
+    if (words.length >= 12) {
+      break;
     }
   }
-  return terms;
+  return words;
 }
 function containsAllWords(words) {
   if (words.length === 0) {
@@ -445,54 +471,9 @@ function containsAllWords(words) {
   const clause = words.map((word) => `'${word.replace(/'/g, "''")}'`).join(" AND ");
   return literal(clause);
 }
-var ARK_ID = /^c[bc][0-9a-z]{6,20}$/;
-var TEMP_WORK_ID = /^[0-9a-f]{32}$/;
-function parseEntityId(input) {
-  const trimmed = input.trim();
-  if (trimmed === "") {
-    throw invalidInput("An identifier is required.");
-  }
-  const arkMatch = /(?:^|\/)ark:\/12148\/(c[bc][0-9a-z]+)/i.exec(trimmed);
-  const bare = arkMatch ? arkMatch[1] : trimmed.replace(/^#/, "").split(/[#?]/)[0];
-  const candidate = (bare ?? "").toLowerCase();
-  if (ARK_ID.test(candidate)) {
-    return {
-      kind: "ark",
-      id: candidate,
-      iri: `http://data.bnf.fr/ark:/12148/${candidate}#about`,
-      pageUrl: `https://data.bnf.fr/ark:/12148/${candidate}`
-    };
-  }
-  const tempMatch = /temp-work\/([0-9a-f]{32})/i.exec(trimmed);
-  const digest = (tempMatch?.[1] ?? candidate).toLowerCase();
-  if (TEMP_WORK_ID.test(digest)) {
-    return {
-      kind: "temp-work",
-      id: `temp-work/${digest}`,
-      iri: `http://data.bnf.fr/temp-work/${digest}/#about`,
-      pageUrl: `https://data.bnf.fr/temp-work/${digest}/`
-    };
-  }
-  throw invalidInput(`"${input}" is not a data.bnf.fr identifier.`, hintFor(trimmed));
-}
-var GALLICA_DOCUMENT = /^(?:bpt6k|btv1b|bd6t|cb32|btv1b)[0-9a-z]+$/i;
-var PAGE_ADDRESS = /data\.bnf\.fr\/(?:[a-z]{2}\/)?(\d{6,12})\/([a-z0-9_]+)/i;
-var GENERAL_HINT = "An identifier looks like 'cb119219976' for an established record, or 'temp-work/22d7f68c1a4bdd081ad7ca791fd3b730' for a provisional one. Take it from a search result rather than building one.";
-function hintFor(input) {
-  const page2 = PAGE_ADDRESS.exec(input);
-  if (page2) {
-    const name = (page2[2] ?? "").replace(/_/g, " ");
-    return `That is the readable address of a data.bnf.fr page, and ${page2[1]} in it is the record's FRBNF number rather than the identifier these tools take. Search for "${name}" with search_authors or search_works, and use the identifier the row carries.`;
-  }
-  const gallicaArk = /ark:\/12148\/([0-9a-z]+)/i.exec(input)?.[1] ?? input;
-  if (GALLICA_DOCUMENT.test(gallicaArk)) {
-    return "That is a Gallica identifier: it names a digitised document rather than a record in the catalogue, and these tools read the catalogue. Search for the work with search_works, then list_editions will give you the Gallica link alongside the edition it belongs to.";
-  }
-  return GENERAL_HINT;
-}
 var iriOf = (id) => `<${id.iri}>`;
 function boundedInteger(value, min, max, name) {
-  if (!Number.isFinite(value) || !Number.isInteger(value)) {
+  if (!(Number.isFinite(value) && Number.isInteger(value))) {
     throw invalidInput(`'${name}' has to be a whole number.`);
   }
   if (value < min || value > max) {
@@ -713,6 +694,14 @@ LIMIT 20`);
 }
 
 // src/bnf/parse.ts
+var ARK_IN_IRI = /ark:\/12148\/(c[bc][0-9a-z]+)/i;
+var TEMP_WORK_IN_IRI = /temp-work\/([0-9a-f]{32})/i;
+var TRAILING_SEPARATOR = /[/#]$/;
+var PATH_SEPARATOR = /[/#]/;
+var ARK_SEGMENT = /ark:\/12148\/([^/?#]+)/;
+var QUERY_START = /[?#]/;
+var LEADING_DOTS = /^[./]+/;
+var TRAILING_SLASHES = /\/+$/;
 var P = {
   type: "http://www.w3.org/1999/02/22-rdf-syntax-ns#type",
   label: "http://www.w3.org/2000/01/rdf-schema#label",
@@ -768,36 +757,50 @@ var ALIGNMENT_HOSTS = [
   { host: "catalogue.bnf.fr", name: "catalogue" }
 ];
 var text = (term) => {
-  if (!term) return null;
+  if (!term) {
+    return null;
+  }
   const value = term.value.trim();
   return value === "" ? null : value;
 };
 var integer = (term) => {
   const raw = text(term);
-  if (raw === null) return null;
+  if (raw === null) {
+    return null;
+  }
   const value = Number(raw);
   return Number.isInteger(value) ? value : null;
 };
 function idFromIri(iri) {
-  const ark = /ark:\/12148\/(c[bc][0-9a-z]+)/i.exec(iri);
-  if (ark?.[1]) return ark[1].toLowerCase();
-  const temp = /temp-work\/([0-9a-f]{32})/i.exec(iri);
-  if (temp?.[1]) return `temp-work/${temp[1].toLowerCase()}`;
+  const ark = ARK_IN_IRI.exec(iri);
+  if (ark?.[1]) {
+    return ark[1].toLowerCase();
+  }
+  const temp = TEMP_WORK_IN_IRI.exec(iri);
+  if (temp?.[1]) {
+    return `temp-work/${temp[1].toLowerCase()}`;
+  }
   return null;
 }
-var vocabularyTerm = (iri) => decodeURIComponent(iri.replace(/[/#]$/, "").split(/[/#]/).pop() ?? iri);
+var vocabularyTerm = (iri) => decodeURIComponent(iri.replace(TRAILING_SEPARATOR, "").split(PATH_SEPARATOR).pop() ?? iri);
 function toDigitisedLink(address, role, fromId, fromTitle) {
-  if (!address || !isGallicaAddress(address)) return null;
-  const segment = /ark:\/12148\/([^/?#]+)/.exec(address)?.[1] ?? null;
-  if (!segment) return null;
+  if (!(address && isGallicaAddress(address))) {
+    return null;
+  }
+  const segment = ARK_SEGMENT.exec(address)?.[1] ?? null;
+  if (!segment) {
+    return null;
+  }
   const ark = segment.split(".")[0] ?? segment;
-  if (ark === "") return null;
+  if (ark === "") {
+    return null;
+  }
   return { ark, url: address, rendering: renderingOf(address, ark), role, fromId, fromTitle };
 }
 function renderingOf(address, ark) {
-  const path = address.split(/[?#]/)[0] ?? address;
+  const path = address.split(QUERY_START)[0] ?? address;
   const after = path.slice(path.indexOf(`ark:/12148/${ark}`) + `ark:/12148/${ark}`.length);
-  const rendering = after.replace(/^[./]+/, "").replace(/\/+$/, "");
+  const rendering = after.replace(LEADING_DOTS, "").replace(TRAILING_SLASHES, "");
   return rendering === "" ? null : rendering;
 }
 function page(rows, limit, skipped) {
@@ -807,9 +810,13 @@ function page(rows, limit, skipped) {
 function readWindowOccupancy(results) {
   for (const row of results.results.bindings) {
     const raw = text(row.windowRows);
-    if (raw === null) continue;
+    if (raw === null) {
+      continue;
+    }
     const count = Number(raw);
-    if (Number.isInteger(count)) return count >= TEXT_WINDOW;
+    if (Number.isInteger(count)) {
+      return count >= TEXT_WINDOW;
+    }
   }
   return null;
 }
@@ -818,10 +825,15 @@ function byPredicate(results) {
   const index = /* @__PURE__ */ new Map();
   for (const row of results.results.bindings) {
     const predicate = text(row.p);
-    if (predicate === null) continue;
+    if (predicate === null) {
+      continue;
+    }
     const bucket = index.get(predicate);
-    if (bucket) bucket.push(row);
-    else index.set(predicate, [row]);
+    if (bucket) {
+      bucket.push(row);
+    } else {
+      index.set(predicate, [row]);
+    }
   }
   return index;
 }
@@ -830,7 +842,9 @@ var allValues = (index, predicate) => {
   const seen = /* @__PURE__ */ new Set();
   for (const row of index.get(predicate) ?? []) {
     const value = text(row.o);
-    if (value !== null) seen.add(value);
+    if (value !== null) {
+      seen.add(value);
+    }
   }
   return [...seen];
 };
@@ -841,8 +855,12 @@ function alignments(index, selfId) {
   const found = {};
   for (const predicate of [P.sameAs, P.exactMatch, P.closeMatch, P.seeAlso]) {
     for (const address of allValues(index, predicate)) {
-      if (!address.startsWith("http")) continue;
-      if (selfId && address.includes(selfId)) continue;
+      if (!address.startsWith("http")) {
+        continue;
+      }
+      if (selfId && address.includes(selfId)) {
+        continue;
+      }
       let host;
       try {
         host = new URL(address).hostname.toLowerCase();
@@ -852,8 +870,12 @@ function alignments(index, selfId) {
       const known = ALIGNMENT_HOSTS.find(
         (entry) => host === entry.host || host.endsWith(`.${entry.host}`)
       );
-      if (!known) continue;
-      (found[known.name] ??= /* @__PURE__ */ new Set()).add(address);
+      if (!known) {
+        continue;
+      }
+      const addresses = found[known.name] ?? /* @__PURE__ */ new Set();
+      found[known.name] = addresses;
+      addresses.add(address);
     }
   }
   return Object.fromEntries(Object.entries(found).map(([name, set]) => [name, [...set]]));
@@ -868,14 +890,18 @@ function toAuthorSummaries(results, limit) {
   const seen = /* @__PURE__ */ new Set();
   let skipped = 0;
   for (const row of results.results.bindings) {
-    if (isOccupancyRow(row, "person")) continue;
+    if (isOccupancyRow(row, "person")) {
+      continue;
+    }
     const iri = text(row.person);
     const id = iri === null ? null : idFromIri(iri);
     if (iri === null || id === null) {
       skipped += 1;
       continue;
     }
-    if (seen.has(id)) continue;
+    if (seen.has(id)) {
+      continue;
+    }
     seen.add(id);
     rows.push({
       id,
@@ -896,18 +922,24 @@ function toAuthorDetail(results, id, pageUrl) {
   const seenLabels = /* @__PURE__ */ new Set();
   for (const row of index.get(P.altLabel) ?? []) {
     const label = text(row.o);
-    if (label === null || seenLabels.has(label)) continue;
+    if (label === null || seenLabels.has(label)) {
+      continue;
+    }
     seenLabels.add(label);
     otherNames.push({ label, language: text(row.lang) });
   }
   const sameAs = alignments(index, id);
   const isni = isniAddresses(index);
-  if (isni.length > 0) sameAs.isni = [.../* @__PURE__ */ new Set([...sameAs.isni ?? [], ...isni])];
+  if (isni.length > 0) {
+    sameAs.isni = [.../* @__PURE__ */ new Set([...sameAs.isni ?? [], ...isni])];
+  }
   const catalogueUrl = allValues(index, P.seeAlso).find((address) => address.includes("catalogue.bnf.fr")) ?? null;
   const depictions = [];
   for (const address of allValues(index, P.depiction)) {
     const link = toDigitisedLink(address, "depiction", id, null);
-    if (link) depictions.push(link);
+    if (link) {
+      depictions.push(link);
+    }
   }
   return {
     id,
@@ -941,8 +973,12 @@ function toAuthorDetail(results, id, pageUrl) {
 function readStatus(statement, iri) {
   if (statement !== null) {
     const said = statement.toLowerCase();
-    if (said.includes("provisional")) return "provisional";
-    if (said.includes("established")) return "established";
+    if (said.includes("provisional")) {
+      return "provisional";
+    }
+    if (said.includes("established")) {
+      return "established";
+    }
   }
   return iri.includes("/temp-work/") ? "provisional" : "established";
 }
@@ -951,7 +987,9 @@ function toWorkSummaries(results, limit) {
   const byId = /* @__PURE__ */ new Map();
   let skipped = 0;
   for (const row of results.results.bindings) {
-    if (isOccupancyRow(row, "work")) continue;
+    if (isOccupancyRow(row, "work")) {
+      continue;
+    }
     const iri = text(row.work);
     const id = iri === null ? null : idFromIri(iri);
     if (iri === null || id === null) {
@@ -979,7 +1017,7 @@ function toWorkSummaries(results, limit) {
   }
   return {
     ...page(
-      order.map((id) => byId.get(id)),
+      order.map((id) => byId.get(id)).filter((one) => one !== void 0),
       limit,
       skipped
     ),
@@ -1012,13 +1050,15 @@ function toAuthoredWorks(results, limit) {
       order.push(id);
     }
     const form = text(row.form);
-    if (form !== null && form.startsWith("http")) {
+    if (form?.startsWith("http")) {
       const term = vocabularyTerm(form);
-      if (!work.forms.includes(term)) work.forms.push(term);
+      if (!work.forms.includes(term)) {
+        work.forms.push(term);
+      }
     }
   }
   return page(
-    order.map((id) => byId.get(id)),
+    order.map((id) => byId.get(id)).filter((one) => one !== void 0),
     limit,
     skipped
   );
@@ -1031,13 +1071,17 @@ function toWorkDetail(results, id, iri, pageUrl) {
   for (const row of index.get(P.creator) ?? []) {
     const creatorIri = text(row.o);
     const creatorId = creatorIri ? idFromIri(creatorIri) : null;
-    if (!creatorId || creators.some((c) => c.id === creatorId)) continue;
+    if (!creatorId || creators.some((c) => c.id === creatorId)) {
+      continue;
+    }
     creators.push({ id: creatorId, name: text(row.name) });
   }
   const depictions = [];
   for (const address of allValues(index, P.depiction)) {
     const link = toDigitisedLink(address, "depiction", id, null);
-    if (link) depictions.push(link);
+    if (link) {
+      depictions.push(link);
+    }
   }
   const statusStatement = firstValue(index, P.statusOfIdentification);
   const catalogueUrl = allValues(index, P.seeAlso).find((address) => address.includes("catalogue.bnf.fr")) ?? null;
@@ -1107,7 +1151,7 @@ function toEditions(results, limit) {
     }
   }
   return page(
-    order.map((id) => byId.get(id)),
+    order.map((id) => byId.get(id)).filter((one) => one !== void 0),
     limit,
     skipped
   );
@@ -1126,7 +1170,9 @@ function toDigitisedLinks(results, limit) {
       ["depiction", "depiction"]
     ]) {
       const link = toDigitisedLink(text(row[column]), role, fromId, title);
-      if (!link || seen.has(link.url)) continue;
+      if (!link || seen.has(link.url)) {
+        continue;
+      }
       seen.add(link.url);
       links.push(link);
     }
@@ -1137,7 +1183,9 @@ function toTypes(results) {
   const types = /* @__PURE__ */ new Set();
   for (const row of results.results.bindings) {
     const iri = text(row.type);
-    if (iri !== null) types.add(iri);
+    if (iri !== null) {
+      types.add(iri);
+    }
   }
   return [...types];
 }
@@ -1178,7 +1226,9 @@ var RateLimiter = class {
   async beforeRequest() {
     const elapsed = Date.now() - this.lastStartedAt;
     const wait = Math.min(this.intervalMs, this.intervalMs - elapsed);
-    if (wait > 0) await sleep(wait);
+    if (wait > 0) {
+      await sleep(wait);
+    }
     this.lastStartedAt = Date.now();
   }
   /** Called when the service asks for room: double the gap, up to the ceiling. */
@@ -1191,9 +1241,13 @@ var RateLimiter = class {
    * response after a rough patch does not undo the caution that earned it.
    */
   succeeded() {
-    if (this.intervalMs === this.baseIntervalMs) return;
+    if (this.intervalMs === this.baseIntervalMs) {
+      return;
+    }
     this.calmStreak += 1;
-    if (this.calmStreak < 3) return;
+    if (this.calmStreak < 3) {
+      return;
+    }
     this.calmStreak = 0;
     this.intervalMs = Math.max(this.baseIntervalMs, Math.round(this.intervalMs / 2));
   }
@@ -1212,7 +1266,9 @@ function withGuarantees(config) {
   const defaults = loadConfig({});
   const bounded = (value, fallback, min, max) => {
     const parsed = Number(value);
-    if (!Number.isFinite(parsed)) return fallback;
+    if (!Number.isFinite(parsed)) {
+      return fallback;
+    }
     return Math.min(max, Math.max(min, parsed));
   };
   const claimed = typeof config.userAgent === "string" ? config.userAgent.trim() : "";
@@ -1263,9 +1319,6 @@ var BnfClient = class {
     return this.config.timeoutMs;
   }
   /** The one address this client sends anything to. */
-  get endpoint() {
-    return SPARQL_ENDPOINT;
-  }
   /**
    * `cacheKey` is stated rather than taken from the query, because two reads of
    * one query can produce different values: a list cut to five rows is not the
@@ -1309,32 +1362,7 @@ var BnfClient = class {
     return { data, cached: false, retrievedAt: new Date(retrievedAt).toISOString() };
   }
   /** Read an identifier a caller wrote, refusing anything this dataset cannot address. */
-  identify(input) {
-    return parseEntityId(input);
-  }
   /** The words a search will actually look for, which a tool reports back. */
-  words(input) {
-    return toSearchWords(input);
-  }
-  /**
-   * The terms the index requires, which is what a row's presence rests on.
-   *
-   * The index splits inside a word at an apostrophe and at a hyphen, so a word
-   * a caller wrote as one can reach it as two, each required on its own.
-   */
-  indexTerms(words) {
-    return toIndexTerms(words);
-  }
-  /**
-   * How a piece of caller text became the terms the search was run with.
-   *
-   * A tool reports the reading back, so the same reading has to be the one the
-   * query was built from: the words, the terms the index makes of them, and
-   * the characters that reached neither.
-   */
-  searchReading(input) {
-    return readSearchText(input);
-  }
   searchAuthors(name, limit, offset) {
     const words = toSearchWords(name);
     const query = searchAuthorsQuery(words, limit, offset);