Catalog and Collection Link titles (#1037)

* Add link titles

* add test for link titles

* update changelog

* update test assertion

* update titles based on PR feedback

Author: naterubin

CHANGELOG.md

@@ -22,6 +22,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
   - Bbox queries outside of [-180, -90, 180, 90] return a 400 error
   - STAC Items passed to the ingest lambda require the collection field to be set
   - The behavior when a `fields` parameter is passed now matches [the spec](https://github.com/stac-api-extensions/fields) ([469](https://github.com/stac-utils/stac-server/pull/1032))
+  - Link titles were added to dynamically generated Catalog and Collection links ([468](https://github.com/stac-utils/stac-server/pull/1037))
 
 ## [4.5.0]
 

src/lib/api.js

@@ -487,42 +487,49 @@ export const addCollectionLinks = function (results, endpoint) {
     links.splice(0, 0, {
       rel: 'self',
       type: 'application/json',
-      href: `${endpoint}/collections/${id}`
+      href: `${endpoint}/collections/${id}`,
+      title: id
     })
     // parent catalog
     links.push({
       rel: 'parent',
       type: 'application/json',
-      href: `${endpoint}`
+      href: `${endpoint}`,
+      title: 'Catalog'
     })
     // root catalog
     links.push({
       rel: 'root',
       type: 'application/json',
-      href: `${endpoint}`
+      href: `${endpoint}`,
+      title: 'Catalog'
     })
     // child items
     links.push({
       rel: 'items',
       type: 'application/geo+json',
-      href: `${endpoint}/collections/${id}/items`
+      href: `${endpoint}/collections/${id}/items`,
+      title: 'Items'
     })
     // queryables
     links.push({
       rel: 'http://www.opengis.net/def/rel/ogc/1.0/queryables',
       type: 'application/schema+json',
-      href: `${endpoint}/collections/${id}/queryables`
+      href: `${endpoint}/collections/${id}/queryables`,
+      title: 'Queryables'
     })
     links.push({
       rel: 'aggregate',
       type: 'application/json',
       href: `${endpoint}/collections/${id}/aggregate`,
-      method: 'GET'
+      method: 'GET',
+      title: 'STAC aggregation [GET]'
     })
     links.push({
       rel: 'aggregations',
       type: 'application/json',
-      href: `${endpoint}/collections/${id}/aggregations`
+      href: `${endpoint}/collections/${id}/aggregations`,
+      title: 'Aggregations'
     })
   })
   return results
@@ -1203,60 +1210,71 @@ const getCatalog = async function (txnEnabled, endpoint = '') {
     {
       rel: 'self',
       type: 'application/json',
-      href: `${endpoint}`
+      href: `${endpoint}`,
+      title: 'Root Catalog'
     },
     {
       rel: 'root',
       type: 'application/json',
-      href: `${endpoint}`
+      href: `${endpoint}`,
+      title: 'Root Catalog'
     },
     {
       rel: 'conformance',
       type: 'application/json',
-      href: `${endpoint}/conformance`
+      href: `${endpoint}/conformance`,
+      title: 'STAC/OGC confromance classes'
     },
     {
       rel: 'data',
       type: 'application/json',
-      href: `${endpoint}/collections`
+      href: `${endpoint}/collections`,
+      title: 'Collections'
     },
     {
       rel: 'search',
       type: 'application/geo+json',
       href: `${endpoint}/search`,
       method: 'GET',
+      title: 'STAC search [GET]'
     },
     {
       rel: 'search',
       type: 'application/geo+json',
       href: `${endpoint}/search`,
       method: 'POST',
+      title: 'STAC search [POST]'
     },
     {
       rel: 'aggregate',
       type: 'application/json',
       href: `${endpoint}/aggregate`,
       method: 'GET',
+      title: 'STAC aggregate [GET]'
     },
     {
       rel: 'aggregations',
       type: 'application/json',
-      href: `${endpoint}/aggregations`
+      href: `${endpoint}/aggregations`,
+      title: 'Aggregations'
     },
     {
       rel: 'service-desc',
       type: 'application/vnd.oai.openapi',
-      href: `${endpoint}/api`
+      href: `${endpoint}/api`,
+      title: 'OpenAPI service description'
     },
     {
       rel: 'service-doc',
       type: 'text/html',
-      href: `${endpoint}/api.html`
+      href: `${endpoint}/api.html`,
+      title: 'OpenAPI service documentation'
     },
     {
       rel: 'http://www.opengis.net/def/rel/ogc/1.0/queryables',
       type: 'application/schema+json',
-      href: `${endpoint}/queryables`
+      href: `${endpoint}/queryables`,
+      title: 'Queryables'
     },
   ]
 
@@ -1265,6 +1283,7 @@ const getCatalog = async function (txnEnabled, endpoint = '') {
       rel: 'server',
       type: 'text/html',
       href: process.env['STAC_DOCS_URL'],
+      title: 'API documentation'
     })
   }
 
@@ -1311,11 +1330,13 @@ const getCollections = async function (backend, endpoint, parameters, headers) {
         rel: 'self',
         type: 'application/json',
         href: `${endpoint}/collections`,
+        title: 'Collections'
       },
       {
         rel: 'root',
         type: 'application/json',
         href: `${endpoint}`,
+        title: 'Root Catalog'
       },
     ],
   }

tests/system/test-api-get-collection.js

@@ -53,6 +53,11 @@ test('GET /collections/:collectionId returns a collection', async (t) => {
   t.true(aggregateLink?.href.endsWith(`/collections/${collectionId}/aggregate`))
   const aggregationsLink = response.body.links.find((l) => l.rel === 'aggregations')
   t.true(aggregationsLink?.href.endsWith(`/collections/${collectionId}/aggregations`))
+
+  // Check that proper link titles are generated
+  response.body.links.forEach((link) => {
+    t.truthy(link.hasOwnProperty('title') && link.title)
+  })
 })
 
 test('GET /collection/:collectionId for non-existent collection returns Not Found', async (t) => {