[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

@@ -281,6 +281,13 @@ const getGroupOverview = contentTypesProvided([
 ]);
 
 
+/* PUT
+ */
+const putGroupOverview = contentTypesConsumed([
+  ["text/markdown", receiveGroupOverview],
+]);
+
+
 /**
  * Split a dataset or narrative `path` into an array of parts.
  *
@@ -385,6 +392,25 @@ async function proxyFromUpstream(req, res, url, accept) {
 }
 
 
+/**
+ * An Express endpoint that receives a group overview determined by the request.
+ *
+ * @param {express.request} req - Express-style request instance
+ * @param {express.response} res - Express-style response instance
+ * @returns {expressEndpointAsync}
+ */
+async function receiveGroupOverview(req, res) {
+  const groupSource = req.context.source;
+
+  authz.assertAuthorized(req.user, authz.actions.Write, groupSource);
+
+  return await proxyToUpstream(req, res,
+    async (method, headers) => await groupSource.urlFor("group-overview.md", method, headers),
+    "text/markdown"
+  );
+}
+
+
 /**
  * Generate an Express endpoint that receives a dataset or narrative
  * Subresource determined by the request.
@@ -764,4 +790,5 @@ module.exports = {
   sendNarrativeSubresource,
 
   getGroupOverview,
+  putGroupOverview,
 };