[wip] Implement GET /groups/:groupName/overview GET

src/app.js

@@ -30,6 +30,7 @@ const {
   getNarrative,
   putNarrative,
   deleteNarrative,
+  getGroupOverview,
 } = endpoints.sources;
 
 const {
@@ -303,6 +304,12 @@ app.routeAsync("/groups/:groupName/narratives/*")
   .deleteAsync(deleteNarrative)
 ;
 
+app.routeAsync("/groups/:groupName/overview")
+  .getAsync(getGroupOverview)
+  // .putAsync(putGroupOverview)
+  // .deleteAsync(deleteGroupOverview)
+;
+
 app.routeAsync("/groups/:groupName/*")
   .all(setDataset(req => req.params[0]))
   .getAsync(getDataset)

src/endpoints/sources.js

@@ -254,6 +254,16 @@ const getNarrative = contentTypesProvided([
 ]);
 
 
+const getGroupOverviewMarkdown = contentTypesProvided([
+  ["text/markdown", sendGroupOverview(req => req.context.source)],
+]);
+
+
+const getGroupOverview = contentTypesProvided([
+  ["text/markdown", getGroupOverviewMarkdown],
+]);
+
+
 /* PUT
  */
 const receiveNarrativeSubresource = type =>
@@ -292,6 +302,27 @@ function pathParts(path = "") {
 }
 
 
+/**
+ * Generate an Express endpoint that sends a group overview
+ * determined by the request.
+ *
+ * @param {sourceExtractor} sourceExtractor - Function to provide the Source instance from the request
+ * @returns {expressEndpointAsync}
+ */
+function sendGroupOverview(sourceExtractor) {
+  return async (req, res) => {
+    const groupSource = sourceExtractor(req);
+
+    authz.assertAuthorized(req.user, authz.actions.Read, groupSource);
+
+    return await sendAny(req, res,
+      await groupSource.urlFor("group-overview.md"),
+      "text/markdown" // TODO: put this in a class?
+    );
+  };
+}
+
+
 /**
  * Generate an Express endpoint that sends a dataset or narrative Subresource
  * determined by the request.
@@ -712,4 +743,6 @@ module.exports = {
 
   sendDatasetSubresource,
   sendNarrativeSubresource,
+
+  getGroupOverview,
 };