nylas 7.10.0 → 7.12.0

package/lib/cjs/apiClient.js

@@ -156,10 +156,6 @@ class APIClient {
         }
         if (optionParams.form) {
             requestOptions.body = optionParams.form;
-            requestOptions.headers = {
-                ...requestOptions.headers,
-                ...optionParams.form.getHeaders(),
-            };
         }
         return requestOptions;
     }
@@ -198,6 +194,10 @@ class APIClient {
     }
     async requestStream(options) {
         const response = await this.sendRequest(options);
+        // TODO: See if we can fix this in a backwards compatible way
+        if (!response.body) {
+            throw new Error('No response body');
+        }
         return response.body;
     }
 }

package/lib/cjs/config.js

@@ -8,7 +8,7 @@ var Region;
 (function (Region) {
     Region["Us"] = "us";
     Region["Eu"] = "eu";
-})(Region = exports.Region || (exports.Region = {}));
+})(Region || (exports.Region = Region = {}));
 /**
  * The default Nylas API region.
  * @default Region.Us

package/lib/cjs/models/availability.js

@@ -9,4 +9,4 @@ var AvailabilityMethod;
     AvailabilityMethod["MaxFairness"] = "max-fairness";
     AvailabilityMethod["MaxAvailability"] = "max-availability";
     AvailabilityMethod["Collective"] = "collective";
-})(AvailabilityMethod = exports.AvailabilityMethod || (exports.AvailabilityMethod = {}));
+})(AvailabilityMethod || (exports.AvailabilityMethod = AvailabilityMethod = {}));

package/lib/cjs/models/credentials.js

@@ -9,4 +9,4 @@ var CredentialType;
     CredentialType["ADMINCONSENT"] = "adminconsent";
     CredentialType["SERVICEACCOUNT"] = "serviceaccount";
     CredentialType["CONNECTOR"] = "connector";
-})(CredentialType = exports.CredentialType || (exports.CredentialType = {}));
+})(CredentialType || (exports.CredentialType = CredentialType = {}));

package/lib/cjs/models/events.js

@@ -10,4 +10,4 @@ var WhenType;
     WhenType["Timespan"] = "timespan";
     WhenType["Date"] = "date";
     WhenType["Datespan"] = "datespan";
-})(WhenType = exports.WhenType || (exports.WhenType = {}));
+})(WhenType || (exports.WhenType = WhenType = {}));

package/lib/cjs/models/freeBusy.js

@@ -8,4 +8,4 @@ var FreeBusyType;
 (function (FreeBusyType) {
     FreeBusyType["FREE_BUSY"] = "free_busy";
     FreeBusyType["ERROR"] = "error";
-})(FreeBusyType = exports.FreeBusyType || (exports.FreeBusyType = {}));
+})(FreeBusyType || (exports.FreeBusyType = FreeBusyType = {}));

package/lib/cjs/models/messages.js

@@ -8,4 +8,6 @@ var MessageFields;
 (function (MessageFields) {
     MessageFields["STANDARD"] = "standard";
     MessageFields["INCLUDE_HEADERS"] = "include_headers";
-})(MessageFields = exports.MessageFields || (exports.MessageFields = {}));
+    MessageFields["INCLUDE_TRACKING_OPTIONS"] = "include_tracking_options";
+    MessageFields["RAW_MIME"] = "raw_mime";
+})(MessageFields || (exports.MessageFields = MessageFields = {}));

package/lib/cjs/models/webhooks.js

@@ -45,4 +45,4 @@ var WebhookTriggers;
     WebhookTriggers["BookingRescheduled"] = "booking.rescheduled";
     WebhookTriggers["BookingCancelled"] = "booking.cancelled";
     WebhookTriggers["BookingReminder"] = "booking.reminder";
-})(WebhookTriggers = exports.WebhookTriggers || (exports.WebhookTriggers = {}));
+})(WebhookTriggers || (exports.WebhookTriggers = WebhookTriggers = {}));

package/lib/cjs/resources/auth.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Auth = void 0;
 const uuid_1 = require("uuid");
-const crypto_1 = require("crypto");
+const node_crypto_1 = require("node:crypto");
 const resource_js_1 = require("./resource.js");
 const utils_js_1 = require("../utils.js");
 /**
@@ -166,7 +166,7 @@ class Auth extends resource_js_1.Resource {
         return url;
     }
     hashPKCESecret(secret) {
-        const hash = (0, crypto_1.createHash)('sha256').update(secret).digest('hex');
+        const hash = (0, node_crypto_1.createHash)('sha256').update(secret).digest('hex');
         return Buffer.from(hash).toString('base64').replace(/=+$/, '');
     }
     getTokenInfo(params) {

package/lib/cjs/resources/drafts.js

@@ -43,11 +43,9 @@ class Drafts extends resource_js_1.Resource {
         const path = (0, utils_js_2.makePathParams)('/v3/grants/{identifier}/drafts', {
             identifier,
         });
-        // Use form data only if the attachment size is greater than 3mb
-        const attachmentSize = requestBody.attachments?.reduce((total, attachment) => {
-            return total + (attachment.size || 0);
-        }, 0) || 0;
-        if (attachmentSize >= messages_js_1.Messages.MAXIMUM_JSON_ATTACHMENT_SIZE) {
+        // Use form data if the total payload size (body + attachments) is greater than 3mb
+        const totalPayloadSize = (0, utils_js_1.calculateTotalPayloadSize)(requestBody);
+        if (totalPayloadSize >= messages_js_1.Messages.MAXIMUM_JSON_ATTACHMENT_SIZE) {
             const form = messages_js_1.Messages._buildFormRequest(requestBody);
             return this.apiClient.request({
                 method: 'POST',
@@ -57,7 +55,7 @@ class Drafts extends resource_js_1.Resource {
             });
         }
         else if (requestBody.attachments) {
-            const processedAttachments = await (0, utils_js_1.encodeAttachmentStreams)(requestBody.attachments);
+            const processedAttachments = await (0, utils_js_1.encodeAttachmentContent)(requestBody.attachments);
             requestBody = {
                 ...requestBody,
                 attachments: processedAttachments,
@@ -78,11 +76,9 @@ class Drafts extends resource_js_1.Resource {
             identifier,
             draftId,
         });
-        // Use form data only if the attachment size is greater than 3mb
-        const attachmentSize = requestBody.attachments?.reduce((total, attachment) => {
-            return total + (attachment.size || 0);
-        }, 0) || 0;
-        if (attachmentSize >= messages_js_1.Messages.MAXIMUM_JSON_ATTACHMENT_SIZE) {
+        // Use form data if the total payload size (body + attachments) is greater than 3mb
+        const totalPayloadSize = (0, utils_js_1.calculateTotalPayloadSize)(requestBody);
+        if (totalPayloadSize >= messages_js_1.Messages.MAXIMUM_JSON_ATTACHMENT_SIZE) {
             const form = messages_js_1.Messages._buildFormRequest(requestBody);
             return this.apiClient.request({
                 method: 'PUT',
@@ -92,7 +88,7 @@ class Drafts extends resource_js_1.Resource {
             });
         }
         else if (requestBody.attachments) {
-            const processedAttachments = await (0, utils_js_1.encodeAttachmentStreams)(requestBody.attachments);
+            const processedAttachments = await (0, utils_js_1.encodeAttachmentContent)(requestBody.attachments);
             requestBody = {
                 ...requestBody,
                 attachments: processedAttachments,

package/lib/cjs/resources/messages.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Messages = void 0;
+const formdata_node_1 = require("formdata-node");
 const utils_js_1 = require("../utils.js");
 const resource_js_1 = require("./resource.js");
 const smartCompose_js_1 = require("./smartCompose.js");
@@ -89,16 +90,14 @@ class Messages extends resource_js_1.Resource {
             path,
             overrides,
         };
-        // Use form data only if the attachment size is greater than 3mb
-        const attachmentSize = requestBody.attachments?.reduce((total, attachment) => {
-            return total + (attachment.size || 0);
-        }, 0) || 0;
-        if (attachmentSize >= Messages.MAXIMUM_JSON_ATTACHMENT_SIZE) {
+        // Use form data if the total payload size (body + attachments) is greater than 3mb
+        const totalPayloadSize = (0, utils_js_1.calculateTotalPayloadSize)(requestBody);
+        if (totalPayloadSize >= Messages.MAXIMUM_JSON_ATTACHMENT_SIZE) {
             requestOptions.form = Messages._buildFormRequest(requestBody);
         }
         else {
             if (requestBody.attachments) {
-                const processedAttachments = await (0, utils_js_1.encodeAttachmentStreams)(requestBody.attachments);
+                const processedAttachments = await (0, utils_js_1.encodeAttachmentContent)(requestBody.attachments);
                 requestOptions.body = {
                     ...requestBody,
                     attachments: processedAttachments,
@@ -157,10 +156,7 @@ class Messages extends resource_js_1.Resource {
         });
     }
     static _buildFormRequest(requestBody) {
-        // FormData imports are funky, cjs needs to use .default, es6 doesn't
-        const FD = require('form-data');
-        const FormDataConstructor = FD.default || FD;
-        const form = new FormDataConstructor();
+        const form = new formdata_node_1.FormData();
         // Split out the message payload from the attachments
         const messagePayload = {
             ...requestBody,
@@ -168,13 +164,30 @@ class Messages extends resource_js_1.Resource {
         };
         form.append('message', JSON.stringify((0, utils_js_1.objKeysToSnakeCase)(messagePayload)));
         // Add a separate form field for each attachment
-        requestBody.attachments?.forEach((attachment, index) => {
-            const contentId = attachment.contentId || `file${index}`;
-            form.append(contentId, attachment.content, {
-                filename: attachment.filename,
-                contentType: attachment.contentType,
+        if (requestBody.attachments && requestBody.attachments.length > 0) {
+            requestBody.attachments.map((attachment, index) => {
+                const contentId = attachment.contentId || `file${index}`;
+                // Handle different content types for formdata-node
+                if (typeof attachment.content === 'string') {
+                    // Base64 string - create a Blob
+                    const buffer = Buffer.from(attachment.content, 'base64');
+                    const blob = new formdata_node_1.Blob([buffer], { type: attachment.contentType });
+                    form.append(contentId, blob, attachment.filename);
+                }
+                else if (Buffer.isBuffer(attachment.content)) {
+                    // Buffer - create a Blob
+                    const blob = new formdata_node_1.Blob([attachment.content], {
+                        type: attachment.contentType,
+                    });
+                    form.append(contentId, blob, attachment.filename);
+                }
+                else {
+                    // ReadableStream - create a proper file-like object according to formdata-node docs
+                    const file = (0, utils_js_1.attachmentStreamToFile)(attachment);
+                    form.append(contentId, file, attachment.filename);
+                }
             });
-        });
+        }
         return form;
     }
 }

package/lib/cjs/utils.js

@@ -1,11 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.makePathParams = exports.safePath = exports.objKeysToSnakeCase = exports.objKeysToCamelCase = exports.encodeAttachmentStreams = exports.createFileRequestBuilder = void 0;
+exports.createFileRequestBuilder = createFileRequestBuilder;
+exports.attachmentStreamToFile = attachmentStreamToFile;
+exports.encodeAttachmentContent = encodeAttachmentContent;
+exports.encodeAttachmentStreams = encodeAttachmentStreams;
+exports.objKeysToCamelCase = objKeysToCamelCase;
+exports.objKeysToSnakeCase = objKeysToSnakeCase;
+exports.safePath = safePath;
+exports.makePathParams = makePathParams;
+exports.calculateTotalPayloadSize = calculateTotalPayloadSize;
 const change_case_1 = require("change-case");
-const fs = require("fs");
-const path = require("path");
+const fs = require("node:fs");
+const path = require("node:path");
 const mime = require("mime-types");
-const stream_1 = require("stream");
+const node_stream_1 = require("node:stream");
 function createFileRequestBuilder(filePath) {
     const stats = fs.statSync(filePath);
     const filename = path.basename(filePath);
@@ -18,7 +26,6 @@ function createFileRequestBuilder(filePath) {
         size: stats.size,
     };
 }
-exports.createFileRequestBuilder = createFileRequestBuilder;
 /**
  * Converts a ReadableStream to a base64 encoded string.
  * @param stream The ReadableStream containing the binary data.
@@ -40,19 +47,67 @@ function streamToBase64(stream) {
     });
 }
 /**
- * Encodes the content of each attachment stream to base64.
+ * Converts a ReadableStream to a File-like object that can be used with FormData.
+ * @param attachment The attachment containing the stream and metadata.
+ * @param mimeType The MIME type for the file (optional).
+ * @returns A File-like object that properly handles the stream.
+ */
+function attachmentStreamToFile(attachment, mimeType) {
+    if (mimeType != null && typeof mimeType !== 'string') {
+        throw new Error('Invalid mimetype, expected string.');
+    }
+    const content = attachment.content;
+    if (typeof content === 'string' || Buffer.isBuffer(content)) {
+        throw new Error('Invalid attachment content, expected ReadableStream.');
+    }
+    // Create a file-shaped object that FormData can handle properly
+    const fileObject = {
+        type: mimeType || attachment.contentType,
+        name: attachment.filename,
+        [Symbol.toStringTag]: 'File',
+        stream() {
+            return content;
+        },
+    };
+    // Add size if available
+    if (attachment.size !== undefined) {
+        fileObject.size = attachment.size;
+    }
+    return fileObject;
+}
+/**
+ * Encodes the content of each attachment to base64.
+ * Handles ReadableStream, Buffer, and string content types.
  * @param attachments The attachments to encode.
  * @returns The attachments with their content encoded to base64.
  */
-async function encodeAttachmentStreams(attachments) {
+async function encodeAttachmentContent(attachments) {
     return await Promise.all(attachments.map(async (attachment) => {
-        const base64EncodedContent = attachment.content instanceof stream_1.Readable
-            ? await streamToBase64(attachment.content)
-            : attachment.content;
-        return { ...attachment, content: base64EncodedContent }; // Replace the stream with its base64 string
+        let base64EncodedContent;
+        if (attachment.content instanceof node_stream_1.Readable) {
+            // ReadableStream -> base64
+            base64EncodedContent = await streamToBase64(attachment.content);
+        }
+        else if (Buffer.isBuffer(attachment.content)) {
+            // Buffer -> base64
+            base64EncodedContent = attachment.content.toString('base64');
+        }
+        else {
+            // string (assumed to already be base64)
+            base64EncodedContent = attachment.content;
+        }
+        return { ...attachment, content: base64EncodedContent };
     }));
 }
-exports.encodeAttachmentStreams = encodeAttachmentStreams;
+/**
+ * @deprecated Use encodeAttachmentContent instead. This alias is provided for backwards compatibility.
+ * Encodes the content of each attachment stream to base64.
+ * @param attachments The attachments to encode.
+ * @returns The attachments with their content encoded to base64.
+ */
+async function encodeAttachmentStreams(attachments) {
+    return encodeAttachmentContent(attachments);
+}
 /**
  * Applies the casing function and ensures numeric parts are preceded by underscores in snake_case.
  * @param casingFunction The original casing function.
@@ -111,7 +166,6 @@ function convertCase(obj, casingFunction, excludeKeys) {
 function objKeysToCamelCase(obj, exclude) {
     return convertCase(obj, change_case_1.camelCase, exclude);
 }
-exports.objKeysToCamelCase = objKeysToCamelCase;
 /**
  * A utility function that recursively converts all keys in an object to snake_case.
  * @param obj The object to convert
@@ -121,7 +175,6 @@ exports.objKeysToCamelCase = objKeysToCamelCase;
 function objKeysToSnakeCase(obj, exclude) {
     return convertCase(obj, change_case_1.snakeCase, exclude);
 }
-exports.objKeysToSnakeCase = objKeysToSnakeCase;
 /**
  * Safely encodes a path template with replacements.
  * @param pathTemplate The path template to encode.
@@ -145,9 +198,29 @@ function safePath(pathTemplate, replacements) {
         }
     });
 }
-exports.safePath = safePath;
 // Helper to create PathParams with type safety and runtime interpolation
 function makePathParams(path, params) {
     return safePath(path, params);
 }
-exports.makePathParams = makePathParams;
+/**
+ * Calculates the total payload size for a message request, including body and attachments.
+ * This is used to determine if multipart/form-data should be used instead of JSON.
+ * @param requestBody The message request body
+ * @returns The total estimated payload size in bytes
+ */
+function calculateTotalPayloadSize(requestBody) {
+    let totalSize = 0;
+    // Calculate size of the message body (JSON payload without attachments)
+    const messagePayloadWithoutAttachments = {
+        ...requestBody,
+        attachments: undefined,
+    };
+    const messagePayloadString = JSON.stringify(objKeysToSnakeCase(messagePayloadWithoutAttachments));
+    totalSize += Buffer.byteLength(messagePayloadString, 'utf8');
+    // Add attachment sizes
+    const attachmentSize = requestBody.attachments?.reduce((total, attachment) => {
+        return total + (attachment.size || 0);
+    }, 0) || 0;
+    totalSize += attachmentSize;
+    return totalSize;
+}

package/lib/cjs/version.js

@@ -2,4 +2,4 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
 // This file is generated by scripts/exportVersion.js
-exports.SDK_VERSION = '7.10.0';
+exports.SDK_VERSION = '7.12.0';

package/lib/esm/apiClient.js

@@ -153,10 +153,6 @@ export default class APIClient {
         }
         if (optionParams.form) {
             requestOptions.body = optionParams.form;
-            requestOptions.headers = {
-                ...requestOptions.headers,
-                ...optionParams.form.getHeaders(),
-            };
         }
         return requestOptions;
     }
@@ -195,6 +191,10 @@ export default class APIClient {
     }
     async requestStream(options) {
         const response = await this.sendRequest(options);
+        // TODO: See if we can fix this in a backwards compatible way
+        if (!response.body) {
+            throw new Error('No response body');
+        }
         return response.body;
     }
 }

package/lib/esm/models/messages.js

@@ -5,4 +5,6 @@ export var MessageFields;
 (function (MessageFields) {
     MessageFields["STANDARD"] = "standard";
     MessageFields["INCLUDE_HEADERS"] = "include_headers";
+    MessageFields["INCLUDE_TRACKING_OPTIONS"] = "include_tracking_options";
+    MessageFields["RAW_MIME"] = "raw_mime";
 })(MessageFields || (MessageFields = {}));

package/lib/esm/resources/auth.js

@@ -1,5 +1,5 @@
 import { v4 as uuid } from 'uuid';
-import { createHash } from 'crypto';
+import { createHash } from 'node:crypto';
 import { Resource } from './resource.js';
 import { makePathParams } from '../utils.js';
 /**

package/lib/esm/resources/drafts.js

@@ -1,6 +1,6 @@
 import { Messages } from './messages.js';
 import { Resource } from './resource.js';
-import { encodeAttachmentStreams } from '../utils.js';
+import { encodeAttachmentContent, calculateTotalPayloadSize, } from '../utils.js';
 import { makePathParams } from '../utils.js';
 /**
  * Nylas Drafts API
@@ -40,11 +40,9 @@ export class Drafts extends Resource {
         const path = makePathParams('/v3/grants/{identifier}/drafts', {
             identifier,
         });
-        // Use form data only if the attachment size is greater than 3mb
-        const attachmentSize = requestBody.attachments?.reduce((total, attachment) => {
-            return total + (attachment.size || 0);
-        }, 0) || 0;
-        if (attachmentSize >= Messages.MAXIMUM_JSON_ATTACHMENT_SIZE) {
+        // Use form data if the total payload size (body + attachments) is greater than 3mb
+        const totalPayloadSize = calculateTotalPayloadSize(requestBody);
+        if (totalPayloadSize >= Messages.MAXIMUM_JSON_ATTACHMENT_SIZE) {
             const form = Messages._buildFormRequest(requestBody);
             return this.apiClient.request({
                 method: 'POST',
@@ -54,7 +52,7 @@ export class Drafts extends Resource {
             });
         }
         else if (requestBody.attachments) {
-            const processedAttachments = await encodeAttachmentStreams(requestBody.attachments);
+            const processedAttachments = await encodeAttachmentContent(requestBody.attachments);
             requestBody = {
                 ...requestBody,
                 attachments: processedAttachments,
@@ -75,11 +73,9 @@ export class Drafts extends Resource {
             identifier,
             draftId,
         });
-        // Use form data only if the attachment size is greater than 3mb
-        const attachmentSize = requestBody.attachments?.reduce((total, attachment) => {
-            return total + (attachment.size || 0);
-        }, 0) || 0;
-        if (attachmentSize >= Messages.MAXIMUM_JSON_ATTACHMENT_SIZE) {
+        // Use form data if the total payload size (body + attachments) is greater than 3mb
+        const totalPayloadSize = calculateTotalPayloadSize(requestBody);
+        if (totalPayloadSize >= Messages.MAXIMUM_JSON_ATTACHMENT_SIZE) {
             const form = Messages._buildFormRequest(requestBody);
             return this.apiClient.request({
                 method: 'PUT',
@@ -89,7 +85,7 @@ export class Drafts extends Resource {
             });
         }
         else if (requestBody.attachments) {
-            const processedAttachments = await encodeAttachmentStreams(requestBody.attachments);
+            const processedAttachments = await encodeAttachmentContent(requestBody.attachments);
             requestBody = {
                 ...requestBody,
                 attachments: processedAttachments,

package/lib/esm/resources/messages.js

@@ -1,4 +1,5 @@
-import { encodeAttachmentStreams, objKeysToSnakeCase, makePathParams, } from '../utils.js';
+import { Blob, FormData } from 'formdata-node';
+import { attachmentStreamToFile, calculateTotalPayloadSize, encodeAttachmentContent, makePathParams, objKeysToSnakeCase, } from '../utils.js';
 import { Resource } from './resource.js';
 import { SmartCompose } from './smartCompose.js';
 /**
@@ -86,16 +87,14 @@ export class Messages extends Resource {
             path,
             overrides,
         };
-        // Use form data only if the attachment size is greater than 3mb
-        const attachmentSize = requestBody.attachments?.reduce((total, attachment) => {
-            return total + (attachment.size || 0);
-        }, 0) || 0;
-        if (attachmentSize >= Messages.MAXIMUM_JSON_ATTACHMENT_SIZE) {
+        // Use form data if the total payload size (body + attachments) is greater than 3mb
+        const totalPayloadSize = calculateTotalPayloadSize(requestBody);
+        if (totalPayloadSize >= Messages.MAXIMUM_JSON_ATTACHMENT_SIZE) {
             requestOptions.form = Messages._buildFormRequest(requestBody);
         }
         else {
             if (requestBody.attachments) {
-                const processedAttachments = await encodeAttachmentStreams(requestBody.attachments);
+                const processedAttachments = await encodeAttachmentContent(requestBody.attachments);
                 requestOptions.body = {
                     ...requestBody,
                     attachments: processedAttachments,
@@ -154,10 +153,7 @@ export class Messages extends Resource {
         });
     }
     static _buildFormRequest(requestBody) {
-        // FormData imports are funky, cjs needs to use .default, es6 doesn't
-        const FD = require('form-data');
-        const FormDataConstructor = FD.default || FD;
-        const form = new FormDataConstructor();
+        const form = new FormData();
         // Split out the message payload from the attachments
         const messagePayload = {
             ...requestBody,
@@ -165,13 +161,30 @@ export class Messages extends Resource {
         };
         form.append('message', JSON.stringify(objKeysToSnakeCase(messagePayload)));
         // Add a separate form field for each attachment
-        requestBody.attachments?.forEach((attachment, index) => {
-            const contentId = attachment.contentId || `file${index}`;
-            form.append(contentId, attachment.content, {
-                filename: attachment.filename,
-                contentType: attachment.contentType,
+        if (requestBody.attachments && requestBody.attachments.length > 0) {
+            requestBody.attachments.map((attachment, index) => {
+                const contentId = attachment.contentId || `file${index}`;
+                // Handle different content types for formdata-node
+                if (typeof attachment.content === 'string') {
+                    // Base64 string - create a Blob
+                    const buffer = Buffer.from(attachment.content, 'base64');
+                    const blob = new Blob([buffer], { type: attachment.contentType });
+                    form.append(contentId, blob, attachment.filename);
+                }
+                else if (Buffer.isBuffer(attachment.content)) {
+                    // Buffer - create a Blob
+                    const blob = new Blob([attachment.content], {
+                        type: attachment.contentType,
+                    });
+                    form.append(contentId, blob, attachment.filename);
+                }
+                else {
+                    // ReadableStream - create a proper file-like object according to formdata-node docs
+                    const file = attachmentStreamToFile(attachment);
+                    form.append(contentId, file, attachment.filename);
+                }
             });
-        });
+        }
         return form;
     }
 }

package/lib/esm/utils.js

@@ -1,8 +1,8 @@
 import { camelCase, snakeCase } from 'change-case';
-import * as fs from 'fs';
-import * as path from 'path';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
 import * as mime from 'mime-types';
-import { Readable } from 'stream';
+import { Readable } from 'node:stream';
 export function createFileRequestBuilder(filePath) {
     const stats = fs.statSync(filePath);
     const filename = path.basename(filePath);
@@ -36,18 +36,67 @@ function streamToBase64(stream) {
     });
 }
 /**
- * Encodes the content of each attachment stream to base64.
+ * Converts a ReadableStream to a File-like object that can be used with FormData.
+ * @param attachment The attachment containing the stream and metadata.
+ * @param mimeType The MIME type for the file (optional).
+ * @returns A File-like object that properly handles the stream.
+ */
+export function attachmentStreamToFile(attachment, mimeType) {
+    if (mimeType != null && typeof mimeType !== 'string') {
+        throw new Error('Invalid mimetype, expected string.');
+    }
+    const content = attachment.content;
+    if (typeof content === 'string' || Buffer.isBuffer(content)) {
+        throw new Error('Invalid attachment content, expected ReadableStream.');
+    }
+    // Create a file-shaped object that FormData can handle properly
+    const fileObject = {
+        type: mimeType || attachment.contentType,
+        name: attachment.filename,
+        [Symbol.toStringTag]: 'File',
+        stream() {
+            return content;
+        },
+    };
+    // Add size if available
+    if (attachment.size !== undefined) {
+        fileObject.size = attachment.size;
+    }
+    return fileObject;
+}
+/**
+ * Encodes the content of each attachment to base64.
+ * Handles ReadableStream, Buffer, and string content types.
  * @param attachments The attachments to encode.
  * @returns The attachments with their content encoded to base64.
  */
-export async function encodeAttachmentStreams(attachments) {
+export async function encodeAttachmentContent(attachments) {
     return await Promise.all(attachments.map(async (attachment) => {
-        const base64EncodedContent = attachment.content instanceof Readable
-            ? await streamToBase64(attachment.content)
-            : attachment.content;
-        return { ...attachment, content: base64EncodedContent }; // Replace the stream with its base64 string
+        let base64EncodedContent;
+        if (attachment.content instanceof Readable) {
+            // ReadableStream -> base64
+            base64EncodedContent = await streamToBase64(attachment.content);
+        }
+        else if (Buffer.isBuffer(attachment.content)) {
+            // Buffer -> base64
+            base64EncodedContent = attachment.content.toString('base64');
+        }
+        else {
+            // string (assumed to already be base64)
+            base64EncodedContent = attachment.content;
+        }
+        return { ...attachment, content: base64EncodedContent };
     }));
 }
+/**
+ * @deprecated Use encodeAttachmentContent instead. This alias is provided for backwards compatibility.
+ * Encodes the content of each attachment stream to base64.
+ * @param attachments The attachments to encode.
+ * @returns The attachments with their content encoded to base64.
+ */
+export async function encodeAttachmentStreams(attachments) {
+    return encodeAttachmentContent(attachments);
+}
 /**
  * Applies the casing function and ensures numeric parts are preceded by underscores in snake_case.
  * @param casingFunction The original casing function.
@@ -142,3 +191,25 @@ export function safePath(pathTemplate, replacements) {
 export function makePathParams(path, params) {
     return safePath(path, params);
 }
+/**
+ * Calculates the total payload size for a message request, including body and attachments.
+ * This is used to determine if multipart/form-data should be used instead of JSON.
+ * @param requestBody The message request body
+ * @returns The total estimated payload size in bytes
+ */
+export function calculateTotalPayloadSize(requestBody) {
+    let totalSize = 0;
+    // Calculate size of the message body (JSON payload without attachments)
+    const messagePayloadWithoutAttachments = {
+        ...requestBody,
+        attachments: undefined,
+    };
+    const messagePayloadString = JSON.stringify(objKeysToSnakeCase(messagePayloadWithoutAttachments));
+    totalSize += Buffer.byteLength(messagePayloadString, 'utf8');
+    // Add attachment sizes
+    const attachmentSize = requestBody.attachments?.reduce((total, attachment) => {
+        return total + (attachment.size || 0);
+    }, 0) || 0;
+    totalSize += attachmentSize;
+    return totalSize;
+}

package/lib/esm/version.js

@@ -1,2 +1,2 @@
 // This file is generated by scripts/exportVersion.js
-export const SDK_VERSION = '7.10.0';
+export const SDK_VERSION = '7.12.0';

package/lib/types/apiClient.d.ts

@@ -1,8 +1,6 @@
-/// <reference types="node" />
-/// <reference types="node" />
 import { Request, Response } from 'node-fetch';
 import { NylasConfig, OverridableNylasConfig } from './config.js';
-import FormData from 'form-data';
+import { FormData } from 'formdata-node';
 /**
  * The header key for the debugging flow ID
  */

package/lib/types/models/attachments.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 /**
  * Interface of an attachment object from Nylas.
  */

package/lib/types/models/folders.d.ts

@@ -84,5 +84,15 @@ export interface ListFolderQueryParams extends ListQueryParams {
      * (Microsoft and EWS only.) Use the ID of a folder to find all child folders it contains.
      */
     parentId?: string;
+    /**
+     * (Microsoft only) When true, Nylas includes hidden folders in its response.
+     */
+    includeHiddenFolders?: boolean;
+    /**
+     * (Microsoft only) If true, retrieves folders from a single-level hierarchy only.
+     * If false, retrieves folders across a multi-level hierarchy.
+     * @default false
+     */
+    singleLevel?: boolean;
 }
 export type UpdateFolderRequest = Partial<CreateFolderRequest>;

package/lib/types/models/messages.d.ts

@@ -74,6 +74,28 @@ export interface BaseMessage {
      */
     unread?: boolean;
 }
+/**
+ * Interface representing message tracking options.
+ */
+export interface MessageTrackingOptions {
+    /**
+     * When true, shows that message open tracking is enabled.
+     */
+    opens: boolean;
+    /**
+     * When true, shows that thread replied tracking is enabled.
+     */
+    threadReplies: boolean;
+    /**
+     * When true, shows that link clicked tracking is enabled.
+     */
+    links: boolean;
+    /**
+     * A label describing the message tracking purpose.
+     * Maximum length: 2048 characters.
+     */
+    label: string;
+}
 /**
  * Interface representing a Nylas Message object.
  */
@@ -87,6 +109,17 @@ export interface Message extends BaseMessage {
      * Only present if the 'fields' query parameter is set to includeHeaders.
      */
     headers?: MessageHeaders[];
+    /**
+     * The message tracking options.
+     * Only present if the 'fields' query parameter is set to include_tracking_options.
+     */
+    trackingOptions?: MessageTrackingOptions;
+    /**
+     * A Base64url-encoded string containing the message data (including the body content).
+     * Only present if the 'fields' query parameter is set to raw_mime.
+     * When this field is requested, only grant_id, object, id, and raw_mime fields are returned.
+     */
+    rawMime?: string;
     /**
      * A list of key-value pairs storing additional data.
      */
@@ -144,7 +177,9 @@ export interface MessageHeaders {
  */
 export declare enum MessageFields {
     STANDARD = "standard",
-    INCLUDE_HEADERS = "include_headers"
+    INCLUDE_HEADERS = "include_headers",
+    INCLUDE_TRACKING_OPTIONS = "include_tracking_options",
+    RAW_MIME = "raw_mime"
 }
 /**
  * Interface representing information about a scheduled message.

package/lib/types/resources/attachments.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 import { Overrides } from '../config.js';
 import { Attachment, FindAttachmentQueryParams, DownloadAttachmentQueryParams } from '../models/attachments.js';
 import { NylasResponse } from '../models/response.js';

package/lib/types/resources/messages.d.ts

@@ -1,4 +1,4 @@
-import FormData from 'form-data';
+import { FormData } from 'formdata-node';
 import APIClient from '../apiClient.js';
 import { Overrides } from '../config.js';
 import { CreateDraftRequest, SendMessageRequest, UpdateDraftRequest } from '../models/drafts.js';

package/lib/types/resources/resource.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 import APIClient from '../apiClient.js';
 import { OverridableNylasConfig } from '../config.js';
 import { ListQueryParams } from '../models/listQueryParams.js';

package/lib/types/utils.d.ts

@@ -1,6 +1,21 @@
 import { CreateAttachmentRequest } from './models/attachments.js';
 export declare function createFileRequestBuilder(filePath: string): CreateAttachmentRequest;
 /**
+ * Converts a ReadableStream to a File-like object that can be used with FormData.
+ * @param attachment The attachment containing the stream and metadata.
+ * @param mimeType The MIME type for the file (optional).
+ * @returns A File-like object that properly handles the stream.
+ */
+export declare function attachmentStreamToFile(attachment: CreateAttachmentRequest, mimeType?: string): any;
+/**
+ * Encodes the content of each attachment to base64.
+ * Handles ReadableStream, Buffer, and string content types.
+ * @param attachments The attachments to encode.
+ * @returns The attachments with their content encoded to base64.
+ */
+export declare function encodeAttachmentContent(attachments: CreateAttachmentRequest[]): Promise<CreateAttachmentRequest[]>;
+/**
+ * @deprecated Use encodeAttachmentContent instead. This alias is provided for backwards compatibility.
  * Encodes the content of each attachment stream to base64.
  * @param attachments The attachments to encode.
  * @returns The attachments with their content encoded to base64.
@@ -43,3 +58,10 @@ export interface PathParams<Path extends string> {
     toPath(): string;
 }
 export declare function makePathParams<Path extends string>(path: Path, params: Record<ExtractPathParams<Path>, string>): string;
+/**
+ * Calculates the total payload size for a message request, including body and attachments.
+ * This is used to determine if multipart/form-data should be used instead of JSON.
+ * @param requestBody The message request body
+ * @returns The total estimated payload size in bytes
+ */
+export declare function calculateTotalPayloadSize(requestBody: any): number;

package/lib/types/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "7.10.0";
+export declare const SDK_VERSION = "7.12.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nylas",
-  "version": "7.10.0",
+  "version": "7.12.0",
   "description": "A NodeJS wrapper for the Nylas REST API for email, contacts, and calendar.",
   "main": "lib/cjs/nylas.js",
   "types": "lib/types/nylas.d.ts",
@@ -40,9 +40,10 @@
   "license": "MIT",
   "dependencies": {
     "change-case": "^4.1.2",
-    "form-data": "^4.0.0",
+    "form-data-encoder": "^4.1.0",
+    "formdata-node": "^6.0.3",
     "mime-types": "^2.1.35",
-    "node-fetch": "^2.6.12",
+    "node-fetch": "^3.3.2",
     "uuid": "^8.3.2"
   },
   "devDependencies": {
@@ -50,7 +51,6 @@
     "@types/jest": "^29.5.2",
     "@types/mime-types": "^2.1.2",
     "@types/node": "^22.15.21",
-    "@types/node-fetch": "^2.6.4",
     "@types/uuid": "^8.3.4",
     "@typescript-eslint/eslint-plugin": "^2.25.0",
     "@typescript-eslint/parser": "^2.25.0",
@@ -60,6 +60,7 @@
     "eslint-plugin-import": "^2.28.1",
     "eslint-plugin-prettier": "^3.0.1",
     "jest": "^29.6.1",
+    "jest-fetch-mock": "^3.0.3",
     "prettier": "^3.5.3",
     "ts-jest": "^29.1.1",
     "typedoc": "^0.28.4",