#327: Add Buffer type support using formdata-node package

- Implemented `Buffer` to `File` conversion for attachment uploads.
- Added `attachment.mimeType` an optional property.
- Added automatic MIME type detection based on file extensions.

Author: MrRefactoring

package-lock.json

@@ -53,6 +53,7 @@
     "code:formatting": "npm run replace:all && npm run prettier && npm run lint:fix"
   },
   "devDependencies": {
+    "@types/mime-types": "^2.1.4",
     "@types/node": "^18.19.69",
     "@types/sinon": "^17.0.3",
     "@typescript-eslint/eslint-plugin": "^8.19.0",
@@ -73,6 +74,7 @@
   "dependencies": {
     "axios": "^1.7.9",
     "formdata-node": "^6.0.3",
+    "mime-types": "^2.1.35",
     "tslib": "^2.8.1"
   }
 }

package.json

@@ -1,6 +1,7 @@
 export interface Attachment {
   filename: string;
   file: Buffer | ReadableStream | string | Blob | File;
+  mimeType?: string;
 }
 
 export interface AttachTemporaryFile {

src/serviceDesk/parameters/attachTemporaryFile.ts

@@ -1,4 +1,5 @@
 import { FormData } from 'formdata-node';
+import * as mime from 'mime-types';
 import * as Models from './models';
 import * as Parameters from './parameters';
 import { Callback } from '../callback';
@@ -116,7 +117,14 @@ export class ServiceDesk {
     const formData = new FormData();
     const attachments = Array.isArray(parameters.attachment) ? parameters.attachment : [parameters.attachment];
 
-    attachments.forEach(attachment => formData.append('file', attachment.file, attachment.filename));
+    attachments.forEach(attachment => {
+      const mimeType = attachment.mimeType ?? (mime.lookup(attachment.filename) || undefined);
+      const file = Buffer.isBuffer(attachment.file)
+        ? new File([attachment.file], attachment.filename, { type: mimeType })
+        : attachment.file;
+
+      formData.append('file', file, attachment.filename);
+    });
 
     const config: RequestConfig = {
       url: `/rest/servicedeskapi/servicedesk/${parameters.serviceDeskId}/attachTemporaryFile`,

src/serviceDesk/serviceDesk.ts

@@ -1,4 +1,5 @@
 import { FormData } from 'formdata-node';
+import * as mime from 'mime-types';
 import * as Models from './models';
 import * as Parameters from './parameters';
 import { Callback } from '../callback';
@@ -425,7 +426,14 @@ export class IssueAttachments {
     const formData = new FormData();
     const attachments = Array.isArray(parameters.attachment) ? parameters.attachment : [parameters.attachment];
 
-    attachments.forEach(attachment => formData.append('file', attachment.file, attachment.filename));
+    attachments.forEach(attachment => {
+      const mimeType = attachment.mimeType ?? (mime.lookup(attachment.filename) || undefined);
+      const file = Buffer.isBuffer(attachment.file)
+        ? new File([attachment.file], attachment.filename, { type: mimeType })
+        : attachment.file;
+
+      formData.append('file', file, attachment.filename);
+    });
 
     const config: RequestConfig = {
       url: `/rest/api/2/issue/${parameters.issueIdOrKey}/attachments`,

src/version2/issueAttachments.ts

@@ -1,6 +1,7 @@
 export interface Attachment {
   filename: string;
   file: Buffer | ReadableStream | string | Blob | File;
+  mimeType?: string;
 }
 
 export interface AddAttachment {

src/version2/parameters/addAttachment.ts

@@ -1,4 +1,5 @@
 import { FormData } from 'formdata-node';
+import * as mime from 'mime-types';
 import * as Models from './models';
 import * as Parameters from './parameters';
 import { Callback } from '../callback';
@@ -425,7 +426,14 @@ export class IssueAttachments {
     const formData = new FormData();
     const attachments = Array.isArray(parameters.attachment) ? parameters.attachment : [parameters.attachment];
 
-    attachments.forEach(attachment => formData.append('file', attachment.file, attachment.filename));
+    attachments.forEach(attachment => {
+      const mimeType = attachment.mimeType ?? (mime.lookup(attachment.filename) || undefined);
+      const file = Buffer.isBuffer(attachment.file)
+        ? new File([attachment.file], attachment.filename, { type: mimeType })
+        : attachment.file;
+
+      formData.append('file', file, attachment.filename);
+    });
 
     const config: RequestConfig = {
       url: `/rest/api/3/issue/${parameters.issueIdOrKey}/attachments`,

src/version3/issueAttachments.ts

@@ -1,6 +1,7 @@
 export interface Attachment {
   filename: string;
   file: Buffer | ReadableStream | string | Blob | File;
+  mimeType?: string;
 }
 
 export interface AddAttachment {