@mtcsistemas/appflowy-mcp-server 1.0.0

package/dist/resources/workspace-resources.js

@@ -0,0 +1,86 @@
+/**
+ * AppFlowy MCP Server - MCP Resources
+ * Exposes AppFlowy data as MCP resources
+ */
+import { appflowyClient } from '../services/appflowy-client.js';
+export function registerWorkspaceResources(server) {
+    // Resource: List of workspaces
+    server.resource('appflowy_workspaces', 'appflowy://workspaces', {
+        description: 'List of all AppFlowy workspaces',
+        mimeType: 'application/json',
+    }, async () => {
+        const workspaces = await appflowyClient.listWorkspaces();
+        return {
+            contents: [
+                {
+                    uri: 'appflowy://workspaces',
+                    mimeType: 'application/json',
+                    text: JSON.stringify(workspaces, null, 2),
+                },
+            ],
+        };
+    });
+    // Resource: Workspace details
+    server.resource('appflowy_workspace', 'appflowy://workspace/{workspace_id}', {
+        description: 'Details of a specific AppFlowy workspace',
+        mimeType: 'application/json',
+    }, async (uri) => {
+        const match = uri.href.match(/appflowy:\/\/workspace\/([^\/]+)/);
+        if (!match)
+            throw new Error('Invalid workspace URI');
+        const workspace = await appflowyClient.getWorkspace(match[1]);
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(workspace, null, 2),
+                },
+            ],
+        };
+    });
+    // Resource: Document content
+    server.resource('appflowy_document', 'appflowy://document/{workspace_id}/{document_id}', {
+        description: 'Content of a specific AppFlowy document',
+        mimeType: 'application/json',
+    }, async (uri) => {
+        const match = uri.href.match(/appflowy:\/\/document\/([^\/]+)\/([^\/]+)/);
+        if (!match)
+            throw new Error('Invalid document URI');
+        const [, workspace_id, document_id] = match;
+        const content = await appflowyClient.getDocumentContent(workspace_id, document_id);
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(content, null, 2),
+                },
+            ],
+        };
+    });
+    // Resource: Database rows
+    server.resource('appflowy_database', 'appflowy://database/{workspace_id}/{database_id}', {
+        description: 'All rows from a specific AppFlowy database',
+        mimeType: 'application/json',
+    }, async (uri) => {
+        const match = uri.href.match(/appflowy:\/\/database\/([^\/]+)\/([^\/]+)/);
+        if (!match)
+            throw new Error('Invalid database URI');
+        const [, workspace_id, database_id] = match;
+        const [dbInfo, rows] = await Promise.all([
+            appflowyClient.getDatabase(workspace_id, database_id),
+            appflowyClient.getDatabaseRows(workspace_id, database_id),
+        ]);
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: 'application/json',
+                    text: JSON.stringify({ database: dbInfo, rows }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=workspace-resources.js.map

package/dist/resources/workspace-resources.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,7 @@
+/**
+ * AppFlowy MCP Server - MCP Server Setup
+ * Configures and assembles the MCP server with all tools, resources, and prompts
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createMcpServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWpE,wBAAgB,eAAe,IAAI,SAAS,CAoB3C"}

package/dist/server.js

@@ -0,0 +1,31 @@
+/**
+ * AppFlowy MCP Server - MCP Server Setup
+ * Configures and assembles the MCP server with all tools, resources, and prompts
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { MCP_CONFIG } from './config.js';
+import { registerWorkspaceTools } from './tools/workspaces.js';
+import { registerDocumentTools } from './tools/documents.js';
+import { registerDatabaseTools } from './tools/databases.js';
+import { registerSearchTools } from './tools/search.js';
+import { registerFileTools } from './tools/files.js';
+import { registerWorkspaceResources } from './resources/workspace-resources.js';
+import { registerAppFlowyPrompts } from './prompts/appflowy-prompts.js';
+export function createMcpServer() {
+    const server = new McpServer({
+        name: MCP_CONFIG.serverName,
+        version: MCP_CONFIG.serverVersion,
+    });
+    // Register all tools
+    registerWorkspaceTools(server);
+    registerDocumentTools(server);
+    registerDatabaseTools(server);
+    registerSearchTools(server);
+    registerFileTools(server);
+    // Register resources
+    registerWorkspaceResources(server);
+    // Register prompts
+    registerAppFlowyPrompts(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAExE,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,UAAU,CAAC,UAAU;QAC3B,OAAO,EAAE,UAAU,CAAC,aAAa;KAClC,CAAC,CAAC;IAEH,qBAAqB;IACrB,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE1B,qBAAqB;IACrB,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAEnC,mBAAmB;IACnB,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAEhC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/services/appflowy-client.d.ts

@@ -0,0 +1,65 @@
+/**
+ * AppFlowy MCP Server - AppFlowy API Client
+ * HTTP client for all AppFlowy Cloud REST API endpoints
+ */
+import { Workspace, Document, DocumentContent, Database, DatabaseRow, SearchResult, FileUploadResult, FileMetadata, BlobInfo } from '../types.js';
+declare class AppFlowyClient {
+    private client;
+    constructor();
+    listWorkspaces(): Promise<Workspace[]>;
+    getWorkspace(workspaceId: string): Promise<Workspace>;
+    listDocuments(workspaceId: string, parentViewId?: string): Promise<Document[]>;
+    getDocument(workspaceId: string, documentId: string): Promise<Document>;
+    getDocumentContent(workspaceId: string, documentId: string): Promise<DocumentContent>;
+    createDocument(workspaceId: string, name: string, parentViewId?: string): Promise<Document>;
+    updateDocument(workspaceId: string, documentId: string, updates: {
+        name?: string;
+    }): Promise<void>;
+    deleteDocument(workspaceId: string, documentId: string): Promise<void>;
+    moveDocument(workspaceId: string, documentId: string, newParentId: string): Promise<void>;
+    duplicateDocument(workspaceId: string, documentId: string): Promise<Document>;
+    listDatabases(workspaceId: string): Promise<Document[]>;
+    getDatabase(workspaceId: string, databaseId: string): Promise<Database>;
+    getDatabaseRows(workspaceId: string, databaseId: string): Promise<DatabaseRow[]>;
+    createDatabaseRow(workspaceId: string, databaseId: string, cells: Record<string, any>): Promise<DatabaseRow>;
+    updateDatabaseRow(workspaceId: string, databaseId: string, rowId: string, cells: Record<string, any>): Promise<DatabaseRow>;
+    deleteDatabaseRow(workspaceId: string, databaseId: string, rowId: string): Promise<void>;
+    search(workspaceId: string, query: string, limit?: number): Promise<SearchResult[]>;
+    globalSearch(query: string, limit?: number): Promise<SearchResult[]>;
+    /**
+     * Upload a file to AppFlowy Cloud storage
+     * @param workspaceId - Target workspace
+     * @param filePath - Local file path
+     * @param parentDir - Parent directory in storage (optional)
+     * @param onProgress - Progress callback
+     */
+    uploadFile(workspaceId: string, filePath: string, parentDir?: string, onProgress?: (progress: number) => void): Promise<FileUploadResult>;
+    /**
+     * Upload a file from a buffer (useful for generated content)
+     */
+    uploadBuffer(workspaceId: string, buffer: Buffer, fileName: string, mimeType?: string, parentDir?: string): Promise<FileUploadResult>;
+    /**
+     * Get file metadata and download URL
+     */
+    getFileMetadata(workspaceId: string, fileId: string, parentDir?: string): Promise<FileMetadata>;
+    /**
+     * Download a file as buffer
+     */
+    downloadFile(workspaceId: string, fileId: string, parentDir?: string): Promise<Buffer>;
+    /**
+     * Delete a file from storage
+     */
+    deleteFile(workspaceId: string, fileId: string, parentDir?: string): Promise<void>;
+    /**
+     * List files in a directory
+     */
+    listFiles(workspaceId: string, parentDir?: string): Promise<BlobInfo[]>;
+    /**
+     * Attach a file to a document by inserting a file block
+     */
+    attachFileToDocument(workspaceId: string, documentId: string, fileUploadResult: FileUploadResult, parentDir?: string): Promise<void>;
+    getWebSocketUrl(workspaceId: string, documentId: string): string;
+}
+export declare const appflowyClient: AppFlowyClient;
+export {};
+//# sourceMappingURL=appflowy-client.d.ts.map

package/dist/services/appflowy-client.d.ts.map

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

package/dist/services/appflowy-client.js

@@ -0,0 +1,303 @@
+/**
+ * AppFlowy MCP Server - AppFlowy API Client
+ * HTTP client for all AppFlowy Cloud REST API endpoints
+ */
+import axios from 'axios';
+import FormData from 'form-data';
+import { createReadStream } from 'fs';
+import { statSync } from 'fs';
+import { basename } from 'path';
+import { lookup } from 'mime-types';
+import { APPFLOWY_CONFIG, getApiUrl, getFileStorageUrl } from '../config.js';
+import { getAuthHeaders, getMultipartAuthHeaders } from './auth.js';
+class AppFlowyClient {
+    client;
+    constructor() {
+        this.client = axios.create({
+            baseURL: getApiUrl(),
+            timeout: 30000,
+        });
+        // Request interceptor: add auth headers to all requests
+        this.client.interceptors.request.use(async (config) => {
+            const headers = await getAuthHeaders();
+            Object.assign(config.headers, headers);
+            return config;
+        });
+        // Response interceptor: handle token expiration
+        this.client.interceptors.response.use((response) => response, async (error) => {
+            if (error.response?.status === 401) {
+                // Token might be expired, clear and retry once
+                const { refreshToken } = await import('./auth.js');
+                await refreshToken();
+                const headers = await getAuthHeaders();
+                error.config.headers = { ...error.config.headers, ...headers };
+                return this.client.request(error.config);
+            }
+            return Promise.reject(error);
+        });
+    }
+    // ============================================
+    // WORKSPACE OPERATIONS
+    // ============================================
+    async listWorkspaces() {
+        const response = await this.client.get('/workspace');
+        return response.data.data || [];
+    }
+    async getWorkspace(workspaceId) {
+        const response = await this.client.get(`/workspace/${workspaceId}`);
+        return response.data.data;
+    }
+    // ============================================
+    // DOCUMENT / VIEW OPERATIONS
+    // ============================================
+    async listDocuments(workspaceId, parentViewId) {
+        const url = parentViewId
+            ? `/workspace/${workspaceId}/folder?parent_view_id=${parentViewId}`
+            : `/workspace/${workspaceId}/folder`;
+        const response = await this.client.get(url);
+        return response.data.data?.views || [];
+    }
+    async getDocument(workspaceId, documentId) {
+        const response = await this.client.get(`/workspace/${workspaceId}/page-view/${documentId}`);
+        return response.data.data;
+    }
+    async getDocumentContent(workspaceId, documentId) {
+        const response = await this.client.get(`/workspace/${workspaceId}/page/${documentId}`);
+        return response.data.data;
+    }
+    async createDocument(workspaceId, name, parentViewId) {
+        const response = await this.client.post(`/workspace/${workspaceId}/page-view`, {
+            name,
+            layout: 'Document',
+            parent_view_id: parentViewId,
+        });
+        return response.data.data;
+    }
+    async updateDocument(workspaceId, documentId, updates) {
+        await this.client.patch(`/workspace/${workspaceId}/page-view/${documentId}`, updates);
+    }
+    async deleteDocument(workspaceId, documentId) {
+        await this.client.delete(`/workspace/${workspaceId}/page-view/${documentId}`);
+    }
+    async moveDocument(workspaceId, documentId, newParentId) {
+        await this.client.post(`/workspace/${workspaceId}/page-view/${documentId}/move`, {
+            new_parent_view_id: newParentId,
+        });
+    }
+    async duplicateDocument(workspaceId, documentId) {
+        const response = await this.client.post(`/workspace/${workspaceId}/page-view/${documentId}/duplicate`);
+        return response.data.data;
+    }
+    // ============================================
+    // DATABASE OPERATIONS
+    // ============================================
+    async listDatabases(workspaceId) {
+        const docs = await this.listDocuments(workspaceId);
+        return docs.filter((d) => ['Grid', 'Board', 'Calendar', 'Gallery'].includes(d.layout));
+    }
+    async getDatabase(workspaceId, databaseId) {
+        const response = await this.client.get(`/workspace/${workspaceId}/database/${databaseId}`);
+        return response.data.data;
+    }
+    async getDatabaseRows(workspaceId, databaseId) {
+        const response = await this.client.get(`/workspace/${workspaceId}/database/${databaseId}/row/detail`);
+        return response.data.data || [];
+    }
+    async createDatabaseRow(workspaceId, databaseId, cells) {
+        const response = await this.client.post(`/workspace/${workspaceId}/database/${databaseId}/row`, {
+            cells,
+        });
+        return response.data.data;
+    }
+    async updateDatabaseRow(workspaceId, databaseId, rowId, cells) {
+        const response = await this.client.put(`/workspace/${workspaceId}/database/${databaseId}/row/${rowId}`, {
+            cells,
+        });
+        return response.data.data;
+    }
+    async deleteDatabaseRow(workspaceId, databaseId, rowId) {
+        await this.client.delete(`/workspace/${workspaceId}/database/${databaseId}/row/${rowId}`);
+    }
+    // ============================================
+    // SEARCH OPERATIONS
+    // ============================================
+    async search(workspaceId, query, limit = 20) {
+        const response = await this.client.get(`/workspace/${workspaceId}/search`, {
+            params: { query, limit },
+        });
+        return response.data.data || [];
+    }
+    async globalSearch(query, limit = 20) {
+        const response = await this.client.get('/search', {
+            params: { query, limit },
+        });
+        return response.data.data || [];
+    }
+    // ============================================
+    // FILE / ATTACHMENT OPERATIONS
+    // ============================================
+    /**
+     * Upload a file to AppFlowy Cloud storage
+     * @param workspaceId - Target workspace
+     * @param filePath - Local file path
+     * @param parentDir - Parent directory in storage (optional)
+     * @param onProgress - Progress callback
+     */
+    async uploadFile(workspaceId, filePath, parentDir = 'attachments', onProgress) {
+        const fileName = basename(filePath);
+        const fileSize = statSync(filePath).size;
+        const mimeType = lookup(filePath) || 'application/octet-stream';
+        // Check file size limit
+        const maxSizeBytes = APPFLOWY_CONFIG.maxFileSizeMB * 1024 * 1024;
+        if (fileSize > maxSizeBytes) {
+            throw new Error(`File size (${(fileSize / 1024 / 1024).toFixed(2)}MB) exceeds maximum allowed (${APPFLOWY_CONFIG.maxFileSizeMB}MB)`);
+        }
+        const formData = new FormData();
+        formData.append('file', createReadStream(filePath), {
+            filename: fileName,
+            contentType: mimeType,
+            knownLength: fileSize,
+        });
+        const headers = await getMultipartAuthHeaders();
+        const uploadUrl = `${getFileStorageUrl()}/${workspaceId}/v1/blob/${parentDir}`;
+        const response = await axios.post(uploadUrl, formData, {
+            headers: {
+                ...headers,
+                ...formData.getHeaders(),
+            },
+            maxBodyLength: maxSizeBytes,
+            maxContentLength: maxSizeBytes,
+            timeout: APPFLOWY_CONFIG.fileTimeoutSec * 1000,
+            onUploadProgress: onProgress
+                ? (progressEvent) => {
+                    const percent = progressEvent.total
+                        ? Math.round((progressEvent.loaded * 100) / progressEvent.total)
+                        : 0;
+                    onProgress(percent);
+                }
+                : undefined,
+        });
+        return {
+            file_id: response.data.file_id || response.data.id,
+            url: response.data.url,
+            name: fileName,
+            size: fileSize,
+            mime_type: mimeType,
+            created_at: new Date().toISOString(),
+        };
+    }
+    /**
+     * Upload a file from a buffer (useful for generated content)
+     */
+    async uploadBuffer(workspaceId, buffer, fileName, mimeType = 'application/octet-stream', parentDir = 'attachments') {
+        const maxSizeBytes = APPFLOWY_CONFIG.maxFileSizeMB * 1024 * 1024;
+        if (buffer.length > maxSizeBytes) {
+            throw new Error(`Buffer size (${(buffer.length / 1024 / 1024).toFixed(2)}MB) exceeds maximum allowed (${APPFLOWY_CONFIG.maxFileSizeMB}MB)`);
+        }
+        const formData = new FormData();
+        formData.append('file', buffer, {
+            filename: fileName,
+            contentType: mimeType,
+        });
+        const headers = await getMultipartAuthHeaders();
+        const uploadUrl = `${getFileStorageUrl()}/${workspaceId}/v1/blob/${parentDir}`;
+        const response = await axios.post(uploadUrl, formData, {
+            headers: {
+                ...headers,
+                ...formData.getHeaders(),
+            },
+            maxBodyLength: maxSizeBytes,
+            maxContentLength: maxSizeBytes,
+            timeout: APPFLOWY_CONFIG.fileTimeoutSec * 1000,
+        });
+        return {
+            file_id: response.data.file_id || response.data.id,
+            url: response.data.url,
+            name: fileName,
+            size: buffer.length,
+            mime_type: mimeType,
+            created_at: new Date().toISOString(),
+        };
+    }
+    /**
+     * Get file metadata and download URL
+     */
+    async getFileMetadata(workspaceId, fileId, parentDir = 'attachments') {
+        const headers = await getAuthHeaders();
+        const url = `${getFileStorageUrl()}/${workspaceId}/v1/blob/${parentDir}/${fileId}`;
+        // HEAD request to get metadata
+        const headResponse = await axios.head(url, { headers });
+        return {
+            file_id: fileId,
+            file_name: headResponse.headers['x-file-name'] || fileId,
+            file_size: parseInt(headResponse.headers['content-length'] || '0', 10),
+            mime_type: headResponse.headers['content-type'] || 'application/octet-stream',
+            created_at: headResponse.headers['x-created-at'] || new Date().toISOString(),
+            modified_at: headResponse.headers['x-modified-at'],
+            url: url,
+        };
+    }
+    /**
+     * Download a file as buffer
+     */
+    async downloadFile(workspaceId, fileId, parentDir = 'attachments') {
+        const headers = await getAuthHeaders();
+        const url = `${getFileStorageUrl()}/${workspaceId}/v1/blob/${parentDir}/${fileId}`;
+        const response = await axios.get(url, {
+            headers,
+            responseType: 'arraybuffer',
+            timeout: APPFLOWY_CONFIG.fileTimeoutSec * 1000,
+        });
+        return Buffer.from(response.data);
+    }
+    /**
+     * Delete a file from storage
+     */
+    async deleteFile(workspaceId, fileId, parentDir = 'attachments') {
+        const headers = await getAuthHeaders();
+        const url = `${getFileStorageUrl()}/${workspaceId}/v1/blob/${parentDir}/${fileId}`;
+        await axios.delete(url, { headers });
+    }
+    /**
+     * List files in a directory
+     */
+    async listFiles(workspaceId, parentDir = 'attachments') {
+        const headers = await getAuthHeaders();
+        const url = `${getFileStorageUrl()}/${workspaceId}/v1/blob/${parentDir}`;
+        const response = await axios.get(url, { headers });
+        return response.data.data || [];
+    }
+    /**
+     * Attach a file to a document by inserting a file block
+     */
+    async attachFileToDocument(workspaceId, documentId, fileUploadResult, parentDir = 'attachments') {
+        // Get current document content
+        const content = await this.getDocumentContent(workspaceId, documentId);
+        // Create a file block
+        const fileBlock = {
+            type: 'file',
+            data: {
+                url: `${getFileStorageUrl()}/${workspaceId}/v1/blob/${parentDir}/${fileUploadResult.file_id}`,
+                name: fileUploadResult.name,
+                size: fileUploadResult.size,
+                file_type: fileUploadResult.mime_type,
+            },
+        };
+        // Append file block to document
+        content.blocks.push(fileBlock);
+        // Update document content
+        await this.client.put(`/workspace/${workspaceId}/page/${documentId}`, {
+            blocks: content.blocks,
+        });
+    }
+    // ============================================
+    // WEBSOCKET (Real-time collaboration)
+    // ============================================
+    getWebSocketUrl(workspaceId, documentId) {
+        const wsBase = APPFLOWY_CONFIG.baseUrl.replace('https://', 'wss://').replace('http://', 'ws://');
+        return `${wsBase}/ws/v1?workspace_id=${workspaceId}&document_id=${documentId}`;
+    }
+}
+// Export singleton instance
+export const appflowyClient = new AppFlowyClient();
+//# sourceMappingURL=appflowy-client.js.map

package/dist/services/appflowy-client.js.map

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

package/dist/services/auth.d.ts

@@ -0,0 +1,26 @@
+/**
+ * AppFlowy MCP Server - Authentication Service
+ * Handles JWT token management via GoTrue (Supabase Auth fork)
+ */
+/**
+ * Authenticate with AppFlowy Cloud via GoTrue
+ * Returns a valid JWT access token
+ */
+export declare function authenticate(): Promise<string>;
+/**
+ * Refresh the current token
+ */
+export declare function refreshToken(): Promise<string>;
+/**
+ * Get authorization headers for API requests
+ */
+export declare function getAuthHeaders(): Promise<Record<string, string>>;
+/**
+ * Get authorization headers for multipart requests (file uploads)
+ */
+export declare function getMultipartAuthHeaders(): Promise<Record<string, string>>;
+/**
+ * Clear cached token (useful for logout or token invalidation)
+ */
+export declare function clearToken(): void;
+//# sourceMappingURL=auth.d.ts.map

package/dist/services/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/services/auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAsCpD;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAuBpD;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAMtE;AAED;;GAEG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAK/E;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAGjC"}

package/dist/services/auth.js

@@ -0,0 +1,89 @@
+/**
+ * AppFlowy MCP Server - Authentication Service
+ * Handles JWT token management via GoTrue (Supabase Auth fork)
+ */
+import axios from 'axios';
+import { APPFLOWY_CONFIG, getGoTrueUrl } from '../config.js';
+let cachedToken = null;
+let tokenExpiry = null;
+/**
+ * Authenticate with AppFlowy Cloud via GoTrue
+ * Returns a valid JWT access token
+ */
+export async function authenticate() {
+    // Return cached token if still valid (with 5-minute buffer)
+    if (cachedToken && tokenExpiry && new Date() < tokenExpiry) {
+        return cachedToken.access_token;
+    }
+    // Use pre-configured JWT token if available
+    if (APPFLOWY_CONFIG.jwtToken) {
+        return APPFLOWY_CONFIG.jwtToken;
+    }
+    // Authenticate with email/password via GoTrue
+    const authUrl = `${getGoTrueUrl()}/token?grant_type=password`;
+    try {
+        const response = await axios.post(authUrl, {
+            email: APPFLOWY_CONFIG.email,
+            password: APPFLOWY_CONFIG.password,
+        }, {
+            headers: { 'Content-Type': 'application/json' },
+            timeout: 30000,
+        });
+        cachedToken = response.data;
+        // Set expiry with 5-minute safety buffer
+        const expiresInMs = (cachedToken.expires_in - 300) * 1000;
+        tokenExpiry = new Date(Date.now() + expiresInMs);
+        return cachedToken.access_token;
+    }
+    catch (error) {
+        const message = error.response?.data?.msg || error.message;
+        throw new Error(`AppFlowy authentication failed: ${message}`);
+    }
+}
+/**
+ * Refresh the current token
+ */
+export async function refreshToken() {
+    if (!cachedToken?.refresh_token) {
+        return authenticate();
+    }
+    const refreshUrl = `${getGoTrueUrl()}/token?grant_type=refresh_token`;
+    try {
+        const response = await axios.post(refreshUrl, { refresh_token: cachedToken.refresh_token }, { headers: { 'Content-Type': 'application/json' } });
+        cachedToken = response.data;
+        const expiresInMs = (cachedToken.expires_in - 300) * 1000;
+        tokenExpiry = new Date(Date.now() + expiresInMs);
+        return cachedToken.access_token;
+    }
+    catch (error) {
+        // If refresh fails, try full re-authentication
+        return authenticate();
+    }
+}
+/**
+ * Get authorization headers for API requests
+ */
+export async function getAuthHeaders() {
+    const token = await authenticate();
+    return {
+        Authorization: `Bearer ${token}`,
+        'Content-Type': 'application/json',
+    };
+}
+/**
+ * Get authorization headers for multipart requests (file uploads)
+ */
+export async function getMultipartAuthHeaders() {
+    const token = await authenticate();
+    return {
+        Authorization: `Bearer ${token}`,
+    };
+}
+/**
+ * Clear cached token (useful for logout or token invalidation)
+ */
+export function clearToken() {
+    cachedToken = null;
+    tokenExpiry = null;
+}
+//# sourceMappingURL=auth.js.map