fix(chrome-extension): resolve Hugging Face file URLs

extensions/geolibre-chrome/scanner.mjs

@@ -30,7 +30,31 @@ export function scanDocumentForDatasets() {
     }
   };
 
+  const huggingFaceHost = (url) => /^(?:huggingface\.co|hf\.co)$/i.test(url.hostname);
+
+  // The Hub links one file from seven routes -- blob, raw, blame, edit, delete,
+  // commits and the ?download=true button -- and every one of them ends in the
+  // file's own extension, so a repository page yields near-duplicate hits where
+  // only `resolve` (which 302s to the CDN) serves bytes a map source can read.
+  const huggingFaceFileUrl = (url) => {
+    if (!huggingFaceHost(url)) return null;
+    const parts = url.pathname.split("/").filter(Boolean);
+    const isRoute = (part) => /^(?:blob|raw|blame|edit|delete|commits|resolve)$/.test(part ?? "");
+    // /<owner>/<repo>/<route>/<revision>/<path> for models, one segment deeper
+    // for /datasets and /spaces (which still carry namespaceless legacy repos).
+    // Read the route from its fixed position rather than scanning, so an owner
+    // or repository named after a route cannot stand in for one.
+    const route = /^(?:datasets|spaces)$/.test(parts[0]) && isRoute(parts[3]) ? 3 : 2;
+    if (!isRoute(parts[route]) || parts.length < route + 3) return null;
+    parts[route] = "resolve";
+    const canonical = new URL(url.href);
+    canonical.pathname = `/${parts.join("/")}`;
+    canonical.searchParams.delete("download");
+    return canonical;
+  };
+
   const canonicalUrl = (url) => {
+    if (huggingFaceHost(url)) return huggingFaceFileUrl(url) ?? url;
     if (url.hostname !== "source.coop") return url;
     const parts = url.pathname.split("/").filter(Boolean);
     if (parts.length < 3) return url;
@@ -93,10 +117,18 @@ export function scanDocumentForDatasets() {
       return;
     }
 
+    // Every Hub route other than a file route is a UI page -- tree, viewer, the
+    // "Auto-converted to Parquet" branch -- so a hint-based match there would
+    // offer HTML as data.
+    const onHub = huggingFaceHost(url);
+    if (onHub && !huggingFaceFileUrl(url)) return;
+
     const kind = classify(url, hint);
     if (!kind) return;
     const existing = datasets.get(url.href);
-    const name = label.trim() || cleanName(url);
+    // Hub links carry UI chrome as their text ("Download", "History", "308 kB
+    // xet"), so the file name has to come from the path.
+    const name = (onHub ? "" : label.trim()) || cleanName(url);
     const candidate = {
       url: url.href,
       name,

tests/chrome-extension.test.ts

@@ -96,6 +96,83 @@ describe("GeoLibre Chrome extension scanner", () => {
     assert.equal(found.styleUrl, "https://data.source.coop/giswqs/opengeos/roads.style.json");
   });
 
+  it("collapses every Hugging Face file route onto the direct resolve URL", () => {
+    const repo = "https://huggingface.co/datasets/giswqs/PACE-Water-Quality";
+    const file = "main/cogs/PACE_OCI-20260103-chla.tif";
+    const found = scan(
+      `
+        <a href="${repo}/blob/${file}">PACE_OCI-20260103-chla.tif</a>
+        <a href="${repo}/raw/${file}">Raw pointer file</a>
+        <a href="${repo}/blame/${file}">Blame</a>
+        <a href="${repo}/edit/${file}">Contribute</a>
+        <a href="${repo}/delete/${file}">Delete</a>
+        <a href="${repo}/commits/${file}">History</a>
+        <a href="${repo}/resolve/${file}?download=true">Download</a>
+      `,
+      `${repo}/blob/${file}`,
+    );
+    assert.deepEqual(found, [
+      {
+        url: `${repo}/resolve/${file}`,
+        name: "PACE_OCI-20260103-chla.tif",
+        format: "GeoTIFF",
+        kind: "raster",
+        styleUrl: null,
+      },
+    ]);
+  });
+
+  it("canonicalizes Hugging Face model and Space files but leaves other Hub links alone", () => {
+    const found = scan(
+      `
+        <a href="https://hf.co/giswqs/model/blob/main/grid.geojson">grid</a>
+        <a href="https://huggingface.co/spaces/giswqs/demo/blob/main/roads.pmtiles">roads</a>
+        <a href="https://huggingface.co/datasets/giswqs/PACE-Water-Quality/tree/main/cogs">cogs</a>
+        <a href="https://huggingface.co/datasets/giswqs/PACE-Water-Quality/tree/refs%2Fconvert%2Fparquet/default">Auto-converted to Parquet</a>
+      `,
+      "https://huggingface.co/giswqs",
+    );
+    assert.deepEqual(
+      found.map((dataset) => dataset.url),
+      [
+        "https://hf.co/giswqs/model/resolve/main/grid.geojson",
+        "https://huggingface.co/spaces/giswqs/demo/resolve/main/roads.pmtiles",
+      ],
+    );
+  });
+
+  it("reads the Hugging Face route from its position, not the first matching segment", () => {
+    const found = scan(
+      `
+        <a href="https://huggingface.co/datasets/giswqs/blob/resolve/main/roads.geojson">repo named blob</a>
+        <a href="https://huggingface.co/raw/model/blob/main/dem.tif">owner named raw</a>
+        <a href="https://huggingface.co/datasets/glue/blob/main/grid.pmtiles">legacy repo</a>
+      `,
+      "https://huggingface.co/giswqs",
+    );
+    assert.deepEqual(
+      found.map((dataset) => dataset.url),
+      [
+        "https://huggingface.co/raw/model/resolve/main/dem.tif",
+        "https://huggingface.co/datasets/glue/resolve/main/grid.pmtiles",
+        "https://huggingface.co/datasets/giswqs/blob/resolve/main/roads.geojson",
+      ],
+    );
+  });
+
+  it("pairs a Hugging Face style file with its dataset across routes", () => {
+    const repo = "https://huggingface.co/datasets/giswqs/opengeos";
+    const [found] = scan(
+      `
+        <a href="${repo}/resolve/main/roads.geojson?download=true">Download</a>
+        <a href="${repo}/blob/main/roads.style.json">roads.style.json</a>
+      `,
+      `${repo}/tree/main`,
+    );
+    assert.equal(found.url, `${repo}/resolve/main/roads.geojson`);
+    assert.equal(found.styleUrl, `${repo}/resolve/main/roads.style.json`);
+  });
+
   it("preserves a discovered style when stronger metadata replaces a dataset", () => {
     const target = new URL("https://web.geolibre.app/");
     target.searchParams.append("data", "https://data.example.com/roads.json");