mcp-databnf 2.0.0 → 2.1.0

package/dist/bnf/client.d.ts

@@ -254,6 +254,16 @@ interface EntityId {
     /** The page a person can open. */
     pageUrl: string;
 }
+/**
+ * Read an identifier a caller wrote, in any of the forms they see.
+ *
+ * Rows carry `http://data.bnf.fr/ark:/12148/cb119219976#about`, prose carries
+ * `cb119219976`, and a browser carries `https://data.bnf.fr/ark:/12148/cb119219976`.
+ * All three name one record. Anything else is refused rather than guessed at,
+ * because an identifier built from a guess sends the next call to a record that
+ * does not exist and the answer reads as an absence.
+ */
+declare function parseEntityId(input: string): EntityId;
 
 /**
  * The one place that talks to data.bnf.fr.
@@ -346,4 +356,4 @@ declare class BnfClient {
     types(id: EntityId): Promise<Read<string[]>>;
 }
 
-export { BnfClient, type ClientOptions, type Read };
+export { BnfClient, type ClientOptions, type EntityId, type EntityKind, type Read, parseEntityId };

package/dist/bnf/client.js

@@ -2,7 +2,7 @@
 import process from "process";
 
 // src/version.ts
-var PKG_VERSION = "2.0.0";
+var PKG_VERSION = "2.1.0";
 var REPO_URL = "https://github.com/smeet666/mcp-databnf";
 
 // src/config.ts
@@ -438,6 +438,11 @@ function parseResults(body) {
 // src/bnf/sparql.ts
 var LEADING_JOINERS = /^['-]+/u;
 var TRAILING_JOINERS = /['-]+$/u;
+var ARK_IN_INPUT = /(?:^|\/)ark:\/12148\/(c[bc][0-9a-z]+)/i;
+var LEADING_HASH = /^#/;
+var FRAGMENT_OR_QUERY = /[#?]/;
+var TEMP_WORK_IN_INPUT = /temp-work\/([0-9a-f]{32})/i;
+var GALLICA_ARK = /ark:\/12148\/([0-9a-z]+)/i;
 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, "");
 }
@@ -471,6 +476,51 @@ 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_IN_INPUT.exec(trimmed);
+  const bare = arkMatch ? arkMatch[1] : trimmed.replace(LEADING_HASH, "").split(FRAGMENT_OR_QUERY)[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_IN_INPUT.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 = GALLICA_ARK.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))) {
@@ -1471,6 +1521,7 @@ var BnfClient = class {
   }
 };
 export {
-  BnfClient
+  BnfClient,
+  parseEntityId
 };
 //# sourceMappingURL=client.js.map