fix: prefer hydra title when available

Author: soyuka

src/hydra/parseHydraDocumentation.ts

@@ -13,6 +13,7 @@ import type {
   ExpandedClass,
   ExpandedDoc,
   Entrypoint,
+  ExpandedOperation,
   ExpandedRdfProperty,
   RequestInitExtended,
 } from "./types.js";
@@ -24,6 +25,16 @@ function guessNameFromUrl(url: string, entrypointUrl: string): string {
   return url.substr(entrypointUrl.length + 1);
 }
 
+function getTitleOrLabel(obj: ExpandedOperation): string {
+  const a = obj["http://www.w3.org/2000/01/rdf-schema#label"] ?? obj["http://www.w3.org/ns/hydra/core#title"] ?? null;
+
+  if (a === null) {
+    throw new Error('No title nor label defined on this operation.');
+  }
+
+  return a[0]["@value"];
+}
+
 /**
  * Finds the description of the class with the given id.
  */
@@ -279,7 +290,9 @@ export default function parseHydraDocumentation(
           ) as unknown as string;
 
           const field = new Field(
-            supportedProperty["http://www.w3.org/2000/01/rdf-schema#label"][0][
+            supportedProperties["http://www.w3.org/ns/hydra/core#title"][0][
+              "@value"
+            ] ?? supportedProperty["http://www.w3.org/2000/01/rdf-schema#label"][0][
               "@value"
             ],
             {
@@ -369,9 +382,7 @@ export default function parseHydraDocumentation(
               type = "create";
             }
             const operation = new Operation(
-              entrypointOperation[
-                "http://www.w3.org/2000/01/rdf-schema#label"
-              ][0]["@value"],
+              getTitleOrLabel(entrypointOperation),
               type,
               {
                 method,
@@ -424,9 +435,7 @@ export default function parseHydraDocumentation(
             type = "delete";
           }
           const operation = new Operation(
-            supportedOperation["http://www.w3.org/2000/01/rdf-schema#label"][0][
-              "@value"
-            ],
+            getTitleOrLabel(supportedOperation),
             type,
             {
               method,