@mtcsistemas/appflowy-mcp-server 1.0.0

package/dist/services/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/services/auth.ts"],"names":[],"mappings":"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"}

package/dist/tools/databases.d.ts

@@ -0,0 +1,7 @@
+/**
+ * AppFlowy MCP Server - Database Tools
+ * MCP tools for database/table operations
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerDatabaseTools(server: McpServer): void;
+//# sourceMappingURL=databases.d.ts.map

package/dist/tools/databases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"databases.d.ts","sourceRoot":"","sources":["../../src/tools/databases.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,QAmMtD"}

package/dist/tools/databases.js

@@ -0,0 +1,199 @@
+/**
+ * AppFlowy MCP Server - Database Tools
+ * MCP tools for database/table operations
+ */
+import { z } from 'zod';
+import { appflowyClient } from '../services/appflowy-client.js';
+export function registerDatabaseTools(server) {
+    // Tool: List databases
+    server.tool('appflowy_list_databases', `List all databases (Grid, Board, Calendar, Gallery) in a workspace.
+
+Args:
+  - workspace_id: The workspace ID`, {
+        workspace_id: z.string().describe('The workspace ID'),
+    }, async ({ workspace_id }) => {
+        try {
+            const databases = await appflowyClient.listDatabases(workspace_id);
+            if (databases.length === 0) {
+                return {
+                    content: [{ type: 'text', text: 'No databases found in this workspace.' }],
+                };
+            }
+            const lines = ['# Databases\n'];
+            for (const db of databases) {
+                const icon = getLayoutIcon(db.layout);
+                lines.push(`${icon} **${db.name}** (${db.layout})`);
+                lines.push(`   ID: ${db.view_id}`);
+                if (db.last_edited_time)
+                    lines.push(`   Last edited: ${db.last_edited_time}`);
+                lines.push('');
+            }
+            return {
+                content: [{ type: 'text', text: lines.join('\n') }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `❌ Error listing databases: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // Tool: Read database
+    server.tool('appflowy_read_database', `Read all rows from a database (table/kanban/calendar).
+
+Returns a markdown table with all data.
+
+Args:
+  - workspace_id: The workspace ID
+  - database_id: The database/view ID`, {
+        workspace_id: z.string().describe('The workspace ID'),
+        database_id: z.string().describe('The database/view ID'),
+    }, async ({ workspace_id, database_id }) => {
+        try {
+            const [dbInfo, rows] = await Promise.all([
+                appflowyClient.getDatabase(workspace_id, database_id),
+                appflowyClient.getDatabaseRows(workspace_id, database_id),
+            ]);
+            const lines = [`# ${dbInfo.name}\n`];
+            lines.push(`**Type**: ${dbInfo.views?.[0]?.layout || 'Grid'}\n`);
+            // Headers
+            const headers = dbInfo.fields.map((f) => f.name).join(' | ');
+            lines.push(`| ${headers} |`);
+            lines.push(`|${dbInfo.fields.map(() => '---').join('|')}|`);
+            // Rows
+            for (const row of rows) {
+                const cells = dbInfo.fields.map((f) => {
+                    const cell = row.cells[f.id];
+                    return formatCellValue(cell);
+                });
+                lines.push(`| ${cells.join(' | ')} |`);
+            }
+            lines.push(`\n*Total rows: ${rows.length}*`);
+            return {
+                content: [{ type: 'text', text: lines.join('\n') }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `❌ Error reading database: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // Tool: Create database row
+    server.tool('appflowy_create_database_row', `Create a new row/entry in a database.
+
+Args:
+  - workspace_id: The workspace ID
+  - database_id: The database/view ID
+  - cells: Object with field IDs as keys and values
+
+Example cells:
+  {\"field_abc123\": \"Task name\", \"field_def456\": \"In Progress\"}`, {
+        workspace_id: z.string().describe('The workspace ID'),
+        database_id: z.string().describe('The database/view ID'),
+        cells: z.record(z.any()).describe('Cell values { field_id: value }'),
+    }, async ({ workspace_id, database_id, cells }) => {
+        try {
+            const row = await appflowyClient.createDatabaseRow(workspace_id, database_id, cells);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `✅ Row created successfully.\n\n- Row ID: ${row.id}\n- Created: ${row.created_at}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `❌ Error creating row: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // Tool: Update database row
+    server.tool('appflowy_update_database_row', `Update an existing row in a database.
+
+Args:
+  - workspace_id: The workspace ID
+  - database_id: The database/view ID
+  - row_id: The row ID to update
+  - cells: Object with field IDs and new values`, {
+        workspace_id: z.string().describe('The workspace ID'),
+        database_id: z.string().describe('The database/view ID'),
+        row_id: z.string().describe('The row ID to update'),
+        cells: z.record(z.any()).describe('Cell values to update { field_id: value }'),
+    }, async ({ workspace_id, database_id, row_id, cells }) => {
+        try {
+            const row = await appflowyClient.updateDatabaseRow(workspace_id, database_id, row_id, cells);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `✅ Row updated successfully.\n\n- Row ID: ${row.id}\n- Last modified: ${row.last_modified}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `❌ Error updating row: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // Tool: Delete database row
+    server.tool('appflowy_delete_database_row', `⚠️ Delete a row from a database. This action cannot be undone!
+
+Args:
+  - workspace_id: The workspace ID
+  - database_id: The database/view ID
+  - row_id: The row ID to delete`, {
+        workspace_id: z.string().describe('The workspace ID'),
+        database_id: z.string().describe('The database/view ID'),
+        row_id: z.string().describe('The row ID to delete'),
+    }, async ({ workspace_id, database_id, row_id }) => {
+        try {
+            await appflowyClient.deleteDatabaseRow(workspace_id, database_id, row_id);
+            return {
+                content: [{ type: 'text', text: '🗑️ Row deleted successfully.' }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `❌ Error deleting row: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+// Helper: Get icon for layout
+function getLayoutIcon(layout) {
+    const icons = {
+        Grid: '📊',
+        Board: '📋',
+        Calendar: '📅',
+        Gallery: '🖼️',
+    };
+    return icons[layout] || '📊';
+}
+// Helper: Format cell value for display
+function formatCellValue(cell) {
+    if (!cell)
+        return '-';
+    if (cell.text)
+        return cell.text;
+    if (cell.value !== undefined) {
+        if (Array.isArray(cell.value))
+            return cell.value.join(', ');
+        if (typeof cell.value === 'boolean')
+            return cell.value ? '✅' : '❌';
+        if (cell.value === null || cell.value === '')
+            return '-';
+        return String(cell.value);
+    }
+    return '-';
+}
+//# sourceMappingURL=databases.js.map

package/dist/tools/databases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"databases.js","sourceRoot":"","sources":["../../src/tools/databases.ts"],"names":[],"mappings":"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"}

package/dist/tools/documents.d.ts

@@ -0,0 +1,7 @@
+/**
+ * AppFlowy MCP Server - Document Tools
+ * MCP tools for document/page management
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerDocumentTools(server: McpServer): void;
+//# sourceMappingURL=documents.d.ts.map

package/dist/tools/documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/tools/documents.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,QA4LtD"}

package/dist/tools/documents.js

@@ -0,0 +1,197 @@
+/**
+ * AppFlowy MCP Server - Document Tools
+ * MCP tools for document/page management
+ */
+import { z } from 'zod';
+import { appflowyClient } from '../services/appflowy-client.js';
+export function registerDocumentTools(server) {
+    // Tool: List documents
+    server.tool('appflowy_list_documents', `List all documents/pages in a workspace or folder.
+
+Can list root-level documents or documents inside a specific folder (parent_view_id).
+
+Args:
+  - workspace_id: The workspace ID
+  - parent_view_id (optional): Folder ID to list contents inside`, {
+        workspace_id: z.string().describe('The workspace ID'),
+        parent_view_id: z.string().optional().describe('Parent folder/view ID (optional)'),
+    }, async ({ workspace_id, parent_view_id }) => {
+        try {
+            const docs = await appflowyClient.listDocuments(workspace_id, parent_view_id);
+            if (docs.length === 0) {
+                return {
+                    content: [{ type: 'text', text: 'No documents found.' }],
+                };
+            }
+            const lines = [`# Documents${parent_view_id ? ' in folder' : ''}\n`];
+            for (const doc of docs) {
+                const icon = doc.icon || getLayoutIcon(doc.layout);
+                lines.push(`${icon} **${doc.name}**`);
+                lines.push(`   ID: ${doc.view_id} | Type: ${doc.layout}`);
+                if (doc.last_edited_time) {
+                    lines.push(`   Last edited: ${doc.last_edited_time}`);
+                }
+                lines.push('');
+            }
+            return {
+                content: [{ type: 'text', text: lines.join('\n') }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `❌ Error listing documents: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // Tool: Read document
+    server.tool('appflowy_read_document', `Read the full content of a document/page from AppFlowy.
+
+Returns the document metadata and text content extracted from blocks.
+
+Args:
+  - workspace_id: The workspace ID
+  - document_id: The document/view ID`, {
+        workspace_id: z.string().describe('The workspace ID'),
+        document_id: z.string().describe('The document/view ID'),
+    }, async ({ workspace_id, document_id }) => {
+        try {
+            const [docMeta, content] = await Promise.all([
+                appflowyClient.getDocument(workspace_id, document_id),
+                appflowyClient.getDocumentContent(workspace_id, document_id),
+            ]);
+            let textContent = '';
+            if (content?.blocks) {
+                textContent = extractTextFromBlocks(content.blocks);
+            }
+            const lines = [`# ${docMeta.name}\n`];
+            lines.push(`**ID**: ${docMeta.view_id}`);
+            lines.push(`**Type**: ${docMeta.layout}`);
+            lines.push(`**Created**: ${docMeta.created_at}`);
+            if (docMeta.last_edited_time)
+                lines.push(`**Last edited**: ${docMeta.last_edited_time}`);
+            lines.push('');
+            lines.push('---');
+            lines.push('');
+            lines.push(textContent || '*Document is empty or contains unsupported content.*');
+            return {
+                content: [{ type: 'text', text: lines.join('\n') }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `❌ Error reading document: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // Tool: Create document
+    server.tool('appflowy_create_document', `Create a new document/page in AppFlowy.
+
+Args:
+  - workspace_id: The workspace ID
+  - name: Document name/title
+  - parent_view_id (optional): Folder ID to place document inside`, {
+        workspace_id: z.string().describe('The workspace ID'),
+        name: z.string().min(1).max(200).describe('Document name/title'),
+        parent_view_id: z.string().optional().describe('Parent folder ID (optional)'),
+    }, async ({ workspace_id, name, parent_view_id }) => {
+        try {
+            const doc = await appflowyClient.createDocument(workspace_id, name, parent_view_id);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `✅ Document created: **${doc.name}**\n\n- ID: ${doc.view_id}\n- Type: ${doc.layout}\n- Created: ${doc.created_at}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `❌ Error creating document: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // Tool: Delete document
+    server.tool('appflowy_delete_document', `⚠️ Delete a document/page from AppFlowy. This action cannot be undone!
+
+Args:
+  - workspace_id: The workspace ID
+  - document_id: The document/view ID to delete`, {
+        workspace_id: z.string().describe('The workspace ID'),
+        document_id: z.string().describe('The document/view ID to delete'),
+    }, async ({ workspace_id, document_id }) => {
+        try {
+            await appflowyClient.deleteDocument(workspace_id, document_id);
+            return {
+                content: [{ type: 'text', text: '🗑️ Document deleted successfully.' }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `❌ Error deleting document: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // Tool: Duplicate document
+    server.tool('appflowy_duplicate_document', `Duplicate/clone an existing document/page.
+
+Args:
+  - workspace_id: The workspace ID
+  - document_id: The document/view ID to duplicate`, {
+        workspace_id: z.string().describe('The workspace ID'),
+        document_id: z.string().describe('The document/view ID to duplicate'),
+    }, async ({ workspace_id, document_id }) => {
+        try {
+            const doc = await appflowyClient.duplicateDocument(workspace_id, document_id);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `📄 Document duplicated: **${doc.name}**\n\n- New ID: ${doc.view_id}\n- Original ID: ${document_id}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `❌ Error duplicating document: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+// Helper: Get icon for document layout
+function getLayoutIcon(layout) {
+    const icons = {
+        Document: '📄',
+        Grid: '📊',
+        Board: '📋',
+        Calendar: '📅',
+        Gallery: '🖼️',
+        Chat: '💬',
+    };
+    return icons[layout] || '📄';
+}
+// Helper: Extract text from document blocks recursively
+function extractTextFromBlocks(blocks) {
+    const texts = [];
+    for (const block of blocks) {
+        if (block.data?.text) {
+            texts.push(block.data.text);
+        }
+        if (block.data?.url && block.type === 'file') {
+            texts.push(`[File: ${block.data.name || 'attachment'} (${block.data.file_type || 'unknown'})]`);
+        }
+        if (block.children?.length) {
+            const childTexts = extractTextFromBlocks(block.children);
+            if (childTexts)
+                texts.push(childTexts);
+        }
+    }
+    return texts.join('\n');
+}
+//# sourceMappingURL=documents.js.map

package/dist/tools/documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.js","sourceRoot":"","sources":["../../src/tools/documents.ts"],"names":[],"mappings":"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"}

package/dist/tools/files.d.ts

@@ -0,0 +1,7 @@
+/**
+ * AppFlowy MCP Server - File/Attachment Tools
+ * MCP tools for uploading, downloading, and managing file attachments
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerFileTools(server: McpServer): void;
+//# sourceMappingURL=files.d.ts.map

package/dist/tools/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/tools/files.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,QAmNlD"}

package/dist/tools/files.js

@@ -0,0 +1,196 @@
+/**
+ * AppFlowy MCP Server - File/Attachment Tools
+ * MCP tools for uploading, downloading, and managing file attachments
+ */
+import { z } from 'zod';
+import { appflowyClient } from '../services/appflowy-client.js';
+import { existsSync } from 'fs';
+import { writeFileSync } from 'fs';
+import { resolve } from 'path';
+export function registerFileTools(server) {
+    // Tool: Upload file
+    server.tool('appflowy_upload_file', `Upload a file from your local machine to AppFlowy Cloud storage.
+
+The file will be stored in your workspace and can be attached to documents.
+
+Args:
+  - workspace_id: The workspace ID
+  - file_path: Absolute path to the local file
+  - parent_dir (optional): Storage directory (default: 'attachments')
+
+Supported file types: images, documents, PDFs, code files, etc.
+Max file size: configurable via APPFLOWY_MAX_FILE_SIZE_MB env var (default: 50MB)`, {
+        workspace_id: z.string().describe('The workspace ID'),
+        file_path: z.string().describe('Absolute path to the local file'),
+        parent_dir: z.string().default('attachments').describe('Storage directory name'),
+    }, async ({ workspace_id, file_path, parent_dir }) => {
+        try {
+            const resolvedPath = resolve(file_path);
+            if (!existsSync(resolvedPath)) {
+                return {
+                    content: [{ type: 'text', text: `❌ File not found: ${resolvedPath}` }],
+                    isError: true,
+                };
+            }
+            const result = await appflowyClient.uploadFile(workspace_id, resolvedPath, parent_dir);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `✅ File uploaded successfully!\n\n📎 **${result.name}**\n- File ID: ${result.file_id}\n- Size: ${formatFileSize(result.size)}\n- Type: ${result.mime_type}\n- URL: ${result.url}\n- Storage: ${parent_dir}/`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `❌ Upload error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // Tool: Download file
+    server.tool('appflowy_download_file', `Download a file from AppFlowy Cloud storage to your local machine.
+
+Args:
+  - workspace_id: The workspace ID
+  - file_id: The file ID (from upload or list_files)
+  - output_path: Absolute path where to save the file
+  - parent_dir (optional): Storage directory (default: 'attachments')`, {
+        workspace_id: z.string().describe('The workspace ID'),
+        file_id: z.string().describe('The file ID'),
+        output_path: z.string().describe('Absolute path to save the file'),
+        parent_dir: z.string().default('attachments').describe('Storage directory name'),
+    }, async ({ workspace_id, file_id, output_path, parent_dir }) => {
+        try {
+            const buffer = await appflowyClient.downloadFile(workspace_id, file_id, parent_dir);
+            const resolvedPath = resolve(output_path);
+            writeFileSync(resolvedPath, buffer);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `✅ File downloaded successfully!\n\n📥 Saved to: ${resolvedPath}\n- Size: ${formatFileSize(buffer.length)}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `❌ Download error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // Tool: List files
+    server.tool('appflowy_list_files', `List all files in a workspace storage directory.
+
+Args:
+  - workspace_id: The workspace ID
+  - parent_dir (optional): Storage directory (default: 'attachments')`, {
+        workspace_id: z.string().describe('The workspace ID'),
+        parent_dir: z.string().default('attachments').describe('Storage directory name'),
+    }, async ({ workspace_id, parent_dir }) => {
+        try {
+            const files = await appflowyClient.listFiles(workspace_id, parent_dir);
+            if (files.length === 0) {
+                return {
+                    content: [{ type: 'text', text: `No files found in ${parent_dir}/` }],
+                };
+            }
+            const lines = [`# Files in ${parent_dir}/\n`];
+            for (const file of files) {
+                lines.push(`📎 **${file.file_id}**`);
+                lines.push(`   URL: ${file.url}`);
+                lines.push('');
+            }
+            return {
+                content: [{ type: 'text', text: lines.join('\n') }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `❌ Error listing files: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // Tool: Delete file
+    server.tool('appflowy_delete_file', `⚠️ Delete a file from AppFlowy Cloud storage. This action cannot be undone!
+
+Args:
+  - workspace_id: The workspace ID
+  - file_id: The file ID to delete
+  - parent_dir (optional): Storage directory (default: 'attachments')`, {
+        workspace_id: z.string().describe('The workspace ID'),
+        file_id: z.string().describe('The file ID to delete'),
+        parent_dir: z.string().default('attachments').describe('Storage directory name'),
+    }, async ({ workspace_id, file_id, parent_dir }) => {
+        try {
+            await appflowyClient.deleteFile(workspace_id, file_id, parent_dir);
+            return {
+                content: [{ type: 'text', text: `🗑️ File ${file_id} deleted successfully.` }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `❌ Error deleting file: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // Tool: Attach file to document
+    server.tool('appflowy_attach_file_to_document', `Attach an uploaded file to a specific document/page in AppFlowy.
+
+This inserts a file block into the document so the file appears inline.
+
+Args:
+  - workspace_id: The workspace ID
+  - document_id: The document/view ID
+  - file_id: The uploaded file ID
+  - parent_dir (optional): Storage directory (default: 'attachments')`, {
+        workspace_id: z.string().describe('The workspace ID'),
+        document_id: z.string().describe('The document/view ID'),
+        file_id: z.string().describe('The uploaded file ID'),
+        parent_dir: z.string().default('attachments').describe('Storage directory name'),
+    }, async ({ workspace_id, document_id, file_id, parent_dir }) => {
+        try {
+            // Get file metadata
+            const metadata = await appflowyClient.getFileMetadata(workspace_id, file_id, parent_dir);
+            // Create upload result object
+            const uploadResult = {
+                file_id,
+                url: metadata.url || '',
+                name: metadata.file_name,
+                size: metadata.file_size,
+                mime_type: metadata.mime_type,
+                created_at: metadata.created_at,
+            };
+            await appflowyClient.attachFileToDocument(workspace_id, document_id, uploadResult, parent_dir);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `✅ File attached to document!\n\n📎 **${metadata.file_name}**\n- Document ID: ${document_id}\n- File ID: ${file_id}\n- Size: ${formatFileSize(metadata.file_size)}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `❌ Error attaching file: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+// Helper: Format file size
+function formatFileSize(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const k = 1024;
+    const sizes = ['B', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${parseFloat((bytes / Math.pow(k, i)).toFixed(2))} ${sizes[i]}`;
+}
+//# sourceMappingURL=files.js.map