multi-app-mcp 1.0.0

package/plugins/quickreviewer/documents.js

@@ -0,0 +1,476 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// DOCUMENTS — Document management tools
+// ─────────────────────────────────────────────────────────────────────────────
+
+import { getAuthHeaders, requireLogin, session } from "./session.js";
+
+const QR_API_URL = process.env.QR_API_URL || "https://app.quickreviewer.com/api";
+
+// ─── Tool Definitions ─────────────────────────────────────────────────────────
+
+export const tools = [
+  {
+    name: "qr_get_documents",
+    description:
+      "Get list of documents in a folder. " +
+      "Use folderId=0 for root folder. " +
+      "User must be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        folderId: { type: "integer", description: "Folder ID (0 for root)" },
+      },
+      required: ["folderId"],
+    },
+  },
+  {
+    name: "qr_get_recent_documents",
+    description: "Get recently accessed documents. User must be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        folderId: { type: "integer", description: "Folder ID (use 0 for all)" },
+      },
+      required: ["folderId"],
+    },
+  },
+  {
+    name: "qr_get_document_detail",
+    description:
+      "Get full details of a specific document by documentId and versionId. " +
+      "User must be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        documentId: { type: "integer", description: "Document ID" },
+        versionId:  { type: "integer", description: "Version ID of the document" },
+      },
+      required: ["documentId", "versionId"],
+    },
+  },
+  {
+    name: "qr_get_document_versions",
+    description:
+      "Get all versions of a document. User must be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        documentId: { type: "integer", description: "Document ID" },
+      },
+      required: ["documentId"],
+    },
+  },
+  {
+    name: "qr_get_document_log",
+    description:
+      "Get activity log of a document — who viewed, commented, approved, etc. " +
+      "User must be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        versionId: { type: "integer", description: "Version ID of the document" },
+      },
+      required: ["versionId"],
+    },
+  },
+  {
+    name: "qr_rename_document",
+    description:
+      "Rename a document. Provide documentId, versionId, and the new title. " +
+      "User must be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        documentId:    { type: "integer", description: "Document ID" },
+        versionId:     { type: "integer", description: "Version ID of the document" },
+        documentTitle: { type: "string",  description: "New name/title for the document" },
+      },
+      required: ["documentId", "versionId", "documentTitle"],
+    },
+  },
+  {
+    name: "qr_trash_document",
+    description:
+      "Move a document to trash. Provide documentId and versionId as arrays. " +
+      "User must be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        documentId: {
+          type: "array",
+          items: { type: "integer" },
+          description: "Array of document IDs to trash",
+        },
+        versionId: {
+          type: "array",
+          items: { type: "integer" },
+          description: "Array of version IDs to trash",
+        },
+      },
+      required: ["documentId", "versionId"],
+    },
+  },
+  {
+    name: "qr_move_document",
+    description:
+      "Move documents to a different folder. " +
+      "Provide documentId and versionId as arrays, and the target folderId. " +
+      "User must be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        documentId: {
+          type: "array",
+          items: { type: "integer" },
+          description: "Array of document IDs to move",
+        },
+        versionId: {
+          type: "array",
+          items: { type: "integer" },
+          description: "Array of version IDs to move",
+        },
+        folderId: { type: "integer", description: "Target folder ID to move documents into" },
+      },
+      required: ["documentId", "versionId", "folderId"],
+    },
+  },
+  {
+    name: "qr_share_document",
+    description:
+      "Share a document with someone via email. " +
+      "shareAction can be: 'view', 'comment', or 'approve'. " +
+      "download: 1 to allow download, 0 to disallow. " +
+      "User must be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        documentId: {
+          type: "array",
+          items: { type: "integer" },
+          description: "Array of document IDs to share",
+        },
+        versionId: {
+          type: "array",
+          items: { type: "integer" },
+          description: "Array of version IDs to share",
+        },
+        shareEmail:  { type: "string",  description: "Email address to share with" },
+        shareAction: { type: "string",  description: "Permission: 'view', 'comment', or 'approve'" },
+        download:    { type: "integer", description: "Allow download: 1 = yes, 0 = no" },
+        anybody:     { type: "integer", description: "Share with anyone who has the link: 1 = yes, 0 = no" },
+        note:        { type: "string",  description: "Optional message to include with the share" },
+      },
+      required: ["documentId", "versionId", "shareEmail", "shareAction", "download"],
+    },
+  },
+  {
+    name: "qr_get_trashed_documents",
+    description:
+      "Get all trashed (deleted) documents of the logged-in user. " +
+      "Use folderId=0 to get all trashed documents across all folders. " +
+      "User must be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        folderId: { type: "integer", description: "Folder ID to filter trashed docs (0 = all)" },
+      },
+      required: ["folderId"],
+    },
+  },
+];
+
+// ─── Handlers ─────────────────────────────────────────────────────────────────
+
+export const handlers = {
+
+  qr_get_documents: async ({ folderId }) => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    const res  = await fetch(`${QR_API_URL}/documents`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ folderId, userId: session.userId }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      const docs = data.data || data.documents || data || [];
+      const count = Array.isArray(docs) ? docs.length : "unknown";
+      return {
+        content: [{
+          type: "text",
+          text:
+            `✅ Documents fetched (${count} found)\n\n` +
+            `Folder ID: ${folderId}\n\n` +
+            `${JSON.stringify(data, null, 2)}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_get_recent_documents: async ({ folderId }) => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    const res  = await fetch(`${QR_API_URL}/recent`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ folderId, userId: session.userId }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      return {
+        content: [{
+          type: "text",
+          text: `✅ Recent documents fetched\n\n${JSON.stringify(data, null, 2)}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_get_document_detail: async ({ documentId, versionId }) => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    const res  = await fetch(`${QR_API_URL}/document/document-detail`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ documentId, versionId }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      return {
+        content: [{
+          type: "text",
+          text: `✅ Document detail fetched\n\n${JSON.stringify(data, null, 2)}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_get_document_versions: async ({ documentId }) => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    const res  = await fetch(`${QR_API_URL}/document/document-versions`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ documentId }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      return {
+        content: [{
+          type: "text",
+          text: `✅ Document versions fetched\n\n${JSON.stringify(data, null, 2)}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_get_document_log: async ({ versionId }) => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    const res  = await fetch(`${QR_API_URL}/document/log`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ versionId }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      return {
+        content: [{
+          type: "text",
+          text: `✅ Activity log fetched\n\n${JSON.stringify(data, null, 2)}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_rename_document: async ({ documentId, versionId, documentTitle }) => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    const res  = await fetch(`${QR_API_URL}/document/rename`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ documentId, versionId, documentTitle }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      return {
+        content: [{
+          type: "text",
+          text: `✅ Document renamed successfully!\n\nNew title: ${documentTitle}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_trash_document: async ({ documentId, versionId }) => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    const res  = await fetch(`${QR_API_URL}/document/trash`, {
+      method:  "PATCH",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ documentId, versionId }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      return {
+        content: [{
+          type: "text",
+          text: `✅ Document(s) moved to trash!\n\nDocument IDs: ${documentId.join(", ")}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_move_document: async ({ documentId, versionId, folderId }) => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    const res  = await fetch(`${QR_API_URL}/document/move`, {
+      method:  "PATCH",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ documentId, versionId, folderId }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      return {
+        content: [{
+          type: "text",
+          text: `✅ Document(s) moved successfully!\n\nMoved to folder ID: ${folderId}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_share_document: async ({ documentId, versionId, shareEmail, shareAction, download, anybody = 0, note = "" }) => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    const res  = await fetch(`${QR_API_URL}/document/share`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ documentId, versionId, shareEmail, shareAction, download, anybody, note }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      return {
+        content: [{
+          type: "text",
+          text:
+            `✅ Document shared successfully!\n\n` +
+            `Shared with: ${shareEmail}\n` +
+            `Permission: ${shareAction}\n` +
+            `Download allowed: ${download === 1 ? "Yes" : "No"}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_get_trashed_documents: async ({ folderId = 0 }) => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    const res  = await fetch(`${QR_API_URL}/trashed`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ folderId }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      const items = Array.isArray(data) ? data : (data.rows || []);
+      return {
+        content: [{
+          type: "text",
+          text: `✅ Trashed documents fetched (${items.length} items)\n\n${JSON.stringify(data, null, 2)}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+};