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

src/app.js

@@ -31,6 +31,7 @@ const {
   putNarrative,
   deleteNarrative,
   getGroupOverview,
+  putGroupOverview,
 } = endpoints.sources;
 
 const {
@@ -306,7 +307,7 @@ app.routeAsync("/groups/:groupName/narratives/*")
 
 app.routeAsync("/groups/:groupName/overview")
   .getAsync(getGroupOverview)
-  // .putAsync(putGroupOverview)
+  .putAsync(putGroupOverview)
   // .deleteAsync(deleteGroupOverview)
 ;
 

src/endpoints/sources.js

@@ -285,6 +285,18 @@ const getGroupOverview = contentTypesProvided([
 ]);
 
 
+/* PUT
+ */
+const putGroupOverviewMarkdown = contentTypesProvided([
+  ["text/markdown", receiveGroupOverview(req => req.context.source)],
+]);
+
+
+const putGroupOverview = contentTypesProvided([
+  ["text/markdown", putGroupOverviewMarkdown],
+]);
+
+
 /**
  * Split a dataset or narrative `path` into an array of parts.
  *
@@ -391,6 +403,29 @@ async function sendAny(req, res, url, accept) {
 }
 
 
+/**
+ * Generate an Express endpoint that receives a group overview
+ * determined by the request.
+ *
+ * @param {sourceExtractor} sourceExtractor - Function to provide the Source instance from the request
+ * @returns {expressEndpointAsync}
+ */
+function receiveGroupOverview(sourceExtractor) {
+  return async (req, res) => {
+    const groupSource = sourceExtractor(req);
+
+    authz.assertAuthorized(req.user, authz.actions.Read, groupSource);
+
+    const urlCallback = async (method, headers) => await groupSource.urlFor("group-overview.md", method, headers);
+
+    return await receiveAny(req, res,
+      urlCallback,
+      "text/markdown" // TODO: put this in a class?
+    );
+  };
+}
+
+
 /**
  * Generate an Express endpoint that receives a dataset or narrative
  * Subresource determined by the request.
@@ -765,4 +800,5 @@ module.exports = {
   sendNarrativeSubresource,
 
   getGroupOverview,
+  putGroupOverview,
 };