/**
* SPDX-FileCopyrightText: © 2025 John Freier
* SPDX-License-Identifier: MIT
*
* ClickUp Task Service - Attachments Module
*
* Handles file attachment operations for ClickUp tasks, supporting three methods:
* - Uploading file attachments from base64/buffer data
* - Uploading file attachments from a URL (web URLs like http/https)
* - Uploading file attachments from local file paths (absolute paths)
*
* REFACTORED: Now uses composition instead of inheritance.
* Only depends on TaskServiceCore for base functionality.
*/
import { TaskServiceCore } from './task-core.js';
import { ClickUpTaskAttachment } from '../types.js';
/**
* Attachment functionality for the TaskService
*
* This service handles all file attachment operations for ClickUp tasks.
* It uses composition to access core functionality instead of inheritance.
*/
export class TaskServiceAttachments {
constructor(private core: TaskServiceCore) {}
/**
* Upload a file attachment to a ClickUp task
* @param taskId The ID of the task to attach the file to
* @param fileData The file data as a Buffer
* @param fileName The name of the file
* @returns Promise resolving to the attachment response from ClickUp
*/
async uploadTaskAttachment(taskId: string, fileData: Buffer, fileName: string): Promise<ClickUpTaskAttachment> {
(this.core as any).logOperation('uploadTaskAttachment', { taskId, fileName, fileSize: fileData.length });
try {
return await (this.core as any).makeRequest(async () => {
// Create FormData for multipart/form-data upload (native Web API)
const formData = new FormData();
// Convert Buffer to Blob and add to form data
const blob = new Blob([fileData], { type: 'application/octet-stream' });
formData.append('attachment', blob, fileName);
// Use the HTTP client for this request with FormData
const response = await (this.core as any).client.post(
`/task/${taskId}/attachment`,
formData,
{
headers: {
'Authorization': (this.core as any).apiKey
// FormData automatically sets Content-Type with boundary
}
}
);
return response.data;
});
} catch (error) {
throw (this.core as any).handleError(error, `Failed to upload attachment to task ${taskId}`);
}
}
/**
* Upload a file attachment to a ClickUp task from a URL
* @param taskId The ID of the task to attach the file to
* @param fileUrl The URL of the file to download and attach
* @param fileName Optional file name (if not provided, it will be extracted from the URL)
* @param authHeader Optional authorization header for the URL
* @returns Promise resolving to the attachment response from ClickUp
*/
async uploadTaskAttachmentFromUrl(
taskId: string,
fileUrl: string,
fileName?: string,
authHeader?: string
): Promise<ClickUpTaskAttachment> {
(this.core as any).logOperation('uploadTaskAttachmentFromUrl', { taskId, fileUrl, fileName });
try {
return await (this.core as any).makeRequest(async () => {
// Download the file from the URL using fetch
const headers: Record<string, string> = {};
if (authHeader) {
headers['Authorization'] = authHeader;
}
const response = await fetch(fileUrl, { headers });
if (!response.ok) {
throw new Error(`Failed to download file: ${response.statusText}`);
}
const arrayBuffer = await response.arrayBuffer();
// Extract filename from URL if not provided
const actualFileName = fileName || fileUrl.split('/').pop() || 'downloaded-file';
// Create FormData for multipart/form-data upload (native Web API)
const formData = new FormData();
// Convert ArrayBuffer to Blob and add to form data
const blob = new Blob([arrayBuffer], { type: 'application/octet-stream' });
formData.append('attachment', blob, actualFileName);
// Upload the file to ClickUp
const uploadResponse = await (this.core as any).client.post(
`/task/${taskId}/attachment`,
formData,
{
headers: {
'Authorization': (this.core as any).apiKey
// FormData automatically sets Content-Type with boundary
}
}
);
return uploadResponse.data;
});
} catch (error) {
throw (this.core as any).handleError(error, `Failed to upload attachment from URL to task ${taskId}`);
}
}
}
