Add tentativeAsBusy parameter to FreeBusy requests

- Add tentativeAsBusy optional boolean parameter to GetFreeBusyRequest interface
- When true (default), Nylas treats tentative events as busy
- When false, tentative events are treated as free
- Add comprehensive test coverage for all tentativeAsBusy scenarios
- Update changelog with new feature - Follows SDK camelCase naming convention

Author: AaronDDM

CHANGELOG.md

@@ -4,6 +4,7 @@
 * Fix event status type to use 'maybe' instead of 'tentative' in Event interface to match API documentation
 * Add support for 'zoom' as a provider type in Auth module
 * Fix Add missing `/cancel` suffix in Notetaker API endpoint
+* Add support for `tentativeAsBusy` parameter in FreeBusy requests to control how tentative events are treated
 
 ### 7.9.0 / 2025-04-30
 * Add support for Notetaker API endpoints

scripts/generateModelIndex.js

@@ -5,7 +5,7 @@ const comment = '// This file is generated by scripts/generateModelIndex.js\n';
 const modelsDir = path.join(__dirname, '..', 'src', 'models');
 let indexContent = '';
 
-fs.readdirSync(modelsDir).forEach(file => {
+fs.readdirSync(modelsDir).forEach((file) => {
   if (file.endsWith('.ts') && file !== 'index.ts') {
     const modelName = file.replace('.ts', '.js');
     indexContent += `export * from './${modelName}';\n`;

src/models/connectors.ts

@@ -104,7 +104,8 @@ export type ImapCreateConnectorRequest = BaseCreateConnectionRequest;
 /**
  * Interface representing the base Nylas connector creation request.
  */
-export type VirtualCalendarsCreateConnectorRequest = BaseCreateConnectionRequest;
+export type VirtualCalendarsCreateConnectorRequest =
+  BaseCreateConnectionRequest;
 
 /**
  * The type of the Nylas connector creation request.

src/models/error.ts

@@ -29,8 +29,10 @@ export abstract class AbstractNylasSdkError extends Error {}
 /**
  * Class representation of a general Nylas API error.
  */
-export class NylasApiError extends AbstractNylasApiError
-  implements NylasApiErrorResponseData {
+export class NylasApiError
+  extends AbstractNylasApiError
+  implements NylasApiErrorResponseData
+{
   /**
    * Error type.
    */
@@ -60,8 +62,10 @@ export class NylasApiError extends AbstractNylasApiError
 /**
  * Class representing an OAuth error returned by the Nylas API.
  */
-export class NylasOAuthError extends AbstractNylasApiError
-  implements NylasOAuthErrorResponse {
+export class NylasOAuthError
+  extends AbstractNylasApiError
+  implements NylasOAuthErrorResponse
+{
   /**
    * Error type.
    */

src/models/freeBusy.ts

@@ -32,6 +32,11 @@ export interface GetFreeBusyRequest {
    * A list of email addresses to check the free/busy schedules for.
    */
   emails: string[];
+  /**
+   * When true, Nylas treats tentative events as busy.
+   * @default true
+   */
+  tentativeAsBusy?: boolean;
 }
 
 /**

src/models/response.ts

@@ -49,6 +49,5 @@ export interface NylasListResponse<T> {
 /**
  * Helper type for pagination
  */
-export type ListResponseInnerType<T> = T extends NylasListResponse<infer R>
-  ? R
-  : never;
+export type ListResponseInnerType<T> =
+  T extends NylasListResponse<infer R> ? R : never;

src/resources/auth.ts

@@ -219,13 +219,9 @@ export class Auth extends Resource {
   }
 
   private hashPKCESecret(secret: string): string {
-    const hash = createHash('sha256')
-      .update(secret)
-      .digest('hex');
+    const hash = createHash('sha256').update(secret).digest('hex');
 
-    return Buffer.from(hash)
-      .toString('base64')
-      .replace(/=+$/, '');
+    return Buffer.from(hash).toString('base64').replace(/=+$/, '');
   }
 
   private getTokenInfo(

src/resources/notetakers.ts

@@ -91,9 +91,8 @@ export class Notetakers extends Resource {
     identifier,
     queryParams,
     overrides,
-  }: ListNotetakersParams & Overrides): AsyncListResponse<
-    ListNotetakersResponse
-  > {
+  }: ListNotetakersParams &
+    Overrides): AsyncListResponse<ListNotetakersResponse> {
     return super._list({
       path: identifier
         ? `/v3/grants/${identifier}/notetakers`

src/resources/resource.ts

@@ -126,11 +126,11 @@ export class Resource {
   ): AsyncListResponse<T> {
     const iterator = this.listIterator(listParams);
     const first = iterator.next().then(
-      res =>
+      (res) =>
         ({
           ...res.value,
           next: iterator.next.bind(iterator),
-        } as ListYieldReturn<T>)
+        }) as ListYieldReturn<T>
     );
 
     return Object.assign(first, {

src/utils.ts

@@ -36,7 +36,7 @@ function streamToBase64(stream: NodeJS.ReadableStream): Promise<string> {
       const base64 = Buffer.concat(chunks).toString('base64');
       resolve(base64);
     });
-    stream.on('error', err => {
+    stream.on('error', (err) => {
       reject(err);
     });
   });
@@ -51,7 +51,7 @@ export async function encodeAttachmentStreams(
   attachments: CreateAttachmentRequest[]
 ): Promise<CreateAttachmentRequest[]> {
   return await Promise.all(
-    attachments.map(async attachment => {
+    attachments.map(async (attachment) => {
       const base64EncodedContent =
         attachment.content instanceof Readable
           ? await streamToBase64(attachment.content)
@@ -102,7 +102,7 @@ function convertCase(
       newObj[key] = obj[key];
     } else if (Array.isArray(obj[key])) {
       newObj[applyCasing(casingFunction, key)] = (obj[key] as any[]).map(
-        item => {
+        (item) => {
           if (typeof item === 'object') {
             return convertCase(item, casingFunction);
           } else {
@@ -157,8 +157,8 @@ export type Subset<K> = {
   [attr in keyof K]?: K[attr] extends object
     ? Subset<K[attr]>
     : K[attr] extends object | null
-    ? Subset<K[attr]> | null
-    : K[attr] extends object | null | undefined
-    ? Subset<K[attr]> | null | undefined
-    : K[attr];
+      ? Subset<K[attr]> | null
+      : K[attr] extends object | null | undefined
+        ? Subset<K[attr]> | null | undefined
+        : K[attr];
 };