nylas 7.10.0 → 7.11.0

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/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',
@@ -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',

package/lib/cjs/resources/messages.js

@@ -89,11 +89,9 @@ 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 {

package/lib/cjs/utils.js

@@ -1,6 +1,12 @@
 "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.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");
@@ -18,7 +24,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.
@@ -52,7 +57,6 @@ async function encodeAttachmentStreams(attachments) {
         return { ...attachment, content: base64EncodedContent }; // Replace the stream with its base64 string
     }));
 }
-exports.encodeAttachmentStreams = encodeAttachmentStreams;
 /**
  * Applies the casing function and ensures numeric parts are preceded by underscores in snake_case.
  * @param casingFunction The original casing function.
@@ -111,7 +115,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 +124,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 +147,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.11.0';

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/drafts.js

@@ -1,6 +1,6 @@
 import { Messages } from './messages.js';
 import { Resource } from './resource.js';
-import { encodeAttachmentStreams } from '../utils.js';
+import { encodeAttachmentStreams, 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',
@@ -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',

package/lib/esm/resources/messages.js

@@ -1,4 +1,4 @@
-import { encodeAttachmentStreams, objKeysToSnakeCase, makePathParams, } from '../utils.js';
+import { encodeAttachmentStreams, objKeysToSnakeCase, makePathParams, calculateTotalPayloadSize, } from '../utils.js';
 import { Resource } from './resource.js';
 import { SmartCompose } from './smartCompose.js';
 /**
@@ -86,11 +86,9 @@ 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 {

package/lib/esm/utils.js

@@ -142,3 +142,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.11.0';

package/lib/types/apiClient.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 import { Request, Response } from 'node-fetch';
 import { NylasConfig, OverridableNylasConfig } from './config.js';
 import FormData from 'form-data';

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/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

@@ -43,3 +43,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.11.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nylas",
-  "version": "7.10.0",
+  "version": "7.11.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",