feat(scheduler): add GET /v3/scheduling/availability endpoint support

src/models/scheduler.ts

@@ -459,3 +459,26 @@ export interface FindBookingQueryParams {
 export type ConfirmBookingQueryParams = FindBookingQueryParams;
 export type RescheduleBookingQueryParams = FindBookingQueryParams;
 export type DestroyBookingQueryParams = FindBookingQueryParams;
+
+export interface AvailabilityTimeSlot {
+  emails: string[];
+  startTime: number;
+  endTime: number;
+  eventId?: string;
+  masterId?: string;
+  calendarId?: string;
+}
+
+export interface AvailabilityResponse {
+  order?: string[];
+  timeSlots: AvailabilityTimeSlot[];
+}
+
+export interface GetAvailabilityQueryParams {
+  startTime: string;
+  endTime: string;
+  configurationId?: string;
+  slug?: string;
+  clientId?: string;
+  bookingId?: string;
+}

src/resources/availability.ts

@@ -0,0 +1,34 @@
+import { Overrides } from '../config.js';
+import { NylasResponse } from '../models/response.js';
+import {
+  AvailabilityResponse,
+  GetAvailabilityQueryParams,
+} from '../models/scheduler.js';
+import { Resource } from './resource.js';
+import { makePathParams } from '../utils.js';
+
+/**
+ * The parameters for the {@link SchedulerAvailability.list} method
+ * @property queryParams The query parameters to include in the request
+ */
+export interface GetAvailabilityParams {
+  queryParams: GetAvailabilityQueryParams;
+}
+
+export class SchedulerAvailability extends Resource {
+  /**
+   * Get availability for a scheduling configuration
+   * @return The availability response with time slots
+   */
+  public list({
+    queryParams,
+    overrides,
+  }: GetAvailabilityParams &
+    Overrides): Promise<NylasResponse<AvailabilityResponse>> {
+    return super._find({
+      path: makePathParams('/v3/scheduling/availability', {}),
+      queryParams,
+      overrides,
+    });
+  }
+}

src/resources/scheduler.ts

@@ -1,16 +1,19 @@
 import { Configurations } from './configurations.js';
 import { Sessions } from './sessions.js';
 import { Bookings } from './bookings.js';
+import { SchedulerAvailability } from './availability.js';
 import APIClient from '../apiClient.js';
 
 export class Scheduler {
   public configurations: Configurations;
   public bookings: Bookings;
   public sessions: Sessions;
+  public availability: SchedulerAvailability;
 
   constructor(apiClient: APIClient) {
     this.configurations = new Configurations(apiClient);
     this.bookings = new Bookings(apiClient);
     this.sessions = new Sessions(apiClient);
+    this.availability = new SchedulerAvailability(apiClient);
   }
 }

tests/resources/availability.spec.ts

@@ -0,0 +1,50 @@
+import APIClient from '../../src/apiClient';
+import { SchedulerAvailability } from '../../src/resources/availability';
+jest.mock('../../src/apiClient');
+
+describe('SchedulerAvailability', () => {
+  let apiClient: jest.Mocked<APIClient>;
+  let availability: SchedulerAvailability;
+
+  beforeAll(() => {
+    apiClient = new APIClient({
+      apiKey: 'apiKey',
+      apiUri: 'https://test.api.nylas.com',
+      timeout: 30,
+      headers: {},
+    }) as jest.Mocked<APIClient>;
+
+    availability = new SchedulerAvailability(apiClient);
+    apiClient.request.mockResolvedValue({});
+  });
+
+  describe('list', () => {
+    it('should call apiClient.request with the correct params', async () => {
+      await availability.list({
+        queryParams: {
+          startTime: '1659367800',
+          endTime: '1659369600',
+          configurationId: 'configuration123',
+        },
+        overrides: {
+          apiUri: 'https://test.api.nylas.com',
+          headers: { override: 'foobar' },
+        },
+      });
+
+      expect(apiClient.request).toHaveBeenCalledWith({
+        method: 'GET',
+        path: '/v3/scheduling/availability',
+        queryParams: {
+          startTime: '1659367800',
+          endTime: '1659369600',
+          configurationId: 'configuration123',
+        },
+        overrides: {
+          apiUri: 'https://test.api.nylas.com',
+          headers: { override: 'foobar' },
+        },
+      });
+    });
+  });
+});