nylas 7.12.0 → 7.13.1

package/cjs-wrapper.d.ts

@@ -0,0 +1,14 @@
+/**
+ * TypeScript definitions for the CommonJS wrapper
+ * This provides proper typing for CommonJS imports
+ */
+
+// Re-export all types from the main module
+export * from './lib/types/models/index.js';
+
+// Import the main Nylas class type
+import Nylas from './lib/types/nylas.js';
+
+// Export as both default and named for maximum compatibility
+declare const nylasExport: typeof Nylas;
+export = nylasExport;

package/cjs-wrapper.js

@@ -0,0 +1,13 @@
+/**
+ * CommonJS wrapper for the Nylas SDK
+ * This file provides CommonJS compatibility by re-exporting the default export
+ * as the main module export while preserving named exports
+ */
+
+const nylasModule = require('./lib/cjs/nylas.js');
+
+// Export the default export as the main module export for CJS compatibility
+module.exports = nylasModule.default;
+
+// Preserve all named exports
+Object.assign(module.exports, nylasModule);

package/lib/cjs/apiClient.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.REQUEST_ID_HEADER = exports.FLOW_ID_HEADER = void 0;
-const node_fetch_1 = require("node-fetch");
 const error_js_1 = require("./models/error.js");
 const utils_js_1 = require("./utils.js");
 const version_js_1 = require("./version.js");
 const change_case_1 = require("change-case");
+const fetchWrapper_js_1 = require("./utils/fetchWrapper.js");
 /**
  * The header key for the debugging flow ID
  */
@@ -73,7 +73,7 @@ class APIClient {
         };
     }
     async sendRequest(options) {
-        const req = this.newRequest(options);
+        const req = await this.newRequest(options);
         const controller = new AbortController();
         // Handle timeout
         let timeoutDuration;
@@ -94,7 +94,8 @@ class APIClient {
             controller.abort();
         }, timeoutDuration);
         try {
-            const response = await (0, node_fetch_1.default)(req, {
+            const fetch = await (0, fetchWrapper_js_1.getFetch)();
+            const response = await fetch(req, {
                 signal: controller.signal,
             });
             clearTimeout(timeout);
@@ -159,9 +160,10 @@ class APIClient {
         }
         return requestOptions;
     }
-    newRequest(options) {
+    async newRequest(options) {
         const newOptions = this.requestOptions(options);
-        return new node_fetch_1.Request(newOptions.url, {
+        const RequestConstructor = await (0, fetchWrapper_js_1.getRequest)();
+        return new RequestConstructor(newOptions.url, {
             method: newOptions.method,
             headers: newOptions.headers,
             body: newOptions.body,
@@ -174,11 +176,19 @@ class APIClient {
         const flowId = headers[exports.FLOW_ID_HEADER];
         const text = await response.text();
         try {
-            const responseJSON = JSON.parse(text);
-            // Inject the flow ID and headers into the response
-            responseJSON.flowId = flowId;
-            responseJSON.headers = headers;
-            return (0, utils_js_1.objKeysToCamelCase)(responseJSON, ['metadata']);
+            const parsed = JSON.parse(text);
+            const payload = (0, utils_js_1.objKeysToCamelCase)({
+                ...parsed,
+                flowId,
+                // deprecated: headers will be removed in a future release. This is for backwards compatibility.
+                headers,
+            }, ['metadata']);
+            // Attach rawHeaders as a non-enumerable property to avoid breaking deep equality
+            Object.defineProperty(payload, 'rawHeaders', {
+                value: headers,
+                enumerable: false,
+            });
+            return payload;
         }
         catch (e) {
             throw new Error(`Could not parse response from the server: ${text}`);

package/lib/cjs/nylas.js

@@ -13,9 +13,12 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
 var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./models/index.js"), exports);
-const apiClient_js_1 = require("./apiClient.js");
+const apiClient_js_1 = __importDefault(require("./apiClient.js"));
 const config_js_1 = require("./config.js");
 const calendars_js_1 = require("./resources/calendars.js");
 const events_js_1 = require("./resources/events.js");

package/lib/cjs/utils/fetchWrapper-cjs.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * Fetch wrapper for CJS builds - uses dynamic imports for node-fetch compatibility
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFetch = getFetch;
+exports.getRequest = getRequest;
+exports.getResponse = getResponse;
+// Cache for the dynamically imported module
+let nodeFetchModule = null;
+/**
+ * Get fetch function - uses dynamic import for CJS
+ */
+async function getFetch() {
+    // In test environment, use global fetch (mocked by jest-fetch-mock)
+    if (typeof global !== 'undefined' && global.fetch) {
+        return global.fetch;
+    }
+    if (!nodeFetchModule) {
+        // Use Function constructor to prevent TypeScript from converting to require()
+        const dynamicImport = new Function('specifier', 'return import(specifier)');
+        nodeFetchModule = (await dynamicImport('node-fetch'));
+    }
+    return nodeFetchModule.default;
+}
+/**
+ * Get Request constructor - uses dynamic import for CJS
+ */
+async function getRequest() {
+    // In test environment, use global Request or a mock
+    if (typeof global !== 'undefined' && global.Request) {
+        return global.Request;
+    }
+    if (!nodeFetchModule) {
+        // Use Function constructor to prevent TypeScript from converting to require()
+        const dynamicImport = new Function('specifier', 'return import(specifier)');
+        nodeFetchModule = (await dynamicImport('node-fetch'));
+    }
+    return nodeFetchModule.Request;
+}
+/**
+ * Get Response constructor - uses dynamic import for CJS
+ */
+async function getResponse() {
+    // In test environment, use global Response or a mock
+    if (typeof global !== 'undefined' && global.Response) {
+        return global.Response;
+    }
+    if (!nodeFetchModule) {
+        // Use Function constructor to prevent TypeScript from converting to require()
+        const dynamicImport = new Function('specifier', 'return import(specifier)');
+        nodeFetchModule = (await dynamicImport('node-fetch'));
+    }
+    return nodeFetchModule.Response;
+}

package/lib/cjs/utils/fetchWrapper.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * Fetch wrapper for CJS builds - uses dynamic imports for node-fetch compatibility
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFetch = getFetch;
+exports.getRequest = getRequest;
+exports.getResponse = getResponse;
+// Cache for the dynamically imported module
+let nodeFetchModule = null;
+/**
+ * Get fetch function - uses dynamic import for CJS
+ */
+async function getFetch() {
+    // In test environment, use global fetch (mocked by jest-fetch-mock)
+    if (typeof global !== 'undefined' && global.fetch) {
+        return global.fetch;
+    }
+    if (!nodeFetchModule) {
+        // Use Function constructor to prevent TypeScript from converting to require()
+        const dynamicImport = new Function('specifier', 'return import(specifier)');
+        nodeFetchModule = (await dynamicImport('node-fetch'));
+    }
+    return nodeFetchModule.default;
+}
+/**
+ * Get Request constructor - uses dynamic import for CJS
+ */
+async function getRequest() {
+    // In test environment, use global Request or a mock
+    if (typeof global !== 'undefined' && global.Request) {
+        return global.Request;
+    }
+    if (!nodeFetchModule) {
+        // Use Function constructor to prevent TypeScript from converting to require()
+        const dynamicImport = new Function('specifier', 'return import(specifier)');
+        nodeFetchModule = (await dynamicImport('node-fetch'));
+    }
+    return nodeFetchModule.Request;
+}
+/**
+ * Get Response constructor - uses dynamic import for CJS
+ */
+async function getResponse() {
+    // In test environment, use global Response or a mock
+    if (typeof global !== 'undefined' && global.Response) {
+        return global.Response;
+    }
+    if (!nodeFetchModule) {
+        // Use Function constructor to prevent TypeScript from converting to require()
+        const dynamicImport = new Function('specifier', 'return import(specifier)');
+        nodeFetchModule = (await dynamicImport('node-fetch'));
+    }
+    return nodeFetchModule.Response;
+}

package/lib/cjs/utils.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createFileRequestBuilder = createFileRequestBuilder;
 exports.attachmentStreamToFile = attachmentStreamToFile;
@@ -10,9 +43,9 @@ exports.safePath = safePath;
 exports.makePathParams = makePathParams;
 exports.calculateTotalPayloadSize = calculateTotalPayloadSize;
 const change_case_1 = require("change-case");
-const fs = require("node:fs");
-const path = require("node:path");
-const mime = require("mime-types");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const mime = __importStar(require("mime-types"));
 const node_stream_1 = require("node:stream");
 function createFileRequestBuilder(filePath) {
     const stats = fs.statSync(filePath);

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.12.0';
+exports.SDK_VERSION = '7.13.1';

package/lib/esm/apiClient.js

@@ -1,8 +1,8 @@
-import fetch, { Request } from 'node-fetch';
 import { NylasApiError, NylasOAuthError, NylasSdkTimeoutError, } from './models/error.js';
 import { objKeysToCamelCase, objKeysToSnakeCase } from './utils.js';
 import { SDK_VERSION } from './version.js';
 import { snakeCase } from 'change-case';
+import { getFetch, getRequest } from './utils/fetchWrapper.js';
 /**
  * The header key for the debugging flow ID
  */
@@ -70,7 +70,7 @@ export default class APIClient {
         };
     }
     async sendRequest(options) {
-        const req = this.newRequest(options);
+        const req = await this.newRequest(options);
         const controller = new AbortController();
         // Handle timeout
         let timeoutDuration;
@@ -91,6 +91,7 @@ export default class APIClient {
             controller.abort();
         }, timeoutDuration);
         try {
+            const fetch = await getFetch();
             const response = await fetch(req, {
                 signal: controller.signal,
             });
@@ -156,9 +157,10 @@ export default class APIClient {
         }
         return requestOptions;
     }
-    newRequest(options) {
+    async newRequest(options) {
         const newOptions = this.requestOptions(options);
-        return new Request(newOptions.url, {
+        const RequestConstructor = await getRequest();
+        return new RequestConstructor(newOptions.url, {
             method: newOptions.method,
             headers: newOptions.headers,
             body: newOptions.body,
@@ -171,11 +173,19 @@ export default class APIClient {
         const flowId = headers[FLOW_ID_HEADER];
         const text = await response.text();
         try {
-            const responseJSON = JSON.parse(text);
-            // Inject the flow ID and headers into the response
-            responseJSON.flowId = flowId;
-            responseJSON.headers = headers;
-            return objKeysToCamelCase(responseJSON, ['metadata']);
+            const parsed = JSON.parse(text);
+            const payload = objKeysToCamelCase({
+                ...parsed,
+                flowId,
+                // deprecated: headers will be removed in a future release. This is for backwards compatibility.
+                headers,
+            }, ['metadata']);
+            // Attach rawHeaders as a non-enumerable property to avoid breaking deep equality
+            Object.defineProperty(payload, 'rawHeaders', {
+                value: headers,
+                enumerable: false,
+            });
+            return payload;
         }
         catch (e) {
             throw new Error(`Could not parse response from the server: ${text}`);

package/lib/esm/nylas.js

@@ -22,7 +22,7 @@ import { Notetakers } from './resources/notetakers.js';
  * A Nylas instance holds a configured http client pointing to a base URL and is intended to be reused and shared
  * across threads and time.
  */
-export default class Nylas {
+class Nylas {
     /**
      * @param config Configuration options for the Nylas SDK
      */
@@ -51,3 +51,4 @@ export default class Nylas {
         return this;
     }
 }
+export default Nylas;

package/lib/esm/utils/fetchWrapper-esm.js

@@ -0,0 +1,22 @@
+/**
+ * Fetch wrapper for ESM builds - uses static imports for optimal performance
+ */
+import fetch, { Request, Response } from 'node-fetch';
+/**
+ * Get fetch function - uses static import for ESM
+ */
+export async function getFetch() {
+    return fetch;
+}
+/**
+ * Get Request constructor - uses static import for ESM
+ */
+export async function getRequest() {
+    return Request;
+}
+/**
+ * Get Response constructor - uses static import for ESM
+ */
+export async function getResponse() {
+    return Response;
+}

package/lib/esm/utils/fetchWrapper.js

@@ -0,0 +1,22 @@
+/**
+ * Fetch wrapper for ESM builds - uses static imports for optimal performance
+ */
+import fetch, { Request, Response } from 'node-fetch';
+/**
+ * Get fetch function - uses static import for ESM
+ */
+export async function getFetch() {
+    return fetch;
+}
+/**
+ * Get Request constructor - uses static import for ESM
+ */
+export async function getRequest() {
+    return Request;
+}
+/**
+ * Get Response constructor - uses static import for ESM
+ */
+export async function getResponse() {
+    return Response;
+}

package/lib/esm/version.js

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

package/lib/types/apiClient.d.ts

@@ -1,6 +1,6 @@
-import { Request, Response } from 'node-fetch';
 import { NylasConfig, OverridableNylasConfig } from './config.js';
 import { FormData } from 'formdata-node';
+import type { Request, Response } from './utils/fetchWrapper.js';
 /**
  * The header key for the debugging flow ID
  */
@@ -73,7 +73,7 @@ export default class APIClient {
     private setRequestHeaders;
     private sendRequest;
     requestOptions(optionParams: RequestOptionsParams): RequestOptions;
-    newRequest(options: RequestOptionsParams): Request;
+    newRequest(options: RequestOptionsParams): Promise<Request>;
     requestWithResponse<T>(response: Response): Promise<T>;
     request<T>(options: RequestOptionsParams): Promise<T>;
     requestRaw(options: RequestOptionsParams): Promise<Buffer>;

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

@@ -69,6 +69,11 @@ export interface CreateDraftRequest {
      * An array of custom headers to add to the message.
      */
     customHeaders?: CustomHeader[];
+    /**
+     * When true, the message body is sent as plain text and the MIME data doesn't include the HTML version of the message.
+     * When false, the message body is sent as HTML. Defaults to false.
+     */
+    isPlaintext?: boolean;
 }
 /**
  * Interface representing a request to send a message.
@@ -96,7 +101,7 @@ export interface Draft extends BaseMessage, Omit<CreateDraftRequest, 'attachment
 /**
  * Interface representing a request to update a draft.
  */
-export type UpdateDraftRequest = Partial<CreateDraftRequest> & {
+export type UpdateDraftRequest = Omit<Partial<CreateDraftRequest>, 'isPlaintext'> & {
     /**
      * Return drafts that are unread.
      */

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

@@ -3,6 +3,20 @@
  */
 export interface NylasBaseResponse {
     requestId: string;
+    /**
+     * The flow ID
+     * Provide this to Nylas support to help trace requests and responses
+     */
+    flowId?: string;
+    /**
+     * The response headers with camelCased keys (backwards compatible)
+     * @deprecated Use rawHeaders instead
+     */
+    headers?: Record<string, string>;
+    /**
+     * The raw response headers with original dashed lowercase keys
+     */
+    rawHeaders?: Record<string, string>;
 }
 /**
  * Interface representation of a Nylas response object
@@ -23,8 +37,13 @@ export interface NylasResponse<T> {
     flowId?: string;
     /**
      * The response headers
+     * @deprecated Use rawHeaders instead
      */
     headers?: Record<string, string>;
+    /**
+     * The raw response headers with original dashed lowercase keys
+     */
+    rawHeaders?: Record<string, string>;
 }
 /**
  * Interface representation of a Nylas response object that contains a list of objects.
@@ -42,6 +61,20 @@ export interface NylasListResponse<T> {
      * The cursor to use to get the next page of data.
      */
     nextCursor?: string;
+    /**
+     * The flow ID
+     * Provide this to Nylas support to help trace requests and responses
+     */
+    flowId?: string;
+    /**
+     * The response headers with camelCased keys (backwards compatible)
+     * @deprecated Use rawHeaders instead
+     */
+    headers?: Record<string, string>;
+    /**
+     * The raw response headers with original dashed lowercase keys
+     */
+    rawHeaders?: Record<string, string>;
 }
 /**
  * Helper type for pagination

package/lib/types/nylas.d.ts

@@ -22,7 +22,7 @@ import { Notetakers } from './resources/notetakers.js';
  * A Nylas instance holds a configured http client pointing to a base URL and is intended to be reused and shared
  * across threads and time.
  */
-export default class Nylas {
+declare class Nylas {
     /**
      * Access the Applications API
      */
@@ -93,3 +93,4 @@ export default class Nylas {
      */
     constructor(config: NylasConfig);
 }
+export default Nylas;

package/lib/types/utils/fetchWrapper-cjs.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Fetch wrapper for CJS builds - uses dynamic imports for node-fetch compatibility
+ */
+/**
+ * Get fetch function - uses dynamic import for CJS
+ */
+export declare function getFetch(): Promise<any>;
+/**
+ * Get Request constructor - uses dynamic import for CJS
+ */
+export declare function getRequest(): Promise<any>;
+/**
+ * Get Response constructor - uses dynamic import for CJS
+ */
+export declare function getResponse(): Promise<any>;
+export type RequestInit = any;
+export type HeadersInit = any;
+export type Request = any;
+export type Response = any;

package/lib/types/utils/fetchWrapper-esm.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Fetch wrapper for ESM builds - uses static imports for optimal performance
+ */
+import fetch, { Request, Response } from 'node-fetch';
+import type { RequestInit, HeadersInit } from 'node-fetch';
+/**
+ * Get fetch function - uses static import for ESM
+ */
+export declare function getFetch(): Promise<typeof fetch>;
+/**
+ * Get Request constructor - uses static import for ESM
+ */
+export declare function getRequest(): Promise<typeof Request>;
+/**
+ * Get Response constructor - uses static import for ESM
+ */
+export declare function getResponse(): Promise<typeof Response>;
+export type { RequestInit, HeadersInit, Request, Response };

package/lib/types/utils/fetchWrapper.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Fetch wrapper for CJS builds - uses dynamic imports for node-fetch compatibility
+ */
+/**
+ * Get fetch function - uses dynamic import for CJS
+ */
+export declare function getFetch(): Promise<any>;
+/**
+ * Get Request constructor - uses dynamic import for CJS
+ */
+export declare function getRequest(): Promise<any>;
+/**
+ * Get Response constructor - uses dynamic import for CJS
+ */
+export declare function getResponse(): Promise<any>;
+export type RequestInit = any;
+export type HeadersInit = any;
+export type Request = any;
+export type Response = any;

package/lib/types/version.d.ts

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

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "nylas",
-  "version": "7.12.0",
+  "version": "7.13.1",
   "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",
   "module": "lib/esm/nylas.js",
   "files": [
-    "lib"
+    "lib",
+    "cjs-wrapper.js",
+    "cjs-wrapper.d.ts"
   ],
   "engines": {
     "node": ">=16"
@@ -24,8 +26,8 @@
     "generate-model-index": "node scripts/generateModelIndex.js",
     "prebuild": "npm run export-version && npm run generate-model-index",
     "build": "rm -rf lib && npm run build-esm && npm run build-cjs && npm run generate-lib-package-json",
-    "build-esm": "tsc -p tsconfig.esm.json",
-    "build-cjs": "tsc -p tsconfig.cjs.json",
+    "build-esm": "node scripts/setupFetchWrapper.js esm && tsc -p tsconfig.esm.json",
+    "build-cjs": "node scripts/setupFetchWrapper.js cjs && tsc -p tsconfig.cjs.json",
     "prepare": "npm run build",
     "build:docs": "typedoc --out docs",
     "version": "npm run export-version && git add src/version.ts"
@@ -72,8 +74,13 @@
     "url": "https://github.com/nylas/nylas-nodejs.git"
   },
   "exports": {
-    "import": "./lib/esm/nylas.js",
-    "require": "./lib/cjs/nylas.js",
-    "types": "./lib/types/nylas.d.ts"
+    "import": {
+      "types": "./lib/types/nylas.d.ts",
+      "default": "./lib/esm/nylas.js"
+    },
+    "require": {
+      "types": "./cjs-wrapper.d.ts",
+      "default": "./cjs-wrapper.js"
+    }
   }
 }