chore: API Consistency (#1304)

* chore: Addressing API inconsistencies

* lint

* add: Missing sort to groups.list
fix: Documention issues

* test: fix

* feat: Add missing shares.info endpoint

* feat: Add sorting to users.list endpoint

* fix: Incorrect pagination parameters listed on user endpoints

* users.s3Upload -> attachments.create

* chore: exportAll -> export_all

server/api/revisions.test.js

@@ -0,0 +1,92 @@
+/* eslint-disable flowtype/require-valid-file-annotation */
+import TestServer from 'fetch-test-server';
+import app from '../app';
+import { flushdb, seed } from '../test/support';
+import { buildDocument, buildUser } from '../test/factories';
+import Revision from '../models/Revision';
+
+const server = new TestServer(app.callback());
+
+beforeEach(flushdb);
+afterAll(server.close);
+
+describe('#revisions.info', async () => {
+  it('should return a document revision', async () => {
+    const { user, document } = await seed();
+    const revision = await Revision.findOne({
+      where: {
+        documentId: document.id,
+      },
+    });
+    const res = await server.post('/api/revisions.info', {
+      body: {
+        token: user.getJwtToken(),
+        id: revision.id,
+      },
+    });
+    const body = await res.json();
+
+    expect(res.status).toEqual(200);
+    expect(body.data.id).not.toEqual(document.id);
+    expect(body.data.title).toEqual(document.title);
+  });
+
+  it('should require authorization', async () => {
+    const document = await buildDocument();
+    const revision = await Revision.findOne({
+      where: {
+        documentId: document.id,
+      },
+    });
+    const user = await buildUser();
+    const res = await server.post('/api/revisions.info', {
+      body: {
+        token: user.getJwtToken(),
+        id: revision.id,
+      },
+    });
+    expect(res.status).toEqual(403);
+  });
+});
+
+describe('#revisions.list', async () => {
+  it("should return a document's revisions", async () => {
+    const { user, document } = await seed();
+    const res = await server.post('/api/revisions.list', {
+      body: {
+        token: user.getJwtToken(),
+        documentId: document.id,
+      },
+    });
+    const body = await res.json();
+
+    expect(res.status).toEqual(200);
+    expect(body.data.length).toEqual(1);
+    expect(body.data[0].id).not.toEqual(document.id);
+    expect(body.data[0].title).toEqual(document.title);
+  });
+
+  it('should not return revisions for document in collection not a member of', async () => {
+    const { user, document, collection } = await seed();
+    collection.private = true;
+    await collection.save();
+
+    const res = await server.post('/api/revisions.list', {
+      body: { token: user.getJwtToken(), documentId: document.id },
+    });
+
+    expect(res.status).toEqual(403);
+  });
+
+  it('should require authorization', async () => {
+    const document = await buildDocument();
+    const user = await buildUser();
+    const res = await server.post('/api/revisions.list', {
+      body: {
+        token: user.getJwtToken(),
+        documentId: document.id,
+      },
+    });
+    expect(res.status).toEqual(403);
+  });
+});